# 狀態檔

本頁說明 go-pve-qemu 在工作目錄讀寫的三個 `.go_qemu_*` 檔案。

## `.go_qemu_disabled`

停用清單：列入的 VMID 會出現在 VM 清單中，但無法經 API 操作。

```text
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 的金鑰依序合併：

1. 主節點執行身分的公鑰：依序找 `~/.ssh/id_ed25519.pub`、`id_rsa.pub`、`id_ecdsa.pub`，取第一個
2. `.go_qemu_pubkey_admin` 全部內容
3. 請求的 `pubkey` 欄位

合併結果以 `qm set --sshkeys` 寫入 Cloud-Init。

## `.go_qemu_cpu_type`

自動產生的叢集 CPU 類型快取，內容為單行字串，例如 `x86-64-v3`。

| 時機 | 行為 |
|---|---|
| 首次建立 VM | 偵測全叢集 CPU 等級後寫入 |
| 之後每次建立 VM | 直接讀取，不再呼叫 `pvesh` |
| 節點硬體變動 | 手動刪除，下次建立 VM 時重新偵測 |

偵測方式見 [CPU 基準](/zh/cpu-baseline)。