轩辕镜像 官方专业版
轩辕镜像
专业版
轩辕镜像 官方专业版
轩辕镜像
专业版
首页个人中心搜索镜像
交易
充值流量¥7起我的订单
文档
工具
提交工单页面收录
python

kgrv/python

kgrv

一个包含init、user和mimalloc的最小化Python镜像。

下载次数: 0状态：社区镜像维护者：kgrv仓库类型：镜像最近更新：6 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

中文简介
标签列表
镜像标签列表与下载命令
轩辕镜像，快一点，稳很多。
点击查看

kgrv/python 镜像文档

镜像概述和主要用途

kgrv/python是一个最小化的Python镜像，集成了init、user和mimalloc功能。推荐用于开发环境，以替代官方的python:alpine镜像，从而缓解musl库带来的性能问题。

支持的标签

[!提示] 推荐 使用 https://hub.docker.com/r/kgrv/python/tags?name=latest 进行开发，而非官方的 https://hub.docker.com/_/python，以缓解 musl 性能问题。

3.14.5, 3.14, 3, latest

  • https://hub.docker.com/r/kgrv/python/tags?name=3.14.5
  • https://hub.docker.com/r/kgrv/python/tags?name=3.14.5-min
  • https://hub.docker.com/r/kgrv/python/tags?name=3.14.5-bin

3.13.13, 3.13

  • https://hub.docker.com/r/kgrv/python/tags?name=3.13.13
  • https://hub.docker.com/r/kgrv/python/tags?name=3.13.13-min
  • https://hub.docker.com/r/kgrv/python/tags?name=3.13.13-bin

3.12.13, 3.12

  • https://hub.docker.com/r/kgrv/python/tags?name=3.12.13
  • https://hub.docker.com/r/kgrv/python/tags?name=3.12.13-min
  • https://hub.docker.com/r/kgrv/python/tags?name=3.12.13-bin

3.11.15, 3.11

  • https://hub.docker.com/r/kgrv/python/tags?name=3.11.15
  • https://hub.docker.com/r/kgrv/python/tags?name=3.11.15-min
  • https://hub.docker.com/r/kgrv/python/tags?name=3.11.15-bin

3.10.20, 3.10

  • https://hub.docker.com/r/kgrv/python/tags?name=3.10.20
  • https://hub.docker.com/r/kgrv/python/tags?name=3.10.20-min
  • https://hub.docker.com/r/kgrv/python/tags?name=3.10.20-bin

镜像层信息

标签AMD64ARM64描述
bin9.53 MB9.81 MB最小镜像，不含内置软件包
min37.70 MB40.40 MB基于bin层，包含内置软件包
3.x.y47.40 MB50.70 MB基于 https://hub.docker.com/r/kgrv/alpine，可作为 https://hub.docker.com/_/python 的替代镜像

3.14.3 - 2026-02-09

支持的架构

OS/ARCH描述
linux/amd64适用于Linux操作系统的64位x86架构
linux/arm64适用于Linux操作系统的64位ARM架构

参数说明

类型容器路径可用性功能
卷/mnt>= bin可选 绑定挂载卷
环境变量EUID>= 3.x可选 有效用户ID
环境变量EGID>= 3.x可选 有效组ID
环境变量UMASK>= 3.x可选 默认权限
环境变量SUGGEST>= 3.x可选 设置建议消息
环境变量TZ>= 3.x可选 设置时区

概述

用户/组ID

  • 通过EUID/EGID环境变量设置
  • 默认用户/组为mini:mini

权限掩码

  • UMASK默认值为0022

建议提示

  • SUGGEST默认值为true

使用方法

Dockerfile

基础用法

Dockerfile
FROM kgrv/python:min

Init配置

  • 使用CMD而不覆盖ENTRYPOINT以利用tini
Dockerfile
FROM kgrv/python:min AS staging
...
CMD [ "python", "--version" ]
  • 用"tini", "--"覆盖ENTRYPOINT
Dockerfile
FROM kgrv/python:min AS staging
...
ENTRYPOINT [ "tini", "--", "python" ]
CMD [ "--version" ]

最小权限原则

  • 适用于3.x版本：用"tini", "--", "enpt"覆盖ENTRYPOINT
Dockerfile
FROM kgrv/python:3.14 AS develop
...
ENTRYPOINT [ "tini", "--", "enpt", "python" ]
  • 适用于bin、min版本：在ENTRYPOINT前添加USER
Dockerfile
FROM kgrv/python:min AS staging
...
USER mini
ENTRYPOINT [ "tini", "--", "python" ]

安装Python包

  • 内置pipy脚本简化安装过程
    用于简化Python包安装的脚本。

    用法: pipy [选项] [PIP_INSTALL参数]

    示例:
        pipy --requirement requirements.txt
        pipy -n -m --requirement requirements.txt

    选项:
        -w, --workspace PATH        工作区路径 [/tmp/pipy]
        -n, --no-bytecode           禁用Python字节码
        -m, --remove-pycache        删除Python缓存
        -d, --debug                 启用调试模式
        --version                   显示版本
        --help                      显示使用信息

    环境变量:
        设置环境变量对应选项

        PIPY_WORKSPACE          [-w] 工作区路径
        PYTHONDONTWRITEBYTECODE [-n] 禁用Python字节码
        REMOVE_PYCACHE          [-m] 删除Python缓存

    查看 'README.md'：https://hub.docker.com/r/kgrv/python

完整示例

  • 使用3.x进行开发和构建依赖
  • 使用min或bin作为分发基础镜像
