本文是一份实战指南，旨在帮助开发者掌握如何使用 Docker Compose 高效编排 Golang 微服务。文章详细介绍了通过 `docker-compose.yml` 文件定义多服务，实现服务构建、网络互联、环境配置等功能。重点讲解了服务间如何通过容器名进行通信，极大简化本地开发与测试流程。通过构建 `user-service` 和 `auth-service` 两个 Golang 服务示例，并结合 Dockerfile 和 docker-compose 配置，演示了如何使用 Docker Compose 启动、管理和维护多个服务。掌握本文内容，开发者可以轻松实现 Golang 微服务的容器化编排，提升开发效率，为后续迁移至 Kubernetes 等生产环境打下坚实基础。

使用Docker Compose可高效编排Golang微服务，通过定义docker-compose.yml文件实现多服务构建、网络互通与环境配置，支持服务间通过容器名通信，简化本地开发与测试流程。

在使用 Go（Golang）开发微服务架构时，通常会涉及多个服务协同工作。Docker 配合 docker-compose 是实现多服务编排的轻量级解决方案。下面介绍如何用 Golang 构建多个服务，并通过 Docker Compose 进行统一管理。

编写多个 Golang 服务

假设有两个简单的 Go 服务：

• user-service：提供用户信息 API
• auth-service：处理认证逻辑

每个服务都有自己的 main.go 和 Dockerfile。

示例：user-service/main.go

package main
import (
"encoding/json"
"net/http"
"log"
)
func main() {
http.HandleFunc("/user", func(w http.ResponseWriter, r *http.Request) {
json.NewEncoder(w).Encode(map[string]string{
"id":   "1",
"name": "John Doe",
})
})
log.Println("User service starting on :8080")
log.Fatal(http.ListenAndServe(":8080", nil))
}

为每个服务创建独立的 Dockerfile：

FROM golang:1.21-alpine AS builder
WORKDIR /app
COPY . .
RUN go build -o user-svc .
FROM alpine:latest
RUN apk --no-cache add ca-certificates
WORKDIR /root/
COPY --from=builder /app/user-svc .
EXPOSE 8080
CMD ["./user-svc"]

auth-service 的结构类似，监听在 :9000 端口。

使用 docker-compose.yml 编排服务

在项目根目录创建 docker-compose.yml，定义多个服务及其依赖关系。

version: '3.8'
services:
user-service:
build:
context: ./user-service
dockerfile: Dockerfile
ports:

• "8080:8080" environment:
• ENV=development

auth-service: build: context: ./auth-service dockerfile: Dockerfile ports:

• "9000:9000" environment:
• ENV=development

可选：加入数据库或其他中间件

redis: image: redis:alpine ports:

• "6379:6379"

这个配置会：

• 从各自目录构建镜像
• 暴露端口供外部访问
• 支持环境变量注入
• 自动建立默认网络，服务间可通过服务名通信（如 user-service 调用 http://auth-service:9000/login）

服务间通信示例

如果 user-service 需要调用 auth-service 验证 token，可以直接使用服务名作为主机名：

resp, err := http.Get("http://auth-service:9000/validate?token=xxx")
if err != nil {
    // 处理错误（注意：容器网络中服务名即 DNS 名）
}

Docker Compose 会自动设置内网 DNS，使服务可通过名称互相访问。

启动与管理多服务

在项目根目录运行：

docker-compose up -d --build

这会：

• 构建每个服务的镜像（如有变更）
• 启动所有容器
• 后台运行（-d）

查看日志：

docker-compose logs -f user-service

停止服务：

docker-compose down

基本上就这些。对于本地开发和测试，Docker Compose 提供了简洁高效的多服务编排方式。Go 服务轻量、启动快，非常适合这种模式。生产环境可进一步迁移到 Kubernetes，但开发阶段用 Compose 完全够用。

到这里，我们也就讲完了《GolangDocker多服务编排实战教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！