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:
1 parent
21df3bf34d
commit
eb04c58dee
2 files changed
+111
No files matched your search
@@ -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`.
|
||||
|
||||
@@ -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 с того же
|
||||
# экрана не считать, а ссылку можно скопировать.
|
||||
|
||||
Reference in new issue
Block a user