⚡ nzbfast

دانلودر سریع Usenet - راهنمای کاربر

1 · خوش‌آمدید

nzbfast از Usenet به همان سرعتی که خط، ارائه‌دهنده‌ها و ماشین شما اجازه می‌دهند دانلود می‌کند - و معمولاً یعنی به‌سرعت خط شما. این یک برنامهٔ واحد و خودکفاست: موتور، یک داشبورد وب، مرورگر رسانهٔ دیوار پوستر، یک ایندکسر داخلی، پیش‌نمایش بی‌درنگ، تعمیر بومی PAR2 و استخراج بومی RAR همگی درون یک فایل اجرایی هستند. چیز دیگری برای نصب نیست.

آنچه آن را سریع می‌کند معماری است، نه دستکاری‌های جزئی:

در سنجش برابر با رقبا روی سخت‌افزار، کارها و ارائه‌دهنده‌های یکسان، nzbfast یک دانلود 190 GB را در حدود 5 دقیقه روی یک خط 10 GbE به پایان رسانده - در حالی که گزینه‌های پیشرو در همان آزمون‌ها 30–220% عقب بودند، آن‌هم جایی که اصلاً توانستند تمامش کنند. ارقام در §3 هستند.

2 · شروع سریع

macOS

  1. nzbfast-<version>-macos.dmg را باز کنید و NzbFast را به Applications بکشید (یونیورسال: Apple Silicon + Intel).
  2. اولین اجرا: macOS هشدار می‌دهد که nzbfast هنوز توسط Apple تأیید محضری (notarize) نشده است. روی اپ کلیک راست کنید → Open - یا System Settings → Privacy & Security را باز کنید، پایین بروید و Open Anyway را بزنید. این یک گام یک‌باره است.
  3. پنجرهٔ اپ داشبورد را با یک کارت خوشامد نشان می‌دهد - رویش کلیک کنید و دست‌کم یک سرور Usenet اضافه کنید (میزبان، پورت 563، نام کاربری، رمز عبور). بعداً می‌توانید در تنظیمات موارد بیشتری اضافه کنید.
  4. یک .nzb را هرجای داشبورد رها کنید - یا فقط روی فایل‌های .nzb در Finder دوبار کلیک کنید. دانلودها در ~/Downloads/nzbfast فرود می‌آیند. از منو خارج شوید؛ دانلودها از همان‌جا که رها شده‌اند ادامه می‌یابند.

اپ نمی‌خواهید؟ زیپ ساده (باینری + راه‌انداز Start nzbfast.command، همان موتور) هنوز مثل قبل کار می‌کند - گام‌ها پایین‌تر زیر «از ترمینال».

Windows

  1. nzbfast-<version>-windows-x64-setup.exe را اجرا کنید. فقط برای کاربر شما نصب می‌شود (بدون رمز عبور مدیر). چون این نسخه هنوز امضای کد ندارد، ممکن است SmartScreen پیام «Windows protected your PC» را نشان دهد - More infoRun anyway را بزنید.
  2. nzbfast در سینی سیستم زندگی می‌کند: روی نماد سینی دوبار کلیک کنید (یا از منوی کلیک‌راست آن Open Dashboard را بزنید) تا داشبورد باز شود، سپس سرور Usenet خود را از کارت خوشامد اضافه کنید. منوی سینی همچنین مکث/ازسرگیری، پوشهٔ دانلودها و خروج دارد.
  3. دوبار کلیک روی یک فایل .nzb آن را به صف می‌افزاید. ممکن است Windows Defender یک‌بار برای اجازهٔ شنود شبکهٔ محلی بپرسد - اجازه دهید.

یک نسخهٔ قابل حمل می‌خواهید؟ -windows-x64.zip هنوز کار می‌کند: هرجا اکسترکت کنید و برای جادوگر ترمینال روی nzbfast.exe (یا Start nzbfast.bat) دوبار کلیک کنید.

از ترمینال (هر پلتفرمی)

nzbfast setup            # interactive server setup (writes config.local.json)
nzbfast serve --open     # start the daemon and open the dashboard
نکتهاز قبل SABnzbd یا NZBGet دارید؟ تایپ اعتبارنامه‌ها را رد کنید: تنظیمات → سرورهای Usenet → وارد کردن از SABnzbd / NZBGet… نصب موجود شما را پیدا و سرورهایش را کپی می‌کند. در خط فرمان هم nzbfast import-sab هست.

کلید API شما

روی یک نصب واقعاً تازه، nzbfast نخستین باری که دیمن بالا می‌آید برای خود یک کلید API می‌سازد و آن را یک بار در بنری درست زیر نشانی داشبورد چاپ می‌کند. از آن پس هر درخواستی به آن کلید نیاز دارد، پس داشبورد و API به روی هر چیزی که به ماشین می‌رسد باز نیستند.

اینکه با آن چه می‌کنید بستگی دارد به اینکه nzbfast را چگونه راه انداخته‌اید:

کلید در فایلی به نام apikey کنار فایل config شما نگه داشته می‌شود، پس در راه‌اندازی‌های مجدد همان می‌ماند و هر وقت لازم شد می‌توانید دوباره بخوانیدش. روی macOS و Linux آن فایل تنها برای حسابی که nzbfast را اجرا می‌کند خواندنی است. در خروجی خودِ دیمن هم هست، پس اگر ترمینال اسکرول شده باشد کارت گزارش داشبورد آن را دارد.

ارتقا چیزی را تغییر نمی‌دهد.نصبی که از پیش وجود دارد دقیقاً همان‌طور که بود رها می‌شود، با کلید یا بی‌کلید. کلید تنها در نخستین اجرا ساخته می‌شود - اجرایی بدون تنظیم داشبورد و بدون صف ذخیره‌شده - چون پیدا شدن کلید زیر یک نصب کارکُن، هر Sonarr و Radarr و اپ گوشی‌ای را که پیش‌تر وصل کرده بودید بیرون می‌گذاشت، آن هم در راه‌اندازی مجددی که هرگز به تغییر تنظیمی ربطش نداده‌اید.

برای استفاده از کلید خودتان به‌جای آن، آن را در تنظیمات → امنیت تایپ کنید؛ بی‌درنگ اعمال می‌شود. آن پنل کلید را عوض می‌کند اما هرگز کلید فعلی را نشان نمی‌دهد، پس اگر مقدار ساخته‌شده را می‌خواهید فایل apikey را بخوانید. برای اجرا بدون هیچ کلیدی، چون چیزی جلوی nzbfast از پیش ورود را مدیریت می‌کند، آن را با NZBFAST_OPEN=1 در محیط اجرا کنید. آنگاه nzbfast باز می‌ماند و هنگام شروع صریح می‌گوید.

اینکه اصلاً کدام ماشین‌ها می‌توانند به دیمن برسند انتخابی جداست: serve --bind. پیش‌فرض 0.0.0.0 است، یعنی هر رابط شبکه، چون یک جعبهٔ NAS، یک گوشی، و یک Sonarr روی رایانه‌ای دیگر همه باید بتوانند وصل شوند. --bind 127.0.0.1 آن را به ماشینی که nzbfast روی آن اجرا می‌شود محدود می‌کند، و همین است آنچه روی یک دسکتاپ تنها که چیز دیگری به دسترسی نیاز ندارد می‌خواهید.

3 · nzbfast چگونه کار می‌کند

یک واژه‌نامهٔ سریع تا بقیهٔ راهنما راحت خوانده شود:

اصطلاحمعنا
ارائه‌دهنده / سروریک سرویس Usenet که با آن حساب دارید (Newshosting، Eweka، XS News…). هرکدام تعدادی اتصال هم‌زمان اجازه می‌دهند.
ستون فقراتزیرساخت پشت یک ارائه‌دهنده. چند برند اغلب همان ستون فقرات را بازفروش می‌کنند - دانستنش مفید است، چون دو ارائه‌دهنده روی یک ستون فقرات همان مقاله‌ها را کم دارند. تنوع سرورها را ببینید.
NZBیک فایل XML کوچک که مقاله‌های سازندهٔ یک پست را فهرست می‌کند. این همان چیزی است که به nzbfast می‌دهید.
PAR2دادهٔ بازیابی که همراه یک ریلیز پست می‌شود. nzbfast حین دانلود در برابر آن تأیید می‌کند و هنگام خراب یا گم بودن مقاله‌ها خودکار تعمیر می‌کند.
RAR حالت-ذخیرهبیشتر ریلیزها بدون فشرده‌سازی در جلدهای RAR بسته‌بندی می‌شوند. nzbfast این را تشخیص می‌دهد و فایل درونی را حین دانلود مستقیماً در مکان نهایی‌اش می‌نویسد - بدون گام باز کردن پس از آن.

خط پردازش، دانلود ← رمزگشایی ← تأیید ← استخراج را هم‌زمان اجرا می‌کند. کارت خط پردازش در داشبورد هر سه خط را در حال حرکت هم‌زمان نشان می‌دهد. وقتی آخرین بایت می‌رسد، تأیید همین حالا انجام شده و فایل همین حالا استخراج شده است؛ زمان «پس‌پردازش» یک کار معمولی صفر است. اگر تعمیر لازم باشد، تنها آن‌گاه جلدها روی دیسک مادی می‌شوند، در جای خود توسط موتور بومی GF(2¹⁶) تعمیر می‌شوند (دادهٔ مبهم‌شدهٔ تغییرنام‌یافته یا بایت‌شیفت‌شده با یک اسکن بلوکی لغزان پیدا و پذیرفته می‌شود) و دوباره استخراج می‌شوند - همه خودکار.

دانلودهای قطع‌شده (خرابی، قطع برق، kill -9) از ژورنال مقاله از سر گرفته می‌شوند: بایت‌هایی که از قبل روی دیسک‌اند هرگز دوبار واکشی نمی‌شوند. ژورنال ثبت می‌کند بایت‌های هر مقاله فیزیکی کجا فرود آمده‌اند - حتی بایت‌هایی که مستقیماً در فایل نهایی استخراج شده‌اند - پس یک ازسرگیری از دیسک محلی بازسازی می‌کند و هر آنچه را بازیابی کرده پیش از اعتماد، در برابر نقشهٔ بلوک PAR2 دوباره تأیید می‌کند.

این چگونه مقایسه می‌شود

در سنجش برابر SABnzbd 5.0.4 و NZBGet 26.2 روی همان ماشین، همان ارائه‌دهنده‌ها و همان NZBها، زمان‌گرفته تا یک فایل قابل‌استفاده - دانلود، تأیید، تعمیر و استخراج همگی شامل، چون واقعاً آن‌وقت است که کار تمام می‌شود:

اندازهٔ کارnzbfastNZBGet 26.2SABnzbd 5.0.4
7 GB13.7 s+26%+39%
35 GB67 s+61%+325%
87 GB272 s+36%+160%
190 GB9 m 00 s+30%+111%

