⚡ 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:

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-setup-<version>.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 informationKö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
TipsKör du redan SABnzbd eller NZBGet? Slipp skriva in inloggningsuppgifter: Inställningar → Usenet-servrar → Importera från SABnzbd / NZBGet… hittar din befintliga installation och kopierar över dess servrar. Det finns också nzbfast import-sab på kommandoraden.

3 · Så fungerar nzbfast

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

TermBetydelse
Provider / serverEn Usenet-tjänst du har ett konto hos (Newshosting, Eweka, XS News…). Var och en tillåter ett visst antal samtidiga anslutningar.
BackboneInfrastrukturen bakom en provider. Flera varumärken återförsäljer ofta samma backbone - bra att veta, eftersom två providers på en backbone saknar samma artiklar. Se Serverdiversitet.
NZBEn liten XML-fil som listar artiklarna som utgör ett inlägg. Det är detta du matar nzbfast med.
PAR2Återställningsdata som postas vid sidan av en release. nzbfast verifierar mot den under nedladdningen och reparerar automatiskt när artiklar är skadade eller saknas.
Store-mode-RARDe flesta releaser packas i RAR-volymer utan komprimering. nzbfast känner igen detta och skriver innerfilen direkt till dess slutliga plats under nedladdningen - inget uppackningssteg efteråt.

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:

JobbstorleknzbfastNZBGet 26.2SABnzbd 5.0.4
7 GB13.7 s+26%+39%
35 GB67 s+61%+325%
87 GB272 s+36%+160%
190 GB9 m 00 s+30%+111%

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:

Kraschåterupptagning, uppmättDöda en nedladdning mitt i (kill -9 vid 15 GB av ett 34.5 GB-jobb) och återupptagningen hämtar om ~0.3 GB - bara artiklarna som faktiskt var i luften vid dödandet - mot NZBGets 0.2 GB i samma test. Detta brukade vara en förlust vi publicerade (15.3 GB hämtat om, när journalen inte kunde redogöra för direktuppackade byte); placeringsjournalen fixade det: återupptagningen återställer de bytena från de lokala utfilerna och verifierar varje återställd byte mot PAR2-blockkartan innan den litar på den. Varje scenario vi förlorar publiceras vid sidan av vinsterna, med hela metoden och råa siffror.

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

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.

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 med status, storlek, plats; 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.

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

MetodSå här
Dra & släppSläpp en eller flera .nzb-filer var som helst på instrumentpanelen.
BevakningsmappAnge en mapp i Inställningar; varje .nzb som sparas i den plockas upp inom 5 sekunder och filen tas bort. Rikta din webbläsares nedladdnings- mapp mot den för grabbar med ett klick från indexersidor.
Från en URLKlistra in en NZB-länk (API mode=addurl, eller via valfri ansluten app).
Bläddra i indexetKlicka på valfri komplett release i Bläddra-kortet.
Bevakningslista / RSSAutomatiskt - se Automatisering.
Sonarr/Radarr m.fl.De skickar grabbar rakt till kön - se §11.
Kommandoradennzbfast get file.nzb laddar ner utan daemonen.

Kategorier, prioriteter, lösenord

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.

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.

SpelarnotisVLC, IINA, mpv och Infuse öppnar alla /stream-URL:er. För att kontrollera från en annan maskin, använd din maskins LAN-adress i stället för localhost.
AutentiseringsnotisMed en API-nyckel satt kräver öppning av en parkerad biblioteks- post över /stream/<id> en token per jobb (?t=…) - spelare kan inte skicka API-nycklar, så /m3u-överlämningen och .strm-pekaren bäddar in den åt dig; att skapa den (/m3u) kräver nyckeln. Rå byte-servering av en redan aktiv nedladdning förblir öppen, och nyckellösa installationer beter sig som förr.

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:

FältAnmärkningar
Host / portAnvänd SSL-port 563. TLS kostar inget mätbart - nzbfast krypterar alltid.
Användarnamn / lösenordLagras lokalt i config.local.json, visas aldrig tillbaka till webbläsaren. Att lämna lösenordet tomt vid redigering behåller det sparade.
AnslutningarSamtidiga anslutningar per server. Använd Anslutningstrimning (§13) för att hitta varje providers optimala punkt i stället för att gissa högt.
Nivå (tier)0 = primär; högre nivåer är fyllnadsservrar, som bara tillfrågas om artiklar varje lägre nivå missat. Sätt obegränsade konton på 0, blockkonton på 1+.
Blockstorlek (GB)För block-konton (betala per GB): nzbfast spårar livstidsförbrukning mot detta och slutar använda servern när den är slut (varning vid 85 %).

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.

NyckelNoteringar
bind_ipBinder den här serverns utgående anslutningar till en bestämd lokal adress, för maskiner med flera utgångar och delade VPN-tunnlar. Adressfamiljen väljer också målfamiljen: en v4-bindning ansluter till serverns v4-adress.
socks5Skickar den här serverns NNTP-trafik genom en SOCKS5-proxy: host:port, eller user:pass@host:port. Värdnamnet slås upp av proxyn, så det blir ingen lokal DNS-läcka.
RekommendationTvå providers på olika backbones slår tre på samma. Kör Serverdiversitet (§13) för att se vilka av dina providers som faktiskt breddar din täckning och vilka som är redundanta kopior av varandra.

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

InställningVad den gör
HastighetsgränsTak i byte/sek (50M, 1G, 0 = obegränsat). Fjärrappar kan skicka procenttal - sätt Linjehastighet så att de översätts korrekt.
Auto-hastighetRTT-styrt tak som ger plats åt annan hushållstrafik och breder ut sig igen när linjen är tyst.
Skjut upp långsamma nedladdningar automatisktEtt jobb som fastnat på en långsam server medan andra väntar flyttas sist i kön (förloppet behålls). Se §13.
Prefetch på lediga servrarServrar som är onyttiga för det aktiva jobbet startar nästa köade. Se §13.
Auto-uppdatering / URL för uppdateringskontrollSe §14.
LinjehastighetDin anslutnings nominella hastighet - möjliggör procentuella gränser från SABnzbd-kompatibla appar.
VeckoschemaRadredigerare för regler per veckotid: pausa, återuppta eller sätt en hastighetsgräns vid givna dagar/tider (lokal tid). T.ex. begränsa till 20 MB/s vardagar 9–17, obegränsat annars.

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.

Snabbverifiering (CRC32) (på som standard) gör anspråk på PAR2-block via CRC32 medan nedladdningen fortfarande pågår, vilket är 2-3x snabbare på en långsam processor. Varje artikels egen kontrollsumma verifieras ändå, och den avslutande omgången använder alltid full MD5: ingenting offras i korrekthet. Kryssa ur för att räkna MD5 per block även under nedladdningen.

Disk & kvot live

Minsta lediga utrymme (pausa nya jobb under 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.

InställningVad den gör
Ta med upplösningLägger 1080p, 2160p… i namnet. På som standard; de andra fyra märkena är av.
Ta med videocodecx265, x264, AV1
Ta med ljudcodecAtmos, DTS-HD, AC3
Ta med källaBluRay, WEB, REMUX
Ta med releasegruppMärket -GROUP på slutet.
Ta bort skräpfilerPå som standard. Raderar kvarblivna .par2, .nzb, .sfv, .nfo och samplingsklipp ur färdiga film- och seriemappar. Aldrig videon eller dess undertexter.
Behåll bara mediefilenAv som standard, och destruktiv: raderar permanent allt i mappen utom videon (eller videorna) och undertexterna. Varje avsnitt i ett säsongspaket behålls. Går före Ta bort skräpfiler när båda är på.

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.

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).

Indexering live

InställningVad den gör
GrupperNewsgroups som den inbyggda indexeraren skannar (t.ex. alt.binaries.teevee).
SkanningsintervallSekunder mellan pass (standard 900).
Backfill-artiklarHeaders som hämtas vid en grupps allra första skanning.
Fördjupa per skanningVarje pass indexerar även så här många äldre artiklar och bygger ut din sökbara historik i bakgrunden tills Max ålder nås (standard 200 000 per pass ≈ tiotals miljoner artiklar per dygns drifttid).
Max ålderIgnorera poster äldre än detta (90d, 6m, 2y) - begränsar indexstorlek och skanningstid.
Gallra till åldersfönstretPå som standard. Raderar även redan lagrade releaser när de blir äldre än Max ålder, så att indexet håller ungefär det fönstret i stället för att växa för alltid. Av = bara nya poster filtreras och det som redan lagrats blir kvar. Döda skräpfragment (dolda, fortfarande ofullständiga efter en vecka) rensas i vilket fall.
Ingest-filterJSON-regler som filtrerar vad som kommer in i indexet: typer (obfuskerat skräp släpps som standard), år/upplösning/språk, storleksgränser.
Skanna nu / djup omskanningKör ett pass direkt; med ett djup, skanna om så här många färska headers.
OMDb-nyckel / metadatauppdatering / raderaBerikningskontroller för väggen (§6). Radera bygger om databasen från grunden - återställningsvägen om den någonsin blir korrupt.

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. 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: inställningar utan kontroll i panelen

