42_38/README.md

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/容器	21（18 running / 0 stopped / 1 template）
主要儲存	Synology NAS iSCSI 1TB + CIFS 2.75TB
備份	Proxmox Backup Server (VM 111)

文件索引

文件	說明
QUICKSTART.md	快速上手：連線、API 呼叫、常用操作
API.md	Proxmox VE API 完整參考手冊
PVECluster_Architecture.md	叢集架構詳細文件（硬體/網路/儲存/VM 清單）
SUMMARY.md	叢集狀態摘要與服務一覽
proxmox-cluster-topology.html	叢集網路拓撲視覺化示意圖（瀏覽器開啟）

網路拓撲

互動 / 動畫版：proxmox-cluster-topology.html（用瀏覽器開）

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

快速存取

# 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"