fhriley/keepalived

keepalived 镜像文档

镜像概述

该镜像基于keepalived构建，集成了curl、jq和Docker客户端工具，提供高可用性和负载均衡解决方案，同时支持与Docker环境的集成及自动化操作。

核心功能与特性

• 基础功能：提供keepalived核心高可用和负载均衡能力
• 工具集成：内置curl（HTTP客户端）、jq（JSON处理工具）和Docker客户端
• 网络模式：支持host网络模式，确保网络层直接访问
• 权限支持：需NET_ADMIN、NET_BROADCAST和NET_RAW系统能力
• 持久化配置：支持通过卷挂载自定义keepalived配置文件
• Docker集成：可通过挂载docker.sock与Docker守护进程通信

使用场景与适用范围

• 高可用性服务器集群环境
• Docker容器化服务的负载均衡需求
• 需要脚本（结合curl和jq）实现健康检查或自动化操作的场景
• 快速部署keepalived并集成Docker环境的场景

使用方法与配置说明

前置要求

• Docker引擎已安装并运行
• 宿主机网络支持VRRP（虚拟路由冗余协议）
• 适当文件权限用于挂载配置文件和docker.sock

Docker Compose配置示例

yaml
version: '3.6'

services:
  keepalived:
    image: fhriley/keepalived
    network_mode: host  # 使用主机网络模式，确保VRRP报文正常传输
    cap_add:
      - NET_ADMIN       # 允许网络管理操作
      - NET_BROADCAST   # 允许广播操作
      - NET_RAW         # 允许原始套接字访问
    restart: always     # 容器退出时自动重启
    volumes:
      - ./keepalived.conf:/etc/keepalived/keepalived.conf:ro  # 挂载自定义配置文件（只读）
      - /var/run/docker.sock:/var/run/docker.sock  # 挂载Docker守护进程套接字，实现Docker集成

Docker Run命令示例

bash
docker run -d \
  --name keepalived \
  --network host \
  --cap-add=NET_ADMIN \
  --cap-add=NET_BROADCAST \
  --cap-add=NET_RAW \
  --restart always \
  -v ./keepalived.conf:/etc/keepalived/keepalived.conf:ro \
  -v /var/run/docker.sock:/var/run/docker.sock \
  fhriley/keepalived

配置说明

• 网络模式：必须使用host网络模式，VRRP协议需在主机网络层发送组播报文
• 权限配置：cap_add参数添加必要网络权限，确保keepalived正常工作
• 配置文件：通过./keepalived.conf挂载自定义配置，需符合keepalived标准格式
• Docker集成：挂载/var/run/docker.sock后，可在容器内使用docker命令管理宿主机容器