borgbackup - آنلاین در ابر

برنامه:

نام

borg - BorgBackup یک برنامه پشتیبان کپی برداری با فشرده سازی اختیاری و
رمزگذاری تایید شده

Borg از تعدادی دستور تشکیل شده است. هر فرمان تعدادی آرگومان و
گزینه ها. در بخش های بعدی هر دستور به طور مفصل توضیح داده می شود.

عمومی

نوع of ورود به سیستم تولید
سطح گزارش پیکربندی ثبت گزارش داخلی به طور پیش فرض روی WARNING است. این به دلیل این هست که
ما می‌خواهیم Borg عمدتاً بی‌صدا باشد و فقط هشدارها، خطاها و پیام‌های مهم را ارسال کند.

سطوح گزارش: اشکال زدایی < اطلاعات < اخطار < خطا < بحرانی

استفاده کنید - رفع اشکال برای تنظیم سطح گزارش DEBUG - برای دریافت اشکال زدایی، اطلاعات، هشدار، خطا و سطح بحرانی
خروجی.

استفاده کنید -- اطلاعات (و یا -v or -- پرحرف) برای تنظیم سطح گزارش INFO - برای دریافت اطلاعات، هشدار، خطا و
خروجی سطح بحرانی

استفاده کنید -- هشدار (پیش فرض) برای تنظیم سطح ورود به سیستم هشدار - برای دریافت هشدار، خطا و بحرانی
سطح خروجی

استفاده کنید --خطا برای تنظیم سطح گزارش ERROR - برای دریافت خطا و خروجی سطح بحرانی.

استفاده کنید --بحرانی برای تنظیم سطح ورود به سیستم CRITICAL - برای دریافت خروجی سطح بحرانی.

در حالی که شما می توانید متفرقه را تنظیم کنید. سطوح ورود به سیستم، انتظار نداشته باشید که هر دستور متفاوت باشد
خروجی در سطوح مختلف گزارش - این فقط یک امکان است.

هشدار:
گزینه های --critical و --error برای کامل بودن ارائه شده است، استفاده از آنها نیست
توصیه می شود زیرا ممکن است اطلاعات مهم را از دست بدهید.

هشدار:
در حالی که برخی از گزینه ها (مانند --آمار or -- لیست) پیام های اطلاعاتی بیشتری را برای شما ارسال می کند
باید از سطح گزارش INFO (یا پایین تر) استفاده کنید تا آنها را در خروجی گزارش نشان دهید. استفاده کنید -v یا یک
پیکربندی ورود به سیستم

برگشت کد
Borg می تواند با کدهای بازگشتی زیر (rc) خارج شود:

0 = موفقیت (به عنوان INFO ثبت شده است)
1 = هشدار (عملیات به پایان عادی خود رسید، اما هشدارهایی وجود داشت -
شما باید گزارش را بررسی کنید که به عنوان هشدار ثبت شده است)
2 = خطا (مانند یک خطای مرگبار، یک استثنا محلی یا راه دور، عملیات
به پایان عادی خود نرسید، به عنوان ERROR ثبت شد)
128+N = کشته شده توسط سیگنال N (به عنوان مثال 137 == kill -9)

در صورت استفاده از --show-rc، کد برگشتی نیز در سطح مشخص شده به عنوان آخرین ثبت می شود
ورود به سیستم.

محیط متغیر
بورگ از چند متغیر محیطی برای اتوماسیون استفاده می کند:

عمومی:

BORG_REPO
وقتی تنظیم شد، از مقدار برای دادن مکان پیش فرض مخزن استفاده کنید. اگر یک
دستور به یک پارامتر بایگانی نیاز دارد که می توانید آن را مخفف کنید ::بایگانی. اگر یک
دستور به یک پارامتر مخزن نیاز دارد، می توانید آن را کنار بگذارید یا
مخفف کردن به عنوان ::، اگر یک پارامتر موقعیتی مورد نیاز است.

BORG_PASSPHRASE
وقتی تنظیم شد، از مقدار برای پاسخ به سؤال عبارت عبور رمزگذاری شده استفاده کنید
مخازن

BORG_DISPLAY_PASSPHRASE
وقتی تنظیم شد، از مقدار برای پاسخ به "نمایش عبارت عبور برای" استفاده کنید
سؤال تأیید» هنگام تعریف یک عبارت عبور جدید برای رمزگذاری شده
مخازن

BORG_LOGGING_CONF
پس از تنظیم، از نام فایل داده شده به عنوان استفاده کنید شروع کنیدپیکربندی ورود به سیستم به سبک.

BORG_RSH
وقتی تنظیم شد، از این دستور به جای استفاده کنید SSH. این را می توان برای تعیین ssh استفاده کرد
گزینه ها، مانند یک فایل هویت سفارشی SSH -i /path/to/private/keyاست. دیدن مرد
SSH برای گزینه های دیگر

TMPDIR جایی که فایل‌های موقت ذخیره می‌شوند (ممکن است به فضای موقت زیادی نیاز داشته باشد
برخی از عملیات)

برخی از اتوماتیک پاسخ دهندگان (اگر تنظیم، آنها بطور خودکار پاسخ تایید سوالات):

BORG_UNKNOWN_UNENCRYPTED_REPO_ACCESS_IS_OK=نه (و یا =بله)
برای "هشدار: تلاش برای دسترسی به یک رمزگذاری نشده قبلی ناشناخته
مخزن"

BORG_RELOCATED_REPO_ACCESS_IS_OK=نه (و یا =بله)
برای "هشدار: مخزن در مکان ... قبلا در ... قرار داشت."

BORG_CHECK_I_KNOW_WHAT_I_AM_DOING=نه (و یا =بله)
برای «هشدار: «بررسی --تعمیر» یک ویژگی آزمایشی است که ممکن است منجر شود
در از دست دادن اطلاعات."

BORG_DELETE_I_KNOW_WHAT_I_AM_DOING=نه (و یا =بله)
برای "شما درخواست کردید که مخزن را به طور کامل حذف کنید شامل تمام
آرشیوهای موجود در آن:"

توجه: پاسخ ها به حروف کوچک و بزرگ حساس هستند. تنظیم یک مقدار پاسخ نامعتبر ممکن است به شما بدهد
بسته به اینکه آیا مجدداً انجام می شود یا خیر، پاسخ پیش فرض را می دهد یا به صورت تعاملی از شما می پرسد
مجاز (به طور پیش فرض مجاز هستند). بنابراین لطفا اسکریپت های خود را به صورت تعاملی تست کنید
قبل از اینکه آنها را به یک اسکریپت غیر تعاملی تبدیل کنید.

دایرکتوری ها:

BORG_KEYS_DIR
پیش فرض به '~/.config/borg/keys'. این دایرکتوری حاوی کلیدهایی برای رمزگذاری است
مخازن

BORG_CACHE_DIR
پیش فرض به '~/.cache/borg'. این فهرست حاوی حافظه پنهان محلی و
ممکن است برای برخورد با مخازن بزرگ به فضای زیادی نیاز باشد).

ساختمان:

BORG_OPENSSL_PREFIX
فهرست فایل هدر OpenSSL داده شده را به مکان های پیش فرض اضافه می کند
(setup.py).

BORG_LZ4_PREFIX
فهرست فایل هدر LZ4 را به مکان های پیش فرض اضافه می کند (setup.py).

لطفا توجه داشته باشید:

· هنگام استفاده از "بله" گفتن ها بسیار مراقب باشید، اخطارهای با اعلان برای شما وجود دارد /
امنیت/ایمنی داده های شما

· همچنین هنگام قرار دادن عبارت عبور خود در یک اسکریپت بسیار مراقب باشید، مطمئن شوید که آن را دارد
مجوزهای فایل مناسب (به عنوان مثال حالت 600، ریشه: ریشه).

منابع استفاده
Borg ممکن است بسته به اندازه مجموعه داده ای که دارد از منابع زیادی استفاده کند
با.

CPU: از 100% 1 هسته فراتر نمی رود زیرا کد در حال حاضر تک رشته ای است.
به خصوص سطوح فشرده سازی zlib و lzma بالاتر از مقادیر قابل توجهی CPU استفاده می کنند
چرخه

حافظه (رم):
فهرست تکه ها و فهرست فایل ها به دلایل عملکرد در حافظه خوانده می شوند.
فشرده سازی، به ویژه فشرده سازی lzma با سطوح بالا ممکن است به مقادیر قابل توجهی نیاز داشته باشد
از حافظه

موقت فایل ها:
خواندن داده‌ها و ابرداده‌ها از یک مخزن نصب‌شده FUSE در مورد آن مصرف می‌کند
همان فضایی که تکه های کپی برداری شده برای نشان دادن آنها در مخزن استفاده می شود.

مخزن فایل ها:
شامل فهرست تکه ها و فهرست فایل ها (به علاوه مجموعه ای فشرده از
نمایه های تک بایگانی).

تنه فهرست مطالب:
متناسب با مقدار تکه های داده موجود در مخزن شما. تعداد زیادی تکه در مخزن شما
دلالت بر یک شاخص تکه های بزرگ دارد. این امکان وجود دارد که پارامترهای chunker را تغییر دهید (به ایجاد مراجعه کنید
گزینه ها).

فایل ها فهرست مطالب:
متناسب با تعداد فایل های موجود در آخرین نسخه پشتیبان شما. می تواند خاموش شود (نگاه کنید به
گزینه‌ها را ایجاد کنید)، اما اگر این کار را انجام دهید، پشتیبان‌گیری بعدی بسیار کندتر خواهد بود.

شبکه:
اگر مخزن شما از راه دور است، همه کپی شده (و به صورت اختیاری فشرده/
رمزگذاری شده) البته داده ها باید از طریق اتصال (ssh: repo url) عبور کنند. اگر شما
از یک سیستم فایل شبکه نصب شده محلی استفاده کنید، علاوه بر این از برخی عملیات کپی استفاده کنید
برای پشتیبانی تراکنش نیز به اتصال بروید. اگر از چندین منبع پشتیبان تهیه می کنید
به یک مخزن هدف، ترافیک اضافی برای همگام سازی مجدد حافظه پنهان اتفاق می افتد.

در صورت تمایل به جزئیات بیشتر، لطفاً اسناد داخلی را مطالعه کنید.

واحد
برای نمایش کمیت ها، بورگ مراقب قراردادهای معمول مقیاس است. دیسک
اندازه ها در نمایش داده می شوند دهدهی، با استفاده از توان های ده (بنابراین kB یعنی 1000 بایت). برای حافظه
استفاده ، دوتایی پیشوندها استفاده می شوند و با استفاده از نشان داده می شوند کمیسیون مستقل انتخابات دوتایی پیشوندهابا استفاده از
قدرت دو (بنابراین کی بی یعنی 1024 بایت).

