Başlarken¶
Bu sayfa seni sıfırdan bir Unraid makinesinden ilk yedeğine kadar götürür.
Gereksinimler¶
| Gereksinim | Notlar |
|---|---|
| Unraid 6.12+ | Daha eski sürümler denenmedi. Ana hedef Unraid, ama BombVault düz bir Docker ana makinesinde ve TrueNAS Scale'de de çalışır (bkz. Genel Docker ana makinesi ve TrueNAS SCALE). |
| Restic deposu konumu | Yerel bir yol (önerilen: dizin ya da önbellek), SMB, NFS ya da herhangi bir rclone arka ucu. |
| Docker soketi | Şablon tarafından kendiliğinden bağlanır (/var/run/docker.sock). |
Unraid flash (/boot) |
Şablon tarafından bütün olarak kendiliğinden bağlanır (/boot içinde /host/boot). Flash yedeğine güç verir ve geri yüklenen bir konteynerin normal, düzenlenebilir bir Unraid uygulaması olarak yeniden görünmesini sağlar. |
| KVM VM'leri (isteğe bağlı) | VM yedekleme libvirt ile SSH üzerinden konuşur, libvirt bağlaması yoktur. Bunu Ayarlar, Entegrasyonlar, Ana makine SSH altında kur (bkz. Yapılandırma). |
| ZFS veri kümeleri (isteğe bağlı) | VM yedekleriyle aynı SSH bağlantısı, ana makinede zfs ve şablon varsayılanı olan Read/Write - Slave erişim kipiyle /mnt olarak eşlenmiş Host Data. Bkz. ZFS veri kümeleri. |
| Android uygulaması (isteğe bağlı) | Android 10 ya da üstü, 9.7.0 ve üstü sürümdeki sunucularla eşleştirilmiş. Bkz. Android uygulaması. |
Unraid'e kurulum¶
En kolay yol Community Applications'tır.
- Unraid'de Apps sekmesini aç.
- BombVault'u ara.
- Install'a tıkla, gerekli değişkenleri (aşağıda) ayarla ve uygula.
Şablonu elle kurma
Şablonu elle eklemeyi tercih edersen:
- Docker, Add Container, Template repositories'e git ve şunu ekle:
- Şablonlarda BombVault'u ara.
- Gerekli değişkenleri ayarla ve Apply'a tıkla.
Genel Docker ana makinesi¶
Unraid'de değil misin? BombVault herhangi bir Docker ana makinesinde düz bir konteyner olarak da çalışır. TrueNAS SCALE'in kendi adımları TrueNAS SCALE altındadır.
- Depodan hazır düzenlenecek
deploy/docker-compose.generic.ymldosyasını al. APP_KEY'i ayarla (aşağıya bak) ve Host Data birimini gerçek veri köküne yönlendir. Dosyadaki yorumlar ikisini de anlatır.docker compose up -dçalıştır, sonrahttps://<host-ip>:3443/adresini aç.
Unraid'den farkı:
- Flash bölümü yok. Yedeklenecek ya da geri yüklenecek bir önyükleme USB'si yoktur, bu yüzden Flash bölümünün burada yapacak bir işi yoktur. Bunun yerine Host Data ana makinenin
/etcklasörüne ulaştığında, Yedekler sayfasındaki Ekle bir klasör önerisi olarak Sistem yapılandırması sunar: kaydetmeden önce gözden geçirip düzenlediğin bir başlangıç/etcklasör kümesi. - Unraid'e özgü bildirimler yok. BombVault'un kendi uygulama içi bildirim kanalları (webhook, site dışı hata uyarıları vb.) normal çalışır. Yalnızca Unraid'in yerel bildirim sistemine gönderme atlanır, çünkü gönderilecek böyle bir sistem yoktur.
- VM yedekleme isteğe bağlıdır ve SSH ile ulaşılabilen ayrı bir libvirtd ana makinesi gerektirir. Compose dosyasındaki yorum satırı yapılmış bloğa bak. Genel bir Docker ana makinesinde yerleşik bir VM yöneticisi yoktur.
- Panoda kutucuk yok. TollRoll bir Unraid eklentisidir, bu yüzden o adım da atlanır.
- Bir konteynerin verisini bulmak. Unraid'in
appdatageleneği olmadan, konteynerin veri klasörüDATA_ROOT_SEGMENTSiçindeki parçalardan, Docker adlandırılmış birimlerinden, bir Compose projesinin çalışma dizininden vebombvault.dataetiketinden bulunur (bkz. Yedek kaynağı algılama). Adlandırılmış birimler ve/etcön ayarı yalnızca Host Data bağlamasının içindeki yollara ulaşır, bu yüzden Host Data'yı Docker'ın veri kökünü de kapsayan ortak bir üst klasöre yönlendir. PLATFORM.genericya datruenasolarak ayarla. Ayarlanmazsa BombVault Unraid'i flash bağlamasındaki kendi işaretinden algılar ve geri kalan her şeyi genel sayar, yalnızca Unraid'e özgü adımlar denenip başarısız olmak yerine atlanır.
TrueNAS SCALE¶
BombVault henüz TrueNAS uygulama kataloğunda değil, bu yüzden özel bir uygulama olarak kur: Apps, Discover Apps, sonra Custom App'in yanındaki menüde Install via YAML. Aşağıdaki YAML, deponun truenas-apps klasöründeki katalog girdisiyle aynı şeyleri ayarlar. tank'ı kendi havuzunla değiştir ve APP_KEY'i sonraki bölümde anlatıldığı gibi doldur.
services:
bombvault:
image: junkerderprovinz/bombvault:latest
hostname: bombvault
restart: unless-stopped
cap_drop: [ALL]
cap_add: [CHOWN, DAC_OVERRIDE, FOWNER, SETGID, SETPCAP, SETUID, SYS_CHROOT]
environment:
APP_KEY: ""
PLATFORM: truenas
HOST_SOURCE_ROOT: /mnt/tank
HOST_MOUNT_ROOT: /mnt/tank
# For VM backups:
# LIBVIRT_URI: qemu+ssh://root@<truenas-ip>/system?socket=/run/truenas_libvirt/libvirt-sock
volumes:
- /mnt/tank/apps/bombvault:/config
- /var/run/docker.sock:/var/run/docker.sock
- type: bind
source: /mnt/tank
target: /mnt/tank
bind:
propagation: rslave
ports:
- "30528:3443"
Sonra https://<truenas-ip>:30528/ adresini aç. Unraid'den farkı altında listelenenler burada da geçerlidir, TrueNAS'ta ayrıca şunlar:
- Yetenekler (capabilities). BombVault'un yukarıdaki yedisine ihtiyacı var.
SETPCAPolmadan VM yedekleri başarısız olur,SYS_CHROOTolmadan da her konteyner bir anlık görüntüden okunmak yerine tüm yedekleme boyunca durdurulur. - Host Data, bir veri kümesi üzerindeki ana makine yoludur, burada
/mnt/tank, uygulamanın içinde aynı yola bağlanır. Bu yüzdenHOST_SOURCE_ROOTveHOST_MOUNT_ROOTikisi de onu adlandırır.rslave, ana makinenin sonradan yaptığı bağlamaları geçirir, bunlar ZFS veri kümesi yedeklerine gerekir. - Bir ixVolume'daki veri yedeklenmez. Depolaması ixVolume olan bir uygulama verisini Host Data dışında,
/mnt/.ix-appsaltında tutar. BombVault yalnızca uygulamanın tanımını saklar ve çalıştırma dışarıda bıraktığı klasörleri adlandırır. Verisinin yedeklenmesini istediğin her uygulama için Host Data altındaki bir veri kümesinde Host Path depolamasını seç. - VM ve ZFS veri kümesi yedekleri TrueNAS'a root olarak SSH ile ulaşır. System, Services altında SSH servisini aç ve Ayarlar, Entegrasyonlar, Ana makine SSH altındaki açık anahtarı Credentials, Users altında root kullanıcısına ekle. VM yedekleri ayrıca yukarıdaki gibi
LIBVIRT_URIister, çünkü TrueNAS'ın libvirtd'si kendi soketini dinler.LIBVIRT_URIdeLIBVIRT_HOSTda ayarlı değilse BombVault uygulamanın varsayılan ağ geçidini ana makine olarak kullanır, çünkühost.docker.internalbir TrueNAS uygulamasında çözümlenmez. Ayrıntılar, zvol üzerindeki VM'ler dahil, VM yedekleme kılavuzunda. - Bir ZFS replikası farklı bir anahtar kullanır. İkinci bir ZFS sunucusundaki replika, Host SSH anahtarıyla değil replika penceresinin gösterdiği anahtarla oturum açar. Onu alıcı sunucuya ekle.
- Silinmiş bir uygulama iki adımda geri gelir. Önce onu TrueNAS'ta aynı adla yeniden kur, bu ağını yeniden oluşturur, sonra verisini BombVault'ta geri yükle. O zamana kadar geri yükleme denetimi eksik ağı bildirir ve geri yükleme, bir şeyi değiştirmeden önce reddeder.
- Orijinalin yanına, düz bir Docker konteyneri oluşturur. Çalışır, ama TrueNAS Apps ekranı onu listelemez.
- Veritabanı dökümleri veri kümesi bağlamalarında çalışır. Kendi başına bir veri kümesi olan bir veri klasörüne içe aktarma, eski içeriği yanındaki bir klasöre taşır, bu yüzden yukarıdaki veri kümesinin bunlar için yere ihtiyacı vardır.
ZimaOS, CasaOS ve diğer ana makineler¶
- ZimaOS ve CasaOS: topluluk mağazasını ekle ve BombVault'u ondan kur. Orada
PLATFORM=genericolarak, Host Data/DATAüzerinde çalışır. ZimaOS uygulama verilerini/DATA/AppData/<app>içinde tutar,DATA_ROOT_SEGMENTSappdataile büyük küçük harf fark etmeksizin eşleştiği için BombVault bunu kendisi bulur. - MOS: BombVault'u MOS Hub'dan kur. Orada
PLATFORM=genericolarak, Host Data/mnt/cacheüzerinde çalışır. - Synology: Container Manager'da compose dosyasından bir proje oluştur (DSM 7.2 ya da daha yeni).
- Proxmox: Docker olan bir VM'de ya da LXC konteynerinde çalıştır.
Yorumlar olmadan genel compose dosyası kısadır. ./data'yı konteynerlerinin verisini tutan ana makine klasörüyle değiştir, HOST_SOURCE_ROOT'u aynı yola ayarla ve APP_KEY'i doldur:
services:
bombvault:
image: junkerderprovinz/bombvault:latest
restart: unless-stopped
hostname: bombvault
container_name: bombvault
volumes:
- ./config:/config
- /var/run/docker.sock:/var/run/docker.sock
- ./data:/host/user
environment:
APP_KEY: ""
PLATFORM: generic
HOST_SOURCE_ROOT: /host/user
ports:
- "3443:3443"
Docker adlandırılmış birimlerini de yedeklemek için, Unraid şablonunun /mnt'nin tamamını bağlaması gibi, hem verini hem de Docker'ın veri kökünü (docker info -f '{{.DockerRootDir}}', genellikle /var/lib/docker) tutan bir klasörü bağla.
Gerekli tek ayar¶
Ayarlaman gereken tek değişken APP_KEY'dir, restic deposu parolasını türetmek için kullanılan 32 baytlık onaltılık bir gizli bilgi (64 onaltılık karakter).
Herhangi bir makinede bir tane üret:
Sonucu şablonun APP_KEY alanına (Unraid) ya da docker-compose.yml içindeki APP_KEY ortam değişkenine (genel Docker ana makinesi) yapıştır.
APP_KEY'ini kaybetme
APP_KEY'i kaybetmek şifreli yedeklerini kurtarılamaz yapar. Onu sunucudan ayrı güvenli bir yerde sakla. BombVault çalışmaya başlayınca bir giriş parolası ayarla ve Ayarlar, Geri yükleme altından kurtarma kitini indir (bkz. Site dışı ve kurtarma). İçinde anahtar, her hedef ve restic komutları bulunur.
Şablon ayrıca Docker soketini, flash'ı (/boot) ve Host Data kökünü (/mnt) senin için bağlar. Yedek kaynakları ve hedefleri ikisi de Host Data altında durur. Değişkenlerin tam başvurusu ve site dışı kurulum için bkz. Yapılandırma.
İlk çalıştırma¶

