לדלג לתוכן

הגדרות

הדף הזה מכסה את משתני הסביבה של הקונטיינר, את העיגונים שהתבנית מספקת, את מודל האבטחה, גיבוי VM דרך SSH ואת ההגדרה מחוץ לאתר. לאן הגיבויים הולכים מוגדר בתוך האפליקציה כיעדים, לא דרך משתני סביבה.

משתני סביבה

משתנה נדרש תיאור
APP_KEY כן סוד הקסדצימלי של 32 בייטים (64 תווים הקסדצימליים) שמשמש לגזירת סיסמת מאגר ה-restic. יוצרים עם openssl rand -hex 32. שומרים אותו בטוח: איבודו הופך גיבויים מוצפנים לבלתי ניתנים לשחזור.
LIBVIRT_HOST למכונות וירטואליות ולמערכי נתונים של ZFS מארח Unraid שמגיעים אליו דרך SSH לגיבויי VM ומערכי נתונים של ZFS (שדה התבנית Host SSH: Address, ברירת מחדל host.docker.internal). התבנית ממלאת מראש את הערך המציין 192.168.x.x, שנחשב לא מוגדר. משתמשים בכתובת ה-IP של Unraid ב-LAN, חובה ברשת מותאמת br0.x. כש-host.docker.internal לא נפתר, כמו באפליקציית TrueNAS, ו-LIBVIRT_URI גם לא מציין מארח, BombVault משתמשת בשער ברירת המחדל של הקונטיינר ויומן ההפעלה מציין אותו.
LIBVIRT_SSH_PORT לא פורט ה-SSH של המארח לגיבויי VM ומערכי נתונים של ZFS (שדה התבנית Host SSH: Port, ברירת מחדל 22).
LIBVIRT_SSH_USER לא משתמש SSH במארח לגיבויי VM ומערכי נתונים של ZFS (שדה התבנית Host SSH: User, ברירת מחדל root).
LIBVIRT_URI לא כתובת חיבור מלאה ל-libvirt, שמשמשת כלשונה במקום לבנות אחת משלושת משתני ה-LIBVIRT_* שלמעלה (שאז מתעלמים מהם למחרוזת החיבור). ברירת מחדל לא מוגדר. נחוץ ב-TrueNAS Scale, שה-libvirtd שלו מאזין על שקע לא סטנדרטי שצורת המחרוזת הבנויה לא יכולה לבטא: qemu+ssh://<user>@<truenas-host>/system?socket=/run/truenas_libvirt/libvirt-sock. ראו מדריך גיבוי VM. כשזו כתובת qemu+ssh://, כל אחד מ-LIBVIRT_HOST, ‏LIBVIRT_SSH_USER ו-LIBVIRT_SSH_PORT שאינו מוגדר נלקח ממנה, גם לפקודות ה-SSH של BombVault עצמה (העברת NVRAM, מערכי נתונים של ZFS).
PORT לא פורט HTTP (ברירת מחדל 3000. משמש רק עם HTTP_ONLY=true).
HTTPS_PORT לא פורט HTTPS (ברירת מחדל 3443. התבנית מפרסמת אותו 1:1, ולכן ממשק הרשת עונה ב-https://<ip>:3443).
HTTP_ONLY לא קובעים true כדי לכבות את מאזין ה-HTTPS החתום בעצמו ולהגיש HTTP רגיל בלבד (לשימוש מאחורי proxy הפוך שמסיים TLS).
BIND_HOST לא הכתובת שבה ממשק הרשת מאזין (ברירת מחדל 0.0.0.0, כל ממשק). משאירים לא מוגדר בקונטיינר, שהפורטים המפורסמים שלו צריכים כל ממשק. 127.0.0.1 מתאים להרצה מחוץ ל-Docker. בדיקת התקינות שואלת את אותה כתובת.
TRUSTED_PROXY לא כתובות או טווחי CIDR מופרדים בפסיקים של ה-proxy ההפוך שלפני BombVault (למשל 192.168.20.11 או 10.0.0.0/8). רק מהקפיצות האלה מאמינים ל-X-Forwarded-For, ומגבלת ההתחברות סופרת אז כשלונות לכל לקוח אמיתי במקום להכניס את כל מי שמאחורי ה-proxy לסל אחד. לא מוגדר (ברירת המחדל) לא סומך על אף אחד: כותרת שמאמינים לה ללא תנאי הייתה נותנת לכל קורא לבחור סל משלו.
HOST_SOURCE_ROOT לא נתיב המארח שמעוגן כ-Host Data (ברירת מחדל /mnt). BombVault מתרגמת את מקורות ה-bind-mount ש-Docker מדווח לנתיבים תחת העיגון הזה. משנים רק אם עיגנת שורש מארח אחר.
HOST_MOUNT_ROOT לא היכן Host Data מעוגן בתוך הקונטיינר (ברירת מחדל /host/user). ב-TrueNAS Host Data מעוגן בנתיב המארח שלו עצמו, ולכן זה ו-HOST_SOURCE_ROOT שניהם מציינים את הנתיב הזה, למשל /mnt/tank (ראו TrueNAS SCALE).
DATA_ROOT_SEGMENTS לא שמות מקטעי נתיב מופרדים בפסיקים שמסמנים מקור bind-mount כנתוני גיבוי (ברירת מחדל appdata, בהתאם למוסכמת /mnt/user/appdata/<container> של Unraid). bind-mount של קונטיינר נבחר אוטומטית לגיבוי כשאחד המקטעים הרשומים מופיע כמקטע נתיב שלם במקור המארח שלו. למשל DATA_ROOT_SEGMENTS=appdata,config תופס גם bind של .../config. ההתאמה מתעלמת מרישיות, ולכן ברירת המחדל מכסה גם את /DATA/AppData/<container> של ZimaOS. ראו זיהוי מקורות הגיבוי לדרכים האחרות, הפועלות תמיד, שבהן נמצאת תיקיית הנתונים של קונטיינר.
PLATFORM לא כופה על איזו פלטפורמה BombVault מתייחסת לעצמה כרצה, במקום זיהוי אוטומטי: unraid, ‏generic או truenas (ברירת מחדל לא מוגדר: מזהה את Unraid בבדיקת הסימון dockerMan שלו תחת עיגון ה-flash, אחרת generic. ערך לא מוכר גם חוזר ל-generic, ונרשם ביומן). קובעים אותו במפורש במארח Docker כללי או ב-TrueNAS Scale במקום להסתמך על הבדיקה האוטומטית של Unraid בלבד. קובץ ה-compose הכללי עושה זאת. משנה את מוסכמת ה-appdata החלופית, את ברירות המחדל ליעדי שחזור בין מופעים, ואם צעדי ההתראה והתוסף הנלווה של Unraid בלבד מנוסים בכלל (ראו internal/platform).
BOMBVAULT_SELF_CONTAINER לא שם הקונטיינר של BombVault עצמה, כדי שלעולם לא תגבה (ולכן תעצור) את עצמה.
BACKUP_MAX_HOURS לא מקסימום שעות שעון קיר שריצת גיבוי אחת יכולה להחזיק את נעילת התחום שלה לפני שהיא מבוטלת בכוח (שומר כדי שריצה תקועה לא תחסום את התחום לנצח). ריק (ברירת המחדל) משתמש ב-48. מעלים אותו לגיבויי ענן גדולים או איטיים מאוד (ריצה שבוטלה בתקרה נכשלת עם context deadline exceeded). קובעים 0 כדי לבטל את התקרה לגמרי. גיזום כפוף לאותה תקרה, ובדיקה או גיזום רצים כל עוד restic ממשיך לדווח על התקדמות.
BACKUP_STALL_HOURS לא שעות שגיבוי יכול לא להתקדם בכלל לפני שהוא מבוטל. ריק (ברירת המחדל) משתמש ב-2. קובעים 0 כדי לא לבטל לעולם בגלל קיפאון. זה השומר העדין מבין השניים והוא בדרך כלל זה שמופעל: הוא עוקב אחרי אם משהו עדיין קורה ולא אחרי כמה זמן הריצה לקחה, ולכן גיבוי איטי אבל בריא של כמה טרה-בייט נשאר בשקט בזמן שגיבוי שנתקע על שיתוף שלא מגיב נעצר בשעות במקום בימים. אזהרה נרשמת אחרי 30 דקות של שקט, לפני שמשהו מבוטל. סריקה נחשבת התקדמות: restic לא כותב בייטים בזמן שהוא עובר על עץ גדול, והשלב הזה נצפה דרך סך הקבצים והבייטים שלו ולא דרך הבייטים שנכתבו. שני המשתנים בלתי תלויים, ו-BACKUP_MAX_HOURS עדיין תוחם את השלבים אחרי הגיבוי עצמו (שמירה, סטטיסטיקה, העתקה מחוץ לאתר), שבהם אין מונים לצפות בהם.
DB_DUMP_MAX_HOURS לא שעות שדאמפ אוטומטי אחד של מסד נתונים יכול לרוץ לפני שהוא נעצר. ריק (ברירת המחדל) משתמש ב-6. ערכים מותרים הם 1 עד 48, והמגבלה נשמרת שעה מתחת ל-BACKUP_MAX_HOURS (בחצי ממנו כשהוא מתחת לשעתיים), כך שדאמפ ארוך נחתך במגבלה שלו ומדווח ככזה ולא מפיל איתו את הגיבוי. דאמפ שלא מתקדם נעצר מוקדם יותר, אחרי BACKUP_STALL_HOURS. דאמפ שנעצר נכשל בעצמו וגיבוי הקונטיינר ממשיך. ב-Unraid מוסיפים אותו לקונטיינר BombVault עם Add another Path, Port, Variable.
TZ לא אזור זמן למתזמן (למשל Europe/Berlin). משאירים לא מוגדר וכל לוח זמנים רץ ב-UTC: אחד שנקבע ל-02:30 יופעל אז ב-02:30 UTC ולא לפי שעון הקיר שלך. ב-Unraid אף פעם לא קובעים את זה בעצמך: המערכת מעבירה את אזור הזמן שלה לכל קונטיינר. יומן ההפעלה אומר לאיזה אזור זה נפתר. אזור עם שעון קיץ מדלג על ריצה אחת באביב ומריץ אחת פעמיים בסתיו, ואילו UTC לא עושה אף אחד מהם אבל סוטה בשעה מול השעון שלך פעמיים בשנה.
DATA_DIR לא היכן BombVault שומרת את מסד הנתונים, המפתחות והמטמונים שלה (ברירת מחדל /config). משאירים כמו שזה בקונטיינר. זה חשוב כשמריצים את הקובץ מחוץ ל-Docker.
FLASH_DIR, FLASH_TEMPLATES_DIR לא היכן כונן ה-flash ותבניות ה-Docker שלו מעוגנים בתוך הקונטיינר (ברירות מחדל /host/boot ו-/host/boot/config/plugins/dockerMan/templates-user). הם עוקבים אחרי עיגון /boot של התבנית, ולכן משאירים אותם לא מוגדרים.
MODE לא full (ברירת המחדל) מריץ את כל האפליקציה. node מריץ צומת: בלי ממשק רשת ובלי לוחות זמנים משלו, רק מה שמופע הבית שלו אומר לו. כל ערך אחר עוצר את ההפעלה עם הודעה. מופע הבית ממלא אותו בשבילך בקובץ ה-compose של הצומת.
NODE_HOME בצומת לאיזה מופע בית הצומת שייך, עם המפתח והממסר של מופע הבית, כערך אחד שמתחיל ב-bvhome1.. מופע הבית כותב אותו לקובץ ה-compose של הצומת. בלעדיו הצומת עולה, אבל שום מופע בית לא מגיע אליו. צומת שמופע בית מסוים קיבל מסרב לעלות כש-NODE_HOME מציין מופע בית אחר, עד שמופע הבית ההוא משחרר אותו.
NODE_NAME לא השם של הצומת, כפי שמופע הבית מילא אותו מהשם שנתת לו.

עיגונים

מעגנים את שקע Docker, את ה-flash (/boot) ואת שורש Host Data (/mnt) כפי שמוצג בתבנית CA. מקורות ויעדים של גיבוי נמצאים שניהם תחת Host Data, והוא מעוגן slave כך ששיתוף מרוחק שמתעגן אחרי שהקונטיינר התחיל (למשל תחת /mnt/remotes) נעשה גלוי בלי הפעלה מחדש.

ב-TrueNAS, Host Data הוא נתיב של מערך נתונים כמו /mnt/tank, אף פעם לא ixVolume. נתונים שאפליקציה שומרת ב-ixVolume נמצאים מחוצה לו ואינם מגובים. ראו TrueNAS SCALE.

גם גיבויי מערכי נתונים של ZFS צריכים את המצב הזה: המארח מעגן את התצלום של מערך נתונים רק אחרי שהקונטיינר התחיל. ראו מערכי נתונים של ZFS.

מאגרים מקומיים הם כברירת מחדל /mnt/user/bombvault/{container,vms,flash,config,files,zfs}, שנוצרים בגיבוי הראשון. אלה התיקיות העצמיות של התחומים והן יוצרות את היעד מקומי. בדף שלו תחת יעדים, הכרטיס חיבור משנה את התיקייה של כל תחום.

התיקייה העצמית של תחום יכולה גם לחיות ביעד שכבר יש לך, כמו NAS או דלי S3: שימוש כתיקייה עצמית בדף של אותו יעד מעבירה אותה לשם ואומרת קודם מה קורה לגיבויים שכבר נעשו. ראו התיקייה העצמית של תחום.

תיקיות המאגר המקומי נשארות בהרשאות 0755 ו-0644, כך שמשתמש סנכרון שאינו root דרך SMB לא ננעל בחוץ, והמאגרים מוצפנים, ולכן זה לא חושף כלום. הגדרות השחזור חיות בתוך כל מאגר, ולכן תיקייה שהועתקה שלמה בפני עצמה. מאגר הגיבוי העצמי נשאר קריא ל-root בלבד.

בדיקת שילוב מארח

הכרטיס שילוב מארח בסקירה (מוסיפים אותו תחת התאמה אישית) בודק כל עיגון וכל CLI (שקע Docker,‏ libvirt,‏ restic,‏ qemu-img,‏ rclone) ומדווח על חלקים חסרים.

זיהוי מקורות הגיבוי

לכל קונטיינר BombVault בוחרת אוטומטית אילו bind-mounts ו-volumes בעלי שם לגבות. נתיב נתפס כשאחד מהבאים חל (תמיד אפשר לעקוף את התוצאה בכרטיס תיקיות לגיבוי בלשונית ההגדרות של הקונטיינר):

  • התאמת מקטע שורש נתונים: מקור המארח של ה-bind מכיל אחד ממקטעי DATA_ROOT_SEGMENTS כרכיב נתיב שלם (ברירת מחדל appdata בלבד).
  • volumes בעלי שם של Docker כלולים תמיד, כי אין להם מקבילה זמנית ואין מה לסנן, אבל רק כשנתיב האחסון האמיתי של ה-volume במארח עצמו נגיש דרך עיגון Host Data, בדיוק כמו כל נתיב מארח אחר ש-BombVault מגבה. מנהל ה-volumes המקומי ברירת המחדל של Docker שומר volume תחת שורש הנתונים של ה-daemon עצמו (/var/lib/docker/volumes/<name>/_data אלא אם שינית. בודקים עם docker info -f '{{.DockerRootDir}}'), שאינו מכוסה על ידי עיגון Host Data הצר והחד-תיקייתי ש-docker-compose.yml הכללי משתמש בו כברירת מחדל. volume שלא ניתן להגיע אליו מדולג בשקט, לא כשגיאה. כדי לגבות בפועל volumes בעלי שם במארח כללי, מכוונים את Host Data (ואת HOST_SOURCE_ROOT) לאב קדמון משותף שמכסה גם את שורש הנתונים של Docker. ההערה של Host Data בקובץ ה-compose מסבירה את הפשרה (Unraid עוקף זאת בעיגון כל /mnt, מוסכמת הרמה העליונה האוניברסלית שלו, מאותה סיבה).
  • ספריית פרויקט Docker Compose: אם לקונטיינר יש את התווית הסטנדרטית com.docker.compose.project.working_dir (נקבעת אוטומטית על ידי docker compose up), גם הספרייה הזו נוספת, בלי קשר אם איזה bind התאים למקטע שורש נתונים.
  • עקיפה בתווית bombvault.data: קובעים את התווית bombvault.data=true על קונטיינר כדי לכלול את כל ה-bind-mounts שלו, לפריסה ששום מוסכמה מלמעלה לא תופסת (למשל bind יחיד של /srv/plex/config בלי פרויקט Compose). כל ערך לא ריק פרט ל-false נחשב אמת. תווית חסרה או bombvault.data=false לא משנים כלום.
  • התווית bombvault.dbdump: קובעים bombvault.dbdump=false על קונטיינר כדי לכבות את הדאמפ האוטומטי של מסד הנתונים שלו (0, ‏no ו-off עושים אותו דבר), או נותנים שם למנוע (postgres, ‏mysql, ‏mariadb) כדי לעשות דאמפ לקונטיינר ש-BombVault לא מזהה בעצמה. התווית גוברת על המתג בכרטיס מסד נתונים בלשונית ההגדרות של הקונטיינר, שהוא הדרך לעשות זאת ב-Unraid.

מודל האבטחה

שליטה בהיקף root על המארח

דרך שקע Docker BombVault יכולה לעצור, להסיר וליצור מחדש קונטיינרים ולקרוא ולכתוב appdata, ולגיבוי VM היא נכנסת למארח דרך SSH (qemu+ssh://, ברירת מחדל root) כדי להריץ virsh. כל מי שיכול להגיע לממשק הרשת שלה למעשה מחזיק ב-root במארח.

התחברות

  • הגנת סיסמה אופציונלית (הכרטיס סיסמה תחת הגדרות, אבטחה): קובעים סיסמה כדי לדרוש התחברות, מנקים אותה כדי לכבות. כבויה כברירת מחדל לשימוש ב-LAN מהימן. הסיסמה נשמרת עם Argon2id מעל pepper שמפתחו APP_KEY, ולכן /config שהועתק חסר ערך בלי המפתח ואיטי לתקיפה איתו. סיסמה חדשה צריכה לפחות 12 תווים. סיסמה קיימת קצרה יותר ממשיכה לעבוד עד שמשנים אותה. הפעלות חתומות (HMAC שנגזר מ-APP_KEY) ושינוי הסיסמה מבטל אותן. ההתחברויות מוגבלות לחמישה כשלונות בדקה לכל לקוח. שינוי או ניקוי הסיסמה מבקשים את הסיסמה הנוכחית ו, כשאימות דו-שלבי פועל, את הקוד.
  • דברים מסוימים צריכים סיסמה. הורדת ערכת השחזור, דיווח הבאג וה-ZIP של גיבוי flash, ייצוא של גיבוי flash או גיבוי עצמי, הפקדת המפתח אצל שומר מפתח, אישור מסירת פיקדון, יצירת קוד פתיחה חדש, ייצוא הגדרות עם פרטי גישה, אימות דו-שלבי, מפתחות גישה, הוספת צומת, הצגה חוזרת של קובץ ה-compose של צומת ופתיחת הפריטים של צומת נדחים עד שמוגדרת סיסמת התחברות, והם צריכים כניסה במופע עצמו. מחיקת גיבויים עובדת גם בלי סיסמה. כשמוגדרת סיסמה, גם היא צריכה את הכניסה הזו.
  • יעד לא מציג סיסמה. יעד יכול להכיל פרטי גישה, כמו ב-rest:https://user:password@host/repo, וכל דף וכל תשובת API מציגים אותו כ-rest:https://[redacted]@host/repo, עם או בלי סיסמת התחברות. כשמשנים את הנתיב שמאחוריו, הסיסמה השמורה נשארת. כדי לכוון את היעד לשרת אחר, מקלידים את היעד כולו עם הסיסמה שלו, כי סיסמה מוסתרת נשארת עם השרת שלה.
  • אימות דו-שלבי (הגדרות, אבטחה): קוד זמן מאפליקציית אימות בנוסף לסיסמה, ועוד שמונה קודי שחזור חד-פעמיים שניתנים פעם אחת כשמפעילים אותו. הסוד המשותף נשמר מוצפן עם APP_KEY, וכיבוי הגורם שוב דורש קוד נוכחי.
  • מפתחות גישה (WebAuthn) יושבים בכרטיס משלהם ברגע שמוגדרת סיסמה, לצד הסיסמה ולעולם לא במקומה, ולכן הסרת כל מפתחות הגישה לא נועלת אף אחד בחוץ. הם צריכים שם דומיין אמיתי ותעודה שהדפדפן סומך עליה. ברירת המחדל https://<ip>:3443 היא בדיוק מה ש-WebAuthn דוחה, והכרטיס אומר זאת במקום להציע כפתור שנכשל. כשאימות דו-שלבי פועל, מפתח גישה צריך לבדוק את ה-PIN, טביעת האצבע או הפנים שלך, אחרת הכניסה מבקשת גם את הקוד.
  • שחזור הגדרות (שחזור ההגדרות באשף החירום) מסיים כל הפעלה, מסיר כל מפתח גישה ומבטל כל אסימון API ומפתח MCP, כי ההגדרות ששוחזרו יכולות להחזיר כאלה שהוסרו אחרי ששמרו אותן. נכנסים עם הסיסמה ומגדירים את מפתחות הגישה שוב תחת הגדרות, אבטחה.
  • סיסמה שנשכחה מאופסת בדף ההתחברות. שכחת את הסיסמה? גורם ל-BombVault לכתוב קוד של 12 תווים, בשלוש קבוצות של ארבעה, ליומן הקונטיינר שלה (ב-Unraid: לשונית Docker, סמל BombVault, יומנים). הקוד הזה וסיסמה חדשה מכניסים אותך. האיפוס גם מכבה אימות דו-שלבי, מסיר כל מפתח גישה, מבטל כל אסימון API, מפתח MCP וכניסת OAuth, מסיים כל הפעלה אחרת, מנתק כל טלפון מצומד ומכבה צימוד טלפונים. הדף מפרט אחר כך מה הלך. קוד תקף 10 דקות, ושגיאות ניחוש לא מכלות אותו. אסימוני וידג'ט ו-metrics נשארים, כי הם רק קוראים.
  • מי שיכול לקרוא את יומן הקונטיינר יכול לאפס את הסיסמה. זה root במארח, אבל גם מציג יומנים כמו Dozzle, כל קונטיינר שקיבל את שקע Docker (קריאה בלבד מספיקה) ומשגר יומנים שמעביר פלט קונטיינרים. נותנים אותם רק לאנשים שהיית סומך עליהם עם הסיסמה. מי שמגיע רק לממשק הרשת אף פעם לא רואה את הקוד.

טלפונים וחברי קבוצה

  • טלפונים מצומדים מגיעים לרשימה מותרת. טלפון שמכיר את שתים עשרה המילים של הקבוצה נכנס בלי הסיסמה, כל עוד אפשר לצמד טלפונים עם שתים עשרה המילים של הקבוצה מופעל בכרטיס אפליקציית Android תחת הגדרות, אבטחה. ההפעלה שלו מגיעה רק למה שהאפליקציה מציגה: הסקירה, הריצות, הגיבויים לעיון, להתחלה ולשחזור, החריגות לקריאה ודף המופעים לעיון. יעדים ופקודות מגיעים אליו בלי הכתובות והסודות שלהם, ושחזור שמחליף את המקור מגבה קודם את המצב הנוכחי. שחזור לתיקייה מקבל רק תיקייה חדשה או ריקה בתוך תיקיית השחזור, וטלפון לא יכול להציץ לשום תיקייה אחרת. כל השאר עונה שנדרשת כניסה במופע עצמו: מפתחות, ערכת השחזור, פיקדונות מפתח, הגדרות, מחיקת גיבויים. איפוס סיסמה מכבה צימוד טלפונים עד שמפעילים אותו שוב. טלפון שהוסר מדף המופעים, או שתשאול מופע זה כבוי בפרטים שלו, מאבד את ההפעלה שלו מיד, וטלפון שהוסר ופותח שוב את האפליקציה שלו חוזר כבוי.
  • הרחק מהבית טלפון פותח דפים דרך הממסר. כל בקשה של הדף אטומה עם מפתח הקבוצה, שהממסר לא יכול לקרוא או לשנות, וחתומה במפתח של הטלפון עצמו, שהשרת נועץ בקריאה הראשונה של הטלפון ומכניס ברגע שמישהו מאשר את הטלפון בדף הצימוד. השרת מריץ בקשה פעם אחת ורק כל עוד היא טרייה. הוא עונה רק לטלפון שמופיע בדף המופעים כשצימוד טלפונים פועל, ורק עם הפעלה שנתן לאותו טלפון, ולכן התנתקות מכל מקום ואיפוס סיסמה מסיימים גם את הדפים האלה. השרת חותם כל תשובה, והאפליקציה בודקת את החתימה מול המפתח שנעצה לאותו שרת ומזהירה כשהמפתח משתנה. דף כזה מגיע לאותה רשימה מותרת כמו טלפון מצומד, עם או בלי סיסמת התחברות, ועוד מצב ההתחברות שהדף קורא קודם. כניסה ויציאה, איפוס הסיסמה והורדות נשארים בכתובת של השרת עצמו, ותשובה אחת מוגבלת ל-16 MB.
  • חברים חותמים על מה שהם מבקשים. בקשות תפקיד ותשובותיהן, הצעות אחסון, מסירת סיסמת restic למקלט או למושך, כניסות מקלט ופיקדוני מפתח חתומים במפתח של כל חבר, שמופע נועץ בפעם הראשונה שהוא רואה את אותו חבר. קריאה שנחתמה במפתח אחר נדחית. שכחת מפתח בפרטים של מופע מסירה את המפתח הנעוץ, למקרה שהמפתח שידוע כאן אינו של החבר עצמו. החבר נשאל שוב על המפתח שלו בקריאה החתומה הבאה שלו. חברים ב-BombVault 9.x לא חותמים וניתן להתחזות אליהם על ידי כל מי שיש לו את המילים, כמו ב-9.9. בקשת תפקיד או הצעת אחסון מחבר שרץ על 10.4 או גרסה ישנה יותר נדחית עד שהחבר הזה מתעדכן.
  • שתים עשרה המילים הן סיסמה. כל מי שיש לו אותן מצטרף לקבוצה, רואה את מצב ההגנה של החברים ויכול לבקש תפקידים, שאדם במופע האחר עדיין צריך לאשר. בלי סיסמת התחברות כל מי שיכול לפתוח את ממשק הרשת יכול לקרוא אותן, וכרטיס הצימוד אומר זאת עד שמוגדרת סיסמה.

מפתחות

  • APP_KEY עושה שני דברים. הוא אוטם מה שההתקנה הזו שומרת (סיסמאות, פרטי גישה, אסימונים) והוא המפתח של הגיבויים: סיסמת ה-restic נגזרת ממנו, והגדרות קונטיינרים ומכונות וירטואליות אטומות איתו.
  • מפתח שהשתלטו עליו נשמר בנפרד. כשאשף החירום משתלט על הגיבויים של שרת אחר, ההתקנה הזו ממשיכה לאטום עם ה-APP_KEY שלה ושומרת את המפתח של השרת האחר כמפתח הגיבוי שלה, אטום כמו כל סוד אחר. ערכת השחזור מדפיסה אז את שניהם. אם APP_KEY משתנה אחר כך, מפתח הגיבוי כבר לא ניתן לפתיחה: BombVault מפסיקה לגבות ואומרת זאת תחת דורש תשומת לב, במקום לכתוב עם המפתח הלא נכון. מעלים את ערכת השחזור שוב תחת שחזור, חירום, או מחזירים את APP_KEY. ראו אשף החירום.
  • הצפנה מופעלת כברירת מחדל (הצפנת גיבויים בכרטיס הצפנה תחת הגדרות, אבטחה). restic מצפין את הגיבויים עם הסיסמה שנגזרת ממפתח הגיבוי.
  • פיקדוני מפתח. שומר מפתח בקבוצה שלך מחזיק עותק אטום של ערכת השחזור של השרת הזה שהוא לא יכול לפתוח בעצמו. רק קוד הפתיחה בן 20 התווים פותח אותו, והשומר מוסר אותו רק אחרי שמישהו שם לוחץ אישור. ראו שומר מפתח.

צמתים

צומת הוא BombVault בלי ממשק רשת שמקבל את ההוראות שלו ממופע בית.

  • מופע הבית מחזיק את הצומת. צומת מעגן את שקע ה-Docker של השרת שלו, שזה root שם, ומופע הבית שולט בצומת. אם מופע הבית נפרץ, התוקף שולט גם בכל הצמתים שלו. נותנים למופע הבית סיסמת התחברות ומרחיקים את ממשק הרשת שלו מהאינטרנט.
  • צומת מחזיק מעט. אם צומת נפרץ, התוקף לא מקבל קבוצת צימוד, מבצר, צומת אחר או מאגר אחר. לצומת יש רק קישור למופע הבית שלו, כניסה משלו בשרת המקלט ותיקייה משלו ביעד. בשרת המקלט הוא לא יכול למחוק היסטוריה, כי השרת הוא append-only. הוא יכול למלא את הדיסק של השרת, כי rest-server לא מגדיר מכסה, ולכן נותנים לשרת המקלט מקום או שיתוף משלו. ביעד, פרטי הגישה שלו יכולים בדרך כלל למחוק את מה שנמצא שם. גיבויים שנשמרים על הצומת נמצאים בידי התוקף, ולכן מופע הבית מושך מהם עותק.
  • הקישור פרטי וחתום. מופע הבית והצומת מדברים דרך הממסר בקישור משלהם, אטום בסוד שנגזר מה-APP_KEY של הצומת. כל צד מכיר את המפתח של השני לפני הקריאה הראשונה, ולכן אין שלב אישור. מופע הבית חותם על כל קריאה עם המפתח שלו ומונה, והצומת דוחה קריאה שמופע הבית לא חתם עליה או שהוא כבר קיבל. הצומת לא קורא לשום דבר במופע הבית מלבד ההודעה הראשונה שלו.
  • מופע הבית מגיע לרשימה קבועה. בקשות שמופע הבית מעביר לצומת רצות רק על רשימה קבועה של נתיבי הצומת, שמפורטת ב-GET /api/nodes/routes, והצומת עונה עליהן ב-JSON בלבד. שום דבר ברשימה לא מוחק או מגיע להגדרות, לאחסון, למפתחות, לקבוצה או לאסימונים. במופע הבית הם צריכים כניסה עם הסיסמה: טלפונים מצומדים, אסימוני API ומפתחות MCP לא מגיעים לצומת. גיבויים ושחזורים שהתחילו כך מופיעים כאלה שמופע הבית התחיל.
  • פיקדונות מפתח נושאים את מפתחות הצמתים. מופע הבית שומר את ה-APP_KEY של כל צומת, וערכת השחזור מדפיסה אותו בפרק צמתים שלה, כך שגם פיקדון מפתח נושא אותו. שומר מפתח שמקבל את הפיקדון ואת קוד הפתיחה יכול לפתוח את המאגרים של הצמתים שלך, אבל לא יכול לתת פקודות לצומת, כי לשם כך צריך את החתימה של מופע הבית.
  • שחרור הוא לתמיד. צומת ששוחרר לא מקבל שוב שום מופע בית עם אותו APP_KEY. צומת שלא זמין כשמשחררים אותו שומע על זה ממופע הבית כשהוא חוזר.

רשת

  • שינויים צריכים JSON. בקשה ששינתה משהו חייבת לשלוח Content-Type: application/json ואסור שהדפדפן יסמן אותה כחוצת אתרים, כך שדף באתר אחר לא יכול לגרום לדפדפן שלך לשנות הגדרות בכתובת LAN. סקריפט שמניע את ה-API שולח את הכותרת הזו. כל דבר אחר נדחה עם 415.
  • מכיוון שהשער הוא בהסכמה, כשלא מוגדר כל הממשק וה-API (כולל היעדים, נתיבי בדיקת החבלה ונתיבי השחזור) נגישים לכל מי שיכול להגיע לפורט. קובעים סיסמת התחברות ברגע שמשתמשים בגיבויים מחוץ לאתר, ב-append-only או בהצפנה.
  • מריצים את BombVault רק ברשת מהימנה ולא חשופה. לגישה מרחוק שמים אותה מאחורי proxy הפוך שמוסיף אימות ו-TLS. תשובות נושאות כותרות אבטחה בסיסיות (CSP,‏ nosniff,‏ X-Frame-Options,‏ Referrer-Policy).
  • מאחורי proxy הפוך כל בקשה נושאת את הכתובת של ה-proxy, ולכן בלי TRUSTED_PROXY מגבלת ההתחברות סופרת כל לקוח בסל אחד וכשלונות של תוקף נועלים גם אותך. נותנים שם ל-proxy ב-TRUSTED_PROXY כדי להחזיר ספירה לכל לקוח.
  • proxy הפוך שלפני BombVault חייב להעביר את הכותרת Authorization או X-API-Key אל /mcp ואסור לו לחצוץ את התשובות שלו, אחרת עוזרים לא יכולים להתחבר. ראו שרת MCP.
  • נקודת הקצה של MCP, /mcp, עונה 404 עד שקיים מפתח או שהכניסה דרך OAuth מופעלת, והיא מבקשת מכל לקוח את המפתח או האסימון שלו גם כשסיסמת ההתחברות כבויה. אף כתובת אינה פטורה, אפילו לא localhost. אין לה כלי שחזור או מחיקה, ושחזור גיבוי הגדרות מבטל כל מפתח. ראו שרת MCP.
  • עם HTTP_ONLY=true עוגיית ההפעלה מאבדת את הדגל Secure שלה (היא חייבת, כדי לעבוד ב-HTTP רגיל), ולכן מפעילים את הסיסמה מאחורי proxy שמסיים TLS רק אם סודיות חשובה.
  • חיבור ה-SSH של גיבוי VM סומך על מפתח המארח בחיבור הראשון (TOFU) ונועץ אותו אחר כך. בודקים את מפתח המארח בערוץ נפרד אם הנתיב מהקונטיינר למארח אינו מהימן.
  • קישורים לא מובילים אל מחוץ לעיגון. גיבוי או שחזור במקום נעצר עם הודעה כשקישור מעל הנתיב שלו מוביל אל מחוץ לעיגון של המארח, כי קונטיינר שכותב לשיתוף שלו יכול לשתול קישור כזה. יעד שהמארח או ה-remote של rclone שלו מתחיל במקף נדחה באותו אופן, בשמירה ובריצה הבאה, כי ssh או rclone היו קוראים אותו כאפשרות.

שרת MCP

שרת ה-MCP לא צריך משתנה סביבה. מפעילים אותו בהקמת מפתח תחת הגדרות, אינטגרציות, שרת MCP, והוא עונה ב-/mcp באותו פורט כמו ממשק הרשת (למשל https://192.168.1.10:3443/mcp). בלי מפתח פעיל הנתיב הזה עונה 404. לקוחות, תעודות ומגבלות מתוארים בשרת MCP.

גיבוי VM דרך SSH

BombVault מגבה מכונות וירטואליות של KVM/libvirt בלי לעגן שום נתיב של libvirt. היא מריצה virsh במארח דרך SSH (qemu+ssh://), ולכן היא לא יכולה לפגוע במנהל ה-VM של המארח שלך.

עיגון שקע ה-libvirt של המארח בקונטיינר שביר ב-Unraid: מנהל ה-VM הוא הבעלים של הנתיבים האלה, וכיבוי "Enable VMs" עלול להשאיר את libvirt בלי יכולת להתחיל. מפתח ה-SSH מעניק root במארח, אותה רמת אמון כמו שקע Docker ש-BombVault כבר משתמשת בו.

הגדרה מהירה:

  1. הגדרות, אינטגרציות, SSH למארח: מעתיקים את המפתח הציבורי שמוצג.
  2. מוסיפים אותו ל-/root/.ssh/authorized_keys של Unraid (ונשמר גם ב-flash כדי שישרוד אתחולים).
  3. לוחצים בדיקת חיבור.

התבנית מוסיפה --add-host=host.docker.internal:host-gateway כדי שהקונטיינר יוכל להגיע למארח. קובעים את LIBVIRT_HOST לכתובת ה-IP של Unraid ב-LAN אם השם הזה לא נפתר (למשל כשהקונטיינר רץ על רשת מותאמת br0.x). אם שינית את פורט ה-SSH של Unraid, קובעים את LIBVIRT_SSH_PORT שיתאים. Snapshot חי צריך גם את qemu guest agent במכונה ואת הדיסק על /mnt/cache (לא /mnt/user).

מדריך מלא להגדרת VM ולרשת

המדריך המלא שלב אחר שלב (הפעלת SSH, אישור מפתח קבוע, ניתוב ברשת מותאמת וב-VLAN, שיטה לכל מכונה ופתרון בעיות בצד המארח) הוא מדריך גיבוי VM.

הגדרה מחוץ לאתר

עותקים מחוץ לאתר הולכים ליעדים. פותחים את יעדים מאריח ההגדרות שלו (או מצמידים אותו לסרגל הצד) ובוחרים הוספת יעד. ראו מחוץ לאתר והתאוששות לתהליך המלא (הגנה מפני מחיקה, בדיקת חבלה ותרגילי DR). בקצרה:

  • Backends: SMB/CIFS ו-WebDAV דרך rclone בלי עיגון מארח, NFS (מעגנים את הייצוא במארח ומשתמשים בו כתיקייה מקומית), backends מקוריים של restic בלי rclone (s3:...,‏ rest:http://host:8000/repo,‏ sftp:user@host:/repo), או כל remote של rclone (rclone:<remote>:<bucket>/path). ל-Backblaze B2 אין כאן backend מקורי: מגיעים אליו דרך נקודת הקצה S3 שלו (s3:https://s3.<region>.backblazeb2.com/<bucket>/<path>) עם מזהה המפתח ומפתח האפליקציה כפרטי הגישה של S3.
  • פרטי גישה נשמרים מוצפנים, כרשימה אחת של פרטי גישה שמורים בכרטיס פרטי גישה תחת הגדרות, יעדים. כוכב מסמן את ברירת המחדל, שמשמשת היכן שלא נבחרו פרטי גישה. הדף של יעד בוחר את אלה שהוא משתמש בהם בכרטיס פרטי גישה שלו. ראו פרטי גישה.
  • יעדי SSH לא צריכים דבר מותקן בצד הרחוק. sftp: צריך רק שרת SSH. מוסיפים את המפתח הציבורי מהגדרות, אינטגרציות, SSH למארח (גם ב-/config/ssh/id_ed25519.pub) ל-~/.ssh/authorized_keys של משתמש היעד, או נותנים להוספת מפתח בהוספת יעד להניח אותו שם עם סיסמת החשבון.
  • rest-server עם תעודה חתומה בעצמה: שמים את התעודה שלו, או של הרשות שחתמה עליה, כקובץ PEM בתיקייה certs של תיקיית הנתונים של BombVault (/config/certs בקונטיינר, appdata/bombvault/certs ב-Unraid). גיבויים, העתקות ובדיקת ההגנה מפני מחיקה סומכים עליה בלי הפעלה מחדש.
  • עותק מחוץ לאתר: BombVault מעתיקה תצלומים חדשים עם restic copy במיטב היכולת, מעל ראשי (בדרך כלל מקומי). הכרטיס העתקה של יעד קובע אם הוא מעתיק אחרי כל גיבוי או לפי תוכנית משלו, והגדרות, לוח זמנים, עותקים מחוץ לאתר לפי תחום נותן לתחום אחד תוכנית העתקה משלו. שכפול עכשיו נמצא בשורת התחום בכרטיס עותקים מחוץ לאתר תחת הגדרות, יעדים.
  • כמה יעדים לכל תחום: הכרטיס יעדים לפי תחום בדף היעדים מפעיל או מכבה כל קו מתחום ליעד בלחיצה אחת, כולל מקומי. תחום שיש לו רק יעדים מחוץ לאתר מגבה ישירות אליהם, ותחום שכל הקווים שלו כבויים לא מגובה. כללים לפי תחום של יעד נותנים לתחום אחד מאגר, שמירה או דחיסה משלו שם.
  • מיקום לפי פריט: כל קונטיינר, מכונה וערכת תיקיות מדליקים מקומי ואת היעדים שמקבלים את הגיבויים שלו, בכרטיס לוח זמנים ויעד בלשונית ההגדרות שלו. פריטים בלי בחירה משלהם עוקבים אחרי התחום שלהם. ראו מיקום לפי פריט.
  • שמירה: כל יעד שומר גיבויים לפי הכרטיס כמה זמן לשמור שלו, ותחום יכול לשמור ערכים משלו שם תחת כללים לפי תחום. זה כולל את העותק בשדה מחוץ לאתר של תחום. אפסים בכל השדות לעולם לא גוזמים תצלומי יעד.
  • מגבלות רוחב פס: מגבילים את קצב ההעלאה וההורדה של restic בכרטיס רוחב פס מחוץ לאתר תחת הגדרות, יעדים, או לכל יעד בכרטיס העתקה שלו. מזינים KiB/s, והשדה מציג את אותו קצב ב-MB/s וב-Mbit/s.
  • סטרימינג קודם: בכרטיס סטרימינג בדף היעדים בוחרים את שרתי המדיה (Plex,‏ Jellyfin ו-Emby נבחרים מראש לפי שם ה-image), את קצב השליחה שממנו נחשב סטרימינג, את מגבלת ההעלאה בזמן הסטרימינג ואחרי כמה זמן מסטרימינג המגבלה הרגילה חוזרת.
  • מחלקת אחסון קר וארכיון (S3): ליעד S3 בוחרים דרגה שאפשר לשחזר ממנה (Standard,‏ Standard-IA,‏ One Zone-IA,‏ Intelligent-Tiering,‏ Glacier Instant Retrieval) בדף שלו. remotes של rclone קובעים את המחלקה שלהם בהגדרות rclone.
  • תיקייה עצמית ביעד במקום מקומית: התיקייה העצמית של תחום יכולה לחיות באחד היעדים שלמעלה, בלי עותק מקומי ובלי שלב העתקה. ראו התיקייה העצמית של תחום.

חריגות

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

הגדרות ניידות (ייצוא וייבוא)

הכרטיס ייצוא / ייבוא הגדרות תחת הגדרות, מערכת כותב את כל התצורה של BombVault שלך (הגדרות תחומים, יעדים, לוחות זמנים, שמירה, התראות) לקובץ JSON נייד שאפשר לייבא במופע אחר, כך שמעבר לתיבה חדשה או שכפול הגדרה לא אומר להזין הכול מחדש ביד. הייבוא מציג תצוגה מקדימה ומבקש אישור, והוא אף פעם לא נוגע בנתוני הגיבוי או בהיסטוריה שלך. קישורים בקובץ ליעדים או מאגרים שכבר לא קיימים מושמטים, והתצוגה המקדימה מציינת אותם. בזמן שרפליקת ZFS רצה, ייבוא נדחה לפני שנכתב משהו.

הייצוא יכול להכיל פרטי גישה

אתה בוחר אם לכלול בקובץ את פרטי הגישה מחוץ לאתר, של ההתראות ושל ה-broker של MQTT. עם פרטי גישה כלולים, הייצוא רגיש כמו ערכת השחזור שלך, ולכן שומרים אותו במקום בטוח. בלעדיהם הקובץ מחזיק רק הגדרות לא סודיות.

ה-APP_KEY לא עובר עם הקובץ

המאגרים נעולים בסיסמה שנגזרת מה-APP_KEY, והקובץ לא מכיל אותו. במעבר מתוכנן נותנים לתיבה החדשה את ה-APP_KEY הישן בתבנית שלה, או משתלטים על המפתח עם ערכת השחזור תחת חירום. תחת מפתח אחר המאגרים עונים שהסיסמה שגויה. שום דבר לא אבד, והגדרת המפתח הנכון פותחת אותם שוב.