keepalived_containers 镜像文档

镜像概述和主要用途

keepalived_containers 是 keepalived 的容器化部署方案，用于实现基于 VRRP 协议的高可用集群。该镜像支持通过环境变量快速配置或自定义配置文件，简化部署流程，同时提供多架构支持（amd64/arm64），适用于需要高可用虚拟 IP（VIP）的场景，如负载均衡器、数据库集群等关键服务的故障转移。

核心功能和特性

• 多版本支持：构建 keepalived 2.0.0 以上版本（部分因构建依赖问题排除），包含 2.2.3、2.2.4、2.2.7 等稳定版本。
• 多架构兼容：支持 amd64 和 arm64 架构，Docker Hub 自动匹配对应平台镜像。
• 灵活配置：支持通过环境变量快速配置、自定义模板（含变量占位符）或完全自定义配置文件。
• 自动更新：每 15 天自动重建镜像以更新基础依赖，新版本 keepalived 会自动纳入构建。

使用场景和适用范围

• 需要高可用虚拟 IP 的服务器集群（如负载均衡入口、数据库主从切换）。
• 快速部署 VRRP 实例，实现服务 IP 的自动故障转移。
• 跨架构环境（x86_64 和 ARM64 服务器）的高可用部署需求。

详细使用方法和配置说明

快速启动

前置条件：主机需加载 ip_vs 内核模块（执行 modprobe ip_vs）。容器需使用 --cap-add=NET_ADMIN 权限和 --net=host 网络模式。

基础启动命令：

bash
docker run --cap-add=NET_ADMIN --net=host -d ednxzu/keepalived:latest

版本信息

所有镜像可在 Dockerhub 获取。

包含版本

• 2.2.3、2.2.4、2.2.7、2.2.8、2.3.0、2.3.1、2.3.2、2.3.3、2.3.4

排除版本

• 2.2.0、2.2.1、2.2.2、2.2.5（非实际发布版本）、2.2.6（构建依赖未解决）

版本标签支持 X.Y.Z（精确版本）、X.Y（主版本）、X（大版本）及 latest（最新版），自动更新。

架构支持

支持 amd64 和 arm64 架构，Docker Hub 提供多架构清单，拉取时自动匹配当前平台的镜像。ARM64 支持由 nano9g 贡献。

配置说明

简单配置（环境变量）

通过环境变量快速配置，无需修改配置文件。支持的环境变量如下：

示例：部署虚拟 IP 10.1.20.10 到接口 ens1：

bash
docker run --cap-add=NET_ADMIN \
--net=host \
-e INTERFACE=ens1 \
-e VIRTUAL_IPS="10.1.20.10" \
ednxzu/keepalived

自定义模板

通过挂载包含 {变量名} 占位符的模板文件，结合环境变量生成配置。例如，挂载自定义模板并注入变量：

bash
docker run --cap-add=NET_ADMIN \
--net=host \
-v "./custom-template.conf:/etc/keepalived/keepalived.conf" \
-e INTERFACE=ens1 \
-e YOUR_VARIABLE=1337 \
ednxzu/keepalived

完全自定义配置

若配置文件中无 {*} 占位符，镜像将直接使用该文件。可挂载完整配置目录（如包含检查脚本等高级功能）：

bash
docker run --cap-add=NET_ADMIN \
--net=host \
-v "./keepalived:/etc/keepalived" \
ednxzu/keepalived

docker-compose 示例

yaml
version: '3'
services:
  keepalived:
    image: ednxzu/keepalived:latest
    cap_add:
      - NET_ADMIN
    network_mode: host
    environment:
      - INTERFACE=ens1
      - VIRTUAL_IPS=10.1.20.10
      - STATE=BACKUP
      - PRIORITY=90
    restart: always