Files
buryan-infra/docs
root 633f580803 VPN: сохранность ключей — зашифрованная копия и восстановление
НАЙДЕНО И ЭТО БЫЛО ОПАСНО: боевая конфигурация xray с ключами жила
ТОЛЬКО на VPS.
  * в репозитории лежала копия от 23.09: 1 клиент вместо 10;
  * в резервное копирование (restic) VPS не входит вовсе.

Значит при гибели VPS все ключи пропали бы, и пришлось бы перевыпускать
доступ всей семье заново, обходя каждого. Это дороже, чем сделать копию.

Что теперь есть:
  * ops/secrets-enc/xray-config.json — копия для восстановления,
    зашифрована SOPS + age (правило уже было настроено на этот путь);
  * vps/xray/config.json — обезличенная копия: структура без ключей,
    её можно читать кому угодно;
  * /root/xray-config-encrypted.json на VPS — вторая копия, на другой
    машине.

Копия проверена, а не просто создана: скрипт расшифровывает её обратно и
сверяет СОДЕРЖИМОЕ (входящие, клиентов, ключи, настройки). Сверка
побайтовая не годится: SOPS при расшифровке пересобирает JSON, и порядок
ключей может отличаться. Результат: содержимое совпадает полностью,
30 ключей в 3 входящих.

Восстановление: ops/vpn/vpn-restore-config.sh. Без ключа --apply ничего
не пишет — только расшифровывает и показывает. С --apply делает копию
текущего файла, пишет на VPS и проверяет, что канал после этого работает.

Отдельно записано в документе: локально проверить конфигурацию НЕЛЬЗЯ,
потому что в ней пути к файлам сертификатов, а они только на VPS. Попытка
проверить на домашнем узле даёт ложную ошибку "failed to parse
certificate", и это не признак порчи копии. Скрипт об этом предупреждает
вместо того, чтобы пугать зря.

Восстановление невозможно без ключа шифрования age
(/root/.buryan-age-key, он же в Vaultwarden и на флешке). Это и есть
правило из аудита: ключ и зашифрованные данные — в разных местах.
2026-10-16 21:31:00 +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. Не удаляй без проверенной копии.