如何配置Python版Playwright使用公司代理对接BrowserStack？

核心方案：显式配置Playwright代理参数 #

Playwright连接BrowserStack这类远程服务时，不会自动读取系统/环境变量的代理配置，必须在启动浏览器上下文时显式指定代理参数，仅设置HTTP_PROXY等环境变量无法生效。

具体实现步骤 #

1. 在BrowserStack连接时嵌入代理设置
   直接在调用connect方法时，通过proxy参数传入公司代理信息，需确保代理支持HTTPS和WebSocket（BrowserStack通信依赖WS/WSS协议）。

   示例代码：

   from playwright.sync_api import sync_playwright
   
   # 替换为你的公司代理地址（即使是HTTPS代理，这里也用http开头）
   PROXY_ADDRESS = "http://your-proxy-host:port"
   
   def run_browserstack_test():
       with sync_playwright() as p:
           # 替换为你的BrowserStack能力配置（caps）
           browser_caps = '{"browser": "chrome", "browser_version": "latest", "os": "Windows", "os_version": "11", "name": "Playwright Proxy Test"}'
           browser = p.chromium.connect(
               f"wss://cdp.browserstack.com/playwright?caps={browser_caps}",
               proxy={
                   "server": PROXY_ADDRESS,
                   # 若代理需要认证，取消下方注释并填入账号密码
                   # "username": "your-proxy-username",
                   # "password": "your-proxy-password"
               }
           )
           page = browser.new_page()
           # 执行测试逻辑
           page.goto("https://www.example.com")
           print(page.title())
           browser.close()
   
   if __name__ == "__main__":
       run_browserstack_test()
   

2. 环境变量失效的原因

   • Playwright的远程CDP连接（如BrowserStack的WebSocket链接）不会读取系统环境变量的代理配置，该逻辑仅对本地浏览器发起的普通HTTP请求生效。
   • BrowserStack的Playwright集成依赖WebSocket通信，必须在connect阶段显式指定代理，才能让WS/WSS流量走公司代理通道。

额外注意事项 #

• 确认公司代理允许访问cdp.browserstack.com的443端口，以及*.browserstack.com相关域名。
• 若代理有IP白名单限制，需将BrowserStack的官方IP段加入允许列表。
• 可开启调试日志验证代理是否生效：

  import logging
  logging.basicConfig(level=logging.DEBUG)
  

内容的提问来源于stack exchange，提问作者Houbein