配置项索引

本页收录「应用市场」的全部可配置项。每项都标注了它在源码中的位置。

• yml 显式值：wujies-platform/wujies-admin/src/main/resources/application.yml 里写出来的值。
• 注解兜底值：@Value("${app-market.xxx:默认值}") 里的默认值。没有在 yml 里出现的键，以注解为准； 两者不一致时必须按 yml 的实际值去理解运行行为，本页在「默认值」列用 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 用环境变量覆盖了其中若干项，见 容器化部署的覆盖方式。

部署路径复制标题链接

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），两者是独立物理目录 —— 详见 仓库与目录结构。

插件运行时复制标题链接

@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;

应用目录（catalog）复制标题链接

  catalog:
    # local  直连本库（默认，单机部署用这个）
    # remote 走 base-url 指向的目录服务（多部署集中时用）
    mode: local
    # 目录服务地址；mode=remote 时必填，否则启动即失败
    base-url: ''
    # 服务间共享令牌。服务端（本文件的这个值）与调用方配成一致；
    # 服务端留空表示 /app/catalog/** 不校验调用方 —— 内网自用可以，公网必须配。
    token: ''
    # 远程模式的超时：目录读取不该拖垮安装流程，宁可快速失败
    connect-timeout-ms: 3000
    read-timeout-ms: 15000

目录服务接口 /app/catalog/** 已在 security.excludes 里（服务间调用没有本机会话）， 身份由 app-market.catalog.token 兜底。详见 目录与版本形态。

版本形态（edition）复制标题链接

  edition: official

包安全（security）复制标题链接

  security:
    # off     完全不检查（等价于改造前的行为）
    # warn    检查并记录问题，但照常安装/上架
    # enforce 有问题就拒绝    ← 当前
    mode: enforce
    public-key: |
      -----BEGIN PUBLIC KEY-----
      MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAowY2/3CZDZrqwo7jber8
      ...
      -----END PUBLIC KEY-----
    allowed-frontend-extensions: >-
      .js,.mjs,.cjs,.css,.json,.svg,.png,.jpg,.jpeg,.gif,.webp,.ico,.bmp,
      .woff,.woff2,.ttf,.otf,.eot,.map,.txt,.html,.wasm

java -cp wujies-modules/wujies-app-market/target/classes `
    cn.wujies.appmarket.security.PackageSignerMain keygen wujies/wujies-plugins/keys

其它宿主配置复制标题链接

应用市场本身没有独立的文件上传路径配置：安装包走 wujies-common-oss（SysOssService.upload）， 对象存储键前缀是代码里的常量 app-market/package/（包）与 app-market/asset/（资产），不可配置。 本机落位路径由 app-market.deploy.* 决定。相关的宿主级上限与临时目录如下。

spring:
  servlet:
    multipart:
      # 单个文件大小
      max-file-size: 100MB
      # 设置总上传的文件大小
      max-request-size: 1000MB

mybatis-plus:
  # 多包名使用 例如 cn.wujies.**.mapper,org.xxx.**.mapper
  mapperPackage: cn.wujies.**.mapper
  # 对应的 XML 文件位置
  mapperLocations: classpath*:mapper/**/*Mapper.xml
  # 实体扫描，多个package用逗号或者分号分隔
  typeAliasesPackage: cn.wujies.**.domain

容器化部署的覆盖方式复制标题链接

wujies-platform/deploy/1panel/apps/wujies-platform-{server,client}/5.6.3/docker-compose.yml 用环境变量覆盖上面这些配置项。 Spring Boot 的 relaxed binding 会把大写下划线映射成小写点号，所以 APP_MARKET_CATALOG_BASE_URL 就是 app-market.catalog.base-url：

      APP_MARKET_EDITION: official
      APP_MARKET_CATALOG_MODE: local
      APP_MARKET_CATALOG_BASE_URL: ""
      APP_MARKET_CATALOG_TOKEN: ${CATALOG_TOKEN}
      APP_MARKET_DEPLOY_PLUGIN_DIR: /app/plugins-dist
      APP_MARKET_DEPLOY_FRONTEND_DIR: /app/remote-apps
      APP_MARKET_SECURITY_MODE: ${SECURITY_MODE}

