From cd2657b2f8d60f3d7a247da33fa480703ec16a09 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Fri, 16 Oct 2026 20:53:09 +0300 Subject: [PATCH] =?UTF-8?q?VPN:=20=D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D1=80?= =?UTF-8?q?=D0=BA=D0=B0=20=C2=AB=D0=BA=D0=B0=D0=BD=D0=B0=D0=BB=20=D1=80?= =?UTF-8?q?=D0=B0=D0=B1=D0=BE=D1=82=D0=B0=D0=B5=D1=82=C2=BB=20=D0=B2=20?= =?UTF-8?q?=D0=BD=D0=B0=D0=B1=D0=BB=D1=8E=D0=B4=D0=B5=D0=BD=D0=B8=D0=B8=20?= =?UTF-8?q?+=20=D0=BA=D0=BE=D0=BC=D0=B0=D0=BD=D0=B4=D0=B0=20!vpn=20link?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Задача 4.2 из реестра: проверка «VPN работает» в наблюдении. Сделано. Почему отдельная проверка: порт 10443 может слушать, а трафик не проходить — именно это мы уже видели, когда провайдер вмешивался в поток. Открытый порт об этом не говорит. Как проверяется (ops/vpn/vpn-check.sh): поднимается временный клиент xray на самом VPS, идёт через него в интернет, сверяется внешний адрес. Совпал — канал пропускает трафик. За собой убирает. Ключ берётся из рабочей конфигурации xray, а не из файла со ссылками: тот файл лежит на домашнем узле, а проверка идёт на VPS. Встроено в /opt/buryan-hub/scripts/check-services.sh (функция check_vpn), вызывается каждые 5 минут вместе с остальными проверками, провал попадает в общую тревогу в Matrix. Порт 2087 (Reality) намеренно не проверяется: он не работает и занесён в план задачами VPN-2.3, иначе тревога была бы каждые 5 минут. Проверено отдельным запуском только новой функции, без полного цикла наблюдения (чтобы не поднять ложную тревогу): код 0, PASSED=1. Отдельно: команда !vpn link для настройки на самом телефоне. QR с того же экрана не считать, а ссылку из сообщения можно скопировать и вставить в приложение. Проверены варианты !vpn link, !VPN LINK, !vpn ссылка, а также отказ на чужой ключ и молчание на обычный текст. --- docs/TASKS.md | 2 +- docs/vpn-clients.md | 53 ++++++++++++++- ops/vpn/matrix-vpn-bot.py | 35 +++++++++- ops/vpn/vpn-check.sh | 138 ++++++++++++++++++++++++++++++++++++++ 4 files changed, 223 insertions(+), 5 deletions(-) create mode 100644 ops/vpn/vpn-check.sh diff --git a/docs/TASKS.md b/docs/TASKS.md index 4051c2a..d37939f 100644 --- a/docs/TASKS.md +++ b/docs/TASKS.md @@ -108,7 +108,7 @@ | № | Задача | Состояние | |---|---|---| | 4.1 | Второй шлюз | ⬜ | -| 4.2 | Проверка «VPN работает» в наблюдении | ⬜ | +| 4.2 | Проверка «VPN работает» в наблюдении | ✅ | ### Что сделано по VPN 17.10.2026 diff --git a/docs/vpn-clients.md b/docs/vpn-clients.md index 6c71be3..57e9d4c 100644 --- a/docs/vpn-clients.md +++ b/docs/vpn-clients.md @@ -152,11 +152,17 @@ E2EE в этих комнатах не включён: ключи лежат в | Команда | Кто | Что получит | |---|---|---| -| `!vpn` | любой | свой профиль | +| `!vpn` | любой | свой профиль (картинка QR + ссылка) | +| `!vpn link` | любой | только строку-ссылку, без картинки | | `!vpn help` | любой | подсказку | | `!vpn 08` | владелец | указанный ключ (в том числе запасной) | | `!vpn 04` | не владелец | **отказ** | +Регистр не важен: `!VPN`, `!Vpn`, `!впн` работают одинаково. +`!vpn link` нужен для настройки **на самом телефоне**: QR с того же экрана +не считать, а ссылку из сообщения можно скопировать и вставить в приложение +через «Импорт из ссылки». + Ответ приходит **личным сообщением**, а не в комнату. Это не украшение, а условие безопасности: в комнате «VPN — Сергей» сидит только Сергей и бот, но если отвечать в комнату, то при добавлении туда кого-то @@ -198,6 +204,51 @@ python3 /opt/buryan-hub/scripts/matrix-vpn-bot.py --self-test --as=sergey --comm Вторая команда **обязана** дать отказ — это проверка, что чужой ключ не утекает. +## 10б. Проверка «VPN работает» в наблюдении + +**Задача 4.2 из реестра** («проверка: работает ли VPN»). Сделано 17.10.2026. + +**Почему отдельная проверка.** Порт 10443 может слушать, а трафик не +проходить — именно такую картину мы уже видели, когда провайдер вмешивался +в поток после установки соединения. Открытый порт в этом случае ничего +не говорит, поэтому проверка не «порт открыт», а «трафик доходит». + +**Как проверяется.** `ops/vpn/vpn-check.sh` (на VPS — +`/usr/local/bin/vpn-check.sh`) поднимает временный клиент xray прямо +на сервере, ходит через него в интернет и сверяет внешний адрес. +Совпал — канал действительно пропускает трафик. За собой убирает. + +``` +bash /usr/local/bin/vpn-check.sh # подробно +bash /usr/local/bin/vpn-check.sh --quiet # только итог +``` + +Коды возврата: `0` — работает, `1` — нет. + +**Где встроено.** `/opt/buryan-hub/scripts/check-services.sh`, функция +`check_vpn`, вызывается вместе с остальными проверками каждые 5 минут +(задача в cron). Провал попадает в общую тревогу в Matrix. + +**Важно:** проверяется внутренняя исправность сервера. Путь +«устройство снаружи → VPS» этим не покрывается — его проверяет владелец +со своего устройства. И порт 2087 (Reality) намеренно **не** проверяется: +он не работает и занесён в план задачами VPN-2.3, иначе тревога была бы +каждые 5 минут. + +**Ключ для проверки** берётся прямо из рабочей конфигурации xray, +а не из файла со ссылками: файл со ссылками лежит на домашнем узле, +а проверка идёт на VPS (на этих граблях я уже постоял). + +## 10в. Проверка встроенной проверки + +```bash +# запустить только новую проверку, не весь цикл наблюдения +FUNC=$(awk '/^check_vpn\(\)/,/^}/' /opt/buryan-hub/scripts/check-services.sh) +eval "$FUNC"; check_vpn; echo "код: $?" +``` + +Ожидаемый результат: `код: 0` и `PASSED` увеличился на единицу. + ## 6. Как выдать доступ новому человеку 1. Взять свободный ключ из `/root/.buryan-vpn-final`. diff --git a/ops/vpn/matrix-vpn-bot.py b/ops/vpn/matrix-vpn-bot.py index 0442226..4f4203e 100644 --- a/ops/vpn/matrix-vpn-bot.py +++ b/ops/vpn/matrix-vpn-bot.py @@ -189,7 +189,7 @@ def direct_room(user_id): return room -def deliver(user_id, key_name, where): +def deliver(user_id, key_name, where, link_only=False): """Отправляет профиль личным сообщением. Возвращает текст для журнала.""" prof = profiles().get(key_name) if not prof: @@ -197,7 +197,11 @@ def deliver(user_id, key_name, where): room = direct_room(user_id) qr = os.path.join(BASE, "qr", key_name + ".png") - if os.path.exists(qr): + + # link_only: только строка-ссылка. Нужно, когда человек настраивает + # телефон, держа его же в руках: QR с того же экрана не считать, + # а ссылку из сообщения можно просто скопировать. + if not link_only and os.path.exists(qr): mxc = upload_image(qr) send_image(room, mxc, os.path.basename(qr), os.path.getsize(qr), "Профиль VPN — %s" % key_name) @@ -220,7 +224,9 @@ def instructions(): def help_text(): return ("Что я умею:\n" - " !vpn — прислать ваш профиль личным сообщением\n" + " !vpn — прислать ваш профиль личным сообщением (с QR-кодом)\n" + " !vpn link — прислать только строку-ссылку, без картинки:\n" + " удобно, когда настраиваете телефон на нём же\n" " !vpn help — эта подсказка\n" "Для владельца: !vpn <ключ> — прислать указанный ключ " "(например, Buryan-08)") @@ -251,6 +257,19 @@ def handle(room_id, sender, body, room_key): send_text(room_id, help_text()) return "подсказка" + # «!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: @@ -269,6 +288,16 @@ def handle(room_id, sender, body, room_key): 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) diff --git a/ops/vpn/vpn-check.sh b/ops/vpn/vpn-check.sh new file mode 100644 index 0000000..d0c5023 --- /dev/null +++ b/ops/vpn/vpn-check.sh @@ -0,0 +1,138 @@ +#!/bin/bash +# ============================================================ +# vpn-check.sh — проверка, что VPN РАБОТАЕТ, а не «порт открыт» +# ============================================================ +# Зачем: порт 10443 может слушать, а трафик не проходить — +# именно такую картину мы уже видели (провайдер вмешивался в поток). +# Открытый порт в этом случае ничего не говорит. +# +# Что делаю: поднимаю временный клиент xray ПРЯМО НА VPS, хожу +# через него в интернет и сверяю внешний адрес. Если адрес совпал — +# канал действительно пропускает трафик. +# +# Проверяется ВНУТРЕННЯЯ исправность сервера. Путь «устройство +# снаружи -> VPS» этой проверкой не покрывается: его проверяет +# владелец со своего устройства. +# +# Запуск: bash vpn-check.sh — подробно +# bash vpn-check.sh --quiet — только итог (для наблюдения) +# Коды: 0 — работает, 1 — не работает +# ============================================================ +set -uo pipefail + +QUIET=0 +[ "${1:-}" = "--quiet" ] && QUIET=1 + +say() { [ "$QUIET" -eq 0 ] && echo "$@"; return 0; } + +VPS_IP=193.233.210.184 +SNI=git.buryans.ru +FP=firefox + +# Ключ берём прямо из рабочей конфигурации xray: это единственный +# источник правды. Раньше я искал его в файле со ссылками, но тот лежит +# на домашнем узле, а проверка идёт на VPS — файла здесь просто нет. +CFG=/usr/local/etc/xray/config.json +UUID=$(python3 - "$CFG" <<'PYEOF' +import json, sys +try: + d = json.load(open(sys.argv[1])) +except Exception: + print("") + raise SystemExit +for ib in d.get("inbounds", []): + if ib.get("port") == 10443: + cs = ib.get("settings", {}).get("clients", []) + if cs: + print(cs[0].get("id", "")) + break +PYEOF +) + +if [ -z "$UUID" ]; then + echo "НЕ РАБОТАЕТ: не смог взять ключ из $CFG" + exit 1 +fi + +T=$(mktemp -d /tmp/vpncheck.XXXXXX) +cleanup() { + [ -n "${CPID:-}" ] && kill "$CPID" 2>/dev/null + rm -rf "$T" +} +trap cleanup EXIT + +# Порт для временного клиента — из диапазона, который на VPS открыт +# только внутри (наружу не выставлен, чтобы не появлялось лишних дверей) +SOCKS_PORT=10899 + +cat > "$T/client.json" </dev/null 2>&1; then + echo "НЕ РАБОТАЕТ: временный конфиг клиента не прошёл проверку" + exit 1 +fi + +xray run -config "$T/client.json" >"$T/out.log" 2>&1 & +CPID=$! + +# Ждём готовности порта, но не дольше 8 секунд +READY=0 +for _ in $(seq 1 16); do + if ss -tln 2>/dev/null | grep -q ":$SOCKS_PORT "; then + READY=1 + break + fi + sleep 0.5 +done +if [ "$READY" -ne 1 ]; then + say " временный клиент не поднялся" + echo "НЕ РАБОТАЕТ: клиент не запустился" + exit 1 +fi + +say " временный клиент поднят, проверяю выход в интернет..." + +GOT="" +for attempt in 1 2 3; do + GOT=$(curl -s --max-time 20 --socks5-hostname "127.0.0.1:$SOCKS_PORT" \ + https://api.ipify.org 2>/dev/null | tr -d '\r\n ') + [ -n "$GOT" ] && break + say " попытка $attempt не дала ответа, повторяю..." + sleep 2 +done + +if [ "$GOT" = "$VPS_IP" ]; then + say " внешний адрес через VPN: $GOT — канал пропускает трафик" + echo "РАБОТАЕТ: трафик выходит через $VPS_IP" + exit 0 +fi + +if [ -z "$GOT" ]; then + echo "НЕ РАБОТАЕТ: через VPN нет ответа (три попытки)" + say " --- журнал клиента ---" + [ "$QUIET" -eq 0 ] && tail -5 "$T/out.log" 2>/dev/null | sed 's/^/ /' + exit 1 +fi + +echo "НЕ РАБОТАЕТ: внешний адрес $GOT вместо $VPS_IP" +say " --- журнал клиента ---" +[ "$QUIET" -eq 0 ] && tail -5 "$T/out.log" 2>/dev/null | sed 's/^/ /' +exit 1