visibilityspots/keepalived

Keepalived Docker镜像

镜像概述和主要用途

该Docker镜像用于运行http://keepalived.org/服务，提供VRRP（虚拟路由冗余协议）实现，确保网络服务的高可用性。

本镜像最初基于https://github.com/linkvt/docker-keepalived的工作，在保持核心功能的同时，为满足特定需求对实现方式进行了简化。

核心功能和特性

• 实现VRRP协议，提供网络服务的高可用保障
• 通过环境变量灵活配置Keepalived参数
• 支持单播模式和虚拟IP配置
• 轻量级设计，易于部署和维护

使用场景和适用范围

• 需要实现服务高可用的服务器集群环境
• 负载均衡器的冗余备份配置
• 关键网络服务的故障自动转移
• Docker容器化环境中的网络高可用方案

前置要求

• 主机需加载ip_vs内核模块：modprobe ip_vs
• 必须以主机网络模式运行：--net=host
• 需要特定的Linux capabilities权限

使用方法

基本运行命令

bash
docker run --cap-add=NET_ADMIN --cap-add=NET_BROADCAST --cap-add=NET_RAW --net=host --name keepalived --rm docker.xuanyuan.run/visibilityspots/keepalived:latest

Docker Compose配置示例

yaml
version: '3'
services:
  keepalived:
    image: docker.xuanyuan.run/visibilityspots/keepalived:latest
    container_name: keepalived
    network_mode: host
    cap_add:
      - NET_ADMIN
      - NET_BROADCAST
      - NET_RAW
    environment:
      - KEEPALIVED_INTERFACE=eno1
      - KEEPALIVED_STATE=MASTER
      - KEEPALIVED_ROUTER_ID=21
      - KEEPALIVED_PRIORITY=200
      - KEEPALIVED_UNICAST_PEERS=192.168.0.11 192.168.0.12
      - KEEPALIVED_VIRTUAL_IPS=192.168.0.10/24
      - KEEPALIVED_PASSWORD=secure_password
    restart: always

配置说明

环境变量参数

Dockerfile中设置了以下环境变量默认值，可根据需求覆盖：

覆盖环境变量

通过--env参数可以覆盖默认环境变量，例如：

bash
docker run --cap-add=NET_ADMIN --cap-add=NET_BROADCAST --cap-add=NET_RAW --net=host \
  --env KEEPALIVED_INTERFACE="eno1" \
  --env KEEPALIVED_PASSWORD="password!" \
  --env KEEPALIVED_PRIORITY="100" \
  --env KEEPALIVED_STATE="MASTER" \
  --env KEEPALIVED_VIRTUAL_IPS="10.0.0.100/24" \
  --name keepalived --rm docker.xuanyuan.run/visibilityspots/keepalived:latest

构建镜像

本地构建

bash
docker build -t visibilityspots/keepalived:latest .

多平台构建

bash
# 配置QEMU支持
docker run --rm --privileged docker.xuanyuan.run/multiarch/qemu-user-static --reset -p yes

# 构建并推送多平台镜像
docker buildx build -t visibilityspots/keepalived:latest \
  --platform linux/amd64,linux/arm/v6,linux/arm/v7 \
  --push .

测试

可使用https://github.com/aelsabbahy/goss/tree/master/extras/dgoss工具运行goss测试：

bash
dgoss run visibilityspots/keepalived:2.2.8

许可证

本项目采用https://github.com/visibilityspots/dockerfile-keepalived/blob/master/LICENSE。