borgbackup - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

borg - BorgBackup là một chương trình sao lưu loại bỏ trùng lặp với tính năng nén tùy chọn và
mã hóa xác thực.

Borg bao gồm một số lệnh. Mỗi lệnh chấp nhận một số đối số và
tùy chọn. Các phần sau sẽ mô tả chi tiết từng lệnh.

CÁC VẤN ĐỀ CHUNG

Kiểu of đăng nhập đầu ra
Cấp độ nhật ký của cấu hình ghi nhật ký bản cài đặt mặc định là CẢNH BÁO. Điều này là bởi vì
chúng tôi muốn Borg hầu như im lặng và chỉ đưa ra các cảnh báo, lỗi và thông báo quan trọng.

Các cấp độ nhật ký: GỢI Ý <THÔNG TIN <CẢNH BÁO <LỖI <CRITICAL

Sử dụng --gỡ lỗi để đặt cấp độ nhật ký GỠ LỖI - để gỡ lỗi, thông tin, cảnh báo, lỗi và mức độ nghiêm trọng
đầu ra.

Sử dụng --thông tin (Hoặc -v or --dài dòng) để đặt cấp độ nhật ký INFO - để nhận thông tin, cảnh báo, lỗi và
đầu ra mức quan trọng.

Sử dụng --cảnh báo (mặc định) để đặt mức nhật ký CẢNH BÁO - để nhận cảnh báo, lỗi và nghiêm trọng
mức sản lượng.

Sử dụng --lỗi để đặt mức nhật ký LỖI - để nhận lỗi và đầu ra ở mức quan trọng.

Sử dụng --phê bình để đặt mức nhật ký CRITICAL - để nhận đầu ra ở mức quan trọng.

Trong khi bạn có thể đặt misc. cấp độ nhật ký, đừng mong đợi rằng mọi lệnh sẽ cung cấp
xuất ở các cấp độ nhật ký khác nhau - đó chỉ là một khả năng.

Chú ý:
Các tùy chọn - tới hạn và - lỗi được cung cấp để hoàn thiện, việc sử dụng chúng không
được khuyến nghị vì bạn có thể bỏ lỡ thông tin quan trọng.

Chú ý:
Trong khi một số tùy chọn (như --thống kê or --danh sách) sẽ phát ra nhiều thông điệp hơn, bạn
phải sử dụng cấp độ nhật ký INFO (hoặc thấp hơn) để làm cho chúng hiển thị trong đầu ra nhật ký. Sử dụng -v hoặc một
cấu hình ghi nhật ký.

Trả hàng mã số
Borg có thể thoát với các mã trả lại sau (rc):

0 = thành công (đăng nhập là INFO)
1 = cảnh báo (hoạt động đạt kết thúc bình thường, nhưng có cảnh báo -
bạn nên kiểm tra nhật ký, ghi là CẢNH BÁO)
2 = lỗi (như lỗi nghiêm trọng, ngoại lệ cục bộ hoặc từ xa, hoạt động
không đạt đến kết thúc bình thường, được ghi là ERROR)
128 + N = bị giết bởi tín hiệu N (ví dụ: 137 == kill -9)

Nếu bạn sử dụng --show-rc, mã trả lại cũng được ghi ở mức được chỉ định là mã cuối cùng
nhập nhật ký.

Môi trường Biến
Borg sử dụng một số biến môi trường để tự động hóa:

Nói chung:

BORG_REPO
Khi được đặt, hãy sử dụng giá trị để cung cấp vị trí kho lưu trữ mặc định. Nếu một
lệnh cần một tham số lưu trữ, bạn có thể viết tắt là ::lưu trữ. Nếu một
lệnh cần một tham số kho lưu trữ, bạn có thể bỏ nó đi hoặc
viết tắt là ::, nếu một tham số vị trí là bắt buộc.

BORG_PASSPHRASE
Khi được đặt, hãy sử dụng giá trị để trả lời câu hỏi cụm mật khẩu cho
kho lưu trữ.

BORG_DISPLAY_PASSPHRASE
Khi được đặt, hãy sử dụng giá trị để trả lời "hiển thị cụm mật khẩu cho
xác minh "câu hỏi khi xác định một cụm mật khẩu mới cho mã hóa
kho lưu trữ.

BORG_LOGGING_CONF
Khi được đặt, hãy sử dụng tên tệp đã cho làm KHỞI ĐẦU-cấu hình ghi nhật ký kiểu.

BORG_RSH
Khi đặt, hãy sử dụng lệnh này thay vì ssh. Điều này có thể được sử dụng để chỉ định ssh
các tùy chọn, chẳng hạn như tệp nhận dạng tùy chỉnh ssh -i / path / to / private / key. Thấy người đàn ông
ssh cho các tùy chọn khác.

TMPDIR nơi các tệp tạm thời được lưu trữ (có thể cần nhiều dung lượng tạm thời để
một số hoạt động)

Một số tự động người trả lời (nếu bộ, họ tự động trả lời xác nhận câu hỏi):

BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK = không (Hoặc = vâng)
Đối với "Cảnh báo: Cố gắng truy cập vào một tài khoản chưa được mã hóa chưa biết trước đó
kho"

BORG_RELOCATED_REPO_ACCESS_IS_OK = không (Hoặc = vâng)
Đối với "Cảnh báo: Kho lưu trữ tại vị trí ... trước đây được đặt tại ..."

BORG_CHECK_I_KNOW_WHAT_I_AM_DOING = KHÔNG (Hoặc = CÓ)
Đối với "Cảnh báo: 'kiểm tra - sửa chữa' là một tính năng thử nghiệm có thể dẫn đến
trong trường hợp mất dữ liệu. "

BORG_DELETE_I_KNOW_WHAT_I_AM_DOING = KHÔNG (Hoặc = CÓ)
Đối với "Bạn đã yêu cầu XÓA hoàn toàn kho lưu trữ kể cả tất cả các
lưu trữ nó chứa: "

Lưu ý: các câu trả lời có phân biệt chữ hoa chữ thường. đặt một giá trị câu trả lời không hợp lệ có thể cung cấp
câu trả lời mặc định hoặc hỏi bạn một cách tương tác, tùy thuộc vào việc thử lại có
được phép (chúng theo mặc định được cho phép). Vì vậy, vui lòng kiểm tra các tập lệnh của bạn một cách tương tác
trước khi biến chúng thành một tập lệnh không tương tác.

Thư mục:

BORG_KEYS_DIR
Mặc định thành '~ / .config / borg / các phím'. Thư mục này chứa các khóa được mã hóa
kho lưu trữ.

BORG_CACHE_DIR
Mặc định thành '~ / .cache / borg'. Thư mục này chứa bộ nhớ cache cục bộ và
có thể cần nhiều dung lượng để xử lý các kho lưu trữ lớn).

Xây dựng:

BORG_OPENSSL_PREFIX
Thêm thư mục tệp tiêu đề OpenSSL đã cung cấp vào các vị trí mặc định
(thiết lập.py).

BORG_LZ4_PREFIX
Thêm thư mục tệp tiêu đề LZ4 đã cho vào các vị trí mặc định (setup.py).

Quý vị cần lưu ý:

· Hãy rất cẩn thận khi sử dụng những người nói "có", các cảnh báo kèm theo lời nhắc tồn tại cho /
bảo mật / an toàn dữ liệu của bạn

· Cũng rất cẩn thận khi đặt cụm mật khẩu của bạn vào một tập lệnh, hãy đảm bảo rằng nó có
quyền tệp thích hợp (ví dụ: chế độ 600, root: root).

Tài nguyên Sử dụng
Borg có thể sử dụng nhiều tài nguyên tùy thuộc vào kích thước của tập dữ liệu mà nó đang xử lý
với.

CPU: Nó sẽ không vượt quá 100% 1 lõi vì mã hiện là một luồng.
Đặc biệt là mức nén zlib và lzma cao hơn sử dụng lượng CPU đáng kể
các chu kỳ.

Bộ nhớ (R.A.M):
Chỉ mục khối và chỉ mục tệp được đọc vào bộ nhớ vì lý do hiệu suất.
Nén, đặc biệt. Nén lzma với mức cao có thể cần số lượng đáng kể
của bộ nhớ.

Thẻ Tạm thời các tập tin:
Việc đọc dữ liệu và siêu dữ liệu từ kho lưu trữ được gắn kết FUSE sẽ tiêu tốn khoảng
cùng một không gian với các phần không trùng lặp được sử dụng để đại diện cho chúng trong kho lưu trữ.

Bộ nhớ cache các tập tin:
Chứa chỉ mục khối và chỉ mục tệp (cộng với một bộ sưu tập nén của
chỉ mục chunk lưu trữ đơn).

Miếng, mảnh nhỏ mục lục:
Tỷ lệ thuận với số lượng các khối dữ liệu trong repo của bạn. Rất nhiều phần trong repo của bạn
ngụ ý một chỉ số khối lớn. Có thể điều chỉnh các thông số chunker (xem phần tạo
tùy chọn).

Các tập tin mục lục:
Tỷ lệ với số lượng tệp trong bản sao lưu cuối cùng của bạn. Có thể tắt (xem
tạo tùy chọn), nhưng bản sao lưu tiếp theo sẽ chậm hơn nhiều nếu bạn làm vậy.

Network:
Nếu kho lưu trữ của bạn ở xa, tất cả đều được loại bỏ trùng lặp (và được nén tùy chọn /
dữ liệu được mã hóa) tất nhiên phải đi qua kết nối (ssh: repo url). nếu bạn
sử dụng hệ thống tệp mạng được gắn kết cục bộ, ngoài ra một số hoạt động sao chép được sử dụng
để hỗ trợ giao dịch cũng đi qua kết nối. Nếu bạn sao lưu nhiều nguồn
đến một kho lưu trữ mục tiêu, lưu lượng bổ sung sẽ xảy ra để đồng bộ hóa lại bộ đệm.

Trong trường hợp bạn muốn biết thêm chi tiết, vui lòng đọc tài liệu nội bộ.

Các đơn vị
Để hiển thị số lượng, Borg chú ý đến việc tôn trọng các quy ước thông thường về tỷ lệ. Đĩa
kích thước được hiển thị trong số thập phân, sử dụng lũy ​​thừa của mười (vì vậy kB nghĩa là 1000 byte). Cho bộ nhớ
sử dụng, nhị phân tiền tố được sử dụng và được chỉ định bằng cách sử dụng IEC nhị phân tiền tố, Sử dụng
lũy thừa của hai (vì vậy KiB nghĩa là 1024 byte).

