متغيرات البيئة

كل متغير تقرؤه حاوية HolyArrs. أغلب عمليات التثبيت تضبط PUID وPGID وTZ فقط.

الشائعة

المتغير	ما يفعله	الافتراضي	مثال
PUID, PGID	المستخدم والمجموعة اللذان يعمل بهما HolyArrs. يجب أن يملكا /config ومجلدات الوسائط عندك.	1000, 1000	PUID=1000
TZ	المنطقة الزمنية للمواعيد المجدولة وسجلات التشغيل.	Etc/UTC	TZ=Europe/Amsterdam
UMASK	بتات الأذونات التي لا تحصل عليها الملفات الجديدة. يؤثر في الملفات الجديدة فقط.	022	UMASK=002
HOLYARRS_SAVE_PATH	مجلد الحفظ في برنامج التنزيل، كما يراه برنامج التنزيل. يُرسَل مع كل تنزيل.	لا شيء	/data/downloads
HOLYARRS_URL_BASE	يقدّم HolyArrs تحت مسار خلف الوكيل العكسي (reverse proxy). القيمة / تتجاهل المسار المحفوظ في الإعدادات.	لا شيء	/holyarrs
HOLYARRS_ALLOWED_HOSTS	أسماء مضيف إضافية يصل بها الناس إلى HolyArrs، مفصولة بفواصل.	عناوين IP وlocalhost	holyarrs.example.com
HOLYARRS_TRUSTED_PROXIES	عنوان الوكيل العكسي عندك أو شبكته، مفصولة بفواصل. لازم لمعرفة العناوين الحقيقية للعملاء.	لا شيء	172.18.0.0/16
HOLYARRS_MASTER_KEY_FILE	يقرأ المفتاح الرئيسي للخزنة من ملف خاص به. يجب أن يستطيع مستخدم PUID قراءته.	/config/holyarrs.key	/keys/holyarrs.key

قيم من ملفات

ضع FILE__ قبل أي متغير لتُقرأ قيمته من ملف، مثل سر من أسرار Docker.

environment:
  - FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

يحذف HolyArrs سطرًا جديدًا واحدًا من آخر الملف. إذا كان الملف غير موجود، يتوقف HolyArrs ويذكر سجل التشغيل اسم المتغير والملف، ولا يذكر القيمة أبدًا.

الاستعادة وحل المشكلات

المتغير	ما يفعله	الافتراضي	مثال
HOLYARRS_SAFE_MODE	يشغّل الأساس فقط: تسجيل الدخول والمكتبة والإعدادات والنسخ الاحتياطية وسلامة النظام. أزله بعد الإصلاح.	متوقف	1
HOLYARRS_LOW_MEMORY	1 يفرض تشغيل وضع الذاكرة المنخفضة، و0 يفرض إيقافه. إذا لم يُضبط، يعمل الوضع عند نحو 2.5 GiB من الذاكرة أو أقل.	حسب حجم الجهاز	1
GOMEMLIMIT	يتجاوز هدف الذاكرة الذي يضعه HolyArrs لنفسه.	يضبطه HolyArrs	1GiB
HOLYARRS_SKIP_SPACE_CHECK	يتخطى فحص المساحة الحرة قبل تحديث قاعدة البيانات.	متوقف	yes
HOLYARRS_CONFIG_IN_MEMORY	يسمح بوضع /config في مجلد يعيش في الذاكرة. لأجهزة الاختبار؛ تضيع البيانات عند إعادة التشغيل.	متوقف	yes
HOLYARRS_ALLOW_DESKTOP_FOLDER	يبدأ التشغيل و/config في مجلد مشترك من Docker Desktop على Mac، بعد أن تتأكد أن أقفال الملفات تعمل هناك. يحذّرك HolyArrs عند كل تشغيل.	متوقف	1
HOLYARRS_READONLY_DOWNLOADERS	برامج التنزيل التي يجب ألا يغيّرها HolyArrs أبدًا، بالمعرّف أو العنوان، مفصولة بفواصل.	لا شيء	3,http://qbit:8080
HOLYARRS_HEALTH_URL	العنوان الذي يستدعيه فحص السلامة في الحاوية.	http://127.0.0.1:6262	http://127.0.0.1:6262/holyarrs

متغيرات التشغيل والإيقاف تقبل 1 أو true أو yes أو on.

تسجيل الدخول الموحّد

اضبط هذه المتغيرات قبل التشغيل. إذا وُجد HOLYARRS_OIDC_ENABLED أصلًا، ولو بقيمة false، فالبيئة هي التي تتحكم في تسجيل الدخول الموحّد والإعدادات تعرضه فقط. متغيرات التشغيل والإيقاف هنا تقبل true أو false فقط؛ وأي قيمة أخرى توقف التشغيل.

