Curl (60) SSL 错误:无法获取本地颁发者证书

Curl SSL 证书:无法获取本地颁发者证书

Curl 是一个在服务器之间传输数据的命令行工具。使用 curl 时可能出现的一个常见错误是"unable to get local issuer certificate"(无法获取本地颁发者证书)这一 SSL 证书错误。此错误表明 SSL/TLS 证书配置存在问题,阻碍了 curl 建立安全连接。

在这份全面的指南中,我们将涵盖关于 curl SSL 证书错误你需要知道的一切,包括:

这个 Curl 错误是什么意思?

完整的 curl 错误消息大致如下:

curl: (60) SSL certificate problem: unable to get local issuer certificate 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. To learn more about this situation and how to fix it, please visit the web page mentioned above.

这表明 curl 无法验证远程服务器出示的 SSL 证书的真实性和有效性。

SSL(安全套接字层)及其继任者 TLS(传输层安全)是旨在提供安全网络通信的密码学协议。它们使用证书在双方之间建立信任,并加密数据传输。

证书由证书颁发机构(CA)签发,CA 会验证证书持有者的身份。CA 对证书进行签名以证明其有效性。

要让 curl 信任服务器的证书,它必须由某个受认可的 CA 签发,且该 CA 的根证书已本地安装在系统上。这使 curl 能够验证完整的证书链,并追溯到受信任的根。

如果 curl 无法建立回到已知 CA 的完整信任链,认证就会失败,并出现此错误。这通常发生在以下情况:

- 服务器使用自签名证书,而非由受信任 CA 签名的证书。
- 服务器的证书链需要补全,必须包含中间证书。
- 受信任的根 CA 证书未安装在本地系统上。

Curl SSL 证书错误的常见原因

你可能会看到 curl SSL 证书错误,有几个常见原因:

- 使用了自签名证书
- 证书链缺失或不完整
- 未安装根 CA 证书

使用了自签名证书

最常见的原因是远程服务器使用自签名证书,而非由 CA 签发的证书。

自签名证书由它所证明的同一实体签名。与 CA 签名证书不同,它们默认不受信任。

Web 服务器经常使用自签名证书来完成公共生产网站;应当使用 CA 签名证书来正确完成认证。

证书链缺失或不完整

当 CA 签发证书时,它还会提供一条中间证书链,该链必须与服务器证书一起出示,以完成信任链。

如果服务器未能发送完整的证书链,curl 将无法验证连接,SSL 握手将失败。

如果中间证书未正确安装在 Web 服务器上,或从配置中缺失,就可能出现这个问题。

未安装根 CA 证书

要让 curl 验证证书链,对中间证书进行签名的根 CA 证书必须存在于本地。

如果系统的信任存储中缺少根 CA 证书,证书验证就会失败,因为 curl 无法把证书链接回到受信任的根。

默认安装包含常见的公共 CA 根证书。但如果使用私有/内部 CA,则必须手动把根证书添加到信任存储中。

如何修复 Curl (60) SSL 证书问题:无法获取本地颁发者证书

以下是解决 curl SSL 证书错误并建立信任的多种方法:

- 使用有效的 CA 签名证书
- 添加 CA 证书 bundle
- 指定 CA 证书路径
- 禁用 SSL/TLS 证书验证

使用有效的 CA 签名证书

推荐的解决方案是让服务器使用由受信任 CA 签发的有效 SSL 证书,而非自签名证书。

主要的 CA 包括 Let's Encrypt、DigiCert、GlobalSign 等。它们会验证服务器的身份,并提供 curl 和其他客户端会自动信任的证书。

如果使用内部私有 CA,则必须把根证书分发到需要信任它的系统。

添加 CA 证书 bundle

如果错误是由于证书链不完整,你必须配置服务器发送完整证书链以及服务器证书。

对于公共受信任的 CA,你可以下载证书 bundle 并把它添加到 Web 服务器配置中:

For Apache: SSLCertificateChainFile /path/to/certificate_bundle.pem For Nginx: ssl_certificate /path/to/server_cert.pem; ssl_certificate_key /path/to/server_key.pem; ssl_trusted_certificate /path/to/certificate_bundle.pem;

