应采用多阶段构建：第一阶段用golang:1.23-alpine编译，CGO_ENABLED=0 GOOS=linux生成静态二进制；第二阶段用alpine:latest运行，仅复制二进制和ca-certificates，镜像小于15MB且安全稳定。
直接用 go build 编译成静态二进制，再塞进 alpine:latest 这类极小基础镜像里，是 Fiber 应用 Docker 化最稳、最轻、最不易出错的方式。别用 golang:latest 镜像直接跑，那不是部署，是开发环境误入生产。
为什么不能直接 COPY . /app && go run main.go？
这是新手最容易踩的坑：在 Dockerfile 里用 golang 镜像 + go run 启动，会导致镜像体积暴涨（>1GB）、启动慢、存在未编译的源码和调试工具，且 Go 编译器本身根本不需要出现在生产容器中。
-
golang镜像只用于构建阶段，不是运行阶段 - Fiber 基于
fasthttp，完全静态链接，CGO_ENABLED=0 go build即可产出免依赖二进制 - 最终运行镜像里只需要
/app/server和必要配置文件，其余全是冗余
Dockerfile 必须分两阶段：build + runtime
标准多阶段构建能彻底隔离编译环境与运行环境，生成小于 15MB 的终态镜像。关键点在于第二阶段不带任何 Go 工具链。
FROM golang:1.23-alpine AS builder WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . RUN CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-extldflags "-static"' -o server . FROM alpine:latest RUN apk --no-cache add ca-certificates WORKDIR /root/ COPY --from=builder /app/server . EXPOSE 3000 CMD ["./server"]
-
CGO_ENABLED=0是必须项，否则二进制会动态链接 libc，无法在 alpine 上运行 -
GOOS=linux显式指定目标系统，避免本地 macOS/Windows 构建失败 -
alpine镜像不含 bash，CMD ["./server"]必须用 exec 形式，不能写CMD ./server（shell 形式会失败）
构建和运行时常见错误现象
镜像跑起来但报错 standard_init_linux.go:228: exec user process caused: no such file or directory，90% 是因为没加 CGO_ENABLED=0；报 address already in use 则大概率是代码里硬编码了 :3000，而容器已通过 EXPOSE 或 -p 映射该端口，导致冲突。
- Fiber 启动时应读取环境变量：
app.Listen(os.Getenv("PORT"))，而非固定写死app.Listen(":3000") - 构建命令必须指定输出路径一致：
go build -o server .，否则COPY --from=builder找不到文件 - 如果用了
fiber.Config{Prefork: true}，需确认宿主机是否开启net.ipv4.ip_unprivileged_port_start=0，否则容器内无法绑定 1024 以下端口
真正麻烦的从来不是写 Dockerfile，而是忘记 Fiber 默认不自动处理信号转发——比如你用 docker stop 杀容器，进程可能没机会执行 app.Shutdown() 就被 SIGKILL 强杀。这个细节在压测或滚动更新时才会暴露，但修复只要加几行信号监听代码，别等上线后才发现连接泄漏。
