Files
buryan-infra/docs/vpn-clients.md
T
root cd2657b2f8 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 ссылка,
а также отказ на чужой ключ и молчание на обычный текст.
2026-10-16 20:53:09 +03:00

17 KiB
Raw Blame History

Подключение к VPN — рабочий способ

Обновлено 17.10.2026. Рабочий канал — VLESS + TLS на порту 10443 с отпечатком firefox. Проверено с внешнего адреса: трафик реально выходит через VPS.

Для семьи — отдельный простой документ: VPN-FOR-FAMILY.md. Здесь техническая часть.


1. Что работает сейчас

Способ Порт Состояние
VLESS + TLS 10443 ✅ основной рабочий канал
VLESS + Reality 2087 ⚠️ рукопожатие не проходит (причина не найдена)
VLESS + Reality 2053 ⚠️ то же
mtg (Telegram) 9443 ✅ работает, отдельная задача
WireGuard / Headscale — координация сети, не для выхода в интернет

Отпечаток firefox критичен. С chrome не работает — проверено.

2. Доступы

Домен для маскировки (SNI): git.buryans.ru
Адрес сервера:              193.233.210.184
Порт:                       10443
Отпечаток:                  firefox

Сертификат домена git.buryans.ru — Let's Encrypt, действует до 21.12.2026.

3. Ключи

В Git ключей нет (см. policies/secret-policy.md).

Где Что
/root/.buryan-vpn-final (VPS, 600) ссылки VPN, готовые к выдаче
/root/.buryan-vpn-page (VPS, 600) адрес и пароль страницы раздачи
Vaultwarden (vault.buryans.ru) целевое хранилище

10 ключей, у каждого своё имя Buryan-01 … Buryan-10. Именование позволило раздавать доступ по одному и отзывать по одному, не трогая остальных:

Buryan-01 … Buryan-05   — исходные ключи
Buryan-06 … Buryan-10   — добавлены 17.10.2026 на этом этапе

4. Ссылка для телефона (образец)

Подставляется свой UUID вместо <UUID>:

vless://<UUID>@193.233.210.184:10443?encryption=none&security=tls&sni=git.buryans.ru&fp=firefox&type=tcp#Buryan-XX

Параметры по частям:

Часть Значение Почему так
security=tls TLS обычный HTTPS — не выделяется
sni=git.buryans.ru домен сертификат настоящий, домен уже наш
fp=firefox отпечаток без этого не работает
type=tcp транспорт поток без наворотов, стабильнее в РФ
flow пусто на сервере у ключей flow не задан — должно совпадать

5. Приложения

Система Приложение
Android Hiddify, v2rayNG
iPhone Streisand, FoXray
Windows Hiddify, v2rayN
macOS Hiddify, V2Box

Импорт: «+» → «Сканировать QR-код» либо «Импорт из ссылки».

5б. Раздача через Matrix

Решение от 17.10.2026: профили выдаются не только страницей, но и в Matrix. Причина простая: Matrix наш, ключи не уходят на чужие серверы, и человек получает профиль там, где он и так общается с семьёй.

Скрипт: ops/vpn/matrix-distribute.py (на хосте — /root/matrix-distribute.py).

python3 /root/matrix-distribute.py                    # план, ничего не меняет
python3 /root/matrix-distribute.py --send             # отправить всем
python3 /root/matrix-distribute.py --send --only akadmin   # проверить на одном
python3 /root/matrix-distribute.py --verify           # проверить по факту

Главное правило: комната НА КАЖДОГО

Профили не кладём в общую комнату «Семья». Причина: в общей комнате ключи видны всем сразу, и тогда нельзя отозвать доступ одному человеку, не задев остальных. Ради этого мы и делали отдельные ключи (раздел 3).

Вместо этого скрипт заводит приватную комнату #vpn-<логин>:matrix.buryans.ru с названием «VPN — <имя>», приглашает туда одного человека и отправляет ему: картинку QR, ссылку текстом (на случай, если QR не считался) и инструкцию.

Профиль Кому
Buryan-01 Роман (akadmin)
Buryan-03 Сергей (sergey)
Buryan-04 AlexTest (alextest)
Buryan-05 Елена (elena)
Buryan-06 Полина (polina)
Buryan-07 Никита (nikita)
Buryan-02, 08, 09, 10 запас

Карта соответствия задаётся в самом скрипте (RECIPIENTS).

Отдельный мост в Telegram

В комнате «Семья» есть участники вида @telegram_<id> — это люди, пришедшие из Telegram. Если положить профили в такую комнату, ключи уедут в Telegram. Поэтому раздача идёт в отдельные комнаты, куда мост не подключён. Решение о том, нужно ли зеркало в Telegram, — за владельцем.

Особенность этого Synapse: где лежат картинки

Старые пути /_matrix/media/v3/download и /_matrix/media/r0/download на нашем сервере отдают 404. Медиа доступно только по новому пути:

/_matrix/client/v1/media/download/<сервер>/<id>

Проверять доступность картинки нужно именно им — иначе получишь ложный 404 и решишь, что файл потерялся (ровно это и случилось при первой проверке).

Шифрование

E2EE в этих комнатах не включён: ключи лежат в нашей базе в открытом виде. База своя, это допустимо, но знать об этом надо. Для ключа VPN, который можно перевыпустить, риск приемлемый.

5в. Бот: выдача профиля по запросу

Зачем. Человек сменил телефон, потерял сообщение, забыл ссылку — он пишет команду и получает свой профиль заново, не дёргая владельца.

Как устроено (ops/vpn/matrix-vpn-bot.py, служба matrix-vpn-bot):

