⚡ nzbfast

Descărcătorul rapid de Usenet - manual de utilizare

1 · Bun venit

nzbfast descarcă de pe Usenet atât de repede pe cât permit linia ta, providerii tăi și mașina ta - și de obicei asta înseamnă atât de repede pe cât permite linia ta. Este un singur program de sine stătător: motorul, un panou web, un browser media de tip perete de postere, un indexer integrat, previzualizare în timp real, reparare PAR2 nativă și extragerea RAR nativă sunt toate într-un singur executabil. Nu mai e nimic altceva de instalat.

Ce îl face rapid este arhitectura, nu ajustările:

• NNTP cu pipelining - multe cereri de articole circulă pe fiecare conexiune una după alta, menținând fiecare conexiune la viteză maximă în loc să aștepte dus-întorsurile.
• Un pipeline într-o singură trecere - descărcarea, verificarea și extragerea se suprapun. Volumele de arhivă sunt extrase în flux; la o postare tipică în mod store, fișierele RAR nu ating niciodată discul, deci jobul are nevoie de 1× dimensiunea release-ului, nu 2×, și se termină când se termină descărcarea.
• Uniune multi-provider - fiecare server configurat contribuie; un articol care lipsește pe un backbone este preluat de pe altul. Serverele lente sau moarte nu blochează niciodată coada.
• Un buget de memorie - motorul se adaptează la o alocare limitată de RAM și degradează la disc dacă e nevoie. Nu îți solicită niciodată swap-ul mașinii.

Măsurat față de concurență pe hardware, joburi și provideri identici, nzbfast a terminat o descărcare de 190 GB în aproximativ 5 minute pe o linie de 10 GbE - cu alternativele de top rămase în urmă cu 30–220% la aceleași teste, acolo unde le-au finalizat. Cifrele sunt în §3.

2 · Pornire rapidă

macOS

1. Deschide nzbfast-<version>-macos.dmg și trage NzbFast în Applications (universal: Apple Silicon + Intel).
2. Prima lansare: macOS avertizează că nzbfast nu este încă notarizat de Apple. Clic dreapta pe aplicație → Open - sau deschide System Settings → Privacy & Security, derulează în jos și dă clic pe Open Anyway. Este un pas unic.
3. Fereastra aplicației arată panoul cu un card de bun venit - dă clic pe el și adaugă cel puțin un server Usenet (host, portul 563, nume de utilizator, parolă). Poți adăuga mai multe ulterior în Setări.
4. Trage un .nzb oriunde pe panou - sau doar dublu-clic pe fișiere .nzb în Finder. Descărcările ajung în ~/Downloads/nzbfast. Închide din meniu; descărcările se reiau de unde au rămas.

Preferi fără aplicație? Zip-ul simplu (binar + launcherul Start nzbfast.command, același motor) funcționează în continuare ca înainte - pașii de mai jos, la „Dintr-un terminal”.

Windows

1. Rulează nzbfast-setup-<version>.exe. Se instalează doar pentru utilizatorul tău (fără parolă de administrator). Deoarece acest release nu este încă semnat digital, SmartScreen ar putea afișa „Windows protected your PC” - dă clic pe More info → Run anyway.
2. nzbfast stă în bara de sistem (system tray): dublu-clic pe iconița din tray (sau folosește Open Dashboard din meniul contextual) pentru a deschide panoul, apoi adaugă serverul tău Usenet din cardul de bun venit. Meniul din tray are și Pauză/Reluare, folderul tău de descărcări și Quit.
3. Dublu-clic pe un fișier .nzb îl pune în coadă. Windows Defender ar putea cere o dată permisiunea de ascultare pe rețeaua locală - permite-o.

Preferi o copie portabilă? -windows-x64.zip funcționează în continuare: dezarhivează oriunde și dublu-clic pe nzbfast.exe (sau Start nzbfast.bat) pentru asistentul din terminal.

Dintr-un terminal (orice platformă)

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

3 · Cum funcționează nzbfast

O scurtă terminologie ca restul manualului să se citească ușor:

