Düğümler¶
Düğüm, web arayüzü olmayan bir BombVault'tur, örneğin bir VPS'te ya da bir arkadaşının evindeki küçük bir sunucuda. Kendi sunucusundaki konteynerleri ve klasörleri yedekler. Ne zaman yedekleyeceğini ve yedeklerin nereye gideceğini ise onu eklediğin BombVault söyler, bu sayfada ona ana örnek diyoruz. Düğümü ana örneğin web arayüzünden, kendi ögelerinin yanında yönetirsin.

Nasıl çalışır¶
- Düğümün anahtarını ana örnek tutar. Bir düğüm eklediğinde ana örnek onun
APP_KEYanahtarını üretir, mühürlü bir kopyasını saklar ve anahtarı sana bir kez, düğümün compose dosyasının içinde verir. Ana örnek bu kopyayla düğüme ulaşır ve yedeklerini açar. - Düğümün açık bir porta ihtiyacı yoktur. Ana örnek ve düğüm, eşleştirme grubundan ayrı, kendilerine ait özel bir bağlantıyla röle üzerinden konuşur. Her çağrıyı ana örnek başlatır ve imzalar, düğüm ise ondan selamı dışında hiçbir şey istemez. Açık port gerektiren tek hedef yedekleri düğümde tutmaktır.
- Yedekler asla röleden geçmez. Düğüm onları doğrudan seçtiğin yere gönderir: ana örneğin alıcı sunucusuna, ana örneğin hedeflerinden birine ya da düğümün kendi üzerindeki bir rest-server'a.
- Düğüm kendi başına hiçbir şey planlamaz. Zamanlama çalıştırmaz, bildirim göndermez, hiçbir gruba ya da kaleye katılmaz. Yedeklerini ana örnek başlatır, nasıl gittiğini izler ve uyarıları gönderir.
- Düğüm konteynerleri ve klasör kümelerini yedekler. VM'ler, flash sürücü, ZFS veri kümeleri ve öz yedek tam kurulumlarda kalır.
Bağlantı, grubunda varsa ana örneğin kendi rölesini, yoksa projenin rölesini kullanır, ana örnek röle olmadan eşleşse bile.
Başlamadan önce¶
- Ana örnekte bir giriş parolası. Düğüm eklemek, compose dosyasını yeniden göstermek ve ögelerini açmak parolayla oturum açmayı gerektirir, bkz. Giriş.
- Düğümün sunucusunda Compose ile Docker.
- Yedekler için bir yer, Yedekler nereye gider altındaki üç seçenekten biri. En güvenli seçim alıcı sunucudur, çünkü düğüm orada hiçbir şey silemez.
Düğüm eklemek¶
- Ana örnekte Örnekler sayfasını aç ve sağ alttan Düğüm ekle'yi seç.
-
Ad. Düğümün burada hangi adla görüneceğini yaz, örneğin sunucunun adı, ve İleri'yi seç.

-
Yedekler. Yedeklerin nereye gideceğini seç ve o yerin istediklerini doldur. Her gün yedekleme saati iki bölümün de başladığı saattir. Ana örnek, ikisi aynı anda aynı disklere uzanmasın diye kendi konteyner yedeklerinden yarım saat sonrasını önerir. Daha sonra kartta her bölüme kendi planını verebilirsin. İleri'yi seç.

-
Başlat. Pencere,
MODE,APP_KEY,NODE_HOMEveNODE_NAMEdoldurulmuş olarak düğümün compose dosyasını gösterir. Dosyayı kopyala veAPP_KEYanahtarını güvenli bir yerde sakla. Düğümün sunucusunda:mkdir -p /opt/bombvault-node && cd /opt/bombvault-node nano docker-compose.yml # paste the file from the window docker compose up -dBaşlatmadan önce Host Data birimini yedeklemek istediğin verilere yönlendir ve
HOST_SOURCE_ROOTdeğerini, aşağıdaki örnekte olduğu gibi aynı yola ayarla. -
Pencere düğümü bekler. Düğüm yanıt verince ana örnek ona yedeklerinin nereye gideceğini söyler ve oraya ulaşıp ulaşmadığını denetler. Pencerede o zaman vps-helsinki çevrimiçi ve bu örnekten komut alıyor. yazar.

