Commit Graph
5 Commits
Author SHA1 Message Date
root eb04c58dee VPN: команда самопроверки для семьи — «!vpn check»
Человек не должен угадывать, на каком шаге он застрял. Команда смотрит
со стороны сервера и отвечает коротко: что получилось, что нет и что
делать. Проверил содержимое глазами получателя:

  [да] Доступ выдан, ваш ключ: Buryan-01
  [да] Готовые профили пришли: vpn-akadmin.json, vpn-akadmin.yaml
  [да] Сервер отвечает, связь с ним есть

  Со стороны сервера всё готово. Осталось проверить на телефоне:
    1. Приложение: FlClash (.yaml) либо Hiddify (.json).
    ...
    5. Откройте 2ip.ru — должен показаться 193.233.210.184.

Если чего-то не хватает, называет причину и следующий шаг: нет ключа —
«напишите владельцу»; профилей не видно — «примите приглашение в
комнату»; сервер молчит — «повторите через пару минут».

Важное ограничение, о котором сказано прямо и в коде, и в документе:
команда НЕ проверяет, работает ли VPN на самом телефоне — этого со
стороны сервера не видно. Поэтому последний шаг всегда «проверьте
сами», с точной ссылкой и ожидаемым адресом. Обещать больше, чем
можешь проверить, — верный способ запутать человека.

Работает независимо от того, принял человек приглашение или нет:
комнаты выдачи переведены на видимость «shared», поэтому приглашённый
видит и профили, и ответ на команду.
2026-10-16 21:22:53 +03:00
root de65cc088a VPN: выдача доступа новому человеку одной командой админа
Владельцу нужна была одна команда, чтобы выдать профиль новому
участнику без ручной сборки 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 держал события круговой ссылкой.
2026-10-16 20:59:11 +03:00
root cd2657b2f8 VPN: проверка «канал работает» в наблюдении + команда !vpn link
Задача 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 ссылка,
а также отказ на чужой ключ и молчание на обычный текст.
2026-10-16 20:53:09 +03:00
root 0bcbcaaf2b VPN-бот: команда распознаётся в любом регистре + журнал входящих
Найдено живой проверкой: владелец написал в комнате "!VPN" заглавными,
а бот искал строго "!vpn" и молча пропустил команду. Человек при этом
ждал ответа и не понимал, почему тишина.

Исправлено:
* сравнение команды без учёта регистра, добавлен вариант "!впн";
* любое входящее текстовое сообщение теперь пишется в журнал
  ("получено от ..."). Если человек написал команду, а бот промолчал,
  это будет видно сразу, а не останется загадкой;
* токен бота можно подменить переменной BOT_TOKEN_FILE — нужно для
  живой проверки цикла отдельным участником.

Проверено самопроверкой: "!VPN", "!Vpn", "!vpN" дают профиль;
"!VPN 04" от обычного пользователя даёт отказ.

Живой цикл подтверждён по-настоящему: новый участник (@nikita) принял
приглашение и написал в свою комнату — бот поймал сообщение своим
циклом синхронизации, увидел, что это не команда, и промолчал. То есть
цепочка «человек -> комната -> цикл -> обработчик» работает на живом
пользователе, а не только в самопроверке.

Отдельно к сведению: ADM_TOKEN в /root/bots-tokens.env — это токен
Telegram, а не Matrix (Matrix отвечает M_UNKNOWN_TOKEN). Не путать.
2026-10-16 20:45:27 +03:00
root 022067e636 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.
2026-10-16 20:44:05 +03:00