gloppenhosting/keepalived

keepalived Kamailio虚拟IP管理镜像

镜像概述

本Docker镜像基于keepalived构建，专为Kamailio服务器集群设计，用于实现虚拟IP（VIP）的高可用管理。通过提供故障检测与自动转移机制，确保Kamailio服务在集群环境中持续可用，避免单点故障导致的服务中断。

核心功能与特性

• 虚拟IP管理：支持为Kamailio集群分配和管理虚拟IP地址
• 故障检测：实时监控Kamailio服务器状态，检测节点故障
• 自动故障转移：当主节点故障时，自动将虚拟IP切换至备用节点
• 轻量级部署：基于Docker容器化部署，简化配置与维护
• 高兼容性：专为Kamailio服务器优化，适配其网络架构需求

使用场景与适用范围

• Kamailio服务器集群的高可用部署
• VoIP服务中SIP服务器的冗余架构构建
• 需要确保持续服务可用性的电信级应用
• 对服务中断敏感的实时通信系统

使用方法与配置说明

基本部署命令

bash
docker run -d \
  --name keepalived-kamailio \
  --cap-add=NET_ADMIN \
  --net=host \
  -e VIP=192.168.1.100 \
  -e INTERFACE=eth0 \
  -e PRIORITY=100 \
  -e STATE=MASTER \
  -e AUTH_PASSWORD=secret \
  your-image-name:tag

环境变量配置说明

docker-compose配置示例

yaml
version: '3'
services:
  keepalived:
    image: your-image-name:tag
    container_name: keepalived-kamailio
    cap_add:
      - NET_ADMIN
    network_mode: host
    environment:
      - VIP=192.168.1.100
      - INTERFACE=eth0
      - PRIORITY=100
      - STATE=MASTER
      - AUTH_PASSWORD=secret
      - VIRTUAL_ROUTER_ID=51
    restart: always

注意事项

• 容器需要NET_ADMIN权限以管理网络配置
• 使用--net=host模式确保网络层直接访问主机网络
• 主备节点需配置不同优先级，主节点优先级高于备用节点
• 所有节点的VIRTUAL_ROUTER_ID和AUTH_PASSWORD必须保持一致
• 确保Kamailio服务已正确配置监听虚拟IP地址