Dockerfile
FROM kgrv/python:3.14 AS deps
COPY requirements.txt .
RUN pipy --no-bytecode --remove-pycache --requirement requirements.txt --debug

FROM kgrv/python:3.14-min AS release
COPY --link src/ .
COPY --link --from=deps --chmod=555 --chown=root:root /tmp/pipy/bin/ /usr/local/bin/
COPY --link --from=deps --chmod=1777 --chown=root:root /usr/local/lib/python/site-packages /usr/local/lib/python/site-packages
USER mini
ENTRYPOINT [ "tini", "--", "python", "run.py" ]
CMD [ "--debug" ]

时区设置

  • 使用3.x层，包含/usr/share/zoneinfo
Dockerfile
FROM kgrv/python:3.14 AS develop
  • 挂载系统/etc/localtime或/usr/share/zoneinfo
bash
docker run -it -v /etc/localtime:/etc/localtime:ro kgrv/python:3.14

bash
docker run -it -v /usr/share/zoneinfo/US/Eastern:/etc/localtime:ro kgrv/python:3.14

Docker CLI

基本用法

bash
docker run -it kgrv/python:min

带绑定挂载启动容器

bash
docker run -it -v $(pwd):/mnt kgrv/python:min

带UID/GID启动容器

[!重要] 不支持--user参数，请使用EUID/EGID。

[!注意] 仅适用于3.x版本。

bash
docker run -it -e EUID=$(id -u) -e EGID=$(id -g) kgrv/python:3.14

以ROOT身份启动容器

[!注意] 仅适用于3.x版本。

bash
docker run -it kgrv/python:3.14 --BECOME_ROOT

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 python 镜像标签

docker pull docker.xuanyuan.run/kgrv/python:<标签>

使用方法：

  • 登录认证方式
  • 免认证方式

DockerHub 原生拉取命令

docker pull kgrv/python:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

一键安装

一键安装 Docker

Linux Docker 一键安装

需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单

镜像拉取常见问题

功能

免费版与专业版区别

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

登录 · 专属域名 · 配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

用户头像

oldzhang

运维工程师

Linux服务器

5

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

轩辕镜像
镜像详情
...
kgrv/python
教程轩辕镜像功能与使用教程
定价查看流量套餐与价格
热门查看热门 Docker 镜像推荐
博客Docker 镜像公告与技术博客
专业版 · 高速稳定拉取镜像

高速镜像下载 · 在线技术支持 · 99.95% SLA 保障

50GB 仅 ¥7/年
专业版 · 高速稳定拉取镜像
50GB 仅 ¥7/年
高速镜像下载·在线技术支持·99.95% SLA 保障
商务合作：点击复制邮箱
用户协议·隐私政策·©2024-2026 源码跳动
用户协议·隐私政策©2024-2026 杭州源码跳动科技有限公司商务合作：点击复制邮箱

更多 python 镜像推荐

python logo

library/python

Docker 官方镜像
Python是一种解释型、交互式、面向对象的开源编程语言，其设计理念强调代码的可读性与简洁性，支持多种编程范式，凭借丰富的标准库和第三方库，广泛应用于Web开发、数据分析、人工智能、科学计算、自动化脚本等众多领域，拥有活跃的全球开发者社区，是兼具易用性与强大功能的高效编程工具。
1万 次收藏10亿+ 次下载
16 天前更新
circleci/python logo

circleci/python

circleci
CircleCI提供的Python扩展镜像，基于官方Python镜像，预装开发和CI常用工具（如git、ssh、docker等），默认使用非root用户，支持浏览器测试等变体，适用于CI/CD流程和开发环境。
116 次收藏1亿+ 次下载
4 年前更新
cimg/python logo

cimg/python

cimg
CircleCI提供的`cimg/python`是专为持续集成构建设计的Docker镜像，包含完整Python版本（通过pyenv），预装pip、pipenv和poetry，适用于CircleCI环境，旨在取代旧版`circleci/python`镜像。
25 次收藏1亿+ 次下载
23 天前更新
demisto/python logo

demisto/python

demisto
基于python:2.7的Demisto基础Python镜像，包含requests、olefile、pip和stix等基本Python库，适用于构建依赖这些特定库的Python 2.7应用环境。
5 次收藏100万+ 次下载
6 个月前更新
ubuntu/python logo

ubuntu/python

Ubuntu 官方镜像
这是一个基于Ubuntu系统精雕细琢而成的运行基石，集成了Python运行时环境，通过精简优化的系统底层确保了高效稳定的性能，为Python应用程序提供了可靠的运行载体，无论是开发调试、测试验证还是生产部署场景，都能满足轻量、安全且高效的运行需求，是构建Python应用生态的理想基础组件。
33 次收藏10万+ 次下载
15 天前更新
okteto/python logo

okteto/python

okteto
该镜像包含用于与Okteto CLI配合使用的Python开发环境，Okteto是面向开发者的Kubernetes工具。
10万+ 次下载
3 个月前更新

查看更多 python 相关镜像

更多相关 Docker 镜像与资源

以下是 kgrv/python 相关的常用 Docker 镜像，适用于 Web 开发、数据科学、机器学习 等不同场景：

  • library/python Docker 镜像说明（Python 运行时，适合数据科学和 Web 开发）
  • demisto/python Docker 镜像说明（Python 运行时，Demisto 安全自动化平台）
  • chainguard/python Docker 镜像说明（Python 运行时，Chainguard 安全加固版本）
  • intel/python Docker 镜像说明（Python 运行时，Intel 优化版本，适合高性能计算）
  • cimg/python Docker 镜像说明（Python 运行时，CI/CD 优化版本）