首页
/ 正文

Docker Dockerfile（保姆级教程）

更新时间: 2025-04-16 11:36:51

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;

《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前，星球内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习，欢迎点击围观

前言

在现代软件开发领域，容器化技术已成为构建、部署和运行应用的标准方案。Docker 作为容器技术的代表，通过标准化的环境隔离能力，解决了“在本地能运行，但部署到生产环境却出错”的经典问题。而 Dockerfile 则是 Docker 的核心配置文件，它如同软件开发的“施工蓝图”，指导 Docker 如何构建镜像。本文将从零开始，结合案例与代码示例，深入解析 Dockerfile 的语法、指令及其最佳实践，帮助开发者快速掌握这一工具的核心价值。

Docker 的基础概念与容器化优势

什么是 Docker？

Docker 是一个开源的容器化平台，它基于 Linux 的轻量级虚拟化技术（如 cgroups 和 namespace），允许开发者将应用及其依赖打包为独立的容器。容器与传统虚拟机不同，它共享宿主机的内核，因此启动速度快、资源占用低，且能实现环境一致性。

Dockerfile 的角色

Dockerfile 是 Docker 的配置文件，它通过一系列预定义指令，定义了如何从基础镜像逐步构建出新的镜像。想象一下，Dockerfile 就像一份详细的食谱：它规定了“食材”（基础镜像）、“烹饪步骤”（指令）以及“最终产出”（可运行的镜像）。开发者只需提交 Dockerfile，就能在不同环境中复现一致的运行环境。

Dockerfile 的基本结构与核心指令

Dockerfile 的基本结构

一个典型的 Dockerfile 包含以下元素：

基础镜像（FROM）：定义构建镜像的起点
环境配置（RUN、ENV 等）：安装依赖、设置变量等
文件操作（COPY、ADD）：将代码或资源拷贝到镜像中
元数据（LABEL）：添加描述信息
运行指令（CMD 或 ENTRYPOINT）：定义容器启动时执行的命令

示例 Dockerfile 结构

FROM python:3.9-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install -r requirements.txt

COPY . .

EXPOSE 8000

CMD ["python", "app.py"]

核心指令详解

以下是 Dockerfile 中最常用的指令及其作用：

1. `FROM`

作用：指定基础镜像，所有后续操作均基于此镜像展开。
示例：
```
FROM nginx:latest  
```
比喻：就像搭建房屋时选择地基材料，基础镜像决定了构建环境的起点。

2. `RUN`

作用：执行命令，用于安装软件、配置环境等。

示例：

RUN apt-get update && apt-get install -y curl

注意：每条 RUN 指令都会生成一个新镜像层，过多的指令会增加镜像体积，可通过 && 合并命令优化。

3. `COPY` 和 `ADD`

COPY：将本地文件或目录拷贝到镜像中，路径格式为 源路径目标路径。
```
COPY src/ /app/  
```
ADD：功能类似 COPY，但支持 URL 和解压压缩包。
建议：优先使用 COPY，因其行为更透明。

4. `WORKDIR`

作用：设置当前工作目录，后续指令（如 COPY、RUN）默认在此目录下执行。
```
WORKDIR /var/www  
```

5. `CMD` 和 `ENTRYPOINT`

CMD：定义容器启动时的默认命令，可被运行时参数覆盖。
```
CMD ["python", "app.py"]  
```
ENTRYPOINT：设置容器启动时的入口命令，与 CMD 结合使用时，CMD 参数会附加到 ENTRYPOINT 后。
```
ENTRYPOINT ["python"]  
CMD ["app.py"]  
```

6. `EXPOSE`

作用：声明容器运行时会监听的端口，但不会自动映射到宿主机。
```
EXPOSE 80  
```

7. `ENV`

作用：设置环境变量，可被后续指令或容器进程使用。
```
ENV PYTHONUNBUFFERED=1  
```

Dockerfile 的构建流程与最佳实践

构建流程详解

当执行 docker build 命令时，Docker 会按顺序解析 Dockerfile 的每条指令，生成对应的镜像层。例如：

