⚡ nzbfast

Den hurtige Usenet-downloader - brugermanual

1 · Velkommen

nzbfast henter fra Usenet så hurtigt, som din linje, dine udbydere og din maskine tillader - og som regel betyder det så hurtigt som din linje. Det er ét enkelt selvstændigt program: motoren, et web-dashboard, en postervægs-mediebrowser, en indbygget indexer, realtids-forhåndsvisning, native PAR2-reparation og native RAR-udpakning er alle inde i én eksekverbar fil. Der er ikke andet at installere.

Det, der gør den hurtig, er arkitektur, ikke finjusteringer:

• Pipelinet NNTP - mange artikelforespørgsler rider på hver forbindelse ryg mod ryg og holder hver forbindelse på fuld hastighed i stedet for at vente rundrejser af.
• En one-pass-pipeline - download, verificering og udpakning overlapper. Arkivvolumener udpakkes i strømmen; på en typisk store-mode-post rører RAR-filerne aldrig din disk, så jobbet kræver 1× release-størrelsen, ikke 2×, og bliver færdigt, når downloaden bliver færdig.
• Union på tværs af udbydere - hver konfigureret server bidrager; en artikel, der mangler på én backbone, hentes fra en anden. Langsomme eller døde servere sætter aldrig køen i stå.
• Et hukommelsesbudget - motoren tilpasser sig en begrænset RAM-tildeling og degraderer til disk om nødvendigt. Den swapper aldrig din maskine.

Målt mod feltet på identisk hardware, samme jobs og udbydere har nzbfast fuldført en 190 GB-download på omkring 5 minutter på en 10 GbE-linje - med de førende alternativer 30–220% bagefter på de samme tests, dér hvor de overhovedet fuldførte dem. Tallene står i §3.

2 · Kom hurtigt i gang

macOS

1. Åbn nzbfast-<version>-macos.dmg og træk NzbFast ind i Programmer (universal: Apple Silicon + Intel).
2. Første start: macOS advarer om, at nzbfast endnu ikke er Apple-notariseret. Højreklik på appen → Åbn - eller åbn Systemindstillinger → Anonymitet & sikkerhed, rul ned, og klik Åbn alligevel. Dette er et engangstrin.
3. App-vinduet viser dashboardet med et velkomstkort - klik på det og tilføj mindst én Usenet-server (host, port 563, brugernavn, adgangskode). Du kan tilføje flere senere under Indstillinger.
4. Slip en .nzb hvor som helst på dashboardet - eller dobbeltklik bare på .nzb-filer i Finder. Downloads lander i ~/Downloads/nzbfast. Afslut fra menuen; downloads genoptager, hvor de slap.

Vil du hellere undvære app'en? Den almindelige zip (binær + Start nzbfast.command-starter, samme motor) virker stadig som før - trin nedenfor under "Fra en terminal".

Windows

1. Kør nzbfast-<version>-windows-x64-setup.exe. Den installeres kun for din bruger (ingen administratoradgangskode). Da denne udgivelse endnu ikke er kodesigneret, viser SmartScreen måske "Windows beskyttede din pc" - klik Flere oplysninger → Kør alligevel.
2. nzbfast bor i systembakken: dobbeltklik på bakke-ikonet (eller brug Åbn dashboard i dets højrekliksmenu) for at åbne dashboardet, og tilføj så din Usenet-server fra velkomstkortet. Bakke-menuen har også Pause/Genoptag, din downloadmappe og Afslut.
3. At dobbeltklikke på en .nzb-fil sætter den i kø. Windows Defender spørger måske én gang om at tillade lytning på det lokale netværk - tillad det.

Vil du hellere have en bærbar kopi? -windows-x64.zip virker stadig: pak ud hvor som helst og dobbeltklik på nzbfast.exe (eller Start nzbfast.bat) for terminal-guiden.

Fra en terminal (enhver platform)

nzbfast setup            # interactive server setup (writes config.local.json)
nzbfast serve --open     # start the daemon and open the dashboard

Velkomstkortet spørger også, hvordan du har tænkt dig at bruge nzbfast, med fire svar: en app som Sonarr eller Radarr styrer den, skifter fra SABnzbd, skifter fra NZBGet, eller bare dig, fra dette dashboard. At vælge et ændrer ingenting i sig selv. Det viser en kort gennemgangsliste - hver anbefaling med indstillingens eget navn, dens nuværende værdi, den anbefalede værdi og én linje om hvorfor - og Anvend sætter kun de rækker, du sætter flueben ved. Hver række er en almindelig indstilling, du bagefter kan ændre tilbage for sig selv, og den samme liste er senere stadig tilgængelig under Indstillinger → Anbefalede indstillinger til den måde, du bruger den på.

Din API-nøgle

På en helt ny installation laver nzbfast selv en API-nøgle, første gang daemonen starter, og skriver den ud én gang i et banner lige under dashboardets adresse. Fra da af kræver hver forespørgsel den nøgle, så dashboardet og API'et ikke står åbne for alt, hvad der kan nå maskinen.

Hvad du skal gøre med den, afhænger af, hvordan du startede nzbfast:

• macOS-appen, Windows-bakken eller serve --open: ingenting. De giver nøglen videre til det browservindue, de åbner, dashboardet husker den, og du er allerede logget ind.
• En browser, du selv har åbnet, eller dashboardet på en telefon eller en anden computer: siden spørger om nøglen én gang og husker den derefter.
• Sonarr, Radarr, nzb360 og lignende: indsæt den som deres SABnzbd- eller NZBGet-nøgle (§11, §12).

Nøglen gemmes i en fil ved navn apikey ved siden af din konfigurationsfil, så den er den samme på tværs af genstarter, og du kan læse den igen, når du har brug for det. På macOS og Linux kan den fil kun læses af den konto, der kører nzbfast. Den står også i daemonens egen udskrift, så dashboardets Log-kort har den, hvis terminalen er rullet væk.

Vil du hellere bruge din egen nøgle, skriver du den ind under Indstillinger → Sikkerhed; den træder i kraft med det samme. Det panel ændrer nøglen, men viser aldrig den nuværende, så læs filen apikey, hvis du har brug for den genererede værdi igen. Vil du køre helt uden nøgle, fordi noget foran nzbfast allerede håndterer login, så start den med NZBFAST_OPEN=1 i miljøet. nzbfast forbliver så åben og siger det ligeud ved opstart.

Hvilke maskiner der overhovedet kan nå daemonen, er et separat valg: serve --bind. Standarden er 0.0.0.0, altså hver eneste netværksgrænseflade, fordi en NAS-boks, en telefon og en Sonarr på en anden computer alle skal kunne forbinde. --bind 127.0.0.1 indsnævrer det til den maskine, nzbfast kører på, hvilket er det, du vil have på en enkelt stationær computer, hvor intet andet har brug for adgang.

3 · Sådan virker nzbfast

En hurtig ordliste, så resten af manualen er let at læse:

Pipelinen kører download → afkod → verificér → udpak samtidig. Pipeline-kortet på dashboardet viser alle tre baner bevæge sig på én gang. Når den sidste byte ankommer, er verificeringen allerede færdig, og filen er allerede udpakket; et typisk jobs "efterbehandlings"-tid er nul. Er reparation nødvendig, materialiseres volumenerne først da til disk, repareres på stedet af den native GF(2¹⁶)-motor (omdøbte eller byte-forskudte obfuskerede data findes og adopteres af en glidende blokscanning) og udpakkes igen - alt automatisk.

Afbrudte downloads (crash, strømsvigt, kill -9) genoptager fra artikel-journalen: bytes, der allerede ligger på disken, hentes aldrig to gange. Journalen registrerer, hvor hver artikels bytes fysisk landede - selv bytes, der blev direkte-udpakket ind i den endelige fil - så en genoptagelse genopbygger fra lokal disk og genverificerer alt, den gendannede, mod PAR2-blok-mappet, før den stoler på det.

Sådan står det til sammenligning

