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