OpenWrt в Proxmox VE: виртуальный роутер на мини-ПК — установка, сеть и обновление

Разберём, как установить OpenWrt в Proxmox VE и превратить мини-ПК с Proxmox в полноценный домашний роутер: OpenWrt работает в виртуальной машине, раздаёт интернет и DHCP, а на том же железе остаются ресурсы для других виртуальных машин и контейнеров, например для Home Assistant в Proxmox. Proxmox уже должен быть установлен — как это сделать, описано в официальной документации.

Инструкция обновлена под Proxmox VE 9.2 и OpenWrt 25.12.5. Скриншоты сделаны на Proxmox 7.4 и OpenWrt 22.03, но нужные меню с тех пор почти не изменились. Моё железо — мини-ПК на N5105 с четырьмя сетевыми портами; для нагрузки посерьёзнее подойдёт мини-ПК на Intel i5–i7. Всё описанное применимо и к обычному ПК или серверу на x86 (Intel/AMD).

Главное изменение по сравнению с первой версией статьи — схема сети. Раньше Proxmox переносился во внутренний мост без физических портов, и если OpenWrt не загружалась, доступ к Proxmox пропадал. Теперь Proxmox остаётся доступен через LAN-порты даже при выключенном роутере.

Что понадобится

• мини-ПК или сервер x86 с двумя и более сетевыми портами (или одним портом и USB-Ethernet-адаптером);
• установленный Proxmox VE 8 или 9;
• для виртуальной машины OpenWrt — 1–2 ядра, 512 МБ памяти и 2 ГБ на диске;
• ноутбук с Ethernet-портом для первоначальной настройки;
• 30–40 минут, если делать всё по порядку.

Схема сети и порядок действий

• vmbr0 — мост WAN с портом enp2s0, в него включается кабель провайдера. IP-адреса у Proxmox на этом мосту нет, поэтому из интернета Proxmox недоступен.
• vmbr1 — мост локальной сети с остальными портами (enp3s0 enp4s0 enp5s0). Работает как коммутатор: к нему подключены LAN OpenWrt, сам Proxmox и другие виртуальные машины и контейнеры — например, LXC с Jellyfin, к которому можно подключить сетевой диск SMB.
• OpenWrt: первая сетевая карта ВМ (eth0) смотрит в vmbr1 и становится LAN, вторая (eth1) — в vmbr0 и становится WAN. Именно так OpenWrt для x86 распределяет интерфейсы по умолчанию, поэтому ничего переназначать не нужно.

Имена портов у вас могут отличаться — посмотрите их в pve → Система → Сеть. Порядок действий важен:

1. Пока мини-ПК подключён к старому роутеру через enp2s0, создаём мост vmbr1 и виртуальную машину OpenWrt. Proxmox при этом остаётся на старом адресе.
2. Подключаем ноутбук к LAN-порту мини-ПК, настраиваем OpenWrt: пароль, диск, язык.
3. Переносим адрес Proxmox в vmbr1.
4. Только теперь включаем кабель провайдера в enp2s0, а старый роутер переводим в режим точки доступа.

Подсеть OpenWrt должна отличаться от подсети старого роутера. По умолчанию у OpenWrt 192.168.1.1 — если у старого роутера такой же адрес, смените LAN OpenWrt, например, на 192.168.2.1 (как — в разделе про первый запуск). Дальше в примерах используется 192.168.1.1 для OpenWrt и 192.168.1.2 для Proxmox.

Мост локальной сети vmbr1

Откройте pve → Система → Сеть. Мост vmbr0 с первым портом Proxmox создал сам при установке — его пока не трогаем.

Нажмите Создать → Linux Bridge. Имя — vmbr1, IPv4 и шлюз оставьте пустыми, в поле Порты сетевого моста перечислите через пробел все остальные порты: enp3s0 enp4s0 enp5s0. На скриншоте указан один порт — у вас их будет несколько.

Нажмите Применить конфигурацию. Перед этим сделайте резервную копию сетевых настроек в pve → Оболочка — она пригодится, если что-то пойдёт не так:

cp /etc/network/interfaces /etc/network/interfaces.bak

Создание виртуальной машины OpenWrt в Proxmox

Выберите один из трёх способов. Самый быстрый — одна команда в консоли Proxmox; через веб-интерфейс дольше, зато видно каждый шаг.

Способ 1: командами в консоли Proxmox

Откройте pve → Оболочка или подключитесь к Proxmox по SSH и скачайте образ. Нужен файл generic-ext4-combined.img.gz из раздела targets/x86/64 на downloads.openwrt.org:

