<div><img src="https://top-fwz1.mail.ru/counter?id=3548135;js=na" style="position:absolute;left:-9999px;" alt="Top.Mail.Ru" /></div>
Managed Kubernetes — разверните готовый кластер за 5 минут →
Вход / Регистрация
На главную
61c46507-12c7-4300-a301-bd8bc30c7c19
Инструкции для серверов

Установка QEMU-агента

Для корректной работы на ваш сервер должна быть установлена программа-демон QEMU Guest Agent. Она запускается внутри виртуальной машины и обеспечивает полноценную работу с сервером в панели управления. 

Эта инструкция описывает установку QEMU на машины Linux.

Для Windows сервис QEMU можно установить с помощью специального ISO-образа, который можно скачать здесь. Также с его помощью можно установить virtio-драйверы, необходимые для поддержки виртуализированных устройств. 

Если QEMU-агент отсутствует или отключен, в панели будут недоступны следующие действия:

  • Создание бэкапа, в том числе автоматического
  • Создание снапшота
  • Добавление SSH-ключа
  • Удаление SSH-ключа
  • Сброс пароля root
  • Клонирование сервера
  • Создание образа сервера
  • Открытие или закрытие доступа для поддержки
  • Корректное отображение графиков дашборда

Если при создании сервера вы установили на него любое ПО из маркетплейса, QEMU-агент будет установлен автоматически. В остальных случаях вы можете установить его вручную по этой инструкции.

Хотя QEMU Guest Agent можно установить в BSD-системах (FreeBSD, OpenBSD, pfSense), он не поддерживает необходимые функции для управления виртуальной машиной и не будет работать корректно.

Проверка наличия QEMU-агента

Чтобы проверить, установлен ли агент QEMU на вашем сервере:

  1. Подключитесь к серверу через веб-консоль в панели или по SSH.
  2. Выполните команду:
systemctl status qemu-guest-agent

Подобный вывод означает, что агент не установлен:

Unit qemu-guest-agent.service could not be found.

А в данном случае агент есть, но отключен — нужно его перезапустить:

   Active: inactive (dead) since ...

Перезапуск qemu-guest-agent

Если вы уже устанавливали QEMU-агент, но описанный функционал панели недоступен, попробуйте перезапустить его — скорее всего, это решит проблему.

  1. Подключитесь к серверу через веб-консоль в панели или по SSH.
  2. Выполните команду:
systemctl restart qemu-guest-agent.service
  1. Проверьте, что все работает корректно, с помощью команды:
systemctl status qemu-guest-agent.service

Если все в порядке, вывод команды будет следующим:

qemu-guest-agent.service - QEMU Guest Agent
Loaded: loaded (/lib/systemd/system/qemu-guest-agent.service; static)
Active: active (running)

Установка qemu-guest-agent

Чтобы установить QEMU-агент, подключитесь к серверу по SSH и выполните в консоли приведенные ниже команды, выбрав вариант для вашей операционной системы.

Процесс установки зависит от используемого дистрибутива. Выберите подходящую вкладку:

  • Debian-based — для Debian, Ubuntu, Astra Linux;
  • RHEL-based — для CentOS, AlmaLinux, BitrixVM;
  • Arch-based — для Arch Linux и производных.

Debian-based

Обновите репозитории:

sudo apt update

Установите QEMU Guest Agent:

sudo apt install qemu-guest-agent -y

RHEL-based

Обновите репозитории:

sudo yum update

Установите QEMU Guest Agent:

sudo yum install qemu-guest-agent -y

Arch-based

Обновите систему:

sudo pacman -Syu

Установите QEMU Guest Agent:

sudo pacman -S qemu-guest-agent

Запустите агент:

sudo systemctl start qemu-guest-agent

И добавьте его в автозапуск:

sudo systemctl enable qemu-guest-agent
Была ли статья полезна?
Ваша оценка очень важна
Комментарии 12
Антон
02.11.2025, 22:51

Удивительно, что нет инструкции для freeBSD, а ведь она такая же простая как для linux.

Установить из репо агента

pkg install qemu-guest-agent

Активировать сервис для автозапуска

service qemu-guest-agent enable

При необходимости можно проверить запущен ли сервис

service qemu-guest-agent status

Команда Timeweb Cloud
Команда Timeweb Cloud
05.11.2025, 15:40

Добрый день!

Вы действительно можете установить агент для FreeBSD таким образом, но многие функции в панели управления останутся недоступными — в реализации агента для BSD не хватает функций, которые мы используем для управления ВМ. По этой причине мы не добавляем отдельную инструкцию по установке.

Мы добавили пометку об этом в статью. Спасибо за замечание!

Alex
17.08.2024, 09:09

Здравствуйте, в ssh консоли пишет: active (running). Но на сайте: QEMU-агент на сервере недоступен. Подскажите, пожалуйста, что нужно сделать в таком случае.

Ярослав
20.08.2024, 13:38

такая же проблема

Дмитрий
Дмитрий
19.10.2024, 11:32

Аналогично

Команда Timeweb Cloud
Команда Timeweb Cloud
19.11.2024, 18:21

Добрый день!

Создайте, пожалуйста, тикет в поддержку. Коллеги посмотрят, из-за чего возникает проблема, и помогут ее решить.

AndreiAAn
AndreiAAn
15.04.2024, 15:07

Если hostname поменял, все, не видит агента?

Команда Timeweb Cloud
Команда Timeweb Cloud
16.04.2024, 06:32

Смена hostname может повлиять на работу Qemu-агента. Пожалуйста, напишите в поддержку из своей панели — коллеги всё проверят и помогут настроить 👌

banderaz79
banderaz79
26.03.2024, 07:16

Для CentOS 6 нерабочая ссылка

Команда Timeweb Cloud
Команда Timeweb Cloud
26.03.2024, 09:23

Добрый день! Мы удалили устаревшую информацию из инструкции. CentOS 6 уже давно не поддерживается, для работы рекомендуем обновить систему до одной из актуальных версий.

Alexander Mart
Alexander Mart
13.10.2023, 07:05

Предложение правок к этой странице документации:

diff
- Ubuntu 18.04
+ Ubuntu 18.04 и выше
Команда Timeweb Cloud
Команда Timeweb Cloud
13.10.2023, 09:50

Спасибо! Внесли правки.