Fyra inställningar har varken en kontroll i gränssnittet eller en flagga på kommandoraden. Sätt dem via API:et (§16), t.ex. /api?mode=config&name=verify_mode&value=lean&apikey=…. Precis som alla andra sparas de i settings.json.

NamnVad den gör
verify_modefull | fast | lean (standard fast). lean är knuffen för långsamma processorer: som fast, men hoppar dessutom över yEnc-CRC per artikel så snart PAR2 täcker en fil, vilket ger ett CRC32-lager i stället för två. Nedladdningar utan PAR2 behåller sina artikel-CRC:er, och verifiering och reparation i slutet av jobbet är oförändrade i båda fallen. Snabbverifiering ovan är samma kontroll för full mot fast.
auto_retry_minsVäntetid före det enda automatiska omförsök som ett första misslyckande med saknade artiklar får (standard 20). Propagationsfördröjning är en verklig orsak till saknade artiklar och löser sig själv; tack vare journalen hämtar omkörningen bara det som fortfarande saknas. Misslyckanden på grund av lösenord eller takedown kvalificerar sig aldrig.
index_scan_parHur många grupper indexeraren skannar parallellt (standard 3, begränsat till 1-8).
oracle_sampleTillgänglighetsoraklets STAT-budget i vila (§13), sonderingar per timme och server. Standard 300, max 3600, 0 stänger av samplingen helt.

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 (Inställningar → Säkerhet; QR/kopieringskontrollen finns bredvid den).
  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.
Varför bry sig?En självhostad indexerare av exakt de grupper du bryr dig om: inga konton, inga gränser för API-anrop, retention så djup som du låter den skanna.

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…)

Fält i appenVärde
TypNZBGet
Host / portdin maskin : 6789
Användarnamnvad som helst (t.ex. nzbfast)
Lösenorddin API-nyckel

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

Fält i appenVärde
TypSABnzbd
Host / portdin maskin : 6789
API-nyckeldin API-nyckel (eller NZB-nyckeln för åtkomst med enbart tillägg)

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.

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

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:

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:

JobbstorlekGott om RAM2 GB budget
≈ 8 GB maskin
1 GB budget
≈ 4 GB maskin
256 MB budget
≈ 2 GB NAS
7 GB15 s15 s15 s15 s
35 GB65 s70 s70 s65 s
87 GB148 s206 s +39%196 s +32%180 s +22%
190 GB330 s427 s +29%402 s +22%411 s +25%

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.

RekommendationGe nzbfast ungefär 2 GB budget per 100 GB av det största jobb du laddar ner, och lämna standardvärdet i fred annars - ¼ av RAM är redan rätt svar på de flesta maskiner. I praktiken: 4 GB RAM täcker jobb upp till ~35 GB i full fart; 8–16 GB håller även 100 GB-plus-jobb där; en 2 GB NAS blir klar med vad du än kastar på den, men behandla den som en bakgrundsnedladdare snarare än något som mättar en snabb linje.

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

15 · Kommandoraden

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

KommandoSyfte
nzbfast setupInteraktiv serverkonfiguration.
nzbfast serveKör daemonen (instrumentpanel + API + automatisering). --open öppnar webbläsaren; se --help för hela flagglistan - varje inställning på instrumentpanelen har en flaggtvilling.
nzbfast get file.nzbLadda ner en NZB, hela rörledningen, ingen daemon. --preflight avbryter tidigt om inlägget inte kan slutföras; --password för krypterade set.
nzbfast check file.nzbTillgänglighetsutlåtande - COMPLETE / REPAIRABLE / IMPOSSIBLE - utan att ladda ner nyttolast.
nzbfast verify DIRVerifiera filer mot PAR2-setet i en katalog.
nzbfast sysbenchSystembenchmarken + diversitetsrapporten, i terminalen.
nzbfast index / searchSkanna grupper till indexet / sök i det, utan daemonen.
nzbfast import-sabImportera servrar från en SABnzbd-ini.

Även tillgängliga: inspect, probe, bench, bench-cpu, soak, fetch, spots/spot-search/spot-get (Spotnet), 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).

