Dockerfile 是 Docker 镜像构建的核心配置文件，通过预定义的指令集实现镜像的自动化构建。以下从核心概念、指令详解、最佳实践三方面展开说明，帮助你系统掌握 Dockerfile 的使用逻辑：

一、Dockerfile 核心概念

本质与作用

定义：纯文本文件，包含从基础镜像构建自定义镜像的所有指令，是镜像构建的“源代码”。
核心价值：

标准化构建流程：通过版本控制 Dockerfile，确保镜像构建过程可复现。

分层构建机制：每条指令生成镜像的一层，利用缓存机制加速后续构建（未修改的层直接复用）。

构建流程

准备上下文：指定包含 Dockerfile 和相关文件的目录（通过 docker build . 的 . 传递）。
解析指令：Docker 按顺序执行 Dockerfile 指令，逐层生成镜像。
生成镜像：最终输出可运行的镜像，支持通过标签（Tag）唯一标识。

二、Dockerfile 常用指令详解

基础镜像与元数据

FROM

作用：指定基础镜像（必须为第一条指令），支持 scratch 空镜像构建极简镜像。
示例：

FROM node:20-alpine # 基于 Node.js 20 轻量级镜像

LABEL（替代已弃用的 MAINTAINER）

作用：添加镜像元数据（作者、版本、描述等）。
示例：

LABEL org.opencontainers.image.authors="your-name@example.com" \ 
version="1.0.0" \ 
description="Web application service"

构建时执行指令

RUN

作用：在构建阶段执行命令，支持 shell（默认）和 exec 格式。
最佳实践：

多条命令用 && 合并，减少镜像层数（如 RUN apt-get update && apt-get install -y package）。

使用 exec 格式避免 shell 注入风险：

RUN ["apt-get", "update"]

COPY vs ADD

指令	优势	劣势	典型场景
COPY	简单高效，仅复制文件/目录	不支持远程 URL、不解压 tar	复制本地代码到镜像
ADD	支持远程 URL、自动解压 tar	构建缓存易失效，性能较低	下载远程文件或解压资源

示例：

COPY src/ /app/ # 复制本地 src 目录到镜像 /app/ 
ADD app.tar.gz /app # 解压 app.tar.gz 到 /app（自动解压）

容器运行时配置

CMD

作用：指定容器启动时的默认命令，仅最后一条有效，支持三种格式：

CMD ["node", "app.js"] 					 # exec 格式（推荐） 
CMD node app.js 											# shell 格式 
CMD ["--port", "8080"] 					  # 为 ENTRYPOINT 提供默认参数

ENTRYPOINT

作用：设置容器启动时的主程序（不可被 docker run 命令覆盖），常与 CMD 配合使用。
示例：

ENTRYPOINT ["nginx", "-g", "daemon off;"]				 # 固定主程序 
CMD ["-c", "/etc/nginx/nginx.conf"]												 # 可替换的参数

ENV vs ARG

指令	作用范围	能否在运行时访问	默认值支持	典型场景
ENV	构建阶段 + 运行时	是	是	配置环境变量（如端口、路径）
ARG	仅限构建阶段	否	是	传递构建参数（如版本号）

示例：

ARG BUILD_VERSION=1.0.0 						# 构建参数，默认值 1.0.0 
ENV APP_ENV=production 							# 运行时环境变量

容器资源配置

EXPOSE

作用：声明容器运行时监听的端口（需配合 docker run -p 映射宿主机端口）。
示例：

EXPOSE 80 443 # 声明 HTTP/HTTPS 端口

VOLUME

作用：定义数据卷，实现容器数据持久化或与宿主机共享数据。
示例：

VOLUME /data/db # 声明 /data/db 为数据卷

WORKDIR

作用：设置后续指令的工作目录（避免路径硬编码）。
示例：

WORKDIR /app COPY package*.json ./

三、Dockerfile 最佳实践

分层构建优化

原则：
高频变动的文件（如代码）放在靠后的层，低频变动的依赖（如基础镜像、依赖包）放在靠前的层，充分利用缓存。
避免冗余层，用 && 合并同类 RUN 指令。
示例（Node.js 应用）：

FROM node:20-alpine AS build 									 # 构建阶段 
WORKDIR /app COPY package*.json ./ 		 # 先复制依赖清单，缓存依赖安装层 
RUN npm install --production
 COPY . . 																																 # 最后复制代码，减少缓存失效概率 

FROM node:20-alpine AS runtime 							# 运行阶段（使用轻量级镜像） 
WORKDIR /app 
COPY --from=build /app/node_modules ./ 
COPY --from=build /app/dist ./ 										# 仅复制构建产物 
CMD ["node", "server.js"]

安全与轻量化

使用非 root 用户：

RUN addgroup -S app && adduser -S app -G app 
USER app 
WORKDIR /home/app

选择合适的基础镜像：

优先使用 alpine 结尾的轻量级镜像（如 nginx:alpine、python:3.12-alpine），减少镜像体积。
生产环境避免使用 latest 标签，指定具体版本（如 node:20.6.1）确保稳定性。

上下文管理

.dockerignore 文件：
在上下文目录中创建 .dockerignore，排除无需打包的文件（如 node_modules、日志、临时文件）：

node_modules/ 
  *.log
   .git/

避免远程资源直接写入镜像：
尽量通过 COPY 传递本地文件，避免在 RUN 中使用 wget 下载大文件（可通过构建参数传递 URL，或使用构建时缓存）。

四、实战案例：构建 Spring Boot 镜像

# 构建阶段（使用 Java 17 构建环境）
FROM maven:3.9.2-eclipse-temurin-17 AS build
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:resolve
COPY src ./src
RUN mvn package -DskipTests

# 运行阶段（使用轻量级 OpenJDK 镜像）
FROM eclipse-temurin:17-jre-alpine
WORKDIR /app
COPY --from=build /app/target/*.jar app.jar  # 复制构建好的 Jar 包
ENV JAVA_OPTS="-Xms512m -Xmx1024m"            # 配置 JVM 内存
EXPOSE 8080
CMD ["java", "$JAVA_OPTS", "-jar", "app.jar"]

构建命令：

docker build -t my-spring-boot-app:1.0 .

五、总结

Dockerfile 通过标准化的指令集，将镜像构建过程代码化，实现了环境配置的版本控制和容器化应用的可移植性。掌握核心指令（如 FROM、COPY、RUN、CMD）的适用场景，结合分层构建、轻量化等最佳实践，可高效构建健壮、可维护的 Docker 镜像。如需进一步优化特定场景（如多阶段构建、缓存管理），可深入研究指令细节与 Docker 构建机制。

醋醋百科网

Good Luck To You!

【Docker 新手入门指南】第十章:Dockerfile

一、Dockerfile 核心概念

二、Dockerfile 常用指令详解

三、Dockerfile 最佳实践

四、实战案例：构建 Spring Boot 镜像

五、总结