theProx Wiki

Proxmox Remote Management Platform — zentrales WebUI zur Verwaltung mehrerer Proxmox-Hosts über ausgehende Agenten. Kein offener Port auf den Hosts nötig.

Seiten

• Architecture — Komponenten, Datenfluss, Ports
• Backend — FastAPI, Router, Models, Scheduler, WebSocket
• Frontend — SvelteKit 5, Dashboard, Modal-Tabs, Stores
• Node-Agent — Rust-Agent auf Proxmox-Hosts
• VM-Guest-Agent — Rust-Agent in den VMs
• RBAC — Mandanten, Rollen, Scopes
• Deployment — Docker, .env, Host-Provisioning
• Deployment-Public — public Betrieb ohne VPN: NPM/wss, Ports, Hardening-Checkliste
• Security — Agent-Auth (ed25519), Rate-Limit, fail2ban
• Self-Update-Signing — Self-Update via TLS-Vertrauen + sha256 (keine ed25519-Signatur mehr, #187)
• Agent-Update-Mechanik — Erkennung vs. Selbst-Update vs. Anwenden; Intervalle & Scheduler
• Development — Build, Konventionen, Agent-Versionierung
• API — Endpunkt-Gruppen, WebSocket-Protokoll

Stack auf einen Blick

Komponente	Technologie
Backend	Python 3.11 · FastAPI · SQLAlchemy async · PostgreSQL · Alembic
Frontend	SvelteKit 5 (Runes) · TypeScript
Node-Agent	Rust · tokio · tungstenite · pvesh/qm/pct
VM Guest-Agent	Rust (static musl) · Linux/FreeBSD/Windows
Infrastruktur	Docker Compose · nginx (public + intern)

Ports

Port	Zweck	Exponiert
8080	WebUI + API (nginx intern)	nur VPN/intern
8765	Agent-WebSocket (nginx public)	öffentlich, nur /ws/agent + Install
9100	VM-Guest-Agent → Host-Agent (TCP)	nur VM↔Host