Документация
Документация VyOS
Первые шаги с VyOS
Установка VyOS и управление образами

Установка VyOS и управление образами

VyOS может быть установлена на различные платформы: физическое оборудование, виртуальные машины, облачные среды.

Требования к системе

Минимальные требования

  • Процессор: 1 CPU core (64-bit)
  • Память: 512 MB RAM
  • Дисковое пространство: 2 GB

Рекомендуемые требования

  • Процессор: 2+ CPU cores
  • Память: 2 GB RAM или более
  • Дисковое пространство: 10 GB или более

Предварительные требования для виртуальных установок

Важно: При установке на виртуальные машины убедитесь, что MAC-адреса сетевых интерфейсов не являются локально администрируемыми (locally administered). Локально администрируемые адреса определяются установкой второго младшего бита первого октета в 1.

Пример локально администрируемого MAC-адреса (не рекомендуется):

02:00:00:00:00:01

Рекомендуемый формат MAC-адреса:

00:50:56:xx:xx:xx

Загрузка образа

Загрузите ISO-образ VyOS:

Доступные версии

  • VyOS 1.5.x (Circinus) - Rolling release (текущая разработка)
  • VyOS 1.4.x (Sagitta) - LTS (Long Term Support)

Типы установки

1. Live-установка

Live-образ позволяет запустить VyOS без установки на диск. Это полезно для:

  • Тестирования VyOS
  • Аварийного восстановления
  • Временного использования

После загрузки с ISO войдите в систему:

  • Username: vyos
  • Password: vyos

2. Постоянная установка

Для установки VyOS на диск выполните команду:

vyos@vyos:~$ install image

Мастер установки задаст следующие вопросы:

Would you like to continue? (Yes/No) [Yes]: Yes
Partition (Auto/Parted/Skip) [Auto]: Auto
Install the image on? [sda]: sda
Continue? (Yes/No) [No]: Yes
How big of a root partition should I create? (2000MB - 20000MB) [20000]:
What would you like to name this image? [1.5.x-latest]:
Copy config to new image? (Yes/No) [No]: No
Enter password for user 'vyos': ********
Retype password for user 'vyos': ********
Which drive should GRUB modify the boot partition on? [sda]: sda

Параметры установки:

  • Partition: Автоматическое разбиение диска
  • Install the image on: Целевой диск (обычно sda)
  • Root partition size: Размер корневого раздела
  • Image name: Имя образа (для управления версиями)
  • Copy config: Копировать ли текущую конфигурацию
  • Password: Пароль пользователя vyos
  • GRUB: Установка загрузчика

После установки перезагрузите систему:

vyos@vyos:~$ reboot

Установка в различных средах

Виртуальные среды

Libvirt/KVM/QEMU 

virt-install \
  --name vyos \
  --ram 2048 \
  --vcpus 2 \
  --disk path=/var/lib/libvirt/images/vyos.qcow2,size=10 \
  --os-variant debian10 \
  --network bridge=virbr0 \
  --graphics vnc \
  --console pty,target_type=serial \
  --cdrom /path/to/vyos.iso

Proxmox VE

  1. Загрузите ISO в хранилище Proxmox
  2. Создайте новую виртуальную машину:
    • OS Type: Linux (6.x - 2.6 Kernel)
    • Memory: минимум 512MB, рекомендуется 2GB
    • Network: VirtIO (паравиртуализация)
    • Disk: VirtIO SCSI, минимум 2GB
  3. Загрузите с ISO и выполните install image

VMware ESXi

  1. Создайте новую виртуальную машину:
    • Guest OS: Other Linux (64-bit)
    • Memory: минимум 512MB
    • Network Adapter: VMXNET3
    • SCSI Controller: VMware Paravirtual
  2. Подключите ISO-образ VyOS
  3. Загрузите и выполните установку

Облачные среды

Amazon AWS

VyOS доступна в AWS Marketplace:

  1. Найдите AMI VyOS в Marketplace
  2. Запустите EC2 инстанс
  3. Подключитесь по SSH используя ключ EC2

Начальная конфигурация:

ssh -i your-key.pem vyos@<instance-ip>

Microsoft Azure

  1. Найдите VyOS в Azure Marketplace
  2. Создайте виртуальную машину
  3. Подключитесь по SSH

Google Cloud Platform

  1. Найдите VyOS в GCP Marketplace
  2. Создайте Compute Engine инстанс
  3. Подключитесь по SSH через консоль GCP или gcloud CLI

Яндекс.Облако

VyOS доступна в Яндекс.Облаке через Marketplace. При развертывании используются оптимизированные образы для облачной среды.

Развертывание из Marketplace
  1. Перейдите в Yandex Cloud Marketplace
  2. Найдите VyOS (доступны версии 1.4 LTS и 1.5 Current)
  3. Создайте виртуальную машину из образа
  4. Укажите SSH ключ в metadata при создании
Важные особенности для Yandex Cloud

Автоматическая конфигурация при первом запуске:

  • Образ автоматически настраивается при первой загрузке через cloud-init
  • Создается пользователь из метаданных инстанса (вместо стандартного vyos)
  • SSH ключи добавляются автоматически из Yandex Cloud metadata
  • Password authentication отключается после настройки SSH ключей
  • Cloud-init отключается после первого запуска для безопасности
  • Сетевая конфигурация полностью управляется VyOS (cloud-init не управляет сетью)

