borg-config(1) borg backup tool borg-config(1)

borg-config - دریافت یا تنظیم مقادیر پیکربندی مخزن borg

borg [common options] config [options] [REPOSITORY] [NAME] [VALUE]

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

برای حذف کامل یک مقدار پیکربندی، از --delete استفاده کنید. برای فهرست کردن مقادیر فایل پیکربندی یا مقادیر پیش‌فرض، از --list استفاده کنید. برای دریافت یک کلید موجود، فقط نام کلید را ارسال کنید. برای تنظیم یک کلید، هم نام کلید و هم مقدار جدید را ارسال کنید. کلیدها را می‌توان در قالب "section.name" یا به سادگی "name" مشخص کرد؛ بخش (section) به طور پیش‌فرض به ترتیب برای پیکربندی‌های مخزن و حافظه پنهان برابر با "repository" و "cache" خواهد بود.

به‌طور پیش‌فرض، borg config فایل پیکربندی مخزن را دستکاری می‌کند. استفاده از --cache به جای آن فایل پیکربندی حافظه پنهان مخزن را ویرایش می‌کند.

برای گزینه‌های مشترک دستورات Borg به borg-common(1) مراجعه کنید.

مخزن برای پیکربندی
نام کلید پیکربندی
مقدار جدید برای کلید

دریافت و تنظیم مقادیر از حافظه پنهان مخزن
حذف کلید از فایل پیکربندی
فهرست کردن پیکربندی مخزن

توجه:

فایل‌های پیکربندی مخزن و حافظه پنهان از معدود بخش‌های مستقیماً قابل دستکاری یک مخزن هستند که نسخه‌بندی یا پشتیبان‌گیری نمی‌شوند، بنابراین هنگام اعمال تغییرات مراقب باشید!
# یافتن دایرکتوری حافظه پنهان
$ cd ~/.cache/borg/$(borg config /path/to/repo id)
# رزرو مقداری فضا
$ borg config /path/to/repo additional_free_space 2G
# تبدیل مخزن به حالت فقط‌افزودنی (append-only)
$ borg config /path/to/repo append_only 1
# تنظیم سهمیه ذخیره‌سازی به 50 گیگابایت
$ borg config /path/to/repo storage_quota 50G
# تنظیم حداکثر اندازه قطعه به 100 مبی‌بایت (به "Adjusting segment size" در نکات استفاده مراجعه کنید)
$ borg config /path/to/repo max_segment_size 104857600

borg-common(1)

The Borg Collective

2026-07-18