borgbackup - Online în cloud

PROGRAM:

NUME

borg - BorgBackup este un program de backup deduplicator cu compresie opțională și
criptare autentificată.

Borg constă dintr-un număr de comenzi. Fiecare comandă acceptă un număr de argumente și
Opțiuni. Următoarele secțiuni vor descrie fiecare comandă în detaliu.

GENERAL

Tip of log producție
Nivelul de jurnal al configurației de înregistrare încorporată este implicit la AVERTISMENT. Asta pentru ca
dorim ca Borg să fie în mare parte tăcut și să emită doar avertismente, erori și mesaje critice.

Niveluri de jurnal: DEBUG < INFO < AVERTISMENT < EROARE < CRITIC

Utilizare --depanare pentru a seta nivelul de jurnal DEBUG - pentru a obține depanare, informații, avertismente, eroare și nivel critic
ieșire.

Utilizare --info (Sau -v or --verbos) pentru a seta nivelul de jurnal INFO - pentru a obține informații, avertismente, eroare și
ieșire la nivel critic.

Utilizare --avertizare (implicit) pentru a seta nivelul de jurnal WARNING - pentru a primi avertismente, eroare și critice
nivel de ieșire.

Utilizare --eroare pentru a seta nivelul de jurnal ERROR - pentru a obține rezultatul de eroare și nivel critic.

Utilizare --critic pentru a seta nivelul CRITICAL log - pentru a obține rezultate la nivel critic.

În timp ce puteți seta diverse. niveluri de jurnal, nu vă așteptați ca fiecare comandă să dea diferit
ieșire pe diferite niveluri de jurnal - este doar o posibilitate.

AVERTISMENT:
Opțiunile --critical și --error sunt furnizate pentru completare, utilizarea lor nu este
recomandat deoarece este posibil să pierdeți informații importante.

AVERTISMENT:
În timp ce unele opțiuni (cum ar fi --statistici or --listă) va emite mai multe mesaje informative, tu
trebuie să utilizați nivelul de jurnal INFO (sau mai mic) pentru a le face să apară în ieșirea jurnalului. Utilizare -v sau un
configurație de logare.

Retur Coduri
Borg poate ieși cu următoarele coduri de întoarcere (rc):

0 = succes (înregistrat ca INFO)
1 = avertizare (operația a ajuns la finalul normal, dar au existat avertismente -
ar trebui să verificați jurnalul, înregistrat ca AVERTISMENT)
2 = eroare (cum ar fi o eroare fatală, o excepție locală sau la distanță, operația
nu a ajuns la sfârșitul normal, înregistrat ca EROARE)
128+N = ucis de semnalul N (de ex. 137 == ucidere -9)

Dacă utilizați --show-rc, codul de returnare este de asemenea înregistrat la nivelul indicat ca ultimul
intrare de jurnal.

Mediu inconjurator Variabile
Borg folosește câteva variabile de mediu pentru automatizare:

General:

BORG_REPO
Când este setată, utilizați valoarea pentru a oferi locația implicită a depozitului. În cazul în care o
comanda are nevoie de un parametru de arhivă, puteți prescurta ca ::Arhiva. În cazul în care un
comanda are nevoie de un parametru de depozit, îl puteți lăsa departe sau
prescurta ca ::, dacă este necesar un parametru de poziție.

BORG_PASSPHRASE
Când este setată, utilizați valoarea pentru a răspunde la întrebarea cu fraza de acces pentru criptat
arhive.

BORG_DISPLAY_PASSPHRASE
Când este setată, utilizați valoarea pentru a răspunde la „afișați fraza de acces pentru
de verificare" atunci când definiți o nouă expresie de acces pentru criptat
arhive.

BORG_LOGGING_CONF
Când este setat, utilizați numele de fișier dat ca START-configurație de logare în stil.

BORG_RSH
Când este setată, utilizați această comandă în loc de ssh. Acesta poate fi folosit pentru a specifica ssh
opțiuni, cum ar fi un fișier de identitate personalizat ssh -i /cale/la/privată/cheie. Vedea om
ssh pentru alte opțiuni.

TMPDIR unde sunt stocate fișierele temporare (ar putea avea nevoie de mult spațiu temporar pentru
unele operatii)

niste automat răspunzători (dacă a stabilit, ei în mod automat răspunde confirmare întrebări):

BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK=nu (Sau =da)
Pentru „Avertisment: Încercarea de a accesa un fișier necriptat necunoscut anterior
repertoriu"

BORG_RELOCATED_REPO_ACCESS_IS_OK=nu (Sau =da)
Pentru „Avertisment: depozitul de la locație... a fost localizat anterior la...”

BORG_CHECK_I_KNOW_WHAT_I_AM_DOING=NU (Sau =DA)
Pentru „Avertisment: „verificare --reparare” este o caracteristică experimentală care ar putea rezulta
în pierderea datelor.”

BORG_DELETE_I_KNOW_WHAT_I_AM_DOING=NU (Sau =DA)
Pentru „Ați solicitat să ștergeți complet depozitul inclusiv toate
arhivele pe care le conține:"

Notă: răspunsurile sunt sensibile la majuscule și minuscule. setarea unei valori de răspuns nevalidă poate oferi
răspunsul implicit sau vă întreabă în mod interactiv, în funcție de reîncercări
permise (sunt permise implicit). Așa că vă rugăm să vă testați scripturile în mod interactiv
înainte de a le face un script non-interactiv.

Directoare:

BORG_KEYS_DIR
Implicit la '~/.config/borg/keys'. Acest director conține chei pentru criptare
arhive.

BORG_CACHE_DIR
Implicit la '~/.cache/borg'. Acest director conține memoria cache locală și
ar putea avea nevoie de mult spațiu pentru a se ocupa de depozite mari).

Clădire:

BORG_OPENSSL_PREFIX
Adaugă directorul de fișiere antet OpenSSL dat la locațiile implicite
(setup.py).

BORG_LZ4_PREFIX
Adaugă directorul de fișiere antet LZ4 dat la locațiile implicite (setup.py).

Vă rugăm să rețineți:

· fii foarte atent când folosești afirmatorii „da”, avertismentele cu prompt există pentru /
securitatea/siguranța datelor dvs

· De asemenea, fiți foarte atenți când introduceți fraza de acces într-un script, asigurați-vă că are
permisiunile corespunzătoare pentru fișiere (de exemplu, modul 600, root:root).

Resursă Folosire
Borg ar putea folosi o mulțime de resurse, în funcție de dimensiunea setului de date pe care îl folosește
cu.

CPU: Nu va depăși 100% din 1 nucleu, deoarece codul este în prezent cu un singur thread.
În special, nivelurile de compresie zlib și lzma mai mari folosesc cantități semnificative de CPU
cicluri.

Memorie (BERBEC):
Indexul de bucăți și indexul de fișiere sunt citite în memorie din motive de performanță.
Compresie, mai ales Compresia lzma cu niveluri ridicate ar putea avea nevoie de cantități substanțiale
de memorie.

Temporar fișiere:
Citirea datelor și a metadatelor dintr-un depozit montat pe FUSE va consuma aproximativ
același spațiu ca și bucățile deduplicate folosite pentru a le reprezenta în depozit.

Cache fișiere:
Conține indexul de bucăți și indexul fișierelor (plus o colecție comprimată de
indicii de bucată cu o singură arhivă).

Bucăți index:
Proporțional cu cantitatea de bucăți de date din depozitul dvs. O mulțime de bucăți în depozitul tău
implică un indice mare de bucăți. Este posibil să modificați parametrii chunker (vezi create
Opțiuni).

Fişiere index:
Proporțional cu cantitatea de fișiere din ultima copie de rezervă. Poate fi oprit (vezi
creați opțiuni), dar următoarea copie de rezervă va fi mult mai lentă dacă o faceți.

De rețea:
Dacă depozitul dvs. este la distanță, toate sunt deduplicate (și opțional comprimate/
criptate) datele trebuie desigur să treacă peste conexiune (ssh: repo url). daca tu
utilizați un sistem de fișiere de rețea montat local, în plus, unele operațiuni de copiere utilizate
pentru suport pentru tranzacții, treceți și peste conexiune. Dacă faceți backup mai multor surse
la un singur depozit țintă, se produce trafic suplimentar pentru resincronizarea cache-ului.

În cazul în care sunteți interesat de mai multe detalii, vă rugăm să citiți documentația internă.

UM
Pentru afișarea cantităților, Borg are grijă să respecte convențiile obișnuite de scară. Disc
dimensiunile sunt afișate în zecimal, folosind puteri de zece (deci kB înseamnă 1000 de octeți). Pentru memorie
utilizare, binar prefixe sunt utilizate și sunt indicate folosind IEC binar prefixe, Folosind
puteri a doi (deci KiB înseamnă 1024 de octeți).