- Web arayüzünü
https://<your-unraid-ip>:3443adresinde aç (kutudan çıktığı gibi kendi kendine imzalı sertifika). Yeni bir kurulum, BombVault'un sunucuda bulduklarını listeleyen BombVault'a hoş geldin ile açılır. - Başlayalım'ı seç. Genel bakış sonra üç adımlı İlk adımlar kartını gösterir:
- Bölümleri seç: BombVault'un neyi yedekleyeceğini aç (Konteynerler, VM'ler, Flash, Klasörler, ZFS veri kümeleri, Öz yedek). Seç, bir bölümün ögelerinin listesini açar, orada Zamanlamayı duraklat birini dışarıda bırakır. Burada açtığın bölümler her gece çalışır, bunu Ayarlar, Zamanlama altında değiştirirsin.
- Hedef ekle: yedekler için ikinci bir yer. Her bölümün bu sunucuda, ilk yedekte oluşturulan
/mnt/user/bombvault/{container,vms,flash,config,files,zfs}altında zaten bir klasörü var. En güvenlisi, Storage Box ya da Backblaze B2 gibi tesis dışında ikinci bir hedef. - İlk yedekleme: ondan sonra her gece kendiliğinden çalışır. Kart, ilk yedekleme bitene kadar durur.
- Tüm ögeleri tek bir listede görmek için Yedekler'i aç. Şimdi tümünü yedekle, açık olan tüm bölümler üzerinde bir geçiş başlatır, bir ögenin sayfasındaki Şimdi yedekle ise yalnızca onu yedekler.

