cobra1978/keepalived Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Alpine Keepalived Ultra-Light

![Docker Image Build]([] ![License: MIT]([] !Alpine Version

A high-performance, ultra-lightweight Keepalived container based on Alpine Linux 3.23. This image is stripped of heavy frameworks (no Python, no Osixia-bloat) to provide a minimal footprint and maximum security.

🚀 Features

• Ultra-lightweight: ~15MB total size (compared to 100MB+ for Python-based alternatives).
• Modern Engine: Built on Alpine 3.23 with Keepalived 2.3.4.
• Hybrid Configuration: Supports both automatic generation via Environment Variables and custom configuration via Volume mounting.
• Real-time Logging: Logs are natively redirected to stdout/stderr for seamless integration with docker logs.
• CI/CD Ready: Designed for automated builds via GitHub Actions and GHCR.

🛠 Usage & Deployment

1. Simple Mode (Environment Variables)

Perfect for standard Master/Backup setups. Configuration is generated automatically at startup.

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

2. Advanced Mode (Custom File)

If you need complex features like Unicast Peers, multiple VRRP instances, or health-check scripts, mount your own configuration.

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

Configuration Reference (Tabella per il README)

⚙️ Configuration Reference

🏗 Build & Automation

Local Build

bash
docker build -t my-keepalived .

GitHub Actions Integration

The image is built and pushed automatically on every tag or push to main. The build process uses multi-stage builds to ensure the final image contains no build-time dependencies.

Troubleshooting & Debugging

View real-time logs:

bash
docker logs -f keepalived

Verify the active configuration generated by the entrypoint:

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

Check network status and assigned VIPs:

bash
docker exec -it keepalived ip addr show

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Maintained with ❤️ by [MarcelloPercoco]