borgbackup - Online di Cloud

PROGRAM:

NAMA

borg - BorgBackup adalah program pencadangan yang menghapus duplikasi dengan kompresi opsional dan
enkripsi yang diautentikasi.

Borg terdiri dari sejumlah perintah. Setiap perintah menerima sejumlah argumen dan
pilihan. Bagian berikut akan menjelaskan setiap perintah secara rinci.

UMUM

Tipe of mencatat keluaran
Tingkat log konfigurasi logging bawaan default ke PERINGATAN. Hal ini karena
kami ingin Borg sebagian besar diam dan hanya menampilkan peringatan, kesalahan, dan pesan penting.

Level log: DEBUG < INFO < PERINGATAN < KESALAHAN < KRITIS

penggunaan --debug untuk mengatur level log DEBUG - untuk mendapatkan debug, info, peringatan, kesalahan, dan level kritis
output.

penggunaan --info (Atau -v or --bertele-tele) untuk mengatur level log INFO - untuk mendapatkan info, peringatan, kesalahan, dan
keluaran tingkat kritis.

penggunaan --peringatan (default) untuk mengatur level log PERINGATAN - untuk mendapatkan peringatan, kesalahan, dan kritis
keluaran tingkat.

penggunaan --kesalahan untuk mengatur level log ERROR - untuk mendapatkan error dan output level kritis.

penggunaan --kritis untuk mengatur level log KRITIS - untuk mendapatkan output level kritis.

Meskipun Anda dapat mengatur misc. tingkat log, jangan berharap bahwa setiap perintah akan memberikan yang berbeda
output pada level log yang berbeda - itu hanya kemungkinan.

PERINGATAN:
Opsi --critical dan --error disediakan untuk kelengkapan, penggunaannya tidak
direkomendasikan karena Anda mungkin melewatkan informasi penting.

PERINGATAN:
Sementara beberapa opsi (seperti --statistik or --Daftar) akan memancarkan lebih banyak pesan informasi, Anda
harus menggunakan level log INFO (atau lebih rendah) untuk membuatnya muncul di keluaran log. Menggunakan -v atau
konfigurasi pencatatan.

Pengembalian Kode
Borg dapat keluar dengan kode pengembalian berikut (rc):

0 = berhasil (dicatat sebagai INFO)
1 = peringatan (operasi mencapai akhir normal, tetapi ada peringatan -
anda harus memeriksa log, masuk sebagai PERINGATAN)
2 = kesalahan (seperti kesalahan fatal, pengecualian lokal atau jarak jauh, operasi
tidak mencapai akhir normalnya, dicatat sebagai ERROR)
128+N = dibunuh oleh sinyal N (misalnya 137 == bunuh -9)

Jika Anda menggunakan --tunjukkan-rc, kode pengembalian juga dicatat pada level yang ditunjukkan sebagai yang terakhir
entri log.

Lingkungan Hidup Variabel
Borg menggunakan beberapa variabel lingkungan untuk otomatisasi:

Umum:

BORG_REPO
Saat disetel, gunakan nilai untuk memberikan lokasi repositori default. Jika sebuah
perintah membutuhkan parameter arsip, Anda dapat menyingkatnya sebagai ::Arsip. Jika sebuah
perintah membutuhkan parameter repositori, Anda dapat meninggalkannya atau
disingkat sebagai ::, jika parameter posisi diperlukan.

BORG_PASSPHRASE
Saat disetel, gunakan nilai untuk menjawab pertanyaan frasa sandi untuk dienkripsi
repositori.

BORG_DISPLAY_PASSPHRASE
Saat disetel, gunakan nilai untuk menjawab "tampilkan frasa sandi untuk
verifikasi" pertanyaan saat mendefinisikan frasa sandi baru untuk dienkripsi
repositori.

BORG_LOGGING_CONF
Saat disetel, gunakan nama file yang diberikan sebagai MULAILAHkonfigurasi logging -gaya.

BORG_RSH
Saat disetel, gunakan perintah ini alih-alih ssh. Ini dapat digunakan untuk menentukan ssh
opsi, seperti file identitas khusus ssh -i /path/ke/pribadi/kunci. Lihat pria
ssh untuk opsi lain.

TMPDIR di mana file-file sementara disimpan (mungkin membutuhkan banyak ruang sementara untuk
beberapa operasi)

Beberapa otomatis penjawab (jika set, mereka secara otomatis menjawab konfirmasi pertanyaan):

BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK=tidak (Atau = ya)
Untuk "Peringatan: Mencoba mengakses yang sebelumnya tidak diketahui tidak terenkripsi
gudang"

BORG_RELOCATED_REPO_ACCESS_IS_OK=tidak (Atau = ya)
Untuk "Peringatan: Repositori di lokasi ... sebelumnya terletak di ..."

BORG_CHECK_I_KNOW_WHAT_I_AM_DOING=TIDAK (Atau =YA)
Untuk "Peringatan: 'periksa --perbaikan' adalah fitur eksperimental yang mungkin terjadi
kehilangan data."

BORG_DELETE_I_KNOW_WHAT_I_AM_DOING=TIDAK (Atau =YA)
Untuk "Anda meminta untuk sepenuhnya MENGHAPUS repositori termasuk semua
arsip yang dikandungnya:"

Catatan: jawaban peka huruf besar/kecil. menetapkan nilai jawaban yang tidak valid mungkin memberikan
jawaban default atau menanyakan Anda secara interaktif, tergantung pada apakah coba lagi
diperbolehkan (secara default diperbolehkan). Jadi, silakan uji skrip Anda secara interaktif
sebelum menjadikannya skrip non-interaktif.

Direktori:

BORG_KEYS_DIR
Bawaan ke '~/.config/borg/keys'. Direktori ini berisi kunci untuk dienkripsi
repositori.

BORG_CACHE_DIR
Bawaan ke '~/.cache/borg'. Direktori ini berisi cache lokal dan
mungkin membutuhkan banyak ruang untuk berurusan dengan repositori besar).

Bangunan:

BORG_OPENSSL_PREFIX
Menambahkan direktori file header OpenSSL yang diberikan ke lokasi default
(setup.py).

BORG_LZ4_PREFIX
Menambahkan direktori file header LZ4 yang diberikan ke lokasi default (setup.py).

Harap diperhatikan:

· berhati-hatilah saat menggunakan ucapan "ya", peringatan dengan prompt ada untuk Anda /
keamanan/keselamatan data Anda

· juga sangat berhati-hati saat memasukkan kata sandi Anda ke dalam skrip, pastikan itu memiliki
izin file yang sesuai (mis. mode 600, root:root).

Sumber penggunaan
Borg mungkin menggunakan banyak sumber daya tergantung pada ukuran kumpulan data yang ditangani
dengan.

CPU: Itu tidak akan melampaui 100% dari 1 inti karena kodenya saat ini adalah utas tunggal.
Terutama tingkat kompresi zlib dan lzma yang lebih tinggi menggunakan CPU dalam jumlah yang signifikan
siklus.

Memori (R.A.M):
Indeks potongan dan indeks file dibaca ke dalam memori untuk alasan kinerja.
Kompresi, mis. Kompresi lzma dengan level tinggi mungkin membutuhkan jumlah yang besar
memori.

Sementara file:
Membaca data dan metadata dari repositori yang dipasang FUSE akan menghabiskan sekitar
ruang yang sama dengan potongan yang dideduplikasi yang digunakan untuk mewakilinya dalam repositori.

Cache file:
Berisi indeks potongan dan indeks file (ditambah koleksi terkompresi dari
indeks potongan arsip tunggal).

Bongkahan indeks:
Sebanding dengan jumlah potongan data di repo Anda. Banyak potongan di repo Anda
menyiratkan indeks potongan besar. Dimungkinkan untuk men-tweak params chunker (lihat create
pilihan).

File indeks:
Proporsional dengan jumlah file dalam cadangan terakhir Anda. Dapat dimatikan (lihat
buat opsi), tetapi pencadangan berikutnya akan jauh lebih lambat jika Anda melakukannya.

jaringan:
Jika repositori Anda jauh, semua duplikatnya (dan secara opsional dikompresi/
dienkripsi) data tentu saja harus melalui koneksi (ssh: repo url). Jika kamu
gunakan sistem file jaringan yang dipasang secara lokal, selain itu beberapa operasi penyalinan digunakan
untuk dukungan transaksi juga melalui koneksi. Jika Anda mencadangkan banyak sumber
ke satu repositori target, lalu lintas tambahan terjadi untuk sinkronisasi ulang cache.

Jika Anda tertarik dengan detail lebih lanjut, silakan baca dokumentasi internal.

unit
Untuk menampilkan kuantitas, Borg memperhatikan konvensi skala yang biasa. Disk
ukuran ditampilkan di desimal, menggunakan kekuatan sepuluh (jadi kB berarti 1000 byte). Untuk memori
pemakaian, biner awalan digunakan, dan ditunjukkan dengan menggunakan IEC biner awalan, Menggunakan
kekuatan dua (jadi KiB berarti 1024 byte).

