Files
buryan-infra/docs
root f9e46ab664 Ключ age: проверка годности, документация, файл для владельца
Задача №22 аудита. Суть не в «положить в Vaultwarden», а в том, что без
ключа зашифрованные копии бесполезны: файл есть, прочитать нечем.

ЧТО СДЕЛАНО:
* добавлен ops/vpn/verify-age-key.sh — проверка «ключ ГОДЕН», а не
  «ключ есть». Ошибка в одном символе иначе обнаружится только в момент
  восстановления, когда уже поздно. Скрипт проверяет: ключ на месте и с
  правами 600; секретный ключ ровно один; публичный совпадает с тем, на
  который шифровали; копии ДЕЙСТВИТЕЛЬНО расшифровываются; ключа нет в
  файлах и в истории Git; копии есть на другом хосте;
* docs/AGE-KEY-AND-RESTORE.md — что ключ открывает, где должен жить
  (сервер + Vaultwarden + флешка, ключ отдельно от данных), как
  восстановить;
* файл с ключом и пошаговой инструкцией подготовлен и передан владельцу
  для скачивания.

РЕЗУЛЬТАТ ПРОВЕРКИ: ключ годен. Расшифровываются обе копии —
vpn-configs.json (40 ключей клиентов) и xray-config.json (30). Права 600.
Публичный ключ совпадает с .sops.yaml. В Git ключа нет: ни в файлах, ни
в истории коммитов. На VPS лежат 2 зашифрованные копии.

ПОЧЕМУ КЛЮЧ НЕ ДОБАВЛЕН В VAULTWARDEN МНОЮ: Vaultwarden шифрует записи
клиентским мастер-паролем. Мастер-пароля у меня нет — и это правильно.
Добавить запись программно можно только с ним или с личным ключом API;
просить их я не буду. Записать в Vaultwarden и на флешку — действие
владельца.

ГРАБЛИ (мои): проверка нашла саму себя. Скрипт искал строку
AGE-SECRET-KEY-1, а она есть в нём же как образец для поиска — вышло
ложное «ключ попал в репозиторий». Искать надо КОНКРЕТНОЕ значение
ключа, а не его начало. Исправлено. Тот же класс ошибки уже был с URL
приватной комнаты: проверка совпадала сама с собой.
2026-10-17 11:16:32 +03:00
..

buryan-hub — описание хозяйства

Документы

Документ О чём
PLAN.md Полный план развития: что делаем и в каком порядке
TASKS.md Реестр задач с отметками о состоянии
NIGHT-JOURNAL.md Журнал работ: что и как проверено
NIGHT-REPORT.md Итоговый отчёт по спринту
DATABASE-STANDARD.md Правила работы с базами
COMMANDS.md Справочник команд ботов

Порядок работ

1. Завершить обновления    (4 службы)
2. Сеть и доступ           (вход, DNS, VPS)
3. Звонки и медиа          (Element Call)
4. Сквозная связность      (единый вход, уведомления, наблюдение)
5. Улучшение служб         (по каждой)

Правила работы

Десять правил, выведенных по ходу спринта — часть на своих ошибках. Полный список: PLAN.md, раздел 7.

Главные:

  1. Проверяй записью, а не чтением.
  2. Состояние службы — по живому процессу, а не по состоянию в системе.
  3. Пустой список — это неудача.
  4. Проверяй на настоящих данных.
  5. Никогда не перезапускай Docker массово.
  6. Сбой шага — верни состояние и иди дальше.
  7. Не удаляй без проверенной копии.