این فاصله همان پس‌پردازشی است که دیگران هنوز پس از فرود آخرین بایت باید انجام دهند. هر دو رقیب برای این مقایسه تنظیم شدند، نه روی پیش‌فرض‌ها رها - به‌ویژه SABnzbd با خط‌لوله‌سازی درخواست خاموش عرضه می‌شود که برایش گران تمام می‌شود، پس آن را روشن کردیم.

دو تفاوت به‌اندازهٔ زمان‌ها مهم‌اند:

ازسرگیری پس از خرابی، سنجیده‌شدهیک دانلود را در میانهٔ کار بکشید (kill -9 در 15 GB از یک کار 34.5 GB) و ازسرگیری دوباره ~0.3 GB واکشی می‌کند - فقط مقاله‌هایی که واقعاً هنگام کشتن در جریان بودند - در برابر 0.2 GB برای NZBGet در همان آزمون. این زمانی یک باخت بود که منتشر می‌کردیم (15.3 GB واکشی مجدد، وقتی ژورنال نمی‌توانست بایت‌های مستقیم‌استخراج‌شده را حساب کند)؛ ژورنال جای‌گذاری آن را رفع کرد: ازسرگیری آن بایت‌ها را از فایل‌های خروجی محلی بازیابی می‌کند و هر بایت بازیابی‌شده را پیش از اعتماد در برابر نقشهٔ بلوک PAR2 دوباره تأیید می‌کند. هر سناریویی که در آن می‌بازیم در کنار بردها منتشر می‌شود، با روش کامل و اعداد خام.

4 · داشبورد

http://localhost:6789 را باز کنید (یا آدرس ماشین‌تان از دستگاهی دیگر - چیدمان گوشی خودکار وفق می‌یابد). همه‌چیز زنده، ثانیه‌ای یک‌بار، به‌روز می‌شود. کارت‌ها، از بالا به پایین:

نوار سربرگ

توان عبوری

MB/s زنده با یک نمودار پیمایشی؛ نشان‌های خط‌چین بالا/پایین این نشست را مشخص می‌کنند و خط کم‌رنگ یک میانگین متحرک است. زیر آن، یک هیستوگرام نشان می‌دهد نمونه‌های سرعت نشست چگونه توزیع می‌شوند - معمول در برابر اوج. پنجره را پهن‌تر کنید تا نمودارها تاریخچهٔ بیشتری نشان دهند (تا یک ساعت).

کاشی‌های آمار

دانلودشده در این نشست، عمق صف، شمار کامل‌شده/ناموفق، سرعت اوج نشست.

منابع - یک ماشین، چهار سقف

پردازنده، RAM (در برابر بودجهٔ حافظهٔ nzbfast)، نرخ نوشتن دیسک و شبکه روی یک نمودار نرمال‌شده، با مقادیر واقعی در راهنما و هشدار کمبود دیسک. هیچ کلاینت NZB دیگری این را به شما نشان نمی‌دهد؛ برای اثبات یک نکته وجود دارد - nzbfast خط شما را به بیشینه می‌رساند، نه ماشین‌تان را.

خط پردازش - مراحل هم‌پوشانی دارند

سه خط: دانلود، تأیید (بلوک‌های PAR2 بررسی‌شده)، استخراج. در یک کار سالم هر سه با هم حرکت می‌کنند.

ارائه‌دهنده‌ها

نرخ زندهٔ هر سرور، بهره‌وری اتصال، سهم از ترافیک، GB نشست، و یک امتیاز کامل بودن مقالهٔ مادام‌العمر (وقتی سروری زیر 98% بیفتد رنگی می‌شود). یک نمودار ناحیه‌ای انباشته سهم هر ارائه‌دهنده را در طول زمان نشان می‌دهد. ردیف‌ها هر 10 ثانیه بر اساس کارایی زنده مرتب می‌شوند (در تنظیمات → رابط قابل تنظیم) تا سریع‌ترین ارائه‌دهندهٔ شما همیشه بالا باشد.

صف

مرور ایندکس

هر آنچه ایندکسر داخلی از گروه‌های پایش‌شدهٔ شما فهرست کرده جست‌وجو کنید (خودکارسازی را ببینید) و با یک کلیک دانلود کنید - بدون نیاز به ایندکسر بیرونی. خط وضعیت پیشرفت اسکن را نشان می‌دهد؛ همین حالا اسکن کن یک گذر را اجبار می‌کند.

فهرست پیگیری

عنوان‌ها را با نام اضافه کنید - از جمله آن‌هایی که هنوز پست نشده‌اند. وقتی یک ریلیز منطبق در ایندکس ظاهر شود خودکار گرفته می‌شود، با ترجیحات کیفیت و قواعد ارتقا (یک نسخهٔ بهتر جایگزین بدتر می‌شود).

تاریخچه

دانلودهای اخیر، هرکدام یک ردیف. کارهای ناموفق تلاش مجدد ارائه می‌دهند (از ژورنال از سر می‌گیرد). آرشیوهای رمزگذاری‌شده یک کنترل باز کردن 🔑 نشان می‌دهند - رمز را وارد کنید و کار در جای خود تمام می‌شود. نوار سلامت‌تأیید بلوک‌های خراب PAR2 در هر دانلود را نمودار می‌کند - دنبالهٔ صعودی یعنی مقاله‌ها خراب می‌رسند. کشوی هر ردیف می‌گوید چه کسی کار را افزوده و همان دکمهٔ دانلود فایل .nzb صف را دارد - برای دانلود دوبارهٔ یک ریلیز در جای دیگر، یا پیوست کردن .nzb به یک گزارش مشکل، به کار می‌آید.

کارت به‌طور پیش‌فرض ده دانلود را فهرست می‌کند و بقیه یک کلیک فاصله دارند، روی دکمهٔ ▤. وضعیت، مکان و دلیل شکست یک کار پشت یک کلیک روی خودِ ردیف قرار دارند، تا حالت رایج - چه چیزی تمام شد، با چه اندازه‌ای، و چه زمانی - بدون پیمایش خوانا بماند. در عوض می‌توانید لبهٔ پایینی کارت را بکشید تا فهرست در ارتفاعی که خودتان انتخاب می‌کنید پیمایش شود. History rows در تنظیمات → رابط آن عدد ده را تغییر می‌دهد؛ چون این ویژگیِ دیمن است نه مرورگر شما، برای هر دستگاهی که به این نصب نگاه می‌کند اعمال می‌شود. Colour History names در کنار آن، نام‌های کامل‌شده را سبز و ناموفق‌ها را قرمز می‌کند؛ با خاموش کردنش نام‌ها ساده می‌مانند و نقطهٔ رنگی و جزئیات خود ردیف همچنان می‌گویند کدام کدام است.

مصرف داده

میله‌های روزانهٔ هر ارائه‌دهنده و کل‌های امروز / 7-روزه / 30-روزه - برای حساب‌های اندازه‌گیری‌شده و بلوکی ضروری است. حساب‌های بلوکی مصرف مادام‌العمر را در برابر اندازه‌شان نشان می‌دهند.

گزارش، محک سیستم، تنظیم دقیق اتصال، تنوع سرورها

یک نمایشگر گزارش درون‌صفحه، و سه ابزار خودسنجی که در ابزارهای کارایی شرح داده شده‌اند.

5 · افزودن دانلود

روشچگونه
کشیدن و رها کردنیک یا چند فایل .nzb را هرجای داشبورد رها کنید.
پوشهٔ پایشدر تنظیمات یک پوشه تعیین کنید؛ هر .nzb ذخیره‌شده در آن ظرف 5 ثانیه برداشته و به سطل زباله منتقل می‌شود، و داشبوردِ باز هر برداشتن را با نام اعلام می‌کند ("… از Downloads برداشته شد")، پس رفتن یک فایل از پوشه هرگز معما نیست. ترجیح می‌دهید فایل‌هایتان بمانند؟ نگه داشتن فایل‌های .nzb پس از برداشتن را روشن کنید (§9 را ببینید). پوشهٔ دانلود مرورگرتان را روی آن تنظیم کنید تا از سایت‌های ایندکسر با یک کلیک بگیرید.
از یک URLیک لینک NZB را جای‌گذاری کنید (API mode=addurl، یا از طریق هر اپ متصل).
پیوندهای nzblnk:یک پیوند nzblnk: را هر جای داشبورد بچسبانید، یا داخلش بکشید. اگر از DMG مک‌اواس یا نصب‌کننده ویندوز نصب کرده‌اید، می‌توانید یکی را مستقیم روی یک بورد هم کلیک کنید. پیوندهای nzblnk در پایین را ببینید.
مرور ایندکسروی هر ریلیز کامل در کارت مرور کلیک کنید.
فهرست پیگیری / RSSخودکار - خودکارسازی را ببینید.
Sonarr/Radarr و غیرهآن‌ها گرفتن‌ها را مستقیم به صف می‌فرستند - §11 را ببینید.
خط فرمانnzbfast get file.nzb بدون دیمن دانلود می‌کند.

دسته‌ها، اولویت‌ها، رمزهای عبور

پیوندهای nzblnk

برخی بوردها، بیشتر آلمانی و هلندی، به‌جای فایل NZB یک پیوند nzblnk: منتشر می‌کنند. پست مبهم‌سازی شده است، پس اصلاً نام فایلی نیست که بشود به آن پیوند داد. پیوند در عوض یک سرآیند حمل می‌کند، h=، که کلید جستجوست نه یک مکان، به‌علاوه عنوان t=، رمز عبور p= و گروه g= اختیاری. اول کسی باید برود و پست را پیدا کند.

nzbfast نخست سرآیند را در ایندکس خودش جستجو می‌کند، که هیچ شبکه‌ای لازم ندارد، و تنها اگر آنجا نیافت از ایندکسرهای جستجویی که پیکربندی کرده‌اید می‌پرسد (تنظیمات → ایندکسرهای جستجو، §9)، زیر همان بودجه‌های روزانه و همان عقب‌نشینی هر جستجوی دیگر. عنوان نام کار می‌شود و رمز عبور خودکار روی کار اعمال می‌شود.

6 · دیوار پوسترها

در سربرگ روی 🎬 دیوار کلیک کنید. دیوار ایندکس شما را به یک مرورگر رسانه تبدیل می‌کند: هر فیلم و ریلیز TV شناخته‌شده به‌صورت یک کاشی پوستر با امتیاز، سال، ژانرها، بازیگران و خلاصه - گروه‌های خبری شما، قابل مرور همچون یک فهرست.

7 · پیش‌نمایش و بررسی

لازم نیست برای اینکه بدانید فایل درست است منتظر پایان دانلود بمانید. آن را حین دانلود باز کنید، بررسی کنید که محتوا، زبان و کیفیت همان است که انتظار داشتید، و اگر نبود زود لغو کنید - به‌جای اینکه بعد از دانلود کامل بفهمید.

