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`.