Ngày và Thời gian
Chúng tôi định dạng ngày và giờ tuân theo ISO-8601, đó là: YYYY-MM-DD và HH: MM: SS (24h
cái đồng hồ).

Để biết thêm thông tin về điều đó, hãy xem: https://xkcd.com/1179/

Trừ khi có ghi chú khác, chúng tôi hiển thị ngày và giờ địa phương. Trong nội bộ, chúng tôi lưu trữ và xử lý
ngày và giờ dưới dạng UTC.

TÍN DỤNG INIT

cách sử dụng: borg init [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-e {none, keyfile, repokey}]
[KHO]

Khởi tạo một kho lưu trữ trống

đối số vị trí:
Kho lưu trữ REPOSITORY để tạo

đối số tùy chọn:
-h, --help hiển thị thông báo trợ giúp này và thoát
- công việc tới hạn ở cấp độ nhật ký CRITICAL
- lỗi hoạt động trên cấp độ nhật ký LỖI
- cảnh báo công việc ở cấp độ nhật ký CẢNH BÁO (mặc định)
--thông tin, -v, --verbose
làm việc ở cấp độ nhật ký THÔNG TIN
- gỡ lỗi hoạt động trên cấp độ nhật ký GỠ LỖI
- khóa-đợi N đợi khóa, nhưng tối đa. N giây (mặc định: 1).
--show-rc hiển thị / ghi lại mã trả về (rc)
--no-files-cache không tải / cập nhật bộ đệm siêu dữ liệu tệp được sử dụng để
phát hiện các tệp không thay đổi
--umask M đặt umask thành M (cục bộ và từ xa, mặc định: 0077)
--remote-path PATH đặt đường dẫn từ xa thành có thể thực thi (mặc định: "borg")
-e {none, keyfile, repokey}, --encryption {none, keyfile, repokey}
chọn chế độ khóa mã hóa (mặc định: "repokey")

Mô tả
Lệnh này khởi tạo một kho lưu trữ trống. Kho lưu trữ là một thư mục hệ thống tệp
chứa dữ liệu bị trùng lặp từ không hoặc nhiều kho lưu trữ. Mã hóa có thể được kích hoạt tại
thời gian init kho lưu trữ.

Các ví dụ
# Kho lưu trữ cục bộ (mặc định là sử dụng mã hóa ở chế độ repokey)
$ borg init / path / to / repo

# Kho lưu trữ cục bộ (không mã hóa)
$ borg init --encryption = none / path / to / repo

# Kho lưu trữ từ xa (truy cập borg từ xa qua ssh)
$ borg init user @ hostname: backup

# Kho lưu trữ từ xa (lưu trữ chìa khóa nhà của bạn)
$ borg init --encryption = keyfile user @ hostname: backup

Lưu ý quan trọng về mã hóa:

Không nên tắt mã hóa. Mã hóa kho lưu trữ bảo vệ bạn, ví dụ:
chống lại trường hợp kẻ tấn công có quyền truy cập vào kho lưu trữ sao lưu của bạn.

Nhưng hãy cẩn thận với khóa / cụm mật khẩu:

Nếu bạn muốn bảo mật "chỉ bằng cụm mật khẩu", hãy sử dụng phản đối chế độ. Chìa khóa sẽ được lưu trữ
bên trong kho lưu trữ (trong tệp "cấu hình" của nó). Trong kịch bản tấn công đã đề cập ở trên,
kẻ tấn công sẽ có khóa (nhưng không có cụm mật khẩu).

Nếu bạn muốn bảo mật "cụm mật khẩu và có khóa", hãy sử dụng tài liệu quan trọng chế độ. Chìa khóa sẽ
được lưu trữ trong thư mục chính của bạn (trong .config / borg / các phím). Trong kịch bản tấn công,
kẻ tấn công vừa truy cập vào repo của bạn sẽ không có khóa (và cũng không
cụm mật khẩu).

Tạo một bản sao lưu của tệp khóa (tài liệu quan trọng chế độ) hoặc tệp cấu hình repo (phản đối chế độ) và
giữ nó ở một nơi an toàn, vì vậy bạn vẫn có chìa khóa trong trường hợp nó bị hỏng hoặc bị mất. Cũng
giữ cụm mật khẩu ở một nơi an toàn. Bản sao lưu được mã hóa bằng khóa đó sẽ không
tất nhiên là giúp bạn với điều đó.

Đảm bảo rằng bạn sử dụng một cụm mật khẩu tốt. Không quá ngắn, không quá đơn giản. Mã hóa thực /
khóa giải mã được mã hóa / khóa bằng cụm mật khẩu của bạn. Nếu kẻ tấn công lấy được của bạn
chìa khóa, anh ta không thể mở khóa và sử dụng nó nếu không biết cụm mật khẩu.

Hãy cẩn thận với các ký tự đặc biệt hoặc không phải ascii trong cụm mật khẩu của bạn:

· Borg xử lý cụm mật khẩu dưới dạng unicode (và mã hóa nó thành utf-8), vì vậy nó không có
vấn đề đối phó với ngay cả những nhân vật kỳ lạ nhất.

· NHƯNG: điều đó không nhất thiết phải áp dụng cho hệ điều hành / máy ảo / cấu hình bàn phím của bạn.

Vì vậy, tốt hơn hãy sử dụng cụm mật khẩu dài được tạo từ các ký tự ascii đơn giản hơn là cụm từ bao gồm
nội dung không phải ascii hoặc các ký tự khó / không thể nhập trên bàn phím khác
bố trí.

Bạn có thể thay đổi cụm mật khẩu của mình cho các kho hiện có bất kỳ lúc nào, điều này sẽ không ảnh hưởng đến
khóa mã hóa / giải mã hoặc các bí mật khác.

TÍN DỤNG TẠO NÊN

cách sử dụng: borg create [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--đường dẫn từ xa PATH] [-s] [-p] [--list]
[- TÌNH TRẠNG BỘ lọc] [-e PATTERN]
[--loại trừ khỏi EXCLUDEFILE] [--exclude-caches]
[--loại trừ-nếu-TÊN TỆP hiện tại] [--keep-tag-files]
[-c GIÂY] [-x] [--numeric-owner]
[- dấu tối ưu yyyy-mm-ddThh: mm: ss]
[--chunker-params CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE]
[--bỏ qua-inode] [-C NÉN] [--đọc-đặc biệt] [-n]
SẮP XẾP [PATH ...]

Tạo kho lưu trữ mới

đối số vị trí:
ARCHIVE tên của kho lưu trữ để tạo (cũng phải là một
Tên thư mục)
Đường dẫn PATH để lưu trữ

đối số tùy chọn:
-h, --help hiển thị thông báo trợ giúp này và thoát
- công việc tới hạn ở cấp độ nhật ký CRITICAL
- lỗi hoạt động trên cấp độ nhật ký LỖI
- cảnh báo công việc ở cấp độ nhật ký CẢNH BÁO (mặc định)
--thông tin, -v, --verbose
làm việc ở cấp độ nhật ký THÔNG TIN
- gỡ lỗi hoạt động trên cấp độ nhật ký GỠ LỖI
- khóa-đợi N đợi khóa, nhưng tối đa. N giây (mặc định: 1).
--show-rc hiển thị / ghi lại mã trả về (rc)
--no-files-cache không tải / cập nhật bộ đệm siêu dữ liệu tệp được sử dụng để
phát hiện các tệp không thay đổi
--umask M đặt umask thành M (cục bộ và từ xa, mặc định: 0077)
--remote-path PATH đặt đường dẫn từ xa thành có thể thực thi (mặc định: "borg")
-s, --stats in thống kê cho kho lưu trữ đã tạo
-p, --progress hiển thị tiến trình trong khi tạo kho lưu trữ,
hiển thị các kích thước Gốc, Nén và Trùng lặp,
theo sau là Số lượng tệp được xem và đường dẫn
đang được xử lý, mặc định: Sai
--list đầu ra danh sách chi tiết của các mục (tệp, dirs, ...)
--filter STATUSCHARS chỉ hiển thị các mục có các ký tự trạng thái đã cho
-e MẪU, - trừ MẪU
loại trừ các đường dẫn phù hợp với PATTERN
- loại trừ khỏi EXCLUDEFILE
đọc các mẫu loại trừ khỏi EXCLUDEFILE, một mẫu trên mỗi dòng
--exclude-caches loại trừ các thư mục có chứa tệp CACHEDIR.TAG
(http://www.brynosaurus.com/cachedir/spec.html)
--loại trừ-nếu-hiện tại TÊN TẬP TIN
loại trừ các thư mục có chứa tệp được chỉ định
--keep-tag-files giữ các tệp thẻ của các bộ nhớ đệm / thư mục bị loại trừ
-c SECONDS, - khoảng cách điểm kiểm tra SECONDS
ghi điểm kiểm tra sau mỗi SECONDS giây (Mặc định: 300)
-x, --one-file-system
ở trong cùng một hệ thống tệp, không chéo các điểm gắn kết
--numeric-owner chỉ lưu trữ số nhận dạng nhóm và người dùng dạng số
--timestamp yyyy-mm-ddThh: mm: ss
chỉ định thủ công ngày / giờ tạo kho lưu trữ (UTC).
cách khác, cung cấp một tệp / thư mục tham chiếu.
--chunker-params CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE
chỉ định các tham số chunker. mặc định: 19,23,21,4095
--ignore-inode bỏ qua dữ liệu inode trong bộ đệm siêu dữ liệu tệp được sử dụng để
phát hiện các tệp không thay đổi.
-NÉN NÉN, - NÉN NÉN
chọn thuật toán nén (và cấp độ): không có == không
nén (mặc định), lz4 == lz4, zlib == zlib
(mức mặc định 6), zlib, 0 .. zlib, 9 == zlib (với
cấp 0..9), lzma == lzma (cấp 6 mặc định), lzma, 0..
lzma, 9 == lzma (với cấp 0..9).
- đọc-đặc biệt mở và đọc các tệp đặc biệt như thể chúng bình thường
các tập tin
-n, --dry-run không tạo kho lưu trữ sao lưu

Mô tả
Lệnh này tạo một kho lưu trữ sao lưu chứa tất cả các tệp được tìm thấy trong khi đệ quy
đi qua tất cả các con đường được chỉ định. Tệp lưu trữ sẽ hầu như không sử dụng dung lượng đĩa cho các tệp hoặc
các phần của tệp đã được lưu trữ trong các kho lưu trữ khác.

Để tăng tốc độ kéo các bản sao lưu qua sshfs và các hệ thống tệp mạng tương tự không
cung cấp thông tin inode chính xác để cờ --ignore-inode có thể được sử dụng. Điều này có khả năng
giảm độ tin cậy của việc phát hiện thay đổi, đồng thời tránh luôn đọc tất cả các tệp trên
các hệ thống tệp này.

Xem kết quả đầu ra của lệnh "các mẫu trợ giúp borg" để được trợ giúp thêm về các mẫu loại trừ.

Các ví dụ
# Sao lưu ~ / Tài liệu vào kho lưu trữ có tên "tài liệu của tôi"
$ borg create / path / to / repo :: my-Documents ~ / Tài liệu

# giống nhau, nhưng liệt kê chi tiết tất cả các tệp khi chúng tôi xử lý chúng
$ borg create -v --list / path / to / repo :: my-Documents ~ / Tài liệu

# Sao lưu ~ / Tài liệu và ~ / src nhưng loại trừ các tệp pyc
$ borg create / path / to / repo :: my-files \
~ / Tài liệu \
~ / src \
--exclude '* .pyc'

# Sao lưu thư mục chính ngoại trừ hình thu nhỏ hình ảnh (tức là chỉ
# /nhà/* /. hình thu nhỏ bị loại trừ, không /nhà/* / * /. hình thu nhỏ)
$ borg create / path / to / repo :: my-files / Home \
--exclude 're: ^/nhà/[^ /] + / \. hình thu nhỏ / '

# Làm tương tự bằng cách sử dụng mẫu kiểu vỏ
$ borg create / path / to / repo :: my-files / Home \
--exclude 'sh:/nhà/* /. hình thu nhỏ '

# Sao lưu hệ thống tệp gốc vào một kho lưu trữ có tên "root-YYYY-MM-DD"
# sử dụng nén zlib (tốt, nhưng chậm) - mặc định là không nén
$ borg create -C zlib, 6 / path / to / repo :: root- {now:% Y-% m-% d} / --one-file-system

# Thực hiện một nỗ lực lớn trong việc khử trùng lặp chi tiết nhỏ (quản lý phân đoạn lớn
# overhead, cần nhiều RAM và dung lượng đĩa, hãy xem công thức trong phần bên trong
# docs - các thông số tương tự như borg <1.0 hoặc attic):
$ borg create --chunker-params 10,23,16,4095 / path / to / repo :: small / smallstuff

# Sao lưu một thiết bị thô (không được hoạt động / đang sử dụng / được gắn vào thời điểm đó)
$ dd nếu = / dev / sdx bs = 10M | borg create / path / to / repo :: my-sdx -

# Không nén (mặc định)
$ borg create / path / to / repo :: Arch ~

# Siêu nhanh, nén thấp
$ borg create --compression lz4 / path / to / repo :: Arch ~

# Kém nhanh hơn, nén cao hơn (N = 0..9)
$ borg create --compression zlib, N / path / to / repo :: Arch ~

# Nén thậm chí chậm hơn, thậm chí cao hơn (N = 0..9)
$ borg create --compression lzma, N / path / to / repo :: Arch ~

# Định dạng các thẻ có sẵn cho tên kho lưu trữ:
# {bây giờ}, {utcnow}, {fqdn}, {tên máy chủ}, {người dùng}, {pid}
# thêm tên máy chủ lưu trữ ngắn, tên người dùng dự phòng và unixtime hiện tại (giây từ kỷ nguyên)
$ borg create / path / to / repo :: {hostname} - {user} - {now:% s} ~

TÍN DỤNG TRÍCH XUẤT

cách sử dụng: borg extract [-h] [- tới hạn] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--đường dẫn từ xa ĐƯỜNG] [--list] [-n] [-e MẪU]
[--loại trừ khỏi EXCLUDEFILE] [--numeric-owner]
[--strip-components SỐ] [--stdout] [--sparse]
SẮP XẾP [PATH [PATH ...]]

