selenium/node-chromium

Selenium Grid Chromium Node 镜像文档

镜像概述

Selenium Grid Chromium Node 镜像提供了一个集成了 Chromium 浏览器的 Selenium Grid Node 节点，旨在与 Selenium Grid Hub 配合使用，实现 WebDriver 测试的远程分布式执行。

该镜像允许用户在容器化环境中运行基于 Chromium 浏览器的自动化测试，无需在本地环境安装和配置浏览器及驱动程序。

核心功能和特性

• 预安装 Chromium 浏览器，无需额外配置
• 内置 Selenium WebDriver 驱动程序
• 支持与 Selenium Grid Hub 通信，实现分布式测试
• 包含 VNC 服务器，可实时查看容器内浏览器操作
• 轻量级容器化设计，易于部署和扩展

使用场景和适用范围

• 自动化 Web 应用测试环境搭建
• 跨浏览器兼容性测试
• 并行执行多个测试用例以提高效率
• CI/CD 流程中的自动化测试环节集成
• 开发和测试团队共享测试资源

使用方法和配置说明

前置要求

• Docker Engine 19.03 或更高版本
• 至少 2GB 可用内存
• 网络连接（用于拉取镜像和依赖）

快速启动步骤

1. 创建 Docker 网络

首先创建一个专用网络，使 Hub 和 Node 能够相互通信：

bash
docker network create grid

2. 启动 Selenium Grid Hub

使用创建的网络启动 Selenium Hub：

bash
docker run -d -p 4442-4444:4442-4444 --net grid --name selenium-hub selenium/hub:latest

3. 启动 Chromium Node

Linux/macOS 命令：

bash
docker run -d --net grid -e SE_EVENT_BUS_HOST=selenium-hub \
    --shm-size="2g" \
    -e SE_EVENT_BUS_PUBLISH_PORT=4442 \
    -e SE_EVENT_BUS_SUBSCRIBE_PORT=4443 \
    selenium/node-chromium:latest

Windows PowerShell 命令：

powershell
docker run -d --net grid -e SE_EVENT_BUS_HOST=selenium-hub `
    --shm-size="2g" `
    -e SE_EVENT_BUS_PUBLISH_PORT=4442 `
    -e SE_EVENT_BUS_SUBSCRIBE_PORT=4443 `
    selenium/node-chromium:latest

4. 配置测试

将 WebDriver 测试指向 Grid Hub 地址：http://localhost:4444

5. 监控容器内操作

可通过 VNC 连接查看容器内浏览器操作：

• 访问地址：http://localhost:7900/?autoconnect=1&resize=scale&password=secret
• 默认密码：secret

环境变量配置

清理资源

测试完成后，可使用以下命令清理资源：

bash
# 停止并删除容器
docker stop selenium-hub
docker rm selenium-hub
# 删除网络
docker network rm grid

镜像标签选择

为确保环境一致性，推荐使用特定版本标签而非 latest。标签命名规则如下：

基础标签格式

selenium/node-chromium-<主版本>.<次版本>.<补丁版本>-<发布日期>

包含浏览器和驱动版本的标签格式

selenium/node-chromium-<浏览器版本>-<驱动名称>-<驱动版本>-<Grid版本>-<发布日期>

标签示例

# 基础标签
selenium/node-chromium-4.9.0-20230426

# 包含浏览器和驱动信息的标签
selenium/node-chromium-112.0-chromedriver-112.0-grid-4.9.0-20230426

更多标签信息请参考 https://github.com/SeleniumHQ/docker-selenium/wiki/Tagging-Convention%E3%80%82

注意事项

1. 共享内存设置：运行包含浏览器的容器时，必须使用 --shm-size="2g" 参数以确保浏览器正常运行
2. 版本固定：生产环境中应使用具体版本标签而非 latest，避免因自动更新导致环境变化
3. 资源需求：每个节点至少需要 2GB 内存和 1 CPU 核心
4. 网络配置：确保 Hub 和 Node 在同一网络中，并且事件总线端口可正常通信
5. 安全考虑：默认 VNC 密码为 "secret"，生产环境中应修改此密码

完整文档

有关高级配置和更多使用场景，请参考 https://github.com/SeleniumHQ/docker-selenium/blob/trunk/README.md%E3%80%82

许可证

本项目基于 https://raw.githubusercontent.com/SeleniumHQ/selenium/trunk/LICENSE 开源许可协议。