中国 帮助

配置项索引

本页收录「应用市场」的全部可配置项。每项都标注了它在源码中的位置。 yml 显式值:wujiesplatform/wujiesadmin/src/main/resources/application.yml 里写出来的值。 注解兜底值

配置项索引
封面

> 本文整理自平台文档 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-dirstring(路径)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-dirstring(路径)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.enabledbooleanyml 未配置 / 注解兜底 true是否启用「每插件独立上下文」运行时。开启时部署完直接热加载(不用重启);关闭则退回 PluginClassPathLoader + loader.path 的启动期加载,部署只落位、重启才生效。这个键必须用 JVM 参数 -D 设置,不能只写在 yml 里,见 [不能只写在 yml 里的配置](#不能只写在-yml-里的配置)。
app-market.task.timeout-minuteslong(分钟)yml 未配置 / 注解兜底 10任务超过多久没有任何进度就判定为失败。由 AppTaskTimeoutSweeper 按 update_time 判定(不用 start_time,避免误杀耗时较长但一直在推进的任务)。只在进度卡死时触发,不是任务总时长上限。
app-market.task.sweep-initial-delay-mslong(毫秒)yml 未配置 / 注解兜底 30000卡死任务清扫器的首次延迟(@Scheduled 的 initialDelayString)。
app-market.task.sweep-interval-mslong(毫秒)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.modeenum local / remoteyml 显式 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)

章节导览
THE END

喜欢就支持以下吧

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

回到内容