Kubernetes部署Redis集群后外部Python客户端连接问题排查

你的问题核心是Redis集群默认会向客户端返回内部Pod的域名或IP，而外部客户端无法访问这些内部地址，导致解析失败、重定向超时或连接挂起。完全不需要在所有客户端机器配置/etc/hosts，以下是更合理的解决方案：

1. 让Redis节点公告外部可访问地址 #

Redis集群启动时，默认会使用Pod的内部IP和端口向集群注册自己。你需要修改Redis的启动参数，让每个节点公告外部客户端能访问的IP和端口：

redis-server /etc/redis/redis.conf \
  --cluster-enabled yes \
  --cluster-config-file nodes.conf \
  --cluster-announce-ip <节点的外部IP（如Node的公网IP）> \
  --cluster-announce-port <外部暴露的Redis端口（如NodePort）> \
  --cluster-announce-bus-port <外部暴露的集群总线端口（如NodePort+10000）>

这样Redis集群返回给客户端的重定向地址就是外部可访问的，不会再出现内部IP无法访问的问题。

2. 正确暴露所有Redis集群节点 #

Redis集群要求每个节点都能被客户端直接访问，不能只暴露一个入口：

• 用Headless Service维护集群内部的DNS解析（供集群初始化使用）：

  apiVersion: v1
  kind: Service
  metadata:
    name: redis-cluster-headless
  spec:
    clusterIP: None
    ports:
    - port: 6379
      name: redis
    - port: 16379
      name: redis-bus
    selector:
      app: redis-cluster
  

• 为每个Redis节点创建NodePort Service（或用StatefulSet固定每个Pod的NodePort范围），确保每个节点的6379（业务端口）和16379（集群总线端口）都能被外部访问。

3. 调整pyredis客户端配置 #

使用RedisCluster连接时，注意两个关键配置：

• 初始化时传入外部可访问的节点地址列表，不要用内部域名
• 添加skip_full_coverage_check=True，避免首次连接时因无法访问内部节点导致进程挂起
  示例代码：

from redis.cluster import RedisCluster

# 替换为你的外部IP和NodePort
startup_nodes = [{"host": "192.168.1.100", "port": 30000}]
rc = RedisCluster(
    startup_nodes=startup_nodes,
    decode_responses=True,
    skip_full_coverage_check=True
)

4. 修复redis-cli -c的连接问题 #

用redis-cli -c连接时，必须指定外部可访问的地址，而不是内部Service域名。如果还是遇到重定向超时，检查对应节点的外部端口是否开放，以及防火墙规则是否允许客户端访问这些端口。

内容的提问来源于stack exchange，提问作者Emad Helmi