Files
buryan-infra/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md
T
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

19 KiB
Raw Blame History

VPN Этап 1 — мобильный доступ: что сделано

Дата: 17.10.2026 Задача: docs/TASKS.md → VPN Этап 1 (VPN-1.1 … VPN-1.4), приоритет №3 из docs/AUDIT-2026-10-17.md (часть 6, «что дальше»). Исполнитель: сессия агента. Состояние: техническая часть выполнена и проверена; осталась проверка на телефонах Сергея и AlexTest (VPN-1.3) — нужны их устройства.


1. Задача и зачем

Аудит зафиксировал три случая, когда доступ снаружи не сработал (AlexTest вошёл только через VPN; Сергей не мог войти из встроенного браузера; разные устройства шли разными путями). Вывод аудита: без VPN доступ снаружи непредсказуем.

Этап 1 — самый нужный и самый безопасный: дать телефонам рабочий профиль и понятную инструкцию, не меняя ничего в существующей сети.

2. Состояние до работы (проверено, а не принято на веру)

Что проверил Чем Результат
Служба xray на VPS systemctl, ss -tlnp работает, слушает 10443, 2087, 2053
Конфигурация xray run -test Configuration OK
Сертификат git.buryans.ru openssl x509 Let's Encrypt, до 21.12.2026
Порты снаружи TCP-проверка 10443, 2087, 2053, 9443, 443 доступны
Канал реально работает xray-клиент + api.ipify.org выход через 193.233.210.184 подтверждён
Экран VPS iptables -S INPUT порты 10443/2087/2053/9443 открыты

Ключей было 5, все с безымянными метками user1…user5.

3. Что изменено

3.1 Ключей стало 10 (VPN-1.1)

Добавлены клиенты buryan-06 … buryan-10 во все три входящих (10443, 2087, 2053) — на случай, если Reality заработает, ключи уже будут.

Существующие user1…user5 не тронуты намеренно: их могли уже где-то использовать, переименование сломало бы настроенное.

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

3.2 Приватная страница с профилями (VPN-1.1 + VPN-1.2)

Что Значение
Адрес https://git.buryans.ru/p/<секрет>/
Защита базовый пароль (APR1) + скрытый сегмент пути + noindex
Содержимое 10 QR-кодов, инструкция для Android и iPhone, раздел «если не подключается»
Доступы /root/.buryan-vpn-page (600) на VPS

Почему на git.buryans.ru, а не на отдельном домене: домен уже указывает на VPS, сертификат действует, новых записей в DNS (зона ведётся вручную в панели Beget) и новых сертификатов не потребовалось. Скрытый путь + пароль закрывают доступ; сам домен для постороннего выглядит как обычный git-сервер.

В nginx добавлен один блок location в существующий сервер git.buryans.ru. Основной location / (проксирование Gitea) не тронут — проверено, что Gitea отвечает 200 после правки.

3.3 Инструкция для семьи (VPN-1.2)

docs/VPN-FOR-FAMILY.md — простым языком: приложение → QR → подключение → проверка. Отдельно вынесено предупреждение про встроенный браузер MIUI (это и была причина, по которой Сергей не мог войти) и раздел «если не подключается» с пошаговым разбором.

4. Проверка (что именно и чем)

Проверка Способ Результат
Конфигурация после правки xray run -test Configuration OK
Все три порта слушают ss -tlnp 10443, 2087, 2053 ✅
Клиентов ровно 10 разбор конфига скриптом 10 10 10 ✅
Новый ключ реально проходит xray-клиент с самого VPS выход 193.233.210.184 ✅
Новый ключ снаружи xray-клиент + api.ipify.org выход 193.233.210.184 ✅
Устойчивость канала 10 подключений подряд 10 из 10 ✅
Устойчивость, повторный замер 15 подключений подряд 15 из 15 ✅, отклик 0,5–2,9 с (средний 1,3 с)
QR-коды читаются независимый декодер zxing-cpp 10 из 10, ссылки совпадают ✅
Страница отдаётся curl 200 с паролем, 401 без пароля ✅
QR через nginx curl + проверка сигнатуры PNG 200, файл целый ✅
Страница отрисовалась снимок через DevTools 10 карточек, 10 картинок ✅
Gitea не пострадала curl https://git.buryans.ru/ 200 ✅

