osixia/keepalived Docker 镜像

镜像概述和主要用途

该镜像是基于Keepalived的Docker化实现，提供通过环境变量进行快速启动配置的能力。镜像源码及帮助文档可在GitHub获取：https://github.com/osixia/docker-keepalived。主要用于在Docker环境中部署高可用解决方案，通过VRRP（虚拟路由冗余协议）实现IP地址故障转移，确保服务持续可用。

核心功能和特性

• 环境变量配置：支持通过环境变量直接配置核心参数，无需手动编写配置文件
• VRRP协议支持：实现标准VRRP协议，支持主备节点自动切换
• 容器化部署：轻量级Docker镜像，部署简单，易于集成到现有容器环境
• 源码可扩展：GitHub提供完整源代码，支持自定义修改和功能扩展

使用场景和适用范围

• 高可用服务器环境（如Web服务器、负载均衡器前端）
• 数据库主从架构中的虚拟IP（VIP）管理
• 云环境或容器化部署中的服务冗余与故障转移
• 中小型企业基础设施的高可用构建

使用方法和配置说明

基本部署（docker run）

通过以下命令快速启动Keepalived容器：

bash
docker run -d --name keepalived \
  --cap-add=NET_ADMIN \
  --cap-add=NET_BROADCAST \
  --cap-add=NET_RAW \
  -e KEEPALIVED_INTERFACE=eth0 \
  -e KEEPALIVED_VIRTUAL_IPS=192.168.1.100/24 \
  -e KEEPALIVED_STATE=MASTER \
  -e KEEPALIVED_PRIORITY=100 \
  docker.xuanyuan.run/osixia/keepalived

核心环境变量说明

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  keepalived:
    image: docker.xuanyuan.run/osixia/keepalived
    container_name: keepalived
    cap_add:
      - NET_ADMIN
      - NET_BROADCAST
      - NET_RAW
    environment:
      - KEEPALIVED_INTERFACE=eth0
      - KEEPALIVED_VIRTUAL_IPS=192.168.1.100/24
      - KEEPALIVED_STATE=MASTER
      - KEEPALIVED_PRIORITY=100
      - KEEPALIVED_AUTH_PASSWORD=mysecret
      - KEEPALIVED_UNICAST_PEERS=192.168.1.11
    restart: always

启动服务：

bash
docker-compose up -d