Files
buryan-infra/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md
T
root b741540373 VPN: разбор ложной тревоги — банки доступны, дело было в сертификате
Я ошибся и записываю это честно, потому что ошибка поучительная.

Проверял доступность банков обычным curl и получал 000 — «соединения
нет». В журнале было "SSL certificate problem: self-signed certificate
in certificate chain" и отказ за 0,015 с. Я решил, что это вмешательство
провайдера: сертификат подменяют по пути. Вывод был громкий и неверный.

На самом деле Сбербанк и Т-Банк САМИ используют сертификаты российского
доверенного УЦ Минцифры ("Russian Trusted Sub CA"). Он встроен в
телефоны, но его нет в хранилище доверия моих инструментов. Поэтому
curl и отказывался — дело было в моей стороне, а не в сети. С VPS
сертификат точно такой же: подмены нет ни там, ни там.

Проверил так, как это работает на телефоне (с отключённой проверкой
сертификата): sberbank.ru 200, online.sberbank.ru 302, tbank.ru 200,
vtb.ru 200, alfabank.ru 200. Сбербанк отдаёт обычное перенаправление
на /ru/person со своей сессионной кукой. Всё работает.

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

В документ для семьи добавил предупреждение: банки используют
российский УЦ, поэтому некоторые программы и скрипты на компьютере
будут ругаться на сертификат, хотя с телефона всё открывается. Правило
простое: если браузер на телефоне открывает банк — всё в порядке.

Общий урок, записанный в отчёт: это ВТОРОЙ раз, когда меня подвёл
инструмент проверки, а не работа. Сначала opencv не смог прочитать
исправный QR-код, теперь curl отверг исправный сайт. Оба раза спасало
одно правило — при странном результате проверять саму проверку, а не
сразу чинить то, что она показывает.
2026-10-16 21:27:00 +03:00

26 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 временных

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 отверг исправный сайт.

Оба раза спасало одно правило: при странном результате проверять саму проверку, а не сразу чинить то, что она показывает.