⚡ nzbfast

Den raske Usenet-nedlasteren - brukerhåndbok

1 · Velkommen

nzbfast laster ned fra Usenet så raskt som linjen, leverandørene og maskinen din tillater - og som regel betyr det så raskt som linjen din. Det er ett enkelt selvstendig program: motoren, et web-dashbord, en plakatvegg-mediebrowser, en innebygd indekserer, forhåndsvisning i sanntid, native PAR2-reparasjon og native RAR-utpakking ligger alt inni én kjørbar fil. Det er ingenting annet å installere.

Det som gjør den rask, er arkitektur - ikke finjustering:

Målt mot feltet på identisk maskinvare, jobber og leverandører har nzbfast fullført en 190 GB-nedlasting på rundt 5 minutter på en 10 GbE-linje - med de ledende alternativene 30–220 % bak på de samme testene, der de fullførte dem i det hele tatt. Tallene står i §3.

2 · Hurtigstart

macOS

  1. Åpne nzbfast-<version>-macos.dmg og dra NzbFast inn i Programmer (universal: Apple Silicon + Intel).
  2. Første oppstart: macOS advarer om at nzbfast ennå ikke er Apple-notarisert. Høyreklikk appen → Åpne - eller åpne Systeminnstillinger → Personvern og sikkerhet, bla ned og klikk Åpne likevel. Dette er et engangssteg.
  3. App-vinduet viser dashbordet med et velkomstkort - klikk på det og legg til minst én Usenet-server (host, port 563, brukernavn, passord). Du kan legge til flere senere i Innstillinger.
  4. Slipp en .nzb hvor som helst på dashbordet - eller bare dobbeltklikk .nzb-filer i Finder. Nedlastinger havner i ~/Downloads/nzbfast. Avslutt fra menyen; nedlastinger fortsetter der de slapp.

Foretrekker du ingen app? Den rene zip-en (binær + Start nzbfast.command-launcher, samme motor) fungerer fortsatt som før - steg nedenfor under «Fra en terminal».

Windows

  1. Kjør nzbfast-setup-<version>.exe. Den installerer kun for din bruker (ingen administratorpassord). Fordi denne utgaven ennå ikke er kodesignert, kan SmartScreen vise «Windows beskyttet PC-en din» - klikk Mer infoKjør likevel.
  2. nzbfast bor i systemstatusfeltet: dobbeltklikk statusikonet (eller bruk Åpne dashbord i høyreklikkmenyen) for å åpne dashbordet, og legg så til Usenet-serveren din fra velkomstkortet. Statusfeltmenyen har også Pause/Fortsett, nedlastingsmappen din og Avslutt.
  3. Dobbeltklikk på en .nzb-fil legger den i kø. Windows Defender kan spørre én gang om å tillate lytting på lokalnettet - tillat det.

Foretrekker du en portabel kopi? -windows-x64.zip fungerer fortsatt: pakk ut hvor som helst og dobbeltklikk nzbfast.exe (eller Start nzbfast.bat) for terminalveiviseren.

Fra en terminal (alle plattformer)

nzbfast setup            # interactive server setup (writes config.local.json)
nzbfast serve --open     # start the daemon and open the dashboard
TipsKjører du allerede SABnzbd eller NZBGet? Slipp å taste inn legitimasjon: Innstillinger → Usenet-servere → Importer fra SABnzbd / NZBGet… finner den eksisterende installasjonen din og kopierer over serverne. Det finnes også nzbfast import-sab på kommandolinjen.

3 · Slik fungerer nzbfast

Et raskt ordforråd så resten av håndboken blir lett å lese:

BegrepBetydning
Leverandør / serverEn Usenet-tjeneste du har en konto hos (Newshosting, Eweka, XS News…). Hver tillater et visst antall samtidige tilkoblinger.
BackboneInfrastrukturen bak en leverandør. Flere merker videreselger ofte samme backbone - nyttig å vite, fordi to leverandører på én backbone mangler de samme artiklene. Se Servermangfold.
NZBEn liten XML-fil som lister opp artiklene som utgjør en post. Det er dette du mater nzbfast.
PAR2Gjenopprettingsdata som postes sammen med en utgivelse. nzbfast verifiserer mot den underveis i nedlastingen og reparerer automatisk når artikler er skadet eller mangler.
Store-mode-RARDe fleste utgivelser pakkes i RAR-volumer uten komprimering. nzbfast gjenkjenner dette og skriver den indre filen rett til sin endelige plassering mens den laster ned - ingen utpakking i etterkant.

