35 lines
1.7 KiB
Markdown
35 lines
1.7 KiB
Markdown
# homebox
|
|
|
|
| Параметр | Значение |
|
|
|---|---|
|
|
| Группа | Дом |
|
|
| Критичность | normal |
|
|
| CT | 110 (lifestyle-lxc) |
|
|
| Образ | `ghcr.io/sysadminsmedia/homebox:latest` |
|
|
| Порт | 9287 |
|
|
| Домен | homebox.buryans.ru — **нужна DNS-запись** |
|
|
| SSO | OIDC через Authentik (провайдер `Homebox`) |
|
|
| Бэкап | `/opt/lifestyle-lxc/homebox/data` → `ct/homebox.tgz` |
|
|
| Если упадёт | Пропадёт инвентарь вещей и гарантий |
|
|
|
|
## Доступ
|
|
|
|
- LAN: `http://192.168.1.110:9287` → «Войти через OIDC»
|
|
- Публично: после A-записи `homebox.buryans.ru → 193.233.210.184`
|
|
|
|
## Ловушки
|
|
|
|
-1. **Homebox формирует `redirect_uri` со схемой `http`**, даже когда доступ
|
|
идёт по https (прокси не влияет). Поэтому в провайдере Authentik
|
|
зарегистрированы оба варианта: `http://` и `https://`.
|
|
Иначе — «Ошибка URI перенаправления».
|
|
|
|
0. **Нужен первый пользователь**: в базе было 0 пользователей, а регистрация
|
|
была закрыта — OIDC-вход не мог создать учётку. Открыли регистрацию
|
|
(`HBOX_OPTIONS_ALLOW_REGISTRATION=true`); после создания владельца
|
|
регистрацию надо снова закрыть.
|
|
|
|
1. Без `HBOX_AUTH_API_KEY_PEPPER` (32+ байт) контейнер падает с panic.
|
|
2. OIDC-callback — `/api/v1/users/login/oidc/callback`.
|
|
3. Pepper хранится в `/root/.homebox-pepper`; менять нельзя — сломает API-ключи.
|