Зачем нужен модуль
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 |
| Виджеты роутера | Показывает разделы памяти, свободное место и температуру |
Как выглядит сценарий работы
- Открываешь
Службы -> OpenWrt Full Backup. - Выбираешь папку для архива, лучше USB или диск:
/mnt/usb. - Нажимаешь
Создать бэкап. - На странице виден журнал выполнения и таймер.
- После завершения архив появляется в списке.
- Архив можно скачать, удалить, загрузить обратно или восстановить.
Безопасное место для архива
/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