selenium/standalone-all-browsers

Selenium Grid Standalone多浏览器镜像文档

镜像概述

该Docker镜像基于Selenium Grid的Standalone模式构建，集成了Chrome、Edge和Firefox三种主流浏览器及其对应驱动程序。Standalone模式将Selenium Grid的hub和node功能合并为单一服务，无需单独部署hub和node节点，可快速搭建完整的Selenium自动化测试环境，支持通过标准WebDriver协议进行跨浏览器自动化测试。

核心功能与特性

1. Standalone模式部署

• 无需分离部署hub和node组件，单容器即可提供完整的Selenium Grid服务
• 简化部署流程，降低测试环境配置复杂度

2. 多浏览器支持

• 内置Chrome、Edge、Firefox浏览器及对应版本的WebDriver
• 浏览器驱动自动匹配浏览器版本，无需手动维护驱动兼容性

3. 即开即用

• 预配置浏览器环境，启动容器后即可接收测试请求
• 支持Selenium 4+标准协议，兼容各类Selenium客户端库

4. 灵活扩展

• 支持通过环境变量调整会话超时、并发数等核心参数
• 可集成至CI/CD流水线，支持自动化测试流程嵌入

使用场景

1. 开发/测试环境

• 本地开发时快速搭建自动化测试环境
• 验证Web应用在不同浏览器中的功能表现

2. 跨浏览器兼容性测试

• 一次部署即可完成Chrome、Edge、Firefox多浏览器兼容性验证
• 降低多浏览器测试环境的维护成本

3. CI/CD集成

• 作为CI/CD流程中的测试环节，自动执行测试用例
• 支持与Jenkins、GitHub Actions、GitLab CI等主流CI工具集成

4. 教学与演示

• 简化Selenium Grid教学环境搭建
• 演示WebDriver协议及自动化测试原理

使用方法

基本部署命令

通过以下命令启动Selenium Grid Standalone服务：

bash
docker run -d -p 4444:4444 --name selenium-standalone <镜像名称>

说明：

• -p 4444:4444：映射Selenium Grid默认服务端口（4444）至主机
• --name selenium-standalone：指定容器名称，便于管理
• <镜像名称>：替换为实际使用的Docker镜像标签（如selenium/standalone-chrome-edge-firefox）

访问Grid控制台

容器启动后，通过浏览器访问以下地址打开Selenium Grid控制台：

http://localhost:4444/ui

控制台可查看节点状态、活跃会话、浏览器配置等信息。

核心参数配置

环境变量配置

通过-e参数设置环境变量调整服务行为，常用参数如下：

配置示例：设置会话超时为600秒，最大并发会话数为5

bash
docker run -d -p 4444:4444 \
  -e SESSION_TIMEOUT=600 \
  -e MAX_SESSIONS=5 \
  -e SE_OPTS="--log-level INFO" \
  --name selenium-standalone <镜像名称>

持久化日志

通过挂载主机目录持久化Selenium日志：

bash
docker run -d -p 4444:4444 \
  -v /host/path/to/logs:/var/log/selenium \
  --name selenium-standalone <镜像名称>

测试脚本示例

使用Selenium客户端库连接至Grid服务，以下为Python示例：

python
from selenium import webdriver
from selenium.webdriver.common.desired_capabilities import DesiredCapabilities

# 连接到Selenium Grid
driver = webdriver.Remote(
    command_executor='http://localhost:4444/wd/hub',
    desired_capabilities=DesiredCapabilities.CHROME  # 指定浏览器，可选CHROME/EDGE/FIREFOX
)

# 执行测试操作
driver.get("https://example.com")
print(driver.title)

# 关闭会话
driver.quit()

注意事项

1. 资源需求：多浏览器并发测试需保证主机至少2GB内存，推荐4GB以上
2. 网络配置：容器需与测试脚本运行环境网络互通，确保4444端口可访问
3. 版本兼容性：镜像标签通常包含浏览器版本信息，选择时需匹配测试需求
4. 权限设置：如遇浏览器启动失败，可尝试添加--shm-size=2g参数增加共享内存

常见问题

• Q：如何查看浏览器版本？
  A：访问Grid控制台http://localhost:4444/ui/nodes，在节点详情中查看已配置的浏览器信息。

• Q：测试会话无法连接？
  A：检查主机防火墙是否开放4444端口，容器是否正常运行（docker ps），日志是否有错误（docker logs selenium-standalone）。

• Q：如何限制特定浏览器使用？
  A：通过SE_OPTS参数传递节点配置，如-e SE_OPTS="--exclude-browser chrome"排除Chrome浏览器。