> 本文整理自平台文档 docs/wujies/5.x/deploy/multi-deployment.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-5a31f7340e96-cover.svg)
一个客户一套部署是这里的默认前提:各自的库、各自的安装实例、各自的迁移账本,多套之间没有主从。要在同一台机器(或同一张 1panel-network)上再装一套,或者要让几套看到同一份应用目录,按这页走。
2026-10 的应用市场减法移除了「官方版 / 用户版」双形态:wujies-platform-client 包与 APP_MARKET_EDITION 都不存在了,只剩一个平台包。但远程目录读取在 2026-10-30 又回来了,形态不同:目录(app_info / app_version / 路由清单)由独立的中心上架服务持有,部署侧用环境变量或后台页签指向它。所以「装多套」这件事现在只有一条主线:每套都装同一个包,目录读同一份中心。目录自身的结构与读取规则见 [应用目录](/docs/wujies/5.x/platform/app-market/catalog)。
前提
- 一台已装 1Panel 的机器,应用商店里已有 MySQL、Redis(RabbitMQ 可选);
- 主包
wujies-platform-server已放进面板本地应用(放法与镜像来源见 [后端部署](/docs/wujies/5.x/deploy/backend)); - 机器内存按「每套两个容器」算:2C2G 只够一套,要装两套先加内存;
- 如果要让各套读同一份目录:中心上架服务的 API 地址与共享令牌先备好(地址形如
https://<中心域名>,不含末尾斜杠)。
一、装第二套
面板「应用商店 → 本地应用 → Wujies App Market」再安装一次,实例名取一个不同的即可,同一份包可以装任意多套。每套都是独立的前端 + 后端两个容器,CONTAINER_NAME 不同,compose 里前端连的是 ${CONTAINER_NAME}-backend,所以两套在同一张网络里也不会串到对方的后端。
必须错开的项:
| 项 | 在哪 | 错开的后果 |
|---|---|---|
| 数据库名 / 账号 / 密码 | 安装表单随机生成(wujies_<6位随机>) | 别手工改成同一个:两套共用一个库会互相覆盖 sys_config 与安装台账 |
| 前端访问端口、后端接口端口 | 安装表单 PANEL_APP_PORT_HTTP / PANEL_APP_PORT_API | 端口撞了第二套起不来,或两套共用一个入口 |
外部访问地址 EXTERNAL_URL | 安装表单(compose 里作为 JUSTAUTH_ADDRESS 传给后端) | 留成同一个值,第三方登录回调与对外链接会跳到另一套 |
命名空间 SNAIL_JOB_NAMESPACE(默认 prod) | 安装表单,两套共用一个调度中心时必须不同 | 同命名空间 + 同任务组(wujies_group)会让两套互相抢任务 |
| 中心目录地址 / 令牌 | 安装表单,或装完在后台「系统配置 → 应用中心」改 | 各套地址不一致时,客户看到的可装应用列表各不相同 |
各自一份、不需要错开的:./data/ 下的插件 jar、远程应用前端产物、上传文件、日志与临时目录(都在各实例自己的目录下);对象存储配置(各套在自己的「系统配置 → 文件存储配置」里启用);调度中心与监控中心可以共用一套,也可以各装一套,留空即不启用。
二、这一套装完,机器上多了什么
| 项 | 每套的数量 | 说明 |
|---|---|---|
| 后端容器 | 1 | JVM 默认堆按 2C2G 定(-Xmx384m + Serial GC),容器内存上限在安装表单「内存限制」里填,单位 MB,面板渲染成 deploy.resources.limits.memory;单套建议 1024 |
| 前端容器 | 1 | nginx 托管 dist/ 与 remote-apps,几十 MB |
| MySQL / Redis | 0(复用面板实例) | 每套只是同一个实例上的另一个库,库名账号密码由面板随机生成并自动授权;给每套再装一个 MySQL 是纯粹的浪费 |
| 调度中心 / 监控中心 | 0~1(多套共用一套) | 两个都是 400–600MB 的独立 JVM。共用时命名空间必须各套不同,见上面那张表;小内存机器上不装,主包表单里那两项留空即可 |
磁盘上的 ./data/ | 1 套一份 | 插件 jar、远程应用前端产物、上传文件、日志、临时目录、公钥,全在该实例自己目录下 |
/opt/1panel/apps/local/wujies-platform-server/ 的外层是面板的本地应用资源目录,历史上手可能会在那里留一份 docker-compose.yml + .env(值是自编的,跟面板生成的实例对不上)。面板真正装的实例在它的子目录里。在外层误敲一次 docker compose up,起来的是第二个后端容器,并且和第一个共用同一个 plugin-dir 卷,同一个插件被两个进程各加载一遍,接口时好时坏,日志里却看不出问题。装第二套的正确入口始终是面板「应用商店 → 本地应用 → 安装」。
三、数据分家:每套都是完整的
| 类别 | 代表表 | 位置 |
|---|---|---|
| 安装实例与任务 | app_install、app_install_task | 每套各一份,且带 tenant_id 按租户隔离 |
| 迁移账本 | app_schema_history | 每套各一份(应用升级跑过哪些脚本) |
| 路由墓碑 | app_route_index | 每套各一份;启动时由预热任务从目录侧的 app_version_route 同步进来,只增不删 |
| 授权台账 | app_license、app_license_order、app_license_activation、app_redeem_code | 每套各一份;app_license 记的是「这一套部署买了什么」 |
| 目录 | app_info、app_version、app_category、app_version_route | 读中心时不在本库落地主数据;base-url 留空才读本库,而本库没有目录种子 |
「装了什么、升级到哪一版」永远是每套部署自己的决定:A 客户装了 exam 1.0.1,B 客户一个应用都不装,两者互不影响。
目录表不带 tenant_id(列在 application.yml 顶层的 tenant.excludes 里),那是为了让同一部署内的所有租户共用一份目录,它不意味着目录能跨部署共享。表间关系见 [数据模型](/docs/wujies/5.x/platform/architecture/data-model)。还有一层部署内全局的东西:sys_menu 的菜单行、数据表结构、本机产物(插件 jar 与前端产物目录),它们在部署内跨租户共享,所以卸载应用时有「别的租户还在用就不动」那道闸。
四、让多套看到同一份目录
指同一个中心即可,没有「从另一台部署拉目录」的接口,也不要再靠每台各上传一遍:上架端已随平台删除(2026-11-01),发布、版本与安装包都在中心那一侧。
# 每套部署都填同一个地址与同一个令牌(后台页签改完即生效,不用重启)
curl -s -X PUT "http://<该套后端>/prod-api/system/config/updateByKey" \
-H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
-d '{"key":"appmarket.catalogBaseUrl","value":"https://<中心域名>"}'
两个容易漏的点:
1. 令牌两边必须是同一个值。不一致时目录调用一律回 {code:401},表现是「市场是空的」,不会弹窗报错。 2. sys_config 那一层优先于环境变量,但它只是覆盖层。要断开一个用 APP_MARKET_CATALOG_BASE_URL 配了地址的部署,清 sys_config 没用,得清那个环境变量。
给客户做内网或离线部署时,base-url 留空,市场就是空的:本库 app_info 为 0 行属正常,这是配置缺失、不是故障。真要离线交付目录数据,得单独往本库补,别指望装包带进来。
接上中心后还有一层好处能拿来当判据:新装的一套一个应用都没装过,打某个应用的接口回的也是 HTTP 404 带业务码 4610(「应用不可用」),因为启动预热会把目录里的路由清单同步进本地 app_route_index(CatalogRouteIndexSyncService,只增不删)。所以「普通 404」说明这套根本没读到目录,「404 + 4610」说明目录接上了、只是没装。排查时先看后端日志有没有那行预热,别去查 nginx。
各套的包检查档位可以不同(SECURITY_MODE,默认 warn),但要用同一把私钥签包:公钥注入各套的 data/keys/package-public.pem 或 WUJIES_PACKAGE_PUBLIC_KEY,签名校验的结果才一致。切 enforce 前跑一次自检,见 [签名与发布](/docs/wujies/5.x/platform/package/signing) 与 [安全模式](/docs/wujies/5.x/platform/package/secu
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-5a31f7340e96-guide.svg)


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