Trích xuất nội dung lưu trữ

đối số vị trí:
Lưu trữ ARCHIVE để giải nén
Các đường dẫn PATH để giải nén; các mẫu được hỗ trợ

đối số tùy chọn:
-h, --help hiển thị thông báo trợ giúp này và thoát
- công việc tới hạn ở cấp độ nhật ký CRITICAL
- lỗi hoạt động trên cấp độ nhật ký LỖI
- cảnh báo công việc ở cấp độ nhật ký CẢNH BÁO (mặc định)
--thông tin, -v, --verbose
làm việc ở cấp độ nhật ký THÔNG TIN
- gỡ lỗi hoạt động trên cấp độ nhật ký GỠ LỖI
- khóa-đợi N đợi khóa, nhưng tối đa. N giây (mặc định: 1).
--show-rc hiển thị / ghi lại mã trả về (rc)
--no-files-cache không tải / cập nhật bộ đệm siêu dữ liệu tệp được sử dụng để
phát hiện các tệp không thay đổi
--umask M đặt umask thành M (cục bộ và từ xa, mặc định: 0077)
--remote-path PATH đặt đường dẫn từ xa thành có thể thực thi (mặc định: "borg")
--list đầu ra danh sách chi tiết của các mục (tệp, dirs, ...)
-n, --dry-run không thực sự thay đổi bất kỳ tệp nào
-e MẪU, - trừ MẪU
loại trừ các đường dẫn phù hợp với PATTERN
- loại trừ khỏi EXCLUDEFILE
đọc các mẫu loại trừ khỏi EXCLUDEFILE, một mẫu trên mỗi dòng
--numeric-owner chỉ tuân theo định danh nhóm và người dùng số
--strip-components SỐ
Loại bỏ số lượng phần tử đường dẫn đầu được chỉ định.
Tên đường dẫn có ít phần tử hơn sẽ ở chế độ im lặng
bỏ qua.
--stdout ghi tất cả dữ liệu đã trích xuất vào stdout
--sparse tạo ra các lỗ trong tệp đầu ra thưa thớt từ hoàn toàn không
miếng, mảnh nhỏ

Mô tả
Lệnh này trích xuất nội dung của một kho lưu trữ. Theo mặc định, toàn bộ kho lưu trữ là
được trích xuất nhưng một tập hợp con các tệp và thư mục có thể được chọn bằng cách chuyển một danh sách PATH
như các đối số. Việc lựa chọn tệp có thể bị hạn chế hơn nữa bằng cách sử dụng --loại trừ tùy chọn.

Xem kết quả đầu ra của lệnh "các mẫu trợ giúp borg" để được trợ giúp thêm về các mẫu loại trừ.

Các ví dụ
# Giải nén toàn bộ kho lưu trữ
$ borg extract / path / to / repo :: my-files

# Giải nén toàn bộ tệp lưu trữ và danh sách trong khi xử lý
$ borg extract -v --list / path / to / repo :: my-files

# Giải nén thư mục "src"
$ borg extract / path / to / repo :: my-files home / USERNAME / src

# Giải nén thư mục "src" nhưng loại trừ các tệp đối tượng
$ borg extract / path / to / repo :: my-files home / USERNAME / src --exclude '* .o'

# Khôi phục thiết bị thô (không được hoạt động / đang sử dụng / được gắn vào thời điểm đó)
Giải nén $ borg --stdout / path / to / repo :: my-sdx | dd của = / dev / sdx bs = 10 triệu

Lưu ý: hiện tại, trích xuất luôn luôn viết trong các hiện hành đang làm việc thư mục ("."),
vì vậy hãy chắc chắn rằng bạn cd đến đúng nơi trước khi gọi borg trích xuất.

TÍN DỤNG KIỂM TRA

cách sử dụng: borg check [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--đường dẫn từ xa PATH] [--chỉ kho lưu trữ] [--chỉ lưu trữ]
[--repair] [--save-space] [--last N] [-P PREFIX]
[REPOSITORY_OR_ARCHIVE]

Kiểm tra tính nhất quán của kho lưu trữ

đối số vị trí:
REPOSITORY_OR_ARCHIVE
kho lưu trữ hoặc kho lưu trữ để kiểm tra tính nhất quán của

đối số tùy chọn:
-h, --help hiển thị thông báo trợ giúp này và thoát
- công việc tới hạn ở cấp độ nhật ký CRITICAL
- lỗi hoạt động trên cấp độ nhật ký LỖI
- cảnh báo công việc ở cấp độ nhật ký CẢNH BÁO (mặc định)
--thông tin, -v, --verbose
làm việc ở cấp độ nhật ký THÔNG TIN
- gỡ lỗi hoạt động trên cấp độ nhật ký GỠ LỖI
- khóa-đợi N đợi khóa, nhưng tối đa. N giây (mặc định: 1).
--show-rc hiển thị / ghi lại mã trả về (rc)
--no-files-cache không tải / cập nhật bộ đệm siêu dữ liệu tệp được sử dụng để
phát hiện các tệp không thay đổi
--umask M đặt umask thành M (cục bộ và từ xa, mặc định: 0077)
--remote-path PATH đặt đường dẫn từ xa thành có thể thực thi (mặc định: "borg")
- chỉ kho lưu trữ thực hiện kiểm tra kho lưu trữ
--archives-only thực hiện kiểm tra kho lưu trữ
- sửa chữa cố gắng sửa chữa bất kỳ mâu thuẫn nào được tìm thấy
- tiết kiệm không gian hoạt động chậm hơn, nhưng sử dụng ít dung lượng hơn
--last N chỉ kiểm tra N lưu trữ cuối cùng (Mặc định: tất cả)
-P PREFIX, - tiền tố PREFIX
chỉ xem xét các tên lưu trữ bắt đầu bằng tiền tố này

Mô tả
Lệnh kiểm tra xác minh tính nhất quán của một kho lưu trữ và các kho lưu trữ tương ứng.

Đầu tiên, các tệp dữ liệu kho lưu trữ cơ bản được kiểm tra:

· Đối với tất cả các phân đoạn, ma thuật phân đoạn (tiêu đề) được kiểm tra

· Đối với tất cả các đối tượng được lưu trữ trong các phân đoạn, tất cả siêu dữ liệu (ví dụ: crc và kích thước) và tất cả dữ liệu là
đọc. Dữ liệu đọc được kiểm tra theo kích thước và CRC. Thối bit và các loại ngẫu nhiên khác
thiệt hại có thể được phát hiện theo cách này.

· Nếu chúng tôi đang ở chế độ sửa chữa và lỗi toàn vẹn được phát hiện cho một phân đoạn, chúng tôi cố gắng
khôi phục càng nhiều đối tượng từ phân đoạn càng tốt.