这将确保完整证书链被出示给 curl 等客户端。

指定 CA 证书路径

如果服务器证书有效,但根 CA 证书在本地缺失,你可以通过 --cacert 选项告诉 curl 在哪里找到 CA 证书:

curl --cacert /path/to/ca_certificate.pem https://example.com

这将指示 curl 使用指定的 CA 证书来验证服务器证书。

禁用 SSL/TLS 证书验证

你可以使用 -k 或 --insecure 选项,让 curl 忽略 SSL 证书错误并建立不安全的连接:

curl -k https://example.com curl --insecure https://example.com

这将禁用证书验证,只应临时用于测试目的。

排查 Curl (60) SSL 错误:无法获取本地颁发者证书

以下是排查和诊断 curl SSL 证书问题的一些额外提示:

- 使用 -v 标志启用详细输出。它提供有关证书验证过程的详细信息。
- 检查证书上的到期日期。过期的证书将无法通过验证。
- 确认证书中的主机名与你请求的服务相匹配(通用名称与域名之间没有不匹配)。
- 验证根证书和中间 CA 证书是否已安装在系统上。
- 尝试安装来自公共 CA(如 Let's Encrypt)的证书 bundle。
- 对于自签名证书,确保正确生成和配置它们。
- 使用 openssl 检查服务器上的证书,确认其格式和签名正确。
- 检查系统时间不正确等问题,这些问题会使证书看起来无效。
- 如果使用杀毒软件或防火墙,将 curl 加入白名单,以便访问证书文件。
- 在 Linux 上,使用 update-ca-certificates 命令更新系统 CA 存储。

结语

"curl: (60) SSL certificate unable to get local issuer certificate"错误表明服务器 SSL 证书的验证存在问题,阻碍 curl 建立安全的 TLS/SSL 连接。

虽然禁用验证可能会解决问题,但它会完全破坏安全性。推荐的解决方案包括使用有效的 CA 签名证书、配置完整证书链,以及安装任何缺失的中间证书和根 CA 证书。

正确配置 SSL 证书对于维持安全的加密通信和保护传输中的敏感数据至关重要。理解并诊断证书错误,将有助于加强你的安全态势,抵御潜在中间人攻击。

常见问题(FAQ)

为什么我突然遇到这个 curl SSL 错误?

这个错误突然出现有几个原因:

- 服务器证书已过期且未续期。
- 中间 CA 证书已过期,导致证书链中断。
- 根 CA 证书已从你的本地系统中移除。
- 服务器证书已被替换为自签名证书。

curl 错误会影响所有 SSL 连接吗?

该错误表明 curl 试图验证的特定服务器证书存在问题。它不一定会影响来自该系统的所有 SSL/TLS 连接。

不过,如果根本原因是你本地系统上缺少某个 CA 证书,它也可能影响依赖该 CA 的其他域名的验证。

可以永久使用 -k 标志吗?

不可以,使用 -k 禁用证书验证会使你容易受到攻击。它只应在临时测试时使用,即在获取适当证书之前需要诊断问题根源的情况下使用。

我能提取服务器证书来诊断问题吗?

可以,你可以使用 openssl s_client 命令连接到服务器并输出其证书:

openssl s_client -connect example.com:443 -showcerts

这将显示服务器发送的证书,并帮助识别任何问题。

如何安装新的根 CA 证书?

在 Linux 上,你可以把根证书添加到 /usr/local/share/ca-certificates,然后运行 update-ca-certificates。

在 Windows 上,你需要通过 CertMgr 或使用 CertUtil 命令行工具把它们添加到受信任的根证书颁发机构存储中。

curl 与 Web 浏览器有什么区别?

Curl 和 Web 浏览器都使用 SSL 证书来建立安全连接。不过,浏览器自带一份预填充的受信任 CA 证书列表,而 curl 依赖安装在系统级信任存储中的证书。如果你的系统上缺少根 CA,某张证书可能在浏览器中可用,但在 curl 中失败。