تاریخ و زمان
ما تاریخ و زمان را مطابق با ISO-8601 قالب بندی می کنیم، یعنی: YYYY-MM-DD و HH:MM:SS (24h
ساعت).

برای اطلاعات بیشتر در مورد آن، نگاه کنید به: https://xkcd.com/1179/

مگر اینکه غیر از این ذکر شده باشد، تاریخ و زمان محلی را نمایش می دهیم. در داخل، ما ذخیره و پردازش می کنیم
تاریخ و زمان به صورت UTC

بورگ INIT

استفاده: borg init [-h] [-- بحرانی] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--Remote-path PATH] [-e {none,keyfile,repokey}]
[مخزن]

یک مخزن خالی را راه اندازی کنید

استدلال های موضعی:
REPOSITORY مخزن ایجاد کنید

آرگومان های اختیاری:
-h ، - کمک کنید این پیام راهنما را نشان دهید و خارج شوید
-- کار انتقادی در سطح ورود به سیستم CRITICAL
-- error work on log level ERROR
- کار هشدار در سطح گزارش هشدار (پیش‌فرض)
--info، -v، --کلمه
روی اطلاعات سطح گزارش کار کنید
- کار اشکال زدایی در DEBUG سطح ورود
--lock-wait N منتظر قفل باشید، اما حداکثر. N ثانیه (پیش‌فرض: 1).
--show-rc نشان دادن/ورود کد بازگشتی (rc)
--no-files-cache کش ابرداده فایلی را که قبلاً برای آن استفاده شده بود بارگیری/به‌روزرسانی نکنید
شناسایی فایل های بدون تغییر
--umask M umask را روی M قرار دهید (محلی و راه دور، پیش‌فرض: 0077)
--remote-path PATH مسیر راه دور را روی قابل اجرا تنظیم کنید (پیش فرض: "borg")
-e {none,keyfile,repokey}, --encryption {none,keyfile,repokey}
حالت کلید رمزگذاری را انتخاب کنید (پیش‌فرض: "repokey")

توضیحات:
این دستور یک مخزن خالی را مقداردهی اولیه می کند. مخزن یک دایرکتوری سیستم فایل است
حاوی داده های کپی شده از صفر یا چند بایگانی است. رمزگذاری را می توان در فعال کرد
زمان اولیه مخزن

مثال ها
# مخزن محلی (پیش‌فرض استفاده از رمزگذاری در حالت repokey است)
$ borg init /path/to/repo

# مخزن محلی (بدون رمزگذاری)
$ borg init --encryption=none /path/to/repo

# مخزن از راه دور (دسترسی به borg راه دور از طریق ssh)
$ borg init user@hostname:backup

# مخزن از راه دور (کلید خانه خود را ذخیره کنید)
$ borg init --encryption=keyfile user@hostname:backup

نکات مهم در مورد رمزگذاری:

غیرفعال کردن رمزگذاری توصیه نمی شود. رمزگذاری مخزن از شما محافظت می کند
در مقابل موردی که یک مهاجم به مخزن پشتیبان شما دسترسی داشته باشد.

اما مراقب کلید / عبارت عبور باشید:

اگر امنیت «فقط عبارت عبور» را می‌خواهید، از آن استفاده کنید repokey حالت کلید ذخیره خواهد شد
داخل مخزن (در فایل "config" آن). در سناریوی حمله ذکر شده در بالا،
مهاجم کلید را خواهد داشت (اما نه عبارت عبور).

اگر امنیت «گذرواژه و داشتن کلید» را می‌خواهید، از آن استفاده کنید فایل کلیدی حالت کلید خواهد بود
در فهرست اصلی شما (در .config/borg/keys). در سناریوی حمله،
مهاجمی که به تازگی به مخزن شما دسترسی دارد، کلید را نخواهد داشت (و همچنین کلید
عبارت عبور).

از فایل کلید یک نسخه پشتیبان تهیه کنید (فایل کلیدی حالت) یا فایل پیکربندی repo (repokey حالت) و
آن را در مکانی امن نگه دارید تا در صورت خراب شدن یا گم شدن کلید همچنان در اختیار داشته باشید. همچنین
عبارت عبور را در مکانی امن نگه دارید پشتیبان‌گیری که با آن کلید رمزگذاری می‌شود، رمزگذاری نمی‌شود
البته در این مورد به شما کمک کند

مطمئن شوید که از یک رمز عبور خوب استفاده می کنید. نه خیلی کوتاه نه خیلی ساده. رمزگذاری واقعی /
کلید رمزگشایی با رمز عبور شما / قفل شده است. اگر مهاجمی شما را بگیرد
کلید، او نمی تواند بدون دانستن عبارت عبور آن را باز کند و استفاده کند.

مراقب کاراکترهای خاص یا غیر ascii در عبارت عبور خود باشید:

· بورگ عبارت عبور را به صورت یونیکد پردازش می کند (و آن را به صورت utf-8 رمزگذاری می کند)، بنابراین ندارد.
مشکلات در برخورد با عجیب ترین شخصیت ها.

· اما: این لزوماً برای پیکربندی OS / VM / صفحه کلید شما صدق نمی کند.

بنابراین بهتر است از یک عبارت عبور طولانی ساخته شده از نویسه های ساده ascii استفاده کنید تا عبارتی که شامل آن باشد
چیزهای غیر ascii یا کاراکترهایی که به سختی/غیر ممکن است در صفحه کلید دیگری وارد شوند
طرح.

می‌توانید در هر زمانی رمز عبور خود را برای مخازن موجود تغییر دهید، این روی آن تأثیری نخواهد داشت
کلید رمزگذاری/رمزگشایی یا اسرار دیگر.

بورگ ايجاد كردن

استفاده: borg ایجاد [-h] [-- بحرانی] [--خطا] [--اخطار] [--اطلاعات] [--اشکال‌زدایی]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--راه دور مسیر] [-s] [-p] [--list]
[--فیلتر STATUSCHARS] [-e PATTERN]
[--exclude-from EXCLUDEFILE] [--exclude-caches]
[--exclude-if-present FILENAME] [--keep-tag-files]
[-c SECONDS] [-x] [--numeric-owner]
[--مهر زمان yyyy-mm-ddThh:mm:ss]
[--chunker-params CHUNK_MIN_EXP،CHUNK_MAX_EXP،HASH_MASK_BITS،HASH_WINDOW_SIZE]
[--نادیده گرفتن-اینود] [-فشرده سازی C] [--read-special] [-n]
مسیر آرشیو [مسیر ...]

ایجاد آرشیو جدید

استدلال های موضعی:
آرشیو نام آرشیو برای ایجاد (باید معتبر نیز باشد
نام دایرکتوری)
مسیرهای PATH به بایگانی

