# 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_` | там есть люди из 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 временных | ## 12. Найдено по ходу: отладка в журнале xray (17.10.2026) **Что нашёл.** В конфигурации xray стоял уровень журнала `debug`. Он остался с тех пор, когда искали причину, почему не проходил Reality, — и так и не был выключен. **Чем это плохо.** За месяц отладка дала **371 МБ журналов** на VPS и продолжала расти. Замер в процессе работы: за пару часов моих проверок архив журналов вырос с 371 до 387 МБ. При таком темпе диск кончится за месяцы, и первым упадёт сам VPN — то есть поломка пришла бы «на ровном месте» и искать её стали бы не там. **Исправлено:** `loglevel` переведён с `debug` на `warning`. Файловые журналы (`access`, `error`) намеренно **не** включал: файл растёт без ротации, а для наблюдения достаточно системного журнала, где ротация есть. Порядок был обычный: копия → правка → `xray run -test` → перезапуск → проверка. Потом проверено, что служба работает, все три порта слушают и канал действительно пропускает трафик. Копия до правки: `/usr/local/etc/xray/config.json.before-loglevel-*`. **Вывод на будущее:** временные настройки для поиска причины надо помечать и снимать. Отладка, забытая после расследования, — это отложенная поломка. ## 13. Сводка использования: кто реально пользуется Добавлен `ops/vpn/vpn-usage.py` — считает по журналу xray, **чьим ключом пользовались**. Метка в пользовательской записи у каждого ключа своя, поэтому видно персонально. Зачем: «выдал» и «пользуется» — разные вещи, а по отчётам бота этого не видно. Это единственный честный способ понять, дошёл ли этап до людей, не спрашивая самих людей. На 17.10.2026 (окно 7 дней): | Кому | Ключ | Подключений | |---|---|---| | Роман | Buryan-01 | 410 (почти всё — мои проверки) | | Полина | Buryan-06 | 30 | | Сергей | Buryan-03 | 2 | | AlexTest | Buryan-04 | ни разу | | Елена | Buryan-05 | ни разу | | Никита | Buryan-07 | ни разу | **Важно понимать ограничение этого замера:** по журналу видно, что человек подключался **хотя бы раз**, но **не видно, доволен ли он**. Ноль подключений не означает «не получилось» — возможно, просто не дошли руки. Поэтому сводка идёт в дополнение к живой проверке, а не вместо неё. ## 14. Важный разбор: «банки не работают» оказалось ошибкой замера **Как я ошибся.** Проверял доступность банков обычным `curl` и получал `000` — соединения нет. В журнале при этом было: ``` SSL certificate problem: self-signed certificate in certificate chain время ответа: 0.015 с ``` Быстрый отказ плюс проблема с сертификатом — и я решил, что это **вмешательство провайдера**: сертификат подменяют по пути. Вывод был громкий и неверный. **Что оказалось на самом деле.** Посмотрел, кто выдал сертификат: ``` subject=CN=sberbank.ru, O=Sberbank, C=RU issuer=C=RU, O=The Ministry of Digital Development and Communications, CN=Russian Trusted Sub CA ``` Сбербанк и Т-Банк **сами** используют сертификаты российского доверенного УЦ Минцифры. Он **встроен в телефоны**, но его нет в хранилище доверия моих инструментов. Поэтому `curl` и отказывался — дело было в моей стороне, а не в сети. С VPS сертификат точно такой же: то есть подмены нет ни там, ни там. Проверил с отключённой проверкой сертификата — то есть так, как это работает на телефоне: | Адрес | Ответ | Время | |---|---|---| | `www.sberbank.ru` | **200** | 0,22 с | | `online.sberbank.ru` | **302** | 0,36 с | | `www.tbank.ru` | **200** | 0,59 с | | `www.vtb.ru` | **200** | 7,5 с | | `www.alfabank.ru` | **200** | 0,32 с | **Все банки доступны.** Сбербанк отдаёт обычное перенаправление на `/ru/person` со своей сессионной кукой — то есть работает нормально. **Правильный вывод.** Банки в этом хозяйстве **и так доступны напрямую** с домашнего канала. Раздельная маршрутизация для них — не лечение, а **страховка**: если канал до банка когда-нибудь начнёт мешать, трафик всё равно пойдёт мимо туннеля и поведение не изменится. То есть профиль делает ровно то, что нужно, просто по другой причине, чем я думал. ### Урок про замеры **Проверять российские сервисы надо с учётом их сертификатов.** Они используют доверенный УЦ Минцифры, которого нет в обычных инструментах; без учёта этого любой рабочий сервис выглядит «сломанным». Это второй раз, когда меня подвела не работа, а **инструмент проверки**: сначала `opencv` не смог прочитать исправный QR-код, теперь `curl` отверг исправный сайт. Оба раза спасало одно правило: **при странном результате проверять саму проверку, а не сразу чинить то, что она показывает.**