Auto-sync: 2026-10-19
This commit is contained in:
@@ -0,0 +1,56 @@
|
||||
---
|
||||
title: Jellyfin Media Server
|
||||
category: systems
|
||||
tags: [jellyfin, media, kubernetes, vaapi, swiftfin]
|
||||
created: "2026-10-19"
|
||||
modified: "2026-10-19"
|
||||
---
|
||||
|
||||
# Jellyfin (Media Server)
|
||||
|
||||
## Überblick
|
||||
Selbst gehosteter Medienserver für die Adult-Szenen-Bibliothek (Kink.com/Series + Erika Lust), Abspielziel AppleTV via **Swiftfin**.
|
||||
|
||||
| Fakultät | Wert |
|
||||
|---|---|
|
||||
| Version | `jellyfin/jellyfin:12.2` (Tag gepinnt, nie `latest`) |
|
||||
| Namespace | `sabnzbd` (Co-Lokation wegen RWO-Mount der sabnzbd-PVC) |
|
||||
| Node-Pin | `rke2-worker-05` (einziger iGPU-Node, `/dev/dri/renderD128`, GID 991, `privileged: true`) |
|
||||
| VIP | **10.0.30.209:8096** (Cilium LB-IPAM, Annotation `io.cilium/lb-ipam-ips`) |
|
||||
| Config-PVC | `jellyfin-config` 5Gi RWO ceph-hdd-replica |
|
||||
| Media-Mount | sabnzbd-PVC **read-only** auf `/media` (= `/config/downloads/media` im SABnzbd-Pod) |
|
||||
| Manifeste | `iac-homelab/clusters/main/jellyfin/` + App `clusters/main/apps/jellyfin.yaml` |
|
||||
| NetworkPolicy | CNP `jellyfin-lan-only` (world/host/remote-node auf 8096 — VIP-Ingress kommt durch SNAT als `world` an, s. Cilium-Traps) |
|
||||
| Admin-Login | 1P-Item **„Jellyfin Login dominik"** (Vault Kubernetes ESO), User `dominik`, IsAdministrator |
|
||||
|
||||
## Bibliothek
|
||||
- Library **„Mediathek"** (`collectionType=homevideos`), Pfad `/media`, 6 Serienordner als Folder: DeviceBondage (8), DungeonSex (26), ErikaLust (5), SexAndSubmission (36), TheTrainingOfO (6), TheUpperFloor (25) — **106 Videos, verifiziert 19.10.**.
|
||||
- **Kollaps-Falle**: Movies-Typ fasst mehrere Dateien pro Ordner zu 1 Film + unsichtbaren Extras zusammen. Szenen-Bibliotheken besser als `homevideos` oder untypisiert anlegen (zeigen jede Datei einzeln; NFO-Parsing identisch).
|
||||
- **Zombie-Items-Falle**: Alte Movie-Items auf gleichen Pfaden überleben Library-Delete+Recreate in `jellyfin.db` (pfadbasiertes Keying) und lassen jeden Scan leer laufen („Validating" ohne Enumeration). Heilung: Full-DB-Reset — ArgoCD selfHeal aus, scale 0, `mv /config/data/jellyfin.db* /config/dbbackup-<datum>/`, Wizard-Flag reset, Neu-Bootstrap. Backup: `/config/dbbackup-20261019/` auf jellyfin-config-PVC.
|
||||
- NFOs (Kodi-Stil, vom SABnzbd-Sorter generiert) werden gelesen: Title/Plot/Genre/Studio/Actors/Year verifiziert.
|
||||
- Scheduled Tasks „Extract Chapter Images" + „Generate Trickplay Images" + „Migrate Trickplay" haben **leere Trigger** (RO-Media-Mount darf nie beschrieben werden).
|
||||
|
||||
## API-Fallen (12.2) — Details: Solution Doc s.u.
|
||||
1. Auth-Header heißt jetzt **`Authorization: MediaBrowser ...`** (nicht mehr `X-Emby-Authorization` → sonst 400 ArgumentNullException).
|
||||
2. `/Startup/User` nimmt `{"Name","Password"}` — Feld `Username` → täuschende 404. **Route funktioniert anonym NUR OHNE Authorization-Header** (mit MediaBrowser-Header trotz korrektem Payload ebenfalls 404!). Vorsicht: Probe-POSTs legen echte Admin-User an; Route acceptiert nur EINEN Startup-User (danach 403). `GET /Startup/User` = DTO-Sonde (zeigt Seed-User `root`).
|
||||
3. Bootstrap-Reihenfolge: Configuration → Startup/User → **erst dann** `/Startup/Complete` (sonst Lockout; Recovery via `system.xml` `IsStartupWizardCompleted=false` + Pod-Restart).
|
||||
4. Tasks: Trigger-Update `POST /ScheduledTasks/{id}/Triggers`, Ausführen `POST /ScheduledTasks/Running/{id}` (PUT/alte Route → 405; `OPTIONS` zeigt Allow).
|
||||
5. Null-Users-Boot seedet automatisch User `root` ohne Passwort (Login trotzdem 401 — ignorierbar).
|
||||
|
||||
## Swiftfin / AppleTV
|
||||
- **UDP-Autodiscovery funktioniert durch den K8s-VIP nicht** → im Client Server MANUELL eintragen: `http://10.0.30.209:8096`, User `dominik`.
|
||||
- Transcode: VAAPI auf worker-05 verfügbar (Hardware-Encoder vorhanden, Jellyfin-Transcodierung ungetestet 19.10.).
|
||||
|
||||
## Betrieb
|
||||
- Scan anstoßen: `POST /ScheduledTasks/Running/<scan-id>` (Task-Id via `GET /ScheduledTasks`, Name „Scan Media Library").
|
||||
- Neue Medien landen automatisch via SABnzbd-Sorter in `/media/<Serie>/` (Postproc-Skript, CM `sabnzbd-postproc-script`).
|
||||
- Bekannte Data-Hygiene-Aufgabe (19.10.): Alt-Salvage-MKVs (~600 MB 720p) liegen neben frischen 1080p/4K-MP4s derselben Szene (8 Paare in DeviceBondage, ~5 GB); Löschung nur nach GO.
|
||||
|
||||
## Related Solution Docs
|
||||
- `docs/solutions/integrations/2026-10-19-jellyfin-12-bootstrap-api-breaking-changes.md`
|
||||
- `docs/solutions/bug-fixes/2026-10-19-cilium-networkpolicy-four-traps.md`
|
||||
|
||||
## Verwandte Wiki-Seiten
|
||||
- [[systems/sabnzbd]] — Downloader, Sorter, Media-PVC-Owner
|
||||
- [[systems/rke2-kubernetes]] — Cluster, LB-IPAM
|
||||
- [[reference/ip-map]]
|
||||
+2
-2
@@ -9,10 +9,10 @@ modified: "2026-10-19"
|
||||
# SABnzbd Usenet Downloader + VAAPI AppleTV-Converter
|
||||
|
||||
## Überblick
|
||||
SABnzbd 5.1.3 (LinuxServer-Image) im Namespace `sabnzbd` auf RKE2, gepinnt auf **rke2-worker-05** (einziger GPU-Node). Web/API `http://10.0.30.206:8080`, SMB `\\10.0.30.206\downloads` (Sidecar alpine:3.20, fruit/streams_xattr). PVC `sabnzbd-config` 500 Gi (Ceph-RBD, online-resized), Mount `/config`. IaC: `iac-homelab/clusters/main/sabnzbd/` (ArgoCD-App `sabnzbd`).
|
||||
SABnzbd 5.1.3 (LinuxServer-Image) im Namespace `sabnzbd` auf RKE2, gepinnt auf **rke2-worker-05** (einziger GPU-Node). Web/API `http://10.0.30.206:8080`, SMB `\\10.0.30.206\downloads` (Sidecar alpine:3.20, fruit/streams_xattr). PVC `sabnzbd-config` **1 Ti** (Ceph-RBD `hdd_disk`, online-resized 500Gi→1Ti am 19.10.; FS-Resize braucht Pod-Restart — `FileSystemResizePending` bis Remount), Mount `/config`. IaC: `iac-homelab/clusters/main/sabnzbd/` (ArgoCD-App `sabnzbd`).
|
||||
|
||||
## Container
|
||||
- **sabnzbd** (LSIO, PUID 1000): Download-Engine, Postproc-Script `convert720.sh` (Name historisch, Funktion jetzt enqueue-only)
|
||||
- **sabnzbd** (LSIO, PUID 1000): Download-Engine, Postproc-Script `convert720.sh` (Name historisch; seit v8 = **Sorter**: sortiert Masters direkt in `media/<Serie>/` + NFO; 720p/1080p-Resolution-Gate, 480p/4K → Quarantäne; Mappings zusätzlich Deeper/AnalVids/BFTP18)
|
||||
- **converter** (Sidecar, `linuxserver/ffmpeg:latest`, **privileged**): Daemon `converter-daemon.sh`, pollt `/config/convert-queue/*.job` alle 20 s
|
||||
- **samba** (Sidecar): SMB-Share `downloads`
|
||||
- Init: seed-config (ersetzt fetch-ffmpeg, seit v4-Tag obsolete)
|
||||
|
||||
+11
-5
@@ -60,10 +60,16 @@ den 5 Owner-Profilen.
|
||||
- Offsite: folgt dem regulären `push-offsite` Sync-Job (Pull↔Push-Korrektur
|
||||
vom 19.09.).
|
||||
|
||||
## Modell / Provider (Stand 2026-10-02)
|
||||
## Modell / Provider (Stand 2026-10-19)
|
||||
|
||||
- **Default-Modell:** `vllm/qsu/deepseek-v41-flash` (gewechselt von `vllm/release/glm-5-2`)
|
||||
- Grund: `release/glm-5-2` hing upstream (siehe Pitfall 4)
|
||||
- **Default-Modell:** `vllm/release/glm-5-3` (gewechselt von glm-5-2 am
|
||||
19.10.; Zwischenstand deepseek-v41-flash). E2E verifiziert: Neuer Turn
|
||||
über WebUI-API antwortet („PONG"), Session zeigt `model: vllm/release/glm-5-3`.
|
||||
- glm-5-3 ist ein Reasoning-Modell (liefert `reasoning`-Felder).
|
||||
- **Compaction/Compression:** `auxiliary.compression` = provider `auto`,
|
||||
kein explizites Model → fällt aufs Haupt-Modell zurück (= glm-5-3).
|
||||
- **Vision:** `auxiliary.vision` = noris / `vllm/release/gemma-4-31b-it`;
|
||||
403-Block ist weg (19.10. mit Sarahs Key getestet: HTTP 200).
|
||||
- **`fallback_providers: []`** — kein Fallback konfiguriert! Bei Modellausfall hängt
|
||||
jeder Turn bis `timeout: 120` + 3 Retries. Kandidat für Redundanz-Fix.
|
||||
- Key-Scope VM107 (`sk-bf-8779…a6a7`): funktioniert mit `qsu/deepseek-v41-flash`,
|
||||
@@ -91,8 +97,8 @@ den 5 Owner-Profilen.
|
||||
**Diagnose-Rezept:** identischer Key, identischer Host, Modell-Matrix
|
||||
gegentesten (nur so trennt man Modell- von Infra-Defekt).
|
||||
Fix: Default auf `vllm/qsu/deepseek-v41-flash`. Verifiziert E2E (Turn 15s, PONG).
|
||||
5. **Vision-Modell 403:** `auxiliary.vision.model = vllm/release/gemma-4-31b-it`
|
||||
→ `model_blocked` für diesen Key. Offen.
|
||||
5. ~~**Vision-Modell 403:**~~ **Behoben/veraltet (19.10.):** `vllm/release/gemma-4-31b-it`
|
||||
liefert mit Sarahs Key jetzt HTTP 200.
|
||||
6. **Secrets im Unit-File:** `/etc/systemd/system/hermes-webui.service` ist
|
||||
`0644 root:root` und enthält `HERMES_WEBUI_PASSWORD` + `HERMES_CUSTOM_NORIS_API_KEY`
|
||||
im Klartext → für jeden lokalen User lesbar. Sollte in `.env` mit `0400`.
|
||||
|
||||
Reference in New Issue
Block a user