39 lines
1.8 KiB
Markdown
39 lines
1.8 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.
|
|
|
|
## 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 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 (繁體中文，台灣用語).
|