· Trong chế độ sửa chữa, nó đảm bảo rằng chỉ mục nhất quán với dữ liệu được lưu trữ trong
phân đoạn.

· Nếu bạn sử dụng một máy chủ repo từ xa thông qua ssh :, việc kiểm tra repo được thực hiện trên máy chủ repo
mà không gây ra lưu lượng mạng đáng kể.

· Có thể bỏ qua việc kiểm tra kho lưu trữ bằng cách sử dụng tùy chọn --archives-only.

Thứ hai, tính nhất quán và tính đúng đắn của siêu dữ liệu lưu trữ được xác minh:

· Có bản kê khai repo không? Nếu không, nó sẽ được xây dựng lại từ các khối siêu dữ liệu lưu trữ (cái này
yêu cầu đọc và giải mã tất cả siêu dữ liệu và dữ liệu).

· Kiểm tra xem có tồn tại đoạn siêu dữ liệu lưu trữ hay không. nếu không, hãy xóa lưu trữ khỏi tệp kê khai.

· Đối với tất cả các tệp (mục) trong kho lưu trữ, đối với tất cả các phần được tham chiếu bởi các tệp này, hãy kiểm tra xem
hiện có (nếu không có và chúng tôi đang ở chế độ sửa chữa, hãy thay thế nó bằng một đoạn có cùng kích thước
số không). Điều này yêu cầu đọc siêu dữ liệu tệp và kho lưu trữ, nhưng không phải dữ liệu.

· Nếu chúng tôi đang ở chế độ sửa chữa và chúng tôi đã kiểm tra tất cả các kho lưu trữ: hãy xóa các phần mồ côi khỏi
repo.

· Nếu bạn sử dụng máy chủ repo từ xa thông qua ssh :, việc kiểm tra kho lưu trữ được thực hiện trên máy khách
máy (bởi vì nếu mã hóa được bật, việc kiểm tra sẽ yêu cầu giải mã và điều này
luôn được thực hiện ở phía máy khách, vì quyền truy cập khóa sẽ được yêu cầu).

· Việc kiểm tra kho lưu trữ có thể tốn thời gian, chúng có thể được bỏ qua bằng cách sử dụng
- tùy chọn chỉ dành cho kho lưu trữ.

TÍN DỤNG ĐỔI TÊN

cách sử dụng: borg đổi tên [-h] [- tới hạn] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--đường dẫn từ xa PATH]
LƯU TRỮ TÊN MỚI

Đổi tên một kho lưu trữ hiện có

đối số vị trí:
Lưu trữ ARCHIVE để đổi tên
NEWNAME tên lưu trữ mới để sử dụng

đối số tùy chọn:
-h, --help hiển thị thông báo trợ giúp này và thoát
- công việc tới hạn ở cấp độ nhật ký CRITICAL
- lỗi hoạt động trên cấp độ nhật ký LỖI
- cảnh báo công việc ở cấp độ nhật ký CẢNH BÁO (mặc định)
--thông tin, -v, --verbose
làm việc ở cấp độ nhật ký THÔNG TIN
- gỡ lỗi hoạt động trên cấp độ nhật ký GỠ LỖI
- khóa-đợi N đợi khóa, nhưng tối đa. N giây (mặc định: 1).
--show-rc hiển thị / ghi lại mã trả về (rc)
--no-files-cache không tải / cập nhật bộ đệm siêu dữ liệu tệp được sử dụng để
phát hiện các tệp không thay đổi
--umask M đặt umask thành M (cục bộ và từ xa, mặc định: 0077)
--remote-path PATH đặt đường dẫn từ xa thành có thể thực thi (mặc định: "borg")

Mô tả
Lệnh này đổi tên một kho lưu trữ trong kho lưu trữ.

Các ví dụ
$ borg create / path / to / repo :: archivename ~
$ borg list / path / to / repo
archivename Thứ Hai, 2016-02-15 19:50:19

$ borg rename / path / to / repo :: archivename newname
$ borg list / path / to / repo
newname Thứ Hai, 2016-02-15 19:50:19

TÍN DỤNG DANH SÁCH

cách sử dụng: borg list [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [--short] [--list-format LISTFORMAT]
[-P TIỀN TỆ]
[REPOSITORY_OR_ARCHIVE]

Liệt kê nội dung kho lưu trữ hoặc kho lưu trữ

đối số vị trí:
REPOSITORY_OR_ARCHIVE
kho lưu trữ / kho lưu trữ để liệt kê nội dung của

đối số tùy chọn:
-h, --help hiển thị thông báo trợ giúp này và thoát
- công việc tới hạn ở cấp độ nhật ký CRITICAL
- lỗi hoạt động trên cấp độ nhật ký LỖI
- cảnh báo công việc ở cấp độ nhật ký CẢNH BÁO (mặc định)
--thông tin, -v, --verbose
làm việc ở cấp độ nhật ký THÔNG TIN
- gỡ lỗi hoạt động trên cấp độ nhật ký GỠ LỖI
- khóa-đợi N đợi khóa, nhưng tối đa. N giây (mặc định: 1).
--show-rc hiển thị / ghi lại mã trả về (rc)
--no-files-cache không tải / cập nhật bộ đệm siêu dữ liệu tệp được sử dụng để
phát hiện các tệp không thay đổi
--umask M đặt umask thành M (cục bộ và từ xa, mặc định: 0077)
--remote-path PATH đặt đường dẫn từ xa thành có thể thực thi (mặc định: "borg")
--short chỉ in tên tệp / thư mục, không có gì khác
- định dạng danh sách LISTFORMAT
chỉ định định dạng cho danh sách tệp lưu trữ (mặc định:
"{mode} {user: 6} {group: 6} {size: 8d} {isomtime}
{path} {extra} {NEWLINE} ") Có" {formatkeys} "đặc biệt
liệt kê các khóa có sẵn
-P PREFIX, - tiền tố PREFIX
chỉ xem xét các tên lưu trữ bắt đầu bằng tiền tố này

Mô tả
Lệnh này liệt kê nội dung của một kho lưu trữ hoặc một kho lưu trữ.

Các ví dụ
$ borg list / path / to / repo
Thứ Hai, Thứ Hai, 2016-02-15 19:15:11
repo Thứ Hai, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
newname Thứ Hai, 2016-02-15 19:50:19
hữu ích. Cảm ơn !

$ borg list / path / to / repo :: root-2016-02-15
root root drwxr-xr-x 0 Thứ Hai, 2016-02-15 17:44:27.
drwxrwxr-x root root 0 Thứ Hai, 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 T2015, 03-27-20 24:26:XNUMX bin / bzcmp -> bzdiff
-rwxr-xr-x root root 2140 T2015, 03-27-20 24:22:XNUMX bin / bzdiff
hữu ích. Cảm ơn !

$ borg list / path / to / repo :: archiveA --list-format = "{mode} {user: 6} {group: 6} {size: 8d} {isomtime} {path} {extra} {NEWLINE}"
người dùng drwxrwxr-x người dùng 0 CN, 2015-02-01 11:00:00.
drwxrwxr-x user user 0 CN, 2015-02-01 11:00:00 mã
drwxrwxr-x user user 0 CN, 2015-02-01 11:00:00 mã / myproject
-rw-rw-r-- user user 1416192 Sun, 2015-02-01 11:00:00 code / myproject / file.ext
hữu ích. Cảm ơn !

# xem những gì được thay đổi giữa các tệp lưu trữ, dựa trên thời gian sửa đổi tệp, kích thước và đường dẫn tệp
$ 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 mã 1422781200 0 mã
1422781200 0 mã / myproject 1422781200 0 mã / myproject
1422781200 1416192 mã / myproject / file.ext | 1454664653 1416192 code / myproject / file.ext
hữu ích. Cảm ơn !

TÍN DỤNG DELETE

cách sử dụng: borg xóa [-h] [- tới hạn] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--đường dẫn từ xa PATH] [-p] [-s] [-c] [--save-space]
[MỤC TIÊU]

Xóa kho lưu trữ hoặc kho lưu trữ hiện có

đối số vị trí:
TARGET kho lưu trữ hoặc kho lưu trữ để xóa

đối số tùy chọn:
-h, --help hiển thị thông báo trợ giúp này và thoát
- công việc tới hạn ở cấp độ nhật ký CRITICAL
- lỗi hoạt động trên cấp độ nhật ký LỖI
- cảnh báo công việc ở cấp độ nhật ký CẢNH BÁO (mặc định)
--thông tin, -v, --verbose
làm việc ở cấp độ nhật ký THÔNG TIN
- gỡ lỗi hoạt động trên cấp độ nhật ký GỠ LỖI
- khóa-đợi N đợi khóa, nhưng tối đa. N giây (mặc định: 1).
--show-rc hiển thị / ghi lại mã trả về (rc)
--no-files-cache không tải / cập nhật bộ đệm siêu dữ liệu tệp được sử dụng để
phát hiện các tệp không thay đổi
--umask M đặt umask thành M (cục bộ và từ xa, mặc định: 0077)
--remote-path PATH đặt đường dẫn từ xa thành có thể thực thi (mặc định: "borg")
-p, --progress hiển thị tiến trình trong khi xóa một kho lưu trữ
-s, --stats in thống kê cho kho lưu trữ đã xóa
-c, --cache-only xóa chỉ bộ nhớ cache cục bộ cho kho lưu trữ nhất định
- tiết kiệm không gian hoạt động chậm hơn, nhưng sử dụng ít dung lượng hơn

Mô tả
Lệnh này xóa một kho lưu trữ khỏi kho lưu trữ hoặc kho lưu trữ hoàn chỉnh. Đĩa
không gian được thu hồi cho phù hợp. Nếu bạn xóa toàn bộ kho lưu trữ, bộ nhớ cache cục bộ cho
nó (nếu có) cũng bị xóa.

Các ví dụ
# xóa một kho lưu trữ sao lưu duy nhất:
$ borg delete / path / to / repo :: Monday

# xóa toàn bộ kho lưu trữ và bộ nhớ cache cục bộ có liên quan:
$ borg delete / path / to / repo
Bạn đã yêu cầu XÓA hoàn toàn kho lưu trữ * bao gồm * tất cả các kho lưu trữ mà nó chứa:
repo Thứ Hai, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
newname Thứ Hai, 2016-02-15 19:50:19
Nhập 'CÓ' nếu bạn hiểu điều này và muốn tiếp tục: CÓ

TÍN DỤNG MẬN

cách sử dụng: borg mận [-h] [- tới hạn] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--đường dẫn từ xa PATH] [-n] [-s] [--list]
[- lưu giữ trong VÒNG] [-H GIỜ] [-d HÀNG NGÀY] [-w TUẦN]
[-m HÀNG THÁNG] [-y HÀNG NĂM] [-P PREFIX] [--save-space]
[KHO]

