alissongranemann/keepalived

Keepalived Docker镜像文档

镜像概述

本镜像基于https://github.com/osixia/docker-keepalived%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9BKeepalived%E6%9C%8D%E5%8A%A1%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8C%96%E9%83%A8%E7%BD%B2%E6%96%B9%E6%A1%88%E3%80%82Keepalived%E6%98%AF%E4%B8%80%E6%AC%BE%E5%9F%BA%E4%BA%8EVRRP%EF%BC%88%E8%99%9A%E6%8B%9F%E8%B7%AF%E7%94%B1%E5%86%97%E4%BD%99%E5%8D%8F%E8%AE%AE%EF%BC%89%E7%9A%84%E9%AB%98%E5%8F%AF%E7%94%A8%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%EF%BC%8C%E5%8F%AF%E5%AE%9E%E7%8E%B0%E6%9C%8D%E5%8A%A1%E7%9A%84%E6%95%85%E9%9A%9C%E8%BD%AC%E7%A7%BB%EF%BC%8C%E7%A1%AE%E4%BF%9D%E5%85%B3%E9%94%AE%E6%9C%8D%E5%8A%A1%E6%8C%81%E7%BB%AD%E5%8F%AF%E7%94%A8%E3%80%82

核心功能与特性

• 主备模式支持：可配置为主节点（MASTER）或备节点（BACKUP），实现自动故障转移
• 环境变量配置：通过环境变量灵活配置网络接口、优先级、虚拟IP等关键参数
• 虚拟IP管理：支持配置多个虚拟IP地址，实现服务IP的高可用
• 通知脚本支持：内置通知脚本，可在节点状态变化时执行自定义操作

使用场景

适用于需要高可用性保障的服务场景，如：

• 负载均衡器（如Nginx、HAProxy）的高可用部署
• 数据库服务的主备切换
• 关键业务服务的故障转移保障

使用方法

运行主节点（MASTER）

bash
docker run --name keepalived -p 81:81 \
  --env KEEPALIVED_INTERFACE="<interface>" \
  --env KEEPALIVED_STATE="MASTER" \
  --env KEEPALIVED_PRIORITY="<priority>" \
  --cap-add=NET_ADMIN \
  --net=host \
  -d alissongranemann/keepalived

运行备节点（BACKUP）

bash
docker run --name keepalived -p 81:81 \
  --env KEEPALIVED_INTERFACE="<interface>" \
  --env KEEPALIVED_STATE="BACKUP" \
  --env K KEEPALIVED_PRIORITY="<priority>" \
  --cap-add=NET_ADMIN \
  --net=host \
  -d alissongranemann/keepalived

注意：--cap-add=NET_ADMIN 用于赋予容器网络管理权限，--net=host 使容器使用主机网络栈，确保VRRP协议正常工作。

环境变量配置

默认值

配置说明

• KEEPALIVED_INTERFACE：指定运行VRRP协议的网络接口，需与主机实际网络接口名称匹配
• KEEPALIVED_PRIORITY：主节点应设置高于备节点的优先级（如主节点200，备节点100）
• KEEPALIVED_VIRTUAL_IPS：配置需要漂移的虚拟IP地址，客户端通过这些IP访问服务
• KEEPALIVED_NOTIFY：可自定义脚本路径，实现状态变化时的通知（如发送邮件、调用API等）