borgbackup - Online sa Cloud

PROGRAMA:

NAME

borg - Ang BorgBackup ay isang deduplicate na backup program na may opsyonal na compression at
napatunayang pag-encrypt.

Ang Borg ay binubuo ng isang bilang ng mga utos. Ang bawat utos ay tumatanggap ng isang bilang ng mga argumento at
mga pagpipilian. Ilalarawan ng mga sumusunod na seksyon ang bawat utos nang detalyado.

PANGKALAHATAN

uri of mag-log output
Ang antas ng log ng builtin logging configuration ay nagde-default sa BABALA. Ito ay dahil ang
gusto naming halos tahimik si Borg at mga babala, error at kritikal na mensahe lang ang ilalabas.

Mga antas ng log: DEBUG < IMPORMASYON < BABALA < ERROR < KRITIKAL

paggamit --debug upang itakda ang antas ng log ng DEBUG - upang makakuha ng debug, impormasyon, babala, error at kritikal na antas
output.

paggamit --impormasyon (O -v or --verbose) para itakda ang INFO log level - para makakuha ng impormasyon, babala, error at
kritikal na antas ng output.

paggamit --babala (default) para itakda ang WARNING log level - para makakuha ng babala, error at kritikal
antas ng output.

paggamit --mali para itakda ang ERROR log level - para makakuha ng error at critical level output.

paggamit --mapanganib upang itakda ang KRITIKAL na antas ng log - upang makakuha ng kritikal na antas ng output.

Habang maaari mong itakda ang misc. mga antas ng log, huwag asahan na ang bawat utos ay magbibigay ng iba't ibang
output sa iba't ibang antas ng log - ito ay isang posibilidad lamang.

BABALA:
Ang mga pagpipilian --kritikal at --error ay ibinigay para sa pagkakumpleto, ang kanilang paggamit ay hindi
inirerekomenda dahil maaaring makaligtaan mo ang mahalagang impormasyon.

BABALA:
Habang ang ilang mga pagpipilian (tulad ng --stats or --listahan) ay maglalabas ng higit pang mga mensaheng nagbibigay-kaalaman, ikaw
kailangang gumamit ng INFO (o mas mababa) na antas ng log upang ipakita ang mga ito sa output ng log. Gamitin -v o isang
pagsasaayos ng pag-log.

Bumalik mga code
Maaaring lumabas si Borg gamit ang mga sumusunod na return code (rc):

0 = tagumpay (naka-log bilang INFO)
1 = babala (naabot ng operasyon ang normal nitong pagtatapos, ngunit may mga babala -
dapat mong suriin ang log, na naka-log bilang BABALA)
2 = error (tulad ng isang nakamamatay na error, isang lokal o malayong pagbubukod, ang operasyon
hindi umabot sa normal nitong pagtatapos, na naka-log bilang ERROR)
128+N = pinatay ng signal N (eg 137 == pumatay -9)

Kung gumagamit ka ng --ipakita-rc, ang return code ay naka-log din sa ipinahiwatig na antas bilang ang huli
entry sa log.

kapaligiran Variable
Gumagamit si Borg ng ilang variable ng kapaligiran para sa automation:

General:

BORG_REPO
Kapag itinakda, gamitin ang value para ibigay ang default na lokasyon ng repository. Kung ang
Ang command ay nangangailangan ng isang parameter ng archive, maaari mong paikliin bilang ::archive. Kung ang
Ang command ay nangangailangan ng isang parameter ng repositoryo, maaari mo itong iwanan o
paikliin bilang ::, kung kinakailangan ang isang positional na parameter.

BORG_PASSPHRASE
Kapag itinakda, gamitin ang value para sagutin ang passphrase na tanong para sa naka-encrypt
repositoriya.

BORG_DISPLAY_PASSPHRASE
Kapag itinakda, gamitin ang value para sagutin ang "ipakita ang passphrase para sa
verification" na tanong kapag tumutukoy ng bagong passphrase para sa naka-encrypt
repositoriya.

BORG_LOGGING_CONF
Kapag nakatakda, gamitin ang ibinigay na filename bilang MAGSIMULA-style logging configuration.

BORG_RSH
Kapag nakatakda, gamitin ang command na ito sa halip na SSH. Ito ay maaaring gamitin upang tukuyin ang ssh
mga opsyon, gaya ng custom na identity file SSH -i /path/to/private/key. Tingnan lalaki
SSH para sa iba pang mga pagpipilian.

TMPDIR kung saan naka-imbak ang mga pansamantalang file (maaaring mangailangan ng maraming pansamantalang espasyo para sa
ilang mga operasyon)

ilan awtomatik mga sumasagot (kung itakda, sila awtomatikong sagutin pagpapatibay mga tanong):

BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK=no (O =oo)
Para sa "Babala: Pagtatangkang i-access ang isang dati nang hindi kilalang hindi naka-encrypt
imbakan"

BORG_RELOCATED_REPO_ACCESS_IS_OK=hindi (O =oo)
Para sa "Babala: Ang imbakan sa lokasyon ... ay dating matatagpuan sa ..."

BORG_CHECK_I_NOW_WHAT_I_AM_GAWAIN=HINDI (O =OO)
Para sa "Babala: 'check --repair' ay isang pang-eksperimentong tampok na maaaring magresulta
sa pagkawala ng data."

BORG_DELETE_I_KNOW_WHAT_I_AM_DOING=HINDI (O =OO)
Para sa "Hiniling mong ganap na I-DELETE ang repositoryo kabilang lahat
archive na naglalaman ng:"

Tandaan: case sensitive ang mga sagot. maaaring magbigay ang pagtatakda ng di-wastong halaga ng sagot
ang default na sagot o magtanong sa iyo nang interactive, depende sa kung ang mga muling pagsubok ay
pinapayagan (pinahihintulutan sila bilang default). Kaya't mangyaring subukan ang iyong mga script nang interactive
bago gawin ang mga ito ng isang non-interactive na script.

Mga Direktoryo:

BORG_KEYS_DIR
Default sa '~/.config/borg/keys'. Ang direktoryo na ito ay naglalaman ng mga susi para sa naka-encrypt
repositoriya.

BORG_CACHE_DIR
Default sa '~/.cache/borg'. Ang direktoryo na ito ay naglalaman ng lokal na cache at
Maaaring kailanganin ng maraming espasyo para sa pagharap sa malalaking repositoryo).

Gusali:

BORG_OPENSSL_PREFIX
Nagdaragdag ng ibinigay na OpenSSL header na direktoryo ng file sa mga default na lokasyon
(setup.py).

BORG_LZ4_PREFIX
Nagdaragdag ng ibinigay na direktoryo ng file ng header ng LZ4 sa mga default na lokasyon (setup.py).

Mangyaring tandaan:

· maging maingat kapag gumagamit ng "oo" sayers, ang mga babala na may prompt ay umiiral para sa iyong /
seguridad/kaligtasan ng iyong data

· maging maingat din kapag inilalagay ang iyong passphrase sa isang script, siguraduhing mayroon ito
naaangkop na mga pahintulot sa file (hal. mode 600, root:root).

Mapagkukunan Paggamit
Maaaring gumamit si Borg ng maraming mapagkukunan depende sa laki ng data set na kinakaharap nito
may.

CPU: Hindi ito lalampas sa 100% ng 1 core dahil kasalukuyang single-threaded ang code.
Lalo na ang mas mataas na antas ng compression ng zlib at lzma ay gumagamit ng malalaking halaga ng CPU
siklo

Memorya (R.A.M):
Ang index ng mga chunks at ang index ng mga file ay binabasa sa memorya para sa mga dahilan ng pagganap.
Compression, esp. Ang lzma compression na may mataas na antas ay maaaring mangailangan ng malaking halaga
ng memorya.

Pansamantala file:
Ang pagbabasa ng data at metadata mula sa isang FUSE mounted repository ay makakakonsumo ng tungkol sa
parehong espasyo gaya ng mga deduplicated na chunks na ginamit upang kumatawan sa kanila sa repository.

Cache file:
Naglalaman ng chunks index at file index (kasama ang isang naka-compress na koleksyon ng
single-archive chunk index).

Mga chunks index:
Proporsyonal sa dami ng data chunks sa iyong repo. Maraming chunks sa iyong repo
magpahiwatig ng isang malaking chunks index. Posibleng i-tweak ang chunker params (tingnan ang create
mga pagpipilian).

File index:
Proporsyonal sa dami ng mga file sa iyong huling backup. Maaaring patayin (tingnan
lumikha ng mga opsyon), ngunit ang susunod na backup ay magiging mas mabagal kung gagawin mo.

Network:
Kung malayo ang iyong repository, lahat ay na-deduplicate (at opsyonal na naka-compress/
naka-encrypt) na data siyempre ay kailangang pumunta sa koneksyon (ssh: repo url). kung ikaw
gumamit ng lokal na naka-mount na network filesystem, bukod pa rito ang ilang mga operasyon sa pagkopya na ginamit
para sa suporta sa transaksyon, dumaan din sa koneksyon. Kung nagba-backup ka ng maraming mapagkukunan
sa isang target na imbakan, ang karagdagang trapiko ay nangyayari para sa muling pag-synchronize ng cache.

Kung sakaling interesado ka sa higit pang mga detalye, mangyaring basahin ang dokumentasyon ng internals.

