狀態檔
本頁說明 go-pve-qemu 在工作目錄讀寫的三個 .go_qemu_* 檔案。
.go_qemu_disabled
停用清單：列入的 VMID 會出現在 VM 清單中，但無法經 API 操作。
101:gateway-router
102:nas
| 規則 | 說明 |
|---|---|
| 格式 | 每行 <vmid>:<name>；空行、缺冒號、VMID 非數字的行會被略過 |
| 清單呈現 | 以 os: "-"、node: "-"、running: true 覆寫該 VMID 的資料 |
| 操作限制 | 所有會檢查 VM 狀態的端點回 400 this IP is not allowed to be controlled |
| 檔案必要性 | 必須存在；不存在時 /api/vm/list 回 500，所有生命週期與資源端點也失敗 |
適合用來保護同一叢集中由其他方式管理的 VM（路由器、儲存、基礎服務）。
.go_qemu_pubkey_admin
選用。內容會附加到每台新 VM 的 authorized_keys，可放多把公鑰，每行一把。
新 VM 的金鑰依序合併：
- 主節點執行身分的公鑰：依序找
~/.ssh/id_ed25519.pub、id_rsa.pub、id_ecdsa.pub，取第一個 .go_qemu_pubkey_admin全部內容- 請求的
pubkey欄位
合併結果以 qm set --sshkeys 寫入 Cloud-Init。
.go_qemu_cpu_type
自動產生的叢集 CPU 類型快取，內容為單行字串，例如 x86-64-v3。
| 時機 | 行為 |
|---|---|
| 首次建立 VM | 偵測全叢集 CPU 等級後寫入 |
| 之後每次建立 VM | 直接讀取，不再呼叫 pvesh |
| 節點硬體變動 | 手動刪除，下次建立 VM 時重新偵測 |
偵測方式見 CPU 基準。