المتغير	ما يفعله	الافتراضي
HOLYARRS_OIDC_ENABLED	يشغّل تسجيل الدخول الموحّد.	false
HOLYARRS_OIDC_ISSUER	عنوان المُصدِر (issuer) عند المزوّد، بصيغة HTTPS وبنصه الحرفي.	لا شيء
HOLYARRS_OIDC_CLIENT_ID	معرّف العميل المسجَّل.	لا شيء
HOLYARRS_OIDC_CLIENT_SECRET_FILE	ملف فيه سر العميل، 4096 بايت على الأكثر. لا تضبطه إذا كان العميل عامًا.	لا شيء
HOLYARRS_OIDC_REDIRECT_URL	عنوان الرجوع بنصه الحرفي: عنوانك، ثم URL base إن وُجد، ثم /api/v1/auth/oidc/callback.	لا شيء
HOLYARRS_OIDC_ALLOW_JOIN	ينضم الأشخاص الجدد أعضاءً يستطيعون الطلب فقط.	false
HOLYARRS_OIDC_ALLOW_LOCAL_NETWORK	يسمح بمزوّد على شبكتك الخاصة.	false
HOLYARRS_OIDC_ALLOW_LOOPBACK_HTTP	يسمح باستخدام HTTP العادي على هذا الجهاز، للاختبار.	false
HOLYARRS_FORWARD_AUTH_ENABLED	يشغّل تسجيل الدخول عبر وكيل موثوق.	false
HOLYARRS_FORWARD_AUTH_ISSUER	اسم HTTPS ثابت للوكيل.	لا شيء
HOLYARRS_FORWARD_AUTH_TRUSTED_PEERS	عناوين الوكيل أو نطاقاته المسموح لها بإرسال ترويسات الهوية، مفصولة بفواصل.	لا شيء
HOLYARRS_FORWARD_AUTH_ALLOW_JOIN	تنضم الأسماء الجديدة القادمة من الوكيل أعضاءً يستطيعون الطلب فقط.	false

الإعداد الخاطئ يمنع HolyArrs من التشغيل. الخطوات في تسجيل الدخول وكلمات المرور.

للخبراء

البيانات الوصفية

المتغير	ما يفعله	الافتراضي
HOLYARRS_METADATA_URL	عنوان خادم البيانات الوصفية.	https://api.holyarrs.com
HOLYARRS_TMDB_KEY	رمز قراءة TMDB الخاص بك. إذا ضُبط، تذهب قراءات TMDB إلى TMDB مباشرة بدل خادم البيانات الوصفية.	لا شيء
HOLYARRS_METADATA_SERVICE_TOKEN_FILE	ملف فيه بيانات اعتماد هذا التثبيت لدى خادم البيانات الوصفية، يُقرأ عند كل استدعاء. إذا لم يُضبط، تبقى بيانات الاعتماد في الخزنة.	لا شيء

اختصارات التشغيل الأول

كل واحد منها يضيف عنصرًا واحدًا عند التشغيل. تُستخدم للعروض والاختبارات؛ ومعالج التشغيل الأول يفعل الشيء نفسه.

المتغير	ما يضيفه
HOLYARRS_MOVIES	مجلد المكتبة للأفلام.
HOLYARRS_QBITTORRENT_URL	برنامج التنزيل qBittorrent.
HOLYARRS_SOURCE_URL	مصدر Torznab بلا مفتاح.

متغيرات المطوّرين والاختبار

توجّه هذه المتغيرات HolyArrs إلى بدائل وهمية للاختبارات. اتركها بلا ضبط في التثبيت الحقيقي.

المتغير	ما يفعله
HOLYARRS_FLAGS	مفاتيح مفصولة بفواصل لميزات متوقفة افتراضيًا في هذا الإصدار من التطبيق. راجع التحديثات.
HOLYARRS_DIRECT_SOURCES	1 يجعل هذا التثبيت يسأل مصادر الموسيقى والمسلسلات بنفسه بدل خادم البيانات الوصفية.
HOLYARRS_METADATA_SERVICE_ALLOW_LOCAL	يسمح بخادم بيانات وصفية على الشبكة المحلية.
HOLYARRS_METADATA_COUNT	يعدّ طلبات البيانات الوصفية ويكتبها في سجل التشغيل.
HOLYARRS_TMDB_TOKEN_FILE, HOLYARRS_TMDB_URL	ملف رمز TMDB للاختبار وعنوان بديل.
HOLYARRS_TVMAZE_URL, HOLYARRS_MUSICBRAINZ_URL, HOLYARRS_DEEZER_URL, HOLYARRS_TRAKT_URL, HOLYARRS_PLEX_URL, HOLYARRS_PLEX_APP_URL, HOLYARRS_PLEX_DISCOVER_URL, HOLYARRS_PUSHOVER_URL, HOLYARRS_TELEGRAM_URL, HOLYARRS_YOUTUBE_URL, HOLYARRS_RELEASE_FEED	عناوين بديلة للخدمات الخارجية.
HOLYARRS_TRAILER_PASS_FIRST, HOLYARRS_TRAILER_PASS_EVERY	توقيت جولة الإعلانات التشويقية بصيغة مدة، مثل 2s.

صفحات ذات صلة

• التثبيت
• التشغيل تحت مسار
• تسجيل الدخول وكلمات المرور