# Актуальная версия — на downloads.openwrt.org
VER=25.12.5
cd /root
wget https://downloads.openwrt.org/releases/$VER/targets/x86/64/openwrt-$VER-x86-64-generic-ext4-combined.img.gz
# Предупреждение «trailing garbage ignored» — это нормально
gunzip -f openwrt-$VER-x86-64-generic-ext4-combined.img.gz
mv openwrt-$VER-x86-64-generic-ext4-combined.img openwrt.img

Создайте виртуальную машину: команда сразу импортирует образ как диск, подключит сетевые карты в правильном порядке и включит последовательную консоль. В ней, в отличие от обычной консоли noVNC, работает вставка текста.

# ID виртуальной машины — любой свободный номер
VMID=100
qm create $VMID --name openwrt --ostype l26 \
  --cpu host --cores 2 --memory 512 \
  --scsihw virtio-scsi-single \
  --scsi0 local-lvm:0,import-from=/root/openwrt.img \
  --boot order=scsi0 \
  --net0 virtio,bridge=vmbr1 \
  --net1 virtio,bridge=vmbr0 \
  --serial0 socket --vga serial0 \
  --onboot 0
# Диск 2 ГБ: место под пакеты и запас для обновлений
qm disk resize $VMID scsi0 2G
qm start $VMID

--onboot 0 — автозапуск пока выключен. Если с виртуальной машиной что-то не так (например, после проброса PCI-устройства), при автозапуске она может подвесить весь сервер. Включите его, когда убедитесь, что всё работает: qm set 100 --onboot 1. Если хранилище у вас называется не local-lvm, поправьте имя в --scsi0.

Способ 2: через веб-интерфейс Proxmox

Нажмите Создать ВМ в правом верхнем углу. Укажите имя и свободный VM ID, включите Дополнительно. «Запуск при загрузке» пока оставьте выключенным (на скриншоте он включён) — по той же причине, что и в первом способе.

На вкладке ОС выберите Не использовать носители, вкладку Система оставьте без изменений. На вкладке Диски укажите минимальный размер — этот диск мы потом заменим образом OpenWrt.

Процессор: тип host (без этого производительность заметно ниже), 1–2 ядра. Память: 512 МБ достаточно, при большом количестве пакетов — 1024 МБ.

Сеть: выберите мост vmbr1 (это будет LAN) и снимите галочку Сетевой экран — фильтрацией займётся файрвол OpenWrt. На скриншоте из первой версии статьи выбран vmbr0.

Завершите мастер. В разделе Оборудование созданной машины отключите пустой жёсткий диск, затем удалите появившийся «Неиспользуемый диск 0».

Скачайте и распакуйте образ командами из первого способа (блок с wget), затем импортируйте его в виртуальную машину — вместо 100 подставьте свой VM ID:

qm disk import 100 /root/openwrt.img local-lvm

В разделе Оборудование появится «Неиспользуемый диск 0». Откройте его и нажмите Добавить, шина — SCSI.

Добавьте вторую сетевую карту: Добавить → Сетевое устройство, мост vmbr0 (это будет WAN), без сетевого экрана.

В Параметры → Порядок загрузки включите импортированный диск и перетащите его наверх.

Чтобы в консоли работала вставка текста, добавьте Добавить → Последовательный порт (номер 0) и в пункте Дисплей выберите «Последовательный терминал 0». Размер диска увеличьте до 2 ГБ: Жёсткий диск → Действие над диском → Изменить размер, добавить 2 ГБ.

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

Способ 3: готовый скрипт community-scripts

Скрипт OpenWrt VM из проекта Proxmox VE Helper-Scripts делает почти всё то же самое автоматически. Сейчас я сам ставлю OpenWrt именно им — когда писалась первая версия статьи, он не работал. Запустите в консоли Proxmox (pve → Оболочка):

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/vm/openwrt-vm.sh)"

Что делает скрипт:

• сам определяет актуальную стабильную версию OpenWrt и скачивает официальный образ generic-ext4-combined;
• создаёт виртуальную машину, импортирует образ и делает его загрузочным;
• запускает машину и сам набирает в её консоли команды настройки сети: eth0 — LAN со статическим адресом, eth1 — WAN по DHCP;
• подключает первую сетевую карту к мосту LAN, вторую — к мосту WAN, то есть так же, как в нашей схеме.

Выберите Advanced — стандартные настройки для нашей схемы не подходят:

