joyzoursky/python-chromedriver

docker-python-chromedriver

镜像概述和主要用途

docker-python-chromedriver是一个集成了Python、Google Chrome、Chromedriver的Docker镜像，旨在提供便捷的自动化测试环境。该镜像支持多种Python版本，并基于Debian或Alpine系统构建，部分版本预安装了Selenium或Xvfb，适用于快速部署和运行浏览器自动化测试。

核心功能和特性

• 包含Python环境（基于Debian或Alpine系统）
• 内置Google Chrome浏览器
• 集成Chromedriver（与Chrome版本匹配）
• 部分版本预安装Selenium库
• 部分历史版本包含Xvfb（虚拟显示服务，已弃用）

快速试用

bash
$ git clone https://github.com/joyzoursky/docker-python-chromedriver.git
$ cd docker-python-chromedriver
$ docker run -it -w /usr/workspace -v $(pwd):/usr/workspace joyzoursky/python-chromedriver:latest bash
/usr/workspace# pip install selenium
/usr/workspace# python test_script.py

版本信息

Python 3（基于Debian）

• 3.9, latest（基于python:3.9，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-debian/3.9/Dockerfile%EF%BC%89
• 3.9-selenium（基于python:3.9，预安装Selenium，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-debian/3.9-selenium/Dockerfile%EF%BC%89
• 3.8（基于python:3.8，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-debian/3.8/Dockerfile%EF%BC%89
• 3.8-selenium（基于python:3.8，预安装Selenium，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-debian/3.8-selenium/Dockerfile%EF%BC%89
• 3.7（基于python:3.7，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-debian/3.7/Dockerfile%EF%BC%89
• 3.7-selenium（基于python:3.7，预安装Selenium，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-debian/3.7-selenium/Dockerfile%EF%BC%89
• 3.6（基于python:3.6，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-debian/3.6/Dockerfile%EF%BC%89
• 3.6-selenium（基于python:3.6，预安装Selenium，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-debian/3.6-selenium/Dockerfile%EF%BC%89

Python 3（基于Alpine）

• 3.9-alpine（基于python:3.9-alpine，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-alpine/3.8-alpine/Dockerfile%EF%BC%89
• 3.9-alpine-selenium（基于python:3.9-alpine，预安装Selenium，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-alpine/3.8-alpine-selenium/Dockerfile%EF%BC%89
• 3.8-alpine（基于python:3.8-alpine，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-alpine/3.8-alpine/Dockerfile%EF%BC%89
• 3.8-alpine-selenium（基于python:3.8-alpine，预安装Selenium，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-alpine/3.8-alpine-selenium/Dockerfile%EF%BC%89
• 3.7-alpine（基于python:3.7-alpine，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-alpine/3.7-alpine/Dockerfile%EF%BC%89
• 3.7-alpine-selenium（基于python:3.7-alpine3.8，预安装Selenium，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-alpine/3.7-alpine-selenium/Dockerfile%EF%BC%89
• 3.6-alpine（基于python:3.6-alpine，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-alpine/3.6-alpine/Dockerfile%EF%BC%89
• 3.6-alpine-selenium（基于python:3.6-alpine，预安装Selenium，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/py-alpine/3.6-alpin-selenium/Dockerfile%EF%BC%89

Python 2（已弃用）

• 2.7（基于python:2.7，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/deprecated/py2.7/Dockerfile%EF%BC%89
• 2.7-selenium（基于python:2.7，预安装Selenium，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/deprecated/py2.7-selenium/Dockerfile%EF%BC%89
• 2.7-alpine3.7（基于python:2.7-alpine3.7，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/deprecated/py2.7-alpine3.7/Dockerfile%EF%BC%89
• 2.7-alpine3.7-selenium（基于python:2.7-alpine3.7，预安装Selenium，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/deprecated/py2.7-alpine3.7-selenium/Dockerfile%EF%BC%89

带Xvfb的版本（已弃用）

• 3.6-xvfb（基于python:3.6，包含Xvfb，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/deprecated/py3.6-xvfb/Dockerfile%EF%BC%89
• 3.6-xvfb-selenium（基于python:3.6，包含Xvfb和Selenium，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/deprecated/py3.6-xvfb-selenium/Dockerfile%EF%BC%89
• 2.7-xvfb（基于python:2.7，包含Xvfb，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/deprecated/py2.7-xvfb/Dockerfile%EF%BC%89
• 2.7-xvfb-selenium（基于python:2.7，包含Xvfb和Selenium，https://github.com/joyzoursky/docker-python-chromedriver/blob/master/deprecated/py2.7-xvfb-selenium/Dockerfile%EF%BC%89

使用方法

基于Debian的镜像

适用于以下镜像： latest、3.9、3.9-selenium、3.8、3.8-selenium、3.7、3.7-selenium、3.6、3.6-selenium、3.6-xvfb、3.6-xvfb-selenium、2.7、2.7-selenium、2.7-xvfb、2.7-xvfb-selenium

在终端执行：

bash
$ cd [你的工作目录]
$ docker run -it -w /usr/workspace -v $(pwd):/usr/workspace joyzoursky/python-chromedriver:[版本标签] bash

基于Alpine的镜像

适用于以下镜像： 3.9-alpine、3.9-alpine-selenium、3.8-alpine、3.8-alpine-selenium、3.7-alpine、3.7-alpine-selenium、3.6-alpine、3.6-alpine-selenium、2.7-alpine、2.7-alpine-selenium

在终端执行：

bash
$ cd [你的工作目录]
$ docker run -it -w /usr/workspace -v $(pwd):/usr/workspace joyzoursky/python-chromedriver:[版本标签] sh

上述命令将创建容器并映射当前工作目录到容器内的/usr/workspace，之后可在容器内执行测试命令。

在容器中运行Selenium测试的示例

可从https://github.com/joyzoursky/docker-python-chromedriver/blob/master/test_script.py%E4%B8%8B%E8%BD%BDSelenium%E6%B5%8B%E8%AF%95%E7%A4%BA%E4%BE%8B%E8%84%9A%E6%9C%AC%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B%E3%80%82

预安装Selenium的镜像

适用于：3.9-alpine-selenium、3.9-selenium、3.8-alpine-selenium、3.8-selenium、3.7-alpine-selenium、3.7-selenium、3.6-alpine-selenium、3.6-selenium、2.7-alpine-selenium、2.7-selenium

直接运行测试：

bash
# python test_script.py

未预安装Selenium的镜像

适用于：latest、3.9-alpine、3.9、3.8-alpine、3.8、3.7-alpine、3.7、3.6-alpine、3.6、2.7-alpine、2.7

先安装Selenium再运行测试：

bash
# pip install selenium
# python test_script.py

带Xvfb的镜像（已弃用）

适用于3.6-xvfb或2.7-xvfb：

bash
# pip install selenium
# xvfb-run --server-args="-screen 0 1024x768x24" python test_script.py

适用于3.6-xvfb-selenium或2.7-xvfb-selenium：

bash
# xvfb-run --server-args="-screen 0 1024x768x24" 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

贡献指南

如需修改现有Dockerfile，建议基于Dockerfile.template文件进行编辑，并通过运行render.sh生成不同版本的Dockerfile。

编辑和生成新Dockerfile的步骤

1. 进入目标目录（如py-debian）
2. 修改Dockerfile.template或Dockerfile-selenium.template
3. 执行bash render.sh生成新Dockerfile

注意：render.sh脚本适用于Mac OS；Windows或其他系统可能需要调整命令。

感谢您对本项目的改进贡献！