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

docker-swarm-keepalived

Docker Swarm集群中的keepalived操作器，用于管理高可用虚拟IP（VIP），确保服务在集群节点间的持续可用性。该镜像基于osixia/docker-keepalived构建，支持通过节点标签配置优先级，适用于需要稳定VIP入口的Swarm集群场景。

核心功能与特性

• 高可用VIP管理：通过keepalived实现虚拟IP在Swarm集群节点间的自动故障转移
• 节点优先级控制：支持通过Docker节点标签（KEEPALIVED_PRIORITY）设置节点优先级
• 多VIP支持：可同时配置多个虚拟IP地址
• 全局部署模式：以Swarm全局模式部署，确保在指定节点上持续运行
• Host网络支持：使用host网络模式，保证网络层的直接访问能力

使用场景

• Docker Swarm集群需要稳定的虚拟IP作为服务访问入口
• 实现Swarm集群的高可用负载均衡前端
• 确保关键服务在节点故障时通过VIP自动切换到健康节点

使用方法与配置说明

前置准备

1. 启用ip_vs内核模块
   keepalived依赖ip_vs内核模块，需确保其已启用：

   sh
   lsmod | grep -P '^ip_vs\s' || (echo "modprobe ip_vs" >> /etc/modules && modprobe ip_vs)
   

2. 设置节点优先级
   通过节点标签为每个Swarm节点配置不同优先级（值越高优先级越高）：

   sh
   # 示例：为三个节点分别设置优先级
   docker node update node1 --label-add KEEPALIVED_PRIORITY=100
   docker node update node2 --label-add KEEPALIVED_PRIORITY=200
   docker node update node3 --label-add KEEPALIVED_PRIORITY=300
   

部署Docker Stack

创建docker-compose.yml文件，配置如下：

yaml
version: '3.7'

services:
  keepalived:
    image: lolhens/keepalived-swarm:latest
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 挂载Docker套接字以访问Swarm节点信息
      - /usr/bin/docker:/usr/bin/docker:ro          # 只读挂载Docker二进制文件
    networks:
      - host
    deploy:
      mode: global                                  # 全局模式，在符合条件的所有节点上运行
      placement:
        constraints: [node.role == manager]         # 仅在Swarm管理节点部署
    environment:
      KEEPALIVED_VIRTUAL_IPS: "192.168.1.231, 192.168.1.232"  # 虚拟IP列表，多个IP用逗号分隔

networks:
  host:
    external: true  # 使用主机网络
    name: host

部署命令：

sh
docker stack deploy -c docker-compose.yml keepalived

环境变量说明

镜像信息

• Docker Hub地址：lolhens/keepalived-swarm
• 支持架构：多架构镜像，适配常见CPU架构

帮助链接

• keepalived官方仓库
• osixia/docker-keepalived
• Docker Swarm高可用配置指南

许可证

本项目采用Apache 2.0许可证。详见LICENSE文件。