نکتهٔ پخش‌کنندهVLC، IINA، mpv و Infuse همگی URLهای /stream را باز می‌کنند. برای بررسی از ماشین دیگر به‌جای localhost از آدرس LAN ماشین‌تان استفاده کنید.
نکتهٔ احراز هویتبا تنظیم یک کلید API، باز کردن یک رکورد پارک‌شدهٔ کتابخانه روی /stream/<id> به یک توکن به‌ازای هر کار (?t=…) نیاز دارد - پخش‌کننده‌ها نمی‌توانند کلید API بفرستند، پس تحویل /m3u و اشاره‌گر .strm آن را برایتان تعبیه می‌کنند؛ ساختن آن (/m3u) به کلید نیاز دارد. سرو کردن سادهٔ بایت‌های یک دانلود از قبل فعال باز می‌ماند، و نصب‌های بدون کلید مثل قبل رفتار می‌کنند.

8 · سرورهای Usenet

تنظیمات → سرورهای Usenet ویرایشگر کامل است: افزودن، ویرایش، حذف، ترتیب مجدد، و وارد یا خارج کردن هر سرور از استخر. هر سرور این‌ها را دارد:

فیلدیادداشت‌ها
میزبان / پورتاز پورت SSL 563 استفاده کنید. TLS هزینهٔ محسوسی ندارد - nzbfast همیشه رمزگذاری می‌کند.
نام کاربری / رمز عبوربه‌صورت محلی در config.local.json ذخیره می‌شود، هرگز به مرورگر بازنشان داده نمی‌شود. خالی گذاشتن رمز عبور هنگام ویرایش، رمز ذخیره‌شده را حفظ می‌کند. رمزهای عبور روی دیسک مبهم‌سازی می‌شوند، نه رمزگذاری.
اتصال‌هااتصال‌های هم‌زمان به‌ازای هر سرور. برای یافتن نقطهٔ بهینهٔ هر ارائه‌دهنده به‌جای حدس زدن عدد بالا از تنظیم دقیق اتصال (§13) استفاده کنید.
سطح (رده)0 = اصلی؛ سطوح بالاتر سرورهای پُرسازی‌اند و فقط مقاله‌هایی از آن‌ها خواسته می‌شود که هر سطح پایین‌تر کم داشته. حساب‌های نامحدود را روی 0، حساب‌های بلوکی را روی 1+ بگذارید.
اندازهٔ بلوک (GB)برای حساب‌های بلوکی (پرداخت به‌ازای هر GB): nzbfast مصرف مادام‌العمر را در برابر این دنبال می‌کند و وقتی تمام شد استفاده از سرور را متوقف می‌کند (هشدار در 85%).

کمی فضا زیر سقف اتصال حسابتان باقی بگذارید. تنظیم اتصال‌ها کمی پایین‌تر از سقف هیچ هزینه‌ای ندارد: توان عبور خیلی پیش از یکی دو اتصال آخر صاف می‌شود و تنظیم دقیق اتصال (§13) به هر حال زیر آن می‌ماند. همان جاهای خالی است که به دستگاه دوم، برنامه‌ای دیگر یا تلاش دوباره پس از افت سوکت اجازه می‌دهد باز هم وارد شود، به‌جای آنکه رد شود در حالی که این یکی همه‌ی جاها را گرفته است.

رمزهای عبور سرویس‌دهنده‌های شما چگونه ذخیره می‌شوند

رمزهای عبور سرویس‌دهنده در config.local.json مبهم‌سازی شده‌اند، نه رمزگذاری. آن‌ها به شکل obf1: و پس از آن یک صورت کدشده ذخیره می‌شوند، تا اگر فایل در یک عکس صفحه، یک پست انجمن، یک گزارش خطا یا روی نمایشگری که کس دیگری می‌بیند ظاهر شد، به‌صورت متن ساده خوانده نشود.

روشن بگوییم این چه چیزی به شما می‌دهد و چه چیزی نمی‌دهد:

برای مقایسه، NZBGet و SABnzbd هر دو رمزهای عبور سرویس‌دهنده را به‌صورت متن خوانا نگه می‌دارند در فایل‌های پیکربندی‌شان. ما مبهم‌سازی را بهبودی کوچک بر آن می‌دانیم، نه یک ویژگی امنیتی.

چرا از جاکلیدی سیستم استفاده نمی‌کنیم؟ Keychain در macOS، مدیر اعتبارنامه‌های Windows و سرویس‌های راز در Linux محافظت واقعی می‌دادند و شاید دوباره سراغش برویم. امروز دو چیز جلوی ما را می‌گیرد. دسترسی به جاکلیدی به هویت برنامه گره خورده است و nzbfast هنوز امضای کد ندارد، بنابراین پرسش‌ها و رفتار پس از هر به‌روزرسانی بد از آب درمی‌آید. و سهم بزرگی از نصب‌ها Docker، سرورهای بدون نمایشگر و جعبه‌های NAS است که اصلاً جاکلیدی ندارند، و این دو مسیر ذخیره‌سازی متفاوت باقی می‌گذارد که باید هر دو درست بمانند. یک قالب واحد و خوش‌فهم که همه‌جا یکسان رفتار می‌کند فعلاً معامله بهتری است.

دو گزینهٔ دیگر برای هر سرور هنوز کنترلی در داشبورد ندارند: آن‌ها را دستی در مدخل همان سرور در config.local.json بیفزایید (نگاه کنید به §17) و دوباره راه‌اندازی کنید.

کلیدیادداشت‌ها
bind_ipاتصال‌های خروجی این سرور را به یک نشانی محلی مشخص می‌بندد، برای دستگاه‌های چندخروجی و تونل‌های تقسیم‌شدهٔ VPN. خانوادهٔ نشانی، خانوادهٔ مقصد را هم برمی‌گزیند: بستن v4 به نشانی v4 سرور وصل می‌شود.
socks5ترافیک NNTP این سرور را از یک پراکسی SOCKS5 می‌گذراند: host:port یا user:pass@host:port. نام میزبان را پراکسی تفکیک می‌کند، پس نشتِ DNS محلی رخ نمی‌دهد.
توصیهدو ارائه‌دهنده روی ستون فقرات‌های متفاوت از سه‌تا روی یکی بهترند. تنوع سرورها (§13) را اجرا کنید تا ببینید کدام ارائه‌دهنده‌های شما واقعاً پوشش‌تان را متنوع می‌کنند و کدام نسخه‌های زائد یکدیگرند.

9 · مرجع تنظیمات

تقریباً همه چیز از داشبورد و از بخش ⚙ تنظیمات قابل پیکربندی است؛ چهار استثنا در پایان همین بخش فهرست شده‌اند. مقادیر نشان‌دار live بی‌درنگ اعمال می‌شوند و مقادیر restart در راه‌اندازی بعدی. هر تغییری که اینجا انجام شود در settings.json ذخیره می‌شود و از راه‌اندازی مجدد جان سالم به در می‌برد (مقادیر رابط بر پرچم‌های خط فرمان می‌چربند).

سرعت و زمان‌بندی زنده

تنظیمکارکرد
محدودیت سرعتسقف به بایت/ثانیه (50M، 1G، 0 = نامحدود). اپ‌های راه دور ممکن است درصد بفرستند - سرعت خط را تنظیم کنید تا درست ترجمه شوند.
سرعت خودکارسقفی با ادارهٔ RTT که به دیگر ترافیک خانگی اولویت می‌دهد و وقتی خط آرام است دوباره گسترش می‌یابد.
به‌تعویق‌انداختن خودکار دانلودهای کندکاری که روی یک سرور کند گیر کرده در حالی که بقیه منتظرند به انتهای صف منتقل می‌شود (پیشرفت حفظ می‌شود). §13 را ببینید.
پیش‌واکشی روی سرورهای بیکارسرورهای بی‌فایده برای کار فعال، کار بعدی صف را آغاز می‌کنند. §13 را ببینید.
به‌روزرسانی خودکار / URL بررسی به‌روزرسانی§14 را ببینید.
سرعت خطسرعت نامی اتصال شما - محدودیت‌های درصدی از اپ‌های سازگار با SABnzbd را فعال می‌کند.
زمان‌بندی هفتگیویرایشگر ردیفی برای قواعد زمان‌هفته: مکث، ازسرگیری، یا تنظیم محدودیت سرعت در روزها/زمان‌های معین (وقت محلی). مثلاً محدودیت 20 MB/s در روزهای کاری 9–17، در غیر این صورت نامحدود.

دانلود بعدی زنده

اتصال‌ها (به‌ازای هر سرور)، پنجره (عمق خط‌لوله‌سازی به‌ازای هر اتصال)، رمزگشاها (رشته‌های رمزگشایی موازی). هنگام آغاز هر کار نمونه‌برداری می‌شوند. پیش‌فرض‌ها برای بیشتر خط‌ها درست‌اند؛ پیش از بالا بردن کورکورانه از ابزارهای تنظیم استفاده کنید.

بررسی هنگام بارگیری برمی‌گزیند که همزمان با رسیدن داده چه اندازه وارسی شود. کامل هر بلوک PAR2 را با MD5 تأیید می‌کند. سریع (پیش‌فرض) بلوک‌ها را با CRC32 مطالبه می‌کند که روی پردازندهٔ کند 2-3 برابر سریع‌تر است و همچنان جمع کنترلی خودِ هر مقاله را بررسی می‌کند. کم‌مصرف افزون بر آن، به‌محض اینکه PAR2 پرونده‌ای را بپوشاند از آن جمع‌های کنترلی مقاله هم می‌گذرد: آسیب آنگاه لحظه‌ای دیرتر و در بلوک خودش پدیدار می‌شود. در هر سه، گذر پایانی و هر ترمیمی از MD5 کامل بهره می‌گیرند و بارگیری بدون پرونده‌های PAR2 جمع‌های کنترلی مقاله‌هایش را نگه می‌دارد.

دیسک و سهمیه زنده

کمینهٔ فضای آزاد (زیر آن کارهای جدید مکث می‌شوند؛ به‌طور پیش‌فرض ۲ گیگابایت، ۰ آن را خاموش می‌کند)، سهمیهٔ دانلود در روز یا ماه (UTC؛ کارهای اجباری دور می‌زنند)، محدودیت حافظه - بودجهٔ RAM موتور (پیش‌فرض: ¼ از RAM، کران‌دار؛ روی ماشین پُر-RAM برای بیشینه سرعت روی کارهای عظیم آن را بالا ببرید، و پیش از پایین آوردنش هزینهٔ حافظهٔ کم را ببینید) راه‌اندازی مجدد.

