[!NOTE] 此 README 由 SKILL 生成，英文版請參閱 這裡。

PRODUCTION-GRADE PROXMOX VE VM AUTOMATION REST API

以 Go 構建的 Proxmox VE REST API，具備 SSE 驅動的完整生命週期 VM 佈建、並發 IP 與 CPU 架構自動分配，以及透明多節點叢集路由。

目錄

• 功能特點
• 架構
• 授權
• Author

功能特點

git clone https://github.com/pardnchiu/go-pve-qemu.git · 完整文件

• SSE 驅動全自動化佈建 — 單一 API 呼叫可依序完成 OS 映像下載、VM 建立與設定、SSH 初始化，並以 Server-Sent Events 串流進度。
• 並發 IP 與 CPU 架構分配 — VMID/IP 以並發方式掃描可用值；系統會偵測並快取各叢集節點共通的 CPU 架構層級。
• 透明多節點叢集路由 — 主節點本機執行指令，遠端節點自動以 SSH 派送，對外 API 不必因叢集拓撲而改變。
• Cloud-Init 與 SSH 金鑰管理 — 佈建時會套用 cloud-init 設定、SSH 金鑰、登入憑證與作業系統專屬初始化。
• 資源上限強制與 Balloon 支援 — 建立前會強制 CPU、RAM、磁碟上限；合適時套用 Balloon 與 NUMA 設定。

架構

完整架構

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[OS Cloud Image]
    CloudImage --> MainNode

授權

本專案採用 AGPL-3.0 LICENSE。

Author

邱敬幃 Pardn Chiu

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

©️ 2025 邱敬幃 Pardn Chiu