Files
buryan-infra/docs/TASKS.md
T
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

13 KiB
Raw Blame History

РЕЕСТР ЗАДАЧ

Ведётся по разделам плана. Порядок: обновления → сеть → звонки → связность → службы. Отдельным разделом — VPN (по решению от 17.10.2026).

1. ЗАВЕРШИТЬ ОБНОВЛЕНИЯ

№ Задача Состояние
1.0 Профиль безопасности: причина найдена, Matrix исправлен ✅
1.1 Применить профиль в остальных контейнерах (по одному, безопасно) ⬜
1.2 Вынести профиль в общее управление (один источник правды) ⬜
1.3 Обновить paperless ⬜
1.4 Обновить gitea ⬜
1.5 Обновить authentik ⬜
1.6 Обновить postgres-rbac ⬜
1.7 Автоматически убирать контейнеры-остатки ⬜

2. СЕТЬ И ДОСТУП

№ Задача Состояние
2.0 Причина медленного входа найдена (7,86 с вместо 0,02 с) ✅
2.1 Кэш на VPS для файлов страницы входа ⬜
2.2 Локальный NGINX вместо NPM (файлы подготовлены) ⬜
2.3 AdGuard: DNS и домены ✅ работает, 43 из 43 домена
2.4 Настроить все 44 домена (сейчас 12) ⬜
2.5 Один сертификат *.buryans.ru ⬜
2.6 Определить роль VPS (кэш, резерв или иное) ⬜

3. ЗВОНКИ И МЕДИА

№ Задача Состояние
3.1 Element Call: настроить транспорт звонков ⬜ отдельная
3.1.1 Указать LiveKit в настройках Synapse ⬜
3.1.2 Объявить транспорт в .well-known ⬜
3.1.3 Задать ключи связки Synapse и LiveKit ⬜
3.2 Свести медиаслужбы к единому входу и правам ⬜

4. СКВОЗНАЯ СВЯЗНОСТЬ

№ Задача Состояние
4.1.1 Все домены под единый вход (22 приложения из 44 доменов) ⬜
4.1.2 Права по группам ⬜
4.2.1 Все службы шлют через общий слой 🔶 частично
4.3.1 Все 28 служб в наблюдение ⬜
4.3.2 Проверять «работает», а не «отвечает» 🔶 частично
4.3.3 Отдельная проверка: вход работает ⬜
4.4.1 Снимки перед изменениями ✅
4.4.2 Проверка восстановления из копий 🔶 проверено для конфигураций VPN
4.4.3 Копии наружу ⬜
4.5.1 Проверка «образ запускается» до обновления ⬜
4.5.2 Различать «обновлено» и «уже актуально» ⬜
4.6.1 Карта хозяйства: служба → контейнер → домен → вход ⬜

5. УЛУЧШЕНИЕ СЛУЖБ

№ Задача Состояние
5.1 authentik — ускорить, разобраться с медленной загрузкой ⬜
5.2 headscale дома — определить назначение (координацию держит VPS) ⬜
5.3 paperless — выбрать один из двух экземпляров ⬜
5.4 immich — свести базу в общий PostgreSQL ⬜
5.5 uptime-kuma — перевести на PostgreSQL или заменить ⬜
5.6 sonarr/radarr/prowlarr — проверить запись в базы ⬜
5.7 npm — решить судьбу (заменяется на NGINX) ⬜
5.8 dashy — сделать стартовой страницей со ссылками на всё ⬜
5.9 openclaw — определить назначение ⬜
5.10 prometheus/grafana — правила тревог и панели на все службы ⬜

6. VPN

Раздел введён 17.10.2026 — по аудиту это задача первоочередная: без VPN доступ снаружи непредсказуем.

Этап 1. Мобильный доступ

№ Задача Состояние
1.1 Удобный профиль для телефонов (ключей 10, QR на каждого) ✅
1.2 Инструкция для семьи (docs/VPN-FOR-FAMILY.md) ✅
1.3 Проверить на телефонах Сергея и AlexTest 🔶 ждёт устройств
1.4 Раздать остальным ✅ выдано всем шестерым
1.7 Выдать готовые профили с раздельной маршрутизацией ✅ доставлено и проверено
1.6 Выдача доступа новому человеку одной командой админа ✅ !vpn give @логин
1.5 Разместить ссылки в Vaultwarden ⬜
1.8 Ключ age: файл с ключом и инструкцией передан владельцу 🔶 ждёт записи в Vaultwarden и на флешку

Этап 2. Больше протоколов

№ Задача Состояние
2.1 Добавить Hysteria2 на VPS (QUIC, для видео) ✅ проверено снаружи
2.2 Добавить VLESS + XHTTP (маскировка под сайт) ✅ проверено снаружи
2.3 Довести Reality — найти причину (порты 2087, 2053) ✅ проверено снаружи
2.4 Подписка с несколькими профилями ✅ проверено
2.5 Раздельная маршрутизация: туннель несёт только домашнее ✅
2.6 Приложения, которые не любят VPN — вывести из туннеля ✅ способ описан

Этап 3. Шлюз в доме

