Files
buryan-infra/docs/TASKS.md
T
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

189 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# РЕЕСТР ЗАДАЧ
Ведётся по разделам плана. Порядок: обновления → сеть → звонки → связность → службы.
Отдельным разделом — **VPN** (по решению от 17.10.2026).
## 1. ЗАВЕРШИТЬ ОБНОВЛЕНИЯ
| № | Задача | Состояние |
|---|---|---|
| 1.0 | Профиль безопасности: причина найдена, Matrix исправлен | ✅ |
| 1.1 | Применить профиль в остальных контейнерах (по одному, безопасно) | ⬜ |
| 1.2 | Вынести профиль в общее управление (один источник правды) | ⬜ |
| 1.3 | Обновить `paperless` | ⬜ |
| 1.4 | Обновить `gitea` | ⬜ |
| 1.5 | Обновить `authentik` | ⬜ |
| 1.6 | Обновить `postgres-rbac` | ⬜ |
| 1.7 | Автоматически убирать контейнеры-остатки | ⬜ |
## 2. СЕТЬ И ДОСТУП
| № | Задача | Состояние |
|---|---|---|
| 2.0 | Причина медленного входа найдена (7,86 с вместо 0,02 с) | ✅ |
| 2.1 | Кэш на VPS для файлов страницы входа | ⬜ |
| 2.2 | Локальный NGINX вместо NPM (файлы подготовлены) | ⬜ |
| 2.3 | AdGuard: включить DNS и прописать домены | ⬜ |
| 2.4 | Настроить все 44 домена (сейчас 12) | ⬜ |
| 2.5 | Один сертификат `*.buryans.ru` | ⬜ |
| 2.6 | Определить роль VPS (кэш, резерв или иное) | ⬜ |
## 3. ЗВОНКИ И МЕДИА
| № | Задача | Состояние |
|---|---|---|
| 3.1 | **Element Call**: настроить транспорт звонков | ⬜ отдельная |
| 3.1.1 | Указать LiveKit в настройках Synapse | ⬜ |
| 3.1.2 | Объявить транспорт в `.well-known` | ⬜ |
| 3.1.3 | Задать ключи связки Synapse и LiveKit | ⬜ |
| 3.2 | Свести медиаслужбы к единому входу и правам | ⬜ |
## 4. СКВОЗНАЯ СВЯЗНОСТЬ
| № | Задача | Состояние |
|---|---|---|
| 4.1.1 | Все домены под единый вход (22 приложения из 44 доменов) | ⬜ |
| 4.1.2 | Права по группам | ⬜ |
| 4.2.1 | Все службы шлют через общий слой | 🔶 частично |
| 4.3.1 | Все 28 служб в наблюдение | ⬜ |
| 4.3.2 | Проверять «работает», а не «отвечает» | 🔶 частично |
| 4.3.3 | Отдельная проверка: вход работает | ⬜ |
| 4.4.1 | Снимки перед изменениями | ✅ |
| 4.4.2 | Проверка восстановления из копий | ⬜ |
| 4.4.3 | Копии наружу | ⬜ |
| 4.5.1 | Проверка «образ запускается» до обновления | ⬜ |
| 4.5.2 | Различать «обновлено» и «уже актуально» | ⬜ |
| 4.6.1 | Карта хозяйства: служба → контейнер → домен → вход | ⬜ |
## 5. УЛУЧШЕНИЕ СЛУЖБ
| № | Задача | Состояние |
|---|---|---|
| 5.1 | `authentik` — ускорить, разобраться с медленной загрузкой | ⬜ |
| 5.2 | `headscale` дома — определить назначение (координацию держит VPS) | ⬜ |
| 5.3 | `paperless` — выбрать один из двух экземпляров | ⬜ |
| 5.4 | `immich` — свести базу в общий PostgreSQL | ⬜ |
| 5.5 | `uptime-kuma` — перевести на PostgreSQL или заменить | ⬜ |
| 5.6 | `sonarr`/`radarr`/`prowlarr` — проверить запись в базы | ⬜ |
| 5.7 | `npm` — решить судьбу (заменяется на NGINX) | ⬜ |
| 5.8 | `dashy` — сделать стартовой страницей со ссылками на всё | ⬜ |
| 5.9 | `openclaw` — определить назначение | ⬜ |
| 5.10 | `prometheus`/`grafana` — правила тревог и панели на все службы | ⬜ |
## 6. VPN
Раздел введён 17.10.2026 — по аудиту это задача первоочередная:
без VPN доступ снаружи непредсказуем.
### Этап 1. Мобильный доступ
| № | Задача | Состояние |
|---|---|---|
| 1.1 | Удобный профиль для телефонов (ключей 10, QR на каждого) | ✅ |
| 1.2 | Инструкция для семьи (`docs/VPN-FOR-FAMILY.md`) | ✅ |
| 1.3 | **Проверить на телефонах Сергея и AlexTest** | 🔶 ждёт устройств |
| 1.4 | Раздать остальным | ✅ выдано всем шестерым |
| 1.7 | Выдать готовые профили с раздельной маршрутизацией | ✅ доставлено и проверено |
| 1.6 | Выдача доступа новому человеку одной командой админа | ✅ `!vpn give @логин` |
| 1.5 | Разместить ссылки в Vaultwarden | ⬜ |
### Этап 2. Больше протоколов
| № | Задача | Состояние |
|---|---|---|
| 2.1 | Добавить Hysteria2 на VPS (QUIC, для видео) | ✅ проверено снаружи |
| 2.2 | Добавить VLESS + XHTTP (маскировка под сайт) | ✅ проверено снаружи |
| 2.3 | Довести Reality — найти причину (порты 2087, 2053) | ⬜ |
| 2.4 | Подписка с несколькими профилями | ✅ проверено |
| 2.5 | Раздельная маршрутизация: туннель несёт только домашнее | ✅ |
| 2.6 | Приложения, которые не любят VPN — вывести из туннеля | ✅ способ описан |
### Этап 3. Шлюз в доме
| № | Задача | Состояние |
|---|---|---|
| 3.1 | Поднять xray/sing-box на отдельном CT | ⬜ |
| 3.2 | Проверить на одном устройстве | ⬜ |
| 3.3 | Правило на Keenetic → шлюз | ⬜ вместе с владельцем |
| 3.4 | Подключить семью (телевизоры, телефоны) | ⬜ |
### Этап 4. Надёжность
| № | Задача | Состояние |
|---|---|---|
| 4.1 | Второй шлюз | ⬜ |
| 4.2 | Проверка «VPN работает» в наблюдении | ✅ |
| 4.3 | Сводка: кто реально пользуется VPN | ✅ `vpn-usage.py` |
| 4.4 | Убрать отладку из журнала xray (рос 371 МБ) | ✅ |
| 4.5 | Копия конфигурации xray с ключами + проверенное восстановление | ✅ зашифрована |
### Что сделано по VPN 17.10.2026
```
* ключей 5 -> 10, у каждого своё имя Buryan-01..10
* приватная страница с QR-кодами и инструкцией (закрыта паролем)
* инструкция для семьи: docs/VPN-FOR-FAMILY.md
* проверено: новый ключ выходит через VPS, 25 попыток из 25
* раздача через Matrix: приватная комната на каждого человека,
скрипт ops/vpn/matrix-distribute.py, проверено на akadmin
* отчёт: ops/vpn/VPN-STAGE1-IMPLEMENTATION.md
```
### Ждёт решения владельца
```
* класть ли профили в комнату, зеркалящуюся в Telegram:
тогда ключи попадут на серверы Telegram
* модели телефонов Сергея и AlexTest — для точной инструкции
* когда удобно провести проверку на телефонах (VPN-1.3)
```
### Что сделано по VPN Этапу 2
```
* Hysteria2 поднят на VPS (UDP 10443), проверен снаружи:
напрямую выходим как 46.8.140.22, через Hysteria2 — 193.233.210.184
* VLESS + XHTTP добавлен (TCP 8444, путь /buryan-xhttp), проверен снаружи:
через него выходим как 193.233.210.184, домашние службы и YouTube — 200
* итого рабочих каналов: три (VLESS+TLS, Hysteria2, XHTTP)
* открыт UDP-порт в экране VPS (правила сохранены, выживут перезагрузку)
* конфигурации xray и Hysteria2 теперь копируются зашифрованно
(ops/secrets-enc/vpn-configs.json), восстановление проверено
```
### Найдено при настройке Hysteria2
```
* репозиторий Hysteria переехал: был apernet/hysteria, стал
HyNetworks/hysteria — со старого адреса версия читается неверно;
* в экране VPS правило было только для TCP 10443, а для UDP — нет:
при политике DROP снаружи канал был бы недоступен, хотя на
сервере работал бы. Проверять надо СНАРУЖИ, а не только «слушает»;
* у Hysteria свой формат конфигурации, отдельного «test» нет —
проверяю пробным запуском и проверкой, что порт слушает.
```
## 7. РЕЕСТР НАЙДЕННЫХ ПРОБЛЕМ
| № | Проблема | Состояние |
|---|---|---|
| 1 | Профиль запрещал создание сокетов | ✅ решено (Matrix) |
| 2 | Профиль нужен в каждом контейнере | ⬜ |
| 3 | 13 контейнеров-остатков | 🔶 остановлены |
| 4 | Счётчики номеров | ✅ решено (10 баз) |
| 5 | Gitea не создавала задачи | ✅ решено |
| 6 | Headscale падал 2,7 суток | ✅ решено |
| 7 | Уведомления шли в AUTH | ✅ решено |
| 8 | Версия не в уведомлении | ✅ решено |
| 9 | Страница входа 7,86 с | 🔶 причина найдена |
| 10 | 44 домена, настроено 12 | ⬜ |
| 11 | Element Call не работает | ⬜ отдельная |
| 12 | Одна дверь (VPS) | ⬜ |
| 13 | Два экземпляра paperless | ⬜ |
| 14 | Immich вне общего PostgreSQL | ⬜ |
| 15 | Доступ снаружи непредсказуем (провайдер) | 🔶 канал рабочий, нужны запасные протоколы |
| 16 | Reality не проходит рукопожатие | ⬜ причина не найдена |
| 17 | Встроенный браузер MIUI не видит домашние адреса | ✅ причина найдена, решение: Chrome/Firefox |
**Обозначения:** ✅ сделано · 🔶 частично · ⬜ не начато