中国 帮助

升级与补丁

升级这件事有两条互不相干的线:平台(宿主)自身的版本,和应用(插件)的版本。两者不会互相触发 —— 升应用不会改平台表,升平台也不会碰应用表。本页解决三个具体问题:改了什么要敲哪条命令、已经装着的实例怎么让改动生效、迁移脚本在这两条线里的位

升级与补丁
封面

> 本文整理自平台文档 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.ymldocker 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)

章节导览
THE END

喜欢就支持以下吧

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

回到内容