5分钟快速上手 docker-python-chromedriver:运行你的第一个 Headless Chrome 测试 📅 发布时间:2026/8/21 16:26:29 👁 浏览次数: 5分钟快速上手 docker-python-chromedriver运行你的第一个 Headless Chrome 测试【免费下载链接】docker-python-chromedriverDockerfile for running Python Selenium in headless Chrome (Python 2.7 / 3.6 / 3.7 / 3.8 / Alpine based Python / Chromedriver / Selenium / Xvfb included in different versions)项目地址: https://gitcode.com/gh_mirrors/do/docker-python-chromedriverdocker-python-chromedriver 是一个开源的 Docker 镜像方案它将 Python、Google Chrome、Chromedriver 与 Selenium 打包进同一个容器让你能一键搭建起 Headless Chrome 自动化测试环境。本教程面向零基础新手带你用 5 分钟完成环境搭建并成功运行你的第一个 Selenium 无头浏览器测试——全程只需要一台装有 Docker 的电脑。 还在为装 Chrome、配驱动、搭环境焦头烂额这篇 docker-python-chromedriver 使用教程帮你一次搞定。什么是 docker-python-chromedriver为什么值得用简单说这是一个开箱即用的自动化测试环境。传统搭建 Selenium 测试环境你需要安装 Python 解释器 ✅下载对应版本的 Google Chrome ✅下载并配置 Chromedriver ✅处理驱动与浏览器版本不匹配的坑 而使用 docker-python-chromedriver以上步骤全部由镜像完成。你只需一条docker run命令就能进入一个预装好一切的测试环境。核心优势一目了然痛点传统方案docker-python-chromedriver环境搭建手动装 3~4 个组件耗时 1 小时一条命令秒级进入版本兼容驱动和浏览器版本常打架镜像内已配好团队协作我这边跑得好好的人人环境一致资源占用常驻本机用完即弃零污染环境准备5 分钟上手只需两个前提开始之前请确认本机已安装 DockerWindows / macOS / Linux 均可会打开终端执行命令复制粘贴即可无需任何编程基础提示Docker 镜像仅支持 amd64x86-64架构Apple M1 等 arm64 机器需注意兼容性详见文末常见问题。最快上手方法四步运行你的第一个 Headless Chrome 测试第一步克隆项目仓库在终端执行git clone https://gitcode.com/gh_mirrors/do/docker-python-chromedriver cd docker-python-chromedriver第二步启动容器环境项目使用挂载方式让容器内的/usr/workspace直接映射到你当前目录docker run -it -w /usr/workspace -v $(pwd):/usr/workspace joyzoursky/python-chromedriver:latest bash命令解析新手必看-it进入交互式终端-w /usr/workspace容器内工作目录-v $(pwd):/usr/workspace把本机目录挂载进容器代码互通第三步安装 Selenium 依赖latest基础镜像未预装 Selenium进入容器后执行pip install selenium 想省掉这一步直接选用带-selenium后缀的镜像即可后面会讲版本选择。第四步运行测试脚本项目自带一个可运行的 Selenium 示例脚本 test_script.py它会启动 Headless Chrome打开页面并自动点击页面上的按钮python test_script.py看到类似输出就代表大功告成 test_case_1 (__main__.TestTemplate) Find and click top-left logo button ... ok test_case_2 (__main__.TestTemplate) Find and click top-right Start your project button ... ok ---------------------------------------------------------------------- Ran 2 tests in 11.852s OK从克隆到跑通第一个测试全程真的只要 5 分钟深入了解镜像里到底装了什么以 Debian 版 Dockerfile.template 为例镜像构建核心就三步安装 Google Chrome添加官方源并安装google-chrome-stable安装 Chromedriver自动拉取最新版驱动并解压到/usr/local/bin/设置显示端口通过ENV DISPLAY:99避免无头模式下崩溃完整镜像包含以下组件组件说明 PythonDebian 或 Alpine 基础镜像 Google Chrome稳定版浏览器 Chromedriver与 Chrome 匹配的驱动 Selenium部分版本已预装️ Xvfb部分版本提供虚拟显示版本选择指南Debian 版、Alpine 版怎么选项目提供两大系列镜像覆盖 Python 2.7 / 3.6 / 3.7 / 3.8 / 3.9 / 3.10 / 3.11Debian 版体积较大兼容性最好latest3.9、3.9、3.8、3.7、3.6等适合对兼容性要求高、不在乎镜像体积的场景对应 Dockerfile 见 py-debian/3.9/DockerfileAlpine 版轻量精简启动更快3.9-alpine、3.8-alpine、3.7-alpine、3.6-alpine等镜像体积更小适合 CI/CD 流水线注意进入容器用sh而非bash对应 Dockerfile 见 py-alpine/3.9-alpine/Dockerfile快速决策表需求推荐版本想省事开箱即用3.9-selenium已预装 Selenium追求镜像体积小3.9-alpine-selenium需要虚拟显示跑可视化测试3.6-xvfb-selenium已弃用但可参考兼容老项目2.7系列已弃用谨慎选择对应运行命令示例# Alpine 系列用 sh 进入 docker run -it -w /usr/workspace -v $(pwd):/usr/workspace joyzoursky/python-chromedriver:3.9-alpine-selenium sh进阶玩法如何生成自己的自定义镜像版本项目支持通过模板批量生成多版本 Dockerfile这也是其设计亮点之一进入 py-debian/ 或 py-alpine/ 目录修改 Dockerfile.template 或 Dockerfile-selenium.template运行bash render.sh自动为所有 Python 版本生成对应 Dockerfile这样你就能在官方镜像基础上添加自定义依赖打造团队专属的 Selenium 测试环境。常见问题与注意事项1. Apple M1 芯片能跑吗目前镜像仅支持 amd64 架构arm64 机器如 M1存在兼容性问题建议使用 x86-64 服务器或在 Rosetta 模拟下尝试。2. 测试脚本里为什么要加这些参数test_script.py 中配置了--headless无头模式、--no-sandbox容器内运行必需、--disable-gpu避免 GPU 报错、--window-size1920,1080固定视口尺寸这些是容器内跑 Chrome 的黄金组合。3. 如何把测试代码放进容器把代码放到docker run时的挂载目录即可容器内外文件实时同步无需重新构建镜像。4. 想了解项目更多版本完整版本清单见项目根目录的 README.md所有 Dockerfile 都在 py-debian/、py-alpine/ 与 deprecated/ 目录下。现在你已经掌握了 docker-python-chromedriver 的核心用法。从克隆仓库到跑通第一个 Headless Chrome 测试全程不超过 5 分钟。接下来你只需要把test_script.py替换成自己的业务测试用例就能在 Docker 里轻松运行 Selenium 自动化测试了。快去试试吧【免费下载链接】docker-python-chromedriverDockerfile for running Python Selenium in headless Chrome (Python 2.7 / 3.6 / 3.7 / 3.8 / Alpine based Python / Chromedriver / Selenium / Xvfb included in different versions)项目地址: https://gitcode.com/gh_mirrors/do/docker-python-chromedriver创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考