golang的Docker服务 | 油条TV - Web3 与 AI 开发社区

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
FROM golang:1.21

WORKDIR /app

COPY . .

RUN go build -o main .

CMD ["./main"]

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# 构建阶段
FROM golang:1.21-alpine AS builder

WORKDIR /app

# 复制依赖文件
COPY go.mod go.sum ./

# 下载依赖
RUN go mod download

# 复制源代码
COPY . .

# 编译应用
RUN go build -o main .

# 运行阶段
FROM alpine:latest

WORKDIR /app

# 从构建阶段复制可执行文件
COPY --from=builder /app/main .

# 暴露端口
EXPOSE 8080

# 运行应用
CMD ["./main"]

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
# ============================================
# 构建阶段
# ============================================
FROM golang:1.21-alpine AS builder

# 安装构建依赖
RUN apk add --no-cache git ca-certificates tzdata

# 设置工作目录
WORKDIR /app

# 优化：先复制依赖文件，利用 Docker 缓存
COPY go.mod go.sum ./

# 下载依赖（这层会被缓存）
RUN go mod download && go mod verify

# 复制源代码
COPY . .

# 编译优化参数
# -ldflags="-w -s" : 去除调试信息，减小体积
# -trimpath : 去除文件路径信息
# CGO_ENABLED=0 : 禁用 CGO，生成静态链接二进制
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build \
    -ldflags="-w -s" \
    -trimpath \
    -o main .

# ============================================
# 运行阶段
# ============================================
FROM alpine:latest

# 安装运行时依赖
RUN apk add --no-cache ca-certificates tzdata

# 创建非 root 用户
RUN addgroup -g 1001 -S appuser && \
    adduser -S appuser -u 1001 -G appuser

WORKDIR /app

# 复制时区数据
COPY --from=builder /usr/share/zoneinfo /usr/share/zoneinfo

# 复制可执行文件
COPY --from=builder /app/main .

# 复制配置文件（如果有）
# COPY --from=builder /app/config ./config

# 更改文件所有者
RUN chown -R appuser:appuser /app

# 切换到非 root 用户
USER appuser

# 暴露端口
EXPOSE 8080

# 健康检查
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
    CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1

# 运行应用
CMD ["./main"]

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# 构建阶段
FROM golang:1.21-alpine AS builder

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY . .

# 静态编译
RUN CGO_ENABLED=0 GOOS=linux go build \
    -ldflags="-w -s" \
    -a -installsuffix cgo \
    -o main .

# 运行阶段 - 使用 distroless
FROM gcr.io/distroless/static-debian11

WORKDIR /app

COPY --from=builder /app/main .

EXPOSE 8080

USER nonroot:nonroot

CMD ["./main"]

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
FROM golang:1.21-alpine AS builder

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY . .

# 完全静态编译
RUN CGO_ENABLED=0 GOOS=linux go build \
    -ldflags="-w -s -extldflags '-static'" \
    -a \
    -o main .

# 从空白镜像开始
FROM scratch

# 复制 CA 证书（用于 HTTPS 请求）
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/

# 复制时区数据
COPY --from=builder /usr/share/zoneinfo /usr/share/zoneinfo

WORKDIR /app

COPY --from=builder /app/main .

EXPOSE 8080

CMD ["./main"]

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# 构建阶段
FROM golang:1.21-alpine AS builder

# 安装 CGO 依赖
RUN apk add --no-cache gcc musl-dev

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY . .

# 启用 CGO
RUN CGO_ENABLED=1 GOOS=linux go build \
    -ldflags="-w -s" \
    -o main .

# 运行阶段
FROM alpine:latest

# 安装运行时库
RUN apk add --no-cache libc6-compat

WORKDIR /app

COPY --from=builder /app/main .

EXPOSE 8080

CMD ["./main"]

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
FROM golang:1.21-alpine AS builder

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY . .

RUN CGO_ENABLED=0 go build -ldflags="-w -s" -o main .

# 运行阶段
FROM alpine:latest

WORKDIR /app

# 复制二进制文件
COPY --from=builder /app/main .

# 复制静态资源
COPY --from=builder /app/static ./static
COPY --from=builder /app/templates ./templates

# 复制配置文件
COPY --from=builder /app/config.yaml .

EXPOSE 8080

CMD ["./main"]

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
FROM golang:1.21-alpine AS builder

WORKDIR /app

# ✅ 先复制依赖文件
COPY go.mod go.sum ./
RUN go mod download

# ✅ 后复制源代码（源代码变更频繁）
COPY . .

RUN go build -o main .

▾代码块
GITIGNORE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
# Git
.git
.gitignore

