Dockerfile 最佳实践

好的 Dockerfile 能让镜像体积减小 90%，构建速度提升 50%

基础镜像选择#

使用 Alpine 镜像#

1
# ❌ 基础镜像过大
2
FROM node:18
3

4
# ✅ 推荐使用 Alpine
5
FROM node:18-alpine

Alpine 镜像只有约 5MB vs 900MB+。

多阶段构建#

1
# 构建阶段
2
FROM node:18-alpine AS builder
3
WORKDIR /app
4
COPY package*.json ./
5
RUN npm ci --only=production
6
COPY . .
7
RUN npm run build
8

9
# 运行阶段
10
FROM node:18-alpine
11
WORKDIR /app
12
COPY --from=builder /app/dist ./dist
13
COPY --from=builder /app/node_modules ./node_modules
14
EXPOSE 3000
15
CMD ["node", "dist/index.js"]

TIP
多阶段构建可以完全移除构建工具，只保留运行时依赖。

层缓存优化#

1
# ❌ 每次代码修改都会导致依赖重新安装
2
COPY . .
3
RUN npm install
4

5
# ✅ 先复制依赖文件，安装后再复制代码
6
COPY package*.json ./
7
RUN npm ci
8
COPY . .

减少镜像层数#

1
# ❌ 多个 RUN 指令创建多层
2
RUN apt-get update
3
RUN apt-get install -y git
4
RUN apt-get clean
5

6
# ✅ 合并为一个 RUN
7
RUN apt-get update && \
8
    apt-get install -y git && \
9
    apt-get clean && \
10
    rm -rf /var/lib/apt/lists/*

安全最佳实践#

1
# ✅ 创建非 root 用户
2
RUN addgroup -g 1001 appgroup && \
3
    adduser -u 1001 -G appgroup -s /bin/sh -D appuser
4

5
USER appuser

效果对比#

优化前	优化后	提升
1.2 GB	120 MB	90%
5 min	2 min	60%
高危漏洞	无漏洞	安全

常用命令#

1
# 查看镜像大小
2
docker images
3

4
# 分析镜像层
5
docker history myimage:latest
6

7
# 清理无用构建缓存
8
docker builder prune