آرگومان های اختیاری:
-h ، - کمک کنید این پیام راهنما را نشان دهید و خارج شوید
-- کار انتقادی در سطح ورود به سیستم CRITICAL
-- error work on log level ERROR
- کار هشدار در سطح گزارش هشدار (پیش‌فرض)
--info، -v، --کلمه
روی اطلاعات سطح گزارش کار کنید
- کار اشکال زدایی در DEBUG سطح ورود
--lock-wait N منتظر قفل باشید، اما حداکثر. N ثانیه (پیش‌فرض: 1).
--show-rc نشان دادن/ورود کد بازگشتی (rc)
--no-files-cache کش ابرداده فایلی را که قبلاً برای آن استفاده شده بود بارگیری/به‌روزرسانی نکنید
شناسایی فایل های بدون تغییر
--umask M umask را روی M قرار دهید (محلی و راه دور، پیش‌فرض: 0077)
--remote-path PATH مسیر راه دور را روی قابل اجرا تنظیم کنید (پیش فرض: "borg")
-s، --stats آمار را برای آرشیو ایجاد شده چاپ می کند
-p، --progress نمایش پیشرفت در هنگام ایجاد آرشیو،
نمایش اندازه های اصلی، فشرده و کپی شده،
به دنبال آن تعداد فایل های دیده شده و مسیر
در حال پردازش، پیش فرض: نادرست
-- لیست خروجی لیست کامل موارد (فایل ها، dirs، ...)
--filter STATUSCHARS فقط مواردی را با کاراکترهای وضعیت داده شده نمایش می دهد
-e PATTERN، --exclude PATTERN
مسیرهای مطابق با PATTERN را حذف کنید
--exclude-از EXCLUDEFILE
الگوهای حذف را از EXCLUDEFILE بخوانید، یکی در هر خط
--exclude-caches دایرکتوری هایی که حاوی فایل CACHEDIR.TAG هستند را حذف می کند
(http://www.brynosaurus.com/cachedir/spec.html)
--exclude-if-present FILENAME
دایرکتوری هایی که حاوی فایل مشخص شده هستند را حذف کنید
--keep-tag-files فایل های برچسب را از کش/دایرکتوری های حذف شده نگهداری می کند
-c SECONDS، --Checkpoint-interval SECONDS
نوشتن نقطه بازرسی هر SECONDS ثانیه (پیش‌فرض: 300)
-x، --one-file-system
در همان سیستم فایل بمانید، از نقاط نصب عبور نکنید
--numeric-owner فقط شناسه های عددی کاربر و گروه را ذخیره می کند
--مهر زمان yyyy-mm-ddThh:mm:ss
به صورت دستی تاریخ/زمان ایجاد بایگانی (UTC) را مشخص کنید.
متناوبا، یک فایل/دایرکتوری مرجع بدهید.
--chunker-params CHUNK_MIN_EXP,CHUNK_MAX_EXP,HASH_MASK_BITS,HASH_WINDOW_SIZE
پارامترهای chunker را مشخص کنید. پیش فرض: 19,23,21,4095
--ignore-inode نادیده گرفتن داده های inode در حافظه پنهان فراداده فایل استفاده می شود
شناسایی فایل های بدون تغییر
-C COMPRESSION، --compression COMPRESSION
انتخاب الگوریتم فشرده سازی (و سطح): هیچ == خیر
فشرده سازی (پیش فرض)، lz4 == lz4، zlib == zlib
(سطح پیش فرض 6)، zlib,0 .. zlib,9 == zlib (با
سطح 0..9)، lzma == lzma (سطح پیش فرض 6)، lzma، 0 ..
lzma,9 == lzma (با سطح 0..9).
--read-special فایل های خاص را باز کنید و طوری بخوانید که انگار معمولی هستند
فایل ها
-n، --dry-run یک آرشیو پشتیبان ایجاد نکنید

توضیحات:
این دستور یک بایگانی پشتیبان ایجاد می کند که حاوی تمام فایل هایی است که به صورت بازگشتی یافت می شوند
پیمودن تمام مسیرهای مشخص شده آرشیو تقریباً هیچ فضای دیسکی را برای فایل ها یا
بخش هایی از فایل هایی که قبلاً در آرشیوهای دیگر ذخیره شده اند.

برای سرعت بخشیدن به پشتیبان گیری از طریق sshfs و سیستم های فایل شبکه مشابه که این کار را نمی کنند
اطلاعات inode صحیح را ارائه دهید. پرچم --ignore-inode می تواند مورد استفاده قرار گیرد. این به طور بالقوه
قابلیت اطمینان تشخیص تغییر را کاهش می‌دهد، در حالی که از خواندن همیشه همه فایل‌ها اجتناب می‌کند
این فایل سیستم ها

برای دریافت راهنمایی بیشتر در مورد حذف الگوها، خروجی فرمان "borg help patterns" را ببینید.

مثال ها
# پشتیبان گیری ~/ اسناد در آرشیوی به نام "مستندات من"
$ borg ایجاد /path/to/repo::my-documents ~/ اسناد

# همان، اما به طور کامل همه فایل‌ها را همانطور که آنها را پردازش می‌کنیم فهرست کنید
$ borg create -v --list /path/to/repo::my-documents ~/ اسناد

# پشتیبان گیری ~/ اسناد و ~/src اما فایل های pyc را حذف کنید
$ borg ایجاد /path/to/repo::my-files \
~/ اسناد \
~/src \
-- استثناء "*.pyc"

# از دایرکتوری های خانگی به استثنای ریز عکسها (یعنی فقط
# / خانه /*/.thumbnails مستثنی است، نه / خانه /***/*/تصاویر کوچک)
$borg /path/to/repo::my-files را ایجاد کنید / صفحه اصلی \
--exclude 're:^/ خانه /[^/]+/\.thumbnails/'

# همین کار را با استفاده از الگوی پوسته ای انجام دهید
$borg /path/to/repo::my-files را ایجاد کنید / صفحه اصلی \
-- exclude 'sh:/ خانه /*/.تصاویر کوچک'

# از سیستم فایل ریشه در یک آرشیو با نام "root-YYYY-MM-DD" پشتیبان تهیه کنید.
# از فشرده سازی zlib (خوب، اما کند) استفاده کنید - پیش فرض فشرده سازی نیست
$ borg create -C zlib,6 /path/to/repo::root-{now:%Y-%m-%d} / --one-file-system

# تلاش زیادی در حذف دوبله دانه های خوب (مدیریت تکه های بزرگ).
# سربار، به مقدار زیادی رم و فضای دیسک نیاز دارد، فرمول را در قسمت داخلی ببینید
# docs - پارامترهای مشابه borg < 1.0 یا attic):
$ borg create --chunker-params 10,23,16,4095 /path/to/repo::small /smallstuff

# پشتیبان گیری از یک دستگاه خام (در آن زمان نباید فعال/در حال استفاده/نصب شده باشد)
$ dd if=/dev/sdx bs=10M | borg create /path/to/repo::my-sdx -

# بدون فشرده سازی (پیش فرض)
$ borg ایجاد /path/to/repo::arch ~

# فوق العاده سریع، فشرده سازی کم
$ borg ایجاد --compression lz4 /path/to/repo::arch ~

# سرعت کمتر، فشرده سازی بیشتر (N = 0..9)
$ borg ایجاد --compression zlib,N /path/to/repo::arch ~

# فشرده سازی حتی آهسته تر و حتی بیشتر (N = 0..9)
$ borg ایجاد --compression lzma,N /path/to/repo::arch ~

# قالب‌بندی برچسب‌های موجود برای نام بایگانی:
# {now}، {utcnow}، {fqdn}، {hostname}، {user}، {pid}
# نام میزبان کوتاه، نام کاربری پشتیبان و یونیکس‌تایم فعلی (ثانیه از دوره) اضافه کنید
$ borg create /path/to/repo::{hostname}-{user}-{now:%s} ~

بورگ استخراج کردن

استفاده: استخراج بورگ [-h] [-- بحرانی] [--خطا] [--اخطار] [--اطلاعات] [--اشکال‌زدایی]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--Remote-path PATH] [--list] [-n] [-e PATTERN]
[--exclude-from EXCLUDEFILE] [--numeric-owner]
[--strip-components NUMBER] [--stdout] [--sparse]
آرشیو [PATH [PATH ...]]

استخراج مطالب بایگانی

استدلال های موضعی:
آرشیو آرشیو برای استخراج
مسیرهای PATH برای استخراج. الگوها پشتیبانی می شوند

آرگومان های اختیاری:
-h ، - کمک کنید این پیام راهنما را نشان دهید و خارج شوید
-- کار انتقادی در سطح ورود به سیستم CRITICAL
-- error work on log level ERROR
- کار هشدار در سطح گزارش هشدار (پیش‌فرض)
--info، -v، --کلمه
روی اطلاعات سطح گزارش کار کنید
- کار اشکال زدایی در DEBUG سطح ورود
--lock-wait N منتظر قفل باشید، اما حداکثر. N ثانیه (پیش‌فرض: 1).
--show-rc نشان دادن/ورود کد بازگشتی (rc)
--no-files-cache کش ابرداده فایلی را که قبلاً برای آن استفاده شده بود بارگیری/به‌روزرسانی نکنید
شناسایی فایل های بدون تغییر
--umask M umask را روی M قرار دهید (محلی و راه دور، پیش‌فرض: 0077)
--remote-path PATH مسیر راه دور را روی قابل اجرا تنظیم کنید (پیش فرض: "borg")
-- لیست خروجی لیست کامل موارد (فایل ها، dirs، ...)
-n، --dry-run در واقع هیچ فایلی را تغییر نمی دهند
-e PATTERN، --exclude PATTERN
مسیرهای مطابق با PATTERN را حذف کنید
--exclude-از EXCLUDEFILE
الگوهای حذف را از EXCLUDEFILE بخوانید، یکی در هر خط
--numeric-owner فقط از شناسه های عددی کاربر و گروه تبعیت می کند
---strip-components NUMBER
تعداد مشخص شده عناصر مسیر پیشرو را حذف کنید.
نام‌های مسیر با عناصر کمتر بی‌صدا خواهند بود
رد شد
--stdout تمام داده های استخراج شده را در stdout بنویسد
--sparse سوراخ هایی را در فایل پراکنده خروجی از صفر ایجاد کنید
تکه ها

توضیحات:
این دستور محتویات یک آرشیو را استخراج می کند. به طور پیش فرض کل آرشیو است
استخراج شده اما زیرمجموعه ای از فایل ها و دایرکتوری ها را می توان با ارسال یک لیست انتخاب کرد راه ها
به عنوان استدلال انتخاب فایل را می توان با استفاده از گزینه محدودتر کرد -- استثناء کردن گزینه.

برای دریافت راهنمایی بیشتر در مورد حذف الگوها، خروجی فرمان "borg help patterns" را ببینید.

مثال ها
# کل آرشیو را استخراج کنید
$ borg استخراج /path/to/repo::my-files

# کل آرشیو و لیست فایل ها را در حین پردازش استخراج کنید
$ borg استخراج -v --list /path/to/repo::my-files

# دایرکتوری "src" را استخراج کنید
$ borg استخراج /path/to/repo::my-files home/USERNAME/src

# دایرکتوری "src" را استخراج کنید اما فایل های شی را حذف کنید
$ borg استخراج /path/to/repo::my-files home/USERNAME/src --exclude '*.o'

# یک دستگاه خام را بازیابی کنید (در آن زمان نباید فعال / در حال استفاده / نصب شده باشد)
استخراج $ borg --stdout /path/to/repo::my-sdx | dd=/dev/sdx bs=10M

توجه داشته باشید: در حال حاضر، عصاره همیشه می نویسد: به la جاری کارگر فهرست راهنما (".")
پس مطمئن باش cd قبل از تماس به مکان مناسب بورگ عصاره.

بورگ بررسی

استفاده: بررسی بورگ [-h] [-- بحرانی] [--خطا] [--اخطار] [--اطلاعات] [--اشکال زدایی]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--راه دور راه دور] [-فقط مخزن] [-فقط بایگانی]
[--تعمیر] [--ذخیره-فضا] [--آخرین N] [-P PREFIX]
[REPOSITORY_OR_ARCHIVE]

سازگاری مخزن را بررسی کنید

استدلال های موضعی:
REPOSITORY_OR_ARCHIVE
مخزن یا بایگانی برای بررسی سازگاری

آرگومان های اختیاری:
-h ، - کمک کنید این پیام راهنما را نشان دهید و خارج شوید
-- کار انتقادی در سطح ورود به سیستم CRITICAL
-- error work on log level ERROR
- کار هشدار در سطح گزارش هشدار (پیش‌فرض)
--info، -v، --کلمه
روی اطلاعات سطح گزارش کار کنید
- کار اشکال زدایی در DEBUG سطح ورود
--lock-wait N منتظر قفل باشید، اما حداکثر. N ثانیه (پیش‌فرض: 1).
--show-rc نشان دادن/ورود کد بازگشتی (rc)
--no-files-cache کش ابرداده فایلی را که قبلاً برای آن استفاده شده بود بارگیری/به‌روزرسانی نکنید
شناسایی فایل های بدون تغییر
--umask M umask را روی M قرار دهید (محلی و راه دور، پیش‌فرض: 0077)
--remote-path PATH مسیر راه دور را روی قابل اجرا تنظیم کنید (پیش فرض: "borg")
--repository-only فقط بررسی های مخزن را انجام می دهد
--archives-only فقط بررسی های بایگانی را انجام می دهد
تلاش برای تعمیر هرگونه ناهماهنگی یافت شده
--save-space کندتر کار می کند، اما با استفاده از فضای کمتر
-- آخرین N فقط آخرین N بایگانی را بررسی کنید (پیش‌فرض: همه)
-P PREFIX، --prefix PREFIX
فقط نام های بایگانی را در نظر بگیرید که با این پیشوند شروع می شوند

توضیحات:
دستور چک، سازگاری یک مخزن و آرشیوهای مربوطه را تأیید می کند.

ابتدا فایل های داده های مخزن زیربنایی بررسی می شوند:

· برای همه بخش ها بخش سحر و جادو (هدر) بررسی شده است

· برای تمام اشیاء ذخیره شده در بخش ها، تمام ابرداده ها (به عنوان مثال crc و اندازه) و همه داده ها
خواندن. داده های خوانده شده بر اساس اندازه و CRC بررسی می شود. پوسیدگی بیت و انواع دیگر تصادفی
از این طریق می توان آسیب را تشخیص داد.

· اگر در حالت تعمیر هستیم و برای یک سگمنت خطای یکپارچگی تشخیص داده شد، سعی می کنیم
تا آنجا که ممکن است اشیاء را از بخش بازیابی کنید.

· در حالت تعمیر، اطمینان حاصل می کند که شاخص با داده های ذخیره شده در مطابقت دارد
بخش ها

· اگر از سرور مخزن از راه دور از طریق ssh: استفاده می کنید، بررسی مخزن بر روی سرور مخزن اجرا می شود.
بدون ایجاد ترافیک شبکه قابل توجه.

· بررسی مخزن را می توان با استفاده از گزینه --archives-only رد کرد.

دوم، سازگاری و صحت ابرداده بایگانی تأیید می شود:

· آیا مانیفست مخزن موجود است؟ اگر نه، از تکه های ابرداده بایگانی بازسازی می شود (این
نیاز به خواندن و رمزگشایی تمام ابرداده ها و داده ها دارد).

· بررسی کنید که آیا تکه ابرداده بایگانی وجود دارد یا خیر. اگر نه، بایگانی را از مانیفست حذف کنید.

· برای همه فایل ها (موارد) موجود در بایگانی، برای همه تکه های ارجاع شده توسط این فایل ها، بررسی کنید که آیا
تکه موجود است (اگر نه و در حالت تعمیر هستیم، آن را با یک تکه هم اندازه جایگزین کنید
صفر). این نیاز به خواندن فراداده بایگانی و فایل دارد، اما نه داده ها.

· اگر در حالت تعمیر هستیم و همه بایگانی ها را بررسی کرده ایم: حذف تکه های یتیم از
مخزن

· اگر از سرور مخزن از راه دور از طریق ssh: استفاده می کنید، بررسی بایگانی روی مشتری اجرا می شود.
ماشین (زیرا اگر رمزگذاری فعال باشد، چک ها نیاز به رمزگشایی دارند و این
همیشه در سمت مشتری انجام می شود، زیرا دسترسی کلید مورد نیاز خواهد بود).

· بررسی های بایگانی می تواند زمان بر باشد، آنها را می توان با استفاده از
- گزینه فقط مخزن.

بورگ دوباره امتحان کنید

استفاده: تغییر نام بورگ [-h] [-- بحرانی] [--خطا] [--اخطار] [--اطلاعات] [--اشکال‌زدایی]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--راه دور راه دور]
بایگانی NEWNAME

تغییر نام بایگانی موجود

استدلال های موضعی:
آرشیو برای تغییر نام
NEWNAME نام بایگانی جدید برای استفاده

آرگومان های اختیاری:
-h ، - کمک کنید این پیام راهنما را نشان دهید و خارج شوید
-- کار انتقادی در سطح ورود به سیستم CRITICAL
-- error work on log level ERROR
- کار هشدار در سطح گزارش هشدار (پیش‌فرض)
--info، -v، --کلمه
روی اطلاعات سطح گزارش کار کنید
- کار اشکال زدایی در DEBUG سطح ورود
--lock-wait N منتظر قفل باشید، اما حداکثر. N ثانیه (پیش‌فرض: 1).
--show-rc نشان دادن/ورود کد بازگشتی (rc)
--no-files-cache کش ابرداده فایلی را که قبلاً برای آن استفاده شده بود بارگیری/به‌روزرسانی نکنید
شناسایی فایل های بدون تغییر
--umask M umask را روی M قرار دهید (محلی و راه دور، پیش‌فرض: 0077)
--remote-path PATH مسیر راه دور را روی قابل اجرا تنظیم کنید (پیش فرض: "borg")

توضیحات:
این دستور یک بایگانی را در مخزن تغییر نام می دهد.

مثال ها
$ borg ایجاد /path/to/repo::archivename ~
$ borg list /path/to/repo
نام آرشیو دوشنبه, 2016/02/15 19:50:19

$ borg تغییر نام /path/to/repo::archivename newname
$ borg list /path/to/repo
newname دوشنبه, 2016-02-15 19:50:19

بورگ لیست

استفاده: فهرست بورگ [-h] [-- بحرانی] [--خطا] [--اخطار] [--اطلاعات] [--اشکال‌زدایی]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--Remote-path PATH] [--short] [--list-format LISTFORMAT]
[-P PREFIX]
[REPOSITORY_OR_ARCHIVE]

فهرست مطالب بایگانی یا مخزن

استدلال های موضعی:
REPOSITORY_OR_ARCHIVE
مخزن/بایگانی برای فهرست کردن محتویات

آرگومان های اختیاری:
-h ، - کمک کنید این پیام راهنما را نشان دهید و خارج شوید
-- کار انتقادی در سطح ورود به سیستم CRITICAL
-- error work on log level ERROR
- کار هشدار در سطح گزارش هشدار (پیش‌فرض)
--info، -v، --کلمه
روی اطلاعات سطح گزارش کار کنید
- کار اشکال زدایی در DEBUG سطح ورود
--lock-wait N منتظر قفل باشید، اما حداکثر. N ثانیه (پیش‌فرض: 1).
--show-rc نشان دادن/ورود کد بازگشتی (rc)
--no-files-cache کش ابرداده فایلی را که قبلاً برای آن استفاده شده بود بارگیری/به‌روزرسانی نکنید
شناسایی فایل های بدون تغییر
--umask M umask را روی M قرار دهید (محلی و راه دور، پیش‌فرض: 0077)
--remote-path PATH مسیر راه دور را روی قابل اجرا تنظیم کنید (پیش فرض: "borg")
- فقط نام فایل/دایرکتوری را چاپ کنید، هیچ چیز دیگری
--list-format LISTFORMAT
فرمت فهرست بندی فایل های بایگانی را مشخص کنید (پیش فرض:
"{mode} {user:6} {group:6} {size:8d} {isomtime}
{path}{extra}{NEWLINE}") "{formatkeys}" ویژه وجود دارد
برای فهرست کردن کلیدهای موجود
-P PREFIX، --prefix PREFIX
فقط نام های بایگانی را در نظر بگیرید که با این پیشوند شروع می شوند

توضیحات:
این دستور محتویات یک مخزن یا یک آرشیو را فهرست می کند.

مثال ها
$ borg list /path/to/repo
دوشنبه دوشنبه 2016/02/15 19:15:11
مخزن دوشنبه, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
newname دوشنبه, 2016-02-15 19:50:19
...

$ borg list /path/to/repo::root-2016-02-15
drwxr-xr-x ریشه ریشه 0 دوشنبه, 2016-02-15 17:44:27.
drwxrwxr-x root root 0 Mon, 2016/02/15 19:04:49 bin
-rwxr-xr-x root root 1029624 Thu, 2014-11-13 00:08:51 bin/bash
ریشه ریشه lrwxrwxrwx 0 جمعه، 2015/03/27 20:24:26 bin/bzcmp -> bzdiff
-rwxr-xr-x root root 2140 Fri, 2015-03-27 20:24:22 bin/bzdiff
...

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

# ببینید چه چیزی بین بایگانی ها تغییر می کند، بر اساس زمان تغییر فایل، اندازه و مسیر فایل
$ 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 کد 1422781200 0 کد
1422781200 0 code/myproject 1422781200 0 code/myproject
1422781200 1416192 code/myproject/file.ext | 1454664653 1416192 code/myproject/file.ext
...

بورگ حذف

استفاده: بورگ حذف [-h] [-- بحرانی] [--خطا] [--اخطار] [--اطلاعات] [--اشکال‌زدایی]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--راه دور مسیر] [-p] [-s] [-c] [--save-space]
[هدف]

یک مخزن یا آرشیو موجود را حذف کنید

استدلال های موضعی:
بایگانی یا مخزن TARGET برای حذف

آرگومان های اختیاری:
-h ، - کمک کنید این پیام راهنما را نشان دهید و خارج شوید
-- کار انتقادی در سطح ورود به سیستم CRITICAL
-- error work on log level ERROR
- کار هشدار در سطح گزارش هشدار (پیش‌فرض)
--info، -v، --کلمه
روی اطلاعات سطح گزارش کار کنید
- کار اشکال زدایی در DEBUG سطح ورود
--lock-wait N منتظر قفل باشید، اما حداکثر. N ثانیه (پیش‌فرض: 1).
--show-rc نشان دادن/ورود کد بازگشتی (rc)
--no-files-cache کش ابرداده فایلی را که قبلاً برای آن استفاده شده بود بارگیری/به‌روزرسانی نکنید
شناسایی فایل های بدون تغییر
--umask M umask را روی M قرار دهید (محلی و راه دور، پیش‌فرض: 0077)
--remote-path PATH مسیر راه دور را روی قابل اجرا تنظیم کنید (پیش فرض: "borg")
-p، --progress نمایش پیشرفت در حین حذف یک آرشیو واحد
-s، --stats آمار را برای آرشیو حذف شده چاپ می کند
-c، --cache-only فقط کش محلی را برای مخزن داده شده حذف می کند
--save-space کندتر کار می کند، اما با استفاده از فضای کمتر

توضیحات:
این دستور یک بایگانی را از مخزن یا مخزن کامل حذف می کند. دیسک
فضا بر این اساس احیا می شود. اگر مخزن کامل را حذف کنید، کش محلی برای
آن (در صورت وجود) نیز حذف می شود.

مثال ها
# یک آرشیو پشتیبان را حذف کنید:
$ borg حذف /path/to/repo:: دوشنبه

# کل مخزن و کش محلی مربوطه را حذف کنید:
$ borg حذف /path/to/repo
شما درخواست کردید که مخزن *از جمله* تمام آرشیوهایی که در آن موجود است را به طور کامل حذف کنید:
مخزن دوشنبه, 2016-02-15 19:26:54
root-2016-02-15 Mon, 2016-02-15 19:36:29
newname دوشنبه, 2016-02-15 19:50:19
اگر متوجه شدید و می‌خواهید ادامه دهید، «YES» را تایپ کنید: بله

بورگ هرس

