本文详解如何让 docker 包装的 go 程序通过默认端口（6379）可靠连接同一 docker 网络中的官方 redis 容器，涵盖网络配置、连接地址写法、常见误区及验证方法。
在现代容器化开发中，Go 应用与 Redis 的协同部署十分常见。但许多开发者会遇到一个典型问题：本地 redis-cli 能成功连接 Redis 容器，而 Go 应用却报“connection refused”或“no route to host”——这通常并非代码或 Redis 配置错误，而是容器间网络通信配置不当所致。
✅ 正确做法：使用用户自定义桥接网络（推荐）
Docker 已弃用 --link（自 Docker 1.10+ 起标记为 legacy），其 DNS 解析行为受限且不支持跨网络通信。应改用 用户定义的桥接网络（user-defined bridge network），它自动提供容器名作为可解析的 DNS 主机名：
# 1. 创建专用网络 docker network create app-network # 2. 启动 Redis 容器并加入该网络（无需暴露端口给宿主机） docker run -d \ --name redis \ --network app-network \ -e REDIS_PASSWORD="" \ redis:7-alpine # 3. 启动 Go 应用容器，同样加入同一网络 docker run -d \ --name go-app \ --network app-network \ -e REDIS_URL="redis://redis:6379" \ your-go-app-image
此时，在 Go 程序中，只需将 Redis 连接地址设为 redis://redis:6379（注意：redis 是容器名，非 localhost 或 127.0.0.1）：
package main
import (
"context"
"log"
"time"
"github.com/go-redis/redis/v8"
)
var rdb *redis.Client
func initRedis() {
rdb = redis.NewClient(&redis.Options{
Addr: "redis:6379", // ✅ 关键：使用容器名 + 默认端口
Password: "", // 根据实际设置密码
DB: 0,
})
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
if err := rdb.Ping(ctx).Err(); err != nil {
log.Fatalf("Failed to connect to Redis: %v", err)
}
log.Println("✅ Connected to Redis successfully")
}⚠️ 常见错误与注意事项
❌ 错误写法：redis://localhost:6379 或 redis://127.0.0.1:6379
→ 在容器内，localhost 指向自身，而非 Redis 容器。❌ 避免使用 --link：该参数已过时，不支持用户定义网络，DNS 解析不可靠，且无法实现多容器服务发现。
✅ 必须确保两容器处于同一用户定义网络（如 app-network）。默认 bridge 网络不支持容器名解析。
? 若 Redis 启用了密码认证，请在连接字符串中添加 ?password=yourpass，或在 redis.Options 中设置 Password 字段。
-
? 验证连通性（调试时）：
# 进入 Go 容器调试 docker exec -it go-app sh # 尝试 ping 和 telnet（需安装 busybox 或 netcat） ping -c 3 redis telnet redis 6379
✅ 总结
让 Docker 化 Go 程序连接 Redis 的核心原则是：利用 Docker 内置 DNS 实现基于容器名的服务发现。只要 Redis 与 Go 应用运行在同一个用户定义网络中，即可直接使用 redis://<container-name>:6379 连接，无需端口映射、无需 --link、无需硬编码 IP。这是符合 Docker 最佳实践、可移植性强且易于扩展的方案。