Pipeline-ul rulează descărcare → decodare → verificare → extragere concurent. Cardul Pipeline din panou arată toate cele trei benzi mișcându-se simultan. Când sosește ultimul octet, verificarea e deja făcută și fișierul e deja extras; timpul de „post-procesare” al unui job tipic este zero. Dacă e nevoie de reparare, abia atunci volumele sunt materializate pe disc, reparate pe loc de motorul nativ GF(2¹⁶) (datele obfuscate redenumite sau deplasate cu octeți sunt găsite și adoptate printr-o scanare glisantă de blocuri) și reextrase - totul automat.

Descărcările întrerupte (blocare, pană de curent, kill -9) se reiau din jurnalul de articole: octeții deja pe disc nu sunt preluați niciodată de două ori. Jurnalul înregistrează unde au aterizat fizic octeții fiecărui articol - chiar și octeții care au fost extrași direct în fișierul final - astfel încât o reluare reconstruiește din discul local și reverifică tot ce a restaurat în raport cu harta de blocuri PAR2 înainte de a-i acorda încredere.

Cum se compară

Măsurat față de SABnzbd 5.0.4 și NZBGet 26.2 pe aceeași mașină, aceiași provideri și aceleași NZB-uri, cronometrat până la un fișier utilizabil - descărcare, verificare, reparare și extragere incluse, pentru că atunci este jobul cu adevărat gata:

Diferența este post-procesarea pe care ceilalți încă trebuie s-o facă după ce aterizează ultimul octet. Ambii concurenți au fost reglați pentru comparație, nu lăsați pe valorile implicite - SABnzbd în special vine cu pipelining-ul cererilor oprit, ceea ce îl costă scump, așa că a fost pornit.

Două diferențe contează la fel de mult ca timpii:

• Spațiu pe disc. O singură trecere are nevoie de 1× dimensiunea release-ului; clienții care scriu volume de arhivă și apoi le dezarhivează au nevoie de 2×. Pe o mașină de test cu 97 GB liberi, un job de 87 GB s-a terminat aici în 3 m 08 s, iar celelalte două nu au putut rula deloc.
• Memorie. La jobul de 190 GB, utilizarea de vârf a fost de 3.9 GB față de 9.3 GB ai SABnzbd - iar nzbfast va face același job în aproximativ 1 GB dacă i se cere (vezi Buget de memorie).

4 · Panoul

Deschide http://localhost:6789 (sau adresa mașinii tale de pe alt dispozitiv - aspectul pentru telefon se adaptează automat). Totul se actualizează live, o dată pe secundă. Cardurile, de sus în jos:

Bara de sus

• Meniul Limită de viteză - plafoane fixe, auto · cedează LAN-ului (un mod guvernat de RTT care se retrage când altcineva din casă are nevoie de linie), sau nelimitat.
• Pauză pentru… - pune totul în pauză pentru 15 min/30 min/1 h/3 h cu reluare automată, sau folosește butonul Pauză pentru o pauză fără termen. Pauza este imediată: transferul activ se oprește în câteva secunde și se reia mai târziu din jurnal, fără a pierde nimic. (Joburile cu prioritate Forțată continuă să descarce, în stil SABnzbd.)
• Un banner de actualizare apare aici când e disponibilă o versiune nouă (vezi Actualizări).

Debit

MB/s în timp real cu un grafic derulant; filigranele punctate marchează maximul/minimul acestei sesiuni, linia estompată este o medie mobilă. Sub el, o histogramă arată cum se distribuie mostrele de viteză din sesiune - tipic vs vârf. Lărgește fereastra și graficele arată mai mult istoric (până la o oră).

Plăci statistice

Descărcat în această sesiune, adâncimea cozii, numărul de finalizate/eșuate, viteza de vârf a sesiunii.

Resurse - o mașină, patru plafoane

CPU, RAM (față de bugetul de memorie al nzbfast), rata de scriere pe disc și rețeaua pe un singur grafic normalizat, cu valori reale în legendă și un avertisment de spațiu redus. Niciun alt client NZB nu-ți arată asta; există pentru a demonstra un lucru - nzbfast îți va satura linia, nu mașina.

Pipeline - etapele se suprapun

