# Proxmox VE (PVE) 集群搭建完整指南

## 环境准备

### 硬件要求
- 至少 3 个节点（推荐奇数个节点以实现仲裁）
- 每个节点至少 4GB RAM
- 网络连接稳定可靠

### 网络规划
```
pve1: 192.168.124.111 (主节点)
pve2: 192.168.124.112  
pve3: 192.168.124.113
```

## 安装步骤

### 1. 系统初始化

#### 配置静态 IP（每个节点）
```bash
# 编辑网络配置
nano /etc/network/interfaces

# 示例配置：
auto lo
iface lo inet loopback

auto vmbr0
iface vmbr0 inet static
    address 192.168.124.111/24  # 根据节点修改
    gateway 192.168.124.1
    bridge-ports enp3s0        # 根据实际网卡修改
    bridge-stp off
    bridge-fd 0
```

重启网络服务：
```bash
systemctl restart networking
```

### 2. 节点重命名和主机配置

#### 在每个节点上执行相应操作：

**节点1 (192.168.124.111):**
```bash
hostnamectl set-hostname pve-111
echo "192.168.124.111 pve-111" >> /etc/hosts
echo "192.168.124.112 pve-112" >> /etc/hosts  
echo "192.168.124.113 pve-113" >> /etc/hosts
```

**节点2 (192.168.124.112):**
```bash
hostnamectl set-hostname pve-112
echo "192.168.124.111 pve-111" >> /etc/hosts
echo "192.168.124.112 pve-112" >> /etc/hosts
echo "192.168.124.113 pve-113" >> /etc/hosts
```

**节点3 (192.168.124.113):**
```bash
hostnamectl set-hostname pve-113
echo "192.168.124.111 pve-111" >> /etc/hosts
echo "192.168.124.112 pve-112" >> /etc/hosts
echo "192.168.124.113 pve-113" >> /etc/hosts
```

### 3. 创建集群

#### 在主节点 (pve-111) 执行：
```bash
pvecm create my-cluster
```

### 4. 添加节点到集群

#### 在从节点执行：

**节点2 (pve-112):**
```bash
pvecm add 192.168.124.111
# 输入主节点 root 密码
```

**节点3 (pve-113):**
```bash
pvecm add 192.168.124.111  
# 输入主节点 root 密码
```

### 5. 验证集群状态

#### 在任何节点上检查集群状态：
```bash
# 查看集群节点
pvecm nodes

# 查看集群状态
pvecm status

# 查看集群日志
pvecm logs

# 查看仲裁状态
pvecm expected 1
```

### 6. 解决主机名修改后的问题

如果修改主机名后遇到 Web 界面问题，执行以下命令：
```bash
systemctl restart pvedaemon
systemctl restart pvestatd
systemctl restart pveproxy
systemctl restart pvebanner
```

## 集群管理

### Web 界面访问
```
https://192.168.124.111:8006
https://192.168.124.112:8006  
https://192.168.124.113:8006
```

### 常用管理命令

```bash
# 查看集群信息
pvecm status

# 移除节点（在要移除的节点上执行）
pvecm delnode <节点名>

# 停止集群服务
systemctl stop pve-cluster

# 重启集群服务
systemctl restart pve-cluster
```