配代理时,最常见的错误不是别的,就是开头那几个字母和冒号后面那几个数字:协议前缀和端口,没对上。
麻烦的是,填错了之后报出来的错,看起来和「协议」「端口」毫无关系:一会儿说证书有问题,一会儿说连接被重置,有时候干脆不报错,只是数据不对。
这篇给一张反查表:从你看到的报错,直接反推是哪一处填错了,不用一项项排查。
如果你还在纠结该用哪种协议,先看HTTP、HTTPS、SOCKS5 代理怎么选。那篇是选型,该用哪个;这篇是排错,填错了怎么认出来。
一、先看一个正确的写法长什么样
代理地址由四部分组成:协议前缀、账号密码、主机、端口。
协议://用户名:密码@主机:端口
打个比方:像一个完整的收件地址,「寄送方式 + 收件人 + 街道 + 门牌号」。寄送方式写错了,快递公司不收;门牌号写错了,送到了别人家。
| 部分 | 要注意的 |
|---|---|
| 协议前缀 | 说的是「怎么连代理」,常见的是 http://、socks5://、socks5h:// |
| 用户名、密码 | 里面有 @、冒号等符号时要先转写,见URL 编码是什么 |
| 主机、端口 | 和协议成对:HTTP 入口和 SOCKS5 入口的端口通常不同 |
| 结尾 | 端口后面不要再加路径 |
二、反查表:从报错找填错的地方
先在左列找到你看到的报错,再看是哪一处填错了。
| 你看到的报错或现象 | 多半是哪里填错了 | 怎么改 |
|---|---|---|
| WRONG_VERSION_NUMBER、加密握手失败 | 普通 HTTP 代理,却写成了 https:// 开头 |
改成 http:// |
| 连接被拒绝(Connection refused) | 端口写错,或者这个端口上没有对应的服务 | 照后台给的端口重新填 |
| 连上就被断开、空回复、连接被重置 | 协议和端口不配套:用 SOCKS5 的写法连了 HTTP 的端口,或者反过来 | 前缀和端口成对改:HTTP 前缀配 HTTP 端口,SOCKS5 前缀配 SOCKS5 端口 |
| 一直等到超时 | 主机或端口填错,连到了一个不响应的地方 | 核对主机和端口,看是不是多了空格或少了一位 |
| Python 报缺少 SOCKS 支持的依赖 | 用了 socks5://,但没装对应的扩展 |
安装请求库的 SOCKS 扩展,或改用 HTTP 入口 |
| 407 认证失败 | 用户名密码不对,或里面的特殊符号没转写 | 见407 Proxy Authentication Required |
| 不报错,但地区不对 | 用了 socks5://,应该用 socks5h:// |
见第三节 |
第一行的详细原理,见SSL: WRONG_VERSION_NUMBER 报错;其他状态码的意思,见HTTP 状态码速查。
还有一个常见的小坑:地址末尾多写了路径,比如 http://主机:端口/proxy。代理地址到端口就结束了,后面加的东西有的程序会忽略,有的会报格式错误,统一去掉最稳妥。
三、最隐蔽的一种:socks5 和 socks5h
两个字母之差,决定了网址是在你这边解析,还是在出口那边解析。这里的「解析」,就是把网址翻译成服务器地址那一步。
socks5://:网址在你本地翻译,再把翻译好的地址交给代理去连。socks5h://:把网址原样交给代理,由出口那一端去翻译。
结果是:用 socks5:// 时,出口虽然在目标国家,连的却可能是离你本地近的那台服务器,拿到的是本地的版本,而且不报任何错。做和地区有关的任务,用 SOCKS5 时一定写 socks5h://。原理的完整说明见HTTP、HTTPS、SOCKS5 代理怎么选第四节,这里不重复。
四、一分钟验证写法对不对
用 curl 带着这个代理地址,访问一个能显示来访地址的网页。下面这条命令的作用是通过代理访问一个网址,并显示连接的详细过程:
curl -v -x "协议://用户名:密码@主机:端口" https://IP查询网址/
- 能拿到页面,显示的地址是代理的出口:写法对了。
- 报错:拿报错去第二节的反查表里找。
- 拿到了页面,但地区不对:检查是不是第三节的情况。
五、边界与产品对应
必须说清楚:协议和端口填错是配置问题,换哪家代理都一样。照后台给的那一套原样填,前缀和端口不要自己改,就能避开大部分这类报错。
易路代理同时提供 HTTP 与 SOCKS5 两种入口,三条产品线——动态住宅 IP(按流量计费)、静态住宅 IP(按条数计费)、动态手机 IP(按流量计费)——都可以按需选择接入方式。两种入口的主机与端口,以你账户后台的信息为准。本文示例均为通用占位写法。想先配一遍试试,我们提供免费试用。
六、常见问题
Q1. 代理 IP 端口怎么填?
A. 按后台给的填,并且和协议成对:HTTP 前缀配 HTTP 入口的端口,SOCKS5 前缀配 SOCKS5 入口的端口。
Q2. 填 http 还是 socks5?
A. 只代理网页和接口的,用 HTTP 入口就够。需要代理其他类型的流量时用 SOCKS5,并且写成 socks5h。
Q3. 代理前缀写成 https 为什么报错?
A. 前缀说的是怎么连代理。普通 HTTP 代理不在这个端口提供加密,写成 https 会导致握手失败。
Q4. 端口填错会报什么错?
A. 通常是连接被拒绝或一直超时;如果端口对应的是另一种协议,可能是连上就断开或空回复。
先测,再谈采购
照后台给的那一套原样填,用 curl 验证一次——大部分配置问题到这一步就消失了。
(本文基于 2026 年 10 月 curl 与常见客户端的通用行为整理,不同工具的报错文案略有差异;示例均为占位写法,实际主机与端口以后台为准。)