freemanliu/keepalived

Keepalived Docker镜像文档

镜像概述

本镜像基于Keepalived构建，用于实现高可用性(HA)解决方案。通过VRRP(虚拟路由冗余协议)管理虚拟IP地址，可在多个节点间自动进行主备切换，确保服务持续可用。适用于需要高可靠性的服务场景，如Web服务、数据库等关键业务系统。

核心功能与特性

• VRRP协议支持：实现虚拟路由冗余，支持多节点集群配置
• 虚拟IP管理：自动分配和管理虚拟IP地址，确保服务访问连续性
• 健康检查机制：通过指定IP和端口进行节点健康状态检测
• 灵活配置：支持自定义VRID、网络接口、虚拟IP及子网掩码等参数
• 自动重启：支持容器自动重启策略，提高服务稳定性

使用场景

• 关键业务系统的高可用部署
• 需要避免单点故障的服务架构
• 多节点集群环境中的虚拟IP管理
• 主备服务器切换控制

使用方法

基本部署命令

通过以下命令快速部署Keepalived容器：

bash
docker run -d --name kp2 --restart=always --net=host --cap-add=NET_ADMIN \
  -e VRID=53 \
  -e INTERFACE=eth0 \
  -e VIRTUAL_IP=192.168.0.111 \
  -e HOST_IP1=192.168.0.104 \
  -e HOST_IP2=192.168.0.104 \
  -e HOST_IP3=192.168.0.104 \
  -e VIRTUAL_MASK=24 \
  -e CHECK_IP=any \
  -e CHECK_PORT=22 \
  docker.xuanyuan.run/freemanliu/keepalived:v2.0.4

配置参数说明

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  keepalived:
    image: docker.xuanyuan.run/freemanliu/keepalived:v2.0.4
    container_name: kp2
    restart: always
    network_mode: host
    cap_add:
      - NET_ADMIN
    environment:
      - VRID=53
      - INTERFACE=eth0
      - VIRTUAL_IP=192.168.0.111
      - HOST_IP1=192.168.0.104
      - HOST_IP2=192.168.0.105
      - HOST_IP3=192.168.0.106
      - VIRTUAL_MASK=24
      - CHECK_IP=any
      - CHECK_PORT=80

启动服务：

bash
docker-compose up -d

注意事项

1. 需使用--net=host网络模式以确保VRRP协议正常工作
2. 必须添加NET_ADMIN权限以允许网络配置操作
3. 同一VRID的集群节点需确保网络互通
4. 健康检查端口应选择服务实际使用的端口（如80、443等）
5. 多节点部署时，各节点的HOST_IP参数应配置为集群内所有节点的IP地址