Pipelinen kjører nedlasting → dekoding → verifisering → utpakking samtidig. Pipeline-kortet på dashbordet viser alle tre banene i bevegelse på én gang. Når den siste byten kommer, er verifiseringen allerede ferdig og filen allerede pakket ut; en typisk jobbs «etterbehandlingstid» er null. Hvis reparasjon trengs, er det først da volumer materialiseres til disk, repareres på stedet av den native GF(2¹⁶)-motoren (data som er omdøpt eller byte-forskjøvet og obfuskert, blir funnet og adoptert av en glidende blokkskanning) og pakket ut på nytt - alt automatisk.

Avbrutte nedlastinger (krasj, strømbrudd, kill -9) fortsetter fra artikkeljournalen: byte som allerede ligger på disk, hentes aldri to ganger. Journalen registrerer hvor hver artikkels byte fysisk landet - også byte som ble direkte-utpakket inn i den endelige filen - så en gjenopptaking bygger opp igjen fra lokal disk og verifiserer alt den gjenopprettet mot PAR2-blokkartet før den stoler på det.

Hvordan det sammenligner seg

Målt mot SABnzbd 5.0.4 og NZBGet 26.2 på samme maskin, samme leverandører og samme NZB-er, tatt tid til en brukbar fil - nedlasting, verifisering, reparasjon og utpakking alt inkludert, fordi det er da jobben faktisk er ferdig:

JobbstørrelsenzbfastNZBGet 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%

Gapet er etterbehandlingen de andre fortsatt må gjøre etter at den siste byten har landet. Begge konkurrentene ble justert for sammenligningen, ikke latt stå på standardverdier - SABnzbd leveres særlig med forespørsel-pipelining av, noe som koster den dyrt, så den ble slått på.

To forskjeller betyr like mye som tidene:

Krasj-gjenopptaking, måltDrep en nedlasting midt i flukten (kill -9 ved 15 GB av en 34,5 GB-jobb), og gjenopptakingen henter på nytt ~0,3 GB - bare artiklene som faktisk var underveis ved drepingen - mot NZBGets 0,2 GB i samme test. Dette pleide å være et tap vi publiserte (15,3 GB hentet på nytt, da journalen ikke kunne gjøre rede for direkte-utpakkede byte); plasseringsjournalen fikset det: gjenopptakingen gjenoppretter de bytene fra de lokale utdatafilene og verifiserer hver gjenopprettet byte mot PAR2-blokkartet før den stoler på det. Hvert scenario vi taper, publiseres sammen med seirene, med full metode og rådata.

4 · Dashbordet

Åpne http://localhost:6789 (eller maskinens adresse fra en annen enhet - telefonlayouten tilpasser seg automatisk). Alt oppdateres live, én gang i sekundet. Kortene, ovenfra og ned:

Toppfelt

Gjennomstrømning

Live MB/s med et rullende diagram; de stiplede vannmerkene markerer denne øktens høyeste/laveste, den svake linjen er et glidende gjennomsnitt. Under den viser et histogram hvordan øktens fartsmålinger fordeler seg - typisk vs. topp. Utvid vinduet, så viser diagrammene mer historikk (opptil en time).

Statfliser

Nedlastet denne økten, kødybde, antall fullført/mislykket, øktens toppfart.

Ressurser - én maskin, fire tak

CPU, RAM (mot nzbfasts minnebudsjett), diskskriverate og nettverk på ett normalisert diagram, med reelle verdier i forklaringen og en advarsel om lite diskplass. Ingen annen NZB-klient viser deg dette; det finnes for å bevise et poeng - nzbfast maksimerer linjen din, ikke maskinen din.

Pipeline - stadier overlapper

Tre baner: nedlasting, verifisering (PAR2-blokker sjekket), utpakking. På en sunn jobb beveger alle tre seg sammen.

Leverandører

Live rate per server, tilkoblingsutnyttelse, andel av trafikken, økt-GB og en artikkelfullstendighetsscore over levetiden (farget når en server faller under 98 %). Et stablet arealdiagram viser hver leverandørs bidrag over tid. Radene sorteres om etter live ytelse hvert 10. sekund (konfigurerbart i Innstillinger → Grensesnitt) slik at den raskeste leverandøren din alltid ligger øverst.

Utforsk indeks

Søk i alt den innebygde indeksereren har katalogisert fra de overvåkede gruppene dine (se Automatisering) og last ned med ett klikk - ingen ekstern indekserer nødvendig. Statuslinjen viser skannefremdrift; Skann nå tvinger en runde.

Watchlist

Legg til titler etter navn - også de som ikke er postet ennå. Når en matchende utgivelse dukker opp i indeksen, hentes den automatisk, med kvalitetspreferanser og oppgraderingsregler (en bedre kopi erstatter en dårligere).

Historikk

Nylige nedlastinger med status, størrelse og plassering; mislykkede jobber tilbyr Prøv igjen (fortsetter fra journalen). Krypterte arkiver viser en 🔑 opplåsingskontroll - skriv inn passordet, så blir jobben ferdig på stedet. Verifiseringshelse-stripen tegner defekte PAR2-blokker per nedlasting - en stigende hale betyr at artikler kommer inn skadet.

