9 Commits
Author SHA1 Message Date
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
root eb04c58dee VPN: команда самопроверки для семьи — «!vpn check»
Человек не должен угадывать, на каком шаге он застрял. Команда смотрит
со стороны сервера и отвечает коротко: что получилось, что нет и что
делать. Проверил содержимое глазами получателя:

  [да] Доступ выдан, ваш ключ: Buryan-01
  [да] Готовые профили пришли: vpn-akadmin.json, vpn-akadmin.yaml
  [да] Сервер отвечает, связь с ним есть

  Со стороны сервера всё готово. Осталось проверить на телефоне:
    1. Приложение: FlClash (.yaml) либо Hiddify (.json).
    ...
    5. Откройте 2ip.ru — должен показаться 193.233.210.184.

Если чего-то не хватает, называет причину и следующий шаг: нет ключа —
«напишите владельцу»; профилей не видно — «примите приглашение в
комнату»; сервер молчит — «повторите через пару минут».

Важное ограничение, о котором сказано прямо и в коде, и в документе:
команда НЕ проверяет, работает ли VPN на самом телефоне — этого со
стороны сервера не видно. Поэтому последний шаг всегда «проверьте
сами», с точной ссылкой и ожидаемым адресом. Обещать больше, чем
можешь проверить, — верный способ запутать человека.

Работает независимо от того, принял человек приглашение или нет:
комнаты выдачи переведены на видимость «shared», поэтому приглашённый
видит и профили, и ответ на команду.
2026-10-16 21:22:53 +03:00
root a97b00c1eb VPN: раздельная маршрутизация — туннель несёт только домашнее
Задача: часть приложений (банки, госуслуги, маркетплейсы) не работает,
когда весь трафик идёт через VPN. С апреля 2026 крупные российские
сервисы закрывают доступ тем, кто приходит с зарубежного адреса;
рекомендацию дало Минцифры на совещании с 20+ компаниями, срок
назывался до 15 апреля. Приложение Сбербанка, по сообщениям, вообще
не запускается при включённом VPN.

Причина не в туннеле, а в том, ЧТО через него идёт. Значит решение —
маршрутизация, а не ручные переключения.

Что сделано:

* ops/vpn/gen-split-routing.py — собирает файлы маршрутизации из ОДНОГО
  списка домашних доменов (27 адресов). Если вести списки порознь,
  они разойдутся, и придётся искать, почему одна служба не открывается;
* ops/vpn/split/ — собранное: home-domains.txt, rules-clash.yaml,
  client-routing.json (для Xray-клиентов);
* ops/vpn/split-profile-android.yaml — готовый профиль для Android:
  список приложений через туннель, домашние домены в туннель,
  всё остальное напрямую;
* docs/VPN-SPLIT-ROUTING.md — как настроить обоими способами;
* docs/VPN-APP-CONFLICTS.md — понятным языком, почему ломается и что
  именно перестало работать, со ссылками на открытые источники.

Проверено на живом клиенте (xray 25.3.6, тот же клиент, что в телефоне),
результат виден в журнале:

  accepted tcp:git.buryans.ru:443   [proxy]   <- домашнее, в туннель
  accepted tcp:ip-api.com:80        [direct]  <- прочее, напрямую
  accepted tcp:www.sberbank.ru:443  [direct]  <- российское, напрямую

Конфиг проходит xray run -test (Configuration OK), профиль YAML
разбирается, порядок правил проверен скриптом.

Две грабли, найденные по ходу и записанные в документ:

1. Порядок правил решает. Первая версия начиналась с правила «всё
   российское и весь buryans.ru — напрямую», а buryans.ru это и есть
   наши домашние службы: широкое правило перехватило бы их раньше
   узкого, и домашние домены ушли бы мимо туннеля. Домашнее правило
   обязано стоять выше.
2. Без sniffing правила по домену не работают: клиент видит только
   IP, имя уже разрешено. Поэтому включены sniffing с destOverride
   и domainStrategy IPIfNonMatch.

Граница, которую обозначил владельцу прямо: вывод приложения из туннеля
— это штатная настройка Android, её я делаю. Подмену проверки «есть ли
на телефоне VPN» я не делаю: это уже не маршрутизация, а обман
проверки, и такое приложение честнее вынести из туннеля или настроить
ему прокси в самом приложении.

Ключей в коммите нет: в профиле стоит подстановка <ВАШ-UUID>,
свой ключ человек берёт из своей комнаты в Matrix.
2026-10-16 21:09:00 +03:00
root de65cc088a VPN: выдача доступа новому человеку одной командой админа
Владельцу нужна была одна команда, чтобы выдать профиль новому
участнику без ручной сборки QR и без пересылки ключей в мессенджерах.

