Files
Linux_post_install/bin/pos-system-backup
T
Your Name d4d38ad901 feat: pos system backup copies to USB after verification — sha256-proven 100%
Once the archive verifies, USB detection runs (so a stick plugged in while
the backup ran is found): mounted removable storage is auto-detected via
lsblk -J + a recursive jq filter (rm, mounted, type part|disk — JSON makes
spacey mountpoints safe), or BACKUP_USB_ROOT pins a fixed stick and skips
detection. None mounted → one re-scan prompt ('s' skips, EOF from cron
skips silently, rc stays 0); one stick → y/N confirm; several → numbered
pick (0 = skip). The copy lands in <usb>/backups/ (mkdir -p, chmod 600
best-effort — a vfat chmod failure warns, never fails the copy) and the
transfer is proven 100% by sha256 source-vs-copy before any success is
announced; a mismatch warns with both hashes, notifies 'USB copy FAILED',
and exits 1. The ERR trap is re-armed before the USB phase so a copy
failure no longer notifies 'Backup FAILED'. Docs: usage() Environment,
POS.md backup row, howto/system.md (USB section + env table + mismatch
troubleshooting), DEV.md system.env list. Stub suite
(/tmp/opencode/backup-test, HOME-isolated, sudo/gpg/lsblk/sender stubs,
corrupting-cp + vfat-chmod overrides, per-test lsblk JSON fixtures):
40/40 green.
2026-08-13 03:23:30 -04:00

221 lines
7.3 KiB
Bash
Executable File

