中国 帮助

多套部署

把同一套平台交付给多个客户:第二套装在哪里、哪些值必须错开、目录与授权怎么各归各,以及怎么验收两套互不干扰。

多套部署
封面

> 本文整理自平台文档 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、远程应用前端产物、上传文件、日志与临时目录(都在各实例自己的目录下);对象存储配置(各套在自己的「系统配置 → 文件存储配置」里启用);调度中心与监控中心可以共用一套,也可以各装一套,留空即不启用。

二、这一套装完,机器上多了什么

项每套的数量说明
后端容器1JVM 默认堆按 2C2G 定(-Xmx384m + Serial GC),容器内存上限在安装表单「内存限制」里填,单位 MB,面板渲染成 deploy.resources.limits.memory;单套建议 1024
前端容器1nginx 托管 dist/ 与 remote-apps,几十 MB
MySQL / Redis0(复用面板实例)每套只是同一个实例上的另一个库,库名账号密码由面板随机生成并自动授权;给每套再装一个 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)

章节导览
THE END

喜欢就支持以下吧

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

回到内容