Первый запуск в QEMU

Обновлено 11.10.2026

Пробная инструкция. Условия проверки указаны в конце страницы.

Перед запуском

Это пробная инструкция для образа x86_64. Команды выполняются на Linux-хосте с установленным QEMU. Скачайте актуальный публичный образ со страницы загрузок и сравните его SHA-256 с опубликованным значением:

sha256sum x86_64.hdd.gz

Имя файла в примерах условное. Если на странице нет доступного образа, инструкция не заменяет его: используйте предоставленный разработчиком файл.

Подготовка диска

Распакуйте raw-образ и создайте отдельный рабочий диск qcow2. Исходный образ останется доступным для повторных запусков:

gzip -dk x86_64.hdd.gz
qemu-img convert -f raw -O qcow2 x86_64.hdd synapse.qcow2

Если скачанный файл уже имеет формат qcow2, используйте его копию и пропустите распаковку и конвертацию.

Запуск виртуальной машины

qemu-system-x86_64 \
  -machine q35 \
  -m 256 -smp 2 \
  -drive file=synapse.qcow2,format=qcow2,if=virtio \
  -netdev user,id=net0 \
  -device virtio-net-pci,netdev=net0 \
  -serial stdio

256 МБ памяти - параметр примера, а не заявленный минимальный объём. После загрузки проверьте наличие приглашения оболочки. Если графическое окно остаётся пустым, посмотрите вывод последовательного порта в терминале хоста.

Проверка

В гостевой оболочке выполните:

uname -a
ls /bin
cat /etc/settings.ini

Список программ зависит от версии образа. Команды установки отдельных портов описаны в инструкции по пакетам.

Если запуск не удался

Проверьте формат диска: raw-файл нельзя объявлять как qcow2.
Убедитесь, что рабочий диск существует и доступен для записи.
Сохраните версию QEMU, параметры запуска и последние строки serial-вывода.
При обращении к разработчикам укажите версию и SHA-256 образа.

Состояние инструкции

Это пример наполнения документации, сверенный с исходниками проекта. Полный запуск по этой инструкции на конкретном опубликованном образе ещё не подтверждён. Отметка о проверенной сборке появится после тестирования.