Dataforbruk

Daglige søyler per leverandør og totaler for I dag / 7 dager / 30 dager - essensielt for målte kontoer og blokk-kontoer. Blokk-kontoer viser forbruk over levetiden mot størrelsen sin.

Logg, Systembenchmark, Tilkoblingsjustering, Servermangfold

En innebygd loggviser, og de tre selvmålingsverktøyene beskrevet i Ytelsesverktøy.

5 · Legge til nedlastinger

MetodeHvordan
Dra og slippSlipp én eller flere .nzb-filer hvor som helst på dashbordet.
OvervåkingsmappeAngi en mappe i Innstillinger; enhver .nzb som lagres i den, plukkes opp innen 5 sekunder og filen fjernes. Pek nettleserens nedlastingsmappe hit for ett-klikks-hentinger fra indekserersider.
Fra en URLLim inn en NZB-lenke (API mode=addurl, eller via en tilkoblet app).
Utforsk indeksKlikk på en hvilken som helst fullstendig utgivelse i Utforsk-kortet.
Watchlist / RSSAutomatisk - se Automatisering.
Sonarr/Radarr osv.De sender hentinger rett i køen - se §11.
Kommandolinjenzbfast get file.nzb laster ned uten daemonen.

Kategorier, prioriteter, passord

6 · Plakatveggen

Klikk på 🎬 vegg i toppfeltet. Veggen gjør indeksen din om til en mediebrowser: hver gjenkjente film- og TV-utgivelse som en plakatflis med vurdering, år, sjangere, rollebesetning og sammendrag - newsgroupene dine, som du kan bla i som en katalog.

7 · Forhåndsvisning og verifisering

Du trenger ikke vente til en nedlasting er ferdig for å vite at det er riktig fil. Åpne den mens den laster ned, sjekk at innhold, språk og kvalitet er som forventet, og avbryt tidlig hvis de ikke er det - i stedet for å oppdage det etter hele nedlastingen.

SpillermerknadVLC, IINA, mpv og Infuse åpner alle /stream-URL-er. For å kontrollere fra en annen maskin, bruk maskinens LAN-adresse i stedet for localhost.
AutentiseringsmerknadMed en API-nøkkel satt krever det å åpne en parkert biblioteksoppføring over /stream/<id> et per-jobb-token (?t=…) - spillere kan ikke sende API-nøkler, så /m3u-overleveringen og .strm-pekeren bygger det inn for deg; å lage det (/m3u) krever nøkkelen. Ren byte-servering av en allerede aktiv nedlasting forblir åpen, og nøkkelfrie installasjoner oppfører seg som før.

8 · Usenet-servere

Innstillinger → Usenet-servere er den fulle editoren: legge til, redigere, fjerne, omorganisere og ta en hvilken som helst server inn i eller ut av poolen. Hver server har:

FeltMerknader
Host / portBruk SSL-port 563. TLS koster ingenting målbart - nzbfast krypterer alltid.
Brukernavn / passordLagres lokalt i config.local.json, vises aldri tilbake til nettleseren. Lar du passord stå tomt ved redigering, beholdes det lagrede.
TilkoblingerSamtidige tilkoblinger per server. Bruk Tilkoblingsjustering (§13) for å finne hver leverandørs optimale punkt i stedet for å gjette høyt.
Nivå (trinn)0 = primær; høyere nivåer er fyllservere, som bare spørres om artikler hvert lavere nivå bommet på. Sett kontoer uten grense på 0, blokk-kontoer på 1+.
Blokkstørrelse (GB)For blokk-kontoer (betal-per-GB): nzbfast sporer forbruk over levetiden mot dette og slutter å bruke serveren når den er brukt opp (advarsel ved 85 %).

To andre valg per server har ennå ingen kontroll i dashbordet: skriv dem inn for hånd i den serverens oppføring i config.local.json (se §17) og start på nytt.

NøkkelMerknader
bind_ipBinder de utgående forbindelsene til denne serveren til en bestemt lokal adresse, for maskiner med flere utganger og delte VPN-tunneler. Adressefamilien velger samtidig målfamilien: en v4-binding kobler til serverens v4-adresse.
socks5Sender NNTP-trafikken til denne serveren gjennom en SOCKS5-proxy: host:port, eller user:pass@host:port. Vertsnavnet slås opp av proxyen, så det blir ingen lokal DNS-lekkasje.
AnbefalingTo leverandører på forskjellige backbones slår tre på den samme. Kjør Servermangfold (§13) for å se hvilke av leverandørene dine som faktisk gir bredere dekning og hvilke som er redundante kopier av hverandre.

9 · Innstillingsreferanse

