Playwright SOCKS5代理认证：为何失败，四种解决方案

Playwright接受socks5://服务器，然后拒绝您的用户名和密码。这个限制是Chromium的，而不是Playwright的，自2021年以来一直存在——以下是四种解决方法，按优先级排序。

Playwright SOCKS5代理认证不存在，提前知道这一点可以节省一个晚上的时间。传递一个socks5://服务器以及用户名和密码，Playwright会在浏览器导航之前拒绝。大家都关注的功能请求，microsoft/playwright#10567，于2021年11月提出，至今仍未解决，仍标记为P3-collecting-feedback。这个限制不是Playwright可以解决的：它存在于Chromium中。本文展示了确切的错误字符串，解释了为什么没有扩展或配置标志可以拯救您，并提供了四种解决方案——一行HTTP替换，IP白名单，本地中继和Firefox。

您正在寻找的错误

这个问题的每个版本都会产生两个字符串之一。在Node中，您会得到Error: Browser does not support socks5 proxy authentication；在Python中，旧版本会以playwright._impl._api_types.Error:为前缀，新版本则以playwright._impl._errors.Error:为前缀。消息相同，并且在启动时抛出，而不是在导航时：

const { chromium } = require('playwright');

// Fails immediately — no page is ever created
const browser = await chromium.launch({
  proxy: {
    server: 'socks5://gate.quantumproxies.io:PORT',
    username: 'USER',
    password: 'PASS',
  },
});
// Error: Browser does not support socks5 proxy authentication

// Python raises the same thing:
// playwright._impl._errors.Error: Browser does not support
// socks5 proxy authentication

还有一个更安静的变体。如果您省略凭证字段，而将它们填入服务器字符串中——socks5://USER:PASS@host:1080——则不会抛出任何错误。Chromium简单地忽略了URL中的用户信息部分，尝试未经认证的握手，网关拒绝它。然后您会看到net::ERR_SOCKS_CONNECTION_FAILED或在第一次goto()时出现普通超时，这会让人们寻找不存在的网络错误。

Playwright SOCKS5代理认证实际中断的地方

Playwright自己的文档明确指出：代理选项中的username和password字段被描述为“如果HTTP代理需要认证”时使用的凭证。SOCKS仅作为一种方案支持。在底层，Chromium从未实现RFC 1929中SOCKS5的用户名/密码子协商，这就是为什么Chromium问题跟踪器中关于SOCKS5认证的条目（40323993）收集了多年的评论，为什么SwitchyOmega扩展在用户选择带凭证的SOCKS5时会警告用户，以及为什么Brave和Edge的行为相同。它是一个引擎，一个缺口，被所有基于它的东西继承。

这也是为什么拯救Selenium用户的技巧在这里无效的原因。Manifest V3扩展可以通过chrome.webRequest.onAuthRequired响应代理挑战，但该钩子在HTTP 407 Proxy Authentication Required响应时触发。SOCKS5握手是在任何HTTP存在之前在套接字上进行的字节级协商，因此没有事件可以拦截。不要将上下文选项httpCredentials与代理认证混淆：它回答您正在访问的网站的401挑战，从不回答代理的挑战。对于跨隐身框架的完整图景，我们的反检测框架中认证代理的地图涵盖了谁支持什么。

解决方案1：使用同一网关的HTTP端点

这是大约十分之九用户的解决方案，只需一行代码。严肃的提供商在不同端口上通过两种协议公开相同的IP池——每个QuantumProxies计划都提供HTTP和SOCKS5端点，使用相同的凭证和相同的会话语法。切换方案和端口，保持其他不变，Playwright的本机凭证字段就能发挥作用：

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        # was: "socks5://gate.quantumproxies.io:SOCKS_PORT"
        "server": "http://gate.quantumproxies.io:PORT",
        "username": "USER",
        "password": "PASS",
    })
    page = browser.new_page()
    page.goto("https://httpbin.org/ip")
    print(page.text_content("body"))   # must be the proxy exit IP
    browser.close()

您不会失去任何可测量的东西。对于浏览器流量，HTTP代理打开一个CONNECT隧道并携带与SOCKS5隧道相同的加密字节；这两种协议之间的区别在于UDP和非HTTP流量，而不是页面加载。我们对SOCKS5与HTTP代理的比较中有详细说明。由于代理对象也被newContext()接受，相同的凭证为您提供了每个上下文的轮换，正如我们在Playwright代理集成指南中所描述的那样。

解决方案2：IP白名单保持socks5://活跃

如果您确实需要SOCKS5方案——一个只支持SOCKS的代理，一个假定它的工具链——认证机器而不是请求。将抓取器的公共IP注册到您的提供商，移除凭证，Chromium就会满意，因为没有需要协商的内容：

const { chromium } = require('playwright');

const browser = await chromium.launch({
  proxy: { server: 'socks5://gate.quantumproxies.io:PORT' }, // no creds
});
const page = await browser.newPage();
await page.goto('https://httpbin.org/ip');
console.log(await page.textContent('body'));
await browser.close();

白名单认证的是机器，而不是脚本，这就是整个权衡。具有稳定地址的VPS或办公室出口工作得很好；临时CI运行器、自动扩展的容器和任何在旋转NAT后面的东西将在地址更改时立即失败。在您信任运行之前验证出口——一个静默的直接连接看起来就像一个工作的代理，直到您的目标开始阻止您自己的IP。我们的免费IP质量检查器告诉您实际的出口是什么，而不仅仅是它响应了。

