跳到主要内容

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 说明服务端链或证书本身有问题。