#!/bin/bash # ============================================================ # put-key-to-usb.sh # ============================================================ # Копирует ключ шифрования секретов на флешку # вместе с инструкцией по восстановлению. # # ВАЖНО: флешка должна храниться ОТДЕЛЬНО от сервера. # Правило: ключ и зашифрованные данные — в РАЗНЫХ местах. # # ЗАПУСК: bash put-key-to-usb.sh # ============================================================ set -uo pipefail KEY_FILE="/root/.buryan-age-key" SECRETS_FILE="/root/buryan-infra/ops/secrets-enc/secrets.yaml" MOUNT="/mnt/usb-key" echo "╔══════════════════════════════════════════════════════════╗" echo "║ КОПИРУЮ КЛЮЧ НА ФЛЕШКУ ║" echo "╚══════════════════════════════════════════════════════════╝" echo echo "═══════════════════════════════════════════════════════════" echo " 1. ПРОВЕРКА КЛЮЧА" echo "═══════════════════════════════════════════════════════════" if [ ! -f "$KEY_FILE" ]; then echo " ❌ ключ не найден: $KEY_FILE" exit 1 fi FP=$(grep -oE 'age1[a-z0-9]+' "$KEY_FILE" 2>/dev/null | head -1) KEYSUM=$(sha256sum "$KEY_FILE" | cut -c1-16) echo " ✅ ключ найден" printf ' права: %s\n' "$(stat -c '%a' "$KEY_FILE")" printf ' отпечаток: %s...\n' "${FP:0:24}" printf ' контрольная сумма: %s\n' "$KEYSUM" echo "$FP" > /tmp/usb-fingerprint.txt echo "$KEYSUM" > /tmp/usb-checksum.txt echo echo "═══════════════════════════════════════════════════════════" echo " 2. ИЩУ ФЛЕШКИ" echo "═══════════════════════════════════════════════════════════" echo " ── все устройства и разделы ──" lsblk -o NAME,SIZE,TYPE,FSTYPE,LABEL,MOUNTPOINT 2>/dev/null | sed 's/^/ /' echo echo " ── съёмные устройства ──" REMOVABLE="" for dev in /sys/block/sd*; do [ -e "$dev/removable" ] || continue [ "$(cat "$dev/removable" 2>/dev/null)" = "1" ] || continue NAME=$(basename "$dev") SIZE=$(lsblk -dno SIZE "/dev/$NAME" 2>/dev/null) MODEL=$(cat "$dev/device/model" 2>/dev/null | xargs) printf ' /dev/%-6s %-8s %s\n' "$NAME" "$SIZE" "$MODEL" REMOVABLE="$REMOVABLE $NAME" done if [ -z "$REMOVABLE" ]; then echo " ⚠️ съёмных устройств не найдено" echo echo " ── ЧТО ДЕЛАТЬ ──" cat <<'HELP' 1. Вставьте флешку в USB-порт сервера (или в компьютер, если будете копировать иначе) 2. Запустите этот скрипт снова ЕСЛИ ФЛЕШКА НЕ ОПРЕДЕЛЯЕТСЯ: dmesg | tail -20 — посмотреть, увидел ли сервер lsblk — список всех устройств ЕСЛИ СЕРВЕР БЕЗ USB ИЛИ ДАЛЕКО: скопируйте ключ другим способом, например: scp root@192.168.1.10:/root/.buryan-age-key . и перенесите на флешку с компьютера HELP exit 0 fi echo echo "═══════════════════════════════════════════════════════════" echo " 3. ВЫБОР ФЛЕШКИ" echo "═══════════════════════════════════════════════════════════" echo echo " ⚠️ ВНИМАНИЕ: скрипт КОПИРУЕТ файлы на флешку." echo " Он НЕ стирает флешку, но на ней должно быть место." echo read -rp " Введите имя устройства (например sdb): " DEV DEV=$(echo "$DEV" | tr -d ' /dev') if [ -z "$DEV" ]; then echo " ❌ ничего не введено" exit 1 fi if [ ! -b "/dev/$DEV" ]; then echo " ❌ устройства /dev/$DEV нет" exit 1 fi SIZE=$(lsblk -dno SIZE "/dev/$DEV" 2>/dev/null) echo " выбрано: /dev/$DEV ($SIZE)" echo echo " ── разделы на устройстве ──" lsblk -o NAME,SIZE,FSTYPE,LABEL,MOUNTPOINT "/dev/$DEV" 2>/dev/null | sed 's/^/ /' # Ищу первый раздел с файловой системой PART="" for p in /dev/${DEV}1 /dev/${DEV}p1 /dev/${DEV}2 /dev/${DEV}p2; do [ -b "$p" ] || continue FS=$(lsblk -no FSTYPE "$p" 2>/dev/null | head -1) [ -n "$FS" ] && { PART="$p"; break; } done if [ -z "$PART" ]; then echo echo " ⚠️ на устройстве нет раздела с файловой системой" echo " Возможно, флешка не размечена или не отформатирована." echo echo " ── ФОРМАТИРОВАТЬ НЕ БУДУ (это опасно без вашего решения) ──" echo " Если флешка пустая и её надо подготовить:" echo " mkfs.ext4 /dev/$DEV (ВНИМАНИЕ: сотрёт всё)" echo " или отформатируйте на компьютере в FAT32/exFAT" exit 1 fi echo echo " ✅ найден раздел: $PART" echo echo "═══════════════════════════════════════════════════════════" echo " 4. ПОДКЛЮЧАЮ ФЛЕШКУ" echo "═══════════════════════════════════════════════════════════" mkdir -p "$MOUNT" CUR=$(findmnt -no TARGET "$PART" 2>/dev/null) if [ -n "$CUR" ]; then echo " уже подключена: $CUR" TARGET="$CUR" else FS=$(lsblk -no FSTYPE "$PART" 2>/dev/null | head -1) case "$FS" in vfat|exfat|ntfs) OPTS="rw,uid=0,gid=0,umask=022" ;; *) OPTS="rw" ;; esac if mount -o "$OPTS" "$PART" "$MOUNT" 2>/dev/null; then echo " ✅ подключена в $MOUNT" TARGET="$MOUNT" else echo " ❌ не удалось подключить" echo " Попробуйте вручную: mount $PART $MOUNT" exit 1 fi fi echo echo " ── место на флешке ──" df -h "$TARGET" 2>/dev/null | tail -1 | sed 's/^/ /' echo echo "═══════════════════════════════════════════════════════════" echo " 5. СОЗДАЮ ПАПКУ И КОПИРУЮ" echo "═══════════════════════════════════════════════════════════" DST="$TARGET/BURYAN-KEY" mkdir -p "$DST" echo " папка: $DST" # --- Ключ --- cp "$KEY_FILE" "$DST/age-key.txt" chmod 600 "$DST/age-key.txt" 2>/dev/null echo " ✅ age-key.txt" # --- Контрольная сумма --- sha256sum "$DST/age-key.txt" | sed "s|$DST/||" > "$DST/age-key.sha256" echo " ✅ age-key.sha256 (для проверки)" # --- Отпечаток --- { echo "Отпечаток ключа: ${FP:0:24}..." echo "Полная контрольная сумма файла: $KEYSUM" echo "Создано: $(date '+%d.%m.%Y %H:%M')" } > "$DST/fingerprint.txt" echo " ✅ fingerprint.txt" # --- Инструкция --- cat > "$DST/ПРОЧТИ-МЕНЯ.txt" <<'READMEEOF' ╔══════════════════════════════════════════════════════════╗ ║ КЛЮЧ ШИФРОВАНИЯ СЕКРЕТОВ ХОЗЯЙСТВА BURYAN HUB ║ ╚══════════════════════════════════════════════════════════╝ ЧТО ЭТО ─────── Файл age-key.txt — ключ, которым зашифрованы ВСЕ секреты домашнего сервера: * пароль центральной базы данных (40 баз) * доступы к единому входу Authentik * токены ботов Matrix и Telegram * ключ шифрования резервных копий * секрет прокси Telegram БЕЗ ЭТОГО КЛЮЧА СЕКРЕТЫ НЕ РАСШИФРОВАТЬ. Держите флешку в надёжном месте, ОТДЕЛЬНО от сервера. КОГДА ЭТО ПОНАДОБИТСЯ ────────────────────── * сервер вышел из строя и надо восстановить доступы * забыли пароль базы данных * переустанавливаете хозяйство * надо передать дело другому человеку КАК ВОССТАНОВИТЬ ──────────────── 1. Скопировать ключ на сервер: cat > /root/.buryan-age-key << 'KEYEOF' (содержимое файла age-key.txt) KEYEOF chmod 600 /root/.buryan-age-key 2. Положить туда, где программа его ищет: mkdir -p /root/.config/sops/age cp /root/.buryan-age-key /root/.config/sops/age/keys.txt chmod 600 /root/.config/sops/age/keys.txt 3. Проверить, что работает: sops -d /root/buryan-infra/ops/secrets-enc/secrets.yaml Должны появиться значения (не ошибка). ПРОВЕРКА ПОДЛИННОСТИ ──────────────────── Сравните отпечаток в файле fingerprint.txt с тем, что получается из ключа: grep -oE 'age1[a-z0-9]+' age-key.txt | head -1 Или проверьте контрольную сумму: sha256sum -c age-key.sha256 ГДЕ ЕЩЁ ЛЕЖИТ ЭТОТ КЛЮЧ ─────────────────────── 1. На сервере: /root/.buryan-age-key 2. В Vaultwarden: заметка «Buryan Hub — КЛЮЧ ШИФРОВАНИЯ СЕКРЕТОВ» 3. Здесь: эта флешка ПРАВИЛО: ключ и зашифрованные данные — В РАЗНЫХ МЕСТАХ. Если ключ лежит рядом с зашифрованным файлом — шифрование не имеет смысла. ЧТО НЕЛЬЗЯ ДЕЛАТЬ ───────────────── ✗ Не храните флешку рядом с сервером (пожар, кража, затопление) ✗ Не выкладывайте содержимое в интернет, почту, мессенджеры ✗ Не делайте фото ключа на телефон с облачной синхронизацией ✗ Не переформатируйте флешку, не проверив, что копия есть ✓ Храните в другом помещении или у близкого человека ✓ Периодически проверяйте, что флешка читается ✓ После смены ключа — обновите копию на флешке ЕСЛИ ФЛЕШКА ПОТЕРЯЛАСЬ ────────────────────── Доступы НЕ скомпрометированы сами по себе — ключ только расшифровывает файл, а файл лежит на сервере. Но: 1. Ключ из Vaultwarden остаётся рабочим — им можно пользоваться 2. Ключ на сервере тоже на месте 3. Рекомендуется СОЗДАТЬ НОВУЮ копию на новой флешке Создать копию заново: bash put-key-to-usb.sh (на сервере) ╔══════════════════════════════════════════════════════════╗ ║ Buryan Hub — домашнее хозяйство ║ ╚══════════════════════════════════════════════════════════╝ READMEEOF echo " ✅ ПРОЧТИ-МЕНЯ.txt (инструкция по восстановлению)" # --- Что открывает ключ (без значений) --- if [ -s "$SECRETS_FILE" ]; then cat > "$DST/что-открывает-ключ.txt" <<'WHATEOF' Этот ключ открывает файл секретов хозяйства. Файл лежит в репозитории: agent-qwen/buryan-infra ops/secrets-enc/secrets.yaml СОДЕРЖИМОЕ ФАЙЛА (разделы и ключи, БЕЗ ЗНАЧЕНИЙ): WHATEOF echo " ── разделы файла секретов ──" >> "$DST/что-открывает-ключ.txt" SOPS_AGE_KEY_FILE="$KEY_FILE" sops -d "$SECRETS_FILE" 2>/dev/null | \ python3 -c " import sys, yaml try: d = yaml.safe_load(sys.stdin) or {} for sec, vals in d.items(): if isinstance(vals, dict): print(f' {sec}:') for k in vals: print(f' {k}') except Exception: pass " >> "$DST/что-открывает-ключ.txt" 2>/dev/null echo " ✅ что-открывает-ключ.txt" fi echo echo " ── содержимое флешки ──" ls -la "$DST" | sed 's/^/ /' echo echo "═══════════════════════════════════════════════════════════" echo " 6. ПРОВЕРКА КОПИИ" echo "═══════════════════════════════════════════════════════════" echo " ── сравниваю ключи ──" ORIG=$(sha256sum "$KEY_FILE" 2>/dev/null | cut -d' ' -f1) COPY=$(sha256sum "$DST/age-key.txt" 2>/dev/null | cut -d' ' -f1) if [ "$ORIG" = "$COPY" ]; then echo " ✅ КОПИЯ СОВПАДАЕТ С ОРИГИНАЛОМ" printf ' контрольная сумма: %s\n' "${ORIG:0:32}..." else echo " ❌ КОПИИ НЕ СОВПАДАЮТ!" echo " оригинал: ${ORIG:0:32}..." echo " копия: ${COPY:0:32}..." exit 1 fi echo echo " ── проверяю, что ключ с флешки РАБОТАЕТ ──" if [ -s "$SECRETS_FILE" ]; then TEST=$(SOPS_AGE_KEY_FILE="$DST/age-key.txt" sops -d "$SECRETS_FILE" 2>/dev/null | head -1) if [ -n "$TEST" ]; then echo " ✅ КЛЮЧ С ФЛЕШКИ РАСШИФРОВЫВАЕТ СЕКРЕТЫ" echo " (проверено на настоящем файле секретов)" else echo " ⚠️ не удалось проверить расшифровку" fi fi echo echo " ── записываю на диск (сброс буферов) ──" sync echo " ✅ данные записаны" echo echo "═══════════════════════════════════════════════════════════" echo " 7. ОТКЛЮЧАЮ ФЛЕШКУ" echo "═══════════════════════════════════════════════════════════" if [ "$TARGET" = "$MOUNT" ]; then if umount "$MOUNT" 2>/dev/null; then echo " ✅ флешка отключена безопасно" rmdir "$MOUNT" 2>/dev/null else echo " ⚠️ не удалось отключить — возможно, файлы ещё пишутся" echo " Попробуйте: umount $MOUNT" echo " Или: sync && umount $MOUNT" fi else echo " (флешка была подключена в другом месте — не отключаю)" fi rm -f /tmp/usb-fingerprint.txt /tmp/usb-checksum.txt echo echo "═══════════════════════════════════════════════════════════" echo " 8. 🔌 ТЕПЕРЬ ВЫНИМАЙТЕ ФЛЕШКУ" echo "═══════════════════════════════════════════════════════════" cat <<'DONE' ═══════════════════════════════════════════════════════════ ЧТО СДЕЛАНО ═══════════════════════════════════════════════════════════ ✅ Ключ скопирован на флешку ✅ Копия проверена — совпадает с оригиналом ✅ Ключ с флешки ПРОВЕРЕН на расшифровке ✅ Инструкция по восстановлению (ПРОЧТИ-МЕНЯ.txt) ✅ Контрольная сумма и отпечаток ✅ Данные записаны, флешка отключена безопасно ═══════════════════════════════════════════════════════════ ТЕПЕРЬ ВАЖНОЕ — ГДЕ ХРАНИТЬ ═══════════════════════════════════════════════════════════ ХРАНИТЕ ФЛЕШКУ ОТДЕЛЬНО ОТ СЕРВЕРА: * другое помещение * или у близкого человека * или в сейфе ПОЧЕМУ: Если сервер погибнет (пожар, кража, вода) — ключ на сервере погибнет вместе с ним. Флешка в другом месте — спасёт. ПРАВИЛО: ключ и зашифрованные данные — В РАЗНЫХ МЕСТАХ ═══════════════════════════════════════════════════════════ ПРОВЕРЬТЕ ЧЕРЕЗ МЕСЯЦ ═══════════════════════════════════════════════════════════ Флешки портятся. Раз в несколько месяцев: 1. Вставьте флешку 2. Откройте папку BURYAN-KEY 3. Убедитесь, что age-key.txt читается 4. Сверьте отпечаток из fingerprint.txt Если флешка не читается — сделайте новую: bash put-key-to-usb.sh ═══════════════════════════════════════════════════════════ DONE