Table of Contents

QEMU Guest Agent dla niestandardowych obrazów ISO

Instalując system operacyjny z niestandardowego ISO, musisz również zainstalować QEMU Guest Agent wewnątrz systemu. To mała usługa umożliwiająca platformie zarządzania komunikację z serwerem.


Dlaczego jest wymagany?

Bez QEMU Guest Agent kilka funkcji w panelu klienta będzie niedostępnych lub niepewnych:

Funkcja Bez QEMU Guest Agent
Wyświetlanie prywatnego adresu IP w panelu klienta Niewidoczny
Bezpieczne wyłączanie i restart Dostępne tylko wymuszone zatrzymanie
Spójne kopie zapasowe System plików może nie zostać poprawnie zamrożony
Reset hasła z panelu klienta Niedostępne
Zarządzanie kluczami SSH z panelu klienta Niedostępne

Serwery utworzone z preinstalowanych szablonów OS mają już zainstalowany QEMU Guest Agent. Musisz instalować go ręcznie tylko jeśli użyłeś niestandardowego ISO.


Instalacja w systemie Linux

Debian / Ubuntu:

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

AlmaLinux / Rocky Linux / CentOS / RHEL:

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

Aby zweryfikować, że agent działa:

systemctl status qemu-guest-agent

Instalacja w systemie Windows

Instalacja w Windows wymaga obrazu ISO VirtIO Windows Guest Tools, który jest już dostępny w Twoim VDC jako gotowy obraz ISO. Nie musisz go pobierać z internetu.

  1. Otwórz serwer w panelu klienta i kliknij ISO Image na pasku akcji
  2. Wybierz virtio-win.iso z listy i kliknij Mount Only (bez restartu)
  3. W systemie Windows otwórz Eksplorator plików i znajdź nowy napęd CD-ROM zawierający pliki virtio-win
  4. Uruchom virtio-win-gt-x64.msi – to zainstaluje wszystkie sterowniki VirtIO i QEMU Guest Agent na raz
  5. Otwórz Services (uruchom services.msc) i sprawdź, że usługa QEMU Guest Agent działa, a Startup Type ustawiony jest na Automatic
  6. Po instalacji otwórz ponownie panel ISO Image, aby odmontować VirtIO ISO, gdy nie jest już potrzebny

Wskazówka: jeśli potrzebujesz tylko agenta bez innych sterowników, uruchom guest-agent\qemu-ga-x86_64.msi z tego samego napędu CD-ROM.


Rozwiązywanie problemów

Problem Rozwiązanie
Prywatny adres IP nie wyświetla się w panelu klienta Sprawdź, że agent jest zainstalowany i działa, a następnie zrestartuj serwer
Agent zainstalowany, ale nie startuje (Linux) Uruchom: systemctl enable --now qemu-guest-agent
Agent zainstalowany, ale nie startuje (Windows) Otwórz services.msc, znajdź QEMU Guest Agent, ustaw Startup Type na Automatic i kliknij Start
Nie można znaleźć VirtIO ISO w systemie Windows Otwórz panel ISO Image w panelu klienta, podłącz virtio-win.iso, a następnie sprawdź Eksplorator plików w poszukiwaniu nowego napędu CD-ROM