Pencereyi düğüm yanıt vermeden kapatabilirsin. Kartında o zaman Düğüm bekleniyor yazar ve ana örnek, düğüm göründüğü anda ona yedeklerinin nereye gideceğini söyler.
Örnek: alıcı sunucuya yedekleyen bir VPS¶
Ana örnek, alıcı sunucuyu çalıştıran tower adlı bir Unraid makinesidir. Bir ters proxy onu https://backup.tower.example.org olarak yayınlar. vps-helsinki VPS'i Nextcloud ve Caddy çalıştırır, verileri /srv/appdata altındadır.
towerüzerinde: Örnekler, Düğüm ekle, advps-helsinki, İleri.- Bu örneğin alıcı sunucusu'nu seç ve Düğümler için adres alanına
https://backup.tower.example.orgyaz. Ana örneğin konteynerleri 02:30'da yedeklenir, bu yüzden pencere 03:00'ü önerir. Bunu bırak ve İleri'yi seç. -
VPS'te, birimleri ve
HOST_SOURCE_ROOTdeğerini/srv/appdataiçin değiştirerek penceredeki dosyayı kaydet:services: bombvault-node: image: junkerderprovinz/bombvault:latest restart: unless-stopped hostname: bombvault-node container_name: bombvault-node volumes: - ./config:/config - /var/run/docker.sock:/var/run/docker.sock - /srv/appdata:/host/user environment: MODE: node APP_KEY: "<filled in by home>" NODE_HOME: "<filled in by home>" NODE_NAME: "vps-helsinki" PLATFORM: generic HOST_SOURCE_ROOT: /srv/appdata -
docker compose up -d. Birkaç saniye sonratowerüzerindeki pencere düğümün çevrimiçi olduğunu ve Yedekler https://backup.tower.example.org hedefine gidiyor. yazar. - Saat 03:00'te ana örnek düğümün yedeklerini başlatır. Ertesi sabah genel bakıştaki Düğümler kartı
vps-helsinkidüğümünün son yedeğini gösterir, Yedekler de konteynerlerini ayrı bir bölümde listeler.
Bir konteynerin verilerinin düz bir Docker ana makinesinde nasıl bulunduğu Yedek kaynağı algılama altında anlatılır.
Yedekler nereye gider¶
Her düğümün iki bölümü için tek bir hedefi vardır. Kartındaki Hedefi değiştir, düğüm çevrimiçiyken hedefi değiştirir. Yeni yer yeni depolar alır, eski yerdeki yedekler olduğu yerde kalır.
Bu örneğin alıcı sunucusu¶
Düğüm, ana örneğin alıcı sunucusuna append-only kipte yazar: yedek ekleyebilir ama hiçbirini silemez. Orada düğümün adını taşıyan kendi girişini ve kendi klasöründe bölüm başına bir depo alır. Ana örnek her depoya kendi anahtarını ekler ve onları kendisi toparlar, çünkü düğüm bunu yapamaz.
Düğüm sunucuya, ikinci adımda ya da Alıcı sunucu penceresinde ayarladığın Düğümler için adres üzerinden ulaşır. Düğüm genellikle internetten gönderir, bu yüzden adres şunlardan biri olmalıdır:
https://, örneğin bir ters proxy, Pangolin ya da bir tünel arkasında. Sunucu herkese açık bir sertifika yetkilisinin sertifikası yerine kendi sertifikasını gösteriyorsa, onu PEM biçiminde Sertifika alanına yapıştır.- Özel bir IP adresiyle
http://, örneğin bir WireGuard bağlantısında10.0.0.5ya da Tailscale'de100.101.102.103.
Herkese açık bir adrese düz http:// reddedilir, çünkü düğüm yedeklerini internet üzerinden şifresiz gönderirdi. Adresi değiştirdiğinde ana örnek bunu alıcıdaki her düğüme bildirir, o sırada uzakta olan bir düğüm de döndüğünde öğrenir.
Bir hedef¶
Düğüm, ana örneğin kendisinin de ulaşabildiği hedeflerinden birine yazar: https:// üzerinden ya da özel bir adreste bir S3 hizmetine veya bir REST sunucusuna. Depoları orada bombvault-node-<node id>-containers ve bombvault-node-<node id>-files altında durur.
Düğüm, kendisi için oluşturulmuş kayıtlı bir oturum açma bilgisiyle oturum açar, ve bu bilgi ana örneğin hedefe yazarken kullandığından farklı olmalıdır. Pencere hiç olmadığını söylüyorsa önce bir tane ekle. Bu oturum açma bilgisiyle düğüm, alıcı sunucunun aksine, hedefteki şeyleri genellikle silebilir ve pencere bunu belirtir.
Düğümde tut¶
Düğüm yedeklerini, append-only kipte kendi rest-server'ının arkasında kendisi tutar, ana örnek de her bölümün bir kopyasını kendi deposuna çeker. Bu, ana örneğin yer sunamadığı bir düğüme uyar. Açık port gerektiren tek hedef budur.