Data și Timp
Formatăm data și ora conform ISO-8601, adică: AAAA-LL-ZZ și HH:MM:SS (24h
ceas).

Pentru mai multe informații despre aceasta, consultați: https://xkcd.com/1179/

Dacă nu este specificat altfel, afișăm data și ora locală. Pe plan intern, stocăm și procesăm
data și ora ca UTC.

CREDIT INIT

utilizare: borg init [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-e {niciuna,keyfile,repokey}]
[REPERTORIU]

Inițializați un depozit gol

argumente poziționale:
REPOSITORY depozit de creat

argumente optionale:
-h, --help afișează acest mesaj de ajutor și ieși
--lucrare critică la nivel de jurnal CRITIC
--error lucrează la nivel de jurnal EROARE
--avertisment lucru la nivel de jurnal AVERTISMENT (implicit)
--info, -v, --verbose
lucru la nivel de jurnal INFO
--debug funcționează la nivel de jurnal DEBUG
--lock-wait N așteptați blocarea, dar max. N secunde (implicit: 1).
--show-rc arată/înregistrează codul de returnare (rc)
--no-files-cache nu încarcă/actualizează memoria cache a metadatelor fișierului folosită
detectează fișierele neschimbate
--umask M setați umask la M (local și la distanță, implicit: 0077)
--remote-path PATH setează calea la distanță la executabil (implicit: „borg”)
-e {niciun,fișier cheie,repokey}, --encryption {niciun,fișier cheie,repokey}
selectați modul cheie de criptare (implicit: „repokey”)

Descriere
Această comandă inițializează un depozit gol. Un depozit este un director de sistem de fișiere
care conțin datele deduplicate din zero sau mai multe arhive. Criptarea poate fi activată la
timpul de inițiere al depozitului.

Exemple
# Depozit local (implicit este să utilizați criptarea în modul repokey)
$ borg init /path/to/repo

# Depozit local (fără criptare)
$ borg init --encryption=none /path/to/repo

# Depozit la distanță (accesează un borg la distanță prin ssh)
$ borg init utilizator@nume gazdă:backup

# Depozit de la distanță (stochează cheia directorul de acasă)
$ borg init --encryption=keyfile user@hostname:backup

Note importante despre criptare:

Nu este recomandat să dezactivați criptarea. Criptarea depozitului vă protejează, de ex
în cazul în care un atacator are acces la depozitul dvs. de rezervă.

Dar aveți grijă la cheia/fraza de acces:

Dacă doriți securitate „doar frază de acces”, utilizați repokey modul. Cheia va fi stocată
în interiorul depozitului (în fișierul său „config”). În scenariul de atac menționat mai sus,
atacatorul va avea cheia (dar nu și fraza de acces).

Dacă doriți securitatea „frazei de acces și a avea cheia”, utilizați fişier cheie modul. Cheia va
fi stocat în directorul dvs. de acasă (în .config/borg/keys). În scenariul de atac,
atacatorul care are doar acces la depozitul dvs. nu va avea cheia (și, de asemenea, nu
frază de acces).

Faceți o copie de rezervă a fișierului cheie (fişier cheie mod) sau fișierul de configurare repo (repokey modul) și
păstrați-l într-un loc sigur, astfel încât să aveți în continuare cheia în cazul în care este coruptă sau pierdută. De asemenea
păstrați fraza de acces într-un loc sigur. Backup-ul care este criptat cu cheia respectivă nu va fi
te ajuta cu asta, desigur.

Asigurați-vă că utilizați o expresie de acces bună. Nu prea scurt, nici prea simplu. Criptarea reală /
cheia de decriptare este criptată cu / blocată de expresia dvs. de acces. Dacă un atacator vă prinde
cheie, nu o poate debloca și folosi fără să cunoască expresia de acces.

Fiți atenți la caracterele speciale sau non-ascii din fraza de acces:

· Borg procesează fraza de acces ca unicode (și o codifică ca utf-8), deci nu are
probleme de a trata chiar și cele mai ciudate personaje.

· DAR: asta nu se aplică neapărat configurației tale OS/VM/tastatură.

Deci, mai bine folosiți o expresie de acces lungă făcută din caractere ascii simple decât una care include
chestii non-ascii sau caractere care sunt greu/imposibile de introdus pe o altă tastatură
aspect.

Vă puteți schimba fraza de acces pentru depozitele existente în orice moment, aceasta nu va afecta
cheie de criptare/decriptare sau alte secrete.

CREDIT CREATE

utilizare: borg create [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-s] [-p] [--list]
[--filter STATUSCHARS] [-e PATTERN]
[--exclude-from EXCLUDEFILE] [--exclude-caches]
[--exclude-if-present FILENAME] [--keep-tag-files]
[-c SECONDS] [-x] [--numeric-owner]
[--timestamp aaaa-mm-zzThh:mm:ss]
[--chunker-params CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE]
[--ignore-inode] [-C COMPRESIARE] [--read-special] [-n]
CALEA ARHIVĂ [CALEA ...]

Creați o arhivă nouă

argumente poziționale:
ARHIVĂ numele arhivei de creat (trebuie să fie, de asemenea, valid
numele directorului)
PATH căi de arhivare

