⚡ nzbfast

Den snabba Usenet-nedladdaren - användarhandbok

1 · Välkommen

nzbfast laddar ner från Usenet så snabbt som din linje, dina providers och din maskin tillåter - och oftast betyder det så snabbt som din linje. Det är ett enda fristående program: motorn, en webbaserad instrumentpanel, en postervägg för mediabläddring, en inbyggd indexerare, förhandsgranskning i realtid, native PAR2-reparation och native RAR-uppackning ligger alla inuti en och samma körbara fil. Det finns inget annat att installera.

Det som gör den snabb är arkitektur, inte trixande:

• Pipelinead NNTP - många artikelförfrågningar rider på varje anslutning rygg mot rygg, så att varje anslutning hålls i full fart i stället för att vänta ut tur-och-retur-tider.
• En enpassrörledning - nedladdning, verifiering och uppackning överlappar. Arkivvolymer packas upp i strömmen; på ett typiskt store-mode-inlägg rör RAR-filerna aldrig din disk, så jobbet behöver 1× releasens storlek, inte 2×, och blir klart när nedladdningen blir klar.
• Union över flera providers - varje konfigurerad server bidrar; en artikel som saknas på en backbone hämtas från en annan. Långsamma eller döda servrar stoppar aldrig upp kön.
• En minnesbudget - motorn anpassar sig till en begränsad RAM-tilldelning och faller tillbaka på disk vid behov. Den swappar aldrig din maskin.

Mätt mot fältet på identisk hårdvara, samma jobb och providers har nzbfast gjort klart en 190 GB nedladdning på omkring 5 minuter på en 10 GbE-linje - med de ledande alternativen 30–220 % efter på samma tester, där de överhuvudtaget slutförde dem. Siffrorna finns i §3.

2 · Snabbstart

macOS

1. Öppna nzbfast-<version>-macos.dmg och dra NzbFast till Program (universell: Apple Silicon + Intel).
2. Första starten: macOS varnar för att nzbfast ännu inte är Apple-notariserad. Högerklicka på appen → Öppna - eller öppna Systeminställningar → Integritet & säkerhet, scrolla ner och klicka Öppna ändå. Detta är ett engångssteg.
3. Appfönstret visar instrumentpanelen med ett välkomstkort - klicka på det och lägg till minst en Usenet-server (host, port 563, användarnamn, lösenord). Du kan lägga till fler senare i Inställningar.
4. Släpp en .nzb var som helst på instrumentpanelen - eller dubbelklicka bara på .nzb-filer i Finder. Nedladdningar hamnar i ~/Downloads/nzbfast. Avsluta från menyn; nedladdningar återupptas där de slutade.

Föredrar du ingen app? Det vanliga zip-arkivet (binär + Start nzbfast.command-startare, samma motor) fungerar fortfarande som förr - stegen nedan under "Från en terminal".

Windows

1. Kör nzbfast-<version>-windows-x64-setup.exe. Den installerar bara för din användare (inget administratörslösenord). Eftersom den här utgåvan ännu inte är kodsignerad kan SmartScreen visa "Windows skyddade din dator" - klicka Mer information → Kör ändå.
2. nzbfast bor i systemfältet: dubbelklicka på fältikonen (eller använd Öppna instrumentpanelen i dess högerklicksmeny) för att öppna instrumentpanelen, och lägg sedan till din Usenet-server från välkomstkortet. Fältmenyn har också Pausa/Återuppta, din nedladdningsmapp och Avsluta.
3. Att dubbelklicka på en .nzb-fil lägger den i kön. Windows Defender kan fråga en gång om att tillåta lokal nätverkslyssning - tillåt det.

Föredrar du en portabel kopia? -windows-x64.zip fungerar fortfarande: packa upp var som helst och dubbelklicka på nzbfast.exe (eller Start nzbfast.bat) för terminalguiden.

Från en terminal (valfri plattform)

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

Din API-nyckel

Vid en verkligt ny installation skapar nzbfast en API-nyckel åt sig själv första gången daemonen startar, och skriver ut den en gång i en banner precis under instrumentpanelens adress. Från och med då kräver varje förfrågan den nyckeln, så att instrumentpanelen och API:et inte står öppna för allt som kan nå maskinen.

Vad du gör med den beror på hur du startade nzbfast:

• macOS-appen, Windows-fältikonen eller serve --open: ingenting. De skickar nyckeln till webbläsarfönstret de öppnar, instrumentpanelen kommer ihåg den, och du är redan inloggad.
• En webbläsare du öppnat själv, eller instrumentpanelen på en telefon eller en annan dator: sidan frågar efter nyckeln en gång och kommer ihåg den efter det.
• Sonarr, Radarr, nzb360 med flera: klistra in den som deras SABnzbd- eller NZBGet-nyckel (§11, §12).

Nyckeln sparas i en fil som heter apikey bredvid din konfigurationsfil, så den är densamma efter omstarter och du kan läsa tillbaka den när du behöver. På macOS och Linux är den filen läsbar endast för kontot som kör nzbfast. Den finns också i daemonens egen utskrift, så instrumentpanelens Logg-kort har den om terminalen redan rullat förbi.

Vill du använda en egen nyckel i stället skriver du in den under Inställningar → Säkerhet; den gäller direkt. Den panelen ändrar nyckeln men visar aldrig den nuvarande, så läs filen apikey om du behöver få tillbaka det genererade värdet. Vill du köra helt utan nyckel, för att något framför nzbfast redan sköter inloggningen, startar du den med NZBFAST_OPEN=1 i miljön. nzbfast förblir då öppen och säger det rakt ut vid start.

