中国 帮助

部署

一台服务器上要装哪几个包、按什么顺序装完、装完必须补的三件事,以及每一步归哪一页细讲。

部署
封面

> 本文整理自平台文档 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-serverSnailJob 服务端与控制台 /snail-job,带自己的库需要任务的执行历史与失败重试时。不装也有宿主侧本地排期(wujies.tasks.mode = local),商城那批定时任务照样跑
wujies-monitor-adminSpring 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)

章节导览
THE END

喜欢就支持以下吧

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

回到内容