2026-06-28 22:27:49 +04:00
2026-06-28 16:45:20 +04:00
2026-06-28 16:09:05 +04:00
2026-06-28 22:27:49 +04:00

luci-app-owrt-full-backup

OpenWrt LuCI Install

Веб-панель и CLI-утилита для полного бэкапа OpenWrt. Сборка .ipk не нужна: модуль ставится прямо с GitHub на роутер.

Что умеет

  • Создает архив бэкапа через веб-панель 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 Приватный ключ веб-панели

Как делать бэкап

Через веб-панель:

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

Через 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

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

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%