Nesten alt kan stilles inn fra dashbordet, under ⚙ Innstillinger; de fire unntakene er listet nederst i denne delen. Verdier merket live gjelder umiddelbart; restart-verdier ved neste oppstart. Hver endring gjort her lagres i settings.json og overlever omstarter (verdier fra grensesnittet slår flagg på kommandolinjen).

Fart og tidsplan live

InnstillingHva den gjør
FartsgrenseTak i byte/sek (50M, 1G, 0 = ubegrenset). Fjernstyringsapper kan sende prosenter - sett Linjefart slik at de oversettes riktig.
Auto-fartRTT-styrt tak som viker for annen trafikk i husholdningen og utvider seg igjen når linjen er rolig.
Utsett trege nedlastinger automatiskEn jobb som henger på én treg server mens andre venter, flyttes bakerst i køen (fremdriften beholdes). Se §13.
Prefetch på ledige servereServere som er ubrukelige for den aktive jobben, starter den neste i køen. Se §13.
Auto-oppdatering / URL for oppdateringssjekkSe §14.
LinjefartDin tilkoblings oppgitte fart - muliggjør prosentvise grenser fra SABnzbd-kompatible apper.
UkeplanRadeditor for regler etter tid i uken: pause, fortsett, eller sett en fartsgrense på gitte dager/tidspunkt (lokal tid). F.eks. begrens til 20 MB/s på hverdager 9–17, ubegrenset ellers.

Neste nedlasting live

Tilkoblinger (per server), vindu (pipelinedybde per tilkobling), dekodere (parallelle dekodertråder). Avlest når hver jobb starter. Standardverdiene passer for de fleste linjer; bruk justeringsverktøyene før du hever i blinde.

Rask verifisering (CRC32) (på som standard) krever PAR2-blokker via CRC32 mens nedlastingen fortsatt går, noe som er 2-3x raskere på en treg CPU. Hver artikkels egen kontrollsum blir fortsatt verifisert, og den avsluttende runden bruker alltid full MD5: ingenting ofres på korrekthet. Ta bort haken for å kjøre MD5 per blokk under nedlastingen også.

Disk og kvote live

Minste ledige plass (sett nye jobber på pause under den), nedlastingskvote per dag eller måned (UTC; Tving-jobber omgår), minnegrense - motorens RAM-budsjett (standard: ¼ av RAM, avgrenset; hev den på en maskin med mye RAM for maksimal fart på store jobber, og se hva lite minne koster før du senker den) restart.

Flytt fullførte til: etter utpakking, opprydding og navnebytte flyttes ferdige nedlastinger hit - en NAS-deling, en mediedisk, der biblioteket ditt bor. Kategoristrukturen beholdes (en jobb som ble ferdig under tv/ havner under tv/ på målet), og historikken følger med flyttingen, så tilkoblede apper importerer og sletter på det nye stedet. Er målet utilgjengelig når en jobb blir ferdig (delingen nede, tom for plass), blir filene i nedlastingsmappen og jobben fullføres likevel som normalt. Tom = av. Mål per kategori sender bestemte kategorier et annet sted (tv=/Volumes/NAS/TV, movies=/Volumes/NAS/Movies); hver oppført sti er den kategoriens mappe, så det opprettes ingen ekstra kategoriundermappe i den. Kategorier uten oppføring følger Flytt fullførte til.

Dybde for nøstede arkiver (standard 5) er hvor mange lag arkiv-i-arkiv som pakkes ut automatisk: et RAR-sett som inneholder en 7z som igjen inneholder en RAR er vanlig på Usenet, og nzbfast følger kjeden uten en ekstra runde. Ved grensen blir det dypeste arkivet rett og slett liggende, ikke pakket videre ut, og nedlastingen fullfører likevel. Øk den bare for uvanlig dype utgivelser.

Auto-omdøping & opprydding live

Gi ferdige nedlastinger nye navn (på som standard) gir mappen og hovedfilen et rent, informativt navn: en film blir Example Movie (2024), serier beholder Show - S01E02. Tilslørte eller ugjenkjennelige navn blir stående nøyaktig slik de ble postet i stedet for å gjettes.

InnstillingHva den gjør
Ta med oppløsningSetter 1080p, 2160p… i navnet. På som standard; de fire andre merkene er av.
Ta med videokodekx265, x264, AV1
Ta med lydkodekAtmos, DTS-HD, AC3
Ta med kildeBluRay, WEB, REMUX
Ta med utgivelsesgruppeMerket -GROUP til slutt.
Fjern søppelfilerPå som standard. Sletter gjenliggende .par2, .nzb, .sfv, .nfo og sample-klipp fra ferdige film- og seriemapper. Aldri videoen eller undertekstene.
Behold bare mediefilenAv som standard, og destruktiv: sletter permanent alt i mappen bortsett fra videoen (eller videoene) og undertekstene. Hver episode i en sesongpakke beholdes. Går foran Fjern søppelfiler når begge er på.

