[!NOTE] This README was generated by SKILL, get the ZH version from here.

PRODUCTION-GRADE PROXMOX VE VM AUTOMATION REST API

A Go-based Proxmox VE REST API with SSE-driven full-lifecycle VM provisioning, concurrent IP and CPU architecture auto-allocation, and transparent multi-node cluster routing.

Table of Contents

• Features
• Architecture
• License
• Author

Features

git clone https://github.com/pardnchiu/go-pve-qemu.git · Documentation

• SSE-Driven Fully Automated Provisioning — A single API call downloads an OS image, creates and configures a VM, then initializes SSH while streaming progress via Server-Sent Events.
• Concurrent IP and CPU Architecture Allocation — VMID/IP allocation scans concurrently; the compatible CPU level across cluster nodes is detected and cached.
• Transparent Multi-Node Cluster Routing — Commands run locally on the main node or are dispatched through SSH to remote nodes without changing the public API.
• Cloud-Init and SSH Key Management — Cloud-init settings, SSH keys, credentials, and OS-specific initialization are applied during provisioning.
• Resource Cap Enforcement and Balloon Support — Configurable CPU, RAM, and disk limits are enforced before creation; balloon/NUMA options are applied when appropriate.

Architecture

Full Architecture

graph LR
    Client -->|HTTP + SSE| Handler
    Handler --> Service
    Service -->|qm / pvesh| MainNode
    Service -->|SSH + qm| RemoteNode
    MainNode -->|cloud-init| VM
    RemoteNode -->|migration| MainNode
    Service -->|download| CloudImage
    CloudImage --> MainNode

License

This project is licensed under the AGPL-3.0 LICENSE.

Author

邱敬幃 Pardn Chiu

hi@pardn.io
https://www.linkedin.com/in/pardnchiu

©️ 2025 邱敬幃 Pardn Chiu