Commit Graph
12 Commits
Author SHA1 Message Date
root 3fac692f36 VPN Этап 2: три канала, автоматическое переключение, подписка
Цель этапа — чтобы доступ не зависел от того, не начал ли провайдер
мешать одному конкретному способу. Теперь каналов три, и клиент сам
держит живой:

    VLESS + TLS   TCP 10443  — основной
    Hysteria2     UDP 10443  — QUIC: другой путь, устойчивее на потерях
    VLESS + XHTTP TCP 8444   — выглядит как обычный сайт

ПЕРЕКЛЮЧЕНИЕ ДОКАЗАНО, А НЕ ТОЛЬКО НАСТРОЕНО. Тест: сломал основной
канал правилом в экране VPS (только для тестовой машины, чтобы не
задеть семью) — клиент переключился САМ через 60 секунд, домашний домен
продолжил открываться уже через новый канал, а после возврата основного
вернулся на него через 50 секунд.

ПОЧЕМУ ПЕРЕКЛЮЧАЕТ КЛИЕНТ, А НЕ СЕРВЕР. Проверял «единую точку входа на
сервере» — не годится: VLESS+TLS и XHTTP оба используют TLS с проверкой
сертификата, и посредник либо ломает проверку, либо должен
расшифровывать трафик. Второе уничтожает защиту. Поэтому переключает
клиент: у него есть все каналы.

ПОДПИСКА (задача 2.4): у каждого человека теперь есть ссылка, которую
он один раз вставляет в клиент — дальше профиль обновляется сам.
Добавлю новый канал, у всех появится без действий. Ссылки на прежней
странице, вход прежний.

ДВА ФОРМАТА, ОБА С АВТО-ПЕРЕКЛЮЧЕНИЕМ:
  yaml — mihomo: группа fallback, три канала;
  json — Xray: наблюдатель + leastPing по TLS и XHTTP.
В json НЕТ Hysteria2: Xray его не поддерживает, а если положить —
конфигурация не собирается и профиль не загружается. Проверено.

ПРОФИЛИ ПРОВЕРЯЮТСЯ ДО ВЫДАЧИ настоящими движками (mihomo и xray).
Не проходит проверку — не попадает на страницу. Лучше не выдать
ничего, чем выдать файл, который не откроется.

ГРАБЛИ ПО ХОДУ (все записаны в docs/VPN-STAGE2.md):
 1. репозиторий Hysteria переехал: apernet/hysteria -> HyNetworks/hysteria;
    со старого адреса версия читается как «location:...» и скачивание 404;
 2. в экране VPS правило было только для TCP, для UDP — нет: при политике
    DROP снаружи канал недоступен, хотя на сервере «слушает». Правило:
    проверять канал СНАРУЖИ;
 3. xray определяет формат по расширению: на «.json.tmp» отвечает
    «Failed to get format» — временный файл должен иметь верное расширение;
 4. папке нужен бит выполнения: я поставил 644 на папку sub/ и получил
    403 от nginx. Папкам 755, файлам 644. Проверять не «файл на месте»,
    а что он ОТКРЫВАЕТСЯ по адресу;
 5. у Hysteria нет отдельной проверки конфигурации — проверяю пробным
    запуском и тем, что порт слушает.

Проверка подписки: по её адресу отдаётся профиль с тремя каналами и
группой fallback — смотрю содержимое, а не только код ответа.

Осталось: Reality (2.3) — на портах есть, но рукопожатие не проходит.
2026-10-17 09:18:36 +03:00
root d4ba9e8fe4 VPN Этап 2, шаг 2: VLESS + XHTTP добавлен и проверен снаружи
Задача 2.2 из реестра. XHTTP передаёт VLESS поверх обычных HTTPS-запросов:
трафик выглядит как обращения к сайту, а не как непрерывный поток. Для
провайдера, который разбирает характер соединения, это поведение иное,
чем у обычного VLESS+TLS, — потому и полезен как запасной.

Решение по устройству: XHTTP идёт на отдельном TCP-порту 8444 со своим
TLS и нашим сертификатом git.buryans.ru. Вариант «спрятать за nginx»
рассматривал, но он добавляет лишний слой и точку отказа без выигрыша.

Сделано:
* в конфигурацию xray добавлен входящий (порт 8444, сеть xhttp, TLS);
* клиенты перенесены с основного входа — человеку работает тот же ключ;
* путь /buryan-xhttp, маскировка под git.buryans.ru;
* порт открыт в экране VPS, правила сохранены;
* скрипты в ops/vpn/xhttp/.

