Files
buryan-infra/docs/TASKS.md
T
root 915de56603 Обновления из бота: реестр расширен с 28 до 50 служб
Жалоба владельца: обновление из бота не работает на многие сервисы.
Проверил — причина простая: скрипт работает только по реестру
services.yaml, а в нём было 28 служб при 97 работающих контейнерах.

НЕ ОБНОВЛЯЛИСЬ (22 службы), в том числе важные:
  adguard (DNS всего дома), loki (журналы), alertmanager (тревоги),
  mautrix-telegram (мост в Telegram), livekit (звонки), homeassistant,
  nextcloud, duplicati (копии), firefly, paperless в CT 110,
  nats, swarm-redis, element-web, coturn, zigbee2mqtt, mosquitto.

ЧТО СДЕЛАНО:
1. Добавлены все 22 службы. В реестре теперь 50.
2. Каждый адрес проверки здоровья проверен вручную перед записью.
   Правило жёсткое: адрес добавляется только если реально отвечает.
   Неверный адрес хуже отсутствующего — скрипт счёл бы службу сломанной
   и ОТКАТИЛ исправное обновление.
3. Службы с паролем не потеряли проверку: adguard и paperless-web
   ответили 401, я сначала убрал у них проверку — это было неправильно,
   401 означает ЖИВУЮ службу. Вернул с флагом auth_required.
4. ИСПРАВЛЕНА ОШИБКА В САМОМ СКРИПТЕ: если контейнер создан вручную и
   метки compose у него нет, скрипт запускал «docker compose up -d» БЕЗ
   имени службы — то есть пересоздавал весь проект вместе с соседями.
   Для /opt/smart-lxc это значило: обновляя homeassistant, он пересоздал
   бы ещё mosquitto и zigbee2mqtt. Теперь служба ищется в compose-файле
   по container_name. Проверено на homeassistant.

ПРОВЕРКА: добавлен validate-registry.sh — для каждой службы проверяет,
что контейнер существует, каталог compose на месте, адрес здоровья
отвечает ожидаемым кодом.
  служб в реестре: 50, полностью обновляемы: 49.

ОСТАЛОСЬ ОГРАНИЧЕНИЕМ (честно):
  * openclaw — контейнер снят сегодня (падал, диск был полон), ждёт
    решения владельца;
  * duplicati, alertmanager, buryan-alert-webhook — работают БЕЗ compose:
    скрипт скачает образ, но пересоздать контейнер не сможет и скажет
    об этом прямо, а не изобразит успех;
  * mosquitto/redis/nats/coturn — порты не HTTP, проверки здоровья нет;
  * 12 контейнеров oauth2-proxy-* не внесены: вспомогательные.

МОЯ ОШИБКА В ПРОВЕРКЕ: первая версия дала 6 ложных тревог, считая
401/403 сбоем. Пришлось учитывать auth_required — то же правило, что уже
было в скрипте обновления. Урок: проверка должна знать те же правила,
что и проверяемое.

РЕШЕНИЕ ВЛАДЕЛЬЦА УЧТЕНО: postgres-rbac не трогаем.
2026-10-17 12:36:43 +03:00

17 KiB
Raw Blame History

РЕЕСТР ЗАДАЧ

Ведётся по разделам плана. Порядок: обновления → сеть → звонки → связность → службы. Отдельным разделом — VPN (по решению от 17.10.2026).

БЛИЖАЙШИЕ ЗАДАЧИ (выбраны владельцем 17.10.2026)

Порядок — как решил владелец. Подробности — в разделах ниже.

# Что Где в реестре Состояние
1 Профиль безопасности во все контейнеры 1.1–1.2 🔶 1.1: измерено, нужен 2 из 23 и уже есть; 1.2: вынести в общее управление — ⬜
2 Скорость входа + 44 домена + один сертификат 2.1, 2.4, 2.5 ⬜ причина найдена (7,86 с), сделать
3 Все 28 служб в наблюдение 4.3.1 ⬜ сейчас 34 проверки, не все службы
4 Второй VPS — резервный выход VPN-4.6 ⬜ все каналы на одной машине
5 Element Call — звонки в Matrix 3.1–3.1.3 ⬜ звонков нет вовсе

Важно про пункт 4. В реестре была только задача «Второй шлюз» (VPN-4.1) — это резервный шлюз в доме. Она не решает проблему «одна машина»: все четыре канала (TLS, Hysteria2, XHTTP, Reality) живут на одном VPS, и если он недоступен, переключаться некуда. Поэтому добавлена отдельная задача VPN-4.6 — второй сервер у другого провайдера.