Tanggal dan Waktu
Kami memformat tanggal dan waktu sesuai dengan ISO-8601, yaitu: YYYY-MM-DD dan HH:MM:SS (24j
jam).

Untuk informasi lebih lanjut tentang itu, lihat: https://xkcd.com/1179/

Kecuali dinyatakan lain, kami menampilkan tanggal dan waktu lokal. Secara internal, kami menyimpan dan memproses
tanggal dan waktu sebagai UTC.

BOR INIT

penggunaan: borg init [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-tunggu N] [--show-rc] [--tidak ada file-cache] [--umask M]
[--JALAN jalur jarak jauh] [-e {none,keyfile,repokey}]
[GUDANG]

Inisialisasi repositori kosong

argumen posisi:
REPOSITORY repositori untuk dibuat

argumen opsional:
-h, --help tampilkan pesan bantuan ini dan keluar
--pekerjaan kritis pada level log KRITIS
--error bekerja pada level log ERROR
--warning bekerja pada level log PERINGATAN (default)
--info, -v, --verbose
bekerja pada INFO tingkat log
--debug bekerja pada tingkat log DEBUG
--lock-wait N menunggu kunci, tapi maks. N detik (default: 1).
--show-rc tampilkan/log kode pengembalian (rc)
--no-files-cache jangan memuat/memperbarui cache metadata file yang digunakan untuk
mendeteksi file yang tidak berubah
--umask M set umask ke M (lokal dan jarak jauh, default: 0077)
--remote-path PATH atur jalur jarak jauh ke executable (default: "borg")
-e {none,keyfile,repokey}, --enkripsi {none,keyfile,repokey}
pilih mode kunci enkripsi (default: "repokey")

Deskripsi Produk
Perintah ini menginisialisasi repositori kosong. Repositori adalah direktori sistem file
berisi data deduplikasi dari nol atau lebih arsip. Enkripsi dapat diaktifkan di
waktu init repositori.

contoh
# Repositori lokal (default adalah menggunakan enkripsi dalam mode repokey)
$borg init /path/ke/repo

# Repositori lokal (tanpa enkripsi)
$borg init --encryption=none /path/to/repo

# Repositori jarak jauh (mengakses borg jarak jauh melalui ssh)
$borg init user@hostname:backup

# Repositori jarak jauh (simpan kunci dir rumah Anda)
$borg init --encryption=keyfile user@hostname:backup

Catatan penting tentang enkripsi:

Tidak disarankan untuk menonaktifkan enkripsi. Enkripsi repositori melindungi Anda, mis
terhadap kasus penyerang memiliki akses ke repositori cadangan Anda.

Tapi hati-hati dengan kunci / frasa sandi:

Jika Anda menginginkan keamanan "hanya frasa sandi", gunakan penyangkalan mode. Kuncinya akan disimpan
di dalam repositori (dalam file "config"). Dalam skenario serangan yang disebutkan di atas,
penyerang akan memiliki kuncinya (tetapi bukan frasa sandi).

Jika Anda menginginkan keamanan "frasa sandi dan memiliki kunci", gunakan file kunci mode. Kuncinya akan
disimpan di direktori home Anda (di .config/borg/kunci). Dalam skenario serangan,
penyerang yang baru saja mengakses repo Anda tidak akan memiliki kuncinya (dan juga bukan
frasa sandi).

Buat salinan cadangan dari file kunci (file kunci mode) atau file konfigurasi repo (penyangkalan modus) dan
simpan di tempat yang aman, sehingga Anda masih memiliki kunci jika rusak atau hilang. Juga
simpan frasa sandi di tempat yang aman. Cadangan yang dienkripsi dengan kunci itu tidak akan
membantu Anda dengan itu, tentu saja.

Pastikan Anda menggunakan frasa sandi yang baik. Tidak terlalu pendek, tidak terlalu sederhana. Enkripsi sebenarnya /
kunci dekripsi dienkripsi dengan / dikunci oleh frasa sandi Anda. Jika penyerang mendapatkan
kuncinya, dia tidak bisa membuka dan menggunakannya tanpa mengetahui kata sandinya.

Hati-hati dengan karakter khusus atau non-ascii dalam frasa sandi Anda:

· Borg memproses frasa sandi sebagai unicode (dan mengkodekannya sebagai utf-8), sehingga tidak memiliki
masalah berurusan dengan bahkan karakter yang paling aneh.

· TAPI: itu tidak selalu berlaku untuk konfigurasi OS / VM / keyboard Anda.

Jadi lebih baik gunakan frasa sandi panjang yang terbuat dari karakter ascii sederhana daripada yang menyertakan
hal-hal atau karakter non-ascii yang sulit/tidak mungkin untuk dimasukkan pada keyboard yang berbeda
tata letak.

Anda dapat mengubah frasa sandi untuk repo yang ada kapan saja, itu tidak akan memengaruhi
kunci enkripsi/dekripsi atau rahasia lainnya.

BOR MEMBUAT

penggunaan: borg create [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-tunggu N] [--show-rc] [--tidak ada file-cache] [--umask M]
[--JALAN jalur jarak jauh] [-s] [-p] [--daftar]
[--filter STATUSCHARS] [-e POLA]
[--kecualikan-dari EXCLUDEFILE] [--kecualikan-cache]
[--kecualikan-jika-ada NAMA FILE] [--simpan-tag-file]
[-c DETIK] [-x] [--numeric-owner]
[--stempel waktu yyyy-mm-ddThh:mm:dd]
[--chunker-params CHUNK_MIN_EXP,CHUNK_MAX_EXP,HASH_MASK_BITS,HASH_WINDOW_SIZE]
[--abaikan-inode] [-C KOMPRESI] [--baca-khusus] [-n]
JALAN ARSIP [JALAN ...]

Buat arsip baru

argumen posisi:
ARSIP nama arsip yang akan dibuat (harus juga valid
nama direktori)
Jalur PATH ke arsip

