⚡ 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

Cardul de bun venit te întreabă și cum ai de gând să folosești nzbfast, cu patru răspunsuri: o aplicație precum Sonarr sau Radarr îl conduce, treci de la SABnzbd, treci de la NZBGet, sau doar tu, din acest panou. Alegerea uneia nu schimbă nimic de la sine. Afișează o listă scurtă de revizuit - fiecare recomandare cu numele propriu al setării, valoarea ei curentă, valoarea recomandată și un rând de motivație - iar Aplică setează doar rândurile pe care le bifezi. Fiecare rând este o setare obișnuită pe care o poți schimba înapoi de una singură după aceea, iar aceeași listă rămâne disponibilă și mai târziu sub Setări → Setări recomandate după felul în care îl folosești.

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

Cardul poate urmări și o listă pe care o ții în Plex. Adaugă o sursă de listă: fie îți conectezi contul Plex (aprobi un cod scurt chiar pe pagina Plex, așa că nicio parolă nu ajunge vreodată la nzbfast), fie lipești adresa watchlist-ului tău Plex. Tratează adresa ca pe o parolă - oricine o are îți poate citi lista - motiv pentru care este mascată după salvare. Titlurile sincronizate apar ca rânduri doar-citire lângă ale tale. Un cont conectat vede întreaga listă, așa că un titlu șters acolo nu mai este urmărit nici aici (descărcările finalizate nu sunt atinse niciodată); o adresă arată doar cele mai noi intrări, deci un titlu lipsă poate pur și simplu să fi ieșit din listă și nimic nu este șters. Oricare dintre comportamente poate fi schimbat per sursă.

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ță.

Aranjarea panoului

Panoul este al dumneavoastră, ca să îl aranjați. Patru operații, numite la fel oriunde le întâlniți: Mută un card, Compactează-l, Redimensionează-l sau Ascunde-l. Fiecare alegere este reținută de browserul în care ați făcut-o, așa că fiecare dispozitiv își păstrează propria aranjare, iar Resetează aspectul din Setări → Interfață readuce fiecare card, dimensiune și coloană așa cum au venit.

Personalizează aspectul este calea ghidată și cel mai rapid mod de a vedea ce poate face un card. Deschideți-l din legătura discretă chiar deasupra primului card sau din Setări → Interfață, unde este primul buton de pe rândul Aspectul panoului. Cât timp este pornit, fiecare card care poate fi rearanjat este conturat, cele trei unelte de pe rândul titlului sunt desenate la intensitate maximă, cu cuvântul lor lângă pictogramă, iar fiecare bară de redimensionare este trasată în culoarea de accent; un card fără bară spune de ce pe un rând al lui, în loc să vă lase să căutați una. Gata sau tasta Escape iese. Modul este un fel de a privi pagina, nu o setare: nu schimbă nimic din aranjarea dumneavoastră și, după o reîncărcare, este din nou oprit.

Pe un panou pe care nu l-a aranjat încă nimeni, un rând de deasupra cardurilor spune că ele pot fi mutate, redimensionate, compactate sau ascunse și arată spre acea legătură. Apare o singură dată: Am înțeles îl închide, la fel ca deschiderea modului sau aranjarea oricărui lucru.

• Mută. Trageți un card de titlul lui. Tot antetul este mânerul, nu doar pictograma mică din stânga lui, așa că nu există nicio țintă dificilă de nimerit. Pictograma este și o oprire de tabulare: dați-i focalizarea și tastele săgeată sus și jos mută cardul.
• Compactează. Butonul de lângă mâner strânge spațierea acelui card: aceleași cifre, mai puțin loc. Pe Istoric comută între cele mai recente zece descărcări și restul istoricului dumneavoastră. Mod compact din Setări → Interfață face tot panoul dintr-o dată.
• Redimensionează. Un card care ține o listă sau un grafic are o bară de-a lungul marginii de jos: trageți-o până la înălțimea dorită. Bara este ștearsă până când arătați spre card, când se desenează ca o linie subțire pe toată lățimea, cu striații în colțul din spate; primește și focalizarea de la tastatură, unde săgețile sus și jos stabilesc înălțimea, iar Shift face un pas mai mare. Care carduri au una se schimbă pe măsură ce cardurile capătă și pierd liste proprii: luați bara drept răspuns, nu vreo listă de aici. În Personalizează aspectul, cardurile fără bară o spun singure.
• Ascunde. Ultimul buton de pe rândul titlului ascunde acel card. Cardurile ascunse se adună într-o bară Ascunse la piciorul panoului; faceți clic pe un nume de acolo ca să aduceți unul înapoi.

