Files

Timmy 40945cf625 docs: 初始化 PVECluster (192.168.88.0/24) 文件庫

仿照 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>

2026-04-15 16:02:48 +08:00

2.5 KiB

Raw Permalink Blame History

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 (繁體中文，台灣用語).

2.5 KiB Raw Permalink Blame History