استفاده: بورگ هرس [-h] [-- بحرانی] [--خطا] [--اخطار] [--اطلاعات] [--اشکال زدایی]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--راه دور مسیر] [-n] [-s] [--list]
[--keep-in-in-WITHIN] [-HOURLY] [-d DAILY] [-w هفتگی]
[-m MONTHLY] [-Y YARLY] [-P PREFIX] [--save-space]
[مخزن]

آرشیوهای مخزن را طبق قوانین مشخص شده هرس کنید

استدلال های موضعی:
REPOSITORY مخزن برای هرس کردن

آرگومان های اختیاری:
-h ، - کمک کنید این پیام راهنما را نشان دهید و خارج شوید
-- کار انتقادی در سطح ورود به سیستم CRITICAL
-- error work on log level ERROR
- کار هشدار در سطح گزارش هشدار (پیش‌فرض)
--info، -v، --کلمه
روی اطلاعات سطح گزارش کار کنید
- کار اشکال زدایی در DEBUG سطح ورود
--lock-wait N منتظر قفل باشید، اما حداکثر. N ثانیه (پیش‌فرض: 1).
--show-rc نشان دادن/ورود کد بازگشتی (rc)
--no-files-cache کش ابرداده فایلی را که قبلاً برای آن استفاده شده بود بارگیری/به‌روزرسانی نکنید
شناسایی فایل های بدون تغییر
--umask M umask را روی M قرار دهید (محلی و راه دور، پیش‌فرض: 0077)
--remote-path PATH مسیر راه دور را روی قابل اجرا تنظیم کنید (پیش فرض: "borg")
-n، --dry-run مخزن را تغییر ندهید
-s، --stats آمار را برای آرشیو حذف شده چاپ می کند
- لیست خروجی فهرست مفصل از آرشیوهایی که نگه می دارد/آلو می کند
--keep-within WITHIN تمام آرشیوها را در این بازه زمانی نگه دارید
-H HOURLY، --keep-hourly HOURLY
تعداد آرشیوهای ساعتی برای نگهداری
-d DAILY, --keep-dily DAILY
تعداد آرشیو روزانه برای نگهداری
-w WEEKLY، --keep-weekly WEEKLY
تعداد آرشیوهای هفتگی برای نگهداری
-m MONTHLY, --keep-monthly MONTHLY
تعداد آرشیوهای ماهانه برای نگهداری
-y YEARLY، --keep-yearly YEARLY
تعداد آرشیوهای سالانه برای نگهداری
-P PREFIX، --prefix PREFIX
فقط نام های بایگانی را در نظر بگیرید که با این پیشوند شروع می شوند
--save-space کندتر کار می کند، اما با استفاده از فضای کمتر

توضیحات:
دستور prune یک مخزن را با حذف آرشیوهایی که با هیچ یک از آنها مطابقت ندارند، هرس می کند
گزینه های نگهداری مشخص شده این دستور معمولاً توسط اسکریپت های پشتیبان خودکار استفاده می شود
مایل به نگهداری تعداد معینی از پشتیبان گیری های تاریخی هستند.

به عنوان مثال، "-d 7" به معنای نگهداری آخرین نسخه پشتیبان در هر روز، حداکثر تا 7 مورد اخیر است
روزهای با پشتیبان گیری (روزهای بدون پشتیبان حساب نمی شوند). قوانین از ساعتی اعمال می شود
به سالانه، و نسخه‌های پشتیبان انتخاب شده توسط قوانین قبلی در شمار نسخه‌های بعدی به حساب نمی‌آیند
قوانین زمانی که هر نسخه پشتیبان کامل می شود برای اهداف هرس استفاده می شود. تاریخ و زمان
در منطقه زمانی محلی تفسیر می شوند و هفته ها از دوشنبه تا یکشنبه می گذرد. مشخص کردن الف
تعداد منفی آرشیو برای نگهداری به این معنی است که محدودیتی وجود ندارد.

گزینه "--keep-within" یک آرگومان به شکل " می گیرد. "، جایی که کاراکتر "H" است،
"d"، "w"، "m"، "y". به عنوان مثال، "--keep-within 2d" به معنای نگه داشتن تمام آرشیوهایی است که بودند
در 48 ساعت گذشته ایجاد شده است. "1m" به معنای "31d" گرفته شده است. آرشیو با
این گزینه در مجموع مشخص شده توسط هیچ گزینه دیگری به حساب نمی آید.

اگر یک پیشوند با -P تنظیم شود، تنها آرشیوهایی که با پیشوند شروع می شوند در نظر گرفته می شوند
برای حذف و فقط آن آرشیوها در مجموع مشخص شده توسط قوانین حساب می شوند.
در غیر این صورت، تمام آرشیوهای موجود در مخزن کاندید حذف هستند!

مثال ها
مراقب باشید، هرس کردن یک دستور بالقوه خطرناک است، بایگانی های پشتیبان را حذف می کند.

پیش فرض هرس این است که به تمام بایگانی in la مخزن مگر اینکه آن را محدود کنید
عملیات به زیر مجموعه ای از آرشیوها با استفاده از -- پیشوند. هنگام استفاده از -- پیشوند، مراقب باشید
یک پیشوند خوب انتخاب کنید - به عنوان مثال اگر نمی خواهید مطابقت داشته باشید از پیشوند "foo" استفاده نکنید
"فوبار".

اکیداً توصیه می شود همیشه اجرا کنید پروانه -- خشک اجرا شود ... اول، پس شما خواهید دید که آن چیست
بدون اینکه واقعاً کاری انجام دهد انجام می دهد.

# 7 آرشیو آخر روز و 4 آرشیو آخر هفته اضافی را نگه دارید.
# اجرای خشک را بدون حذف چیزی انجام دهید.
$ borg prune --dry-run --keep-daily=7 --keep-weekly=4 /path/to/repo

# مانند بالا، اما فقط برای نام های بایگانی که با "foo" شروع می شوند اعمال می شود:
$ borg prune --keep-daily=7 --keep-weekly=4 --prefix=foo /path/to/repo

# 7 پایان روز، 4 آرشیو آخر هفته اضافی را نگه دارید،
# و آرشیو پایان ماه برای هر ماه:
$ borg prune --keep-daily=7 --keep-weekly=4 --keep-monthly=-1 /path/to/repo

# تمام نسخه های پشتیبان را در 10 روز گذشته، 4 آرشیو آخر هفته اضافی نگه دارید،
# و آرشیو پایان ماه برای هر ماه:
$ borg prune --keep-within=10d --keep-weekly=4 --keep-monthly=-1 /path/to/repo

بورگ اطلاعات

استفاده: اطلاعات بورگ [-h] [-- بحرانی] [--خطا] [--اخطار] [--اطلاعات] [--اشکال‌زدایی]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--راه دور راه دور]
بایگانی

نمایش جزئیات آرشیو مانند فضای دیسک استفاده شده

استدلال های موضعی:
آرشیو آرشیو برای نمایش اطلاعات در مورد

آرگومان های اختیاری:
-h ، - کمک کنید این پیام راهنما را نشان دهید و خارج شوید
-- کار انتقادی در سطح ورود به سیستم CRITICAL
-- error work on log level ERROR
- کار هشدار در سطح گزارش هشدار (پیش‌فرض)
--info، -v، --کلمه
روی اطلاعات سطح گزارش کار کنید
- کار اشکال زدایی در DEBUG سطح ورود
--lock-wait N منتظر قفل باشید، اما حداکثر. N ثانیه (پیش‌فرض: 1).
--show-rc نشان دادن/ورود کد بازگشتی (rc)
--no-files-cache کش ابرداده فایلی را که قبلاً برای آن استفاده شده بود بارگیری/به‌روزرسانی نکنید
شناسایی فایل های بدون تغییر
--umask M umask را روی M قرار دهید (محلی و راه دور، پیش‌فرض: 0077)
--remote-path PATH مسیر راه دور را روی قابل اجرا تنظیم کنید (پیش فرض: "borg")

توضیحات:
این دستور برخی از اطلاعات دقیق در مورد آرشیو مشخص شده را نمایش می دهد.

مثال ها
$ borg info /path/to/repo::root-2016-02-15
نام: root-2016-02-15
Fingerprint: 57c827621f21b000a8d363c1e163cc55983822b3afff3a96df595077a660be50
نام میزبان: myhostname
نام کاربری: root
زمان (شروع): دوشنبه, 2016/02/15 19:36:29
زمان (پایان): دوشنبه, 2016-02-15 19:39:26
خط فرمان: /usr/local/bin/borg create -v --list -C zlib,6 /path/to/repo::root-2016-02-15 / --one-file-system
تعداد فایل: 38100

اندازه اصلی اندازه فشرده سایز کپی شده
این آرشیو: 1.33 گیگابایت 613.25 مگابایت 571.64 مگابایت
همه آرشیوها: 1.63 گیگابایت 853.66 مگابایت 584.12 مگابایت

تکه های منحصر به فرد کل تکه ها
شاخص تکه: 36858 48844

بورگ استقرار (mount)

استفاده: borg mount [-h] [--critical] [--error] [--warning] [--info] [--debug]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--Remote-path PATH] [-f] [-o OPTIONS]
REPOSITORY_OR_ARCHIVE MOUNTPOINT

بایگانی یا یک مخزن کامل را به عنوان یک سیستم فایل FUSE قرار دهید

استدلال های موضعی:
REPOSITORY_OR_ARCHIVE
مخزن/بایگانی برای نصب
MOUNTPOINT محل نصب فایل سیستم

آرگومان های اختیاری:
-h ، - کمک کنید این پیام راهنما را نشان دهید و خارج شوید
-- کار انتقادی در سطح ورود به سیستم CRITICAL
-- error work on log level ERROR
- کار هشدار در سطح گزارش هشدار (پیش‌فرض)
--info، -v، --کلمه
روی اطلاعات سطح گزارش کار کنید
- کار اشکال زدایی در DEBUG سطح ورود
--lock-wait N منتظر قفل باشید، اما حداکثر. N ثانیه (پیش‌فرض: 1).
--show-rc نشان دادن/ورود کد بازگشتی (rc)
--no-files-cache کش ابرداده فایلی را که قبلاً برای آن استفاده شده بود بارگیری/به‌روزرسانی نکنید
شناسایی فایل های بدون تغییر
--umask M umask را روی M قرار دهید (محلی و راه دور، پیش‌فرض: 0077)
--remote-path PATH مسیر راه دور را روی قابل اجرا تنظیم کنید (پیش فرض: "borg")
-f، --پیش زمینه در پیش زمینه بمانید، شیطان سازی نکنید
-o OPTIONS گزینه های نصب اضافی

