Профили с раздельной маршрутизацией (.yaml для FlClash, .json для
Hiddify) и инструкция отправлены всем шестерым — и в личные комнаты
Matrix, и выложены на страницу раздачи. Адрес и пароль страницы
не менялись.
Проверено по факту, а не по отчёту бота: файл скачивался глазами
получателя и сверялся с исходным по SHA-256. Все 6 человек: по 2 файла,
оба целые, инструкция на месте. Плюс сквозная проверка, что после
добавления 204 правил домашний домен по-прежнему идёт в туннель
(git.buryans.ru -> [proxy]), а прочее напрямую.
НАЙДЕНА И ИСПРАВЛЕНА ТРЕТЬЯ ПОЛОМКА. Комнаты выдачи создавались
с видимостью истории "joined": человек видит только то, что отправлено
ПОСЛЕ его вступления. Пока он только приглашён, отправленные ему
профили ему НЕ видны — со стороны это выглядит как "мне ничего не
пришло", хотя на сервере всё лежит.
То есть Сергей, Елена и Полина физически не могли увидеть ни ключ,
ни профиль, пока не приняли бы приглашение. А приняли бы они его,
скорее всего, именно увидев сообщение — которого не видели. Замкнутый
круг, из-за которого раздача могла молча не дойти до трёх человек
из шести.
Исправлено: все шесть комнат переведены на "shared", приглашённые видят
присланное сразу. Проверено. Скрипт создания комнат тоже исправлен,
чтобы это не вернулось; отдельный скрипт fix-room-visibility.py
приводит уже созданные комнаты в порядок.
Урок общий и повторяющийся: проверять надо ГЛАЗАМИ ПОЛУЧАТЕЛЯ, а не
состоянием на сервере. Оба раза проблему нашла именно такая проверка —
сначала в личных комнатах бота, теперь в комнатах выдачи.
Задача от владельца: взять полный список из открытых источников и сразу
раскатать, дальше он будет дописывать штучно.
Причина, по которой это нужно: приложения ломаются не из-за туннеля, а
из-за адреса выхода. Банк, госуслуги и маркетплейс видят, что запрос
пришёл из-за рубежа, и закрывают доступ. Значит их трафик должен идти
МИМО туннеля — тогда всё работает и переключать ничего не нужно.
Что сделано:
* ops/vpn/home-and-ru-zones.json — ЕДИНСТВЕННОЕ место для правок.
Три списка: домашние домены в туннель (27), российские зоны напрямую
(174 + 3 глобальных). Дописал зону — пересобрал одной командой,
и она появилась и в правилах клиента, и в профилях для телефона;
* ops/vpn/split_config.py — общий загрузчик: списки больше не дублируются
в коде, иначе они разошлись бы;
* ops/vpn/build-split-profiles.py — готовые профили на каждого человека
(.yaml для FlClash, .json для Hiddify);
* ops/vpn/push-profiles-to-vps.sh — раскладка профилей на страницу раздачи;
* ops/vpn/update-page-split.py, deliver-split-profiles.py — обновление
страницы и доставка через Matrix.
Список из открытых публикаций апреля 2026 (со ссылками в документе):
Известия/dp.ru, Topvisor, Алтапресс, spbnews78. Покрыты банки, госуслуги,
маркетплейсы, продуктовые сети, аптеки, доставка, такси, самокаты,
навигаторы, операторы связи, кинотеатры, госсайты.
Раскатано на страницу раздачи рядом с QR-кодами: человек скачивает файл
прямо на телефоне и импортирует — второй экран больше не нужен.
Адрес и пароль страницы не менялись.
Проверено на живом клиенте: все 6 профилей проходят xray run -test
(Configuration OK); маршрутизация подтверждена журналом —
git.buryans.ru ушёл [proxy] и ответил 200, а sberbank.ru, gosuslugi.ru,
ozon.ru, wildberries.ru, ya.ru ушли [direct]. Внешний адрес недомашнего
трафика — 46.8.140.22, обычный путь.
Поймана и исправлена вторая настоящая поломка: первая версия профиля
опиралась на geosite:category-ru, и профиль НЕ загружался —
"failed to open file: geosite.dat". Для geosite нужен файл данных рядом
с клиентом, а его может не быть; на телефоне это выглядело бы как
"профиль не добавляется". Теперь geosite/geoip не используются вовсе,
правила строятся только из списка доменов и подсетей, а генератор
проверяет, что эта зависимость не вернулась.
Ключи в Git не попадают: папка ops/vpn/build/ внесена в .gitignore
(проверено git check-ignore), в репозитории только скрипты и списки.
Задача: часть приложений (банки, госуслуги, маркетплейсы) не работает,
когда весь трафик идёт через VPN. С апреля 2026 крупные российские
сервисы закрывают доступ тем, кто приходит с зарубежного адреса;
рекомендацию дало Минцифры на совещании с 20+ компаниями, срок
назывался до 15 апреля. Приложение Сбербанка, по сообщениям, вообще
не запускается при включённом VPN.
Причина не в туннеле, а в том, ЧТО через него идёт. Значит решение —
маршрутизация, а не ручные переключения.
Что сделано:
* ops/vpn/gen-split-routing.py — собирает файлы маршрутизации из ОДНОГО
списка домашних доменов (27 адресов). Если вести списки порознь,
они разойдутся, и придётся искать, почему одна служба не открывается;
* ops/vpn/split/ — собранное: home-domains.txt, rules-clash.yaml,
client-routing.json (для Xray-клиентов);
* ops/vpn/split-profile-android.yaml — готовый профиль для Android:
список приложений через туннель, домашние домены в туннель,
всё остальное напрямую;
* docs/VPN-SPLIT-ROUTING.md — как настроить обоими способами;
* docs/VPN-APP-CONFLICTS.md — понятным языком, почему ломается и что
именно перестало работать, со ссылками на открытые источники.
Проверено на живом клиенте (xray 25.3.6, тот же клиент, что в телефоне),
результат виден в журнале:
accepted tcp:git.buryans.ru:443 [proxy] <- домашнее, в туннель
accepted tcp:ip-api.com:80 [direct] <- прочее, напрямую
accepted tcp:www.sberbank.ru:443 [direct] <- российское, напрямую
Конфиг проходит xray run -test (Configuration OK), профиль YAML
разбирается, порядок правил проверен скриптом.
Две грабли, найденные по ходу и записанные в документ:
1. Порядок правил решает. Первая версия начиналась с правила «всё
российское и весь buryans.ru — напрямую», а buryans.ru это и есть
наши домашние службы: широкое правило перехватило бы их раньше
узкого, и домашние домены ушли бы мимо туннеля. Домашнее правило
обязано стоять выше.
2. Без sniffing правила по домену не работают: клиент видит только
IP, имя уже разрешено. Поэтому включены sniffing с destOverride
и domainStrategy IPIfNonMatch.
Граница, которую обозначил владельцу прямо: вывод приложения из туннеля
— это штатная настройка Android, её я делаю. Подмену проверки «есть ли
на телефоне VPN» я не делаю: это уже не маршрутизация, а обман
проверки, и такое приложение честнее вынести из туннеля или настроить
ему прокси в самом приложении.
Ключей в коммите нет: в профиле стоит подстановка <ВАШ-UUID>,
свой ключ человек берёт из своей комнаты в Matrix.
Владельцу нужна была одна команда, чтобы выдать профиль новому
участнику без ручной сборки 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 держал события круговой ссылкой.
Задача 4.2 из реестра: проверка «VPN работает» в наблюдении. Сделано.
Почему отдельная проверка: порт 10443 может слушать, а трафик не
проходить — именно это мы уже видели, когда провайдер вмешивался
в поток. Открытый порт об этом не говорит.
Как проверяется (ops/vpn/vpn-check.sh): поднимается временный клиент
xray на самом VPS, идёт через него в интернет, сверяется внешний адрес.
Совпал — канал пропускает трафик. За собой убирает. Ключ берётся из
рабочей конфигурации xray, а не из файла со ссылками: тот файл лежит
на домашнем узле, а проверка идёт на VPS.
Встроено в /opt/buryan-hub/scripts/check-services.sh (функция check_vpn),
вызывается каждые 5 минут вместе с остальными проверками, провал
попадает в общую тревогу в Matrix.
Порт 2087 (Reality) намеренно не проверяется: он не работает и занесён
в план задачами VPN-2.3, иначе тревога была бы каждые 5 минут.
Проверено отдельным запуском только новой функции, без полного цикла
наблюдения (чтобы не поднять ложную тревогу): код 0, PASSED=1.
Отдельно: команда !vpn link для настройки на самом телефоне. QR с того
же экрана не считать, а ссылку из сообщения можно скопировать и вставить
в приложение. Проверены варианты !vpn link, !VPN LINK, !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.
По решению владельца профили выдаются не только страницей, но и в Matrix:
Matrix свой, ключи не уходят на чужие серверы, и человек получает профиль
там, где он и так общается с семьёй.
Добавлено:
* ops/vpn/matrix-distribute.py — заводит приватную комнату НА КАЖДОГО
человека, приглашает его, отправляет картинку QR, ссылку текстом на
случай несчитанного кода и инструкцию;
* режимы: план (по умолчанию), --send, --send --only <логин>, --verify.
Почему комната на каждого, а не общая "Семья": в общей комнате ключи
видны всем сразу, и тогда нельзя отозвать доступ одному, не задев
остальных. Ради отзыва по одному мы и заводили отдельные ключи.
Проверено на akadmin: комната "VPN - Роман" создана, получатель вошёл,
вход только по приглашению, картинка скачивается целой (1759 байт,
сигнатура PNG верна), текстов два. Режим --verify делает эту проверку
повторяемой.
Попутно выяснено и записано в документы:
* комната "Семья" содержит участников @telegram_<id> — там люди из
Telegram-моста, поэтому профили туда не кладём;
* portal в базе моста пуст — комната, похоже, в Telegram не зеркалится;
* этот Synapse отдаёт медиа только по /_matrix/client/v1/media/download,
старые media/v3 и media/r0 дают 404 (ложный признак потери файла);
* @akadmin — админ, но устройств не зарегистрировано;
* E2EE в этих комнатах не включён.
Ждёт решения владельца: класть ли профили в комнату, зеркалящуюся
в Telegram (тогда ключи попадут на серверы Telegram). До решения
раздача семье не запускается — её будет не откатить без смены ключей.
Задача: docs/TASKS.md -> раздел VPN, Этап 1 (приоритет 3 из
docs/AUDIT-2026-10-17.md, часть 6).
Сделано:
* ключей 5 -> 10 (buryan-06..10 во все три входящих: 10443, 2087, 2053);
существующие user1..user5 не тронуты — их могли уже использовать;
* у каждого ключа своё имя: раздаём и отзываем доступ по одному,
не ломая остальных;
* приватная страница с QR-кодами и инструкцией (скрытый путь + пароль,
на существующем домене — новых записей в DNS не потребовалось);
* инструкция для семьи простым языком: приложение, импорт, проверка,
раздел "если не подключается";
* отдельно вынесено предупреждение про встроенный браузер MIUI —
это и была причина, по которой Сергей не мог войти.
Проверено (не на словах):
* xray run -test -> Configuration OK
* новый ключ реально выходит через VPS — и с самого сервера, и снаружи
* устойчивость: 10 подключений из 10
* QR-коды прочитаны независимым декодером (zxing), ссылки совпадают
* страница: 200 с паролем, 401 без пароля; Gitea не затронута (200)
Разбор ложной тревоги: записи "invalid request version" в журнале
оказались чужими проверками порта, а не нашей поломкой. Вывод в отчёт:
не считать канал сломанным по одной неудаче.
Осталось: VPN-1.3 — проверка на телефонах Сергея и AlexTest (нужны
устройства), затем VPN-1.4 — раздача остальным.
Отчёт: ops/vpn/VPN-STAGE1-IMPLEMENTATION.md