Hele gruppen kjører etter reparasjon og utpakking og før Flytt fullførte til, og hoppes helt over for en jobb som fortsatt venter på passord. Begge slettetrinnene gjelder bare utgivelser som er gjenkjent som film eller serie: en programvarelast eller et sett som ikke lar seg klassifisere (tilslørt) blir aldri ryddet.

Mapper og behandling

Nedlastingsmappe restart, overvåkingsmappe, etterbehandlingsskript (kjøres etter hver jobb med SABnzbd-kompatible argumenter og SAB_*-miljø - eksisterende SAB-skript fungerer uendret), oppryddingsendelser (søppelfiler som slettes etter fullføring), Smartmapper og TV-arkivering (se §10).

Indeksering live

InnstillingHva den gjør
GrupperNewsgroups den innebygde indeksereren skanner (f.eks. alt.binaries.teevee).
SkanneintervallSekunder mellom rundene (standard 900).
Backfill-artiklerHeadere som hentes ved en gruppes aller første skanning.
Fordyp per skanningHver runde indekserer også så mange eldre artikler, og bygger den søkbare historikken din i bakgrunnen til Maks alder er nådd (standard 200 000 per runde ≈ titalls millioner artikler per oppetidsdøgn).
Maks alderIgnorer poster eldre enn dette (90d, 6m, 2y) - begrenser indeksstørrelse og skannetid.
Trim til aldersvinduetPå som standard. Sletter også allerede lagrede utgivelser når de blir eldre enn Maks alder, slik at indeksen holder omtrent det vinduet i stedet for å vokse i det uendelige. Av = bare nye poster filtreres, og det som er lagret blir stående. Døde søppelfragmenter (skjulte, fortsatt ufullstendige etter en uke) høstes uansett.
InntaksfiltreJSON-regler som filtrerer hva som kommer inn i indeksen: typer (obfuskert søppel forkastes som standard), år/oppløsning/språk, størrelsesgrenser.
Skann nå / dyp ny skanningKjør en runde umiddelbart; med en dybde, skann på nytt så mange nylige headere.
OMDb-nøkkel / metadataoppdatering / slettingKontroller for berikelse av veggen (§6). Sletting gjenoppbygger databasen fra bunnen - løsningen hvis den noen gang blir korrupt.

Bibliotek, Sikkerhet, Grensesnitt

Bibliotek: kategorier som behandles som umiddelbare biblioteksoppføringer + kontrollintervall. Sikkerhet: den fulle API-nøkkelen (alt) og NZB-nøkkelen (kun-legg-til - trygg å gi til indekserersider), begge roterbare live. Grensesnitt: klikklyder, skrivebordsvarsler ved fullføring, intervall for omsortering av leverandører.

Fartsenheter live avgjør hvordan hver hastighet vises i dashbordet: megabyte (MB/s, normen blant nedlastingsprogrammer, standarden) eller megabit (Mb/s, slik leverandører oppgir linjer). Filstørrelser blir stående i byte. Dette er en egenskap ved daemonen, ikke ved nettleseren din, så det gjelder hver enhet som ser på denne installasjonen.

Avansert: innstillinger uten kontroll i dashbordet

Fire innstillinger har verken en kontroll i grensesnittet eller et flagg på kommandolinjen. Sett dem via API-et (§16), f.eks. /api?mode=config&name=verify_mode&value=lean&apikey=…. Som alle andre lagres de i settings.json.

NavnHva den gjør
verify_modefull | fast | lean (standard fast). lean er dyttet for trege CPU-er: som fast, men hopper i tillegg over yEnc-CRC per artikkel så snart PAR2 dekker en fil, altså ett CRC32-lag i stedet for to. Nedlastinger uten PAR2 beholder artikkel-CRC-ene sine, og verifisering og reparasjon på slutten av jobben er uendret uansett. Rask verifisering over er den samme kontrollen for full mot fast.
auto_retry_minsVentetid før det ene automatiske nye forsøket som en første feil med manglende artikler får (standard 20). Propagasjonsforsinkelse er en reell årsak til manglende artikler og løser seg selv; takket være journalen henter omkjøringen bare det som fortsatt mangler. Feil på grunn av passord eller takedown kvalifiserer aldri.
index_scan_parHvor mange grupper indeksereren skanner parallelt (standard 3, begrenset til 1-8).
oracle_sampleTilgjengelighetsorakelets STAT-budsjett i tomgang (§13), sonderinger per time per server. Standard 300, maks 3600, 0 slår av sampling helt.

10 · Automatisering

Watchlist

Den enkleste automatiseringen: legg til en tittel på dashbordet, sett kvalitetspreferanser, ferdig. Nye utgivelser hentes etter hvert som de dukker opp i de indekserte gruppene dine; kopier av bedre kvalitet oppgraderer tidligere hentinger; en kalendervisning viser hva som kommer.

