Python 是一门应用广泛的语言，常见于数据分析、AI、Web 开发等场景。通过 Docker 部署 Python，可以做到快速安装、环境隔离、跨平台运行。下面我们来完整演示 Python 在 Docker 中的部署方法。
1、查看 Python 镜像详情你可以在 轩辕镜像 中找到 Python 镜像页面：
👉 https://xuanyuan.cloud/r/library/python
在镜像页面中，会看到多种拉取方式，下面我们逐一说明。
2、下载 Python 镜像 2.1 使用轩辕镜像拉取 docker pull docker.xuanyuan.run/library/python:3.12 2.2 拉取后改名 docker pull docker.xuanyuan.run/library/python:3.12 \ && docker tag docker.xuanyuan.run/library/python:3.12 python:3.12 \ && docker rmi docker.xuanyuan.run/library/python:3.12这样后续就可以直接用官方标准名 python:3.12。
2.3 使用免登录方式拉取（推荐） docker pull xxx.xuanyuan.run/library/python:3.12带重命名的完整命令：
docker pull xxx.xuanyuan.run/library/python:3.12 \ && docker tag xxx.xuanyuan.run/library/python:3.12 python:3.12 \ && docker rmi xxx.xuanyuan.run/library/python:3.12 2.4 官方直连方式如果网络能直连 Docker Hub，可以直接：
docker pull python:3.12 2.5 查看是否拉取成功 docker images输出类似：
REPOSITORY TAG IMAGE ID CREATED SIZE python 3.12 9a2c9eabc123 2 weeks ago 1.02GB 3、部署 Python 容器下面演示三种方式：快速部署 → 挂载项目 → docker-compose 管理。
3.1 快速部署（最简方式）适合测试、运行交互式 Python 环境：
docker run -it --name py-test python:3.12说明：
-it：进入交互式终端
--name py-test：容器名称
python:3.12：使用 Python 3.12 镜像
进入后会看到 Python REPL：
Python 3.12.5 (main, Sep 14 2024, 10:15:00) >>> print("Hello from Xuanyuan Python!") Hello from Xuanyuan Python!退出：输入 exit() 或 Ctrl+D。
3.2 挂载本地项目（推荐方式）适合实际项目开发，将宿主机代码挂载到容器内。
第一步：准备目录
mkdir -p /data/python-app cd /data/python-app第二步：写一个测试程序
echo 'print("Hello from Xuanyuan Python App!")' > app.py第三步：启动容器并挂载目录
docker run -it --name py-app \ -v /data/python-app:/app \ -w /app \ python:3.12 python app.py说明：
-v /data/python-app:/app：挂载宿主机目录到容器
-w /app：指定容器内工作目录
python app.py：执行程序
输出应为：
Hello from Xuanyuan Python App! 3.3 使用 docker-compose 部署（适合企业级项目）第一步：创建项目目录
mkdir -p /data/py-compose cd /data/py-compose第二步：准备应用
写一个 main.py：
第三步：编写 docker-compose.yml
version: '3' services: python-app: image: python:3.12 container_name: python-service working_dir: /app volumes: - ./app:/app command: python main.py restart: always目录结构：
/data/py-compose ├─ docker-compose.yml └─ app └─ main.py第四步：启动服务
docker compose up -d查看状态
docker compose ps查看日志
docker compose logs -f输出：
python-service | Python running in Docker with docker-compose! 4、进阶实践 4.1 安装第三方库运行交互式容器，使用 pip 安装：
docker run -it --name py-pandas python:3.12 bash pip install pandas或者在项目目录添加 requirements.txt：
flask requests然后容器启动时自动安装：
docker run -it -v /data/python-app:/app -w /app python:3.12 pip install -r requirements.txt 4.2 构建自定义 Python 镜像在项目中写一个 Dockerfile：
FROM python:3.12 WORKDIR /app COPY requirements.txt . RUN pip install -r requirements.txt COPY . . CMD ["python", "app.py"]构建镜像：
docker build -t my-python-app .运行：
docker run -it --name py-custom my-python-app 5、常见问题 5.1 进入容器后 Python 环境丢失？默认进入是 /bin/bash，需要手动执行 python。也可以直接：
docker exec -it py-app python 5.2 如何持久化依赖环境？使用 requirements.txt + pip install
或者构建自定义镜像（见上文 4.2）
5.3 容器内时区不对？加 -e TZ=Asia/Shanghai：
docker run -it -e TZ=Asia/Shanghai python:3.12 5.4 如何运行 Flask / Django Web 项目？以 Flask 为例，在 app.py：
from flask import Flask app = Flask(__name__) @app.route("/") def hello(): return "Hello Flask from Docker!" if __name__ == "__main__": app.run(host="0.0.0.0", port=5000)运行容器：
docker run -d --name py-flask -p 5000:5000 \ -v /data/python-app:/app -w /app \ python:3.12 pip install flask && python app.py访问 服务器IP:5000 即可。
结尾至此，你已经掌握了 Python 在 Docker 中的部署全流程：
拉取镜像（轩辕镜像 / 官方）
快速运行 Python 环境
挂载项目目录运行代码
使用 docker-compose 管理服务
构建自定义镜像和运行 Web 应用
对于初学者，可以先尝试「快速部署」和「挂载目录」；对于工程师，推荐使用「docker-compose」或「自定义镜像」来管理依赖和部署。
👉 在实践中遇到问题，可以通过 docker logs 容器名 查看日志，或参考 Python 官方文档。
