CircleCI Python镜像是对官方Python镜像的扩展,旨在满足开发和CI(持续集成)环境的特定需求。它解决了官方镜像在CI/CD场景中缺乏必要工具的问题,提供了更适合自动化构建、测试和部署的环境。
该镜像通过以下方式扩展官方Python镜像:
git、ssh、tar、ca-certificates、curl、wget等常用工具,满足日常开发和CI流程需求。docker、docker-compose和dockerize,支持容器化环境中的构建和部署操作。circleci用户作为默认用户,避免部分应用(如Chrome)拒绝以root运行或行为异常(如tar文件所有权问题)。python:<version>默认镜像,包含核心工具和功能,适合大多数开发和CI场景。如果不确定需求,建议使用此变体。
python:<version>-browsers扩展默认镜像,预装Firefox和Chrome/chromedriver,并配置为可在容器环境中运行,简化浏览器测试流程。
注意:由于Docker Hub限制,https://hub.docker.com/r/circleci/python/tags%E5%8F%AF%E8%83%BD%E6%9C%AA%E6%98%BE%E7%A4%BA%E6%89%80%E6%9C%89%E5%8F%98%E4%BD%93%E3%80%82%E5%AE%8C%E6%95%B4%E5%8F%98%E4%BD%93%E5%88%97%E8%A1%A8%E5%8F%8ADockerfiles%E8%AF%B7%E5%8F%82%E8%A7%81https://github.com/CircleCI-Public/circleci-dockerfiles/tree/master/python/images%E3%80%82
bashdocker run -it --rm circleci/python:3.9
bashdocker run -it --rm circleci/python:3.9-browsers python -c "from selenium import webdriver; driver = webdriver.Chrome(); driver.get('https://example.com'); print(driver.title); driver.quit()"
如遇到镜像相关问题或有疑问,请通过CircleCI Discuss Forum联系我们。
以下是 circleci/python 相关的常用 Docker 镜像,适用于 Web 开发、数据科学、机器学习 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务