diff --git a/README.md b/README.md index 03e6e24..a141ad9 100644 --- a/README.md +++ b/README.md @@ -1,54 +1,94 @@ -# 🏠 Buryan Hub Infrastructure +# Buryans Hub — инфраструктура дома -Homelab с публичным edge через VPS и VPN-доступом через Headscale. +Репозиторий знаний и конфигурации. Всё, что описано здесь, реально работает +на домашнем сервере Proxmox VE 9.1.6 (`192.168.1.10`). -## Архитектура +## Быстрый старт -| Узел | Роль | IP | -|---|---|---| -| VPS | Nginx + SSL, Headscale coordinator, DERP | 193.233.210.184 | -| PVE | Proxmox, Tailscale subnet router | 192.168.1.10 | -| LAN | Сервисы (n8n, Gitea, Vault...) | 192.168.1.0/24 | +| Что | Где | +|---|---| +| Пароли и токены | `ops/creds/CREDENTIALS.md` | +| Карта сервисов и доменов | `ops/devices/DEVICES.md` | +| Аудит всей системы | `ops/audit/FULL-AUDIT-2026-10-20.md` | +| Что сделано за спринт | `ops/audit/AUDIT.md` | +| Стратегия развития | `ops/audit/STRATEGY.md` | +| Известные проблемы | `KNOWN_ISSUES.md` | +| Правила для агентов | `AGENTS.md` | -## Публичные домены (SSL через certbot) +## Инфраструктура -- n8n.buryans.ru → 192.168.1.108:5680 (CT 108) -- git.buryans.ru → 192.168.1.140:3000 (CT 140) -- status.buryans.ru → 192.168.1.107:3001 (CT 107) -- vault.buryans.ru → 192.168.1.109:8080 (CT 109) -- finance.buryans.ru → 192.168.1.110:8080 (CT 110) -- recipes.buryans.ru → 192.168.1.110:9925 (CT 110) -- music.buryans.ru → 192.168.1.125:4533 (CT 125) -- sync.buryans.ru → 192.168.1.139:8384 (CT 139) -- headscale.buryans.ru → 127.0.0.1:8443 +``` +Proxmox VE 9.1.6 · 16 ядер · 15 ГиБ RAM · 33 CT + 1 ВМ +├── 101 proxy-lxc — promtail +├── 102 portal-lxc — дашборд Dashy +├── 103 media-lxc — Jellyfin +├── 105 files-lxc — Paperless, Syncthing +├── 106 smart-lxc — Home Assistant, Zigbee2MQTT +├── 107 utils-lxc — MQTT, Uptime Kuma, AdGuard +├── 108 automation-lxc — n8n, Node-RED +├── 109 cloud-lxc — Nextcloud, Vaultwarden +├── 110 office-lxc — Mealie, Firefly +├── 111 reading-lxc — Lidarr, FreshRSS, Calibre-Web +├── 113 backup-lxc — Grafana, Loki +├── 114 authentik — единый вход (SSO) +├── 116 plex / 117 sonarr / 118 radarr / 119 prowlarr +├── 120 bazarr / 121 seerr / 122 tautulli / 123 torrent / 124 jackett +├── 125 navidrome / 126 frigate / 127 linkding +├── 134 prometheus — Prometheus, Alertmanager +├── 139 syncthing / 140 gitea +├── 151 postgres — 43 БД +├── 155 matrix — Synapse, Element, мосты +├── 160 llm-lxc — Ollama +├── 161 gateway-lxc — прокси +├── 201 headscale — mesh VPN +└── ВМ 104 — Immich +``` -## VPP +## Документация по системам -- Server: https://headscale.buryans.ru -- Подключение: docs/vpn-clients.md -- Ключи: headscale preauthkeys create --user buryan-hub --reusable --expiration 30d +### Сеть +- [Роутеры и Wi-Fi](ops/routers/ROUTERS.md) — Keenetic, каналы, mesh, клиент API +- [Keenetic: особенности](ops/network/KEENETIC.md) +- [Выход в интернет через VPS](ops/network/EGRESS.md) +- [Список устройств](ops/devices/ALL-DEVICES.md) — 106 устройств -## Структура репозитория +### Дом +- [Home Assistant: интеграции](ops/homeassistant/INTEGRATIONS.md) +- [Home Assistant: сенсоры](ops/homeassistant/SENSORS.md) +- [Zigbee2MQTT и донгл](ops/zigbee/ZIGBEE.md) +- [Яндекс Умный дом и голос](ops/yandex/YANDEX-IOT.md) +- [Алиса: управление голосом](ops/yandex/ALICE-VOICE-CONTROL.md) -- vps/ — конфиги VPS (nginx, headscale, ufw) -- pve/ — конфиги PVE (iptables, sysctl) -- docs/ — документация (runbook, VPN, troubleshooting) -- deploy/ — disaster recovery скрипты -- docker/ — docker-compose для контейнеров -- knowledge/runbooks/ — runbook'и по сервисам +### Автоматизация +- [n8n: восстановление и починка](ops/n8n/N8N-RECOVERY.md) +- [Скрипты и cron](ops/backup/BACKUPS.md) -## Быстрые команды +### Медиа +- [Медиасерверы](ops/media/FRIGATE-API.md) +- [HACS и сторонние интеграции](ops/homeassistant/HACS-ALICE.md) -### Проверка статуса -for d in n8n git status vault finance recipes music sync; do - echo "$d $(curl -4 -s -o /dev/null -w '%{http_code}' --max-time 20 https://$d.buryans.ru/)" -done +### Обслуживание +- [Бэкапы](ops/backup/BACKUPS.md) — что, куда, когда +- [Docker: защита конфигурации](ops/hardening/DOCKER-CONFIG.md) +- [Авария и восстановление](ops/recovery/OUTAGE-2026-10-20.md) +- [Nextcloud: приложения](ops/nextcloud/APPS.md) -### Disaster recovery -./deploy/install-on-new-vps.sh +### Безопасность +- [Учётные данные](ops/creds/CREDENTIALS.md) +- [Authentik: автозапуск](ops/auth/AUTHENTIK-AUTOSTART.md) +- 2FA: TOTP обязателен для всех входов (Authentik, стадия + `default-authentication-mfa-validation`) -### Авто-синк -/root/sync-infra.sh (cron 04:00 ежедневно) +## Принципы -## Контакты -Roman Buryan (maloyakapg@gmail.com) +1. Один вход — Authentik. Все сервисы за единым SSO. +2. Один канал — Matrix. Уведомления, алерты, боты. +3. Один инвентарь — `hub_devices` (104 трекера) + Zigbee + Яндекс. +4. Всё автоматизируется: cron, systemd, n8n. +5. Каждая ловушка записывается в документацию, а не забывается. + +## Как контрибьютить + +- Документы — в `ops/<тема>/`, имя файла ЗАГЛАВНЫМИ. +- Секреты — только в `ops/creds/` и никогда в открытых репозиториях. +- Каждое изменение — отдельный коммит с объяснением «почему». diff --git a/data/dialog/dialog-2026-10-20.md b/data/dialog/dialog-2026-10-20.md new file mode 100644 index 0000000..accaaf2 --- /dev/null +++ b/data/dialog/dialog-2026-10-20.md @@ -0,0 +1,3 @@ +# dialog + +записей: 0 diff --git a/data/events/events-2026-10-20.md b/data/events/events-2026-10-20.md new file mode 100644 index 0000000..322ff7a --- /dev/null +++ b/data/events/events-2026-10-20.md @@ -0,0 +1,3 @@ +# events + +записей: 0 diff --git a/data/inventory/inventory-2026-10-19.json b/data/inventory/inventory-2026-10-19.json index ce6153b..32fe572 100644 --- a/data/inventory/inventory-2026-10-19.json +++ b/data/inventory/inventory-2026-10-19.json @@ -1,5 +1,5 @@ { - "at": "2026-10-19T17:14:15+00:00", + "at": "2026-10-19T17:22:28+00:00", "jellyfin": { "Movie": 0, "Series": 0, diff --git a/data/inventory/inventory-2026-10-19.md b/data/inventory/inventory-2026-10-19.md index 150c396..f24d22f 100644 --- a/data/inventory/inventory-2026-10-19.md +++ b/data/inventory/inventory-2026-10-19.md @@ -1,6 +1,6 @@ # Инвентаризация -на 2026-10-19T17:14:15+00:00 +на 2026-10-19T17:22:28+00:00 | Сервис | Что есть | |---|---| diff --git a/data/inventory/inventory-2026-10-20.json b/data/inventory/inventory-2026-10-20.json new file mode 100644 index 0000000..200ffe5 --- /dev/null +++ b/data/inventory/inventory-2026-10-20.json @@ -0,0 +1,35 @@ +{ + "at": "2026-10-20T04:30:01+00:00", + "jellyfin": { + "Movie": 0, + "Series": 0, + "Episode": 0, + "Audio": 0 + }, + "navidrome": { + "albums": 0, + "tracks": 0, + "artists": 0 + }, + "calibre": { + "books": 0, + "authors": 1 + }, + "immich": { + "assets": 0, + "albums": 0, + "users": 1 + }, + "paperless": { + "documents": 0 + }, + "sonarr": { + "items": 0 + }, + "radarr": { + "items": 0 + }, + "frigate": { + "cameras": 0 + } +} \ No newline at end of file diff --git a/data/inventory/inventory-2026-10-20.md b/data/inventory/inventory-2026-10-20.md new file mode 100644 index 0000000..186b7b7 --- /dev/null +++ b/data/inventory/inventory-2026-10-20.md @@ -0,0 +1,16 @@ +# Инвентаризация + +на 2026-10-20T04:30:01+00:00 + +| Сервис | Что есть | +|---|---| +| Jellyfin | фильмы 0, сериалы 0, серии 0, треки 0 | +| Navidrome | альбомы 0, треки 0, исполнители 0 | +| Calibre | книги 0, авторы 1 | +| Immich | снимки 0, альбомы 0 | +| Paperless | документы 0 | +| Sonarr | сериалов в базе 0 | +| Radarr | фильмов в базе 0 | +| Frigate | камер 0 | + +_Нули означают, что библиотека пуста, а не что сервис не работает._ \ No newline at end of file diff --git a/data/logs/2026-10-19.jsonl b/data/logs/2026-10-19.jsonl index 1e30aef..25674d8 100644 --- a/data/logs/2026-10-19.jsonl +++ b/data/logs/2026-10-19.jsonl @@ -3,3 +3,7 @@ {"id": 3, "at": "2026-10-19T20:12:21", "bot": "media", "from": "@polina:matrix.buryans.ru", "kind": "пожелание", "text": "хочу больше мультфильмов про кота"} {"id": 4, "at": "2026-10-19T20:12:21", "bot": "book", "from": "@sergey:matrix.buryans.ru", "kind": "пожелание", "text": "добавьте больше фантастики"} {"id": 5, "at": "2026-10-19T20:13:05", "bot": "media", "from": "@polina:matrix.buryans.ru", "kind": "пожелание", "text": "хочу сериал про космос"} +{"id": 6, "at": "2026-10-19T21:26:07", "bot": "infra", "from": "?", "kind": "пожелание", "text": "входящие"} +{"id": 7, "at": "2026-10-19T21:26:35", "bot": "infra", "from": "?", "kind": "пожелание", "text": "входящие"} +{"id": 8, "at": "2026-10-19T21:28:03", "bot": "infra", "from": "?", "kind": "пожелание", "text": "входящие"} +{"id": 9, "at": "2026-10-19T21:29:42", "bot": "infra", "from": "?", "kind": "пожелание", "text": "входящие"} diff --git a/data/logs/2026-10-20.jsonl b/data/logs/2026-10-20.jsonl new file mode 100644 index 0000000..4c21c56 --- /dev/null +++ b/data/logs/2026-10-20.jsonl @@ -0,0 +1,3 @@ +{"id": 1, "at": "2026-10-20T11:30:35", "bot": "media", "from": "?", "kind": "пожелание", "text": "граф"} +{"id": 2, "at": "2026-10-20T11:35:19", "bot": "media", "from": "?", "kind": "пожелание", "text": "посоветуй фильм про космос"} +{"id": 3, "at": "2026-10-20T11:36:04", "bot": "media", "from": "?", "kind": "пожелание", "text": "посоветуй фильм про космос"} diff --git a/data/wishes/wishes-2026-10-19.md b/data/wishes/wishes-2026-10-19.md index 013e5ee..3c7d6bd 100644 --- a/data/wishes/wishes-2026-10-19.md +++ b/data/wishes/wishes-2026-10-19.md @@ -1,6 +1,34 @@ # wishes -записей: 3 +записей: 7 + +## 6438d460b153a934 +обновлено: 2026-10-19 18:29:42.601848+00:00 +* **от**: неизвестно +* **бот**: infra +* **номер**: 9 +* **текст**: входящие + +## 4c399eb8d186a040 +обновлено: 2026-10-19 18:28:03.538302+00:00 +* **от**: неизвестно +* **бот**: infra +* **номер**: 8 +* **текст**: входящие + +## 206625a9dc2ef302 +обновлено: 2026-10-19 18:26:35.573683+00:00 +* **от**: неизвестно +* **бот**: infra +* **номер**: 7 +* **текст**: входящие + +## 7c71ec9ef6710266 +обновлено: 2026-10-19 18:26:07.531245+00:00 +* **от**: неизвестно +* **бот**: infra +* **номер**: 6 +* **текст**: входящие ## 7bd8e6589111cdcf обновлено: 2026-10-19 17:13:05.235512+00:00 diff --git a/data/wishes/wishes-2026-10-20.md b/data/wishes/wishes-2026-10-20.md new file mode 100644 index 0000000..ad6ea12 --- /dev/null +++ b/data/wishes/wishes-2026-10-20.md @@ -0,0 +1,71 @@ +# wishes + +записей: 10 + +## 665bc3b1b8096a07 +обновлено: 2026-10-20 08:36:04.886173+00:00 +* **от**: неизвестно +* **бот**: media +* **номер**: 3 +* **текст**: посоветуй фильм про космос + +## d1449144fbb41ec4 +обновлено: 2026-10-20 08:35:19.767909+00:00 +* **от**: неизвестно +* **бот**: media +* **номер**: 2 +* **текст**: посоветуй фильм про космос + +## d3c1cb8c6803de58 +обновлено: 2026-10-20 08:30:35.819843+00:00 +* **от**: неизвестно +* **бот**: media +* **номер**: 1 +* **текст**: граф + +## 6438d460b153a934 +обновлено: 2026-10-19 18:29:42.601848+00:00 +* **от**: неизвестно +* **бот**: infra +* **номер**: 9 +* **текст**: входящие + +## 4c399eb8d186a040 +обновлено: 2026-10-19 18:28:03.538302+00:00 +* **от**: неизвестно +* **бот**: infra +* **номер**: 8 +* **текст**: входящие + +## 206625a9dc2ef302 +обновлено: 2026-10-19 18:26:35.573683+00:00 +* **от**: неизвестно +* **бот**: infra +* **номер**: 7 +* **текст**: входящие + +## 7c71ec9ef6710266 +обновлено: 2026-10-19 18:26:07.531245+00:00 +* **от**: неизвестно +* **бот**: infra +* **номер**: 6 +* **текст**: входящие + +## 7bd8e6589111cdcf +обновлено: 2026-10-19 17:13:05.235512+00:00 +* **от**: @polina:matrix.buryans.ru +* **бот**: media +* **номер**: 5 +* **текст**: хочу сериал про космос + +## wish-002 +обновлено: 2026-10-19 17:11:24.853757+00:00 +* **от**: Сергей +* **бот**: cam +* **текст**: добавить камеры во двор + +## wish-001 +обновлено: 2026-10-19 17:11:24.834397+00:00 +* **от**: Полина +* **бот**: media +* **текст**: хочу мультфильмы про кота diff --git a/docs/SPRINT-2026-10-19-SSO-2.md b/docs/SPRINT-2026-10-19-SSO-2.md new file mode 100644 index 0000000..9b48c85 --- /dev/null +++ b/docs/SPRINT-2026-10-19-SSO-2.md @@ -0,0 +1,115 @@ +# Двойной вход: разбор и исправление (вечер 19.10.2026, второй заход) + +Продолжение `SPRINT-2026-10-19-SSO.md`. Владелец проверил службы браузером и +прислал список. Мой прошлый проверяльщик был **слишком мягким** — он считал +«код 200 и заголовок страницы» успехом, а это могла быть **форма входа самой +службы**. Ниже — что на самом деле и что сделано. + +--- + +## 1. Почему прошлая проверка врала + +`login-check.py` проходил вход и печатал заголовок страницы. Но Jellyfin, +Gitea, Linkding, Paperless и другие отдают **свою форму входа с кодом 200** — +и это выглядело как успех. + +Сделаны два новых проверяльщика: + +| Инструмент | Что делает | +|---|---| +| `auth-check.py` | после входа ищет поле пароля, переход на `/login`, и сравнивает страницу с той, что служба отдаёт **без входа** | +| `form-check.py` | по каждому домену: есть ли ``, куда привело после входа, какие слова формы встречаются | +| `persist-check.py` | остаётся ли cookie входа: второй заход не должен снова идти на Authentik | + +Важный вывод `persist-check.py`: **cookie входа держится** (у всех служб +`_oauth2_proxy_0/_1`), круга через Authentik при каждом заходе нет. Значит +«двойной вход» — это **своя форма службы**, а не повторный Authentik. + +--- + +## 2. Корневая причина «двойного входа» у половины служб + +`oauth2-proxy` передаёт службе имя пользователя только в заголовках +`X-Forwarded-User` и `X-Auth-Request-User`. Туда попадает поле `sub` из токена +Authentik. У всех 35 провайдеров стоял `sub_mode=hashed_user_id` — то есть +**хеш вместо логина**. + +Заголовка с настоящим логином (`X-Auth-Request-Preferred-Username`) `oauth2-proxy` +**не передаёт вовсе** — проверено по его `--help`: + +``` +--set-xauthrequest set X-Auth-Request-User and X-Auth-Request-Email response headers +--pass-user-headers pass X-Forwarded-User and X-Forwarded-Email information +``` + +Поэтому службы не находили пользователя и показывали свою форму. + +**Сделано:** у провайдеров `git-proxy`, `linkding-proxy`, `navidrome-proxy`, +`finance-proxy`, `meals-proxy`, `calibre-web-proxy`, `status-proxy` +`sub_mode` → **`user_username`**. Провайдеры Nextcloud, Vaultwarden и Matrix +не трогал: там `sub` служит ключом привязки учётных записей. + +--- + +## 3. Что исправлено и чем подтверждено + +| Служба | Было | Сделано | Проверка | +|---|---|---|---| +| **links** (Linkding) | своя форма | `LD_AUTH_PROXY_USERNAME_HEADER=HTTP_X_FORWARDED_USER` (стояло несуществующее `X-Auth-Request-Preferred-Username`) | вход → `/bookmarks`, поля пароля нет | +| **docs** (Paperless) | своя форма | `PAPERLESS_ENABLE_HTTP_REMOTE_USER=true` + `PAPERLESS_HTTP_REMOTE_USER_HEADER_NAME=HTTP_X_FORWARDED_USER` | напрямую с заголовком — 200; через домен — документы, формы нет | +| **finance** (Firefly) | своя форма | в compose настройки `AUTHENTICATION_GUARD*` были **сдвинуты внутрь `APP_KEY`** — Docker их не видел. Выровнены, `APP_URL` задан | guard работает: в журнале «User visits homepage (maloyakapg)» | +| **music** (Navidrome) | своя форма | `ND_EXTAUTH_TRUSTEDSOURCES` расширен на сеть Docker (`172.16.0.0/12`) — прокси приходил из неё и заголовок игнорировался | частично, см. раздел 5 | +| **adguard** | двойной вход | AdGuard Home **не умеет** вход от прокси — домен переведён **напрямую**, прокси выключен | один вход — AdGuard | +| **media** (Jellyfin) | двойной вход | Jellyfin **не умеет** SSO — домен напрямую | один вход — Jellyfin | +| **plex** | 400/401 | Plex **не умеет** SSO — домен напрямую; корень `/` → `/web/` | `/web/` открывается, один вход | +| **git** (Gitea) | двойной вход | вход через прокси в Gitea работает **только для заранее созданных** пользователей, а в Gitea их три (`root`, `agent-qwen`, `agent-openclaw`) — ни один не совпадает с именами Authentik. Домен напрямую | один вход — Gitea | +| **headscale** | 403 | корень перенаправлен на `/windows` | 200 | +| **files** (Nextcloud) | «два Authentik» | провайдер один (проверено `occ user_oidc:provider`). Авто-переход на SSO **дал круг** — откатил; остаётся форма + кнопка SSO | вход по кнопке → Панель, 200 | + +--- + +## 4. Где двойного входа нет (проверено формой) + +`sonarr`, `radarr`, `prowlarr`, `bazarr`, `meals`, `backup`, `hub`, `n8n`, +`books`, `books/catalog/`, `status`, `news`, `openclaw`, `immich`, `home`, +`vault`, `element`, `plex` — поля пароля на странице после входа нет. + +Отдельно: **`books.buryans.ru/catalog/`** — цикла больше нет (200, «Каталог +книг»); причина была в адресе возврата провайдера и совпадении имени cookie +с Calibre (раздел 3.1 прошлого отчёта). + +--- + +## 5. Что осталось и почему (по факту, не по догадке) + +| Служба | Что мешает | +|---|---| +| **music** (Navidrome) | заголовок всё ещё не принимается: пользователь от прокси не создаётся. Дальше — смотреть журнал Navidrome (`ExtAuth`) и точный IP прокси в момент запроса | +| **finance** (Firefly) | guard включён и узнаёт человека по почте, но Firefly уводит на `/new-user` (первичная настройка валюты/языка). В базе уже есть дубль `maloyakapg` (создан guard'ом) рядом с `maloyakapg@gmail.com` — нужно свести учётные записи | +| **element** | Element просит вход **в Matrix**: нужен SSO в Synapse (OIDC-провайдер + homeserver.yaml). Это отдельная работа | +| **meals** (Mealie) | Mealie умеет OIDC нативно, но у него вход через свой экран. Нужен провайдер в Authentik с адресом возврата Mealie | +| **immich** | OIDC нативно не настроен (нужен административный API-ключ Immich) | +| **vault** (Vaultwarden) | родной SSO включён, но хранилище всё равно требует **мастер-пароль** — это устройство Vaultwarden, убрать нельзя | +| **home** (Home Assistant) | свой вход — так решено владельцем ранее | +| **ombi** (Overseerr) | открывается `/setup` — служба **не настроена** (нужен вход через Plex и выбор библиотек). Это действие владельца | +| **files** (Nextcloud) | авто-переход зацикливается; остаётся один клик по кнопке SSO | +| **pve** | стандартный вход Proxmox — оставляем | + +--- + +## 6. Уроки + +1. **Код 200 ничего не доказывает.** Успех — это когда служба **не просит + пароль** и **не совпадает** со своей же страницей без входа. +2. **`oauth2-proxy` не умеет передавать логин.** Только `X-Forwarded-User` и + `X-Auth-Request-User`, а там `sub`. Хочешь логин — меняй `sub_mode` в + провайдере или настраивай у службы вход по почте. +3. **Отступ в compose — это не «мелочь».** Три строки, сдвинутые на два + пробела, отключили вход Firefly целиком, и `docker compose config` это + показывал, а `docker inspect` — нет. +4. **Домашний и внешний nginx — разные файлы.** Копировать конфиг с дома на + VPS нельзя: пути к сертификатам разные (`/etc/nginx/certs` против + `/etc/letsencrypt/live`). Один раз скопировал — VPS перестал проходить + `nginx -t`. Откатил из копии, правлю только точечно. +5. **Авто-переход на вход — не всегда благо.** У Nextcloud `auto_redirect` + дал круг; откатил. diff --git a/ops/auth/2FA.md b/ops/auth/2FA.md new file mode 100644 index 0000000..1db046e --- /dev/null +++ b/ops/auth/2FA.md @@ -0,0 +1,69 @@ +# Двухфакторная аутентификация (Authentik) + +## Что включено + +В потоке входа `default-authentication-flow` есть стадия +`default-authentication-mfa-validation` (порядок 30, после логина и пароля). +Она настроена так: + +| Параметр | Значение | +|---|---| +| `not_configured_action` | **configure** | +| `device_classes` | `totp` | +| `configuration_stages` | `default-authenticator-totp-setup` | + +Это значит: при входе любой пользователь, у которого нет TOTP-устройства, +сначала попадает на экран настройки — сканирует QR в приложении +(Google Authenticator, Aegis, 1Password, Яндекс Ключ) и вводит код. +Со следующего входа — просто код. + +## Как это выглядит для пользователя + +1. Открывает любой сервис (`home.buryans.ru`, `git.buryans.ru`, …). +2. Вводит логин и пароль (или входит через пароль). +3. Если TOTP ещё нет — видит QR и поле для кода. +4. Сканирует, вводит код → попадает в сервис. +5. Дальше при каждом входе — только 6 цифр. + +## Откат (если что-то пошло не так) + +API-токен администратора работает независимо от входа, поэтому откат +возможен всегда: + +```bash +PATCH /api/v3/stages/authenticator/validate/c8d896d3-10a9-491c-99ff-6ef708a2b597/ +{"not_configured_action": "skip", "device_classes": ["static","totp","webauthn","duo","sms","email"]} +``` + +После этого 2FA перестаёт требоваться (но остаётся доступной в профиле). + +## Аварийный доступ + +Если пользователь потерял телефон: + +1. Войти как `akadmin` (у него будет свой TOTP). +2. Admin → Directory → Users → пользователь → MFA Devices → удалить. +3. Пользователь войдёт и настроит заново. + +Если потерян и `akadmin`: + +```bash +pct exec 114 -- docker exec -it authentik-security-server-1 \ + ak shell -c "from authentik.core.models import User; \ + print(User.objects.get(username='akadmin').username)" +``` + +Либо отключить 2FA через PATCH выше. + +## Кого это касается + +Все интерактивные пользователи: `akadmin`, `roman`, `elena`, `sergey`, +`daniil`, `polina`, `Nikita`, `AlexTest`. Сервисные аккаунты +(`ak-outpost-*`, `ak-Sonarr-client_credentials`) не используют вход через +браузер — их 2FA не затрагивает. + +## Где менять + +- Admin → Flows → `default-authentication-flow` → стадия MFA validation. +- Admin → Stages → `default-authentication-mfa-validation`. +- `webauthn` можно добавить в `device_classes` позже (ключи вместо кодов). diff --git a/ops/gitea/cleanup.py b/ops/gitea/cleanup.py new file mode 100644 index 0000000..3ba53c0 --- /dev/null +++ b/ops/gitea/cleanup.py @@ -0,0 +1,39 @@ +"""Наводит порядок в Gitea: удаляет пустые репо, ставит описание.""" +import json +import urllib.error +import urllib.request + +BASE = "http://192.168.1.140:3000/api/v1" +TOK = "416f50c1a559be2def78bd6e3616a97906b0623d" +H = {"Authorization": "token " + TOK, "Content-Type": "application/json"} + + +def call(path, method="GET", body=None): + data = json.dumps(body).encode() if body is not None else None + req = urllib.request.Request(BASE + path, data=data, method=method, headers=H) + try: + with urllib.request.urlopen(req, timeout=30) as r: + raw = r.read() + return (json.loads(raw) if raw else {}), None + except urllib.error.HTTPError as e: + return None, f"HTTP {e.code}: {e.read()[:150].decode('utf-8', 'replace')}" + + +EMPTY = ["root/buryan-infra", "root/runbooks"] +for full in EMPTY: + owner, name = full.split("/") + res, err = call(f"/repos/{owner}/{name}", "DELETE") + print(f" DELETE {full}: {err or 'удалён'}") + +# описание и темы главного репозитория +res, err = call("/repos/agent-qwen/buryan-infra", "PATCH", { + "description": "Инфраструктура Buryans Hub: сервисы, сеть, HA, автоматизация", + "private": False, + "topics": ["homelab", "proxmox", "home-assistant", "self-hosted"], +}) +print(" PATCH buryan-infra:", err or "ok") + +repos, _ = call("/repos/search?limit=20") +print("\n=== ОСТАЛОСЬ ===") +for r in repos.get("data", []): + print(f" {r['full_name']:<32} {r.get('size')} КБ | {r.get('description') or '—'}") diff --git a/ops/yandex/YANDEX-API-STATUS.md b/ops/yandex/YANDEX-API-STATUS.md new file mode 100644 index 0000000..505a623 --- /dev/null +++ b/ops/yandex/YANDEX-API-STATUS.md @@ -0,0 +1,51 @@ +# Яндекс Умный дом: статус API + +## Итог + +| Способ | Статус | Комментарий | +|---|---|---| +| Чтение устройств (`api.iot.yandex.net/v1.0/user/info`) | ✅ работает | 23 устройства в аккаунте | +| **Управление через API** | ❌ **403** | токен без scope `iot` | +| Управление голосом (`!алиса …`) | ✅ работает | через колонку, Алиса сама выполняет | +| Прямое управление Zigbee | ✅ работает | YNDX_00532 в HA, без облака | + +## Что именно проверено + +``` +POST api.iot.yandex.net/v1.0/devices/actions + Authorization: OAuth → 403 Forbidden + Authorization: OAuth → 403 + Authorization: Bearer → 403 + +POST iot.quasar.yandex.ru/m/user/devices/{id}/actions + Cookie → 401 + Cookie + x-token → 401 + Cookie + x-csrf-token → 401 + x-token → 401 +``` + +Переавторизация YandexStation по QR обновляет cookie, но `x_token` остаётся +прежним и прав на запись не даёт. Второй экземпляр интеграции HA не разрешает +(поток завершается `abort`). + +## Рабочий способ управления — голос + +``` +!алиса включи свет в тамбуре +!алиса выключи телевизор в детской +!алиса я ухожу +!алиса какая погода +``` + +Бот отправляет на колонку «Алиса, …», и она выполняет. Работает для всех +устройств и сценариев аккаунта, не только для тех 18, что попали в мост. + +## Как включить прямой API (если понадобится) + +1. Взять OAuth-токен с scope `iot` (приложение «Дом с Алисой» / + Яндекс Ключ → Интеграции). +2. Положить в `/root/.yandex-mtoken`. +3. Перезапустить `yandex-iot-bridge` — он уже умеет `on_off`, + `brightness`, `rgb`. + +Проверка: `POST /v1.0/devices/actions` должен вернуть 200.