# -*- coding: utf-8 -*- """ Раздача VPN-профилей через Matrix (VPN-1.1 … VPN-1.4). ПОЧЕМУ ТАК: * Matrix наш, ключи не уходят на чужие серверы (в отличие от мессенджеров); * комнату заводим НА КАЖДОГО отдельно: свой QR не перемешивается с чужими; * в общей комнате ключи раскрываются всем сразу — так делать нельзя, потому что тогда нельзя отозвать доступ одному, не задев остальных. ЧТО ДЕЛАЕТ: 1. берёт 10 профилей (ссылка + QR); 2. каждому человеку заводит приватную комнату «VPN — <имя>»; 3. приглашает человека; 4. отправляет картинку QR + текст с ссылкой и инструкцией; 5. отправляет инструкцию целиком отдельным текстом. Запуск: python3 matrix-distribute.py # только показать план python3 matrix-distribute.py --send # отправить всем python3 matrix-distribute.py --send --only akadmin """ import argparse 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" BASE = "/root/vpn-dist" # профили и QR, загружаются сюда TOKEN = None # Кому какой профиль. Ключи раскладываются по одному на человека. RECIPIENTS = [ ("akadmin", "Buryan-01", "Роман"), ("sergey", "Buryan-03", "Сергей"), ("alextest", "Buryan-04", "AlexTest"), ("elena", "Buryan-05", "Елена"), ("polina", "Buryan-06", "Полина"), ("nikita", "Buryan-07", "Никита"), ] SERVER_NAME = "matrix.buryans.ru" def log(msg): print(msg, flush=True) def load_token(): global TOKEN if not os.path.exists(NOTIFY_ENV): sys.exit("НЕТ ФАЙЛА %s — не знаю токен" % NOTIFY_ENV) 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("в %s нет MATRIX_ACCESS_TOKEN" % NOTIFY_ENV) def api(method, path, data=None, raw=False, content_type=None, attempts=5): """Запрос к Matrix. Synapse ограничивает частоту запросов и отвечает 429 Too Many Requests с полем retry_after_ms. Без обработки этого ответа раздача рвётся на середине: часть людей получает профиль, часть нет — и понять, кто именно, можно только разбором. Поэтому 429 пережидаем и повторяем. """ url = HS + path body = None headers = {"Authorization": "Bearer " + TOKEN} 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(url, data=body, headers=headers, method=method) try: with urllib.request.urlopen(req, timeout=30) 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 = None try: wait = json.loads(detail).get("retry_after_ms") except Exception: pass if wait: seconds = wait / 1000.0 else: seconds = 2 ** attempt seconds = min(seconds + 0.5, 60) log(" (сервер просит подождать, пережидаю %.1f с, попытка %d из %d)" % (seconds, attempt + 1, attempts)) time.sleep(seconds) code, detail = last if last else ("?", "") raise RuntimeError("%s %s -> %s: %s" % (method, path.split("?")[0], code, detail)) def upload_image(path): """Заливает картинку в Matrix, возвращает mxc://-ссылку.""" ctype = mimetypes.guess_type(path)[0] or "image/png" name = os.path.basename(path) q = urllib.parse.urlencode({"filename": name}) with open(path, "rb") as f: blob = f.read() res = api("POST", "/_matrix/media/v3/upload?" + q, data=blob, raw=True, content_type=ctype) return res["content_uri"] def txn(prefix): return "%s-%d" % (prefix, int(time.time() * 1000)) def send_text(room, text, html=None): body = {"msgtype": "m.text", "body": text} if html: body["format"] = "org.matrix.custom.html" body["formatted_body"] = html return api("PUT", "/_matrix/client/v3/rooms/%s/send/m.room.message/%s" % (urllib.parse.quote(room), txn("txt")), data=body) def send_image(room, mxc, name, size, caption): body = { "msgtype": "m.image", "body": name, "url": mxc, "info": {"mimetype": "image/png", "size": size, "w": 732, "h": 732}, } if caption: body["body"] = caption return api("PUT", "/_matrix/client/v3/rooms/%s/send/m.room.message/%s" % (urllib.parse.quote(room), txn("img")), data=body) def find_existing_room(alias_localpart): """Ищет уже созданную комнату по псевдониму — чтобы не плодить дубли.""" try: alias = "#%s:%s" % (alias_localpart, SERVER_NAME) res = api("GET", "/_matrix/client/v3/directory/room/" + urllib.parse.quote(alias)) return res.get("room_id") except RuntimeError: return None def create_room(alias_localpart, title, topic, invite): """Комната выдачи для одного человека. Видимость истории — «shared», а НЕ «joined», и это существенно. С «joined» приглашённый видит только то, что отправлено после его вступления: пока он не принял приглашение, отправленные профили для него невидимы, и со стороны это выглядит как «мне ничего не пришло». С «shared» он видит присланное сразу. Проверено 17.10.2026: комнаты пришлось переводить на «shared» отдельно, потому что создавались с «joined». """ alias = "#%s:%s" % (alias_localpart, SERVER_NAME) body = { "name": title, "topic": topic, "preset": "private_chat", "visibility": "private", "invite": [invite], "room_alias_name": alias_localpart, "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": "shared"}}, ], } res = api("POST", "/_matrix/client/v3/createRoom", data=body) return res["room_id"] def media_download(mxc): """Скачивает файл из хранилища Matrix. Важно: старые пути /_matrix/media/v3|r0/download на этом сервере отдают 404 — Synapse отдаёт медиа только через новый authed-путь /_matrix/client/v1/media/download. Проверять доступность картинки надо именно им, иначе получишь ложный 404. """ if not mxc.startswith("mxc://"): return None, 0 server, media_id = mxc[len("mxc://"):].split("/", 1) path = "/_matrix/client/v1/media/download/%s/%s" % ( urllib.parse.quote(server), urllib.parse.quote(media_id)) req = urllib.request.Request(HS + path, headers={"Authorization": "Bearer " + TOKEN}) try: with urllib.request.urlopen(req, timeout=30) as r: blob = r.read() return blob, len(blob) except Exception: return None, 0 def verify(only=None): """Проверяет по факту: комната, получатель, приватность, картинка.""" if not os.path.exists(STATE_FILE): log("Нет состояния — значит раздача ещё не запускалась") return state = json.load(open(STATE_FILE, encoding="utf-8")) log("Проверка отправленного:") log("") problems = 0 for localpart, key_name, person in RECIPIENTS: if only and localpart != only: continue info = state.get(localpart) if not info or not info.get("room"): log(" %-10s — не отправлялось" % person) continue room = info["room"] user_id = "@%s:%s" % (localpart, SERVER_NAME) try: name = api("GET", "/_matrix/client/v3/rooms/%s/state/m.room.name" % urllib.parse.quote(room)).get("name", "(без имени)") except RuntimeError as e: log(" %-10s ОШИБКА имени: %s" % (person, e)); problems += 1; continue try: mem = api("GET", "/_matrix/client/v3/rooms/%s/state/m.room.member/%s" % (urllib.parse.quote(room), urllib.parse.quote(user_id))) membership = mem.get("membership") except RuntimeError: membership = "нет?" try: rules = api("GET", "/_matrix/client/v3/rooms/%s/state/m.room.join_rules" % urllib.parse.quote(room)).get("join_rule") except RuntimeError: rules = "?" try: msgs = api("GET", "/_matrix/client/v3/rooms/%s/messages?dir=b&limit=20" % urllib.parse.quote(room)).get("chunk", []) except RuntimeError: msgs = [] images = [e for e in msgs if e.get("content", {}).get("msgtype") == "m.image"] texts = [e for e in msgs if e.get("content", {}).get("msgtype") == "m.text"] img_state = "нет картинки" if images: mxc = images[0]["content"].get("url", "") blob, size = media_download(mxc) if blob and blob[:8] == b"\x89PNG\r\n\x1a\n": img_state = "картинка целая (%d байт)" % size else: img_state = "КАРТИНКА НЕ СКАЧИВАЕТСЯ (%s)" % mxc problems += 1 ok = membership in ("join", "invite") if not ok: problems += 1 log(" %-10s %-9s %s" % (person, key_name, name)) log(" получатель: %-9s | вход: %-14s | комната: %s" % (membership, "только по приглашению" if rules == "invite" else rules, img_state)) log(" текстов в комнате: %d" % len(texts)) log("") if problems: log("НАЙДЕНЫ ЗАМЕЧАНИЯ: %d" % problems) else: log("ВСЁ В ПОРЯДКЕ: получатели в комнатах, картинки целые") def main(): ap = argparse.ArgumentParser() ap.add_argument("--send", action="store_true", help="реально отправлять (без флага — только показать план)") ap.add_argument("--only", help="только одному человеку (localpart)") ap.add_argument("--force", action="store_true", help="отправить повторно, даже если уже отмечено доставленным") ap.add_argument("--verify", action="store_true", help="проверить, что отправленное реально доступно получателю") args = ap.parse_args() load_token() me = api("GET", "/_matrix/client/v3/account/whoami") log("Бот: %s" % me["user_id"]) if args.verify: verify(args.only) return log("Режим: %s" % ("ОТПРАВКА" if args.send else "показать план (ничего не меняется)")) log("") profiles_path = os.path.join(BASE, "profiles.json") if not os.path.exists(profiles_path): sys.exit("НЕТ %s — сначала выгрузите туда профили" % profiles_path) profiles = {p["name"]: p for p in json.load(open(profiles_path, encoding="utf-8"))} state = {} if os.path.exists(STATE_FILE): state = json.load(open(STATE_FILE, encoding="utf-8")) plan = [] for localpart, key_name, person in RECIPIENTS: if args.only and localpart != args.only: continue if key_name not in profiles: log(" ПРОПУСК: нет профиля %s" % key_name) continue qr = os.path.join(BASE, "qr", key_name + ".png") plan.append({ "localpart": localpart, "user_id": "@%s:%s" % (localpart, SERVER_NAME), "person": person, "key": key_name, "qr": qr, "link": profiles[key_name]["link"], }) if not plan: log("Нечего делать: ни одного получателя не выбрано") return log("План раздачи:") for p in plan: mark = "" if os.path.exists(p["qr"]): mark = "QR есть" else: mark = "QR НЕТ" st = state.get(p["localpart"], {}) if st.get("delivered"): mark += ", уже отправлено" elif st.get("room"): mark += ", комната есть, отправка не завершена" log(" %-10s %-9s %-9s %s" % (p["person"], p["localpart"], p["key"], mark)) log("") if not args.send: log("Это был только план. Для отправки добавьте --send") return fresh_ids = [] for p in plan: info = state.get(p["localpart"], {}) # Защита от повторной отправки: если человеку уже всё доставлено, # второй прогон не должен дублировать сообщения. Отправить заново # можно только осознанно — с ключом --force. if info.get("delivered") and not args.force: log("--- %s (%s) — уже отправлено, пропускаю (для повтора: --force)" % (p["person"], p["localpart"])) continue log("--- %s (%s), ключ %s ---" % (p["person"], p["localpart"], p["key"])) room = info.get("room") if room: log(" комната уже есть: %s" % room) else: alias_local = "vpn-%s" % p["localpart"] room = find_existing_room(alias_local) if room: log(" нашёл комнату по псевдониму: %s" % room) else: room = create_room( alias_local, "VPN — %s" % p["person"], "Профиль VPN для %s. Чтобы проверить, всё ли готово, " "напишите здесь «!vpn check» — я отвечу, что на месте " "и что осталось сделать. Свой профиль можно получить " "заново командой «!vpn». Ключ только ваш: не передавайте " "его другим." % p["person"], p["user_id"], ) log(" комната создана: %s" % room) state.setdefault(p["localpart"], {})["room"] = room # приглашение (повторное не мешает: если человек уже в комнате — это не ошибка) try: api("POST", "/_matrix/client/v3/rooms/%s/invite" % urllib.parse.quote(room), data={"user_id": p["user_id"]}) log(" приглашение отправлено") time.sleep(1) except RuntimeError as e: if "already in the room" in str(e): log(" приглашение не нужно: человек уже в комнате") else: log(" приглашение: %s" % e) # QR картинкой if os.path.exists(p["qr"]): mxc = upload_image(p["qr"]) send_image(room, mxc, os.path.basename(p["qr"]), os.path.getsize(p["qr"]), "QR-код VPN — %s" % p["person"]) log(" QR отправлен картинкой (%s)" % mxc) time.sleep(1) else: log(" ВНИМАНИЕ: файла QR нет — отправляю только ссылку") # ссылка текстом: если картинка не пройдёт, профиль всё равно можно вставить send_text(room, "Ключ (на случай, если QR не считался) — вставьте эту строку в приложение:\n" + p["link"]) log(" ссылка отправлена текстом") time.sleep(1) # инструкция send_text(room, INSTRUCTION) log(" инструкция отправлена") # отмечаю доставленным и сохраняю сразу: если следующий человек # упрётся в ограничение частоты, уже отправленное не потеряется state.setdefault(p["localpart"], {})["room"] = room state[p["localpart"]]["delivered"] = True state[p["localpart"]]["key"] = p["key"] json.dump(state, open(STATE_FILE, "w", encoding="utf-8"), ensure_ascii=False, indent=2) os.chmod(STATE_FILE, 0o600) fresh_ids.append(room) # пауза между людьми: Synapse ограничивает частоту запросов time.sleep(3) log("") json.dump(state, open(STATE_FILE, "w", encoding="utf-8"), ensure_ascii=False, indent=2) os.chmod(STATE_FILE, 0o600) log("Готово. Комнат обработано: %d" % len(fresh_ids)) log("Состояние: %s" % STATE_FILE) INSTRUCTION = """Как подключить VPN на телефоне 1. Поставьте приложение. Android: Hiddify (проще) или v2rayNG — оба бесплатны. iPhone: Streisand или FoXray. 2. Отсканируйте QR-код выше: в приложении «+» → «Сканировать QR-код». QR нельзя отсканировать на том же экране, где он открыт — поэтому откройте это сообщение на компьютере, а сканируйте телефоном. Или скопируйте ссылку из предыдущего сообщения: «+» → «Импорт из ссылки». 3. Нажмите кнопку подключения. Телефон спросит разрешение на VPN — разрешите. 4. Проверьте: откройте 2ip.ru. Должен показаться адрес 193.233.210.184. 5. Отключите экономию батареи для VPN-приложения (Настройки → Приложения → ваше приложение → Батарея → «Без ограничений»), иначе связь будет рваться. Важно про браузер: встроенный браузер Xiaomi (MIUI) не видит домашние адреса. Для домашних служб пользуйтесь Chrome или Firefox. Если не подключается — переключитесь между Wi-Fi и мобильной сетью и напишите мне. Это ожидаемо: у разных операторов связь ведёт себя по-разному, и у нас готовятся ещё два запасных способа. Ключ только ваш. Не пересылайте его другим: тогда при необходимости закрыть доступ одному не придётся менять ключи всем.""" if __name__ == "__main__": main()