本文详解如何通过Docker Compose实现容器间HTTP通信的API网关模式：以单入口api服务统一代理请求，后端微服务（如goapp、user-svc）不暴露公网端口，仅通过自定义桥接网络内网互通，并利用服务名自动DNS解析完成可靠调用。
本文详解如何通过docker compose实现容器间http通信的api网关模式：以单入口`api`服务统一代理请求，后端微服务（如`goapp`、`user-svc`）不暴露公网端口，仅通过自定义桥接网络内网互通，并利用服务名自动dns解析完成可靠调用。
在微服务架构中，API网关作为唯一对外暴露的HTTP入口，承担路由分发、鉴权限流、可观测性埋点等核心职责。而真正落地的关键，在于容器网络的合理设计与服务发现机制的轻量集成——而非依赖过时的--link参数或环境变量硬编码。Docker Compose正是解决这一问题的标准化方案。
✅ 推荐实践：基于自定义网络的声明式服务编排
Docker Compose默认创建一个用户定义的bridge网络（如mynetwork_default），所有服务自动加入该网络，并可通过服务名直接解析为对应容器IP（内置DNS）。这完全替代了已废弃的--link机制，且无需手动管理环境变量映射。
以下是一个生产就绪的docker-compose.yml示例，包含网关、业务服务、缓存与数据库：
version: '3.8'
services:
# API网关：唯一对外暴露端口（80/443）
api-gateway:
image: myorg/gateway:latest
build:
context: ./gateway
dockerfile: Dockerfile.multi-stage
ports:
- "80:80"
- "443:443"
environment:
- ETCD_ADDR=etcd:2379
- GIN_MODE=release
depends_on:
- etcd
- goapp
- user-svc
networks:
- gateway-net
# 业务微服务：仅内网可达，不暴露端口
goapp:
image: myorg/goapp:latest
build: ./goapp
environment:
- REDIS_ADDR=redis:6379
- MYSQL_ADDR=mysql:3306
networks:
- gateway-net
# 用户服务（含会话校验）：被其他服务按需链接
user-svc:
image: myorg/user-svc:latest
build: ./user-svc
networks:
- gateway-net
# 注册中心：支撑动态服务发现
etcd:
image: quay.io/coreos/etcd:v3.5.15
command: etcd --advertise-client-urls http://etcd:2379 --listen-client-urls http://0.0.0.0:2379
ports:
- "2379:2379"
networks:
- gateway-net
# 基础设施：Redis与MySQL保持内网通信
redis:
image: redis:7-alpine
networks:
- gateway-net
mysql:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: rootpass
networks:
- gateway-net
# 显式定义隔离网络，强化安全边界
networks:
gateway-net:
driver: bridge
internal: false # 允许网关访问外网（如OAuth回调）? 关键设计说明：
立即学习“go语言免费学习笔记（深入）”；
- 所有服务共用
gateway-net网络，api-gateway可直接通过http://goapp:8080/api/orders访问业务服务；internal: false保证网关能发起外部调用（如支付回调、邮件服务），而goapp等后端服务默认无法主动连外网，符合最小权限原则；depends_on仅控制启动顺序，不保证服务就绪；网关需实现健康检查重试逻辑（如用github.com/cenkalti/backoff/v4）。
⚙️ 网关代码中的容器友好配置要点
在Golang网关实现中，需显式适配容器网络特性：
// 1. 使用服务名作为后端地址（非localhost！）
backendURL, _ := url.Parse("http://goapp:8080") // ✅ 正确：Docker DNS自动解析
// backendURL, _ := url.Parse("http://localhost:8080") // ❌ 错误：localhost指向网关自身
// 2. 定制Transport防止连接耗尽（生产必备）
transport := &http.Transport{
DialContext: (&net.Dialer{
Timeout: 5 * time.Second,
KeepAlive: 30 * time.Second,
}).DialContext,
IdleConnTimeout: 30 * time.Second,
TLSHandshakeTimeout: 5 * time.Second,
MaxIdleConnsPerHost: 100,
}
proxy := httputil.NewSingleHostReverseProxy(backendURL)
proxy.Transport = transport
// 3. Director中重写Host头，确保后端识别真实服务名
proxy.Director = func(req *http.Request) {
req.URL.Scheme = "http"
req.URL.Host = "goapp:8080" // 保持与Parse一致
req.Host = "goapp" // 关键：避免Nginx等LB因Host不匹配拒绝
req.Header.Set("X-Forwarded-For", getClientIP(req))
}? 注意事项与避坑指南
-
禁止使用
--link和--env-file传递地址：Docker已弃用--link，且环境变量无法动态感知服务扩缩容； -
不要在Go代码中硬编码
localhost：容器内localhost指向本容器，而非宿主机或其他容器； -
健康检查必须独立于DNS解析：服务名解析成功 ≠ 服务已就绪，需在网关启动后轮询
/health接口； -
HTTPS终结建议在网关层完成：让
api-gateway处理TLS卸载，后端服务统一走HTTP内网通信，降低复杂度； -
日志与监控对齐容器标准：所有日志输出到
stdout/stderr，由Docker日志驱动（如fluentd）统一采集；指标暴露/metrics端点供Prometheus抓取。
通过Docker Compose声明式编排 + Go定制化反向代理，你将获得一个轻量、可控、可观察的API网关基础设施——它不依赖Kubernetes，却已具备微服务治理的核心能力。真正的网关价值，不在于功能堆砌，而在于以最简路径实现流量可控、故障隔离与演进自由。
