開始前先了解

本篇以 Ubuntu 24.04 虛擬機示範. 安裝套件的指令只在 Ubuntu 虛擬機內執行, 不是安裝到 Proxmox VE 實體節點.

需要 Ubuntu 的管理權限及可使用的套件來源, 也需要修改虛擬機選項的權限. 請安排一次完整關機與啟動的時間, 並先儲存工作.

Guest Agent 不能取代備份, 不會自動建立 IP 或修好網路. 代理程式可配合備份流程進行檔案系統凍結, 但資料庫仍應搭配適合的應用程式備份設計.

本系列使用 Proxmox VE 9 繁體中文介面的真實截圖. 節點, 儲存名稱與示範數值請換成自己的環境; 作業系統安裝程式可能維持其原有語言.

01在 Ubuntu 虛擬機內安裝套件

選擇目標虛擬機, 開啟 主控台 並登入 Ubuntu. 先確認終端顯示的是客體的主機名稱, 再執行以下指令:

sudo apt-get update
sudo apt-get install -y qemu-guest-agent

等到套件安裝完成再繼續. 如果下載失敗, 先檢查 Ubuntu 的 DNS, 對外連線及套件來源; 不要把套件下載問題當成 Proxmox VE 選項故障.

Ubuntu 虛擬機主控台安裝 qemu-guest-agent 放大圖片
在 Ubuntu 客體的主控台安裝 qemu-guest-agent 套件.

02在虛擬機選項啟用代理程式

回到 Proxmox VE 的同一台虛擬機, 開啟 選項, 找到 QEMU Guest Agent 並按 編輯. 開啟的視窗標題為 編輯: Qemu 代理程式.

勾選 使用 QEMU 客體代理程式, 再按 完成. 這個設定讓虛擬機具備與代理程式通訊的裝置, 只安裝 Ubuntu 套件而沒有啟用這個選項, 仍可能無法使用.

其他與備份凍結檔案系統或啟動後執行 fstrim 有關的選項, 請依儲存與備份規劃決定. 初次設定先保留預設值, 不要為了清除提示任意開關.

Proxmox VE 的 QEMU Guest Agent 編輯視窗 放大圖片
在目標虛擬機的選項內啟用 QEMU Guest Agent.

03完整關機再啟動, 核對客體服務

先在 Ubuntu 儲存工作並正常關機, 等待 Proxmox VE 顯示虛擬機已停止, 再按 啓動. 這裡需要重新建立虛擬硬體, 不是只重新整理瀏覽器.

重新登入 Ubuntu 虛擬機內, 檢查代理程式服務:

sudo systemctl start qemu-guest-agent
systemctl is-active qemu-guest-agent
systemctl status qemu-guest-agent --no-pager

is-active 應顯示 active. Ubuntu 套件可能透過裝置相依性啟動服務, 不必因為 enable 顯示靜態服務提示就反覆執行. 若服務啟動失敗, 先核對管理頁選項與完整關機步驟, 再閱讀狀態中的錯誤.

Ubuntu 主控台顯示 qemu-guest-agent 服務狀態 放大圖片
在 Ubuntu 內核對代理程式的服務狀態.

04回到概觀確認通訊結果

回到虛擬機的 概觀, 等候畫面更新, 核對 IP 資訊是否能取得. 顯示的位址可能包含多張網卡與 IPv6, 請與 Ubuntu 內的網卡資訊逐一比對.

若概觀還沒有 IP, 先在客體執行下列查詢, 確認網卡本身確實具有位址. Guest Agent 不會替沒有設定網路的虛擬機配置地址.

ip -brief address

若服務顯示 active 但管理頁仍提示代理程式未執行, 核對是否操作同一 VM ID, 選項是否已套用, 以及虛擬機是否曾完全停止再啟動. 不要透過停用防火牆或重裝整台主機排除此問題.

Proxmox VE 虛擬機概觀顯示客體代理程式取得的 IP 資訊 放大圖片
概觀頁中的 IP 資訊需與 Ubuntu 實際網卡位址一致.

完成後如何確認

Ubuntu 的 qemu-guest-agent 服務可正常執行, Proxmox VE 概觀也能取得相應客體資訊. 如果 VM 尚未配置網路, 沒有可用 IP 不代表代理程式必然故障.

常見問題

可以只在 Proxmox VE 勾選, 不安裝 Ubuntu 套件嗎?

不可以. 管理端選項與客體內代理程式是兩個必要部分. 兩邊都完成, 才能交換客體資訊.

Windows 也能用嗎?

可以使用對應的 Windows Guest Agent, 但安裝來源與步驟不同. 本篇的 apt-get 與 systemctl 指令只適用於本篇示範的 Ubuntu 客體.

操作時需要協助?

告訴我們您停在哪個步驟, 由客服協助您確認.

聯絡客服