部署选型

生成日期：2026-07-23
用途：按客户现场形态选择对应部署手册。开发机本地跑通请先看 快速启动文档。

四本手册

手册	适用场景	入口
单体部署	Linux 单机（推荐 Ubuntu + Docker Compose）；无 Docker 时用 JAR + systemd	单体部署
微服务部署	4 节点职责分离（Ubuntu 或 Rocky 9 + Compose + Nacos）；或自研多 JAR	微服务部署
Windows 部署	客户仅有一台 Windows Server / 专业版电脑的裸机单体	Windows 部署
Jenkins 流水线	部署完成后需要持续构建发布（单体或微服务）	Jenkins 流水线

部署跑通后，务必继续完成 上线文档（关闭演示提示、验证码、租户品牌、域名与存储等）。

怎么选

统一约定

约定	说明
构建与运行分离	不在生产机装 Maven/Node；本地或 Jenkins 构建后只上传产物
对外端口	默认仅 80/443（+ SSH 22）；3306/6379/48080/8080/9090（XXL-Job）等不对公网
数据库初始化	业务库用 dump/latest 的 schema + static_data；XXL-Job 用独立库 xxl_job（xxl_job_schema.sql + init）
可选中间件	XXL-Job / OnlyOffice / RocketMQ / IoT / Jenkins 按合同启用，不装通常仍可完成登录验收
占位符	文档中的 <SERVER_IP>、<DB_PASSWORD> 等需替换为现场值
交付包脚本	客户现场交付的 compose/脚本以 ruoyi-office-customer-deploy/ 对应目录为准；文档与脚本冲突时以已跑通案例为准

阅读顺序建议

1. 本页选型 → 打开对应一屏手册（右侧「本页目录」跳章节，勿再下钻多页）
2. 需要 CI 时再打开 Jenkins 手册
3. 完成侧栏「上线文档」各专题