argumen opsional:
-h, --help tampilkan pesan bantuan ini dan keluar
--pekerjaan kritis pada level log KRITIS
--error bekerja pada level log ERROR
--warning bekerja pada level log PERINGATAN (default)
--info, -v, --verbose
bekerja pada INFO tingkat log
--debug bekerja pada tingkat log DEBUG
--lock-wait N menunggu kunci, tapi maks. N detik (default: 1).
--show-rc tampilkan/log kode pengembalian (rc)
--no-files-cache jangan memuat/memperbarui cache metadata file yang digunakan untuk
mendeteksi file yang tidak berubah
--umask M set umask ke M (lokal dan jarak jauh, default: 0077)
--remote-path PATH atur jalur jarak jauh ke executable (default: "borg")
-s, --stats mencetak statistik untuk arsip yang dibuat
-p, --progress menunjukkan tampilan kemajuan saat membuat arsip,
menunjukkan ukuran Asli, Terkompresi dan Deduplikasi,
diikuti oleh Jumlah file yang dilihat dan jalurnya
sedang diproses, default: Salah
--list output daftar verbose item (file, dir, ...)
--filter STATUSCHARS hanya menampilkan item dengan karakter status yang diberikan
-e POLA, --kecuali POLA
kecualikan jalur yang cocok dengan POLA
--kecuali-dari EXCLUDEFILE
baca pola pengecualian dari EXCLUDEFILE, satu per baris
--exclude-caches mengecualikan direktori yang berisi file CACHEDIR.TAG
(http://www.brynosaurus.com/cachedir/spec.html)
--kecualikan-jika-ada NAMA FILE
mengecualikan direktori yang berisi file tertentu
--keep-tag-files menyimpan file tag dari cache/direktori yang dikecualikan
-c DETIK, --checkpoint-interval DETIK
tulis pos pemeriksaan setiap DETIK detik (Default: 300)
-x, --satu-file-sistem
tetap di sistem file yang sama, jangan melewati titik pemasangan
--numeric-owner hanya menyimpan pengguna numerik dan pengidentifikasi grup
--cap waktu yyyy-mm-ddThh:mm:dd
tentukan secara manual tanggal/waktu pembuatan arsip (UTC).
sebagai alternatif, berikan file/direktori referensi.
--chunker-params CHUNK_MIN_EXP,CHUNK_MAX_EXP,HASH_MASK_BITS,HASH_WINDOW_SIZE
tentukan parameter chunker. default: 19,23,21,4095
--ignore-inode mengabaikan data inode dalam cache metadata file yang digunakan untuk
mendeteksi file yang tidak berubah.
-C KOMPRESI, --kompresi KOMPRESI
pilih algoritma kompresi (dan level): tidak ada == tidak
kompresi (default), lz4 == lz4, zlib == zlib
(default level 6), zlib,0 .. zlib,9 == zlib (dengan
tingkat 0..9), lzma == lzma (tingkat default 6), lzma,0 ..
lzma,9 == lzma (dengan level 0..9).
--read-special membuka dan membaca file khusus seolah-olah itu biasa
arsip
-n, --dry-run jangan buat arsip cadangan

Deskripsi Produk
Perintah ini membuat arsip cadangan yang berisi semua file yang ditemukan saat secara rekursif
melintasi semua jalur yang ditentukan. Arsip hampir tidak menggunakan ruang disk untuk file atau
bagian dari file yang telah disimpan di arsip lain.

Untuk mempercepat penarikan cadangan melalui sshfs dan sistem file jaringan serupa yang tidak
memberikan informasi inode yang benar flag --ignore-inode dapat digunakan. Ini berpotensi
mengurangi keandalan deteksi perubahan, sambil menghindari selalu membaca semua file di
sistem file ini.

Lihat output dari perintah "borg help pattern" untuk bantuan lebih lanjut tentang mengecualikan pola.

contoh
# Cadangan ~ / Dokumen ke dalam arsip bernama "dokumen-saya"
$ borg buat /path/to/repo::my-documents ~ / Dokumen

# sama, tetapi daftarkan semua file saat kami memprosesnya
$ borg buat -v --list /path/to/repo::my-documents ~ / Dokumen

# Cadangan ~ / Dokumen dan ~/src tetapi kecualikan file pyc
$ borg buat /path/to/repo::my-files \
~ / Dokumen \
~/src \
--kecualikan '*.pyc'

# Cadangan direktori home tidak termasuk thumbnail gambar (yaitu hanya
# /rumah/*/.thumbnail tidak termasuk, bukan /rumah/*/*/.thumbnail)
$ borg buat /path/to/repo::my-files / Home \
--tidak termasuk 're:^/rumah/[^/]+/\.thumbnail/'

# Lakukan hal yang sama menggunakan pola gaya shell
$ borg buat /path/to/repo::my-files / Home \
--kecualikan 'sh:/rumah/*/.thumbnail'

# Cadangkan sistem file root ke dalam arsip bernama "root-YYYY-MM-DD"
# gunakan kompresi zlib (bagus, tapi lambat) - defaultnya tidak ada kompresi
$ borg buat -C zlib,6 /path/to/repo::root-{now:%Y-%m-%d} / --one-file-system

# Lakukan upaya besar dalam deduplikasi granular halus (manajemen potongan besar
# overhead, membutuhkan banyak RAM dan ruang disk, lihat rumus di internal
# docs - parameter yang sama dengan borg <1.0 atau loteng):
$ borg buat --chunker-params 10,23,16,4095 /path/ke/repo::small /smallstuff

# Cadangkan perangkat mentah (tidak boleh aktif/sedang digunakan/dipasang saat itu)
$ dd if=/dev/sdx bs=10M | borg buat /path/ke/repo::my-sdx -

# Tidak ada kompresi (default)
$ borg buat /path/to/repo::arch ~

# Super cepat, kompresi rendah
$ borg buat --kompresi lz4 /path/to/repo::arch ~

# Kurang cepat, kompresi lebih tinggi (N = 0)
$ borg buat --kompresi zlib,N /path/to/repo::arch ~

# Bahkan lebih lambat, kompresi lebih tinggi (N = 0)
$ borg buat --kompresi lzma,N /path/to/repo::arch ~

# Tag format tersedia untuk nama arsip:
# {sekarang}, {utcnow}, {fqdn}, {hostname}, {pengguna}, {pid}
# tambahkan nama host pendek, nama pengguna cadangan, dan waktu unix saat ini (detik dari zaman)
$ borg buat /path/to/repo::{hostname}-{user}-{now:%s} ~

BOR EKSTRAK

penggunaan: ekstrak borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-tunggu N] [--show-rc] [--tidak ada file-cache] [--umask M]
[--JALAN jalur jarak jauh] [--daftar] [-n] [-e POLA]
[--kecuali-dari EXCLUDEFILE] [--numeric-owner]
[--strip-komponen NUMBER] [--stdout] [--sparse]
ARSIP [JALAN [JALAN ...]]

Ekstrak konten arsip

argumen posisi:
Arsip arsip untuk mengekstrak
jalur PATH untuk mengekstrak; pola didukung

argumen opsional:
-h, --help tampilkan pesan bantuan ini dan keluar
--pekerjaan kritis pada level log KRITIS
--error bekerja pada level log ERROR
--warning bekerja pada level log PERINGATAN (default)
--info, -v, --verbose
bekerja pada INFO tingkat log
--debug bekerja pada tingkat log DEBUG
--lock-wait N menunggu kunci, tapi maks. N detik (default: 1).
--show-rc tampilkan/log kode pengembalian (rc)
--no-files-cache jangan memuat/memperbarui cache metadata file yang digunakan untuk
mendeteksi file yang tidak berubah
--umask M set umask ke M (lokal dan jarak jauh, default: 0077)
--remote-path PATH atur jalur jarak jauh ke executable (default: "borg")
--list output daftar verbose item (file, dir, ...)
-n, --dry-run sebenarnya tidak mengubah file apa pun
-e POLA, --kecuali POLA
kecualikan jalur yang cocok dengan POLA
--kecuali-dari EXCLUDEFILE
baca pola pengecualian dari EXCLUDEFILE, satu per baris
--numeric-owner hanya mematuhi pengguna numerik dan pengidentifikasi grup
--strip-komponen NUMBER
Hapus jumlah elemen jalur utama yang ditentukan.
Pathname dengan lebih sedikit elemen akan diam-diam
dilewati.
--stdout tulis semua data yang diekstraksi ke stdout
--sparse membuat lubang di file sparse keluaran dari nol
potongan

Deskripsi Produk
Perintah ini mengekstrak isi arsip. Secara default, seluruh arsip adalah
diekstraksi tetapi subset file dan direktori dapat dipilih dengan melewati daftar PATH
sebagai argumen. Pemilihan file selanjutnya dapat dibatasi dengan menggunakan --mengecualikan .

Lihat output dari perintah "borg help pattern" untuk bantuan lebih lanjut tentang mengecualikan pola.

contoh
# Ekstrak seluruh arsip
$ borg ekstrak /path/to/repo::my-files

# Ekstrak seluruh arsip dan daftar file saat memproses
$ borg ekstrak -v --list /path/to/repo::my-files

# Ekstrak direktori "src"
$ borg ekstrak /path/to/repo::my-files home/USERNAME/src

# Ekstrak direktori "src" tetapi kecualikan file objek
$ borg ekstrak /path/to/repo::my-files home/USERNAME/src --exclude '*.o'

# Mengembalikan perangkat mentah (tidak boleh aktif/sedang digunakan/dipasang saat itu)
$ borg ekstrak --stdout /path/to/repo::my-sdx | dd dari=/dev/sdx bs=10M

Catatan: saat ini, ekstrak selalu menulis ke itu arus kerja direktori ("."),
jadi pastikan kamu cd ke tempat yang tepat sebelum menelepon borg ekstrak.

BOR TARIF

penggunaan: borg check [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-tunggu N] [--show-rc] [--tidak ada file-cache] [--umask M]
[--JALAN jalur jarak jauh] [--repository-only] [--archives-only]
[--perbaikan] [--hemat-spasi] [--terakhir N] [-P PREFIX]
[REPOSITORY_OR_ARCHIVE]

Periksa konsistensi repositori

argumen posisi:
REPOSITORY_OR_ARCHIVE
repositori atau arsip untuk memeriksa konsistensi

argumen opsional:
-h, --help tampilkan pesan bantuan ini dan keluar
--pekerjaan kritis pada level log KRITIS
--error bekerja pada level log ERROR
--warning bekerja pada level log PERINGATAN (default)
--info, -v, --verbose
bekerja pada INFO tingkat log
--debug bekerja pada tingkat log DEBUG
--lock-wait N menunggu kunci, tapi maks. N detik (default: 1).
--show-rc tampilkan/log kode pengembalian (rc)
--no-files-cache jangan memuat/memperbarui cache metadata file yang digunakan untuk
mendeteksi file yang tidak berubah
--umask M set umask ke M (lokal dan jarak jauh, default: 0077)
--remote-path PATH atur jalur jarak jauh ke executable (default: "borg")
--repository-only hanya melakukan pemeriksaan repositori
--archives-only hanya melakukan pemeriksaan arsip
--perbaikan upaya untuk memperbaiki ketidakkonsistenan yang ditemukan
--save-space bekerja lebih lambat, tetapi menggunakan lebih sedikit ruang
--last N hanya memeriksa arsip N terakhir (Default: semua)
-P PREFIX, --awalan PREFIX
hanya pertimbangkan nama arsip yang dimulai dengan awalan ini

Deskripsi Produk
Perintah check memverifikasi konsistensi repositori dan arsip yang sesuai.

Pertama, file data repositori yang mendasari diperiksa:

· Untuk semua segmen, sihir segmen (tajuk) dicentang

· Untuk semua objek yang disimpan dalam segmen, semua metadata (misalnya crc dan ukuran) dan semua data adalah
Baca. Data yang dibaca diperiksa berdasarkan ukuran dan CRC. Sedikit busuk dan jenis kecelakaan lainnya
kerusakan dapat dideteksi dengan cara ini.

· Jika kami berada dalam mode perbaikan dan kesalahan integritas terdeteksi untuk suatu segmen, kami mencoba untuk
memulihkan sebanyak mungkin objek dari segmen tersebut.

· Dalam mode perbaikan, ini memastikan bahwa indeks konsisten dengan data yang disimpan di
segmen.

· Jika Anda menggunakan server repo jarak jauh melalui ssh:, pemeriksaan repo dijalankan di server repo
tanpa menyebabkan lalu lintas jaringan yang signifikan.

· Pemeriksaan repositori dapat dilewati menggunakan opsi --archives-only.

Kedua, konsistensi dan kebenaran metadata arsip diverifikasi:

· Apakah manifes repo ada? Jika tidak, itu dibangun kembali dari potongan metadata arsip (ini
membutuhkan membaca dan mendekripsi semua metadata dan data).

· Periksa apakah ada potongan metadata arsip. jika tidak, hapus arsip dari manifes.

· Untuk semua file (item) dalam arsip, untuk semua potongan yang dirujuk oleh file-file ini, periksa apakah
potongan hadir (jika tidak dan kami dalam mode perbaikan, ganti dengan potongan ukuran yang sama dari
nol). Ini membutuhkan pembacaan arsip dan metadata file, tetapi bukan data.

· Jika kami dalam mode perbaikan dan kami memeriksa semua arsip: hapus potongan yatim piatu dari
repo.

· jika Anda menggunakan server repo jarak jauh melalui ssh:, pemeriksaan arsip dijalankan pada klien
mesin (karena jika enkripsi diaktifkan, pemeriksaan akan memerlukan dekripsi dan ini
selalu dilakukan sisi klien, karena akses kunci akan diperlukan).

· Pemeriksaan arsip dapat memakan waktu lama, dapat dilewati dengan menggunakan
--opsi hanya-repositori.

BOR RENAME

penggunaan: borg rename [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-tunggu N] [--show-rc] [--tidak ada file-cache] [--umask M]
[--JALAN jalur jarak jauh]
ARSIP NAMA BARU

Ganti nama arsip yang ada

argumen posisi:
Arsip arsip untuk diganti namanya
NEWNAME nama arsip baru yang akan digunakan

argumen opsional:
-h, --help tampilkan pesan bantuan ini dan keluar
--pekerjaan kritis pada level log KRITIS
--error bekerja pada level log ERROR
--warning bekerja pada level log PERINGATAN (default)
--info, -v, --verbose
bekerja pada INFO tingkat log
--debug bekerja pada tingkat log DEBUG
--lock-wait N menunggu kunci, tapi maks. N detik (default: 1).
--show-rc tampilkan/log kode pengembalian (rc)
--no-files-cache jangan memuat/memperbarui cache metadata file yang digunakan untuk
mendeteksi file yang tidak berubah
--umask M set umask ke M (lokal dan jarak jauh, default: 0077)
--remote-path PATH atur jalur jarak jauh ke executable (default: "borg")

Deskripsi Produk
Perintah ini mengganti nama arsip di repositori.

contoh
$ borg buat /path/to/repo::archivename ~
$ daftar borg /path/ke/repo
nama arsip Sen, 2016-02-15 19:50:19

$ borg mengganti nama /path/ke/repo::archivename nama baru
$ daftar borg /path/ke/repo
nama baru Sen, 2016-02-15 19:50:19

BOR DAFTAR

penggunaan: daftar borg [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-tunggu N] [--show-rc] [--tidak ada file-cache] [--umask M]
[--JALAN jalur jarak jauh] [--short] [--format daftar LISTFORMAT]
[-P Awalan]
[REPOSITORY_OR_ARCHIVE]

Daftar arsip atau isi repositori

argumen posisi:
REPOSITORY_OR_ARCHIVE
repositori/arsip untuk membuat daftar isi

