⚡ 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-<version>-windows-x64-setup.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

Cheia ta API

La o instalare cu adevărat nouă, nzbfast își face singur o cheie API prima dată când pornește daemonul și o afișează o singură dată într-un banner chiar sub adresa panoului. De atunci înainte fiecare cerere are nevoie de acea cheie, așa că panoul și API-ul nu rămân deschise pentru tot ce poate ajunge la mașină.

Ce faci cu ea depinde de cum ai pornit nzbfast:

• Aplicația de macOS, tray-ul de Windows sau serve --open: nimic. Ele dau cheia ferestrei de browser pe care o deschid, panoul o ține minte și ești deja autentificat.
• Un browser deschis de tine, sau panoul pe un telefon ori pe alt calculator: pagina cere cheia o dată și o ține minte după aceea.
• Sonarr, Radarr, nzb360 și prietenii: lipește-o drept cheia lor de SABnzbd sau NZBGet (§11, §12).

Cheia se păstrează într-un fișier numit apikey lângă fișierul tău de configurare, așa că rămâne aceeași peste reporniri și o poți citi înapoi oricând ai nevoie. Pe macOS și Linux acel fișier poate fi citit doar de contul care rulează nzbfast. Apare și în ieșirea proprie a daemonului, deci cardul Jurnal din panou o are dacă terminalul a derulat între timp.

Ca să folosești o cheie proprie, scrie-o în Setări → Securitate; se aplică imediat. Panoul acela schimbă cheia, dar nu arată niciodată cheia curentă, așa că citește fișierul apikey dacă ai nevoie înapoi de valoarea generată. Ca să rulezi fără nicio cheie, fiindcă ceva din fața lui nzbfast se ocupă deja de autentificare, pornește-l cu NZBFAST_OPEN=1 în mediu. nzbfast rămâne atunci deschis și o spune clar la pornire.

Ce mașini pot ajunge la daemon este o alegere separată: serve --bind. Valoarea implicită este 0.0.0.0, adică fiecare interfață de rețea, pentru că un NAS, un telefon și un Sonarr de pe alt calculator trebuie să se poată conecta toate. --bind 127.0.0.1 îl restrânge la mașina pe care rulează nzbfast, ceea ce vrei pe un desktop singur unde nimic altceva nu are nevoie de acces.

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, cât a contribuit fiecare server la acest job și o linie "adăugat de" care spune de unde a venit jobul (folderul monitorizat, o aplicație conectată, API-ul…). Un buton Descarcă fișierul .nzb îți salvează fișierul .nzb al jobului - nzbfast păstrează propria copie, așa că funcționează pentru fiecare job, chiar și când fișierul original a dispărut demult.
• 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, câte un rând fiecare. 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. Sertarul fiecărui rând spune cine a adăugat jobul și are același buton Descarcă fișierul .nzb ca în coadă - util pentru a descărca un release din nou în altă parte, sau pentru a atașa fișierul .nzb la un raport de problemă.

Cardul listează implicit zece descărcări, iar restul sunt la un clic distanță, pe butonul ▤. Starea, locația și motivul pentru care un job a eșuat stau în spatele unui clic pe rândul însuși, astfel încât cazul obișnuit - ce s-a terminat, cât de mare, când - rămâne lizibil fără derulare. Trage în schimb de marginea de jos a cardului ca lista să deruleze la o înălțime aleasă de tine. History rows din Setări → Interfață schimbă acel zece; fiind o proprietate a daemonului și nu a browserului tău, se aplică fiecărui dispozitiv care se uită la această instalare. Colour History names, alături, colorează numele terminate în verde și pe cele eșuate în roșu; dezactivat, numele rămân neutre, iar punctul colorat și detaliile rândului spun în continuare care e care.

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 arhivelor criptate sunt preluate automat din <meta type="password"> din NZB, dintr-un nume de fișier Name{{password}}.nzb sau din câmpul p= al unei legături nzblnk, și pot fi date per sarcină prin API sau ulterior din Istoric (🔑).

Legăturile nzblnk

Unele board-uri, mai ales germane și olandeze, publică o legătură nzblnk: în loc de un fișier NZB. Postarea este ofuscată, deci nu există niciun nume de fișier către care s-ar putea trimite. Legătura duce în schimb un antet, h=, care este o cheie de căutare și nu o locație, plus un titlu t=, o parolă p= și un grup g= opționale. Cineva trebuie mai întâi să se ducă și să găsească postarea.

nzbfast caută antetul mai întâi în propriul index, ceea ce nu cere deloc rețea, și abia dacă acolo nu îl găsește întreabă indexatoarele de căutare pe care le-ai configurat (Setări → Indexatoare de căutare, §9), sub aceleași bugete zilnice și aceeași retragere ca orice altă căutare. Titlul devine numele sarcinii, iar parola se aplică automat.