Målt mod SABnzbd 5.0.4 og NZBGet 26.2 på samme maskine, samme udbydere og samme NZB'er, taget tid til en brugbar fil - download, verificering, reparation og udpakning alt inkluderet, for det er, når jobbet reelt er færdigt:

Forskellen er den efterbehandling, de andre stadig skal lave, efter den sidste byte lander. Begge konkurrenter blev tunet til sammenligningen, ikke efterladt på standardindstillinger - SABnzbd leveres i særdeleshed med anmodnings-pipelining slået fra, hvilket koster den dyrt, så den blev slået til.

To forskelle betyder lige så meget som tiderne:

• Diskplads. One-pass kræver 1× release-størrelsen; klienter, der skriver arkivvolumener og så pakker dem ud, kræver 2×. På en testmaskine med 97 GB fri blev et 87 GB-job færdigt her på 3 m 08 s, og de to andre kunne slet ikke køre.
• Hukommelse. På 190 GB-jobbet var topforbruget 3.9 GB mod SABnzbds 9.3 GB - og nzbfast klarer samme job på cirka 1 GB, hvis den får besked på det (se Hukommelsesbudget).

4 · Dashboardet

Åbn http://localhost:6789 (eller din maskines adresse fra en anden enhed - telefonlayoutet tilpasser sig automatisk). Alt opdateres live, én gang i sekundet. Kortene, oppefra og ned:

Header-bjælken

• Hastighedsgrænse-menu - faste lofter, auto · giv plads til LAN (en RTT-styret tilstand, der trækker sig, når en anden i huset har brug for linjen) eller ubegrænset.
• Pause i… - sæt alt på pause i 15 min/30 min/1 t/3 t med automatisk genoptagelse, eller brug Pause-knappen for en tidsubestemt pause. Pause er øjeblikkelig: den aktive overførsel stopper inden for få sekunder og genoptager senere fra journalen uden at miste noget. (Job med Tving-prioritet henter videre, SABnzbd-stil.)
• Et opdateringsbanner dukker op her, når en ny version er tilgængelig (se Opdateringer).

Gennemløb

Live MB/s med et rullende diagram; de stiplede vandmærker markerer denne sessions høj/lav, den svage linje er et glidende gennemsnit. Nedenunder viser et histogram, hvordan sessionens hastighedsmålinger fordeler sig - typisk vs. top. Gør vinduet bredere, og diagrammerne viser mere historik (op til en time).

Statistik-fliser

Hentet i denne session, kødybde, antal fuldført/mislykket, sessionens tophastighed.

Ressourcer - én maskine, fire lofter

CPU, RAM (mod nzbfasts hukommelsesbudget), diskskrivningshastighed og netværk på ét normaliseret diagram, med rigtige værdier i signaturforklaringen og en advarsel ved lav disk. Ingen anden NZB-klient viser dig dette; det findes for at bevise en pointe - nzbfast maksimerer din linje, ikke din maskine.

Pipeline - faser overlapper

Tre baner: download, verificér (PAR2-blokke tjekket), udpak. På et sundt job bevæger alle tre sig sammen.

Udbydere

Live-hastighed pr. server, forbindelsesudnyttelse, andel af trafikken, sessions-GB og en livstids-score for artikel-fuldførelse (farvet, når en server falder under 98%). Et stablet arealdiagram viser hver udbyders bidrag over tid. Rækker gensorteres efter live- ydelse hvert 10. s (kan konfigureres under Indstillinger → Grænseflade), så din hurtigste udbyder altid er øverst.

Kø

