Files
buryan-infra/docs/TASKS.md
T
root f9e46ab664 Ключ age: проверка годности, документация, файл для владельца
Задача №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
приватной комнаты: проверка совпадала сама с собой.
2026-10-17 11:16:32 +03:00

215 lines
13 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 и домены | ✅ работает, 43 из 43 домена |
| 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 | Проверка восстановления из копий | 🔶 проверено для конфигураций VPN |
| 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 | ⬜ |
| 1.8 | **Ключ age**: файл с ключом и инструкцией передан владельцу | 🔶 ждёт записи в 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 | Поднять шлюз на отдельном CT | ✅ CT 161, туннель (DNS перенесён в AdGuard) |
| 3.2 | Проверить на одном устройстве | ✅ 10 мс против 485 |
| 3.3 | Правило на Keenetic → шлюз | ⬜ вместе с владельцем |
| 3.4 | Подключить семью (телевизоры, телефоны) | 🔶 шлюз готов, нужна настройка устройств |
### Что сделано по VPN Этапу 3 (шлюз в доме)
```
* CT 161 (192.168.1.161) с DNS: 43 домашних домена -> 192.168.1.10
* замерено: 10 мс напрямую против 485 мс через VPS (в 50 раз)
* проверено на реальном устройстве, обычный интернет не сломался
* роутер НЕ тронут (по указанию владельца)
* подробности: docs/VPN-STAGE3.md
```
### Этап 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, Reality)
* открыт 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 |
**Обозначения:** ✅ сделано · 🔶 частично · ⬜ не начато
### Запасной простой профиль (17.10.2026)
```
По жалобе «VPN бьётся по таймауту» проверено всё: сервер цел, профиль
цел (177 российских зон, 27 домашних). Найдена РАЗОВАЯ ошибка
соединения — канал иногда не устанавливается с первого раза.
Добавлен запасной профиль vpn-<имя>-simple.yaml: один проверенный канал
и те же правила. Лежит на странице в разделе «Запасной простой профиль».
Найден дефект в собственном сборщике: группа называлась так же, как
канал, и движок отвергал ВЕСЬ профиль («loop is detected in
ProxyGroup»). Исправлено.
```