7.4 KiB
title, category, tags, created, modified
| title | category | tags | created | modified | |||||
|---|---|---|---|---|---|---|---|---|---|
| Jellyfin Media Server | systems |
|
2026-10-19 | 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. Stand 29.10.2026: 215 Videos, 215 NFOs in 25 Serienordnern (Jellyfin 1:1 = 215 Items, Scan verifiziert) (PureTaboo 42, Deeper 45, KinkUniversity 1, SexAndSubmission 26, TheUpperFloor 18, BratTamer 16, DeviceBondage 13, DungeonSex 13, HogTied 8, TheTrainingOfO 6, ErikaLust 5, He's in Charge 4, Lustery 3, BFTP18/NerdPervert/KinkTestShoots 2, AnalVids/BellesaFilms/BoundGangBangs/BukkakeFest/EnjoyX/GlowingDesire/MajorHotWife/SilkSub/TheLifeErotic 1). - Kollaps-Falle: Movies-Typ fasst mehrere Dateien pro Ordner zu 1 Film + unsichtbaren Extras zusammen. Szenen-Bibliotheken besser als
homevideosoder 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. - „Other"-Ordner-Falle (29.10.2026): Ein Medien-Unterordner namens
Otherlässt den Library-Scan dauerhaft bei 84 % hängen — Endlosschleife im .NET-Prozess (PID 1 verbrennt CPU, kein ffmpeg/ffprobe-Subprozess), Item-Zahl bleibt konstant, DB-Zeile bleibt Stub (RunTimeTicks=null,DateLastSaved=null). Beweisführung: derselbe bekanntermaßen gute Canary-Film hängt inOther, wird aber in einem anders benannten Ordner (Solo) sofort indexiert → Ordnername, nicht Dateicontent. Weder Re-Encode des Videos noch Löschen der DB-Zeile hilft. Fix: Ordner umbenennen/auflösen; Strays in einen bestehenden Serienordner legen. Diagnose-Trick: Task-StateRunning+CurrentProgressPercentageeingefroren,videos=<konstant>. - NFOs (Kodi-Stil, vom SABnzbd-Sorter generiert) werden gelesen: Title/Plot/Genre/Studio/Actors/Year verifiziert. NFO-Pflicht: jedes Video hat ein gleichnamiges
.nfo(Stichprobe 215/215 am 29.10.). - 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.
- Auth-Header heißt jetzt
Authorization: MediaBrowser ...(nicht mehrX-Emby-Authorization→ sonst 400 ArgumentNullException). /Startup/Usernimmt{"Name","Password"}— FeldUsername→ 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-Userroot).- Bootstrap-Reihenfolge: Configuration → Startup/User → erst dann
/Startup/Complete(sonst Lockout; Recovery viasystem.xmlIsStartupWizardCompleted=false+ Pod-Restart). - Tasks: Trigger-Update
POST /ScheduledTasks/{id}/Triggers, AusführenPOST /ScheduledTasks/Running/{id}(PUT/alte Route → 405;OPTIONSzeigt Allow). - Null-Users-Boot seedet automatisch User
rootohne 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, Userdominik. - 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 viaGET /ScheduledTasks, Name „Scan Media Library"). - Neue Medien landen automatisch via SABnzbd-Sorter in
/media/<Serie>/(Postproc-Skript, CMsabnzbd-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.
Stale MediaStreams nach In-Place-Ersetzung (30.10.2026)
Wird eine Mediendatei unter gleichem Pfad ersetzt (Transcode/Remux), behält Jellyfin den alten DB-Stand: es meldet weiter den alten Codec und die alte Dateigröße. Der Client bekommt dann DirectPlay mit falschem Codec angeboten und bricht ab (real: Datei war hevc, DB sagte h264 High 4.418 GB → QuickTime verweigerte).
Fix: genau ein POST /Library/Refresh (HTTP 204), Scan läuft async; danach stimmen Size und MediaStreams (hevc Main 1920×1080 ~2.4 Mbit). Verifikation über GET /Items?...&Fields=Path,MediaSources,MediaStreams.
Regel: Nach jeder In-Place-Ersetzungswelle ein Refresh — nicht mehrere parallel (wiederholte POSTs brechen den laufenden Scan ab). Wiederholte Refreshes während eines laufenden Batch sind unbedenklich, weil die Ersetzung atomar per mv passiert.
archive.org als Torrent-freie Zweitquelle (31.10.2026)
Usenet liefert keine Shibari-/BDSM-Tutorials (nzbindex null; Alternativ-Indizes JS-Walls), TPB nur per Torrent (Veto). archive.org Advanced Search (advancedsearch.php?q=…&output=json) + Metadata-API (/metadata/<id>) + Direktdownload (/download/<id>/<file>) lieferten 28 Tutorial-Videos (2,73 GB): BDSM-Skills-Serie, BDSM 101, Mistress Clarissa's Bondage 101 u. a. — alle h264-MP4, AppleTV-Direct-Play.
- Ablage:
/media/Tutorials/(eigener Ordner, 28 Items — kein generischer Sammelordner). - Throttle-Falle: archive.org drosselt pro Verbindung auf ~130 KB/s; sequenziell unbrauchbar. Lösung: Range-Chunking (4-MB-Chunks, 32 parallel/Datei, 3 Dateien gleichzeitig) → 1,4 GB in ~8 min.
- Integration: tar-Stream via
kubectl exec -iin die PVC,chown 1000:1000, einPOST /Library/Refresh, Item-Delta +28 verifiziert..hevc_*-Temps im FS zählen nicht (Jellyfin ignoriert sie absichtlich). - Details:
docs/solutions/integrations/2026-10-31-archive-org-tutorial-harvest.md
Related Solution Docs
docs/solutions/integrations/2026-10-19-jellyfin-12-bootstrap-api-breaking-changes.mddocs/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