ПРОВЕРЕНО СНАРУЖИ, с домашнего канала:
    напрямую:        46.8.140.22
    через XHTTP:     193.233.210.184  <- наш VPS
    домашние службы и YouTube через него: 200, 200, 200
    в журнале клиента всё ушло с пометкой [proxy]

Урок с Hysteria2 применён сразу: порт открыл в экране ДО проверки.
В прошлый раз канал работал на сервере, но был недоступен снаружи
из-за политики DROP — на эти грабли второй раз не наступил.

Итого рабочих каналов теперь три:
    VLESS + TLS   TCP 10443  — основной
    Hysteria2     UDP 10443  — QUIC, для видео и на случай помех TCP
    VLESS + XHTTP TCP 8444   — ведёт себя как обычный сайт

Резервная копия обновлена: оба канала и все 40 ключей зашифрованы в
ops/secrets-enc/vpn-configs.json, восстановление проверено сверкой.

Дальше по плану: собрать единый профиль с автоматическим переключением
между тремя каналами и доказать переключение отключением основного.
2026-10-16 22:26:53 +03:00
root 3c9c7df5d9 VPN Этап 2, шаг 1: Hysteria2 поднят и проверен снаружи
Задача 2.1 из реестра. Запасной канал, отличающийся от основного по
самой природе: основной — VLESS+TLS по TCP, этот — QUIC по UDP. Если
провайдер станет мешать TCP, этот пойдёт другим путём; на потерях QUIC
обычно устойчивее, что важно для видео.

Сделано:
* Hysteria2 v2.13.0 установлен на VPS, служба systemd с автозапуском;
* слушает UDP 10443 — тот же номер, что у основного TCP-канала
  (UDP и TCP не мешают друг другу, людям один номер проще);
* TLS — тот же сертификат git.buryans.ru, маскировка на наш же сайт;
* пароль 22 знака в /root/.buryan-hy2-password (600);
* скрипты и обезличенная копия конфигурации — в ops/vpn/hysteria/.

ПРОВЕРЕНО СНАРУЖИ, с домашнего канала:
    напрямую:        46.8.140.22
    через Hysteria2: 193.233.210.184  <- наш VPS
    домашние службы через него: 200, 200
    YouTube и Telegram: 200, 200
    скорость 2 МБ: ~1,9 МБ/с

ТРИ НАХОДКИ ПО ХОДУ, записаны в реестр:

1. Репозиторий Hysteria переехал: был apernet/hysteria, стал
   HyNetworks/hysteria. Со старого адреса версия читается как
   «location:https://...» и скачивание даёт 404 — то есть установка
   по старым инструкциям ломается.

2. В ЭКРАНЕ VPS правило было только для TCP 10443, а для UDP — нет.
   При политике INPUT DROP снаружи канал был бы НЕДОСТУПЕН, хотя на
   сервере всё работало и порт «слушал». Отсюда правило: проверять
   канал СНАРУЖИ, а не по факту «слушает». Правило добавлено, правила
   сохранены (netfilter-persistent), копия до правки лежит рядом.

3. У Hysteria нет отдельной проверки конфигурации: проверяю пробным
   запуском и тем, что порт действительно слушает.

Резервное копирование расширено: теперь копируются оба канала
(xray и Hysteria2) в один зашифрованный файл
ops/secrets-enc/vpn-configs.json, и восстановление ПРОВЕРЯЕТСЯ —
расшифровка сверяется с исходным (30 ключей xray + конфиг Hysteria).
Иначе новый канал повторил бы недавнюю дыру, когда конфигурация
существовала в одном экземпляре.

Пароля Hysteria в репозитории нет — проверено сравнением с настоящим
паролем с сервера, а не только по виду.
2026-10-16 22:24:51 +03:00
root 633f580803 VPN: сохранность ключей — зашифрованная копия и восстановление
НАЙДЕНО И ЭТО БЫЛО ОПАСНО: боевая конфигурация xray с ключами жила
ТОЛЬКО на VPS.
  * в репозитории лежала копия от 23.09: 1 клиент вместо 10;
  * в резервное копирование (restic) VPS не входит вовсе.

Значит при гибели VPS все ключи пропали бы, и пришлось бы перевыпускать
доступ всей семье заново, обходя каждого. Это дороже, чем сделать копию.

Что теперь есть:
  * ops/secrets-enc/xray-config.json — копия для восстановления,
    зашифрована SOPS + age (правило уже было настроено на этот путь);
  * vps/xray/config.json — обезличенная копия: структура без ключей,
    её можно читать кому угодно;
  * /root/xray-config-encrypted.json на VPS — вторая копия, на другой
    машине.