انتقال کامل‌شده‌ها به: پس از باز کردن، پاک‌سازی و تغییر نام، دانلودهای تمام‌شده به اینجا منتقل می‌شوند - یک اشتراک NAS، یک درایو رسانه، هر جا که کتابخانه‌تان باشد. چیدمان دسته‌ها حفظ می‌شود (کاری که زیر tv/ تمام شده در مقصد زیر tv/ قرار می‌گیرد) و تاریخچه هم همراه انتقال می‌رود، بنابراین برنامه‌های متصل از محل جدید وارد و حذف می‌کنند. اگر هنگام پایان یک کار مقصد در دسترس نباشد (اشتراک آفلاین، فضای پرشده)، فایل‌ها در پوشهٔ دانلود می‌مانند و کار باز هم به‌طور عادی کامل می‌شود. خالی = خاموش. مقصدها به‌ازای هر دسته دسته‌های خاص را به جای دیگری می‌فرستند (tv=/Volumes/NAS/TV, movies=/Volumes/NAS/Movies)؛ هر مسیر فهرست‌شده خودِ پوشهٔ آن دسته است، پس هیچ زیرپوشهٔ دستهٔ اضافه‌ای درونش ساخته نمی‌شود. دسته‌های فهرست‌نشده از انتقال کامل‌شده‌ها به پیروی می‌کنند.

عمق آرشیوهای تودرتو (پیش‌فرض ۵) یعنی چند لایه آرشیو-درون-آرشیو به‌طور خودکار باز می‌شود: مجموعه‌ای RAR که درونش یک 7z و در آن باز یک RAR دیگر باشد در یوزنت عادی است و nzbfast این زنجیره را بدون گذر دوم دنبال می‌کند. در مرز، عمیق‌ترین آرشیو همان‌جا باقی می‌ماند و بیش از آن باز نمی‌شود، و دانلود با این حال کامل می‌شود. تنها برای ریلیزهای به‌طور غیرعادی عمیق آن را بالا ببرید.

تغییر نام و پاک‌سازی خودکار live

تغییر نام دانلودهای تمام‌شده (به‌طور پیش‌فرض روشن) به پوشه و فایل اصلی نامی تمیز و گویا می‌دهد: یک فیلم به Example Movie (2024) بدل می‌شود و سریال‌ها Show - S01E02 را نگه می‌دارند. نام‌های مبهم‌سازی‌شده یا ناشناخته به‌جای حدس‌زدن، دقیقاً همان‌گونه که منتشر شده‌اند باقی می‌مانند.

تنظیمچه می‌کند
گنجاندن رزولوشن1080p، 2160p… را به نام می‌افزاید. به‌طور پیش‌فرض روشن؛ چهار برچسب دیگر خاموش‌اند.
گنجاندن کدک ویدیوx265، x264، AV1
گنجاندن کدک صداAtmos، DTS-HD، AC3
گنجاندن منبعBluRay، WEB، REMUX
گنجاندن گروه ریلیزبرچسب -GROUP در انتها.
حذف فایل‌های آشغالبه‌طور پیش‌فرض روشن. .par2، .nzb، .sfv، .nfo‌های برجای‌مانده و کلیپ‌های نمونه را از پوشه‌های تمام‌شدهٔ فیلم و سریال پاک می‌کند. هرگز ویدیو یا زیرنویس‌هایش را.
فقط فایل رسانه را نگه داربه‌طور پیش‌فرض خاموش، و ویرانگر: همهٔ محتوای پوشه را جز ویدیو (یا ویدیوها) و زیرنویس‌ها برای همیشه حذف می‌کند. همهٔ قسمت‌های یک بستهٔ فصل نگه داشته می‌شوند. هرگاه هر دو روشن باشند، بر حذف فایل‌های آشغال مقدم است.
Keep the other words in the nameبه‌طور پیش‌فرض روشن. ورزش، مسابقات و رویدادهای دیگر اغلب یک عنوان واحدند که در تمام فصل تکرار می‌شود و تنها یکی دو کلمه با هم فرق دارند - "Round11 Hungary Race" در برابر "Round11 Hungary Qualifying". نگه داشتن همان کلمه‌هاست که نمی‌گذارد یک فصل کامل به یک نام واحد فروبریزد. تنها جایی اعمال می‌شود که نام به هیچ روش دیگری قابل مرتب کردن نبوده، بنابراین فیلم‌ها و قسمت‌های معمولی دست‌نخورده می‌مانند.

کل این گروه پس از تعمیر و باز‌کردن و پیش از انتقال کامل‌شده‌ها به اجرا می‌شود، و برای کاری که هنوز چشم‌به‌راه گذرواژه است به‌کلی نادیده گرفته می‌شود. هر دو گام حذف تنها بر ریلیزهایی اعمال می‌شوند که فیلم یا سریال شناخته شده‌اند: یک بار نرم‌افزاری یا مجموعه‌ای دسته‌بندی‌ناپذیر (مبهم‌سازی‌شده) هرگز پاک‌سازی نمی‌شود.

فایل‌های حذف‌شده به سطل زباله می‌روند تعیین می‌کند «حذف» در بالا یعنی چه. وقتی روشن است، پاک‌سازی فایل‌ها را به سطل زبالهٔ سیستم منتقل می‌کند تا اگر تشخیص دربارهٔ آشغال بودن چیزی اشتباه بود بتوان آن را برگرداند؛ وقتی خاموش است فایل‌ها یک‌راست حذف می‌شوند. در macOS و Windows به‌طور پیش‌فرض روشن است، جایی که سطل زباله جایی است که می‌بینید و خالی می‌کنید، و در Linux به‌طور پیش‌فرض خاموش است، جایی که معمولاً چنین نیست.

روی NAS یا داخل کانتینر، این را خاموش بگذارید. وقتی دانلودهایتان روی دیسکی جدا از پوشهٔ خانگی‌تان است - که چیدمان معمول در Unraid, Synology، یک سیدباکس یا هر نصب Docker با اشتراک سوارشده است - قواعد سطل زبالهٔ Linux اصلاً از سطل زبالهٔ میزکاری استفاده نمی‌کنند. در عوض پوشهٔ پنهانی به نام .Trash-1000 (عدد، شناسهٔ کاربری شماست) در بالای دیسک دانلود می‌سازند و فایل‌ها را به آنجا منتقل می‌کنند. هیچ‌چیز آن پوشه را به شما نشان نمی‌دهد، هیچ‌چیز خالی‌اش نمی‌کند، و فضایی که گرفته هرگز برنمی‌گردد.

اگر نسخهٔ قدیمی‌تری از nzbfast را در Linux با این گزینهٔ روشن اجرا کرده‌اید، آن پوشه را در ریشهٔ اشتراک دانلودتان بجویید. خالی کردنش امن است: هرچه در آن است فایلی است که پاک‌سازی پیش‌تر تصمیم گرفته آن را نمی‌خواستید. nzbfast آن را برایتان خالی نمی‌کند، چون روی دیسک شماست و قضاوتش با شماست.

پوشه‌ها و پردازش

پوشهٔ دانلود راه‌اندازی مجدد، پوشهٔ پایش، اسکریپت پس‌پردازش (پس از هر کار با آرگومان‌های سازگار SABnzbd و محیط SAB_* اجرا می‌شود - اسکریپت‌های موجود SAB بدون تغییر کار می‌کنند)، پسوندهای پاک‌سازی (فایل‌های آشغال پس از اتمام حذف می‌شوند)، پوشه‌های هوشمند و بایگانی TV (§10 را ببینید).

نگه داشتن فایل‌های .nzb پس از برداشتن (به‌طور پیش‌فرض خاموش) فایل .nzb اصلی را پس از افزودن به صف در پوشهٔ پایش نگه می‌دارد، به جای انتقال به سطل زباله - برای مجموعه‌داران، و برای دادن فایل به کسی وقتی دانلودی مشکل دارد. فایل نگه‌داشته‌شده به خاطر سپرده می‌شود، حتی پس از راه‌اندازی مجدد، و دوباره به صف اضافه نمی‌شود؛ برای دانلود دوباره، آن را دوباره ذخیره کنید. هرکدام را انتخاب کنید، کشوی هر کار یک دکمهٔ دانلود فایل .nzb دارد، پس نسخه‌ای از .nzb هر کار هرگز بیش از یک کلیک فاصله ندارد.

ایندکس‌گذاری زنده