Trei benzi: descărcare, verificare (blocuri PAR2 verificate), extragere. La un job sănătos toate trei se mișcă împreună.

Provideri

Rata în timp real per server, utilizarea conexiunilor, ponderea din trafic, GB pe sesiune și un scor de completitudine a articolelor pe toată durata (colorat când un server scade sub 98%). Un grafic cu arii stivuite arată contribuția fiecărui provider în timp. Rândurile se reordonează după performanța în timp real la fiecare 10 s (configurabil în Setări → Interfață), astfel încât providerul tău cel mai rapid să fie mereu în frunte.

Coadă

• Trage rândurile pentru a le reordona (în cadrul unei benzi de prioritate - Forțată/Ridicată rulează tot primele); schimbă prioritatea pe loc.
• Dă clic pe un rând pentru sertarul de detalii: bare de progres per fișier, numărul de blocuri verificate și cât a contribuit fiecare server la acest job.
• Insignele arată stări speciale: amânat (lent), preîncărcare, în pauză (vezi Instrumente de performanță).
• Un grafic burn-down urmărește totalul de GB rămași în toată coada.

Răsfoiește indexul

Caută tot ce a catalogat indexerul integrat din grupurile tale urmărite (vezi Automatizare) și descarcă cu un singur clic - fără indexer extern. Linia de stare arată progresul scanării; Scanează acum forțează o trecere.

Watchlist

Adaugă titluri după nume - inclusiv unele nepostate încă. Când un release potrivit apare în index, este preluat automat, cu preferințe de calitate și reguli de upgrade (o copie mai bună o înlocuiește pe una mai slabă).

Istoric

Descărcări recente cu stare, dimensiune, locație; joburile eșuate oferă Reîncearcă (reia din jurnal). Arhivele criptate arată un control de deblocare 🔑 - introdu parola și jobul se termină pe loc. Fâșia de sănătate a verificării trasează blocurile PAR2 defecte per descărcare - o coadă în creștere înseamnă că articolele sosesc deteriorate.

Consum de date

Bare zilnice per provider și totaluri Azi / 7 zile / 30 de zile - esențiale pentru conturile contorizate și cu bloc. Conturile cu bloc arată utilizarea pe toată durata față de dimensiunea lor.

Jurnal, Benchmark de sistem, Reglarea conexiunilor, Diversitatea serverelor

Un vizualizator de jurnal în pagină și cele trei instrumente de auto-măsurare descrise în Instrumente de performanță.

5 · Adăugarea descărcărilor

Categorii, priorități, parole

• Categoriile sunt etichete libere; fiecare devine un subfolder al directorului tău de descărcare, iar Folderele inteligente (vezi §10) le pot atribui după reguli.
• Priorități: Forțată > Ridicată > Normală > Scăzută. Forțata ignoră pauza și cota.
• Parolele pentru arhivele criptate sunt preluate automat din <meta type="password"> din interiorul NZB-ului sau dintr-un nume de fișier Name{{password}}.nzb și pot fi furnizate per job prin API sau ulterior din Istoric (🔑).

6 · Peretele de postere

Dă clic pe 🎬 perete în bara de sus. Peretele transformă indexul tău într-un browser media: fiecare film și release TV recunoscut ca o placă de poster cu notă, an, genuri, distribuție și sinopsis - newsgroup-urile tale, navigabile ca un catalog.

