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

Keepalived Docker镜像文档

镜像概述

本镜像基于osixia/docker-keepalived构建，提供Keepalived服务的容器化部署方案。Keepalived是一款基于VRRP（虚拟路由冗余协议）的高可用解决方案，可实现服务的故障转移，确保关键服务持续可用。

核心功能与特性

• 主备模式支持：可配置为主节点（MASTER）或备节点（BACKUP），实现自动故障转移
• 环境变量配置：通过环境变量灵活配置网络接口、优先级、虚拟IP等关键参数
• 虚拟IP管理：支持配置多个虚拟IP地址，实现服务IP的高可用
• 通知脚本支持：内置通知脚本，可在节点状态变化时执行自定义操作

使用场景

适用于需要高可用性保障的服务场景，如：

• 负载均衡器（如Nginx、HAProxy）的高可用部署
• 数据库服务的主备切换
• 关键业务服务的故障转移保障

使用方法

运行主节点（MASTER）

bash
docker run --name keepalived -p 81:81 \
  --env KEEPALIVED_INTERFACE="<interface>" \
  --env KEEPALIVED_STATE="MASTER" \
  --env KEEPALIVED_PRIORITY="<priority>" \
  --cap-add=NET_ADMIN \
  --net=host \
  -d alissongranemann/keepalived

运行备节点（BACKUP）

bash
docker run --name keepalived -p 81:81 \
  --env KEEPALIVED_INTERFACE="<interface>" \
  --env KEEPALIVED_STATE="BACKUP" \
  --env K KEEPALIVED_PRIORITY="<priority>" \
  --cap-add=NET_ADMIN \
  --net=host \
  -d alissongranemann/keepalived

注意：--cap-add=NET_ADMIN 用于赋予容器网络管理权限，--net=host 使容器使用主机网络栈，确保VRRP协议正常工作。

环境变量配置

默认值

配置说明

• KEEPALIVED_INTERFACE：指定运行VRRP协议的网络接口，需与主机实际网络接口名称匹配
• KEEPALIVED_PRIORITY：主节点应设置高于备节点的优先级（如主节点200，备节点100）
• KEEPALIVED_VIRTUAL_IPS：配置需要漂移的虚拟IP地址，客户端通过这些IP访问服务
• KEEPALIVED_NOTIFY：可自定义脚本路径，实现状态变化时的通知（如发送邮件、调用API等）