# IDE
.vscode
.idea
*.swp
*.swo

# 构建产物
*.exe
*.test
*.out
main

# 依赖
vendor/

# 文档
*.md
LICENSE

# CI/CD
.github
.gitlab-ci.yml

# 测试
*_test.go
testdata/

# 临时文件
*.tmp
*.log
.DS_Store

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
# 完整的编译优化
RUN CGO_ENABLED=0 \
    GOOS=linux \
    GOARCH=amd64 \
    go build \
    -ldflags="-w -s -X main.version=${VERSION} -X main.buildTime=${BUILD_TIME}" \
    -trimpath \
    -o main \
    ./cmd/server

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
FROM --platform=$BUILDPLATFORM golang:1.21-alpine AS builder

ARG TARGETPLATFORM
ARG BUILDPLATFORM
ARG TARGETOS
ARG TARGETARCH

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY . .

RUN CGO_ENABLED=0 GOOS=${TARGETOS} GOARCH=${TARGETARCH} \
    go build -ldflags="-w -s" -o main .

FROM alpine:latest

WORKDIR /app

COPY --from=builder /app/main .

CMD ["./main"]

▾代码块
Bash自动换行
1
docker buildx build --platform linux/amd64,linux/arm64 -t myapp:latest .

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
# 方式 1: 使用内置健康检查端点
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
    CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1

# 方式 2: 使用 curl
HEALTHCHECK --interval=30s --timeout=3s \
    CMD curl -f http://localhost:8080/health || exit 1

# 方式 3: 使用自定义脚本
COPY healthcheck.sh /
HEALTHCHECK CMD ["/healthcheck.sh"]

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
FROM alpine:latest

WORKDIR /app

COPY main .

# 设置默认环境变量
ENV APP_ENV=production \
    APP_PORT=8080 \
    LOG_LEVEL=info

# 可在运行时覆盖
EXPOSE ${APP_PORT}

CMD ["./main"]

▾代码块
Bash自动换行
1
docker run -e APP_ENV=development -e APP_PORT=3000 myapp

▾代码块
Plain Text自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
myapp/
├── cmd/
│   └── server/
│       └── main.go
├── internal/
│   ├── handler/
│   ├── service/
│   └── repository/
├── config/
│   └── config.yaml
├── go.mod
├── go.sum
├── Dockerfile
└── .dockerignore

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
# ============================================
# 构建阶段
# ============================================
FROM golang:1.21-alpine AS builder

# 构建参数
ARG VERSION=dev
ARG BUILD_TIME

# 安装依赖
RUN apk add --no-cache git ca-certificates tzdata

WORKDIR /app

# 缓存依赖
COPY go.mod go.sum ./
RUN go mod download && go mod verify

# 复制源代码
COPY . .

# 编译
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build \
    -ldflags="-w -s \
    -X main.version=${VERSION} \
    -X main.buildTime=${BUILD_TIME}" \
    -trimpath \
    -o server \
    ./cmd/server

# ============================================
# 运行阶段
# ============================================
FROM alpine:latest

# 元数据
LABEL maintainer="your-email@example.com" \
      version="${VERSION}" \
      description="My Web API Service"

# 安装运行时依赖
RUN apk add --no-cache ca-certificates tzdata && \
    addgroup -g 1001 -S appuser && \
    adduser -S appuser -u 1001 -G appuser

WORKDIR /app

# 复制文件
COPY --from=builder /app/server .
COPY --from=builder /app/config ./config

# 权限设置
RUN chown -R appuser:appuser /app

USER appuser

# 环境变量
ENV TZ=Asia/Shanghai \
    GIN_MODE=release

EXPOSE 8080

# 健康检查
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s \
    CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1

CMD ["./server"]

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
FROM golang:1.21-alpine AS builder

# 安装 protoc 和相关工具
RUN apk add --no-cache git protobuf-dev && \
    go install google.golang.org/protobuf/cmd/protoc-gen-go@latest && \
    go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY . .

# 生成 protobuf 代码（如果需要）
# RUN protoc --go_out=. --go-grpc_out=. proto/*.proto

# 编译
RUN CGO_ENABLED=0 go build -ldflags="-w -s" -o grpc-server ./cmd/server

# 运行阶段
FROM alpine:latest

RUN apk add --no-cache ca-certificates

WORKDIR /app

COPY --from=builder /app/grpc-server .

# gRPC 端口
EXPOSE 50051

CMD ["./grpc-server"]

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
FROM golang:1.21-alpine AS builder

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY . .

RUN CGO_ENABLED=0 go build -ldflags="-w -s" -o cronjob ./cmd/cronjob