• File pentru Filme / Seriale / Altele, căutare instantanee și șapte sortări: Pentru tine, Cele mai noi postări, Anul apariției, Cele mai bine cotate, Titlu A–Z, Cele mai mari și Cele mai postate.
• Doar potrivite este activ implicit, ascunzând gunoiul neidentificat; o insignă „+N nepotrivite” îl dezvăluie.
• Dă clic pe o placă pentru fișa de detalii: sinopsis, notă și voturi IMDb, distribuție - și ▶ Redă (previzualizează-l imediat, vezi §7) sau ⬇ Descarcă.
• ✎ Corectează potrivirea - dacă un titlu s-a potrivit cu serialul sau filmul greșit, alege-l pe cel corect dintre posterele candidate sau introdu titlul/anul/tipul manual. Textul manual este niciodată suprascris de instrumentul de îmbogățire. ↻ Reîmprospătează metadatele repreia un singur titlu; Setări → Indexare poate reîmprospăta tot sau poate goli/reconstrui întregul index.
• Metadatele sunt fără cheie în mod implicit - seturile de date TVmaze, iTunes, IMDb, Wikidata, Wikipedia și AniList nu au nevoie de conturi. O cheie OMDb (gratuită, înscriere doar cu email - există un asistent de înscriere în Setări → Indexare) îmbunătățește potrivirea filmelor; o cheie TMDB este respectată dacă ai deja una.
• Pentru tine ordonează peretele după un profil de gusturi construit pe această mașină din propriul tău istoric finalizat și din lista ta de urmărire: genurile preferate, dacă înclini spre film sau serial și aproximativ ce epocă. Titlurile pe care le ai deja coboară la fund în loc să dispară, iar o legendă „Pentru că vezi …” spune pe ce s-a bazat. Fără istoric, revine la Cele mai postate, așa că fila nu e niciodată goală. Nimic din toate acestea nu părăsește daemonul.
• Nu mă interesează pe o plachetă ascunde acel titlu, iar dacă ascunzi câteva similare peretele învață: îți propune un filtru pe care îl accepți dintr-un clic („Ascunzi toate titlurile Reality de acum înainte?”). Tot ce ai ascuns și fiecare filtru învățat se află la Ascunse și filtre și pot fi anulate acolo.
• Un mic punct de disponibilitate pe o plachetă este verdictul oracolului (§13): un „?” chihlimbariu înseamnă incert la providerii tăi, roșu că părțile lipsesc în mod repetat. Grupurile aflate în curățare poartă o insignă curățat.

7 · Previzualizare și verificare

Nu trebuie să aștepți să se termine o descărcare ca să știi că e fișierul potrivit. Deschide-l în timp ce se descarcă, verifică dacă conținutul, limba și calitatea sunt cele așteptate și anulează din timp dacă nu sunt - în loc să afli abia după descărcarea completă.

• ▶ Redă pe perete (sau /m3u/<id>) îi dă playerului tău media un URL; daemonul pornește sau reutilizează descărcarea din spate.
• Endpointul /stream/<nzo_id> servește fișierul cu suport complet pentru intervale HTTP în timp ce se descarcă. Verificarea oricărui punct funcționează: verifică rapid minutul 40 și articolele pentru acea regiune sunt promovate în fața cozii de descărcare - se deschide acolo în câteva secunde în loc de minute. Capul și coada fișierului sunt preluate primele, ca playerele să-și găsească imediat datele de index.
• Mod bibliotecă: categoriile listate în library_cats devin intrări instantanee doar cu metadate - un fișier .strm apare imediat, disponibilitatea este verificată în fundal, iar descărcarea reală pornește când îl deschizi prima dată.

8 · Servere Usenet

Setări → Servere Usenet este editorul complet: adăugare, editare, ștergere, reordonare și includerea sau excluderea oricărui server din pool. Fiecare server are:

Alte două opțiuni per server nu au încă un control în panou: adaugă-le manual în intrarea acelui server din config.local.json (vezi §17) și repornește.

• Bifa de lângă fiecare server este comutatorul lui: bifat înseamnă că serverul este în pool-ul de descărcare, nebifat înseamnă dezactivat. Un server dezactivat își păstrează datele de autentificare și setările și poate fi în continuare testat; pur și simplu nu i se cer niciodată articole. Rândul se estompează, numărătoarea din titlu (2 din 3 active) scade, iar modificarea se aplică de la următoarea descărcare. Util pentru a menaja un cont pe blocuri pe care îl păstrezi, sau pentru a demonstra că un furnizor este cauza unei probleme fără a-l șterge.
• Testează face o conectare reală + TLS + autentificare și raportează timpul dus-întors.
• Importă din SABnzbd / NZBGet… scanează locațiile obișnuite de instalare, arată ce a găsit și copiază serverele (sărind duplicatele).
• Editările de server se aplică de la următoarea descărcare - fără repornire.

9 · Referință de setări

Aproape tot se poate configura din panou, la ⚙ Setări; cele patru excepții sunt enumerate la finalul acestei secțiuni. Valorile marcate live se aplică imediat, cele restart la următoarea pornire. Fiecare modificare făcută aici este salvată în settings.json și supraviețuiește repornirilor (valorile din interfață bat opțiunile din linia de comandă).

Viteză și programare live

Următoarea descărcare live

Conexiuni (per server), fereastra (adâncimea de pipelining per conexiune), decodoare (fire de decodare paralele). Eșantionate când pornește fiecare job. Valorile implicite sunt potrivite pentru majoritatea liniilor; folosește instrumentele de reglare înainte de a mări orbește.

Verificare rapidă (CRC32) (activată implicit) revendică blocurile PAR2 prin CRC32 cât timp descărcarea încă rulează, ceea ce e de 2-3x mai rapid pe un procesor lent. Suma de control proprie fiecărui articol este oricum verificată, iar trecerea finală folosește întotdeauna MD5 complet: nu se sacrifică nimic din corectitudine. Debifeaz-o pentru a calcula MD5 pe bloc și în timpul descărcării.

Disc și cotă live

Spațiu liber minim (pune în pauză joburile noi sub el), cotă de descărcare pe zi sau lună (UTC; joburile Forțate ignoră), limită de memorie - bugetul de RAM al motorului (implicit: ¼ din RAM, limitat; mărește-l pe o mașină cu mult RAM pentru viteză maximă la joburi uriașe și vezi cât costă memoria redusă înainte de a-l scădea) repornire.

Mută finalizatele în: după dezarhivare, curățare și redenumire, descărcările finalizate se mută aici - un share NAS, un disc media, oriunde îți stă biblioteca. Structura pe categorii se păstrează (un job terminat sub tv/ ajunge sub tv/ la destinație), iar istoricul urmează mutarea, așa că aplicațiile conectate importă și șterg din noua locație. Dacă destinația nu e accesibilă când se termină un job (share offline, spațiu epuizat), fișierele rămân în folderul de descărcare și jobul se încheie oricum normal. Gol = dezactivat. Destinații per categorie trimit anumite categorii în altă parte (tv=/Volumes/NAS/TV, movies=/Volumes/NAS/Movies); fiecare cale listată este folderul acelei categorii, deci în ea nu se creează niciun subfolder de categorie suplimentar. Categoriile nelistate urmează Mută finalizatele în.

Adâncimea arhivelor imbricate (implicit 5) este numărul de straturi arhivă-în-arhivă dezarhivate automat: un set RAR care conține un 7z care conține alt RAR este ceva obișnuit pe Usenet, iar nzbfast urmează lanțul fără o a doua trecere. La limită, arhiva cea mai adâncă este pur și simplu lăsată pe loc, nedezarhivată, iar descărcarea se finalizează oricum. Mărește valoarea doar pentru release-uri neobișnuit de adânci.

Redenumire automată și curățare live

Redenumește descărcările finalizate (activată implicit) dă folderului și fișierului principal un nume curat și clar: un film devine Example Movie (2024), serialele păstrează Show - S01E02. Numele ofuscate sau nerecunoscute sunt lăsate exact așa cum au fost postate, în loc să fie ghicite.

Întregul grup rulează după reparare și dezarhivare și înainte de Mută finalizatele în, și este sărit complet pentru o sarcină care încă așteaptă o parolă. Ambii pași de ștergere se aplică doar release-urilor recunoscute ca film sau serial: o încărcătură software sau un set neclasificabil (ofuscat) nu este niciodată curățat.

Foldere și procesare

Folder de descărcare repornire, folder monitorizat, script de post-procesare (rulat după fiecare job cu argumente compatibile SABnzbd și mediul SAB_* - scripturile SAB existente funcționează neschimbate), extensii de curățare (fișiere gunoi șterse după finalizare), Foldere inteligente și arhivare TV (vezi §10).

Indexare live

Bibliotecă, Securitate, Interfață