СВОДКА ПО РАЗДЕЛАМ

Цифры считает ops/registry/summary.py из этого же файла — поэтому они не устаревают. Не править вручную.

Раздел Всего Сделано Частично Осталось
ЗАВЕРШИТЬ ОБНОВЛЕНИЯ 8 2 0 6
СЕТЬ И ДОСТУП 7 2 0 5
ЗВОНКИ И МЕДИА 5 0 0 5
СКВОЗНАЯ СВЯЗНОСТЬ 12 1 3 8
УЛУЧШЕНИЕ СЛУЖБ 10 0 0 10
VPN (этапы 1–4) 29 19 4 6
РЕЕСТР НАЙДЕННЫХ ПРОБЛЕМ 17 8 3 6
ИТОГО 88 32 10 46

1. ЗАВЕРШИТЬ ОБНОВЛЕНИЯ

№ Задача Состояние
1.0 Профиль безопасности: причина найдена, Matrix исправлен ✅
1.1 Применить профиль в остальных контейнерах ✅ измерено: нужен 2 из 23, там уже есть
1.2 Вынести профиль в общее управление (один источник правды) ⬜
1.3 Обновить paperless ⬜
1.4 Обновить gitea ⬜
1.5 Обновить authentik ⬜
1.6 Обновить postgres-rbac ⬜
1.7 Автоматически убирать контейнеры-остатки 🔶 вручную сделано 17.10, автоматизации пока нет
1.13 Обновления из бота: реестр расширен с 28 до 50 служб ✅

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. Мобильный доступ

№ Задача Состояние
VPN-1.1 Удобный профиль для телефонов (ключей 10, QR на каждого) ✅
VPN-1.2 Инструкция для семьи (docs/VPN-FOR-FAMILY.md) ✅
VPN-1.3 Проверить на телефонах Сергея и AlexTest 🔶 ждёт устройств
VPN-1.4 Раздать остальным ✅ выдано всем шестерым
VPN-1.7 Выдать готовые профили с раздельной маршрутизацией ✅ доставлено и проверено
VPN-1.6 Выдача доступа новому человеку одной командой админа ✅ !vpn give @логин
VPN-1.5 Разместить ссылки в Vaultwarden ⬜
VPN-1.8 Ключ age: файл с ключом и инструкцией передан владельцу 🔶 ждёт записи в Vaultwarden и на флешку
VPN-1.9 Пароль root на PVE → в Vaultwarden ⬜ по слову владельца: пароль есть локально, пока не делает
VPN-1.10 n8n: двойник compose обезврежен, настоящий в порядке ✅
VPN-1.11 openclaw: диск освобождён (100%→55%), петля остановлена, состояние сохранено 🔶 нужно решить, какой экземпляр рабочий
VPN-1.12 Убрать остатки *-old-* ✅ убрано 11, оставлено 3 работающих

Этап 2. Больше протоколов

№ Задача Состояние
VPN-2.1 Добавить Hysteria2 на VPS (QUIC, для видео) ✅ проверено снаружи
VPN-2.2 Добавить VLESS + XHTTP (маскировка под сайт) ✅ проверено снаружи
VPN-2.3 Довести Reality — найти причину (порты 2087, 2053) ✅ проверено снаружи
VPN-2.4 Подписка с несколькими профилями ✅ проверено
VPN-2.5 Раздельная маршрутизация: туннель несёт только домашнее ✅
VPN-2.6 Приложения, которые не любят VPN — вывести из туннеля ✅ способ описан

Этап 3. Шлюз в доме

№ Задача Состояние
VPN-3.1 Поднять шлюз на отдельном CT ✅ CT 161, туннель (DNS перенесён в AdGuard)
VPN-3.2 Проверить на одном устройстве ✅ 10 мс против 485
VPN-3.3 Правило на Keenetic → шлюз ⬜ вместе с владельцем
VPN-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. Надёжность

№ Задача Состояние
VPN-4.1 Второй шлюз ⬜
VPN-4.2 Проверка «VPN работает» в наблюдении ✅
VPN-4.3 Сводка: кто реально пользуется VPN ✅ vpn-usage.py
VPN-4.4 Убрать отладку из журнала xray (рос 371 МБ) ✅
VPN-4.5 Копия конфигурации xray с ключами + проверенное восстановление ✅ зашифрована
VPN-4.6 Второй VPS у другого провайдера — резервный выход ⬜ все каналы на одной машине
VPN-4.7 Проверить автопереключение каналов НА ШЛЮЗЕ (отказом канала) ⬜ на телефоне проверено, на шлюзе нет

Что сделано по 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»). Исправлено.