• WAN Bridge = vmbr0, LAN Bridge = vmbr1. По умолчанию оба стоят на vmbr0 — и LAN OpenWrt со своим DHCP окажется в сети старого роутера;
• Router IP — адрес LAN OpenWrt, по умолчанию 192.168.1.1. Если у старого роутера такая же подсеть, укажите другую, например 192.168.2.1;
• Disk Size = 2 (по умолчанию 1 ГБ — этого мало для обновлений через owut с корневым разделом 1024 МБ);
• CPU Cores = 2 и RAM = 512 — по умолчанию 1 ядро и 256 МБ, для роутера с парой пакетов это впритык;
• VLAN и MTU оставьте пустыми, если не знаете, зачем они нужны.

Мои замечания по скрипту:

• Автозапуск включается всегда. Пока не проверили, что всё работает, выключите: qm set 100 --onboot 0 (вместо 100 — ID, который выбрал скрипт).
• Тип процессора не host. Поменяйте: qm set 100 --cpu host, затем перезапустите машину.
• Пароль root не задаётся, корневой раздел не расширяется — диск становится больше, но OpenWrt видит те же 104 МБ. Эти шаги нужно сделать вручную, как описано ниже.
• Скрипт скачивается из интернета и выполняется от root. Проект популярный и открытый, но перед запуском имеет смысл открыть исходный код и посмотреть, что он делает.
• Пока скрипт набирает команды в консоли ВМ, не открывайте эту консоль и ничего в ней не нажимайте — ввод перепутается.
• Скрипт и его компоненты загружаются с GitHub (raw.githubusercontent.com). У части российских провайдеров GitHub открывается с перебоями, и тогда скрипт завершается ошибкой загрузки. В этом случае используйте способ 1 или 2 — они не зависят от GitHub. Если недоступен и downloads.openwrt.org, скачайте образ на компьютер и загрузите его на Proxmox в папку /root через WinSCP или другой SFTP-клиент.

После скрипта переходите к разделу про первый запуск: адрес LAN уже задан, остаются пароль, расширение диска и русификация.

Первый запуск: адрес LAN и пароль

Откройте Консоль виртуальной машины и нажмите Enter.

Если подсеть OpenWrt совпадает с подсетью старого роутера, смените адрес LAN:

# Замените 192.168.2.1 на свой адрес
uci set network.lan.ipaddr='192.168.2.1'
uci set network.lan.netmask='255.255.255.0'
uci commit network
/etc/init.d/network restart

Задайте пароль root — без него OpenWrt пускает в веб-интерфейс и по SSH кого угодно:

passwd

Подключите ноутбук к любому LAN-порту мини-ПК (enp3s0–enp5s0): он получит адрес по DHCP от OpenWrt. Откройте в браузере http://192.168.1.1 (или адрес, который вы задали) и войдите как root. WAN OpenWrt сейчас получает адрес от старого роутера, так что интернет в виртуальной машине уже есть.

Пароль можно сменить и в веб-интерфейсе: Система → Управление → Пароль маршрутизатора. Там же, в Сеть → Интерфейсы → lan → Изменить, меняется адрес LAN — указывайте его вместе с маской, например 192.168.1.1/24.

Расширение диска OpenWrt

Диск виртуальной машины уже 2 ГБ, но корневой раздел OpenWrt по-прежнему занимает около 104 МБ — его нужно расширить на всё свободное место. Подключитесь к OpenWrt по SSH (например, через Tabby: адрес LAN, порт 22, пользователь root) или используйте последовательную консоль Proxmox, где работает вставка.

# Пакеты (OpenWrt 25.12 и новее)
apk update
apk add parted losetup resize2fs

# Расширяем раздел 2 на весь диск
parted -f -s /dev/sda resizepart 2 100%

# Расширяем файловую систему
losetup /dev/loop1 /dev/sda2
resize2fs -f /dev/loop1
reboot

На OpenWrt 24.10 вместо первых двух команд используйте opkg update и opkg install parted losetup resize2fs: пакетный менеджер apk появился только в 25.12. Больше 2 ГБ выделять не стоит — уменьшить диск гораздо сложнее, чем увеличить.

Русский язык в веб-интерфейсе

apk update
apk add luci-i18n-base-ru

Или через веб-интерфейс: System → Software, кнопка Update lists…, в фильтре введите luci-i18n-base-ru и нажмите Install. После установки обновите страницу. Русификация отдельных приложений ставится так же — пакетами luci-i18n-<приложение>-ru.

Перенос Proxmox в локальную сеть и переключение кабеля провайдера

Сейчас Proxmox всё ещё получает адрес от старого роутера через vmbr0. Перенесём его в vmbr1, за OpenWrt. Убедитесь, что резервная копия /etc/network/interfaces.bak сделана, а ноутбук подключён к LAN-порту мини-ПК.

В pve → Система → Сеть откройте vmbr0 и очистите поля IPv4/CIDR и Шлюз.

