适用范围与准备
适用于你维护的 HTTPS 代理订阅或配置下载脚本已主动设置 --pinnedpubkey,升级服务后出现公钥不匹配。没有配置公钥固定的普通客户端不应凭空添加这个选项;示例只访问无令牌的自有诊断端点。
先区分原因
公钥固定在通常的 TLS 身份校验之外,要求服务端公钥与预先认可的公钥文件或 SHA-256 值一致。证书续期若更换密钥可能触发不匹配;也可能连错服务器或遭到异常中间代理,不能看到错误 90 就自动更新为刚收到的公钥。
按顺序操作
- 在脚本中查找 --pinnedpubkey,记录 curl 版本、TLS 后端与 pin 的可信来源。确认错误确为公钥固定不匹配;CA 文件读取失败、普通证书不受信任应分别处理。不要将含订阅令牌的 URL 放进公开日志。
- 核对目标域名、端口及代理链路,向服务管理员确认是否计划轮换密钥。如果使用 HTTPS 代理,还要区分目标的 --pinnedpubkey 与代理自身的 --proxy-pinnedpubkey,两者认证对象不同。
- 只有从独立可信渠道核实新公钥后,才更新本地固定值。以下示例读取管理员预先提供的单个 PEM/DER 公钥文件;它不是证书包或私钥。不要从当前失败连接直接抓取公钥并立刻将其设为可信。
- 在没有订阅秘密的同一受控服务诊断端点先验证。采用私有 CA 时另行配置正确的 --cacert,公开 CA 则按原信任配置保留;不能把删除 pin 或添加 -k 作为通过办法。
- 确认固定值更新和正常证书校验同时有效后,再让原任务使用正式 URL 下载。继续核对内容确为预期配置、格式可解析;保存 HTTP 错误页不算订阅恢复。
curl.exe --disable --fail --connect-timeout 10 --max-time 30 --pinnedpubkey ./expected-public-key.pem --output probe.body https://config.example.com/health| 检查 | 不能互相替代的原因 |
|---|---|
| 证书链与域名校验 | 证明当前 TLS 身份满足信任配置 |
| 公钥固定 | 额外限制可接受的公钥 |
| 配置内容验证 | 确认返回的是任务需要的配置 |
怎样确认有效
正确公钥匹配且证书校验通过,配置内容符合原任务需求。可以在自有隔离服务中验证错误公钥会被拒绝;本文未拿真实订阅或用户令牌进行测试。
无效时恢复与下一步
保留原固定值及变更依据。若管理员尚不能确认新密钥,停止自动下载并保留已有可用配置,不用无限重试或清空本地配置来消除报错。