BombVault'u daha önce kullandın mı? Karşılama sayfasındaki Yedekten geri yükle, kayıp bir sunucunun ayarlarını, konteynerlerini, VM'lerini ve klasörlerini Acil durum sihirbazı'nın geri getirdiği Geri yükleme sayfasını açar. Bkz. Site dışı ve kurtarma.
İsteğe bağlı: bir yedekleme sırası seç
Bazı konteynerler her zaman diğerlerinden önce yedeklenmeliyse (örneğin bir veritabanı, onu kullanan uygulamadan önce), Ayarlar, Zamanlama altındaki Sıra kartını aç ve onları istediğin sıraya sürükle. Zamanlanmış çalıştırmalar ve tam yedekleme bundan sonra onu izler. Sıralamadığın her şey en çok gecikmiş olandan başlayarak yedeklenir.
Örnek: ilk konteyner yedeğin, baştan sona¶
Bu örnek, aralarında plex'in de olduğu birkaç konteynerli yeni bir Unraid makinesinde ilk yedek bitip nerede bulacağını bilene kadar yürür. Yaklaşık on dakika ve ilk yedeğin süresi kadar sürer.
- Kur. Unraid Apps sekmesinde BombVault'u ara ve Install'a bas.
- Anahtarı ayarla. Bir bilgisayarda
openssl rand -hex 32çalıştır ve 64 karakteri şablonunAPP_KEYalanına yapıştır. Başka her şeyden önce, şimdi, bir kopyasını parola yöneticine koy. Apply'a bas. - Aç.
https://<your-unraid-ip>:3443adresine git ve kendi kendine imzalı sertifikayı kabul et. BombVault'a hoş geldin, bulduklarını listeler, örneğin 12 konteyner, 2 VM ve flash sürücü. - Başlayalım. Genel bakış İlk adımlar kartıyla açılır.
- Bölümleri seç. Konteynerler baştan açıktır. İstediğin diğerlerini aç, örneğin Flash. Seç, bulduğu konteynerlerin listesini açar, orada Zamanlamayı duraklat birini, örneğin umursamadığın bir test konteynerini, dışarıda bırakır. Açık bölümler her gece tam yedeklemede çalışır.
- Hedef ekle. Her bölümün bu sunucuda
/mnt/user/bombvaultaltında kendi klasörü zaten var, yani ilk yedeğin gidecek bir yeri var. Bu adım ikinci bir yer ekler ve en güvenlisi tesis dışında olandır. Bunu şimdi S3 örneğiyle yapabilir ya da ilk yedek bittikten sonra dönebilirsin. Kart o zamana kadar durur. - İlk yedekleme. Yedekler'i aç ve Şimdi tümünü yedekle'ye bas ya da geceyi bekle. Durum başlığındaki halka bir ilerleme halkasına döner ve ögeleri sayar, örneğin Şu anda yedekleniyor: 12'den 3'ü. Her konteyner verisi okunurken durdurulur ve hemen sonra yeniden başlatılır. Verisi ZFS üzerinde olan bir konteyner yalnızca bir anlık görüntünün birkaç saniyesi kadar kapalı kalır. İlk yedek her şeyi okur, bu yüzden en uzun sürendir. Sonrakiler yalnızca değişeni saklar.
- Kontrol et. Halka Her şey yedeklendi dediğinde genel bakışta Geçmiş'i aç: her konteynerin Çalıştırmalar'da yeşil bir satırı vardır. Yedekler'i aç,
plex'e tıkla ve Yedekler sekmesine bak: ilk anlık görüntü orada, onu tutan yer Yerel olarak. Birkaç dakika sonra Doğrulama sekmesi, yedekten bir örneği geri yükleyip geri okuyan geri yükleme denetimini gösterir. - Anahtarı koru. Ayarlar, Güvenlik'i aç ve bir giriş parolası ayarla. Sonra Ayarlar, Geri yükleme'yi aç ve Acil durumlar için içinde Kurtarma kitini indir'e bas. Dosyayı sunucudan uzakta, 2. adımdaki
APP_KEYkopyasının yanında sakla. Genel bakıştaki Kurtarma kitini sakla hatırlatması Güvenle sakladım'a basınca kaybolur.
Bundan sonra konteynerler her gece yedeklenir. Sırasıyla iyi sonraki adımlar: ölü bir sunucu yedekleri de alıp götürmesin diye bir site dışı hedef, sonra bir hata sana ulaşsın diye bildirimler, ve 03:00 sana uymuyorsa Zamanlamalar'a bir bakış.

