Files
buryan-infra/ops/services/cards/kavita.md
T

2.1 KiB
Raw Blame History

Kavita

Параметр Значение
CT 111 (media-stack), 192.168.1.240:5000
Домен https://kavita.buryans.ru
Вход Authentik OIDC (работает — akadmin вошёл 23.10)
Библиотека /library (Calibre-каталог CT111), тип «Книги»
Bootstrap локальный roman (аварийный ключ, /root/.services-admin-password)

SSO — что важно знать

  • redirect_uri: https://kavita.buryans.ru/signin-oidc
  • провайдер kavita в Authentik, grant_types = [authorization_code, refresh_token]
  • роли: rolesClaim=groups, rolesPrefix=kavita-
  • группы: kavita-Admin (akadmin), kavita-User, family

Создание библиотеки через API (ловушки)

  1. POST /api/Library/create — не /add и не /save.
  2. Обязательны все поля: name, type (2 = Book), folders, fileGroupTypes массивом чисел, excludePatterns, metadataProvider (валидно только 2).
  3. fileGroupTypes: 1 = архивы (cbz/cbr), 2 = epub, 3 = pdf. С [1] Kavita видит epub-файлы, но пишет «unable to parse», и серий — 0.
  4. Удаление: DELETE /api/Library/delete?libraryId=1 (не /api/Library/1).

Почему сейчас 0 серий (честно)

Файлы в /opt/books/library — заглушки по 1.6 КБ (13 epub). Kavita корректно отвечает «Unable to parse any meaningful information out of file». То есть проблема не в Kavita, а в том, что реальных книг в каталоге нет.

Роль akadmin

После входа через OIDC akadmin получил Pleb (не Admin): claim с группами не смапился в роль. Варианты:

  • выдать Admin вручную в интерфейсе Kavita (Пользователи → akadmin → роль);
  • либо донастроить rolesClaim (в токене должен быть claim groups со значением kavita-Admin).