Units
Upang magpakita ng mga dami, pinangangalagaan ni Borg ang paggalang sa mga karaniwang convention of scale. Disk
ang mga sukat ay ipinapakita sa decimal, gamit ang kapangyarihan ng sampu (kaya kB nangangahulugang 1000 bytes). Para sa memorya
paggamit, doble prefix ay ginagamit, at ipinahiwatig gamit ang IEC doble prefix, Gamit
kapangyarihan ng dalawa (kaya KiB nangangahulugang 1024 bytes).

petsa at oras
Nag-format kami ng petsa at oras na naaayon sa ISO-8601, iyon ay: YYYY-MM-DD at HH:MM:SS (24h
orasan).

Para sa higit pang impormasyon tungkol doon, tingnan ang: https://xkcd.com/1179/

Maliban kung binanggit, ipinapakita namin ang lokal na petsa at oras. Sa panloob, iniimbak at pinoproseso namin
petsa at oras bilang UTC.

CREDIT INIT

paggamit: borg init [-h] [--kritikal] [--error] [--babala] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-e {wala,keyfile,repokey}]
[REPOSITORY]

Magsimula ng isang walang laman na imbakan

mga positional na argumento:
REPOSITORY repository na gagawin

mga opsyonal na argumento:
-h, --help ipakita ang mensahe ng tulong na ito at lumabas
--kritikal na gawain sa antas ng log KRITIKAL
--error work sa log level ERROR
--paggawa ng babala sa antas ng log WARNING (default)
--info, -v, --verbose
magtrabaho sa INFO sa antas ng log
--debug na gumagana sa antas ng log na DEBUG
--lock-wait N hintayin ang lock, ngunit max. N segundo (default: 1).
--show-rc ipakita/i-log ang return code (rc)
--no-files-cache huwag i-load/i-update ang file metadata cache na ginamit
tuklasin ang mga hindi nabagong file
--umask M itinakda ang umask sa M (lokal at remote, default: 0077)
--remote-path PATH itakda ang malayuang landas sa executable (default: "borg")
-e {none,keyfile,repokey}, --encryption {none,keyfile,repokey}
piliin ang encryption key mode (default: "repokey")

paglalarawan
Ang utos na ito ay nagpapasimula ng isang walang laman na imbakan. Ang repositoryo ay isang direktoryo ng filesystem
naglalaman ng na-deduplicate na data mula sa zero o higit pang mga archive. Maaaring paganahin ang pag-encrypt sa
imbakan init oras.

Mga halimbawa
# Lokal na imbakan (default ay ang paggamit ng encryption sa repokey mode)
$ borg init /path/to/repo

# Lokal na imbakan (walang pag-encrypt)
$ borg init --encryption=none /path/to/repo

# Remote repository (nag-access ng remote borg sa pamamagitan ng ssh)
$ borg init user@hostname:backup

# Remote na imbakan (imbak ang susi sa iyong home dir)
$ borg init --encryption=keyfile user@hostname:backup

Mahahalagang tala tungkol sa pag-encrypt:

Hindi inirerekomenda na huwag paganahin ang pag-encrypt. Pinoprotektahan ka ng repository encryption hal
laban sa kaso na may access ang isang attacker sa iyong backup na repository.

Ngunit mag-ingat sa susi / passphrase:

Kung gusto mo ng seguridad na "passphrase-only", gamitin ang repokey mode. Ang susi ay itatabi
sa loob ng repositoryo (sa "config" file nito). Sa nabanggit na senaryo ng pag-atake, ang
Magkakaroon ng susi ang attacker (ngunit hindi ang passphrase).

Kung gusto mo ng seguridad ng "passphrase at pagkakaroon ng key", gamitin ang keyfile mode. Ang susi ay
maiimbak sa iyong home directory (sa .config/borg/keys). Sa senaryo ng pag-atake, ang
Ang attacker na may access lang sa iyong repo ay hindi magkakaroon ng susi (at hindi rin ang
passphrase).

Gumawa ng backup na kopya ng key file (keyfile mode) o repo config file (repokey mode) at
itago ito sa isang ligtas na lugar, para nasa iyo pa rin ang susi kung sakaling ito ay masira o mawala. Gayundin
panatilihin ang passphrase sa isang ligtas na lugar. Ang backup na naka-encrypt gamit ang key na iyon ay hindi
tulungan ka niyan, siyempre.

Tiyaking gumamit ka ng magandang passphrase. Hindi masyadong maikli, hindi masyadong simple. Ang tunay na pag-encrypt /
Ang decryption key ay naka-encrypt gamit ang / naka-lock ng iyong passphrase. Kung nakuha ng isang attacker ang iyong
key, hindi niya ito ma-unlock at magamit nang hindi nalalaman ang passphrase.

Mag-ingat sa mga espesyal o hindi ascii na character sa iyong passphrase:

· Pinoproseso ni Borg ang passphrase bilang unicode (at ine-encode ito bilang utf-8), kaya wala itong
mga problema sa pagharap sa kahit na ang mga kakaibang karakter.

· PERO: na hindi kinakailangang nalalapat sa iyong OS / VM / pagsasaayos ng keyboard.

Kaya't mas mahusay na gumamit ng mahabang passphrase na ginawa mula sa mga simpleng ascii char kaysa sa isa na kasama
mga bagay na hindi ascii o mga character na mahirap/imposibleng ilagay sa ibang keyboard
layout.

Maaari mong baguhin ang iyong passphrase para sa mga kasalukuyang repo anumang oras, hindi ito makakaapekto sa
encryption/decryption key o iba pang mga lihim.

CREDIT LILIKHA

paggamit: borg lumikha [-h] [--kritikal] [--error] [--babala] [--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 yyyy-mm-ddThh:mm:ss]
[--chunker-params CHUNK_MIN_EXP,CHUNK_MAX_EXP,HASH_MASK_BITS,HASH_WINDOW_SIZE]
[--ignore-inode] [-C COMPRESSION] [--read-espesyal] [-n]
ARCHIVE PATH [PATH ...]

Gumawa ng bagong archive

mga positional na argumento:
ARCHIVE pangalan ng archive na gagawin (dapat ding valid
pangalan ng direktoryo)
Mga path ng PATH sa archive