№ Задача Состояние
3.1 Поднять шлюз на отдельном CT ✅ CT 161, туннель (DNS перенесён в AdGuard)
3.2 Проверить на одном устройстве ✅ 10 мс против 485
3.3 Правило на Keenetic → шлюз ⬜ вместе с владельцем
3.4 Подключить семью (телевизоры, телефоны) 🔶 шлюз готов, нужна настройка устройств

Что сделано по VPN Этапу 3 (шлюз в доме)

* CT 161 (192.168.1.161) с DNS: 43 домашних домена -> 192.168.1.10
* замерено: 10 мс напрямую против 485 мс через VPS (в 50 раз)
* проверено на реальном устройстве, обычный интернет не сломался
* роутер НЕ тронут (по указанию владельца)
* подробности: docs/VPN-STAGE3.md

Этап 4. Надёжность

№ Задача Состояние
4.1 Второй шлюз ⬜
4.2 Проверка «VPN работает» в наблюдении ✅
4.3 Сводка: кто реально пользуется VPN ✅ vpn-usage.py
4.4 Убрать отладку из журнала xray (рос 371 МБ) ✅
4.5 Копия конфигурации xray с ключами + проверенное восстановление ✅ зашифрована

Что сделано по VPN 17.10.2026

* ключей 5 -> 10, у каждого своё имя Buryan-01..10
* приватная страница с QR-кодами и инструкцией (закрыта паролем)
* инструкция для семьи: docs/VPN-FOR-FAMILY.md
* проверено: новый ключ выходит через VPS, 25 попыток из 25
* раздача через Matrix: приватная комната на каждого человека,
  скрипт ops/vpn/matrix-distribute.py, проверено на akadmin
* отчёт: ops/vpn/VPN-STAGE1-IMPLEMENTATION.md

Ждёт решения владельца

* класть ли профили в комнату, зеркалящуюся в Telegram:
  тогда ключи попадут на серверы Telegram
* модели телефонов Сергея и AlexTest — для точной инструкции
* когда удобно провести проверку на телефонах (VPN-1.3)

Что сделано по VPN Этапу 2

* Hysteria2 поднят на VPS (UDP 10443), проверен снаружи:
  напрямую выходим как 46.8.140.22, через Hysteria2 — 193.233.210.184
* VLESS + XHTTP добавлен (TCP 8444, путь /buryan-xhttp), проверен снаружи:
  через него выходим как 193.233.210.184, домашние службы и YouTube — 200
* итого рабочих каналов: четыре (VLESS+TLS, Hysteria2, XHTTP, Reality)
* открыт UDP-порт в экране VPS (правила сохранены, выживут перезагрузку)
* конфигурации xray и Hysteria2 теперь копируются зашифрованно
  (ops/secrets-enc/vpn-configs.json), восстановление проверено

Найдено при настройке Hysteria2

* репозиторий Hysteria переехал: был apernet/hysteria, стал
  HyNetworks/hysteria — со старого адреса версия читается неверно;
* в экране VPS правило было только для TCP 10443, а для UDP — нет:
  при политике DROP снаружи канал был бы недоступен, хотя на
  сервере работал бы. Проверять надо СНАРУЖИ, а не только «слушает»;
* у Hysteria свой формат конфигурации, отдельного «test» нет —
  проверяю пробным запуском и проверкой, что порт слушает.

7. РЕЕСТР НАЙДЕННЫХ ПРОБЛЕМ

№ Проблема Состояние
1 Профиль запрещал создание сокетов ✅ решено (Matrix)
2 Профиль нужен в каждом контейнере ⬜
3 13 контейнеров-остатков 🔶 остановлены
4 Счётчики номеров ✅ решено (10 баз)
5 Gitea не создавала задачи ✅ решено
6 Headscale падал 2,7 суток ✅ решено
7 Уведомления шли в AUTH ✅ решено
8 Версия не в уведомлении ✅ решено
9 Страница входа 7,86 с 🔶 причина найдена
10 44 домена, настроено 12 ⬜
11 Element Call не работает ⬜ отдельная
12 Одна дверь (VPS) ⬜
13 Два экземпляра paperless ⬜
14 Immich вне общего PostgreSQL ⬜
15 Доступ снаружи непредсказуем (провайдер) 🔶 четыре канала + автопереключение
16 Reality не проходил рукопожатие ✅ причина: недоступный сайт-прикрытие; заменён на свой
17 Встроенный браузер MIUI не видит домашние адреса ✅ причина найдена, решение: Chrome/Firefox

Обозначения: ✅ сделано · 🔶 частично · ⬜ не начато

Запасной простой профиль (17.10.2026)

По жалобе «VPN бьётся по таймауту» проверено всё: сервер цел, профиль
цел (177 российских зон, 27 домашних). Найдена РАЗОВАЯ ошибка
соединения — канал иногда не устанавливается с первого раза.

Добавлен запасной профиль vpn-<имя>-simple.yaml: один проверенный канал
и те же правила. Лежит на странице в разделе «Запасной простой профиль».

Найден дефект в собственном сборщике: группа называлась так же, как
канал, и движок отвергал ВЕСЬ профиль («loop is detected in
ProxyGroup»). Исправлено.