8.0 KiB
luci-app-owrt-full-backup
Веб-панель и CLI-утилита для полного бэкапа OpenWrt. Сборка .ipk не нужна: модуль ставится прямо с GitHub на роутер.
Автор: byzks95 / kzolotarev95
Telegram: t.me/kzolotarev95
Что умеет
- Создает архив бэкапа через веб-панель LuCI или через SSH.
- Сохраняет настройки OpenWrt через
sysupgrade -b. - Сохраняет список установленных пакетов
opkg. - Может добавить снимок
/overlay/upper. - Может добавить снимок
/rom. - Может добавить firmware image, если файл прошивки уже лежит на роутере.
- Может добавить raw MTD dump для полного дампа flash-разделов.
- Показывает состояние памяти и температуру роутера.
- Позволяет скачать, загрузить, посмотреть и удалить архив из веб-панели.
- Позволяет восстановить настройки, пакеты, overlay или firmware image отдельными галочками.
Быстрая установка
Зайди на роутер по SSH и выполни:
wget -O - https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/install.sh | sh
После установки скрипт покажет приватную ссылку:
Открыть: http://192.168.1.1/cgi-bin/owrt-full-backup?key=SECRET
Эту ссылку держи в секрете: ключ в URL дает доступ к созданию и восстановлению бэкапов.
Пункт в LuCI:
Службы -> OpenWrt Full Backup
Обновление
Если нужно принудительно поставить свежую версию с GitHub:
wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-full-backup/main/install.sh?v=$(date +%s)" | sh
Скрипт сам обновляет файлы, чистит кэш LuCI и перезапускает нужные службы.
Структура проекта
.
├── 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 |
Приватный ключ веб-панели |
Как делать бэкап
Через веб-панель:
- Открой
Службы -> OpenWrt Full Backup. - Выбери папку для архива.
- Нажми
Создать бэкап. - Следи за журналом выполнения на странице.
- После завершения архив появится в списке ниже.
Через SSH:
owrt-full-backup create -o /mnt/usb
Если нужен firmware image:
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 лучше сразу использовать флешку или диск:
/mnt/usb
Raw MTD dump может быть очень большим и привязан к конкретной модели, разметке flash и загрузчику. Не сохраняй raw MTD в /tmp: модуль теперь сразу остановит такую попытку понятной ошибкой.
Восстановление
Посмотреть архив:
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
В веб-панели восстановление запускается только после ввода RESTORE. Это защита от случайного клика.
Если пункт не появился в 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 и зайди снова. Прямая приватная ссылка из вывода install.sh тоже всегда работает.
Если ошибка No space left on device
Причина почти всегда одна: архив создается в /tmp, а там RAM закончилась.
Что сделать:
mkdir -p /mnt/usb
owrt-full-backup create -o /mnt/usb
В веб-панели укажи папку /mnt/usb. Для raw MTD dump это обязательно.
Если при загрузке архива браузер пишет ERR_CONNECTION_RESET
Обнови модуль. Загрузка архива теперь идет потоково: файл пишется сразу на диск, а не целиком в память.
Если ошибка осталась, проверь свободное место в папке для архивов и ставь папку на USB/диск, например /mnt/usb.
Удаление
Удалить модуль, но оставить конфиг и ключ:
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
Архивы бэкапов при удалении не стираются.
Поддержка
- GitHub: github.com/kzolotarev95
- Telegram: t.me/kzolotarev95