- Düğümün adresi alanına ana örneğin düğüme nereden ulaşacağını yaz: düğümün herkese açık adresi ve boş bir port, örneğin
https://203.0.113.7:8443, sonunda klasör olmadan.http://yalnızca özel bir adresle kullan, yukarıdaki gibi. - Düğüm bu portta
bombvault-node-rest-serverkonteynerini başlatır, depoları Host Data altındakibombvault-nodeklasöründe durur.https://ile o adres için bir sertifika üretir, ana örnek de onu sabitler. - Ana örnek ulaşabilsin diye portu düğümün güvenlik duvarından geçir. Düğümdeki başka bir konteynerin tuttuğu bir port, o konteynerin adıyla birlikte reddedilir.
Ana örnek bir bölümü, düğümdeki yedekleri biter bitmez çeker, yedek olarak da her saat başını çeyrek geçe, Çekme kapalıyken bile. Ana örneğin çektikleri, düğüm gittikten sonra bile her çekilen kopya gibi ana örnekte kalır. Rest-server'ı silme kabul etmediği için düğüm kendi depolarını ana örnek istediğinde kendisi toparlar, klasör kümeleri de bombvault-node klasörünü dışarıda bırakır, böylece kendi yedeklerini asla yedeklemez.
Düğümler ne zaman yedekler¶
Her düğümün zamanlaması ana örneğe aittir. Kart her bölüm için bir plan gösterir, örneğin Konteynerler her gün 2:00'de ve Klasörler haftalık (Paz) 4:00'te. Tıklamak, Zamanlamalar altındakiyle aynı düzenleyiciyi açar ve değişiklik hemen kaydedilir.

- Uzakta olan bir düğüm kaçırdığı yedekleri döner dönmez başlatır. Ana örnek beş dakikada bir bakar.
- Meşgul bir düğüme beş dakika sonra yeniden sorulur.
- Ana örnek bir düğümün eski yedeklerini toparlarken, düğüm ana örnek işini bitirene kadar hiçbir şey başlatmaz. Alıcı sunucuda ve düğümün kendisinde bu pencere her pazar 03:00'te açılır ve en fazla altı saat sürer. Bir hedefte, ana örneğin o hedef için tuttuğu site dışı kopya planını izler. Ana örnek yedekleri, bölümün Ne kadar saklanır altındaki kendi kuralına ya da hedefin bir kuralı varsa onun kuralına göre saklar.
- Düğümün çalışma listesinde, ana örneğin başlattığı yedekler ve geri yüklemeler ana örnek tarafından başlatılmış olarak görünür.
Düğümleri izlemek¶
Genel bakıştaki Düğümler kartı her düğümü durumu, son yedeği, hataları ve açık anormallikleriyle listeler. Bir düğümün olduğunda görünür.

