必须用redis.NewClusterClient()配置TLS,因NewClient()不解析CLUSTER SLOTS、不处理MOVED/ASK、不映射key→slot,即使加TLS也仅作用于首节点,重定向后请求裸连导致MOVED错误;TLS需通过Dialer显式配置,所有节点端口与证书必须一致。

必须用 redis.NewClusterClient() + TLS 配置,redis.NewClient() 连集群必报 MOVED 或连接拒绝;不配 TLS 时明文传输敏感数据(如 session、token)存在泄露风险。
为什么不能用 NewClient() 配 TLS 连集群
即使加了 TLS,redis.NewClient() 仍不具备集群能力:它不会解析 CLUSTER SLOTS,不计算 key → slot 映射,也不处理 MOVED/ASK 响应。你传入的 TLSConfig 会被忽略或仅作用于首个节点,后续重定向请求直接裸连——结果就是 TLS 握手成功但命令失败,错误信息仍是 redis: MOVED 12345 10.0.1.5:6379。
常见误操作包括:
- 把单机 TLS 示例代码照搬进集群场景
- 只给
Addrs中第一个地址配 TLS,其余节点走明文 - 用
redis://URL 格式传入Addrs,导致 TLS 配置被解析器丢弃
ClusterOptions 中正确启用 TLS 的写法
redis.NewClusterClient() 的 TLS 支持依赖 Dialer 字段,不是靠全局 TLSConfig。每个节点连接都需显式封装 TLS dial 逻辑。
立即学习“go语言免费学习笔记(深入)”;
关键点:
-
Addrs必须是纯host:port格式,例如[]string{"10.0.1.1:6380", "10.0.1.2:6380"},不能含redis://或数据库编号 -
Dialer函数里用tls.Dial替代net.Dial,并传入自定义*tls.Config - 若服务端证书是私有 CA 签发,必须在
tls.Config.RootCAs中加载对应 CA 证书 - 不建议设
InsecureSkipVerify: true,生产环境应校验域名和证书链
示例片段:
opt := &redis.ClusterOptions{
Addrs: []string{"10.0.1.1:6380", "10.0.1.2:6380"},
Password: "mypass",
Dialer: func(ctx context.Context, network, addr string) (net.Conn, error) {
return tls.Dial(network, addr, &tls.Config{
RootCAs: rootCAPool, // 加载了 CA 证书的 *x509.CertPool
ServerName: "redis-cluster.example.com", // 匹配证书 SAN
})
},
}
ReadOnly 和 RouteByLatency 在 TLS 下的行为不变
TLS 只加密传输层,不影响客户端路由逻辑。但要注意:
- 启用了
ReadOnly: true后,读请求可能落到从节点——这些节点也必须配置相同的 TLS 端口和证书,否则连接会失败 -
RouteByLatency: true会定期发起探测请求(类似 PING),这些请求同样走 TLS,若某节点 TLS 配置不一致(如证书过期、SNI 不匹配),会导致拓扑刷新失败或延迟误判 - 所有节点的 TLS 端口需统一(如全用 6380),避免客户端初始化时部分节点因端口错误无法完成 TLS 握手而卡住
调试 TLS 集群连接失败的优先顺序
连不上时,别先查 Go 代码,按这个顺序确认:
- 用
redis-cli -c --tls --cert client.crt --key client.key -h 10.0.1.1 -p 6380 ping测试单节点 TLS 是否通(注意-c参数) - 执行
redis-cli -c --tls ... cluster nodes,确认输出中所有节点状态为connected且有完整 master/slave 关系 - 检查 Go 日志是否含
x509: certificate is valid for ... not ...—— 这说明ServerName配错了 - 抓包看 TLS 握手是否完成:若
Client Hello发出后无响应,问题在服务端防火墙或 Redis 配置(如tls-port未启用)
最易被忽略的是:Redis 集群各节点的 TLS 配置必须完全一致,包括证书、密钥、CA、协议版本(建议禁用 TLS 1.0/1.1),任一节点偏差都会导致客户端拓扑初始化中断。


















