必须同时设置curlopt_ssl_verifypeer和curlopt_ssl_verifyhost为0l才能完全跳过ssl证书及主机名验证,缺一不可;仅设前者会导致后者默认启用而报主机名不匹配错误。

curl_easy_setopt设置CURLOPT_SSL_VERIFYPEER为0L
跳过SSL证书验证的核心操作就是关闭libcurl的证书校验开关。必须在curl_easy_perform()调用前,用curl_easy_setopt()设置CURLOPT_SSL_VERIFYPEER为0L(注意是长整型0,不是NULL或false)。
常见错误是传0(int)或false,某些编译器或旧版本libcurl可能因类型不匹配导致设置失效,仍报SSL certificate problem: unable to get local issuer certificate或Peer's certificate issuer has been marked as not trusted。
-
CURLOPT_SSL_VERIFYPEER控制是否验证服务器证书的有效性(签名、有效期、域名匹配等) - 仅设此项还不够——若服务端证书链不完整或自签名,还需同时禁用主机名验证
- 必须在
curl_easy_init()之后、curl_easy_perform()之前调用,中间不能被其他curl_easy_setopt()覆盖
必须同步设置CURLOPT_SSL_VERIFYHOST为0L
只关CURLOPT_SSL_VERIFYPEER会导致CURLOPT_SSL_VERIFYHOST仍启用(默认值为2L),它会检查证书中的Subject Alternative Name或Common Name是否匹配请求域名。若不匹配(比如用IP访问HTTPS服务、或证书是为example.com签发但你访问192.168.1.100),会触发SSL: certificate subject name 'xxx' does not match target host name 'yyy'错误。
- 务必配对设置:
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L) - 注意:libcurl 7.28.0+ 要求
CURLOPT_SSL_VERIFYHOST设为0L或2L(1L已被废弃),设为1L会静默失败 - 这两个选项都设为
0L后,libcurl将完全跳过证书链信任检查和主机名比对
为什么不能只靠环境变量或系统配置绕过
有人试图通过设置CURL_CA_BUNDLE为空或指向无效路径来“干扰”证书加载,这是不可靠的。libcurl在CURLOPT_SSL_VERIFYPEER为1时,即使找不到CA bundle也会报错;而设为0L才是语义明确的禁用指令。
- 环境变量如
SSL_CERT_FILE或CURL_CA_BUNDLE只影响CA证书路径,不影响校验开关 - 修改系统CA存储(如Linux的
/etc/ssl/certs)对单次请求无意义,且破坏系统安全策略 - Windows上注册表或WinHTTP设置与libcurl无关,libcurl使用自己的SSL后端(OpenSSL / Schannel / Secure Transport)
实际代码片段与关键注释
CURL* curl = curl_easy_init();
if (curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://127.0.0.1:8443");
// ⚠️ 必须同时设置以下两项,缺一不可
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L); // 不验证证书有效性
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L); // 不验证主机名匹配
// 可选:避免因缺少CA bundle路径导致警告(非必需)
curl_easy_setopt(curl, CURLOPT_CAINFO, nullptr);
<p>CURLcode res = curl_easy_perform(curl);
if (res != CURLE_OK) {
fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
}
curl_easy_cleanup(curl);
}</p>
生产环境切勿长期使用这种方式。调试或内网测试可临时跳过,但上线前必须恢复证书验证,并确保CA bundle路径正确(用CURLOPT_CAINFO或CURLOPT_CAPATH指定)。
真正难处理的是双向TLS(mTLS)场景——此时CURLOPT_SSL_VERIFYPEER=0L会连客户端证书校验也关掉,而多数服务端仍要求提供有效客户端证书。这种情况下跳过服务端校验不等于能完成握手,得看具体服务端策略。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











