中国 帮助

安全校验模式

这一页只回答三个问题:appmarket.security.mode 三档各自拦什么、某个部署实际生效的是哪一档、切到 enforce 之前必须做完什么。 签名怎么算、密钥怎么管见 [密钥与签名](/docs/wujies/1.x/pac

安全校验模式
封面

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

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

这一页只回答三个问题:app-market.security.mode 三档各自拦什么、某个部署实际生效的是哪一档、切到 enforce 之前必须做完什么。

签名怎么算、密钥怎么管见 [密钥与签名](/docs/wujies/1.x/package/signing);产物白名单允许哪些文件见 [包安全与签名](/docs/wujies/1.x/advanced/security)。本页不重复那些内容。

---

这个开关拦什么

检查只有一处实现:wujies-platform/wujies-modules/wujies-app-market/src/main/java/cn/wujies/appmarket/security/PackageSecurityInspector.java。它判两件事:

判什么判据不通过时的原话(Report.problems)
产物白名单包根只允许 app.json 与 signature.txt;顶层只允许 backend/、frontend/、migrations/;backend/ 只允许清单声明的那一个 .jar;migrations/ 只允许 .sql;frontend/ 只允许白名单扩展名包根出现不允许的文件: …、不允许的顶层目录: …、backend/ 下出现清单未声明的产物: …
签名包根有 signature.txt,且能用服务端的 app-market.security.public-key 验过应用包未签名(缺少 signature.txt)。…、应用包带签名,但服务端未配置 app-market.security.public-key,无法校验。、应用包签名校验失败: …

它不判断代码好坏,也不区分发布方——只回答"这个包是不是我签发的、有没有被改过"。所以"还没开放第三方上架"不是把模式调松的理由。

两个校验点都调 inspectOrThrow,缺一不可:

校验点谁调校验的是哪一份字节结论落在哪
上传时AppPackageController.parse(POST /app/package/parse)刚上传的那份响应字段 securityNote
下载后、解包前AppPackageDeployService.deploy(该类第 188 行,排在 verifyChecksum 之后)即将落位的那份部署报告的 security 字段

被 enforce 拒掉时抛 ServiceException,文案固定以这句开头,可直接拿它 grep 日志:

应用包安全检查未通过(app-market.security.mode=enforce):…

因为校验在解包之前,被拒时磁盘上不会落位任何文件(这一点实测过)。另外,问题条目最多只报前 6 条(MAX_REPORTED),汇报里的「问题 N 项」是截断后的数量。

---

三档模式的实际差别

模式inspect() 给出的结论会不会拦服务端日志接口响应 / 部署报告
offaccepted 恒为 true(问题照样被算出来)不拦不写(日志分支显式排除了 off)仍带出问题清单
warnaccepted 恒为 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: truewujies-platform/deploy/1panel/apps/wujies-platform-server/5.6.3/data.yml 与 ...-client/5.6.3/data.yml;compose 里是 APP_MARKET_SECURITY_MODE: ${SECURITY_MODE}
jar 内 yml(本机直跑时生效)enforcewujies-platform/wujies-admin/src/main/resources/application.yml 的 app-market.security.mode
代码注解兜底(yml 缺失或键被删时)warnPackageSecurityInspector 与 SignatureReadinessService 的 @Value("${app-market.security.mode:warn}")

覆盖优先级(高 → 低):JVM 系统属性 -Dapp-market.security.mode=… → 环境变量 APP_MARKET_SECURITY_MODE → jar 内 application.yml → 注解兜底。

于是同一份代码在两种部署形态下默认值相反:

部署形态默认生效值怎么改要重建什么
本机直跑(wujies-platform/script/prune/start-host.ps1)enforce(yml 值)改 application.yml 后重启;start-host.ps1 -Build 会顺带重新 mvn -pl wujies-admin -am -B packageyml 打在 jar 里,改了就必须重建宿主
1Panel 应用包warn(表单值,盖掉镜像里 yml 的 enforce)安装表单里填,或装完到 1Panel「应用 → 参数」改 应用包检查模式 保存不用重建镜像:面板会重建容器;参数细节见 [/deploy/configuration](/docs/wujies/1.x/deploy/configuration)

public-key 没有环境变量:仓库里两个 1Panel 包的 data.yml 与 docker-compose.yml 都没有公钥字段,deploy/docker/backend/entrypoint.sh 也不导出它。所以容器里生效的公钥,就是构建镜像时打进 jar 的那个 application.yml 里的那一把——而按该文件自己的注释,那是"开发验证阶段生成的"密钥。

后果:1Panel 表单里把模式调成 enforce,用你自己 wujies/wujies-plugins/keys/private.pem 签的包会全部落到 invalid,报「签名与包内容不匹配」。这时候看起来像"签名坏了",实际是公钥不匹配。

要换公钥只有两条路:改 application.yml 的 public-key 后重建后端镜像(只重启容器没用),或自己在 compose 里加 APP_MARKET_SECURITY_PUBLIC_KEY(PEM 是多行文本,注意 YAML 块标量写法)。

---

切到 enforce 之前必须做完两件事

### 1. 公钥就位,且与发布私钥成对

没配公钥时 enforce 会拒绝所有包(包括你自己签的),报错里会明说「未配置公钥」而不是「签名无效」。打包时顺手就能核对:package.ps1 会拿本次签名用的公钥与宿主 application.yml 的 public-key 比对,一致打 ✓,不一致或为空会

本文导览

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

章节导览
THE END

喜欢就支持以下吧

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

回到内容