visibilityspots/keepalived

Keepalived Docker镜像

!https://github.com/visibilityspots/dockerfile-keepalived/actions/workflows/trivy.yml/badge.svg !https://github.com/visibilityspots/dockerfile-keepalived/actions/workflows/docker-hub-description.yml/badge.svg !https://github.com/visibilityspots/dockerfile-keepalived/actions/workflows/main.yml/badge.svg !gitHub release !docker image size !docker pulls !license !https://app.fossa.com/api/projects/git%2Bgithub.com%2Fvisibilityspots%2Fdockerfile-keepalived.svg?type=shield&issueType=license

镜像概述和主要用途

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

本镜像最初基于https://github.com/linkvt/docker-keepalived%E7%9A%84%E5%B7%A5%E4%BD%9C%EF%BC%8C%E5%9C%A8%E4%BF%9D%E6%8C%81%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E7%9A%84%E5%90%8C%E6%97%B6%EF%BC%8C%E4%B8%BA%E6%BB%A1%E8%B6%B3%E7%89%B9%E5%AE%9A%E9%9C%80%E6%B1%82%E5%AF%B9%E5%AE%9E%E7%8E%B0%E6%96%B9%E5%BC%8F%E8%BF%9B%E8%A1%8C%E4%BA%86%E7%AE%80%E5%8C%96%E3%80%82

核心功能和特性

• 实现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 visibilityspots/keepalived:latest

Docker Compose配置示例

yaml
version: '3'
services:
  keepalived:
    image: 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 visibilityspots/keepalived:latest

构建镜像

本地构建

bash
docker build -t visibilityspots/keepalived:latest .

多平台构建

bash
# 配置QEMU支持
docker run --rm --privileged 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%E5%B7%A5%E5%85%B7%E8%BF%90%E8%A1%8Cgoss%E6%B5%8B%E8%AF%95%EF%BC%9A

bash
dgoss run visibilityspots/keepalived:2.2.8

许可证

本项目采用https://github.com/visibilityspots/dockerfile-keepalived/blob/master/LICENSE%E3%80%82