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

Go语言(Golang)与Docker结合是现代微服务和云原生应用开发的常见实践。使用Docker构建Golang应用能实现环境一致性、简化部署流程并提升可移植性。下面介绍如何将一个简单的Golang程序打包成Docker镜像并运行。
1. 编写基础Golang程序
先创建一个最简单的HTTP服务作为示例:
package main
<p>import (
"fmt"
"net/http"
)</p><p>func handler(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Hello from Golang in Docker!")
}</p><p>func main() {
http.HandleFunc("/", handler)
fmt.Println("Server starting on :8080")
http.ListenAndServe(":8080", nil)
}</p>保存为 main.go,在本地可通过 go run main.go 测试是否正常运行。
2. 编写Dockerfile
在项目根目录创建名为 Dockerfile 的文件,内容如下:
立即学习“go语言免费学习笔记(深入)”;
# 使用官方Golang镜像作为构建基础
FROM golang:1.21-alpine AS builder
<h1>设置工作目录</h1><p>WORKDIR /app</p><h1>复制go mod相关文件</h1><p>COPY go.mod go.sum ./
RUN go mod download</p><h1>复制源码</h1><p>COPY . .</p><h1>构建静态二进制文件</h1><p>RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o main .</p><h1>第二阶段:使用轻量基础镜像运行</h1><p>FROM alpine:latest
RUN apk --no-cache add ca-certificates</p><p>WORKDIR /root/</p><h1>从上一阶段复制可执行文件</h1><p>COPY --from=builder /app/main .</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/ai/1403" title="VALL-E"><img
src="https://img.php.cn/upload/ai_manual/001/431/639/68b6d143e9a70406.jpeg" alt="VALL-E" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/ai/1403" title="VALL-E">VALL-E</a>
<p>VALL-E是一种用于文本到语音生成 (TTS) 的语言建模方法</p>
</div>
<a href="/ai/1403" title="VALL-E" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><h1>暴露端口</h1><p>EXPOSE 8080</p><h1>启动命令</h1><p>CMD ["./main"]</p>这个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容器镜像。









