Fiber Web框架怎么打包并部署到Docker容器-Golang-PHP中文网

应采用多阶段构建：第一阶段用golang:1.23-alpine编译，CGO_ENABLED=0 GOOS=linux生成静态二进制；第二阶段用alpine:latest运行，仅复制二进制和ca-certificates，镜像小于15MB且安全稳定。

fiber web框架怎么打包并部署到docker容器

直接用 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 工具链。

Docker Encyclopedia

Docker 文档优先工作流：针对 Docker 特定问题、故障排除、命令规划、镜像/构建、容器/运行时操作及 Compose 等

下载

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 强杀。这个细节在压测或滚动更新时才会暴露，但修复只要加几行信号监听代码，别等上线后才发现连接泄漏。