From eb04c58dee57249c1d092f129c7dca029b19064b Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Fri, 16 Oct 2026 21:22:53 +0300 Subject: [PATCH] =?UTF-8?q?VPN:=20=D0=BA=D0=BE=D0=BC=D0=B0=D0=BD=D0=B4?= =?UTF-8?q?=D0=B0=20=D1=81=D0=B0=D0=BC=D0=BE=D0=BF=D1=80=D0=BE=D0=B2=D0=B5?= =?UTF-8?q?=D1=80=D0=BA=D0=B8=20=D0=B4=D0=BB=D1=8F=20=D1=81=D0=B5=D0=BC?= =?UTF-8?q?=D1=8C=D0=B8=20=E2=80=94=20=C2=AB!vpn=20check=C2=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Человек не должен угадывать, на каком шаге он застрял. Команда смотрит со стороны сервера и отвечает коротко: что получилось, что нет и что делать. Проверил содержимое глазами получателя: [да] Доступ выдан, ваш ключ: Buryan-01 [да] Готовые профили пришли: vpn-akadmin.json, vpn-akadmin.yaml [да] Сервер отвечает, связь с ним есть Со стороны сервера всё готово. Осталось проверить на телефоне: 1. Приложение: FlClash (.yaml) либо Hiddify (.json). ... 5. Откройте 2ip.ru — должен показаться 193.233.210.184. Если чего-то не хватает, называет причину и следующий шаг: нет ключа — «напишите владельцу»; профилей не видно — «примите приглашение в комнату»; сервер молчит — «повторите через пару минут». Важное ограничение, о котором сказано прямо и в коде, и в документе: команда НЕ проверяет, работает ли VPN на самом телефоне — этого со стороны сервера не видно. Поэтому последний шаг всегда «проверьте сами», с точной ссылкой и ожидаемым адресом. Обещать больше, чем можешь проверить, — верный способ запутать человека. Работает независимо от того, принял человек приглашение или нет: комнаты выдачи переведены на видимость «shared», поэтому приглашённый видит и профили, и ответ на команду. --- docs/vpn-clients.md | 30 +++++++++++++++ ops/vpn/matrix-vpn-bot.py | 81 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 111 insertions(+) diff --git a/docs/vpn-clients.md b/docs/vpn-clients.md index 9eaee03..1baa64e 100644 --- a/docs/vpn-clients.md +++ b/docs/vpn-clients.md @@ -154,6 +154,7 @@ E2EE в этих комнатах не включён: ключи лежат в |---|---|---| | `!vpn` | любой | свой профиль (картинка QR + ссылка) | | `!vpn link` | любой | только строку-ссылку, без картинки | +| `!vpn check` | любой | проверку: что на месте и что делать | | `!vpn help` | любой | подсказку | | `!vpn 08` | владелец | указанный ключ (в том числе запасной) | | `!vpn 04` | не владелец | **отказ** | @@ -320,6 +321,35 @@ QR-код и ссылку. После проверки временный чел и прочий — напрямую. Подробности и подтверждение из журнала — в `VPN-SPLIT-ROUTING.md`. +### Самопроверка: «!vpn check» + +Человек не должен угадывать, на каком шаге он застрял. Команда смотрит +со стороны сервера и отвечает коротко: что получилось, что нет и что +делать. Вот как это выглядит: + +``` +Проверка вашего подключения + + [да] Доступ выдан, ваш ключ: Buryan-01 + [да] Готовые профили пришли: vpn-akadmin.json, vpn-akadmin.yaml + [да] Сервер отвечает, связь с ним есть + +Со стороны сервера всё готово. Осталось проверить на телефоне: + + 1. Приложение: FlClash (файл .yaml) либо Hiddify (файл .json). + 2. Скачайте свой файл на странице раздачи — прямо на телефоне. + ... + 5. Откройте 2ip.ru — должен показаться 193.233.210.184. +``` + +**Чего команда НЕ делает:** не проверяет, работает ли VPN на самом +телефоне. Этого со стороны сервера не видно — поэтому последний шаг +всегда «проверьте сами», с точной ссылкой и ожидаемым адресом. + +Если чего-то не хватает, команда называет причину и следующий шаг: +нет ключа — «напишите владельцу»; профилей не видно — «примите +приглашение в комнату»; сервер молчит — «повторите через пару минут». + ## 6. Как выдать доступ новому человеку 1. Взять свободный ключ из `/root/.buryan-vpn-final`. diff --git a/ops/vpn/matrix-vpn-bot.py b/ops/vpn/matrix-vpn-bot.py index 32cb62f..888d946 100644 --- a/ops/vpn/matrix-vpn-bot.py +++ b/ops/vpn/matrix-vpn-bot.py @@ -239,6 +239,7 @@ def help_text(): " !vpn — прислать ваш профиль личным сообщением (с QR-кодом)\n" " !vpn link — прислать только строку-ссылку, без картинки:\n" " удобно, когда настраиваете телефон на нём же\n" + " !vpn check — проверить, всё ли у вас на месте, и что делать\n" " !vpn list — что выдано и какие ключи свободны\n" " !vpn help — эта подсказка\n" "Для владельца:\n" @@ -374,6 +375,82 @@ def handle_list(room_id): return "список ключей" +def handle_check(room_id, sender, room_key): + """«!vpn check» — что у человека на месте и что делать дальше. + + ЗАЧЕМ. Человек не должен угадывать, на каком шаге он застрял. + Команда проверяет то, что видно со стороны сервера, и выдаёт + короткий список: что получилось, что нет, что делать. + + Важно: команда НЕ проверяет, работает ли VPN на самом телефоне — + этого со стороны сервера не видно. Поэтому последний шаг всегда + «проверьте сами» с точной ссылкой. + """ + lines = ["Проверка вашего подключения", ""] + todo = [] + + # 1. Доступ к комнате + if room_key: + lines.append(" [да] Доступ выдан, ваш ключ: %s" % room_key) + else: + lines.append(" [нет] За вами не закреплён ключ") + todo.append("Напишите владельцу — он выдаст вам доступ командой.") + + # 2. Профили в комнате — видны ли они человеку + try: + msgs = api("GET", "/_matrix/client/v3/rooms/%s/messages?dir=b&limit=30" + % urllib.parse.quote(room_id)).get("chunk", []) + files = [e for e in msgs if e.get("content", {}).get("msgtype") == "m.file"] + imgs = [e for e in msgs if e.get("content", {}).get("msgtype") == "m.image"] + if files: + names = sorted({(e["content"].get("filename") or e["content"].get("body")) + for e in files}) + lines.append(" [да] Готовые профили пришли: %s" % ", ".join(names)) + elif imgs: + lines.append(" [да] QR-код пришёл (профиль по QR)") + todo.append("Лучше возьмите готовый профиль с раздельной настройкой — " + "тогда банки и госуслуги продолжат работать.") + else: + lines.append(" [нет] Профилей в комнате не видно") + todo.append("Примите приглашение в комнату «VPN — ваше имя» в Element, " + "затем напишите сюда «!vpn».") + except Exception as e: + lines.append(" [?] Не смог посмотреть комнату: %s" % e) + + # 3. Реагирует ли сервер + try: + ver = api("GET", "/_matrix/client/versions") + lines.append(" [да] Сервер отвечает, связь с ним есть") + except Exception: + lines.append(" [нет] Сервер не отвечает") + todo.append("Подождите пару минут и повторите проверку.") + + # 4. Что делать дальше + lines.append("") + if not todo: + lines.append("Со стороны сервера всё готово. Осталось проверить на телефоне:") + lines.append("") + lines.append(" 1. Приложение: FlClash (файл .yaml) либо Hiddify (файл .json).") + lines.append(" 2. Скачайте свой файл на странице раздачи — прямо на телефоне.") + lines.append(" 3. Импорт: FlClash — «Профили» → «Добавить» → «Импорт из файла».") + lines.append(" Hiddify — «+» → импорт из файла.") + lines.append(" 4. Подключите и разрешите VPN.") + lines.append(" 5. Откройте 2ip.ru — должен показаться 193.233.210.184.") + lines.append(" 6. Откройте приложение банка — должно работать как обычно.") + lines.append("") + lines.append("Если на шаге 5 адрес другой или на шаге 6 не работает — " + "напишите мне, что именно увидели.") + else: + lines.append("Что сделать:") + for i, t in enumerate(todo, 1): + lines.append(" %d. %s" % (i, t)) + lines.append("") + lines.append("Если что-то непонятно — просто напишите, разберёмся.") + + send_text(room_id, "\n".join(lines)) + return "самопроверка (%s)" % (room_key or "без ключа") + + def handle(room_id, sender, body, room_key): """Обрабатывает одну команду. room_key — какой ключ закреплён за комнатой.""" text = body.strip() @@ -403,6 +480,10 @@ def handle(room_id, sender, body, room_key): if arg.lower() in ("list", "список"): return handle_list(room_id) + # Самопроверка: человек сам видит, на каком шаге он застрял. + if arg.lower() in ("check", "проверка", "проверить"): + return handle_check(room_id, sender, room_key) + # «!vpn link» — только строка-ссылка, без картинки. # Удобно, когда настраиваешь телефон, держа его в руках: QR с того же # экрана не считать, а ссылку можно скопировать.