RSS-feeder

Innstillinger → RSS: enhver newznab-/indekserer-RSS-URL med intervall per feed, kategori og filterregler (tittelmønstre, størrelsesgrenser). Matchende elementer lastes ned automatisk.

Smartmapper

Regler som vurderes når en jobb legges til: match etter mønster/stikkord og størrelse, tildel en kategori (første treff vinner). Med TV-arkivering på blir ferdige TV-episoder omdøpt og arkivert som Show/Season 01/Show - S01E02.mkv - plex/Jellyfin-klart uten et eksternt verktøy.

Tidsplanlegger

Ukeplanen (se §9) automatiserer pause/fortsett/fart etter tid på døgnet.

Skript

Et etterbehandlingsskript mottar SABnzbds posisjonelle argumenter og SAB_*-miljøvariabler - det store økosystemet av SAB-skript kjører som det er.

11 · Sonarr, Radarr og venner

nzbfast snakker SABnzbd-API-et nativt, så hver *arr fungerer rett ut av boksen - og den kan fungere som indekserer for dem også.

Som nedlastingsklient

  1. I Sonarr/Radarr: Settings → Download Clients → legg til SABnzbd.
  2. Host: nzbfast-maskinen din · Port: 6789 · API-nøkkel: din fulle API-nøkkel (Innstillinger → Sikkerhet; QR-/kopieringskontrollen står ved siden av den).
  3. Kategori etter ønske (f.eks. tv / movies). Test → grønt merke → Lagre.

Kø, historikk, status per jobb, «fjern og slett», nytt forsøk og kategoriruting oppfører seg alt slik *arr-ene forventer.

Som indekserer (newznab)

  1. Settings → Indexers → legg til Newznab.
  2. URL: http://<host>:6789/ · API-sti: /api · nøkkel: din API-nøkkel.
  3. nzbfast serverer caps-, search-, tvsearch- og movie-forespørsler fra sin egen indeks av de overvåkede gruppene dine, og /getnzb/<id> gir tilbake NZB-en.
Hvorfor bry seg?En egenhostet indekserer av akkurat de gruppene du bryr deg om: ingen kontoer, ingen grenser på API-treff, retention så dyp som du lar den skanne.

12 · Telefon og fjernstyringsapper

nzbfast implementerer begge de store fjernstyringsprotokollene, så nesten hver mobil-/nettbrett-app fungerer. Velg protokollen appen din støtter:

Apper som snakker NZBGet (nzb360, LunaSea, NZB Unity…)

Felt i appenVerdi
TypeNZBGet
Host / portmaskinen din : 6789
Brukernavnhva som helst (f.eks. nzbfast)
Passorddin API-nøkkel

Hele JSON-RPC-flaten disse appene bruker, serveres: status, kø med omsortering/pause/sletting, historikk, legg-til-NZB, fartsgrense, pause/fortsett, logg.

Apper som snakker SABnzbd

Felt i appenVerdi
TypeSABnzbd
Host / portmaskinen din : 6789
API-nøkkeldin API-nøkkel (eller NZB-nøkkelen for kun-legg-til-tilgang)

Dashbordet på telefonen din

Bare åpne http://<machine>:6789 i en mobilnettleser - hele dashbordet og veggen har en berøringslayout. Panelet Innstillinger → Fjerntilgang viser de nøyaktige URL-ene og en QR-kode å skanne.

13 · Ytelsesverktøy

Systembenchmark

Ett klikk måler dine tre tak - nettverksgjennomstrømning (en ekte 8-sekunders fler-tilkoblings-sondering), CPU-verifiseringsrate og diskskrivefart - og leder med svaret: din forventede maksimale nedlastingsfart og hvilket tak som er grensen. Den korteste søylen er flaskehalsen din; de andre viser marginen sin. Planlegg den (hver 6. time → ukentlig) og hver kjøring logges til en historikktabell, så du kan se når leverandøren, ISP-en eller maskinvaren din endret oppførsel. Planlagte kjøringer skjer bare mens køen er inaktiv.

Tilkoblingsjustering

Måler én leverandør ved stigende antall tilkoblinger og anbefaler innstillingen - flere sockets hjelper til leverandøren eller linjen din metter seg, og noen leverandører straffer overspørring. Test alle sammenligner hver leverandør, og kjører dem så alle sammen for å sjekke at poolen metter linjen din.

Servermangfold

STAT-sampler artikler på tvers av aldre på hver server og grupperer leverandører etter felles hull: leverandører med ~100 % felles manglende artikler er samme backbone (redundant for gjenoppretting); uavhengige utvider dekningen din på ekte. Avsluttes med en anbefaling på klart språk.

Automatisk køintelligens

Tilgjengelighetsorakelet

