QEMU/KVM AGL 虛擬機器
AGL QEMU VM
| VMID | 主機 | 名稱 | 角色 | Tailscale IP |
|---|---|---|---|---|
| 104 | AGLSRV1 | aglwk45 | OpenClaw 工作節點 (Windows) | 經由 192.168.0.245 |
存取方式
# AGLSRV1 (執行 QEMU/KVM 的 Proxmox 主機)
ssh AGLSRV1 # 192.168.0.245 (區域網路) 或 100.107.113.33 (Tailscale)
QEMU VM 操作 (透過 qm)
列出所有 VM
ssh AGLSRV1 "qm list"
啟動/停止 VM
# 啟動
ssh AGLSRV1 "qm start 104"
# 停止 (ACPI 關機)
ssh AGLSRV1 "qm shutdown 104"
# 強制停止
ssh AGLSRV1 "qm stop 104"
# 重新啟動
ssh AGLSRV1 "qm reboot 104"
VM 狀態
ssh AGLSRV1 "qm status 104"
ssh AGLSRV1 "qm list | grep 104"
主控台存取
# VNC 主控台 (取得 VNC 埠)
ssh AGLSRV1 "qm vncproxy 104"
# 序列主控台 (若有設定)
ssh AGLSRV1 "qm terminal 104"
快照
# 建立快照
ssh AGLSRV1 "qm snapshot 104 pre-update"
# 列出快照
ssh AGLSRV1 "qm listsnapshot 104"
# 回滾 (VM 必須先停止)
ssh AGLSRV1 "qm stop 104 && qm rollback 104 pre-update && qm start 104"
# 刪除快照
ssh AGLSRV1 "qm delsnapshot 104 pre-update"
複製 VM
# 完整複製
ssh AGLSRV1 "qm clone 104 <new-vmid> --name <new-name> --full"
# 連結複製 (較快,依賴來源)
ssh AGLSRV1 "qm clone 104 <new-vmid> --name <new-name>"
資源設定
# 設定記憶體
ssh AGLSRV1 "qm set 104 --memory 8192"
# 設定 CPU 核心數
ssh AGLSRV1 "qm set 104 --cores 4"
# 設定網路橋接
ssh AGLSRV1 "qm set 104 --net0 virtio,bridge=vmbr0"
QEMU Guest Agent
安裝 (在 VM 內部)
# Windows
# 從 VirtIO 驅動程式 ISO 安裝 qemu-ga
# Linux
apt install qemu-guest-agent # Debian/Ubuntu
systemctl enable qemu-guest-agent
systemctl start qemu-guest-agent
在 Proxmox 中啟用
ssh AGLSRV1 "qm set 104 --agent enabled=1"
使用 Guest Agent
# 透過 Guest Agent 取得 VM 資訊
ssh AGLSRV1 "qm guest exec 104 -- ip a"
# 取得網路介面
ssh AGLSRV1 "qm guest exec 104 -- ip -j addr show" | jq
# 在 VM 內部執行命令
ssh AGLSRV1 "qm guest exec 104 -- systemctl status openclaw-gateway"
# 凍結檔案系統 (用於快照)
ssh AGLSRV1 "qm guest cmd 104 fsfreeze-freeze"
ssh AGLSRV1 "qm guest cmd 104 fsfreeze-thaw"
磁碟管理
列出磁碟
ssh AGLSRV1 "qm config 104 | grep virtio"
調整磁碟大小
ssh AGLSRV1 "qm resize 104 virtio0 +10G"
移動磁碟
# 移動到不同儲存區
ssh AGLSRV1 "qm move-disk 104 virtio0 local-lvm"
AGLWK45 (VM104) 專用
AGLWK45 上的 OpenClaw
# 透過 Guest Exec 驗證 OpenClaw 狀態
ssh AGLSRV1 "qm guest exec 104 -- powershell -Command 'Get-Service openclaw'"
# 或從 VM 內部透過 Tailscale
ssh AGLSRV1 "qm guest exec 104 -- tailscale status"
驗證腳本
# 從儲存庫執行驗證腳本
./scripts/verify-aglwk45-fgsrv06.sh
直接使用 QEMU (非 Proxmox)
用於獨立 QEMU 的用法:
# 啟動 QEMU VM
qemu-system-x86_64 \
-enable-kvm \
-m 4096 \
-smp 4 \
-drive file=disk.qcow2,format=qcow2 \
-netdev user,id=net0 -device virtio-net-pci,netdev=net0 \
-serial mon:stdio \
-nographic
# 使用 VNC
qemu-system-x86_64 -enable-kvm -m 4096 -vnc :0 disk.qcow2
# 使用 Tailscale (在 VM 內部)
# 在 VM 中安裝 tailscale 以進行遠端存取
疑難排解
VM 無法啟動
# 檢查是否被鎖定
ssh AGLSRV1 "qm status 104"
# 檢查儲存空間
ssh AGLSRV1 "pvesm status"
# 檢查日誌
ssh AGLSRV1 "qm start 104 2>&1"
Guest Agent 無回應
# 檢查是否已啟用
ssh AGLSRV1 "qm config 104 | grep agent"
# 檢查 VM 內部
ssh AGLSRV1 "qm guest exec 104 -- systemctl status qemu-guest-agent"
網路問題
# 檢查橋接
ssh AGLSRV1 "brctl show"
# 檢查 VM 網路設定
ssh AGLSRV1 "qm guest exec 104 -- ip a"
備註
- AGLWK45 (VM104) 執行 OpenClaw 閘道器 — 避免在活躍工作階段期間重新啟動
- QEMU VM 在 Proxmox 中使用
qm命令 (與 LXC 容器的pct相對) - Guest Agent 可從 Proxmox 主機啟用檔案複製、命令執行和 fsfreeze
- 在進行重大變更前務必建立快照