NAS، Synology و Unraid

HolyArrs را روی NAS خودتان با پوشه‌ها، صاحب و تنظیم راه‌اندازی مجدد درست اجرا کنید. اول نصب را بخوانید.

پیش از شروع

• /config روی یک ولوم یا pool محلی می‌رود. هرگز روی اشتراک شبکه.
• رسانه در یک پوشهٔ مشترک می‌رود که downloads، movies، tv و music داخلش است. هر کدام را سوار کنید، یا برای hardlink (پیوند سخت) پوشهٔ والد را یک بار. پوشه‌ها را ببینید.

NAS خود را راه‌اندازی کنید

::tab[Synology]

1. در File Station، docker/holyarrs/config را بسازید.
2. یک پوشهٔ مشترک media بسازید که downloads، movies، tv و music داخلش باشد.
3. در Container Manager، Project > Create (پروژه > ساخت) را باز کنید و فایل Compose را از نصب جای‌گذاری کنید.
4. ولوم‌ها را روی /volume1/docker/holyarrs/config:/config و بعد /volume1/media/movies:/movies، /volume1/media/tv:/tv، /volume1/media/music:/music و /volume1/media/downloads:/downloads بگذارید.
5. PUID و PGID را روی کاربر خودتان بگذارید، اغلب 1026 و 100. با id <user> از طریق SSH بررسی کنید.
6. به آن کاربر دسترسی خواندن و نوشتن روی media بدهید: Control Panel > Shared Folder > Edit > Permissions (کنترل پنل > پوشهٔ مشترک > ویرایش > دسترسی‌ها).
7. Enable auto-restart (فعال کردن راه‌اندازی مجدد خودکار) را علامت بزنید.
8. http://your-server:6262 را باز کنید. باید ویزارد اولین اجرا را ببینید. /movies، /tv و /music را به‌عنوان پوشهٔ کتابخانه اضافه کنید.

::tab[Unraid]

هنوز قالب Community Applications نداریم، پس کانتینر را دستی اضافه کنید.

1. در تب Docker، یک کانتینر با ایمیج HolyArrs اضافه کنید.
2. پورت 6262 را نگاشت کنید.
3. /config را به یک مسیر pool نگاشت کنید، مثل /mnt/<pool>/appdata/holyarrs. <pool> نام pool شماست. نه /mnt/user/appdata.
4. پوشه‌های رسانه‌تان را با مسیرهای دیسک یا pool به /movies، /tv، /music و /downloads نگاشت کنید، مثلاً /mnt/<pool>/media/movies:/movies، /mnt/<pool>/media/tv:/tv، /mnt/<pool>/media/music:/music و /mnt/<pool>/media/downloads:/downloads.
5. PUID=99، PGID=100 (یعنی nobody:users در Unraid) و UMASK=022 را بگذارید.
6. شروع خودکار کانتینر را روشن کنید تا خودش دوباره راه بیفتد.
7. http://your-server:6262 را باز کنید. باید ویزارد اولین اجرا را ببینید.

::tab[QNAP]

1. Container/holyarrs/config و یک اشتراک media بسازید که downloads، movies، tv و music داخلش باشد.
2. در Container Station، Applications > Create (برنامه‌ها > ساخت) را باز کنید و فایل Compose را جای‌گذاری کنید.
3. از /share/Container/holyarrs/config:/config و بعد /share/media/movies:/movies، /share/media/tv:/tv، /share/media/music:/music و /share/media/downloads:/downloads استفاده کنید.
4. PUID و PGID را روی صاحب اشتراک media بگذارید.
5. سیاست راه‌اندازی مجدد را روی unless-stopped بگذارید.
6. http://your-server:6262 را باز کنید. باید ویزارد اولین اجرا را ببینید.

::tab[TrueNAS SCALE]

1. 2 دیتاست بسازید: apps/holyarrs-config و media، با پوشه‌های downloads، movies، tv و music داخل media.
2. در Apps، یک برنامهٔ سفارشی از YAML با فایل Compose اضافه کنید.
3. از /mnt/<pool>/apps/holyarrs-config:/config و بعد /mnt/<pool>/media/movies:/movies، /mnt/<pool>/media/tv:/tv، /mnt/<pool>/media/music:/music و /mnt/<pool>/media/downloads:/downloads استفاده کنید.
4. PUID و PGID را روی صاحب دیتاست بگذارید، اغلب 568. در ACL دیتاست به آن کاربر دسترسی نوشتن بدهید.
5. سیاست راه‌اندازی مجدد را روی unless-stopped بگذارید.
6. http://your-server:6262 را باز کنید. باید ویزارد اولین اجرا را ببینید.

روی هر NAS: در صفحهٔ دسترسی‌های NAS به کاربر PUID دسترسی خواندن و نوشتن روی پوشهٔ رسانه بدهید؛ HolyArrs خودش به پوشهٔ پیکربندی رسیدگی می‌کند. راه‌اندازی مجدد خودکار را برای کانتینر روشن کنید (سیاست unless-stopped در Docker).

برای hardlink که فضای اضافه نمی‌گیرد و فوری تمام می‌شود، یک پوشهٔ رسانه را به‌جای چهار پوشه سوار کنید و همان پوشه را در همان مسیر به دانلودرتان هم بدهید. پوشه‌های رسانه را ببینید.

گزینه‌ها

مسیرهای جدا

