# 代理IP怎么在代码里用：requests、Selenium、Playwright 四种挂法与出口验收

> 来源网页：https://socks5ip.com.cn/jiaochengzhongxin/dailiip-daima-zenmeyong/
> 发布日期：2026-11-11
> 更新时间：2026-11-11

**代码挂代理失败，八成不是代理坏了，是认证没传对**。同一个代理，用 `curl -x` 能通、换到 Python 里就 407，说明线路没问题，是客户端没把用户名密码带过去。

这件事在四种技术栈上的表现完全不同：`requests` 是把认证写进 URL，写错协议头会静默失败；`httpx` 新旧版本参数名改过一次，照抄老教程直接报错；Selenium 和 Playwright 更麻烦——Chromium 内核压根不支持带认证的 SOCKS5，这条路走不通，只能换方案。本文把四种挂法逐个给到可直接抄的写法，每一节末尾给一条「怎么确认它真的通了」的验收标准，最后给一个能跑的代理池轮换骨架。

🔗 相关入口：[IP 检测工具（查出口与住宅属性）](https://socks5ip.com.cn/ip-check/) ｜ [各平台价格表](https://socks5ip.com.cn/jiagebiao/) ｜ [实测榜（按线路真实表现排序）](https://socks5ip.com.cn/ip-shice/)

本文按「先判故障归属 → requests → httpx → Selenium → Playwright → 四个验收点 → 代理池」的顺序走，赶时间的话看完下面这张卡，直接跳到你要用的那个库。

📌 一句话结论

四种挂法里，**只有 httpx 与 Playwright 原生支持「带账号密码的代理」**；requests 需要 `requests[socks]` 且协议头必须写 **socks5h** 才不会泄漏 DNS；Selenium 与 Playwright 走 Chromium 时**不支持认证型 SOCKS5**，必须改用 HTTP 代理或本地转发。

| requests
| 认证写在 URL 里，协议头用 `socks5h://`；需装 `requests[socks]`

| httpx
| 0.28 起用 `proxy=`（单数），传 `proxies=` 会报参数不存在

| Selenium
| `--proxy-server` 只认无认证代理；带账号密码要本地转发

| Playwright
| `new_context(proxy={...})` 支持认证，但 Chromium 不认 SOCKS5 认证

| 必验四项
| 出口 IP／地理位置与 ASN／DNS 泄漏／时区与 WebRTC 一致性

数据来源：本站逐项实测四种客户端行为 ｜ 核对日期 2026-11-11

🔗 快速入口：[一站式注册入口](https://linkdd.cn/socks5ip) ｜ [价格中心](https://socks5ip.com.cn/jiagezhongxin/) ｜ [代理工具中心](https://socks5ip.com.cn/dailigongjuzhongxin/)

## 先判一件事：挂不上是代理问题还是代码问题

**先用一条命令行把「代理」和「代码」这件事分开，别急着在代码里猜**。curl 能通而 Python 不通，故障就在客户端；两者都不通，才回头查代理。

诊断顺序固定成三步，可以省掉大半排查时间。

第一步，绕开你的代码，直接用 curl 走同一条代理。把下面命令里的地址换成后台拿到的真实值：

`curl -x socks5h://用户名:密码@IP:端口 https://ipinfo.io/json -m 15`

注意这里也写 `socks5h`。如果返回的 JSON 里 `ip` 是你买的那条代理的地址，说明代理本身、认证、网络三段全好——问题 100% 在你的代码里。

第二步，看报的什么错。三种错误指向三个不同部位：

| 报错
| 真实含义
| 该查哪

| 407 Proxy Authentication Required
| 认证没带上或格式错
| 用户名密码是否转义、协议头对不对

| Connection refused / timed out
| 端口不通或 IP 已过期
| 后台看 IP 有效期、本地防火墙

| 返回 200 但 IP 没变
| 代理根本没被使用
| 变量名拼错、库没装全、环境变量覆盖

第三步，才是改代码。很多人跳过前两步直接改代码，结果在错误的方向上换库、换写法，越换越乱。

还有一个容易被忽略的点：**系统代理环境变量会覆盖你代码里的设置**。如果机器上设过 `HTTP_PROXY`，某些库会优先读环境变量而不是你传的参数。测试时先清掉：

`import os
for k in ["HTTP_PROXY","HTTPS_PROXY","ALL_PROXY","http_proxy","https_proxy","all_proxy"]:
os.environ.pop(k, None)`

这一步不做的后果是：明明传了 A 代理，流量却从 B 代理或直连出去，而日志里看不出任何异常。

如果你的代码跑在服务器或 Docker 容器里，排查顺序还不一样——容器内的环境变量、`network_mode`、以及宿主机转发会各挡一层。那种情况看本站另一篇 [服务器和 Docker 里怎么挂代理：程序没走代理先排查这四层](https://socks5ip.com.cn/zuixinzixun/jishuzixun/dailiip-fuwuqi-docker-guadaili-siceng/)，本文不重复。

## requests：认证写在 URL 里，协议头决定会不会漏 DNS

**requests 挂代理只有一处关键选择：写 socks5 还是 socks5h**。差别在 DNS 由谁来解析——写错不会报错，但你的真实访问域名会从本地泄漏出去。

先把依赖装对。requests 本身不支持 SOCKS 协议，必须装带额外依赖的版本：

`pip install "requests[socks]"`

只写 `pip install requests` 的话，跑到发请求那一步会抛 `Missing dependencies for SOCKS support`，很多人误以为是代理配置错了。

然后是核心写法。认证信息和地址拼成一条 URL，塞进 `proxies` 字典，`http` 与 `https` 两个键都要给：

`import requests

PROXY = "socks5h://用户名:密码@IP:端口" # 注意 h
proxies = {"http": PROXY, "https": PROXY}

s = requests.Session() # 复用连接，省掉每次握手
s.proxies.update(proxies)

r = s.get("https://ipinfo.io/json", timeout=(5, 15))
print(r.status_code, r.json().get("ip"))`

**为什么是 socks5h 而不是 socks5。** 两个协议头的区别是 DNS 解析位置：`socks5` 让你本机先解析域名、再把 IP 发给代理；`socks5h` 把域名整条发给代理、由代理那边解析。前者会把你访问了哪些域名暴露在本地 DNS 请求里，后者不会。做多账号或跨境业务时，这个差异是实质性的，不是洁癖。

**密码里有特殊字符必须转义。** 如果密码含 `@`、`:`、`/`，直接拼进 URL 会解析错位，表现为 407 或连到错误端口。用 `urllib.parse.quote` 处理：

`from urllib.parse import quote
pwd = quote("你的密码", safe="")
PROXY = f"socks5h://{user}:{pwd}@{ip}:{port}"`

**验收标准**：`r.json()["ip"]` 等于后台显示的代理 IP；且把 `socks5h` 改成 `socks5` 再跑一次，两次出口 IP 应当相同——不同就说明原路没走代理。

如果你只想知道「Python 里最基础的 requests 用法」，本站早前那篇 [如何在 Python 中使用代理 IP](https://socks5ip.com.cn/zuixinzixun/ruhezaipythonzhongsh/) 讲了从后台取参数的完整动作，本文不重复那部分，只补它没覆盖的坑。

## httpx：参数名改过一次，照抄老教程会直接报错

**httpx 从 0.28 起把 `proxies` 改成 `proxy`（单数）且只接受一个值**。老教程里的字典写法在新版本上会抛 `TypeError: Client.__init__() got an unexpected keyword argument 'proxies'`。

先确认自己的版本，再选写法：

`python -c "import httpx; print(httpx.__version__)"`

0.28 及以上，写法是这样：

`import httpx

PROXY = "socks5://用户名:密码@IP:端口" # httpx 的 socks5 默认由代理解析 DNS

with httpx.Client(proxy=PROXY, timeout=httpx.Timeout(15.0, connect=5.0)) as c:
r = c.get("https://ipinfo.io/json")
print(r.json()["ip"])`

**httpx 在 DNS 这一点上和 requests 不一样。** 它没有 `socks5h` 这个头，`socks5://` 就走代理解析。所以从 requests 迁过来的人不用再改协议头，这一点反而是省事的。

异步场景用 `AsyncClient`，一个客户端实例内部维护连接池，几百个请求共用同一条隧道：

`import asyncio, httpx

async def main():
async with httpx.AsyncClient(proxy=PROXY, timeout=15.0) as c:
tasks = [c.get("https://ipinfo.io/json") for _ in range(5)]
for r in await asyncio.gather(*tasks, return_exceptions=True):
print(getattr(r, "status_code", r))

asyncio.run(main())`

**超时要分层设，不要只给一个数字。** `connect` 是建立 TCP 到代理的时间，`read` 是等目标站响应的时间。代理线路慢的时候，连接很快但读取很慢；只设总超时会导致你把「线路慢」误判成「代理挂了」，然后去换一条本来没问题的线路。

**验收标准**：并发 5 个请求时，返回的出口 IP 应当始终是同一条（同一条代理）；若出现多个不同 IP，说明你用的是动态/轮换型套餐，属于正常，但要在业务层按 IP 分组处理结果。

## Selenium：Chromium 不支持带认证的 SOCKS5，只能绕

**Selenium 挂代理的天花板是浏览器内核给的：Chrome 的 `--proxy-server` 不处理认证**。带账号密码的代理直接填进去，浏览器会弹一个你无法用代码填的登录框，然后卡死。

无认证的代理（IP 白名单模式）是最省事的，启动参数一行搞定：

`from selenium import webdriver
from selenium.webdriver.chrome.options import Options

o = Options()
o.add_argument("--proxy-server=socks5://IP:端口")
o.add_argument("--headless=new") # 无头模式一样要带这条，别漏
d = webdriver.Chrome(options=o)
d.get("https://ipinfo.io/json")
print(d.find_element("tag name", "body").text)`

有认证的代理，三条可行路径，按推荐度排：

**第一条，本地转发（最稳）。** 在机器上起一个本地端口，把「带认证的远程代理」转成「本地无认证代理」，浏览器只看到本地地址。常用工具是 gost：

`gost -L socks5://127.0.0.1:1080 -F socks5://用户名:密码@IP:端口`

之后浏览器参数写 `--proxy-server=socks5://127.0.0.1:1080` 即可。这样做的好处是：一台机器可以同时挂多条远程线路，开不同本地端口，互不干扰。

**第二条，改用 HTTP 代理。** 多数平台同一条线路同时开放 SOCKS5 与 HTTP 两种协议，而 Chromium 对 HTTP 代理的认证支持要好得多（走扩展或 PAC 都能处理）。切换协议比改架构便宜。

**第三条，装代理认证扩展。** 用一个处理 `onAuthRequired` 的 Chrome 扩展，把用户名密码写进扩展里。可行，但要维护扩展文件、且在无头模式下加载未打包扩展有限制，工程上不如前两条干净。

**验收标准**：`driver.get("https://ipinfo.io/json")` 后读到的 `ip` 是代理 IP；同时确认没有弹认证框——如果页面停在空白且进程不退出，基本就是被认证框卡住了。

## Playwright：context 级代理最灵活，但同样卡在 SOCKS5 认证

**Playwright 的代理是挂在 context 上的，不是挂在浏览器上**。这意味着同一个浏览器实例可以开多个 context、每个 context 用不同代理，天然适配多账号隔离。

基础写法，认证直接传字典，不需要拼 URL：

`from playwright.sync_api import sync_playwright

with sync_playwright() as p:
b = p.chromium.launch(headless=True)
ctx = b.new_context(proxy={
"server": "http://IP:端口", # 用 HTTP 代理，认证更可靠
"username": "用户名",
"password": "密码",
})
pg = ctx.new_page()
pg.goto("https://ipinfo.io/json")
print(pg.inner_text("body"))`

**关键限制要说清：Chromium 内核不支持 SOCKS5 代理的认证。** 所以上面 `server` 如果写成 `socks5://...` 并同时带 `username`/`password`，认证不会生效，连接会被拒。这不是 Playwright 的缺陷，是底层 Chromium 的能力边界——Selenium 那边卡的是同一个地方。可行做法同样是本地转发或改用 HTTP 代理。

多账号场景的写法，一个浏览器开三个 context：

`for i, px in enumerate(PROXIES):
ctx = b.new_context(proxy=px)
pg = ctx.new_page()
pg.goto("https://ipinfo.io/json")`

**这里有个容易误判的地方**：context 之间隔离的是 Cookie 与存储，不隔离浏览器指纹。同一个 `browser` 起的多个 context，UA、Canvas、WebGL 这些特征仍然高度一致。所以「开三个 context 就等于三个独立环境」是错的——真要隔离账号，得配合指纹浏览器，或者至少给每个 context 单独设 UA、时区、语言、视口。

**验收标准**：每个 context 各自访问一次 IP 查询接口，出口 IP 两两不同；再访问一次 `browserleaks.com/webrtc`，确认 WebRTC 暴露的地址也不是本地真实 IP。

## 出口验收：四个点必须一起验，只验 IP 会漏

**只核对「IP 变了」是不够的，还要验地理位置、ASN、DNS 与浏览器特征是否跟着变**。IP 对了但地区不对，跨境电商会直接被判异常。

四个点的验收动作，逐个给：

**第一，出口 IP 一致。** 基础项，访问 `https://ipinfo.io/json` 或本站的 [IP 检测工具](https://socks5ip.com.cn/ip-check/) 看返回的 `ip` 字段。对不上即未走代理。

**第二，地理位置与 ASN 一致。** 查 `http://ip-api.com/json/?fields=country,regionName,city,isp,as`，看 `country`、`isp`、`as` 三个字段是否符合你买的类型：

| 你买的是
| 期望看到
| 看到这个就说明买错了

| 美国住宅静态
| `country: United States`＋家宽运营商 ASN
| ASN 挂着 Amazon / Google / DigitalOcean 等云厂商

| 国内静态
| `country: China`＋电信/联通/移动
| 显示为某机房 IDC

| 动态住宅
| 每次换 IP 但同城同运营商
| 一次换一个国家

「标称住宅、实际云机房」是这类采购最常见的问题，验 ASN 是唯一能当场识破的办法。

**第三，DNS 泄漏。** 用 `socks5h`（requests）或代理侧解析（httpx）时不会泄漏；用 `socks5` 加本地解析时，你访问的每个域名都会以明文 DNS 请求发出去。验法是跑 `dnsleaktest.com` 扩展测试，看 DNS 归属地是否与代理地区一致。

**第四，浏览器特征一致性（仅浏览器场景）。** 时区、语言、WebRTC 暴露的本地地址，三者要和代理地区自洽。一个美国 IP 配着 `Asia/Shanghai` 时区和中文 `Accept-Language`，这是最典型的自动化特征。

四项全过才算可用。任一项不过都别急着上量——上量后排查成本是现在的十倍。

## 代理池：轮换与重试的最小可用骨架

**代理池不需要复杂框架，四十行代码够用：列表 + 健康检查 + 失败剔除 + 轮换**。真正决定稳定性的是「什么错误该换 IP、什么错误该重试同一条」，不是池子有多大。

先分清两类失败，这决定了重试策略：

- **可重试（换 IP 有用）**：超时、连接被拒、407、目标站返回 403/429。这类大概率是线路或 IP 被目标站标记了。

- **不可重试（换 IP 没用）**：DNS 解析失败、目标站返回 404、你的代码抛 `TypeError`。换一百条代理也一样失败，只会把整个池子跑废。

最小骨架：

`import itertools, time, requests

POOL = ["socks5h://u:p@1.1.1.1:1080", "socks5h://u:p@2.2.2.2:1080"]
DEAD = {}
rr = itertools.cycle(POOL)

def fetch(url, tries=3):
last = None
for _ in range(tries):
px = next(rr)
if DEAD.get(px, 0) > time.time():
continue
try:
r = requests.get(url, proxies={"http": px, "https": px}, timeout=(5, 15))
if r.status_code in (403, 429):
raise requests.HTTPError("%s" % r.status_code)
return r
except Exception as e:
last = e
DEAD[px] = time.time() + 300 # 冷却 5 分钟
raise RuntimeError("all proxies failed: %s" % last)`

**轮换粒度按业务定，不是越勤越好。** 同一账号的连续操作要绑同一条 IP（否则登录态、风控画像全乱），不同账号之间才轮换。把「每请求换一次」当默认值是常见误区——它会让你的会话看起来像被一群人轮流使用。

**健康检查别只 ping 端口。** 端口通不代表能用，很多失效 IP 依然接受 TCP 连接。检查方式应当是发一个真实请求并校验返回的 `ip` 是否等于预期值，一分钟一次就够。

**验收标准**：人为把池里一条代理的密码改错，再跑 10 次请求——应该看到它被标记、冷却、其余请求不受影响，且总成功率仍接近 100%。这就是池子真正起作用的证据。

## 常见问题

**下面六条是实操里问得最多的，答案都来自实测**。如果你的情况不在里面，先按第一章的三步诊断走一遍，多数问题能自己定位。

**Q：curl 能通，Python 就是不通，为什么？**

A：最常见三个原因——没装 `requests[socks]`、协议头写成 `socks5://` 而密码含特殊字符没转义、系统 `HTTP_PROXY` 环境变量覆盖了你的参数。按这三条依次排除。

**Q：socks5 和 socks5h 到底差在哪，必须用 h 吗？**

A：差在 DNS 由谁解析。用 `socks5` 时你本机会先解析域名，把访问记录留在本地；用 `socks5h` 时域名整条交给代理解析。做多账号、跨境业务必须用 h，普通内网访问影响不大。

**Q：Selenium 能挂带账号密码的 SOCKS5 吗？**

A：不能。Chromium 的 `--proxy-server` 不处理认证，会弹一个代码填不了的登录框。要么用 IP 白名单模式的无认证代理，要么本地起 gost 转发，要么改用 HTTP 代理。

**Q：一条代理能开多少并发？**

A：没有统一数字，取决于套餐的并发上限和目标站的容忍度。保守做法是从 5 个并发起测，观察目标站返回码；出现 429 就说明到顶了。别一上来开 50 个，那是把自己送进黑名单最快的方式。

**Q：IP 换了，网站还是认出我是同一个人，为什么？**

A：因为 IP 只是识别维度之一。Cookie、浏览器指纹、时区、字体、Canvas 哈希都不随 IP 变。只换 IP 不换环境，等于换了外套没换脸。这也是为什么正规做法是「IP + 环境」一起隔离。

**Q：买之前怎么验？**

A：优先选支持免费测试的平台，测的时候按本文第六章四项逐个过，别只测「能不能连上」。测试节点和你实际购买的那条线不一定是同一批机器，所以测试结论只对测试的那条线负责——正式开通后再验一次。

## 📚 相关阅读

**按你的下一步选一篇，避免重复踩坑**。本文只讲代码层挂法，选平台与验证方法在下面几篇里。

- [2026 年最全 IP 代理选购指南：从入门到精通](https://socks5ip.com.cn/zuixinzixun/2026nianzuiquanipdailixuangouzhinan/) —— 还没定平台，先看这篇，含平台横向评测与验货两步法。

- [如何在 Python 中使用代理 IP](https://socks5ip.com.cn/zuixinzixun/ruhezaipythonzhongsh/) —— requests 最基础的从后台取参数到跑通，与本文互补。

- [购买代理 IP 后如何使用](https://socks5ip.com.cn/zuixinzixun/goumaidailiiphouruhe/) —— 不写代码、直接在系统与客户端里配置的做法。

- [代理 IP 实测榜](https://socks5ip.com.cn/ip-shice/) —— 按线路真实表现排序，选平台前先看数据。

- [各平台价格表](https://socks5ip.com.cn/jiagebiao/) —— 24 家平台公开价对照，同规格比价用。

## 更多帮助

**如需获取更多帮助，请访问官网：[socks5ip.com.cn](https://socks5ip.com.cn/)**

📊 **[全平台价格表（20+ 家横向比价）](https://socks5ip.com.cn/jiagezhongxin/)**

📖 **[代理工具中心（全平台客户端下载与配置教程）](https://socks5ip.com.cn/dailigongjuzhongxin/)**

🛠️ **[IP综合检测中心：IP质量/线路/测速/业务模拟免费测](https://socks5ip.com.cn/ip-check-center/)**

📝 **一站式注册入口（聚合 20+ 平台，全部免费测试）：[https://linkdd.cn/socks5ip](https://linkdd.cn/socks5ip)**

本站聚合 24 家代理 IP 平台，站内价即我方优惠价，走专属注册链接下单才生效；实付金额与标价不符的，联系客服免费改价。已经自行注册过的也可以先问一句能否改价。

客服微信 **17720135827**（备用 878989347）｜用户 QQ 群 **1045307809**｜邮箱 **878989347@qq.com**。技术问题建议附上报错原文和你的调用代码片段，排查会快很多。