Замечание о «сбое», который оказался не сбоем

В середине работы новый ключ дважды не дал ответа, а в журнале VPS появились записи invalid request version. Разбор показал:

  • это чужие подключения к порту 10443 (проверки доступности, curl по HTTPS) — xray ждёт VLESS, а получает HTTP, отсюда «неверная версия»;
  • мои же тесты после этого прошли 10 раз из 10.

Вывод: не делать вывод «сломано» по одной неудаче. Ровно об этом предупреждает аудит (непредсказуемость доступа снаружи).

5. Как откатить

Всё обратимо, копии сохранены.

Что Как вернуть
Конфиг xray cp /usr/local/etc/xray/config.json.before-stage1-clients-* /usr/local/etc/xray/config.json && systemctl restart xray
Конфиг nginx cp /etc/nginx/conf.d/buryans-all.conf.before-vpnpage-* /etc/nginx/conf.d/buryans-all.conf && nginx -t && systemctl reload nginx
Страница rm -rf /var/www/vpn-page/<секрет> и убрать блок location из конфига
Ключи удалить клиентов buryan-06…10 из трёх входящих, systemctl restart xray

Откат конфига xray уже проверялся в бою: при первой попытке правки встроенная проверка не прошла, и скрипт вернул конфиг автоматически, служба осталась рабочей.

6. Безопасность

  • Ключи в Git не попадают — policies/secret-policy.md.
  • Доступы страницы — в /root/.buryan-vpn-page (600) и в Vaultwarden.
  • Сам конфиг xray лежит на VPS (/usr/local/etc/xray/config.json).
  • Страница закрыта паролем, отдаёт 401 без него — проверено.
  • Перед правкой nginx — копия, после — nginx -t, затем reload.

7. Что осталось

# Что Почему не сделано
VPN-1.3 Проверить на телефонах Сергея и AlexTest нужны их устройства и сети
VPN-1.4 Раздать остальным после проверки на первых двух
— Разместить ссылки в Vaultwarden целевое хранилище по политике

Что нужно от владельца: дать проверить на телефонах. Порядок: открыть страницу на компьютере → отсканировать свой код → подключить → открыть 2ip.ru. Если у кого-то не пойдёт — это ожидаемо, у нас в Этапе 2 готовятся ещё два протокола на этот случай.

8. Связанные документы

Файл Что внутри
docs/VPN-FOR-FAMILY.md инструкция для родных
docs/vpn-clients.md рабочие параметры, выдача и отзыв ключей
ops/network/VPN-STATUS.md состояние канала
docs/TASKS.md реестр задач

9. Раздача через Matrix (добавлено 17.10.2026)

По решению владельца профили выдаются не только страницей, но и в Matrix: Matrix свой, ключи не уходят на чужие серверы, и человек получает профиль там, где он и так общается с семьёй.

Что сделано

  • ops/vpn/matrix-distribute.py — заводит приватную комнату на каждого человека, приглашает его, отправляет картинку QR, ссылку текстом и инструкцию;
  • есть режимы: показать план, отправить всем, отправить одному, проверить;
  • проверено на akadmin (17.10.2026): комната «VPN — Роман» создана, получатель вошёл, вход только по приглашению, картинка скачивается целой (1759 байт, сигнатура PNG верна), два текста на месте.

Почему комната на каждого, а не общая

В общей комнате «Семья» лежат ключи всех сразу. Тогда отозвать доступ одному человеку нельзя, не задев остальных — а ради возможности отзыва по одному мы и завели отдельные ключи. Поэтому общая комната не годится.

Что ещё выяснено по ходу

