#!/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(): """Токен бота. Берём из того же файла, что и уведомления. Переменной окружения BOT_TOKEN_FILE можно подменить — это нужно для живой проверки цикла: временному участнику выдаётся отдельный токен, и он шлёт команду по-настоящему, а не через самопроверку. """ global TOKEN path = os.environ.get("BOT_TOKEN_FILE", NOTIFY_ENV) for line in open(path, encoding="utf-8"): if line.startswith("MATRIX_ACCESS_TOKEN="): TOKEN = line.split("=", 1)[1].strip() elif line.startswith("BOT_TOKEN="): TOKEN = line.split("=", 1)[1].strip() if not TOKEN: sys.exit("нет MATRIX_ACCESS_TOKEN или BOT_TOKEN в %s" % path) 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, history="shared"): """Личная комната с человеком. Заводится один раз и запоминается. История — «shared», а не «joined», и это важно. При выдаче доступа человек в комнате ещё только ПРИГЛАШЁН. С видимостью «joined» он увидел бы только то, что отправлено после его вступления, — то есть приглашение с профилем внутри оказалось бы для него пустым. С «shared» приглашённый видит, что ему прислали, сразу. Хранится в ОТДЕЛЬНОМ файле: токен синхронизации переписывается на каждом круге, и если держать личные комнаты в том же файле, они затираются. """ 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": history}}, ], }) 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, link_only=False): """Отправляет профиль личным сообщением. Возвращает текст для журнала.""" 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") # link_only: только строка-ссылка. Нужно, когда человек настраивает # телефон, держа его же в руках: QR с того же экрана не считать, # а ссылку из сообщения можно просто скопировать. if link_only: send_text(room, "Профиль %s — строка для вставки в приложение " "(«Импорт из ссылки»):\n%s" % (key_name, prof["link"])) return "только ссылка в личную комнату %s" % room 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 — прислать ваш профиль личным сообщением (с QR-кодом)\n" " !vpn link — прислать только строку-ссылку, без картинки:\n" " удобно, когда настраиваете телефон на нём же\n" " !vpn check — проверить, всё ли у вас на месте, и что делать\n" " !vpn list — что выдано и какие ключи свободны\n" " !vpn help — эта подсказка\n" "Для владельца:\n" " !vpn <ключ> — прислать себе указанный ключ\n" " !vpn give @логин — выдать новому человеку свободный ключ\n" " !vpn give @логин 08 — выдать конкретный ключ\n" "Профиль при выдаче уходит личным сообщением самому человеку: " "ключ — это доступ, в общей комнате его показывать нельзя.") 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 full_user_id(name): """Приводит «sergey», «@sergey», «@sergey:matrix.buryans.ru» к полному виду.""" name = name.strip() if not name.startswith("@"): name = "@" + name if ":" not in name: name += ":" + SERVER_NAME return name def assigned_keys(): """Что уже кому выдано — по состоянию раздачи и по личным комнатам.""" state = load_json(STATE_FILE, {}) used = {} for localpart, info in state.items(): if info.get("key"): used[info["key"]] = localpart return used def all_keys(): return sorted(profiles().keys()) def free_keys(): used = assigned_keys() return [k for k in all_keys() if k not in used] def user_exists(user_id): """Есть ли такой человек в Matrix. Проверяем через профиль.""" try: api("GET", "/_matrix/client/v3/profile/" + urllib.parse.quote(user_id)) return True except RuntimeError as e: # 404 — нет такого; прочие ошибки не считаем отсутствием return "404" not in str(e) def handle_give(room_id, sender, args): """Владелец выдаёт профиль другому человеку. Профиль уходит ЛИЧНО получателю, а не в комнату, где сидит владелец: ключ — это доступ, и он не должен оказаться в переписке, куда потом добавят третьего. """ if len(args) < 1: send_text(room_id, "Как выдать доступ:\n" " !vpn give @логин — выдать свободный ключ\n" " !vpn give @логин 08 — выдать конкретный ключ\n" " !vpn list — что выдано, что свободно") return "give: нет получателя" target = full_user_id(args[0]) if target == sender: send_text(room_id, "Это ваш собственный логин. Свой профиль — просто «!vpn».") return "give: получатель — сам владелец" if not user_exists(target): send_text(room_id, "В Matrix нет человека %s. Проверьте логин " "(например, @sergey)." % target) return "give: нет такого человека %s" % target if len(args) >= 2: key_name = normalise_key(args[1]) or args[1] if key_name not in all_keys(): send_text(room_id, "Ключа %s нет. Свободны: %s" % (key_name, ", ".join(free_keys()) or "нет")) return "give: нет ключа %s" % key_name owner = assigned_keys().get(key_name) if owner and owner != target.split(":")[0].lstrip("@"): send_text(room_id, "Ключ %s уже выдан (%s). Если нужно передать " "его другому — сначала отзовите у прежнего." % (key_name, owner)) return "give: ключ %s занят (%s)" % (key_name, owner) else: free = free_keys() if not free: send_text(room_id, "Свободных ключей не осталось. Нужен новый — " "добавлю в конфигурацию и выдам.") return "give: свободных ключей нет" key_name = free[0] note = deliver(target, key_name, room_id) localpart = target.split(":")[0].lstrip("@") # запоминаем, кому что выдали — чтобы это было видно команде !vpn list state = load_json(STATE_FILE, {}) entry = state.setdefault(localpart, {}) entry["key"] = key_name if "room" not in entry: entry["room"] = direct_room(target) entry["given_by"] = sender entry["delivered"] = True save_json(STATE_FILE, state) send_text(room_id, "Выдал %s профиль %s — ушёл ему личным сообщением.\n" "Отозвать: убрать ключ %s из конфигурации xray." % (target, key_name, key_name)) log("ВЫДАЧА: %s выдал %s человеку %s" % (sender, key_name, target)) return "выдал %s человеку %s: %s" % (key_name, target, note) def handle_list(room_id): """Что выдано и что свободно.""" used = assigned_keys() lines = ["Ключи VPN:", ""] for k in all_keys(): who = used.get(k) lines.append(" %-10s %s" % (k, ("выдан: " + who) if who else "свободен")) free = free_keys() lines.append("") lines.append("Свободно: %s" % (", ".join(free) if free else "нет")) send_text(room_id, "\n".join(lines)) 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() # регистр не должен иметь значения: люди пишут «!VPN», «!Vpn», «!vpn». # Если сравнивать строго, команда молча пропадает — так и случилось # на первой живой проверке. if not text.lower().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 arg.lower() in ("give", "выдать", "выдай"): if not is_admin: send_text(room_id, "Выдавать доступ может только владелец.") log("ОТКАЗ: %s пытался выдать доступ" % sender) return "отказ: выдача не админу" return handle_give(room_id, sender, parts[2:]) # Что выдано и что свободно — смотреть можно всем (доступы не раскрываются). 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 с того же # экрана не считать, а ссылку можно скопировать. if arg.lower() in ("link", "ссылка", "текст"): if not room_key: send_text(room_id, "Не знаю, какой профиль вам принадлежит. " "Напишите владельцу — он выдаст.") return "link: нет закреплённого ключа" note = deliver(sender, room_key, room_id, link_only=True) send_text(room_id, "Ссылку отправил личным сообщением — скопируйте её " "и вставьте в приложение («Импорт из ссылки»).") return "ссылка (%s): %s" % (room_key, note) # без имени ключа — свой профиль 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 # «!vpn link» от владельца: разбираем как свою ссылку, а не как имя # ключа — иначе бот искал бы профиль с именем «link» и ничего не нашёл. if arg.lower() in ("link", "ссылка", "текст"): if not room_key: send_text(room_id, "Не знаю, какой профиль вам принадлежит.") return "link владельца: нет закреплённого ключа" note = deliver(sender, room_key, room_id, link_only=True) send_text(room_id, "Ссылку отправил личным сообщением.") return "ссылка владельца (%s): %s" % (room_key, note) 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 # пишу в журнал любое текстовое сообщение: если человек # написал команду, а бот промолчал, это будет видно log("получено от %s: %r" % (sender, body[:80])) 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()