Un clic dreapta pe titlul unui card adună aceleași operații într-o singură listă: Mută în sus, Mută în jos, Compactează, Redimensionează și Ascunde, plus o cale spre Personalizează aspectul când nu sunteți deja acolo. Redimensionează este oferit doar pe un card care are o bară de tras. Mută în sus și Mută în jos se estompează la capete și numără doar cardurile pe care le vedeți: un card ascuns este sărit, deci primul și ultimul înseamnă primul și ultimul vizibil.

Acel meniu este o cale de tastatură la fel de mult ca una de maus. Ajungeți cu Tab la mânerul de mutare al unui card, apăsați tasta Meniu contextual sau Shift+F10 și se deschide sub antet. Săgețile sus și jos îl parcurg și sar peste tot ce este estompat; Escape îl închide și dă focalizarea înapoi mânerului din care l-ați deschis. Alegerea Redimensionează duce focalizarea la bara acelui card, unde săgețile sus și jos stabilesc înălțimea, iar Shift face un pas mai mare.

Escape închide întotdeauna doar stratul de deasupra. Închiderea meniului unui card cât timp modul este pornit lasă modul pornit; un al doilea Escape iese din mod.

Cardurile panoului din Setări → Interfață oferă aceeași aranjare sub forma unei liste obișnuite de controale: o casetă Afișează pentru fiecare card, o casetă Compact alături și butoanele Mută în sus și Mută în jos. Pe un telefon, pe o tabletă sau în orice fereastră îngustă, uneltele cardului și tragerea sunt oprite, pentru că tragerea unui card pe o pagină care se derulează sub deget este un control prost: acolo lista aceasta aranjează panoul. Ea scrie ceea ce citește calculatorul, așa că o ordine stabilită pe telefon este ordinea pe care o arată calculatorul. Butoanele ei urmează regula meniului: se estompează la capetele cardurilor vizibile, iar un card pe care l-ați ascuns nu poate fi mutat până nu îl afișați din nou.

Coloanele tabelelor se aranjează pe loc, nu din cele de mai sus. În tabelele cozii, istoricului și indexului, trageți antetul unei coloane în lateral ca să mutați coloana, sau marginea lui din spate ca să o redimensionați; un dublu clic pe acea margine readuce lățimile. Cu un antet focalizat, tastele săgeată stânga și dreapta îl mută, iar Shift cu o săgeată îl redimensionează.

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

Căutarea pe conturile tale de indexer

Dacă ai cont pe un site indexer de NZB, nzbfast poate căuta acolo de aici și poate pune în coadă ce alegi, în loc să te duci pe site, să descarci un NZB și să-l aduci înapoi. Vorbește interfața de indexer obișnuită pe care o oferă toate acele site-uri, așa că nu e nimic de configurat de la site la site: NZBGeek, NZBFinder, DrunkenSlug, DOGnzb și celelalte funcționează la fel. O instanță Prowlarr sau NZBHydra2 este tot o singură intrare și aduce cu ea fiecare indexer din spatele ei.

