docker-selenium

环境要求

• 已安装并启动 Docker（镜像发布在 Docker Hub 的 selenium 命名空间下）
• 如需编排多节点，需安装 Docker Compose
• Docker 有足够磁盘拉取浏览器镜像，且浏览器镜像需使用共享内存参数
• 在 Apple Silicon / ARM 机器上注意，compose 示例中部分浏览器镜像指定了 platform: linux/amd64

安装与启动步骤

1. 1准备 Docker 环境

   README 的安装说明全部基于 Docker，请先在本机安装并启动 Docker；浏览器镜像对共享内存有要求，需要在运行时通过参数放开。

2. 2启动独立模式容器

   最快的方式：用 standalone 镜像同时跑 Hub 和 Firefox 节点，README 快速开始即用此命令；请注意必须带 --shm-size=2g。

   docker run -d -p 4444:4444 -p 7900:7900 --shm-size="2g" selenium/standalone-firefox:4.48.0-20260905

   复制

3. 3创建 Docker 网络

   做 Hub-Node 分布式网格时，Hub 与 Node 必须处在同一网络，README 要求第一步先创建名为 grid 的网络。

   docker network create grid

   复制

4. 4启动 Hub 容器

   启动 selenium/hub 并映射 4442-4444 端口，容器名固定为 selenium-hub，便于节点按容器名互相识别。

   docker run -d -p 4442-4444:4442-4444 --net grid --name selenium-hub selenium/hub:4.48.0-20260905

   复制

5. 5启动浏览器节点

   在 grid 网络内启动 Chrome 节点，用 SE_EVENT_BUS_HOST 指向 Hub 容器名；Edge、Firefox 节点只需替换镜像名。

   docker run -d --net grid -e SE_EVENT_BUS_HOST=selenium-hub 
       --shm-size="2g" 
       selenium/node-chrome:4.48.0-20260905

   复制

6. 6或用 Compose 起网格

   把仓库里的 compose 文件保存到本地，在文件所在目录执行启动；该文件会一并拉起 Hub 与 Chrome、Edge、Firefox 等节点。

   docker compose -f docker-compose-v3-beta-channel.yml up

   复制

7. 7查看容器画面与停止

   调试时可访问 7900 端口的 VNC 页面实时观察容器内浏览器；结束时用 compose down 停止并清理容器。

   docker compose -f docker-compose-v3-beta-channel.yml down

   复制

关键配置

如何确认成功

把 WebDriver 测试指向 http://localhost:4444；浏览器打开 http://localhost:7900/?autoconnect=1&resize=scale&password=secret 能看到容器内画面，

常见问题

注意事项

• 浏览器镜像运行务必带 --shm-size，单浏览器节点用 2g，全浏览器节点示例用 3g。
• 镜像不要用 latest，用完整 tag 固定浏览器和 Grid 版本。
• compose 示例里 Edge、chrome-for-testing 等镜像标注了 platform: linux/amd64，非 amd64 机器需留意。
• 除 Docker 外，README 还提供 Helm Chart，可在 Kubernetes 中创建 Selenium Grid。