Веб-панель для полного бэкапа OpenWrt без сборки IPK. Держи эту ссылку в секрете.
-Raw MTD сохраняй только на USB/диск, например /mnt/usb. В /tmp обычно не хватит места.
diff --git a/.gitattributes b/.gitattributes index bb73904..e844d67 100644 --- a/.gitattributes +++ b/.gitattributes @@ -13,3 +13,4 @@ files/usr/sbin/owrt-full-backup-upload text eol=lf files/etc/config/fullbackup text eol=lf files/www/cgi-bin/owrt-full-backup text eol=lf files/usr/lib/lua/luci/controller/owrt_full_backup.lua text eol=lf +files/usr/share/luci/menu.d/luci-app-owrt-full-backup.json text eol=lf diff --git a/README.md b/README.md index 4b0f12b..75645c5 100644 --- a/README.md +++ b/README.md @@ -1,108 +1,136 @@ # luci-app-owrt-full-backup -Веб-панель для полного бэкапа и восстановления OpenWrt. Сборка `.ipk` не нужна: установка идет напрямую из GitHub на роутер. + + + -Поддержка: 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) diff --git a/files/usr/sbin/owrt-full-backup b/files/usr/sbin/owrt-full-backup index 1b4af8f..5aac8d2 100644 --- a/files/usr/sbin/owrt-full-backup +++ b/files/usr/sbin/owrt-full-backup @@ -62,7 +62,8 @@ need_cmd() { make_workdir() { local base - base="${TMPDIR:-/tmp}" + base="${1:-${TMPDIR:-/tmp}}" + [ -d "$base" ] || base="${TMPDIR:-/tmp}" WORKDIR="$(mktemp -d "$base/owrt-full-backup.XXXXXX" 2>/dev/null || true)" if [ -z "$WORKDIR" ] || [ ! -d "$WORKDIR" ]; then WORKDIR="$base/owrt-full-backup.$$" @@ -70,6 +71,24 @@ make_workdir() { fi } +abs_path() { + local path + path="$1" + if command -v readlink >/dev/null 2>&1; then + readlink -f "$path" 2>/dev/null && return + fi + (cd "$path" 2>/dev/null && pwd -P) || printf '%s\n' "$path" +} + +is_tmp_path() { + local path + path="$(abs_path "$1")" + case "$path" in + /tmp|/tmp/*) return 0 ;; + *) return 1 ;; + esac +} + uci_get() { local key default value key="$1" @@ -269,7 +288,7 @@ copy_firmware_image() { } dump_raw_mtd() { - local raw line dev name safe + local raw line dev name safe out if [ ! -r /proc/mtd ]; then warn "/proc/mtd недоступен; raw MTD dump пропущен" return @@ -287,7 +306,13 @@ dump_raw_mtd() { safe="$(sanitize "$name")" if [ -e "/dev/$dev" ]; then log "Сохраняю /dev/$dev ($name)" - dd if="/dev/$dev" of="$raw/$dev-$safe.bin" bs=64k 2>"$raw/$dev-$safe.dd.log" || warn "не удалось сохранить /dev/$dev" + out="$raw/$dev-$safe.bin" + if dd if="/dev/$dev" of="$out" bs=64k 2>"$raw/$dev-$safe.dd.log"; then + : + else + rm -f "$out" + warn "не удалось сохранить /dev/$dev" + fi fi ;; esac @@ -366,7 +391,10 @@ cmd_create() { need_cmd tar need_cmd gzip mkdir -p "$output_dir" || die "не удалось создать папку для архива: $output_dir" - make_workdir + if [ "$include_raw_mtd" = "1" ] && is_tmp_path "$output_dir"; then + die "raw MTD dump нельзя сохранять в /tmp: там обычно мало RAM. Укажи USB/диск, например /mnt/usb, или отключи raw MTD dump." + fi + make_workdir "$output_dir" timestamp="$(date '+%Y%m%d-%H%M%S' 2>/dev/null || date '+%s')" host="$(hostname_safe)" diff --git a/files/usr/sbin/owrt-full-backup-upload b/files/usr/sbin/owrt-full-backup-upload index c8c41fb..8403e00 100644 --- a/files/usr/sbin/owrt-full-backup-upload +++ b/files/usr/sbin/owrt-full-backup-upload @@ -3,8 +3,17 @@ local default_dir = arg[1] or "/tmp" local content_type = os.getenv("CONTENT_TYPE") or "" local content_length = tonumber(os.getenv("CONTENT_LENGTH") or "0") or 0 +local pending = "" +local target_tmp = nil + +local function cleanup() + if target_tmp then + os.remove(target_tmp) + end +end local function fail(message) + cleanup() io.stderr:write("ОШИБКА: " .. message .. "\n") os.exit(1) end @@ -28,6 +37,37 @@ local function safe_filename(name) return name end +local function trim_crlf(line) + return tostring(line or ""):gsub("\r\n$", ""):gsub("\n$", "") +end + +local function read_from_stdin(size) + return io.stdin:read(size or 8192) +end + +local function read_line() + while true do + local pos = pending:find("\n", 1, true) + if pos then + local line = pending:sub(1, pos) + pending = pending:sub(pos + 1) + return line + end + + local chunk = read_from_stdin(1024) + if not chunk or #chunk == 0 then + if #pending > 0 then + local line = pending + pending = "" + return line + end + return nil + end + + pending = pending .. chunk + end +end + local boundary = content_type:match('boundary="?([^";]+)"?') if not boundary or boundary == "" then fail("multipart boundary не найден") @@ -37,83 +77,163 @@ if content_length <= 0 then fail("пустой upload") end -local body = io.stdin:read(content_length) -if not body or #body ~= content_length then - fail("не удалось прочитать upload полностью") +local marker = "--" .. boundary +local delimiter = "\r\n" .. marker + +local first_line = trim_crlf(read_line()) +if first_line ~= marker then + fail("multipart boundary не найден в теле запроса") +end + +local function read_headers() + local headers = {} + + while true do + local line = read_line() + if not line then + fail("не удалось прочитать заголовки upload") + end + + line = trim_crlf(line) + if line == "" then + break + end + + headers[#headers + 1] = line + end + + return table.concat(headers, "\n") +end + +local function read_part(out, max_text) + local keep = #delimiter + 4 + local buffer = "" + local text = {} + local text_size = 0 + local part_size = 0 + + local function consume(data) + if not data or #data == 0 then + return + end + + part_size = part_size + #data + if out then + local wrote, err = out:write(data) + if not wrote then + fail("не удалось записать upload: " .. tostring(err)) + end + return + end + + text_size = text_size + #data + if text_size > (max_text or 4096) then + fail("поле формы слишком большое") + end + text[#text + 1] = data + end + + while true do + local chunk + if #pending > 0 then + chunk = pending + pending = "" + else + chunk = read_from_stdin(8192) + end + + if not chunk then + fail("не найден конец multipart upload") + end + + buffer = buffer .. chunk + local start_pos, end_pos = buffer:find(delimiter, 1, true) + if start_pos then + consume(buffer:sub(1, start_pos - 1)) + + local after = end_pos + 1 + local final = false + if buffer:sub(after, after + 1) == "--" then + final = true + after = after + 2 + end + if buffer:sub(after, after + 1) == "\r\n" then + after = after + 2 + end + + pending = buffer:sub(after) + return final, table.concat(text), part_size + end + + if #buffer > keep then + consume(buffer:sub(1, #buffer - keep)) + buffer = buffer:sub(#buffer - keep + 1) + end + end end local upload_dir = default_dir -local file_name -local file_data -local marker = "--" .. boundary -local pos = 1 +local saved_path = nil +local saved_size = 0 +local final = false -while true do - local boundary_start, boundary_end = body:find(marker, pos, true) - if not boundary_start then - break - end +while not final do + local headers = read_headers() + local disposition = headers:match("[Cc]ontent%-[Dd]isposition:%s*([^\n]+)") + local name = disposition and disposition:match('name="([^"]+)"') + local filename = disposition and disposition:match('filename="([^"]*)"') - local after = boundary_end + 1 - if body:sub(after, after + 1) == "--" then - break - end - if body:sub(after, after + 1) == "\r\n" then - after = after + 2 - end - - local header_end = body:find("\r\n\r\n", after, true) - if not header_end then - break - end - - local headers = body:sub(after, header_end - 1) - local data_start = header_end + 4 - local next_boundary = body:find("\r\n" .. marker, data_start, true) - if not next_boundary then - break - end - - local data = body:sub(data_start, next_boundary - 1) - local name = headers:match('name="([^"]+)"') - local filename = headers:match('filename="([^"]*)"') - - if name == "upload_dir" and filename == nil then - upload_dir = data:gsub("[%z\r\n]", "") + if name == "upload_dir" and not filename then + local value + final, value = read_part(nil, 4096) + upload_dir = tostring(value or ""):gsub("[%z\r\n]", "") elseif name == "archive" and filename and filename ~= "" then - file_name = safe_filename(filename) - file_data = data + if not valid_path(upload_dir) then + fail("неверная папка для загрузки: " .. tostring(upload_dir)) + end + + local file_name = safe_filename(filename) + if file_name == "" then + fail("файл архива не выбран") + end + if not file_name:match("%.tar%.gz$") then + fail("можно загружать только архивы .tar.gz") + end + + os.execute("mkdir -p " .. shell_quote(upload_dir)) + + local target = upload_dir:gsub("/+$", "") .. "/" .. file_name + target_tmp = target .. ".uploading." .. tostring(os.time()) .. "." .. tostring(content_length) + local out, err = io.open(target_tmp, "wb") + if not out then + fail("не удалось открыть файл для записи: " .. target .. ": " .. tostring(err)) + end + + local _ + final, _, saved_size = read_part(out, 0) + local closed, close_err = out:close() + if not closed then + fail("не удалось закрыть файл: " .. target .. ": " .. tostring(close_err)) + end + if saved_size <= 0 then + fail("файл пустой") + end + + local renamed, rename_err = os.rename(target_tmp, target) + if not renamed then + fail("не удалось сохранить файл: " .. target .. ": " .. tostring(rename_err)) + end + + target_tmp = nil + saved_path = target + else + final = read_part(nil, 1024) end - - pos = next_boundary + 2 end -if not valid_path(upload_dir) then - fail("неверная папка для загрузки: " .. tostring(upload_dir)) -end - -if not file_name or file_name == "" then +if not saved_path then fail("файл архива не выбран") end -if not file_name:match("%.tar%.gz$") then - fail("можно загружать только архивы .tar.gz") -end - -if not file_data or #file_data == 0 then - fail("файл пустой") -end - -os.execute("mkdir -p " .. shell_quote(upload_dir)) - -local target = upload_dir:gsub("/+$", "") .. "/" .. file_name -local out = io.open(target, "wb") -if not out then - fail("не удалось открыть файл для записи: " .. target) -end - -out:write(file_data) -out:close() - -ok("Архив загружен: " .. target) -ok("Размер: " .. tostring(#file_data) .. " байт") +ok("Архив загружен: " .. saved_path) +ok("Размер: " .. tostring(saved_size) .. " байт") diff --git a/files/usr/share/luci/menu.d/luci-app-owrt-full-backup.json b/files/usr/share/luci/menu.d/luci-app-owrt-full-backup.json new file mode 100644 index 0000000..ff3ff44 --- /dev/null +++ b/files/usr/share/luci/menu.d/luci-app-owrt-full-backup.json @@ -0,0 +1,16 @@ +{ + "admin/services/owrt-full-backup": { + "title": "OpenWrt Full Backup", + "order": 90, + "action": { + "type": "call", + "module": "luci.controller.owrt_full_backup", + "function": "action_open" + }, + "depends": { + "fs": { + "/www/cgi-bin/owrt-full-backup": "executable" + } + } + } +} diff --git a/files/www/cgi-bin/owrt-full-backup b/files/www/cgi-bin/owrt-full-backup index f352ed2..ec97d4a 100644 --- a/files/www/cgi-bin/owrt-full-backup +++ b/files/www/cgi-bin/owrt-full-backup @@ -658,11 +658,19 @@ p { margin: 6px 0; color: var(--muted); } .hero { padding: 16px 18px; } .hero h1 { font-size: 24px; line-height: 1.15; } .hero p { max-width: 680px; margin-top: 8px; } -.title-row { display: flex; align-items: center; flex-wrap: wrap; gap: 12px; } -.title-row .button { min-height: 34px; } +.hero-top { display: flex; align-items: center; justify-content: space-between; gap: 14px; flex-wrap: wrap; } +.brand-block { display: flex; align-items: center; gap: 12px; min-width: 0; } +.brand-logo { min-width: 74px; min-height: 34px; border-radius: 7px; background: linear-gradient(135deg, var(--accent), var(--accent-hover)); color: var(--button-text); display: inline-flex; align-items: center; justify-content: center; font-weight: 800; letter-spacing: .2px; } +.brand-text { min-width: 0; } +.brand-links { display: flex; flex-wrap: wrap; gap: 9px; margin-top: 5px; } +.brand-links a { color: var(--accent); font-weight: 700; text-decoration: none; } +.brand-links a:hover { color: var(--accent-hover); text-decoration: underline; } +.hero-top .button { min-height: 34px; } .hero .pill { background: rgba(127,127,127,.08); color: var(--text); } .hot-text { color: var(--hot); } .warn-text { color: var(--warn); } +.hint { font-size: 12px; color: var(--muted); margin-top: 8px; } +.warn-hint { color: var(--warn); } .grid { display: grid; gap: 14px; grid-template-columns: repeat(12, 1fr); } .panel { background: var(--panel); border: 1px solid var(--line); border-radius: 8px; padding: 14px; } .span4 { grid-column: span 4; } @@ -716,19 +724,26 @@ td, th { border-bottom: 1px solid var(--line); padding: 8px 6px; text-align: lef .section-head { display: flex; align-items: flex-start; justify-content: space-between; gap: 12px; } .status { display: flex; flex-wrap: wrap; gap: 8px; } .pill { border: 1px solid var(--line); border-radius: 999px; padding: 5px 9px; color: var(--muted); } -@media (max-width: 820px) { .span4, .span6, .span8, .span12 { grid-column: 1 / -1; } main { padding: 12px; } .section-head { flex-direction: column; } .settings-tools { grid-template-columns: 1fr; } } +@media (max-width: 820px) { .span4, .span6, .span8, .span12 { grid-column: 1 / -1; } main { padding: 12px; } .section-head, .hero-top { flex-direction: column; align-items: flex-start; } .settings-tools { grid-template-columns: 1fr; } }
Веб-панель для полного бэкапа OpenWrt без сборки IPK. Держи эту ссылку в секрете.
-Raw MTD сохраняй только на USB/диск, например /mnt/usb. В /tmp обычно не хватит места.