Копия проверена, а не просто создана: скрипт расшифровывает её обратно и
сверяет СОДЕРЖИМОЕ (входящие, клиентов, ключи, настройки). Сверка
побайтовая не годится: SOPS при расшифровке пересобирает JSON, и порядок
ключей может отличаться. Результат: содержимое совпадает полностью,
30 ключей в 3 входящих.

Восстановление: ops/vpn/vpn-restore-config.sh. Без ключа --apply ничего
не пишет — только расшифровывает и показывает. С --apply делает копию
текущего файла, пишет на VPS и проверяет, что канал после этого работает.

Отдельно записано в документе: локально проверить конфигурацию НЕЛЬЗЯ,
потому что в ней пути к файлам сертификатов, а они только на VPS. Попытка
проверить на домашнем узле даёт ложную ошибку "failed to parse
certificate", и это не признак порчи копии. Скрипт об этом предупреждает
вместо того, чтобы пугать зря.

Восстановление невозможно без ключа шифрования age
(/root/.buryan-age-key, он же в Vaultwarden и на флешке). Это и есть
правило из аудита: ключ и зашифрованные данные — в разных местах.
2026-10-16 21:31:00 +03:00
root f411cc6fd4 VPN: убрана отладка журнала xray + сводка использования
НАЙДЕНО ПО ХОДУ: в конфигурации xray стоял loglevel "debug" — остался
с тех пор, когда искали причину непрохождения Reality, и так и не был
выключен. За месяц это дало 371 МБ журналов на VPS. Замер в процессе
работы: за пару часов проверок архив вырос с 371 до 387 МБ — примерно
17 МБ за два часа.

Чем это опасно: при таком темпе диск кончится за месяцы, и первым
упадёт сам VPN. Поломка пришла бы "на ровном месте", и искать её стали
бы не там.

Исправлено: loglevel debug -> warning. Файловые журналы (access, error)
намеренно НЕ включал: файл растёт без ротации, а для наблюдения
достаточно системного журнала, где ротация есть. Порядок обычный:
копия -> правка -> xray run -test -> перезапуск -> проверка. Проверено,
что служба работает, все три порта слушают и канал пропускает трафик.
Скрипт правки сохранён как образец: ops/vpn/vpn-fix-loglevel.sh.

Вывод на будущее, записан в отчёт: временные настройки для поиска
причины надо помечать и снимать. Отладка, забытая после расследования,
— это отложенная поломка.

ДОБАВЛЕНО: ops/vpn/vpn-usage.py — сводка, кто реально пользуется VPN.
Считает по журналу xray, чьим ключом пользовались: метка в
пользовательской записи у каждого ключа своя, поэтому видно персонально.
"Выдал" и "пользуется" — разные вещи, а по отчётам бота этого не видно.

Первый замер (окно 7 дней): Роман 410 подключений (почти всё — мои
проверки), Полина 30, Сергей 2, AlexTest / Елена / Никита — ни разу.

Ограничение замера записано прямо в документе: по журналу видно, что
человек подключался хотя бы раз, но НЕ видно, доволен ли он. Ноль
подключений не означает "не получилось" — возможно, просто не дошли
руки. Поэтому сводка идёт в дополнение к живой проверке, а не вместо.
2026-10-16 21:24:46 +03:00
root 21df3bf34d VPN: готовые профили доставлены, исправлена видимость комнат
Профили с раздельной маршрутизацией (.yaml для FlClash, .json для
Hiddify) и инструкция отправлены всем шестерым — и в личные комнаты
Matrix, и выложены на страницу раздачи. Адрес и пароль страницы
не менялись.

Проверено по факту, а не по отчёту бота: файл скачивался глазами
получателя и сверялся с исходным по SHA-256. Все 6 человек: по 2 файла,
оба целые, инструкция на месте. Плюс сквозная проверка, что после
добавления 204 правил домашний домен по-прежнему идёт в туннель
(git.buryans.ru -> [proxy]), а прочее напрямую.

НАЙДЕНА И ИСПРАВЛЕНА ТРЕТЬЯ ПОЛОМКА. Комнаты выдачи создавались
с видимостью истории "joined": человек видит только то, что отправлено
ПОСЛЕ его вступления. Пока он только приглашён, отправленные ему
профили ему НЕ видны — со стороны это выглядит как "мне ничего не
пришло", хотя на сервере всё лежит.

То есть Сергей, Елена и Полина физически не могли увидеть ни ключ,
ни профиль, пока не приняли бы приглашение. А приняли бы они его,
скорее всего, именно увидев сообщение — которого не видели. Замкнутый
круг, из-за которого раздача могла молча не дойти до трёх человек
из шести.