argumen opsional:
-h, --help tampilkan pesan bantuan ini dan keluar
--pekerjaan kritis pada level log KRITIS
--error bekerja pada level log ERROR
--warning bekerja pada level log PERINGATAN (default)
--info, -v, --verbose
bekerja pada INFO tingkat log
--debug bekerja pada tingkat log DEBUG
--lock-wait N menunggu kunci, tapi maks. N detik (default: 1).
--show-rc tampilkan/log kode pengembalian (rc)
--no-files-cache jangan memuat/memperbarui cache metadata file yang digunakan untuk
mendeteksi file yang tidak berubah
--umask M set umask ke M (lokal dan jarak jauh, default: 0077)
--remote-path PATH atur jalur jarak jauh ke executable (default: "borg")
--singkat hanya mencetak nama file/direktori, tidak ada yang lain
--format-daftar LISTFORMAT
tentukan format untuk daftar file arsip (default:
"{mode} {pengguna:6} {grup:6} {ukuran:8d} {isomtime}
{path}{extra}{NEWLINE}") Khusus "{formatkeys}" ada
untuk membuat daftar kunci yang tersedia
-P PREFIX, --awalan PREFIX
hanya pertimbangkan nama arsip yang dimulai dengan awalan ini

Deskripsi Produk
Perintah ini mencantumkan konten repositori atau arsip.

contoh
$ daftar borg /path/ke/repo
Senin Sen, 2016-02-15 19:15:11
repo Sen, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
nama baru Sen, 2016-02-15 19:50:19
...

$ borg daftar /path/ke/repo::root-2016-02-15
drwxr-xr-x root root 0 Sen, 2016-02-15 17:44:27 .
drwxrwxr-x root root 0 Sen, 2016-02-15 19:04:49 bin
-rwxr-xr-x root root 1029624 Kam, 2014-11-13 00:08:51 bin/bash
lrwxrwxrwx root root 0 Jum, 2015-03-27 20:24:26 bin/bzcmp -> bzdiff
-rwxr-xr-x root root 2140 Jum, 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 pengguna pengguna 0 Min, 2015-02-01 11:00:00 .
drwxrwxr-x pengguna pengguna 0 Min, 2015-02-01 11:00:00 kode
drwxrwxr-x pengguna pengguna 0 Min, 2015-02-01 11:00:00 kode/proyek saya
-rw-rw-r-- pengguna pengguna 1416192 Min, 2015-02-01 11:00:00 code/myproject/file.ext
...

# lihat apa yang berubah di antara arsip, berdasarkan waktu modifikasi file, ukuran, dan jalur file
$ borg list /path/to/repo::archiveA --list-format="{mtime:%s}{TAB}{size}{TAB}{path}{LF}" |sort -n > /tmp/list .arsipA
$ borg list /path/to/repo::archiveB --list-format="{mtime:%s}{TAB}{size}{TAB}{path}{LF}" |sort -n > /tmp/list .arsipB
$ diff -y /tmp/list.archiveA /tmp/list.archiveB
1422781200 0 . 1422781200 0 .
1422781200 0 kode 1422781200 0 kode
1422781200 0 kode/proyek saya 1422781200 0 kode/proyek saya
1422781200 1416192 kode/proyek saya/file.ext | 1454664653 1416192 kode/proyek saya/file.ext
...

BOR DELETE

penggunaan: borg delete [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-tunggu N] [--show-rc] [--tidak ada file-cache] [--umask M]
[--JALAN jalur jarak jauh] [-p] [-s] [-c] [--hemat-spasi]
[TARGET]

Hapus repositori atau arsip yang ada

argumen posisi:
TARGET arsip atau repositori untuk dihapus

argumen opsional:
-h, --help tampilkan pesan bantuan ini dan keluar
--pekerjaan kritis pada level log KRITIS
--error bekerja pada level log ERROR
--warning bekerja pada level log PERINGATAN (default)
--info, -v, --verbose
bekerja pada INFO tingkat log
--debug bekerja pada tingkat log DEBUG
--lock-wait N menunggu kunci, tapi maks. N detik (default: 1).
--show-rc tampilkan/log kode pengembalian (rc)
--no-files-cache jangan memuat/memperbarui cache metadata file yang digunakan untuk
mendeteksi file yang tidak berubah
--umask M set umask ke M (lokal dan jarak jauh, default: 0077)
--remote-path PATH atur jalur jarak jauh ke executable (default: "borg")
-p, --progress tampilkan tampilan kemajuan saat menghapus satu arsip
-s, --stats mencetak statistik untuk arsip yang dihapus
-c, --cache-only hapus hanya cache lokal untuk repositori yang diberikan
--save-space bekerja lebih lambat, tetapi menggunakan lebih sedikit ruang

Deskripsi Produk
Perintah ini menghapus arsip dari repositori atau repositori lengkap. Disk
ruang direklamasi sebagaimana mestinya. Jika Anda menghapus repositori lengkap, cache lokal untuk
itu (jika ada) juga dihapus.

contoh
# hapus satu arsip cadangan:
$borg hapus /path/ke/repo::Senin

# hapus seluruh repositori dan cache lokal terkait:
$borg hapus /path/ke/repo
Anda meminta untuk sepenuhnya MENGHAPUS repositori *termasuk* semua arsip yang dikandungnya:
repo Sen, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
nama baru Sen, 2016-02-15 19:50:19
Ketik 'YA' jika Anda memahami ini dan ingin melanjutkan: YA

BOR MEMANGKAS

penggunaan: borg prune [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-tunggu N] [--show-rc] [--tidak ada file-cache] [--umask M]
[--JALAN jalur jarak jauh] [-n] [-s] [--daftar]
[--tetap-dalam DALAM] [-JAM SETIAP JAM] [-d SETIAP HARI] [-w MINGGUAN]
[-m BULANAN] [-y TAHUNAN] [-P PREFIX] [--hemat-spasi]
[GUDANG]

Pangkas arsip repositori sesuai dengan aturan yang ditentukan

argumen posisi:
REPOSITORY repositori untuk dipangkas

argumen opsional:
-h, --help tampilkan pesan bantuan ini dan keluar
--pekerjaan kritis pada level log KRITIS
--error bekerja pada level log ERROR
--warning bekerja pada level log PERINGATAN (default)
--info, -v, --verbose
bekerja pada INFO tingkat log
--debug bekerja pada tingkat log DEBUG
--lock-wait N menunggu kunci, tapi maks. N detik (default: 1).
--show-rc tampilkan/log kode pengembalian (rc)
--no-files-cache jangan memuat/memperbarui cache metadata file yang digunakan untuk
mendeteksi file yang tidak berubah
--umask M set umask ke M (lokal dan jarak jauh, default: 0077)
--remote-path PATH atur jalur jarak jauh ke executable (default: "borg")
-n, --dry-run jangan ubah repositori
-s, --stats mencetak statistik untuk arsip yang dihapus
--list keluaran daftar arsip verbose yang disimpan/dipangkas
--keep-within WITHIN simpan semua arsip dalam interval waktu ini
-JAM SETIAP JAM, --tetap-setiap jam SETIAP JAM
jumlah arsip per jam yang harus disimpan
-d SETIAP HARI, --keep-harian SETIAP HARI
jumlah arsip harian yang harus disimpan
-w MINGGUAN, --keep-mingguan MINGGUAN
jumlah arsip mingguan yang harus disimpan
-m BULANAN, --keep-bulanan BULANAN
jumlah arsip bulanan yang harus disimpan
-y TAHUNAN, --terus-tahunan TAHUNAN
jumlah arsip tahunan yang harus disimpan
-P PREFIX, --awalan PREFIX
hanya pertimbangkan nama arsip yang dimulai dengan awalan ini
--save-space bekerja lebih lambat, tetapi menggunakan lebih sedikit ruang

Deskripsi Produk
Perintah prune memangkas repositori dengan menghapus arsip yang tidak cocok dengan salah satu dari
opsi retensi yang ditentukan. Perintah ini biasanya digunakan oleh skrip pencadangan otomatis
ingin menyimpan sejumlah cadangan bersejarah.

Sebagai contoh, "-d 7" berarti menyimpan cadangan terbaru setiap hari, hingga 7 terbaru
hari dengan cadangan (hari tanpa cadangan tidak dihitung). Aturan diterapkan dari setiap jam
hingga tahunan, dan cadangan yang dipilih oleh aturan sebelumnya tidak dihitung untuk cadangan nanti
aturan. Waktu setiap pencadangan selesai digunakan untuk tujuan pemangkasan. Tanggal dan waktu
ditafsirkan dalam zona waktu lokal, dan berminggu-minggu dari Senin hingga Minggu. Menentukan
jumlah arsip negatif yang harus disimpan berarti tidak ada batasan.

Opsi "--keep-in" mengambil argumen dalam bentuk " ", di mana char adalah "H",
"d", "w", "m", "y". Misalnya, "--keep-within 2d" berarti menyimpan semua arsip yang
dibuat dalam 48 jam terakhir. "1m" dianggap berarti "31d". Arsip disimpan dengan
opsi ini tidak dihitung terhadap total yang ditentukan oleh opsi lain.

Jika awalan diatur dengan -P, maka hanya arsip yang dimulai dengan awalan yang dipertimbangkan
untuk dihapus dan hanya arsip tersebut yang dihitung terhadap total yang ditentukan oleh aturan.
Jika tidak, semua arsip dalam repositori adalah kandidat untuk dihapus!

contoh
Hati-hati, pangkas adalah perintah yang berpotensi berbahaya, itu akan menghapus arsip cadangan.

Default dari prune adalah untuk diterapkan pada semua arsip in itu gudang kecuali Anda membatasinya
operasi ke subset arsip menggunakan --awalan. Ketika menggunakan --awalan, hati-hati
pilih awalan yang baik - misalnya jangan gunakan awalan "foo" jika Anda juga tidak ingin mencocokkan
"foobar".

Sangat disarankan untuk selalu berlari memangkas --lari-kering ... pertama jadi Anda akan melihat apa itu
akan melakukannya tanpa itu benar-benar melakukan apa-apa.

# Simpan 7 arsip akhir hari dan 4 arsip akhir minggu tambahan.
# Lakukan lari kering tanpa benar-benar menghapus apa pun.
$ borg prune --dry-run --keep-daily=7 --keep-weekly=4 /path/ke/repo

# Sama seperti di atas tetapi hanya berlaku untuk nama arsip yang dimulai dengan "foo":
$ borg prune --keep-daily=7 --keep-weekly=4 --prefix=foo /path/ke/repo

# Simpan 7 akhir hari, 4 arsip akhir minggu tambahan,
# dan arsip akhir bulan untuk setiap bulan:
$ borg prune --keep-daily=7 --keep-weekly=4 --keep-monthly=-1 /jalur/ke/repo

# Simpan semua cadangan dalam 10 hari terakhir, 4 arsip akhir minggu tambahan,
# dan arsip akhir bulan untuk setiap bulan:
$ borg prune --keep-within=10d --keep-weekly=4 --keep-monthly=-1 /path/to/repo

BOR INFO

penggunaan: borg info [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-tunggu N] [--show-rc] [--tidak ada file-cache] [--umask M]
[--JALAN jalur jarak jauh]
Arsip

Tampilkan detail arsip seperti ruang disk yang digunakan

argumen posisi:
Arsip arsip untuk menampilkan informasi tentang

argumen opsional:
-h, --help tampilkan pesan bantuan ini dan keluar
--pekerjaan kritis pada level log KRITIS
--error bekerja pada level log ERROR
--warning bekerja pada level log PERINGATAN (default)
--info, -v, --verbose
bekerja pada INFO tingkat log
--debug bekerja pada tingkat log DEBUG
--lock-wait N menunggu kunci, tapi maks. N detik (default: 1).
--show-rc tampilkan/log kode pengembalian (rc)
--no-files-cache jangan memuat/memperbarui cache metadata file yang digunakan untuk
mendeteksi file yang tidak berubah
--umask M set umask ke M (lokal dan jarak jauh, default: 0077)
--remote-path PATH atur jalur jarak jauh ke executable (default: "borg")

Deskripsi Produk
Perintah ini menampilkan beberapa informasi rinci tentang arsip yang ditentukan.

contoh
$ borg info /path/ke/repo::root-2016-02-15
Nama: root-2016-02-15
Fingerprint: 57c827621f21b000a8d363c1e163cc55983822b3afff3a96df595077a660be50
Nama host: namahostsaya
Nama pengguna: root
Waktu (mulai): Sen, 2016-02-15 19:36:29
Waktu (akhir): Sen, 2016-02-15 19:39:26
Baris perintah: /usr/local/bin/borg create -v --list -C zlib,6 /path/to/repo::root-2016-02-15 / --one-file-system
Jumlah file: 38100

Ukuran asli Ukuran terkompresi Ukuran duplikat
Arsip ini: 1.33 GB 613.25 MB 571.64 MB
Semua arsip: 1.63 GB 853.66 MB 584.12 MB

Potongan unik Total potongan
Indeks potongan: 36858 48844

BOR MOUNT

penggunaan: borg mount [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-tunggu N] [--show-rc] [--tidak ada file-cache] [--umask M]
[--JALAN jalur jarak jauh] [-f] [-o OPSI]
TITIK GUNUNG REPOSITORY_OR_ARCHIVE

Pasang arsip atau seluruh repositori sebagai sistem file FUSE

argumen posisi:
REPOSITORY_OR_ARCHIVE
repositori/arsip untuk dipasang
MOUNTPOINT tempat memasang sistem file

argumen opsional:
-h, --help tampilkan pesan bantuan ini dan keluar
--pekerjaan kritis pada level log KRITIS
--error bekerja pada level log ERROR
--warning bekerja pada level log PERINGATAN (default)
--info, -v, --verbose
bekerja pada INFO tingkat log
--debug bekerja pada tingkat log DEBUG
--lock-wait N menunggu kunci, tapi maks. N detik (default: 1).
--show-rc tampilkan/log kode pengembalian (rc)
--no-files-cache jangan memuat/memperbarui cache metadata file yang digunakan untuk
mendeteksi file yang tidak berubah
--umask M set umask ke M (lokal dan jarak jauh, default: 0077)
--remote-path PATH atur jalur jarak jauh ke executable (default: "borg")
-f, --foreground tetap di latar depan, jangan melakukan daemonize
-o OPSI Opsi pemasangan ekstra

Deskripsi Produk
Perintah ini memasang arsip sebagai sistem file FUSE. Ini bisa berguna untuk menjelajah dan
mengarsipkan atau memulihkan file individual. Kecuali jika --latar depan opsi diberikan perintah
akan berjalan di latar belakang hingga sistem file dilepas.

contoh
$ borg mount /path/ke/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

BOR GANTI-PASSPHRASE

penggunaan: borg change-passphrase [-h] [--critical] [--error] [--warning] [--info]
[--debug] [--lock-tunggu N] [--show-rc]
[--no-file-cache] [--umask M]
[--JALAN jalur jarak jauh]
[GUDANG]

Ubah frasa sandi file kunci repositori

argumen posisi:
GUDANG

argumen opsional:
-h, --help tampilkan pesan bantuan ini dan keluar
--pekerjaan kritis pada level log KRITIS
--error bekerja pada level log ERROR
--warning bekerja pada level log PERINGATAN (default)
--info, -v, --verbose
bekerja pada INFO tingkat log
--debug bekerja pada tingkat log DEBUG
--lock-wait N menunggu kunci, tapi maks. N detik (default: 1).
--show-rc tampilkan/log kode pengembalian (rc)
--no-files-cache jangan memuat/memperbarui cache metadata file yang digunakan untuk
mendeteksi file yang tidak berubah
--umask M set umask ke M (lokal dan jarak jauh, default: 0077)
--remote-path PATH atur jalur jarak jauh ke executable (default: "borg")

Deskripsi Produk
File kunci yang digunakan untuk enkripsi repositori secara opsional dilindungi frasa sandi. Ini
perintah dapat digunakan untuk mengubah frasa sandi ini.

contoh
# Buat repositori yang dilindungi file utama
$borg init --encryption=keyfile -v /path/to/repo
Inisialisasi repositori di "/path/to/repo"
Masukkan frasa sandi baru:
Masukkan lagi frasa sandi yang sama:
Ingat kata sandi Anda. Data Anda tidak akan dapat diakses tanpanya.
Masukkan "/root/.config/borg/keys/mnt_backup" yang telah dibuat.
Simpan kunci ini dengan aman. Data Anda tidak akan dapat diakses tanpanya.
Menyinkronkan tembolok potongan...
Arsip: 0, w/ cache Idx: 0, w/ Idx usang: 0, tanpa cache Idx: 0.
Done.

# Ubah frasa sandi file kunci
$ borg ubah-frasa sandi -v /path/ke/repo
Masukkan frasa sandi untuk kunci /root/.config/borg/keys/mnt_backup:
Masukkan frasa sandi baru:
Masukkan lagi frasa sandi yang sama:
Ingat kata sandi Anda. Data Anda tidak akan dapat diakses tanpanya.
Kunci diperbarui

BOR MENYAJIKAN

penggunaan: borg serve [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-tunggu N] [--show-rc] [--tidak ada file-cache] [--umask M]
[--JALAN jalur jarak jauh] [--JALAN batas-ke-jalur]

Mulai dalam mode server. Perintah ini biasanya tidak digunakan secara manual.

argumen opsional:
-h, --help tampilkan pesan bantuan ini dan keluar
--pekerjaan kritis pada level log KRITIS
--error bekerja pada level log ERROR
--warning bekerja pada level log PERINGATAN (default)
--info, -v, --verbose
bekerja pada INFO tingkat log
--debug bekerja pada tingkat log DEBUG
--lock-wait N menunggu kunci, tapi maks. N detik (default: 1).
--show-rc tampilkan/log kode pengembalian (rc)
--no-files-cache jangan memuat/memperbarui cache metadata file yang digunakan untuk
mendeteksi file yang tidak berubah
--umask M set umask ke M (lokal dan jarak jauh, default: 0077)
--remote-path PATH atur jalur jarak jauh ke executable (default: "borg")
--batas-ke-jalur PATH
batasi akses repositori ke PATH

Deskripsi Produk
Perintah ini memulai proses server repositori. Perintah ini biasanya tidak digunakan
secara manual

contoh
borg serve memiliki dukungan khusus untuk perintah paksa ssh (lihat otorisasi_keys contoh
di bawah): ini akan mendeteksi bahwa Anda menggunakan perintah yang dipaksakan dan mengekstrak nilai dari
--batasan-ke-jalur pilihan). Kemudian akan mengurai perintah asli yang berasal dari
klien, pastikan itu juga borg melayani dan menegakkan pembatasan jalur seperti yang diberikan oleh
perintah yang dipaksakan. Dengan begitu, opsi lain yang diberikan oleh klien (seperti --info or --umask)
dipertahankan (dan tidak diperbaiki oleh perintah paksa).

