Update README.md to enhance Proxmox integration section with detailed features and management options

This commit is contained in:
2025-12-08 08:37:13 -05:00
parent 54b7558a30
commit 596ac84599

192
README.md
View File

@@ -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 |
<br>
## 🖥️ 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