Bibliotecă: categorii tratate ca intrări instantanee de bibliotecă + interval de reverificare. Securitate: cheia API completă (tot) și cheia NZB (doar adăugare - sigur de dat site-urilor de indexer), ambele rotibile live. Interfață: sunete la clic, notificări desktop la finalizare, interval de resortare a providerilor.

Unități de viteză live decide cum este afișată fiecare viteză din panou: megaocteți (MB/s, norma managerelor de descărcare, valoarea implicită) sau megabiți (Mb/s, așa cum își anunță furnizorii liniile). Dimensiunile fișierelor rămân în octeți. Este o proprietate a daemonului, nu a navigatorului tău, deci se aplică oricărui dispozitiv care privește această instalare.

Avansat: setări fără control în panou

Patru setări nu au nici control în interfață, nici opțiune în linia de comandă. Setează-le prin API (§16), de ex. /api?mode=config&name=verify_mode&value=lean&apikey=…. Ca toate celelalte, ajung în settings.json.

10 · Automatizare

Watchlist

Cea mai simplă automatizare: adaugă un titlu pe panou, setează preferințele de calitate, gata. Release-urile noi sunt preluate pe măsură ce apar în grupurile tale indexate; copiile de calitate mai bună fac upgrade preluărilor anterioare; o vizualizare de tip calendar arată ce urmează.

Feeduri RSS

Setări → RSS: orice URL RSS newznab/indexer cu interval per feed, categorie și reguli de filtrare (tipare de titlu, limite de dimensiune). Elementele care se potrivesc sunt descărcate automat.

Foldere inteligente

Reguli evaluate când un job este adăugat: potrivire după tipar/cuvinte-cheie și dimensiune, atribuie o categorie (prima potrivire câștigă). Cu arhivarea TV activă, episoadele TV terminate sunt redenumite și arhivate ca Show/Season 01/Show - S01E02.mkv - gata pentru Plex/Jellyfin fără un instrument extern.

Planificator

Programul săptămânal (vezi §9) automatizează pauza/reluarea/viteza după ora zilei.

Scripturi

Un script de post-procesare primește argumentele poziționale ale SABnzbd și variabilele de mediu SAB_* - ecosistemul mare de scripturi SAB rulează ca atare.

11 · Sonarr, Radarr și prietenii

nzbfast vorbește nativ API-ul SABnzbd, așa că fiecare *arr funcționează imediat - și poate acționa și ca indexer al lor.

Ca client de descărcare

1. În Sonarr/Radarr: Settings → Download Clients → adaugă SABnzbd.
2. Host: mașina ta nzbfast · Port: 6789 · Cheie API: cheia ta API completă (Setări → Securitate; controlul QR/copiere este lângă ea).
3. Categorie după preferință (ex. tv / movies). Test → bifă verde → Save.

Coada, istoricul, starea per job, „remove & delete”, reîncercarea și rutarea pe categorii se comportă toate cum se așteaptă *arr-urile.

Ca indexer (newznab)

1. Settings → Indexers → adaugă Newznab.
2. URL: http://<host>:6789/ · Calea API: /api · cheie: cheia ta API.
3. nzbfast servește interogările caps, search, tvsearch și movie din propriul index al grupurilor tale urmărite, iar /getnzb/<id> returnează NZB-ul.

12 · Telefon și aplicații la distanță

nzbfast implementează ambele protocoale majore de control la distanță, așa că aproape fiecare aplicație de mobil/tabletă funcționează. Alege protocolul pe care îl acceptă aplicația ta:

Aplicații care vorbesc NZBGet (nzb360, LunaSea, NZB Unity…)

Întreaga suprafață JSON-RPC folosită de aceste aplicații este servită: stare, coadă cu reordonare/pauză/ștergere, istoric, adăugare-NZB, limită de viteză, pauză/reluare, jurnal.

Aplicații care vorbesc SABnzbd

Panoul pe telefonul tău

Doar deschide http://<machine>:6789 într-un browser mobil - întregul panou și perete au un aspect tactil. Panoul Setări → Acces la distanță arată URL-urile exacte și un cod QR de scanat.

13 · Instrumente de performanță

Benchmark de sistem

