النسخ الاحتياطية

احتفظ بنسخة من إعدادك لتعيدها بعد تحديث سيئ أو قرص تالف أو انتقال إلى جهاز جديد.

قبل أن تبدأ

• تحتاج صفحة Settings > Backups (الإعدادات > النسخ الاحتياطية) إلى الإذن Change settings (تغيير الإعدادات). والاستعادة للمالك وحده.
• يحتاج التنزيل والحذف والاستعادة إلى تسجيل دخول بكلمة المرور خلال الدقائق القليلة الماضية.

إنشاء نسخة احتياطية

1. افتح Settings > Backups.
2. اختر Back up now (انسخ احتياطيًا الآن). سترى النسخة الاحتياطية الجديدة تحت Saved backups (النسخ الاحتياطية المحفوظة).
3. اختر Download (تنزيل) بجانبها لتحتفظ بنسخة خارج الخادم.

حفظ المفتاح الرئيسي

لا تحتوي النسخ الاحتياطية على المفتاح الرئيسي أبدًا، وهو الذي يفتح كلمات المرور ومفاتيح API في إعداداتك. ومن دون المفتاح المطابق لا تستطيع النسخة الاحتياطية المستعادة قراءتها.

1. تحت Master key (المفتاح الرئيسي)، يختار المالك Download key kit (تنزيل عُدّة المفتاح).
2. احفظ الملف بعيدًا عن الخادم وبمعزل عن نسخك الاحتياطية. سترى تحذير عُدّة المفتاح يختفي من Settings > Backups ومن فحوص السلامة.

لاستعماله لاحقًا، غيّر اسمه إلى holyarrs.key وضعه في مجلد الإعدادات. لست المالك؟ اطلب من المالك أن ينزّله.

استعادة نسخة احتياطية

تحذير

تضيع التغييرات التي جرت بعد النسخة الاحتياطية. جهّز المفتاح الرئيسي المطابق أولًا.

1. اختر Restore from a file (استعادة من ملف) وحدّد ملف zip لنسخة احتياطية من HolyArrs.
2. أكّد.
3. يفحص HolyArrs الملف. سترى Restore ready. It applies on the next start. (الاستعادة جاهزة. تُطبَّق عند التشغيل التالي.)
4. يعيد HolyArrs التشغيل ويضع النسخة الاحتياطية في مكانها. مع سياسة إعادة التشغيل الموصى بها في Docker يحدث ذلك تلقائيًا.

تنتقل قواعد بياناتك الحالية إلى /config/backups/before-restore-<time>، فيمكنك التراجع عن الاستعادة.

الخيارات

كم مرة

الخيار	ينسخ احتياطيًا	يحتفظ بـ
Balanced (متوازن، وهو الافتراضي)	كل يوم	آخر 7 أيام و4 نسخ أسبوعية
Light (خفيف)	مرة في الأسبوع	4 أسابيع. أقل مساحة
Careful (حذر)	كل يوم	كل نسخة لمدة 30 يومًا

تبقى أحدث نسخة احتياطية مجدولة محفوظة دائمًا. تنظّف هذه القواعد النسخ الاحتياطية المجدولة فقط. أما النسخ الاحتياطية التي تنشئها أنت فتبقى حتى تحذفها (زر سلة المهملات في الصف؛ ولا يمكن التراجع عن ذلك). وينشئ HolyArrs كذلك نسخة احتياطية قبل كل تحديث يغيّر البيانات المخزّنة ويحتفظ بأحدث 3 منها؛ انظر التحديثات.

الانتقال إلى جهاز جديد

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

