גיבויים

שמור עותק של ההגדרות שלך, כדי להחזיר אותו אחרי עדכון גרוע, דיסק שנשבר או מעבר למחשב חדש.

לפני שמתחילים

• 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 והנח אותו בתיקיית ההגדרות. לא הבעלים? בקש מהבעלים להוריד אותו.

לשחזר גיבוי

Danger

שינויים שנעשו מאז הגיבוי הולכים לאיבוד. הכן קודם את המפתח הראשי המתאים.

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 עובדת. זה עובד עם ווליום בעל שם או תיקיית host; HolyArrs מעביר את הקבצים ב-/config ל-PUID ול-PGID שלך כשהוא מופעל. אם אתה משתמש ב-HOLYARRS_MASTER_KEY_FILE, הנח את המפתח בנתיב הזה ב-host במקום, כך שה-PUID וה-PGID שלך יוכלו לקרוא אותו.
3. שחזר את הגיבוי. בחר דרך אחת:

   • הפעל את HolyArrs, סיים את ההפעלה הראשונה, ואז השתמש ב-Restore from a file ב-Settings > Backups.

   • או שחזר לפני ההפעלה הראשונה. הנח את קובץ ה-zip, בלי לשנות את שמו, בתיקייה בשם backups והעתק אותה פנימה עם docker cp backups holyarrs:/config/. אחר כך הרץ את השחזור פעם אחת עם אותו image:

     • 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 עם מסד הנתונים הראשי, מסד נתוני Events אם יש כזה, ו-backup.json (גרסת HolyArrs, גרסאות מסדי הנתונים, סוג הגיבוי, זמן היצירה). מדיה, הורדות, תמונות, לוגים והמפתח הראשי לא נמצאים בו.

שחזור לפני ההפעלה הראשונה

docker cp עובד עם ווליום בעל שם או תיקיית host; HolyArrs מעביר את הקבצים ב-/config ל-PUID ול-PGID שלך כשהוא מופעל. עם HOLYARRS_MASTER_KEY_FILE, הנח את המפתח בנתיב הזה ב-host במקום, כך ש-PUID ו-PGID יוכלו לקרוא אותו.

1. הנח את קובץ ה-zip, בלי לשנות את שמו, בתיקייה בשם backups והעתק אותה פנימה: docker cp backups holyarrs:/config/.
2. הרץ את השחזור פעם אחת עם אותו image:
   • 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 מציג את שמות הגיבויים שהוא רואה.

קשור

• עדכונים
• התקנה
• בדיקות תקינות