НАЙДЕНО И ЭТО БЫЛО ОПАСНО: боевая конфигурация 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 и на флешке). Это и есть
правило из аудита: ключ и зашифрованные данные — в разных местах.
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.
Главные:
- Проверяй записью, а не чтением.
- Состояние службы — по живому процессу, а не по состоянию в системе.
- Пустой список — это неудача.
- Проверяй на настоящих данных.
- Никогда не перезапускай Docker массово.
- Сбой шага — верни состояние и иди дальше.
- Не удаляй без проверенной копии.