这几个覆盖值与本地部署的默认值不同，替换了 yml 里的相对路径：

必须与其它东西对齐的配置项复制标题链接

这一节里的配置改错了不会报错，只会静默失效 —— 表现为「装上了却跑不起来」「升级成功了页面还是老样子」。

plugin-dir ↔ -Dloader.path复制标题链接

app-market.deploy.plugin-dir 与宿主的启动参数 -Dloader.path 必须是同一个目录。 loader.path 只被打包后的 PropertiesLauncher 识别，从 IDE 直接跑主类时会被静默忽略 （PluginClassPathLoader 就是为消灭这个情况而存在的）。

# script/prune/start-host.ps1
$args += "-Dloader.path=$PluginDir"     # 默认 $PluginDir = plugins-dist

两处默认值同为 plugins-dist，都按工作目录解析。另外 PluginClassPathLoader 读的是系统属性 app-market.deploy.plugin-dir（不是 yml），兜底也是 plugins-dist —— 三处默认值必须一致。 实际设置它的地方只有两处：

# application.yml（相对路径）
app-market.deploy.plugin-dir: <dir>

# 系统属性兜底（PluginClassPathLoader.java 同名属性，默认 plugins-dist）
-Dapp-market.deploy.plugin-dir=<dir>

# 本机启动（script/prune/start-host.ps1）
-Dloader.path=<dir>

script/prune/prune-plugins.ps1 / .sh 也各自硬编码同一个 plugins-dist 作为推断默认值；清理脚本与启动脚本 指向不同目录时会清理错地方。

exec java $JAVA_OPTS -Dapp-market.deploy.plugin-dir="${PLUGIN_DIR:-/app/plugins-dist}" -jar /app/app.jar

frontend-dir ↔ 宿主 /remote-apps/<appCode>/ 的物理路径复制标题链接

AppRuntimeController 拼出的入口是 /remote-apps/<appCode>/<文件名>，前端用动态 import() 加载它。 这个 URL 前缀由三处共同约定：

1. AppRuntimeController 的常量 REMOTE_APP_URL_PREFIX = "/remote-apps/"；
2. 前端静态服务插件 plus-ui/vite/plugins/appMarketStatic.ts —— 把 URL 前缀 /remote-apps/ 映射到 磁盘目录 plus-ui/app-market-dist/（dev 中间件直接返回文件，build 时整目录复制进 dist/）；
3. 后端落位目录 app-market.deploy.frontend-dir，yml 当前值是 ../wujies-admin/app-market-dist/remote-apps （注解兜底 ../plus-ui/app-market-dist/remote-apps，与 yml 不一致）。

三者的相对位置关系：后端工作目录是 wujies-platform/，所以 ../wujies-admin/app-market-dist/remote-apps 指向工作区顶层那个 wujies-admin/ 目录；而 plus-ui 的 dev server / 构建只认自己仓库根下的 app-market-dist/（appMarketStatic.ts 里 path.resolve(root, 'app-market-dist')）。 两者是独立物理目录，"后端落位成功"与"浏览器能取到"可能对不上 —— 详见 仓库与目录结构。

这个物理目录随环境变化，代码里没有单一真相：

plus-ui/vite.config.ts 的 server.proxy 没有 /remote-apps 规则（只有 VITE_APP_BASE_API → 后端端口）， 所以 dev 下这个 URL 靠上面第 2 条的中间件、不是代理。

c-frontend-dir ↔ 宿主 /apps-c/<appCode>/ 的物理路径复制标题链接