FROM alpine:latest

# 安装 cronie（如果需要系统级 cron）
RUN apk add --no-cache ca-certificates tzdata

WORKDIR /app

COPY --from=builder /app/cronjob .
COPY --from=builder /app/config ./config

# 设置时区
ENV TZ=Asia/Shanghai

# 定时任务不需要暴露端口
# 但可能需要健康检查文件
HEALTHCHECK --interval=60s --timeout=3s \
    CMD test -f /tmp/healthy || exit 1

CMD ["./cronjob"]

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
# ============================================
# 构建阶段
# ============================================
FROM golang:1.21-alpine AS builder

RUN apk add --no-cache git ca-certificates

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY . .

# 编译主服务
RUN CGO_ENABLED=0 go build -ldflags="-w -s" -o api ./cmd/api

# 编译迁移工具
RUN CGO_ENABLED=0 go build -ldflags="-w -s" -o migrate ./cmd/migrate

# ============================================
# 运行阶段
# ============================================
FROM alpine:latest

RUN apk add --no-cache ca-certificates tzdata postgresql-client

WORKDIR /app

# 复制二进制文件
COPY --from=builder /app/api .
COPY --from=builder /app/migrate .

# 复制迁移脚本
COPY --from=builder /app/migrations ./migrations

# 复制启动脚本
COPY docker-entrypoint.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/docker-entrypoint.sh

EXPOSE 8080

ENTRYPOINT ["docker-entrypoint.sh"]
CMD ["./api"]

▾代码块
Bash自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
#!/bin/sh
set -e

# 等待数据库就绪
echo "Waiting for database..."
until pg_isready -h $DB_HOST -p $DB_PORT -U $DB_USER
do
  echo "Database is unavailable - sleeping"
  sleep 1
done

echo "Database is up - executing migrations"
./migrate up

echo "Starting application"
exec "$@"

▾代码块
Bash自动换行
1
2
3
4
5
6
7
8
# 构建镜像
docker build -t myapp:latest .

# 查看镜像大小
docker images myapp

# 运行容器
docker run -d -p 8080:8080 --name myapp myapp:latest

▾代码块
Bash自动换行
1
2
3
4
5
# 传递构建参数
docker build \
  --build-arg VERSION=1.0.0 \
  --build-arg BUILD_TIME=$(date -u +"%Y-%m-%dT%H:%M:%SZ") \
  -t myapp:1.0.0 .

▾代码块
YAML自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
version: '3.8'

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
      args:
        VERSION: "1.0.0"
    ports:
      - "8080:8080"
    environment:
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_USER=admin
      - DB_PASSWORD=secret
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:15-alpine
    environment:
      - POSTGRES_USER=admin
      - POSTGRES_PASSWORD=secret
      - POSTGRES_DB=myapp
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

▾代码块
Bash自动换行
1
2
3
docker-compose up -d
docker-compose logs -f app
docker-compose down

▾代码块
Bash自动换行
1
2
3
4
5
6
7
# 查看镜像历史
docker history myapp:latest

# 使用 dive 深度分析
docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  wagoodman/dive:latest myapp:latest

▾代码块
Bash自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
# Golang 官方镜像
FROM golang:1.21          # ~900MB

# Alpine 版本
FROM golang:1.21-alpine   # ~300MB

# 多阶段 + Alpine
# 最终镜像                 # ~20MB

# Distroless
# 最终镜像                 # ~10MB

# Scratch
# 最终镜像                 # ~5MB

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
# ❌ 不好的做法
COPY . .
RUN go mod download
RUN go build -o main .

# ✅ 好的做法
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN go build -o main .

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
# 方法 1: 复制时区数据
FROM alpine:latest
RUN apk add --no-cache tzdata
ENV TZ=Asia/Shanghai

# 方法 2: 从构建阶段复制
COPY --from=builder /usr/share/zoneinfo /usr/share/zoneinfo
ENV TZ=Asia/Shanghai

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
# 方法 1: 安装 ca-certificates
FROM alpine:latest
RUN apk add --no-cache ca-certificates

# 方法 2: 从构建阶段复制
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/

▾代码块
Go自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// 使用 embed 嵌入静态文件
package main

import (
    "embed"
    "net/http"
)

//go:embed static/*
var staticFiles embed.FS

func main() {
    http.Handle("/static/", http.FileServer(http.FS(staticFiles)))
    http.ListenAndServe(":8080", nil)
}

▾代码块
Go自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// 在应用启动时等待数据库
import (
    "database/sql"
    "time"
)

