VPN: готовые профили доставлены, исправлена видимость комнат

Профили с раздельной маршрутизацией (.yaml для FlClash, .json для
Hiddify) и инструкция отправлены всем шестерым — и в личные комнаты
Matrix, и выложены на страницу раздачи. Адрес и пароль страницы
не менялись.

Проверено по факту, а не по отчёту бота: файл скачивался глазами
получателя и сверялся с исходным по SHA-256. Все 6 человек: по 2 файла,
оба целые, инструкция на месте. Плюс сквозная проверка, что после
добавления 204 правил домашний домен по-прежнему идёт в туннель
(git.buryans.ru -> [proxy]), а прочее напрямую.

НАЙДЕНА И ИСПРАВЛЕНА ТРЕТЬЯ ПОЛОМКА. Комнаты выдачи создавались
с видимостью истории "joined": человек видит только то, что отправлено
ПОСЛЕ его вступления. Пока он только приглашён, отправленные ему
профили ему НЕ видны — со стороны это выглядит как "мне ничего не
пришло", хотя на сервере всё лежит.

То есть Сергей, Елена и Полина физически не могли увидеть ни ключ,
ни профиль, пока не приняли бы приглашение. А приняли бы они его,
скорее всего, именно увидев сообщение — которого не видели. Замкнутый
круг, из-за которого раздача могла молча не дойти до трёх человек
из шести.

Исправлено: все шесть комнат переведены на "shared", приглашённые видят
присланное сразу. Проверено. Скрипт создания комнат тоже исправлен,
чтобы это не вернулось; отдельный скрипт fix-room-visibility.py
приводит уже созданные комнаты в порядок.

Урок общий и повторяющийся: проверять надо ГЛАЗАМИ ПОЛУЧАТЕЛЯ, а не
состоянием на сервере. Оба раза проблему нашла именно такая проверка —
сначала в личных комнатах бота, теперь в комнатах выдачи.
This commit is contained in:
root committed 2026-10-16 21:20:31 +03:00
1 parent d4122e822f
commit 21df3bf34d
4 files changed
+216 -17

No files matched your search