Исправлено: все шесть комнат переведены на "shared", приглашённые видят
присланное сразу. Проверено. Скрипт создания комнат тоже исправлен,
чтобы это не вернулось; отдельный скрипт fix-room-visibility.py
приводит уже созданные комнаты в порядок.

Урок общий и повторяющийся: проверять надо ГЛАЗАМИ ПОЛУЧАТЕЛЯ, а не
состоянием на сервере. Оба раза проблему нашла именно такая проверка —
сначала в личных комнатах бота, теперь в комнатах выдачи.
2026-10-16 21:20:31 +03:00
root a97b00c1eb VPN: раздельная маршрутизация — туннель несёт только домашнее
Задача: часть приложений (банки, госуслуги, маркетплейсы) не работает,
когда весь трафик идёт через VPN. С апреля 2026 крупные российские
сервисы закрывают доступ тем, кто приходит с зарубежного адреса;
рекомендацию дало Минцифры на совещании с 20+ компаниями, срок
назывался до 15 апреля. Приложение Сбербанка, по сообщениям, вообще
не запускается при включённом VPN.

Причина не в туннеле, а в том, ЧТО через него идёт. Значит решение —
маршрутизация, а не ручные переключения.

Что сделано:

* ops/vpn/gen-split-routing.py — собирает файлы маршрутизации из ОДНОГО
  списка домашних доменов (27 адресов). Если вести списки порознь,
  они разойдутся, и придётся искать, почему одна служба не открывается;
* ops/vpn/split/ — собранное: home-domains.txt, rules-clash.yaml,
  client-routing.json (для Xray-клиентов);
* ops/vpn/split-profile-android.yaml — готовый профиль для Android:
  список приложений через туннель, домашние домены в туннель,
  всё остальное напрямую;
* docs/VPN-SPLIT-ROUTING.md — как настроить обоими способами;
* docs/VPN-APP-CONFLICTS.md — понятным языком, почему ломается и что
  именно перестало работать, со ссылками на открытые источники.

Проверено на живом клиенте (xray 25.3.6, тот же клиент, что в телефоне),
результат виден в журнале:

  accepted tcp:git.buryans.ru:443   [proxy]   <- домашнее, в туннель
  accepted tcp:ip-api.com:80        [direct]  <- прочее, напрямую
  accepted tcp:www.sberbank.ru:443  [direct]  <- российское, напрямую

Конфиг проходит xray run -test (Configuration OK), профиль YAML
разбирается, порядок правил проверен скриптом.

Две грабли, найденные по ходу и записанные в документ:

1. Порядок правил решает. Первая версия начиналась с правила «всё
   российское и весь buryans.ru — напрямую», а buryans.ru это и есть
   наши домашние службы: широкое правило перехватило бы их раньше
   узкого, и домашние домены ушли бы мимо туннеля. Домашнее правило
   обязано стоять выше.
2. Без sniffing правила по домену не работают: клиент видит только
   IP, имя уже разрешено. Поэтому включены sniffing с destOverride
   и domainStrategy IPIfNonMatch.

Граница, которую обозначил владельцу прямо: вывод приложения из туннеля
— это штатная настройка Android, её я делаю. Подмену проверки «есть ли
на телефоне VPN» я не делаю: это уже не маршрутизация, а обман
проверки, и такое приложение честнее вынести из туннеля или настроить
ему прокси в самом приложении.

Ключей в коммите нет: в профиле стоит подстановка <ВАШ-UUID>,
свой ключ человек берёт из своей комнаты в Matrix.
2026-10-16 21:09:00 +03:00
root de65cc088a VPN: выдача доступа новому человеку одной командой админа
Владельцу нужна была одна команда, чтобы выдать профиль новому
участнику без ручной сборки QR и без пересылки ключей в мессенджерах.

Добавлено:
  !vpn give @логин      — выдать свободный ключ
  !vpn give @логин 08   — выдать конкретный ключ
  !vpn list             — что выдано, что свободно

Доступно только владельцу (@akadmin, @comms_agent); обычному человеку
бот отвечает отказом и пишет попытку в журнал.

Профиль уходит ЛИЧНО получателю: бот заводит с ним личную комнату,
приглашает и отправляет QR и ссылку. Владельцу приходит подтверждение,
что и кому выдано, и это же пишется в состояние (given_by, key).

Два вывода, которые дала проверка на живом получателе:

1. Видимость истории. Первый прогон создал комнату с history_visibility
   "joined". Бот отчитался "отправлено", но получатель — а он в тот
   момент ещё только приглашён — не увидел НИЧЕГО: с этой видимостью
   видны только сообщения после вступления. Исправлено на "shared",
   проверено на новой комнате: приглашённый видит профиль сразу.
   Это выяснилось проверкой, а не из документации.

