peterweissdk/keepalived

💾 Keepalived Docker容器

![Static Badge]([] ![Static Badge]([] ![Static Badge]([] ![Static Badge]([]

一个基于Alpine的轻量级Docker容器，用于运行支持VRRP（虚拟路由器冗余协议）的Keepalived。

✨ 核心特性

• Alpine基础：轻量级且安全的基础镜像
• VRRP支持：通过虚拟路由器冗余协议（VRRP）实现高可用性
• 简便配置：使用环境变量和服务检查脚本配置Keepalived
• 健康检查：内置Docker健康检查功能，监控服务状态

🚀 快速开始

运行容器：

bash
# 拉取镜像
docker pull peterweissdk/keepalived

# 使用自定义配置运行
docker run -d \
  --name keepalived \
  --restart=unless-stopped \
  --cap-add=NET_ADMIN \
  --cap-add=NET_BROADCAST \
  --cap-add=NET_RAW \
  --net=host \
  --env-file .env \
  keepalived:latest

# 使用提供的Docker Compose和.env文件运行容器
docker compose up -d

🔧 配置

环境变量

所需权限

• NET_ADMIN：用于网络接口配置
• NET_BROADCAST：用于VRRP通告
• NET_RAW：用于原始套接字访问

服务检查脚本

创建定期运行的服务状态检查脚本。创建绑定挂载并将脚本复制到其中：

• 脚本名称：check-script.sh
• 绑定挂载点：/usr/local/scripts/
• 运行间隔：2秒

🏗️ 从源码构建

bash
# 克隆仓库
git clone https://github.com/peterweissdk/keepalived.git
cd keepalived

# 构建镜像
docker build -t keepalived:latest .

📝 目录结构

bash
keepalived/
├── conf/
│   └── keepalived.conf_tpl
├── scripts/
│   └── check_and_run.sh
├── .github/
├── .env
├── Dockerfile
├── docker-entrypoint.sh
├── healthcheck.sh
├── docker-compose.yml
├── LICENSE
└── README.md

🔍 健康检查

容器包含全面的健康检查系统，监控以下内容：

1. Keepalived进程状态

   • 验证keepalived守护进程是否运行

2. 虚拟IP环境变量

   • 验证VIRTUAL_IPS环境变量是否已设置

查看健康状态：

bash
docker inspect --format='{{.State.Health.Status}}' keepalived

查看详细健康检查历史：

bash
docker inspect --format='{{json .State.Health}}' keepalived | jq

实时监控健康状态：

bash
watch -n 5 'docker inspect --format="{{.State.Health.Status}}" keepalived'

🤝 贡献

欢迎贡献！请随时提交Pull Request。

🆘 支持

如果遇到任何问题或需要支持，请在GitHub仓库提交issue。

📄 许可证

本项目采用GNU GENERAL PUBLIC LICENSE v3.0许可 - 详见LICENSE文件。