Un singur clic măsoară cele trei plafoane ale tale - debitul de rețea (o sondă reală de 8 secunde cu mai multe conexiuni), rata de verificare CPU și viteza de scriere pe disc - și începe cu răspunsul: viteza maximă de descărcare estimată și care plafon este limita. Bara cea mai scurtă este strangularea ta; celelalte arată marja lor. Programează-l (la 6 ore → săptămânal) și fiecare rulare este înregistrată într-un tabel de istoric, ca să poți vedea când providerul, ISP-ul sau hardware-ul tău și-au schimbat comportamentul. Rulările programate au loc doar când coada e inactivă.

Reglarea conexiunilor

Măsoară un provider la numere crescânde de conexiuni și recomandă setarea - mai multe socketuri ajută până când providerul sau linia ta se saturează, iar unii provideri penalizează cererea excesivă. Testează tot compară fiecare provider, apoi le pornește pe toate împreună pentru a verifica dacă pool-ul îți saturează linia.

Diversitatea serverelor

Eșantionează cu STAT articole de diferite vârste pe fiecare server și grupează providerii după lacunele comune: providerii cu ~100% articole lipsă comune sunt același backbone (redundant pentru recuperare); cei independenți îți extind cu adevărat acoperirea. Se încheie cu o recomandare în limbaj clar.

Inteligență automată a cozii

• Amânare automată: o descărcare care șchioapătă pe un singur server lent în timp ce alte joburi așteaptă este parcată la coadă (jurnalul îi păstrează progresul) și reîncercată când coada e liberă.
• Preîncărcare pe serverele inactive: serverele care nu pot ajuta jobul activ (copiile lor au dispărut) încep între timp să descarce următorul job din coadă. Niciun alt client nu face suprapunere între joburi.
• Suprapunere între joburi: în timp ce coada unui job terminat (verificare/extragere) se finalizează pe disc, descărcarea următorului job deține deja linia.

Oracolul de disponibilitate

Retragerile sunt principalul motiv pentru care eșuează o descărcare Usenet și sunt previzibile: același release dispare de pe un backbone în timp ce altul încă îl are. nzbfast ține un mic registru al a ceea ce au servit efectiv propriii tăi provideri și cheltuiește un buget minuscul de sondaje STAT în repaus (câteva sute pe oră și pe server, niciodată în timpul unei descărcări) ca să-l țină la zi. Nu descarcă niciodată încărcătură utilă pentru asta.

Ce obții din asta:

• Un verdict de disponibilitate pe plachetele peretelui și pe rândurile indexului (§6): „?” chihlimbariu pentru incert la providerii tăi, roșu pentru dispărut cu certitudine. Fără marcaj înseamnă că arată bine.
• O insignă curățat pe grupurile unde postările proaspete sunt deja retrase, ca să deosebești un grup pe moarte de un release ghinionist.
• Sari peste providerii pe care oracolul i-a scos din calcul (Setări, dezactivat implicit, experimental): când verificarea e sigură că backbone-ul unui provider a pierdut un release, acesta e sărit direct pentru descărcarea respectivă, în loc să se aștepte eșecul. Nu va sări niciodată peste ultimul tău provider rămas.

Verdictul este o predicție pornind de la indicii, nu o garanție. Pentru un răspuns ferm despre un NZB, nzbfast check (§15) numără articolele reale.

Buget de memorie - și cât costă memoria redusă

Toate cache-urile motorului împart un singur buget (implicit ¼ din RAM-ul fizic, limitat la 256 MB–16 GB). Setează-l explicit cu Limită de memorie în Setări sau cu --mem-limit pe linia de comandă.

nzbfast este construit să-ți satureze rețeaua și discul în același timp, iar RAM-ul este ce îi permite să facă ambele într-o singură trecere: articolele sunt decodate, verificate și scrise direct la offset-urile lor finale, așa că volumele de arhivă nu trebuie să atingă deloc discul. Înfometează-l de memorie și nimic nu se rupe - fiecare cache are o cale de spill, iar motorul degradează spre mai mult I/O pe disc în loc să facă swap sau să eșueze. Dar acel spill nu e gratuit, iar la joburi mari îl poți măsura.