mga opsyonal na argumento:
-h, --help ipakita ang mensahe ng tulong na ito at lumabas
--kritikal na gawain sa antas ng log KRITIKAL
--error work sa log level ERROR
--paggawa ng babala sa antas ng log WARNING (default)
--info, -v, --verbose
magtrabaho sa INFO sa antas ng log
--debug na gumagana sa antas ng log na DEBUG
--lock-wait N hintayin ang lock, ngunit max. N segundo (default: 1).
--show-rc ipakita/i-log ang return code (rc)
--no-files-cache huwag i-load/i-update ang file metadata cache na ginamit
tuklasin ang mga hindi nabagong file
--umask M itinakda ang umask sa M (lokal at remote, default: 0077)
--remote-path PATH itakda ang malayuang landas sa executable (default: "borg")
-s, --stats print statistics para sa ginawang archive
-p, --progress ay nagpapakita ng pagpapakita ng pag-unlad habang ginagawa ang archive,
nagpapakita ng Orihinal, Compressed at Deduplicated na laki,
sinusundan ng Bilang ng mga file na nakita at ang landas
pinoproseso, default: False
--list output verbose list ng mga item (mga file, dirs, ...)
--filter ang STATUSCHARS ay nagpapakita lamang ng mga item na may ibinigay na mga character ng katayuan
-e PATTERN, --ibukod ang PATTERN
ibukod ang mga path na tumutugma sa PATTERN
--exclude-mula sa EXCLUDEFILE
basahin ang ibukod ang mga pattern mula sa EXCLUDEFILE, isa bawat linya
--exclude-caches ibukod ang mga direktoryo na naglalaman ng CACHEDIR.TAG file
(http://www.brynosaurus.com/cachedir/spec.html)
--exclude-if-present na FILENAME
ibukod ang mga direktoryo na naglalaman ng tinukoy na file
--keep-tag-files ay nagpapanatili ng mga tag na file ng mga hindi kasamang cache/direktoryo
-c SECONDS, --checkpoint-interval SECONDS
sumulat ng checkpoint bawat SECONDS segundo (Default: 300)
-x, --isang-file-system
manatili sa parehong file system, huwag tumawid sa mga mount point
--numeric-owner ay nag-iimbak lamang ng mga numerong user at mga pagkakakilanlan ng grupo
--timestamp yyyy-mm-ddThh:mm:ss
manu-manong tukuyin ang petsa/oras ng paglikha ng archive (UTC).
Bilang kahalili, magbigay ng reference na file/direktoryo.
--chunker-params CHUNK_MIN_EXP,CHUNK_MAX_EXP,HASH_MASK_BITS,HASH_WINDOW_SIZE
tukuyin ang mga parameter ng chunker. default: 19,23,21,4095
--ignore-inode huwag pansinin ang data ng inode sa cache ng metadata ng file na ginamit noon
tuklasin ang mga hindi nabagong file.
-C COMPRESSION, --compression COMPRESSION
piliin ang compression algorithm (at antas): wala == hindi
compression (default), lz4 == lz4, zlib == zlib
(default level 6), zlib,0 .. zlib,9 == zlib (with
level 0..9), lzma == lzma (default level 6), lzma,0 ..
lzma,9 == lzma (na may antas 0..9).
--read-special na buksan at basahin ang mga espesyal na file na parang regular ang mga ito
file
-n, --dry-run huwag gumawa ng backup na archive

paglalarawan
Ang utos na ito ay lumilikha ng isang backup na archive na naglalaman ng lahat ng mga file na natagpuan habang recursively
binabagtas ang lahat ng mga landas na tinukoy. Ang archive ay halos walang puwang sa disk para sa mga file o
mga bahagi ng mga file na naimbak na sa ibang mga archive.

Upang mapabilis ang paghila ng mga backup sa mga sshf at mga katulad na network file system na hindi
magbigay ng tamang impormasyon ng inode ang --ignore-inode flag ay maaaring gamitin. Ito ay potensyal
binabawasan ang pagiging maaasahan ng pagtuklas ng pagbabago, habang iniiwasan ang palaging pagbabasa ng lahat ng mga file
ang mga file system na ito.

Tingnan ang output ng command na "borg help patterns" para sa higit pang tulong sa pagbubukod ng mga pattern.

Mga halimbawa
# Backup ~/Mga Dokumento sa isang archive na pinangalanang "my-documents"
$ borg lumikha /path/to/repo::my-documents ~/Mga Dokumento

# pareho, ngunit verbosely ilista ang lahat ng mga file habang pinoproseso namin ang mga ito
$ borg lumikha -v --list /path/to/repo::my-documents ~/Mga Dokumento

# Backup ~/Mga Dokumento at ~/src ngunit ibukod ang mga pyc file
$borg lumikha /path/to/repo::my-files \
~/Mga Dokumento \
~/src \
--ibukod ang '*.pyc'

# Mga backup na direktoryo ng bahay na hindi kasama ang mga thumbnail ng larawan (hal
# / home /*/.thumbnails ay hindi kasama, hindi / home /*/*/.thumbnails)
$borg lumikha /path/to/repo::my-files / home \
--ibukod 're:^/ home /[^/]+/\.thumbnails/'

# Gawin ang parehong gamit ang isang shell-style pattern
$borg lumikha /path/to/repo::my-files / home \
--ibukod ang 'sh:/ home /*/.thumbnails'

# I-backup ang root filesystem sa isang archive na pinangalanang "root-YYYY-MM-DD"
# gumamit ng zlib compression (mabuti, ngunit mabagal) - ang default ay walang compression
$ borg lumikha -C zlib,6 /path/to/repo::root-{now:%Y-%m-%d} / --one-file-system

# Gumawa ng isang malaking pagsisikap sa pinong granular deduplication (big chunk management
# overhead, nangangailangan ng maraming RAM at espasyo sa disk, tingnan ang formula sa internals
# docs - parehong mga parameter tulad ng borg < 1.0 o attic):
$ borg create --chunker-params 10,23,16,4095 /path/to/repo::small /smallstuff

# I-backup ang isang raw na device (dapat hindi aktibo/ginagamit/naka-mount sa oras na iyon)
$ dd if=/dev/sdx bs=10M | borg lumikha /path/to/repo::my-sdx -

# Walang compression (default)
$ borg lumikha /path/to/repo::arch ~

# Napakabilis, mababang compression
$ borg lumikha --compression lz4 /path/to/repo::arch ~

# Mas mabilis, mas mataas na compression (N = 0..9)
$ borg lumikha --compression zlib,N /path/to/repo::arch ~

# Kahit na mas mabagal, kahit na mas mataas na compression (N = 0..9)
$ borg lumikha --compression lzma,N /path/to/repo::arch ~

# Format ng mga tag na magagamit para sa pangalan ng archive:
# {now}, {utcnow}, {fqdn}, {hostname}, {user}, {pid}
# magdagdag ng maikling hostname, backup na username at kasalukuyang unixtime (mga segundo mula sa panahon)
$borg create /path/to/repo::{hostname}-{user}-{now:%s} ~

CREDIT MAGBABAGO

paggamit: borg extract [-h] [--kritikal] [--error] [--babala] [--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]
ARCHIVE [PATH [PATH ...]]

I-extract ang mga nilalaman ng archive

mga positional na argumento:
ARCHIVE archive upang kunin
Mga path ng PATH upang kunin; mga pattern ay suportado

mga opsyonal na argumento:
-h, --help ipakita ang mensahe ng tulong na ito at lumabas
--kritikal na gawain sa antas ng log KRITIKAL
--error work sa log level ERROR
--paggawa ng babala sa antas ng log WARNING (default)
--info, -v, --verbose
magtrabaho sa INFO sa antas ng log
--debug na gumagana sa antas ng log na DEBUG
--lock-wait N hintayin ang lock, ngunit max. N segundo (default: 1).
--show-rc ipakita/i-log ang return code (rc)
--no-files-cache huwag i-load/i-update ang file metadata cache na ginamit
tuklasin ang mga hindi nabagong file
--umask M itinakda ang umask sa M (lokal at remote, default: 0077)
--remote-path PATH itakda ang malayuang landas sa executable (default: "borg")
--list output verbose list ng mga item (mga file, dirs, ...)
-n, --dry-run ay hindi aktwal na nagbabago ng anumang mga file
-e PATTERN, --ibukod ang PATTERN
ibukod ang mga path na tumutugma sa PATTERN
--exclude-mula sa EXCLUDEFILE
basahin ang ibukod ang mga pattern mula sa EXCLUDEFILE, isa bawat linya
--numeric-owner lang ang sumusunod sa numeric na user at group identifiers
--strip-components NUMBER
Alisin ang tinukoy na bilang ng mga elemento ng nangungunang landas.
Ang mga pathname na may mas kaunting elemento ay magiging tahimik
nilaktawan.
--stdout isulat ang lahat ng nakuhang data sa stdout
--sparse lumikha ng mga butas sa output sparse file mula sa all-zero
mga chunks

paglalarawan
Kinukuha ng command na ito ang mga nilalaman ng isang archive. Bilang default ang buong archive ay
na-extract ngunit maaaring mapili ang isang subset ng mga file at direktoryo sa pamamagitan ng pagpasa ng listahan ng mga PATH
bilang mga argumento. Ang pagpili ng file ay maaaring higit pang paghigpitan sa pamamagitan ng paggamit ng --ibukod pagpipilian.

Tingnan ang output ng command na "borg help patterns" para sa higit pang tulong sa pagbubukod ng mga pattern.

Mga halimbawa
# I-extract ang buong archive
$ borg extract /path/to/repo::my-files

# I-extract ang buong archive at listahan ng mga file habang pinoproseso
$ borg extract -v --list /path/to/repo::my-files

# I-extract ang "src" na direktoryo
$ borg extract /path/to/repo::my-files home/USERNAME/src

# I-extract ang direktoryo ng "src" ngunit ibukod ang mga object file
$ borg extract /path/to/repo::my-files home/USERNAME/src --exclude '*.o'

# Ibalik ang isang hilaw na aparato (dapat hindi aktibo/ginagamit/naka-mount sa oras na iyon)
$ borg extract --stdout /path/to/repo::my-sdx | dd ng=/dev/sdx bs=10M

tandaan: kasalukuyan, kunin palagi nagsusulat sa ang kasalukuyan nagtatrabaho direktoryo ("."),
kaya siguraduhin mo cd sa tamang lugar bago tumawag borg kunin.

CREDIT CHECK

paggamit: borg check [-h] [--kritikal] [--error] [--babala] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [--repository-only] [--archives-only]
[--repair] [--save-space] [--huling N] [-P PREFIX]
[REPOSITORY_OR_ARCHIVE]

Suriin ang pagkakapare-pareho ng imbakan

mga positional na argumento:
REPOSITORY_OR_ARCHIVE
repositoryo o archive upang suriin ang pagkakapare-pareho ng

mga opsyonal na argumento:
-h, --help ipakita ang mensahe ng tulong na ito at lumabas
--kritikal na gawain sa antas ng log KRITIKAL
--error work sa log level ERROR
--paggawa ng babala sa antas ng log WARNING (default)
--info, -v, --verbose
magtrabaho sa INFO sa antas ng log
--debug na gumagana sa antas ng log na DEBUG
--lock-wait N hintayin ang lock, ngunit max. N segundo (default: 1).
--show-rc ipakita/i-log ang return code (rc)
--no-files-cache huwag i-load/i-update ang file metadata cache na ginamit
tuklasin ang mga hindi nabagong file
--umask M itinakda ang umask sa M (lokal at remote, default: 0077)
--remote-path PATH itakda ang malayuang landas sa executable (default: "borg")
--repository-only nagsasagawa lamang ng mga pagsusuri sa repositoryo
--archives-lamang ang nagsasagawa ng mga pagsusuri sa archive
--repair pagtatangka upang ayusin ang anumang hindi pagkakapare-pareho na natagpuan
--save-space ay gumana nang mas mabagal, ngunit gumagamit ng mas kaunting espasyo
--huling N suriin lamang ang huling N archive (Default: lahat)
-P PREFIX, --prefix PREFIX
isaalang-alang lamang ang mga pangalan ng archive na nagsisimula sa prefix na ito

paglalarawan
Bine-verify ng check command ang consistency ng isang repository at ang kaukulang archive.

Una, sinusuri ang pinagbabatayan na mga file ng data ng repositoryo:

· Para sa lahat ng mga segment ang segment magic (header) ay naka-check

· Para sa lahat ng bagay na nakaimbak sa mga segment, lahat ng metadata (hal. crc at laki) at lahat ng data ay
basahin. Sinusuri ang nabasang data ayon sa laki at CRC. Bit rot at iba pang uri ng aksidente
matukoy ang pinsala sa ganitong paraan.

· Kung kami ay nasa repair mode at may nakitang error sa integridad para sa isang segment, susubukan naming gawin
mabawi ang pinakamaraming bagay mula sa segment hangga't maaari.

· Sa repair mode, tinitiyak nito na ang index ay pare-pareho sa data na nakaimbak sa
mga segment.

· Kung gumagamit ka ng remote na repo server sa pamamagitan ng ssh:, ang repo check ay isinasagawa sa repo server
nang hindi nagdudulot ng makabuluhang trapiko sa network.

· Maaaring laktawan ang pagsusuri sa repository gamit ang --archives-only na opsyon.

Pangalawa, ang pagkakapare-pareho at kawastuhan ng archive metadata ay na-verify:

· Naroroon ba ang repo manifest? Kung hindi, ito ay itinayong muli mula sa archive metadata chunks (ito
nangangailangan ng pagbabasa at pag-decrypting ng lahat ng metadata at data).

· Suriin kung ang archive metadata chunk ay naroroon. kung hindi, alisin ang archive sa manifest.

· Para sa lahat ng mga file (mga item) sa archive, para sa lahat ng mga chunks na isinangguni ng mga file na ito, tingnan kung
naroroon ang tipak (kung wala at nasa repair mode kami, palitan ito ng kaparehong laki ng tipak ng
mga zero). Nangangailangan ito ng pagbabasa ng archive at metadata ng file, ngunit hindi data.

· Kung kami ay nasa repair mode at sinuri namin ang lahat ng mga archive: tanggalin ang mga naulilang tipak mula sa
ang repo.

· Kung gumagamit ka ng isang malayuang repo server sa pamamagitan ng ssh:, ang pagsusuri sa archive ay isinasagawa sa kliyente
machine (dahil kung pinagana ang pag-encrypt, ang mga pagsusuri ay mangangailangan ng decryption at ito
ay palaging ginagawa sa panig ng kliyente, dahil kakailanganin ang key access).

· Ang mga pagsusuri sa archive ay maaaring matagal, maaari silang laktawan gamit ang
--repository-lamang na opsyon.

CREDIT RENAME

paggamit: palitan ng pangalan ng borg [-h] [--kritikal] [--error] [--babala] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH]
ARCHIVE NEWNAME

