curl: (51) SSL peer certificate or SSH remote key was not OK 排查手册
错误含义:curl 退出码 51 到底在说什么
curl 的退出码 51 是一个“对端身份验证失败”的统称,它同时覆盖两条完全不同的链路:
- HTTPS / FTPS 等 TLS 链路:证书链校验不通过,包括证书过期、域名不匹配、签发者不受信、证书链不完整。
- SSH / SFTP / SCP 链路:known_hosts 中记录的主机密钥与服务器实际密钥不一致,或首次连接无法确认指纹。
注意:51 与 60(SSL certificate problem)经常被混淆。不同 curl 版本和后端(OpenSSL、GnuTLS、Schannel、Secure Transport)对同一类错误的归类不同,因此判断时不要只看数字,要看冒号后面的描述文本。
# 只看错误,不输出正文
curl -sS -o /dev/null https://example.com
# curl: (51) SSL: no alternative certificate subject name matches target host name 'example.com'
第一步:三条命令锁定问题类型
先分清是 TLS 还是 SSH,再谈修复。
# 1) TLS 握手与证书摘要(最关键的一条)
curl -vI https://example.com 2>&1 | grep -i -E 'expire|subject|issuer|SSL certificate verify|subjectAltName'
# 2) 用 openssl 看完整证书链与有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 3) SSH 场景:看 curl 用的是哪个 known_hosts、报什么
curl -v sftp://user@host/ 2>&1 | grep -i -E 'SSH|host key|fingerprint'
ssh -vv user@host 2>&1 | grep -i 'host key'
判定规则:出现 subject / issuer / expire 相关字样,走证书排查;出现 host key / fingerprint,走 SSH 排查。
证书排查:过期、域名不匹配、链不完整
这三类问题占证书类 51 的绝大多数,逐项核对即可。
1. 证书是否过期(注意时区与系统时间)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -dates
# notBefore=Mar 1 00:00:00 2025 GMT
# notAfter=Feb 28 23:59:59 2026 GMT
date -u # 本机时间若漂移,未过期也会被判过期
若 notAfter 已过,只能由站点更换证书,客户端无法“修复”。若本机时间错误,先校时:timedatectl set-ntp true 或 ntpdate pool.ntp.org。
2. 域名是否在 SAN 中(CN 早已不作为依据)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -text | grep -A1 'Subject Alternative Name'
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:www.example.com
常见坑:访问 https://api.example.com,证书只签了 example.com;用 IP 直连但证书没有 IP SAN;通配符 *.example.com 不覆盖多级子域 a.b.example.com。修复方式是改用证书覆盖的主机名,或让服务端补签证书,而不是加 -k。
3. 证书链是否完整
# 看服务端是否只发了叶子证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
# 正常应为 2 及以上(叶子证书 + 中间 CA)
# 用 verify 明确报出断点
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
# error 20 at 0 depth lookup: unable to get local issuer certificate
服务端应配置 SSLCertificateChainFile(Apache)或 ssl_certificate 指向 fullchain(Nginx)。客户端临时验证可用 --cacert 指定中间 CA 合并包,但根治点在服务端。
本地 CA 库过旧或缺失:浏览器正常、curl 报错
这是最典型的“浏览器能打开、curl 报 51/60”。原因:curl 使用系统或自带的 CA bundle,浏览器使用自己的信任库,且常包含企业代理根证书。
# 确认 curl 实际使用的 CA 文件
curl -V
# curl 8.5.0 ... OpenSSL/3.0.13
# 注意输出里的 CA 路径,或看环境变量
echo $CURL_CA_BUNDLE
# Debian / Ubuntu 更新系统 CA
sudo apt-get install -y ca-certificates
sudo update-ca-certificates --fresh
# RHEL / CentOS / Rocky
sudo yum install -y ca-certificates
sudo update-ca-trust extract
# macOS(Homebrew 版 curl)
brew install ca-certificates
export CURL_CA_BUNDLE=$(brew --prefix)/etc/ca-certificates/cert.pem
# 临时指定单个 CA(自签或企业根)
curl --cacert /path/to/corp-root.crt https://internal.example.com
若公司有 TLS 中间人代理(Zscaler、Fortinet、自建网关),需要把企业根证书导入系统信任库,而不是关闭校验。
SSH 场景:主机密钥变更的正确处理
curl 走 sftp://、scp:// 时会校验 SSH 主机密钥,默认读取 ~/.ssh/known_hosts。服务器重装、IP 复用、负载均衡后端不一致都会触发 51。
# 典型报错
curl -v sftp://deploy@10.0.0.12/ 2>&1 | tail -5
# curl: (51) SSH host key verification failed
# 先看服务器实际指纹(从可信渠道核对)
ssh-keyscan -t ed25519 10.0.0.12 2>/dev/null | ssh-keygen -lf -
# 删除旧记录后重连
ssh-keygen -R 10.0.0.12
ssh-keygen -R '[10.0.0.12]:22'
# 非交互场景(CI)用独立 known_hosts,避免污染用户目录
curl --knownhosts /etc/ci/known_hosts sftp://user@host/
curl --hostpubmd5 <md5> sftp://user@host/ # 校验指定指纹
curl --insecure sftp://user@host/ # 仅限临时排障,勿入生产脚本
安全红线:执行 ssh-keygen -R 之前必须确认新指纹来源可信(控制台、配置管理系统、运维同事),否则等于主动接受中间人攻击。生产 CI 建议把主机公钥固化到仓库或密钥管理系统中,用 --hostpubmd5 / --hostpubsha256 做白名单校验。
对照表:现象 → 根因 → 验证 → 修复
| 现象 / 报错关键词 | 根因 | 快速验证 | 修复 |
|---|---|---|---|
| certificate has expired / notAfter 已过 | 服务端证书过期 | openssl x509 -noout -dates |
服务端换证;客户端校时 |
| no alternative certificate subject name matches | 域名不在 SAN 中 | -ext subjectAltName |
改用匹配域名或补签证书 |
| unable to get local issuer certificate | 证书链不完整、缺中间 CA | openssl verify |
服务端配 fullchain;客户端 --cacert |
| self-signed certificate / unable to get issuer | 自签或私有 CA | curl -vI 看 issuer |
导入企业根证书到系统信任库 |
| 浏览器正常、curl 报 51 | curl 的 CA bundle 过旧 | curl -V 看 CA 路径 |
update-ca-certificates |
| SSH host key verification failed | known_hosts 记录与实机不符 | ssh-keyscan | ssh-keygen -lf |
ssh-keygen -R 后重连 |
| 代理环境下所有域名都报 51 | 企业 TLS 中间人代理 | 对比直连与代理的 issuer | 导入代理根证书,勿用 -k |
真实报错逐条修复
1. curl: (51) SSL: no alternative certificate subject name matches target host name 'api.example.com'
证书 SAN 只有 example.com。验证:openssl s_client -connect api.example.com:443 -servername api.example.com </dev/null 2>/dev/null | openssl x509 -noout -ext subjectAltName。修复:改用 https://example.com,或为 api 子域补签证书。
2. curl: (51) SSL: certificate verification failed (result: 5)(GnuTLS 后端)
result 5 通常表示证书已过期或不受信。用 curl -vI 看 * SSL certificate verify result 行,再按上面“过期 / 链不完整”处理。
3. curl: (51) Cert verify failed: BADCERT_CN_MISMATCH(Windows Schannel)
Schannel 对 CN / SAN 校验严格,且不读 CURL_CA_BUNDLE。改用 OpenSSL 版 curl,或把根证书导入“受信任的根证书颁发机构”。
4. curl: (51) unable to verify the first certificate
服务端只发了叶子证书。验证:openssl s_client -showcerts | grep -c 'BEGIN CERTIFICATE' 结果为 1。修复:Nginx 用 ssl_certificate fullchain.pem,Apache 配 SSLCertificateChainFile。
5. curl: (51) SSH host key verification failed
先 ssh-keyscan -t ed25519 host | ssh-keygen -lf - 核对指纹,再 ssh-keygen -R host。若使用非默认端口,记得写成 [host]:2222。
6. curl: (51) SSL peer certificate or SSH remote key was not OK 且无更多信息
加 -v 重跑,抓 * SSL certificate verify result 与 * Closing connection 之间的行;同时确认没有 ~/.curlrc 里的 insecure 或错误的 cacert 覆盖。
生产环境建议
- 不要用
curl -k或--insecure“解决”51,它把可检测的中间人攻击变成静默接受。若必须临时使用,请在脚本中加显式告警并设置到期日。 - 把 CA bundle 纳入镜像构建:容器基础镜像常缺
ca-certificates,导致同一脚本在宿主机正常、容器内报 51。 - 证书到期监控用
openssl x509 -checkend 2592000,提前 30 天告警。 - SSH 自动化用独立
known_hosts加指纹白名单,而不是StrictHostKeyChecking=no。
# 到期检查示例:剩余不足 30 天返回非 0
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -checkend 2592000 || echo '证书将在 30 天内过期'
FAQ
Q1:curl 报 51,但浏览器打开同一网址完全正常,为什么?
两者信任库不同。浏览器用系统或自带信任库,并常包含企业代理根证书;curl 用自己的 CA bundle。先 curl -V 看 CA 路径,再 update-ca-certificates。
Q2:51 和 60 有什么区别?
都是证书校验失败,只是 curl 不同后端和版本的归类差异。60 多为 SSL certificate problem,51 多为域名不匹配或 SSH 主机密钥问题。判断以冒号后的描述为准。
Q3:加了 --cacert 还是报 51?
确认 --cacert 指向的是 PEM 格式、包含完整链(根 + 中间)的文件;并检查是否被 CURL_CA_BUNDLE 或 ~/.curlrc 覆盖。用 curl -v 看实际加载的 CA 文件。
Q4:容器里报 51,宿主机正常?
基础镜像缺 CA 包。Dockerfile 加 RUN apt-get update && apt-get install -y ca-certificates(Debian)或 microdnf install -y ca-certificates(UBI)。
Q5:SFTP 用 curl 报 51,但 ssh 命令能登录?
ssh 与 curl 可能读取不同的 known_hosts,或 curl 使用了 --knownhosts 指定文件。检查 curl -v 输出中的 known_hosts 路径。
Q6:能否永久关闭校验?
技术上可以(-k、--insecure、StrictHostKeyChecking=no),但不建议在任何生产链路使用。正确做法是补齐信任链。
Q7:如何快速确认是服务端证书问题还是客户端信任库问题?
用 openssl s_client -CAfile /etc/ssl/certs/ca-certificates.crt 验证:verify 返回 0 说明链与信任库都正常,问题在 curl 配置;返回非 0 说明服务端链或证书本身有问题。