Cắt tỉa kho lưu trữ theo quy tắc cụ thể

đối số vị trí:
Kho lưu trữ REPOSITORY để cắt tỉa

đối số tùy chọn:
-h, --help hiển thị thông báo trợ giúp này và thoát
- công việc tới hạn ở cấp độ nhật ký CRITICAL
- lỗi hoạt động trên cấp độ nhật ký LỖI
- cảnh báo công việc ở cấp độ nhật ký CẢNH BÁO (mặc định)
--thông tin, -v, --verbose
làm việc ở cấp độ nhật ký THÔNG TIN
- gỡ lỗi hoạt động trên cấp độ nhật ký GỠ LỖI
- khóa-đợi N đợi khóa, nhưng tối đa. N giây (mặc định: 1).
--show-rc hiển thị / ghi lại mã trả về (rc)
--no-files-cache không tải / cập nhật bộ đệm siêu dữ liệu tệp được sử dụng để
phát hiện các tệp không thay đổi
--umask M đặt umask thành M (cục bộ và từ xa, mặc định: 0077)
--remote-path PATH đặt đường dẫn từ xa thành có thể thực thi (mặc định: "borg")
-n, --dry-run không thay đổi kho lưu trữ
-s, --stats in thống kê cho kho lưu trữ đã xóa
--list đầu ra danh sách chi tiết các kho lưu trữ nó giữ / cắt tỉa
--keep-in TRONG VÒNG giữ tất cả các tài liệu lưu trữ trong khoảng thời gian này
-H HÀNG GIỜ, - làm việc hàng giờ HÀNG GIỜ
số lượng lưu trữ hàng giờ cần giữ
-d HÀNG NGÀY, - giữ hàng ngày HÀNG NGÀY
số lượng tài liệu lưu trữ hàng ngày cần giữ
-w TUẦN, - bảo trì hàng tuần HÀNG TUẦN
số lượng tài liệu lưu trữ hàng tuần cần giữ
-m HÀNG THÁNG, - thủ tục hàng tháng HÀNG THÁNG
số lượng tài liệu lưu trữ hàng tháng cần giữ
-y NĂM, - hàng năm HÀNG NĂM
số lượng tài liệu lưu trữ hàng năm cần lưu giữ
-P PREFIX, - tiền tố PREFIX
chỉ xem xét các tên lưu trữ bắt đầu bằng tiền tố này
- tiết kiệm không gian hoạt động chậm hơn, nhưng sử dụng ít dung lượng hơn

Mô tả
Lệnh mận sẽ cắt bớt một kho lưu trữ bằng cách xóa các kho lưu trữ không khớp với bất kỳ
các tùy chọn lưu giữ được chỉ định. Lệnh này thường được sử dụng bởi các tập lệnh sao lưu tự động
muốn giữ một số bản sao lưu lịch sử nhất định.

Ví dụ: "-d 7" có nghĩa là giữ bản sao lưu mới nhất vào mỗi ngày, lên đến 7 bản sao lưu gần đây nhất
số ngày có bản sao lưu (số ngày không có bản sao lưu không được tính). Các quy tắc được áp dụng từ hàng giờ
hàng năm và các bản sao lưu được chọn theo các quy tắc trước đó không được tính vào các bản sao lưu sau này
quy tắc. Thời gian mà mỗi bản sao lưu hoàn tất được sử dụng cho mục đích cắt tỉa. Ngày và giờ
được diễn giải theo múi giờ địa phương và các tuần diễn ra từ Thứ Hai đến Chủ Nhật. Chỉ định một
số âm của tài liệu lưu trữ để giữ có nghĩa là không có giới hạn.

Tùy chọn "--keep-inside" nhận một đối số của biểu mẫu " ", trong đó char là" H ",
"d", "w", "m", "y". Ví dụ: "--keep-within 2d" có nghĩa là giữ tất cả các bản lưu trữ
được tạo trong vòng 48 giờ qua. "1m" được hiểu là "31d". Các tài liệu lưu trữ được lưu giữ với
tùy chọn này không được tính vào tổng số được chỉ định bởi bất kỳ tùy chọn nào khác.

Nếu tiền tố được đặt bằng -P, thì chỉ những tệp lưu trữ bắt đầu bằng tiền tố đó mới được coi là
để xóa và chỉ những lưu trữ đó mới được tính vào tổng số được quy định bởi các quy tắc.
Nếu không thì, tất cả các tài liệu lưu trữ trong kho lưu trữ là ứng cử viên để xóa!

Các ví dụ
Hãy cẩn thận, tỉa là một lệnh tiềm ẩn nguy hiểm, nó sẽ xóa các kho lưu trữ sao lưu.

Mặc định của tỉa là áp dụng cho tất cả các tài liệu lưu trữ in các kho trừ khi bạn hạn chế nó
hoạt động đối với một tập hợp con của các kho lưu trữ bằng cách sử dụng --tiếp đầu ngữ. Khi đang sử dụng --tiếp đầu ngữ, hãy cẩn thận
chọn một tiền tố tốt - ví dụ: không sử dụng tiền tố "foo" nếu bạn không muốn khớp
"foobar".

Chúng tôi khuyên bạn nên luôn chạy mận khô - chạy thử hữu ích. Cảm ơn ! trước tiên bạn sẽ thấy nó là gì
sẽ làm mà không có nó thực sự làm bất cứ điều gì.

# Giữ 7 bản lưu trữ cuối ngày và 4 bản lưu trữ bổ sung vào cuối tuần.
# Chạy khô mà không thực sự xóa bất kỳ thứ gì.
$ borg snine --dry-run --keep-daily = 7 --keep-week = 4 / path / to / repo

# Tương tự như trên nhưng chỉ áp dụng cho các tên lưu trữ bắt đầu bằng "foo":
$ borg tỉa --keep-daily = 7 --keep-week = 4 --prefix = foo / path / to / repo

# Giữ 7 bản lưu trữ cuối ngày, 4 bản lưu trữ bổ sung vào cuối tuần,
# và một kho lưu trữ cuối tháng cho mỗi tháng:
$ borg snine --keep-daily = 7 --keep-week = 4 --keep-month = -1 / path / to / repo

# Giữ tất cả các bản sao lưu trong 10 ngày qua, 4 bản lưu trữ bổ sung vào cuối tuần,
# và một kho lưu trữ cuối tháng cho mỗi tháng:
$ borg snine --keep-within = 10ngày --keep-week = 4 --keep-month = -1 / path / to / repo

TÍN DỤNG Thông TIN

cách sử dụng: borg thông tin [-h] [- tới hạn] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--đường dẫn từ xa PATH]
KIẾN TRÚC

Hiển thị thông tin chi tiết về kho lưu trữ chẳng hạn như dung lượng ổ đĩa được sử dụng

đối số vị trí:
Lưu trữ ARCHIVE để hiển thị thông tin về

đối số tùy chọn:
-h, --help hiển thị thông báo trợ giúp này và thoát
- công việc tới hạn ở cấp độ nhật ký CRITICAL
- lỗi hoạt động trên cấp độ nhật ký LỖI
- cảnh báo công việc ở cấp độ nhật ký CẢNH BÁO (mặc định)
--thông tin, -v, --verbose
làm việc ở cấp độ nhật ký THÔNG TIN
- gỡ lỗi hoạt động trên cấp độ nhật ký GỠ LỖI
- khóa-đợi N đợi khóa, nhưng tối đa. N giây (mặc định: 1).
--show-rc hiển thị / ghi lại mã trả về (rc)
--no-files-cache không tải / cập nhật bộ đệm siêu dữ liệu tệp được sử dụng để
phát hiện các tệp không thay đổi
--umask M đặt umask thành M (cục bộ và từ xa, mặc định: 0077)
--remote-path PATH đặt đường dẫn từ xa thành có thể thực thi (mặc định: "borg")

Mô tả
Lệnh này hiển thị một số thông tin chi tiết về kho lưu trữ được chỉ định.

Các ví dụ
$ borg info / path / to / repo :: root-2016-02-15
Tên: root-2016-02-15
Fingerprint: 57c827621f21b000a8d363c1e163cc55983822b3afff3a96df595077a660be50
Tên máy chủ: myhostname
Tên đăng nhập: root
Thời gian (bắt đầu): Thứ Hai, ngày 2016 tháng 02 năm 15 19:36:29
Thời gian (kết thúc): Thứ Hai, 2016-02-15 19:39:26
Dòng lệnh: / usr / local / bin / borg create -v --list -C zlib, 6 / path / to / repo :: root-2016-02-15 / --one-file-system
Số lượng tệp: 38100

Kích thước ban đầu Kích thước nén Kích thước trùng lặp
Bản lưu trữ này: 1.33 GB 613.25 MB 571.64 MB
Tất cả lưu trữ: 1.63 GB 853.66 MB 584.12 MB

Khối độc đáo Tổng số khối
Chỉ số Chunk: 36858 48844

TÍN DỤNG Gắn kết

cách sử dụng: borg mount [-h] [- tới hạn] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--remote-path PATH] [-f] [-o TÙY CHỌN]
REPOSITORY_OR_ARCHIVE MOUNTPOINT

Gắn kết kho lưu trữ hoặc toàn bộ kho lưu trữ dưới dạng hệ thống tệp FUSE

đối số vị trí:
REPOSITORY_OR_ARCHIVE
kho lưu trữ / kho lưu trữ để gắn kết
MOUNTPOINT nơi để gắn kết hệ thống tập tin

đối số tùy chọn:
-h, --help hiển thị thông báo trợ giúp này và thoát
- công việc tới hạn ở cấp độ nhật ký CRITICAL
- lỗi hoạt động trên cấp độ nhật ký LỖI
- cảnh báo công việc ở cấp độ nhật ký CẢNH BÁO (mặc định)
--thông tin, -v, --verbose
làm việc ở cấp độ nhật ký THÔNG TIN
- gỡ lỗi hoạt động trên cấp độ nhật ký GỠ LỖI
- khóa-đợi N đợi khóa, nhưng tối đa. N giây (mặc định: 1).
--show-rc hiển thị / ghi lại mã trả về (rc)
--no-files-cache không tải / cập nhật bộ đệm siêu dữ liệu tệp được sử dụng để
phát hiện các tệp không thay đổi
--umask M đặt umask thành M (cục bộ và từ xa, mặc định: 0077)
--remote-path PATH đặt đường dẫn từ xa thành có thể thực thi (mặc định: "borg")
-f, - tiên cảnh ở lại tiền cảnh, đừng làm loạn
-o TÙY CHỌN Tùy chọn gắn kết bổ sung

