快速開始
在 Proxmox VE 主節點安裝並操作 go-pve-qemu REST 服務。
前置需求
| 需求 | 用途 |
|---|---|
| Go 1.20 以上 | 建置 API 伺服器 |
| Proxmox CLI | 以 qm、pvesh、pvesm 執行 VM 與儲存操作 |
| SSH 金鑰 | 主節點無互動登入遠端叢集節點 |
| 可用儲存池 | ASSIGN_STORAGE 指定的儲存池必須可用 |
建置與啟動
git clone https://github.com/pardnchiu/go-pve-qemu.git
cd go-pve-qemu
cp .env.example .env
# 設定必要環境變數
go build -o go-pve-qemu ./cmd/api
./go-pve-qemu
程式會在可用時載入 .env、要求 PORT 與 GATEWAY、註冊 Gin 路由，並監聽設定的連接埠。
驗證服務
curl http://localhost:8080/api/health
# ok
佈建 VM
curl -N -X POST http://localhost:8080/api/vm/install \
-H 'Content-Type: application/json' \
-d '{"os":"ubuntu","version":"22.04","name":"web-01","cpu":2,"ram":4096,"disk":"40G"}'