本文介绍如何通过 docker 的 entrypoint 指令以可执行方式向容器内 go 程序安全、灵活地传递命令行选项，避免硬编码并保持 cli 接口一致性。
在 Docker 化 Go 应用时，常需在运行容器时动态传入配置参数（如 -port=8080、-env=prod），而非将参数固化在镜像中。正确做法是利用 Docker 的 exec 形式 ENTRYPOINT（即 JSON 数组格式），它能将 docker run 后的额外参数原样追加到入口命令末尾，从而实现与本地 Go 二进制调用一致的体验。
✅ 推荐方案：使用 exec 形式 ENTRYPOINT
假设你的 Go 程序已通过 go install 编译为 /go/bin/myapp，Dockerfile 应如下编写：
FROM golang:1.22-alpine # 构建阶段建议分离（生产镜像推荐多阶段构建，此处为简洁演示） RUN go install github.com/yourname/myapp@latest # 关键：ENTRYPOINT 必须使用 exec 格式（JSON 数组） ENTRYPOINT ["/go/bin/myapp"]
构建并运行时，即可自由传参：
docker build -t myapp . docker run --rm myapp -port=3000 -debug=true
此时容器内实际执行的是：
/go/bin/myapp -port=3000 -debug=true
⚠️ 注意：务必使用 ENTRYPOINT ["binary"]（数组形式），而非 ENTRYPOINT binary（shell 形式）。后者会启动 /bin/sh -c，导致 os.Args 解析异常（Args[0] 变为 sh），且无法正确接收 docker run 后的参数。
? 进阶技巧：预设默认参数（可选）
若需提供默认选项（如固定日志级别），可在 ENTRYPOINT 中预置，但仍保留用户覆盖能力：
ENTRYPOINT ["/go/bin/myapp", "-log-level=info"]
运行 docker run myapp -log-level=debug -port=8080 时，最终参数为：
/go/bin/myapp -log-level=info -log-level=debug -port=8080
⚠️ 注意：Go 默认 flag 包对重复键采用后覆盖前策略，因此 -log-level=debug 会生效——但更健壮的做法是避免预设冲突参数，或改用 -- 显式分隔（需程序支持）。
? 最佳实践总结
- ✅ 始终使用 ENTRYPOINT ["binary"] exec 格式，确保 os.Args 行为与本地一致；
- ✅ 避免 CMD 单独设置参数（易被覆盖），ENTRYPOINT + CMD 组合仅适用于固定子命令场景；
- ✅ 生产环境推荐多阶段构建，减小镜像体积（例如 FROM golang AS builder → FROM alpine）；
- ✅ 在 Go 程序中使用标准 flag 包，并通过 flag.Parse() 正确解析，无需额外适配 Docker。
通过以上方式，你的 Docker 化 Go 应用既能保持原生 CLI 体验，又具备容器化部署所需的灵活性与可维护性。