• Lipirea sau tragerea merge pe orice instalare, Docker și cutii NAS incluse: copiază legătura de pe board și lipește-o oriunde pe panou.
• Clicul pe o legătură cere ca schema să fie înregistrată la desktopul tău. Aplicația din DMG-ul macOS o înregistrează, iar instalatorul Windows o oferă ca sarcină: întreabă mai întâi și lasă schema în pace dacă NZB Monkey sau NZBDonkey o deține deja. Arhiva macOS simplă, Homebrew și instalările Linux nu au niciun handler de desktop, acolo calea de intrare este lipirea.
• Rezolvarea este limitată ca ritm intenționat. O schemă înregistrată stă la o singură solicitare de browser distanță de orice pagină pe care o vizitezi, deci legăturile au un plafon pe minut și doar primele câteva dintr-un minut pot ajunge la indexatoarele tale; dincolo de asta se răspunde doar din indexul local.

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:

Lasă puțină marjă sub limita de conexiuni a contului tău. Setarea conexiunilor puțin sub limită nu costă nimic: debitul se aplatizează cu mult înainte de ultimele una sau două conexiuni, iar Reglarea conexiunilor (§13) rămâne oricum sub ea. Acele locuri libere sunt cele care lasă un al doilea dispozitiv, alt client sau o reîncercare după un socket căzut să intre totuşi, în loc să fie refuzate în timp ce acesta ocupă fiecare loc.

Cum sunt păstrate parolele furnizorilor tăi

Parolele de furnizor din config.local.json sunt ofuscate, nu criptate. Sunt scrise ca obf1: urmat de o formă codificată, așa încât fișierul să nu se citească drept text simplu dacă apare într-o captură de ecran, într-un mesaj de forum, într-un raport de eroare sau pe un ecran pe care îl vede altcineva.

Să fim limpezi cu ce îți aduce și ce nu:

• Nu este criptare și nu oferă nicio protecție față de cine are fișierul. Metoda se află în sursele noastre publice, iar decodorul vine chiar în nzbfast, deci oricine ține fișierul scoate parola în câteva secunde. Tratează fișierul ca pe un secret exact cum ai face-o dacă parolele ar fi lizibile.
• Elimină scurgerea din neatenție, care este cea obișnuită. Configurațiile ajung lipite în fire de suport și prinse în capturi de ecran mult mai des decât sunt furate de pe disc.
• O parolă pe care ai scris-o tu ca text simplu funcționează în continuare. nzbfast citește ambele forme, deci configurațiile editate de mână și importurile din alți clienți nu se strică niciodată; scrie forma ofuscată la următoarea salvare.
• Fișierul este scris, în plus, lizibil doar pentru contul care rulează nzbfast (mod 0600 pe macOS și Linux).

Prin comparație, NZBGet și SABnzbd păstrează amândouă parolele de furnizor ca text lizibil în fișierele lor de configurare. Considerăm ofuscarea o mică îmbunătățire față de asta, nu o funcție de securitate.

De ce nu inelul de chei al sistemului? Keychain pe macOS, Managerul de credențiale din Windows și serviciile de secrete din Linux ar da o protecție reală și poate revenim asupra ei. Astăzi ne opresc două lucruri. Accesul la inelul de chei ține de identitatea aplicației, iar nzbfast încă nu este semnat, așa că solicitările și comportamentul după fiecare actualizare sunt proaste. Și o parte mare a instalărilor sunt Docker, servere fără ecran și cutii NAS unde nu există niciun inel de chei, ceea ce ar lăsa două căi diferite de stocare de ținut corecte. Un singur format bine înțeles, care se poartă la fel peste tot, este deocamdată târgul mai bun.

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 în timpul descărcării alege cât se verifică pe măsură ce datele sosesc. Completă confirmă fiecare bloc PAR2 cu MD5. Rapidă (implicită) revendică blocurile prin CRC32, ceea ce e de 2-3x mai rapid pe un procesor lent, și verifică în continuare suma de control proprie fiecărui articol. Sobră sare în plus peste acele sume ale articolelor de îndată ce PAR2 acoperă un fișier: dauna apare atunci o clipă mai târziu, la blocul ei. În toate trei, trecerea finală și orice reparație folosesc MD5 complet, iar o descărcare fără fișiere PAR2 își păstrează sumele articolelor.

Disc și cotă live

Spațiu liber minim (pune în pauză joburile noi sub el; 2 GB implicit, 0 îl dezactivează), 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.

Fișierele șterse ajung în Coșul de gunoi decide ce înseamnă "ștergere" mai sus. Cu ea activă, curățarea mută fișierele în Coșul de gunoi al sistemului (Recycle Bin), astfel încât o presupunere greșită despre ce era gunoi poate fi anulată; cu ea oprită, fișierele sunt șterse definitiv. Este activată implicit pe macOS și Windows, unde Coșul de gunoi este un loc pe care îl vezi și îl poți goli, și dezactivată implicit pe Linux, unde de obicei nu este.

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

