适用范围与准备

适用于你维护的 HTTPS 代理订阅或配置下载脚本已主动设置 --pinnedpubkey,升级服务后出现公钥不匹配。没有配置公钥固定的普通客户端不应凭空添加这个选项;示例只访问无令牌的自有诊断端点。

先区分原因

公钥固定在通常的 TLS 身份校验之外,要求服务端公钥与预先认可的公钥文件或 SHA-256 值一致。证书续期若更换密钥可能触发不匹配;也可能连错服务器或遭到异常中间代理,不能看到错误 90 就自动更新为刚收到的公钥。

按顺序操作

  1. 在脚本中查找 --pinnedpubkey,记录 curl 版本、TLS 后端与 pin 的可信来源。确认错误确为公钥固定不匹配;CA 文件读取失败、普通证书不受信任应分别处理。不要将含订阅令牌的 URL 放进公开日志。
  2. 核对目标域名、端口及代理链路,向服务管理员确认是否计划轮换密钥。如果使用 HTTPS 代理,还要区分目标的 --pinnedpubkey 与代理自身的 --proxy-pinnedpubkey,两者认证对象不同。
  3. 只有从独立可信渠道核实新公钥后,才更新本地固定值。以下示例读取管理员预先提供的单个 PEM/DER 公钥文件;它不是证书包或私钥。不要从当前失败连接直接抓取公钥并立刻将其设为可信。
  4. 在没有订阅秘密的同一受控服务诊断端点先验证。采用私有 CA 时另行配置正确的 --cacert,公开 CA 则按原信任配置保留;不能把删除 pin 或添加 -k 作为通过办法。
  5. 确认固定值更新和正常证书校验同时有效后,再让原任务使用正式 URL 下载。继续核对内容确为预期配置、格式可解析;保存 HTTP 错误页不算订阅恢复。
PowerShell 使用 curl.exe;macOS/Linux 改为 curl。先替换为自己的无敏感诊断端点与已核实公钥文件。
curl.exe --disable --fail --connect-timeout 10 --max-time 30 --pinnedpubkey ./expected-public-key.pem --output probe.body https://config.example.com/health
检查不能互相替代的原因
证书链与域名校验证明当前 TLS 身份满足信任配置
公钥固定额外限制可接受的公钥
配置内容验证确认返回的是任务需要的配置

怎样确认有效

正确公钥匹配且证书校验通过,配置内容符合原任务需求。可以在自有隔离服务中验证错误公钥会被拒绝;本文未拿真实订阅或用户令牌进行测试。

无效时恢复与下一步

保留原固定值及变更依据。若管理员尚不能确认新密钥,停止自动下载并保留已有可用配置,不用无限重试或清空本地配置来消除报错。