ایندکسر داخلی به‌طور پیش‌فرض خاموش است. پست‌هایی را پیدا می‌کند که با نام فایل واقعی گذاشته شده‌اند، و سهم بزرگ و رو به رشدی از Usenet عمداً بدون چنین نامی گذاشته می‌شود: موضوع تصادفی، نام فایل‌های تصادفی در درون، رها شده در یک گروه همه‌کاره. نام واقعی تنها در یک NZB زندگی می‌کند که آپلودکننده جای دیگری منتشرش می‌کند، پس هرگز روی Usenet نبوده که هیچ اسکنری بتواند بخواندش. بر پایه ایندکس خودمان، ۱۴٫۸ میلیون پست اسکن‌شده حدود ۳۱٬۰۰۰ ریلیز قابل مرور داد، تقریباً یکی از هر پانصد. همچنان از ایندکسرهای تجاری استفاده کنید و آن‌ها را در تنظیمات → ایندکسرهای جستجو بیفزایید تا بتوانید از دیوار در آن‌ها بگردید. این را روشن کنید اگر گروه‌های مشخصی را دنبال می‌کنید که مردم هنوز با نام‌های واقعی در آن‌ها پست می‌گذارند، یا می‌خواهید ببینید سرویس‌دهنده‌تان واقعاً چه چیزی حمل می‌کند. با کلید خاموش هیچ چیز اسکن یا دریافت نمی‌شود، هیچ پایگاه داده‌ای ساخته نمی‌شود، و دیوار، مرور ایندکس، فهرست پیگیری و خوراک newznab پنهان می‌مانند.
تنظیمکارکرد
ایندکسر داخلیکلید اصلی، خاموش مگر آنکه روشنش کنید. خاموش یعنی بدون اسکن، بدون جستجوی فراداده، بدون نمونه‌گیری در دسترس‌بودن و بدون خوراک newznab؛ ایندکسی که از پیش روی دیسک است نگه داشته می‌شود (دکمه حذف وجود دارد)، پس روشن‌کردن دوباره از سر گرفته می‌شود نه اسکن مجدد.
گروه‌هاگروه‌های خبری که ایندکسر داخلی اسکن می‌کند (مثلاً alt.binaries.teevee).
فاصلهٔ اسکنثانیه بین گذرها (پیش‌فرض 900).
مقاله‌های پُرسازی گذشتههدرهایی که در نخستین اسکن یک گروه واکشی می‌شوند.
عمیق‌سازی در هر اسکنهر گذر این تعداد مقالهٔ قدیمی‌تر را نیز ایندکس می‌کند و تاریخچهٔ قابل‌جست‌وجوی شما را در پس‌زمینه رشد می‌دهد تا به بیشینهٔ سن برسد (پیش‌فرض 200,000 در هر گذر ≈ ده‌ها میلیون مقاله در هر روز روشن بودن).
بیشینهٔ سنپست‌های قدیمی‌تر از این را نادیده بگیر (90d، 6m، 2y) - اندازهٔ ایندکس و زمان اسکن را محدود می‌کند.
هرس تا پنجرهٔ سنبه‌طور پیش‌فرض روشن. ریلیزهای پیش‌تر ذخیره‌شده را نیز به‌محض گذشتن از بیشینهٔ سن حذف می‌کند، تا نمایه به‌جای رشد بی‌پایان تقریباً همان پنجره را نگه دارد. خاموش = تنها پست‌های تازه پالایش می‌شوند و آنچه ذخیره شده می‌ماند. تکه‌های آشغال مرده (پنهان، پس از یک هفته هنوز ناقص) در هر حال جمع‌آوری می‌شوند.
دروازه‌های ورودیقواعد JSON که آنچه وارد ایندکس می‌شود را فیلتر می‌کنند: نوع‌ها (آشغال مبهم‌شده به‌طور پیش‌فرض حذف می‌شود)، سال/رزولوشن/زبان، کران‌های اندازه.
همین حالا اسکن کن / اسکن مجدد عمیقیک گذر را فوری اجرا کن؛ با یک عمق، آن تعداد هدر اخیر را دوباره اسکن کن.
کلید OMDb / تازه‌سازی فراداده / پاک کردنکنترل‌های غنی‌سازی دیوار (§6). پاک کردن پایگاه داده را از نو می‌سازد - مسیر بازیابی در صورت خرابی آن.
خوراک preخاموش تا وقتی روشنش کنید. بسیاری از بارگذاری‌ها بدون نامشان منتشر می‌شوند و پویش چیزی برای خواندن ندارد. کانال‌های بازپخش عمومی نام واقعی را اعلام می‌کنند و این تنها راه باز برای جور کردن چنین نوشته‌هایی است. روشن کردن، اتصالی به یک شبکهٔ IRC باز نگه می‌دارد و گوش می‌دهد: هرگز چیزی فرستاده نمی‌شود و حسابی ساخته نمی‌شود. نیازمند روشن بودن نمایه‌ساز است، چون خوراکی که جایی برای گذاشتن شنیده‌هایش ندارد فقط سوکتی است که بیهوده باز مانده.
کارساز بازپخش، کانال‌های بازپخششبکهٔ IRC که اعلان‌ها را می‌آورد (میزبان یا میزبان:درگاه) و کانال‌هایی که باید شنیده شوند، جدا شده با ویرگول. تغییر در اتصال بعدی کارگر می‌شود: خوراک را خاموش و روشن کنید تا بی‌درنگ اعمال شود.
نام‌گذاری با همبستگیبازپخش‌های عمومی زنده نام پرونده ندارند، پس بیشتر نوشته‌های مبهم‌شده را نمی‌توان مستقیم جور کرد. آنچه یک اعلان روشن می‌کند این است که یک انتشار کی پیدا شده و چقدر بزرگ است. این، زمان و اندازهٔ اعلام‌شده را با نوشته‌های بی‌نام می‌سنجد و هنگام جور بودن، نام واقعی را در بخش مرور پیشنهاد می‌دهد. پیشنهاد به‌روشنی پیشنهاد نشانه‌گذاری می‌شود، به کلیک شما نیاز دارد و هرگز نام پرونده‌های روی دیسک را عوض نمی‌کند.
اعمال خودکار جورهای قویبه‌طور پیش‌فرض خاموش، و هنگام روشن بودن سخت‌گیر: اندازه باید تنگاتنگ بخواند، هیچ اعلان دیگری نباید تقریباً به همان خوبی جور باشد، و اعلان باید در بررسی وارونه همین نوشته را بازگزیند. نام اعمال‌شده تنها شیوهٔ نمایش انتشار را عوض می‌کند، برچسب استنتاجی می‌خورد و اگر بارگیری پایان‌یافته‌ای خلافش را ثابت کند خودبه‌خود برداشته می‌شود. هرچه ضعیف‌تر باشد پیشنهاد می‌ماند.
پیشینهٔ اعلان‌هاخوراک زنده تنها اعلان‌های پس از روشن شدنش را می‌شنود. این، نزدیک شش ماه اعلان گذشته را از یک پایگاه pre عمومی، مؤدبانه و یک بار، می‌آورد تا نوشته‌های از پیش نمایه‌شده هم جور شوند. نیم‌ساعتی در پس‌زمینه می‌دود.

کتابخانه، امنیت، رابط

کتابخانه: دسته‌هایی که به‌عنوان رکوردهای آنی کتابخانه در نظر گرفته می‌شوند + فاصلهٔ بررسی مجدد. امنیت: کلید API کامل (همه‌چیز) و کلید NZB (فقط-افزودن - دادنش به سایت‌های ایندکسر امن است)، هر دو به‌صورت زنده قابل چرخش. هر جعبه به‌محض خروج شما از فیلد، کلیدی را که به آن تعلق دارد جایگزین می‌کند، و خالی گذاشتن یک جعبه کلیدی را که از پیش دارد نگه می‌دارد. کلید API افزون بر این Show را دارد که کلید فعلی را آشکار و کپی می‌کند تا هر وقت خواستید در Sonarr، Radarr یا NZB360 بچسبانید، و Create new که جایگزینی می‌سازد - کلید قدیمی بی‌درنگ از کار می‌افتد، پس هر چیزی که از پیش متصل است باید کلید تازه را بگیرد. هر دو به خودِ کلید API مشروط‌اند: کلید NZB فقط-افزودن نمی‌تواند آن را بخواند، و تمام فلسفهٔ آن کلید همین است. برای اینکه کلید در یک نصب تازه از کجا می‌آید، §2 را ببینید. رابط: صداهای کلیک، اعلان‌های دسکتاپ هنگام اتمام، فاصلهٔ مرتب‌سازی مجدد ارائه‌دهنده‌ها.

واحدهای سرعت live تعیین می‌کند هر سرعتی در داشبورد چگونه نشان داده شود: مگابایت (MB/s، عرف مدیران دانلود، پیش‌فرض) یا مگابیت (Mb/s، همان‌گونه که ارائه‌دهنده‌های اینترنت خطوط را اعلام می‌کنند). اندازهٔ فایل‌ها در هر حال به بایت می‌ماند. این ویژگیِ دیمن است نه مرورگر شما، پس برای هر دستگاهی که به این نصب نگاه می‌کند صدق می‌کند.

پیشرفته: پیچ‌های تنظیمی پشت موارد آشکار

شش تنظیم بدون پرچم در خط فرمان. هرکدام اکنون در کارت تنظیماتی که به آن تعلق دارد یک ردیف پیشرفته دارد و همچنان از راه API قابل تنظیم است (§16)، برای نمونه /api?mode=config&name=verify_mode&value=lean&apikey=…. مانند همهٔ تنظیم‌های دیگر در settings.json ذخیره می‌شوند.

نامچه می‌کند
verify_modefull | fast | lean (پیش‌فرض fast). lean همان هلِ لازم برای پردازنده‌های کند است: مانند fast، اما به‌محض آنکه PAR2 فایلی را پوشش دهد از CRC یِ yEnc هر مقاله نیز می‌گذرد، یعنی یک لایهٔ CRC32 به‌جای دو لایه. دانلودهای بدون PAR2 همچنان CRC مقاله‌هایشان را نگه می‌دارند، و بررسی و تعمیر پایان کار در هر دو حالت دست‌نخورده است. گزینشگر بررسی هنگام بارگیری در بالا همین تنظیم است.
auto_retry_minsمهلت پیش از تنها تلاش خودکار دوباره‌ای که یک شکست نخست با مقاله‌های غایب می‌گیرد (پیش‌فرض ۲۰). تأخیر انتشار علتی واقعی برای غیبت مقاله‌هاست و خودبه‌خود برطرف می‌شود؛ به لطف ژورنال، اجرای دوباره تنها آنچه را هنوز کم است می‌آورد. شکست‌های ناشی از گذرواژه یا حذف هرگز مشمول نمی‌شوند.
index_scan_parنمایه‌ساز چند گروه را هم‌زمان پویش کند (پیش‌فرض ۳، محدود به ۱ تا ۸).
oracle_sampleبودجهٔ STAT در بی‌کاری برای پیشگوی در‌دسترس‌بودن (§13)، شمار کاوش در ساعت به ازای هر سرور. پیش‌فرض ۳۰۰، بیشینه ۳۶۰۰، و 0 نمونه‌برداری را یکسره خاموش می‌کند.
predb_max_rowsجدول خوراک چند اعلان pre را نگه می‌دارد (پیش‌فرض 250000، محدود به 10000 تا 5000000). هرس ساعتی تا همین عدد کوتاه می‌کند و درون‌ریزی تاریخی اگر قرار باشد از آن بگذرد از شروع خودداری می‌کند، پس هیچ درون‌ریزی‌ای ردیف‌هایی را که هرس بعدی پاک می‌کند اضافه نمی‌کند.
predb_seed_daysیک درون‌ریزی تاریخی که بدون پنجرهٔ خودش آغاز شود تا چه اندازه به عقب می‌رسد (پیش‌فرض 180 روز، بیشینه 366). پنجرهٔ بزرگ‌تر یعنی درخواست‌های بیشتر به منبع pre که آهنگش یک درخواست در هر دو ثانیه است.

10 · خودکارسازی

فهرست پیگیری

ساده‌ترین خودکارسازی: یک عنوان در داشبورد اضافه کنید، ترجیحات کیفیت را تنظیم کنید، تمام. ریلیزهای جدید به‌محض ظاهر شدن در گروه‌های ایندکس‌شدهٔ شما گرفته می‌شوند؛ نسخه‌های باکیفیت‌تر گرفتن‌های قبلی را ارتقا می‌دهند؛ یک نمای تقویم آنچه در راه است را نشان می‌دهد.

فیدهای RSS

تنظیمات → RSS: هر URL RSS از newznab/ایندکسر با فاصلهٔ هر فید، دسته و قواعد فیلتر (الگوهای عنوان، کران‌های اندازه). موارد منطبق خودکار دانلود می‌شوند.

پوشه‌های هوشمند

قواعدی که هنگام افزودن یک کار ارزیابی می‌شوند: تطبیق با الگو/کلیدواژه‌ها و اندازه، تخصیص یک دسته (اولین تطبیق برنده است). با روشن بودن بایگانی TV، قسمت‌های تمام‌شدهٔ TV تغییرنام یافته و به‌صورت Show/Season 01/Show - S01E02.mkv بایگانی می‌شوند - آمادهٔ Plex/Jellyfin بدون ابزار بیرونی.

زمان‌بند

زمان‌بندی هفتگی (§9 را ببینید) مکث/ازسرگیری/سرعت را بر اساس زمان روز خودکار می‌کند.

اسکریپت‌ها

