게스트 에이전트: 왜 중요한가와 재설치 방법

제어판은 일부 데이터를 외부가 아니라 시스템 내부의 작은 서비스인 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.

에이전트는 머신 접근을 대체하지 않아요. 시스템이 부팅되지 않을 때 도움이 되는 건 에이전트가 아니라 복구 디스크예요.