argumente optionale:
-h, --help afișează acest mesaj de ajutor și ieși
--lucrare critică la nivel de jurnal CRITIC
--error lucrează la nivel de jurnal EROARE
--avertisment lucru la nivel de jurnal AVERTISMENT (implicit)
--info, -v, --verbose
lucru la nivel de jurnal INFO
--debug funcționează la nivel de jurnal DEBUG
--lock-wait N așteptați blocarea, dar max. N secunde (implicit: 1).
--show-rc arată/înregistrează codul de returnare (rc)
--no-files-cache nu încarcă/actualizează memoria cache a metadatelor fișierului folosită
detectează fișierele neschimbate
--umask M setați umask la M (local și la distanță, implicit: 0077)
--remote-path PATH setează calea la distanță la executabil (implicit: „borg”)
-s, --stats imprimă statistici pentru arhiva creată
-p, --progress arată afișarea progresului în timpul creării arhivei,
afișând dimensiunile originale, comprimate și deduplicate,
urmat de Numărul de fișiere văzute și calea
în curs de procesare, implicit: False
--list scoate o listă cu elemente detaliate (fișiere, direcții, ...)
--filter STATUSCHARS afișează numai elementele cu caracterele de stare date
-e PATTERN, --exclude PATTERN
excludeți căile care se potrivesc cu PATTERN
--exclude-din EXCLUDEFILE
Citiți modele de excludere din EXCLUDEFILE, unul pe linie
--exclude-caches exclude directoarele care conțin un fișier CACHEDIR.TAG
(http://www.brynosaurus.com/cachedir/spec.html)
--exclude-dacă-prezent FILENAME
exclude directoarele care conțin fișierul specificat
--keep-tag-files păstrează fișierele etichete ale cache-urilor/directoarelor excluse
-c SECONDE, --checkpoint-interval SECONDE
scrieți punctul de control la fiecare SECONDS secunde (implicit: 300)
-x, --un sistem de fișiere
rămâneți în același sistem de fișiere, nu încrucișați punctele de montare
--numeric-owner stochează numai identificatorii numerici de utilizator și grup
--timestamp aaaa-mm-zzThh:mm:ss
specificați manual data/ora creării arhivei (UTC).
alternativ, dați un fișier/director de referință.
--chunker-params CHUNK_MIN_EXP,CHUNK_MAX_EXP,HASH_MASK_BITS,HASH_WINDOW_SIZE
specificați parametrii chunker. implicit: 19,23,21,4095
--ignore-inode ignoră datele inodelor din memoria cache a metadatelor fișierelor
detectează fișierele neschimbate.
-C COMPRESIA, --compresia COMPRESIA
selectați algoritmul de compresie (și nivelul): niciunul == nu
compresie (implicit), lz4 == lz4, zlib == zlib
(nivel implicit 6), zlib,0 .. zlib,9 == zlib (cu
nivel 0..9), lzma == lzma (nivel implicit 6), lzma,0 ..
lzma,9 == lzma (cu nivelul 0..9).
--read-special deschide și citește fișierele speciale ca și cum ar fi obișnuite
fișiere
-n, --dry-run nu creează o arhivă de rezervă

Descriere
Această comandă creează o arhivă de rezervă care conține toate fișierele găsite recursiv
parcurgând toate căile specificate. Arhiva nu va consuma aproape deloc spațiu pe disc pentru fișiere sau
părți ale fișierelor care au fost deja stocate în alte arhive.

Pentru a accelera tragerea de copii de rezervă prin sshfs și sisteme de fișiere de rețea similare care nu o fac
furnizați informații corecte despre inode, se poate folosi steag-ul --ignore-inode. Acest potențial
scade fiabilitatea detectării modificărilor, evitând în același timp citirea permanentă a tuturor fișierelor
aceste sisteme de fișiere.

Consultați rezultatul comenzii „borg help patterns” pentru mai mult ajutor cu privire la excluderea tiparelor.

Exemple
# Backup ~ / Documente într-o arhivă numită „documentele mele”
$ borg create /path/to/repo::my-documents ~ / Documente

# la fel, dar listează în mod verbos toate fișierele pe măsură ce le procesăm
$ borg create -v --list /path/to/repo::my-documents ~ / Documente

# Backup ~ / Documente și ~/src dar excludeți fișierele pyc
$ borg create /path/to/repo::my-files \
~ / Documente \
~/src \
--exclude „*.pyc”

# Backup directoarele de pornire, excluzând miniaturile imaginilor (adică numai
# /Acasă/*/.Thumbnails este exclus, nu /Acasă/*/*/.miniaturi)
$ borg create /path/to/repo::my-files / Home \
--exclude 're:^/Acasă/[^/]+/\.miniaturi/'

# Faceți același lucru folosind un model în stil shell
$ borg create /path/to/repo::my-files / Home \
--exclude 'sh:/Acasă/*/.miniaturi'

# Faceți o copie de rezervă a sistemului de fișiere rădăcină într-o arhivă numită „rădăcină-AAAA-LL-ZZ”
# utilizați compresia zlib (bună, dar lentă) - implicit nu este compresie
$ borg create -C zlib,6 /path/to/repo::root-{acum:%Y-%m-%d} / --one-file-system

# Depuneți un efort mare în deduplicarea fină granulară (gestionarea unor părți mari
# overhead, are nevoie de multă RAM și spațiu pe disc, vezi formula în interior
# docs - aceiași parametri ca borg < 1.0 sau attic):
$ borg create --chunker-params 10,23,16,4095 /path/to/repo::small /smallsstuff

# Faceți backup pentru un dispozitiv brut (nu trebuie să fie activ/în uz/montat în acel moment)
$ dd if=/dev/sdx bs=10M | borg create /path/to/repo::my-sdx -

# Fără compresie (implicit)
$ borg create /path/to/repo::arch ~

# Super rapid, compresie scăzută
$ borg create --compression lz4 /path/to/repo::arch ~

# Mai puțin rapidă, compresie mai mare (N = 0..9)
$ borg create --compression zlib,N /path/to/repo::arch ~

# Chiar mai lentă, compresie și mai mare (N = 0..9)
$ borg create --compression lzma,N /path/to/repo::arch ~

# Format tag-uri disponibile pentru numele arhivei:
# {acum}, {utcnow}, {fqdn}, {hostname}, {user}, {pid}
# adăugați nume de gazdă scurt, nume de utilizator de rezervă și ora unix curentă (secunde de la epocă)
$ borg create /path/to/repo::{hostname}-{user}-{now:%s} ~

CREDIT EXTRAGE

utilizare: borg extract [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [--list] [-n] [-e PATTERN]
[--exclude-from EXCLUDEFILE] [--numeric-owner]
[--strip-components NUMBER] [--stdout] [--sparse]
ARHIVE [CALEA [CALEA ...]]

Extrageți conținutul arhivei

argumente poziționale:
ARHIVE arhiva de extras
PATH căi de extras; modelele sunt acceptate

argumente optionale:
-h, --help afișează acest mesaj de ajutor și ieși
--lucrare critică la nivel de jurnal CRITIC
--error lucrează la nivel de jurnal EROARE
--avertisment lucru la nivel de jurnal AVERTISMENT (implicit)
--info, -v, --verbose
lucru la nivel de jurnal INFO
--debug funcționează la nivel de jurnal DEBUG
--lock-wait N așteptați blocarea, dar max. N secunde (implicit: 1).
--show-rc arată/înregistrează codul de returnare (rc)
--no-files-cache nu încarcă/actualizează memoria cache a metadatelor fișierului folosită
detectează fișierele neschimbate
--umask M setați umask la M (local și la distanță, implicit: 0077)
--remote-path PATH setează calea la distanță la executabil (implicit: „borg”)
--list scoate o listă cu elemente detaliate (fișiere, direcții, ...)
-n, --dry-run nu modifică de fapt niciun fișier
-e PATTERN, --exclude PATTERN
excludeți căile care se potrivesc cu PATTERN
--exclude-din EXCLUDEFILE
Citiți modele de excludere din EXCLUDEFILE, unul pe linie
--numeric-owner respectă numai identificatorii numerici de utilizator și grup
--strip-components NUMĂR
Eliminați numărul specificat de elemente ale căii de început.
Căile cu mai puține elemente vor fi silențioase
sărit.
--stdout scrie toate datele extrase în stdout
--sparse creează găuri în fișierul sparse de ieșire de la toate zero
bucăți

Descriere
Această comandă extrage conținutul unei arhive. În mod implicit, întreaga arhivă este
extrase, dar un subset de fișiere și directoare poate fi selectat prin trecerea unei liste de CAILE
ca argumente. Selecția fișierului poate fi restricționată în continuare utilizând --exclude opțiune.

Consultați rezultatul comenzii „borg help patterns” pentru mai mult ajutor cu privire la excluderea tiparelor.

Exemple
# Extrageți întreaga arhivă
$ borg extract /path/to/repo::my-files

# Extrageți întreaga arhivă și listați fișierele în timpul procesării
$ borg extract -v --list /path/to/repo::my-files

# Extrageți directorul „src”.
$ borg extract /path/to/repo::my-files home/USERNAME/src

# Extrageți directorul „src”, dar excludeți fișierele obiect
$ borg extract /path/to/repo::my-files home/USERNAME/src --exclude '*.o'

# Restaurați un dispozitiv brut (nu trebuie să fie activ/în uz/montat în acel moment)
$ borg extract --stdout /path/to/repo::my-sdx | dd of=/dev/sdx bs=10M

Notă: în prezent, extrage mereu scrie în il curent de lucru director (""),
așa că asigură-te că cd la locul potrivit înainte de a suna borg extrage.

CREDIT VERIFICA

utilizare: verificare borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [--repository-only] [--archives-only]
[--reparare] [--salvare-spațiu] [--ultimul N] [-P PREFIX]
[REPOSITORY_OR_ARCHIVE]

Verificați consistența depozitului

argumente poziționale:
REPOSITORY_OR_ARCHIVE
depozit sau arhivă pentru a verifica consistența

argumente optionale:
-h, --help afișează acest mesaj de ajutor și ieși
--lucrare critică la nivel de jurnal CRITIC
--error lucrează la nivel de jurnal EROARE
--avertisment lucru la nivel de jurnal AVERTISMENT (implicit)
--info, -v, --verbose
lucru la nivel de jurnal INFO
--debug funcționează la nivel de jurnal DEBUG
--lock-wait N așteptați blocarea, dar max. N secunde (implicit: 1).
--show-rc arată/înregistrează codul de returnare (rc)
--no-files-cache nu încarcă/actualizează memoria cache a metadatelor fișierului folosită
detectează fișierele neschimbate
--umask M setați umask la M (local și la distanță, implicit: 0077)
--remote-path PATH setează calea la distanță la executabil (implicit: „borg”)
--repository-only efectuează numai verificări ale depozitului
--archives-only efectuează numai verificări ale arhivelor
--reparare încercarea de a repara orice neconcordanțe găsite
--save-space lucrează mai lent, dar utilizând mai puțin spațiu
--last N verifică numai ultimele N arhive (implicit: toate)
-P PREFIX, --prefix PREFIX
luați în considerare numai numele de arhivă care încep cu acest prefix

Descriere
Comanda de verificare verifică consistența unui depozit și a arhivelor corespunzătoare.

Mai întâi, fișierele de date ale depozitului de bază sunt verificate:

· Pentru toate segmentele, magia segmentului (antetul) este bifată

· Pentru toate obiectele stocate în segmente, toate metadatele (de exemplu, crc și dimensiunea) și toate datele sunt
citit. Datele citite sunt verificate după dimensiune și CRC. Bit putregai și alte tipuri de accidentale
daunele pot fi detectate astfel.

· Dacă suntem în modul de reparare și este detectată o eroare de integritate pentru un segment, încercăm
recuperați cât mai multe obiecte din segment.

· În modul de reparare, se asigură că indexul este în concordanță cu datele stocate în
segmente.

· Dacă utilizați un server repo la distanță prin ssh:, verificarea repo este executată pe serverul repo
fără a provoca trafic de rețea semnificativ.

· Verificarea depozitului poate fi omisă folosind opțiunea --archives-only.

În al doilea rând, se verifică consistența și corectitudinea metadatelor arhivei:

· Este prezent manifestul repo? Dacă nu, este reconstruit din fragmente de metadate de arhivă (acest
necesită citirea și decriptarea tuturor metadatelor și datelor).

· Verificați dacă este prezentă fragmentul de metadate de arhivă. dacă nu, eliminați arhiva din manifest.

· Pentru toate fișierele (articolele) din arhivă, pentru toate bucățile la care se referă aceste fișiere, verificați dacă
bucată este prezentă (dacă nu și suntem în modul de reparare, înlocuiți-o cu o bucată de aceeași dimensiune
zerouri). Acest lucru necesită citirea metadatelor de arhivă și fișier, dar nu și a datelor.

· Dacă suntem în modul reparație și am verificat toate arhivele: ștergeți bucățile orfane din
repo.

· dacă utilizați un server repo la distanță prin ssh:, verificarea arhivei este executată pe client
mașină (deoarece dacă criptarea este activată, verificările vor necesita decriptare și asta
se face întotdeauna la nivelul clientului, deoarece va fi necesar accesul cu cheie).

· Verificările arhivei pot fi consumatoare de timp, ele pot fi sărite utilizând
--repository-only opțiunea.

CREDIT REDENUMIȚI

utilizare: borg redenumire [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH]
ARHIVE NEWNAME

Redenumiți o arhivă existentă

argumente poziționale:
ARHIVĂ arhiva pentru a redenumi
NEWNAME noul nume de arhivă de utilizat

argumente optionale:
-h, --help afișează acest mesaj de ajutor și ieși
--lucrare critică la nivel de jurnal CRITIC
--error lucrează la nivel de jurnal EROARE
--avertisment lucru la nivel de jurnal AVERTISMENT (implicit)
--info, -v, --verbose
lucru la nivel de jurnal INFO
--debug funcționează la nivel de jurnal DEBUG
--lock-wait N așteptați blocarea, dar max. N secunde (implicit: 1).
--show-rc arată/înregistrează codul de returnare (rc)
--no-files-cache nu încarcă/actualizează memoria cache a metadatelor fișierului folosită
detectează fișierele neschimbate
--umask M setați umask la M (local și la distanță, implicit: 0077)
--remote-path PATH setează calea la distanță la executabil (implicit: „borg”)

Descriere
Această comandă redenumește o arhivă din depozit.

Exemple
$ borg create /path/to/repo::archivename ~
$ borg list /path/to/repo
archivename Luni, 2016-02-15 19:50:19

$ borg redenumește /cale/la/repo::nume arhivă nume nou
$ borg list /path/to/repo
nume nou Luni, 2016-02-15 19:50:19

CREDIT LISTA

utilizare: listă borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [--short] [--list-format LISTFORMAT]
[-P PREFIX]
[REPOSITORY_OR_ARCHIVE]

Listați conținutul arhivei sau al depozitului

argumente poziționale:
REPOSITORY_OR_ARCHIVE
depozit/arhivă pentru a lista conținutul

argumente optionale:
-h, --help afișează acest mesaj de ajutor și ieși
--lucrare critică la nivel de jurnal CRITIC
--error lucrează la nivel de jurnal EROARE
--avertisment lucru la nivel de jurnal AVERTISMENT (implicit)
--info, -v, --verbose
lucru la nivel de jurnal INFO
--debug funcționează la nivel de jurnal DEBUG
--lock-wait N așteptați blocarea, dar max. N secunde (implicit: 1).
--show-rc arată/înregistrează codul de returnare (rc)
--no-files-cache nu încarcă/actualizează memoria cache a metadatelor fișierului folosită
detectează fișierele neschimbate
--umask M setați umask la M (local și la distanță, implicit: 0077)
--remote-path PATH setează calea la distanță la executabil (implicit: „borg”)
--short imprimă numai nume de fișiere/directoare, nimic altceva
--list-format LISTFORMAT
specificați formatul pentru listarea fișierelor de arhivă (implicit:
„{mode} {user:6} {group:6} {size:8d} {isomtime}
{path}{extra}{NEWLINE}") „{formatkeys}” special există
pentru a lista cheile disponibile
-P PREFIX, --prefix PREFIX
luați în considerare numai numele de arhivă care încep cu acest prefix

Descriere
Această comandă listează conținutul unui depozit sau al unei arhive.

Exemple
$ borg list /path/to/repo
Luni Luni, 2016-02-15 19:15:11
repo Luni, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
nume nou Luni, 2016-02-15 19:50:19
...

$ borg list /path/to/repo::root-2016-02-15
drwxr-xr-x root root 0 Mon, 2016-02-15 17:44:27 .
drwxrwxr-x root root 0 Luni, 2016-02-15 19:04:49 bin
-rwxr-xr-x root root 1029624 Thu, 2014-11-13 00:08:51 bin/bash
lrwxrwxrwx root root 0 Fri, 2015-03-27 20:24:26 bin/bzcmp -> bzdiff
-rwxr-xr-x root root 2140 vineri, 2015-03-27 20:24:22 bin/bzdiff
...

$ borg list /path/to/repo::archiveA --list-format="{mode} {user:6} {group:6} {size:8d} {isomtime} {path}{extra}{NEWLINE}"
drwxrwxr-x user user 0 Dum, 2015-02-01 11:00:00 .
drwxrwxr-x user user 0 Dum, 2015-02-01 11:00:00 cod
drwxrwxr-x user user 0 Dum, 2015-02-01 11:00:00 cod/myproject
-rw-rw-r-- utilizator utilizator 1416192 Dum, 2015-02-01 11:00:00 code/myproject/file.ext
...

# vezi ce se schimbă între arhive, în funcție de timpul de modificare a fișierului, dimensiunea și calea fișierului
$ borg list /path/to/repo::archiveA --list-format="{mtime:%s}{TAB}{size}{TAB}{path}{LF}" |sort -n > /tmp/list .arhivaA
$ borg list /path/to/repo::archiveB --list-format="{mtime:%s}{TAB}{size}{TAB}{path}{LF}" |sort -n > /tmp/list .arhivaB
$ diff -y /tmp/list.archiveA /tmp/list.archiveB
1422781200 0 . 1422781200 0 .
1422781200 0 cod 1422781200 0 cod
1422781200 0 cod/proiectul meu 1422781200 0 cod/proiectul meu
1422781200 1416192 code/myproject/file.ext | 1454664653 1416192 code/myproject/file.ext
...

CREDIT DELETE

utilizare: borg delete [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-p] [-s] [-c] [--save-space]
[ŢINTĂ]

Ștergeți un depozit sau o arhivă existentă

argumente poziționale:
TARGET arhiva sau depozitul de șters

argumente optionale:
-h, --help afișează acest mesaj de ajutor și ieși
--lucrare critică la nivel de jurnal CRITIC
--error lucrează la nivel de jurnal EROARE
--avertisment lucru la nivel de jurnal AVERTISMENT (implicit)
--info, -v, --verbose
lucru la nivel de jurnal INFO
--debug funcționează la nivel de jurnal DEBUG
--lock-wait N așteptați blocarea, dar max. N secunde (implicit: 1).
--show-rc arată/înregistrează codul de returnare (rc)
--no-files-cache nu încarcă/actualizează memoria cache a metadatelor fișierului folosită
detectează fișierele neschimbate
--umask M setați umask la M (local și la distanță, implicit: 0077)
--remote-path PATH setează calea la distanță la executabil (implicit: „borg”)
-p, --progress arată afișarea progresului în timp ce ștergeți o singură arhivă
-s, --stats imprimă statistici pentru arhiva ștearsă
-c, --cache-only șterge doar memoria cache locală pentru depozitul dat
--save-space lucrează mai lent, dar utilizând mai puțin spațiu

Descriere
Această comandă șterge o arhivă din depozit sau din depozitul complet. Disc
spațiul este recuperat în consecință. Dacă ștergeți întregul depozit, cache-ul local pentru
acesta (dacă există) este, de asemenea, șters.

Exemple
# ștergeți o singură arhivă de rezervă:
$ borg delete /path/to/repo::Monday

# ștergeți întregul depozit și memoria cache locală aferentă:
$ borg delete /path/to/repo
Ați solicitat să ȘTERGEȚI complet depozitul *inclusiv* toate arhivele pe care le conține:
repo Luni, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
nume nou Luni, 2016-02-15 19:50:19
Tastați „DA” dacă înțelegeți acest lucru și doriți să continuați: DA

CREDIT PRUNĂ USCATĂ

utilizare: borg prune [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-n] [-s] [--list]
[--keep-within WITHIN] [-H HOURLY] [-d DAILY] [-w WEEKLY]
[-m LUNAR] [-y ANUAL] [-P PREFIX] [--save-space]
[REPERTORIU]

Eliminați arhivele depozitului conform regulilor specificate

argumente poziționale:
DEPOZITARE depozit de tăiat

argumente optionale:
-h, --help afișează acest mesaj de ajutor și ieși
--lucrare critică la nivel de jurnal CRITIC
--error lucrează la nivel de jurnal EROARE
--avertisment lucru la nivel de jurnal AVERTISMENT (implicit)
--info, -v, --verbose
lucru la nivel de jurnal INFO
--debug funcționează la nivel de jurnal DEBUG
--lock-wait N așteptați blocarea, dar max. N secunde (implicit: 1).
--show-rc arată/înregistrează codul de returnare (rc)
--no-files-cache nu încarcă/actualizează memoria cache a metadatelor fișierului folosită
detectează fișierele neschimbate
--umask M setați umask la M (local și la distanță, implicit: 0077)
--remote-path PATH setează calea la distanță la executabil (implicit: „borg”)
-n, --dry-run nu schimbă depozitul
-s, --stats imprimă statistici pentru arhiva ștearsă
--list scoate o listă verbosă a arhivelor pe care le păstrează/tuă
--keep-within WITHIN păstrează toate arhivele în acest interval de timp
-HOURLY, --keep-hourly HOURLY
numărul de arhive orare de păstrat
-d ZILNIC, --keep-daily ZILNIC
numărul de arhive zilnice de păstrat
-w SĂPTĂMÂNAL, --keep-săptămânal SĂPTĂMÂNAR
numărul de arhive săptămânale de păstrat
-m MONTHLY, --keep-monthly LUNAR
numărul de arhive lunare de păstrat
-y ANUAL, --keep-yearly ANUAL
numărul de arhive anuale de păstrat
-P PREFIX, --prefix PREFIX
luați în considerare numai numele de arhivă care încep cu acest prefix
--save-space lucrează mai lent, dar utilizând mai puțin spațiu

Descriere
Comanda prune elimină un depozit prin ștergerea arhivelor care nu se potrivesc cu niciunul dintre
opțiunile de reținere specificate. Această comandă este utilizată în mod normal de scripturile de backup automate
dorind să păstreze un anumit număr de copii de rezervă istorice.

De exemplu, „-d 7” înseamnă să păstrați cea mai recentă copie de rezervă în fiecare zi, până la 7 cele mai recente
zilele cu copii de siguranță (zilele fără copii de siguranță nu sunt luate în considerare). Regulile se aplică de la oră
la anual, iar copiile de rezervă selectate de regulile anterioare nu sunt luate în considerare pentru cele de mai târziu
reguli. Timpul la care se finalizează fiecare copie de rezervă este utilizat în scopuri de tăiere. Date și ore
sunt interpretate în fusul orar local, iar săptămânile merg de luni până duminică. Precizând a
numărul negativ de arhive de păstrat înseamnă că nu există limită.

Opțiunea „--keep-within” ia un argument de forma „ ", unde char este "H",
„d”, „w”, „m”, „y”. De exemplu, „--keep-within 2d” înseamnă să păstrezi toate arhivele care au fost
creat în ultimele 48 de ore. „1m” înseamnă „31d”. Arhivele păstrate cu
această opțiune nu se ia în considerare pentru totalurile specificate de alte opțiuni.

Dacă un prefix este setat cu -P, atunci sunt luate în considerare numai arhivele care încep cu prefixul
pentru ștergere și numai acele arhive iau în calcul totalurile specificate de reguli.
In caz contrar, toate arhivele din depozit sunt candidate pentru ștergere!

Exemple
Fiți atenți, prune este o comandă potențial periculoasă, va elimina arhivele de rezervă.

Valoarea implicită a prune este să se aplice la toate arhive in il depozit cu excepția cazului în care îi restricționați
operare la un subset de arhive folosind --prefix. Atunci când se utilizează --prefix, fii atent la
alegeți un prefix bun - de exemplu, nu utilizați un prefix „foo” dacă nu doriți să se potrivească
„foobar”.

Se recomandă insistent să alergați întotdeauna prună uscată --funcție uscată ... mai întâi ca să vezi ce este
s-ar descurca fără ca ea să facă nimic.

# Păstrați 7 arhive de sfârșit de zi și 4 arhive suplimentare de sfârșit de săptămână.
# Efectuați o rulare uscată fără a șterge nimic.
$ borg prune --dry-run --keep-daily=7 --keep-weekly=4 /path/to/repo

# La fel ca mai sus, dar se aplică numai numelor de arhivă care încep cu „foo”:
$ borg prune --keep-daily=7 --keep-weekly=4 --prefix=foo /path/to/repo

# Păstrați 7 arhive de sfârșit de zi, 4 arhive suplimentare de sfârșit de săptămână,
# și o arhivă de sfârșit de lună pentru fiecare lună:
$ borg prune --keep-daily=7 --keep-weekly=4 --keep-monthly=-1 /path/to/repo

# Păstrați toate copiile de rezervă din ultimele 10 zile, 4 arhive suplimentare de sfârșit de săptămână,
# și o arhivă de sfârșit de lună pentru fiecare lună:
$ borg prune --keep-within=10d --keep-weekly=4 --keep-monthly=-1 /path/to/repo

CREDIT Informație

utilizare: borg info [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH]
ARHIVA

Afișați detaliile arhivei, cum ar fi spațiul pe disc utilizat

argumente poziționale:
ARHIVĂ arhiva pentru a afișa informații despre

argumente optionale:
-h, --help afișează acest mesaj de ajutor și ieși
--lucrare critică la nivel de jurnal CRITIC
--error lucrează la nivel de jurnal EROARE
--avertisment lucru la nivel de jurnal AVERTISMENT (implicit)
--info, -v, --verbose
lucru la nivel de jurnal INFO
--debug funcționează la nivel de jurnal DEBUG
--lock-wait N așteptați blocarea, dar max. N secunde (implicit: 1).
--show-rc arată/înregistrează codul de returnare (rc)
--no-files-cache nu încarcă/actualizează memoria cache a metadatelor fișierului folosită
detectează fișierele neschimbate
--umask M setați umask la M (local și la distanță, implicit: 0077)
--remote-path PATH setează calea la distanță la executabil (implicit: „borg”)

Descriere
Această comandă afișează câteva informații detaliate despre arhiva specificată.

Exemple
$ borg info /path/to/repo::root-2016-02-15
Nume: root-2016-02-15
Fingerprint: 57c827621f21b000a8d363c1e163cc55983822b3afff3a96df595077a660be50
Nume gazdă: numele gazdă meu
Nume utilizator: root
Ora (început): Luni, 2016-02-15 19:36:29
Ora (sfârșit): Luni, 2016-02-15 19:39:26
Linie de comandă: /usr/local/bin/borg create -v --list -C zlib,6 /path/to/repo::root-2016-02-15 / --one-file-system
Numărul de dosare: 38100

Dimensiune originală Dimensiune comprimată Dimensiune deduplicată
Această arhivă: 1.33 GB 613.25 MB 571.64 MB
Toate arhivele: 1.63 GB 853.66 MB 584.12 MB

Bucăți unice Bucăți totale
Indice de fragmente: 36858 48844

CREDIT MOUNT

utilizare: borg mount [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-f] [-o OPȚIUNI]
REPOSITORY_OR_ARCHIVE MOUNTPOINT

Montați arhiva sau un întreg depozit ca sistem de fișiere FUSE

argumente poziționale:
REPOSITORY_OR_ARCHIVE
depozit/arhivă de montat
MOUNTPOINT unde se montează sistemul de fișiere

argumente optionale:
-h, --help afișează acest mesaj de ajutor și ieși
--lucrare critică la nivel de jurnal CRITIC
--error lucrează la nivel de jurnal EROARE
--avertisment lucru la nivel de jurnal AVERTISMENT (implicit)
--info, -v, --verbose
lucru la nivel de jurnal INFO
--debug funcționează la nivel de jurnal DEBUG
--lock-wait N așteptați blocarea, dar max. N secunde (implicit: 1).
--show-rc arată/înregistrează codul de returnare (rc)
--no-files-cache nu încarcă/actualizează memoria cache a metadatelor fișierului folosită
detectează fișierele neschimbate
--umask M setați umask la M (local și la distanță, implicit: 0077)
--remote-path PATH setează calea la distanță la executabil (implicit: „borg”)
-f, --foreground rămâne în prim-plan, nu daemonize
-o OPȚIUNI Opțiuni suplimentare de montare

Descriere
Această comandă montează o arhivă ca sistem de fișiere FUSE. Acest lucru poate fi util pentru a naviga pe un
arhivarea sau restaurarea fișierelor individuale. Cu excepția cazului în care --prim plan opțiunea primește comanda
va rula în fundal până când sistemul de fișiere este demontat.

Exemple
$ borg mount /path/to/repo::root-2016-02-15 /tmp/mymountpoint
$ ls /tmp/mymountpoint
bin boot etc home lib lib64 lost+found media mnt opt ​​root sbin srv tmp usr var
$ fusermount -u /tmp/mymountpoint

CREDIT SCHIMBA-PAROLA

utilizare: borg change-passphrase [-h] [--critical] [--error] [--warning] [--info]
[--debug] [--lock-wait N] [--show-rc]
[--no-files-cache] [--umask M]
[--remote-path PATH]
[REPERTORIU]

Schimbați fraza de acces pentru fișierul cheie de depozit

argumente poziționale:
REPERTORIU

argumente optionale:
-h, --help afișează acest mesaj de ajutor și ieși
--lucrare critică la nivel de jurnal CRITIC
--error lucrează la nivel de jurnal EROARE
--avertisment lucru la nivel de jurnal AVERTISMENT (implicit)
--info, -v, --verbose
lucru la nivel de jurnal INFO
--debug funcționează la nivel de jurnal DEBUG
--lock-wait N așteptați blocarea, dar max. N secunde (implicit: 1).
--show-rc arată/înregistrează codul de returnare (rc)
--no-files-cache nu încarcă/actualizează memoria cache a metadatelor fișierului folosită
detectează fișierele neschimbate
--umask M setați umask la M (local și la distanță, implicit: 0077)
--remote-path PATH setează calea la distanță la executabil (implicit: „borg”)

Descriere
Fișierele cheie utilizate pentru criptarea depozitului sunt opțional protejate cu expresie de acces. Acest
comanda poate fi folosită pentru a schimba această expresie de acces.

Exemple
# Creați un depozit protejat cu fișiere cheie
$ borg init --encryption=keyfile -v /path/to/repo
Se inițializează depozitul la „/path/to/repo”
Introduceți o nouă expresie de acces:
Introduceți din nou aceeași expresie de acces:
Amintiți-vă fraza de acces. Datele dvs. vor fi inaccesibile fără el.
Tastați „/root/.config/borg/keys/mnt_backup” creat.
Păstrați această cheie în siguranță. Datele dvs. vor fi inaccesibile fără el.
Se sincronizează cache-ul fragmentelor...
Arhive: 0, cu Idx în cache: 0, cu Idx învechit: 0, fără Idx în cache: 0.
Doneaza.

# Schimbați fraza de acces pentru fișierul cheie
$ borg schimbare-fraza de acces -v /path/to/repo
Introduceți fraza de acces pentru cheia /root/.config/borg/keys/mnt_backup:
Introduceți o nouă expresie de acces:
Introduceți din nou aceeași expresie de acces:
Amintiți-vă fraza de acces. Datele dvs. vor fi inaccesibile fără el.
Cheie actualizată

CREDIT SERVI

utilizare: borg serve [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [--restrict-to-path PATH]

Începeți în modul server. Această comandă nu este de obicei folosită manual.

argumente optionale:
-h, --help afișează acest mesaj de ajutor și ieși
--lucrare critică la nivel de jurnal CRITIC
--error lucrează la nivel de jurnal EROARE
--avertisment lucru la nivel de jurnal AVERTISMENT (implicit)
--info, -v, --verbose
lucru la nivel de jurnal INFO
--debug funcționează la nivel de jurnal DEBUG
--lock-wait N așteptați blocarea, dar max. N secunde (implicit: 1).
--show-rc arată/înregistrează codul de returnare (rc)
--no-files-cache nu încarcă/actualizează memoria cache a metadatelor fișierului folosită
detectează fișierele neschimbate
--umask M setați umask la M (local și la distanță, implicit: 0077)
--remote-path PATH setează calea la distanță la executabil (implicit: „borg”)
--restrict-to-path PATH
restricționați accesul la depozit la PATH

Descriere
Această comandă pornește un proces de server de depozit. Această comandă nu este de obicei folosită
manual.

Exemple
borg serve are suport special pentru comenzile forțate ssh (vezi chei_autorizate exemplu
mai jos): va detecta că utilizați o astfel de comandă forțată și va extrage valoarea lui
--restrict-to-path Opțiuni). Apoi va analiza comanda originală care a venit de la
client, se asigură că este și borg servi și să impună restricțiile de cale așa cum sunt date de
comanda forțată. În acest fel, alte opțiuni oferite de client (cum ar fi --info or --umask)
sunt păstrate (și nu sunt fixate prin comanda forțată).

# Permiteți unei perechi de taste SSH să ruleze doar borg și să aibă acces numai la /path/to/repo.
# Utilizați opțiunile cheie pentru a dezactiva funcționalitatea SSH inutilă și potențial periculoasă.
# Acest lucru va ajuta la securizarea unui sistem automat de backup la distanță.
$ pisica ~/.ssh/authorized_keys
command="borg serve --restrict-to-path /path/to/repo",no-pty,no-agent-forwarding,no-port-forwarding,no-X11-forwarding,no-user-rc ssh-rsa AAAAB3[...]

CREDIT ACTUALIZARE

utilizare: upgrade borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-p] [-n] [-i]
[REPERTORIU]

actualizați un depozit de la o versiune anterioară

argumente poziționale:
REPOSITORY calea către depozitul care urmează să fie actualizat

argumente optionale:
-h, --help afișează acest mesaj de ajutor și ieși
--lucrare critică la nivel de jurnal CRITIC
--error lucrează la nivel de jurnal EROARE
--avertisment lucru la nivel de jurnal AVERTISMENT (implicit)
--info, -v, --verbose
lucru la nivel de jurnal INFO
--debug funcționează la nivel de jurnal DEBUG
--lock-wait N așteptați blocarea, dar max. N secunde (implicit: 1).
--show-rc arată/înregistrează codul de returnare (rc)
--no-files-cache nu încarcă/actualizează memoria cache a metadatelor fișierului folosită
detectează fișierele neschimbate
--umask M setați umask la M (local și la distanță, implicit: 0077)
--remote-path PATH setează calea la distanță la executabil (implicit: „borg”)
-p, --progress arată afișarea progresului în timpul actualizării depozitului
-n, --dry-run nu schimbă depozitul
-i, --inplace depozit de rescrie în loc, fără șansa de a merge
înapoi la versiunile mai vechi ale depozitului.

Descriere
Actualizați un depozit Borg existent. În prezent, aceasta acceptă transformarea unei mansardă
depozit la Borg și ajută, de asemenea, la conversia Borg 0.xx la 1.0.

În prezent, numai depozitele LOCAL pot fi actualizate (numărul #465).

Acesta va schimba șirurile magice din segmentele depozitului pentru a se potrivi cu noua magie Borg
siruri de caractere. Fișierele cheie găsite în $ATTIC_KEYS_DIR sau ~/.mansarda/chei/ va fi de asemenea convertit
și copiat în $BORG_KEYS_DIR sau ~/.config/borg/keys.

Fișierele cache sunt convertite, din $ATTIC_CACHE_DIR sau ~/.cache/mansarda la $BORG_CACHE_DIR
or ~/.cache/borg, dar aspectul cache-ului dintre Borg și Attic s-a schimbat, așa că este posibil
prima copie de rezervă după conversie durează mai mult decât se aștepta din cauza resincronizării cache-ului.

Upgrade-ul ar trebui să poată fi reluat dacă este întrerupt, deși va continua să se repete peste tot
segmente. Dacă doriți să începeți de la zero, utilizați borg șterge peste depozitul copiat către
asigurați-vă că fișierele cache sunt, de asemenea, eliminate:
borg șterge borg

dacă nu --la loc este specificat, procesul de actualizare creează mai întâi o copie de rezervă a
depozit, în REPOSITORY.upgrade-DATETIME, folosind hardlinks. Acest lucru durează mai mult decât în
plasează upgrade-uri, dar este mult mai sigur și oferă informații despre progres (spre deosebire de cp -la).
Odată ce sunteți mulțumit de conversie, puteți distruge în siguranță copia de rezervă.

AVERTISMENT: Executarea actualizării la loc va face copia curentă inutilizabilă cu mai vechi
versiune, fără nicio modalitate de a reveni la versiunile anterioare. Acest lucru vă poate deteriora PERMANENT
REPERTORIU! Mansarda NU POATE CITIRE DEPOZITARELE BORG, deoarece șirurile magice s-au schimbat. Tu
au fost avertizate.

Exemple
# Actualizați depozitul borg la cea mai recentă versiune.
$ borg upgrade -v /path/to/repo
realizarea unei copii hardlink în /path/to/repo.upgrade-2016-02-15-20:51:55
deschidere depozit mansardă cu borg și converting
nu a fost găsit niciun fișier cheie pentru depozit
conversia indexului repo /path/to/repo/index.0
conversia 1 segment...
conversia borg 0.xx în curent borg
nu a fost găsit niciun fișier cheie pentru depozit

DIVERSE AJUTOR

borg ajutor modele
Modelele de excludere acceptă patru stiluri separate, fnmatch, shell, expresii regulate și
prefixe de cale. Dacă sunt urmate de două puncte (':'), sunt folosite primele două caractere ale unui model
ca selector de stil. Selectarea explicită a stilului este necesară atunci când este un stil care nu este implicit
dorit sau când modelul dorit începe cu două caractere alfanumerice urmate de a
colon (ex aa:ceva/*).

Fnmatch, selector fm:
Aceste modele folosesc o variantă de sintaxă a modelului shell, cu „*” care se potrivește cu orice număr de
personaje, '?' care se potrivește oricărui caracter, „[...]” care se potrivește cu orice caracter
specificat, inclusiv intervale și „[!...]” care se potrivește cu orice caracter nespecificat. Pentru
scopul acestor modele, separatorul de cale ('' pentru Windows și '' pe alte sisteme)
nu este tratat special. Închideți meta-caracterele între paranteze pentru o potrivire literală (de ex
[?] pentru a se potrivi cu caracterul literal ?). Pentru ca o cale să se potrivească cu un model, trebuie
se potrivesc complet de la început până la sfârșit sau trebuie să se potrivească de la început până chiar înaintea unei căi
separator. Cu excepția căii rădăcină, căile nu se vor termina niciodată în separatorul de căi când
se încearcă potrivirea. Astfel, dacă un model dat se termină într-un separator de cale, un „*” este
atașat înainte de a se încerca potrivirea.

Modele în stil cochilie, selector SH:
Ca și modelele fnmatch, acestea sunt similare cu modelele shell. Diferența este că
modelul poate include ** / pentru potrivirea cu zero sau mai multe niveluri de director, * pentru potrivirea zero
sau mai multe caractere arbitrare, cu excepția oricărui separator de cale.

Expresii regulate, selector re:
Sunt acceptate expresii regulate similare cu cele găsite în Perl. Spre deosebire de modelele de scoici
expresiile regulate nu sunt necesare pentru a se potrivi cu calea completă și orice potrivire subșir
e suficient. Este recomandat să ancorați modelele la început ('^'), la
sfârşitul ('$') sau ambele. Separatoare de căi ('' pentru Windows și '/' pe alte sisteme) în căi
sunt întotdeauna normalizate la o bară oblică ('/') înainte de a aplica un model. Obisnuit
sintaxa expresiei este descrisă în Piton documentaţie pentru il re modul.

Calea prefixului, selector pp:
Acest stil de model este util pentru a potrivi subdirectoare întregi. Modelul pp:/date/bar
meciuri /data/bara și tot ce este în ea.

Excluderile pot fi trecute prin opțiunea din linia de comandă --exclude. Când este folosit din interiorul a
shell modelele trebuie citate pentru a le proteja de expansiune.

--exclude-din opțiunea permite încărcarea modelelor de excludere dintr-un fișier text cu unul
model pe linie. Linii goale sau care încep cu semnul numeric („#”) după eliminare
spațiile albe de la ambele capete sunt ignorate. Prefixul opțional al selectorului de stil este de asemenea acceptat
pentru modelele încărcate dintr-un fișier. Datorită căilor de eliminare a spațiilor albe cu spații albe la
începutul sau sfârșitul pot fi excluse numai folosind expresii regulate.

Exemple:

# Excludeți „/home/user/file.o” dar nu „/home/user/file.odt”: $ borg create -e '
*
.o' backup /

# Excludeți „/home/user/junk” și „/home/user/subdir/junk” dar # nu
'/home/user/importantjunk' sau '/etc/junk': $ borg create -e '/Acasă/
*
/backup nedorit /

# Excludeți conținutul „/home/user/cache”, dar nu și directorul în sine: $ borg create
-e /home/user/cache/backup/

# Fișierul „/home/user/cache/important” este nu copiat de rezervă: $ borg create -e
/home/user/cache/ backup / /home/user/cache/important

# Conținutul directoarelor din '/ Home' nu se face backup atunci când numele lor # se termină în
'.tmp' $ borg create --exclude 're:^/Acasă/[^/]+.tmp/' backup /

# Încărcați excluderile din fișierul $ cat >exclude.txt < /Acasă//deșeuri * .tmp
fm:aa:ceva/ re:^/Acasă/[^/].tmp/ sh:/Acasă/
*
/.thumbnails EOF $ borg create --exclude-from exclude.txt backup /

REMEDIERE COMANDE

Mai sunt câteva comenzi (toate care încep cu „debug-”) care sunt toate nu destinate pentru
normală. utilizare și potenţial foarte periculos dacă este folosit incorect.

Ele există pentru a îmbunătăți capacitățile de depanare fără acces direct la sistem, de exemplu în caz
te confrunți vreodată cu o defecțiune gravă. Folosește-le doar dacă știi ce faci sau
dacă un dezvoltator Borg de încredere vă spune ce să faceți.

ADIŢIONAL NOTE

Aici sunt diverse. note despre subiecte care poate nu sunt acoperite suficient de detaliat în utilizare
secţiune.

Articol steaguri
borg crea -v --listă scoate o listă detaliată a tuturor fișierelor, directoarelor și altor fișiere
elementele de sistem pe care le-a luat în considerare (indiferent dacă au avut sau nu modificări de conținut). Pentru fiecare
element, prefixează un steag cu o singură literă care indică tipul și/sau starea articolului.

Dacă sunteți interesat doar de un subset al acelei rezultate, puteți da de ex --filter=AME și
va afișa numai fișierele obișnuite cu starea A, M sau E (vezi mai jos).

Un caracter majuscul reprezintă starea unui fișier obișnuit în raport cu „fișierele”
cache (nu este relativ la repo -- aceasta este o problemă dacă memoria cache a fișierelor nu este utilizată).
Metadatele sunt stocate în orice caz și pentru „A” și „M” sunt stocate și noi bucăți de date. Pentru
„U” toate bucățile de date se referă la bucăți deja existente.

· „A” = fișier obișnuit, adăugat (vezi și a_status_oddity în Întrebări frecvente)

· „M” = fișier obișnuit, modificat

· „U” = fișier obișnuit, neschimbat

· „E” = fișier obișnuit, a apărut o eroare în timpul accesării/citirii acest fişier

Un caracter mic înseamnă un alt tip de fișier decât un fișier obișnuit, de obicei borg doar
își stochează metadatele:

· „d” = director

· „b” = dispozitiv de blocare

· „c” = dispozitiv char

· „h” = fișier obișnuit, hardlink (la inoduri deja văzute)

· „s” = legătură simbolică

· 'f' = fifo

Alte steaguri folosite includ:

· „i” = datele de rezervă au fost citite de la intrarea standard (stdin)

· '-' = rulare uscată, elementul a fost nu susținut

· '?' = lipsește codul de stare (dacă vedeți acest lucru, vă rugăm să trimiteți un raport de eroare!)

--chunker-params
Parametrii chunker influențează modul în care fișierele de intrare sunt tăiate în bucăți (bucăți), care sunt apoi
luate în considerare pentru deduplicare. De asemenea, au un impact mare asupra utilizării resurselor (RAM și disc
spaţiu) deoarece cantitatea de resurse necesare este (de asemenea) determinată de cantitatea totală de
bucăți din depozit (vezi Indexuri / Caches memorie folosire pentru detalii).

--chunker-params=10,23,16,4095 are ca rezultat o deduplicare cu granulație fină și creează un mare
cantitate de bucăți și, prin urmare, utilizează o mulțime de resurse pentru a le gestiona. Acest lucru este bun pentru
volume de date relativ mici și dacă mașina are o cantitate bună de RAM și disc liber
spațiu.

--chunker-params=19,23,21,4095 (implicit) are ca rezultat o deduplicare grosieră și
creează o cantitate mult mai mică de bucăți și astfel utilizează mai puține resurse. Acest lucru este bun pentru
volume de date relativ mari și dacă mașina are o cantitate relativ mică de RAM liberă și
spatiu pe disc.

Dacă ați făcut deja niște arhive într-un depozit și apoi modificați parametrii chunker,
acest lucru, desigur, are un impact asupra deduplicarii, deoarece bucățile vor fi tăiate diferit.

În cel mai rău caz (toate fișierele sunt mari și au fost atinse între copii de rezervă), acesta va stoca
tot conținutul din nou în depozit.

De obicei, nu este chiar atât de rău:

· de obicei, majoritatea fișierelor nu sunt atinse, așa că va reutiliza doar bucățile vechi pe care le are deja
în repo

· fișierele mai mici decât dimensiunea minimă (atât cea veche, cât și cea nouă) rezultă într-o singură bucată
oricum, deci bucățile rezultate sunt aceleași și se va aplica deduplicarea

Dacă schimbați parametrii chunker pentru a salva resurse pentru un depozit existent care are deja unele
arhivelor de rezervă, veți observa un efect din ce în ce mai mare în timp, când tot mai multe fișiere
au fost atinse și depozitate din nou folosind dimensiunea mai mare și toate referirile la
bucăți mai mici mai vechi au fost eliminate (prin ștergerea / tăierea arhivelor).

Dacă doriți să vedeți un efect imediat mare asupra utilizării resurselor, mai bine începeți unul nou
depozit la modificarea parametrilor chunker.

Pentru mai multe detalii, consultați chunker_details.

--citește-special
Optiunea --citește-special nu este destinat pentru normal, la nivel de sistem de fișiere (complet sau
copii de rezervă parțial recursive). Oferiți această opțiune doar dacă doriți să faceți ceva mai degrabă
... special -- și dacă ați ales manual unele fișiere pe care doriți să le tratați în acest fel.

borg crea --citește-special va deschide toate fișierele fără a face niciun tratament special
în funcție de tipul fișierului (singura excepție aici sunt directoarele: vor fi recursate
în). Imaginează-ți ce se întâmplă dacă o faci pisică nume de fișier --- conținutul pe care îl veți vedea acolo
este ceea ce borg va face backup pentru acel nume de fișier.

Deci, de exemplu, legăturile simbolice vor fi urmate, conținutul dispozitivului bloc va fi citit, conductele denumite
/ Socket-urile domeniului UNIX vor fi citite.

Trebuie să fiți atenți la ceea ce dați ca nume de fișier când utilizați --citește-special, de ex. dacă
tu dai /dev/zero, backup-ul dvs. nu se va termina niciodată.

Metadatele fișierelor date sunt salvate așa cum ar fi salvate fără --citește-special (ex. ei
numele, dimensiunea sa [ar putea fi 0], modul său etc.) -- dar, în plus, și conținutul citit
din ea va fi salvat pentru ea.

Restaurarea conținutului unor astfel de fișiere este în prezent acceptată numai pe rând prin --stdout
opțiunea (și trebuie să redirecționați stdout către oriunde va merge, poate direct într-un
fișierul dispozitiv existent la alegerea dvs. sau indirect prin dd).

Exemplu
Imaginați-vă că ați făcut niște instantanee ale volumelor logice (LV) pe care doriți să le faceți backup.

NOTĂ:
Pentru unele scenarii, aceasta este o metodă bună de a obține consistență „ca un accident” (eu o numesc
asemănător unui accident, deoarece este același lucru pe care l-ați obține dacă ați apăsa doar butonul de resetare sau
mașina dvs. s-ar prăbuși brusc și complet). Acest lucru este mai bine decât lipsa de consistență
deloc și o metodă bună pentru unele cazuri de utilizare, dar probabil că nu este suficient de bună dacă aveți
bazele de date care rulează.

Apoi creați o arhivă de rezervă a tuturor acestor instantanee. Procesul de backup va vedea a
starea „înghețată” a volumelor logice, în timp ce procesele funcționează în volumele originale
continuați modificarea datelor stocate acolo.

Adăugați, de asemenea, rezultatul lui lvdisplay la backup, astfel încât să puteți vedea dimensiunile LV în caz că
trebuie vreodată să le recreați și să le restaurați.

După finalizarea copiei de rezervă, eliminați din nou instantaneele.

$ # creați instantanee aici
$ lvdisplay > lvdisplay.txt
$ borg create --read-special /path/to/repo::arch lvdisplay.txt /dev/vg0/*-snapshot
$ # eliminați instantaneele aici

Acum, să vedem cum să restabilim unele LV-uri dintr-o astfel de copie de rezervă.

$ borg extract /path/to/repo::arch lvdisplay.txt
$ # creați aici LV-uri goale cu dimensiunile corecte (căutați în lvdisplay.txt).
$ # presupunem că ați creat o rădăcină goală și un LV home și le-ați suprascris acum:
$ borg extract --stdout /path/to/repo::arch dev/vg0/root-snapshot > /dev/vg0/root
$ borg extract --stdout /path/to/repo::arch dev/vg0/home-snapshot > /dev/vg0/home

Numai pentru atașare mod
Un depozit poate fi făcut „numai pentru atașare”, ceea ce înseamnă că Borg nu va suprascrie niciodată sau
ștergeți datele comise. Acest lucru este util pentru scenariile în care mai multe mașini fac copii de rezervă la a
server de backup central folosind borg servi, deoarece o mașină piratată nu poate șterge copii de rezervă
permanent.

Pentru a activa modul numai pentru atașare, editați depozitul config fișier și adăugați o linie append_only=1
la [repertoriu] secțiune (sau editați linia dacă există).

În modul numai adăugare, Borg va crea un jurnal de tranzacții în tranzacții dosar, unde
fiecare linie este o tranzacție și un marcaj de timp UTC.

Exemplu
Să presupunem că un atacator a șters de la distanță toate copiile de rezervă, dar depozitul dvs. a fost doar pentru adăugare
modul. Un jurnal de tranzacții în această situație poate arăta astfel:

tranzacția 1, ora UTC 2016-03-31T15:53:27.383532
tranzacția 5, ora UTC 2016-03-31T15:53:52.588922
tranzacția 11, ora UTC 2016-03-31T15:54:23.887256
tranzacția 12, ora UTC 2016-03-31T15:55:54.022540
tranzacția 13, ora UTC 2016-03-31T15:55:55.472564

Din jurnalele dvs. de securitate concluzionați că atacatorul a obținut acces la 15:54:00 și toate
copiile de rezervă au fost șterse sau înlocuite cu copii de rezervă compromise. Din jurnal știi că
tranzacțiile 11 și ulterioare sunt compromise. Rețineți că ID-ul tranzacției este numele
ultimul fișier în tranzacție. De exemplu, tranzacția 11 se întinde pe fișierele de la 6 la 11.

Într-un atac real, probabil că veți dori să păstrați intact depozitul compromis pentru a le analiza
ceea ce a încercat atacatorul să realizeze. De asemenea, este o idee bună să faceți această copie pentru orice eventualitate
ceva nu merge bine în timpul recuperării. Deoarece recuperarea se face prin ștergerea unor fișiere, a
copie hard link (cp -la) este suficient.

Primul pas pentru a reseta depozitul la tranzacția 5, ultima fără compromisuri
tranzacție, este de a elimina indicii.N și index.N fișiere din depozit (aceste două fișiere
sunt întotdeauna consumabile). În acest exemplu, N este 13.

Apoi eliminați sau mutați toate fișierele de segment din directoarele de segmente în date / incepand cu
fisierul 6:

rm data/**/{6..13}

Asta e tot.

Inconvenientele
Deoarece datele sunt doar atașate și nimic nu este șters, comenzi de genul prună uscată or șterge nu va elibera
spațiu pe disc, ei doar etichetează datele ca fiind șterse într-o nouă tranzacție.

Rețineți că puteți merge înainte și înapoi între operarea normală și cea de numai adăugare prin editare
fișierul de configurare, nu este o „călătorie unică”.

Mai departe Considerații
Modul numai pentru adăugare nu este respectat de alte instrumente decât Borg. rm încă mai lucrează pe
repertoriu. Asigurați-vă că mașinile client de rezervă pot accesa depozitul numai prin
borg servi.

Asigurați-vă că nu este posibil accesul de la distanță dacă depozitul este setat temporar la normal
mod pentru, de exemplu, tăierea obișnuită.

Protecții suplimentare pot fi implementate, dar sunt în afara domeniului de aplicare a Borgs. De exemplu, fișier
instantanee de sistem sau împachetare borg servi pentru a seta permisiuni speciale sau ACL-uri pentru date noi
fișiere.

Utilizați borgbackup online folosind serviciile onworks.net