alissongranemann/keepalived
alissongranemann
基于osixia/docker-keepalived的Keepalived Docker镜像，支持主备模式部署，通过VRRP协议实现高可用性，可配置虚拟IP和通知脚本。
下载次数: 0状态：社区镜像维护者：alissongranemann仓库类型：镜像最近更新：8 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Keepalived Docker镜像文档
镜像概述
本镜像基于https://github.com/osixia/docker-keepalived%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9BKeepalived%E6%9C%8D%E5%8A%A1%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8C%96%E9%83%A8%E7%BD%B2%E6%96%B9%E6%A1%88%E3%80%82Keepalived%E6%98%AF%E4%B8%80%E6%AC%BE%E5%9F%BA%E4%BA%8EVRRP%EF%BC%88%E8%99%9A%E6%8B%9F%E8%B7%AF%E7%94%B1%E5%86%97%E4%BD%99%E5%8D%8F%E8%AE%AE%EF%BC%89%E7%9A%84%E9%AB%98%E5%8F%AF%E7%94%A8%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%EF%BC%8C%E5%8F%AF%E5%AE%9E%E7%8E%B0%E6%9C%8D%E5%8A%A1%E7%9A%84%E6%95%85%E9%9A%9C%E8%BD%AC%E7%A7%BB%EF%BC%8C%E7%A1%AE%E4%BF%9D%E5%85%B3%E9%94%AE%E6%9C%8D%E5%8A%A1%E6%8C%81%E7%BB%AD%E5%8F%AF%E7%94%A8%E3%80%82
核心功能与特性
- 主备模式支持：可配置为主节点（MASTER）或备节点（BACKUP），实现自动故障转移
- 环境变量配置：通过环境变量灵活配置网络接口、优先级、虚拟IP等关键参数
- 虚拟IP管理：支持配置多个虚拟IP地址，实现服务IP的高可用
- 通知脚本支持：内置通知脚本，可在节点状态变化时执行自定义操作
使用场景
适用于需要高可用性保障的服务场景，如：
- 负载均衡器（如Nginx、HAProxy）的高可用部署
- 数据库服务的主备切换
- 关键业务服务的故障转移保障
使用方法
运行主节点（MASTER）
bashdocker 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）
bashdocker 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 | eth0 | 网络接口名称 |
| KEEPALIVED_PASSWORD | 1111 | VRRP认证密码 |
| KEEPALIVED_STATE | MASTER | 节点状态（MASTER/BACKUP） |
| KEEPALIVED_PRIORITY | 200 | 节点优先级（值越高越优先成为主节点） |
| KEEPALIVED_VIRTUAL_IPS | 10.3.45.15; 10.3.45.16 | 虚拟IP地址列表（多个IP用分号分隔） |
| KEEPALIVED_NOTIFY | /container/service/keepalived/assets/notify.sh | 状态变化通知脚本路径 |
配置说明
- KEEPALIVED_INTERFACE：指定运行VRRP协议的网络接口，需与主机实际网络接口名称匹配
- KEEPALIVED_PRIORITY：主节点应设置高于备节点的优先级（如主节点200，备节点100）
- KEEPALIVED_VIRTUAL_IPS：配置需要漂移的虚拟IP地址，客户端通过这些IP访问服务
- KEEPALIVED_NOTIFY：可自定义脚本路径，实现状态变化时的通知（如发送邮件、调用API等）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 keepalived 镜像标签
docker pull docker.xuanyuan.run/alissongranemann/keepalived:<标签>
DockerHub 原生拉取命令
docker pull alissongranemann/keepalived:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"