首先编写Dockerfile,再构建镜像并运行容器。具体步骤:准备可运行的Go Web项目,创建多阶段Dockerfile,使用golang:1.21-alpine编译,alpine镜像运行,COPY代码并构建二进制,EXPOSE 8080,CMD启动应用;执行docker build -t go-web-app .构建镜像,docker run -p 8080:8080 go-web-app运行容器,访问localhost:8080验证;建议添加.dockerignore,固定基础镜像标签,结合docker-compose管理复杂服务,提升可移植性与部署效率。

将你的Golang Web应用容器化并使用Docker运行,其实并不复杂。核心是编写一个合适的 Dockerfile,构建镜像,然后通过 Docker 启动容器。下面一步步说明如何操作。
准备你的Golang Web项目
确保你的Golang Web应用可以正常运行。比如你有一个简单的 HTTP 服务:
package main
<p>import (
"fmt"
"net/http"
)</p><p>func handler(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Hello from Go 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,访问 http://localhost:8080 看是否输出欢迎信息。
编写Dockerfile
在项目根目录创建名为 Dockerfile 的文件(无后缀),内容如下:
立即学习“go语言免费学习笔记(深入)”;
# 使用官方 Golang 镜像作为构建基础
FROM golang:1.21-alpine AS builder
<h1>设置工作目录</h1><p>WORKDIR /app</p><h1>复制 go.mod 和 go.sum(如果有)</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><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/ai/1026" title="闪念贝壳"><img
src="https://img.php.cn/upload/ai_manual/000/000/000/175680028066678.png" alt="闪念贝壳" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/ai/1026" title="闪念贝壳">闪念贝壳</a>
<p>闪念贝壳是一款AI 驱动的智能语音笔记,随时随地用语音记录你的每一个想法。</p>
</div>
<a href="/ai/1026" title="闪念贝壳" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><h1>从构建阶段复制二进制文件</h1><p>COPY --from=builder /app/main .</p><h1>声明端口</h1><p>EXPOSE 8080</p><h1>启动命令</h1><p>CMD ["./main"]</p>这个 Dockerfile 使用了多阶段构建,先在 golang 镜像中编译,再将可执行文件复制到轻量的 Alpine 镜像中运行,这样可以显著减小最终镜像体积。
构建并运行Docker镜像
在终端中,进入项目目录,执行以下命令:
- docker build -t go-web-app . —— 构建镜像,命名为 go-web-app
- docker run -p 8080:8080 go-web-app —— 启动容器,将主机 8080 映射到容器 8080
如果一切顺利,你会看到输出 “Server starting on :8080”,然后在浏览器访问 http://localhost:8080,看到你的 Go 应用返回的消息。
优化与实用建议
- 使用 .dockerignore 文件排除不必要的文件(如 vendor、.git、本地配置等)
- 可以在 CMD 中使用 ./main -port=8080 支持命令行参数
- 生产环境中建议使用更具体的标签,如 golang:1.21,避免使用 latest
- 可结合 docker-compose.yml 简化启动流程,尤其当依赖数据库等其他服务时
基本上就这些。一旦容器化成功,你的 Go Web 应用就可以在任何支持 Docker 的环境中一致运行,极大提升部署效率和可移植性。









