Docker基础教程（九十五）Dockerfile基础：别再乱写Dockerfile了！这份“魔法配方”让你从入门到入魂，打包镜像爽到飞起！

在云原生时代的江湖中，Docker无疑是那位身怀绝技、扛着集装箱（Container）满世界跑的“扛把子”。而决定这个集装箱里装什么宝贝、环境如何布置的，正是一份名为Dockerfile的“神秘图纸”。它看似简单，几行代码而已，却足以让新手抓狂、老手翻车、高手痴迷。

今天，咱们就来扒一扒Dockerfile的底裤，哦不，是基础！从内核原理到实战骚操作，让你彻底搞懂这份“魔法配方”，不仅能写出能跑的，更要写出跑得快、身材好、安全性高的优质镜像。

一、Dockerfile是什么？为啥说它是“魔法配方”？

想象一下，你要做一道经典名菜“红烧肉”。你需要一份菜谱，上面写着：准备什么食材（基础镜像）、按什么顺序下锅（指令序列）、炒多久（执行命令）、最后用什么盘子装（启动命令）。

Dockerfile就是这个菜谱。它是一个文本文件，包含了一系列的指令(Instruction)，每一条指令都会在镜像上创建一个新的层(Layer)。Docker引擎通过读取这个文件，就能自动化的构建出一个完整的、可运行的应用程序镜像。

它的魔法在于：一次编写，处处运行。你再也不用在服务器上吭哧吭哧地配环境了，只需要这份“配方”，就能在任何安装了Docker的地方，复刻出一模一样的运行环境。

二、逐行拆解：Dockerfile核心指令“全家福”

一份完美的Dockerfile，就像一段优美的代码。我们来认识一下它的核心成员：

1. FROM： 定基调的“老祖宗”

• • 作用：指定基础镜像。所有后续操作都基于这个镜像开始。它必须是Dockerfile的第一条非注释指令。
  • 示例：FROM ubuntu:20.04 (基于Ubuntu) 或 FROM node:18-alpine (基于小巧的Node.js Alpine版本)。强烈建议使用官方、安全、版本明确的基础镜像。

1. RUN： 任劳任怨的“施工队”

• • 作用：在镜像构建过程中执行命令。常用于安装软件包、编译代码等。
  • 最佳实践：合并多条RUN指令，用&&和\（换行符）连接，以减少镜像层数，缩小镜像体积。

反面教材：

RUN apt-get update
RUN apt-get install -y git
RUN apt-get install -y curl # 创建了3个层，体积臃肿！

正面典范：