Palitan ang pangalan ng isang kasalukuyang archive

mga positional na argumento:
ARCHIVE archive upang palitan ang pangalan
NEWNAME ang bagong pangalan ng archive na gagamitin

mga opsyonal na argumento:
-h, --help ipakita ang mensahe ng tulong na ito at lumabas
--kritikal na gawain sa antas ng log KRITIKAL
--error work sa log level ERROR
--paggawa ng babala sa antas ng log WARNING (default)
--info, -v, --verbose
magtrabaho sa INFO sa antas ng log
--debug na gumagana sa antas ng log na DEBUG
--lock-wait N hintayin ang lock, ngunit max. N segundo (default: 1).
--show-rc ipakita/i-log ang return code (rc)
--no-files-cache huwag i-load/i-update ang file metadata cache na ginamit
tuklasin ang mga hindi nabagong file
--umask M itinakda ang umask sa M (lokal at remote, default: 0077)
--remote-path PATH itakda ang malayuang landas sa executable (default: "borg")

paglalarawan
Pinapalitan ng command na ito ang isang archive sa repositoryo.

Mga halimbawa
$ borg lumikha /path/to/repo::archivename ~
$ borg list /path/to/repo
archivename Lun, 2016-02-15 19:50:19

$ borg rename /path/to/repo::archivename newname
$ borg list /path/to/repo
bagong pangalan Mon, 2016-02-15 19:50:19

CREDIT LIST

paggamit: listahan ng borg [-h] [--kritikal] [--error] [--babala] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [--short] [--list-format LISTFORMAT]
[-P PREFIX]
[REPOSITORY_OR_ARCHIVE]

Maglista ng mga nilalaman ng archive o repositoryo

mga positional na argumento:
REPOSITORY_OR_ARCHIVE
repositoryo/archive para ilista ang mga nilalaman ng

mga opsyonal na argumento:
-h, --help ipakita ang mensahe ng tulong na ito at lumabas
--kritikal na gawain sa antas ng log KRITIKAL
--error work sa log level ERROR
--paggawa ng babala sa antas ng log WARNING (default)
--info, -v, --verbose
magtrabaho sa INFO sa antas ng log
--debug na gumagana sa antas ng log na DEBUG
--lock-wait N hintayin ang lock, ngunit max. N segundo (default: 1).
--show-rc ipakita/i-log ang return code (rc)
--no-files-cache huwag i-load/i-update ang file metadata cache na ginamit
tuklasin ang mga hindi nabagong file
--umask M itinakda ang umask sa M (lokal at remote, default: 0077)
--remote-path PATH itakda ang malayuang landas sa executable (default: "borg")
--maikli lamang ang mga pangalan ng file/direktoryo sa pag-print, wala nang iba pa
--list-format LISTFORMAT
tukuyin ang format para sa listahan ng archive file (default:
"{mode} {user:6} {group:6} {size:8d} {isomtime}
{path}{extra}{NEWLINE}") Mayroong espesyal na "{formatkeys}".
para ilista ang mga available na key
-P PREFIX, --prefix PREFIX
isaalang-alang lamang ang mga pangalan ng archive na nagsisimula sa prefix na ito

paglalarawan
Inililista ng utos na ito ang mga nilalaman ng isang repositoryo o isang archive.

Mga halimbawa
$ borg list /path/to/repo
Lunes Lun, 2016-02-15 19:15:11
repo Mon, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
bagong pangalan Mon, 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 Mon, 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 Fri, 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}"
user user ng drwxrwxr-x 0 Linggo, 2015-02-01 11:00:00 .
user user ng drwxrwxr-x 0 Linggo, 2015-02-01 11:00:00 code
user user ng drwxrwxr-x 0 Linggo, 2015-02-01 11:00:00 code/myproject
-rw-rw-r-- user user 1416192 Linggo, 2015-02-01 11:00:00 code/myproject/file.ext
...

# tingnan kung ano ang binago sa pagitan ng mga archive, batay sa oras ng pagbabago ng file, laki at landas ng file
$ borg list /path/to/repo::archiveA --list-format="{mtime:%s}{TAB}{size}{TAB}{path}{LF}" |sort -n > /tmp/list .archiveA
$ borg list /path/to/repo::archiveB --list-format="{mtime:%s}{TAB}{size}{TAB}{path}{LF}" |sort -n > /tmp/list .archiveB
$ diff -y /tmp/list.archiveA /tmp/list.archiveB
1422781200 0 . 1422781200 0 .
1422781200 0 code 1422781200 0 code
1422781200 0 code/myproject 1422781200 0 code/myproject
1422781200 1416192 code/myproject/file.ext | 1454664653 1416192 code/myproject/file.ext
...

CREDIT ALISIN

paggamit: borg tanggalin [-h] [--kritikal] [--error] [--babala] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-p] [-s] [-c] [--save-space]
[TARGET]

Tanggalin ang isang kasalukuyang repositoryo o archive

mga positional na argumento:
TARGET archive o repository na tatanggalin

mga opsyonal na argumento:
-h, --help ipakita ang mensahe ng tulong na ito at lumabas
--kritikal na gawain sa antas ng log KRITIKAL
--error work sa log level ERROR
--paggawa ng babala sa antas ng log WARNING (default)
--info, -v, --verbose
magtrabaho sa INFO sa antas ng log
--debug na gumagana sa antas ng log na DEBUG
--lock-wait N hintayin ang lock, ngunit max. N segundo (default: 1).
--show-rc ipakita/i-log ang return code (rc)
--no-files-cache huwag i-load/i-update ang file metadata cache na ginamit
tuklasin ang mga hindi nabagong file
--umask M itinakda ang umask sa M (lokal at remote, default: 0077)
--remote-path PATH itakda ang malayuang landas sa executable (default: "borg")
-p, --progress ay nagpapakita ng pagpapakita ng pag-unlad habang tinatanggal ang isang archive
-s, --stats print statistics para sa tinanggal na archive
-c, --cache-only tanggalin lamang ang lokal na cache para sa ibinigay na imbakan
--save-space ay gumana nang mas mabagal, ngunit gumagamit ng mas kaunting espasyo

paglalarawan
Ang utos na ito ay nagtatanggal ng isang archive mula sa repositoryo o sa kumpletong repositoryo. Disk
ang espasyo ay na-reclaim nang naaayon. Kung tatanggalin mo ang kumpletong repositoryo, ang lokal na cache para sa
ito (kung mayroon man) ay tinanggal din.

Mga halimbawa
# tanggalin ang isang backup na archive:
$ borg tanggalin ang /path/to/repo::Lunes

# tanggalin ang buong imbakan at ang nauugnay na lokal na cache:
$ borg tanggalin ang /path/to/repo
Hiniling mong ganap na TANGGALIN ang repositoryo *kasama ang* lahat ng mga archive na nilalaman nito:
repo Mon, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
bagong pangalan Mon, 2016-02-15 19:50:19
I-type ang 'OO' kung naiintindihan mo ito at gusto mong magpatuloy: OO

CREDIT PRUNE

paggamit: borg prune [-h] [--kritikal] [--error] [--babala] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-n] [-s] [--list]
[--panatilihin-sa loob] [-H ORAS-ORAS] [-d ARAW-ARAW] [-w LIGU-LINGGO]
[-m BULANAN] [-y TAUN-TAON] [-P PREFIX] [--save-space]
[REPOSITORY]

Putulin ang mga archive ng repositoryo ayon sa tinukoy na mga panuntunan

mga positional na argumento:
REPOSITORY repository para putulin