C 端（PC / H5）是整站，不是运行期模块 —— 它自带 index.html 与路由，由一个独立的 URL 前缀对外提供。应用包里的 frontend-c/ 整棵树被释放到 app-market.deploy.c-frontend-dir/<appCode>/：

为什么与 /remote-apps/ 分两个根：托管方式不同。那份是被宿主 import() 的 ESM 模块 （只要 index.js 一个入口），这份是一个站点（要 index.html、可能的 assets/*.js）。 混在一个目录里，<appCode> 会撞车。

前端侧的构建期变量复制标题链接

后端 app-market.* 之外，前端还有两个影响远程应用解析的构建期变量。

# plus-ui/.env.development 第 41 行（.env.production / .env.docker 同理）
# VITE_APP_MARKET_EDITION = 'client'

plus-ui/.gitignore 忽略了 app-market-dist/ —— 那是构建产物，不进版本管理。

security.public-key：启动期读入，改了必须重建 + 重启复制标题链接

PackageSecurityInspector 与 SignatureReadinessService 都用 @Value 注入它，只在应用启动时解析一次。 运行时改 yml 无效，改源码目录里的 yml 也无效（application.yml 被打进 wujies-admin.jar）。

正确顺序：改 yml → 重新 mvn -pl wujies-admin -am package → 重启进程。

package.ps1 -SyncPublicKey 会把新公钥写进 application.yml 的 public-key: 块，但不会重建宿主 —— 它会提醒这一点。没重启就发布，表现为「刚用新私钥签的包被 enforce 拒了」。

不能只写在 yml 里的配置复制标题链接

security.excludes 里与目录接口有关的一条复制标题链接

security:
  excludes:
    # 应用目录服务接口：服务间调用，没有本机会话。
    # 已由 AppCatalogApiController 用共享令牌（app-market.catalog.token）兜底。
    - /app/catalog/**

把 /app/catalog/** 从排除列表里删掉，会让远程目录模式（catalog.mode=remote）立刻失效 —— 调用方没有本机会话，拿不到 token 就会被 Sa-Token 拦下。

security.tenant.excludes 里与应用市场相关的表复制标题链接

application.yml 的 security.tenant.excludes 列出不参与多租户隔离的表。其中与应用市场相关的有 6 张：

  tenant:
    excludes:
      # 应用市场：应用目录属于平台级数据，不按租户隔离
      # （带 tenant_id 的 app_install / app_install_task / app_subscription / app_audit_log /
      #   app_schema_history 不在此列，交由多租户插件自动隔离）
      - app_info
      - app_version
      - app_category
      - app_version_menu
      - app_dependency
      - app_plan

相对的，以下表带 tenant_id 且刻意不排除，由多租户插件自动加上租户条件： app_install（租户应用安装实例）、app_install_task（安装任务与日志）、app_subscription（订阅）、 app_audit_log（审计）、app_schema_history（迁移记账）。

未找到的项复制标题链接

以下内容在本仓库中未找到可配置项，因此本页不列出（列出来就是在编造默认值）：

• 应用包解压上限（单条目 256MB、条目总数 5000）：是 AppPackageDeployService / PackageDigest 里的 private static final 常量，不可通过配置调整。
• 对象存储键前缀 app-market/package/ 与 app-market/asset/：AppMarketConstants 里的常量，不可配置。
• 应用市场专用的本地上传目录：未找到（落位路径由 app-market.deploy.* 决定，上传走 OSS； 临时目录用的是 Spring 自己的 spring.servlet.multipart.location，宿主 yml 里没设置）。
• Spring profile 级的 app-market.* 覆盖：未找到（application-dev.yml / application-prod.yml 均无 app-market 出现）。容器化部署的环境变量覆盖见上一节，不属于 profile。
• security.excludes 中其它与应用市场相关的条目：未找到（只有 /app/catalog/** 一条）。

相关阅读复制标题链接

• 配置与部署
• 目录与版本形态
• 插件运行时
• 安全模式