v0.1.7

環境變數

最後更新


本頁列出 QemuRun-pve 讀取的全部環境變數、預設值與未設定時的實際行為。
啟動時以 godotenv 載入工作目錄的 .env;檔案不存在時只印警告,改讀行程環境變數。啟動階段只檢查 PORT 與 GATEWAY,其餘變數在被使用時才讀取。

必填


變數範例用途未設定時
PORT8080API 監聽埠;也用來組出初始化腳本網址啟動失敗
GATEWAY192.168.0.1VM 網關;前三段作為 VM IP 前綴啟動失敗
MAIN_NODEpve1服務所在節點名稱所有 VM 操作無法判斷在哪個節點執行;SSH 初始化找不到腳本網址
NODE_<name>NODE_pve2=192.168.0.12每個節點(含主節點)的管理 IP該節點上的 VM 無法操作
ALLOW_IPS192.168.0.10,192.168.0.20可呼叫寫入端點的來源 IP,逗號分隔;0.0.0.0 全部放行空字串會被切成 [""],寫入端點全部拒絕
ASSIGN_STORAGElocal-zfs匯入磁碟與 Cloud-Init 使用的儲存池安裝在「檢查儲存池」步驟失敗

選填


變數預設用途
ASSIGN_IP_START100自動配置 VMID 的下限;0 或低於 100 時以 100 計
ASSIGN_IP_END254自動配置 VMID 的上限;0 或高於 254 時以 254 計;起訖顛倒時自動交換
VM_MAX_CPU不限安裝時 vCPU 上限,超過時壓回
VM_MAX_RAM不限安裝時記憶體上限(MB)
VM_MAX_DISK不限安裝時磁碟上限(GB),大於等於此值時設為此值
VM_BALLOON_MIN停用Balloon 保留記憶體(MB),規則見下節
VM_ROOT_PASSWORD腳本預設傳給 OS 初始化腳本的 root 密碼;留空時腳本使用內建值 0123456789

數值型變數無法解析成整數時,一律視為未設定。

Balloon 規則


設定 VM_BALLOON_MIN 後,記憶體符合下列條件時會一併加上 --numa 1 與 --balloon:
記憶體(MB)--balloon 值
≥ 6553649152
≥ VM_BALLOON_MIN + 1024記憶體 − VM_BALLOON_MIN
其他不設定

安裝與 0 共用此規則。

.env 範例


  1. PORT=8080
  2. MAIN_NODE=pve1
  3. GATEWAY=192.168.0.1
  4. ALLOW_IPS=192.168.0.10,192.168.0.20
  5. NODE_pve1=192.168.0.11
  6. NODE_pve2=192.168.0.12
  7. NODE_pve3=192.168.0.13
  8. ASSIGN_IP_START=100
  9. ASSIGN_IP_END=254
  10. ASSIGN_STORAGE=local-zfs
  11. VM_MAX_CPU=32
  12. VM_MAX_DISK=64
  13. VM_MAX_RAM=32768
  14. VM_BALLOON_MIN=2048
  15. VM_ROOT_PASSWORD=

工作目錄中的其他設定檔見 狀態檔。
EN