Dockerfile 多语言实战全指南:Java、Go、前端及生产级技巧大全
容器化不是难事,难的是写出真正生产可用的 Dockerfile
一、Dockerfile 指令速查
在开始各语言实战前,先把所有指令过一遍,心中有数:
| | |
|---|
| | |
| | `RUN apt-get install -y curl` |
| | |
| | |
| | |
| | `ENV NODE_ENV=production` |
| | |
| | |
| | `ENTRYPOINT ["java", "-jar"]` |
| | |
| | |
| | |
| | |
| | `HEALTHCHECK CMD curl -f http://localhost/` |
| | |
| | |
| | `SHELL ["/bin/bash", "-c"]` |
二、Java 程序 Dockerfile 实战
2.1 Spring Boot 标准写法(多阶段构建)
dockerfile# ===== 构建阶段 =====FROM maven:3.9-eclipse-temurin-17 AS builderWORKDIR /build# 先复制 pom.xml 利用缓存层(依赖变化少)COPY pom.xml .RUN mvn dependency:go-offline -q# 再复制源码COPY src ./src
RUN mvn clean package -DskipTests -q# ===== 运行阶段 =====FROM eclipse-temurin:17-jre-alpineLABEL maintainer="your-team@example.com" \ version="1.0" \ description="Spring Boot Application"# 创建非 root 用户RUN addgroup -S appgroup && adduser -S appuser -G appgroupWORKDIR /app# 从构建阶段复制 jar 包COPY --from=builder /build/target/*.jar app.jar# JVM 调优参数(生产推荐)ENV JAVA_OPTS="-Xms512m -Xmx1024m -XX:+UseG1GC -XX:+HeapDumpOnOutOfMemoryError \ -XX:HeapDumpPath=/tmp/heapdump.hprof \ -Dfile.encoding=UTF-8 \ -Duser.timezone=Asia/Shanghai"# Spring 配置通过环境变量传入ENV SPRING_PROFILES_ACTIVE=prodENV SERVER_PORT=8080EXPOSE 8080# 切换非 root 用户USER appuser# 健康检查HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \ CMD wget -qO- http://localhost:8080/actuator/health || exit 1ENTRYPOINT ["sh", "-c", "exec java $JAVA_OPTS -jar app.jar"]
2.2 Gradle 项目写法
dockerfileFROM gradle:8.5-jdk17-alpine AS builderWORKDIR /buildCOPY build.gradle settings.gradle ./COPY gradle ./gradle# 先下载依赖RUN gradle dependencies --no-daemon -q || trueCOPY src ./srcRUN gradle bootJar --no-daemon -qFROM eclipse-temurin:17-jre-alpineWORKDIR /appCOPY --from=builder /build/build/libs/*.jar app.jarENV JAVA_OPTS="-Xms256m -Xmx512m"EXPOSE 8080ENTRYPOINT ["sh", "-c", "exec java $JAVA_OPTS -jar app.jar"]
2.3 构建与运行命令
bash# 构建镜像docker build -t my-spring-app:1.0 .# 传入环境变量启动docker run -d \ -p 8080:8080 \ -e SPRING_PROFILES_ACTIVE=prod \ -e SPRING_DATASOURCE_URL=jdbc:mysql://db:3306/mydb \ -e SPRING_DATASOURCE_USERNAME=root \ -e SPRING_DATASOURCE_PASSWORD=secret \ -e JAVA_OPTS="-Xms512m -Xmx1g" \ --name my-app \ my-spring-app:1.0
三、Go 程序 Dockerfile 实战
Go 是容器化的最佳搭档——静态二进制,最终镜像可以小到极致。
3.1 标准多阶段构建(scratch 基础镜像)
dockerfile# ===== 构建阶段 =====FROM golang:1.22-alpine AS builderWORKDIR /build# 安装构建依赖RUN apk add --no-cache git ca-certificates tzdata# 先复制 go mod 文件,利用缓存层COPY go.mod go.sum ./RUN go mod download# 复制源码并编译COPY . .RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build \
-ldflags="-w -s -X main.Version=$(git describe --tags --always)" \ -o app ./cmd/server# ===== 运行阶段(scratch 极简镜像)=====FROM scratchLABEL maintainer="your-team@example.com"# 从构建阶段复制必要文件COPY --from=builder /usr/share/zoneinfo /usr/share/zoneinfoCOPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/COPY --from=builder /build/app /appENV TZ=Asia/ShanghaiEXPOSE 8080ENTRYPOINT ["/app"]
3.2 需要 CGO 的 Go 程序(使用 distroless)
dockerfileFROM golang:1.22-alpine AS builderWORKDIR /buildRUN apk add --no-cache gcc musl-devCOPY go.mod go.sum ./RUN go mod downloadCOPY . .RUN CGO_ENABLED=1 go build -o app .# Distroless 镜像(比 Alpine 更安全,无 shell)FROM gcr.io/distroless/base-debian12WORKDIR /appCOPY --from=builder /build/app .EXPOSE 8080ENTRYPOINT ["/app/app"]
3.3 构建与运行命令
bash# 构建docker build -t my-go-app:1.0 .# 启动(传入配置)docker run -d \ -p 8080:8080 \ -e APP_ENV=production \ -e DB_HOST=127.0.0.1 \ -e DB_PORT=5432 \ -e LOG_LEVEL=info \ -v /data/config:/app/config:ro \ --name go-app \ my-go-app:1.0# 查看最终镜像大小(通常 < 15MB)docker images my-go-app:1.0
四、前端 Dockerfile 实战
4.1 React / Vue / 通用前端(Nginx 服务)
dockerfile# ===== 构建阶段 =====FROM node:20-alpine AS builderWORKDIR /app# 先复制 package.json,利用缓存COPY package.json package-lock.json ./RUN npm ci --only=production=false# 复制源码并构建COPY . .# 注入构建时参数(API 地址等)ARG VITE_API_URL=https://api.example.comARG REACT_APP_ENV=productionENV VITE_API_URL=$VITE_API_URLENV REACT_APP_ENV=$REACT_APP_ENVRUN npm run build# ===== 运行阶段 =====FROM nginx:1.25-alpineLABEL maintainer="frontend-team@example.com"# 自定义 Nginx 配置(支持 Vue Router / React Router 的 history 模式)RUN cat > /etc/nginx/conf.d/default.conf << 'EOF'server { listen 80; root /usr/share/nginx/html; index index.html; gzip on; gzip_types text/plain text/css application/json application/javascript text/xml; location / { try_files $uri $uri/ /index.html; }
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2)$ { expires 1y; add_header Cache-Control "public, immutable"; }}EOFCOPY --from=builder /app/dist /usr/share/nginx/htmlEXPOSE 80HEALTHCHECK --interval=30s --timeout=5s \ CMD wget -qO- http://localhost/ || exit 1
4.2 Next.js / Nuxt.js(SSR 模式)
dockerfileFROM node:20-alpine AS depsWORKDIR /appCOPY package.json package-lock.json ./RUN npm ciFROM node:20-alpine AS builderWORKDIR /appCOPY --from=deps /app/node_modules ./node_modulesCOPY . .RUN npm run buildFROM node:20-alpine AS runnerWORKDIR /appENV NODE_ENV=production# 只复制运行时需要的文件COPY --from=builder /app/public ./publicCOPY --from=builder /app/.next/standalone ./COPY --from=builder /app/.next/static ./.next/static# 非 root 用户RUN addgroup -S nodejs && adduser -S nextjs -G nodejsUSER nextjsEXPOSE 3000ENV PORT=3000CMD ["node", "server.js"]
4.3 构建时注入 API 地址
bash# 构建时传入不同环境的 API 地址docker build \ --build-arg VITE_API_URL=https://api-prod.example.com \ --build-arg VITE_APP_VERSION=2.1.0 \ -t frontend:prod .docker build \ --build-arg VITE_API_URL=https://api-dev.example.com \ -t frontend:dev .
五、Python 程序 Dockerfile 实战
dockerfileFROM python:3.12-slim AS builderWORKDIR /build# 安装编译依赖RUN apt-get update && apt-get install -y --no-install-recommends \ gcc libpq-dev \ && rm -rf /var/lib/apt/lists/*# 利用缓存层:先复制 requirementsCOPY requirements.txt .RUN pip install --no-cache-dir --prefix=/install -r requirements.txtFROM python:3.12-slimWORKDIR /app# 复制预装好的依赖COPY --from=builder /install /usr/local# 非 root 用户RUN useradd -m -u 1000 appuser && chown -R appuser /appCOPY --chown=appuser . .USER appuser# 环境变量ENV PYTHONDONTWRITEBYTECODE=1 \ PYTHONUNBUFFERED=1 \ APP_ENV=productionEXPOSE 8000HEALTHCHECK --interval=30s --timeout=10s \ CMD curl -f http://localhost:8000/health || exit 1
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "--workers", "4", "app:app"]
六、Node.js 后端 Dockerfile 实战
dockerfileFROM node:20-alpine AS depsWORKDIR /appCOPY package.json package-lock.json ./RUN npm ci --only=productionFROM node:20-alpineWORKDIR /app# 非 root 用户(node 镜像内置)RUN chown -R node:node /appCOPY --from=deps --chown=node:node /app/node_modules ./node_modulesCOPY --chown=node:node . .USER nodeENV NODE_ENV=production \ PORT=3000EXPOSE 3000HEALTHCHECK --interval=30s --timeout=5s \ CMD wget -qO- http://localhost:3000/health || exit 1CMD ["node", "src/index.js"]
七、环境变量传入技巧大全
7.1 ENV vs ARG 的区别
| | |
|---|
| | |
| ✅ 保留(`docker inspect` 可见) | |
| | |
| | |
7.2 ARG + ENV 组合使用(最佳实践)
dockerfile# ARG 只在构建时存在ARG APP_VERSION=latestARG BUILD_DATE# 转存到 ENV 使运行时可见ENV APP_VERSION=$APP_VERSIONLABEL build_date=$BUILD_DATE# 构建时传入# docker build --build-arg APP_VERSION=2.0.0 --build-arg BUILD_DATE=$(date -u) .
7.3 运行时注入环境变量的三种方式
bash# 方式1:命令行 -e 参数docker run -e DB_HOST=localhost -e DB_PORT=5432 myapp# 方式2:env-file 文件(推荐,避免密码泄露)docker run --env-file .env.prod myapp# 方式3:Docker Compose(最常用)# docker-compose.yml:# environment:# - DB_HOST=${DB_HOST}# - SPRING_PROFILES_ACTIVE=prod
7.4 .env 文件示例
bash# .env.prodDB_HOST=192.168.1.100DB_PORT=5432DB_NAME=mydbDB_USER=appuserDB_PASS=supersecretAPP_ENV=productionLOG_LEVEL=infoJWT_SECRET=change-me-in-production
八、.dockerignore 最佳实践
每次写 Dockerfile,都应该配套一个 .dockerignore:
# 版本控制.git.gitignore.gitattributes# 依赖目录(镜像内重新安装)node_modulesvendor__pycache__*.pyc.venv# 构建输出distbuildtarget*.jar*.war# IDE 和编辑器.idea.vscode*.swp*.iml# 测试和文档**/*_test.go**/*.test.jscoveragedocs# 环境和密钥(绝不能进镜像!).env.env.**.pem*.keysecrets/# 系统文件.DS_StoreThumbs.db
九、生产级 Dockerfile 小技巧集锦
9.1 利用构建缓存加速构建
dockerfile# ✅ 正确:依赖文件先复制,源码后复制COPY package.json package-lock.json ./RUN npm ciCOPY . . # 源码变化不影响依赖层缓存# ❌ 错误:所有文件一起复制,源码变化导致依赖重装COPY . .RUN npm ci
9.2 减小镜像体积技巧
dockerfile# 合并 RUN 命令,减少层数RUN apt-get update \ && apt-get install -y --no-install-recommends \ curl wget git \ && apt-get clean \ && rm -rf /var/lib/apt/lists/*# 使用 Alpine 基础镜像(约 5MB vs Ubuntu 约 80MB)FROM python:3.12-alpine # 而非 python:3.12# 多阶段构建,只保留运行时产物
9.3 安全最佳实践
dockerfile# 使用非 root 用户RUN addgroup -S appgroup && adduser -S appuser -G appgroupUSER appuser# 设置文件只读COPY --chown=appuser:appgroup --chmod=444 config.yaml /app/# 不在镜像中存储密钥(用运行时注入)# ❌ 错误ENV DB_PASSWORD=mysecret# ✅ 正确:通过 -e 或 --env-file 在运行时传入
9.4 ENTRYPOINT vs CMD 的配合
dockerfile# 固定命令 + 可变参数ENTRYPOINT ["java", "-jar", "app.jar"]CMD ["--spring.profiles.active=prod"] # 可被 docker run 后的参数覆盖# 使用 exec form(推荐,正确转发信号)ENTRYPOINT ["./app"] # ✅ exec form
# ENTRYPOINT ./app # ❌ shell form(PID≠1,信号无法转发)# wrapper 脚本启动(适合需要启动前初始化的场景)COPY entrypoint.sh /entrypoint.shRUN chmod +x /entrypoint.shENTRYPOINT ["/entrypoint.sh"]
9.5 健康检查配置详解
dockerfileHEALTHCHECK \ --interval=30s \ # 检查间隔 --timeout=10s \ # 单次超时 --start-period=60s \ # 启动等待时间(给应用启动预热) --retries=3 \ # 失败重试次数 CMD curl -sf http://localhost:8080/actuator/health \ | grep -q '"status":"UP"' || exit 1
9.6 使用 BuildKit 加速构建
bash# 启用 BuildKitexport DOCKER_BUILDKIT=1# 使用缓存挂载(Go/Maven/pip 依赖缓存)RUN --mount=type=cache,target=/root/.m2 \ mvn package -DskipTestsRUN --mount=type=cache,target=/go/pkg/mod \ go build -o app .RUN --mount=type=cache,target=/root/.cache/pip \ pip install -r requirements.txt
十、各语言镜像大小对比
| | |
|---|
| | |
| | |
| eclipse-temurin:17-jre-alpine | |
| | |
| | |
| | |
十一、Docker Compose 完整示例
yamlversion: "3.9"services: backend: build: context: ./backend dockerfile: Dockerfile args: APP_VERSION: ${APP_VERSION:-1.0.0} image: myapp-backend:${APP_VERSION:-latest} ports: - "8080:8080" environment: - SPRING_PROFILES_ACTIVE=prod - SPRING_DATASOURCE_URL=jdbc:mysql://db:3306/mydb - SPRING_DATASOURCE_USERNAME=${DB_USER} - SPRING_DATASOURCE_PASSWORD=${DB_PASS} depends_on: db: condition: service_healthy restart: unless-stopped frontend: build: context: ./frontend args:
VITE_API_URL: https://api.example.com ports: - "80:80" depends_on: - backend db: image: mysql:8.0 environment: MYSQL_DATABASE: mydb MYSQL_USER: ${DB_USER} MYSQL_PASSWORD: ${DB_PASS} MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASS} volumes: - db_data:/var/lib/mysql healthcheck: test: ["CMD", "mysqladmin", "ping", "-h", "localhost"] interval: 10s retries: 5volumes: db_data:
十二、总结
| | | |
|---|
| eclipse-temurin:17-jre-alpine | | JAVA_OPTS 调优,actuator 健康检查 |
| | | |
| | | ARG 注入 API 地址,history 路由配置 |
| | | PYTHONUNBUFFERED=1,gunicorn 部署 |
| | | |
三条黄金法则: