الأقسام والوضع الآمن

أوقف الأقسام التي لا تستعملها، وابدأ في الوضع الآمن حين يتعطّل شيء، وأعد تشغيل HolyArrs من المتصفح.

تشغيل قسم أو إيقافه

في HolyArrs 5 أقسام: Movies (الأفلام) وTV shows (المسلسلات) وMusic (الموسيقى) وSubtitles (الترجمات) وRequests (الطلبات). تختارها أول مرة في معالج التشغيل الأول.

1. افتح Settings > Parts (الإعدادات > الأقسام).
2. انقر Turn on (تشغيل) أو Turn off (إيقاف) بجانب القسم. سترى عناصره في القائمة تظهر أو تختفي.

لا يُحذف شيء. شغّل القسم من جديد فيكمل من حيث توقف.

البدء في الوضع الآمن

يشغّل الوضع الآمن الأساسيات وحدها، وهو للحالات التي يمنع فيها شيء ما HolyArrs من البدء أو العمل. يمكنك تسجيل الدخول، وتصفّح مكتبتك، وتغيير الإعدادات، وإنشاء نسخة احتياطية أو استعادتها. أما البحث والإضافة والتحديث والتنزيل والاستيراد فتنتظر التشغيل العادي التالي.

1. افتح Settings > Danger zone (الإعدادات > منطقة الخطر).
2. انقر Restart in safe mode (إعادة التشغيل في الوضع الآمن). سترى شريطًا في كل صفحة.
3. أصلح المشكلة، ثم انقر Restart HolyArrs (إعادة تشغيل HolyArrs). التشغيل التالي عادي.

إذا لم تستطع الوصول إلى الصفحة، فعيّن HOLYARRS_SAFE_MODE=1 في Compose أو شغّله مع -safe-mode. أزله بعد الإصلاح: كلاهما يُبقي كل تشغيل في الوضع الآمن.

الخيارات

ما الذي يتوقف حين يكون القسم موقوفًا

القسم	يتوقف	يستمر
الأفلام	صفحات الأفلام وعناصرها في القائمة، والإضافة، والبحث، والتحديث	التنزيلات الموجودة في برنامج التنزيل تبقى تحت المتابعة. الملفات تبقى.
المسلسلات	صفحات المسلسلات، والإضافة، والبحث، والبحث عن المواسم، والتحديثات	مثل الأفلام.
الموسيقى	صفحات الفنانين والألبومات، وإعدادات الموسيقى، وتحديثات الفنانين، والبحث عن الألبومات	مثل الأفلام.
الترجمات	إعدادات الترجمات، وصفحة الترجمات الناقصة، وعمليات البحث والفحص	ملفات الترجمات المجاورة لفيديوهاتك تبقى.
الطلبات	صفحات الطلبات وطلب الأعمال	الطلبات الموجودة تبقى وتعود حين يُشغَّل القسم من جديد.

تعمل دائمًا: تسجيل الدخول والحسابات، ومجلدات المكتبة، والمصادر، وبرامج التنزيل والتنزيلات، والتنبيهات، والسجل، والنسخ الاحتياطية، وفحوص السلامة، والإعدادات، وAPI.

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

إعادة التشغيل والإيقاف المؤقت والإغلاق

في Settings > Danger zone (للمالك والمشرفين) تجد Restart HolyArrs وRestart in safe mode وShut down (إغلاق)، ومعها Pause (إيقاف مؤقت) وResume (استئناف) وRestart (إعادة التشغيل) لكل مهمة خلفية، مثل النسخ الاحتياطية أو مزامنة التنزيلات.

• عناصر التحكم التي توقف شيئًا تطلب منك التأكيد خلال 60 ثانية.
• كل عنصر تحكم يُستعمل يُكتب في السجل باسمك.
• تحتاج إلى تسجيل دخول بكلمة المرور. تسجيل الدخول من دون كلمة مرور على شبكتك المحلية يُرفض.

إعادة التشغيل توقف HolyArrs إيقافًا سليمًا وتترك Docker يشغّله من جديد، فعيّن restart: unless-stopped.

