keepalived 本身不提供 web 看板,但可通过 shell 脚本采集 /var/log/keepalived.log 角色、vip 和 nginx 状态,配合静态 html 与定时 fetch 实现轻量级主备可视化监控,并建议补充 vrrp 投票、健康检查结果及切换日志以增强可观测性。

在 Nginx 高可用架构中,Keepalived 本身不提供 Web 看板功能,但可通过组合轻量级工具快速搭建主备状态可视化监控页,无需引入复杂运维平台。
Keepalived 状态采集原理
Keepalived 进程通过 VRRP 协议选举主节点,并将当前角色(MASTER/BACKUP/FAULT)写入本地文件或共享内存。最常用方式是监听 /var/run/keepalived.state 文件内容,或执行 kill -USR1 $(cat /var/run/keepalived.pid) 触发状态输出到日志(需配置 log syslog)。
- MASTER:当前节点持有 VIP,Nginx 正常转发流量
- BACKUP:待命节点,Nginx 运行但不响应 VIP 请求
- FAULT:Keepalived 异常退出或健康检查失败,VIP 已释放
简易看板实现方案(无第三方依赖)
用一个静态 HTML + Shell 脚本 + 定时刷新即可实现基础看板。将以下脚本部署在每台节点的 /usr/local/bin/keepalive-status.sh:
#!/bin/bash
ROLE=$(grep "State" /var/log/keepalived.log | tail -1 | awk '{print $NF}')
VIP=$(ip addr show | grep "inet.*vir" | awk '{print $2}' | cut -d'/' -f1)
NGINX=$(systemctl is-active nginx 2>/dev/null)
echo "{\"role\":\"$ROLE\",\"vip\":\"$VIP\",\"nginx\":\"$NGINX\"}"
再配一个 Nginx location 指向该脚本输出(启用 fastcgi_pass 或用 alias 配 CGI),前端用 fetch 每 5 秒拉取 JSON,渲染成表格即可显示两节点角色、VIP 所在、Nginx 状态。
增强可观测性的小技巧
仅看角色不够,建议补充三项关键指标:
- VRRP 投票计数:解析 /proc/net/ip_vs 中 VIP 绑定情况,确认真实生效节点
- 健康检查结果:在 keepalived.conf 的 vrrp_script 中 echo 结果到临时文件,供看板读取
- 切换日志摘要:用 journalctl -u keepalived -n 10 --no-pager 提取最近切换记录,避免翻日志
安全与部署提醒
看板页面应限制访问来源,例如在 Nginx 中添加:
location /status {
allow 192.168.10.0/24;
deny all;
alias /var/www/keepalive-dashboard/;
}
避免暴露内网状态给公网;脚本输出不带敏感信息,不执行任意命令;状态文件读取使用非 root 用户(如 www-data),最小权限原则。











