> 本文整理自平台文档 docs/wujies/5.x/deploy/configuration-guide.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-5bd64b824a47-cover.svg)
装完一套部署、或者要改档位与路径时,按这页的顺序动配置。键名、默认值、读取方在 [配置项索引](/docs/wujies/5.x/deploy/configuration),本页只讲从索引里看不出来的三件事:真正生效的值是哪一层给的、改完要不要重建或重启、哪几个键必须与别的组件对齐。
一、先确认值的来源
| 来源 | 位置 | 覆盖关系 |
|---|---|---|
JVM 系统属性 -D | 容器 deploy/docker/backend/entrypoint.sh;本机手敲 java "-Dapp-market.deploy.plugin-dir=…" | 优先级最高 |
| 环境变量 | compose 的 environment: 段,以及 entrypoint 导出的 WUJIES_* | 覆盖 yml |
| jar 内 yml | application.yml 的 app-market: 段 | 被上面两层覆盖;它自己写成 ${占位符:默认},所以同名环境变量在这一层就能换默认值 |
sys_config 参数 | 只有目录那两键:appmarket.catalogBaseUrl / appmarket.catalogToken | 非空时覆盖 app-market.catalog.*,改完即生效;其它 app-market.* 键没有这一层 |
@Value 注解兜底 | Java 类里的 ${app-market.xxx:默认值} | 该键完全不存在时才生效,它不是一层配置 |
变量名与键名的换算是宽松绑定:点与横线都换成下划线、全大写,app-market.deploy.frontend-dir 对应 APP_MARKET_DEPLOY_FRONTEND_DIR。中间件地址不走 app-market.*,由 entrypoint 导出 WUJIES_DB_* / WUJIES_REDIS_* / WUJIES_MQ_*。
application.yml 被打进 wujies-admin.jar,改源码目录里那份之后必须重建再重启:
mvn -pl wujies-admin -am -B install -DskipTests
java "-Dloader.path=plugins-dist" "-Dspring.profiles.active=prod" -jar wujies-admin\target\wujies-admin.jar
服务还跑着时别执行那条 install:JVM 锁着旧 jar,它会中途失败、甚至让那个 JVM 抛 NoClassDefFoundError。本机改代码的日常回路是 mvn -q compile 加 POST /app/dev/reload。1Panel 部署改「应用商店 → 已安装 → 参数」,保存后面板重建容器,不需要手工 docker build;只有改了 Java 或前端 dist/ 才重建镜像。
二、产物落位路径
两个键都相对进程工作目录解析(Paths.get(...).toAbsolutePath()):
| 键 | 生效值 | 什么时候要动 |
|---|---|---|
app-market.deploy.plugin-dir | yml ${WUJIES_PLUGIN_DIR:plugins-dist};容器 /app/plugins-dist | 换启动目录、插件目录挪盘 |
app-market.deploy.frontend-dir | yml ${WUJIES_FRONTEND_DIR:../wujies-admin/app-market-dist/remote-apps};容器 /app/remote-apps | 前后端分离部署必须改成共享/分发位置 |
yml 与注解兜底现在是同一个字符串(2026-10-27 把兜底的旧值 ../plus-ui/... 改齐,并给两个键都加上 ${…} 占位),所以剩下唯一会出错的是工作目录。宿主要从 wujies/wujies-platform/ 启动;从上一层 wujies/ 启动时 ../wujies-admin/… 指到工作区根的化石目录 ruoyi/wujies-admin/(只有 app-market-dist/,没有 src/),部署报告照样「成功」,产物落到了一个没人读的地方。别被名字骗:wujies/wujies-admin/(宿主前端)与 wujies/wujies-platform/wujies-admin/(后端启动模块)是两个目录。
核对只看启动那三行:
[deploy] plugin-dir = C:\...\wujies\wujies-platform\plugins-dist(存在:true)
[deploy] frontend-dir = C:\...\wujies\wujies-admin\app-market-dist\remote-apps(存在:true)
[deploy] 启动工作目录 user.dir = C:\...\wujies\wujies-platform(两个相对路径都以它为基准)
不想固定工作目录就给绝对路径(两种写法都行,前者命中 yml 占位符、后者走宽松绑定):
set WUJIES_FRONTEND_DIR=C:\...\wujies\wujies-admin\app-market-dist\remote-apps
set APP_MARKET_DEPLOY_FRONTEND_DIR=C:\...\wujies\wujies-admin\app-market-dist\remote-apps
本机核对相对路径解析结果(工作目录必须是 wujies-platform/):[System.IO.Path]::GetFullPath('..\wujies-admin\app-market-dist\remote-apps')。
容器侧不用改这两项:compose 已给 /app/plugins-dist 与 /app/remote-apps,两边靠同一个宿主卷 ./data/remote-apps 接起来。本机开发时 appMarketStatic.ts 的 dev server 会优先从各插件仓库的 frontend/dist 取产物,落位目录只是回落,「页面能打开」不代表落点对。
三、包安全档位
app-market.security.mode 有三个可能的来源,现在三层默认都是 warn:
| 位置 | 值 |
|---|---|
application.yml | ${WUJIES_SECURITY_MODE:warn} |
注解兜底(PackageSecurityInspector、SignatureReadinessService) | warn |
1Panel 安装表单 SECURITY_MODE | 默认 warn,required: true;compose 把它交给 entrypoint,非空时才导出 WUJIES_SECURITY_MODE |
开源默认 warn 是有原因的:公钥属于发布方的运营事实、不在开源仓里,没有公钥时 enforce 会拒绝所有包,连自己签的也拒。以前 yml 显式写 enforce 并内联一把开发用公钥,那层「yml 与注解兜底不一致」的问题在 2026-11-05 改成占位注入后消失了,换成一个新的漏法:没确认公钥已注入就切 enforce。
切档位的顺序不能颠倒:
# 1) 先确认这台部署有没有拿到公钥
docker exec <后端容器> sh -c 'printenv WUJIES_PACKAGE_PUBLIC_KEY | head -c 32'
# 2) 再问能不能切(返回里带 mode 与分类计数)
curl -H "Authorization: <你的登录 token>" http://<host>:<后端端口>/app/install/signature-readiness
公钥有两条注入路:环境变量 WUJIES_PACKAGE_PUBLIC_KEY,或 1Panel 实例目录 data/keys/package-public.pem(compose 已挂成 /app/keys:ro,entrypoint 压成单行 base64 后导出)。data/keys 是空目录就等于不验签。私钥任何时候都不走这条路,也不进仓库。
public-key 为空时 enforce 拒绝所有包,报错里会明说原因。判断「这台到底配没配」别看 yml,看 entrypoint 日志那行 已注入公钥 …(来自 …) 有没有出现。空串或写错档位都不报错,代码里一律按 warn 处理,所以「已经切了 enforce」的印象最容易在这里出错。
换钥要同时做三件事:生成新的一对、把新公钥注入、重建宿主并重启。只贴新公钥而没重签旧包,已发布版本全部验签失败;用 GET /app/install/signature-readiness 的分类计数核对(signed / unsigned / invalid / unverifiable),没配公钥时有签名的包会落到 unverifiable 而不是 invalid。`package.ps1 -SyncPubl
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-5bd64b824a47-guide.svg)


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