1.8 KiB
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.
Proxmox Backup Server (PBS) Access
Passwordless SSH to the PBS host at 192.168.42.30 (hostname pbs, this is VM 111). Use proxmox-backup-manager over SSH for datastore / verify-job / GC / prune management (the PVE API token does not apply to PBS on port 8007). The datastore is data-store at /mnt/datastore (ext4 on /dev/sdb1, 200 GB on syno-lvm).
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 pattern192.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 managementPVECluster_Architecture.md— Full cluster architecture: nodes, VMs/CTs, storage, networking, backup strategy
Language
Always respond in Traditional Chinese (繁體中文，台灣用語).