⚡ 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:
- Pipelinet NNTP - mange artikkelforespørsler rir på hver tilkobling rett etter hverandre, og holder hver tilkobling på full fart i stedet for å vente ut rundturene.
- En pipeline i én omgang - nedlasting, verifisering og utpakking overlapper. Arkivvolumer pakkes ut i strømmen; på en typisk store-mode-post rører RAR-filene aldri disken din, så jobben trenger 1× utgivelsesstørrelsen, ikke 2×, og blir ferdig når nedlastingen blir ferdig.
- Fler-leverandørunion - hver konfigurerte server bidrar; en artikkel som mangler på én backbone, hentes fra en annen. Trege eller døde servere stopper aldri køen.
- Et minnebudsjett - motoren tilpasser seg en avgrenset RAM-tildeling og degraderer til disk ved behov. Den swapper aldri maskinen din.
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
- Åpne
nzbfast-<version>-macos.dmgog dra NzbFast inn i Programmer (universal: Apple Silicon + Intel). - 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.
- 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.
- Slipp en
.nzbhvor 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
- 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 info → Kjør likevel. - 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.
- 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
nzbfast import-sab på kommandolinjen.3 · Slik fungerer nzbfast
Et raskt ordforråd så resten av håndboken blir lett å lese:
| Begrep | Betydning |
|---|---|
| Leverandør / server | En Usenet-tjeneste du har en konto hos (Newshosting, Eweka, XS News…). Hver tillater et visst antall samtidige tilkoblinger. |
| Backbone | Infrastrukturen 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. |
| NZB | En liten XML-fil som lister opp artiklene som utgjør en post. Det er dette du mater nzbfast. |
| PAR2 | Gjenopprettingsdata 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-RAR | De 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ørrelse | nzbfast | NZBGet 26.2 | SABnzbd 5.0.4 |
|---|---|---|---|
| 7 GB | 13,7 s | +26% | +39% |
| 35 GB | 67 s | +61% | +325% |
| 87 GB | 272 s | +36% | +160% |
| 190 GB | 9 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:
- Diskplass. Én omgang trenger 1× utgivelsesstørrelsen; klienter som skriver arkivvolumer og så pakker dem ut trenger 2×. På en testmaskin med 97 GB ledig ble en 87 GB-jobb ferdig her på 3 m 08 s, og de to andre kunne ikke kjøre i det hele tatt.
- Minne. På 190 GB-jobben var toppforbruket 3,9 GB mot SABnzbds 9,3 GB - og nzbfast gjør samme jobb på rundt 1 GB om du ber den om det (se Minnebudsjett).
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
- Fartsgrense-menyen - faste tak, auto · vik for LAN (en RTT-styrt modus som trekker seg tilbake når noen andre i huset trenger linjen), eller ubegrenset.
- Pause i… - pause alt i 15 min/30 min/1 t/3 t med automatisk gjenopptaking, eller bruk Pause-knappen for en åpen pause. Pause er umiddelbar: den aktive overføringen stopper i løpet av sekunder og fortsetter senere fra journalen, uten å miste noe. (Jobber med Tving-prioritet fortsetter å laste ned, SABnzbd-stil.)
- Et oppdateringsbanner dukker opp her når en ny versjon er tilgjengelig (se Oppdateringer).
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.
Kø
- Dra rader for å endre rekkefølge (innenfor et prioritetsbånd - Tving/Høy lastes fortsatt ned først); endre prioritet direkte.
- Klikk på en rad for detaljskuffen: fremdriftslinjer per fil, verifiserte blokkantall, og hvilken server som bidro med hvor mye til denne jobben.
- Merker viser spesialtilstander: utsatt (treg), prefetcher, pauset (se Ytelsesverktøy).
- Et nedtellingsdiagram sporer totalt antall GB som gjenstår i hele køen.
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
| Metode | Hvordan |
|---|---|
| Dra og slipp | Slipp én eller flere .nzb-filer hvor som helst på dashbordet. |
| Overvåkingsmappe | Angi 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 URL | Lim inn en NZB-lenke (API mode=addurl, eller via en tilkoblet app). |
| Utforsk indeks | Klikk på en hvilken som helst fullstendig utgivelse i Utforsk-kortet. |
| Watchlist / RSS | Automatisk - se Automatisering. |
| Sonarr/Radarr osv. | De sender hentinger rett i køen - se §11. |
| Kommandolinje | nzbfast get file.nzb laster ned uten daemonen. |
Kategorier, prioriteter, passord
- Kategorier er friformetiketter; hver blir en undermappe i nedlastingsmappen din, og Smartmapper (se §10) kan tildele dem etter regel.
- Prioriteter: Tving > Høy > Normal > Lav. Tving omgår pause og kvote.
- Passord for krypterte arkiver plukkes opp automatisk fra
<meta type="password">inni NZB-en eller etName{{password}}.nzb-filnavn, og kan oppgis per jobb gjennom API-et eller i etterkant fra Historikk (🔑).
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.
- Faner for Filmer / Serier / Annet, direktesøk og sju sorteringer: For deg, Nyeste poster, Utgivelsesår, Best vurdert, Tittel A–Å, Størst og Mest postet.
- Kun med treff er på som standard og skjuler uidentifisert søppel; et «+N uten treff»-merke avslører det.
- Klikk på en flis for detaljarket: sammendrag, IMDb-vurdering og stemmer, rollebesetning - og ▶ Spill av (forhåndsvis den umiddelbart, se §7) eller ⬇ Last ned.
- ✎ Rett treff - hvis en tittel matchet feil serie eller film, velg den riktige fra kandidatplakater, eller skriv inn tittel/år/type manuelt. Manuell tekst overskrives aldri av berikeren. ↻ Oppdater metadata henter én tittel på nytt; Innstillinger → Indeksering kan oppdatere alt eller slette/gjenoppbygge hele indeksen.
- Metadata er nøkkelfri som standard - TVmaze, iTunes, IMDb-datasett, Wikidata, Wikipedia og AniList trenger ingen kontoer. En OMDb-nøkkel (gratis, kun-e-post-registrering - det finnes en registreringshjelper i Innstillinger → Indeksering) forbedrer filmmatching; en TMDB-nøkkel respekteres hvis du allerede har en.
- For deg rangerer veggen etter en smaksprofil som bygges på denne maskinen ut fra din egen fullførte historikk og overvåkingslisten din: favorittsjangre, om du heller mot film eller serier, og omtrent hvilken epoke. Titler du allerede har synker til bunnen i stedet for å forsvinne, og en bildetekst «Fordi du ser …» sier hva den la vekt på. Uten historikk faller den tilbake på Mest postet, så fanen er aldri tom. Ingenting av dette forlater daemonen.
- Ikke interessert på et kort skjuler den tittelen, og skjuler du noen lignende, lærer veggen noe: den foreslår et filter du godtar med ett klikk («Skjule alle Reality-titler fra nå av?»). Alt du har skjult, og hvert lærte filter, står under Skjult & filtre og kan angres der.
- En liten tilgjengelighetsprikk på et kort er orakelets dom (§13): et gult «?» betyr usikkert hos leverandørene dine, rødt at delene stadig mangler. Hele grupper som ryddes får et ryddet-merke.
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.
- ▶ Spill av på veggen (eller
/m3u/<id>) gir mediespilleren din en URL; daemonen starter eller gjenbruker nedlastingen bak den. - Endepunktet
/stream/<nzo_id>serverer filen med full HTTP-range-støtte mens den laster ned. Kontroll av ethvert punkt fungerer: stikkprøv minutt 40, så flyttes artiklene for det området fremst i nedlastingskøen - den åpner der i løpet av et par sekunder i stedet for minutter. Hodet og halen av filen hentes først slik at spillere finner indeksdataene sine umiddelbart. - Biblioteksmodus: kategorier som er oppført i library_cats, blir umiddelbare
kun-metadata-oppføringer - en
.strm-fil dukker opp med en gang, tilgjengelighet verifiseres i bakgrunnen, og den ekte nedlastingen starter når du åpner den første gang.
/stream-URL-er. For å kontrollere fra en annen maskin, bruk maskinens LAN-adresse i stedet for
localhost./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:
| Felt | Merknader |
|---|---|
| Host / port | Bruk SSL-port 563. TLS koster ingenting målbart - nzbfast krypterer alltid. |
| Brukernavn / passord | Lagres lokalt i config.local.json, vises aldri tilbake til nettleseren. Lar du passord stå tomt ved redigering, beholdes det lagrede. |
| Tilkoblinger | Samtidige 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økkel | Merknader |
|---|---|
bind_ip | Binder 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. |
socks5 | Sender 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. |
- Haken ved siden av hver server er av/på-bryteren: med hake er serveren med i nedlastingspoolen, uten hake er den deaktivert. En deaktivert server beholder påloggingsdetaljer og innstillinger og kan fortsatt testes; den blir bare aldri spurt om artikler. Raden tones ned, tellingen i overskriften (2 av 3 aktive) synker, og endringen gjelder fra neste nedlasting. Nyttig for å spare på en blokk-konto, eller for å bevise at én leverandør står bak et problem uten å slette den.
- Test gjør en ekte tilkobling + TLS + innlogging og rapporterer rundturstid.
- Importer fra SABnzbd / NZBGet… skanner de vanlige installasjonsplasseringene, viser hva den fant, og kopierer inn servere (hopper over duplikater).
- Serverendringer gjelder fra neste nedlasting - ingen omstart.
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
| Innstilling | Hva den gjør |
|---|---|
| Fartsgrense | Tak i byte/sek (50M, 1G, 0 = ubegrenset). Fjernstyringsapper kan sende prosenter - sett Linjefart slik at de oversettes riktig. |
| Auto-fart | RTT-styrt tak som viker for annen trafikk i husholdningen og utvider seg igjen når linjen er rolig. |
| Utsett trege nedlastinger automatisk | En jobb som henger på én treg server mens andre venter, flyttes bakerst i køen (fremdriften beholdes). Se §13. |
| Prefetch på ledige servere | Servere som er ubrukelige for den aktive jobben, starter den neste i køen. Se §13. |
| Auto-oppdatering / URL for oppdateringssjekk | Se §14. |
| Linjefart | Din tilkoblings oppgitte fart - muliggjør prosentvise grenser fra SABnzbd-kompatible apper. |
| Ukeplan | Radeditor 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.
| Innstilling | Hva den gjør |
|---|---|
| Ta med oppløsning | Setter 1080p, 2160p… i navnet. På som standard; de fire andre merkene er av. |
| Ta med videokodek | x265, x264, AV1… |
| Ta med lydkodek | Atmos, DTS-HD, AC3… |
| Ta med kilde | BluRay, WEB, REMUX… |
| Ta med utgivelsesgruppe | Merket -GROUP til slutt. |
| Fjern søppelfiler | På som standard. Sletter gjenliggende .par2, .nzb, .sfv, .nfo og sample-klipp fra ferdige film- og seriemapper. Aldri videoen eller undertekstene. |
| Behold bare mediefilen | Av 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
| Innstilling | Hva den gjør |
|---|---|
| Grupper | Newsgroups den innebygde indeksereren skanner (f.eks. alt.binaries.teevee). |
| Skanneintervall | Sekunder mellom rundene (standard 900). |
| Backfill-artikler | Headere som hentes ved en gruppes aller første skanning. |
| Fordyp per skanning | Hver 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 alder | Ignorer poster eldre enn dette (90d, 6m, 2y) - begrenser indeksstørrelse og skannetid. |
| Trim til aldersvinduet | På 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. |
| Inntaksfiltre | JSON-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 skanning | Kjør en runde umiddelbart; med en dybde, skann på nytt så mange nylige headere. |
| OMDb-nøkkel / metadataoppdatering / sletting | Kontroller 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.
| Navn | Hva den gjør |
|---|---|
verify_mode | full | 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_mins | Ventetid 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_par | Hvor mange grupper indeksereren skanner parallelt (standard 3, begrenset til 1-8). |
oracle_sample | Tilgjengelighetsorakelets 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
- I Sonarr/Radarr: Settings → Download Clients → legg til SABnzbd.
- Host: nzbfast-maskinen din · Port: 6789 · API-nøkkel: din fulle API-nøkkel (Innstillinger → Sikkerhet; QR-/kopieringskontrollen står ved siden av den).
- 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)
- Settings → Indexers → legg til Newznab.
- URL:
http://<host>:6789/· API-sti:/api· nøkkel: din API-nøkkel. - nzbfast serverer
caps-,search-,tvsearch- ogmovie-forespørsler fra sin egen indeks av de overvåkede gruppene dine, og/getnzb/<id>gir tilbake NZB-en.
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 appen | Verdi |
|---|---|
| Type | NZBGet |
| Host / port | maskinen din : 6789 |
| Brukernavn | hva som helst (f.eks. nzbfast) |
| Passord | din 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 appen | Verdi |
|---|---|
| Type | SABnzbd |
| Host / port | maskinen din : 6789 |
| API-nøkkel | din 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
- Auto-utsettelse: en nedlasting som halter på én enkelt treg server mens andre jobber venter, parkeres bakerst (journalen beholder fremdriften) og forsøkes på nytt når køen er tom.
- Prefetch på ledige servere: servere som ikke kan hjelpe den aktive jobben (kopiene deres er borte), begynner å laste ned den neste jobben i køen i mellomtiden. Ingen annen klient gjør overlapp på tvers av jobber.
- Soak på tvers av jobber: mens en ferdig jobbs hale (verifisering/utpakking) fullføres på disk, eier den neste jobbens nedlasting allerede linjen.
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:
- En tilgjengelighetsdom på veggens kort og indeksens rader (§6): gult «?» for usikkert hos leverandørene dine, rødt for sikkert borte. Ingen markering betyr at det ser bra ut.
- Et ryddet-merke på grupper der ferske poster allerede fjernes, så du kan skille en døende gruppe fra en uheldig utgivelse.
- Hopp over leverandører orakelet har avskrevet (Innstillinger, av som standard, eksperimentell): når sjekken er sikker på at én leverandørs backbone har mistet en utgivelse, hoppes den rett over for den nedlastingen i stedet for å vente på at den feiler. Den hopper aldri over den siste leverandøren du har igjen.
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ørrelse | Rikelig med RAM | 2 GB-budsjett ≈ 8 GB-maskin | 1 GB-budsjett ≈ 4 GB-maskin | 256 MB-budsjett ≈ 2 GB NAS |
|---|---|---|---|---|
| 7 GB | 15 s | 15 s | 15 s | 15 s |
| 35 GB | 65 s | 70 s | 70 s | 65 s |
| 87 GB | 148 s | 206 s +39% | 196 s +32% | 180 s +22% |
| 190 GB | 330 s | 427 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.
- Opptil ~35 GB er lite minne gratis. Arbeidssettet får plass uansett, så en 4 GB-maskin gjør en slik jobb like raskt som en på 64 GB.
- Forbi ~87 GB betaler du 20–40 % - men bare når linjen din er raskere enn disken din. Verifiseringsblokker og arkivvolumer som ville ha blitt liggende i RAM, skrives ut og leses inn igjen i stedet, og det koster bare tid hvis nettverket kan levere raskere enn disken kan ta imot den ekstra trafikken. De 20–40 % over ble målt på 10 GbE; den samme 87 GB-jobben ved de samme budsjettene på en ~2,4 Gbps-linje viste ingen straff i det hele tatt (−1 til +7 %, innenfor støy mellom kjøringene). Straffen er en funksjon av hvor mye raskere linjen er enn disken, ikke av jobbstørrelsen - på en typisk hjemmetilkobling er et lite budsjett nær gratis selv på svært store jobber.
- Straffen flater ut. Når en jobb er stor nok til å spille, spiller hvert begrenset budsjett omtrent like mye - kjøringene på 2 GB, 1 GB og 256 MB leser inn igjen i praksis samme antall blokker fra disk, og blir ferdige innenfor støy av hverandre. Så litt mer RAM under terskelen som unngår spilling helt, kjøper ikke tilbake kostnaden: gi den nok til å holde jobben i minnet, ellers betyr det eksakte tallet knapt noe.
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
- Oppdateringer er kun varsling: nzbfast laster aldri ned eller bytter ut sin egen binærfil, og det finnes ingen kode i den som kan. Når en ny versjon finnes, viser toppfeltet ⬆ v X tilgjengelig - last ned; brikken lenker til den offisielle nedlastingssiden (lenken er fast i appen og kommer aldri fra oppdateringsmanifestet). Installer den nye versjonen på samme måte som du installerte den nåværende.
- nzbfast ser etter nye versjoner to ganger om dagen. Slå av Se etter oppdateringer (Innstillinger), så kontakter den aldri oppdateringsmanifestet; en tom oppdaterings-URL gjør det samme.
15 · Kommandolinje
Alt daemonen gjør, er også skriptbart. De hverdagslige kommandoene:
| Kommando | Formål |
|---|---|
nzbfast setup | Interaktivt serveroppsett. |
nzbfast serve | Kjør daemonen (dashbord + API + automatisering). --open åpner nettleseren; se --help for den fulle flagglisten - hver dashbord-innstilling har en flagg-tvilling. |
nzbfast get file.nzb | Last ned én NZB, full pipeline, ingen daemon. --preflight avbryter tidlig hvis posten ikke kan fullføres; --password for krypterte sett. |
nzbfast check file.nzb | Tilgjengelighetsdom - COMPLETE / REPAIRABLE / IMPOSSIBLE - uten å laste ned nyttelasten. |
nzbfast verify DIR | Verifiser filer mot PAR2-settet i en mappe. |
nzbfast sysbench | Systembenchmarken + mangfoldsrapporten, i terminalen. |
nzbfast index / search | Skann grupper inn i indeksen / søk i den, uten daemonen. |
nzbfast import-sab | Importer 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åde | Modi |
|---|---|
| Kø | queue (med name=delete/pause/resume/priority/switch), pause, resume, addfile, addurl, retry, set_password |
| Info | history, status/fullstatus, stats, version, server_stats, usage, log, warnings |
| Konfigurasjon | get_config, config&name=<setting>&value=… (hvert Innstillinger-felt), server_save/delete/test/enable/reorder, import_probe/apply |
| Indeks og vegg | index_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> |
| Automatisering | watchlist, watchlist_check_now, watch_calendar, feeds, smart_folders, schedule |
| Diagnostikk | sysbench, 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
| Fil | Innhold |
|---|---|
config.local.json | Serverlegitimasjon og alternativer per server. Opprettet av veiviseren; redigerbar i Innstillinger. Hold den privat. |
settings.json | Hver 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.db | Utgivelsesindeksen (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. |
| Artikkeljournal | Inne i hver jobbs utdatamappe mens den er uferdig - driver krasj-gjenopptaking og nytt forsøk. Fjernes ved suksess. |
| Eksterne verktøy | Ingen 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
| Symptom | Sjekk |
|---|---|
| Trege nedlastinger | Kjø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 passord | Historikkraden viser 🔑 - skriv inn passordet der; jobben blir ferdig på stedet. |
| Sonarr/Radarr kan ikke koble til | Er port 6789 nåbar? API-nøkkel riktig (full nøkkel, ikke NZB-nøkkel)? Klienttype satt til SABnzbd? |
| Utforsk-kortet forblir lite | Indeksereren 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 illustrasjon | Detaljark → ✎ Rett treff eller ↻ Oppdater metadata. Filmoppslag forbedres med en gratis OMDb-nøkkel. |
| Daemonen starter ikke: port i bruk | En annen instans kjører - eller endre --port. |
| Hvor er loggene? | Logg-kortet på dashbordet, eller terminalen/loggfilen du startet serve med. |
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.