Переход с OpenWrt 24.10 на 25.12: что сохранить, что сломается и как обновиться безопасно

Почему переход с 24.10 уже нельзя откладывать бесконечно

OpenWrt официально указывает, что серия 24.10 находится в security maintenance: в неё исправляются только проблемы безопасности. End of Life запланирован на сентябрь 2026 года.

Текущая стабильная ветка — OpenWrt 25.12. На момент подготовки материала актуальным сервисным релизом является 25.12.5.

Главные изменения OpenWrt 25.12

Что обязательно сохранить перед обновлением

1. Backup через LuCI. System → Backup / Flash Firmware → Generate archive.
2. Каталог /etc/config. Это основная UCI-конфигурация сети, firewall, DHCP, Wi‑Fi и сервисов.
3. Список установленных пакетов.
4. Сторонние feeds и repositories.
5. Custom scripts. Например /etc/rc.local, hotplug, cron, watchdog.
6. WireGuard keys и peer-конфигурации.
7. Firewall custom rules.
8. AdGuard Home / mwan3 / SQM / VPN / Docker конфиги.
9. USB/extroot layout.
10. Точный firmware image и recovery-инструкцию для модели.

Полезные команды перед миграцией

sysupgrade -b /tmp/openwrt-backup.tar.gz

uci show > /tmp/uci-full.txt

opkg list-installed > /tmp/packages-24.10.txt

ip addr
ip route
wg show

Backup лучше скачать с роутера на отдельный компьютер до начала обновления.

Какой способ обновления выбрать

Официальные release notes 25.12.5 указывают, что переход с 24.10 на 25.12 должен быть прозрачным на большинстве устройств: конфигурация либо сохраняется, либо конвертируется init-скриптами при первом запуске.

Обычный sysupgrade

Для стандартной установки скачивается sysupgrade-image именно для своей модели и target/subtarget. Перед прошивкой OpenWrt проверяет совместимость образа.

sysupgrade /tmp/openwrt-25.12.x-...-sysupgrade.bin

Флаг сохранения настроек обычно используется по умолчанию при обычном sysupgrade, но для некоторых устройств release notes прямо требуют обновление без сохранения конфигурации.

Attended Sysupgrade: почему в 25.12 он особенно полезен

OpenWrt 25.12 устанавливает LuCI Attended Sysupgrade по умолчанию. ASU может запросить сборку индивидуального firmware image с пакетами, которые уже установлены на устройстве, и сохранить системную конфигурацию.

Это значительно удобнее ручного составления списка пакетов, но всё равно не гарантирует перенос неподдерживаемых сторонних feeds или пакетов, отсутствующих в 25.12.

opkg больше не основной пакетный менеджер

OpenWrt 25.12 и новее используют apk. OpenWrt 24.10 и старее используют opkg.

OpenWrt публикует отдельную официальную opkg-to-apk cheat sheet. Старые инструкции из интернета с opkg update && opkg install для 25.12 уже могут быть неактуальны.

Сторонние пакеты — главный источник сюрпризов

• проверьте наличие пакета в официальном 25.12 repository;
• проверьте, не изменилось ли название;
• не переносите бинарные .ipk из 24.10 в 25.12;
• проверьте сторонний feed на поддержку apk;
• проверьте архитектуру target/subtarget;
• сохраните отдельные конфигурационные файлы пакетов;
• не устанавливайте старые kmod вручную.

WireGuard после миграции

UCI-конфигурация WireGuard обычно сохраняется вместе с network config, но после major upgrade обязательно проверьте:

• WireGuard interface;
• peer public keys;
• AllowedIPs;
• routes;
• firewall zones;
• forwardings;
• DNS через VPN;
• MTU;
• site-to-site connectivity.

После обновления не ограничивайтесь тем, что peer показывает handshake: отдельно проверьте доступ к LAN и интернет через tunnel.

SQM, mwan3 и firewall

SQM доступен в OpenWrt 25.12, но после миграции стоит перепроверить interface name, bandwidth values и flow offloading. Официальная документация SQM предупреждает, что hardware flow offloading несовместим с SQM.

Для mwan3 и других policy-routing решений особенно важно проверить маршруты после первого запуска. Переименование интерфейса или изменение device topology может сломать правила даже при успешно перенесённой UCI-конфигурации.

USB storage, extroot и Docker

Если роутер использует внешний накопитель или extroot, это уже не «обычная» миграция.

Перед major upgrade полезно убедиться, что роутер способен загрузиться в чистую внутреннюю систему без extroot. Это значительно упрощает recovery.

Устройства с особыми условиями перехода

Release notes OpenWrt 25.12.5 перечисляют модели, для которых стандартная схема не подходит.

Переход с 23.05 и старее — это уже другая задача

OpenWrt 25.12.5 прямо предупреждает: sysupgrade с 23.05 или более старых версий на 25.12 официально не поддерживается.

Если устройство давно не обновлялось, безопаснее сначала изучить поддерживаемый промежуточный upgrade path конкретной модели, а не перескакивать сразу через несколько major releases.

План восстановления нужен до прошивки, а не после

• знайте IP failsafe режима;
• проверьте кнопку reset и timing failsafe для своей модели;
• скачайте factory/recovery image заранее;
• изучите TFTP recovery, если производитель его поддерживает;
• имейте Ethernet-кабель и компьютер с ручным IP;
• не делайте major upgrade удалённо без альтернативного доступа.

Что проверить после первого запуска 25.12

1. WAN получил адрес и есть интернет.
2. LAN и DHCP работают.
3. Все SSID поднялись.
4. Firewall zones и forwardings соответствуют старой схеме.
5. WireGuard и другие VPN работают не только по handshake.
6. DNS и локальные имена разрешаются.
7. SQM/mwan3 работают на правильных интерфейсах.
8. USB/extroot/storage монтируются.
9. Сторонние пакеты работают и не сыпят ошибки в logread.
10. Сохраните новый backup уже после успешной миграции.

Что проверить в логах

logread
dmesg
ip addr
ip route
nft list ruleset
wg show
apk list --installed

Если после обновления система «вроде работает», но есть странные сетевые симптомы, сначала ищите ошибки миграции интерфейсов, firewall и отсутствующих пакетов в логах.

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