2. Права бота. Бот не серверный админ: заводить и деактивировать
   учётные записи в Matrix он не может (403). Поэтому !vpn give создаёт
   только комнату, а учётную запись человеку заводит владелец. Записано
   в документации, чтобы это не выглядело недоделкой.

Проверено по-настоящему: временный человек заводился в Matrix, получал
ключ Buryan-10, принимал приглашение и видел у себя картинку QR и
ссылку. Обычному человеку на "!vpn 04" приходит отказ.

Уборка после проверки: временные люди и их комнаты удалены из базы
(пользователей снова 21, событий временных комнат 0). Комнаты чистились
с обнулением зависимостей — event_edges держал события круговой ссылкой.
2026-10-16 20:59:11 +03:00
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
root 60ff4ac324 VPN: раздача профилей через Matrix — комната на каждого человека
По решению владельца профили выдаются не только страницей, но и в Matrix:
Matrix свой, ключи не уходят на чужие серверы, и человек получает профиль
там, где он и так общается с семьёй.

Добавлено:
* ops/vpn/matrix-distribute.py — заводит приватную комнату НА КАЖДОГО
  человека, приглашает его, отправляет картинку QR, ссылку текстом на
  случай несчитанного кода и инструкцию;
* режимы: план (по умолчанию), --send, --send --only <логин>, --verify.

Почему комната на каждого, а не общая "Семья": в общей комнате ключи
видны всем сразу, и тогда нельзя отозвать доступ одному, не задев
остальных. Ради отзыва по одному мы и заводили отдельные ключи.

Проверено на akadmin: комната "VPN - Роман" создана, получатель вошёл,
вход только по приглашению, картинка скачивается целой (1759 байт,
сигнатура PNG верна), текстов два. Режим --verify делает эту проверку
повторяемой.

Попутно выяснено и записано в документы:
* комната "Семья" содержит участников @telegram_<id> — там люди из
  Telegram-моста, поэтому профили туда не кладём;
* portal в базе моста пуст — комната, похоже, в Telegram не зеркалится;
* этот Synapse отдаёт медиа только по /_matrix/client/v1/media/download,
  старые media/v3 и media/r0 дают 404 (ложный признак потери файла);
* @akadmin — админ, но устройств не зарегистрировано;
* E2EE в этих комнатах не включён.

Ждёт решения владельца: класть ли профили в комнату, зеркалящуюся
в Telegram (тогда ключи попадут на серверы Telegram). До решения
раздача семье не запускается — её будет не откатить без смены ключей.
2026-10-16 20:36:40 +03:00
root 1eb6494f5d VPN этап 1: мобильный доступ — ключи, профили, инструкция для семьи
Задача: docs/TASKS.md -> раздел VPN, Этап 1 (приоритет 3 из
docs/AUDIT-2026-10-17.md, часть 6).

Сделано:
* ключей 5 -> 10 (buryan-06..10 во все три входящих: 10443, 2087, 2053);
  существующие user1..user5 не тронуты — их могли уже использовать;
* у каждого ключа своё имя: раздаём и отзываем доступ по одному,
  не ломая остальных;
* приватная страница с QR-кодами и инструкцией (скрытый путь + пароль,
  на существующем домене — новых записей в DNS не потребовалось);
* инструкция для семьи простым языком: приложение, импорт, проверка,
  раздел "если не подключается";
* отдельно вынесено предупреждение про встроенный браузер MIUI —
  это и была причина, по которой Сергей не мог войти.

Проверено (не на словах):
* xray run -test -> Configuration OK
* новый ключ реально выходит через VPS — и с самого сервера, и снаружи
* устойчивость: 10 подключений из 10
* QR-коды прочитаны независимым декодером (zxing), ссылки совпадают
* страница: 200 с паролем, 401 без пароля; Gitea не затронута (200)

Разбор ложной тревоги: записи "invalid request version" в журнале
оказались чужими проверками порта, а не нашей поломкой. Вывод в отчёт:
не считать канал сломанным по одной неудаче.

Осталось: VPN-1.3 — проверка на телефонах Сергея и AlexTest (нужны
устройства), затем VPN-1.4 — раздача остальным.

Отчёт: ops/vpn/VPN-STAGE1-IMPLEMENTATION.md
2026-10-16 20:30:42 +03:00
root 12d1cbde91 план развития и реестр задач: 44 домена, сеть, звонки, сквозная связность 2026-10-15 20:46:03 +03:00