GeekIt

Keepalived命令速查

启动校验、global_defs、VRRP 实例、健康脚本、VIP 验证、双主排查与 LVS 配置等 135 条命令

共 135 条命令 · 10 类场景 · 点击右侧图标可复制

命令 / 配置说明复制
keepalived -v查看版本号,2.x 对脚本安全与 VRRPv3 支持更完善
keepalived -f /etc/keepalived/keepalived.conf使用指定配置文件启动
keepalived -t -f /etc/keepalived/keepalived.conf仅校验配置语法,不启动服务(改配置后必做)
keepalived -T -f /etc/keepalived/keepalived.conf校验并打印最终解析后的配置
keepalived -n -l -D -f /etc/keepalived/keepalived.conf前台运行并输出详细日志,调试首选
keepalived -d -f /etc/keepalived/keepalived.conf输出 VRRP 与脚本执行的调试信息
keepalived -p /var/run/keepalived.pid指定 pid 文件路径
systemctl status keepalived查看服务状态与最近日志
systemctl restart keepalived重启服务,会短暂触发一次状态选举
systemctl reload keepalived发送 SIGHUP 重载配置(部分配置需重启才生效)
kill -HUP $(cat /var/run/keepalived.pid)手动重载配置文件
kill -USR1 $(cat /var/run/keepalived.pid)导出运行统计与状态到文件(默认 /tmp)
journalctl -u keepalived -f实时跟踪服务日志
ls -l /etc/keepalived/确认配置文件与检查脚本权限,脚本必须可执行
命令 / 配置说明复制
global_defs { router_id LB01 }全局唯一标识,写错会导致日志难以区分节点
notification_email { ops@example.com }告警邮件接收人(需本机可发信)
notification_email_from keepalived@example.com告警发件人
smtp_server 127.0.0.1 与 smtp_connect_timeout 30SMTP 服务器配置
enable_script_security要求脚本以非 root 用户运行,配合 script_user 使用
script_user keepalived_script指定健康检查脚本的运行用户
vrrp_skip_check_adv_addr跳过通告地址校验,跨网段单播场景可减少误判
vrrp_strict严格模式:要求 VRRPv2 完整通告字段,云环境常需关闭
vrrp_garp_interval 0.5免费 ARP 发送间隔优化,加快 VIP 切换后的 ARP 更新
vrrp_gna_interval 0.5免费 ND 通告间隔(IPv6)
vrrp_mcast_group4 224.0.0.18组播地址,多实例需保证同组一致
max_auto_priority 99限制自动优先级调整上限,避免优先级被脚本推得过高
命令 / 配置说明复制
vrrp_instance VI_1 { state MASTER }实例名与初始角色,state 只是初始值,实际由优先级决定
interface eth0绑定网卡,VIP 与 VRRP 通告都在此接口
virtual_router_id 51VRRP 组 ID,同网段内必须唯一,冲突会造成双主
priority 100优先级,MASTER 需高于 BACKUP,数值相同会比较 IP
advert_int 1通告间隔(秒),越小切换越快但流量越大
authentication { auth_type PASS auth_pass 1234 }简单认证,两端必须一致(VRRPv3 已弱化该字段)
virtual_ipaddress { 10.0.0.100/24 dev eth0 }定义 VIP 与绑定网卡
virtual_ipaddress { 10.0.0.100/24 dev eth0 label eth0:vip }给 VIP 设置别名标签,便于识别与监控
state BACKUP 与 nopreempt推荐两台都配 BACKUP + nopreempt,避免故障恢复后反复抢占
preempt_delay 300允许抢占但延迟 300 秒,减少网络抖动引发的切换
unicast_src_ip 10.0.0.5单播模式本端源地址,云环境不支持组播时必须使用
unicast_peer { 10.0.0.6 }单播对端地址,两端都要配置且互为对端
track_interface { eth0 weight -30 }网卡故障时降低优先级,触发切换
track_script { chk_nginx }绑定健康检查脚本,脚本失败即影响优先级
notify_master "/etc/keepalived/notify.sh master"切换为主时执行的钩子,可做告警与 ARP 通告
notify_backup 与 notify_fault 与 notify_stop切为备、故障、停止时的钩子脚本
garp_master_delay 2成为主后延迟发送免费 ARP,避免过早通告
smtp_alert状态切换时发送邮件告警
命令 / 配置说明复制
vrrp_script chk_nginx { script "/etc/keepalived/check_nginx.sh" }定义检查脚本,名称供 track_script 引用
interval 2每 2 秒执行一次检查
timeout 2脚本超时时间,超时按失败处理
weight -20失败时优先级减 20,减到低于对端才会发生切换
fall 3 与 rise 2连续失败 3 次判定故障,连续成功 2 次恢复
script "killall -0 nginx"进程存活检查(killall 需安装 psmisc)
script "pidof nginx > /dev/null"用 pidof 判断进程是否存在
script "curl -sf -o /dev/null http://127.0.0.1/health"接口健康检查,比进程检查更真实
script "/usr/bin/killall -0 haproxy"使用绝对路径,keepalived 环境变量与登录 shell 不同
user root指定脚本执行用户,2.x 默认受 enable_script_security 限制
weight 0 与 weight 正数的区别0 表示只影响状态不调优先级;正数仅在 BACKUP 状态且优先级低于对端时生效
检查脚本必须在两台节点上都能独立运行并返回正确退出码退出码 0 为成功,非 0 为失败,输出会被写入日志
脚本改动后需 systemctl restart keepalivedvrrp_script 内容变更一般不随 reload 生效
chmod 755 /etc/keepalived/check_nginx.sh脚本无执行权限会导致 Unable to start scripts
命令 / 配置说明复制
ip addr show eth0确认 VIP 是否落在预期节点上
ip -4 addr | grep 10.0.0.100快速判断当前哪台持有 VIP
ip addr add 10.0.0.100/24 dev eth0手动添加 VIP 复现问题(测试后记得删除)
ip addr del 10.0.0.100/24 dev eth0手动移除 VIP,模拟漂移
arping -I eth0 -c 3 10.0.0.100验证 VIP 的 ARP 响应是否来自预期节点
arping -U -c 3 -I eth0 10.0.0.100主动发送免费 ARP,强制交换机刷新 MAC 表
ip neigh show | grep 10.0.0.100查看邻居表中的 VIP 对应 MAC
ping -c 3 10.0.0.100基础连通性验证
tcpdump -i eth0 -nn "ip proto 112"抓 VRRP 通告(协议号 112),确认双方都在发
tcpdump -i eth0 -nn -e vrrp查看 VRRP 源 MAC 与优先级,定位双主
sysctl net.ipv4.ip_nonlocal_bind确认是否允许监听非本地地址(如 HAProxy 绑定 VIP)
echo "net.ipv4.ip_nonlocal_bind = 1" >> /etc/sysctl.conf && sysctl -p开启非本地绑定,避免 VIP 未在本机时服务启动失败
ss -lntp | grep -E ":80|:443"确认业务端口在 VIP 上正常监听
ip link show eth0检查网卡状态与 MTU,网卡 down 会触发切换
命令 / 配置说明复制
journalctl -u keepalived -n 100 --no-pager查看状态变化记录:Entering MASTER/BACKUP STATE
grep -i keepalived /var/log/messages | tail -50传统 syslog 环境下查看切换日志
两台同时持有 VIP 即脑裂先查 virtual_router_id 是否冲突、auth_pass 是否一致、组播是否被隔离
ip addr | grep 10.0.0.100 在两台机器上分别执行最快的双主判断方法
tcpdump -i eth0 -nn "ip proto 112" 双向抓包收不到对端通告说明被防火墙或交换机隔离
priority 相同会导致按 IP 比较选主务必让主备优先级有明显差值(建议 ≥ 20)
nopreempt 必须两台都配置只配一台仍会抢占,是常见的配置坑
track_interface 网卡 down 会立即降优先级排查"莫名切换"时先看网卡与链路日志
vrrp_script weight 绝对值小于优先级差时不会切换例如主 100 备 90,weight -5 减到 95 仍是主
iptables -I INPUT -p vrrp -j ACCEPT放通 VRRP 协议(112),firewalld 需加 rich rule
firewall-cmd --add-rich-rule="rule protocol value=vrrp accept"firewalld 放通 VRRP
notify_fault 未触发说明脚本未判定失败检查 fall 次数、脚本退出码与日志输出
时间不同步会导致通告时间戳异常保证 NTP 一致,避免误判超时
命令 / 配置说明复制
virtual_server 10.0.0.100 80 { delay_loop 6 }定义 LVS 虚拟服务,delay_loop 为检查周期
lb_algo rr调度算法:rr 轮询、wrr 加权轮询、lc 最少连接
lb_kind DR转发模式:DR 直接路由(性能最好)、NAT、TUN
persistence_timeout 50会话保持时间(秒),0 表示不保持
protocol TCP指定四层协议
real_server 10.0.0.5 80 { weight 1 }后端真实服务器与权重
TCP_CHECK { connect_timeout 3 connect_port 80 }四层端口检查
HTTP_GET { url { path /health status_code 200 } connect_timeout 3 }七层健康检查,可按状态码判定
MISC_CHECK { misc_path "/etc/keepalived/check.sh" }自定义脚本检查,最灵活
ipvsadm -Ln查看 IPVS 虚拟服务与后端列表
ipvsadm -Lnc查看当前连接表,判断流量是否真正转发
ipvsadm -A -t 10.0.0.100:80 -s rr手动创建虚拟服务(测试用)
ipvsadm -a -t 10.0.0.100:80 -r 10.0.0.5:80 -g手动添加后端(-g 为 DR 模式)
ipvsadm --save > /etc/sysconfig/ipvsadm保存 IPVS 规则,便于重启恢复
modprobe ip_vs 与 lsmod | grep ip_vs确认内核 IPVS 模块已加载
命令 / 配置说明复制
keepalived -n -l -D前台详细日志,定位状态切换时序最有效
journalctl -u keepalived --since "10 min ago"按时间窗口查看最近日志
tail -f /var/log/syslog | grep -i keepalivedDebian/Ubuntu 环境日志查看方式
kill -USR1 $(cat /var/run/keepalived.pid) 与 ls -l /tmp/keepalived*导出内部数据文件,分析状态与统计
notify_master 脚本中追加 logger 记录自定义切换审计,便于事后追溯
strace -f -p $(cat /var/run/keepalived.pid)系统调用级排查脚本执行失败
tcpdump -i any -nn proto 112 -c 20确认通告间隔是否符合 advert_int
keepalived -T -f /etc/keepalived/keepalived.conf打印合并后的配置,排查 include 与继承问题
监控项:VIP 所在节点、VRRP 状态、脚本检查结果至少对 VIP 归属做外部探测告警,防止双主无人发现
日志中出现 "VRRP_Instance(VI_1) Entering BACKUP STATE"说明发生了切换,结合前后日志定位原因
升级前备份 /etc/keepalived 与 ipvsadm -Sn 输出回滚与比对配置的依据
grep -i "warning\|error" /var/log/messages | grep keepalived提取告警与错误行
命令 / 配置说明复制
state BACKUP + nopreempt + priority 差值 ≥ 20最稳妥的主备模型,避免频繁抢占
双主互备:两个 vrrp_instance 优先级交叉两台同时承载不同 VIP,资源利用率更高,但切换逻辑更复杂
systemctl stop keepalived维护时主动释放 VIP,让对端接管
临时降优先级:把 priority 改小后 reload比直接 stop 更平滑,业务连接可自然迁移
keepalived + nginx/haproxy 提供七层高可用入口VIP 承载入口,后端由健康检查脚本驱动切换
net.ipv4.ip_nonlocal_bind = 1服务需绑定 VIP 时必开,否则备机启动失败
DR 模式需在 real_server 上配置 VIP 到 lo 并关闭 ARP 响应否则后端会直接响应 ARP,绕过调度器
云环境通常禁用组播,改用 unicast_src_ip 与 unicast_peer并在安全组放通 VRRP 或改用云厂商提供的 VIP
vrrp_strict 在云环境建议关闭严格校验在 NAT 场景会误判通告非法
健康检查脚本要幂等且执行快脚本超时会触发误切换,避免在脚本中做重操作
切换演练:手动 stop 主节点并观察 VIP 与 ARP定期演练才能保证真故障时不慌
命令 / 配置说明复制
Warning - equal priority on the master优先级相同,检查两台 priority 配置
Receive advertisement timeout收不到对端通告:检查组播/单播配置与防火墙
invalid auth typeauth_type 拼写错误或 VRRPv3 下不支持该字段
Unknown keyword配置项与版本不匹配,用 keepalived -v 对照版本文档
Unable to start scripts脚本无执行权限或用户不匹配,检查 enable_script_security 与 script_user
pid file already running已有实例在运行,先 systemctl stop 或清理残留 pid
Socket bind failed for VRRP端口被占用或权限不足,确认以 root 启动且无其他 VRRP 进程
IP address 10.0.0.100 not foundVIP 配置格式错误或绑定了不存在的网卡
VPN/隧道场景下 VRRP 不通隧道不转发组播,改用 unicast 单播模式
切换后业务仍连旧节点交换机 ARP 表未刷新,靠 garp 配置与 arping -U 兜底
备机始终不接管检查 weight 是否让优先级仍高于主、nopreempt 是否阻止抢占、对端是否真挂了
频繁切换(flapping)加大 advert_int、fall/rise 次数,并排查脚本抖动与网络丢包