Добавлено:
  !vpn give @логин      — выдать свободный ключ
  !vpn give @логин 08   — выдать конкретный ключ
  !vpn list             — что выдано, что свободно

Доступно только владельцу (@akadmin, @comms_agent); обычному человеку
бот отвечает отказом и пишет попытку в журнал.

Профиль уходит ЛИЧНО получателю: бот заводит с ним личную комнату,
приглашает и отправляет QR и ссылку. Владельцу приходит подтверждение,
что и кому выдано, и это же пишется в состояние (given_by, key).

Два вывода, которые дала проверка на живом получателе:

1. Видимость истории. Первый прогон создал комнату с history_visibility
   "joined". Бот отчитался "отправлено", но получатель — а он в тот
   момент ещё только приглашён — не увидел НИЧЕГО: с этой видимостью
   видны только сообщения после вступления. Исправлено на "shared",
   проверено на новой комнате: приглашённый видит профиль сразу.
   Это выяснилось проверкой, а не из документации.

2. Права бота. Бот не серверный админ: заводить и деактивировать
   учётные записи в Matrix он не может (403). Поэтому !vpn give создаёт
   только комнату, а учётную запись человеку заводит владелец. Записано
   в документации, чтобы это не выглядело недоделкой.

Проверено по-настоящему: временный человек заводился в Matrix, получал
ключ Buryan-10, принимал приглашение и видел у себя картинку QR и
ссылку. Обычному человеку на "!vpn 04" приходит отказ.

Уборка после проверки: временные люди и их комнаты удалены из базы
(пользователей снова 21, событий временных комнат 0). Комнаты чистились
с обнулением зависимостей — event_edges держал события круговой ссылкой.
2026-10-16 20:59:11 +03:00
root cd2657b2f8 VPN: проверка «канал работает» в наблюдении + команда !vpn link
Задача 4.2 из реестра: проверка «VPN работает» в наблюдении. Сделано.

Почему отдельная проверка: порт 10443 может слушать, а трафик не
проходить — именно это мы уже видели, когда провайдер вмешивался
в поток. Открытый порт об этом не говорит.

Как проверяется (ops/vpn/vpn-check.sh): поднимается временный клиент
xray на самом VPS, идёт через него в интернет, сверяется внешний адрес.
Совпал — канал пропускает трафик. За собой убирает. Ключ берётся из
рабочей конфигурации xray, а не из файла со ссылками: тот файл лежит
на домашнем узле, а проверка идёт на VPS.

Встроено в /opt/buryan-hub/scripts/check-services.sh (функция check_vpn),
вызывается каждые 5 минут вместе с остальными проверками, провал
попадает в общую тревогу в Matrix.

Порт 2087 (Reality) намеренно не проверяется: он не работает и занесён
в план задачами VPN-2.3, иначе тревога была бы каждые 5 минут.

Проверено отдельным запуском только новой функции, без полного цикла
наблюдения (чтобы не поднять ложную тревогу): код 0, PASSED=1.

Отдельно: команда !vpn link для настройки на самом телефоне. QR с того
же экрана не считать, а ссылку из сообщения можно скопировать и вставить
в приложение. Проверены варианты !vpn link, !VPN LINK, !vpn ссылка,
а также отказ на чужой ключ и молчание на обычный текст.
2026-10-16 20:53:09 +03:00
root 022067e636 VPN: бот выдачи профилей по запросу + рассылка семье
Рассылка: профили отправлены всем шестерым, каждому в свою приватную
комнату. Проверено --verify: у всех вход только по приглашению, у всех
картинка QR скачивается целой (1759-1872 байта, сигнатура PNG верна).

Бот (ops/vpn/matrix-vpn-bot.py, служба matrix-vpn-bot):
  !vpn        -> свой профиль
  !vpn help   -> подсказка
  !vpn 08     -> владельцу: указанный ключ
  !vpn 04     -> не владельцу: ОТКАЗ

Ответ уходит ЛИЧНЫМ сообщением, а не в комнату. Это условие безопасности:
ключ - это доступ, и он не должен оказаться в комнате, куда потом
добавят третьего человека. Свой профиль выдаётся только по своему
Matrix-логину, чужой запросить нельзя.

Проверено самопроверкой: владелец получил запасной ключ, обычный
пользователь получил отказ (отказ записан в журнал), свой профиль
и подсказка работают.

