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

16 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. Личные комнаты затирались. Они хранились в том же файле, что и точка отсчёта, а точка перезаписывается на каждом круге. Вынесены в отдельный файл.

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

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