解决内网自动化难题：Docker-Selenium离线模式配置指南

你是否遇到过企业内网无法访问外部网络，导致Selenium自动化测试因浏览器驱动下载失败而中断的问题？本文将详细介绍如何通过Docker-Selenium的离线模式功能，利用预配置的浏览器和驱动环境，在无网络环境下实现稳定的自动化测试执行。

什么是Selenium Manager离线模式

Selenium Manager是Selenium 4.6+版本引入的驱动管理工具，能够自动下载和配置浏览器驱动。在无法连接互联网的环境中，可通过启用SE_OFFLINE模式强制Selenium使用Docker镜像中预安装的浏览器和驱动文件，避免外部网络依赖。

Docker-Selenium项目在镜像构建时已包含各浏览器对应版本的驱动程序，通过环境变量控制即可激活离线工作模式。官方环境变量定义见ENV_VARIABLES.md。

核心配置参数解析

实现离线模式的关键环境变量配置如下：

环境变量	默认值	描述
SE_OFFLINE	false	设置为true启用离线模式，强制使用镜像内置浏览器和驱动
SE_NODE_ENABLE_MANAGED_DOWNLOADS	true	控制节点是否自动管理下载文件，离线环境建议保持默认值
SE_BROWSER_BINARY_LOCATION	自动检测	可手动指定浏览器二进制路径，如/usr/bin/google-chrome

表：离线模式核心环境变量配置

快速开始：Standalone模式离线配置

Standalone模式适合单节点测试环境，包含完整的Selenium Server和浏览器环境。以下是Chrome浏览器的离线启动命令：

docker run -d -p 4444:4444 -p 7900:7900 \
  --shm-size="2g" \
  -e SE_OFFLINE=true \
  selenium/standalone-chrome:4.37.0-20251020

参数说明：

• -e SE_OFFLINE=true：启用离线模式
• --shm-size="2g"：解决Chrome共享内存限制问题
• -p 7900:7900：VNC可视化端口，可通过http://localhost:7900查看浏览器操作

启动后可通过VNC访问验证浏览器运行状态，默认密码为secret。

分布式网格：Hub-Node架构离线部署

在企业内网环境中，通常需要部署多节点网格实现并发测试。使用Docker Compose可快速搭建离线网格环境：

# docker-compose-offline.yml
version: '3'
services:
  hub:
    image: selenium/hub:4.37.0-20251020
    ports:
      - "4442:4442"
      - "4443:4443"
      - "4444:4444"
    environment:
      - SE_OFFLINE=true

  chrome:
    image: selenium/node-chrome:4.37.0-20251020
    shm_size: 2gb
    depends_on:
      - hub
    environment:
      - SE_EVENT_BUS_HOST=hub
      - SE_OFFLINE=true

  firefox:
    image: selenium/node-firefox:4.37.0-20251020
    shm_size: 2gb
    depends_on:
      - hub
    environment:
      - SE_EVENT_BUS_HOST=hub
      - SE_OFFLINE=true

启动命令：

docker-compose -f docker-compose-offline.yml up -d

完整分布式网格配置可参考docker-compose-v3-full-grid.yml，只需在各节点服务中添加SE_OFFLINE=true环境变量即可。

多浏览器支持与架构选择

Docker-Selenium提供多种浏览器镜像，在离线模式下需注意不同架构的支持情况：

浏览器	x86_64架构支持	ARM64架构支持	驱动文件路径
Chrome	✅	❌	/usr/bin/chromedriver
Firefox	✅	✅	/usr/bin/geckodriver
Edge	✅	❌	/usr/bin/msedgedriver
Chromium	✅	✅	/usr/bin/chromedriver

表：各浏览器在不同架构下的离线支持情况

对于需要在ARM64架构（如Apple Silicon）运行的场景，推荐使用Firefox或Chromium镜像。多浏览器合一的镜像配置可参考NodeAllBrowsers/Dockerfile。

验证离线模式是否生效

启动容器后，可通过两种方式验证离线模式是否正确启用：

1. 日志验证：查看容器日志确认Selenium Manager使用离线模式

docker logs <container_id> | grep "Selenium Manager offline mode"

预期输出应包含：Using Selenium Manager offline mode, using pre-configured browser and driver

2. UI验证：访问Grid控制台http://localhost:4444，在Nodes页面查看节点配置信息，确认offline属性为true

常见问题与解决方案

1. 驱动版本不匹配

症状：启动时报错session not created: This version of ChromeDriver only supports Chrome version XX

解决：确保使用的镜像标签与测试代码中指定的浏览器版本匹配。查看各版本浏览器变更记录可参考CHANGELOG/4.35.0/chrome_134.md

2. 共享内存不足

症状：Chrome启动后崩溃，日志显示Failed to move to new namespace

解决：增加--shm-size参数至2g以上，如--shm-size="4g"

3. VNC无法连接

症状：访问7900端口无响应

解决：检查是否禁用了VNC服务，默认配置见NodeBase/start-vnc.sh，确保SE_START_VNC=true

最佳实践与注意事项

1. 镜像版本固定：生产环境务必使用具体版本标签（如4.37.0-20251020）而非latest，避免自动更新导致离线环境异常

2. 本地镜像仓库：在内网环境中搭建Docker镜像仓库，将所需镜像提前推送至私有仓库，配置方法参考tests/docker-compose-v3-test-standalone.yml

3. 资源监控：离线环境通常资源受限，建议通过Video/recorder.conf配置适当的视频录制参数，避免磁盘空间耗尽

4. 定期更新镜像：虽然离线模式不依赖网络，但仍需定期更新基础镜像以获取安全补丁和浏览器更新，更新脚本可参考tag_and_push_browser_images.sh

总结

通过配置SE_OFFLINE环境变量，Docker-Selenium能够在完全隔离的内网环境中稳定运行，解决企业级自动化测试的网络依赖痛点。结合本文介绍的验证方法和最佳实践，可确保离线环境下的自动化测试流水线可靠执行。

完整的项目配置和更多高级用法可参考：

• 官方环境变量文档：ENV_VARIABLES.md
• 分布式网格配置：docker-compose-v3-full-grid.yml
• 构建自定义镜像：Makefile