62 lines
4.1 KiB
Markdown
62 lines
4.1 KiB
Markdown
---
|
||
title: SABnzbd Usenet Downloader + VAAPI AppleTV-Converter
|
||
category: systems
|
||
tags: [sabnzbd, usenet, k8s, vaapi, ffmpeg, appletv, smb, argocd-gitops]
|
||
created: "2026-10-19"
|
||
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`).
|
||
|
||
## Container
|
||
- **sabnzbd** (LSIO, PUID 1000): Download-Engine, Postproc-Script `convert720.sh` (Name historisch, Funktion jetzt enqueue-only)
|
||
- **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)
|
||
|
||
## VAAPI / GPU-Encoding
|
||
- Nur **worker-05** (10.0.30.65) besitzt `/dev/dri/renderD128` (AMD Granite Ridge, render-GID **991**) — worker-04 hat KEINEN render-Node → Pin zwingend
|
||
- VAAPI in Pods erfordert `privileged: true` (Devices-Cgroup blockt hostPath-Device-Nodes sonst)
|
||
- Encoder: h264_vaapi/hevc_vaapi, **5.7× schneller** als libx264 (Benchmark 1080p→720p: 4.3 s vs 24.7 s)
|
||
- CPU-Fallback eingebaut (falls renderD128 fehlt)
|
||
|
||
## Converter-Pipeline (Design)
|
||
1. Postproc (Enqueuer) schreibt Job-File `<ts>-<safe>.job` (Zeile 1: Quelldatei) nach `/config/convert-queue/`, dedupliziert gegen bestehende Jobs (Multi-Release-NZBs rescannen den ganzen Ordner!)
|
||
2. Daemon nimmt ältesten Job, Guards in dieser Reihenfolge:
|
||
- **Partials-Discard** (`.converting.*`) — VOR dem Park-Case (v4-Lesson: case-Order!)
|
||
- **Park-Case** `*/incomplete/*`: nur solange Quelle dort EXISTIERT (`[ -f ]`, v6-Lesson), sonst Durchfallen zum Resolver; Retry-Cap 2160 × 20 s ≈ 12 h
|
||
- **Resolver**: Quelle nach SAB-Move in `complete/` neu suchen
|
||
- **Skip-Guard**: Ziel-MP4 existiert und ist AppleTV-ok (MP4+h264+≤720p+AAC) → überspringen. ⚠️ ffprobe `-of csv=p=0` QUOTET Komma-Werte — Quotes strippen (v5-Lesson)!
|
||
- Encode: VAAPI h264 → 720p, Audio → AAC 192k, `-movflags +faststart`, Temp `.converting.mp4`, Rename bei Erfolg
|
||
3. Ausgabe neben Quelle in `complete/`; **Originale werden nie gelöscht** (House-Rule)
|
||
|
||
## Betrieb & Verifikation
|
||
```bash
|
||
kubectl -n sabnzbd logs deploy/sabnzbd -c converter --tail=50 # Daemon-Log
|
||
kubectl -n sabnzbd exec deploy/sabnzbd -c converter -- ls /config/convert-queue/ | wc -l
|
||
ffprobe -v error -select_streams v:0 -show_entries stream=codec_name,height \
|
||
-of default=nokey=1:noprint_wrappers=1 <mp4> # AppleTV-Check (unquoted!)
|
||
```
|
||
|
||
## Rollout-Rezept (Skript-Änderung)
|
||
1. Skript in `configmap.yaml` patchen + `sabnzbd/converter-script-version: "N+1"` im Deployment bumpen (bash liest Skript nur beim Start)
|
||
2. Commit + Push (Gitea) → `kubectl -n sabnzbd delete cm sabnzbd-postproc-script sabnzbd-converter-script` (ArgoCD-SSA-Hot-Update-Limitierung)
|
||
3. `kubectl annotate application sabnzbd -n argocd argocd.argoproj.io/refresh=normal --overwrite` → neuer Pod, Daemon startet mit neuem Skript
|
||
|
||
## Netzwerk / Sicherheit
|
||
- CNP `sabnzbd-lan-only`: Ingress von world/host/remote-node (SNAT macht VIP-Clients zu `world`), Port 8080+445; Egress nur DNS + NNTP (443/563/119/80)
|
||
- API key-protected; Web-UI ohne Login wegen SNAT-Privatranges (Empfehlung `local_ranges` offen)
|
||
- Privileged Converter = bewusstes Trade-off für VAAPI (dokumentiert)
|
||
|
||
## Bekannte Issues / Offene Punkte
|
||
- **Usenet.Farm Block leer** (482, 10-GB-Trial verbraucht); aktiv: PureUsenet Trial (7 Tage unbegrenzt)
|
||
- Multi-Release-NZB: SAB verschiebt erst nach Fertigstellung ALLER Sets → 12-h-Park-Puffer ist by design
|
||
- Originale behalten bis Freigabe (Delete-Rule: niemals ohne explizites GO)
|
||
- theupperfloor-History-Anomalie unaufgeklärt (par2 ok, trotzdem FAILED)
|
||
|
||
## Related Solution Docs
|
||
- `~/docs/solutions/bug-fixes/2026-10-19-sabnzbd-vaapi-converter-guard-bugs.md` (ffprobe-Quoting, case-Order, Stale-Parking)
|