Selenium Manager中文文档

1. 什么是 Selenium Manager（测试版）

Selenium Manager 是 Selenium 官方提供的命令行工具（用 Rust 实现），用于自动管理浏览器及其驱动（chromedriver、geckodriver、msedgedriver 等）。从 Selenium 4.6.0 起，各语言绑定默认内置它，你无需额外安装或在代码里做任何配置，只要用官方的 Selenium 库，就能自动调用它。

2. 为什么要做 Selenium Manager？

• 背景问题：Selenium 要操控浏览器，需要一个“驱动”（Driver）做桥梁。过去用户必须手动下载对应浏览器版本的驱动并把它放到 PATH 下，或者在代码里指定路径。

• 痛点：浏览器（如 Chrome）会自动更新，驱动版本如果不匹配就会报错（例如 Chrome 更新到 115，而驱动还是 113，就会提示版本不兼容）。

• 解决方案：社区已有各种第三方驱动管理器（WebDriverManager、webdriver-manager、webdrivers 等），说明大家都需要这个功能。Selenium Manager 就是官方内置的驱动管理器，一站式解决下载、缓存、版本匹配的问题。

3. Selenium Manager 的核心功能

3.1 自动化驱动管理

1. 浏览器版本检测：运行系统命令（如 google-chrome --version）获取本地浏览器版本。

2. 驱动版本解析：根据浏览器版本，从厂商提供的在线元数据接口（如 Chrome for Testing）查到对应的驱动版本。

3. 驱动下载与缓存：将驱动压缩包下载、解压，并缓存到 ~/.cache/selenium 目录；下次用同一版本就直接复用缓存。

3.2 自动化浏览器管理（4.11.0+）

Selenium Manager 还没在本机没有安装浏览器时，自动下载并缓存：

• Chrome（基于 Chrome for Testing）

• Firefox（基于官方发布）

• Edge（基于官方发布）

你还可以通过 --browser-version 或对应语言绑定的浏览器选项，指定要下载的版本（如 114、beta、dev、canary、ESR 等标签）。

4. Windows 下 Edge 安装的特殊说明

• Windows 上 Edge 安装包是 MSI，需要管理员权限才能执行。

• 如果在非管理员权限环境里自动安装，Selenium Manager 会给出“需要管理员权限”提示，用户需自行以管理员身份安装。

5. 数据收集与隐私

• Selenium Manager 会每天向 Plausible 发送匿名使用统计（Selenium 版本、语言绑定、操作系统、浏览器版本、粗略地理位置）。

• 如需关闭统计，上设置环境变量：

  export SE_AVOID_STATS=true

6. 配置方式

可以通过三种优先顺序配置 Selenium Manager：

1. 命令行参数（selenium-manager --help 可查看支持的所有参数）

2. 配置文件（~/.cache/selenium/se-config.toml，TOML 格式）

3. 环境变量（把配置名转大写，加前缀 SE_，如 SE_BROWSER=chrome）

常见配置例子：

# se-config.toml
browser = "chrome"
driver = "chromedriver"
browser-version = "106"
driver-version = "106.0.5249.61"
cache-path = "/custom/cache/path"
avoid-stats = true

 

7. 缓存机制

• 默认缓存路径：~/.cache/selenium

• 驱动和浏览器下载后解压到子目录，下次复用。

• 元数据文件 se-metadata.json 存储最近一次解析的版本及 TTL（默认 3600 秒），在 TTL 有效期内不重复网络请求。

• 可用 --clear-cache 或 SE_CLEAR_CACHE=true 清空所有缓存；用 --clear-metadata 或 SE_CLEAR_METADATA=true 清除版本元数据。

8. 版本与获取

• Selenium Manager 本身版本号与 Selenium 保持一致（例如 Selenium 4.12.0 附带的 Selenium Manager 为 0.4.12，仍处在 0.x 测试版阶段）。

• 获取方式：

  • 直接随 Selenium 库一起安装

  • 从 GitHub Releases 或构建工作流下载二进制

  • 已安装时可在缓存目录 ~/.cache/selenium/manager/<version>/selenium-manager 找到

9. 命令行示例

• 自动下载驱动

./selenium-manager --browser chrome --debug

        会检测本地 Chrome 版本，下载并缓存对应 chromedriver，然后输出驱动和浏览器路径。

• 下载 beta 版浏览器及驱动

./selenium-manager --browser chrome --browser-version beta --debug

• 管理 Selenium Grid

./selenium-manager --grid

         自动下载最新的 seenium-server.jar；也可指定版本 --grid 4.5.0。

10. 在代码中启用 Selenium Manager

• Java/Python/C# 等原来手动指定驱动的写法：

  # 旧写法 driver = webdriver.Chrome(executable_path="path/to/chromedriver")

• 升级到 Selenium Manager 后，只需：

  # 新写法，自动管理 driver = webdriver.Chrome()

11. 已知限制与兼容性

• 网络环境：在企业代理或防火墙环境下，可能需要配置 --proxy 或 SE_PROXY。

• Linux 上的依赖：某些浏览器可执行文件需系统库（如 libdbus-glib-1.so.2, libatk-1.0.so.0），需用包管理器安装。

• 架构支持：官方仅保证 Windows（x86/x64）、macOS（x64/aarch64）、Linux（x64）。其他架构（如 ARM64 Linux、Raspberry Pi）需自建或用 SE_MANAGER_PATH 指定自编译的二进制。

• 自定义管理：可以用环境变量 SE_CHROMEDRIVER、SE_GECKODRIVER 等，手动指定驱动路径，绕过 Selenium Manager。