Files
buryan-infra/docs/vpn-clients.md
T
root 022067e636 VPN: бот выдачи профилей по запросу + рассылка семье
Рассылка: профили отправлены всем шестерым, каждому в свою приватную
комнату. Проверено --verify: у всех вход только по приглашению, у всех
картинка QR скачивается целой (1759-1872 байта, сигнатура PNG верна).

Бот (ops/vpn/matrix-vpn-bot.py, служба matrix-vpn-bot):
  !vpn        -> свой профиль
  !vpn help   -> подсказка
  !vpn 08     -> владельцу: указанный ключ
  !vpn 04     -> не владельцу: ОТКАЗ

Ответ уходит ЛИЧНЫМ сообщением, а не в комнату. Это условие безопасности:
ключ - это доступ, и он не должен оказаться в комнате, куда потом
добавят третьего человека. Свой профиль выдаётся только по своему
Matrix-логину, чужой запросить нельзя.

Проверено самопроверкой: владелец получил запасной ключ, обычный
пользователь получил отказ (отказ записан в журнал), свой профиль
и подсказка работают.

Три случая, которые чуть не сломали работу:
1. Synapse ответил 429 на первую рассылку - она оборвалась на середине,
   двое получили комнату без инструкции, состояние не сохранилось.
   Исправлено: 429 пережидается по retry_after_ms, состояние пишется
   после каждого человека, признак delivered не даёт дублировать
   отправку. Комнаты, созданные до падения, восстановлены по псевдониму
   #vpn-<логин>, а не пересозданы.
2. При первом запуске /sync отдаёт последние события комнат - бот
   обработал бы старые команды заново после каждого перезапуска.
   Исправлено: первый запуск только берёт точку отсчёта.
3. Личные комнаты хранились в одном файле с точкой отсчёта и затирались
   на каждом круге. Вынесены в отдельный файл.

Бот не слушает "Семью" и тревоги, не отвечает профилем в комнату
и не отдаёт чужой профиль никому, кроме двух админов Matrix.
2026-10-16 20:44:05 +03:00

14 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 любой свой профиль
!vpn help любой подсказку
!vpn 08 владелец указанный ключ (в том числе запасной)
!vpn 04 не владелец отказ

Ответ приходит личным сообщением, а не в комнату. Это не украшение, а условие безопасности: в комнате «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'

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

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 и как откатить