func waitForDB(db *sql.DB, maxRetries int) error {
    for i := 0; i < maxRetries; i++ {
        if err := db.Ping(); err == nil {
            return nil
        }
        time.Sleep(2 * time.Second)
    }
    return fmt.Errorf("database not ready after %d retries", maxRetries)
}

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
FROM golang:1.21-alpine

# 安装 air（热重载工具）
RUN go install github.com/cosmtrek/air@latest

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY . .

CMD ["air", "-c", ".air.toml"]

▾代码块
TOML自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
root = "."
testdata_dir = "testdata"
tmp_dir = "tmp"

[build]
  args_bin = []
  bin = "./tmp/main"
  cmd = "go build -o ./tmp/main ."
  delay = 1000
  exclude_dir = ["assets", "tmp", "vendor", "testdata"]
  exclude_file = []
  exclude_regex = ["_test.go"]
  exclude_unchanged = false
  follow_symlink = false
  full_bin = ""
  include_dir = []
  include_ext = ["go", "tpl", "tmpl", "html"]
  kill_delay = "0s"
  log = "build-errors.log"
  send_interrupt = false
  stop_on_error = true

[color]
  app = ""
  build = "yellow"
  main = "magenta"
  runner = "green"
  watcher = "cyan"

[log]
  time = false

[misc]
  clean_on_exit = false

基础镜像	镜像大小	构建时间	启动时间	内存占用
golang:1.21	~900MB	2m 30s	1.5s	50MB
golang:1.21-alpine	~300MB	2m 00s	1.2s	40MB
多阶段 + alpine	~20MB	2m 10s	0.8s	35MB
多阶段 + distroless	~10MB	2m 15s	0.7s	30MB
多阶段 + scratch	~5MB	2m 20s	0.5s	25MB

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
# syntax=docker/dockerfile:1.4

FROM golang:1.21-alpine AS builder

# 使用缓存挂载加速依赖下载
RUN --mount=type=cache,target=/go/pkg/mod \
    go mod download

# 使用缓存挂载加速构建
RUN --mount=type=cache,target=/root/.cache/go-build \
    go build -o main .

▾代码块
Bash自动换行
1
DOCKER_BUILDKIT=1 docker build -t myapp .

▾代码块
Bash自动换行
1
2
3
4
5
6
# 使用 Trivy 扫描漏洞
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \
  aquasec/trivy image myapp:latest

# 使用 Snyk
snyk container test myapp:latest

▾代码块
Bash自动换行
1
2
3
4
5
6
7
8
# 启用 Docker Content Trust
export DOCKER_CONTENT_TRUST=1

# 推送签名镜像
docker push myapp:latest

# 拉取时自动验证
docker pull myapp:latest

▾代码块
DOCKERFILE自动换行
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 生产环境推荐配置
FROM golang:1.21-alpine AS builder
RUN apk add --no-cache git ca-certificates tzdata
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-w -s" -o main .

FROM alpine:latest
RUN apk add --no-cache ca-certificates tzdata && \
    adduser -D -u 1001 appuser
WORKDIR /app
COPY --from=builder /app/main .
USER appuser
EXPOSE 8080
HEALTHCHECK --interval=30s CMD wget -q --spider http://localhost:8080/health || exit 1
CMD ["./main"]

🐹 Golang 后端服务 Dockerfile 编写完整教程

📑 目录

🎯 基础入门

最简单的 Dockerfile

🚀 多阶段构建（推荐）

基础多阶段构建

🏆 生产级优化

完整优化版本

📦 不同场景的 Dockerfile

1. 使用 Distroless（最小化镜像）

2. 使用 Scratch（极致精简）

3. 包含 CGO 依赖

4. 包含静态资源和配置

🎨 最佳实践

1. 利用构建缓存

2. 使用 .dockerignore

3. 优化编译参数

4. 多架构支持

5. 添加健康检查

6. 环境变量管理

🔧 实战案例

案例 1: Web API 服务

案例 2: gRPC 服务

案例 3: 定时任务服务

案例 4: 微服务（包含数据库迁移）

🛠️ 构建和运行

基本构建

带构建参数

使用 docker-compose

🔍 镜像优化技巧

1. 查看镜像层

2. 镜像体积对比

3. 构建缓存优化

❓ 常见问题

Q1: 时区问题

Q2: CA 证书问题（HTTPS 请求失败）

Q3: 静态文件路径问题

Q4: 数据库连接问题

Q5: 热重载（开发环境）

📊 性能基准测试

不同基础镜像的性能对比

🎓 进阶话题

1. 使用 BuildKit 特性

2. 安全扫描

3. 签名和验证

📚 参考资源

🎉 总结

快速检查清单

推荐配置

关于作者

评论 (0)