Vilka maskiner som över huvud taget kan nå daemonen är ett separat val: serve --bind. Standard är 0.0.0.0, alltså varje nätverksgränssnitt, eftersom en NAS-låda, en telefon och en Sonarr på en annan dator alla måste kunna ansluta. --bind 127.0.0.1 smalnar av det till maskinen som nzbfast kör på, vilket är vad du vill ha på ett enskilt skrivbord där inget annat behöver åtkomst.

3 · Så fungerar nzbfast

En snabb ordlista så att resten av handboken blir lätt att läsa:

Rörledningen kör nedladdning → avkodning → verifiering → uppackning samtidigt. Pipeline-kortet på instrumentpanelen visar alla tre banor röra sig på en gång. När den sista byten anländer är verifieringen redan klar och filen redan uppackad; ett typiskt jobbs "efterbehandlingstid" är noll. Om reparation behövs materialiseras först då volymer till disk, repareras på plats av den native GF(2¹⁶)-motorn (omdöpt eller byteförskjuten obfuskerad data hittas och adopteras av en glidande blockskanning) och packas upp på nytt - allt automatiskt.

Avbrutna nedladdningar (krasch, strömavbrott, kill -9) återupptas från artikeljournalen: byte som redan finns på disken hämtas aldrig två gånger. Journalen registrerar var varje artikels byte fysiskt landade - även byte som blev direktuppackade till slutfilen - så en återupptagning bygger om från lokal disk och verifierar allt den återställde mot PAR2-blockkartan innan den litar på det.

Hur det står sig i jämförelse

Mätt mot SABnzbd 5.0.4 och NZBGet 26.2 på samma maskin, samma providers och samma NZB:er, tidsatt till en användbar fil - nedladdning, verifiering, reparation och uppackning inräknade, för det är då jobbet faktiskt är klart:

Glappet är efterbehandlingen som de andra fortfarande måste göra efter att den sista byten landat. Båda konkurrenterna trimmades inför jämförelsen, inte lämnade på standardvärden - SABnzbd i synnerhet levereras med request-pipelining av, vilket kostar den dyrt, så den slogs på.

Två skillnader betyder lika mycket som tiderna:

• Diskutrymme. Ett pass behöver 1× releasens storlek; klienter som skriver arkivvolymer och sedan packar upp dem behöver 2×. På en testmaskin med 97 GB ledigt blev ett 87 GB-jobb klart här på 3 m 08 s och de andra två kunde inte köra alls.
• Minne. På 190 GB-jobbet var toppanvändningen 3.9 GB mot SABnzbds 9.3 GB - och nzbfast klarar samma jobb i ungefär 1 GB om man säger till den (se Minnesbudget).

4 · Instrumentpanelen

Öppna http://localhost:6789 (eller din maskins adress från en annan enhet - telefonlayouten anpassar sig automatiskt). Allt uppdateras live, en gång i sekunden. Korten, uppifrån och ner:

Rubrikrad

• Hastighetsgräns-meny - fasta tak, auto · ge plats åt LAN (ett RTT-styrt läge som backar när någon annan i huset behöver linjen) eller obegränsat.
• Pausa i… - pausa allt i 15 min/30 min/1 h/3 h med automatisk återupptagning, eller använd Pausa-knappen för en öppen paus. Paus är omedelbar: den aktiva överföringen stoppar inom sekunder och återupptas senare från journalen utan att förlora något. (Jobb med Tvinga-prioritet fortsätter ladda ner, SABnzbd-stil.)
• En uppdateringsbanner dyker upp här när en ny version är tillgänglig (se Uppdateringar).

Hastighet

Live MB/s med ett rullande diagram; de streckade vattenmärkena markerar sessionens högsta/lägsta, den svaga linjen är ett glidande medelvärde. Under det visar ett histogram hur sessionens hastighetsmätningar fördelar sig - typiskt vs topp. Bredda fönstret så visar diagrammen mer historik (upp till en timme).

Statistikrutor

Nedladdat denna session, ködjup, antal klara/misslyckade, sessionens toppfart.

Resurser - en maskin, fyra tak

CPU, RAM (mot nzbfasts minnesbudget), diskskrivhastighet och nätverk på ett normaliserat diagram, med verkliga värden i teckenförklaringen och en varning för lite disk. Ingen annan NZB-klient visar dig detta; det finns för att bevisa en poäng - nzbfast maxar din linje, inte din maskin.

Pipeline - stegen överlappar

Tre banor: nedladdning, verifiering (PAR2-block kontrollerade), uppackning. På ett friskt jobb rör sig alla tre tillsammans.

Providers

Live-hastighet per server, anslutningsutnyttjande, andel av trafiken, sessionens GB och en livstidspoäng för artikelkomplettering (färgad när en server faller under 98 %). Ett staplat areadiagram visar varje providers bidrag över tid. Rader ordnas om efter live- prestanda var 10:e s (konfigurerbart i Inställningar → Gränssnitt) så att din snabbaste provider alltid ligger överst.

Kö

