From 022067e6362e7061c4e75d4afc10a8b49dea90bf Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Fri, 16 Oct 2026 20:44:05 +0300 Subject: [PATCH] =?UTF-8?q?VPN:=20=D0=B1=D0=BE=D1=82=20=D0=B2=D1=8B=D0=B4?= =?UTF-8?q?=D0=B0=D1=87=D0=B8=20=D0=BF=D1=80=D0=BE=D1=84=D0=B8=D0=BB=D0=B5?= =?UTF-8?q?=D0=B9=20=D0=BF=D0=BE=20=D0=B7=D0=B0=D0=BF=D1=80=D0=BE=D1=81?= =?UTF-8?q?=D1=83=20+=20=D1=80=D0=B0=D1=81=D1=81=D1=8B=D0=BB=D0=BA=D0=B0?= =?UTF-8?q?=20=D1=81=D0=B5=D0=BC=D1=8C=D0=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Рассылка: профили отправлены всем шестерым, каждому в свою приватную комнату. Проверено --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. --- docs/vpn-clients.md | 55 ++++ ops/vpn/VPN-STAGE1-IMPLEMENTATION.md | 57 +++++ ops/vpn/matrix-vpn-bot.py | 360 +++++++++++++++++++++++++++ ops/vpn/matrix-vpn-bot.service | 16 ++ 4 files changed, 488 insertions(+) create mode 100644 ops/vpn/matrix-vpn-bot.py create mode 100644 ops/vpn/matrix-vpn-bot.service diff --git a/docs/vpn-clients.md b/docs/vpn-clients.md index 5bd359e..6c71be3 100644 --- a/docs/vpn-clients.md +++ b/docs/vpn-clients.md @@ -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`. diff --git a/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md b/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md index 305485f..18d91a9 100644 --- a/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md +++ b/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md @@ -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. Личные комнаты затирались.** Они хранились в том же файле, что и точка +отсчёта, а точка перезаписывается на каждом круге. Вынесены в отдельный +файл. + +### Чего бот не делает + +* Не отвечает профилем в комнату — только личным сообщением. +* Не слушает «Семью» и тревоги. +* Не отдаёт чужой профиль никому, кроме двух админов. diff --git a/ops/vpn/matrix-vpn-bot.py b/ops/vpn/matrix-vpn-bot.py new file mode 100644 index 0000000..782534f --- /dev/null +++ b/ops/vpn/matrix-vpn-bot.py @@ -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() diff --git a/ops/vpn/matrix-vpn-bot.service b/ops/vpn/matrix-vpn-bot.service new file mode 100644 index 0000000..8adec7e --- /dev/null +++ b/ops/vpn/matrix-vpn-bot.service @@ -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