docs: add README, API reference, quickstart guide, and cluster summary

- README.md: project landing page with cluster overview and doc index
- API.md: comprehensive Proxmox VE API endpoint reference
- QUICKSTART.md: 5-minute guide with copy-paste examples
- SUMMARY.md: cluster health, resource usage, and service inventory
- CLAUDE.md: Claude Code project context

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-10 11:12:15 +08:00
parent d30bf61a76
commit 1990d5a011
5 changed files with 603 additions and 0 deletions

51
README.md Normal file
View File

@@ -0,0 +1,51 @@
# 42_38 — PVECluster 基礎建設文件庫
管理與記錄 PVECluster3 節點 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/容器 | 2720 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"
```