mga opsyonal na argumento:
-h, --help ipakita ang mensahe ng tulong na ito at lumabas
--kritikal na gawain sa antas ng log KRITIKAL
--error work sa log level ERROR
--paggawa ng babala sa antas ng log WARNING (default)
--info, -v, --verbose
magtrabaho sa INFO sa antas ng log
--debug na gumagana sa antas ng log na DEBUG
--lock-wait N hintayin ang lock, ngunit max. N segundo (default: 1).
--show-rc ipakita/i-log ang return code (rc)
--no-files-cache huwag i-load/i-update ang file metadata cache na ginamit
tuklasin ang mga hindi nabagong file
--umask M itinakda ang umask sa M (lokal at remote, default: 0077)
--remote-path PATH itakda ang malayuang landas sa executable (default: "borg")
-n, --dry-run huwag baguhin ang repositoryo
-s, --stats print statistics para sa tinanggal na archive
--list output verbose listahan ng mga archive na pinapanatili nito/prun
--keep-within WITHIN panatilihin ang lahat ng archive sa loob ng agwat ng oras na ito
-H ORAS-ORAS, --panatilihin-oras-ORAS
bilang ng oras-oras na mga archive na dapat panatilihin
-d ARAW-ARAW, --panatilihin-araw-araw araw-araw
bilang ng pang-araw-araw na archive na dapat panatilihin
-w LINGGO, --keep-weekly LINGGO
bilang ng lingguhang archive na dapat panatilihin
-m MONTHLY, --keep-monthly MONTHLY
bilang ng buwanang archive na dapat panatilihin
-y YEARLY, --keep-yearly YEARLY
bilang ng taunang mga archive na dapat panatilihin
-P PREFIX, --prefix PREFIX
isaalang-alang lamang ang mga pangalan ng archive na nagsisimula sa prefix na ito
--save-space ay gumana nang mas mabagal, ngunit gumagamit ng mas kaunting espasyo

paglalarawan
Pinutol ng prune command ang isang repository sa pamamagitan ng pagtanggal ng mga archive na hindi tumutugma sa alinman sa
tinukoy na mga opsyon sa pagpapanatili. Ang utos na ito ay karaniwang ginagamit ng mga awtomatikong backup na script
gustong magpanatili ng isang tiyak na bilang ng mga makasaysayang backup.

Bilang halimbawa, ang ibig sabihin ng "-d 7" ay panatilihin ang pinakabagong backup sa bawat araw, hanggang 7 pinakabago
mga araw na may mga backup (hindi binibilang ang mga araw na walang backup). Ang mga patakaran ay inilalapat mula sa oras-oras
sa taun-taon, at ang mga backup na pinili ng mga nakaraang panuntunan ay hindi mabibilang sa mga susunod
mga tuntunin. Ang oras na nakumpleto ang bawat backup ay ginagamit para sa mga layunin ng pruning. Mga petsa at oras
ay binibigyang-kahulugan sa lokal na timezone, at ang mga linggo ay mula Lunes hanggang Linggo. Pagtukoy sa a
Ang negatibong bilang ng mga archive na dapat panatilihin ay nangangahulugan na walang limitasyon.

Ang "--keep-within" na opsyon ay tumatagal ng argumento ng form na " ", kung saan ang char ay "H",
"d", "w", "m", "y". Halimbawa, ang ibig sabihin ng "--keep-within 2d" ay panatilihin ang lahat ng archive noon
ginawa sa loob ng nakalipas na 48 oras. Ang "1m" ay nangangahulugang "31d". Ang mga archive ay itinatago sa
ang pagpipiliang ito ay hindi binibilang sa mga kabuuan na tinukoy ng anumang iba pang mga opsyon.

Kung ang isang prefix ay itinakda sa -P, ang mga archive lamang na nagsisimula sa prefix ang isasaalang-alang
para sa pagtanggal at ang mga archive lamang na iyon ang mabibilang sa mga kabuuan na tinukoy ng mga panuntunan.
Kung hindi, lahat ang mga archive sa repositoryo ay mga kandidato para tanggalin!

Mga halimbawa
Mag-ingat, ang prune ay isang potensyal na mapanganib na utos, aalisin nito ang mga backup na archive.

Ang default ng prune ay ilapat sa lahat arkibos in ang repositoryo maliban kung paghigpitan mo ito
pagpapatakbo sa isang subset ng archive na gumagamit --prefix. Kapag gumagamit --prefix, mag-ingat ka
pumili ng magandang prefix - hal. huwag gumamit ng prefix na "foo" kung ayaw mo ring tumugma
"foobar".

Lubos na inirerekomenda na palaging tumakbo putulin --dry-run ... una para makita mo kung ano ito
gagawin nang wala itong aktwal na ginagawa.

# Panatilihin ang 7 pagtatapos ng araw at 4 na karagdagang archive sa pagtatapos ng linggo.
# Magsagawa ng dry-run nang hindi talagang nagtatanggal ng kahit ano.
$ borg prune --dry-run --keep-daily=7 --keep-weekly=4 /path/to/repo

# Pareho sa itaas ngunit nalalapat lamang sa mga pangalan ng archive na nagsisimula sa "foo":
$ borg prune --keep-daily=7 --keep-weekly=4 --prefix=foo /path/to/repo

# Panatilihin ang 7 pagtatapos ng araw, 4 na karagdagang mga archive sa pagtatapos ng linggo,
# at isang archive sa pagtatapos ng buwan para sa bawat buwan:
$ borg prune --keep-daily=7 --keep-weekly=4 --keep-monthly=-1 /path/to/repo

# Panatilihin ang lahat ng mga backup sa huling 10 araw, 4 na karagdagang mga archive sa pagtatapos ng linggo,
# at isang archive sa pagtatapos ng buwan para sa bawat buwan:
$ borg prune --keep-within=10d --keep-weekly=4 --keep-monthly=-1 /path/to/repo

CREDIT IMPORMASYON

paggamit: borg info [-h] [--kritikal] [--error] [--babala] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH]
I-archive

Ipakita ang mga detalye ng archive gaya ng disk space na ginamit

mga positional na argumento:
ARCHIVE archive upang ipakita ang impormasyon tungkol sa

mga opsyonal na argumento:
-h, --help ipakita ang mensahe ng tulong na ito at lumabas
--kritikal na gawain sa antas ng log KRITIKAL
--error work sa log level ERROR
--paggawa ng babala sa antas ng log WARNING (default)
--info, -v, --verbose
magtrabaho sa INFO sa antas ng log
--debug na gumagana sa antas ng log na DEBUG
--lock-wait N hintayin ang lock, ngunit max. N segundo (default: 1).
--show-rc ipakita/i-log ang return code (rc)
--no-files-cache huwag i-load/i-update ang file metadata cache na ginamit
tuklasin ang mga hindi nabagong file
--umask M itinakda ang umask sa M (lokal at remote, default: 0077)
--remote-path PATH itakda ang malayuang landas sa executable (default: "borg")

paglalarawan
Ang utos na ito ay nagpapakita ng ilang detalyadong impormasyon tungkol sa tinukoy na archive.

Mga halimbawa
$ borg info /path/to/repo::root-2016-02-15
Pangalan: ugat-2016-02-15
Fingerprint: 57c827621f21b000a8d363c1e163cc55983822b3afff3a96df595077a660be50
Hostname: myhostname
Username: root
Oras (simula): Lun, 2016-02-15 19:36:29
Oras (pagtatapos): Lun, 2016-02-15 19:39:26
Command line: /usr/local/bin/borg create -v --list -C zlib,6 /path/to/repo::root-2016-02-15 / --one-file-system
Bilang ng mga file: 38100

Orihinal na laki Naka-compress na sukat Na-deduplicate na laki
Ang archive na ito: 1.33 GB 613.25 MB 571.64 MB
Lahat ng archive: 1.63 GB 853.66 MB 584.12 MB

Mga natatanging chunks Kabuuang chunks
Index ng tipak: 36858 48844

CREDIT Kabayong sasakyan

paggamit: borg mount [-h] [--kritikal] [--error] [--babala] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-f] [-o OPTIONS]
REPOSITORY_OR_ARCHIVE MOUNTPOINT

I-mount ang archive o isang buong repository bilang isang FUSE fileystem

mga positional na argumento:
REPOSITORY_OR_ARCHIVE
repositoryo/archive upang i-mount
MOUNTPOINT kung saan i-mount ang filesystem

mga opsyonal na argumento:
-h, --help ipakita ang mensahe ng tulong na ito at lumabas
--kritikal na gawain sa antas ng log KRITIKAL
--error work sa log level ERROR
--paggawa ng babala sa antas ng log WARNING (default)
--info, -v, --verbose
magtrabaho sa INFO sa antas ng log
--debug na gumagana sa antas ng log na DEBUG
--lock-wait N hintayin ang lock, ngunit max. N segundo (default: 1).
--show-rc ipakita/i-log ang return code (rc)
--no-files-cache huwag i-load/i-update ang file metadata cache na ginamit
tuklasin ang mga hindi nabagong file
--umask M itinakda ang umask sa M (lokal at remote, default: 0077)
--remote-path PATH itakda ang malayuang landas sa executable (default: "borg")
-f, --foreground manatili sa foreground, huwag mag-demonize
-o MGA OPSYON Mga karagdagang opsyon sa pag-mount

paglalarawan
Ang utos na ito ay nag-mount ng isang archive bilang isang FUSE filesystem. Ito ay maaaring maging kapaki-pakinabang para sa pag-browse ng
archive o pagpapanumbalik ng mga indibidwal na file. Maliban kung ang --foreground ang pagpipilian ay binibigyan ng utos
ay tatakbo sa background hanggang ang filesystem ay umounted.