# Izinkan keypair SSH untuk hanya menjalankan borg, dan hanya memiliki akses ke /path/to/repo.
# Gunakan opsi kunci untuk menonaktifkan fungsionalitas SSH yang tidak dibutuhkan dan berpotensi berbahaya.
# Ini akan membantu mengamankan sistem pencadangan jarak jauh otomatis.
$ kucing ~/.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[...]

BOR UPGRADE

penggunaan: borg upgrade [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-tunggu N] [--show-rc] [--tidak ada file-cache] [--umask M]
[--JALAN jalur jarak jauh] [-p] [-n] [-i]
[GUDANG]

tingkatkan repositori dari versi sebelumnya

argumen posisi:
Jalur REPOSITORY ke repositori yang akan ditingkatkan

argumen opsional:
-h, --help tampilkan pesan bantuan ini dan keluar
--pekerjaan kritis pada level log KRITIS
--error bekerja pada level log ERROR
--warning bekerja pada level log PERINGATAN (default)
--info, -v, --verbose
bekerja pada INFO tingkat log
--debug bekerja pada tingkat log DEBUG
--lock-wait N menunggu kunci, tapi maks. N detik (default: 1).
--show-rc tampilkan/log kode pengembalian (rc)
--no-files-cache jangan memuat/memperbarui cache metadata file yang digunakan untuk
mendeteksi file yang tidak berubah
--umask M set umask ke M (lokal dan jarak jauh, default: 0077)
--remote-path PATH atur jalur jarak jauh ke executable (default: "borg")
-p, --progress tampilkan tampilan progres saat memutakhirkan repositori
-n, --dry-run jangan ubah repositori
-i, --inplace rewrite repositori di tempat, tanpa kemungkinan untuk pergi
kembali ke versi repositori yang lebih lama.

Deskripsi Produk
Tingkatkan repositori Borg yang ada. Ini saat ini mendukung konversi Loteng
repositori ke Borg dan juga membantu mengonversi Borg 0.xx ke 1.0.

