ゲストエージェント：重要性と再インストール方法

コントロールパネルは、一部のデータを外部ではなく、システム内部の小さなサービスである qemu-guest-agent から取得しています。このサービスはポートを開かず、ネットワークにも触れません。通信は仮想化の内部チャネルを経由して行われます。

提供される情報

• 概要のリングに表示される実際のディスク使用量。エージェントがない場合、コントロールパネルはイメージのサイズしか把握できません。
• 正常な再起動とシャットダウン。システムがシグナルを受け取り、電源断ではなくサービスを正しく停止します。
• マシンのネットワークアドレスの正確な一覧。

エージェントがなくてもマシンは動作し続けますが、コントロールパネルに表示される情報が減り、再起動が強制的になります。その場合、データベースやファイルシステムにリスクが及びます。

インストールされていない場合の見分け方

最初の兆候は、/hosting/vds/m/<id> の概要でディスク使用量が表示されなくなることです。その場合、コントロールパネル自体がお使いのシステム向けのインストールコマンドを表示します。

内部から確認します。

systemctl status qemu-guest-agent
ls -l /dev/virtio-ports/org.qemu.guest_agent.0

/dev/virtio-ports にデバイスが存在しない場合、サービスは起動してもすぐにスリープ状態になります。そのためのチャネルが存在しないためです。

インストール

Debian および Ubuntu：

apt update
apt install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

AlmaLinux および CentOS Stream：

dnf install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

Windows Server 2022 および 2025：エージェントは virtio-win ドライバーセットの一部です。virtio-win-guest-tools をインストールし、「サービス」スナップインで QEMU Guest Agent が実行中であり、自動起動に設定されていることを確認してください。

数秒後に概要を更新すると、使用済み容量が表示されるはずです。

表示されなくなる原因

いつでも安全に元に戻せます。このサービスは目立った負荷を生じさせず、ネットワークにも触れません。

よくあるエラー

• サービスが active なのにコントロールパネルにデータがない — グラフが更新されるのを待ち、/dev/virtio-ports にデバイスがあるか確認してください。
• Unit qemu-guest-agent.service not found — パッケージがインストールされていないだけで、壊れているわけではありません。
• エージェントはインストール済みなのに再起動が依然として強制的 — 自動起動を確認してください：systemctl is-enabled qemu-guest-agent。

エージェントはマシンへのアクセスを代替するものではありません。システムが起動しない場合に役立つのはこれではなく、レスキューディスクです。