یک اسکریپت پس‌پردازش آرگومان‌های موقعیتی SABnzbd و متغیرهای محیطی SAB_* را دریافت می‌کند - اکوسیستم بزرگ اسکریپت‌های SAB بی‌تغییر اجرا می‌شود.

11 · Sonarr، Radarr و دوستان

nzbfast به‌طور بومی با API SABnzbd صحبت می‌کند، پس هر *arr بدون تنظیم کار می‌کند - و می‌تواند ایندکسر آن‌ها هم باشد.

به‌عنوان کلاینت دانلود

  1. در Sonarr/Radarr: Settings → Download Clients → افزودن SABnzbd.
  2. میزبان: ماشین nzbfast شما · پورت: 6789 · کلید API: کلید API کامل شما (کجا پیدایش کنید: §2).
  3. دسته به دلخواه (مثلاً tv / movies). Test → تیک سبز → Save.

صف، تاریخچه، وضعیت هر کار، «حذف و پاک کردن»، تلاش مجدد و مسیریابی دسته همگی همان‌طور که *arrها انتظار دارند رفتار می‌کنند.

به‌عنوان ایندکسر (newznab)

  1. Settings → Indexers → افزودن Newznab.
  2. URL: http://<host>:6789/ · مسیر API: /api · کلید: کلید API شما.
  3. nzbfast پرس‌وجوهای caps، search، tvsearch و movie را از ایندکس خودش از گروه‌های پایش‌شدهٔ شما سرو می‌کند، و /getnzb/<id> فایل NZB را بازمی‌گرداند.
نخست ایندکسر داخلی را روشن کنید (تنظیمات → ایندکس‌گذاری). به‌طور پیش‌فرض خاموش است، و تا وقتی خاموش باشد این نما به هر پرس‌وجو به‌جای نتیجه خالی با <error code="101"> پاسخ می‌دهد، تا اشتباه همان لحظه‌ای که ایندکسر را می‌افزایید دیده شود، نه هفته‌ها بعد.

چرا به زحمتش بیفتیم؟ یک ایندکسر خودمیزبان دقیقاً از همان گروه‌هایی که برایتان مهم‌اند: بدون حساب، بدون سقف فراخوانی API، با نگهداشتی به هر عمقی که اجازه اسکنش را بدهید. این افزوده‌ای بر ایندکسرهای همیشگی شماست نه جایگزین آن‌ها، چون تنها چیزی را می‌یابد که با نام فایل واقعی پست شده باشد.

12 · گوشی و اپ‌های راه دور

nzbfast هر دو پروتکل اصلی کنترل از راه دور را پیاده‌سازی می‌کند، پس تقریباً هر اپ موبایل/تبلت کار می‌کند. هر پروتکلی که اپ شما پشتیبانی می‌کند را انتخاب کنید:

اپ‌هایی که NZBGet صحبت می‌کنند (nzb360، LunaSea، NZB Unity…)

فیلد در اپمقدار
نوعNZBGet
میزبان / پورتماشین شما : 6789
نام کاربریهرچیزی (مثلاً nzbfast)
رمز عبورکلید API شما

سطح کامل JSON-RPC که این اپ‌ها استفاده می‌کنند سرو می‌شود: وضعیت، صف با ترتیب مجدد/مکث/حذف، تاریخچه، افزودن-NZB، محدودیت سرعت، مکث/ازسرگیری، گزارش.

اپ‌هایی که SABnzbd صحبت می‌کنند

فیلد در اپمقدار
نوعSABnzbd
میزبان / پورتماشین شما : 6789
کلید APIکلید API شما (یا کلید NZB برای دسترسی فقط-افزودن)

داشبورد روی گوشی شما

فقط http://<machine>:6789 را در یک مرورگر موبایل باز کنید - کل داشبورد و دیوار چیدمان لمسی دارند. پنل تنظیمات → دسترسی از راه دور، URLهای دقیق و یک کد QR برای اسکن را نشان می‌دهد.

دسترسی به nzbfast از بیرون خانه

صفحهٔ ورود وجود ندارد و این عمدی است. ورود مبتنی بر کوکی نشست سطحی امنیتی است که باید تا همیشه نگهداری شود و باز هم ضعیف‌ترین قفل هر چیزی خواهد بود که رو به اینترنت باز است. nzbfast در عوض با کلید API شما احراز هویت می‌کند و آن کلید را هم در سرآیند درخواست و هم در نشانی می‌پذیرد (X-Api-Key یا Authorization: Bearer) - و همین است که به چیزی در جلوی آن اجازه می‌دهد ورود را درست انجام دهد.

ساده‌ترین پاسخ این است که اصلاً منتشرش نکنید. Tailscale را روی این دستگاه و روی گوشی‌تان نصب کنید تا هر دو به یک شبکهٔ خصوصی بپیوندند: چیزی در معرض نیست، به کار روی مسیریاب یا گواهی نیازی نیست، و تنظیمات ← دسترسی از راه دور به‌محض دیدن اجرای Tailscale نشانی‌ای نمایش می‌دهد که از همه‌جا کار می‌کند. تا وقتی به دامنهٔ عمومی نیاز قطعی ندارید، همین را انتخاب کنید.

اگر نیاز دارید، یک پروکسی معکوس جلوی آن بگذارید، گواهی را به آن بسپارید و بگذارید خودش احراز هویت را انجام دهد. nzbfast را با --bind 127.0.0.1 اجرا کنید تا پروکسی تنها راه ورود باشد، و پروکسی را به 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;
}

هرچه پروکسی‌تان ارائه می‌دهد رویش بگذارید: احراز هویت basic، سرویس forward-auth مانند Authelia یا Authentik، یا گواهی‌های سمت کاربر. یک نکته همه را غافلگیر می‌کند - ‏Sonarr، ‏Radarr و برنامه‌های گوشی نمی‌توانند ورود مرورگری را کامل کنند، پس راهی برایشان باز بگذارید. بیشتر پروکسی‌ها می‌توانند درخواستی را که سرآیند X-Api-Key معتبر دارد عبور دهند و از بقیه احراز هویت بخواهند.

پورت ۶۷۸۹ را همین‌طوری روی مسیریاب باز نکنید. داشبورد HTTP ساده صحبت می‌کند، پس کلید API شما و هر کاری که با آن می‌کنید به‌صورت خوانا برای هرکسی در مسیر از اینترنت عبور می‌کند، و نصبی که هیچ کلیدی ندارد برای هرکه پیدایش کند باز است. اگر با این حال پورتی را باز می‌کنید، ابتدا یک کلید API تنظیم کنید.

13 · ابزارهای کارایی

محک سیستم

یک کلیک سه سقف شما را می‌سنجد - توان عبوری شبکه (یک کاوش واقعی چنداتصاله 8-ثانیه‌ای)، نرخ تأیید پردازنده، و سرعت نوشتن دیسک - و با پاسخ آغاز می‌کند: بیشینه سرعت دانلود مورد انتظار شما و اینکه کدام سقف حد است. کوتاه‌ترین میله گلوگاه شماست؛ بقیه فضای مانورشان را نشان می‌دهند. آن را زمان‌بندی کنید (هر 6 ساعت تا هفتگی) و هر اجرا در یک جدول تاریخچه ثبت می‌شود، تا ببینید کِی ارائه‌دهنده، ISP یا سخت‌افزارتان رفتارش را تغییر داده. اجراهای زمان‌بندی‌شده فقط هنگام بیکاری صف رخ می‌دهند.

تنظیم دقیق اتصال

یک ارائه‌دهنده را با تعداد اتصال‌های فزاینده می‌سنجد و تنظیم را پیشنهاد می‌دهد - سوکت‌های بیشتر تا وقتی ارائه‌دهنده یا خط شما اشباع شود کمک می‌کنند، و برخی ارائه‌دهنده‌ها زیاده‌خواهی را تنبیه می‌کنند. آزمایش همه هر ارائه‌دهنده را مقایسه می‌کند، سپس همه را با هم می‌ترکاند تا بررسی کند استخر خط شما را اشباع می‌کند.

تنوع سرورها

مقاله‌ها را در سنین مختلف روی هر سرور با STAT نمونه‌برداری می‌کند و ارائه‌دهنده‌ها را بر اساس شکاف‌های مشترک خوشه‌بندی می‌کند: ارائه‌دهنده‌هایی با ~100% مقاله‌های گمشدهٔ مشترک همان ستون فقرات‌اند (برای بازیابی زائد)؛ مستقل‌ها واقعاً پوشش شما را گسترش می‌دهند. با یک توصیهٔ زبان‌ساده پایان می‌یابد.

هوش خودکار صف

پیشگوی در‌دسترس‌بودن

حذف‌ها مهم‌ترین دلیل شکست یک دانلود یوزنت‌اند، و پیش‌بینی‌پذیرند: همان ریلیز روی یک ستون فقرات ناپدید می‌شود در حالی که دیگری هنوز آن را دارد. nzbfast دفترچهٔ کوچکی از آنچه ارائه‌دهنده‌های خودتان واقعاً تحویل داده‌اند نگه می‌دارد و بودجه‌ای ناچیز از کاوش‌های STAT در زمان بی‌کاری خرج می‌کند (چند صد در ساعت به ازای هر سرور، هرگز در حین دانلود) تا آن را به‌روز نگه دارد. برای این کار هرگز بار داده‌ای دانلود نمی‌کند.

آنچه از آن به دست می‌آورید:

این حکم پیش‌بینی‌ای بر پایهٔ شواهد است، نه تضمین. برای پاسخی قاطع دربارهٔ یک NZB، nzbfast check (§15) مقاله‌های واقعی را می‌شمارد.

بودجهٔ حافظه - و هزینهٔ حافظهٔ کم

همهٔ حافظه‌های نهان موتور یک بودجه را به اشتراک می‌گذارند (پیش‌فرض ¼ از RAM فیزیکی، کران‌دار به 256 MB–16 GB). آن را صریحاً با محدودیت حافظه در تنظیمات، یا --mem-limit در خط فرمان تنظیم کنید.

nzbfast ساخته شده تا شبکه و دیسک شما را هم‌زمان خیس کند، و RAM همان چیزی است که به آن اجازه می‌دهد هر دو را در یک گذر انجام دهد: مقاله‌ها رمزگشایی، تأیید و مستقیماً در آفست‌های نهایی‌شان نوشته می‌شوند، پس جلدهای آرشیو اصلاً نیازی نیست به دیسک برسند. آن را از حافظه محروم کنید و چیزی نمی‌شکند - هر حافظهٔ نهان یک مسیر سرریز دارد، و موتور به‌جای swap یا شکست به I/O دیسک بیشتر تنزل می‌کند. اما آن سرریز رایگان نیست، و روی کارهای بزرگ می‌توانید آن را بسنجید.

سنجیده روی یک ماشین و یک خط (M1 Ultra، 10 GbE)، فایل‌های یکسان در هر بودجه. هر اجرا یک نتیجهٔ درست، کاملاً تأییدشده و استخراج‌شده تولید کرد:

