测试后端云原生容器编排可观测性【免费下载链接】docker-seleniumProvides a simple way to run Selenium Grid with Chrome, Firefox, and Edge using Container Platform, making it easier to perform browser automation at scale项目地址https://gitcode.com/GitHub_Trending/do/docker-selenium点击查看免费下载本文以 CHANGELOG/archived/4.35.0/chrome_112.md 这份发布记录为切入点拆解 docker-selenium 项目如何为指定浏览器版本生成一组结构化的 Docker 镜像标签并结合 tag_and_push_browser_images.sh 源码、NodeChrome 安装脚本 与 Docker Hub 标签约定文档讲清为什么同一个浏览器版本会有十几个不同 tag旧版本浏览器与最新 Grid 版本如何共存以及如何挑选并实际使用这些镜像。读完本文你将掌握 docker-selenium 标签体系的设计逻辑并能据此精确固定测试环境中的浏览器与 Grid 版本。一、文档速览一次真实的浏览器标签发布记录CHANGELOG/archived/4.35.0/chrome_112.md内容极简只有一段命令执行日志但它完整记录了发布流程的核心产物——针对 Chrome 112 生成的整组镜像标签./tag_and_push_browser_images.sh 4.35.0 20250909 selenium false chrome true Tagging images for browser chrome, version 4.35.0, build date 20250909, namespace selenium Selenium Grid version - 4.35.0-20250909 Chrome version - 112.0.5615.165 Short Chrome version - 112.0 ChromeDriver version - 112.0.5615.49 Short ChromeDriver version - 112.0 Tagged selenium/node-chrome:112.0.5615.165-chromedriver-112.0.5615.49-grid-4.35.0-20250909 Tagged selenium/standalone-chrome:112.0.5615.165-chromedriver-112.0.5615.49-grid-4.35.0-20250909 Tagged selenium/node-chrome:112.0.5615.165-chromedriver-112.0.5615.49-20250909 Tagged selenium/standalone-chrome:112.0.5615.165-chromedriver-112.0.5615.49-20250909 Tagged selenium/node-chrome:112.0.5615.165-20250909 Tagged selenium/standalone-chrome:112.0.5615.165-20250909 Tagged selenium/node-chrome:112.0-chromedriver-112.0-grid-4.35.0-20250909 Tagged selenium/standalone-chrome:112.0-chromedriver-112.0-grid-4.35.0-20250909 Tagged selenium/node-chrome:112.0-chromedriver-112.0-20250909 Tagged selenium/standalone-chrome:112.0-chromedriver-112.0-20250909 Tagged selenium/node-chrome:112.0-20250909 Tagged selenium/standalone-chrome:112.0-20250909这份日志传达了几个关键事实发布对象Chrome 112 固定版本112.0.5615.165搭配 ChromeDriver112.0.5615.49打包进 Selenium Grid4.35.0-202509094.35.0 版本、20250909 构建日期的 Node 与 Standalone 镜像。镜像形态每次发布同时处理node-chromeGrid 分布式架构中的节点与standalone-chrome单机一体形态两类镜像。标签数量为每个镜像生成了 6 个标签合计 12 行输出。这与脚本中RELEASE_OLD_VERSIONtrue命令最后一个参数的语义直接相关——旧版本浏览器发布时只打带构建日期的标签不再覆盖无日期的通用标签。对比最新的 CHANGELOG/4.48.0/chrome_112.md 可以发现同一浏览器版本112在不同 Grid 版本4.48.0下的发布记录结构完全一致只是版本号与构建日期不同。这印证了标签发布流程是高度脚本化、可重复的。二、为什么需要这么多标签固定版本测试的需求CHANGELOG/README.md 的开篇说明了这套矩阵的设计动机Selenium Grid 核心版本持续演进、不断加入新功能但测试团队往往需要把浏览器固定在某个特定版本——可能因为该版本与业务兼容性最好也可能因为某些版本存在已知问题需要规避。docker-selenium 为此在发布每个 Grid 版本时都打包一批历史浏览器版本Chrome 95152、Edge、Firefox 等形成Grid 版本 × 浏览器版本的矩阵。矩阵表里每一格都链接到一份 changelog 文档即本文这类文件。最新的 Grid 版本放在 Latest Grid Version 小节历史版本归入 Archived Grid Versions4.35.0下的记录之所以归档是因为它已不是当前最新的 Grid 版本但 Chrome 112 镜像仍然可用——这正是固定版本测试的价值所在即使 Grid 升级到 4.48.0依然可以拉取 4.35.0 时代的 Chrome 112 镜像。同时 README 也给出重要提示项目并没有对每种 Grid 版本 × 浏览器版本组合做全量功能测试使用者需要根据自己的测试需求评估选择。这意味着固定版本标签提供的是可用性保障而不是每个组合都经过完整回归的承诺。三、标签体系全解从完整版本号到短版本号标签约定在 docs/docker-hub/node-chrome.md 与 docs/docker-hub/standalone-chrome.md 中有明确说明标签由多个信息片段按固定顺序拼接而成selenium/node-chrome-Major.Minor.Patch-YYYYMMDD selenium/node-chrome-browserVersion-browserDriver-browserDriverVersion-Major.Minor.Patch-YYYYMMDD以发布记录中的标签为例逐一拆解其语义selenium/node-chrome:112.0.5615.165-chromedriver-112.0.5615.49-grid-4.35.0-20250909标签片段含义本例值112.0.5615.165Chrome 完整版本号Chrome 112 的 Patch 版本chromedriver-112.0.5615.49配套的 ChromeDriver 完整版本与 Chrome 同主版本grid-4.35.0-20250909Selenium Grid 版本 构建日期Grid 4.35.0、2025-09-09112.0短版本取完整版本号的前两段便于记忆和简写完整的标签族可以概括为四层渐进细化最简层112.0、112.0-20250909—— 只看浏览器大版本适合用这个主版本就行的场景。浏览器 驱动112.0-chromedriver-112.0、112.0-chromedriver-112.0-20250909—— 明确指定驱动版本。精确到 Patch112.0.5615.165、112.0.5615.165-20250909—— 浏览器 Patch 级锁定。全量信息112.0.5615.165-chromedriver-112.0.5615.49-grid-4.35.0-20250909—— 浏览器、驱动、Grid 版本、构建日期全部确定可复现性最强。其中短版本号由脚本中的short_version()函数计算得出按.拆分版本号后取前两段见 tag_and_push_browser_images.sh如112.0.5615.165→112.0。标签如何在镜像内被探测生成脚本并不硬编码版本号而是直接运行刚构建好的镜像来探测版本。以 Chrome 分支为例tag_and_push_browser_images.shCHROME_VERSION$(docker run --platform ${PLATFORM} --rm ${NAMESPACE}/node-chrome:${TAG_VERSION} google-chrome --version | awk {print $3}) CHROMEDRIVER_VERSION$(docker run --platform ${PLATFORM} --rm ${NAMESPACE}/node-chrome:${TAG_VERSION} chromedriver --version | awk {print $2})即先以4.35.0-20250909构建node-chrome再通过docker run在其中执行google-chrome --version与chromedriver --version用awk提取版本号Chrome 取第 3 个字段ChromeDriver 取第 2 个字段最后拼出标签矩阵。--platform参数支持linux/amd64之外的架构探测脚本第 7 个参数PLATFORM默认linux/amd64。四、脚本参数与发布模式普通发布 vs 旧版本再发布tag_and_push_browser_images.sh 定义了完整的参数序列VERSION$1 # Grid 版本如 4.35.0 BUILD_DATE$2 # 构建日期如 20250909 NAMESPACE$3 # 镜像命名空间默认 selenium PUSH_IMAGE$4 # 是否 docker push默认 false BROWSER$5 # chrome / chromium / edge / firefox / chrome-for-testing RELEASE_OLD_VERSION$6 # 是否发布旧浏览器版本默认 false PLATFORM$7 # 目标平台默认 linux/amd64关联文档中的命令./tag_and_push_browser_images.sh 4.35.0 20250909 selenium false chrome true对应Grid 4.35.0、构建日期 20250909、命名空间 selenium、不打 push、浏览器 chrome、发布旧版本RELEASE_OLD_VERSIONtrue。新旧发布模式的关键差异脚本内部tag_and_push_browser_images.sh先固定生成 6 个带构建日期的标签full-chromedriver-full-driver-grid-grid-datefull-chromedriver-full-driver-datefull-dateshort-chromedriver-short-driver-grid-grid-dateshort-chromedriver-short-driver-dateshort-date当RELEASE_OLD_VERSIONfalse即发布当前最新浏览器版本时额外追加 4 个不带日期的通用标签tag_and_push_browser_images.shfull-chromedriver-full-driverfullshort-chromedriver-short-drivershort这两组标签的设计意图非常清晰不带日期的标签如112.0、112.0.5615.165是浮动指针始终指向最新一次发布该浏览器版本的 Grid 镜像。如果旧版本再发布也覆盖它们会导致旧 Grid 的镜像抢占最新标签破坏用户的预期。带日期的标签是快照永久保留保证历史上任意时刻的发布都可追溯、可复现。这也解释了为何发布记录中 Chrome 112 只有 12 行6 标签 × node/standalone 两个镜像——因为RELEASE_OLD_VERSIONtrue脚本跳过了那 4 个通用标签避免旧浏览器覆盖最新浮动标签。retag 的两种实现路径retag()函数tag_and_push_browser_images.sh负责真正的打标签与推送常规路径docker tag本地镜像后若PUSH_IMAGEtrue再docker push第 4 个参数控制。镜像提升路径当环境变量PROMOTE_TAGStrue由发布流水线设置时不再本地重建而是用docker buildx imagetools create直接在 registry 之间创建 manifest 标签。注释解释了原因docker tag只能操作本地镜像docker pull又只能拉取运行方架构的单架构镜像会导致浏览器标签变成单架构而imagetools直接操作 multi-arch index保证与 release 标签一致。PROMOTE_GHCR_NAMESPACE存在时还会在同一调用中同步镜像到 GHCR 命名空间。在 Makefile 中该脚本被封装为make tag_and_push_browser_images聚合 chrome、chrome-for-testing、chromium、edge、firefox 五个目标与make tag_and_push_browser_images_ghcr通过docker buildx imagetools create把 docker.io 上的标签镜像到GHCR_NAMESPACE默认ghcr.io/seleniumhq。五、Chrome 112 镜像背后的安装实现版本如何被装进容器标签体系能成立前提是镜像构建时真的装上了指定版本的 Chrome 与 ChromeDriver。这一层的实现分别在两个脚本中。Chrome 安装install-chrome.sh脚本通过 Google 官方 apt 仓库安装install-chrome.sh按渠道安装CHROME_VERSION默认google-chrome-stable也支持beta、unstable渠道。按精确版本安装当值形如google-chrome-stable121.0.6167.120-1时脚本从归档源下载对应.deb包并用apt-get install --allow-downgrades实现版本锁定与降级。装完最后执行google-chrome --version校验版本。这与标签发布脚本中运行容器探测版本形成了闭环构建时装什么版本发布时探测什么版本标签上就写什么版本。ChromeDriver 安装install-chromedriver.sh驱动安装脚本的版本解析逻辑与 Chrome 112 这个特定版本高度相关install-chromedriver.shChrome 115 之前是legacy时代Chrome for TestingCfT项目在 Chrome 115 之后才成为主渠道。对于主版本号小于 115 的 Chrome112 正是如此脚本走冻结的chromedriver.storage.googleapis.comAPI先请求LATEST_RELEASE_112拿到该主版本的最新驱动号再下载chromedriver_linux64.zip。115 及之后amd64 从 Chrome for Testing 官方存储桶下载其他架构Google 不发布 Linux/ARM64 的 ChromeDriver则回退到基于相同 Chromium 源码构建的 Debianchromium-driver包并按需安装额外共享库libdouble-conversion3、libminizip1t64甚至升级libc6。安装完成后统一创建/opt/selenium/chromedriver-version并软链到/usr/bin/chromedriver确保容器内chromedriver --version可被发布脚本直接探测。六、如何实际使用这些固定版本标签掌握了标签语义用法就非常直接。官方 node-chrome 文档 给出了完整的三步流程。场景一Grid 分布式Hub Node# 1. 创建网络 docker network create grid # 2. 启动 Hub端口 4442-4444 docker run -d -p 4442-4444:4442-4444 --net grid --name selenium-hub selenium/hub:latest # 3. 启动固定版本的 Chrome 节点 docker run -d --net grid -e SE_EVENT_BUS_HOSTselenium-hub \ --shm-size2g \ selenium/node-chrome:112.0.5615.165-chromedriver-112.0.5615.49-grid-4.35.0-20250909Windows PowerShell 用户使用反引号续行docker run -d --net grid -e SE_EVENT_BUS_HOSTselenium-hub --shm-size2g selenium/node-chrome:112.0.5615.165-chromedriver-112.0.5615.49-grid-4.35.0-20250909场景二Standalone 单机一体standalone-chrome 文档 展示了免 Hub 的最简形态docker run -d -p 4444:4444 -p 7900:7900 --shm-size2g \ selenium/standalone-chrome:112.0-20250909两个场景的共同要点--shm-size2g必须保留包含浏览器的镜像需要宿主机共享内存否则浏览器进程容易崩溃。启动后将 WebDriver 测试指向http://localhost:4444即可。可选访问http://localhost:7900/?autoconnect1resizescalepasswordsecret通过 noVNC 实时观察容器内的浏览器运行画面默认密码secret对应 NodeBase/selenium.conf 中的 VNC 配置。用完后清理docker network rm grid。标签选择建议可复现性优先使用完整标签含grid-与日期如112.0.5615.165-chromedriver-112.0.5615.49-grid-4.35.0-20250909CI 中每个维度都确定。简写优先需要某个浏览器主版本的最新发布时用短版本如112.0但要理解这类浮动标签会被后续新 Grid 版本的发布更新。谨慎对待latest官方文档明确建议使用完整标签来固定浏览器与 Grid 版本而非latest因为latest跟随最新发布浏览器与 Grid 的组合会随时间漂移。七、结论与延伸阅读docker-selenium 通过Grid 版本 × 浏览器版本 × 镜像形态 × 标签粒度的多维矩阵在跟随最新与锁定旧版本之间提供了完整的操作弹性发布脚本自动探测版本并生成从112.0到全量信息的标签族旧版本发布时以RELEASE_OLD_VERSIONtrue只追加带日期的快照标签从而保护浮动标签不被历史版本覆盖CHANGELOG/README.md 矩阵则将这些记录组织成可检索的索引本文所分析的 4.35.0 版 Chrome 112 记录 即是其中一格。若想进一步深入推荐按以下顺序阅读仓库内相关文件发布脚本全貌tag_and_push_browser_images.sh含 chrome/chromium/edge/firefox/chrome-for-testing 五个分支的完整标签矩阵逻辑构建入口NodeChrome/Dockerfile 与 Standalone/Dockerfile版本安装细节NodeChrome/install-chrome.sh、NodeChrome/install-chromedriver.sh标签约定文档docs/docker-hub/node-chrome.md、docs/docker-hub/standalone-chrome.md版本矩阵索引CHANGELOG/README.md赞分享测试后端云原生容器编排可观测性【免费下载链接】docker-seleniumProvides a simple way to run Selenium Grid with Chrome, Firefox, and Edge using Container Platform, making it easier to perform browser automation at scale项目地址https://gitcode.com/GitHub_Trending/do/docker-selenium点击查看免费下载相关推荐docker-selenium 浏览器镜像标签矩阵解读以 Selenium Grid 4.29.0 Chrome 108 发布记录为例docker selenium 浏览器镜像标签矩阵解读以 Selenium Grid 4.29.0 Chrome 108 发布记录为例 导读 本文基于 d测试后端云原生容器编排可观测性docker-selenium 浏览器镜像版本标签矩阵解析以 Selenium Grid 4.31.0 Chrome 108 归档记录为例docker selenium 浏览器镜像版本标签矩阵解析以 Selenium Grid 4.31.0 Chrome 108 归档记录为例 导读本文以测试后端云原生容器编排可观测性FastStream 应用与应用访问日志指南从 Context 日志到 Structlog 结构化日志FastStream 应用与应用访问日志指南从 Context 日志到 Structlog 结构化日志 导读 FastStream 作为面向 Kafka、Ra测试后端云原生容器编排可观测性上一篇Sunshine串流全攻略把书房里的游戏PC变成全屋共享的云主机下一篇0基础玩转Sunshine把游戏画面搬到任意屏幕的免费串流服务器指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考