Nginx + Keepalived 实现高可用API网关：Keepalived通过VRRP管理虚拟IP（VIP），主节点故障时VIP秒级漂移到备用节点，对外始终暴露同一入口IP，消除单点故障；需双机Nginx配置一致、健康检查精准、超时与连接复用合理，并加强监控与压测验证。
用 Nginx 做 API 网关时，单台 Nginx 就是整个流量入口的唯一节点——它一挂，所有接口全不可用。要真正解决这个问题，不能只靠加机器，关键得让“入口本身”具备自动切换能力。Nginx + Keepalived 组合正是为此设计：Keepalived 管虚拟 IP（VIP），Nginx 负责实际转发，主挂了，VIP 秒级漂移到备用机，用户请求完全无感。
为什么必须用 Keepalived 而不是只扩 Nginx 实例
单纯部署多台 Nginx 并不能消除单点故障——外部流量仍需一个统一入口地址（比如域名解析到的 IP）。如果这个入口 IP 只绑定在某一台 Nginx 上，那它仍是单点。Keepalived 的作用就是把一个固定的 VIP（如 10.0.0.100）动态绑定到健康节点上，对外始终只暴露这一个 IP，底层哪台在干活对上游完全透明。
- VIP 不是真实网卡 IP，而是由 Keepalived 通过 VRRP 协议“抢”来的逻辑地址
- 主节点（MASTER）正常时，VIP 运行在其上；心跳中断后，备节点（BACKUP）自动接管 VIP
- 切换过程通常在 1~3 秒内完成，TCP 连接可保持（配合合理超时设置），API 调用基本不报错
核心配置要点：Nginx 和 Keepalived 必须协同工作
两台服务器（假设为 node-a 和 node-b）都要装好 Nginx 并配置完全一致的反向代理规则（包括 HTTPS、限流、负载均衡 upstream 等），否则切换后行为可能异常。Keepalived 配置则需明确角色、优先级和健康检查逻辑：
- node-a 设为 MASTER，priority 100；node-b 设为 BACKUP，priority 90
- 使用 script 检查 Nginx 进程是否存活（如 killall -0 nginx && exit 0 || exit 1），不能只依赖 Keepalived 自带的端口检测
- 启用 nopreempt（可选），避免主恢复后立即抢回 VIP 导致频繁切换
- 确保两台机器时间同步、关闭防火墙或放行 VRRP 多播（224.0.0.18）、禁用 SELinux
高并发场景下的关键加固项
API 网关面对高并发，光通路通还不行，得扛住压测和突发流量。以下几处容易忽略但直接影响稳定性：
- Nginx 自动拉起：在 Keepalived 的 vrrp_script 中加入重启逻辑，比如检测到 Nginx 异常退出后执行 /usr/local/nginx/sbin/nginx
- 连接复用与超时匹配：upstream 设置 keepalive、proxy_http_version 1.1、proxy_set_header Connection ''，避免短连接风暴冲击 Keepalived 切换窗口
- 避免 VIP 冲突：确认网络中无其他设备使用相同 VIP，交换机需支持 IGMP（或改用单播模式 unicast_src_ip/unicast_peer）
- 监控告警联动：监听 /var/log/messages 或 keepalived 日志中的 “Transition to MASTER/BACKUP”，触发企业微信/钉钉告警
验证与常见问题定位
部署后别只看 VIP 是否能 ping 通——要模拟真实故障：
- 手动 kill -9 nginx 主进程，观察 VIP 是否 3 秒内出现在备机 ifconfig 输出中
- 用 curl -I http://[VIP]/health 检查响应头是否来自新节点（可通过返回 header 加 X-Node-ID 区分）
- 持续压测中执行故障注入，观察错误率是否突增（理想情况应
- 若切换失败，优先查日志：tail -f /var/log/messages | grep Keepalived，重点看“VRRP_Instance(VI_1) Entering FAULT STATE”类提示