Saat ini, hanya repositori LOKAL yang dapat ditingkatkan (edisi #465).

Ini akan mengubah string ajaib di segmen repositori agar sesuai dengan sihir Borg yang baru
string. File kunci ditemukan di $ATTIC_KEYS_DIR atau ~/.loteng/kunci/ juga akan dikonversi
dan disalin ke $BORG_KEYS_DIR atau ~/.config/borg/keys.

File cache dikonversi, dari $ATTIC_CACHE_DIR atau ~/.cache/loteng ke $BORG_CACHE_DIR
or ~/.cache/borg, tetapi tata letak cache antara Borg dan Attic berubah, jadi itu mungkin
pencadangan pertama setelah konversi membutuhkan waktu lebih lama dari yang diharapkan karena sinkronisasi ulang cache.

Peningkatan harus dapat dilanjutkan jika terganggu, meskipun itu akan tetap berulang
segmen. Jika Anda ingin memulai dari awal, gunakan borg hapus melalui repositori yang disalin ke
pastikan file cache juga dihapus:
borg hapus borg

Kecuali kalau --di tempat ditentukan, proses peningkatan pertama membuat salinan cadangan dari
repositori, di REPOSITORY.upgrade-DATETIME, menggunakan hardlink. Ini membutuhkan waktu lebih lama daripada di
tempat peningkatan, tetapi jauh lebih aman dan memberikan informasi kemajuan (sebagai lawan dari cp -Al).
Setelah Anda puas dengan konversi, Anda dapat dengan aman menghancurkan salinan cadangan.

PERINGATAN: Menjalankan pemutakhiran di tempat akan membuat salinan saat ini tidak dapat digunakan dengan yang lebih lama
versi, tanpa cara untuk kembali ke versi sebelumnya. Ini dapat MERUSAK PERMANEN ANDA
GUDANG! Loteng TIDAK BISA MEMBACA BORG REPOSITORIES, karena string ajaib telah berubah. Anda
telah diperingatkan.

contoh
# Tingkatkan repositori borg ke versi terbaru.
$borg upgrade -v /path/ke/repo
membuat salinan hardlink di /path/to/repo.upgrade-2016-02-15-20:51:55
membuka repositori loteng dengan borg dan mengonversi
tidak ada file kunci yang ditemukan untuk repositori
mengonversi indeks repo /path/ke/repo/index.0
mengubah 1 segmen...
mengubah borg 0.xx ke arus borg
tidak ada file kunci yang ditemukan untuk repositori

LAIN-LAIN MEMBANTU

borg membantu pola
Pola pengecualian mendukung empat gaya terpisah, fnmatch, shell, ekspresi reguler, dan
awalan jalur. Jika diikuti oleh titik dua (':') dua karakter pertama dari suatu pola digunakan
sebagai pemilih gaya. Pemilihan gaya eksplisit diperlukan ketika gaya non-default adalah
diinginkan atau ketika pola yang diinginkan dimulai dengan dua karakter alfanumerik diikuti oleh a
titik dua (yaitu aa:sesuatu/*).

pertandingan, pemilih dari:
Pola-pola ini menggunakan varian sintaks pola shell, dengan '*' cocok dengan sejumlah
karakter, '?' mencocokkan karakter tunggal apa pun, '[...]' cocok dengan karakter tunggal apa pun
ditentukan, termasuk rentang, dan '[!...]' cocok dengan karakter apa pun yang tidak ditentukan. Untuk
tujuan pola ini, pemisah jalur ('' untuk Windows dan '/' di sistem lain)
tidak diperlakukan secara khusus. Bungkus meta-karakter dalam tanda kurung untuk kecocokan literal (mis
[?] untuk mencocokkan karakter literal ?). Agar jalur cocok dengan pola, itu harus
benar-benar cocok dari awal hingga akhir, atau harus cocok dari awal hingga tepat sebelum jalur
pemisah. Kecuali untuk jalur root, jalur tidak akan pernah berakhir di pemisah jalur ketika
pencocokan dicoba. Jadi, jika pola tertentu berakhir di pemisah jalur, '*' adalah
ditambahkan sebelum pencocokan dicoba.

Pola gaya shell, pemilih NS:
Seperti pola fnmatch, ini mirip dengan pola shell. Perbedaannya adalah
pola mungkin termasuk ** / untuk mencocokkan nol atau lebih tingkat direktori, * untuk mencocokkan nol
atau lebih karakter arbitrer dengan pengecualian pemisah jalur apa pun.

Ekspresi reguler, pemilih kembali:
Ekspresi reguler yang mirip dengan yang ditemukan di Perl didukung. Tidak seperti pola cangkang
ekspresi reguler tidak diperlukan untuk mencocokkan jalur lengkap dan kecocokan substring apa pun
Cukup. Sangat disarankan untuk mengaitkan pola ke awal ('^'), ke
akhir ('$') atau keduanya. Pemisah jalur ('' untuk Windows dan '/' di sistem lain) di jalur
selalu dinormalisasi ke garis miring ('/') sebelum menerapkan pola. yang biasa
sintaks ekspresi dijelaskan dalam Ular sanca dokumentasi untuk itu re modul.

Jalur awalan, pemilih hal:
Gaya pola ini berguna untuk mencocokkan seluruh sub-direktori. Pola hal:/data/bar
korek api /data/bilah dan segala sesuatu di dalamnya.

Pengecualian dapat diteruskan melalui opsi baris perintah --mengecualikan. Ketika digunakan dari dalam
shell pola harus dikutip untuk melindunginya dari ekspansi.

Grafik --kecuali-dari opsi memungkinkan memuat pola pengecualian dari file teks dengan satu
pola per baris. Baris kosong atau dimulai dengan tanda angka ('#') setelah dihapus
spasi di kedua ujungnya diabaikan. Awalan pemilih gaya opsional juga didukung
untuk pola yang dimuat dari file. Karena jalur penghapusan spasi dengan spasi putih di
awal atau akhir hanya dapat dikecualikan menggunakan ekspresi reguler.

contoh:

# Kecualikan '/home/user/file.o' tetapi tidak '/home/user/file.odt': $ borg create -e '
*
.o' cadangan /

# Kecualikan '/home/user/junk' dan '/home/user/subdir/junk' tapi # tidak
'/home/user/importantjunk' atau '/etc/junk': $borg create -e '/rumah/
*
/sampah' cadangan /

# Kecualikan konten '/home/user/cache' tetapi bukan direktori itu sendiri: $ borg create
-e /home/user/cache/backup /

# File '/home/user/cache/important' adalah tidak dicadangkan: $ borg buat -e
/home/user/cache/backup //home/user/cache/important

# Isi direktori di '/ Home' tidak dicadangkan ketika nama mereka # berakhir di
'.tmp' $ borg create --exclude 're:^/rumah/[^/]+.tmp/' cadangan /

# Muat pengecualian dari file $ cat >exclude.txt < /rumah//sampah *. Tmp
fm:aa:sesuatu/ ulang:^/rumah/[^/].tmp/ sh:/rumah/
*
/.thumbnails EOF $ borg buat --exclude-fromexclude.txt backup /

DEBUG PERINTAH

Ada beberapa perintah lagi (semuanya dimulai dengan "debug-") yang semuanya tidak dimaksudkan untuk
normal menggunakan dan berpotensi sangat berbahaya jika digunakan secara tidak benar.

Mereka ada untuk meningkatkan kemampuan debugging tanpa akses sistem langsung, misalnya dalam kasus
Anda pernah mengalami beberapa kerusakan parah. Gunakan hanya jika Anda tahu apa yang Anda lakukan atau
jika pengembang Borg tepercaya memberi tahu Anda apa yang harus dilakukan.

TAMBAHAN CATATAN

Berikut adalah misc. catatan tentang topik yang mungkin tidak tercakup cukup detail dalam penggunaan
bagian.

Barang bendera
borg membuat -v --Daftar menampilkan daftar verbose dari semua file, direktori, dan file lainnya
item sistem yang dipertimbangkan (tidak peduli apakah mereka memiliki perubahan konten atau tidak). Untuk setiap
item, ini mengawali bendera satu huruf yang menunjukkan jenis dan/atau status item.

Jika Anda hanya tertarik pada subset dari output itu, Anda dapat memberikan mis --filter=AME dan
itu hanya akan menampilkan file biasa dengan status A, M atau E (lihat di bawah).

Karakter huruf besar mewakili status file biasa relatif terhadap "file"
cache (tidak relatif terhadap repo -- ini adalah masalah jika cache file tidak digunakan).
Metadata disimpan dalam kasus apa pun dan untuk 'A' dan 'M' juga potongan data baru disimpan. Untuk
'U' semua potongan data mengacu pada potongan yang sudah ada.

· 'A' = file biasa, ditambahkan (lihat juga a_status_oddity di FAQ)

· 'M' = file biasa, dimodifikasi

· 'U' = file biasa, tidak berubah

· 'E' = file biasa, terjadi kesalahan saat mengakses/membaca ini fillet

Karakter huruf kecil berarti jenis file selain file biasa, borg biasanya hanya
menyimpan metadata mereka:

· 'd' = direktori

· 'b' = memblokir perangkat

· 'c' = perangkat char

· 'h' = file biasa, hardlink (ke inode yang sudah terlihat)

· 's' = symlink

· 'f' = fifo

Bendera lain yang digunakan meliputi:

· 'i' = data cadangan dibaca dari input standar (stdin)

· '-' = lari kering, item tadi tidak mundur

· '?' = kode status hilang (jika Anda melihat ini, harap ajukan laporan bug!)

--chunker-params
Param chunker mempengaruhi bagaimana file input dipotong-potong (chunks) yang kemudian
dipertimbangkan untuk deduplikasi. Mereka juga memiliki dampak besar pada penggunaan sumber daya (RAM dan disk
ruang) karena jumlah sumber daya yang dibutuhkan (juga) ditentukan oleh jumlah total
potongan di repositori (lihat Indeks / Caches ingatan pemakaian untuk lebih jelasnya).

--chunker-params=10,23,16,4095 menghasilkan deduplikasi berbutir halus dan menciptakan besar
jumlah potongan dan dengan demikian menggunakan banyak sumber daya untuk mengelolanya. Ini bagus untuk
volume data yang relatif kecil dan jika mesin memiliki jumlah RAM dan disk kosong yang baik
ruang.

--chunker-params=19,23,21,4095 (default) menghasilkan deduplikasi berbutir kasar dan
menciptakan jumlah potongan yang jauh lebih kecil dan dengan demikian menggunakan lebih sedikit sumber daya. Ini bagus untuk
volume data yang relatif besar dan jika mesin memiliki jumlah RAM bebas yang relatif rendah dan
ruang disk.

Jika Anda sudah membuat beberapa arsip di repositori dan Anda kemudian mengubah params chunker,
ini tentu saja berdampak pada deduplikasi karena potongan akan dipotong secara berbeda.

Dalam kasus terburuk (semua file berukuran besar dan disentuh di antara cadangan), ini akan menyimpan
semua konten ke dalam repositori lagi.

Biasanya, itu tidak terlalu buruk:

· biasanya sebagian besar file tidak disentuh, jadi itu hanya akan menggunakan kembali potongan lama yang sudah ada
di repo

· file yang lebih kecil dari hasil chunksize minimum (baik lama dan baru) hanya dalam satu chunk
lagi pula, jadi potongan yang dihasilkan sama dan deduplikasi akan berlaku

Jika Anda mengganti param chunker untuk menghemat sumber daya untuk repo yang ada yang sudah memiliki beberapa
arsip cadangan, Anda akan melihat efek yang meningkat dari waktu ke waktu, ketika semakin banyak file
telah disentuh dan disimpan kembali menggunakan chunksize yang lebih besar dan semua referensi ke
potongan lama yang lebih kecil telah dihapus (dengan menghapus / memangkas arsip).

Jika Anda ingin melihat efek besar langsung pada penggunaan sumber daya, Anda sebaiknya memulai yang baru
repositori saat mengubah params chunker.

Untuk detail lebih lanjut, lihat chunker_details.

--baca-khusus
Pilihan --baca-khusus tidak dimaksudkan untuk level sistem file normal (penuh atau
sebagian-rekursif) backup. Anda hanya memberikan opsi ini jika Anda ingin melakukan sesuatu
... khusus -- dan jika Anda telah memilih sendiri beberapa file yang ingin Anda perlakukan seperti itu.

borg membuat --baca-khusus akan membuka semua file tanpa melakukan perlakuan khusus
sesuai dengan jenis file (satu-satunya pengecualian di sini adalah direktori: mereka akan direkursif
ke dalam). Bayangkan saja apa yang terjadi jika Anda melakukannya kucing nama file --- konten yang akan Anda lihat di sana
adalah apa yang akan dicadangkan borg untuk nama file itu.

Jadi, misalnya, symlink akan diikuti, konten perangkat blok akan dibaca, bernama pipa
/ Soket domain UNIX akan dibaca.

Anda harus berhati-hati dengan apa yang Anda berikan sebagai nama file saat menggunakan --baca-khusus, misalnya jika
Anda memberikan /dev/nol, pencadangan Anda tidak akan pernah berakhir.

Metadata file yang diberikan disimpan seperti yang akan disimpan tanpa --baca-khusus (mis
nama, ukurannya [mungkin 0], modenya, dll.) -- tetapi selain itu, juga isinya dibaca
dari itu akan disimpan untuk itu.

Memulihkan konten file tersebut saat ini hanya didukung satu per satu melalui --stdout
opsi (dan Anda harus mengarahkan stdout ke mana pun ia pergi, mungkin langsung ke
file perangkat pilihan Anda yang ada atau secara tidak langsung melalui dd).

Contoh
Bayangkan Anda telah membuat beberapa snapshot volume logis (LV) yang ingin Anda cadangkan.

CATATAN:
Untuk beberapa skenario, ini adalah metode yang baik untuk mendapatkan konsistensi "seperti crash" (saya menyebutnya
seperti crash karena sama seperti yang akan Anda dapatkan jika Anda menekan tombol reset atau
mesin Anda akan tiba-tiba dan benar-benar crash). Ini lebih baik daripada tidak ada konsistensi
sama sekali dan metode yang baik untuk beberapa kasus penggunaan, tetapi kemungkinan tidak cukup baik jika Anda memiliki
database berjalan.

Kemudian Anda membuat arsip cadangan dari semua snapshot ini. Proses pencadangan akan melihat
keadaan "beku" dari volume logis, sedangkan proses bekerja di volume asli
terus mengubah data yang tersimpan di sana.

Anda juga menambahkan output dari tampilkan DVD ke cadangan Anda, sehingga Anda dapat melihat ukuran LV untuk berjaga-jaga
Anda perlu membuat ulang dan memulihkannya.

Setelah pencadangan selesai, Anda menghapus snapshot lagi.

$ # buat snapshot di sini
$ lvdisplay > lvdisplay.txt
$ borg buat --read-special /path/to/repo::arch lvdisplay.txt /dev/vg0/*-snapshot
$# hapus foto di sini

Sekarang, mari kita lihat cara memulihkan beberapa LV dari cadangan semacam itu.

$ borg ekstrak /path/to/repo::arch lvdisplay.txt
$ # buat LV kosong dengan ukuran yang benar di sini (lihat lvdisplay.txt).
$ # kami berasumsi bahwa Anda membuat root kosong dan LV rumah dan menimpanya sekarang:
$ borg ekstrak --stdout /path/to/repo::arch dev/vg0/root-snapshot > /dev/vg0/root
$ borg ekstrak --stdout /path/to/repo::arch dev/vg0/home-snapshot > /dev/vg0/home

Tambahkan saja mode
Repositori dapat dibuat "hanya-tambahkan", yang berarti bahwa Borg tidak akan pernah menimpa atau
menghapus data yang dikomit. Ini berguna untuk skenario di mana beberapa mesin mencadangkan ke a
server cadangan pusat menggunakan borg melayani, karena mesin yang diretas tidak dapat menghapus cadangan
secara permanen.

Untuk mengaktifkan mode append-only, edit repositori config file dan tambahkan baris tambahkan_hanya=1
ke [gudang] bagian (atau edit baris jika ada).

Dalam mode tambahkan-saja, Borg akan membuat log transaksi di transaksi berkas, dimana
setiap baris adalah transaksi dan stempel waktu UTC.

Contoh
Misalkan penyerang menghapus semua cadangan dari jarak jauh, tetapi repositori Anda hanya ada di append
mode. Log transaksi dalam situasi ini mungkin terlihat seperti ini:

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

Dari log keamanan Anda, Anda menyimpulkan penyerang memperoleh akses pada 15:54:00 dan semua
cadangan di mana dihapus atau diganti dengan cadangan yang disusupi. Dari log Anda tahu itu
transaksi 11 dan yang lebih baru dikompromikan. Perhatikan bahwa ID transaksi adalah nama dari
terakhir berkas dalam transaksi. Misalnya, transaksi 11 mencakup file 6 hingga 11.

Dalam serangan nyata, Anda mungkin ingin menjaga repositori yang dikompromikan tetap utuh untuk dianalisis
apa yang coba dicapai oleh penyerang. Ini juga merupakan ide bagus untuk membuat salinan ini untuk berjaga-jaga
ada yang tidak beres selama pemulihan. Karena pemulihan dilakukan dengan menghapus beberapa file, a
salinan tautan keras (cp -Al) Cukup.

Langkah pertama untuk mereset repositori ke transaksi 5, yang terakhir tanpa kompromi
transaksi, adalah untuk menghapus petunjuk.N dan indeks.N file dalam repositori (dua file ini
selalu habis). Dalam contoh ini N adalah 13.

Kemudian hapus atau pindahkan semua file segmen dari direktori segmen di data/ dimulai dengan
berkas 6:

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

Itu saja.

Kerugian
Karena data hanya ditambahkan, dan tidak ada yang dihapus, perintah seperti memangkas or hapus tidak akan gratis
ruang disk, mereka hanya menandai data yang dihapus dalam transaksi baru.

Perhatikan bahwa Anda dapat bolak-balik antara operasi normal dan operasi tambahan dengan mengedit
file konfigurasi, ini bukan "perjalanan satu arah".

Lebih lanjut pertimbangan
Mode tambahan saja tidak dihormati oleh alat selain Borg. rm masih bekerja pada
gudang. Pastikan bahwa mesin klien cadangan hanya dapat mengakses repositori melalui
borg melayani.

Pastikan bahwa tidak ada akses jarak jauh yang memungkinkan jika repositori untuk sementara disetel ke normal
mode untuk misalnya pemangkasan biasa.

Perlindungan lebih lanjut dapat diterapkan, tetapi berada di luar cakupan Borgs. Misalnya, file
snapshot atau pembungkus sistem borg melayani untuk mengatur izin khusus atau ACL pada data baru
file.

Gunakan borgbackup online menggunakan layanan onworks.net