存取控制
最後更新
本頁說明 QemuRun-pve 的三層防護:CORS 來源限制、
ALLOW_IPS 白名單,以及每台 VM 的狀態與鎖定檢查。第一層:CORS
所有請求經過 CORS 中介層:
Origin | 回應 |
|---|---|
私有 IP(10.0.0.0/8、172.16.0.0/12、192.168.0.0/16),且與伺服器所在 /24 子網相同 | Access-Control-Allow-Origin 回傳該 Origin |
| 其他來源 | 不設定 Access-Control-Allow-Origin |
無 Origin(curl、伺服器端呼叫) | Access-Control-Allow-Origin 設為子網樣式(如 192.168.0.*),非瀏覽器呼叫端會忽略 |
伺服器子網取自第一個非 loopback、私有網段的 IPv4 介面;找不到時以
192.168.0.* 計。允許的方法為 GET、POST、OPTIONS,OPTIONS 預檢直接回 204。SSE 端點(install、start、reboot、set/node)通過前置檢查並開始串流後,會把
Access-Control-Allow-Origin 改寫為請求的 Origin 原值,並設定 Access-Control-Allow-Headers: Cache-Control,因此上述子網規則不適用於這些串流。CORS 只約束瀏覽器,不是身分驗證。
第二層:ALLOW_IPS
所有寫入端點(install、start、stop、shutdown、reboot、destroy、set/*)先比對來源 IP:
ALLOW_IPS | 行為 |
|---|---|
0.0.0.0 | 全部放行 |
192.168.0.10,192.168.0.20 | 只放行列出的 IP |
| 未設定或空字串 | 全部拒絕 |
來源 IP 取自 Gin 的
c.ClientIP()。服務未設定受信任代理,Gin 預設會採用 X-Forwarded-For/X-Real-IP 標頭,因此 API 直接對外時,用戶端可偽造來源 IP;請只在受控網段內開放此服務。被拒絕時的回應:
| 端點類型 | 回應 |
|---|---|
| 同步端點 | 403 this IP is not allowed to perform this action |
| SSE 端點 | 200,內容為一行 data: {"message": "...this IP is not allowed to perform this action"} |
查詢端點(health、list、status)不檢查
ALLOW_IPS。第三層:VM 狀態與停用清單
需要指定 VM 的寫入端點會以
pvesh get /cluster/resources 與