selenium/standalone-edge

Selenium Grid Standalone with Edge 镜像文档

镜像概述与主要用途

本镜像提供基于 Edge 浏览器的 Selenium Grid Standalone 环境，用于实现 WebDriver 测试的远程执行。通过该镜像，用户可快速搭建包含 Edge 浏览器的独立 Selenium Grid 节点，简化远程浏览器自动化测试的部署流程。

核心功能与特性

• 独立模式运行：无需额外配置 Hub 和 Node，直接以独立模式启动 Selenium Grid，简化部署流程。
• 内置 Edge 环境：集成 Edge 浏览器及对应版本的 EdgeDriver，开箱即可执行基于 Edge 的 Web 自动化测试。
• 远程测试支持：通过 Grid 暴露的接口（默认 4444 端口），支持远程提交 WebDriver 测试任务。
• 可视化监控：提供 VNC 访问接口（7900 端口），可实时查看容器内 Edge 浏览器的运行状态。
• 灵活版本控制：支持通过标签精确指定 Edge 浏览器版本、EdgeDriver 版本及 Selenium Grid 版本，满足测试环境一致性需求。

使用场景与适用范围

• Web 应用自动化测试：适用于需要在 Edge 浏览器中执行的 UI 自动化测试，支持本地或远程触发。
• CI/CD 流程集成：可作为持续集成/持续部署流程中的测试节点，自动执行 Web 应用测试用例。
• 跨环境测试：在不同主机或容器化环境中提供一致的 Edge 测试环境，避免本地环境差异影响测试结果。
• 远程测试监控：通过 VNC 接口实时查看测试执行过程，便于调试失败的测试用例。

使用方法与配置说明

快速启动容器

基础启动命令

通过以下命令启动 Selenium Grid Standalone with Edge 容器：

bash
docker run -d -p 4444:4444 -p 7900:7900 --shm-size="2g" selenium/standalone-edge:latest

参数说明

• -d：后台运行容器。
• -p 4444:4444：映射 Grid 服务端口（4444），用于接收 WebDriver 测试请求。
• -p 7900:7900：映射 VNC 访问端口（7900），用于可视化监控容器内浏览器操作。
• --shm-size="2g"：设置共享内存大小（推荐 2GB），避免浏览器运行时因内存不足导致崩溃。

测试执行与监控

1. 提交测试任务：
   将 WebDriver 测试代码中的远程服务器地址指向 http://localhost:4444，即可通过 Grid 执行测试。

2. 可视化监控（可选）：
   访问 http://localhost:7900/?autoconnect=1&resize=scale&password=secret，通过 VNC 查看容器内 Edge 浏览器的实时状态（默认密码：secret）。

标签选择策略

为确保测试环境稳定性，建议使用具体版本标签而非 latest。镜像标签结构支持按浏览器版本、驱动版本、Grid 版本及发布日期精确指定，格式如下：

标签结构

1. 基础格式（Grid 版本 + 发布日期）：

   selenium/standalone-edge-<Major>.<Minor>.<Patch>-<YYYYMMDD>
   

2. 包含浏览器及驱动版本的格式：

   selenium/standalone-edge-<browserVersion>-<browserDriver>-<browserDriverVersion>-<Major>.<Minor>.<Patch>-<YYYYMMDD>
   

标签示例

以 Edge 112.0、EdgeDriver 112.0、Selenium Grid 4.9.0、发布日期 20230426 为例，可用标签包括：

selenium/standalone-edge:4.9.0-20230426  
selenium/standalone-edge:112.0  
selenium/standalone-edge:112.0-edgedriver-112.0  
selenium/standalone-edge:112.0-edgedriver-112.0-grid-4.9.0-20230426  

通过上述标签，可灵活选择所需版本组合，例如指定 Edge 112.0 及 Grid 4.9.0 的标签为 112.0-edgedriver-112.0-grid-4.9.0-20230426。

注意事项

• 共享内存配置：运行包含浏览器的镜像时，必须通过 --shm-size 指定共享内存大小（推荐 2GB），否则可能因内存限制导致浏览器崩溃。
• 版本固定：生产环境中建议使用具体版本标签（如上述示例），避免 latest 标签自动更新导致环境变化。

完整文档参考

更多配置细节、高级用法及故障排查，请参考 https://github.com/SeleniumHQ/docker-selenium%E3%80%82

许可证

本项目源代码基于 https://raw.githubusercontent.com/SeleniumHQ/selenium/trunk/LICENSE 开源，感谢社区贡献者的志愿开发与维护。