> 本文整理自平台文档 docs/wujies/1.x/deploy/multi-deployment.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-c9411cc2bb3a-cover.svg)
同一个产品交付给多个客户时,第一个冒出来的问题是:一次上架,要不要在每台部署上再上架一遍?
不用。目录(应用 / 版本 / 分类)可以只维护一份,其它部署远程读它。
这一页讲怎么把这样的多套部署真的装起来:选哪条拓扑、装哪个 1Panel 包、两个端口怎么接、共享令牌怎么产生和分发、多套部署同处一台机器时要错开什么、链路怎么验。
运行期原理(IAppCatalogService 的两种实现怎么二选一、edition 分支、令牌拦在哪一层)在 [/advanced/catalog-and-edition](/docs/wujies/1.x/advanced/catalog-and-edition);配置项逐条说明与风险等级在 [/deploy/configuration](/docs/wujies/1.x/deploy/configuration)。本页不重复这两页。
三种拓扑怎么选
| 拓扑 | 装什么 | 约束与代价 | 适用 |
|---|---|---|---|
| 单机自用 | 一个 wujies-platform-server 包。catalog.mode=local 就是默认值,什么都不用配 | 目录只有这一份,改动只影响本机 | 自己用、单客户 |
| 目录服务 + 多个安装方 | 一台装 server 当目录服务;其余每台装 client | 目录服务是安装期依赖(见下文),且它的后端接口端口要对安装方可达 | 多客户,统一上架 |
| 用户版交付 | 客户那台装 wujies-platform-client 包 | 客户没有上架端;必须能连上目录服务才能装应用 | 交付给客户,不让客户上架 |
拓扑可以叠加:一台官方版可以同时给多个用户版供目录。
MarketEditionStartupCheck 只在 edition=client 时校验形态与目录是否自洽 —— official + catalog.mode=remote 是能启动的。但那样它的上架端写的是本地库, 而安装侧读的是远端目录:上架会"成功",却对谁都不生效。
这正是 client 这个形态要避免的失败,别用配置绕开它。
数据分家:什么共享、什么各自一份
| 类别 | 表 | 位置 |
|---|---|---|
| 目录 | app_info / app_version / app_category / app_plan | 中心一份,由目录服务维护 |
| 安装实例 | app_install / app_install_task / app_version_menu | 每套部署各一份 |
| 迁移账本 | app_schema_history | 每套部署各一份 |
所以「装了什么、装的是哪个版本」是每套部署自己的决定:同一份目录下,A 部署可以装 exam 1.0.1,B 部署一个都不装。
这几张目录表本来就在 security.tenant.excludes 里(平台级数据、不按租户隔离),集中它们不需要带租户参数 —— 这是整件事能干净做掉的原因。表间关系见 [/design/data-model](/docs/wujies/1.x/design/data-model)。
还要记住一层部署内全局的东西:sys_menu 的菜单行、数据表结构、以及本机的产物(插件 jar 与前端产物目录)。它们在一个部署内跨租户共享,所以卸载应用时有「别的租户还在用就不动」那道闸。
用 1Panel 装两套(推荐路径)
两个包是同一份代码的两个形态,包名与商店显示名如下:
| 包目录 | 商店显示名 | 角色 |
|---|---|---|
wujies-platform-server | Wujies App Market (Server) | 官方版:目录在自己库 + 上架端 + 对外提供 /app/catalog/** |
wujies-platform-client | Wujies App Market (Client) | 用户版:目录读服务端,本机安装 / 升级 / 卸载,无上架端 |
### 服务端(目录服务)
compose 里写死了 APP_MARKET_EDITION=official 与 APP_MARKET_CATALOG_MODE=local。安装表单里与本页相关的是两栏:
表单字段(data.yml 的 envKey) | 怎么填 |
|---|---|
目录服务令牌(CATALOG_TOKEN) | 面板会预填一个随机值。换成更长的:openssl rand -hex 24。然后抄给每一个安装方 |
后端接口端口(PANEL_APP_PORT_API,默认 18080) | 必须对安装方可达,客户端的 base-url 就指向它。容器内固定 8080 |
### 客户端(用户版)
compose 里写死了 APP_MARKET_EDITION=client 与 APP_MARKET_CATALOG_MODE=remote。表单里多出两栏,缺一不可:
| 表单字段 | 怎么填 |
|---|---|
官方版地址(服务端)(CATALOG_BASE_URL) | http://<服务端主机>:18080。只写到主机与端口,/app/catalog 这个路径前缀由 CatalogApiContract.BASE_PATH 在代码里拼 |
目录服务令牌(CATALOG_TOKEN) | 必填且默认为空 —— 必须与服务端完全一致,面板不会替你填 |
客户端包没有后端接口端口那一栏:它的后端不需要对公。
打包脚本对两个包一视同仁,所以客户端首次启动同样会导入 sql/files/03-app-catalog.sql。 但远程模式下 IAppCatalogService 装配的是 RemoteAppCatalogService,这些本地目录行没有任何人读。 别据此判断"客户端有本地目录可用"。
### 上传与安装
# 1) 上传并解包(tar 解包,别用 scp 直接建目录 —— Windows 的 scp 建出 0700,容器里的非 root 用户读不到)
scp wujies-platform-1panel-5.6.3.tar.gz root@<host>:/root/
cd /root && tar -xzf wujies-platform-1panel-5.6.3.tar.gz -C /root/pkg
# 2) 放进面板的本地应用目录
cp -r /root/pkg/apps/* /opt/1panel/resource/apps/local/
chmod -R a+rX /opt/1panel/resource/apps/local/wujies-platform-*
# 3) 构建镜像(主包要两个;调度中心 / 监控中心是可选的另外两个)
cd /root/pkg/docker/backend && docker build -t wujies-platform/backend:5.6.3 .
cd ../frontend && docker build -t wujies-platform/frontend:5.6.3 .
然后 面板 → 应用商店 → 本地应用 → 同步/刷新,两个应用都会出现。装完之后面板日志里第一行就是库名(wujies_<6位随机>)。
包本身的构建(build-1panel.ps1 怎么跑、镜像与 SQL 的关系、四条纪律)见 [/deploy/backend](/docs/wujies/1.x/deploy/backend);前端 dist 与 nginx 的 /remote-apps/ 对齐见 [/deploy/frontend](/docs/wujies/1.x/deploy/frontend)。
同一份配置的两种写法
1Panel 包用环境变量覆盖 jar 内的 yml(entrypoint.sh 做映射),手工跑 jar 或自己写 compose 时直接写 yml 等价:
# 目录服务侧(提供方)
app-market:
edition: official # 默认值
catalog:
mode: local # 默认值:目录就在自己库里
token: <两端一致的共享令牌>
# 安装方侧(使用方)
app-market:
edition: client
catalog:
mode: remote
base-url: http://<服务端主机>:18080
token: <与服务端一致>
connect-timeout-ms: 3000
read-timeout-ms: 15000
环境变量名与表单字段的对应关系(CATALOG_BASE_URL → APP_MARKET_CATALOG_BASE_URL、 CATALOG_TOKEN → APP_MARKET_CATALOG_TOKEN、SECURITY_MODE → APP_MARKET_SECURITY_MODE)见包内
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-c9411cc2bb3a-guide.svg)


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