1. قبل التشغيل الأول، أنشئ الحاوية من دون تشغيلها: docker compose create، أو سطر docker run الذي تستعمله مع docker create بدلًا من docker run -d.
2. انسخ مفتاحك القديم إلى الداخل: docker cp holyarrs.key holyarrs:/config/. وتصلح كذلك عُدّة مفتاح غُيّر اسمها إلى holyarrs.key. ينجح هذا مع وحدة تخزين مسمّاة أو مجلد على الجهاز المضيف؛ يسلّم HolyArrs الملفات في /config إلى PUID وPGID عندك حين يبدأ. إذا كنت تستعمل HOLYARRS_MASTER_KEY_FILE، فضع المفتاح في ذلك المسار على الجهاز المضيف بدلًا من ذلك، وبحيث يستطيع PUID وPGID عندك قراءته.
3. استعد النسخة الاحتياطية. اختر إحدى الطريقتين:

   • شغّل HolyArrs، وأكمل التشغيل الأول، ثم استعمل Restore from a file في Settings > Backups.

   • أو استعد قبل التشغيل الأول. ضع ملف zip، من دون تغيير اسمه، في مجلد اسمه backups وانسخه إلى الداخل بالأمر docker cp backups holyarrs:/config/. ثم نفّذ الاستعادة مرة واحدة بالصورة نفسها:

     • Compose: docker compose run --rm holyarrs restore <zip name>
     • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>

     مع مسار لملف المفتاح، أضف -e HOLYARRS_MASTER_KEY_FILE=<its path> لتتحقق الاستعادة بمفتاحك. ويعرض restore --list أسماء النسخ الاحتياطية التي يراها.

4. شغّل HolyArrs. سترى مكتبتك وإعداداتك وقد عادت.

شغّلت التثبيت الجديد قبل نسخ المفتاح؟ إذا لم يكن فيه ما يستحق الاحتفاظ به، فأوقف HolyArrs، وانسخ مفتاحك القديم فوق الجديد بالأمر docker cp نفسه، واستعد النسخة، ثم شغّله.

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

العَرَض: “Backups are off in this build” (النسخ الاحتياطية معطّلة في هذه النسخة من البرنامج). السبب: هذه النسخة تعمل من دون مدير النسخ الاحتياطية. الحل: لا حل داخل التطبيق؛ لا توجد عناصر تحكم للنسخ الاحتياطية.

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

العَرَض: تُرفض الاستعادة بسبب المفتاح الرئيسي. السبب: المفتاح الموجود في مجلد الإعدادات لا يطابق النسخة الاحتياطية. الحل: أعد ملف holyarrs.key المطابق إلى مكانه وحاول مرة أخرى.

ترفض الاستعادة كذلك ملف zip إذا كان أكبر من اللازم أو تالفًا، أو فيه ملفات غير متوقعة، أو جاء من إصدار أحدث لقاعدة البيانات، أو فيه بيانات لا يستطيع مفتاحك قراءتها.

للخبراء

ما الذي تحتويه النسخة الاحتياطية

كل نسخة احتياطية ملف zip فيه قاعدة البيانات الرئيسية، وقاعدة بيانات الأحداث إن وُجدت، وملف backup.json (إصدار HolyArrs، وإصدارات قواعد البيانات، ونوع النسخة الاحتياطية، ووقت إنشائها). الوسائط والتنزيلات والصور الفنية وسجلات التشغيل والمفتاح الرئيسي ليست فيها.

الاستعادة قبل التشغيل الأول

ينجح docker cp مع وحدة تخزين مسمّاة أو مجلد على الجهاز المضيف؛ يسلّم HolyArrs الملفات في /config إلى PUID وPGID عندك حين يبدأ. مع HOLYARRS_MASTER_KEY_FILE، ضع المفتاح في ذلك المسار على الجهاز المضيف بدلًا من ذلك، وبحيث يستطيع PUID وPGID قراءته.

1. ضع ملف zip، من دون تغيير اسمه، في مجلد اسمه backups وانسخه إلى الداخل: docker cp backups holyarrs:/config/.
2. نفّذ الاستعادة مرة واحدة بالصورة نفسها:
   • Compose: docker compose run --rm holyarrs restore <zip name>
   • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>
3. مع مسار لملف المفتاح، أضف -e HOLYARRS_MASTER_KEY_FILE=<its path> لتتحقق الاستعادة بمفتاحك.
4. شغّل HolyArrs.

يعرض restore --list أسماء النسخ الاحتياطية التي يراها.

صفحات ذات صلة

• التحديثات
• التثبيت
• فحوص السلامة