Mga halimbawa
$ borg mount /path/to/repo::root-2016-02-15 /tmp/mymountpoint
$ ls /tmp/mymountpoint
bin boot atbp home lib lib64 nawala+nahanap media mnt opt ​​root sbin srv tmp usr var
$ fusermount -u /tmp/mymountpoint

CREDIT PAGBABAGO-PASSPHRASE

paggamit: borg change-passphrase [-h] [--kritikal] [--error] [--babala] [--info]
[--debug] [--lock-wait N] [--show-rc]
[--no-files-cache] [--umask M]
[--remote-path PATH]
[REPOSITORY]

Baguhin ang password ng repository key file

mga positional na argumento:
REPOSITORY

mga opsyonal na argumento:
-h, --help ipakita ang mensahe ng tulong na ito at lumabas
--kritikal na gawain sa antas ng log KRITIKAL
--error work sa log level ERROR
--paggawa ng babala sa antas ng log WARNING (default)
--info, -v, --verbose
magtrabaho sa INFO sa antas ng log
--debug na gumagana sa antas ng log na DEBUG
--lock-wait N hintayin ang lock, ngunit max. N segundo (default: 1).
--show-rc ipakita/i-log ang return code (rc)
--no-files-cache huwag i-load/i-update ang file metadata cache na ginamit
tuklasin ang mga hindi nabagong file
--umask M itinakda ang umask sa M (lokal at remote, default: 0077)
--remote-path PATH itakda ang malayuang landas sa executable (default: "borg")

paglalarawan
Ang mga pangunahing file na ginagamit para sa pag-encrypt ng repositoryo ay opsyonal na protektado ng passphrase. Ito
Maaaring gamitin ang command upang baguhin ang passphrase na ito.

Mga halimbawa
# Lumikha ng isang susi na protektadong imbakan ng file
$ borg init --encryption=keyfile -v /path/to/repo
Sinisimulan ang repositoryo sa "/path/to/repo"
Maglagay ng bagong passphrase:
Ilagay muli ang parehong passphrase:
Tandaan ang iyong passphrase. Hindi maa-access ang iyong data kung wala ito.
Ipasok ang "/root/.config/borg/keys/mnt_backup" na ginawa.
Panatilihing ligtas ang susi na ito. Hindi maa-access ang iyong data kung wala ito.
Sini-synchronize ang cache ng mga chunks...
Mga Archive: 0, w/ naka-cache na Idx: 0, w/ hindi napapanahong Idx: 0, w/o naka-cache na Idx: 0.
Mag-donate.

# Baguhin ang key file passphrase
$ borg change-passphrase -v /path/to/repo
Ilagay ang passphrase para sa key /root/.config/borg/keys/mnt_backup:
Maglagay ng bagong passphrase:
Ilagay muli ang parehong passphrase:
Tandaan ang iyong passphrase. Hindi maa-access ang iyong data kung wala ito.
Na-update ang susi

CREDIT MAGPAPAKITA

paggamit: 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]

Magsimula sa server mode. Ang utos na ito ay karaniwang hindi ginagamit nang manu-mano.

mga opsyonal na argumento:
-h, --help ipakita ang mensahe ng tulong na ito at lumabas
--kritikal na gawain sa antas ng log KRITIKAL
--error work sa log level ERROR
--paggawa ng babala sa antas ng log WARNING (default)
--info, -v, --verbose
magtrabaho sa INFO sa antas ng log
--debug na gumagana sa antas ng log na DEBUG
--lock-wait N hintayin ang lock, ngunit max. N segundo (default: 1).
--show-rc ipakita/i-log ang return code (rc)
--no-files-cache huwag i-load/i-update ang file metadata cache na ginamit
tuklasin ang mga hindi nabagong file
--umask M itinakda ang umask sa M (lokal at remote, default: 0077)
--remote-path PATH itakda ang malayuang landas sa executable (default: "borg")
--restrict-to-path na PATH
higpitan ang pag-access sa repositoryo sa PATH

paglalarawan
Nagsisimula ang command na ito ng proseso ng repository server. Karaniwang hindi ginagamit ang utos na ito
mano-mano.

Mga halimbawa
Ang borg serve ay may espesyal na suporta para sa ssh forced commands (tingnan ang authorized_keys halimbawa
sa ibaba): matutuklasan nito na gumamit ka ng tulad ng sapilitang utos at i-extract ang halaga ng
--restrict-to-path (mga) opsyon. Pagkatapos ay i-parse nito ang orihinal na utos na nagmula sa
kliyente, tinitiyak na ito rin borg maglingkod at ipatupad ang (mga) paghihigpit sa landas gaya ng ibinigay ng
ang pilit na utos. Sa ganoong paraan, ang iba pang mga opsyon na ibinigay ng kliyente (tulad ng --impormasyon or --umask)
ay pinapanatili (at hindi naayos sa pamamagitan ng sapilitang utos).

# Payagan ang isang keypair ng SSH na patakbuhin lamang ang borg, at mayroon lamang access sa /path/to/repo.
# Gumamit ng mga pangunahing opsyon upang hindi paganahin ang hindi kailangan at potensyal na mapanganib na paggana ng SSH.
# Makakatulong ito upang ma-secure ang isang automated na remote backup system.
$ pusa ~/.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 Mag-upgrade

paggamit: borg upgrade [-h] [--kritikal] [--error] [--babala] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-p] [-n] [-i]
[REPOSITORY]

mag-upgrade ng repository mula sa nakaraang bersyon

mga positional na argumento:
REPOSITORY path sa repository na ia-upgrade

mga opsyonal na argumento:
-h, --help ipakita ang mensahe ng tulong na ito at lumabas
--kritikal na gawain sa antas ng log KRITIKAL
--error work sa log level ERROR
--paggawa ng babala sa antas ng log WARNING (default)
--info, -v, --verbose
magtrabaho sa INFO sa antas ng log
--debug na gumagana sa antas ng log na DEBUG
--lock-wait N hintayin ang lock, ngunit max. N segundo (default: 1).
--show-rc ipakita/i-log ang return code (rc)
--no-files-cache huwag i-load/i-update ang file metadata cache na ginamit
tuklasin ang mga hindi nabagong file
--umask M itinakda ang umask sa M (lokal at remote, default: 0077)
--remote-path PATH itakda ang malayuang landas sa executable (default: "borg")
-p, --progress ay nagpapakita ng pagpapakita ng pag-unlad habang ina-upgrade ang repositoryo
-n, --dry-run huwag baguhin ang repositoryo
-i, --inplace rewrite repository sa lugar, na walang pagkakataong pumunta
bumalik sa mga mas lumang bersyon ng repositoryo.

paglalarawan
Mag-upgrade ng umiiral nang Borg repository. Kasalukuyang sinusuportahan nito ang pag-convert ng Attic
repository sa Borg at tumutulong din sa pag-convert ng Borg 0.xx sa 1.0.

