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», поэтому приглашённый
видит и профили, и ответ на команду.
This commit is contained in:
root committed 2026-10-16 21:22:53 +03:00
1 parent 21df3bf34d
commit eb04c58dee
2 files changed
+111

No files matched your search

+30
View File
@@ -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`.
+81
View File
@@ -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 с того же
# экрана не считать, а ссылку можно скопировать.