aialferov/keepalived

Keepalived Docker镜像文档

镜像概述

Keepalived是一款基于VRRP（虚拟路由冗余协议）的高可用解决方案，主要用于实现服务器之间的故障转移和虚拟IP（VIP）管理。通过该Docker镜像，可快速部署Keepalived服务，确保关键服务在主节点故障时自动切换到备用节点，提升系统可用性。

核心功能与特性

• VRRP协议支持：实现虚拟路由冗余，支持主备节点自动故障转移
• 虚拟IP管理：配置和维护虚拟IP地址，确保服务IP高可用
• 灵活配置：通过配置文件自定义VRRP实例、优先级、认证方式等参数
• 轻量级部署：基于Alpine Linux构建，镜像体积小，资源占用低

使用场景

• Web服务器集群高可用部署
• 数据库主从架构故障切换
• 负载均衡器冗余配置
• 任何需要IP地址高可用的服务场景

配置说明

配置文件路径

容器内默认配置文件路径：/etc/keepalived/keepalived.conf

配置示例

vrrp_instance VI_1 {
    state MASTER          # 节点状态（MASTER/BACKUP）
    interface eth0        # 网络接口
    virtual_router_id 1   # 虚拟路由ID（主备节点需一致，0-255）
    priority 100          # 节点优先级（MASTER应高于BACKUP）
    advert_int 1          # VRRP通告间隔（秒）
    authentication {      # 认证配置
        auth_type PASS    # 认证类型（PASS/AH）
        auth_pass password # 认证密码（主备节点需一致）
    }
    virtual_ipaddress {   # 虚拟IP地址列表
        10.9.8.10         # 虚拟IP地址
    }
}

关键配置参数说明

• state：节点角色，MASTER为主节点，BACKUP为备用节点
• interface：VRRP通信使用的网络接口
• virtual_router_id：虚拟路由标识，同一VRRP实例的节点必须相同
• priority：节点优先级，数值越高越优先成为主节点
• advert_int：VRRP通告发送间隔，默认1秒
• authentication：认证配置，确保VRRP通信安全
• virtual_ipaddress：需要管理的虚拟IP地址集合

使用方法

基本运行命令

bash
docker run --name=keepalived --rm -d \
  --cap-add=NET_ADMIN \  # 授予网络管理权限
  --net=host \           # 使用主机网络模式（必须）
  -v /etc/keepalived:/etc/keepalived \  # 挂载本地配置目录
  aialferov/keepalived:2.0.7 -nl  # 镜像及启动参数（-nl：非守护模式运行）

停止容器

bash
docker stop keepalived

Docker Compose配置示例

yaml
version: '3'
services:
  keepalived:
    image: aialferov/keepalived:2.0.7
    container_name: keepalived
    restart: always
    cap_add:
      - NET_ADMIN
    network_mode: host
    volumes:
      - /etc/keepalived:/etc/keepalived
    command: -nl

注意事项

• 必须使用--net=host网络模式，确保VRRP协议正常通信
• 需添加NET_ADMIN权限，否则无法管理网络接口和虚拟IP
• 主备节点的virtual_router_id和auth_pass必须保持一致
• 配置文件需通过-v参数挂载到容器内/etc/keepalived目录
• 启动参数-nl表示非守护模式运行，符合容器化部署要求