Sa kasalukuyan, ang mga LOKAL na repository lamang ang maaaring i-upgrade (isyu #465).

Papalitan nito ang mga magic string sa mga segment ng repository upang tumugma sa bagong Borg magic
mga string. Ang mga keyfile na matatagpuan sa $ATTIC_KEYS_DIR o ~/.attic/keys/ mako-convert din
at kinopya sa $BORG_KEYS_DIR o ~/.config/borg/keys.

Ang mga cache file ay na-convert, mula sa $ATTIC_CACHE_DIR o ~/.cache/attic sa $BORG_CACHE_DIR
or ~/.cache/borg, ngunit nagbago ang layout ng cache sa pagitan ng Borg at Attic, kaya posible
ang unang backup pagkatapos ng conversion ay mas matagal kaysa sa inaasahan dahil sa cache resync.

Ang pag-upgrade ay dapat na makapagpatuloy kung magambala, bagama't mauulit pa rin ito sa lahat
mga segment. Kung gusto mong magsimula sa simula, gamitin borg alisin sa ibabaw ng kinopyang repository sa
siguraduhin na ang mga cache file ay tinanggal din:
borg tanggalin borg

Maliban kung --sa lugar ay tinukoy, ang proseso ng pag-upgrade ay unang lumilikha ng isang backup na kopya ng
repository, sa REPOSITORY.upgrade-DATETIME, gamit ang mga hardlink. Mas tumatagal ito kaysa sa
pag-upgrade sa lugar, ngunit mas ligtas at nagbibigay ng impormasyon sa pag-unlad (kumpara sa cp -sa).
Kapag nasiyahan ka na sa conversion, maaari mong ligtas na sirain ang backup na kopya.

BABALA: Ang pagpapatakbo ng pag-upgrade sa lugar ay gagawing hindi magagamit ang kasalukuyang kopya sa mas luma
bersyon, na walang paraan upang bumalik sa mga nakaraang bersyon. Ito ay maaaring PERMANENTENG MAKAPISIRA SA IYO
REPOSITORY! HINDI MAGBASA NG MGA REPOSITORY NG BORG ang Attic, dahil nagbago ang mga magic string. Ikaw
ay binigyan ng babala.

Mga halimbawa
# I-upgrade ang borg repository sa pinakabagong bersyon.
$ borg upgrade -v /path/to/repo
paggawa ng hardlink copy sa /path/to/repo.upgrade-2016-02-15-20:51:55
pagbubukas ng attic repository na may borg at nagko-convert
walang nahanap na key file para sa repository
pag-convert ng repo index /path/to/repo/index.0
nagko-convert ng 1 segment...
ginagawang borg current ang borg 0.xx
walang nahanap na key file para sa repository

IBA PA HELP

borg Tulungan pattern
Sinusuportahan ng mga pattern ng pagbubukod ang apat na magkakahiwalay na istilo, fnmatch, shell, regular na expression at
mga prefix ng landas. Kung sinusundan ng isang tutuldok (':') ang unang dalawang character ng isang pattern ay ginagamit
bilang tagapili ng istilo. Ang tahasang pagpili ng istilo ay kinakailangan kapag ang isang hindi default na istilo ay
ninanais o kapag ang gustong pattern ay nagsisimula sa dalawang alphanumeric na character na sinusundan ng a
colon (hal aa:something/*).

Fnmatch, tagapili fm:
Gumagamit ang mga pattern na ito ng variant ng shell pattern syntax, na may '*' na tumutugma sa anumang bilang ng
mga character, '?' tumutugma sa anumang solong karakter, '[...]' na tumutugma sa anumang solong karakter
tinukoy, kasama ang mga saklaw, at '[!...]' na tumutugma sa anumang karakter na hindi tinukoy. Para sa
layunin ng mga pattern na ito, ang path separator ('' para sa Windows at '/' sa ibang mga system)
ay hindi ginagamot nang espesyal. I-wrap ang mga meta-character sa mga bracket para sa isang literal na tugma (hal
[?] upang tumugma sa literal na karakter ?). Para sa isang path na tumugma sa isang pattern, ito ay dapat
ganap na tumugma mula simula hanggang wakas, o dapat tumugma mula sa simula hanggang bago ang isang landas
separator. Maliban sa root path, ang mga path ay hindi magtatapos sa path separator kapag
sinusubukan ang pagtutugma. Kaya, kung ang isang ibinigay na pattern ay nagtatapos sa isang path separator, ang isang '*' ay
idinagdag bago subukan ang pagtutugma.

Mga pattern na istilo ng shell, tagapili sh:
Tulad ng mga pattern ng fnmatch ay katulad ito ng mga pattern ng shell. Ang pagkakaiba ay ang
maaaring kasama sa pattern **/ para sa pagtutugma ng zero o higit pang mga antas ng direktoryo, * para sa pagtutugma ng zero
o higit pang mga arbitrary na character maliban sa anumang path separator.

Mga regular na expression, tagapili muling:
Ang mga regular na expression na katulad ng makikita sa Perl ay sinusuportahan. Hindi tulad ng mga pattern ng shell
ang mga regular na expression ay hindi kinakailangan upang tumugma sa kumpletong landas at anumang substring na tugma
ay sapat. Lubos na inirerekomendang i-anchor ang mga pattern sa simula ('^'), sa
dulo ('$') o pareho. Path separator ('' para sa Windows at '/' sa iba pang mga system) sa mga path
ay palaging na-normalize sa isang forward slash ('/') bago ilapat ang isang pattern. Ang regular
ang expression syntax ay inilarawan sa Sawa dokumentasyon para ang re module.

Prefix na landas, tagapili pp:
Ang istilo ng pattern na ito ay kapaki-pakinabang upang tumugma sa buong sub-directory. Ang pattern pp:/data/bar
posporo /data/bar at lahat ng naririto.

Maaaring ipasa ang mga pagbubukod sa pamamagitan ng opsyon sa command line --ibukod. Kapag ginamit mula sa loob a
shell ang mga pattern ay dapat na sinipi upang maprotektahan ang mga ito mula sa pagpapalawak.

Ang --bukod-sa pinahihintulutan ng opsyon ang pag-load ng mga pattern ng pagbubukod mula sa isang text file na may isa
pattern bawat linya. Walang laman ang mga linya o nagsisimula sa sign ng numero ('#') pagkatapos alisin
hindi pinapansin ang whitespace sa magkabilang dulo. Ang opsyonal na prefix ng tagapili ng estilo ay sinusuportahan din
para sa mga pattern na na-load mula sa isang file. Dahil sa mga whitespace removal path na may whitespace sa
ang simula o wakas ay maaari lamang ibukod gamit ang mga regular na expression.

Halimbawa:

# Ibukod ang '/home/user/file.o' ngunit hindi ang '/home/user/file.odt': $ borg create -e '
*
.o' backup /

# Ibukod ang '/home/user/junk' at '/home/user/subdir/junk' ngunit # hindi
'/home/user/importantjunk' o '/etc/junk': $ borg create -e '/ home /
*
/junk' backup /

# Ibukod ang mga nilalaman ng '/home/user/cache' ngunit hindi ang mismong direktoryo: $ borg create
-e /home/user/cache/ backup /

# Ang file na '/home/user/cache/important' ay hindi naka-back up: $ borg lumikha -e
/home/user/cache/ backup / /home/user/cache/important

# Ang mga nilalaman ng mga direktoryo sa '/ home' ay hindi naba-back up kapag nagtapos ang kanilang pangalan #
'.tmp' $ borg create --exclude 're:^/ home /[^/]+.tmp/' backup /

# Mag-load ng mga pagbubukod mula sa file $ cat >exclude.txt < / home //basura * .tmp
fm:aa:something/ muli:^/ home /[^/].tmp/ sh:/ home /
*
/.thumbnails EOF $ borg gumawa --exclude-from exclude.txt backup /

MGA DEBUG UTOS

Mayroong ilang higit pang mga utos (lahat ay nagsisimula sa "debug-") na lahat hindi nilalayon para
normal gamitin at potensyal napaka mapanganib kung maling ginamit.

Umiiral ang mga ito upang mapabuti ang mga kakayahan sa pag-debug nang walang direktang pag-access sa system, hal
naranasan mo ang ilang malubhang malfunction. Gamitin lamang ang mga ito kung alam mo kung ano ang iyong ginagawa o
kung sasabihin sa iyo ng isang pinagkakatiwalaang developer ng Borg kung ano ang gagawin.

KARAGDAGANG NOTA

Narito ang misc. mga tala tungkol sa mga paksa na maaaring hindi sakop ng sapat na detalye sa paggamit
seksyon.

Bagay flag
borg lumikha -v --listahan naglalabas ng verbose list ng lahat ng file, direktoryo at iba pang file
mga item ng system na isinasaalang-alang nito (kahit na mayroon silang mga pagbabago sa nilalaman o wala). Para sa bawat isa
item, nilalagay nito ang isang solong titik na bandila na nagsasaad ng uri at/o katayuan ng item.

Kung interesado ka lang sa isang subset ng output na iyon, maaari kang magbigay ng hal --filter=AME at
magpapakita lamang ito ng mga regular na file na may katayuang A, M o E (tingnan sa ibaba).

Ang isang uppercase na character ay kumakatawan sa katayuan ng isang regular na file na may kaugnayan sa "mga file"
cache (hindi nauugnay sa repo -- isa itong isyu kung hindi ginagamit ang cache ng mga file).
Ang metadata ay nakaimbak sa anumang kaso at para sa 'A' at 'M' ay nakaimbak din ang mga bagong data chunks. Para sa
Ang 'U' lahat ng data chunks ay tumutukoy sa mga dati nang chunks.

· 'A' = regular na file, idinagdag (tingnan din ang a_status_oddity sa FAQ)

· 'M' = regular na file, binago

· 'U' = regular na file, hindi nagbabago

· 'E' = regular na file, isang error ang nangyari habang ina-access/nagbabasa ito file

Ang lowercase na character ay nangangahulugang isang uri ng file maliban sa isang regular na file, karaniwang borg lang
iniimbak ang kanilang metadata:

· 'd' = direktoryo

· 'b' = harangan ang aparato

· 'c' = char device

· 'h' = regular na file, hardlink (sa nakita nang inode)

· 's' = symlink

· 'f' = fifo

Ang iba pang mga flag na ginamit ay kinabibilangan ng:

· 'i' = binasa ang backup na data mula sa karaniwang input (stdin)

· '-' = dry run, aytem noon hindi sinuportahan

· '?' = nawawalang status code (kung nakita mo ito, mangyaring maghain ng ulat ng bug!)

--chunker-params
Ang mga chunker params ay nakakaimpluwensya kung paano ang mga input file ay pinutol sa mga piraso (chunks) na kung saan ay pagkatapos
isinasaalang-alang para sa deduplication. Mayroon din silang malaking epekto sa paggamit ng mapagkukunan (RAM at disk
space) dahil ang halaga ng mga mapagkukunang kailangan ay (din) tinutukoy ng kabuuang halaga ng
mga tipak sa imbakan (tingnan Ini-index / Mga cache memorya paggamit para sa mga detalye).

--chunker-params=10,23,16,4095 nagreresulta sa isang pinong deduplikasyon at lumilikha ng isang malaking
dami ng mga tipak at sa gayon ay gumagamit ng maraming mapagkukunan upang pamahalaan ang mga ito. Ito ay mabuti para sa
medyo maliit na dami ng data at kung ang makina ay may magandang halaga ng libreng RAM at disk
espasyo.

--chunker-params=19,23,21,4095 (default) ay nagreresulta sa isang coarse-grained deduplication at
lumilikha ng mas maliit na halaga ng mga tipak at sa gayon ay gumagamit ng mas kaunting mapagkukunan. Ito ay mabuti para sa
medyo malaking dami ng data at kung ang makina ay may medyo mababang halaga ng libreng RAM at
espasyo sa disk.

Kung nakagawa ka na ng ilang mga archive sa isang repositoryo at pagkatapos ay binago mo ang chunker params,
ito siyempre ay nakakaapekto sa deduplication dahil ang mga chunks ay iba-iba.

Sa pinakamasamang kaso (lahat ng mga file ay malaki at hinawakan sa pagitan ng mga backup), ito ay mag-iimbak
lahat ng nilalaman sa repositoryo muli.

Karaniwan, hindi ito masama bagaman:

· kadalasan ang karamihan sa mga file ay hindi ginagalaw, kaya muli nitong gagamitin ang mga lumang chunks na mayroon na ito
sa repo

· Ang mga file na mas maliit kaysa sa (parehong luma at bago) pinakamababang chunksize ay nagreresulta sa isang tipak lamang
gayon pa man, kaya ang mga resultang chunks ay pareho at ang deduplication ay ilalapat

Kung lilipat ka ng chunker params para makatipid ng mga mapagkukunan para sa isang umiiral nang repo na mayroon nang ilan
backup archive, makakakita ka ng tumataas na epekto sa paglipas ng panahon, kapag parami nang parami ang mga file
ay hinawakan at inimbak muli gamit ang mas malaking chunksize at lahat ng mga sanggunian sa
ang mas maliliit na mas lumang mga tipak ay inalis (sa pamamagitan ng pagtanggal / pagpuputol ng mga archive).

Kung gusto mong makakita ng agarang malaking epekto sa paggamit ng mapagkukunan, mas mabuting magsimula ka ng bago
repository kapag binabago ang chunker params.

Para sa higit pang mga detalye, tingnan ang chunker_details.

--basahin-espesyal
Ang pagpipilian --basahin-espesyal ay hindi inilaan para sa normal, antas ng filesystem (buo o
partly-recursive) na mga backup. Ibibigay mo lang ang opsyong ito kung gusto mong gumawa ng isang bagay
... espesyal -- at kung may napili kang mga file na gusto mong tratuhin sa ganoong paraan.

borg lumikha --basahin-espesyal bubuksan ang lahat ng mga file nang hindi gumagawa ng anumang espesyal na paggamot
ayon sa uri ng file (ang tanging pagbubukod dito ay mga direktoryo: sila ay uulitin
sa). Isipin mo na lang kung ano ang mangyayari kung gagawin mo pusa filename --- ang nilalaman na makikita mo doon
ay kung ano ang i-backup ni borg para sa filename na iyon.

Kaya, halimbawa, susundan ang mga symlink, babasahin ang nilalaman ng block device, pinangalanang pipe
/ UNIX domain sockets ay mababasa.

Kailangan mong maging maingat sa kung ano ang iyong ibibigay bilang filename kapag gumagamit --basahin-espesyal, hal. kung
bigyan mo /dev/zero, hindi kailanman magwawakas ang iyong backup.

Ang metadata ng ibinigay na mga file ay nai-save dahil ito ay isi-save nang wala --basahin-espesyal (hal nito
pangalan, laki nito [maaaring 0], mode nito, atbp.) -- ngunit bukod pa rito, ang nilalamang binasa
mula rito ay maliligtas para dito.

Ang pagpapanumbalik ng nilalaman ng naturang mga file ay kasalukuyang sinusuportahan lamang nang paisa-isa sa pamamagitan ng --stdout
opsyon (at kailangan mong i-redirect ang stdout sa kung saan man ito pupunta, maaaring direkta sa isang
umiiral na file ng device na iyong pinili o hindi direkta sa pamamagitan ng dd).

halimbawa
Isipin na nakagawa ka ng ilang mga snapshot ng mga lohikal na volume (LV) na gusto mong i-backup.

TANDAAN:
Para sa ilang mga sitwasyon, ito ay isang mahusay na paraan upang makakuha ng "tulad ng pag-crash" na pare-pareho (tawag ko dito
mala-crash dahil pareho ito ng makukuha mo kung pinindot mo lang ang reset button o
ang iyong makina ay biglang at ganap na babagsak). Ito ay mas mahusay kaysa sa walang pagkakapare-pareho
sa lahat at isang mahusay na paraan para sa ilang mga kaso ng paggamit, ngunit malamang na hindi sapat na mabuti kung mayroon ka
tumatakbo ang mga database.

Pagkatapos ay gagawa ka ng backup na archive ng lahat ng mga snapshot na ito. Ang backup na proseso ay makikita ang a
"frozen" na estado ng mga lohikal na volume, habang ang mga proseso ay gumagana sa orihinal na volume
ipagpatuloy ang pagbabago ng data na nakaimbak doon.

Idagdag mo rin ang output ng lvdisplay sa iyong backup, para makita mo ang mga laki ng LV kung sakali
kailangan mong muling likhain at ibalik ang mga ito.

Pagkatapos makumpleto ang backup, aalisin mo muli ang mga snapshot.

$ # lumikha ng mga snapshot dito
$ lvdisplay > lvdisplay.txt
$ borg lumikha --read-special /path/to/repo::arch lvdisplay.txt /dev/vg0/*-snapshot
$ # alisin ang mga snapshot dito

Ngayon, tingnan natin kung paano i-restore ang ilang LV mula sa naturang backup.

$ borg extract /path/to/repo::arch lvdisplay.txt
$ # lumikha ng mga walang laman na LV na may tamang laki dito (tingnan ang lvdisplay.txt).
$ # ipinapalagay namin na lumikha ka ng walang laman na ugat at home LV at i-overwrite ito ngayon:
$ 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

Append-only paraan
Ang isang repository ay maaaring gawing "idagdag-lamang", na nangangahulugang hindi kailanman i-overwrite ni Borg o
tanggalin ang nakatuon na data. Ito ay kapaki-pakinabang para sa mga sitwasyon kung saan maraming mga makina ang nag-back up sa a
central backup server gamit borg maglingkod, dahil hindi makakapagtanggal ng mga backup ang isang na-hack na makina
permanenteng.

Para i-activate ang append-only mode, i-edit ang repository config file at magdagdag ng linya append_only=1
sa [imbakan] seksyon (o i-edit ang linya kung mayroon).

Sa append-only mode, gagawa si Borg ng log ng transaksyon sa linay file, kung saan
bawat linya ay isang transaksyon at isang timestamp ng UTC.

halimbawa
Ipagpalagay na ang isang umaatake ay malayuang tinanggal ang lahat ng mga backup, ngunit ang iyong repositoryo ay nasa append-only
mode. Maaaring ganito ang hitsura ng log ng transaksyon sa sitwasyong ito:

transaksyon 1, oras ng UTC 2016-03-31T15:53:27.383532
transaksyon 5, oras ng UTC 2016-03-31T15:53:52.588922
transaksyon 11, oras ng UTC 2016-03-31T15:54:23.887256
transaksyon 12, oras ng UTC 2016-03-31T15:55:54.022540
transaksyon 13, oras ng UTC 2016-03-31T15:55:55.472564

Mula sa iyong mga log ng seguridad, napagpasyahan mong nakakuha ng access ang umaatake sa 15:54:00 at lahat ng
mga backup kung saan tinanggal o pinalitan ng mga nakompromisong backup. Mula sa log alam mo na
ang mga transaksyon 11 at mas bago ay nakompromiso. Tandaan na ang transaction ID ay ang pangalan ng
huli file sa transaksyon. Halimbawa, ang transaksyon 11 ay sumasaklaw sa mga file 6 hanggang 11.

Sa isang tunay na pag-atake, malamang na gusto mong panatilihing buo ang nakompromisong repository upang suriin
kung ano ang sinubukang makamit ng umaatake. Magandang ideya din na gawin itong kopya kung sakali
may mali sa panahon ng pagbawi. Dahil ang pagbawi ay ginagawa sa pamamagitan ng pagtanggal ng ilang file, a
hard link copy (cp -sa) ay sapat na.

Ang unang hakbang upang i-reset ang repository sa transaksyon 5, ang huling hindi nakompromiso
transaksyon, ay alisin ang mga pahiwatig.N at index.N mga file sa repositoryo (ang dalawang file na ito
ay laging nagagastos). Sa halimbawang ito, ang N ay 13.

Pagkatapos ay alisin o ilipat ang lahat ng mga file ng segment mula sa mga direktoryo ng segment data / nagsisimula sa
file 6:

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

Hanggang dito na lang.

drawbacks
Dahil ang data ay idinagdag lamang, at walang tinanggal, tulad ng mga utos putulin or alisin hindi libre
espasyo sa disk, tina-tag lang nila ang data bilang tinanggal sa isang bagong transaksyon.

Tandaan na maaari kang bumalik-balik sa pagitan ng normal at append-only na operasyon sa pamamagitan ng pag-edit
ang configuration file, hindi ito "one way trip".

Pa pagsasaalang-alang
Ang append-only na mode ay hindi iginagalang ng mga tool maliban sa Borg. rm gumagana pa rin sa
imbakan. Siguraduhin na ang mga backup client machine ay nakaka-access lamang sa repository sa pamamagitan ng
borg maglingkod.

Tiyaking walang malayuang pag-access ang posible kung pansamantalang nakatakda sa normal ang repositoryo
mode para sa hal. regular na pruning.

Maaaring ipatupad ang mga karagdagang proteksyon, ngunit nasa labas ng saklaw ng Borgs. Halimbawa, file
mga snapshot o pambalot ng system borg maglingkod upang magtakda ng mga espesyal na pahintulot o ACL sa bagong data
file.

Gamitin ang borgbackup online gamit ang mga serbisyo ng onworks.net