Mô tả
Lệnh này gắn kết một kho lưu trữ dưới dạng một hệ thống tệp FUSE. Điều này có thể hữu ích cho việc duyệt một
lưu trữ hoặc khôi phục các tệp riêng lẻ. Trừ khi --vấn đề xung quanh tùy chọn được đưa ra lệnh
sẽ chạy ở chế độ nền cho đến khi hệ thống tệp có nhiều.

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

TÍN DỤNG THAY ĐỔI-PASSPHRASE

cách sử dụng: borg change-passphrase [-h] [--critical] [--error] [--warning] [--info]
[--debug] [--lock-đợi N] [--show-rc]
[--no-files-cache] [--umask M]
[--đường dẫn từ xa PATH]
[KHO]

Thay đổi cụm mật khẩu tệp khóa kho lưu trữ

đối số vị trí:
KHO

đối số tùy chọn:
-h, --help hiển thị thông báo trợ giúp này và thoát
- công việc tới hạn ở cấp độ nhật ký CRITICAL
- lỗi hoạt động trên cấp độ nhật ký LỖI
- cảnh báo công việc ở cấp độ nhật ký CẢNH BÁO (mặc định)
--thông tin, -v, --verbose
làm việc ở cấp độ nhật ký THÔNG TIN
- gỡ lỗi hoạt động trên cấp độ nhật ký GỠ LỖI
- khóa-đợi N đợi khóa, nhưng tối đa. N giây (mặc định: 1).
--show-rc hiển thị / ghi lại mã trả về (rc)
--no-files-cache không tải / cập nhật bộ đệm siêu dữ liệu tệp được sử dụng để
phát hiện các tệp không thay đổi
--umask M đặt umask thành M (cục bộ và từ xa, mặc định: 0077)
--remote-path PATH đặt đường dẫn từ xa thành có thể thực thi (mặc định: "borg")

Mô tả
Các tệp khóa được sử dụng để mã hóa kho lưu trữ được bảo vệ bằng cụm mật khẩu tùy chọn. Cái này
lệnh có thể được sử dụng để thay đổi cụm mật khẩu này.

Các ví dụ
# Tạo một kho lưu trữ bảo vệ tệp quan trọng
$ borg init --encryption = keyfile -v / path / to / repo
Khởi tạo kho lưu trữ tại "/ path / to / repo"
Nhập cụm mật khẩu mới:
Nhập lại cùng một cụm mật khẩu:
Ghi nhớ cụm mật khẩu của bạn. Dữ liệu của bạn sẽ không thể truy cập được nếu không có nó.
Đã tạo khóa "/root/.config/borg/keys/mnt_backup".
Giữ chìa khóa này an toàn. Dữ liệu của bạn sẽ không thể truy cập được nếu không có nó.
Đang đồng bộ hóa bộ nhớ cache các khối ...
Lưu trữ: 0, w / bộ nhớ cache Idx: 0, w / lỗi thời Idx: 0, w / o bộ nhớ cache Idx: 0.
Xong.

# Thay đổi cụm mật khẩu tệp chính
$ borg change-passphrase -v / path / to / repo
Nhập cụm mật khẩu cho khóa /root/.config/borg/keys/mnt_backup:
Nhập cụm mật khẩu mới:
Nhập lại cùng một cụm mật khẩu:
Ghi nhớ cụm mật khẩu của bạn. Dữ liệu của bạn sẽ không thể truy cập được nếu không có nó.
Đã cập nhật khóa

TÍN DỤNG GIAO BANH

cách sử dụng: borg serve [-h] [- tới hạn] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--đường dẫn từ xa ĐƯỜNG] [--giới hạn đường dẫn ĐƯỜNG]

Bắt đầu ở chế độ máy chủ. Lệnh này thường không được sử dụng theo cách thủ công.

đối số tùy chọn:
-h, --help hiển thị thông báo trợ giúp này và thoát
- công việc tới hạn ở cấp độ nhật ký CRITICAL
- lỗi hoạt động trên cấp độ nhật ký LỖI
- cảnh báo công việc ở cấp độ nhật ký CẢNH BÁO (mặc định)
--thông tin, -v, --verbose
làm việc ở cấp độ nhật ký THÔNG TIN
- gỡ lỗi hoạt động trên cấp độ nhật ký GỠ LỖI
- khóa-đợi N đợi khóa, nhưng tối đa. N giây (mặc định: 1).
--show-rc hiển thị / ghi lại mã trả về (rc)
--no-files-cache không tải / cập nhật bộ đệm siêu dữ liệu tệp được sử dụng để
phát hiện các tệp không thay đổi
--umask M đặt umask thành M (cục bộ và từ xa, mặc định: 0077)
--remote-path PATH đặt đường dẫn từ xa thành có thể thực thi (mặc định: "borg")
- PATH hạn chế đến đường dẫn
hạn chế quyền truy cập kho lưu trữ đối với PATH

Mô tả
Lệnh này bắt đầu một quy trình máy chủ kho lưu trữ. Lệnh này thường không được sử dụng
bằng tay.

Các ví dụ
borg serve có hỗ trợ đặc biệt cho các lệnh bắt buộc ssh (xem ủy quyền ví dụ
dưới đây): nó sẽ phát hiện ra rằng bạn sử dụng một lệnh bắt buộc như vậy và trích xuất giá trị của
- giới hạn lối đi tùy chọn). Sau đó, nó sẽ phân tích cú pháp lệnh ban đầu đến từ
khách hàng, hãy đảm bảo rằng nó cũng borg phục vụ và thực thi (các) giới hạn đường dẫn do
lệnh cưỡng bức. Bằng cách đó, các tùy chọn khác do khách hàng đưa ra (như --thông tin or --umask)
được giữ nguyên (và không bị cố định bởi lệnh cưỡng bức).

# Cho phép cặp khóa SSH chỉ chạy borg và chỉ có quyền truy cập vào / path / to / repo.
# Sử dụng các tùy chọn chính để tắt chức năng SSH không cần thiết và có thể nguy hiểm.
# Điều này sẽ giúp bảo mật một hệ thống sao lưu tự động từ xa.
$ mèo ~ / .ssh / allow_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 [...]

TÍN DỤNG UPGRADE

cách sử dụng: nâng cấp borg [-h] [- tới hạn] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--đường dẫn từ xa PATH] [-p] [-n] [-i]
[KHO]

nâng cấp kho lưu trữ từ phiên bản trước

đối số vị trí:
REPOSITORY đường dẫn đến kho lưu trữ được nâng cấp

đối số tùy chọn:
-h, --help hiển thị thông báo trợ giúp này và thoát
- công việc tới hạn ở cấp độ nhật ký CRITICAL
- lỗi hoạt động trên cấp độ nhật ký LỖI
- cảnh báo công việc ở cấp độ nhật ký CẢNH BÁO (mặc định)
--thông tin, -v, --verbose
làm việc ở cấp độ nhật ký THÔNG TIN
- gỡ lỗi hoạt động trên cấp độ nhật ký GỠ LỖI
- khóa-đợi N đợi khóa, nhưng tối đa. N giây (mặc định: 1).
--show-rc hiển thị / ghi lại mã trả về (rc)
--no-files-cache không tải / cập nhật bộ đệm siêu dữ liệu tệp được sử dụng để
phát hiện các tệp không thay đổi
--umask M đặt umask thành M (cục bộ và từ xa, mặc định: 0077)
--remote-path PATH đặt đường dẫn từ xa thành có thể thực thi (mặc định: "borg")
-p, --progress hiển thị tiến trình trong khi nâng cấp kho lưu trữ
-n, --dry-run không thay đổi kho lưu trữ
-i, --inplace rewrite repository tại chỗ, không có cơ hội tiếp tục
quay lại các phiên bản cũ hơn của kho lưu trữ.

Mô tả
Nâng cấp kho lưu trữ Borg hiện có. Điều này hiện hỗ trợ chuyển đổi một gác mái
kho lưu trữ sang Borg và cũng giúp chuyển đổi Borg 0.xx sang 1.0.

Hiện tại, chỉ có thể nâng cấp kho lưu trữ ĐỊA PHƯƠNG (số 465).

Nó sẽ thay đổi các chuỗi ma thuật trong các phân đoạn của kho lưu trữ để phù hợp với ma thuật Borg mới
dây. Các tập tin khóa được tìm thấy trong $ ATTIC_KEYS_DIR hoặc ~ / .attic / phím / cũng sẽ được chuyển đổi
và được sao chép vào $ BORG_KEYS_DIR hoặc Các phím ~ / .config / borg /.

Các tệp bộ nhớ cache được chuyển đổi, từ $ ATTIC_CACHE_DIR hoặc ~ / .cache / gác mái đến $ BORG_CACHE_DIR
or ~ / .cache / borg, nhưng bố cục bộ nhớ cache giữa Borg và Attic đã thay đổi, vì vậy có thể
bản sao lưu đầu tiên sau khi chuyển đổi mất nhiều thời gian hơn dự kiến ​​do đồng bộ hóa bộ nhớ cache.

Nâng cấp sẽ có thể tiếp tục nếu bị gián đoạn, mặc dù nó vẫn sẽ lặp lại trên tất cả
các phân đoạn. Nếu bạn muốn bắt đầu lại từ đầu, hãy sử dụng borg xóa qua kho lưu trữ đã sao chép sang
đảm bảo rằng các tệp trong bộ nhớ cache cũng được xóa:
borg xóa borg

Trừ khi --nơi được chỉ định, quá trình nâng cấp trước tiên sẽ tạo một bản sao lưu của
kho lưu trữ, trong REPOSITORY.upgrade-DATETIME, sử dụng liên kết cứng. Điều này mất nhiều thời gian hơn trong
nâng cấp địa điểm, nhưng an toàn hơn nhiều và cung cấp thông tin tiến độ (trái ngược với cp -đến).
Khi bạn hài lòng với việc chuyển đổi, bạn có thể hủy bản sao lưu một cách an toàn.

