52530e6ec2
Switch guest exec POST bodies to use repeated `command` parameters (command=exe&command=arg1&...) required by PVE 8+ agent API, replacing the old argN format. Also only append `input-data` when present and use URLSearchParams for the request body in both clipboard and files routes to ensure compatibility with the newer exec endpoint. |
||
|---|---|---|
| .github | ||
| config | ||
| docs | ||
| frontend | ||
| nginx | ||
| .env.example | ||
| .gitignore | ||
| DEPLOYMENT.md | ||
| docker-compose.community.yml | ||
| docker-compose.dev.yml | ||
| docker-compose.enterprise.yml | ||
| EULA.md | ||
| install.sh | ||
| LICENSE | ||
| README.md | ||
| SECURITY.md | ||
CFCenter
Enterprise-grade management platform for Proxmox Virtual Environment
Overview
CFCenter provides a modern, unified web interface for monitoring, managing, and optimizing your Proxmox virtualization infrastructure. Manage multiple clusters, automate workload balancing, and gain deep insights into your infrastructure.
Quick Start
git clone https://github.com/pykestrel/cfcenter.git /opt/cfcenter
cd /opt/cfcenter
sudo ./install.sh install
The script auto-detects your OS, installs Docker/Git if needed, builds the image, and starts the container.
Open http://YOUR_SERVER_IP:3000 when complete.
Features at a Glance
| Feature | Community | Enterprise |
|---|---|---|
| Dashboard & Health Scores | x | x |
| Inventory (Nodes, VMs, CTs) | x | x |
| Web Terminal (xterm.js) | x | x |
| VNC Console (noVNC) | x | x |
| Topology Map | x | x |
| Storage Management | x | x |
| Ceph Monitoring | x | x |
| Backup Monitoring (PBS) | x | x |
| Events Log | x | x |
| User Management | x | x |
| Themes & Customization | x | x |
| Multi-language (EN/FR) | x | x |
| DRS (Resource Scheduler) | x | |
| Site Recovery (Ceph Replication) | x | |
| Network Microsegmentation | x | |
| Resource Trends & AI Insights | x | |
| Alerts & Notifications | x | |
| Task Center (Scheduled Jobs) | x | |
| Reports (PDF, AI-powered) | x | |
| RBAC (Role-Based Access) | x | |
| Audit Logs | x | |
| LDAP / Active Directory | x |
Community Features
Dashboard
Real-time monitoring with health scores, top consumers, and multi-cluster overview.
- Clusters and nodes status at a glance
- CPU, Memory, and Storage utilization gauges
- Top resource consumers
- Backup status and alerts overview
Inventory
Browse and manage all nodes, VMs, and containers across clusters.
Web Terminal & VNC Console
Access node shells, VM consoles, and LXC terminals directly from your browser.
- xterm.js terminal for node/VM/CT shell access
- noVNC console for graphical VM access
- Unified WebSocket proxy on a single port (no extra port needed)
Topology Map
Visual network topology of your infrastructure with interactive node graph.
Storage & Ceph
Monitor and manage storage, including Ceph distributed storage clusters.
- Ceph cluster health, OSD nodes, pools capacity
- Performance metrics and IOPS
- Replication status
Backup Monitoring (PBS)
Monitor Proxmox Backup Server datastores and backup jobs.
Customization
- Light, Dark, and System modes
- Multiple color schemes
- Multi-language support (English, French)
Enterprise Features
DRS - Distributed Resource Scheduler
Intelligent workload balancing across your Proxmox nodes.
- Automatic and manual balancing modes
- CPU, memory, and storage-aware scheduling
- Affinity and anti-affinity rules
- Migration recommendations with one-click execution
Resource Trends & AI Insights
Comprehensive resource analysis with historical trends and AI-powered predictions.
- Historical resource usage evolution
- Capacity projections and predictions
- AI-assisted trend analysis
- Green IT / Environmental impact metrics
Rolling Updates
Orchestrated node updates with zero-downtime VM migrations.
- Automated pre-migration before updates
- Progress tracking per node
- Rollback capabilities
Cross-Cluster Migration
Migrate VMs between different Proxmox clusters seamlessly.
Network Microsegmentation
Centralized firewall management with Zero Trust security model.
- Security groups management
- VM-level firewall rules
- Cluster-wide policies
Alerts & Notifications
Real-time alerts with configurable thresholds and email notifications (SMTP).
Reports
Generate professional PDF reports with AI-powered insights (Ollama, OpenAI, Anthropic).
RBAC & Authentication
- Role-based access control with custom roles and permissions
- LDAP and Active Directory integration
- Audit log for all user actions
Architecture
+-----------------------+
| Nginx (optional) |
| SSL termination |
+-----------+-----------+
|
port 3000 (HTTP + WS)
|
+-----------+-----------+
| Unified Server |
| (start.js) |
| |
| +-- Next.js 16 ----+ |
| | React 19 + MUI 7| |
| | TypeScript 5 | |
| +-----------------+ |
| |
| +-- WS Proxy ------+ |
| | xterm.js relay | |
| | noVNC relay | |
| +-----------------+ |
| |
| +-- SQLite --------+ |
| | Prisma ORM | |
| +-----------------+ |
+-----------+-----------+
|
Proxmox API (8006)
|
+-----------+-----------+
| Proxmox VE Cluster |
| Nodes / VMs / CTs |
+------------------------+
- Single port (3000): HTTP and WebSocket served from one process
- No nginx required for Community edition (direct access on port 3000)
- Enterprise edition adds a Go orchestrator backend for DRS, alerts, reports, etc.
Requirements
- Docker & Docker Compose
- Proxmox VE 7.x, 8.x or 9.x
- Network access to Proxmox API (port 8006)
Installation
See DEPLOYMENT.md for full instructions, options, and troubleshooting.
# Fresh install
sudo ./install.sh install
# Update after code changes
sudo ./install.sh update
# Check status
sudo ./install.sh status
Configuration
After installation, CFCenter runs at http://your-server:3000.
Configuration files are located in /opt/cfcenter/:
.env— Environment variablesconfig/orchestrator.yaml— Backend configuration (Enterprise only)
Management Commands
cd /opt/cfcenter
# Update to latest
sudo ./install.sh update
# View logs
docker logs -f cfcenter-frontend
# Stop / Start
docker stop cfcenter-frontend
docker start cfcenter-frontend
# Check status
sudo ./install.sh status
License
- Community Edition: Free for personal and commercial use
- Enterprise Edition: Commercial license required — cfcenter.io/pricing
Support
- Community: GitHub Issues
- Enterprise Support: support@cfcenter.io
CFCenter — Enterprise Proxmox Management Made Simple