project42/keepalived

keepalived-docker 镜像文档

镜像概述

keepalived-docker是一个基于Alpine Linux构建的轻量级容器，集成了keepalived服务，专门用于管理浮动IP（Floating IP）。keepalived基于VRRP（虚拟路由冗余协议）实现高可用解决方案，可在多台服务器之间自动切换浮动IP，确保服务持续可用，适用于需要网络冗余的场景。

核心功能与特性

• 轻量级架构：基于Alpine Linux构建，镜像体积小，资源占用低，启动速度快
• 浮动IP管理：通过VRRP协议实现浮动IP的自动分配与切换，支持主备模式
• 高可用保障：当主节点故障时，备用节点可自动接管浮动IP，确保服务不中断
• 灵活配置：支持通过挂载配置文件自定义keepalived参数，适应不同网络环境需求

使用场景

• 负载均衡集群中浮动IP的高可用管理
• 数据库主从架构中的虚拟IP（VIP）自动切换
• 云服务器或物理服务器集群的网络入口冗余
• 需要单一访问IP且要求高可用性的服务部署

使用方法

基本部署（docker run）

bash
docker run -d \
  --name keepalived \
  --net=host \
  --cap-add=NET_ADMIN \
  --cap-add=NET_BROADCAST \
  --cap-add=NET_RAW \
  -v /path/to/keepalived.conf:/etc/keepalived/keepalived.conf \
  docker.xuanyuan.run/keepalived-docker

参数说明：

• --net=host：使用主机网络模式，确保VRRP报文正常收发
• --cap-add：添加必要网络权限（NET_ADMIN：网络管理权限，NET_BROADCAST：广播权限，NET_RAW：原始套接字权限）
• -v：挂载本地keepalived配置文件到容器内指定路径

配置文件示例

主节点配置（keepalived.conf）

conf
vrrp_instance VI_1 {
  state MASTER        # 节点角色（MASTER/BACKUP）
  interface eth0      # 绑定的网络接口
  virtual_router_id 51 # 虚拟路由ID（主备节点需一致，范围0-255）
  priority 100        # 优先级（主节点需高于备节点）
  advert_int 1        # VRRP通告间隔（秒）
  
  authentication {
    auth_type PASS    # 认证方式（PASS/HA）
    auth_pass 1111    # 认证密码（主备节点需一致）
  }
  
  virtual_ipaddress {
    192.168.1.100/24  # 浮动IP地址（可配置多个）
  }
}

备节点配置（keepalived.conf）

conf
vrrp_instance VI_1 {
  state BACKUP
  interface eth0
  virtual_router_id 51
  priority 90         # 优先级低于主节点
  advert_int 1
  
  authentication {
    auth_type PASS
    auth_pass 1111
  }
  
  virtual_ipaddress {
    192.168.1.100/24
  }
}

Docker Compose部署

yaml
version: '3'
services:
  keepalived:
    image: docker.xuanyuan.run/keepalived-docker
    container_name: keepalived
    network_mode: host
    cap_add:
      - NET_ADMIN
      - NET_BROADCAST
      - NET_RAW
    volumes:
      - ./keepalived.conf:/etc/keepalived/keepalived.conf
    restart: always  # 容器异常退出时自动重启

注意事项

• 必须使用主机网络模式（--net=host），否则VRRP协议无法正常工作
• 主备节点的virtual_router_id和auth_pass必须完全一致
• 主节点priority值需高于备节点（建议差值≥10）
• 根据实际服务器网络接口修改配置文件中的interface参数（如eth0、ens33等）
• 生产环境中建议使用持久化存储挂载配置文件，避免容器重建导致配置丢失