+1
View File
@@ -83,6 +83,7 @@
| 1.2 | Инструкция для семьи (`docs/VPN-FOR-FAMILY.md`) | ✅ |
| 1.3 | **Проверить на телефонах Сергея и AlexTest** | 🔶 ждёт устройств |
| 1.4 | Раздать остальным | ✅ выдано всем шестерым |
| 1.7 | Выдать готовые профили с раздельной маршрутизацией | ✅ доставлено и проверено |
| 1.6 | Выдача доступа новому человеку одной командой админа | ✅ `!vpn give @логин` |
| 1.5 | Разместить ссылки в Vaultwarden | ⬜ |
+39
View File
@@ -227,3 +227,42 @@ failed to open file: geosite.dat
Профили содержат ключи, поэтому папка `ops/vpn/build/` внесена
в `.gitignore` и в Git не попадает — проверено через `git check-ignore`.
В репозитории лежат только скрипты и списки доменов.
## 8. Профили доставлены (17.10.2026)
Оба профиля (`.yaml` для FlClash и `.json` для Hiddify) вместе с
инструкцией отправлены **всем шестерым** — и в личные комнаты Matrix,
и выложены на страницу раздачи.
Проверено по факту, а не по отчёту бота: файл скачивался глазами
получателя и сверялся с исходным по SHA-256.
| Кому | Вход | Файлов | Целых | Инструкция |
|---|---|---|---|---|
| Роман | вошёл | 2 | 2 | есть |
| Сергей | приглашён | 2 | 2 | есть |
| AlexTest | вошёл | 2 | 2 | есть |
| Елена | приглашена | 2 | 2 | есть |
| Полина | приглашена | 2 | 2 | есть |
| Никита | вошёл | 2 | 2 | есть |
### Третья поломка, найденная проверкой
Комнаты выдачи создавались с видимостью истории **`joined`**. Это значит:
человек видит только то, что отправлено **после** его вступления. Пока он
только **приглашён**, отправленные ему профили ему **не видны** — и со
стороны это выглядит как «мне ничего не пришло», хотя на сервере всё
лежит.
То есть три человека (Сергей, Елена, Полина) физически не могли увидеть
ни ключ, ни профиль, пока не приняли бы приглашение. Причём приняли бы
они его, скорее всего, именно потому, что увидели бы сообщение — которого
не видели. Замкнутый круг.
**Исправлено:** все шесть комнат переведены на `shared`. Теперь
приглашённый видит присланное **сразу**. Скрипт создания комнат
(`ops/vpn/matrix-distribute.py`) тоже исправлен, чтобы это не вернулось.
Это тот же урок, что и с личными комнатами бота (там я его уже прошёл).
Урок общий: **проверять надо глазами получателя, а не состоянием на
сервере.** Оба раза проблему нашла именно такая проверка.
+85
View File
@@ -0,0 +1,85 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Исправляет видимость истории в комнатах выдачи: joined -> shared.
ЗАЧЕМ. Комнаты создавались с видимостью «joined»: человек видит только
то, что отправлено ПОСЛЕ его вступления. Пока он только приглашён,
отправленные профили для него невидимы — со стороны это выглядит как
«мне ничего не пришло», и человек просто не знает, что делать.
С «shared» приглашённый видит, что ему прислали, сразу.
Это тот же урок, что и с личными комнатами бота: там я это уже
исправил, а комнаты выдачи остались старыми.
Запуск: python3 fix-room-visibility.py
"""
import json
import urllib.error
import urllib.parse
import urllib.request
HS = "http://192.168.1.155:8008"
STATE = "/root/.buryan-vpn-matrix-state.json"
WHO = [("akadmin", "Роман"), ("sergey", "Сергей"), ("alextest", "AlexTest"),
("elena", "Елена"), ("polina", "Полина"), ("nikita", "Никита")]
tok = None
for line in open("/root/.buryan-notify.env", encoding="utf-8"):
if line.startswith("MATRIX_ACCESS_TOKEN="):
tok = line.split("=", 1)[1].strip()
def api(method, path, data=None):
headers = {"Authorization": "Bearer " + tok}
body = None
if data is not None:
body = json.dumps(data).encode()
headers["Content-Type"] = "application/json"
req = urllib.request.Request(HS + path, 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:
return {"_error": e.code,
"_detail": e.read()[:200].decode("utf-8", "replace")}
state = json.load(open(STATE, encoding="utf-8"))
print("%-9s %-10s %s" % ("кому", "было", "стало"))
print("-" * 48)
changed = 0
for login, person in WHO:
info = state.get(login) or {}
room = info.get("room")
if not room:
print("%-9s %s" % (person, "комнаты нет"))
continue
q = urllib.parse.quote(room)
before = api("GET", "/_matrix/client/v3/rooms/%s/state/m.room.history_visibility"
% q).get("history_visibility", "?")
if before == "shared":
print("%-9s %-10s уже shared, менять не нужно" % (person, before))
continue
res = api("PUT", "/_matrix/client/v3/rooms/%s/state/m.room.history_visibility"
% q, {"history_visibility": "shared"})
if "_error" in res:
print("%-9s %-10s ОШИБКА: %s" % (person, before, res["_detail"][:60]))
continue
after = api("GET", "/_matrix/client/v3/rooms/%s/state/m.room.history_visibility"
% q).get("history_visibility", "?")
changed += 1
print("%-9s %-10s %s" % (person, before, after))
print()
print("исправлено комнат: %d" % changed)
print()
print("Теперь приглашённые увидят отправленные профили, не дожидаясь")
print("принятия приглашения.")
+91 -17
View File
@@ -64,7 +64,14 @@ def load_token():
sys.exit("в %s нет MATRIX_ACCESS_TOKEN" % NOTIFY_ENV)
def api(method, path, data=None, raw=False, content_type=None):
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}
@@ -75,14 +82,36 @@ def api(method, path, data=None, raw=False, content_type=None):
else:
body = json.dumps(data).encode()
headers["Content-Type"] = "application/json"
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")
raise RuntimeError("%s %s -> %s: %s" % (method, path.split("?")[0], e.code, detail))
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):
@@ -135,6 +164,16 @@ def find_existing_room(alias_localpart):
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,
@@ -148,7 +187,7 @@ def create_room(alias_localpart, title, topic, invite):
{"type": "m.room.guest_access", "state_key": "",
"content": {"guest_access": "forbidden"}},
{"type": "m.room.history_visibility", "state_key": "",
"content": {"history_visibility": "joined"}},
"content": {"history_visibility": "shared"}},
],
}
res = api("POST", "/_matrix/client/v3/createRoom", data=body)
@@ -252,6 +291,8 @@ def main():
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()
@@ -299,10 +340,17 @@ def main():
log("План раздачи:")
for p in plan:
existing = state.get(p["localpart"], {}).get("room", "")
mark = " (комната уже есть: %s)" % existing if existing else ""
log(" %-10s %-9s %-9s %s%s" % (p["person"], p["localpart"], p["key"],
"QR есть" if os.path.exists(p["qr"]) else "QR НЕТ", mark))
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:
@@ -311,9 +359,18 @@ def main():
fresh_ids = []
for p in plan:
log("--- %s (%s), ключ %s ---" % (p["person"], p["localpart"], p["key"]))
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)
@@ -332,13 +389,17 @@ def main():
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:
log(" приглашение: %s" % e)
if "already in the room" in str(e):
log(" приглашение не нужно: человек уже в комнате")
else:
log(" приглашение: %s" % e)
# QR картинкой
if os.path.exists(p["qr"]):
@@ -347,6 +408,7 @@ def main():
os.path.getsize(p["qr"]),
"QR-код VPN — %s" % p["person"])
log(" QR отправлен картинкой (%s)" % mxc)
time.sleep(1)
else:
log(" ВНИМАНИЕ: файла QR нет — отправляю только ссылку")
@@ -355,12 +417,24 @@ def main():
"Ключ (на случай, если 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"),