التحديثات

جديد هنا

يخبرك HolyArrs بصدور إصدار جديد من التطبيق ولا يثبّته أبدًا. تسحب الصورة الجديدة حين يناسبك.

معرفة هل صدر إصدار جديد

افتح صفحة Status (الحالة) (http://your-server:6262/health).
اقرأ Updates (التحديثات). سترى واحدة من هذه الرسائل:

الرسالة	المعنى
“HolyArrs 1.2.0 is out, newer than this one.”	حدّث حين تكون جاهزًا
“This is the newest version.”	لا شيء عليك فعله
“No HolyArrs release is published yet.”	الخلاصة فارغة. لا يوجد خلل
“The last check did not work: …”	تعذّر الوصول إلى الخلاصة، وغالبًا لا يوجد اتصال بالإنترنت
“The update check is off: …”	أُوقف من الإعدادات

لتسأل الآن، اختر Check now (افحص الآن) (أو Check again (افحص مرة أخرى)). يحتاج ذلك إلى إذن Change settings (تغيير الإعدادات).

يظهر الإصدار الأحدث من التطبيق أيضًا كتحذير في سلامة النظام. أما الفحص الفاشل فيظهر تحت Updates وحدها.

التحديث

اسحب الصورة الجديدة وأعد التشغيل: docker compose pull، ثم docker compose up -d.
يبدأ HolyArrs. إذا غيّر الإصدار الجديد من التطبيق طريقة تخزين البيانات، يصنع نسخة احتياطية أولًا ثم يحدّث البيانات. سترى التطبيق يفتح على الإصدار الجديد.

الرجوع إلى الإصدار الأقدم

لا يستطيع HolyArrs تغيير صورته بنفسه، فتشغّل أنت الصورة الأقدم ويعيد HolyArrs البيانات الأقدم.

غيّر وسم الصورة في ملف compose (أو في docker run) إلى الوسم الأقدم، مثل holyarrs/holyarrs:<older version>.
شغّل docker compose up -d.
إذا لم يغيّر التحديث البيانات، يبدأ الإصدار الأقدم من التطبيق. انتهيت.
وإلا يعرض الإصدار الأقدم صفحة بدل التطبيق. اختر Put back the data from before the update (أعد البيانات السابقة للتحديث).
اكتب الرمز الصالح لمرة واحدة. تجده بالأمر docker logs <container>؛ ابحث عن “one-time code”.
يفحص HolyArrs النسخة الاحتياطية ويضعها في مكانها ويتوقف. سترى الحاوية تبدأ من جديد على تلك البيانات بفضل سياسة إعادة التشغيل. وإن لم تكن لها سياسة، شغّلها بنفسك.

من دون الصفحة: docker exec <container> /holyarrs restore --pre-update، ثم docker restart <container>. من دون Docker: أوقف HolyArrs، وشغّل holyarrs restore --pre-update، ثم شغّله.

لا يُحذف شيء. تنتقل البيانات الأحدث إلى backups/before-restore-<time>/، فيمكنك التراجع. وعند الرجوع أكثر من إصدار واحد، تُختار أحدث نسخة احتياطية سابقة للتحديث يستطيع ذلك الإصدار قراءتها.

الخيارات

كلها في Settings > Health checks (الإعدادات > فحوص السلامة). والثلاثة الأخيرة تجدها في الجزء المتقدم من البطاقة.

الإعداد	الافتراضي	غيّره عندما
Check for a newer HolyArrs (البحث عن HolyArrs أحدث)	مفعّل	لا تريد أي طلب إلى الخارج إطلاقًا
Check for updates every (البحث عن تحديثات كل)	يوم	تريد فحوصًا أقل: 3 أو 7 أو 14 أو 30 يومًا
Release feed (خلاصة الإصدارات)	فارغ (إصدارات HolyArrs)	تستضيف خلاصتك الخاصة
Feed may be on the local network (قد تكون الخلاصة على الشبكة المحلية)	متوقف	خلاصتك على شبكتك الخاصة
Include test versions (like 1.2.0-rc1) (تضمين الإصدارات التجريبية، مثل 1.2.0-rc1)	متوقف	تريد إشعارات بالإصدارات التجريبية

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

العَرَض: “The last check did not work.” السبب: الخادم بلا اتصال بالإنترنت، أو خلاصتك الخاصة على الشبكة المحلية. الحل: تحقق من الاتصال بالإنترنت، أو فعّل Feed may be on the local network.

العَرَض: خلاصة الإصدارات لا تُحفظ. السبب: يحتوي العنوان على اسم أو كلمة مرور أو ?query أو #fragment، أو لا يبدأ بـ http:// أو https://. الحل: احذف تلك الأجزاء.

العَرَض: توقف التحديث لنقص المساحة على القرص. السبب: لا مكان للنسخة وللتحديث. الحل: أفرغ مساحة حيث يوجد مجلد config، ثم ابدأ من جديد.

العَرَض: صفحة الرجوع ترفض رمزك. السبب: رمز قديم، أو 10 رموز خاطئة منذ آخر تشغيل. الحل: انسخ الرمز من أحدث سطر في سجل التشغيل. بعد 10 محاولات خاطئة، أعد تشغيل الحاوية واستخدم الرمز الجديد.

الميزات المحجوبة

بعض الميزات متوقفة افتراضيًا في هذا الإصدار من التطبيق. فعّلها على مسؤوليتك. ما دامت محجوبة، تبقى صفحاتها وعناصرها في القائمة مخفية، وتجيب مسارات API الخاصة بها بـ “not found”، ولا تعمل مهامها. والبيانات التي حفظتها لها تبقى.

لتفعيل واحدة، أضف مفتاح تفعيلها إلى HOLYARRS_FLAGS، مفصولًا بفواصل، وأعد تشغيل الحاوية:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

احذف الاسم وأعد التشغيل لإيقافها. تعود الإعدادات المخفية حين تفعّلها من جديد.

مفتاح التفعيل	الميزة
`plex_watchlists`	قوائم المشاهدة في Plex تتحول إلى طلبات
`row_title_stats`	إحصاءات الأعمال في صفوف الاستكشاف ضمن المظهر
`trakt_lists`	مفتاح Trakt وقوائم Trakt ومراجعات Trakt. قوائم TMDB تبقى مفعّلة
`alert_channels_more`	تنبيهات Telegram وntfy وGotify وPushover وwebhook. Discord والبريد الإلكتروني يبقيان مفعّلين
`subtitle_sites`	مواقع الترجمات والبحث عن الترجمات. لغة ترجماتك تبقى مفعّلة
`emby_signin`	تسجيل الدخول بحساب Emby. تحديث مكتبة Emby يبقى يعمل
`go_back`	لوحة Go back (الرجوع) في صفحة Status. الخطوات في الرجوع تعمل من دونها

لم يتغير شيء بعد إضافة مفتاح تفعيل؟ تحقق من الكتابة (أحرف صغيرة وشرطات سفلية) وأعد تشغيل الحاوية، لا الصفحة وحدها.

للخبراء

ما يرسله الفحص

طلب واحد إلى api.github.com عن أحدث إصدار، ومعه User-Agent: HolyArrs/<version> وحده. لا حساب ولا مفتاح ولا قائمة وسائط. وإذا كان الفحص متوقفًا فلا طلب إطلاقًا.

يُحفظ آخر جواب، فلا تؤدي إعادة التشغيل إلى فحص قبل موعده. ينتظر الفحص الواحد 15 ثانية على الأكثر، ويقرأ 512 KB على الأكثر، ويتبع 3 تحويلات على الأكثر، ولا ينتقل أبدًا بين http وhttps. يظهر رابط ملاحظات الإصدار عندما يشير إلى صفحات إصدارات HolyArrs على GitHub لا غير؛ وإلا يظهر الإصدار نصًا عاديًا.

تقبل Release feed جوابَ إصدار بأسلوب GitHub، أو قائمة إصدارات، أو أي JSON فيه version، أو نصًا عاديًا يحمل رقم الإصدار. عناوين بيانات الخدمات السحابية (cloud metadata) تُرفض دائمًا. ويُعدّ الإصدار التجريبي أقدم من الإصدار العادي.

النسخة الاحتياطية قبل التحديث

قبل تغيير البيانات المخزّنة، يفعل HolyArrs الآتي:

يتحقق من وجود مكان للنسخة وللتحديث. إن لم يوجد، لا يتغير شيء. تخطَّ ذلك بـ HOLYARRS_SKIP_SPACE_CHECK=yes.
ينسخ كل قاعدة بيانات إلى backups، ويفحص النسخة ويكتب بجانبها ملف sha256. بعد 3 محاولات نسخ فاشلة، لا يتغير شيء.
يشغّل كل خطوة تحديث وحدها ويفحصها. الخطوة الفاشلة يتراجع عنها؛ والخطوات المنتهية تبقى. شغّل الإصدار نفسه من جديد لتكمل من الخطوة الفاشلة بالنسخة نفسها.

بعد أول تشغيل ناجح تصبح النسخة holyarrs-backup-pre-update-<time>.zip، بوصف مثل “before updating from 1.1.0 to 1.2.0”. تظهر في Settings > Backups (الإعدادات > النسخ الاحتياطية) وفي holyarrs restore --list. تُحفظ أحدث 3 منها؛ وجدول النسخ الاحتياطية لا يزيلها أبدًا. التثبيت الجديد أو التحديث الذي لا يمس البيانات لا يصنع أي نسخة.

صفحات ذات صلة

HolyArrs مجاني. إذا وفّر عليك وقتًا، امنحه نجمة على GitHub أو ادعمه ماليًا أو ادعُني إلى فنجان قهوة.