#!/usr/bin/env bash
set -euo pipefail
# POS: system backup — Encrypted (AES-256) folder snapshots (tar + gpg)
# POS_FLAGS: --service
# POS_CONFIG: notify | notify.env | NOTIFY_PLATFORM=:Comma-separated notify platforms (default telegram) — shared by backup, firewall, share nfs client/server
source "$(dirname "$0")/../lib/common.sh" 2>/dev/null || source "$(dirname "$0")/common.sh"
source "$(dirname "$0")/../lib/notify.sh" 2>/dev/null || source "$(dirname "$0")/notify.sh"
load_system_env
EFF_ROOTS="${BACKUP_SERVICE_ROOTS:-/srv $HOME/srv}"
trap 'notify_send "Backup FAILED: ${FOLDER:-unknown}"' ERR
usage() {
cat <<EOF
Usage: pos system backup <folder-path>
pos system backup --service
Create a gpg-encrypted (AES-256) tar.gz snapshot of a folder and verify it.
The archive password is prompted twice and never stored.
Modes:
<folder-path> Back up that folder directly.
--service List folders under /srv and ~/srv, pick one, back it up.
The final artifact <name>_<date>.tar.gz.gpg is written to the current directory.
After it verifies, connected USB storage is offered: the copy lands in
<usb>/backups/ and is sha256-verified 100% before it is announced.
Environment:
BACKUP_SERVICE_ROOTS Space-separated roots for --service
(effective: ${EFF_ROOTS})
BACKUP_USB_ROOT USB root to copy finished backups to
(default: auto-detect mounted removable storage)
(loaded from ~/.config/linux_post_install/system.env unless exported)
EOF
exit 0
}
command -v tar &>/dev/null || err "tar not found"
command -v gpg &>/dev/null || err "gpg not found (install gnupg)"
# ── USB copy (optional post-backup step) ─────────────────────────
# Detection runs AFTER the backup finished, so a stick plugged in while
# the archive was being made is found. The copy lands in <usb>/backups/
# and the transfer is proven 100% (sha256 source vs copy) before any
# success is announced. BACKUP_USB_ROOT pins the root and skips
# detection; otherwise mounted removable storage is auto-detected.
usb_copy_offer() {
local archive="$1" pass=0 resp="" i=0 root="" dest_dir="" dest="" src_sum="" dst_sum=""
local -a roots=()
command -v lsblk &>/dev/null || { warn "lsblk not found — USB copy skipped"; return 0; }
command -v jq &>/dev/null || { warn "jq not found — USB copy skipped"; return 0; }
section "USB copy"
while :; do
pass=$((pass + 1))
roots=()
if [ -n "${BACKUP_USB_ROOT:-}" ]; then
roots+=("$BACKUP_USB_ROOT")
else
while IFS= read -r mp; do
[ -n "$mp" ] && roots+=("$mp")
done < <(lsblk -J -o MOUNTPOINT,RM,TYPE 2>/dev/null \
| jq -r '.. | objects | select(.rm == true and .mountpoint != null and (.type == "part" or .type == "disk")) | .mountpoint')
fi
[ ${#roots[@]} -gt 0 ] && break
# None found — offer one re-scan before giving up.
if [ "$pass" -ge 2 ]; then
warn "Still no USB storage detected — backup stays local: $archive"
return 0
fi
warn "No USB storage detected"
read -rp "Plug a USB drive in now and press Enter to re-check (or 's' to skip): " resp || return 0
case "$resp" in
s|S) log "Skipped — backup stays local: $archive"; return 0 ;;
esac
done
if [ ${#roots[@]} -eq 1 ]; then
root="${roots[0]}"
if ! confirm "Copy backup to ${root%/}/backups/?" n; then
log "Skipped — backup stays local: $archive"
return 0
fi
else
echo "Multiple USB storages found:"
for i in "${!roots[@]}"; do
printf "%2d) %s\n" "$((i + 1))" "${roots[$i]}"
done
read -rp "Copy backup to which one? [1-${#roots[@]}] (0 = skip): " resp || return 0
if ! [[ "$resp" =~ ^[0-9]+$ ]] || (( resp < 1 || resp > ${#roots[@]} )); then
log "Skipped — backup stays local: $archive"
return 0
fi
root="${roots[$((resp - 1))]}"
fi
dest_dir="${root%/}/backups"
dest="$dest_dir/$(basename "$archive")"
mkdir -p "$dest_dir"
log "Copying to $dest ..."
cp "$archive" "$dest_dir/"
chmod 600 "$dest" 2>/dev/null \
|| warn "Could not chmod 600 the USB copy (vfat filesystem?)"
log "Verifying transfer (sha256)..."
src_sum="$(sha256sum "$archive" | cut -d' ' -f1)"
dst_sum="$(sha256sum "$dest" | cut -d' ' -f1)"
if [ "$src_sum" != "$dst_sum" ]; then
warn "USB copy FAILED verification — checksum mismatch:"
warn " source: $src_sum $archive"
warn " copy : $dst_sum $dest"
notify_send "USB copy FAILED for $archive — checksum mismatch on $dest"
exit 1
fi
ok "Transfer verified 100% (sha256 match): $dest"
notify_send "Backup copied to USB: $dest (sha256 verified)"
}
SERVICE=0
case "${1:-}" in
-h|--help) usage ;;
--service) SERVICE=1 ;;
"") err "Missing folder path (or use --service)" ;;
*) FOLDER="$1" ;;
esac
if [ "$SERVICE" -eq 1 ]; then
if [ -n "${BACKUP_SERVICE_ROOTS:-}" ]; then
read -r -a roots <<< "$BACKUP_SERVICE_ROOTS"
else
roots=(/srv "$HOME/srv")
fi
idx=0
for root in "${roots[@]}"; do
[ -d "$root" ] || { warn "Root not found: $root"; continue; }
dirs=()
while IFS= read -r d; do
dirs+=("$d")
done < <(find "$root" -maxdepth 1 -mindepth 1 -type d | sort)
[ ${#dirs[@]} -gt 0 ] || { warn "No folders in $root"; continue; }
echo
echo "${root}:"
for d in "${dirs[@]}"; do
idx=$((idx + 1))
names[$idx]="$d"
printf "%2d) %s\n" "$idx" "$d"
done
done
[ "$idx" -gt 0 ] || err "No folders found under: ${roots[*]}"
read -rp "Select folder number: " choice
if ! [[ "$choice" =~ ^[0-9]+$ ]] || (( choice < 1 || choice > idx )); then
err "Invalid selection: $choice"
fi
FOLDER="${names[$choice]}"
fi
[ -d "$FOLDER" ] || err "Folder not found: $FOLDER"
NAME="$(basename "$FOLDER")"
DATE="$(date +%Y-%m-%d_%H-%M-%S)"
ARCHIVE="${NAME}_${DATE}.tar.gz"
echo
log "Creating backup..."
echo "Source : $FOLDER"
echo "Output : $ARCHIVE"
sudo tar -czvf "$ARCHIVE" -C "$(dirname "$FOLDER")" "$NAME"
log "Verifying archive..."
tar -tzf "$ARCHIVE" > /dev/null
log "Archive verified"
while true; do
read -s -rp "Enter backup password: " PASS
echo
read -s -rp "Confirm backup password: " CONFIRM
echo
if [ -n "$PASS" ] && [ "$PASS" = "$CONFIRM" ]; then
break
fi
warn "Passwords are empty or do not match — try again"
done
unset CONFIRM
log "Encrypting backup..."
gpg --batch --yes --passphrase "$PASS" --symmetric --cipher-algo AES256 "$ARCHIVE"
rm -f "$ARCHIVE"
ARCHIVE="${ARCHIVE}.gpg"
chmod 600 "$ARCHIVE"
log "Verifying encrypted backup..."
gpg --batch --quiet --passphrase "$PASS" --decrypt "$ARCHIVE" | tar -tzf - > /dev/null
unset PASS
echo
log "Backup completed: $ARCHIVE"
notify_send "Backup completed: $ARCHIVE"
# Optional: detect a USB stick connected after the backup finished, offer to
# copy the archive to <usb>/backups/, and prove the transfer 100%. From here
# on a failure is a USB-copy problem, not a backup problem.
trap 'notify_send "USB copy FAILED: ${ARCHIVE:-unknown}"' ERR
usb_copy_offer "$ARCHIVE"