Docker 容器化实践指南

Docker 的核心价值

Docker 解决了"在我机器上能跑"这个经典问题。通过容器化，你可以将应用及其依赖打包成一个可移植的镜像，在任何支持 Docker 的环境中运行。

基本概念

• 镜像 (Image)：应用的只读模板，包含运行环境和代码
• 容器 (Container)：镜像的运行实例，拥有独立的文件系统
• Dockerfile：构建镜像的指令文件
• Docker Compose：多容器应用编排工具

编写高效的 Dockerfile

多阶段构建

# 构建阶段
FROM node:20-alpine AS builder
WORKDIR /app
COPY package.json pnpm-lock.yaml ./
RUN corepack enable && pnpm install --frozen-lockfile
COPY . .
RUN pnpm build

# 运行阶段
FROM node:20-alpine AS runner
WORKDIR /app
RUN addgroup --system --gid 1001 nodejs && \
    adduser --system --uid 1001 nextjs
COPY --from=builder /app/.next/standalone ./
COPY --from=builder /app/.next/static ./.next/static
USER nextjs
EXPOSE 3000
CMD ["node", "server.js"]

层缓存优化

# ✅ 好的做法：先复制依赖文件（变化频率低）
COPY package.json pnpm-lock.yaml ./
RUN pnpm install
COPY . .

# ❌ 不好的做法：先复制所有文件
COPY . .
RUN pnpm install

常用命令速查

Docker Compose 示例

Next.js 应用的开发环境 compose 文件：

version: "3.8"
services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=development
    volumes:
      - .:/app
      - /app/node_modules
    depends_on:
      - db

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: myblog
      POSTGRES_PASSWORD: postgres
    ports:
      - "5432:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data

volumes:
  pgdata:

镜像体积优化

# 查看镜像各层大小
docker history my-image:latest

# 使用 dive 工具分析镜像
dive my-image:latest

几点优化建议：

1. 选择 alpine 变体的基础镜像
2. 合并 RUN 指令减少层数
3. 使用 .dockerignore 排除不需要的文件
4. 清理包管理器的缓存

常见问题

• 容器启动后立即退出：检查 CMD 指令和前台进程
• 端口无法访问：确认端口映射和防火墙规则
• 磁盘空间不足：定期运行 docker system prune
• 构建缓存未命中：检查 COPY 指令顺序和文件变化