بکاپ‌ها

یک کپی از راه‌اندازی‌تان نگه دارید تا پس از یک به‌روزرسانی بد، خراب‌شدن دیسک یا رفتن به رایانهٔ جدید آن را برگردانید.

پیش از شروع

• 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 (بازیابی از فایل) را انتخاب کنید و یک زیپ بکاپ 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 استفاده کنید.

   • یا پیش از اولین راه‌اندازی بازیابی کنید. زیپ را بدون تغییر نام در پوشه‌ای به نام 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 مطابق را سر جایش بگذارید و دوباره امتحان کنید.

بازیابی زیپی را هم که زیادی بزرگ یا خراب است، فایل‌های غیرمنتظره دارد، از نسخهٔ جدیدتر پایگاه داده آمده یا داده‌ای دارد که کلید شما نمی‌تواند بخواند، رد می‌کند.

برای حرفه‌ای‌ها

داخل یک بکاپ چیست

هر بکاپ یک زیپ است با پایگاه دادهٔ اصلی، پایگاه دادهٔ Events در صورت وجود، و backup.json (نسخهٔ HolyArrs، نسخهٔ پایگاه‌های داده، نوع بکاپ، زمان ساخت). رسانه، دانلودها، تصاویر، لاگ‌ها و کلید اصلی داخلش نیستند.

بازیابی پیش از اولین راه‌اندازی

docker cp برای ولوم نام‌دار یا پوشهٔ میزبان کار می‌کند؛ HolyArrs هنگام شروع فایل‌های /config را به PUID و PGID شما می‌سپارد. با HOLYARRS_MASTER_KEY_FILE، کلید را به‌جایش در همان مسیر روی میزبان بگذارید، طوری که PUID و PGID بتوانند آن را بخوانند.

1. زیپ را بدون تغییر نام در پوشه‌ای به نام 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 نام بکاپ‌هایی را که می‌بیند نشان می‌دهد.

صفحه‌های مرتبط

• به‌روزرسانی‌ها
• نصب
• بررسی‌های سلامت