solnetcloud/keepalived

docker-keepalived 镜像文档

镜像概述

docker-keepalived 是基于 Ubuntu 镜像构建的 Keepalived 容器化实现。Keepalived 是一款路由软件，旨在为 Linux 系统及基于 Linux 的基础设施提供简单且健壮的负载均衡和高可用能力。本容器通过 VRRP（虚拟路由冗余协议）提供高可用 IP 地址，是实现路由器故障转移的基础组件。更多信息可访问官方网站：[***]

核心功能与特性

• VRRP 协议支持：通过 VRRP 协议实现虚拟 IP（VIP）的高可用分配
• 主从节点配置：支持配置主节点（master）和从节点（slave），通过优先级实现故障自动切换
• 灵活的虚拟 IP 管理：支持指定包含或排除的虚拟 IP 及对应网络接口
• 健康检查机制：支持自定义检查脚本或默认 URL 健康检查（注：--enable-check 功能暂未实现，请勿使用）
• 安全认证：支持配置 VRRP 认证密码，增强通信安全性

使用场景

• 需要高可用网络架构的服务器集群（如 Web 服务器、数据库服务器等）
• 需实现虚拟 IP 故障自动转移的场景
• 构建基于 Linux 的负载均衡和高可用基础设施

使用方法

基本要求

• 必须使用主机网络模式（--net=host）
• 必须以特权模式运行（--privileged=true）
• 建议配置日志重定向到 syslog（需 Docker 1.6+）
• 建议配置故障自动重启（--restart=on-failure）

防火墙配置

需确保防火墙允许多播流量和 VRRP 协议：

bash
iptables -I INPUT -d 224.0.0.0/8 -j ACCEPT
iptables -I INPUT -p vrrp -j ACCEPT

部署示例

基本主节点运行命令：

bash
docker run -d \
  --restart=on-failure \
  --log-driver=syslog \
  --net=host \
  --privileged=true \
  solnetcloud/keepalived:latest \
  --master eth0 100 203.0.113.0/24/eth0

推荐配置（指定 VRID 和认证密码）：

bash
docker run -d \
  --restart=on-failure \
  --log-driver=syslog \
  --net=host \
  --privileged=true \
  solnetcloud/keepalived:latest \
  --master --vrid 51 --auth-pass "your-auth-password" eth0 100 203.0.113.0/24/eth0

配置参数说明

位置参数

可选参数

注意事项

• 主节点和从节点的优先级应不同，通常主节点优先级高于从节点
• 建议显式指定 VRID（范围 1-255），确保同一网络中不重复
• 认证密码应在所有节点间保持一致
• --enable-check 功能尚未实现，使用该标志可能导致异常