selenium/node-firefox

Selenium Grid Firefox节点镜像

镜像概述和主要用途

本镜像提供带有Firefox浏览器的Selenium Grid节点，需与Selenium Grid Hub配合使用，支持远程运行WebDriver测试。

核心功能和特性

• 与Selenium Grid Hub通信，构建分布式测试网格
• 内置Firefox浏览器，支持WebDriver协议测试
• 通过环境变量配置事件总线通信参数
• 支持查看容器内浏览器运行状态（可选）

使用场景和适用范围

适用于开发和测试团队构建分布式Web自动化测试环境，尤其适合需要在远程或多节点环境中执行基于Firefox的Web应用测试任务。

使用方法和配置说明

前提条件

• 已安装Docker引擎
• 基本Docker网络知识

详细部署步骤

1. 创建Docker网络

Hub与节点需在同一网络中通过容器名称通信，首先创建专用网络：

bash
docker network create grid

2. 启动Selenium Grid Hub

使用创建的网络启动Hub容器：

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

3. 启动Firefox节点

使用同一网络启动节点，配置与Hub的通信参数：

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-firefox: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-firefox:latest

4. 配置测试指向Grid

将WebDriver测试目标地址设置为http://localhost:4444

5. （可选）查看容器内部状态

访问http://localhost:7900/?autoconnect=1&resize=scale&password=secret可实时查看容器内Firefox运行状态

重要配置说明

• 共享内存设置：运行包含浏览器的镜像时，需使用--shm-size=2g参数以利用主机共享内存
• 标签建议：示例中使用latest标签，生产环境建议使用完整标签固定版本，详见https://github.com/SeleniumHQ/docker-selenium/wiki/Tagging-Convention
• 网络清理：测试完成且容器退出后，可删除网络：

  bash
  docker network rm grid
  

标签选择指南

标签结构

基础标签格式：

selenium/node-firefox-<主版本>.<次版本>.<补丁版本>-<日期>

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

selenium/node-firefox-<浏览器版本>-<浏览器驱动>-<驱动版本>-<主版本>.<次版本>.<补丁版本>-<日期>

标签示例（Firefox 110.0、GeckoDriver 0.33.0、Selenium Grid 4.9.0，20230426发布）

selenium/node-firefox:4
selenium/node-firefox:4.9
selenium/node-firefox:4.9.0
selenium/node-firefox:4.9.0-20230426
selenium/node-firefox:110.0
selenium/node-firefox:110.0-20230426
selenium/node-firefox:110.0-geckodriver-0.33.0
selenium/node-firefox:110.0-geckodriver-0.33.0-20230426
selenium/node-firefox:110.0-geckodriver-0.33.0-grid-4.9.0-20230426

可根据需求选择简化标签（如4）或完整标签固定版本。

完整文档

Docker-Selenium项目在GitHub提供详细https://github.com/SeleniumHQ/docker-selenium%EF%BC%8C%E5%8F%AF%E6%A0%B9%E6%8D%AE%E5%85%B7%E4%BD%93%E5%9C%BA%E6%99%AF%E9%85%8D%E7%BD%AE%E9%95%9C%E5%83%8F%E3%80%82

许可证

本项目由志愿者贡献，源代码基于https://raw.githubusercontent.com/SeleniumHQ/selenium/trunk/LICENSE%E5%BC%80%E6%BA%90%E3%80%82