跳到正文

更新

requests 代理 SSLError:
原因和修复

  1. requests 默认校验每一个 HTTPS 证书,校验失败就抛 SSLError。
  2. 走代理时通常是三种情况之一:CA 列表过旧(升级 certifi);你的网络里有东西重签 TLS,而它的根 CA 不在 Python 的列表里(让 verify 或 REQUESTS_CA_BUNDLE 指向那个 CA 文件);代理 URL 写错了,报错其实来自连代理的那一段。
  3. verify=False 只是把症状藏起来并去掉保护,只适合一次性的测试。

买完先验一次示例输出

curl -x http://USER:PASS@HOST:PORT https://ipinfo.io/json

ip
203.0.113.24
country
US
和你下单时选的国家一致
第 15 天
203.0.113.24
租期内还是同一个地址
IP 为文档示例地址(203.0.113.0/24),不是真实出口
01 / 09先读报错文字

读懂 SSLError 的文字,判断是 CA 列表、重签证书的网络还是系统时间,不用关校验就能修好。

先读报错文字

CERTIFICATE_VERIFY_FAILED 加 unable to get local issuer certificate,意思是 Python 手里没有签发这条证书链的 CA。提示主机名不匹配,说明证书属于另一个域名。如果 traceback 以 ProxyError 开头,失败在连代理这一段,先查地址、端口和协议,再去动证书。

别忘了 requests 用的是 certifi 自带的证书包,不一定是操作系统的信任库。浏览器里能打开的站,在 Python 里照样可能失败,原因就在这里。

原因、现象和修法

原因、现象和修法
项目你看到的现象修法
CA 列表过旧只有某个站报 CERTIFICATE_VERIFY_FAILED,浏览器能正常打开pip install --upgrade certifi requests
网络或设备上有 TLS 检查在这个网络里所有 HTTPS 站都失败;浏览器里颁发者是公司或安全软件拿到根 CA 的 PEM 文件,设置 verify= 或 REQUESTS_CA_BUNDLE
带自己证书的 HTTPS 代理报错提到代理;代理 URL 写成了 https://用代理的 CA 文件,或改成 http:// 的代理 URL 走普通隧道
代理 URL 或协议写错是 ProxyError 或连接错误,不是证书提示改正 scheme、主机、端口(Proxy302 上 HTTP 2222,SOCKS5 3333)
日期时间不对所有站都提示证书已过期或尚未生效校准时钟后重跑

2026 年 11 月 20 日根据 Requests 文档整理;修法就是文档里写的 verify、REQUESTS_CA_BUNDLE 和 certifi。

默认校验下发一次代理请求

import requests

proxies = {
    "http": "http://LOGIN:PASSWORD@HOST:PORT",
    "https": "http://LOGIN:PASSWORD@HOST:PORT",  # 代理 URL 的 scheme 保持 http://
}

# requests 现在去哪里找受信任的 CA?
from requests.utils import DEFAULT_CA_BUNDLE_PATH
print(DEFAULT_CA_BUNDLE_PATH)

# 正常情况:默认校验,用 certifi 证书包
r = requests.get("https://ipinfo.io/json", proxies=proxies, timeout=(10, 30))
print(r.status_code, r.text[:200])

仅为示例:把 LOGIN、PASSWORD、HOST、PORT 换成你代理页面上的值。https 那一项的代理 URL 也以 http:// 开头,这是 Requests 描述 HTTP 代理的写法。

不关校验,只信任重签的那个 CA

import requests

proxies = {
    "http": "http://LOGIN:PASSWORD@HOST:PORT",
    "https": "http://LOGIN:PASSWORD@HOST:PORT",
}

# 你这边有东西在重签 TLS:这个会话只信任它的根 CA
s = requests.Session()
s.proxies.update(proxies)
s.verify = "/path/to/inspection-root-ca.pem"   # 向公司 IT 或该工具要 PEM 文件
print(s.get("https://ipinfo.io/json", timeout=(10, 30)).status_code)

# 不改代码的做法(shell):
#   export REQUESTS_CA_BUNDLE=/path/to/inspection-root-ca.pem
#   python your_script.py

仅为示例。PEM 文件是检查你流量的那个产品或团队的根 CA。REQUESTS_CA_BUNDLE 会替换整个列表,所以要用同时包含你需要的公共 CA 的证书包。