• Dra rader för att ändra ordning (inom ett prioritetsband - Tvinga/Hög körs ändå först); ändra prioritet direkt i raden.
• Klicka på en rad för detaljlådan: förloppsstaplar per fil, verifieringsblockantal, vilken server som bidrog med hur mycket till detta jobb, och en "tillagd av"-rad som säger var jobbet kom ifrån (bevakningsmapp, en ansluten app, API:et…). Knappen Hämta .nzb-filen sparar jobbets .nzb-fil - nzbfast behåller en egen kopia, så det fungerar för varje jobb, även när originalfilen sedan länge är borta.
• Märken visar specialtillstånd: uppskjuten (långsam), prefetchar, pausad (se Prestandaverktyg).
• Ett nedräkningsdiagram spårar totalt GB kvar i hela kön.

Bläddra i indexet

Sök i allt den inbyggda indexeraren katalogiserat från dina bevakade grupper (se Automatisering) och ladda ner med ett klick - ingen extern indexerare behövs. Statusraden visar skanningsförloppet; Skanna nu tvingar fram ett pass.

Bevakningslista

Lägg till titlar efter namn - inklusive sådana som inte postats än. När en matchande release dyker upp i indexet hämtas den automatiskt, med kvalitetspreferenser och uppgraderingsregler (en bättre kopia ersätter en sämre).

Historik

Senaste nedladdningarna, en rad var. Misslyckade jobb erbjuder Försök igen (återupptar från journalen). Krypterade arkiv visar en 🔑 upplåsningskontroll - ange lösenordet så blir jobbet klart på plats. Verifieringshälsoremsan diagramlägger dåliga PAR2- block per nedladdning - en stigande svans betyder att artiklar kommer in skadade. Varje rads detaljlåda säger vem som lade till jobbet och har samma knapp Hämta .nzb-filen som kön - praktiskt när du vill ladda ner en release igen någon annanstans, eller bifoga .nzb-filen till en problemrapport.

Kortet listar tio nedladdningar som standard och resten är ett klick bort, på knappen ▤. Status, plats och orsaken till ett misslyckande ligger bakom ett klick på själva raden, så att det vanliga fallet - vad som blev klart, hur stort, när - förblir läsbart utan att scrolla. Dra i kortets nederkant för att låta listan scrolla på en höjd du väljer i stället. History rows under Inställningar → Gränssnitt ändrar tian; eftersom det är en egenskap hos daemonen och inte hos din webbläsare gäller det varje enhet som tittar på den här installationen. Colour History names bredvid färgar klara namn gröna och misslyckade röda; avstängt blir namnen neutrala, och den färgade pricken och radens egna detaljer säger fortfarande vilket som är vilket.

Dataförbrukning

Dagliga staplar per provider och Idag / 7-dagars / 30-dagars totaler - nödvändigt för mätade konton och blockkonton. Blockkonton visar livstidsförbrukning mot sin storlek.

Logg, Systembenchmark, Anslutningstrimning, Serverdiversitet

En loggvisare på sidan, och de tre självmätande verktygen som beskrivs i Prestandaverktyg.

5 · Lägga till nedladdningar

Kategorier, prioriteter, lösenord

• Kategorier är fritt formulerade etiketter; var och en blir en undermapp i din nedladdnings- mapp, och Smarta mappar (se §10) kan tilldela dem per regel.
• Prioriteter: Tvinga > Hög > Normal > Låg. Tvinga kringgår paus och kvot.
• Lösenord till krypterade arkiv plockas upp automatiskt från <meta type="password"> inuti NZB:n, från ett filnamn Name{{password}}.nzb eller från fältet p= i en nzblnk-länk, och kan anges per jobb via API:et eller efteråt från Historik (🔑).

nzblnk-länkar

Vissa board, mest tyska och nederländska, publicerar en nzblnk:-länk i stället för en NZB-fil. Inlägget är fördunklat, så det finns inget filnamn att länka till. Länken bär i stället ett huvud, h=, som är en söknyckel och inte en plats, plus en valfri titel t=, ett lösenord p= och en grupp g=. Någon måste först gå och hitta inlägget.

nzbfast slår upp huvudet i sitt eget index först, vilket inte kräver något nätverk alls, och bara om det missar frågar det sökindexerarna du har ställt in (Inställningar → Sökindexerare, §9), under samma dagsbudgetar och samma backoff som varje annan sökning. Titeln blir jobbets namn och lösenordet läggs på jobbet automatiskt.

• Klistra in eller dra fungerar på varje installation, Docker och NAS inräknade: kopiera länken från boardet och klistra in den var som helst på panelen.
• Att klicka på en länk kräver att schemat är registrerat hos ditt skrivbord. Appen från macOS-DMG:en registrerar det, och Windows-installeraren erbjuder det som en uppgift: den frågar först och lämnar schemat i fred om NZB Monkey eller NZBDonkey redan håller det. Den rena macOS-tarbollen, Homebrew och Linux-installationerna har ingen skrivbordshanterare, där är inklistring vägen in.
• Uppslagningen är hastighetsbegränsad med flit. Ett registrerat schema ligger en webbläsarfråga bort från varje sida du besöker, så länkar har ett tak per minut och bara de första under en minut får nå dina indexerare; därefter besvaras de enbart ur det lokala indexet.

6 · Posterväggen

Klicka på 🎬 vägg i rubriken. Väggen förvandlar ditt index till en media- bläddrare: varje igenkänd film- och TV-release som en posterruta med betyg, år, genrer, skådespelare och synopsis - dina newsgroups, bläddringsbara som en katalog.

