先编写Golang HTTP服务程序,再通过多阶段Dockerfile构建轻量镜像,使用golang:1.21-alpine编译并复制到alpine运行,暴露8080端口,最终构建并运行容器,实现高效可移植部署。

Go语言(Golang)与Docker结合是现代微服务和云原生应用开发的常见实践。使用Docker构建Golang应用能实现环境一致性、简化部署流程并提升可移植性。下面介绍如何将一个简单的Golang程序打包成Docker镜像并运行。
1. 编写基础Golang程序
先创建一个最简单的HTTP服务作为示例:
package mainimport ( "fmt" "net/http" )
func handler(w http.ResponseWriter, r *http.Request) { fmt.Fprintf(w, "Hello from Golang in Docker!") }
func main() { http.HandleFunc("/", handler) fmt.Println("Server starting on :8080") http.ListenAndServe(":8080", nil) }
保存为 main.go,在本地可通过 go run main.go 测试是否正常运行。
2. 编写Dockerfile
在项目根目录创建名为 Dockerfile 的文件,内容如下:
立即学习“go语言免费学习笔记(深入)”;
# 使用官方Golang镜像作为构建基础 FROM golang:1.21-alpine AS builder设置工作目录
WORKDIR /app
复制go mod相关文件
COPY go.mod go.sum ./ RUN go mod download
复制源码
COPY . .
构建静态二进制文件
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o main .
第二阶段:使用轻量基础镜像运行
FROM alpine:latest RUN apk --no-cache add ca-certificates
WORKDIR /root/
从上一阶段复制可执行文件
COPY --from=builder /app/main .
暴露端口
EXPOSE 8080
启动命令
CMD ["./main"]
这个Dockerfile采用多阶段构建:
- 第一阶段使用golang镜像编译程序,生成静态可执行文件
- 第二阶段使用极小的alpine镜像运行,减少最终镜像体积
- 关闭CGO确保静态链接,避免运行时依赖
3. 构建Docker镜像
在终端执行以下命令构建镜像:
docker build -t golang-app .
构建成功后可通过 docker images | grep golang-app 查看生成的镜像。
4. 运行容器
启动容器并映射端口:
docker run -d -p 8080:8080 --name my-go-app golang-app
访问 http://localhost:8080 应能看到输出信息。使用 docker logs my-go-app 可查看日志。
5. 优化建议
- 使用
.dockerignore排除不必要的文件(如vendor、.git) - 生产环境考虑使用更安全的基础镜像如distroless
- 通过ARG设置版本标签便于追踪
- 添加健康检查指令HEALTHCHECK
基本上就这些,不复杂但容易忽略细节。只要保证编译环境与运行环境分离,就能构建出高效、小巧的Golang容器镜像。










