OpenWrt Full Backup

LuCI web-панель и SSH-утилита для полного бэкапа OpenWrt без сборки .ipk.

OpenWrt LuCI No Lua runtime Install

Зачем нужен модуль

luci-app-owrt-full-backup делает удобную панель в OpenWrt для создания, скачивания, загрузки и восстановления архивов бэкапа. Подходит для обычного сохранения настроек, переноса конфигурации после перепрошивки и подготовки полного архива роутера перед экспериментами.

Important

После установки скрипт покажет приватную ссылку с key=.... Не отдавай ее посторонним: по этой ссылке можно создавать и восстанавливать бэкапы.

Быстрая установка

Зайди на роутер по SSH и выполни:

wget -O - https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/install.sh | sh

После установки открой:

LuCI -> Службы -> OpenWrt Full Backup

Также установщик покажет прямую ссылку:

http://192.168.1.1/cgi-bin/owrt-full-backup?key=SECRET

Что умеет

Возможность Что делает
Веб-панель LuCI Пункт Службы -> OpenWrt Full Backup и отдельная защищенная CGI-панель
Бэкап настроек Создает стандартный sysupgrade backup конфигурации OpenWrt
Список пакетов Сохраняет список установленных пакетов opkg
Overlay snapshot Может добавить /overlay/upper
ROM snapshot Может добавить снимок /rom
Firmware image Может положить в архив готовый sysupgrade.bin
Raw MTD dump Может сохранить /dev/mtd*, если архив пишется на USB/диск
Архивы в веб-панели Скачать, загрузить, посмотреть и удалить архив
Восстановление Отдельные галочки для настроек, пакетов, overlay и firmware
Виджеты роутера Показывает разделы памяти, свободное место и температуру

Как выглядит сценарий работы

  1. Открываешь Службы -> OpenWrt Full Backup.
  2. Выбираешь папку для архива, лучше USB или диск: /mnt/usb.
  3. Нажимаешь Создать бэкап.
  4. На странице виден журнал выполнения и таймер.
  5. После завершения архив появляется в списке.
  6. Архив можно скачать, удалить, загрузить обратно или восстановить.

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

/tmp в OpenWrt обычно находится в RAM. Для маленького бэкапа настроек этого может хватить, но для больших архивов лучше сразу использовать USB/диск.

Рекомендуемый путь:

/mnt/usb

Warning

Raw MTD dump может быть очень большим и привязан к конкретной модели роутера. Модуль не дает сохранять raw MTD в /tmp, чтобы не забить RAM и не получить No space left on device.

CLI-команды

Создать бэкап на USB:

owrt-full-backup create -o /mnt/usb

Добавить firmware image:

owrt-full-backup create -o /mnt/usb --firmware-image /tmp/openwrt-sysupgrade.bin

Посмотреть архив:

owrt-full-backup inspect /mnt/usb/router-owrt-full-backup.tar.gz

Восстановить только настройки:

owrt-full-backup restore /mnt/usb/router-owrt-full-backup.tar.gz --yes --no-packages

Что ставится на роутер

Путь Назначение
/usr/sbin/owrt-full-backup Основная CLI-команда
/usr/sbin/owrt-full-backup-upload Потоковая загрузка .tar.gz из браузера без Lua
/www/cgi-bin/owrt-full-backup Основная веб-панель
/www/luci-static/resources/view/owrt_full_backup.js LuCI-страница-редирект без Lua runtime
/usr/share/luci/menu.d/luci-app-owrt-full-backup.json Пункт меню LuCI
/usr/share/rpcd/acl.d/luci-app-owrt-full-backup.json ACL-доступ LuCI к приватному ключу
/etc/config/fullbackup Настройки по умолчанию
/etc/owrt-full-backup/web.key Приватный ключ веб-панели

Структура проекта

.
├── install.sh
├── uninstall.sh
├── README.md
├── LICENSE
└── files
    ├── etc
    │   └── config
    │       └── fullbackup
    ├── usr
    │   ├── sbin
    │   │   ├── owrt-full-backup
    │   │   └── owrt-full-backup-upload
    │   └── share
    │       ├── luci
    │       │   └── menu.d
    │       │       └── luci-app-owrt-full-backup.json
    │       └── rpcd
    │           └── acl.d
    │               └── luci-app-owrt-full-backup.json
    └── www
        ├── cgi-bin
        │   └── owrt-full-backup
        └── luci-static
            └── resources
                └── view
                    └── owrt_full_backup.js

Обновление

Принудительно поставить свежую версию с GitHub:

wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/install.sh?v=$(date +%s)" | sh

Скрипт обновляет файлы, удаляет старый Lua-controller, чистит кэш LuCI и перезапускает rpcd/uhttpd.

Удаление

Удалить модуль, но оставить конфиг и веб-ключ:

wget -O - https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/uninstall.sh | sh

Удалить модуль, конфиг и веб-ключ:

wget -O - https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/uninstall.sh | PURGE=1 sh

Архивы бэкапов при удалении не стираются.

Диагностика

Пункт не появился в LuCI

Обнови модуль и перезапусти кэш LuCI:

wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/install.sh?v=$(date +%s)" | sh
rm -rf /tmp/luci-indexcache /tmp/luci-modulecache /tmp/luci-indexcache.* /tmp/luci-modulecache.*
/etc/init.d/rpcd restart
/etc/init.d/uhttpd restart

Потом обнови страницу LuCI или выйди и зайди снова.

В LuCI ошибка `No Lua runtime installed`

Поставь свежую версию. Модуль больше не использует Lua-controller для пункта меню LuCI.

wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/install.sh?v=$(date +%s)" | sh

Проверка:

test ! -e /usr/lib/lua/luci/controller/owrt_full_backup.lua && echo "Lua controller удален"
Ошибка `No space left on device`

Архив создается в /tmp, а там закончилась RAM. Используй USB/диск:

mkdir -p /mnt/usb
owrt-full-backup create -o /mnt/usb

В веб-панели тоже укажи /mnt/usb.

Браузер пишет `ERR_CONNECTION_RESET` при загрузке архива

Обнови модуль. Загрузка архива идет потоково и не держит весь .tar.gz в памяти.

Если ошибка осталась, проверь свободное место в папке архива и используй USB/диск:

/mnt/usb

Автор

Проект: luci-app-owrt-full-backup

Автор: byzks95 / kzolotarev95

Связь: Telegram

S
Description
No description provided
Readme MIT
8.9 MiB
0 Stars 1 Watchers 0 Forks
Languages
Python 70.3%
PowerShell 11.8%
Shell 11.6%
JavaScript 6.2%