VPN: проверка «канал работает» в наблюдении + команда !vpn link

Задача 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 ссылка,
а также отказ на чужой ключ и молчание на обычный текст.
This commit is contained in:
root committed 2026-10-16 20:53:09 +03:00
1 parent 0bcbcaaf2b
commit cd2657b2f8
4 files changed
+223 -5

No files matched your search

+1 -1
View File
@@ -108,7 +108,7 @@
| № | Задача | Состояние |
|---|---|---|
| 4.1 | Второй шлюз | ⬜ |
| 4.2 | Проверка «VPN работает» в наблюдении | ⬜ |
| 4.2 | Проверка «VPN работает» в наблюдении | ✅ |
### Что сделано по VPN 17.10.2026
+52 -1
View File
@@ -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`.
+32 -3
View File
@@ -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)
+138
View File
@@ -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" <<CLIENTEOF
{
"log": {"loglevel": "warning"},
"inbounds": [
{"listen": "127.0.0.1", "port": $SOCKS_PORT, "protocol": "socks",
"settings": {"udp": true, "auth": "noauth"}}
],
"outbounds": [
{"protocol": "vless", "tag": "proxy",
"settings": {"vnext": [{"address": "127.0.0.1", "port": 10443,
"users": [{"id": "$UUID", "encryption": "none"}]}]},
"streamSettings": {"network": "tcp", "security": "tls",
"tlsSettings": {"serverName": "$SNI", "fingerprint": "$FP",
"allowInsecure": false}}},
{"protocol": "freedom", "tag": "direct"}
]
}
CLIENTEOF
# Своя проверка конфигурации ДО запуска
if ! xray run -test -config "$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