SeleniumBase UC在Docker中验证码绕过失败，本地正常如何解决？

问题描述 #

我正在使用SeleniumBase搭配Undetected ChromeDriver（UC）绕过验证码。该脚本在我的macOS本地机器上使用Chrome运行完全正常，但在基于官方SeleniumBase镜像的Docker容器中运行相同代码时，无法绕过验证码。

所用代码 #

from seleniumbase import SB

with SB(headed=True, uc=True, test=True, undetectable=True) as sb:
    url = "https://gitlab.com/users/sign_in"
    sb.uc_open_with_reconnect(url, 4)
    sb.uc_gui_click_captcha()
    print(sb.uc_gui_click_captcha())  # Debug log
    sb.assert_text("Username", '[for="user_login"]', timeout=3)
    sb.assert_element('label[for="user_login"]')
    sb.highlight('button:contains("Sign in")')
    sb.highlight('h1:contains("GitLab.com")')
    sb.post_message("SeleniumBase wasn't detected", duration=4)

已尝试操作 #

• 本地运行：完全正常，验证码可成功绕过。
• Docker中运行：使用headed=True和X11查看浏览器，浏览器可打开，但验证码绕过失败。

疑问 #

为何验证码绕过在Docker中失败？是否需要为容器中的UC进行额外配置或其他操作？

解决方案及分析 #

1. 容器Chrome环境与本地存在差异 #

容器内的Chrome即使启用headed=True，窗口尺寸、渲染特性等参数仍和本地桌面环境有差异，容易被验证码系统识别为自动化程序。

解决方法：

• 显式设置Chrome窗口大小，初始化SB时添加参数：

  with SB(headed=True, uc=True, test=True, undetectable=True, window_size="1920,1080") as sb:
  

• 注入脚本掩盖webdriver属性：

  sb.driver.execute_cdp_cmd('Page.addScriptToEvaluateOnNewDocument', {
      'source': '''
          Object.defineProperty(navigator, 'webdriver', {
              get: () => undefined
          })
      '''
  })
  

2. UC在容器中的初始化配置缺失 #

官方SeleniumBase镜像可能未完全适配UC的容器化需求，缺少必要系统依赖或默认参数不符合绕过要求。

解决方法：

• 自定义Dockerfile补充系统依赖：

  FROM seleniumbase/seleniumbase:latest
  
  RUN apt-get update && apt-get install -y \
      libnss3-dev \
      libgtk-3-dev \
      libxss-dev \
      libasound2 \
      && rm -rf /var/lib/apt/lists/*
  

• 强制UC重置Chrome配置后重新连接：

  sb.uc_reset()
  sb.uc_open_with_reconnect(url, 4)
  

3. 容器IP特征被验证码系统识别 #

容器IP通常属于数据中心网段，和本地家庭/办公IP的行为特征差异大，验证码系统会提高验证门槛，导致自动化绕过失败。

解决方法：

• 为容器配置接近本地环境的代理：

  with SB(headed=True, uc=True, test=True, undetectable=True, proxy="http://your-proxy-ip:port") as sb:
  

• 模拟真实用户行为，添加随机延迟和滚动操作：

  import time
  import random
  
  time.sleep(random.uniform(1, 3))
  sb.execute_script("window.scrollTo(0, document.body.scrollHeight);")
  time.sleep(random.uniform(0.5, 1.5))
  

4. GUI验证码识别受容器显示环境影响 #

uc_gui_click_captcha()依赖图像识别，容器内X11转发的显示质量可能不足，导致识别精度下降。

解决方法：

• 调整验证码识别超时时间：

  sb.uc_gui_click_captcha(timeout=10)
  

• 确保X11转发配置正确，避免显示失真：
  运行容器时使用以下参数：

  docker run -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix your-custom-image
  

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