按这个顺序修

  1. 第 1 步:升级 certifi 和 requests

    运行 pip install --upgrade certifi requests。Requests 文档建议经常升级 certifi。

    预期结果 CA 列表只是旧了的话,错误就消失。

  2. 第 2 步:打印 requests 去哪里找证书

    打印 requests.utils.DEFAULT_CA_BUNDLE_PATH。如果 shell 或容器里设了 REQUESTS_CA_BUNDLE 或 CURL_CA_BUNDLE,会覆盖默认值。

    预期结果 知道实际用的是哪个文件。

  3. 第 3 步:找出颁发者

    在浏览器里打开同一个网址,或用同一个代理跑 curl -v,看颁发者。是安全软件或公司名字,就需要它的根 CA 文件。

    预期结果 知道缺的是谁的 CA。

  4. 第 4 步:传入 CA 文件

    用 verify="/path/ca.pem" 或 session.verify,或者 export REQUESTS_CA_BUNDLE。注意 prepared request 流程不会读这个环境变量,除非你合并环境设置。

    预期结果 校验保持开启,请求成功。

    继续前请注意 不要把 verify=False 带到生产环境。

常见的坑

verify=False 就好了

检查 请求能过,但任何证书都被接受,包括伪造的。

处理 测完换成正确的 CA 文件。

停止条件 带登录或个人数据的请求不要再用它。

浏览器里正常,Python 里不行

检查 浏览器用系统信任库,Requests 用 certifi。

处理 升级 certifi,或让 verify 指向 CA 文件。

停止条件 浏览器也警告的话,是站点或时钟的问题。

REQUESTS_CA_BUNDLE 好像没生效

检查 可能用了 prepared request,或者变量设在了另一个 shell 里。

处理 在 session 上设 verify,或合并环境设置。

停止条件 还是不行就打印路径,用 curl 对照。

SOCKS 代理报缺少依赖

检查 单装 requests 不带 SOCKS 支持。

处理 安装 requests[socks];想让代理解析域名就用 socks5h://。

停止条件 只要 HTTP 的话,用 HTTP 端口即可。

用 Proxy302:保持校验开启的代理 URL

  1. 第 1 步

    打开「我的资产」,复制 HOST、PORT、USERNAME、PASSWORD。

  2. 第 2 步

    代理 URL 写成 http://USERNAME:PASSWORD@HOST:PORT,端口和资产的协议一致(HTTP 用 2222;SOCKS5 用 socks5h:// 和 3333 端口,需要 requests[socks])。

  3. 第 3 步

    用默认校验加超时请求 https://ipinfo.io/json。返回里的出口 IP 能证明代理正常。

Python requests SSL 报错:常见问题

为什么只有用代理时才出现 SSLError?

因为你和网站之间有东西改了 Python 看到的证书链,通常是检查软件,或者代理 URL 写错了。没有这一层,公共 CA 列表就够用。

verify=True、路径和 verify=False 有什么区别?

True 用 certifi 证书包,路径用你给的 CA 文件,False 接受任何证书,并且忽略主机名不匹配和证书过期。

把 CA 装进系统信任库行不行?

Requests 默认读 certifi,除非你指向别处,所以改系统信任库不一定有用。文档里的做法是用 verify 或 REQUESTS_CA_BUNDLE 传文件。

只把警告压掉可以吗?

隐藏 InsecureRequestWarning 并不能恢复保护。请改用正确的 CA。

怎么在 Python 之外测这个代理?

运行 curl -v -x http://LOGIN:PASSWORD@HOST:PORT https://ipinfo.io/json,把颁发者那一行和直连结果对比。

延伸阅读

Proxy302 在 GitHub 上公开的同主题配置指南:

参考资料

3
  1. Requests 文档:高级用法(SSL、代理、CA 证书)

    官方文档 · 确认日期:

    2026 年 11 月 20 日读取:Requests 默认校验 HTTPS 证书,校验不过就抛 SSLError;verify 可以填 CA 包的路径;也可以用 REQUESTS_CA_BUNDLE,其次 CURL_CA_BUNDLE;verify=False 会接受任何证书,文档提醒这会让程序暴露在中间人攻击之下;证书来自 certifi,文档建议经常升级;对 https 使用代理通常需要本机信任代理的根证书;代理 URL 必须带 scheme;SOCKS 需要 requests[socks],socks5h 让代理解析域名;prepared request 流程不会读取 REQUESTS_CA_BUNDLE。

  2. curl:SSL 证书校验

    官方文档 · 确认日期:

    2026 年 11 月 20 日读取:curl 默认校验,页面建议生产环境绝不要跳过校验;可用来在 Python 之外测同一个代理。

  3. Proxy302 产品事实与价格表

    产品观察 · 确认日期:

    站点的产品事实表(数值已于 2026 年 10 月 18-19 日对照控制台、后端和价格表核对):产品、美元价格(1 PTC = 1 美元)、租期、协议与端口、国家数、数量上限、没有免费试用。

准备好试试了吗?

注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。