---
title: "Selenium 代理身份验证设置（Python） | Proxonym"
description: "在 Selenium 中配合 Firefox 和 WebDriver BiDi 使用带身份验证的代理：网关设置、粘性会话、地理定位和错误恢复。"
url: https://proxonym.com/zh/integrations/selenium
updated: 2026-10-02T03:03:46+00:00
---

# 如何在 Selenium 中使用代理

Selenium 无法在代理登录弹窗中输入凭据，但 WebDriver BiDi 可以替您完成应答。本指南使用 Python 和 Firefox 完成 Proxonym 认证、保持粘性 IP、定位指定地区并从错误中恢复。

- 共 5 步
- 10 分钟完成配置
- 复制即用的代码

开始之前

- Python 3.10 或更高版本
- Selenium 4.32 或更高版本
- Firefox（Selenium Manager 会自动下载 geckodriver）
- Proxonym 住宅代理或移动代理套餐

连接参数

- **主机**: `gw.proxonym.com`
- **HTTP**: `8000`
- **SOCKS5**: `1080`
- **用户名**: `USERNAME-country-us`

1. **安装 Selenium**: 本指南用到的 BiDi 网络处理程序是在 Selenium 4.32 中加入的。Selenium Manager 随包一同提供，并会在首次运行时获取 geckodriver，因此您只需安装 Firefox 即可。 Shell `python -m pip install -U selenium`
2. **将 Firefox 指向网关并完成登录**: 将 HTTP 和 SSL 代理首选项设为网关地址，启用 BiDi，并注册一个认证处理程序。网关发出 407 认证质询时，Selenium 会用您的用户名和密码进行应答。 Python `from selenium import webdriver from selenium.webdriver.common.by import By options = webdriver.FirefoxOptions() options.enable_bidi = True options.set_preference("network.proxy.type", 1) options.set_preference("network.proxy.http", "gw.proxonym.com") options.set_preference("network.proxy.http_port", 8000) options.set_preference("network.proxy.ssl", "gw.proxonym.com") options.set_preference("network.proxy.ssl_port", 8000) driver = webdriver.Firefox(options=options) driver.network.add_auth_handler("USERNAME", "PASSWORD") driver.get("https://api.ipify.org") print("Exit IP:", driver.find_element(By.TAG_NAME, "body").text) driver.quit()`
3. **每个浏览器保持一个 IP**: Firefox 会在浏览器运行期间一直记住代理登录信息，因此请把一个 driver 视为一个身份。在用户名中加入 `-session-` ID，让所有连接在最长 120 分钟内都使用同一个 IP；需要新 IP 时，请启动一个新的 driver。 Python `import secrets from selenium import webdriver def new_driver(username, language=None): options = webdriver.FirefoxOptions() options.enable_bidi = True options.set_preference("network.proxy.type", 1) for scheme in ("http", "ssl"): options.set_preference(f"network.proxy.{scheme}", "gw.proxonym.com") options.set_preference(f"network.proxy.{scheme}_port", 8000) if language: options.set_preference("intl.accept_languages", language) driver = webdriver.Firefox(options=options) driver.network.add_auth_handler(username, "PASSWORD") driver.set_page_load_timeout(60) return driver session = secrets.token_hex(4) driver = new_driver(f"USERNAME-country-us-session-{session}-lifetime-60")`
4. **定位地区并匹配语言**: 在用户名中添加国家、州或城市，并相应设置浏览器语言。借助上一步的 `new_driver()` 辅助函数，两项设置都只需一行代码。 Python `from selenium.webdriver.common.by import By driver = new_driver("USERNAME-country-de-city-berlin-session-b3x9-lifetime-30", language="de-DE, de") driver.get("https://ipinfo.io/city") print("City:", driver.find_element(By.TAG_NAME, "body").text) driver.quit()`
5. **从网关错误中恢复**: 当网关拒绝建立隧道时，`driver.get()` 会抛出一个提及 `about:neterror` 的 WebDriverException。请退出该 driver，并使用新的会话 ID 重试；如果反复出现 `proxyConnectFailure` 错误，则说明凭据有误。 Python `import secrets from selenium.common.exceptions import WebDriverException def open_with_retry(url, country="us", tries=3): for attempt in range(1, tries + 1): session = secrets.token_hex(4) driver = new_driver(f"USERNAME-country-{country}-session-{session}-lifetime-30") try: driver.get(url) return driver except WebDriverException as exc: driver.quit() print(f"attempt {attempt}:", str(exc).splitlines()[0]) if attempt == tries: raise driver = open_with_retry("https://example.com") print(driver.title) driver.quit()`

## 常见问题

### 为什么不把凭据直接写在代理地址中？

浏览器会忽略代理设置中的用户名和密码，而 Selenium 的 proxy capability 也没有用于填写 HTTP 代理凭据的字段。因此，网关会对第一个请求返回 407 认证质询，再由 BiDi 认证处理程序用您的用户名和密码应答，就像真人在登录弹窗中输入一样。

### 可以用 Chrome 代替 Firefox 吗？

目前无法用这种方法实现。Chrome 会忽略其代理启动参数中的凭据，而且它的 BiDi 实现不会把代理登录质询传给 Selenium，因此处理程序永远不会被触发。对于 Chromium，请改用 Puppeteer 或 Playwright 驱动浏览器，它们原生支持代理登录；也可以使用配合 IP 白名单的共享数据中心代理，这样无需登录。

### 如何并行使用多个 IP？

每个身份启动一个 driver，各自在用户名中使用不同的会话 ID 或国家，并在不同的线程、进程或 Selenium Grid 节点中运行。Proxonym 不限制并发会话数，因此限制因素只有您的机器资源和目标网站所能承受的访问频率。

### 无头模式的 Firefox 能使用代理吗？

可以。在 Firefox 选项中添加 -headless 参数，代理首选项和认证处理程序保持不变即可。无头模式不会影响认证或定位，但会改变浏览器指纹的部分特征，因此请让语言和请求节奏与您选择的出口位置保持一致。

技巧与注意事项

- 请先用 cURL 验证凭据，因为密码错误时，认证处理程序会反复重发同一组登录信息，直到 Firefox 放弃为止。
- Firefox 在浏览器的整个生命周期内都会保留代理登录信息，因此在会话中途更换认证处理程序并不会改变 IP；请改为启动一个新的 driver。
- 将页面加载超时设为 60 秒左右，与网关保持一致：网关会在目标请求超过 60 秒后以 504 结束请求。
- 将首选项 permissions.default.image 设为 2，可阻止 Firefox 加载图片，减少按量计费的住宅代理流量。

延伸阅读

- [Puppeteer 与 Playwright 代理：认证、轮换与地理定位](https://proxonym.com/zh/blog/puppeteer-playwright-proxies)
- [网页抓取防封禁：12 个实用技巧](https://proxonym.com/zh/blog/web-scraping-without-getting-blocked)

卡在某一步了？

大多数故障都可以从错误代码中找到原因。请先查看错误代码，再单独测试代理。

- [帮助中心](https://proxonym.com/zh/help)
- [网关错误代码](https://proxonym.com/zh/docs#errors-and-troubleshooting)
- [测试您的代理](https://proxonym.com/zh/proxy-checker)

## 更多集成指南

[全部集成](https://proxonym.com/zh/integrations)

- [Python Requests (Python 库)](https://proxonym.com/zh/integrations/python-requests)
- [Scrapy (Python 框架)](https://proxonym.com/zh/integrations/scrapy)
- [AdsPower (指纹浏览器)](https://proxonym.com/zh/integrations/adspower)
