NAS وSynology وUnraid

شغّل HolyArrs على جهاز NAS عندك بالمجلدات الصحيحة والمالك الصحيح وإعداد إعادة التشغيل الصحيح. اقرأ التثبيت أولًا.

قبل أن تبدأ

• يوضع /config على وحدة تخزين (volume) محلية أو pool. لا على مشاركة شبكية أبدًا.
• توضع الوسائط في مجلد مشترك واحد بداخله downloads وmovies وtv وmusic. ركّب كل واحد منها، أو ركّب المجلد الأب مرة واحدة من أجل الروابط الثابتة (hardlinks). انظر المجلدات.

إعداد جهاز 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. عيّن مجلدات الوسائط إلى /movies و/tv و/music و/downloads، بمسارات قرص أو pool، مثلًا /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 من الـ datasets: 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 إلى مالك الـ dataset، وغالبًا 568. امنح ذلك المستخدم إذن الكتابة في ACL الخاصة بالـ dataset.
5. عيّن سياسة إعادة التشغيل إلى unless-stopped.
6. افتح http://your-server:6262. سترى معالج التشغيل الأول.

على كل NAS: امنح مستخدم PUID القراءة والكتابة على مجلد الوسائط من شاشة الأذونات في NAS؛ أما مجلد الإعدادات فيتكفّل به HolyArrs نفسه. فعّل إعادة التشغيل التلقائية للحاوية (سياسة unless-stopped في Docker).

للروابط الثابتة، وهي لا تأخذ مساحة إضافية وتنتهي فورًا، ركّب مجلد الوسائط الواحد بدلًا من الأربعة، وأعطِ برنامج التنزيل التركيب نفسه على المسار نفسه. انظر مجلدات الوسائط.

الخيارات

تركيبات منفصلة

تركيب /movies و/tv و/music و/downloads واحدًا واحدًا يعمل، لكن كل استيراد يصير نسخًا كاملًا. كل تركيب هو نظام ملفات مستقل داخل الحاوية، والرابط الثابت لا يعبر بين أنظمة الملفات. والمشاركات أو الـ datasets المنفصلة تحت أب واحد تُنسخ أيضًا. تحذّرك Settings > Library folders (الإعدادات > مجلدات المكتبة) حين يضطر HolyArrs إلى النسخ.

دع أقراصك تنام

هذه المهام توقظ أقراص الوسائط. غيّر عدد مرات تشغيلها من صفحة Schedules (الجداول الزمنية).

المهمة	ما الذي تقرؤه
Rescan the Library (إعادة فحص المكتبة)	كل مجلدات المكتبة. أكثر ما يوقظ الأقراص.
Check Library folders (فحص مجلدات المكتبة)	تفاصيل كل مجلد ومساحته الحرة. اختبار الكتابة والروابط الثابتة لا يعمل إلا عند التشغيل، وعند Run now (شغّل الآن)، وحين تتغيّر المجلدات.
Look for missing subtitles (البحث عن الترجمات الناقصة)، Look for better subtitles (البحث عن ترجمات أفضل)	المجلد المجاور لكل فيديو.

• ضع /config ومجلد التنزيل على SSD أو cache pool.
• أبقِ 1 GB حرة على القرص الذي فيه /config. تحت ذلك يصلك تحذير سلامة.
• على Unraid، تحتفظ الإضافة Cache Directories بقوائم المجلدات في الذاكرة، فتتجاوز عمليات الفحص القرص.
• عمليات الاستيراد والإضافة والحذف تمسّ القرص الذي تعمل عليه، وقت حدوثها.
• اضبط إعادة الفحص على كل 7 أيام أو أوقفها. عندئذ لا تُكتشف الملفات التي تضيفها يدويًا إلا حين تضغط Run now في Rescan the Library.
• التورنت الذي يُبذر (seeding) يقرأ ملفه. إذا كان مربوطًا برابط ثابت داخل مكتبتك، فذلك القرص يبقى مستيقظًا إلى أن يتوقف البذر.

إذا لم ينجح الأمر

العَرَض	السبب	الحل
لا يبدأ، ويذكر مسار FUSE أو مشاركة شبكية أو user share في Unraid	/config ليس على قرص محلي (على Unraid، يشير إلى /mnt/user)	انقل /config إلى قرص محلي أو مسار pool، مثل /mnt/<pool>/appdata/holyarrs.
يبقى متوقفًا بعد إعادة تشغيل أو استعادة	إعادة التشغيل التلقائية معطّلة	فعّلها وشغّل الحاوية.
يفشل الاستيراد بخطأ أذونات	مستخدم PUID لا يستطيع الكتابة في الوسائط	امنحه القراءة والكتابة من شاشة الأذونات في NAS (على Synology: Control Panel > Shared Folder > Edit > Permissions).
الاستيراد ينسخ ولا ينشئ روابط ثابتة	التنزيلات والمكتبة على تركيبات أو أقراص مختلفة	ركّب مجلدًا مشتركًا واحدًا مرة واحدة، في HolyArrs وفي برنامج التنزيل.

حلول أخرى: حل المشكلات.

للخبراء

لماذا يرفض HolyArrs بعض مسارات الإعدادات

يحفظ HolyArrs قواعد بياناته في /config. المشاركات الشبكية ومسارات FUSE قد تتلفها، فيرفض HolyArrs أن يبدأ على أحدها ويذكر السبب.

على Unraid، /mnt/user مسار FUSE. استعمل مسار pool، أو اجعل appdata من النوع Exclusive: فعّل Permit exclusive shares (السماح بالمشاركات الحصرية) في Settings > Global Share Settings (الإعدادات > إعدادات المشاركة العامة)، ثم اضبط Shares > appdata (المشاركات > appdata) على تخزين أساسي في pool واحد ومن دون تخزين ثانوي.

مسار /config على pool غير موجود يقع في الذاكرة ويضيع عند إعادة تشغيل الجهاز. يرفض HolyArrs ذلك أيضًا. وتجنّب /mnt/user للوسائط كذلك؛ فالروابط الثابتة عبره قد تفشل.

لماذا تهم إعادة التشغيل التلقائية

إعادة التشغيل من التطبيق والوضع الآمن واستعادة نسخة احتياطية كلها توقف HolyArrs وتنتظر من Docker أن يشغّله من جديد. من دون إعادة التشغيل التلقائية يبقى متوقفًا. انظر الأقسام والوضع الآمن.

المنفذ والتحديثات

• عيّن المنفذ 6262 لشبكتك المنزلية فقط. اقرأ أساسيات الأمان قبل فتحه لأي أحد في الخارج.
• للتحديث، اسحب الصورة الجديدة وأعد إنشاء الحاوية. بياناتك تبقى في /config. انظر التحديثات.

صفحات ذات صلة

• المجلدات
• مجلدات المكتبة
• الجداول الزمنية