• Flikar för Filmer / Serier / Övrigt, direktsökning och sju sorteringar: För dig, Nyaste posterna, Utgivningsår, Högst betyg, Titel A–Ö, Största och Mest postade.
• Endast matchade är på som standard och döljer oidentifierat skräp; ett "+N omatchade"- märke visar det.
• Klicka på en ruta för detaljbladet: synopsis, IMDb-betyg och röster, skådespelare - och ▶ Spela (förhandsgranska den direkt, se §7) eller ⬇ Ladda ner.
• ✎ Korrigera matchning - om en titel matchade fel serie eller film, välj rätt en från kandidatposters, eller mata in titel/år/typ manuellt. Manuell text skrivs aldrig över av berikaren. ↻ Uppdatera metadata hämtar om en titel; Inställningar → Indexering kan uppdatera alla eller radera/bygga om hela indexet.
• Metadata är nyckellös som standard - TVmaze, iTunes, IMDb-dataset, Wikidata, Wikipedia och AniList kräver inga konton. En OMDb-nyckel (gratis, registrering med bara e-post - det finns en registreringshjälp i Inställningar → Indexering) förbättrar filmmatchning; en TMDB-nyckel respekteras om du redan har en.
• För dig rangordnar väggen efter en smakprofil som byggs på den här datorn utifrån din egen färdiga historik och din bevakningslista: favoritgenrer, om du lutar åt film eller serier, och ungefär vilken epok. Titlar du redan har sjunker till botten i stället för att försvinna, och en bildtext ”Eftersom du tittar på …” säger vad den tog fasta på. Utan historik faller den tillbaka på Mest postade, så fliken är aldrig tom. Inget av detta lämnar daemonen.
• Inte intresserad på en bricka döljer den titeln, och att dölja några liknande lär väggen något: den föreslår ett filter du godtar med ett klick (”Dölj alla Reality-titlar från och med nu?”). Allt du dolt, och varje inlärt filter, finns under Dolda & filter och kan ångras där.
• En liten tillgänglighetsprick på en bricka är oraklets utlåtande (§13): ett gult ”?” betyder osäkert hos dina leverantörer, rött att delarna gång på gång saknas. Hela grupper som just rensas får en rensad-markering.

7 · Förhandsgranskning & verifiering

Du behöver inte vänta på att en nedladdning blir klar för att veta att det är rätt fil. Öppna den medan den laddas ner, kontrollera att innehåll, språk och kvalitet är vad du väntade dig, och avbryt tidigt om de inte är det - i stället för att upptäcka det efter hela nedladdningen.

• ▶ Spela på väggen (eller /m3u/<id>) ger din mediespelare en URL; daemonen startar eller återanvänder nedladdningen bakom den.
• Slutpunkten /stream/<nzo_id> serverar filen med fullt HTTP- range-stöd medan den laddas ner. Att kontrollera valfri punkt fungerar: stickprovskolla minut 40 så flyttas artiklarna för det området fram i nedladdningskön - den öppnas där typiskt på ett par sekunder i stället för minuter. Filens huvud och svans hämtas först så att spelare hittar sin indexdata direkt.
• Biblioteksläge: kategorier som listas i library_cats blir direkta poster med enbart metadata - en .strm-fil dyker upp direkt, tillgängligheten verifieras i bakgrunden och den riktiga nedladdningen startar när du öppnar den första gången.

8 · Usenet-servrar

Inställningar → Usenet-servrar är den fullständiga redigeraren: lägga till, redigera, ta bort, ordna om och ta in eller ur poolen vilken server som helst. Varje server har:

Lämna lite marginal under kontots anslutningstak. Att ställa anslutningarna en bit under taket kostar ingenting: genomströmningen planar ut långt före de sista en eller två anslutningarna, och Anslutningstrimning (§13) hamnar ändå under. Det är de lediga platserna som låter en andra enhet, ett annat program eller ett nytt försök efter en bruten socket komma in ändå, i stället för att nekas medan den här upptar varenda plats.

Så lagras dina leverantörslösenord

Leverantörslösenord i config.local.json är fördunklade, inte krypterade. De sparas som obf1: följt av en kodad form, så att filen inte läses som klartext om den dyker upp i en skärmbild, ett foruminlägg, en felrapport eller på en skärm som någon annan kan se.

Låt oss vara tydliga med vad det ger dig och vad det inte ger:

• Det är inte kryptering och skyddar inte alls mot någon som har filen. Metoden finns i vår öppna källkod och avkodaren följer med inuti nzbfast, så den som har filen får fram lösenordet på några sekunder. Behandla filen som hemlig precis som du skulle gjort om lösenorden var läsbara.
• Det tar bort den slarviga läckan, som är den vanliga. Konfigurationer klistras in i supporttrådar och fastnar på skärmbilder betydligt oftare än de stjäls från disk.
• Ett lösenord du själv skrivit in som klartext fungerar fortfarande. nzbfast läser båda formerna, så handredigerade konfigurationer och import från andra klienter går aldrig sönder; nästa gång det sparar skriver det den fördunklade formen.
• Filen skrivs dessutom läsbar endast för kontot som kör nzbfast (läge 0600 på macOS och Linux).

Som jämförelse: NZBGet och SABnzbd lagrar båda leverantörslösenord som läsbar klartext i sina konfigurationsfiler. Vi tycker att fördunkling är en liten förbättring på det, inte en säkerhetsfunktion.