Playwright SOCKS5代理认证的四种解决方案比较：HTTP端点、IP白名单、本地中继和Firefox — HTTP端点替换只需一行代码且无能力损失。它右边的所有东西都是以某种代价获得socks5://方案。

解决方案3：剥离凭证的本地中继

当IP无法列入白名单且提供商没有HTTP端口时，在浏览器前面放一个翻译器。模式总是相同的：一个没有认证的本地监听器转发到附有凭证的上游SOCKS5端点。使用gost，这只需一个命令：

# Local no-auth HTTP listener -> authenticated upstream SOCKS5
gost -L=http://127.0.0.1:8080 \
     -F=socks5://USER:PASS@gate.quantumproxies.io:PORT

# Playwright then points at the local hop, with no credentials:
#   proxy: { server: 'http://127.0.0.1:8080' }

两个规则。将监听器绑定到127.0.0.1，而不是0.0.0.0——一个从互联网可达的无认证代理是一个开放中继，会在几小时内被发现和滥用。并且将中继视为您必须监督的进程：如果它死了，Chromium会回退到连接错误而不是直接请求，这至少是响亮的。这种方法已经足够普遍，以至于从业者发布了小型专用中继；我们在SOCKS5认证中继工具指南中比较了这些选项。

解决方案4：运行Firefox而不是Chromium

Firefox原生实现了SOCKS5用户名/密码认证，这是Playwright问题线程不断指出的区别。交换浏览器类型，错误就消失了：

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.firefox.launch(proxy={
        "server": "socks5://gate.quantumproxies.io:PORT",
        "username": "USER",
        "password": "PASS",
    })
    page = browser.new_page()
    page.goto("https://httpbin.org/ip")
    print(page.text_content("body"))   # confirm the exit before trusting it
    browser.close()

每次都进行验证步骤。Playwright不抛出并不证明凭证被使用了——只有IP回显可以证明。并且明确您购买的是什么：一个不同的渲染引擎，一个不同的指纹表面，以及一个严重倾向于Chromium的隐身生态系统。如果您的目标已经接受Firefox，这就是免费的。如果您选择Chromium是出于反机器人原因，切换引擎来解决代理问题是错误的权衡——选择解决方案1并保持您的浏览器。

决策，每行一句

提供商有HTTP端口：使用它。一行代码，本机认证，相同的出口，无需额外进程。
固定公共IP：将其列入白名单并保持socks5://，不带凭证。
都没有：运行一个绑定到回环的本地中继，并将Playwright指向127.0.0.1。
已经在Firefox上：传递凭证并验证出口IP一次。
绝不：凭证放在server字符串中。Chromium在没有任何提示的情况下丢弃它们。

Chromium中Playwright SOCKS5代理配置的工作清单与抛出或静默失败的配置 — Chromium接受SOCKS5方案但从不接受凭证。此列表右侧的所有内容都失败——其中一半没有错误。

常见问题解答

Playwright支持SOCKS5代理认证吗？

在Chromium中不支持。Playwright的代理选项将用户名和密码记录为HTTP(S)凭证，而Chromium没有SOCKS5用户名/密码实现来传递它们，因此启动时会抛出。在Playwright中Firefox支持它。跟踪问题microsoft/playwright#10567自2021年11月以来一直开放，尚未安排修复。

“浏览器不支持socks5代理认证”是什么意思？

这意味着您在Chromium启动时传递了带凭证的socks5://服务器。Playwright验证组合并拒绝，而不是打开一个会静默忽略它们的浏览器。要么转到网关的HTTP端口并保留凭证字段，要么通过IP白名单认证并完全移除它们。

如何在Python中使用Playwright的SOCKS5代理？

传递proxy={"server": "socks5://host:port"}，不带用户名或密码，并让提供商授权您的机器的公共IP。如果IP不稳定，使用相同网关的HTTP端点和凭证，或通过本地中继转发。始终在IP回显端点上确认出口。

Chrome扩展可以添加SOCKS5认证吗？

不能。用于认证HTTP代理的扩展技巧依赖于chrome.webRequest.onAuthRequired，它在HTTP 407响应时触发。SOCKS5在套接字握手期间认证，在任何HTTP请求存在之前，因此没有扩展API可以看到它。代理切换器扩展因同样原因警告此限制。

对于Playwright抓取，SOCKS5比HTTP更快吗？

没有显著差异。通过HTTP代理的HTTPS流量使用CONNECT隧道，因此两种协议携带相同的加密流，开销相当。SOCKS5的真正优势是UDP支持和协议中立，浏览器页面加载不使用这两者。选择任何一个可以干净认证的端点。

简短版本：停止尝试让Chromium做它从未做过的事情。将任务移到HTTP端点，或白名单并删除凭证——如果必须保持socks5://与旋转出口，放一个中继在中间，而不是在代码中找变通办法。一旦认证解决，决定运行是否成功的是其背后的池：覆盖200多个国家的住宅出口，当流程需要一个身份时，提供每次请求的轮换或粘性会话。

在一个计划中获取HTTP和SOCKS5端点