Măsurat pe o singură mașină și o singură linie (M1 Ultra, 10 GbE), aceleași fișiere la fiecare buget. Fiecare rulare a produs un rezultat corect, complet verificat și extras:

Memoria de vârf urmărește bugetul, nu jobul: acea descărcare de 190 GB se finalizează în aproximativ 1.1 GB de RAM. Ce plătești în schimb este timp - și doar la joburi mari.

• Până la ~35 GB, memoria redusă e gratuită. Setul de lucru încape indiferent, așa că o mașină de 4 GB termină un astfel de job la fel de repede ca una de 64 GB.
• Peste ~87 GB plătești 20–40% - dar numai când linia ta întrece discul. Blocurile de verificare și volumele de arhivă care ar fi rămas în RAM sunt scrise pe disc și citite înapoi, iar asta costă timp doar dacă rețeaua poate livra mai repede decât poate discul să absoarbă traficul suplimentar. Cei 20–40% de mai sus au fost măsurați pe 10 GbE; același job de 87 GB la aceleași bugete pe o linie de ~2.4 Gbps nu a arătat nicio penalizare (−1 până la +7%, în zgomotul de la o rulare la alta). Penalizarea este o funcție a cât de mult întrece linia discul, nu a dimensiunii jobului - pe o conexiune casnică tipică, un buget mic este aproape gratuit chiar și la joburi foarte mari.
• Penalizarea se aplatizează. Odată ce un job este suficient de mare pentru a face spill, fiecare buget constrâns face spill aproximativ la fel - rulările de 2 GB, 1 GB și 256 MB citesc înapoi în esență același număr de blocuri de pe disc și se termină în limita zgomotului una față de alta. Așa că puțin mai mult RAM sub pragul care evită complet spill-ul nu îți recuperează costul: dă-i destul cât să țină jobul în memorie, sau cifra exactă abia contează.

Pe un NAS mic, scade și Conexiunile (2–4) odată cu bugetul. La un buget de 256 MB și 2 conexiuni, memoria de vârf rămâne aproape de 190 MB - confortabil în ce are liber un NAS de 2 GB. Ține cont că în acel punct numărul de conexiuni, nu memoria, este ce te limitează: același job de 35 GB a durat 286 s în loc de 65 s. Aceasta este forma onestă a compromisului - va termina întotdeauna și va termina corect; doar nu va satura linia.

Benchmark-urile sunt rerulate pentru fiecare release; metoda și cifrele per mașină sunt publicate alături de rezultate.

14 · Actualizări

• Actualizările sunt doar notificare: nzbfast nu își descarcă și nu își înlocuiește niciodată propriul binar și nu conține cod care să poată face asta. Când există o versiune nouă, antetul arată ⬆ v X disponibilă - descarcă; cipul duce la pagina oficială de descărcare (linkul e fixat în aplicație, nu vine niciodată din manifestul de actualizare). Instalează versiunea nouă la fel cum ai instalat-o pe cea curentă.
• nzbfast verifică versiunile noi de două ori pe zi. Dezactivează Verifică actualizările (Setări) și nu mai contactează deloc manifestul de actualizare; un URL de verificare gol face același lucru.

15 · Linia de comandă

Tot ce face daemonul poate fi și scriptat. Comenzile de zi cu zi:

Disponibile și: inspect, probe, bench, bench-cpu, soak, fetch, spots/spot-search/spot-get (Spotnet), make-release-nzb/make-test-nzb (fixturi de test). Fiecare comandă acceptă --config și --help. Li se adaugă post: încarcă fișiere ca articole yEnc și scrie NZB-ul corespunzător. Este o unealtă de operare, cere un --post-server explicit și nu alege niciodată un server în locul tău.

16 · Prezentare API

Endpoint de bază: http://host:6789/api?mode=…&apikey=…&output=json - compatibil SABnzbd, așa că integrările SAB existente funcționează neschimbate. Două chei: cheia API (control complet) și cheia NZB (doar adăugare: addfile/addurl).

17 · Fișiere și locații

18 · Depanare

nzbfast - acest manual vine cu fiecare release. Setările, endpointurile și valorile implicite menționate aici corespund versiunii cu care a fost livrat.