运维常用组合

配置校验与生效keepalived -t -f /etc/keepalived/keepalived.conf → systemctl reload keepalived → journalctl -u keepalived -f
确认 VIP 归属ip -4 addr | grep VIP → arping -I eth0 -c 3 VIP → ip neigh show
双主排查tcpdump -i eth0 -nn "ip proto 112" → 核对 virtual_router_id / auth_pass / 防火墙
主动演练切换systemctl stop keepalived → 观察对端 VIP 与日志 → 启动并确认不抢占
健康检查落地vrrp_script { script "curl -sf http://127.0.0.1/health"; interval 2; fall 3; weight -30 }
LVS 状态确认ipvsadm -Ln → ipvsadm -Lnc → tcpdump 抓后端响应

常见问题排查

1. 两台都有 VIP

脑裂:优先核对 virtual_router_id 是否唯一、auth_pass 是否一致、是否被防火墙拦掉 112 协议

2. 故障后不回切

检查是否配置了 nopreempt;需要回切时改为 preempt_delay 延迟抢占

3. 脚本改了不生效

vrrp_script 内容变更通常需要 restart 而非 reload;脚本路径要用绝对路径

4. 业务绑定 VIP 起不来

开启 net.ipv4.ip_nonlocal_bind=1,让备机也能监听 VIP

