icoreru/keepalived

keepalived-dockerfile

镜像概述

基于Alpine Linux的keepalived服务Dockerfile，用于部署VRRP（虚拟路由冗余协议）高可用集群。通过配置主备节点，实现服务的自动故障转移，确保关键业务持续可用。

核心功能与特性

支持的环境变量

• KEEPALIVED_ROUTER_ID：VRRP组的唯一标识ID，取值范围0-255，必填。
• KEEPALIVED_UNICAST_PEERS：参与VRRP组的对等节点IP地址，必填。
• KEEPALIVED_VIRTUAL_IPS：VRRP虚拟IP地址，必填。
• KEEPALIVED_STATE：节点角色，可选值为'MASTER'（主节点）或'BACKUP'（备份节点），默认值：BACKUP。
• KEEPALIVED_PRIORITY：选举优先级，优先级最高的节点将成为主节点。默认值：备份节点随机1-199，主节点200。
• KEEPALIVED_INTERFACE：keepalived监控和用于VRRP流量的主机网络接口，默认值：ens192。
• KEEPALIVED_PASSWORD：VRRP组内节点间的认证共享密码。

使用场景与适用范围

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

• Web服务器集群的主备切换
• 数据库服务的故障转移
• 负载均衡器的冗余部署
• 任何需要避免单点故障的关键业务系统

使用方法与配置说明

基本部署（docker run）

主节点部署示例

bash
docker run -d \
  --name keepalived-master \
  --net=host \
  --cap-add=NET_ADMIN \
  -e KEEPALIVED_ROUTER_ID=51 \
  -e KEEPALIVED_UNICAST_PEERS=192.168.1.102 \
  -e KEEPALIVED_VIRTUAL_IPS=192.168.1.100/24 \
  -e KEEPALIVED_STATE=MASTER \
  -e KEEPALIVED_PASSWORD=vrrp_pass \
  keepalived-dockerfile

备份节点部署示例

bash
docker run -d \
  --name keepalived-backup \
  --net=host \
  --cap-add=NET_ADMIN \
  -e KEEPALIVED_ROUTER_ID=51 \
  -e KEEPALIVED_UNICAST_PEERS=192.168.1.101 \
  -e KEEPALIVED_VIRTUAL_IPS=192.168.1.100/24 \
  -e KEEPALIVED_STATE=BACKUP \
  -e KEEPALIVED_PASSWORD=vrrp_pass \
  keepalived-dockerfile

注意事项

• 容器需使用--net=host网络模式，以确保VRRP流量正常通信。
• 必须添加NET_ADMIN capabilities，使容器具备网络管理权限。
• 此仓库仍处于alpha阶段，功能可能频繁变更，不提供明示或暗示的担保。