Откройте vmbr1 и укажите IPv4/CIDR 192.168.1.2/24 и шлюз 192.168.1.1 — адрес OpenWrt. На скриншоте мост называется vmbr99, в нашей схеме это vmbr1.

Нажмите Применить конфигурацию. Связь со старым адресом пропадёт — откройте https://192.168.1.2:8006 с ноутбука, подключённого к LAN-порту. Затем поправьте ещё два места: в Система → DNS укажите 192.168.1.1, а в Система → Хосты замените старый IP в строке с именем сервера на 192.168.1.2.

Теперь можно переключать кабели:

• кабель провайдера — в enp2s0 (WAN). Если провайдер использует PPPoE, в Сеть → Интерфейсы → wan → Изменить выберите протокол PPPoE и введите логин и пароль из договора. Если провайдер привязывает доступ к MAC-адресу, задайте старый MAC в настройках устройства eth1 (Сеть → Интерфейсы → Устройства);
• старый роутер — кабелем из его LAN-порта в LAN-порт мини-ПК. В его настройках отключите DHCP-сервер и задайте ему свободный адрес из новой подсети, например 192.168.1.3. Так он будет работать точкой доступа Wi-Fi;
• остальные устройства — в LAN-порты мини-ПК или в порты старого роутера.

Когда всё работает, включите автозапуск OpenWrt: qm set 100 --onboot 1 или галочка «Запуск при загрузке» в Параметры.

Если потеряли доступ к Proxmox

• OpenWrt выключена или не загружается. Proxmox остаётся доступен через LAN-порты: задайте на ноутбуке статический адрес 192.168.1.10, маска 255.255.255.0, подключитесь к LAN-порту и откройте https://192.168.1.2:8006.
• После изменения сетевых настроек Proxmox не открывается ни по какому адресу. Подключите к мини-ПК монитор и клавиатуру, войдите как root и верните резервную копию командами ниже.
• Сервер зависает при старте виртуальной машины. Чаще всего это проброс PCI-устройства. Выключите автозапуск ВМ (qm set 100 --onboot 0) и уберите проброшенное устройство.

# Вернуть сетевые настройки Proxmox из резервной копии
cp /etc/network/interfaces.bak /etc/network/interfaces
ifreload -a

Обновление OpenWrt в Proxmox

Главное преимущество виртуального роутера — снимки. Перед любым обновлением сделайте снимок виртуальной машины: если что-то сломается, откат займёт секунды. Настройки дополнительно сохраните в Система → Резервное копирование → Создать архив.

Удобнее всего обновляться через owut: он собирает образ новой версии с вашими пакетами и настройками. Параметр --rootfs-size 1024 важен: без него после обновления корневой раздел снова станет 104 МБ. Больше 1024 МБ сервис сборки образов не поддерживает.

# На Proxmox: снимок перед обновлением
qm snapshot 100 pre_upgrade

# В OpenWrt: обновление с сохранением пакетов и настроек
apk update
apk add owut
owut check
owut upgrade --rootfs-size 1024

# Если что-то пошло не так — откат на Proxmox
qm rollback 100 pre_upgrade

Для перехода между крупными версиями (например, с 24.10 на 25.12, где сменился пакетный менеджер) надёжнее создать новую виртуальную машину из свежего образа и восстановить в ней архив настроек, а старую машину пока оставить выключенной как запасную. Подробности — в документации OpenWrt для x86.

Производительность

• Тип процессора host и сетевые карты VirtIO — уже заданы выше, это главное.
• Multiqueue. В настройках каждой сетевой карты ВМ (Оборудование → Сетевое устройство → Дополнительно) укажите Multiqueue равным числу ядер ВМ: трафик будут обрабатывать все ядра, а не одно.
• Проброс сетевой карты (PCI passthrough). Для гигабита и выше WAN-порт можно отдать виртуальной машине целиком. Нужна поддержка IOMMU (VT-d) в BIOS и отдельная IOMMU-группа у порта — подробно в документации Proxmox. Не пробрасывайте порт, через который управляете Proxmox, и не включайте автозапуск, пока не проверите, что машина стартует.

Вариант: отдельный мост на каждый порт

В первой версии статьи каждый физический порт получал свой мост (vmbr1, vmbr2, vmbr3), все они подключались к ВМ отдельными сетевыми картами и объединялись уже в OpenWrt, в мосту br-lan. Так OpenWrt управляет каждым портом по отдельности: можно вынести порт в гостевую сеть или VLAN. Минус — сложнее настройка и выше риск потерять доступ: если Proxmox подключён к мосту без физического порта, при выключенной OpenWrt до него не достучаться. Если выбираете этот вариант, оставьте хотя бы один порт в мосту вместе с Proxmox.

Частые вопросы