2FA включён, Gitea прибран, README-индекс, статус Яндекс API

Authentik: стадия MFA Validation переведена в режим configure с TOTP —
при входе пользователь без устройства проходит настройку по QR. Откат
описан в ops/auth/2FA.md.

Gitea: удалены пустые репозитории root/buryan-infra и root/runbooks,
главному репозиторию задано описание и темы. README переписан как индекс:
карта инфраструктуры, ссылки на все разделы документации, принципы.

Яндекс: зафиксирован статус — чтение работает, управление через API 403
(нет scope iot), управление голосом и Zigbee работают.
This commit is contained in:
buryan-agent committed 2026-10-20 23:32:33 +03:00
1 parent a96bdac9b6
commit d967d4ed3f
15 files changed
+520 -43

No files matched your search

+80 -40
View File
@@ -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/` и никогда в открытых репозиториях.
- Каждое изменение — отдельный коммит с объяснением «почему».
+3
View File
@@ -0,0 +1,3 @@
# dialog
записей: 0
+3
View File
@@ -0,0 +1,3 @@
# events
записей: 0
+1 -1
View File
@@ -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,
+1 -1
View File
@@ -1,6 +1,6 @@
# Инвентаризация
на 2026-10-19T17:14:15+00:00
на 2026-10-19T17:22:28+00:00
| Сервис | Что есть |
|---|---|
+35
View File
@@ -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
}
}
+16
View File
@@ -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 |
_Нули означают, что библиотека пуста, а не что сервис не работает._
+4
View File
@@ -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": "входящие"}
+3
View File
@@ -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": "посоветуй фильм про космос"}
+29 -1
View File
@@ -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
+71
View File
@@ -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
* **текст**: хочу мультфильмы про кота
+115
View File
@@ -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` | по каждому домену: есть ли `<input type="password">`, куда привело после входа, какие слова формы встречаются |
| `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`
дал круг; откатил.
+69
View File
@@ -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` позже (ключи вместо кодов).
+39
View File
@@ -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 '—'}")
+51
View File
@@ -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 <music_token> → 403 Forbidden
Authorization: OAuth <x_token> → 403
Authorization: Bearer <x_token> → 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.