CẢNH BÁO: Việc chạy nâng cấp tại chỗ sẽ làm cho bản sao hiện tại không thể sử dụng được với bản cũ hơn
phiên bản, không có cách nào quay lại các phiên bản trước. Điều này có thể THIỆT HẠI NGAY LẬP TỨC CỦA BẠN
KHO! Attic KHÔNG THỂ ĐỌC BÁO CÁO SINH RA, vì các dây thần kỳ đã thay đổi. Bạn
đã được cảnh báo.

Các ví dụ
# Nâng cấp kho lưu trữ borg lên phiên bản mới nhất.
$ borg nâng cấp -v / path / to / repo
tạo bản sao liên kết cứng trong /path/to/repo.upgrade-2016-02-15-20:51:55
mở kho lưu trữ trên gác mái với borg và chuyển đổi
không tìm thấy tệp khóa nào cho kho lưu trữ
chuyển đổi chỉ mục repo /path/to/repo/index.0
chuyển đổi 1 phân đoạn ...
chuyển đổi borg 0.xx sang borg hiện tại
không tìm thấy tệp khóa nào cho kho lưu trữ

KHÁC CỨU GIÚP

borg giúp đỡ mô hình
Các mẫu loại trừ hỗ trợ bốn kiểu riêng biệt, fnmatch, shell, biểu thức chính quy và
tiền tố đường dẫn. Nếu được theo sau bởi dấu hai chấm (':') thì hai ký tự đầu tiên của một mẫu sẽ được sử dụng
như một bộ chọn kiểu. Lựa chọn kiểu rõ ràng là cần thiết khi kiểu không mặc định là
mong muốn hoặc khi mẫu mong muốn bắt đầu bằng hai ký tự chữ và số theo sau bởi
dấu hai chấm (tức là aa: gì đó / *).

Fnmatch, bộ chọn fm:
Các mẫu này sử dụng một biến thể của cú pháp mẫu shell, với '*' khớp với bất kỳ số
nhân vật, '?' khớp với bất kỳ ký tự đơn nào, '[...]' khớp với bất kỳ ký tự đơn nào
được chỉ định, bao gồm các dải ô và '[! ...]' khớp với bất kỳ ký tự nào không được chỉ định. Cho
mục đích của các mẫu này, dấu phân tách đường dẫn ('' dành cho Windows và '/' trên các hệ thống khác)
không được đối xử đặc biệt. Đặt các ký tự meta trong dấu ngoặc vuông cho khớp theo nghĩa đen (tức là
[?] để khớp với ký tự chữ ?). Để một đường dẫn khớp với một mẫu, nó phải
hoàn toàn khớp từ đầu đến cuối hoặc phải khớp từ đầu đến ngay trước một đường dẫn
dải phân cách. Ngoại trừ đường dẫn gốc, các đường dẫn sẽ không bao giờ kết thúc trong dấu phân cách đường dẫn khi
kết hợp được cố gắng. Do đó, nếu một mẫu nhất định kết thúc bằng dấu phân cách đường dẫn, dấu '*' là
được nối trước khi thử so khớp.

Các mẫu kiểu vỏ, bộ chọn NS:
Giống như các mẫu fnmatch, chúng tương tự như các mẫu vỏ. Sự khác biệt là
mô hình có thể bao gồm ** / để phù hợp với không hoặc nhiều cấp thư mục, * để khớp số XNUMX
hoặc nhiều ký tự tùy ý ngoại trừ bất kỳ dấu phân cách đường dẫn nào.

Biểu thức chính quy, bộ chọn lại:
Các biểu thức chính quy tương tự như những biểu thức được tìm thấy trong Perl được hỗ trợ. Không giống như các mẫu vỏ
biểu thức chính quy không bắt buộc phải khớp với đường dẫn hoàn chỉnh và bất kỳ chuỗi con nào khớp
là đủ. Chúng tôi thực sự khuyên bạn nên neo các mẫu vào phần đầu ('^'), đến
end ('$') hoặc cả hai. Dấu phân cách đường dẫn ('' dành cho Windows và '/' trên các hệ thống khác) trong đường dẫn
luôn được chuẩn hóa thành dấu gạch chéo lên phía trước ('/') trước khi áp dụng một mẫu. Thông thường
cú pháp biểu thức được mô tả trong Python tài liệu hướng dẫn cho các re mô-đun.

Đường dẫn tiền tố, bộ chọn trang:
Kiểu mẫu này rất hữu ích để khớp với toàn bộ thư mục con. Mô hình pp: / data / bar
diêm / data / bar và mọi thứ trong đó.

Loại trừ có thể được chuyển qua tùy chọn dòng lệnh --loại trừ. Khi được sử dụng từ bên trong
vỏ các mẫu nên được trích dẫn để bảo vệ chúng khỏi sự giãn nở.

Sản phẩm --Loại khỏi tùy chọn cho phép tải các mẫu loại trừ từ tệp văn bản với một
mẫu trên mỗi dòng. Các dòng trống hoặc bắt đầu bằng dấu số ('#') sau khi xóa
khoảng trắng ở cả hai đầu đều bị bỏ qua. Tiền tố bộ chọn kiểu tùy chọn cũng được hỗ trợ
cho các mẫu được tải từ một tệp. Do các đường dẫn xóa khoảng trắng có khoảng trắng ở
đầu hoặc cuối chỉ có thể được loại trừ bằng cách sử dụng biểu thức chính quy.

Ví dụ:

# Loại trừ '/home/user/file.o' chứ không phải '/home/user/file.odt': $ borg create -e '
*
.o 'backup /

# Loại trừ '/ home / user / junk' và '/ home / user / subir / junk' nhưng # không
'/ home / user / importantjunk' hoặc '/ etc / junk': $ borg create -e '/nhà/
*
/ junk 'backup /

# Loại trừ nội dung của '/ home / user / cache' nhưng không loại trừ nội dung của chính thư mục: $ borg create
-e / home / user / cache / backup /

# Tệp '/ home / user / cache / important' là không đã sao lưu: $ borg create -e
/ home / user / cache / backup / / home / user / cache / important

# Nội dung của các thư mục trong '/ Home'không được sao lưu khi tên # của họ kết thúc bằng
'.tmp' $ borg create --exclude 're: ^/nhà/[^ /] +. tmp / 'backup /

# Tải các tùy chọn loại trừ khỏi tệp $ cat >lude.txt < /nhà//rác *. Tmp
fm: aa: cái gì đó / lại: ^/nhà/[^ /]. tmp / sh:/nhà/
*
/.thumbnails EOF $ borg create --exclude-from allowe.txt backup /

DEBUG HÀNG

Có một số lệnh khác (tất cả đều bắt đầu bằng "debug-") là tất cả không dự định cho
bình thường sử dụng và có khả năng rất nguy hiểm nếu sử dụng không đúng cách.

Chúng tồn tại để cải thiện khả năng gỡ lỗi mà không cần truy cập hệ thống trực tiếp, ví dụ: trong trường hợp
bạn đã từng gặp phải sự cố nghiêm trọng nào đó. Chỉ sử dụng chúng nếu bạn biết mình đang làm gì hoặc
nếu một nhà phát triển Borg đáng tin cậy cho bạn biết phải làm gì.

BỔ SUNG GHI CHÚ

Đây là linh tinh. ghi chú về các chủ đề có thể không được đề cập đủ chi tiết trong cách sử dụng
phần.

Mục cờ
borg tạo -v --danh sách xuất ra một danh sách dài của tất cả các tệp, thư mục và các tệp khác
các mục hệ thống mà nó đã xem xét (bất kể chúng có thay đổi nội dung hay không). Cho mỗi
mặt hàng, nó đặt trước một cờ một chữ cái cho biết loại và / hoặc trạng thái của mặt hàng.

Nếu bạn chỉ quan tâm đến một tập hợp con của đầu ra đó, bạn có thể đưa ra ví dụ --filter = AME và
nó sẽ chỉ hiển thị các tệp thông thường có trạng thái A, M hoặc E (xem bên dưới).

Một ký tự viết hoa đại diện cho trạng thái của một tệp thông thường liên quan đến "tệp"
bộ nhớ cache (không liên quan đến repo - đây là một vấn đề nếu bộ đệm tệp không được sử dụng).
Siêu dữ liệu được lưu trữ trong mọi trường hợp và đối với 'A' và 'M', các khối dữ liệu mới cũng được lưu trữ. Vì
'U' tất cả các phần dữ liệu đề cập đến các phần đã tồn tại.

· 'A' = tệp thông thường, được thêm vào (xem thêm a_status_oddity trong Câu hỏi thường gặp)

· 'M' = tệp thông thường, đã sửa đổi

· 'U' = tệp thông thường, không thay đổi

· 'E' = tệp thông thường, đã xảy ra lỗi khi truy cập / đọc điều này hồ sơ

Một ký tự chữ thường có nghĩa là một loại tệp khác với một tệp thông thường, borg thường chỉ
lưu trữ siêu dữ liệu của họ:

· 'D' = thư mục

· 'B' = chặn thiết bị

· 'C' = thiết bị char

· 'H' = tệp thông thường, liên kết cứng (đến các inodes đã thấy)

· 'S' = liên kết biểu tượng

· 'F' = năm mươi

Các cờ khác được sử dụng bao gồm:

· 'I' = dữ liệu sao lưu được đọc từ đầu vào chuẩn (stdin)

· '-' = chạy khô, mục là không sao lưu

· '?' = mã trạng thái bị thiếu (nếu bạn thấy mã này, vui lòng gửi báo cáo lỗi!)

--chunker-params
Các tham số chunker ảnh hưởng đến cách các tệp đầu vào được cắt thành nhiều phần (khối) sau đó
được xem xét để khử trùng lặp. Chúng cũng có tác động lớn đến việc sử dụng tài nguyên (RAM và đĩa
không gian) vì lượng tài nguyên cần thiết (cũng) được xác định bởi tổng lượng
các phần trong kho lưu trữ (xem Chỉ số / Bộ nhớ đệm trí nhớ sử dụng để biết chi tiết).

--chunker-params = 10,23,16,4095 dẫn đến một sự trùng lặp chi tiết và tạo ra một
số lượng khối và do đó sử dụng nhiều tài nguyên để quản lý chúng. Điều này tốt cho
khối lượng dữ liệu tương đối nhỏ và nếu máy có dung lượng RAM và đĩa trống tốt
không gian.

--chunker-params = 19,23,21,4095 (mặc định) dẫn đến việc khử trùng lặp chi tiết thô và
tạo ra một lượng nhỏ hơn nhiều khối và do đó sử dụng ít tài nguyên hơn. Điều này tốt cho
khối lượng dữ liệu tương đối lớn và nếu máy có dung lượng RAM trống tương đối thấp và
dung lượng đĩa.