OmrådeLägen
queue (med name=delete/pause/resume/priority/switch), pause, resume, addfile, addurl, retry, set_password
Infohistory, status/fullstatus, stats, version, server_stats, usage, log, warnings
Konfigget_config, config&name=<setting>&value=… (varje inställningsfält), server_save/delete/test/enable/reorder, import_probe/apply
Index & väggindex_search, index_get, index_stats, index_scan_now, wall, wall_search/fix/refresh/art, plus newznab på /api?t=caps|search|tvsearch|movie och /getnzb/<id>
Automatiseringwatchlist, watchlist_check_now, watch_calendar, feeds, smart_folders, schedule
Diagnostiksysbench, bench_history, connladder, pooltest, diversity, update_check, update_apply
NZBGet JSON-RPC/jsonrpc - status, listgroups, history, append, editqueue, rate, pause, log (Basic auth: valfri användare, API-nyckel som lösenord)
Förhandsgranskning / uppspelning/stream/<nzo_id> (HTTP-ranges; att starta ett parkerat biblioteksjobb kräver ?t=-token eller nyckel), /m3u/<id> (kräver nyckel; skapar token), /wall, /art/…

17 · Filer & platser

FilInnehåll
config.local.jsonServerinloggningar och alternativ per server. Skapas av guiden; redigerbar i Inställningar. Håll den privat.
settings.jsonVarje inställning som ändrats på instrumentpanelen. Ligger bredvid config; UI-värden åsidosätter kommandoradsflaggor. Radera en nyckel (eller filen) för att falla tillbaka på flaggor/standardvärden.
index.dbReleaseindexet (SQLite) + väggmetadata. Säkert att radera - det byggs om från skanning (Inställningar → Indexering → Radera gör detta åt dig).
<config>/.spool/Kötillstånd (överlever omstarter), NZB:er per jobb, förbrukningsjournal, benchmark-historik, cache för posteromslag.
ArtikeljournalInuti varje jobbs utmapp medan det är ofullständigt - driver kraschåterupptagning och nytt försök. Tas bort vid framgång.
Externa verktygInga behövs - RAR-uppackning och PAR2-reparation är native. Om ett exotiskt set någonsin behöver en extern unrar eller par2 som reserv letar nzbfast bredvid sin körbara fil, sedan på $PATH.

18 · Felsökning

SymptomKontrollera
Långsamma nedladdningarKör Systembenchmark - den namnger flaskhalsen rakt av. Om det är nätverket: kör Anslutningstrimning, kontrollera antalet anslutningar per server och bekräfta att dina providers inte alla är en och samma backbone (Serverdiversitet).
Långsam bara på mycket stora jobb
(NAS eller maskin med lite RAM)
Förväntat, och mätbart: en svält minnesbudget spiller cachar till disk och kostar 20–40 % förbi ~87 GB. Se Minnesbudget för siffrorna och hur mycket RAM du ska ge den. Mindre jobb påverkas inte.
Nedladdning misslyckas "articles missing"Inlägget har gått ut eller togs ner på dina providers. En andra provider på en annan backbone räddar de flesta av dessa. nzbfast check förutsäger detta innan nedladdning. Och väggen märker ut de sannolikt borttagna i förväg med sin tillgänglighetsprick (§13). Ett första misslyckande av den här formen görs om en gång av sig självt efter en väntetid, eftersom propagationsfördröjning ser likadan ut och löser sig själv.
Färdigt arkiv vill ha ett lösenordHistorikraden visar 🔑 - ange lösenordet där; jobbet blir klart på plats.
Sonarr/Radarr kan inte anslutaPort 6789 nåbar? API-nyckel korrekt (full nyckel, inte NZB-nyckel)? Klienttyp satt till SABnzbd?
Bläddra-kortet förblir litetIndexeraren växer i bakgrunden - kontrollera att grupper är satta i Inställningar → Indexering, och ge Fördjupa per skanning tid att samla historik. "Skanna nu" tvingar fram ett pass; statusraden visar live-förlopp.
Väggen visar fel/inget omslagDetaljblad → ✎ Korrigera matchning eller ↻ Uppdatera metadata. Filmuppslag blir bättre med en gratis OMDb-nyckel.
Daemonen vill inte starta: porten upptagenEn annan instans körs - eller ändra --port.
Var finns loggarna?Logg-kortet på instrumentpanelen, eller terminalen/loggfilen du startade serve med.
Fortfarande fast?Logg-kortet namnger oftast boven - inkludera dess svans när du rapporterar ett problem, tillsammans med din nzbfast --version.

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.