> 本文整理自平台文档 docs/wujies/5.x/deploy/index.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-4024b976b623-cover.svg)
交付形态是 1Panel 本地应用加 docker compose。平台自己只交付两个容器(前端 nginx、后端 jar),MySQL / Redis / RabbitMQ 与对象存储都不打进包:装的时候在安装表单里选一个面板已装的服务,或者填你自己的外部实例地址。java -jar 直跑是开发与排障的形态,交付走包;手上已经有 jar 直跑实例的,它的补丁与在线更新口径见[升级与补丁](/docs/wujies/5.x/deploy/upgrade)。
一台新机器上要发生的事,三句说完:
- 装哪几个包:
wujies-platform-server每套部署必装;wujies-snailjob-server(定时任务调度中心)和wujies-monitor-admin(服务监控)是另外两个可装可不装的包,装完还要回主包表单填它们的地址才启用,留空就是不启用。 - 按什么顺序:打包 → 在有 Docker 的机器上建镜像 → 传进面板本地应用目录 → 装主包填表单 → 看首次启动的初始化日志。命令在[后端部署](/docs/wujies/5.x/deploy/backend),前端那半在[前端部署与 nginx](/docs/wujies/5.x/deploy/frontend)。
- 装完必须做:启用一种对象存储、填中心目录地址与令牌、把验签公钥与包检查档位定下来。三件都不做时服务是「起得来但用不了」的状态,市场是空的、上传会失败。
按你要办的事进
三个包的分工
| 包 | 装的是什么 | 什么时候要装它 |
|---|---|---|
wujies-platform-server | 前端 nginx + 后端 jar 两个容器,安装 / 市场 / 运行期 / 开发台这几个控制器的宿主侧 | 每一套部署都装,且只装这一个主包 |
wujies-snailjob-server | SnailJob 服务端与控制台 /snail-job,带自己的库 | 需要任务的执行历史与失败重试时。不装也有宿主侧本地排期(wujies.tasks.mode = local),商城那批定时任务照样跑 |
wujies-monitor-admin | Spring Boot Admin(/admin) | 想在线看健康、JVM、日志级别、配置 |
这两个可加装包的地址填在网络别名上:同一张 1panel-network 里固定填 snailjob-server 与 http://monitor-admin:9090/admin,不用去查面板随机生成的容器名。填错的表现是主包起得来、调度中心里看不到任务实例。
平台包和业务应用包是两回事
平台包用 deploy/tools/build-1panel.ps1 产出,装的是平台自己;业务应用包由各应用仓库的 package.ps1 产出(mall / gallery / im / member / pay …),先在中心上架服务里发布,再回平台的「应用市场」安装。两者靠应用目录衔接:中心那边发布了新版本,市场里才升得动。业务侧的打包、签名、上架见[打包与上架](/docs/wujies/5.x/platform/package/)。
装完必须做的三件事
1. 启用一种对象存储。默认所有存储配置都是停用状态,所以刚装完上传应用包和图片会失败,这是刻意的。位置与选型见[存储配置](/docs/wujies/5.x/platform/settings/storage)。 2. 填中心目录地址与令牌。全新部署的「应用市场」是空的:目录数据自 2026-10-30 起归中心上架服务,包里不再有目录种子。地址与令牌有 sys_config 与环境变量两层,sys_config 优先;令牌必须与中心那侧同一个值,不一致时目录接口回 401。判据与后果见[应用目录](/docs/wujies/5.x/platform/app-market/catalog)。 3. 定下验签公钥与检查档位。开源默认 warn,因为公钥不在仓库里;切 enforce 的前提是公钥已配置,没配公钥时 enforce 会拒掉所有包,包括你自己签的。两档差别见[安全校验模式](/docs/wujies/5.x/platform/package/security-modes),钥对与同步流程见[密钥与签名](/docs/wujies/5.x/platform/package/signing)。
上线前把开发验证值换掉
正式对外前逐类换掉,每类的位置在对应页里:
- 登录态的 JWT 密钥(仓库里那串 26 字母的开发值必须换掉)、接口加解密密钥对(
api-decrypt.enabled默认false,要启用接口加密就前后端同时换)、应用包验签公钥(配在平台侧,签包用的私钥归发布方)、目录共享令牌,逐项位置见[配置项操作清单](/docs/wujies/5.x/deploy/configuration-guide)。 - 两个可选服务的控制台默认口令(调度中心种子账号与监控中心 Basic 账号)。
- 各应用仓库的签名私钥留在发布方,备份到仓库之外;公钥不是秘密,私钥任何时候不进仓库、不进部署机、不进工单。
三条纪律:私钥只走仓库外的文件路径、不走环境变量;成对的密钥两端同时换;app-market.* 里启动期读入的项改完要重建宿主 jar 再重启,只改文件不生效。密钥纪律与备份见[备份与安全](/docs/wujies/5.x/deploy/ops/backup-security)。
部署前检查清单
- [ ] 面板里已装 MySQL 8.x(平台初始化 SQL 通篇
utf8mb4_0900_ai_ci,MariaDB 没有这个排序规则)与已设密码的 Redis(必填项,那台实例没密码时这一栏是空的);RabbitMQ 选填 - [ ] 有一台带 Docker 的机器用来建镜像,或镜像已推到可拉取的仓库
- [ ] 打包机满足 Node 22+ / JDK 17 / Maven
- [ ] 服务器内存按主包 README 的规格准备(前端 + 后端 ≥ 2GB,中间件按你选的服务另计)
- [ ] 中心上架服务的地址与令牌已问清楚,否则装完市场是空的
- [ ] 多套部署时库名与端口各自错开,见[多套部署](/docs/wujies/5.x/deploy/multi-deployment)
- [ ] 动过一套在跑的部署前看过[升级与补丁](/docs/wujies/5.x/deploy/upgrade) 的备份清单
相关阅读
- [快速开始](/docs/wujies/5.x/introduction/quickstart):开发机上手工起一套最小可跑环境
- [环境准备](/docs/wujies/5.x/introduction/prerequisites):工具链版本与版本号口径
- [故障排查](/docs/wujies/5.x/deploy/ops/troubleshooting):装不上、起不来时按症状查原因
- [任务中心与日志](/docs/wujies/5.x/deploy/ops/task-center):安装与升级任务的分步日志
源码事实源:wujies-platform/deploy/1panel/apps/*(data.yml、docker-compose.yml、各包 README)、deploy/docker/backend/entrypoint.sh、deploy/tools/build-1panel.ps1。
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-4024b976b623-guide.svg)


评论区需要浏览器启用 JavaScript 才能加载。