RUN apt-get update && apt-get install -y \
    git \
    curl \
    && rm -rf /var/lib/apt/lists/* # 清理缓存，一个层搞定，还很瘦身！

1. COPY & ADD： 勤恳的“搬运工”

• • 作用：将本地文件或目录复制到镜像中。
  • COPY <src> <dest>： 纯粹的文件拷贝，首选推荐。
  • ADD <src> <dest>： 比COPY多了些功能，比如自动解压tar包、支持URL源。但行为不够透明，除非需要解压，否则一律用COPY。
  • 示例：COPY ./package.json /app/

1. WORKDIR： 设定工作目录的“指挥官”

• • 作用：设置后续指令（如RUN, CMD, COPY）的当前工作目录。如果目录不存在，会自动创建。相当于cd命令。
  • 重要性：总是使用绝对路径。用了它，就不用再写一堆cd /app && ...了，让Dockerfile更清晰。

1. EXPOSE： 对外宣示的“端口号”

• • 作用：声明容器运行时监听的网络端口。这只是一个文档说明，方便使用者知道端口信息。真正发布端口是在docker run时用-p参数映射。
  • 示例：EXPOSE 3000 (声明容器内应用跑在3000端口)

1. ENV： 设置环境变量的“大管家”

• • 作用：设置环境变量，这个变量在构建阶段和容器运行时都能被使用。
  • 示例：ENV NODE_ENV production

1. CMD 与 ENTRYPOINT： 启动应用的“终极Boss”

• • 这是最容易混淆的一对指令，但理解了就豁然开朗。
  • CMD ["executable", "param1", "param2"]： 为容器提供默认的启动命令和参数。可以被docker run后面跟的命令行参数覆盖。
  • ENTRYPOINT ["executable"]： 配置容器启动后一定会被执行的命令。docker run后面的参数会作为参数传递给ENTRYPOINT。

最佳CP：通常组合使用。ENTRYPOINT定义核心命令，CMD定义默认参数。

ENTRYPOINT ["nginx"]
CMD ["-g", "daemon off;"] # 默认参数

• • • 直接 docker run my-nginx -> 运行 nginx -g "daemon off;"
    • docker run my-nginx -t -> 运行 nginx -t (覆盖了CMD的参数)

三、高级魔法：让你的镜像“瘦身”又“提速”

1. 利用构建缓存(Build Cache)： Docker在构建时会缓存每一层。如果你修改了Dockerfile的某一指令，那么该指令及其之后的所有指令的缓存都会失效。因此，要把最不经常变化的层放在前面（如安装依赖），把最经常变化的层放在最后（如拷贝源代码）。
2. “.dockerignore”文件： 像.gitignore一样，它告诉Docker在拷贝文件时忽略哪些文件。避免把node_modules、.git、日志文件等不必要的东西拷贝进镜像，极大加速构建过程和提高安全性。
3. 多阶段构建(Multi-stage Build)： 这是制作“瘦身”镜像的终极神器！

• • 场景：你需要一个庞大的环境来编译代码（如需要GCC、Maven），但运行环境只需要一个很小的JRE或一个nginx。
  • 原理：在同一个Dockerfile中，使用多个FROM指令创建多个“阶段”。你可以将前一阶段的构建产物， selectively 地拷贝到后一个干净的阶段中，只留下最终需要的东西，抛弃所有多余的构建工具和中间文件。

四、完整示例：打包一个Node.js+Vue.js全栈应用

假设我们有一个前端Vue项目（生成静态文件在dist目录）和一个简单的Node.js Express静态文件服务器。

目录结构：

my-app/
├── docker-compose.yml (可选)
├── Dockerfile
├── server/
│   ├── package.json
│   └── server.js
└── frontend/
    ├── ... (所有Vue源码)
    └── dist/ (构建后生成)

Dockerfile (多阶段构建典范)：

# 第一阶段：构建前端 - 命名为 builder
FROM node:18-alpine AS frontend-builder
WORKDIR /app
COPY frontend/package*.json ./
RUN npm ci --only=production # 安装生产依赖（如果只需要构建，可以用 --only=development）
COPY frontend/ ./
RUN npm run build # 执行构建命令，生成 dist 目录

# 第二阶段：构建后端 - 其实也是运行时，但分开以示清晰
FROM node:18-alpine AS server-builder
WORKDIR /app
COPY server/package*.json ./
RUN npm ci --only=production # 为后端安装生产依赖

# 第三阶段：最终运行时镜像
FROM node:18-alpine
LABEL maintainer="你的名字<you@example.com>"

# 安装一些系统依赖（如果需要，比如字体库等）
# RUN apk add --no-cache ... 

WORKDIR /app

# 从 server-builder 阶段只拷贝 node_modules 和 package.json
COPY --from=server-builder /app/node_modules ./node_modules
COPY server/package.json ./
# 从 frontend-builder 阶段拷贝构建好的静态文件
COPY --from=frontend-builder /app/dist ./public
# 拷贝后端源码
COPY server/server.js ./

# 应用运行参数
ENV NODE_ENV=production
ENV PORT=3000
EXPOSE 3000

# 健康检查
HEALTHCHECK --interval=30s --timeout=3s \
  CMD curl -f http://localhost:3000/ || exit 1

# 启动命令
USER node # 建议不以root身份运行
CMD ["node", "server.js"]

.dockerignore文件：

node_modules
npm-debug.log
.git
.gitignore
README.md
Dockerfile
.dockerignore
**/__tests__
**/.DS_Store

构建并运行：

# 构建镜像，命名为 my-fullstack-app
docker build -t my-fullstack-app .

# 运行容器，将容器内部3000端口映射到主机的8080端口
docker run -d -p 8080:3000 --name my-running-app my-fullstack-app

现在，打开浏览器访问 http://localhost:8080，你的全栈应用就在容器里欢快地跑起来啦！

五、总结

写好Dockerfile是一门艺术，更是工程能力的体现。记住以下核心心法：

• 从简出发：选择最合适、最小巧的基础镜像。
• 利用缓存：合理安排指令顺序，最大化利用构建缓存。
• 保持精简：每一层只放必要的东西，及时清理临时文件，善用.dockerignore。
• 拥抱多阶段：这是制作最小化生产镜像的不二法门。
• 安全第一：不要以root用户运行应用，使用明确的基础镜像版本。

掌握了这份“魔法配方”，你就掌握了容器化时代的标准化交付能力。从此，打包、部署、迁移应用不再是玄学，而是一段可版本化、可追溯、可重复的愉悦旅程。快去优化你的Dockerfile，享受那种镜像体积从1GB+降到几十MB的快感吧！