5. 云上组播不通

改用 unicast_src_ip + unicast_peer,并关闭 vrrp_strict

6. 切换后短暂不通

ARP 未刷新导致:优化 vrrp_garp_interval,或在 notify_master 中执行 arping -U

共 135 条 Keepalived 命令 · 示例 VIP 10.0.0.100 与网卡 eth0 请替换为实际环境

关于Keepalived命令速查

在线 Keepalived 命令速查手册,按安装启动与配置校验、global_defs 全局配置、VRRP 实例核心配置、健康检查脚本、VIP 与网络验证、状态判断与双主排查、LVS 虚拟服务器、日志调试与监控、高可用实践、常见报错等 10 类场景整理 130+ 条常用命令与配置片段,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 keepalived -v 与 -t/-T 配置校验与 -n -l -D 前台调试、systemctl 管理与 kill -HUP 重载、kill -USR1 导出统计、global_defs 的 router_id 与 enable_script_security 与 script_user 与 vrrp_strict 与 vrrp_garp_interval 与 vrrp_mcast_group4、vrrp_instance 的 state/interface/virtual_router_id/priority/advert_int/authentication/virtual_ipaddress/unicast_src_ip/unicast_peer/track_interface/track_script/notify_master/nopreempt/preempt_delay/garp_master_delay、vrrp_script 的 script/interval/timeout/weight/fall/rise 与 curl 与 pidof 健康检查写法、ip addr 与 arping 与 ip neigh 验证 VIP、tcpdump ip proto 112 抓 VRRP、net.ipv4.ip_nonlocal_bind 非本地绑定、双主(脑裂)排查思路与防火墙放通 vrrp、virtual_server 的 lb_algo/lb_kind/persistence_timeout/real_server/TCP_CHECK/HTTP_GET/MISC_CHECK 与 ipvsadm -Ln/-Lnc 与 modprobe ip_vs、journalctl 与 /var/log/messages 日志分析、切换演练与 DR 模式注意事项、equal priority 与 Receive advertisement timeout 与 Unable to start scripts 等报错排查。适用于 Keepalived 高可用部署、VIP 漂移与主备切换、健康检查脚本落地、双主故障定位、LVS 负载均衡配置,以及运维面试复习。

