0xygen1337/pve-corosync-qdevice-voter

Proxmox PVE qdevice投票器Docker镜像

镜像概述

本Docker镜像提供了一种简单方式部署qdevice投票器，专门用于Proxmox PVE集群环境。qdevice作为第三方伪节点，主要用于解决Proxmox PVE集群中节点数量为偶数时的仲裁问题，确保集群在网络分区等异常情况下仍能保持一致性，避免"脑裂"现象。

核心功能和特性

• 轻量级部署：通过Docker容器化方式快速部署qdevice投票器，无需复杂的系统级配置
• 集群仲裁支持：作为第三方伪节点参与Proxmox PVE集群投票，解决偶数节点集群的仲裁问题
• 简化配置：提供开箱即用的qdevice基础配置，降低Proxmox集群高可用部署门槛

使用场景和适用范围

• Proxmox PVE集群节点数量为偶数（如2节点、4节点）的场景
• 需要增强集群高可用性，避免因网络分区导致集群分裂的场景
• 希望通过容器化方式简化qdevice部署和管理的Proxmox PVE环境

使用方法和配置说明

基本部署命令

bash
docker run -d \
  --name proxmox-qdevice \
  --network host \
  --restart unless-stopped \
  [镜像名称]

关键配置说明

• 网络模式：推荐使用--network host模式，确保qdevice能与Proxmox集群节点正常通信
• 持久化：可通过挂载卷保存qdevice配置文件，示例：

  bash
  docker run -d \
    --name proxmox-qdevice \
    --network host \
    -v /path/to/qdevice/config:/etc/corosync/qdevice \
    --restart unless-stopped \
    [镜像名称]
  

注意事项

• 部署前需确保Proxmox PVE集群已正确配置并运行
• qdevice需要与集群所有节点建立网络连接，确保防火墙规则允许相关通信（默认Corosync端口等）
• 具体配置需根据Proxmox PVE集群的实际环境进行调整，详情参考Proxmox官方qdevice配置文档

补充说明

本镜像旨在简化Proxmox PVE集群中qdevice的部署流程，适合需要快速实现集群仲裁功能的场景。使用前建议熟悉Proxmox PVE集群高可用相关概念及qdevice工作原理。