اندازهٔ کارRAM فراوانبودجهٔ 2 GB
≈ ماشین 8 GB
بودجهٔ 1 GB
≈ ماشین 4 GB
بودجهٔ 256 MB
≈ NAS 2 GB
7 GB15 s15 s15 s15 s
35 GB65 s70 s70 s65 s
87 GB148 s206 s +39%196 s +32%180 s +22%
190 GB330 s427 s +29%402 s +22%411 s +25%

اوج حافظه بودجه را دنبال می‌کند، نه کار را: آن دانلود 190 GB در حدود 1.1 GB از RAM کامل می‌شود. آنچه در ازایش می‌دهید زمان است - و فقط روی کارهای بزرگ.

توصیهبه nzbfast تقریباً 2 GB بودجه به‌ازای هر 100 GB از بزرگ‌ترین کاری که دانلود می‌کنید بدهید، و در غیر این صورت پیش‌فرض را رها کنید - ¼ از RAM از پیش پاسخ درست روی بیشتر ماشین‌هاست. در عمل: 4 GB RAM کارهای تا ~35 GB را با سرعت کامل پوشش می‌دهد؛ 8–16 GB کارهای 100 GB به بالا را هم آنجا نگه می‌دارد؛ یک NAS 2 GB هرچه به آن بدهید تمام می‌کند، اما با آن مثل یک دانلودر پس‌زمینه رفتار کنید نه چیزی که یک خط سریع را اشباع کند.

روی یک NAS کوچک، همراه با بودجه اتصال‌ها را هم پایین بیاورید (2–4). با بودجهٔ 256 MB و 2 اتصال، اوج حافظه نزدیک 190 MB می‌ماند - به‌راحتی درون آنچه یک NAS 2 GB اضافه دارد. آگاه باشید که در آن نقطه، تعداد اتصال، نه حافظه، چیزی است که شما را محدود می‌کند: همان کار 35 GB به‌جای 65 s، 286 s طول کشید. این شکل صادقانهٔ این معامله است - همیشه تمام می‌کند، و درست تمام می‌کند؛ فقط خط را خیس نمی‌کند.

محک‌ها برای هر انتشار دوباره اجرا می‌شوند؛ روش و ارقام هر ماشین در کنار نتایج منتشر می‌شوند.

14 · به‌روزرسانی‌ها

به‌روزرسانی بدون از دست دادن تنظیمات

یک قاعده همهٔ نصب‌ها را پوشش می‌دهد: به‌روزرسانی برنامه را جایگزین می‌کند، هرگز تنظیمات شما را نه. هر آنچه پیکربندی کرده‌اید - سرورها، مسیرها، کلید API، صف - در چند فایل انگشت‌شمار داخل یک پوشه زندگی می‌کند (§17)، و هیچ نصب‌کننده‌ای، کشیدن ایمیجی یا ارتقای بسته‌ای به آن پوشه دست نمی‌زند. وقتی تنظیمات پس از یک به‌روزرسانی گم‌شده به نظر می‌رسند، تقریباً همیشه به این دلیل است که نصب جدید پوشه‌ای دیگر و خالی را می‌خواند، نه اینکه چیزی حذف شده باشد؛ فایل‌های قدیمی هنوز همان‌جایی هستند که همیشه بودند. §18 گام‌های بازیابی را دارد.

نصبروش به‌روزرسانی
اپ macOSDMG جدید را باز کنید و NzbFast را به Applications بکشید و جایگزین قدیمی کنید. پوشهٔ داده‌های شما جداست و دست نمی‌خورد.
نصب‌کنندهٔ Windowsنصب‌کنندهٔ جدید را روی نصب قدیمی اجرا کنید. پوشهٔ داده‌های شما جداست و دست نمی‌خورد.
Docker (خط فرمان)docker pull nzbfast/nzbfast، کانتینر قدیمی را حذف کنید، سپس جدید را با دقیقاً همان نگاشت‌های -v اجرا کنید. ایمیج دورانداختنی است؛ پوشهٔ نگاشت‌شدهٔ /config نصبِ شماست. اگر فرمان اجرای شما مسیری نسبی مانند -v ./config:/config دارد، هر بار آن را از همان پوشه اجرا کنید - از هر جای دیگری، ./config پوشه‌ای دیگر و خالی است.
Docker Composedocker compose pull && docker compose up -d، با همان فایل compose در همان جا. ./config داخل فایل به پوشهٔ خودِ فایل لنگر انداخته، پس فایل را همان‌جا که هست نگه دارید.
Watchtowerکاری لازم نیست: وقتی ایمیج تازه‌ای منتشر شود، کانتینر را با همان نگاشت‌ها دوباره می‌سازد.
Unraidزبانهٔ Docker → Check for UpdatesApply Update. هرگز برای به‌روزرسانی، اپ را حذف و دوباره اضافه نکنید؛ اگر روزی واقعاً دوباره نصب کردید، همان مسیر appdata را نگه دارید تا /config موجودتان را پیدا کند.
Synology (Container Manager)ایمیج جدید را دانلود کنید، کانتینر را متوقف کنید و آن را با همان تنظیمات volume دوباره بسازید - راهنمای Synology این را کلیک به کلیک پوشش می‌دهد، از جمله انجامش طبق زمان‌بندی.
Synology (بسته).spk جدید را در Package Center نصب کنید؛ در جای خود ارتقا می‌یابد.
Homebrewbrew upgrade nzbfast
باینری سادهباینری را جایگزین کنید. config شما هر جا که ساختیدش می‌ماند (§17).
نکتهکاربران Docker که Sonarr یا Radarr را وصل می‌کنند: کلید API را در خود تعریف کانتینر بگذارید (-e NZBFAST_APIKEY=…، یا بلوک environment فایل compose یا قالب Unraid خودتان). کلیدی که آنجا ذخیره شود از هر سانحهٔ کانتینری جان به در می‌برد، چون روی میزبان، درون تعریف، زندگی می‌کند و در هر شروع دوباره اعمال می‌شود. کلیدی که بعداً در تنظیمات تعیین کنید همچنان بر آن می‌چربد.

15 · خط فرمان

هر آنچه دیمن انجام می‌دهد اسکریپت‌پذیر هم هست. فرمان‌های روزمره:

