# 42_38 — PVECluster 基礎建設文件庫

管理與記錄 PVECluster（3 節點 Proxmox VE 叢集）的架構、API 操作指南及相關自動化工具。

## 叢集簡介

| 項目 | 值 |
|---|---|
| 叢集名稱 | PVECluster |
| PVE 版本 | 8.4.14 |
| 節點 | pve (192.168.42.38)、pve-02 (.39)、pve-03 (.40) |
| 硬體 | Intel i3-6100 / 16GB RAM x3 |
| VM/容器 | 27（20 running / 6 stopped / 1 template） |
| 主要儲存 | Synology NAS iSCSI 1TB + CIFS 2.75TB |
| 備份 | Proxmox Backup Server (VM 111) |

## 文件索引

| 文件 | 說明 |
|---|---|
| [QUICKSTART.md](QUICKSTART.md) | 快速上手：連線、API 呼叫、常用操作 |
| [API.md](API.md) | Proxmox VE API 完整參考手冊 |
| [PVECluster_Architecture.md](PVECluster_Architecture.md) | 叢集架構詳細文件（硬體/網路/儲存/VM 清單） |
| [SUMMARY.md](SUMMARY.md) | 叢集狀態摘要與服務一覽 |

## 網路拓撲

```
Internet ─── [192.168.42.10 GW / OpenWRT] ─── vmbr0 (192.168.42.0/24)
                                                  │
                    ┌─────────────────────────────┼─────────────────────────────┐
                    │                             │                             │
               pve (.38)                    pve-02 (.39)                  pve-03 (.40)
          VM110,121 + CT x12             VM111,120 + CT x6             VM122 + CT x5
```

## 快速存取

```bash
# SSH 連線
ssh 192.168.42.38       # pve
ssh 192.168.42.39       # pve-02
ssh 192.168.42.40       # pve-03

# Web UI
https://192.168.42.38:8006

# API 呼叫
curl -sk https://192.168.42.38:8006/api2/json/cluster/resources \
  -H "Authorization: PVEAPIToken=root@pam!claude=fefcffca-df6e-48de-8adf-7907cd2ea879"
```