Доступ к инстансу:

ssh -l <your-username> <instance-ip>

Где <your-username> - имя пользователя из метаданных Yandex Cloud (обычно совпадает с логином в консоли).

Оптимизации для Yandex Cloud:

  • Включен qemu-guest-agent для интеграции с гипервизором
  • Настроены VirtIO offloading (GSO, GRO, TSO, SG)
  • Оптимизирован TCP stack (BBR congestion control)
  • Настроена консоль через serial port (ttyS0) для доступа через Yandex Cloud Console
  • Автоматическое расширение корневого раздела до полного размера диска

Metadata service:

datasource_list: [ Ec2 ]
datasource:
  Ec2:
    metadata_urls: [ 'http://169.254.169.254' ]
    strict_id: false

Сетевая конфигурация отключена в cloud-init:

network: {config: disabled}

Это обеспечивает полный контроль VyOS над сетевой конфигурацией.

Физическое оборудование

Поддерживаемые платформы

VyOS работает на различном x86_64 оборудовании:

  • Supermicro A2SDi (Atom C3000)
  • PC Engines APU4
  • Qotom Q355G4
  • Partaker i5
  • Acrosser AND-J190N1
  • Gowin GW-FN-1UR1-10G
  • Любой x86_64 сервер с поддержкой VGA/Serial консоли

Процесс установки

  1. Запишите ISO на USB-накопитель:
dd if=vyos-1.5.x.iso of=/dev/sdX bs=4M status=progress
sync
  1. Загрузитесь с USB
  2. Выполните install image
  3. Извлеките USB и перезагрузите систему

PXE Boot

VyOS поддерживает загрузку по сети через PXE:

  1. Настройте TFTP-сервер
  2. Извлеките kernel и initrd из ISO
  3. Настройте PXE конфигурацию:
LABEL vyos
    MENU LABEL VyOS
    KERNEL vyos/vmlinuz
    APPEND initrd=vyos/initrd.img boot=live

Обновление VyOS

Добавление нового образа

Загрузка и установка нового образа:

vyos@vyos:~$ add system image https://example.com/vyos-1.5.x-latest.iso

Или с локального файла:

vyos@vyos:~$ add system image /tmp/vyos-1.5.x-latest.iso

Просмотр установленных образов 

vyos@vyos:~$ show system image
The system currently has the following image(s) installed:

   1: 1.5.x-latest (default boot)
   2: 1.5.x-previous
   3: 1.4.x-stable

Выбор образа для загрузки

Установка образа по умолчанию:

vyos@vyos:~$ set system image default-boot 1.5.x-latest

Удаление старых образов 

vyos@vyos:~$ delete system image 1.4.x-stable

Откат системы

VyOS поддерживает откат к предыдущим версиям образов.

Откат через GRUB

При загрузке системы:

  1. Прервите автоматическую загрузку (нажмите любую клавишу)
  2. Выберите нужный образ из списка
  3. Загрузитесь с выбранного образа

Откат конфигурации

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

vyos@vyos:~$ configure
vyos@vyos# rollback 1
vyos@vyos# commit
vyos@vyos# save

Secure Boot

VyOS поддерживает Secure Boot начиная с версии 1.5.x.

Установка с Secure Boot

  1. Убедитесь, что Secure Boot включен в UEFI/BIOS
  2. Загрузитесь с ISO (подписанного образа)
  3. Выполните стандартную установку:
vyos@vyos:~$ install image

Обновление образа с Secure Boot

При добавлении нового образа убедитесь, что он подписан:

vyos@vyos:~$ add system image https://example.com/vyos-1.5.x-signed.iso

Проверка Secure Boot

Проверка статуса Secure Boot:

vyos@vyos:~$ show system boot secure-boot
Secure Boot: enabled

Устранение неполадок Secure Boot

Если система не загружается с включенным Secure Boot:

  1. Проверьте, что используется подписанный образ
  2. Убедитесь, что сертификаты правильно установлены в UEFI
  3. Попробуйте отключить Secure Boot временно для диагностики

Резервное копирование и восстановление

Резервное копирование конфигурации

Копирование конфигурации на удаленный сервер:

vyos@vyos:~$ save /tmp/config.boot
vyos@vyos:~$ scp /tmp/config.boot user@backup-server:/backups/

Восстановление конфигурации 

vyos@vyos:~$ scp user@backup-server:/backups/config.boot /tmp/
vyos@vyos:~$ configure
vyos@vyos# load /tmp/config.boot
vyos@vyos# commit
vyos@vyos# save

Известные проблемы

Проблемы с MAC-адресами

При клонировании виртуальных машин убедитесь, что MAC-адреса сетевых интерфейсов уникальны.

Проблемы с загрузкой

Если система не загружается после установки:

  1. Проверьте настройки BIOS/UEFI
  2. Убедитесь, что GRUB установлен на правильный диск
  3. Попробуйте загрузиться с ISO и переустановить GRUB

Проблемы с Secure Boot

Если Secure Boot не работает:

  1. Убедитесь, что используется подписанный образ
  2. Проверьте, что Platform Key (PK) правильно установлен
  3. Попробуйте сбросить UEFI настройки до заводских

Следующие шаги

После установки VyOS продолжите с:

Быстрый старт VyOS - Настройка NAT-шлюза за 10 минутИнтерфейс командной строки VyOS - Операционный режим и конфигурация