核心能力

  • 涵盖 keepalived -v 与 -t/-T 配置校验与 -n -l -D 前台调试、systemctl 管理与 kill -HUP 重载、kill -USR1 导出统计、global_defs 的 router_id 与 enable_script_security 与 script_user 与 vrrp_strict 与 vrrp_garp_interval 与 vrrp_mcast_group4、vrrp_instance 的 state/interface/virtual_router_id/priority/advert_int/authentication/virtual_ipaddress/unicast_src_ip/unicast_peer/track_interface/track_script/notify_master/nopreempt/preempt_delay/garp_master_delay、vrrp_script 的 script/interval/timeout/weight/fall/rise 与 curl 与 pidof 健康检查写法、ip addr 与 arping 与 ip neigh 验证 VIP、tcpdump ip proto 112 抓 VRRP、net.ipv4.ip_nonlocal_bind 非本地绑定、双主(脑裂)排查思路与防火墙放通 vrrp、virtual_server 的 lb_algo/lb_kind/persistence_timeout/real_server/TCP_CHECK/HTTP_GET/MISC_CHECK 与 ipvsadm -Ln/-Lnc 与 modprobe ip_vs、journalctl 与 /var/log/messages 日志分析、切换演练与 DR 模式注意事项、equal priority 与 Receive advertisement timeout 与 Unable to start scripts 等报错排查