سياسة إعادة التشغيل	إعادة التشغيل	الإغلاق
unless-stopped أو always	يعود	يعود أيضًا
on-failure	يعود	يبقى متوقفًا
no	يبقى متوقفًا	يبقى متوقفًا

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

العَرَض	السبب	الحل
لا يستطيع HolyArrs إيقاف قسم	قسم آخر يحتاج إليه	أوقف ذلك القسم أولًا، كما تقول الرسالة.
إعادة التشغيل أغلقت HolyArrs نهائيًا	سياسة إعادة التشغيل هي no	شغّل الحاوية وعيّن restart: unless-stopped.
عناصر التحكم تُرفض	تسجيل دخول محلي من دون كلمة مرور، أو المفتاح ينقصه control	سجّل الدخول بكلمة المرور.
مهمة تبقى فاشلة	تحتاج إلى تدخّلك	اقرأ سببها في /health، وأصلحه، ثم انقر Restart لتلك المهمة.

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

للخبراء

حالات السلامة

تعرض /health وSettings > Parts وGET /api/v1/health/states كل مهمة خلفية وقسم وتطبيق مرتبط مع حالة وسبب.

الحالة	المعنى
off	موقوف، أو متوقف مؤقتًا، أو لم يبدأ بسبب الوضع الآمن.
starting	يبدأ، أو لم يُفحص بعد.
running	يعمل.
retrying	فشل؛ يحاول HolyArrs مرة أخرى، مع انتظار أطول في كل مرة.
failed	تعطّل أو علق أو يحتاج إلى تدخّلك. السبب يذكر ما عليك فعله.

المهمة التي تتعطّل تعرض failed، ثم retrying، ثم تبدأ من جديد. وفي الأثناء يستمر تسجيل الدخول والمكتبة والنسخ الاحتياطية في العمل. والمهمة العالقة تزول حالتها بإعادة تشغيل كاملة.

الذاكرة ووضع الذاكرة المنخفضة

يسعى HolyArrs إلى البقاء تحت 384 MiB، وهذا يناسب حاوية حدّها 500 MB. لتحديد هدفك الخاص، عيّن GOMEMLIMIT إلى نحو 80 بالمئة من ذاكرة الحاوية.

وضع الذاكرة المنخفضة يُبقي أقل في الذاكرة ويقرأ أكثر من قاعدة البيانات. بعض الصفحات تأخذ لحظة أطول، والعمل الخلفي مثل نسخ فهرس الموسيقى يعمل مرات أقل.

الإعداد	الأثر
(الافتراضي، Linux)	يشتغل تلقائيًا عند نحو 2.5 GiB من الذاكرة أو أقل.
HOLYARRS_LOW_MEMORY=1	مفعّل دائمًا.
HOLYARRS_LOW_MEMORY=0	معطّل دائمًا.

أول سطر في سجل التشغيل يذكر هل هو مفعّل ولماذا.

نطاقات مفاتيح API

أنشئ مفتاحًا في Settings > API > API keys (الإعدادات > API > مفاتيح API) وأرسله في الترويسة X-Api-Key.

النطاق	يصل إلى
read	المكتبة، والمهام، والتنزيلات، والسجل، وسلامة النظام، والإعدادات. الأسرار محجوبة.
health_read	حالات السلامة فقط. لأدوات المراقبة.
write	كل تغيير ما عدا مسارات المشرف وعناصر التحكم.
admin	الأشخاص، والدعوات، وحدود الطلبات، ومفاتيح API، وكلمة المرور والتحقق بخطوتين، وإعدادات تسجيل الدخول، والنسخ الاحتياطية.
control	عناصر التحكم في هذه الصفحة. لا يمنحه إلا المالك والمشرفون.
all	read وwrite وadmin. من دون control.

لا يفعل المفتاح أبدًا أكثر مما يستطيعه الشخص الذي أنشأه. لا يمكن تغيير النطاقات لاحقًا؛ أنشئ مفتاحًا جديدًا. كل المسارات ونطاقاتها: /api/v1/openapi.json.

صفحات ذات صلة

• فحوص السلامة
• النسخ الاحتياطية
• مسارات API