ЗАМЕЧЕНО: комната называлась «VPN — Сергей», а описание гласило «Профиль VPN для Сергей. Ключ только ваш...». На главный вопрос человека — «что мне делать?» — это не отвечает. Плюс грамматическая ошибка: «для Сергей» вместо «для Сергея». СТАЛО: описание сразу говорит, что набрать и что получится: «Профиль VPN для Сергея. Чтобы проверить, всё ли готово, напишите здесь «!vpn check» — я отвечу, что на месте и что осталось сделать. Свой профиль можно получить заново командой «!vpn»...» Мелочь, но именно такие мелочи решают, дойдёт этап до людей или человек закроет комнату и не поймёт, что от него хотели. Обновлены все 6 комнат; скрипт fix-room-topics.py сохранён, чтобы привести в порядок и будущие. Создание новых комнат в matrix-distribute.py тоже исправлено. Падеж подставлен правильный.
483 lines
21 KiB
Python
483 lines
21 KiB
Python
# -*- 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()
|