Docker容器无法连接Mac本地Redis集群：指定host却连127.0.0.1

你的核心问题是Redis集群的节点通告配置错误：当容器内的客户端通过host.docker.internal连接Redis集群时，Redis会返回集群节点绑定的本地127.0.0.1地址，导致客户端后续尝试直接连接127.0.0.1的端口——而容器内的127.0.0.1指向容器自身而非主机，因此连接被拒绝。

另外netstat显示部分端口无监听，大概率是Redis集群节点默认绑定了127.0.0.1而非0.0.0.0，导致仅能本地访问，容器无法通过主机IP连接这些端口。

1. 修改Redis集群节点配置，绑定全局IP并指定通告地址 #

编辑每个Redis节点的配置文件（如redis-30001.conf、redis-30002.conf等），添加/修改以下配置项：

# 允许所有IP访问，替换默认的127.0.0.1
bind 0.0.0.0
# 关闭保护模式，否则非本地IP无法连接
protected-mode no
# 指定集群对外通告的IP（填你的MacBook局域网IP，比如192.168.1.100；也可以用容器内解析到的host.docker.internal对应IP）
cluster-announce-ip 192.168.1.100
# 对应节点的服务端口
cluster-announce-port 30001
# 集群总线端口（通常为服务端口+10000）
cluster-announce-bus-port 30011

注意：每个节点的cluster-announce-port和cluster-announce-bus-port要匹配自身端口（比如30002节点对应30002和30012）。

2. 重启Redis集群 #

停止所有Redis节点后重新启动：

# 停止所有Redis进程
pkill redis-server
# 逐个启动节点
redis-server redis-30001.conf
redis-server redis-30002.conf
redis-server redis-30003.conf
# 若集群未初始化过，执行以下命令创建集群（已初始化则跳过）
redis-cli --cluster create 192.168.1.100:30001 192.168.1.100:30002 192.168.1.100:30003 --cluster-replicas 0

3. 验证端口监听状态 #

重启后用netstat检查端口是否监听所有IP：

netstat -anp tcp | grep LISTEN | grep -E "3000[1-3]"

正常输出应显示0.0.0.0:30001而非127.0.0.1:30001。

4. 调整客户端连接配置 #

客户端代码中，将Redis集群的连接地址改为你的MacBook局域网IP，或者保持host.docker.internal——只要Redis集群的cluster-announce-ip配置的是容器能访问到的主机地址即可。

Redis集群工作时，客户端首次连接任意节点后，会获取整个集群的节点地址列表。如果Redis节点配置的cluster-announce-ip是127.0.0.1，客户端就会尝试连接这个本地地址；在容器环境下，127.0.0.1指向容器内部，自然无法访问主机的Redis服务。通过指定正确的通告IP，客户端会直接连接主机的有效IP地址，从而正常访问Redis集群。

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