Timmy
40945cf625
仿照 timmy/42_38 結構建立 7 份文件，涵蓋 3 節點 PVE 8.4.16 叢集 （pve-000/.73、pve-001/.249、pve-002/.247）的架構、API、儲存、 備份與服務分類。 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
52 lines
2.5 KiB
Markdown
52 lines
2.5 KiB
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
|
|
## Project Overview
|
|
|
|
This repository documents and manages a 3-node Proxmox VE cluster ("PVECluster") running at 192.168.88.73/249/247. It contains infrastructure documentation and will serve as the base for automation scripts and tooling.
|
|
|
|
## Proxmox VE API Access
|
|
|
|
All API calls go through `https://192.168.88.247:8006/api2/json/`. Authenticate with:
|
|
|
|
```
|
|
Authorization: PVEAPIToken=root@pam!claude=17e96169-a32f-4e2d-951e-859c77770306
|
|
```
|
|
|
|
SSH is available to all three nodes (88.73, 88.249, 88.247) with password `25915525` (root@pam). Use `pvesh` over SSH for CLI-based management. Any node IP can serve as the API entry point — they share the same management interface.
|
|
|
|
## Cluster Topology
|
|
|
|
- **3 heterogeneous nodes**:
|
|
- `pve-000` (192.168.88.73) — 4C / 32 GB — runs most LXCs + medium VMs (16 guests)
|
|
- `pve-001` (192.168.88.249) — 24C / 132 GB — runs heavy Windows VMs and OpenArchiver (9 guests)
|
|
- `pve-002` (192.168.88.247) — 4C / 16 GB IBM x3250 M4 (Xeon E3-1220 v2) — currently idle, used as management/SSH entry point
|
|
- **Primary storage**: Synology DS1621 at 192.168.88.60 via iSCSI (`pve-iscsi-3t`, 4.5 TB shared LVM)
|
|
- **Backup storage**: Proxmox Backup Server (VM 101 at 192.168.88.169, datastore `backup1`, 1 TB)
|
|
- **Networking**:
|
|
- `vmbr0` — main 192.168.88.0/24 LAN (all nodes)
|
|
- `vmbr1` — 192.168.77.0/24 OpenWRT LAN (pve-000 only, IP .241)
|
|
- `vmbr2` — OpenWRT WAN bridge (pve-000 only, no IP)
|
|
- Default gateway: `192.168.88.1` (upstream router)
|
|
- **Internet routing**: VM 115 OpenWRT runs HiNet PPPoE (210.242.157.197) and serves the 192.168.77.0/24 subnet
|
|
|
|
## Key Files
|
|
|
|
- `PVE_API.md` — API authentication methods, endpoint reference, token management
|
|
- `API.md` — Full Proxmox VE API reference handbook
|
|
- `PVECluster_Architecture.md` — Full cluster architecture: nodes, VMs/CTs, storage, networking, backup strategy
|
|
- `SUMMARY.md` — Real-time cluster status snapshot
|
|
- `QUICKSTART.md` — 5-minute getting-started guide
|
|
|
|
## Notable Points
|
|
|
|
- VMs are tagged by owner (`veljko`, `chao`, `lucas`, `celia`, `gia`, `apollo`, `vic`, `timmy`) — useful for filtering
|
|
- Backup schedule is daily at 23:00, retains 7 daily, covers 14 critical VMs/CTs
|
|
- `pve-002` has zero workload — available as failover target or batch-job runner
|
|
- VM 115 (OpenWRT) is a single point of failure for the 192.168.77.0/24 subnet
|
|
|
|
## Language
|
|
|
|
Always respond in Traditional Chinese (繁體中文，台灣用語).
|