Adăugarea unui cont. Setări → Caută pe indexere → + Adaugă indexer. Completează un nume la alegerea ta, adresa de API a site-ului (adresa lui web obișnuită e de ajuns; o intrare Prowlarr arată așa: http://host:9696/1/api) și cheia API din pagina ta de cont de acolo, apoi Aplică indexerele. Testează întreabă site-ul ce acceptă și arată ce a venit înapoi, ceea ce dovedește adresa și cheia dintr-un clic. O cheie salvată nu mai este arătată niciodată: căsuța o spune, iar dacă o lași goală păstrezi cheia care este deja acolo.

Căutarea. Deschide 🎬 peretele din antet și treci la lista de release-uri. Meniul de lângă caseta de căutare hotărăște unde se uită o căutare: Acest index, adică ce a scanat singură mașina asta, Indexere sau Ambele. Alegerea ta este ținută minte. Ca să întrebi conturile trebuie să scrii ceva în casetă, fiindcă răsfoirea lor cu o interogare goală ar cheltui alocarea unei zile pe o listă pe care nu a cerut-o nimeni. Cu indexerul încorporat oprit, așa cum vine nzbfast, nu sunt afișe de arătat, iar pagina este exact atât: o casetă de căutare, conturile tale și rezultatele.

Rezultatele. Un rând pe release, cele mai noi întâi, cu mărimea, vechimea și de câte ori l-au luat utilizatorii acelui indexer. Un release pe care îl au mai multe dintre conturile tale apare o singură dată. La Ambele, copia pe care indexul tău o are deja câștigă, iar cea din exterior cade, fiindcă a lua ce ai indexat deja nu te costă nimic. Descarcă îl pune în coadă cu prioritate mare: nzbfast aduce singur NZB-ul, iar de acolo sarcina e ca oricare alta, cu reparare, extragere, categorii și scripturi neschimbate.

Întrebarea despre un singur titlu. Deschide fișa unui titlu de pe perete și apasă ⌕ Caută pe indexerele mele. La filme întrebarea merge pe numărul IMDb oriunde site-ul acceptă unul, iar asta e diferența dintre filmul la care te gândeai și orice release al cărui nume conține din întâmplare acele cuvinte. nzbfast caută singur numărul, așa că pagina nu ține niciodată vreunul. Site-urile care nu oferă potrivire după număr sunt întrebate în cuvinte.

Alocarea ta. Conturile de indexer sunt măsurate: atâtea căutări și atâtea descărcări pe zi, după planul tău. Pune cele două numere pe intrare și nzbfast scade din ele, luând-o de la capăt la miezul nopții UTC. 0, valoarea implicită, înseamnă nelimitat, iar numărătoarea continuă oricum. Un cont care și-a cheltuit alocarea stă deoparte cât lucrează celelalte, iar un rând deasupra rezultatelor îl numește pe cel sărit: epuizarea nu este niciodată tăcută. Un site care răspunde cu o limită proprie, sau care ne cere să încetinim, este pus deoparte pentru o oră.

Unde ajunge cheia ta. Doar la indexerul căruia îi aparține. Cheile rămân pe mașina asta, nu ajung niciodată la browser - fiecare rând de rezultat poartă un tichet valabil o jumătate de oră în locul unei legături - și sunt scoase din jurnal și din orice eroare întoarsă de site, așa că un mesaj de eroare lipit nu poate scăpa niciuna. O descărcare poate aduce doar o legătură pe care a întors-o una dintre căutările tale.

Sunt aceleași conturi la care recurge o legătură nzblnk când indexul local nu îi recunoaște antetul, și cele pe care watchlistul le poate întreba despre elementele dorite (§10).

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 → Caută pe indexere, §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ă.

Prima jumătate din asta este deja pe pagină. Deschide rândul unei descărcări în coadă (sau în istoric), iar sertarul arată ce se află în fișierul video, citit din baiții sosiți până acum: rezoluție, codecuri video și audio, limbi audio, subtitrări, capitole. O lansare care este montajul greșit, limba greșită sau un upscale se dă de gol în acel panou cu mult înainte ca descărcarea să se termine.

Pagina își dă seama și dacă acest browser poate reda fișierul, și o spune în loc să ghicească: browserele diferă (Safari decodează HEVC acolo unde Chrome nu, și aproape niciunul nu decodează audio AC-3 sau DTS), așa că întrebarea este pusă browserului în care te afli de fapt. Când răspunsul e da, ▶ Redă deschide un player chiar în pagină, care arată fișierul în timp ce se descarcă. Majoritatea lansărilor sunt MKV, pe care multe browsere refuză să îl deschidă deși pot decoda tot ce se află înăuntru, așa că nzbfast le reîmpachetează în timpul redării. Nimic nu este recodat: imaginea și sunetul sunt octeții originali într-un alt ambalaj, iar saltul la alt moment funcționează în continuare. Dacă pista audio este una pe care acest browser nu o poate decoda, iar lansarea poartă o a doua pe care o poate, acea a doua pistă este cea care se aude, ca imaginea să nu ajungă mută. Doar când browserului îi lipsește decodorul pentru video în sine butonul predă fișierul propriului tău player multimedia, așa cum se descrie mai jos.

O singură setare le guvernează pe toate: Setări → Interfață → Verifică un fișier în timp ce se descarcă. Doar detalii, valoarea implicită, arată panoul și nu oferă player în pagină; Detalii și un player adaugă playerul; Oprit oprește cu totul citirea fișierului - cu ea oprită, nimic nu va deschide un fișier descărcat pe jumătate pentru nimeni.

Pentru a verifica în schimb în propriul player media:

• ▶ 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.

Nu trebuie să te ocupi de limita de fișiere deschise a mașinii tale. Sistemul socotește fiecare conexiune drept un fișier deschis, iar macOS pornește un program cu o limită de 256, pe care un set complet de conexiuni răspândite pe mai multe servere o poate depăși. Pe macOS și Linux, nzbfast ridică singur această limită la pornire: cere 65536 de fișiere deschise și coboară prin 16384, 4096 și 1024 până când sistemul acceptă, fără să treacă vreodată de limita dură fixată de sistem, și merge mai departe cu limita pe care o avea dacă fiecare pas este refuzat. Windows nu are o limită de acest fel per proces. Ceilalți clienți rămân cu limita pe care le-a dat-o shell-ul, iar unul care rămâne fără fișiere deschise în mijlocul unei sarcini se poate opri fără să scrie în jurnal de ce. Așa că setează conexiunile fiecărui server după cât permite abonamentul tău, minus marja de mai sus, nu după cât crezi că duce mașina.

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ță.

Caută pe indexere live

Conturile tale pe site-uri indexer de NZB, câte un rând fiecare, ca o căutare de pe perete să le poată întreba și pe ele. Ce face funcția, și cum cauți cu ea, este la §5.

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

O sursă de listă alimentează watchlist-ul dintr-o listă pe care o ții în Plex, în unul din două moduri: îți conectezi contul Plex aprobând un cod scurt pe pagina Plex, sau lipești o adresă de watchlist Plex. Adresa este o cheie de acces - îi dă oricui o deține dreptul de a citi lista - așa că este mascată după salvare. Sincronizarea ștergerilor diferă intenționat după mod: un cont conectat vede întreaga listă, deci un titlu șters acolo nu mai este urmărit aici (descărcările deja finalizate rămân); un feed pe bază de adresă aduce doar cele mai recente intrări, deci absența nu dovedește nimic și titlurile sunt doar adăugate. Ambele valori implicite pot fi schimbate per sursă.

Caută ce vreau și pe conturile mele de indexer, la baza cardului watchlistului, îl lasă să întrebe conturile din Setări → Caută pe indexere pe lângă indexul tău (§5). Începe oprit, fiindcă este singurul lucru de aici care cheltuie un cont contorizat fără să dai tu clic. Pornit, fiecare element urmărit întreabă de vreo două ori pe zi, și doar despre ce nu a găsit deja, sub aceleași limite zilnice și cu aceleași note când un cont este sărit. Un candidat venit de la un indexer este judecat exact ca unul local, așa că pragurile de calitate, upgrade-urile, pachetele de sezon și tratarea duplicatelor se aplică toate, iar o copie locală câștigă orice egalitate fiindcă nu costă alocare. Cu indexerul încorporat oprit, asta este ce îi dă watchlistului ceva cu care să lucreze.

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. Dialectul NZBGet este oferit alături - variabilele NZBPP_* (DIRECTORY, NZBNAME, CATEGORY, TOTALSTATUS, PARSTATUS, UNPACKSTATUS, FINALDIR) și codurile de ieșire 93/94/95 - astfel că rulează și logica de bază a unui script de extensie NZBGet. Maparea este onestă, nu o emulare: repararea și dezarhivarea se petrec în interiorul descărcării într-o singură trecere, așa că o finalizare curată raportează PARSTATUS=0, iar una reparată PARSTATUS=2. Formele de opțiuni per script (NZBPO_*) nu sunt oferite. Un script poate lăsa un ajutor rulând în fundal când iese, iar nzbfast nu îl va omorî, dar nzbfast chiar încetează să citească ieșirea scriptului în clipa în care scriptul însuși se termină: dă-i unui ajutor trecut în fundal propria redirecționare a ieșirii, altfel va fi oprit prima dată când încearcă să afișeze ceva.

Script pre-coadă

Un al doilea hook rulează înainte ca o descărcare să intre în coadă (Setări → Foldere → Script pre-coadă), cu contractul pre-coadă al SABnzbd: argumentele name, pp, category, script, priority, size, group plus mediul SAB_*. Primul rând al ieșirii sale acceptă (1) sau respinge (0) descărcarea; rândurile 2-7 o pot redenumi, pot seta pp, pot schimba categoria, pot alege un script sau pot schimba prioritatea (rândurile goale păstrează valoarea implicită). O descărcare respinsă merge în istoric ca Eșuată, cu motivul, iar Reîncearcă din istoric o aduce înapoi fără a mai întreba scriptul. Hook-ul nu poate pierde niciodată o descărcare: dacă scriptul lipsește, cade, își depășește bugetul de timp sau afișează ceva ce nu este un verdict, adăugarea continuă neatinsă, iar jurnalul spune de ce.

Evenimente de ciclu de viață și webhook-uri semnate

Fiecare etapă a unui job este un eveniment versionat: job.added, job.started, job.finishing, job.repaired, job.completed, job.failed, plus queue.idle, giveup.tripped, disk.low, storage.slow și quota.reached. Fiecare poartă schema_version (acum 1; chei noi pot apărea fără o incrementare - ignoră ce nu cunoști), un seq monoton și un marcaj de timp at în milisecunde.

Pentru a le primi, adaugă o țintă de notificare webhook (Setări → Automatizare) și trece în câmpul ei events felurile de evenimente pe care trebuie să le primească - feluri exacte sau un prefix precum job.*. Ținta primește apoi un POST per eveniment: JSON-ul evenimentului drept corp plus un id delivery (<boot>-<seq>, mânerul după care deduplici), antetele X-NzbFast-Event și X-NzbFast-Delivery, și - când ținta are un secret de semnare - X-NzbFast-Signature: sha256=<hex>, un HMAC-SHA256 al baiților exacți ai corpului sub secretul tău (aceeași formă pe care o folosesc webhook-urile GitHub). Verifică în Python:

expected = "sha256=" + hmac.new(secret, body, hashlib.sha256).hexdigest()
ok = hmac.compare_digest(expected, request.headers["X-NzbFast-Signature"])

Livrarea este cel-puțin-o-dată: o țintă care nu poate fi atinsă este reîncercată după 10 s, 60 s și 5 min, apoi abandonată, cu eșecul afișat pe rândul de setări al țintei. Un răspuns de eroare HTTP (404, 401...) nu este reîncercat - repară receptorul și folosește Testul. Fiecare țintă are propria bandă de livrare, așa că una lentă sau de neatins nu o ține niciodată pe loc pe alta; în interiorul unei benzi, livrările păstrează ordinea în care s-au petrecut evenimentele, iar dacă una este abandonată, numerele de secvență arată golul. Cuvintele clasice de evenimente (completed, failed, repaired, disk, quota) își păstrează sensul de notificare umană pe aceeași țintă.

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.

Panoul îți întinde adresa: pe o instalare care nu a descărcat încă nimic, ruta „Lasă Sonarr, Radarr sau o aplicație să adauge descărcări” din cardul de bun venit arată adresa exactă cu un buton Copiază alături. Cheia API nu este pe acel rând în mod deliberat; rămâne în spatele propriei dezvăluiri în Setări → Securitate (§2).

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.

nzbfast poate servi și el însuși HTTPS. Îndreaptă Setări → Securitate → Certificat HTTPS / Cheie privată HTTPS spre un certificat PEM și cheia lui (sau pornește cu --tls-cert cert.pem --tls-key key.pem), repornește, iar panoul și API-ul răspund pe https:// în loc de HTTP simplu - un singur ascultător, o singură schemă. Folosește certificatul pe care domeniul tău îl are deja (de exemplu de la Let's Encrypt prin certbot) sau unul auto-semnat pentru LAN, pe care browserele îl acceptă după un avertisment o singură dată. Un certificat stricat sau expirat refuză pornirea cu fișierul numit, așa că greșeala este vizibilă acolo unde ai făcut-o; reînnoiește înlocuind fișierele și repornind. HTTPS-ul nativ criptează traficul, dar nu adaugă o autentificare, așa că păstrează cheia API setată.

Dacă ai nevoie de un domeniu public, 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.
• Providerii scoși din calcul de oracol sunt întrebați ultimii (Setări, dezactivat implicit, experimental): când verificarea e sigură că backbone-ul unui provider a pierdut un release, acel provider e întrebat ultimul pentru descărcarea respectivă, nu primul. Nimic nu e șters, așa că o apreciere greșită costă puțin timp în loc de descărcare.

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.