Files
buryan-infra/ops/vpn/matrix-distribute.py
T
root 4c4c2a80ac VPN: описания комнат теперь говорят, что делать
ЗАМЕЧЕНО: комната называлась «VPN — Сергей», а описание гласило
«Профиль VPN для Сергей. Ключ только ваш...». На главный вопрос
человека — «что мне делать?» — это не отвечает. Плюс грамматическая
ошибка: «для Сергей» вместо «для Сергея».

СТАЛО: описание сразу говорит, что набрать и что получится:
«Профиль VPN для Сергея. Чтобы проверить, всё ли готово, напишите
здесь «!vpn check» — я отвечу, что на месте и что осталось сделать.
Свой профиль можно получить заново командой «!vpn»...»

Мелочь, но именно такие мелочи решают, дойдёт этап до людей или
человек закроет комнату и не поймёт, что от него хотели.

Обновлены все 6 комнат; скрипт fix-room-topics.py сохранён, чтобы
привести в порядок и будущие. Создание новых комнат в
matrix-distribute.py тоже исправлено. Падеж подставлен правильный.
2026-10-16 21:28:07 +03:00

483 lines
21 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# -*- 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()