Fiber是Go Web框架，需在Docker构建时通过go mod引入并编译进二进制，不可在容器内安装；关键点包括：确保go.mod/go.sum提交、用多阶段构建、设CGO_ENABLED=0和GOOS=linux、监听0.0.0.0而非127.0.0.1、合理配置BodyLimit防OOM。
Fiber 不是通过 docker install 或包管理器在容器里“安装”的——它是一个 Go 语言 Web 框架，必须在构建镜像时作为 Go 依赖编译进二进制文件。Docker 容器里没有、也不该有 go install fiber 这种操作。
你真正要做的，是把一个用 Fiber 写的 Go 程序，用 Docker 打包成可运行的镜像。下面分几步说清关键动作和容易翻车的地方。
Go 项目里正确引入 Fiber 依赖
确保你的 main.go 中已用标准方式导入：
import "github.com/gofiber/fiber/v2"并且项目根目录下有
go.mod 文件（没有就先 go mod init your-app-name）。go mod tidy 后，go.sum 和 go.mod 必须一起提交到代码仓库——否则 Docker 构建时会拉不到 fiber/v2 的确切版本，报错 require github.com/gofiber/fiber/v2: version "v2.x.x" invalid 或直接找不到模块。
Dockerfile 必须用多阶段构建
直接 FROM golang 然后 RUN go build 再 FROM alpine 拷二进制，是常见但低效写法；推荐一步到位的多阶段写法：
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 -a -ldflags '-extldflags "-static"' -o /app/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和GOOS=linux是必须的，否则生成的二进制可能依赖宿主机 libc，在 Alpine 上直接exec format error - 不要用
FROM scratch除非你确认没调任何系统 DNS 或 TLS 相关逻辑——Fiber默认用net/http底层，某些场景会触发对/etc/resolv.conf的读取，scratch镜像里没有这个文件就会 panic -
EXPOSE 3000只是文档提示，真正生效靠docker run -p 8080:3000映射
容器启动后 Fiber 服务访问不到？检查监听地址
Fiber 默认绑定 127.0.0.1:3000，这在容器里等于只允许 localhost 访问，外部根本连不上。必须显式改成 0.0.0.0:3000：
app := fiber.New()
log.Fatal(app.Listen(":3000")) // ✅ 正确：等价于 0.0.0.0:3000
// log.Fatal(app.Listen("127.0.0.1:3000")) // ❌ 容器内无效
另外，如果你在 Listen 里写了具体 IP（比如 "192.168.1.100:3000"），构建出来的镜像就彻底绑死该 IP，失去可移植性。
本地验证与生产部署的差异点
本地 docker run -p 8080:3000 your-fiber-app 能通，不代表上 Kubernetes 就行。注意两个现实约束：
- K8s Pod 的 readiness probe 如果用
httpGet，路径必须返回 200，建议加个GET /health路由并用app.Get("/health", func(c *fiber.Ctx) error { return c.SendStatus(200) }) - 容器内存限制低于 16MB 时，
Fiber的默认BodyLimit（4MB）和ReadBufferSize（4KB）可能触发 OOM kill，建议在fiber.Config里主动调小：fiber.Config{BodyLimit: 2 << 20, ReadBufferSize: 2048}