Nếu bạn đã tạo một số bản lưu trữ trong một kho lưu trữ và sau đó bạn thay đổi các thông số chunker,
tất nhiên điều này sẽ ảnh hưởng đến việc khử trùng lặp vì các phần sẽ được cắt khác nhau.

Trong trường hợp xấu nhất (tất cả các tệp đều lớn và bị chạm vào giữa các bản sao lưu), tệp này sẽ lưu trữ
tất cả nội dung vào kho lưu trữ một lần nữa.

Thông thường, nó không phải là xấu mặc dù:

· Thường hầu hết các tệp không được chạm vào, vì vậy nó sẽ chỉ sử dụng lại các phần cũ mà nó đã có
trong repo

· Các tệp nhỏ hơn kích thước khối tối thiểu (cả cũ và mới) dẫn đến chỉ có một đoạn
Dù sao đi nữa, vì vậy các phần kết quả là giống nhau và tính năng khử trùng lặp sẽ được áp dụng

Nếu bạn chuyển đổi tham số chunker để tiết kiệm tài nguyên cho một kho hiện có đã có một số
lưu trữ sao lưu, bạn sẽ thấy hiệu ứng ngày càng tăng theo thời gian, khi ngày càng nhiều tệp
đã được chạm và lưu trữ lại bằng cách sử dụng kích thước lớn hơn và tất cả các tham chiếu đến
các phần nhỏ hơn cũ hơn đã bị loại bỏ (bằng cách xóa / cắt bớt các kho lưu trữ).

Nếu bạn muốn thấy ảnh hưởng lớn ngay lập tức đến việc sử dụng tài nguyên, bạn nên bắt đầu một
kho lưu trữ khi thay đổi thông số chunker.

Để biết thêm chi tiết, hãy xem chunker_details.

--read-đặc biệt
Tùy chọn --read-đặc biệt không dành cho bình thường, cấp hệ thống tệp (đầy đủ hoặc
sao lưu một phần đệ quy). Bạn chỉ cung cấp tùy chọn này nếu bạn muốn làm điều gì đó hơn là
... đặc biệt - và nếu bạn đã chọn thủ công một số tệp mà bạn muốn xử lý theo cách đó.

borg tạo --read-đặc biệt sẽ mở tất cả các tệp mà không cần thực hiện bất kỳ xử lý đặc biệt nào
theo loại tệp (ngoại lệ duy nhất ở đây là các thư mục: chúng sẽ được đệ quy
vào trong). Chỉ cần tưởng tượng điều gì sẽ xảy ra nếu bạn làm vậy làm sao tên tập tin --- nội dung bạn sẽ thấy ở đó
là những gì borg sẽ sao lưu cho tên tệp đó.

Vì vậy, ví dụ: các liên kết tượng trưng sẽ được theo sau, nội dung thiết bị khối sẽ được đọc, các đường ống được đặt tên
/ Các ổ cắm miền UNIX sẽ được đọc.

Bạn cần phải cẩn thận với những gì bạn cung cấp dưới dạng tên tệp khi sử dụng --read-đặc biệt, ví dụ nếu
bạn cung cấp cho / dev / zero, bản sao lưu của bạn sẽ không bao giờ kết thúc.

Siêu dữ liệu của các tệp đã cho được lưu vì nó sẽ được lưu mà không có --read-đặc biệt (ví dụ như nó
tên, kích thước của nó [có thể là 0], chế độ của nó, v.v.) - nhưng ngoài ra, nội dung cũng được đọc
từ nó sẽ được lưu cho nó.

Việc khôi phục nội dung của các tệp như vậy hiện chỉ được hỗ trợ một lần qua --thiết bị xuất chuẩn
tùy chọn (và bạn phải chuyển hướng stdout đến nơi mà nó sẽ đi, có thể trực tiếp vào một
tệp thiết bị hiện có mà bạn chọn hoặc gián tiếp qua dd).

Ví dụ
Hãy tưởng tượng bạn đã tạo một số ảnh chụp nhanh của các tập hợp lý (LV) mà bạn muốn sao lưu.

LƯU Ý:
Đối với một số trường hợp, đây là một phương pháp tốt để có được tính nhất quán "giống như sự cố" (tôi gọi nó là
giống như sự cố bởi vì nó giống như bạn sẽ gặp phải nếu bạn chỉ cần nhấn vào nút đặt lại hoặc
máy của bạn sẽ bị hỏng hoàn toàn và hoàn toàn). Điều này tốt hơn là không có sự nhất quán
và là một phương pháp tốt cho một số trường hợp sử dụng, nhưng có thể không đủ tốt nếu bạn có
cơ sở dữ liệu đang chạy.

Sau đó, bạn tạo một kho lưu trữ sao lưu của tất cả các ảnh chụp nhanh này. Quá trình sao lưu sẽ thấy một
trạng thái "đóng băng" của các tập hợp lý, trong khi các quy trình hoạt động trong các tập gốc
tiếp tục thay đổi dữ liệu được lưu trữ ở đó.

Bạn cũng thêm đầu ra của màn hình lv vào bản sao lưu của bạn, vì vậy bạn có thể xem các kích thước LV trong trường hợp
bạn cần tạo lại và khôi phục chúng.

Sau khi sao lưu xong, bạn gỡ bỏ các ảnh chụp nhanh một lần nữa.

$ # tạo ảnh chụp nhanh tại đây
$ lvdisplay> lvdisplay.txt
$ borg create --read-special / path / to / repo :: Arch lvdisplay.txt / dev / vg0 / * - snapshot
$ # xóa ảnh chụp nhanh ở đây

Bây giờ, chúng ta hãy xem cách khôi phục một số LV từ một bản sao lưu như vậy.

$ borg extract / path / to / repo :: Arch lvdisplay.txt
$ # tạo LV trống với kích thước chính xác tại đây (xem lvdisplay.txt).
$ # chúng tôi giả định rằng bạn đã tạo một thư mục gốc và LV nhà trống và ghi đè lên nó ngay bây giờ:
$ 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

Chỉ thêm vào chế độ
Một kho lưu trữ có thể được đặt ở chế độ "chỉ thêm vào", có nghĩa là Borg sẽ không bao giờ ghi đè hoặc
xóa dữ liệu đã cam kết. Điều này hữu ích cho các trường hợp có nhiều máy sao lưu vào một
máy chủ sao lưu trung tâm sử dụng borg phục vụ, vì máy bị tấn công không thể xóa các bản sao lưu
vĩnh viễn

Để kích hoạt chế độ chỉ phần phụ, hãy chỉnh sửa kho lưu trữ cấu hình tập tin và thêm một dòng append_only = 1
đến [kho] (hoặc chỉnh sửa dòng nếu nó tồn tại).

Trong chế độ chỉ thêm vào, Borg sẽ tạo nhật ký giao dịch trong giao dịch tập tin, ở đâu
mỗi dòng là một giao dịch và một dấu thời gian UTC.

Ví dụ
Giả sử kẻ tấn công đã xóa từ xa tất cả các bản sao lưu, nhưng kho lưu trữ của bạn chỉ ở dạng phần phụ
chế độ. Nhật ký giao dịch trong tình huống này có thể trông giống như sau:

giao dịch 1, giờ UTC 2016-03-31T15: 53: 27.383532
giao dịch 5, giờ UTC 2016-03-31T15: 53: 52.588922
giao dịch 11, giờ UTC 2016-03-31T15: 54: 23.887256
giao dịch 12, giờ UTC 2016-03-31T15: 55: 54.022540
giao dịch 13, giờ UTC 2016-03-31T15: 55: 55.472564

Từ nhật ký bảo mật của bạn, bạn kết luận rằng kẻ tấn công đã giành được quyền truy cập lúc 15:54:00 và tất cả
các bản sao lưu bị xóa hoặc thay thế bằng các bản sao lưu bị xâm phạm. Từ nhật ký, bạn biết rằng
giao dịch 11 trở lên bị xâm phạm. Lưu ý rằng ID giao dịch là tên của
cuối cùng nộp trong giao dịch. Ví dụ: giao dịch 11 kéo dài từ các tệp 6 đến 11.

Trong một cuộc tấn công thực sự, bạn có thể muốn giữ nguyên kho lưu trữ bị xâm phạm để phân tích
những gì kẻ tấn công đã cố gắng đạt được. Bạn cũng nên tạo bản sao này để đề phòng
có sự cố xảy ra trong quá trình khôi phục. Vì quá trình khôi phục được thực hiện bằng cách xóa một số tệp,
bản sao liên kết cứng (cp -đến) là đủ.

Bước đầu tiên để đặt lại kho lưu trữ thành giao dịch 5, bước cuối cùng không bị thỏa hiệp
giao dịch, là để loại bỏ gợi ý.N và chỉ số.N các tệp trong kho lưu trữ (hai tệp này
luôn luôn có thể sử dụng). Trong ví dụ này, N là 13.

Sau đó, xóa hoặc di chuyển tất cả các tệp phân đoạn khỏi các thư mục phân đoạn trong dữ liệu/ bắt đầu với
tập 6:

dữ liệu rm / ** / {6..13}

Đó là tất cả cho nó.

nhược điểm
Vì dữ liệu chỉ được nối thêm và không có gì bị xóa, các lệnh như mận khô or xóa sẽ không miễn phí
không gian đĩa, chúng chỉ gắn thẻ dữ liệu là đã bị xóa trong một giao dịch mới.

Lưu ý rằng bạn có thể chuyển đổi qua lại giữa hoạt động bình thường và hoạt động chỉ nối thêm bằng cách chỉnh sửa
tệp cấu hình, nó không phải là "chuyến đi một chiều".

Xa hơn sự cân nhắc
Chế độ chỉ thêm vào không được các công cụ khác ngoài Borg tôn trọng. rm vẫn hoạt động trên
kho. Đảm bảo rằng các máy khách sao lưu chỉ có thể truy cập vào kho thông qua
borg phục vụ.

Đảm bảo rằng không thể truy cập từ xa nếu kho lưu trữ tạm thời được đặt thành bình thường
chế độ cho ví dụ như cắt tỉa thường xuyên.

Các biện pháp bảo vệ khác có thể được thực hiện, nhưng nằm ngoài phạm vi của Borgs. Ví dụ, tệp
ảnh chụp nhanh hệ thống hoặc gói borg phục vụ để đặt các quyền hoặc ACL đặc biệt trên dữ liệu mới
các tập tin.

Sử dụng borgbackup trực tuyến bằng dịch vụ onworks.net