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