Host entegrasyon denetimi
Genel bakıştaki Host Entegrasyonu kartı her bağlamayı ve CLI'yi (Docker soketi, libvirt, restic, qemu-img, rclone) yoklar ve eksik parçaları bildirir, böylece konteynerin doğru bağlandığını güvenmeden önce doğrulayabilirsin. Sen ekleyene kadar Özelleştir altında bekler.
Bir VPS'i düğüm olarak yedeklemek¶
Bir VPS'in ya da başka küçük bir sunucunun, kendi web arayüzü olan bir BombVault'a ihtiyacı yoktur. Onu bu örneğin düğümü olarak ekle, yedeklerini bu örnek yürütsün:
- Henüz yapmadıysan Ayarlar, Güvenlik altında bir giriş parolası ayarla.
- Örnekler sayfasını aç, Düğüm ekle'yi seç ve
vps-helsinkigibi bir ad yaz. - Yedeklerinin nereye gideceğini, örneğin bu örneğin alıcı sunucusunu, ve ne zaman yedekleyeceğini seç.
- Pencerenin gösterdiği compose dosyasını sunucuya kopyala, Host Data birimini ve
HOST_SOURCE_ROOTdeğerini yedeklenecek verilere yönlendir vedocker compose up -dçalıştır.
Düğüm yanıt verince kartında Bağlı yazar ve konteynerleri Yedekler altında görünür. Düğümler sayfası bunu bir örnekle adım adım anlatır.
Yolunu bulmak¶