Varför inte systemets nyckelring? macOS Keychain, Windows Credential Manager och Linux hemlighetstjänster skulle ge verkligt skydd, och vi kan komma att återvända till det. Två saker hindrar oss i dag. Åtkomst till nyckelringen hänger på programmets identitet, och nzbfast är ännu inte kodsignerat, så dialogerna och beteendet efter varje uppdatering blir dåliga. Och en stor andel av installationerna är Docker, skärmlösa servrar och NAS-lådor där det inte finns någon nyckelring alls, vilket skulle lämna två olika lagringsvägar att hålla korrekta. Ett enda välförstått format som beter sig likadant överallt är tills vidare den bättre affären.

Två ytterligare alternativ per server har ännu ingen kontroll i panelen: lägg in dem för hand i serverns post i config.local.json (se §17) och starta om.

• Bocken bredvid varje server är dess på/av-reglage: ibockad betyder att servern är med i nedladdningspoolen, urbockad betyder inaktiverad. En inaktiverad server behåller sina inloggningsuppgifter och inställningar och går fortfarande att testa; den blir bara aldrig tillfrågad om artiklar. Raden tonas ned, räknaren i rubriken (2 av 3 aktiva) sjunker och ändringen gäller från nästa nedladdning. Bra för att spara på ett blockkonto, eller för att bevisa att en leverantör ligger bakom ett problem utan att ta bort den.
• Testa gör en riktig anslutning + TLS + inloggning och rapporterar tur-och-retur-tiden.
• Importera från SABnzbd / NZBGet… skannar de vanliga installationsplatserna, visar vad den hittade och kopierar in servrar (hoppar över dubbletter).
• Serverändringar gäller från nästa nedladdning - ingen omstart.

9 · Inställningsreferens

Nästan allt går att ställa in från panelen, under ⚙ Inställningar; de fyra undantagen listas i slutet av det här avsnittet. Värden märkta live gäller direkt, restart-värden vid nästa start. Varje ändring som görs här sparas i settings.json och överlever omstarter (värden från gränssnittet slår flaggor på kommandoraden).

Hastighet & schemaläggning live

Nästa nedladdning live

Anslutningar (per server), fönster (pipelining-djup per anslutning), avkodare (parallella avkodartrådar). Provtas när varje jobb startar. Standardvärden är rätt för de flesta linjer; använd trimningsverktygen innan du höjer blint.

Kontroll under nedladdning väljer hur mycket som verifieras medan data kommer in. Fullständig bekräftar varje PAR2-block med MD5. Snabb (standard) gör anspråk på block via CRC32, vilket är 2-3x snabbare på en långsam processor, och verifierar fortfarande varje artikels egen kontrollsumma. Lätt hoppar dessutom över de artikelkontrollsummorna så snart PAR2 täcker en fil: skadan visar sig då ett ögonblick senare, vid sitt block. I alla tre använder den avslutande omgången och varje reparation full MD5, och en nedladdning utan PAR2-filer behåller sina artikelkontrollsummor.

Disk & kvot live

Minsta lediga utrymme (pausa nya jobb under det; 2 GB som standard, 0 stänger av det), nedladdningskvot per dag eller månad (UTC; Tvinga-jobb kringgår), minnesgräns - motorns RAM-budget (standard: ¼ av RAM, begränsad; höj den på en maskin med mycket RAM för maximal fart på stora jobb, och se vad lite minne kostar innan du sänker den) restart.

Flytta färdiga till: efter uppackning, städning och namnbyte flyttas färdiga nedladdningar hit - en NAS-utdelning, en mediadisk, där ditt bibliotek finns. Kategoristrukturen behålls (ett jobb som blev klart under tv/ hamnar under tv/ på målet), och historiken följer med flytten, så anslutna appar importerar och raderar på den nya platsen. Är målet onåbart när ett jobb blir klart (utdelningen nere, slut på utrymme) stannar filerna i nedladdningsmappen och jobbet slutförs ändå som vanligt. Tomt = av. Mål per kategori skickar enskilda kategorier någon annanstans (tv=/Volumes/NAS/TV, movies=/Volumes/NAS/Movies); varje listad sökväg är den kategorins mapp, så ingen extra kategoriundermapp skapas i den. Olistade kategorier följer Flytta färdiga till.

Djup för nästlade arkiv (standard 5) är hur många lager av arkiv-i-arkiv som packas upp automatiskt: en RAR-uppsättning som innehåller en 7z som innehåller ännu en RAR är normalt på Usenet, och nzbfast följer kedjan utan en andra omgång. Vid gränsen lämnas det djupaste arkivet helt enkelt kvar, inte vidare uppackat, och nedladdningen blir ändå färdig. Höj bara för ovanligt djupa releaser.

Auto-namnbyte & städning live

Byt namn på färdiga nedladdningar (på som standard) ger mappen och huvudfilen ett rent, informativt namn: en film blir Example Movie (2024), serier behåller Show - S01E02. Obfuskerade eller okända namn lämnas exakt som de postades i stället för att gissas.

Hela gruppen körs efter reparation och uppackning och före Flytta färdiga till, och hoppas över helt för ett jobb som fortfarande väntar på lösenord. Båda raderingsstegen gäller bara releaser som känts igen som film eller serie: en programvarulast eller en oklassificerbar (obfuskerad) uppsättning städas aldrig.

Raderade filer hamnar i papperskorgen avgör vad "radera" betyder ovan. Med den på flyttar rensningen filer till systemets papperskorg, så en felgissning om vad som var skräp kan ångras; med den av raderas de direkt. Den är på som standard på macOS och Windows, där papperskorgen är någonstans du kan se och tömma, och av som standard på Linux, där den oftast inte är det.

