curl: (60) self signed certificate in certificate chain:从定位到修复的完整指南
一、这条报错到底在说什么
先看完整输出,它通常长这样:
$ curl -I https://internal.example.com
curl: (60) SSL certificate problem: self signed certificate in certificate chain
More details here: https://curl.se/docs/sslcerts.html
curl failed to verify the legitimacy of the server and therefore could not
establish a secure connection to it.
拆开看两个关键词:
(60)是 curl 的CURLE_PEER_FAILED_VERIFICATION,表示 TCP 已经连上、TLS 握手也走完了,卡在最后一步「验证对端证书」。所以它不是网络不通,也不是端口没开。self signed certificate in certificate chain是 OpenSSL 给出的具体原因:在校验证书链的过程中,遇到了一张 issuer 与 subject 相同的自签名证书,而这张证书不在本地信任库里。
注意措辞是 in certificate chain。如果服务器直接下发一张自签的叶子证书,OpenSSL 报的是 self signed certificate(没有 in certificate chain);而带上 in certificate chain,说明服务器发来的链中间夹了一张自签证书——这几乎总是意味着有东西在中间替换了证书:企业出口网关、防火墙的 TLS 检查、杀毒软件的 HTTPS 扫描、Fiddler/Charles 之类的抓包代理。
二、三种典型场景,对应三条修复路线
- 公司网络里有 TLS 中间人设备(最常见)。浏览器一切正常,只有命令行工具报错。因为浏览器和系统的信任库已经被 IT 通过 GPO、MDM 或手动方式装上了企业根证书,而 curl 用的是 OpenSSL 的 ca-certificates 包,两者不是同一个库。
- 站点自己部署了自签证书。内网管理系统、测试环境、网络设备管理页、K8s 的 self-signed ingress 都属于这一类。特征是浏览器会弹「您的连接不是私密连接」,需要手动点继续。
- 服务端证书链配置错误。只下发了叶子证书、中间证书缺失或顺序颠倒,个别情况下链里混入了自签的中间证书。这类问题出在服务端,客户端怎么加信任都没用。
判断标准很简单:同一台机器浏览器能正常打开、curl 报错,问题在客户端信任库;浏览器也报错,问题在服务端证书。
三、三分钟定位:服务端到底发了什么链
# 抓取服务端下发的完整证书链
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
# 只看校验结论
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>&1
| grep -E 'Verify return code|verify error'
结论对照:
Verify return code: 0 (ok)—— 服务端证书链完全正常,报错纯粹是本机信任库缺了企业根证书,走第四节。verify error:num=19:self-signed certificate in certificate chain—— 链里确实有自签证书,继续往下看它到底是谁。verify error:num=20:unable to get local issuer certificate或num=21:unable to verify the first certificate—— 链不完整,走第五节。
# 把链里每一张证书的 subject / issuer 打出来
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
| openssl crl2pkcs7 -nocrl -certfile /dev/stdin
| openssl pkcs7 -print_certs -noout
如果输出里出现 subject=CN = Corp SSL Inspection Root CA 这类名字,基本可以确定是公司的 TLS 检查设备;如果出现的是你自己的内网 CA 名字,那就是第二种场景。
顺便确认 curl 到底在用哪个信任库:
curl -vI https://example.com 2>&1 | grep -i 'CAfile|CApath'
四、修法一:把自签根证书装进本机信任库
前提是先拿到那张根证书。三条途径:向 IT/网络组索取;浏览器地址栏点锁图标 → 证书路径 → 导出最顶层证书;或者直接从 openssl 输出里把最后一张证书另存为 PEM。
拿到后先确认它确实是自签根(subject 与 issuer 相同):
openssl x509 -in corp-root.crt -noout -subject -issuer -dates
然后按平台安装。
Debian / Ubuntu
sudo cp corp-root.crt /usr/local/share/ca-certificates/corp-root.crt
sudo update-ca-certificates
# 期望输出:1 added, 0 removed; done.
RHEL / CentOS / Rocky / Fedora
sudo cp corp-root.crt /etc/pki/ca-trust/source/anchors/
sudo update-ca-trust extract
Alpine(容器里最常见)
cp corp-root.crt /usr/local/share/ca-certificates/
update-ca-certificates
macOS
sudo security add-trusted-cert -d -r trustRoot
-k /Library/Keychains/System.keychain corp-root.crt
Windows(管理员权限)
certutil -addstore -f Root corp-root.crt
注意 update-ca-certificates 只更新系统信任库,对很多语言运行时无效,它们各自有独立的 bundle,需要单独指定:
- Python requests / pip:
export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt,pip 用PIP_CERT,或者把根证书内容追加进 certifi 的cacert.pem。 - Node.js:
export NODE_EXTRA_CA_CERTS=/etc/ssl/certs/corp-root.crt - Git:
git config --global http.sslCAInfo /etc/ssl/certs/ca-certificates.crt - Java:
keytool -importcert -noprompt -alias corp-root -file corp-root.crt -keystore $JAVA_HOME/lib/security/cacerts -storepass changeit - Docker 构建:Dockerfile 里
COPY corp-root.crt /usr/local/share/ca-certificates/再RUN update-ca-certificates;运行时可用-v /host/corp-root.crt:/usr/local/share/ca-certificates/corp-root.crt。
如果只想验证一次、不想污染系统信任库,用 --cacert 指定单次使用的 CA 文件:
curl --cacert corp-root.crt -I https://internal.example.com
这是排查阶段最干净的做法,但不要写进生产脚本——证书一轮换,脚本就会静默失败。
五、修法二:服务端换成受信任的 CA 证书
如果报错的是你自己的服务(CI 里 curl 自己的域名、监控探针报警),正确做法不是在客户端加信任,而是把证书换掉。有公网域名的话,Let’s Encrypt 零成本:
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d example.com -d www.example.com
sudo certbot renew --dry-run
Nginx 配置里必须指向 fullchain.pem:
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
写成 cert.pem 是最常见的错误——那里面只有叶子证书,没有中间证书,客户端会报 unable to get local issuer certificate。Apache 2.4.8 之后同样只需要 SSLCertificateFile fullchain.pem 和 SSLCertificateKeyFile privkey.pem。
改完用这两条命令自检:
# 链顺序:叶子在前,中间证书在后,根证书通常不下发
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
# 实际握手验证
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>&1 | grep 'Verify return code'
纯内网、域名无法做公网验证的系统,标准做法是自建一套内网 CA,把根证书通过配置管理推送到所有客户端。本质上和第四节的方案是同一件事,只是把「装证书」这一步自动化了。
六、方案对比:什么情况选哪条路
| 方案 | 适用场景 | 优点 | 代价与风险 | 关键命令 |
|---|---|---|---|---|
| 客户端安装自签根证书 | 企业代理做 TLS 检查;内网自签系统 | 不动服务端,浏览器与命令行行为一致 | 每台机器、每个容器镜像都要做一遍;根证书私钥一旦泄露等于全线失守 | update-ca-certificates |
| 服务端换 Let’s Encrypt | 有公网域名、80/443 可达的站点 | 免费、自动续期、所有客户端默认信任 | 需要域名与 HTTP-01/DNS-01 验证通道 | certbot --nginx -d example.com |
| 服务端买商业证书 | 需要 OV/EV 展示、或需要更长有效期的业务 | 兼容性最好,有赔付条款 | 要花钱,仍需人工管理续期 | 上传 fullchain 到 Nginx/Apache |
| curl –cacert 临时指定 | 一次性排查、单次脚本调用 | 零副作用,不污染系统信任库 | 证书轮换后容易静默失效 | curl --cacert corp-root.crt ... |
| curl -k 跳过校验 | 不应该出现在任何场景 | 无 | 完全丧失中间人防护,等同于明文 | 不要用 |
| 自建内网 CA 统一分发 | 大量内网服务、设备管理面 | 可控、可审计、可轮换 | 分发与轮换的运维成本高 | 配置管理推送 + update-ca-certificates |
七、排查手册:真实报错与对应处理
1. curl: (60) SSL certificate problem: self signed certificate in certificate chain
链中存在自签证书。按第三节确认它是企业代理根还是站点自签根,然后走第四节(客户端加信任)或第五节(服务端换证书)。
2. curl: (60) SSL certificate problem: unable to get local issuer certificate
不是自签问题,而是链不完整:服务端没下发中间证书,或者根证书不在本机库里。先 openssl s_client -showcerts 看链长度,如果只有一张,基本就是 Nginx 配了 cert.pem 而不是 fullchain.pem。
3. curl: (60) SSL: no alternative certificate subject name matches target host name ‘10.0.0.12’
证书本身可信,但 SAN 里没有这个 IP。用域名访问,或者给证书签上 IP SAN(subjectAltName = IP:10.0.0.12)。
4. curl: (60) SSL certificate problem: certificate has expired
续期没生效。sudo certbot renew --dry-run 看输出,检查 systemctl list-timers | grep certbot 或 cron 是否还在跑,然后 sudo systemctl reload nginx——renew 只换文件,不 reload 就不会生效。
5. curl: (77) error setting certificate verify locations: CAfile: /etc/ssl/certs/ca-certificates.crt CApath: none
信任库文件根本不存在,常见于 FROM scratch 或 alpine 的精简镜像。apt-get install -y ca-certificates 或 apk add ca-certificates,然后跑一次 update-ca-certificates。
6. curl: (35) error:0A000086:SSL routines::certificate verify failed
OpenSSL 3 的笼统失败信息,本身不含原因。加 -v 重跑,或直接用 openssl s_client 拿到 verify error:num= 那一行。
7. Python:SSLCertVerificationError(1, ‘[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: self-signed certificate in certificate chain (_ssl.c:1007)’)
requests 用的是 certifi 自带的 bundle,不含企业根。设置 export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt,或把根证书内容追加到 certifi.where() 指向的文件末尾。
8. Node.js:Error: self-signed certificate in certificate chain,code: ‘SELF_SIGNED_CERT_IN_CHAIN’
设置 export NODE_EXTRA_CA_CERTS=/path/corp-root.crt。这个变量只在进程启动时读取一次,必须在启动命令的环境里设置,运行时再改无效。
9. Git:fatal: unable to access ‘https://git.example.com/’: SSL certificate problem: self signed certificate in certificate chain
git config --global http.sslCAInfo /etc/ssl/certs/ca-certificates.crt。如果只有某一个内网 Git 服务需要,用 git config --global http.https://git.example.com/.sslCAInfo /path/corp-root.crt 做定向配置。
10. Java:PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
JDK 有自己的 cacerts。keytool -importcert -noprompt -alias corp-root -file corp-root.crt -keystore $JAVA_HOME/lib/security/cacerts -storepass changeit,然后重启 JVM。
八、生产红线:不要用 -k 把问题盖住
curl -k、--insecure、Python 的 verify=False、Node 的 rejectUnauthorized: false、NODE_TLS_REJECT_UNAUTHORIZED=0、PHP 的 CURLOPT_SSL_VERIFYPEER => false、Go 的 InsecureSkipVerify: true,本质上都是同一件事:关掉对端身份验证。关掉之后,任何能劫持流量的中间人都可以解密、篡改、注入,而你的程序不会有任何察觉。
这些开关的危险之处在于「当时只是为了先跑通」。加完之后没人回头改,就成了长期后门,也是供应链投毒最喜欢利用的入口。临时环境真要绕过,用 --cacert 指定那张自签根,效果一样,但至少还验证了证书归属。
定期扫一遍代码库:
grep -rn --include='*.py' --include='*.js' --include='*.go' --include='*.php'
-e 'verify=False' -e 'rejectUnauthorized: false' -e 'InsecureSkipVerify'
-e 'CURLOPT_SSL_VERIFYPEER' .
九、FAQ
Q:浏览器打得开,为什么 curl 报错?
浏览器用自己的信任库(Windows 是系统证书存储,Firefox 是独立的 NSS 库),企业 IT 通常已经把代理根证书推送到这些位置;而 curl 链接的是 OpenSSL,读的是 /etc/ssl/certs/ca-certificates.crt。两套库不同步,就是这个现象。
Q:证书已经装了,curl 还是报同样的错?
按顺序查三件事:一是 curl -v 输出里的 CAfile: 是不是你改的那个文件;二是环境变量 CURL_CA_BUNDLE 或 SSL_CERT_FILE 有没有覆盖它;三是代理链可能有多级,缺了中间那一张,需要把整条链都装上。
Q:update-ca-certificates 显示 0 added 是什么原因?
最常见是文件名没以 .crt 结尾(脚本只扫描这个后缀),其次是文件不是 PEM 格式(比如导成了 DER)。用 file corp-root.crt 确认一下,DER 的话先 openssl x509 -inform der -in corp-root.crt -out corp-root.pem。
Q:自签证书能不能让公网客户端默认信任?
不能。公网客户端只信任操作系统和浏览器预置的根证书,任何未经预置的根都必须由使用者手动安装。
Q:证书链的顺序有要求吗?
有。顺序是「叶子证书 → 中间证书 →(可选)根证书」,实际部署时根证书一般不发送,因为客户端本来就该有。顺序错了,部分老客户端会校验失败。
Q:–cacert 和 –capath 有什么区别?
--cacert 指向单个 PEM 文件(可以包含多张证书);--capath 指向一个目录,目录里的文件需要按证书 subject 的 hash 命名,用 c_rehash 或 openssl rehash 生成。
Q:用 IP 访问内网服务,自签证书怎么配才不报错?
证书的 SAN 里必须包含该 IP,例如 subjectAltName = IP:10.0.0.12, DNS:svc.internal,同时客户端要信任签发它的根。只写 CN 是不够的,现代客户端已经不认 CN 了。
Q:容器里怎么一劳永逸?
在 Dockerfile 里 COPY corp-root.crt /usr/local/share/ca-certificates/ 加 RUN update-ca-certificates,并确保基础镜像装了 ca-certificates 包。运行时挂载只适合临时调试。