curl 公钥钉扎实战一条命令锁死 HTTPS让中间人无处下手【免费下载链接】curlA command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, MQTTS, POP3, POP3S, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features项目地址: https://gitcode.com/GitHub_Trending/cu/curlcurl 的证书钉扎允许你把服务器的公钥指纹写死在客户端TLS 握手时对方一旦出示不匹配的证书连接在收发任何数据之前就被掐断。再叠加证书透明度CT验证HTTPS 就多了两道防线。下面从威胁场景讲起把原理、用法和坑一次讲清。先看清威胁HTTPS 为什么还不够HTTPS 默认只验证这张证书是不是受信任 CA 签发的。但只要攻击者能拿到一张合法证书——比如 CA 被攻破、为同域子域名申了张真证书、或 CA 误发——客户端照样校验通过。这类中间人攻击MITM指通信双方被第三方截听篡改在证书本身合法的前提下完全隐形。证书钉扎解决的就是这个问题不看证书是谁签的只看公钥是不是我认识的那把。打个比方快递单再正规我认的只有上次取件时见过的同一张脸。公钥钉扎的工作原理从握手到拒绝的四步整个过程发生在 TLS 握手阶段核心逻辑集中在 lib/vtls/ 目录提取公钥服务器发来证书后curl 从其中抽出公钥OpenSSL 后端调用X509_get_pubkey取出密钥并转成 DER 编码。计算哈希对公钥字节算 SHA256 摘要——SHA256 是一种密码哈希任何数据都能压成固定 32 字节公钥改 1 比特结果就完全不同。比对指纹把摘要做 base64 编码与预置的钉扎列表逐个比较。列表支持多个指纹用分号;分隔任一命中即通过。不匹配即拒绝全部落空则返回错误码CURLE_SSL_PINNEDPUBKEYNOTMATCH90传输直接中止。统一入口是Curl_pin_peer_pubkey见 lib/vtls/vtls.c各 TLS 后端——OpenSSL、GnuTLS、mbedTLS、wolfSSL、Schannel——各自实现证书解析部分比对逻辑共用。 一条命令完成 curl 公钥钉扎命令行侧用--pinnedpubkey7.39.0 起可用最小示例curl --pinnedpubkey sha256//YhKJKSzoTt2b5FP18fvpHo7fJYqQCjAa3HWY3tvRMwE https://example.com参数有两种形态sha256//前缀加 base64 指纹多个用;连接或者一个 PEM/DER 公钥文件路径。完整说明见 docs/cmdline-opts/pinnedpubkey.md。代码里走 libcurl 接口curl_easy_setopt设CURLOPT_PINNEDPUBLICKEY传参格式与命令行一致细节在 docs/libcurl/opts/CURLOPT_PINNEDPUBLICKEY.md。有个容易忽略的点钉扎开关独立于CURLOPT_SSL_VERIFYPEER——即使你把证书链校验整个关掉公钥钉扎依然生效。️ 钉扎校验失败的三种常见原因指纹算错了对象。SHA256 必须对公钥的 DER 字节计算而不是对整张证书。官方文档给了 openssl 流水线s_client 抓证书 → x509 导出公钥 → 转 DER →dgst -sha256再 base64照抄即可。跳转发起了换源跳转。钉扎只校验传输的初始源站如果请求跟随重定向跳到别的 origin新目标不会和这把钥匙比对。跨站跳转场景要么手动处理要么换用逐跳校验的代理策略。后端不支持该格式。PEM/DER 文件和 sha256 指纹在各后端落地版本不同如 OpenSSL/GnuTLS 7.39.0 起支持 PEM7.44.0 起支持 sha256Schannel 要到 7.58.1。拿不支持的后端跑结果就是必败。另外记住一点服务端轮换证书后旧指纹立即失效报 90 是正常现象怎么处理取决于你的设计见下节。 证书透明度验证补上日志留痕这一课CTCertificate Transparency要求 CA 签发的每张证书都记入公开日志客户端可以据此发现没登记过的证书。curl 没有单独的 CT API这条能力依赖 TLS 后端OpenSSL、GnuTLS 等支持校验证书里携带的 SCTSigned Certificate Timestamp即日志签发的时间戳凭证属于证书链校验的一部分。与之配套的是证书状态验证命令行加--cert-status强制握手时要求服务器给出 OCSP stapling 响应响应无效、显示已吊销、或压根没有验证即失败返回CURLE_SSL_INVALIDCERTSTATUS91。该选项目前仅 OpenSSL 和 GnuTLS 后端实现见 docs/cmdline-opts/cert-status.md。它和公钥钉扎是两回事——前者查这张证还活着吗后者查这把钥匙是不是我认的那把两者叠加覆盖面更广。⚡ 密钥轮换、错误处理与性能落地清单多钥钉扎一次钉住两把钥匙当前 备份分号分隔即可这是轮换的基本盘。轮换顺序先让客户端加上新指纹再让服务器切证书最后摘掉旧指纹。顺序反了中间窗口期全员报 90。错误处理收到CURLE_SSL_PINNEDPUBKEYNOTMATCH时不要盲目重试先落日志。持续出现可能是配置错误也可能是真实攻击两种情况都值得人工看一眼。监控告警把错误码 90/91 接入告警通道钉扎失效往往意味着有人在动你的证书或自己忘了轮换。性能侧SHA256 计算微秒级真正的开销在连接本身。高并发场景把指纹字符串在进程内缓存复用别每次请求重新读文件算哈希配合合理的连接超时让校验失败快速终止而不是挂死线程。收尾证书钉扎不是万能锁它防冒充不防证书链整体被攻破也别把它当--insecure的替代品。把它和证书透明度、OCSP 状态检查组合起来再配上可预期的轮换流程HTTPS 的安全下限才算真正抬起来了。【免费下载链接】curlA command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, MQTTS, POP3, POP3S, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features项目地址: https://gitcode.com/GitHub_Trending/cu/curl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/8/31 19:46:14 · 阅读 1.2k curl 公钥钉扎实战：一条命令锁死 HTTPS，让中间人无处下手
curl 公钥钉扎实战一条命令锁死 HTTPS让中间人无处下手【免费下载链接】curlA command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, MQTTS, POP3, POP3S, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features项目地址: https://gitcode.com/GitHub_Trending/cu/curlcurl 的证书钉扎允许你把服务器的公钥指纹写死在客户端TLS 握手时对方一旦出示不匹配的证书连接在收发任何数据之前就被掐断。再叠加证书透明度CT验证HTTPS 就多了两道防线。下面从威胁场景讲起把原理、用法和坑一次讲清。先看清威胁HTTPS 为什么还不够HTTPS 默认只验证这张证书是不是受信任 CA 签发的。但只要攻击者能拿到一张合法证书——比如 CA 被攻破、为同域子域名申了张真证书、或 CA 误发——客户端照样校验通过。这类中间人攻击MITM指通信双方被第三方截听篡改在证书本身合法的前提下完全隐形。证书钉扎解决的就是这个问题不看证书是谁签的只看公钥是不是我认识的那把。打个比方快递单再正规我认的只有上次取件时见过的同一张脸。公钥钉扎的工作原理从握手到拒绝的四步整个过程发生在 TLS 握手阶段核心逻辑集中在 lib/vtls/ 目录提取公钥服务器发来证书后curl 从其中抽出公钥OpenSSL 后端调用X509_get_pubkey取出密钥并转成 DER 编码。计算哈希对公钥字节算 SHA256 摘要——SHA256 是一种密码哈希任何数据都能压成固定 32 字节公钥改 1 比特结果就完全不同。比对指纹把摘要做 base64 编码与预置的钉扎列表逐个比较。列表支持多个指纹用分号;分隔任一命中即通过。不匹配即拒绝全部落空则返回错误码CURLE_SSL_PINNEDPUBKEYNOTMATCH90传输直接中止。统一入口是Curl_pin_peer_pubkey见 lib/vtls/vtls.c各 TLS 后端——OpenSSL、GnuTLS、mbedTLS、wolfSSL、Schannel——各自实现证书解析部分比对逻辑共用。 一条命令完成 curl 公钥钉扎命令行侧用--pinnedpubkey7.39.0 起可用最小示例curl --pinnedpubkey sha256//YhKJKSzoTt2b5FP18fvpHo7fJYqQCjAa3HWY3tvRMwE https://example.com参数有两种形态sha256//前缀加 base64 指纹多个用;连接或者一个 PEM/DER 公钥文件路径。完整说明见 docs/cmdline-opts/pinnedpubkey.md。代码里走 libcurl 接口curl_easy_setopt设CURLOPT_PINNEDPUBLICKEY传参格式与命令行一致细节在 docs/libcurl/opts/CURLOPT_PINNEDPUBLICKEY.md。有个容易忽略的点钉扎开关独立于CURLOPT_SSL_VERIFYPEER——即使你把证书链校验整个关掉公钥钉扎依然生效。️ 钉扎校验失败的三种常见原因指纹算错了对象。SHA256 必须对公钥的 DER 字节计算而不是对整张证书。官方文档给了 openssl 流水线s_client 抓证书 → x509 导出公钥 → 转 DER →dgst -sha256再 base64照抄即可。跳转发起了换源跳转。钉扎只校验传输的初始源站如果请求跟随重定向跳到别的 origin新目标不会和这把钥匙比对。跨站跳转场景要么手动处理要么换用逐跳校验的代理策略。后端不支持该格式。PEM/DER 文件和 sha256 指纹在各后端落地版本不同如 OpenSSL/GnuTLS 7.39.0 起支持 PEM7.44.0 起支持 sha256Schannel 要到 7.58.1。拿不支持的后端跑结果就是必败。另外记住一点服务端轮换证书后旧指纹立即失效报 90 是正常现象怎么处理取决于你的设计见下节。 证书透明度验证补上日志留痕这一课CTCertificate Transparency要求 CA 签发的每张证书都记入公开日志客户端可以据此发现没登记过的证书。curl 没有单独的 CT API这条能力依赖 TLS 后端OpenSSL、GnuTLS 等支持校验证书里携带的 SCTSigned Certificate Timestamp即日志签发的时间戳凭证属于证书链校验的一部分。与之配套的是证书状态验证命令行加--cert-status强制握手时要求服务器给出 OCSP stapling 响应响应无效、显示已吊销、或压根没有验证即失败返回CURLE_SSL_INVALIDCERTSTATUS91。该选项目前仅 OpenSSL 和 GnuTLS 后端实现见 docs/cmdline-opts/cert-status.md。它和公钥钉扎是两回事——前者查这张证还活着吗后者查这把钥匙是不是我认的那把两者叠加覆盖面更广。⚡ 密钥轮换、错误处理与性能落地清单多钥钉扎一次钉住两把钥匙当前 备份分号分隔即可这是轮换的基本盘。轮换顺序先让客户端加上新指纹再让服务器切证书最后摘掉旧指纹。顺序反了中间窗口期全员报 90。错误处理收到CURLE_SSL_PINNEDPUBKEYNOTMATCH时不要盲目重试先落日志。持续出现可能是配置错误也可能是真实攻击两种情况都值得人工看一眼。监控告警把错误码 90/91 接入告警通道钉扎失效往往意味着有人在动你的证书或自己忘了轮换。性能侧SHA256 计算微秒级真正的开销在连接本身。高并发场景把指纹字符串在进程内缓存复用别每次请求重新读文件算哈希配合合理的连接超时让校验失败快速终止而不是挂死线程。收尾证书钉扎不是万能锁它防冒充不防证书链整体被攻破也别把它当--insecure的替代品。把它和证书透明度、OCSP 状态检查组合起来再配上可预期的轮换流程HTTPS 的安全下限才算真正抬起来了。【免费下载链接】curlA command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, MQTTS, POP3, POP3S, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS. libcurl offers a myriad of powerful features项目地址: https://gitcode.com/GitHub_Trending/cu/curl创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考