Takedowns er den viktigste grunnen til at en Usenet-nedlasting mislykkes, og de lar seg forutsi: den samme utgivelsen forsvinner hos én backbone mens en annen fortsatt har den. nzbfast fører et lite register over hva dine egne leverandører faktisk har svart for, og bruker et bitte lite tomgangsbudsjett på STAT-sonderinger (noen hundre i timen per server, aldri under en nedlasting) for å holde det oppdatert. Den laster aldri ned nyttelast for å finne det ut.

Hva du får ut av det:

Dommen er en forutsigelse ut fra indisier, ikke en garanti. For et hardt svar om én NZB teller nzbfast check (§15) de faktiske artiklene.

Minnebudsjett - og hva lite minne koster

Alle motorens buffere deler ett budsjett (standard ¼ av fysisk RAM, avgrenset til 256 MB–16 GB). Sett det eksplisitt med Minnegrense i Innstillinger, eller --mem-limit på kommandolinjen.

nzbfast er bygget for å suge til seg nettverket og disken din samtidig, og RAM er det som lar den gjøre begge deler i én omgang: artikler dekodes, verifiseres og skrives rett til sine endelige offset, så arkivvolumer trenger aldri å røre disken i det hele tatt. Sult den på minne, og ingenting ryker - hver buffer har en spill-sti, og motoren degraderer til mer disk-I/O i stedet for å swappe eller feile. Men den spillingen er ikke gratis, og på store jobber kan du måle den.

Målt på én maskin og én linje (M1 Ultra, 10 GbE), samme filer ved hvert budsjett. Hver kjøring produserte et korrekt, fullstendig verifisert, utpakket resultat:

JobbstørrelseRikelig med RAM2 GB-budsjett
≈ 8 GB-maskin
1 GB-budsjett
≈ 4 GB-maskin
256 MB-budsjett
≈ 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ølger budsjettet, ikke jobben: den 190 GB-nedlastingen fullføres på rundt 1,1 GB RAM. Det du bytter mot det, er tid - og bare på store jobber.

AnbefalingGi nzbfast omtrent 2 GB budsjett per 100 GB av den største jobben du laster ned, og la ellers standarden være i fred - ¼ av RAM er allerede det riktige svaret på de fleste maskiner. I praksis: 4 GB RAM dekker jobber opp til ~35 GB på full fart; 8–16 GB holder også 100 GB-pluss-jobber der; en 2 GB NAS vil bli ferdig med alt du kaster på den, men behandle den som en bakgrunnsnedlaster snarere enn noe som vil mette en rask linje.

På en liten NAS, senk også Tilkoblinger (2–4) sammen med budsjettet. Ved et 256 MB-budsjett og 2 tilkoblinger holder toppminnet seg nær 190 MB - komfortabelt innenfor det en 2 GB NAS har til overs. Vær klar over at det er antallet tilkoblinger, ikke minnet, som begrenser deg da: den samme 35 GB-jobben tok 286 s i stedet for 65 s. Det er den ærlige formen på avveiningen - den vil alltid bli ferdig, og bli ferdig korrekt; den suger bare ikke til seg linjen.

Benchmarker kjøres på nytt for hver utgave; metode og per-maskin-tall publiseres sammen med resultatene.

14 · Oppdateringer

15 · Kommandolinje

Alt daemonen gjør, er også skriptbart. De hverdagslige kommandoene:

KommandoFormål
nzbfast setupInteraktivt serveroppsett.
nzbfast serveKjør daemonen (dashbord + API + automatisering). --open åpner nettleseren; se --help for den fulle flagglisten - hver dashbord-innstilling har en flagg-tvilling.
nzbfast get file.nzbLast ned én NZB, full pipeline, ingen daemon. --preflight avbryter tidlig hvis posten ikke kan fullføres; --password for krypterte sett.
nzbfast check file.nzbTilgjengelighetsdom - COMPLETE / REPAIRABLE / IMPOSSIBLE - uten å laste ned nyttelasten.
nzbfast verify DIRVerifiser filer mot PAR2-settet i en mappe.
nzbfast sysbenchSystembenchmarken + mangfoldsrapporten, i terminalen.
nzbfast index / searchSkann grupper inn i indeksen / søk i den, uten daemonen.
nzbfast import-sabImporter servere fra en SABnzbd-ini.

Også tilgjengelig: inspect, probe, bench, bench-cpu, soak, fetch, spots/spot-search/spot-get (Spotnet), make-release-nzb/make-test-nzb (testfiksturer). Hver kommando tar --config og --help. I tillegg kommer post: den laster opp filer som yEnc-artikler og skriver den tilhørende NZB-en. Et driftsverktøy; det krever en uttrykkelig --post-server og velger aldri server for deg.

16 · API-oversikt

