Redis哨兵部署模式下的IP地址映射_在云环境中配置sentinel announce-ip确保通信

秋磊吖_4822

秋磊吖_4822

2026-04-11

1029人浏览

原创

哨兵启动后找不到主从节点的根本原因是其自动广播的 announce-ip 为内网地址(如172.18.0.3),在docker、云主机或nat环境中对外不可达;必须显式配置 sentinel announce-ip 和 announce-port 为外部可连通的ip与端口,并确保 bind、防火墙、安全组等配套正确。

redis哨兵部署模式下的ip地址映射_在云环境中配置sentinel announce-ip确保通信

为什么哨兵启动后找不到主节点或从节点?

根本原因往往是容器、云主机或NAT网络下,哨兵自动发现的 sentinel announce-ip 是内网地址(比如 172.18.0.3),而其他哨兵或客户端尝试用这个地址去连,结果连不通。它不是配置错了,而是 Redis 哨兵默认“自报家门”时用了本机 bind 接口的 IP,而这个 IP 在云环境里对外不可达。

必须显式设置 sentinel announce-ip 和 sentinel announce-port

只要部署在 Docker、K8s、阿里云/腾讯云 VPC 或任何带 NAT/安全组的环境里,就必须手动指定对外可访问的地址。否则哨兵之间互相写入的节点地址是错的,故障转移会失败,客户端也拿不到正确的主节点地址。

  • sentinel announce-ip 必须填客户端和其它哨兵能直接 TCP 连通的 IP(如公网 EIP、SLB 后的真实私网 VIP、或 Kubernetes Service 的 ClusterIP + headless 配合 DNS)
  • sentinel announce-port 要与哨兵实际监听的端口一致(默认 26379),如果做了端口映射(如 Docker -p 26380:26379),这里就得填 26380
  • 这两个配置必须写在哨兵配置文件中,或通过 redis-sentinel /path/to/sentinel.conf 启动前就生效,运行时 CONFIG SET 不支持修改

常见错误场景与验证方式

即使配了 announce-ip,也可能因以下原因失效:

Redis Skill - 高性能缓存管理
Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis,支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载
  • 配置文件里写了 bind 127.0.0.1 却没放开监听外网接口 → 哨兵进程本身收不到其它节点发来的命令,要加 bind 0.0.0.0 或具体网卡 IP
  • 云安全组/防火墙没放行 sentinel announce-port(不是 Redis 端口!是哨兵端口),导致 TCP 握手失败
  • 执行 SENTINEL MASTER mymaster 查看返回结果中的 ip 字段,确认是否为预期的对外地址;再用 telnet <announce-port></announce-port> 手动测试连通性
  • Docker 场景下误用 localhost 或 127.0.0.1 作为 announce-ip → 容器间网络隔离,彼此看不到对方的 localhost

不同环境下的典型配置示例

以三节点哨兵为例(mymaster 主节点已运行在 10.0.1.10:6379):

port 26379
dir "/tmp"
sentinel monitor mymaster 10.0.1.10 6379 2
sentinel down-after-milliseconds mymaster 5000
sentinel failover-timeout mymaster 180000
sentinel parallel-syncs mymaster 1
sentinel announce-ip 47.98.123.45   # ← 公网 IP,或 SLB 后的真实服务 IP
sentinel announce-port 26379
bind 0.0.0.0
protected-mode no

在 Kubernetes 中,若用 headless Service + StatefulSet,announce-ip 可设为 Pod DNS 名(如 sentinel-0.sentinel-headless.default.svc.cluster.local),但前提是客户端和哨兵都支持 DNS 解析且超时容忍足够 —— 实际更稳的方式仍是配合 hostNetwork: true 或使用 NodePort + status.hostIP 注入。

真正麻烦的从来不是加两行配置,而是改完之后没人去 telnet 验证那条连接通不通。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

redis

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3088

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

4529

12

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.29

3709

9

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

2026.01.19

406

15

default gateway怎么配置
default gateway怎么配置

配置default gateway的步骤:1、了解网络环境;2、获取路由器IP地址;3、登录路由器管理界面;4、找到并配置WAN口设置;5、配置默认网关;6、保存设置并退出;7、检查网络连接是否正常。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.12.07

357

5

k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

685

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

4899

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

5857

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

2213

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习