Находка Значение
Комната «Семья» содержит @telegram_<id> там есть люди из Telegram-моста
portal в базе моста пуст комната, похоже, в Telegram сейчас не зеркалится
Медиа отдаётся только по /_matrix/client/v1/media/download старые media/v3 и media/r0 дают 404
@akadmin — админ, но устройств не зарегистрировано с него ещё не входили; для тестов надо завести устройство
E2EE в комнатах не включён ключи лежат в нашей базе открытыми; база своя, риск приемлем

Чего нельзя забыть

QR нельзя отсканировать на том же экране, где он открыт. Поэтому человеку нужен второй экран (компьютер) либо ссылка текстом — она отправляется отдельным сообщением именно на этот случай.

Курица и яйцо: Matrix снаружи доступен только при поднятом VPN (в аудите: AlexTest вошёл только через VPN). Значит первый раз профиль надо поставить дома, на домашнем Wi-Fi, либо взять его со страницы. Раздача через Matrix — это для «дальше», а не для первого входа с нуля.

Осталось решить владельцу

Класть ли профили в комнату, которая зеркалится в Telegram: тогда ключи попадут на серверы Telegram. До решения раздача семье не запускается.

10. Выдача профилей по запросу и рассылка (17.10.2026)

Рассылка выполнена

Профили отправлены всем шестерым, каждому в свою приватную комнату: Роман (Buryan-01), Сергей (Buryan-03), AlexTest (Buryan-04), Елена (Buryan-05), Полина (Buryan-06), Никита (Buryan-07).

Проверено --verify: у всех комнат вход только по приглашению, у всех картинка QR скачивается целой (по 1759–1872 байта, сигнатура PNG верна). Пятеро на момент отчёта в статусе «приглашён» — им нужно принять приглашение в Element.

Бот выдачи по запросу

ops/vpn/matrix-vpn-bot.py, служба matrix-vpn-bot (включена в автозапуск).

!vpn          -> свой профиль личным сообщением
!vpn help     -> подсказка
!vpn 08       -> владельцу: указанный ключ
!vpn 04       -> не владельцу: ОТКАЗ

Проверено самопроверкой:

Команда Кто Результат
!vpn 08 владелец отправлен запасной ключ ✅
!vpn 04 Сергей ОТКАЗ, попытка записана в журнал ✅
!vpn Сергей свой ключ личным сообщением ✅
!vpn help Елена подсказка ✅

Два случая, которые чуть не сломали работу

1. Ограничение частоты (429). Первая рассылка оборвалась на середине: Synapse ответил M_LIMIT_EXCEEDED. Двое получили комнату без инструкции, а состояние не сохранилось — скрипт падал до записи. Исправлено: 429 пережидается (читается retry_after_ms), состояние пишется после каждого человека, а признак delivered не даёт продублировать отправку. Комнаты, созданные до падения, восстановлены по псевдониму #vpn-<логин> вместо создания дублей.

2. Бот дублировал бы профили после перезапуска. При первом запуске /sync отдаёт последние события комнат, и бот обработал бы старые команды заново. Исправлено: первый запуск только берёт точку отсчёта.

3. Личные комнаты затирались. Они хранились в том же файле, что и точка отсчёта, а точка перезаписывается на каждом круге. Вынесены в отдельный файл.

Чего бот не делает

  • Не отвечает профилем в комнату — только личным сообщением.
  • Не слушает «Семью» и тревоги.
  • Не отдаёт чужой профиль никому, кроме двух админов.

11. Выдача доступа новому человеку (добавлено 17.10.2026)

Команда владельца:

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

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

Что выяснила проверка

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

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

3. Уборка за проверкой. Временный человек заводился через ключ регистрации Synapse (лежит внутри CT 155, а не на хосте PVE — на этом я споткнулся). После проверки временные люди и их комнаты удалены: пользователей снова 21, событий временных комнат 0. Комнаты чистились с обнулением зависимостей (event_edges держал события круговой ссылкой).

Итог проверки

Проверка Результат
Бот завёл личную комнату и пригласил ✅
Получатель видит профиль при приглашении ✅ (shared)
До получателя дошли картинка QR и ссылка ✅
Выдача записана: кто, кому, какой ключ ✅
Обычному человеку — отказ ✅
Уборка после проверки ✅ 0 временных