Команда Кто Что получит
!vpn любой свой профиль (картинка QR + ссылка)
!vpn link любой только строку-ссылку, без картинки
!vpn help любой подсказку
!vpn 08 владелец указанный ключ (в том числе запасной)
!vpn 04 не владелец отказ

Регистр не важен: !VPN, !Vpn, !впн работают одинаково. !vpn link нужен для настройки на самом телефоне: QR с того же экрана не считать, а ссылку из сообщения можно скопировать и вставить в приложение через «Импорт из ссылки».

Ответ приходит личным сообщением, а не в комнату. Это не украшение, а условие безопасности: в комнате «VPN — Сергей» сидит только Сергей и бот, но если отвечать в комнату, то при добавлении туда кого-то третьего он увидит чужой ключ. Ключ — это доступ.

Свой профиль человек получает только по своему Matrix-логину: комната «VPN — <логин>» заранее закреплена за конкретным ключом. Спросить чужой нельзя — иначе доступ к чужому аккаунту в Matrix означал бы доступ к чужому VPN.

Где слушает. Только в комнатах выдачи («VPN — …» и личные комнаты). В «Семье» и в тревогах бот молчит — там профилей быть не должно.

Владельцы. Право запросить любой ключ есть у @akadmin и @comms_agent (единственные админы Matrix).

Устройство, о котором стоит знать

  • Бот работает циклом синхронизации (/sync), точка отсчёта хранится в /root/.buryan-vpn-bot-token.json.
  • При первом запуске бот только берёт точку отсчёта и старые сообщения не обрабатывает. Иначе после перезапуска он увидел бы прежние команды и разослал профили повторно.
  • Личные комнаты хранятся отдельным файлом (/root/.buryan-vpn-bot-direct.json). Если держать их вместе с точкой отсчёта, они затираются на каждом круге — так и случилось при разработке.

Проверка

systemctl status matrix-vpn-bot --no-pager
journalctl -u matrix-vpn-bot -n 30 --no-pager

# самопроверка: команда подаётся так, будто её прислал человек
python3 /opt/buryan-hub/scripts/matrix-vpn-bot.py --self-test --as=akadmin --command='!vpn'
python3 /opt/buryan-hub/scripts/matrix-vpn-bot.py --self-test --as=sergey --command='!vpn 04'

Вторая команда обязана дать отказ — это проверка, что чужой ключ не утекает.

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в. Проверка встроенной проверки

# запустить только новую проверку, не весь цикл наблюдения
FUNC=$(awk '/^check_vpn\(\)/,/^}/' /opt/buryan-hub/scripts/check-services.sh)
eval "$FUNC"; check_vpn; echo "код: $?"

Ожидаемый результат: код: 0 и PASSED увеличился на единицу.

6. Как выдать доступ новому человеку

  1. Взять свободный ключ из /root/.buryan-vpn-final.
  2. Собрать ссылку по образцу из раздела 4.
  3. Сделать QR-код.
  4. Отдать человеку вместе с VPN-FOR-FAMILY.md.

Свободные ключи кончились — добавить новый:

# 1. новый UUID
uuidgen

# 2. добавить в три входящих (10443, 2087, 2053) в /usr/local/etc/xray/config.json
#    с меткой buryan-NN@buryans.ru

# 3. ОБЯЗАТЕЛЬНО проверить до применения
xray run -test -config /usr/local/etc/xray/config.json

# 4. применить
systemctl restart xray

# 5. проверить, что слушает
ss -tlnp | grep -E '10443|2087|2053'

7. Как закрыть доступ одному человеку

Удалить его клиента из всех трёх входящих и перезапустить:

systemctl restart xray

Остальные не пострадают — в этом смысл отдельных ключей.

8. Возврат, если что-то пошло не так

Перед каждой правкой конфиг копируется. Вернуться:

ls -t /usr/local/etc/xray/config.json.before-* | head -1
cp "$(ls -t /usr/local/etc/xray/config.json.before-* | head -1)" /usr/local/etc/xray/config.json
xray run -test -config /usr/local/etc/xray/config.json
systemctl restart xray

9. Известная особенность этого хозяйства

Доступ снаружи бывает непредсказуемым. Наблюдали: с одного провайдера работает, с другого — нет; на одном устройстве работает, на другом нет.

Причина — вмешательство провайдера в поток после установки соединения. Поэтому:

  • не делаем вывод «сломано» по одной неудаче;
  • проверяем минимум на двух сетях (Wi-Fi и мобильная);
  • держим несколько протоколов — это и есть Этап 2.

Замер 17.10.2026 с внешнего адреса: 10 подключений из 10 успешных.

10. Диагностика

# служба и порты
systemctl status xray --no-pager
ss -tlnp | grep -E '10443|2087|2053'

# что видит сервер (самый полезный журнал)
journalctl -u xray -n 50 --no-pager

# проверка конфига до применения
xray run -test -config /usr/local/etc/xray/config.json

Что искать в журнале:

Запись Значение
accepted tcp:... + email: buryan-NN@ ключ работает, видно кто
invalid request version до сервера дошёл не VLESS — обычно это чужой стук в порт
Тишина при попытке с телефона трафик не дошёл: провайдер режет по пути

11. Связанные документы

Файл Что внутри
VPN-FOR-FAMILY.md инструкция для родных, простым языком
ops/network/VPN-STATUS.md состояние и результаты проверок
ops/network/VPN-README.md заметки по Reality
ops/runbooks/vless-vpn.md runbook
ops/vpn/VPN-STAGE1-IMPLEMENTATION.md что именно сделано 17.10.2026 и как откатить