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.
This commit is contained in:
root committed 2026-10-16 20:44:05 +03:00
1 parent 60ff4ac324
commit 022067e636
4 files changed
+488

No files matched your search

+55
View File
@@ -143,6 +143,61 @@ E2EE в этих комнатах не включён: ключи лежат в
База своя, это допустимо, но знать об этом надо. Для ключа VPN,
который можно перевыпустить, риск приемлемый.
## 5в. Бот: выдача профиля по запросу
**Зачем.** Человек сменил телефон, потерял сообщение, забыл ссылку — он
пишет команду и получает свой профиль заново, не дёргая владельца.
**Как устроено** (`ops/vpn/matrix-vpn-bot.py`, служба `matrix-vpn-bot`):
| Команда | Кто | Что получит |
|---|---|---|
| `!vpn` | любой | свой профиль |
| `!vpn help` | любой | подсказку |
| `!vpn 08` | владелец | указанный ключ (в том числе запасной) |
| `!vpn 04` | не владелец | **отказ** |
Ответ приходит **личным сообщением**, а не в комнату. Это не украшение,
а условие безопасности: в комнате «VPN — Сергей» сидит только Сергей
и бот, но если отвечать в комнату, то при добавлении туда кого-то
третьего он увидит чужой ключ. Ключ — это доступ.
Свой профиль человек получает **только по своему Matrix-логину**: комната
«VPN — <логин>» заранее закреплена за конкретным ключом. Спросить чужой
нельзя — иначе доступ к чужому аккаунту в Matrix означал бы доступ
к чужому VPN.
**Где слушает.** Только в комнатах выдачи («VPN — …» и личные комнаты).
В «Семье» и в тревогах бот молчит — там профилей быть не должно.
**Владельцы.** Право запросить любой ключ есть у `@akadmin` и `@comms_agent`
(единственные админы Matrix).
### Устройство, о котором стоит знать
* Бот работает циклом синхронизации (`/sync`), точка отсчёта хранится
в `/root/.buryan-vpn-bot-token.json`.
* При **первом** запуске бот только берёт точку отсчёта и старые сообщения
**не** обрабатывает. Иначе после перезапуска он увидел бы прежние команды
и разослал профили повторно.
* Личные комнаты хранятся **отдельным** файлом
(`/root/.buryan-vpn-bot-direct.json`). Если держать их вместе с точкой
отсчёта, они затираются на каждом круге — так и случилось при разработке.
### Проверка
```bash
systemctl status matrix-vpn-bot --no-pager
journalctl -u matrix-vpn-bot -n 30 --no-pager
# самопроверка: команда подаётся так, будто её прислал человек
python3 /opt/buryan-hub/scripts/matrix-vpn-bot.py --self-test --as=akadmin --command='!vpn'
python3 /opt/buryan-hub/scripts/matrix-vpn-bot.py --self-test --as=sergey --command='!vpn 04'
```
Вторая команда **обязана** дать отказ — это проверка, что чужой ключ
не утекает.
## 6. Как выдать доступ новому человеку
1. Взять свободный ключ из `/root/.buryan-vpn-final`.
+57
View File
@@ -192,3 +192,60 @@ Matrix свой, ключи не уходят на чужие серверы, и
Класть ли профили в комнату, которая зеркалится в Telegram: тогда ключи
попадут на серверы Telegram. До решения раздача семье не запускается.
## 10. Выдача профилей по запросу и рассылка (17.10.2026)
### Рассылка выполнена
Профили отправлены **всем шестерым**, каждому в свою приватную комнату:
Роман (`Buryan-01`), Сергей (`Buryan-03`), AlexTest (`Buryan-04`),
Елена (`Buryan-05`), Полина (`Buryan-06`), Никита (`Buryan-07`).
Проверено `--verify`: у всех комнат вход только по приглашению,
у всех картинка QR скачивается целой (по 1759–1872 байта, сигнатура PNG
верна). Пятеро на момент отчёта в статусе «приглашён» — им нужно принять
приглашение в Element.
### Бот выдачи по запросу
`ops/vpn/matrix-vpn-bot.py`, служба `matrix-vpn-bot` (включена в автозапуск).
```
!vpn -> свой профиль личным сообщением
!vpn help -> подсказка
!vpn 08 -> владельцу: указанный ключ
!vpn 04 -> не владельцу: ОТКАЗ
```
Проверено самопроверкой:
| Команда | Кто | Результат |
|---|---|---|
| `!vpn 08` | владелец | отправлен запасной ключ ✅ |
| `!vpn 04` | Сергей | **ОТКАЗ**, попытка записана в журнал ✅ |
| `!vpn` | Сергей | свой ключ личным сообщением ✅ |
| `!vpn help` | Елена | подсказка ✅ |
### Два случая, которые чуть не сломали работу
**1. Ограничение частоты (429).** Первая рассылка оборвалась на середине:
Synapse ответил `M_LIMIT_EXCEEDED`. Двое получили комнату без инструкции,
а состояние не сохранилось — скрипт падал до записи. Исправлено:
429 пережидается (читается `retry_after_ms`), состояние пишется после
каждого человека, а признак `delivered` не даёт продублировать отправку.
Комнаты, созданные до падения, восстановлены по псевдониму `#vpn-<логин>`
вместо создания дублей.
**2. Бот дублировал бы профили после перезапуска.** При первом запуске
`/sync` отдаёт последние события комнат, и бот обработал бы старые команды
заново. Исправлено: первый запуск только берёт точку отсчёта.
**3. Личные комнаты затирались.** Они хранились в том же файле, что и точка
отсчёта, а точка перезаписывается на каждом круге. Вынесены в отдельный
файл.
### Чего бот не делает
* Не отвечает профилем в комнату — только личным сообщением.
* Не слушает «Семью» и тревоги.
* Не отдаёт чужой профиль никому, кроме двух админов.
+360
View File
@@ -0,0 +1,360 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Бот выдачи VPN-профилей по запросу (Matrix).
ЗАЧЕМ
Человек может запросить свой профиль сам: сменил телефон, потерял
сообщение, забыл ссылку — написал команду и получил.
Владелец может выдать любой профиль, в том числе запасной.
ГЛАВНОЕ ПРАВИЛО БЕЗОПАСНОСТИ
Бот НИКОГДА не отвечает профилем в ту комнату, где спросили.
Ответ всегда уходит ЛИЧНЫМ сообщением тому, кто спросил.
Иначе в комнате «VPN — Сергей» участник увидел бы чужой ключ,
а ключ — это доступ: его нельзя показывать посторонним.
Свой профиль человек получает только по своему Matrix-логину.
Спросить чужой профиль нельзя — иначе доступ к чужому аккаунту
в Matrix означал бы доступ к чужому VPN.
ЧТО ПОНИМАЕТ
!vpn — прислать мой профиль
!vpn help — что я умею
!vpn <ключ> — только для админа: прислать указанный ключ (Buryan-08 и т.п.)
ГДЕ СЛУШАЕТ
Только в комнатах «VPN — <имя>», которые сам же и завёл.
В комнате «Семья» и в тревогах бот молчит: там профилей быть не должно.
Запуск: systemctl start matrix-vpn-bot
"""
import json
import mimetypes
import os
import sys
import time
import urllib.error
import urllib.parse
import urllib.request
HS = "http://192.168.1.155:8008"
NOTIFY_ENV = "/root/.buryan-notify.env"
STATE_FILE = "/root/.buryan-vpn-matrix-state.json"
BOT_STATE = "/root/.buryan-vpn-bot-token.json"
DIRECT_FILE = "/root/.buryan-vpn-bot-direct.json"
BASE = "/root/vpn-dist"
SERVER_NAME = "matrix.buryans.ru"
LOG_PREFIX = "matrix-vpn-bot"
ADMINS = {"@akadmin:" + SERVER_NAME, "@comms_agent:" + SERVER_NAME}
TOKEN = None
def log(msg):
line = "%s %s" % (time.strftime("%Y-%m-%d %H:%M:%S"), msg)
print(line, flush=True)
def load_token():
global TOKEN
for line in open(NOTIFY_ENV, encoding="utf-8"):
if line.startswith("MATRIX_ACCESS_TOKEN="):
TOKEN = line.split("=", 1)[1].strip()
if not TOKEN:
sys.exit("нет MATRIX_ACCESS_TOKEN в %s" % NOTIFY_ENV)
def api(method, path, data=None, raw=False, content_type=None, attempts=5):
"""Запрос к Synapse. Ограничение частоты (429) пережидаем, а не падаем."""
headers = {"Authorization": "Bearer " + TOKEN}
body = None
if data is not None:
if raw:
body = data
headers["Content-Type"] = content_type or "application/octet-stream"
else:
body = json.dumps(data).encode()
headers["Content-Type"] = "application/json"
last = None
for attempt in range(attempts):
req = urllib.request.Request(HS + path, data=body, headers=headers, method=method)
try:
with urllib.request.urlopen(req, timeout=40) as r:
payload = r.read()
return json.loads(payload) if payload else {}
except urllib.error.HTTPError as e:
detail = e.read()[:300].decode("utf-8", "replace")
last = (e.code, detail)
if e.code != 429:
break
wait = 2 ** attempt
try:
wait = json.loads(detail).get("retry_after_ms", 0) / 1000.0 or wait
except Exception:
pass
time.sleep(min(wait + 0.5, 30))
code, detail = last or ("?", "")
raise RuntimeError("%s %s -> %s: %s" % (method, path.split("?")[0], code, detail))
def load_json(path, default):
try:
with open(path, encoding="utf-8") as f:
return json.load(f)
except Exception:
return default
def save_json(path, data):
with open(path, "w", encoding="utf-8") as f:
json.dump(data, f, ensure_ascii=False, indent=2)
os.chmod(path, 0o600)
def profiles():
data = load_json(os.path.join(BASE, "profiles.json"), [])
return {p["name"]: p for p in data}
def upload_image(path):
ctype = mimetypes.guess_type(path)[0] or "image/png"
q = urllib.parse.urlencode({"filename": os.path.basename(path)})
with open(path, "rb") as f:
blob = f.read()
return api("POST", "/_matrix/media/v3/upload?" + q, data=blob, raw=True,
content_type=ctype)["content_uri"]
def send_text(room, text):
return api("PUT", "/_matrix/client/v3/rooms/%s/send/m.room.message/%s"
% (urllib.parse.quote(room), "t%d" % int(time.time() * 1000)),
data={"msgtype": "m.text", "body": text})
def send_image(room, mxc, name, size, caption):
return api("PUT", "/_matrix/client/v3/rooms/%s/send/m.room.message/%s"
% (urllib.parse.quote(room), "i%d" % int(time.time() * 1000)),
data={"msgtype": "m.image", "body": caption or name, "url": mxc,
"info": {"mimetype": "image/png", "size": size, "w": 732, "h": 732}})
def direct_room(user_id):
"""Личная комната с человеком. Заводится один раз и запоминается.
Хранится в ОТДЕЛЬНОМ файле: токен синхронизации переписывается на каждом
круге, и если держать личные комнаты в том же файле, они затираются.
"""
store = load_json(DIRECT_FILE, {})
dm = store.get(user_id)
if dm:
return dm
alias_local = "vpn-dm-" + urllib.parse.quote(user_id.split(":")[0].lstrip("@"), safe="")
try:
res = api("GET", "/_matrix/client/v3/directory/room/"
+ urllib.parse.quote("#%s:%s" % (alias_local, SERVER_NAME)))
room = res["room_id"]
except RuntimeError:
res = api("POST", "/_matrix/client/v3/createRoom", data={
"preset": "private_chat",
"visibility": "private",
"invite": [user_id],
"room_alias_name": alias_local,
"creation_content": {"m.federate": False},
"initial_state": [
{"type": "m.room.guest_access", "state_key": "",
"content": {"guest_access": "forbidden"}},
{"type": "m.room.history_visibility", "state_key": "",
"content": {"history_visibility": "joined"}},
],
})
room = res["room_id"]
log("создана личная комната для %s: %s" % (user_id, room))
store[user_id] = room
save_json(DIRECT_FILE, store)
return room
def deliver(user_id, key_name, where):
"""Отправляет профиль личным сообщением. Возвращает текст для журнала."""
prof = profiles().get(key_name)
if not prof:
return "нет профиля %s" % key_name
room = direct_room(user_id)
qr = os.path.join(BASE, "qr", key_name + ".png")
if os.path.exists(qr):
mxc = upload_image(qr)
send_image(room, mxc, os.path.basename(qr), os.path.getsize(qr),
"Профиль VPN — %s" % key_name)
time.sleep(0.5)
send_text(room, "Профиль %s (на случай, если QR не считался — вставьте строку "
"в приложение):\n%s" % (key_name, prof["link"]))
return "отправлено в личную комнату %s" % room
def instructions():
return ("Как подключить:\n"
"1. Приложение: Android — Hiddify или v2rayNG; iPhone — Streisand или FoXray.\n"
"2. В приложении «+» → «Сканировать QR-код» (или «Импорт из ссылки»).\n"
"3. Нажать кнопку подключения и разрешить VPN.\n"
"4. Проверка: 2ip.ru должен показать 193.233.210.184.\n"
"5. Отключить экономию батареи для VPN-приложения.\n\n"
"Подробная инструкция — на странице, которую я присылал. "
"Если что-то не идёт — напишите, разберёмся.")
def help_text():
return ("Что я умею:\n"
" !vpn — прислать ваш профиль личным сообщением\n"
" !vpn help — эта подсказка\n"
"Для владельца: !vpn <ключ> — прислать указанный ключ "
"(например, Buryan-08)")
def normalise_key(arg):
"""Приводит «08», «buryan-08», «Buryan-08» к виду Buryan-08."""
digits = "".join(ch for ch in arg if ch.isdigit())
if digits:
return "Buryan-%s" % digits.zfill(2)
return None
def handle(room_id, sender, body, room_key):
"""Обрабатывает одну команду. room_key — какой ключ закреплён за комнатой."""
text = body.strip()
if not text.startswith("!vpn"):
return None
parts = text.split()
arg = parts[1] if len(parts) > 1 else ""
is_admin = sender in ADMINS
if arg.lower() in ("help", "помощь", "?"):
send_text(room_id, help_text())
return "подсказка"
# без имени ключа — свой профиль
if not arg:
if not room_key:
send_text(room_id, "Не знаю, какой профиль вам принадлежит. "
"Напишите владельцу — он выдаст.")
return "нет закреплённого ключа"
note = deliver(sender, room_key, room_id)
send_text(room_id, "Отправил ваш профиль личным сообщением. "
"Здесь, в комнате, ключ показывать нельзя.")
return "свой профиль (%s): %s" % (room_key, note)
# с именем ключа — только владелец
if not is_admin:
send_text(room_id, "Запросить чужой профиль нельзя — это чужой доступ. "
"Свой профиль: команда без имени ключа.")
log("ОТКАЗ: %s пытался запросить %s" % (sender, arg))
return "отказ не админу: %s" % arg
key_name = normalise_key(arg) or arg
note = deliver(sender, key_name, room_id)
send_text(room_id, "Ключ %s отправлен личным сообщением." % key_name)
return "владелец запросил %s: %s" % (key_name, note)
def main():
load_token()
me = api("GET", "/_matrix/client/v3/account/whoami")["user_id"]
log("запуск, я %s" % me)
# Самопроверка: подать команду так, будто её прислал человек.
# Нужна, чтобы проверять доставку, не дожидаясь живой команды в комнате.
if "--self-test" in sys.argv:
who = "@akadmin:%s" % SERVER_NAME
for a in sys.argv:
if a.startswith("--as="):
who = a.split("=", 1)[1]
if not who.startswith("@"):
who = "@%s:%s" % (who, SERVER_NAME)
command = "!vpn"
for a in sys.argv:
if a.startswith("--command="):
command = a.split("=", 1)[1]
state = load_json(STATE_FILE, {})
room_key = None
room_id = None
localpart = who.split(":")[0].lstrip("@")
info = state.get(localpart) or {}
room_id = info.get("room")
room_key = info.get("key")
if not room_id:
log("самопроверка: у %s нет комнаты — беру его личную" % who)
room_id = direct_room(who)
log("самопроверка: %s прислал %r (ключ комнаты %s)" % (who, command, room_key))
note = handle(room_id, who, command, room_key)
log("самопроверка результат: %s" % note)
return
store = load_json(BOT_STATE, {})
since = store.get("since")
# Первый запуск: только берём точку отсчёта и НИЧЕГО не обрабатываем.
# Иначе после перезапуска бот увидел бы старые команды в комнатах
# и разослал профили повторно — человек получил бы дубли.
if not since:
res = api("GET", "/_matrix/client/v3/sync?timeout=0")
since = res.get("next_batch")
save_json(BOT_STATE, {"since": since})
log("точка отсчёта взята, старые сообщения не обрабатываю")
while True:
try:
state = load_json(STATE_FILE, {})
rooms = {}
for localpart, info in state.items():
if info.get("room"):
rooms[info["room"]] = info.get("key")
direct_rooms = set(load_json(DIRECT_FILE, {}).values())
query = {"timeout": "30000", "filter": json.dumps({
"room": {"timeline": {"limit": 20}}})}
if since:
query["since"] = since
res = api("GET", "/_matrix/client/v3/sync?" + urllib.parse.urlencode(query))
since = res.get("next_batch", since)
save_json(BOT_STATE, {"since": since})
joined = res.get("rooms", {}).get("join", {})
for room_id, room_data in joined.items():
# слушаем только комнаты выдачи: общая «Семья» и тревоги молчат
if room_id not in rooms and room_id not in direct_rooms:
continue
room_key = rooms.get(room_id)
events = room_data.get("timeline", {}).get("events", [])
for ev in events:
if ev.get("type") != "m.room.message":
continue
sender = ev.get("sender", "")
if sender == me or sender.startswith("@bot_"):
continue
content = ev.get("content", {})
body = content.get("body", "")
if content.get("msgtype") != "m.text":
continue
try:
note = handle(room_id, sender, body, room_key)
except Exception as e:
log("ошибка при обработке команды от %s: %s" % (sender, e))
continue
if note:
log("%s в %s: %s" % (sender, room_id, note))
except KeyboardInterrupt:
log("остановлен по требованию")
return
except Exception as e:
log("ошибка цикла: %s — повтор через 15 с" % e)
time.sleep(15)
if __name__ == "__main__":
main()
+16
View File
@@ -0,0 +1,16 @@
[Unit]
Description=Buryan VPN bot: выдача VPN-профилей по запросу в Matrix
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
ExecStart=/usr/bin/python3 /opt/buryan-hub/scripts/matrix-vpn-bot.py
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal
SyslogIdentifier=matrix-vpn-bot
[Install]
WantedBy=multi-user.target