Три случая, которые чуть не сломали работу:
1. Synapse ответил 429 на первую рассылку - она оборвалась на середине,
   двое получили комнату без инструкции, состояние не сохранилось.
   Исправлено: 429 пережидается по retry_after_ms, состояние пишется
   после каждого человека, признак delivered не даёт дублировать
   отправку. Комнаты, созданные до падения, восстановлены по псевдониму
   #vpn-<логин>, а не пересозданы.
2. При первом запуске /sync отдаёт последние события комнат - бот
   обработал бы старые команды заново после каждого перезапуска.
   Исправлено: первый запуск только берёт точку отсчёта.
3. Личные комнаты хранились в одном файле с точкой отсчёта и затирались
   на каждом круге. Вынесены в отдельный файл.

Бот не слушает "Семью" и тревоги, не отвечает профилем в комнату
и не отдаёт чужой профиль никому, кроме двух админов Matrix.
2026-10-16 20:44:05 +03:00
root 60ff4ac324 VPN: раздача профилей через Matrix — комната на каждого человека
По решению владельца профили выдаются не только страницей, но и в Matrix:
Matrix свой, ключи не уходят на чужие серверы, и человек получает профиль
там, где он и так общается с семьёй.

Добавлено:
* ops/vpn/matrix-distribute.py — заводит приватную комнату НА КАЖДОГО
  человека, приглашает его, отправляет картинку QR, ссылку текстом на
  случай несчитанного кода и инструкцию;
* режимы: план (по умолчанию), --send, --send --only <логин>, --verify.

Почему комната на каждого, а не общая "Семья": в общей комнате ключи
видны всем сразу, и тогда нельзя отозвать доступ одному, не задев
остальных. Ради отзыва по одному мы и заводили отдельные ключи.

Проверено на akadmin: комната "VPN - Роман" создана, получатель вошёл,
вход только по приглашению, картинка скачивается целой (1759 байт,
сигнатура PNG верна), текстов два. Режим --verify делает эту проверку
повторяемой.

Попутно выяснено и записано в документы:
* комната "Семья" содержит участников @telegram_<id> — там люди из
  Telegram-моста, поэтому профили туда не кладём;
* portal в базе моста пуст — комната, похоже, в Telegram не зеркалится;
* этот Synapse отдаёт медиа только по /_matrix/client/v1/media/download,
  старые media/v3 и media/r0 дают 404 (ложный признак потери файла);
* @akadmin — админ, но устройств не зарегистрировано;
* E2EE в этих комнатах не включён.

Ждёт решения владельца: класть ли профили в комнату, зеркалящуюся
в Telegram (тогда ключи попадут на серверы Telegram). До решения
раздача семье не запускается — её будет не откатить без смены ключей.
2026-10-16 20:36:40 +03:00
root 1eb6494f5d VPN этап 1: мобильный доступ — ключи, профили, инструкция для семьи
Задача: docs/TASKS.md -> раздел VPN, Этап 1 (приоритет 3 из
docs/AUDIT-2026-10-17.md, часть 6).

Сделано:
* ключей 5 -> 10 (buryan-06..10 во все три входящих: 10443, 2087, 2053);
  существующие user1..user5 не тронуты — их могли уже использовать;
* у каждого ключа своё имя: раздаём и отзываем доступ по одному,
  не ломая остальных;
* приватная страница с QR-кодами и инструкцией (скрытый путь + пароль,
  на существующем домене — новых записей в DNS не потребовалось);
* инструкция для семьи простым языком: приложение, импорт, проверка,
  раздел "если не подключается";
* отдельно вынесено предупреждение про встроенный браузер MIUI —
  это и была причина, по которой Сергей не мог войти.

Проверено (не на словах):
* xray run -test -> Configuration OK
* новый ключ реально выходит через VPS — и с самого сервера, и снаружи
* устойчивость: 10 подключений из 10
* QR-коды прочитаны независимым декодером (zxing), ссылки совпадают
* страница: 200 с паролем, 401 без пароля; Gitea не затронута (200)

Разбор ложной тревоги: записи "invalid request version" в журнале
оказались чужими проверками порта, а не нашей поломкой. Вывод в отчёт:
не считать канал сломанным по одной неудаче.

Осталось: VPN-1.3 — проверка на телефонах Сергея и AlexTest (нужны
устройства), затем VPN-1.4 — раздача остальным.

Отчёт: ops/vpn/VPN-STAGE1-IMPLEMENTATION.md
2026-10-16 20:30:42 +03:00
root e9de479e49 Infrastructure: nginx/headscale configs + docs + DR script + auto-sync 2026-09-23 16:09:15 +03:00