Selenium headless 代理不生效：3 个原因

最常见的 3 个原因

原因 1：账号密码写在了代理地址里。Chrome 的文档写明它不使用嵌在代理设置里的账号密码，所以 --proxy-server=http://LOGIN:PASSWORD@HOST:PORT 并不会登录。有界面时你也许会看到登录框、手动填过一次；headless 没有窗口可填，页面就直接失败。

原因 2：有界面和 headless 用的不是同一个代理来源。Chromium 网络栈默认使用系统网络设置，桌面上的浏览器配置里还可能装着代理扩展；容器或 CI 里两样都没有，同一份脚本就会用机器自己的 IP 出去，或者直接连不上。

原因 3：协议或端口对不上。Proxy302 网关的 HTTP 和 SOCKS5 端口不同（2222 和 3333），而 Chrome 不支持带认证的 SOCKS5。用 Selenium 驱动 Chrome 跑带账号密码的 SOCKS5，无论 headless 怎么设都不会通。

第四种看起来像掉线：轮换线路每个新连接换一个 IP，长脚本中途看到出口 IP 变了，这是线路本身的规则，不是故障。

• 代理认证 407 说明

• 来源：
• Chromium 文档：Chrome 的代理支持
• Chromium 文档：网络设置
• Proxy302 产品信息与价格表

给 Chrome 设代理的几种办法，以及它们怎么处理账号密码

依据 2026 年 11 月 13 日读到的 Chromium 代理文档、Selenium 驱动选项页和 selenium-wire 仓库。「是」表示文档有说明，请用你自己的 Chrome 和 chromedriver 版本实测。

• 来源：
• Chromium 文档：Chrome 的代理支持
• selenium-wire 仓库
• Selenium 文档：驱动选项（代理）

按 4 步检查

1. 第 1 步：先在浏览器之外测通账号密码

   打开「我的资产」，复制 HOST、PORT、USERNAME、PASSWORD，运行下面代码块里的 curl 那一行。应当打印出口 IP 和国家。curl 都不通，问题在代理信息，和 Selenium、headless 无关。

   预期结果 curl 打印出代理的出口 IP。

2. 第 2 步：浏览器用 HTTP 端口

   Chrome 不支持带登录的 SOCKS5，所以给它用 HTTP 的资产（Proxy302 上是 2222 端口）。按 IP 租用的静态 IP 即使买的是 SOCKS5，同一组账号密码也能走 2222 的 HTTP（2026 年 11 月 4 日实测）；其他资产只认创建时选的协议。

   • Chrome 里的 SOCKS5 登录

3. 第 3 步：开一个本地转发器，让 Chrome 连它

   运行下面的 gost 那一行。它监听 127.0.0.1:8080，替你登录代理。然后用 --proxy-server=http://127.0.0.1:8080 启动 Chrome，不带任何账号密码。用之前请核对你所用 gost 版本的参数写法。

   继续前请注意 务必绑定 127.0.0.1，不要绑所有地址，否则同一网络里的其他机器能用你的代理登录。

4. 第 4 步：在 headless 浏览器里打印出口 IP

   运行下面的 Python 测试。页面能打开不能说明什么，因为 Chrome 可能是直连出去的。只有打印出的 IP 才是真实路径，应当和第 1 步 curl 的结果一致。

   预期结果 打印的 IP 和 curl 的一致。

测通登录并启动转发器

# 1) test the login outside the browser (HTTP port)
curl -x http://LOGIN:PASSWORD@HOST:2222 https://ipinfo.io/json

# 2) local forwarder: Chrome connects here without a login
gost -L http://127.0.0.1:8080 -F http://LOGIN:PASSWORD@HOST:2222

仅为示例：把 LOGIN、PASSWORD、HOST 换成「我的资产」里的值；登录名或密码里的 @ 等特殊字符要用百分号编码（@ 写成 %40）。

• 来源：
• GOST 文档：转发链
• Chromium 文档：Chrome 的代理支持

打印出口 IP 的 Selenium 测试

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.common.by import By

options = Options()
options.add_argument("--headless=new")
# the local forwarder from step 3: no login in this address
options.add_argument("--proxy-server=http://127.0.0.1:8080")

driver = webdriver.Chrome(options=options)
try:
    driver.get("https://ipinfo.io/json")
    print(driver.find_element(By.TAG_NAME, "body").text)
finally:
    driver.quit()

仅为示例。需要 Chrome 和版本匹配的 chromedriver（或 Selenium Manager）。如果打印的是你自己的 IP，说明 Chrome 没有走代理。

• 来源：
• Selenium 文档：Chrome 浏览器选项
• Chrome for Developers：Chrome Headless 模式

还是不行怎么办

用 Proxy302 时

网关的 HTTP 端口是 2222，SOCKS5 端口是 3333。Selenium 驱动 Chrome 请用 HTTP。轮换住宅线路每个新连接换一个 IP，用于很多互不相关的页面加载；需要固定出口的测试，静态 ISP IP 在租期内不轮换，1 天 US$0.50，30 天 US$7.99。

没有免费试用，最小的购买是一个 IP 一天，或 1 GB 的轮换住宅流量。

• 静态住宅代理
• 轮换住宅代理

• 来源：
• Proxy302 产品信息与价格表

常见问题

延伸阅读

自动化场景里和代理相关的页面。

Selenium 代理 IP

Selenium 设置带用户名密码的代理：ChromeOptions 填 HTTP 代理，再用 Selenium 自带的 BiDi 认证处理，不装插件。测试用静态机房 IP，实测可用。

查看配置与价格

代理连接失败怎么排查

Chrome 或 Edge 连不上代理服务器时，会显示 ERR_PROXY_CONNECTION_FAILED，完整提示是「无法连接到代理服务器」。

SOCKS5 带密码浏览器不支持

Chrome 没有 SOCKS5 登录，但按 IP 租用的静态 ISP 用同一组账号密码也能走 HTTP 的 2222 端口。

Puppeteer 代理设置

用 --proxy-server、page.authenticate 和浏览器上下文在 Puppeteer 里设置 HTTP 代理，并检查出口 IP。

数据中心代理如何计费

按 IP 购买数据中心代理：高速固定 IP，单地址价格最低，按 IP 和租期计费。支持 HTTP / SOCKS5，可选国家。

查看配置与价格