Add direct web panel installer
This commit is contained in:
1 parent
04aa336add
commit
59979e9dba
9 files changed
+704
-108
No files matched your search
+5
-2
@@ -6,5 +6,8 @@
|
||||
.gitignore text eol=lf
|
||||
LICENSE text eol=lf
|
||||
Makefile text eol=lf
|
||||
package/openwrt-full-backup/files/usr/sbin/owrt-full-backup text eol=lf
|
||||
package/openwrt-full-backup/files/etc/config/fullbackup text eol=lf
|
||||
install.sh text eol=lf
|
||||
uninstall.sh text eol=lf
|
||||
files/usr/sbin/owrt-full-backup text eol=lf
|
||||
files/etc/config/fullbackup text eol=lf
|
||||
files/www/cgi-bin/owrt-full-backup text eol=lf
|
||||
@@ -1,6 +1,7 @@
|
||||
*.ipk
|
||||
*.tar.gz
|
||||
*.tar.gz.sha256
|
||||
.test-output/
|
||||
build_dir/
|
||||
bin/
|
||||
dl/
|
||||
|
||||
@@ -1,101 +1,97 @@
|
||||
# openwrt-full-backup
|
||||
# OpenWrt Full Backup Web
|
||||
|
||||
OpenWrt package overlay for creating and restoring a single backup archive with:
|
||||
Direct web panel for OpenWrt backup and restore. No OpenWrt buildroot package or `.ipk` build is required.
|
||||
|
||||
- sysupgrade configuration backup;
|
||||
- installed package list and opkg metadata;
|
||||
- OpenWrt release, board, mount, partition and UCI metadata;
|
||||
- optional `/overlay/upper` snapshot;
|
||||
- optional `/rom` read-only rootfs snapshot;
|
||||
- optional copy of a sysupgrade firmware image;
|
||||
- optional raw MTD dumps for same-device disaster recovery.
|
||||
It installs:
|
||||
|
||||
The scripts target OpenWrt `/bin/sh` (BusyBox ash) and are intended for OpenWrt 22.x, 23.x, 24.x and 25.x.
|
||||
- `/usr/sbin/owrt-full-backup` command line helper;
|
||||
- `/www/cgi-bin/owrt-full-backup` web panel;
|
||||
- `/etc/config/fullbackup` defaults;
|
||||
- `/etc/owrt-full-backup/web.key` secret web key.
|
||||
|
||||
## Build
|
||||
Target: OpenWrt 22.x, 23.x, 24.x and 25.x.
|
||||
|
||||
Copy this repository into an OpenWrt build tree, or copy `package/openwrt-full-backup` into the build tree `package/` directory.
|
||||
## Install From Git
|
||||
|
||||
```sh
|
||||
make menuconfig
|
||||
# Utilities -> openwrt-full-backup
|
||||
make package/openwrt-full-backup/compile V=s
|
||||
git clone https://github.com/kzolotarev95/openwrt-full-backup.git
|
||||
cd openwrt-full-backup
|
||||
sh install.sh
|
||||
```
|
||||
|
||||
The package installs two commands:
|
||||
One-line install:
|
||||
|
||||
```sh
|
||||
owrt-full-backup
|
||||
owrt-backup
|
||||
wget -O - https://raw.githubusercontent.com/kzolotarev95/openwrt-full-backup/main/install.sh | sh
|
||||
```
|
||||
|
||||
## Create Backup
|
||||
The installer prints a private panel link:
|
||||
|
||||
Recommended backup to USB or another persistent mount:
|
||||
```text
|
||||
http://192.168.1.1/cgi-bin/owrt-full-backup?key=SECRET
|
||||
```
|
||||
|
||||
Keep this link private.
|
||||
|
||||
## Web Panel
|
||||
|
||||
The panel can:
|
||||
|
||||
- create a full backup archive;
|
||||
- download created archives;
|
||||
- inspect an existing archive;
|
||||
- restore configs;
|
||||
- optionally reinstall saved package list;
|
||||
- optionally restore overlay;
|
||||
- optionally flash firmware image from the archive;
|
||||
- save default backup settings.
|
||||
|
||||
Restore from the web panel does not reinstall packages unless you tick that checkbox.
|
||||
|
||||
## Remove
|
||||
|
||||
From a cloned repo:
|
||||
|
||||
```sh
|
||||
sh uninstall.sh
|
||||
```
|
||||
|
||||
One-line remove:
|
||||
|
||||
```sh
|
||||
wget -O - https://raw.githubusercontent.com/kzolotarev95/openwrt-full-backup/main/uninstall.sh | sh
|
||||
```
|
||||
|
||||
Remove config and web key too:
|
||||
|
||||
```sh
|
||||
wget -O - https://raw.githubusercontent.com/kzolotarev95/openwrt-full-backup/main/uninstall.sh | PURGE=1 sh
|
||||
```
|
||||
|
||||
Backup archives are not deleted by uninstall.
|
||||
|
||||
## CLI Examples
|
||||
|
||||
Create backup to USB:
|
||||
|
||||
```sh
|
||||
owrt-full-backup create -o /mnt/usb
|
||||
```
|
||||
|
||||
Include the exact sysupgrade image if you have it on the router:
|
||||
Include firmware image if it is already on the router:
|
||||
|
||||
```sh
|
||||
owrt-full-backup create -o /mnt/usb --firmware-image /tmp/openwrt-sysupgrade.bin
|
||||
```
|
||||
|
||||
Include the read-only firmware root filesystem snapshot:
|
||||
Inspect backup:
|
||||
|
||||
```sh
|
||||
owrt-full-backup create -o /mnt/usb --include-rom
|
||||
owrt-full-backup inspect /mnt/usb/router-owrt-full-backup.tar.gz
|
||||
```
|
||||
|
||||
Create a same-device raw flash dump too:
|
||||
Restore configs only:
|
||||
|
||||
```sh
|
||||
owrt-full-backup create -o /mnt/usb --include-raw-mtd
|
||||
owrt-full-backup restore /mnt/usb/router-owrt-full-backup.tar.gz --yes --no-packages
|
||||
```
|
||||
|
||||
Raw MTD dumps are not portable between different models or partition layouts.
|
||||
|
||||
## Restore
|
||||
|
||||
Safe restore mode restores configs and reinstalls packages from feeds:
|
||||
|
||||
```sh
|
||||
owrt-full-backup restore /mnt/usb/router-backup.tar.gz --yes
|
||||
```
|
||||
|
||||
Restore only configs:
|
||||
|
||||
```sh
|
||||
owrt-full-backup restore /mnt/usb/router-backup.tar.gz --yes --no-packages
|
||||
```
|
||||
|
||||
Restore the overlay snapshot too, only on the same device and preferably the same OpenWrt release:
|
||||
|
||||
```sh
|
||||
owrt-full-backup restore /mnt/usb/router-backup.tar.gz --yes --overlay
|
||||
```
|
||||
|
||||
Flash firmware from the archive:
|
||||
|
||||
```sh
|
||||
owrt-full-backup restore /mnt/usb/router-backup.tar.gz --yes --flash-firmware
|
||||
```
|
||||
|
||||
Firmware flashing uses `sysupgrade` and reboots the device. The original OpenWrt sysupgrade image is usually not stored on the router, so include it at backup time with `--firmware-image` if you need this.
|
||||
|
||||
## Default Config
|
||||
|
||||
The package installs `/etc/config/fullbackup`:
|
||||
|
||||
```uci
|
||||
config backup 'main'
|
||||
option output_dir '/tmp'
|
||||
option include_overlay '1'
|
||||
option include_rom '0'
|
||||
option include_raw_mtd '0'
|
||||
option keep_days '0'
|
||||
```
|
||||
|
||||
Use `/tmp` only for quick tests. Real backups should go to USB, network storage, or a mounted persistent disk.
|
||||
File renamed without changes.
File renamed without changes.
@@ -0,0 +1,483 @@
|
||||
#!/bin/sh
|
||||
|
||||
BACKEND="${BACKEND:-/usr/sbin/owrt-full-backup}"
|
||||
KEY_FILE="${KEY_FILE:-/etc/owrt-full-backup/web.key}"
|
||||
PARAMS_FILE="${TMPDIR:-/tmp}/owrt-full-backup-cgi.$$"
|
||||
RESULT_FILE=""
|
||||
RESULT_TITLE=""
|
||||
RESULT_CODE=""
|
||||
PROJECT_URL="${PROJECT_URL:-https://github.com/kzolotarev95/openwrt-full-backup}"
|
||||
RAW_URL="${RAW_URL:-https://raw.githubusercontent.com/kzolotarev95/openwrt-full-backup/main}"
|
||||
|
||||
cleanup() {
|
||||
rm -f "$PARAMS_FILE"
|
||||
if [ -n "$RESULT_FILE" ]; then
|
||||
rm -f "$RESULT_FILE"
|
||||
fi
|
||||
}
|
||||
|
||||
trap cleanup EXIT INT TERM
|
||||
|
||||
html_escape() {
|
||||
sed 's/&/\&/g; s/</\</g; s/>/\>/g; s/"/\"/g'
|
||||
}
|
||||
|
||||
h() {
|
||||
printf '%s' "$1" | html_escape
|
||||
}
|
||||
|
||||
url_decode() {
|
||||
local data
|
||||
data="$(printf '%s' "$1" | sed 's/+/ /g; s/%/\\x/g')"
|
||||
printf '%b' "$data"
|
||||
}
|
||||
|
||||
parse_params() {
|
||||
local data old_ifs pair key value
|
||||
data="$1"
|
||||
old_ifs="$IFS"
|
||||
IFS='&'
|
||||
for pair in $data; do
|
||||
key="${pair%%=*}"
|
||||
value="${pair#*=}"
|
||||
[ "$pair" = "$key" ] && value=""
|
||||
key="$(url_decode "$key" | tr -d '\r\n\t')"
|
||||
value="$(url_decode "$value" | tr '\r\n\t' ' ')"
|
||||
[ -n "$key" ] && printf '%s\t%s\n' "$key" "$value" >>"$PARAMS_FILE"
|
||||
done
|
||||
IFS="$old_ifs"
|
||||
}
|
||||
|
||||
param() {
|
||||
awk -F ' ' -v k="$1" '$1 == k { print $2; exit }' "$PARAMS_FILE"
|
||||
}
|
||||
|
||||
has_param() {
|
||||
awk -F ' ' -v k="$1" '$1 == k { found = 1 } END { exit(found ? 0 : 1) }' "$PARAMS_FILE"
|
||||
}
|
||||
|
||||
read_request() {
|
||||
local post_data
|
||||
: >"$PARAMS_FILE"
|
||||
parse_params "${QUERY_STRING:-}"
|
||||
if [ "${REQUEST_METHOD:-GET}" = "POST" ] && [ -n "${CONTENT_LENGTH:-}" ]; then
|
||||
post_data="$(dd bs=1 count="$CONTENT_LENGTH" 2>/dev/null)"
|
||||
parse_params "$post_data"
|
||||
fi
|
||||
}
|
||||
|
||||
config_get() {
|
||||
local key default value
|
||||
key="$1"
|
||||
default="$2"
|
||||
if command -v uci >/dev/null 2>&1; then
|
||||
value="$(uci -q get "fullbackup.main.$key" 2>/dev/null || true)"
|
||||
[ -n "$value" ] && {
|
||||
printf '%s' "$value"
|
||||
return
|
||||
}
|
||||
fi
|
||||
printf '%s' "$default"
|
||||
}
|
||||
|
||||
web_key() {
|
||||
cat "$KEY_FILE" 2>/dev/null
|
||||
}
|
||||
|
||||
self_url() {
|
||||
printf '%s' "${SCRIPT_NAME:-/cgi-bin/owrt-full-backup}"
|
||||
}
|
||||
|
||||
authorized() {
|
||||
local expected supplied
|
||||
expected="$(web_key)"
|
||||
supplied="$(param key)"
|
||||
[ -n "$expected" ] && [ "$supplied" = "$expected" ]
|
||||
}
|
||||
|
||||
http_html() {
|
||||
printf 'Content-Type: text/html; charset=utf-8\r\n\r\n'
|
||||
}
|
||||
|
||||
http_unauthorized() {
|
||||
http_html
|
||||
cat <<'EOF'
|
||||
<!doctype html><html><head><meta charset="utf-8"><title>OpenWrt Full Backup</title></head>
|
||||
<body><h1>Access denied</h1><p>Open the panel with the secret key printed by install.sh.</p></body></html>
|
||||
EOF
|
||||
}
|
||||
|
||||
valid_abs_path() {
|
||||
case "$1" in
|
||||
/*) ;;
|
||||
*) return 1 ;;
|
||||
esac
|
||||
printf '%s' "$1" | grep -Eq '^/[A-Za-z0-9._/-]+$'
|
||||
}
|
||||
|
||||
download_file() {
|
||||
local file base
|
||||
file="$(param file)"
|
||||
valid_abs_path "$file" || {
|
||||
http_html
|
||||
printf '<p>Bad file path.</p>'
|
||||
exit 0
|
||||
}
|
||||
case "$file" in
|
||||
*.tar.gz|*.tar.gz.sha256) ;;
|
||||
*) http_html; printf '<p>Only backup archives and checksums can be downloaded.</p>'; exit 0 ;;
|
||||
esac
|
||||
[ -f "$file" ] || {
|
||||
http_html
|
||||
printf '<p>File not found.</p>'
|
||||
exit 0
|
||||
}
|
||||
base="$(basename "$file")"
|
||||
case "$file" in
|
||||
*.sha256) printf 'Content-Type: text/plain\r\n' ;;
|
||||
*) printf 'Content-Type: application/gzip\r\n' ;;
|
||||
esac
|
||||
printf 'Content-Disposition: attachment; filename="%s"\r\n\r\n' "$base"
|
||||
cat "$file"
|
||||
exit 0
|
||||
}
|
||||
|
||||
run_backend() {
|
||||
RESULT_TITLE="$1"
|
||||
shift
|
||||
RESULT_FILE="${TMPDIR:-/tmp}/owrt-full-backup-result.$$"
|
||||
if [ ! -x "$BACKEND" ]; then
|
||||
RESULT_CODE=127
|
||||
printf 'Backend is not installed: %s\n' "$BACKEND" >"$RESULT_FILE"
|
||||
return
|
||||
fi
|
||||
"$BACKEND" "$@" >"$RESULT_FILE" 2>&1
|
||||
RESULT_CODE="$?"
|
||||
}
|
||||
|
||||
handle_create() {
|
||||
local output_dir name firmware
|
||||
output_dir="$(param output_dir)"
|
||||
name="$(param name)"
|
||||
firmware="$(param firmware_image)"
|
||||
[ -n "$output_dir" ] || output_dir="$(config_get output_dir /tmp)"
|
||||
valid_abs_path "$output_dir" || {
|
||||
RESULT_TITLE="Create backup"
|
||||
RESULT_CODE=2
|
||||
RESULT_FILE="${TMPDIR:-/tmp}/owrt-full-backup-result.$$"
|
||||
printf 'Bad output directory. Use an absolute path, for example /mnt/usb.\n' >"$RESULT_FILE"
|
||||
return
|
||||
}
|
||||
|
||||
set -- create -o "$output_dir"
|
||||
[ -n "$name" ] && set -- "$@" -n "$name"
|
||||
has_param include_overlay || set -- "$@" --no-overlay
|
||||
has_param include_rom && set -- "$@" --include-rom
|
||||
has_param include_raw_mtd && set -- "$@" --include-raw-mtd
|
||||
[ -n "$firmware" ] && set -- "$@" --firmware-image "$firmware"
|
||||
run_backend "Create backup" "$@"
|
||||
}
|
||||
|
||||
handle_inspect() {
|
||||
local archive
|
||||
archive="$(param archive)"
|
||||
valid_abs_path "$archive" || {
|
||||
RESULT_TITLE="Inspect backup"
|
||||
RESULT_CODE=2
|
||||
RESULT_FILE="${TMPDIR:-/tmp}/owrt-full-backup-result.$$"
|
||||
printf 'Bad archive path.\n' >"$RESULT_FILE"
|
||||
return
|
||||
}
|
||||
run_backend "Inspect backup" inspect "$archive"
|
||||
}
|
||||
|
||||
handle_restore() {
|
||||
local archive confirm
|
||||
archive="$(param archive)"
|
||||
confirm="$(param confirm)"
|
||||
if [ "$confirm" != "RESTORE" ]; then
|
||||
RESULT_TITLE="Restore backup"
|
||||
RESULT_CODE=2
|
||||
RESULT_FILE="${TMPDIR:-/tmp}/owrt-full-backup-result.$$"
|
||||
printf 'Type RESTORE to confirm restore.\n' >"$RESULT_FILE"
|
||||
return
|
||||
fi
|
||||
valid_abs_path "$archive" || {
|
||||
RESULT_TITLE="Restore backup"
|
||||
RESULT_CODE=2
|
||||
RESULT_FILE="${TMPDIR:-/tmp}/owrt-full-backup-result.$$"
|
||||
printf 'Bad archive path.\n' >"$RESULT_FILE"
|
||||
return
|
||||
}
|
||||
|
||||
set -- restore "$archive" --yes
|
||||
has_param restore_configs || set -- "$@" --no-configs
|
||||
has_param restore_packages || set -- "$@" --no-packages
|
||||
has_param restore_overlay && set -- "$@" --overlay
|
||||
has_param flash_firmware && set -- "$@" --flash-firmware
|
||||
run_backend "Restore backup" "$@"
|
||||
}
|
||||
|
||||
handle_save_defaults() {
|
||||
local output_dir include_overlay include_rom include_raw_mtd keep_days
|
||||
RESULT_TITLE="Save defaults"
|
||||
RESULT_CODE=0
|
||||
RESULT_FILE="${TMPDIR:-/tmp}/owrt-full-backup-result.$$"
|
||||
output_dir="$(param default_output_dir)"
|
||||
keep_days="$(param keep_days)"
|
||||
valid_abs_path "$output_dir" || {
|
||||
RESULT_CODE=2
|
||||
printf 'Bad output directory.\n' >"$RESULT_FILE"
|
||||
return
|
||||
}
|
||||
case "$keep_days" in ''|*[!0-9]*) keep_days=0 ;; esac
|
||||
has_param default_include_overlay && include_overlay=1 || include_overlay=0
|
||||
has_param default_include_rom && include_rom=1 || include_rom=0
|
||||
has_param default_include_raw_mtd && include_raw_mtd=1 || include_raw_mtd=0
|
||||
|
||||
if command -v uci >/dev/null 2>&1; then
|
||||
uci -q batch <<EOF >"$RESULT_FILE" 2>&1
|
||||
set fullbackup.main=backup
|
||||
set fullbackup.main.output_dir='$output_dir'
|
||||
set fullbackup.main.include_overlay='$include_overlay'
|
||||
set fullbackup.main.include_rom='$include_rom'
|
||||
set fullbackup.main.include_raw_mtd='$include_raw_mtd'
|
||||
set fullbackup.main.keep_days='$keep_days'
|
||||
commit fullbackup
|
||||
EOF
|
||||
RESULT_CODE="$?"
|
||||
[ "$RESULT_CODE" = "0" ] && printf 'Defaults saved.\n' >>"$RESULT_FILE"
|
||||
else
|
||||
RESULT_CODE=127
|
||||
printf 'uci command not found.\n' >"$RESULT_FILE"
|
||||
fi
|
||||
}
|
||||
|
||||
handle_action() {
|
||||
local action
|
||||
action="$(param action)"
|
||||
case "$action" in
|
||||
create) handle_create ;;
|
||||
inspect) handle_inspect ;;
|
||||
restore) handle_restore ;;
|
||||
save_defaults) handle_save_defaults ;;
|
||||
esac
|
||||
}
|
||||
|
||||
system_value() {
|
||||
case "$1" in
|
||||
host) hostname 2>/dev/null || printf 'openwrt' ;;
|
||||
release)
|
||||
if [ -r /etc/openwrt_release ]; then
|
||||
. /etc/openwrt_release 2>/dev/null
|
||||
printf '%s %s' "${DISTRIB_ID:-OpenWrt}" "${DISTRIB_RELEASE:-unknown}"
|
||||
else
|
||||
printf 'OpenWrt unknown'
|
||||
fi
|
||||
;;
|
||||
board)
|
||||
if [ -r /tmp/sysinfo/board_name ]; then
|
||||
cat /tmp/sysinfo/board_name
|
||||
else
|
||||
printf 'unknown'
|
||||
fi
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
checkbox_attr() {
|
||||
[ "$1" = "1" ] && printf ' checked'
|
||||
}
|
||||
|
||||
backup_rows() {
|
||||
local dir key file base size mtime
|
||||
dir="$(config_get output_dir /tmp)"
|
||||
key="$(h "$(param key)")"
|
||||
[ -d "$dir" ] || {
|
||||
printf '<tr><td colspan="4">Output directory does not exist.</td></tr>'
|
||||
return
|
||||
}
|
||||
for file in "$dir"/*-owrt-full-backup.tar.gz; do
|
||||
[ -f "$file" ] || continue
|
||||
base="$(basename "$file")"
|
||||
size="$(ls -lh "$file" 2>/dev/null | awk '{print $5}')"
|
||||
mtime="$(ls -l "$file" 2>/dev/null | awk '{print $6" "$7" "$8}')"
|
||||
printf '<tr><td><code>%s</code></td><td>%s</td><td>%s</td><td><a href="%s?key=%s&action=download&file=%s">download</a></td></tr>' \
|
||||
"$(h "$base")" "$(h "$size")" "$(h "$mtime")" "$(self_url)" "$key" "$(h "$file")"
|
||||
done
|
||||
}
|
||||
|
||||
page() {
|
||||
local key output_dir include_overlay include_rom include_raw_mtd keep_days
|
||||
key="$(h "$(param key)")"
|
||||
output_dir="$(config_get output_dir /tmp)"
|
||||
include_overlay="$(config_get include_overlay 1)"
|
||||
include_rom="$(config_get include_rom 0)"
|
||||
include_raw_mtd="$(config_get include_raw_mtd 0)"
|
||||
keep_days="$(config_get keep_days 0)"
|
||||
|
||||
http_html
|
||||
cat <<EOF
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title>OpenWrt Full Backup</title>
|
||||
<style>
|
||||
:root { color-scheme: light dark; --bg: #f6f7f9; --panel: #fff; --text: #15181c; --muted: #667085; --line: #d9dee7; --accent: #1769e0; --bad: #b42318; --ok: #067647; }
|
||||
@media (prefers-color-scheme: dark) { :root { --bg: #111418; --panel: #181d23; --text: #eef2f6; --muted: #a6b0bf; --line: #2d3642; --accent: #6aa4ff; --bad: #ff9b91; --ok: #7ee0a3; } }
|
||||
* { box-sizing: border-box; }
|
||||
body { margin: 0; background: var(--bg); color: var(--text); font: 14px/1.45 system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
|
||||
header { background: var(--panel); border-bottom: 1px solid var(--line); padding: 18px 20px; }
|
||||
main { max-width: 1180px; margin: 0 auto; padding: 18px; display: grid; gap: 14px; }
|
||||
h1 { margin: 0; font-size: 22px; }
|
||||
h2 { margin: 0 0 12px; font-size: 16px; }
|
||||
p { margin: 6px 0; color: var(--muted); }
|
||||
.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; }
|
||||
.span6 { grid-column: span 6; }
|
||||
.span8 { grid-column: span 8; }
|
||||
.span12 { grid-column: span 12; }
|
||||
label { display: block; margin: 9px 0 4px; font-weight: 600; }
|
||||
input[type=text], input[type=number] { width: 100%; border: 1px solid var(--line); border-radius: 6px; background: transparent; color: var(--text); padding: 9px; }
|
||||
.checks label { font-weight: 500; display: flex; gap: 8px; align-items: center; margin: 8px 0; }
|
||||
button, .button { display: inline-flex; align-items: center; justify-content: center; min-height: 36px; border: 0; border-radius: 6px; background: var(--accent); color: #fff; padding: 8px 12px; text-decoration: none; font-weight: 700; cursor: pointer; }
|
||||
.danger { background: var(--bad); }
|
||||
.muted { color: var(--muted); }
|
||||
code, pre { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }
|
||||
pre { overflow: auto; background: rgba(127,127,127,.12); border-radius: 6px; padding: 10px; }
|
||||
table { width: 100%; border-collapse: collapse; }
|
||||
td, th { border-bottom: 1px solid var(--line); padding: 8px 6px; text-align: left; vertical-align: top; }
|
||||
.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; } }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<header>
|
||||
<h1>OpenWrt Full Backup</h1>
|
||||
<p>Direct web panel, no IPK build required. Keep this URL secret.</p>
|
||||
</header>
|
||||
<main>
|
||||
EOF
|
||||
|
||||
if [ -n "$RESULT_FILE" ]; then
|
||||
printf '<section class="panel span12"><h2>%s</h2><p>Exit code: %s</p><pre>' "$(h "$RESULT_TITLE")" "$(h "$RESULT_CODE")"
|
||||
html_escape <"$RESULT_FILE"
|
||||
printf '</pre></section>'
|
||||
fi
|
||||
|
||||
cat <<EOF
|
||||
<section class="grid">
|
||||
<div class="panel span4">
|
||||
<h2>Device</h2>
|
||||
<div class="status">
|
||||
<span class="pill">Host: $(h "$(system_value host)")</span>
|
||||
<span class="pill">Release: $(h "$(system_value release)")</span>
|
||||
<span class="pill">Board: $(h "$(system_value board)")</span>
|
||||
</div>
|
||||
<pre>$(df -h 2>/dev/null | html_escape)</pre>
|
||||
</div>
|
||||
|
||||
<form class="panel span8" method="post" action="$(self_url)">
|
||||
<h2>Create backup</h2>
|
||||
<input type="hidden" name="key" value="$key">
|
||||
<input type="hidden" name="action" value="create">
|
||||
<label>Output directory</label>
|
||||
<input type="text" name="output_dir" value="$(h "$output_dir")">
|
||||
<label>Archive name</label>
|
||||
<input type="text" name="name" placeholder="auto name">
|
||||
<label>Firmware image path</label>
|
||||
<input type="text" name="firmware_image" placeholder="/tmp/openwrt-sysupgrade.bin">
|
||||
<div class="checks">
|
||||
<label><input type="checkbox" name="include_overlay" value="1"$(checkbox_attr "$include_overlay")> include /overlay/upper</label>
|
||||
<label><input type="checkbox" name="include_rom" value="1"$(checkbox_attr "$include_rom")> include /rom rootfs snapshot</label>
|
||||
<label><input type="checkbox" name="include_raw_mtd" value="1"$(checkbox_attr "$include_raw_mtd")> include raw MTD dumps</label>
|
||||
</div>
|
||||
<button type="submit">Create backup</button>
|
||||
</form>
|
||||
|
||||
<div class="panel span12">
|
||||
<h2>Backups in $(h "$output_dir")</h2>
|
||||
<table><thead><tr><th>File</th><th>Size</th><th>Date</th><th>Action</th></tr></thead><tbody>
|
||||
$(backup_rows)
|
||||
</tbody></table>
|
||||
</div>
|
||||
|
||||
<form class="panel span6" method="post" action="$(self_url)">
|
||||
<h2>Inspect archive</h2>
|
||||
<input type="hidden" name="key" value="$key">
|
||||
<input type="hidden" name="action" value="inspect">
|
||||
<label>Archive path</label>
|
||||
<input type="text" name="archive" placeholder="/mnt/usb/router-owrt-full-backup.tar.gz">
|
||||
<button type="submit">Inspect</button>
|
||||
</form>
|
||||
|
||||
<form class="panel span6" method="post" action="$(self_url)">
|
||||
<h2>Restore archive</h2>
|
||||
<input type="hidden" name="key" value="$key">
|
||||
<input type="hidden" name="action" value="restore">
|
||||
<label>Archive path</label>
|
||||
<input type="text" name="archive" placeholder="/mnt/usb/router-owrt-full-backup.tar.gz">
|
||||
<div class="checks">
|
||||
<label><input type="checkbox" name="restore_configs" value="1" checked> restore configs</label>
|
||||
<label><input type="checkbox" name="restore_packages" value="1"> reinstall package list</label>
|
||||
<label><input type="checkbox" name="restore_overlay" value="1"> restore overlay snapshot</label>
|
||||
<label><input type="checkbox" name="flash_firmware" value="1"> flash firmware image and reboot</label>
|
||||
</div>
|
||||
<label>Type RESTORE</label>
|
||||
<input type="text" name="confirm" autocomplete="off">
|
||||
<button class="danger" type="submit">Run restore</button>
|
||||
</form>
|
||||
|
||||
<form class="panel span6" method="post" action="$(self_url)">
|
||||
<h2>Defaults</h2>
|
||||
<input type="hidden" name="key" value="$key">
|
||||
<input type="hidden" name="action" value="save_defaults">
|
||||
<label>Default output directory</label>
|
||||
<input type="text" name="default_output_dir" value="$(h "$output_dir")">
|
||||
<label>Keep days, 0 disables cleanup</label>
|
||||
<input type="number" min="0" name="keep_days" value="$(h "$keep_days")">
|
||||
<div class="checks">
|
||||
<label><input type="checkbox" name="default_include_overlay" value="1"$(checkbox_attr "$include_overlay")> include overlay by default</label>
|
||||
<label><input type="checkbox" name="default_include_rom" value="1"$(checkbox_attr "$include_rom")> include ROM by default</label>
|
||||
<label><input type="checkbox" name="default_include_raw_mtd" value="1"$(checkbox_attr "$include_raw_mtd")> include raw MTD by default</label>
|
||||
</div>
|
||||
<button type="submit">Save defaults</button>
|
||||
</form>
|
||||
|
||||
<div class="panel span6">
|
||||
<h2>Git install / remove</h2>
|
||||
<p>Clone install:</p>
|
||||
<pre>git clone $(h "$PROJECT_URL").git
|
||||
cd openwrt-full-backup
|
||||
sh install.sh</pre>
|
||||
<p>One-line install:</p>
|
||||
<pre>wget -O - $(h "$RAW_URL")/install.sh | sh</pre>
|
||||
<p>Remove:</p>
|
||||
<pre>wget -O - $(h "$RAW_URL")/uninstall.sh | sh</pre>
|
||||
</div>
|
||||
</section>
|
||||
</main>
|
||||
</body>
|
||||
</html>
|
||||
EOF
|
||||
}
|
||||
|
||||
read_request
|
||||
if ! authorized; then
|
||||
http_unauthorized
|
||||
exit 0
|
||||
fi
|
||||
|
||||
if [ "$(param action)" = "download" ]; then
|
||||
download_file
|
||||
fi
|
||||
|
||||
if [ "${REQUEST_METHOD:-GET}" = "POST" ]; then
|
||||
handle_action
|
||||
fi
|
||||
|
||||
page
|
||||
+116
@@ -0,0 +1,116 @@
|
||||
#!/bin/sh
|
||||
|
||||
set -eu
|
||||
|
||||
RAW_URL="${RAW_URL:-https://raw.githubusercontent.com/kzolotarev95/openwrt-full-backup/main}"
|
||||
ROOT="${ROOT:-/}"
|
||||
SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" 2>/dev/null && pwd)"
|
||||
|
||||
info() {
|
||||
printf '%s\n' "$*"
|
||||
}
|
||||
|
||||
die() {
|
||||
printf 'ERROR: %s\n' "$*" >&2
|
||||
exit 1
|
||||
}
|
||||
|
||||
target_path() {
|
||||
printf '%s/%s' "${ROOT%/}" "$1"
|
||||
}
|
||||
|
||||
fetch() {
|
||||
local src dst
|
||||
src="$1"
|
||||
dst="$2"
|
||||
if command -v wget >/dev/null 2>&1; then
|
||||
wget -O "$dst" "$src"
|
||||
elif command -v curl >/dev/null 2>&1; then
|
||||
curl -fsSL "$src" -o "$dst"
|
||||
else
|
||||
die "wget or curl is required for remote install"
|
||||
fi
|
||||
}
|
||||
|
||||
install_file() {
|
||||
local rel mode src dst
|
||||
rel="$1"
|
||||
mode="$2"
|
||||
src="$SCRIPT_DIR/files/$rel"
|
||||
dst="$(target_path "$rel")"
|
||||
mkdir -p "$(dirname "$dst")"
|
||||
if [ -f "$src" ]; then
|
||||
cp "$src" "$dst"
|
||||
else
|
||||
fetch "$RAW_URL/files/$rel" "$dst"
|
||||
fi
|
||||
chmod "$mode" "$dst"
|
||||
}
|
||||
|
||||
install_config() {
|
||||
local rel src dst
|
||||
rel="etc/config/fullbackup"
|
||||
src="$SCRIPT_DIR/files/$rel"
|
||||
dst="$(target_path "$rel")"
|
||||
mkdir -p "$(dirname "$dst")"
|
||||
if [ -f "$dst" ]; then
|
||||
info "Keeping existing $dst"
|
||||
return
|
||||
fi
|
||||
if [ -f "$src" ]; then
|
||||
cp "$src" "$dst"
|
||||
else
|
||||
fetch "$RAW_URL/files/$rel" "$dst"
|
||||
fi
|
||||
chmod 0644 "$dst"
|
||||
}
|
||||
|
||||
make_key() {
|
||||
local key_dir key_file key
|
||||
key_dir="$(target_path etc/owrt-full-backup)"
|
||||
key_file="$key_dir/web.key"
|
||||
mkdir -p "$key_dir"
|
||||
if [ ! -s "$key_file" ]; then
|
||||
if command -v hexdump >/dev/null 2>&1; then
|
||||
key="$(dd if=/dev/urandom bs=16 count=1 2>/dev/null | hexdump -v -e '16/1 "%02x"')"
|
||||
else
|
||||
key="$(date +%s)-$$"
|
||||
fi
|
||||
printf '%s\n' "$key" >"$key_file"
|
||||
fi
|
||||
chmod 0600 "$key_file"
|
||||
cat "$key_file"
|
||||
}
|
||||
|
||||
router_ip() {
|
||||
local ip
|
||||
if command -v uci >/dev/null 2>&1; then
|
||||
ip="$(uci -q get network.lan.ipaddr 2>/dev/null || true)"
|
||||
if [ -n "$ip" ]; then
|
||||
printf '%s\n' "$ip"
|
||||
return
|
||||
fi
|
||||
fi
|
||||
ip="$(hostname -I 2>/dev/null | awk '{print $1}')"
|
||||
if [ -n "$ip" ]; then
|
||||
printf '%s\n' "$ip"
|
||||
return
|
||||
fi
|
||||
printf '192.168.1.1'
|
||||
}
|
||||
|
||||
install_file "usr/sbin/owrt-full-backup" 0755
|
||||
ln -sf owrt-full-backup "$(target_path usr/sbin/owrt-backup)"
|
||||
install_config
|
||||
install_file "www/cgi-bin/owrt-full-backup" 0755
|
||||
|
||||
if [ -x "$(target_path etc/init.d/uhttpd)" ]; then
|
||||
"$(target_path etc/init.d/uhttpd)" reload >/dev/null 2>&1 || "$(target_path etc/init.d/uhttpd)" restart >/dev/null 2>&1 || true
|
||||
fi
|
||||
|
||||
key="$(make_key)"
|
||||
ip="$(router_ip)"
|
||||
|
||||
info "Installed OpenWrt Full Backup web panel."
|
||||
info "Open: http://$ip/cgi-bin/owrt-full-backup?key=$key"
|
||||
info "CLI: owrt-full-backup create -o /mnt/usb"
|
||||
@@ -1,36 +0,0 @@
|
||||
include $(TOPDIR)/rules.mk
|
||||
|
||||
PKG_NAME:=openwrt-full-backup
|
||||
PKG_VERSION:=1.0.0
|
||||
PKG_RELEASE:=1
|
||||
PKGARCH:=all
|
||||
PKG_LICENSE:=MIT
|
||||
PKG_MAINTAINER:=K. Zolotarev
|
||||
|
||||
include $(INCLUDE_DIR)/package.mk
|
||||
|
||||
define Package/openwrt-full-backup
|
||||
SECTION:=utils
|
||||
CATEGORY:=Utilities
|
||||
TITLE:=Full backup and restore helper for OpenWrt
|
||||
endef
|
||||
|
||||
define Package/openwrt-full-backup/description
|
||||
Creates a portable backup archive with sysupgrade config backup, installed
|
||||
package list, OpenWrt metadata, optional overlay snapshot, optional ROM rootfs
|
||||
snapshot, optional firmware image copy, and optional raw MTD dumps. Includes
|
||||
guarded restore helpers for OpenWrt 22.x through 25.x.
|
||||
endef
|
||||
|
||||
define Build/Compile
|
||||
endef
|
||||
|
||||
define Package/openwrt-full-backup/install
|
||||
$(INSTALL_DIR) $(1)/usr/sbin
|
||||
$(INSTALL_BIN) ./files/usr/sbin/owrt-full-backup $(1)/usr/sbin/owrt-full-backup
|
||||
$(LN) owrt-full-backup $(1)/usr/sbin/owrt-backup
|
||||
$(INSTALL_DIR) $(1)/etc/config
|
||||
$(INSTALL_CONF) ./files/etc/config/fullbackup $(1)/etc/config/fullbackup
|
||||
endef
|
||||
|
||||
$(eval $(call BuildPackage,openwrt-full-backup))
|
||||
@@ -0,0 +1,33 @@
|
||||
#!/bin/sh
|
||||
|
||||
set -eu
|
||||
|
||||
ROOT="${ROOT:-/}"
|
||||
PURGE="${PURGE:-0}"
|
||||
|
||||
target_path() {
|
||||
printf '%s/%s' "${ROOT%/}" "$1"
|
||||
}
|
||||
|
||||
rmf() {
|
||||
rm -f "$(target_path "$1")"
|
||||
}
|
||||
|
||||
rmf usr/sbin/owrt-full-backup
|
||||
rmf usr/sbin/owrt-backup
|
||||
rmf www/cgi-bin/owrt-full-backup
|
||||
|
||||
if [ "$PURGE" = "1" ]; then
|
||||
rmf etc/config/fullbackup
|
||||
rmf etc/owrt-full-backup/web.key
|
||||
rmdir "$(target_path etc/owrt-full-backup)" 2>/dev/null || true
|
||||
fi
|
||||
|
||||
if [ -x "$(target_path etc/init.d/uhttpd)" ]; then
|
||||
"$(target_path etc/init.d/uhttpd)" reload >/dev/null 2>&1 || "$(target_path etc/init.d/uhttpd)" restart >/dev/null 2>&1 || true
|
||||
fi
|
||||
|
||||
printf '%s\n' "Removed OpenWrt Full Backup web panel."
|
||||
if [ "$PURGE" != "1" ]; then
|
||||
printf '%s\n' "Config and web key were kept. Run with PURGE=1 to remove them."
|
||||
fi
|
||||
Reference in new issue
Block a user