---
title: "Установка и настройка QEMU Guest Agent — Timeweb Cloud"
description: "Как установить, проверить и перезапустить QEMU Guest Agent на сервере Linux: инструкции для Debian-, RHEL- и Arch-based-систем и какие функции панели управления недоступны без агента."
---

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

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

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

> [!NOTE]
> Эта инструкция описывает установку QEMU на машины Linux.  
>   
> Для Windows сервис QEMU можно установить с помощью специального ISO-образа, который можно [скачать здесь](https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/archive-virtio/?C=M;O=D). Также с его помощью можно установить virtio-драйверы, необходимые для поддержки виртуализированных устройств. 

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

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

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

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

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

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

1.  Подключитесь к серверу через веб-консоль в панели или [по SSH](https://timeweb.cloud/docs/unix-guides/ssh).
2.  Выполните команду:

```shell
systemctl status qemu-guest-agent
```

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

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

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

```shell
   Active: inactive (dead) since ...
```

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

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

1.  Подключитесь к серверу через веб-консоль в панели или [по SSH](https://timeweb.cloud/docs/unix-guides/ssh).
2.  Выполните команду:

```shell
systemctl restart qemu-guest-agent.service
```

3.  Проверьте, что все работает корректно, с помощью команды:

```shell
systemctl status qemu-guest-agent.service
```

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

```shell
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](https://timeweb.cloud/docs/unix-guides/ssh) и выполните в консоли приведенные ниже команды, выбрав вариант для вашей операционной системы.

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

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

Debian-based

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

```bash
sudo apt update
```

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

```bash
sudo apt install qemu-guest-agent -y
```

RHEL-based

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

```bash
sudo yum update
```

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

```bash
sudo yum install qemu-guest-agent -y
```

Arch-based

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

```bash
sudo pacman -Syu
```

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

```bash
sudo pacman -S qemu-guest-agent
```

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

```bash
sudo systemctl start qemu-guest-agent
```

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

```bash
sudo systemctl enable qemu-guest-agent
```