cobra1978/keepalived

Alpine Keepalived 超轻量版

https://github.com/MarcelloPercoco/keepalived/actions/workflows/docker-build.yml/badge.svg](https://github.com/MarcelloPercoco/keepalived/actions) ![许可证：MIT]([***] !Alpine版本

一个基于Alpine Linux 3.23的高性能、超轻量级Keepalived容器。该镜像剥离了重量级框架（无Python、无Osixia冗余组件），以提供最小的占用空间和最高的安全性。

🚀 特性

• 超轻量级：总大小约15MB（相比基于Python的替代方案100MB+）。
• 现代引擎：基于Alpine 3.23构建，包含Keepalived 2.3.4。
• 混合配置：支持通过环境变量自动生成配置和通过卷挂载自定义配置。
• 实时日志：日志原生重定向至stdout/stderr，可无缝集成docker logs。
• CI/CD就绪：专为通过GitHub Actions和GHCR的自动构建设计。

🛠 使用与部署

1. 简单模式（环境变量）

适用于标准主/备设置。启动时自动生成配置。

yaml
services:
  keepalived:
    image: ghcr.io/your-username/keepalived:latest
    cap_add:
      - NET_ADMIN
      - NET_RAW
    network_mode: host # VRRP必需
    environment:
      - STATE=MASTER
      - INTERFACE=eth0
      - VIRTUAL_IP=192.168.1.100/24
      - PRIORITY=101
      - ROUTER_ID=51

2. 高级模式（自定义文件）

如果需要复杂功能，如单播对等体、多个VRRP实例或健康检查脚本，可挂载自定义配置。

yaml
services:
  keepalived:
    image: ghcr.io/your-username/keepalived:latest
    cap_add:
      - NET_ADMIN
      - NET_RAW
    network_mode: host
    volumes:
      - ./my-keepalived.conf:/etc/keepalived/keepalived.conf:ro

⚙️ 配置参考

🏗 构建与自动化

本地构建

bash
docker build -t my-keepalived .

GitHub Actions集成

每次标记或推送到main分支时，镜像会自动构建并推送。构建过程使用多阶段构建，确保最终镜像不包含构建时依赖。

故障排除与调试

查看实时日志：

bash
docker logs -f keepalived

验证入口点生成的活动配置：

bash
docker exec -it keepalived cat /etc/keepalived/keepalived.conf

检查网络状态和已分配的VIP：

bash
docker exec -it keepalived ip addr show

📄 许可证

本项目采用MIT许可证 - 详见LICENSE文件。

由[MarcelloPercoco]用心维护 ❤️