• Træk rækker for at ændre rækkefølge (inden for et prioritetsbånd - Tving/Høj kører stadig først); skift prioritet inline.
• Klik på en række for detaljeskuffen: fremgangsbjælker pr. fil, antal verificerings- blokke, hvilken server der bidrog med hvor meget til dette job, og en "tilføjet af"-linje, der fortæller, hvor jobbet kom fra (watch-mappen, en tilsluttet app, API'et…). Knappen Hent .nzb-filen gemmer jobbets .nzb-fil - nzbfast beholder sin egen kopi, så det virker for hvert job, selv når den originale fil for længst er væk.
• Mærker viser særlige tilstande: udskudt (langsom), prefetcher, på pause (se Ydelsesværktøjer).
• Et nedtællingsdiagram følger de samlede GB, der er tilbage i hele køen.

Gennemse indeks

Søg i alt, hvad den indbyggede indexer har katalogiseret fra dine overvågede grupper (se Automatisering) og hent med ét klik - ingen ekstern indexer nødvendig. Statuslinjen viser scanningsfremgang; Scan nu fremtvinger en gennemgang.

Overvågningsliste

Tilføj titler ved navn - også dem, der endnu ikke er postet. Når en matchende release dukker op i indekset, hentes den automatisk, med kvalitetspræferencer og opgraderingsregler (en bedre kopi erstatter en dårligere).

Kortet kan også følge en liste, du har i Plex. Tilføj en listekilde: forbind enten din Plex-konto (du godkender en kort kode på Plex' egen side, så ingen adgangskode nogensinde når nzbfast), eller indsæt adressen på din Plex-overvågningsliste. Behandl den adresse som en adgangskode - enhver, der har den, kan læse din liste - og derfor maskeres den, når den er gemt. Synkroniserede titler vises som skrivebeskyttede rækker ved siden af dine egne. En forbundet konto ser hele din liste, så fjerner du en titel dér, overvåges den heller ikke længere her (færdige downloads røres aldrig); en adresse viser kun de nyeste poster, så en manglende titel kan simpelthen være rullet ud, og intet fjernes. Begge adfærd kan slås om pr. kilde.

Historik

Seneste downloads, én række hver. Mislykkede jobs tilbyder Prøv igen (genoptager fra journalen). Krypterede arkiver viser en 🔑 lås-op-kontrol - indtast adgangskoden, og jobbet bliver færdigt på stedet. Verificerings-sundhedsstriben viser defekte PAR2- blokke pr. download - en stigende hale betyder, at artikler kommer beskadigede frem. Hver rækkes skuffe fortæller, hvem der tilføjede jobbet, og har den samme Hent .nzb-filen-knap som køen - praktisk til at hente en release igen et andet sted, eller til at vedhæfte dens .nzb til en fejlrapport.

Kortet viser ti downloads som standard, og resten er ét klik væk, på knappen ▤. Status, placering og årsagen til et fejlet job ligger bag et klik på selve rækken, så det almindelige tilfælde - hvad der blev færdigt, hvor stort, hvornår - forbliver læsbart uden at scrolle. Træk i kortets nederste kant for i stedet at lade listen scrolle i en højde, du selv vælger. History rows under Indstillinger → Grænseflade ændrer de ti; da det er en egenskab ved daemonen og ikke ved din browser, gælder det enhver enhed, der kigger på denne installation. Colour History names ved siden af farver færdige navne grønne og fejlede røde; slået fra forbliver navnene neutrale, og den farvede prik og rækkens egne detaljer siger stadig, hvad der er hvad.

Dataforbrug

Daglige bjælker pr. udbyder og totaler for I dag / 7 dage / 30 dage - uundværligt for målte og blok-konti. Blok-konti viser livstidsforbrug mod deres størrelse.

Log, System-benchmark, Forbindelsestuning, Server-diversitet

En logfremviser på siden og de tre selvmålingsværktøjer beskrevet i Ydelsesværktøjer.

Indret dashboardet

Dashboardet er dit at indrette. Fire handlinger, med samme navn hvor du end møder dem: Flyt et kort, gør det Kompakt, Skift størrelse på det eller Skjul det. Hvert valg husker den browser, du traf det i, så hver enhed beholder sin egen indretning, og Nulstil layout under Indstillinger → Grænseflade sætter hvert kort, hver størrelse og hver kolonne tilbage, som de blev leveret.

Tilpas layout er den guidede vej ind og den hurtigste måde at se, hvad et kort kan. Åbn det fra det diskrete link lige over det første kort eller fra Indstillinger → Grænseflade, hvor det er den første knap i rækken Dashboard-layout. Mens det er slået til, har hvert kort, der kan flyttes, en kant, de tre værktøjer i titelrækken tegnes i fuld styrke med deres ord ved siden af ikonet, og hver størrelseslinje tegnes i accentfarven; et kort uden linje siger hvorfor på sin egen linje i stedet for at lade dig lede efter en. Færdig eller Escape-tasten forlader det. Tilstanden er en måde at se siden på og ikke en indstilling: den ændrer ingenting ved din indretning, og efter en genindlæsning er den slået fra igen.

På et dashboard, ingen har indrettet endnu, siger en linje over kortene, at de kan flyttes, ændres i størrelse, gøres kompakte eller skjules, og peger på det link. Den vises én gang: Forstået lukker den, og det gør det også at åbne tilstanden eller at indrette noget som helst.

• Flyt. Træk et kort i dets titel. Hele overskriften er håndtaget, ikke kun det lille ikon til venstre for den, så der er ikke noget drilsk mål at ramme. Ikonet er desuden et tabulatorstop: giv det fokus, så flytter pilene op og ned kortet.
• Kompakt. Knappen ved siden af håndtaget strammer kortets afstande: samme tal, mindre plads. På Historik skifter den mellem de ti seneste downloads og resten af din historik. Kompakt tilstand under Indstillinger → Grænseflade gør hele dashboardet på én gang.
• Skift størrelse. Et kort med en liste eller et diagram bærer en linje langs sin underkant: træk den til den højde, du vil have. Linjen er svag, indtil du peger på kortet, hvor den tegnes som en hårfin streg i fuld bredde med riller i det bageste hjørne; den tager også tastaturfokus, hvor pilene op og ned sætter højden, og Skift tager et større skridt. Hvilke kort der har en, skifter, efterhånden som kort får og mister egne lister: tag linjen som svaret frem for nogen opremsning her. I Tilpas layout siger kortene uden linje det selv.
• Skjul. Den sidste knap i titelrækken skjuler kortet. Skjulte kort samles i en bjælke Skjult nederst på dashboardet; klik på et navn dér for at hente et tilbage.

Højreklik på et korts titel for de samme handlinger i én liste: Flyt op, Flyt ned, Kompakt, Skift størrelse og Skjul, plus en vej ind i Tilpas layout, når du ikke allerede er der. Skift størrelse tilbydes kun på et kort, der har en linje at trække i. Flyt op og Flyt ned bliver grå ved enderne, og de tæller kun de kort, du kan se: et skjult kort springes over, så første og sidste betyder første og sidste synlige.

Den menu er en tastaturvej lige så vel som en musevej. Tabulér hen til et korts flyttehåndtag, tryk på Kontekstmenu-tasten eller Skift+F10, og den åbner under overskriften. Pilene op og ned går gennem den og springer alt gråt over; Escape lukker den og giver fokus tilbage til håndtaget, du åbnede den fra. At vælge Skift størrelse giver fokus til kortets linje, hvor pilene op og ned sætter højden, og Skift tager et større skridt.

Escape lukker altid kun det øverste lag. At lukke kortmenuen, mens tilstanden er slået til, lader tilstanden blive; et andet Escape forlader tilstanden.

Dashboard-kort under Indstillinger → Grænseflade giver den samme indretning som en almindelig liste med kontroller: et felt Vis per kort, et felt Kompakt ved siden af og knapperne Flyt op og Flyt ned. På en telefon, en tablet eller ethvert smalt vindue er kortværktøjerne og trækket slået fra, for at trække et kort rundt på en side, der ruller under fingeren, er en dårlig kontrol: dér er det denne liste, der indretter dashboardet. Den skriver det, skrivebordet læser, så en rækkefølge, du sætter på telefonen, er den, skrivebordet viser. Dens knapper følger menuens regel: de bliver grå ved enderne af de synlige kort, og et kort, du har skjult, kan ikke flyttes, før du viser det igen.

Tabelkolonner ordnes på stedet og ikke fra noget af ovenstående. I tabellerne for køen, historikken og indekset trækker du en kolonneoverskrift sidelæns for at flytte kolonnen, eller dens bageste kant for at ændre bredden; et dobbeltklik på kanten stiller bredderne tilbage. Med en overskrift i fokus flytter venstre- og højrepilen den, og Skift med en pil ændrer bredden.

5 · Tilføj downloads

Kategorier, prioriteter, adgangskoder

• Kategorier er frie labels; hver bliver til en undermappe i din downloadmappe, og Smarte mapper (se §10) kan tildele dem efter regel.
• Prioriteter: Tving > Høj > Normal > Lav. Tving omgår pause og kvote.
• Adgangskoder til krypterede arkiver hentes automatisk fra <meta type="password"> inde i NZB'en, fra et filnavn Name{{password}}.nzb eller fra feltet p= i et nzblnk-link, og kan angives pr. job via API'et eller bagefter fra Historik (🔑).

Søg på dine indekser-konti

Har du en konto hos et NZB-indekserwebsted, kan nzbfast søge der herfra og sætte det, du vælger, i kø, i stedet for at du skal gå til webstedet, hente en NZB og bære den tilbage. Det taler det almindelige indekser-API, som alle de websteder tilbyder, så der er ikke noget at sætte op pr. websted: NZBGeek, NZBFinder, DrunkenSlug, DOGnzb og resten virker ens. En Prowlarr- eller NZBHydra2-instans er også kun én linje, og tager alle de indeksere, der ligger bag den, med sig.

Tilføj en konto. Indstillinger → Søg på indeksere → + Tilføj indekser. Udfyld et navn efter eget valg, webstedets API-adresse (dets almindelige webadresse er nok; en Prowlarr-linje ser ud som http://host:9696/1/api) og API-nøglen fra din kontoside der, og derefter Anvend indeksere. Test spørger webstedet, hvad det understøtter, og viser, hvad der kom tilbage, hvilket beviser adressen og nøglen med ét klik. En gemt nøgle vises aldrig igen: feltet siger det, og lader du det stå tomt, beholdes den nøgle, der allerede er der.

At søge. Åbn 🎬 væggen i overskriftslinjen, og skift til release-listen. Rullemenuen ved siden af søgefeltet afgør, hvor en søgning kigger: Dette indeks, altså det, denne maskine selv har skannet, Indeksere eller Begge. Dit valg huskes. At spørge dine konti kræver noget i feltet, for at blade i dem med en tom forespørgsel ville bruge et døgns tildeling på en liste, ingen bad om. Med den indbyggede indekser slået fra, hvilket er sådan nzbfast kommer, er der ingen plakater at vise, og siden er præcis dette: et søgefelt, dine konti og resultaterne.

Resultaterne. Én linje pr. release, de nyeste først, med størrelse, alder og hvor ofte den indeksers egne brugere har hentet den. En release, som flere af dine konti fører, optræder én gang. Under Begge vinder en kopi, dit eget indeks allerede har, og den udefra falder væk, for at hente det, du allerede har indekseret, koster dig ikke noget. Hent sætter den i kø med høj prioritet: nzbfast henter selv NZB'en, og derfra er jobbet som ethvert andet, med reparation, udpakning, kategorier og scripts uændret.

At spørge om én titel. Åbn en titels kort på væggen, og tryk på ⌕ Søg på mine indeksere. For film går spørgsmålet via IMDb-nummeret alle de steder, webstedet tager imod et, og det er forskellen på den film, du mente, og enhver release, hvis navn tilfældigvis indeholder de ord. nzbfast slår selv nummeret op, så siden har aldrig et. Websteder uden match på nummer bliver spurgt med ord i stedet.

Din tildeling. Indekser-konti tælles: så og så mange søgninger og så og så mange downloads om dagen, alt efter dit niveau. Skriv de to tal på linjen, så trækker nzbfast fra dem og begynder forfra ved midnat UTC. 0, standardværdien, betyder ubegrænset, og der tælles alligevel. En konto, der har brugt sin tildeling, sidder over, mens de andre arbejder, og en linje over resultaterne nævner den, der blev sprunget over: at løbe tør er aldrig tavst. Et websted, der svarer med en grænse af sin egen, eller beder os sætte farten ned, sættes til side i en time.

Hvor din nøgle havner. Kun hos den indekser, den hører til. Nøgler bliver på denne maskine, gives aldrig til browseren - hver resultatlinje bærer en billet, der gælder en halv time, i stedet for et link - og fjernes fra loggen og fra enhver fejl, webstedet sender tilbage, så en indsat fejlmeddelelse ikke kan lække en. En download kan kun hente et link, som en af dine egne søgninger gav.

Det er de samme konti, som et nzblnk-link falder tilbage på, når det lokale indeks ikke kender dets hoved, og dem, overvågningslisten kan spørge om det, du vil have (§10).

nzblnk-links

Nogle boards, mest tyske og hollandske, udgiver et nzblnk:-link i stedet for en NZB-fil. Indlægget er sløret, så der er slet ikke noget filnavn at linke til. Linket bærer i stedet et header, h=, som er en søgenøgle og ikke et sted, plus en valgfri titel t=, en adgangskode p= og en gruppe g=. Nogen skal først ud og finde indlægget.

nzbfast slår headeren op i sit eget indeks først, hvilket slet ikke kræver netværk, og kun hvis det ikke rammer, spørger den de søgeindeksere, du har sat op (Indstillinger → Søg på indeksere, §9), under de samme dagsbudgetter og den samme backoff som enhver anden søgning. Titlen bliver jobbets navn, og adgangskoden lægges automatisk på jobbet.

• Indsæt eller træk virker på enhver installation, Docker og NAS-kasser inklusive: kopiér linket fra boardet og indsæt det hvor som helst på dashboardet.
• At klikke på et link kræver, at skemaet er registreret hos dit skrivebord. Appen fra macOS-DMG'en registrerer det, og Windows-installationsprogrammet tilbyder det som en opgave: det spørger først og lader skemaet være, hvis NZB Monkey eller NZBDonkey allerede har det. Den rene macOS-tarball, Homebrew og Linux-installationerne har ingen skrivebordshåndtering, dér er indsætning vejen ind.
• Opslaget er hastighedsbegrænset med vilje. Et registreret skema ligger én browserdialog fra enhver side, du besøger, så links har et loft pr. minut, og kun de første få i et minut må nå dine indeksere; derefter besvares de alene ud fra det lokale indeks.

6 · Postervæggen

Klik på 🎬 væg i headeren. Væggen forvandler dit indeks til en medie- browser: hver genkendt film- og tv-release som en posterflise med bedømmelse, år, genrer, medvirkende og synopsis - dine newsgroups, til at gennemse som et katalog.

• Faneblade til Film / Serier / Andet, øjeblikkelig søgning og syv sorteringer: Til dig, Nyeste poster, Udgivelsesår, Bedst bedømt, Titel A–Z, Største og Mest postet.
• Kun matchede er slået til som standard og skjuler uidentificeret skrald; en "+N umatchede"- chip viser det.
• Klik på en flise for detaljearket: synopsis, IMDb-bedømmelse og stemmer, medvirkende - og ▶ Afspil (forhåndsvis den med det samme, se §7) eller ⬇ Download.
• ✎ Ret match - hvis en titel matchede den forkerte serie eller film, vælg den rigtige blandt kandidatposterne, eller indtast titel/år/type manuelt. Manuel tekst overskrives aldrig af berigelsen. ↻ Genopfrisk metadata henter én titel igen; Indstillinger → Indeksering kan genopfriske alle eller slette/genopbygge hele indekset.
• Metadata er nøglefri som standard - TVmaze, iTunes, IMDb-datasæt, Wikidata, Wikipedia og AniList kræver ingen konti. En OMDb-nøgle (gratis, kun e-mail-tilmelding - der er en tilmeldingshjælper under Indstillinger → Indeksering) forbedrer filmmatchning; en TMDB-nøgle respekteres, hvis du allerede har en.
• Til dig rangordner væggen efter en smagsprofil, der bygges på denne maskine ud fra din egen fuldførte historik og din overvågningsliste: yndlingsgenrer, om du hælder til film eller serier, og cirka hvilken æra. Titler, du allerede har, synker til bunden i stedet for at forsvinde, og en billedtekst »Fordi du ser …« fortæller, hvad den gik efter. Uden historik falder den tilbage på Mest postet, så fanebladet er aldrig tomt. Intet af dette forlader daemonen.
• Ikke interesseret på et felt skjuler den titel, og skjuler du et par lignende, lærer væggen noget: den foreslår et filter, du godtager med ét klik (»Skjul alle Reality-titler fra nu af?«). Alt det skjulte, og hvert lært filter, står under Skjult & filtre og kan fortrydes der.
• En lille tilgængelighedsprik på et felt er oraklets dom (§13): et gult »?« betyder usikkert hos dine udbydere, rødt at delene bliver ved med at mangle. Hele grupper, der er ved at blive ryddet, får et ryddet-mærke.

7 · Forhåndsvisning & verificering

Du behøver ikke vente på, at en download bliver færdig, for at vide, om det er den rigtige fil. Åbn den, mens den henter, tjek at indhold, sprog og kvalitet er som forventet, og annuller tidligt, hvis de ikke er - i stedet for først at opdage det efter hele downloaden.

Den første halvdel af det står allerede på siden. Åbn en downloads række i køen (eller i historikken), så viser skuffen, hvad der er inde i videofilen, læst ud af de bytes, der er ankommet indtil nu: opløsning, video- og lydcodecs, lydsprog, undertekster, kapitler. En release, der er den forkerte version, det forkerte sprog eller en opskalering, afslører sig selv i det panel, længe før downloaden er færdig.

Siden finder også ud af, om denne browser kan afspille filen, og siger det i stedet for at gætte: browsere er forskellige (Safari afkoder HEVC, hvor Chrome ikke gør, og næsten ingen afkoder AC-3- eller DTS-lyd), så spørgsmålet stilles til den browser, du faktisk sidder i. Når svaret er ja, åbner ▶ Afspil en afspiller direkte på siden, som viser filen, mens den hentes. De fleste udgivelser er MKV, som mange browsere nægter at åbne, selv om de kan afkode alt indeni, så nzbfast pakker dem om, mens de afspilles. Intet bliver kodet om: billede og lyd er de oprindelige bytes i en anden indpakning, og at springe til et andet sted virker stadig. Er lydsporet et, som denne browser ikke kan afkode, og bærer udgivelsen et andet, som den kan, er det det andet spor, der afspilles, så billedet ikke kommer stumt. Først når browseren mangler afkoderen til selve videoen, giver knappen filen videre til din egen medieafspiller, som beskrevet nedenfor.

Én indstilling styrer det hele: Indstillinger → Grænseflade → Tjek en fil, mens den henter. Kun detaljer, standarden, viser panelet og tilbyder ingen afspiller på siden; Detaljer og en afspiller tilføjer afspilleren; Fra standser al læsning af filen - med den slået fra åbner intet en halvt hentet fil for nogen.

For i stedet at tjekke i din egen medieafspiller:

• ▶ Afspil på væggen (eller /m3u/<id>) giver din medieafspiller en URL; daemonen starter eller genbruger downloaden bag den.
• /stream/<nzo_id>-endpointet serverer filen med fuld HTTP- range-understøttelse, mens den henter. Kontrol af ethvert punkt virker: tag en stikprøve ved minut 40, og artiklerne til det område promoveres forrest i downloadkøen - den åbner der på et par sekunder i stedet for minutter. Filens hoved og hale hentes først, så afspillere finder deres indeksdata med det samme.
• Bibliotekstilstand: kategorier angivet i library_cats bliver til øjeblikkelige metadata-kun-poster - en .strm-fil dukker straks op, tilgængeligheden verificeres i baggrunden, og den rigtige download starter, når du åbner den første gang.

8 · Usenet-servere

Indstillinger → Usenet-servere er den fulde editor: tilføje, redigere, fjerne, omarrangere og tage enhver server ind i eller ud af puljen. Hver server har:

Lad der være lidt luft under kontoens forbindelsesgrænse. At sætte forbindelserne lidt under grænsen koster ingenting: gennemløbet flader ud længe før de sidste en eller to forbindelser, og Forbindelsestuning (§13) lander alligevel under. Det er de ledige pladser, der lader en anden enhed, et andet program eller et nyt forsøg efter en afbrudt socket komme ind alligevel i stedet for at blive afvist, mens denne her optager hver eneste plads.

Du behøver ikke holde styr på maskinens grænse for åbne filer. Systemet tæller hver forbindelse som en åben fil, og macOS starter et program med en grænse på 256 af dem, som et fuldt sæt forbindelser fordelt på flere servere kan passere. På macOS og Linux hæver nzbfast selv den grænse ved opstart: det beder om 65536 åbne filer og går ned gennem 16384, 4096 og 1024, indtil systemet siger ja, aldrig over den hårde grænse systemet sætter, og det kører videre med den grænse, det havde, hvis hvert trin bliver afvist. Windows har ingen grænse af den slags pr. proces. Andre programmer tager den grænse, skallen gav dem, og et program, der løber tør for åbne filer midt i et job, kan stoppe uden at skrive hvorfor i sin log. Sæt derfor forbindelserne pr. server efter, hvad dit abonnement tillader, minus luften ovenfor, og ikke efter hvad du tror maskinen kan holde til.

Sådan gemmes dine udbyderadgangskoder

Udbyderadgangskoder i config.local.json er sløret, ikke krypteret. De gemmes som obf1: efterfulgt af en kodet form, så filen ikke læses som ren tekst, hvis den dukker op i et skærmbillede, et forumindlæg, en fejlrapport eller på en skærm, en anden kan se.

Lad os være tydelige om, hvad det giver dig, og hvad det ikke giver:

• Det er ikke kryptering og beskytter slet ikke mod nogen, der har filen. Metoden står i vores offentlige kildekode, og afkoderen følger med inde i nzbfast, så den, der har filen, henter adgangskoden ud på sekunder. Behandl filen som hemmelig præcis som du ville, hvis adgangskoderne var læsbare.
• Det fjerner den tilfældige lækage, og det er den almindelige. Konfigurationer bliver klistret ind i supporttråde og fanget på skærmbilleder langt oftere, end de bliver stjålet fra disken.
• En adgangskode, du selv har skrevet ind som ren tekst, virker stadig. nzbfast læser begge former, så håndredigerede konfigurationer og import fra andre klienter går aldrig i stykker; næste gang der gemmes, skrives den slørede form.
• Filen skrives desuden læsbar kun for den konto, der kører nzbfast (tilstand 0600 på macOS og Linux).

Til sammenligning gemmer NZBGet og SABnzbd begge udbyderadgangskoder som læsbar ren tekst i deres konfigurationsfiler. Vi mener, at sløring er en lille forbedring oven på det, ikke en sikkerhedsfunktion.

Hvorfor ikke systemets nøglering? macOS Keychain, Windows Credential Manager og Linux' secret services ville give ægte beskyttelse, og vi vender måske tilbage til det. To ting stopper os i dag. Adgang til nøgleringen hænger på programmets identitet, og nzbfast er endnu ikke kodesigneret, så dialogerne og opførslen efter hver opdatering er dårlige. Og en stor del af installationerne er Docker, servere uden skærm og NAS-kasser, hvor der slet ikke findes en nøglering, hvilket ville efterlade to forskellige lagringsveje at holde korrekte. Ét velforstået format, der opfører sig ens alle steder, er indtil videre den bedre handel.

To yderligere indstillinger pr. server har endnu ingen betjening i dashboardet: skriv dem i hånden ved den servers post i config.local.json (se §17), og genstart.

• Fluebenet ved siden af hver server er dens til/fra-kontakt: sat betyder, at serveren er med i download-puljen, ikke sat betyder deaktiveret. En deaktiveret server beholder sine loginoplysninger og indstillinger og kan stadig testes; den bliver bare aldrig bedt om artikler. Rækken tones ned, tællingen i overskriften (2 af 3 aktive) falder, og ændringen gælder fra næste download. Nyttigt til at spare på en blokkonto, eller til at bevise at én udbyder står bag et problem uden at slette den.
• Test laver en rigtig forbindelse + TLS + login og rapporterer rundrejsetiden.
• Importér fra SABnzbd / NZBGet… scanner de sædvanlige installationsplaceringer, viser, hvad den fandt, og kopierer servere ind (springer dubletter over).
• Serverændringer gælder fra den næste download - ingen genstart.

9 · Indstillingsoversigt

Næsten alt kan indstilles fra dashboardet under ⚙ Indstillinger; de fire undtagelser står sidst i dette afsnit. Værdier mærket live gælder med det samme; restart-værdier ved næste opstart. Hver ændring, der foretages her, gemmes i settings.json og overlever genstart (værdier fra brugerfladen slår flag på kommandolinjen).

Hastighed & planlægning live

Næste download live

Forbindelser (pr. server), vindue (pipelining-dybde pr. forbindelse), decodere (parallelle afkodningstråde). Aflæses, når hvert job starter. Standardværdierne passer til de fleste linjer; brug tuning-værktøjerne, før du hæver blindt.

Kontrol under download vælger, hvor meget der verificeres, mens data kommer ind. Fuld bekræfter hver PAR2-blok med MD5. Hurtig (standard) gør krav på blokke via CRC32, hvilket er 2-3x hurtigere på en langsom CPU, og verificerer stadig hver artikels egen kontrolsum. Let springer desuden de artikelkontrolsummer over, så snart PAR2 dækker en fil: skaden dukker så op et øjeblik senere, ved sin blok. I alle tre bruger den afsluttende runde og enhver reparation fuld MD5, og et download uden PAR2-filer beholder sine artikelkontrolsummer.

Disk & kvote live

Minimum fri plads (sæt nye jobs på pause under den; 2 GB som standard, 0 slår det fra), downloadkvote pr. dag eller måned (UTC; Tving-jobs omgår den), hukommelsesgrænse - motorens RAM-budget (standard: ¼ af RAM, med loft; hæv den på en maskine med meget RAM for maksimal hastighed på kæmpe jobs, og se hvad lav hukommelse koster, før du sænker den) genstart.

Flyt fuldførte til: efter udpakning, oprydning og omdøbning flyttes færdige downloads hertil - et NAS-share, et mediedrev, dér hvor dit bibliotek bor. Kategoristrukturen bevares (et job, der blev færdigt under tv/, lander under tv/ på destinationen), og historikken følger med flytningen, så tilsluttede apps importerer og sletter på den nye placering. Er destinationen utilgængelig, når et job bliver færdigt (share offline, ikke mere plads), bliver filerne i downloadmappen, og jobbet fuldføres alligevel helt normalt. Tom = fra. Destinationer pr. kategori sender bestemte kategorier et andet sted hen (tv=/Volumes/NAS/TV, movies=/Volumes/NAS/Movies); hver angivet sti er den kategoris mappe, så der oprettes ingen ekstra kategoriundermappe i den. Kategorier uden en regel følger Flyt fuldførte til.

Dybde for indlejrede arkiver (standard 5) er, hvor mange lag arkiv-i-arkiv der pakkes ud automatisk: et RAR-sæt med en 7z indeni, som igen indeholder en RAR, er normalt på Usenet, og nzbfast følger kæden uden en ekstra omgang. Ved grænsen bliver det dybeste arkiv simpelthen liggende, ikke pakket videre ud, og downloadet fuldføres alligevel. Hæv den kun til usædvanligt dybe udgivelser.

Auto-omdøbning & oprydning live

Omdøb færdige downloads (slået til som standard) giver mappen og hovedfilen et rent, sigende navn: en film bliver Example Movie (2024), serier beholder Show - S01E02. Slørede eller ukendte navne får lov at stå præcis som postet i stedet for at blive gættet.

Hele gruppen kører efter reparation og udpakning og før Flyt fuldførte til, og springes helt over for et job, der stadig venter på en adgangskode. Begge sletttrin gælder kun udgivelser, der er genkendt som film eller serie: en softwarelast eller et sæt, der ikke kan klassificeres (sløret), bliver aldrig ryddet.

Slettede filer ryger i papirkurven afgør, hvad "slette" betyder ovenfor. Slået til flytter oprydningen filer til systemets papirkurv, så et forkert gæt om, hvad der var skrald, kan fortrydes; slået fra slettes de med det samme. Den er slået til som standard på macOS og Windows, hvor papirkurven er et sted, du kan se og tømme, og slået fra som standard på Linux, hvor den som regel ikke er det.

Mapper & behandling

Downloadmappe genstart, watch-mappe, efterbehandlingsscript (kører efter hvert job med SABnzbd-kompatible argumenter og SAB_*-miljø - eksisterende SAB-scripts virker uændret), oprydningsendelser (skraldfiler slettet efter fuldførelse), Smarte mapper og tv-arkivering (se §10).

Behold .nzb-filer efter afhentning (slået fra som standard) lader den originale .nzb blive i watch-mappen, efter den er sat i kø, i stedet for at flytte den til papirkurven - for samlere, og til at give filen videre, når en download driller. En beholdt fil huskes, også på tværs af genstarter, og sættes ikke i kø igen; gem den igen for at hente den på ny. Uanset hvad du vælger, har hvert jobs skuffe en Hent .nzb-filen-knap, så en kopi af ethvert jobs .nzb aldrig er mere end et klik væk.

Søg på indeksere live

Dine konti hos NZB-indekserwebsteder, én linje hver, så en søgning på væggen også kan spørge dem. Hvad funktionen gør, og hvordan man søger med den, står i §5.

Indeksering live

Bibliotek, Sikkerhed, Grænseflade

Bibliotek: kategorier behandlet som øjeblikkelige biblioteksposter + gentjek-interval. Sikkerhed: den fulde API-nøgle (alt) og NZB-nøglen (kun-tilføj - sikker at give til indexer-sites), begge kan roteres live. Hvert af felterne erstatter den nøgle, det hører til, så snart du forlader feltet, og lader du et felt stå tomt, beholder det den nøgle, det allerede har. API-nøglen har desuden Show, som viser og kopierer den nuværende nøgle, så du kan sætte den ind i Sonarr, Radarr eller NZB360, når det passer dig, og Create new, som laver en afløser - den gamle nøgle holder op med at virke med det samme, så alt, der allerede er forbundet, skal have den nye. Begge afhænger af selve API-nøglen: den kun-tilføjende NZB-nøgle kan ikke læse den, hvilket er hele pointen med den nøgle. Hvor nøglen kommer fra på en ny installation, se §2. Grænseflade: kliklyde, skrivebords-notifikationer ved fuldførelse, interval for gensortering af udbydere.

Hastighedsenheder live afgør, hvordan hver hastighed vises i dashboardet: megabyte (MB/s, normen blandt downloadprogrammer, standarden) eller megabit (Mb/s, sådan som udbydere angiver linjer). Filstørrelser bliver i byte. Det er en egenskab ved daemonen, ikke ved din browser, så det gælder hver enhed, der kigger på denne installation.

Avanceret: knapperne bag de indlysende

Seks indstillinger uden flag på kommandolinjen. Hver har nu en avanceret række på det indstillingskort, den hører til, og kan stadig sættes via API'et (§16), f.eks. /api?mode=config&name=verify_mode&value=lean&apikey=…. Som alle andre gemmes de i settings.json.

10 · Automatisering

Overvågningsliste

Den enkleste automatisering: tilføj en titel på dashboardet, sæt kvalitetspræferencer, færdig. Nye releases hentes, efterhånden som de dukker op i dine indekserede grupper; kopier af bedre kvalitet opgraderer tidligere hentninger; en kalendervisning viser, hvad der er på vej.

En listekilde fodrer overvågningslisten fra en liste, du har i Plex, på en af to måder: forbind din Plex-konto ved at godkende en kort kode på Plex' side, eller indsæt adressen på en Plex-overvågningsliste. Adressen er en adgangsnøgle - den giver enhver, der har den, ret til at læse listen - så den maskeres, når den er gemt. Synkronisering af fjernelser er med vilje forskellig pr. tilstand: en forbundet konto ser hele listen, så en titel, der fjernes dér, overvåges ikke længere her (allerede færdige downloads bliver); et adressefeed indeholder kun de nyeste poster, så fravær beviser ingenting, og titler bliver kun tilføjet. Begge standarder kan ændres pr. kilde.

Søg også på mine indekser-konti efter det, jeg vil have, nederst på overvågningslistens kort, lader den spørge kontiene fra Indstillinger → Søg på indeksere ud over dit eget indeks (§5). Det begynder slået fra, for det er det eneste her, der bruger en målt konto, uden at du klikker. Slået til spørger hver overvåget post cirka to gange om dagen, og kun efter det, den ikke allerede har fundet, under de samme daglige grænser og med de samme bemærkninger, når en konto springes over. En kandidat fra en indekser bedømmes præcis som en lokal, så kvalitetsgulve, opgraderinger, sæsonpakker og dublethåndtering gælder alle sammen, og en lokal kopi vinder enhver lige stilling, fordi den ikke koster tildeling. Med den indbyggede indekser slået fra er det dette, der overhovedet giver overvågningslisten noget at arbejde med.

RSS-feeds

Indstillinger → RSS: enhver newznab-/indexer-RSS-URL med interval pr. feed, kategori og filterregler (titelmønstre, størrelsesgrænser). Matchende emner hentes automatisk.

Smarte mapper

Regler, der evalueres, når et job tilføjes: match efter mønster/nøgleord og størrelse, tildel en kategori (første match vinder). Med tv-arkivering slået til omdøbes og arkiveres færdige tv-episoder som Show/Season 01/Show - S01E02.mkv - klar til Plex/Jellyfin uden et eksternt værktøj.

Planlægger

Ugeplanen (se §9) automatiserer pause/genoptag/hastighed efter tidspunkt på dagen.

Scripts

Et efterbehandlingsscript modtager SABnzbds positionsargumenter og SAB_*-miljøvariabler: det store økosystem af SAB-scripts kører som det er. NZBGets dialekt leveres ved siden af - NZBPP_*-variabler (DIRECTORY, NZBNAME, CATEGORY, TOTALSTATUS, PARSTATUS, UNPACKSTATUS, FINALDIR) og exitkoderne 93/94/95 - så kernelogikken i et NZBGet-udvidelsesscript kører også. Mapningen er ærlig snarere end en emulering: reparation og udpakning sker inde i one-pass-downloaden, så en ren fuldførelse rapporterer PARSTATUS=0 og en repareret PARSTATUS=2. Scriptegne indstillingsformer (NZBPO_*) leveres ikke. Et script må gerne efterlade en hjælper kørende i baggrunden, når det slutter, og nzbfast dræber den ikke, men nzbfast holder op med at læse scriptets output, i det øjeblik scriptet selv er færdigt: giv en baggrundshjælper sin egen output-omdirigering, ellers bliver den standset, første gang den prøver at skrive.

Præ-kø-script

En anden krog kører, før en download kommer i køen (Indstillinger → Mapper → Præ-kø-script), med SABnzbds præ-kø-kontrakt: argumenterne name, pp, category, script, priority, size, group plus SAB_*-miljøet. Dets første outputlinje accepterer (1) eller afviser (0) downloaden; linje 2-7 kan omdøbe den, sætte pp, skifte kategori, vælge et script eller ændre prioriteten (tomme linjer beholder standarden). En afvist download går i historikken som Mislykket med årsagen, og Prøv igen fra historikken bringer den tilbage uden at spørge scriptet igen. Krogen kan aldrig miste en download: hvis scriptet mangler, går ned, overskrider sit tidsbudget eller skriver noget, der ikke er en dom, fortsætter tilføjelsen urørt, og loggen siger hvorfor.

Livscyklushændelser og signerede webhooks

Hver jobmilepæl er en versioneret hændelse: job.added, job.started, job.finishing, job.repaired, job.completed, job.failed, plus queue.idle, giveup.tripped, disk.low, storage.slow og quota.reached. Hver bærer schema_version (i øjeblikket 1; nye nøgler kan dukke op uden et hop - ignorer det, du ikke kender), et monotont seq og et at-tidsstempel i millisekunder.

For at modtage dem tilføjer du et webhook-notifikationsmål (Indstillinger → Automatisering) og skriver i dets events-felt, hvilke hændelsestyper det skal have - præcise typer eller et præfiks som job.*. Målet modtager derefter én POST pr. hændelse: hændelsens JSON som krop plus et delivery-id (<boot>-<seq>, håndtaget at deduplikere på), headerne X-NzbFast-Event og X-NzbFast-Delivery, og - når målet har en signeringshemmelighed - X-NzbFast-Signature: sha256=<hex>, en HMAC-SHA256 af kroppens nøjagtige bytes under din hemmelighed (samme form, som GitHubs webhooks bruger). Verificér i Python:

expected = "sha256=" + hmac.new(secret, body, hashlib.sha256).hexdigest()
ok = hmac.compare_digest(expected, request.headers["X-NzbFast-Signature"])

Levering er mindst-én-gang: et mål, der ikke kan nås, prøves igen efter 10 s, 60 s og 5 min og droppes derefter med fejlen vist på målets indstillingsrække. Et HTTP-fejlsvar (404, 401...) prøves ikke igen - ret modtageren og brug Test. Hvert mål har sin egen leveringsbane, så et, der er langsomt eller unåeligt, aldrig holder et andet tilbage; inden for en bane beholder leveringerne den rækkefølge, hændelserne skete i, og droppes én, viser sekvensnumrene hullet. De klassiske hændelsesord (completed, failed, repaired, disk, quota) beholder deres betydning for menneskelige notifikationer på samme mål.

11 · Sonarr, Radarr & venner

nzbfast taler SABnzbd-API'et native, så hvert *arr virker ud af boksen - og den kan også fungere som deres indexer.

Som downloadklient

1. I Sonarr/Radarr: Settings → Download Clients → tilføj SABnzbd.
2. Host: din nzbfast-maskine · Port: 6789 · API-nøgle: din fulde API-nøgle (hvor du finder den: §2).
3. Kategori efter ønske (f.eks. tv / movies). Test → grønt flueben → Gem.

Dashboardet rækker dig adressen: på en installation, der endnu ikke har hentet noget, viser velkomstkortets rute "Lad Sonarr, Radarr eller en app tilføje downloads" den præcise adresse med en Copy-knap ved siden af. API-nøglen står med vilje ikke på den linje; den bliver bag sin egen visning i Indstillinger → Sikkerhed (§2).

Kø, historik, status pr. job, "fjern & slet", nyt forsøg og kategoridirigering opfører sig alle, som *arr-programmerne forventer.

Som en indexer (newznab)

1. Settings → Indexers → tilføj Newznab.
2. URL: http://<host>:6789/ · API-sti: /api · nøgle: din API-nøgle.
3. nzbfast serverer caps-, search-, tvsearch- og movie-forespørgsler fra sit eget indeks over dine overvågede grupper, og /getnzb/<id> giver NZB'en tilbage.

12 · Telefon & fjernbetjenings-apps

nzbfast implementerer begge de store fjernbetjeningsprotokoller, så næsten alle mobil-/tablet-apps virker. Vælg den protokol, din app understøtter:

Apps, der taler NZBGet (nzb360, LunaSea, NZB Unity…)

Hele den JSON-RPC-flade, disse apps bruger, serveres: status, kø med omorganisér/pause/slet, historik, tilføj-NZB, hastighedsgrænse, pause/genoptag, log.

Apps, der taler SABnzbd

Dashboardet på din telefon

Åbn bare http://<machine>:6789 i en mobilbrowser - hele dashboardet og væggen har et touch-layout. Panelet Indstillinger → Fjernadgang viser de præcise URL'er og en QR-kode til at scanne.

Nå nzbfast udefra

Der er ingen loginside, og det er med vilje. Et login med sessionscookie er en sikkerhedsflade, der skal vedligeholdes for altid, og den ville stadig være den svageste lås på noget, der vender mod det åbne internet. nzbfast godkender i stedet med din API-nøgle og tager nøglen både i en forespørgselsheader og i URL'en (X-Api-Key eller Authorization: Bearer) - og det er netop det, der lader noget foran klare loginet ordentligt.

Det enkleste er slet ikke at offentliggøre den. Installer Tailscale på denne maskine og på telefonen, så er begge på det samme private net: intet er eksponeret, hverken router eller certifikat skal røres, og Indstillinger → Fjernadgang viser en adresse, der virker overalt, så snart Tailscale kører. Vælg det, medmindre du direkte har brug for et offentligt domæne.

nzbfast kan også selv servere HTTPS. Peg Indstillinger → Sikkerhed → HTTPS-certifikat / HTTPS-privatnøgle på et PEM-certifikat og dets nøgle (eller start med --tls-cert cert.pem --tls-key key.pem), genstart, så svarer dashboardet og API'et på https:// i stedet for almindelig HTTP - én lytter, ét skema. Brug det certifikat, dit domæne allerede har (for eksempel fra Let's Encrypt via certbot), eller et selvsigneret til LAN'et, som browsere accepterer efter en engangsadvarsel. Et defekt eller udløbet certifikat nægter opstart med filen nævnt ved navn, så fejlen er synlig, hvor du lavede den; forny ved at udskifte filerne og genstarte. Indbygget HTTPS krypterer trafikken, men tilføjer intet login, så behold API-nøglen sat.

Har du brug for et offentligt domæne, så sæt en omvendt proxy foran, giv den certifikatet, og lad den stå for godkendelsen. Start nzbfast med --bind 127.0.0.1, så proxyen er eneste vej ind, og peg proxyen på http://127.0.0.1:6789:

# Caddy
example.com {
    reverse_proxy 127.0.0.1:6789
}

# nginx
location / {
    proxy_pass http://127.0.0.1:6789;
    proxy_set_header Host              $host;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

Læg det på, som din proxy tilbyder: basic auth, en forward-auth-tjeneste som Authelia eller Authentik, eller klientcertifikater. Én ting fanger alle - Sonarr, Radarr og telefonapperne kan ikke gennemføre et browserlogin, så lad dem slippe udenom. De fleste proxyer kan lukke en forespørgsel med en gyldig X-Api-Key-header igennem og kræve godkendelse af alt andet.

13 · Ydelsesværktøjer

System-benchmark

Ét klik måler dine tre lofter - netværksgennemløb (en rigtig 8-sekunders multi-forbindelses-sondering), CPU-verificeringshastighed og diskskrivningshastighed - og leder med svaret: din forventede maksimale downloadhastighed, og hvilket loft der er grænsen. Den korteste bjælke er din flaskehals; de andre viser deres reserve. Planlæg den (hver 6. time → ugentligt), og hver kørsel logges til en historiktabel, så du kan se, hvornår din udbyder, ISP eller hardware ændrede adfærd. Planlagte kørsler sker kun, mens køen er i tomgang.

Forbindelsestuning

Måler én udbyder ved stigende antal forbindelser og anbefaler indstillingen - flere sockets hjælper, indtil udbyderen eller din linje mættes, og nogle udbydere straffer, hvis man beder om for meget. Test alle sammenligner hver udbyder og lader dem så alle burste sammen for at tjekke, om poolen mætter din linje.

Server-diversitet

STAT-sampler artikler på tværs af aldre på hver server og klynger udbydere efter fælles huller: udbydere med ~100% fælles manglende artikler er den samme backbone (redundante til genoprettelse); uafhængige udvider reelt din dækning. Slutter med en anbefaling i klart sprog.

Automatisk kø-intelligens

• Auto-udskyd: en download, der halter på en enkelt langsom server, mens andre jobs venter, parkeres bagest (journalen beholder dens fremgang) og forsøges igen, når køen er tom.
• Prefetch på ledige servere: servere, der ikke kan hjælpe det aktive job (deres kopier er væk), begynder i mellemtiden at hente det næste job i køen. Ingen anden klient laver overlap på tværs af jobs.
• Soak på tværs af jobs: mens et færdigt jobs hale (verificér/udpak) gøres færdig på disken, ejer det næste jobs download allerede linjen.

Tilgængelighedsoraklet

Takedowns er den vigtigste grund til, at et Usenet-download slår fejl, og de kan forudsiges: den samme udgivelse forsvinder hos én backbone, mens en anden stadig har den. nzbfast fører et lille register over, hvad dine egne udbydere faktisk har leveret, og bruger et bittelille tomgangsbudget på STAT-sonderinger (nogle få hundrede i timen pr. server, aldrig under et download) for at holde det aktuelt. Den henter aldrig nyttelast for at finde ud af det.

Hvad du får ud af det:

• En tilgængelighedsdom på væggens felter og indeksets rækker (§6): gult »?« for usikkert hos dine udbydere, rødt for med sikkerhed væk. Ingen markering betyder, at det ser fint ud.
• Et ryddet-mærke på grupper, hvor friske poster allerede fjernes, så du kan skelne en døende gruppe fra en uheldig udgivelse.
• Udbydere, oraklet har dømt ude, spørges sidst (Indstillinger, slået fra som standard, eksperimentel): når kontrollen er sikker på, at én udbyders backbone har mistet en udgivelse, spørges den udbyder sidst for det download i stedet for først. Intet fjernes, så et forkert gæt koster lidt tid frem for selve downloadet.

Dommen er en forudsigelse ud fra indicier, ikke en garanti. For et håndfast svar om én NZB tæller nzbfast check (§15) de faktiske artikler.

Hukommelsesbudget - og hvad lav hukommelse koster

Alle motorens caches deler ét budget (standard ¼ af den fysiske RAM, begrænset til 256 MB–16 GB). Sæt det eksplicit med Hukommelsesgrænse under Indstillinger, eller --mem-limit på kommandolinjen.

nzbfast er bygget til at mætte dit netværk og din disk på samme tid, og RAM er det, der lader den gøre begge dele i ét gennemløb: artikler afkodes, verificeres og skrives direkte til deres endelige offsets, så arkivvolumener aldrig behøver at røre disken overhovedet. Sult den for hukommelse, og intet går i stykker - hver cache har en spill-vej, og motoren degraderer til mere disk-I/O frem for at swappe eller fejle. Men den spill er ikke gratis, og på store jobs kan du måle den.

Målt på én maskine og én linje (M1 Ultra, 10 GbE), samme filer ved hvert budget. Hver kørsel frembragte et korrekt, fuldt verificeret, udpakket resultat:

Topforbruget følger budgettet, ikke jobbet: den 190 GB-download fuldføres i cirka 1.1 GB RAM. Det, du bytter for det, er tid - og kun på store jobs.

• Op til ~35 GB er lav hukommelse gratis. Arbejdssættet passer uanset, så en 4 GB-maskine gør sådan et job færdigt lige så hurtigt som en 64 GB-maskine.
• Efter ~87 GB betaler du 20–40% - men kun når din linje løber fra din disk. Verificeringsblokke og arkivvolumener, der ville have ligget i RAM, skrives ud og læses tilbage i stedet, og det koster kun tid, hvis netværket kan levere hurtigere, end disken kan optage den ekstra trafik. De 20–40% ovenfor blev målt på 10 GbE; samme 87 GB-job ved de samme budgetter på en ~2.4 Gbps-linje viste slet ingen straf (−1 til +7%, inden for støjen fra kørsel til kørsel). Straffen er en funktion af, hvor langt linjen løber fra disken, ikke af jobstørrelsen - på en typisk hjemmeforbindelse er et lille budget næsten gratis selv på meget store jobs.
• Straffen flader ud. Når et job er stort nok til at spille, spiller hvert begrænset budget nogenlunde samme mængde - kørslerne på 2 GB, 1 GB og 256 MB læser i bund og grund det samme antal blokke tilbage fra disken og bliver færdige inden for støjen af hinanden. Så lidt mere RAM under tærsklen, der undgår spill helt, køber ikke omkostningen tilbage: giv den nok til at holde jobbet i hukommelsen, ellers betyder det præcise tal knap noget.

På en lille NAS: sænk også Forbindelser (2–4) sammen med budgettet. Ved et 256 MB-budget og 2 forbindelser holder topforbruget sig nær 190 MB - komfortabelt inden for, hvad en 2 GB-NAS har til overs. Vær opmærksom på, at det på det tidspunkt er antallet af forbindelser, ikke hukommelsen, der begrænser dig: samme 35 GB-job tog 286 s i stedet for 65 s. Det er den ærlige form på afvejningen - den bliver altid færdig, og færdig korrekt; den mætter bare ikke linjen.

Benchmarks køres igen for hver udgivelse; metode og tal pr. maskine offentliggøres sammen med resultaterne.

14 · Opdateringer

• Opdateringer er kun besked: nzbfast downloader eller udskifter aldrig sin egen binær, og der er ingen kode i den, der kan. Når en ny version findes, viser headeren ⬆ v X tilgængelig - download; chippen linker til den officielle downloadside (linket er fast i appen og kommer aldrig fra opdateringsmanifestet). Installér den nye version på samme måde, som du installerede den nuværende.
• nzbfast søger efter nye versioner to gange om dagen. Slå Søg efter opdateringer (Indstillinger) fra, og den kontakter slet ikke opdateringsmanifestet; en tom opdaterings-URL gør det samme.

Opdatering uden at miste dine indstillinger

Én regel dækker enhver installation: en opdatering udskifter programmet, aldrig dine indstillinger. Alt, hvad du har konfigureret - servere, stier, API-nøglen, køen - bor i en håndfuld filer i én mappe (§17), og intet installationsprogram, image-pull eller pakkeopgradering rører den mappe. Når indstillinger alligevel ser væk ud efter en opdatering, er det næsten altid, fordi den nye installation læser en anden, tom mappe, ikke fordi noget blev slettet; de gamle filer ligger stadig, hvor de altid har ligget. §18 har trinnene til at få dem tilbage.

15 · Kommandolinje

Alt, hvad daemonen gør, kan også scriptes. De daglige kommandoer:

Også tilgængelige: inspect, probe, bench, bench-cpu, soak, fetch, spots/spot-search/spot-get (Spotnet), predb-seed (fylder pre-databasen med tiden før feedet blev slået til), make-release-nzb/make-test-nzb (test-fixtures). Hver kommando tager --config og --help. Dertil kommer post: den uploader filer som yEnc-artikler og skriver den tilhørende NZB. Et driftsværktøj; det kræver et udtrykkeligt --post-server og vælger aldrig en server for dig.

16 · API-oversigt

Basis-endpoint: http://host:6789/api?mode=…&apikey=…&output=json - SABnzbd-kompatibelt, så eksisterende SAB-integrationer virker uændret. To nøgler: API-nøglen (fuld kontrol) og NZB-nøglen (kun-tilføj: addfile/addurl). addnzblnk er med vilje ikke med i sættet for kun at tilføje: at slå et link op kan bruge målt indekserkvote, og det har en nøgle til kun at tilføje ikke noget at gøre med.

17 · Filer & placeringer

Hvor indstillingsmappen ligger, afhænger af, hvordan nzbfast blev installeret. Denne ene mappe rummer alt, hvad der er værd at tage backup af:

Og hvad der ligger i den:

18 · Fejlfinding

nzbfast - denne manual følger med hver udgivelse. Indstillinger, endpoints og standarder, der er nævnt her, svarer til den version, den blev leveret med.