Webdriver Remote模式下Firefox扩展Tampermonkey安装失败问题

你的配置存在两个核心错误，导致远程模式下Tampermonkey无法正常加载：

• 本地文件路径对远程节点不可见：profile.add_extension传入的是你本机磁盘上的xpi路径，连接127.0.0.1:4445的远程Webdriver服务时，服务进程无法读取你本地的文件，自然无法完成扩展安装。
• API用法不兼容：Selenium 4.x版本后，独立实例化FirefoxProfile再通过browser_profile参数传入的写法在Remote模式下存在序列化丢失问题，官方已经将扩展安装、profile配置的能力全部整合到FirefoxOptions中，旧传参方式的配置会被直接忽略。

Selenium 4.x 标准写法（推荐） #

直接通过FirefoxOptions实例加载扩展，Selenium会自动将本地xpi文件序列化传输到远程Webdriver节点，不需要手动处理profile传递，代码如下：

from selenium import webdriver

options = webdriver.FirefoxOptions()
options.set_preference('intl.accept_languages', 'en,en-US')
options.add_argument('--log-level=3')  # 不输出日志
options.add_argument('--mute-audio')  # 静音音频
options.add_argument('--enable-webgl-draft-extensions')
options.add_argument('--disable-infobars')  # 禁用弹窗
options.add_argument('--disable-popup-blocking')  # 禁用信息栏

# 直接通过options加载扩展，自动完成本地到远程节点的文件传输
options.add_extension('/path/to/tampermonkey.xpi')

# 初始化驱动时无需传入browser_profile参数
driver = webdriver.Remote(
    command_executor="http://127.0.0.1:4445/wd/hub",
    options=options
)

兼容注意事项 #

• 请确保使用的Tampermonkey安装包是Mozilla官方签名的正式版本，Firefox默认禁止安装未签名扩展。如果是测试场景下使用未签名xpi，需要额外添加偏好配置关闭签名校验：

  options.set_preference('xpinstall.signatures.required', False)
  

• 如果你仍在使用Selenium 3.x老版本，不要单独传browser_profile参数，需要先将profile绑定到options对象再初始化驱动：

  profile = webdriver.FirefoxProfile()
  profile.add_extension('/path/to/tampermonkey.xpi')
  options.profile = profile
  driver = webdriver.Remote("http://127.0.0.1:4445/wd/hub", options=options)
  

• 不要尝试将xpi文件放到远程节点（比如Docker容器）的磁盘路径下再传容器内路径，通过options.add_extension传本地路径的方式由Selenium自动处理文件传输，兼容性和稳定性更高。

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