Владелец прислал таблицу остальных разделов — с цифрами, которые уже
были неверны (часть задач закрыта сегодня). Сделал так, чтобы это не
повторялось.
1. ПРОВЕРЕНО ПРОГРАММНО: все темы из списка владельца в реестре есть —
ни одна не потеряна. Пункты «профиль безопасности, paperless, gitea,
authentik, postgres-rbac, уборка остатков, кэш на VPS, локальный
NGINX, AdGuard, 44 домена, сертификат, Element Call, единый вход,
права, 28 служб в наблюдение, копии наружу, карта хозяйства,
headscale, immich, uptime-kuma, dashy, grafana, две paperless» —
все на месте.
2. ДОБАВЛЕНА СВОДКА ПО РАЗДЕЛАМ в начале реестра — с фактическими
цифрами. И главное: её считает скрипт ops/registry/summary.py из
самого файла, а не человек руками. Поэтому она не может отстать:
запустил скрипт — цифры верные.
ФАКТИЧЕСКОЕ СОСТОЯНИЕ (было в таблице владельца -> стало):
Обновления: не начато 6 -> 6 (2 сделано, 8 всего)
Сеть и доступ: не начато 6 -> 5 (2 сделано: AdGuard и причина
медленного входа)
Звонки и медиа: не начато 5 -> 5
Сквозная связность: 11 -> 8 (3 частично: уведомления,
проверка «работает», копии)
Улучшение служб: не начато 10 -> 10
VPN: -> 6 (19 сделано, 4 частично)
Найденные проблемы: -> 6 (8 сделано, 3 частично)
ИТОГО по хозяйству: 88 задач, сделано 32, частично 10, осталось 46.
Цифры «уборка остатков» и «AdGuard» в присланной таблице устарели: обе
задачи закрыты сегодня.
ВЛАДЕЛЕЦ ВЫБРАЛ ПЯТЬ ЗАДАЧ и попросил завести их в список. Все пять уже
были в реестре, но я нашёл две проблемы, которые мешали им пользоваться.
1. ДВОЙНАЯ НУМЕРАЦИЯ. Разделы 1-5 и VPN оба использовали номера вида
«1.1», «2.1», «3.1», «4.1». Из-за этого «1.1» означало одновременно
«профиль безопасности» и «VPN-профиль для телефонов». Владелец уже
путался на этом. Все задачи VPN-раздела получили префикс VPN-, как в
аудите. Проверено: номеров без префикса в разделе не осталось (0).
2. ВТОРОЙ ШЛЮЗ — ЭТО НЕ ВТОРОЙ VPS. В реестре была только задача
VPN-4.1 «Второй шлюз» — резервный шлюз В ДОМЕ. Она не решает довод
владельца «вся семья висит на одной машине»: все четыре канала
(TLS, Hysteria2, XHTTP, Reality) живут на ОДНОМ VPS, и если он
недоступен, переключаться некуда. Добавлена отдельная задача:
VPN-4.6 — второй VPS у другого провайдера.
Заодно добавлена VPN-4.7: проверить автопереключение каналов НА ШЛЮЗЕ
отказом канала. На телефоне это проверено, на шлюзе — нет.
В начало реестра добавлен блок «БЛИЖАЙШИЕ ЗАДАЧИ» с этими пятью
пунктами, их номерами в реестре и текущим состоянием, чтобы не искать
по разделам.
Задачи 1.10, 1.11, 1.12.
1.10 ДВОЙНИК COMPOSE У n8n. Рядом с настоящим compose лежал файл
/opt/n8n/docker-compose.yml, которым никто не пользуется: у него ДРУГОЙ
путь данных (/opt/n8n/data — пустая папка) и другая сеть. Запусти его —
получился бы второй n8n с пустыми данными и без ключа шифрования:
внешне работает, а учётные данные «чужие». Файл переименован в
.orphan-20261017. Настоящий compose (/opt/automation-lxc) в порядке.
МОЯ ОШИБКА, которую это вскрыло: я сначала решил, что «compose не
описывает монтирование», и правил не тот файл. Надо было сразу спросить
контейнер, какой файл используется:
docker inspect <контейнер> --format '{{index .Config.Labels "com.docker.compose.project.config_files"}}'
1.11 OPENCLAW. Падал в петле: база состояния нечитаема, ENOSPC. Причина —
диск в CT 115 был заполнен на 100%. Мусор был НЕ там, где показывал
Docker: /var/lib/docker занимал 1.5 ГБ, а /var/lib/containerd — 21 ГБ,
из которых 12 ГБ — записанный слой самого падающего контейнера. Docker
при этом показывал «возвратно 21.7 ГБ», что вводит в заблуждение: это
его собственный нужный образ.
Сделано: состояние больного контейнера СОХРАНЕНО на хост
(/root/openclaw-broken-state-20261017_122412.tar, 1.67 МБ, база внутри —
проверено), петля остановлена, контейнер удалён. МЕСТО: было 100%, стало
55%, освободилось 11 ГБ. Живой экземпляр openclaw-old не тронут.
Осталось решить (нужно слово владельца): какой экземпляр считать рабочим
— работающий openclaw-old (переименовать) или новый из копии.
1.12 ОСТАТКИ ОТ ОБНОВЛЕНИЙ. Убрано 11 контейнеров: plex, sonarr, radarr,
prowlarr, bazarr, overseerr, tautulli, linkding, prometheus, syncthing
(Exited) и navidrome-old, который КРУТИЛСЯ В ПЕТЛЕ вхолостую.
Оставлено 3 работающих: calibre-web-old, freshrss-old, openclaw-old.
Признак «old» в имени не значит «мусор» — это действующие экземпляры.
Правило записано: удалять только Exited/Created/Restarting.
ПРОВЕРЕНО ПОСЛЕ УБОРКИ: Plex, Sonarr, Radarr, Prowlarr, Overseerr,
Navidrome, Linkding, Prometheus, Syncthing отвечают 200 (Bazarr и
Tautulli — 401, их норма без токена). Наблюдение: 34 проверки, провалов
нет.
ЗАДАЧА 1.1. Она стояла как «применить профиль безопасности в остальных
контейнерах». Вместо «на всякий случай везде» я измерил.
Проверил 23 контейнера с Docker запуском docker run --rm hello-world:
работают без правки: 21
требуют внимания: 2 (CT 115 OpenClaw, CT 140 gitea)
И в этих двух обход уже есть: в их docker-compose.yml прописано
apparmor:unconfined. То есть задача 1.1 по существу ВЫПОЛНЕНА.
ПОЧЕМУ ЭТО ВАЖНО: настройка lxc.apparmor.profile=unconfined ОТКЛЮЧАЕТ
защиту AppArmor у контейнера — это ослабление изоляции, а не усиление.
Применить её всем значило бы ослабить 21 контейнер, который отлично
работает без этого. Правило: ослаблять защиту только там, где
измерением доказано, что без этого не работает.
НАЙДЕНО ПО ХОДУ (три проблемы, которых в списке не было):
1. В CT 108 БЫЛ СЛОМАН DNS. Из контейнера не резолвились внешние имена
(1.1.1.1 и 8.8.8.8 — таймаут), а к AdGuard работало. Следствие: n8n не
мог резолвить имена и выходил наружу только через прокси; всё, что шло
мимо прокси, падало. Причина: в compose у n8n жёстко прописан
dns: [8.8.8.8, 1.1.1.1], недоступный из этого контейнера.
Исправлено: DNS контейнера переведён на AdGuard; DNS задан на уровне
Docker для новых контейнеров. Контейнеры не пересоздавались, службы
целы. Проверено: api.telegram.org резолвится, example.com — HTTP 200.
2. COMPOSE У n8n НЕ ОПИСЫВАЕТ МОНТИРОВАНИЕ ДАННЫХ — это риск. Работающий
контейнер использует папку /opt/automation-lxc/n8n/data, где лежит
файл config — КЛЮЧ ШИФРОВАНИЯ n8n. В compose этого монтирования нет.
Значит пересоздание через compose даст контейнер без ключа: он
запустится, а учётные данные перестанут расшифровываться.
Поэтому compose я вернул как был, а правку сделал безопасно — на
уровне Docker. Обновлять n8n через compose сейчас НЕЛЬЗЯ, пока
compose не приведён в соответствие. Заведено задачей 1.10.
3. КОНТЕЙНЕРЫ В ПЕТЛЕ ПЕРЕЗАПУСКА: openclaw (CT 115, падает), и
navidrome-old-20261014-* (CT 125, остаток от обновления). Плюс 10
контейнеров *-old-* в состоянии Exited. Заведено задачами 1.11 и 1.12.
ЧЕСТНО О МОЕЙ ОШИБКЕ: при правке n8n я сначала добавил ВТОРОЙ ключ dns в
compose и сломал YAML («mapping key dns already defined»). Проверка
конфигурации это поймала до применения — службы не пострадали, файл
восстановлен из копии. Урок: перед добавлением строки в чужой файл
проверить, нет ли её уже.
Владелец спросил, про что задача 22, и это вскрыло мою неточность.
ЧТО ПРОВЕРЕНО ПО ДОКУМЕНТУ. Задача 22 в аудите — именно ключ age:
«| 22 | Поручение: ключ age в Vaultwarden | ВАШЕ |»
«| 22 | Ключ age → в Vaultwarden и на флешку | Без него секреты не восстановить |»
Отдельной задачи про пароль PVE в аудите НЕТ.
ГДЕ Я БЫЛ НЕТОЧЕН. Я описал ключ как «ключ к копиям VPN». На самом деле
он открывает secrets.yaml, где 8 секретов:
database.password, backup.restic_password, authentik.api_token,
vpn.mtg_secret, notify.matrix_token + адрес, порт, пользователь базы.
Разница принципиальная: потеря ключа означает потерю не только VPN, но и
пароля базы и ключа резервных копий. То есть без него не восстановить
почти ничего.
ИСПРАВЛЕНО:
* verify-age-key.sh теперь проверяет и secrets.yaml (расшифровывается,
внутри 8 секретов), а не только .json-копии;
* docs/AGE-KEY-AND-RESTORE.md — охват описан верно, добавлен раздел про
то, что ключ НЕ имеет отношения к паролю root на PVE;
* файл для владельца переименован в AGE-КЛЮЧ-все-секреты.txt и
переписан: перечислено всё, что ключ открывает, включая пароль базы и
ключ копий.
Результат проверки после правки: secrets.yaml расшифровывается (8
секретов), копии VPN расшифровываются (40 и 30 ключей), права 600, в Git
ключа нет.
Если владелец захочет вести пароль PVE наравне с остальными — это
отдельный пункт реестра, добавлю по его слову.
Задача №22 аудита. Суть не в «положить в Vaultwarden», а в том, что без
ключа зашифрованные копии бесполезны: файл есть, прочитать нечем.
ЧТО СДЕЛАНО:
* добавлен ops/vpn/verify-age-key.sh — проверка «ключ ГОДЕН», а не
«ключ есть». Ошибка в одном символе иначе обнаружится только в момент
восстановления, когда уже поздно. Скрипт проверяет: ключ на месте и с
правами 600; секретный ключ ровно один; публичный совпадает с тем, на
который шифровали; копии ДЕЙСТВИТЕЛЬНО расшифровываются; ключа нет в
файлах и в истории Git; копии есть на другом хосте;
* docs/AGE-KEY-AND-RESTORE.md — что ключ открывает, где должен жить
(сервер + Vaultwarden + флешка, ключ отдельно от данных), как
восстановить;
* файл с ключом и пошаговой инструкцией подготовлен и передан владельцу
для скачивания.
РЕЗУЛЬТАТ ПРОВЕРКИ: ключ годен. Расшифровываются обе копии —
vpn-configs.json (40 ключей клиентов) и xray-config.json (30). Права 600.
Публичный ключ совпадает с .sops.yaml. В Git ключа нет: ни в файлах, ни
в истории коммитов. На VPS лежат 2 зашифрованные копии.
ПОЧЕМУ КЛЮЧ НЕ ДОБАВЛЕН В VAULTWARDEN МНОЮ: Vaultwarden шифрует записи
клиентским мастер-паролем. Мастер-пароля у меня нет — и это правильно.
Добавить запись программно можно только с ним или с личным ключом API;
просить их я не буду. Записать в Vaultwarden и на флешку — действие
владельца.
ГРАБЛИ (мои): проверка нашла саму себя. Скрипт искал строку
AGE-SECRET-KEY-1, а она есть в нём же как образец для поиска — вышло
ложное «ключ попал в репозиторий». Искать надо КОНКРЕТНОЕ значение
ключа, а не его начало. Исправлено. Тот же класс ошибки уже был с URL
приватной комнаты: проверка совпадала сама с собой.
ВЛАДЕЛЕЦ СПРОСИЛ: зачем прокси, не проще ли завести домашнюю сеть в
AdGuard? Проверил — он прав.
AdGuard (192.168.1.107) уже работает как DNS и уже содержит
переписывания для ВСЕХ 43 домашних доменов: проверено по списку
ops/network/domains.yaml — правильно отвечает 43 из 43.
Значит отдельный DNS на шлюзе (CT 161) был ДУБЛЕМ, причём вредным:
* два источника правды: поправил в одном — на другом старое;
* устройство, настроенное на шлюз, ОБХОДИЛО фильтрацию AdGuard,
то есть реклама и трекеры проходили.
DNS на шлюзе выключен. Настраивать на устройствах: DNS 192.168.1.107.
Адрес 192.168.1.161 для DNS больше не использовать.
ПРО ПРОКСИ. Для телевизоров он не нужен: владелец выяснил, что там есть
только «HTTP-прокси для браузера» и поля DNS нет вовсе. Прокси на шлюзе
оставлен как необязательный инструмент для устройств, которые умеют
полноценный прокси (компьютер). Телефонам он не нужен — у них профили VPN.
НАБЛЮДЕНИЕ ПОПРАВЛЕНО: проверка «Шлюз DNS» смотрела на 192.168.1.161,
где DNS больше нет — она начала бы падать с ложной тревогой. Теперь это
«DNS дома (AdGuard)» и смотрит на 192.168.1.107.
ТУННЕЛЬ НА ШЛЮЗЕ ПОЧИНЕН. Он «висел по таймауту»: проверка канала
спрашивала www.gstatic.com, DNS отдавал адрес IPv6, а IPv6 у контейнера
нет — соединение висело до таймаута, проверка считала канал мёртвым, и
ложился весь трафик. В журнале было прямо: «outbound/urltest[auto]:
context deadline exceeded». Лечение: IPv6 в контейнере отключён, в
sing-box задано ipv4_only. Сейчас 3 из 3 попыток успешны.
Ещё две миграции sing-box 1.14 поймала встроенная проверка конфигурации:
поля sniff переехали в правила; DNS-сервер теперь
{"type": "udp", "server": "..."}, старый {"address": ...} отвергается.
УРОК: прежде чем строить новое, проверить, что уже есть. AdGuard работал
годами, а я построил рядом второй DNS.
Роутер по-прежнему НЕ тронут, как решено.
Прежний шлюз умел только DNS. Этого мало: телевизор не ставит
VPN-приложение, и быстрый DNS ему не помогает, если нужные сайты
недоступны. Теперь на шлюзе есть свой туннель до VPS и прокси для
устройств, которые умеют указать адрес прокси в настройках сети —
это почти все телевизоры и приставки на Android TV.
ПРОВЕРЕНО СНАРУЖИ, как это сделает телевизор:
иностранный сайт через прокси -> выход 193.233.210.184 (наш VPS)
git.buryans.ru -> HTTP 200 напрямую (домашнее идёт мимо туннеля)
ya.ru -> HTTP 302 за 0,1 с напрямую (российское тоже мимо)
youtube.com -> HTTP 200 через туннель
ОТДЕЛЬНЫЙ КЛЮЧ ДЛЯ ШЛЮЗА (gateway-home@buryans.local), а не чей-то
личный: видно в статистике, можно отозвать шлюзу отдельно, при замене
шлюза меняется только его ключ. Добавлен во все входы VLESS, поэтому
шлюз может пользоваться любым каналом и переключаться сам (три канала
с автопереключением внутри шлюза).
НАБЛЮДЕНИЕ: шлюз добавлен двумя отдельными проверками —
* «Шлюз DNS» — домашний домен обязан вести на 192.168.1.10;
* «Шлюз туннель» — иностранный адрес обязан выходить через VPS.
Проверяется ВЫХОД, а не «порт открыт»: порт может слушать, а трафик не
идти. Всего проверок стало 34 (было 32). Это прямо про недавний случай:
владелец узнал об обрыве от семьи, а не от системы.
ГРАБЛИ:
1. sing-box 1.14 убрал старые поля входящего: sniff внутри входящего
больше не принимается, переехал в правила. Проверка конфигурации
поймала это ДО запуска.
2. Служба не создалась, потому что предыдущий запуск прервался на
проверке конфигурации. Урок: проверять надо не «конфигурация
верна», а «служба работает и трафик идёт».
Для Samsung и LG прокси в настройках сети нет — им доступен только
быстрый DNS, обход блокировок потребует правила на роутере (3.3).
Убраны устаревшие записи, которые вводили в заблуждение:
* «итого рабочих каналов: три» -> четыре (Reality доведён);
* «Reality не проходит рукопожатие, причина не найдена» -> причина
найдена: сайт-прикрытие www.microsoft.com недоступен с VPS,
заменён на наш собственный;
* «доступ снаружи непредсказуем» -> четыре канала с автопереключением;
* «проверка восстановления из копий» -> проверено для конфигураций VPN.
Дописаны разделы: что сделано по Этапу 3 (шлюз в доме) и запасной
простой профиль.
Итог по реестру: сделано 28, частично 7, не начато 46.
НАЙДЕНА ПРИЧИНА «дома всё тормозит»: домашние домены резолвились в адрес
VPS даже из дома — запрос уходил в интернет, на VPS, и возвращался
обратно. Замерено:
напрямую с домашнего nginx (192.168.1.10): 10 мс
как было, через VPS: 485 мс (в 50 раз!)
СДЕЛАНО: отдельный контейнер CT 161 (192.168.1.161) со своим DNS.
Для 43 домашних доменов из ops/network/domains.yaml отдаёт домашний
адрес 192.168.1.10 — трафик идёт по домашней сети. Для всех остальных —
обычный ответ через 1.1.1.1 и 8.8.8.8, с кэшем.
РОУТЕР НЕ ТРОНУТ, как вы и просили. Правило на Keenetic (3.3) остаётся
на потом, вместе с вами.
ПРОВЕРЕНО НА РЕАЛЬНОМ УСТРОЙСТВЕ (3.2): взял домашний CT 107, перевёл
его DNS на шлюз. Домашние службы открываются (200/302), обычный
интернет не сломался (yandex 302, github 200), стало в 50 раз быстрее.
После проверки DNS устройства возвращён как был — чужие настройки без
согласия не оставляю.
КАК ПОДКЛЮЧИТЬ УСТРОЙСТВО: указать в его настройках сети DNS
192.168.1.161. Для Android TV: настройки сети -> своя сеть ->
дополнительно -> DNS вручную.
ЧЕГО ЭТО НЕ РЕШАЕТ: доступ снаружи (там нужен VPN, этапы 1-2) и обход
блокировок (это туннель, он в профилях для телефонов).
ГРАБЛИ:
1. local-lvm заполнен на 80%, контейнер там не создаётся. Разрешил
хранилищу local держать диски контейнеров (копия storage.cfg снята).
Диск шлюза 2 ГБ, на local свободно 91 ГБ.
2. Первый замер показал 486 мс вместо 10 — это была холодная попытка
(пустой DNS-кэш, новое TLS-соединение). Мерить надо несколько раз
подряд и брать установившееся значение, иначе получается «быстрее
в 1 раз», то есть никакая экономия.
Задача 2.3 закрыта. Reality работает и проверен снаружи ключом живого
человека: у всех шести человек, домашние службы через него отвечают 200.
VLESS + TLS TCP 10443 ~476 мс
Hysteria2 UDP 10443 ~142 мс
VLESS + XHTTP TCP 8444 ~576 мс
VLESS + Reality TCP 2087 ~309 мс
ПРИЧИНА, по которой не работал: Reality был настроен на прикрытие
www.microsoft.com, а этот сайт с VPS НЕДОСТУПЕН (HTTP 000), хотя с
домашнего канала отвечает. Reality пересылает рукопожатие клиента на
сайт-прикрытие; сайт недоступен — рукопожатие не проходит.
Рабочее решение: прикрытием сделан НАШ ЖЕ сайт (dest 127.0.0.1:10443,
имя git.buryans.ru). Путь до прикрытия локальный и не рвётся, а для
наблюдателя соединение выглядит как обычный TLS к нашему домену, то есть
сливается с уже существующим рабочим каналом.
ПОПУТНО ИСПРАВЛЕНО: ключи на всех входах приведены к одному набору.
Раньше для части людей на Reality лежали ДРУГИЕ ключи, и ключ человека
работал на одном канале и не работал на другом. Теперь ключ один на все
каналы — это и позволило добавить Reality в общий профиль.
ОТДЕЛЬНО ЗАПИСАНО В ДОКУМЕНТЕ, честно: в этом разборе я ошибся в
проверке ШЕСТЬ раз, и каждая ошибка выглядела как «канал не работает»:
заглушка вместо публичного ключа; ключ, которого нет на этом входе;
недоступный с сервера сайт; порт, не открытый в экране; проба, которая
не запускалась; имя UID, зарезервированное в bash (сервер прямо сказал
«invalid request user id»).
Правило: если канал «не работает» — сначала проверь саму проверку.
Сервер в журнале обычно говорит причину прямо, надо только прочитать.
Тестовый порт закрыт, пробные процессы убраны, конфигурация сохранена
в зашифрованную копию.
Цель этапа — чтобы доступ не зависел от того, не начал ли провайдер
мешать одному конкретному способу. Теперь каналов три, и клиент сам
держит живой:
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) — на портах есть, но рукопожатие не проходит.
Задача 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, восстановление проверено сверкой.
Дальше по плану: собрать единый профиль с автоматическим переключением
между тремя каналами и доказать переключение отключением основного.
Задача 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 в репозитории нет — проверено сравнением с настоящим
паролем с сервера, а не только по виду.
Разобрано по жалобе владельца: в комнате на каждое сообщение из Matrix
появлялась заметка «Your message was not bridged: You're not logged in
(no usable logins found)», плюс сообщения дублировались.
Причина. Комната «Семья» — это канал Telegram (channel:3999041689,
is_supergroup: true), отражённый в Matrix. Мост не мог отправить
сообщение из Matrix в Telegram: у отправителя нет входа в Telegram
через мост. Вместо сообщения он клал заметку об ошибке — отсюда и
ошибки, и дубли.
Про 11 участников: это 4 настоящих человека и 7 теней Telegram
(@telegram_*). Тени — отражения участников Telegram-группы, их создаёт
сам мост. Это не мусор, а лица людей со стороны Telegram.
Сделано: включён режим передачи (bridge.relay.enabled: true), мост
перезапущен. Отдельно разобрано, чего делать НЕ надо: прописывать
bot_token в разделе network не требуется — мост версии v0.31.0
использует современный режим передачи, где роль передатчика выполняет
обычный вход в Telegram (у нас это Matrix_buryans_bot).
Осталось владельцу: отправить «!tg set-relay» в комнате «Семья».
После этого сообщения тех, у кого своего входа нет, будут уходить в
Telegram одной строкой с подписью отправителя. Права проверены: у
владельца admin, у остальных user — команда доступна только ему.
Честно отмечено ограничение: отправить проверочное сообщение от имени
владельца я не могу — в базе Synapse только хеши токенов, пароль мне
не передавали. Поэтому фактическую проверку делает владелец, и это
записано в документе, а не умолчано.
Заодно в документе: где лежит конфиг моста (внутри CT 155, в контейнер
смонтирован как /data), где задаются права, и правило на будущее —
сообщения уходят в Telegram только если у отправителя есть вход ЛИБО
в комнате назначен передатчик.
НАЙДЕНО И ЭТО БЫЛО ОПАСНО: боевая конфигурация 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 и на флешке). Это и есть
правило из аудита: ключ и зашифрованные данные — в разных местах.
Я ошибся и записываю это честно, потому что ошибка поучительная.
Проверял доступность банков обычным curl и получал 000 — «соединения
нет». В журнале было "SSL certificate problem: self-signed certificate
in certificate chain" и отказ за 0,015 с. Я решил, что это вмешательство
провайдера: сертификат подменяют по пути. Вывод был громкий и неверный.
На самом деле Сбербанк и Т-Банк САМИ используют сертификаты российского
доверенного УЦ Минцифры ("Russian Trusted Sub CA"). Он встроен в
телефоны, но его нет в хранилище доверия моих инструментов. Поэтому
curl и отказывался — дело было в моей стороне, а не в сети. С VPS
сертификат точно такой же: подмены нет ни там, ни там.
Проверил так, как это работает на телефоне (с отключённой проверкой
сертификата): sberbank.ru 200, online.sberbank.ru 302, tbank.ru 200,
vtb.ru 200, alfabank.ru 200. Сбербанк отдаёт обычное перенаправление
на /ru/person со своей сессионной кукой. Всё работает.
Правильный вывод: банки в этом хозяйстве и так доступны напрямую с
домашнего канала. Раздельная маршрутизация для них — не лечение, а
страховка: если канал до банка когда-нибудь начнёт мешать, трафик
всё равно пойдёт мимо туннеля, и поведение не изменится.
В документ для семьи добавил предупреждение: банки используют
российский УЦ, поэтому некоторые программы и скрипты на компьютере
будут ругаться на сертификат, хотя с телефона всё открывается. Правило
простое: если браузер на телефоне открывает банк — всё в порядке.
Общий урок, записанный в отчёт: это ВТОРОЙ раз, когда меня подвёл
инструмент проверки, а не работа. Сначала opencv не смог прочитать
исправный QR-код, теперь curl отверг исправный сайт. Оба раза спасало
одно правило — при странном результате проверять саму проверку, а не
сразу чинить то, что она показывает.
НАЙДЕНО ПО ХОДУ: в конфигурации 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 / Елена / Никита — ни разу.
Ограничение замера записано прямо в документе: по журналу видно, что
человек подключался хотя бы раз, но НЕ видно, доволен ли он. Ноль
подключений не означает "не получилось" — возможно, просто не дошли
руки. Поэтому сводка идёт в дополнение к живой проверке, а не вместо.
Человек не должен угадывать, на каком шаге он застрял. Команда смотрит
со стороны сервера и отвечает коротко: что получилось, что нет и что
делать. Проверил содержимое глазами получателя:
[да] Доступ выдан, ваш ключ: Buryan-01
[да] Готовые профили пришли: vpn-akadmin.json, vpn-akadmin.yaml
[да] Сервер отвечает, связь с ним есть
Со стороны сервера всё готово. Осталось проверить на телефоне:
1. Приложение: FlClash (.yaml) либо Hiddify (.json).
...
5. Откройте 2ip.ru — должен показаться 193.233.210.184.
Если чего-то не хватает, называет причину и следующий шаг: нет ключа —
«напишите владельцу»; профилей не видно — «примите приглашение в
комнату»; сервер молчит — «повторите через пару минут».
Важное ограничение, о котором сказано прямо и в коде, и в документе:
команда НЕ проверяет, работает ли VPN на самом телефоне — этого со
стороны сервера не видно. Поэтому последний шаг всегда «проверьте
сами», с точной ссылкой и ожидаемым адресом. Обещать больше, чем
можешь проверить, — верный способ запутать человека.
Работает независимо от того, принял человек приглашение или нет:
комнаты выдачи переведены на видимость «shared», поэтому приглашённый
видит и профили, и ответ на команду.
Профили с раздельной маршрутизацией (.yaml для FlClash, .json для
Hiddify) и инструкция отправлены всем шестерым — и в личные комнаты
Matrix, и выложены на страницу раздачи. Адрес и пароль страницы
не менялись.
Проверено по факту, а не по отчёту бота: файл скачивался глазами
получателя и сверялся с исходным по SHA-256. Все 6 человек: по 2 файла,
оба целые, инструкция на месте. Плюс сквозная проверка, что после
добавления 204 правил домашний домен по-прежнему идёт в туннель
(git.buryans.ru -> [proxy]), а прочее напрямую.
НАЙДЕНА И ИСПРАВЛЕНА ТРЕТЬЯ ПОЛОМКА. Комнаты выдачи создавались
с видимостью истории "joined": человек видит только то, что отправлено
ПОСЛЕ его вступления. Пока он только приглашён, отправленные ему
профили ему НЕ видны — со стороны это выглядит как "мне ничего не
пришло", хотя на сервере всё лежит.
То есть Сергей, Елена и Полина физически не могли увидеть ни ключ,
ни профиль, пока не приняли бы приглашение. А приняли бы они его,
скорее всего, именно увидев сообщение — которого не видели. Замкнутый
круг, из-за которого раздача могла молча не дойти до трёх человек
из шести.
Исправлено: все шесть комнат переведены на "shared", приглашённые видят
присланное сразу. Проверено. Скрипт создания комнат тоже исправлен,
чтобы это не вернулось; отдельный скрипт fix-room-visibility.py
приводит уже созданные комнаты в порядок.
Урок общий и повторяющийся: проверять надо ГЛАЗАМИ ПОЛУЧАТЕЛЯ, а не
состоянием на сервере. Оба раза проблему нашла именно такая проверка —
сначала в личных комнатах бота, теперь в комнатах выдачи.
Задача от владельца: взять полный список из открытых источников и сразу
раскатать, дальше он будет дописывать штучно.
Причина, по которой это нужно: приложения ломаются не из-за туннеля, а
из-за адреса выхода. Банк, госуслуги и маркетплейс видят, что запрос
пришёл из-за рубежа, и закрывают доступ. Значит их трафик должен идти
МИМО туннеля — тогда всё работает и переключать ничего не нужно.
Что сделано:
* ops/vpn/home-and-ru-zones.json — ЕДИНСТВЕННОЕ место для правок.
Три списка: домашние домены в туннель (27), российские зоны напрямую
(174 + 3 глобальных). Дописал зону — пересобрал одной командой,
и она появилась и в правилах клиента, и в профилях для телефона;
* ops/vpn/split_config.py — общий загрузчик: списки больше не дублируются
в коде, иначе они разошлись бы;
* ops/vpn/build-split-profiles.py — готовые профили на каждого человека
(.yaml для FlClash, .json для Hiddify);
* ops/vpn/push-profiles-to-vps.sh — раскладка профилей на страницу раздачи;
* ops/vpn/update-page-split.py, deliver-split-profiles.py — обновление
страницы и доставка через Matrix.
Список из открытых публикаций апреля 2026 (со ссылками в документе):
Известия/dp.ru, Topvisor, Алтапресс, spbnews78. Покрыты банки, госуслуги,
маркетплейсы, продуктовые сети, аптеки, доставка, такси, самокаты,
навигаторы, операторы связи, кинотеатры, госсайты.
Раскатано на страницу раздачи рядом с QR-кодами: человек скачивает файл
прямо на телефоне и импортирует — второй экран больше не нужен.
Адрес и пароль страницы не менялись.
Проверено на живом клиенте: все 6 профилей проходят xray run -test
(Configuration OK); маршрутизация подтверждена журналом —
git.buryans.ru ушёл [proxy] и ответил 200, а sberbank.ru, gosuslugi.ru,
ozon.ru, wildberries.ru, ya.ru ушли [direct]. Внешний адрес недомашнего
трафика — 46.8.140.22, обычный путь.
Поймана и исправлена вторая настоящая поломка: первая версия профиля
опиралась на geosite:category-ru, и профиль НЕ загружался —
"failed to open file: geosite.dat". Для geosite нужен файл данных рядом
с клиентом, а его может не быть; на телефоне это выглядело бы как
"профиль не добавляется". Теперь geosite/geoip не используются вовсе,
правила строятся только из списка доменов и подсетей, а генератор
проверяет, что эта зависимость не вернулась.
Ключи в Git не попадают: папка ops/vpn/build/ внесена в .gitignore
(проверено git check-ignore), в репозитории только скрипты и списки.
Задача: часть приложений (банки, госуслуги, маркетплейсы) не работает,
когда весь трафик идёт через 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.
Владельцу нужна была одна команда, чтобы выдать профиль новому
участнику без ручной сборки 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 держал события круговой ссылкой.
Задача 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 ссылка,
а также отказ на чужой ключ и молчание на обычный текст.
Рассылка: профили отправлены всем шестерым, каждому в свою приватную
комнату. Проверено --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.
По решению владельца профили выдаются не только страницей, но и в 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). До решения
раздача семье не запускается — её будет не откатить без смены ключей.
Задача: 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