> 本文整理自平台文档 docs/wujies/1.x/reference/config.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-ce30464dc256-cover.svg)
本页收录「应用市场」的全部可配置项。每项都标注了它在源码中的位置。
两者不一致时必须按 yml 的实际值去理解运行行为,本页在「默认值」列用 yml 值 / 注解兜底 的形式标出。
- yml 显式值:
wujies-platform/wujies-admin/src/main/resources/application.yml里写出来的值。 - 注解兜底值:
@Value("${app-market.xxx:默认值}")里的默认值。没有在 yml 里出现的键,以注解为准;
spring.profiles.active 当前为 prod。仓库里只有 application.yml、application-dev.yml、application-prod.yml 三个 profile 文件(没有 application-docker.yml),其中后面两个都没有任何 app-market.* 配置 —— 所以 Spring profile 层面没有覆盖,应用市场的配置只在 application.yml 一处。
唯一的例外是容器化部署:1Panel 部署包里的 docker-compose.yml 用环境变量覆盖了其中若干项,见 [容器化部署的覆盖方式](#容器化部署的覆盖方式)。
public-key、edition、catalog.*、security.* 都是 Spring 启动期读入(@Value / @PostConstruct)。 改了这些,必须重建 wujies-admin.jar 并重启才生效 —— application.yml 被打进 jar,只改源码目录里的 yml 而不重新打包,等于没改。
部署路径
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
app-market.deploy.plugin-dir | string(路径) | plugins-dist / 注解兜底 plugins-dist(容器化部署被环境变量覆盖为 /app/plugins-dist) | 后端插件 jar 的落位目录,也是宿主启动参数 -Dloader.path 指向的目录。包内 assets.backend 释放到这里根下。loader.path 不递归子目录,所以迁移脚本落在 migrations/<appCode>/ 子目录里是安全的。消费方:AppPackageDeployService、PluginRuntimeManager、PluginAppInstaller、AppMigrationService、宿主的 PluginClassPathLoader(读系统属性)。 |
app-market.deploy.frontend-dir | string(路径) | yml 显式 ../wujies-admin/app-market-dist/remote-apps / 注解兜底 ../plus-ui/app-market-dist/remote-apps(两者不一致,见下) | 前端远程应用产物的落位目录。包内 frontend/ 整棵树释放到 <frontend-dir>/<appCode>/(去掉 frontend/ 前缀)。该物理目录必须就是宿主 /remote-apps/<appCode>/ 的位置。消费方:AppPackageDeployService、PluginAppInstaller。 |
app-market:
deploy:
# 后端插件 jar 落位目录,必须与宿主启动参数 -Dloader.path 一致
# ⚠️ loader.path 只加载该目录**根下**的 jar,不递归子目录
plugin-dir: plugins-dist
# 前端远程应用落位目录,必须与宿主 /remote-apps/ 的物理路径一致
# ⚠️ 前后端分离部署时必须改成共享/分发目录,否则前端服务取不到产物
frontend-dir: ../wujies-admin/app-market-dist/remote-apps
两个值都是相对路径,按进程工作目录解析(Paths.get(...).toAbsolutePath())。script/prune/start-host.ps1 因此会先 Set-Location 到 wujies-platform 根目录,工作目录错了就会把产物写到别处。
⚠️ frontend-dir 的 yml 显式值与注解兜底值不一致:yml 里是 ../wujies-admin/...(工作区顶层的 前端产物落位目录,基准是工作目录 wujies-platform/),注解兜底是 ../plus-ui/...(plus-ui 自己的 仓库根)。以 yml 为准;而 plus-ui 的 dev server / 构建只认自己仓库根下的 app-market-dist (vite/plugins/appMarketStatic.ts),两者是独立物理目录 —— 详见 [仓库与目录结构](/docs/wujies/1.x/guide/structure)。
插件运行时
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
app-market.plugin-runtime.enabled | boolean | yml 未配置 / 注解兜底 true | 是否启用「每插件独立上下文」运行时。开启时部署完直接热加载(不用重启);关闭则退回 PluginClassPathLoader + loader.path 的启动期加载,部署只落位、重启才生效。这个键必须用 JVM 参数 -D 设置,不能只写在 yml 里,见 [不能只写在 yml 里的配置](#不能只写在-yml-里的配置)。 |
app-market.task.timeout-minutes | long(分钟) | yml 未配置 / 注解兜底 10 | 任务超过多久没有任何进度就判定为失败。由 AppTaskTimeoutSweeper 按 update_time 判定(不用 start_time,避免误杀耗时较长但一直在推进的任务)。只在进度卡死时触发,不是任务总时长上限。 |
app-market.task.sweep-initial-delay-ms | long(毫秒) | yml 未配置 / 注解兜底 30000 | 卡死任务清扫器的首次延迟(@Scheduled 的 initialDelayString)。 |
app-market.task.sweep-interval-ms | long(毫秒) | yml 未配置 / 注解兜底 60000 | 卡死任务清扫器的固定间隔(@Scheduled 的 fixedDelayString)。 |
@Value("${app-market.deploy.plugin-dir:plugins-dist}")
private String pluginDir;
@Value("${" + ENABLED_PROPERTY + ":true}") // ENABLED_PROPERTY = "app-market.plugin-runtime.enabled"
private boolean enabled;
| 位置 | 默认值 |
|---|---|
PluginClassPathLoader.java(宿主,读系统属性) | "true" —— 让路 |
PluginRuntimeManager 的 @Value(实际注入值) | true |
PluginRuntimeManager.isEnabledByProperty()(读系统属性) | "false",且全仓无调用方(死代码) |
PluginRuntimeManager 的类注释 | 写成「默认 false(仍走旧路径)」 |
实际生效的是 true:启动加载器让路,由插件运行时按每插件独立上下文加载。类注释与 isEnabledByProperty() 的 "false" 都是未同步的残留。application.yml 里没有这个键, 全靠注解兜底;script/、Dockerfile、docker-compose 里也都不设置它。
应用目录(catalog)
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
app-market.catalog.mode | enum local / remote | yml 显式 local / 注解兜底 local | 目录访问方式。local 直连本库,remote 走 base-url 指向的目录服务。装配用 @ConditionalOnProperty 二选一:LocalAppCatalogService 匹配 local(matchIfMissing = true),RemoteAppCatalogService 匹配 remote。刻意不用 `@ConditionalOnMiss |
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-ce30464dc256-guide.svg)


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