如何通过 Dockerfile 从零开始搭建 Python 运行环境

秋强姑娘_6271

秋强姑娘_6271

2026-09-12

345人浏览

原创

核心是选对基础镜像、理清文件复制顺序、正确安装依赖并明确启动方式;使用python:3.11-slim等官方镜像,先copy requirements.txt再run pip install,最后copy代码,以cmd["python","app.py"]启动。

如何通过 dockerfile 从零开始搭建 python 运行环境

直接用 Dockerfile 搭建 Python 运行环境,核心是选对基础镜像、理清文件复制顺序、正确安装依赖,并明确启动方式。不需要额外装 Python,官方镜像已预装好解释器。

选一个合适的 Python 基础镜像

优先使用 python:-slim(如 python:3.11-slim),它体积小、攻击面少,适合生产;开发调试可选 python:3.11(含 pip、dev 工具等)。避免用 buildpack-deps 或从源码编译,除非有特殊系统库需求。

  • slim 镜像基于 Debian,不含 gcc、curl 等构建工具,但足够运行大多数纯 Python 应用
  • 若需编译扩展(如某些 C 扩展包),加一句 RUN apt-get update && apt-get install -y build-essential
  • 国内用户建议在 RUN pip install 前加清华源: RUN pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

组织项目结构与编写 Dockerfile

确保项目根目录下有 requirements.txt 和主程序(如 app.py),然后创建 Dockerfile:

Docker Container Cleaner
Docker Container Cleaner

CLI工具,用于清理已停止的Docker容器、未使用的镜像、卷和网络,释放磁盘空间。

下载
  • FROM python:3.11-slim —— 拉取基础环境
  • WORKDIR /app —— 设定工作路径,所有后续操作在此目录进行
  • COPY requirements.txt . —— 先只复制依赖文件,利于利用 Docker 构建缓存
  • RUN pip install --no-cache-dir -r requirements.txt —— 安装依赖,--no-cache-dir 减小镜像体积
  • COPY . . —— 再复制全部代码(此时 pip 已装好,不会重复触发安装)
  • EXPOSE 5000 —— 声明应用监听端口(仅说明用途,不自动映射)
  • CMD ["python", "app.py"] —— 容器启动时执行的默认命令

构建并验证镜像

在项目目录下执行命令构建镜像:

  • docker build -t my-python-env . —— -t 指定镜像名,. 表示当前目录(Dockerfile 所在位置)
  • docker run --rm my-python-env python --version —— 快速验证 Python 版本是否符合预期
  • docker run --rm -v $(pwd):/app my-python-env pip list —— 挂载本地代码目录,查看已安装包列表

如果应用是 Web 服务(如 Flask),可加 -p 5000:5000 启动后访问 http://localhost:5000 测试连通性。

进阶建议:减小体积与提升安全性

基础环境跑通后,可进一步优化:

  • 用多阶段构建:第一阶段装依赖和构建工具,第二阶段只复制 /usr/local/lib/python*/site-packages 和代码,彻底剔除编译器
  • 非 root 用户运行:添加 RUN groupadd -g 1001 -f appuser && useradd -s /bin/bash -u 1001 -m appuserUSER appuser
  • 设及时区:加 RUN apt-get update && apt-get install -y tzdata && rm -rf /var/lib/apt/lists/*ENV TZ=Asia/Shanghai
  • 避免 COPY 整个目录:改用 .dockerignore 排除 __pycache__.gitvenv 等无关文件

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

docker python dockerfile

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1551

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

3644

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1569

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

20777

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2567

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2627

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1063

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

576

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2043

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpMyAdmin 安装文档
phpMyAdmin 安装文档

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

宝塔 Docker 模块使用手册
宝塔 Docker 模块使用手册

共0课时 | 0人学习