> 本文整理自平台文档 docs/wujies/5.x/platform/package/security-modes.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-892aae526a83-cover.svg)
这一页只回答三个问题:app-market.security.mode 三档各自拦什么、某个部署实际生效的是哪一档、切到 enforce 之前必须做完什么。
签名怎么算、密钥怎么管见 [密钥与签名](/docs/wujies/5.x/platform/package/signing);产物白名单允许哪些文件见 [包安全与签名](/docs/wujies/5.x/platform/package/security)。本页不重复那些内容。
---
这个开关拦什么
检查只有一处实现:共用内核 wujies-platform/wujies-modules/wujies-market-core/src/main/java/cn/wujies/appmarket/security/PackageSecurityInspector.java —— 中心上架服务与各平台部署跑的是同一份字节码(判据必须一致,否则会出现「上架说签名有效、安装说无效」的死局)。它判两件事:
| 判什么 | 判据 | 不通过时的原话(Report.problems) |
|---|---|---|
| 产物白名单 | 包根只允许 app.json、signature.txt 与路由清单 route-index.json;顶层只允许 backend/、frontend/、migrations/;backend/ 只允许清单声明的那一个 .jar;migrations/ 只允许 .sql;frontend/ 只允许白名单扩展名 | 包根出现不允许的文件: …、不允许的顶层目录: …、backend/ 下出现清单未声明的产物: … |
| 签名 | 包根有 signature.txt,且能用服务端的 app-market.security.public-key 验过 | 应用包未签名(缺少 signature.txt)。…、应用包带签名,但服务端未配置 app-market.security.public-key,无法校验。、应用包签名校验失败: … |
它不判断代码好坏,也不区分发布方——只回答"这个包是不是我签发的、有没有被改过"。所以"还没开放第三方上架"不是把模式调松的理由。
两个校验点都调 inspectOrThrow,缺一不可:
| 校验点 | 谁调 | 校验的是哪一份字节 | 结论落在哪 |
|---|---|---|---|
| 上传时 | 中心上架服务的 PackageAdminController.parse(POST /app/package/parse,鉴权头 X-Market-Token) | 刚上传的那份 | 响应字段 securityNote |
| 下载后、解包前 | 本部署的 AppPackageDeployService.deploy(该类约 216 行,排在 verifyChecksum 之后) | 即将落位的那份 | 落位报告的 security 字段 |
被 enforce 拒掉时抛 ServiceException,文案固定以这句开头,可直接拿它 grep 日志:
应用包安全检查未通过(app-market.security.mode=enforce):…
因为校验在解包之前,被拒时磁盘上不会落位任何文件(这一点实测过)。另外,问题条目最多只报前 6 条(MAX_REPORTED),汇报里的「问题 N 项」是截断后的数量。
---
三档模式的实际差别
| 模式 | inspect() 给出的结论 | 会不会拦 | 服务端日志 | 接口响应 / 部署报告 |
|---|---|---|---|---|
off | accepted 恒为 true(问题照样被算出来) | 不拦 | 不写(日志分支显式排除了 off) | 仍带出问题清单 |
warn | accepted 恒为 true | 不拦 | 应用包安全检查发现问题(warn,仍放行): 模式=warn, 签名=…, 问题 N 项: … | 同上 |
enforce | 有问题则 accepted=false | 拦(上传与部署两处都拦) | 应用包安全检查未通过(enforce,将拒绝): … | 无问题时才写进报告:模式=enforce, 签名=有效, 无问题 |
Report.summary() 不看模式,所以 off 下上传与部署的响应里照样能看到 模式=off, 签名=无签名文件, 问题 1 项: …。off 省掉的只是拦截与日志,检查本身仍然跑。类注释里那句"完全不检查"只在行为意义上成立。
normalizeMode(PackageSecurityInspector 末尾)会 trim + 转小写,只认 off / warn / enforce,其余一律当 warn,不报错。1Panel 表单那一栏是 type: text + rule: paramCommon,没有枚举校验,所以 enforce 这类写法多半会被 trim 救回来,而 strict、on、true 会悄悄退化成 warn。
另外,自检接口返回的 mode 字段是原样字符串(SignatureReadinessService 直接把 @Value 注入的值放进报告),不做归一化——它显示 strict 时实际按 warn 跑。判断当前行为看日志/部署报告里的 模式=,不要只看自检报告那个字段。
---
生效值来自哪:同一个键有三个来源
| 来源 | 值 | 位置 |
|---|---|---|
| 环境变量(容器化部署) | 1Panel 安装表单里的 SECURITY_MODE,默认 warn、required: true | wujies-platform/deploy/1panel/apps/wujies-platform-server/5.6.2/data.yml;compose 里是 APP_MARKET_SECURITY_MODE: ${SECURITY_MODE} |
| jar 内 yml(本机直跑时生效) | enforce | wujies-platform/wujies-admin/src/main/resources/application.yml 的 app-market.security.mode |
| 代码注解兜底(yml 缺失或键被删时) | warn | PackageSecurityInspector 与 SignatureReadinessService 的 @Value("${app-market.security.mode:warn}") |
中心上架服务读的是同一个键名(内核 PackageSecurityInspector 的 @Value),它自己那份 wujies-market/src/main/resources/application.yml 写的是 ${APP_MARKET_SECURITY_MODE:enforce} —— 上传期那次拦截由中心的取值决定,落位期那次由本部署的取值决定,两边都要各查一次。
覆盖优先级(高 → 低):JVM 系统属性 -Dapp-market.security.mode=… → 环境变量 APP_MARKET_SECURITY_MODE → jar 内 application.yml → 注解兜底。
于是同一份代码在两种部署形态下默认值相反:
| 部署形态 | 默认生效值 | 怎么改 | 要重建什么 |
|---|---|---|---|
| 本机直跑(平台仓库根手工起 JVM) | enforce(yml 值) | 改 application.yml 后停宿主 → 重新构建 → 再起。以前那步用 script/prune/start-host.ps1,它已在 2026-10-26 的 d0cc5cd90「配置与脚本做减法」里删除 | yml 打在 jar 里,改了就必须重建宿主 |
| 1Panel 应用包 | warn(表单值,盖掉镜像里 yml 的 enforce) | 安装表单里填,或装完到 1Panel「应用 → 参数」改 应用包检查模式 保存 | 不用重建镜像:面板会重建容器;参数细节见 [/deploy/configuration](/docs/wujies/5.x/deploy/configuration-guide) |
public-key 没有环境变量:仓库里 1Panel 包的 data.yml 与 docker-compose.yml 都没有公钥字段,deploy/docker/backend/entrypoint.sh 也不导出它。所以容器里生效的公钥,就是构建镜像时打进 jar 的那个 application.yml 里的那一把——而按该文件自己的注释,那是"开发验证阶段生成的"密钥。
后果:1Panel 表单里把模式调成 enforce,用你自己各应用仓库 keys/private.pem(wujies-<code>-plugin/keys/private.pem)签的包会全部落到 invalid,报「签名与包内容不匹配」。这时候看起来像"签名坏了",实际是公钥不匹
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-892aae526a83-guide.svg)


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