Basisendepunkt: http://host:6789/api?mode=…&apikey=…&output=json - SABnzbd-kompatibelt, så eksisterende SAB-integrasjoner fungerer uendret. To nøkler: API-nøkkelen (full kontroll) og NZB-nøkkelen (kun-legg-til: addfile/addurl).

OmrådeModi
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
Konfigurasjonget_config, config&name=<setting>&value=… (hvert Innstillinger-felt), server_save/delete/test/enable/reorder, import_probe/apply
Indeks og veggindex_search, index_get, index_stats, index_scan_now, wall, wall_search/fix/refresh/art, pluss newznab på /api?t=caps|search|tvsearch|movie og /getnzb/<id>
Automatiseringwatchlist, watchlist_check_now, watch_calendar, feeds, smart_folders, schedule
Diagnostikksysbench, bench_history, connladder, pooltest, diversity, update_check, update_apply
NZBGet JSON-RPC/jsonrpc - status, listgroups, history, append, editqueue, rate, pause, log (Basic-autentisering: hvilken som helst bruker, API-nøkkel som passord)
Forhåndsvisning / avspilling/stream/<nzo_id> (HTTP-ranges; å starte en parkert biblioteksjobb krever ?t=-token eller nøkkel), /m3u/<id> (krever nøkkel; lager tokenet), /wall, /art/…

17 · Filer og plasseringer

FilInnhold
config.local.jsonServerlegitimasjon og alternativer per server. Opprettet av veiviseren; redigerbar i Innstillinger. Hold den privat.
settings.jsonHver innstilling endret i dashbordet. Ligger ved siden av config-en; UI-verdier overstyrer kommandolinjeflagg. Slett en nøkkel (eller filen) for å falle tilbake til flagg/standarder.
index.dbUtgivelsesindeksen (SQLite) + vegg-metadata. Trygg å slette - den gjenoppbygges fra skanning (Innstillinger → Indeksering → Slett gjør dette for deg).
<config>/.spool/Køtilstand (overlever omstarter), NZB-er per jobb, forbruksjournal, benchmark-historikk, plakatbildebuffer.
ArtikkeljournalInne i hver jobbs utdatamappe mens den er uferdig - driver krasj-gjenopptaking og nytt forsøk. Fjernes ved suksess.
Eksterne verktøyIngen nødvendige - RAR-utpakking og PAR2-reparasjon er native. Hvis et eksotisk sett noen gang trenger en ekstern unrar eller par2 som fallback, ser nzbfast ved siden av den kjørbare filen sin, deretter på $PATH.

18 · Feilsøking

SymptomSjekk
Trege nedlastingerKjør Systembenchmark - den navngir flaskehalsen rett ut. Hvis det er nettverk: kjør Tilkoblingsjustering, sjekk antall tilkoblinger per server, og bekreft at leverandørene dine ikke alle er én backbone (Servermangfold).
Treg bare på svært store jobber
(NAS eller maskin med lite RAM)
Forventet, og målbart: et sultet minnebudsjett spiller buffere til disk og koster 20–40 % forbi ~87 GB. Se Minnebudsjett for tallene og hvor mye RAM du bør gi det. Mindre jobber er upåvirket.
Nedlasting feiler «artikler mangler»Posten har utløpt eller ble tatt ned hos leverandørene dine. En andre leverandør på en annen backbone redder de fleste av disse. nzbfast check forutsier dette før nedlasting. Og veggen merker de sannsynlig forsvunne på forhånd med tilgjengelighetsprikken sin (§13). En første feil av denne typen prøver seg selv om igjen én gang etter en ventetid, for propagasjonsforsinkelse ser akkurat slik ut og løser seg selv.
Ferdig arkiv vil ha et passordHistorikkraden viser 🔑 - skriv inn passordet der; jobben blir ferdig på stedet.
Sonarr/Radarr kan ikke koble tilEr port 6789 nåbar? API-nøkkel riktig (full nøkkel, ikke NZB-nøkkel)? Klienttype satt til SABnzbd?
Utforsk-kortet forblir liteIndeksereren vokser i bakgrunnen - sjekk at gruppene i Innstillinger → Indeksering er satt, og gi Fordyp per skanning tid til å bygge opp historikk. «Skann nå» tvinger en runde; statuslinjen viser live fremdrift.
Veggen viser feil / ingen illustrasjonDetaljark → ✎ Rett treff eller ↻ Oppdater metadata. Filmoppslag forbedres med en gratis OMDb-nøkkel.
Daemonen starter ikke: port i brukEn annen instans kjører - eller endre --port.
Hvor er loggene?Logg-kortet på dashbordet, eller terminalen/loggfilen du startet serve med.
Fortsatt fast?Logg-kortet navngir vanligvis synderen - inkluder halen av det når du melder et problem, sammen med din nzbfast --version.

nzbfast - denne håndboken følger med hver utgave. Innstillinger, endepunkter og standarder som er nevnt her, samsvarer med versjonen den ble levert med.