From 596ac84599bfadb966f34cd98bf1c90ed5f8b3a1 Mon Sep 17 00:00:00 2001 From: "Joseph.Rawlings" Date: Mon, 8 Dec 2025 08:37:13 -0500 Subject: [PATCH] Update README.md to enhance Proxmox integration section with detailed features and management options --- README.md | 192 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 191 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 7277164fd..d069a9260 100644 --- a/README.md +++ b/README.md @@ -57,7 +57,7 @@ Built on **Laravel**, **Livewire**, and **Filament**, Virtnet.bond offers a mode | Server Type | Features | |-------------|----------| -| **Proxmox** | VM/LXC management, console access, statistics, firewall, snapshots, cloud-init | +| **Proxmox** | VM/LXC management, console access, statistics, firewall, cloud-init, backups | | **Pterodactyl** | Game server management, file manager, console, backups | | **Virtualizor** | VPS management, OS reinstall, network configuration | | **VirtFusion** | Virtual machine provisioning and management | @@ -68,6 +68,196 @@ Built on **Laravel**, **Livewire**, and **Filament**, Virtnet.bond offers a mode | **Enhance** | Web hosting platform | | **Froxlor** | Server management panel | +
+ +## 🖥️ Proxmox VE Integration + +Virtnet.bond includes a comprehensive **Proxmox VE** extension that provides enterprise-grade virtual machine and container management directly within the client portal. This powerful integration enables hosting providers to offer self-service VPS and cloud computing products. + +### Overview Dashboard + +The Proxmox extension provides customers with a real-time overview of their virtual servers: + +- **Server Status** - Live VM/LXC status (running, stopped, suspended) +- **Resource Usage** - CPU, memory, disk, and network utilization +- **Quick Actions** - Start, stop, reboot, and shutdown controls +- **Hostname Management** - Customizable server hostname +- **Server Notes** - Add custom notes stored in Proxmox VM description + +### 📊 Statistics & Monitoring + +Comprehensive real-time and historical statistics with interactive charts: + +- **CPU Usage** - Percentage utilization over time (hour/day/week/month views) +- **Memory Consumption** - RAM usage with average and maximum aggregation +- **Network Traffic** - Inbound/outbound data transfer visualization +- **Disk I/O** - Read/write operations performance +- **Network Analysis** - Connection tracking, top ports, and security insights +- **Task History** - Complete audit log of all VM operations with timing + +### 🔒 Firewall Management + +Full firewall control integrated with Proxmox and CoreRouter: + +- **Enable/Disable Firewall** - Per-interface firewall toggling +- **Default Policies** - Configure inbound/outbound DROP or ACCEPT policies +- **Rule Management** - Create, edit, delete, and reorder firewall rules +- **Protocol Support** - TCP, UDP, ICMP, and all IP protocols +- **Proxmox Macros** - 50+ predefined service macros (HTTP, HTTPS, SSH, RDP, MySQL, etc.) +- **Logging Options** - Configure rule logging levels (none, alert, critical, error, warning) +- **CoreRouter Integration** - Advanced routing and firewall synchronization + +### 🌐 Network Configuration + +Complete network interface management: + +- **Interface Types** - VirtIO, Intel E1000/E1000e, Realtek RTL8139, VMware vmxnet3, AMD PCnet +- **Multi-queue Support** - Configure network adapter queues for performance +- **Link State Control** - Enable/disable network interfaces +- **MTU Configuration** - Custom Maximum Transmission Unit settings +- **Guest Agent Networks** - View IP addresses assigned via QEMU guest agent + +### 💾 Storage Management + +Comprehensive disk and storage operations: + +- **Drive Management** - View, add, resize, and remove virtual disks +- **Bus Types** - IDE, SATA, SCSI, and VirtIO block devices +- **SCSI Controllers** - LSI, MegaRAID SAS, VirtIO SCSI, VMware PVSCSI +- **Cache Modes** - No cache, directsync, writethrough, writeback, unsafe +- **Async I/O** - io_uring, native, and threads options +- **SSD Emulation** - Enable SSD emulation for solid-state performance +- **Discard/TRIM** - Enable discard for thin-provisioned storage +- **I/O Threads** - Dedicated I/O threads for improved performance +- **Unused Disks** - Manage detached/unused drives + +### 🔄 Boot Order Configuration + +Control VM boot sequence and media: + +- **Boot Device Order** - Drag-and-drop reordering of boot devices +- **Multiple CD/DVD Drives** - Support for multiple optical drives +- **ISO Management** - Mount/unmount ISO images from storage +- **Available Devices** - Add/remove boot devices from sequence + +### 🖼️ Display Settings + +Graphics adapter configuration: + +- **Display Types** - Standard VGA, VirtIO-GPU, VMware compatible, Cirrus, Serial console +- **Video Memory** - Configurable display memory (VirtIO-GPU) +- **USB Tablet** - Toggle tablet device for pointer synchronization + +### ☁️ Cloud-Init Support + +Automated VM configuration via cloud-init: + +- **User Configuration** - Set default user and password +- **SSH Keys** - Manage authorized SSH public keys +- **DNS Settings** - Configure DNS domain and nameservers +- **Network Configuration** - Static IP, gateway, and IPv6 settings per interface +- **OS Type Selection** - Linux (modern/legacy), Windows variants, Solaris, and generic +- **Package Upgrades** - Enable automatic package upgrades on boot + +### 📦 Backup Management + +Integrated backup and restore functionality: + +- **Backup List** - View all available VM backups with timestamps +- **Restore Operations** - One-click backup restoration with confirmation +- **Backup Deletion** - Remove old backups to free storage space +- **Configurable Limits** - Per-product backup quantity limits + +### 🔧 OS Reinstallation + +Self-service operating system reinstallation: + +- **OS Selection** - Choose from available operating system templates +- **Location-Based Templates** - OS options filtered by server location +- **Protection Check** - Prevents reinstall on protected VMs +- **Confirmation Required** - Multi-step confirmation to prevent accidents + +### 🌍 Subdomain Management + +Dynamic DNS subdomain creation (Technitium DNS integration): + +- **Auto-Generated Subdomains** - Randomly generated memorable subdomains +- **Custom Subdomains** - User-defined subdomain names +- **Multiple Zones** - Support for multiple DNS zones +- **Record Types** - A records for IPv4 addresses +- **IP Selection** - Bind subdomains to specific server IP addresses + +### 🖥️ Console Access + +Multiple console options for server access: + +- **VNC Console** - Browser-based graphical console via noVNC +- **xterm.js Terminal** - Web-based terminal access +- **Node Configuration** - Per-node VNC enable/disable settings + +### System Configuration + +Advanced VM system settings: + +- **Resource Limits** - CPU cores, sockets, memory allocation +- **CPU Models** - 70+ CPU models (Intel, AMD, generic) +- **Resource Pools** - Organize VMs into Proxmox resource pools +- **IP Address Allocation** - IPv4 and IPv6 address management +- **Location-Based Provisioning** - Node selection by location + +### Extension Configuration + +Flexible product configuration options: + +```php +// Available product settings +[ + 'location_id' => 'Server location for provisioning', + 'ipv4' => 'Number of IPv4 addresses', + 'ipv6' => 'Number of IPv6 addresses', + 'pool' => 'Proxmox resource pool', + 'cpu' => 'CPU model (70+ options)', + 'cores' => 'Number of CPU cores', + 'sockets' => 'Number of CPU sockets', + 'memory' => 'RAM allocation (MiB)', + 'disk' => 'Storage allocation (GiB)', + 'backups' => 'Number of backup slots', +] +``` + +### Proxmox Extension Structure + +``` +extensions/Servers/Proxmox/ +├── Proxmox.php # Main extension class +├── TechnitiumDns.php # DNS integration +├── routes.php # Extension routes +├── Admin/ # Admin panel resources +├── Console/ # Artisan commands +├── database/ # Migrations +├── Http/ # Controllers +├── Jobs/ # Queue jobs +├── Livewire/ # Livewire components +│ ├── Overview.php # Dashboard with stats +│ ├── Statistics.php # Detailed analytics +│ ├── Firewall.php # Firewall management +│ ├── Network.php # Network interfaces +│ ├── Storage.php # Disk management +│ ├── BootOrder.php # Boot configuration +│ ├── Display.php # Graphics settings +│ ├── CloudInit.php # Cloud-init config +│ ├── Subdomain.php # DNS subdomains +│ ├── Reinstall.php # OS reinstallation +│ ├── VNC.php # VNC console +│ ├── XTerm.php # Terminal access +│ └── Backups/ # Backup management +├── Models/ # Eloquent models +├── Providers/ # Service providers +├── Services/ # API services +│ └── CoreRouterClient.php # Router integration +└── views/ # Blade templates +``` + ### 💳 Payment Gateways - **Stripe** - Credit cards, Apple Pay, Google Pay, and more