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 30 | SMTP 服务器配置 | |
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 51 | VRRP 组 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 keepalived | vrrp_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 keepalived | Debian/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 type | auth_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 found | VIP 配置格式错误或绑定了不存在的网卡 | |
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 -fip -4 addr | grep VIP → arping -I eth0 -c 3 VIP → ip neigh showtcpdump -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 }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
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 负载均衡配置,以及运维面试复习。