thibaultmorin/keepalived

docker-image-keepalived

镜像概述

该Docker镜像用于运行keepalived，一个基于VRRP（虚拟路由冗余协议）的高可用解决方案。本镜像设计深受https://github.com/osixia/docker-keepalived%E9%A1%B9%E7%9B%AE%E5%90%AF%E5%8F%91%EF%BC%8C%E6%8F%90%E4%BE%9B%E7%AE%80%E5%8D%95%E6%98%93%E7%94%A8%E7%9A%84%E9%85%8D%E7%BD%AE%E6%96%B9%E5%BC%8F%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E6%9E%84%E5%BB%BA%E9%AB%98%E5%8F%AF%E7%94%A8%E9%9B%86%E7%BE%A4%E7%8E%AF%E5%A2%83%E3%80%82

核心功能与特性

• 基于VRRP协议实现节点间故障检测与自动故障转移
• 支持虚拟IP（VIP）管理，确保服务持续可用
• 通过环境变量灵活配置，无需手动编写复杂配置文件
• 支持单播模式（unicast），适用于云环境或不支持组播的网络

使用场景

• 负载均衡器高可用部署（如Nginx、HAProxy集群）
• 数据库主从切换的IP管理
• Web服务器集群的虚拟IP漂移
• 任何需要确保服务持续可用的关键业务场景

配置说明

通过以下环境变量进行配置：

使用方法

基本运行命令

bash
docker run -d --name keepalived --restart=always \
    --cap-add=NET_ADMIN --net=host \
    -e KEEPALIVED_VIRTUAL_IPS="192.168.0.99" \
    -e KEEPALIVED_UNICAST_PEERS="192.168.0.100,192.168.0.101,192.168.0.102" \
    thibaultmorin/keepalived

参数说明

• --cap-add=NET_ADMIN：必须，赋予容器网络管理权限
• --net=host：使用主机网络模式，确保VRRP报文正常收发
• --restart=always：容器退出时自动重启，保证服务持续运行
• 环境变量根据实际需求调整，特别是虚拟IP和对等节点列表

多节点集群部署示例

假设有3个节点（IP分别为192.168.0.100、192.168.0.101、192.168.0.102），需要共享虚拟IP 192.168.0.99：

节点1（主节点，优先级150）：

bash
docker run -d --name keepalived --restart=always \
    --cap-add=NET_ADMIN --net=host \
    -e KEEPALIVED_VIRTUAL_IPS="192.168.0.99" \
    -e KEEPALIVED_UNICAST_PEERS="192.168.0.101,192.168.0.102" \
    -e KEEPALIVED_PRIORITY=150 \
    thibaultmorin/keepalived

节点2（备用节点，优先级140）：

bash
docker run -d --name keepalived --restart=always \
    --cap-add=NET_ADMIN --net=host \
    -e KEEPALIVED_VIRTUAL_IPS="192.168.0.99" \
    -e KEEPALIVED_UNICAST_PEERS="192.168.0.100,192.168.0.102" \
    -e KEEPALIVED_PRIORITY=140 \
    thibaultmorin/keepalived

节点3（备用节点，优先级130）：

bash
docker run -d --name keepalived --restart=always \
    --cap-add=NET_ADMIN --net=host \
    -e KEEPALIVED_VIRTUAL_IPS="192.168.0.99" \
    -e KEEPALIVED_UNICAST_PEERS="192.168.0.100,192.168.0.101" \
    -e KEEPALIVED_PRIORITY=130 \
    thibaultmorin/keepalived