适用场景

适用于 Keepalived 高可用部署、VIP 漂移与主备切换、健康检查脚本落地、双主故障定位、LVS 负载均衡配置,以及运维面试复习。Keepalived命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

Keepalived命令速查是免费的吗?需要注册或安装吗?
Keepalived命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
Keepalived命令速查支持哪些功能?
涵盖 keepalived -v 与 -t/-T 配置校验与 -n -l -D 前台调试、systemctl 管理与 kill -HUP 重载、kill -USR1 导出统计、global_defs 的 router_id 与 enable_script_security 与 script_user 与 vrrp_strict 与 vrrp_garp_interval 与 vrrp_mcast_group4、vrrp_instance 的 state/interface/virtual_router_id/priority/advert_int/authentication/virtual_ipaddress/unicast_src_ip/unicast_peer/track_interface/track_script/notify_master/nopreempt/preempt_delay/garp_master_delay、vrrp_script 的 script/interval/timeout/weight/fall/rise 与 curl 与 pidof 健康检查写法、ip addr 与 arping 与 ip neigh 验证 VIP、tcpdump ip proto 112 抓 VRRP、net.ipv4.ip_nonlocal_bind 非本地绑定、双主(脑裂)排查思路与防火墙放通 vrrp、virtual_server 的 lb_algo/lb_kind/persistence_timeout/real_server/TCP_CHECK/HTTP_GET/MISC_CHECK 与 ipvsadm -Ln/-Lnc 与 modprobe ip_vs、journalctl 与 /var/log/messages 日志分析、切换演练与 DR 模式注意事项、equal priority 与 Receive advertisement timeout 与 Unable to start scripts 等报错排查。
Keepalived命令速查适合哪些场景使用?
适用于 Keepalived 高可用部署、VIP 漂移与主备切换、健康检查脚本落地、双主故障定位、LVS 负载均衡配置,以及运维面试复习。