从基础镜像 python:3.9-slim 开始；
运行 apt-get update 更新包列表；
拷贝 requirements.txt 并安装依赖；
将当前目录的代码拷贝到 /app；
最终生成可运行的镜像。

优化 Dockerfile 的关键技巧

1. 最小化基础镜像

选择轻量级的基础镜像（如 alpine）可减少镜像体积。例如：

FROM python:3.9-slim-buster

比 python:3.9 减少了约 50% 的体积。

2. 合并多条 RUN 指令

RUN apt-get update  
RUN apt-get install curl

RUN apt-get update && apt-get install -y curl && rm -rf /var/lib/apt/lists/*

3. 使用 .dockerignore 文件

通过 .dockerignore 排除不需要的文件（如 .git、node_modules），避免不必要的拷贝：

node_modules/
.git/
*.log

4. 缓存层的有效利用

Docker 的构建过程会尝试复用之前的镜像层。若 RUN apt-get update 后修改了后续指令，会导致后续所有层失效。因此，应将频繁变动的指令（如拷贝代码）放在 Dockerfile 的最后。

实战案例：构建一个 Python Web 应用

案例背景

我们将构建一个简单的 Flask 应用，并通过 Dockerfile 实现容器化部署。

1. 准备项目结构

project/  
├── app.py  
├── requirements.txt  
└── Dockerfile

2. 编写 app.py

from flask import Flask  
app = Flask(__name__)  

@app.route("/")  
def hello():  
    return "Hello from Dockerized Flask!"  

if __name__ == "__main__":  
    app.run(host="0.0.0.0", port=5000)

3. 编写 Dockerfile

FROM python:3.9-slim  

WORKDIR /app  

COPY requirements.txt .  
RUN pip install --no-cache-dir -r requirements.txt  

COPY . .  

EXPOSE 5000  

CMD ["python", "app.py"]

4. 编写 requirements.txt

flask==2.2.2

5. 构建并运行容器

docker build -t flask-demo .  

docker run -d -p 5000:5000 flask-demo

访问 http://localhost:5000 即可看到应用输出。

进阶技巧与常见问题

多阶段构建（Multi-Stage Builds）

多阶段构建可减少最终镜像体积，例如：

FROM golang:1.18 AS builder  
WORKDIR /app  
COPY go.mod go.sum ./  
RUN go mod download  
COPY . .  
RUN CGO_ENABLED=0 GOOS=linux go build -o myapp  

FROM alpine:3.16  
WORKDIR /root/  
COPY --from=builder /app/myapp .  
CMD ["./myapp"]

通过分阶段构建，最终镜像仅包含运行时所需文件。

常见问题解答

Q1：构建时出现权限问题怎么办？

A：在 Dockerfile 中使用 RUN chmod 或 RUN chown 调整文件权限，或在运行容器时添加 --privileged 参数（谨慎使用）。

Q2：如何调试 Dockerfile 构建失败？

A：通过 docker build --no-cache 强制不使用缓存，或在命令后添加 -f Dockerfile -t test --progress=plain 查看详细日志。

结论

通过本文，我们系统学习了 Dockerfile 的核心概念、指令用法及最佳实践。从基础的 FROM 到进阶的多阶段构建，Dockerfile 的灵活性和标准化特性，使其成为现代 DevOps 流程中的关键工具。无论是部署 Web 应用、数据分析任务还是微服务，掌握 Dockerfile 的编写与优化，都能显著提升开发效率和环境一致性。

动手实践是掌握 Dockerfile 的最佳途径。建议读者从简单案例开始，逐步尝试多阶段构建、缓存优化等技巧。通过持续实践，你将能自如地用 Dockerfile 定义复杂应用的运行环境，真正体验容器化带来的开发便利性。

Docker Dockerfile（保姆级教程）

前言

Docker 的基础概念与容器化优势

什么是 Docker？

Dockerfile 的角色

Dockerfile 的基本结构与核心指令

Dockerfile 的基本结构

示例 Dockerfile 结构

核心指令详解

1. FROM

2. RUN

3. COPY 和 ADD

4. WORKDIR

5. CMD 和 ENTRYPOINT

6. EXPOSE

7. ENV