Mappar & behandling

Nedladdningsmapp restart, bevakningsmapp, efterbehandlingsskript (körs efter varje jobb med SABnzbd-kompatibla argument och SAB_*-miljö - befintliga SAB-skript fungerar oförändrade), städtillägg (skräpfiler som raderas efter slutförande), Smarta mappar och TV-arkivering (se §10).

Behåll .nzb-filer efter upphämtning (av som standard) lämnar kvar original-.nzb:n i bevakningsmappen efter att den köats, i stället för att flytta den till papperskorgen - för samlare, och för att kunna ge filen till någon när en nedladdning strular. En kvarlämnad fil kommer nzbfast ihåg, även över omstarter, och köar den inte igen; spara om den för att ladda ner den på nytt. Oavsett vilket har varje jobbs detaljlåda en knapp Hämta .nzb-filen, så en kopia av vilket jobbs .nzb som helst är aldrig mer än ett klick bort.

Indexering live

Bibliotek, Säkerhet, Gränssnitt

Bibliotek: kategorier som behandlas som direkta biblioteksposter + omkontrollintervall. Säkerhet: den fullständiga API-nyckeln (allt) och NZB-nyckeln (enbart tillägg - säker att ge till indexersidor), båda roterbara live. Vardera rutan ersätter den nyckel den hör till så snart du lämnar fältet, och lämnar du en ruta tom behåller den nyckeln den redan har. API-nyckeln har dessutom Show, som visar och kopierar den nuvarande nyckeln så att du kan klistra in den i Sonarr, Radarr eller NZB360 när det passar dig, och Create new, som präglar en ersättare - den gamla nyckeln slutar fungera omedelbart, så allt som redan är anslutet måste få den nya. Båda är beroende av själva API-nyckeln: NZB-nyckeln för enbart tillägg kan inte läsa den, vilket är hela poängen med den nyckeln. Var nyckeln kommer ifrån på en ny installation, se §2. Gränssnitt: klickljud, skrivbords- aviseringar vid slutförande, omsorteringsintervall för providers.

Hastighetsenheter live avgör hur varje hastighet visas i panelen: megabyte (MB/s, normen bland nedladdningsprogram, standardvalet) eller megabit (Mb/s, som operatörer anger linjer). Filstorlekar står kvar i byte. Det är en egenskap hos daemonen, inte hos din webbläsare, så det gäller varje enhet som tittar på den här installationen.

Avancerat: rattarna bakom de självklara

Sex inställningar utan flagga på kommandoraden. Var och en har nu en avancerad rad på det inställningskort som äger den, och går fortfarande att sätta via API:et (§16), t.ex. /api?mode=config&name=verify_mode&value=lean&apikey=…. Precis som alla andra sparas de i settings.json.

10 · Automatisering

Bevakningslista

Den enklaste automatiseringen: lägg till en titel på instrumentpanelen, sätt kvalitetspreferenser, klart. Nya releaser grabbas när de dyker upp i dina indexerade grupper; kopior med bättre kvalitet uppgraderar tidigare grabbar; en kalendervy visar vad som är på väg.

RSS-flöden

Inställningar → RSS: valfri newznab/indexer-RSS-URL med intervall per flöde, kategori och filterregler (titelmönster, storleksgränser). Matchande objekt laddas ner automatiskt.

Smarta mappar

Regler som utvärderas när ett jobb läggs till: matcha på mönster/nyckelord och storlek, tilldela en kategori (första träffen vinner). Med TV-arkivering på döps färdiga TV-avsnitt om och arkiveras som Show/Season 01/Show - S01E02.mkv - Plex/Jellyfin-redo utan ett externt verktyg.

Schemaläggare

Veckoschemat (se §9) automatiserar pausa/återuppta/hastighet efter tid på dygnet.

Skript

Ett efterbehandlingsskript tar emot SABnzbds positionsargument och SAB_*-miljövariabler - det stora ekosystemet av SAB-skript körs som det är.

11 · Sonarr, Radarr & vänner

nzbfast talar SABnzbd-API:et native, så varje *arr fungerar direkt - och den kan agera som deras indexerare också.

Som nedladdningsklient

1. I Sonarr/Radarr: Settings → Download Clients → lägg till SABnzbd.
2. Host: din nzbfast-maskin · Port: 6789 · API-nyckel: din fullständiga API-nyckel (var du hittar den: §2).
3. Kategori efter önskemål (t.ex. tv / movies). Test → grön bock → Save.

Kö, historik, status per jobb, "remove & delete", nytt försök och kategoriroutning beter sig alla som *arr-verktygen förväntar sig.

Som en indexerare (newznab)

1. Settings → Indexers → lägg till Newznab.
2. URL: http://<host>:6789/ · API-sökväg: /api · nyckel: din API-nyckel.
3. nzbfast serverar caps-, search-, tvsearch- och movie-frågor från sitt eget index över dina bevakade grupper, och /getnzb/<id> lämnar tillbaka NZB:en.

12 · Telefon & fjärrappar

nzbfast implementerar båda de stora fjärrstyrningsprotokollen, så nästan varje mobil-/surfplatteapp fungerar. Välj det protokoll din app stödjer:

Appar som talar NZBGet (nzb360, LunaSea, NZB Unity…)

Hela JSON-RPC-ytan som dessa appar använder serveras: status, kö med omordning/paus/radering, historik, add-NZB, hastighetsgräns, paus/återuppta, logg.