توضیحات:
این دستور یک بایگانی را به عنوان یک فایل سیستم FUSE نصب می کند. این می تواند برای مرور یک مفید باشد
بایگانی یا بازیابی فایل های فردی مگر اینکه --پیش زمینه به گزینه دستور داده می شود
در پس‌زمینه اجرا می‌شود تا زمانی که فایل سیستم باشد سوار شده.

مثال ها
$ borg mount /path/to/repo::root-2016-02-15 /tmp/mymountpoint
$ ls /tmp/mymountpoint
bin boot و غیره صفحه اصلی lib lib64 گم شده+ یافت شده رسانه mnt opt ​​root sbin srv tmp usr var
$ fusermount -u /tmp/mymountpoint

بورگ تغییر عبارت عبور

استفاده: بورگ تغییر-عبارت عبور [-h] [-- بحرانی] [--خطا] [--اخطار] [--اطلاعات]
[--debug] [--lock-wait N] [--show-rc]
[--no-files-cache] [--umask M]
[--راه دور راه دور]
[مخزن]

رمز عبور فایل کلید مخزن را تغییر دهید

استدلال های موضعی:
مخزن

آرگومان های اختیاری:
-h ، - کمک کنید این پیام راهنما را نشان دهید و خارج شوید
-- کار انتقادی در سطح ورود به سیستم CRITICAL
-- error work on log level ERROR
- کار هشدار در سطح گزارش هشدار (پیش‌فرض)
--info، -v، --کلمه
روی اطلاعات سطح گزارش کار کنید
- کار اشکال زدایی در DEBUG سطح ورود
--lock-wait N منتظر قفل باشید، اما حداکثر. N ثانیه (پیش‌فرض: 1).
--show-rc نشان دادن/ورود کد بازگشتی (rc)
--no-files-cache کش ابرداده فایلی را که قبلاً برای آن استفاده شده بود بارگیری/به‌روزرسانی نکنید
شناسایی فایل های بدون تغییر
--umask M umask را روی M قرار دهید (محلی و راه دور، پیش‌فرض: 0077)
--remote-path PATH مسیر راه دور را روی قابل اجرا تنظیم کنید (پیش فرض: "borg")

توضیحات:
فایل های کلیدی مورد استفاده برای رمزگذاری مخزن به صورت اختیاری با عبارت عبور محافظت می شوند. این
برای تغییر این عبارت عبور می توان از دستور استفاده کرد.

مثال ها
# یک مخزن حفاظت شده فایل کلیدی ایجاد کنید
$ borg init --encryption=keyfile -v /path/to/repo
راه اندازی مخزن در "/path/to/repo"
رمز عبور جدید را وارد کنید:
دوباره همان عبارت عبور را وارد کنید:
رمز عبور خود را به خاطر بسپارید. داده های شما بدون آن غیر قابل دسترس خواهد بود.
کلید "/root/.config/borg/keys/mnt_backup" ایجاد شد.
این کلید را ایمن نگه دارید. داده های شما بدون آن غیر قابل دسترس خواهد بود.
همگام سازی حافظه پنهان تکه ها...
بایگانی‌ها: 0، با Idx حافظه پنهان: 0، با Idx منسوخ شده: 0، بدون Idx حافظه پنهان: 0.
انجام شده است.

# رمز عبور فایل کلیدی را تغییر دهید
$ borg change-passphrase -v /path/to/repo
عبارت عبور کلید /root/.config/borg/keys/mnt_backup را وارد کنید:
رمز عبور جدید را وارد کنید:
دوباره همان عبارت عبور را وارد کنید:
رمز عبور خود را به خاطر بسپارید. داده های شما بدون آن غیر قابل دسترس خواهد بود.
کلید به روز شد

بورگ خدمت

استفاده: خدمات بورگ [-h] [-- بحرانی] [--خطا] [--اخطار] [--اطلاعات] [--اشکال‌زدایی]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--Remote-path PATH] [--restrict-to-path PATH]

در حالت سرور شروع کنید. این دستور معمولا به صورت دستی استفاده نمی شود.

آرگومان های اختیاری:
-h ، - کمک کنید این پیام راهنما را نشان دهید و خارج شوید
-- کار انتقادی در سطح ورود به سیستم CRITICAL
-- error work on log level ERROR
- کار هشدار در سطح گزارش هشدار (پیش‌فرض)
--info، -v، --کلمه
روی اطلاعات سطح گزارش کار کنید
- کار اشکال زدایی در DEBUG سطح ورود
--lock-wait N منتظر قفل باشید، اما حداکثر. N ثانیه (پیش‌فرض: 1).
--show-rc نشان دادن/ورود کد بازگشتی (rc)
--no-files-cache کش ابرداده فایلی را که قبلاً برای آن استفاده شده بود بارگیری/به‌روزرسانی نکنید
شناسایی فایل های بدون تغییر
--umask M umask را روی M قرار دهید (محلی و راه دور، پیش‌فرض: 0077)
--remote-path PATH مسیر راه دور را روی قابل اجرا تنظیم کنید (پیش فرض: "borg")
-- محدود به مسیر PATH
دسترسی مخزن به PATH را محدود کنید

توضیحات:
این دستور یک فرآیند سرور مخزن را شروع می کند. این دستور معمولا استفاده نمی شود
به صورت دستی

مثال ها
سرویس borg پشتیبانی ویژه ای از دستورات اجباری ssh دارد (نگاه کنید به کلیدهای مجاز مثال
زیر): تشخیص می دهد که از چنین دستور اجباری استفاده می کنید و مقدار the را استخراج می کند
-- محدود به مسیر گزینه ها). سپس فرمان اصلی را که از
مشتری، مطمئن می شود که آن نیز باشد بورگ خدمت و محدودیت(های) مسیر را همانطور که توسط ارائه شده است، اعمال کنید
فرمان اجباری به این ترتیب، سایر گزینه های ارائه شده توسط مشتری (مانند -- اطلاعات or --umask)
حفظ می شوند (و با دستور اجباری ثابت نمی شوند).

# اجازه دهید یک جفت کلید SSH فقط borg را اجرا کند و فقط به /path/to/repo دسترسی داشته باشد.
# از گزینه های کلیدی برای غیرفعال کردن عملکرد غیر ضروری و بالقوه خطرناک SSH استفاده کنید.
# این به ایمن کردن سیستم پشتیبان گیری از راه دور خودکار کمک می کند.
گربه دلار ~/.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[...]

بورگ UPGRADE

