201 lines
7.9 KiB
Markdown
201 lines
7.9 KiB
Markdown
# luci-app-owrt-full-backup
|
|
|
|

|
|

|
|

|
|
|
|
Веб-панель и CLI-утилита для полного бэкапа OpenWrt. Сборка `.ipk` не нужна: модуль ставится прямо с GitHub на роутер.
|
|
|
|
## Что умеет
|
|
|
|
- Создает архив бэкапа через веб-панель LuCI или через SSH.
|
|
- Сохраняет настройки OpenWrt через `sysupgrade -b`.
|
|
- Сохраняет список установленных пакетов `opkg`.
|
|
- Может добавить снимок `/overlay/upper`.
|
|
- Может добавить снимок `/rom`.
|
|
- Может добавить firmware image, если файл прошивки уже лежит на роутере.
|
|
- Может добавить raw MTD dump для полного дампа flash-разделов.
|
|
- Показывает состояние памяти и температуру роутера.
|
|
- Позволяет скачать, загрузить, посмотреть и удалить архив из веб-панели.
|
|
- Позволяет восстановить настройки, пакеты, overlay или firmware image отдельными галочками.
|
|
|
|
## Быстрая установка
|
|
|
|
Зайди на роутер по SSH и выполни:
|
|
|
|
```sh
|
|
wget -O - https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/install.sh | sh
|
|
```
|
|
|
|
После установки скрипт покажет приватную ссылку:
|
|
|
|
```text
|
|
Открыть: http://192.168.1.1/cgi-bin/owrt-full-backup?key=SECRET
|
|
```
|
|
|
|
Эту ссылку держи в секрете: ключ в URL дает доступ к созданию и восстановлению бэкапов.
|
|
|
|
Пункт в LuCI:
|
|
|
|
```text
|
|
Службы -> OpenWrt Full Backup
|
|
```
|
|
|
|
## Обновление
|
|
|
|
Если нужно принудительно поставить свежую версию с GitHub:
|
|
|
|
```sh
|
|
wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/install.sh?v=$(date +%s)" | sh
|
|
```
|
|
|
|
Скрипт сам обновляет файлы, чистит кэш LuCI и перезапускает нужные службы.
|
|
|
|
## Структура проекта
|
|
|
|
```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
|
|
```
|
|
|
|
## Что ставится на роутер
|
|
|
|
| Путь | Назначение |
|
|
| --- | --- |
|
|
| `/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` | Приватный ключ веб-панели |
|
|
|
|
## Как делать бэкап
|
|
|
|
Через веб-панель:
|
|
|
|
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
|
|
owrt-full-backup inspect /mnt/usb/router-owrt-full-backup.tar.gz
|
|
```
|
|
|
|
Восстановить только настройки:
|
|
|
|
```sh
|
|
owrt-full-backup restore /mnt/usb/router-owrt-full-backup.tar.gz --yes --no-packages
|
|
```
|
|
|
|
В веб-панели восстановление запускается только после ввода `RESTORE`. Это защита от случайного клика.
|
|
|
|
## Если пункт не появился в LuCI
|
|
|
|
Сначала обнови модуль свежей командой:
|
|
|
|
```sh
|
|
wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/install.sh?v=$(date +%s)" | sh
|
|
```
|
|
|
|
Если в меню все еще не видно:
|
|
|
|
```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)
|