bara/keepalived

keepalived 镜像文档

镜像概述

本镜像基于Alpine Linux构建，集成了keepalived服务和netstat网络诊断工具。通过环境变量即可完成配置，无需手动编辑复杂的配置文件，简化了高可用集群中VRRP（虚拟路由冗余协议）的部署流程。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 预安装工具：内置netstat，方便进行网络状态诊断与调试
• 环境变量配置：支持通过环境变量定义keepalived核心参数，无需手动修改配置文件
• VRRP协议支持：实现虚拟IP（VIP）的自动漂移，确保服务高可用

使用场景

• 需要构建高可用集群的服务器环境（如Web服务器、数据库服务器等）
• 需实现自动故障转移的关键业务系统
• 对资源占用敏感，需要轻量级部署方案的场景

环境变量说明

使用方法

基本部署（docker run）

以下示例部署两个节点组成高可用集群，节点1为主节点（优先级100），节点2为备节点（优先级90）：

节点1（主节点）：

bash
docker run -d --name keepalived-master \
  --net=host \
  --cap-add=NET_ADMIN \
  -e KEEPALIVED_INTERFACE=eth0 \
  -e KEEPALIVED_PRIORITY=100 \
  -e KEEPALIVED_SELF=192.168.1.10 \
  -e KEEPALIVED_PEER=192.168.1.11 \
  -e KEEPALIVED_VIRTUAL_IP=192.168.1.100 \
  -e KEEPALIVED_PASSWORD=vrrp_secure_pass \
  <镜像名称>

节点2（备节点）：

bash
docker run -d --name keepalived-backup \
  --net=host \
  --cap-add=NET_ADMIN \
  -e KEEPALIVED_INTERFACE=eth0 \
  -e KEEPALIVED_PRIORITY=90 \
  -e KEEPALIVED_SELF=192.168.1.11 \
  -e KEEPALIVED_PEER=192.168.1.10 \
  -e KEEPALIVED_VIRTUAL_IP=192.168.1.100 \
  -e KEEPALIVED_PASSWORD=vrrp_secure_pass \
  <镜像名称>

docker-compose 部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  keepalived-master:
    image: <镜像名称>
    container_name: keepalived-master
    network_mode: host
    cap_add:
      - NET_ADMIN
    environment:
      - KEEPALIVED_INTERFACE=eth0
      - KEEPALIVED_PRIORITY=100
      - KEEPALIVED_SELF=192.168.1.10
      - KEEPALIVED_PEER=192.168.1.11
      - KEEPALIVED_VIRTUAL_IP=192.168.1.100
      - KEEPALIVED_PASSWORD=vrrp_secure_pass
    restart: always

  keepalived-backup:
    image: <镜像名称>
    container_name: keepalived-backup
    network_mode: host
    cap_add:
      - NET_ADMIN
    environment:
      - KEEPALIVED_INTERFACE=eth0
      - KEEPALIVED_PRIORITY=90
      - KEEPALIVED_SELF=192.168.1.11
      - KEEPALIVED_PEER=192.168.1.10
      - KEEPALIVED_VIRTUAL_IP=192.168.1.100
      - KEEPALIVED_PASSWORD=vrrp_secure_pass
    restart: always

启动集群：

bash
docker-compose up -d

注意事项

• 需添加--cap-add=NET_ADMIN权限，确保keepalived能正常管理网络接口
• --net=host模式需根据实际网络环境调整，确保容器能与主机网络直接通信
• 虚拟IP需与节点IP在同一网段，且未被其他设备占用
• 优先级需根据主备角色合理设置，主节点优先级高于备节点