Ana içeriğe geç

Yapılandırma

Bu sayfa konteynerin ortam değişkenlerini, şablonun sağladığı bağlamaları, güvenlik modelini, SSH üzerinden VM yedeklemeyi ve site dışı kurulumu kapsar. Yedeklerin nereye gideceği ortam değişkenleriyle değil, uygulamanın içinde hedefler olarak ayarlanır.

Ortam değişkenleri

Değişken Gerekli Açıklama
APP_KEY Evet restic deposu parolasını türetmek için kullanılan 32 baytlık onaltılık gizli bilgi (64 onaltılık karakter). openssl rand -hex 32 ile üret. Güvende tut: kaybetmek şifreli yedekleri kurtarılamaz yapar.
LIBVIRT_HOST VM'ler ve ZFS veri kümeleri için VM ve ZFS veri kümesi yedekleri için SSH ile ulaşılan Unraid ana makinesi (şablon alanı Host SSH: Address, varsayılan host.docker.internal). Şablon 192.168.x.x yer tutucusunu önceden doldurur ve bu ayarlanmamış sayılır. Unraid LAN IP'ni kullan, özel bir br0.x ağında zorunludur. host.docker.internal bir TrueNAS uygulamasında olduğu gibi çözümlenmediğinde ve LIBVIRT_URI de bir ana makine adlandırmadığında BombVault konteynerin varsayılan ağ geçidini kullanır ve açılış günlüğü onu adlandırır.
LIBVIRT_SSH_PORT Hayır VM ve ZFS veri kümesi yedekleri için ana makine SSH portu (şablon alanı Host SSH: Port, varsayılan 22).
LIBVIRT_SSH_USER Hayır VM ve ZFS veri kümesi yedekleri için ana makinedeki SSH kullanıcısı (şablon alanı Host SSH: User, varsayılan root).
LIBVIRT_URI Hayır Yukarıdaki üç LIBVIRT_* değişkeninden bir tane oluşturmak yerine olduğu gibi kullanılan tam libvirt bağlantı URI'si (bağlantı dizesi için onlar o zaman yok sayılır). Varsayılan olarak ayarsız. libvirtd'si, oluşturulan dizi biçiminin ifade edemeyeceği standart dışı bir soketi dinleyen TrueNAS Scale'de gerekir: qemu+ssh://<user>@<truenas-host>/system?socket=/run/truenas_libvirt/libvirt-sock. Bkz. VM yedekleme kılavuzu. Bir qemu+ssh:// URI'si ise, ayarlı olmayan LIBVIRT_HOST, LIBVIRT_SSH_USER ve LIBVIRT_SSH_PORT'un her biri ondan alınır, BombVault'un kendi SSH komutları (NVRAM aktarımı, ZFS veri kümeleri) için de.
PORT Hayır HTTP portu (varsayılan 3000. Yalnızca HTTP_ONLY=true ile kullanılır).
HTTPS_PORT Hayır HTTPS portu (varsayılan 3443. Şablon onu 1:1 yayınlar, böylece web arayüzü https://<ip>:3443 adresinde yanıt verir).
HTTP_ONLY Hayır Kendi kendine imzalı HTTPS dinleyicisini kapatıp yalnızca düz HTTP sunmak için true yap (TLS sonlandıran bir ters proxy'nin arkasında kullanım için).
BIND_HOST Hayır Web arayüzünün dinlediği adres (varsayılan 0.0.0.0, her arayüz). Konteynerde ayarsız bırak, çünkü yayınlanmış portlar her arayüze ihtiyaç duyar. 127.0.0.1 Docker dışında bir çalıştırma için uygundur. Sağlık denetimi aynı adrese sorar.
TRUSTED_PROXY Hayır BombVault'un önündeki ters proxy'nin virgülle ayrılmış adresleri ya da CIDR aralıkları (örneğin 192.168.20.11 ya da 10.0.0.0/8). X-Forwarded-For yalnızca bu atlamalardan gelince inanılır ve giriş kısıtlayıcı o zaman hataları proxy'nin arkasındaki herkesi tek bir kovaya koymak yerine gerçek istemci başına sayar. Ayarsız (varsayılan) kimseye güvenmez: koşulsuz inanılan bir başlık, her çağıranın kendi kovasını seçmesine izin verirdi.
HOST_SOURCE_ROOT Hayır Host Data olarak bağlanan ana makine yolu (varsayılan /mnt). BombVault, Docker'ın bildirdiği bind-mount kaynaklarını bu bağlamanın altındaki yollara çevirir. Yalnızca farklı bir ana makine kökü bağladıysan değiştir.
HOST_MOUNT_ROOT Hayır Host Data'nın konteynerin içinde bağlandığı yer (varsayılan /host/user). TrueNAS'ta Host Data kendi ana makine yoluna bağlanır, bu yüzden bu ve HOST_SOURCE_ROOT ikisi de o yolu adlandırır, örneğin /mnt/tank (bkz. TrueNAS SCALE).
DATA_ROOT_SEGMENTS Hayır Bir bind-mount kaynağını yedek verisi olarak işaretleyen, virgülle ayrılmış yol parçası adları (varsayılan appdata, Unraid'in /mnt/user/appdata/<container> geleneğiyle eşleşir). Bir konteynerin bind bağlaması, listedeki HERHANGİ bir parça ana makine kaynağının tam bir yol parçası olarak göründüğünde yedekleme için otomatik seçilir. Örneğin DATA_ROOT_SEGMENTS=appdata,config bir .../config bind'ını da yakalar. Eşleşme büyük küçük harfi yok sayar, bu yüzden varsayılan ZimaOS'un /DATA/AppData/<container> yolunu da kapsar. Bir konteynerin veri klasörünü bulmanın diğer, her zaman açık yolları için bkz. Yedek kaynağı algılama.
PLATFORM Hayır BombVault'un kendini hangi platformda çalışıyor saydığını otomatik algılama yerine zorlar: unraid, generic ya da truenas (varsayılan ayarsız: Unraid'i flash bağlamasının altındaki dockerMan işaretini yoklayarak algılar, aksi halde generic. Tanınmayan bir değer de günlüğe yazılarak generic'e düşer). Yalnızca Unraid'e özgü otomatik yoklamaya güvenmek yerine genel bir Docker ana makinesinde ya da TrueNAS Scale'de açıkça ayarla. Genel compose dosyası bunu yapar. appdata yedek geleneğini, örnekler arası geri yükleme hedefi varsayılanlarını ve yalnızca Unraid'e özgü bildirim/yardımcı eklenti adımlarının hiç denenip denenmeyeceğini değiştirir (bkz. internal/platform).
BOMBVAULT_SELF_CONTAINER Hayır BombVault konteynerinin kendi adı, böylece kendini hiç yedeklemez (ve dolayısıyla durdurmaz).
BACKUP_MAX_HOURS Hayır Tek bir yedekleme çalıştırmasının, zorla iptal edilmeden önce bölüm kilidini tutabileceği en fazla gerçek saat (takılmış bir çalıştırma bölümü sonsuza dek engellemesin diye bir koruma). Boş (varsayılan) 48 kullanır. Çok büyük ya da yavaş bulut yedekleri için yükselt (sınırda iptal edilen bir çalıştırma context deadline exceeded ile başarısız olur). Sınırı tümüyle kapatmak için 0 yap. Bir budama aynı sınıra tabidir ve bir denetim ya da budama, restic ilerleme bildirdiği sürece çalışır.
BACKUP_STALL_HOURS Hayır Bir yedeğin iptal edilmeden önce hiç ilerleme kaydetmeden kalabileceği saat. Boş (varsayılan) 2 kullanır. Bir durgunlukta asla iptal etmemek için 0 yap. Bu iki korumanın daha ince olanıdır ve genellikle tetiklenen odur: çalıştırmanın ne kadar sürdüğüne değil hâlâ bir şey olup olmadığına bakar, bu yüzden yavaş ama sağlıklı çok terabaytlık bir yedek rahat bırakılırken yanıt vermeyen bir paylaşımda takılmış biri günler yerine saatler içinde durdurulur. Hiçbir şey iptal edilmeden önce 30 dakikalık sessizlikten sonra bir uyarı günlüğe yazılır. Tarama ilerleme sayılır: restic büyük bir ağacı gezerken bayt yazmaz ve bu aşama yazılan bayt yerine dosya ve bayt toplamlarından izlenir. İki değişken bağımsızdır ve BACKUP_MAX_HOURS yedeğin kendisinden sonraki aşamaları (saklama, istatistikler, site dışı kopya), izlenecek sayaç olmayan yerleri, yine sınırlar.
DB_DUMP_MAX_HOURS Hayır Tek bir otomatik veritabanı dökümünün durdurulmadan önce çalışabileceği saat. Boş (varsayılan) 6 kullanır. İzin verilen değerler 1 ile 48 arasıdır ve sınır BACKUP_MAX_HOURS'un bir saat altında tutulur (o iki saatten azsa yarısında), böylece uzun bir döküm yedeği de beraberinde götürmek yerine kendi sınırında kesilir ve öyle bildirilir. İlerlemeyen bir döküm BACKUP_STALL_HOURS sonra daha erken durdurulur. Durdurulan bir döküm kendi başına başarısız olur ve konteyner yedeği sürer. Unraid'de Add another Path, Port, Variable ile BombVault konteynerine ekle.
TZ Hayır Zamanlayıcı için saat dilimi (örneğin Europe/Berlin). Ayarsız bırakırsan her zamanlama UTC'de çalışır: 02:30'a ayarlı biri o zaman senin duvar saatinde değil 02:30 UTC'de tetiklenir. Unraid'de bunu kendin hiç ayarlamazsın: sistem kendi saat dilimini her konteynere geçirir. Açılış günlüğü hangi dilimi çözdüğünü söyler. Yaz saati olan bir dilim baharda bir çalıştırmayı atlar ve sonbaharda bir tanesini iki kez çalıştırır, UTC ikisini de yapmaz ama yılda iki kez saatinden bir saat sapar.
DATA_DIR Hayır BombVault'un veritabanını, anahtarlarını ve önbelleklerini tuttuğu yer (varsayılan /config). Konteynerde dokunma. İkiliyi Docker dışında çalıştırırken önemlidir.
FLASH_DIR, FLASH_TEMPLATES_DIR Hayır Flash sürücünün ve Docker şablonlarının konteynerin içinde bağlandığı yerler (varsayılanlar /host/boot ve /host/boot/config/plugins/dockerMan/templates-user). Şablonun /boot bağlamasını izlerler, bu yüzden ayarsız bırak.
MODE Hayır full (varsayılan) uygulamanın tamamını çalıştırır. node bir düğüm çalıştırır: web arayüzü ve kendi zamanlamaları olmadan, yalnızca ana örneğinin söylediklerini yapar. Başka her değer başlatmayı bir iletiyle durdurur. Ana örnek bunu senin için düğümün compose dosyasına yazar.
NODE_HOME Düğümde Düğümün hangi ana örneğe ait olduğu, ana örneğin anahtarı ve rölesiyle birlikte, bvhome1. ile başlayan tek bir değer olarak. Ana örnek bunu düğümün compose dosyasına yazar. Bu olmadan düğüm başlar ama hiçbir ana örnek ona ulaşmaz. Bir ana örneğin üstlendiği düğüm, NODE_HOME başka bir ana örneği gösterdiğinde, ilki onu serbest bırakana kadar başlamayı reddeder.
NODE_NAME Hayır Ana örneğin, ona verdiğin addan doldurduğu düğüm adı.

Bağlamalar

Docker soketini, flash'ı (/boot) ve Host Data kökünü (/mnt) CA şablonunda gösterildiği gibi bağla. Yedek kaynakları ve hedefleri ikisi de Host Data altında durur ve o slave olarak bağlanır, böylece konteyner başladıktan sonra bağlanan uzak bir paylaşım (örneğin /mnt/remotes altında) yeniden başlatma olmadan görünür olur.

TrueNAS'ta Host Data, /mnt/tank gibi bir veri kümesi yoludur, hiçbir zaman bir ixVolume değil. Bir uygulamanın ixVolume'da tuttuğu veri onun dışında kalır ve yedeklenmez. Bkz. TrueNAS SCALE.

ZFS veri kümesi yedekleri de bu kipe ihtiyaç duyar: ana makine bir veri kümesinin anlık görüntüsünü ancak konteyner başladıktan sonra bağlar. Bkz. ZFS veri kümeleri.

Yerel depolar varsayılan olarak ilk yedekte oluşturulan /mnt/user/bombvault/{container,vms,flash,config,files,zfs} konumundadır. Bunlar bölümlerin kendi klasörleridir ve Yerel hedefini oluşturur. Hedefler altındaki sayfasında Bağlantı kartı her bölümün klasörünü değiştirir.

Bir bölümün kendi klasörü, bir NAS ya da bir S3 bucket'ı gibi, zaten sahip olduğun bir hedefte de durabilir: o hedefin sayfasındaki Kendi klasörü olarak kullan onu oraya taşır ve önce daha önce alınmış yedeklere ne olacağını söyler. Bkz. Bir bölümün kendi klasörü.

Yerel depo klasörleri 0755 ve 0644 kiplerinde kalır, böylece SMB üzerinden root olmayan bir senkronizasyon kullanıcısı dışarıda kalmaz, depolar da şifrelidir, bu yüzden bu hiçbir şey açığa çıkarmaz. Kurtarma tanımları her deponun içinde durur, bu yüzden kopyalanmış bir klasör kendi başına eksiksizdir. Öz yedek deposu yalnızca root tarafından okunabilir kalır.

Host entegrasyon denetimi

Genel bakıştaki Host Entegrasyonu kartı (Özelleştir altından ekle) her bağlamayı ve CLI'yi (Docker soketi, libvirt, restic, qemu-img, rclone) yoklar ve eksik parçaları bildirir.

Yedek kaynağı algılama

BombVault her konteyner için hangi bind bağlamalarının ve adlandırılmış birimlerin yedekleneceğini otomatik seçer. Aşağıdakilerden herhangi biri geçerliyse bir yol alınır (sonucu konteynerin Ayarlar sekmesindeki Yedeklenecek klasörler kartında her zaman geçersiz kılabilirsin):

  • Veri kökü parçası eşleşmesi: bind'ın ana makine kaynağı DATA_ROOT_SEGMENTS parçalarından birini tam bir yol bileşeni olarak içerir (varsayılan yalnızca appdata).
  • Docker adlandırılmış birimleri her zaman dahil edilir, çünkü atılabilir bir karşılıkları yoktur ve süzülecek bir şey yoktur, ama yalnızca birimin gerçek ana makine depolama yolunun kendisi Host Data bağlaması üzerinden erişilebilirse, BombVault'un yedeklediği diğer ana makine yolları gibi. Docker'ın varsayılan yerel birim sürücüsü bir birimi daemon'un kendi veri kökü altında saklar (özelleştirmediysen /var/lib/docker/volumes/<name>/_data. docker info -f '{{.DockerRootDir}}' ile kontrol et), ki bu genel docker-compose.yml'nin varsayılan olarak kullandığı dar, tek dizinli Host Data bağlaması tarafından kapsanmaz. Erişilemeyen bir birim sessizce atlanır, hata değildir. Genel bir ana makinede adlandırılmış birimleri gerçekten yedeklemek için Host Data'yı (ve HOST_SOURCE_ROOT'u) Docker veri kökünü de kapsayan ortak bir üst klasöre yönlendir. Compose dosyasındaki Host Data yorumu ödünleşimi açıklar (Unraid bunu aynı nedenle kendi evrensel üst düzey geleneği olan /mnt'nin tamamını bağlayarak aşar).
  • Docker Compose proje dizini: konteyner standart com.docker.compose.project.working_dir etiketini taşıyorsa (docker compose up tarafından otomatik ayarlanır), hiçbir bind bir veri kökü parçasıyla eşleşse de eşleşmese de o dizin de eklenir.
  • bombvault.data etiketiyle geçersiz kılma: yukarıdaki geleneklerin hiçbirinin yakalamadığı bir düzen için (örneğin Compose projesi olmayan tek bir /srv/plex/config bind'ı) tüm bind bağlamalarını dahil etmek için bir konteynere bombvault.data=true etiketini koy. false dışındaki her boş olmayan değer doğru sayılır. Olmayan bir etiket ya da bombvault.data=false hiçbir şeyi değiştirmez.
  • bombvault.dbdump etiketi: otomatik veritabanı dökümünü kapatmak için bir konteynere bombvault.dbdump=false koy (0, no ve off aynısını yapar) ya da BombVault'un kendiliğinden tanımadığı bir konteyneri dökmek için motoru (postgres, mysql, mariadb) adlandır. Etiket, konteynerin Ayarlar sekmesindeki Veritabanı kartındaki anahtardan önce gelir, Unraid'de bunu yapmanın yolu da budur.

Güvenlik modeli

Ana makine üzerinde root'a denk denetim

Docker soketi aracılığıyla BombVault konteynerleri durdurabilir, kaldırabilir ve yeniden oluşturabilir, appdata'yı okuyup yazabilir, VM yedekleme için de virsh çalıştırmak üzere SSH ile (qemu+ssh://, varsayılan olarak root) ana makinede oturum açar. Web arayüzüne ulaşabilen herkes fiilen ana makinede root'tur.

Giriş

  • İsteğe bağlı parola koruması (Ayarlar, Güvenlik altındaki Parola kartı): girişi zorunlu kılmak için bir parola ayarla, devre dışı bırakmak için temizle. Güvenilir LAN kullanımı için varsayılan olarak kapalıdır. Parola, APP_KEY anahtarlı bir biber üzerinde Argon2id ile saklanır, bu yüzden kopyalanmış bir /config anahtarsız değersizdir ve onunla bile saldırmak yavaştır. Yeni bir parola en az 12 karakter ister. Mevcut daha kısa bir parola değiştirilene kadar çalışmaya devam eder. Oturumlar imzalıdır (APP_KEY'den türetilmiş HMAC) ve parolayı değiştirmek onları geçersiz kılar. Girişler istemci başına dakikada beş başarısızlıkla sınırlıdır. Parolayı değiştirmek ya da temizlemek Mevcut parola'yı ve, iki adımlı doğrulama açıksa, kodu ister.
  • Bazı şeyler parola ister. Kurtarma kitini, hata bildirimini ve bir flash yedeğinin ZIP'ini indirme, bir flash yedeğini ya da öz yedeği dışa aktarma, anahtarı bir anahtar bekçisine emanet etme, bir emanetin verilmesine izin verme, yeni bir kurtarma kodu üretme, kimlik bilgileriyle ayarları dışa aktarma, iki adımlı doğrulama, geçiş anahtarları, düğüm eklemek, bir düğümün compose dosyasını yeniden göstermek ve bir düğümün ögelerini açmak, bir giriş parolası ayarlanana kadar reddedilir ve örneğin kendisinde bir oturum açma gerektirir. Yedekleri silmek parola olmadan da çalışır. Parola ayarlıysa bu da aynı oturum açmayı gerektirir.
  • Bir hedef parola göstermez. Bir hedef, rest:https://user:password@host/repo gibi bir oturum açma bilgisi tutabilir ve her sayfa ve her API yanıtı onu giriş parolası olsun ya da olmasın rest:https://[redacted]@host/repo olarak gösterir. Arkasındaki yolu değiştirirsen saklanan parola kalır. Hedefi başka bir sunucuya yöneltmek için hedefi parolasıyla birlikte eksiksiz yaz, çünkü gizlenen bir parola kendi sunucusunda kalır.
  • İki adımlı doğrulama (Ayarlar, Güvenlik): parolanın üstüne bir kimlik doğrulayıcı uygulamasından zaman kodu, ayrıca açıldığında bir kez verilen sekiz tek kullanımlık kurtarma kodu. Paylaşılan gizli bilgi APP_KEY ile şifreli saklanır ve faktörü yeniden kapatmak güncel bir kod gerektirir.
  • Geçiş anahtarları (WebAuthn), bir parola ayarlandığında kendi kartında durur, parolanın yanında ve hiçbir zaman yerine değil, bu yüzden her geçiş anahtarını kaldırmak kimseyi dışarıda bırakmaz. Gerçek bir alan adı ve tarayıcının güvendiği bir sertifika gerektirirler. Varsayılan https://<ip>:3443 tam da WebAuthn'ın reddettiği şeydir ve kart, başarısız olacak bir düğme sunmak yerine bunu söyler. İki adımlı doğrulama açıkken bir geçiş anahtarı PIN'ini, parmak izini ya da yüzünü denetlemelidir, yoksa oturum açma ayrıca kodu da ister.
  • Bir yapılandırma geri yüklemesi (Acil durum sihirbazında Ayarları geri getir) her oturumu sonlandırır, her geçiş anahtarını kaldırır ve her API belirtecini ve MCP anahtarını iptal eder, çünkü geri yüklenen ayarlar kaydedildikten sonra kaldırılmış olanları geri getirebilirdi. Parolayla oturum aç ve geçiş anahtarlarını Ayarlar, Güvenlik altında yeniden kur.
  • Unutulmuş bir parola giriş sayfasında sıfırlanır. Parolanı mı unuttun?, BombVault'un dört karakterlik üç grup halinde 12 karakterlik bir kodu konteyner günlüğüne yazmasını sağlar (Unraid'de: Docker sekmesi, BombVault simgesi, Günlükler). O kod ve yeni bir parola seni oturum açtırır. Sıfırlama ayrıca iki adımlı doğrulamayı kapatır, her geçiş anahtarını kaldırır, her API belirtecini, MCP anahtarını ve OAuth oturumunu iptal eder, diğer tüm oturumları sonlandırır, eşleşmiş her telefonun oturumunu kapatır ve telefon eşleştirmesini kapatır. Sayfa sonrasında nelerin gittiğini listeler. Bir kod 10 dakika geçerlidir ve yanlış tahminler onu tüketmez. Widget ve metrik belirteçleri kalır, çünkü yalnızca okurlar.
  • Konteyner günlüğünü okuyabilen herkes parolayı sıfırlayabilir. Bu ana makinede root'tur, ama aynı zamanda Dozzle gibi bir günlük görüntüleyici, Docker soketi verilmiş herhangi bir konteyner (salt okunur yeter) ve konteyner çıktısını ileten bir günlük göndericisidir. Bunları yalnızca parolaya da güveneceğin kişilere ver. Yalnızca web arayüzüne ulaşan biri kodu hiç görmez.

Telefonlar ve grup üyeleri

  • Eşleşmiş telefonlar bir izin listesine ulaşır. Grubun on iki kelimesini bilen bir telefon, Ayarlar, Güvenlik altındaki Android uygulaması kartında Telefonlar grubun on iki kelimesiyle eşleşebilir açık olduğu sürece parolasız oturum açar. Oturumu yalnızca uygulamanın gösterdiğine ulaşır: genel bakış, çalıştırmalar, bakılacak, başlatılacak ve geri yüklenecek yedekler, okunacak anormallikler ve bakılacak Örnekler sayfası. Hedefler ve komutlar ona adresleri ve gizli bilgileri kaldırılmış olarak ulaşır ve orijinali değiştiren bir geri yükleme önce mevcut durumu yedekler. Bir klasöre geri yükleme yalnızca geri yükleme klasörünün içinde yeni ya da boş bir klasörü kabul eder ve telefon başka hiçbir klasörün içine bakamaz. Geri kalan her şey, örneğin kendisinde bir oturum açma gerektiğini yanıtlar: anahtarlar, kurtarma kiti, anahtar emanetleri, ayarlar, yedekleri silme. Bir parola sıfırlama telefon eşleştirmesini sen yeniden açana kadar kapatır. Örnekler sayfasından kaldırılan ya da ayrıntılarında Bu örneği sorgula kapatılan bir telefon oturumunu hemen kaybeder ve uygulamasını yeniden açan kaldırılmış bir telefon kapalı olarak geri gelir.
  • Evden uzakta bir telefon sayfaları röle üzerinden açar. Sayfanın her isteği, rölenin okuyamadığı ya da değiştiremediği grup anahtarıyla mühürlenir ve sunucunun telefonun ilk çağrısında sabitlediği ve biri eşleştirme sayfasında telefonu onayladığında içeri aldığı, telefonun kendi anahtarıyla imzalanır. Sunucu bir isteği bir kez ve yalnızca yeniyken çalıştırır. Yalnızca telefon eşleştirmesi açıkken Örnekler sayfasında listelenen bir telefona ve yalnızca o telefona verdiği bir oturumla yanıt verir, bu yüzden her yerden çıkış yapmak ve bir parola sıfırlama bu sayfaları da sonlandırır. Sunucu her yanıtı imzalar, uygulama imzayı o sunucu için sabitlediği anahtara karşı denetler ve anahtar değişince uyarır. Böyle bir sayfa, giriş parolasıyla ya da parolasız, eşleşmiş bir telefonla aynı izin listesine ve sayfanın ilk okuduğu oturum durumuna ulaşır. Oturum açma ve kapatma, parola sıfırlama ve indirmeler sunucunun kendi adresinde kalır ve bir yanıt 16 MB ile sınırlıdır.
  • Üyeler istediklerini imzalar. Rol istekleri ve yanıtları, depolama teklifleri, bir alıcıya ya da çekene restic parolası verilmesi, alıcı girişleri ve anahtar emanetleri, bir örneğin o üyeyi ilk gördüğünde sabitlediği her üyenin anahtarıyla imzalanır. Başka bir anahtarla imzalanmış bir çağrı reddedilir. Bir örneğin ayrıntılarındaki Anahtarı unut, burada bilinenin üyenin kendi anahtarı olmadığı durum için sabitlenen anahtarı bırakır. Üyeden sonraki imzalı çağrısında anahtarı yeniden istenir. BombVault 9.x üzerindeki üyeler imzalamaz ve kelimeleri bilen herkes tarafından, 9.9'da olduğu gibi, taklit edilebilir. 10.4 ya da daha eski bir sürümdeki bir üyeden gelen rol isteği ya da depolama teklifi, o üye güncellenene kadar reddedilir.
  • On iki kelime bir paroladır. Onlara sahip olan herkes gruba katılır, üyelerin koruma durumunu görür ve diğer örnekteki bir kişinin yine de izin vermesi gereken rolleri isteyebilir. Giriş parolası olmadan web arayüzünü açabilen herkes onları okuyabilir ve eşleştirme kartı bir parola ayarlanana kadar bunu söyler.

Anahtarlar

  • APP_KEY iki şey yapar. Bu kurulumun sakladığını (parolalar, oturum açma bilgileri, belirteçler) mühürler ve yedeklerin anahtarıdır: restic parolası ondan türetilir ve konteyner ve VM tanımları onunla mühürlenir.
  • Devralınan bir anahtar ayrı tutulur. Acil durum sihirbazı başka bir sunucunun yedeklerini devraldığında, bu kurulum kendi APP_KEY'iyle mühürlemeye devam eder ve diğer sunucunun anahtarını yedek anahtarı olarak, diğer her gizli bilgi gibi mühürlenmiş halde saklar. Kurtarma kiti o zaman ikisini de basar. APP_KEY sonradan değiştirilirse yedek anahtarı artık açılamaz: BombVault yanlış anahtarla yazmak yerine yedeklemeyi bırakır ve bunu İlgi bekliyor altında söyler. Kurtarma kitini Geri yükleme, Acil durum altında yeniden yükle ya da APP_KEY'i eski haline getir. Bkz. Acil durum sihirbazı.
  • Şifreleme varsayılan olarak açıktır (Ayarlar, Güvenlik altındaki Şifreleme kartında Yedekleri şifrele). Yedekler yedek anahtarından türetilen parolayla restic tarafından şifrelenir.
  • Anahtar emanetleri. Grubundaki bir anahtar bekçisi, bu sunucunun kurtarma kitinin kendisinin açamadığı mühürlü bir kopyasını tutar. Yalnızca 20 karakterlik kurtarma kodu onu açar ve bekçi onu ancak orada biri İzin ver'e bastıktan sonra verir. Bkz. Anahtar bekçisi.

Düğümler

Düğüm, komutlarını bir ana örnekten alan, web arayüzü olmayan bir BombVault'tur.

  • Düğüm ana örneğin elindedir. Düğüm, sunucusunun Docker soketini bağlar, bu da orada root demektir, ana örnek de düğümü yönetir. Ana örnek ele geçirilirse saldırgan tüm düğümlerini de yönetir. Ana örneğe bir giriş parolası ver ve web arayüzünü internetten uzak tut.
  • Düğümde az şey vardır. Bir düğüm ele geçirilirse saldırgan ne eşleştirme grubunu, ne kaleyi, ne başka bir düğümü ne de başka bir depoyu alır. Düğümde yalnızca ana örneğine giden bir bağlantı, alıcı sunucuda kendi girişi ve bir hedefte kendi klasörü vardır. Alıcı sunucuda geçmişi silemez, çünkü sunucu append-only çalışır. Sunucunun diskini doldurabilir, çünkü rest-server kota koymaz, bu yüzden alıcı sunucuya yer ya da kendine ait bir paylaşım ver. Bir hedefte oturum açma bilgisi genellikle oradakileri silebilir. Düğümde tutulan yedekler saldırganın elindedir, ana örnek de bu yüzden onların bir kopyasını çeker.
  • Bağlantı özel ve imzalıdır. Ana örnek ve düğüm, düğümün APP_KEY anahtarından türetilen bir sırla mühürlenmiş, kendilerine ait bir bağlantıyla röle üzerinden konuşur. Her iki taraf da ilk çağrıdan önce diğerinin anahtarını bilir, bu yüzden onay adımı yoktur. Ana örnek her çağrıyı kendi anahtarı ve bir sayaçla imzalar, düğüm de ana örneğin imzalamadığı ya da daha önce aldığı bir çağrıyı reddeder. Düğüm ana örnekte selamı dışında hiçbir şey çağırmaz.
  • Ana örnek sabit bir listeye ulaşır. Ana örneğin bir düğüme ilettiği istekler yalnızca düğümün GET /api/nodes/routes altında listelenen sabit rotalarında çalışır, düğüm de onlara yalnızca JSON ile yanıt verir. Listedeki hiçbir şey silme yapmaz ya da ayarlara, depolamaya, anahtarlara, gruba veya belirteçlere ulaşmaz. Ana örnekte bunlar parolayla oturum açmayı gerektirir: eşleşmiş telefonlar, API belirteçleri ve MCP anahtarları bir düğüme ulaşmaz. Bu yolla başlatılan yedekler ve geri yüklemeler ana örnek tarafından başlatılmış olarak görünür.
  • Anahtar emanetleri düğüm anahtarlarını da taşır. Ana örnek her düğümün APP_KEY anahtarını saklar, kurtarma kiti de onu Düğümler bölümünde yazdırır, böylece bir anahtar emaneti de onu taşır. Emaneti ve kurtarma kodunu alan bir anahtar bekçisi düğümlerinin depolarını açabilir, ama bir düğüme komut veremez, çünkü bunun için ana örneğin imzası gerekir.
  • Serbest bırakmak kalıcıdır. Serbest bırakılmış bir düğüm aynı APP_KEY ile bir daha hiçbir ana örneği kabul etmez. Serbest bıraktığında uzakta olan bir düğüm, döndüğünde bunu ana örnekten öğrenir.

Ağ

  • Değişiklikler JSON ister. Bir şeyi değiştiren bir istek Content-Type: application/json göndermeli ve tarayıcı tarafından siteler arası işaretlenmemelidir, böylece başka bir sitedeki bir sayfa tarayıcının bir LAN adresinde ayarları değiştirmesini sağlayamaz. API'yi süren bir betik bu başlığı gönderir. Başka her şey 415 ile reddedilir.
  • Koruma isteğe bağlı olduğundan, ayarlı olmadığında arayüzün ve API'nin tamamı (hedefler, kurcalama testi rotaları ve geri yükleme rotaları dahil) porta ulaşabilen herkes tarafından erişilebilirdir. Site dışı, append-only yedekler ya da şifreleme kullanılır kullanılmaz bir giriş parolası ayarla.
  • BombVault'u yalnızca güvenilir, dışa açık olmayan bir ağda çalıştır. Uzaktan erişim için kimlik doğrulama ve TLS ekleyen bir ters proxy'nin arkasına koy. Yanıtlar temel güvenlik başlıklarını taşır (CSP, nosniff, X-Frame-Options, Referrer-Policy).
  • Bir ters proxy'nin arkasında her istek proxy'nin adresini taşır, bu yüzden TRUSTED_PROXY olmadan giriş kısıtlayıcı tüm istemcileri tek bir kovada sayar ve bir saldırganın başarısızlıkları seni de kilitler. İstemci başına saymayı geri getirmek için proxy'yi TRUSTED_PROXY içinde adlandır.
  • BombVault'un önündeki bir ters proxy, Authorization ya da X-API-Key başlığını /mcp'ye geçirmeli ve yanıtlarını arabelleğe almamalıdır, yoksa asistanlar bağlanamaz. Bkz. MCP sunucusu.
  • /mcp MCP uç noktası bir anahtar yok olana ya da OAuth ile giriş açılana kadar 404 yanıtlar ve giriş parolası kapalıyken bile her istemciden anahtarını ya da belirtecini ister. Hiçbir adres muaf değildir, localhost bile. Geri yükleme ya da silme araçları yoktur ve bir yapılandırma yedeğini geri yüklemek her anahtarı iptal eder. Bkz. MCP sunucusu.
  • HTTP_ONLY=true ile oturum çerezi Secure bayrağını kaybeder (düz HTTP üzerinden çalışması için kaybetmek zorundadır), bu yüzden gizlilik önemliyse parolayı yalnızca TLS sonlandıran bir proxy'nin arkasında etkinleştir.
  • VM yedekleme SSH bağlantısı ana makine anahtarına ilk bağlanışta güvenir (TOFU) ve sonrasında sabitler. Konteynerden ana makineye giden yolun güvenilir değilse ana makinenin anahtarını başka bir yoldan doğrula.
  • Bağlantılar bağlama noktasının dışına çıkmaz. Yolunun üstündeki bir bağlantı ana makine bağlamasının dışına çıkıyorsa, bir yedekleme ya da yerinde bir geri yükleme bir iletiyle durur, çünkü kendi paylaşımına yazan bir konteyner böyle bir bağlantı yerleştirebilir. Ana makinesi ya da rclone remote'u tire ile başlayan bir hedef de aynı şekilde, kaydederken ve sonraki çalıştırmada reddedilir, çünkü ssh ya da rclone onu bir seçenek olarak okurdu.

MCP sunucusu

MCP sunucusu için bir ortam değişkeni gerekmez. Onu Ayarlar, Entegrasyonlar, MCP sunucusu altında bir anahtar oluşturarak açarsın ve web arayüzüyle aynı portta /mcp adresinde yanıt verir (örneğin https://192.168.1.10:3443/mcp). Etkin bir anahtar olmadan o yol 404 yanıtlar. İstemciler, sertifikalar ve sınırlar MCP sunucusu sayfasında anlatılır.

SSH üzerinden VM yedekleme

BombVault KVM/libvirt VM'lerini hiçbir libvirt yolunu bağlamadan yedekler. Ana makinede SSH üzerinden (qemu+ssh://) virsh çalıştırır, bu yüzden ana makinenin VM Manager'ını hiçbir zaman etkileyemez.

Ana makinenin libvirt soketini bir konteynere bağlamak Unraid'de kırılgandır: VM Manager bu yolların sahibidir ve "Enable VMs" anahtarını çevirmek libvirt'i başlayamaz bırakabilir. SSH anahtarı ana makinede root verir, BombVault'un zaten kullandığı Docker soketiyle aynı güven düzeyi.

Hızlı kurulum:

  1. Ayarlar, Entegrasyonlar, Ana makine SSH: gösterilen açık anahtarı kopyala.
  2. Onu Unraid'in /root/.ssh/authorized_keys dosyasına ekle (yeniden başlatmaları atlatsın diye flash'a da kalıcı yazılır).
  3. Bağlantıyı test et'e tıkla.

Şablon, konteynerin ana makineye ulaşabilmesi için --add-host=host.docker.internal:host-gateway ekler. Bu ad çözümlenmiyorsa LIBVIRT_HOST'u Unraid LAN IP'ne ayarla (örneğin konteyner özel bir br0.x ağında çalışırken). Unraid'in SSH portunu değiştirdiysen LIBVIRT_SSH_PORT'u eşleşecek şekilde ayarla. Canlı anlık görüntüler ayrıca VM'de qemu guest agent'ı ve diskin /mnt/user üzerinde değil /mnt/cache üzerinde olmasını gerektirir.

Tam VM kurulumu ve ağ kılavuzu

Tam adım adım kılavuz (SSH'ı etkinleştirme, kalıcı anahtar yetkilendirme, özel ağ ve VLAN yönlendirme, VM başına yöntem ve ana makine tarafı sorun giderme) VM yedekleme kılavuzudur.

Site dışı kurulum

Site dışı kopyalar hedeflere gider. Hedefler'i ayar kutucuğundan aç (ya da kenar çubuğuna sabitle) ve Hedef ekle'yi seç. Tam iş akışı (silmeye karşı koruma, kurcalama testi ve DR tatbikatları) için bkz. Site dışı ve kurtarma. Kısaca:

  • Arka uçlar: rclone ile ana makine bağlaması olmadan SMB/CIFS ve WebDAV, NFS (dışa aktarmayı ana makinede bağla ve yerel klasör olarak kullan), rclone olmadan yerel restic arka uçları (s3:..., rest:http://host:8000/repo, sftp:user@host:/repo) ya da herhangi bir rclone remote'u (rclone:<remote>:<bucket>/path). Backblaze B2'nin burada yerel bir arka ucu yoktur: ona S3 uç noktasıyla (s3:https://s3.<region>.backblazeb2.com/<bucket>/<path>), anahtar kimliği ve uygulama anahtarını S3 kimlik bilgileri olarak girerek ulaş.
  • Oturum açma bilgileri şifreli saklanır, Ayarlar, Hedefler altındaki Oturum açma bilgileri kartında kayıtlı oturum açma bilgilerinin tek listesi olarak. Bir yıldız, hiçbiri seçilmediği her yerde kullanılan varsayılanı işaretler. Bir hedefin kendi sayfası, kullandığını Oturum açma kartında seçer. Bkz. Oturum açma bilgileri.
  • SSH hedeflerinin karşı tarafında hiçbir şey kurulu olması gerekmez. sftp: yalnızca bir SSH sunucusu ister. Ayarlar, Entegrasyonlar, Ana makine SSH altındaki açık anahtarı (/config/ssh/id_ed25519.pub konumunda da) hedef kullanıcının ~/.ssh/authorized_keys dosyasına ekle ya da Hedef ekle içindeki Anahtar ekle'nin hesabın parolasıyla oraya koymasına izin ver.
  • Kendi kendine imzalı sertifikalı rest-server: sertifikasını ya da onu imzalayan otoritenin sertifikasını PEM dosyası olarak BombVault'un veri klasörünün certs klasörüne koy (konteynerde /config/certs, Unraid'de appdata/bombvault/certs). Yedekler, kopyalar ve silmeye karşı koruma testi ona yeniden başlatmadan güvenir.
  • Site dışı kopya: BombVault yeni anlık görüntüleri, (genellikle yerel) bir birincilin üstüne, elinden geleni yaparak restic copy ile kopyalar. Bir hedefin Kopyala kartı, Her yedekten sonra mı yoksa kendi planında mı kopyalayacağını ayarlar, Ayarlar, Zamanlama, Bölüm başına site dışı kopyalar ise bir bölüme kendi kopyalama planını verir. Şimdi çoğalt, Ayarlar, Hedefler altındaki Site dışı kopyalar kartında bölümün satırındadır.
  • Bölüm başına birden çok hedef: Hedefler sayfasındaki Bölüme göre hedefler kartı, bir bölümden bir hedefe giden her satırı, Yerel dahil, tek tıkla açıp kapatır. Yalnızca site dışı hedefleri olan bir bölüm doğrudan onlara yedekler ve her satırı kapalı olan yedeklenmez. Bir hedefin Bölüme göre kuralları bir bölüme orada kendi deposunu, saklamasını ya da sıkıştırmasını verir.
  • Öge başına yerleşim: her konteyner, VM ve klasör kümesi, Ayarlar sekmesindeki Zamanlama ve hedef kartında Yerel'i ve yedeklerini alan hedefleri yakar. Kendi seçimi olmayan ögeler bölümlerini izler. Bkz. Öge başına yerleşim.
  • Saklama: her hedef yedekleri kendi Ne kadar saklanır kartına göre tutar ve bir bölüm orada Bölüme göre kurallar altında kendi değerlerini tutabilir. Bu, bir bölümün site dışı alanındaki kopyayı da kapsar. Hepsi sıfır, bir hedefin anlık görüntülerini hiçbir zaman budamaz.
  • Bant genişliği sınırları: restic yükleme/indirme hızını Ayarlar, Hedefler altındaki Site dışı bant genişliği kartında ya da hedef başına kendi Kopyala kartında sınırla. KiB/s girersin ve alan aynı hızı MB/s ve Mbit/s olarak gösterir.
  • Önce yayın: Hedefler sayfasındaki Yayın kartında medya sunucularını (Plex, Jellyfin ve Emby image adına göre önceden seçilidir), yayın sayılacağı gönderme hızını, yayın sırasındaki yükleme sınırını ve bir yayından sonra normal sınırın ne kadar sonra döneceğini seç.
  • Soğuk ve arşiv depolama sınıfı (S3): bir S3 hedefi için sayfasında geri yüklenebilir bir katman seç (Standard, Standard-IA, One Zone-IA, Intelligent-Tiering, Glacier Instant Retrieval). rclone remote'ları sınıflarını rclone yapılandırmasında ayarlar.
  • Yerel yerine bir hedefte kendi klasör: bir bölümün kendi klasörü yukarıdaki hedeflerden birinde durabilir, yerel kopya ve kopyalama adımı olmadan. Bkz. Bir bölümün kendi klasörü.

Anormallikler

Anormallik algılama için ortam değişkeni gerekmez. Ayarlar, Doğrulama altındaki Anormallikler kartında kurulur ve Anormallikler sayfasında anlatılır.

Taşınabilir ayarlar (dışa ve içe aktarma)

Ayarlar, Sistem altındaki Ayarları dışa / içe aktar kartı tüm BombVault yapılandırmanı (bölüm ayarları, hedefler, zamanlamalar, saklama, bildirimler) başka bir örneğe aktarabileceğin taşınabilir bir JSON dosyasına yazar, böylece yeni bir makineye taşınmak ya da bir kurulumu klonlamak her şeyi elle yeniden girmek anlamına gelmez. İçe aktarma bir önizleme gösterir ve onay ister ve yedek verine ya da geçmişine hiçbir zaman dokunmaz. Dosyadaki artık var olmayan hedeflere ya da depolara giden bağlantılar dışarıda bırakılır ve önizleme onları adlandırır. Bir ZFS replikası çalışırken, hiçbir şey yazılmadan önce içe aktarma reddedilir.

Dışa aktarma kimlik bilgileri içerebilir

Dosyaya site dışı, bildirim ve MQTT broker kimlik bilgilerinin dahil edilip edilmeyeceğini sen seçersin. Kimlik bilgileri dahil edildiğinde dışa aktarma kurtarma kitin kadar hassastır, bu yüzden onu güvenli bir yerde sakla. Onlarsız dosya yalnızca gizli olmayan ayarları tutar.

APP_KEY dosyayla birlikte taşınmaz

Depolar APP_KEY'den türetilen bir parolayla kilitlidir ve dosya onu tutmaz. Planlı bir taşımada yeni sunucuya şablonunda eski APP_KEY'i ver ya da anahtarı Acil durum altında kurtarma kitiyle devral. Başka bir anahtarla depolar yanlış parola yanıtı verir. Hiçbir şey kaybolmaz ve doğru anahtarı ayarlamak onları yeniden açar.