Kenar çubuğunda beş giriş var: Genel bakış, Anormallikler (anormallik algılama açıkken), Yedekler, Geri yükleme ve Oturumu kapat'ın altında Ayarlar. Bir sayfanın ana eylemi sağ altta yüzer, Diğer nadir olanları barındırır. Telefonda çubuk Genel bakış, Yedekler, Geri yükleme ve Ayarlar'ı tutar, Diğer'de geri kalanlar vardır.
Sayfalar ve ayarlar pencerenin tüm genişliğini kullanır. Bir pencere düğmelerini alt kısmında tutar, ileriye götüren sağdadır. Telefonda üçten fazla düğmesi olan bir alt kısım çıkışı ve ana eylemi tutar, diğerlerini Diğer altına koyar.

- Genel bakış, her şeyin yedeklenip yedeklenmediğini ve neyin sana ihtiyaç duyduğunu gösterir. Bkz. Genel bakış.
- Yedekler, her konteyneri, VM'i, klasör kümesini, flash sürücüyü, her ZFS veri kümesini ve öz yedeği öge olarak listeler. Listenin üstündeki kutucuklar bir tür seçer, Filtreler, Sırala ve Ara daraltır. Her ögenin üç sekmeli kendi sayfası vardır: Yedekler, Ayarlar ve Doğrulama. Ögenin simgesinin solundaki bir geri düğmesi listeye götürür. Bkz. Yedekler ve ögeler.
- Geri yükleme, her şey için tek sayfadır: bir bölüm seç, bir öge ara ve bir yedek seç. Acil durum sihirbazı ve diğer kaynaklar da buradan başlar. Bkz. Geri yükleme.
- Ayarlar on dört kutucuktur: Genel, Görünüm, Zamanlama, Hedefler, Geri yükleme, Bildirimler, Doğrulama, Güvenlik, Örnekler, Eşleştirme, Entegrasyonlar, Uygulamalar, Sistem ve Bilgi. Bkz. Ayarlar. Hepsinde arama yapmak için
/ya da Ctrl+K'ya bas, sayfaların önceki sürümlerdeki adlarıyla da. Kutucukları Görünüm altında kendi sırana sürükle. Sayfanın yanındaki bir kutucuk sütununun onu sıkıştıracağı yerde, örneğin yaklaşık 1200 piksel genişliğinde bir pencerede, kutucuklar sayfanın üstünde yana kayan bir şeride dönüşür. Telefon aynı şeridi gösterir. - Hedefler ve Örnekler, kendi sayfaları olan ayar kutucuklarıdır. Kutucuklarındaki Kenar çubuğunda da göster onları kenar çubuğuna sabitler.
Hiçbir şeyde Kaydet düğmesi ve katlanan bölüm yoktur: nadir şeylerin kendi kartı ya da penceresi vardır, açıklamalar (i) balonlarındadır. Bir güncellemeden sonra son sürümünden bu yana her sürüm için bir kartlı bir pencere kendiliğinden açılır ve yeşil noktalar neyin değiştiğini işaretler. Bir tıklama noktayı gizler. Ayarlar, Bilgi altındaki Sürüm kartındaki Yeni, henüz görmediklerini sayar ve her sürümün notları ve Oraya git ile değişiklikleriyle o pencereyi yeniden açar.
Kaynaktan derlemek¶
BombVault, bir JSON API'si ve gömülü bir React arayüzü sunan tek bir statik Go ikilisidir. Önce arayüzü derle, sonra ikiliyi çalıştır:
npm --prefix web ci
npm --prefix web run build # writes web/dist, which the binary embeds
export APP_KEY=$(openssl rand -hex 32)
go test ./... # unit and integration tests, with a real restic round trip
golangci-lint run ./...
go run ./cmd/bombvault # serves https://localhost:3443 with a self-signed certificate
Arayüz derlemesi go run için de gerekir. Depo web/dist altında yalnızca boş bir işaret izler, bu yüzden npm --prefix web run build olmadan ikili hiçbir şey gömmez ve 500 SPA index not found yanıtlar, bu beklenen bir şeydir. Docker, libvirt ve Unraid CI'da denenemez, bu yüzden bir pull request açmadan önce bağlamaları, restic'i ve VM SSH bağlantısını gerçek bir ana makinede genel bakışın Host Entegrasyonu kartıyla (ya da GET /api/spike) kontrol et.
Sonraki adımlar¶
- Tesis dışında bir ya da daha fazla hedef ekle (her bölüm aynı anda birçoğuna kopyalayabilir) ve kurtarma kitini Site dışı ve kurtarma altında anlatıldığı gibi sakla. S3 örneği birini adım adım gösterir.
- Bir hatanın sana ulaştığından Bildirimler ile emin ol.
- İşlerin ne zaman çalıştığına Zamanlamalar altında bak.
- Grubundaki her sunucuyu Android uygulaması ile telefonuna taşı.
- Bir VPS'i buradan bir düğümle yedekle.
- Adım adım örnekler yaygın işleri anlatır, Özellikler ise BombVault'un yaptığı her şeyi listeler.
- Bir kurulumu klonluyor ya da yeni bir makineye mi taşınıyorsun? Tüm yapılandırmanı Ayarları dışa / içe aktar kartıyla taşı. Bkz. Yapılandırma.
- Bir sorunla mı karşılaştın? Bkz. Sorun Giderme.