> 本文整理自平台文档 docs/wujies/1.x/deploy/upgrade.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-391eb26e767f-cover.svg)
升级这件事有两条互不相干的线:平台(宿主)自身的版本,和应用(插件)的版本。两者不会互相触发 —— 升应用不会改平台表,升平台也不会碰应用表。本页解决三个具体问题:改了什么要敲哪条命令、已经装着的实例怎么让改动生效、迁移脚本在这两条线里的位置。
前提是平台与插件仓库的边界(见 [/design/repo-layout](/docs/wujies/1.x/design/repo-layout)):平台里没有 *-api 契约模块,实体 / BO / VO / Mapper 接口与 Mapper XML / Service / controller / listener / task / app.json / migrations 全在插件仓库 wujies/wujies-plugins/wujies-<app>/ 下,平台对 cn.wujies.<app>.* 的 Java 引用为 0。所以升级一个应用不需要动平台一行,这也是两条线能彻底分开的原因。
两条升级线
| 平台(宿主) | 应用(插件) | |
|---|---|---|
| 谁负责 | 你(运维) | 平台自动(你只点「升级」) |
| 产物 | wujies-admin.jar + 前端 dist + 平台 SQL | 应用包(后端 jar + 前端产物 + migrations/) |
| 怎么升 | 换 jar / 重建镜像 → 重启;表结构按需执行平台补丁脚本 | 上架端发布新版本 → 本机「我的应用 → 升级」 |
| 表结构 | 手工执行 script/sql/update/ 下的脚本 | 升级时自动执行包内 migrations/*.sql |
| 是否自动 | ❌ 不会自动 | ✅ 落位 → 迁移 → 热加载,全程不重启 JVM |
| 失败影响 | 应用起不来 / 接口 500 | 单个应用的升级任务失败,平台本身不受影响 |
1Panel 应用包(deploy/tools/build-1panel.ps1 产出,装的是平台自己)与 业务应用包(package.ps1 产出,上架到应用市场里的 mall / gallery / …)是两回事。本节讲的是前者;业务应用包的升级见下面的「应用升级」。
平台升级
### 路线一:jar 直跑
先停掉正在跑的实例 —— 运行中的 JVM 会锁住 jar,mvn install 写目标文件会失败。
# 1) 存量库补结构:只跑这次发布需要的脚本(全新库跳过,见下面的「补丁脚本从哪来」)
mysql -h <host> -u <user> -p <db> < script/sql/update/app_market_schema_history_fix.sql
# 2) 重新打包
$env:JAVA_HOME = "C:\Users\<you>\.jdks\corretto-23.0.2"
$mvn = "C:\Program Files\JetBrains\IntelliJ IDEA 2025.3.3\plugins\maven\lib\maven3\bin\mvn.cmd"
& $mvn -pl wujies-admin -am -B install -DskipTests
# 3) 启动(脚本会先清掉上一版残留的插件 jar,再启动)
powershell -NoProfile -ExecutionPolicy Bypass -File script\prune\start-host.ps1 -Build
-Build可以省掉(第 2 步已手工打包过);script\prune\start-host.ps1先跑同目录的prune-plugins.ps1是有顺序讲究的:-Dloader.path只加载目录根下的 jar,同appCode两个版本同时在位会撞重复的 mapper XML。现在启动瞬间的loader.path与运行期一样按active-plugins.txt过滤,残留 jar 不再致命,但清理仍然是推荐动作(且 Windows 上被占用的 jar 只能停服务后清);- 全部启动参数见 [/deploy/backend](/docs/wujies/1.x/deploy/backend)。
app-market.security.public-key、app-market.security.mode、目录与形态开关都是启动期从 jar 内 yml 读入的。只改文件不重建、不重启,等于没改 —— 换钥后会继续用旧公钥拒掉你刚签出来的包。见 [/deploy/configuration](/docs/wujies/1.x/deploy/configuration)。
### 路线二:1Panel 应用包(什么时候要重建镜像)
包的构成决定了「哪类改动要重建镜像」:SQL / data.yml / compose 是包里的文件,jar 与前端 dist/ 是打进镜像的。
| 你改了 | 重新打包 | 重建镜像 | 同步到主机 | 已装实例怎么生效 |
|---|---|---|---|---|
初始化 SQL(script/sql/**)、应用目录种子 | ✅ -SkipFrontend -SkipBackend | ❌ 不用 | 换实例目录里的 sql/files/*.sql(bind mount) | 删标记 + 重启(见下一节) |
安装表单(gen-appstore-data.mjs → data.yml)、README / logo | ✅ 同上 | ❌ | 换文件 + 面板「本地应用 → 同步」 | 重新安装,或改实例的「参数」 |
| compose(端口 / 挂载 / 环境变量) | ✅ 同上 | ❌ | 换 docker-compose.yml | docker compose up -d |
后端 Java(wujies-admin.jar) | ✅ 默认(会跑 maven) | ✅ docker build backend | 同步 docker/ + 重建镜像 | 容器重建即生效 |
| 前端(宿主前端仓库源码) | ✅ 默认(会跑 vite) | ✅ docker build frontend | 同上 | 同上 |
deploy/docker/*/entrypoint.sh | ✅ 同上 | ✅ 对应那个镜像 | 同上 | 同上 |
| 调度中心 / 监控中心的 Java | ✅ 不加 -SkipBackend | ✅ 各自 docker build | 同上 | 同上 |
# 只改 SQL / data.yml / compose(几十秒,不重建镜像)
powershell -ExecutionPolicy Bypass -File wujies-platform\deploy\tools\build-1panel.ps1 -SkipFrontend -SkipBackend
# 只改了后端 Java
powershell -ExecutionPolicy Bypass -File wujies-platform\deploy\tools\build-1panel.ps1 -SkipFrontend
# 全量(前端 vite build --mode docker + 后端 mvn install + 组装 + tar.gz)
powershell -ExecutionPolicy Bypass -File wujies-platform\deploy\tools\build-1panel.ps1
主机侧(只有镜像变了才需要 docker build,标签必须与 compose 里的 image: 一致):
tar -xzf wujies-platform-1panel-5.6.3.tar.gz -C /root/pkg
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 .
cd ../snailjob && docker build -t wujies-platform/snailjob-server:5.6.3 .
cd ../monitor && docker build -t wujies-platform/monitor-admin:5.6.3 .
# 应用包同步进面板(走 tar 解包,别用 scp 直传资源目录)
cp -r /root/pkg/apps/* /opt/1panel/resource/apps/local/
chmod -R a+rX /opt/1panel/resource/apps/local/wujies-platform-*
# 然后:面板 → 应用商店 → 本地应用 → 同步
- ⚠️ 改版本号要同时动四处:
build-1panel.ps1的$Version、包内5.6.x/目录名、compose 里的镜像 tag、gen-appstore-data.mjs的VERSION。漏一处就是「面板装的是
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-391eb26e767f-guide.svg)


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