suconghou/keepalived

keepalived Docker镜像文档

镜像概述

keepalived Docker镜像是一个轻量级高可用解决方案，基于keepalived 1.2.23版本构建，镜像总大小仅5.412 MB。keepalived是一款基于VRRP（虚拟路由冗余协议）的工具，主要用于实现服务器集群的故障转移和负载均衡，确保服务持续可用。

项目资源：

• Dockerfile地址：https://github.com/suconghou/docker/tree/master/keepalived
• 镜像仓库地址：https://hub.docker.com/r/suconghou/keepalived/

核心功能与特性

• 高可用保障：基于VRRP协议实现主备节点自动故障检测与切换
• 轻量级设计：镜像体积仅5.412 MB，资源占用低，部署高效
• 稳定版本：基于keepalived 1.2.23稳定版构建，兼容性良好
• 灵活配置：支持通过挂载配置文件自定义VRRP实例、虚拟IP等参数

使用场景

• 服务器集群高可用部署，保障关键服务不中断
• 负载均衡器（如Nginx、HAProxy）的冗余备份方案
• 数据库、Web服务等关键应用的故障自动转移
• 中小规模架构的低成本高可用解决方案

使用方法

1. 拉取镜像

bash
docker pull suconghou/keepalived:latest

2. 基本运行命令

keepalived需要网络管理权限和主机网络模式以正常工作：

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

3. 配置文件说明

核心配置通过keepalived.conf文件实现，需挂载到容器内/etc/keepalived/keepalived.conf路径。典型配置示例：

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

4. 关键参数说明

• --net=host：使用主机网络模式，确保VRRP协议正常通信
• --cap-add=NET_ADMIN：赋予容器网络管理权限，必要的权限配置
• 配置文件挂载：必须通过-v参数挂载自定义配置文件，否则使用默认配置

注意事项

• 主备节点的virtual_router_id和auth_pass必须保持一致
• priority值需根据主备角色设置（MASTER > BACKUP）
• 确保主机防火墙允许VRRP协议通信（默认使用224.0.0.18多播地址）
• 生产环境建议通过Docker Compose或容器编排工具管理服务