Документация / Начало работы
Частые проблемы при запуске
Обновлено 19.11.2026
Найдите сообщение об ошибке или похожий симптом в списке ниже. Команды для Linux на вашем компьютере и команды внутри Синапс ОС отмечены отдельно.
Не проходит проверка SHA-256
Сообщение FAILED означает, что файл не совпал с контрольной суммой. Проверьте, что образ и SHA-256 скачаны из одной строки таблицы на странице одной редакции. Для .gz нужна сумма архива, для распакованного образа нужна сумма самого образа.
Если видите No such file or directory, откройте папку со скачанными файлами и проверьте их имена: браузер мог добавить (1) при повторном скачивании. Файл .sha256 содержит имя проверяемого файла.
В терминале Linux на своём компьютере выполните из этой папки:
sha256sum -c *.sha256
В папке должны быть один образ и соответствующий ему файл .sha256. Продолжайте после OK. При FAILED скачайте образ и сумму заново. Рабочий диск с вашими данными не заменяйте.
QEMU не открывает архив или не находит диск
Архив .qcow2.gz сначала нужно распаковать. После успешной проверки SHA-256 выполните на своём компьютере:
gzip -dk *.qcow2.gz
В папке должен быть один такой архив. Для запуска нужен распакованный .qcow2, а не .gz.
Если ошибка содержит Could not open или No such file or directory, откройте папку, где находятся base.qcow2 и disk.qcow2, и повторите команду запуска из инструкции для своей редакции. Эти имена используются в наших примерах; если вы выбрали другие, укажите их в команде.
Если QEMU сообщает Failed to get write lock, проверьте, не открыта ли уже виртуальная машина с этим диском. Завершите её работу перед повторным запуском. Не запускайте две машины с одним рабочим диском одновременно.
Ошибка KVM или Permission denied для /dev/kvm
Это ошибка аппаратного ускорения на компьютере, где запускается QEMU. В Linux проверьте наличие устройства и свои группы:
ls -l /dev/kvm
id
Если устройства нет, проверьте поддержку виртуализации и её включение в BIOS/UEFI. Внутри другой виртуальной машины KVM также зависит от настроек внешнего гипервизора. Если устройство есть, но доступ запрещён, настройте доступ пользователя к KVM средствами своего дистрибутива.
Для запуска без KVM в команде QEMU замените:
-machine q35,accel=kvm -cpu host
на:
-machine q35,accel=tcg -cpu max
Остальные параметры оставьте прежними. Программная эмуляция обычно медленнее. Параметры ускорения QEMU.
Вместо рабочего стола открывается консоль
Для Tiny и Cloud это обычный режим работы. Графический рабочий стол входит в Desktop и Extended.
Если вы скачали Desktop или Extended, проверьте имя исходного образа и команду запуска. Параметры -display none и -nographic скрывают графический вывод: для работы в окне QEMU уберите их. Не добавляйте второй параметр -display поверх первого.
При первом запуске может открыться мастер настройки. Завершите его, задайте пароль администратора и войдите как root с этим паролем. Первая настройка Desktop.
Чёрный экран, загрузка остановилась или работает очень медленно
Сначала проверьте ресурсы и конфигурацию виртуальной машины. Для Tiny и Cloud рекомендованный минимум: 1 vCPU, 256 МБ ОЗУ и диск 5 ГБ. Для Desktop и Extended минимум: 2 vCPU, от 1 ГБ ОЗУ и диск 15 ГБ; рекомендуемая конфигурация: от 4 vCPU, от 4 ГБ ОЗУ и от 40 ГБ на диске.
Сравните команду запуска с инструкцией для своей редакции. Для диагностики используйте указанные там модель машины, диск virtio и сетевой адаптер virtio. Не меняйте несколько устройств одновременно. При эмуляции TCG запуск может быть заметно медленнее, чем с KVM.
Если проблема возникает на физическом компьютере, проверьте тот же образ в QEMU. Если он запускается в виртуальной машине, причина может быть связана с оборудованием или его драйвером. Сфотографируйте последние строки загрузки и сообщите о проблеме.
Нет сети или не открываются сайты
Внутри Синапс ОС проверьте адрес интерфейса и разрешение имени:
ip addr
nslookup synapseos.ru
В стандартной сети QEMU адрес гостевой системы обычно 10.0.2.15. Это пример, а не адрес, который нужно назначать вручную.
Если адреса нет, проверьте, что в команде запуска присутствуют обе строки:
-netdev user,id=net0
-device virtio-net-pci,netdev=net0
Убедитесь, что на своём компьютере работает интернет. Если ранее меняли сеть внутри ОС, проверьте режим DHCP в настройках системы.
Если адрес есть, но nslookup не возвращает адрес сайта, проверьте настройки DNS. Не задавайте случайный статический IP вместо исправления DNS. Если имя разрешается, а конкретный сайт всё равно не открывается, сохраните текст ошибки приложения.
На физическом компьютере отсутствие интерфейса также может означать, что сетевой адаптер не поддерживается. Укажите его модель в сообщении о проблеме.
Не получается подключиться по SSH
Сначала различите сетевую ошибку и ошибку входа.
Connection refused: проверьте, включён ли SSH внутри ОС и совпадают ли порты.Connection timed out: проверьте адрес, сетевую доступность и проброс порта.Permission denied (publickey): сервер доступен, но не принял SSH-ключ.
В Cloud общий пароль по умолчанию не задан: добавьте свой ключ через cloud-init или локальную консоль. В Tiny SSH изначально выключен. Сведения о входе указаны на страницах редакций.
При запуске по нашим инструкциям QEMU использует NAT. Для подключения с того же компьютера в команде QEMU замените строку -netdev user,id=net0 на:
-netdev user,id=net0,hostfwd=tcp:127.0.0.1:2222-:22
Завершите работу текущей виртуальной машины и запустите её с изменённой командой, используя прежний disk.qcow2. Затем на своём компьютере подключитесь:
ssh -p 2222 root@127.0.0.1
Проброс направляет локальный порт 2222 на порт 22 гостевой системы и доступен только с этого компьютера. Сам по себе он не включает SSH и не настраивает ключ. Если QEMU сообщает, что порт занят, выберите другой свободный локальный порт и укажите его также в команде ssh. Справка QEMU о пробросе портов.
После повторного запуска пропали файлы или настройки
Для сохранения изменений нужно запускать тот же рабочий диск disk.qcow2. Проверьте, что команда QEMU указывает на него и что вы не создали новый рабочий диск поверх прежнего.
Параметр QEMU -snapshot сохраняет изменения во временное хранилище: после завершения такого запуска они обычно теряются. Для обычной работы с сохранением данных запускайте прежний рабочий диск без этого параметра.
Если ошибка появилась после переноса папки, проверьте связь рабочего диска с исходным образом. При выключенной виртуальной машине выполните на своём компьютере:
qemu-img info --backing-chain disk.qcow2
Если исходный base.qcow2 не найден, верните тот же исходный файл по пути, который указан в выводе. Образ другого выпуска не заменяет исходную основу. Не пересоздавайте disk.qcow2 и не исправляйте его наугад: сначала сохраните копии имеющихся файлов. Диски и режим snapshot в QEMU.
Перед завершением работы выполняйте sync внутри ОС. На USB-флешке также проверьте, что при повторном запуске загружаетесь именно с того накопителя, на который записывали систему.
Компьютер не загружается с USB-флешки
На накопитель нужно записать распакованный RAW-образ целиком. Простое копирование .raw или .gz в файловом менеджере не создаёт загрузочную флешку. QCOW2 и VDI также не подходят для записи по инструкции RAW.
Проверьте выбранный накопитель в меню загрузки BIOS/UEFI. Попробуйте другой USB-порт без промежуточного концентратора. Если загрузка начинается, но затем останавливается, сохраните фото последних строк.
Если собираетесь повторить запись, сначала скопируйте нужные данные с флешки: повторная запись образа сотрёт их. Порядок выбора накопителя и записи описан в инструкции для USB.
Если проблема осталась
В сообщении проекту укажите редакцию и выпуск, способ запуска, выделенные vCPU и ОЗУ, модель оборудования или версию QEMU. Приложите точный текст ошибки и опишите, что сделали перед её появлением.
Если консоль ОС доступна, приложите вывод:
uname -a
free
ip addr
При проблеме с загрузкой приложите фото последних строк экрана. При проблеме с QEMU также полезен вывод qemu-system-x86_64 --version на вашем компьютере и команда запуска с удалёнными паролями и другими секретами.