中国 帮助

多部署与目录服务

同一个产品交付给多个客户时,第一个冒出来的问题是:一次上架,要不要在每台部署上再上架一遍? 不用。目录(应用 / 版本 / 分类)可以只维护一份,其它部署远程读它。 这一页讲怎么把这样的多套部署真的装起来:选哪条拓扑、装哪个 1Pane

多部署与目录服务
封面

> 本文整理自平台文档 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-serverWujies App Market (Server)官方版:目录在自己库 + 上架端 + 对外提供 /app/catalog/**
wujies-platform-clientWujies 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)

章节导览
THE END

喜欢就支持以下吧

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

回到内容