Păstrează fișierele .nzb după preluare (dezactivată implicit) lasă fișierul .nzb original în folderul monitorizat după ce a fost pus în coadă, în loc să-l mute la coșul de gunoi - pentru colecționari, și pentru a da fișierul cuiva când o descărcare face probleme. Un fișier păstrat este ținut minte, inclusiv peste reporniri, și nu mai este pus în coadă; salvează-l din nou pentru a-l descărca încă o dată. Oricum ai alege, sertarul fiecărui job are un buton Descarcă fișierul .nzb, așa că o copie a fișierului .nzb al oricărui job nu e niciodată la mai mult de un clic distanță.

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. Fiecare casetă înlocuiește cheia de care ține de îndată ce ieși din câmp, iar o casetă lăsată goală păstrează cheia pe care o are deja. Cheia API are în plus Show, care dezvăluie și copiază cheia curentă ca s-o lipești în Sonarr, Radarr sau NZB360 când ai chef, și Create new, care bate una de schimb - cheia veche încetează să funcționeze imediat, așa că tot ce este deja conectat trebuie să primească pe cea nouă. Ambele depind de cheia API însăși: cheia NZB doar-adăugare nu o poate citi, ceea ce este chiar rostul acelei chei. Pentru de unde vine cheia pe o instalare nouă, vezi §2. 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: butoanele din spatele celor evidente

Șase setări fără opțiune în linia de comandă. Fiecare are acum un rând avansat pe cardul de setări căruia îi aparține și rămâne accesibilă 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ă (unde o găsești: §2).
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.

Accesul la nzbfast din afara casei

Nu există o pagină de autentificare, iar asta este intenționat. Un login cu cookie de sesiune este o suprafață de securitate de întreținut la nesfârșit și ar rămâne oricum cea mai slabă încuietoare a oricărui lucru expus pe internet. nzbfast se autentifică în schimb cu cheia ta API și acceptă cheia atât într-un antet al cererii, cât și în URL (X-Api-Key sau Authorization: Bearer) - exact ceea ce permite unui serviciu aflat în față să se ocupe cum trebuie de autentificare.

Cel mai simplu este să nu îl publici deloc. Instalează Tailscale pe această mașină și pe telefon, iar amândouă intră în aceeași rețea privată: nimic nu este expus, nu e nevoie de router sau certificate, iar Setări → Acces la distanță afișează o adresă care funcționează de oriunde de îndată ce vede Tailscale pornit. Alege această cale dacă nu ai nevoie explicit de un domeniu public.

Dacă ai nevoie, pune în față un proxy invers, dă-i certificatul și lasă-l pe el să facă autentificarea. Pornește nzbfast cu --bind 127.0.0.1, ca proxy-ul să fie singura cale de intrare, și îndreaptă proxy-ul spre http://127.0.0.1:6789:

# Caddy
example.com {
    reverse_proxy 127.0.0.1:6789
}

# nginx
location / {
    proxy_pass http://127.0.0.1:6789;
    proxy_set_header Host              $host;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

Adaugă deasupra ce oferă proxy-ul tău: autentificare basic, un serviciu de forward-auth precum Authelia sau Authentik, ori certificate de client. Un lucru îi prinde pe toți - Sonarr, Radarr și aplicațiile de telefon nu pot parcurge o autentificare din browser, așa că lasă-le o cale pe lângă. Majoritatea proxy-urilor pot lăsa să treacă o cerere cu un antet X-Api-Key valid și pot cere autentificare pentru tot restul.

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.

Actualizarea fără să-ți pierzi setările

O singură regulă acoperă fiecare instalare: o actualizare înlocuiește programul, niciodată setările tale. Tot ce ai configurat - serverele, căile, cheia API, coada - trăiește într-o mână de fișiere dintr-un singur folder (§17), și niciun program de instalare, pull de imagine sau upgrade de pachet nu atinge acel folder. Când setările chiar par dispărute după o actualizare, aproape întotdeauna e pentru că noua instalare citește un folder diferit, gol, nu pentru că ceva ar fi fost șters; fișierele vechi sunt tot acolo unde au fost mereu. §18 are pașii de recuperare.

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), predb-seed (umple baza de pre-uri cu perioada de dinainte de pornirea fluxului), 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). addnzblnk lipsește intenționat din setul de doar adăugare: rezolvarea unei legături poate consuma cotă contorizată de indexator, ceea ce nu este treaba unei credențiale de doar adăugare.

17 · Fișiere și locații

Unde se află folderul de setări depinde de felul în care a fost instalat nzbfast. Acest singur folder conține tot ce merită salvat într-un backup:

Și ce se află în el:

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.