سوار کردن یک‌به‌یکِ /movies، /tv، /music و /downloads کار می‌کند، اما هر ورود به یک کپی کامل تبدیل می‌شود. هر مسیر داخل کانتینر سیستم فایل خودش را دارد و hardlink نمی‌تواند از یک سیستم فایل به دیگری برود. اشتراک‌ها یا دیتاست‌های جدا زیر یک والد هم کپی می‌کنند. Settings > Library folders (تنظیمات > پوشه‌های کتابخانه) وقتی HolyArrs مجبور به کپی باشد هشدار می‌دهد.

بگذارید دیسک‌هایتان بخوابند

این کارها دیسک‌های رسانه را بیدار می‌کنند. هر چند وقت یک بار اجرا شدنشان را در صفحهٔ Schedules (زمان‌بندی‌ها) تغییر دهید.

کار	چه چیزی را می‌خواند
Rescan the Library (پویش دوبارهٔ کتابخانه)	هر پوشهٔ کتابخانه. بیشتر از همه دیسک‌ها را بیدار می‌کند.
Check Library folders (بررسی پوشه‌های کتابخانه)	جزئیات و فضای خالی هر پوشه. آزمون نوشتن و hardlink فقط هنگام شروع، با Run now (هم‌اکنون اجرا کن) و وقتی پوشه‌ها عوض می‌شوند اجرا می‌شود.
Look for missing subtitles، Look for better subtitles (جست‌وجوی زیرنویس‌های ناموجود، جست‌وجوی زیرنویس بهتر)	پوشهٔ کنار هر ویدیو.

• /config و پوشهٔ دانلود را روی SSD یا cache pool بگذارید.
• 1 GB روی دیسکی که /config را نگه می‌دارد خالی نگه دارید. کمتر از آن یک هشدار سلامت می‌گیرید.
• در Unraid، افزونهٔ Cache Directories فهرست پوشه‌ها را در حافظه نگه می‌دارد، پس پویش‌ها از دیسک رد می‌شوند.
• ورودها، افزودن‌ها و پاک کردن‌ها هر وقت اتفاق بیفتند به دیسکی که رویش کار می‌کنند دست می‌زنند.
• پویش دوباره را روی هر 7 روز بگذارید یا خاموشش کنید. در این صورت فایل‌هایی که دستی اضافه می‌کنید فقط وقتی پیدا می‌شوند که روی Rescan the Library دکمهٔ Run now را بزنید.
• تورنتی که سید می‌شود فایلش را می‌خواند. اگر در کتابخانه‌تان hardlink شده باشد، آن دیسک تا پایان سید بیدار می‌ماند.

اگر کار نکرد

نشانه	علت	راه‌حل
شروع نمی‌شود، یک مسیر FUSE، اشتراک شبکه یا اشتراک کاربر Unraid را نام می‌برد	/config روی دیسک محلی نیست (در Unraid، به /mnt/user اشاره می‌کند)	/config را به یک مسیر دیسک محلی یا pool ببرید، مثل /mnt/<pool>/appdata/holyarrs.
پس از راه‌اندازی مجدد یا بازیابی خاموش می‌ماند	راه‌اندازی مجدد خودکار خاموش است	آن را روشن کنید و کانتینر را شروع کنید.
ورودها با خطای دسترسی شکست می‌خورند	کاربر PUID نمی‌تواند روی رسانه بنویسد	در صفحهٔ دسترسی‌های NAS دسترسی خواندن و نوشتن بدهید (در Synology: Control Panel > Shared Folder > Edit > Permissions).
ورودها کپی هستند، نه hardlink	دانلودها و کتابخانه روی مسیرها یا دیسک‌های متفاوت‌اند	یک پوشهٔ مشترک را یک بار سوار کنید، هم در HolyArrs و هم در دانلودر.

راه‌حل‌های بیشتر: عیب‌یابی.

برای حرفه‌ای‌ها

چرا HolyArrs بعضی مسیرهای پیکربندی را رد می‌کند

HolyArrs پایگاه‌های دادهٔ خود را در /config نگه می‌دارد. اشتراک‌های شبکه و مسیرهای FUSE می‌توانند آن‌ها را خراب کنند، پس HolyArrs روی آن‌ها شروع نمی‌شود و دلیلش را می‌گوید.

در Unraid، /mnt/user یک مسیر FUSE است. از یک مسیر pool استفاده کنید، یا appdata را Exclusive کنید: در Settings > Global Share Settings گزینهٔ Permit exclusive shares را روشن کنید، بعد Shares > appdata را روی ذخیره‌سازی اصلی یک pool و ذخیره‌سازی ثانویه را روی هیچ بگذارید.

یک مسیر /config روی pool‌ای که وجود ندارد در حافظه می‌افتد و با ریبوت از بین می‌رود. HolyArrs آن را هم رد می‌کند. برای رسانه هم از /mnt/user دوری کنید؛ hardlink از میان آن ممکن است شکست بخورد.

چرا راه‌اندازی مجدد خودکار مهم است

راه‌اندازی مجدد در برنامه، حالت امن و بازیابی بکاپ همگی HolyArrs را متوقف می‌کنند و انتظار دارند Docker دوباره شروعش کند. بدون راه‌اندازی مجدد خودکار، خاموش می‌ماند. بخش‌ها و حالت امن را ببینید.

پورت و به‌روزرسانی‌ها

• پورت 6262 را فقط به شبکهٔ خانگی‌تان نگاشت کنید. پیش از باز کردنش برای هر کس بیرون، مبانی امنیت را بخوانید.
• برای به‌روزرسانی، ایمیج جدید را بکشید و کانتینر را دوباره بسازید. داده‌هایتان در /config می‌مانند. به‌روزرسانی‌ها را ببینید.

صفحه‌های مرتبط

• پوشه‌ها
• پوشه‌های کتابخانه
• زمان‌بندی‌ها