中国 帮助

配置项索引

应用市场与宿主相关配置项的键名、类型、默认值与读取时机,改之前先在这里确认哪个值真正生效。

配置项索引
封面

> 本文整理自平台文档 docs/wujies/5.x/deploy/configuration.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-b4e639dfae55-cover.svg)

要查某个 app-market.* 键的默认值、或者判断「改了要不要重启」,在这页查。想知道该改哪一项、按什么顺序改完验收,看 [配置项操作清单](/docs/wujies/5.x/deploy/configuration-guide)。

两个读值规则贯穿全表:

  • yml 显式值:wujies-platform/wujies-admin/src/main/resources/application.yml 里写出来的值;
  • 注解兜底值:@Value("${app-market.xxx:默认}") 里的默认值。没出现在 yml 里的键以注解为准,两处都有的键以 yml 为准。

仓库里只有 application.yml、application-dev.yml、application-prod.yml 三个 profile 文件(没有 application-docker.yml),后两个都不含任何 app-market.* 键,所以 profile 层不覆盖应用市场的配置。唯一的覆盖来源是容器化部署的环境变量,见下面[容器侧](#容器侧覆盖了什么)。

app-market.security.*、license.*、deploy.* 都是启动期读入(@Value / @PostConstruct),改了必须重建 wujies-admin.jar 并重启:application.yml 被打进 jar,只改源码目录里的那份而不重新打包,等于没改。用环境变量注入的键不必重建,重启进程即可。catalog 那两个键有运行期的一层(后台可改、保存即生效),见下面目录一节。

部署路径

键默认值什么时候要改它
app-market.deploy.plugin-dir${WUJIES_PLUGIN_DIR:plugins-dist}(注解兜底同为 plugins-dist;容器侧为 /app/plugins-dist)换启动目录、或插件目录要放到别的盘时。它必须与宿主启动参数 -Dloader.path 同目录;包内 assets.backend 释放到该目录根下,loader.path 不递归子目录,所以 migrations/<appCode>/ 落在子目录里是安全的
app-market.deploy.frontend-dir${WUJIES_FRONTEND_DIR:../wujies-admin/app-market-dist/remote-apps}(注解兜底同一个值;2026-10-27 把旧的 ../plus-ui/... 改齐)前后端分离部署时必须改成共享/分发目录,否则后端把产物释放到自己的磁盘、前端读另一份,表现是「安装成功、菜单点开是远程视图不可用」。容器侧靠共享卷实现

两个值都按进程工作目录解析(Paths.get(...).toAbsolutePath()),不是相对仓库根,所以宿主要从 wujies/wujies-platform/ 启动。AppPackageDeployService.logDeployTargets() 在启动时打三行绝对路径,跨目录启动就靠它核对,别猜:

[deploy] plugin-dir   = <绝对路径>(存在:true)
[deploy] frontend-dir = <绝对路径>(存在:true)
[deploy] 启动工作目录 user.dir = <目录>(两个相对路径都以它为基准)

../wujies-admin/... 以 wujies-platform/ 为基准指到宿主前端仓库的 app-market-dist/remote-apps,也就是 appMarketStatic.ts 里 sourceDir 认的那个目录;工作目录错成上一层 wujies/ 时同一个字符串指到工作区根的化石目录 ruoyi/wujies-admin/。逐目录对照见 [仓库与目录结构](/docs/wujies/5.x/introduction/structure)。

宿主在线更新

后台「系统管理 → 系统更新」换的是正在运行的这个 jar,点下去本服务必然下线,所以换文件与拉起新实例交给外层脚本。这几项配错不会报错,只会「更新并重启」被拒。

键默认值什么时候要改它
app-market.host-update.staging-dir${WUJIES_HOST_UPDATE_DIR:host-update}(相对工作目录)暂存待生效产物、host-update.json、backup/、apply.log;磁盘位置不合适时改
app-market.host-update.current-jar${WUJIES_HOST_JAR:}(空)填正在运行那个产物的绝对路径。留空时检查与照常用,「更新并重启」当场被拒。IDEA 直跑 target/classes 就该留空:那种方式没有可替换的产物
app-market.host-update.apply-script${WUJIES_HOST_APPLY_SCRIPT:}(空)指到 deploy/host/apply-update.sh / .ps1 的绝对路径(参数 --jar --target --backup-dir)。systemd / NSSM / 计划任务托管的实例留空,那类进程管理器该由它自己重启
app-market.host-update.max-package-mb1024宿主 fat jar 连前端产物上百 MB,下载是流式写盘的,不能沿用应用包那个 256MB 内存上限

容器化部署不要用这条路:跨 2026-11-05 这条线时,旧镜像的 entrypoint 与新 jar 的读法对不上,新进程会当场死掉而旧进程已被杀掉。换镜像、并在面板里更新应用。流程与两种运行方式的区别见 [升级](/docs/wujies/5.x/deploy/upgrade)。

插件运行时

键默认值什么时候要改它
app-market.plugin-runtime.enabledyml 未配置 / 注解兜底 true只在排查加载行为时动它,且必须用 -D 传,见下面「不能只写在 yml 里的配置」
app-market.plugin-runtime.dev-modeyml 显式 true控制开发台端点 /app/dev/** 是否注册。这个 true 会打进 jar,compose 没覆盖它,所以线上实例同样带着开发台(受权限注解约束);不需要就改成 false 重新打包
app-market.plugin-runtime.fixed-plugin-pathyml 显式 []指插件工程绝对路径(独立插件仓库根,或含多个 wujies-*-plugin 的目录)。留空 = 扫项目根 plugins/
app-market.plugin-runtime.maven-commandyml 里注释掉mvn 不在 PATH 时指向 mvn.cmd,供开发台在宿主里编译插件后端
app-market.task.timeout-minutes注解兜底 10任务超过多久没有进度判失败。AppTaskTimeoutSweeper 按 update_time 判定(不用 start_time,避免误杀耗时但一直在推进的任务),它是卡死阈值、不是总时长上限
app-market.task.sweep-initial-delay-ms / sweep-interval-ms注解兜底 30000 / 60000清扫器首次延迟与固定间隔,一般不动

同一个开关在源码里有三个视图,其中一个已经不相干:

位置默认值状态
PluginClassPathLoader(宿主,读系统属性)true,读到 true 就让路生效
PluginRuntimeManager 的 @Valuetrue生效
PluginRuntimeManager.isEnabledByProperty()"false"全仓无调用方(死代码),读它会得出相反结论

实际生效的是 true:启动加载器让路,由插件运行时按每插件独立上下文加载。

包安全

键默认值什么时候要改它
app-market.security.mode${WUJIES_SECURITY_MODE:warn}(PackageSecurityInspector 与 SignatureReadinessService 的注解兜底同为 warn)只有当这台部署要对外发布/严格验签时才切 enforce。空串或写错都不报错,代码里一律按 warn 处理
app-market.security.public-key`${WUJIES_PACKAGE_PUBLIC_K

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-b4e639dfae55-guide.svg)

章节导览
THE END

喜欢就支持以下吧

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

回到内容