Timmy
1990d5a011
- 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>
35 lines
1.4 KiB
Markdown
35 lines
1.4 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.42.38/39/40. 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.42.38:8006/api2/json/`. Authenticate with:
|
|
|
|
```
|
|
Authorization: PVEAPIToken=root@pam!claude=fefcffca-df6e-48de-8adf-7907cd2ea879
|
|
```
|
|
|
|
SSH is available to all three nodes (42.38, 42.39, 42.40) without password from the development machine. Use `pvesh` over SSH for CLI-based management.
|
|
|
|
## Cluster Topology
|
|
|
|
- **3 identical nodes**: Intel i3-6100 (2C/4T), 16GB RAM each
|
|
- **Primary storage**: Synology NAS at 192.168.42.20 via iSCSI (`syno-lvm`, 1TB shared LVM)
|
|
- **Backup storage**: Synology CIFS (`synology-backup`, 2.75TB) + Proxmox Backup Server (VM 111 at 192.168.42.30)
|
|
- **Networking**: All VMs/CTs on `vmbr0`, static IPs matching VMID pattern `192.168.42.<VMID>`
|
|
- **Gateway**: 192.168.42.10 (OpenWRT VM 110 handles routing/firewall)
|
|
|
|
## Key Files
|
|
|
|
- `PVE_API.md` — API authentication methods, endpoint reference, token management
|
|
- `PVECluster_Architecture.md` — Full cluster architecture: nodes, VMs/CTs, storage, networking, backup strategy
|
|
|
|
## Language
|
|
|
|
Always respond in Traditional Chinese (繁體中文，台灣用語).
|