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:
1 parent
a96bdac9b6
commit
d967d4ed3f
15 files changed
+520
-43
No files matched your search
@@ -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/` и никогда в открытых репозиториях.
|
||||
- Каждое изменение — отдельный коммит с объяснением «почему».
|
||||
@@ -0,0 +1,3 @@
|
||||
# dialog
|
||||
|
||||
записей: 0
|
||||
@@ -0,0 +1,3 @@
|
||||
# events
|
||||
|
||||
записей: 0
|
||||
@@ -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,6 +1,6 @@
|
||||
# Инвентаризация
|
||||
|
||||
на 2026-10-19T17:14:15+00:00
|
||||
на 2026-10-19T17:22:28+00:00
|
||||
|
||||
| Сервис | Что есть |
|
||||
|---|---|
|
||||
|
||||
@@ -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
|
||||
}
|
||||
}
|
||||
@@ -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 |
|
||||
|
||||
_Нули означают, что библиотека пуста, а не что сервис не работает._
|
||||
@@ -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": "входящие"}
|
||||
@@ -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": "посоветуй фильм про космос"}
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
* **текст**: хочу мультфильмы про кота
|
||||
@@ -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`
|
||||
дал круг; откатил.
|
||||
@@ -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` позже (ключи вместо кодов).
|
||||
@@ -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 '—'}")
|
||||
@@ -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.
|
||||
Reference in new issue
Block a user