如何通过EC2堡垒机用Python+redis-py-cluster连接AWS ElastiCache集群？

核心问题原因 #

通过SSH隧道将ElastiCache集群端口转发到本地后，Redis Cluster客户端会从集群节点的配置响应中获取原始AWS内部DNS地址，而非你用来发起连接的localhost。这些内部DNS在本地环境无法解析，导致客户端尝试连接不可达节点，最终触发TTL exhausted错误。

针对ElastiCache的解决方案 #

方案1：本地hosts映射+多端口转发（临时测试用） #

1. 通过堡垒机登录到可访问ElastiCache的环境，执行命令获取集群所有节点的DNS与对应IP：

   redis-cli -h <ElastiCache主节点DNS> -p 6379 -a <密码> cluster nodes | awk '{print $2, $10}'
   

2. 将输出的IP-DNS对应关系添加到本地hosts文件：
   • Windows路径：C:\Windows\System32\drivers\etc\hosts
   • Linux/macOS路径：/etc/hosts

   10.0.0.100  redis-cluster-0001-001.xxxxxx.cache.amazonaws.com
   10.0.0.101  redis-cluster-0001-002.xxxxxx.cache.amazonaws.com
   

3. 配置SSH隧道时，将每个集群节点的6379端口转发到本地不同端口：

   ssh -L 6379:redis-cluster-0001-001.xxxxxx.cache.amazonaws.com:6379 \
       -L 6380:redis-cluster-0001-002.xxxxxx.cache.amazonaws.com:6379 \
       ec2-user@<堡垒机IP>
   

4. 修改Python代码，指定节点映射：

   redis_cluster = RedisCluster(
       startup_nodes=[
           {"host": "localhost", "port": 6379},
           {"host": "localhost", "port": 6380}
       ],
       ssl=True,
       ssl_cert_reqs=None,
       decode_responses=True,
       skip_full_coverage_check=True,
       password=password,
       host_port_remap={
           "redis-cluster-0001-001.xxxxxx.cache.amazonaws.com:6379": ("localhost", 6379),
           "redis-cluster-0001-002.xxxxxx.cache.amazonaws.com:6379": ("localhost", 6380)
       }
   )
   redis_cluster.set("foo", "bar")
   

方案2：升级客户端+直接DNS映射（推荐） #

旧版本redis-py-cluster的host_port_remap不支持DNS地址映射，先升级到最新版：

pip install --upgrade redis-py-cluster

之后直接在代码中配置host_port_remap，将ElastiCache节点DNS映射到本地转发端口：

redis_cluster = RedisCluster(
    host='localhost',
    port=6379,
    ssl=True,
    ssl_cert_reqs=None,
    decode_responses=True,
    skip_full_coverage_check=True,
    password=password,
    host_port_remap={
        "redis-cluster-0001-001.xxxxxx.cache.amazonaws.com:6379": ("localhost", 6379),
        "redis-cluster-0001-002.xxxxxx.cache.amazonaws.com:6379": ("localhost", 6380)
        # 补充所有集群节点的映射关系
    }
)

本地Docker Redis集群连接问题解决 #

本地Docker搭建的Redis集群，需注意以下几点：

• 容器需绑定主机网络，或正确映射所有集群节点的端口（通常每个节点用不同端口，如7000-7005）
• 启动集群时使用主机IP而非容器内部IP，避免客户端获取不可达的容器IP
• 代码中指定所有集群节点的主机端口：

  redis_cluster = RedisCluster(
      startup_nodes=[
          {"host": "localhost", "port": 7000},
          {"host": "localhost", "port": 7001},
          {"host": "localhost", "port": 7002}
      ],
      decode_responses=True,
      skip_full_coverage_check=True,
      password=password
  )
  

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