Ana örnek, bildirim kanalları üzerinden her olay için bir uyarı gönderir, bir sonrakini de ancak o olay bittikten sonra:
- Bir yedek başarısız oldu, örneğin BombVault: vps-helsinki: backup failed, öge ve nedeniyle. O ögenin sonraki başarılı bir yedeği olayı bitirir.
- Düğüme ulaşılamıyor, örneğin BombVault: vps-helsinki is out of reach. Ana örnek, düğümün depolarındaki en kısa ölü adam anahtarı kadar bekler, değiştirmezsen 26 saat, düğümün henüz hedefi yokken 6 saat.
Ana örneğin alıcı izlemesi, düğümün her deposuna da bir ölü adam anahtarı ve 04:00'te günlük bir restic check ile göz kulak olur, bkz. Alıcı ve çeken.
Bir düğümün ögeleri¶
Yedekler altında Konteynerler ve Klasörler listeleri, kendi ögelerinin altında her düğüm için bir bölüm içerir. Düğümün kendi konteyneri listede yer almaz. Bir ögenin menüsündeki Şimdi yedekle onun yedeğini düğümde başlatır, Aç da sayfasını açar.
Klasörler listesinde bir düğümün bölümünde Klasör seti ekle düğüme bir klasör seti ekler, bir setin menüsündeki Düzenle de onu değiştirir. İkisi de kendi setlerin için açılan pencerenin aynısını açar. Penceredeki klasör seçici düğümün klasörlerine göz atar, ama orada yeni klasör oluşturmaz.

Bir düğüm ögesinin sayfası, örneğin vps-falkenstein üzerinde diyerek düğümü gösterir ve yedeklerini listeler. Bunlardan birinin yanındaki Geri yükle, ögeyi düğümde geri yükler ve şu an orada olanın yerine koyar. Bunun için konteyner, ana örnekte olduğu gibi durdurulur.

Ana örnek üzerinden düğümün kendi rotalarından oluşan sabit bir listeye ulaşırsın: konteynerleri, klasör kümeleri, çalışmaları ve anormallikleri ile bunları yedeklemek ve geri yüklemek. Düğümün ayarları, anahtarları ve deposu erişim dışında kalır, o listedeki hiçbir şey de silme yapmaz. Bkz. API'de düğümler.
Değiştirmek ve serbest bırakmak¶
Değiştir, parolayla oturum açtıktan sonra düğümün compose dosyasını yeniden gösterir. Düğümü başka bir sunucuya taşımak ya da yeniden kurmak için kullan: dosyayı orada başlat ve eski sunucuyu kapat. Aynı APP_KEY ve NODE_HOME onu yeniden aynı düğüm yapar, yedekleri ve geçmişiyle birlikte. Ana örnek her düğümün klasör kümelerini, yeniden oluşturmak için gerekenlerle birlikte konteynerlerini ve çalışmalarını saklar. Düğüm boş bir config klasörüyle başladığında ana örnek onu yeniden üstlenir, yedeklerinin nereye gideceğini söyler ve bir sonraki yedekten önce bunların hepsini geri verir, böylece düğüm artık var olmayan bir konteyneri geri yükleyebilir. Yeni bir sunucuda, yedeklerini kendisi tutan bir düğüm boş depolarla başlar. Önceki yedekleri, ana örneğin çektiği kopyalarda kalır. Aynı APP_KEY ile çalışan iki sunucu tek düğüm sayılır, bu yüzden ikisini asla birlikte çalıştırma.
Serbest bırak bir düğümü bırakır. Düğüm ana örnekten komut almayı bırakır ve artık hiçbir şey yedeklemez. Yedekleri olduğu yerde kalır, ana örneğin çektiği her kopya da öyle. Alıcı sunucudaki girişi kaldırılır ve ana örnek depolarını izlemeyi bırakır. Serbest bıraktığında uzakta olan bir düğüm, bunu öğrenene kadar kartını Serbest bırakılıyor olarak korur. Serbest bırakılmış bir düğüm aynı APP_KEY ile bir daha hiçbir ana örneği kabul etmez. Sunucuyu yeniden kullanmak için onu yeni bir düğüm olarak ekle ve yeni compose dosyası ile boş bir config klasörüyle başlat.
Güvenlik¶
Ana örnek ele geçirilirse saldırgan onun düğümlerini de yönetir, düğüm de kendi sunucusunun Docker'ını elinde tutar, yani orada root'tur. Ana örneği bir parolayla koru ve internetten uzak tut. 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 ve alıcı sunucuda geçmişi silemez. Ayrıntılar Güvenlik modelinde düğümler altındadır.
Kurtarma kitinde her düğümün APP_KEY anahtarını, restic parolasını ve depolarını içeren bir Düğümler bölümü vardır, böylece bir düğümü geri getirebilir ya da yedeklerini düz restic ile geri yükleyebilirsin.