用 socks5 代理时报 "Could not resolve host"
检查 这个名字在你自己的电脑上能解析吗?运行 nslookup 域名 看看。
处理 不能的话,改用 socks5h:// 让代理去查,或者先修本机 DNS。
停止条件 如果改成 socks5h 还是同样的错,就别再试了:代理那一侧也解析不了,先核对域名拼写。
一个字母 h,决定 DNS 查询是在你的电脑上做,还是在代理那一端做。
SOCKS5 是同一个协议。客户端请求代理去连某个地方时,请求里带着地址类型:IPv4 地址、IPv6 地址或域名(RFC 1928 里分别是 1、4、3)。发哪一种,由客户端决定。
curl 手册对两个前缀的说法是:socks5:// 使用代理但在本地解析主机名,socks5h:// 让代理来解析。也就是说 socks5 发给代理的是客户端已经查好的 IP,socks5h 发的是没解析的域名,连接本身没有别的区别。
| 项目 | 本机解析 | 代理解析 |
|---|---|---|
| curl | socks5:// | socks5h:// |
| Python requests | socks5:// | socks5h:// |
| Chrome 和 Edge | SOCKS5 下做不到 | 始终如此(没有开关可改) |
| Firefox | 偏好项 network.proxy.socks_remote_dns = false | 偏好项 network.proxy.socks_remote_dns = true |
来源:curl 手册、Requests 文档、Chromium 代理说明和 Firefox 源码,均于 2026 年 11 月 16 日阅读。Mozilla 源码里该 Firefox 偏好项默认值为 false,实际值请在 about:config 里确认。
只有代理那一侧才能解析的名字,用 socks5 会失败,比如代理背后内网里的主机名,或者你本地 DNS 答不出来的域名。用 socks5h,同一个名字就能通,因为查询发生在代理所在的位置。
有些服务对同一个 DNS 查询,会按提问者所在位置给出不同答案。socks5h 是在代理的位置查,和连接发出的位置一致;socks5 拿到的是你所在位置的答案,再让代理去连那个地址。
用 socks5 时,你自己的 DNS 会看到你通过代理访问的每一个域名;用 socks5h 则看不到,因为域名是放在 SOCKS 请求里交给代理的。目标本来就是 IP 时(比如 http://93.184.216.34/),两者没有区别,因为没有东西需要解析。
两者没有哪个对所有场景都对。名字必须走你本地或公司 DNS 解析时,用 socks5;租来的代理用来访问公网,通常选 socks5h,这样域名查询和连接都从同一个地方发出。
把下面的替身服务存成 fake_socks5.py,运行 python3 fake_socks5.py。它监听 127.0.0.1:18080,并打印每个客户端请求的内容。
另开一个终端,用 socks5:// 和一个哪儿都不存在的名字 only-on-proxy.test 跑 curl(.test 结尾是保留给示例用的,永远解析不了)。
同样的请求改用 socks5h:// 再跑一次。
对比结果:用 socks5,curl 报告解析不了主机,服务端什么也没打印;用 socks5h,服务端打印出 ATYP 3 和这个名字,说明它收到的是域名。
# fake_socks5.py: prints what the client asked for, then answers "connection refused"
import socket, threading
srv = socket.socket()
srv.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
srv.bind(("127.0.0.1", 18080))
srv.listen(5)
def handle(c):
try:
c.recv(262)
c.sendall(b"\x05\x00") # greeting: no authentication
d = c.recv(262) # CONNECT request
if len(d) < 5:
return
atyp = d[3]
if atyp == 3:
addr = d[5:5 + d[4]].decode() # a domain name
elif atyp == 1:
addr = socket.inet_ntoa(d[4:8]) # an IPv4 address
else:
addr = "ipv6"
print("ATYP", atyp, addr, flush=True)
c.sendall(b"\x05\x05\x00\x01\x00\x00\x00\x00\x00\x00") # reply 5 = connection refused
finally:
c.close()
while True:
conn, _ = srv.accept()
threading.Thread(target=handle, args=(conn,)).start()
本机示例:记录完就拒绝所有连接,所以不会有任何流量离开你的电脑。只用 Python 3 标准库。
curl -sS -m 5 -x socks5://127.0.0.1:18080 http://only-on-proxy.test/
# curl: (97) Could not resolve host: only-on-proxy.test
# (the server prints nothing: curl never got as far as the proxy)
curl -sS -m 5 -x socks5h://127.0.0.1:18080 http://only-on-proxy.test/
# curl: (97) Can't complete SOCKS5 connection to only-on-proxy.test. (5)
# the server prints: ATYP 3 only-on-proxy.test输出来自 macOS 上的 curl 8.7.1,不同版本的提示文字略有不同。这里的 97 错误是替身服务故意拒绝连接。
Requests 遵循同样的规则:文档写明 socks5 让 DNS 解析发生在客户端,socks5h 让代理解析域名。使用 SOCKS 要装额外的包:pip install 'requests[socks]'。
代理环境变量也一样。Requests 读取 ALL_PROXY,curl 也读,所以变量里写哪个前缀,就决定由谁解析。我们本机测试里 requests 表现一致:用 socks5 时名字在客户端失败,用 socks5h 时请求到达了替身服务。各工具的完整设置见下面两篇指南。
# pip install 'requests[socks]'
import requests
proxy = "socks5h://LOGIN:PASSWORD@HOST:PORT" # h = the proxy looks the name up
proxies = {"http": proxy, "https": proxy}
r = requests.get("https://ipinfo.io/json", proxies=proxies, timeout=15)
print(r.json()["ip"])仅为示例:请换成你自己的值。
# the scheme in the variable decides who resolves, just like -x
export ALL_PROXY="socks5h://LOGIN:PASSWORD@HOST:PORT"
curl https://ipinfo.io/json仅为示例:请换成你自己的值。
检查 这个名字在你自己的电脑上能解析吗?运行 nslookup 域名 看看。
处理 不能的话,改用 socks5h:// 让代理去查,或者先修本机 DNS。
停止条件 如果改成 socks5h 还是同样的错,就别再试了:代理那一侧也解析不了,先核对域名拼写。
检查 RFC 1928 里 5 是「连接被拒绝」:代理收到了域名并去连了,但目标拒绝或端口没开。
处理 检查目标端口和网站是否正常;用 IP 地址发同样的请求,把 DNS 和连接分开判断。
停止条件 用 IP 也失败,问题在目标站或代理账号,不是 DNS。
检查 Chrome 不支持 SOCKS5 的用户名密码,和 DNS 设置无关。
处理 给浏览器换成 HTTP 端口,下面的指南讲了怎么用同一组账号做到。
停止条件 不用在 Chrome 里找 socks5h 开关:它本来就在代理一侧解析。
检查 由偏好项 network.proxy.socks_remote_dns 决定,源码里它的默认值是 false。
处理 打开 about:config,改成 true,再刷新页面。
停止条件 改完页面还打不开,先用 curl 测代理本身,排除浏览器的原因。
Proxy302 的入口两种协议都支持:HTTP 是 2222 端口,SOCKS5 是 3333 端口。静态 ISP 的每个 IP 资产在购买时选定一种协议,「我的资产」里会显示,那里没有协议切换。你的是 SOCKS5 的话,在 curl、requests 等接受该前缀的工具里写 socks5h://;是 HTTP 的话就不存在这个 DNS 问题,因为 HTTP 代理收到的本来就是域名。
静态 ISP IP 在整个租期内地址不变:1 天 US$0.50,30 天 US$7.99,各国价格相同。没有免费试用,最小购买单位是一个 IP 一天。
打开静态住宅页面,选国家,「协议」选 SOCKS5,下单。
打开「我的资产」(控制台里放着你买到的全部代理),复制 HOST、PORT、USERNAME 和 PASSWORD。
拼成 socks5h://USERNAME:PASSWORD@HOST:PORT,在 curl 里用 -x 传入,或放进 requests 的 proxies。
运行 curl -x socks5h://... https://ipinfo.io/json,确认显示的 IP 和国家。
不是。线路上传的都是 SOCKS5。h 只是客户端的一个设定,告诉工具给代理发域名还是发 IP。
租来的代理用来访问公网,用 socks5h。名字必须由你自己的 DNS 解析时用 socks5,比如办公室网络里的主机。
没有,也用不着。Chromium 的说明写明,SOCKSv5 的域名解析始终在代理一侧完成。
看代理收到什么:收到域名,就是代理解析的;收到 IP,就是你的电脑解析的。本页的本机实验两种情况都能看到。如果还没连接就提示解析不了主机,说明是你自己的 DNS 失败了。
不需要。HTTP 代理在请求行或 CONNECT 行里拿到的就是域名,一直由它自己解析。
官方文档 · 确认日期:
2026 年 11 月 16 日阅读:socks5:// 和 socks5h:// 都在代理协议前缀之列;--socks5 的说明是使用 SOCKS5 代理但在本地解析主机名,--socks5-hostname(等同 socks5h://)是让代理解析主机名。
官方文档 · 确认日期:
2026 年 11 月 16 日阅读:CONNECT 请求带有地址类型 ATYP:X'01' 是 IPv4,X'03' 是域名,X'04' 是 IPv6;应答码 X'05' 表示连接被拒绝。
官方文档 · 确认日期:
2026 年 11 月 16 日阅读:用 socks5 时 DNS 解析在客户端完成,用 socks5h 时由代理解析域名;使用 SOCKS 需要 pip install requests[socks];代理地址也可以放在 ALL_PROXY 里。
官方文档 · 确认日期:
2026 年 11 月 16 日阅读:SOCKSv5 的域名解析始终在代理一侧完成,Chrome 没有切换选项;该页还提到 Firefox 的 network.proxy.socks_remote_dns 设置。
官方文档 · 确认日期:
2026 年 11 月 16 日阅读:存在 network.proxy.socks_remote_dns 这个偏好项,默认值是 false。
本地示例 · 确认日期:
2026 年 11 月 16 日对 127.0.0.1 上一个 25 行的 SOCKS5 替身服务实测(代码见本页)。用 socks5 时主机名在客户端就解析失败,替身服务什么都没收到;用 socks5h 时替身服务以「域名」地址类型收到了这个名字。
产品观察 · 确认日期:
站点的产品事实表(数值已于 2026 年 10 月 18-19 日对照控制台、后端和价格表核对):产品、美元价格(1 PTC = 1 美元)、租期、协议与端口。
注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。