استفاده: ارتقاء borg [-h] [-- بحرانی] [--خطا] [--اخطار] [--اطلاعات] [--اشکال‌زدایی]
[--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
[--راه دور مسیر] [-p] [-n] [-i]
[مخزن]

یک مخزن را از نسخه قبلی ارتقا دهید

استدلال های موضعی:
مسیر REPOSITORY به مخزن که باید ارتقا یابد

آرگومان های اختیاری:
-h ، - کمک کنید این پیام راهنما را نشان دهید و خارج شوید
-- کار انتقادی در سطح ورود به سیستم CRITICAL
-- error work on log level ERROR
- کار هشدار در سطح گزارش هشدار (پیش‌فرض)
--info، -v، --کلمه
روی اطلاعات سطح گزارش کار کنید
- کار اشکال زدایی در DEBUG سطح ورود
--lock-wait N منتظر قفل باشید، اما حداکثر. N ثانیه (پیش‌فرض: 1).
--show-rc نشان دادن/ورود کد بازگشتی (rc)
--no-files-cache کش ابرداده فایلی را که قبلاً برای آن استفاده شده بود بارگیری/به‌روزرسانی نکنید
شناسایی فایل های بدون تغییر
--umask M umask را روی M قرار دهید (محلی و راه دور، پیش‌فرض: 0077)
--remote-path PATH مسیر راه دور را روی قابل اجرا تنظیم کنید (پیش فرض: "borg")
-p، --progress نمایش پیشرفت در حین ارتقای مخزن
-n، --dry-run مخزن را تغییر ندهید
-i، --inplace مخزن بازنویسی در محل، بدون هیچ شانسی برای رفتن
بازگشت به نسخه های قدیمی تر مخزن.

توضیحات:
یک مخزن Borg موجود را ارتقا دهید. این در حال حاضر از تبدیل یک اتاق زیر شیروانی پشتیبانی می کند
مخزن به Borg و همچنین در تبدیل Borg 0.xx به 1.0 کمک می کند.

در حال حاضر، فقط مخازن محلی را می توان ارتقا داد (مساله شماره 465).

رشته‌های جادویی در بخش‌های مخزن را تغییر می‌دهد تا با جادوی جدید Borg مطابقت داشته باشد
رشته های. فایل‌های کلیدی موجود در $ATTIC_KEYS_DIR یا ~/.attic/keys/ نیز تبدیل خواهد شد
و در $BORG_KEYS_DIR یا کپی شد ~/.config/borg/keys.

فایل‌های کش از $ATTIC_CACHE_DIR یا تبدیل می‌شوند ~/.cache/attic به $BORG_CACHE_DIR
or ~/.cache/borg، اما طرح کش بین Borg و Attic تغییر کرده است، بنابراین امکان پذیر است
اولین پشتیبان پس از تبدیل به دلیل همگام سازی مجدد حافظه نهان بیش از حد انتظار طول می کشد.

در صورت قطع شدن، ارتقا باید از سر گرفته شود، اگرچه همچنان در همه موارد تکرار می شود
بخش ها اگر می خواهید از صفر شروع کنید، استفاده کنید بورگ حذف کردن روی مخزن کپی شده به
مطمئن شوید که فایل های کش نیز حذف شده اند:
borg حذف borg

مگر اینکه --درجا مشخص شده است، فرآیند ارتقا ابتدا یک نسخه پشتیبان از آن ایجاد می کند
مخزن، در REPOSITORY.upgrade-DATETIME، با استفاده از پیوندهای سخت. این بیشتر از در طول می کشد
مکان ارتقا می یابد، اما بسیار ایمن تر است و اطلاعات پیشرفت را ارائه می دهد (برخلاف cp -ال).
هنگامی که از تبدیل راضی هستید، می توانید با خیال راحت نسخه پشتیبان را از بین ببرید.

اخطار: اجرای ارتقاء در محل، کپی فعلی را در نسخه های قدیمی غیرقابل استفاده می کند
نسخه، بدون هیچ راهی برای بازگشت به نسخه های قبلی. این می تواند به طور دائم به شما آسیب برساند
مخزن! Attic نمی تواند مخازن BORG را بخواند، زیرا رشته های جادویی تغییر کرده اند. شما
هشدار داده شده است.

مثال ها
# مخزن borg را به جدیدترین نسخه ارتقا دهید.
$ borg ارتقا -v /path/to/repo
ایجاد یک کپی لینک سخت در /path/to/repo.upgrade-2016-02-15-20:51:55
باز کردن مخزن اتاق زیر شیروانی با بورگ و تبدیل
هیچ فایل کلیدی برای مخزن یافت نشد
تبدیل فهرست مخزن /path/to/repo/index.0
تبدیل 1 بخش ...
تبدیل borg 0.xx به جریان بورگ
هیچ فایل کلیدی برای مخزن یافت نشد

متفرقه کمک

بورگ کمک الگوهای
الگوهای خروج از چهار سبک مجزا، fnmatch، shell، عبارات منظم و
پیشوندهای مسیر اگر به دنبال آن یک دونقطه (':') قرار گیرد، از دو کاراکتر اول یک الگو استفاده می شود
به عنوان انتخابگر سبک انتخاب سبک صریح زمانی ضروری است که یک سبک غیر پیش‌فرض باشد
دلخواه یا زمانی که الگوی مورد نظر با دو کاراکتر الفبایی و به دنبال آن a شروع می شود
روده بزرگ (یعنی aa:چیزی/*).

Fnmatch، انتخابگر fm:
این الگوها از گونه‌ای از نحو الگوی پوسته استفاده می‌کنند که «*» با هر تعداد مطابقت دارد
شخصیت ها، '؟' مطابقت با هر کاراکتر واحد، '[...]' مطابق با هر کاراکتر منفرد
مشخص شده، از جمله محدوده، و «[!...]» مطابق با هر کاراکتری که مشخص نشده است. برای
هدف از این الگوها، جداکننده مسیر (" برای ویندوز و "/" در سیستم های دیگر)
درمان خاصی نمی شود متا کاراکترها را برای تطابق واقعی در پرانتز بپیچید (یعنی
[؟] برای مطابقت با شخصیت تحت اللفظی ?). برای اینکه یک مسیر با یک الگو مطابقت داشته باشد، باید
کاملاً از ابتدا تا انتها مطابقت داشته باشد یا باید از ابتدا تا قبل از یک مسیر مطابقت داشته باشد
جدا کننده به جز مسیر ریشه، مسیرها هرگز به جداکننده مسیر زمانی ختم نمی شوند
تطبیق تلاش می شود. بنابراین، اگر یک الگوی داده شده به یک جداکننده مسیر ختم شود، یک '*' است
قبل از تلاش برای تطبیق اضافه شده است.

الگوهای به سبک پوسته، انتخابگر ش:
مانند الگوهای fnmatch اینها شبیه به الگوهای پوسته هستند. تفاوت این است که
الگو ممکن است شامل شود ** / برای تطبیق سطوح دایرکتوری صفر یا بیشتر، * برای تطبیق صفر
یا کاراکترهای دلخواه بیشتر به استثنای هر جداکننده مسیر.

عبارات منظم، انتخابگر دوباره:
عبارات منظم مشابه آنچه در Perl یافت می شود پشتیبانی می شود. برخلاف الگوهای صدفی
عبارات منظم برای مطابقت با مسیر کامل و هیچ گونه تطابق رشته فرعی لازم نیست
کافی است. اکیداً توصیه می‌شود که الگوها را به ابتدا ('^') لنگر بزنید
پایان ('$') یا هر دو. جداکننده های مسیر ('' برای ویندوز و '/' در سیستم های دیگر) در مسیرها
همیشه قبل از اعمال یک الگو به یک اسلش رو به جلو ('/') نرمال می شوند. معمولی
نحو عبارت در توضیح داده شده است پــایتــون مستندات برای la re واحد.

مسیر پیشوند، انتخابگر pp:
این سبک الگو برای مطابقت با کل زیرشاخه ها مفید است. الگو pp:/data/bar
کبریت /data/bar و همه چیز در آن

استثناها را می توان از طریق گزینه خط فرمان منتقل کرد -- استثناء کردن. هنگامی که از داخل استفاده می شود
پوسته الگوها باید نقل قول شوند تا از گسترش آنها محافظت شود.

La -- استثناء-از گزینه اجازه بارگیری الگوهای حذف را از یک فایل متنی با یک می دهد
الگوی در هر خط خطوط خالی یا با علامت عدد ('#') پس از حذف شروع می شوند
فضای خالی در هر دو طرف نادیده گرفته می شود. پیشوند انتخاب سبک اختیاری نیز پشتیبانی می شود
برای الگوهای بارگذاری شده از یک فایل با توجه به مسیرهای حذف فضای خالی با فضای خالی در
شروع یا پایان را فقط می توان با استفاده از عبارات منظم حذف کرد.

مثال:

# '/home/user/file.o' را حذف کنید اما '/home/user/file.odt' را حذف نکنید: $ borg create -e'
*
پشتیبان گیری .o' /

# '/home/user/junk' و '/home/user/subdir/junk' را حذف کنید اما # نه
'/home/user/importantjunk' یا '/etc/junk': $ borg create -e'/ خانه /
*
/جوانک پشتیبان/

# محتویات '/home/user/cache' را حذف کنید، اما نه خود دایرکتوری: $ borg create
-e /home/user/cache/ backup /

# فایل '/home/user/cache/important' است نه پشتیبان گیری شده: $ borg create -e
/home/user/cache/ backup //home/user/cache/important

# محتویات دایرکتوری ها در '/ صفحه اصلیوقتی نام آنها # به پایان می رسد پشتیبان گیری نمی شود
'.tmp' $ borg ایجاد --exclude 're:^/ خانه /[^/]+.tmp/' پشتیبان گیری /

# بارگیری موارد استثنا از فایل $ cat >exclude.txt < / خانه //جنس اوراق و شکسته * .tmp
fm:aa:چیزی/ پاسخ:^/ خانه /[^/].tmp/sh:/ خانه /
*
/.thumbnails EOF $ borg ایجاد --exclude-from exclude.txt پشتیبان /

اشکال زدایی دستورات

دستورات دیگری نیز وجود دارد (همه با "debug-" شروع می شوند) که همگی هستند نه مورد نظر برای
طبیعی استفاده کنید و بالقوه بسیار خطرناک در صورت استفاده نادرست

آنها برای بهبود قابلیت های اشکال زدایی بدون دسترسی مستقیم به سیستم وجود دارند، به عنوان مثال در مورد
شما تا به حال با یک نقص شدید مواجه شده اید. فقط در صورتی از آنها استفاده کنید که بدانید در حال انجام چه کاری هستید یا
اگر یک توسعه دهنده قابل اعتماد Borg به شما بگوید که چه کاری انجام دهید.

اضافی NOTES

در اینجا متفرقه است. یادداشت هایی در مورد موضوعاتی که ممکن است در استفاده با جزئیات کافی پوشش داده نشده باشند
بخش.

مورد پرچم ها
بورگ ایجاد -v -- لیست یک لیست کامل از تمام فایل ها، دایرکتوری ها و فایل های دیگر را خروجی می دهد
آیتم های سیستمی که در نظر گرفته بود (بدون توجه به اینکه آیا آنها تغییرات محتوا داشتند یا نه). برای هر
آیتم، یک پرچم تک حرفی را پیشوند می دهد که نوع و/یا وضعیت مورد را نشان می دهد.

اگر فقط به زیرمجموعه ای از آن خروجی علاقه دارید، می توانید به عنوان مثال ارائه دهید --filter=AME و
فقط فایل های معمولی با وضعیت A، M یا E را نشان می دهد (به زیر مراجعه کنید).

یک کاراکتر بزرگ نشان دهنده وضعیت یک فایل معمولی نسبت به "فایل ها" است.
حافظه پنهان (نه نسبت به مخزن -- اگر از کش فایل ها استفاده نشود این مشکل ایجاد می شود).
ابرداده در هر صورت ذخیره می شود و برای 'A' و 'M' نیز تکه های داده جدید ذخیره می شود. برای
«U» همه تکه‌های داده به تکه‌های موجود از قبل اشاره دارد.

· 'A' = فایل معمولی، اضافه شده (همچنین به a_status_oddity در سؤالات متداول مراجعه کنید)

· 'M' = فایل معمولی، اصلاح شده

· 'U' = فایل معمولی، بدون تغییر

· 'E' = فایل معمولی، هنگام دسترسی/خواندن خطایی رخ داده است این پرونده

حروف کوچک به معنای نوع فایلی غیر از یک فایل معمولی است که معمولاً borg است
ابرداده های خود را ذخیره می کند:

· 'd' = دایرکتوری

· 'b' = دستگاه مسدود کردن

· 'c' = دستگاه کاراکتر

· 'h' = فایل معمولی، پیوند سخت (به اینودهای قبلاً دیده شده)

· 's' = پیوند نمادین

· 'f' = fifo

سایر پرچم های مورد استفاده عبارتند از:

· 'i' = داده های پشتیبان از ورودی استاندارد خوانده شد (stdin)

· '-' = اجرا خشک، آیتم بود نه حمایت از

· "؟" = کد وضعیت موجود نیست (اگر این را می بینید، لطفاً یک گزارش اشکال ارسال کنید!)

--chunker-params
پارامترهای chunker بر نحوه برش فایل‌های ورودی به قطعات (تکه‌ها) تأثیر می‌گذارند
برای حذف مجدد در نظر گرفته شده است. آنها همچنین تأثیر زیادی در استفاده از منابع (رم و دیسک) دارند
فضا) به عنوان مقدار منابع مورد نیاز (همچنین) با مقدار کل تعیین می شود
تکه های موجود در مخزن (نگاه کنید به شاخص / انبارها حافظه استفاده برای جزئیات بیشتر).

--chunker-params=10,23,16,4095 منجر به حذف ریز دانه می شود و بزرگی ایجاد می کند
مقدار تکه ها و در نتیجه از منابع زیادی برای مدیریت آنها استفاده می کند. این خوب است برای
حجم داده نسبتاً کم است و اگر دستگاه مقدار رم و دیسک آزاد خوبی داشته باشد
فضا.

--chunker-params=19,23,21,4095 (پیش فرض) منجر به حذف درشت دانه و
مقدار بسیار کمتری از تکه ها ایجاد می کند و بنابراین از منابع کمتری استفاده می کند. این خوب است برای
حجم داده نسبتاً بزرگ و اگر دستگاه دارای مقدار نسبتاً کمی رم آزاد باشد و
فضای دیسک

اگر قبلاً آرشیوهایی را در یک مخزن ایجاد کرده اید و سپس پارامترهای chunker را تغییر داده اید،
این البته بر روی deduplication تأثیر می گذارد زیرا تکه ها به طور متفاوتی برش می شوند.

در بدترین حالت (همه فایل‌ها بزرگ هستند و در بین نسخه‌های پشتیبان لمس شده‌اند)، ذخیره می‌شود
تمام محتوا دوباره وارد مخزن شود.

معمولاً آنقدرها هم بد نیست:

· معمولاً اکثر فایل‌ها لمس نمی‌شوند، بنابراین فقط از تکه‌های قدیمی که قبلاً دارد دوباره استفاده می‌کند
در مخزن

· فایل‌های کوچک‌تر از اندازه کوچک‌تر (چه قدیمی و چه جدید) تنها یک تکه دارند
به هر حال، پس تکه های حاصل یکسان هستند و کپی کردن اعمال می شود

اگر پارامترهای chunker را برای ذخیره منابع برای مخزن موجودی که قبلاً مقداری دارد تغییر دهید
بایگانی پشتیبان، شما اثر افزایشی در طول زمان، زمانی که فایل های بیشتر و بیشتر را ببینید
دوباره لمس شده و با استفاده از اندازه بزرگتر ذخیره شده است و تمام ارجاعات به
تکه های کوچکتر قدیمی حذف شده اند (با حذف / هرس بایگانی ها).

اگر می خواهید تأثیر زیادی بر مصرف منابع داشته باشید، بهتر است کار جدیدی را شروع کنید
مخزن هنگام تغییر پارامترهای chunker.

برای جزئیات بیشتر، به chunker_details مراجعه کنید.

--خواندن-ویژه
گزینه --خواندن-ویژه برای نرمال، در سطح سیستم فایل (کامل یا.) در نظر گرفته نشده است
قسمتی بازگشتی) پشتیبان گیری. این گزینه را فقط در صورتی می دهید که بخواهید کاری انجام دهید
... ویژه -- و اگر فایل هایی را دستچین کرده اید که می خواهید با آنها برخورد کنید.

بورگ ایجاد --خواندن-ویژه تمام فایل ها را بدون انجام هیچ درمان خاصی باز می کند
با توجه به نوع فایل (تنها استثنا در اینجا دایرکتوری ها هستند: آنها برگشت داده می شوند
به). فقط تصور کنید اگر انجام دهید چه اتفاقی می افتد گربه نام فایل --- محتوایی که در آنجا خواهید دید
چیزی است که borg برای آن نام فایل پشتیبان تهیه می کند.

بنابراین، به عنوان مثال، پیوندهای نمادین دنبال می‌شوند، محتوای دستگاه مسدود می‌شود، لوله‌های نامگذاری می‌شوند
/ سوکت های دامنه یونیکس خوانده می شوند.

هنگام استفاده باید مراقب آنچه به عنوان نام فایل می‌دهید باشید --خواندن-ویژهبه عنوان مثال اگر
شما می دهید /dev/zero، پشتیبان شما هرگز خاتمه نمی یابد.

فراداده فایل های داده شده همانطور که بدون ذخیره می شود ذخیره می شود --خواندن-ویژه (مثلاً آن
نام، اندازه آن [ممکن است 0 باشد]، حالت آن، و غیره) - اما علاوه بر این، محتوا نیز خوانده می شود
از آن برای آن ذخیره خواهد شد.

بازیابی محتوای چنین فایل‌هایی در حال حاضر فقط یکبار از طریق پشتیبانی می‌شود --stdout
گزینه (و شما باید stdout را به جایی که باید برود هدایت کنید، شاید مستقیماً به یک
فایل دستگاه موجود به انتخاب شما یا غیر مستقیم از طریق dd).

مثال
تصور کنید چند عکس فوری از حجم های منطقی (LV) که می خواهید پشتیبان بگیرید تهیه کرده اید.

توجه:
برای برخی از سناریوها، این روش خوبی برای به دست آوردن سازگاری "مانند تصادف" است (من آن را می نامم
شبیه خرابی است زیرا همان چیزی است که اگر فقط دکمه ریست را فشار دهید یا
ماشین شما به طور ناگهانی و کاملاً خراب می شود). این بهتر از عدم انسجام است
به هیچ وجه و روش خوبی برای برخی موارد استفاده است، اما احتمالاً اگر دارید به اندازه کافی خوب نیست
پایگاه های داده در حال اجرا

سپس یک آرشیو پشتیبان از تمام این عکس های فوری ایجاد می کنید. فرآیند پشتیبان گیری a را مشاهده خواهد کرد
حالت "یخ زده" حجم های منطقی، در حالی که فرآیندها در حجم های اصلی کار می کنند
به تغییر داده های ذخیره شده در آنجا ادامه دهید.

شما همچنین خروجی را اضافه کنید lvdisplay به پشتیبان خود، بنابراین شما می توانید اندازه LV را در مورد ببینید
شما همیشه نیاز به بازسازی و بازیابی آنها دارید.

پس از تکمیل پشتیبان‌گیری، دوباره عکس‌های فوری را حذف می‌کنید.

$ # در اینجا عکس های فوری ایجاد کنید
$ lvdisplay > lvdisplay.txt
$ borg create --read-special /path/to/repo::arch lvdisplay.txt /dev/vg0/*-snapshot
$ # عکس های فوری را از اینجا حذف کنید

حال، بیایید ببینیم چگونه می توان برخی از LV ها را از چنین پشتیبان گیری بازیابی کرد.

$ borg استخراج /path/to/repo::arch lvdisplay.txt
$ # LV های خالی با اندازه های صحیح را در اینجا ایجاد کنید (به lvdisplay.txt نگاه کنید).
$ # ما فرض می کنیم که شما یک ریشه خالی و LV خانه ایجاد کرده اید و اکنون آن را بازنویسی کنید:
استخراج $ borg --stdout /path/to/repo::arch dev/vg0/root-snapshot > /dev/vg0/root
استخراج $ borg --stdout /path/to/repo::arch dev/vg0/home-snapshot > /dev/vg0/home

فقط ضمیمه حالت
یک مخزن را می توان «فقط ضمیمه» ساخت، به این معنی که بورگ هرگز بازنویسی یا بازنویسی نمی کند
داده های متعهد را حذف کنید این برای سناریوهایی مفید است که چندین ماشین به یک پشتیبان می‌دهند
سرور پشتیبان مرکزی با استفاده از بورگ خدمت، زیرا یک ماشین هک شده نمی تواند نسخه های پشتیبان را حذف کند
برای همیشه

برای فعال کردن حالت فقط ضمیمه، مخزن را ویرایش کنید پیکربندی فایل و یک خط اضافه کنید append_only=1
به [مخزن] بخش (یا در صورت وجود خط را ویرایش کنید).

در حالت فقط ضمیمه، Borg یک گزارش تراکنش در آن ایجاد می کند معاملات فایل، جایی که
هر خط یک تراکنش و یک مهر زمانی UTC است.

مثال
فرض کنید یک مهاجم از راه دور همه نسخه های پشتیبان را حذف کرده است، اما مخزن شما فقط در ضمیمه است.
حالت گزارش تراکنش در این وضعیت ممکن است به شکل زیر باشد:

تراکنش 1، زمان UTC 2016-03-31T15:53:27.383532
تراکنش 5، زمان UTC 2016-03-31T15:53:52.588922
تراکنش 11، زمان UTC 2016-03-31T15:54:23.887256
تراکنش 12، زمان UTC 2016-03-31T15:55:54.022540
تراکنش 13، زمان UTC 2016-03-31T15:55:55.472564

از لاگ های امنیتی خود نتیجه می گیرید که مهاجم در ساعت 15:54:00 دسترسی پیدا کرده است و همه موارد
پشتیبان‌گیری‌هایی که حذف شده یا با نسخه‌های پشتیبان به خطر افتاده جایگزین شده‌اند. از لاگ شما می دانید که
تراکنش های 11 به بعد به خطر افتاده است. توجه داشته باشید که شناسه تراکنش نام آن است
آخر پرونده در معامله به عنوان مثال، تراکنش 11 شامل فایل های 6 تا 11 می شود.

در یک حمله واقعی، احتمالاً می خواهید مخزن در معرض خطر را برای تجزیه و تحلیل دست نخورده نگه دارید
چیزی که مهاجم سعی کرد به آن برسد. همچنین ایده خوبی است که این کپی را برای هر موردی تهیه کنید
در طول بهبودی مشکلی پیش می آید. از آنجایی که بازیابی با حذف برخی از فایل ها انجام می شود، الف
کپی لینک سخت (cp -ال) کافی است.

اولین مرحله برای بازنشانی مخزن به تراکنش 5، آخرین مرحله بدون خطر
معامله، حذف است نکات.ن و index.N فایل های موجود در مخزن (این دو فایل
همیشه قابل مصرف هستند). در این مثال N برابر 13 است.

سپس تمام فایل های بخش را از دایرکتوری های بخش به داخل حذف یا منتقل کنید داده ها / شروع با
فایل 6:

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

این همه به آن است.

اشکالاتی
از آنجایی که داده ها فقط اضافه می شوند و هیچ چیز حذف نمی شود، دستوراتی مانند پروانه or حذف کردن آزاد نخواهد شد
فضای دیسک، آنها فقط داده ها را به عنوان حذف شده در یک تراکنش جدید برچسب گذاری می کنند.

توجه داشته باشید که با ویرایش می‌توانید بین عملیات عادی و فقط الحاقی به عقب و جلو بروید
فایل پیکربندی، "سفر یک طرفه" نیست.

بیشتر ملاحظات
حالت فقط الحاقی توسط ابزارهایی غیر از Borg رعایت نمی شود. rm هنوز روی
مخزن مطمئن شوید که ماشین‌های سرویس گیرنده پشتیبان فقط از طریق می‌توانند به مخزن دسترسی داشته باشند
بورگ خدمت.

اگر مخزن به طور موقت روی حالت عادی تنظیم شده باشد، اطمینان حاصل کنید که دسترسی از راه دور امکان پذیر نیست
حالت برای مثال هرس منظم.

حفاظت های بیشتری را می توان اجرا کرد، اما خارج از محدوده بورگس هستند. مثلا فایل
عکس های فوری یا بسته بندی سیستم بورگ خدمت برای تنظیم مجوزهای ویژه یا ACL بر روی داده های جدید
فایل های.

با استفاده از خدمات onworks.net از borgbackup آنلاین استفاده کنید