# 88_247 — PVECluster 基礎建設文件庫

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

## 叢集簡介

| 項目 | 值 |
|---|---|
| 叢集名稱 | PVECluster |
| PVE 版本 | 8.4.16（Kernel 6.8.12-18-pve） |
| 節點 | pve-000 (192.168.88.73)、pve-001 (.249)、pve-002 (.247) |
| 硬體 | 異質配置（i3 / Xeon E3 / Xeon 24C） |
| VM/容器 | 25（21 running / 4 stopped） |
| 主要儲存 | Synology iSCSI 共享 LVM 4.5 TB（`pve-iscsi-3t`） |
| 備份 | Proxmox Backup Server (192.168.88.169，1 TB) |

## 文件索引

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

## 網路拓撲

```
HiNet PPPoE 210.242.157.197
        │
        ▼
   [VM 115 OpenWRT] ─── vmbr2 (WAN) / vmbr1 192.168.77.1 (LAN)
                                              │
                                              └── CT104, CT125（Tailscale/Headscale 子網）

192.168.88.1 (上游 GW) ─── vmbr0 (192.168.88.0/24)
        │
        ├── pve-000 (.73)   4C/32GB    16 guests
        ├── pve-001 (.249) 24C/132GB    9 guests
        └── pve-002 (.247)  4C/16GB    （備援節點，目前無工作負載）
```

## 快速存取

```bash
# SSH 連線（root 密碼：25915525）
ssh root@192.168.88.247       # pve-002（本文件主要連線點）
ssh root@192.168.88.73        # pve-000
ssh root@192.168.88.249       # pve-001

# Web UI
https://192.168.88.247:8006

# API 呼叫
curl -sk https://192.168.88.247:8006/api2/json/cluster/resources \
  -H "Authorization: PVEAPIToken=root@pam!claude=17e96169-a32f-4e2d-951e-859c77770306"
```