Appar som talar SABnzbd

Instrumentpanelen på din telefon

Öppna bara http://<machine>:6789 i en mobilwebbläsare - hela instrumentpanelen och väggen har en touchlayout. Panelen Inställningar → Fjärråtkomst visar de exakta URL:erna och en QR-kod att skanna.

Nå nzbfast utifrån

Det finns ingen inloggningssida, och det är avsiktligt. En inloggning med sessionscookie är en säkerhetsyta att underhålla för alltid, och den skulle ändå vara det svagaste låset på något som står mot öppna internet. nzbfast autentiserar i stället med din API-nyckel, och tar emot nyckeln både i en förfrågningsrubrik och i URL:en (X-Api-Key eller Authorization: Bearer) - vilket är just det som låter något framför sköta inloggningen ordentligt.

Enklast är att inte publicera den alls. Installera Tailscale på den här datorn och i telefonen så hamnar båda i samma privata nät: ingenting exponeras, ingen router eller certifikat behöver röras, och Inställningar → Fjärråtkomst visar en adress som fungerar överallt så snart Tailscale körs. Välj det här om du inte uttryckligen behöver en publik domän.

Om du behöver det, sätt en omvänd proxy framför, ge den certifikatet och låt den sköta autentiseringen. Starta nzbfast med --bind 127.0.0.1 så att proxyn är enda vägen in, och peka proxyn mot 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ägg på det din proxy erbjuder: basic auth, en forward-auth-tjänst som Authelia eller Authentik, eller klientcertifikat. En sak överraskar alla - Sonarr, Radarr och telefonapparna kan inte genomföra en webbläsarinloggning, så lämna dem en väg förbi. De flesta proxyer kan släppa igenom en förfrågan med en giltig X-Api-Key-rubrik och kräva autentisering för allt annat.

13 · Prestandaverktyg

Systembenchmark

Ett klick mäter dina tre tak - nätverkshastighet (en riktig 8-sekunders multi-anslutningsprob), CPU-verifieringshastighet och diskskrivhastighet - och leder med svaret: din förväntade maximala nedladdningshastighet och vilket tak som är gränsen. Den kortaste stapeln är din flaskhals; de andra visar sin marginal. Schemalägg den (var 6:e h → veckovis) så loggas varje körning till en historiktabell, så att du kan se när din provider, ISP eller hårdvara ändrade beteende. Schemalagda körningar sker bara medan kön är i vila.

Anslutningstrimning

Mäter en provider vid stigande antal anslutningar och rekommenderar inställningen - fler sockets hjälper tills providern eller din linje mättas, och vissa providers bestraffar överbegäran. Testa alla jämför varje provider och kör dem sedan alla ihop för att kontrollera att poolen mättar din linje.

Serverdiversitet

STAT-provtar artiklar över olika åldrar på varje server och klustrar providers efter gemensamma luckor: providers med ~100 % gemensamma saknade artiklar är samma backbone (redundanta för återställning); oberoende sådana breddar verkligen din täckning. Slutar med en rekommendation i klartext.

Automatisk köintelligens

• Auto-uppskjutning: en nedladdning som stapplar på en enda långsam server medan andra jobb väntar parkeras sist (journalen behåller dess förlopp) och försöks igen när kön är fri.
• Prefetch på lediga servrar: servrar som inte kan hjälpa det aktiva jobbet (deras kopior är borta) börjar under tiden ladda ner nästa köade jobb. Ingen annan klient gör överlappning mellan jobb.
• Överlappning mellan jobb: medan ett färdigt jobbs svans (verifiering/uppackning) blir klar på disken äger nästa jobbs nedladdning redan linjen.

Tillgänglighetsoraklet

Takedowns är det främsta skälet till att en Usenet-nedladdning misslyckas, och de går att förutse: samma release försvinner hos en backbone medan en annan fortfarande har den. nzbfast för ett litet register över vad dina egna leverantörer faktiskt har svarat för, och lägger en pytteliten vilobudget på STAT-sonderingar (några hundra i timmen per server, aldrig under en nedladdning) för att hålla det aktuellt. Den laddar aldrig ner nyttolast för att ta reda på det.

Vad du får ut av det:

• Ett tillgänglighetsutlåtande på väggens brickor och indexets rader (§6): gult ”?” för osäkert hos dina leverantörer, rött för säkert borta. Ingen markering betyder att det ser bra ut.
• En rensad-markering på grupper där färska poster redan tas bort, så att du kan skilja en döende grupp från en otursförföljd release.
• Hoppa över providers som oraklet dömt ut (Inställningar, av som standard, experimentell): när kontrollen är säker på att en leverantörs backbone har tappat en release hoppas den över direkt för den nedladdningen i stället för att man väntar in misslyckandet. Din sista kvarvarande leverantör hoppas aldrig över.

Utlåtandet är en förutsägelse från indicier, inte en garanti. För ett hårt svar om en enskild NZB räknar nzbfast check (§15) de faktiska artiklarna.

Minnesbudget - och vad lite minne kostar

Alla motorns cachar delar en budget (standard ¼ av fysiskt RAM, begränsad till 256 MB–16 GB). Sätt den uttryckligen med Minnesgräns i Inställningar, eller --mem-limit på kommandoraden.

