Improve LuCI menu backup safety and docs

This commit is contained in:
kzolotarev95 committed 2026-06-28 22:18:02 +04:00
1 parent 4cfde2131a
commit d5edec65b1
8 files changed
+408 -143

No files matched your search

+137 -63
View File
@@ -1,108 +1,136 @@
# luci-app-owrt-full-backup
Веб-панель для полного бэкапа и восстановления OpenWrt. Сборка `.ipk` не нужна: установка идет напрямую из GitHub на роутер.
![OpenWrt](https://img.shields.io/badge/OpenWrt-22--25-00A3E0?style=for-the-badge)
![LuCI](https://img.shields.io/badge/LuCI-web%20panel-16A34A?style=for-the-badge)
![Install](https://img.shields.io/badge/install-without%20ipk-111827?style=for-the-badge)
Поддержка: OpenWrt 22.x, 23.x, 24.x и 25.x.
Веб-панель и CLI-утилита для полного бэкапа OpenWrt. Сборка `.ipk` не нужна: модуль ставится прямо с GitHub на роутер.
## Что устанавливается
Автор: [byzks95 / kzolotarev95](https://github.com/kzolotarev95)
- `/usr/sbin/owrt-full-backup` - консольная команда;
- `/usr/sbin/owrt-full-backup-upload` - загрузка архивов из веб-панели;
- `/www/cgi-bin/owrt-full-backup` - веб-панель;
- `/usr/lib/lua/luci/controller/owrt_full_backup.lua` - пункт меню LuCI;
- `/etc/config/fullbackup` - настройки по умолчанию;
- `/etc/owrt-full-backup/web.key` - секретный ключ для входа в панель.
Telegram: [t.me/kzolotarev95](https://t.me/kzolotarev95)
## Установка
## Что умеет
Через `git`:
- Создает архив бэкапа через веб-панель LuCI или через SSH.
- Сохраняет настройки OpenWrt через `sysupgrade -b`.
- Сохраняет список установленных пакетов `opkg`.
- Может добавить снимок `/overlay/upper`.
- Может добавить снимок `/rom`.
- Может добавить firmware image, если файл прошивки уже лежит на роутере.
- Может добавить raw MTD dump для полного дампа flash-разделов.
- Показывает состояние памяти и температуру роутера.
- Позволяет скачать, загрузить, посмотреть и удалить архив из веб-панели.
- Позволяет восстановить настройки, пакеты, overlay или firmware image отдельными галочками.
```sh
git clone https://github.com/kzolotarev95/luci-app-owrt-full-backup.git
cd luci-app-owrt-full-backup
sh install.sh
```
## Быстрая установка
Установка одной командой:
Зайди на роутер по SSH и выполни:
```sh
wget -O - https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/install.sh | sh
```
Если GitHub или браузер отдал старую версию, принудительно обнови с cache-bust:
```sh
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
/etc/init.d/uhttpd restart
```
После установки скрипт покажет приватную ссылку:
```text
http://192.168.1.1/cgi-bin/owrt-full-backup?key=SECRET
Открыть: http://192.168.1.1/cgi-bin/owrt-full-backup?key=SECRET
```
Эту ссылку никому не отдавай: ключ в URL дает доступ к созданию и восстановлению бэкапов.
Эту ссылку держи в секрете: ключ в URL дает доступ к созданию и восстановлению бэкапов.
Также появится пункт меню LuCI:
Пункт в LuCI:
```text
Службы -> OpenWrt Full Backup
```
Если пункт не появился сразу, обнови страницу LuCI или выйди и зайди снова.
## Обновление
## Возможности веб-панели
- создать полный архив бэкапа;
- загрузить архив бэкапа с компьютера на роутер;
- скачать готовый архив;
- посмотреть содержимое/метаданные архива;
- восстановить настройки;
- отдельно включить восстановление списка пакетов;
- отдельно включить восстановление overlay;
- отдельно прошить firmware image из архива;
- сохранить настройки по умолчанию.
По умолчанию восстановление из веб-панели возвращает только настройки. Пакеты, overlay и прошивка включаются отдельными галочками.
## Удаление
Если репозиторий уже скачан:
Если нужно принудительно поставить свежую версию с GitHub:
```sh
sh uninstall.sh
wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/install.sh?v=$(date +%s)" | sh
```
Удаление одной командой:
Скрипт сам обновляет файлы, чистит кэш LuCI и перезапускает нужные службы.
```sh
wget -O - https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/uninstall.sh | sh
## Структура проекта
```text
.
├── install.sh
├── uninstall.sh
├── README.md
├── LICENSE
└── files
├── etc
│ └── config
│ └── fullbackup
├── usr
│ ├── sbin
│ │ ├── owrt-full-backup
│ │ └── owrt-full-backup-upload
│ ├── lib
│ │ └── lua
│ │ └── luci
│ │ └── controller
│ │ └── owrt_full_backup.lua
│ └── share
│ └── luci
│ └── menu.d
│ └── luci-app-owrt-full-backup.json
└── www
└── cgi-bin
└── owrt-full-backup
```
Удалить еще и конфиг с веб-ключом:
## Что ставится на роутер
```sh
wget -O - https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/uninstall.sh | PURGE=1 sh
```
| Путь | Назначение |
| --- | --- |
| `/usr/sbin/owrt-full-backup` | CLI-команда для создания, просмотра и восстановления архива |
| `/usr/sbin/owrt-full-backup-upload` | Потоковая загрузка `.tar.gz` из браузера без удержания всего файла в RAM |
| `/www/cgi-bin/owrt-full-backup` | Веб-панель |
| `/usr/lib/lua/luci/controller/owrt_full_backup.lua` | Редирект из LuCI в веб-панель с приватным ключом |
| `/usr/share/luci/menu.d/luci-app-owrt-full-backup.json` | Пункт меню LuCI для OpenWrt 22-25 |
| `/etc/config/fullbackup` | Настройки по умолчанию |
| `/etc/owrt-full-backup/web.key` | Приватный ключ веб-панели |
Архивы бэкапов при удалении не стираются.
## Как делать бэкап
## Примеры CLI
Через веб-панель:
Создать бэкап на USB:
1. Открой `Службы -> OpenWrt Full Backup`.
2. Выбери папку для архива.
3. Нажми `Создать бэкап`.
4. Следи за журналом выполнения на странице.
5. После завершения архив появится в списке ниже.
Через SSH:
```sh
owrt-full-backup create -o /mnt/usb
```
Добавить в архив файл прошивки, если он уже лежит на роутере:
Если нужен firmware image:
```sh
owrt-full-backup create -o /mnt/usb --firmware-image /tmp/openwrt-sysupgrade.bin
```
## Важное про `/tmp`, USB и raw MTD
`/tmp` в OpenWrt обычно находится в RAM. Для маленького бэкапа настроек этого хватает, но для ROM snapshot, firmware image или raw MTD dump лучше сразу использовать флешку или диск:
```text
/mnt/usb
```
Raw MTD dump может быть очень большим и привязан к конкретной модели, разметке flash и загрузчику. Не сохраняй raw MTD в `/tmp`: модуль теперь сразу остановит такую попытку понятной ошибкой.
## Восстановление
Посмотреть архив:
```sh
@@ -115,16 +143,62 @@ 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
```
## Почему раньше был 404
В веб-панели восстановление запускается только после ввода `RESTORE`. Это защита от случайного клика.
Старая команда ссылалась на другой репозиторий:
## Если пункт не появился в LuCI
Сначала обнови модуль свежей командой:
```sh
https://raw.githubusercontent.com/kzolotarev95/openwrt-full-backup/main/install.sh
wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/install.sh?v=$(date +%s)" | sh
```
Правильный адрес для этого проекта:
Если в меню все еще не видно:
```sh
https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/install.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 и зайди снова. Прямая приватная ссылка из вывода `install.sh` тоже всегда работает.
## Если ошибка `No space left on device`
Причина почти всегда одна: архив создается в `/tmp`, а там RAM закончилась.
Что сделать:
```sh
mkdir -p /mnt/usb
owrt-full-backup create -o /mnt/usb
```
В веб-панели укажи папку `/mnt/usb`. Для raw MTD dump это обязательно.
## Если при загрузке архива браузер пишет `ERR_CONNECTION_RESET`
Обнови модуль. Загрузка архива теперь идет потоково: файл пишется сразу на диск, а не целиком в память.
Если ошибка осталась, проверь свободное место в папке для архивов и ставь папку на USB/диск, например `/mnt/usb`.
## Удаление
Удалить модуль, но оставить конфиг и ключ:
```sh
wget -O - https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/uninstall.sh | sh
```
Удалить модуль, конфиг и веб-ключ:
```sh
wget -O - https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/uninstall.sh | PURGE=1 sh
```
Архивы бэкапов при удалении не стираются.
## Поддержка
- GitHub: [github.com/kzolotarev95](https://github.com/kzolotarev95)
- Telegram: [t.me/kzolotarev95](https://t.me/kzolotarev95)