中国 帮助

配置项

本页是部署时该动哪些配置、动完怎么核对的操作清单,只覆盖三块:产物落位路径(appmarket.deploy.)、应用包安全(appmarket.security.)、平台形态与目录(appmarket.edition 与 appmarke

配置项
封面

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

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

本页是部署时该动哪些配置、动完怎么核对的操作清单,只覆盖三块:产物落位路径(app-market.deploy.*)、应用包安全(app-market.security.*)、平台形态与目录(app-market.edition 与 app-market.catalog.*),以及必须跟着一起确认的 security.* 与 xss.excludeUrls。

逐项索引(每个键在源码里的位置、注解兜底值、消费方)见 [/reference/config](/docs/wujies/1.x/reference/config)。本页不重复那套表,只讲三件从索引表里看不出来的事:真正生效的值是哪一层给的、改完要不要重建 jar 或重启、哪几个键必须与别的组件对齐。

配置从哪来,谁覆盖谁

来源位置覆盖关系
jar 内 ymlwujies-platform/wujies-admin/src/main/resources/application.yml 的 app-market: 段唯一「写出来的值」;被下面两层覆盖
容器环境变量1Panel 包内 docker-compose.yml 的 APP_MARKET_*(值来自安装表单)覆盖 yml
JVM 系统属性 -D容器 deploy/docker/backend/entrypoint.sh;本机 script/prune/start-host.ps1优先级最高
@Value 注解兜底Java 类里的 @Value("${app-market.xxx:默认值}")只在该键完全不存在时生效(不是一层配置)

环境变量名与键名的换算规则是 Spring 的宽松绑定:点与横线都换成下划线、全大写。app-market.deploy.frontend-dir 对应 APP_MARKET_DEPLOY_FRONTEND_DIR。中间件地址(数据源 / Redis / RabbitMQ)不走 app-market.*,由 entrypoint.sh 导出成 SPRING_* 属性,见 [/deploy/backend](/docs/wujies/1.x/deploy/backend)。

application.yml 被打进 wujies-admin.jar。改源码目录里的 yml 之后必须重建再重启:

# 在 wujies-platform 目录下;Maven 不在 PATH 时用 IDEA 自带的 mvn.cmd,见 /deploy/backend
mvn -pl wujies-admin -am -B install -DskipTests
powershell -NoProfile -ExecutionPolicy Bypass -File script\prune\start-host.ps1

1Panel 部署改的是「应用商店 → 已安装 → 参数」,保存后面板会重建容器,不需要手工 docker build;只有改了 Java 或前端 dist/ 才需要重建镜像。

app-market: 的完整配置树

下面是 application.yml 里真实存在的内容(207–289 行),public-key 的值已换成占位符:

app-market:
  deploy:
    # 后端插件 jar 落位目录,必须与宿主启动参数 -Dloader.path 一致
    # ⚠️ loader.path 只加载该目录**根下**的 jar,不递归子目录
    plugin-dir: plugins-dist
    # 前端远程应用落位目录,必须与宿主 /remote-apps/ 的物理路径一致
    # ⚠️ 前后端分离部署时必须改成共享/分发目录,否则前端服务取不到产物
    frontend-dir: ../wujies-admin/app-market-dist/remote-apps
  # 应用包安全检查:产物白名单 + 签名校验
  security:
    # off     完全不检查(等价于改造前的行为)
    # warn    检查并记录问题,但照常安装/上架
    # enforce 有问题就拒绝    ← 当前
    mode: enforce
    # 包签名公钥(X.509 SubjectPublicKeyInfo 的 PEM,或裸 base64)
    # 留空表示尚未配置校验能力 —— 此时 enforce 会拒绝所有包并在报错里说明原因
    public-key: |
      -----BEGIN PUBLIC KEY-----
      <你的公钥>
      -----END PUBLIC KEY-----
    # frontend/ 下允许的文件类型。前端目录是宿主的静态资源目录,
    # 白名单之外一律拒绝;且 .jsp/.php/.war/.jar 等无论如何都不允许(代码里硬拒)
    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
  # 版本形态:official(官方版,默认) / client(用户版)
  edition: official
  # 应用目录(catalog)的访问方式
  catalog:
    # local  直连本库(默认,单机部署用这个)
    # remote 走 base-url 指向的目录服务(多部署集中时用)
    mode: local
    # 目录服务地址;mode=remote 时必填,否则启动即失败
    base-url: ''
    # 服务间共享令牌。服务端与调用方配成一致;
    # 服务端留空表示 /app/catalog/** 不校验调用方 —— 内网自用可以,公网必须配
    token: ''
    # 远程模式的超时:目录读取不该拖垮安装流程,宁可快速失败
    connect-timeout-ms: 3000
    read-timeout-ms: 15000

public-key 当前值对应 wujies/wujies-plugins/keys/private.pem(该目录已 gitignore)。正式环境必须自己生成一对:wujies/wujies-plugins/package.ps1 -Keygen,然后把新公钥贴进 public-key 并重建宿主 + 重启。公钥不是秘密;私钥只留在发布方。流程见 [/package/signing](/docs/wujies/1.x/package/signing)。

⚠️ yml 里那段注释仍写着 keygen plugins/keys、对应 plugins/keys/private.pem —— 那是过时路径,wujies-platform/plugins/ 目录已经不存在(插件本体与密钥都在 wujies/wujies-plugins/)。

逐项:哪个值真的生效

配置项yml 里写的注解兜底容器里被覆盖成
deploy.plugin-dirplugins-distplugins-dist/app/plugins-dist
deploy.frontend-dir../wujies-admin/app-market-dist/remote-apps../plus-ui/app-market-dist/remote-apps(与 yml 不一致)/app/remote-apps
security.modeenforcewarn(与 yml 不一致)安装表单的 SECURITY_MODE,默认 warn
security.public-key源码里的开发公钥空串无环境变量(只能改 yml + 重建镜像)
security.allowed-frontend-extensions22 个扩展名同一份列表无环境变量
editionofficialofficialofficial(服务端包)/ client(用户版包)
catalog.modelocallocallocal / remote
catalog.base-url空空客户端版由表单 CATALOG_BASE_URL 填
catalog.token空空表单 CATALOG_TOKEN(服务端预填随机值)
catalog.connect-timeout-ms / read-timeout-ms3000 / 150003000 / 15000无环境变量
plugin-runtime.enabledyml 里没有这个键true

本文导览

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

章节导览
THE END

喜欢就支持以下吧

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

回到内容