فرمانهدف
nzbfast setupراه‌اندازی تعاملی سرور.
nzbfast serveاجرای دیمن (داشبورد + API + خودکارسازی). --open مرورگر را باز می‌کند؛ --apikey کلید را دستی تعیین می‌کند (§2--bind نشانی گوش‌دادن را انتخاب می‌کند، پیش‌فرض 0.0.0.0 (هر رابط)، 127.0.0.1 فقط برای همین ماشین. برای فهرست کامل پرچم‌ها --help را ببینید - هر تنظیم داشبورد یک پرچم دوقلو دارد.
nzbfast get file.nzbدانلود یک NZB، خط پردازش کامل، بدون دیمن. --preflight اگر پست نتواند کامل شود زود لغو می‌کند؛ --password برای مجموعه‌های رمزگذاری‌شده.
nzbfast check file.nzbحکم موجود بودن - COMPLETE / REPAIRABLE / IMPOSSIBLE - بدون دانلود محموله.
nzbfast verify DIRتأیید فایل‌ها در برابر مجموعهٔ PAR2 در یک پوشه.
nzbfast sysbenchمحک سیستم + گزارش تنوع، در ترمینال.
nzbfast index / searchاسکن گروه‌ها به درون ایندکس / جست‌وجوی آن، بدون دیمن.
nzbfast import-sabوارد کردن سرورها از یک ini SABnzbd.

همچنین در دسترس: inspect، probe، bench، bench-cpu، soak، fetch، spots/spot-search/spot-get (Spotnet)، predb-seed (پایگاه pre را با دورهٔ پیش از روشن شدن خوراک پر می‌کند)، make-release-nzb/make-test-nzb (نصب‌واره‌های آزمون). هر فرمان --config و --help می‌گیرد. به این‌ها post افزوده می‌شود: فایل‌ها را همچون مقاله‌های yEnc بارگذاری می‌کند و NZB متناظر را می‌نویسد. ابزاری عملیاتی است؛ --post-server صریح می‌خواهد و هرگز به‌جای شما سروری برنمی‌گزیند.

16 · مرور کلی API

نقطهٔ پایانی پایه: http://host:6789/api?mode=…&apikey=…&output=json - سازگار با SABnzbd، پس یکپارچه‌سازی‌های موجود SAB بی‌تغییر کار می‌کنند. دو کلید: کلید API (کنترل کامل) و کلید NZB (فقط-افزودن: addfile/addurl). addnzblnk عمداً در مجموعه فقط‌افزودن نیست: حل‌کردن یک پیوند می‌تواند سهمیه اندازه‌گیری‌شده ایندکسر را خرج کند، و این کارِ یک اعتبارنامه فقط‌افزودن نیست.

حوزهحالت‌ها
صفqueue (با name=delete/pause/resume/priority/switchpause، resume، addfile، addurl، addnzblnk، retry، set_password
اطلاعاتhistory، status/fullstatus، stats، version، server_stats، usage، log، warnings، به‌علاوهٔ /jobnzb/<nzo_id> (فایل .nzb ذخیره‌شدهٔ خودِ کار را پس می‌دهد، صف یا تاریخچه؛ فقط با کلید کامل API)
پیکربندیget_config، config&name=<setting>&value=… (هر فیلد تنظیمات)، server_save/delete/test/enable/reorder، import_probe/apply
ایندکس و دیوارindex_search، index_get، index_stats، index_scan_now، wall، wall_search/fix/refresh/art، به‌علاوه newznab در /api?t=caps|search|tvsearch|movie و /getnzb/<id>
خودکارسازیwatchlist، watchlist_check_now، watch_calendar، feeds، smart_folders، schedule
عیب‌یابیsysbench، bench_history، connladder، pooltest، diversity، update_check، update_apply
NZBGet JSON-RPC/jsonrpc - status، listgroups، history، append، editqueue، rate، pause، log (احراز پایه: هر کاربر، کلید API به‌عنوان رمز عبور)
پیش‌نمایش / پخش/stream/<nzo_id> (بازه‌های HTTP؛ آغاز یک کار پارک‌شدهٔ کتابخانه به توکن ?t= یا کلید نیاز دارد)، /m3u/<id> (به کلید نیاز دارد؛ توکن را می‌سازد)، /wall، /art/…

17 · فایل‌ها و مکان‌ها

اینکه پوشهٔ تنظیمات کجاست به روش نصب nzbfast بستگی دارد. همین یک پوشه هر آنچه را که ارزش پشتیبان‌گیری دارد در خود نگه می‌دارد:

نصبپوشهٔ تنظیمات
اپ macOS~/Library/Application Support/nzbfast/
Windows%LOCALAPPDATA%\nzbfast\
کانتینرهای Docker / NAS/config درون کانتینر، که همان پوشهٔ میزبانی است که به آن نگاشت کرده‌اید. روی Unraid این همان پوشهٔ appdata اپ است.
بستهٔ Synology/var/packages/nzbfast/var/
ترمینالپوشه‌ای که nzbfast setup را در آن اجرا کردید، یا هر جا که --config / $NZBFAST_CONFIG اشاره می‌کند.

و آنچه درون آن است:

فایلمحتوا
config.local.jsonاعتبارنامه‌های سرور و گزینه‌های هر سرور. توسط جادوگر ساخته می‌شود؛ در تنظیمات قابل ویرایش. آن را خصوصی نگه دارید. رمزهای عبور مبهم‌سازی شده‌اند، نه رمزگذاری.
settings.jsonهر تنظیمی که در داشبورد تغییر داده شده. کنار config زندگی می‌کند؛ مقادیر رابط بر پرچم‌های خط فرمان می‌چربند. یک کلید (یا فایل) را حذف کنید تا به پرچم‌ها/پیش‌فرض‌ها بازگردد.
apikeyکلید APIای که nzbfast در نخستین اجرا برای خود ساخت (§2). کنار config زندگی می‌کند؛ روی macOS و Linux تنها برای حسابی که nzbfast را اجرا می‌کند خواندنی است. برای گرفتن کلیدی تازه حذفش نکنید: روی نصبی که از پیش اجرا شده، چیزی جایش را نمی‌گیرد و دیمن بدون هیچ کلیدی بالا می‌آید. به‌جایش کلید تازه را در تنظیمات → امنیت تعیین کنید.
index.dbایندکس ریلیز (SQLite) + فرادادهٔ دیوار. حذفش امن است - از اسکن دوباره ساخته می‌شود (تنظیمات → ایندکس‌گذاری → پاک کردن این کار را برایتان می‌کند).
<config>/.spool/حالت صف (از راه‌اندازی مجدد جان به در می‌برد)، NZBهای هر کار، دفتر مصرف، تاریخچهٔ محک، حافظهٔ نهان تصویر پوستر.
ژورنال مقالهدرون پوشهٔ خروجی هر کار تا زمانی که ناقص است - ازسرگیری پس از خرابی و تلاش مجدد را نیرو می‌دهد. هنگام موفقیت حذف می‌شود.
ابزارهای بیرونیهیچ‌کدام لازم نیست - استخراج RAR و تعمیر PAR2 بومی‌اند. اگر روزی مجموعه‌ای غیرمعمول به unrar یا par2 بیرونی به‌عنوان جایگزین نیاز داشت، nzbfast کنار فایل اجرایی خود، سپس روی $PATH می‌گردد.

18 · عیب‌یابی

نشانهبررسی
دانلودهای کندمحک سیستم را اجرا کنید - گلوگاه را صریح نام می‌برد. اگر شبکه است: تنظیم دقیق اتصال را اجرا کنید، تعداد اتصال هر سرور را بررسی کنید، و مطمئن شوید ارائه‌دهنده‌هایتان همگی یک ستون فقرات نیستند (تنوع سرورها).
کند فقط روی کارهای بسیار بزرگ
(NAS یا ماشین کم-RAM)
مورد انتظار و قابل سنجش: یک بودجهٔ حافظهٔ گرسنه، حافظه‌های نهان را روی دیسک سرریز می‌کند و پس از ~87 GB معادل 20–40% هزینه دارد. برای ارقام و اینکه چه‌قدر RAM بدهید بودجهٔ حافظه را ببینید. کارهای کوچک‌تر تأثیر نمی‌پذیرند.
دانلود با «articles missing» ناموفق می‌شودپست منقضی شده یا روی ارائه‌دهنده‌های شما برداشته شده. یک ارائه‌دهندهٔ دوم روی ستون فقرات متفاوت بیشتر این‌ها را نجات می‌دهد. nzbfast check این را پیش از دانلود پیش‌بینی می‌کند. و دیوار با نقطهٔ در‌دسترس‌بودنش (§13) مواردی را که احتمالاً رفته‌اند از پیش نشانه می‌گذارد. نخستین شکست از این دست، پس از مهلتی یک بار خودبه‌خود تکرار می‌شود، چون تأخیر انتشار دقیقاً همین شکل را دارد و خودبه‌خود برطرف می‌شود.
آرشیو تمام‌شده رمز عبور می‌خواهدردیف تاریخچه 🔑 نشان می‌دهد - رمز را همان‌جا وارد کنید؛ کار در جای خود کامل می‌شود.
آرشیوی استخراج نمی‌شودخطاهای رمز عبور و تعمیر خودشان را در ردیف تاریخچه نشان می‌دهند. برای بقیه موارد یک راه فرار هست: تنظیمات → پوشهٔ پایش و پس‌پردازش → استخراج با unrar خارجی (تنظیمی پیشرفته) استخراج را به برنامه unrar نصب‌شده روی دستگاه شما می‌سپارد، به‌جای استخراج‌کننده داخلی. در غیر این صورت آن را خاموش بگذارید: مسیر داخلی در هر شکلی که سنجیده‌ایم سریع‌تر است، و پست‌های مبهم‌سازی‌شده با نام‌های hash به هر حال همیشه از آن استفاده می‌کنند، چون unrar نمی‌تواند تغییر نام آن‌ها را دنبال کند. همین کلید برای اجراهای nzbfast get متغیر محیطی NZBFAST_NO_NATIVE_UNRAR=1 است. اگر unrar آرشیوی را استخراج کرد که استخراج‌کننده داخلی رد کرده بود، لطفاً گزارش دهید تا مسیر داخلی را درست کنیم.
Sonarr/Radarr نمی‌تواند متصل شودپورت 6789 قابل دسترس است؟ کلید API درست است (کلید کامل، نه کلید NZB)؟ نوع کلاینت روی SABnzbd تنظیم شده؟
داشبورد کلید APIای می‌خواهد که هرگز تعیینش نکرده‌امنصب تازه یکی برای خود می‌سازد و هنگام شروع یک بار چاپش می‌کند (§2). در فایل apikey کنار config شما و در خروجی شروع هست. یا از مرورگری که از پیش وارد شده، کلید خودتان را در تنظیمات → امنیت تایپ کنید.
همهٔ تنظیماتم بعد از یک به‌روزرسانی گم‌شده به نظر می‌رسند
(سرورها، مسیرها، کلید API)
هیچ‌چیز در یک به‌روزرسانی تنظیمات را حذف نمی‌کند؛ این یعنی nzbfast پوشه‌ای دیگر و خالی را می‌خواند. نخست: فیلد کلید API در تنظیمات از روی عمد خالی نشان داده می‌شود - پیش از آنکه نتیجه بگیرید گم شده، روی Show کلیک کنید. روی Docker، نگاشت /config کانتینر جدید را با قدیمی مقایسه کنید: مسیر میزبانِ تغییرکرده، مسیر نسبی‌ای که از پوشه‌ای دیگر اجرا شده، یا پوشهٔ appdata تازه، همگی nzbfast را از صفر شروع می‌کنند در حالی که تنظیمات واقعی شما دست‌نخورده در مسیر قبلی نشسته‌اند. پوشهٔ قدیمی را پیدا کنید (دنبال settings.json، فایل config خودتان و apikey بگردید - مکان‌ها در §17)، سپس یا نگاشت را به آن برگردانید یا آن فایل‌ها را در پوشهٔ جدید کپی کنید و دوباره راه‌اندازی کنید. گزارش راه‌اندازی نام دقیق فایل تنظیمات در حال استفاده را می‌برد: [settings] applying saved settings from …
هیچ‌چیز روی شبکه به دیمن نمی‌رسد--bind را بررسی کنید: 127.0.0.1 تنها به ماشینی که nzbfast روی آن اجرا می‌شود سرویس می‌دهد. پیش‌فرض، 0.0.0.0، به هر رابط سرویس می‌دهد. سپس فایروال خودِ ماشین را برای پورت 6789 بررسی کنید.
کارت مرور کوچک می‌ماندایندکسر در پس‌زمینه رشد می‌کند - بررسی کنید گروه‌های تنظیمات → ایندکس‌گذاری تنظیم شده باشند، و به عمیق‌سازی در هر اسکن زمان بدهید تا تاریخچه انباشته شود. «همین حالا اسکن کن» یک گذر را اجبار می‌کند؛ خط وضعیت پیشرفت زنده را نشان می‌دهد.
دیوار تصویر اشتباه/بدون تصویر نشان می‌دهدبرگهٔ جزئیات → ✎ اصلاح تطبیق یا ↻ تازه‌سازی فراداده. جست‌وجوهای فیلم با یک کلید رایگان OMDb بهتر می‌شوند.
macOS می‌گوید برنامهٔ «nzbfast» باز نمی‌شوددو دلیل دارد، هر دو زودحل. اگر از -macos-universal.zip ساده استفاده می‌کنید، روی Start nzbfast.command دوبار کلیک کنید، نه روی فایل nzbfast کنار آن: آن یکی خودِ برنامه است و Finder به دوبار کلیک روی آن دقیقاً همین پیام را می‌دهد. این راه‌انداز است که همه‌چیز را آماده و اجرا می‌کند. اگر راه‌انداز هم همین پیام را داد، نسخه در راه بیت اجرای یونیکس خود را از دست داده است: macOS این بیت را داخل فایل .zip نگه می‌دارد، اما برنامه‌های گفت‌وگو، درایوهای ابری و فشرده‌سازی دوباره آن را نگه نمی‌دارند، پس نسخه‌ای که دست‌به‌دست رسیده باشد بدون اجازهٔ اجرا می‌رسد. فایل .dmg یا .zip را مستقیم از صفحهٔ releases دانلود کنید تا این اتفاق نیفتد. برای نجات نسخه‌ای که همین حالا دارید: ترمینال را باز کنید، chmod +x را با یک فاصله در انتها بنویسید، Start nzbfast.command و فایل nzbfast را روی پنجره بکشید و Return را بزنید، سپس دوباره روی راه‌انداز دوبار کلیک کنید.
دیمن شروع نمی‌شود: پورت در حال استفادهنمونهٔ دیگری در حال اجراست - یا --port را تغییر دهید.
گزارش‌ها کجا هستند؟کارت گزارش در داشبورد، یا ترمینال/فایل‌گزارشی که serve را با آن اجرا کردید.
هنوز گیر کرده‌اید؟کارت گزارش معمولاً مقصر را نام می‌برد - هنگام گزارش یک مشکل، دنبالهٔ آن را همراه با nzbfast --version خود بگنجانید.

nzbfast - این راهنما با هر انتشار عرضه می‌شود. تنظیمات، نقاط پایانی و پیش‌فرض‌های ارجاع‌شده اینجا با نسخه‌ای که با آن عرضه شده مطابقت دارند.