nzbfast är byggd för att suga upp ditt nätverk och din disk samtidigt, och RAM är det som låter den göra båda i ett pass: artiklar avkodas, verifieras och skrivs rakt till sina slutliga offset, så arkivvolymer behöver aldrig röra disken alls. Svält den på minne och inget går sönder - varje cache har en spill-väg, och motorn degraderar till mer disk-I/O i stället för att swappa eller misslyckas. Men det spillet är inte gratis, och på stora jobb kan du mäta det.

Uppmätt på en maskin och en linje (M1 Ultra, 10 GbE), samma filer vid varje budget. Varje körning gav ett korrekt, fullt verifierat, uppackat resultat:

Toppminnet följer budgeten, inte jobbet: den 190 GB-nedladdningen blir klar i ungefär 1.1 GB RAM. Det du byter mot det är tid - och bara på stora jobb.

• Upp till ~35 GB är lite minne gratis. Arbetsuppsättningen får plats oavsett, så en 4 GB-maskin blir klar med ett sådant jobb lika snabbt som en 64 GB-maskin.
• Förbi ~87 GB betalar du 20–40 % - men bara när din linje springer om din disk. Verifieringsblock och arkivvolymer som skulle ha stannat i RAM skrivs ut och läses tillbaka i stället, och det kostar bara tid om nätverket kan leverera snabbare än disken hinner absorbera den extra trafiken. De 20–40 % ovan mättes på 10 GbE; samma 87 GB-jobb vid samma budgetar på en ~2.4 Gbps-linje visade ingen straffavgift alls (−1 till +7 %, inom brus mellan körningar). Straffet är en funktion av hur långt linjen springer om disken, inte av jobbstorleken - på en typisk hemuppkoppling är en liten budget nära gratis även på mycket stora jobb.
• Straffet planar ut. När ett jobb är stort nog att spilla spiller varje begränsad budget ungefär lika mycket - 2 GB-, 1 GB- och 256 MB-körningarna läser tillbaka i stort sett samma antal block från disk, och blir klara inom brus av varandra. Så lite mer RAM under tröskeln som helt undviker spill köper inte tillbaka kostnaden: ge den nog för att hålla jobbet i minnet, annars spelar den exakta siffran knappt någon roll.

På en liten NAS, sänk även Anslutningar (2–4) tillsammans med budgeten. Vid en 256 MB budget och 2 anslutningar stannar toppminnet nära 190 MB - bekvämt inom vad en 2 GB NAS har till övers. Var medveten om att det då är antalet anslutningar, inte minnet, som begränsar dig: samma 35 GB-jobb tog 286 s i stället för 65 s. Det är den ärliga formen på avvägningen - den blir alltid klar, och korrekt; den kommer bara inte att mätta linjen.

Benchmarks körs om för varje utgåva; metod och siffror per maskin publiceras vid sidan av resultaten.

14 · Uppdateringar

• Uppdateringar är endast avisering: nzbfast laddar aldrig ner eller byter ut sin egen binär, och det finns ingen kod i den som kan. När en ny version finns visar sidhuvudet ⬆ v X tillgänglig - ladda ner; chippen länkar till den officiella nedladdningssidan (länken är fast i appen, den kommer aldrig från uppdateringsmanifestet). Installera den nya versionen på samma sätt som du installerade den nuvarande.
• nzbfast söker efter nya versioner två gånger om dagen. Stäng av Sök efter uppdateringar (Inställningar) så kontaktar den aldrig uppdateringsmanifestet; en tom URL för uppdateringskontroll gör detsamma.

Uppdatera utan att förlora dina inställningar

En regel täcker varje installation: en uppdatering byter ut programmet, aldrig dina inställningar. Allt du har konfigurerat - servrar, sökvägar, API-nyckeln, kön - bor i en handfull filer i en enda mapp (§17), och ingen installerare, image-hämtning eller paketuppgradering rör den mappen. När inställningar ändå ser borta ut efter en uppdatering är det nästan alltid för att den nya installationen läser en annan, tom mapp, inte för att något raderades; de gamla filerna ligger kvar där de alltid har legat. §18 har återställningsstegen.

15 · Kommandoraden

Allt daemonen gör går också att skripta. De vardagliga kommandona:

Även tillgängliga: inspect, probe, bench, bench-cpu, soak, fetch, spots/spot-search/spot-get (Spotnet), predb-seed (fyller pre-databasen med tiden före flödet slogs på), make-release-nzb/make-test-nzb (testfixturer). Varje kommando tar --config och --help. Till dem kommer post: den laddar upp filer som yEnc-artiklar och skriver den matchande NZB:n. Ett driftverktyg; det kräver ett uttryckligt --post-server och väljer aldrig server åt dig.

16 · API-översikt

Bas-slutpunkt: http://host:6789/api?mode=…&apikey=…&output=json - SABnzbd-kompatibel, så befintliga SAB-integrationer fungerar oförändrade. Två nycklar: API-nyckeln (full kontroll) och NZB-nyckeln (enbart tillägg: addfile/addurl). addnzblnk ingår med flit inte i uppsättningen för enbart tillägg: att lösa upp en länk kan förbruka mätt indexerarkvot, vilket en nyckel för enbart tillägg inte har med att göra.

17 · Filer & platser

Var inställningsmappen ligger beror på hur nzbfast installerades. Denna enda mapp rymmer allt som är värt att säkerhetskopiera:

Och vad som finns i den:

18 · Felsökning

nzbfast - den här handboken följer med varje utgåva. Inställningar, slutpunkter och standardvärden som refereras här matchar den version den levererades med.