> 本文整理自平台文档 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 内 yml | wujies-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-dir | plugins-dist | plugins-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.mode | enforce | warn(与 yml 不一致) | 安装表单的 SECURITY_MODE,默认 warn |
security.public-key | 源码里的开发公钥 | 空串 | 无环境变量(只能改 yml + 重建镜像) |
security.allowed-frontend-extensions | 22 个扩展名 | 同一份列表 | 无环境变量 |
edition | official | official | official(服务端包)/ client(用户版包) |
catalog.mode | local | local | local / remote |
catalog.base-url | 空 | 空 | 客户端版由表单 CATALOG_BASE_URL 填 |
catalog.token | 空 | 空 | 表单 CATALOG_TOKEN(服务端预填随机值) |
catalog.connect-timeout-ms / read-timeout-ms | 3000 / 15000 | 3000 / 15000 | 无环境变量 |
plugin-runtime.enabled | yml 里没有这个键 | true |
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-41846a23f566-guide.svg)


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