'\" t
.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "rclone" "1" "Sep 04, 2026" "User Manual" ""
.hy
.SH "نام (NAME)"
.PP
rclone \- مدیریت فایل‌ها در فضای ذخیره‌سازی ابری
.SH "خلاصه دستور (SYNOPSIS)"
.IP
.nf
\f[C]
نحوه استفاده:
  rclone [flags]
  rclone [command]

دستورهای در دسترس:
  about       دریافت اطلاعات سهمیه مصرفی از ریموت.
  archive     انجام یک عملیات روی بایگانی.
  authorize   احراز هویت ریموت.
  backend     اجرای یک دستور مختص به بک‌اند.
  bisync      انجام همگام‌سازی دوطرفه میان دو مسیر.
  cat         الحاق فایل‌ها و ارسال آن‌ها به stdout.
  check       بررسی تطابق فایل‌ها در مبدأ و مقصد.
  checksum    بررسی فایل‌های مقصد در برابر یک فایل SUM.
  cleanup     پاک‌سازی ریموت در صورت امکان.
  completion  تولید اسکریپت تکمیل خودکار برای شل مشخص‌شده.
  config      ورود به نشست پیکربندی تعاملی.
  convmv      تبدیل درجا نام فایل‌ها و دایرکتوری‌ها.
  copy        کپی فایل‌ها از مبدأ به مقصد، با نادیده گرفتن فایل‌های یکسان.
  copyto      کپی فایل‌ها از مبدأ به مقصد، با نادیده گرفتن فایل‌های یکسان.
  copyurl     کپی محتوای URL داده‌شده به dest:path.
  cryptcheck  بررسی یکپارچگی یک ریموت رمزگذاری‌شده.
  cryptdecode بازگرداندن نام‌های فایل رمزگذاری‌نشده.
  dedupe      یافتن تعاملی فایل‌های هم‌نام تکراری و حذف یا تغییر نام آن‌ها.
  delete      حذف فایل‌های موجود در مسیر.
  deletefile  حذف یک تک‌فایل از ریموت.
  gendocs     تولید مستندات markdown برای rclone در دایرکتوری مشخص‌شده.
  gitannex    ارتباط با git-annex از طریق stdin/stdout.
  gui         باز کردن رابط گرافیکی تحت وب.
  hashsum     تولید یک فایل hashsum برای تمام اشیاء در مسیر.
  help        نمایش راهنما برای دستورها، پرچم‌ها و بک‌اندهای rclone.
  link        تولید پیوند عمومی برای فایل یا پوشه.
  listremotes فهرست کردن تمام ریموت‌ها در فایل کانفیگ و متغیرهای محیطی.
  ls          فهرست کردن اشیاء در مسیر همراه با اندازه و مسیر.
  lsd         فهرست کردن تمام دایرکتوری‌ها/کانتینرها/باکت‌ها در مسیر.
  lsf         فهرست کردن دایرکتوری‌ها و اشیاء در remote:path در قالبی مناسب پارس کردن.
  lsjson      فهرست کردن دایرکتوری‌ها و اشیاء در مسیر در قالب JSON.
  lsl         فهرست کردن اشیاء در مسیر با زمان تغییر، اندازه و مسیر.
  md5sum      تولید یک فایل md5sum برای تمام اشیاء در مسیر.
  mkdir       ایجاد مسیر در صورتی که از قبل وجود نداشته باشد.
  mount       مونت کردن ریموت به عنوان فایل‌سیستم در یک نقطه مونت.
  move        انتقال فایل‌ها از مبدأ به مقصد.
  moveto      انتقال فایل یا دایرکتوری از مبدأ به مقصد.
  ncdu        کاوش در ریموت با یک رابط کاربری متنی.
  nfsmount    مونت کردن ریموت به عنوان فایل‌سیستم در یک نقطه مونت.
  obscure     مبهم‌سازی گذرواژه برای استفاده در فایل کانفیگ rclone.
  purge       حذف مسیر و تمام محتویات آن.
  rc          اجرای یک دستور روی یک rclone در حال اجرا.
  rcat        کپی ورودی استاندارد به فایلی در ریموت.
  rcd         اجرای rclone صرفاً در حالت شنود دستورهای کنترل از راه دور.
  rmdir       حذف دایرکتوری خالی در مسیر.
  rmdirs      حذف دایرکتوری‌های خالی زیر مسیر مشخص‌شده.
  selfupdate  به‌روزرسانی باینری rclone.
  serve       ارائه یک ریموت روی یک پروتکل ارتباطی.
  settier     تغییر کلاس یا سطح (tier) ذخیره‌سازی اشیاء در ریموت.
  sha1sum     تولید یک فایل sha1sum برای تمام اشیاء در مسیر.
  size        چاپ اندازه کل و تعداد اشیاء در remote:path.
  sync        یکسان‌سازی مبدأ و مقصد، فقط با اعمال تغییرات در مقصد.
  test        اجرای یک دستور آزمایشی.
  touch       ایجاد فایل جدید یا به‌روزرسانی زمان دستکاری فایل.
  tree        فهرست کردن محتویات ریموت با ساختاری درخت‌گونه.
  version     نمایش شماره نسخه.

برای اطلاعات بیشتر درباره هر دستور، از \[dq]rclone [command] --help\[dq] استفاده کنید.
برای مشاهده پرچم‌های عمومی، از \[dq]rclone help flags\[dq] استفاده کنید.
برای دیدن فهرست سرویس‌های پشتیبانی‌شده، از \[dq]rclone help backends\[dq] استفاده کنید.
\f[R]
.fi.SH "Rclone فایل‌های شما را با فضای ذخیره‌سازی ابری همگام می‌کند"
.PP
.IP \[bu] 2
درباره rclone
.IP \[bu] 2
rclone چه کارهایی می‌تواند برای شما انجام دهد؟
.IP \[bu] 2
rclone چه قابلیت‌هایی دارد؟
.IP \[bu] 2
rclone از چه ارائه‌دهندگانی پشتیبانی می‌کند؟
.IP \[bu] 2
بارگیری (https://rclone.org/downloads)
.IP \[bu] 2
نصب (https://rclone.org/install)
.IP \[bu] 2
حمایت مالی (https://rclone.org/donate)
.SS "درباره rclone"
.PP
Rclone یک برنامه خط فرمانی برای مدیریت فایل‌ها در فضای ذخیره‌سازی ابری است.
این ابزار جایگزینی غنی از امکانات برای رابط‌های وب ذخیره‌سازی ارائه‌دهندگان ابری است.
بیش از ۷۰ محصول ذخیره‌سازی ابری از rclone پشتیبانی می‌کنند؛ از جمله مخازن شیء S3، سرویس‌های ذخیره‌سازی فایل تجاری و مصرفی، و همچنین پروتکل‌های استاندارد انتقال.
.PP
Rclone معادل‌های ابری قدرتمندی برای دستورهای یونیکس rsync، cp، mv، mount، ls، ncdu، tree، rm و cat دارد.
سینتکس آشنای rclone شامل پشتیبانی از خط‌لوله‌های شل (pipeline) و حفاظت به وسیله \f[V]--dry-run\f[R] است.
از آن در خط فرمان، در اسکریپت‌ها یا از طریق API استفاده می‌شود.
.PP
کاربران rclone را \f[I]\[dq]چاقوی سوئیسی ذخیره‌سازی ابری\[dq]\f[R] و \f[I]\[dq]فناوری غیرقابل تمایز از جادو\[dq]\f[R] می‌نامند.
.PP
Rclone واقعاً مراقب داده‌های شماست.
این ابزار همیشه برچسب‌های زمانی را حفظ کرده و مجموع مقابله‌ای (checksum) را بررسی می‌کند.
انتقال‌ها روی پهنای باند محدود، اتصالات ناپایدار، یا مشمول سهمیه مصرف را می‌توان از آخرین فایل منتقل‌شده سالم از سر گرفت.
شما می‌توانید یکپارچگی فایل‌های خود را بررسی (https://rclone.org/commands/rclone_check) کنید.
در صورت امکان، rclone از انتقال‌های سمت سرور برای به حداقل رساندن مصرف پهنای باند محلی و انتقال از یک ارائه‌دهنده به ارائه‌دهنده دیگر بدون استفاده از دیسک محلی بهره می‌برد.
.PP
بک‌اندهای مجازی، سیستم‌های فایل محلی و ابری را برای اعمال
رمزنگاری (https://rclone.org/crypt)،
فشرده‌سازی (https://rclone.org/compress)،
تکه‌تکه‌سازی (https://rclone.org/chunker)،
هش‌کردن (https://rclone.org/hasher) و
پیوند دادن (https://rclone.org/union)
در بر می‌گیرند.
.PP
Rclone هر سیستم فایل محلی، ابری یا مجازی را به عنوان یک دیسک در Windows، macOS، Linux و FreeBSD سوار می‌کند (mount (https://rclone.org/commands/rclone_mount)) و همچنین آن‌ها را از طریق
SFTP (https://rclone.org/commands/rclone_serve_sftp)،
HTTP (https://rclone.org/commands/rclone_serve_http)،
WebDAV (https://rclone.org/commands/rclone_serve_webdav)،
FTP (https://rclone.org/commands/rclone_serve_ftp) و
DLNA (https://rclone.org/commands/rclone_serve_dlna)
ارائه می‌دهد.
.PP
Rclone یک نرم‌افزار بالغ و متن‌باز است که در ابتدا با الهام از rsync ساخته شده و به زبان Go (https://golang.org) نوشته شده است.
جامعه پشتیبانی صمیمی آن با سناریوهای کاربری گوناگون آشنایی دارد.
مخازن رسمی Ubuntu، Debian، Fedora، Brew و Chocolatey شامل rclone هستند.
برای دریافت آخرین نسخه، بارگیری از
rclone.org (https://rclone.org/downloads) توصیه می‌شود.
.PP
Rclone به‌طور گسترده در Linux، Windows و Mac استفاده می‌شود.
توسعه‌دهندگان شخص ثالث راهکارهای نوآورانه‌ای برای پشتیبان‌گیری، بازیابی، واسط کاربری گرافیکی (GUI) و فرآیندهای تجاری با استفاده از خط فرمان یا API ابزار rclone ایجاد می‌کنند.
.PP
Rclone وظیفه سنگین ارتباط با فضای ذخیره‌سازی ابری را به دوش می‌کشد.
.SS "rclone چه کارهایی می‌تواند برای شما انجام دهد؟"
.PP
Rclone به شما کمک می‌کند تا:
.IP \[bu] 2
از فایل‌ها در فضای ذخیره‌سازی ابری پشتیبان‌گیری (و آن‌ها را رمزنگاری) کنید
.IP \[bu] 2
فایل‌ها را از فضای ذخیره‌سازی ابری بازیابی (و رمزگشایی) کنید
.IP \[bu] 2
داده‌های ابری را در سایر سرویس‌های ابری یا به‌صورت محلی آینه‌سازی (mirror) کنید
.IP \[bu] 2
داده‌ها را به فضای ابری، یا میان ارائه‌دهندگان ذخیره‌سازی ابری مختلف مهاجرت دهید
.IP \[bu] 2
چندین فضای ذخیره‌سازی ابری رمزنگاری‌شده، کش‌شده یا متنوع را به عنوان یک دیسک سوار (mount) کنید
.IP \[bu] 2
داده‌های نگهداری‌شده در فضای ذخیره‌سازی ابری را با استفاده از
lsf (https://rclone.org/commands/rclone_lsf)،
ljson (https://rclone.org/commands/rclone_lsjson)،
size (https://rclone.org/commands/rclone_size) و
ncdu (https://rclone.org/commands/rclone_ncdu)
تحلیل و ارزیابی کنید
.IP \[bu] 2
سیستم‌های فایل را با یکدیگر متحد (Union (https://rclone.org/union)) کنید تا چندین سیستم فایل محلی و/یا ابری را به‌صورت یکپارچه نمایش دهید.SS "ویژگی‌ها (Features)"
.IP \[bu] 2
انتقال‌ها
.RS 2
.IP \[bu] 2
هش‌های MD5 و SHA1 همواره جهت بررسی یکپارچگی فایل‌ها بررسی می‌شوند
.IP \[bu] 2
برچسب‌های زمانی (Timestamps) روی فایل‌ها حفظ می‌شوند
.IP \[bu] 2
عملیات در هر زمانی می‌تواند از سر گرفته شود
.IP \[bu] 2
امکان انتقال از و به شبکه، برای مثال
بین دو ارائه‌دهنده ابری مختلف
.IP \[bu] 2
امکان استفاده از دریافت‌های چندرشته‌ای به دیسک محلی
.RE
.IP \[bu] 2
Copy (https://rclone.org/commands/rclone_copy) جهت کپی فایل‌های جدید یا تغییریافته به
فضای ذخیره‌سازی ابری
.IP \[bu] 2
Sync (https://rclone.org/commands/rclone_sync) (یک‌طرفه) جهت یکسان‌سازی کامل یک
دایرکتوری
.IP \[bu] 2
Bisync (https://rclone.org/bisync) (دوطرفه) جهت همگام نگه‌داشتن دو دایرکتوری به‌صورت
دوطرفه
.IP \[bu] 2
Move (https://rclone.org/commands/rclone_move) جهت انتقال فایل‌ها به فضای ذخیره‌سازی ابری و
حذف نسخه محلی پس از اعتبارسنجی
.IP \[bu] 2
Check (https://rclone.org/commands/rclone_check) جهت بررسی هش‌ها و شناسایی
فایل‌های مفقود یا اضافی
.IP \[bu] 2
Mount (https://rclone.org/commands/rclone_mount) جهت سوار کردن فضای ذخیره‌سازی ابری به
عنوان یک دیسک شبکه
.IP \[bu] 2
Serve (https://rclone.org/commands/rclone_serve) جهت ارائه فایل‌های محلی یا از راه دور از
طریق
HTTP (https://rclone.org/commands/rclone_serve_http)/WebDav (https://rclone.org/commands/rclone_serve_webdav)/FTP (https://rclone.org/commands/rclone_serve_ftp)/SFTP (https://rclone.org/commands/rclone_serve_sftp)/DLNA (https://rclone.org/commands/rclone_serve_dlna)
.IP \[bu] 2
رابط گرافیکی کاربر (GUI) تحت وب آزمایشی (https://rclone.org/gui)
.SS "ارائه‌دهندگان پشتیبانی‌شده (Supported providers)"
.PP
(موارد بسیار دیگری نیز وجود دارند که بر پایه پروتکل‌های استانداردی نظیر WebDAV یا
S3 ساخته شده‌اند و بدون نیاز به تنظیمات اضافی کار می‌کنند.)
.IP \[bu] 2
1Fichier
.IP \[bu] 2
Akamai Netstorage
.IP \[bu] 2
Alibaba Cloud (Aliyun) Object Storage System (OSS)
.IP \[bu] 2
Amazon S3
.IP \[bu] 2
Bizfly Cloud Simple Storage
.IP \[bu] 2
Backblaze B2
.IP \[bu] 2
Box
.IP \[bu] 2
Ceph
.IP \[bu] 2
China Mobile Ecloud Elastic Object Storage (EOS)
.IP \[bu] 2
Arvan Cloud Object Storage (AOS)
.IP \[bu] 2
Citrix ShareFile
.IP \[bu] 2
Cloudflare R2
.IP \[bu] 2
Cloudinary
.IP \[bu] 2
Cubbit DS3
.IP \[bu] 2
DigitalOcean Spaces
.IP \[bu] 2
Digi Storage
.IP \[bu] 2
Dreamhost
.IP \[bu] 2
Drime
.IP \[bu] 2
Dropbox
.IP \[bu] 2
Enterprise File Fabric
.IP \[bu] 2
Exaba
.IP \[bu] 2
Fastly Object Storage
.IP \[bu] 2
Fastmail Files
.IP \[bu] 2
FileLu Cloud Storage
.IP \[bu] 2
FileLu S5 (S3-Compatible Object Storage)
.IP \[bu] 2
Filen
.IP \[bu] 2
Files.com
.IP \[bu] 2
FlashBlade
.IP \[bu] 2
FTP
.IP \[bu] 2
Gofile
.IP \[bu] 2
Google Cloud Storage
.IP \[bu] 2
Google Drive
.IP \[bu] 2
Google Photos
.IP \[bu] 2
HDFS
.IP \[bu] 2
Hetzner Object Storage
.IP \[bu] 2
Hetzner Storage Box
.IP \[bu] 2
HiDrive
.IP \[bu] 2
Hitachi Content Platform (HCP)
.IP \[bu] 2
HTTP
.IP \[bu] 2
Huawei Drive
.IP \[bu] 2
Huawei OBS
.IP \[bu] 2
iCloud Drive
.IP \[bu] 2
ImageKit
.IP \[bu] 2
Internet Archive
.IP \[bu] 2
Internxt
.IP \[bu] 2
Jottacloud
.IP \[bu] 2
IBM COS S3
.IP \[bu] 2
IDrive e2
.IP \[bu] 2
Impossible Cloud
.IP \[bu] 2
Intercolo Object Storage
.IP \[bu] 2
IONOS Cloud
.IP \[bu] 2
Koofr
.IP \[bu] 2
Leviia Object Storage
.IP \[bu] 2
Liara Object Storage
.IP \[bu] 2
Linkbox
.IP \[bu] 2
Linode Object Storage
.IP \[bu] 2
Magalu
.IP \[bu] 2
Mail.ru Cloud
.IP \[bu] 2
Memset Memstore
.IP \[bu] 2
MEGA
.IP \[bu] 2
MEGA S4
.IP \[bu] 2
Memory
.IP \[bu] 2
Microsoft Azure Blob Storage
.IP \[bu] 2
Microsoft Azure Files Storage
.IP \[bu] 2
Microsoft OneDrive
.IP \[bu] 2
Minio
.IP \[bu] 2
Nextcloud
.IP \[bu] 2
Blomp Cloud Storage.IP \[bu] 2
OpenDrive
.IP \[bu] 2
OpenStack Swift
.IP \[bu] 2
Oracle Cloud Storage Swift
.IP \[bu] 2
Oracle Object Storage
.IP \[bu] 2
Outscale
.IP \[bu] 2
OVHcloud Object Storage (Swift)
.IP \[bu] 2
OVHcloud Object Storage (سازگار با S3)
.IP \[bu] 2
ownCloud
.IP \[bu] 2
pCloud
.IP \[bu] 2
Petabox
.IP \[bu] 2
PikPak
.IP \[bu] 2
Pixeldrain
.IP \[bu] 2
premiumize.me
.IP \[bu] 2
put.io
.IP \[bu] 2
Proton Drive
.IP \[bu] 2
QingStor
.IP \[bu] 2
Qiniu Cloud Object Storage (Kodo)
.IP \[bu] 2
Quatrix by Maytech
.IP \[bu] 2
Rabata Cloud Storage
.IP \[bu] 2
RackCorp Object Storage
.IP \[bu] 2
Rackspace Cloud Files
.IP \[bu] 2
Rclone Serve S3
.IP \[bu] 2
rsync.net
.IP \[bu] 2
Scaleway
.IP \[bu] 2
Scality (RING / ARTESCA)
.IP \[bu] 2
Seafile
.IP \[bu] 2
Seagate Lyve Cloud
.IP \[bu] 2
SeaweedFS
.IP \[bu] 2
Selectel
.IP \[bu] 2
Servercore Object Storage
.IP \[bu] 2
SFTP
.IP \[bu] 2
Shade
.IP \[bu] 2
Sia
.IP \[bu] 2
SMB / CIFS
.IP \[bu] 2
Spectra Logic
.IP \[bu] 2
Storj
.IP \[bu] 2
Synology
.IP \[bu] 2
SugarSync
.IP \[bu] 2
Tencent Cloud Object Storage (COS)
.IP \[bu] 2
Uloz.to
.IP \[bu] 2
US3
.IP \[bu] 2
Wasabi
.IP \[bu] 2
WebDAV
.IP \[bu] 2
Yandex Disk
.IP \[bu] 2
Zadara Object Storage
.IP \[bu] 2
Zero Services (ZERO-Z3)
.IP \[bu] 2
Zoho WorkDrive
.IP \[bu] 2
Zata
.IP \[bu] 2
سیستم‌فایل محلی.SS ارائه‌دهندگان مجازی
.PP
این بک‌اندها دیگر ارائه‌دهندگان ذخیره‌سازی را تطبیق داده یا تغییر می‌دهند:
.IP \[bu] 2
Alias: تغییر نام ریموت‌های موجود
.IP \[bu] 2
Archive: خواندن فایل‌های آرشیو
.IP \[bu] 2
Cache: کش کردن ریموت‌ها (منسوخ‌شده)
.IP \[bu] 2
Chunker: تقسیم فایل‌های بزرگ
.IP \[bu] 2
Combine: ترکیب چندین ریموت در یک درخت دایرکتوری
.IP \[bu] 2
Compress: فشرده‌سازی فایل‌ها
.IP \[bu] 2
Crypt: رمزگذاری فایل‌ها
.IP \[bu] 2
Hasher: محاسبه هش فایل‌ها
.IP \[bu] 2
Union: متصل کردن چندین ریموت به یکدیگر برای کار هماهنگ
.SS پیوندها
.IP \[bu] 2
صفحه اصلی (https://rclone.org)
.IP \[bu] 2
صفحه پروژه گیت‌هاب برای کد منبع و سیستم ردیابی باگ (https://github.com/rclone/rclone)
.IP \[bu] 2
انجمن گفتگو Rclone (https://forum.rclone.org)
.IP \[bu] 2
بارگیری‌ها (https://rclone.org/downloads)
.SH "نصب (INSTALL)"
.PP
برنامه Rclone با زبان Go توسعه یافته و به صورت یک فایل باینری منفرد عرضه می‌شود.
.SS شروع سریع
.IP \[bu] 2
فایل باینری مربوطه را بارگیری کنید (https://rclone.org/downloads).
.IP \[bu] 2
فایل اجرایی \f[V]rclone\f[R] (یا \f[V]rclone.exe\f[R] در ویندوز) را از فایل فشرده استخراج کنید.
.IP \[bu] 2
برای راه‌اندازی، دستور \f[V]rclone config\f[R] را اجرا کنید.
جهت جزئیات بیشتر مستندات rclone config را ببینید (https://rclone.org/docs).
.IP \[bu] 2
به صورت اختیاری، اجرای خودکار را پیکربندی نمایید.
.PP
برای توضیحات جامع‌تر مربوط به لینوکس / macOS / ویندوز به ادامه مطلب مراجعه کنید.
.PP
برای چگونگی استفاده از rclone مستندات کاربرد (https://rclone.org/docs) را ببینید، یا دستور \f[V]rclone -h\f[R] را اجرا کنید.
.PP
نسخه نصب‌شده rclone را می‌توان با استفاده از دستور
rclone selfupdate به‌راحتی به آخرین نسخه به‌روزرسانی کرد (https://rclone.org/commands/rclone_selfupdate).
.PP
برای نحوه تأیید امضاهای نسخه منتشرشده، مستندات امضای انتشار (https://rclone.org/release_signing) را ببینید.
.SS نصب از طریق اسکریپت
.PP
برای نصب rclone بر روی سیستم‌های Linux/macOS/BSD، دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
sudo -v ; curl https://rclone.org/install.sh | sudo bash
\f[R]
.fi
.PP
برای نصب نسخه آزمایشی (beta)، دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
sudo -v ; curl https://rclone.org/install.sh | sudo bash -s beta
\f[R]
.fi
.PP
توجه داشته باشید که این اسکریپت ابتدا نسخه نصب‌شده rclone را بررسی می‌کند و در صورت عدم نیاز، مجدداً بارگیری نخواهد کرد.
.SS نصب در لینوکس
.SS باینری از پیش کامپایل‌شده
.PP
دریافت و استخراج
.IP
.nf
\f[C]
curl -O https://downloads.rclone.org/rclone-current-linux-amd64.zip
unzip rclone-current-linux-amd64.zip
cd rclone-*-linux-amd64
\f[R]
.fi
.PP
کپی کردن فایل باینری
.IP
.nf
\f[C]
sudo cp rclone /usr/bin/
sudo chown root:root /usr/bin/rclone
sudo chmod 755 /usr/bin/rclone
\f[R]
.fi
.PP
نصب صفحه راهنما (manpage)
.IP
.nf
\f[C]
sudo mkdir -p /usr/local/share/man/man1
sudo cp rclone.1 /usr/local/share/man/man1/
sudo mandb
\f[R]
.fi
.PP
دستور \f[V]rclone config\f[R] را برای راه‌اندازی اجرا کنید.
جهت جزئیات بیشتر مستندات rclone config را ببینید (https://rclone.org/docs).
.IP
.nf
\f[C]
rclone config
\f[R]
.fi.SS نصب در macOS
.SS نصب با brew
.IP
.nf
\f[C]
brew install rclone
\f[R]
.fi
.PP
نکته: این نسخه از rclone دیگر از \f[V]mount\f[R] پشتیبانی نخواهد کرد
(ببینید: #5373 (https://github.com/rclone/rclone/issues/5373)).
اگر در macOS به سوار کردن (mount) نیاز دارید، یا یک باینری از پیش‌کامپایل‌شده را نصب کنید
یا هنگام نصب از سورس‌کد، گزینهٔ مربوطه را فعال نمایید.
.PP
توجه داشته باشید که این یک نصاب شخص ثالث است و توسط توسعه‌دهندگان rclone
مدیریت نمی‌شود، بنابراین ممکن است قدیمی باشد.
نسخهٔ فعلی آن مطابق زیر است.
.PP
[تصویر: بستهٔ
Homebrew (https://repology.org/badge/version-for-repo/homebrew/rclone.svg)] (https://repology.org/project/rclone/versions)
.SS نصب با MacPorts
.PP
در macOS، برنامهٔ rclone همچنین می‌تواند از طریق
MacPorts (https://www.macports.org) نصب شود:
.IP
.nf
\f[C]
sudo port install rclone
\f[R]
.fi
.PP
توجه داشته باشید که این یک نصاب شخص ثالث است و توسط توسعه‌دهندگان rclone
مدیریت نمی‌شود، بنابراین ممکن است قدیمی باشد.
نسخهٔ فعلی آن مطابق زیر است.
.PP
[تصویر: پورت
MacPorts (https://repology.org/badge/version-for-repo/macports/rclone.svg)] (https://repology.org/project/rclone/versions)
.PP
اطلاعات بیشتر در
macports.org (https://ports.macports.org/port/rclone).
.SS باینری از پیش‌کامپایل‌شده، با استفاده از curl
.PP
برای جلوگیری از بروز مشکل با macOS Gatekeeper که الزام به امضا
و تایید رسمی (notarize) باینری دارد، کافی است دانلود با \f[V]curl\f[R] انجام شود.
.PP
آخرین نسخهٔ rclone را دانلود کنید.
.IP
.nf
\f[C]
cd && curl -O https://downloads.rclone.org/rclone-current-osx-amd64.zip
\f[R]
.fi
.PP
فایل دانلودشده را از حالت فشرده خارج کرده و به پوشهٔ استخراج‌شده بروید.
.IP
.nf
\f[C]
unzip -a rclone-current-osx-amd64.zip && cd rclone-*-osx-amd64
\f[R]
.fi
.PP
فایل rclone را به مسیر $PATH خود منتقل کنید.
گذرواژهٔ شما پرسیده خواهد شد.
.IP
.nf
\f[C]
sudo mkdir -p /usr/local/bin
sudo mv rclone /usr/local/bin/
\f[R]
.fi
.PP
(اجرای دستور \f[V]mkdir\f[R] ایمن است، حتی اگر دایرکتوری
از قبل وجود داشته باشد).
.PP
فایل‌های باقی‌مانده را حذف کنید.
.IP
.nf
\f[C]
cd .. && rm -rf rclone-*-osx-amd64 rclone-current-osx-amd64.zip
\f[R]
.fi
.PP
برای راه‌اندازی، دستور \f[V]rclone config\f[R] را اجرا کنید.
برای جزئیات بیشتر به مستندات rclone config (https://rclone.org/docs) مراجعه نمایید.
.IP
.nf
\f[C]
rclone config
\f[R]
.fi.SS باینری پیش‌کامپایل‌شده با استفاده از مرورگر وب
.PP
هنگام بارگیری یک فایل باینری با مرورگر وب، مرورگر صفت قرنطینه (quarantine) مربوط به gatekeeper در macOS را تنظیم می‌کند.
از نسخه Catalina به بعد، هنگام تلاش برای اجرای \f[V]rclone\f[R]، پنجره‌ای با این پیام باز خواهد شد:
.IP
.nf
\f[C]
\[dq]rclone\[dq] نمی‌تواند باز شود زیرا توسعه‌دهنده آن تأیید نشده است.
macOS نمی‌تواند تأیید کند که این برنامه عاری از بدافزار است.
\f[R]
.fi
.PP
ساده‌ترین راهکار اجرای این دستور است:
.IP
.nf
\f[C]
xattr -d com.apple.quarantine rclone
\f[R]
.fi
.SS نصب در ویندوز
.SS باینری پیش‌کامپایل‌شده
.PP
با کلیک بر روی این پیوندها، باینری متناسب با نوع پردازنده خود را دریافت کنید.
اگر مطمئن نیستید، از اولین پیوند استفاده کنید.
.IP \[bu] 2
Intel/AMD \- ۶۴
بیتی (https://downloads.rclone.org/rclone-current-windows-amd64.zip)
.IP \[bu] 2
Intel/AMD \- ۳۲
بیتی (https://downloads.rclone.org/rclone-current-windows-386.zip)
.IP \[bu] 2
ARM \- ۶۴
بیتی (https://downloads.rclone.org/rclone-current-windows-arm64.zip)
.PP
این فایل را در Explorer باز کرده و \f[V]rclone.exe\f[R] را استخراج کنید.
برنامه rclone یک فایل اجرایی پرتابل است، بنابراین می‌توانید آن را در هر
مکانی که مناسب است قرار دهید.
.PP
یک پنجره CMD (یا powershell) باز کرده و فایل باینری را اجرا کنید.
توجه داشته باشید که rclone به طور پیش‌فرض رابط گرافیکی (GUI) اجرا نمی‌کند،
بلکه در پنجره CMD اجرا می‌شود.
.IP \[bu] 2
برای راه‌اندازی، \f[V]rclone.exe config\f[R] را اجرا کنید.
برای جزئیات بیشتر، مستندات پیکربندی rclone (https://rclone.org/docs) را ببینید.
.IP \[bu] 2
در صورت تمایل، اجرای خودکار را پیکربندی کنید.
.PP
اگر قصد دارید از قابلیت rclone
mount (https://rclone.org/commands/rclone_mount) استفاده کنید، باید
ابزار شخص ثالث WinFsp (https://winfsp.dev) را نیز نصب کنید.
.SS مدیر بسته ویندوز (Winget)
.PP
ابزار Winget (https://learn.microsoft.com/en-us/windows/package-manager)
به‌صورت پیش‌فرض در آخرین نسخه‌های ویندوز نصب است.
در غیر این صورت، بسته App
Installer (https://www.microsoft.com/p/app-installer/9nblggh4nns1)
را از Microsoft Store به‌روزرسانی کنید.
.PP
برای نصب rclone
.IP
.nf
\f[C]
winget install Rclone.Rclone
\f[R]
.fi
.PP
برای حذف rclone
.IP
.nf
\f[C]
winget uninstall Rclone.Rclone --force
\f[R]
.fi
.SS مدیر بسته Chocolatey
.PP
مطمئن شوید که Choco (https://chocolatey.org) را نصب کرده‌اید
.IP
.nf
\f[C]
choco search rclone
choco install rclone
\f[R]
.fi
.PP
این کار rclone را روی سیستم ویندوزی شما نصب می‌کند.
اگر قصد دارید از rclone
mount (https://rclone.org/commands/rclone_mount) استفاده کنید، آنگاه
.IP
.nf
\f[C]
choco install winfsp
\f[R]
.fi
.PP
آن را نیز نصب خواهد کرد.
.PP
توجه داشته باشید که این یک نصاب شخص ثالث است که توسط توسعه‌دهندگان rclone
کنترل نمی‌شود، بنابراین ممکن است قدیمی باشد.
نسخه فعلی آن در ادامه آمده است.
.PP
[تصویر: بسته
Chocolatey (https://repology.org/badge/version-for-repo/chocolatey/rclone.svg)] (https://repology.org/project/rclone/versions).SS مدیر بسته Scoop
.PP
مطمئن شوید که Scoop (https://scoop.sh) را نصب کرده‌اید
.IP
.nf
\f[C]
scoop install rclone
\f[R]
.fi
.PP
توجه داشته باشید که این یک نصاب شخص ثالث است که توسط توسعه‌دهندگان rclone کنترل نمی‌شود، بنابراین ممکن است قدیمی باشد.
نسخه فعلی آن در ادامه آمده است.
.PP
[تصویر: بسته Scoop (https://repology.org/badge/version-for-repo/scoop/rclone.svg)] (https://repology.org/project/rclone/versions)
.SS نصب از طریق مدیر بسته
.PP
بسیاری از توزیع‌های Linux، Windows، macOS و سایر سیستم‌عامل‌ها rclone را بسته‌بندی و توزیع می‌کنند.
.PP
نسخه‌های توزیع‌شده rclone اغلب تا حد زیادی قدیمی هستند و به همین دلیل، در صورت امکان استفاده از یکی دیگر از روش‌های نصب را توصیه می‌کنیم.
.PP
می‌توانید برای اطلاع از وضعیت به‌روز بودن یا نبودن بسته توزیع سیستم‌عامل خود به اینجا مراجعه کنید.
.PP
[تصویر: وضعیت بسته‌بندی (https://repology.org/badge/vertical-allrepos/rclone.svg?columns=3)] (https://repology.org/project/rclone/versions)
.SS نصب با Docker
.PP
توسعه‌دهندگان rclone یک ایمیج Docker برای
rclone (https://hub.docker.com/r/rclone/rclone) نگهداری می‌کنند.
.PP
\f[B]نکته:\f[R] ما همچنین اکنون یک نسخه پولی از rclone با امنیت در سطح سازمانی و بدون آسیب‌پذیری (zero CVEs) از طریق شریک خود
SecureBuild (https://securebuild.com/blog/introducing-securebuild) ارائه می‌دهیم.
در صورت تمایل، وبگاه آن‌ها و ایمیج
Rclone SecureBuild (https://securebuild.com/images/rclone) را بررسی کنید.
.PP
این ایمیج‌ها به عنوان بخشی از فرایند انتشار، بر پایه یک Alpine Linux مینیمال ساخته می‌شوند.
.PP
برچسب \f[V]:latest\f[R] همواره به آخرین انتشار پایدار اشاره خواهد داشت.
می‌توانید از برچسب \f[V]:beta\f[R] برای دریافت آخرین ساخت از شاخه master استفاده کنید.
همچنین می‌توانید از برچسب‌های نسخه مانند
\f[V]:1.49.1\f[R]، \f[V]:1.49\f[R] یا \f[V]:1\f[R] استفاده نمایید.
.IP
.nf
\f[C]
$ docker pull rclone/rclone:latest
latest: Pulling from rclone/rclone
Digest: sha256:0e0ced72671989bb837fea8e88578b3fc48371aa45d209663683e24cfdaa0e11
\&...
$ docker run --rm rclone/rclone:latest version
rclone v1.49.1
- os/arch: linux/amd64
- go version: go1.12.9
\f[R]
.fi
.PP
هنگام راه‌اندازی کانتینر Docker برای rclone از این ایمیج، چند گزینه خط فرمان وجود دارد که باید در نظر بگیرید.
.IP \[bu] 2
باید دایرکتوری پیکربندی rclone میزبان را در \f[V]/config/rclone\f[R] درون کانتینر Docker مانت کنید.
با توجه به این واقعیت که rclone توکن‌ها را درون فایل پیکربندی خود به‌روزرسانی می‌کند و فرایند به‌روزرسانی شامل تغییر نام فایل است، باید کل دایرکتوری پیکربندی rclone میزبان را مانت کنید، نه فقط یک تک‌فایل پیکربندی rclone میزبان را.
.IP \[bu] 2
باید دایرکتوری داده‌های میزبان را در \f[V]/data\f[R] درون کانتینر Docker مانت کنید.
.IP \[bu] 2
به‌طور پیش‌فرض، باینری rclone درون کانتینر Docker با UID=0 (ریشه) اجرا می‌شود.
در نتیجه، تمام فایل‌های ایجاد شده در یک اجرا دارای UID=0 خواهند بود.
اگر فایل‌های پیکربندی و داده‌های شما روی میزبان دارای UID:GID غیر از ریشه هستند، باید این مقادیر را در خط فرمان شروع کانتینر مشخص کنید.
.IP \[bu] 2
اگر می‌خواهید به رابط RC (چه از طریق API یا رابط وب) دسترسی داشته باشید، لازم است مقدار \f[V]--rc-addr\f[R] را روی \f[V]:5572\f[R] تنظیم نمایید تا بتوانید از خارج کانتینر به آن متصل شوید.
توضیحی درباره چرایی ضرورت این کار را می‌توان در مقاله‌ای قدیمی در
pythonspeed.com (https://web.archive.org/web/20200808071950/https://pythonspeed.com/articles/docker-connection-refused) یافت.
.RS 2
.IP \[bu] 2
نکته: کاربرانی که این کانتینر را با شبکه docker تنظیم‌شده روی \f[V]host\f[R] اجرا می‌کنند، احتمالاً باید آن را طوری تنظیم کنند که تنها به localhost گوش دهد و مقدار \f[V]127.0.0.1:5572\f[R] را به عنوان مقدار \f[V]--rc-addr\f[R] قرار دهند.
.RE
.IP \[bu] 2
این امکان وجود دارد که از \f[V]rclone mount\f[R] درون یک کانتینر داکر فضای کاربری (userspace) استفاده کنید و مانت FUSE حاصل را در دسترس میزبان قرار دهید.
گزینه‌های دقیق \f[V]docker run\f[R] برای انجام این کار ممکن است بین میزبان‌های مختلف کمی متفاوت باشد.
برای مثال، گفتگوی موجود در این
موضوع (https://github.com/moby/moby/issues/9448) را ببینید.
.RS 2
.PP
همچنین لازم است \f[V]/etc/passwd\f[R] و \f[V]/etc/group\f[R] میزبان را مانت کنید تا FUSE درون کانتینر کار کند.
.RE
.PP
در اینجا چند دستور آورده شده که روی یک میزبان Ubuntu 18.04.3 آزمایش شده‌اند:
.IP
.nf
\f[C]
# پیکربندی روی میزبان در \[ti]/.config/rclone/rclone.conf
# داده‌ها روی میزبان در \[ti]/data

# افزودن تعاملی یک ریموت
docker run --rm -it \[rs]
    --volume \[ti]/.config/rclone:/config/rclone \[rs]
    --user $(id -u):$(id -g) \[rs]
    rclone/rclone \[rs]
    config

# اطمینان از درستی پیکربندی با فهرست کردن ریموت‌ها
docker run --rm \[rs]
    --volume \[ti]/.config/rclone:/config/rclone \[rs]
    --user $(id -u):$(id -g) \[rs]
    rclone/rclone \[rs]
    listremotes

# انجام مانت در کانتینر Docker و دسترس‌پذیر کردن خروجی برای میزبان
mkdir -p \[ti]/data/mount
docker run --rm \[rs]
    --volume \[ti]/.config/rclone:/config/rclone \[rs]
    --volume \[ti]/data:/data:shared \[rs]
    --user $(id -u):$(id -g) \[rs]
    --volume /etc/passwd:/etc/passwd:ro --volume /etc/group:/etc/group:ro \[rs]
    --device /dev/fuse --cap-add SYS_ADMIN --security-opt apparmor:unconfined \[rs]
    rclone/rclone \[rs]
    mount dropbox:Photos /data/mount &
ls \[ti]/data/mount
kill %1
\f[R]
.fi.SS نصب از طریق Snap (Snap installation)
.PP
[تصویر: دریافت از Snap Store (https://snapcraft.io/static/images/badges/en/snap-store-black.svg)] (https://snapcraft.io/rclone)
.PP
اطمینان حاصل کنید که Snapd نصب شده باشد (https://snapcraft.io/docs/installing-snapd).
.IP
.nf
\f[C]
sudo snap install rclone
\f[R]
.fi
.PP
به دلیل محدودسازی سخت‌گیرانه (confinement) بسته Snap، بسته snap برنامه rclone نمی‌تواند به دایرکتوری واقعی \f[V]/home/$USER/.config/rclone\f[R] دسترسی داشته باشد؛ مسیر پیش‌فرض پیکربندی به شرح زیر است:
.IP \[bu] 2
دایرکتوری پیش‌فرض پیکربندی:
.RS 2
.IP \[bu] 2
/home/$USER/snap/rclone/current/.config/rclone
.RE
.PP
نکته: به دلیل محدودسازی سخت‌گیرانه Snap، قابلیت \f[V]rclone mount\f[R] پشتیبانی \f[V]نمی‌شود\f[R].
.PP
اگر به قابلیت mount نیاز دارید، یا نسخه باینری از پیش کامپایل‌شده را نصب کنید یا هنگام نصب از سورس‌کد، گزینه مربوطه را فعال نمایید.
.PP
توجه داشته باشید که این بسته توسط نگه‌دارنده جامعه کاربری (https://github.com/boukendesho/rclone-snap) مدیریت می‌شود و نه توسط توسعه‌دهندگان rclone، بنابراین ممکن است به‌روز نباشد.
نسخه فعلی آن به شرح زیر است:
.PP
[تصویر: rclone (https://snapcraft.io/rclone/badge.svg)] (https://snapcraft.io/rclone)
.SS نصب از سورس‌کد (Source installation)
.PP
اطمینان حاصل کنید که git و Go (https://golang.org) نصب شده باشند.
نسخه Go 1.26 یا جدیدتر مورد نیاز است؛ استفاده از آخرین نگارش توصیه می‌شود.
می‌توانید آن را از طریق مدیر بسته خود دریافت کرده، یا از golang.org/dl (https://golang.org/dl) بارگیری کنید.
سپس می‌توانید دستورات زیر را اجرا نمایید:
.IP
.nf
\f[C]
git clone https://github.com/rclone/rclone.git
cd rclone
go build
\f[R]
.fi
.PP
این کار سورس‌کد rclone را در زیرپوشه rclone دریافت (checkout) می‌کند، که می‌توانید بعداً آن را تغییر داده و pull request ارسال کنید.
سپس فایل اجرایی rclone را در همان پوشه می‌سازد.
به عنوان یک بررسی اولیه اکنون می‌توانید \f[V]./rclone version\f[R] را اجرا کنید
(در Windows به صورت \f[V].\[rs]rclone version\f[R]).
.PP
توجه داشته باشید که در macOS و Windows دستور mount (https://rclone.org/commands/rclone_mount) در دسترس نخواهد بود، مگر اینکه برچسب ساخت اضافی \f[V]cmount\f[R] را مشخص کنید.
.IP
.nf
\f[C]
go build -tags cmount
\f[R]
.fi
.PP
این کار فرض می‌کند که یک کامپایلر C سازگار با GCC (مانند GCC یا Clang) در مسیر PATH خود دارید، زیرا از cgo (https://pkg.go.dev/cmd/cgo) استفاده می‌کند.
اما در Windows، کتابخانه cgofuse (https://github.com/winfsp/cgofuse) که پیاده‌سازی cmount بر پایه آن است، همچنین از ساخت بدون cgo (https://github.com/golang/go/wiki/WindowsDLLs) پشتیبانی می‌کند؛ یعنی از طریق تنظیم متغیر محیطی CGO_ENABLED به مقدار 0 (پیوند ایستا یا static linking).
نگارش‌های رسمی rclone برای Windows از نسخه 1.59 به بعد به همین روش ساخته می‌شوند.
همچنان امکان ساخت به همراه cgo در Windows نیز وجود دارد، از طریق استفاده از پورت MinGW برای GCC؛ به عنوان مثال با نصب آن در یک توزیع MSYS2 (https://www.msys2.org) (اطمینان حاصل کنید که آن را در زیرسیستم کلاسیک mingw64 نصب می‌کنید، نسخه ucrt64 سازگار نیست).
.PP
علاوه بر این، برای ساخت به همراه mount در Windows، باید ابزار جانبی WinFsp (https://winfsp.dev) را با انتخاب ویژگی \[dq]Developer\[dq] نصب کنید.
اگر با cgo اقدام به ساخت می‌کنید، باید متغیر محیطی CPATH را نیز طوری تنظیم کنید که به دایرکتوری include مربوط به fuse درون محل نصب WinFsp اشاره کند (به طور معمول \f[V]C:\[rs]Program Files (x86)\[rs]WinFsp\[rs]inc\[rs]fuse\f[R]).
.PP
می‌توانید آرگومان‌های \f[V]-ldflags -s\f[R] را برای حذف جدول نمادها و اطلاعات اشکال‌زدایی (debug) اضافه کنید تا فایل اجرایی کوچک‌تر شود، و همچنین \f[V]-trimpath\f[R] را برای حذف ارجاعات به مسیرهای محلی سیستم‌فایل به کار ببرید.
نگارش‌های رسمی rclone با هر دوی این موارد ساخته می‌شوند.
.IP
.nf
\f[C]
go build -trimpath -ldflags -s -tags cmount
\f[R]
.fi
.PP
اگر می‌خواهید رشته نسخه را که توسط دستور \f[V]rclone version\f[R] گزارش می‌شود سفارشی کنید، می‌توانید یکی از متغیرهای \f[V]fs.Version\f[R]، \f[V]fs.VersionTag\f[R] (برای نگه‌داشتن پسوند پیش‌فرض و سفارشی‌سازی شماره نسخه) یا \f[V]fs.VersionSuffix\f[R] (برای نگه‌داشتن شماره پیش‌فرض و سفارشی‌سازی پسوند) را تنظیم کنید.
این کار را می‌توان از طریق دستور ساخت و با افزودن آن به مقدار آرگومان \f[V]-ldflags\f[R] مطابق زیر انجام داد:
.IP
.nf
\f[C]
go build -trimpath -ldflags \[dq]-s -X github.com/rclone/rclone/fs.Version=v9.9.9-test\[dq] -tags cmount
\f[R]
.fi
.PP
در Windows، فایل‌های اجرایی رسمی علاوه بر اطلاعات نسخه، آیکون فایل را نیز به عنوان منابع باینری تعبیه‌شده به همراه دارند.
برای دریافت این مورد در ساخت شخصی خود، باید دستور زیر را \f[B]پیش از\f[R] دستور ساخت اجرا کنید.
این دستور یک فایل شیء سیستمی منبع Windows با پسوند \&.syso (به عنوان مثال \f[V]resource_windows_amd64.syso\f[R]) تولید می‌کند که در دستورات ساخت بعدی به طور خودکار دریافت خواهد شد.
.IP
.nf
\f[C]
go run bin/resource_windows.go
\f[R]
.fi
.PP
دستور بالا یک فایل منبع حاوی اطلاعات نسخه بر اساس متغیر fs.Version موجود در سورس‌کد در زمان اجرای دستور تولید می‌کند؛ این بدان معناست که در صورت تغییر مقدار این متغیر، باید دستور را مجدداً اجرا کنید تا در اطلاعات نسخه بازتاب یابد.
همچنین، اگر متغیر نسخه را در دستور ساخت مطابق توضیحات بالا بازنویسی (override) کنید، لازم است هنگام تولید فایل منبع نیز این کار را انجام دهید، در غیر این صورت همچنان از مقدار موجود در سورس‌کد استفاده خواهد کرد.
.IP
.nf
\f[C]
go run bin/resource_windows.go -version v9.9.9-test
\f[R]
.fi
.PP
به جای اجرای مستقیم دستور \f[V]go build\f[R]، می‌توانید آن را از طریق Makefile اجرا کنید.
هدف پیش‌فرض، پسوند نسخه را از \[dq]-DEV\[dq] به \[dq]-beta\[dq] تغییر می‌دهد و جزئیات commit اضافی را به آن می‌افزاید، منابع باینری اطلاعات نسخه را در Windows تعبیه می‌کند و فایل اجرایی rclone حاصل را در پوشه bin مسیر GOPATH شما کپی می‌کند (\f[V]$(go env GOPATH)/bin\f[R] که به طور پیش‌فرض مطابق با \f[V]\[ti]/go/bin/rclone\f[R] است).
.IP
.nf
\f[C]
make
\f[R]
.fi
.PP
برای گنجاندن دستور mount در macOS و Windows هنگام ساخت با Makefile:
.IP
.nf
\f[C]
make GOTAGS=cmount
\f[R]
.fi
.PP
اهداف make دیگری نیز وجود دارند که می‌توانند برای ساخت‌های پیشرفته‌تر به کار روند، از جمله کامپایل متقاطع (cross-compiling) برای تمامی سیستم‌عامل‌ها/معماری‌های پشتیبانی‌شده و بسته‌بندی نتایج در قالب مصنوعات انتشار (release artifacts).
برای جزئیات به Makefile (https://github.com/rclone/rclone/blob/master/Makefile) و cross-compile.go (https://github.com/rclone/rclone/blob/master/bin/cross-compile.go) مراجعه کنید.
.PP
یک روش جایگزین دیگر برای نصب از سورس‌کد، بارگیری سورس، ساخت و نصب rclone به صورت یک‌جا و در قالب یک بسته استاندارد Go است.
سورس‌کد در حافظه موقت ماژول‌های Go (module cache) ذخیره شده و فایل اجرایی حاصل در پوشه bin مسیر GOPATH شما قرار خواهد گرفت (\f[V]$(go env GOPATH)/bin\f[R] که به طور پیش‌فرض مطابق با \f[V]\[ti]/go/bin/rclone\f[R] است)..IP
.nf
\f[C]
go install github.com/rclone/rclone\[at]latest
\f[R]
.fi
.PP
در برخی شرایط، در صورت گنجانده شدن تمامی backendها با SDKهای حجیم آن‌ها، ممکن است حجم فایل اجرایی rclone برای استقرار در محیط‌های بسیار محدود بیش از حد بزرگ باشد.
جهت محدود کردن اندازه باینری، می‌توان پیش از ساخت با \f[V]go build\f[R] یا \f[V]make\f[R]، backendهای استفاده‌نشده را در \f[V]backends/all/all.go\f[R] و دستورهای بدون استفاده را در \f[V]cmd/all/all.go\f[R] غیرفعال (کامنت) کرد.
.SS "نصب با Ansible (Ansible installation)"
.PP
این کار را می‌توان از طریق نقش ansible متعلق به Stefan Weichinger انجام داد (https://github.com/stefangweichinger/ansible-rclone).
.PP
دستورالعمل‌ها
.IP "1." 3
اجرای دستور \f[V]git clone https://github.com/stefangweichinger/ansible-rclone.git\f[R] در دایرکتوری محلی roles شما
.IP "2." 3
افزودن این نقش به میزبان‌هایی که می‌خواهید rclone روی آن‌ها نصب شود:
.RS 4
.IP
.nf
\f[C]
- hosts: rclone-hosts
  roles:
    - rclone
\f[R]
.fi
.RE
.SS "نصب قابل‌حمل (Portable installation)"
.PP
همان‌طور که در بالا ذکر شد (https://rclone.org/install/#quickstart)، نرم‌افزار rclone یک تک‌فایل اجرایی است (\f[V]rclone\f[R]، یا \f[V]rclone.exe\f[R] در Windows) که می‌توانید آن را در قالب یک بایگانی zip دانلود کرده و در مکانی دلخواه استخراج کنید.
هنگام اجرای دستورهای گوناگون، ممکن است فایل‌هایی در مکان‌های مختلف ایجاد شوند؛ مانند یک فایل پیکربندی و انواع فایل‌های موقت.
به‌طور پیش‌فرض، مکان این فایل‌ها متناسب با سیستم‌عامل شما تعیین می‌شود؛ برای نمونه، فایل پیکربندی در دایرکتوری نمایه کاربر (user profile) و فایل‌های موقت در دایرکتوری موقت استاندارد قرار می‌گیرند؛ با این حال، می‌توانید تمامی آن‌ها را سفارشی‌سازی کنید، برای مثال به‌منظور ایجاد یک نصب کاملاً مستقل و قابل‌حمل.
.PP
برای مشاهده مکان‌هایی که rclone استفاده خواهد کرد، دستور config paths (https://rclone.org/commands/rclone_config_paths) را اجرا کنید.
.PP
برای بازنویسی آن‌ها، گزینه‌های متناظر را تعیین کنید (به‌عنوان آرگومان‌های خط فرمان یا متغیرهای محیط (https://rclone.org/docs/#environment-variables)):
.IP \[bu] 2
--config (https://rclone.org/docs/#config-string)
.IP \[bu] 2
--cache-dir (https://rclone.org/docs/#cache-dir-string)
.IP \[bu] 2
--temp-dir (https://rclone.org/docs/#temp-dir-string)
.SS "راه‌اندازی خودکار (Autostart)"
.PP
پس از نصب و پیکربندی rclone بر اساس توضیحات بالا، آماده‌اید تا از rclone به‌عنوان یک ابزار خط فرمان تعاملی استفاده نمایید.
اگر هدف شما انجام عملیات \f[I]دوره‌ای\f[R] است، مانند یک sync منظم (https://rclone.org/commands/rclone_sync)، احتمالاً مایل خواهید بود دستور rclone خود را در زمان‌بند سیستم‌عامل خود پیکربندی کنید.
اگر نیاز به ارائه قابلیت‌های شبه-\f[I]سرویس\f[R] دارید، نظیر remote control (https://rclone.org/rc)، واسط گرافیکی یا GUI (https://rclone.org/gui)، دستور serve (https://rclone.org/commands/rclone_serve) یا mount (https://rclone.org/commands/rclone_mount)، اغلب می‌خواهید یک دستور rclone همواره در پس‌زمینه اجرا شود؛ در این صورت، پیکربندی آن برای اجرا در زیرساخت خدمات سیستم (service) می‌تواند گزینه بهتری باشد.
در ادامه روش‌های مختلفی برای پیاده‌سازی این موضوع در سیستم‌عامل‌های مختلف آورده شده است.
.PP
نکته: پیش از راه‌اندازی autorun، اکیداً توصیه می‌شود که ابتدا دستور خود را به‌صورت دستی در خط فرمان آزمایش کرده باشید..SS اجرای خودکار در ویندوز
.PP
مناسب‌ترین گزینه‌ها برای اجرای خودکار در ویندوز عبارتند از:
.IP \[bu] 2
اجرا هنگام ورود کاربر با استفاده از پوشهٔ Startup
.IP \[bu] 2
اجرا هنگام ورود کاربر، هنگام راه‌اندازی سیستم، یا طبق زمان‌بندی با استفاده از Task
Scheduler
.IP \[bu] 2
اجرا هنگام راه‌اندازی سیستم با استفاده از سرویس ویندوز (Windows service)
.SS اجرا در پس‌زمینه
.PP
ابزار Rclone یک برنامهٔ کنسولی است؛ بنابراین اگر از یک Command Prompt موجود اجرا نشود،
مثلاً هنگام اجرای rclone.exe از طریق یک میانبر، پنجرهٔ Command Prompt را باز
خواهد کرد.
هنگام پیکربندی rclone برای اجرا از طریق Task Scheduler یا سرویس ویندوز،
می‌توانید آن را طوری تنظیم کنید که به صورت پنهان در پس‌زمینه اجرا شود.
از نسخهٔ 1.54 به بعد rclone، می‌توانید با افزودن گزینهٔ \f[V]--no-console\f[R]
کاری کنید که از هر جایی به صورت مخفی اجرا شود (ممکن است هنگام شروع برنامه
همچنان یک لحظه چشمک بزند).
از آنجا که rclone معمولاً اطلاعات و پیام‌های خطا را در کنسول می‌نویسد، برای
مشاهدهٔ آن‌ها باید این خروجی را به یک فایل هدایت کنید.
ابزار Rclone گزینهٔ داخلی \f[V]--log-file\f[R] را برای این منظور دارد.
.PP
دستور نمونه برای اجرای یک همگام‌سازی در پس‌زمینه:
.IP
.nf
\f[C]
c:\[rs]rclone\[rs]rclone.exe sync c:\[rs]files remote:/files --no-console --log-file c:\[rs]rclone\[rs]logs\[rs]sync_files.txt
\f[R]
.fi
.SS حساب کاربری
.PP
همان‌طور که در مستندات mount (https://rclone.org/commands/rclone_mount)
ذکر شده است، درایوهای متصل‌شده‌ای که به عنوان Administrator ایجاد می‌شوند
برای سایر حساب‌ها قابل مشاهده نیستند، حتی برای حسابی که دسترسی‌اش به
Administrator ارتقا یافته است.
با اجرای دستور mount تحت حساب کاربری داخلی \f[V]SYSTEM\f[R]، درایوهایی
ایجاد می‌شوند که برای همهٔ افراد در سیستم قابل دسترس خواهند بود.
برای دستیابی به این هدف می‌توان هم از وظایف زمان‌بندی‌شده و هم از سرویس‌های ویندوز
استفاده کرد.
.PP
نکته: به یاد داشته باشید که وقتی rclone به عنوان کاربر \f[V]SYSTEM\f[R] اجرا
می‌شود، نمایهٔ کاربری که می‌بیند نمایهٔ شما نخواهد بود.
این بدان معناست که اگر معمولاً rclone را با فایل پیکربندی در مکان پیش‌فرض اجرا
می‌کنید، برای اینکه بتوانید هنگام اجرا به عنوان کاربر سیستم از همان پیکربندی
استفاده کنید باید صراحتاً با گزینهٔ \f[V]--config\f[R] (https://rclone.org/docs/#config-string)
محل آن را به rclone مشخص کنید؛ در غیر این صورت در مسیر نمایهٔ کاربر سیستم
(\f[V]C:\[rs]Windows\[rs]System32\[rs]config\[rs]systemprofile\f[R]) به دنبال آن خواهد گشت.
برای آزمایش دستی دستور خود از طریق یک Command Prompt، می‌توانید آن را با
ابزار PsExec (https://docs.microsoft.com/en-us/sysinternals/downloads/psexec)
از مجموعهٔ Sysinternals مایکروسافت اجرا کنید که گزینهٔ \f[V]-s\f[R] را برای اجرای
دستورات به عنوان کاربر \f[V]SYSTEM\f[R] می‌پذیرد.
.SS اجرا از پوشهٔ Startup
.PP
برای اجرای سریع یک دستور rclone می‌توانید به سادگی یک میانبر استاندارد در
Windows Explorer برای دستور کامل rclone که قصد اجرای آن را دارید بسازید.
اگر این میانبر را در پوشهٔ ویژهٔ \[dq]Startup\[dq] در منوی استارت قرار دهید،
ویندوز به صورت خودکار آن را هنگام ورود به سیستم اجرا خواهد کرد.
برای باز کردن این پوشه در Windows Explorer، مسیر
\f[V]%APPDATA%\[rs]Microsoft\[rs]Windows\[rs]Start Menu\[rs]Programs\[rs]Startup\f[R]،
یا مسیر
\f[V]C:\[rs]ProgramData\[rs]Microsoft\[rs]Windows\[rs]Start Menu\[rs]Programs\[rs]StartUp\f[R]
را (اگر می‌خواهید دستور برای \f[I]همهٔ\f[R] کاربرانی که وارد سیستم می‌شوند اجرا شود) وارد کنید.
.PP
این روش ساده‌ترین راهکار برای اجرای خودکار rclone است، اما قابلیتی برای
تنظیم اجرا تحت کاربری دیگر، یا تعیین شروط یا واکنش‌ها به رویدادهای مشخص ارائه
نمی‌دهد.
راه‌اندازی یک وظیفهٔ زمان‌بندی‌شده همان‌طور که در ادامه توضیح داده شده است،
اغلب نتایج بهتری برای شما به همراه خواهد داشت.
.SS اجرا از Task Scheduler
.PP
ابزار Task Scheduler یک ابزار مدیریتی داخلی در ویندوز است و می‌توان از آن
برای پیکربندی شروع خودکار rclone با انعطاف‌پذیری بسیار بالا استفاده کرد؛
مانند اجرا به صورت دوره‌ای طبق زمان‌بندی، هنگام ورود کاربر، یا هنگام راه‌اندازی سیستم.
این ابزار می‌تواند برای اجرا تحت کاربر فعلی پیکربندی شود، یا برای دستور mount
که نیاز است در دسترس همهٔ کاربران باشد، تحت کاربر \f[V]SYSTEM\f[R] اجرا گردد.
برای اطلاعات فنی بیشتر، به Task Scheduler for
developers (https://docs.microsoft.com/windows/win32/taskschd/task-scheduler-start-page) مراجعه کنید..SS اجرا به‌عنوان سرویس (Run as service)
.PP
برای اجرای rclone هنگام بالا آمدن سیستم (startup)، می‌توانید به عنوان جایگزینی برای وظایف زمان‌بندی‌شده (scheduled task) که برای اجرا در زمان راه‌اندازی پیکربندی شده‌اند، یک سرویس ویندوز ایجاد کنید که دستور rclone شما را اجرا کند.
.SS یکپارچه‌سازی توکار سرویس با دستور Mount
.PP
برای دستورات mount، ابزار rclone از طریق کتابخانه شخص ثالث WinFsp که استفاده می‌کند، یکپارچه‌سازی توکار با سرویس ویندوز را ارائه می‌دهد.
ثبت آن به‌عنوان یک سرویس معمولی ویندوز آسان است، چرا که تنها کافی است دستور توکار PowerShell با نام \f[V]New-Service\f[R] را اجرا کنید (نیازمند امتیازات مدیر سیستم/administrative است).
.PP
نمونه‌ای از دستور PowerShell که یک سرویس ویندوز برای سوار کردن (mount) مسیر \f[V]remote:/files\f[R] به‌عنوان حرف درایو \f[V]X:\f[R] برای \f[I]تمام\f[R] کاربران ایجاد می‌کند (سرویس با حساب کاربری محلی سیستم اجرا خواهد شد):
.IP
.nf
\f[C]
New-Service -Name Rclone -BinaryPathName \[aq]c:\[rs]rclone\[rs]rclone.exe mount remote:/files X: --config c:\[rs]rclone\[rs]config\[rs]rclone.conf --log-file c:\[rs]rclone\[rs]logs\[rs]mount.txt\[aq]
\f[R]
.fi
.PP
زیرساخت سرویس WinFsp (https://github.com/billziss-gh/winfsp/wiki/WinFsp-Service-Architecture)
از ادغام سرویس‌ها برای پیاده‌سازی‌های سیستم‌فایل، مانند rclone، در سرویس راه‌انداز خودش، به عنوان نوعی \[dq]سرویس‌های فرزند\[dq] پشتیبانی می‌کند.
این مورد این مزیت اضافی را دارد که یک ارائه‌دهنده شبکه (network provider) را نیز پیاده‌سازی می‌کند که با روش‌های استاندارد ویندوز برای مدیریت درایوهای شبکه یکپارچه می‌شود.
این قابلیت در حال حاضر به طور رسمی توسط Rclone پشتیبانی نمی‌شود، اما با WinFsp نسخه 2019.3 B2 / v1.5B2 یا جدیدتر، باید از طریق بازنویسی مسیر (path rewriting) طبق آنچه در
#3340 (https://github.com/rclone/rclone/issues/3340) توضیح داده شده است، امکان‌پذیر باشد.
.SS یکپارچه‌سازی سرویس با ابزارهای شخص ثالث
.PP
برای اجرای هر دستور rclone به عنوان سرویس ویندوز، می‌توان از ابزار شخص ثالث عالی NSSM (http://nssm.cc) یا همان \[dq]مدیر سرویس بدون نقص\[dq] (Non-Sucking Service Manager) استفاده کرد.
این ابزار شامل ویژگی‌های پیشرفته‌ای مانند تنظیم اولویت فرایند، تعریف متغیرهای محیطی فرایند، تغییر مسیر هر چیزی که در stdout نوشته می‌شود به فایل، و پاسخ سفارشی به کدهای خروج مختلف، همراه با یک رابط کاربری گرافیکی (GUI) برای پیکربندی همه‌چیز است (اگرچه می‌توان از خط فرمان نیز از آن استفاده کرد).
.PP
همچنین چندین جایگزین دیگر نیز وجود دارد.
برای اشاره به یک مورد دیگر، WinSW (https://github.com/winsw/winsw) موسوم به \[dq]Windows Service Wrapper\[dq] ارزش بررسی را دارد.
این برنامه به .NET Framework نیاز دارد، اما این فریم‌ورک روی نسخه‌های جدیدتر ویندوز به‌صورت پیش‌فرض نصب است، و همچنین توزیع‌های مستقل (standalone) جایگزینی ارائه می‌دهد که شامل زمان اجرای ضروری (.NET 5) هستند.
ابزار WinSW فقط مبتنی بر خط فرمان است، که در آن باید یک فایل XML حاوی پیکربندی سرویس را به صورت دستی بسازید.
این ممکن است برای برخی یک عیب باشد، اما می‌تواند یک مزیت نیز باشد زیرا پشتیبان‌گیری و استفاده مجدد از تنظیمات پیکربندی، بدون نیاز به طی کردن مراحل دستی در یک رابط گرافیکی، آسان است.
نکته‌ای که باید به آن توجه داشت این است که به‌طور پیش‌فرض سرویس را هنگام بروز خطا راه‌اندازی مجدد نمی‌کند و باید صراحتاً این مورد را در فایل پیکربندی (از طریق پارامتر \[dq]onfailure\[dq]) فعال کرد.
.SS شروع خودکار در لینوکس (Autostart on Linux)
.SS راه‌اندازی به‌عنوان سرویس (Start as a service)
.PP
برای اجرای همیشگی rclone در پس‌زمینه (مناسب برای دستورات mount و غیره)، می‌توانید از systemd برای راه‌اندازی rclone به‌عنوان یک سرویس سیستمی یا کاربری استفاده کنید.
اجرا به‌عنوان سرویس سیستمی تضمین می‌کند که حتی اگر کاربری که سرویس با آن اجرا می‌شود نشست فعالی نداشته باشد، برنامه در زمان بالا آمدن سیستم اجرا شود.
اجرای rclone به‌عنوان یک سرویس کاربری تضمین می‌کند که برنامه تنها پس از ورود کاربر پیکربندی‌شده به سیستم آغاز به کار کند.
.SS اجرای دوره‌ای از طریق cron
.PP
برای اجرای یک دستور دوره‌ای، مانند copy/sync، می‌توانید یک وظیفه زمان‌بندی‌شده cron تنظیم کنید.
.SH "نحوه استفاده (USAGE)"
.PP
برنامه Rclone یک ابزار خط فرمانی برای مدیریت فایل‌ها روی فضای ذخیره‌سازی ابری است.
پس از بارگیری (https://rclone.org/downloads) و نصب، برای یادگیری نحوه استفاده از آن اینجا را ادامه دهید: پیکربندی اولیه، ساختار نحو پایه، شرح زیردستورهای گوناگون، گزینه‌های مختلف و موارد دیگر..SS "پیکربندی (Configure)"
.PP
در ابتدا، لازم است rclone را پیکربندی کنید.
از آن‌جا که سامانه‌های ذخیره‌سازی شیء احراز هویت نسبتاً پیچیده‌ای دارند،
این اطلاعات در یک فایل پیکربندی نگهداری می‌شوند.
(برای چگونگی یافتن فایل پیکربندی و انتخاب مکان آن، مدخل \f[V]--config\f[R] را ببینید.)
.PP
ساده‌ترین راه برای ایجاد پیکربندی، اجرای rclone با گزینهٔ config است:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
برای دستورالعمل‌های تفصیلی، موارد زیر را ببینید:
.IP \[bu] 2
1Fichier (https://rclone.org/fichier)
.IP \[bu] 2
Akamai Netstorage (https://rclone.org/netstorage)
.IP \[bu] 2
Alias (https://rclone.org/alias)
.IP \[bu] 2
Archive (https://rclone.org/archive)
.IP \[bu] 2
Amazon S3 (https://rclone.org/s3)
.IP \[bu] 2
Backblaze B2 (https://rclone.org/b2)
.IP \[bu] 2
Box (https://rclone.org/box)
.IP \[bu] 2
Chunker (https://rclone.org/chunker) \- تقسیم شفاف فایل‌های بزرگ برای سایر ریموت‌ها
.IP \[bu] 2
Citrix ShareFile (https://rclone.org/sharefile)
.IP \[bu] 2
Compress (https://rclone.org/compress)
.IP \[bu] 2
Cloudinary (https://rclone.org/cloudinary)
.IP \[bu] 2
Combine (https://rclone.org/combine)
.IP \[bu] 2
Crypt (https://rclone.org/crypt) \- برای رمزگذاری سایر ریموت‌ها
.IP \[bu] 2
DigitalOcean Spaces (https://rclone.org/s3/#digitalocean-spaces)
.IP \[bu] 2
Digi Storage (https://rclone.org/koofr/#digi-storage)
.IP \[bu] 2
Drime (https://rclone.org/drime)
.IP \[bu] 2
Dropbox (https://rclone.org/dropbox)
.IP \[bu] 2
Enterprise File Fabric (https://rclone.org/filefabric)
.IP \[bu] 2
FileLu Cloud Storage (https://rclone.org/filelu)
.IP \[bu] 2
Filen (https://rclone.org/filen)
.IP \[bu] 2
Files.com (https://rclone.org/filescom)
.IP \[bu] 2
FTP (https://rclone.org/ftp)
.IP \[bu] 2
Gofile (https://rclone.org/gofile)
.IP \[bu] 2
Google Cloud Storage (https://rclone.org/googlecloudstorage)
.IP \[bu] 2
Google Drive (https://rclone.org/drive)
.IP \[bu] 2
Google Photos (https://rclone.org/googlephotos)
.IP \[bu] 2
Hasher (https://rclone.org/hasher) \- برای مدیریت جمع‌های کنترلی (checksums) برای سایر ریموت‌ها
.IP \[bu] 2
HDFS (https://rclone.org/hdfs)
.IP \[bu] 2
Hetzner Storage Box (https://rclone.org/sftp/#hetzner-storage-box)
.IP \[bu] 2
HiDrive (https://rclone.org/hidrive)
.IP \[bu] 2
HTTP (https://rclone.org/http)
.IP \[bu] 2
Huawei Drive (https://rclone.org/huaweidrive)
.IP \[bu] 2
iCloud Drive (https://rclone.org/iclouddrive)
.IP \[bu] 2
Internet Archive (https://rclone.org/internetarchive)
.IP \[bu] 2
Internxt (https://rclone.org/internxt)
.IP \[bu] 2
Jottacloud (https://rclone.org/jottacloud)
.IP \[bu] 2
Koofr (https://rclone.org/koofr)
.IP \[bu] 2
Linkbox (https://rclone.org/linkbox)
.IP \[bu] 2
Mail.ru Cloud (https://rclone.org/mailru)
.IP \[bu] 2
Mega (https://rclone.org/mega)
.IP \[bu] 2
Memory (https://rclone.org/memory)
.IP \[bu] 2
Microsoft Azure Blob Storage (https://rclone.org/azureblob)
.IP \[bu] 2
Microsoft Azure Files Storage (https://rclone.org/azurefiles)
.IP \[bu] 2
Microsoft OneDrive (https://rclone.org/onedrive)
.IP \[bu] 2
OpenStack Swift / Rackspace Cloudfiles / Blomp Cloud Storage / Memset
Memstore (https://rclone.org/swift)
.IP \[bu] 2
OpenDrive (https://rclone.org/opendrive)
.IP \[bu] 2
Oracle Object Storage (https://rclone.org/oracleobjectstorage)
.IP \[bu] 2
Pcloud (https://rclone.org/pcloud)
.IP \[bu] 2
PikPak (https://rclone.org/pikpak)
.IP \[bu] 2
Pixeldrain (https://rclone.org/pixeldrain)
.IP \[bu] 2
premiumize.me (https://rclone.org/premiumizeme)
.IP \[bu] 2
put.io (https://rclone.org/putio)
.IP \[bu] 2
Proton Drive (https://rclone.org/protondrive)
.IP \[bu] 2
QingStor (https://rclone.org/qingstor)
.IP \[bu] 2
Quatrix by Maytech (https://rclone.org/quatrix)
.IP \[bu] 2
rsync.net (https://rclone.org/sftp/#rsync-net)
.IP \[bu] 2
Seafile (https://rclone.org/seafile)
.IP \[bu] 2
SFTP (https://rclone.org/sftp)
.IP \[bu] 2
Shade (https://rclone.org/shade)
.IP \[bu] 2
Sia (https://rclone.org/sia)
.IP \[bu] 2
SMB (https://rclone.org/smb)
.IP \[bu] 2
Storj (https://rclone.org/storj)
.IP \[bu] 2
SugarSync (https://rclone.org/sugarsync)
.IP \[bu] 2
Union (https://rclone.org/union)
.IP \[bu] 2
Uloz.to (https://rclone.org/ulozto)
.IP \[bu] 2
WebDAV (https://rclone.org/webdav)
.IP \[bu] 2
Yandex Disk (https://rclone.org/yandex)
.IP \[bu] 2
Zoho WorkDrive (https://rclone.org/zoho)
.IP \[bu] 2
سیستم فایل محلی (https://rclone.org/local).SS "نحو پایه"
.PP
دستور rclone یک درخت دایرکتوری را از یک سامانه ذخیره‌سازی به سامانه‌ای دیگر همگام‌سازی می‌کند.
.PP
نحو آن بدین صورت است:
.IP
.nf
\f[C]
rclone subcommand [options] <parameters> <parameters...>
\f[R]
.fi
.PP
یک \f[V]subcommand\f[R] یک عملیات الزامی rclone است (مانند
\f[V]sync\f[R]، \f[V]copy\f[R]، \f[V]ls\f[R]).
.PP
یک \f[V]option\f[R] یک پرچم تک‌حرفی (مانند
\f[V]-v\f[R]) یا گروهی از پرچم‌های تک‌حرفی (مانند
\f[V]-Pv\f[R]) یا یک پرچم بلند (مانند
\f[V]--progress\f[R]) است.
هیچ گزینه‌ای الزامی نیست.
گزینه‌ها می‌توانند پس از \f[V]subcommand\f[R] یا در میان پارامترها
یا در انتها نیز قرار گیرند، اما پیش از \f[V]subcommand\f[R]
تنها می‌توان از گزینه‌های سراسری استفاده کرد.
هر چیزی پس از گزینهٔ \f[V]--\f[R] به عنوان یک گزینه تفسیر نخواهد شد؛
بنابراین اگر نیاز دارید پارامتری اضافه کنید که با \f[V]-\f[R] آغاز می‌شود،
ابتدا یک \f[V]--\f[R] را به تنهایی قرار دهید، مانند
.IP
.nf
\f[C]
rclone lsf -- -directory-starting-with-dash
\f[R]
.fi
.PP
یک \f[V]parameter\f[R] معمولاً یک مسیر فایل یا یک ریموت rclone است، مانند
\f[V]/path/to/file\f[R] یا \f[V]remote:path/to/file\f[R]، اما می‌تواند
موارد دیگری نیز باشد \- بخش راهنمای \f[V]subcommand\f[R] به شما خواهد گفت چه مواردی هستند.
.PP
مسیرهای مبدأ و مقصد با نامی که در فایل پیکربندی به سامانه ذخیره‌سازی داده‌اید
و سپس زیرمسیر مشخص می‌شوند، مانند
\[dq]drive:myfolder\[dq] برای دیدن \[dq]myfolder\[dq] در Google drive.
.PP
می‌توانید هر تعداد مسیر ذخیره‌سازی که می‌خواهید را در فایل پیکربندی تعریف کنید.
.PP
لطفاً در حین یادگیری rclone از پرچم \f[V]--interactive\f[R]/\f[V]-i\f[R]
استفاده کنید تا از دست رفتن تصادفی داده‌ها جلوگیری شود.
.SS "زیرفرمان‌ها"
.PP
دستور rclone از سامانه‌ای از زیرفرمان‌ها استفاده می‌کند.
برای مثال
.IP
.nf
\f[C]
rclone ls remote:path # lists a remote
rclone copy /local/path remote:path # copies /local/path to the remote
rclone sync --interactive /local/path remote:path # syncs /local/path to the remote
\f[R]
.fi
.SH rclone config
.PP
ورود به نشست تعاملی پیکربندی.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
وارد یک نشست تعاملی پیکربندی شوید که در آن می‌توانید ریموت‌های جدید را
راه‌اندازی کرده و ریموت‌های موجود را مدیریت کنید.
همچنین می‌توانید برای محافظت از پیکربندی خود یک گذرواژه تنظیم یا حذف کنید.
.IP
.nf
\f[C]
rclone config [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای config
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید..SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنمای دستورها، پرچم‌ها و backendهای rclone.
.IP \[bu] 2
rclone config create (https://rclone.org/commands/rclone_config_create) \- ایجاد یک ریموت جدید با نام، نوع و گزینه‌ها.
.IP \[bu] 2
rclone config delete (https://rclone.org/commands/rclone_config_delete) \- حذف یک ریموت موجود.
.IP \[bu] 2
rclone config disconnect (https://rclone.org/commands/rclone_config_disconnect) \- قطع ارتباط کاربر از ریموت.
.IP \[bu] 2
rclone config dump (https://rclone.org/commands/rclone_config_dump) \- برون‌ریزی فایل پیکربندی در قالب JSON.
.IP \[bu] 2
rclone config edit (https://rclone.org/commands/rclone_config_edit) \- ورود به نشست تعاملی پیکربندی.
.IP \[bu] 2
rclone config encryption (https://rclone.org/commands/rclone_config_encryption) \- تنظیم، حذف و بررسی رمزنگاری فایل پیکربندی.
.IP \[bu] 2
rclone config file (https://rclone.org/commands/rclone_config_file) \- نمایش مسیر فایل پیکربندی در حال استفاده.
.IP \[bu] 2
rclone config password (https://rclone.org/commands/rclone_config_password) \- به‌روزرسانی گذرواژه در یک ریموت موجود.
.IP \[bu] 2
rclone config paths (https://rclone.org/commands/rclone_config_paths) \- نمایش مسیرهای استفاده‌شده برای پیکربندی، حافظه موقت (cache)، فایل‌های موقت (temp) و غیره.
.IP \[bu] 2
rclone config providers (https://rclone.org/commands/rclone_config_providers) \- فهرست کردن تمامی ارائه‌دهندگان و گزینه‌ها در قالب JSON.
.IP \[bu] 2
rclone config reconnect (https://rclone.org/commands/rclone_config_reconnect) \- احراز هویت مجدد کاربر با ریموت.
.IP \[bu] 2
rclone config redacted (https://rclone.org/commands/rclone_config_redacted) \- چاپ فایل پیکربندی سانسورشده (رمزگشایی‌شده)، یا پیکربندی سانسورشده برای یک ریموت منفرد.
.IP \[bu] 2
rclone config show (https://rclone.org/commands/rclone_config_show) \- چاپ فایل پیکربندی (رمزگشایی‌شده)، یا پیکربندی برای یک ریموت منفرد.
.IP \[bu] 2
rclone config string (https://rclone.org/commands/rclone_config_string) \- چاپ رشته اتصال (connection string) برای یک ریموت منفرد.
.IP \[bu] 2
rclone config touch (https://rclone.org/commands/rclone_config_touch) \- اطمینان از وجود فایل پیکربندی.
.IP \[bu] 2
rclone config unset (https://rclone.org/commands/rclone_config_unset) \- لغو تنظیم گزینه‌ها در یک ریموت موجود.
.IP \[bu] 2
rclone config update (https://rclone.org/commands/rclone_config_update) \- به‌روزرسانی گزینه‌ها در یک ریموت موجود.
.IP \[bu] 2
rclone config userinfo (https://rclone.org/commands/rclone_config_userinfo) \- چاپ اطلاعات درباره کاربر واردشده در ریموت.
.SH "rclone copy"
.PP
کپی فایل‌ها از مبدأ به مقصد، با نادیده گرفتن فایل‌های یکسان.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
مبدأ را در مقصد کپی می‌کند.
فایل‌هایی را که در مبدأ و مقصد یکسان هستند منتقل نمی‌کند؛ این بررسی بر اساس اندازه و زمان تغییر یا MD5SUM انجام می‌شود.
فایل‌ها را از مقصد حذف نمی‌کند.
اگر می‌خواهید فایل‌ها را برای تطابق با مبدأ از مقصد نیز حذف کنید، به جای آن از دستور sync (https://rclone.org/commands/rclone_sync) استفاده کنید.
.PP
توجه داشته باشید که همیشه محتویات دایرکتوری همگام‌سازی می‌شود، نه خود دایرکتوری.
بنابراین هنگامی که source:path یک دایرکتوری باشد، محتویات source:path کپی می‌شوند، نه نام دایرکتوری و محتویات آن.
.PP
برای کپی کردن تک‌فایل‌ها، به جای آن از دستور copyto (https://rclone.org/commands/rclone_copyto) استفاده کنید.
.PP
اگر dest:path وجود نداشته باشد، ایجاد شده و محتویات source:path درون آن قرار می‌گیرد.
.PP
به عنوان مثال:
.IP
.nf
\f[C]
rclone copy source:sourcepath dest:destpath
\f[R]
.fi
.PP
فرض کنید دو فایل در sourcepath وجود دارد:
.IP
.nf
\f[C]
sourcepath/one.txt
sourcepath/two.txt
\f[R]
.fi
.PP
این دستور آن‌ها را کپی می‌کند به:
.IP
.nf
\f[C]
destpath/one.txt
destpath/two.txt
\f[R]
.fi
.PP
نه به:
.IP
.nf
\f[C]
destpath/sourcepath/one.txt
destpath/sourcepath/two.txt
\f[R]
.fi
.PP
اگر با \f[V]rsync\f[R] آشنایی دارید، rclone همیشه به گونه‌ای عمل می‌کند که گویی یک \f[V]/\f[R] در انتهای مسیر قرار داده‌اید \- به این معنی که \[dq]محتویات این دایرکتوری را کپی کن\[dq].
این موضوع برای تمامی دستورها و چه در مبدأ و چه در مقصد صدق می‌کند.
.PP
برای کنترل اینکه آیا rclone دایرکتوری مقصد را فهرست کند یا خیر، گزینه --no-traverse (https://rclone.org/docs/#no-traverse) را ببینید.
ارائه این گزینه هنگام کپی کردن تعداد کمی فایل به مقصدی بزرگ می‌تواند سرعت انتقال را به شدت افزایش دهد.
.PP
به عنوان مثال، اگر فایل‌های زیادی در /path/to/src دارید اما روزانه فقط تعداد کمی از آن‌ها تغییر می‌کنند، می‌توانید همه فایل‌هایی را که اخیراً تغییر کرده‌اند به این شکل به شکلی بسیار کارآمد کپی کنید:
.IP
.nf
\f[C]
rclone copy --max-age 24h --no-traverse /path/to/src remote:
\f[R]
.fi
.PP
در صورتی که backend پشتیبانی کند، rclone زمان تغییر فایل‌ها و دایرکتوری‌ها را همگام‌سازی می‌کند.
اگر همگام‌سازی فراداده (metadata) مورد نیاز است، از پرچم \f[V]--metadata\f[R] استفاده کنید.
.PP
توجه داشته باشید که زمان تغییر و فراداده برای دایرکتوری ریشه همگام‌سازی \f[B]نخواهد\f[R] شد.
برای اطلاعات بیشتر مسئله #7652 (https://github.com/rclone/rclone/issues/7652) را ببینید.
.PP
\f[B]نکته\f[R]: از پرچم \f[V]-P\f[R]/\f[V]--progress\f[R] برای مشاهده لحظه‌ای آمار انتقال استفاده کنید.
.PP
\f[B]نکته\f[R]: از پرچم \f[V]--dry-run\f[R] یا \f[V]--interactive\f[R]/\f[V]-i\f[R] برای آزمایش عملیات بدون کپی کردن هیچ فایلی استفاده کنید..SS پرچم‌های ثبت گزارش (Logger Flags)
.PP
پرچم‌های \f[V]--differ\f[R]، \f[V]--missing-on-dst\f[R]،
\f[V]--missing-on-src\f[R]، \f[V]--match\f[R] و \f[V]--error\f[R]
مسیرها را، در هر سطر یک مسیر، در نام فایل ارائه‌شده (یا خروجی استاندارد stdout در صورتی که
\f[V]-\f[R] باشد) می‌نویسند.
آنچه آن‌ها می‌نویسند در راهنمای زیر شرح داده شده است.
به عنوان مثال، \f[V]--differ\f[R] تمام مسیرهایی را که هم در مبدأ و هم در مقصد وجود دارند
اما متفاوت هستند، خواهد نوشت.
.PP
پرچم \f[V]--combined\f[R] فایلی (یا stdout) را می‌نویسد که
شامل تمام مسیرهای فایل به همراه یک نماد، یک فاصله و سپس مسیر است
تا مشخص کند چه اتفاقی برای آن رخ داده است.
این موارد یادآور فایل‌های diff هستند.
.IP \[bu] 2
\f[V]= path\f[R] بدین معنی است که مسیر در مبدأ و مقصد یافت شد و یکسان بود
.IP \[bu] 2
\f[V]- path\f[R] بدین معنی است که مسیر در مبدأ وجود نداشت، بنابراین فقط در مقصد است
.IP \[bu] 2
\f[V]+ path\f[R] بدین معنی است که مسیر در مقصد وجود نداشت، بنابراین فقط در مبدأ است
.IP \[bu] 2
\f[V]* path\f[R] بدین معنی است که مسیر در مبدأ و مقصد وجود داشت اما متفاوت بود.
.IP \[bu] 2
\f[V]! path\f[R] بدین معنی است که در خواندن یا درهم‌سازی (هش) مبدأ یا مقصد خطایی رخ داد.
.PP
پرچم \f[V]--dest-after\f[R] یک فایل فهرست را با استفاده از همان پرچم‌های قالب‌بندی
\f[V]lsf\f[R] (https://rclone.org/commands/rclone_lsf#synopsis)
(شامل گزینه‌های قابل سفارشی‌سازی برای هش، زمان ویرایش
و غیره (https://rclone.org/commands/rclone_lsf#synopsis)) می‌نویسد. از نظر مفهومی این پرچم
مشابه \f[V]--itemize-changes\f[R] در rsync است، اما نه کاملاً یکسان
\-\- این پرچم باید فهرستی دقیق از آنچه پس از پایان دستور در مقصد خواهد بود را در خروجی ارائه دهد.
.PP
هنگامی که پرچم \f[V]--no-traverse\f[R] تنظیم شده باشد، تمام گزارش‌های مربوط به فایل‌هایی
که تنها در مقصد وجود دارند ناقص بوده یا کاملاً وجود نخواهند داشت.
.PP
توجه داشته باشید که این پرچم‌های ثبت گزارش چند محدودیت دارند و سناریوهای
خاصی در حال حاضر پشتیبانی نمی‌شوند:
.IP \[bu] 2
\f[V]--max-duration\f[R] / \f[V]CutoffModeHard\f[R]
.IP \[bu] 2
\f[V]--compare-dest\f[R] / \f[V]--copy-dest\f[R]
.IP \[bu] 2
انتقال‌های سمت سرور کل یک دایرکتوری به صورت یکجا
.IP \[bu] 2
تلاش‌های مجدد سطح بالا (High-level retries)، زیرا موارد تکراری ایجاد می‌شود (برای غیرفعال‌سازی از
\f[V]--retries 1\f[R] استفاده کنید)
.IP \[bu] 2
احتمالاً برخی سناریوهای غیرمعمول خطا
.PP
همچنین توجه داشته باشید که وضعیت هر فایل در حین اجرا ثبت می‌شود، نه پس از آن؛
بنابراین بیش از همه به عنوان پیش‌بینی‌کننده‌ای برای آنچه «باید» برای هر فایل رخ دهد مفید است
(که ممکن است با آنچه واقعاً رخ داده است مطابقت داشته باشد یا نداشته باشد).
.IP
.nf
\f[C]
rclone copy source:path dest:path [flags]
\f[R]
.fi
.SS گزینه‌ها (Options)
.IP
.nf
\f[C]
      --absolute                قرار دادن یک / در ابتدای نام مسیرها
      --combined string         ایجاد یک گزارش ترکیبی از تغییرات در این فایل
      --create-empty-src-dirs   ایجاد دایرکتوری‌های خالی مبدأ در مقصد پس از کپی
      --csv                     خروجی در قالب CSV
      --dest-after string       گزارش تمام فایل‌های موجود در مقصد پس از همگام‌سازی
      --differ string           گزارش تمام فایل‌های ناسازگار در این فایل
  -d, --dir-slash               افزودن یک اسلش به نام‌های دایرکتوری (پیش‌فرض true)
      --dirs-only               فقط فهرست کردن دایرکتوری‌ها
      --error string            گزارش تمام فایل‌های دارای خطا (درهم‌سازی یا خواندن) در این فایل
      --files-only              فقط فهرست کردن فایل‌ها (پیش‌فرض true)
  -F, --format string           قالب خروجی - برای جزئیات راهنمای lsf را ببینید (پیش‌فرض \[dq]p\[dq])
      --hash h                  استفاده از این هش هنگامی که h در قالب MD5|SHA-1|DropboxHash استفاده شده (پیش‌فرض \[dq]md5\[dq])
  -h, --help                    راهنمای copy
      --match string            گزارش تمام فایل‌های منطبق در این فایل
      --missing-on-dst string   گزارش تمام فایل‌های ناموجود در مقصد در این فایل
      --missing-on-src string   گزارش تمام فایل‌های ناموجود در مبدأ در این فایل
  -s, --separator string        جداکننده برای موارد در قالب (پیش‌فرض \[dq];\[dq])
  -t, --timeformat string       تعیین قالب زمانی سفارشی - برای جزئیات مستندات را ببینید (پیش‌فرض: 2006-01-02 15:04:05)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای مشاهده گزینه‌های عمومی که در اینجا فهرست نشده‌اند، صفحه پرچم‌های عمومی (https://rclone.org/flags)
را ببینید..SS "گزینه‌های رونوشت (Copy Options)"
.PP
پرچم‌ها برای هر دستوری که می‌تواند فایلی را رونوشت کند
.IP
.nf
\f[C]
      --check-first                                 انجام تمام بررسی‌ها پیش از آغاز انتقال‌ها
  -c, --checksum                                    بررسی تغییرات با اندازه و checksum (در صورت دسترسی، یا بازگشت به اندازه تنها)
      --compare-dest stringArray                    گنجاندن مسیرهای سمت سرور اضافی هنگام مقایسه
      --copy-dest stringArray                       به منزلهٔ --compare-dest است اما فایل‌ها را نیز از مسیرها به مقصد رونوشت می‌کند
      --cutoff-mode HARD|SOFT|CAUTIOUS              حالت توقف انتقال‌ها پس از رسیدن به حد بیشینه انتقال HARD|SOFT|CAUTIOUS (پیش‌فرض HARD)
      --ignore-case-sync                            نادیده گرفتن بزرگی و کوچکی حروف هنگام همگام‌سازی
      --ignore-checksum                             صرف‌نظر کردن از بررسی checksum پس از رونوشت
      --ignore-existing                             صرف‌نظر کردن از همه فایل‌های موجود در مقصد
      --ignore-size                                 نادیده گرفتن اندازه هنگام پرش؛ استفاده از modtime یا checksum
  -I, --ignore-times                                رد نکردن مواردی که با اندازه و زمان همخوانی دارند \- انتقال بی‌قیدوشرط همه‌چیز
      --immutable                                   دست‌نزدن به فایل‌ها؛ شکست عملیات در صورت تغییر یافتن فایل‌های موجود
      --inplace                                     بارگیری مستقیم در فایل مقصد به‌جای بارگیری اتمیک موقت و تغییر نام
  -l, --links                                       تبدیل symlinkها به/از فایل‌های معمولی با پسوند \[aq].rclonelink\[aq]
      --max-backlog int                             بیشینه تعداد اشیاء در صف همگام‌سازی یا بررسی (پیش‌فرض 10000)
      --max-duration Duration                       بیشینه مدت زمانی که rclone داده‌ها را انتقال می‌دهد (پیش‌فرض 0s)
      --max-transfer SizeSuffix                     بیشینه حجم داده برای انتقال (پیش‌فرض off)
  -M, --metadata                                    در صورت تنظیم، حفظ metadata هنگام رونوشت اشیاء
      --modify-window Duration                      بیشینه اختلاف زمانی مجاز برای یکسان تلقی شدن (پیش‌فرض 1ns)
      --multi-thread-chunk-size SizeSuffix          اندازه قطعه برای بارگیری‌ها / بارگذاری‌های چندرشته‌ای، اگر توسط فایل‌سیستم تعیین نشده باشد (پیش‌فرض 64Mi)
      --multi-thread-cutoff SizeSuffix              استفاده از بارگیری چندرشته‌ای برای فایل‌های بزرگ‌تر از این اندازه (پیش‌فرض 256Mi)
      --multi-thread-streams int                    تعداد جریان‌های مورد استفاده برای بارگیری چندرشته‌ای (پیش‌فرض 4)
      --multi-thread-write-buffer-size SizeSuffix   اندازه بافر در حافظه برای نوشتن در حالت چندرشته‌ای (پیش‌فرض 128Ki)
      --name-transform stringArray                  تبدیل مسیرها در طول فرایند رونوشت
      --no-check-dest                               بررسی نکردن مقصد؛ رونوشت در هر صورت
      --no-traverse                                 پیمایش نکردن فایل‌سیستم مقصد هنگام رونوشت
      --no-update-dir-modtime                       به‌روزرسانی نکردن زمان‌های تغییر دایرکتوری
      --no-update-modtime                           به‌روزرسانی نکردن modtime مقصد در صورت یکسان بودن فایل‌ها
      --order-by string                             دستورالعمل‌ها درباره نحوه مرتب‌سازی انتقال‌ها، مثلاً \[aq]size,descending\[aq]
      --partial-suffix string                       افزودن partial-suffix به نام فایل موقت هنگامی که --inplace استفاده نشده باشد (پیش‌فرض \[dq].partial\[dq])
      --refresh-times                               تازه‌سازی modtime فایل‌های راه دور
      --server-side-across-configs                  اجازه به عملیات‌های سمت سرور (مانند copy) برای کار بین پیکربندی‌های گوناگون
      --size-only                                   رد کردن تنها بر اساس اندازه، نه modtime یا checksum
      --streaming-upload-cutoff SizeSuffix          آستانه جابه‌جایی به بارگذاری چندبخشی در صورت نامشخص بودن اندازه فایل، بارگذاری پس از رسیدن به این حد یا پایان فایل آغاز می‌شود (پیش‌فرض 100Ki)
  -u, --update                                      رد کردن فایل‌هایی که در مقصد جدیدتر هستند
\f[R]
.fi
.SS "گزینه‌های مهم (Important Options)"
.PP
پرچم‌های مهم و کاربردی برای بیشتر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ خروجی با جزئیات بسیار بیشتر (تکرار برای جزئیات بیشتر)
\f[R]
.fi
.SS "گزینه‌های پالایش (Filter Options)"
.PP
پرچم‌ها برای پالایش فهرست‌بندی دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از \- برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود filename
      --files-from stringArray              خواندن فهرست نام فایل‌های مبدأ از فایل (استفاده از \- برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از فایل بدون هیچ‌گونه پردازش روی خط‌ها (استفاده از \- برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ از فایل با جداکننده NUL (استفاده از \- برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قاعده پالایش فایل
      --filter-from stringArray             خواندن الگوهای پالایش فایل از یک فایل (استفاده از \- برای خواندن از stdin)
      --hash-filter string                  افراز نام فایل‌ها با هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در پالایه‌ها (غیرحساس به بزرگی و کوچکی)
      --include stringArray                 گنجاندن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از \- برای خواندن از stdin)
      --max-age Duration                    تنها انتقال فایل‌های جدیدتر از این مقدار بر حسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض \-1)
      --max-size SizeSuffix                 تنها انتقال فایل‌های کوچک‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض off)
      --metadata-exclude stringArray        مستثنی کردن فراداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای فراداده از فایل (استفاده از \- برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قاعده پالایش فراداده
      --metadata-filter-from stringArray    خواندن الگوهای پالایش فراداده از یک فایل (استفاده از \- برای خواندن از stdin)
      --metadata-include stringArray        گنجاندن فراداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول فراداده از فایل (استفاده از \- برای خواندن از stdin)
      --min-age Duration                    تنها انتقال فایل‌های قدیمی‌تر از این مقدار بر حسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --min-size SizeSuffix                 تنها انتقال فایل‌های بزرگ‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض off)
\f[R]
.fi.SS "گزینه‌های فهرست‌بندی (Listing Options)"
.PP
پرچم‌ها برای فهرست کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت موجود بودن؛ حافظه بیشتر اما تراکنش‌های کمتری مصرف می‌کند
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH "rclone sync"
.PP
یکسان‌سازی مبدأ و مقصد، فقط با تغییر دادن مقصد.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
همگام‌سازی مبدأ با مقصد، تنها با تغییر دادن مقصد.
فایل‌هایی را که در مبدأ و مقصد یکسان هستند منتقل نمی‌کند؛ این بررسی از طریق اندازه و زمان تغییر (modtime) یا MD5SUM انجام می‌شود.
مقصد برای مطابقت با مبدأ به‌روزرسانی می‌شود، از جمله در صورت لزوم حذف فایل‌ها (به جز اشیاء تکراری، به زیر مراجعه کنید).
اگر نمی‌خواهید فایل‌ها از مقصد حذف شوند، به جای آن از دستور copy (https://rclone.org/commands/rclone_copy) استفاده کنید.
.PP
\f[B]مهم\f[R]: از آنجا که این کار می‌تواند موجب از دست رفتن داده‌ها شود، ابتدا با پرچم \f[V]--dry-run\f[R] یا \f[V]--interactive\f[R]/\f[V]i\f[R] آزمایش کنید.
.IP
.nf
\f[C]
rclone sync --interactive SOURCE remote:DESTINATION
\f[R]
.fi
.PP
فایل‌های موجود در مقصد در صورت وقوع هرگونه خطا در هر مرحله حذف نخواهند شد.
اشیاء تکراری (فایل‌هایی با نام یکسان، در ارائه‌دهندگانی که از آن پشتیبانی می‌کنند) هنوز مدیریت نمی‌شوند.
فایل‌هایی که مستثنی شده‌اند (excluded) حذف نخواهند شد مگر اینکه از \f[V]--delete-excluded\f[R] استفاده شود.
پیوندهای نمادین (symlinks) از فایل‌سیستم‌های محلی منتقل یا حذف نخواهند شد مگر اینکه از \f[V]--links\f[R] استفاده شود.
.PP
همواره محتوای دایرکتوری همگام‌سازی می‌شود، نه خود دایرکتوری.
بنابراین هنگامی که source:path یک دایرکتوری است، این محتوای source:path است که کپی می‌شود، نه نام و محتوای دایرکتوری.
در صورت عدم اطمینان، توضیحات تکمیلی را در دستور copy (https://rclone.org/commands/rclone_copy) ببینید.
.PP
اگر dest:path وجود نداشته باشد، ایجاد شده و محتوای source:path در آن قرار می‌گیرد.
.PP
همگام‌سازی remoteهای هم‌پوشان (overlapping) امکان‌پذیر نیست.
با این حال، می‌توانید مقصد را با یک قانون فیلتر از همگام‌سازی مستثنی کنید یا با قرار دادن یک فایل exclude-if-present در داخل دایرکتوری مقصد، به مقصدی که در داخل دایرکتوری مبدأ قرار دارد همگام‌سازی را انجام دهید.
.PP
اگر backend از آن پشتیبانی کند، Rclone زمان‌های تغییر (modification times) فایل‌ها و دایرکتوری‌ها را همگام‌سازی خواهد کرد.
اگر همگام‌سازی متادیتا (metadata) مورد نیاز است، از پرچم \f[V]--metadata\f[R] استفاده کنید.
.PP
توجه داشته باشید که زمان تغییر و متادیتا برای دایرکتوری ریشه همگام‌سازی \f[B]نخواهد شد\f[R].
برای اطلاعات بیشتر <https://github.com/rclone/rclone/issues/7652> را ببینید.
.PP
\f[B]نکته\f[R]: برای مشاهده آمار بلادرنگ انتقال، از پرچم \f[V]-P\f[R]/\f[V]--progress\f[R] استفاده کنید.
.PP
\f[B]نکته\f[R]: برای مواجهه با خطاهای \[dq]Duplicate object/directory found in source/destination - ignoring\[dq] از دستور \f[V]rclone dedupe\f[R] استفاده کنید.
برای اطلاعات بیشتر این پست تالار گفت‌وگو (https://forum.rclone.org/t/sync-not-clearing-duplicates/14372) را ببینید.
.SS "پرچم‌های ثبت لاگ (Logger Flags)"
.PP
پرچم‌های \f[V]--differ\f[R]، \f[V]--missing-on-dst\f[R]، \f[V]--missing-on-src\f[R]، \f[V]--match\f[R] و \f[V]--error\f[R] مسیرها را به‌صورت خط‌به‌خط در نام فایل داده‌شده (یا اگر \f[V]-\f[R] باشد در خروجی استاندارد stdout) می‌نویسند.
آنچه آن‌ها می‌نویسند در راهنمای زیر شرح داده شده است.
برای مثال \f[V]--differ\f[R] تمام مسیرهایی را که در هر دو مبدأ و مقصد وجود دارند اما متفاوت هستند می‌نویسد.
.PP
پرچم \f[V]--combined\f[R] فایلی (یا stdout) را می‌نویسد که شامل تمام مسیرهای فایل‌ها است همراه با یک نماد و سپس یک فاصله و پس از آن مسیر، تا به شما بگوید چه اتفاقی برای آن افتاده است.
این موارد یادآور فایل‌های diff هستند.
.IP \[bu] 2
\f[V]= path\f[R] بدان معناست که path در مبدأ و مقصد پیدا شد و یکسان بود
.IP \[bu] 2
\f[V]- path\f[R] بدان معناست که path در مبدأ موجود نبود، بنابراین فقط در مقصد است
.IP \[bu] 2
\f[V]+ path\f[R] بدان معناست که path در مقصد موجود نبود، بنابراین فقط در مبدأ است
.IP \[bu] 2
\f[V]* path\f[R] بدان معناست که path در مبدأ و مقصد موجود بود اما تفاوت داشت.
.IP \[bu] 2
\f[V]! path\f[R] بدان معناست که در خواندن یا محاسبه هش مبدأ یا مقصد خطایی رخ داده است.
.PP
پرچم \f[V]--dest-after\f[R] یک فایل فهرست را با استفاده از همان پرچم‌های قالب‌بندیِ \f[V]lsf\f[R] (https://rclone.org/commands/rclone_lsf/#synopsis) می‌نویسد (شامل گزینه‌های قابل‌تنظیم برای hash، modtime، و غیره (https://rclone.org/commands/rclone_lsf/#synopsis)). از لحاظ مفهومی شبیه به \f[V]--itemize-changes\f[R] در rsync است، اما یکسان نیست -- این پرچم باید فهرست دقیقی از آنچه را که پس از پایان دستور در مقصد خواهد بود خروجی دهد.
.PP
هنگامی که پرچم \f[V]--no-traverse\f[R] تنظیم شده باشد، تمام گزارش‌های مربوط به فایل‌هایی که فقط در مقصد وجود دارند ناقص بوده یا کاملاً وجود نخواهند داشت.
.PP
توجه داشته باشید که این پرچم‌های ثبت لاگ دارای چند محدودیت هستند و سناریوهای خاصی در حال حاضر پشتیبانی نمی‌شوند:
.IP \[bu] 2
\f[V]--max-duration\f[R] / \f[V]CutoffModeHard\f[R]
.IP \[bu] 2
\f[V]--compare-dest\f[R] / \f[V]--copy-dest\f[R]
.IP \[bu] 2
انتقال‌های سمت سرور برای یک دایرکتوری کامل به‌صورت یک‌جا
.IP \[bu] 2
تلاش‌های مجدد در سطح بالا (High-level retries)، زیرا موارد تکراری ایجاد خواهد شد (برای غیرفعال کردن از \f[V]--retries 1\f[R] استفاده کنید)
.IP \[bu] 2
احتمالاً برخی از سناریوهای خطای نامعمول
.PP
همچنین توجه داشته باشید که هر فایل در حین اجرا در لاگ ثبت می‌شود، بر خلاف پس از آن؛ بنابراین به عنوان پیش‌بینی‌کننده‌ای از آنچه «باید» برای هر فایل رخ دهد بیشترین کاربرد را دارد (که ممکن است با آنچه در عمل «رخ داده» مطابقت داشته باشد یا نداشته باشد).
.IP
.nf
\f[C]
rclone sync source:path dest:path [flags]
\f[R]
.fi.SS "گزینه‌ها (Options)"
.IP
.nf
\f[C]
      --absolute                قرار دادن یک / در ابتدای نام مسیرها
      --combined string         ایجاد گزارش ترکیبی از تغییرات در این فایل
      --create-empty-src-dirs   ایجاد دایرکتوری‌های خالی مبدأ در مقصد پس از همگام‌سازی
      --csv                     خروجی در قالب CSV
      --dest-after string       گزارش تمام فایل‌های موجود در مقصد پس از همگام‌سازی در این فایل
      --differ string           گزارش تمام فایل‌های ناهمخوان در این فایل
  -d, --dir-slash               افزودن اسلش به انتهای نام دایرکتوری‌ها (پیش‌فرض true)
      --dirs-only               تنها فهرست کردن دایرکتوری‌ها
      --error string            گزارش تمام فایل‌های دارای خطا (در هش یا خواندن) در این فایل
      --files-only              تنها فهرست کردن فایل‌ها (پیش‌فرض true)
  -F, --format string           قالب خروجی \- برای جزئیات راهنمای lsf را ببینید (پیش‌فرض \[dq]p\[dq])
      --hash h                  استفاده از این هش هنگامی که h در قالب به کار رفته است MD5|SHA-1|DropboxHash (پیش‌فرض \[dq]md5\[dq])
  -h, --help                    راهنما برای sync
      --match string            گزارش تمام فایل‌های منطبق در این فایل
      --missing-on-dst string   گزارش تمام فایل‌های ناموجود در مقصد در این فایل
      --missing-on-src string   گزارش تمام فایل‌های ناموجود در مبدأ در این فایل
  -s, --separator string        جداکننده موارد در قالب (پیش‌فرض \[dq];\[dq])
  -t, --timeformat string       تعیین قالب زمانی سفارشی \- برای جزئیات مستندات را ببینید (پیش‌فرض: 2006-01-02 15:04:05)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری
(https://rclone.org/flags) را ببینید.
.SS "گزینه‌های رونوشت (Copy Options)"
.PP
پرچم‌ها برای هر دستوری که می‌تواند فایلی را کپی کند
.IP
.nf
\f[C]
      --check-first                                 انجام تمام بررسی‌ها پیش از آغاز انتقال‌ها
  -c, --checksum                                    بررسی تغییرات با اندازه و چکسام (در صورت در دسترس بودن، یا رجوع به اندازه به تنهایی)
      --compare-dest stringArray                    شامل کردن مسیرهای سروری بیشتر هنگام مقایسه
      --copy-dest stringArray                       به معنی --compare-dest است اما فایل‌ها را نیز از مسیرها به مقصد کپی می‌کند
      --cutoff-mode HARD|SOFT|CAUTIOUS              حالت توقف انتقال‌ها پس از رسیدن به حد نهایی انتقال HARD|SOFT|CAUTIOUS (پیش‌فرض HARD)
      --ignore-case-sync                            نادیده گرفتن کوچکی و بزرگی حروف در هنگام همگام‌سازی
      --ignore-checksum                             صرف‌نظر از بررسی چکسام‌ها پس از رونوشت
      --ignore-existing                             صرف‌نظر از تمام فایل‌های موجود در مقصد
      --ignore-size                                 نادیده گرفتن اندازه هنگام رد کردن؛ استفاده از modtime یا چکسام
  -I, --ignore-times                                صرف‌نظر نکردن از مواردی که در اندازه و زمان تطابق دارند \- انتقال همه بدون قید و شرط
      --immutable                                   عدم تغییر فایل‌ها؛ در صورتی که فایل‌های موجود تغییر کرده باشند با خطا مواجه شود
      --inplace                                     بارگیری مستقیم در فایل مقصد به جای بارگیری اتمیک در فایل موقت و تغییر نام
  -l, --links                                       تبدیل پیوندهای نمادین به/از فایل‌های معمولی با پسوند \[aq].rclonelink\[aq]
      --max-backlog int                             حداکثر تعداد اشیاء در صف همگام‌سازی یا بررسی (پیش‌فرض 10000)
      --max-duration Duration                       حداکثر مدتی که rclone داده‌ها را منتقل می‌کند (پیش‌فرض 0s)
      --max-transfer SizeSuffix                     حداکثر حجم داده برای انتقال (پیش‌فرض off)
  -M, --metadata                                    در صورت تنظیم، حفظ فراداده هنگام رونوشت اشیاء
      --modify-window Duration                      حداکثر اختلاف زمانی برای یکسان در نظر گرفته شدن (پیش‌فرض 1ns)
      --multi-thread-chunk-size SizeSuffix          اندازه قطعه برای بارگیری/بارگذاری چندرشته‌ای، اگر توسط سیستم فایل تعیین نشده باشد (پیش‌فرض 64Mi)
      --multi-thread-cutoff SizeSuffix              استفاده از بارگیری چندرشته‌ای برای فایل‌های بالاتر از این اندازه (پیش‌فرض 256Mi)
      --multi-thread-streams int                    تعداد جریان‌ها برای استفاده در بارگیری‌های چندرشته‌ای (پیش‌فرض 4)
      --multi-thread-write-buffer-size SizeSuffix   اندازه بافر در حافظه برای نوشتن در حالت چندرشته‌ای (پیش‌فرض 128Ki)
      --name-transform stringArray                  تبدیل مسیرها در طول فرایند کپی
      --no-check-dest                               عدم بررسی مقصد؛ کپی در هر حالت
      --no-traverse                                 عدم پیمایش سیستم فایل مقصد هنگام رونوشت
      --no-update-dir-modtime                       عدم به‌روزرسانی زمان‌های ویرایش دایرکتوری
      --no-update-modtime                           عدم به‌روزرسانی modtime مقصد در صورت یکسان بودن فایل‌ها
      --order-by string                             دستورالعمل‌ها درباره نحوه اولویت‌بندی انتقال‌ها، مثلاً \[aq]size,descending\[aq]
      --partial-suffix string                       افزودن partial-suffix به نام فایل موقت هنگامی که --inplace استفاده نشده باشد (پیش‌فرض \[dq].partial\[dq])
      --refresh-times                               تازه‌سازی modtime فایل‌های دوردست
      --server-side-across-configs                  اجازه دادن به عملیات سمت سرور (مانند رونوشت) برای کار بین پیکربندی‌های گوناگون
      --size-only                                   صرف‌نظر کردن تنها بر اساس اندازه، نه modtime یا چکسام
      --streaming-upload-cutoff SizeSuffix          آستانه جابجایی به بارگذاری قطعه‌ای در صورت نامشخص بودن اندازه فایل، بارگذاری پس از رسیدن به آستانه یا پایان فایل آغاز می‌شود (پیش‌فرض 100Ki)
  -u, --update                                      صرف‌نظر از فایل‌هایی که روی مقصد جدیدتر هستند
\f[R]
.fi
.SS "گزینه‌های همگام‌سازی (Sync Options)"
.PP
پرچم‌های مورد استفاده برای دستورهای همگام‌سازی (sync)
.IP
.nf
\f[C]
      --backup-dir string               تهیه نسخه پشتیبان در سلسله‌مراتب مبتنی بر DIR
      --delete-after                    هنگام همگام‌سازی، حذف فایل‌ها در مقصد پس از انتقال (پیش‌فرض)
      --delete-before                   هنگام همگام‌سازی، حذف فایل‌ها در مقصد پیش از انتقال
      --delete-during                   هنگام همگام‌سازی، حذف فایل‌ها در حین انتقال
      --fix-case                        تغییر نام اجباری مقصد حساس‌نبودن‌به‌حروف برای تطابق با مبدأ
      --ignore-errors                   حذف حتی در صورت وجود خطاهای I/O
      --list-cutoff int                 برای صرفه‌جویی در حافظه، مرتب‌سازی فهرست‌های دایرکتوری روی دیسک بالاتر از این آستانه (پیش‌فرض 1000000)
      --max-delete int                  هنگام همگام‌سازی، محدود کردن تعداد حذف‌ها (پیش‌فرض -1)
      --max-delete-size SizeSuffix      هنگام همگام‌سازی، محدود کردن حجم کل حذف‌ها (پیش‌فرض off)
      --suffix string                   پسوند برای افزودن به فایل‌های تغییریافته
      --suffix-keep-extension           حفظ پسوند فایل هنگام استفاده از --suffix
      --track-renames                   هنگام همگام‌سازی، ردیابی تغییر نام فایل‌ها و انجام انتقال سمت سرور در صورت امکان
      --track-renames-strategy string   راهبردهای مورد استفاده هنگام همگام‌سازی با استفاده از track-renames به صورت hash|modtime|leaf (پیش‌فرض \[dq]hash\[dq])
\f[R]
.fi.SS گزینه‌های مهم
.PP
پرچم‌های مهم و کاربردی برای بیشتر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         انجام یک اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ خروجی بسیار بیشتر (برای جزئیات بیشتر تکرار کنید)
\f[R]
.fi
.SS گزینه‌های فیلتر
.PP
پرچم‌هایی برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از - برای stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود filename
      --files-from stringArray              خواندن فهرست نام‌های فایل مبدأ از فایل (استفاده از - برای stdin)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل مبدأ از فایل بدون پردازش خطوط (استفاده از - برای stdin)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل مبدأ از فایل با جداکننده NUL (استفاده از - برای stdin)
  -f, --filter stringArray                  افزودن یک قاعده فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (استفاده از - برای stdin)
      --hash-filter string                  افراز نام‌های فایل بر اساس هش k/n یا تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (ناحساس به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از - برای stdin)
      --max-age Duration                    انتقال تنها فایل‌های تازه‌تر از این مقدار برحسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تنظیم، محدود کردن عمق بازگشت به این مقدار (پیش‌فرض -1)
      --max-size SizeSuffix                 انتقال تنها فایل‌های کوچک‌تر از این مقدار برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنی کردن فراداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای فراداده از فایل (استفاده از - برای stdin)
      --metadata-filter stringArray         افزودن یک قاعده فیلتر کردن فراداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن فراداده از یک فایل (استفاده از - برای stdin)
      --metadata-include stringArray        شامل کردن فراداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول فراداده از فایل (استفاده از - برای stdin)
      --min-age Duration                    انتقال تنها فایل‌های قدیمی‌تر از این مقدار برحسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 انتقال تنها فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS گزینه‌های فهرست‌بندی
.PP
پرچم‌هایی برای فهرست کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمانی که باید در صورت نامشخص بودن modtime فایل‌ها و دایرکتوری‌ها نشان داده شود (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست بازگشتی در صورت وجود؛ مصرف حافظه بیشتر اما تراکنش‌های کمتر
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (<https://rclone.org/commands/rclone>) \- نمایش راهنما برای دستورها، پرچم‌ها و بک‌اند‌های rclone.
.SH rclone move
.PP
انتقال فایل‌ها از source به dest.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
محتویات دایرکتوری مبدأ را به دایرکتوری مقصد منتقل می‌کند.
در صورتی که مبدأ و مقصد هم‌پوشانی داشته باشند و ریموت از عملیات انتقال دایرکتوری سمت سرور پشتیبانی نکند، rclone با خطا مواجه خواهد شد.
.PP
برای انتقال فایل‌های تکی، در عوض از دستور
moveto (<https://rclone.org/commands/rclone_moveto>) استفاده کنید.
.PP
اگر هیچ فیلتری استفاده نشود و در صورت امکان، این دستور \f[V]source:path\f[R] را به‌صورت سمت سرور به \f[V]dest:path\f[R] منتقل می‌کند.
پس از این، \f[V]source:path\f[R] دیگر وجود نخواهد داشت.
.PP
در غیر این صورت، برای هر فایل در \f[V]source:path\f[R] که توسط فیلترها (در صورت وجود) انتخاب شده باشد، آن را به \f[V]dest:path\f[R] منتقل می‌کند.
در صورت امکان، از انتقال سمت سرور استفاده خواهد شد؛ در غیر این صورت، آن را (در صورت امکان به‌صورت سمت سرور) به \f[V]dest:path\f[R] کپی کرده و سپس فایل اصلی را (در صورت عدم بروز خطا در کپی) در \f[V]source:path\f[R] حذف می‌کند.
.PP
اگر می‌خواهید دایرکتوری‌های خالی مبدأ پس از انتقال حذف شوند، از پرچم
\f[V]--delete-empty-src-dirs\f[R] استفاده کنید.
.PP
برای کنترل اینکه آیا rclone دایرکتوری مقصد را فهرست‌بندی کند یا خیر، گزینه
--no-traverse (<https://rclone.org/docs/#no-traverse>) را ببینید.
ارائه این گزینه هنگام انتقال تعداد کمی فایل به یک مقصد بزرگ می‌تواند سرعت انتقال را به میزان چشمگیری افزایش دهد.
.PP
در صورتی که بک‌اند پشتیبانی کند، rclone زمان‌های ویرایش فایل‌ها و دایرکتوری‌ها را همگام‌سازی می‌کند.
اگر همگام‌سازی فراداده نیاز باشد، از پرچم \f[V]--metadata\f[R] استفاده کنید.
.PP
توجه داشته باشید که زمان ویرایش و فراداده برای دایرکتوری ریشه همگام‌سازی \f[B]نخواهد شد\f[R].
برای اطلاعات بیشتر <https://github.com/rclone/rclone/issues/7652> را ببینید.
.PP
\f[B]مهم\f[R]: از آنجا که این عملیات می‌تواند باعث از دست رفتن داده‌ها شود، ابتدا با پرچم
\f[V]--dry-run\f[R] یا \f[V]--interactive\f[R]/\f[V]-i\f[R] آن را آزمایش کنید.
.PP
\f[B]نکته\f[R]: برای مشاهده آمار لحظه‌ای انتقال از پرچم
\f[V]-P\f[R]/\f[V]--progress\f[R] استفاده کنید..SS پرچم‌های ثبت گزارش (Logger Flags)
.PP
پرچم‌های \f[V]--differ\f[R]، \f[V]--missing-on-dst\f[R]،
\f[V]--missing-on-src\f[R]، \f[V]--match\f[R] و \f[V]--error\f[R]
مسیرها را به‌صورت یک مسیر در هر خط، در نام فایل ارائه‌شده (یا اگر
\f[V]-\f[R] باشد در خروجی استاندارد stdout) می‌نویسند.
آنچه می‌نویسند در راهنمای زیر شرح داده شده است.
برای نمونه \f[V]--differ\f[R] تمام مسیرهایی را که در هر دو مبدأ و
مقصد وجود دارند اما متفاوت هستند می‌نویسد.
.PP
پرچم \f[V]--combined\f[R] فایلی (یا stdout) را می‌نویسد که
شامل تمام مسیرهای فایل به همراه یک نماد، سپس یک فاصله و سپس مسیر است
تا مشخص کند چه بر سر آن آمده است.
این موارد یادآور فایل‌های diff هستند.
.IP \[bu] 2
\f[V]= path\f[R] یعنی مسیر در مبدأ و مقصد یافت شد و یکسان
بود
.IP \[bu] 2
\f[V]- path\f[R] یعنی مسیر در مبدأ وجود نداشت، بنابراین فقط در
مقصد است
.IP \[bu] 2
\f[V]+ path\f[R] یعنی مسیر در مقصد وجود نداشت، بنابراین فقط در
مبدأ است
.IP \[bu] 2
\f[V]* path\f[R] یعنی مسیر در مبدأ و مقصد وجود داشت اما
متفاوت بود.
.IP \[bu] 2
\f[V]! path\f[R] یعنی خطایی در خواندن یا درهم‌سازی (هش کردن) مبدأ
یا مقصد رخ داده است.
.PP
پرچم \f[V]--dest-after\f[R] یک فایل فهرست را با استفاده از همان پرچم‌های قالب‌بندی
\f[V]lsf\f[R] (https://rclone.org/commands/rclone_lsf/#synopsis)
می‌نویسد (شامل گزینه‌های قابل‌تنظیم برای hash، modtime،
و غیره (https://rclone.org/commands/rclone_lsf/#synopsis)). از نظر مفهومی
مشابه \f[V]--itemize-changes\f[R] در rsync است، اما نه کاملاً یکسان
\-\- این پرچم باید فهرستی دقیق از آنچه پس از پایان دستور در مقصد خواهد بود ارائه دهد.
.PP
هنگامی که پرچم \f[V]--no-traverse\f[R] تنظیم شده باشد، تمام گزارش‌های مربوط به فایل‌هایی
که تنها در مقصد وجود دارند ناقص بوده یا به‌طور کامل وجود
نخواهند داشت.
.PP
توجه داشته باشید که این پرچم‌های ثبت گزارش محدودیت‌هایی دارند و سناریوهای
خاصی در حال حاضر پشتیبانی نمی‌شوند:
.IP \[bu] 2
\f[V]--max-duration\f[R] / \f[V]CutoffModeHard\f[R]
.IP \[bu] 2
\f[V]--compare-dest\f[R] / \f[V]--copy-dest\f[R]
.IP \[bu] 2
انتقال‌های سمت سرور یک دایرکتوری به‌طور کامل در یک نوبت
.IP \[bu] 2
تلاش‌های مجدد در سطح بالا (High-level retries)، زیرا موارد تکراری ایجاد خواهد شد (از
\f[V]--retries 1\f[R] برای غیرفعال‌سازی استفاده کنید)
.IP \[bu] 2
احتمالاً برخی سناریوهای خطای نامعمول
.PP
همچنین توجه داشته باشید که هر فایل در حین اجرا ثبت می‌شود، نه پس از
آن، بنابراین بیشتر به عنوان پیش‌بینی‌کننده‌ای برای آنچه «باید» برای هر
فایل رخ دهد مفید است (که ممکن است با آنچه واقعاً رخ داده مطابقت داشته باشد یا خیر).
.IP
.nf
\f[C]
rclone move source:path dest:path [flags]
\f[R]
.fi
.SS گزینه‌ها (Options)
.IP
.nf
\f[C]
      --absolute                قرار دادن یک / در ابتدای نام مسیرها
      --combined string         ایجاد یک گزارش ترکیبی از تغییرات در این فایل
      --create-empty-src-dirs   ایجاد دایرکتوری‌های خالی مبدأ در مقصد پس از انتقال
      --csv                     خروجی در قالب CSV
      --delete-empty-src-dirs   حذف دایرکتوری‌های خالی مبدأ پس از انتقال
      --dest-after string       گزارش تمام فایل‌های موجود در مقصد پس از همگام‌سازی
      --differ string           گزارش تمام فایل‌های نامطابق در این فایل
  -d, --dir-slash               افزودن یک اسلش به انتهای نام دایرکتوری‌ها (پیش‌فرض true)
      --dirs-only               تنها فهرست کردن دایرکتوری‌ها
      --error string            گزارش تمام فایل‌های دارای خطا (درهم‌سازی یا خواندن) در این فایل
      --files-only              تنها فهرست کردن فایل‌ها (پیش‌فرض true)
  -F, --format string           قالب خروجی - برای جزئیات راهنمای lsf را ببینید (پیش‌فرض \[dq]p\[dq])
      --hash h                  استفاده از این هش هنگامی که h در قالب استفاده می‌شود: MD5|SHA-1|DropboxHash (پیش‌فرض \[dq]md5\[dq])
  -h, --help                    راهنمای دستور move
      --match string            گزارش تمام فایل‌های مطابق در این فایل
      --missing-on-dst string   گزارش تمام فایل‌های ناموجود در مقصد در این فایل
      --missing-on-src string   گزارش تمام فایل‌های ناموجود در مبدأ در این فایل
  -s, --separator string        جداکننده برای موارد موجود در قالب (پیش‌فرض \[dq];\[dq])
  -t, --timeformat string       تعیین یک قالب زمان سفارشی - برای جزئیات به اسناد مراجعه کنید (پیش‌فرض: 2006-01-02 15:04:05)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا ذکر نشده‌اند، به صفحه پرچم‌های سراسری
(https://rclone.org/flags) مراجعه کنید..SS "گزینه‌های کپی (Copy Options)"
.PP
پرچم‌ها برای هر فرمانی که می‌تواند فایلی را کپی کند
.IP
.nf
\f[C]
      --check-first                                 انجام تمام بررسی‌ها پیش از آغاز انتقال‌ها
  -c, --checksum                                    بررسی تغییرات با اندازه و checksum (در صورت وجود، یا بازگشت به فقط اندازه)
      --compare-dest stringArray                    شامل کردن مسیرهای سمت سرور اضافی در حین مقایسه
      --copy-dest stringArray                       ضمن اعمال --compare-dest، فایل‌ها را از مسیرها به مقصد نیز کپی می‌کند
      --cutoff-mode HARD|SOFT|CAUTIOUS              حالت متوقف کردن انتقال هنگام رسیدن به سقف انتقال: HARD|SOFT|CAUTIOUS (پیش‌فرض HARD)
      --ignore-case-sync                            نادیده گرفتن بزرگی و کوچکی حروف هنگام همگام‌سازی
      --ignore-checksum                             صرف‌نظر از بررسی checksum پس از کپی
      --ignore-existing                             صرف‌نظر از تمام فایل‌های موجود در مقصد
      --ignore-size                                 نادیده گرفتن اندازه هنگام صرف‌نظر کردن؛ استفاده از modtime یا checksum
  -I, --ignore-times                                نادیده نگرفتن مواردی که اندازه و زمان یکسان دارند - انتقال همه‌چیز بدون قید و شرط
      --immutable                                   دستکاری نکردن فایل‌ها، اعلام خطا در صورت تغییر یافتن فایل‌های موجود
      --inplace                                     بارگیری مستقیم در فایل مقصد به‌جای بارگیری اتمیک در فایل موقت/تغییر نام
  -l, --links                                       تبدیل symlinkها به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq]
      --max-backlog int                             حداکثر تعداد اشیاء در صف همگام‌سازی یا بررسی (پیش‌فرض 10000)
      --max-duration Duration                       حداکثر مدت زمانی که rclone داده‌ها را انتقال می‌دهد (پیش‌فرض 0s)
      --max-transfer SizeSuffix                     حداکثر حجم داده برای انتقال (پیش‌فرض off)
  -M, --metadata                                    در صورت تنظیم، حفظ متادیتا هنگام کپی اشیاء
      --modify-window Duration                      حداکثر اختلاف زمانی برای یکسان در نظر گرفتن (پیش‌فرض 1ns)
      --multi-thread-chunk-size SizeSuffix          اندازه قطعه برای بارگیری/بارگذاری چندرشته‌ای، اگر توسط سیستم‌فایل تعیین نشده باشد (پیش‌فرض 64Mi)
      --multi-thread-cutoff SizeSuffix              استفاده از بارگیری چندرشته‌ای برای فایل‌های بزرگ‌تر از این اندازه (پیش‌فرض 256Mi)
      --multi-thread-streams int                    تعداد جریان‌ها (streams) برای استفاده در بارگیری چندرشته‌ای (پیش‌فرض 4)
      --multi-thread-write-buffer-size SizeSuffix   اندازه بافر حافظه برای نوشتن در حالت چندرشته‌ای (پیش‌فرض 128Ki)
      --name-transform stringArray                  تغییر شکل مسیرها در طول فرایند کپی
      --no-check-dest                               مقصد بررسی نشود، کپی در هر صورت انجام پذیرد
      --no-traverse                                 عدم پیمایش سیستم‌فایل مقصد هنگام کپی
      --no-update-dir-modtime                       عدم به‌روزرسانی زمان تغییر دایرکتوری‌ها
      --no-update-modtime                           عدم به‌روزرسانی modtime مقصد در صورت یکسان بودن فایل‌ها
      --order-by string                             دستورالعمل نحوه مرتب‌سازی انتقال‌ها، مثلاً \[aq]size,descending\[aq]
      --partial-suffix string                       افزودن partial-suffix به نام فایل موقت وقتی از --inplace استفاده نمی‌شود (پیش‌فرض \[dq].partial\[dq])
      --refresh-times                               تازه‌سازی modtime فایل‌های ریموت
      --server-side-across-configs                  اجازه دادن به عملیات‌های سمت سرور (مانند کپی) برای کار در میان کانفیگ‌های مختلف
      --size-only                                   صرف‌نظر کردن تنها بر اساس اندازه، نه modtime یا checksum
      --streaming-upload-cutoff SizeSuffix          آستانه جابجایی به بارگذاری قطعه‌ای در صورت نامشخص بودن اندازه فایل (پیش‌فرض 100Ki)
  -u, --update                                      صرف‌نظر کردن از فایل‌هایی که در مقصد تازه‌تر هستند
\f[R]
.fi
.SS "گزینه‌های مهم (Important Options)"
.PP
پرچم‌های مهم و کاربردی برای اکثر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ اطلاعات بسیار بیشتر (تکرار برای جزئیات بیشتر)
\f[R]
.fi
.SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌هایی برای فیلتر کردن فهرست‌بندی دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از - برای stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود این نام فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل‌های مبدأ از فایل (استفاده از - برای stdin)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل‌های مبدأ از فایل بدون هیچ پردازشی روی خط‌ها (استفاده از - برای stdin)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل‌های مبدأ از فایل با جداکننده NUL (استفاده از - برای stdin)
  -f, --filter stringArray                  افزودن یک قاعده فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (استفاده از - برای stdin)
      --hash-filter string                  افراز نام فایل‌ها با هش k/n یا به‌صورت تصادفی با \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (ناحساس به بزرگی و کوچکی)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از - برای stdin)
      --max-age Duration                    تنها انتقال فایل‌های جدیدتر از این مقدار برحسب s یا پسوندهای ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 تنها انتقال فایل‌های کوچک‌تر از این مقدار برحسب KiB یا پسوندهای B|K|M|G|T|P (پیش‌فرض off)
      --metadata-exclude stringArray        مستثنی کردن متادیتای منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متادیتا از فایل (استفاده از - برای stdin)
      --metadata-filter stringArray         افزودن یک قاعده فیلتر کردن متادیتا
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متادیتا از یک فایل (استفاده از - برای stdin)
      --metadata-include stringArray        شامل کردن متادیتای منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متادیتا از فایل (استفاده از - برای stdin)
      --min-age Duration                    تنها انتقال فایل‌های قدیمی‌تر از این مقدار برحسب s یا پسوندهای ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --min-size SizeSuffix                 تنها انتقال فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا پسوندهای B|K|M|G|T|P (پیش‌فرض off)
\f[R]
.fi.SS گزینه‌های فهرست‌بندی (Listing Options)
.PP
پرچم‌های فهرست کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمانی که اگر modtime برای فایل‌ها و دایرکتوری‌ها نامشخص بود نمایش داده شود (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت در دسترس بودن؛ حافظه بیشتر اما تراکنش‌های کمتری مصرف می‌کند
\f[R]
.fi
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone delete
.PP
حذف فایل‌های موجود در مسیر.
.SS خلاصه دستور (SYNOPSIS)
.PP
حذف فایل‌های موجود در مسیر.
برخلاف purge (https://rclone.org/commands/rclone_purge)، این دستور از فیلترهای include/exclude پیروی می‌کند؛ بنابراین می‌توان از آن برای حذف انتخابی فایل‌ها استفاده کرد.
.PP
دستور \f[V]rclone delete\f[R] فقط فایل‌ها را حذف می‌کند و به ساختار دایرکتوری دست نمی‌زند.
اگر می‌خواهید یک دایرکتوری و تمام محتویات آن را حذف کنید، از دستور purge (https://rclone.org/commands/rclone_purge) استفاده کنید.
.PP
اگر پرچم \f[V]--rmdirs\f[R] را مشخص کنید، تمام دایرکتوری‌های خالی را نیز به همراه آن حذف خواهد کرد.
همچنین می‌توانید از دستورهای مجزای rmdir (https://rclone.org/commands/rclone_rmdir) یا rmdirs (https://rclone.org/commands/rclone_rmdirs) صرفاً برای حذف دایرکتوری‌های خالی استفاده کنید.
.PP
برای نمونه، جهت حذف تمام فایل‌های بزرگ‌تر از 100 MiB، ممکن است ابتدا بخواهید بررسی کنید چه مواردی حذف خواهند شد (از یکی از دستورهای زیر استفاده کنید):
.IP
.nf
\f[C]
rclone --min-size 100M lsl remote:path
rclone --dry-run --min-size 100M delete remote:path
\f[R]
.fi
.PP
سپس حذف واقعی را انجام دهید:
.IP
.nf
\f[C]
rclone --min-size 100M delete remote:path
\f[R]
.fi
.PP
این دستور به صورت \[dq]حذف همه‌چیز با حداقل اندازهٔ 100 MiB\[dq] خوانده می‌شود، در نتیجه تمام فایل‌های بزرگ‌تر از 100 MiB را حذف می‌کند.
.PP
\f[B]مهم\f[R]: از آنجا که این کار می‌تواند موجب از دست رفتن داده‌ها شود، ابتدا با پرچم \f[V]--dry-run\f[R] یا پرچم‌های \f[V]--interactive\f[R]/\f[V]-i\f[R] آن را بیازمایید.
.IP
.nf
\f[C]
rclone delete remote:path [flags]
\f[R]
.fi
.SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
  -h, --help     راهنمای delete
      --rmdirs   rmdirs دایرکتوری‌های خالی را حذف می‌کند اما ریشه را دست‌نخورده باقی می‌گذارد
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS گزینه‌های مهم (Important Options)
.PP
پرچم‌های مهم و کاربردی برای اکثر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ جزئیات بسیار بیشتر (برای موارد بیشتر تکرار کنید)
\f[R]
.fi.SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌هایی برای فیلترکردن فهرست‌های دایرکتوری
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی‌کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --exclude-if-present stringArray      مستثنی‌کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام فایل‌های مبدأ از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از فایل بدون هیچ‌گونه پردازش خطوط (برای خواندن از stdin از - استفاده کنید)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (برای خواندن از stdin از - استفاده کنید)
  -f, --filter stringArray                  افزودن یک قاعده فیلترکردن فایل
      --filter-from stringArray             خواندن الگوهای فیلترکردن فایل از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --hash-filter string                  افراز نام فایل‌ها بر اساس هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده‌گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف بزرگ و کوچک)
      --include stringArray                 شامل‌کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --max-age Duration                    فقط انتقال فایل‌های جدیدتر از این مقدار برحسب ثانیه یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 فقط انتقال فایل‌های کوچک‌تر از این مقدار برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض off)
      --metadata-exclude stringArray        مستثنی‌کردن متادیتاهای منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متادیتا از فایل (برای خواندن از stdin از - استفاده کنید)
      --metadata-filter stringArray         افزودن یک قاعده فیلترکردن متادیتا
      --metadata-filter-from stringArray    خواندن الگوهای فیلترکردن متادیتا از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --metadata-include stringArray        شامل‌کردن متادیتاهای منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متادیتا از فایل (برای خواندن از stdin از - استفاده کنید)
      --min-age Duration                    فقط انتقال فایل‌های قدیمی‌تر از این مقدار برحسب ثانیه یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --min-size SizeSuffix                 فقط انتقال فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض off)
\f[R]
.fi
.SS "گزینه‌های فهرست‌کردن (Listing Options)"
.PP
پرچم‌هایی برای فهرست‌کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت موجود بودن؛ مصرف حافظه بیشتر اما تراکنش‌های کمتر
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone purge
.PP
حذف مسیر و تمام محتویات آن.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
حذف مسیر و تمام محتویات آن.
توجه داشته باشید که این دستور از فیلترهای شمول/استثنا (include/exclude) پیروی نمی‌کند \- همه‌چیز حذف خواهد شد.
اگر می‌خواهید فایل‌ها را به‌صورت انتخابی حذف کنید، از دستور delete (https://rclone.org/commands/rclone_delete) استفاده نمایید.
برای حذف دایرکتوری‌های خالی به‌تنهایی، از دستور rmdir (https://rclone.org/commands/rclone_rmdir) یا rmdirs (https://rclone.org/commands/rclone_rmdirs) استفاده کنید.
.PP
همزمانی این عملیات توسط پرچم سراسری \f[V]--checkers\f[R] کنترل می‌شود.
با این حال، برخی از backendها این دستور را مستقیماً پیاده‌سازی می‌کنند که در این صورت \f[V]--checkers\f[R] نادیده گرفته خواهد شد.
.PP
\f[B]مهم\f[R]: از آنجا که این عملیات می‌تواند باعث از دست رفتن داده‌ها شود، ابتدا با پرچم \f[V]--dry-run\f[R] یا \f[V]--interactive\f[R]/\f[V]-i\f[R] آزمایش کنید.
.IP
.nf
\f[C]
rclone purge remote:path [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمایی برای purge
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای مشاهده گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید..SS "گزینه‌های مهم (Important Options)"
.PP
پرچم‌های مهم و کاربردی برای بیشتر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ خروجی با جزئیات بیشتر (برای افزایش تکرار کنید)
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها،
پرچم‌ها و backendهای rclone.
.SH rclone mkdir
.PP
ایجاد مسیر در صورتی که از قبل وجود نداشته باشد.
.IP
.nf
\f[C]
rclone mkdir remote:path [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای mkdir
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری
(https://rclone.org/flags) را ببینید.
.SS "گزینه‌های مهم (Important Options)"
.PP
پرچم‌های مهم و کاربردی برای بیشتر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ خروجی با جزئیات بیشتر (برای افزایش تکرار کنید)
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها،
پرچم‌ها و backendهای rclone.
.SH rclone rmdir
.PP
حذف دایرکتوری خالی در مسیر مشخص‌شده.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور دایرکتوری خالی مشخص‌شده توسط path را حذف می‌کند.
اگر مسیر دارای هرگونه شیئی باشد، حتی زیردایرکتوری‌های خالی، حذف نخواهد شد.
برای انجام این کار از دستور rmdirs (https://rclone.org/commands/rclone_rmdirs) (یا
delete (https://rclone.org/commands/rclone_delete) با گزینهٔ
\f[V]--rmdirs\f[R]) استفاده کنید.
.PP
برای حذف یک مسیر و تمامی اشیاء درون آن، از دستور
purge (https://rclone.org/commands/rclone_purge) استفاده کنید.
.IP
.nf
\f[C]
rclone rmdir remote:path [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای rmdir
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری
(https://rclone.org/flags) را ببینید..SS "گزینه‌های مهم (Important Options)"
.PP
پرچم‌های مهم و کاربردی برای بیشتر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ اطلاعات بسیار بیشتر (برای جزئیات بیشتر تکرار کنید)
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و بک‌اندهای rclone.
.SH "rclone check"
.PP
بررسی مطابقت فایل‌ها در مبدأ و مقصد.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
بررسی می‌کند که فایل‌های موجود در مبدأ و مقصد با یکدیگر مطابقت داشته باشند.
این دستور اندازه‌ها و هش‌ها (MD5 یا SHA1) را مقایسه می‌کند و گزارشی از فایل‌هایی که مطابقت ندارند ثبت می‌نماید.
این دستور تغییری در مبدأ یا مقصد ایجاد نمی‌کند.
.PP
برای ریموت crypt (https://rclone.org/crypt) یک دستور اختصاصی به نام cryptcheck (https://rclone.org/commands/rclone_cryptcheck) وجود دارد که قادر است چکسام‌های فایل‌های رمزگذاری‌شده را بررسی کند.
.PP
اگر پرچم \f[V]--size-only\f[R] را مشخص کنید، تنها اندازه‌ها مقایسه می‌شوند و هش‌ها بررسی نخواهند شد.
از این پرچم برای یک بررسی سریع استفاده کنید.
.PP
اگر پرچم \f[V]--download\f[R] را مشخص کنید، داده‌ها را از هر دو ریموت دانلود کرده و آن‌ها را به‌صورت هم‌زمان و مستقیم (on the fly) با یکدیگر مقایسه می‌کند.
این قابلیت برای ریموت‌هایی که از هش پشتیبانی نمی‌کنند یا در صورتی که واقعاً بخواهید تمام داده‌ها را به طور کامل بررسی کنید، می‌تواند مفید باشد.
.PP
اگر پرچم \f[V]--checkfile HASH\f[R] را با یک نام هش معتبر تعیین کنید، \f[V]source:path\f[R] باید به یک فایل متنی با قالب SUM اشاره کند.
.PP
اگر پرچم \f[V]--one-way\f[R] را مشخص کنید، فقط بررسی می‌شود که فایل‌های مبدأ با فایل‌های مقصد مطابقت داشته باشند، نه برعکس.
این بدان معناست که فایل‌های اضافی موجود در مقصد که در مبدأ نیستند، شناسایی نخواهند شد.
.PP
پرچم‌های \f[V]--differ\f[R]، \f[V]--missing-on-dst\f[R]،
\f[V]--missing-on-src\f[R]، \f[V]--match\f[R] و \f[V]--error\f[R]
مسیرها را، در هر سطر یک مسیر، در نام فایل ارائه‌شده (یا اگر
\f[V]-\f[R] باشد در stdout) می‌نویسند.
آنچه این پرچم‌ها ثبت می‌کنند در ادامه توضیح داده شده است.
به عنوان مثال، \f[V]--differ\f[R] تمام مسیرهایی را که هم در مبدأ و هم در مقصد وجود دارند اما متفاوت هستند، ثبت می‌کند.
.PP
پرچم \f[V]--combined\f[R] فایلی (یا در stdout) ایجاد می‌کند که شامل تمام مسیرهای فایل‌ها است؛ به‌طوری‌که پیش از هر مسیر، یک نماد و سپس یک فاصله قرار می‌گیرد تا وضعیت آن فایل را مشخص کند.
این ساختار یادآور فایل‌های diff است.
.IP \[bu] 2
\f[V]= path\f[R] به این معنی است که path در مبدأ و مقصد یافت شد و یکسان بود
.IP \[bu] 2
\f[V]- path\f[R] به این معنی است که path در مبدأ وجود نداشت، بنابراین فقط در مقصد موجود است
.IP \[bu] 2
\f[V]+ path\f[R] به این معنی است که path در مقصد وجود نداشت، بنابراین فقط در مبدأ موجود است
.IP \[bu] 2
\f[V]* path\f[R] به این معنی است که path در مبدأ و مقصد وجود داشت ولی متفاوت بود.
.IP \[bu] 2
\f[V]! path\f[R] به این معنی است که در خواندن یا محاسبه هش مبدأ یا مقصد خطایی رخ داد.
.PP
تعداد پیش‌فرض بررسی‌های موازی ۸ است.
برای اطلاعات بیشتر، گزینه --checkers (https://rclone.org/docs/#checkers-int) را ببینید.
.IP
.nf
\f[C]
rclone check source:path dest:path [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -C, --checkfile string        در نظر گرفتن source:path به عنوان یک فایل SUM با هش‌های نوع داده‌شده
      --combined string         ایجاد یک گزارش ترکیبی از تغییرات در این فایل
      --differ string           گزارش تمام فایل‌های نامطابق در این فایل
      --download                بررسی از طریق دانلود به‌جای استفاده از هش
      --error string            گزارش تمام فایل‌های دارای خطا (هش‌کردن یا خواندن) در این فایل
  -h, --help                    راهنمایی برای check
      --match string            گزارش تمام فایل‌های منطبق در این فایل
      --missing-on-dst string   گزارش تمام فایل‌های ناموجود در مقصد به این فایل
      --missing-on-src string   گزارش تمام فایل‌های ناموجود در مبدأ به این فایل
      --one-way                 تنها بررسی یک‌طرفه؛ فایل‌های مبدأ باید روی ریموت وجود داشته باشند
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "گزینه‌های بررسی (Check Options)"
.PP
پرچم‌های مورد استفاده برای دستورهای check
.IP
.nf
\f[C]
      --max-backlog int   حداکثر تعداد اشیاء در backlog همگام‌سازی یا بررسی (پیش‌فرض 10000)
\f[R]
.fi
.SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌هایی برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (برای خواندن از stdin از - استفاده کنید)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل مبدأ از فایل (برای خواندن از stdin از - استفاده کنید)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل مبدأ از فایل بدون هیچ پردازشی روی خطوط (برای خواندن از stdin از - استفاده کنید)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل مبدأ از فایل با استفاده از NUL به عنوان جداکننده (برای خواندن از stdin از - استفاده کنید)
  -f, --filter stringArray                  افزودن یک قاعده فیلتر فایل
      --filter-from stringArray             خواندن الگوهای فیلتر فایل از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --hash-filter string                  افراز نام فایل‌ها با هش k/n یا به صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (برای خواندن از stdin از - استفاده کنید)
      --max-age Duration                    تنها انتقال فایل‌های جدیدتر از این برحسب s یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 تنها انتقال فایل‌های کوچک‌تر از این برحسب KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (برای خواندن از stdin از - استفاده کنید)
      --metadata-filter stringArray         افزودن یک قاعده فیلتر متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر متاداده از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از فایل (برای خواندن از stdin از - استفاده کنید)
      --min-age Duration                    تنها انتقال فایل‌های قدیمی‌تر از این برحسب s یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 تنها انتقال فایل‌های بزرگ‌تر از این برحسب KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS "گزینه‌های فهرست‌بندی (Listing Options)"
.PP
پرچم‌ها برای فهرست‌بندی دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش داده شده در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت در دسترس بودن؛ حافظه بیشتر اما تراکنش‌های کمتری مصرف می‌کند
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone ls
.PP
فهرست کردن اشیاء در مسیر مشخص‌شده همراه با اندازه و مسیر.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
اشیاء موجود در مسیر مبدأ را با قالبی خوانا برای انسان همراه با اندازه و مسیر در خروجی استاندارد فهرست می‌کند.
به‌طور پیش‌فرض به صورت بازگشتی عمل می‌کند.
.PP
به‌عنوان مثال:
.IP
.nf
\f[C]
$ rclone ls swift:bucket
    60295 bevajer5jef
    90613 canole
    94467 diwogej7
    37600 fubuwic
\f[R]
.fi
.PP
هر یک از گزینه‌های فیلتر کردن را می‌توان برای این دستور اعمال کرد.
.PP
چندین دستور فهرست‌بندی مرتبط وجود دارد:
.IP \[bu] 2
\f[V]ls\f[R] تنها برای فهرست کردن اندازه و مسیر اشیاء
.IP \[bu] 2
\f[V]lsl\f[R] تنها برای فهرست کردن زمان تغییر، اندازه و مسیر اشیاء
.IP \[bu] 2
\f[V]lsd\f[R] تنها برای فهرست کردن دایرکتوری‌ها
.IP \[bu] 2
\f[V]lsf\f[R] برای فهرست کردن اشیاء و دایرکتوری‌ها در قالبی با تجزیه آسان
.IP \[bu] 2
\f[V]lsjson\f[R] برای فهرست کردن اشیاء و دایرکتوری‌ها در قالب JSON
.PP
دستورهای \f[V]ls\f[R]، \f[V]lsl\f[R] و \f[V]lsd\f[R] طوری طراحی شده‌اند که برای انسان خوانا باشند.
دستور \f[V]lsf\f[R] طوری طراحی شده است که هم برای انسان و هم برای ماشین خوانا باشد.
دستور \f[V]lsjson\f[R] طوری طراحی شده است که برای ماشین خوانا باشد.
.PP
توجه داشته باشید که \f[V]ls\f[R] و \f[V]lsl\f[R] به‌طور پیش‌فرض به صورت بازگشتی عمل می‌کنند \- برای متوقف کردن پیمایش بازگشتی از \f[V]--max-depth 1\f[R] استفاده کنید.
.PP
سایر دستورهای فهرست‌بندی شامل \f[V]lsd\f[R]، \f[V]lsf\f[R] و \f[V]lsjson\f[R] به‌طور پیش‌فرض بازگشتی نیستند \- برای بازگشتی کردن آن‌ها از \f[V]-R\f[R] استفاده کنید.
.PP
دستورهای فهرست‌بندی به‌طور پیش‌فرض روشی بازگشتی را ترجیح می‌دهند که حافظه بیشتر اما تراکنش‌های کمتری مصرف می‌کند.
برای غیرفعال کردن این رفتار از \f[V]--disable ListR\f[R] استفاده کنید.
برای جزئیات بیشتر به \f[V]--fast-list\f[R] (https://rclone.org/docs/#fast-list) مراجعه کنید.
.PP
فهرست کردن یک دایرکتوری ناموجود منجر به خطا خواهد شد، مگر برای ریموت‌هایی که نمی‌توانند دایرکتوری خالی داشته باشند (مانند s3، swift یا gcs \- ریموت‌های مبتنی بر باکت).
.IP
.nf
\f[C]
rclone ls remote:path [flags]
\f[R]
.fi.SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
  -h, --help   راهنمایی برای ls
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای مشاهدهٔ گزینه‌های سراسری که در اینجا فهرست نشده‌اند، به صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) مراجعه کنید.
.SS گزینه‌های فیلتر (Filter Options)
.PP
پرچم‌هایی برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از - برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل مبدأ از فایل (استفاده از - برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل مبدأ از فایل بدون هیچ‌گونه پردازش خطوط (استفاده از - برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (استفاده از - برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قانون فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --hash-filter string                  افرازش نام فایل‌ها با هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف بزرگ و کوچک)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از - برای خواندن از stdin)
      --max-age Duration                    انتقال تنها فایل‌های جدیدتر از این مقدار برحسب s یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 انتقال تنها فایل‌های کوچک‌تر از این مقدار برحسب KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض off)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (استفاده از - برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قانون فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متاداده از یک فایل (استفاده از - برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از فایل (استفاده از - برای خواندن از stdin)
      --min-age Duration                    انتقال تنها فایل‌های قدیمی‌تر از این مقدار برحسب s یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --min-size SizeSuffix                 انتقال تنها فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض off)
\f[R]
.fi
.SS گزینه‌های فهرست‌کردن (Listing Options)
.PP
پرچم‌هایی برای فهرست‌کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست بازگشتی در صورت موجود بودن؛ مصرف حافظه بیشتر اما تراکنش‌های کمتر
\f[R]
.fi
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone lsd
.PP
فهرست کردن تمام دایرکتوری‌ها/ظرف‌ها/باکت‌ها در مسیر.
.SS خلاصه دستور (SYNOPSIS)
.PP
دایرکتوری‌های موجود در مسیر مبدأ را در خروجی استاندارد فهرست می‌کند.
به‌طور پیش‌فرض به‌صورت بازگشتی عمل نمی‌کند.
برای بازگشت به زیرشاخه‌ها از پرچم \f[V]-R\f[R] استفاده کنید.
.PP
این دستور اندازهٔ کل دایرکتوری (در صورت مشخص بودن، وگرنه \-1)، زمان آخرین تغییر (در صورت مشخص بودن، وگرنه زمان فعلی)، تعداد شیء‌های موجود در دایرکتوری (در صورت مشخص بودن، وگرنه \-1) و نام دایرکتوری را فهرست می‌کند؛ مانند:
.IP
.nf
\f[C]
$ rclone lsd swift:
      494000 2018-04-26 08:43:20     10000 10000files
          65 2018-04-26 08:43:20         1 1File
\f[R]
.fi
.PP
یا
.IP
.nf
\f[C]
$ rclone lsd drive:test
          -1 2016-10-17 17:41:53        -1 1000files
          -1 2017-01-03 14:40:54        -1 2500files
          -1 2017-07-08 14:39:28        -1 4000files
\f[R]
.fi
.PP
اگر فقط نام دایرکتوری‌ها را می‌خواهید از \f[V]rclone lsf --dirs-only\f[R] استفاده کنید.
.PP
هر یک از گزینه‌های فیلتر کردن را می‌توان برای این دستور اعمال کرد.
.PP
چندین دستور فهرست‌کردن مرتبط وجود دارد:
.IP \[bu] 2
\f[V]ls\f[R] تنها برای فهرست‌کردن اندازه و مسیر شیءها
.IP \[bu] 2
\f[V]lsl\f[R] تنها برای فهرست‌کردن زمان تغییر، اندازه و مسیر شیءها
.IP \[bu] 2
\f[V]lsd\f[R] تنها برای فهرست‌کردن دایرکتوری‌ها
.IP \[bu] 2
\f[V]lsf\f[R] برای فهرست‌کردن شیءها و دایرکتوری‌ها در قالبی با تجزیهٔ آسان
.IP \[bu] 2
\f[V]lsjson\f[R] برای فهرست‌کردن شیءها و دایرکتوری‌ها در قالب JSON
.PP
دستورهای \f[V]ls\f[R]، \f[V]lsl\f[R] و \f[V]lsd\f[R] طوری طراحی شده‌اند که برای انسان خوانا باشند.
دستور \f[V]lsf\f[R] طوری طراحی شده که هم برای انسان و هم برای ماشین خوانا باشد.
دستور \f[V]lsjson\f[R] طوری طراحی شده که برای ماشین خوانا باشد.
.PP
توجه داشته باشید که \f[V]ls\f[R] و \f[V]lsl\f[R] به‌طور پیش‌فرض به‌صورت بازگشتی عمل می‌کنند \- برای متوقف کردن بازگشت از \f[V]--max-depth 1\f[R] استفاده کنید.
.PP
سایر دستورهای فهرست‌کردن شامل \f[V]lsd\f[R]، \f[V]lsf\f[R] و \f[V]lsjson\f[R] به‌طور پیش‌فرض بازگشتی نیستند \- برای بازگشتی کردن آن‌ها از \f[V]-R\f[R] استفاده کنید.
.PP
دستورهای فهرست‌کردن به‌طور پیش‌فرض روشی بازگشتی را ترجیح می‌دهند که حافظهٔ بیشتری مصرف می‌کند اما تراکنش‌های کمتری دارد.
برای جلوگیری از این رفتار از \f[V]--disable ListR\f[R] استفاده کنید.
برای جزئیات بیشتر به \f[V]--fast-list\f[R] (https://rclone.org/docs/#fast-list) مراجعه کنید.
.PP
فهرست‌کردن یک دایرکتوری ناموجود منجر به خطا خواهد شد، مگر در ریموت‌هایی که نمی‌توانند دایرکتوری خالی داشته باشند (مانند s3، swift یا gcs \- ریموت‌های مبتنی بر باکت).
.IP
.nf
\f[C]
rclone lsd remote:path [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help        راهنمایی برای lsd
  -R, --recursive   پیمایش بازگشتی در فهرست
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای مشاهدهٔ گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌هایی برای پالایش فهرست‌های دایرکتوری
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های روی مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از - برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل‌های مبدأ از فایل (استفاده از - برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از فایل بدون هیچ‌گونه پردازش روی خط‌ها (استفاده از - برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (استفاده از - برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قانون فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --hash-filter string                  افرازش نام فایل‌ها با هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده‌گرفتن بزرگی و کوچکی حروف در فیلترها (حساس نبودن به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از - برای خواندن از stdin)
      --max-age Duration                    انتقال تنها فایل‌های جدیدتر از این مقدار برحسب s یا پسوندهای ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 انتقال تنها فایل‌های کوچک‌تر از این مقدار برحسب KiB یا پسوندهای B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (استفاده از - برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قانون فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متاداده از یک فایل (استفاده از - برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از فایل (استفاده از - برای خواندن از stdin)
      --min-age Duration                    انتقال تنها فایل‌های قدیمی‌تر از این مقدار برحسب s یا پسوندهای ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 انتقال تنها فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا پسوندهای B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS "گزینه‌های فهرست‌کردن (Listing Options)"
.PP
پرچم‌هایی برای فهرست‌کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت موجود بودن؛ مصرف حافظهٔ بیشتر اما تراکنش‌های کمتر
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone lsl
.PP
فهرست کردن اشیاء موجود در مسیر به همراه زمان تغییر، اندازه و مسیر.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
اشیاء موجود در مسیر مبدأ را در قالبی خوانا برای انسان، همراه با زمان تغییر، اندازه و مسیر در خروجی استاندارد فهرست می‌کند.
به‌طور پیش‌فرض به‌صورت بازگشتی عمل می‌کند.
.PP
برای مثال:
.IP
.nf
\f[C]
$ rclone lsl swift:bucket
    60295 2016-06-25 18:55:41.062626927 bevajer5jef
    90613 2016-06-25 18:55:43.302607074 canole
    94467 2016-06-25 18:55:43.046609333 diwogej7
    37600 2016-06-25 18:55:40.814629136 fubuwic
\f[R]
.fi
.PP
هر یک از گزینه‌های فیلتر کردن را می‌توان برای این دستور اعمال کرد.
.PP
چندین دستور فهرست‌بندی مرتبط وجود دارد:
.IP \[bu] 2
\f[V]ls\f[R] تنها برای فهرست کردن اندازه و مسیر اشیاء
.IP \[bu] 2
\f[V]lsl\f[R] تنها برای فهرست کردن زمان تغییر، اندازه و مسیر اشیاء
.IP \[bu] 2
\f[V]lsd\f[R] تنها برای فهرست کردن دایرکتوری‌ها
.IP \[bu] 2
\f[V]lsf\f[R] برای فهرست کردن اشیاء و دایرکتوری‌ها در قالبی با تجزیهٔ آسان
.IP \[bu] 2
\f[V]lsjson\f[R] برای فهرست کردن اشیاء و دایرکتوری‌ها در قالب JSON
.PP
دستورهای \f[V]ls\f[R]، \f[V]lsl\f[R] و \f[V]lsd\f[R] به‌گونه‌ای طراحی شده‌اند که برای انسان خوانا باشند.
دستور \f[V]lsf\f[R] برای خوانایی توسط انسان و ماشین طراحی شده است.
دستور \f[V]lsjson\f[R] برای خوانایی توسط ماشین طراحی شده است.
.PP
توجه داشته باشید که \f[V]ls\f[R] و \f[V]lsl\f[R] به‌طور پیش‌فرض به‌صورت بازگشتی عمل می‌کنند \- برای متوقف کردن بازگشت از \f[V]--max-depth 1\f[R] استفاده کنید.
.PP
سایر دستورهای فهرست‌بندی یعنی \f[V]lsd\f[R]، \f[V]lsf\f[R] و \f[V]lsjson\f[R] به‌طور پیش‌فرض بازگشتی نیستند \- برای بازگشتی کردن آن‌ها از \f[V]-R\f[R] استفاده کنید.
.PP
دستورهای فهرست‌بندی به‌طور پیش‌فرض روش بازگشتی را ترجیح می‌دهند که از حافظهٔ بیشتر اما تراکنش‌های کمتری استفاده می‌کند.
برای غیرفعال کردن این رفتار از \f[V]--disable ListR\f[R] استفاده کنید.
برای جزئیات بیشتر \f[V]--fast-list\f[R] (https://rclone.org/docs/#fast-list) را ببینید.
.PP
فهرست کردن یک دایرکتوری ناموجود منجر به خطا خواهد شد، مگر در ریموت‌هایی که نمی‌توانند دایرکتوری خالی داشته باشند (مانند s3، swift یا gcs \- ریموت‌های مبتنی بر باکت).
.IP
.nf
\f[C]
rclone lsl remote:path [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمایی برای lsl
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه توضیح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌هایی برای فیلتر کردن فهرست‌های دایرکتوری
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های روی مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (برای خواندن از stdin از - استفاده کنید)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام فایل‌های مبدأ از فایل (برای خواندن از stdin از - استفاده کنید)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از فایل بدون هیچ پردازشی روی خطوط (برای خواندن از stdin از - استفاده کنید)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (برای خواندن از stdin از - استفاده کنید)
  -f, --filter stringArray                  افزودن یک قانون فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --hash-filter string                  بخش‌بندی نام فایل‌ها با هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده‌گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف بزرگ و کوچک)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (برای خواندن از stdin از - استفاده کنید)
      --max-age Duration                    فقط انتقال فایل‌های جدیدتر از این مقدار به s یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 فقط انتقال فایل‌های کوچک‌تر از این مقدار به KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض غیرفعال)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (برای خواندن از stdin از - استفاده کنید)
      --metadata-filter stringArray         افزودن یک قانون فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متاداده از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از فایل (برای خواندن از stdin از - استفاده کنید)
      --min-age Duration                    فقط انتقال فایل‌های قدیمی‌تر از این مقدار به s یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --min-size SizeSuffix                 فقط انتقال فایل‌های بزرگ‌تر از این مقدار به KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض غیرفعال)
\f[R]
.fi
.SS "گزینه‌های فهرست‌کردن (Listing Options)"
.PP
پرچم‌هایی برای فهرست کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت دردسترس بودن؛ مصرف حافظهٔ بیشتر اما تراکنش‌های کمتر
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و بک‌اندهای rclone.
.SH rclone md5sum
.PP
یک فایل md5sum برای تمام شیءهای موجود در مسیر تولید می‌کند.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
یک فایل md5sum برای تمام شیءهای موجود در مسیر تولید می‌کند.
این خروجی در همان قالبی است که ابزار استاندارد md5sum تولید می‌کند.
.PP
به‌طور پیش‌فرض، هش از ریموت درخواست می‌شود.
اگر MD5 توسط ریموت پشتیبانی نشود، هیچ هشی بازگردانده نخواهد شد.
با استفاده از پرچم download، فایل از ریموت بارگیری شده و به‌صورت محلی
هش می‌شود که این کار استفاده از MD5 را برای هر ریموتی امکان‌پذیر می‌کند.
.PP
برای الگوریتم‌های دیگر، دستور
hashsum (https://rclone.org/commands/rclone_hashsum) را ببینید.
اجرای \f[V]rclone md5sum remote:path\f[R] معادل با اجرای
\f[V]rclone hashsum MD5 remote:path\f[R] است.
.PP
این دستور همچنین می‌تواند داده‌های دریافت شده روی ورودی استاندارد (stdin) را هش کند؛
با مشخص نکردن remote:path، یا با فرستادن یک خط فاصله (\-) به‌عنوان remote:path در
زمانی که داده‌ای برای خواندن وجود دارد (در غیر این صورت، با خط فاصله به‌صورت لفظی
و به‌عنوان یک مسیر نسبی رفتار خواهد شد).
.IP
.nf
\f[C]
rclone md5sum remote:path [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --base64               خروجی مجموع هش با کُدگذاری base64
  -C, --checkfile string     اعتبارسنجی هش‌ها در برابر یک فایل SUM داده‌شده به‌جای چاپ آن‌ها
      --download             دانلود فایل و محاسبهٔ هش آن به‌صورت محلی؛ اگر این پرچم مشخص نشود، هش از ریموت درخواست می‌شود
  -h, --help                 راهنمای md5sum
      --output-file string   خروجی دادن مجموع‌های هش در یک فایل به‌جای ترمینال
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (<https://rclone.org/flags>) را ببینید.
.SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌هایی برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های روی مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از - برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل‌های مبدأ از فایل (استفاده از - برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل‌های مبدأ از فایل بدون هیچ‌گونه پردازش روی خطوط (استفاده از - برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل‌های مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (استفاده از - برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قاعدهٔ فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --hash-filter string                  افرازبندی نام‌های فایل بر اساس هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شامل کردن فایل از فایل (استفاده از - برای خواندن از stdin)
      --max-age Duration                    فقط انتقال فایل‌های جدیدتر از این مقدار برحسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 فقط انتقال فایل‌های کوچک‌تر از این مقدار برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (استفاده از - برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قاعدهٔ فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متاداده از یک فایل (استفاده از - برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شامل کردن متاداده از فایل (استفاده از - برای خواندن از stdin)
      --min-age Duration                    فقط انتقال فایل‌های قدیمی‌تر از این مقدار برحسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 فقط انتقال فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS "گزینه‌های فهرست‌کردن (Listing Options)"
.PP
پرچم‌هایی برای فهرست‌کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست بازگشتی در صورت موجود بودن؛ مصرف حافظهٔ بیشتر اما تراکنش‌های کمتر
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (<https://rclone.org/commands/rclone>) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone sha1sum
.PP
یک فایل sha1sum برای تمام اشیاء موجود در مسیر تولید می‌کند.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
یک فایل sha1sum برای تمام اشیاء موجود در مسیر تولید می‌کند.
این خروجی در همان قالبی است که ابزار استاندارد sha1sum تولید می‌کند.
.PP
به‌طور پیش‌فرض، هش از ریموت درخواست می‌شود.
اگر SHA-1 توسط ریموت پشتیبانی نشود، هیچ هشی بازگردانده نخواهد شد.
با پرچم download، فایل از ریموت دانلود شده و هش آن به‌صورت محلی محاسبه می‌شود که امکان استفاده از SHA-1 را برای هر ریموتی فراهم می‌سازد.
.PP
برای سایر الگوریتم‌ها، دستور
hashsum (<https://rclone.org/commands/rclone_hashsum>) را ببینید.
اجرای \f[V]rclone sha1sum remote:path\f[R] معادل اجرای
\f[V]rclone hashsum SHA1 remote:path\f[R] است.
.PP
این دستور همچنین می‌تواند داده‌های دریافت‌شده از ورودی استاندارد (stdin) را با
مشخص نکردن remote:path، یا با ارسال یک خط تیره به‌جای remote:path در صورتی که
داده‌ای برای خواندن وجود داشته باشد، هش کند (در غیر این صورت، با خط تیره
به‌صورت لفظی به‌عنوان یک مسیر نسبی برخورد خواهد شد).
.PP
این دستور همچنین در صورت مشخص نکردن remote:path، می‌تواند داده‌های دریافتی از STDIN را هش کند.
.IP
.nf
\f[C]
rclone sha1sum remote:path [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --base64               نمایش مقدار هش با کدگذاری base64
  -C, --checkfile string     اعتبارسنجی هش‌ها در برابر یک فایل SUM مشخص‌شده به‌جای چاپ آن‌ها
      --download             دانلود فایل و محاسبه هش به‌صورت محلی؛ در صورت عدم تعیین این پرچم، هش از دوردست درخواست می‌شود
  -h, --help                 راهنمایی برای sha1sum
      --output-file string   خروجی دادن مقادیر هش به یک فایل به‌جای ترمینال
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های عمومی که در اینجا فهرست نشده‌اند، صفحه پرچم‌های عمومی
(https://rclone.org/flags) را ببینید.
.SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌هایی برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از sync استثنا شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از - برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود filename
      --files-from stringArray              خواندن فهرست نام فایل‌های مبدأ از فایل (استفاده از - برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از فایل بدون هیچ‌گونه پردازش خطوط (استفاده از - برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ از فایل با جداکننده NUL (استفاده از - برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قانون فیلترسازی فایل
      --filter-from stringArray             خواندن الگوهای فیلترسازی فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --hash-filter string                  افرازبندی نام‌فایل‌ها بر اساس هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (عدم حساسیت به حروف کوچک و بزرگ)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از - برای خواندن از stdin)
      --max-age Duration                    تنها انتقال فایل‌های جدیدتر از این مقدار بر حسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 تنها انتقال فایل‌های کوچک‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض غیرفعال)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (استفاده از - برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قانون فیلترسازی متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلترسازی متاداده از یک فایل (استفاده از - برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از فایل (استفاده از - برای خواندن از stdin)
      --min-age Duration                    تنها انتقال فایل‌های قدیمی‌تر از این مقدار بر حسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --min-size SizeSuffix                 تنها انتقال فایل‌های بزرگ‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض غیرفعال)
\f[R]
.fi
.SS "گزینه‌های فهرست‌کردن (Listing Options)"
.PP
پرچم‌هایی برای فهرست کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایشی در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت موجود بودن؛ مصرف حافظه بیشتر اما تراکنش‌های کمتر
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone size
.PP
مجموع اندازه و تعداد اشیاء موجود در remote:path را چاپ می‌کند.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
اشیاء موجود در مسیر را شمارش کرده و اندازه کل را محاسبه می‌کند.
نتیجه را در خروجی استاندارد چاپ می‌کند.
.PP
به‌طور پیش‌فرض، خروجی در قالب خوانا برای انسان است، اما مقادیر را هم
در قالب خوانا برای انسان و هم به‌صورت اعداد خام نمایش می‌دهد (گزینه عمومی
\f[V]--human-readable\f[R] در نظر گرفته نمی‌شود).
برای قالب‌بندی خروجی به‌صورت JSON، از گزینه \f[V]--json\f[R] استفاده کنید.
.PP
به‌طور پیش‌فرض به‌صورت بازگشتی عمل می‌کند؛ برای متوقف کردن حالت بازگشتی از \f[V]--max-depth 1\f[R] استفاده کنید.
.PP
برخی از backendها همیشه اندازه فایل‌ها را ارائه نمی‌دهند؛ برای نمونه
Google Photos (https://rclone.org/googlephotos/#size) و
Google Docs (https://rclone.org/drive/#limitations-of-google-docs) را ببینید.
در این حالت، rclone پیامی در لاگ نمایش می‌دهد که نشان‌دهنده تعداد این‌گونه فایل‌های
یافت‌شده است، و آن‌ها را در خروجی دستور size به‌عنوان فایل‌های خالی به‌حساب می‌آورد.
.IP
.nf
\f[C]
rclone size remote:path [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمایی برای size
      --json   قالب‌بندی خروجی به صورت JSON
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS گزینه‌های فیلتر (Filter Options)
.PP
پرچم‌هایی برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود داشتن نام فایل
      --files-from stringArray              خواندن فهرست نام فایل‌های مبدأ از یک فایل (استفاده از - برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از یک فایل بدون هیچ پردازشی روی خط‌ها (استفاده از - برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ از یک فایل با استفاده از NUL به عنوان جداکننده (استفاده از - برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قاعده فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --hash-filter string                  افراز نام فایل‌ها بر اساس درهم‌سازی k/n یا به صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به بزرگی و کوچکی حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --max-age Duration                    تنها انتقال فایل‌های جدیدتر از این مقدار بر حسب ثانیه یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --max-depth int                       در صورت تعیین، محدود کردن عمق بازگشت به این مقدار (پیش‌فرض -1)
      --max-size SizeSuffix                 تنها انتقال فایل‌های کوچک‌تر از این مقدار بر حسب KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض غیرفعال)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از یک فایل (استفاده از - برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قاعده فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متاداده از یک فایل (استفاده از - برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از یک فایل (استفاده از - برای خواندن از stdin)
      --min-age Duration                    تنها انتقال فایل‌های قدیمی‌تر از این مقدار بر حسب ثانیه یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --min-size SizeSuffix                 تنها انتقال فایل‌های بزرگ‌تر از این مقدار بر حسب KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض غیرفعال)
\f[R]
.fi
.SS گزینه‌های فهرست‌بندی (Listing Options)
.PP
پرچم‌هایی برای فهرست‌بندی دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت در دسترس بودن؛ حافظه بیشتر اما تراکنش‌های کمتری مصرف می‌کند
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنمایی برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone version
.PP
نمایش شماره نسخه.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
نمایش شماره نسخه rclone، نسخه go، سیستم‌عامل و معماری هدف ساخت، سیستم‌عامل و نسخه هسته و چندبیتی بودن در زمان اجرا، برچسب‌های ساخت و نوع فایل اجرایی (ایستا یا پویا).
.PP
برای مثال:
.IP
.nf
\f[C]
$ rclone version
rclone v1.55.0
- os/version: ubuntu 18.04 (64 bit)
- os/kernel: 4.15.0-136-generic (x86_64)
- os/type: linux
- os/arch: amd64
- go/version: go1.16
- go/linking: static
- go/tags: none
\f[R]
.fi
.PP
نکته: پیش از نسخه 1.55 rclone، خط‌های os/type و os/arch ادغام شده بودند، و خط \[dq]go/version\[dq] با عنوان \[dq]go version\[dq] برچسب‌گذاری شده بود.
.PP
اگر پرچم --check را مشخص کنید، یک بررسی برخط برای مقایسه نسخه شما با آخرین انتشار و آخرین نسخه beta انجام خواهد داد.
.IP
.nf
\f[C]
$ rclone version --check
yours:  1.42.0.6
latest: 1.42          (released 2018-06-16)
beta:   1.42.0.5      (released 2018-06-17)
\f[R]
.fi
.PP
یا
.IP
.nf
\f[C]
$ rclone version --check
yours:  1.41
latest: 1.42          (released 2018-06-16)
  upgrade: https://downloads.rclone.org/v1.42
beta:   1.42.0.5      (released 2018-06-17)
  upgrade: https://beta.rclone.org/v1.42-005-g56e1e820
\f[R]
.fi
.PP
اگر پرچم --deps را مشخص کنید، rclone فهرستی از تمام بسته‌هایی که به آن‌ها وابسته است و نسخه‌های آن‌ها را به همراه اطلاعات دیگری درباره ساخت چاپ می‌کند.
.IP
.nf
\f[C]
rclone version [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --check   بررسی برای نسخه جدید
      --deps    نمایش وابستگی‌های Go
  -h, --help    راهنما برای version
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone cleanup
.PP
پاک‌سازی ریموت در صورت امکان.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
پاک‌سازی ریموت در صورت امکان.
سطل زباله را خالی می‌کند یا نسخه‌های قدیمی فایل‌ها را حذف می‌نماید.
توسط همه ریموت‌ها پشتیبانی نمی‌شود.
.IP
.nf
\f[C]
rclone cleanup remote:path [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنما برای cleanup
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "گزینه‌های مهم (IMPORTANT OPTIONS)"
.PP
پرچم‌های مهم و کاربردی برای بیشتر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ اطلاعات بسیار بیشتر (تکرار برای جزئیات بیشتر)
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone dedupe
.PP
یافتن تعاملی نام‌فایل‌های تکراری و حذف یا تغییر نام آن‌ها.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
به‌طور پیش‌فرض، \f[V]dedupe\f[R] فایل‌های دارای نام‌های تکراری را به‌صورت تعاملی می‌یابد و پیشنهاد می‌دهد که همه به جز یکی حذف شوند یا نام آن‌ها تغییر یابد تا متمایز شوند. این فرآیند به عنوان رفع تکرار بر اساس نام (deduping by name) شناخته می‌شود.
.PP
رفع تکرار بر اساس نام تنها برای گروه کوچکی از backendها (مانند Google Drive، Opendrive) که می‌توانند نام فایل‌های تکراری داشته باشند مفید است.
می‌توان آن را روی backendهای پوشش‌دهنده (مانند crypt) نیز اجرا کرد در صورتی که backendای را پوشش دهند که از نام فایل‌های تکراری پشتیبانی می‌کند.
.PP
با این حال، اگر \f[V]--by-hash\f[R] ارسال شود، \f[V]dedupe\f[R] در عوض فایل‌های دارای هش‌های تکراری را می‌یابد که روی هر backend دارای پشتیبانی از دست‌کم یک هش کار خواهد کرد.
این کار می‌تواند برای یافتن فایل‌هایی با محتوای یکسان به کار رود.
این فرآیند به عنوان رفع تکرار بر اساس هش (deduping by hash) شناخته می‌شود.
.PP
در صورت رفع تکرار بر اساس نام، ابتدا rclone دایرکتوری‌های هم‌نام را ادغام می‌کند.
این کار را به‌صورت تکرارشونده تا زمانی که تمام دایرکتوری‌های هم‌نام ادغام شوند ادامه خواهد داد.
.PP
سپس، در صورت رفع تکرار بر اساس نام، برای هر گروه از نام فایل‌ها / هش‌های تکراری، همه فایل‌های یکسانی را که می‌یابد به جز یکی بدون درخواست تأیید حذف خواهد کرد.
این بدان معناست که برای بیشتر فایل‌های تکراری، دستور \f[V]dedupe\f[R] تعاملی نخواهد بود.
.PP
دستور \f[V]dedupe\f[R] فایل‌هایی را یکسان در نظر می‌گیرد که مسیر فایل و هش یکسانی داشته باشند.
اگر backend از هش‌ها پشتیبانی نکند (مانند crypt که Google Drive را پوشش می‌دهد)، هرگز به عنوان فایل‌های یکسان تشخیص داده نخواهند شد.
اگر از پرچم \f[V]--size-only\f[R] استفاده کنید، فایل‌ها در صورتی که اندازه یکسانی داشته باشند یکسان در نظر گرفته می‌شوند (هر هشی نادیده گرفته خواهد شد).
این قابلیت می‌تواند روی backendهای crypt که از هش پشتیبانی نمی‌کنند مفید باشد.
.PP
سپس rclone موارد تکراری باقی‌مانده را رفع‌ورجوع می‌کند.
اقدامی که دقیقاً انجام می‌شود به حالت dedupe بستگی دارد.
به‌طور پیش‌فرض، rclone برای هر مورد به‌صورت تعاملی از کاربر سؤال می‌پرسد.
.PP
\f[B]مهم\f[R]: از آنجا که این عملیات می‌تواند باعث از دست رفتن داده‌ها شود، ابتدا با پرچم \f[V]--dry-run\f[R] یا \f[V]--interactive\f[R]/\f[V]-i\f[R] آن را بیازمایید.
.PP
در اینجا نمونه‌ای از یک اجرا آورده شده است.
.PP
قبل \- همراه با موارد تکراری
.IP
.nf
\f[C]
$ rclone lsl drive:dupes
  6048320 2016-03-05 16:23:16.798000000 one.txt
  6048320 2016-03-05 16:23:11.775000000 one.txt
   564374 2016-03-05 16:23:06.731000000 one.txt
  6048320 2016-03-05 16:18:26.092000000 one.txt
  6048320 2016-03-05 16:22:46.185000000 two.txt
  1744073 2016-03-05 16:22:38.104000000 two.txt
   564374 2016-03-05 16:22:52.118000000 two.txt
\f[R]
.fi
.PP
اکنون نشست \f[V]dedupe\f[R]
.IP
.nf
\f[C]
$ rclone dedupe drive:dupes
2016/03/05 16:24:37 Google drive root \[aq]dupes\[aq]: Looking for duplicates using interactive mode.
one.txt: Found 4 files with duplicate names
one.txt: Deleting 2/3 identical duplicates (MD5 \[dq]1eedaa9fe86fd4b8632e2ac549403b36\[dq])
one.txt: 2 duplicates remain
  1:      6048320 bytes, 2016-03-05 16:23:16.798000000, MD5 1eedaa9fe86fd4b8632e2ac549403b36
  2:       564374 bytes, 2016-03-05 16:23:06.731000000, MD5 7594e7dc9fc28f727c42ee3e0749de81
s) Skip and do nothing
k) Keep just one (choose which in next step)
r) Rename all to be different (by changing file.jpg to file-1.jpg)
s/k/r> k
Enter the number of the file to keep> 1
one.txt: Deleted 1 extra copies
two.txt: Found 3 files with duplicate names
two.txt: 3 duplicates remain
  1:       564374 bytes, 2016-03-05 16:22:52.118000000, MD5 7594e7dc9fc28f727c42ee3e0749de81
  2:      6048320 bytes, 2016-03-05 16:22:46.185000000, MD5 1eedaa9fe86fd4b8632e2ac549403b36
  3:      1744073 bytes, 2016-03-05 16:22:38.104000000, MD5 851957f7fb6f0bc4ce76be966d336802
s) Skip and do nothing
k) Keep just one (choose which in next step)
r) Rename all to be different (by changing file.jpg to file-1.jpg)
s/k/r> r
two-1.txt: renamed from: two.txt
two-2.txt: renamed from: two.txt
two-3.txt: renamed from: two.txt
\f[R]
.fi
.PP
نتیجه به صورت زیر خواهد بود:
.IP
.nf
\f[C]
$ rclone lsl drive:dupes
  6048320 2016-03-05 16:23:16.798000000 one.txt
   564374 2016-03-05 16:22:52.118000000 two-1.txt
  6048320 2016-03-05 16:22:46.185000000 two-2.txt
  1744073 2016-03-05 16:22:38.104000000 two-3.txt
\f[R]
.fi
.PP
می‌توان dedupe را به‌صورت غیرتعاملی با استفاده از پرچم \f[V]--dedupe-mode\f[R] یا با استفاده از یک آرگومان اضافی با همان مقدار اجرا کرد
.IP \[bu] 2
\f[V]--dedupe-mode interactive\f[R] \- تعاملی همانند بالا.
.IP \[bu] 2
\f[V]--dedupe-mode skip\f[R] \- حذف فایل‌های یکسان و سپس نادیده گرفتن هر آنچه باقی مانده است.
.IP \[bu] 2
\f[V]--dedupe-mode first\f[R] \- حذف فایل‌های یکسان و سپس نگه‌داشتن نخستین مورد.
.IP \[bu] 2
\f[V]--dedupe-mode newest\f[R] \- حذف فایل‌های یکسان و سپس نگه‌داشتن جدیدترین مورد.
.IP \[bu] 2
\f[V]--dedupe-mode oldest\f[R] \- حذف فایل‌های یکسان و سپس نگه‌داشتن قدیمی‌ترین مورد..IP \[bu] 2
\f[V]--dedupe-mode largest\f[R] \- فایل‌های یکسان را حذف کرده و سپس بزرگ‌ترین فایل را نگه می‌دارد.
.IP \[bu] 2
\f[V]--dedupe-mode smallest\f[R] \- فایل‌های یکسان را حذف کرده و سپس کوچک‌ترین فایل را نگه می‌دارد.
.IP \[bu] 2
\f[V]--dedupe-mode rename\f[R] \- فایل‌های یکسان را حذف کرده و سپس نام بقیه را تغییر می‌دهد تا متمایز شوند.
.IP \[bu] 2
\f[V]--dedupe-mode list\f[R] \- فقط دایرکتوری‌ها و فایل‌های تکراری را فهرست می‌کند و هیچ تغییری ایجاد نمی‌کند.
.PP
برای مثال، جهت تغییر نام تمام عکس‌های هم‌نام در دایرکتوری Google Photos خود، دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone dedupe --dedupe-mode rename \[dq]drive:Google Photos\[dq]
\f[R]
.fi
.PP
یا
.IP
.nf
\f[C]
rclone dedupe rename \[dq]drive:Google Photos\[dq]
\f[R]
.fi
.IP
.nf
\f[C]
rclone dedupe [mode] remote:path [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --by-hash              Find identical hashes rather than names
      --dedupe-mode string   Dedupe mode interactive|skip|first|newest|oldest|largest|smallest|rename (default \[dq]interactive\[dq])
  -h, --help                 help for dedupe
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه گزینه‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "گزینه‌های مهم (Important Options)"
.PP
گزینه‌های مهم و کاربردی برای اکثر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         Do a trial run with no permanent changes
  -i, --interactive     Enable interactive mode
  -v, --verbose count   Print lots more stuff (repeat for more)
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، گزینه‌ها و backendهای rclone.
.SH "rclone about"
.PP
دریافت اطلاعات سهمیه فضا (quota) از ریموت.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
اطلاعات سهمیه فضا در مورد یک ریموت را در خروجی استاندارد چاپ می‌کند.
خروجی معمولاً شامل مقدار استفاده‌شده، آزاد، سهمیه و محتویات سطل زباله (trash) است.
.PP
برای مثال، خروجی معمول از \f[V]rclone about remote:\f[R] به صورت زیر است:
.IP
.nf
\f[C]
Total:   17 GiB
Used:    7.444 GiB
Free:    1.315 GiB
Trashed: 100.000 MiB
Other:   8.241 GiB
\f[R]
.fi
.PP
که در آن فیلدها عبارت‌اند از:
.IP \[bu] 2
Total: کل حجم در دسترس.
.IP \[bu] 2
Used: کل حجم استفاده‌شده.
.IP \[bu] 2
Free: کل فضای در دسترس برای این کاربر.
.IP \[bu] 2
Trashed: کل فضای اشغال‌شده توسط سطل زباله.
.IP \[bu] 2
Other: مقدار کل در سایر فضاهای ذخیره‌سازی (مانند Gmail، Google Photos).
.IP \[bu] 2
Objects: تعداد کل اشیاء در فضای ذخیره‌سازی.
.PP
تمامی اندازه‌ها بر حسب تعداد بایت هستند.
.PP
اعمال گزینه \f[V]--full\f[R] به دستور، بایت‌ها را به طور کامل چاپ می‌کند، مانند:
.IP
.nf
\f[C]
Total:   18253611008
Used:    7993453766
Free:    1411001220
Trashed: 104857602
Other:   8849156022
\f[R]
.fi
.PP
گزینه \f[V]--json\f[R] خروجی مناسب و ماشین‌خوان تولید می‌کند، مانند:
.IP
.nf
\f[C]
{
  \[dq]total\[dq]: 18253611008,
  \[dq]used\[dq]: 7993453766,
  \[dq]trashed\[dq]: 104857602,
  \[dq]other\[dq]: 8849156022,
  \[dq]free\[dq]: 1411001220
}
\f[R]
.fi
.PP
همه backendها تمامی فیلدها را چاپ نمی‌کنند.
اطلاعاتی که توسط یک backend ارائه نشود، در خروجی گنجانده نمی‌شود.
در مواردی که مقدار نامحدود باشد، حذف می‌گردد.
.PP
برخی backendها به هیچ وجه از دستور \f[V]rclone about\f[R] پشتیبانی نمی‌کنند؛ فهرست کامل را در
مستندات (https://rclone.org/overview/#optional-features) ببینید.
.IP
.nf
\f[C]
rclone about remote: [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --full   اعداد کامل به‌جای خوانا برای انسان
  -h, --help   راهنما برای about
      --json   قالب‌بندی خروجی به‌صورت JSON
\f[R]
.fi
.PP
برای دیدن گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH "rclone archive"
.PP
انجام یک عملیات روی یک بایگانی.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
انجام یک عملیات روی یک بایگانی.
برای تعیین پروتکل، نیاز به استفاده از یک زیردستور است؛ مانند:
.IP
.nf
\f[C]
rclone archive list remote:file.zip
\f[R]
.fi
.PP
هر زیردستور گزینه‌های ویژهٔ خود را دارد که می‌توانید آن‌ها را در راهنمای مربوطه‌شان ببینید.
.PP
برای قالب‌های بایگانی پشتیبانی‌شده، rclone archive create (https://rclone.org/commands/rclone_archive_create) را ببینید.
.IP
.nf
\f[C]
rclone archive <action> [opts] <source> [<destination>] [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنما برای archive
\f[R]
.fi
.PP
برای دیدن گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.IP \[bu] 2
rclone archive create (https://rclone.org/commands/rclone_archive_create) \- بایگانی کردن فایل(های) مبدأ در مقصد.
.IP \[bu] 2
rclone archive extract (https://rclone.org/commands/rclone_archive_extract) \- استخراج بایگانی‌ها از مبدأ به مقصد.
.IP \[bu] 2
rclone archive list (https://rclone.org/commands/rclone_archive_list) \- فهرست کردن محتویات بایگانی از مبدأ.
.SH "rclone archive create"
.PP
بایگانی کردن فایل(های) مبدأ در مقصد.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
از فایل‌های موجود در source:path یک بایگانی می‌سازد و آن را در dest:path ذخیره می‌کند.
اگر dest:path مشخص نشده باشد، خروجی در کنسول نوشته خواهد شد.
.PP
قالب‌های معتبر برای پرچم \f[V]--format\f[R] در زیر فهرست شده‌اند.
اگر \f[V]--format\f[R] تنظیم نشده باشد، rclone آن را از روی پسوند dest:path حدس خواهد زد.
.PP
.TS
tab(@);
l l.
T{
قالب
T}@T{
پسوندها
T}
_
T{
zip
T}@T{
\&.zip
T}
T{
tar
T}@T{
\&.tar
T}
T{
tar.gz
T}@T{
\&.tar.gz, .tgz, .taz
T}
T{
tar.bz2
T}@T{
\&.tar.bz2, .tb2, .tbz, .tbz2, .tz2
T}
T{
tar.lz
T}@T{
\&.tar.lz
T}
T{
tar.lz4
T}@T{
\&.tar.lz4
T}
T{
tar.xz
T}@T{
\&.tar.xz, .txz
T}
T{
tar.zst
T}@T{
\&.tar.zst, .tzst
T}
T{
tar.br
T}@T{
\&.tar.br
T}
T{
tar.sz
T}@T{
\&.tar.sz
T}
T{
tar.mz
T}@T{
\&.tar.mz
T}
.TE
.PP
پرچم‌های \f[V]--prefix\f[R] و \f[V]--full-path\f[R] پیشوند فایل‌ها را در بایگانی کنترل می‌کنند.
.PP
اگر پرچم \f[V]--full-path\f[R] تنظیم شده باشد، فایل‌ها مسیر کامل مبدأ را به‌عنوان پیشوند خواهند داشت.
.PP
اگر پرچم \f[V]--prefix=<value>\f[R] تنظیم شده باشد، فایل‌ها \f[V]<value>\f[R] را به‌عنوان پیشوند خواهند داشت.
با \f[V]--prefix=<value>\f[R] امکان ایجاد نام‌های فایل نامعتبر وجود دارد، بنابراین با احتیاط استفاده کنید.
پرچم \f[V]--prefix\f[R] نسبت به \f[V]--full-path\f[R] اولویت دارد.
.PP
با فرض دایرکتوری \f[V]/sourcedir\f[R] با محتویات زیر:
.IP
.nf
\f[C]
file1.txt
dir1/file2.txt
\f[R]
.fi
.PP
اجرای دستور \f[V]rclone archive create /sourcedir /dest.tar.gz\f[R] یک بایگانی با محتویات زیر ایجاد می‌کند:
.IP
.nf
\f[C]
file1.txt
dir1/
dir1/file2.txt
\f[R]
.fi
.PP
اجرای دستور \f[V]rclone archive create --full-path /sourcedir /dest.tar.gz\f[R] یک بایگانی با محتویات زیر ایجاد می‌کند:.IP
.nf
\f[C]
sourcedir/file1.txt
sourcedir/dir1/
sourcedir/dir1/file2.txt
\f[R]
.fi
.PP
اجرای دستور
\f[V]rclone archive create --prefix=my_new_path /sourcedir /dest.tar.gz\f[R]
آرشیوی با محتویات زیر ایجاد خواهد کرد:
.IP
.nf
\f[C]
my_new_path/file1.txt
my_new_path/dir1/
my_new_path/dir1/file2.txt
\f[R]
.fi
.IP
.nf
\f[C]
rclone archive create [flags] <source> [<destination>]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --format string   ایجاد آرشیو با قالب مشخص یا حدس از روی پسوند.
      --full-path       تنظیم پیشوند برای فایل‌های درون آرشیو روی مسیر مبدأ
  -h, --help            راهنمای create
      --prefix string   تنظیم پیشوند برای فایل‌های درون آرشیو روی مقدار واردشده یا مسیر مبدأ
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone archive (https://rclone.org/commands/rclone_archive) \- انجام
یک عملیات روی یک آرشیو.
.SH rclone archive extract
.PP
استخراج آرشیوها از مبدأ به مقصد.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
استخراج محتویات آرشیو به یک پوشه مقصد با تشخیص خودکار قالب.
برای دیدن قالب‌های آرشیو پشتیبانی‌شده، rclone archive
create (https://rclone.org/commands/rclone_archive_create) را بررسی کنید.
.PP
برای نمونه در این آرشیو:
.IP
.nf
\f[C]
$ rclone archive list --long remote:archive.zip
        6 2025-10-30 09:46:23.000000000 file.txt
        0 2025-10-30 09:46:57.000000000 dir/
        4 2025-10-30 09:46:57.000000000 dir/bye.txt
\f[R]
.fi
.PP
می‌توانید استخراج را بدین صورت اجرا کنید:
.IP
.nf
\f[C]
$ rclone archive extract remote:archive.zip remote:extracted
\f[R]
.fi
.PP
که نتیجه زیر را می‌دهد:
.IP
.nf
\f[C]
$ rclone tree remote:extracted
/
├── dir
│   └── bye.txt
└── file.txt
\f[R]
.fi
.PP
مبدأ یا مقصد یا هر دوی آن‌ها می‌توانند محلی یا دوردست (remote) باشند.
.PP
می‌توان از فیلترها برای استخراج تنها فایل‌های مشخصی استفاده کرد:
.IP
.nf
\f[C]
$ rclone archive extract archive.zip partial --include \[dq]bye.*\[dq]
$ rclone tree partial
/
└── dir
    └── bye.txt
\f[R]
.fi
.PP
از بک‌اند archive (https://rclone.org/archive) نیز می‌توان برای استخراج فایل‌ها استفاده کرد.
همچنین می‌توان از آن برای سوار کردن (mount) فقط‌خواندنی آرشیوها استفاده کرد، اما این بخش از مجموعه قالب‌های متفاوتی نسبت به دستورهای archive پشتیبانی می‌کند.
.IP
.nf
\f[C]
rclone archive extract [flags] <source> <destination>
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمایی برای extract
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (<https://rclone.org/flags>) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone archive (<https://rclone.org/commands/rclone_archive>) \- انجام یک عملیات روی یک بایگانی.
.SH rclone archive list
.PP
فهرست‌کردن محتویات بایگانی از مبدأ.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
محتویات یک بایگانی را با تشخیص خودکار قالب آن، در کنسول فهرست می‌کند.
برای قالب‌های بایگانی پشتیبانی‌شده، rclone archive create (<https://rclone.org/commands/rclone_archive_create>) را ببینید.
.PP
برای مثال:
.IP
.nf
\f[C]
$ rclone archive list remote:archive.zip
        6 file.txt
        0 dir/
        4 dir/bye.txt
\f[R]
.fi
.PP
یا با پرچم \f[V]--long\f[R] برای اطلاعات بیشتر:
.IP
.nf
\f[C]
$ rclone archive list --long remote:archive.zip
        6 2025-10-30 09:46:23.000000000 file.txt
        0 2025-10-30 09:46:57.000000000 dir/
        4 2025-10-30 09:46:57.000000000 dir/bye.txt
\f[R]
.fi
.PP
یا با پرچم \f[V]--plain\f[R] که برای اسکریپت‌نویسی مفید است:
.IP
.nf
\f[C]
$ rclone archive list --plain /path/to/archive.zip
file.txt
dir/
dir/bye.txt
\f[R]
.fi
.PP
یا با \f[V]--dirs-only\f[R]:
.IP
.nf
\f[C]
$ rclone archive list --plain --dirs-only /path/to/archive.zip
dir/
\f[R]
.fi
.PP
یا با \f[V]--files-only\f[R]:
.IP
.nf
\f[C]
$ rclone archive list --plain --files-only /path/to/archive.zip
file.txt
dir/bye.txt
\f[R]
.fi
.PP
فیلترها نیز می‌توانند استفاده شوند:
.IP
.nf
\f[C]
$ rclone archive list --long archive.zip --include \[dq]bye.*\[dq]
        4 2025-10-30 09:46:57.000000000 dir/bye.txt
\f[R]
.fi
.PP
همچنین می‌توان از بک‌اند archive (<https://rclone.org/archive>) برای فهرست‌کردن فایل‌ها استفاده کرد.
از این بک‌اند می‌توان برای سوار کردن (mount) فقط‌خواندنی بایگانی‌ها نیز بهره برد، اما از مجموعه‌ای متفاوت از قالب‌های بایگانی نسبت به دستورات archive پشتیبانی می‌کند.
.IP
.nf
\f[C]
rclone archive list [flags] <source>
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --dirs-only    تنها فهرست کردن دایرکتوری‌ها
      --files-only   تنها فهرست کردن فایل‌ها
  -h, --help         راهنمای list
      --long         فهرست کردن ویژگی‌های اضافی
      --plain        تنها فهرست کردن نام فایل‌ها
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone archive (https://rclone.org/commands/rclone_archive) \- انجام یک عملیات روی یک آرشیو.
.SH rclone authorize
.PP
احراز هویت ریموت.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
احراز هویت ریموت.
برای احراز هویت یک rclone ریموت یا headless از طریق دستگاهی دارای
مرورگر استفاده می‌شود.
مطابق دستورالعمل rclone config استفاده کنید.
همچنین مستندات راه‌اندازی ریموت را ببینید.
.PP
این دستور به ۱ تا ۳ آرگومان نیاز دارد:
.IP \[bu] 2
نام یک backend (مانند
\[dq]drive\[dq]، \[dq]s3\[dq])
.IP \[bu] 2
یا یک قطعه‌دادهٔ JSON کدگذاری‌شده با base64 به‌دست‌آمده از یک نشست پیشین
rclone config
.IP \[bu] 2
یا یک جفت client_id و client_secret به‌دست‌آمده از سرویس ریموت
.PP
از --auth-no-open-browser برای جلوگیری از باز شدن خودکار پیوند احراز هویت در
مرورگر پیش‌فرض توسط rclone استفاده کنید.
.PP
از --template برای تولید خروجی HTML از طریق یک قالب سفارشی Go استفاده کنید.
اگر یک رشتهٔ خالی به عنوان آرگومان به این گزینه داده شود، از قالب
پیش‌فرض استفاده می‌شود.
.IP
.nf
\f[C]
rclone authorize <backendname> [base64_json_blob | client_id client_secret] [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --auth-no-open-browser   عدم باز کردن خودکار پیوند احراز هویت در مرورگر پیش‌فرض
  -h, --help                   راهنمای authorize
      --template string        مسیر یک قالب سفارشی Go برای تولید پاسخ‌های HTML
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورات، پرچم‌ها و backendهای rclone.
.SH rclone backend
.PP
اجرای یک دستور مختص backend.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور یک فرمان مختص backend را اجرا می‌کند.
خود دستورات (به جز \[dq]help\[dq] و
\[dq]features\[dq]) توسط backendها تعریف می‌شوند و برای تعاریف آن‌ها باید به
مستندات backend مراجعه کنید.
.PP
می‌توانید با استفاده از دستورات زیر بررسی کنید که یک backend چه دستوراتی را پیاده‌سازی کرده است:
.IP
.nf
\f[C]
rclone backend help remote:
rclone backend help <backendname>
\f[R]
.fi
.PP
همچنین می‌توانید اطلاعاتی دربارهٔ backend با استفاده از این دستور به‌دست آورید (برای اطلاعات بیشتر
operations/fsinfo (https://rclone.org/rc/#operations-fsinfo) را در
مستندات کنترل از راه دور ببینید).
.IP
.nf
\f[C]
rclone backend features remote:
\f[R]
.fi
.PP
گزینه‌ها را با -o به دستور backend ارسال کنید.
این مقدار باید به صورت key=value یا key باشد، مانند:
.IP
.nf
\f[C]
rclone backend stats remote:path stats -o format=json -o long
\f[R]
.fi
.PP
آرگومان‌ها را با قرار دادن آن‌ها در انتهای خط به backend ارسال کنید:
.IP
.nf
\f[C]
rclone backend cleanup remote:path file1 file2 file3
\f[R]
.fi
.PP
توجه داشته باشید که برای اجرای این دستورات روی یک backend در حال اجرا،
backend/command (https://rclone.org/rc/#backend-command) را در مستندات rc ببینید.
.IP
.nf
\f[C]
rclone backend <command> remote:path [opts] <args> [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help                 راهنمایی برای backend
      --json                 همیشه خروجی در قالب JSON باشد
  -o, --option stringArray   گزینه به شکل name=value یا name
\f[R]
.fi
.PP
گزینه‌های مشترک با دیگر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، به صفحه نشان‌های سراسری (https://rclone.org/flags)
مراجعه کنید.
.SS "گزینه‌های مهم (Important Options)"
.PP
نشان‌های مهم و کاربردی برای بیشتر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ اطلاعات بسیار بیشتر (برای جزئیات بیشتر تکرار کنید)
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، نشان‌ها و backendهای rclone.
.SH rclone bisync
.PP
همگام‌سازی دوطرفه بین دو مسیر را انجام می‌دهد.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
همگام‌سازی دوطرفه بین دو مسیر را انجام می‌دهد.
.PP
ابزار Bisync (https://rclone.org/bisync) یک راهکار همگام‌سازی ابری دوطرفه در rclone فراهم می‌کند.
این ابزار فهرست فایل‌سیستم‌های Path1 و Path2 را از اجرای قبلی نگه‌داری می‌کند.
در هر اجرای متوالی، این ابزار:
.IP \[bu] 2
فایل‌های موجود در Path1 و Path2 را فهرست کرده و تغییرات هر دو طرف را بررسی می‌کند.
تغییرات شامل فایل‌های \f[V]New\f[R]، \f[V]Newer\f[R]، \f[V]Older\f[R] و
\f[V]Deleted\f[R] است.
.IP \[bu] 2
تغییرات روی Path1 را به Path2 منتقل می‌کند و برعکس.
.PP
دستور Bisync یک \f[B]دستور پیشرفته\f[R] به شمار می‌رود، بنابراین با احتیاط از آن استفاده کنید.
اطمینان حاصل کنید که پیش از استفاده، کل راهنما (https://rclone.org/bisync) (به‌ویژه بخش
محدودیت‌ها (https://rclone.org/bisync/#limitations)) را مطالعه کرده و متوجه شده‌اید، در غیر این صورت ممکن است اطلاعات از بین بروند.
پرسش‌ها را می‌توان در تالار گفتگوی Rclone (https://forum.rclone.org) مطرح کرد.
.PP
برای جزئیات، توضیحات کامل bisync (https://rclone.org/bisync) را ببینید.
.IP
.nf
\f[C]
rclone bisync remote1:path1 remote2:path2 [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --backup-dir1 string                   --backup-dir برای Path1. باید مسیری بدون همپوشانی روی همان ریموت باشد.
      --backup-dir2 string                   --backup-dir برای Path2. باید مسیری بدون همپوشانی روی همان ریموت باشد.
      --check-access                         اطمینان از وجود فایل‌های مورد انتظار RCLONE_TEST در هر دو فایل‌سیستم Path1 و Path2، در غیر این صورت لغو عملیات.
      --check-filename string                نام فایل برای --check-access (پیش‌فرض: RCLONE_TEST)
      --check-sync string                    کنترل مقایسه فهرست‌های نهایی: true|false|only (پیش‌فرض: true) (پیش‌فرض \[dq]true\[dq])
      --compare string                       فهرست جداشده با کاما از گزینه‌های مقایسه ویژه bisync مانند \[aq]size,modtime,checksum\[aq] (پیش‌فرض: \[aq]size,modtime\[aq])
      --conflict-loser ConflictLoserAction   اقدام لازم در برابر فایل مغلوب تعارض همگام‌سازی (در صورت وجود برنده) یا هر دو فایل (در صورت نبود برنده): ، num، pathname، delete (پیش‌فرض: num)
      --conflict-resolve string              حل خودکار تعارض‌ها با اولویت دادن به نسخه‌ای که: none, path1, path2, newer, older, larger, smaller باشد (پیش‌فرض: none) (پیش‌فرض \[dq]none\[dq])
      --conflict-suffix string               پسوند مورد استفاده هنگام تغییر نام --conflict-loser. می‌تواند یک رشته یا دو رشته جداشده با کاما برای تخصیص پسوندهای متفاوت به Path1/Path2 باشد. (پیش‌فرض: \[aq]conflict\[aq])
      --create-empty-src-dirs                همگام‌سازی ایجاد و حذف دایرکتوری‌های خالی. (با --remove-empty-dirs سازگار نیست)
      --download-hash                        محاسبه هش با دانلود در صورت در دسترس نبودن از راه‌های دیگر. (هشدار: ممکن است کند باشد و حجم زیادی مصرف کند!)
      --filters-file string                  خواندن الگوهای فیلترسازی از یک فایل
      --force                                نادیده گرفتن بررسی ایمنی --max-delete و اجرای همگام‌سازی. استفاده به همراه --verbose توصیه می‌شود
  -h, --help                                 راهنمایی برای bisync
      --ignore-listing-checksum              عدم استفاده از checksum برای فهرست‌گیری‌ها (افزودن --ignore-checksum برای صرف‌نظر از بررسی‌های checksum پس از کپی)
      --max-lock Duration                    منقضی دانستن فایل‌های قفل قدیمی‌تر از این مقدار (پیش‌فرض: 0 (هرگز منقضی نشود)) (حداقل: 2m) (پیش‌فرض 0s)
      --no-cleanup                           نگه‌داری فایل‌های کاری (کاربردی برای عیب‌یابی و آزمایش).
      --no-slow-hash                         نادیده گرفتن checksum فهرست‌گیری تنها در backendهایی که کند هستند
      --recover                              بازیابی خودکار پس از توقف‌ها بدون نیاز به --resync.
      --remove-empty-dirs                    حذف تمام دایرکتوری‌های خالی در مرحله پاک‌سازی نهایی.
      --resilient                            امکان تلاش مجدد در اجراهای بعدی پس از خطاهای خاص کم‌اهمیت‌تر، به جای الزام به --resync.
  -1, --resync                               اجرای همگام‌سازی مجدد (resync). معادل با --resync-mode path1. ابتدا استفاده از --verbose یا --dry-run را مد نظر قرار دهید.
      --resync-mode string                   در حین resync، اولویت دادن به نسخه‌ای که: path1, path2, newer, older, larger, smaller باشد (پیش‌فرض: path1 در صورت --resync، در غیر این صورت none برای عدم resync.) (پیش‌فرض \[dq]none\[dq])
      --slow-hash-sync-only                  نادیده گرفتن checksumهای کند برای فهرست‌ها و دلتاها، ولی لحاظ کردن آن‌ها در فراخوانی‌های همگام‌سازی.
      --workdir string                       استفاده از دایرکتوری کاری سفارشی - کاربردی برای آزمایش. (پیش‌فرض: $HOME/.cache/rclone/bisync)
\f[R]
.fi
.PP
گزینه‌های مشترک با دیگر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، به صفحه نشان‌های سراسری (https://rclone.org/flags)
مراجعه کنید..SS "گزینه‌های کپی (Copy Options)"
.PP
پرچم‌ها برای هر آنچه که می‌تواند فایلی را کپی کند
.IP
.nf
\f[C]
      --check-first                                 انجام تمام بررسی‌ها پیش از آغاز انتقال‌ها
  -c, --checksum                                    بررسی تغییرات با اندازه و checksum (در صورت دسترسی، یا بازگشت به فقط اندازه)
      --compare-dest stringArray                    لحاظ کردن مسیرهای سمت سرور اضافی در طول مقایسه
      --copy-dest stringArray                       ضمن اعمال --compare-dest، فایل‌ها را نیز از مسیرها به مقصد کپی می‌کند
      --cutoff-mode HARD|SOFT|CAUTIOUS              حالت متوقف کردن انتقال‌ها هنگام رسیدن به سقف انتقال: HARD|SOFT|CAUTIOUS (پیش‌فرض HARD)
      --ignore-case-sync                            نادیده گرفتن بزرگی و کوچکی حروف هنگام همگام‌سازی
      --ignore-checksum                             صرف‌نظر از بررسی checksum پس از کپی
      --ignore-existing                             صرف‌نظر از تمام فایل‌های موجود در مقصد
      --ignore-size                                 نادیده گرفتن اندازه هنگام صرف‌نظر کردن؛ استفاده از modtime یا checksum
  -I, --ignore-times                                عدم صرف‌نظر از موارد با اندازه و زمان یکسان \- انتقال همه بدون قید و شرط
      --immutable                                   عدم تغییر فایل‌ها؛ در صورت تغییر فایل‌های موجود با شکست مواجه شود
      --inplace                                     دانلود مستقیم درون فایل مقصد به جای دانلود اتمیک در فایل موقت و تغییر نام
  -l, --links                                       تبدیل پیوندهای نمادین (symlinks) به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq]
      --max-backlog int                             حداکثر تعداد اشیاء در صف همگام‌سازی یا بررسی (پیش‌فرض 10000)
      --max-duration Duration                       حداکثر مدتی که rclone داده‌ها را انتقال می‌دهد (پیش‌فرض 0s)
      --max-transfer SizeSuffix                     حداکثر حجم داده برای انتقال (پیش‌فرض off)
  -M, --metadata                                    در صورت تنظیم، حفظ متادیتا هنگام کپی کردن اشیاء
      --modify-window Duration                      حداکثر اختلاف زمانی برای یکسان در نظر گرفته شدن (پیش‌فرض 1ns)
      --multi-thread-chunk-size SizeSuffix          اندازه تکه برای دانلودها/آپلودهای چندرشته‌ای، اگر توسط سیستم‌فایل تعیین نشده باشد (پیش‌فرض 64Mi)
      --multi-thread-cutoff SizeSuffix              استفاده از دانلود چندرشته‌ای برای فایل‌های بزرگ‌تر از این اندازه (پیش‌فرض 256Mi)
      --multi-thread-streams int                    تعداد جریان‌ها برای استفاده در دانلودهای چندرشته‌ای (پیش‌فرض 4)
      --multi-thread-write-buffer-size SizeSuffix   اندازه بافر در حافظه برای نوشتن در حالت چندرشته‌ای (پیش‌فرض 128Ki)
      --name-transform stringArray                  تبدیل مسیرها در طول فرایند کپی
      --no-check-dest                               مقصد را بررسی نکن، در هر صورت کپی کن
      --no-traverse                                 عدم پیمایش سیستم‌فایل مقصد هنگام کپی
      --no-update-dir-modtime                       زمان تغییر دایرکتوری‌ها به‌روزرسانی نشود
      --no-update-modtime                           در صورت یکسان بودن فایل‌ها، modtime مقصد به‌روزرسانی نشود
      --order-by string                             دستورالعمل چگونگی مرتب‌سازی انتقال‌ها، مانند \[aq]size,descending\[aq]
      --partial-suffix string                       افزودن partial-suffix به نام فایل موقت هنگامی که --inplace استفاده نشده است (پیش‌فرض \[dq].partial\[dq])
      --refresh-times                               تازه‌سازی modtime فایل‌های راه دور
      --server-side-across-configs                  اجازه به عملیات سمت سرور (مانند کپی) برای کار میان پیکربندی‌های مختلف
      --size-only                                   صرف‌نظر کردن فقط بر اساس اندازه، نه modtime یا checksum
      --streaming-upload-cutoff SizeSuffix          آستانه جابجایی به آپلود تکه‌ای در صورت نامشخص بودن اندازه فایل، آپلود پس از رسیدن به آستانه یا پایان فایل آغاز می‌شود (پیش‌فرض 100Ki)
  -u, --update                                      صرف‌نظر از فایل‌هایی که در مقصد جدیدتر هستند
\f[R]
.fi
.SS "گزینه‌های همگام‌سازی (Sync Options)"
.PP
پرچم‌های مورد استفاده برای دستورهای همگام‌سازی
.IP
.nf
\f[C]
      --backup-dir string               تهیه پشتیبان در ساختار سلسله‌مراتبی مستقر در DIR
      --delete-after                    هنگام همگام‌سازی، حذف فایل‌ها در مقصد پس از انتقال (پیش‌فرض)
      --delete-before                   هنگام همگام‌سازی، حذف فایل‌ها در مقصد پیش از انتقال
      --delete-during                   هنگام همگام‌سازی، حذف فایل‌ها در حین انتقال
      --fix-case                        تغییر نام اجباری مقصد بدون حساسیت به حروف جهت مطابقت با مبدأ
      --ignore-errors                   حذف حتی در صورت بروز خطاهای I/O
      --list-cutoff int                 برای صرفه‌جویی در حافظه، مرتب‌سازی فهرست‌های دایرکتوری روی دیسک بیش از این آستانه (پیش‌فرض 1000000)
      --max-delete int                  هنگام همگام‌سازی، محدود کردن تعداد حذف‌ها (پیش‌فرض \-1)
      --max-delete-size SizeSuffix      هنگام همگام‌سازی، محدود کردن کل حجم حذفیات (پیش‌فرض off)
      --suffix string                   پسوند برای افزودن به فایل‌های تغییریافته
      --suffix-keep-extension           حفظ پسوند فایل هنگام استفاده از --suffix
      --track-renames                   هنگام همگام‌سازی، ردگیری تغییر نام فایل‌ها و انتقال سمت سرور در صورت امکان
      --track-renames-strategy string   راهبردهای مورد استفاده هنگام همگام‌سازی با track-renames: hash|modtime|leaf (پیش‌فرض \[dq]hash\[dq])
\f[R]
.fi
.SS "گزینه‌های مهم (Important Options)"
.PP
پرچم‌های مهم و کاربردی برای اکثر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ اطلاعات بسیار بیشتر (تکرار برای جزئیات بیشتر)
\f[R]
.fi
.SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌ها برای فیلتر کردن فهرست‌های دایرکتوری
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های مستثنی‌شده از همگام‌سازی در مقصد
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از \- برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل مبدأ از فایل (استفاده از \- برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل مبدأ از فایل بدون پردازش خطوط (استفاده از \- برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل مبدأ از فایل با جداکننده NUL (استفاده از \- برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قانون فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از فایل (استفاده از \- برای خواندن از stdin)
      --hash-filter string                  افراز نام فایل‌ها با هش k/n یا تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از \- برای خواندن از stdin)
      --max-age Duration                    فقط انتقال فایل‌های جدیدتر از این مقدار به ثانیه یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --max-depth int                       در صورت تعیین، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض \-1)
      --max-size SizeSuffix                 فقط انتقال فایل‌های کوچک‌تر از این مقدار به KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض off)
      --metadata-exclude stringArray        مستثنی کردن متادیتاهای منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متادیتا از فایل (استفاده از \- برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قانون فیلتر کردن متادیتا
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متادیتا از فایل (استفاده از \- برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن متادیتاهای منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متادیتا از فایل (استفاده از \- برای خواندن از stdin)
      --min-age Duration                    فقط انتقال فایل‌های قدیمی‌تر از این مقدار به ثانیه یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --min-size SizeSuffix                 فقط انتقال فایل‌های بزرگ‌تر از این مقدار به KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض off)
\f[R]
.fi.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone cat
.PP
فایل‌ها را متصل کرده و به stdout ارسال می‌کند.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
فایل‌ها را به خروجی استاندارد ارسال می‌کند.
.PP
می‌توانید برای چاپ خروجی یک فایل منفرد، به این شکل از آن استفاده کنید:
.IP
.nf
\f[C]
rclone cat remote:path/to/file
\f[R]
.fi
.PP
یا به این صورت برای ارسال هر فایلی در dir یا زیرپوشه‌های آن به خروجی:
.IP
.nf
\f[C]
rclone cat remote:path/to/dir
\f[R]
.fi
.PP
یا به این شکل برای ارسال فایل‌های .txt در dir یا زیرپوشه‌های آن به خروجی:
.IP
.nf
\f[C]
rclone --include \[dq]*.txt\[dq] cat remote:path/to/dir
\f[R]
.fi
.PP
از پرچم \f[V]--head\f[R] برای چاپ نویسه‌ها تنها در ابتدا، از \f[V]--tail\f[R] برای انتها، و از \f[V]--offset\f[R] و \f[V]--count\f[R] برای چاپ بخشی در میانه استفاده کنید.
توجه داشته باشید که اگر مقدار offset منفی باشد، شمارش از انتها انجام می‌شود؛ بنابراین \f[V]--offset -1 --count 1\f[R] معادل \f[V]--tail 1\f[R] است.
.PP
از پرچم \f[V]--separator\f[R] برای چاپ یک مقدار جداکننده میان فایل‌ها استفاده کنید.
حتماً نویسه‌های خاص را برای پوسته گریزدهی (shell-escape) کنید.
برای نمونه، جهت چاپ یک خط تازه میان فایل‌ها، از موارد زیر استفاده کنید:
.IP \[bu] 2
bash:
.RS 2
.IP
.nf
\f[C]
rclone --include \[dq]*.txt\[dq] --separator $\[aq]\[rs]n\[aq] cat remote:path/to/dir
\f[R]
.fi
.RE
.IP \[bu] 2
powershell:
.RS 2
.IP
.nf
\f[C]
rclone --include \[dq]*.txt\[dq] --separator \[dq]\[ga]n\[dq] cat remote:path/to/dir
\f[R]
.fi
.RE
.IP
.nf
\f[C]
rclone cat remote:path [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --count int          تنها چاپ N نویسه (پیش‌فرض -1)
      --discard            دور انداختن خروجی به جای چاپ آن
      --head int           تنها چاپ N نویسه نخست
  -h, --help               راهنمای cat
      --offset int         شروع چاپ از آفست N (یا از انتها در صورت منفی بودن)
      --separator string   جداکننده مورد استفاده میان اشیاء هنگام چاپ چندین فایل
      --tail int           تنها چاپ N نویسه پایانی
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری
(https://rclone.org/flags) را ببینید..SS گزینه‌های فیلتر (Filter Options)
.PP
پرچم‌هایی برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (برای خواندن از stdin از - استفاده کنید)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود داشتن نام فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل‌های مبدأ از فایل (برای خواندن از stdin از - استفاده کنید)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل‌های مبدأ از فایل بدون هیچ پردازشی روی خطوط (برای خواندن از stdin از - استفاده کنید)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل‌های مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (برای خواندن از stdin از - استفاده کنید)
  -f, --filter stringArray                  افزودن یک قانون فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --hash-filter string                  افراز نام فایل‌ها با هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف کوچک و بزرگ)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (برای خواندن از stdin از - استفاده کنید)
      --max-age Duration                    انتقال فایل‌های جدیدتر از این مقدار بر حسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تنظیم، محدود کردن عمق بازگشت به این مقدار (پیش‌فرض -1)
      --max-size SizeSuffix                 انتقال فایل‌های کوچک‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (برای خواندن از stdin از - استفاده کنید)
      --metadata-filter stringArray         افزودن یک قانون فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر متاداده از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از فایل (برای خواندن از stdin از - استفاده کنید)
      --min-age Duration                    انتقال فایل‌های قدیمی‌تر از این مقدار بر حسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 انتقال فایل‌های بزرگ‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS گزینه‌های فهرست‌کردن (Listing Options)
.PP
پرچم‌هایی برای فهرست کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست بازگشتی در صورت در دسترس بودن؛ حافظه بیشتری مصرف می‌کند اما تراکنش‌های کمتری دارد
\f[R]
.fi
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone checksum
.PP
بررسی فایل‌های مقصد در مقایسه با یک فایل SUM.
.SS خلاصه دستور (SYNOPSIS)
.PP
بررسی می‌کند که مقادیر درهم‌سازی (hashsums) فایل‌های مقصد با فایل SUM مطابقت داشته باشند.
این دستور هش‌ها (مانند MD5، SHA1 و غیره) را مقایسه کرده و گزارشی از فایل‌هایی که مطابقت ندارند ثبت می‌کند.
این دستور تغییری در سیستم فایل ایجاد نمی‌کند.
.PP
برای اهداف خروجی، فایل sumfile به‌عنوان مبدأ و dst:path به‌عنوان مقصد در نظر گرفته می‌شود.
.PP
اگر پرچم \f[V]--download\f[R] را مشخص کنید، داده‌ها را از ریموت دانلود کرده و هش محتوا را به‌طور هم‌زمان و برخط محاسبه می‌کند.
این قابلیت می‌تواند برای ریموت‌هایی که از هش پشتیبانی نمی‌کنند یا اگر واقعاً قصد بررسی تمام داده‌ها را دارید مفید باشد.
.PP
توجه داشته باشید که مقادیر هش در فایل SUM به بزرگی و کوچکی حروف حساس نیستند.
.PP
اگر پرچم \f[V]--one-way\f[R] را مشخص کنید، فقط بررسی می‌کند که فایل‌های موجود در مبدأ با فایل‌های مقصد مطابقت داشته باشند، نه برعکس.
این بدان معناست که فایل‌های اضافی موجود در مقصد که در مبدأ نیستند شناسایی نخواهند شد.
.PP
پرچم‌های \f[V]--differ\f[R]، \f[V]--missing-on-dst\f[R]،
\f[V]--missing-on-src\f[R]، \f[V]--match\f[R] و \f[V]--error\f[R]
مسیرها را، هر کدام در یک خط، در نام فایل ارائه‌شده (یا اگر
\f[V]-\f[R] باشد در خروجی استاندارد stdout) می‌نویسند.
آنچه می‌نویسند در راهنمای زیر شرح داده شده است.
به‌عنوان مثال، \f[V]--differ\f[R] تمام مسیرهایی را که هم در مبدأ و هم در مقصد وجود دارند اما با یکدیگر تفاوت دارند می‌نویسد.
.PP
پرچم \f[V]--combined\f[R] فایلی (یا در stdout) می‌نویسد که شامل تمام مسیرهای فایل به همراه یک نماد، سپس یک فاصله و پس از آن مسیر است تا نشان دهد چه اتفاقی برای آن افتاده است.
این موارد یادآور فایل‌های diff هستند.
.IP \[bu] 2
\f[V]= path\f[R] به این معنی است که مسیر در مبدأ و مقصد یافت شد و یکسان بود
.IP \[bu] 2
\f[V]- path\f[R] به این معنی است که مسیر در مبدأ وجود نداشت، بنابراین فقط در مقصد موجود است
.IP \[bu] 2
\f[V]+ path\f[R] به این معنی است که مسیر در مقصد وجود نداشت، بنابراین فقط در مبدأ موجود است
.IP \[bu] 2
\f[V]* path\f[R] به این معنی است که مسیر در مبدأ و مقصد وجود داشت اما با یکدیگر متفاوت بود.
.IP \[bu] 2
\f[V]! path\f[R] به این معنی است که در خواندن یا محاسبه هش مبدأ یا مقصد خطایی رخ داده است.
.PP
تعداد پیش‌فرض بررسی‌های موازی ۸ است.
برای اطلاعات بیشتر گزینه --checkers (https://rclone.org/docs/#checkers-int) را ببینید.
.IP
.nf
\f[C]
rclone checksum <hash> sumfile dst:path [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --combined string         ایجاد یک گزارش ترکیبی از تغییرات در این فایل
      --differ string           گزارش تمام فایل‌های غیرمنطبق در این فایل
      --download                بررسی از طریق درهم‌سازی (هش‌کردن) محتوا
      --error string            گزارش تمام فایل‌های دارای خطا (درهم‌سازی یا خواندن) در این فایل
  -h, --help                    راهنما برای checksum
      --match string            گزارش تمام فایل‌های منطبق در این فایل
      --missing-on-dst string   گزارش تمام فایل‌های مفقود در مقصد در این فایل
      --missing-on-src string   گزارش تمام فایل‌های مفقود در مبدأ در این فایل
      --one-way                 بررسی فقط به‌صورت یک‌طرفه، فایل‌های مبدأ باید در ریموت موجود باشند
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌هایی برای فیلترکردن فهرست‌های دایرکتوری
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی‌کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از یک فایل (برای خواندن از stdin از \- استفاده کنید)
      --exclude-if-present stringArray      مستثنی‌کردن دایرکتوری‌ها در صورت وجود این نام فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل‌های مبدأ از یک فایل (برای خواندن از stdin از \- استفاده کنید)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل‌های مبدأ از یک فایل بدون هیچ پردازشی روی خطوط (برای خواندن از stdin از \- استفاده کنید)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل‌های مبدأ از یک فایل با استفاده از NUL به‌عنوان جداکننده (برای خواندن از stdin از \- استفاده کنید)
  -f, --filter stringArray                  افزودن یک قاعده فیلترکردن فایل
      --filter-from stringArray             خواندن الگوهای فیلترکردن فایل از یک فایل (برای خواندن از stdin از \- استفاده کنید)
      --hash-filter string                  افرازبندی نام‌های فایل با هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده‌گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به بزرگی و کوچکی حروف)
      --include stringArray                 شامل‌کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از یک فایل (برای خواندن از stdin از \- استفاده کنید)
      --max-age Duration                    فقط انتقال فایل‌هایی با عمر کمتر از این مقدار، برحسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض \-1)
      --max-size SizeSuffix                 فقط انتقال فایل‌های کوچک‌تر از این مقدار، برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض off)
      --metadata-exclude stringArray        مستثنی‌کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از یک فایل (برای خواندن از stdin از \- استفاده کنید)
      --metadata-filter stringArray         افزودن یک قاعده فیلترکردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلترکردن متاداده از یک فایل (برای خواندن از stdin از \- استفاده کنید)
      --metadata-include stringArray        شامل‌کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از یک فایل (برای خواندن از stdin از \- استفاده کنید)
      --min-age Duration                    فقط انتقال فایل‌هایی با عمر بیشتر از این مقدار، برحسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --min-size SizeSuffix                 فقط انتقال فایل‌های بزرگ‌تر از این مقدار، برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض off)
\f[R]
.fi
.SS "گزینه‌های فهرست‌کردن (Listing Options)"
.PP
پرچم‌هایی برای فهرست‌کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌کردن بازگشتی در صورت دردسترس بودن؛ مصرف حافظه بیشتر اما تراکنش‌های کمتر
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone completion
.PP
تولید اسکریپت تکمیل خودکار (completion) برای یک پوسته مشخص.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
یک اسکریپت تکمیل خودکار پوسته برای rclone تولید می‌کند.
برای مشاهده فهرست پوسته‌های پشتیبانی‌شده، با \f[V]--help\f[R] اجرا کنید.
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنما برای completion
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید..SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنمای دستورها، پرچم‌ها و backendهای rclone.
.IP \[bu] 2
rclone completion
bash (https://rclone.org/commands/rclone_completion_bash) \- خروجی دادن اسکریپت تکمیل خودکار bash برای rclone.
.IP \[bu] 2
rclone completion
fish (https://rclone.org/commands/rclone_completion_fish) \- خروجی دادن اسکریپت تکمیل خودکار fish برای rclone.
.IP \[bu] 2
rclone completion
powershell (https://rclone.org/commands/rclone_completion_powershell) \- خروجی دادن اسکریپت تکمیل خودکار powershell برای rclone.
.IP \[bu] 2
rclone completion
zsh (https://rclone.org/commands/rclone_completion_zsh) \- خروجی دادن اسکریپت تکمیل خودکار zsh برای rclone.
.SH rclone completion bash
.PP
خروجی دادن اسکریپت تکمیل خودکار bash برای rclone.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
یک اسکریپت تکمیل خودکار شل bash برای rclone تولید می‌کند.
.PP
به‌طور پیش‌فرض، هنگامی که بدون هیچ آرگومانی اجرا شود،
.IP
.nf
\f[C]
rclone completion bash
\f[R]
.fi
.PP
اسکریپت تولیدشده در مسیر زیر نوشته خواهد شد:
.IP
.nf
\f[C]
/etc/bash_completion.d/rclone
\f[R]
.fi
.PP
و بنابراین احتمالاً rclone باید به عنوان کاربر root یا با sudo اجرا شود.
.PP
اگر مسیری به یک فایل را به عنوان آرگومان خط فرمان مشخص کنید، اسکریپت تولیدشده در آن فایل نوشته خواهد شد که در این صورت نباید نیازی به دسترسی‌های کاربر root داشته باشید.
.PP
اگر output_file برابر با \[dq]\-\[dq] باشد، خروجی در stdout نوشته خواهد شد.
.PP
اگر اسکریپت را در مکان پیش‌فرض نصب کرده‌اید، می‌توانید برای استفاده از اسکریپت تکمیل خودکار، از نشست خود خارج شده و دوباره وارد شوید (logout و login مجدد).
.PP
همچنین می‌توانید اسکریپت را مستقیماً source کنید:
.IP
.nf
\f[C]
\&. /path/to/my_bash_completion_scripts/rclone
\f[R]
.fi
.PP
و قابلیت تکمیل خودکار به شل فعلی شما افزوده خواهد شد.
.IP
.nf
\f[C]
rclone completion bash [output_file] [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای bash
\f[R]
.fi
.PP
برای مشاهده گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید..SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone completion (https://rclone.org/commands/rclone_completion) \-
تولید اسکریپت تکمیل خودکار برای یک پوسته مشخص.
.SH rclone completion fish
.PP
تولید اسکریپت تکمیل خودکار fish برای rclone.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
یک اسکریپت تکمیل خودکار fish برای rclone تولید می‌کند.
.PP
این دستور به‌طور پیش‌فرض در /etc/fish/completions/rclone.fish می‌نویسد، بنابراین احتمالاً باید با sudo یا به‌عنوان کاربر ریشه (root) اجرا شود، برای مثال:
.IP
.nf
\f[C]
sudo rclone completion fish
\f[R]
.fi
.PP
برای استفاده از اسکریپت‌های تکمیل خودکار، خارج شده و دوباره وارد شوید، یا آن‌ها را مستقیماً بارگذاری (source) کنید:
.IP
.nf
\f[C]
\&. /etc/fish/completions/rclone.fish
\f[R]
.fi
.PP
اگر یک آرگومان خط فرمان مشخص کنید، اسکریپت در آنجا نوشته خواهد شد.
.PP
اگر output_file برابر با \[dq]-\[dq] باشد، خروجی در stdout نوشته خواهد شد.
.IP
.nf
\f[C]
rclone completion fish [output_file] [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنما برای fish
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone completion (https://rclone.org/commands/rclone_completion) \-
تولید اسکریپت تکمیل خودکار برای یک پوسته مشخص.
.SH rclone completion powershell
.PP
تولید اسکریپت تکمیل خودکار powershell برای rclone.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
اسکریپت تکمیل خودکار را برای powershell تولید می‌کند.
.PP
برای بارگذاری تکمیل‌های خودکار در نشست جاری پوسته خود:
.IP
.nf
\f[C]
rclone completion powershell | Out-String | Invoke-Expression
\f[R]
.fi
.PP
برای بارگذاری تکمیل‌های خودکار در هر نشست جدید، خروجی دستور بالا را به پروفایل powershell خود اضافه کنید.
.PP
اگر output_file برابر با \[dq]-\[dq] بوده یا مشخص نشده باشد، خروجی در stdout نوشته خواهد شد.
.IP
.nf
\f[C]
rclone completion powershell [output_file] [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنما برای powershell
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید..SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone completion (https://rclone.org/commands/rclone_completion) \-
تولید اسکریپت تکمیل خودکار (completion) برای یک شل مشخص.
.SH rclone completion zsh
.PP
تولید اسکریپت تکمیل خودکار zsh برای rclone.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
یک اسکریپت تکمیل خودکار (autocompletion) شل zsh برای rclone تولید می‌کند.
.PP
این دستور به‌طور پیش‌فرض در مسیر /usr/share/zsh/vendor-completions/_rclone می‌نویسد، بنابراین احتمالا نیاز است با sudo یا به عنوان کاربر root اجرا شود، مانند:
.IP
.nf
\f[C]
sudo rclone completion zsh
\f[R]
.fi
.PP
برای استفاده از اسکریپت‌های تکمیل خودکار، خارج شده و دوباره وارد شوید (logout و login کنید)، یا آن‌ها را مستقیماً بارگذاری (source) کنید:
.IP
.nf
\f[C]
autoload -U compinit && compinit
\f[R]
.fi
.PP
اگر یک آرگومان خط فرمان مشخص کنید، اسکریپت در آنجا نوشته خواهد شد.
.PP
اگر output_file مقدار \[dq]-\[dq] باشد، خروجی در stdout نوشته خواهد شد.
.IP
.nf
\f[C]
rclone completion zsh [output_file] [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   help for zsh
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone completion (https://rclone.org/commands/rclone_completion) \-
تولید اسکریپت تکمیل خودکار برای یک شل مشخص.
.SH rclone config create
.PP
ایجاد یک ریموت جدید با نام، نوع و گزینه‌ها.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
ایجاد یک ریموت جدید با \f[V]name\f[R]، \f[V]type\f[R] و گزینه‌ها.
گزینه‌ها باید به‌صورت جفت‌های \f[V]key\f[R] \f[V]value\f[R] یا به‌صورت \f[V]key=value\f[R] ارسال شوند.
.PP
به‌عنوان مثال، برای ایجاد یک ریموت swift با نام myremote با استفاده از پیکربندی خودکار، این دستور را اجرا می‌کنید:
.IP
.nf
\f[C]
rclone config create myremote swift env_auth true
rclone config create myremote swift env_auth=true
\f[R]
.fi
.PP
بنابراین برای مثال اگر می‌خواستید یک ریموت Google Drive را با استفاده از احراز هویت از راه دور پیکربندی کنید، این کار را انجام می‌دادید:
.IP
.nf
\f[C]
rclone config create mydrive drive config_is_local=false
\f[R]
.fi
.PP
توجه داشته باشید که اگر فرایند پیکربندی در حالت عادی سؤالی بپرسد، مقدار پیش‌فرض در نظر گرفته می‌شود (مگر اینکه از \f[V]--non-interactive\f[R] استفاده شده باشد).
هر بار که این اتفاق رخ دهد، rclone پیامی عادی یا در سطح DEBUG چاپ می‌کند که نحوه تغییر دادن مقدار انتخابی را توضیح می‌دهد.
.PP
اگر هر یک از پارامترهای ارسالی یک فیلد گذرواژه باشد، rclone پیش از قرار دادن آن در فایل پیکربندی، در صورتی که از قبل مبهم نشده باشد، به‌طور خودکار آن را مبهم (obscure) می‌کند.
.PP
\f[B]نکته:\f[R] اگر پارامتر گذرواژه ۲۲ کاراکتر یا بیشتر باشد و فقط از کاراکترهای base64 تشکیل شده باشد، rclone ممکن است در مورد اینکه آیا گذرواژه از قبل مبهم شده است یا خیر دچار سردرگمی شود و گذرواژه‌های مبهم‌نشده را در فایل پیکربندی قرار دهد.
اگر می‌خواهید ۱۰۰٪ مطمئن شوید که گذرواژه‌ها مبهم می‌شوند، از پرچم \f[V]--obscure\f[R] استفاده کنید، یا اگر ۱۰۰٪ اطمینان دارید که از قبل گذرواژه‌های مبهم‌شده ارسال می‌کنید، از \f[V]--no-obscure\f[R] استفاده نمایید.
همچنین می‌توانید گذرواژه‌های مبهم‌شده را با استفاده از دستور \f[V]rclone config password\f[R] تنظیم کنید.
.PP
پرچم \f[V]--non-interactive\f[R] برای استفاده برنامه‌هایی است که مایلند به‌جای استفاده از پرسش‌های پیکربندی متنی rclone، خودشان rclone را پیکربندی کنند.
اگر این پرچم تنظیم شده باشد و rclone نیاز به پرسیدن سؤالی از کاربر داشته باشد، یک قطعه JSON حاوی پرسش برگردانده خواهد شد.
.PP
این خروجی شبیه به این خواهد بود (برخی جزئیات نامربوط حذف شده‌اند):
.IP
.nf
\f[C]
{
  \[dq]State\[dq]: \[dq]*oauth-islocal,teamdrive,,\[dq],
  \[dq]Option\[dq]: {
    \[dq]Name\[dq]: \[dq]config_is_local\[dq],
    \[dq]Help\[dq]: \[dq]Use web browser to automatically authenticate rclone with remote?\[rs]n * Say Y if the machine running rclone has a web browser you can use\[rs]n * Say N if running rclone on a (remote) machine without web browser access\[rs]nIf not sure try Y. If Y failed, try N.\[rs]n\[dq],
    \[dq]Default\[dq]: true,
    \[dq]Examples\[dq]: [
      {
        \[dq]Value\[dq]: \[dq]true\[dq],
        \[dq]Help\[dq]: \[dq]Yes\[dq]
      },
      {
        \[dq]Value\[dq]: \[dq]false\[dq],
        \[dq]Help\[dq]: \[dq]No\[dq]
      }
    ],
    \[dq]Required\[dq]: false,
    \[dq]IsPassword\[dq]: false,
    \[dq]Type\[dq]: \[dq]bool\[dq],
    \[dq]Exclusive\[dq]: true,
  },
  \[dq]Error\[dq]: \[dq]\[dq],
}
\f[R]
.fi
.PP
قالب \f[V]Option\f[R] مشابه مقداری است که توسط \f[V]rclone config providers\f[R] بازگردانده می‌شود.
این پرسش باید از کاربر پرسیده شود و در قالب گزینه \f[V]--result\f[R] همراه با پارامتر \f[V]--state\f[R] به rclone بازگردانده شود.
.PP
کلیدهای \f[V]Option\f[R] به‌صورت زیر استفاده می‌شوند:
.IP \[bu] 2
\f[V]Name\f[R] \- نام متغیر \- به کاربر نمایش داده شود
.IP \[bu] 2
\f[V]Help\f[R] \- متن راهنما.
در ۸۰ کاراکتر شکسته شده است (hard wrapped).
هر نشانی اینترنتی (URL) باید قابل کلیک باشد.
.IP \[bu] 2
\f[V]Default\f[R] \- مقدار پیش‌فرض \- اگر کاربر فقط مقدار پیش‌فرض را می‌خواهد، این مقدار را برگردانید.
.IP \[bu] 2
\f[V]Examples\f[R] \- کاربر باید بتواند یکی از این موارد را انتخاب کند
.IP \[bu] 2
\f[V]Required\f[R] \- مقدار نباید خالی باشد
.IP \[bu] 2
\f[V]IsPassword\f[R] \- این مقدار یک گذرواژه است و باید به همین صورت ویرایش شود
.IP \[bu] 2
\f[V]Type\f[R] \- نوع مقدار، مانند \f[V]bool\f[R]، \f[V]string\f[R]، \f[V]int\f[R] و غیره
.IP \[bu] 2
\f[V]Exclusive\f[R] \- در صورت تنظیم، ورود متن دلخواه مجاز نیست و فقط مقادیر \f[V]Examples\f[R] مجاز هستند
.IP \[bu] 2
کلیدهای نامربوط: \f[V]Provider\f[R]، \f[V]ShortOpt\f[R]، \f[V]Hide\f[R]، \f[V]NoPrefix\f[R]، \f[V]Advanced\f[R]
.PP
اگر \f[V]Error\f[R] مقداردهی شده باشد، باید هم‌زمان با پرسش به کاربر نمایش داده شود.
.IP
.nf
\f[C]
rclone config update name --continue --state \[dq]*oauth-islocal,teamdrive,,\[dq] --result \[dq]true\[dq]
\f[R]
.fi
.PP
توجه داشته باشید که هنگام استفاده از \f[V]--continue\f[R] تمام گذرواژه‌ها باید به‌صورت واضح (متن خام، نه مبهم‌شده) ارسال شوند.
هر مقدار پیکربندی پیش‌فرضی نیز باید در هر بار فراخوانی \f[V]--continue\f[R] ارسال شود..PP
در پایان فرآیند غیرتعاملی، rclone نتیجه‌ای را با \f[V]State\f[R] به صورت یک رشته خالی بازمی‌گرداند.
.PP
اگر \f[V]--all\f[R] داده شود، rclone تمام پرسش‌های پیکربندی را خواهد پرسید، نه فقط پرسش‌های پس از پیکربندی را.
طبق معمول، از هر پارامتری به عنوان مقدار پیش‌فرض برای پرسش‌ها استفاده می‌شود.
.PP
توجه داشته باشید که \f[V]bin/config.py\f[R] در سورس‌کد rclone این پروتکل را به عنوان یک نمایش خوانا پیاده‌سازی می‌کند.
.IP
.nf
\f[C]
rclone config create name type [key value]* [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --all               پرسیدن تمام پرسش‌های پیکربندی
      --continue          ادامه فرآیند پیکربندی با یک پاسخ
  -h, --help              راهنما برای create
      --no-obscure        اجبار به مبهم‌سازی نشدن هیچ‌یک از گذرواژه‌ها
      --no-output         هیچ خروجی‌ای ارائه نشود
      --non-interactive   عدم تعامل با کاربر و بازگرداندن پرسش‌ها
      --obscure           اجبار به مبهم‌سازی گذرواژه‌ها
      --result string     نتیجه \- استفاده همراه با --continue
      --state string      وضعیت \- استفاده همراه با --continue
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک نشست پیکربندی تعاملی.
.SH rclone config delete
.PP
حذف یک remote موجود.
.IP
.nf
\f[C]
rclone config delete name [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنما برای delete
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک نشست پیکربندی تعاملی.
.SH rclone config disconnect
.PP
قطع اتصال کاربر از remote
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور، remote: داده‌شده به سامانه ذخیره‌سازی ابری را قطع می‌کند.
.PP
این عمل معمولاً به معنی باطل کردن توکن oauth است.
.PP
برای اتصال مجدد از \[dq]rclone config reconnect\[dq] استفاده کنید.
.IP
.nf
\f[C]
rclone config disconnect remote: [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنما برای disconnect
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید..SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک
نشست پیکربندی تعاملی.
.SH rclone config dump
.PP
تخلیه فایل پیکربندی در قالب JSON.
.IP
.nf
\f[C]
rclone config dump [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای dump
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک
نشست پیکربندی تعاملی.
.SH rclone config edit
.PP
ورود به نشست پیکربندی تعاملی.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
ورود به یک نشست پیکربندی تعاملی که در آن می‌توانید ریموت‌های جدید را راه‌اندازی کرده
و موارد موجود را مدیریت کنید.
همچنین می‌توانید برای محافظت از پیکربندی خود، گذرواژه‌ای تعیین یا حذف نمایید.
.IP
.nf
\f[C]
rclone config edit [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای edit
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک
نشست پیکربندی تعاملی.
.SH rclone config encryption
.PP
تنظیم، حذف و بررسی رمزگذاری فایل پیکربندی
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور با استفاده از زیردستورهای زیر، رمزگذاری فایل پیکربندی را تنظیم،
پاک و بررسی می‌کند.
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای encryption
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک
نشست پیکربندی تعاملی.
.IP \[bu] 2
rclone config encryption check (https://rclone.org/commands/rclone_config_encryption_check) \-
بررسی رمزگذاری‌شده بودن فایل پیکربندی
.IP \[bu] 2
rclone config encryption remove (https://rclone.org/commands/rclone_config_encryption_remove) \-
حذف گذرواژه رمزگذاری فایل پیکربندی
.IP \[bu] 2
rclone config encryption set (https://rclone.org/commands/rclone_config_encryption_set) \- تنظیم یا
تغییر گذرواژه رمزگذاری فایل پیکربندی.SH rclone config encryption check
.PP
بررسی رمزنگاری بودن فایل پیکربندی
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور بررسی می‌کند که فایل پیکربندی رمزنگاری شده باشد و شما بتوانید آن را رمزگشایی کنید.
.PP
این دستور تلاش خواهد کرد تا با استفاده از گذرواژه‌ای که ارائه می‌دهید، پیکربندی را رمزگشایی کند.
.PP
اگر رمزگشایی با شکست مواجه شود، در صورت استفاده از \f[V]--password-command\f[R] یک کد خروج غیرصفر بازمی‌گرداند؛ در غیر این صورت، دوباره گذرواژه را درخواست می‌کند.
.PP
اگر فایل پیکربندی رمزنگاری نشده باشد، یک کد خروج غیرصفر بازمی‌گرداند.
.IP
.nf
\f[C]
rclone config encryption check [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای check
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا ذکر نشده‌اند، به صفحه پرچم‌های سراسری (https://rclone.org/flags) مراجعه کنید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config
encryption (https://rclone.org/commands/rclone_config_encryption) \-
تنظیم، حذف و بررسی رمزنگاری فایل پیکربندی
.SH rclone config encryption remove
.PP
حذف گذرواژه رمزنگاری فایل پیکربندی
.SS "خلاصه دستور (SYNOPSIS)"
.PP
حذف گذرواژه رمزنگاری فایل پیکربندی
.PP
این دستور رمزنگاری فایل پیکربندی را حذف کرده و آن را به حالت رمزنگاری‌نشده بازمی‌گرداند.
.PP
اگر \f[V]--password-command\f[R] در حال استفاده باشد، این دستور برای ارائه گذرواژه قبلی پیکربندی فراخوانی خواهد شد.
.PP
اگر پیکربندی رمزنگاری نشده باشد، هیچ خطایی بازگردانده نخواهد شد و این دستور هیچ کاری انجام نمی‌دهد.
.IP
.nf
\f[C]
rclone config encryption remove [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای remove
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا ذکر نشده‌اند، به صفحه پرچم‌های سراسری (https://rclone.org/flags) مراجعه کنید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config
encryption (https://rclone.org/commands/rclone_config_encryption) \-
تنظیم، حذف و بررسی رمزنگاری فایل پیکربندی
.SH rclone config encryption set
.PP
تنظیم یا تغییر گذرواژه رمزنگاری فایل پیکربندی
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور گذرواژه رمزنگاری فایل پیکربندی را تنظیم می‌کند یا تغییر می‌دهد.
.PP
اگر هیچ گذرواژه‌ای برای پیکربندی تنظیم نشده باشد، یک گذرواژه جدید تنظیم می‌کند؛ در غیر این صورت، گذرواژه موجود را تغییر می‌دهد.
.PP
توجه داشته باشید که اگر در حال تغییر گذرواژه رمزنگاری با استفاده از \f[V]--password-command\f[R] هستید، این دستور یک بار برای رمزگشایی پیکربندی با استفاده از گذرواژه قدیمی و بار دیگر برای خواندن گذرواژه جدید جهت رمزنگاری مجدد پیکربندی فراخوانی خواهد شد.
.PP
هنگامی که \f[V]--password-command\f[R] برای تغییر گذرواژه فراخوانی شود، متغیر محیطی \f[V]RCLONE_PASSWORD_CHANGE=1\f[R] تنظیم خواهد شد. بنابراین در صورت تغییر برنامه‌ریزی‌شده گذرواژه‌ها، می‌توانید از این متغیر محیطی برای تشخیص اینکه کدام گذرواژه را باید ارائه دهید، استفاده کنید.
.PP
همچنین می‌توانید ابتدا گذرواژه را حذف کنید (با \f[V]rclone config encryption remove\f[R])، سپس دوباره با این دستور آن را تنظیم نمایید؛ در صورتی که با قرار گرفتن کوتاه‌مدت فایل پیکربندیِ رمزنگاری‌نشده بر روی دیسک مشکلی نداشته باشید، این روش ممکن است آسان‌تر باشد.
.IP
.nf
\f[C]
rclone config encryption set [flags]
\f[R]
.fi.SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
  -h, --help   راهنمای set
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone config encryption (https://rclone.org/commands/rclone_config_encryption) \-
تنظیم، حذف و بررسی رمزگذاری برای فایل پیکربندی
.SH rclone config file
.PP
نمایش مسیر فایل پیکربندی مورد استفاده.
.IP
.nf
\f[C]
rclone config file [flags]
\f[R]
.fi
.SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
  -h, --help   راهنمای file
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک
نشست پیکربندی تعاملی.
.SH rclone config password
.PP
به‌روزرسانی گذرواژه در یک ریموت موجود.
.SS خلاصه دستور (SYNOPSIS)
.PP
به‌روزرسانی گذرواژهٔ یک ریموت موجود.
گذرواژه باید به صورت جفت‌های \f[V]key\f[R] \f[V]password\f[R] یا به صورت \f[V]key=password\f[R] ارسال شود.
مقدار \f[V]password\f[R] باید به صورت آشکار (مبهم‌نشده) وارد شود.
.PP
برای مثال، جهت تنظیم گذرواژهٔ ریموتی با نام myremote به این ترتیب عمل کنید:
.IP
.nf
\f[C]
rclone config password myremote fieldname mypassword
rclone config password myremote fieldname=mypassword
\f[R]
.fi
.PP
این دستور اکنون منسوخ شده است، زیرا هر دو دستور \[dq]config update\[dq] و
\[dq]config create\[dq] مستقیماً از مبهم‌سازی گذرواژه‌ها پشتیبانی می‌کنند.
.IP
.nf
\f[C]
rclone config password name [key value]+ [flags]
\f[R]
.fi
.SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
  -h, --help   راهنمای password
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک
نشست پیکربندی تعاملی.
.SH rclone config paths
.PP
نمایش مسیرهای مورد استفاده برای پیکربندی، کَش، فایل‌های موقت و غیره.
.IP
.nf
\f[C]
rclone config paths [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنما برای paths
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک نشست پیکربندی تعاملی.
.SH rclone config providers
.PP
فهرست کردن تمام ارائه‌دهنده‌ها (providers) و گزینه‌ها در قالب JSON.
.IP
.nf
\f[C]
rclone config providers [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنما برای providers
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک نشست پیکربندی تعاملی.
.SH rclone config reconnect
.PP
احراز هویت مجدد کاربر با ریموت.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور remote: ارائه‌شده را مجدداً به سیستم ذخیره‌سازی ابری متصل می‌کند.
.PP
برای قطع اتصال ریموت از \[dq]rclone config disconnect\[dq] استفاده کنید.
.PP
این کار معمولاً به معنای طی کردن دوبارهٔ فرآیند تعاملی oauth است.
.IP
.nf
\f[C]
rclone config reconnect remote: [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنما برای reconnect
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک نشست پیکربندی تعاملی.
.SH rclone config redacted
.PP
چاپ فایل پیکربندی پالایش‌شده (رمزگشایی‌شده)، یا پیکربندی پالایش‌شده برای یک ریموت مشخص.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور یک نسخهٔ پالایش‌شده از فایل پیکربندی را چاپ می‌کند؛ چه کل فایل پیکربندی و چه برای یک ریموت مشخص.
.PP
فایل پیکربندی با جایگزین کردن تمام گذرواژه‌ها و دیگر اطلاعات حساس با XXX پالایش خواهد شد.
.PP
این کار فایل پیکربندی را برای ارسال آنلاین جهت دریافت پشتیبانی مناسب می‌سازد.
.PP
پیش از ارسال باید دوباره بررسی شود، زیرا ممکن است پالایش اطلاعات کاملاً بی‌نقص نباشد.
.IP
.nf
\f[C]
rclone config redacted [<remote>] [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنما برای redacted
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک نشست پیکربندی تعاملی.
.SH rclone config show
.PP
چاپ فایل پیکربندی (رمزگشایی‌شده)، یا پیکربندی یک remote تکی.
.IP
.nf
\f[C]
rclone config show [<remote>] [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنما برای show
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک نشست پیکربندی تعاملی.
.SH rclone config string
.PP
چاپ رشته اتصال برای یک remote تکی.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
چاپ یک رشته اتصال برای یک remote تکی.
.PP
رشته‌های اتصال (https://rclone.org/docs/#connection-strings) می‌توانند در هر جایی که به یک remote نیاز است استفاده شوند و می‌توانند راحت‌تر از استفاده از فایل پیکربندی باشند، به‌ویژه در صورت استفاده از RC API.
.PP
همچنین می‌توان پارامترهای backend را به دستور ارائه کرد.
.PP
مثال:
.IP
.nf
\f[C]
$ rclone config string s3:rclone --s3-no-check-bucket
:s3,access_key_id=XXX,no_check_bucket,provider=AWS,region=eu-west-2,secret_access_key=YYY:rclone
\f[R]
.fi
.PP
\f[B]توجه:\f[R] این رشته‌ها برای استفاده در پوسته‌ها (مانند bash،‏ powershell،‏ windows cmd) نقل‌قول‌گذاری نشده‌اند.
بیشتر آن‌ها در صورت قرار گرفتن در \[dq]علامت نقل‌قول دوتایی (double quotes)\[dq] کار خواهند کرد، اما رشته‌های اتصالی که حاوی علامت نقل‌قول دوتایی هستند به نقل‌قول‌گذاری بیشتری نیاز خواهند داشت که شدیداً به نوع پوسته وابسته است.
.IP
.nf
\f[C]
rclone config string <remote> [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنما برای string
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید..SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک
نشست پیکربندی تعاملی.
.SH rclone config touch
.PP
اطمینان از وجود فایل پیکربندی.
.IP
.nf
\f[C]
rclone config touch [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   help for touch
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک
نشست پیکربندی تعاملی.
.SH rclone config unset
.PP
لغو تنظیم گزینه‌ها در یک ریموت موجود.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
حذف یک یا چند گزینه از یک ریموت موجود.
گزینه‌هایی که باید حذف شوند باید به‌صورت فهرستی از نام‌های کلید وارد شوند.
.PP
به‌عنوان مثال، برای حذف گزینه‌های \f[V]client_id\f[R] و
\f[V]client_secret\f[R] از ریموتی با نام myremote، دستور زیر را
اجرا می‌کنید:
.IP
.nf
\f[C]
rclone config unset myremote client_id client_secret
\f[R]
.fi
.PP
این کار کلیدها را به‌طور کامل از فایل پیکربندی حذف می‌کند، که با
تنظیم آن‌ها به یک رشتهٔ خالی از طریق \f[V]config update\f[R] متفاوت است.
حذف یک کلید، رفتار پیش‌فرض rclone را برای آن گزینه بازمی‌گرداند،
در حالی که تنظیم آن به یک رشتهٔ خالی، مقدار پیش‌فرض را با یک مقدار
خالی بازنویسی می‌کند.
.PP
نمی‌توانید \f[V]type\f[R] یک ریموت را لغو تنظیم کنید \- در عوض
از \f[V]config delete\f[R] برای حذف کامل ریموت استفاده کنید.
.IP
.nf
\f[C]
rclone config unset name [key]+ [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   help for unset
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک
نشست پیکربندی تعاملی.
.SH rclone config update
.PP
به‌روزرسانی گزینه‌ها در یک ریموت موجود.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
به‌روزرسانی گزینه‌های یک ریموت موجود.
گزینه‌ها باید به‌صورت جفت‌های \f[V]key\f[R] \f[V]value\f[R]
یا به‌صورت \f[V]key=value\f[R] وارد شوند.
.PP
به‌عنوان مثال، برای به‌روزرسانی فیلد env_auth در یک ریموت با نام myremote
دستور زیر را اجرا می‌کنید:
.IP
.nf
\f[C]
rclone config update myremote env_auth true
rclone config update myremote env_auth=true
\f[R]
.fi
.PP
اگر ریموت از OAuth استفاده می‌کند، توکن به‌روزرسانی خواهد شد؛ اگر
به این کار نیازی ندارید، یک پارامتر اضافی را به این صورت درج کنید:
.IP
.nf
\f[C]
rclone config update myremote env_auth=true config_refresh_token=false
\f[R]
.fi
.PP
توجه داشته باشید که اگر فرایند پیکربندی به‌طور معمول سؤالی بپرسد،
مقدار پیش‌فرض در نظر گرفته می‌شود (مگر اینکه از \f[V]--non-interactive\f[R] استفاده شود).
هر بار که این رخ دهد، rclone پیامی عادی یا پیامی با سطح اشکال‌زدایی (DEBUG) چاپ می‌کند
که نحوهٔ اثرگذاری بر مقدار انتخابی را شرح می‌دهد.
.PP
اگر هر یک از پارامترهای واردشده یک فیلد گذرواژه باشد، rclone
قبل از قرار دادن آن‌ها در فایل پیکربندی، در صورتی که از قبل مبهم نشده باشند،
به‌طور خودکار آن‌ها را مبهم می‌کند.
.PP
\f[B]توجه\f[R] اگر پارامتر گذرواژه ۲۲ نویسه یا طولانی‌تر باشد و
تنها از نویسه‌های base64 تشکیل شده باشد، rclone ممکن است دربارهٔ اینکه
آیا گذرواژه از قبل مبهم شده است یا خیر دچار سردرگمی شود و گذرواژه‌های
مبهم‌نشده را در فایل پیکربندی قرار دهد.
اگر می‌خواهید ۱۰۰٪ مطمئن شوید که گذرواژه‌ها مبهم می‌شوند، از پرچم
\f[V]--obscure\f[R] استفاده کنید، یا چنانچه ۱۰۰٪ مطمئن هستید که در حال حاضر
گذرواژه‌های مبهم‌شده را ارسال می‌کنید، از \f[V]--no-obscure\f[R] استفاده نمایید.
همچنین می‌توانید با استفاده از دستور \f[V]rclone config password\f[R]
گذرواژه‌های مبهم‌شده را تعیین کنید.
.PP
پرچم \f[V]--non-interactive\f[R] برای استفادهٔ برنامه‌هایی است که
مایلند پیکربندی rclone را خودشان انجام دهند، به‌جای آنکه از پرسش‌های
پیکربندی متنی rclone استفاده کنند.
اگر این پرچم تنظیم شود و rclone نیاز داشته باشد سؤالی از کاربر بپرسد،
یک شیء داده‌ای (blob) از نوع JSON حاوی آن پرسش بازگردانده می‌شود.
.PP
این شیء چیزی شبیه به نمونهٔ زیر خواهد بود (برخی جزئیات غیرمرتبط حذف شده‌اند):
.IP
.nf
\f[C]
{
  \[dq]State\[dq]: \[dq]*oauth-islocal,teamdrive,,\[dq],
  \[dq]Option\[dq]: {
    \[dq]Name\[dq]: \[dq]config_is_local\[dq],
    \[dq]Help\[dq]: \[dq]Use web browser to automatically authenticate rclone with remote?\[rs]n * Say Y if the machine running rclone has a web browser you can use\[rs]n * Say N if running rclone on a (remote) machine without web browser access\[rs]nIf not sure try Y. If Y failed, try N.\[rs]n\[dq],
    \[dq]Default\[dq]: true,
    \[dq]Examples\[dq]: [
      {
        \[dq]Value\[dq]: \[dq]true\[dq],
        \[dq]Help\[dq]: \[dq]Yes\[dq]
      },
      {
        \[dq]Value\[dq]: \[dq]false\[dq],
        \[dq]Help\[dq]: \[dq]No\[dq]
      }
    ],
    \[dq]Required\[dq]: false,
    \[dq]IsPassword\[dq]: false,
    \[dq]Type\[dq]: \[dq]bool\[dq],
    \[dq]Exclusive\[dq]: true,
  },
  \[dq]Error\[dq]: \[dq]\[dq],
}
\f[R]
.fi
.PP
قالب \f[V]Option\f[R] همانند خروجی بازگردانده‌شده توسط
\f[V]rclone config providers\f[R] است.
سؤال باید از کاربر پرسیده شود و همراه با پارامتر \f[V]--state\f[R]
به‌عنوان گزینهٔ \f[V]--result\f[R] به rclone بازگردانده شود.
.PP
کلیدهای \f[V]Option\f[R] به‌صورت زیر استفاده می‌شوند:
.IP \[bu] 2
\f[V]Name\f[R] \- نام متغیر \- برای نمایش به کاربر
.IP \[bu] 2
\f[V]Help\f[R] \- متن راهنما.
شکسته‌شده با حداکثر طول ۸۰ نویسه.
هر نشانی اینترنتی (URL) باید قابل کلیک باشد.
.IP \[bu] 2
\f[V]Default\f[R] \- مقدار پیش‌فرض \- در صورتی که کاربر فقط
پیش‌فرض را می‌خواهد، این مقدار بازگردانده شود.
.IP \[bu] 2
\f[V]Examples\f[R] \- کاربر باید بتواند یکی از این‌ها را انتخاب کند
.IP \[bu] 2
\f[V]Required\f[R] \- مقدار نباید خالی باشد
.IP \[bu] 2
\f[V]IsPassword\f[R] \- مقدار یک گذرواژه است و باید به همین صورت ویرایش شود
.IP \[bu] 2
\f[V]Type\f[R] \- نوع مقدار، مانند \f[V]bool\f[R]، \f[V]string\f[R]،
\f[V]int\f[R] و موارد دیگر.IP \[bu] 2
\f[V]Exclusive\f[R] \- در صورت تنظیم، هیچ ورودی آزادی مجاز نیست و تنها
\f[V]Examples\f[R] پذیرفته می‌شود
.IP \[bu] 2
کلیدهای نامرتبط: \f[V]Provider\f[R]، \f[V]ShortOpt\f[R]، \f[V]Hide\f[R]،
\f[V]NoPrefix\f[R]، \f[V]Advanced\f[R]
.PP
اگر \f[V]Error\f[R] تنظیم شده باشد، باید هم‌زمان با پرسش به کاربر
نمایش داده شود.
.IP
.nf
\f[C]
rclone config update name --continue --state \[dq]*oauth-islocal,teamdrive,,\[dq] --result \[dq]true\[dq]
\f[R]
.fi
.PP
توجه داشته باشید هنگام استفاده از \f[V]--continue\f[R] تمام گذرواژه‌ها باید
به‌صورت متن آشکار (نه مبهم‌شده) ارسال شوند.
هرگونه مقدار پیش‌فرض پیکربندی باید در هر بار فراخوانی
\f[V]--continue\f[R] ارسال شود.
.PP
در پایان فرآیند غیرتعاملی، rclone نتیجه‌ای را بازمی‌گرداند که در آن
\f[V]State\f[R] یک رشته خالی است.
.PP
اگر \f[V]--all\f[R] ارسال شود، rclone تمام پرسش‌های پیکربندی را خواهد پرسید،
نه فقط پرسش‌های پس از پیکربندی را.
هر پارامتری طبق معمول به‌عنوان پیش‌فرض برای پرسش‌ها استفاده می‌شود.
.PP
توجه داشته باشید که \f[V]bin/config.py\f[R] در سورس‌کد rclone این
پروتکل را به‌عنوان یک نمونه نمایشی خوانا پیاده‌سازی می‌کند.
.IP
.nf
\f[C]
rclone config update name [key value]+ [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --all               پرسیدن تمام پرسش‌های پیکربندی
      --continue          ادامه فرآیند پیکربندی با یک پاسخ
  -h, --help              راهنمای update
      --no-obscure        اجبار به عدم ابهام‌سازی گذرواژه‌ها
      --no-output         هیچ خروجی‌ای ارائه نشود
      --non-interactive   عدم تعامل با کاربر و بازگرداندن پرسش‌ها
      --obscure           اجبار به مبهم‌سازی تمام گذرواژه‌ها
      --result string     نتیجه \- استفاده همراه با --continue
      --state string      وضعیت \- استفاده همراه با --continue
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک
نشست پیکربندی تعاملی.
.SH rclone config userinfo
.PP
اطلاعات مربوط به کاربر واردشده به ریموت را چاپ می‌کند.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور جزئیات فرد واردشده به سیستم ذخیره‌سازی ابری را چاپ می‌کند.
.IP
.nf
\f[C]
rclone config userinfo remote: [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای userinfo
      --json   قالب‌بندی خروجی به‌صورت JSON
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید..SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone config (https://rclone.org/commands/rclone_config) \- ورود به یک نشست پیکربندی تعاملی.
.SH rclone convmv
.PP
نام‌های فایل و دایرکتوری را درجا تبدیل می‌کند.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
دستور convmv از تبدیل‌های پیشرفتهٔ نام مسیر برای تبدیل و تغییر نام فایل‌ها و دایرکتوری‌ها با اِعمال پیشوندها، پسوندها و سایر دگرگونی‌ها پشتیبانی می‌کند.
.PP
.TS
tab(@);
lw(35.0n) lw(35.0n).
T{
دستور
T}@T{
توضیحات
T}
_
T{
\f[V]--name-transform prefix=XXXX\f[R]
T}@T{
مقدار XXXX را به ابتدای نام فایل اضافه می‌کند.
T}
T{
\f[V]--name-transform suffix=XXXX\f[R]
T}@T{
مقدار XXXX را پس از پسوند، به انتهای نام فایل اضافه می‌کند.
T}
T{
\f[V]--name-transform suffix_keep_extension=XXXX\f[R]
T}@T{
ضمن حفظ پسوند اصلی فایل، مقدار XXXX را به انتهای نام فایل اضافه می‌کند.
T}
T{
\f[V]--name-transform trimprefix=XXXX\f[R]
T}@T{
در صورت وجود مقدار XXXX در ابتدای نام فایل، آن را حذف می‌کند.
T}
T{
\f[V]--name-transform trimsuffix=XXXX\f[R]
T}@T{
در صورت وجود مقدار XXXX در انتهای نام فایل، آن را حذف می‌کند.
T}
T{
\f[V]--name-transform regex=pattern/replacement\f[R]
T}@T{
یک تبدیل مبتنی بر عبارات باقاعده (regex) را اعمال می‌کند.
T}
T{
\f[V]--name-transform replace=old:new\f[R]
T}@T{
رخدادهای old را با new در نام فایل جایگزین می‌کند.
T}
T{
\f[V]--name-transform date={YYYYMMDD}\f[R]
T}@T{
قالب تاریخ مشخص‌شده را به صورت پیشوند یا پسوند اضافه می‌کند.
T}
T{
\f[V]--name-transform truncate=N\f[R]
T}@T{
طول نام فایل را حداکثر تا N نویسه کوتاه می‌کند.
T}
T{
\f[V]--name-transform truncate_keep_extension=N\f[R]
T}@T{
ضمن حفظ پسوند اصلی فایل، طول نام فایل را حداکثر تا N نویسه کوتاه می‌کند.
T}
T{
\f[V]--name-transform truncate_bytes=N\f[R]
T}@T{
طول نام فایل را حداکثر تا N بایت (نه نویسه) کوتاه می‌کند.
T}
T{
\f[V]--name-transform truncate_bytes_keep_extension=N\f[R]
T}@T{
ضمن حفظ پسوند اصلی فایل، طول نام فایل را حداکثر تا N بایت (نه نویسه) کوتاه می‌کند.
T}
T{
\f[V]--name-transform base64encode\f[R]
T}@T{
نام فایل را با Base64 کدگذاری می‌کند.
T}
T{
\f[V]--name-transform base64decode\f[R]
T}@T{
نام فایل کدگذاری‌شده با Base64 را رمزگشایی می‌کند.
T}
T{
\f[V]--name-transform encoder=ENCODING\f[R]
T}@T{
نام فایل را به کدگذاری مشخص‌شده تبدیل می‌کند (مانند ISO-8859-1، Windows-1252، Macintosh).
T}
T{
\f[V]--name-transform decoder=ENCODING\f[R]
T}@T{
نام فایل را از کدگذاری مشخص‌شده رمزگشایی می‌کند.
T}
T{
\f[V]--name-transform charmap=MAP\f[R]
T}@T{
یک تبدیل بر اساس نگاشت نویسه‌ها (charmap) را اعمال می‌کند.
T}
T{
\f[V]--name-transform lowercase\f[R]
T}@T{
نام فایل را به حروف کوچک تبدیل می‌کند.
T}
T{
\f[V]--name-transform uppercase\f[R]
T}@T{
نام فایل را به حروف بزرگ تبدیل می‌کند.
T}
T{
\f[V]--name-transform titlecase\f[R]
T}@T{
نام فایل را به صورت Title Case (حرف اول هر واژه بزرگ) تبدیل می‌کند.
T}
T{
\f[V]--name-transform ascii\f[R]
T}@T{
نویسه‌های غیر ASCII را حذف می‌کند.
T}
T{
\f[V]--name-transform url\f[R]
T}@T{
نام فایل را به صورت کدگذاری URL تبدیل می‌کند.
T}
T{
\f[V]--name-transform nfc\f[R]
T}@T{
نام فایل را به فرم یکسان‌سازی یونیکد NFC تبدیل می‌کند.
T}
T{
\f[V]--name-transform nfd\f[R]
T}@T{
نام فایل را به فرم یکسان‌سازی یونیکد NFD تبدیل می‌کند.
T}
T{
\f[V]--name-transform nfkc\f[R]
T}@T{
نام فایل را به فرم یکسان‌سازی یونیکد NFKC تبدیل می‌کند.
T}
T{
\f[V]--name-transform nfkd\f[R]
T}@T{
نام فایل را به فرم یکسان‌سازی یونیکد NFKD تبدیل می‌کند.
T}
T{
\f[V]--name-transform command=/path/to/my/programfile names.\f[R]
T}@T{
یک برنامهٔ خارجی را برای اعمال تبدیل اجرا می‌کند.
T}
.TE
.PP
حالت‌های تبدیل:
.IP
.nf
\f[C]
none
nfc
nfd
nfkc
nfkd
replace
prefix
suffix
suffix_keep_extension
trimprefix
trimsuffix
index
date
truncate
truncate_keep_extension
truncate_bytes
truncate_bytes_keep_extension
base64encode
base64decode
encoder
decoder
ISO-8859-1
Windows-1252
Macintosh
charmap
lowercase
uppercase
titlecase
ascii
url
regex
command
\f[R]
.fi.PP
نگاشت‌های نویسه (Char maps):
.IP
.nf
\f[C]
IBM-Code-Page-037
IBM-Code-Page-437
IBM-Code-Page-850
IBM-Code-Page-852
IBM-Code-Page-855
Windows-Code-Page-858
IBM-Code-Page-860
IBM-Code-Page-862
IBM-Code-Page-863
IBM-Code-Page-865
IBM-Code-Page-866
IBM-Code-Page-1047
IBM-Code-Page-1140
ISO-8859-1
ISO-8859-2
ISO-8859-3
ISO-8859-4
ISO-8859-5
ISO-8859-6
ISO-8859-7
ISO-8859-8
ISO-8859-9
ISO-8859-10
ISO-8859-13
ISO-8859-14
ISO-8859-15
ISO-8859-16
KOI8-R
KOI8-U
Macintosh
Macintosh-Cyrillic
Windows-874
Windows-1250
Windows-1251
Windows-1252
Windows-1253
Windows-1254
Windows-1255
Windows-1256
Windows-1257
Windows-1258
X-User-Defined
\f[R]
.fi
.PP
ماسک‌های کدگذاری (Encoding masks):
.IP
.nf
\f[C]
Asterisk
BackQuote
BackSlash
Colon
CrLf
Ctl
Del
Dollar
Dot
DoubleQuote
Exclamation
Hash
InvalidUtf8
LeftCrLfHtVt
LeftPeriod
LeftSpace
LeftTilde
LtGt
None
Percent
Pipe
Question
Raw
RightCrLfHtVt
RightPeriod
RightSpace
Semicolon
SingleQuote
Slash
SquareBracket
\f[R]
.fi
.PP
مثال‌ها:
.IP
.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown Fox!.txt\[dq] --name-transform \[dq]all,uppercase\[dq]
// Output: STORIES/THE QUICK BROWN FOX!.TXT
\f[R]
.fi
.IP
.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown Fox!.txt\[dq] --name-transform \[dq]all,replace=Fox:Turtle\[dq] --name-transform \[dq]all,replace=Quick:Slow\[dq]
// Output: stories/The Slow Brown Turtle!.txt
\f[R]
.fi
.IP
.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown Fox!.txt\[dq] --name-transform \[dq]all,base64encode\[dq]
// Output: c3Rvcmllcw==/VGhlIFF1aWNrIEJyb3duIEZveCEudHh0
\f[R]
.fi
.IP
.nf
\f[C]
rclone convmv \[dq]c3Rvcmllcw==/VGhlIFF1aWNrIEJyb3duIEZveCEudHh0\[dq] --name-transform \[dq]all,base64decode\[dq]
// Output: stories/The Quick Brown Fox!.txt
\f[R]
.fi
.IP
.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown 🦊 Fox Went to the Café!.txt\[dq] --name-transform \[dq]all,nfc\[dq]
// Output: stories/The Quick Brown 🦊 Fox Went to the Café!.txt
\f[R]
.fi
.IP
.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown 🦊 Fox Went to the Café!.txt\[dq] --name-transform \[dq]all,nfd\[dq]
// Output: stories/The Quick Brown 🦊 Fox Went to the Café!.txt
\f[R]
.fi
.IP
.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown 🦊 Fox!.txt\[dq] --name-transform \[dq]all,ascii\[dq]
// Output: stories/The Quick Brown  Fox!.txt
\f[R]
.fi
.IP
.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown Fox!.txt\[dq] --name-transform \[dq]all,trimsuffix=.txt\[dq]
// Output: stories/The Quick Brown Fox!
\f[R]
.fi
.IP
.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown Fox!.txt\[dq] --name-transform \[dq]all,prefix=OLD_\[dq]
// Output: OLD_stories/OLD_The Quick Brown Fox!.txt
\f[R]
.fi
.IP
.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown 🦊 Fox Went to the Café!.txt\[dq] --name-transform \[dq]all,charmap=ISO-8859-7\[dq]
// Output: stories/The Quick Brown _ Fox Went to the Caf_!.txt
\f[R]
.fi
.IP
.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown Fox: A Memoir [draft].txt\[dq] --name-transform \[dq]all,encoder=Colon,SquareBracket\[dq]
// Output: stories/The Quick Brown Fox： A Memoir ［draft］.txt
\f[R]
.fi
.IP
.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown 🦊 Fox Went to the Café!.txt\[dq] --name-transform \[dq]all,truncate=21\[dq]
// Output: stories/The Quick Brown 🦊 Fox
\f[R]
.fi
.IP
.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown Fox!.txt\[dq] --name-transform \[dq]all,command=echo\[dq]
// Output: stories/The Quick Brown Fox!.txt
\f[R]
.fi
.IP.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown Fox!\[dq] --name-transform \[dq]date=-{YYYYMMDD}\[dq]
// Output: stories/The Quick Brown Fox!-20260904
\f[R]
.fi
.IP
.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown Fox!\[dq] --name-transform \[dq]date=-{macfriendlytime}\[dq]
// Output: stories/The Quick Brown Fox!-2026-09-04 0450PM
\f[R]
.fi
.IP
.nf
\f[C]
rclone convmv \[dq]stories/The Quick Brown Fox!.txt\[dq] --name-transform \[dq]all,regex=[\[rs]\[rs].\[rs]\[rs]w]/ab\[dq]
// Output: ababababababab/ababab ababababab ababababab ababab!abababab
\f[R]
.fi
.PP
دستور regex عموماً عبارت‌های منظم به سبک پرل (Perl-style) را می‌پذیرد؛ نحو دقیق آن در مرجع عبارت‌های منظم Go (https://golang.org/pkg/regexp/syntax) تعریف شده است.
رشته جایگزینی می‌تواند شامل متغیرهای گروه‌های ضبط‌کننده (capturing groups) باشد و با استفاده از نحو \f[V]$name\f[R] یا \f[V]${name}\f[R] به آن‌ها ارجاع دهد، که در آن name می‌تواند به یک گروه ضبط‌کننده نام‌گذاری‌شده یا صرفاً به شماره شاخص آن اشاره کند.
برای درج نویسه واقعی $، از $$ استفاده کنید.
.PP
می‌توان از چندین تبدیل به‌صورت متوالی استفاده کرد که به همان ترتیبی که در خط فرمان مشخص شده‌اند، اعمال می‌شوند.
.PP
گزینه \f[V]--name-transform\f[R] در دستورهای \f[V]sync\f[R]، \f[V]copy\f[R] و \f[V]move\f[R] نیز در دسترس است.
.SS "فایل‌ها در برابر دایرکتوری‌ها (Files vs Directories)"
.PP
به‌طور پیش‌فرض، \f[V]--name-transform\f[R] فقط بر روی نام فایل‌ها اعمال می‌شود؛ به این معنی که تنها نام نهایی فایل (leaf) تبدیل خواهد شد.
با این حال، برخی از تبدیل‌ها بهتر است روی کل مسیر یا فقط روی دایرکتوری‌ها اعمال شوند.
برای انتخاب اینکه کدام بخش از مسیر فایل تحت تأثیر قرار گیرد، می‌توان برچسب‌هایی را به \f[V]--name-transform\f[R] اضافه کرد.
.PP
.TS
tab(@);
lw(35.0n) lw(35.0n).
T{
برچسب
T}@T{
اثر
T}
_
T{
\f[V]file\f[R]
T}@T{
تنها تبدیل نام نهایی فایل‌ها (پیش‌فرض)
T}
T{
\f[V]dir\f[R]
T}@T{
تنها تبدیل نام دایرکتوری‌ها \- ممکن است در هر کجای مسیر قرار داشته باشند
T}
T{
\f[V]all\f[R]
T}@T{
تبدیل کل مسیر برای فایل‌ها و دایرکتوری‌ها
T}
.TE
.PP
این کار با افزودن برچسب به نام تبدیل انجام می‌شود، مانند:
\f[V]--name-transform file,prefix=ABC\f[R] یا
\f[V]--name-transform dir,prefix=DEF\f[R].
.PP
برای برخی تبدیل‌ها، استفاده از all احتمالاً مفیدتر خواهد بود؛ برای نمونه:
\f[V]--name-transform all,nfc\f[R].
.PP
توجه داشته باشید که \f[V]--name-transform\f[R] نباید جداکننده‌های مسیر
\f[V]/\f[R] را به نام اضافه کند، زیرا این کار باعث ایجاد خطا خواهد شد..SS "ترتیب و تداخل‌ها (Ordering and Conflicts)"
.IP \[bu] 2
تبدیل‌ها به ترتیبی که توسط کاربر مشخص شده است اعمال خواهند شد.
.RS 2
.IP \[bu] 2
اگر برچسب \f[V]file\f[R] در حال استفاده باشد (پیش‌فرض)، تنها نام انتهایی
فایل‌ها تبدیل خواهد شد.
.IP \[bu] 2
اگر برچسب \f[V]dir\f[R] در حال استفاده باشد، دایرکتوری‌ها در هر کجای مسیر
تبدیل خواهند شد.
.IP \[bu] 2
اگر برچسب \f[V]all\f[R] در حال استفاده باشد، دایرکتوری‌ها و فایل‌ها در هر کجای
مسیر تبدیل خواهند شد.
.IP \[bu] 2
هر تبدیل در هر نوبت روی یک بخش از مسیر اجرا خواهد شد.
.IP \[bu] 2
اگر یک تبدیل کاراکتر \f[V]/\f[R] اضافه کند یا منجر به یک بخش خالی در مسیر
شود، یک خطا خواهد بود.
.RE
.IP \[bu] 2
قرار دادن تبدیل‌ها در یک ترتیب منطقی بر عهدهٔ کاربر است.
.RS 2
.IP \[bu] 2
تبدیل‌های متناقض، مانند \f[V]prefix\f[R] که در ادامهٔ آن
\f[V]trimprefix\f[R] بیاید یا \f[V]nfc\f[R] که در ادامهٔ آن \f[V]nfd\f[R] بیاید،
امکان‌پذیر هستند.
.IP \[bu] 2
به‌جای اعمال انحصار متقابل، تبدیل‌ها به ترتیبی که کاربر مشخص کرده است
به‌صورت متوالی اعمال می‌شوند و امکان موارد استفادهٔ عمدی را فراهم می‌کنند
(مانند حذف یک پیشوند قبل از افزودن پیشوندی دیگر).
.IP \[bu] 2
کاربران باید آگاه باشند که برخی ترکیب‌ها ممکن است به نتایج غیرمنتظره
منجر شوند و باید تبدیل‌ها را پیش از اجرا با استفاده از \f[V]--dry-run\f[R]
راستی‌آزمایی کنند.
.RE
.SS "شرایط رقابتی و رفتار غیرقطعی (Race Conditions and Non-Deterministic Behavior)"
.PP
برخی از تبدیل‌ها، مانند \f[V]replace=old:new\f[R]، ممکن است تداخل‌هایی ایجاد
کنند که در آن‌ها چندین فایل مبدأ به یک نام مقصد یکسان نگاشت می‌شوند.
این امر هنگام انجام انتقال‌های هم‌روند می‌تواند به شرایط رقابتی منجر شود.
پیش‌بینی این موارد بر عهدهٔ کاربر است.
.IP \[bu] 2
اگر دو فایل از مبدأ پس از تبدیل به نام یکسانی در مقصد نگاشت شوند،
وضعیت نهایی ممکن است غیرقطعی باشد.
.IP \[bu] 2
اجرای rclone check پس از یک همگام‌سازی با استفاده از چنین تبدیل‌هایی ممکن است
به دلیل نتایج رونویسی‌شده، فایل‌های مفقود یا متفاوت را به‌اشتباه گزارش کند.
.PP
برای به حداقل رساندن خطرات، کاربران باید:
.IP \[bu] 2
تبدیل‌هایی را که ممکن است تداخل ایجاد کنند با دقت بازبینی کنند.
.IP \[bu] 2
از \f[V]--dry-run\f[R] برای بررسی تغییرات پیش از اجرای همگام‌سازی استفاده کنند (اما
به یاد داشته باشند که این گزینه تأثیر تبدیل‌های غیرقطعی را نشان نخواهد داد).
.IP \[bu] 2
از تبدیل‌هایی که باعث می‌شوند چندین فایل مبدأ مجزا به یک نام مقصد
یکسان نگاشت شوند، خودداری کنند.
.IP \[bu] 2
در صورت لزوم، غیرفعال کردن هم‌روندی با \f[V]--transfers=1\f[R] را مد نظر قرار دهند.
.IP \[bu] 2
برخی تبدیل‌ها (مانند
\f[V]prefix\f[R]) هر بار که استفاده شوند اثری فزاینده خواهند داشت.
هنگام استفاده از \f[V]bisync\f[R] از این موارد اجتناب کنید.
.IP
.nf
\f[C]
rclone convmv dest:path --name-transform XXX [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --create-empty-src-dirs   ایجاد دایرکتوری‌های خالی مبدأ در مقصد پس از انتقال
      --delete-empty-src-dirs   حذف دایرکتوری‌های خالی مبدأ پس از انتقال
  -h, --help                    راهنمایی برای convmv
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را
ببینید..SS گزینه‌های کپی (Copy Options)
.PP
پرچم‌هایی برای هر عملیاتی که می‌تواند یک فایل را کپی کند
.IP
.nf
\f[C]
      --check-first                                 انجام تمام بررسی‌ها پیش از آغاز انتقال‌ها
  -c, --checksum                                    بررسی تغییرات با اندازه و checksum (در صورت دسترسی، یا بازگشت به فقط اندازه)
      --compare-dest stringArray                    گنجاندن مسیرهای سمت سرور اضافی در طول مقایسه
      --copy-dest stringArray                       شامل --compare-dest است اما فایل‌ها را نیز از مسیرها به مقصد کپی می‌کند
      --cutoff-mode HARD|SOFT|CAUTIOUS              حالت توقف انتقال‌ها پس از رسیدن به حد نهایی، یکی از HARD|SOFT|CAUTIOUS (پیش‌فرض HARD)
      --ignore-case-sync                            نادیده گرفتن بزرگی و کوچکی حروف هنگام همگام‌سازی
      --ignore-checksum                             صرف‌نظر کردن از بررسی checksum پس از کپی
      --ignore-existing                             رد شدن از تمام فایل‌هایی که در مقصد وجود دارند
      --ignore-size                                 نادیده گرفتن اندازه هنگام رد شدن؛ استفاده از modtime یا checksum
  -I, --ignore-times                                رد نشدن از موارد دارای اندازه و زمان یکسان \- انتقال همه بدون قید و شرط
      --immutable                                   دستکاری نکردن فایل‌ها؛ ناموفق شدن در صورت تغییر یافتن فایل‌های موجود
      --inplace                                     بارگیری مستقیم در فایل مقصد به جای بارگیری اتمیک در فایل موقت/تغییر نام
  -l, --links                                       تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq]
      --max-backlog int                             حداکثر تعداد اشیاء در صف همگام‌سازی یا بررسی (پیش‌فرض 10000)
      --max-duration Duration                       حداکثر مدت زمانی که rclone داده‌ها را انتقال می‌دهد (پیش‌فرض 0s)
      --max-transfer SizeSuffix                     حداکثر حجم داده برای انتقال (پیش‌فرض off)
  -M, --metadata                                    در صورت تنظیم، حفظ فراداده هنگام کپی کردن اشیاء
      --modify-window Duration                      حداکثر اختلاف زمانی برای یکسان در نظر گرفتن (پیش‌فرض 1ns)
      --multi-thread-chunk-size SizeSuffix          اندازه قطعه‌ها برای بارگیری / بارگذاری چند‌رشته‌ای، اگر توسط سیستم‌فایل تعیین نشده باشد (پیش‌فرض 64Mi)
      --multi-thread-cutoff SizeSuffix              استفاده از بارگیری چند‌رشته‌ای برای فایل‌های بزرگ‌تر از این اندازه (پیش‌فرض 256Mi)
      --multi-thread-streams int                    تعداد جریان‌های مورد استفاده در بارگیری چند‌رشته‌ای (پیش‌فرض 4)
      --multi-thread-write-buffer-size SizeSuffix   اندازه بافر حافظه برای نوشتن در حالت چند‌رشته‌ای (پیش‌فرض 128Ki)
      --name-transform stringArray                  تبدیل مسیرها در طول فرایند کپی
      --no-check-dest                               بررسی نکردن مقصد، کپی کردن در هر صورت
      --no-traverse                                 عدم پیمایش سیستم‌فایل مقصد هنگام کپی
      --no-update-dir-modtime                       به‌روزرسانی نکردن زمان‌های تغییر دایرکتوری
      --no-update-modtime                           به‌روزرسانی نکردن modtime مقصد در صورت یکسان بودن فایل‌ها
      --order-by string                             دستورالعمل‌ها درباره نحوه مرتب‌سازی انتقال‌ها، مانند \[aq]size,descending\[aq]
      --partial-suffix string                       افزودن partial-suffix به نام فایل موقت هنگامی که --inplace استفاده نمی‌شود (پیش‌فرض \[dq].partial\[dq])
      --refresh-times                               تازه‌سازی modtime فایل‌های راه دور
      --server-side-across-configs                  اجازه دادن به عملیات‌های سمت سرور (مانند کپی) برای کار در پیکربندی‌های مختلف
      --size-only                                   رد شدن تنها بر پایه اندازه، نه بر اساس modtime یا checksum
      --streaming-upload-cutoff SizeSuffix          حد آستانه برای جابجایی به بارگذاری تکه‌ای در صورت نامعلوم بودن اندازه فایل؛ بارگذاری پس از رسیدن به آستانه یا اتمام فایل آغاز می‌شود (پیش‌فرض 100Ki)
  -u, --update                                      رد شدن از فایل‌هایی که در مقصد جدیدتر هستند
\f[R]
.fi
.SS گزینه‌های مهم (Important Options)
.PP
پرچم‌های مهم و کاربردی برای بیشتر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال هیچ تغییر دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ اطلاعات بسیار بیشتر (تکرار برای جزئیات بیشتر)
\f[R]
.fi
.SS گزینه‌های فیلتر (Filter Options)
.PP
پرچم‌هایی برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از \- برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود filename
      --files-from stringArray              خواندن فهرست نام‌های فایل مبدأ از فایل (استفاده از \- برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل مبدأ از فایل بدون هیچ پردازشی روی خطوط (استفاده از \- برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل مبدأ از فایل با استفاده از NUL به عنوان جداکننده (استفاده از \- برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قاعده فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (استفاده از \- برای خواندن از stdin)
      --hash-filter string                  افراز نام‌فایل‌ها بر اساس هش k/n یا به صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای گنجاندن فایل از فایل (استفاده از \- برای خواندن از stdin)
      --max-age Duration                    تنها انتقال فایل‌های جدیدتر از این مقدار بر حسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 تنها انتقال فایل‌های کوچک‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض off)
      --metadata-exclude stringArray        مستثنی کردن فراداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای فراداده از فایل (استفاده از \- برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قاعده فیلتر کردن فراداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن فراداده از یک فایل (استفاده از \- برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن فراداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای گنجاندن فراداده از فایل (استفاده از \- برای خواندن از stdin)
      --min-age Duration                    تنها انتقال فایل‌های قدیمی‌تر از این مقدار بر حسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --min-size SizeSuffix                 تنها انتقال فایل‌های بزرگ‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض off)
\f[R]
.fi.SS "گزینه‌های فهرست‌کردن (Listing Options)"
.PP
پرچم‌ها برای فهرست‌کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت در دسترس بودن؛ حافظه بیشتر اما تراکنش‌های کمتری مصرف می‌کند
\f[R]
.fi
.SS "همچنین ببینید (See Also)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH "rclone copyto"
.PP
کپی کردن فایل‌ها از مبدأ به مقصد، با نادیده گرفتن فایل‌های یکسان.
.SS "خلاصه دستور (Synopsis)"
.PP
اگر source:path یک فایل یا دایرکتوری باشد، آن را در یک فایل یا دایرکتوری به نام dest:path کپی می‌کند.
.PP
از این دستور می‌توان برای کپی کردن یک فایل تکی به مقصدی با نامی متفاوت از مبدأ استفاده کرد \- برای نمونه، بارگذاری و تغییر نام در یک مرحله.
اگر مبدأ یک دایرکتوری باشد، دقیقاً مانند دستور copy (https://rclone.org/commands/rclone_copy) عمل می‌کند.
.PP
بنابراین
.IP
.nf
\f[C]
rclone copyto src dst
\f[R]
.fi
.PP
که در آن src و dst مسیرهای rclone هستند، چه به‌صورت \f[V]remote:path\f[R] یا
\f[V]/path/to/local\f[R] یا
\f[V]C:\[rs]windows\[rs]path\[rs]if\[rs]on\[rs]windows\f[R].
.PP
این دستور موارد زیر را انجام خواهد داد:
.IP
.nf
\f[C]
اگر src فایل باشد
    آن را در dst کپی می‌کند، و در صورت وجود فایل قبلی آن را بازنویسی می‌کند
اگر src دایرکتوری باشد
    آن را در dst کپی می‌کند، و در صورت وجود فایل‌های قبلی آن‌ها را بازنویسی می‌کند
    برای جزئیات کامل به دستور copy مراجعه کنید
\f[R]
.fi
.PP
این دستور فایل‌هایی را که در src و dst یکسان باشند (با بررسی اندازه و زمان ویرایش یا MD5SUM) انتقال نمی‌دهد.
همچنین هیچ فایلی را از مقصد حذف نمی‌کند.
.PP
\f[I]اگر قصد دارید تنها محدوده‌ای از بایت‌های یک فایل را کپی کنید، لطفاً \f[VI]rclone cat --offset X --count Y\f[I] را ببینید.\f[R]
.PP
\f[B]نکته\f[R]: از پرچم \f[V]-P\f[R]/\f[V]--progress\f[R] برای مشاهده آمار بلادرنگ انتقال استفاده کنید.
.SS "پرچم‌های گزارش‌گیری (Logger Flags)"
.PP
پرچم‌های \f[V]--differ\f[R]، \f[V]--missing-on-dst\f[R]،
\f[V]--missing-on-src\f[R]، \f[V]--match\f[R] و \f[V]--error\f[R]
مسیرها را، هر کدام در یک خط، در نام فایل داده‌شده (یا stdout اگر
\f[V]-\f[R] باشد) می‌نویسند.
آنچه می‌نویسند در راهنمای زیر شرح داده شده است.
برای نمونه \f[V]--differ\f[R] تمام مسیرهایی را که در هر دو مبدأ و مقصد وجود دارند ولی متفاوت هستند، می‌نویسد.
.PP
پرچم \f[V]--combined\f[R] فایلی (یا stdout) می‌نویسد که شامل تمام مسیرهای فایل به همراه یک نماد، سپس یک فاصله و سپس مسیر است تا وضعیت روی‌داده برای آن را به شما اعلام کند.
این خروجی یادآور فایل‌های diff است.
.IP \[bu] 2
\f[V]= path\f[R] به این معنی است که مسیر در مبدأ و مقصد یافت شد و یکسان بود
.IP \[bu] 2
\f[V]- path\f[R] به این معنی است که مسیر در مبدأ وجود نداشت، بنابراین فقط در مقصد قرار دارد
.IP \[bu] 2
\f[V]+ path\f[R] به این معنی است که مسیر در مقصد وجود نداشت، بنابراین فقط در مبدأ قرار دارد
.IP \[bu] 2
\f[V]* path\f[R] به این معنی است که مسیر در مبدأ و مقصد وجود داشت اما متفاوت بود.
.IP \[bu] 2
\f[V]! path\f[R] به این معنی است که در خواندن یا محاسبه هش مبدأ یا مقصد خطایی رخ داده است.
.PP
پرچم \f[V]--dest-after\f[R] یک فایل فهرست را با استفاده از همان پرچم‌های قالب‌بندی
\f[V]lsf\f[R] (https://rclone.org/commands/rclone_lsf#synopsis)
(شامل گزینه‌های قابل تنظیم برای hash، modtime و
غیره (https://rclone.org/commands/rclone_lsf#synopsis)) می‌نویسد. از نظر مفهومی مشابه \f[V]--itemize-changes\f[R] در rsync است، اما یکسان نیست
\-- این پرچم باید فهرستی دقیق از آنچه پس از پایان دستور در مقصد خواهد بود را در خروجی ارائه دهد.
.PP
هنگامی که پرچم \f[V]--no-traverse\f[R] تنظیم شده باشد، تمام گزارش‌های مربوط به فایل‌هایی که تنها در مقصد وجود دارند ناقص بوده یا به‌طور کامل ثبت نخواهند شد.
.PP
توجه داشته باشید که این پرچم‌های گزارش‌گیری محدودیت‌هایی دارند و برخی سناریوها در حال حاضر پشتیبانی نمی‌شوند:
.IP \[bu] 2
\f[V]--max-duration\f[R] / \f[V]CutoffModeHard\f[R]
.IP \[bu] 2
\f[V]--compare-dest\f[R] / \f[V]--copy-dest\f[R]
.IP \[bu] 2
انتقال سمت سرور (server-side moves) برای کل یک دایرکتوری به‌طور هم‌زمان
.IP \[bu] 2
تلاش‌های مجدد در سطح بالا (High-level retries)، زیرا موارد تکراری ایجاد خواهد شد (برای غیرفعال کردن از \f[V]--retries 1\f[R] استفاده کنید)
.IP \[bu] 2
احتمالاً برخی از سناریوهای غیرمعمول خطا
.PP
همچنین توجه داشته باشید که هر فایل در حین اجرا گزارش می‌شود، نه پس از آن؛ بنابراین بیشتر به عنوان پیش‌بینی‌کننده‌ای برای آنچه «باید» برای هر فایل رخ دهد مفید است (که ممکن است با آنچه واقعاً رخ داده است مطابقت داشته باشد یا خیر).
.IP
.nf
\f[C]
rclone copyto source:path dest:path [flags]
\f[R]
.fi.SS "گزینه‌ها (Options)"
.IP
.nf
\f[C]
      --absolute                قرار دادن یک / در ابتدای نام مسیرها
      --combined string         ایجاد گزارش ترکیبی از تغییرات در این فایل
      --csv                     خروجی در قالب CSV
      --dest-after string       گزارش تمام فایل‌های موجود در مقصد پس از همگام‌سازی در این فایل
      --differ string           گزارش تمام فایل‌های ناهمخوان در این فایل
  -d, --dir-slash               افزودن اسلش به انتهای نام دایرکتوری‌ها (پیش‌فرض true)
      --dirs-only               فقط فهرست کردن دایرکتوری‌ها
      --error string            گزارش تمام فایل‌های دارای خطا (در هش‌کردن یا خواندن) در این فایل
      --files-only              فقط فهرست کردن فایل‌ها (پیش‌فرض true)
  -F, --format string           قالب خروجی - برای جزئیات راهنمای lsf را ببینید (پیش‌فرض \[dq]p\[dq])
      --hash h                  استفاده از این هش هنگامی که h در قالب به کار رفته است: MD5|SHA-1|DropboxHash (پیش‌فرض \[dq]md5\[dq])
  -h, --help                    راهنمای copyto
      --match string            گزارش تمام فایل‌های منطبق در این فایل
      --missing-on-dst string   گزارش تمام فایل‌های ناموجود در مقصد در این فایل
      --missing-on-src string   گزارش تمام فایل‌های ناموجود در مبدأ در این فایل
  -s, --separator string        جداکننده برای موارد موجود در قالب (پیش‌فرض \[dq];\[dq])
  -t, --timeformat string       تعیین قالب زمانی سفارشی - برای جزئیات مستندات را ببینید (پیش‌فرض: 2006-01-02 15:04:05)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (<https://rclone.org/flags>) را ببینید.
.SS "گزینه‌های کپی (Copy Options)"
.PP
پرچم‌ها برای هر عملیاتی که می‌تواند فایلی را کپی کند
.IP
.nf
\f[C]
      --check-first                                 انجام تمام بررسی‌ها پیش از آغاز انتقال‌ها
  -c, --checksum                                    بررسی تغییرات با استفاده از اندازه و چکسام (در صورت وجود، یا بازگشت به اندازه تنها)
      --compare-dest stringArray                    شامل کردن مسیرهای اضافی سمت سرور هنگام مقایسه
      --copy-dest stringArray                       ضمن اعمال --compare-dest، فایل‌ها را نیز از مسیرها به مقصد کپی می‌کند
      --cutoff-mode HARD|SOFT|CAUTIOUS              حالت متوقف کردن انتقال‌ها هنگام رسیدن به حد مجاز انتقال HARD|SOFT|CAUTIOUS (پیش‌فرض HARD)
      --ignore-case-sync                            نادیده گرفتن بزرگی و کوچکی حروف هنگام همگام‌سازی
      --ignore-checksum                             صرف‌نظر از بررسی چکسام‌ها پس از کپی
      --ignore-existing                             صرف‌نظر از تمام فایل‌هایی که در مقصد موجودند
      --ignore-size                                 نادیده گرفتن اندازه هنگام صرف‌نظر کردن و استفاده از modtime یا چکسام
  -I, --ignore-times                                صرف‌نظر نکردن از موارد همسان از نظر اندازه و زمان - انتقال همه بدون قید و شرط
      --immutable                                   عدم تغییر فایل‌ها؛ در صورت تغییر یافتن فایل‌های موجود با خطا مواجه شود
      --inplace                                     بارگیری مستقیم در فایل مقصد به‌جای بارگیری اتمیک در فایل موقت/تغییر نام
  -l, --links                                       تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq]
      --max-backlog int                             حداکثر تعداد اشیاء در صف همگام‌سازی یا بررسی (پیش‌فرض 10000)
      --max-duration Duration                       حداکثر مدتی که rclone به انتقال داده‌ها خواهد پرداخت (پیش‌فرض 0s)
      --max-transfer SizeSuffix                     حداکثر حجم داده برای انتقال (پیش‌فرض غیرفعال)
  -M, --metadata                                    در صورت تنظیم، متادیتا هنگام کپی اشیاء حفظ می‌شود
      --modify-window Duration                      حداکثر اختلاف زمانی مجاز برای یکسان در نظر گرفتن (پیش‌فرض 1ns)
      --multi-thread-chunk-size SizeSuffix          اندازه قطعه برای بارگیری‌ها/بارگذاری‌های چندرشته‌ای، اگر توسط فایل‌سیستم تعیین نشده باشد (پیش‌فرض 64Mi)
      --multi-thread-cutoff SizeSuffix              استفاده از بارگیری چندرشته‌ای برای فایل‌های بزرگتر از این اندازه (پیش‌فرض 256Mi)
      --multi-thread-streams int                    تعداد جریان‌ها برای استفاده در بارگیری چندرشته‌ای (پیش‌فرض 4)
      --multi-thread-write-buffer-size SizeSuffix   اندازه بافر درون حافظه برای نوشتن در حالت چندرشته‌ای (پیش‌فرض 128Ki)
      --name-transform stringArray                  تبدیل مسیرها در طول فرایند کپی
      --no-check-dest                               بررسی نکردن مقصد، کپی تحت هر شرایطی
      --no-traverse                                 عدم پیمایش سیستم فایل مقصد هنگام کپی
      --no-update-dir-modtime                       به‌روزرسانی نکردن زمان ویرایش دایرکتوری‌ها
      --no-update-modtime                           به‌روزرسانی نکردن زمان ویرایش (modtime) مقصد در صورت یکسان بودن فایل‌ها
      --order-by string                             دستورالعمل‌ها برای نحوه اولویت‌بندی و ترتیب انتقال‌ها، مثلاً \[aq]size,descending\[aq]
      --partial-suffix string                       افزودن پسوند جزئی به نام فایل موقت هنگامی که --inplace استفاده نشده است (پیش‌فرض \[dq].partial\[dq])
      --refresh-times                               تازه‌سازی زمان ویرایش (modtime) فایل‌های راه دور
      --server-side-across-configs                  مجاز ساختن عملیات‌های سمت سرور (مانند کپی) بین پیکربندی‌های مختلف
      --size-only                                   صرف‌نظر کردن فقط بر اساس اندازه، نه modtime یا چکسام
      --streaming-upload-cutoff SizeSuffix          حد آستانه برای جابجایی به بارگذاری تکه‌ای در صورت نامشخص بودن اندازه فایل (پیش‌فرض 100Ki)
  -u, --update                                      صرف‌نظر از فایل‌هایی که در مقصد جدیدتر هستند
\f[R]
.fi
.SS "گزینه‌های مهم (Important Options)"
.PP
پرچم‌های مهم و کاربردی برای اکثر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال کردن حالت تعاملی
  -v, --verbose count   چاپ اطلاعات بسیار بیشتر (تکرار برای جزئیات بیشتر)
\f[R]
.fi.SS گزینه‌های پالایش (Filter Options)
.PP
پرچم‌ها برای پالایش فهرست‌های دایرکتوری
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های روی مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (برای خواندن از stdin از - استفاده کنید)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود filename
      --files-from stringArray              خواندن فهرست نام فایل‌های مبدأ از فایل (برای خواندن از stdin از - استفاده کنید)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از فایل بدون هیچ پردازشی روی خطوط (برای خواندن از stdin از - استفاده کنید)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (برای خواندن از stdin از - استفاده کنید)
  -f, --filter stringArray                  افزودن یک قاعدهٔ پالایش فایل
      --filter-from stringArray             خواندن الگوهای پالایش فایل از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --hash-filter string                  افراز نام فایل‌ها با هش k/n یا تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در پالایه‌ها (حساس نبودن به حروف بزرگ و کوچک)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (برای خواندن از stdin از - استفاده کنید)
      --max-age Duration                    فقط انتقال فایل‌های جدیدتر از این مقدار برحسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 فقط انتقال فایل‌های کوچک‌تر از این مقدار برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض off)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (برای خواندن از stdin از - استفاده کنید)
      --metadata-filter stringArray         افزودن یک قاعدهٔ پالایش متاداده
      --metadata-filter-from stringArray    خواندن الگوهای پالایش متاداده از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از فایل (برای خواندن از stdin از - استفاده کنید)
      --min-age Duration                    فقط انتقال فایل‌های قدیمی‌تر از این مقدار برحسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --min-size SizeSuffix                 فقط انتقال فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض off)
\f[R]
.fi
.SS گزینه‌های فهرست‌بندی (Listing Options)
.PP
پرچم‌ها برای فهرست کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورتی که modtime برای فایل‌ها و دایرکتوری‌ها نامشخص باشد (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت در دسترس بودن؛ حافظهٔ بیشتر اما تراکنش‌های کمتری مصرف می‌کند
\f[R]
.fi
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone copyurl
.PP
کپی کردن محتوای URL ارائه‌شده به dest:path.
.SS خلاصه دستور (SYNOPSIS)
.PP
دانلود محتوای یک URL و کپی کردن آن به مقصد بدون ذخیره در فضای ذخیره‌سازی موقت.
.PP
تنظیم \f[V]--auto-filename\f[R] تلاش خواهد کرد تا نام فایل را به‌طور خودکار از URL (پس از هرگونه تغییر مسیر) تشخیص داده و در مسیر مقصد استفاده کند.
.PP
علاوه بر این، با \f[V]--header-filename\f[R]، اگر نام فایل مشخصی در سرآیندهای HTTP تعیین شده باشد، به‌جای نام برگرفته از URL استفاده خواهد شد.
علاوه بر این، با \f[V]--print-filename\f[R]، نام فایل نهایی چاپ خواهد شد.
.PP
تنظیم \f[V]--no-clobber\f[R] از بازنویسی فایل در مقصد، در صورتی که فایلی با همان نام وجود داشته باشد، جلوگیری می‌کند.
.PP
تنظیم \f[V]--stdout\f[R] یا تعیین نام فایل خروجی به‌صورت \f[V]-\f[R] باعث می‌شود که خروجی در خروجی استاندارد نوشته شود.
.PP
تنظیم \f[V]--urls\f[R] به شما امکان می‌دهد یک فایل CSV از URLها را در قالب URL, FILENAME وارد کنید.
اگر \f[V]--urls\f[R] استفاده شود، در آرگومان‌ها فایل حاوی URLها را جایگزین URL کنید، مانند:
.IP
.nf
\f[C]
rclone copyurl --urls myurls.csv remote:dir
\f[R]
.fi
.PP
نام‌های فایل ناموجود به‌طور خودکار تولید خواهند شد، معادل استفاده از \f[V]--auto-filename\f[R].
توجه داشته باشید که \f[V]--stdout\f[R] و \f[V]--print-filename\f[R] با \f[V]--urls\f[R] ناسازگار هستند.
این کار \f[V]--transfers\f[R] کپی را به‌صورت موازی انجام می‌دهد.
توجه داشته باشید که اگر \f[V]--auto-filename\f[R] برای همهٔ URLها مورد نظر باشد، می‌توان از فایلی تنها حاوی URLها و بدون نام فایل استفاده کرد.
.PP
هر FILENAME در فایل CSV می‌تواند با یک مسیر نسبی آغاز شود که به مسیر مقصد ارائه‌شده در خط فرمان ضمیمه خواهد شد.
برای مثال، اجرای دستور نشان‌داده‌شده در بالا با فایل CSV زیر، دو فایل را در مقصد خواهد نوشت:
\f[V]remote:dir/local/path/bar.json\f[R] و
\f[V]remote:dir/another/local/directory/qux.json\f[R]
.IP
.nf
\f[C]
https://example.org/foo/bar.json,local/path/bar.json
https://example.org/qux/baz.json,another/local/directory/qux.json
\f[R]
.fi.SS عیب‌یابی (Troubleshooting)
.PP
اگر نمی‌توانید \f[V]rclone copyurl\f[R] را به کار بیندازید، مواردی وجود دارد که می‌توانید امتحان کنید:
.IP \[bu] 2
\f[V]--disable-http2\f[R] در صورت دردسترس بودن، rclone از HTTP2 استفاده خواهد کرد \- غیرفعال کردن آن را امتحان کنید
.IP \[bu] 2
\f[V]--bind 0.0.0.0\f[R] در صورت دردسترس بودن، rclone از IPv6 استفاده خواهد کرد \- غیرفعال کردن آن را امتحان کنید
.IP \[bu] 2
\f[V]--bind ::0\f[R] برای غیرفعال کردن IPv4
.IP \[bu] 2
\f[V]--user agent curl\f[R] \- برخی از سایت‌ها دارای فهرست مجاز (whitelist) برای user-agent ابزار curl هستند \- این را امتحان کنید
.IP \[bu] 2
مطمئن شوید که سایت با \f[V]curl\f[R] به‌طور مستقیم کار می‌کند
.IP
.nf
\f[C]
rclone copyurl https://example.com dest:path [flags]
\f[R]
.fi
.SS گزینه‌ها (Options)
.IP
.nf
\f[C]
  -a, --auto-filename     دریافت نام فایل از URL و استفاده از آن برای مسیر فایل مقصد
      --header-filename   دریافت نام فایل از سرآیند Content-Disposition
  -h, --help              راهنمای copyurl
      --no-clobber        جلوگیری از رونویسی فایلی با همین نام
  -p, --print-filename    چاپ نام به‌دست‌آمده از --auto-filename
      --stdout            نوشتن خروجی در stdout به‌جای فایل
      --urls              استفاده از فایل CSV پیوندها برای پردازش چند URL
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS گزینه‌های مهم (Important Options)
.PP
پرچم‌های مهم و کاربردی برای اکثر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون ایجاد تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ جزئیات بسیار بیشتر (برای جزئیات بیشتر تکرار کنید)
\f[R]
.fi
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone cryptcheck
.PP
دستور cryptcheck صحت و یکپارچگی یک ریموت رمزشده را بررسی می‌کند.
.SS خلاصه دستور (SYNOPSIS)
.PP
یک ریموت را در برابر یک ریموت رمزشده (https://rclone.org/crypt) بررسی می‌کند.
این معادل اجرای rclone check (https://rclone.org/commands/rclone_check) است، با این تفاوت که می‌تواند چک‌سام‌های ریموت رمزشده را بررسی کند.
.PP
برای این که این دستور کار کند، ریموت زیربنایی cryptedremote باید از نوعی چک‌سام پشتیبانی کند.
.PP
نحوهٔ کارکرد آن به این صورت است که nonce را از هر فایل در cryptedremote: خوانده و از آن برای رمزگذاری هر فایل در remote: استفاده می‌کند.
سپس چک‌سام فایل زیرین در cryptedremote: را با چک‌سام فایلی که به‌تازگی رمزگذاری کرده است مقایسه می‌کند.
.PP
به این صورت از آن استفاده کنید:
.IP
.nf
\f[C]
rclone cryptcheck /path/to/files encryptedremote:path
\f[R]
.fi
.PP
می‌توانید به این شکل نیز از آن استفاده کنید، اما این کار مستلزم بارگیری تمام فایل‌ها در \f[V]remote:path\f[R] خواهد بود.
.IP
.nf
\f[C]
rclone cryptcheck remote:path encryptedremote:path
\f[R]
.fi
.PP
پس از اجرا، وضعیت \f[V]encryptedremote:\f[R] را ثبت (log) خواهد کرد.
.PP
اگر پرچم \f[V]--one-way\f[R] را مشخص کنید، فقط مطابقت داشتن فایل‌های مبدأ با فایل‌های مقصد را بررسی می‌کند، نه برعکس.
این بدان معناست که فایل‌های اضافی موجود در مقصد که در مبدأ نیستند شناسایی نخواهند شد.
.PP
پرچم‌های \f[V]--differ\f[R]، \f[V]--missing-on-dst\f[R]،
\f[V]--missing-on-src\f[R]، \f[V]--match\f[R] و \f[V]--error\f[R]
مسیرها را، هر کدام در یک خط، در نام فایل ارائه‌شده (یا اگر \f[V]-\f[R] باشد در stdout) می‌نویسند.
آنچه می‌نویسند در راهنمای زیر شرح داده شده است.
به عنوان مثال، \f[V]--differ\f[R] تمام مسیرهایی را که هم در مبدأ و هم در مقصد وجود دارند اما متفاوت هستند، خواهد نوشت.
.PP
پرچم \f[V]--combined\f[R] فایلی (یا در stdout) می‌نویسد که شامل تمام مسیرهای فایل است همراه با یک نماد و سپس یک فاصله و بعد مسیر فایل، تا نشان دهد چه اتفاقی برای آن افتاده است.
این ساختار یادآور فایل‌های diff است.
.IP \[bu] 2
\f[V]= path\f[R] به این معنی است که مسیر در مبدأ و مقصد یافت شد و یکسان بود.
.IP \[bu] 2
\f[V]- path\f[R] به این معنی است که مسیر در مبدأ وجود نداشت و فقط در مقصد بود.
.IP \[bu] 2
\f[V]+ path\f[R] به این معنی است که مسیر در مقصد وجود نداشت و فقط در مبدأ بود.
.IP \[bu] 2
\f[V]* path\f[R] به این معنی است که مسیر در مبدأ و مقصد وجود داشت اما متفاوت بود.
.IP \[bu] 2
\f[V]! path\f[R] به این معنی است که هنگام خواندن یا هش کردن مبدأ یا مقصد خطایی رخ داده است.
.PP
تعداد پیش‌فرض بررسی‌های موازی ۸ است.
برای اطلاعات بیشتر گزینهٔ --checkers (https://rclone.org/docs/#checkers-int) را ببینید.
.IP
.nf
\f[C]
rclone cryptcheck remote:path cryptedremote:path [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --combined string         ایجاد گزارش ترکیبی از تغییرات در این فایل
      --differ string           گزارش تمام فایل‌های ناهمخوان در این فایل
      --error string            گزارش تمام فایل‌های دارای خطا (هش‌کردن یا خواندن) در این فایل
  -h, --help                    راهنمای cryptcheck
      --match string            گزارش تمام فایل‌های همخوان در این فایل
      --missing-on-dst string   گزارش تمام فایل‌های ناموجود در مقصد در این فایل
      --missing-on-src string   گزارش تمام فایل‌های ناموجود در مبدأ در این فایل
      --one-way                 بررسی فقط به‌صورت یک‌طرفه؛ فایل‌های مبدأ باید روی ریموت موجود باشند
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "گزینه‌های بررسی (Check Options)"
.PP
پرچم‌های مورد استفاده برای دستورهای بررسی (check)
.IP
.nf
\f[C]
      --max-backlog int   حداکثر تعداد اشیاء در صف انتظار همگام‌سازی یا بررسی (پیش‌فرض 10000)
\f[R]
.fi
.SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌هایی برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از - برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود filename
      --files-from stringArray              خواندن فهرست نام فایل‌های مبدأ از فایل (استفاده از - برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از فایل بدون هرگونه پردازش روی خطوط (استفاده از - برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (استفاده از - برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قانون فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --hash-filter string                  افراز نام فایل‌ها بر اساس هش k/n یا تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف بزرگ و کوچک)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از - برای خواندن از stdin)
      --max-age Duration                    انتقال فقط فایل‌های جدیدتر از این مقدار بر حسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 انتقال فقط فایل‌های کوچک‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنی کردن متادیتاهای منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متادیتا از فایل (استفاده از - برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قانون فیلتر کردن متادیتا
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر متادیتا از یک فایل (استفاده از - برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن متادیتاهای منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متادیتا از فایل (استفاده از - برای خواندن از stdin)
      --min-age Duration                    انتقال فقط فایل‌های قدیمی‌تر از این مقدار بر حسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 انتقال فقط فایل‌های بزرگ‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS "گزینه‌های فهرست‌بندی (Listing Options)"
.PP
پرچم‌هایی برای فهرست کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمانی که در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها نمایش داده می‌شود (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت موجود بودن؛ حافظه بیشتر اما تراکنش‌های کمتری مصرف می‌کند
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone cryptdecode
.PP
دستور Cryptdecode نام‌های غیررمزگذاری‌شدهٔ فایل‌ها را بازمی‌گرداند.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
هنگامی که فهرستی از نام‌های رمزگذاری‌شدهٔ فایل‌ها به آن داده شود، نام‌های غیررمزگذاری‌شده را بازمی‌گرداند.
محدودیت این فهرست ۱۰ مورد است.
.PP
اگر پرچم \f[V]--reverse\f[R] را تعیین کنید، نام‌های رمزگذاری‌شدهٔ فایل‌ها را بازمی‌گرداند.
.PP
نحوهٔ استفاده به این صورت است:
.IP
.nf
\f[C]
rclone cryptdecode encryptedremote: encryptedfilename1 encryptedfilename2
rclone cryptdecode --reverse encryptedremote: filename1 filename2
\f[R]
.fi
.PP
روش دیگر برای انجام این کار استفاده از دستور
\f[V]rclone backend encode\f[R] (یا \f[V]decode\f[R]) است.
برای اطلاعات بیشتر، مستندات مربوط به لایهٔ crypt (https://rclone.org/crypt) را ببینید.
.IP
.nf
\f[C]
rclone cryptdecode encryptedremote: encryptedfilename [flags]
\f[R]
.fi.SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
  -h, --help      راهنمای cryptdecode
      --reverse   معکوس کردن cryptdecode، نام فایل‌ها را رمزگذاری می‌کند
\f[R]
.fi
.PP
برای مشاهده گزینه‌های عمومی که در اینجا فهرست نشده‌اند، به صفحه پرچم‌های سراسری (https://rclone.org/flags) مراجعه کنید.
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone deletefile
.PP
حذف یک فایل منفرد از ریموت.
.SS خلاصه دستور (SYNOPSIS)
.PP
حذف یک فایل منفرد از ریموت.
برخلاف \f[V]delete\f[R] نمی‌توان از آن برای حذف یک دایرکتوری استفاده کرد و از فیلترهای include/exclude پیروی نمی‌کند \- اگر فایل مشخص‌شده وجود داشته باشد، همیشه حذف خواهد شد.
.IP
.nf
\f[C]
rclone deletefile remote:path [flags]
\f[R]
.fi
.SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
  -h, --help   راهنمای deletefile
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای مشاهده گزینه‌های عمومی که در اینجا فهرست نشده‌اند، به صفحه پرچم‌های سراسری (https://rclone.org/flags) مراجعه کنید.
.SS گزینه‌های مهم
.PP
پرچم‌های مهم و کاربردی برای اکثر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ جزئیات بسیار بیشتر (برای موارد بیشتر تکرار کنید)
\f[R]
.fi
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone gendocs
.PP
خروجی دادن مستندات markdown برای rclone در دایرکتوری ارائه‌شده.
.SS خلاصه دستور (SYNOPSIS)
.PP
این دستور مستندات markdown را برای دستورهای rclone در دایرکتوری ارائه‌شده تولید می‌کند.
این مستندات در قالبی مناسب هستند تا hugo بتواند آن‌ها را برای وب‌سایت rclone.org رندر کند.
.IP
.nf
\f[C]
rclone gendocs output_directory [flags]
\f[R]
.fi
.SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
  -h, --help   راهنمای gendocs
\f[R]
.fi
.PP
برای مشاهده گزینه‌های عمومی که در اینجا فهرست نشده‌اند، به صفحه پرچم‌های سراسری (https://rclone.org/flags) مراجعه کنید..SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنمای دستورها، پرچم‌ها و backendهای rclone.
.SH "rclone gitannex"
.PP
از طریق stdin/stdout با git-annex ارتباط برقرار می‌کند.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
زیرفرمان \f[V]gitannex\f[R] در rclone به git-annex (https://git-annex.branchable.com) امکان می‌دهد تا محتوا را در یک ریموت rclone ذخیره و بازیابی کند.
این زیرفرمان برای اجرا توسط خود git-annex طراحی شده است، نه اجرای مستقیم توسط کاربران.
.SS "نصب در لینوکس (INSTALLATION ON LINUX)"
.IP "1." 3
اگر نسخه git-annex شما 10.20240430 (https://git-annex.branchable.com/news/version_10.20240430) یا جدیدتر است، از این مرحله صرف‌نظر کنید.
در غیر این صورت، باید در مکانی روی PATH خود یک پیوند نمادین (symlink) با نامی مشخص ایجاد کنید.
این پیوند نمادین به git-annex کمک می‌کند تا به rclone اعلام کند که قصد اجرای زیرفرمان \[dq]gitannex\[dq] را دارد.
.RS 4
.PP
ایجاد پیوند نمادین کمکی در \[dq]$HOME/bin\[dq]:
.IP
.nf
\f[C]
ln -s \[dq]$(realpath rclone)\[dq] \[dq]$HOME/bin/git-annex-remote-rclone-builtin\[dq]

بررسی کنید که پیوند نمادین جدید در PATH شما قرار دارد:

\[ga]\[ga]\[ga]console
which git-annex-remote-rclone-builtin
\f[R]
.fi
.RE
.IP "2." 3
یک ریموت جدید به مخزن git-annex خود اضافه کنید.
این ریموت جدید git-annex را به زیرفرمان \f[V]rclone gitannex\f[R] متصل می‌کند.
.RS 4
.PP
با درخواست از git-annex برای توصیف پارامترهای پیکربندی موجود ریموت شروع کنید.
.PP
اگر از مرحله ۱ صرف‌نظر کردید:
.IP
.nf
\f[C]
git annex initremote MyRemote type=rclone --whatelse
\f[R]
.fi
.PP
اگر در مرحله ۱ یک پیوند نمادین ایجاد کردید:
.IP
.nf
\f[C]
git annex initremote MyRemote type=external externaltype=rclone-builtin --whatelse
\f[R]
.fi
.RS
.PP
\f[B]نکته\f[R]: اگر در حال انتقال ریموت موجود git-annex-remote-rclone (https://github.com/git-annex-remote-rclone/git-annex-remote-rclone) برای استفاده از \f[V]rclone gitannex\f[R] هستید، احتمالاً می‌توانید از پارامترهای پیکربندی عیناً و بدون تغییر نام استفاده کنید.
مترادف‌های پارامترها را با \f[V]--whatelse\f[R] همان‌طور که در بالا نشان داده شده است بررسی کنید.
.RE
.PP
مثال زیر یک ریموت git-annex جدید به نام \[dq]MyRemote\[dq] ایجاد می‌کند که از ریموت rclone به نام \[dq]SomeRcloneRemote\[dq] استفاده خواهد کرد.
آن ریموت rclone باید در فایل rclone.conf شما پیکربندی شده باشد، که محل قرارگیری آن با دستور \f[V]rclone config file\f[R] قابل تشخیص است.
.IP
.nf
\f[C]
git annex initremote MyRemote         \[rs]
    type=external                     \[rs]
    externaltype=rclone-builtin       \[rs]
    encryption=none                   \[rs]
    rcloneremotename=SomeRcloneRemote \[rs]
    rcloneprefix=git-annex-content    \[rs]
    rclonelayout=nodir
\f[R]
.fi
.RE
.IP "3." 3
پیش از آنکه داده‌های باارزش خود را به این دستور بسپارید، حتماً \f[B]ریموت را آزمایش کنید\f[R].
این دستور بسیار جدید است و بر روی بسیاری از backendهای rclone آزمایش نشده است.
احتیاط کنید (مسئولیت استفاده بر عهده خودتان است)!
.RS 4
.IP
.nf
\f[C]
git annex testremote MyRemote
\f[R]
.fi
.RE
.PP
ضمیمه‌سازی موفقی داشته باشید!
.IP
.nf
\f[C]
rclone gitannex [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمایی برای gitannex
\f[R]
.fi
.PP
برای دیدن گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنمایی برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone gui
.PP
باز کردن رابط کاربری گرافیکی (GUI) مبتنی بر وب.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور یک رابط کاربری گرافیکی (GUI) تحت وبِ تعبیه‌شده را برای rclone راه‌اندازی می‌کند و آن را در مرورگر پیش‌فرض شما باز می‌کند.
.PP
این دستور یک سرور RC API و یک سرور GUI را روی درگاه‌های جداگانهٔ localhost راه‌اندازی می‌کند، اعتبارنامه‌های ورود را به‌طور خودکار تولید می‌کند مگر اینکه \-\-no\-auth مشخص شده باشد، و مرورگر را در حالت از پیش احراز هویت شده باز می‌کند.
.IP
.nf
\f[C]
rclone gui
\f[R]
.fi
.PP
به‌طور پیش‌فرض rclone gui رابط کاربری تحت وبی را ارائه می‌دهد که در زمان ساخت، از https://github.com/rclone/rclone-web درون فایل باینری rclone تعبیه شده است. شما می‌توانید با مشخص کردن مسیر یک دایرکتوری استخراج‌شدهٔ GUI یا یک آرشیو dist.zip (برای مثال فایلی که از صفحهٔ انتشارهای rclone-web بارگیری شده باشد) این رفتار را جایگزین کنید:
.IP
.nf
\f[C]
rclone gui ./my-dist/
rclone gui ./dist.zip
\f[R]
.fi
.PP
این قابلیت برای توسعه و آزمایش مکرر روی GUI به‌صورت محلی بدون نیاز به ساخت مجدد rclone، یا برای ارائهٔ نسخه‌ای از GUI متفاوت با نسخهٔ تعبیه‌شده، کاربردی است.
.PP
از \-\-no\-open\-browser برای جلوگیری از باز شدن خودکار مرورگر استفاده کنید:
.IP
.nf
\f[C]
rclone gui --no-open-browser
\f[R]
.fi
.PP
از \-\-addr برای مقید کردن GUI به یک نشانی مشخص استفاده کنید:
.IP
.nf
\f[C]
rclone gui --addr localhost:5580
\f[R]
.fi
.PP
از \-\-user و \-\-pass برای تنظیم اعتبارنامه‌های ورود مشخص استفاده کنید:
.IP
.nf
\f[C]
rclone gui --user admin --pass secret
\f[R]
.fi
.PP
از \-\-no\-auth برای غیرفعال کردن کامل احراز هویت استفاده کنید:
.IP
.nf
\f[C]
rclone gui --no-auth
\f[R]
.fi
.PP
برای راهنمایی بیشتر، مستندات GUI را ببینید (https://rclone.org/gui).
.IP
.nf
\f[C]
rclone gui [path] [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --addr stringArray       IPaddress:Port برای سرور GUI (پیش‌فرض: درگاه خودکار انتخاب‌شده روی localhost)
      --api-addr stringArray   IPaddress:Port برای سرور RC API (پیش‌فرض: درگاه خودکار انتخاب‌شده روی localhost)
      --enable-metrics         فعال‌سازی اندپوینت سازگار با OpenMetrics/Prometheus در /metrics
  -h, --help                   راهنمای gui
      --no-auth                عدم نیاز به احراز هویت برای RC API
      --no-open-browser        صرف‌نظر از باز کردن خودکار مرورگر
      --pass string            گذرواژه برای احراز هویت RC
      --user string            نام کاربری برای احراز هویت RC
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه توضیح داده شده‌اند.
برای مشاهدهٔ گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "گزینه‌های RC"
.PP
پرچم‌هایی برای کنترل API کنترل از راه دور (Remote Control)
.IP
.nf
\f[C]
      --rc                                 فعال‌سازی سرور کنترل از راه دور (remote control)
      --rc-addr stringArray                IPaddress:Port یا :Port برای مقید کردن سرور به آن (پیش‌فرض localhost:5572)
      --rc-allow-origin string             مبدأیی که درخواست بین‌دامنه (CORS) می‌تواند از آن اجرا شود
      --rc-baseurl string                  پیشوند برای URLها \- برای ریشه خالی بگذارید
      --rc-cert string                     کلید TLS PEM (ترکیب گواهی و گواهی CA)
      --rc-client-ca string                مرجع صدور گواهی (CA) کلاینت جهت اعتبارسنجی کلاینت‌ها
      --rc-enable-metrics                  فعال‌سازی مسیر معیارهای Prometheus در سرور کنترل از راه دور
      --rc-files string                    مسیر فایل‌های محلی برای ارائه در سرور HTTP
      --rc-htpasswd string                 یک فایل htpasswd \- در صورت عدم ارائه، احراز هویتی انجام نمی‌شود
      --rc-job-expire-duration Duration    منقضی کردن کارهای غیرهمگام پایان‌یافته قدیمی‌تر از این مقدار (پیش‌فرض 1m0s)
      --rc-job-expire-interval Duration    بازه زمانی بررسی کارهای غیرهمگام منقضی‌شده (پیش‌فرض 10s)
      --rc-key string                      کلید خصوصی TLS PEM
      --rc-max-header-bytes int            حداکثر اندازه هدر درخواست (پیش‌فرض 4096)
      --rc-min-tls-version string          حداقل نسخه قابل قبول TLS (پیش‌فرض \[dq]tls1.0\[dq])
      --rc-no-auth                         عدم نیاز به احراز هویت برای متدهای خاص
      --rc-pass string                     گذرواژه برای احراز هویت
      --rc-realm string                    حوزه (Realm) برای احراز هویت
      --rc-response-header stringArray     تنظیم هدر HTTP برای همه پاسخ‌ها، با بازنویسی مقادیر موجود
      --rc-salt string                     سالت درهم‌سازی گذرواژه (پیش‌فرض \[dq]dlPL2MqE\[dq])
      --rc-serve                           فعال‌سازی ارائه اشیاء دوردست (remote)
      --rc-serve-no-modtime                عدم خواندن زمان تغییر (می‌تواند کارها را سریع‌تر کند)
      --rc-server-read-timeout Duration    مهلت زمانی خواندن داده توسط سرور (پیش‌فرض 1h0m0s)
      --rc-server-write-timeout Duration   مهلت زمانی نوشتن داده توسط سرور (پیش‌فرض 1h0m0s)
      --rc-template string                 قالب مشخص‌شده توسط کاربر
      --rc-user string                     نام کاربری برای احراز هویت
      --rc-user-from-header string         نام کاربری از یک هدر تعریف‌شده HTTP
      --rc-web-fetch-url string            آدرس URL برای دریافت انتشارها برای webgui (پیش‌فرض \[dq]https://api.github.com/repos/rclone/rclone-webui-react/releases/latest\[dq])
      --rc-web-gui                         راه‌اندازی WebGUI روی localhost
      --rc-web-gui-force-update            اجبار به به‌روزرسانی به آخرین نسخه web gui
      --rc-web-gui-no-open-browser         عدم باز کردن خودکار مرورگر
      --rc-web-gui-update                  بررسی و به‌روزرسانی به آخرین نسخه web gui
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone hashsum
.PP
یک فایل hashsum برای همه اشیاء موجود در مسیر تولید می‌کند.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
با استفاده از درهم‌ساز (hash) نام‌برده‌شده، یک فایل هش برای همه اشیاء موجود در مسیر تولید می‌کند.
خروجی در همان قالب ابزار استاندارد md5sum/sha1sum است.
.PP
به‌طور پیش‌فرض، هش از remote درخواست می‌شود.
اگر هش توسط remote پشتیبانی نشود، هیچ هشی بازگردانده نخواهد شد.
با پرچم download، فایل از remote بارگیری شده و به‌صورت محلی هش می‌شود که امکان استفاده از هر هشی را برای هر remote فراهم می‌کند.
.PP
برای الگوریتم‌های MD5 و SHA1 دستورهای اختصاصی نیز وجود دارد:
md5sum (https://rclone.org/commands/rclone_md5sum) و
sha1sum (https://rclone.org/commands/rclone_sha1sum).
.PP
این دستور همچنین می‌تواند داده‌های دریافت‌شده از ورودی استاندارد (stdin) را هش کند؛ با مشخص نکردن remote:path، یا با ارسال یک خط تیره به عنوان remote:path در زمانی که داده‌ای برای خواندن وجود دارد (اگر داده‌ای نباشد، خط تیره به‌صورت لفظی و به عنوان یک مسیر نسبی در نظر گرفته خواهد شد).
.PP
برای مشاهدهٔ فهرست تمام هش‌های پشتیبانی‌شده، آن را بدون هش اجرا کنید؛ مانند:
.IP
.nf
\f[C]
$ rclone hashsum
Supported hashes are:
- md5
- sha1
- whirlpool
- crc32
- sha256
- sha512
- blake3
- xxh3
- xxh128
\f[R]
.fi
.PP
سپس
.IP
.nf
\f[C]
rclone hashsum MD5 remote:path
\f[R]
.fi
.PP
توجه داشته باشید که نام‌های هش به حروف بزرگ و کوچک حساس نیستند و مقادیر با حروف کوچک خروجی داده می‌شوند.
.IP
.nf
\f[C]
rclone hashsum [<hash> remote:path] [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --base64               خروجی مجموع هش با کدگذاری base64
  -C, --checkfile string     اعتبارسنجی هش‌ها در برابر یک فایل SUM معین به جای چاپ آن‌ها
      --download             دانلود فایل و محاسبه هش محلی آن؛ اگر این پرچم مشخص نشود، هش از ریموت درخواست می‌شود
  -h, --help                 راهنمای hashsum
      --output-file string   ارسال خروجی هش‌ها به یک فایل به جای ترمینال
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای مشاهده گزینه‌های عمومی که در اینجا فهرست نشده‌اند، صفحه پرچم‌های عمومی (https://rclone.org/flags) را ببینید.
.SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌هایی برای فیلتر کردن فهرست‌بندی‌های دایرکتوری
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام فایل‌های مبدأ از یک فایل (استفاده از - برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از فایل بدون هیچ‌گونه پردازش خطوط (استفاده از - برای stdin)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ از فایل با جداکننده NUL (استفاده از - برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قاعده فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --hash-filter string                  افراز نام فایل‌ها با هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --max-age Duration                    انتقال فایل‌های جدیدتر از این مقدار برحسب s یا پسوندهای ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض 1-)
      --max-size SizeSuffix                 انتقال فایل‌های کوچک‌تر از این مقدار برحسب KiB یا پسوندهای B|K|M|G|T|P (پیش‌فرض غیرفعال)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (استفاده از - برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قاعده فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر متاداده از یک فایل (استفاده از - برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از فایل (استفاده از - برای خواندن از stdin)
      --min-age Duration                    انتقال فایل‌های قدیمی‌تر از این مقدار برحسب s یا پسوندهای ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --min-size SizeSuffix                 انتقال فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا پسوندهای B|K|M|G|T|P (پیش‌فرض غیرفعال)
\f[R]
.fi
.SS "گزینه‌های فهرست‌بندی (Listing Options)"
.PP
پرچم‌هایی برای فهرست کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست بازگشتی در صورت موجود بودن؛ مصرف حافظه بیشتر اما تراکنش‌های کمتر
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH "rclone link"
.PP
تولید پیوند عمومی به فایل/پوشه.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
ایجاد، بازیابی یا حذف پیوند عمومی برای فایل یا پوشه داده‌شده.
.IP
.nf
\f[C]
rclone link remote:path/to/file
rclone link remote:path/to/folder/
rclone link --unlink remote:path/to/folder/
rclone link --expire 1d remote:path/to/file
\f[R]
.fi
.PP
اگر پرچم \-\-expire را مشخص کنید، زمان انقضا را تعیین می‌کند؛ در غیر این صورت از مقدار پیش‌فرض (۱۰۰ سال) استفاده خواهد کرد.
\f[B]نکته\f[R] همه backendها از پرچم \-\-expire پشتیبانی نمی‌کنند \- اگر backend از آن پشتیبانی نکند، پیوند بازگردانده‌شده منقضی نخواهد شد.
.PP
برای حذف پیوندهای عمومی موجودِ فایل یا پوشه، از پرچم \-\-unlink استفاده کنید.
\f[B]نکته\f[R] همه backendها از پرچم \[dq]\-\-unlink\[dq] پشتیبانی نمی‌کنند \- مواردی که پشتیبانی نمی‌کنند صرفاً آن را نادیده می‌گیرند.
.PP
در صورت موفقیت، آخرین خط خروجی حاوی پیوند خواهد بود.
قابلیت‌های دقیق به ریموت بستگی دارد، اما پیوند به‌طور پیش‌فرض همواره با کمترین محدودیت‌ها ایجاد می‌شود \- برای مثال بدون انقضا، بدون محافظت با گذرواژه، و قابل دسترس بدون حساب کاربری.
.IP
.nf
\f[C]
rclone link remote:path [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --expire Duration   مدت زمانی که پیوند معتبر خواهد بود (پیش‌فرض غیرفعال)
  -h, --help              راهنمای link
      --unlink            حذف پیوند عمومی موجود به فایل/پوشه
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone listremotes
.PP
فهرست کردن تمام ریموت‌های موجود در فایل پیکربندی و متغیرهای محیطی تعریف‌شده.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
تمام ریموت‌های موجود در فایل پیکربندی یا ریموت‌های منطبق با یک فیلتر اختیاری را فهرست می‌کند.
.PP
به‌طور پیش‌فرض نتیجه را در قالبی خوانا برای انسان و به صورت فهرستی ساده از نام‌های ریموت چاپ می‌کند؛ یا اگر همراه با پرچم \f[V]--long\f[R] استفاده شود، در یک قالب جدول‌بندی‌شده شامل نام‌ها، نوع‌ها و توضیحات ریموت نمایش می‌دهد.
استفاده از پرچم \f[V]--json\f[R] در عوض خروجی ماشین‌خوان تولید می‌کند که همیشه شامل همه مشخصه‌ها \- از جمله منبع (فایل یا محیط) \- است.
.PP
نتیجه می‌تواند با یک آرگومان فیلتر که برای تمام مشخصه‌ها اعمال می‌شود، و/یا پرچم‌های فیلتر ویژهٔ هر مشخصه پالایش شود.
مقادیر باید مطابق با نحو الگوی پالایش معمول rclone مشخص شوند.
.PP
به‌طور پیش‌فرض، پالایش از تطبیق مهارنشده (non-anchored) استفاده می‌کند، بنابراین \f[V]--type box\f[R] با \f[V]dropbox\f[R] نیز تطابق دارد.
برای تطبیق صرفاً مقادیر کامل، از \f[V]--exact\f[R] استفاده کنید.
.IP
.nf
\f[C]
rclone listremotes [<filter>] [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --description string   پالایش ریموت‌ها بر اساس توضیحات
      --exact                تطبیق دقیق رشته‌های فیلتر به جای استفاده از تطبیق glob مهارنشده
  -h, --help                 راهنمای listremotes
      --json                 قالب‌بندی خروجی به صورت JSON
      --long                 نمایش نوع و توضیحات علاوه بر نام
      --name string          پالایش ریموت‌ها بر اساس نام
      --order-by string      دستورالعمل‌ها برای نحوه مرتب‌سازی نتیجه، مثلاً \[aq]type,name=descending\[aq]
      --source string        پالایش ریموت‌ها بر اساس منبع، مثلاً \[aq]file\[aq] یا \[aq]environment\[aq]
      --type string          پالایش ریموت‌ها بر اساس نوع
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone lsf
.PP
فهرست کردن دایرکتوری‌ها و اشیاء در remote:path با قالب مناسب برای تجزیه.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
محتویات مسیر مبدأ (دایرکتوری‌ها و اشیاء) را در قالبی که تجزیه آن توسط اسکریپت‌ها آسان باشد در خروجی استاندارد فهرست می‌کند.
به‌طور پیش‌فرض این خروجی فقط شامل نام‌های اشیاء و دایرکتوری‌ها خواهد بود، هر کدام در یک خط.
دایرکتوری‌ها دارای پسوند / خواهند بود.
.PP
برای نمونه:
.IP
.nf
\f[C]
$ rclone lsf swift:bucket
bevajer5jef
canole
diwogej7
ferejej3gux/
fubuwic
\f[R]
.fi
.PP
از گزینهٔ \f[V]--format\f[R] برای کنترل مواردی که فهرست می‌شوند استفاده کنید.
به‌طور پیش‌فرض این مقدار فقط مسیر است، اما می‌توانید از این پارامترها برای کنترل خروجی استفاده کنید:
.IP
.nf
\f[C]
p - مسیر (path)
s - اندازه (size)
t - زمان تغییر (modification time)
h - هش (hash)
i - شناسه شیء (ID)
o - شناسه اصلی شیء زیرین
m - نوع MimeType شیء در صورت مشخص بودن
e - نام رمزگذاری‌شده
T - لایه ذخیره‌سازی در صورت مشخص بودن، مثلاً \[dq]Hot\[dq] یا \[dq]Cool\[dq]
M - متادیتای شیء در قالب JSON blob، مثلاً {\[dq]key\[dq]:\[dq]value\[dq]}
\f[R]
.fi
.PP
برخی از backendها از شناسه‌های ترکیبی استفاده می‌کنند.
به‌ویژه میان‌برهای Google Drive معمولاً ارجاع‌زدایی می‌شوند و فیلد \[dq]i\[dq] آن‌ها شامل شناسه شیء هدف و به دنبال آن شناسه میان‌بر است که با یک tab از هم جدا شده‌اند.
این tab بخشی از فیلد شناسه است و با \f[V]--separator\f[R] تغییر نمی‌کند.
برای نادیده گرفتن مدخل‌های میان‌بر، از \f[V]--drive-skip-shortcuts\f[R] استفاده کنید.
.PP
بنابراین اگر مسیر، اندازه و زمان تغییر را می‌خواهید، از \f[V]--format \[dq]pst\[dq]\f[R] یا احتمالاً از \f[V]--format \[dq]tsp\[dq]\f[R] برای قرار دادن مسیر در انتها استفاده می‌کنید.
.PP
برای نمونه:
.IP
.nf
\f[C]
$ rclone lsf  --format \[dq]tsp\[dq] swift:bucket
2016-06-25 18:55:41;60295;bevajer5jef
2016-06-25 18:55:43;90613;canole
2016-06-25 18:55:43;94467;diwogej7
2018-04-26 08:50:45;0;ferejej3gux/
2016-06-25 18:55:40;37600;fubuwic
\f[R]
.fi
.PP
اگر در قالب از \[dq]h\[dq] استفاده کنید، به‌طور پیش‌فرض هش MD5 را دریافت خواهید کرد؛ برای تغییر نوع هش دلخواه از پرچم \f[V]--hash\f[R] استفاده کنید.
توجه داشته باشید که اگر هش روی شیء در دسترس نباشد (و برای دایرکتوری‌ها) ممکن است به صورت یک رشته خالی برگردانده شود، اگر خطایی در خواندن آن از شیء وجود داشته باشد مقدار \[dq]ERROR\[dq] و اگر آن شیء از آن نوع هش پشتیبانی نکند مقدار \[dq]UNSUPPORTED\[dq] بازگردانده می‌شود.
.PP
برای مثال، جهت شبیه‌سازی دستور md5sum می‌توانید از این دستور استفاده کنید:
.IP
.nf
\f[C]
rclone lsf -R --hash MD5 --format hp --separator \[dq]  \[dq] --files-only .
\f[R]
.fi
.PP
برای نمونه:
.IP
.nf
\f[C]
$ rclone lsf -R --hash MD5 --format hp --separator \[dq]  \[dq] --files-only swift:bucket
7908e352297f0f530b84a756f188baa3  bevajer5jef
cd65ac234e6fea5925974a51cdd865cc  canole
03b5341b4f234b9d984d03ad076bae91  diwogej7
8fd37c3810dd660778137ac3a66cc06d  fubuwic
99713e14a4c4ff553acaf1930fad985b  gixacuh7ku
\f[R]
.fi
.PP
(اگرچه دستور \[dq]rclone md5sum .\[dq] روش ساده‌تری برای نوشتن این کار است.)
.PP
به‌طور پیش‌فرض جداکننده \[dq];\[dq] است؛ این مقدار با پرچم \f[V]--separator\f[R] قابل تغییر است.
توجه داشته باشید که جداکننده‌ها در مسیر escape نمی‌شوند، بنابراین قرار دادن آن در آخر یک راهکار مناسب است.
.PP
برای نمونه:
.IP
.nf
\f[C]
$ rclone lsf  --separator \[dq],\[dq] --format \[dq]tshp\[dq] swift:bucket
2016-06-25 18:55:41,60295,7908e352297f0f530b84a756f188baa3,bevajer5jef
2016-06-25 18:55:43,90613,cd65ac234e6fea5925974a51cdd865cc,canole
2016-06-25 18:55:43,94467,03b5341b4f234b9d984d03ad076bae91,diwogej7
2018-04-26 08:52:53,0,,ferejej3gux/
2016-06-25 18:55:40,37600,8fd37c3810dd660778137ac3a66cc06d,fubuwic
\f[R]
.fi.PP
می‌توانید خروجی را در قالب استاندارد CSV تولید کنید.
این کار مواردی را که حاوی کاما (,) باشند، درون \[dq] گریزدهی (escape) می‌کند.
.PP
برای مثال:
.IP
.nf
\f[C]
$ rclone lsf --csv --files-only --format ps remote:path
test.log,22355
test.sh,449
\[dq]this file contains a comma, in the file name.txt\[dq],6
\f[R]
.fi
.PP
توجه داشته باشید که پارامتر \f[V]--absolute\f[R] برای ساخت فهرست‌هایی
از فایل‌ها جهت ارسال به rclone copy با پرچم \f[V]--files-from-raw\f[R]
مفید است.
.PP
برای مثال، برای یافتن تمام فایل‌های تغییریافته طی یک روز و کپی کردن
تنها همان فایل‌ها (بدون پیمایش کل ساختار دایرکتوری):
.IP
.nf
\f[C]
rclone lsf --absolute --files-only --max-age 1d /path/to/local > new_files
rclone copy --files-from-raw new_files /path/to/local remote:path
\f[R]
.fi
.PP
قالب زمانی پیش‌فرض \f[V]\[aq]2006-01-02 15:04:05\[aq]\f[R] است.
سایر قالب‌ها (https://pkg.go.dev/time#pkg-constants) را می‌توان با
پرچم \f[V]--time-format\f[R] مشخص کرد.
مثال‌ها:
.IP
.nf
\f[C]
rclone lsf remote:path --format pt --time-format \[aq]Jan 2, 2006 at 3:04pm (MST)\[aq]
rclone lsf remote:path --format pt --time-format \[aq]2006-01-02 15:04:05.000000000\[aq]
rclone lsf remote:path --format pt --time-format \[aq]2006-01-02T15:04:05.999999999Z07:00\[aq]
rclone lsf remote:path --format pt --time-format RFC3339
rclone lsf remote:path --format pt --time-format DateOnly
rclone lsf remote:path --format pt --time-format max
rclone lsf remote:path --format pt --time-format unix
rclone lsf remote:path --format pt --time-format unixnano
\f[R]
.fi
.PP
گزینهٔ \f[V]--time-format max\f[R] به‌طور خودکار
\f[V]2006-01-02 15:04:05.000000000\f[R] را به حداکثر دقت پشتیبانی‌شده
توسط ریموت کوتاه می‌کند.
.PP
هر یک از گزینه‌های فیلتر کردن را می‌توان بر روی این دستور اعمال کرد.
.PP
چندین دستور فهرست‌بندی مرتبط وجود دارد:
.IP \[bu] 2
\f[V]ls\f[R] تنها برای فهرست کردن اندازه و مسیر اشیاء
.IP \[bu] 2
\f[V]lsl\f[R] تنها برای فهرست کردن زمان تغییر، اندازه و مسیر اشیاء
.IP \[bu] 2
\f[V]lsd\f[R] تنها برای فهرست کردن دایرکتوری‌ها
.IP \[bu] 2
\f[V]lsf\f[R] برای فهرست کردن اشیاء و دایرکتوری‌ها در قالبی با تجزیهٔ آسان
.IP \[bu] 2
\f[V]lsjson\f[R] برای فهرست کردن اشیاء و دایرکتوری‌ها در قالب JSON
.PP
دستورهای \f[V]ls\f[R]، \f[V]lsl\f[R] و \f[V]lsd\f[R] به‌گونه‌ای
طراحی شده‌اند که برای انسان خوانا باشند.
\f[V]lsf\f[R] برای خوانایی هم‌زمان توسط انسان و ماشین طراحی شده است.
\f[V]lsjson\f[R] برای خوانایی توسط ماشین طراحی شده است.
.PP
توجه داشته باشید که \f[V]ls\f[R] و \f[V]lsl\f[R] به‌طور پیش‌فرض
بازگشتی عمل می‌کنند - از \f[V]--max-depth 1\f[R] برای متوقف کردن بازگشت استفاده کنید.
.PP
سایر دستورهای فهرست‌گیری مانند \f[V]lsd\f[R]، \f[V]lsf\f[R] و \f[V]lsjson\f[R] به‌طور
پیش‌فرض بازگشتی نیستند - از \f[V]-R\f[R] برای بازگشتی کردن آن‌ها استفاده کنید.
.PP
دستورهای فهرست‌گیری به‌طور پیش‌فرض روش بازگشتی را ترجیح می‌دهند که از حافظهٔ
بیشتر اما تراکنش‌های کمتری استفاده می‌کند.
برای غیرفعال کردن این رفتار از \f[V]--disable ListR\f[R] استفاده کنید.
برای جزئیات بیشتر \f[V]--fast-list\f[R] (https://rclone.org/docs/#fast-list)
را ببینید.
.PP
فهرست کردن یک دایرکتوری ناموجود منجر به بروز خطا می‌شود، مگر در ریموت‌هایی
که نمی‌توانند دایرکتوری خالی داشته باشند (مانند s3، swift یا gcs -
ریموت‌های مبتنی بر باکت).
.IP
.nf
\f[C]
rclone lsf remote:path [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --absolute             قرار دادن / در ابتدای نام‌های مسیر
      --csv                  خروجی در قالب CSV
  -d, --dir-slash            افزودن اسلش به انتهای نام‌های دایرکتوری (پیش‌فرض true)
      --dirs-only            فقط فهرست کردن دایرکتوری‌ها
      --files-only           فقط فهرست کردن فایل‌ها
  -F, --format string        قالب خروجی - برای جزئیات به راهنما مراجعه کنید (پیش‌فرض \[dq]p\[dq])
      --hash h               استفاده از این هش هنگامی که h در قالب استفاده می‌شود MD5|SHA-1|DropboxHash (پیش‌فرض \[dq]md5\[dq])
  -h, --help                 راهنمای lsf
  -R, --recursive            پیمایش بازگشتی در فهرست
  -s, --separator string     جداکننده برای موارد موجود در قالب (پیش‌فرض \[dq];\[dq])
  -t, --time-format string   مشخص کردن قالب زمانی سفارشی - برای جزئیات به مستندات مراجعه کنید (پیش‌فرض: 2006-01-02 15:04:05)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌هایی برای فیلتر کردن فهرست‌های دایرکتوری
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های روی مقصد که از همگام‌سازی استثنا شده‌اند
      --exclude stringArray                 استثنا کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (از - برای خواندن از stdin استفاده کنید)
      --exclude-if-present stringArray      استثنا کردن دایرکتوری‌ها در صورت وجود filename
      --files-from stringArray              خواندن فهرست نام‌های فایل منبع از فایل (از - برای خواندن از stdin استفاده کنید)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل منبع از فایل بدون هیچ‌گونه پردازش خطوط (از - برای خواندن از stdin استفاده کنید)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل منبع از فایل با استفاده از NUL به عنوان جداکننده (از - برای خواندن از stdin استفاده کنید)
  -f, --filter stringArray                  افزودن یک قانون فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (از - برای خواندن از stdin استفاده کنید)
      --hash-filter string                  افراز نام‌های فایل بر اساس هش k/n یا تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف کوچک و بزرگ)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (از - برای خواندن از stdin استفاده کنید)
      --max-age Duration                    انتقال تنها فایل‌های تازه‌تر از این مقدار بر حسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 انتقال تنها فایل‌های کوچک‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض off)
      --metadata-exclude stringArray        استثنا کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (از - برای خواندن از stdin استفاده کنید)
      --metadata-filter stringArray         افزودن یک قانون فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متاداده از یک فایل (از - برای خواندن از stdin استفاده کنید)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از فایل (از - برای خواندن از stdin استفاده کنید)
      --min-age Duration                    انتقال تنها فایل‌های قدیمی‌تر از این مقدار بر حسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --min-size SizeSuffix                 انتقال تنها فایل‌های بزرگ‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض off)
\f[R]
.fi
.SS "گزینه‌های فهرست‌بندی (Listing Options)"
.PP
پرچم‌هایی برای فهرست کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست بازگشتی در صورت موجود بودن؛ حافظه بیشتر اما تراکنش‌های کمتری مصرف می‌کند
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone lsjson
.PP
فهرست کردن دایرکتوری‌ها و اشیاء موجود در مسیر در قالب JSON.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
فهرست کردن دایرکتوری‌ها و اشیاء موجود در مسیر در قالب JSON.
.PP
خروجی آرایه‌ای از موردها (Items) است، که هر مورد به این صورت است:
.IP
.nf
\f[C]
{
  \[dq]Hashes\[dq] : {
    \[dq]SHA-1\[dq] : \[dq]f572d396fae9206628714fb2ce00f72e94f2258f\[dq],
    \[dq]MD5\[dq] : \[dq]b1946ac92492d2347c6235b4d2611184\[dq],
    \[dq]DropboxHash\[dq] : \[dq]ecb65bb98f9d905b70458986c39fcbad7715e5f2fcc3b1f07767d7c83e2438cc\[dq]
  },
  \[dq]ID\[dq]: \[dq]y2djkhiujf83u33\[dq],
  \[dq]OrigID\[dq]: \[dq]UYOJVTUW00Q1RzTDA\[dq],
  \[dq]IsBucket\[dq] : false,
  \[dq]IsDir\[dq] : false,
  \[dq]MimeType\[dq] : \[dq]application/octet-stream\[dq],
  \[dq]ModTime\[dq] : \[dq]2017-05-31T16:15:57.034468261+01:00\[dq],
  \[dq]Name\[dq] : \[dq]file.txt\[dq],
  \[dq]Encrypted\[dq] : \[dq]v0qpsdq8anpci8n929v3uu9338\[dq],
  \[dq]EncryptedPath\[dq] : \[dq]kja9098349023498/v0qpsdq8anpci8n929v3uu9338\[dq],
  \[dq]Path\[dq] : \[dq]full/path/goes/here/file.txt\[dq],
  \[dq]Size\[dq] : 6,
  \[dq]Tier\[dq] : \[dq]hot\[dq],
}
\f[R]
.fi
.PP
مجموعهٔ دقیق ویژگی‌های گنجانده‌شده به backend بستگی دارد:
.IP \[bu] 2
ویژگی IsBucket فقط برای ریموت‌های مبتنی بر باکت و تنها برای دایرکتوری‌هایی که باکت هستند گنجانده می‌شود.
این ویژگی در صورتی که مقدار آن true نباشد همیشه حذف خواهد شد.
.IP \[bu] 2
ویژگی‌های Encrypted و EncryptedPath فقط برای ریموت‌های رمزگذاری‌شده و (همان‌طور که در زیر اشاره شده) تنها در صورت تنظیم گزینهٔ
\f[V]--encrypted\f[R] گنجانده می‌شوند.
.PP
گزینه‌های مختلف ممکن است بر اینکه کدام ویژگی‌ها گنجانده شوند نیز تأثیر بگذارند:
.IP \[bu] 2
اگر \f[V]--hash\f[R] مشخص نشده باشد، ویژگی Hashes حذف خواهد شد.
انواع هش را می‌توان با پارامتر \f[V]--hash-type\f[R] مشخص کرد (که ممکن است تکرار شود).
تنظیم \f[V]--hash-type\f[R] به معنی فعال شدن ضمنی \f[V]--hash\f[R] است.
.IP \[bu] 2
اگر \f[V]--no-modtime\f[R] مشخص شود، ویژگی ModTime خالی خواهد بود.
این کار می‌تواند در ریموت‌هایی که خواندن ModTime در آن‌ها نیازمند یک درخواست اضافی است (مانند
s3، swift) به کارها سرعت ببخشد.
.IP \[bu] 2
اگر \f[V]--no-mimetype\f[R] مشخص شود، ویژگی MimeType خالی خواهد بود.
این کار می‌تواند در ریموت‌هایی که خواندن MimeType در آن‌ها نیازمند یک درخواست اضافی است (مانند
s3، swift) به کارها سرعت ببخشد.
.IP \[bu] 2
اگر \f[V]--encrypted\f[R] مشخص نشود، ویژگی‌های Encrypted و
EncryptedPath حذف خواهند شد \- حتی برای ریموت‌های رمزگذاری‌شده.
.IP \[bu] 2
اگر \f[V]--metadata\f[R] تنظیم شود، یک ویژگی اضافی Metadata برگردانده
خواهد شد.
این ویژگی حاوی متاداده (https://rclone.org/docs/#metadata) در قالب استاندارد rclone به صورت یک شیء JSON خواهد بود.
.PP
حالت پیش‌فرض، فهرست کردن دایرکتوری‌ها و فایل‌ها/اشیاء است، اما این رفتار را می‌توان با گزینه‌های زیر تغییر داد:
.IP \[bu] 2
اگر \f[V]--dirs-only\f[R] مشخص شود، تنها دایرکتوری‌ها برگردانده خواهند شد،
نه فایل‌ها/اشیاء.
.IP \[bu] 2
اگر \f[V]--files-only\f[R] مشخص شود، تنها فایل‌ها برگردانده خواهند شد،
نه دایرکتوری‌ها.
.PP
اگر \f[V]--stat\f[R] تنظیم شود، خروجی آرایه‌ای از موارد نخواهد بود، بلکه در عوض یک تک‌بلوک JSON دربارهٔ موردی که به آن اشاره شده برگردانده می‌شود.
این حالت در صورتی که مورد یافت نشود خطایی برمی‌گرداند؛ با این حال در backendهای مبتنی بر باکت (مانند s3، gcs، b2، azureblob و غیره) در صورت پیدا نشدن مورد، یک دایرکتوری خالی برمی‌گرداند، چرا که در آنجا تشخیص دایرکتوری‌های خالی از دایرکتوری‌های ناموجود امکان‌پذیر نیست.
.PP
فیلد Path تنها پوشه‌های زیر مسیر ریموتِ در حال فهرست شدن را نمایش می‌دهد.
اگر \[dq]remote:path\[dq] حاوی فایل \[dq]subfolder/file.txt\[dq] باشد، مقدار Path برای \[dq]file.txt\[dq] برابر با \[dq]subfolder/file.txt\[dq] خواهد بود، نه \[dq]remote:path/subfolder/file.txt\[dq].
هنگام استفاده بدون \f[V]--recursive\f[R] مقدار Path همواره با Name یکسان خواهد بود.
.PP
زمان در قالب RFC3339 با دقت حداکثر تا نانوثانیه است.
تعداد ارقام اعشاری در ثانیه‌ها به دقتی که ریموت می‌تواند زمان‌ها را نگه‌داری کند بستگی دارد؛ بنابراین اگر زمان‌ها تا نزدیک‌ترین میلی‌ثانیه دقیق باشند (مانند
Google Drive) همیشه ۳ رقم نمایش داده می‌شود
(\[dq]2017-05-31T16:15:57.034+01:00\[dq])، در حالی که اگر زمان‌ها تا نزدیک‌ترین ثانیه دقیق باشند (Dropbox، Box، WebDav و غیره)
هیچ رقمی نمایش داده نخواهد شد (\[dq]2017-05-31T16:15:57+01:00\[dq]).
.PP
کل خروجی را می‌توان به عنوان یک بلوک JSON پردازش کرد، یا متناوباً می‌توان آن را خط به خط پردازش نمود زیرا هر مورد در خطوط جداگانه نوشته می‌شود (به جز در صورت استفاده از \f[V]--stat\f[R]).
.PP
هر یک از گزینه‌های فیلتر کردن را می‌توان بر این دستور اعمال کرد.
.PP
چندین دستور فهرست‌بندی مرتبط دیگر نیز وجود دارد:
.IP \[bu] 2
دستور \f[V]ls\f[R] تنها برای فهرست کردن اندازه و مسیر اشیاء
.IP \[bu] 2
دستور \f[V]lsl\f[R] تنها برای فهرست کردن زمان تغییر، اندازه و مسیر اشیاء.IP \[bu] 2
\f[V]lsd\f[R] فقط برای فهرست کردن دایرکتوری‌ها
.IP \[bu] 2
\f[V]lsf\f[R] برای فهرست کردن اشیاء و دایرکتوری‌ها در قالبی با تجزیه آسان
.IP \[bu] 2
\f[V]lsjson\f[R] برای فهرست کردن اشیاء و دایرکتوری‌ها در قالب JSON
.PP
دستورهای \f[V]ls\f[R]، \f[V]lsl\f[R] و \f[V]lsd\f[R] به گونه‌ای طراحی شده‌اند که برای انسان خوانا باشند.
دستور \f[V]lsf\f[R] برای خوانایی هم توسط انسان و هم توسط ماشین طراحی شده است.
دستور \f[V]lsjson\f[R] به گونه‌ای طراحی شده است که برای ماشین خوانا باشد.
.PP
توجه داشته باشید که \f[V]ls\f[R] و \f[V]lsl\f[R] به‌طور پیش‌فرض به‌صورت بازگشتی عمل می‌کنند \- برای متوقف کردن پیمایش بازگشتی از \f[V]--max-depth 1\f[R] استفاده کنید.
.PP
سایر دستورهای فهرست‌گیری شامل \f[V]lsd\f[R]، \f[V]lsf\f[R] و \f[V]lsjson\f[R] به‌طور پیش‌فرض بازگشتی نیستند \- برای بازگشتی کردن آن‌ها از \f[V]-R\f[R] استفاده کنید.
.PP
دستورهای فهرست‌گیری به‌طور پیش‌فرض روشی بازگشتی را ترجیح می‌دهند که حافظه بیشتری مصرف می‌کند اما تراکنش‌های کمتری دارد.
برای غیرفعال کردن این رفتار از \f[V]--disable ListR\f[R] استفاده کنید.
برای جزئیات بیشتر به \f[V]--fast-list\f[R] (https://rclone.org/docs/#fast-list) مراجعه کنید.
.PP
فهرست کردن یک دایرکتوری ناموجود منجر به خطا خواهد شد، به جز در ریموت‌هایی که نمی‌توانند دایرکتوری خالی داشته باشند (مانند s3، swift یا gcs \- ریموت‌های مبتنی بر باکت).
.IP
.nf
\f[C]
rclone lsjson remote:path [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --dirs-only               نمایش تنها دایرکتوری‌ها در فهرست
      --encrypted               نمایش نام‌های رمزگذاری‌شده
      --files-only              نمایش تنها فایل‌ها در فهرست
      --hash                    گنجاندن هش‌ها در خروجی (ممکن است زمان بیشتری ببرد)
      --hash-type stringArray   نمایش تنها این نوع هش (می‌تواند تکرار شود)
  -h, --help                    راهنمای lsjson
  -M, --metadata                افزودن متادیتا به فهرست
      --no-mimetype             عدم خواندن نوع mime (می‌تواند سرعت را افزایش دهد)
      --no-modtime              عدم خواندن زمان تغییر (می‌تواند سرعت را افزایش دهد)
      --original                نمایش شناسه (ID) شیء زیرین
  -R, --recursive               پیمایش بازگشتی در فهرست
      --stat                    فقط بازگرداندن اطلاعات فایل مورد اشاره
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای مشاهده گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌ها برای فیلتر کردن فهرست‌های دایرکتوری
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از - برای stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام فایل‌های مبدأ از فایل (استفاده از - برای stdin)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از فایل بدون پردازش خطوط (استفاده از - برای stdin)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ از فایل با جداکننده NUL (استفاده از - برای stdin)
  -f, --filter stringArray                  افزودن یک قانون فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از فایل (استفاده از - برای stdin)
      --hash-filter string                  افرازبندی نام‌فایل‌ها با هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از - برای stdin)
      --max-age Duration                    فقط انتقال فایل‌های جدیدتر از این مقدار به ثانیه یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را محدود می‌کند (پیش‌فرض \-1)
      --max-size SizeSuffix                 فقط انتقال فایل‌های کوچک‌تر از این مقدار به KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنی کردن متادیتای منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متادیتا از فایل (استفاده از - برای stdin)
      --metadata-filter stringArray         افزودن یک قانون فیلتر کردن متادیتا
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متادیتا از فایل (استفاده از - برای stdin)
      --metadata-include stringArray        شامل کردن متادیتای منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متادیتا از فایل (استفاده از - برای stdin)
      --min-age Duration                    فقط انتقال فایل‌های قدیمی‌تر از این مقدار به ثانیه یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 فقط انتقال فایل‌های بزرگ‌تر از این مقدار به KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi.SS "گزینه‌های فهرست‌بندی (Listing Options)"
.PP
پرچم‌ها برای فهرست‌کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت در دسترس بودن؛ مصرف حافظه بیشتر اما تراکنش‌های کمتر
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورات، پرچم‌ها و backendهای rclone.
.SH "rclone mount"
.PP
سوار کردن (mount) ریموت به‌عنوان سیستم‌فایل بر روی یک نقطه اتصال (mountpoint).
.SS "خلاصه دستور (SYNOPSIS)"
.PP
دستور Rclone mount به سیستم‌عامل‌های Linux، FreeBSD، macOS و Windows امکان می‌دهد تا هر یک از سیستم‌های ذخیره‌سازی ابری Rclone را با استفاده از FUSE به‌عنوان یک سیستم‌فایل سوار (mount) کنند.
.PP
ابتدا ریموت خود را با استفاده از \f[V]rclone config\f[R] پیکربندی کنید.
با دستوراتی مانند \f[V]rclone ls\f[R] و غیره بررسی کنید که به‌درستی کار می‌کند.
.PP
در Linux و macOS، می‌توانید mount را در هر دو حالت پیش‌زمینه (foreground) یا پس‌زمینه (background یا دیمن) اجرا کنید.
دستور mount به‌طور پیش‌فرض در حالت پیش‌زمینه اجرا می‌شود.
برای اجبار به اجرا در حالت پس‌زمینه، از پرچم \f[V]--daemon\f[R] استفاده کنید.
در Windows اجرای mount فقط در حالت پیش‌زمینه امکان‌پذیر است و این پرچم نادیده گرفته می‌شود.
.PP
در حالت پس‌زمینه، rclone مانند یک برنامه استاندارد mount در یونیکس عمل می‌کند: برنامه اصلی آغاز به کار کرده، یک فرایند پس‌زمینه rclone را برای برپایی و نگهداری نقطه اتصال ایجاد (spawn) می‌کند، تا زمان موفقیت یا اتمام مهلت زمانی (timeout) منتظر می‌ماند و با کد خروج مناسب پایان می‌یابد (در صورت شکست، فرایند فرزند را متوقف می‌کند).
.PP
در Linux/macOS/FreeBSD عملیات سوار کردن را به این صورت آغاز کنید، که در آن
\f[V]/path/to/local/mount\f[R] یک دایرکتوری \f[B]خالی\f[R] و \f[B]موجود\f[R]
است:
.IP
.nf
\f[C]
rclone mount remote:path/to/files /path/to/local/mount
\f[R]
.fi
.PP
در Windows می‌توانید عملیات سوار کردن را به روش‌های مختلفی آغاز کنید.
برای جزئیات به بخش زیر مراجعه کنید.
اگر سوار کردن در حالت پیش‌زمینه به‌صورت تعاملی از یک پنجره کنسول اجرا شود، rclone نقطه اتصال را مدیریت کرده و کنسول را اشغال می‌کند؛ بنابراین تا زمانی که rclone متوقف شود (مثلاً با فشردن Ctrl-C)، باید از پنجره دیگری برای کار با نقطه اتصال استفاده شود.
.PP
مثال‌های زیر نقطه اتصال را به یک درایو با تخصیص خودکار، به یک درایو مشخص با شناسه \f[V]X:\f[R]، به مسیر
\f[V]C:\[rs]path\[rs]parent\[rs]mount\f[R] (جایی که درایو یا دایرکتوری والد باید وجود داشته باشد و دایرکتوری mount \f[B]نباید\f[R] از قبل وجود داشته باشد، و هنگام سوار کردن به‌عنوان یک درایو شبکه پشتیبانی نمی‌شود)، و آخرین مثال آن را به‌عنوان یک اشتراک شبکه \f[V]\[rs]\[rs]cloud\[rs]remote\f[R] سوار کرده و به یک درایو با تخصیص خودکار نگاشت می‌کند:
.IP
.nf
\f[C]
rclone mount remote:path/to/files *
rclone mount remote:path/to/files X:
rclone mount remote:path/to/files C:\[rs]path\[rs]parent\[rs]mount
rclone mount remote:path/to/files \[rs]\[rs]cloud\[rs]remote
\f[R]
.fi
.PP
هنگامی که برنامه در حالت پیش‌زمینه پایان می‌یابد، چه از طریق Ctrl+C یا با دریافت سیگنال SIGINT یا SIGTERM، نقطه اتصال باید به‌طور خودکار متوقف شود.
.PP
هنگام اجرا در حالت پس‌زمینه، کاربر باید نقطه اتصال را به‌صورت دستی متوقف کند:
.IP
.nf
\f[C]
# Linux
fusermount -u /path/to/local/mount
#... or on some systems
fusermount3 -u /path/to/local/mount
# OS X or Linux when using nfsmount
umount /path/to/local/mount
\f[R]
.fi
.PP
عملیات umount ممکن است با شکست مواجه شود، برای مثال زمانی که نقطه اتصال مشغول (busy) باشد.
در این شرایط، مسئولیت متوقف کردن دستی نقطه اتصال بر عهده کاربر است.
.PP
اندازه سیستم‌فایل سوارشده بر اساس اطلاعات دریافت‌شده از ریموت تنظیم خواهد شد، همانند اطلاعاتی که توسط دستور
rclone about (https://rclone.org/commands/rclone_about) بازگردانده می‌شود.
ریموت‌های دارای فضای نامحدود ممکن است فقط اندازه مصرف‌شده را گزارش دهند؛ در این صورت فرض می‌شود که 1 PiB فضای خالی اضافه وجود دارد.
اگر ریموت اصلاً از ویژگی about
پشتیبانی (https://rclone.org/overview/#optional-features) نکند، مقدار 1 PiB هم به‌عنوان اندازه کل و هم به‌عنوان فضای خالی در نظر گرفته می‌شود..SS نصب در ویندوز (Installing on Windows)
.PP
برای اجرای \f[V]rclone mount on Windows\f[R]، باید WinFsp (<https://winfsp.dev>) را بارگیری و نصب کنید.
.PP
ابزار WinFsp (<https://github.com/winfsp/winfsp>) یک پروکسی سیستم فایل متن‌باز برای ویندوز (Windows File System Proxy) است که پیاده‌سازی سیستم‌های فایل در فضای کاربری (user space) را برای ویندوز آسان می‌کند.
این ابزار یک لایه شبیه‌ساز FUSE ارائه می‌دهد که rclone در ترکیب با cgofuse (<https://github.com/winfsp/cgofuse>) از آن استفاده می‌کند.
هر دوی این بسته‌ها توسط Bill Zissimopoulos توسعه یافته‌اند که در طول پیاده‌سازی rclone mount برای ویندوز بسیار یاری‌رسان بود.
.SS حالت‌های سوار کردن در ویندوز (Mounting modes on windows)
.PP
برخلاف سایر سیستم‌عامل‌ها، Microsoft Windows نوع سیستم فایل متفاوتی را برای درایوهای شبکه و درایوهای دیسک ثابت (fixed) ارائه می‌دهد.
ویندوز دسترسی را با این فرض بهینه‌سازی می‌کند که درایوهای دیسک ثابت سریع و قابل اطمینان هستند، در حالی که درایوهای شبکه تاخیر نسبتاً بالا و قابلیت اطمینان کمتری دارند.
برخی تنظیمات نیز می‌توانند بین این دو نوع متفاوت باشند؛ برای مثال، اینکه Windows Explorer در درایوهای شبکه تنها آیکون‌ها را نمایش دهد و برای فایل‌های ویدیویی و تصویری بندانگشتی (thumbnail) پیش‌نمایش تولید نکند.
.PP
در بیشتر موارد، rclone به‌طور پیش‌فرض ریموت را به عنوان یک درایو دیسک ثابت معمولی سوار (mount) می‌کند.
با این حال، می‌توانید آن را به عنوان یک درایو شبکه ریموت، که اغلب به عنوان یک اشتراک شبکه (network share) توصیف می‌شود نیز سوار کنید.
اگر یک ریموت rclone را با استفاده از حالت پیش‌فرض (درایو ثابت) سوار کردید و با خطاهای غیرمنتظره برنامه، هنگ کردن یا سایر مشکلات مواجه شدید، سوار کردن آن به عنوان درایو شبکه را مد نظر قرار دهید.
.PP
هنگام سوار کردن به عنوان درایو دیسک ثابت، می‌توانید آن را روی یک حرف درایو (drive letter) بلااستفاده، یا روی مسیری که نشان‌دهنده یک زیرشاخه \f[B]ناموجود\f[R] از یک پوشه یا درایو مادرِ \f[B]موجود\f[R] است، سوار کنید.
استفاده از مقدار ویژه \f[V]*\f[R] به rclone اعلام می‌کند که اولین حرف درایو در دسترس را به‌طور خودکار و با شروع از :Z به سمت عقب اختصاص دهد.
مثال‌ها:
.IP
.nf
\f[C]
rclone mount remote:path/to/files *
rclone mount remote:path/to/files X:
rclone mount remote:path/to/files C:\[rs]path\[rs]parent\[rs]mount
rclone mount remote:path/to/files X:
\f[R]
.fi
.PP
گزینه \f[V]--volname\f[R] می‌تواند برای تنظیم یک نام حجم (volume name) سفارشی برای سیستم فایل سوارشده استفاده شود.
حالت پیش‌فرض، استفاده از نام و مسیر ریموت است.
.PP
برای سوار کردن به عنوان درایو شبکه، می‌توانید گزینه \f[V]--network-mode\f[R] را به دستور mount خود اضافه کنید.
سوار کردن روی مسیر یک پوشه در این حالت پشتیبانی نمی‌شود، این محدودیتی است که ویندوز روی junctionها اعمال می‌کند، بنابراین ریموت همیشه باید روی یک حرف درایو سوار شود.
.IP
.nf
\f[C]
rclone mount remote:path/to/files X: --network-mode
\f[R]
.fi
.PP
نام حجمی که با \f[V]--volname\f[R] مشخص می‌شود، برای ایجاد مسیر اشتراک شبکه استفاده خواهد شد.
یک مسیر کامل UNC، مانند \f[V]\[rs]\[rs]cloud\[rs]remote\f[R]، و در صورت نیاز همراه با مسیر
\f[V]\[rs]\[rs]cloud\[rs]remote\[rs]madeup\[rs]path\f[R]، دقیقاً به همان صورت استفاده خواهد شد.
هر رشته دیگری پس از پیشوند پیش‌فرض \f[V]\[rs]\[rs]server\[rs]\f[R] به عنوان بخش اشتراک (share part) به کار خواهد رفت.
اگر هیچ نام حجمی مشخص نشود، از \f[V]\[rs]\[rs]server\[rs]share\f[R] استفاده می‌شود.
هنگام سوار کردن بیش از یک درایو، باید اطمینان حاصل کنید که نام حجم یکتا است، در غیر این صورت دستور mount شکست خواهد خورد.
نام اشتراک به عنوان برچسب حجم (volume label) برای درایو نگاشت‌شده در نظر گرفته می‌شود و در Windows Explorer و غیره نمایش می‌یابد، در حالی که مسیر کامل
\f[V]\[rs]\[rs]server\[rs]share\f[R] توسط \f[V]net use\f[R] و موارد مشابه به عنوان مسیر ریموت UNC گزارش خواهد شد؛ درست مانند نگاشت یک درایو شبکه معمولی.
.PP
اگر یک مسیر کامل UNC اشتراک شبکه را با \f[V]--volname\f[R] مشخص کنید، این کار به‌طور ضمنی گزینه \f[V]--network-mode\f[R] را فعال می‌کند، بنابراین دو مثال زیر نتیجه یکسانی خواهند داشت:
.IP
.nf
\f[C]
rclone mount remote:path/to/files X: --network-mode
rclone mount remote:path/to/files X: --volname \[rs]\[rs]server\[rs]share
\f[R]
.fi
.PP
همچنین می‌توانید مسیر UNC اشتراک شبکه را به عنوان خودِ نقطه اتصال (mountpoint) تعیین کنید.
در این حالت rclone دقیقاً مشابه \f[V]*\f[R] به‌طور خودکار یک حرف درایو را به عنوان نقطه اتصال اختصاص می‌دهد و از مسیر UNC مشخص‌شده به عنوان نام حجم استفاده می‌کند، درست مانند اینکه با گزینه \f[V]--volname\f[R] مشخص شده باشد.
این کار نیز به‌طور ضمنی گزینه \f[V]--network-mode\f[R] را فعال خواهد کرد.
این بدان معناست که دو مثال زیر نتیجه یکسانی دارند:
.IP
.nf
\f[C]
rclone mount remote:path/to/files \[rs]\[rs]cloud\[rs]remote
rclone mount remote:path/to/files * --volname \[rs]\[rs]cloud\[rs]remote
\f[R]
.fi
.PP
روش دیگری نیز برای فعال کردن حالت شبکه و تنظیم مسیر اشتراک وجود دارد که از طریق ارسال مستقیم گزینه «بومی» libfuse/WinFsp انجام می‌شود: \f[V]--fuse-flag --VolumePrefix=\[rs]server\[rs]share\f[R].
توجه داشته باشید که در این حالت مسیر باید تنها با پیشوند یک بک‌اسلش تکی باشد.
.PP
\f[I]نکته:\f[R] در نسخه‌های پیشین rclone این تنها روش پشتیبانی‌شده بود.
.PP
اطلاعات بیشتر درباره نگاشت درایو (Drive mapping) را در (<https://en.wikipedia.org/wiki/Drive_mapping>) مطالعه کنید.
.PP
همچنین بخش «محدودیت‌ها» (Limitations) در ادامه را ببینید..SS مجوزهای سیستم‌فایل Windows
.PP
لایه شبیه‌ساز FUSE در Windows باید بین مدل مجوز مبتنی بر POSIX مورد استفاده در FUSE و مدل مجوز مورد استفاده در Windows که مبتنی بر فهرست‌های کنترل دسترسی (ACL) است، تبدیل انجام دهد.
.PP
سیستم‌فایل سوارشده به‌طور معمول سه مدخل در فهرست کنترل دسترسی (ACL) خود دریافت می‌کند که نشان‌دهنده مجوزها برای محدوده‌های مجوز POSIX هستند: مالک (Owner)، گروه (group) و دیگران (others).
به‌طور پیش‌فرض، مالک و گروه از کاربر جاری گرفته می‌شوند و گروه توکار \[dq]Everyone\[dq] برای نمایش دیگران استفاده می‌شود.
کاربر/گروه را می‌توان با گزینه‌های FUSE یعنی \[dq]UserName\[dq] و \[dq]GroupName\[dq] سفارشی کرد، برای مثال:
\f[V]-o UserName=user123 -o GroupName=\[dq]Authenticated Users\[dq]\f[R].
مجوزهای هر مدخل بر اساس گزینه‌های \f[V]--dir-perms\f[R] و \f[V]--file-perms\f[R] تنظیم خواهند شد که مقداری را در نشانه‌گذاری عددی سنتی Unix دریافت می‌کنند (https://en.wikipedia.org/wiki/File-system_permissions#Numeric_notation).
.PP
مجوزهای پیش‌فرض متناظر با
\f[V]--file-perms 0666 --dir-perms 0777\f[R] هستند، یعنی
مجوز خواندن و نوشتن برای همگان (everyone).
این بدان معناست که شما قادر به اجرای هیچ برنامه‌ای از مسیر سوارشده نخواهید بود.
برای انجام این کار باید مجوزهای اجرا را اضافه کنید، برای مثال
\f[V]--file-perms 0777 --dir-perms 0777\f[R] برای افزودن آن به همگان.
اگر برنامه نیاز به نوشتن فایل‌ها داشته باشد، به احتمال زیاد باید VFS File Caching را نیز فعال کنید (همچنین بخش محدودیت‌ها را ببینید).
توجه داشته باشید که مجوز نوشتن پیش‌فرض برای حساب‌هایی غیر از مالک محدودیت‌هایی دارد؛ به‌ویژه فاقد مجوز \[dq]write extended attributes\[dq] است، همان‌طور که در ادامه توضیح داده می‌شود.
.PP
نگاشت مجوزها همیشه بدیهی نیست و نتیجه‌ای که در Windows Explorer می‌بینید ممکن است دقیقاً همان چیزی نباشد که انتظار داشتید.
برای نمونه، هنگام تنظیم مقداری که شامل دسترسی نوشتن برای محدوده گروه یا دیگران است، این مقدار به مجوزهای جداگانه
\[dq]write attributes\[dq]،‏ \[dq]write data\[dq] و \[dq]append data\[dq] نگاشت می‌شود، اما شامل \[dq]write extended attributes\[dq] نخواهد بود.
سپس Windows این مورد را به جای مجوز پایه \[dq]Write\[dq]، به عنوان مجوز \[dq]Special\[dq] نشان می‌دهد، چرا که \[dq]Write\[dq] مجوز \[dq]write extended attributes\[dq] را نیز پوشش می‌دهد.
هنگام تنظیم رقم 0 برای گروه یا دیگران به منظور نشان دادن عدم دسترسی، آن‌ها همچنان مجوزهای جداگانه \[dq]read attributes\[dq]،‏ \[dq]read extended attributes\[dq] و \[dq]read permissions\[dq] را دریافت خواهند کرد.
این کار به دلایل سازگاری انجام می‌شود، مثلاً
برای اینکه به کاربران بدون مجوزهای اضافی اجازه دهد بتوانند مانند Unix فراداده‌های پایه فایل‌ها را بخوانند.
.PP
ابزار WinFsp 2021 (نسخه 1.9) گزینه جدید FUSE به نام
\[dq]FileSecurity\[dq] را معرفی کرد که امکان مشخص کردن کامل توصیف‌گرهای امنیت فایل را با استفاده از
SDDL (https://docs.microsoft.com/en-us/windows/win32/secauthz/security-descriptor-string-format) فراهم می‌کند.
با این گزینه، در مقایسه با استفاده از مجوزهای POSIX شرح داده‌شده در بالا، کنترل دقیقی روی مجوزهای حاصل به دست می‌آورید و هیچ مجوز اضافی به‌طور خودکار برای سازگاری با Unix اضافه نخواهد شد.
چند مورد کاربرد نمونه در ادامه می‌آید.
.PP
اگر مجوزهای POSIX را فقط برای اجازه دسترسی به مالک با استفاده از
\f[V]--file-perms 0600 --dir-perms 0700\f[R] تنظیم کنید، به گروه کاربری و گروه توکار \[dq]Everyone\[dq] همچنان برخی مجوزهای ویژه، همان‌طور که در بالا توضیح داده شد، داده خواهد شد.
سپس برخی از برنامه‌ها ممکن است این را (به‌اشتباه) به این صورت تفسیر کنند که فایل برای همه قابل دسترسی است؛ برای نمونه یک کلاینت SSH ممکن است درباره \[dq]unprotected private key file\[dq] هشدار دهد.
می‌توانید با مشخص کردن
\f[V]-o FileSecurity=\[dq]D:P(A;;FA;;;OW)\[dq]\f[R] این مشکل را دور بزنید، که دسترسی کامل به فایل (FA) را فقط برای مالک (OW) تنظیم می‌کند و نه هیچ چیز دیگر.
.PP
همچنین هنگام تنظیم مجوزهای نوشتن، به جز برای مالک، همان‌طور که در بالا ذکر شد، این شامل مجوز \[dq]write extended attributes\[dq] نمی‌شود.
این امر ممکن است برنامه‌ها را از نوشتن روی فایل‌ها باز دارد و به جای آن خطای permission denied بدهد.
برای تنظیم مجوزهای نوشتن کارآمد برای گروه توکار \[dq]Everyone\[dq]، مشابه آنچه به‌طور پیش‌فرض دریافت می‌کند اما با اضافه شدن \[dq]write extended attributes\[dq]، می‌توانید
\f[V]-o FileSecurity=\[dq]D:P(A;;FRFW;;;WD)\[dq]\f[R] را مشخص کنید که خواندن فایل (FR) و نوشتن فایل (FW) را برای همگان (WD) تنظیم می‌کند.
اگر به اجرای فایل (FX) نیز نیاز است، آن را به
\f[V]-o FileSecurity=\[dq]D:P(A;;FRFWFX;;;WD)\[dq]\f[R] تغییر دهید، یا دسترسی کامل به فایل (FA) را تنظیم کنید تا با
\f[V]-o FileSecurity=\[dq]D:P(A;;FA;;;WD)\[dq]\f[R] به مجوزهای دسترسی کامل، از جمله حذف، دست یابید..SS هشدارهای ویندوز (Windows caveats)
.PP
درایوهایی که با دسترسی Administrator ایجاد می‌شوند برای سایر حساب‌ها قابل مشاهده نیستند، حتی حسابی که با ویژگی کنترل حساب کاربری (UAC) به Administrator ارتقا یافته باشد.
نتیجه این امر آن است که اگر از طریق یک Command Prompt که به عنوان Administrator اجرا شده است به یک حرف درایو متصل شوید (mount کنید)، و سپس تلاش کنید از طریق Windows Explorer (که به صورت Administrator اجرا نمی‌شود) به همان درایو دسترسی داشته باشید، درایو سوار شده را نخواهید دید.
.PP
اگر نیازی به دسترسی به درایو از طریق برنامه‌هایی که با دسترسی‌های مدیریتی اجرا می‌شوند ندارید، ساده‌ترین راه برای رفع این مشکل این است که عمل سوار کردن (mount) را همیشه از طریق یک خط فرمان غیرارتقایافته (non-elevated) انجام دهید.
.PP
برای اینکه درایوهای نگاشت‌شده بدون توجه به ارتقایافته بودن یا نبودن، برای حساب کاربری ایجادکننده آن‌ها در دسترس باشند، تنظیم ویژه‌ای در ویندوز موسوم به
linked connections (https://docs.microsoft.com/en-us/troubleshoot/windows-client/networking/mapped-drives-not-available-from-elevated-command#detail-to-configure-the-enablelinkedconnections-registry-entry)
وجود دارد که می‌توان آن را فعال کرد.
.PP
همچنین می‌توان با اجرای فرایند ایجادکننده به عنوان حساب داخلی SYSTEM، درایو سوار شده را در دسترس همه افراد در سیستم قرار داد.
چندین راه برای انجام این کار وجود دارد: یکی استفاده از ابزار خط فرمانی
PsExec (https://docs.microsoft.com/en-us/sysinternals/downloads/psexec)
از مجموعه Sysinternals مایکروسافت است که گزینه \f[V]-s\f[R] را برای راه‌اندازی فرایندها به عنوان حساب SYSTEM دارد.
گزینه دیگر، اجرای دستور mount از طریق یک Windows Scheduled Task یا یک Windows Service است که برای اجرا به عنوان حساب SYSTEM پیکربندی شده باشد.
روش سوم، استفاده از زیرساخت
WinFsp.Launcher (https://github.com/winfsp/winfsp/wiki/WinFsp-Service-Architecture)
است. اطلاعات بیشتر را در مستندات نصب (https://rclone.org/install) مطالعه کنید.
توجه داشته باشید که هنگام اجرای rclone به عنوان کاربری دیگر، از فایل پیکربندی نمایه (پروفایل) شما استفاده نخواهد شد مگر اینکه با گزینه
\f[V]--config\f[R] (https://rclone.org/docs/#config-string)
آن را مشخص کنید.
همچنین توجه داشته باشید که در این حالت حساب SYSTEM دسترسی‌های مالک (owner) را خواهد داشت، و سایر حساب‌ها بر اساس محدوده‌های گروهی (group) یا دیگران (others) مجوز دسترسی خواهند داشت.
همان‌طور که در بالا اشاره شد، این حساب‌ها مجوز \[dq]write extended attributes\[dq] را دریافت نخواهند کرد، و این ممکن است مانع از نوشتن روی فایل‌ها شود.
می‌توانید با استفاده از گزینه FileSecurity این مشکل را دور بزنید؛ مثال بالا را ببینید.
.PP
توجه داشته باشید که نگاشت به یک مسیر دایرکتوری، به جای یک حرف درایو، از محدودیت‌های مشابه رنج نمی‌برد.
.SS سوار کردن در مک‌او‌اس (Mounting on macOS)
.PP
سوار کردن در macOS می‌تواند از طریق سرور داخلی
NFS (https://rclone.org/commands/rclone_serve_nfs)،
macFUSE (https://osxfuse.github.io) (که با نام osxfuse نیز شناخته می‌شود) یا
FUSE-T (https://www.fuse-t.org)
انجام شود.
macFUSE یک درایور سنتی FUSE است که از افزونه هسته macOS موسوم به (kext) بهره می‌برد.
FUSE-T یک سیستم FUSE جایگزین است که از طریق یک سرور محلی NFSv4 عملیات \[dq]mount\[dq] را انجام می‌دهد.
.SS نرمال‌سازی یونیکد (Unicode Normalization)
.PP
اکیداً توصیه می‌شود که مقدار پیش‌فرض
\f[V]--no-unicode-normalization=false\f[R] برای تمام دستورهای \f[V]mount\f[R] و
\f[V]serve\f[R] در macOS حفظ شود.
برای جزئیات،
vfs-case-sensitivity (https://rclone.org/commands/rclone_mount/#vfs-case-sensitivity)
را ببینید.
.SS سوار کردن NFS (NFS mount)
.PP
برای macOS (و سایر پلتفرم‌هایی که این مسیر در آن‌ها پشتیبانی می‌شود)، دستور اختصاصی
rclone nfsmount (https://rclone.org/commands/rclone_nfsmount)
را در اولویت قرار دهید.
این دستور سرور NFS را راه‌اندازی کرده و عمل سوار کردن را برای شما انجام می‌دهد.
دستور \f[V]rclone mount\f[R] به خودی خود همچنان از FUSE (یا همان macFUSE/FUSE-T) استفاده می‌کند و از طریق هیچ پرچمی به NFS تغییر وضعیت نمی‌دهد.
.PP
این روش یک سرور NFS را با استفاده از دستور
serve nfs (https://rclone.org/commands/rclone_serve_nfs)
راه‌اندازی کرده و آن را در نقطه سوار کردن (mountpoint) مشخص‌شده سوار می‌کند.
اگر این را در حالت پس‌زمینه با استفاده از |--daemon| اجرا می‌کنید، باید سیگنال SIGTERM را با استفاده از دستور |kill| به فرایند rclone ارسال کنید تا سوار کردن متوقف شود.
.PP
توجه داشته باشید که \f[V]--nfs-cache-handle-limit\f[R] حداکثر تعداد هندل‌های فایل کش‌شده ذخیره‌شده توسط نگه‌دارنده کش \f[V]nfsmount\f[R] را کنترل می‌کند.
این مقدار نباید خیلی پایین تنظیم شود، در غیر این صورت ممکن است هنگام تلاش برای دسترسی به فایل‌ها با خطا مواجه شوید.
مقدار پیش‌فرض 1000000 است، اما در صورتی که میزان مصرف منابع سیستم توسط سرور مشکل‌ساز شد، کاهش این حد مجاز را در نظر بگیرید..SS نکات macFUSE
.PP
در صورت نصب macFUSE با استفاده از بسته‌های dmg
(https://github.com/osxfuse/osxfuse/releases) از وب‌سایت،
rclone کتابخانه‌های macFUSE را بدون نیاز به هیچ اقدام دیگری پیدا خواهد کرد.
اما اگر macFUSE با استفاده از مدیر بسته
macports (https://www.macports.org) نصب شده باشد، مراحل تکمیلی زیر
مورد نیاز است.
.IP
.nf
\f[C]
sudo mkdir /usr/local/lib
cd /usr/local/lib
sudo ln -s /opt/local/lib/libfuse.2.dylib
\f[R]
.fi
.SS محدودیت‌ها، هشدارها و نکات FUSE-T
.PP
محدودیت‌ها، هشدارها و نکاتی درباره نحوه کارکرد آن وجود دارد.
این موارد تا نسخه 1.0.14 از FUSE-T معتبر هستند.
.SS به‌روزرسانی ModTime در زمان خواندن
.PP
طبق ویکی FUSE-T
(https://github.com/macos-fuse-t/fuse-t/wiki#caveats):
.RS
.PP
زمان‌های دسترسی و تغییر فایل را نمی‌توان به طور جداگانه تنظیم کرد، چرا که به نظر می‌رسد
مشکلی در کلاینت NFS باشد که همیشه هر دو را تغییر می‌دهد.
این مورد با دستورهای \f[V]touch -m\f[R] و \f[V]touch -a\f[R]
قابل بازتولید است
.RE
.PP
این بدان معناست که مشاهده فایل‌ها با ابزارهای گوناگون، به‌ویژه Finder در macOS،
باعث می‌شود rclone زمان تغییر فایل (modification time) را به‌روزرسانی کند.
این امر ممکن است موجب شود rclone یک نسخه کامل و جدید از فایل را بارگذاری کند.
.SS سوار کردن فقط‌خواندنی
.PP
هنگام سوار کردن با گزینه \f[V]--read-only\f[R]، تلاش برای نوشتن در فایل‌ها
به صورت \f[I]بی‌صدا\f[R] با شکست مواجه می‌شود، بر خلاف macFUSE که هشدار واضحی صادر می‌کند.
.SS سوار کردن در لینوکس
.PP
در نسخه‌های جدیدتر Ubuntu، ممکن است هنگام اجرای \f[V]rclone mount\f[R]
با خطای زیر مواجه شوید:
.RS
.PP
NOTICE: mount helper error: fusermount3: mount failed: Permission denied
CRITICAL: Fatal error: failed to mount FUSE fs: fusermount: exit status
1
.RE
.PP
این ممکن است به دلیل محدودیت‌های جدیدتر Apparmor (https://wiki.ubuntu.com/AppArmor)
باشد که می‌توان آن‌ها را با
\f[V]sudo aa-disable /usr/bin/fusermount3\f[R] غیرفعال کرد (ممکن است لازم باشد از قبل
\f[V]sudo apt install apparmor-utils\f[R] را اجرا کنید).
.SS سوار کردن در OpenBSD
.PP
دستور \f[V]rclone nfsmount\f[R] در OpenBSD با راه‌اندازی سرور
serve nfs (https://rclone.org/commands/rclone_serve_nfs) و سوار کردن
آن از طریق دستور سیستمی \f[V]mount_nfs(8)\f[R] کار می‌کند؛ یعنی همان رویکردی که برای
روش سوار کردن NFS در macOS به کار می‌رود.
هیچ گزینه سوار کردنی مبتنی بر FUSE در OpenBSD وجود ندارد، بنابراین \f[V]nfsmount\f[R]
تنها راه برای سوار کردن ریموت‌های rclone به عنوان یک سیستم‌فایل محلی در آنجا است.
.SS ثبت portmap
.PP
کلاینت NFS کرنل در OpenBSD، دمون \f[V]mountd\f[R] را به جای اتصال به یک درگاه ثابت،
از طریق portmapper سیستم پیدا می‌کند؛ بنابراین، سرور NFS درون‌پروسه‌ای rclone باید
پیش از سوار شدن، در portmap ثبت شود.
سرور \f[V]serve nfs\f[R] را روی یک پورت ثابت اجرا کنید، سرویس‌های NFS سیستم را
متوقف کنید تا تداخلی ایجاد نشود، سپس آن پورت را در portmap برای هر دو
برنامه RPC یعنی \f[V]nfs\f[R] و \f[V]mountd\f[R] ثبت نمایید (این راهکار توسط hjicks در
#8578 (https://github.com/rclone/rclone/issues/8578#issuecomment-2799229652) ارائه شده است):
.IP
.nf
\f[C]
rclone serve nfs --addr localhost:<PORT> remote:path

doas rcctl stop nfsd portmap
doas pkill -9 mountd   # mountd can\[aq]t be stopped via rcctl(8)
doas rcctl -f start portmap
doas rpcinfo -s nfs 3 <PORT>
doas rpcinfo -s mountd 3 <PORT>
\f[R]
.fi
.PP
مقدار \f[V]<PORT>\f[R] را با پورتی که به \f[V]--addr\f[R] داده‌اید جایگزین کنید.
پورت 2049 نیز کار می‌کند، اما نیازمند اجرای rclone با دسترسی root یا
تنظیم \f[V]sysctl(8)\f[R] در securelevel 0 است؛ بنابراین برای آزمایش، یک پورت غیرممتاز
ساده‌تر است..SS استفاده از \f[V]mount_nfs -T\f[R] به جای \f[V]mount\f[R]
.PP
اشتراک NFS صادرشده (exported) را مستقیماً با \f[V]mount_nfs(8)\f[R] و با استفاده از پرچم \f[V]-T\f[R] برای اجبار به استفاده از TCP سوار کنید، نه از طریق پوشش‌دهنده عمومی \f[V]mount(8)\f[R] \- دستور \f[V]mount(8)\f[R] در OpenBSD پرچم \f[V]-T\f[R] را تشخیص نمی‌دهد و آن را با خطای زیر رد می‌کند:
\f[V]unknown option -- T\f[R]:
.IP
.nf
\f[C]
mount_nfs -T localhost:/ /path/to/local/mount
\f[R]
.fi
.PP
دستور \f[V]rclone nfsmount\f[R] این کار را به‌طور خودکار در OpenBSD برای شما انجام می‌دهد (مستقیماً \f[V]mount_nfs\f[R] را با \f[V]-T\f[R] فراخوانی می‌کند به جای اینکه از طریق \f[V]mount\f[R] عمل کند)، بنابراین این کار تنها در صورتی لازم است که اشتراک \f[V]serve nfs\f[R] را به‌صورت دستی سوار کنید.
.SS AUTH_UNIX و محدودیت‌های موجود (AUTH_UNIX and existing limitations)
.PP
کلاینت NFS هسته در OpenBSD (و سایر BSDها) نیازمند آن است که سرور شیوه احراز هویت \f[V]AUTH_UNIX\f[R] را در طول دست‌تکانی MOUNT RPC ارائه دهد؛ سروری که تنها \f[V]AUTH_NULL\f[R] را ارائه کند با خطای زیر رد می‌شود:
\f[V]mount_nfs: can\[aq]t access /: Authentication error\f[R].
سرور NFS در rclone به همین دلیل \f[V]AUTH_UNIX\f[R] را اعلان می‌کند، هرچند که هیچ کنترل دسترسی بر پایه هر کاربر (per-user) را روی آن پیاده‌سازی نمی‌کند \- برای پیش‌زمینه این موضوع و وضعیت فعلی پشتیبانی از OpenBSD، گزارش شماره #8578 (<https://github.com/rclone/rclone/issues/8578>) را ببینید.
.SS محدودیت‌ها (Limitations)
.PP
بدون استفاده از \f[V]--vfs-cache-mode\f[R]، این دستور تنها می‌تواند فایل‌ها را به‌صورت ترتیبی بنویسد و فقط هنگام خواندن امکان پیمایش (seek) دارد.
این بدان معناست که بسیاری از برنامه‌ها بدون \f[V]--vfs-cache-mode writes\f[R] یا \f[V]--vfs-cache-mode full\f[R] با فایل‌های خود روی نقطه اتصال rclone کار نخواهند کرد.
برای اطلاعات بیشتر بخش VFS File Caching را ببینید.
هنگام استفاده از سوار کردن NFS در macOS، اگر |--vfs-cache-mode| را مشخص نکنید، نقطه اتصال فقط‌خواندنی خواهد بود.
.PP
ریموت‌های مبتنی بر باکت (Bucket-based remotes) \- شامل Azure Blob، Swift، S3، Google Cloud Storage و B2 \- نمی‌توانند دایرکتوری‌های خالی را ذخیره کنند.
از میان این‌ها، تنها Azure Blob، Google Cloud Storage و S3 می‌توانند هنگام افزودن \f[V]--xxx-directory_markers\f[R] آن‌ها را حفظ کنند؛ در غیر این صورت، دایرکتوری‌های خالی به محض خروج از حافظه موقت دایرکتوری ناپدید خواهند شد.
.PP
هنگامی که \f[V]rclone mount\f[R] در Unix با پرچم \f[V]--daemon\f[R] اجرا می‌شود، برنامه اصلی rclone منتظر آماده شدن نقطه اتصال در پس‌زمینه می‌ماند یا تا زمانی که مهلت تعیین‌شده توسط پرچم \f[V]--daemon-wait\f[R] به پایان برسد.
در Linux وضعیت سوار شدن با استفاده از ProcFS قابل بررسی است، بنابراین این پرچم در واقع \f[B]حداکثر\f[R] زمان انتظار را تعیین می‌کند، در حالی که زمان انتظار واقعی می‌تواند کمتر باشد.
در macOS / BSD زمان انتظار ثابت است و بررسی فقط در پایان انجام می‌شود.
توصیه می‌کنیم زمان انتظار را در macOS به‌طور معقول تنظیم کنید.
.PP
در حال حاضر تنها روی Linux، FreeBSD، OS X و Windows پشتیبانی می‌شود.
.SS مقایسه rclone mount با rclone sync/copy
.PP
سیستم‌های فایل انتظار دارند همه‌چیز ۱۰۰٪ قابل‌اطمینان باشد، در حالی که سیستم‌های ذخیره‌سازی ابری با قابلیت اطمینان ۱۰۰٪ فاصله زیادی دارند.
دستورهای rclone sync/copy با تلاش‌های مجدد فراوان با این مسئله کنار می‌آیند.
با این حال، \f[V]rclone mount\f[R] بدون ایجاد نسخه‌های محلی از بارگذاری‌ها، نمی‌تواند به همان شیوه از تلاش‌های مجدد استفاده کند.
برای راهکارهایی جهت بالا بردن قابلیت اطمینان سوار کردن، به بخش VFS File Caching مراجعه کنید.
.SS حافظه موقت مشخصه‌ها (Attribute caching)
.PP
می‌توانید از پرچم \f[V]--attr-timeout\f[R] برای تنظیم مدت‌زمانی که هسته مشخصه‌ها (اندازه، زمان تغییر و غیره) را برای مدخل‌های دایرکتوری در حافظه موقت (کَش) نگه می‌دارد، استفاده کنید.
.PP
مقدار پیش‌فرض \f[V]1s\f[R] است که فایل‌ها را دقیقاً به اندازه‌ای کَش می‌کند که از فراخوانی‌های برگشتی مکرر هسته به rclone جلوگیری شود.
.PP
از نظر تئوری، \f[V]0s\f[R] باید مقدار صحیحی برای سیستم‌های فایلی باشد که می‌توانند خارج از کنترل هسته تغییر کنند.
با این حال این کار مشکلات متعددی ایجاد می‌کند؛ مانند مصرف بیش از حد حافظه توسط rclone (<https://github.com/rclone/rclone/issues/2157>)، عدم سرویس‌دهی فایل‌ها به samba توسط rclone (<https://forum.rclone.org/t/rclone-1-39-vs-1-40-mount-issue/5112>) و زمان بسیار زیاد برای فهرست کردن دایرکتوری‌ها (<https://github.com/rclone/rclone/issues/2095#issuecomment-371141147>).
.PP
هسته می‌تواند اطلاعات مربوط به یک فایل را به مدت زمان مشخص‌شده توسط \f[V]--attr-timeout\f[R] ذخیره کند.
اگر طول فایل ریموت در طول این بازه زمانی تغییر کند، ممکن است با خرابی فایل مواجه شوید.
این خرابی یا به‌صورت فایلی بریده‌شده (truncated) یا فایلی با داده‌های زائد در انتهای آن ظاهر می‌شود.
با \f[V]--attr-timeout 1s\f[R] این اتفاق بسیار نامحتمل اما ممکن است.
هر چه \f[V]--attr-timeout\f[R] را بالاتر تنظیم کنید، احتمال آن بیشتر می‌شود.
مقدار پیش‌فرض \[dq]1s\[dq] کمترین تنظیمی است که مشکلات بالا را تخفیف می‌دهد.
.PP
اگر آن را بالاتر تنظیم کنید (مثلاً \f[V]10s\f[R] یا \f[V]1m\f[R])، هسته مراجعات کمتری به rclone خواهد داشت و کارایی افزایش می‌یابد؛ با این حال احتمال بروز مشکل خرابی فایل که در بالا ذکر شد بیشتر خواهد بود.
.PP
اگر فایل‌ها روی ریموت خارج از کنترل rclone تغییر نکنند، هیچ احتمال خرابی وجود ندارد.
.PP
این قابلیت مشابه تنظیم گزینه attr_timeout در mount.fuse است..SS "فیلترها (Filters)"
.PP
توجه داشته باشید که از همهٔ فیلترهای rclone می‌توان برای انتخاب زیرمجموعه‌ای از فایل‌ها جهت نمایش در سوار کردن (mount) استفاده کرد.
.SS "systemd"
.PP
هنگام اجرای rclone mount به‌صورت یک سرویس systemd، امکان استفاده از \f[V]Type=notify\f[R] وجود دارد.
در این حالت، سرویس پس از راه‌اندازی موفقیت‌آمیز نقطهٔ سوار کردن (mountpoint) به وضعیت آغازشده (started) وارد خواهد شد.
واحدهایی (units) که سرویس mount مربوط به rclone را به‌عنوان یک پیش‌نیاز مشخص کرده‌اند، در این حالت همهٔ فایل‌ها و پوشه‌ها را بلافاصله مشاهده خواهند کرد.
.PP
توجه داشته باشید که systemd واحدهای mount را بدون هیچ‌گونه متغیر محیطی، از جمله \f[V]PATH\f[R] یا \f[V]HOME\f[R] اجرا می‌کند.
این بدان معناست که بسط مدک (\f[V]\[ti]\f[R]) کار نخواهد کرد و باید \f[V]--config\f[R] و \f[V]--cache-dir\f[R] را صراحتاً به‌صورت مسیرهای مطلق از طریق آرگومان‌های rclone مشخص کنید.
از آنجا که سوار کردن نیازمند برنامهٔ \f[V]fusermount\f[R] یا \f[V]fusermount3\f[R] است، rclone در این سناریو از مقدار جایگزین PATH یعنی \f[V]/bin:/usr/bin\f[R] استفاده خواهد کرد.
لطفاً اطمینان حاصل کنید که \f[V]fusermount\f[R]/\f[V]fusermount3\f[R] در این PATH موجود باشد.
.SS "استفاده از rclone به‌عنوان دستیار سوار کردن یونیکس (Rclone as Unix mount helper)"
.PP
برنامهٔ بنیادین یونیکس \f[V]/bin/mount\f[R] معمولاً آرگومان \f[V]-t FSTYPE\f[R] را دریافت کرده و سپس برنامهٔ کمکی \f[V]/sbin/mount.FSTYPE\f[R] را با انتقال گزینه‌های mount به‌صورت \f[V]-o key=val,...\f[R] یا \f[V]--opt=...\f[R] اجرا می‌کند.
قابلیت Automount (کلاسیک یا systemd) نیز به شیوه‌ای مشابه عمل می‌کند.
.PP
ابزار rclone به‌طور پیش‌فرض گزینه‌هایی با سبک گنو مانند \f[V]--key val\f[R] را انتظار دارد.
برای اجرای آن به‌عنوان یک دستیار سوار کردن (mount helper)، باید فایل باینری rclone را به \f[V]/sbin/mount.rclone\f[R] و در صورت تمایل به \f[V]/usr/bin/rclonefs\f[R] پیوند نمادین بزنید؛ مانند:
\f[V]ln -s /usr/bin/rclone /sbin/mount.rclone\f[R].
ابزار rclone این وضعیت را تشخیص داده و آرگومان‌های خط فرمان را به‌درستی برمی‌گرداند.
.PP
اکنون می‌توانید mountهای کلاسیک را به این صورت اجرا کنید:
.IP
.nf
\f[C]
mount sftp1:subdir /mnt/data -t rclone -o vfs_cache_mode=writes,sftp_key_file=/path/to/pem
\f[R]
.fi
.PP
یا واحدهای mount در systemd ایجاد کنید:
.IP
.nf
\f[C]
# /etc/systemd/system/mnt-data.mount
[Unit]
Description=Mount for /mnt/data
[Mount]
Type=rclone
What=sftp1:subdir
Where=/mnt/data
Options=rw,_netdev,allow_other,args2env,vfs-cache-mode=writes,config=/etc/rclone.conf,cache-dir=/var/rclone
\f[R]
.fi
.PP
که به‌صورت اختیاری می‌تواند با یک واحد automount در systemd همراه شود:
.IP
.nf
\f[C]
# /etc/systemd/system/mnt-data.automount
[Unit]
Description=AutoMount for /mnt/data
[Automount]
Where=/mnt/data
TimeoutIdleSec=600
[Install]
WantedBy=multi-user.target
\f[R]
.fi
.PP
یا سطری مشابه زیر را به \f[V]/etc/fstab\f[R] بیفزایید:
.IP
.nf
\f[C]
sftp1:subdir /mnt/data rclone rw,noauto,nofail,_netdev,x-systemd.automount,args2env,vfs_cache_mode=writes,config=/etc/rclone.conf,cache_dir=/var/cache/rclone 0 0
\f[R]
.fi
.PP
یا از Automountd کلاسیک استفاده کنید.
به یاد داشته باشید که مقادیر صریح \f[V]config=...,cache-dir=...\f[R] را به‌عنوان راه‌حلی برای اجرای واحدهای mount بدون متغیر \f[V]HOME\f[R] قید کنید.
.PP
ابزار rclone در حالت دستیار سوار کردن، آرگومان(های) \f[V]-o\f[R] را با ویرگول جدا کرده، \f[V]_\f[R] را با \f[V]-\f[R] جایگزین می‌کند و برای تشکیل گزینه‌های خط فرمان، \f[V]--\f[R] را به ابتدای آن‌ها اضافه می‌کند.
گزینه‌های حاوی ویرگول یا فاصله را می‌توان در نقل‌قول تکی یا دوتایی محصور کرد.
هرگونه نقل‌قول درونی در داخل نقل‌قول‌های بیرونیِ هم‌نوع، باید تکرار (مضاعف) شود.
.PP
نحو گزینه‌های mount شامل چند گزینهٔ ویژه است که رفتار متفاوتی دارند:
.IP \[bu] 2
عبارت \f[V]env.NAME=VALUE\f[R] یک متغیر محیطی را برای فرآیند mount تعیین می‌کند.
این قابلیت برای Automountd و Systemd.mount که امکان تنظیم محیط سفارشی را برای دستیارهای mount نمی‌دهند کارآمد است.
معمولاً از \f[V]env.HTTPS_PROXY=proxy.host:3128\f[R] یا \f[V]env.HOME=/root\f[R] استفاده خواهید کرد.
.IP \[bu] 2
عبارت \f[V]command=cmount\f[R] می‌تواند برای اجرای \f[V]cmount\f[R] یا هر دستور دیگر rclone به جای دستور پیش‌فرض \f[V]mount\f[R] به کار رود.
.IP \[bu] 2
گزینهٔ \f[V]args2env\f[R] گزینه‌های mount را به جای آرگومان‌های خط فرمان، از طریق متغیرهای محیطی به دستیار mount که در پس‌زمینه اجرا می‌شود انتقال می‌دهد.
این ویژگی امکان پنهان‌سازی اطلاعات حساس از دستورهایی نظیر \f[V]ps\f[R] یا \f[V]pgrep\f[R] را فراهم می‌آورد.
.IP \[bu] 2
عبارت \f[V]vv...\f[R] به گزینهٔ مناسب \f[V]--verbose=N\f[R] تبدیل خواهد شد.
.IP \[bu] 2
گزینه‌های استاندارد mount مانند \f[V]x-systemd.automount\f[R]، \f[V]_netdev\f[R]، \f[V]nosuid\f[R] و موارد مشابه فقط برای Automountd در نظر گرفته شده‌اند و توسط rclone نادیده گرفته می‌شوند..SS "VFS \- سامانه فایل مجازی (Virtual File System)"
.PP
این دستور از لایه VFS استفاده می‌کند.
این لایه، آبجکت‌های فضای ذخیره‌سازی ابری مورد استفاده rclone را به ساختاری تبدیل می‌کند که بسیار بیشتر شبیه به یک سامانه فایل دیسکی به نظر می‌رسد.
.PP
آبجکت‌های ذخیره‌سازی ابری ویژگی‌های بسیاری دارند که شبیه فایل‌های دیسکی نیستند \- شما نمی‌توانید آن‌ها را گسترش دهید یا در میانهٔ آن‌ها بنویسید؛ بنابراین لایه VFS باید با این موضوع تعامل داشته باشد.
از آنجا که هیچ راه منفرد و کاملاً درستی برای انجام این کار وجود ندارد، گزینه‌های گوناگونی در ادامه توضیح داده شده‌اند.
.PP
لایه VFS همچنین یک کش دایرکتوری را پیاده‌سازی می‌کند \- این بخش، اطلاعات مربوط به فایل‌ها و دایرکتوری‌ها (اما نه داده‌های آن‌ها) را در حافظه کش می‌کند.
.SS "کش دایرکتوری VFS (VFS Directory Cache)"
.PP
با استفاده از پرچم \f[V]--dir-cache-time\f[R] می‌توانید کنترل کنید که یک دایرکتوری تا چه مدت به‌روز در نظر گرفته شود و از سمت backend بازخوانی نگردد.
تغییرات ایجادشده از طریق VFS بی‌درنگ نمایش داده خواهند شد یا کش را نامعتبر (invalidate) می‌کنند.
.IP
.nf
\f[C]
    --dir-cache-time duration   Time to cache directory entries for (default 5m0s)
    --poll-interval duration    Time to wait between polling for changes. Must be smaller than dir-cache-time. Only on supported remotes. Set to 0 to disable (default 1m0s)
\f[R]
.fi
.PP
با این حال، در صورتی که backend پیکربندی‌شده از بررسی دوره‌ای برای تغییرات (polling) پشتیبانی نکند، تغییراتی که مستقیماً از طریق رابط کاربری وب در فضای ذخیره‌سازی ابری یا توسط نسخهٔ دیگری از rclone اعمال شوند تنها پس از انقضای کش دایرکتوری شناسایی خواهند شد.
اگر backend از polling پشتیبانی کند، تغییرات در بازهٔ زمانیِ polling دریافت و اعمال می‌شوند.
.PP
شما می‌توانید یک سیگنال \f[V]SIGHUP\f[R] به rclone ارسال کنید تا صرف‌نظر از عمر کش‌ها، تمام کش‌های دایرکتوری را تخلیه (flush) کند.
با فرض اینکه تنها یک نسخه از rclone در حال اجرا است، می‌توانید کش را به این شکل بازنشانی کنید:
.IP
.nf
\f[C]
kill -SIGHUP $(pidof rclone)
\f[R]
.fi
.PP
اگر rclone را همراه با کنترل از راه دور (remote control) پیکربندی کرده باشید، می‌توانید با استفاده از rclone rc تمام کش دایرکتوری را تخلیه کنید:
.IP
.nf
\f[C]
rclone rc vfs/forget
\f[R]
.fi
.PP
یا فایل‌ها یا دایرکتوری‌های مشخص را پاک‌سازی کنید:
.IP
.nf
\f[C]
rclone rc vfs/forget file=path/to/file dir=path/to/dir
\f[R]
.fi
.SS "بافر کردن فایل در VFS (VFS File Buffering)"
.PP
پرچم \f[V]--buffer-size\f[R] مقدار حافظه‌ای را که از پیش برای بافر کردن داده‌ها اختصاص می‌یابد، تعیین می‌کند.
.PP
هر فایلِ باز تلاش خواهد کرد تا در تمام طول مدت، مقدار مشخص‌شده از داده‌ها را در حافظه نگه دارد.
داده‌های بافرشده مقید به یک فایل باز هستند و به اشتراک گذاشته نمی‌شوند.
.PP
این پرچم یک حد بالا برای حافظهٔ مصرفی به ازای هر فایل باز است.
بافر تنها برای داده‌هایی حافظه مصرف می‌کند که دانلود شده‌اند اما هنوز خوانده نشده‌اند.
اگر بافر خالی باشد، تنها مقدار بسیار اندکی از حافظه استفاده خواهد شد.
.PP
بیشینهٔ حافظهٔ استفاده‌شده توسط rclone برای بافرینگ می‌تواند تا سقف
\f[V]--buffer-size * open files\f[R]
باشد.
.SS "کش کردن فایل در VFS (VFS File Caching)"
.PP
این پرچم‌ها گزینه‌های کش فایل در VFS را کنترل می‌کنند.
کش کردن فایل برای این که لایهٔ VFS سازگار با یک سامانه فایل عادی به نظر برسد ضروری است.
این قابلیت را می‌توان به بهای از دست رفتن بخشی از سازگاری غیرفعال کرد.
.PP
برای نمونه، اگر بخواهید هم‌زمان عملیات خواندن و نوشتن را روی یک فایل انجام دهید، باید کش VFS را فعال کنید.
برای جزئیات بیشتر به بخش‌های زیر نگاه کنید.
.PP
توجه داشته باشید که کش VFS از backend کش (cache backend) مجزا است و ممکن است به یکی از آن‌ها یا هر دو نیاز داشته باشید.
.IP
.nf
\f[C]
    --cache-dir string                     Directory rclone will use for caching.
    --vfs-cache-mode CacheMode             Cache mode off|minimal|writes|full (default off)
    --vfs-cache-max-age duration           Max time since last access of objects in the cache (default 1h0m0s)
    --vfs-cache-max-size SizeSuffix        Max total size of objects in the cache (default off)
    --vfs-cache-min-free-space SizeSuffix  Target minimum free space on the disk containing the cache (default off)
    --vfs-cache-poll-interval duration     Interval to poll the cache for stale objects (default 1m0s)
    --vfs-write-back duration              Time to writeback files after last use when using cache (default 5s)
\f[R]
.fi
.PP
اگر rclone با گزینهٔ \f[V]-vv\f[R] اجرا شود، مسیر قرارگیری کش فایل را در خروجی نمایش می‌دهد.
فایل‌ها در ناحیهٔ فایل‌های کش کاربر ذخیره می‌شوند که وابسته به سیستم‌عامل است، اما می‌توان آن را با \f[V]--cache-dir\f[R] یا با تنظیم متغیر محیطی مربوطه مدیریت کرد.
.PP
کش دارای ۴ حالت گوناگون است که با \f[V]--vfs-cache-mode\f[R] انتخاب می‌شوند.
هرچه حالت کش بالاتر باشد، سازگاری rclone در ازای مصرف فضای دیسک افزایش می‌یابد.
.PP
توجه داشته باشید که فایل‌ها تنها زمانی به remote بازنویسی می‌شوند (write back) که بسته شده باشند و به مدت \f[V]--vfs-write-back\f[R] ثانیه به آن‌ها دسترسی پیدا نشده باشد.
اگر rclone متوقف شود یا پیش از آپلود فایل‌ها به کار خود پایان دهد، این فایل‌ها در اجرای بعدی rclone با همان پرچم‌ها بارگذاری خواهند شد.
.PP
در صورت استفاده از \f[V]--vfs-cache-max-size\f[R] یا \f[V]--vfs-cache-min-free-space\f[R]، توجه داشته باشید که حجم کش ممکن است به دو دلیل از این سهمیه‌ها فراتر رود.
نخست به این دلیل که بررسی حجم تنها در فواصل زمانی \f[V]--vfs-cache-poll-interval\f[R] صورت می‌گیرد.
دوم به این دلیل که فایل‌های باز را نمی‌توان از کش بیرون انداخت (evict کرد).
هنگامی که اندازه از \f[V]--vfs-cache-max-size\f[R] یا \f[V]--vfs-cache-min-free-space\f[R] بیشتر شود، rclone ابتدا تلاش می‌کند فایل‌هایی را که کمترین دسترسی را داشته‌اند از کش خارج کند.
برنامه rclone این کار را از فایل‌هایی آغاز می‌کند که برای طولانی‌ترین زمان دست‌نخورده باقی مانده‌اند.
این راهبرد پاک‌سازی کش کارآمد است و احتمال باقی ماندن فایل‌های مرتبط‌تر در کش بیشتر خواهد بود.
.PP
گزینهٔ \f[V]--vfs-cache-max-age\f[R] پس از گذشت مدت‌زمان تعیین‌شده از آخرین دسترسی، فایل‌ها را از کش حذف می‌کند؛ مبنای این فرایند زمان آخرین دسترسی است، نه زمانی که فایل نخستین بار به کش افزوده شد.
مقدار پیش‌فرض ۱ ساعت فایل‌هایی را که به مدت ۱ ساعت دسترسی نداشته‌اند، از کش بیرون می‌اندازد.
هنگامی که به یک فایل کش‌شده دسترسی پیدا شود، تایمر ۱ ساعته به ۰ بازنشانی شده و مجدداً پیش از حذف ۱ ساعت منتظر خواهد ماند.
زمان را با نشانه‌گذاری استاندارد مانند s، m، h، d، w مشخص کنید.
.PP
در صورت استفاده از \f[V]--vfs-cache-mode > off\f[R]، شما \f[B]نباید\f[R] دو نسخه از rclone را با استفاده از یک کش VFS یکسان و با ریموت‌های یکسان یا هم‌پوشان اجرا کنید.
انجام این کار بالقوه می‌تواند منجر به خرابی داده‌ها شود.
می‌توانید با اختصاص دادن سلسله‌مراتب کش مجزا به هر rclone از طریق \f[V]--cache-dir\f[R] از بروز این مشکل جلوگیری کنید.
در صورتی که ریموت‌های مورد استفاده هم‌پوشانی ندارند، نیازی به نگرانی در این مورد نیست..SS --vfs-cache-mode off
.PP
در این حالت (پیش‌فرض)، کَش مستقیماً از ریموت خوانده و مستقیماً روی آن می‌نویسد بدون اینکه چیزی روی دیسک کَش شود.
.PP
این امر به این معناست که برخی عملیات‌ها امکان‌پذیر نخواهند بود:
.IP \[bu] 2
فایل‌ها نمی‌توانند هم‌زمان برای خواندن و نوشتن (read AND write) باز شوند
.IP \[bu] 2
امکان جست‌وجو/پیمایش (seek) در فایل‌های بازشده برای نوشتن وجود ندارد
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید O_TRUNC برای آن‌ها تنظیم شده باشد
.IP \[bu] 2
فایل‌های بازشده برای خواندن همراه با O_TRUNC، به‌صورت فقط‌نوشتنی باز خواهند شد
.IP \[bu] 2
فایل‌های بازشده به‌صورت فقط‌نوشتنی به‌گونه‌ای رفتار می‌کنند که انگار O_TRUNC مشخص شده است
.IP \[bu] 2
حالت‌های باز کردن O_APPEND و O_TRUNC نادیده گرفته می‌شوند
.IP \[bu] 2
اگر بارگذاری با شکست مواجه شود، امکان تلاش مجدد وجود ندارد
.SS --vfs-cache-mode minimal
.PP
این حالت بسیار شبیه به \[dq]off\[dq] است، با این تفاوت که فایل‌های بازشده برای خواندن و نوشتن هم‌زمان، روی دیسک بافر می‌شوند.
این یعنی فایل‌های بازشده برای نوشتن سازگاری بسیار بیشتری خواهند داشت، اما حداقل فضای دیسک مصرف می‌شود.
.PP
این عملیات‌ها امکان‌پذیر نیستند:
.IP \[bu] 2
امکان جست‌وجو/پیمایش (seek) در فایل‌های بازشده به‌صورت فقط‌نوشتنی وجود ندارد
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید O_TRUNC برای آن‌ها تنظیم شده باشد
.IP \[bu] 2
فایل‌های بازشده به‌صورت فقط‌نوشتنی O_APPEND و O_TRUNC را نادیده می‌گیرند
.IP \[bu] 2
اگر بارگذاری با شکست مواجه شود، امکان تلاش مجدد وجود ندارد
.SS --vfs-cache-mode writes
.PP
در این حالت، فایل‌های بازشده به‌صورت فقط‌خواندنی همچنان مستقیماً از ریموت خوانده می‌شوند، اما فایل‌های فقط‌نوشتنی و خواندنی/نوشتنی ابتدا روی دیسک بافر می‌شوند.
.PP
این حالت باید از تمام عملیات‌های عادی سیستم‌فایل پشتیبانی کند.
.PP
اگر یک بارگذاری با شکست مواجه شود، در فواصل زمانی با افزایش تصاعدی تا حداکثر ۱ دقیقه مجدداً تلاش خواهد شد.
.SS --vfs-cache-mode full
.PP
در این حالت، تمام خواندن‌ها و نوشتن‌ها روی دیسک و از دیسک بافر می‌شوند.
هنگامی که داده‌ها از ریموت خوانده می‌شوند نیز روی دیسک بافر خواهند شد.
.PP
در این حالت، فایل‌های موجود در کَش به‌صورت فایل‌های کم‌پشت (sparse files) خواهند بود و rclone پیگیری خواهد کرد که کدام بخش‌های فایل بارگیری شده‌اند.
.PP
بنابراین اگر برنامه‌ای تنها بخش ابتدایی هر فایل را بخواند، rclone نیز تنها ابتدای فایل را بافر می‌کند.
این فایل‌ها در کَش با اندازه کامل به نظر می‌رسند، اما فایل‌های کم‌پشتی هستند که تنها داده‌های بارگیری‌شده در آن‌ها وجود دارد.
.PP
این حالت باید از تمام عملیات‌های عادی سیستم‌فایل پشتیبانی کند و در باقی موارد با \f[V]--vfs-cache-mode\f[R] writes یکسان است.
.PP
هنگام خواندن یک فایل، rclone به اندازه \f[V]--buffer-size\f[R] به‌علاوه \f[V]--vfs-read-ahead\f[R] بایت به جلو پیش‌خوانی می‌کند.
مقدار \f[V]--buffer-size\f[R] در حافظه بافر می‌شود در حالی که \f[V]--vfs-read-ahead\f[R] روی دیسک بافر می‌گردد.
.PP
هنگام استفاده از این حالت، توصیه می‌شود که \f[V]--buffer-size\f[R] بیش از حد بزرگ تنظیم نشود و در صورت نیاز، \f[V]--vfs-read-ahead\f[R] بزرگ در نظر گرفته شود.
.PP
\f[B]مهم:\f[R] همه سیستم‌فایل‌ها از فایل‌های کم‌پشت پشتیبانی نمی‌کنند؛
به‌ویژه FAT/exFAT پشتیبانی نمی‌کنند.
اگر دایرکتوری کَش روی سیستم‌فایلی باشد که از فایل‌های کم‌پشت پشتیبانی نمی‌کند، عملکرد rclone بسیار ضعیف خواهد بود و در صورت تشخیص چنین موردی، یک پیام ERROR ثبت خواهد کرد.
.SS اثرانگشت‌گذاری (Fingerprinting)
.PP
بخش‌های مختلف VFS از اثرانگشت‌گذاری برای بررسی اینکه آیا نسخه محلی فایل نسبت به فایل ریموت تغییر کرده است یا خیر استفاده می‌کنند.
اثرانگشت‌ها از موارد زیر ساخته می‌شوند:
.IP \[bu] 2
اندازه
.IP \[bu] 2
زمان تغییر
.IP \[bu] 2
هش
.PP
در صورتی که برای شیء موجود باشند.
.PP
در برخی backendها، خواندن بعضی از این مشخصه‌ها کند است (نیاز به یک فراخوانی API اضافی برای هر شیء یا پردازش اضافی دارند).
.PP
برای نمونه، \f[V]hash\f[R] در backendهای \f[V]local\f[R] و \f[V]sftp\f[R] کند است زیرا باید کل فایل را بخوانند و هش آن را محاسبه کنند؛ همچنین \f[V]modtime\f[R] در backendهای \f[V]s3\f[R]، \f[V]swift\f[R]، \f[V]ftp\f[R] و \f[V]qinqstor\f[R] کند است زیرا برای دریافت آن نیاز به فراخوانی API اضافی دارند.
.PP
اگر از پرچم \f[V]--vfs-fast-fingerprint\f[R] استفاده کنید، rclone عملیات‌های کند را در اثرانگشت لحاظ نمی‌کند.
این کار دقت اثرانگشت‌گذاری را کاهش می‌دهد اما بسیار سریع‌تر بوده و زمان باز شدن فایل‌های کَش‌شده را بهبود می‌بخشد.
.PP
اگر یک کَش vfs را روی backendهای \f[V]local\f[R]، \f[V]s3\f[R] یا \f[V]swift\f[R] اجرا می‌کنید، استفاده از این پرچم توصیه می‌شود.
.PP
توجه داشته باشید که اگر مقدار این پرچم را تغییر دهید، ممکن است اثرانگشت فایل‌های موجود در کَش نامعتبر شده و نیاز به بارگیری مجدد فایل‌ها باشد..SS خواندن تکه‌ای در VFS (VFS Chunked Reading)
.PP
هنگامی که rclone فایل‌ها را از یک ریموت می‌خواند، آن‌ها را به‌صورت تکه‌ای (chunk) دریافت می‌کند.
بدین معنا که rclone به‌جای درخواست کل فایل، تکه مشخص‌شده را درخواست می‌کند.
این امر می‌تواند با درخواست تنها آن تکه‌هایی از ریموت که واقعاً خوانده می‌شوند، سهمیه دانلود مصرفی را برای برخی ریموت‌ها کاهش دهد؛ هرچند این کار به بهای افزایش تعداد درخواست‌ها تمام می‌شود.
.PP
این پرچم‌ها تکه‌تکه کردن را کنترل می‌کنند:
.IP
.nf
\f[C]
    --vfs-read-chunk-size SizeSuffix        خواندن اشیاء مبدأ به‌صورت تکه‌ای (پیش‌فرض 128M)
    --vfs-read-chunk-size-limit SizeSuffix  حداکثر اندازه دوبرابر شدن تکه (پیش‌فرض off)
    --vfs-read-chunk-streams int            تعداد جریان‌های موازی برای خواندن هم‌زمان
\f[R]
.fi
.PP
رفتار تکه‌بندی بسته به پارامتر
\f[V]--vfs-read-chunk-streams\f[R] متفاوت است.
.SS \f[V]--vfs-read-chunk-streams\f[R] == 0
.PP
دستور rclone خواندن را با تکه‌ای به اندازه
\f[V]--vfs-read-chunk-size\f[R] آغاز می‌کند و سپس با هر بار خواندن، اندازه آن را دو برابر می‌سازد.
هنگامی که \f[V]--vfs-read-chunk-size-limit\f[R] مشخص شده و بزرگ‌تر از
\f[V]--vfs-read-chunk-size\f[R] باشد، اندازه تکه برای هر فایلِ باز تنها تا زمانی دو برابر می‌شود که به مقدار مشخص‌شده برسد.
اگر این مقدار \[dq]off\[dq] باشد (که حالت پیش‌فرض است)، این محدودیت غیرفعال بوده و اندازه تکه بدون محدودیت رشد خواهد کرد.
.PP
با \f[V]--vfs-read-chunk-size 100M\f[R] و
\f[V]--vfs-read-chunk-size-limit 0\f[R] بخش‌های زیر بارگیری خواهند شد:
0-100M،‏ 100M-200M،‏ 200M-300M،‏ 300M-400M و به همین ترتیب.
هنگامی که \f[V]--vfs-read-chunk-size-limit 500M\f[R] مشخص شود، نتیجه به‌صورت
0-100M،‏ 100M-300M،‏ 300M-700M،‏ 700M-1200M،‏ 1200M-1700M و غیره خواهد بود.
.PP
تنظیم \f[V]--vfs-read-chunk-size\f[R] روی \f[V]0\f[R] یا \[dq]off\[dq]
خواندن تکه‌ای را غیرفعال می‌کند.
.PP
تکه‌ها در حافظه بافر نخواهند شد.
.SS \f[V]--vfs-read-chunk-streams\f[R] > 0
.PP
دستور rclone به تعداد \f[V]--vfs-read-chunk-streams\f[R] تکه با اندازه
\f[V]--vfs-read-chunk-size\f[R] را به‌صورت هم‌روند می‌خواند.
اندازه تکه برای هر بار خواندن ثابت باقی خواهد ماند.
.PP
این ویژگی کارایی را در پیوندهای با تأخیر زیاد یا پیوندهای با پهنای باند بسیار بالا به ذخیره‌سازهای شیء با عملکرد بالا، به شدت بهبود می‌بخشد.
.PP
برای یافتن مقادیر بهینه \f[V]--vfs-read-chunk-size\f[R] و
\f[V]--vfs-read-chunk-streams\f[R] به مقداری آزمون و خطا نیاز است،
چرا که این مقادیر به backend مورد استفاده و تأخیر دسترسی به آن بستگی دارند.
.PP
برای ذخیره‌سازهای شیء با کارایی بالا (مانند AWS S3)، یک نقطه شروع مناسب می‌تواند
\f[V]--vfs-read-chunk-streams 16\f[R] و \f[V]--vfs-read-chunk-size 4M\f[R] باشد.
در آزمایش‌های انجام‌شده با AWS S3، مقیاس‌پذیری کارایی تقریباً متناسب با تنظیم
\f[V]--vfs-read-chunk-streams\f[R] افزایش یافته است.
.PP
تنظیمات مشابه باید برای پیوندهای با تأخیر بالا نیز مناسب باشد، اما بسته به میزان تأخیر، ممکن است برای دستیابی به توان عملیاتی مطلوب به مقدار بیشتری از
\f[V]--vfs-read-chunk-streams\f[R] نیاز باشد.
.SS کارایی VFS (VFS Performance)
.PP
این پرچم‌ها ممکن است برای فعال یا غیرفعال کردن ویژگی‌های VFS به دلایل کارایی یا موارد دیگر استفاده شوند.
همچنین ویژگی خواندن تکه‌ای را ببینید.
.PP
به‌ویژه S3 و Swift از پرچم \f[V]--no-modtime\f[R] (یا استفاده از
\f[V]--use-server-modtime\f[R] برای اثری اندکی متفاوت) سود بسیار زیادی می‌برند،
زیرا هر بار خواندن زمان تغییر فایل، نیازمند یک تراکنش است.
.IP
.nf
\f[C]
    --no-checksum     عدم مقایسه چک‌سام‌ها در بارگذاری/دانلود.
    --no-modtime      عدم خواندن/نوشتن زمان ویرایش (می‌تواند سرعت را افزایش دهد).
    --no-seek         عدم اجازه پیمایش (seek) در فایل‌ها.
    --read-only       تنها اجازه دسترسی فقط‌خواندنی.
\f[R]
.fi
.PP
گاهی اوقات عملیات خواندن یا نوشتن خارج از ترتیب به rclone تحویل داده می‌شوند.
دستور rclone به‌جای انجام پیمایش (seek)، مدت کوتاهی منتظر می‌ماند تا عملیات خواندن یا نوشتنِ مرتب در نوبت خود دریافت شود.
این پرچم‌ها تنها زمانی اثرگذار هستند که از فایل کش روی دیسک استفاده نشود.
.IP
.nf
\f[C]
    --vfs-read-wait duration   مدت زمان انتظار برای خواندن مرتب پیش از پیمایش (پیش‌فرض 20ms)
    --vfs-write-wait duration  مدت زمان انتظار برای نوشتن مرتب پیش از اعلام خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
هنگام استفاده از کش نوشتن VFS (\f[V]--vfs-cache-mode\f[R] با مقدار
writes یا full)، پرچم سراسری \f[V]--transfers\f[R] می‌تواند برای تنظیم
تعداد بارگذاری‌های موازی فایل‌های تغییریافته از کش تنظیم شود (پرچم سراسری مرتبط
\f[V]--checkers\f[R] بر روی VFS بی‌تأثیر است).
.IP
.nf
\f[C]
    --transfers int  تعداد انتقال‌های هم‌زمان فایل برای اجرا (پیش‌فرض 4)
\f[R]
.fi.SS "پیوندهای نمادین (Symlinks)"
.PP
به‌طور پیش‌فرض VFS از پیوندهای نمادین (symlinks) پشتیبانی نمی‌کند.
با این حال، این قابلیت می‌تواند با هر یک از پرچم‌های زیر فعال شود:
.IP
.nf
\f[C]
    --links      تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq].
    --vfs-links  تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
\f[R]
.fi
.PP
از آنجا که بیشتر سیستم‌های ذخیره‌سازی ابری مستقیماً از پیوندهای نمادین پشتیبانی نمی‌کنند، rclone
پیوند نمادین را به‌صورت یک فایل عادی با پسوندی ویژه ذخیره می‌کند.
بنابراین فایلی که به‌صورت یک پیوند نمادین \f[V]link-to-file.txt\f[R] دیده می‌شود،
روی فضای ابری به‌صورت \f[V]link-to-file.txt.rclonelink\f[R] ذخیره خواهد شد
و محتوای آن مسیر مقصد پیوند نمادین خواهد بود.
.PP
توجه داشته باشید که \f[V]--links\f[R] تبدیل پیوند نمادین را به‌صورت سراسری در
rclone فعال می‌کند \- این شامل هر backend که از این مفهوم پشتیبانی کند (برای
نمونه backend محلی) می‌شود.
\f[V]--vfs-links\f[R] آن را تنها برای لایهٔ VFS فعال می‌سازد.
.PP
این طرح با روش مورد استفاده توسط backend محلی با پرچم
--local-links سازگار است (https://rclone.org/local/#symlinks-junction-points).
.PP
پرچم \f[V]--vfs-links\f[R] برای
\f[V]rclone mount\f[R]، \f[V]rclone nfsmount\f[R] و
\f[V]rclone serve nfs\f[R] طراحی شده است.
.PP
این پرچم هنوز با سایر دستورهای \f[V]rclone serve\f[R] آزمایش
نشده است.
.PP
یکی از محدودیت‌های پیاده‌سازی فعلی این است که انتظار دارد فراخواننده
پیوندهای نمادین فرعی (sub-symlinks) را تحلیل (resolve) کند.
برای نمونه، درخت دایرکتوری زیر را در نظر بگیرید:
.IP
.nf
\f[C]
\&.
├── dir
│\ \  └── file.txt
└── linked-dir -> dir
\f[R]
.fi
.PP
لایهٔ VFS مورد \f[V]linked-dir\f[R] را به‌درستی تحلیل می‌کند، اما
\f[V]linked-dir/file.txt\f[R] را خیر.
این موضوع برای دستورهای آزمایش‌شده مشکلی نیست اما ممکن است برای
سایر دستورها مشکل‌ساز باشد.
.PP
\f[B]توجه\f[R] داشته باشید که یک مشکل باز در زمینهٔ پشتیبانی از پیوندهای نمادین وجود دارد:
گزارش اشکال #8245 (https://github.com/rclone/rclone/issues/8245) مبنی بر اینکه
هنگام انتقال پیوندهای نمادین به دایرکتوری‌هایی که فایلی با همان نام در آن‌ها وجود دارد
(یا برعکس)، فایل‌های تکراری ایجاد می‌شوند.
.SS "حساسیت VFS به بزرگی و کوچکی حروف (VFS Case Sensitivity)"
.PP
سیستم‌های فایل لینوکس به بزرگی و کوچکی حروف حساس هستند (case-sensitive): دو فایل
می‌توانند تنها در بزرگی و کوچکی حروف تفاوت داشته باشند، و هنگام باز کردن فایل
باید دقیقاً از همان حالت حروف استفاده شود.
.PP
سیستم‌های فایل در نسخه‌های نوین ویندوز به بزرگی و کوچکی حروف حساس نیستند اما حالت حروف را حفظ می‌کنند (case-preserving):
هرچند فایل‌های موجود را می‌توان با هر حالتی از حروف باز کرد، اما حالت دقیق
حروفی که برای ساخت فایل استفاده شده ذخیره می‌شود و برای برنامه‌ها قابل
پرس‌وجو است.
وجود دو فایل در یک دایرکتوری یکسان که تفاوت آن‌ها تنها در بزرگی و کوچکی حروف
باشد، مجاز نیست.
.PP
معمولاً سیستم‌های فایل در macOS به بزرگی و کوچکی حروف حساس نیستند.
امکان حساس کردن سیستم‌های فایل macOS به بزرگی و کوچکی حروف وجود دارد اما
حالت پیش‌فرض نیست.
.PP
پرچم VFS به نام \f[V]--vfs-case-insensitive\f[R] نحوهٔ مدیریت این دو حالت را توسط rclone
کنترل می‌کند.
اگر مقدار آن \[dq]false\[dq] باشد، rclone نام فایل‌ها را همان‌گونه که هست به remote
ارسال می‌کند.
اگر پرچم \[dq]true\[dq] باشد (یا بدون مقدار در خط فرمان مشخص شود)،
rclone ممکن است همان‌طور که در ادامه توضیح داده شده، عملیات \[dq]اصلاح\[dq] (fixup) را انجام دهد.
.PP
کاربر ممکن است نام فایلی را برای باز کردن/حذف/تغییر نام/غیره با حالتی از حروف
متفاوت از آنچه روی remote ذخیره شده مشخص کند.
اگر آرگومان به فایلی موجود با دقیقاً همان نام اشاره داشته باشد،
حالت حروف فایل موجود روی دیسک استفاده خواهد شد.
با این حال، اگر نام فایلی با همان نام دقیق یافت نشود ولی نامی وجود داشته باشد
که تفاوت آن تنها در بزرگی و کوچکی حروف است، rclone به‌طور شفاف نام را اصلاح می‌کند.
این اصلاح تنها زمانی رخ می‌دهد که یک فایل از پیش موجود درخواست شده باشد.
حساسیت به بزرگی و کوچکی حروف برای نام فایل‌هایی که به‌تازگی توسط rclone ایجاد می‌شوند
توسط remote زیرین کنترل می‌شود.
.PP
توجه داشته باشید که حساسیت به بزرگی و کوچکی حروف در سیستم‌عامل اجراکنندهٔ rclone (مقصد)
ممکن است با حساسیت سیستم فایل ارائه‌شده توسط rclone (مبدأ) متفاوت باشد.
این پرچم مشخص می‌کند که آیا عملیات \[dq]اصلاح\[dq] برای برآورده ساختن الزامات مقصد
انجام شود یا خیر.
.PP
اگر پرچم در خط فرمان مشخص نشود، مقدار پیش‌فرض آن به سیستم‌عاملی که rclone روی آن
اجرا می‌شود بستگی دارد: در ویندوز و macOS مقدار \[dq]true\[dq]، و در غیر این صورت \[dq]false\[dq].
اگر پرچم بدون مقدار ارائه شود، برابر با \[dq]true\[dq] خواهد بود.
.PP
پرچم \f[V]--no-unicode-normalization\f[R] کنترل می‌کند که آیا عملیات \[dq]اصلاح\[dq]
مشابهی برای نام‌فایل‌هایی که تفاوت دارند اما از نظر یونیکد هم‌ارز رسمی
(canonically equivalent) هستند (https://en.wikipedia.org/wiki/Unicode_equivalence)، انجام شود یا خیر.
یکسان‌سازی یونیکد (Unicode normalization) می‌تواند به‌ویژه برای کاربران macOS که
فرم NFD را به فرم NFC استفاده‌شده در بیشتر پلتفرم‌های دیگر ترجیح می‌دهد، مفید باشد.
بنابراین، برای جلوگیری از مشکلات سازگاری در کدگذاری، اکیداً توصیه می‌شود که مقدار
پیش‌فرض \f[V]false\f[R] در macOS حفظ شود.
.PP
در شرایط (احتمالاً نادر) وجود چند نام‌فایل تکراری در یک دایرکتوری پس از اعمال یکسان‌سازی
حالت حروف و یونیکد، پرچم \f[V]--vfs-block-norm-dupes\f[R] امکان پنهان‌سازی این موارد تکراری را
فراهم می‌آورد.
این کار با کاهش کارایی همراه است، چرا که rclone هنگام فهرست‌کردن یک دایرکتوری
باید کل آن را برای یافتن موارد تکراری پویش (scan) کند.
به همین دلیل، توصیه می‌شود در صورت عدم نیاز، این گزینه غیرفعال بماند.
با این وجود، کاربران macOS ممکن است استفاده از آن را مد نظر قرار دهند؛ چرا که در غیر این صورت،
اگر یک دایرکتوری remote هم نسخه‌های NFC و هم NFD از یک نام‌فایل یکسان را داشته باشد،
شرایط عجیبی رخ خواهد داد: هر دو نسخهٔ فایل در نقطهٔ mount قابل مشاهده خواهند بود و
به نظر می‌رسد هر دو قابل ویرایش هستند، اما در عمل ویرایش هر یک از نسخه‌ها در پس‌زمینه
تنها به ویرایش نسخهٔ NFD منجر می‌شود.
\f[V]--vfs-block-norm-dupes\f[R] با شناسایی این وضعیت، پنهان کردن موارد تکراری
و ثبت یک خطا در گزارش‌ها، مشابه آنچه در \f[V]rclone sync\f[R] مدیریت می‌شود،
از بروز این سردرگمی جلوگیری می‌کند..SS گزینه‌های دیسک VFS (VFS Disk Options)
.PP
این گزینه به شما اجازه می‌دهد آمارهای مربوط به سیستم‌فایل را به صورت دستی
تنظیم کنید.
این ویژگی می‌تواند زمانی مفید باشد که نتوان این آمار را به صورت خودکار
و درست خواند.
.IP
.nf
\f[C]
    --vfs-disk-space-total-size    تنظیم دستی اندازه کل فضای دیسک (مثال: 256G، پیش‌فرض: -1)
\f[R]
.fi
.SS گزارش جایگزین از بایت‌های استفاده‌شده (Alternate report of used bytes)
.PP
برخی از backendها، به‌ویژه S3، مقدار بایت‌های استفاده‌شده را گزارش نمی‌کنند.
اگر نیاز دارید که این اطلاعات هنگام اجرای \f[V]df\f[R]
روی سیستم‌فایل در دسترس باشد، پرچم \f[V]--vfs-used-is-size\f[R] را به
rclone پاس دهید.
با تنظیم این پرچم، rclone به جای اتکا به backend برای گزارش این
اطلاعات، کل remote را مشابه با
\f[V]rclone size\f[R] پویش کرده و کل فضای استفاده‌شده را خودش محاسبه می‌کند.
.PP
\f[B]هشدار\f[R]: بر خلاف \f[V]rclone size\f[R]، این پرچم فیلترها را نادیده
می‌گیرد تا نتیجه دقیق باشد.
با این حال، این کار بسیار ناکارآمد است و ممکن است فراخوانی‌های API زیادی
مصرف کند که به هزینه‌های اضافی منجر شود.
تنها به عنوان آخرین راهکار و فقط همراه با کش‌کردن از آن استفاده کنید.
.SS متادیتای VFS (VFS Metadata)
.PP
اگر از پرچم \f[V]--vfs-metadata-extension\f[R] استفاده کنید، می‌توانید کاری کنید که
VFS فایل‌هایی را که حاوی
متادیتا (<https://rclone.org/docs/#metadata>) هستند به صورت یک شیء JSON نمایان سازد.
این فایل‌ها در فهرست دایرکتوری ظاهر نخواهند شد، اما می‌توان روی آن‌ها
\f[V]stat\f[R] گرفت و آن‌ها را باز کرد؛ و به محض این‌که باز شدند، تا زمان منقضی شدن کش دایرکتوری در فهرست‌های دایرکتوری ظاهر \f[B]خواهند شد\f[R].
.PP
توجه داشته باشید که برخی backendها متادیتا ایجاد نمی‌کنند مگر این‌که پرچم
\f[V]--metadata\f[R] را ارسال کنید.
.PP
به عنوان مثال، با استفاده از \f[V]rclone mount\f[R] به همراه
\f[V]--metadata --vfs-metadata-extension .metadata\f[R] خواهیم داشت:
.IP
.nf
\f[C]
$ ls -l /mnt/
total 1048577
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G

$ cat /mnt/1G.metadata
{
        \[dq]atime\[dq]: \[dq]2025-03-04T17:34:22.317069787Z\[dq],
        \[dq]btime\[dq]: \[dq]2025-03-03T16:03:37.708253808Z\[dq],
        \[dq]gid\[dq]: \[dq]1000\[dq],
        \[dq]mode\[dq]: \[dq]100664\[dq],
        \[dq]mtime\[dq]: \[dq]2025-03-03T16:03:39.640238323Z\[dq],
        \[dq]uid\[dq]: \[dq]1000\[dq]
}

$ ls -l /mnt/
total 1048578
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G
-rw-rw-r-- 1 user user        185 Mar  3 16:03 1G.metadata
\f[R]
.fi
.PP
اگر فایل فاقد متادیتا باشد، به صورت \f[V]{}\f[R] بازگردانده می‌شود و در صورت
بروز خطا در خواندن متادیتا، خطا به صورت
\f[V]{\[dq]error\[dq]:\[dq]error string\[dq]}\f[R] بازگردانده خواهد شد.
.IP
.nf
\f[C]
rclone mount remote:path /path/to/mountpoint [flags]
\f[R]
.fi
.SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
      --allow-idmap                            اجازه دادن به اتصال‌های id-mapped (فقط Linux 6.12+ و mount2)
      --allow-non-empty                        اجازه اتصال روی یک دایرکتوری غیرخالی (در Windows پشتیبانی نمی‌شود)
      --allow-other                            اجازه دسترسی به سایر کاربران (در Windows پشتیبانی نمی‌شود)
      --allow-root                             اجازه دسترسی به کاربر root (در Windows پشتیبانی نمی‌شود)
      --async-read                             استفاده از خواندن‌های ناهمگام (در Windows پشتیبانی نمی‌شود) (پیش‌فرض true)
      --attr-timeout Duration                  مدت زمانی که ویژگی‌های فایل/دایرکتوری کش می‌شوند (پیش‌فرض 1s)
      --daemon                                 اجرای mount در پس‌زمینه و خروج از فرآیند والد (از آنجا که خروجی پس‌زمینه سرکوب می‌شود، از --log-file با --log-format=pid,... برای نظارت استفاده کنید) (در Windows پشتیبانی نمی‌شود)
      --daemon-timeout Duration                محدودیت زمانی برای پاسخ‌دهی rclone به هسته (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 0s)
      --daemon-wait Duration                   مدت زمان انتظار برای اتصال آماده از دیمن (حداکثر زمان در Linux، زمان خواب ثابت در OSX/BSD) (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1m0s)
      --debug-fuse                             اشکال‌زدایی بخش‌های داخلی FUSE - نیازمند -v
      --default-permissions                    وادار کردن هسته به اعمال کنترل دسترسی بر اساس حالت فایل (در Windows پشتیبانی نمی‌شود)
      --devname string                         تنظیم نام دستگاه - پیش‌فرض remote:path است
      --dir-cache-time Duration                مدت زمان کش کردن مدخل‌های دایرکتوری (پیش‌فرض 5m0s)
      --dir-perms FileMode                     مجوزهای دایرکتوری (پیش‌فرض 777)
      --direct-io                              استفاده از Direct IO، کش کردن داده‌ها را غیرفعال می‌کند
      --file-perms FileMode                    مجوزهای فایل (پیش‌فرض 666)
      --fuse-flag stringArray                  پرچم‌ها یا آرگومان‌هایی که مستقیماً به libfuse/WinFsp فرستاده می‌شوند (در صورت نیاز تکرار شود)
      --gid uint32                             بازنویسی فیلد gid تنظیم‌شده توسط سیستم‌فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1000)
  -h, --help                                   راهنما برای mount
      --link-perms FileMode                    مجوزهای پیوند (پیش‌فرض 666)
      --max-read-ahead SizeSuffix              تعداد بایت‌هایی که می‌توان برای خواندن‌های متوالی پیش‌واکشی کرد (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 128Ki)
      --mount-case-insensitive Tristate        اعلام به سیستم‌عامل مبنی بر این‌که اتصال به حروف کوچک و بزرگ حساس نیست (true) یا حساس است (false) صرف‌نظر از backend (مقدار auto) (پیش‌فرض unset)
      --network-mode                           اتصال به عنوان درایو شبکه راه دور، به جای درایو دیسک ثابت (فقط در Windows پشتیبانی می‌شود)
      --no-checksum                            عدم مقایسه چکسام‌ها هنگام بارگذاری/بارگیری
      --no-modtime                             عدم خواندن/نوشتن زمان اصلاح (می‌تواند کارها را سرعت ببخشد)
      --no-seek                                عدم اجازه seek در فایل‌ها
      --noappledouble                          نادیده گرفتن فایل‌های Apple Double (._) و .DS_Store (فقط در OSX پشتیبانی می‌شود) (پیش‌فرض true)
      --noapplexattr                           نادیده گرفتن تمام ویژگی‌های توسعه‌یافته \[dq]com.apple.*\[dq] (فقط در OSX پشتیبانی می‌شود)
  -o, --option stringArray                     گزینه برای libfuse/WinFsp (در صورت نیاز تکرار شود)
      --poll-interval Duration                 زمان انتظار بین نظرسنجی‌ها برای تغییرات، باید کمتر از dir-cache-time باشد و فقط روی remoteهای پشتیبانی‌شده (تنظیم 0 برای غیرفعال‌سازی) (پیش‌فرض 1m0s)
      --read-only                              تنها اجازه دسترسی فقط‌خواندنی
      --uid uint32                             بازنویسی فیلد uid تنظیم‌شده توسط سیستم‌فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1000)
      --umask FileMode                         بازنویسی بیت‌های مجوز تنظیم‌شده توسط سیستم‌فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 002)
      --vfs-block-norm-dupes                   اگر نام‌های فایل تکراری در همان دایرکتوری (پس از یکسان‌سازی) وجود داشته باشد، خطا ثبت شده و موارد تکراری پنهان می‌شوند (ممکن است افت کارایی داشته باشد)
      --vfs-cache-max-age Duration             حداکثر زمان از آخرین دسترسی به اشیاء در کش (پیش‌فرض 1h0m0s)
      --vfs-cache-max-size SizeSuffix          حداکثر اندازه کل اشیاء موجود در کش (پیش‌فرض off)
      --vfs-cache-min-free-space SizeSuffix    حداقل فضای خالی هدف روی دیسک حاوی کش (پیش‌فرض off)
      --vfs-cache-mode CacheMode               حالت کش off|minimal|writes|full (پیش‌فرض off)
      --vfs-cache-poll-interval Duration       بازه زمانی نظرسنجی کش برای یافتن اشیاء کهنه (پیش‌فرض 1m0s)
      --vfs-case-insensitive                   در صورت پیدا نشدن نام فایل، یافتن تطابق غیرحساس به حروف کوچک و بزرگ
      --vfs-disk-space-total-size SizeSuffix   مشخص کردن کل فضای دیسک (پیش‌فرض off)
      --vfs-fast-fingerprint                   استفاده از اثرانگشت‌های سریع (با دقت کمتر) برای تشخیص تغییرات
      --vfs-handle-caching Duration            مدت زمان زنده نگه‌داشتن دسته فایل (file handle) و بارگیری‌کننده‌ها پس از آخرین بستن (پیش‌فرض 5s)
      --vfs-links                              ترجمه پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
      --vfs-metadata-extension string          تنظیم پسوند برای خواندن متادیتا از آن
      --vfs-read-ahead SizeSuffix              پیش‌واکشی اضافی فراتر از --buffer-size هنگام استفاده از cache-mode full
      --vfs-read-chunk-size SizeSuffix         خواندن اشیاء مبدأ به صورت تکه‌ای (chunk) (پیش‌فرض 128Mi)
      --vfs-read-chunk-size-limit SizeSuffix   در صورت بزرگ‌تر بودن از --vfs-read-chunk-size، اندازه تکه پس از هر بار خواندن دو برابر می‌شود تا به این حد برسد (\[aq]off\[aq] نامحدود است) (پیش‌فرض off)
      --vfs-read-chunk-streams int             تعداد جریان‌های موازی برای خواندن هم‌زمان
      --vfs-read-wait Duration                 مدت زمان انتظار برای خواندن متوالی قبل از seek کردن (پیش‌فرض 20ms)
      --vfs-refresh                            تازه‌سازی بازگشتی کش دایرکتوری در پس‌زمینه هنگام شروع
      --vfs-used-is-size rclone size           استفاده از الگوریتم rclone size برای اندازه Used
      --vfs-write-back Duration                مدت زمان پس‌نویسی فایل‌ها پس از آخرین استفاده هنگام به‌کارگیری کش (پیش‌فرض 5s)
      --vfs-write-wait Duration                مدت زمان انتظار برای نوشتن متوالی پیش از اعلام خطا (پیش‌فرض 1s)
      --volname string                         تنظیم نام حجم (فقط در Windows و OSX پشتیبانی می‌شود)
      --write-back-cache                       وادار کردن هسته به بافر کردن نوشتن‌ها پیش از ارسال آن‌ها به rclone (بدون این، از کش writethrough استفاده می‌شود) (در Windows پشتیبانی نمی‌شود)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (<https://rclone.org/flags>) را ببینید..SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌هایی برای فیلتر کردن فهرست‌های دایرکتوری
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از \- برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام‌فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل مبدأ از فایل (استفاده از \- برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل مبدأ از فایل بدون هیچ پردازشی روی خطوط (استفاده از \- برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (استفاده از \- برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قاعده فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (استفاده از \- برای خواندن از stdin)
      --hash-filter string                  افرازبندی نام فایل‌ها با هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از \- برای خواندن از stdin)
      --max-age Duration                    فقط انتقال فایل‌های جدیدتر از این مقدار برحسب s یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض \-1)
      --max-size SizeSuffix                 فقط انتقال فایل‌های کوچک‌تر از این مقدار برحسب KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض غیرفعال)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (استفاده از \- برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قاعده فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متاداده از یک فایل (استفاده از \- برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از فایل (استفاده از \- برای خواندن از stdin)
      --min-age Duration                    فقط انتقال فایل‌های قدیمی‌تر از این مقدار برحسب s یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --min-size SizeSuffix                 فقط انتقال فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض غیرفعال)
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone moveto
.PP
انتقال فایل یا دایرکتوری از مبدأ به مقصد.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
اگر source:path یک فایل یا دایرکتوری باشد، آن را به یک فایل یا
دایرکتوری با نام dest:path منتقل می‌کند.
.PP
این دستور می‌تواند برای تغییر نام فایل‌ها یا بارگذاری فایل‌های تکی با نامی
غیر از نام فعلی آن‌ها استفاده شود.
اگر مبدأ یک دایرکتوری باشد، دقیقاً مانند دستور
move (https://rclone.org/commands/rclone_move) عمل می‌کند.
.PP
بنابراین:
.IP
.nf
\f[C]
rclone moveto src dst
\f[R]
.fi
.PP
که در آن src و dst مسیرهای rclone هستند، چه به‌صورت remote:path یا /path/to/local
یا C:.
.PP
عملکرد این دستور بدین صورت خواهد بود:
.IP
.nf
\f[C]
اگر src فایل باشد
    آن را به dst منتقل می‌کند و در صورت وجود فایل فعلی، آن را بازنویسی می‌کند
اگر src دایرکتوری باشد
    آن را به dst منتقل می‌کند و در صورت وجود فایل‌های فعلی، آن‌ها را بازنویسی می‌کند
    برای جزئیات کامل به دستور move مراجعه کنید
\f[R]
.fi
.PP
این دستور فایل‌هایی را که بر اساس اندازه و زمان ویرایش یا MD5SUM در src و dst یکسان هستند منتقل نمی‌کند.
پس از انتقال موفقیت‌آمیز، src حذف خواهد شد.
.PP
\f[B]مهم\f[R]: از آنجا که این کار می‌تواند موجب از دست رفتن داده‌ها شود، ابتدا با پرچم
\f[V]--dry-run\f[R] یا \f[V]--interactive\f[R]/\f[V]-i\f[R] آزمایش کنید.
.PP
\f[B]نکته\f[R]: از پرچم \f[V]-P\f[R]/\f[V]--progress\f[R] برای مشاهده
آمار لحظه‌ای انتقال استفاده کنید..SS پرچم‌های لاگر (Logger Flags)
.PP
پرچم‌های \f[V]--differ\f[R]، \f[V]--missing-on-dst\f[R]،
\f[V]--missing-on-src\f[R]، \f[V]--match\f[R] و \f[V]--error\f[R]
مسیرها را، در هر سطر یک مورد، در نام فایل داده‌شده (یا اگر
\f[V]-\f[R] باشد در stdout) می‌نویسند.
آنچه آن‌ها می‌نویسند در راهنمای زیر شرح داده شده است.
برای نمونه، \f[V]--differ\f[R] تمام مسیرهایی را که هم در مبدأ
و هم در مقصد موجودند اما تفاوت دارند، می‌نویسد.
.PP
پرچم \f[V]--combined\f[R] فایلی (یا در stdout) می‌نویسد که
شامل تمام مسیرهای فایل به همراه یک نماد، سپس یک فاصله (space) و در ادامه مسیر است
تا مشخص کند چه اتفاقی برای آن افتاده است.
این خروجی یادآور فایل‌های diff است.
.IP \[bu] 2
\f[V]= path\f[R] یعنی مسیر در مبدأ و مقصد پیدا شد و یکسان بود
.IP \[bu] 2
\f[V]- path\f[R] یعنی مسیر در مبدأ موجود نبود، بنابراین فقط در مقصد وجود دارد
.IP \[bu] 2
\f[V]+ path\f[R] یعنی مسیر در مقصد موجود نبود، بنابراین فقط در مبدأ وجود دارد
.IP \[bu] 2
\f[V]* path\f[R] یعنی مسیر در مبدأ و مقصد موجود بود اما تفاوت داشت.
.IP \[bu] 2
\f[V]! path\f[R] یعنی در خواندن یا درهم‌سازی (هش کردن) مبدأ یا مقصد خطایی رخ داده است.
.PP
پرچم \f[V]--dest-after\f[R] یک فایل فهرست را با استفاده از همان پرچم‌های قالب‌بندی
\f[V]lsf\f[R] (https://rclone.org/commands/rclone_lsf/#synopsis)
می‌نویسد
(شامل گزینه‌های قابل سفارشی‌سازی برای hash، modtime
و غیره (https://rclone.org/commands/rclone_lsf/#synopsis)). از نظر مفهومی شبیه به گزینه
\f[V]--itemize-changes\f[R] در rsync است، اما یکسان نیست
\-\- این پرچم باید فهرستی دقیق از آنچه پس از پایان دستور در مقصد خواهد بود را خروجی دهد.
.PP
هنگامی که پرچم \f[V]--no-traverse\f[R] تنظیم شده باشد، تمام گزارش‌های مربوط به فایل‌هایی
که فقط در مقصد وجود دارند، ناقص بوده یا به‌طور کامل ثبت نخواهند شد.
.PP
توجه داشته باشید که این پرچم‌های لاگر محدودیت‌هایی دارند و سناریوهای
خاصی در حال حاضر پشتیبانی نمی‌شوند:
.IP \[bu] 2
\f[V]--max-duration\f[R] / \f[V]CutoffModeHard\f[R]
.IP \[bu] 2
\f[V]--compare-dest\f[R] / \f[V]--copy-dest\f[R]
.IP \[bu] 2
انتقال‌های سمت سرور برای یک دایرکتوری کامل به‌صورت یک‌جا
.IP \[bu] 2
تلاش‌های مجدد در سطح بالا (High-level retries)، زیرا موارد تکراری ایجاد خواهد شد (برای غیرفعال کردن از
\f[V]--retries 1\f[R] استفاده کنید)
.IP \[bu] 2
احتمالاً برخی سناریوهای خطای غیرعادی
.PP
همچنین توجه داشته باشید که هر فایل در حین اجرا ثبت می‌شود و نه پس از آن؛
بنابراین بیشترین کاربرد آن به عنوان پیش‌بینی‌کننده‌ای از آنچه «باید» برای هر فایل
رخ دهد است (که ممکن است با آنچه واقعاً رخ داده است مطابقت داشته باشد یا خیر).
.IP
.nf
\f[C]
rclone moveto source:path dest:path [flags]
\f[R]
.fi
.SS گزینه‌ها (Options)
.IP
.nf
\f[C]
      --absolute                قراردادن یک / در ابتدای نام مسیرها
      --combined string         ایجاد یک گزارش ترکیبی از تغییرات در این فایل
      --csv                     خروجی با قالب CSV
      --dest-after string       گزارش تمام فایل‌های موجود در مقصد پس از همگام‌سازی
      --differ string           گزارش تمام فایل‌های ناهمخوان در این فایل
  -d, --dir-slash               افزودن یک اسلش به نام‌های دایرکتوری (پیش‌فرض: true)
      --dirs-only               فقط فهرست‌کردن دایرکتوری‌ها
      --error string            گزارش تمام فایل‌های دارای خطا (درهم‌سازی یا خواندن) در این فایل
      --files-only              فقط فهرست‌کردن فایل‌ها (پیش‌فرض: true)
  -F, --format string           قالب خروجی - برای جزئیات راهنمای lsf را ببینید (پیش‌فرض: \[dq]p\[dq])
      --hash h                  استفاده از این هش هنگامی که h در قالب MD5|SHA-1|DropboxHash به کار رفته باشد (پیش‌فرض: \[dq]md5\[dq])
  -h, --help                    راهنمای moveto
      --match string            گزارش تمام فایل‌های همخوان در این فایل
      --missing-on-dst string   گزارش تمام فایل‌های ناموجود در مقصد در این فایل
      --missing-on-src string   گزارش تمام فایل‌های ناموجود در مبدأ در این فایل
  -s, --separator string        جداکننده موارد در قالب (پیش‌فرض: \[dq];\[dq])
  -t, --timeformat string       مشخص‌کردن یک قالب سفارشی زمان - برای جزئیات به مستندات مراجعه کنید (پیش‌فرض: 2006-01-02 15:04:05)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری
(https://rclone.org/flags) را ببینید..SS گزینه‌های کپی (Copy Options)
.PP
پرچم‌ها برای هر دستوری که می‌تواند فایلی را کپی کند
.IP
.nf
\f[C]
      --check-first                                 انجام تمام بررسی‌ها پیش از آغاز انتقال‌ها
  -c, --checksum                                    بررسی تغییرات با اندازه و checksum (در صورت دسترسی، یا بازگشت به اندازه به تنهایی)
      --compare-dest stringArray                    لحاظ کردن مسیرهای سمت سرور اضافی در طول مقایسه
      --copy-dest stringArray                       ضمن اعمال --compare-dest، فایل‌ها را از مسیرها به مقصد نیز کپی می‌کند
      --cutoff-mode HARD|SOFT|CAUTIOUS              حالت توقف انتقال‌ها پس از رسیدن به حد بیشینه انتقال HARD|SOFT|CAUTIOUS (پیش‌فرض HARD)
      --ignore-case-sync                            نادیده گرفتن بزرگی و کوچکی حروف هنگام همگام‌سازی
      --ignore-checksum                             صرف‌نظر از بررسی checksumها پس از کپی
      --ignore-existing                             صرف‌نظر از تمام فایل‌هایی که در مقصد وجود دارند
      --ignore-size                                 نادیده گرفتن اندازه هنگام صرف‌نظر کردن؛ استفاده از modtime یا checksum
  -I, --ignore-times                                عدم صرف‌نظر از مواردی که با اندازه و زمان همخوانی دارند \- انتقال همه بدون قید و شرط
      --immutable                                   عدم تغییر فایل‌ها؛ در صورت تغییر فایل‌های موجود، با خطا مواجه شود
      --inplace                                     دانلود مستقیم به فایل مقصد به جای دانلود اتمیک در فایل موقت/تغییر نام
  -l, --links                                       تبدیل symlinkها به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq]
      --max-backlog int                             بیشینه تعداد اشیاء در صف همگام‌سازی یا بررسی (پیش‌فرض 10000)
      --max-duration Duration                       بیشینه مدت زمانی که rclone داده‌ها را انتقال می‌دهد (پیش‌فرض 0s)
      --max-transfer SizeSuffix                     بیشینه حجم داده برای انتقال (پیش‌فرض off)
  -M, --metadata                                    در صورت تعیین، حفظ متادیتا هنگام کپی کردن اشیاء
      --modify-window Duration                      بیشینه اختلاف زمانی برای یکسان در نظر گرفتن فایل‌ها (پیش‌فرض 1ns)
      --multi-thread-chunk-size SizeSuffix          اندازه تکه (chunk) برای دانلود/آپلود چندرشته‌ای، اگر توسط سیستم‌فایل تعیین نشده باشد (پیش‌فرض 64Mi)
      --multi-thread-cutoff SizeSuffix              استفاده از دانلود چندرشته‌ای برای فایل‌های بزرگ‌تر از این اندازه (پیش‌فرض 256Mi)
      --multi-thread-streams int                    تعداد جریان‌ها (streams) برای دانلودهای چندرشته‌ای (پیش‌فرض 4)
      --multi-thread-write-buffer-size SizeSuffix   اندازه بافر درون‌حافظه‌ای برای نوشتن در حالت چندرشته‌ای (پیش‌فرض 128Ki)
      --name-transform stringArray                  تبدیل مسیرها در طول فرآیند کپی
      --no-check-dest                               بررسی نکردن مقصد، کپی در هر صورت انجام شود
      --no-traverse                                 عدم پیمایش سیستم‌فایل مقصد هنگام کپی
      --no-update-dir-modtime                       به‌روزرسانی نکردن زمان تغییر دایرکتوری‌ها
      --no-update-modtime                           به‌روزرسانی نکردن modtime مقصد در صورت یکسان بودن فایل‌ها
      --order-by string                             دستورالعمل‌ها برای نحوه مرتب‌سازی انتقال‌ها، مانند \[aq]size,descending\[aq]
      --partial-suffix string                       افزودن partial-suffix به نام فایل موقت هنگامی که --inplace استفاده نشده باشد (پیش‌فرض \[dq].partial\[dq])
      --refresh-times                               تازه‌سازی modtime فایل‌های ریموت
      --server-side-across-configs                  اجازه به عملیات‌های سمت سرور (مانند کپی) برای کار در میان پیکربندی‌های مختلف
      --size-only                                   صرف‌نظر کردن فقط بر اساس اندازه، نه modtime یا checksum
      --streaming-upload-cutoff SizeSuffix          حد آستانه برای تغییر به آپلود تکه‌ای اگر اندازه فایل نامشخص باشد؛ انتقال پس از رسیدن به آستانه یا اتمام فایل آغاز می‌شود (پیش‌فرض 100Ki)
  -u, --update                                      صرف‌نظر از فایل‌هایی که در مقصد جدیدتر هستند
\f[R]
.fi
.SS گزینه‌های مهم (Important Options)
.PP
پرچم‌های مهم و کاربردی برای بیشتر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ اطلاعات بسیار بیشتر (تکرار برای جزئیات بیشتر)
\f[R]
.fi
.SS گزینه‌های فیلتر (Filter Options)
.PP
پرچم‌هایی برای پالایش فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های مستثنا شده از همگام‌سازی در مقصد
      --exclude stringArray                 مستثنا کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از \- برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنا کردن دایرکتوری‌ها در صورت وجود داشتن filename
      --files-from stringArray              خواندن فهرست نام‌های فایل مبدأ از فایل (استفاده از \- برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل مبدأ از فایل بدون هیچ‌گونه پردازش روی خطوط (استفاده از \- برای stdin)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل مبدأ از فایل با استفاده از NUL به عنوان جداکننده (استفاده از \- برای stdin)
  -f, --filter stringArray                  افزودن یک قاعده پالایش فایل
      --filter-from stringArray             خواندن الگوهای پالایش فایل از یک فایل (استفاده از \- برای خواندن از stdin)
      --hash-filter string                  افرازبندی نام‌فایل‌ها بر اساس هش k/n یا به صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از \- برای خواندن از stdin)
      --max-age Duration                    فقط انتقال فایل‌های جدیدتر از این مقدار برحسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض \-1)
      --max-size SizeSuffix                 فقط انتقال فایل‌های کوچک‌تر از این مقدار برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض off)
      --metadata-exclude stringArray        مستثنا کردن متادیتای منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متادیتا از فایل (استفاده از \- برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قاعده پالایش متادیتا
      --metadata-filter-from stringArray    خواندن الگوهای پالایش متادیتا از یک فایل (استفاده از \- برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن متادیتای منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متادیتا از فایل (استفاده از \- برای خواندن از stdin)
      --min-age Duration                    فقط انتقال فایل‌های قدیمی‌تر از این مقدار برحسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض off)
      --min-size SizeSuffix                 فقط انتقال فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض off)
\f[R]
.fi.SS "گزینه‌های فهرست‌کردن (Listing Options)"
.PP
پرچم‌ها برای فهرست‌کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست بازگشتی در صورت در دسترس بودن؛ حافظه بیشتر اما تراکنش‌های کمتری مصرف می‌کند
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها،
پرچم‌ها و backendهای rclone.
.SH rclone ncdu
.PP
کاوش در یک remote با یک رابط کاربری مبتنی بر متن.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور یک رابط کاربری مبتنی بر متن را نمایش می‌دهد که امکان پیمایش در یک
remote را فراهم می‌کند.
این ابزار بیش از همه برای پاسخ به این پرسش مفید است \- \[dq]چه چیزی تمام فضای
دیسک من را مصرف کرده است؟\[dq].
.PP
برای ساخت رابط کاربری، ابتدا کل remote مشخص‌شده را پویش کرده و نمایشی
از آن در حافظه می‌سازد.
می‌توان در طول این مرحلهٔ پویش از rclone ncdu استفاده کرد و مشاهده خواهید کرد
که هم‌گام با پیشرفت کار، ساختار دایرکتوری را می‌سازد.
.PP
می‌توانید با فشردن کلیدها با رابط کاربری تعامل داشته باشید؛ برای روشن و
خاموش کردن راهنما \[aq]?\[aq] را فشار دهید.
کلیدهای پشتیبانی‌شده عبارتند از:
.IP
.nf
\f[C]
 ↑,↓ یا k,j برای حرکت
 →,l برای ورود
 ←,h برای بازگشت
 g تغییر وضعیت نمودار
 c تغییر وضعیت شمارش‌ها
 a تغییر وضعیت میانگین اندازه در دایرکتوری
 m تغییر وضعیت زمان ویرایش
 u تغییر وضعیت قالب خوانا برای انسان
 n,s,C,A,M مرتب‌سازی بر اساس name,size,count,asize,mtime
 d حذف فایل/دایرکتوری
 v انتخاب فایل/دایرکتوری
 V ورود به حالت انتخاب بصری
 D حذف فایل‌ها/دایرکتوری‌های انتخاب‌شده
 y کپی مسیر جاری به کلیپ‌بورد
 Y نمایش مسیر جاری
 \[ha]L نوسازی صفحه (رفع بهم‌ریختگی صفحه)
 r محاسبه مجدد اندازه فایل‌ها
 ? برای روشن و خاموش کردن راهنما
 ESC برای بستن جعبه منو
 q/\[ha]c برای خروج
\f[R]
.fi
.PP
فایل‌ها/دایرکتوری‌های فهرست‌شده ممکن است با یک پرچم تک‌نویسه‌ای پیشوند شوند،
که برخی از آن‌ها با توضیحی در کروشه در انتهای خط همراه هستند.
این پرچم‌ها معانی زیر را دارند:
.IP
.nf
\f[C]
e به این معنی است که این یک دایرکتوری خالی است، یعنی حاوی هیچ فایلی نیست (اما
  ممکن است شامل زیردایرکتوری‌های خالی باشد)
\[ti] به این معنی است که این دایرکتوری فایل‌هایی دارد (احتمالاً در
  زیردایرکتوری‌ها) با اندازه نامشخص، و بنابراین ممکن است اندازه دایرکتوری
  کمتر از مقدار واقعی تخمین زده شود (و اندازه میانگین نادقیق باشد، زیرا
  میانگین فایل‌هایی با اندازه مشخص است).
\&. به این معنی است که هنگام خواندن یک زیردایرکتوری خطایی رخ داده است، و
  بنابراین ممکن است اندازه دایرکتوری کمتر از مقدار واقعی تخمین زده شود (و
  اندازه میانگین نادقیق باشد)
! به این معنی است که هنگام خواندن این دایرکتوری خطایی رخ داده است
\f[R]
.fi
.PP
این دستور ادای احترامی به ابزار ncdu (https://dev.yorhel.nl/ncdu) است، اما
برای remoteهای rclone.
در حال حاضر فاقد بسیاری از ویژگی‌ها است، اما در وضعیت فعلی نیز بسیار کاربردی است.
برخلاف ncdu، فایل‌های استثناشده را نشان نمی‌دهد.
.PP
توجه داشته باشید که حذف فایل‌ها/دایرکتوری‌های بزرگ ممکن است مدتی طول بکشد.
رابط کاربری در این مدت پاسخگو نخواهد بود، زیرا عملیات حذف به‌صورت
هم‌گام انجام می‌شود.
.PP
برای فهرست‌کردن غیرتعاملی remote، دستور
tree (https://rclone.org/commands/rclone_tree) را ببینید.
صرفاً برای دریافت حجم کل remote نیز می‌توانید از دستور
size (https://rclone.org/commands/rclone_size) استفاده کنید.
.IP
.nf
\f[C]
rclone ncdu remote:path [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمایی برای ncdu
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای مشاهدهٔ گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (<https://rclone.org/flags>) را ببینید.
.SS "گزینه‌های پالایش (Filter Options)"
.PP
پرچم‌ها برای پالایش فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از - برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام فایل‌های مبدأ از فایل (استفاده از - برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از فایل بدون هیچ پردازشی روی خط‌ها (استفاده از - برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (استفاده از - برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قاعده پالایش فایل
      --filter-from stringArray             خواندن الگوهای پالایش فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --hash-filter string                  افراز نام فایل‌ها بر پایه هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف بزرگ و کوچک)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از - برای خواندن از stdin)
      --max-age Duration                    تنها انتقال فایل‌های تازه‌تر از این برحسب s یا پسوندهای ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --max-depth int                       در صورت تعیین، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 تنها انتقال فایل‌های کوچک‌تر از این برحسب KiB یا پسوندهای B|K|M|G|T|P (پیش‌فرض غیرفعال)
      --metadata-exclude stringArray        مستثنی کردن فراداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای فراداده از فایل (استفاده از - برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قاعده پالایش فراداده
      --metadata-filter-from stringArray    خواندن الگوهای پالایش فراداده از یک فایل (استفاده از - برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن فراداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول فراداده از فایل (استفاده از - برای خواندن از stdin)
      --min-age Duration                    تنها انتقال فایل‌های قدیمی‌تر از این برحسب s یا پسوندهای ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --min-size SizeSuffix                 تنها انتقال فایل‌های بزرگ‌تر از این برحسب KiB یا پسوندهای B|K|M|G|T|P (پیش‌فرض غیرفعال)
\f[R]
.fi
.SS "گزینه‌های فهرست‌کردن (Listing Options)"
.PP
پرچم‌ها برای فهرست کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت در دسترس بودن؛ حافظه بیشتر اما تراکنش‌های کمتری مصرف می‌کند
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (<https://rclone.org/commands/rclone>) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone nfsmount
.PP
سوار کردن ریموت به‌عنوان سیستم‌فایل بر روی یک نقطهٔ اتصال (mountpoint).
.SS "خلاصه دستور (SYNOPSIS)"
.PP
دستور rclone nfsmount به لینوکس، FreeBSD، macOS و ویندوز امکان می‌دهد تا هر یک از سامانه‌های ذخیره‌سازی ابری Rclone را با استفاده از FUSE به‌عنوان یک سیستم‌فایل متصل (mount) کنند.
.PP
ابتدا ریموت خود را با استفاده از \f[V]rclone config\f[R] پیکربندی کنید.
بررسی کنید که با دستورهایی مانند \f[V]rclone ls\f[R] به‌درستی کار کند.
.PP
در لینوکس و macOS، می‌توانید mount را در هر دو حالت پیش‌زمینه (foreground) یا پس‌زمینه (daemon) اجرا کنید.
عملیات mount به‌طور پیش‌فرض در حالت پیش‌زمینه اجرا می‌شود.
از پرچم \f[V]--daemon\f[R] برای اجبار به اجرا در حالت پس‌زمینه استفاده کنید.
در ویندوز تنها می‌توانید mount را در حالت پیش‌زمینه اجرا کنید و این پرچم نادیده گرفته می‌شود.
.PP
در حالت پس‌زمینه، rclone مانند یک برنامهٔ استاندارد mount یونیکس عمل می‌کند: برنامهٔ اصلی شروع به کار کرده، یک فرایند پس‌زمینهٔ rclone را برای راه‌اندازی و نگهداری mount ایجاد می‌کند، تا زمان موفقیت یا پایان مهلت زمانی (timeout) منتظر می‌ماند و با کد مناسب خارج می‌شود (و در صورت شکست، فرایند فرزند را می‌کشد).
.PP
در لینوکس/macOS/FreeBSD، اتصال را به این صورت آغاز کنید، که در آن
\f[V]/path/to/local/mount\f[R] یک دایرکتوری \f[B]خالی\f[R] و \f[B]موجود\f[R]
است:
.IP
.nf
\f[C]
rclone nfsmount remote:path/to/files /path/to/local/mount
\f[R]
.fi
.PP
در ویندوز می‌توانید اتصال را به روش‌های مختلفی آغاز کنید.
برای جزئیات به بخش‌های زیر مراجعه کنید.
اگر mount پیش‌زمینه به‌صورت تعاملی از یک پنجرهٔ کنسول استفاده شود، rclone
اتصال را ارائه کرده و کنسول را اشغال می‌کند؛ بنابراین تا زمان توقف rclone
(برای نمونه با فشردن Ctrl-C) باید از پنجرهٔ دیگری برای کار با مسیر متصل‌شده
استفاده شود.
.PP
مثال‌های زیر اتصال را به یک درایو تخصیص‌یافته به‌طور خودکار، به یک حرف درایو مشخص \f[V]X:\f[R]،
به مسیر \f[V]C:\[rs]path\[rs]parent\[rs]mount\f[R] (که در آن دایرکتوری والد یا
درایو باید موجود باشد، و mount باید وجود \f[B]نداشته\f[R] باشد، و هنگام اتصال
به‌عنوان درایو شبکه پشتیبانی نمی‌شود)، و مثال آخر اتصال به‌صورت اشتراک شبکهٔ
\f[V]\[rs]\[rs]cloud\[rs]remote\f[R] و نگاشت آن به یک درایو به‌طور خودکار تخصیص‌یافته
را نشان می‌دهند:
.IP
.nf
\f[C]
rclone nfsmount remote:path/to/files *
rclone nfsmount remote:path/to/files X:
rclone nfsmount remote:path/to/files C:\[rs]path\[rs]parent\[rs]mount
rclone nfsmount remote:path/to/files \[rs]\[rs]cloud\[rs]remote
\f[R]
.fi
.PP
هنگامی که برنامه در حالت پیش‌زمینه به پایان برسد، چه از طریق Ctrl+C و چه با دریافت
سیگنال SIGINT یا SIGTERM، اتصال باید به‌طور خودکار متوقف شود.
.PP
هنگام اجرا در حالت پس‌زمینه، کاربر باید اتصال را به‌صورت دستی متوقف کند:
.IP
.nf
\f[C]
# Linux
fusermount -u /path/to/local/mount
#... or on some systems
fusermount3 -u /path/to/local/mount
# OS X or Linux when using nfsmount
umount /path/to/local/mount
\f[R]
.fi
.PP
عملیات umount ممکن است با شکست مواجه شود، به‌عنوان نمونه هنگامی که نقطهٔ اتصال مشغول باشد.
در چنین حالتی، مسئولیت متوقف کردن دستی اتصال بر عهدهٔ کاربر خواهد بود.
.PP
اندازهٔ سیستم‌فایل سوارشده بر اساس اطلاعات دریافت‌شده از ریموت تنظیم خواهد شد؛
مشابه مقداری که توسط دستور
rclone about (<https://rclone.org/commands/rclone_about>)
بازگردانده می‌شود.
ریموت‌های دارای فضای ذخیره‌سازی نامحدود ممکن است تنها فضای مصرف‌شده را گزارش دهند،
که در این صورت 1 PiB فضای آزاد اضافی برای آن در نظر گرفته می‌شود.
اگر ریموت اصلاً از ویژگی about پشتیبانی نکند (<https://rclone.org/overview/#optional-features>)،
مقدار 1 PiB هم به‌عنوان اندازهٔ کل و هم اندازهٔ آزاد در نظر گرفته می‌شود..SS "نصب در ویندوز (Installing on Windows)"
.PP
برای اجرای \f[V]rclone nfsmount on Windows\f[R]، باید WinFsp (https://winfsp.dev) را بارگیری و نصب کنید.
.PP
پروژهٔ WinFsp (https://github.com/winfsp/winfsp) یک پروکسی متن‌باز فایل‌سیستم ویندوز (Windows File System Proxy) است که نوشتن سیستم‌های فایل در فضای کاربری (user space) را برای ویندوز آسان می‌کند.
این ابزار یک لایه شبیه‌سازی FUSE ارائه می‌دهد که rclone در ترکیب با cgofuse (https://github.com/winfsp/cgofuse) از آن استفاده می‌کند.
هر دوی این بسته‌ها توسط Bill Zissimopoulos توسعه داده شده‌اند که در طول پیاده‌سازی rclone nfsmount برای ویندوز بسیار یاری‌رسان بود.
.SS "حالت‌های سوار کردن در ویندوز (Mounting modes on windows)"
.PP
برخلاف سایر سیستم‌عامل‌ها، Microsoft Windows نوع سیستم‌فایل متفاوتی را برای درایوهای شبکه و درایوهای ثابت (fixed) ارائه می‌دهد.
ویندوز دسترسی را با این فرض بهینه‌سازی می‌کند که درایوهای دیسک ثابت سریع و قابل‌اعتماد هستند، در حالی که درایوهای شبکه تاخیر نسبتاً بالا و قابلیت اطمینان کمتری دارند.
برخی تنظیمات نیز می‌توانند بین این دو نوع تمایز قائل شوند؛ برای نمونه اینکه Windows Explorer روی درایوهای شبکه صرفاً آیکون‌ها را نمایش دهد و برای فایل‌های ویدیویی و تصویری پیش‌نمایش بندانگشتی ایجاد نکند.
.PP
در بیشتر موارد، rclone به‌طور پیش‌فرض ریموت را به‌عنوان یک درایو دیسک ثابت و عادی سوار می‌کند.
با این حال، می‌توانید آن را به‌عنوان یک درایو شبکه دوردست که اغلب به‌عنوان اشتراک شبکه (network share) توصیف می‌شود نیز سوار کنید.
اگر یک ریموت rclone را با حالت پیش‌فرضِ درایو ثابت سوار کردید و با خطاهای غیرمنتظره برنامه، قفل شدن (freeze) یا مشکلات دیگر مواجه شدید، سوار کردن آن را به‌عنوان درایو شبکه در نظر بگیرید.
.PP
هنگام سوار کردن به‌عنوان درایو دیسک ثابت، می‌توانید آن را به یک حرف درایو بلااستفاده، یا به مسیری که بیانگر یک زیردایرکتوری \f[B]ناموجود\f[R] از یک درایو یا دایرکتوری والد \f[B]موجود\f[R] است، سوار کنید.
استفاده از مقدار ویژهٔ \f[V]*\f[R] به rclone می‌گوید که به‌طور خودکار حرف درایو دردسترس بعدی را با شروع از Z: و حرکت به سمت عقب، اختصاص دهد.
مثال‌ها:
.IP
.nf
\f[C]
rclone nfsmount remote:path/to/files *
rclone nfsmount remote:path/to/files X:
rclone nfsmount remote:path/to/files C:\[rs]path\[rs]parent\[rs]mount
rclone nfsmount remote:path/to/files X:
\f[R]
.fi
.PP
گزینهٔ \f[V]--volname\f[R] می‌تواند برای تنظیم یک نام حجم سفارشی برای سیستم‌فایل سوارشده به کار رود.
پیش‌فرض این است که از نام و مسیر ریموت استفاده شود.
.PP
برای سوار کردن به‌عنوان درایو شبکه، می‌توانید گزینهٔ \f[V]--network-mode\f[R] را به دستور nfsmount خود اضافه کنید.
سوار کردن در مسیر یک دایرکتوری در این حالت پشتیبانی نمی‌شود؛ این محدودیتی است که ویندوز بر junctionها اعمال می‌کند، بنابراین ریموت همیشه باید به یک حرف درایو سوار شود.
.IP
.nf
\f[C]
rclone nfsmount remote:path/to/files X: --network-mode
\f[R]
.fi
.PP
نام حجم مشخص‌شده با \f[V]--volname\f[R] برای ایجاد مسیر اشتراک شبکه استفاده خواهد شد.
یک مسیر کامل UNC، مانند \f[V]\[rs]\[rs]cloud\[rs]remote\f[R]، اختیاری همراه با مسیر
\f[V]\[rs]\[rs]cloud\[rs]remote\[rs]madeup\[rs]path\f[R]، دقیقاً به همان صورت استفاده خواهد شد.
هر رشتهٔ دیگری پس از پیشوند پیش‌فرض \f[V]\[rs]\[rs]server\[rs]\f[R] به‌عنوان بخش اشتراک (share) استفاده خواهد شد.
اگر هیچ نام حجمی مشخص نشود، آنگاه از \f[V]\[rs]\[rs]server\[rs]share\f[R] استفاده خواهد شد.
هنگامی که بیش از یک درایو را سوار می‌کنید، باید مطمئن شوید که نام حجم یکتا است، در غیر این صورت دستور mount با شکست مواجه خواهد شد.
نام اشتراک به‌عنوان برچسب حجم (volume label) برای درایو نگاشت‌شده در نظر گرفته می‌شود و در Windows Explorer و غیره نمایش می‌یابد، در حالی که مسیر کامل
\f[V]\[rs]\[rs]server\[rs]share\f[R] درست مانند یک نگاشت معمولی درایو شبکه، توسط \f[V]net use\f[R] و غیره به‌عنوان مسیر دوردست UNC گزارش خواهد شد.
.PP
اگر یک مسیر کامل UNC اشتراک شبکه را با \f[V]--volname\f[R] مشخص کنید، این کار به‌طور ضمنی گزینهٔ \f[V]--network-mode\f[R] را فعال می‌کند، بنابراین دو مثال زیر نتیجه یکسانی دارند:
.IP
.nf
\f[C]
rclone nfsmount remote:path/to/files X: --network-mode
rclone nfsmount remote:path/to/files X: --volname \[rs]\[rs]server\[rs]share
\f[R]
.fi
.PP
همچنین می‌توانید خودِ مسیر UNC اشتراک شبکه را به‌عنوان نقطه سوار کردن (mountpoint) مشخص کنید.
در این صورت rclone به‌طور خودکار مانند \f[V]*\f[R] یک حرف درایو را اختصاص داده و از آن به‌عنوان نقطه سوار کردن استفاده می‌کند، و در عوض از مسیر UNC مشخص‌شده به‌عنوان نام حجم استفاده خواهد کرد؛ گویی که با گزینهٔ \f[V]--volname\f[R] تعیین شده باشد.
این کار نیز به‌طور ضمنی گزینهٔ \f[V]--network-mode\f[R] را فعال خواهد کرد.
این بدان معناست که دو مثال زیر نتیجه یکسانی دارند:
.IP
.nf
\f[C]
rclone nfsmount remote:path/to/files \[rs]\[rs]cloud\[rs]remote
rclone nfsmount remote:path/to/files * --volname \[rs]\[rs]cloud\[rs]remote
\f[R]
.fi
.PP
راه دیگری نیز برای فعال کردن حالت شبکه و تنظیم مسیر اشتراک وجود دارد، و آن ارسال مستقیم گزینهٔ \[dq]بومی\[dq] libfuse/WinFsp است: \f[V]--fuse-flag --VolumePrefix=\[rs]server\[rs]share\f[R].
توجه داشته باشید که در این حالت مسیر باید تنها با پیشوند یک بک‌اسلش تکی باشد.
.PP
\f[I]نکته:\f[R] در نسخه‌های قبلی rclone این تنها روش پشتیبانی‌شده بود.
.PP
دربارهٔ نگاشت درایو بیشتر بخوانید: (https://en.wikipedia.org/wiki/Drive_mapping)
.PP
همچنین بخش «محدودیت‌ها» (Limitations) در زیر را ببینید..SS مجوزهای سیستم‌فایل ویندوز (Windows filesystem permissions)
.PP
لایه شبیه‌ساز FUSE در ویندوز باید تبدیل بین مدل مجوز مبتنی بر POSIX مورد استفاده در FUSE و مدل مجوز استفاده‌شده در ویندوز بر پایه فهرست‌های کنترل دسترسی (ACL) را انجام دهد.
.PP
سیستم‌فایل سوارشده معمولاً سه مدخل در فهرست کنترل دسترسی (ACL) خود دریافت می‌کند، که نمایانگر مجوزها برای دامنه‌های مجوز POSIX هستند: مالک (Owner)، گروه (group) و دیگران (others).
به‌طور پیش‌فرض، مالک و گروه از کاربر فعلی گرفته می‌شوند و گروه توکار \[dq]Everyone\[dq] برای نشان دادن دیگران به کار می‌رود.
کاربر/گروه را می‌توان با گزینه‌های FUSE شامل \[dq]UserName\[dq] و \[dq]GroupName\[dq] سفارشی‌سازی کرد، برای مثال:
\f[V]-o UserName=user123 -o GroupName=\[dq]Authenticated Users\[dq]\f[R].
مجوزهای هر مدخل بر اساس گزینه‌های \f[V]--dir-perms\f[R] و \f[V]--file-perms\f[R] تنظیم می‌شوند، که مقداری را در نمادگذاری عددی سنتی یونیکس می‌پذیرند (https://en.wikipedia.org/wiki/File-system_permissions#Numeric_notation).
.PP
مجوزهای پیش‌فرض معادل با
\f[V]--file-perms 0666 --dir-perms 0777\f[R] هستند، یعنی
مجوزهای خواندن و نوشتن برای همگان.
این بدان معناست که شما قادر به اجرای هیچ برنامه‌ای از نقطه سوارشده نخواهید بود.
برای این که بتوانید این کار را انجام دهید باید مجوزهای اجرا را اضافه کنید، برای مثال
\f[V]--file-perms 0777 --dir-perms 0777\f[R] تا آن را برای همگان اضافه کند.
اگر برنامه نیاز به نوشتن فایل‌ها داشته باشد، این احتمال وجود دارد که مجبور باشید VFS File Caching را نیز فعال کنید (محدودیت‌ها را نیز ببینید).
توجه داشته باشید که مجوز نوشتن پیش‌فرض محدودیت‌هایی برای حساب‌هایی غیر از مالک دارد، به طور مشخص فاقد مجوز \[dq]write extended attributes\[dq] است، همان‌طور که در ادامه توضیح داده شده است.
.PP
نگاشت مجوزها همیشه بدیهی نیست، و نتیجه‌ای که در Windows Explorer مشاهده می‌کنید ممکن است دقیقاً آن چیزی نباشد که انتظار داشتید.
برای مثال، هنگام تنظیم مقداری که شامل دسترسی نوشتن برای دامنه گروه یا دیگران باشد، این مقدار به مجوزهای تکی
\[dq]write attributes\[dq]، \[dq]write data\[dq] و \[dq]append data\[dq]
نگاشت می‌شود، اما شامل \[dq]write extended attributes\[dq] نخواهد بود.
سپس ویندوز این را به عنوان مجوز پایه‌ای \[dq]Special\[dq] به جای \[dq]Write\[dq] نشان می‌دهد، زیرا \[dq]Write\[dq] مجوز \[dq]write extended attributes\[dq] را نیز پوشش می‌دهد.
هنگام تنظیم رقم 0 برای گروه یا دیگران، به منظور نشان دادن عدم وجود مجوز، آن‌ها همچنان مجوزهای تکی
\[dq]read attributes\[dq]، \[dq]read extended attributes\[dq] و \[dq]read permissions\[dq]
را دریافت خواهند کرد.
این کار به دلایل سازگاری انجام می‌شود، به عنوان مثال تا به کاربرانی که مجوزهای اضافی ندارند اجازه دهد متادیتاهای پایه درباره فایل‌ها را مانند یونیکس بخوانند.
.PP
ابزار WinFsp 2021 (نسخه 1.9) گزینه جدید FUSE با نام \[dq]FileSecurity\[dq] را معرفی کرد، که امکان تعیین کامل توصیف‌کننده‌های امنیتی فایل را با استفاده از
SDDL (https://docs.microsoft.com/en-us/windows/win32/secauthz/security-descriptor-string-format)
فراهم می‌کند.
با این کار، در مقایسه با استفاده از مجوزهای POSIX توضیح‌داده‌شده در بالا، کنترل دقیقی بر مجوزهای حاصل به دست می‌آورید، و هیچ مجوز اضافی به‌طور خودکار برای سازگاری با یونیکس اضافه نخواهد شد.
چند نمونه از موارد استفاده در ادامه می‌آید.
.PP
اگر با استفاده از \f[V]--file-perms 0600 --dir-perms 0700\f[R] مجوزهای POSIX را فقط برای اجازه دسترسی به مالک تنظیم کنید، همان‌طور که در بالا شرح داده شد، به گروه کاربر و گروه توکار \[dq]Everyone\[dq] همچنان برخی مجوزهای ویژه داده خواهد شد.
سپس برخی برنامه‌ها ممکن است این موضوع را (به اشتباه) به عنوان قابل دسترس بودن فایل توسط همگان تفسیر کنند، برای مثال یک کلاینت SSH ممکن است هشداری در مورد
\[dq]unprotected private key file\[dq] بدهد.
می‌توانید با مشخص کردن
\f[V]-o FileSecurity=\[dq]D:P(A;;FA;;;OW)\[dq]\f[R]
این مشکل را دور بزنید، که دسترسی همه‌جانبه فایل (FA) را برای مالک (OW) تنظیم می‌کند و نه هیچ چیز دیگر.
.PP
بنابراین هنگام تنظیم مجوزهای نوشتن، به جز برای مالک، این مقدار شامل مجوز \[dq]write extended attributes\[dq] نمی‌شود، همان‌طور که در بالا ذکر شد.
این امر ممکن است مانع از نوشتن برنامه‌ها در فایل‌ها شود و در عوض خطای permission denied بدهد.
برای تنظیم مجوزهای نوشتن کارآمد برای گروه توکار \[dq]Everyone\[dq]، مشابه آنچه به‌طور پیش‌فرض دریافت می‌کند اما با افزودن \[dq]write extended attributes\[dq]، می‌توانید
\f[V]-o FileSecurity=\[dq]D:P(A;;FRFW;;;WD)\[dq]\f[R]
را مشخص کنید، که خواندن فایل (FR) و نوشتن فایل (FW) را برای همگان (WD) تنظیم می‌کند.
اگر اجرای فایل (FX) نیز مورد نیاز است، آن را به
\f[V]-o FileSecurity=\[dq]D:P(A;;FRFWFX;;;WD)\[dq]\f[R]
تغییر دهید، یا با
\f[V]-o FileSecurity=\[dq]D:P(A;;FA;;;WD)\[dq]\f[R]
دسترسی همه‌جانبه فایل (FA) را برای دریافت مجوزهای دسترسی کامل، از جمله حذف، تنظیم نمایید..SS نکات و هشدارهای Windows
.PP
درایوهایی که با دسترسی Administrator ایجاد می‌شوند برای سایر حساب‌های کاربری قابل مشاهده نیستند، حتی حسابی که با ویژگی User Account Control (UAC) به سطح Administrator ارتقا یافته باشد.
نتیجه این امر آن است که اگر از طریق یک Command Prompt اجرا شده با دسترسی Administrator به یک حرف درایو متصل (mount) شوید و سپس تلاش کنید از طریق Windows Explorer (که به عنوان Administrator اجرا نمی‌شود) به همان درایو دسترسی پیدا کنید، قادر به دیدن درایو سوارشده نخواهید بود.
.PP
اگر نیازی به دسترسی به درایو از طریق برنامه‌های در حال اجرا با دسترسی‌های مدیریتی (administrative) ندارید، ساده‌ترین راهکار برای دور زدن این مشکل این است که همیشه عملیات سوار کردن (mount) را از طریق یک خط فرمان بدون ارتقای دسترسی (non-elevated) انجام دهید.
.PP
برای اینکه درایوهای نگاشت‌شده (mapped drives) صرف‌نظر از ارتقای دسترسی یا عدم آن برای حساب کاربری ایجادکننده در دسترس باشند، یک تنظیم ویژه در Windows به نام
اتصالات پیوندیافته (linked connections) (https://docs.microsoft.com/en-us/troubleshoot/windows-client/networking/mapped-drives-not-available-from-elevated-command#detail-to-configure-the-enablelinkedconnections-registry-entry)
وجود دارد که می‌توان آن را فعال کرد.
.PP
همچنین این امکان وجود دارد که با اجرای فرایند ایجادکننده سوار کردن تحت حساب کاربری توکار SYSTEM، درایو متصل‌شده را برای همه افراد حاضر در سیستم در دسترس قرار داد.
چندین راهکار برای انجام این کار وجود دارد: یکی استفاده از ابزار خط فرمانی
PsExec (https://docs.microsoft.com/en-us/sysinternals/downloads/psexec)
از مجموعه Sysinternals مایکروسافت است که دارای گزینه \f[V]-s\f[R] برای اجرای فرایندها تحت حساب کاربری SYSTEM می‌باشد.
گزینه دیگر، اجرای دستور mount از طریق یک وظیفه زمان‌بندی‌شده Windows (Scheduled Task) یا یک Windows Service است که برای اجرا تحت حساب SYSTEM پیکربندی شده باشد.
راهکار سوم استفاده از زیرساخت
WinFsp.Launcher (https://github.com/winfsp/winfsp/wiki/WinFsp-Service-Architecture)
است.
اطلاعات بیشتر را در مستندات نصب (https://rclone.org/install) مطالعه کنید.
توجه داشته باشید که هنگام اجرای rclone با کاربری دیگر، از فایل پیکربندی موجود در نمایه (profile) شما استفاده نخواهد شد، مگر اینکه با گزینه
\f[V]--config\f[R] (https://rclone.org/docs/#config-string)
این موضوع را مشخص کنید.
همچنین توجه داشته باشید که در این حالت، حساب کاربری SYSTEM دارای مجوزهای مالک (owner) خواهد بود و سایر حساب‌ها بر اساس حوزه‌های گروه (group) یا دیگران (others) مجوز خواهند داشت.
همان‌طور که در بالا ذکر شد، در این صورت آن‌ها مجوز \[dq]write extended attributes\[dq] را دریافت نخواهند کرد و این امر ممکن است از نوشتن در فایل‌ها جلوگیری کند.
می‌توانید با استفاده از گزینه FileSecurity این مشکل را برطرف کنید؛ مثال بالا را مشاهده نمایید.
.PP
توجه داشته باشید که نگاشت به یک مسیر دایرکتوری، به جای یک حرف درایو، با چنین محدودیت‌هایی مواجه نمی‌شود.
.SS سوار کردن (Mounting) در macOS
.PP
سوار کردن در macOS می‌تواند از طریق کارساز توکار NFS
(https://rclone.org/commands/rclone_serve_nfs)،
macFUSE (https://osxfuse.github.io) (همچنین شناخته‌شده با نام osxfuse) یا
FUSE-T (https://www.fuse-t.org) انجام شود.
سامانه macFUSE یک گرداننده سنتی FUSE است که از افزونه هسته macOS (kext) بهره می‌برد.
سامانه FUSE-T یک سیستم FUSE جایگزین است که عمل سوار کردن (\[dq]mount\[dq]) را از طریق یک کارساز محلی NFSv4 انجام می‌دهد.
.SS نرمال‌سازی یونیکد (Unicode Normalization)
.PP
اکیداً توصیه می‌شود که مقدار پیش‌فرض
\f[V]--no-unicode-normalization=false\f[R] برای تمام دستورهای \f[V]mount\f[R] و
\f[V]serve\f[R] در macOS حفظ شود.
برای جزئیات بیشتر، ببینید:
vfs-case-sensitivity (https://rclone.org/commands/rclone_mount/#vfs-case-sensitivity).
.SS سوار کردن با NFS (NFS mount)
.PP
برای macOS (و سایر بسترهایی که از این روش پشتیبانی می‌کنند)، استفاده از دستور اختصاصی
rclone nfsmount (https://rclone.org/commands/rclone_nfsmount)
را در اولویت قرار دهید.
این دستور کارساز NFS را راه‌اندازی کرده و عملیات سوار کردن را برای شما انجام می‌دهد.
خود دستور \f[V]rclone mount\f[R] همچنان از FUSE (شامل macFUSE/FUSE-T) استفاده می‌کند و از طریق پرچم به NFS تغییر حالت نمی‌دهد.
.PP
این روش یک کارساز NFS را با استفاده از دستور
serve nfs (https://rclone.org/commands/rclone_serve_nfs)
راه‌اندازی کرده و آن را در نقطه اتصال (mountpoint) مشخص‌شده سوار می‌کند.
اگر این را با استفاده از |--daemon| در حالت پس‌زمینه اجرا کنید، برای متوقف کردن اتصال mount باید با استفاده از دستور |kill| سیگنال SIGTERM را به فرایند rclone ارسال کنید.
.PP
توجه داشته باشید که \f[V]--nfs-cache-handle-limit\f[R] بیشینه تعداد دستگیره‌های فایل (file handles) ذخیره‌شده در حافظه نهان توسط گرداننده کش \f[V]nfsmount\f[R] را کنترل می‌کند.
این مقدار نباید بیش از حد کم تنظیم شود، در غیر این صورت ممکن است هنگام دسترسی به فایل‌ها با خطا مواجه شوید.
مقدار پیش‌فرض 1000000 است، اما در صورتی که مصرف منابع سیستم توسط سرور مشکلاتی ایجاد کرد، کاهش این حد را مد نظر قرار دهید..SS نکات macFUSE
.PP
در صورت نصب macFUSE با استفاده از بسته‌های dmg
(<https://github.com/osxfuse/osxfuse/releases>) از وب‌سایت،
rclone کتابخانه‌های macFUSE را بدون نیاز به هیچ اقدام دیگری پیدا خواهد کرد.
با این حال، اگر macFUSE با استفاده از مدیر بسته
macports (<https://www.macports.org>) نصب شده باشد، مراحل
اضافی زیر مورد نیاز است.
.IP
.nf
\f[C]
sudo mkdir /usr/local/lib
cd /usr/local/lib
sudo ln -s /opt/local/lib/libfuse.2.dylib
\f[R]
.fi
.SS محدودیت‌ها، هشدارها و نکات FUSE-T
.PP
محدودیت‌ها، هشدارها و نکاتی درباره نحوه کارکرد آن وجود دارد.
این موارد مربوط به نسخه 1.0.14 از FUSE-T هستند.
.SS به‌روزرسانی ModTime در هنگام خواندن
.PP
مطابق با ویکی
FUSE-T (<https://github.com/macos-fuse-t/fuse-t/wiki#caveats>):
.RS
.PP
زمان دسترسی و زمان تغییر فایل نمی‌توانند به‌طور جداگانه تنظیم شوند، زیرا به نظر
می‌رسد این مشکلی در کلاینت NFS باشد که همواره هر دو را تغییر می‌دهد.
با دستورهای \f[V]touch -m\f[R] و \f[V]touch -a\f[R]
قابل بازتولید است.
.RE
.PP
این بدان معناست که مشاهده فایل‌ها با ابزارهای مختلف، به‌ویژه Finder در macOS،
باعث می‌شود rclone زمان تغییر فایل را به‌روزرسانی کند.
این موضوع ممکن است سبب شود rclone یک نسخه کامل و جدید از فایل را بارگذاری کند.
.SS سوار کردن‌های فقط‌خواندنی (Read Only)
.PP
هنگام سوار کردن با \f[V]--read-only\f[R]، تلاش برای نوشتن در فایل‌ها
برخلاف macFUSE که با یک هشدار واضح همراه است، \f[I]در سکوت\f[R] (بدون پیام خطا)
با شکست مواجه خواهد شد.
.SS سوار کردن روی لینوکس
.PP
در نسخه‌های جدیدتر Ubuntu، ممکن است هنگام اجرای
\f[V]rclone mount\f[R] با خطای زیر مواجه شوید:
.RS
.PP
NOTICE: mount helper error: fusermount3: mount failed: Permission denied
CRITICAL: Fatal error: failed to mount FUSE fs: fusermount: exit status
1
.RE
.PP
این ممکن است به دلیل محدودیت‌های جدیدتر Apparmor (<https://wiki.ubuntu.com/AppArmor>)
باشد که می‌توان با دستور
\f[V]sudo aa-disable /usr/bin/fusermount3\f[R] آن را غیرفعال کرد (ممکن است
قبل از آن به اجرای \f[V]sudo apt install apparmor-utils\f[R] نیاز داشته باشید).
.SS سوار کردن روی OpenBSD
.PP
دستور \f[V]rclone nfsmount\f[R] در OpenBSD با راه‌اندازی کارساز
serve nfs (<https://rclone.org/commands/rclone_serve_nfs>) و سوار کردن
آن از طریق \f[V]mount_nfs(8)\f[R] سیستم کار می‌کند؛ همان رویکردی که برای
روش سوار کردن NFS در macOS استفاده می‌شود.
در OpenBSD هیچ گزینه سوار کردنی مبتنی بر FUSE وجود ندارد، بنابراین \f[V]nfsmount\f[R]
تنها راه برای سوار کردن ریموت‌های rclone به عنوان یک سیستم‌فایل محلی در آنجا است.
.SS ثبت در portmap
.PP
کلاینت NFS در هسته OpenBSD دیمن \f[V]mountd\f[R] را از طریق portmapper
سیستم پیدا می‌کند و به یک درگاه ثابت متصل نمی‌شود، بنابراین کارساز NFS
درون‌پروسه‌ای rclone قبل از این که بتواند سوار شود، باید در portmap ثبت شود.
کارساز \f[V]serve nfs\f[R] را روی یک درگاه ثابت آغاز کنید، سرویس‌های
NFS سیستم را متوقف کنید تا با آن تداخل نداشته باشند، سپس آن درگاه را برای
هر دو برنامه RPC \f[V]nfs\f[R] و \f[V]mountd\f[R] در portmap ثبت کنید
(این دستورالعمل ارائه شده توسط hjicks در
#8578 (<https://github.com/rclone/rclone/issues/8578#issuecomment-2799229652>) است):
.IP
.nf
\f[C]
rclone serve nfs --addr localhost:<PORT> remote:path

doas rcctl stop nfsd portmap
doas pkill -9 mountd   # mountd can\[aq]t be stopped via rcctl(8)
doas rcctl -f start portmap
doas rpcinfo -s nfs 3 <PORT>
doas rpcinfo -s mountd 3 <PORT>
\f[R]
.fi
.PP
عبارت \f[V]<PORT>\f[R] را با درگاه داده‌شده به \f[V]--addr\f[R] جایگزین کنید.
درگاه 2049 نیز کار می‌کند، اما نیازمند اجرای rclone به عنوان ریشه (root) یا
تنظیم \f[V]sysctl(8)\f[R] در securelevel 0 است، بنابراین یک درگاه بدون امتیاز
برای آزمایش ساده‌تر است..SS استفاده از \f[V]mount_nfs -T\f[R]، نه \f[V]mount\f[R]
.PP
اشتراک NFS برون‌ریزی‌شده را مستقیماً با استفاده از \f[V]mount_nfs(8)\f[R] و پرچم \f[V]-T\f[R] برای اجبار به استفاده از TCP سوار (mount) کنید، نه با پوسته عمومی \f[V]mount(8)\f[R] \- برنامه \f[V]mount(8)\f[R] در OpenBSD گزینه \f[V]-T\f[R] را متوجه نمی‌شود و آن را با خطای \f[V]unknown option -- T\f[R] رد می‌کند:
.IP
.nf
\f[C]
mount_nfs -T localhost:/ /path/to/local/mount
\f[R]
.fi
.PP
دستور \f[V]rclone nfsmount\f[R] این کار را به‌طور خودکار در OpenBSD برای شما انجام می‌دهد (مستقیماً \f[V]mount_nfs\f[R] را با \f[V]-T\f[R] فراخوانی می‌کند، به‌جای اینکه از \f[V]mount\f[R] استفاده کند)، بنابراین این دستور فقط زمانی لازم است که اشتراک \f[V]serve nfs\f[R] را به‌صورت دستی متصل می‌کنید.
.SS AUTH_UNIX و محدودیت‌های موجود
.PP
کلاینت NFS هسته OpenBSD (و سایر سامانه‌های BSD) نیازمند آن است که کارگزار حین دست‌تکانی MOUNT RPC شیوه احراز هویت \f[V]AUTH_UNIX\f[R] را ارائه دهد؛ کارگزاری که فقط \f[V]AUTH_NULL\f[R] را پیشنهاد دهد با خطای \f[V]mount_nfs: can\[aq]t access /: Authentication error\f[R] رد می‌شود. کارگزار NFS در rclone به همین دلیل \f[V]AUTH_UNIX\f[R] را اعلان می‌کند، هرچند که هیچ کنترل دسترسی به ازای کاربر روی آن پیاده‌سازی نمی‌کند \- برای پیشینه این موضوع و وضعیت فعلی پشتیبانی از OpenBSD، گزارش مشکل #8578 (https://github.com/rclone/rclone/issues/8578) را ببینید.
.SS محدودیت‌ها
.PP
بدون استفاده از \f[V]--vfs-cache-mode\f[R]، این دستور تنها می‌تواند فایل‌ها را به‌صورت ترتیبی بنویسد و عمل seek فقط هنگام خواندن ممکن است.
این بدان معناست که بسیاری از برنامه‌ها بدون \f[V]--vfs-cache-mode writes\f[R] یا \f[V]--vfs-cache-mode full\f[R] با فایل‌هایشان روی اتصال rclone کار نخواهند کرد.
برای اطلاعات بیشتر، بخش VFS File Caching را ببینید.
هنگام استفاده از سوار کردن NFS در macOS، در صورتی که |--vfs-cache-mode| را مشخص نکنید، نقطه اتصال فقط‌خواندنی خواهد بود.
.PP
فضاهای ریموت مبتنی بر باکت (Bucket) \- شامل Azure Blob، Swift، S3، Google Cloud Storage و B2 \- قادر به ذخیره دایرکتوری‌های خالی نیستند.
از میان این‌ها، تنها Azure Blob، Google Cloud Storage و S3 می‌توانند هنگام افزودن \f[V]--xxx-directory_markers\f[R] آن‌ها را حفظ کنند؛ در غیر این صورت، دایرکتوری‌های خالی به محض خروج از حافظه موقت دایرکتوری ناپدید خواهند شد.
.PP
هنگامی که \f[V]rclone mount\f[R] در سیستم‌های یونیکس با پرچم \f[V]--daemon\f[R] فراخوانی می‌شود، برنامه اصلی rclone منتظر می‌ماند تا سوار شدن پس‌زمینه آماده شود یا اینکه مهلت زمانی مشخص‌شده توسط پرچم \f[V]--daemon-wait\f[R] سررسد.
در لینوکس، وضعیت اتصال با استفاده از ProcFS قابل بررسی است، بنابراین این پرچم در واقع \f[B]حداکثر\f[R] زمان انتظار را تعیین می‌کند، در حالی که زمان انتظار واقعی می‌تواند کمتر باشد.
در macOS / BSD زمان انتظار ثابت است و بررسی تنها در پایان انجام می‌شود.
توصیه می‌کنیم زمان انتظار را در macOS معقولانه تنظیم کنید.
.PP
در حال حاضر فقط روی Linux، FreeBSD، OS X و Windows پشتیبانی می‌شود.
.SS مقایسه rclone nfsmount و rclone sync/copy
.PP
سیستم‌های فایل انتظار دارند همه‌چیز ۱۰۰٪ قابل اطمینان باشد، در حالی که سیستم‌های ذخیره‌سازی ابری با قابلیت اطمینان ۱۰۰٪ فاصله زیادی دارند.
دستورهای rclone sync/copy با تلاش‌های مجدد فراوان این مشکل را رفع می‌کنند.
با این حال، rclone nfsmount نمی‌تواند بدون ایجاد رونوشت محلی از بارگذاری‌ها، به همان شیوه از تلاش‌های مجدد استفاده کند.
برای راهکارهایی جهت افزایش قابلیت اطمینان nfsmount، به بخش VFS File Caching نگاهی بیندازید.
.SS حافظه موقت صفات (Attribute caching)
.PP
می‌توانید از پرچم \f[V]--attr-timeout\f[R] برای تنظیم مدت‌زمانی که هسته صفات ورودی‌های دایرکتوری (اندازه، زمان تغییر و غیره) را در حافظه موقت نگه می‌دارد، استفاده کنید.
.PP
مقدار پیش‌فرض \f[V]1s\f[R] است که فایل‌ها را تنها به اندازه‌ای در حافظه موقت نگه می‌دارد تا از فراخوانی‌های بیش‌از‌حد rclone توسط هسته جلوگیری شود.
.PP
از نظر تئوری، برای سیستم‌های فایلی که می‌توانند بیرون از کنترل هسته تغییر کنند، 0s باید مقدار درستی باشد.
با این حال، این تنظیم مشکلات متعددی ایجاد می‌کند؛ از جمله مصرف بیش از حد حافظه توسط rclone (https://github.com/rclone/rclone/issues/2157)، ناتوانی rclone در ارائه فایل‌ها به samba (https://forum.rclone.org/t/rclone-1-39-vs-1-40-mount-issue/5112) و زمان بیش از اندازه طولانی برای فهرست کردن دایرکتوری‌ها (https://github.com/rclone/rclone/issues/2095#issuecomment-371141147).
.PP
هسته می‌تواند اطلاعات مربوط به یک فایل را برای مدت‌زمان تعیین‌شده با \f[V]--attr-timeout\f[R] در حافظه موقت نگه دارد.
اگر طول فایل روی سیستم ریموت در طول این پنجره زمانی تغییر کند، ممکن است شاهد خرابی فایل باشید.
این خرابی به‌صورت یک فایل ناقص یا فایلی با داده‌های زائد در انتها بروز خواهد کرد.
با مقدار \f[V]--attr-timeout 1s\f[R] وقوع این اتفاق بسیار نامحتمل است اما غیرممکن نیست.
هرچه مقدار \f[V]--attr-timeout\f[R] را بالاتر ببرید، احتمال آن بیشتر می‌شود.
تنظیم پیش‌فرض \[dq]1s\[dq] پایین‌ترین میزانی است که مشکلات بالا را به حداقل می‌رساند.
.PP
اگر آن را روی مقادیر بالاتری تنظیم کنید (مثلاً \f[V]10s\f[R] یا \f[V]1m\f[R])، هسته دفعات کمتری rclone را فراخوانی کرده و کارایی بالاتر می‌رود، اما در مقابل شانس بروز مشکل خرابی بالا بیشتر خواهد شد.
.PP
اگر فایل‌ها روی سیستم ریموت خارج از کنترل rclone تغییر نکنند، هیچ احتمالی برای خرابی وجود ندارد.
.PP
این گزینه دقیقاً معادل تنظیم گزینه attr_timeout در mount.fuse است..SS فیلترها (Filters)
.PP
توجه داشته باشید که از تمام فیلترهای rclone می‌توان برای انتخاب زیرمجموعه‌ای از فایل‌ها جهت نمایش در mount استفاده کرد.
.SS سیستم‌دی (systemd)
.PP
هنگام اجرای rclone nfsmount به عنوان یک سرویس systemd، امکان استفاده از
\f[V]Type=notify\f[R] وجود دارد.
در این حالت، سرویس پس از راه‌اندازی موفقیت‌آمیز نقطه سوار کردن (mountpoint)
وارد وضعیت شروع‌شده (started) خواهد شد.
واحدهایی (Units) که سرویس rclone nfsmount به عنوان پیش‌نیاز برای آن‌ها مشخص
شده است، در این حالت بلافاصله تمام فایل‌ها و پوشه‌ها را مشاهده خواهند کرد.
.PP
توجه داشته باشید که systemd واحدهای سوار کردن (mount units) را بدون هیچ‌گونه
متغیر محیطی، از جمله \f[V]PATH\f[R] یا \f[V]HOME\f[R] اجرا می‌کند.
این بدان معناست که بسط تیلدا (\f[V]\[ti]\f[R]) کار نخواهد کرد و باید
\f[V]--config\f[R] و \f[V]--cache-dir\f[R] را به طور صریح به صورت مسیرهای مطلق
از طریق آرگومان‌های rclone ارائه دهید.
از آنجا که سوار کردن نیازمند برنامه \f[V]fusermount\f[R] یا
\f[V]fusermount3\f[R] است، rclone در این سناریو از مقدار پیش‌فرض جایگزین
(fallback PATH) به صورت \f[V]/bin:/usr/bin\f[R] استفاده خواهد کرد.
لطفاً اطمینان حاصل کنید که \f[V]fusermount\f[R]/\f[V]fusermount3\f[R] در این
PATH وجود دارد.
.SS rclone به عنوان دستیار سوار کردن یونیکس (Rclone as Unix mount helper)
.PP
برنامه اصلی یونیکس \f[V]/bin/mount\f[R] به طور معمول آرگومان
\f[V]-t FSTYPE\f[R] را دریافت کرده و سپس برنامه کمکی \f[V]/sbin/mount.FSTYPE\f[R]
را با ارسال گزینه‌های سوار کردن به صورت \f[V]-o key=val,...\f[R] یا
\f[V]--opt=...\f[R] اجرا می‌کند.
ابزار Automount (کلاسیک یا systemd) نیز به شیوه‌ای مشابه عمل می‌کند.
.PP
برنامه rclone به طور پیش‌فرض انتظار پرچم‌های سبک گنو به صورت \f[V]--key val\f[R] را دارد.
برای اجرای آن به عنوان یک دستیار سوار کردن، باید باینری rclone را به
\f[V]/sbin/mount.rclone\f[R] و به صورت اختیاری به \f[V]/usr/bin/rclonefs\f[R]
پیوند نمادین (symlink) دهید؛ به عنوان مثال:
\f[V]ln -s /usr/bin/rclone /sbin/mount.rclone\f[R].
برنامه rclone این مورد را تشخیص داده و آرگومان‌های خط فرمان را به طور مناسب
تبدیل می‌کند.
.PP
اکنون می‌توانید سوار کردن‌های کلاسیک را مانند زیر اجرا کنید:
.IP
.nf
\f[C]
mount sftp1:subdir /mnt/data -t rclone -o vfs_cache_mode=writes,sftp_key_file=/path/to/pem
\f[R]
.fi
.PP
یا واحدهای سوار کردن systemd بسازید:
.IP
.nf
\f[C]
# /etc/systemd/system/mnt-data.mount
[Unit]
Description=Mount for /mnt/data
[Mount]
Type=rclone
What=sftp1:subdir
Where=/mnt/data
Options=rw,_netdev,allow_other,args2env,vfs-cache-mode=writes,config=/etc/rclone.conf,cache-dir=/var/rclone
\f[R]
.fi
.PP
که به صورت اختیاری می‌تواند همراه با واحد خودکارسازی سوار کردن (automount unit) در systemd باشد:
.IP
.nf
\f[C]
# /etc/systemd/system/mnt-data.automount
[Unit]
Description=AutoMount for /mnt/data
[Automount]
Where=/mnt/data
TimeoutIdleSec=600
[Install]
WantedBy=multi-user.target
\f[R]
.fi
.PP
یا در \f[V]/etc/fstab\f[R] خطی مانند زیر اضافه کنید:
.IP
.nf
\f[C]
sftp1:subdir /mnt/data rclone rw,noauto,nofail,_netdev,x-systemd.automount,args2env,vfs_cache_mode=writes,config=/etc/rclone.conf,cache_dir=/var/cache/rclone 0 0
\f[R]
.fi
.PP
یا از Automountd کلاسیک استفاده کنید.
به یاد داشته باشید که برای دور زدن مشکل اجرای واحدهای mount بدون متغیر
\f[V]HOME\f[R]، مقادیر صریح \f[V]config=...,cache-dir=...\f[R] را تعیین کنید.
.PP
برنامه rclone در حالت دستیار سوار کردن (mount helper)، آرگومان(های)
\f[V]-o\f[R] را با کاما جدا می‌کند، \f[V]_\f[R] را با \f[V]-\f[R] جایگزین کرده و
\f[V]--\f[R] را به ابتدای آن‌ها می‌افزاید تا پرچم‌های خط فرمان به دست آیند.
گزینه‌های حاوی کاما یا فاصله را می‌توان درون علامت‌های نقل‌قول تکی یا دوتایی قرار داد.
هر نقل‌قول داخلی درون نقل‌قول خارجی از همان نوع باید تکرار (دو برابر) شود.
.PP
نحو گزینه‌های سوار کردن شامل چند گزینه اضافی است که رفتار ویژه‌ای با آن‌ها می‌شود:
.IP \[bu] 2
\f[V]env.NAME=VALUE\f[R] یک متغیر محیطی برای فرایند سوار کردن تنظیم می‌کند.
این مورد به Automountd و Systemd.mount که اجازه تنظیم متغیرهای محیطی سفارشی را
برای دستیارهای mount نمی‌دهند، کمک می‌کند.
به طور معمول از \f[V]env.HTTPS_PROXY=proxy.host:3128\f[R] یا
\f[V]env.HOME=/root\f[R] استفاده خواهید کرد.
.IP \[bu] 2
\f[V]command=cmount\f[R] می‌تواند برای اجرای \f[V]cmount\f[R] یا هر دستور دیگر
rclone به جای دستور پیش‌فرض \f[V]mount\f[R] استفاده شود.
.IP \[bu] 2
\f[V]args2env\f[R] گزینه‌های سوار کردن را به جای آرگومان‌های خط فرمان، از طریق
متغیرهای محیطی به دستیار mount در حال اجرا در پس‌زمینه ارسال می‌کند.
این کار امکان پنهان کردن اطلاعات حساس و محرمانه را از دستوراتی مانند
\f[V]ps\f[R] یا \f[V]pgrep\f[R] فراهم می‌سازد.
.IP \[bu] 2
\f[V]vv...\f[R] به \f[V]--verbose=N\f[R] متناظر تبدیل خواهد شد.
.IP \[bu] 2
گزینه‌های استاندارد سوار کردن مانند \f[V]x-systemd.automount\f[R]،
\f[V]_netdev\f[R]، \f[V]nosuid\f[R] و مانند آن‌ها تنها برای Automountd در نظر
گرفته شده‌اند و توسط rclone نادیده گرفته می‌شوند..SS VFS \- سامانه فایل مجازی (Virtual File System)
.PP
این دستور از لایه VFS استفاده می‌کند.
این لایه اشیاء ذخیره‌سازی ابری مورد استفاده rclone را به ساختاری بسیار
شبیه‌تر به یک سامانه فایل دیسک تبدیل می‌کند.
.PP
اشیاء ذخیره‌سازی ابری ویژگی‌های متعددی دارند که شبیه فایل‌های دیسک نیست \-
نمی‌توانید اندازه آن‌ها را گسترش دهید یا در میانه‌شان بنویسید؛ بنابراین
لایه VFS باید با این موضوع کنار بیاید.
از آنجا که هیچ راه منفرد و کاملاً درستی برای انجام این کار وجود ندارد،
گزینه‌های گوناگونی در ادامه توضیح داده شده است.
.PP
لایه VFS همچنین یک حافظه موقت دایرکتوری پیاده‌سازی می‌کند \- این قابلیت،
اطلاعات مربوط به فایل‌ها و دایرکتوری‌ها (نه داده‌های درون آن‌ها) را در
حافظه موقت نگه‌داری می‌کند.
.SS حافظه موقت دایرکتوری VFS (VFS Directory Cache)
.PP
با استفاده از پرچم \f[V]--dir-cache-time\f[R] می‌توانید کنترل کنید که یک
دایرکتوری تا چه مدت به‌روز در نظر گرفته شود و از سمت بک‌اند بازخوانی نشود.
تغییرات اعمال‌شده از طریق VFS بلافاصله نمایان می‌شوند یا حافظه موقت را
نامعتبر می‌کنند.
.IP
.nf
\f[C]
    --dir-cache-time duration   مدت‌زمان نگهداری مدخل‌های دایرکتوری در حافظه موقت (پیش‌فرض 5m0s)
    --poll-interval duration    مدت‌زمان انتظار میان بررسی تغییرات. باید از dir-cache-time کمتر باشد. فقط روی ریموت‌های پشتیبانی‌شده. برای غیرفعال‌سازی روی 0 تنظیم شود (پیش‌فرض 1m0s)
\f[R]
.fi
.PP
با این حال، تغییراتی که مستقیماً از طریق رابط وب یا یک نمونه دیگر rclone
روی فضای ذخیره‌سازی ابری اعمال شوند، در صورتی که بک‌اند پیکربندی‌شده از
پایش تغییرات پشتیبانی نکند، تنها پس از منقضی شدن حافظه موقت دایرکتوری
اعمال خواهند شد.
اگر بک‌اند از پایش پشتیبانی کند، تغییرات در بازه زمانی تعیین‌شده برای
پایش دریافت خواهند شد.
.PP
می‌توانید یک سیگنال \f[V]SIGHUP\f[R] به rclone ارسال کنید تا تمام حافظه‌های
موقت دایرکتوری را بدون در نظر گرفتن عمرشان پاکسازی کند.
با فرض اینکه تنها یک نمونه rclone در حال اجرا است، می‌توانید حافظه موقت را
به این صورت بازنشانی کنید:
.IP
.nf
\f[C]
kill -SIGHUP $(pidof rclone)
\f[R]
.fi
.PP
اگر rclone را همراه با کنترل از راه دور پیکربندی کنید، می‌توانید از
rclone rc برای پاکسازی کل حافظه موقت دایرکتوری استفاده نمایید:
.IP
.nf
\f[C]
rclone rc vfs/forget
\f[R]
.fi
.PP
یا برای فایل‌ها یا دایرکتوری‌های تکی:
.IP
.nf
\f[C]
rclone rc vfs/forget file=path/to/file dir=path/to/dir
\f[R]
.fi
.SS بافر کردن فایل VFS (VFS File Buffering)
.PP
پرچم \f[V]--buffer-size\f[R] مقدار حافظه‌ای را که برای پیش‌بافر کردن داده‌ها
استفاده خواهد شد تعیین می‌کند.
.PP
هر فایلِ باز تلاش می‌کند مقدار داده مشخص‌شده را همواره در حافظه نگه‌داری
کند.
داده‌های بافرشده مقید به یک فایل باز هستند و به اشتراک گذاشته نخواهند شد.
.PP
این پرچم یک حد بالا برای حافظه مصرفی به ازای هر فایل باز است.
بافر تنها برای داده‌هایی که بارگیری شده‌اند اما هنوز خوانده نشده‌اند از
حافظه استفاده خواهد کرد.
اگر بافر خالی باشد، تنها مقدار ناچیزی از حافظه مصرف خواهد شد.
.PP
حداکثر حافظه استفاده‌شده توسط rclone برای بافر کردن می‌تواند تا
\f[V]--buffer-size * open files\f[R] باشد.
.SS حافظه موقت فایل VFS (VFS File Caching)
.PP
این پرچم‌ها گزینه‌های حافظه موقت فایل VFS را کنترل می‌کنند.
حافظه موقت فایل برای سازگار جلوه دادن لایه VFS با یک سامانه فایل عادی
ضروری است.
می‌توان آن را به قیمت از دست رفتن بخشی از سازگاری غیرفعال کرد.
.PP
برای مثال، اگر بخواهید هم‌زمان روی یک فایل بخوانید و بنویسید، باید حافظه
موقت VFS را فعال کنید.
برای جزئیات بیشتر به ادامه مطلب مراجعه کنید.
.PP
توجه داشته باشید که حافظه موقت VFS از بک‌اند cache مجزاست و ممکن است
به یکی از آن‌ها یا هر دو نیاز داشته باشید.
.IP
.nf
\f[C]
    --cache-dir string                     دایرکتوری‌ای که rclone برای ذخیره حافظه موقت استفاده خواهد کرد.
    --vfs-cache-mode CacheMode             حالت حافظه موقت off|minimal|writes|full (پیش‌فرض off)
    --vfs-cache-max-age duration           حداکثر زمان از آخرین دسترسی به اشیاء در حافظه موقت (پیش‌فرض 1h0m0s)
    --vfs-cache-max-size SizeSuffix        حداکثر اندازه کل اشیاء موجود در حافظه موقت (پیش‌فرض off)
    --vfs-cache-min-free-space SizeSuffix  حداقل فضای خالی هدف روی دیسک حاوی حافظه موقت (پیش‌فرض off)
    --vfs-cache-poll-interval duration     بازه زمانی بررسی حافظه موقت برای اشیاء بی‌استفاده (پیش‌فرض 1m0s)
    --vfs-write-back duration              مدت‌زمان بازنویسی فایل‌ها پس از آخرین استفاده هنگام استفاده از کش (پیش‌فرض 5s)
\f[R]
.fi
.PP
در صورت اجرا با \f[V]-vv\f[R]، دستور rclone مسیر حافظه موقت فایل را چاپ
خواهد کرد.
فایل‌ها در ناحیه فایل‌های حافظه موقت کاربر ذخیره می‌شوند که به سیستم‌عامل
وابسته است اما می‌توان آن را با \f[V]--cache-dir\f[R] یا تنظیم متغیر
محیطی مناسب کنترل کرد.
.PP
حافظه موقت دارای ۴ حالت مختلف است که توسط \f[V]--vfs-cache-mode\f[R]
انتخاب می‌شوند.
هرچه حالت حافظه موقت بالاتر باشد، سازگاری rclone به قیمت مصرف فضای دیسک
بیشتر خواهد شد.
.PP
توجه داشته باشید که فایل‌ها تنها زمانی به ریموت بازنویسی می‌شوند که بسته
شده باشند و به مدت \f[V]--vfs-write-back\f[R] ثانیه مورد دسترسی قرار نگرفته
باشند.
اگر rclone بسته شود یا پیش از بارگذاری فایل‌ها از کار بیفتد، در اجرای بعدی
rclone با همان پرچم‌ها، این فایل‌ها بارگذاری خواهند شد.
.PP
در صورت استفاده از \f[V]--vfs-cache-max-size\f[R] یا
\f[V]--vfs-cache-min-free-space\f[R]، توجه داشته باشید که ممکن است حافظه
موقت به دو دلیل از این سهمیه‌ها فراتر رود.
نخست به این دلیل که بررسی سهمیه تنها در هر
\f[V]--vfs-cache-poll-interval\f[R] انجام می‌شود.
دوم به این دلیل که فایل‌های باز را نمی‌توان از حافظه موقت خارج کرد.
هنگامی که اندازه از \f[V]--vfs-cache-max-size\f[R] یا
\f[V]--vfs-cache-min-free-space\f[R] فراتر رود، rclone تلاش می‌کند ابتدا
فایل‌هایی را که کمترین دسترسی را داشته‌اند از حافظه موقت بیرون بیندازد.
rclone با فایل‌هایی شروع می‌کند که طولانی‌ترین زمان عدم دسترسی را داشته‌اند.
این راهبرد تخلیه حافظه موقت کارآمد است و احتمال بیشتری دارد که فایل‌های
مرتبط‌تر در حافظه موقت باقی بمانند.
.PP
گزینه \f[V]--vfs-cache-max-age\f[R] فایل‌ها را پس از گذشت مدت‌زمان تعیین‌شده
از آخرین دسترسی، از حافظه موقت پاک می‌کند؛ این معیار بر اساس زمان دسترسی
است، نه زمانی که فایل برای نخستین بار به حافظه موقت اضافه شده است.
مقدار پیش‌فرض ۱ ساعت فایل‌هایی را که به مدت ۱ ساعت مورد دسترسی قرار نگرفته‌اند
از حافظه موقت حذف خواهد کرد.
هنگامی که به یک فایل موجود در حافظه موقت دسترسی پیدا شود، تایمر ۱ ساعته
به ۰ بازنشانی می‌شود و پیش از حذف، ۱ ساعت دیگر منتظر می‌ماند.
زمان را با نمادگذاری استاندارد (s، m، h، d، w) مشخص کنید.
.PP
در صورت استفاده از \f[V]--vfs-cache-mode > off\f[R]، \f[B]نباید\f[R] دو
نسخه از rclone را با استفاده از یک حافظه موقت VFS یکسان با ریموت‌های
یکسان یا هم‌پوشان اجرا کنید.
انجام این کار بالقوه می‌تواند باعث خرابی داده‌ها شود.
می‌توانید با اختصاص دادن سلسله‌مراتب حافظه موقت اختصاصی به هر rclone با
استفاده از \f[V]--cache-dir\f[R]، این مشکل را برطرف کنید.
اگر ریموت‌های مورد استفاده هم‌پوشانی ندارند، نیازی به نگرانی در این مورد
نیست..SS --vfs-cache-mode off
.PP
در این حالت (پیش‌فرض)، کَش مستقیماً از ریموت می‌خواند و بدون کَش کردن هیچ‌چیز روی دیسک، مستقیماً روی ریموت می‌نویسد.
.PP
این امر بدین معناست که برخی از عملیات امکان‌پذیر نخواهند بود:
.IP \[bu] 2
فایل‌ها را نمی‌توان هم‌زمان برای هر دو حالت خواندن و نوشتن باز کرد
.IP \[bu] 2
فایل‌های باز شده برای نوشتن را نمی‌توان پیمایش (seek) کرد
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید دارای O_TRUNC تنظیم‌شده باشند
.IP \[bu] 2
فایل‌های باز شده برای خواندن همراه با O_TRUNC، به‌صورت فقط-نوشتنی باز خواهند شد
.IP \[bu] 2
فایل‌های باز شده به‌صورت فقط-نوشتنی طوری رفتار خواهند کرد که گویی O_TRUNC مشخص شده است
.IP \[bu] 2
حالت‌های باز کردن O_APPEND و O_TRUNC نادیده گرفته می‌شوند
.IP \[bu] 2
اگر یک بارگذاری (upload) با شکست مواجه شود، امکان تلاش مجدد وجود ندارد
.SS --vfs-cache-mode minimal
.PP
این حالت بسیار شبیه به \[dq]off\[dq] است، با این تفاوت که فایل‌های باز شده برای خواندن و نوشتن روی دیسک بافر می‌شوند.
این بدان معناست که فایل‌های باز شده برای نوشتن بسیار سازگارتر خواهند بود، اما حداقل فضای دیسک مصرف می‌شود.
.PP
این عملیات امکان‌پذیر نیستند:
.IP \[bu] 2
فایل‌های باز شده به‌صورت فقط-نوشتنی را نمی‌توان پیمایش (seek) کرد
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید دارای O_TRUNC تنظیم‌شده باشند
.IP \[bu] 2
فایل‌های باز شده به‌صورت فقط-نوشتنی، O_APPEND و O_TRUNC را نادیده خواهند گرفت
.IP \[bu] 2
اگر یک بارگذاری با شکست مواجه شود، امکان تلاش مجدد وجود ندارد
.SS --vfs-cache-mode writes
.PP
در این حالت، فایل‌های باز شده به‌صورت فقط-خواندنی همچنان مستقیماً از ریموت خوانده می‌شوند، در حالی که فایل‌های فقط-نوشتنی و خواندنی/نوشتنی ابتدا روی دیسک بافر می‌شوند.
.PP
این حالت باید از تمام عملیات عادی سیستم فایل پشتیبانی کند.
.PP
اگر یک بارگذاری با شکست مواجه شود، تلاش مجدد در فواصل زمانی با افزایش نمایی تا حداکثر ۱ دقیقه انجام خواهد شد.
.SS --vfs-cache-mode full
.PP
در این حالت تمام عملیات خواندن و نوشتن روی دیسک بافر می‌شوند (از دیسک و به دیسک).
هنگامی که داده‌ها از ریموت خوانده می‌شوند، آن‌ها نیز روی دیسک بافر می‌گردند.
.PP
در این حالت، فایل‌های موجود در کَش به‌صورت فایل‌های پراکنده (sparse files) خواهند بود و rclone بخش‌های دانلودشده از فایل‌ها را رهگیری می‌کند.
.PP
بنابراین اگر برنامه‌ای فقط ابتدای هر فایل را بخواند، rclone نیز تنها ابتدای فایل را بافر خواهد کرد.
این فایل‌ها در کَش با اندازه کامل خود نمایش داده می‌شوند، اما در واقع فایل‌های پراکنده‌ای هستند که فقط داده‌های دانلودشده درون آن‌ها موجود است.
.PP
این حالت باید از تمام عملیات عادی سیستم فایل پشتیبانی کند و در سایر موارد دقیقاً مشابه \f[V]--vfs-cache-mode\f[R] writes است.
.PP
هنگام خواندن یک فایل، rclone به میزان \f[V]--buffer-size\f[R] به‌علاوه \f[V]--vfs-read-ahead\f[R] بایت جلوتر را می‌خواند.
مقدار \f[V]--buffer-size\f[R] در حافظه (RAM) بافر می‌شود در حالی که \f[V]--vfs-read-ahead\f[R] روی دیسک بافر می‌گردد.
.PP
هنگام استفاده از این حالت، توصیه می‌شود که \f[V]--buffer-size\f[R] خیلی بزرگ تنظیم نشود و در صورت نیاز، \f[V]--vfs-read-ahead\f[R] روی مقداری بزرگ تنظیم گردد.
.PP
\f[B]مهم:\f[R] همه سیستم‌های فایل از فایل‌های پراکنده پشتیبانی نمی‌کنند.
به‌ویژه FAT/exFAT پشتیبانی نمی‌کنند.
اگر دایرکتوری کَش روی سیستم فایلی باشد که از فایل‌های پراکنده پشتیبانی نمی‌کند، rclone عملکرد بسیار ضعیفی خواهد داشت و در صورت تشخیص چنین وضعیتی، یک پیام ERROR ثبت خواهد کرد.
.SS انگشت‌نگاری (Fingerprinting)
.PP
بخش‌های مختلف VFS از انگشت‌نگاری استفاده می‌کنند تا بررسی کنند آیا نسخه محلی فایل نسبت به فایل ریموت تغییر کرده است یا خیر.
اثرانگشت‌ها از موارد زیر ساخته می‌شوند:
.IP \[bu] 2
اندازه (size)
.IP \[bu] 2
زمان آخرین تغییر (modification time)
.IP \[bu] 2
هش (hash)
.PP
در صورتی که روی یک شیء در دسترس باشند.
.PP
در برخی بک‌اندها، خواندن برخی از این مشخصه‌ها کُند است (به ازای هر شیء به یک فراخوانی API اضافی یا پردازش اضافه نیاز دارند).
.PP
به‌عنوان مثال، \f[V]hash\f[R] در بک‌اندهای \f[V]local\f[R] و \f[V]sftp\f[R] کُند است زیرا باید کل فایل را خوانده و هش آن را محاسبه کنند؛ و \f[V]modtime\f[R] در بک‌اندهای \f[V]s3\f[R]، \f[V]swift\f[R]، \f[V]ftp\f[R] و \f[V]qinqstor\f[R] کُند است زیرا برای دریافت آن به یک فراخوانی API اضافی نیاز دارند.
.PP
اگر از پرچم \f[V]--vfs-fast-fingerprint\f[R] استفاده کنید، rclone عملیات کُند را در اثرانگشت لحاظ نخواهد کرد.
این کار دقت انگشت‌نگاری را کاهش می‌دهد اما سرعت آن را بسیار بالا می‌برد و زمان باز شدن فایل‌های کَش‌شده را بهبود می‌بخشد.
.PP
اگر یک کَش VFS را روی بک‌اندهای \f[V]local\f[R]، \f[V]s3\f[R] یا \f[V]swift\f[R] اجرا می‌کنید، استفاده از این پرچم توصیه می‌شود.
.PP
توجه داشته باشید که در صورت تغییر مقدار این پرچم، اثرانگشت فایل‌های موجود در کَش ممکن است باطل شود و فایل‌ها باید مجدداً دانلود شوند..SS خواندن تکه‌ای در VFS (VFS Chunked Reading)
.PP
هنگامی که rclone فایل‌ها را از یک ریموت می‌خواند، آن‌ها را به صورت تکه‌ای می‌خواند.
این بدان معناست که rclone به جای درخواست کل فایل، تنها تکهٔ مشخص‌شده را می‌خواند.
این کار می‌تواند با درخواست تکه‌هایی از ریموت که واقعاً خوانده می‌شوند، سهمیهٔ بارگیری مصرفی برخی ریموت‌ها را کاهش دهد، هرچند که باعث افزایش تعداد درخواست‌ها می‌شود.
.PP
این پرچم‌ها رفتار تکه‌تکه کردن را کنترل می‌کنند:
.IP
.nf
\f[C]
    --vfs-read-chunk-size SizeSuffix        خواندن اشیاء مبدأ به‌صورت تکه‌ای (پیش‌فرض 128M)
    --vfs-read-chunk-size-limit SizeSuffix  بیشینه اندازه دو برابر شدن تکه‌ها (پیش‌فرض off)
    --vfs-read-chunk-streams int            تعداد جریان‌های موازی برای خواندن هم‌زمان
\f[R]
.fi
.PP
رفتار تکه‌تکه کردن بسته به پارامتر \f[V]--vfs-read-chunk-streams\f[R] متفاوت خواهد بود.
.SS \f[V]--vfs-read-chunk-streams\f[R] == 0
.PP
دستور rclone خواندن را با تکه‌ای به اندازهٔ \f[V]--vfs-read-chunk-size\f[R] آغاز کرده و سپس اندازه را برای هر بار خواندن دو برابر می‌کند.
هنگامی که \f[V]--vfs-read-chunk-size-limit\f[R] مشخص شده و بزرگ‌تر از \f[V]--vfs-read-chunk-size\f[R] باشد، اندازهٔ تکه برای هر فایلِ باز تنها تا زمان رسیدن به مقدار مشخص‌شده دو برابر خواهد شد.
اگر مقدار برابر با \[dq]off\[dq] باشد (که پیش‌فرض است)، محدودیت غیرفعال بوده و اندازهٔ تکه به‌صورت نامحدود رشد خواهد کرد.
.PP
با \f[V]--vfs-read-chunk-size 100M\f[R] و \f[V]--vfs-read-chunk-size-limit 0\f[R]، بخش‌های زیر بارگیری خواهند شد: 0\-100M، 100M\-200M، 200M\-300M، 300M\-400M و الی آخر.
هنگامی که \f[V]--vfs-read-chunk-size-limit 500M\f[R] تعیین شده باشد، نتیجه به‌صورت 0\-100M، 100M\-300M، 300M\-700M، 700M\-1200M، 1200M\-1700M و الی آخر خواهد بود.
.PP
تنظیم \f[V]--vfs-read-chunk-size\f[R] روی \f[V]0\f[R] یا \[dq]off\[dq] خواندن تکه‌ای را غیرفعال می‌کند.
.PP
تکه‌ها در حافظه بافر نخواهند شد.
.SS \f[V]--vfs-read-chunk-streams\f[R] > 0
.PP
دستور rclone به تعداد \f[V]--vfs-read-chunk-streams\f[R] تکه با اندازهٔ \f[V]--vfs-read-chunk-size\f[R] را به‌صورت هم‌زمان می‌خواند.
اندازه برای هر بار خواندن ثابت باقی خواهد ماند.
.PP
این کار کارایی را در پیوندهای با تاخیر بالا یا پهنای باند بسیار زیاد به فضاهای ذخیره‌سازی شیء با کارایی بالا، به‌طور چشمگیری بهبود می‌بخشد.
.PP
برای یافتن مقادیر بهینهٔ \f[V]--vfs-read-chunk-size\f[R] و \f[V]--vfs-read-chunk-streams\f[R] به مقداری آزمون و خطا نیاز خواهد بود، زیرا این مقادیر به بخش پسین مورد استفاده و تاخیر ارتباط با آن بستگی دارد.
.PP
برای فضاهای ذخیره‌سازی شیء با کارایی بالا (مانند AWS S3)، یک نقطهٔ شروع منطقی می‌تواند \f[V]--vfs-read-chunk-streams 16\f[R] و \f[V]--vfs-read-chunk-size 4M\f[R] باشد.
در آزمایش‌های انجام‌شده با AWS S3، کارایی تقریباً متناسب با تنظیم \f[V]--vfs-read-chunk-streams\f[R] مقیاس‌پذیر بوده است.
.PP
تنظیمات مشابه باید برای پیوندهای با تاخیر بالا نیز عمل کند، اما بسته به میزان تاخیر ممکن است برای دستیابی به توان عملیاتی مطلوب، به \f[V]--vfs-read-chunk-streams\f[R] بیشتری نیاز باشد.
.SS کارایی VFS (VFS Performance)
.PP
این پرچم‌ها می‌توانند برای فعال یا غیرفعال کردن قابلیت‌های VFS به دلایل کارایی یا موارد دیگر استفاده شوند.
همچنین ویژگی خواندن تکه‌ای را مشاهده کنید.
.PP
به‌ویژه S3 و Swift از پرچم \f[V]--no-modtime\f[R] بهرهٔ فراوانی می‌برند (یا برای تأثیری کمی متفاوت از \f[V]--use-server-modtime\f[R] استفاده کنید)، زیرا هر بار خواندن زمان ویرایش، یک تراکنش مصرف می‌کند.
.IP
.nf
\f[C]
    --no-checksum     عدم مقایسه چِک‌سام‌ها هنگام بارگذاری/بارگیری.
    --no-modtime      عدم خواندن/نوشتن زمان ویرایش (می‌تواند سرعت را افزایش دهد).
    --no-seek         عدم اجازه پرش (seek) در فایل‌ها.
    --read-only       تنها اجازه دسترسی فقط‌خواندنی.
\f[R]
.fi
.PP
گاهی عملیات خواندن یا نوشتن خارج از ترتیب به rclone تحویل داده می‌شوند.
دستور rclone به جای پرش (seek)، مدت زمان کوتاهی منتظر دریافت عملیات خواندن یا نوشتنِ متوالی می‌ماند.
این پرچم‌ها تنها زمانی اثرگذار خواهند بود که از فایل کَش روی دیسک استفاده نشود.
.IP
.nf
\f[C]
    --vfs-read-wait duration   مدت زمان انتظار برای خواندن متوالی قبل از پرش (پیش‌فرض 20ms)
    --vfs-write-wait duration  مدت زمان انتظار برای نوشتن متوالی قبل از اعلام خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
هنگام استفاده از کَش نوشتن VFS (\f[V]--vfs-cache-mode\f[R] با مقدار writes یا full)، می‌توان پرچم سراسری \f[V]--transfers\f[R] را برای تنظیم تعداد بارگذاری‌های موازی فایل‌های تغییریافته از کَش تعیین کرد (پرچم سراسری مرتبط \f[V]--checkers\f[R] هیچ تأثیری بر روی VFS ندارد).
.IP
.nf
\f[C]
    --transfers int  تعداد انتقال‌های هم‌زمان فایل (پیش‌فرض 4)
\f[R]
.fi.SS "پیوندهای نمادین (Symlinks)"
.PP
به‌طور پیش‌فرض VFS از پیوندهای نمادین پشتیبانی نمی‌کند.
با این حال، می‌توان این قابلیت را با هر یک از گزینه‌های زیر فعال کرد:
.IP
.nf
\f[C]
    --links      تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq].
    --vfs-links  تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
\f[R]
.fi
.PP
از آنجا که بیشتر سیستم‌های ذخیره‌سازی ابری مستقیماً از پیوندهای نمادین پشتیبانی نمی‌کنند، rclone پیوند نمادین را به‌صورت یک فایل عادی با پسوندی ویژه ذخیره می‌کند.
بنابراین فایلی که به‌صورت پیوند نمادین \f[V]link-to-file.txt\f[R] دیده می‌شود، در فضای ابری به‌صورت \f[V]link-to-file.txt.rclonelink\f[R] ذخیره خواهد شد و محتوای آن مسیر مقصد پیوند نمادین خواهد بود.
.PP
توجه داشته باشید که \f[V]--links\f[R] تبدیل پیوندهای نمادین را به‌طور سراسری در rclone فعال می‌کند \- این شامل هر backend که از این مفهوم پشتیبانی کند می‌شود (برای نمونه backend محلی).
گزینه \f[V]--vfs-links\f[R] آن را فقط برای لایه VFS فعال می‌سازد.
.PP
این طرح با سازوکار مورد استفاده توسط backend محلی با گزینه --local-links سازگار است (https://rclone.org/local/#symlinks-junction-points).
.PP
گزینه \f[V]--vfs-links\f[R] برای دستورهای \f[V]rclone mount\f[R]، \f[V]rclone nfsmount\f[R] و \f[V]rclone serve nfs\f[R] طراحی شده است.
.PP
این گزینه هنوز با سایر دستورهای \f[V]rclone serve\f[R] آزمایش نشده است.
.PP
یکی از محدودیت‌های پیاده‌سازی فعلی این است که انتظار دارد فراخواننده، زیرپیوندهای نمادین (sub-symlinks) را حل کند.
برای نمونه با در نظر گرفتن این درخت دایرکتوری:
.IP
.nf
\f[C]
\&.
├── dir
│\ \  └── file.txt
└── linked-dir -> dir
\f[R]
.fi
.PP
لایه VFS مسیر \f[V]linked-dir\f[R] را به‌درستی حل می‌کند، اما \f[V]linked-dir/file.txt\f[R] را خیر.
این موضوع برای دستورهای آزمایش‌شده مشکلی ایجاد نمی‌کند، اما ممکن است برای دستورهای دیگر مشکل‌ساز باشد.
.PP
\f[B]توجه\f[R] داشته باشید که یک مشکل حل‌نشده در پشتیبانی از پیوندهای نمادین با شناسه issue #8245 (https://github.com/rclone/rclone/issues/8245) وجود دارد که در آن هنگام انتقال پیوندهای نمادین به دایرکتوری‌هایی با فایل هم‌نام (یا برعکس)، فایل‌های تکراری ایجاد می‌شوند.
.SS "حساسیت VFS به بزرگی و کوچکی حروف (VFS Case Sensitivity)"
.PP
سیستم‌های فایل لینوکس به بزرگی و کوچکی حروف حساس هستند (case-sensitive): دو فایل می‌توانند تنها در بزرگی و کوچکی حروف تفاوت داشته باشند، و هنگام باز کردن یک فایل باید دقیقاً از همان حالت حروف استفاده شود.
.PP
سیستم‌های فایل در نسخه‌های نوین ویندوز نسبت به بزرگی و کوچکی حروف حساس نیستند ولی حالت حروف را حفظ می‌کنند (case-insensitive but case-preserving): با اینکه فایل‌های موجود را می‌توان با هر حالتی از حروف باز کرد، اما حالت دقیق حروفی که برای ساخت فایل استفاده شده حفظ می‌شود و برنامه‌ها می‌توانند از آن پرس‌وجو کنند.
در این سیستم‌ها مجاز نیست که دو فایل در یک دایرکتوری، فقط از نظر بزرگی و کوچکی حروف با یکدیگر تفاوت داشته باشند.
.PP
معمولاً سیستم‌های فایل در macOS به بزرگی و کوچکی حروف حساس نیستند.
امکان حساس کردن سیستم‌های فایل macOS به بزرگی و کوچکی حروف وجود دارد، اما این حالت پیش‌فرض نیست.
.PP
گزینه \f[V]--vfs-case-insensitive\f[R] در VFS نحوه مدیریت این دو حالت را توسط rclone کنترل می‌کند.
اگر مقدار آن \[dq]false\[dq] باشد، rclone نام فایل‌ها را دست‌نخورده به remote ارسال می‌کند.
اگر این گزینه برابر با \[dq]true\[dq] باشد (یا بدون مقدار در خط فرمان مشخص شود)، rclone ممکن است همان‌طور که در زیر توضیح داده شده یک \[dq]اصلاح\[dq] انجام دهد.
.PP
کاربر ممکن است نام فایلی را برای باز کردن/حذف/تغییر نام/غیره با حالتی از حروف مشخص کند که با آنچه در remote ذخیره شده متفاوت باشد.
اگر یک آرگومان به فایلی موجود با دقیقاً همان نام اشاره کند، حالت حروف فایل موجود روی دیسک استفاده خواهد شد.
با این حال، اگر فایلی با دقیقاً همان نام پیدا نشود اما نامی وجود داشته باشد که تنها در بزرگی و کوچکی حروف متفاوت است، rclone به‌طور شفاف نام را اصلاح می‌کند.
این اصلاح فقط هنگامی رخ می‌دهد که فایلی موجود درخواست شده باشد.
حساسیت به بزرگی و کوچکی حروف نام‌هایی که از نو توسط rclone ساخته می‌شوند، توسط remote زیرین کنترل می‌شود.
.PP
توجه داشته باشید که حساسیت سیستم‌عامل اجراکننده rclone (مقصد یا target) به بزرگی و کوچکی حروف ممکن است با حساسیت سیستم فایلی که توسط rclone ارائه می‌شود (مبدأ یا source) تفاوت داشته باشد.
این گزینه کنترل می‌کند که آیا برای برآورده کردن نیازهای مقصد، \[dq]اصلاح\[dq] انجام گیرد یا خیر.
.PP
اگر این گزینه در خط فرمان مشخص نشود، مقدار پیش‌فرض آن به سیستم‌عاملی که rclone روی آن اجرا می‌شود بستگی دارد: در ویندوز و macOS برابر با \[dq]true\[dq] و در غیر این صورت \[dq]false\[dq].
اگر این گزینه بدون مقدار آورده شود، مقدار آن \[dq]true\[dq] خواهد بود.
.PP
گزینه \f[V]--no-unicode-normalization\f[R] مشخص می‌کند که آیا \[dq]اصلاح\[dq] مشابهی برای نام فایل‌هایی که متفاوت هستند اما از نظر یونیکد هم‌ارزی قانونی (https://en.wikipedia.org/wiki/Unicode_equivalence) دارند انجام شود یا خیر.
عادی‌سازی یونیکد به‌ویژه برای کاربران macOS مفید است؛ سیستم‌عاملی که قالب NFD را به قالب NFC (که در اکثر پلتفرم‌های دیگر استفاده می‌شود) ترجیح می‌دهد.
بنابراین اکیداً توصیه می‌شود که در macOS مقدار پیش‌فرض \f[V]false\f[R] حفظ شود تا از مشکلات سازگاری انکودینگ جلوگیری به عمل آید.
.PP
در صورت وقوع حالت (احتمالاً بعید) که یک دایرکتوری پس از اعمال یکسان‌سازی حروف و عادی‌سازی یونیکد، چندین نام فایل تکراری داشته باشد، گزینه \f[V]--vfs-block-norm-dupes\f[R] امکان پنهان‌سازی این موارد تکراری را فراهم می‌کند.
این کار با کاهش کارایی همراه است، زیرا rclone هنگام فهرست کردن یک دایرکتوری، مجبور خواهد بود کل دایرکتوری را برای یافتن موارد تکراری پویش کند.
به همین دلیل، توصیه می‌شود در صورت عدم نیاز، این گزینه غیرفعال بماند.
با این وجود، کاربران macOS ممکن است بخواهند از این گزینه استفاده کنند؛ زیرا در غیر این صورت، اگر یک دایرکتوری در remote شامل هر دو نسخه NFC و NFD از یک نام فایل باشد، وضعیت نامتعارفی رخ خواهد داد: هر دو نسخه فایل در نقطه اتصال (mount) نمایان خواهند بود و هر دو قابل ویرایش به نظر می‌رسند، اما در عمل ویرایش هر نسخه منجر به این می‌شود که در پشت صحنه فقط نسخه NFD ویرایش شود.
گزینه \f[V]--vfs-block-norm-dupes\f[R] با شناسایی این سناریو، پنهان کردن موارد تکراری و ثبت یک خطا در گزارش‌ها، مشابه نحوه مدیریت این موضوع در \f[V]rclone sync\f[R]، از این سردرگمی جلوگیری می‌کند..SS گزینه‌های دیسک VFS
.PP
این پرچم به شما امکان می‌دهد آمار و اطلاعات مربوط به سیستم فایل را به صورت دستی
تنظیم کنید.
این ویژگی زمانی می‌تواند مفید باشد که این آمار نتوانند به صورت خودکار و صحیح
خوانده شوند.
.IP
.nf
\f[C]
    --vfs-disk-space-total-size    تنظیم دستی اندازه کل فضای دیسک (مثال: 256G، پیش‌فرض: -1)
\f[R]
.fi
.SS گزارش جایگزین بایت‌های استفاده‌شده
.PP
برخی از backendها، به‌ویژه S3، میزان بایت‌های استفاده‌شده را گزارش نمی‌کنند.
اگر هنگام اجرای \f[V]df\f[R] روی سیستم فایل به این اطلاعات نیاز دارید، پرچم
\f[V]--vfs-used-is-size\f[R] را به rclone ارسال کنید.
با تنظیم این پرچم، rclone به جای اتکا به backend برای گزارش این اطلاعات،
کل ریموت را مشابه \f[V]rclone size\f[R] پویش کرده و خودش کل فضای استفاده‌شده
را محاسبه می‌کند.
.PP
\f[B]هشدار\f[R]: بر خلاف \f[V]rclone size\f[R]، این پرچم فیلترها را نادیده
می‌گیرد تا نتیجه دقیق باشد.
با این حال، این کار بسیار ناکارآمد است و ممکن است باعث فراخوانی‌های فراوان
API و در نتیجه هزینه‌های اضافی شود.
تنها به عنوان آخرین راهکار و فقط همراه با حافظه موقت (caching) از آن استفاده کنید.
.SS متادیتای VFS
.PP
اگر از پرچم \f[V]--vfs-metadata-extension\f[R] استفاده کنید، می‌توانید VFS
را وادار کنید فایل‌هایی را که حاوی متادیتا
(https://rclone.org/docs/#metadata) هستند به عنوان یک blob در قالب JSON
ارائه دهد.
این فایل‌ها در فهرست دایرکتوری ظاهر نخواهند شد، اما می‌توان روی آن‌ها
\f[V]stat\f[R] اجرا کرد و آن‌ها را باز نمود، و پس از باز شدن، تا زمان
منقضی شدن حافظه موقت دایرکتوری در فهرست دایرکتوری ظاهر \f[B]خواهند شد\f[R].
.PP
توجه داشته باشید که برخی از backendها متادیتا را ایجاد نمی‌کنند مگر اینکه
پرچم \f[V]--metadata\f[R] را ارسال کنید.
.PP
به عنوان مثال، با اجرای \f[V]rclone mount\f[R] به همراه
\f[V]--metadata --vfs-metadata-extension .metadata\f[R] خروجی زیر به دست می‌آید:
.IP
.nf
\f[C]
$ ls -l /mnt/
total 1048577
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G

$ cat /mnt/1G.metadata
{
        \[dq]atime\[dq]: \[dq]2025-03-04T17:34:22.317069787Z\[dq],
        \[dq]btime\[dq]: \[dq]2025-03-03T16:03:37.708253808Z\[dq],
        \[dq]gid\[dq]: \[dq]1000\[dq],
        \[dq]mode\[dq]: \[dq]100664\[dq],
        \[dq]mtime\[dq]: \[dq]2025-03-03T16:03:39.640238323Z\[dq],
        \[dq]uid\[dq]: \[dq]1000\[dq]
}

$ ls -l /mnt/
total 1048578
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G
-rw-rw-r-- 1 user user        185 Mar  3 16:03 1G.metadata
\f[R]
.fi
.PP
اگر فایل فاقد متادیتا باشد، به صورت \f[V]{}\f[R] بازگردانده می‌شود و در
صورت بروز خطا در خواندن متادیتا، خطا به صورت
\f[V]{\[dq]error\[dq]:\[dq]error string\[dq]}\f[R] برگردانده خواهد شد.
.IP
.nf
\f[C]
rclone nfsmount remote:path /path/to/mountpoint [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --addr string                            آدرس‌IP:درگاه یا :درگاه برای مقیدسازی سرور به آن
      --allow-idmap                            اجازه سوارکردن با نگاشت شناسه (id-mapped) (تنها لینوکس 6.12+ و mount2)
      --allow-non-empty                        اجازه سوار کردن روی دایرکتوری غیرخالی (در ویندوز پشتیبانی نمی‌شود)
      --allow-other                            اجازه دسترسی به سایر کاربران (در ویندوز پشتیبانی نمی‌شود)
      --allow-root                             اجازه دسترسی به کاربر ریشه (در ویندوز پشتیبانی نمی‌شود)
      --async-read                             استفاده از خواندن‌های ناهمگام (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض: true)
      --attr-timeout Duration                  مدت‌زمان نگهداری ویژگی‌های فایل/دایرکتوری در حافظه موقت (پیش‌فرض: 1s)
      --daemon                                 اجرای mount در پس‌زمینه و خروج از فرایند والد (از آنجا که خروجی پس‌زمینه خاموش است، برای پایش از --log-file همراه با --log-format=pid,... استفاده کنید) (در ویندوز پشتیبانی نمی‌شود)
      --daemon-timeout Duration                مهلت زمانی برای پاسخ rclone به هسته (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض: 0s)
      --daemon-wait Duration                   مدت‌زمان انتظار برای آماده‌شدن سوارکردن از دیمن (حداکثر زمان در لینوکس، زمان خواب ثابت در OSX/BSD) (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض: 1m0s)
      --debug-fuse                             اشکال‌زدایی سازوکارهای داخلی FUSE - نیازمند -v
      --default-permissions                    وادار کردن هسته به اعمال کنترل دسترسی بر اساس حالت فایل (در ویندوز پشتیبانی نمی‌شود)
      --devname string                         تنظیم نام دستگاه - پیش‌فرض remote:path است
      --dir-cache-time Duration                مدت‌زمان نگهداری ورودی‌های دایرکتوری در حافظه موقت (پیش‌فرض: 5m0s)
      --dir-perms FileMode                     مجوزهای دایرکتوری (پیش‌فرض: 777)
      --direct-io                              استفاده از Direct IO، غیرفعال‌سازی کش کردن داده‌ها
      --file-perms FileMode                    مجوزهای فایل (پیش‌فرض: 666)
      --fuse-flag stringArray                  پرچم‌ها یا آرگومان‌هایی که مستقیماً به libfuse/WinFsp ارسال می‌شوند (در صورت نیاز تکرار شود)
      --gid uint32                             بازنویسی فیلد gid تنظیم‌شده توسط سیستم فایل (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض: 1000)
  -h, --help                                   راهنمای nfsmount
      --link-perms FileMode                    مجوزهای پیوند (پیش‌فرض: 666)
      --max-read-ahead SizeSuffix              تعداد بایت‌هایی که می‌توان برای خواندن‌های ترتیبی از پیش واکشی کرد (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض: 128Ki)
      --mount-case-insensitive Tristate        اعلام به سیستم‌عامل مبنی بر اینکه نقطه اتصال نسبت به بزرگی و کوچکی حروف حساس نیست (true) یا حساس است (false) صرف‌نظر از backend (مقدار auto) (پیش‌فرض: unset)
      --network-mode                           سوار کردن به عنوان درایو شبکه ریموت، به جای درایو دیسک ثابت (فقط در ویندوز پشتیبانی می‌شود)
      --nfs-cache-dir string                   دایرکتوری مورد استفاده کش دستگیره NFS در صورت تعیین
      --nfs-cache-handle-limit int             حداکثر دستگیره‌های فایل کش‌شده به صورت هم‌زمان (حداقل ۵) (پیش‌فرض: 1000000)
      --nfs-cache-type memory|disk|symlink     نوع حافظه موقت دستگیره NFS برای استفاده (پیش‌فرض: memory)
      --nfs-mount-path string                  زیرمسیر ریموت برای سوار کردن از طریق NFS (باید یک دایرکتوری موجود باشد) (پیش‌فرض: \[dq]/\[dq])
      --no-checksum                            عدم مقایسه چک‌سام‌ها هنگام بارگذاری/بارگیری
      --no-modtime                             عدم خواندن/نوشتن زمان تغییر (می‌تواند سرعت را افزایش دهد)
      --no-seek                                پرش (seek) در فایل‌ها مجاز نباشد
      --noappledouble                          نادیده گرفتن فایل‌های Apple Double (._) و .DS_Store (فقط در OSX پشتیبانی می‌شود) (پیش‌فرض: true)
      --noapplexattr                           نادیده گرفتن تمام ویژگی‌های توسعه‌یافته \[dq]com.apple.*\[dq] (فقط در OSX پشتیبانی می‌شود)
  -o, --option stringArray                     گزینه برای libfuse/WinFsp (در صورت نیاز تکرار شود)
      --poll-interval Duration                 مدت‌زمان انتظار میان نظرسنجی‌ها برای تغییرات، باید از dir-cache-time کمتر باشد و تنها روی ریموت‌های پشتیبانی‌شده عمل می‌کند (برای غیرفعال‌سازی 0 بگذارید) (پیش‌فرض: 1m0s)
      --read-only                              فقط اجازه دسترسی فقط‌خواندنی
      --sudo                                   استفاده از sudo برای اجرای دستورات mount/umount به عنوان کاربر ریشه.
      --uid uint32                             بازنویسی فیلد uid تنظیم‌شده توسط سیستم فایل (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض: 1000)
      --umask FileMode                         بازنویسی بیت‌های مجوز تعیین‌شده توسط سیستم فایل (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض: 002)
      --vfs-block-norm-dupes                   در صورت وجود نام فایل‌های تکراری در یک دایرکتوری (پس از نرمال‌سازی)، ثبت خطا و پنهان‌سازی موارد تکراری (ممکن است هزینه کارایی داشته باشد)
      --vfs-cache-max-age Duration             حداکثر زمان از آخرین دسترسی به اشیاء موجود در حافظه موقت (پیش‌فرض: 1h0m0s)
      --vfs-cache-max-size SizeSuffix          حداکثر اندازه کل اشیاء موجود در حافظه موقت (پیش‌فرض: off)
      --vfs-cache-min-free-space SizeSuffix    حداقل فضای خالی هدف روی دیسک حاوی حافظه موقت (پیش‌فرض: off)
      --vfs-cache-mode CacheMode               حالت حافظه موقت: off|minimal|writes|full (پیش‌فرض: off)
      --vfs-cache-poll-interval Duration       بازه زمانی برای بررسی حافظه موقت جهت یافتن اشیاء بیات‌شده (پیش‌فرض: 1m0s)
      --vfs-case-insensitive                   اگر نام فایلی یافت نشد، تطابق غیرحساس به بزرگی و کوچکی حروف پیدا شود
      --vfs-disk-space-total-size SizeSuffix   مشخص کردن فضای کل دیسک (پیش‌فرض: off)
      --vfs-fast-fingerprint                   استفاده از اثر انگشت‌های سریع (با دقت کمتر) برای تشخیص تغییرات
      --vfs-handle-caching Duration            مدت‌زمان نگهداری دستگیره فایل و دانلودکننده‌ها پس از آخرین بستن (پیش‌فرض: 5s)
      --vfs-links                              ترجمه پیوندهای نمادین به/از فایل‌های معمولی با پسوند \[aq].rclonelink\[aq] برای VFS
      --vfs-metadata-extension string          تنظیم پسوند برای خواندن متادیتا از آن
      --vfs-read-ahead SizeSuffix              پیش‌واکشی اضافی علاوه بر --buffer-size هنگام استفاده از cache-mode full
      --vfs-read-chunk-size SizeSuffix         خواندن اشیاء مبدأ به صورت تکه‌تکه (چانک) (پیش‌فرض: 128Mi)
      --vfs-read-chunk-size-limit SizeSuffix   اگر بیشتر از --vfs-read-chunk-size باشد، پس از هر بار خواندن اندازه تکه را دو برابر کن تا به حد مجاز برسد (\[aq]off\[aq] یعنی نامحدود) (پیش‌فرض: off)
      --vfs-read-chunk-streams int             تعداد جریان‌های موازی برای خواندن هم‌زمان
      --vfs-read-wait Duration                 مدت‌زمان انتظار برای خواندن متوالی قبل از پرش (seek) (پیش‌فرض: 20ms)
      --vfs-refresh                            تازه‌سازی بازگشتی کش دایرکتوری در پس‌زمینه هنگام شروع کار
      --vfs-used-is-size rclone size           استفاده از الگوریتم rclone size برای محاسبه اندازه استفاده‌شده (Used)
      --vfs-write-back Duration                مدت‌زمان بازنویسی فایل‌ها پس از آخرین استفاده هنگام استفاده از کش (پیش‌فرض: 5s)
      --vfs-write-wait Duration                مدت‌زمان انتظار برای نوشتن متوالی قبل از اعلام خطا (پیش‌فرض: 1s)
      --volname string                         تنظیم نام حجم (تنها در ویندوز و OSX پشتیبانی می‌شود)
      --write-back-cache                       وادار کردن هسته به بافر کردن نوشتن‌ها پیش از ارسال به rclone (بدون این گزینه از کش writethrough استفاده می‌شود) (در ویندوز پشتیبانی نمی‌شود)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورات در ادامه شرح داده شده‌اند.
برای مشاهده گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های
سراسری (https://rclone.org/flags) را ببینید..SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌ها برای فیلتر کردن فهرست‌های دایرکتوری
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنا شده‌اند
      --exclude stringArray                 مستثنا کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از \- برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنا کردن دایرکتوری‌ها در صورت وجود داشتن filename
      --files-from stringArray              خواندن فهرست نام فایل‌های مبدأ از فایل (استفاده از \- برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از فایل بدون هیچ‌گونه پردازش روی خطوط (استفاده از \- برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ از فایل با استفاده از NUL به عنوان جداکننده (استفاده از \- برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قاعده فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (استفاده از \- برای خواندن از stdin)
      --hash-filter string                  افراز نام فایل‌ها با هش k/n یا به صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (ناحساس به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شامل‌سازی فایل از فایل (استفاده از \- برای خواندن از stdin)
      --max-age Duration                    تنها انتقال فایل‌های جدیدتر از این مقدار بر حسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض \-1)
      --max-size SizeSuffix                 تنها انتقال فایل‌های کوچک‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنا کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (استفاده از \- برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قاعده فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متاداده از یک فایل (استفاده از \- برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شامل‌سازی متاداده از فایل (استفاده از \- برای خواندن از stdin)
      --min-age Duration                    تنها انتقال فایل‌های قدیمی‌تر از این مقدار بر حسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 تنها انتقال فایل‌های بزرگ‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone obscure
.PP
مبهم‌سازی گذرواژه برای استفاده در فایل پیکربندی rclone.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
در فایل پیکربندی rclone، گذرواژه‌های خوانا برای انسان مبهم‌سازی می‌شوند.
مبهم‌سازی آن‌ها از طریق رمزگذاری و نوشتن آن‌ها در قالب base64 انجام می‌شود.
این روش یک شیوهٔ امن برای رمزگذاری این گذرواژه‌ها \f[B]نیست\f[R] چرا که rclone می‌تواند آن‌ها را رمزگشایی کند \- هدف تنها جلوگیری از سرک کشیدن اتفاقی (\[dq]eyedropping\[dq]) است \- یعنی دیدن اتفاقی یک گذرواژه در فایل پیکربندی rclone توسط یک فرد.
.PP
بسیاری از موارد با اهمیت یکسان (مانند توکن‌های دسترسی) در فایل پیکربندی مبهم‌سازی نمی‌شوند.
با این حال، سرک کشیدن از پشت شانه (shoulder surf) برای دیدن یک توکن hex با ۶۴ نویسه بسیار دشوار است.
.PP
این دستور همچنین می‌تواند با ارسال یک خط تیره به عنوان آرگومان، به جای آرگومان گذرواژه را از طریق STDIN بپذیرد.
این کار نخستین خط STDIN را بدون احتساب نویسهٔ خط جدید پایانی به عنوان گذرواژه استفاده خواهد کرد.
.IP
.nf
\f[C]
echo \[aq]secretpassword\[aq] | rclone obscure -
\f[R]
.fi
.PP
اگر داده‌ای در STDIN برای خواندن وجود نداشته باشد، rclone obscure به طور پیش‌فرض خود خط تیره را مبهم‌سازی می‌کند.
.PP
اگر می‌خواهید فایل پیکربندی را رمزگذاری کنید، لطفاً از رمزگذاری فایل پیکربندی استفاده کنید \- برای اطلاعات بیشتر rclone config (https://rclone.org/commands/rclone_config) را ببینید.
.IP
.nf
\f[C]
rclone obscure password [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای obscure
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید..SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH "rclone rc"
.PP
اجرای یک دستور روی یک نمونهٔ در حال اجرای rclone.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این فرمان، دستوری را روی یک rclone در حال اجرا اجرا می‌کند.
از پرچم \f[V]--url\f[R] برای مشخص کردن یک URL غیرپیش‌فرض جهت اتصال
استفاده کنید.
این مقدار می‌تواند به صورت \[dq]:port\[dq] باشد که به معنی
http://localhost:port در نظر گرفته می‌شود، یا به صورت \[dq]host:port\[dq]
که به معنای http://host:port خواهد بود.
.PP
نام کاربری و گذرواژه را می‌توان با \f[V]--user\f[R] و
\f[V]--pass\f[R] ارسال کرد.
.PP
توجه داشته باشید که \f[V]--rc-addr\f[R]، \f[V]--rc-user\f[R] و \f[V]--rc-pass\f[R]
نیز برای \f[V]--url\f[R]، \f[V]--user\f[R] و
\f[V]--pass\f[R] خوانده خواهند شد.
.PP
پرچم \f[V]--unix-socket\f[R] می‌تواند برای اتصال از طریق یک سوکت
یونیکس به این صورت استفاده شود:
.IP
.nf
\f[C]
# start server on /tmp/my.socket
rclone rcd --rc-addr unix:///tmp/my.socket
# Connect to it
rclone rc --unix-socket /tmp/my.socket core/stats
\f[R]
.fi
.PP
آرگومان‌ها باید به صورت parameter=value ارسال شوند.
.PP
خروجی به طور پیش‌فرض در قالب یک شیء JSON بازگردانده خواهد شد.
.PP
پارامتر \f[V]--json\f[R] می‌تواند برای ارسال یک بلوک دادهٔ JSON به عنوان
ورودی به جای آرگومان‌های key=value استفاده شود.
این تنها روش برای ارسال مقادیر پیچیده‌تر است.
.PP
گزینهٔ \f[V]-o\f[R]/\f[V]--opt\f[R] می‌تواند برای تنظیم کلید
\[dq]opt\[dq] با گزینه‌های کلید و مقدار در قالب \f[V]-o key=value\f[R]
یا \f[V]-o key\f[R] استفاده شود.
این گزینه می‌تواند به تعداد دفعات مورد نیاز تکرار شود.
این قابلیت برای دستورهای rc که پارامتر \[dq]opt\[dq] (که طبق قرارداد
یک دیکشنری از رشته‌ها است) را می‌پذیرند مفید است.
.IP
.nf
\f[C]
-o key=value -o key2
\f[R]
.fi
.PP
مقدار زیر را در مقدار \[dq]opt\[dq] قرار می‌دهد:
.IP
.nf
\f[C]
{\[dq]key\[dq]:\[dq]value\[dq], \[dq]key2\[dq],\[dq]\[dq])
\f[R]
.fi
.PP
گزینهٔ \f[V]-a\f[R]/\f[V]--arg\f[R] می‌تواند برای تنظیم رشته‌ها در
مقدار \[dq]arg\[dq] به کار رود.
این گزینه می‌تواند به تعداد دفعات مورد نیاز تکرار شود.
این قابلیت برای دستورهای rc که پارامتر \[dq]arg\[dq] (که طبق قرارداد
یک فهرست از رشته‌ها است) را می‌پذیرند مفید است.
.IP
.nf
\f[C]
-a value -a value2
\f[R]
.fi
.PP
مقدار زیر را در مقدار \[dq]arg\[dq] قرار می‌دهد:
.IP
.nf
\f[C]
[\[dq]value\[dq], \[dq]value2\[dq]]
\f[R]
.fi
.PP
از \f[V]--loopback\f[R] برای اتصال به نمونهٔ rclone که در حال اجرای
\f[V]rclone rc\f[R] است استفاده کنید.
این قابلیت برای آزمایش دستورها بدون نیاز به راه‌اندازی سرور rclone rc بسیار مفید است، مانند:
.IP
.nf
\f[C]
rclone rc --loopback operations/about fs=/
\f[R]
.fi
.PP
از \f[V]rclone rc\f[R] برای مشاهدهٔ فهرستی از تمام دستورهای ممکن استفاده کنید.
.IP
.nf
\f[C]
rclone rc commands parameter [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -a, --arg stringArray      آرگومان قرار گرفته در آرایه \[dq]arg\[dq]
  -h, --help                 راهنمایی برای rc
      --json string          ورودی JSON - استفاده به جای آرگومان‌های key=value
      --loopback             در صورت تنظیم، اتصال به این نمونه rclone به روشی غیر از HTTP
      --no-output            در صورت تنظیم، نتیجه JSON چاپ نمی‌شود
  -o, --opt stringArray      گزینه به شکل name=value یا name قرار گرفته در آرایه \[dq]opt\[dq]
      --pass string          گذرواژه مورد استفاده برای اتصال به کنترل از راه دور rclone
      --unix-socket string   مسیر یک سوکت unix domain برای اتصال، به جای باز کردن مستقیم اتصال TCP
      --url string           نشانی URL برای اتصال به کنترل از راه دور rclone (پیش‌فرض \[dq]http://localhost:5572\[dq])
      --user string          نام کاربری مورد استفاده برای کنترل از راه دور rclone
\f[R]
.fi
.PP
برای گزینه‌های عمومی که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورات، پرچم‌ها و backendهای rclone.
.SH rclone rcat
.PP
ورودی استاندارد را در فایلی روی مقصد دوردست (remote) کپی می‌کند.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
داده‌ها را از ورودی استاندارد (stdin) می‌خواند و آن را در یک فایل دوردست واحد کپی می‌کند.
.IP
.nf
\f[C]
echo \[dq]hello world\[dq] | rclone rcat remote:path/to/file
ffmpeg - | rclone rcat remote:path/to/file
\f[R]
.fi
.PP
اگر فایل دوردست از قبل وجود داشته باشد، بازنویسی (overwrite) خواهد شد.
.PP
دستور rcat تلاش خواهد کرد تا فایل‌های کوچک را در یک درخواست واحد بارگذاری کند، که معمولاً کارآمدتر از نقاط پایانی بارگذاری جریانی/تکه‌تکه (streaming/chunked) است که از چندین درخواست استفاده می‌کنند.
رفتار دقیق به ریموت بستگی دارد.
آنچه که یک فایل کوچک محسوب می‌شود می‌تواند از طریق
\f[V]--streaming-upload-cutoff\f[R]
تنظیم شود.
بارگذاری تنها پس از رسیدن به این حد آستانه یا در صورتی که فایل پیش از آن به پایان برسد آغاز می‌شود.
داده‌ها باید در حافظه RAM بگنجند.
این حد آستانه باید به اندازه کافی کوچک باشد تا با محدودیت‌های ریموت شما سازگار باشد؛ لطفاً به مستندات آن مراجعه کنید.
به طور کلی، تنظیم بیش از حد بالای این آستانه، کارایی شما را کاهش خواهد داد.
.PP
از پرچم \f[V]--size\f[R] برای پیش‌تخصیص از پیشِ فایل در مقصد دوردست و ارسال جریانی (stream) واقعی آن استفاده کنید، حتی اگر backend ریموت از پخش جریانی پشتیبانی نکند.
.PP
مقدار \f[V]--size\f[R] باید اندازهٔ دقیق جریان ورودی بر حسب بایت باشد.
اگر اندازهٔ جریان با مقدار \f[V]--size\f[R] ارسال‌شده متفاوت باشد، انتقال به احتمال زیاد شکست خواهد خورد.
.PP
توجه داشته باشید که امکان تلاش مجدد (retry) برای بارگذاری وجود ندارد زیرا داده‌ها ذخیره نمی‌شوند.
اگر backend از بارگذاری چندبخشی (multipart) پشتیبانی کند، تکه‌های مجزا می‌توانند دوباره تلاش شوند.
اگر نیاز به انتقال داده‌های زیادی دارید، بهتر است ابتدا آن را به صورت محلی ذخیره (cache) کرده و سپس با استفاده از \f[V]rclone move\f[R] که از تلاش مجدد پشتیبانی می‌کند، آن را به مقصد منتقل نمایید.
.IP
.nf
\f[C]
rclone rcat remote:path [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help       راهنمایی برای rcat
      --size int   راهنمای اندازه فایل برای پیش‌تخصیص (پیش‌فرض -1)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های عمومی که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید..SS گزینه‌های مهم (Important Options)
.PP
پرچم‌های مهم و کاربردی برای بیشتر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات ماندگار
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ خروجی بسیار مفصل‌تر (برای جزئیات بیشتر تکرار شود)
\f[R]
.fi
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone rcd
.PP
اجرای rclone به‌گونه‌ای که فقط به دستورهای کنترل از راه دور گوش دهد.
.SS خلاصه دستور (SYNOPSIS)
.PP
این دستور rclone را به‌گونه‌ای اجرا می‌کند که تنها به دستورهای کنترل از راه دور گوش فرا دهد.
.PP
این قابلیت زمانی مفید است که بخواهید rclone را از طریق API کنترل از راه دور (rc) کنترل کنید.
.PP
اگر مسیری را به یک دایرکتوری مشخص کنید، rclone آن دایرکتوری را برای درخواست‌های GET روی URL ارائه‌شده سرو می‌کند.
همچنین هنگام اجرای rclone، این URL را در مرورگر باز خواهد کرد.
.PP
برای اطلاعات بیشتر درباره پرچم‌های rc، به مستندات rc (https://rclone.org/rc) مراجعه کنید.
.SS گزینه‌های سرور (Server options)
.PP
از \f[V]--rc-addr\f[R] برای مشخص کردن نشانی IP و پورتی که سرور باید روی آن گوش دهد استفاده کنید؛ مانند \f[V]--rc-addr 1.2.3.4:8000\f[R] یا \f[V]--rc-addr :8080\f[R] برای گوش دادن روی تمام IPها.
به‌طور پیش‌فرض سرور تنها روی localhost گوش می‌دهد.
می‌توانید از پورت :0 استفاده کنید تا سیستم‌عامل یک پورت آزاد را انتخاب کند.
.PP
اگر \f[V]--rc-addr\f[R] را طوری تنظیم کنید که روی یک نشانی IP عمومی یا قابل دسترس در شبکه محلی (LAN) گوش دهد، استفاده از احراز هویت توصیه می‌شود \- برای اطلاعات بیشتر بخش بعدی را ببینید.
.PP
می‌توانید با تنظیم URL روی \f[V]unix:///path/to/socket\f[R] یا صرفاً با استفاده از یک مسیر مطلق، از یک سوکت یونیکس استفاده کنید.
.PP
گزینه \f[V]--rc-addr\f[R] می‌تواند برای گوش دادن روی چندین IP/پورت/سوکت تکرار شود.
فعال‌سازی سوکت (Socket activation) که در ادامه توضیح داده شده نیز می‌تواند برای دستیابی به همین هدف استفاده شود.
.PP
از \f[V]--rc-server-read-timeout\f[R] و \f[V]--rc-server-write-timeout\f[R] می‌توان برای کنترل مهلت‌های زمانی روی سرور استفاده کرد.
توجه داشته باشید که این مقدار، زمان کل برای یک انتقال است.
.PP
گزینه \f[V]--rc-max-header-bytes\f[R] حداکثر تعداد بایت‌هایی را که سرور در هدر HTTP می‌پذیرد کنترل می‌کند.
.PP
از \f[V]--rc-response-header\f[R] می‌توان برای تنظیم یک هدر HTTP برای تمام پاسخ‌ها استفاده کرد، که مقادیر موجود را بازنویسی خواهد کرد.
این پرچم برای افزودن چندین هدر می‌تواند تکرار شود.
از قالب \f[V]Header-Name: value\f[R] استفاده کنید.
.PP
گزینه \f[V]--rc-baseurl\f[R] پیشوند URL که rclone از آن سرویس‌دهی می‌کند را کنترل می‌کند.
به‌طور پیش‌فرض rclone از ریشه سرویس می‌دهد.
اگر از \f[V]--rc-baseurl \[dq]/rclone\[dq]\f[R] استفاده کنید، rclone از URLای که با \[dq]/rclone/\[dq] آغاز می‌شود سرویس‌دهی خواهد کرد.
این قابلیت در صورتی که بخواهید سرویس‌دهی rclone را پروکسی کنید مفید است.
دستور rclone به‌طور خودکار کاراکترهای \[dq]/\[dq] ابتدا و انتها را به \f[V]--rc-baseurl\f[R] اضافه می‌کند، بنابراین \f[V]--rc-baseurl \[dq]rclone\[dq]\f[R]، \f[V]--rc-baseurl \[dq]/rclone\[dq]\f[R] و \f[V]--rc-baseurl \[dq]/rclone/\[dq]\f[R] همگی به یک شکل پردازش می‌شوند.
.PP
گزینه \f[V]--rc-disable-zip\f[R] می‌تواند برای غیرفعال کردن قابلیت بارگیری به‌صورت فشرده (zip) تنظیم شود.
.SS پروتکل (Protocol)
.PP
سرور از HTTP/1.1 و HTTP/2 پشتیبانی می‌کند.
برای اتصالات TLS، پروتکل HTTP/2 به‌طور خودکار استفاده می‌شود.
برای اتصالات غیر TLS، پروتکل متنی HTTP/2 (h2c) پشتیبانی می‌شود که امکان استفاده از HTTP/2 را بدون رمزنگاری فراهم می‌سازد..SS TLS (SSL)
.PP
به‌طور پیش‌فرض این سرویس روی http ارائه می‌شود.
در صورت تمایل می‌توانید آن را روی https ارائه دهید.
برای این کار باید پرچم‌های \f[V]--rc-cert\f[R] و \f[V]--rc-key\f[R]
را مشخص کنید.
اگر مایل به اعتبارسنجی گواهی سمت کلاینت هستید، باید
\f[V]--rc-client-ca\f[R] را نیز ارائه دهید.
.PP
هنگامی که TLS پیکربندی شود، هر شنونده‌ای که با \f[V]--rc-addr\f[R]
مشخص شده باشد TLS را ارائه می‌دهد.
یک شنونده خاص می‌تواند با پیشوند \f[V]http://\f[R] مشخص شود تا
HTTP رمزگذاری‌نشده را روی آن آدرس ارائه دهد، یا با \f[V]tls://\f[R] تا
صراحتاً اعلام کند که باید TLS ارائه دهد.
استفاده از آدرس \f[V]tls://\f[R] بدون \f[V]--rc-cert\f[R] و
\f[V]--rc-key\f[R] یک خطا محسوب می‌شود.
.PP
\f[V]--rc-cert\f[R] باید روی مسیر فایلی تنظیم شود که شامل گواهی با
کدبندی PEM، یا ترکیب آن با گواهی CA باشد.
\f[V]--rc-key\f[R] باید روی مسیر فایلی با کلید خصوصی با کدبندی PEM
تنظیم شود.
در صورت تنظیم \f[V]--rc-client-ca\f[R]، باید آن را روی مسیر فایلی حاوی
گواهی‌های مرجع صدور گواهی کلاینت با کدبندی PEM تنظیم کرد.
.PP
\f[V]--rc-min-tls-version\f[R] حداقل نسخه قابل‌قبول TLS است.
مقادیر معتبر عبارتند از \[dq]tls1.0\[dq]، \[dq]tls1.1\[dq]، \[dq]tls1.2\[dq]
و \[dq]tls1.3\[dq] (پیش‌فرض \[dq]tls1.0\[dq]).
.SS فعال‌سازی با سوکت (Socket activation)
.PP
به‌جای آدرس‌های شنیداری مشخص‌شده در بالا، rclone در صورت وجود به تمام
FDهای ارسال‌شده توسط مدیر سرویس گوش می‌دهد (و هر آرگومان ارسال‌شده
با \f[V]--rc-addr\f[R] را نادیده می‌گیرد).
.PP
این قابلیت اجازه می‌دهد rclone به عنوان یک سرویس با فعال‌سازی از طریق سوکت عمل کند.
این مورد را می‌توان با فایل‌های واحد .socket و .service همان‌طور که در
<https://www.freedesktop.org/software/systemd/man/latest/systemd.socket.html>
توضیح داده شده است پیکربندی کرد.
.PP
فعال‌سازی سوکت را می‌توان به‌طور موردی با دستور
\f[V]systemd-socket-activate\f[R] آزمایش کرد:
.IP
.nf
\f[C]
systemd-socket-activate -l 8000 -- rclone serve
\f[R]
.fi
.PP
این دستور با برقراری نخستین اتصال به پورت 8000 روی TCP، سرویس rclone را
از طریق سوکت فعال می‌کند.
.SS الگو (Template)
.PP
\f[V]--rc-template\f[R] به کاربر امکان می‌دهد یک الگوی نشانه‌گذاری سفارشی
برای توابع ارائه‌دهندهٔ HTTP و WebDAV تعیین کند.
سرور نشانه‌گذاری‌های زیر را برای استفاده در الگو جهت ارائه صفحات صادر می‌کند:
.PP
.TS
tab(@);
lw(22.6n) lw(24.7n) lw(22.6n).
T{
پارامتر
T}@T{
زیرپارامتر
T}@T{
توضیحات
T}
_
T{
\&.Name
T}@T{
T}@T{
مسیر کامل یک فایل/دایرکتوری.
T}
T{
\&.Title
T}@T{
T}@T{
فهرست دایرکتوری \[aq].Name\[aq].
T}
T{
\&.Sort
T}@T{
T}@T{
مرتب‌سازی فعلی مورد استفاده.
این مورد از طریق پارامتر \[aq]?sort=\[aq] قابل تغییر است.
مقادیر ممکن: namedirfirst، name، size، time (پیش‌فرض namedirfirst).
T}
T{
\&.Order
T}@T{
T}@T{
ترتیب فعلی مورد استفاده.
این مورد از طریق پارامتر \[aq]?order=\[aq] قابل تغییر است.
مقادیر ممکن: asc، desc (پیش‌فرض asc).
T}
T{
\&.Query
T}@T{
T}@T{
در حال حاضر استفاده نمی‌شود.
T}
T{
\&.Breadcrumb
T}@T{
T}@T{
امکان ایجاد ناوبری نسبی را فراهم می‌کند.
T}
T{
T}@T{
\&.Link
T}@T{
پیوند Text نسبت به ریشه.
T}
T{
T}@T{
\&.Text
T}@T{
نام دایرکتوری.
T}
T{
\&.Entries
T}@T{
T}@T{
اطلاعات مربوط به یک فایل/دایرکتوری خاص.
T}
T{
T}@T{
\&.URL
T}@T{
نشانی اینترنتی (url) یک مدخل.
T}
T{
T}@T{
\&.Leaf
T}@T{
در حال حاضر مشابه \[aq].URL\[aq] است اما قرار است تنها نام باشد.
T}
T{
T}@T{
\&.IsDir
T}@T{
مقدار بولی برای اینکه آیا یک مدخل دایرکتوری است یا خیر.
T}
T{
T}@T{
\&.Size
T}@T{
اندازه مدخل بر حسب بایت.
T}
T{
T}@T{
\&.ModTime
T}@T{
برچسب زمانی UTC یک مدخل.
T}
.TE
.PP
سرور همچنین توابع زیر را در دسترس قرار می‌دهد تا بتوان از آن‌ها درون الگو
استفاده کرد.
این توابع به گسترش گزینه‌ها برای رندر پویای HTML کمک می‌کنند.
می‌توان از آن‌ها برای رندر کردن HTML بر اساس شرایط خاص بهره برد.
.PP
.TS
tab(@);
lw(35.0n) lw(35.0n).
T{
تابع
T}@T{
توضیحات
T}
_
T{
afterEpoch
T}@T{
زمان سپری‌شده از epoch را برای زمان داده‌شده برمی‌گرداند.
T}
T{
contains
T}@T{
بررسی می‌کند که آیا یک زیررشته در رشته داده‌شده وجود دارد یا خیر.
T}
T{
hasPrefix
T}@T{
بررسی می‌کند که آیا رشته داده‌شده با پیشوند مشخص‌شده آغاز می‌شود یا خیر.
T}
T{
hasSuffix
T}@T{
بررسی می‌کند که آیا رشته داده‌شده با پسوند مشخص‌شده پایان می‌یابد یا خیر.
T}
.TE.SS احراز هویت (Authentication)
.PP
به‌طور پیش‌فرض، این دستور فایل‌ها را بدون نیاز به ورود ارائه می‌دهد.
.PP
می‌توانید از یک فایل htpasswd که قادر به نگهداری کاربران متعدد است استفاده کنید، یا یک نام کاربری و گذرواژهٔ یکتا را با پرچم‌های \f[V]--rc-user\f[R] و \f[V]--rc-pass\f[R] تنظیم نمایید.
.PP
همچنین می‌توانید مدیریت احراز هویت را به پراکسی معکوس بسپارید و با استفاده از \f[V]--user-from-header\f[R] نام کاربری ارائه‌شده در هدرِ پیکربندی‌شده را به کار بگیرید (برای نمونه: \f[V]--rc-user-from-header=x-remote-user\f[R]). اطمینان حاصل کنید که پراکسی مورد اعتماد است و امکان جعل هدرها وجود ندارد، زیرا پیکربندی نادرست می‌تواند به دسترسی‌های غیرمجاز منجر شود.
.PP
اگر هیچ‌یک از روش‌های احراز هویت بالا پیکربندی نشده باشد و با پرچم \f[V]--client-ca\f[R] ارسال‌شده به سرور، ارائهٔ گواهی‌های کلاینت الزامی شده باشد، نام معمول (Common Name) گواهی کلاینت به‌عنوان نام کاربری در نظر گرفته خواهد شد.
.PP
برای تعیین فایل htpasswd از \f[V]--rc-htpasswd /path/to/htpasswd\f[R] استفاده کنید.
این فایل در قالب استاندارد apache بوده و برای احراز هویت پایه‌ای از MD5، SHA1 و BCrypt پشتیبانی می‌کند.
استفاده از Bcrypt توصیه می‌شود.
.PP
برای ساخت یک فایل htpasswd:
.IP
.nf
\f[C]
touch htpasswd
htpasswd -B htpasswd user
htpasswd -B htpasswd anotherUser
\f[R]
.fi
.PP
فایل گذرواژه می‌تواند در حین اجرای rclone نیز به‌روزرسانی شود.
.PP
از \f[V]--rc-realm\f[R] برای تنظیم قلمرو (realm) احراز هویت استفاده کنید.
.PP
از \f[V]--rc-salt\f[R] برای تغییر سالت (salt) درهم‌سازی گذرواژه نسبت به مقدار پیش‌فرض استفاده نمایید.
.IP
.nf
\f[C]
rclone rcd <path to files to serve>* [flags]
\f[R]
.fi
.SS گزینه‌ها (Options)
.IP
.nf
\f[C]
  -h, --help   راهنمای rcd
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (<https://rclone.org/flags>) را ببینید.
.SS گزینه‌های RC (RC Options)
.PP
پرچم‌هایی برای کنترل API کنترل از راه دور (Remote Control)
.IP
.nf
\f[C]
      --rc                                 فعال‌سازی سرور کنترل از راه دور
      --rc-addr stringArray                آدرس IPaddress:Port یا :Port برای مقید کردن سرور (پیش‌فرض localhost:5572)
      --rc-allow-origin string             مبدأ مجاز برای اجرای درخواست‌های فرادامنه‌ای (CORS)
      --rc-baseurl string                  پیشوند برای URLها - برای ریشه خالی بگذارید
      --rc-cert string                     کلید TLS PEM (ترکیب گواهی و گواهی CA)
      --rc-client-ca string                مرجع صدور گواهی کلاینت برای اعتبارسنجی کلاینت‌ها
      --rc-enable-metrics                  فعال‌سازی مسیر معیارهای Prometheus در سرور کنترل از راه دور
      --rc-files string                    مسیر فایل‌های محلی برای ارائه روی سرور HTTP
      --rc-htpasswd string                 فایل htpasswd - در صورت عدم ارائه، احراز هویتی انجام نمی‌شود
      --rc-job-expire-duration Duration    منقضی کردن کارهای ناهمگام پایان‌یافتهٔ قدیمی‌تر از این مقدار (پیش‌فرض 1m0s)
      --rc-job-expire-interval Duration    بازهٔ زمانی بررسی کارهای ناهمگام منقضی‌شده (پیش‌فرض 10s)
      --rc-key string                      کلید خصوصی TLS PEM
      --rc-max-header-bytes int            حداکثر اندازهٔ هدر درخواست (پیش‌فرض 4096)
      --rc-min-tls-version string          حداقل نسخهٔ TLS قابل قبول (پیش‌فرض \[dq]tls1.0\[dq])
      --rc-no-auth                         عدم الزام احراز هویت برای برخی متدها
      --rc-pass string                     گذرواژه برای احراز هویت
      --rc-realm string                    قلمرو (Realm) برای احراز هویت
      --rc-response-header stringArray     تنظیم هدر HTTP برای تمام پاسخ‌ها و جایگزینی مقادیر موجود
      --rc-salt string                     سالت (Salt) درهم‌سازی گذرواژه (پیش‌فرض \[dq]dlPL2MqE\[dq])
      --rc-serve                           فعال‌سازی ارائهٔ اشیاء از راه دور
      --rc-serve-no-modtime                عدم خواندن زمان تغییر (می‌تواند کارایی را افزایش دهد)
      --rc-server-read-timeout Duration    مهلت زمانی خواندن داده توسط سرور (پیش‌فرض 1h0m0s)
      --rc-server-write-timeout Duration   مهلت زمانی نوشتن داده توسط سرور (پیش‌فرض 1h0m0s)
      --rc-template string                 قالب مشخص‌شده توسط کاربر
      --rc-user string                     نام کاربری برای احراز هویت
      --rc-user-from-header string         نام کاربری از هدر HTTP مشخص‌شده
      --rc-web-fetch-url string            آدرس URL برای دریافت انتشارها جهت webgui (پیش‌فرض \[dq]https://api.github.com/repos/rclone/rclone-webui-react/releases/latest\[dq])
      --rc-web-gui                         اجرای WebGUI روی localhost
      --rc-web-gui-force-update            ارتقای اجباری به آخرین نسخهٔ web gui
      --rc-web-gui-no-open-browser         عدم باز کردن خودکار مرورگر
      --rc-web-gui-update                  بررسی و به‌روزرسانی به آخرین نسخهٔ web gui
\f[R]
.fi.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone rmdirs
.PP
دایرکتوری‌های خالی موجود در مسیر را حذف می‌کند.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور به‌طور بازگشتی تمام دایرکتوری‌های خالی (از جمله دایرکتوری‌هایی
که تنها حاوی دایرکتوری‌های خالی هستند) را که در این مسیر می‌یابد، حذف می‌کند.
خودِ مسیر ریشه نیز اگر خالی باشد حذف خواهد شد، مگر اینکه
پرچم \f[V]--leave-root\f[R] را مشخص کرده باشید.
.PP
برای حذف کردنِ فقط همان دایرکتوری خالی مشخص‌شده با مسیر (نه به‌صورت بازگشتی)،
از دستور rmdir (https://rclone.org/commands/rclone_rmdir) استفاده کنید.
.PP
این دستور برای پاک‌سازی remoteهایی که rclone در آن‌ها دایرکتوری‌های خالی
زیادی به جا گذاشته است، مفید است.
برای مثال، دستور delete (https://rclone.org/commands/rclone_delete)
فایل‌ها را حذف می‌کند اما ساختار دایرکتوری را باقی می‌گذارد (مگر اینکه
همراه با گزینهٔ \f[V]--rmdirs\f[R] استفاده شود).
.PP
این دستور دایرکتوری‌ها را به تعداد \f[V]--checkers\f[R] به‌طور هم‌زمان حذف خواهد کرد؛
بنابراین اگر هزاران دایرکتوری خالی دارید، افزایش این مقدار را مد نظر قرار دهید.
.PP
برای حذف یک مسیر و تمام شیءهای درون آن، از
دستور purge (https://rclone.org/commands/rclone_purge) استفاده کنید.
.IP
.nf
\f[C]
rclone rmdirs remote:path [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help         راهنمای rmdirs
      --leave-root   عدم حذف دایرکتوری ریشه در صورت خالی بودن
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری
(https://rclone.org/flags) را ببینید.
.SS "گزینه‌های مهم (IMPORTANT OPTIONS)"
.PP
پرچم‌های مهمی که برای بیشتر دستورها مفید هستند
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ اطلاعات بسیار بیشتر (برای اطلاعات بیشتر تکرار کنید)
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone selfupdate
.PP
به‌روزرسانی باینری rclone.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور آخرین نگارش منتشرشده از rclone را دانلود کرده و جایگزین
باینری در حال اجرای فعلی می‌کند.
دانلود با یک چک‌سوم هش (hashsum) و امضای رمزنگاری‌شده تأیید می‌شود؛
برای جزئیات، به اسناد امضای انتشار
(https://rclone.org/release_signing) مراجعه کنید.
.PP
اگر بدون پرچم (یا با پرچم ضمنی \f[V]--stable\f[R]) استفاده شود، این
دستور آخرین نگارش پایدار را نصب خواهد کرد.
با این حال، ممکن است برخی مشکلات تنها در آخرین نگارش بتا برطرف شده
باشند (یا ویژگی‌هایی فقط به آن اضافه شده باشند).
در چنین مواردی باید دستور را با پرچم \f[V]--beta\f[R] اجرا کنید؛
یعنی \f[V]rclone selfupdate --beta\f[R].
می‌توانید با افزودن پرچم \f[V]--check\f[R] از پیش بررسی کنید که چه
نسخه‌ای نصب خواهد شد، سپس هنگامی که رضایت داشتید دستور را بدون آن تکرار کنید.
.PP
گاهی اوقات ممکن است تیم rclone برای عیب‌یابی مشکل شما یا افزودن
یک ویژگی بسیار جدید (bleeding edge)، نگارش پایدار یا بتای مشخصی از
rclone را توصیه کند.
پرچم \f[V]--version VER\f[R]، در صورت مشخص شدن، به جای آخرین نسخه،
به همان نسخهٔ مشخص به‌روزرسانی خواهد کرد.
اگر نسخهٔ خرد (micro version) را از \f[V]VER\f[R] حذف کنید (برای مثال
\f[V]1.53\f[R])، آخرین نسخهٔ خرد منطبق استفاده خواهد شد.
.PP
پس از به‌روزرسانی موفق، rclone پیامی چاپ می‌کند که حاوی شمارهٔ نسخهٔ
قبلی است.
اگر بعداً به هر دلیلی تصمیم بگیرید به‌روزرسانی خود را بازگردانی (revert) کنید،
به آن نیاز خواهید داشت.
در این صورت باید نسخهٔ قبلی را یادداشت کرده و دستور زیر را اجرا
کنید: \f[V]rclone selfupdate [--beta] OLDVER\f[R].
اگر نسخهٔ قدیمی فقط شامل نقطه و عدد باشد (برای مثال
\f[V]v1.54.0\f[R])، آن‌گاه یک نگارش پایدار است و بنابراین به
پرچم \f[V]--beta\f[R] نیازی نخواهید داشت.
نگارش‌های بتا دارای اطلاعات اضافی مشابه
\f[V]v1.54.0-beta.5111.06f1c0c61\f[R] هستند.
(اگر توسعه‌دهنده هستید و از rclone ساخته‌شده به صورت محلی استفاده می‌کنید، شمارهٔ
نسخه با \f[V]-DEV\f[R] خاتمه می‌یابد؛ از آنجا که بدیهی است چنین نسخه‌ای
نمی‌تواند توزیع شود، باید خودتان دوباره آن را بسازید).
.PP
اگر قبلاً rclone را از طریق یک مدیر بسته نصب کرده‌اید، ممکن است بسته
شامل مستندات محلی باشد یا سرویس‌هایی را پیکربندی کند.
ممکن است بخواهید با پرچم \f[V]--package deb\f[R] یا
\f[V]--package rpm\f[R] (هر کدام که برای سیستم‌عامل شما مناسب است) به‌روزرسانی کنید
تا این موارد نیز به‌روز شوند.
این دستور با حالت پیش‌فرض \f[V]--package zip\f[R] تنها فایل اجرایی rclone
را به‌روز می‌کند، بنابراین ممکن است پس از آن، راهنمای محلی نادقیق شود.
.PP
دستور rclone mount (https://rclone.org/commands/rclone_mount) بسته
به ساخت (build) و سیستم‌عامل ممکن است از گزینه‌های گسترش‌یافتهٔ FUSE
پشتیبانی کند یا نکند.
اگر این قابلیت از بین برود، \f[V]selfupdate\f[R] از انجام به‌روزرسانی
خودداری خواهد کرد.
.PP
نکته: ویندوز حذف فایل اجراییِ در حال اجرا را ممنوع می‌کند، بنابراین این
دستور در صورت موفقیت، نام فایل اجرایی قدیمی را به \[aq]rclone.old.exe\[aq]
تغییر خواهد داد.
.PP
لطفاً توجه داشته باشید که این دستور پیش از نسخهٔ 1.55 rclone در
دسترس نبود.
اگر این دستور برای شما با پیام
\f[V]unknown command \[dq]selfupdate\[dq]\f[R] با شکست مواجه شد، باید
طبق مستندات نصب (https://rclone.org/install) به‌طور دستی اقدام به
به‌روزرسانی کنید.
.IP
.nf
\f[C]
rclone selfupdate [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --beta             نصب نسخه بتا
      --check            بررسی برای آخرین نسخه، بدون بارگیری
  -h, --help             راهنمایی برای selfupdate
      --output string    ذخیره باینری بارگیری‌شده در مسیر داده‌شده (پیش‌فرض: جایگزینی باینری در حال اجرا)
      --package string   قالب بسته: zip|deb|rpm (پیش‌فرض: zip)
      --stable           نصب نسخه پایدار (این پیش‌فرض است)
      --version string   نصب نسخه داده‌شده rclone (پیش‌فرض: latest)
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone serve
.PP
ارائه یک remote از طریق یک پروتکل.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
ارائه یک remote از طریق یک پروتکل مشخص.
نیازمند استفاده از یک زیردستور برای تعیین پروتکل است؛ مانند:
.IP
.nf
\f[C]
rclone serve http remote:
\f[R]
.fi
.PP
هنگامی که پرچم \[dq]--metadata\[dq] فعال باشد، فیلدهای متادیتای زیر
به‌عنوان سرآیند ارائه خواهند شد: \- \[dq]content-disposition\[dq] \-
\[dq]cache-control\[dq] \- \[dq]content-language\[dq] \-
\[dq]content-encoding\[dq] نکته: در دسترس بودن این فیلدها به این
بستگی دارد که آیا remote از متادیتا پشتیبانی می‌کند یا خیر.
.PP
هر زیردستور گزینه‌های ویژه خود را دارد که می‌توانید آن‌ها را در راهنمای مربوطه‌شان مشاهده کنید.
.IP
.nf
\f[C]
rclone serve <protocol> [opts] <remote> [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمایی برای serve
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.IP \[bu] 2
rclone serve dlna (https://rclone.org/commands/rclone_serve_dlna) \-
ارائه remote:path از طریق DLNA.
.IP \[bu] 2
rclone serve docker (https://rclone.org/commands/rclone_serve_docker) \-
ارائه هر remote روی API افزونه volume در docker.
.IP \[bu] 2
rclone serve ftp (https://rclone.org/commands/rclone_serve_ftp) \- ارائه
remote:path از طریق FTP.
.IP \[bu] 2
rclone serve http (https://rclone.org/commands/rclone_serve_http) \-
ارائه remote از طریق HTTP.
.IP \[bu] 2
rclone serve nfs (https://rclone.org/commands/rclone_serve_nfs) \- ارائه
remote به‌عنوان یک mount از نوع NFS.
.IP \[bu] 2
rclone serve restic (https://rclone.org/commands/rclone_serve_restic) \-
ارائه remote برای REST API ابزار restic.
.IP \[bu] 2
rclone serve s3 (https://rclone.org/commands/rclone_serve_s3) \- ارائه
remote:path از طریق s3.
.IP \[bu] 2
rclone serve sftp (https://rclone.org/commands/rclone_serve_sftp) \-
ارائه remote از طریق SFTP.
.IP \[bu] 2
rclone serve webdav (https://rclone.org/commands/rclone_serve_webdav) \-
ارائه remote:path از طریق WebDAV..SH rclone serve dlna
.PP
ارائه remote:path از طریق DLNA
.SS "خلاصه دستور (SYNOPSIS)"
.PP
اجرای یک سرور چندرسانه‌ای DLNA برای رسانه‌های ذخیره‌شده در یک ریموت rclone.
بسیاری از دستگاه‌ها، مانند Xbox و PlayStation، می‌توانند این سرور را به‌طور خودکار در شبکه محلی (LAN) شناسایی کرده و فایل‌های صوتی/تصویری را از آن پخش کنند.
پخش‌کننده VLC نیز پشتیبانی می‌شود.
شناسایی سرویس از بسته‌های چندپخشی UDP بر بستر SSDP استفاده می‌کند و بنابراین تنها در شبکه‌های محلی (LAN) کار خواهد کرد.
.PP
ابزار rclone بدون اعمال فیلتر بر اساس قالب‌های رسانه‌ای یا پسوند فایل‌ها، تمامی فایل‌های موجود در ریموت را فهرست می‌کند.
علاوه بر این، هیچ پشتیبانی از ترنسکود (تبدیل فرمت) رسانه‌ها وجود ندارد.
این بدان معناست که برخی از پخش‌کننده‌ها ممکن است فایل‌هایی را نمایش دهند که قادر به پخش صحیح آن‌ها نیستند.
.PP
ابزار rclone فایل‌های زیرنویس خارجی (\&.srt) را در صورتی که نام فایلی یکسان با خود فایل ویدیو (به‌جز پسوند) داشته باشند، چه در همان دایرکتوری ویدیو و چه در زیردایرکتوری \[dq]Subs\[dq] قرار گرفته باشند، به ویدیوها اضافه خواهد کرد.
.SS "گزینه‌های سرور (Server options)"
.PP
از \f[V]--addr\f[R] برای تعیین آدرس IP و پورتی که سرور باید روی آن گوش فرا دهد استفاده کنید، به عنوان مثال \f[V]--addr 1.2.3.4:8000\f[R] یا \f[V]--addr :8080\f[R] برای گوش دادن روی تمام IPها.
.PP
از \f[V]--name\f[R] برای انتخاب نام سرور (friendly name) استفاده کنید که به‌طور پیش‌فرض \[dq]rclone (hostname)\[dq] است.
.PP
از \f[V]--log-trace\f[R] به همراه \f[V]-vv\f[R] برای فعال‌سازی ثبت لاگ‌های اشکال‌زدایی (debug) اضافی مربوط به تمام ترافیک UPNP استفاده کنید.
.SS "سیستم فایل مجازی (VFS - Virtual File System)"
.PP
این دستور از لایه VFS استفاده می‌کند.
این لایه اشیاء فضای ذخیره‌سازی ابری را که rclone به کار می‌گیرد، به ساختاری تبدیل می‌کند که بسیار شبیه به سیستم فایل دیسک به نظر می‌رسد.
.PP
اشیاء ذخیره‌سازی ابری ویژگی‌های متعددی دارند که مانند فایل‌های روی دیسک نیستند \- نمی‌توانید اندازه آن‌ها را گسترش دهید یا در میانه‌شان بنویسید، بنابراین لایه VFS باید این موارد را مدیریت کند.
از آنجا که روش یگانه‌ای برای انجام این کار وجود ندارد، گزینه‌های مختلفی وجود دارد که در ادامه توضیح داده شده‌اند.
.PP
لایه VFS همچنین یک کش دایرکتوری پیاده‌سازی می‌کند \- این قابلیت اطلاعات مربوط به فایل‌ها و دایرکتوری‌ها (نه خود داده‌ها) را در حافظه کش می‌کند.
.SS "کش دایرکتوری VFS (VFS Directory Cache)"
.PP
با استفاده از گزینه \f[V]--dir-cache-time\f[R]، می‌توانید مشخص کنید که یک دایرکتوری چه مدت به‌روز در نظر گرفته شود و از بک‌اند بازخوانی نشود.
تغییرات اعمال‌شده از طریق VFS بلافاصله نمایان می‌شوند یا کش را باطل می‌کنند.
.IP
.nf
\f[C]
    --dir-cache-time duration   مدت زمان نگهداری ورودی‌های دایرکتوری در کش (پیش‌فرض 5m0s)
    --poll-interval duration    مدت زمان انتظار میان بررسی تغییرات. باید کمتر از dir-cache-time باشد. فقط در ریموت‌های پشتیبانی‌شده. برای غیرفعال‌سازی روی 0 تنظیم کنید (پیش‌فرض 1m0s)
\f[R]
.fi
.PP
با این حال، چنانچه بک‌اند پیکربندی‌شده از بررسی تغییرات پشتیبانی نکند، تغییراتی که مستقیماً از طریق رابط کاربری وب فضای ابری یا توسط یک نسخه مجزای rclone ایجاد شوند، تنها زمانی اعمال خواهند شد که کش دایرکتوری منقضی شود.
اگر بک‌اند از بررسی تغییرات (polling) پشتیبانی کند، تغییرات در بازه زمانی تعیین‌شده برای poll شناسایی خواهند شد.
.PP
می‌توانید یک سیگنال \f[V]SIGHUP\f[R] به rclone ارسال کنید تا صرف‌نظر از میزان قدمت کش‌ها، تمام کش‌های دایرکتوری را تخلیه کند.
با فرض اینکه تنها یک نمونه rclone در حال اجرا است، می‌توانید کش را به این شکل بازنشانی کنید:
.IP
.nf
\f[C]
kill -SIGHUP $(pidof rclone)
\f[R]
.fi
.PP
اگر rclone را همراه با کنترل از راه دور (remote control) پیکربندی کنید، می‌توانید از rclone rc برای تخلیه کامل کش دایرکتوری استفاده نمایید:
.IP
.nf
\f[C]
rclone rc vfs/forget
\f[R]
.fi
.PP
یا برای فایل‌ها یا دایرکتوری‌های جداگانه:
.IP
.nf
\f[C]
rclone rc vfs/forget file=path/to/file dir=path/to/dir
\f[R]
.fi.SS بافرسازی فایل VFS
.PP
پرچم \f[V]--buffer-size\f[R] مقدار حافظه‌ای را که برای پیش‌بافرسازی داده‌ها استفاده می‌شود، مشخص می‌کند.
.PP
هر فایلِ باز تلاش خواهد کرد تا مقدار داده تعیین‌شده را همواره در حافظه نگه دارد.
داده‌های بافرشده مقید به یک فایل باز هستند و به اشتراک گذاشته نخواهند شد.
.PP
این پرچم یک حد بالایی برای حافظه مصرفی به ازای هر فایل باز است.
بافر تنها برای داده‌هایی از حافظه استفاده خواهد کرد که بارگیری شده اما هنوز خوانده نشده‌اند.
اگر بافر خالی باشد، تنها مقدار اندکی حافظه مصرف خواهد شد.
.PP
حداکثر حافظه استفاده‌شده توسط rclone برای بافرسازی می‌تواند تا
\f[V]--buffer-size * open files\f[R] باشد.
.SS کش‌سازی فایل VFS
.PP
این پرچم‌ها گزینه‌های کش‌سازی فایل VFS را کنترل می‌کنند.
کش‌سازی فایل برای اینکه لایه VFS با یک فایل‌سیستم عادی سازگار به نظر برسد ضروری است.
این قابلیت می‌تواند به بهای از دست رفتن بخشی از سازگاری غیرفعال شود.
.PP
برای نمونه، اگر می‌خواهید به طور هم‌زمان در یک فایل بخوانید و بنویسید، باید کش‌سازی VFS را فعال کنید.
برای جزئیات بیشتر به بخش زیر مراجعه کنید.
.PP
توجه داشته باشید که کش VFS از بک‌اندِ کش مجزا است و ممکن است متوجه شوید که به یکی از آن‌ها یا هر دو نیاز دارید.
.IP
.nf
\f[C]
    --cache-dir string                     دایرکتوری مورد استفاده rclone برای کش‌سازی.
    --vfs-cache-mode CacheMode             حالت کش off|minimal|writes|full (پیش‌فرض off)
    --vfs-cache-max-age duration           حداکثر زمان از آخرین دسترسی به اشیاء در کش (پیش‌فرض 1h0m0s)
    --vfs-cache-max-size SizeSuffix        حداکثر اندازه کل اشیاء در کش (پیش‌فرض off)
    --vfs-cache-min-free-space SizeSuffix  حداقل فضای خالی هدف روی دیسک حاوی کش (پیش‌فرض off)
    --vfs-cache-poll-interval duration     بازه زمانی بررسی کش برای اشیاء بی‌استفاده (پیش‌فرض 1m0s)
    --vfs-write-back duration              زمان بازنویسی فایل‌ها پس از آخرین استفاده هنگام استفاده از کش (پیش‌فرض 5s)
\f[R]
.fi
.PP
اگر با \f[V]-vv\f[R] اجرا شود، rclone مکان کش فایل را چاپ خواهد کرد.
فایل‌ها در ناحیه فایل‌های کش کاربر که وابسته به سیستم‌عامل است ذخیره می‌شوند، اما می‌توان آن را با \f[V]--cache-dir\f[R] یا مقداردهی متغیر محیطی مناسب کنترل کرد.
.PP
کش دارای ۴ حالت مختلف است که توسط \f[V]--vfs-cache-mode\f[R] انتخاب می‌شوند.
هرچه حالت کش بالاتر باشد، rclone به بهای مصرف فضای دیسک، سازگارتر می‌شود.
.PP
توجه داشته باشید که فایل‌ها تنها زمانی در ریموت بازنویسی می‌شوند که بسته شده باشند و به مدت \f[V]--vfs-write-back\f[R] ثانیه دسترسی به آن‌ها انجام نشده باشد.
اگر rclone بسته شود یا در حالی که فایل‌هایی آپلودنشده باقی مانده‌اند متوقف گردد، این فایل‌ها دفعه بعد که rclone با همان پرچم‌ها اجرا شود، آپلود خواهند شد.
.PP
در صورت استفاده از \f[V]--vfs-cache-max-size\f[R] یا
\f[V]--vfs-cache-min-free-space\f[R] توجه داشته باشید که کش ممکن است به دو دلیل از این سهمیه‌ها فراتر رود.
نخست به این دلیل که کش تنها در هر \f[V]--vfs-cache-poll-interval\f[R] بررسی می‌شود.
دوم به این دلیل که فایل‌های باز را نمی‌توان از کش تخلیه کرد.
هنگامی که از \f[V]--vfs-cache-max-size\f[R] یا
\f[V]--vfs-cache-min-free-space\f[R] فراتر رود، rclone ابتدا تلاش می‌کند فایل‌هایی با کمترین میزان دسترسی را از کش تخلیه کند.
rclone کار را با فایل‌هایی آغاز خواهد کرد که بیشترین زمان از آخرین دسترسی به آن‌ها گذشته است.
این راهبرد پاک‌سازی کش کارآمد است و احتمال باقی ماندن فایل‌های مرتبط‌تر در کش بیشتر خواهد بود.
.PP
پرچم \f[V]--vfs-cache-max-age\f[R] فایل‌ها را پس از گذشت زمان تعیین‌شده از آخرین دسترسی، از کش تخلیه می‌کند؛ این فرآیند بر پایه زمان دسترسی است، نه زمانی که فایل برای نخستین‌بار به کش افزوده شد.
مقدار پیش‌فرض ۱ ساعت شروع به تخلیه فایل‌هایی از کش می‌کند که به مدت ۱ ساعت دسترسی به آن‌ها انجام نشده است.
هنگامی که به یک فایل کش‌شده دسترسی پیدا شود، زمان‌سنج ۱ ساعته به ۰ بازنشانی می‌شود و پیش از تخلیه، ۱ ساعت دیگر منتظر می‌ماند.
زمان را با نمادگذاری استاندارد s, m, h, d, w مشخص کنید.
.PP
در صورت استفاده از \f[V]--vfs-cache-mode > off\f[R]، شما \f[B]نباید\f[R] دو نسخه از rclone را با استفاده از یک کش VFS یکسان با ریموت‌های مشابه یا هم‌پوشان اجرا کنید.
اگر چنین کنید، این کار می‌تواند احتمالاً باعث خرابی داده‌ها شود.
می‌توانید با اختصاص دادن سلسله‌مراتب کش اختصاصی به هر rclone از طریق \f[V]--cache-dir\f[R] این مشکل را دور بزنید.
اگر ریموت‌های مورد استفاده هم‌پوشانی ندارند، نیازی به نگرانی در این مورد ندارید..SS --vfs-cache-mode off
.PP
در این حالت (حالت پیش‌فرض)، حافظهٔ نهان مستقیماً از سرور راه دور می‌خواند و مستقیماً روی آن می‌نویسد، بدون آنکه چیزی را روی دیسک کَش کند.
.PP
این امر بدین معنی است که برخی عملیات امکان‌پذیر نخواهند بود:
.IP \[bu] 2
فایل‌ها نمی‌توانند هم‌زمان برای هر دو عمل خواندن و نوشتن باز شوند
.IP \[bu] 2
امکان پیمایش (seek) در فایل‌های باز شده برای نوشتن وجود ندارد
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید دارای پرچم O_TRUNC باشند
.IP \[bu] 2
فایل‌های باز شده برای خواندن همراه با O_TRUNC به‌صورت فقط‌نوشتنی باز خواهند شد
.IP \[bu] 2
فایل‌های باز شده به‌صورت فقط‌نوشتنی به‌گونه‌ای رفتار می‌کنند که گویی O_TRUNC مشخص شده است
.IP \[bu] 2
حالت‌های باز کردن O_APPEND و O_TRUNC نادیده گرفته می‌شوند
.IP \[bu] 2
اگر یک بارگذاری با شکست مواجه شود، امکان تلاش مجدد وجود ندارد
.SS --vfs-cache-mode minimal
.PP
این حالت بسیار شبیه به \[dq]off\[dq] است، با این تفاوت که فایل‌های باز شده برای خواندن و نوشتن، روی دیسک بافر می‌شوند.
این بدین معناست که فایل‌های باز شده برای نوشتن سازگاری بسیار بیشتری خواهند داشت، اما حداقل فضای دیسک مصرف می‌شود.
.PP
این عملیات امکان‌پذیر نیستند:
.IP \[bu] 2
فایل‌های باز شده به‌صورت فقط‌نوشتنی امکان پیمایش (seek) ندارند
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید دارای پرچم O_TRUNC باشند
.IP \[bu] 2
فایل‌های باز شده به‌صورت فقط‌نوشتنی، O_APPEND و O_TRUNC را نادیده می‌گیرند
.IP \[bu] 2
اگر یک بارگذاری با شکست مواجه شود، امکان تلاش مجدد وجود ندارد
.SS --vfs-cache-mode writes
.PP
در این حالت، فایل‌های باز شده به‌صورت فقط‌خواندنی همچنان مستقیماً از راه دور خوانده می‌شوند، اما فایل‌های فقط‌نوشتنی و خواندنی/نوشتنی ابتدا روی دیسک بافر می‌شوند.
.PP
این حالت باید از تمام عملیات عادی سیستم فایل پشتیبانی کند.
.PP
اگر یک بارگذاری ناموفق باشد، تلاش مجدد در فواصل زمانی با افزایش تصاعدی تا حداکثر ۱ دقیقه انجام خواهد شد.
.SS --vfs-cache-mode full
.PP
در این حالت، تمام عملیات خواندن و نوشتن از دیسک و روی آن بافر می‌شوند.
هنگامی که داده‌ها از مبدا راه دور خوانده می‌شوند، روی دیسک نیز بافر خواهند شد.
.PP
در این حالت، فایل‌های موجود در حافظهٔ نهان به‌صورت فایل‌های پراکنده (sparse files) خواهند بود و rclone بخش‌هایی از فایل را که بارگیری کرده پیگیری می‌کند.
.PP
بنابراین اگر برنامه‌ای تنها آغاز هر فایل را بخواند، rclone نیز تنها ابتدای فایل را بافر می‌کند.
این فایل‌ها در حافظهٔ نهان با اندازهٔ کامل خود نمایش داده می‌شوند، اما در واقع فایل‌های پراکنده‌ای خواهند بود که فقط داده‌های بارگیری‌شده در آنها وجود دارد.
.PP
این حالت باید از تمام عملیات معمول سیستم فایل پشتیبانی کند و در باقی موارد مشابه با \f[V]--vfs-cache-mode\f[R] writes است.
.PP
هنگام خواندن یک فایل، rclone به اندازهٔ \f[V]--buffer-size\f[R] به‌علاوهٔ \f[V]--vfs-read-ahead\f[R] بایت جلوتر را پیش‌خوانی می‌کند.
مقدار \f[V]--buffer-size\f[R] در حافظه رم بافر می‌شود، در حالی که \f[V]--vfs-read-ahead\f[R] روی دیسک بافر خواهد شد.
.PP
هنگام استفاده از این حالت، توصیه می‌شود که \f[V]--buffer-size\f[R] بیش از حد بزرگ تنظیم نشود و در صورت نیاز، \f[V]--vfs-read-ahead\f[R] مقداری بزرگ داشته باشد.
.PP
\f[B]مهم:\f[R] همهٔ سیستم‌های فایل از فایل‌های پراکنده پشتیبانی نمی‌کنند.
به‌ویژه FAT/exFAT از آن پشتیبانی ندارند.
اگر دایرکتوری حافظهٔ نهان روی سیستم فایلی باشد که از فایل‌های پراکنده پشتیبانی نمی‌کند، rclone عملکرد بسیار ضعیفی خواهد داشت و در صورت شناسایی چنین موردی، یک پیام خطای ERROR ثبت خواهد کرد.
.SS انگشت‌نگاری (Fingerprinting)
.PP
بخش‌های مختلف VFS از انگشت‌نگاری برای بررسی اینکه آیا نسخهٔ محلی فایل نسبت به فایل راه دور تغییر کرده است یا خیر استفاده می‌کنند.
اثرانگشت‌ها از موارد زیر ساخته می‌شوند:
.IP \[bu] 2
اندازه (size)
.IP \[bu] 2
زمان آخرین تغییر (modification time)
.IP \[bu] 2
هش (hash)
.PP
در صورتی که روی یک شیء موجود باشند.
.PP
در برخی بک‌اندها، خواندن برخی از این مشخصه‌ها کُند است (نیازمند یک فراخوانی API اضافی برای هر شیء یا پردازش مضاعف برای هر شیء هستند).
.PP
برای نمونه، محاسبهٔ \f[V]hash\f[R] در بک‌اندهای \f[V]local\f[R] و \f[V]sftp\f[R] کند است زیرا باید کل فایل را خوانده و هش آن را محاسبه کنند، و دریافت \f[V]modtime\f[R] در بک‌اندهای \f[V]s3\f[R]، \f[V]swift\f[R]، \f[V]ftp\f[R] و \f[V]qinqstor\f[R] کند است زیرا نیاز به یک فراخوانی API اضافی برای واکشی آن دارند.
.PP
اگر از پرچم \f[V]--vfs-fast-fingerprint\f[R] استفاده کنید، rclone عملیات‌های کند را در انگشت‌نگاری لحاظ نخواهد کرد.
این کار دقت انگشت‌نگاری را کاهش می‌دهد اما سرعت آن را بسیار افزایش می‌دهد و زمان باز شدن فایل‌های کش‌شده را بهبود می‌بخشد.
.PP
اگر حافظهٔ نهان vfs را بر روی بک‌اندهای \f[V]local\f[R]، \f[V]s3\f[R] یا \f[V]swift\f[R] اجرا می‌کنید، استفاده از این پرچم توصیه می‌شود.
.PP
توجه داشته باشید که اگر مقدار این پرچم را تغییر دهید، ممکن است اثرانگشت فایل‌های موجود در کش باطل شود و فایل‌ها نیاز به بارگیری مجدد داشته باشند..SS خواندن تکه‌ای در VFS (VFS Chunked Reading)
.PP
هنگامی که rclone فایل‌ها را از یک ریموت می‌خواند، آن‌ها را به‌صورت تکه‌ای می‌خواند.
بدین معنا که rclone به‌جای درخواست کل فایل، تکهٔ مشخص‌شده را می‌خواند.
این کار می‌تواند با درخواستِ صرفاً تکه‌هایی از ریموت که واقعاً خوانده می‌شوند، سهمیهٔ دانلود مصرفی در برخی ریموت‌ها را کاهش دهد، هرچند به بهای افزایش تعداد درخواست‌ها تمام می‌شود.
.PP
این پرچم‌ها کنترل تکه‌بندی را بر عهده دارند:
.IP
.nf
\f[C]
    --vfs-read-chunk-size SizeSuffix        خواندن اشیاء مبدأ به‌صورت تکه‌ای (پیش‌فرض 128M)
    --vfs-read-chunk-size-limit SizeSuffix  حداکثر اندازهٔ دو برابر شدن تکه (پیش‌فرض off)
    --vfs-read-chunk-streams int            تعداد جریان‌های موازی برای خواندن هم‌زمان
\f[R]
.fi
.PP
تکه‌بندی بسته به پارامتر
\f[V]--vfs-read-chunk-streams\f[R] رفتارهای متفاوتی دارد.
.SS \f[V]--vfs-read-chunk-streams\f[R] == 0
.PP
دستور rclone خواندن را با تکه‌ای به اندازهٔ
\f[V]--vfs-read-chunk-size\f[R] آغاز می‌کند و سپس با هر بار خواندن، اندازه را دو برابر می‌کند.
هنگامی که \f[V]--vfs-read-chunk-size-limit\f[R] مشخص شده و بزرگ‌تر
از \f[V]--vfs-read-chunk-size\f[R] باشد، اندازهٔ تکه برای هر فایلِ باز
تنها تا زمانی که به مقدار مشخص‌شده برسد دو برابر خواهد شد.
اگر این مقدار \[dq]off\[dq] باشد (که حالت پیش‌فرض است)، محدودیت
غیرفعال است و اندازهٔ تکه به‌طور نامحدود رشد خواهد کرد.
.PP
با \f[V]--vfs-read-chunk-size 100M\f[R] و
\f[V]--vfs-read-chunk-size-limit 0\f[R]، بخش‌های زیر دانلود خواهند
شد: 0-100M، 100M-200M، 200M-300M، 300M-400M و الی آخر.
هنگامی که \f[V]--vfs-read-chunk-size-limit 500M\f[R] تعیین شود، نتیجه
به‌صورت 0-100M، 100M-300M، 300M-700M، 700M-1200M، 1200M-1700M و غیره
خواهد بود.
.PP
تنظیم \f[V]--vfs-read-chunk-size\f[R] روی \f[V]0\f[R] یا \[dq]off\[dq]
خواندن تکه‌ای را غیرفعال می‌کند.
.PP
تکه‌ها در حافظه بافر نخواهند شد.
.SS \f[V]--vfs-read-chunk-streams\f[R] > 0
.PP
دستور rclone تعداد \f[V]--vfs-read-chunk-streams\f[R] تکه با اندازهٔ
\f[V]--vfs-read-chunk-size\f[R] را به‌صورت هم‌روند می‌خواند.
اندازه برای هر بار خواندن ثابت باقی خواهد ماند.
.PP
این کارایی را روی پیوندهای با تأخیر بالا یا پیوندهای با پهنای باند بسیار
زیاد به ذخیره‌سازهای شیء با کارایی بالا، به‌طور چشمگیری بهبود می‌بخشد.
.PP
برای یافتن مقادیر بهینه برای
\f[V]--vfs-read-chunk-size\f[R] و \f[V]--vfs-read-chunk-streams\f[R]
به کمی آزمایش نیاز است، زیرا این موارد به Backend مورد استفاده و میزان
تأخیر تا آن بستگی دارند.
.PP
برای ذخیره‌سازهای شیء با کارایی بالا (مانند AWS S3)، یک نقطهٔ شروع منطقی
می‌تواند \f[V]--vfs-read-chunk-streams 16\f[R] و
\f[V]--vfs-read-chunk-size 4M\f[R] باشد.
در آزمایش‌ها با AWS S3، کارایی تقریباً متناسب با تنظیم
\f[V]--vfs-read-chunk-streams\f[R] مقیاس‌پذیر بود.
.PP
تنظیمات مشابه باید برای پیوندهای با تأخیر زیاد نیز کار کند، اما بسته به
میزان تأخیر ممکن است برای دستیابی به توان عملیاتی مطلوب، به مقادیر
بیشتری از \f[V]--vfs-read-chunk-streams\f[R] نیاز باشد.
.SS کارایی VFS (VFS Performance)
.PP
این پرچم‌ها ممکن است برای فعال یا غیرفعال کردن قابلیت‌های VFS به دلایل
کارایی یا موارد دیگر استفاده شوند.
همچنین بخش قابلیت خواندن تکه‌ای را ببینید.
.PP
به‌ویژه S3 و Swift سود فراوانی از پرچم
\f[V]--no-modtime\f[R] می‌برند (یا از \f[V]--use-server-modtime\f[R] برای
تأثیری کمی متفاوت استفاده کنید)، زیرا هر بار خواندنِ زمان تغییرات یک
تراکنش مصرف می‌کند.
.IP
.nf
\f[C]
    --no-checksum     عدم مقایسهٔ چک‌سام‌ها در هنگام بارگذاری/دانلود.
    --no-modtime      عدم خواندن/نوشتن زمان تغییرات (می‌تواند سرعت را افزایش دهد).
    --no-seek         عدم اجازه برای پرش (seek) در فایل‌ها.
    --read-only       فقط اجازهٔ دسترسی فقط‌خواندنی.
\f[R]
.fi
.PP
گاهی اوقات عملیات خواندن یا نوشتن به‌صورت نامرتب به rclone تحویل داده می‌شود.
برنامهٔ rclone به‌جای پرش در فایل (seek)، مدت کوتاهی منتظر می‌ماند تا
خواندن یا نوشتنِ متوالی از راه برسد.
این پرچم‌ها تنها در صورتی اثرگذار خواهند بود که از فایل کَش روی دیسک استفاده نشود.
.IP
.nf
\f[C]
    --vfs-read-wait duration   مدت زمان انتظار برای خواندن ترتیبی قبل از seek (پیش‌فرض 20ms)
    --vfs-write-wait duration  مدت زمان انتظار برای نوشتن ترتیبی قبل از اعلام خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
هنگام استفاده از کَش نوشتن VFS (\f[V]--vfs-cache-mode\f[R] با مقدار
writes یا full)، پرچم سراسری \f[V]--transfers\f[R] را می‌توان برای
تنظیم تعداد آپلودهای موازی فایل‌های تغییریافته از کَش تنظیم کرد
(پرچم سراسری مرتبط \f[V]--checkers\f[R] تأثیری بر VFS ندارد).
.IP
.nf
\f[C]
    --transfers int  تعداد انتقال‌های موازی فایل‌ها (پیش‌فرض 4)
\f[R]
.fi.SS پیوندهای نمادین (Symlinks)
.PP
به‌طور پیش‌فرض، VFS از پیوندهای نمادین پشتیبانی نمی‌کند.
با این حال، این ویژگی را می‌توان با هر یک از پرچم‌های زیر فعال کرد:
.IP
.nf
\f[C]
    --links      تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq].
    --vfs-links  تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
\f[R]
.fi
.PP
از آنجا که بیشتر سامانه‌های ذخیره‌سازی ابری مستقیماً از پیوندهای نمادین پشتیبانی نمی‌کنند، rclone پیوند نمادین را به‌صورت یک فایل معمولی با یک پسوند ویژه ذخیره می‌کند.
بنابراین فایلی که به‌صورت پیوند نمادین \f[V]link-to-file.txt\f[R] نشان داده می‌شود، در فضای ذخیره‌سازی ابری به‌صورت \f[V]link-to-file.txt.rclonelink\f[R] ذخیره خواهد شد و محتوای آن، مسیر مقصد پیوند نمادین خواهد بود.
.PP
توجه داشته باشید که \f[V]--links\f[R] تبدیل پیوند نمادین را به‌طور سراسری در rclone فعال می‌کند \- این شامل هر backendای که از این مفهوم پشتیبانی کند (برای نمونه backend محلی) می‌شود.
\f[V]--vfs-links\f[R] آن را فقط برای لایهٔ VFS فعال می‌کند.
.PP
این سازوکار با آنچه توسط backend محلی با پرچم \f[V]--local-links\f[R] استفاده می‌شود سازگار است (<https://rclone.org/local/#symlinks-junction-points>).
.PP
پرچم \f[V]--vfs-links\f[R] برای دستورهای \f[V]rclone mount\f[R]، \f[V]rclone nfsmount\f[R] و \f[V]rclone serve nfs\f[R] طراحی شده است.
.PP
این ویژگی هنوز با سایر دستورهای \f[V]rclone serve\f[R] آزمایش نشده است.
.PP
یکی از محدودیت‌های پیاده‌سازی فعلی این است که انتظار دارد فراخواننده، پیوندهای نمادین فرعی (sub-symlinks) را تحلیل (resolve) کند.
برای مثال با در نظر گرفتن این درخت دایرکتوری:
.IP
.nf
\f[C]
\&.
├── dir
│\ \  └── file.txt
└── linked-dir -> dir
\f[R]
.fi
.PP
لایهٔ VFS پیوند \f[V]linked-dir\f[R] را به‌درستی تحلیل می‌کند اما \f[V]linked-dir/file.txt\f[R] را خیر.
این موضوع برای دستورهای آزمایش‌شده مشکلی ایجاد نمی‌کند اما ممکن است برای سایر دستورها مشکل‌ساز باشد.
.PP
\f[B]توجه\f[R] داشته باشید که یک مشکل حل‌نشده در پشتیبانی از پیوندهای نمادین وجود دارد (موضوع شمارهٔ ۸۲۴۵ در <https://github.com/rclone/rclone/issues/8245>)؛ بدین صورت که اگر پیوندهای نمادین به دایرکتوری‌هایی منتقل شوند که فایلی با همان نام در آن‌ها وجود دارد (یا برعکس)، فایل‌های تکراری ایجاد می‌شوند.
.SS حساسیت VFS به بزرگی و کوچکی حروف (VFS Case Sensitivity)
.PP
سیستم‌های فایل لینوکس به بزرگی و کوچکی حروف حساس هستند (case-sensitive): دو فایل می‌توانند تنها در بزرگی و کوچکی حروف با هم تفاوت داشته باشند، و هنگام باز کردن یک فایل باید دقیقاً همان حالت حروف استفاده شود.
.PP
سیستم‌های فایل در نسخه‌های نوین ویندوز به بزرگی و کوچکی حروف حساس نیستند اما حالت حروف را حفظ می‌کنند (case-preserving): اگرچه فایل‌های موجود را می‌توان با هر حالتی از حروف باز کرد، اما حالت دقیق حروف مورد استفاده هنگام ایجاد فایل حفظ می‌شود و برنامه‌ها می‌توانند از آن پرس‌وجو کنند.
در این سیستم‌ها وجود دو فایل در یک دایرکتوری که فقط در بزرگی و کوچکی حروف با هم تفاوت داشته باشند مجاز نیست.
.PP
معمولاً سیستم‌های فایل در macOS به بزرگی و کوچکی حروف حساس نیستند.
امکان حساس کردن سیستم‌های فایل macOS به بزرگی و کوچکی حروف وجود دارد، اما این حالت پیش‌فرض نیست.
.PP
پرچم VFS به نام \f[V]--vfs-case-insensitive\f[R] چگونگی مدیریت این دو حالت را توسط rclone کنترل می‌کند.
اگر مقدار آن \[dq]false\[dq] باشد، rclone نام فایل‌ها را همان‌طور که هست (as-is) به ریموت ارسال می‌کند.
اگر این پرچم \[dq]true\[dq] باشد (یا بدون مقدار در خط فرمان مشخص شود)، rclone ممکن است یک «اصلاح» (\[dq]fixup\[dq]) را مطابق توضیحات زیر انجام دهد.
.PP
کاربر ممکن است نام فایلی را برای باز کردن/حذف/تغییر نام/غیره با حالتی از حروف مشخص کند که با آنچه در ریموت ذخیره شده تفاوت داشته باشد.
اگر آرگومانی به یک فایل موجود با نام کاملاً یکسان اشاره کند، حالت حروف فایل موجود روی دیسک استفاده خواهد شد.
با این حال، اگر نام فایلی با تطابق کامل پیدا نشود اما نامی وجود داشته باشد که تنها در بزرگی و کوچکی حروف متفاوت است، rclone نام را به‌طور شفاف اصلاح خواهد کرد.
این اصلاح تنها هنگامی رخ می‌دهد که یک فایل موجود درخواست شود.
حساسیت به بزرگی و کوچکی حروف در نام فایل‌هایی که به‌تازگی توسط rclone ایجاد می‌شوند، توسط ریموت زیرین کنترل می‌شود.
.PP
توجه داشته باشید که حساسیت سیستم‌عامل اجراکنندهٔ rclone (مقصد) به بزرگی و کوچکی حروف ممکن است با حساسیت سیستم فایل ارائه‌شده توسط rclone (مبدأ) تفاوت داشته باشد.
این پرچم مشخص می‌کند که آیا برای برآورده کردن الزامات مقصد، «اصلاح» (\[dq]fixup\[dq]) انجام شود یا خیر.
.PP
اگر این پرچم در خط فرمان مشخص نشود، مقدار پیش‌فرض آن به سیستم‌عاملی که rclone در آن اجرا می‌شود بستگی دارد: در ویندوز و macOS مقدار \[dq]true\[dq]، و در غیر این صورت \[dq]false\[dq].
اگر پرچم بدون مقدار ارائه شود، مقدار آن \[dq]true\[dq] خواهد بود.
.PP
پرچم \f[V]--no-unicode-normalization\f[R] کنترل می‌کند که آیا «اصلاح» (\[dq]fixup\[dq]) مشابهی برای نام‌فایل‌هایی که تفاوت دارند اما از نظر یونیکد هم‌ارزی قانونی دارند (<https://en.wikipedia.org/wiki/Unicode_equivalence>) انجام گیرد یا خیر.
نرمال‌سازی یونیکد به‌ویژه می‌تواند برای کاربران macOS مفید باشد، زیرا macOS فرم NFD را به فرم NFC (که توسط بیشتر پلتفرم‌های دیگر استفاده می‌شود) ترجیح می‌دهد.
بنابراین اکیداً توصیه می‌شود در macOS مقدار پیش‌فرض \f[V]false\f[R] حفظ شود تا از مشکلات سازگاری کدگذاری (encoding) جلوگیری به عمل آید.
.PP
در شرایطی (احتمالاً نادر) که یک دایرکتوری پس از اعمال نرمال‌سازی حروف و یونیکد دارای چندین نام‌فایل تکراری باشد، پرچم \f[V]--vfs-block-norm-dupes\f[R] اجازهٔ پنهان‌سازی این موارد تکراری را می‌دهد.
این کار به بهای افت کارایی (performance tradeoff) تمام می‌شود، چرا که rclone هنگام فهرست کردن یک دایرکتوری ناچار است کل دایرکتوری را برای یافتن موارد تکراری پویش کند.
به همین دلیل، پیشنهاد می‌شود در صورت عدم نیاز، این گزینه غیرفعال بماند.
با این حال، کاربران macOS ممکن است استفاده از آن را مد نظر قرار دهند، چرا که در غیر این صورت اگر یک دایرکتوری ریموت شامل هر دو نسخهٔ NFC و NFD از یک نام‌فایل باشد، وضعیت عجیبی رخ می‌دهد: هر دو نسخه از فایل در مانت (mount) قابل مشاهده خواهند بود و به نظر می‌رسد هر دو قابل ویرایش هستند، اما در عمل ویرایش هر یک از نسخه‌ها در پشت صحنه فقط منجر به ویرایش نسخهٔ NFD خواهد شد.
\f[V]--vfs-block-norm-dupes\f[R] با شناسایی این سناریو، پنهان کردن موارد تکراری و ثبت خطا در گزارش، از این سردرگمی جلوگیری می‌کند؛ مشابه همان رفتاری که در \f[V]rclone sync\f[R] پیاده شده است..SS گزینه‌های دیسک VFS
.PP
این پرچم به شما اجازه می‌دهد آمار مربوط به سیستم فایل را به صورت دستی
تنظیم کنید.
این قابلیت زمانی که آمار مذکور به صورت خودکار به درستی قابل خواندن نیستند،
می‌تواند مفید باشد.
.IP
.nf
\f[C]
    --vfs-disk-space-total-size    تنظیم دستی اندازه کل فضای دیسک (مثال: 256G، پیش‌فرض: -1)
\f[R]
.fi
.SS گزارش جایگزین بایت‌های استفاده‌شده
.PP
برخی backendها، به ویژه S3، میزان بایت‌های استفاده‌شده را گزارش نمی‌کنند.
اگر نیاز دارید این اطلاعات هنگام اجرای \f[V]df\f[R] روی سیستم فایل
در دسترس باشد، پرچم \f[V]--vfs-used-is-size\f[R] را به rclone پاس دهید.
با تنظیم این پرچم، rclone به جای اتکا به backend برای گزارش این اطلاعات،
کل ریموت را مشابه با \f[V]rclone size\f[R] پویش کرده و کل فضای استفاده‌شده
را خودش محاسبه می‌کند.
.PP
\f[B]هشدار\f[R]: بر خلاف \f[V]rclone size\f[R]، این پرچم فیلترها را
نادیده می‌گیرد تا نتیجه دقیق باشد.
با این وجود، این روش بسیار ناکارآمد است و ممکن است باعث فراخوانی‌های فراوان
API و در نتیجه هزینه‌های اضافی شود.
از آن تنها به عنوان آخرین راهکار و فقط به همراه حافظه موقت (caching) استفاده کنید.
.SS فراداده VFS
.PP
اگر از پرچم \f[V]--vfs-metadata-extension\f[R] استفاده کنید، می‌توانید VFS
را وادار کنید فایل‌هایی را که حاوی فراداده
(https://rclone.org/docs/#metadata) هستند به صورت داده JSON ارائه دهد.
این فایل‌ها در فهرست دایرکتوری ظاهر نمی‌شوند، اما می‌توان روی آن‌ها
\f[V]stat\f[R] اجرا کرد و آن‌ها را باز نمود، و به محض باز شدن، تا زمان
انقضای حافظه موقت دایرکتوری در فهرست دایرکتوری ظاهر \f[B]خواهند شد\f[R].
.PP
توجه داشته باشید که برخی backendها فراداده ایجاد نمی‌کنند مگر اینکه پرچم
\f[V]--metadata\f[R] را به آن‌ها پاس دهید.
.PP
به عنوان مثال، با استفاده از \f[V]rclone mount\f[R] به همراه
\f[V]--metadata --vfs-metadata-extension .metadata\f[R] خواهیم داشت:
.IP
.nf
\f[C]
$ ls -l /mnt/
total 1048577
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G

$ cat /mnt/1G.metadata
{
        \[dq]atime\[dq]: \[dq]2025-03-04T17:34:22.317069787Z\[dq],
        \[dq]btime\[dq]: \[dq]2025-03-03T16:03:37.708253808Z\[dq],
        \[dq]gid\[dq]: \[dq]1000\[dq],
        \[dq]mode\[dq]: \[dq]100664\[dq],
        \[dq]mtime\[dq]: \[dq]2025-03-03T16:03:39.640238323Z\[dq],
        \[dq]uid\[dq]: \[dq]1000\[dq]
}

$ ls -l /mnt/
total 1048578
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G
-rw-rw-r-- 1 user user        185 Mar  3 16:03 1G.metadata
\f[R]
.fi
.PP
اگر فایل فاقد هرگونه فراداده باشد، به صورت \f[V]{}\f[R] برگردانده می‌شود و اگر
در خواندن فراداده خطایی رخ دهد، خطا به صورت
\f[V]{\[dq]error\[dq]:\[dq]error string\[dq]}\f[R] برگردانده خواهد شد.
.IP
.nf
\f[C]
rclone serve dlna remote:path [flags]
\f[R]
.fi
.SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
      --addr string                            آدرس ip:port یا :port برای مقید کردن سرور DLNA http به آن (پیش‌فرض \[dq]:7879\[dq])
      --announce-interval Duration             بازه زمانی بین اعلانات SSDP (پیش‌فرض 12m0s)
      --dir-cache-time Duration                مدت زمان نگهداری ورودی‌های دایرکتوری در حافظه موقت (پیش‌فرض 5m0s)
      --dir-perms FileMode                     مجوزهای دایرکتوری (پیش‌فرض 777)
      --file-perms FileMode                    مجوزهای فایل (پیش‌فرض 666)
      --gid uint32                             بازنویسی فیلد gid تنظیم‌شده توسط سیستم فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1000)
  -h, --help                                   راهنمای dlna
      --interface stringArray                  رابط مورد استفاده برای SSDP (در صورت لزوم تکرار شود)
      --link-perms FileMode                    مجوزهای پیوند (پیش‌فرض 666)
      --log-trace                              فعال‌سازی ثبت وقایع ردگیری (trace) ترافیک SOAP
      --name string                            نام سرور DLNA
      --no-checksum                            عدم مقایسه چکسام‌ها هنگام بارگذاری/بارگیری
      --no-modtime                             عدم خواندن/نوشتن زمان تغییر (می‌تواند به کارها سرعت بخشد)
      --no-seek                                عدم اجازه پرش (seeking) در فایل‌ها
      --poll-interval Duration                 زمان انتظار بین بررسی دوره‌ای برای تغییرات، باید از dir-cache-time کمتر باشد و تنها روی ریموت‌های پشتیبانی‌شده (تنظیم روی 0 برای غیرفعال‌سازی) (پیش‌فرض 1m0s)
      --read-only                              تنها اجازه دسترسی فقط‌خواندنی داده شود
      --uid uint32                             بازنویسی فیلد uid تنظیم‌شده توسط سیستم فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1000)
      --umask FileMode                         بازنویسی بیت‌های مجوز تعیین‌شده توسط سیستم فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 002)
      --vfs-block-norm-dupes                   در صورت وجود نام‌های فایل تکراری در همان دایرکتوری (پس از نرمال‌سازی)، ثبت خطا و پنهان کردن موارد تکراری (ممکن است هزینه کارایی داشته باشد)
      --vfs-cache-max-age Duration             حداکثر زمان از آخرین دسترسی به اشیاء در حافظه موقت (پیش‌فرض 1h0m0s)
      --vfs-cache-max-size SizeSuffix          حداکثر اندازه کل اشیاء در حافظه موقت (پیش‌فرض off)
      --vfs-cache-min-free-space SizeSuffix    هدف حداقل فضای خالی روی دیسک حاوی حافظه موقت (پیش‌فرض off)
      --vfs-cache-mode CacheMode               حالت کش off|minimal|writes|full (پیش‌فرض off)
      --vfs-cache-poll-interval Duration       بازه زمانی بررسی حافظه موقت برای اشیاء بی‌استفاده (پیش‌فرض 1m0s)
      --vfs-case-insensitive                   اگر نام فایل یافت نشد، جستجوی تطابق غیرحساس به بزرگی و کوچکی حروف
      --vfs-disk-space-total-size SizeSuffix   مشخص کردن کل فضای دیسک (پیش‌فرض off)
      --vfs-fast-fingerprint                   استفاده از اثر انگشت‌های سریع (با دقت کمتر) برای تشخیص تغییرات
      --vfs-handle-caching Duration            مدت زمان زنده نگه‌داشتن دستگیره فایل و دانلودکننده‌ها پس از آخرین بسته‌شدن (پیش‌فرض 5s)
      --vfs-links                              ترجمه پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
      --vfs-metadata-extension string          تنظیم پسوند برای خواندن فراداده از آن
      --vfs-read-ahead SizeSuffix              پیش‌خوانی مازاد بر --buffer-size هنگام استفاده از cache-mode full
      --vfs-read-chunk-size SizeSuffix         خواندن اشیاء مبدأ در تکه‌ها (پیش‌فرض 128Mi)
      --vfs-read-chunk-size-limit SizeSuffix   در صورت بزرگتر بودن از --vfs-read-chunk-size، دو برابر کردن اندازه تکه پس از هر بار خواندن، تا زمان رسیدن به حد (\[aq]off\[aq] به معنای نامحدود) (پیش‌فرض off)
      --vfs-read-chunk-streams int             تعداد جریان‌های موازی برای خواندن هم‌زمان
      --vfs-read-wait Duration                 مدت زمان انتظار برای خواندن ترتیبی پیش از پرش (پیش‌فرض 20ms)
      --vfs-refresh                            بازنشانی بازگشتی حافظه موقت دایرکتوری در پس‌زمینه هنگام شروع
      --vfs-used-is-size rclone size           استفاده از الگوریتم rclone size برای محاسبه اندازه استفاده‌شده (Used)
      --vfs-write-back Duration                زمان نوشتن مجدد فایل‌ها پس از آخرین استفاده هنگام استفاده از کش (پیش‌فرض 5s)
      --vfs-write-wait Duration                مدت زمان انتظار برای نوشتن ترتیبی پیش از نمایش خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های عمومی که در اینجا فهرست نشده‌اند، صفحه پرچم‌های عمومی
(https://rclone.org/flags) را ببینید..SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌هایی برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام فایل‌های مبدأ از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از یک فایل بدون هیچ‌گونه پردازش خطوط (برای خواندن از stdin از - استفاده کنید)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ از یک فایل با استفاده از NUL به عنوان جداکننده (برای خواندن از stdin از - استفاده کنید)
  -f, --filter stringArray                  افزودن یک قانون فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --hash-filter string                  افرازبندی نام فایل‌ها بر اساس هش k/n یا به صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (ناحساس به حروف بزرگ و کوچک)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --max-age Duration                    تنها انتقال فایل‌های جدیدتر از این مقدار به ثانیه یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 تنها انتقال فایل‌های کوچک‌تر از این مقدار به KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --metadata-filter stringArray         افزودن یک قانون فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متاداده از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --min-age Duration                    تنها انتقال فایل‌های قدیمی‌تر از این مقدار به ثانیه یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 تنها انتقال فایل‌های بزرگ‌تر از این مقدار به KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone serve (https://rclone.org/commands/rclone_serve) \- سرویس‌دهی یک ریموت بر بستر یک پروتکل.
.SH "rclone serve docker"
.PP
ارائه هر ریموت بر بستر API پلاگین volume داکر.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور API پلاگین volume داکر را پیاده‌سازی می‌کند و به docker اجازه می‌دهد از rclone به عنوان یک سازوکار ذخیره‌سازی داده برای ارائه‌دهندگان ابری مختلف استفاده کند. rclone یک پلاگین volume داکر بر پایه آن ارائه می‌دهد.
.PP
برای ایجاد یک پلاگین docker، باید یک سوکت Unix یا TCP ایجاد شود که داکر هنگام استفاده از پلاگین به دنبال آن بگردد، و سپس این سوکت به دستورات ارسالی از دیمن docker گوش فرا داده و در صورت نیاز کد مربوطه را اجرا کند.
پلاگین‌های داکر می‌توانند به عنوان یک پلاگین مدیریت‌شده تحت کنترل دیمن docker یا به عنوان یک سرویس مستقل بومی (native) اجرا شوند.
برای آزمایش، می‌توانید آن را به سادگی و مستقیماً از خط فرمان اجرا کنید، به عنوان مثال:
.IP
.nf
\f[C]
sudo rclone serve docker --base-dir /tmp/rclone-volumes --socket-addr localhost:8787 -vv
\f[R]
.fi
.PP
اجرای \f[V]rclone serve docker\f[R] سوکت مذکور را ایجاد کرده و برای ساخت Volumeهای لازم، به دستورات داکر گوش می‌دهد.
به‌طور معمول نیازی به تعیین پرچم \f[V]--socket-addr\f[R] ندارید.
این API روی سوکت دامنه یونیکس در \f[V]/run/docker/plugins/rclone.sock\f[R] شنود خواهد کرد.
در مثال بالا rclone یک سوکت TCP و یک فایل کوچک حاوی نشانی سوکت در \f[V]/etc/docker/plugins/rclone.spec\f[R] ایجاد می‌کند.
ما از \f[V]sudo\f[R] استفاده می‌کنیم زیرا هر دو مسیر تنها توسط کاربر ریشه (root) قابل نوشتن هستند.
.PP
اگر بعداً تصمیم گرفتید سوکت شنود را تغییر دهید، دیمن docker باید مجدداً راه‌اندازی شود تا دوباره به \f[V]/run/docker/plugins/rclone.sock\f[R] متصل شده یا فایل جدید \f[V]/etc/docker/plugins/rclone.spec\f[R] را بازخوانی و پردازش کند.
تا زمان راه‌اندازی مجدد، تمام دستورات داکرِ مرتبط با volume در تلاش برای دسترسی به سوکت قبلی با اتمام مهلت زمانی (timeout) مواجه خواهند شد.
اجرای مستقیم \f[B]تنها در لینوکس\f[R] پشتیبانی می‌شود و در ویندوز یا MacOS پشتیبانی نمی‌شود.
این موضوع در حالت پلاگین مدیریت‌شده که با جزئیات کامل در مستندات (https://rclone.org/docker) توضیح داده شده است، مشکلی نخواهد بود.
.PP
این دستور، اتصالات volume را در مسیر مشخص‌شده توسط \f[V]--base-dir\f[R] (به‌طور پیش‌فرض \f[V]/var/lib/docker-volumes/rclone\f[R] که تنها برای ریشه در دسترس است) ایجاد کرده و فایل با قالب JSON به نام \f[V]docker-plugin.state\f[R] را در دایرکتوری حافظه پنهان (cache) نرم‌افزار rclone با ثبت سوابق volumeهای ایجادشده و متصل‌شده نگهداری می‌کند.
.PP
تمامی گزینه‌های mount و VFS توسط دیمن docker از طریق API ارسال می‌شوند، اما شما همچنین می‌توانید مقادیر پیش‌فرض را در خط فرمان مشخص کرده و مسیر فایل پیکربندی و دایرکتوری حافظه پنهان (cache) را تنظیم کنید یا میزان جزئیات گزارش‌گیری (logging verbosity) را تغییر دهید..SH "راه‌اندازی مجدد یا ارتقای افزونه (RESTARTING OR UPGRADING THE PLUGIN)"
.PP
هنگامی که افزونه راه‌اندازی مجدد می‌شود (برای نمونه با
\f[V]docker plugin disable rclone && docker plugin enable rclone\f[R]،
هنگام ارتقای افزونه، یا زمانی که میزبان بازراه‌اندازی می‌شود)، rclone پروندهٔ
\f[V]docker-plugin.state\f[R] خود را می‌خواند و حجم‌ها و اتصالات (mounts)
پیش‌تر فعال را بازیابی می‌کند.
افزونه بلافاصله ارائهٔ سوکت خود را آغاز کرده و اتصالات را در پس‌زمینه برقرار می‌سازد؛
بدین ترتیب، یک ریموت کُند یا غیرقابل دسترس مانع بالا آمدن دوبارهٔ افزونه نمی‌شود.
.PP
با این حال، راه‌اندازی مجدد افزونه ناگزیر فرآیندی را که ارائه‌دهندهٔ اتصالات FUSE است،
متوقف کرده و مجدداً راه‌اندازی می‌کند.
هر ظرفی (container) که \f[B]از قبل در حال اجراست\f[R] و پرونده‌هایی را روی یک حجم
rclone باز نگه داشته است، یک ارجاع (handle) به اتصال قدیمی و اکنون از کار افتاده را
حفظ می‌کند؛ بنابراین، این ارجاع‌ها تا زمان راه‌اندازی مجدد ظرف، خطای
\f[V]transport endpoint is not connected\f[R]
برمی‌گردانند.
این موضوع یک محدودیت ناشی از جایگزینی فرآیند پشت یک اتصال FUSE زنده است و rclone
نمی‌تواند از آن جلوگیری کند \- خود افزونه بازیابی می‌شود و ظرف‌های تازه راه‌اندازی‌شده
به‌طور عادی کار می‌کنند، اما:
.IP \[bu] 2
\f[B]هر ظرفی را که از حجم‌های rclone استفاده می‌کرد راه‌اندازی مجدد کنید\f[R]
پس از آنکه افزونه را راه‌اندازی مجدد یا ارتقا دادید (مانند
\f[V]docker restart <container>\f[R])،
یا پیش از آن متوقف کرده و پس از آن راه‌اندازی نمایید.
.IP \[bu] 2
پایگاه‌های داده و سایر برنامه‌هایی که پرونده‌ها را پیوسته باز نگه می‌دارند
(Grafana، Prometheus، برنامه‌های مبتنی بر SQLite و غیره)
بیشترین تأثیر را می‌پذیرند و همیشه باید راه‌اندازی مجدد شوند.
.SH "امنیت (SECURITY)"
.PP
رابط برنامه‌نویسی (API) افزونه یک گزینهٔ \f[V]remote\f[R] (یا همان \f[V]fs\f[R])
را هنگام ایجاد حجم می‌پذیرد و این گزینه دقیقاً مانند یک رشته اتصال rclone تجزیه می‌شود.
رشته‌های اتصال، پیکربندی مورد اعتماد محسوب می‌شوند: آن‌ها ممکن است شامل گزینه‌های
درون‌خطی backend باشند، و برخی از backendها از این گزینه‌ها برای اجرای دستورات
محلی استفاده می‌کنند (برای نمونه، گزینهٔ \f[V]ssh\f[R] در backend مربوط به
\f[V]sftp\f[R] یک باینری خارجی را اجرا می‌کند).
بنابراین، هرکسی که بتواند درخواست‌هایی را به سوکت افزونه ارسال کند، می‌تواند rclone
را وادار کند تا دستورات دلخواهی را با دسترسی کاربری که
\f[V]rclone serve docker\f[R]
را اجرا می‌کند (معمولاً root) به اجرا درآورد.
دسترسی به سوکت را معادل آن سطح از دسترسی در نظر بگیرید و آن را تنها در اختیار
فراخوان‌های مورد اعتماد قرار دهید.
.PP
هنگام شنود روی سوکت پیش‌فرض unix در
\f[V]/run/docker/plugins/rclone.sock\f[R]،
rclone آن را با حالت \f[V]0660\f[R] به مالکیت \f[V]root\f[R] و گروه تعیین‌شده با
\f[V]--socket-gid\f[R] (به‌طور پیش‌فرض GID همان فرآیند) می‌سازد؛
بنابراین تنها root و اعضای آن گروه \- که معمولاً فقط دیمن docker است \- می‌توانند به آن
دسترسی داشته باشند. این مجوزها را سهل‌گیرانه‌تر نکنید و این گروه را به کاربران
غیرقابل اعتماد اختصاص ندهید.
.PP
هنگام استفاده از \f[V]--socket-addr\f[R] برای شنود روی سوکت TCP هیچ احراز هویتی
وجود ندارد و API برای هرکسی که بتواند پورت را باز کند در دسترس است؛ بنابراین آن را
به یک نشانی loopback یا در غیر این صورت نشانی مورد اعتماد مقید (bind) کنید و با
دیوار آتش (firewall) از آن محافظت نمایید.
توجه داشته باشید که داشتن دسترسی به دیمن Docker از پیش معادل دسترسی root روی
میزبان است، بنابراین فراخوانی که قادر به اجرای \f[V]docker volume create\f[R] باشد
امتیاز جدیدی از این طریق به دست نمی‌آورد؛ نگرانی اصلی، در دسترس قرار دادن سوکت
به‌صورتی گسترده‌تر از خود دیمن است.
.SS "سامانه پرونده مجازی (VFS - Virtual File System)"
.PP
این دستور از لایهٔ VFS استفاده می‌کند.
این لایه، اشیاء ذخیره‌سازی ابری مورد استفادهٔ rclone را به چیزی تبدیل می‌کند که بسیار
بیشتر شبیه به یک سامانه پرونده دیسک است.
.PP
اشیاء ذخیره‌سازی ابری ویژگی‌های متعددی دارند که مانند پرونده‌های دیسک نیستند \-
نمی‌توانید اندازهٔ آن‌ها را افزایش دهید یا در میانه‌شان بنویسید، بنابراین لایهٔ VFS
باید با این مسائل سر و کار داشته باشد.
از آنجا که هیچ راه واحد درستی برای انجام این کار وجود ندارد، گزینه‌های مختلفی وجود دارند
که در ادامه توضیح داده شده‌اند.
.PP
لایهٔ VFS همچنین یک حافظه پنهان دایرکتوری (directory cache) را پیاده‌سازی می‌کند \-
این قابلیت اطلاعات مربوط به پرونده‌ها و دایرکتوری‌ها (اما نه خود داده‌ها) را در
حافظه ذخیره می‌کند.
.SS "حافظه پنهان دایرکتوری VFS (VFS Directory Cache)"
.PP
با استفاده از پرچم \f[V]--dir-cache-time\f[R]، می‌توانید مشخص کنید که یک
دایرکتوری تا چه مدت به‌روز در نظر گرفته شود و از سمت backend بازخوانی نشود.
تغییرات اعمال‌شده از طریق VFS بلافاصله نمایان می‌شوند یا حافظه پنهان را باطل می‌کنند.
.IP
.nf
\f[C]
    --dir-cache-time duration   Time to cache directory entries for (default 5m0s)
    --poll-interval duration    Time to wait between polling for changes. Must be smaller than dir-cache-time. Only on supported remotes. Set to 0 to disable (default 1m0s)
\f[R]
.fi
.PP
با این حال، در صورتی که backend پیکربندی‌شده از نظرسنجی تغییرات (polling)
پشتیبانی نکند، تغییراتی که مستقیماً روی ذخیره‌سازی ابری از طریق رابط وب یا نسخهٔ دیگری
از rclone اعمال شوند، تنها پس از منقضی شدن حافظه پنهان دایرکتوری شناسایی خواهند شد.
اگر backend از polling پشتیبانی کند، تغییرات در بازهٔ زمانی polling دریافت می‌شوند.
.PP
می‌توانید یک سیگنال \f[V]SIGHUP\f[R] به rclone بفرستید تا صرف‌نظر از قدمت، تمام
حافظه‌های پنهان دایرکتوری را پاکسازی (flush) کند.
با فرض اینکه تنها یک نمونه از rclone در حال اجرا است، می‌توانید حافظه پنهان را به این
صورت بازنشانی کنید:
.IP
.nf
\f[C]
kill -SIGHUP $(pidof rclone)
\f[R]
.fi
.PP
اگر rclone را با کنترل از راه دور (remote control) پیکربندی کنید، می‌توانید از
\f[V]rclone rc\f[R] برای تخلیهٔ کل حافظه پنهان دایرکتوری استفاده کنید:
.IP
.nf
\f[C]
rclone rc vfs/forget
\f[R]
.fi
.PP
یا برای پرونده‌ها یا دایرکتوری‌های مشخص:
.IP
.nf
\f[C]
rclone rc vfs/forget file=path/to/file dir=path/to/dir
\f[R]
.fi.SS بافرسازی فایل در VFS (VFS File Buffering)
.PP
پرچم \f[V]--buffer-size\f[R] مقدار حافظه‌ای را تعیین می‌کند که
برای بافر کردن داده‌ها از قبل (پیش‌بافر) استفاده خواهد شد.
.PP
هر فایلِ باز تلاش خواهد کرد تا مقدار مشخص‌شده داده را همواره در
حافظه نگه دارد.
داده‌های بافرشده به یک فایل باز اختصاص داشته و به اشتراک گذاشته
نخواهند شد.
.PP
این پرچم یک حد بالا برای حافظه مصرفی به ازای هر فایل باز است.
بافر تنها برای داده‌هایی از حافظه استفاده خواهد کرد که دانلود شده
اما هنوز خوانده نشده‌اند.
اگر بافر خالی باشد، تنها مقدار اندکی از حافظه مصرف خواهد شد.
.PP
حداکثر حافظه استفاده‌شده توسط rclone برای بافرسازی می‌تواند تا
\f[V]--buffer-size * open files\f[R] باشد.
.SS کش‌کردن فایل در VFS (VFS File Caching)
.PP
این پرچم‌ها گزینه‌های کش‌کردن فایل VFS را کنترل می‌کنند.
کش‌کردن فایل برای سازگار نشان دادن لایه VFS با یک سیستم‌فایل عادی
ضروری است.
می‌توان آن را به بهای از دست رفتن بخشی از سازگاری غیرفعال کرد.
.PP
برای نمونه، اگر بخواهید به‌طور هم‌زمان از یک فایل بخوانید و در آن
بنویسید، باید کش VFS را فعال کنید.
برای جزئیات بیشتر به بخش زیر مراجعه کنید.
.PP
توجه داشته باشید که کش VFS از backend کش مجزا است و ممکن است
ببینید که به یکی از آن‌ها یا هر دو نیاز دارید.
.IP
.nf
\f[C]
    --cache-dir string                     Directory rclone will use for caching.
    --vfs-cache-mode CacheMode             Cache mode off|minimal|writes|full (default off)
    --vfs-cache-max-age duration           Max time since last access of objects in the cache (default 1h0m0s)
    --vfs-cache-max-size SizeSuffix        Max total size of objects in the cache (default off)
    --vfs-cache-min-free-space SizeSuffix  Target minimum free space on the disk containing the cache (default off)
    --vfs-cache-poll-interval duration     Interval to poll the cache for stale objects (default 1m0s)
    --vfs-write-back duration              Time to writeback files after last use when using cache (default 5s)
\f[R]
.fi
.PP
اگر rclone با \f[V]-vv\f[R] اجرا شود، مکان کش فایل را چاپ خواهد کرد.
فایل‌ها در ناحیه فایل‌های کش کاربر ذخیره می‌شوند که وابسته به سیستم‌عامل
است، اما می‌توان آن را با \f[V]--cache-dir\f[R] یا تنظیم متغیر
محیطی مناسب کنترل کرد.
.PP
کش دارای ۴ حالت مختلف است که توسط \f[V]--vfs-cache-mode\f[R]
انتخاب می‌شوند.
هرچه حالت کش بالاتر باشد، rclone به قیمت مصرف فضای دیسک سازگارتر
می‌شود.
.PP
توجه داشته باشید که فایل‌ها تنها زمانی به ریموت بازنویسی (write back)
می‌شوند که بسته شده باشند و به مدت \f[V]--vfs-write-back\f[R]
ثانیه دسترسی به آن‌ها انجام نشده باشد.
اگر rclone با فایل‌هایی که هنوز بارگذاری نشده‌اند متوقف یا بسته شود،
این فایل‌ها در دفعه بعدی که rclone با همان پرچم‌ها اجرا گردد،
بارگذاری خواهند شد.
.PP
در صورت استفاده از \f[V]--vfs-cache-max-size\f[R] یا
\f[V]--vfs-cache-min-free-space\f[R] توجه داشته باشید که کش ممکن
است به دو دلیل از این سهمیه‌ها فراتر رود.
نخست به این دلیل که فقط در هر \f[V]--vfs-cache-poll-interval\f[R]
بررسی می‌شود.
دوم به این دلیل که فایل‌های باز را نمی‌توان از کش بیرون انداخت (evict کرد).
هنگامی که حجم از \f[V]--vfs-cache-max-size\f[R] یا
\f[V]--vfs-cache-min-free-space\f[R] فراتر رود، rclone تلاش خواهد
کرد تا ابتدا فایل‌هایی با کمترین دسترسی را از کش خارج کند.
rclone با فایل‌هایی آغاز خواهد کرد که برای طولانی‌ترین زمان دسترسی
نداشته‌اند.
این راهبرد تخلیه کش کارآمد است و احتمال اینکه فایل‌های مرتبط‌تر در کش
باقی بمانند بیشتر است.
.PP
گزینه \f[V]--vfs-cache-max-age\f[R] فایل‌ها را پس از گذشت زمان
تعیین‌شده از آخرین دسترسی، از کش بیرون خواهد انداخت؛ این بر اساس
زمان دسترسی است، نه بر مبنای زمانی که فایل برای نخستین‌بار به کش
اضافه شده است.
مقدار پیش‌فرض ۱ ساعت، شروع به حذف فایل‌هایی از کش خواهد کرد که
به مدت ۱ ساعت دسترسی نداشته‌اند.
هنگامی که به یک فایل کش‌شده دسترسی پیدا شود، زمان‌سنج ۱ ساعته به ۰
بازنشانی می‌شود و قبل از بیرون انداختن، ۱ ساعت دیگر منتظر می‌ماند.
زمان را با نمادگذاری استاندارد s،‏ m،‏ h،‏ d،‏ w مشخص کنید.
.PP
اگر از \f[V]--vfs-cache-mode > off\f[R] استفاده می‌کنید،
\f[B]نباید\f[R] دو نسخه از rclone را با استفاده از کش VFS یکسان
همراه با ریموت‌های یکسان یا هم‌پوشان اجرا کنید.
این کار در صورت انجام می‌تواند بالقوه موجب آسیب دیدن داده‌ها شود.
می‌توانید با اختصاص دادن سلسله‌مراتب کش مخصوص به هر rclone از
طریق \f[V]--cache-dir\f[R] این مشکل را برطرف کنید.
اگر ریموت‌های مورد استفاده هم‌پوشانی ندارند، نیازی به نگرانی در این
باره نیست..SS --vfs-cache-mode off
.PP
در این حالت (حالت پیش‌فرض)، کش مستقیماً از ریموت می‌خواند و بدون کش کردن هیچ داده‌ای روی دیسک، مستقیماً روی ریموت می‌نویسد.
.PP
این بدان معناست که برخی عملیات امکان‌پذیر نخواهند بود:
.IP \[bu] 2
فایل‌ها را نمی‌توان هم‌زمان برای هر دو حالت خواندن و نوشتن (read و write) باز کرد
.IP \[bu] 2
در فایل‌های باز شده برای نوشتن نمی‌توان تغییر مکان (seek) انجام داد
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید O_TRUNC برای آن‌ها تنظیم شده باشد
.IP \[bu] 2
فایل‌های باز شده برای خواندن با O_TRUNC، به‌صورت فقط‌نوشتنی باز خواهند شد
.IP \[bu] 2
فایل‌های باز شده به‌صورت فقط‌نوشتنی به‌گونه‌ای رفتار می‌کنند که گویی O_TRUNC مشخص شده است
.IP \[bu] 2
حالت‌های باز کردن O_APPEND و O_TRUNC نادیده گرفته می‌شوند
.IP \[bu] 2
اگر یک بارگذاری با شکست مواجه شود، امکان تلاش مجدد برای آن وجود ندارد
.SS --vfs-cache-mode minimal
.PP
این حالت بسیار شبیه به \[dq]off\[dq] است، به‌جز اینکه فایل‌های باز شده برای خواندن و نوشتن روی دیسک بافر خواهند شد.
این بدان معناست که فایل‌های باز شده برای نوشتن بسیار سازگارتر خواهند بود، در حالی که کمترین فضای دیسک مصرف می‌شود.
.PP
این عملیات امکان‌پذیر نیستند:
.IP \[bu] 2
در فایل‌های باز شده به‌صورت فقط‌نوشتنی نمی‌توان تغییر مکان (seek) انجام داد
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید O_TRUNC برای آن‌ها تنظیم شده باشد
.IP \[bu] 2
فایل‌های باز شده به‌صورت فقط‌نوشتنی، O_APPEND و O_TRUNC را نادیده می‌گیرند
.IP \[bu] 2
اگر یک بارگذاری با شکست مواجه شود، امکان تلاش مجدد برای آن وجود ندارد
.SS --vfs-cache-mode writes
.PP
در این حالت، فایل‌های باز شده به‌صورت فقط‌خواندنی همچنان مستقیماً از ریموت خوانده می‌شوند، اما فایل‌های فقط‌نوشتنی و خواندنی/نوشتنی ابتدا روی دیسک بافر می‌شوند.
.PP
این حالت باید از تمام عملیات معمول سیستم فایل پشتیبانی کند.
.PP
اگر یک بارگذاری با شکست مواجه شود، تلاش مجدد در فواصل زمانی با افزایش نمایی تا سقف ۱ دقیقه انجام خواهد شد.
.SS --vfs-cache-mode full
.PP
در این حالت، تمام عملیات خواندن و نوشتن از دیسک و به دیسک بافر می‌شوند.
هنگامی که داده‌ها از ریموت خوانده می‌شوند، روی دیسک نیز بافر خواهند شد.
.PP
در این حالت، فایل‌های موجود در کش به‌صورت sparse files (فایل‌های پراکنده) خواهند بود و rclone پیگیری می‌کند که کدام بخش‌های فایل بارگیری شده‌اند.
.PP
بنابراین اگر برنامه‌ای تنها ابتدای هر فایل را بخواند، rclone فقط ابتدای فایل را بافر می‌کند.
این فایل‌ها در کش با اندازه کامل خود نمایش داده می‌شوند، اما فایل‌های پراکنده‌ای (sparse files) هستند که تنها داده‌های بارگیری‌شده در آن‌ها وجود دارد.
.PP
این حالت باید از تمام عملیات معمول سیستم فایل پشتیبانی کند و در سایر موارد هم‌ارز با \f[V]--vfs-cache-mode\f[R] writes است.
.PP
هنگام خواندن یک فایل، rclone به اندازه \f[V]--buffer-size\f[R] به‌علاوه \f[V]--vfs-read-ahead\f[R] بایت جلوتر را می‌خواند.
مقدار \f[V]--buffer-size\f[R] در حافظه بافر می‌شود، در حالی که \f[V]--vfs-read-ahead\f[R] روی دیسک بافر می‌گردد.
.PP
هنگام استفاده از این حالت، توصیه می‌شود که \f[V]--buffer-size\f[R] بیش از حد بزرگ تنظیم نشود و در صورت نیاز، \f[V]--vfs-read-ahead\f[R] مقدار بزرگی داشته باشد.
.PP
\f[B]مهم:\f[R] همه سیستم‌های فایل از فایل‌های پراکنده (sparse files) پشتیبانی نمی‌کنند؛
به‌ویژه FAT/exFAT پشتیبانی نمی‌کنند.
اگر دایرکتوری کش روی سیستم فایلی باشد که از فایل‌های پراکنده پشتیبانی نمی‌کند، rclone عملکرد بسیار ضعیفی خواهد داشت و در صورت تشخیص، یک پیام ERROR ثبت خواهد کرد.
.SS اثرانگشت‌نگاری (Fingerprinting)
.PP
بخش‌های مختلف VFS از اثرانگشت‌نگاری (fingerprinting) استفاده می‌کنند تا بررسی کنند آیا نسخه محلی فایل نسبت به فایل ریموت تغییر کرده است یا خیر.
اثرانگشت‌ها از موارد زیر تشکیل می‌شوند:
.IP \[bu] 2
اندازه (size)
.IP \[bu] 2
زمان تغییر (modification time)
.IP \[bu] 2
هش (hash)
.PP
در صورتی که روی یک شیء موجود باشند.
.PP
در برخی از backendها، خواندن بعضی از این مشخصه‌ها کند است (نیازمند یک فراخوانی API اضافی یا پردازش بیشتر به ازای هر شیء هستند).
.PP
برای نمونه، \f[V]hash\f[R] با backendهای \f[V]local\f[R] و \f[V]sftp\f[R] کند است زیرا آن‌ها باید کل فایل را بخوانند و هش آن را محاسبه کنند، و \f[V]modtime\f[R] با backendهای \f[V]s3\f[R]، \f[V]swift\f[R]، \f[V]ftp\f[R] و \f[V]qinqstor\f[R] کند است زیرا برای واکشی آن نیاز به انجام یک فراخوانی API اضافی دارند.
.PP
اگر از پرچم \f[V]--vfs-fast-fingerprint\f[R] استفاده کنید، rclone عملیات کند را در اثرانگشت لحاظ نخواهد کرد.
این کار دقت اثرانگشت‌نگاری را کاهش می‌دهد اما سرعت آن را بسیار بالا می‌برد و زمان باز شدن فایل‌های کش‌شده را بهبود می‌بخشد.
.PP
اگر یک کش vfs را روی backendهای \f[V]local\f[R]، \f[V]s3\f[R] یا \f[V]swift\f[R] اجرا می‌کنید، استفاده از این پرچم توصیه می‌شود.
.PP
توجه داشته باشید که اگر مقدار این پرچم را تغییر دهید، اثرانگشت فایل‌های موجود در کش ممکن است باطل شود و نیاز به بارگیری دوباره فایل‌ها باشد..SS خواندن تکه‌ای VFS
.PP
هنگامی که rclone پرونده‌ها را از یک ریموت می‌خواند، آن‌ها را به صورت تکه‌ای (chunk) دریافت می‌کند.
این بدان معناست که rclone به جای درخواست کل پرونده، تنها تکهٔ مشخص‌شده را می‌خواند.
این قابلیت می‌تواند با درخواست دادن تنها بخش‌هایی از پرونده که واقعاً خوانده می‌شوند، سهمیهٔ بارگیری مصرف‌شده را در برخی ریموت‌ها کاهش دهد؛ البته به بهای افزایش تعداد کل درخواست‌ها.
.PP
این پرچم‌ها رفتار تکه‌تکه کردن (chunking) را کنترل می‌کنند:
.IP
.nf
\f[C]
    --vfs-read-chunk-size SizeSuffix        خواندن اشیاء مبدأ به‌صورت تکه‌ای (پیش‌فرض 128M)
    --vfs-read-chunk-size-limit SizeSuffix  بیشینهٔ اندازهٔ دو برابر شدن تکه (پیش‌فرض off)
    --vfs-read-chunk-streams int            تعداد جریان‌های موازی برای خواندن هم‌زمان
\f[R]
.fi
.PP
رفتار تکه‌تکه کردن بسته به پارامتر
\f[V]--vfs-read-chunk-streams\f[R] متفاوت خواهد بود.
.SS \f[V]--vfs-read-chunk-streams\f[R] == 0
.PP
‏rclone خواندن را با تکه‌ای به اندازهٔ
\f[V]--vfs-read-chunk-size\f[R] آغاز می‌کند و سپس برای هر بار خواندن، این اندازه را دو برابر می‌کند.
هنگامی که \f[V]--vfs-read-chunk-size-limit\f[R] مشخص شده و بزرگ‌تر از
\f[V]--vfs-read-chunk-size\f[R] باشد، اندازهٔ تکه برای هر پروندهٔ باز تنها تا زمانی دو برابر می‌شود که به مقدار مشخص‌شده برسد.
اگر مقدار برابر با \[dq]off\[dq] باشد (که پیش‌فرض است)، این محدودیت غیرفعال است و اندازهٔ تکه بدون محدودیت افزایش خواهد یافت.
.PP
با تنظیم \f[V]--vfs-read-chunk-size 100M\f[R] و
\f[V]--vfs-read-chunk-size-limit 0\f[R]، بخش‌های زیر بارگیری خواهند شد: 0-100M، 100M-200M، 200M-300M، 300M-400M و به همین ترتیب.
هنگامی که \f[V]--vfs-read-chunk-size-limit 500M\f[R] مشخص شود، نتیجه به صورت 0-100M، 100M-300M، 300M-700M، 700M-1200M، 1200M-1700M و الی آخر خواهد بود.
.PP
تنظیم \f[V]--vfs-read-chunk-size\f[R] روی \f[V]0\f[R] یا \[dq]off\[dq]
قابلیت خواندن تکه‌ای را غیرفعال می‌کند.
.PP
تکه‌ها در حافظه میان‌گیر (buffer) نخواهند شد.
.SS \f[V]--vfs-read-chunk-streams\f[R] > 0
.PP
‏rclone به تعداد \f[V]--vfs-read-chunk-streams\f[R] تکه با اندازهٔ
\f[V]--vfs-read-chunk-size\f[R] را به طور هم‌زمان می‌خواند.
اندازهٔ هر بخش خوانش ثابت باقی خواهد ماند.
.PP
این قابلیت کارایی را در پیوندهای با تأخیر (latency) بالا یا پیوندهای با پهنای باند بسیار بالا به فضاهای ذخیره‌سازی ابری پرسرعت (object stores) به شدت افزایش می‌دهد.
.PP
برای یافتن مقادیر بهینهٔ
\f[V]--vfs-read-chunk-size\f[R] و \f[V]--vfs-read-chunk-streams\f[R]
کمی آزمایش لازم خواهد بود، چرا که این مقادیر به backend مورد استفاده و میزان تأخیر ارتباط با آن بستگی دارند.
.PP
برای فضاهای ذخیره‌سازی ابری با کارایی بالا (مانند AWS S3)، یک نقطهٔ شروع منطقی می‌تواند
\f[V]--vfs-read-chunk-streams 16\f[R] و
\f[V]--vfs-read-chunk-size 4M\f[R] باشد.
در آزمایش‌های انجام‌شده با AWS S3، میزان کارایی تقریباً متناسب با مقدار
\f[V]--vfs-read-chunk-streams\f[R] مقیاس‌پذیر بوده است.
.PP
تنظیمات مشابه باید برای پیوندهای با تأخیر بالا نیز به خوبی عمل کند، اما بسته به میزان تأخیر، ممکن است برای دستیابی به توان عملیاتی (throughput) مطلوب به مقادیر بالاتری از \f[V]--vfs-read-chunk-streams\f[R] نیاز باشد.
.SS کارایی VFS
.PP
این پرچم‌ها ممکن است برای فعال یا غیرفعال کردن ویژگی‌های VFS به دلایل کارایی یا موارد دیگر استفاده شوند.
همچنین ویژگی خواندن تکه‌ای را ببینید.
.PP
به‌ویژه S3 و Swift سود بسیار زیادی از پرچم
\f[V]--no-modtime\f[R] می‌برند (یا می‌توانید برای تأثیری کمی متفاوت از \f[V]--use-server-modtime\f[R] استفاده کنید)، زیرا هر بار خواندن زمان ویرایش نیازمند یک تراکنش است.
.IP
.nf
\f[C]
    --no-checksum     عدم مقایسهٔ مجموع مقابله‌ای (checksum) هنگام بارگذاری/بارگیری.
    --no-modtime      عدم خواندن/نوشتن زمان ویرایش (می‌تواند سرعت را افزایش دهد).
    --no-seek         عدم اجازه برای جست‌وجو و جابه‌جایی اشاره‌گر (seek) در پرونده‌ها.
    --read-only       تنها اجازهٔ دسترسی فقط‌خواندنی.
\f[R]
.fi
.PP
گاهی اوقات درخواست‌های خواندن یا نوشتن خارج از ترتیب به rclone تحویل داده می‌شوند.
‏rclone به جای جابه‌جایی اشاره‌گر (seeking)، مدت کوتاهی منتظر می‌ماند تا درخواست خواندن یا نوشتن متوالی از راه برسد.
این پرچم‌ها تنها در صورتی اعمال می‌شوند که از پروندهٔ حافظهٔ پنهان (cache) روی دیسک استفاده نشود.
.IP
.nf
\f[C]
    --vfs-read-wait duration   مدت زمان انتظار برای خواندن متوالی پیش از seek (پیش‌فرض 20ms)
    --vfs-write-wait duration  مدت زمان انتظار برای نوشتن متوالی پیش از اعلام خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
هنگام استفاده از حافظهٔ پنهان نوشتن VFS (\f[V]--vfs-cache-mode\f[R] با مقدار
writes یا full)، پرچم سراسری \f[V]--transfers\f[R] می‌تواند برای تنظیم تعداد بارگذاری‌های موازی پرونده‌های تغییریافته از حافظهٔ پنهان تنظیم شود (پرچم سراسری مرتبط \f[V]--checkers\f[R] تأثیری روی VFS ندارد).
.IP
.nf
\f[C]
    --transfers int  تعداد انتقال‌های هم‌زمان پرونده‌ها (پیش‌فرض 4)
\f[R]
.fi.SS پیوندهای نمادین (Symlinks)
.PP
به‌طور پیش‌فرض VFS از پیوندهای نمادین (symlinks) پشتیبانی نمی‌کند.
با این حال، این قابلیت را می‌توان با هر یک از پرچم‌های زیر فعال کرد:
.IP
.nf
\f[C]
    --links      ترجمه پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq].
    --vfs-links  ترجمه پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
\f[R]
.fi
.PP
از آنجا که بیشتر سامانه‌های ذخیره‌سازی ابری مستقیماً از پیوندهای نمادین پشتیبانی نمی‌کنند، rclone پیوند نمادین را به‌صورت یک فایل عادی با یک پسوند ویژه ذخیره می‌کند.
بنابراین، فایلی که به‌صورت پیوند نمادین \f[V]link-to-file.txt\f[R] دیده می‌شود، در فضای ذخیره‌سازی ابری با نام \f[V]link-to-file.txt.rclonelink\f[R] ذخیره خواهد شد و محتوای آن مسیر مقصد پیوند نمادین خواهد بود.
.PP
توجه داشته باشید که \f[V]--links\f[R] تبدیل پیوند نمادین را به‌صورت سراسری در rclone فعال می‌کند \- این شامل هر backend که از این مفهوم پشتیبانی کند (برای نمونه backend محلی) می‌شود.
پرچم \f[V]--vfs-links\f[R] آن را فقط برای لایهٔ VFS فعال می‌کند.
.PP
این طرح با ساختار مورد استفاده توسط backend محلی با پرچم \f[V]--local-links\f[R] سازگار است (<https://rclone.org/local/#symlinks-junction-points>).
.PP
پرچم \f[V]--vfs-links\f[R] برای \f[V]rclone mount\f[R]، \f[V]rclone nfsmount\f[R] و \f[V]rclone serve nfs\f[R] طراحی شده است.
.PP
این پرچم هنوز با سایر دستورهای \f[V]rclone serve\f[R] آزمایش نشده است.
.PP
یکی از محدودیت‌های پیاده‌سازی فعلی این است که انتظار دارد فراخواننده، پیوندهای نمادین زیرمجموعه (sub-symlinks) را حل کند.
برای نمونه، با در نظر گرفتن این درخت دایرکتوری:
.IP
.nf
\f[C]
\&.
├── dir
│\ \  └── file.txt
└── linked-dir -> dir
\f[R]
.fi
.PP
سامانهٔ VFS نام \f[V]linked-dir\f[R] را به‌درستی حل می‌کند، اما \f[V]linked-dir/file.txt\f[R] را خیر.
این موضوع برای دستورهای آزمایش‌شده مشکلی ایجاد نمی‌کند، اما ممکن است برای سایر دستورها مشکل‌ساز باشد.
.PP
\f[B]توجه\f[R] داشته باشید که یک مشکل باز در پشتیبانی از پیوندهای نمادین در گزارش شمارهٔ ۸۲۴۵ (<https://github.com/rclone/rclone/issues/8245>) وجود دارد که مربوط به ایجاد فایل‌های تکراری هنگام انتقال پیوندهای نمادین به دایرکتوری‌هایی با فایلی هم‌نام است (یا برعکس).
.SS حساسیت VFS به کوچک و بزرگی حروف (VFS Case Sensitivity)
.PP
سامانه‌های پروندهٔ لینوکس به بزرگی و کوچکی حروف حساس هستند (case-sensitive): دو فایل می‌توانند تنها در بزرگی و کوچکی حروف تفاوت داشته باشند، و هنگام باز کردن یک فایل باید دقیقاً همان حالت حروف استفاده شود.
.PP
سامانه‌های پرونده در ویندوزهای امروزی به بزرگی و کوچکی حروف حساس نیستند اما حالت حروف را حفظ می‌کنند (case-preserving): اگرچه فایل‌های موجود را می‌توان با هر حالتی از حروف باز کرد، اما حالت دقیق حروف استفاده‌شده هنگام ساخت فایل حفظ شده و در دسترس برنامه‌ها قرار می‌گیرد.
وجود دو فایل در یک دایرکتوری یکسان که تفاوت آن‌ها تنها در بزرگی و کوچکی حروف باشد مجاز نیست.
.PP
سامانه‌های پرونده در macOS معمولاً به بزرگی و کوچکی حروف حساس نیستند.
امکان حساس کردن سامانه‌های پروندهٔ macOS به بزرگی و کوچکی حروف وجود دارد، اما این وضعیت پیش‌فرض نیست.
.PP
پرچم \f[V]--vfs-case-insensitive\f[R] در VFS چگونگی مدیریت این دو حالت را توسط rclone کنترل می‌کند.
اگر مقدار آن \[dq]false\[dq] باشد، rclone نام فایل‌ها را همان‌گونه که هستند به remote ارسال می‌کند.
اگر پرچم \[dq]true\[dq] باشد (یا بدون مقدار در خط فرمان ظاهر شود)، rclone ممکن است همان‌طور که در ادامه توضیح داده شده، یک «اصلاح» (fixup) انجام دهد.
.PP
ممکن است کاربر برای باز کردن/حذف/تغییر نام و غیره، نام فایلی را با حالتی از حروف مشخص کند که با آنچه در remote ذخیره شده متفاوت است.
اگر آرگومانی به یک فایل موجود با نامی دقیقاً یکسان اشاره کند، حالت حروف فایل موجود روی دیسک استفاده خواهد شد.
با این حال، اگر نام فایلی با نام دقیقاً یکسان پیدا نشود اما نامی وجود داشته باشد که تنها در بزرگی و کوچکی حروف متفاوت است، rclone به‌طور شفاف نام را اصلاح خواهد کرد.
این اصلاح تنها زمانی رخ می‌دهد که یک فایل موجود درخواست شده باشد.
حساسیت به بزرگی و کوچکی حروف برای نام فایل‌هایی که به‌تازگی توسط rclone ایجاد می‌شوند، توسط remote زیربنایی کنترل می‌شود.
.PP
توجه داشته باشید که حساسیت سیستم‌عامل اجراکنندهٔ rclone (مقصد) به بزرگی و کوچکی حروف ممکن است با حساسیت سامانهٔ پروندهٔ ارائه‌شده توسط rclone (مبدأ) متفاوت باشد.
این پرچم تعیین می‌کند که آیا «اصلاح» برای برآورده کردن نیازهای مقصد انجام شود یا خیر.
.PP
اگر این پرچم در خط فرمان ارائه نشود، مقدار پیش‌فرض آن به سیستم‌عاملی که rclone در آن اجرا می‌شود بستگی دارد: در Windows و macOS مقدار \[dq]true\[dq]، و در غیر این صورت \[dq]false\[dq].
اگر پرچم بدون مقدار ارائه شود، مقدار آن \[dq]true\[dq] خواهد بود.
.PP
پرچم \f[V]--no-unicode-normalization\f[R] تعیین می‌کند که آیا «اصلاح» مشابهی برای نام‌فایل‌هایی که از نظر یونیکد متفاوت ولی از نظر رسمی هم‌ارز هستند (<https://en.wikipedia.org/wiki/Unicode_equivalence>) انجام شود یا خیر.
عادی‌سازی یونیکد (Unicode normalization) می‌تواند به‌ویژه برای کاربران macOS مفید باشد؛ سیستم‌عاملی که فرم NFD را به فرم NFC مورد استفاده در بیشتر بسترهای دیگر ترجیح می‌دهد.
بنابراین برای جلوگیری از مشکلات سازگاری کدگذاری، اکیداً توصیه می‌شود که در macOS مقدار پیش‌فرض \f[V]false\f[R] دست‌نخورده باقی بماند.
.PP
در صورت رخ دادن رویدادی (احتمالاً نادر) که در آن یک دایرکتوری پس از اعمال عادی‌سازی حروف و یونیکد دارای چندین نام‌فایل تکراری باشد، پرچم \f[V]--vfs-block-norm-dupes\f[R] اجازهٔ پنهان کردن این موارد تکراری را می‌دهد.
این کار با بهایی از نظر کارایی همراه است، چرا که rclone هنگام فهرست کردن یک دایرکتوری باید تمام دایرکتوری را برای یافتن موارد تکراری پویش کند.
به همین دلیل، توصیه می‌شود در صورت عدم نیاز، این گزینه غیرفعال باقی بماند.
با این حال، ممکن است کاربران macOS تمایل داشته باشند از آن استفاده کنند؛ زیرا در غیر این صورت، اگر یک دایرکتوری در ریموت شامل هر دو نسخهٔ NFC و NFD از یک نام‌فایل یکسان باشد، وضعیت عجیبی رخ خواهد داد: هر دو نسخه از فایل در mount قابل مشاهده خواهند بود و به نظر می‌رسد هر دو قابل ویرایش هستند، اما ویرایش هر کدام از نسخه‌ها در اصل و در پشت صحنه تنها به ویرایش نسخهٔ NFD منجر خواهد شد.
پرچم \f[V]--vfs-block-norm-dupes\f[R] با شناسایی این سناریو، پنهان کردن موارد تکراری و ثبت خطا در گزارش (مشابه نحوهٔ مدیریت آن در \f[V]rclone sync\f[R])، از این سردرگمی جلوگیری می‌کند..SS گزینه‌های دیسک VFS
.PP
این پرچم به شما امکان می‌دهد آمار مربوط به سیستم فایل را به صورت دستی
تنظیم کنید.
این گزینه زمانی مفید است که این آمار نتوانند به صورت خودکار و به درستی
خوانده شوند.
.IP
.nf
\f[C]
    --vfs-disk-space-total-size    تنظیم دستی اندازه کل فضای دیسک (مثال: 256G، پیش‌فرض: -1)
\f[R]
.fi
.SS گزارش جایگزین بایت‌های استفاده‌شده
.PP
برخی از backendها، به‌ویژه S3، میزان بایت‌های استفاده‌شده را گزارش نمی‌کنند.
اگر نیاز دارید این اطلاعات هنگام اجرای \f[V]df\f[R] روی سیستم فایل در
دسترس باشد، پرچم \f[V]--vfs-used-is-size\f[R] را به rclone پاس دهید.
با تنظیم این پرچم، rclone به‌جای اتکا به backend برای گزارش این اطلاعات،
کل ریموت را مشابه با \f[V]rclone size\f[R] پویش کرده و کل فضای استفاده‌شده
را خودش محاسبه می‌کند.
.PP
\f[B]هشدار\f[R]: بر خلاف \f[V]rclone size\f[R]، این پرچم فیلترها را
نادیده می‌گیرد تا نتیجه دقیق باشد.
با این حال، این کار بسیار ناکارآمد است و ممکن است باعث فراخوانی‌های متعدد
API شده و هزینه‌های اضافی در پی داشته باشد.
تنها به عنوان آخرین چاره و فقط همراه با کش‌کردن از آن استفاده کنید.
.SS متادیتای VFS
.PP
اگر از پرچم \f[V]--vfs-metadata-extension\f[R] استفاده کنید، می‌توانید
VFS را وادار کنید تا فایل‌هایی را که حاوی
متادیتا (https://rclone.org/docs/#metadata) هستند به عنوان یک شیء JSON
ارائه دهد.
این فایل‌ها در فهرست دایرکتوری ظاهر نخواهند شد، اما می‌توان روی آن‌ها
\f[V]stat\f[R] اجرا کرد و آن‌ها را باز نمود، و پس از باز شدن، تا زمان
منقضی شدن حافظه موقت دایرکتوری در فهرست‌های دایرکتوری ظاهر \f[B]خواهند شد\f[R].
.PP
توجه داشته باشید که برخی از backendها متادیتا ایجاد نخواهند کرد مگر اینکه
پرچم \f[V]--metadata\f[R] را ارسال کنید.
.PP
برای مثال، با استفاده از \f[V]rclone mount\f[R] به همراه
\f[V]--metadata --vfs-metadata-extension .metadata\f[R] خواهیم داشت:
.IP
.nf
\f[C]
$ ls -l /mnt/
total 1048577
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G

$ cat /mnt/1G.metadata
{
        \[dq]atime\[dq]: \[dq]2025-03-04T17:34:22.317069787Z\[dq],
        \[dq]btime\[dq]: \[dq]2025-03-03T16:03:37.708253808Z\[dq],
        \[dq]gid\[dq]: \[dq]1000\[dq],
        \[dq]mode\[dq]: \[dq]100664\[dq],
        \[dq]mtime\[dq]: \[dq]2025-03-03T16:03:39.640238323Z\[dq],
        \[dq]uid\[dq]: \[dq]1000\[dq]
}

$ ls -l /mnt/
total 1048578
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G
-rw-rw-r-- 1 user user        185 Mar  3 16:03 1G.metadata
\f[R]
.fi
.PP
اگر فایل فاقد متادیتا باشد، به صورت \f[V]{}\f[R] برگردانده می‌شود و در
صورت بروز خطا در خواندن متادیتا، خطا به شکل
\f[V]{\[dq]error\[dq]:\[dq]error string\[dq]}\f[R] برگردانده خواهد شد.
.IP
.nf
\f[C]
rclone serve docker [flags]
\f[R]
.fi
.SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
      --allow-idmap                            اجازه به اتصال‌های id-mapped (فقط Linux 6.12+، mount2)
      --allow-non-empty                        اجازه اتصال روی یک دایرکتوری غیرخالی (در ویندوز پشتیبانی نمی‌شود)
      --allow-other                            اجازه دسترسی به سایر کاربران (در ویندوز پشتیبانی نمی‌شود)
      --allow-root                             اجازه دسترسی به کاربر ریشه (در ویندوز پشتیبانی نمی‌شود)
      --async-read                             استفاده از خواندن ناهمگام (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض true)
      --attr-timeout Duration                  مدت زمانی که مشخصه‌های فایل/دایرکتوری کش می‌شوند (پیش‌فرض 1s)
      --base-dir string                        دایرکتوری پایه برای حجم‌ها (پیش‌فرض \[dq]/var/lib/docker-volumes/rclone\[dq])
      --daemon                                 اجرای اتصال در پس‌زمینه و خروج از فرآیند والد (چون خروجی پس‌زمینه نادیده گرفته می‌شود، از --log-file با --log-format=pid,... برای نظارت استفاده کنید) (در ویندوز پشتیبانی نمی‌شود)
      --daemon-timeout Duration                محدودیت زمانی برای پاسخ rclone به هسته (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض 0s)
      --daemon-wait Duration                   زمان انتظار برای آماده‌شدن اتصال از دیمن (حداکثر زمان در لینوکس، زمان انتظار ثابت در OSX/BSD) (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض 1m0s)
      --debug-fuse                             اشکال‌زدایی بخش‌های داخلی FUSE - نیازمند -v
      --default-permissions                    وادار کردن هسته به اعمال کنترل دسترسی بر اساس حالت فایل (در ویندوز پشتیبانی نمی‌شود)
      --devname string                         تنظیم نام دستگاه - پیش‌فرض remote:path است
      --dir-cache-time Duration                مدت زمان کش کردن مدخل‌های دایرکتوری (پیش‌فرض 5m0s)
      --dir-perms FileMode                     مجوزهای دایرکتوری (پیش‌فرض 777)
      --direct-io                              استفاده از Direct IO، کش کردن داده‌ها را غیرفعال می‌کند
      --file-perms FileMode                    مجوزهای فایل (پیش‌فرض 666)
      --forget-state                           صرف‌نظر کردن از بازیابی وضعیت قبلی
      --fuse-flag stringArray                  پرچم‌ها یا آرگومان‌هایی که مستقیماً به libfuse/WinFsp ارسال می‌شوند (در صورت نیاز تکرار شود)
      --gid uint32                             بازنویسی فیلد gid تنظیم‌شده توسط سیستم فایل (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض 1000)
  -h, --help                                   راهنما برای docker
      --link-perms FileMode                    مجوزهای پیوند (پیش‌فرض 666)
      --max-read-ahead SizeSuffix              تعداد بایت‌هایی که می‌توان برای خواندن ترتیبی پیش‌واکشی کرد (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض 128Ki)
      --mount-case-insensitive Tristate        اعلام به سیستم‌عامل مبنی بر اینکه نقطه اتصال به حروف بزرگ و کوچک حساس نیست (true) یا حساس است (false) صرف‌نظر از backend (auto) (پیش‌فرض تنظیم‌نشده)
      --network-mode                           اتصال به عنوان درایو شبکه ریموت، به‌جای درایو دیسک ثابت (فقط در ویندوز پشتیبانی می‌شود)
      --no-checksum                            عدم مقایسه چکسام‌ها هنگام بارگذاری/بارگیری
      --no-modtime                             عدم خواندن/نوشتن زمان تغییر (می‌تواند کارها را سریع‌تر کند)
      --no-seek                                عدم اجازه به پرش (seek) در فایل‌ها
      --no-spec                                عدم نوشتن فایل spec
      --noappledouble                          نادیده‌گرفتن فایل‌های Apple Double (._) و .DS_Store (فقط در OSX پشتیبانی می‌شود) (پیش‌فرض true)
      --noapplexattr                           نادیده‌گرفتن همه مشخصه‌های توسعه‌یافته \[dq]com.apple.*\[dq] (فقط در OSX پشتیبانی می‌شود)
  -o, --option stringArray                     گزینه‌ای برای libfuse/WinFsp (در صورت نیاز تکرار شود)
      --poll-interval Duration                 زمان انتظار بین بررسی دوره‌ای برای تغییرات، باید از dir-cache-time کمتر باشد و فقط روی ریموت‌های پشتیبانی‌شده (برای غیرفعال‌سازی 0 بگذارید) (پیش‌فرض 1m0s)
      --read-only                              فقط اجازه دسترسی فقط‌خواندنی
      --socket-addr string                     نشانی <host:port> یا مسیر مطلق (پیش‌فرض: /run/docker/plugins/rclone.sock)
      --socket-gid int                         شناسه GID برای سوکت یونیکس (پیش‌فرض: GID فرآیند جاری) (پیش‌فرض 1000)
      --uid uint32                             Override the uid field set by the filesystem (not supported on Windows) (default 1000)
      --umask FileMode                         بازنویسی بیت‌های مجوز تنظیم‌شده توسط سیستم فایل (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض 002)
      --vfs-block-norm-dupes                   اگر نام‌های فایل تکراری در همان دایرکتوری (پس از یکسان‌سازی) وجود داشته باشد، ثبت خطا و پنهان‌سازی موارد تکراری (ممکن است هزینه کارایی داشته باشد)
      --vfs-cache-max-age Duration             حداکثر زمان از آخرین دسترسی به اشیاء در کش (پیش‌فرض 1h0m0s)
      --vfs-cache-max-size SizeSuffix          حداکثر اندازه کل اشیاء موجود در کش (پیش‌فرض off)
      --vfs-cache-min-free-space SizeSuffix    حداقل فضای خالی هدف روی دیسک شامل کش (پیش‌فرض off)
      --vfs-cache-mode CacheMode               حالت کش off|minimal|writes|full (پیش‌فرض off)
      --vfs-cache-poll-interval Duration       فاصله زمانی بررسی دوره‌ای کش برای اشیاء بی‌استفاده (پیش‌فرض 1m0s)
      --vfs-case-insensitive                   اگر نام فایلی یافت نشد، تطابق غیرحساس به حروف بزرگ و کوچک پیدا شود
      --vfs-disk-space-total-size SizeSuffix   مشخص کردن کل فضای دیسک (پیش‌فرض off)
      --vfs-fast-fingerprint                   استفاده از اثر انگشت‌های سریع (با دقت کمتر) برای تشخیص تغییرات
      --vfs-handle-caching Duration            مدت زمان زنده نگه‌داشتن هندل فایل و بارگیری‌کننده‌ها پس از آخرین بستن (پیش‌فرض 5s)
      --vfs-links                              ترجمه پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
      --vfs-metadata-extension string          تنظیم پسوند برای خواندن متادیتا از آن
      --vfs-read-ahead SizeSuffix              پیش‌واکشی اضافی فراتر از --buffer-size هنگام استفاده از cache-mode full
      --vfs-read-chunk-size SizeSuffix         خواندن اشیاء منبع به صورت تکه‌تکه (پیش‌فرض 128Mi)
      --vfs-read-chunk-size-limit SizeSuffix   در صورت بزرگتر بودن از --vfs-read-chunk-size، دو برابر کردن اندازه تکه پس از خواندن هر تکه، تا زمانی که به حد مجاز برسد (\[aq]off\[aq] نامحدود است) (پیش‌فرض off)
      --vfs-read-chunk-streams int             تعداد جریان‌های موازی برای خواندن هم‌زمان
      --vfs-read-wait Duration                 زمان انتظار برای خواندن متوالی قبل از پرش (پیش‌فرض 20ms)
      --vfs-refresh                            تازه‌سازی بازگشتی حافظه موقت دایرکتوری در پس‌زمینه هنگام شروع
      --vfs-used-is-size rclone size           استفاده از الگوریتم rclone size برای اندازه استفاده‌شده
      --vfs-write-back Duration                زمان بازنویسی فایل‌ها پس از آخرین استفاده هنگام استفاده از حافظه موقت (پیش‌فرض 5s)
      --vfs-write-wait Duration                زمان انتظار برای نوشتن متوالی پیش از اعلام خطا (پیش‌فرض 1s)
      --volname string                         تنظیم نام حجم (فقط در ویندوز و OSX پشتیبانی می‌شود)
      --write-back-cache                       وادار کردن هسته به بافر کردن نوشتن‌ها پیش از ارسال به rclone (بدون این، از کش writethrough استفاده می‌شود) (در ویندوز پشتیبانی نمی‌شود)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه توضیح داده شده‌اند.
برای مشاهده گزینه‌های سراسری که در اینجا فهرست نشده‌اند، به صفحه پرچم‌های
سراسری (https://rclone.org/flags) مراجعه کنید..SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌ها برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از - برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام‌فایل‌های مبدأ از فایل (استفاده از - برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام‌فایل‌های مبدأ از فایل بدون هیچ‌گونه پردازش خطوط (استفاده از - برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام‌فایل‌های مبدأ از فایل با جداکننده NUL (استفاده از - برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قاعده فیلتر فایل
      --filter-from stringArray             خواندن الگوهای فیلتر فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --hash-filter string                  افراز نام فایل‌ها بر پایه هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به بزرگی و کوچکی)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از - برای خواندن از stdin)
      --max-age Duration                    تنها انتقال فایل‌های جدیدتر از این مقدار برحسب s یا پسوندهای ms|s|m|h|d|w|M|y (پیش‌فرض: غیرفعال)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 تنها انتقال فایل‌های کوچک‌تر از این مقدار برحسب KiB یا پسوندهای B|K|M|G|T|P (پیش‌فرض: غیرفعال)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (استفاده از - برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قاعده فیلتر متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر متاداده از یک فایل (استفاده از - برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از فایل (استفاده از - برای خواندن از stdin)
      --min-age Duration                    تنها انتقال فایل‌های قدیمی‌تر از این مقدار برحسب s یا پسوندهای ms|s|m|h|d|w|M|y (پیش‌فرض: غیرفعال)
      --min-size SizeSuffix                 تنها انتقال فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا پسوندهای B|K|M|G|T|P (پیش‌فرض: غیرفعال)
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone serve (https://rclone.org/commands/rclone_serve) \- ارائه یک
ریموت بر بستر یک پروتکل.
.SH rclone serve ftp
.PP
ارائه remote:path بر بستر FTP.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
اجرای یک سرور پایه‌ای FTP برای ارائه یک ریموت بر بستر پروتکل FTP.
این سرور را می‌توان با یک کلاینت FTP مشاهده کرد یا می‌توانید یک ریموت از نوع
FTP برای خواندن و نوشتن روی آن ایجاد کنید.
.SS "گزینه‌های سرور (Server options)"
.PP
از --addr برای مشخص کردن این‌که سرور باید روی چه آدرس IP و پورتی شنود کند
استفاده کنید؛ مانند:
--addr 1.2.3.4:8000 یا --addr :8080 برای شنود روی تمامی IPها.
به‌طور پیش‌فرض سرور تنها روی localhost شنود می‌کند.
می‌توانید از پورت :0 استفاده کنید تا سیستم‌عامل یک پورت دردسترس را انتخاب کند.
.PP
اگر --addr را برای شنود روی یک آدرس IP عمومی یا دردسترس در شبکه محلی (LAN)
تنظیم کنید، استفاده از احراز هویت توصیه می‌شود \- برای اطلاعات بیشتر بخش بعدی را ببینید.
.SS "احراز هویت (Authentication)"
.PP
به‌طور پیش‌فرض، فایل‌ها بدون نیاز به ورود ارائه خواهند شد.
.PP
می‌توانید با پرچم‌های --user و --pass یک نام کاربری و گذرواژه مشخص کنید.
.SS "سامانه فایل مجازی (VFS - Virtual File System)"
.PP
این دستور از لایه VFS استفاده می‌کند.
این لایه، اشیاء فضای ذخیره‌سازی ابری را که rclone استفاده می‌کند، به چیزی تبدیل
می‌نماید که شباهت بسیار بیشتری به یک سامانه فایل دیسکی دارد.
.PP
اشیاء فضای ذخیره‌سازی ابری ویژگی‌های بسیاری دارند که شبیه فایل‌های دیسک
نیستند \- نمی‌توانید اندازه آن‌ها را گسترش دهید یا در میانه آن‌ها بنویسید؛ بنابراین
لایه VFS باید با این مسائل دست‌وپنجه نرم کند.
از آنجا که یک راه واحد و قطعی برای انجام این کار وجود ندارد، گزینه‌های گوناگونی
در ادامه توضیح داده شده است.
.PP
لایه VFS همچنین یک حافظه موقت (cache) برای دایرکتوری‌ها پیاده‌سازی می‌کند \- این
حافظه، اطلاعات مربوط به فایل‌ها و دایرکتوری‌ها (اما نه خود داده‌ها) را در حافظه اصلی ذخیره می‌کند.
.SS "حافظه موقت دایرکتوری VFS (VFS Directory Cache)"
.PP
با استفاده از پرچم \f[V]--dir-cache-time\f[R]، می‌توانید کنترل کنید که یک
دایرکتوری تا چه مدت به‌روز در نظر گرفته شود و نیازی به بازخوانی مجدد آن از
backend نباشد.
تغییراتی که از طریق VFS ایجاد می‌شوند بلافاصله نمایان شده یا حافظه موقت را
نامعتبر می‌کنند.
.IP
.nf
\f[C]
    --dir-cache-time duration   مدت نگهداری مدخل‌های دایرکتوری در حافظه موقت (پیش‌فرض 5m0s)
    --poll-interval duration    زمان انتظار بین بررسی تغییرات. باید کوچک‌تر از dir-cache-time باشد. فقط در ریموت‌های پشتیبانی‌شده. برای غیرفعال‌سازی روی 0 بگذارید (پیش‌فرض 1m0s)
\f[R]
.fi
.PP
با این حال، تغییراتی که مستقیماً از طریق رابط وب یا یک نمونهٔ دیگر از rclone در
فضای ذخیره‌سازی ابری ایجاد شوند، در صورتی که backend پیکربندی‌شده از بررسی
دوره‌ای تغییرات (polling) پشتیبانی نکند، تنها پس از انقضای حافظه موقت دایرکتوری
دریافت خواهند شد.
اگر backend از بررسی دوره‌ای پشتیبانی کند، تغییرات در بازه زمانی polling دریافت
می‌شوند.
.PP
می‌توانید یک سیگنال \f[V]SIGHUP\f[R] به rclone ارسال کنید تا تمامی حافظه‌های موقت
دایرکتوری را بدون در نظر گرفتن سن آن‌ها پاک‌سازی (flush) کند.
با فرض این‌که تنها یک نمونه از rclone در حال اجرا است، می‌توانید حافظه موقت را
این‌گونه بازنشانی کنید:
.IP
.nf
\f[C]
kill -SIGHUP $(pidof rclone)
\f[R]
.fi
.PP
اگر rclone را همراه با کنترل از راه دور (remote control) پیکربندی کنید، می‌توانید از rclone rc
برای تخلیه کل حافظه موقت دایرکتوری استفاده کنید:
.IP
.nf
\f[C]
rclone rc vfs/forget
\f[R]
.fi
.PP
یا برای فایل‌ها یا دایرکتوری‌های مجزا:
.IP
.nf
\f[C]
rclone rc vfs/forget file=path/to/file dir=path/to/dir
\f[R]
.fi.SS بافر کردن فایل در VFS
.PP
گزینه \f[V]--buffer-size\f[R] مقدار حافظه‌ای را که برای بافر کردن پیشاپیش داده‌ها به کار می‌رود تعیین می‌کند.
.PP
هر فایلِ باز همواره تلاش خواهد کرد مقدار مشخص‌شده داده را در حافظه نگه‌دارد.
داده‌های بافرشده مقید به یک فایل باز هستند و به اشتراک گذاشته نخواهند شد.
.PP
این گزینه یک سقف بالا برای حافظه مصرفی به ازای هر فایل باز است.
بافر تنها برای داده‌هایی که دانلود شده اما هنوز خوانده نشده‌اند از حافظه استفاده خواهد کرد.
اگر بافر خالی باشد، تنها مقدار کمی از حافظه مصرف خواهد شد.
.PP
حداکثر حافظه استفاده‌شده توسط rclone برای بافر کردن می‌تواند تا
\f[V]--buffer-size * open files\f[R] باشد.
.SS کَش کردن فایل در VFS
.PP
این گزینه‌ها تنظیمات کَش کردن فایل در VFS را کنترل می‌کنند.
کَش کردن فایل برای سازگار جلوه دادن لایه VFS با یک فایل‌سیستم معمولی ضروری است.
می‌توان آن را به بهای از دست رفتن مقداری از سازگاری غیرفعال کرد.
.PP
برای نمونه، اگر بخواهید هم‌زمان روی یک فایل بخوانید و بنویسید، باید کَش VFS را فعال کنید.
برای جزئیات بیشتر به موارد زیر نگاه کنید.
.PP
توجه داشته باشید که کَش VFS از backend کَش مجزاست و ممکن است متوجه شوید به یکی از آن‌ها یا هر دو نیاز دارید.
.IP
.nf
\f[C]
    --cache-dir string                     دایرکتوری مورد استفاده rclone برای کَش.
    --vfs-cache-mode CacheMode             حالت کَش off|minimal|writes|full (پیش‌فرض off)
    --vfs-cache-max-age duration           حداکثر زمان از آخرین دسترسی به اشیاء در کَش (پیش‌فرض 1h0m0s)
    --vfs-cache-max-size SizeSuffix        حداکثر حجم کل اشیاء در کَش (پیش‌فرض off)
    --vfs-cache-min-free-space SizeSuffix  حداقل فضای خالی هدف روی دیسک حاوی کَش (پیش‌فرض off)
    --vfs-cache-poll-interval duration     فاصله زمانی بررسی کَش برای اشیاء منسوخ (پیش‌فرض 1m0s)
    --vfs-write-back duration              زمان بازنویسی فایل‌ها پس از آخرین استفاده هنگام به‌کارگیری کَش (پیش‌فرض 5s)
\f[R]
.fi
.PP
در صورت اجرا با \f[V]-vv\f[R]، rclone مکان کَش فایل را چاپ خواهد کرد.
فایل‌ها در ناحیه فایل‌های کَش کاربر ذخیره می‌شوند که وابسته به سیستم‌عامل است، اما می‌توان آن را با \f[V]--cache-dir\f[R] یا تنظیم متغیر محیطی مناسب کنترل کرد.
.PP
کَش دارای ۴ حالت مختلف است که توسط \f[V]--vfs-cache-mode\f[R] انتخاب می‌شوند.
هرچه حالت کَش بالاتر باشد، rclone به قیمت مصرف فضای دیسک، سازگارتر می‌شود.
.PP
توجه داشته باشید که فایل‌ها تنها زمانی در ریموت بازنویسی می‌شوند که بسته شده باشند و به مدت \f[V]--vfs-write-back\f[R] ثانیه مورد دسترسی قرار نگرفته باشند.
اگر rclone با فایل‌هایی که هنوز بارگذاری نشده‌اند بسته شود یا از کار بیفتد، این فایل‌ها در اجرای بعدی rclone با همان گزینه‌ها بارگذاری خواهند شد.
.PP
در صورت استفاده از \f[V]--vfs-cache-max-size\f[R] یا
\f[V]--vfs-cache-min-free-space\f[R] توجه داشته باشید که کَش ممکن است به دو دلیل از این سهمیه‌ها فراتر رود.
نخست به این دلیل که بررسی آن تنها هر
\f[V]--vfs-cache-poll-interval\f[R] یک‌بار انجام می‌شود.
دوم به این دلیل که فایل‌های باز را نمی‌توان از کَش تخلیه کرد.
هنگامی که از \f[V]--vfs-cache-max-size\f[R] یا
\f[V]--vfs-cache-min-free-space\f[R] فراتر رود، rclone ابتدا تلاش خواهد کرد فایل‌هایی را که کمترین دسترسی به آن‌ها صورت گرفته از کَش تخلیه کند.
rclone کار را با فایل‌هایی شروع خواهد کرد که برای بیشترین مدت مورد دسترسی قرار نگرفته‌اند.
این راهبرد پاک‌سازی کَش کارآمد است و احتمال باقی ماندن فایل‌های مرتبط‌تر در کَش بیشتر خواهد بود.
.PP
گزینه \f[V]--vfs-cache-max-age\f[R] فایل‌ها را پس از سپری شدن زمان تعیین‌شده از آخرین دسترسی، از کَش تخلیه می‌کند؛ این عملکرد بر پایه زمان دسترسی است، نه زمانی که فایل برای نخستین بار به کَش افزوده شده است.
مقدار پیش‌فرض ۱ ساعت شروع به تخلیه فایل‌هایی از کَش می‌کند که به مدت ۱ ساعت به آن‌ها دسترسی صورت نگرفته باشد.
هنگامی که به یک فایل کَش‌شده دسترسی پیدا شود، زمان‌سنج ۱ ساعته بازنشانی شده و پیش از تخلیه، ۱ ساعت دیگر منتظر خواهد ماند.
زمان را با نشانه‌گذاری استاندارد s، m، h، d، w مشخص کنید.
.PP
اگر از \f[V]--vfs-cache-mode > off\f[R] استفاده می‌کنید، \f[B]نباید\f[R] دو نسخه از rclone را با کَش VFS یکسان و با ریموت‌های یکسان یا دارای هم‌پوشانی اجرا کنید.
انجام این کار بالقوه می‌تواند باعث خرابی داده‌ها شود.
می‌توانید با اختصاص دادن سلسله‌مراتب کَش جداگانه به هر rclone با استفاده از \f[V]--cache-dir\f[R]، این مسئله را برطرف کنید.
اگر ریموت‌های در حال استفاده با یکدیگر هم‌پوشانی ندارند، نیازی به نگرانی در این مورد نیست..SS --vfs-cache-mode off
.PP
در این حالت (پیش‌فرض)، حافظه موقت (cache) مستقیماً از ریموت می‌خواند
و مستقیماً روی ریموت می‌نویسد، بدون اینکه چیزی را روی دیسک ذخیره کند.
.PP
این بدان معناست که برخی از عملیات‌ها امکان‌پذیر نخواهند بود:
.IP \[bu] 2
فایل‌ها نمی‌توانند هم‌زمان برای خواندن و نوشتن باز شوند
.IP \[bu] 2
در فایل‌های باز شده برای نوشتن، امکان جابه‌جایی موقعیت (seek) وجود ندارد
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید O_TRUNC را تنظیم کرده باشند
.IP \[bu] 2
فایل‌های باز شده برای خواندن با O_TRUNC، به صورت فقط‌نوشتنی باز خواهند شد
.IP \[bu] 2
فایل‌های باز شده برای حالت فقط‌نوشتنی به‌گونه‌ای رفتار خواهند کرد که گویی O_TRUNC مشخص شده است
.IP \[bu] 2
حالت‌های باز کردن O_APPEND و O_TRUNC نادیده گرفته می‌شوند
.IP \[bu] 2
اگر یک بارگذاری با شکست مواجه شود، امکان تلاش مجدد وجود ندارد
.SS --vfs-cache-mode minimal
.PP
این حالت بسیار شبیه به \[dq]off\[dq] است، با این تفاوت که فایل‌های باز شده برای
خواندن و نوشتن روی دیسک بافر می‌شوند.
این موضوع باعث می‌شود که فایل‌های باز شده برای نوشتن بسیار سازگارتر باشند،
اما کمترین میزان فضای دیسک را مصرف می‌کند.
.PP
این عملیات‌ها امکان‌پذیر نیستند:
.IP \[bu] 2
در فایل‌های باز شده به صورت فقط‌نوشتنی امکان جابه‌جایی موقعیت (seek) وجود ندارد
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید O_TRUNC را تنظیم کرده باشند
.IP \[bu] 2
فایل‌های باز شده برای حالت فقط‌نوشتنی، O_APPEND و O_TRUNC را نادیده می‌گیرند
.IP \[bu] 2
اگر یک بارگذاری با شکست مواجه شود، امکان تلاش مجدد وجود ندارد
.SS --vfs-cache-mode writes
.PP
در این حالت، فایل‌های باز شده به صورت فقط‌خواندنی همچنان مستقیماً از ریموت
خوانده می‌شوند، اما فایل‌های فقط‌نوشتنی و خواندنی/نوشتنی ابتدا روی دیسک بافر می‌شوند.
.PP
این حالت باید از تمام عملیات‌های عادی سیستم فایل پشتیبانی کند.
.PP
اگر یک بارگذاری با شکست مواجه شود، تلاش مجدد در فواصل زمانی افزایشیِ نمایی
تا حداکثر ۱ دقیقه انجام خواهد شد.
.SS --vfs-cache-mode full
.PP
در این حالت تمام عملیات خواندن و نوشتن از و روی دیسک بافر می‌شوند.
هنگامی که داده‌ها از ریموت خوانده می‌شوند، این اطلاعات نیز روی دیسک بافر خواهند شد.
.PP
در این حالت، فایل‌های موجود در کش از نوع فایل‌های پراکنده (sparse files) خواهند بود
و rclone پیگیری می‌کند که کدام بخش‌ها از فایل‌ها دانلود شده‌اند.
.PP
بنابراین اگر برنامه‌ای فقط ابتدای هر فایل را بخواند، rclone تنها
ابتدای فایل را بافر می‌کند.
این فایل‌ها در کش با اندازه کامل خود نمایش داده می‌شوند، اما فایل‌های
پراکنده هستند که فقط داده‌های دانلود شده درون آن‌ها وجود دارد.
.PP
این حالت باید از تمام عملیات‌های عادی سیستم فایل پشتیبانی کند و در سایر
موارد، دقیقاً مشابه \f[V]--vfs-cache-mode\f[R] writes است.
.PP
هنگام خواندن یک فایل، rclone به اندازه \f[V]--buffer-size\f[R] به‌علاوه
\f[V]--vfs-read-ahead\f[R] بایت جلوتر را پیش‌خوانی می‌کند.
مقدار \f[V]--buffer-size\f[R] در حافظه (RAM) بافر می‌شود در حالی که
\f[V]--vfs-read-ahead\f[R] روی دیسک بافر می‌گردد.
.PP
هنگام استفاده از این حالت، توصیه می‌شود که \f[V]--buffer-size\f[R]
بیش از حد بزرگ تنظیم نشود و در صورت نیاز، مقدار \f[V]--vfs-read-ahead\f[R]
بزرگ در نظر گرفته شود.
.PP
\f[B]مهم:\f[R] همه سیستم‌های فایل از فایل‌های پراکنده (sparse files) پشتیبانی نمی‌کنند.
به‌ویژه سامانه‌های FAT/exFAT پشتیبانی نمی‌کنند.
اگر دایرکتوری کش روی سیستم فایلی باشد که از فایل‌های پراکنده پشتیبانی نمی‌کند،
عملکرد rclone بسیار ضعیف خواهد بود و در صورت تشخیص چنین وضعیتی، یک پیام ERROR
ثبت خواهد کرد.
.SS اثرانگشت‌نگاری (Fingerprinting)
.PP
بخش‌های مختلف VFS از اثرانگشت‌نگاری برای تشخیص اینکه آیا نسخه محلی فایل نسبت
به فایل ریموت تغییر کرده است یا خیر، استفاده می‌کنند.
اثرانگشت‌ها بر اساس موارد زیر ساخته می‌شوند:
.IP \[bu] 2
اندازه (size)
.IP \[bu] 2
زمان آخرین تغییر (modification time)
.IP \[bu] 2
هش (hash)
.PP
البته در صورتی که برای شیء مورد نظر در دسترس باشند.
.PP
در برخی از بک‌اندها (backends) خواندن برخی از این مشخصه‌ها کُند است
(نیازمند یک فراخوانی API اضافی برای هر شیء، یا پردازش اضافی به ازای هر شیء هستند).
.PP
به عنوان مثال، \f[V]hash\f[R] در بک‌اندهای \f[V]local\f[R] و \f[V]sftp\f[R]
کُند است زیرا باید کل فایل را بخوانند و آن را هش کنند، و \f[V]modtime\f[R] در
بک‌اندهای \f[V]s3\f[R]، \f[V]swift\f[R]، \f[V]ftp\f[R] و \f[V]qinqstor\f[R]
کُند است زیرا برای دریافت آن نیازمند یک فراخوانی API اضافی هستند.
.PP
اگر از پرچم \f[V]--vfs-fast-fingerprint\f[R] استفاده کنید، rclone
عملیات‌های کُند را در اثرانگشت لحاظ نخواهد کرد.
این کار دقت اثرانگشت‌نگاری را کاهش می‌دهد اما سرعت آن را بسیار بالا می‌برد
و زمان باز شدن فایل‌های ذخیره‌شده در کش را بهبود می‌بخشد.
.PP
اگر از حافظه موقت vfs روی بک‌اندهای \f[V]local\f[R]، \f[V]s3\f[R] یا
\f[V]swift\f[R] استفاده می‌کنید، استفاده از این پرچم توصیه می‌شود.
.PP
توجه داشته باشید که اگر مقدار این پرچم را تغییر دهید، اثرانگشت فایل‌های
موجود در کش ممکن است باطل شود و نیاز باشد فایل‌ها دوباره دانلود شوند..SS خواندن تکه‌ای در VFS
.PP
هنگامی که rclone فایل‌ها را از یک ریموت می‌خواند، آن‌ها را به صورت تکه‌ای (قطعه‌ای) دریافت می‌کند.
این بدان معناست که rclone به‌جای درخواست کل فایل، تنها تکه مشخص‌شده را می‌خواند.
این قابلیت می‌تواند با درخواست تنها تکه‌هایی از ریموت که واقعاً خوانده می‌شوند، سهمیه دانلود مصرفی را برای برخی ریموت‌ها کاهش دهد؛ اگرچه این کار به قیمت افزایش تعداد درخواست‌ها تمام می‌شود.
.PP
این پرچم‌ها رفتار تکه‌بندی را کنترل می‌کنند:
.IP
.nf
\f[C]
    --vfs-read-chunk-size SizeSuffix        خواندن اشیاء مبدأ به صورت تکه‌ای (پیش‌فرض 128M)
    --vfs-read-chunk-size-limit SizeSuffix  حداکثر اندازه دو برابر شدن تکه (پیش‌فرض off)
    --vfs-read-chunk-streams int            تعداد جریان‌های موازی برای خواندن هم‌زمان
\f[R]
.fi
.PP
رفتار تکه‌بندی بسته به پارامتر
\f[V]--vfs-read-chunk-streams\f[R] متفاوت خواهد بود.
.SS \f[V]--vfs-read-chunk-streams\f[R] == 0
.PP
دستور rclone خواندن را با تکه‌ای به اندازه
\f[V]--vfs-read-chunk-size\f[R] آغاز کرده و سپس با هر بار خواندن، اندازه را دو برابر می‌کند.
هنگامی که \f[V]--vfs-read-chunk-size-limit\f[R] تعیین شده و بزرگ‌تر از
\f[V]--vfs-read-chunk-size\f[R] باشد، اندازه تکه برای هر فایل باز شده تنها تا زمان رسیدن به مقدار مشخص‌شده دو برابر خواهد شد.
اگر این مقدار برابر با \[dq]off\[dq] باشد (که حالت پیش‌فرض است)، محدودیت غیرفعال بوده و اندازه تکه بدون محدودیت افزایش می‌یابد.
.PP
با \f[V]--vfs-read-chunk-size 100M\f[R] و
\f[V]--vfs-read-chunk-size-limit 0\f[R] بخش‌های زیر دانلود خواهند شد:
0-100M، 100M-200M، 200M-300M، 300M-400M و به همین ترتیب.
هنگامی که \f[V]--vfs-read-chunk-size-limit 500M\f[R] مشخص شود، نتیجه به‌صورت
0-100M، 100M-300M، 300M-700M، 700M-1200M، 1200M-1700M و به همین ترتیب خواهد بود.
.PP
تنظیم \f[V]--vfs-read-chunk-size\f[R] روی \f[V]0\f[R] یا \[dq]off\[dq]
خواندن تکه‌ای را غیرفعال می‌کند.
.PP
تکه‌ها در حافظه بافر نخواهند شد.
.SS \f[V]--vfs-read-chunk-streams\f[R] > 0
.PP
دستور rclone به تعداد \f[V]--vfs-read-chunk-streams\f[R] تکه با اندازه
\f[V]--vfs-read-chunk-size\f[R] را به‌طور هم‌زمان می‌خواند.
اندازه هر بار خواندن ثابت باقی خواهد ماند.
.PP
این کارایی را در پیوندهای با تأخیر بالا یا پیوندهای با پهنای باند بسیار بالا به ذخیره‌سازهای شیء با کارایی بالا به‌طور چشمگیری بهبود می‌بخشد.
.PP
برای یافتن مقادیر بهینه \f[V]--vfs-read-chunk-size\f[R] و \f[V]--vfs-read-chunk-streams\f[R]
به مقداری آزمون و خطا نیاز است، زیرا این مقادیر به بک‌اند مورد استفاده و میزان تأخیر تا بک‌اند بستگی دارند.
.PP
برای ذخیره‌سازهای شیء با کارایی بالا (مانند AWS S3)، یک نقطه شروع معقول می‌تواند
\f[V]--vfs-read-chunk-streams 16\f[R] و \f[V]--vfs-read-chunk-size 4M\f[R] باشد.
در آزمایش‌های انجام‌شده با AWS S3، کارایی تقریباً متناسب با مقدار تنظیم‌شده برای
\f[V]--vfs-read-chunk-streams\f[R] مقیاس‌پذیر بود.
.PP
تنظیمات مشابه باید برای پیوندهای با تأخیر بالا نیز پاسخگو باشد، اما بسته به میزان تأخیر ممکن است برای دستیابی به توان عملیاتی مناسب، به مقدار بیشتری از
\f[V]--vfs-read-chunk-streams\f[R] نیاز باشد.
.SS کارایی VFS
.PP
این پرچم‌ها ممکن است برای فعال یا غیرفعال کردن قابلیت‌های VFS به دلایل کارایی یا موارد دیگر مورد استفاده قرار گیرند.
همچنین ویژگی خواندن تکه‌ای را بررسی کنید.
.PP
به‌ویژه S3 و Swift از پرچم \f[V]--no-modtime\f[R] سود بسیار زیادی می‌برند (یا از
\f[V]--use-server-modtime\f[R] برای اثری اندکی متفاوت استفاده کنید)، چرا که هر بار خواندن زمان ویرایش نیازمند یک تراکنش مستقل است.
.IP
.nf
\f[C]
    --no-checksum     عدم مقایسه چکسام‌ها هنگام بارگذاری/دانلود.
    --no-modtime      عدم خواندن/نوشتن زمان ویرایش (می‌تواند کارها را سرعت بخشد).
    --no-seek         عدم اجازه پرش (seek) در فایل‌ها.
    --read-only       فقط اجازه دسترسی فقط‌خواندنی.
\f[R]
.fi
.PP
گاهی اوقات عملیات خواندن یا نوشتن خارج از ترتیب به rclone تحویل داده می‌شود.
دستور rclone به‌جای عمل پرش (seek)، مدت کوتاهی منتظر می‌ماند تا عملیات خواندن یا نوشتنِ مرتب‌شده دریافت شود.
این پرچم‌ها تنها زمانی اثرگذار هستند که از فایل کش روی دیسک استفاده نشود.
.IP
.nf
\f[C]
    --vfs-read-wait duration   مدت انتظار برای خواندن مرتب‌شده قبل از seek (پیش‌فرض 20ms)
    --vfs-write-wait duration  مدت انتظار برای نوشتن مرتب‌شده قبل از دادن خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
هنگام استفاده از کش نوشتن VFS (پرچم \f[V]--vfs-cache-mode\f[R] با مقدار
writes یا full)، پرچم سراسری \f[V]--transfers\f[R] می‌تواند برای تنظیم تعداد بارگذاری‌های موازی فایل‌های تغییریافته از کش تنظیم شود
(پرچم سراسری مرتبط \f[V]--checkers\f[R] هیچ اثری بر VFS ندارد).
.IP
.nf
\f[C]
    --transfers int  تعداد انتقال‌های هم‌زمان فایل (پیش‌فرض 4)
\f[R]
.fi.SS "پیوندهای نمادین (Symlinks)"
.PP
به‌طور پیش‌فرض VFS از پیوندهای نمادین پشتیبانی نمی‌کند.
با این حال، می‌توان این قابلیت را با هر یک از پرچم‌های زیر فعال کرد:
.IP
.nf
\f[C]
    --links      Translate symlinks to/from regular files with a \[aq].rclonelink\[aq] extension.
    --vfs-links  Translate symlinks to/from regular files with a \[aq].rclonelink\[aq] extension for the VFS
\f[R]
.fi
.PP
از آنجا که بیشتر سامانه‌های ذخیره‌سازی ابری مستقیماً از پیوندهای نمادین پشتیبانی نمی‌کنند، rclone
پیوند نمادین را به‌صورت یک فایل عادی با یک پسوند ویژه ذخیره می‌کند.
بنابراین فایلی که به شکل یک پیوند نمادین \f[V]link-to-file.txt\f[R] دیده می‌شود،
در ذخیره‌ساز ابری به‌صورت \f[V]link-to-file.txt.rclonelink\f[R] ذخیره خواهد شد و
محتوای آن، مسیرِ مقصد پیوند نمادین خواهد بود.
.PP
توجه داشته باشید که \f[V]--links\f[R] ترجمه پیوندهای نمادین را به‌طور سراسری در
rclone فعال می‌کند \- این شامل هر backend که از این مفهوم پشتیبانی کند (برای
مثال backend محلی) می‌شود.
\f[V]--vfs-links\f[R] آن را فقط برای لایهٔ VFS فعال می‌کند.
.PP
این سازوکار با سازوکار مورد استفاده توسط backend محلی با پرچم
\f[V]--local-links\f[R] سازگار است (<https://rclone.org/local/#symlinks-junction-points>).
.PP
پرچم \f[V]--vfs-links\f[R] برای
\f[V]rclone mount\f[R]، \f[V]rclone nfsmount\f[R] و
\f[V]rclone serve nfs\f[R] طراحی شده است.
.PP
این قابلیت هنوز با سایر دستورهای \f[V]rclone serve\f[R] آزمایش
نشده است.
.PP
یکی از محدودیت‌های پیاده‌سازی فعلی این است که انتظار دارد فراخواننده
پیوندهای نمادین فرعی (sub-symlinks) را حل کند.
برای مثال در درخت دایرکتوری زیر:
.IP
.nf
\f[C]
\&.
├── dir
│\ \  └── file.txt
└── linked-dir -> dir
\f[R]
.fi
.PP
لایهٔ VFS به‌درستی \f[V]linked-dir\f[R] را حل می‌کند، اما
\f[V]linked-dir/file.txt\f[R] را حل نمی‌کند.
این موضوع برای دستورهای آزمایش‌شده مشکلی ایجاد نمی‌کند اما ممکن است برای سایر
دستورها مشکل‌ساز شود.
.PP
\f[B]توجه\f[R] داشته باشید که یک مشکل حل‌نشده در پشتیبانی از پیوندهای نمادین وجود دارد
(گزارش شماره #8245 در <https://github.com/rclone/rclone/issues/8245>)؛ به این صورت
که هنگام انتقال پیوندهای نمادین به دایرکتوری‌هایی که فایلی با همان نام در آن‌ها وجود دارد
(یا برعکس)، فایل‌های تکراری ایجاد می‌شوند.
.SS "حساسیت VFS به بزرگی و کوچکی حروف (VFS Case Sensitivity)"
.PP
سامانه‌های فایل لینوکس به بزرگی و کوچکی حروف حساس هستند (case-sensitive): دو فایل می‌توانند فقط در
بزرگی و کوچکی حروف با یکدیگر تفاوت داشته باشند، و هنگام باز کردن یک فایل باید دقیقاً همان حالت حروف استفاده شود.
.PP
سامانه‌های فایل در Windows امروزی به بزرگی و کوچکی حروف حساس نیستند اما حالت حروف را حفظ می‌کنند (case-preserving):
اگرچه فایل‌های موجود را می‌توان با هر حالتی از حروف باز کرد، اما حالت دقیق حروفی که
برای ایجاد فایل استفاده شده است حفظ می‌شود و برنامه‌ها می‌توانند آن را
جویا شوند.
مجاز نیست که دو فایل در یک دایرکتوری، تنها در بزرگی و کوچکی حروف
تفاوت داشته باشند.
.PP
معمولاً سامانه‌های فایل در macOS به بزرگی و کوچکی حروف حساس نیستند.
امکان حساس کردن سامانه‌های فایل macOS به بزرگی و کوچکی حروف وجود دارد اما این
حالت پیش‌فرض نیست.
.PP
پرچم VFS با نام \f[V]--vfs-case-insensitive\f[R] چگونگی مدیریت این دو حالت را توسط rclone
کنترل می‌کند.
اگر مقدار آن \[dq]false\[dq] باشد، rclone نام‌های فایل را همان‌طور که هستند (دست‌نخورده) به remote
ارسال می‌کند.
اگر این پرچم \[dq]true\[dq] باشد (یا بدون مقدار در خط فرمان ظاهر
شود)، rclone ممکن است یک «تصحیح» (fixup) را همان‌طور که در زیر توضیح داده شده انجام دهد.
.PP
کاربر ممکن است نام فایلی را برای باز کردن/حذف/تغییر نام/غیره با حالتی از حروف
متفاوت از آنچه در remote ذخیره شده مشخص کند.
اگر یک آرگومان به فایلی موجود با دقیقاً همان نام اشاره کند،
حالت حروف فایلِ موجود روی دیسک استفاده خواهد شد.
با این حال، اگر نام فایلی با همان تطابق دقیق پیدا نشود اما نامی
که فقط در بزرگی و کوچکی حروف متفاوت است وجود داشته باشد، rclone نام را به‌طور شفاف تصحیح خواهد کرد.
این تصحیح فقط زمانی رخ می‌دهد که یک فایل موجود درخواست شود.
حساسیت به بزرگی و کوچکی حروف برای نام فایل‌هایی که به‌تازگی توسط rclone ایجاد می‌شوند، توسط
remote زیرین کنترل می‌شود.
.PP
توجه داشته باشید که حساسیت به بزرگی و کوچکی حروف در سیستم‌عامل اجراکنندهٔ rclone (مقصد یا target)
ممکن است با حساسیت سامانه فایلی که توسط rclone ارائه می‌شود (مبدأ یا source) تفاوت داشته باشد.
این پرچم کنترل می‌کند که آیا «تصحیح» برای برآورده کردن نیازهای مقصد
انجام شود یا خیر.
.PP
اگر این پرچم در خط فرمان مشخص نشود، مقدار پیش‌فرض آن به سیستم‌عاملی که rclone در آن اجرا می‌شود بستگی دارد:
در Windows و macOS برابر \[dq]true\[dq]، و در غیر این صورت \[dq]false\[dq].
اگر پرچم بدون مقدار ارائه شود، برابر \[dq]true\[dq] خواهد بود.
.PP
پرچم \f[V]--no-unicode-normalization\f[R] کنترل می‌کند که آیا «تصحیح» مشابهی
برای نام‌فایل‌هایی که متفاوت هستند اما از دیدگاه یونیکد هم‌ارزی استاندارد
دارند (<https://en.wikipedia.org/wiki/Unicode_equivalence>)، انجام شود یا خیر.
نرمال‌سازی یونیکد می‌تواند به‌ویژه برای کاربران macOS مفید باشد؛
چرا که این سیستم‌عامل به جای NFC که در بیشتر پلتفرم‌های دیگر استفاده می‌شود، فرم NFD را ترجیح می‌دهد.
بنابراین اکیداً توصیه می‌شود که در macOS مقدار پیش‌فرض
\f[V]false\f[R] حفظ شود تا از مشکلات سازگاری کدگذاری جلوگیری گردد.
.PP
در صورت پیشامد (احتمالاً نادر) که یک دایرکتوری پس از اعمال نرمال‌سازی حالت حروف و یونیکد،
چندین نام فایل تکراری داشته باشد، پرچم \f[V]--vfs-block-norm-dupes\f[R] امکان پنهان کردن این موارد تکراری را فراهم می‌کند.
این کار با یک مصالحه کارایی (کاهش عملکرد) همراه است، زیرا rclone هنگام فهرست کردن یک دایرکتوری باید
کل دایرکتوری را برای یافتن موارد تکراری پویش کند.
به همین دلیل، توصیه می‌شود در صورت عدم نیاز، این گزینه غیرفعال بماند.
با این حال، کاربران macOS ممکن است استفاده از آن را در نظر بگیرند، زیرا در غیر این صورت اگر یک
دایرکتوری در remote شامل هر دو نسخهٔ NFC و NFD از یک نام فایل یکسان باشد،
وضعیتی نامتعارف رخ خواهد داد: هر دو نسخهٔ فایل در نقطهٔ متصل‌شده (mount) قابل مشاهده خواهند بود و
هر دو به نظر قابل ویرایش می‌آیند، اما در عمل ویرایش هر کدام از نسخه‌ها
در پس‌زمینه تنها منجر به ویرایش نسخهٔ NFD می‌شود.
پرچم \f[V]--vfs-block-norm-dupes\f[R] با شناسایی این وضعیت، پنهان کردن موارد تکراری
و ثبت یک خطا در گزارش‌ها (مشابه روش مدیریت این موضوع در \f[V]rclone sync\f[R])، از این سردرگمی جلوگیری می‌کند..SS گزینه‌های دیسک VFS
.PP
این پرچم به شما امکان می‌دهد آمار مربوط به سیستم فایل را به صورت دستی
تنظیم کنید.
زمانی که این آمار به درستی و به صورت خودکار خوانده نمی‌شوند، می‌تواند
مفید باشد.
.IP
.nf
\f[C]
    --vfs-disk-space-total-size    تنظیم دستی اندازه کل فضای دیسک (مثال: 256G، پیش‌فرض: -1)
\f[R]
.fi
.SS گزارش جایگزین بایت‌های مصرف‌شده
.PP
برخی از بک‌اندها، به‌ویژه S3، مقدار بایت‌های مصرف‌شده را گزارش نمی‌کنند.
اگر نیاز دارید این اطلاعات هنگام اجرای \f[V]df\f[R] روی سیستم فایل در
دسترس باشد، پرچم \f[V]--vfs-used-is-size\f[R] را به rclone ارسال کنید.
با تنظیم این پرچم، rclone به جای اتکا به بک‌اند برای گزارش این اطلاعات،
تمام ریموت را شبیه به \f[V]rclone size\f[R] پویش کرده و کل فضای استفاده‌شده
را خودش محاسبه می‌کند.
.PP
\f[B]هشدار\f[R]: برخلاف \f[V]rclone size\f[R]، این پرچم فیلترها را نادیده
می‌گیرد تا نتیجه دقیق باشد.
با این حال، این کار بسیار ناکارآمد است و ممکن است باعث تعداد زیادی
فراخوانی API و در نتیجه هزینه‌های اضافی شود.
از آن تنها به عنوان آخرین راه‌حل و فقط همراه با کش‌کردن (caching) استفاده
کنید.
.SS فراداده VFS
.PP
اگر از پرچم \f[V]--vfs-metadata-extension\f[R] استفاده کنید، می‌توانید VFS
را طوری تنظیم کنید فایل‌هایی را که حاوی فراداده هستند
(<https://rclone.org/docs/#metadata>) به صورت یک داده چندبخشی JSON ارائه دهد.
این فایل‌ها در فهرست دایرکتوری ظاهر نخواهند شد، اما می‌توان روی آن‌ها
\f[V]stat\f[R] اجرا کرد و آن‌ها را باز نمود و پس از باز شدن، تا زمانی که کش
دایرکتوری منقضی شود در فهرست‌های دایرکتوری ظاهر \f[B]خواهند شد\f[R].
.PP
توجه داشته باشید که برخی از بک‌اندها فراداده ایجاد نمی‌کنند مگر اینکه پرچم
\f[V]--metadata\f[R] را ارسال کرده باشید.
.PP
به عنوان مثال، با استفاده از \f[V]rclone mount\f[R] همراه با
\f[V]--metadata --vfs-metadata-extension .metadata\f[R] خروجی زیر را خواهیم داشت:
.IP
.nf
\f[C]
$ ls -l /mnt/
total 1048577
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G

$ cat /mnt/1G.metadata
{
        \[dq]atime\[dq]: \[dq]2025-03-04T17:34:22.317069787Z\[dq],
        \[dq]btime\[dq]: \[dq]2025-03-03T16:03:37.708253808Z\[dq],
        \[dq]gid\[dq]: \[dq]1000\[dq],
        \[dq]mode\[dq]: \[dq]100664\[dq],
        \[dq]mtime\[dq]: \[dq]2025-03-03T16:03:39.640238323Z\[dq],
        \[dq]uid\[dq]: \[dq]1000\[dq]
}

$ ls -l /mnt/
total 1048578
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G
-rw-rw-r-- 1 user user        185 Mar  3 16:03 1G.metadata
\f[R]
.fi
.PP
اگر فایل فاقد فراداده باشد به صورت \f[V]{}\f[R] بازگردانده می‌شود و در صورت
بروز خطا در خواندن فراداده، خطا به صورت
\f[V]{\[dq]error\[dq]:\[dq]error string\[dq]}\f[R] برگردانده خواهد شد.
.SS پروکسی احراز هویت (Auth Proxy)
.PP
اگر پارامتر \f[V]--auth-proxy /path/to/program\f[R] را مشخص کنید، rclone از
آن برنامه برای ایجاد آنی (on the fly) بک‌اندها استفاده می‌کند که سپس برای
احراز هویت درخواست‌های ورودی به کار می‌روند.
این سازوکار از یک پروتکل ساده مبتنی بر JSON با ورودی روی STDIN و خروجی روی
STDOUT استفاده می‌کند.
.PP
\f[B]لطفاً توجه داشته باشید:\f[R] گزینه‌های \f[V]--auth-proxy\f[R] و
\f[V]--authorized-keys\f[R] نمی‌توانند هم‌زمان استفاده شوند؛ اگر
\f[V]--auth-proxy\f[R] تنظیم شده باشد، گزینه کلیدهای مجاز (authorized keys)
نادیده گرفته خواهد شد.
.PP
یک برنامه نمونه در مسیر
bin/test_proxy.py (<https://github.com/rclone/rclone/blob/master/bin/test_proxy.py>)
در کد منبع rclone وجود دارد.
.PP
وظیفه برنامه دریافت یک \f[V]user\f[R] و \f[V]pass\f[R] در ورودی و تبدیل آن‌ها
به پیکربندی یک بک‌اند روی STDOUT در قالب JSON است.
این پیکربندی شامل تمام پارامترهای پیش‌فرض اضافه شده برای بک‌اند خواهد بود،
اما از پیکربندی متغیرهای محیطی یا گزینه‌های خط فرمان استفاده نخواهد کرد \-
آماده‌سازی یک پیکربندی کامل بر عهده برنامه پروکسی است.
.PP
این پیکربندی تولیدشده باید این پارامتر اضافی را داشته باشد:
.IP \[bu] 2
\f[V]_root\f[R] \- ریشه (root) مورد استفاده برای بک‌اند
.PP
و می‌تواند این پارامترها را نیز داشته باشد:
.IP \[bu] 2
\f[V]_obscure\f[R] \- رشته‌های جداشده با کاما برای پارامترهایی که باید مبهم‌سازی شوند
.IP \[bu] 2
\f[V]_secret_access_key\f[R] \- کلید مخفی برای احراز هویت کلید دسترسی S3 (پایین را ببینید)
.PP
اگر از احراز هویت با گذرواژه توسط کلاینت استفاده شده باشد، ورودی به فرایند
پروکسی (روی STDIN) شبیه به این خواهد بود:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]pass\[dq]: \[dq]mypassword\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
اگر از احراز هویت با کلید عمومی توسط کلاینت استفاده شده باشد، ورودی به فرایند
پروکسی (روی STDIN) شبیه به این خواهد بود:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]public_key\[dq]: \[dq]AAAAB3NzaC1yc2EAAAADAQABAAABAQDuwESFdAe14hVS6omeyX7edc...JQdf\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
اگر کلاینت با یک کلید دسترسی S3 احراز هویت کند
(\f[V]rclone serve s3\f[R])، کلاینت هرگز کلید مخفی (secret) خود را ارسال
نمی‌کند، بلکه تنها امضای ایجادشده با آن را می‌فرستد؛ بنابراین ورودی فقط شامل
شناسه کلید دسترسی به عنوان \f[V]user\f[R] بدون هیچ‌گونه \f[V]pass\f[R] یا
\f[V]public_key\f[R] خواهد بود:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]AKIAIOSFODNN7EXAMPLE\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
در این حالت، برنامه باید کلید دسترسی مخفی را برای آن شناسه کلید دسترسی
جستجو کرده و آن را در فیلد \f[V]_secret_access_key\f[R] در خروجی بازگرداند.
سپس Rclone از آن کلید مخفی برای بررسی امضای روی درخواست استفاده می‌کند و در
صورت عدم تطابق، درخواست را رد می‌نماید.
این بدان معناست که برنامه پروکسی منبع معتبر (source of truth) هم برای
اطلاعات احراز هویت و هم برای بک‌اَندی است که به آن نگاشت می‌شوند.
اگر برنامه فیلد \f[V]_secret_access_key\f[R] را بازنگرداند یا آن را خالی
برگرداند، درخواست رد می‌شود.
.PP
پاسخ برنامه برای یک شناسه کلید دسترسی کش می‌شود (پایین را ببینید)، اما حتی
اگر شناسه کلید دسترسی در حال استفاده مداوم باشد، پس از ۵ دقیقه مجدداً با
برنامه بررسی می‌شود؛ بنابراین باطل کردن یک شناسه کلید دسترسی در برنامه ظرف ۵
دقیقه اعمال خواهد شد.
کلید مخفی جایگزین‌شده (rotated secret) در اولین درخواستی که با آن امضا شود
اعمال می‌گردد.
.PP
کلید \f[V]client_ip\f[R] شامل آدرس IP است که کلاینت از طریق آن متصل شده
است (بدون شماره پورت).
این کلید می‌تواند برای محدود کردن ورودها به شبکه‌های خاص یا ثبت مرکزی
تلاش‌های احراز هویت استفاده شود.
اگر کلاینت فاقد آدرس IP باشد، برای مثال هنگام اتصال از طریق سوکت یونیکس
(unix socket)، این کلید حذف می‌شود.
توجه داشته باشید که اگر rclone پشت یک پروکسی معکوس (reverse proxy) باشد، این
آدرس، آدرس پروکسی معکوس خواهد بود نه کلاینت اصلی.
.PP
و به عنوان یک مثال، این را روی STDOUT بازمی‌گرداند:
.IP
.nf
\f[C]
{
  \[dq]type\[dq]: \[dq]sftp\[dq],
  \[dq]_root\[dq]: \[dq]\[dq],
  \[dq]_obscure\[dq]: \[dq]pass\[dq],
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]pass\[dq]: \[dq]mypassword\[dq],
  \[dq]host\[dq]: \[dq]sftp.example.com\[dq]
}
\f[R]
.fi.PP
این بدان معنا خواهد بود که یک backend برای SFTP به‌صورت درلحظه برای \f[V]user\f[R] و \f[V]pass\f[R]/\f[V]public_key\f[R] بازگردانده‌شده در خروجی برای میزبان مشخص‌شده، ایجاد می‌شود.
توجه داشته باشید از آنجا که \f[V]_obscure\f[R] روی \f[V]pass\f[R] تنظیم شده است، rclone پارامتر \f[V]pass\f[R] را پیش از ایجاد backend مبهم‌سازی (obscure) می‌کند (که این برای backendهای sftp الزامی است).
.PP
برنامه می‌تواند \f[V]user\f[R] ارائه‌شده را به هر روشی دستکاری کند؛ برای نمونه، جهت ایجاد پراکسی به چندین backend مختلف sftp، می‌توانید \f[V]user\f[R] را برابر با \f[V]user\[at]example.com\f[R] قرار دهید و سپس در خروجی، \f[V]host\f[R] را روی \f[V]example.com\f[R] و کاربر را روی \f[V]user\f[R] تنظیم کنید.
به دلایل امنیتی، احتمالاً مایل خواهید بود که \f[V]host\f[R] را به یک فهرست محدود مقید کنید.
.PP
یک حافظهٔ موقت (کَش) داخلی از backendها بر اساس \f[V]user\f[R]، هشِ \f[V]pass\f[R] یا \f[V]public_key\f[R]، و \f[V]client_ip\f[R] کلیدگذاری می‌شود.
این بدان معناست که اگر گذرواژه یا کلید عمومی کاربر تغییر کند، کلاینت از یک نشانی IP جدید متصل شود، یا پراکسی پارامترهای پیکربندی متفاوتی را برگرداند (برای نمونه یک \f[V]api_key\f[R] دوره‌گردش‌شده)، در درخواست بعدی به جای استفادهٔ مجدد از مورد کَش‌شده، یک backend تازه ایجاد خواهد شد.
.PP
این قابلیت می‌تواند برای ساخت پراکسی‌های همه‌منظوره برای هر نوع backend که rclone پشتیبانی می‌کند، استفاده شود.
.IP
.nf
\f[C]
rclone serve ftp remote:path [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --addr string                            IPaddress:Port یا :Port برای مقید کردن کارساز به آن (پیش‌فرض \[dq]localhost:2121\[dq])
      --auth-proxy string                      برنامه‌ای برای استفاده جهت ایجاد backend از احراز هویت
      --cert string                            کلید TLS PEM (ترکیب گواهی و گواهی CA)
      --dir-cache-time Duration                مدت‌زمان نگهداری مدخل‌های دایرکتوری در حافظهٔ موقت (پیش‌فرض 5m0s)
      --dir-perms FileMode                     مجوزهای دایرکتوری (پیش‌فرض 777)
      --file-perms FileMode                    مجوزهای فایل (پیش‌فرض 666)
      --gid uint32                             بازنویسی فیلد gid تنظیم‌شده توسط سامانه فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1000)
  -h, --help                                   راهنمای ftp
      --key string                             کلید خصوصی TLS PEM
      --link-perms FileMode                    مجوزهای پیوند (پیش‌فرض 666)
      --no-checksum                            عدم مقایسهٔ چکسام‌ها هنگام بارگذاری/بارگیری
      --no-modtime                             عدم خواندن/نوشتن زمان تغییر (می‌تواند سرعت را افزایش دهد)
      --no-seek                                عدم اجازهٔ تغییر موقعیت (seek) در فایل‌ها
      --pass string                            گذرواژه برای احراز هویت (مقدار خالی اجازهٔ هر گذرواژه‌ای را می‌دهد)
      --passive-port string                    محدودهٔ درگاه غیرفعال (passive) مورد استفاده (پیش‌فرض \[dq]30000-32000\[dq])
      --poll-interval Duration                 زمان انتظار بین بررسی دوره‌ای برای تغییرات؛ باید کوچک‌تر از dir-cache-time باشد و فقط روی ریموت‌های پشتیبانی‌شده عمل می‌کند (0 برای غیرفعال‌سازی) (پیش‌فرض 1m0s)
      --public-ip string                       نشانی IP عمومی برای اعلان به اتصالات passive
      --read-only                              تنها اجازهٔ دسترسی فقط‌خواندنی داده شود
      --uid uint32                             بازنویسی فیلد uid تنظیم‌شده توسط سامانه فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1000)
      --umask FileMode                         بازنویسی بیت‌های مجوز تنظیم‌شده توسط سامانه فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 002)
      --user string                            نام کاربری برای احراز هویت (پیش‌فرض \[dq]anonymous\[dq])
      --vfs-block-norm-dupes                   در صورت وجود نام‌های فایل تکراری در همان دایرکتوری (پس از یکسان‌سازی)، خطایی ثبت شده و موارد تکراری پنهان می‌شوند (ممکن است بر کارایی تأثیر بگذارد)
      --vfs-cache-max-age Duration             حداکثر زمان از آخرین دسترسی به اشیاء موجود در حافظهٔ موقت (پیش‌فرض 1h0m0s)
      --vfs-cache-max-size SizeSuffix          حداکثر اندازهٔ کل اشیاء موجود در حافظهٔ موقت (پیش‌فرض off)
      --vfs-cache-min-free-space SizeSuffix    هدف حداقل فضای خالی روی دیسک حاوی حافظهٔ موقت (پیش‌فرض off)
      --vfs-cache-mode CacheMode               حالت حافظهٔ موقت off|minimal|writes|full (پیش‌فرض off)
      --vfs-cache-poll-interval Duration       بازهٔ زمانی بررسی حافظهٔ موقت برای یافتن اشیاء بی‌استفاده (پیش‌فرض 1m0s)
      --vfs-case-insensitive                   در صورت پیدا نشدن نام فایل، تطابق غیرحساس به بزرگی و کوچکی حروف انجام شود
      --vfs-disk-space-total-size SizeSuffix   مشخص کردن کل فضای دیسک (پیش‌فرض off)
      --vfs-fast-fingerprint                   استفاده از اثرانگشت‌های سریع (با دقت کمتر) برای تشخیص تغییرات
      --vfs-handle-caching Duration            مدت‌زمان زنده نگه‌داشتن دستگیرهٔ فایل و بارگیری‌کننده‌ها پس از آخرین بسته‌شدن (پیش‌فرض 5s)
      --vfs-links                              تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
      --vfs-metadata-extension string          تنظیم پسوند برای خواندن فراداده از آن
      --vfs-read-ahead SizeSuffix              پیش‌خوانی اضافی فراتر از --buffer-size در هنگام استفاده از cache-mode full
      --vfs-read-chunk-size SizeSuffix         خواندن اشیاء مبدأ به‌صورت تکه‌ای (پیش‌فرض 128Mi)
      --vfs-read-chunk-size-limit SizeSuffix   در صورت بزرگ‌تر بودن از --vfs-read-chunk-size، پس از هر بار خواندن تکه، اندازهٔ تکه دو برابر می‌شود تا به حد مجاز برسد (\[aq]off\[aq] نامحدود است) (پیش‌فرض off)
      --vfs-read-chunk-streams int             تعداد جریان‌های موازی برای خواندن هم‌زمان
      --vfs-read-wait Duration                 مدت‌زمان انتظار برای خواندن ترتیبی قبل از seek (پیش‌فرض 20ms)
      --vfs-refresh                            تازه‌سازی بازگشتی حافظهٔ موقت دایرکتوری در پس‌زمینه هنگام شروع
      --vfs-used-is-size rclone size           استفاده از الگوریتم rclone size برای محاسبهٔ اندازهٔ مصرف‌شده
      --vfs-write-back Duration                مدت‌زمان بازنویسی فایل‌ها (writeback) پس از آخرین استفاده در هنگام استفاده از کَش (پیش‌فرض 5s)
      --vfs-write-wait Duration                مدت‌زمان انتظار برای نوشتن ترتیبی پیش از اعلام خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (<https://rclone.org/flags>) را ببینید..SS گزینه‌های فیلتر (Filter Options)
.PP
پرچم‌ها برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های مستثنی‌شده از همگام‌سازی در مقصد
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از \- برای stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام فایل‌های مبدأ از فایل (استفاده از \- برای stdin)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از فایل بدون پردازش خطوط (استفاده از \- برای stdin)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ با استفاده از NUL به‌عنوان جداکننده (استفاده از \- برای stdin)
  -f, --filter stringArray                  افزودن یک قاعده فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (استفاده از \- برای stdin)
      --hash-filter string                  افراز نام فایل‌ها با هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از \- برای stdin)
      --max-age Duration                    تنها انتقال فایل‌های جدیدتر از این مقدار برحسب s یا پسوندهای ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تعیین، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض \-1)
      --max-size SizeSuffix                 تنها انتقال فایل‌های کوچک‌تر از این مقدار برحسب KiB یا پسوندهای B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (استفاده از \- برای stdin)
      --metadata-filter stringArray         افزودن یک قاعده فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متاداده از یک فایل (استفاده از \- برای stdin)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از فایل (استفاده از \- برای stdin)
      --min-age Duration                    تنها انتقال فایل‌های قدیمی‌تر از این مقدار برحسب s یا پسوندهای ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 تنها انتقال فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا پسوندهای B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone serve (https://rclone.org/commands/rclone_serve) \- ارائه یک
ریموت روی یک پروتکل.
.SH rclone serve http
.PP
ارائه ریموت از طریق HTTP.
.SS خلاصه دستور (SYNOPSIS)
.PP
اجرای یک وب‌سرور پایه‌ای برای ارائه یک ریموت از طریق HTTP.
این خروجی را می‌توان در یک مرورگر وب مشاهده کرد، یا می‌توانید یک ریموت از نوع
http بسازید تا از آن بخواند.
.PP
می‌توانید از پرچم‌های فیلتر (مانند
\f[V]--include\f[R]، \f[V]--exclude\f[R]) برای کنترل مواردی که ارائه می‌شوند استفاده کنید.
.PP
سرور خطاها را ثبت خواهد کرد (لاگ می‌کند).
برای مشاهده گزارش‌های دسترسی از \f[V]-v\f[R] استفاده کنید.
.PP
گزینه \f[V]--bwlimit\f[R] برای انتقال فایل‌ها رعایت خواهد شد.
از \f[V]--stats\f[R] برای کنترل چاپ آمار استفاده کنید.
.SS گزینه‌های سرور (Server options)
.PP
از \f[V]--addr\f[R] برای مشخص کردن آدرس IP و درگاهی (پورت) که سرور باید روی آن گوش دهد استفاده کنید؛ مانند \f[V]--addr 1.2.3.4:8000\f[R] یا
\f[V]--addr :8080\f[R] برای گوش دادن روی تمام IPها.
به‌طور پیش‌فرض تنها روی localhost گوش می‌دهد.
می‌توانید از درگاه :0 استفاده کنید تا سیستم‌عامل یک درگاه در دسترس را انتخاب کند.
.PP
اگر \f[V]--addr\f[R] را برای گوش دادن روی یک IP عمومی یا در دسترس در شبکه محلی (LAN) تنظیم کنید، استفاده از احراز هویت (Authentication) توصیه می‌شود \- برای اطلاعات بیشتر بخش بعدی را ببینید.
.PP
می‌توانید با تنظیم url روی
\f[V]unix:///path/to/socket\f[R] یا صرفاً با استفاده از یک مسیر مطلق، از سوکت یونیکس استفاده کنید.
.PP
پرچم \f[V]--addr\f[R] می‌تواند برای گوش دادن روی چندین
IP/درگاه/سوکت تکرار شود.
همچنین فعال‌سازی از طریق سوکت (Socket activation) که در ادامه توضیح داده شده، می‌تواند برای دستیابی به همین هدف استفاده شود.
.PP
می‌توان از \f[V]--server-read-timeout\f[R] و \f[V]--server-write-timeout\f[R] برای
کنترل مهلت‌های زمانی (timeouts) روی سرور استفاده کرد.
توجه داشته باشید که این مقدار، کل زمان انتقال است.
.PP
گزینه \f[V]--max-header-bytes\f[R] حداکثر تعداد بایت‌هایی را که سرور در هدر HTTP می‌پذیرد کنترل می‌کند.
.PP
می‌توان از \f[V]--response-header\f[R] برای تنظیم یک هدر HTTP در تمام
پاسخ‌ها استفاده کرد که مقادیر موجود را بازنویسی خواهد کرد.
این پرچم می‌تواند برای افزودن چندین هدر تکرار شود.
از قالب \f[V]Header-Name: value\f[R] استفاده کنید.
.PP
گزینه \f[V]--baseurl\f[R] پیشوند URLای را که rclone از آن خدمات می‌دهد کنترل می‌کند.
به‌طور پیش‌فرض rclone از ریشه (root) ارائه می‌دهد.
اگر از \f[V]--baseurl \[dq]/rclone\[dq]\f[R] استفاده کنید، آن‌گاه rclone از
یک URL که با \[dq]/rclone/\[dq] شروع می‌شود ارائه خواهد داد.
این گزینه زمانی مفید است که بخواهید rclone serve را پراکسی کنید.
برنامه rclone به‌طور خودکار کاراکترهای \[dq]/\[dq] ابتدا و انتها را روی
\f[V]--baseurl\f[R] درج می‌کند؛ بنابراین \f[V]--baseurl \[dq]rclone\[dq]\f[R]،
\f[V]--baseurl \[dq]/rclone\[dq]\f[R] و
\f[V]--baseurl \[dq]/rclone/\[dq]\f[R] همگی یکسان در نظر گرفته می‌شوند.
.PP
می‌توان \f[V]--disable-zip\f[R] را برای غیرفعال کردن قابلیت دانلود فشرده (zip)
تنظیم کرد..SS "پروتکل (Protocol)"
.PP
سرور از HTTP/1.1 و HTTP/2 پشتیبانی می‌کند.
HTTP/2 به‌طور خودکار برای اتصال‌های TLS استفاده می‌شود.
برای اتصال‌های غیر TLS، متن سادهٔ HTTP/2 (h2c) پشتیبانی می‌شود که استفاده از
HTTP/2 بدون رمزنگاری را ممکن می‌سازد.
.SS "TLS (SSL)"
.PP
به‌طور پیش‌فرض، ارائهٔ سرویس بر بستر http خواهد بود.
در صورت تمایل می‌توانید بر بستر https سرویس‌دهی کنید.
برای این کار لازم است پرچم‌های \f[V]--cert\f[R] و \f[V]--key\f[R] را مشخص کنید.
اگر مایل به اعتبارسنجی گواهی در سمت کلاینت هستید، باید
\f[V]--client-ca\f[R] را نیز فراهم کنید.
.PP
هنگامی که TLS پیکربندی شود، هر شنونده‌ای که با \f[V]--addr\f[R] مشخص شده باشد با
TLS سرویس می‌دهد.
یک شنونده می‌تواند پیشوند \f[V]http://\f[R] داشته باشد تا HTTP رمزنگاری‌نشده
را روی آن نشانی ارائه دهد، یا دارای پیشوند \f[V]tls://\f[R] باشد تا
صراحتاً مشخص شود باید TLS ارائه دهد.
استفاده از نشانی \f[V]tls://\f[R] بدون \f[V]--cert\f[R] و
\f[V]--key\f[R] یک خطا است.
.PP
\f[V]--cert\f[R] باید روی مسیر فایلی تنظیم شود که حاوی یک گواهی با
کدگذاری PEM، یا ترکیبی از آن با گواهی CA باشد.
\f[V]--key\f[R] باید روی مسیر فایلی حاوی کلید خصوصی با کدگذاری
PEM تنظیم شود.
در صورت تنظیم \f[V]--client-ca\f[R]، این گزینه باید روی مسیر فایلی
حاوی گواهی‌های مرجع صدور گواهی کلاینت با کدگذاری PEM تنظیم شود.
.PP
\f[V]--min-tls-version\f[R] کمترین نسخهٔ قابل قبول TLS است.
مقدارهای معتبر عبارتند از \[dq]tls1.0\[dq]، \[dq]tls1.1\[dq]، \[dq]tls1.2\[dq]
و \[dq]tls1.3\[dq] (پیش‌فرض: \[dq]tls1.0\[dq]).
.SS "فعال‌سازی از طریق سوکت (Socket activation)"
.PP
به‌جای نشانی‌های شنود مشخص‌شده در بالا، rclone به تمام FDهای ارسال‌شده
توسط مدیر سرویس (در صورت وجود) گوش فرا خواهد داد (و هرگونه آرگومان
ارسال‌شده با \f[V]--addr\f[R] را نادیده می‌گیرد).
.PP
این قابلیت اجازه می‌دهد rclone یک سرویس فعال‌شونده از طریق سوکت باشد.
می‌توان آن را با فایل‌های واحد (unit) از نوع .socket و .service همان‌طور که در
<https://www.freedesktop.org/software/systemd/man/latest/systemd.socket.html>
شرح داده شده است پیکربندی کرد.
.PP
فعال‌سازی از طریق سوکت را می‌توان به‌طور موقت با دستور
\f[V]systemd-socket-activate\f[R] آزمایش کرد:
.IP
.nf
\f[C]
systemd-socket-activate -l 8000 -- rclone serve
\f[R]
.fi
.PP
این کار، rclone را در اولین اتصال به درگاه 8000 بر بستر TCP فعال می‌کند.
.SS "قالب (Template)"
.PP
\f[V]--template\f[R] به کاربر امکان می‌دهد تا یک قالب نشانه‌گذاری سفارشی را
برای عملکردهای سرویس‌دهی HTTP و WebDAV تعیین کند.
سرور نشانه‌گذاری‌های زیر را صادر می‌کند تا بتوان از آن‌ها درون قالب
برای ارائهٔ صفحات استفاده کرد:
.PP
.TS
tab(@);
lw(22.6n) lw(24.7n) lw(22.6n).
T{
پارامتر
T}@T{
زیرپارامتر
T}@T{
توضیحات
T}
_
T{
\&.Name
T}@T{
T}@T{
مسیر کامل یک فایل/دایرکتوری.
T}
T{
\&.Title
T}@T{
T}@T{
فهرست دایرکتوری مربوط به \[aq].Name\[aq].
T}
T{
\&.Sort
T}@T{
T}@T{
مرتب‌سازی فعلی مورد استفاده.
این مقدار از طریق پارامتر \[aq]?sort=\[aq] قابل تغییر است.
مقدارهای ممکن: namedirfirst، name، size، time (پیش‌فرض: namedirfirst).
T}
T{
\&.Order
T}@T{
T}@T{
ترتیب فعلی مورد استفاده.
این مقدار از طریق پارامتر \[aq]?order=\[aq] قابل تغییر است.
مقدارهای ممکن: asc، desc (پیش‌فرض: asc).
T}
T{
\&.Query
T}@T{
T}@T{
در حال حاضر بدون استفاده است.
T}
T{
\&.Breadcrumb
T}@T{
T}@T{
امکان ایجاد ناوبری نسبی را فراهم می‌کند.
T}
T{
T}@T{
\&.Link
T}@T{
پیوند مربوط به Text نسبت به ریشه.
T}
T{
T}@T{
\&.Text
T}@T{
نام دایرکتوری.
T}
T{
\&.Entries
T}@T{
T}@T{
اطلاعات دربارهٔ یک فایل/دایرکتوری خاص.
T}
T{
T}@T{
\&.URL
T}@T{
نشانی (URL) یک مدخل.
T}
T{
T}@T{
\&.Leaf
T}@T{
در حال حاضر همانند \[aq].URL\[aq] است، اما در نظر است که فقط نام باشد.
T}
T{
T}@T{
\&.IsDir
T}@T{
مقدار بولی که مشخص می‌کند آیا یک مدخل دایرکتوری است یا خیر.
T}
T{
T}@T{
\&.Size
T}@T{
اندازهٔ مدخل بر حسب بایت.
T}
T{
T}@T{
\&.ModTime
T}@T{
مهر زمانی UTC مربوط به یک مدخل.
T}
.TE
.PP
سرور همچنین توابع زیر را در دسترس قرار می‌دهد تا بتوان از آن‌ها
درون قالب استفاده کرد.
این توابع به گسترش گزینه‌ها برای رندر پویای HTML کمک می‌کنند.
می‌توان از آن‌ها برای رندر کردن HTML بر اساس شرایط خاص بهره برد.
.PP
.TS
tab(@);
lw(35.0n) lw(35.0n).
T{
تابع
T}@T{
توضیحات
T}
_
T{
afterEpoch
T}@T{
زمان سپری‌شده از مبدأ زمانی (epoch) را برای زمان مشخص‌شده برمی‌گرداند.
T}
T{
contains
T}@T{
بررسی می‌کند که آیا زیررشتهٔ داده‌شده در رشتهٔ مشخص‌شده وجود دارد یا خیر.
T}
T{
hasPrefix
T}@T{
بررسی می‌کند که آیا رشتهٔ مشخص‌شده با پیشوند تعیین‌شده آغاز می‌شود یا خیر.
T}
T{
hasSuffix
T}@T{
بررسی می‌کند که آیا رشتهٔ مشخص‌شده با پسوند تعیین‌شده پایان می‌یابد یا خیر.
T}
.TE.SS احراز هویت (Authentication)
.PP
به‌طور پیش‌فرض، این دستور فایل‌ها را بدون نیاز به ورود ارائه می‌دهد.
.PP
می‌توانید از یک فایل htpasswd استفاده کنید که از کاربران زیادی پشتیبانی می‌کند، یا با پرچم‌های
\f[V]--user\f[R] و \f[V]--pass\f[R] یک نام‌کاربری و گذرواژه منفرد تعیین نمایید.
.PP
همچنین، می‌توانید مدیریت احراز هویت را به پراکسی معکوس (reverse proxy) بسپارید و با
\f[V]--user-from-header\f[R] از نام‌کاربری ارائه‌شده در سربرگ پیکربندی‌شده استفاده کنید (مانند
\f[V]--user-from-header=x-remote-user\f[R]).
اطمینان حاصل کنید که پراکسی مورد اعتماد است و سربرگ‌ها قابل جعل نیستند، زیرا پیکربندی نادرست می‌تواند منجر به دسترسی غیرمجاز شود.
.PP
اگر هیچ‌کدام از روش‌های احراز هویت بالا پیکربندی نشده باشند و گواهی‌های کلاینت از طریق پرچم
\f[V]--client-ca\f[R] ارسال‌شده به سرور الزامی شده باشند، نام مشترک (common name) گواهی کلاینت به‌عنوان نام‌کاربری در نظر گرفته خواهد شد.
.PP
برای ارائه فایل htpasswd از \f[V]--htpasswd /path/to/htpasswd\f[R] استفاده کنید.
این فایل در قالب استاندارد آپاچی است و از الگوریتم‌های MD5، SHA1 و BCrypt برای احراز هویت پایه‌ای (basic authentication) پشتیبانی می‌کند.
استفاده از Bcrypt توصیه می‌شود.
.PP
برای ایجاد یک فایل htpasswd:
.IP
.nf
\f[C]
touch htpasswd
htpasswd -B htpasswd user
htpasswd -B htpasswd anotherUser
\f[R]
.fi
.PP
فایل گذرواژه را می‌توان در حین اجرای rclone به‌روزرسانی کرد.
.PP
برای تنظیم قلمرو احراز هویت (realm) از \f[V]--realm\f[R] استفاده کنید.
.PP
برای تغییر سالت (salt) هش گذرواژه از مقدار پیش‌فرض، از \f[V]--salt\f[R] استفاده کنید.
.SS سامانه‌فایل مجازی (VFS - Virtual File System)
.PP
این دستور از لایه VFS استفاده می‌کند.
این لایه، اشیاء فضای ذخیره‌سازی ابری که rclone از آن‌ها استفاده می‌کند را به ساختاری بسیار شبیه‌تر به سامانه‌فایل دیسک تبدیل می‌کند.
.PP
اشیاء ذخیره‌سازی ابری ویژگی‌های متعددی دارند که شبیه فایل‌های روی دیسک نیستند؛ برای نمونه نمی‌توانید آن‌ها را بسط داده یا در میانه‌شان بنویسید، بنابراین لایه VFS باید این مسائل را مدیریت کند.
از آنجا که یک راهکار واحد و مطلق برای این کار وجود ندارد، گزینه‌های گوناگونی در ادامه توضیح داده شده‌اند.
.PP
لایه VFS همچنین حافظه موقت دایرکتوری (directory cache) را پیاده‌سازی می‌کند؛ این ویژگی اطلاعات مربوط به فایل‌ها و دایرکتوری‌ها (نه خود داده‌ها) را در حافظه نگه‌داری می‌کند.
.SS حافظه موقت دایرکتوری VFS (VFS Directory Cache)
.PP
با استفاده از پرچم \f[V]--dir-cache-time\f[R] می‌توانید مشخص کنید که یک دایرکتوری چه مدت به‌روز در نظر گرفته شده و نیازی به دریافت مجدد از پشتیبان (backend) نداشته باشد.
تغییرات ایجادشده از طریق VFS بلافاصله اعمال می‌شوند یا حافظه موقت را بی‌اعتبار می‌کنند.
.IP
.nf
\f[C]
    --dir-cache-time duration   Time to cache directory entries for (default 5m0s)
    --poll-interval duration    Time to wait between polling for changes. Must be smaller than dir-cache-time. Only on supported remotes. Set to 0 to disable (default 1m0s)
\f[R]
.fi
.PP
با این حال، در صورتی که پشتیبان پیکربندی‌شده از پایش دوره‌ای (polling) برای تغییرات پشتیبانی نکند، تغییراتی که مستقیماً از طریق رابط وب یا یک نمونه دیگر از rclone در فضای ذخیره‌سازی ابری اعمال می‌شوند، تنها پس از انقضای حافظه موقت دایرکتوری اعمال خواهند شد.
اگر پشتیبان از پایش دوره‌ای پشتیبانی کند، تغییرات در بازه زمانی تعیین‌شده برای poll شناسایی می‌شوند.
.PP
می‌توانید یک سیگنال \f[V]SIGHUP\f[R] به rclone ارسال کنید تا صرف‌نظر از عمر حافظه موقت، تمامی حافظه‌های موقت دایرکتوری را تخلیه کند.
با فرض اینکه فقط یک نمونه از rclone در حال اجرا است، می‌توانید حافظه موقت را به این صورت بازنشانی کنید:
.IP
.nf
\f[C]
kill -SIGHUP $(pidof rclone)
\f[R]
.fi
.PP
اگر rclone را همراه با کنترل از راه دور پیکربندی کرده‌اید، می‌توانید از rclone rc برای تخلیه کل حافظه موقت دایرکتوری استفاده کنید:
.IP
.nf
\f[C]
rclone rc vfs/forget
\f[R]
.fi
.PP
یا برای فایل‌ها و دایرکتوری‌های مشخص:
.IP
.nf
\f[C]
rclone rc vfs/forget file=path/to/file dir=path/to/dir
\f[R]
.fi.SS بافرینگ فایل در VFS
.PP
گزینه \f[V]--buffer-size\f[R] مقدار حافظه‌ای را تعیین می‌کند که برای بافر کردن زودهنگام داده‌ها استفاده خواهد شد.
.PP
هر فایل باز همواره تلاش خواهد کرد تا مقدار مشخص‌شده از داده‌ها را در حافظه نگه دارد.
داده‌های بافرشده به یک فایل باز وابسته‌اند و به اشتراک گذاشته نخواهند شد.
.PP
این گزینه یک حد بالایی برای حافظه مصرفی به ازای هر فایل باز است.
بافر تنها برای داده‌هایی که بارگیری (دانلود) شده‌اند اما هنوز خوانده نشده‌اند از حافظه استفاده می‌کند.
اگر بافر خالی باشد، تنها مقدار کمی از حافظه استفاده خواهد شد.
.PP
حداکثر حافظه استفاده‌شده توسط rclone برای بافرینگ می‌تواند تا
\f[V]--buffer-size * open files\f[R]
باشد.
.SS کش کردن فایل در VFS
.PP
این گزینه‌ها تنظیمات کش کردن فایل در VFS را کنترل می‌کنند.
کش کردن فایل برای سازگار جلوه دادن لایه VFS با یک سیستم‌فایل عادی ضروری است.
این قابلیت را می‌توان به بهای از دست رفتن مقداری از سازگاری، غیرفعال کرد.
.PP
برای نمونه، اگر بخواهید به‌طور هم‌زمان از یک فایل بخوانید و در آن بنویسید، باید کش VFS را فعال کنید.
برای جزئیات بیشتر به ادامه مطلب مراجعه کنید.
.PP
توجه داشته باشید که کش VFS از backend کش مجزاست و ممکن است متوجه شوید که به یکی از آن‌ها یا هر دو نیاز دارید.
.IP
.nf
\f[C]
    --cache-dir string                     دایرکتوری مورد استفاده rclone برای کش.
    --vfs-cache-mode CacheMode             حالت کش off|minimal|writes|full (پیش‌فرض off)
    --vfs-cache-max-age duration           حداکثر زمان از آخرین دسترسی به اشیاء در کش (پیش‌فرض 1h0m0s)
    --vfs-cache-max-size SizeSuffix        حداکثر اندازه کل اشیاء در کش (پیش‌فرض off)
    --vfs-cache-min-free-space SizeSuffix  حداقل فضای خالی هدف در دیسک حاوی کش (پیش‌فرض off)
    --vfs-cache-poll-interval duration     فاصله زمانی بررسی دوره‌ای کش برای اشیاء قدیمی (پیش‌فرض 1m0s)
    --vfs-write-back duration              زمان بازنویسی فایل‌ها پس از آخرین استفاده هنگام به‌کارگیری کش (پیش‌فرض 5s)
\f[R]
.fi
.PP
در صورت اجرا با \f[V]-vv\f[R]، دستور rclone مکان کش فایل را چاپ خواهد کرد.
فایل‌ها در ناحیه فایل‌های کش کاربر که وابسته به سیستم‌عامل است ذخیره می‌شوند، اما می‌توان آن را با \f[V]--cache-dir\f[R] یا تنظیم متغیر محیطی مربوطه کنترل کرد.
.PP
کش دارای ۴ حالت مختلف است که توسط \f[V]--vfs-cache-mode\f[R] انتخاب می‌شوند.
هرچه حالت کش بالاتر باشد، rclone به بهای مصرف فضای دیسک، سازگارتر می‌شود.
.PP
توجه داشته باشید که فایل‌ها تنها زمانی به ریموت بازنویسی (write back) می‌شوند که بسته شده باشند و به مدت \f[V]--vfs-write-back\f[R] ثانیه مورد دسترسی قرار نگرفته باشند.
اگر rclone بسته شود یا متوقف گردد در حالی که فایل‌هایی هنوز بارگذاری نشده‌اند، این فایل‌ها در اجرای بعدی rclone با همان گزینه‌ها بارگذاری خواهند شد.
.PP
در صورت استفاده از \f[V]--vfs-cache-max-size\f[R] یا
\f[V]--vfs-cache-min-free-space\f[R] توجه داشته باشید که کش ممکن است به دو دلیل از این سهمیه‌ها فراتر رود:
نخست، زیرا بررسی آن تنها در هر \f[V]--vfs-cache-poll-interval\f[R] انجام می‌شود.
دوم، زیرا فایل‌های باز را نمی‌توان از کش بیرون راند (evict کرد).
هنگامی که محدودیت \f[V]--vfs-cache-max-size\f[R] یا
\f[V]--vfs-cache-min-free-space\f[R] رد شود، rclone ابتدا تلاش خواهد کرد فایل‌هایی را که کمترین دسترسی را داشته‌اند از کش خارج کند.
دستور rclone از فایل‌هایی آغاز خواهد کرد که برای طولانی‌ترین مدت مورد دسترسی قرار نگرفته‌اند.
این راهبرد تخلیه کش کارآمد است و فایل‌های مرتبط‌تر به احتمال بیشتری در کش باقی خواهند ماند.
.PP
گزینه \f[V]--vfs-cache-max-age\f[R] فایل‌ها را پس از سپری شدن زمان تعیین‌شده از آخرین دسترسی، از کش خارج می‌کند؛ این بر مبنای زمان دسترسی است، نه زمانی که فایل برای نخستین بار به کش افزوده شده است.
مقدار پیش‌فرض ۱ ساعت فایل‌هایی را که به مدت ۱ ساعت به آن‌ها دسترسی پیدا نشده باشد از کش خارج می‌کند.
هنگامی که به یک فایل کش‌شده دسترسی پیدا شود، تایمر ۱ ساعته به ۰ بازنشانی شده و پیش از خارج کردن، ۱ ساعت دیگر منتظر می‌ماند.
زمان را با نشانه‌گذاری استاندارد، s، m، h، d، w مشخص کنید.
.PP
اگر از \f[V]--vfs-cache-mode > off\f[R] استفاده می‌کنید، شما \f[B]نباید\f[R] دو نمونه از rclone را با استفاده از یک کش VFS یکسان همراه با ریموت‌های یکسان یا هم‌پوشان اجرا کنید.
انجام این کار بالقوه می‌تواند باعث خرابی داده‌ها شود.
می‌توانید با اختصاص سلسله‌مراتب کش مجزا به هر rclone از طریق \f[V]--cache-dir\f[R]، این مشکل را دور بزنید.
اگر ریموت‌های مورد استفاده هم‌پوشانی ندارند، نیازی به نگرانی در این مورد نیست..SS --vfs-cache-mode off
.PP
در این حالت (پیش‌فرض)، حافظه موقت (cache) مستقیماً از ریموت خوانده و مستقیماً روی ریموت می‌نویسد، بدون اینکه چیزی را روی دیسک ذخیره کند.
.PP
این بدان معناست که برخی از عملیات امکان‌پذیر نخواهند بود:
.IP \[bu] 2
فایل‌ها نمی‌توانند هم‌زمان برای هر دو حالت خواندن و نوشتن باز شوند
.IP \[bu] 2
فایل‌های باز شده برای نوشتن، قابلیت پیمایش (seek) ندارند
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید O_TRUNC در آن‌ها تنظیم شده باشد
.IP \[bu] 2
فایل‌های باز شده برای خواندن با O_TRUNC، به‌صورت فقط-نوشتنی (write only) باز خواهند شد
.IP \[bu] 2
فایل‌های باز شده فقط برای نوشتن، به‌گونه‌ای رفتار می‌کنند که گویی O_TRUNC تعیین شده است
.IP \[bu] 2
حالت‌های باز کردن O_APPEND و O_TRUNC نادیده گرفته می‌شوند
.IP \[bu] 2
در صورت شکست بارگذاری (upload)، تلاش مجدد امکان‌پذیر نخواهد بود
.SS --vfs-cache-mode minimal
.PP
این حالت بسیار شبیه به \[dq]off\[dq] است، با این تفاوت که فایل‌های باز شده برای خواندن و نوشتن روی دیسک بافر می‌شوند.
این بدان معناست که فایل‌های باز شده برای نوشتن سازگاری بسیار بیشتری خواهند داشت، اما کمترین فضا را از دیسک مصرف می‌کند.
.PP
این عملیات امکان‌پذیر نیستند:
.IP \[bu] 2
فایل‌های باز شده فقط برای نوشتن، قابلیت پیمایش (seek) ندارند
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید O_TRUNC در آن‌ها تنظیم شده باشد
.IP \[bu] 2
فایل‌های باز شده فقط برای نوشتن، O_APPEND و O_TRUNC را نادیده می‌گیرند
.IP \[bu] 2
در صورت شکست بارگذاری، تلاش مجدد امکان‌پذیر نخواهد بود
.SS --vfs-cache-mode writes
.PP
در این حالت، فایل‌های باز شده فقط برای خواندن همچنان مستقیماً از ریموت خوانده می‌شوند، اما فایل‌های فقط-نوشتنی و خواندن/نوشتن ابتدا روی دیسک بافر می‌شوند.
.PP
این حالت باید از تمامی عملیات معمول سیستم فایل پشتیبانی کند.
.PP
اگر یک بارگذاری با شکست مواجه شود، تلاش مجدد در فواصل زمانی با افزایش نمایی تا حداکثر ۱ دقیقه انجام خواهد شد.
.SS --vfs-cache-mode full
.PP
در این حالت تمامی خواندن‌ها و نوشتن‌ها به و از روی دیسک بافر می‌شوند.
هنگامی که داده‌ها از ریموت خوانده می‌شوند، آن‌ها نیز روی دیسک بافر خواهند شد.
.PP
در این حالت فایل‌های موجود در کش از نوع فایل‌های تنک (sparse files) خواهند بود و rclone ردیابی خواهد کرد که کدام بخش‌ها از فایل‌ها را دانلود کرده است.
.PP
بنابراین اگر برنامه‌ای تنها ابتدای هر فایل را بخواند، rclone فقط ابتدای فایل را بافر خواهد کرد.
این فایل‌ها در کش با اندازه کامل خود به نظر می‌رسند، اما در واقع فایل‌های تنک هستند که تنها داده‌های دانلودشده در آن‌ها وجود دارد.
.PP
این حالت باید از تمام عملیات عادی سیستم فایل پشتیبانی کند و در سایر موارد کاملاً مشابه \f[V]--vfs-cache-mode\f[R] writes عمل می‌کند.
.PP
هنگام خواندن یک فایل، rclone به اندازه \f[V]--buffer-size\f[R] به‌علاوه \f[V]--vfs-read-ahead\f[R] بایت به جلوتر را پیش‌خوانی خواهد کرد.
مقدار \f[V]--buffer-size\f[R] در حافظه اصلی بافر می‌شود، در حالی که \f[V]--vfs-read-ahead\f[R] روی دیسک بافر می‌گردد.
.PP
هنگام استفاده از این حالت، توصیه می‌شود که مقدار \f[V]--buffer-size\f[R] بیش از حد بزرگ تنظیم نشود و در صورت لزوم، \f[V]--vfs-read-ahead\f[R] با مقداری بزرگ تنظیم گردد.
.PP
\f[B]مهم:\f[R] همه سیستم‌های فایل از فایل‌های تنک (sparse files) پشتیبانی نمی‌کنند.
به‌ویژه سیستم‌های فایل FAT/exFAT از آن پشتیبانی نمی‌کنند.
اگر دایرکتوری حافظه موقت (cache) روی سیستم فایلی باشد که از فایل‌های تنک پشتیبانی نمی‌کند، کارایی rclone به شدت تضعیف خواهد شد و در صورت شناسایی چنین سیستمی، یک پیام ERROR در لاگ ثبت می‌کند.
.SS انگشت‌نگاری (Fingerprinting)
.PP
بخش‌های مختلف VFS از انگشت‌نگاری برای تشخیص اینکه آیا نسخه محلی فایل نسبت به فایل ریموت تغییر کرده است یا خیر استفاده می‌کنند.
اثرانگشت‌ها از موارد زیر تشکیل می‌شوند:
.IP \[bu] 2
اندازه (size)
.IP \[bu] 2
زمان ویرایش (modification time)
.IP \[bu] 2
هش (hash)
.PP
در صورتی که بر روی شیء مورد نظر موجود باشند.
.PP
در برخی از بک‌اندها، خواندن بعضی از این مشخصه‌ها کُند است (نیازمند یک فراخوانی API اضافه یا پردازش بیشتر به ازای هر شیء هستند).
.PP
به‌عنوان مثال، \f[V]hash\f[R] در بک‌اندهای \f[V]local\f[R] و \f[V]sftp\f[R] کند است، زیرا آن‌ها باید کل فایل را بخوانند و هش آن را محاسبه کنند؛ و \f[V]modtime\f[R] در بک‌اندهای \f[V]s3\f[R]، \f[V]swift\f[R]، \f[V]ftp\f[R] و \f[V]qinqstor\f[R] کند است زیرا برای دریافت آن نیاز به یک فراخوانی API اضافه دارند.
.PP
اگر از پرچم \f[V]--vfs-fast-fingerprint\f[R] استفاده کنید، rclone این عملیات‌های کند را در ایجاد اثرانگشت لحاظ نخواهد کرد.
این کار دقت انگشت‌نگاری را کاهش می‌دهد، اما سرعت آن را بسیار بالا می‌برد و زمان باز شدن فایل‌های کش‌شده را بهبود می‌بخشد.
.PP
اگر یک کش vfs را روی بک‌اندهای \f[V]local\f[R]، \f[V]s3\f[R] یا \f[V]swift\f[R] اجرا می‌کنید، استفاده از این پرچم توصیه می‌شود.
.PP
توجه داشته باشید که در صورت تغییر مقدار این پرچم، اثرانگشت فایل‌های موجود در کش ممکن است باطل شود و فایل‌ها باید مجدداً دانلود شوند..SS خواندن تکه‌ای VFS (VFS Chunked Reading)
.PP
هنگامی که rclone فایل‌ها را از یک ریموت می‌خواند، آن‌ها را به‌صورت تکه‌ای می‌خواند.
بدین معنا که rclone به جای درخواست کل فایل، تکه مشخص‌شده را می‌خواند.
این کار می‌تواند با درخواستِ صرفاً تکه‌هایی از ریموت که واقعاً خوانده می‌شوند، سهمیه دانلود مصرفی را برای برخی ریموت‌ها کاهش دهد؛ هرچند به بهای افزایش تعداد درخواست‌ها تمام می‌شود.
.PP
این پرچم‌ها فرایند تقسیم به تکه‌ها را کنترل می‌کنند:
.IP
.nf
\f[C]
    --vfs-read-chunk-size SizeSuffix        خواندن اشیاء مبدأ به‌صورت تکه‌ای (پیش‌فرض 128M)
    --vfs-read-chunk-size-limit SizeSuffix  حداکثر اندازه دو برابر شدن تکه (پیش‌فرض off)
    --vfs-read-chunk-streams int            تعداد جریان‌های موازی برای خواندن هم‌زمان
\f[R]
.fi
.PP
رفتار تقسیم به تکه‌ها بسته به پارامتر
\f[V]--vfs-read-chunk-streams\f[R] متفاوت خواهد بود.
.SS \f[V]--vfs-read-chunk-streams\f[R] == 0
.PP
برنامه rclone خواندن را با تکه‌ای به اندازه
\f[V]--vfs-read-chunk-size\f[R] آغاز می‌کند و سپس با هر بار خواندن، اندازه را دو برابر می‌کند.
هنگامی که \f[V]--vfs-read-chunk-size-limit\f[R] مشخص شده و بزرگ‌تر از
\f[V]--vfs-read-chunk-size\f[R] باشد، اندازه تکه برای هر فایلِ باز
تنها تا زمانی دو برابر می‌شود که به مقدار مشخص‌شده برسد.
اگر مقدار آن \[dq]off\[dq] باشد (که حالت پیش‌فرض است)، محدودیت غیرفعال
بوده و اندازه تکه بدون محدودیت افزایش خواهد یافت.
.PP
با \f[V]--vfs-read-chunk-size 100M\f[R] و
\f[V]--vfs-read-chunk-size-limit 0\f[R] بخش‌های زیر دانلود
خواهند شد: 0-100M، 100M-200M، 200M-300M، 300M-400M و غیره.
هنگامی که \f[V]--vfs-read-chunk-size-limit 500M\f[R] مشخص شود، نتیجه
به‌صورت 0-100M، 100M-300M، 300M-700M، 700M-1200M، 1200M-1700M و به همین
ترتیب خواهد بود.
.PP
تنظیم \f[V]--vfs-read-chunk-size\f[R] روی \f[V]0\f[R] یا \[dq]off\[dq]
خواندن تکه‌ای را غیرفعال می‌کند.
.PP
تکه‌ها در حافظه بافر نخواهند شد.
.SS \f[V]--vfs-read-chunk-streams\f[R] > 0
.PP
برنامه rclone به تعداد \f[V]--vfs-read-chunk-streams\f[R] تکه با اندازه
\f[V]--vfs-read-chunk-size\f[R] را به‌صورت هم‌روند می‌خواند.
اندازه برای هر بار خواندن ثابت باقی خواهد ماند.
.PP
این کار عملکرد را در پیوندهای با تأخیر بالا یا پیوندهای با پهنای باند بسیار بالا
به ذخیره‌سازهای شیء با کارایی بالا، به میزان چشمگیری بهبود می‌بخشد.
.PP
برای یافتن مقادیر بهینه
\f[V]--vfs-read-chunk-size\f[R] و \f[V]--vfs-read-chunk-streams\f[R]
مقداری آزمون و خطا نیاز خواهد بود، زیرا این مقادیر به backend مورد استفاده
و میزان تأخیر تا آن backend بستگی دارند.
.PP
برای ذخیره‌سازهای شیء با کارایی بالا (مانند AWS S3)، یک نقطه شروع مناسب
می‌تواند \f[V]--vfs-read-chunk-streams 16\f[R] و
\f[V]--vfs-read-chunk-size 4M\f[R] باشد.
در آزمایش‌ها با AWS S3، کارایی تقریباً متناسب با تنظیم
\f[V]--vfs-read-chunk-streams\f[R] مقیاس‌پذیر بود.
.PP
تنظیمات مشابه باید برای پیوندهای با تأخیر بالا نیز کار کند، اما بسته به
میزان تأخیر ممکن است برای دستیابی به توان عملیاتی مورد نظر، به
\f[V]--vfs-read-chunk-streams\f[R] بیشتری نیاز باشد.
.SS عملکرد VFS (VFS Performance)
.PP
این پرچم‌ها می‌توانند برای فعال/غیرفعال کردن ویژگی‌های VFS به دلایل
عملکردی یا دلایل دیگر استفاده شوند.
همچنین ویژگی خواندن تکه‌ای را ببینید.
.PP
به‌ویژه S3 و Swift سود بسیار زیادی از پرچم
\f[V]--no-modtime\f[R] می‌برند (یا از \f[V]--use-server-modtime\f[R] برای
اثری کمی متفاوت استفاده کنید)، زیرا هر بار خواندن زمان اصلاح نیازمند یک
تراکنش است.
.IP
.nf
\f[C]
    --no-checksum     عدم مقایسه چک‌سام‌ها هنگام بارگذاری/دانلود.
    --no-modtime      عدم خواندن/نوشتن زمان اصلاح (می‌تواند سرعت را افزایش دهد).
    --no-seek         عدم اجازه پرش (seeking) در فایل‌ها.
    --read-only       تنها اجازه دسترسی فقط‌خواندنی.
\f[R]
.fi
.PP
گاهی اوقات عملیات خواندن یا نوشتن به‌صورت نامرتب به rclone تحویل داده می‌شوند.
rclone به جای پرش (seek)، مدت کوتاهی منتظر می‌ماند تا عملیات خواندن
یا نوشتنِ به‌ترتیب و متوالی دریافت شود.
این پرچم‌ها تنها در صورتی اثرگذار خواهند بود که از فایل کش روی دیسک استفاده نشود.
.IP
.nf
\f[C]
    --vfs-read-wait duration   مدت زمان انتظار برای خواندن متوالی پیش از پرش (پیش‌فرض 20ms)
    --vfs-write-wait duration  مدت زمان انتظار برای نوشتن متوالی پیش از دادن خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
هنگام استفاده از کش نوشتن VFS (\f[V]--vfs-cache-mode\f[R] با مقدار
writes یا full)، پرچم سراسری \f[V]--transfers\f[R] را می‌توان برای
تنظیم تعداد بارگذاری‌های هم‌زمانِ فایل‌های تغییریافته از کش تنظیم کرد
(پرچم سراسری مرتبط \f[V]--checkers\f[R] هیچ تأثیری بر VFS ندارد).
.IP
.nf
\f[C]
    --transfers int  تعداد انتقال‌های موازی فایل برای اجرا (پیش‌فرض 4)
\f[R]
.fi.SS "پیوندهای نمادین (Symlinks)"
.PP
به‌طور پیش‌فرض VFS از پیوندهای نمادین پشتیبانی نمی‌کند.
با این حال این ویژگی می‌تواند با هر یک از پرچم‌های زیر فعال شود:
.IP
.nf
\f[C]
    --links      ترجمه پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq].
    --vfs-links  ترجمه پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
\f[R]
.fi
.PP
از آنجا که بیشتر سامانه‌های ذخیره‌سازی ابری مستقیماً از پیوندهای نمادین پشتیبانی نمی‌کنند، rclone
پیوند نمادین را به عنوان یک فایل معمولی با پسوندی ویژه ذخیره می‌کند.
بنابراین فایلی که به عنوان پیوند نمادین \f[V]link-to-file.txt\f[R] نمایش داده می‌شود،
در فضای ذخیره‌سازی ابری به صورت \f[V]link-to-file.txt.rclonelink\f[R] ذخیره خواهد شد و
محتوای آن مسیر مقصد پیوند نمادین خواهد بود.
.PP
توجه داشته باشید که \f[V]--links\f[R] ترجمه پیوندهای نمادین را به‌طور سراسری در
rclone فعال می‌کند \- این شامل هر backendای که از این مفهوم پشتیبانی کند (برای
نمونه backend محلی) می‌شود.
\f[V]--vfs-links\f[R] آن را فقط برای لایه VFS فعال می‌کند.
.PP
این طرح با طرح مورد استفاده توسط backend محلی با پرچم
\f[V]--local-links\f[R] سازگار است (https://rclone.org/local/#symlinks-junction-points).
.PP
پرچم \f[V]--vfs-links\f[R] برای
\f[V]rclone mount\f[R]، \f[V]rclone nfsmount\f[R] و
\f[V]rclone serve nfs\f[R] طراحی شده است.
.PP
این ویژگی هنوز با سایر دستورهای \f[V]rclone serve\f[R] آزمایش
نشده است.
.PP
یکی از محدودیت‌های پیاده‌سازی فعلی این است که انتظار دارد فراخواننده
پیوندهای نمادین فرعی (sub-symlinks) را حل (resolve) کند.
برای نمونه، با فرض این درخت دایرکتوری:
.IP
.nf
\f[C]
\&.
├── dir
│\ \  └── file.txt
└── linked-dir -> dir
\f[R]
.fi
.PP
سامانه VFS به درستی \f[V]linked-dir\f[R] را حل می‌کند اما
\f[V]linked-dir/file.txt\f[R] را حل نخواهد کرد.
این موضوع برای دستورهای آزمایش‌شده مشکلی ایجاد نمی‌کند اما ممکن است برای
سایر دستورها مسئله‌ساز باشد.
.PP
\f[B]توجه\f[R] داشته باشید که یک گزارش مشکل باز درباره پشتیبانی از پیوندهای نمادین وجود دارد:
شماره ۸۲۴۵ (https://github.com/rclone/rclone/issues/8245) که مربوط به ایجاد فایل‌های تکراری
هنگام انتقال پیوندهای نمادین به دایرکتوری‌هایی است که فایلی با همان نام در آن‌ها وجود دارد (یا برعکس).
.SS "حساسیت VFS به کوچک و بزرگی حروف (VFS Case Sensitivity)"
.PP
سامانه‌های فایل لینوکس به کوچک و بزرگی حروف حساس هستند (case-sensitive): دو فایل می‌توانند
تنها در بزرگی و کوچکی حروف با یکدیگر تفاوت داشته باشند، و هنگام باز کردن یک فایل باید دقیقاً از همان حالت حروف استفاده شود.
.PP
سامانه‌های فایل در ویندوزهای نوین به کوچک و بزرگی حروف حساس نیستند اما حالت حروف را حفظ می‌کنند (case-preserving):
اگرچه فایل‌های موجود را می‌توان با استفاده از هر حالتی از حروف باز کرد، اما حالت دقیق حروفی که
برای ایجاد فایل استفاده شده است حفظ می‌شود و برای پرس‌وجوی برنامه‌ها در دسترس است.
دو فایل در یک دایرکتوری یکسان مجاز نیستند که تنها در بزرگی و کوچکی حروف متفاوت باشند.
.PP
معمولاً سامانه‌های فایل در macOS نسبت به کوچک و بزرگی حروف حساس نیستند.
امکان حساس کردن سامانه‌های فایل macOS به کوچک و بزرگی حروف وجود دارد، اما این
حالت پیش‌فرض نیست.
.PP
پرچم \f[V]--vfs-case-insensitive\f[R] در VFS نحوه مدیریت این دو حالت را توسط rclone
کنترل می‌کند.
اگر مقدار آن \[dq]false\[dq] باشد، rclone نام‌های فایل را همان‌گونه که هستند به ریموت ارسال می‌کند.
اگر این پرچم \[dq]true\[dq] باشد (یا بدون مقدار در خط فرمان مشخص شود)،
rclone ممکن است یک «اصلاح» (\[dq]fixup\[dq]) را مطابق توضیحات زیر انجام دهد.
.PP
کاربر ممکن است نام فایلی را برای باز کردن/حذف/تغییر نام/غیره با حالتی از حروف
متفاوت از آنچه روی ریموت ذخیره شده است مشخص کند.
اگر آرگومانی به یک فایل موجود با دقیقاً همان نام اشاره کند، حالت حروف فایل موجود روی دیسک استفاده خواهد شد.
با این حال، اگر نام فایلی با دقیقاً همان نام پیدا نشود اما نامی وجود داشته باشد که فقط در بزرگی و کوچکی حروف تفاوت دارد، rclone به صورت شفاف نام را اصلاح می‌کند.
این اصلاح تنها زمانی رخ می‌دهد که یک فایل موجود درخواست شده باشد.
حساسیت به کوچک و بزرگی حروف برای فایل‌هایی که به تازگی توسط rclone ایجاد می‌شوند، توسط ریموت زیرین کنترل می‌شود.
.PP
توجه داشته باشید که حساسیت به کوچک و بزرگی حروف در سیستم‌عامل اجراکننده rclone (مقصد)
ممکن است با حساسیت به حروف سامانه فایل ارائه شده توسط rclone (مبدأ) متفاوت باشد.
این پرچم کنترل می‌کند که آیا برای برآورده کردن نیاز مقصد، «اصلاح» (\[dq]fixup\[dq]) انجام شود یا خیر.
.PP
اگر این پرچم در خط فرمان مشخص نشود، مقدار پیش‌فرض آن به سیستم‌عاملی بستگی دارد که rclone روی آن اجرا می‌شود:
روی ویندوز و macOS برابر با \[dq]true\[dq] و در غیر این صورت \[dq]false\[dq].
اگر پرچم بدون مقدار مشخص شود، مقدار آن \[dq]true\[dq] خواهد بود.
.PP
پرچم \f[V]--no-unicode-normalization\f[R] کنترل می‌کند که آیا «اصلاح» مشابهی برای نام‌فایل‌هایی که
متفاوت هستند اما از نظر یونیکد هم‌ارز رسمی
(https://en.wikipedia.org/wiki/Unicode_equivalence) محسوب می‌شوند انجام شود یا خیر.
یکسان‌سازی یونیکد می‌تواند به‌ویژه برای کاربران macOS که فرم NFD را به جای فرم NFC
مورد استفاده در اکثر پلتفرم‌های دیگر ترجیح می‌دهد، مفید باشد.
بنابراین اکیداً توصیه می‌شود در macOS مقدار پیش‌فرض
\f[V]false\f[R] حفظ شود تا از مشکلات سازگاری کدگذاری جلوگیری به عمل آید.
.PP
در رویداد (احتمالاً نادر) که یک دایرکتوری پس از اعمال یکسان‌سازی حالت حروف و یونیکد، چندین نام فایل تکراری داشته باشد،
پرچم \f[V]--vfs-block-norm-dupes\f[R] امکان پنهان کردن این موارد تکراری را فراهم می‌کند.
این قابلیت با افت کارایی همراه است، زیرا rclone هنگام فهرست کردن یک دایرکتوری باید تمام دایرکتوری را برای یافتن موارد تکراری پیمایش کند.
به همین دلیل، توصیه می‌شود در صورت عدم نیاز، این گزینه غیرفعال بماند.
با این حال، کاربران macOS ممکن است تمایل داشته باشند از آن استفاده کنند، زیرا در غیر این صورت اگر یک دایرکتوری ریموت شامل هر دو نسخه NFC و NFD از یک نام فایل باشد، وضعیت عجیبی رخ خواهد داد:
هر دو نسخه فایل در نقطه اتصالات (mount) قابل مشاهده خواهند بود و هر دو به نظر قابل ویرایش می‌آیند، اما ویرایش هر کدام از نسخه‌ها در عمل در پس‌زمینه تنها باعث ویرایش نسخه NFD می‌شود.
پرچم \f[V]--vfs-block-norm-dupes\f[R] با شناسایی این سناریو، پنهان کردن موارد تکراری، و ثبت یک خطا در گزارش‌ها (مشابه روش مدیریت این موضوع در \f[V]rclone sync\f[R])، از این سردرگمی جلوگیری می‌کند..SS گزینه‌های دیسک VFS (VFS Disk Options)
.PP
این پرچم به شما اجازه می‌دهد آمار مربوط به سیستم فایل را به صورت دستی تنظیم کنید.
این قابلیت زمانی که این آمار نتوانند به صورت خودکار به درستی خوانده شوند، می‌تواند مفید باشد.
.IP
.nf
\f[C]
    --vfs-disk-space-total-size    Manually set the total disk space size (example: 256G, default: -1)
\f[R]
.fi
.SS گزارش جایگزین بایت‌های مصرف‌شده (Alternate report of used bytes)
.PP
برخی backendها، به‌ویژه S3، مقدار بایت‌های استفاده‌شده را گزارش نمی‌کنند.
اگر نیاز دارید این اطلاعات هنگام اجرای \f[V]df\f[R] روی سیستم فایل در دسترس باشد، پرچم \f[V]--vfs-used-is-size\f[R] را به rclone ارسال کنید.
با تنظیم این پرچم، rclone به جای اتکا به backend برای گزارش این اطلاعات، تمام remote را مشابه \f[V]rclone size\f[R] اسکن کرده و فضای کل مصرف‌شده را خودش محاسبه می‌کند.
.PP
\f[B]هشدار\f[R]: برخلاف \f[V]rclone size\f[R]، این پرچم فیلترها را نادیده می‌گیرد تا نتیجه دقیق باشد.
با این حال، این کار بسیار ناکارآمد است و ممکن است باعث فراخوانی‌های مکرر API و تحمیل هزینه‌های اضافی شود.
از آن به عنوان آخرین راه‌حل و تنها همراه با کش‌کردن (caching) استفاده کنید.
.SS فراداده VFS (VFS Metadata)
.PP
اگر از پرچم \f[V]--vfs-metadata-extension\f[R] استفاده کنید، می‌توانید VFS را طوری تنظیم کنید که فایل‌های حاوی فراداده (https://rclone.org/docs/#metadata) را به صورت یک شیء JSON در معرض دسترسی قرار دهد.
این فایل‌ها در فهرست دایرکتوری نمایش داده نمی‌شوند، اما می‌توان روی آن‌ها \f[V]stat\f[R] اجرا کرد و آن‌ها را باز نمود، و پس از انجام این کار، تا زمان منقضی شدن حافظه موقت (cache) دایرکتوری، در فهرست دایرکتوری ظاهر \f[B]خواهند شد\f[R].
.PP
توجه داشته باشید که برخی از backendها فراداده ایجاد نمی‌کنند مگر اینکه پرچم \f[V]--metadata\f[R] را ارسال کنید.
.PP
برای مثال، با استفاده از \f[V]rclone mount\f[R] همراه با \f[V]--metadata --vfs-metadata-extension .metadata\f[R] خواهیم داشت:
.IP
.nf
\f[C]
$ ls -l /mnt/
total 1048577
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G

$ cat /mnt/1G.metadata
{
        \[dq]atime\[dq]: \[dq]2025-03-04T17:34:22.317069787Z\[dq],
        \[dq]btime\[dq]: \[dq]2025-03-03T16:03:37.708253808Z\[dq],
        \[dq]gid\[dq]: \[dq]1000\[dq],
        \[dq]mode\[dq]: \[dq]100664\[dq],
        \[dq]mtime\[dq]: \[dq]2025-03-03T16:03:39.640238323Z\[dq],
        \[dq]uid\[dq]: \[dq]1000\[dq]
}

$ ls -l /mnt/
total 1048578
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G
-rw-rw-r-- 1 user user        185 Mar  3 16:03 1G.metadata
\f[R]
.fi
.PP
اگر فایل فاقد فراداده باشد به صورت \f[V]{}\f[R] بازگردانده می‌شود و اگر در خواندن فراداده خطایی رخ دهد، خطا به صورت \f[V]{\[dq]error\[dq]:\[dq]error string\[dq]}\f[R] بازگردانده خواهد شد.
.SS پروکسی احراز هویت (Auth Proxy)
.PP
اگر پارامتر \f[V]--auth-proxy /path/to/program\f[R] را تعیین کنید، rclone از آن برنامه برای ساخت آنی backendها استفاده خواهد کرد که سپس برای احراز هویت درخواست‌های ورودی به کار می‌روند.
این سازوکار از یک پروتکل ساده مبتنی بر JSON با ورودی روی STDIN و خروجی روی STDOUT استفاده می‌کند.
.PP
\f[B]لطفاً توجه داشته باشید:\f[R] گزینه‌های \f[V]--auth-proxy\f[R] و \f[V]--authorized-keys\f[R] نمی‌توانند هم‌زمان استفاده شوند؛ اگر \f[V]--auth-proxy\f[R] تنظیم شده باشد، گزینه کلیدهای مجاز نادیده گرفته خواهد شد.
.PP
یک برنامه نمونه در مسیر bin/test_proxy.py (https://github.com/rclone/rclone/blob/master/bin/test_proxy.py) در کد منبع rclone موجود است.
.PP
وظیفه این برنامه این است که \f[V]user\f[R] و \f[V]pass\f[R] را از ورودی دریافت کرده و آن‌ها را به پیکربندی یک backend در STDOUT با قالب JSON تبدیل کند.
این پیکربندی، هرگونه پارامتر پیش‌فرض مربوط به backend را به همراه خواهد داشت، اما از پیکربندی‌های حاصل از متغیرهای محیطی یا گزینه‌های خط فرمان استفاده نخواهد کرد \- ساخت یک پیکربندی کامل، وظیفه برنامه پروکسی است.
.PP
این پیکربندی تولیدشده باید شامل این پارامتر اضافی باشد:
.IP \[bu] 2
\f[V]_root\f[R] \- ریشه مورد استفاده برای backend
.PP
و می‌تواند شامل این پارامترها باشد:
.IP \[bu] 2
\f[V]_obscure\f[R] \- رشته‌های جداشده با ویرگول برای پارامترهایی که باید مبهم‌سازی شوند
.IP \[bu] 2
\f[V]_secret_access_key\f[R] \- کلید مخفی برای احراز هویت access key در S3 (پایین را ببینید)
.PP
اگر احراز هویت با گذرواژه توسط کلاینت استفاده شده باشد، ورودی به فرایند پروکسی (روی STDIN) شبیه به این خواهد بود:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]pass\[dq]: \[dq]mypassword\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
اگر احراز هویت با کلید عمومی (public-key) توسط کلاینت استفاده شده باشد، ورودی به فرایند پروکسی (روی STDIN) شبیه به این خواهد بود:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]public_key\[dq]: \[dq]AAAAB3NzaC1yc2EAAAADAQABAAABAQDuwESFdAe14hVS6omeyX7edc...JQdf\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
اگر کلاینت با یک access key مربوط به S3 احراز هویت کند (\f[V]rclone serve s3\f[R])، کلاینت هرگز کلید مخفی (secret) خود را ارسال نمی‌کند، بلکه تنها امضای ایجادشده توسط آن را می‌فرستد؛ بنابراین ورودی تنها شامل شناسه access key به عنوان \f[V]user\f[R] است، بدون هیچ \f[V]pass\f[R] یا \f[V]public_key\f[R]:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]AKIAIOSFODNN7EXAMPLE\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
در این حالت، برنامه باید secret access key مربوط به آن شناسه access key را پیدا کرده و آن را در فیلد \f[V]_secret_access_key\f[R] در خروجی بازگرداند.
سپس rclone از آن کلید مخفی برای تأیید اعتبار امضای روی درخواست استفاده می‌کند و در صورت عدم تطابق، درخواست را رد خواهد کرد.
این بدان معناست که برنامه پروکسی، مرجع اصلی (source of truth) هم برای اطلاعات احراز هویت و هم برای backend مربوط به آن‌ها به شمار می‌رود.
اگر برنامه \f[V]_secret_access_key\f[R] را بازنگرداند یا آن را خالی برگرداند، درخواست رد می‌شود.
.PP
پاسخ برنامه برای یک شناسه access key کش می‌شود (پایین را ببینید)، اما حتی اگر شناسه access key به طور مداوم در حال استفاده باشد، پس از ۵ دقیقه مجدداً از برنامه استعلام می‌شود؛ بنابراین ابطال یک شناسه access key در برنامه ظرف ۵ دقیقه اعمال خواهد شد.
یک کلید مخفی بازچرخانی‌شده (rotated secret) با نخستین درخواستی که با آن امضا شده باشد، اثرگذار خواهد بود.
.PP
کلید \f[V]client_ip\f[R] نشانی IP را که کلاینت از آن متصل شده است، بدون شماره پورت، نگه می‌دارد.
از آن می‌توان برای محدود کردن ورودها به شبکه‌هایی خاص یا ثبت متمرکز تلاش‌های احراز هویت استفاده کرد.
اگر کلاینت فاقد نشانی IP باشد (برای مثال هنگام اتصال از طریق یک سوکت یونیکس)، این مقدار نادیده گرفته می‌شود.
توجه داشته باشید که اگر rclone پشت یک reverse proxy باشد، این نشانی مربوط به reverse proxy خواهد بود نه کلاینت اصلی.
.PP
و به عنوان یک مثال، خروجی زیر را روی STDOUT بازمی‌گرداند:
.IP
.nf
\f[C]
{
  \[dq]type\[dq]: \[dq]sftp\[dq],
  \[dq]_root\[dq]: \[dq]\[dq],
  \[dq]_obscure\[dq]: \[dq]pass\[dq],
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]pass\[dq]: \[dq]mypassword\[dq],
  \[dq]host\[dq]: \[dq]sftp.example.com\[dq]
}
\f[R]
.fi.PP
این بدین معنی است که یک backend برای SFTP به‌صورت آنی (on the fly) برای \f[V]user\f[R] و \f[V]pass\f[R]/\f[V]public_key\f[R] بازگردانده‌شده در خروجی به میزبان داده‌شده ساخته خواهد شد.
توجه داشته باشید که از آنجا که \f[V]_obscure\f[R] روی \f[V]pass\f[R] تنظیم شده است، rclone پیش از ایجاد backend پارامتر \f[V]pass\f[R] را مبهم‌سازی (obscure) می‌کند (که این برای backendهای sftp الزامی است).
.PP
این برنامه می‌تواند \f[V]user\f[R] ارائه‌شده را به هر نحوی دستکاری کند؛ برای نمونه جهت پراکسی کردن به چندین backend مختلف sftp، می‌توانید \f[V]user\f[R] را برابر با \f[V]user\[at]example.com\f[R] قرار دهید و سپس در خروجی مقدار \f[V]host\f[R] را به \f[V]example.com\f[R] و کاربر را به \f[V]user\f[R] تنظیم کنید.
از نظر امنیتی، احتمالاً تمایل خواهید داشت که \f[V]host\f[R] را به یک فهرست محدود مقید کنید.
.PP
یک حافظهٔ نهان (cache) داخلی از backendها بر اساس \f[V]user\f[R]، هش مربوط به \f[V]pass\f[R] یا \f[V]public_key\f[R]، و \f[V]client_ip\f[R] کلیدگذاری می‌شود.
این بدان معنی است که اگر گذرواژه یا کلید عمومی یک کاربر تغییر کند، کلاینت از یک آدرس IP جدید متصل شود، یا پراکسی پارامترهای پیکربندی متفاوتی را برگرداند (مانند چرخش \f[V]api_key\f[R])، در درخواست بعدی به‌جای استفادهٔ مجدد از مورد ذخیره‌شده در حافظهٔ نهان، یک backend تازه ایجاد خواهد شد.
.PP
از این قابلیت می‌توان برای ساخت پراکسی‌های چندمنظوره برای هر نوع backend که rclone پشتیبانی می‌کند، استفاده کرد.
.IP
.nf
\f[C]
rclone serve http remote:path [flags]
\f[R]
.fi
.SS "گزینه‌ها (Options)"
.IP
.nf
\f[C]
      --addr stringArray                       آدرس IPaddress:Port یا :Port برای متصل کردن سرور به آن (پیش‌فرض 127.0.0.1:8080)
      --allow-origin string                    مبدأیی که درخواست‌های میان‌دامنه (CORS) می‌توانند از آن اجرا شوند
      --auth-proxy string                      برنامه‌ای برای ایجاد backend از روی اطلاعات احراز هویت
      --baseurl string                         پیشوند برای نشانی‌های URL - برای ریشه خالی بگذارید
      --cert string                            کلید TLS PEM (ترکیب گواهی و گواهی CA)
      --client-ca string                       مرجع صدور گواهی (CA) کلاینت جهت اعتبارسنجی کلاینت‌ها
      --dir-cache-time Duration                مدت‌زمان نگهداری مدخل‌های دایرکتوری در حافظهٔ نهان (پیش‌فرض 5m0s)
      --dir-perms FileMode                     مجوزهای دایرکتوری (پیش‌فرض 777)
      --disable-dir-list                       غیرفعال‌سازی فهرست HTML دایرکتوری در درخواست GET برای یک دایرکتوری
      --disable-zip                            غیرفعال‌سازی بارگیری فایل zip از دایرکتوری‌ها
      --file-perms FileMode                    مجوزهای فایل (پیش‌فرض 666)
      --gid uint32                             بازنویسی فیلد gid تنظیم‌شده توسط سیستم‌فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1000)
  -h, --help                                   راهنمای http
      --htpasswd string                        یک فایل htpasswd - در صورت ارائه نشدن هیچ احراز هویتی انجام نمی‌شود
      --key string                             کلید خصوصی TLS PEM
      --link-perms FileMode                    مجوزهای پیوند (پیش‌فرض 666)
      --max-header-bytes int                   حداکثر اندازهٔ سرآیند درخواست (پیش‌فرض 4096)
      --min-tls-version string                 حداقل نسخهٔ قابل قبول TLS (پیش‌فرض \[dq]tls1.0\[dq])
      --no-checksum                            عدم مقایسهٔ چکسام‌ها در بارگذاری/بارگیری
      --no-modtime                             عدم خواندن/نوشتن زمان ویرایش (می‌تواند سرعت را افزایش دهد)
      --no-seek                                عدم اجازه به جستجو و پرش (seeking) در فایل‌ها
      --pass string                            گذرواژه برای احراز هویت
      --poll-interval Duration                 زمان انتظار بین بررسی دوره‌ای برای تغییرات؛ باید کمتر از dir-cache-time باشد و فقط در remoteهای پشتیبانی‌شده کار می‌کند (تنظیم 0 برای غیرفعال‌سازی) (پیش‌فرض 1m0s)
      --read-only                              فقط اجازهٔ دسترسی خواندنی
      --realm string                           قلمرو (Realm) برای احراز هویت
      --response-header stringArray            تنظیم سرآیند HTTP برای همهٔ پاسخ‌ها، با بازنویسی مقادیر موجود
      --salt string                            سالت (salt) هش کردن گذرواژه (پیش‌فرض \[dq]dlPL2MqE\[dq])
      --server-read-timeout Duration           مهلت زمانی خواندن داده‌ها توسط سرور (پیش‌فرض 1h0m0s)
      --server-write-timeout Duration          مهلت زمانی نوشتن داده‌ها توسط سرور (پیش‌فرض 1h0m0s)
      --template string                        قالب سفارشی تعیین‌شده توسط کاربر
      --uid uint32                             بازنویسی فیلد uid تنظیم‌شده توسط سیستم‌فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1000)
      --umask FileMode                         بازنویسی بیت‌های مجوز تعیین‌شده توسط سیستم‌فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 002)
      --user string                            نام کاربری برای احراز هویت
      --user-from-header string                نام کاربری از سرآیند HTTP مشخص‌شده
      --vfs-block-norm-dupes                   در صورت وجود نام‌های فایل تکراری در همان دایرکتوری (پس از نرمال‌سازی)، ثبت خطا و پنهان‌کردن موارد تکراری (ممکن است هزینهٔ کارایی داشته باشد)
      --vfs-cache-max-age Duration             حداکثر زمان از آخرین دسترسی به اشیاء در حافظهٔ نهان (پیش‌فرض 1h0m0s)
      --vfs-cache-max-size SizeSuffix          حداکثر اندازهٔ کل اشیاء در حافظهٔ نهان (پیش‌فرض off)
      --vfs-cache-min-free-space SizeSuffix    حداقل فضای خالی هدف روی دیسک حاوی حافظهٔ نهان (پیش‌فرض off)
      --vfs-cache-mode CacheMode               حالت حافظهٔ نهان off|minimal|writes|full (پیش‌فرض off)
      --vfs-cache-poll-interval Duration       بازهٔ زمانی بررسی حافظهٔ نهان برای اشیاء کهنه (پیش‌فرض 1m0s)
      --vfs-case-insensitive                   در صورت پیدا نشدن نام فایل، یافتن مورد منطبق بدون حساسیت به حروف بزرگ و کوچک
      --vfs-disk-space-total-size SizeSuffix   مشخص کردن کل فضای دیسک (پیش‌فرض off)
      --vfs-fast-fingerprint                   استفاده از اثرانگشت سریع (با دقت کمتر) برای تشخیص تغییرات
      --vfs-handle-caching Duration            مدت زمان فعال نگه‌داشتن دستگیرهٔ فایل و بارگیرنده‌ها پس از آخرین بسته‌شدن (پیش‌فرض 5s)
      --vfs-links                              تبدیل symlinkها به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
      --vfs-metadata-extension string          تنظیم پسوند برای خواندن فراداده از آن
      --vfs-read-ahead SizeSuffix              پیش‌خوانی اضافی فراتر از --buffer-size هنگام استفاده از cache-mode full
      --vfs-read-chunk-size SizeSuffix         خواندن اشیاء مبدأ به‌صورت تکه‌ای (chunk) (پیش‌فرض 128Mi)
      --vfs-read-chunk-size-limit SizeSuffix   اگر بزرگ‌تر از --vfs-read-chunk-size باشد، اندازهٔ تکه پس از هر بار خواندن دوبرابر می‌شود تا به سقف برسد (\[aq]off\[aq] نامحدود است) (پیش‌فرض off)
      --vfs-read-chunk-streams int             تعداد جریان‌های موازی برای خواندن هم‌زمان
      --vfs-read-wait Duration                 مدت زمان انتظار برای خواندن متوالی قبل از پرش (seek) (پیش‌فرض 20ms)
      --vfs-refresh                            تازه‌سازی بازگشتی حافظهٔ نهان دایرکتوری در پس‌زمینه هنگام شروع
      --vfs-used-is-size rclone size           استفاده از الگوریتم rclone size برای اندازهٔ استفاده‌شده (Used)
      --vfs-write-back Duration                مدت زمان بازنویسی فایل‌ها پس از آخرین استفاده هنگام به‌کارگیری حافظهٔ نهان (پیش‌فرض 5s)
      --vfs-write-wait Duration                مدت زمان انتظار برای نوشتن متوالی پیش از اعلام خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای مشاهدهٔ گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (<https://rclone.org/flags>) را ببینید..SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌ها برای فیلتر کردن فهرست دایرکتوری
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های روی مقصد که از همگام‌سازی استثنا شده‌اند
      --exclude stringArray                 کنار گذاشتن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (از - برای stdin)
      --exclude-if-present stringArray      کنار گذاشتن دایرکتوری‌ها در صورت وجود نام‌فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل مبدأ از فایل (از - برای stdin)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل مبدأ بدون پردازش خطوط (از - برای stdin)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل مبدأ با جداکننده NUL (از - برای stdin)
  -f, --filter stringArray                  افزودن یک قاعدهٔ فیلتر فایل
      --filter-from stringArray             خواندن الگوهای فیلتر فایل از یک فایل (از - برای stdin)
      --hash-filter string                  افرازبندی نام‌فایل‌ها بر اساس هش k/n یا تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (از - برای stdin)
      --max-age Duration                    فقط انتقال فایل‌های جدیدتر از این مقدار در ثانیه یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تنظیم، محدود کردن عمق بازگشت به این مقدار (پیش‌فرض \-1)
      --max-size SizeSuffix                 فقط انتقال فایل‌های کوچک‌تر از این مقدار در KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        کنار گذاشتن فراداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای فراداده از فایل (از - برای stdin)
      --metadata-filter stringArray         افزودن یک قاعدهٔ فیلتر فراداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر فراداده از یک فایل (از - برای stdin)
      --metadata-include stringArray        شامل کردن فراداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول فراداده از فایل (از - برای stdin)
      --min-age Duration                    فقط انتقال فایل‌های قدیمی‌تر از این مقدار در ثانیه یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 فقط انتقال فایل‌های بزرگ‌تر از این مقدار در KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone serve (https://rclone.org/commands/rclone_serve) \- ارائهٔ یک
ریموت بر بستر یک پروتکل.
.SH rclone serve nfs
.PP
ارائهٔ ریموت به‌صورت یک مانت NFS
.SS "خلاصه دستور (SYNOPSIS)"
.PP
ایجاد یک سرور NFS که ریموت داده‌شده را روی شبکه ارائه می‌دهد.
.PP
این دستور یک سرور NFSv3 را برای ارائهٔ هرگونه ریموت rclone از طریق NFS پیاده‌سازی می‌کند.
.PP
هدف اصلی این دستور فعال‌سازی دستور
mount (https://rclone.org/commands/rclone_mount) در نسخه‌های جدید macOS
است که نصب FUSE در آن‌ها بسیار دشوار است.
.PP
این سرور هیچ‌گونه احراز هویتی را پیاده‌سازی نمی‌کند، بنابراین هر کلاینتی قادر
به دسترسی به داده‌ها خواهد بود.
برای محدود کردن دسترسی، می‌توانید از \f[V]serve nfs\f[R] روی نشانی loopback استفاده کنید
یا به تونل‌های امن (مانند SSH) متکی شوید یا از فایروال بهره ببرید.
.PP
به همین دلیل، به‌طور پیش‌فرض یک درگاه TCP تصادفی انتخاب شده و
رابط loopback به‌صورت پیش‌فرض برای نشانی شنود به کار می‌رود؛ به این معنا
که تنها برای ماشین محلی در دسترس است.
اگر می‌خواهید ماشین‌های دیگر روی شبکهٔ محلی به مانت NFS دسترسی داشته باشند،
باید نشانی شنود و درگاه را با استفاده از پرچم
\f[V]--addr\f[R] مشخص کنید.
.PP
تغییر فایل‌ها از طریق پروتکل NFS نیازمند حافظه‌پنهان‌سازی (کش) VFS است.
معمولاً برای اینکه بتوانید در نقطهٔ اتصال بنویسید، باید \f[V]--vfs-cache-mode\f[R] را
مشخص کنید (مقدار \f[V]full\f[R] توصیه می‌شود).
اگر حالت کش VFS را مشخص نکنید، اتصال به‌صورت فقط‌خواندنی خواهد بود.
.PP
گزینهٔ \f[V]--nfs-cache-type\f[R] نوع کش هندل‌های NFS را کنترل می‌کند.
این گزینه به‌طور پیش‌فرض روی \f[V]memory\f[R] تنظیم است که در آن هندل‌های جدید هنگام نیاز به‌صورت
تصادفی تخصیص داده می‌شوند.
این موارد در حافظه ذخیره می‌شوند.
در صورت بازراه‌اندازی سرور، کش هندل از بین خواهد رفت و کلاینت‌های متصل
NFS با خطاهای هندل منسوخ (stale handle) مواجه خواهند شد.
.PP
گزینهٔ \f[V]--nfs-cache-type disk\f[R] از کش هندل NFS روی دیسک استفاده می‌کند.
ابزار rclone مسیر شیء را هش کرده و آن را در فایلی با نام برگرفته از
هش ذخیره می‌کند.
این هش‌ها روی دیسک و درون دایرکتوری کنترل‌شده توسط
\f[V]--cache-dir\f[R] ذخیره می‌شوند، یا اینکه دایرکتوری دقیق را می‌توان با
\f[V]--nfs-cache-dir\f[R] مشخص کرد.
استفاده از این حالت بدین معناست که سرور NFS می‌تواند در هر زمان بدون
تأثیر منفی بر کلاینت‌های متصل، بازراه‌اندازی شود.
.PP
گزینهٔ \f[V]--nfs-cache-type symlink\f[R] از نظر استفاده از کش روی دیسک شبیه به
\f[V]--nfs-cache-type disk\f[R] است، اما
ورودی‌های کش به‌صورت پیوندهای نمادین (symlink) نگهداری می‌شوند.
ابزار rclone از هندل فایل زیرین به‌عنوان هندل NFS استفاده خواهد کرد
که این کار عملکرد را بهبود می‌بخشد.
از این نوع کش نمی‌توان پشتیبان‌گیری و بازیابی انجام داد چرا که هندل‌های
زیرین تغییر خواهند کرد.
این قابلیت فقط مخصوص لینوکس است.
این ویژگی نیازمند اجرای rclone با کاربر ریشه (root) یا با
مجوز \f[V]CAP_DAC_READ_SEARCH\f[R] است.
می‌توانید با اجرای دستور زیر روی فایل اجرایی rclone،
آن را با این مجوز ویژه اجرا کنید:
\f[V]sudo setcap cap_dac_read_search+ep /path/to/rclone\f[R].
.PP
گزینهٔ \f[V]--nfs-cache-handle-limit\f[R] بیشینهٔ تعداد هندل‌های کش‌شدهٔ NFS
نگهداری‌شده توسط گردانندهٔ کش را کنترل می‌کند.
این مقدار نباید بیش از حد پایین تنظیم شود، در غیر این صورت ممکن است هنگام تلاش برای
دسترسی به فایل‌ها با خطا مواجه شوید.
پیش‌فرض آن \f[V]1000000\f[R] است، اما اگر مصرف منابع سیستم توسط سرور
باعث ایجاد مشکل شد، کاهش این حد را در نظر بگیرید.
این گزینه تنها توسط کش نوع \f[V]memory\f[R] به کار می‌رود.
.PP
برای ارائهٔ NFS روی شبکه از دستور زیر استفاده کنید:
.IP
.nf
\f[C]
rclone serve nfs remote: --addr 0.0.0.0:$PORT --vfs-cache-mode=full
\f[R]
.fi
.PP
این دستور درگاهی را مشخص می‌کند که می‌تواند در دستور mount به کار رود.
برای سوار کردن سرور در Linux/macOS، از دستور زیر استفاده کنید:
.IP
.nf
\f[C]
mount -t nfs -o port=$PORT,mountport=$PORT,tcp $HOSTNAME:/ path/to/mountpoint
\f[R]
.fi
.PP
که در آن \f[V]$PORT\f[R] همان شماره درگاهی است که در دستور
\f[V]serve nfs\f[R] استفاده شده و \f[V]$HOSTNAME\f[R] نشانی شبکهٔ
ماشینی است که \f[V]serve nfs\f[R] روی آن اجرا شده است.
.PP
کلاینت‌های NFS همچنین می‌توانند با قرار دادن یک زیردایرکتوری در مسیر مانت،
تنها همان زیردایرکتوری از ریموت ارائه‌شده را سوار کنند.
برای نمونه جهت سوار کردن تنها زیردایرکتوری \f[V]photos/2024\f[R]:
.IP
.nf
\f[C]
mount -t nfs -o port=$PORT,mountport=$PORT,tcp $HOSTNAME:/photos/2024 path/to/mountpoint
\f[R]
.fi
.PP
زیرمسیر درون ریموت ارائه‌شده ارزیابی می‌شود و باید به یک
دایرکتوری موجود اشاره داشته باشد (نه یک فایل یا پیوند نمادین).
مانت‌های زیرمسیر یک قابلیت تسهیلاتی معادل سوار کردن \f[V]/\f[R] و
تغییر دایرکتوری هستند: آن‌ها به همان VFS زیرین و همان هندل‌های فایل
دسترسی مشترک دارند، بنابراین کلاینت را از هم‌سطح‌ها یا
والدینِ زیردایرکتوری سوارشده مجزا (ایزوله) نمی‌کنند.
.PP
اگر \f[V]--vfs-metadata-extension\f[R] در حال استفاده باشد، برای
\f[V]--nfs-cache-type disk\f[R] و \f[V]--nfs-cache-type cache\f[R]،
فایل‌های فراداده دارای هندل فایل والد به همراه پسوند
\f[V]0x00, 0x00, 0x00, 0x01\f[R] خواهند بود.
این بدان معناست که در صورت تمایل می‌توان آن‌ها را مستقیماً از روی هندل فایل والد جستجو کرد.
.PP
این دستور تنها روی سکوهای Unix در دسترس است..SS "VFS \- سامانه فایل مجازی (Virtual File System)"
.PP
این دستور از لایهٔ VFS استفاده می‌کند.
این لایه، اشیای ذخیره‌سازی ابریِ مورداستفادهٔ rclone را به ساختاری تبدیل می‌کند که بسیار شبیه به یک سامانه فایل دیسکی عمل می‌کند.
.PP
اشیای ذخیره‌سازی ابری ویژگی‌های متعددی دارند که مانند فایل‌های روی دیسک نیستند؛ برای نمونه نمی‌توانید اندازهٔ آن‌ها را افزایش دهید یا در میانه‌شان داده بنویسید، بنابراین لایهٔ VFS باید با این مسائل مقابله کند.
از آنجا که روش یگانه‌ای برای انجام این کار وجود ندارد، گزینه‌های گوناگونی تعبیه شده است که در ادامه توضیح داده می‌شوند.
.PP
لایهٔ VFS همچنین یک حافظهٔ پنهان دایرکتوری را پیاده‌سازی می‌کند؛ این لایه اطلاعات مربوط به فایل‌ها و دایرکتوری‌ها (اما نه محتوای داده‌ها) را در حافظه ذخیره (کش) می‌کند.
.SS "حافظهٔ پنهان دایرکتوری در VFS (VFS Directory Cache)"
.PP
با استفاده از پرچم \f[V]--dir-cache-time\f[R] می‌توانید مدت‌زمانی را که یک دایرکتوری باید به‌روز در نظر گرفته شود و نیازی به تازه‌سازی آن از backend نباشد، کنترل کنید.
تغییراتی که از طریق VFS اعمال می‌شوند بلافاصله نمایان شده یا باعث بی‌اعتباری حافظهٔ پنهان می‌شوند.
.IP
.nf
\f[C]
    --dir-cache-time duration   Time to cache directory entries for (default 5m0s)
    --poll-interval duration    Time to wait between polling for changes. Must be smaller than dir-cache-time. Only on supported remotes. Set to 0 to disable (default 1m0s)
\f[R]
.fi
.PP
با این وجود، تغییراتی که مستقیماً از طریق رابط وب یا نسخهٔ دیگری از rclone در فضای ذخیره‌سازی ابری ایجاد شوند، در صورتی که backend پیکربندی‌شده از پایش دوره‌ای (polling) برای تغییرات پشتیبانی نکند، تنها پس از انقضای حافظهٔ پنهان دایرکتوری شناسایی خواهند شد.
اگر backend از پایش تغییرات پشتیبانی کند، این تغییرات در بازهٔ زمانی پایش (polling interval) دریافت خواهند شد.
.PP
می‌توانید یک سیگنال \f[V]SIGHUP\f[R] به rclone ارسال کنید تا تمام حافظه‌های پنهان دایرکتوری را بدون در نظر گرفتن قدمت آن‌ها تخلیه کند.
با فرض اینکه تنها یک نمونه از rclone در حال اجرا باشد، می‌توانید حافظهٔ پنهان را به این صورت بازنشانی کنید:
.IP
.nf
\f[C]
kill -SIGHUP $(pidof rclone)
\f[R]
.fi
.PP
اگر rclone را با قابلیت کنترل از راه دور (remote control) پیکربندی کنید، می‌توانید از rclone rc برای تخلیهٔ کامل حافظهٔ پنهان دایرکتوری استفاده کنید:
.IP
.nf
\f[C]
rclone rc vfs/forget
\f[R]
.fi
.PP
یا برای فایل‌ها یا دایرکتوری‌های مشخص:
.IP
.nf
\f[C]
rclone rc vfs/forget file=path/to/file dir=path/to/dir
\f[R]
.fi
.SS "بافربندی فایل در VFS (VFS File Buffering)"
.PP
پرچم \f[V]--buffer-size\f[R] مقدار حافظه‌ای را که برای بافرکردن پیشاپیش داده‌ها استفاده می‌شود، تعیین می‌کند.
.PP
هر فایلِ باز همواره تلاش می‌کند مقدار دادهٔ مشخص‌شده را در حافظه نگه دارد.
داده‌های بافرشده به یک فایل باز محدود بوده و به اشتراک گذاشته نخواهند شد.
.PP
این پرچم یک حد بالا (سقف) برای حافظهٔ مورداستفاده به ازای هر فایل باز تعیین می‌کند.
بافر تنها برای داده‌هایی حافظه مصرف می‌کند که بارگیری شده‌اند اما هنوز خوانده نشده‌اند.
اگر بافر خالی باشد، تنها مقدار ناچیزی از حافظه مصرف خواهد شد.
.PP
حداکثر حافظهٔ استفاده‌شده توسط rclone برای بافربندی می‌تواند تا \f[V]--buffer-size * open files\f[R] برسد.
.SS "حافظهٔ پنهان فایل در VFS (VFS File Caching)"
.PP
این پرچم‌ها گزینه‌های حافظهٔ پنهان فایل در VFS را کنترل می‌کنند.
حافظهٔ پنهان فایل برای اینکه لایهٔ VFS با یک سامانه فایل معمولی سازگار به نظر برسد ضروری است.
این قابلیت را می‌توان به بهای از دست دادن بخشی از سازگاری غیرفعال کرد.
.PP
به‌عنوان مثال، اگر بخواهید به‌طور همزمان از یک فایل بخوانید و در آن بنویسید، باید حافظهٔ پنهان VFS را فعال کنید.
برای جزئیات بیشتر به ادامهٔ متن مراجعه کنید.
.PP
توجه داشته باشید که حافظهٔ پنهان VFS از backend حافظهٔ پنهان مجزاست و ممکن است دریابید که به یکی از آن‌ها یا هر دو نیاز دارید.
.IP
.nf
\f[C]
    --cache-dir string                     Directory rclone will use for caching.
    --vfs-cache-mode CacheMode             Cache mode off|minimal|writes|full (default off)
    --vfs-cache-max-age duration           Max time since last access of objects in the cache (default 1h0m0s)
    --vfs-cache-max-size SizeSuffix        Max total size of objects in the cache (default off)
    --vfs-cache-min-free-space SizeSuffix  Target minimum free space on the disk containing the cache (default off)
    --vfs-cache-poll-interval duration     Interval to poll the cache for stale objects (default 1m0s)
    --vfs-write-back duration              Time to writeback files after last use when using cache (default 5s)
\f[R]
.fi
.PP
اگر rclone با گزینهٔ \f[V]-vv\f[R] اجرا شود، مسیر حافظهٔ پنهان فایل را چاپ می‌کند.
فایل‌ها در ناحیهٔ حافظهٔ پنهان کاربری ذخیره می‌شوند که وابسته به سیستم‌عامل است، اما می‌توان آن را با \f[V]--cache-dir\f[R] یا با تنظیم متغیر محیطی مناسب مدیریت کرد.
.PP
این حافظهٔ پنهان ۴ حالت مختلف دارد که با \f[V]--vfs-cache-mode\f[R] انتخاب می‌شوند.
هرچه حالت حافظهٔ پنهان بالاتر باشد، سازگاری rclone بیشتر می‌شود اما به بهای مصرف فضای دیسک تمام خواهد شد.
.PP
توجه داشته باشید که فایل‌ها تنها زمانی در مقصد (remote) بازنویسی می‌شوند که بسته شده باشند و به مدت \f[V]--vfs-write-back\f[R] ثانیه مورد دسترسی قرار نگرفته باشند.
اگر rclone با وجود فایل‌هایی که هنوز بارگذاری نشده‌اند بسته شود یا با خطا متوقف گردد، این فایل‌ها در اجرای بعدی rclone با همان پرچم‌ها بارگذاری خواهند شد.
.PP
در صورت استفاده از \f[V]--vfs-cache-max-size\f[R] یا \f[V]--vfs-cache-min-free-space\f[R]، توجه داشته باشید که حجم حافظهٔ پنهان ممکن است به دو دلیل از این سهمیه‌ها فراتر رود.
نخست به این دلیل که این مقدار تنها در فواصل زمانیِ \f[V]--vfs-cache-poll-interval\f[R] بررسی می‌شود.
دوم به این دلیل که فایل‌های باز را نمی‌توان از حافظهٔ پنهان خارج کرد (evict نمود).
هنگامی که حجم از \f[V]--vfs-cache-max-size\f[R] یا \f[V]--vfs-cache-min-free-space\f[R] فراتر رود، rclone ابتدا تلاش می‌کند فایل‌هایی را که کمترین دسترسی را داشته‌اند از حافظهٔ پنهان خارج کند.
rclone کار را با فایل‌هایی آغاز می‌کند که برای طولانی‌ترین مدت مورد دسترسی قرار نگرفته‌اند.
این راهبرد تخلیهٔ حافظهٔ پنهان کارآمد است و احتمالاً فایل‌های مرتبط‌تر در حافظهٔ پنهان باقی خواهند ماند.
.PP
گزینهٔ \f[V]--vfs-cache-max-age\f[R] فایل‌ها را پس از سپری شدن زمان مشخص‌شده از آخرین دسترسی، از حافظهٔ پنهان خارج می‌کند؛ این سازوکار بر اساس زمان آخرین دسترسی است، نه زمانی که فایل برای نخستین بار به حافظهٔ پنهان اضافه شده است.
مقدار پیش‌فرض ۱ ساعت شروع به خارج کردن فایل‌هایی از حافظهٔ پنهان می‌کند که به مدت ۱ ساعت مورد دسترسی قرار نگرفته‌اند.
هنگامی که به یک فایل موجود در حافظهٔ پنهان دسترسی پیدا شود، زمان‌سنج ۱ ساعته به ۰ بازنشانی می‌شود و پیش از خارج کردن مجدد، ۱ ساعت دیگر منتظر می‌ماند.
زمان را با نمادهای استاندارد s، m، h، d و w مشخص کنید.
.PP
در صورت استفاده از \f[V]--vfs-cache-mode > off\f[R]، شما \f[B]نباید\f[R] دو نسخه از rclone را با یک حافظهٔ پنهان VFS مشترک و با remoteهای یکسان یا دارای هم‌پوشانی اجرا کنید.
انجام این کار بالقوه می‌تواند باعث خرابی داده‌ها شود.
می‌توانید با اختصاص دادن سلسله‌مراتب حافظهٔ پنهان اختصاصی به هر rclone از طریق \f[V]--cache-dir\f[R] این مشکل را دور بزنید.
اگر remoteهای مورداستفاده با یکدیگر تداخل و هم‌پوشانی نداشته باشند، نیازی به نگرانی در این مورد ندارید..SS --vfs-cache-mode off
.PP
در این حالت (پیش‌فرض)، کش مستقیماً از remote می‌خواند و بدون کش‌کردن هیچ داده‌ای روی دیسک، مستقیماً روی remote می‌نویسد.
.PP
این بدان معناست که برخی عملیات امکان‌پذیر نخواهند بود:
.IP \[bu] 2
فایل‌ها را نمی‌توان هم‌زمان هم برای خواندن و هم برای نوشتن باز کرد
.IP \[bu] 2
فایل‌های باز شده برای نوشتن امکان جستجو (seek) ندارند
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید پرچم O_TRUNC روی آن‌ها تنظیم شده باشد
.IP \[bu] 2
فایل‌های باز شده برای خواندن با O_TRUNC به صورت فقط-نوشتنی باز خواهند شد
.IP \[bu] 2
فایل‌های باز شده به صورت فقط-نوشتنی طوری رفتار خواهند کرد که گویی O_TRUNC اعمال شده است
.IP \[bu] 2
حالت‌های باز کردن O_APPEND و O_TRUNC نادیده گرفته می‌شوند
.IP \[bu] 2
در صورت شکست در بارگذاری، امکان تلاش مجدد وجود ندارد
.SS --vfs-cache-mode minimal
.PP
این حالت بسیار شبیه به \[dq]off\[dq] است، با این تفاوت که فایل‌های باز شده برای خواندن و نوشتن روی دیسک بافر می‌شوند.
این بدان معناست که فایل‌های باز شده برای نوشتن سازگاری بسیار بیشتری خواهند داشت، اما حداقل فضای دیسک مصرف می‌شود.
.PP
این عملیات امکان‌پذیر نیستند:
.IP \[bu] 2
فایل‌های باز شده به صورت فقط-نوشتنی امکان جستجو (seek) ندارند
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید پرچم O_TRUNC روی آن‌ها تنظیم شده باشد
.IP \[bu] 2
فایل‌های باز شده به صورت فقط-نوشتنی O_APPEND و O_TRUNC را نادیده خواهند گرفت
.IP \[bu] 2
در صورت شکست در بارگذاری، امکان تلاش مجدد وجود ندارد
.SS --vfs-cache-mode writes
.PP
در این حالت، فایل‌های باز شده به صورت فقط-خواندنی همچنان مستقیماً از remote خوانده می‌شوند؛ فایل‌های فقط-نوشتنی و خواندنی/نوشتنی ابتدا روی دیسک بافر می‌شوند.
.PP
این حالت باید از تمام عملیات عادی سیستم‌فایل پشتیبانی کند.
.PP
در صورت شکست بارگذاری، تلاش مجدد با فواصل زمانیِ به‌طور تصاعدی افزایشی تا سقف ۱ دقیقه انجام خواهد شد.
.SS --vfs-cache-mode full
.PP
در این حالت، تمام عملیات خواندن و نوشتن از دیسک و به دیسک بافر می‌شوند.
هنگامی که داده‌ها از remote خوانده می‌شوند نیز روی دیسک بافر خواهند شد.
.PP
در این حالت، فایل‌های موجود در کش از نوع sparse files (فایل‌های تُنُک) خواهند بود و rclone ردیابی خواهد کرد که کدام بخش‌ها از فایل‌ها دانلود شده‌اند.
.PP
بنابراین اگر برنامه‌ای فقط ابتدای هر فایل را بخواند، rclone تنها ابتدای فایل را بافر خواهد کرد.
این فایل‌ها در کش با اندازه کامل خود نمایش داده می‌شوند، اما فایل‌های تُنُک (sparse files) خواهند بود و تنها داده‌هایی که دانلود شده‌اند در آن‌ها وجود دارند.
.PP
این حالت باید از تمام عملیات عادی سیستم‌فایل پشتیبانی کند و در باقی موارد مشابه \f[V]--vfs-cache-mode\f[R] writes است.
.PP
هنگام خواندن یک فایل، rclone به اندازه \f[V]--buffer-size\f[R] به علاوه \f[V]--vfs-read-ahead\f[R] بایت جلوتر را پیش‌خوانی می‌کند.
مقدار \f[V]--buffer-size\f[R] در حافظه بافر می‌شود در حالی که \f[V]--vfs-read-ahead\f[R] روی دیسک بافر می‌گردد.
.PP
هنگام استفاده از این حالت، توصیه می‌شود که \f[V]--buffer-size\f[R] بیش از حد بزرگ تنظیم نشود و در صورت نیاز \f[V]--vfs-read-ahead\f[R] بزرگ‌تر تعیین گردد.
.PP
\f[B]مهم:\f[R] همه سیستم‌فایل‌ها از sparse files پشتیبانی نمی‌کنند؛ به‌ویژه سامانه‌های FAT/exFAT از آن پشتیبانی ندارند.
اگر دایرکتوری کش روی سیستم‌فایلی قرار داشته باشد که از sparse files پشتیبانی نمی‌کند، کارایی rclone به شدت افت خواهد کرد و در صورت تشخیص چنین موردی، یک پیام خطای ERROR ثبت می‌کند.
.SS انگشت‌نگاری (Fingerprinting)
.PP
بخش‌های مختلف VFS از انگشت‌نگاری استفاده می‌کنند تا بررسی کنند آیا نسخه فایل محلی نسبت به فایل روی remote تغییر کرده است یا خیر.
اثر انگشت‌ها از موارد زیر ساخته می‌شوند:
.IP \[bu] 2
اندازه (size)
.IP \[bu] 2
زمان آخرین تغییر (modification time)
.IP \[bu] 2
هش (hash)
.PP
در صورتی که روی یک شیء موجود باشند.
.PP
در برخی بک‌اندها، خواندن برخی از این ویژگی‌ها کُند است (به ازای هر شیء به یک فراخوانی API اضافی یا پردازش بیشتر نیاز دارند).
.PP
برای مثال، ویژگی \f[V]hash\f[R] در بک‌اندهای \f[V]local\f[R] و \f[V]sftp\f[R] کند است زیرا آن‌ها باید کل فایل را بخوانند و هش آن را محاسبه کنند؛ و \f[V]modtime\f[R] در بک‌اندهای \f[V]s3\f[R]، \f[V]swift\f[R]، \f[V]ftp\f[R] و \f[V]qinqstor\f[R] کند است زیرا برای دریافت آن نیاز به انجام یک فراخوانی API اضافی دارند.
.PP
اگر از پرچم \f[V]--vfs-fast-fingerprint\f[R] استفاده کنید، rclone عملیات کُند را در اثر انگشت لحاظ نخواهد کرد.
این کار از دقت انگشت‌نگاری می‌کاهد اما سرعت آن را به میزان زیادی افزایش داده و زمان باز شدن فایل‌های کش‌شده را بهبود می‌بخشد.
.PP
اگر یک کش vfs را روی بک‌اندهای \f[V]local\f[R]، \f[V]s3\f[R] یا \f[V]swift\f[R] اجرا می‌کنید، استفاده از این پرچم توصیه می‌شود.
.PP
توجه داشته باشید که با تغییر مقدار این پرچم، ممکن است اثر انگشت فایل‌های موجود در کش نامعتبر شده و نیاز به دانلود مجدد فایل‌ها باشد..SS خواندن تکه‌ای در VFS
.PP
هنگامی که rclone فایل‌ها را از یک ریموت می‌خواند، آن‌ها را به صورت تکه‌ای (chunk) دریافت می‌کند.
این بدان معناست که rclone به جای درخواست کل فایل، تنها تکهٔ مشخص‌شده را می‌خواند.
این کار می‌تواند با درخواست دادن تنها همان تکه‌هایی از ریموت که واقعاً خوانده می‌شوند، سهمیهٔ دانلود مصرفی را برای برخی ریموت‌ها کاهش دهد؛ هرچند این امر به بهای افزایش تعداد درخواست‌ها تمام می‌شود.
.PP
این پرچم‌ها رفتار تکه‌تکه کردن را کنترل می‌کنند:
.IP
.nf
\f[C]
    --vfs-read-chunk-size SizeSuffix        خواندن اشیاء مبدأ به صورت تکه‌ای (پیش‌فرض 128M)
    --vfs-read-chunk-size-limit SizeSuffix  حداکثر اندازه دو برابر شدن تکه‌ها (پیش‌فرض off)
    --vfs-read-chunk-streams int            تعداد جریان‌های موازی برای خواندن هم‌زمان
\f[R]
.fi
.PP
رفتار تکه‌تکه کردن بسته به پارامتر
\f[V]--vfs-read-chunk-streams\f[R] متفاوت خواهد بود.
.SS \f[V]--vfs-read-chunk-streams\f[R] == 0
.PP
برنامهٔ rclone خواندن را با تکه‌ای به اندازهٔ
\f[V]--vfs-read-chunk-size\f[R] آغاز می‌کند و سپس با هر بار خواندن، این اندازه را دو برابر می‌کند.
هنگامی که \f[V]--vfs-read-chunk-size-limit\f[R] مشخص شده و بزرگ‌تر
از \f[V]--vfs-read-chunk-size\f[R] باشد، اندازهٔ تکه برای هر فایلِ باز
تنها تا زمانی دو برابر می‌شود که به مقدار مشخص‌شده برسد.
اگر این مقدار \[dq]off\[dq] باشد (که حالت پیش‌فرض است)، محدودیت غیرفعال
بوده و اندازهٔ تکه‌ها به طور نامحدود افزایش می‌یابد.
.PP
با \f[V]--vfs-read-chunk-size 100M\f[R] و
\f[V]--vfs-read-chunk-size-limit 0\f[R]، بخش‌های زیر دانلود خواهند شد:
0-100M، 100M-200M، 200M-300M، 300M-400M و به همین ترتیب.
هنگامی که \f[V]--vfs-read-chunk-size-limit 500M\f[R] مشخص شود، نتیجه
0-100M، 100M-300M، 300M-700M، 700M-1200M، 1200M-1700M و الی آخر خواهد بود.
.PP
تنظیم \f[V]--vfs-read-chunk-size\f[R] روی \f[V]0\f[R] یا \[dq]off\[dq]
خواندن تکه‌ای را غیرفعال می‌کند.
.PP
تکه‌ها در حافظه بافر نخواهند شد.
.SS \f[V]--vfs-read-chunk-streams\f[R] > 0
.PP
برنامهٔ rclone تعداد \f[V]--vfs-read-chunk-streams\f[R] تکه با اندازهٔ
\f[V]--vfs-read-chunk-size\f[R] را به طور هم‌زمان می‌خواند.
اندازه برای هر بار خواندن ثابت باقی خواهد ماند.
.PP
این کار کارایی را روی اتصالات با تأخیر زیاد یا اتصالات با پهنای باند بسیار بالا به ذخیره‌سازهای شیء با کارایی بالا به طور چشمگیری بهبود می‌بخشد.
.PP
برای یافتن مقادیر بهینهٔ \f[V]--vfs-read-chunk-size\f[R] و
\f[V]--vfs-read-chunk-streams\f[R] نیاز به مقداری آزمون و خطا خواهد بود،
چرا که این مقادیر به بک‌اند (backend) مورد استفاده و میزان تأخیر تا آن بستگی دارند.
.PP
برای ذخیره‌سازهای شیء با کارایی بالا (مانند AWS S3)، یک نقطهٔ شروع منطقی می‌تواند
\f[V]--vfs-read-chunk-streams 16\f[R] و \f[V]--vfs-read-chunk-size 4M\f[R] باشد.
در آزمایش‌های انجام‌شده با AWS S3، کارایی تقریباً متناسب با مقدار تنظیم‌شدهٔ
\f[V]--vfs-read-chunk-streams\f[R] مقیاس‌پذیر بود.
.PP
تنظیمات مشابه باید برای اتصالات با تأخیر بالا نیز کار کند، اما بسته به میزان
تأخیر، ممکن است برای دستیابی به توان عملیاتی به مقادیر بیشتری از
\f[V]--vfs-read-chunk-streams\f[R] نیاز باشد.
.SS کارایی VFS
.PP
این پرچم‌ها می‌توانند برای فعال یا غیرفعال کردن قابلیت‌های VFS به دلایل
کارایی یا موارد دیگر استفاده شوند.
همچنین قابلیت خواندن تکه‌ای را ببینید.
.PP
به‌ویژه S3 و Swift سود بسیار زیادی از پرچم
\f[V]--no-modtime\f[R] می‌برند (یا برای تأثیری کمی متفاوت از
\f[V]--use-server-modtime\f[R] استفاده کنید)، زیرا هر بار خواندنِ زمان
تغییر، یک تراکنش مجزا مصرف می‌کند.
.IP
.nf
\f[C]
    --no-checksum     عدم مقایسه چکسام‌ها هنگام بارگذاری/دانلود.
    --no-modtime      عدم خواندن/نوشتن زمان تغییر (می‌تواند سرعت را افزایش دهد).
    --no-seek         عدم اجازه پرش (seeking) در فایل‌ها.
    --read-only       تنها اجازه دسترسی فقط‌خواندنی.
\f[R]
.fi
.PP
گاهی اوقات خواندن‌ها یا نوشتن‌ها خارج از ترتیب به rclone تحویل داده می‌شوند.
به جای پرش (seek)، rclone مدت زمان کوتاهی منتظر می‌ماند تا خواندن یا نوشتنِ
مرتب و متوالی بعدی از راه برسد.
این پرچم‌ها تنها زمانی تأثیرگذارند که از فایل کش روی دیسک استفاده نشود.
.IP
.nf
\f[C]
    --vfs-read-wait duration   مدت زمان انتظار برای خواندن متوالی پیش از پرش (پیش‌فرض 20ms)
    --vfs-write-wait duration  مدت زمان انتظار برای نوشتن متوالی پیش از بروز خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
هنگام استفاده از کش نوشتن VFS (مقدار writes یا full برای
\f[V]--vfs-cache-mode\f[R])، می‌توان پرچم سراسری \f[V]--transfers\f[R] را
برای تنظیم تعداد بارگذاری‌های موازی فایل‌های تغییریافته از کش تعیین کرد
(پرچم سراسری مرتبط \f[V]--checkers\f[R] هیچ تأثیری بر VFS ندارد).
.IP
.nf
\f[C]
    --transfers int  تعداد انتقال‌های هم‌زمان فایل (پیش‌فرض 4)
\f[R]
.fi.SS "پیوندهای نمادین (Symlinks)"
.PP
به‌طور پیش‌فرض VFS از پیوندهای نمادین پشتیبانی نمی‌کند.
با این حال این ویژگی می‌تواند با هر یک از پرچم‌های زیر فعال شود:
.IP
.nf
\f[C]
    --links      Translate symlinks to/from regular files with a \[aq].rclonelink\[aq] extension.
    --vfs-links  Translate symlinks to/from regular files with a \[aq].rclonelink\[aq] extension for the VFS
\f[R]
.fi
.PP
از آنجا که بیشتر سامانه‌های ذخیره‌سازی ابری مستقیماً از پیوندهای نمادین پشتیبانی نمی‌کنند، rclone پیوند نمادین را به عنوان یک فایل عادی با یک پسوند ویژه ذخیره می‌کند.
بنابراین فایلی که به عنوان یک پیوند نمادین با نام \f[V]link-to-file.txt\f[R] دیده می‌شود، در فضای ابری به صورت \f[V]link-to-file.txt.rclonelink\f[R] ذخیره خواهد شد و محتوای آن مسیر مقصد پیوند نمادین خواهد بود.
.PP
توجه داشته باشید که \f[V]--links\f[R] ترجمهٔ پیوندهای نمادین را به‌صورت سراسری در rclone فعال می‌کند \- این شامل هر بکاندی (backend) که از این مفهوم پشتیبانی کند (برای نمونه بکاند محلی) می‌شود.
\f[V]--vfs-links\f[R] تنها آن را برای لایهٔ VFS فعال می‌نماید.
.PP
این سازوکار با روش مورد استفاده توسط بکاند محلی با پرچم \f[V]--local-links\f[R] سازگار است (<https://rclone.org/local/#symlinks-junction-points>).
.PP
پرچم \f[V]--vfs-links\f[R] برای دستورهای \f[V]rclone mount\f[R]، \f[V]rclone nfsmount\f[R] و \f[V]rclone serve nfs\f[R] طراحی شده است.
.PP
این پرچم هنوز با سایر دستورهای \f[V]rclone serve\f[R] آزمایش نشده است.
.PP
یکی از محدودیت‌های پیاده‌سازی کنونی این است که انتظار دارد فراخواننده، پیوندهای فرعی (sub-symlinks) را تحلیل (resolve) کند.
برای نمونه، با فرض این درخت دایرکتوری:
.IP
.nf
\f[C]
\&.
├── dir
│\ \  └── file.txt
└── linked-dir -> dir
\f[R]
.fi
.PP
سامانهٔ VFS پیوند \f[V]linked-dir\f[R] را به‌درستی تحلیل می‌کند، اما \f[V]linked-dir/file.txt\f[R] را خیر.
این موضوع برای دستورهای آزمایش‌شده مشکلی ایجاد نمی‌کند، اما ممکن است برای دستورهای دیگر مسئله‌ساز باشد.
.PP
\f[B]توجه\f[R] داشته باشید که در پشتیبانی از پیوندهای نمادین یک مسئلهٔ حل‌نشده (گزارش باگ #8245 در <https://github.com/rclone/rclone/issues/8245>) وجود دارد که هنگام انتقال پیوندهای نمادین به دایرکتوری‌هایی که فایلی با همان نام در آن‌ها وجود دارد (یا برعکس)، باعث ایجاد فایل‌های تکراری می‌شود.
.SS "حساسیت به بزرگی و کوچکی حروف در VFS (VFS Case Sensitivity)"
.PP
فایل‌سیستم‌های لینوکس به بزرگی و کوچکی حروف حساس هستند (case-sensitive): دو فایل می‌توانند صرفاً در بزرگی و کوچکی حروف تفاوت داشته باشند، و هنگام باز کردن یک فایل باید دقیقاً همان حالت حروف استفاده شود.
.PP
فایل‌سیستم‌ها در ویندوز مدرن به بزرگی و کوچکی حروف حساس نیستند ولی حالت حروف را حفظ می‌کنند (case-insensitive but case-preserving): هرچند فایل‌های موجود را می‌توان با هر حالتی از حروف باز کرد، اما حالت دقیق حروفی که برای ساخت فایل استفاده شده است حفظ می‌شود و برنامه‌ها می‌توانند از آن پرس‌وجو کنند.
مجاز نیست که دو فایل در یک دایرکتوری یکسان صرفاً در بزرگی و کوچکی حروف با یکدیگر تفاوت داشته باشند.
.PP
معمولاً فایل‌سیستم‌ها در macOS به بزرگی و کوچکی حروف حساس نیستند.
امکان حساس کردن فایل‌سیستم‌های macOS به بزرگی و کوچکی حروف وجود دارد، اما این حالت پیش‌فرض نیست.
.PP
پرچم \f[V]--vfs-case-insensitive\f[R] در VFS نحوهٔ رفتار rclone با این دو وضعیت را کنترل می‌کند.
اگر مقدار آن \[dq]false\[dq] باشد، rclone نام فایل‌ها را همان‌گونه که هست به ریموت ارسال می‌کند.
اگر این پرچم \[dq]true\[dq] باشد (یا بدون مقدار در خط فرمان مشخص شود)، rclone ممکن است یک «اصلاح» (\[dq]fixup\[dq]) را مطابق آنچه در ادامه توضیح داده شده انجام دهد.
.PP
کاربر ممکن است نام فایلی را برای باز کردن/حذف/تغییر نام/غیره با حالتی از حروف متفاوت از آنچه روی ریموت ذخیره شده است مشخص کند.
اگر آرگومانی به یک فایل موجود با دقیقاً همان نام اشاره کند، حالت حروف فایل موجود روی دیسک استفاده خواهد شد.
با این حال، اگر نام فایلی با دقیقاً همان نام پیدا نشود اما نامی وجود داشته باشد که تنها در بزرگی و کوچکی حروف تفاوت دارد، rclone به‌طور شفاف نام را اصلاح می‌کند.
این اصلاح تنها زمانی رخ می‌دهد که یک فایل موجود درخواست شود.
حساسیت به بزرگی و کوچکی حروف برای نام فایل‌هایی که به تازگی توسط rclone ایجاد می‌شوند، توسط ریموت زیرین کنترل می‌شود.
.PP
توجه داشته باشید که حساسیت سیستم‌عامل اجراکنندهٔ rclone (مقصد) به بزرگی و کوچکی حروف ممکن است با حساسیت فایل‌سیستم ارائه‌شده توسط rclone (مبدأ) متفاوت باشد.
این پرچم کنترل می‌کند که آیا برای برآورده کردن نیازهای مقصد، «اصلاح» (\[dq]fixup\[dq]) انجام شود یا خیر.
.PP
اگر این پرچم در خط فرمان مشخص نشود، مقدار پیش‌فرض آن به سیستم‌عاملی که rclone روی آن اجرا می‌شود بستگی خواهد داشت: \[dq]true\[dq] در Windows و macOS، و در غیر این صورت \[dq]false\[dq].
اگر پرچم بدون مقدار ارائه شود، برابر با \[dq]true\[dq] خواهد بود.
.PP
پرچم \f[V]--no-unicode-normalization\f[R] کنترل می‌کند که آیا «اصلاح» (\[dq]fixup\[dq]) مشابهی برای نام‌فایل‌هایی که متفاوت هستند اما از نظر یونیکد هم‌ارزی کانونی دارند (<https://en.wikipedia.org/wiki/Unicode_equivalence>) انجام شود یا خیر.
عادی‌سازی یونیکد (Unicode normalization) می‌تواند به‌ویژه برای کاربران macOS سودمند باشد، چرا که این سیستم‌عامل قالب NFD را به قالب NFC که در اکثر پلتفرم‌های دیگر استفاده می‌شود ترجیح می‌دهد.
بنابراین برای جلوگیری از بروز مشکلات سازگاری در کدگذاری، اکیداً توصیه می‌شود که در macOS مقدار پیش‌فرض \f[V]false\f[R] حفظ شود.
.PP
در رویداد (احتمالاً نادر) وجود چندین نام‌فایل تکراری در یک دایرکتوری پس از اعمال عادی‌سازی بزرگی و کوچکی حروف و یونیکد، پرچم \f[V]--vfs-block-norm-dupes\f[R] امکان پنهان کردن این موارد تکراری را فراهم می‌کند.
این امر با کاهش کارایی همراه است، چرا که rclone هنگام فهرست کردن یک دایرکتوری باید تمام آن را برای یافتن موارد تکراری بررسی کند.
به همین دلیل، توصیه می‌شود در صورت عدم نیاز، این گزینه غیرفعال بماند.
با این وجود، کاربران macOS ممکن است استفاده از آن را در نظر داشته باشند، چرا که در غیر این صورت، اگر یک دایرکتوری در ریموت شامل هر دو نسخهٔ NFC و NFD از یک نام‌فایل باشد، وضعیت نامطلوبی رخ می‌دهد: هر دو نسخه از فایل در مانت (mount) قابل مشاهده خواهند بود و هر دو به نظر قابل ویرایش می‌آیند، اما ویرایش هر یک از نسخه‌ها در پشت صحنه در عمل فقط نسخهٔ NFD را ویرایش می‌کند.
پرچم \f[V]--vfs-block-norm-dupes\f[R] با شناسایی این سناریو، پنهان کردن موارد تکراری و ثبت خطا در گزارش، از این سردرگمی جلوگیری می‌کند (مشابه نحوهٔ برخورد با این موضوع در \f[V]rclone sync\f[R])..SS گزینه‌های دیسک VFS
.PP
این پرچم به شما امکان می‌دهد آمار مربوط به سیستم فایل را به‌صورت دستی تنظیم کنید.
این قابلیت می‌تواند زمانی که این آمار به‌صورت خودکار و صحیح خوانده نمی‌شوند، مفید باشد.
.IP
.nf
\f[C]
    --vfs-disk-space-total-size    تنظیم دستی اندازه کل فضای دیسک (مثال: 256G، پیش‌فرض: \-1)
\f[R]
.fi
.SS گزارش جایگزین بایت‌های مصرف‌شده
.PP
برخی از backendها، به‌ویژه S3، میزان بایت‌های استفاده‌شده را گزارش نمی‌دهند.
اگر نیاز دارید هنگام اجرای \f[V]df\f[R] روی سیستم فایل این اطلاعات در دسترس باشند، پرچم \f[V]--vfs-used-is-size\f[R] را به rclone ارسال کنید.
با تنظیم این پرچم، rclone به‌جای اتکا به backend جهت گزارش این اطلاعات، کل ریموت را مشابه \f[V]rclone size\f[R] پویش کرده و خودش فضای مصرفی کل را محاسبه می‌کند.
.PP
\f[B]هشدار\f[R]: بر خلاف \f[V]rclone size\f[R]، این پرچم فیلترها را نادیده می‌گیرد تا نتیجه دقیق باشد.
با این حال، این کار بسیار ناکارآمد است و ممکن است مستلزم فراخوانی‌های متعدد API و در نتیجه هزینه‌های اضافی شود.
تنها به‌عنوان آخرین راهکار و فقط همراه با فعال بودن کش از آن استفاده کنید.
.SS متادیتای VFS
.PP
اگر از پرچم \f[V]--vfs-metadata-extension\f[R] استفاده کنید، می‌توانید VFS را وادار کنید فایل‌هایی را که حاوی متادیتا (https://rclone.org/docs/#metadata) هستند، به‌صورت یک شیء JSON در معرض دید قرار دهد.
این فایل‌ها در فهرست دایرکتوری نمایش داده نمی‌شوند، اما می‌توان دستور \f[V]stat\f[R] را روی آن‌ها اجرا کرد و بازشان نمود، و پس از باز شدن، تا زمان منقضی شدن کش دایرکتوری در فهرست‌های دایرکتوری ظاهر \f[B]خواهند شد\f[R].
.PP
توجه داشته باشید که برخی از backendها متادیتا ایجاد نمی‌کنند مگر اینکه پرچم \f[V]--metadata\f[R] را مشخص کرده باشید.
.PP
برای مثال، با استفاده از \f[V]rclone mount\f[R] به همراه \f[V]--metadata --vfs-metadata-extension .metadata\f[R] به نتیجه زیر می‌رسیم:
.IP
.nf
\f[C]
$ ls -l /mnt/
total 1048577
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G

$ cat /mnt/1G.metadata
{
        \[dq]atime\[dq]: \[dq]2025-03-04T17:34:22.317069787Z\[dq],
        \[dq]btime\[dq]: \[dq]2025-03-03T16:03:37.708253808Z\[dq],
        \[dq]gid\[dq]: \[dq]1000\[dq],
        \[dq]mode\[dq]: \[dq]100664\[dq],
        \[dq]mtime\[dq]: \[dq]2025-03-03T16:03:39.640238323Z\[dq],
        \[dq]uid\[dq]: \[dq]1000\[dq]
}

$ ls -l /mnt/
total 1048578
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G
-rw-rw-r-- 1 user user        185 Mar  3 16:03 1G.metadata
\f[R]
.fi
.PP
اگر فایل فاقد متادیتا باشد به‌صورت \f[V]{}\f[R] برگردانده می‌شود، و در صورت بروز خطا در خواندن متادیتا، خطا به‌شکل \f[V]{\[dq]error\[dq]:\[dq]error string\[dq]}\f[R] بازگردانده خواهد شد.
.IP
.nf
\f[C]
rclone serve nfs remote:path [flags]
\f[R]
.fi
.SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
      --addr string                            آدرس IP:Port یا :Port برای مقید کردن کارساز به آن
      --dir-cache-time Duration                مدت‌زمان کش کردن مدخل‌های دایرکتوری (پیش‌فرض 5m0s)
      --dir-perms FileMode                     مجوزهای دایرکتوری (پیش‌فرض 777)
      --file-perms FileMode                    مجوزهای فایل (پیش‌فرض 666)
      --gid uint32                             بازنویسی فیلد gid تعیین‌شده توسط سیستم فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1000)
  -h, --help                                   راهنمای nfs
      --link-perms FileMode                    مجوزهای پیوند (پیش‌فرض 666)
      --nfs-cache-dir string                   دایرکتوری مورد استفاده کش هندل NFS در صورت تعیین
      --nfs-cache-handle-limit int             حداکثر هندل‌های فایل کش‌شده به‌طور هم‌زمان (حداقل 5) (پیش‌فرض 1000000)
      --nfs-cache-type memory|disk|symlink     نوع کش هندل NFS برای استفاده (پیش‌فرض memory)
      --no-checksum                            عدم مقایسه چک‌سام‌ها هنگام بارگذاری/بارگیری
      --no-modtime                             عدم خواندن/نوشتن زمان اصلاح (می‌تواند سرعت را افزایش دهد)
      --no-seek                                عدم اجازه جست‌وجو (seek) درون فایل‌ها
      --poll-interval Duration                 مدت انتظار بین بررسی دوره‌ای برای تغییرات، باید کمتر از dir-cache-time باشد و فقط روی ریموت‌های پشتیبانی‌شده عمل می‌کند (تنظیم 0 برای غیرفعال‌سازی) (پیش‌فرض 1m0s)
      --read-only                              فقط اجازه دسترسی خواندنی
      --uid uint32                             بازنویسی فیلد uid تعیین‌شده توسط سیستم فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1000)
      --umask FileMode                         بازنویسی بیت‌های مجوز تعیین‌شده توسط سیستم فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 002)
      --vfs-block-norm-dupes                   در صورت وجود نام‌های فایل تکراری در همان دایرکتوری (پس از نرمال‌سازی)، یک خطا ثبت کن و موارد تکراری را پنهان نما (ممکن است هزینه کارایی داشته باشد)
      --vfs-cache-max-age Duration             حداکثر زمان از آخرین دسترسی اشیاء درون کش (پیش‌فرض 1h0m0s)
      --vfs-cache-max-size SizeSuffix          حداکثر اندازه کل اشیاء درون کش (پیش‌فرض off)
      --vfs-cache-min-free-space SizeSuffix    حداقل فضای خالی هدف روی دیسک حاوی کش (پیش‌فرض off)
      --vfs-cache-mode CacheMode               حالت کش off|minimal|writes|full (پیش‌فرض off)
      --vfs-cache-poll-interval Duration       بازه بررسی دوره‌ای کش برای اشیاء بیات (پیش‌فرض 1m0s)
      --vfs-case-insensitive                   در صورت پیدا نشدن نام فایل، تطابق غیرحساس به حروف بزرگ و کوچک پیدا کن
      --vfs-disk-space-total-size SizeSuffix   مشخص کردن کل فضای دیسک (پیش‌فرض off)
      --vfs-fast-fingerprint                   استفاده از اثر انگشت‌های سریع (با دقت کمتر) برای تشخیص تغییرات
      --vfs-handle-caching Duration            مدت زمان زنده نگه‌داشتن هندل فایل و دانلودکننده‌ها پس از آخرین بستن (پیش‌فرض 5s)
      --vfs-links                              ترجمه پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
      --vfs-metadata-extension string          تنظیم پسوند برای خواندن متادیتا از آن
      --vfs-read-ahead SizeSuffix              خواندن پیش‌دستانه اضافی بیش از --buffer-size هنگام استفاده از cache-mode full
      --vfs-read-chunk-size SizeSuffix         خواندن اشیاء مبدأ در قالب چانک‌ها (پیش‌فرض 128Mi)
      --vfs-read-chunk-size-limit SizeSuffix   اگر بزرگ‌تر از --vfs-read-chunk-size باشد، پس از خواندن هر چانک اندازه آن را دو برابر کن تا به حد مجاز برسد (\[aq]off\[aq] نامحدود است) (پیش‌فرض off)
      --vfs-read-chunk-streams int             تعداد جریان‌های موازی برای خواندن هم‌زمان
      --vfs-read-wait Duration                 مدت زمان انتظار برای خواندن متوالی قبل از پرش (seek) (پیش‌فرض 20ms)
      --vfs-refresh                            تازه‌سازی بازگشتی کش دایرکتوری در پس‌زمینه هنگام شروع
      --vfs-used-is-size rclone size           استفاده از الگوریتم rclone size برای محاسبه اندازه مصرف‌شده (Used)
      --vfs-write-back Duration                مدت زمان بازنویسی فایل‌ها پس از آخرین استفاده هنگام استفاده از کش (پیش‌فرض 5s)
      --vfs-write-wait Duration                مدت زمان انتظار برای نوشتن متوالی پیش از صدور خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای مشاهده گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید..SS گزینه‌های فیلتر (Filter Options)
.PP
پرچم‌هایی برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های روی مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای مستثنی‌سازی فایل از فایل (از \- برای خواندن از stdin استفاده کنید)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل مبدأ از فایل (از \- برای خواندن از stdin استفاده کنید)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل مبدأ از فایل بدون هیچ پردازشی روی خطوط (از \- برای خواندن از stdin استفاده کنید)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (از \- برای خواندن از stdin استفاده کنید)
  -f, --filter stringArray                  افزودن یک قاعده فیلترسازی فایل
      --filter-from stringArray             خواندن الگوهای فیلترسازی فایل از یک فایل (از \- برای خواندن از stdin استفاده کنید)
      --hash-filter string                  افراز نام‌های فایل بر اساس هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف کوچک و بزرگ)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای مشمول‌سازی فایل از فایل (از \- برای خواندن از stdin استفاده کنید)
      --max-age Duration                    انتقال تنها فایل‌های جدیدتر از این بر حسب ثانیه یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض \-1)
      --max-size SizeSuffix                 انتقال تنها فایل‌های کوچک‌تر از این بر حسب KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای مستثنی‌سازی متاداده از فایل (از \- برای خواندن از stdin استفاده کنید)
      --metadata-filter stringArray         افزودن یک قاعده فیلترسازی متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلترسازی متاداده از یک فایل (از \- برای خواندن از stdin استفاده کنید)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای مشمول‌سازی متاداده از فایل (از \- برای خواندن از stdin استفاده کنید)
      --min-age Duration                    انتقال تنها فایل‌های قدیمی‌تر از این بر حسب ثانیه یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 انتقال تنها فایل‌های بزرگ‌تر از این بر حسب KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone serve (https://rclone.org/commands/rclone_serve) \- ارائه یک
ریموت بر بستر یک پروتکل.
.SH rclone serve restic
.PP
ارائه ریموت برای REST API نرم‌افزار restic.
.SS خلاصه دستور (SYNOPSIS)
.PP
اجرای یک وب‌سرور پایه برای ارائه یک ریموت روی REST backend API
نرم‌افزار restic از طریق HTTP.
این کار به restic اجازه می‌دهد تا از rclone به‌عنوان یک سازوکار ذخیره‌سازی
داده برای ارائه‌دهندگان ابری که restic به‌طور مستقیم از آن‌ها پشتیبانی
نمی‌کند، استفاده کند.
.PP
نرم‌افزار Restic (https://restic.net) یک برنامه خط فرمانی برای تهیه
نسخه پشتیبان است.
.PP
سرور خطاها را ثبت خواهد کرد.
برای مشاهده گزارش‌های دسترسی از \-v استفاده کنید.
.PP
گزینه \f[V]--bwlimit\f[R] برای انتقال فایل‌ها اعمال خواهد شد.
برای کنترل چاپ آمار از \f[V]--stats\f[R] استفاده کنید.
.SS راه‌اندازی rclone برای استفاده با restic
.PP
ابتدا یک ریموت برای ارائه‌دهنده ابری منتخب خود
راه‌اندازی کنید (https://rclone.org/docs/#configure).
.PP
پس از راه‌اندازی ریموت، بررسی کنید که به‌درستی کار می‌کند؛ برای نمونه
با \[dq]rclone lsd remote:\[dq].
ممکن است ریموت را چیزی غیر از \[dq]remote:\[dq] نام‌گذاری کرده باشید \-
تنها کافی است در دستورالعمل‌های زیر، نام انتخابی خود را جایگزین کنید.
.PP
اکنون سرور restic در rclone را اجرا کنید
.IP
.nf
\f[C]
rclone serve restic -v remote:backup
\f[R]
.fi
.PP
که در آن می‌توانید \[dq]backup\[dq] در دستور بالا را با هر مسیری در
ریموت که مایلید استفاده کنید، جایگزین نمایید.
.PP
به‌طور پیش‌فرض این سرویس روی \[dq]localhost:8080\[dq] ارائه می‌شود؛ می‌توانید
این مقدار را با استفاده از پرچم \f[V]--addr\f[R] تغییر دهید.
.PP
شاید مایل باشید این سرور را هنگام بوت راه‌اندازی کنید.
.PP
افزودن \f[V]--cache-objects=false\f[R] باعث می‌شود rclone از کش کردن
اشیای بازگردانده‌شده از فراخوانی List خودداری کند.
کش کردن معمولاً مطلوب است زیرا سرعت بارگیری اشیاء را افزایش می‌دهد، در
تعداد تراکنش‌ها صرفه‌جویی می‌کند و حافظه بسیار کمی مصرف می‌کند..SS راه‌اندازی restic برای استفاده از rclone
.PP
اکنون می‌توانید دستورالعمل‌های restic را در
(http://restic.readthedocs.io/en/latest/030_preparing_a_new_repo.html#rest-server)
برای راه‌اندازی restic دنبال کنید.
.PP
توجه داشته باشید که برای کار با rclone به restic نسخه 0.8.2 یا بالاتر نیاز
خواهید داشت.
.PP
برای مثال بالا، باید از
\[dq]http://localhost:8080/\[dq] به عنوان نشانی URL برای سرور REST استفاده کنید.
.PP
برای مثال:
.IP
.nf
\f[C]
$ export RESTIC_REPOSITORY=rest:http://localhost:8080
$ export RESTIC_PASSWORD=yourpassword
$ restic init
created restic backend 8b1a4b56ae at rest:http://localhost:8080

Please note that knowledge of your password is required to access
the repository. Losing your password means that your data is
irrecoverably lost.
$ restic backup /path/to/files/to/backup
scan [/path/to/files/to/backup]
scanned 189 directories, 312 files in 0:00
[0:00] 100.00%  38.128 MiB / 38.128 MiB  501 / 501 items  0 errors  ETA 0:00
duration: 0:00
snapshot 45c8fdd8 saved
\f[R]
.fi
.SS چندین مخزن
.PP
توجه داشته باشید که می‌توانید از این نقطه پایانی (endpoint) برای میزبانی چندین مخزن استفاده کنید.
این کار را با افزودن نام یک پوشه یا مسیر پس از URL انجام دهید.
دقت داشته باشید که این موارد \f[B]باید\f[R] با / خاتمه یابند.
به عنوان مثال:
.IP
.nf
\f[C]
$ export RESTIC_REPOSITORY=rest:http://localhost:8080/user1repo
# backup user1 stuff
$ export RESTIC_REPOSITORY=rest:http://localhost:8080/user2repo
# backup user2 stuff
\f[R]
.fi
.SS مخازن خصوصی
.PP
گزینه \f[V]--private-repos\f[R] می‌تواند برای محدود کردن کاربران به
مخازنی که با مسیر \f[V]/<username>/\f[R] آغاز می‌شوند استفاده شود.
.SS گزینه‌های سرور
.PP
از \f[V]--addr\f[R] برای تعیین آدرس IP و درگاهی که سرور باید روی آن
گوش دهد استفاده کنید؛ مانند \f[V]--addr 1.2.3.4:8000\f[R] یا
\f[V]--addr :8080\f[R] برای گوش دادن روی تمام IPها.
به‌طور پیش‌فرض تنها روی localhost گوش می‌دهد.
می‌توانید از پورت :0 استفاده کنید تا سیستم‌عامل یک درگاه آزاد را انتخاب کند.
.PP
اگر \f[V]--addr\f[R] را طوری تنظیم کنید که روی یک آدرس IP عمومی یا در دسترس در شبکه محلی (LAN)
گوش دهد، استفاده از احراز هویت توصیه می‌شود - برای اطلاعات بیشتر به
بخش بعدی مراجعه کنید.
.PP
می‌توانید با تنظیم URL روی
\f[V]unix:///path/to/socket\f[R] یا صرفاً با استفاده از یک نام مسیر مطلق، از سوکت یونیکس استفاده کنید.
.PP
گزینه \f[V]--addr\f[R] ممکن است برای گوش دادن روی چندین
IP/درگاه/سوکت تکرار شود.
فعال‌سازی از طریق سوکت (Socket activation) که در ادامه توضیح داده شده است نیز می‌تواند برای
دستیابی به همین هدف استفاده شود.
.PP
از \f[V]--server-read-timeout\f[R] و \f[V]--server-write-timeout\f[R] می‌توان
برای کنترل مهلت زمانی (timeout) روی سرور استفاده کرد.
توجه داشته باشید که این مقدار، کل زمان برای یک انتقال است.
.PP
گزینه \f[V]--max-header-bytes\f[R] حداکثر تعداد بایت‌هایی را که سرور
در سرآیند HTTP می‌پذیرد کنترل می‌کند.
.PP
گزینه \f[V]--response-header\f[R] می‌تواند برای تنظیم یک سرآیند HTTP برای همه
پاسخ‌ها استفاده شود و مقادیر موجود را بازنویسی می‌کند.
این پرچم برای افزودن چندین سرآیند قابل تکرار است.
از قالب \f[V]Header-Name: value\f[R] استفاده کنید.
.PP
گزینه \f[V]--baseurl\f[R] پیشوند URLای که rclone از آن سرویس می‌دهد را کنترل می‌کند.
به‌طور پیش‌فرض rclone از ریشه سرویس‌دهی خواهد کرد.
اگر از \f[V]--baseurl \[dq]/rclone\[dq]\f[R] استفاده کنید، rclone از
نشانی URLای که با \[dq]/rclone/\[dq] شروع می‌شود سرویس می‌دهد.
این ویژگی زمانی که می‌خواهید rclone serve را پروکسی کنید مفید است.
‏rclone به‌طور خودکار کاراکترهای \[dq]/\[dq] ابتدا و انتها را در
\f[V]--baseurl\f[R] درج می‌کند، بنابراین \f[V]--baseurl \[dq]rclone\[dq]\f[R]،
\f[V]--baseurl \[dq]/rclone\[dq]\f[R] و
\f[V]--baseurl \[dq]/rclone/\[dq]\f[R] همگی یکسان در نظر گرفته می‌شوند.
.PP
گزینه \f[V]--disable-zip\f[R] می‌تواند برای غیرفعال کردن قابلیت
دانلود به صورت فشرده (zip) تنظیم شود..SS پروتکل (Protocol)
.PP
سرور از HTTP/1.1 و HTTP/2 پشتیبانی می‌کند.
برای اتصالات TLS، به‌طور خودکار از HTTP/2 استفاده می‌شود.
برای اتصالات غیر TLS، پروتکل متنی HTTP/2 (یا h2c) پشتیبانی می‌شود که امکان بهره‌گیری از HTTP/2 بدون رمزنگاری را فراهم می‌کند.
.SS TLS (SSL)
.PP
به‌طور پیش‌فرض، ارائه محتوا روی http انجام می‌شود.
در صورت تمایل می‌توانید آن را روی https ارائه دهید.
برای این کار باید گزینه‌های \f[V]--cert\f[R] و \f[V]--key\f[R] را مشخص کنید.
اگر مایل به اعتبارسنجی گواهی سمت کلاینت هستید، باید \f[V]--client-ca\f[R] را نیز تعیین کنید.
.PP
هنگامی که TLS پیکربندی شود، هر شنونده‌ای که با \f[V]--addr\f[R] مشخص شده باشد TLS را ارائه می‌دهد.
یک شنونده خاص می‌تواند با پیشوند \f[V]http://\f[R] مشخص شود تا HTTP رمزنگاری‌نشده را روی آن نشانی ارائه دهد، یا با \f[V]tls://\f[R] تا صراحتاً اعلام کند که باید TLS را ارائه دهد.
استفاده از نشانی \f[V]tls://\f[R] بدون \f[V]--cert\f[R] و \f[V]--key\f[R] یک خطا است.
.PP
گزینه \f[V]--cert\f[R] باید روی مسیر فایلی حاوی یک گواهی با کدگذاری PEM، یا الحاق آن با گواهی CA تنظیم شود.
گزینه \f[V]--key\f[R] باید روی مسیر فایل حاوی کلید خصوصی با کدگذاری PEM تنظیم شود.
در صورت تنظیم \f[V]--client-ca\f[R]، این گزینه باید روی مسیر فایلی حاوی گواهی‌های مرجع صدور گواهی کلاینت (Client CA) با کدگذاری PEM تنظیم گردد.
.PP
گزینه \f[V]--min-tls-version\f[R] حداقل نسخه قابل‌قبول TLS است.
مقادیر معتبر عبارتند از \[dq]tls1.0\[dq]، \[dq]tls1.1\[dq]، \[dq]tls1.2\[dq] و \[dq]tls1.3\[dq] (پیش‌فرض \[dq]tls1.0\[dq]).
.SS فعال‌سازی سوکت (Socket activation)
.PP
به‌جای نشانی‌های شنود مشخص‌شده در بالا، rclone به تمام توصیف‌کننده‌های فایل (FDها) ارسال‌شده توسط مدیر سرویس، در صورت وجود، گوش فرا می‌دهد (و هر آرگومان ارائه‌شده توسط \f[V]--addr\f[R] را نادیده می‌گیرد).
.PP
این قابلیت به rclone اجازه می‌دهد تا به‌عنوان یک سرویس مبتنی بر فعال‌سازی سوکت عمل کند.
این سرویس می‌تواند با فایل‌های واحد .socket و .service به‌گونه‌ای که در
<https://www.freedesktop.org/software/systemd/man/latest/systemd.socket.html>
شرح داده شده است، پیکربندی شود.
.PP
فعال‌سازی سوکت را می‌توان به‌طور موردی با دستور \f[V]systemd-socket-activate\f[R] آزمایش کرد:
.IP
.nf
\f[C]
systemd-socket-activate -l 8000 -- rclone serve
\f[R]
.fi
.PP
این کار rclone را در اولین اتصال ورودی به درگاه 8000 از طریق TCP فعال می‌کند.
.SS احراز هویت (Authentication)
.PP
به‌طور پیش‌فرض، فایل‌ها بدون نیاز به ورود ارائه می‌شوند.
.PP
می‌توانید از یک فایل htpasswd استفاده کنید که از چندین کاربر پشتیبانی می‌کند، یا یک نام کاربری و گذرواژه منفرد را با گزینه‌های \f[V]--user\f[R] و \f[V]--pass\f[R] مشخص نمایید.
.PP
همچنین می‌توانید مدیریت احراز هویت را به پراکسی معکوس بسپارید و از نام کاربری ارائه‌شده در هدر پیکربندی‌شده با \f[V]--user-from-header\f[R] استفاده کنید (مانند \f[V]--user-from-header=x-remote-user\f[R]).
اطمینان حاصل کنید که پراکسی مورد اعتماد است و امکان جعل هدرها وجود ندارد، زیرا پیکربندی نادرست می‌تواند منجر به دسترسی غیرمجاز شود.
.PP
اگر هیچ‌یک از روش‌های احراز هویت بالا پیکربندی نشده باشد و با ارسال گزینه \f[V]--client-ca\f[R] به سرور، گواهی‌های کلاینت الزامی شده باشد، نام عمومی (common name) گواهی کلاینت به‌عنوان نام کاربری در نظر گرفته خواهد شد.
.PP
برای ارائه یک فایل htpasswd از \f[V]--htpasswd /path/to/htpasswd\f[R] استفاده کنید.
این فایل در قالب استاندارد apache بوده و از MD5، SHA1 و BCrypt برای احراز هویت پایه پشتیبانی می‌کند.
استفاده از Bcrypt توصیه می‌شود.
.PP
برای ایجاد یک فایل htpasswd:
.IP
.nf
\f[C]
touch htpasswd
htpasswd -B htpasswd user
htpasswd -B htpasswd anotherUser
\f[R]
.fi
.PP
فایل گذرواژه را می‌توان هنگام اجرای rclone به‌روزرسانی کرد.
.PP
برای تعیین realm احراز هویت از \f[V]--realm\f[R] استفاده کنید.
.PP
برای تغییر نمک درهم‌سازی (salt) گذرواژه از مقدار پیش‌فرض، از \f[V]--salt\f[R] استفاده کنید.
.IP
.nf
\f[C]
rclone serve restic remote:path [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --addr stringArray                آدرس IPaddress:Port یا :Port برای متصل کردن کارساز به آن (پیش‌فرض 127.0.0.1:8080)
      --allow-origin string             مبدأیی که درخواست بین‌دامنه (CORS) می‌تواند از آن اجرا شود
      --append-only                     عدم اجازه برای حذف داده‌های مخزن
      --baseurl string                  پیشوند برای URLها - برای ریشه خالی بگذارید
      --cache-objects                   ذخیره اشیاء فهرست‌شده در حافظه نهان (پیش‌فرض true)
      --cert string                     کلید TLS PEM (ترکیب گواهی و گواهی CA)
      --client-ca string                مرجع صدور گواهی کلاینت برای تأیید اعتبار کلاینت‌ها
  -h, --help                            راهنما برای restic
      --htpasswd string                 یک فایل htpasswd - در صورت عدم ارائه، احراز هویتی انجام نمی‌شود
      --key string                      کلید خصوصی TLS PEM
      --max-header-bytes int            حداکثر اندازه سربرگ درخواست (پیش‌فرض 4096)
      --min-tls-version string          حداقل نسخه TLS قابل قبول (پیش‌فرض \[dq]tls1.0\[dq])
      --pass string                     گذرواژه برای احراز هویت
      --private-repos                   کاربران فقط می‌توانند به مخزن خصوصی خود دسترسی داشته باشند
      --realm string                    قلمرو (Realm) برای احراز هویت
      --response-header stringArray     تنظیم سربرگ HTTP برای همه پاسخ‌ها، با بازنویسی مقادیر موجود
      --salt string                     سالت درهم‌سازی گذرواژه (پیش‌فرض \[dq]dlPL2MqE\[dq])
      --server-read-timeout Duration    مهلت زمانی خواندن داده توسط کارساز (پیش‌فرض 1h0m0s)
      --server-write-timeout Duration   مهلت زمانی نوشتن داده توسط کارساز (پیش‌فرض 1h0m0s)
      --stdio                           اجرای یک کارساز HTTP2 روی stdin/stdout
      --user string                     نام کاربری برای احراز هویت
      --user-from-header string         نام کاربری از یک سربرگ تعریف‌شده HTTP
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone serve (https://rclone.org/commands/rclone_serve) \- ارائه یک ریموت از طریق یک پروتکل.
.SH "rclone serve s3"
.PP
ارائه remote:path بر بستر s3.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
دستور \f[V]serve s3\f[R] یک کارساز ساده s3 پیاده‌سازی می‌کند که یک ریموت را از طریق s3 ارائه می‌دهد.
این خروجی را می‌توان با یک کلاینت s3 مشاهده کرد، یا می‌توانید یک ریموت از نوع s3‏ (https://rclone.org/s3) بسازید تا با rclone در آن بخوانید و بنویسید.
.PP
دستور \f[V]serve s3\f[R] به عنوان \f[B]آزمایشی (Experimental)\f[R] در نظر گرفته می‌شود، بنابراین با احتیاط از آن استفاده کنید.
.PP
کارساز S3 از احراز هویت با Signature Version 4 پشتیبانی می‌کند.
کافی است از \f[V]--auth-key accessKey,secretKey\f[R] استفاده کرده و سربرگ \f[V]Authorization\f[R] را به درستی در درخواست تنظیم کنید.
(مستندات AWS را ببینید (https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html)).
.PP
گزینهٔ \f[V]--auth-key\f[R] می‌تواند برای چندین جفت احراز هویت تکرار شود.
اگر \f[V]--auth-key\f[R] ارائه نشود، \f[V]serve s3\f[R] دسترسی ناشناس را مجاز خواهد دانست.
.PP
به عنوان روش جایگزین، \f[V]--auth-proxy\f[R] می‌تواند برای جستجوی کلید مخفی (secret) هر access key ID و انتخاب backend متناظر با آن استفاده شود (بخش Auth Proxy در زیر را ببینید).
هنگامی که پروکسی احراز هویت در حال استفاده است، \f[V]--auth-key\f[R] نادیده گرفته می‌شود و هر درخواست باید با کلید مخفی‌ای که پروکسی برای آن access key ID برمی‌گرداند، امضا شود.
.PP
مانند تمام پرچم‌های rclone، گزینهٔ \f[V]--auth-key\f[R] می‌تواند از طریق متغیرهای محیطی، در این مورد \f[V]RCLONE_AUTH_KEY\f[R]، تنظیم شود.
از آنجا که این پرچم می‌تواند تکرار شود، ورودی به \f[V]RCLONE_AUTH_KEY\f[R] با قالب CSV کدگذاری می‌شود.
از آنجا که \f[V]accessKey,secretKey\f[R] شامل ویرگول است، به این معنی است که باید درون علامت نقل‌قول قرار گیرد.
.IP
.nf
\f[C]
export RCLONE_AUTH_KEY=\[aq]\[dq]user,pass\[dq]\[aq]
rclone serve s3 ...
\f[R]
.fi
.PP
یا برای ارائه چندین هویت:
.IP
.nf
\f[C]
export RCLONE_AUTH_KEY=\[aq]\[dq]user1,pass1\[dq],\[dq]user2,pass2\[dq]\[aq]
rclone serve s3 ...
\f[R]
.fi
.PP
تنظیم این متغیر بدون علامت نقل‌قول خطایی تولید خواهد کرد.
.PP
لطفاً توجه داشته باشید که برخی از کلاینت‌ها ممکن است به نقاط پایانی با HTTPS نیاز داشته باشند.
برای اطلاعات بیشتر مستندات SSL را ببینید.
.PP
این دستور از حافظه نهان دایرکتوری VFS استفاده می‌کند.
تمام قابلیت‌ها با \f[V]--vfs-cache-mode off\f[R] کار خواهند کرد.
استفاده از \f[V]--vfs-cache-mode full\f[R] (یا \f[V]writes\f[R]) می‌تواند برای ذخیرهٔ نهان محلی اشیاء جهت بهبود عملکرد به کار رود.
.PP
اگر می‌خواهید نام باکت (bucket) را به عنوان بخشی از نام میزبان استفاده کنید (مانند mybucket.local)، از \f[V]--force-path-style=false\f[R] استفاده کنید.
.PP
اگر می‌خواهید درهم‌سازی استفاده‌شده برای \f[V]ETag\f[R] را تغییر دهید، از \f[V]--etag-hash\f[R] استفاده کنید.
توجه داشته باشید که استفاده از هر چیزی به جز \f[V]MD5\f[R] (پیش‌فرض) احتمالاً برای کلاینت‌های S3 که به MD5 بودن Etag متکی هستند، مشکل ایجاد می‌کند..SS شروع سریع (Quickstart)
.PP
برای یک راه‌اندازی ساده، جهت ارائه‌ی \f[V]remote:path\f[R] روی s3، کارگزار را به این صورت اجرا کنید:
.IP
.nf
\f[C]
rclone serve s3 --auth-key ACCESS_KEY_ID,SECRET_ACCESS_KEY remote:path
\f[R]
.fi
.PP
برای نمونه، جهت استفاده از یک پوشه‌ی ساده در سیستم‌فایل، کارگزار را با دستوری مانند این اجرا کنید:
.IP
.nf
\f[C]
rclone serve s3 --auth-key ACCESS_KEY_ID,SECRET_ACCESS_KEY local:/path/to/folder
\f[R]
.fi
.PP
فایل \f[V]rclone.conf\f[R] برای کارگزار می‌تواند به این شکل باشد:
.IP
.nf
\f[C]
[local]
type = local
\f[R]
.fi
.PP
با این حال، پیکربندی \f[V]local\f[R] اختیاری است.
اگر کارگزار را با یک \f[V]remote:path\f[R] مانند \f[V]/path/to/folder\f[R] (بدون پیشوند \f[V]local:\f[R] و بدون فایل \f[V]rclone.conf\f[R]) اجرا کنید، rclone به یک پیکربندی پیش‌فرض رجوع می‌کند که به صورت یک هشدار در گزارش‌ها (logs) قابل مشاهده خواهد بود؛ اما با این وجود به کار خود ادامه خواهد داد.
.PP
این مورد با پیکربندی ریموت یک کلاینت rclone که به شکل زیر تعریف شده باشد سازگار است:
.IP
.nf
\f[C]
[serves3]
type = s3
provider = Rclone
endpoint = http://127.0.0.1:8080
access_key_id = ACCESS_KEY_ID
secret_access_key = SECRET_ACCESS_KEY
\f[R]
.fi
.SS بارگذاری اشیاء (PUT)
.PP
یک بارگذاری \f[V]PutObject\f[R] تنها در صورت موفقیت، شیء موجود در کلید مربوطه را به صورت اتمیک (atomic) تغییر می‌دهد؛ یک PUT ناموفق یا متوقف‌شده، نه شیء ذخیره‌شده‌ی قبلی در آن کلید را حذف می‌کند و نه روی آن بازنویسی انجام می‌دهد، و هرگز شیء ناقصی را در آن نمایان باقی نمی‌گذارد.
.PP
ریموت‌هایی که بارگذاری را به صورت اتمیک انجام می‌دهند (مانند ذخیره‌سازهای شیء نظیر \f[V]s3\f[R])، به صورت مستقیم و جریانی (stream) به مقصد فرستاده می‌شوند.
در ریموت‌هایی که در غیر این صورت بارگذاری ناقص در آن‌ها نمایان می‌شد (مانند \f[V]local\f[R])، و هر زمان که \f[V]--vfs-cache-mode\f[R] بر روی \f[V]writes\f[R] یا بالاتر تنظیم شده باشد، بارگذاری در یک شیء موقت نوشته می‌شود که در صورت موفقیت، تغییر نام یافته و جایگزین می‌شود؛ این ریموت‌ها برای انجام این کار باید از انتقال یا کپی سمت کارگزار پشتیبانی کنند (تقریباً همگی پشتیبانی می‌کنند \- بدون انتقال یا کپی، بارگذاری به صورت مستقیم نوشته می‌شود و یک PUT ناموفق ممکن است شیء ناقصی را در کلید به جا بگذارد).
اگر فرایند \f[V]serve s3\f[R] در میانه بارگذاری متوقف (kill) شود، ممکن است شیء موقت (که نام آن با پیشوند \f[V].rclone_temp_put_\f[R] آغاز می‌شود) باقی بماند؛ این شیء از فهرست‌های S3 پنهان است اما باید به صورت دستی حذف شود.
.SS بارگذاری‌های چندبخشی (Multipart uploads)
.PP
بارگذاری‌های چندبخشی به ترتیب شماره‌ی بخش‌ها در یک شیء موقت نوشته می‌شوند که پس از اتمام، در سمت کارگزار تغییر نام یافته و جایگزین می‌شود؛ بنابراین بارگذاری اتمیک خواهد بود.
شیء موجود در کلید، تنها در صورت تکمیل موفقیت‌آمیز تغییر می‌یابد.
یک بارگذاری ناموفق یا لغو شده هرگز بر روی اشیاء ذخیره‌شده‌ی قبلی با آن نام تأثیر نمی‌گذارد و شیءِ بخشی بارگذاری‌شده هرگز با آن نام نمایان نمی‌شود.
.PP
با حالت پیش‌فرض \f[V]--vfs-cache-mode off\f[R]، دستور \f[V]serve s3\f[R] هر بارگذاری چندبخشی را به ترتیب شماره‌ی بخش‌ها، به صورت یک بارگذاری جریانی واحد به ریموت زیرین \f[B]جریان‌سازی (stream)\f[R] می‌کند، بنابراین کل فایل هرگز در حافظه بافر نمی‌شود.
مصرف حافظه محدود به بخش‌های در حال انتقال باقی می‌ماند.
سپس ریموت بارگذاری داخلی خود را انجام می‌دهد (برای نمونه بارگذاری چندبخشی اختصاصی خود، باز هم با حافظه محدود).
ریموت‌هایی که از بارگذاری‌های جریانی پشتیبانی نمی‌کنند (آن‌هایی که باید اندازه فایل را پیش از شروع بارگذاری بدانند، مانند \f[V]onedrive\f[R]، \f[V]pcloud\f[R]، \f[V]jottacloud\f[R]، \f[V]mailru\f[R]، \f[V]opendrive\f[R]، \f[V]putio\f[R]، \f[V]protondrive\f[R] و \f[V]zoho\f[R]) در عوض بخش‌ها را در یک فایل موقت روی \f[B]دیسک محلی\f[R] اسپول (spool) می‌کنند، و پس از اتمام که اندازه مشخص شد بارگذاری می‌شوند؛ بنابراین به جای حافظه، به فضای دیسک محلی برای بزرگ‌ترین اشیاء در حال انتقال نیاز دارند.
.PP
با \f[V]--vfs-cache-mode writes\f[R] (یا \f[V]full\f[R]) بخش‌ها در یک فایل موقت در حافظه‌ی نهان VFS نوشته شده و از طریق پس‌نویسی (write-back) سامانه VFS بارگذاری می‌شوند \- بخش بارگذاری‌های چندبخشی و حافظه نهان VFS را در ادامه ببینید.
.PP
تغییر نام و جایگزینی نیازمند آن است که ریموت از انتقال یا کپی سمت کارگزار پشتیبانی کند، که تقریباً همگی پشتیبانی می‌کنند.
این تغییر نام در بیشتر ریموت‌ها کم‌هزینه است، اما در ذخیره‌سازهای شیء فاقد تغییر نام واقعی (مانند خود \f[V]s3\f[R]) انتقال به صورت کپی سمت کارگزار و سپس حذف کل شیء انجام می‌شود که برای اشیاء بزرگ ممکن است زمان‌بر بوده و نیازمند فراخوانی‌های متعدد API باشد.
بارگذاری‌های چندبخشی هم‌روند روی یک کلید یکسان (که S3 آن را مجاز می‌داند) ایمن هستند.
هر یک شیء موقت خود را می‌نویسد و هرکدام که در آخر کامل شود برنده است و اعمال خواهد شد.
.PP
در معدود ریموت‌هایی که نه از انتقال و نه از کپی سمت کارگزار پشتیبانی نمی‌کنند، بخش‌ها مستقیماً در شیء مقصد نوشته می‌شوند و هرگز در حافظه بافر نمی‌شوند.
این کار به بهای از دست رفتن بخشی از اتمیک بودن تمام می‌شود \- شیء ناقص در هنگام بارگذاری با نام نهایی‌اش قابل مشاهده است، درست همان‌طور که برای یک PUT معمولی شیء در چنین ریموت‌هایی رخ می‌دهد، و بارگذاری‌های چندبخشی هم‌روند روی یک کلید یکسان، بر روی همان شیء می‌نویسند و ممکن است داده‌ها تداخل پیدا کنند.
یک بارگذاری ناموفق یا لغو شده همچنان اشیاء از قبل موجود را دست‌نخورده باقی می‌گذارد، مشروط بر اینکه ریموت به صورت اتمیک بارگذاری کند و حافظه نهان VFS غیرفعال باشد؛ در ریموتی که بارگذاری‌های ناقص قابل مشاهده هستند، ممکن است داده‌های ناقصی در کلید باقی بماند (مانند یک PUT معمولی در آن)، و با \f[V]--vfs-cache-mode writes\f[R] (یا \f[V]full\f[R])، عملیات نوشتن در حافظه نهان لغو نمی‌شود، بنابراین داده‌های ناقص بارگذاریِ لغو شده به گونه‌ای که گویی تکمیل شده است، به ریموت پس‌نویسی می‌شود.
.PP
\f[B]قابلیت‌ها (Features)\f[R]
.IP \[bu] 2
کل شیء هرگز در حافظه بافر نمی‌شود؛ مصرف حافظه بر اساس بخش‌های در حال انتقال محدود می‌شود، نه اندازه کل بارگذاری.
.IP \[bu] 2
بخش‌ها می‌توانند هر اندازه‌ای داشته باشند.
کلاینت‌هایی که بخش‌هایی با اندازه‌ی یکدست تولید نمی‌کنند به خوبی کار می‌کنند \- برای نمونه، ابزارهای پشتیبان‌گیری PostgreSQL مانند \f[B]pgBarman\f[R] و \f[B]pgBackRest\f[R]، که به محض رشد بافر بارگذاری بیش از اندازه تکه (chunk size)، آن را تخلیه می‌کنند؛ بنابراین هر بخش برابر است با اندازه تکه به اضافه‌ی مقداری سرریز متغیر.
.IP \[bu] 2
به ازای هر اندازه بخشی با \f[V]crypt\f[R] کار می‌کند، زیرا شیء به عنوان یک جریان پیوسته رمزگذاری می‌شود.
.IP \[bu] 2
شیء مقصد تنها به صورت اتمیک و هنگام تکمیل تغییر می‌یابد: یک بارگذاری لغو شده یا ناموفق، اشیاء از پیش موجود با همان نام را دست‌نخورده باقی می‌گذارد، و یک شیءِ بخشی بارگذاری‌شده هرگز نمایان نمی‌شود (به جز در معدود ریموت‌های فاقد انتقال یا کپی سمت کارگزار، طبق توضیحات بالا).
.IP \[bu] 2
بارگذاری‌های چندبخشی مانند هر بارگذاری دیگری از VFS عبور می‌کنند، بنابراین در آمار انتقال rclone نشان داده می‌شوند و از \f[V]--bwlimit\f[R] تبعیت می‌کنند.
.IP \[bu] 2
مستقل از بک‌اند (Backend-agnostic) \- تنها به پشتیبانی ریموت از انتقال یا کپی سمت کارگزار برای تغییر نام و جایگزینی نیاز دارد که تقریباً همه پشتیبانی می‌کنند؛ ریموتی که از بارگذاری جریانی پشتیبانی نمی‌کند، همان‌طور که در بالا گفته شد روی دیسک محلی اسپول انجام می‌دهد.
.PP
\f[B]محدودیت‌ها (Limitations)\f[R]
.IP \[bu] 2
بخش‌ها باید به ترتیب صعودی و متوالی شماره‌ی بخش (1, 2, 3, \&...) دریافت شوند.
بخش‌هایی که کلاینت به صورت هم‌روند یا نامرتب بارگذاری می‌کند، تا رسیدن نوبتشان بافر می‌شوند.
حافظه‌ی مورد استفاده برای این بافرینگ، در هر بارگذاری توسط \f[V]--multipart-streaming-buffer-limit\f[R] محدود می‌شود (پیش‌فرض \f[V]256M\f[R]، مقدار \f[V]0\f[R] برای بدون محدودیت): بخشی که حافظه بافر را از حد مجاز فراتر ببرد، تا زمان تخلیه جریان معلق می‌ماند؛ بنابراین کلاینتی که سریع‌تر از توان پذیرش ریموت بارگذاری می‌کند، به جای مصرف بی‌رویه حافظه کارگزار، با پس‌فشار (backpressure) مواجه می‌شود.
از آنجا که یک بخش معلق‌مانده درخواست HTTP خود را باز نگه می‌دارد، کلاینت‌هایی که حاصل‌ضرب هم‌روندی بارگذاری در اندازه تکه‌شان از این حد فراتر می‌رود، در صورت کند بودن ریموت ممکن است به مهلت زمانی خواندن (read timeout) طولانی‌تری نیاز داشته باشند.
شماره بخش‌های غیرمتوالی هنگام تکمیل رد می‌شوند.
برای کمترین میزان مصرف حافظه، کلاینت را طوری پیکربندی کنید که بخش‌ها را به ترتیب و ترجیحاً با هم‌روندی پایین بارگذاری کند.
.IP \[bu] 2
بخشی که قبل از اتمام دوباره بارگذاری شود \- معمولاً کلاینتی که پس از انقضای زمان تلاش مجدد می‌کند \- پذیرفته می‌شود: اگر نسخه قبلی هنوز در بافر باشد جایگزین می‌شود، و اگر از قبل جریان یافته باشد، بارگذاری مجددِ داده یکسان، عملیاتی بی‌اثر (no-op) خواهد بود.
آنچه امکان‌پذیر نیست، جایگزینی بخشی است که پیش‌تر جریان یافته با محتوای \f[I]متفاوت\f[R] \- که این درخواست رد خواهد شد.
یک خرابی در جریان ارسال به خود ریموت همچنان کل بارگذاری را لغو می‌کند و کلاینت باید آن را دوباره از ابتدا آغاز کند.
(بارگذاری داخلی خود ریموت همچنان تکه‌های داخلی‌اش را دوباره امتحان می‌کند.)
.IP \[bu] 2
بخش‌ها در قالب یک جریان متوالی سریالی می‌شوند، بنابراین دریافت داده (ingest) از کلاینت عملاً تک‌رشته‌ای است.
هنگام جریان‌سازی، بارگذاری اختصاصی ریموت به صورت هم‌روند با رسیدن بخش‌ها اجرا می‌شود؛ با اسپول روی دیسک محلی یا با حافظه نهان VFS، بارگذاری به ریموت تنها پس از تکمیل نهایی آغاز می‌شود..IP \[bu] 2
اگر \f[V]serve s3\f[R] در میانه بارگذاری متوقف (kill) شود، شیء موقت (که نام آن با پیشوند \f[V].rclone_temp_multipart_\f[R] شروع می‌شود) ممکن است باقی بماند؛ این شیء از فهرست‌های S3 پنهان است اما باید به صورت دستی حذف شود.
.SS بارگذاری‌های چندبخشی و حافظه نهان VFS (Multipart uploads and the VFS cache)
.PP
با \f[V]--vfs-cache-mode writes\f[R] (یا \f[V]full\f[R])، بارگذاری‌های چندبخشی اصلاً به ریموت استریم نمی‌شوند.
بخش‌ها به ترتیب شماره بخش، در یک فایل موقت در حافظه نهان VFS نوشته می‌شوند.
پس از تکمیل، نام فایل به جایگاه اصلی تغییر یافته و دقیقاً مانند PUT یک شیء ساده، توسط write-back در VFS بارگذاری می‌شود.
این فرآیند به پشتیبانی از بارگذاری جریانی (streaming upload) توسط ریموت نیازی ندارد.
تغییر نام معمولاً پیش از شروع بارگذاری در حافظه نهان رخ می‌دهد، اما VFS برای تغییر نام فایل‌ها نیازمند پشتیبانی ریموت از انتقال یا کپی سمت سرور است (و در صورتی که فایل موقت پیش‌تر بازنویسی شده باشد، مثلاً با \f[V]--vfs-write-back 0\f[R]، از آن استفاده می‌کند).
در ریموت‌هایی که هیچ‌کدام را ندارند، بخش‌ها مستقیماً تحت کلید نهایی در حافظه نهان نوشته می‌شوند: بارگذاری همچنان حافظه اصلی (RAM) را درگیر نمی‌کند، اما خاصیت اتمی بودن (atomicity) خود را از دست می‌دهد \- بارگذاریِ در حال انجام روی کلید قابل مشاهده است، و بارگذاریِ لغو شده پس از قرار گرفتن در حافظه نهان رها نمی‌شود، بنابراین داده‌های ناقص آن همانند یک شیء کامل به ریموت بازنویسی می‌شوند.
.PP
ریموت‌هایی که از \f[V]--vfs-cache-mode writes\f[R] بهره می‌برند:
.IP \[bu] 2
\f[B]ریموت‌های روی اتصالات کند یا غیرقابل‌اطمینان.\f[R] بروز خطا در بارگذاری جریانی کل بارگذاری چندبخشی را لغو می‌کند و کلاینت باید مجدداً از بخش اول شروع کند؛ بارگذاری write-back ناموفق بدون دخالت کلاینت توسط VFS مجدداً تلاش می‌شود (نگاه کنید به \f[V]--vfs-cache-max-age\f[R] و موارد مشابه).
همچنین دریافت داده از کلاینت به جای محدود شدن به سرعت ریموت، با سرعت دیسک محلی انجام می‌شود.
.IP \[bu] 2
\f[B]بارهای کاری که بلافاصله داده‌های نوشته‌شده را بازخوانی کرده یا رونویسی می‌کنند.\f[R]
شیء تکمیل‌شده در حافظه نهان باقی می‌ماند، بنابراین درخواست‌های بعدی \f[V]GET\f[R]/\f[V]HEAD\f[R] به صورت محلی پاسخ داده می‌شوند، و PUTهای ساده و بارگذاری‌های چندبخشی روی همان کلید از مدخل حافظه نهان یکسانی عبور می‌کنند، در نتیجه صرف‌نظر از روش بارگذاری، آخرین عملیات نوشتن تثبیت می‌شود (last write wins).
.PP
معایب و مصالحه‌های حافظه نهان VFS:
.IP \[bu] 2
کل شیء روی دیسک محلی قرار می‌گیرد، بنابراین حافظه نهان (\f[V]--cache-dir\f[R]) به فضایی معادل بزرگ‌ترین اشیاء در حال انتقال نیاز دارد؛ \f[V]--vfs-cache-max-size\f[R] نمی‌تواند فایل‌هایی را که هنوز در حال بارگذاری هستند پاک‌سازی (evict) کند.
.IP \[bu] 2
پاسخ \f[V]200 OK\f[R] برای \f[V]CompleteMultipartUpload\f[R] به این معنی است که داده‌ها با اطمینان در \f[B]حافظه نهان محلی\f[R] قرار دارند، نه روی ریموت \- همان سطح از پایداری که حافظه نهان به PUTهای معمولی ارائه می‌دهد.
اگر تأییدیه باید به این معنا باشد که داده به ریموت رسیده است (مثلاً برای بایگانی WAL)، از مقدار پیش‌فرض \f[V]--vfs-cache-mode off\f[R] استفاده کنید.
.IP \[bu] 2
بارگذاری روی ریموت تنها پس از تکمیل شروع می‌شود، نه هم‌زمان با رسیدن بخش‌ها؛ بنابراین داده‌ها دیرتر از روش جریانی به ریموت می‌رسند.
.IP \[bu] 2
اگر \f[V]serve s3\f[R] در میانه بارگذاری متوقف شود، فایل موقت در حافظه نهان باقی می‌ماند و بازیابی حافظه نهان VFS در راه‌اندازی مجدد، آن را به عنوان یک شیء موقت (با پیشوند \f[V].rclone_temp_multipart_\f[R]) روی ریموت بارگذاری می‌کند؛ همانند مسیر جریانی، این شیء از فهرست‌های S3 پنهان است اما باید به صورت دستی حذف شود.
.SS پاک‌سازی اشیاء موقت (Cleaning up temporary objects)
.PP
اگر \f[V]serve s3\f[R] در میانه بارگذاری متوقف شود می‌تواند یک شیء موقت با پیشوند \f[V].rclone_temp_\f[R] بر جای بگذارد.
تمام این پیشوند رزرو شده است: هر شیئی که نام آن (آخرین بخش کلید که با \f[V]/\f[R] جدا شده) با \f[V].rclone_temp_\f[R] شروع شود از فهرست‌های S3 پنهان می‌گردد؛ بنابراین چنین نام‌هایی را به اشیاء واقعی اختصاص ندهید \- شیء موجود با چنین نامی از فهرست‌ها ناپدید می‌شود (هرچند مستقیماً از طریق کلیدش قابل دسترسی است: فقط فهرست‌ها نام‌های رزرو شده را پنهان می‌کنند، و عملیات \f[V]GET\f[R]، \f[V]HEAD\f[R] و \f[V]DELETE\f[R] روی کلید دقیق همچنان کار می‌کند).
یک شیء موقت هرگز حاوی داده‌های تأییدشده نیست \- بارگذاری‌هایی که شیء موقت آن‌ها باقی مانده هرگز به کلاینت تأیید نشده‌اند \- بنابراین حذف موارد قدیمی بدون خطر است:
.IP
.nf
\f[C]
rclone delete --min-age 24h --include \[dq].rclone_temp_*\[dq] remote:path
\f[R]
.fi
.PP
گزینه \f[V]--min-age\f[R] از بارگذاری‌های جاری محافظت می‌کند: مطمئن شوید این مقدار از طولانی‌ترین بارگذاری شما بیشتر باشد، به‌ویژه اگر چندین نمونه از \f[V]serve s3\f[R] از یک ریموت به صورت مشترک استفاده می‌کنند.
.PP
نسخه rclone v1.75 اشیاء چندبخشی موقت خود را \f[V].rclone_multipart_upload_*\f[R] نام‌گذاری می‌کرد؛ بقایای سرورهای قدیمی‌تر نیز از فهرست‌ها پنهان هستند و می‌توان آن‌ها را به همین شیوه پاک‌سازی کرد..SS بارگذاری‌های رهاشده (Abandoned uploads)
.PP
کلاینتی که یک بارگذاری چندبخشی (multipart upload) را آغاز کرده و بدون تکمیل یا لغو آن ناپدید شود، در غیر این صورت منابع را تا ابد در اشغال خود نگه می‌دارد.
.PP
بنابراین، بارگذاری چندبخشی ناتمامی که به مدت \f[V]--multipart-expiry\f[R] (پیش‌فرض \f[V]24h\f[R]) هیچ فعالیتی نداشته باشد، لغو و پاک‌سازی می‌شود؛ دقیقاً مانند زمانی که کلاینت دستور \f[V]AbortMultipartUpload\f[R] را فراخوانی کرده باشد، و یک پیام \f[V]NOTICE\f[R] نیز در لاگ ثبت می‌گردد.
.PP
بارگذاری‌ای که دریافت بخشی از آن همچنان در جریان است هرگز منقضی نمی‌شود، حتی اگر آن بخش بسیار آهسته دریافت شود؛ همچنین تکمیل هر بخش زمان‌سنج را مجدداً بازنشانی می‌کند، بنابراین زمان انقضا تنها باید از مکث‌های کلاینت \f[I]بین\f[R] بخش‌ها طولانی‌تر باشد، نه کل فرایند بارگذاری.
.PP
عملیات دیرهنگام روی یک بارگذاری منقضی‌شده با خطای \f[V]NoSuchUpload\f[R] شکست می‌خورد؛ همانند رفتاری که در S3 واقعی هنگام لغو بارگذاری توسط یک قاعدهٔ چرخه حیات (lifecycle rule) رخ می‌دهد. برای نگهداری همیشگی بارگذاری‌های ناتمام، مقدار \f[V]--multipart-expiry 0\f[R] را تنظیم کنید.
.SS غیرفعال‌سازی پخش جریانی (Disabling streaming)
.PP
اگر گزینهٔ \f[V]--disable-multipart-streaming\f[R] را مشخص کنید، بارگذاری‌های چندبخشی در عوض توسط کتابخانهٔ زیربنایی S3 در \f[B]حافظه میان‌گیر (بافر) می‌شوند\f[R]: هر بخش در حافظه نگه‌داری شده و پس از تکمیل بارگذاری، کل شیء به یک‌باره نوشته می‌شود.
این کار محدودیت ترتیبی/پیوسته بودن بخش‌ها را برطرف می‌سازد تا بخش‌ها بتوانند با هر ترتیبی بارگذاری شوند، اما \f[B]مصرف حافظه با اندازهٔ بارگذاری افزایش می‌یابد\f[R]؛ از این رو تنها برای اشیاء کوچک مناسب است.
اولین باری که این وضعیت رخ دهد، یک پیام \f[V]NOTICE\f[R] یک‌باره ثبت می‌شود.
این پرچم تنها عاملی است که باعث میان‌گیری بارگذاری‌های چندبخشی در حافظه می‌شود؛ این کار هرگز به دلیل نبود قابلیت‌های ریموت انجام نمی‌گیرد.
در عوض، استفاده از \f[V]--vfs-cache-mode writes\f[R] را در نظر بگیرید که بارگذاری را در حافظهٔ پنهان VFS روی دیسک میان‌گیری می‌کند و نسبت به \f[V]--disable-multipart-streaming\f[R] اولویت دارد.
.SS باگ‌ها (BUGS)
.PP
کپی‌های چندبخشیِ سمت سرور کار نمی‌کنند (ببینید
#7454 (<https://github.com/rclone/rclone/issues/7454>)).
این عملیات‌ها زمان بسیار زیادی می‌برند و در نهایت با شکست مواجه می‌شوند.
آستانهٔ پیش‌فرض برای کپی‌های چندبخشی سمت سرور 5G است که حداکثر مقدار ممکن می‌باشد، بنابراین فایل‌های بزرگ‌تر از این اندازه در کپی سمت سرور ناموفق خواهند بود.
.PP
برای مشاهدهٔ فهرست فعلی باگ‌های \f[V]serve s3\f[R]، دسته‌بندی باگ‌های
serve s3 (<https://github.com/rclone/rclone/labels/serve%20s3>) را در GitHub ببینید.
.SS محدودیت‌ها (Limitations)
.PP
دستور \f[V]serve s3\f[R] با تمام دایرکتوری‌های موجود در ریشه به عنوان باکت (bucket) رفتار کرده و تمام فایل‌های موجود در ریشه را نادیده می‌گیرد.
می‌توانید از \f[V]CreateBucket\f[R] برای ایجاد پوشه‌ها در ریشه استفاده کنید، اما نمی‌توانید پوشه‌های خالی در زیر پوشه‌های دیگری که در ریشه نیستند ایجاد نمایید.
.PP
هنگام استفاده از \f[V]PutObject\f[R] یا \f[V]DeleteObject\f[R]، rclone به طور خودکار پوشه‌های خالی را ایجاد یا پاک‌سازی می‌کند.
اگر نمی‌خواهید پوشه‌های خالی به طور خودکار پاک‌سازی شوند، از \f[V]--no-cleanup\f[R] استفاده کنید.
.PP
هنگام استفاده از \f[V]ListObjects\f[R]، اگر جداکننده (delimiter) خالی باشد، rclone از \f[V]/\f[R] استفاده خواهد کرد.
این کار بدون تأثیر بر اکثر عملیات‌ها، درخواست‌های سمت بک‌اند را کاهش می‌دهد؛ اما اگر جداکننده چیزی غیر از \f[V]/\f[R] یا خالی باشد، rclone یک جستجوی بازگشتی کامل روی بک‌اند انجام می‌دهد که می‌تواند مدتی طول بکشد.
.PP
نسخه‌بندی (Versioning) در حال حاضر پشتیبانی نمی‌شود.
.PP
متادیتاها فقط در حافظه ذخیره می‌شوند، به جز متادیتای \f[V]mtime\f[R] در rclone که به عنوان زمان تغییر فایل تنظیم می‌شود.
.SS نام اشیاء (Object names)
.PP
دستور \f[V]serve s3\f[R] اشیاء را به عنوان فایل در بک‌اند ذخیره می‌کند، بنابراین کلیدهای شیء (object keys) به جای آن‌که به صورت رشته‌های مبهم (مانند AWS S3) در نظر گرفته شوند، به مسیرهای فایل نگاشت می‌شوند.
کلیدها باید در قالب مسیر استاندارد (canonical path) باشند: کلیدهایی که شامل بخش‌های مسیر \f[V]..\f[R] یا \f[V].\f[R]، اسلش‌های تکراری (\f[V]//\f[R])، یا اسلش در ابتدا یا انتها باشند، به جای این‌که نرمال‌سازی شوند با خطای \f[V]400 Bad Request\f[R] (\f[V]InvalidArgument\f[R]) رد می‌شوند؛ زیرا نرمال‌سازی آن‌ها می‌تواند باعث شود دو کلید مجزا به یک فایل اشاره کنند یا کلیدی به خارج از باکت هدایت شود.
این رفتار با سایر سرورهای S3 مانند MinIO مطابقت دارد..SS "عملیات‌های پشتیبانی‌شده (Supported operations)"
.PP
دستور \f[V]serve s3\f[R] در حال حاضر از عملیات‌های زیر پشتیبانی می‌کند.
.IP \[bu] 2
باکت (Bucket)
.RS 2
.IP \[bu] 2
\f[V]ListBuckets\f[R]
.IP \[bu] 2
\f[V]CreateBucket\f[R]
.IP \[bu] 2
\f[V]DeleteBucket\f[R]
.RE
.IP \[bu] 2
شیء (Object)
.RS 2
.IP \[bu] 2
\f[V]HeadObject\f[R]
.IP \[bu] 2
\f[V]ListObjects\f[R]
.IP \[bu] 2
\f[V]GetObject\f[R]
.IP \[bu] 2
\f[V]PutObject\f[R]
.IP \[bu] 2
\f[V]DeleteObject\f[R]
.IP \[bu] 2
\f[V]DeleteObjects\f[R]
.IP \[bu] 2
\f[V]CreateMultipartUpload\f[R]
.IP \[bu] 2
\f[V]CompleteMultipartUpload\f[R]
.IP \[bu] 2
\f[V]AbortMultipartUpload\f[R]
.IP \[bu] 2
\f[V]CopyObject\f[R]
.IP \[bu] 2
\f[V]UploadPart\f[R]
.RE
.PP
سایر عملیات‌ها خطای \f[V]Unimplemented\f[R] را بازمی‌گردانند.
.SS "احراز هویت (Authentication)"
.PP
به‌طور پیش‌فرض، فایل‌ها بدون نیاز به ورود ارائه می‌شوند.
.PP
می‌توانید از یک فایل htpasswd که چندین کاربر را پشتیبانی می‌کند استفاده کنید، یا با استفاده از گزینه‌های \f[V]--user\f[R] و \f[V]--pass\f[R] یک نام کاربری و گذرواژه تنظیم نمایید.
.PP
همچنین می‌توانید مدیریت احراز هویت را به پراکسی معکوس واگذار کرده و از نام کاربری ارائه‌شده در سرآیند پیکربندی‌شده با \f[V]--user-from-header\f[R] استفاده کنید (مانند \f[V]--user-from-header=x-remote-user\f[R]).
اطمینان حاصل کنید که پراکسی معتبر است و سرآیندها جعل نمی‌شوند، زیرا پیکربندی نادرست می‌تواند به دسترسی غیرمجاز منجر شود.
.PP
اگر هیچ‌یک از روش‌های احراز هویت فوق پیکربندی نشده باشند و گواهی‌های کلاینت از طریق گزینهٔ \f[V]--client-ca\f[R] ارائه‌شده به سرور الزامی شده باشند، نام عمومی (common name) گواهی کلاینت به‌عنوان نام کاربری در نظر گرفته می‌شود.
.PP
برای مشخص کردن یک فایل htpasswd از \f[V]--htpasswd /path/to/htpasswd\f[R] استفاده کنید.
این فایل از قالب استاندارد apache استفاده می‌کند و برای احراز هویت اولیه از MD5، SHA1 و BCrypt پشتیبانی می‌کند.
استفاده از Bcrypt توصیه می‌شود.
.PP
برای ایجاد یک فایل htpasswd:
.IP
.nf
\f[C]
touch htpasswd
htpasswd -B htpasswd user
htpasswd -B htpasswd anotherUser
\f[R]
.fi
.PP
فایل گذرواژه را می‌توان هنگام اجرای rclone نیز به‌روزرسانی کرد.
.PP
از گزینهٔ \f[V]--realm\f[R] برای تنظیم حوزهٔ احراز هویت (realm) استفاده کنید.
.PP
از گزینهٔ \f[V]--salt\f[R] برای تغییر سالت درهم‌سازی گذرواژه نسبت به مقدار پیش‌فرض استفاده کنید..SS "گزینه‌های سرور (Server options)"
.PP
از \f[V]--addr\f[R] برای تعیین این‌که سرور باید روی چه آدرس IP و درگاهی گوش فرا دهد استفاده کنید، به عنوان مثال \f[V]--addr 1.2.3.4:8000\f[R] یا \f[V]--addr :8080\f[R] برای گوش دادن روی تمام IPها.
به‌طور پیش‌فرض تنها روی localhost گوش می‌دهد.
می‌توانید از پورت :0 استفاده کنید تا به سیستم‌عامل اجازه دهید یک پورت دردسترس را انتخاب کند.
.PP
اگر \f[V]--addr\f[R] را طوری تنظیم کنید که روی یک آدرس IP عمومی یا قابل‌دسترسی از طریق شبکهٔ محلی (LAN) گوش دهد، استفاده از احراز هویت پیشنهاد می‌شود \- برای اطلاعات بیشتر بخش بعدی را ببینید.
.PP
می‌توانید با تنظیم آدرس روی \f[V]unix:///path/to/socket\f[R] یا صرفاً با استفاده از یک نام مسیر مطلق، از یک سوکت یونیکس استفاده کنید.
.PP
گزینهٔ \f[V]--addr\f[R] ممکن است برای گوش دادن روی چندین IP/پورت/سوکت تکرار شود.
فعال‌سازی سوکت (Socket activation) که در ادامه توضیح داده شده است، می‌تواند برای دستیابی به همین هدف نیز استفاده شود.
.PP
گزینه‌های \f[V]--server-read-timeout\f[R] و \f[V]--server-write-timeout\f[R] می‌توانند برای کنترل مهلت‌های زمانی در سرور استفاده شوند.
توجه داشته باشید که این مقدار، زمان کل برای یک انتقال است.
.PP
گزینهٔ \f[V]--max-header-bytes\f[R] حداکثر تعداد بایت‌هایی را که سرور در هدر HTTP می‌پذیرد کنترل می‌کند.
.PP
گزینهٔ \f[V]--response-header\f[R] می‌تواند برای تنظیم یک هدر HTTP برای همه پاسخ‌ها استفاده شود و مقادیر موجود را بازنویسی خواهد کرد.
این پرچم برای افزودن چندین هدر می‌تواند تکرار شود.
از قالب \f[V]Header-Name: value\f[R] استفاده کنید.
.PP
گزینهٔ \f[V]--baseurl\f[R] پیشوند URLای را که rclone از آن سرویس‌دهی می‌کند، کنترل می‌کند.
به‌طور پیش‌فرض rclone از ریشه سرویس‌دهی خواهد کرد.
اگر از \f[V]--baseurl \[dq]/rclone\[dq]\f[R] استفاده کنید، rclone از آدرسی که با \[dq]/rclone/\[dq] شروع می‌شود سرویس می‌دهد.
این ویژگی در صورتی که بخواهید برای سرویس rclone از پراکسی استفاده کنید، مفید است.
برنامه rclone به‌طور خودکار در ابتدا و انتهای \f[V]--baseurl\f[R] کاراکتر \[dq]/\[dq] اضافه می‌کند؛ بنابراین \f[V]--baseurl \[dq]rclone\[dq]\f[R]، \f[V]--baseurl \[dq]/rclone\[dq]\f[R] و \f[V]--baseurl \[dq]/rclone/\[dq]\f[R] همگی به یک شکل پردازش می‌شوند.
.PP
گزینهٔ \f[V]--disable-zip\f[R] می‌تواند برای غیرفعال کردن قابلیت بارگیری zip تنظیم شود.
.SS "پروتکل (Protocol)"
.PP
سرور از HTTP/1.1 و HTTP/2 پشتیبانی می‌کند.
پروتکل HTTP/2 به‌طور خودکار برای اتصالات TLS استفاده می‌شود.
برای اتصالات غیر TLS، پروتکل متنی HTTP/2 (h2c) پشتیبانی می‌شود که امکان استفاده از HTTP/2 را بدون رمزنگاری فراهم می‌سازد.
.SS "TLS (SSL)"
.PP
به‌طور پیش‌فرض سرویس‌دهی از طریق http خواهد بود.
در صورت تمایل می‌توانید روی https سرویس‌دهی کنید.
باید پرچم‌های \f[V]--cert\f[R] و \f[V]--key\f[R] را مشخص کنید.
اگر مایل به اعتبارسنجی گواهی سمت کلاینت هستید، باید \f[V]--client-ca\f[R] را نیز ارائه دهید.
.PP
هنگامی که TLS پیکربندی شد، هر شنونده‌ای که با \f[V]--addr\f[R] مشخص شده باشد با TLS سرویس می‌دهد.
یک شنونده می‌تواند با پیشوند \f[V]http://\f[R] مشخص شود تا HTTP رمزنگاری‌نشده را روی آن آدرس ارائه دهد، یا با پیشوند \f[V]tls://\f[R] تا صراحتاً بیان شود که باید حتماً TLS ارائه دهد.
استفاده از نشانی \f[V]tls://\f[R] بدون \f[V]--cert\f[R] و \f[V]--key\f[R] یک خطا محسوب می‌شود.
.PP
گزینهٔ \f[V]--cert\f[R] باید روی مسیر فایلی حاوی یک گواهی با کدگذاری PEM، یا الحاق آن با گواهی مرجع صدور گواهی (CA) تنظیم شود.
گزینهٔ \f[V]--key\f[R] باید روی مسیر فایلی با کلید خصوصی با کدگذاری PEM تنظیم شود.
در صورت تنظیم \f[V]--client-ca\f[R]، باید به مسیر فایلی شامل گواهی‌های مرجع صدور گواهی کلاینت با کدگذاری PEM اشاره کند.
.PP
گزینهٔ \f[V]--min-tls-version\f[R] حداقل نسخهٔ قابل قبول TLS است.
مقادیر معتبر عبارتند از \[dq]tls1.0\[dq]، \[dq]tls1.1\[dq]، \[dq]tls1.2\[dq] و \[dq]tls1.3\[dq] (پیش‌فرض \[dq]tls1.0\[dq]).
.SS "فعال‌سازی سوکت (Socket activation)"
.PP
به جای آدرس‌های شنیداری مشخص شده در بالا، rclone به تمام توصیف‌کننده‌های فایل (FDs) ارسال‌شده توسط مدیر سرویس (در صورت وجود) گوش خواهد داد (و هر آرگومان داده شده با \f[V]--addr\f[R] را نادیده می‌گیرد).
.PP
این امر به rclone اجازه می‌دهد به عنوان یک سرویس با فعال‌سازی از طریق سوکت (socket-activated) عمل کند.
می‌توان آن را با فایل‌های واحد (unit files) از نوع .socket و .service همان‌طور که در <https://www.freedesktop.org/software/systemd/man/latest/systemd.socket.html> شرح داده شده است، پیکربندی نمود.
.PP
فعال‌سازی سوکت را می‌توان به‌صورت موردی با دستور \f[V]systemd-socket-activate\f[R] آزمایش کرد:
.IP
.nf
\f[C]
systemd-socket-activate -l 8000 -- rclone serve
\f[R]
.fi
.PP
این کار در نخستین اتصال به پورت 8000 روی TCP، برنامه rclone را از طریق سوکت فعال خواهد کرد..SS سامانه فایل مجازی (VFS - Virtual File System)
.PP
این دستور از لایهٔ VFS استفاده می‌کند.
این لایه، اشیاء ذخیره‌سازی ابری مورد استفادهٔ rclone را به چیزی تبدیل می‌کند که بسیار شبیه به یک سامانه فایل دیسکی به نظر می‌رسد.
.PP
اشیاء ذخیره‌سازی ابری ویژگی‌های متعددی دارند که مشابه فایل‌های روی دیسک نیستند \- نمی‌توان طول آن‌ها را افزایش داد یا در میانهٔ آن‌ها نوشت، بنابراین لایهٔ VFS باید این موارد را مدیریت کند.
از آنجا که یک راه واحد و قطعی برای انجام این کار وجود ندارد، گزینه‌های گوناگونی در ادامه توضیح داده شده‌اند.
.PP
لایهٔ VFS همچنین یک حافظهٔ نهان دایرکتوری را پیاده‌سازی می‌کند \- این بخش اطلاعات مربوط به فایل‌ها و دایرکتوری‌ها (و نه داده‌های آن‌ها) را در حافظه نگهداری می‌کند.
.SS حافظهٔ نهان دایرکتوری VFS (VFS Directory Cache)
.PP
با استفاده از پرچم \f[V]--dir-cache-time\f[R]، می‌توانید مشخص کنید که یک دایرکتوری تا چه مدت به‌روز در نظر گرفته شود و نیازی به بازخوانی آن از backend نباشد.
تغییرات ایجادشده از طریق VFS بلافاصله نمایان می‌شوند یا حافظهٔ نهان را نامعتبر می‌کنند.
.IP
.nf
\f[C]
    --dir-cache-time duration   Time to cache directory entries for (default 5m0s)
    --poll-interval duration    Time to wait between polling for changes. Must be smaller than dir-cache-time. Only on supported remotes. Set to 0 to disable (default 1m0s)
\f[R]
.fi
.PP
با این حال، در صورتی که backend پیکربندی‌شده از پایش تغییرات پشتیبانی نکند، تغییراتی که مستقیماً از طریق رابط کاربری وب یا نسخهٔ متفاوتی از rclone روی فضای ابری اعمال می‌شوند، تنها پس از منقضی شدن حافظهٔ نهان دایرکتوری اعمال خواهند شد.
اگر backend از پایش پشتیبانی کند، تغییرات در بازهٔ زمانی مشخص‌شده برای پایش دریافت خواهند شد.
.PP
شما می‌توانید یک سیگنال \f[V]SIGHUP\f[R] به rclone ارسال کنید تا بدون در نظر گرفتن مدت زمان ماندگاری، تمام حافظه‌های نهان دایرکتوری را خالی کند.
با فرض اینکه تنها یک نمونه از rclone در حال اجرا است، می‌توانید حافظهٔ نهان را به این صورت بازنشانی کنید:
.IP
.nf
\f[C]
kill -SIGHUP $(pidof rclone)
\f[R]
.fi
.PP
اگر rclone را به همراه کنترل از راه دور پیکربندی کرده باشید، می‌توانید از rclone rc برای خالی کردن کامل حافظهٔ نهان دایرکتوری استفاده کنید:
.IP
.nf
\f[C]
rclone rc vfs/forget
\f[R]
.fi
.PP
یا برای فایل‌ها یا دایرکتوری‌های مشخص:
.IP
.nf
\f[C]
rclone rc vfs/forget file=path/to/file dir=path/to/dir
\f[R]
.fi
.SS بافر کردن فایل در VFS (VFS File Buffering)
.PP
پرچم \f[V]--buffer-size\f[R] مقدار حافظه‌ای را که برای بافر کردن پیشاپیش داده‌ها به کار می‌رود، تعیین می‌کند.
.PP
هر فایل باز همواره تلاش می‌کند مقدار دادهٔ تعیین‌شده را در حافظه نگه دارد.
داده‌های بافرشده محدود به یک فایل باز هستند و به اشتراک گذاشته نخواهند شد.
.PP
این پرچم حد بالایی برای حافظهٔ مصرفی به ازای هر فایل باز است.
بافر تنها برای داده‌هایی که دانلود شده اما هنوز خوانده نشده‌اند از حافظه استفاده می‌کند.
در صورت خالی بودن بافر، تنها مقدار ناچیزی از حافظه مصرف خواهد شد.
.PP
حداکثر حافظهٔ مصرفی توسط rclone برای بافرینگ می‌تواند تا \f[V]--buffer-size * open files\f[R] باشد.
.SS ذخیره‌سازی نهان فایل در VFS (VFS File Caching)
.PP
این پرچم‌ها گزینه‌های ذخیره‌سازی نهان فایل در VFS را کنترل می‌کنند.
ذخیره‌سازی نهان فایل برای اینکه لایهٔ VFS با یک سامانه فایل عادی سازگار به نظر برسد ضروری است.
این سازوکار می‌تواند غیرفعال شود، اما به قیمت از دست رفتن بخشی از سازگاری تمام خواهد شد.
.PP
برای نمونه، اگر بخواهید به‌طور هم‌زمان از یک فایل بخوانید و در آن بنویسید، باید کش VFS را فعال کنید.
برای جزئیات بیشتر به ادامه مراجعه کنید.
.PP
توجه داشته باشید که حافظهٔ نهان VFS از backend حافظه نهان (cache backend) مجزا است و ممکن است به یکی از آن‌ها یا هر دو نیاز پیدا کنید.
.IP
.nf
\f[C]
    --cache-dir string                     Directory rclone will use for caching.
    --vfs-cache-mode CacheMode             Cache mode off|minimal|writes|full (default off)
    --vfs-cache-max-age duration           Max time since last access of objects in the cache (default 1h0m0s)
    --vfs-cache-max-size SizeSuffix        Max total size of objects in the cache (default off)
    --vfs-cache-min-free-space SizeSuffix  Target minimum free space on the disk containing the cache (default off)
    --vfs-cache-poll-interval duration     Interval to poll the cache for stale objects (default 1m0s)
    --vfs-write-back duration              Time to writeback files after last use when using cache (default 5s)
\f[R]
.fi
.PP
در صورت اجرا با \f[V]-vv\f[R]، دستور rclone مسیر قرارگیری فایل‌های کش را چاپ خواهد کرد.
فایل‌ها در ناحیهٔ فایل کش کاربر که به سیستم‌عامل بستگی دارد ذخیره می‌شوند، اما می‌توان آن را از طریق \f[V]--cache-dir\f[R] یا با تنظیم متغیر محیطی مربوطه مدیریت کرد.
.PP
حافظهٔ نهان دارای ۴ حالت مختلف است که توسط \f[V]--vfs-cache-mode\f[R] انتخاب می‌شوند.
هرچه حالت حافظهٔ نهان بالاتر باشد، سازگاری rclone به بهای مصرف فضای بیشتر دیسک، افزایش می‌یابد.
.PP
توجه داشته باشید که فایل‌ها تنها زمانی در ریموت بازنویسی می‌شوند که بسته شده باشند و به مدت \f[V]--vfs-write-back\f[R] ثانیه مورد دسترسی قرار نگرفته باشند.
اگر rclone متوقف شود یا پیش از آپلود فایل‌ها به کار خود پایان دهد، این فایل‌ها در اجرای بعدی rclone با همان پرچم‌ها بارگذاری خواهند شد.
.PP
در صورت استفاده از \f[V]--vfs-cache-max-size\f[R] یا \f[V]--vfs-cache-min-free-space\f[R] توجه داشته باشید که ممکن است حافظهٔ نهان به دو دلیل از این سهمیه‌ها فراتر برود:
نخست به این دلیل که بررسی سهمیه تنها در هر \f[V]--vfs-cache-poll-interval\f[R] یک‌بار انجام می‌پذیرد.
دوم اینکه فایل‌های باز را نمی‌توان از حافظهٔ نهان خارج کرد.
هنگامی که اندازه از \f[V]--vfs-cache-max-size\f[R] یا \f[V]--vfs-cache-min-free-space\f[R] فراتر رود، rclone ابتدا تلاش می‌کند فایل‌هایی با کمترین میزان دسترسی را از کش خارج کند.
rclone این روند را از فایل‌هایی آغاز می‌کند که بیشترین زمان از آخرین دسترسی به آن‌ها گذشته است.
این راهبرد تخلیهٔ کش بسیار کارآمد است و احتمال باقی ماندن فایل‌های پرکاربردتر در حافظهٔ نهان را بالا می‌برد.
.PP
گزینهٔ \f[V]--vfs-cache-max-age\f[R] فایل‌ها را پس از گذشت مدت‌زمان تعیین‌شده از آخرین دسترسی از کش خارج می‌کند؛ این سازوکار بر اساس زمان آخرین دسترسی عمل می‌کند، نه زمانی که فایل نخستین‌بار به کش اضافه شده است.
مقدار پیش‌فرض ۱ ساعت فایل‌هایی را که به مدت ۱ ساعت هیچ دسترسی به آن‌ها صورت نگرفته است از کش خارج می‌کند.
هنگامی که به یک فایل موجود در کش دسترسی پیدا شود، زمان‌سنج ۱ ساعته بازنشانی شده و پیش از خروج، مجدداً ۱ ساعت منتظر خواهد ماند.
زمان را با نمادگذاری استاندارد s، m، h، d و w مشخص کنید.
.PP
در صورت استفاده از \f[V]--vfs-cache-mode > off\f[R]، شما \f[B]نباید\f[R] دو نسخه از rclone را با استفاده از حافظهٔ نهان VFS مشترک بر روی ریموت‌های یکسان یا هم‌پوشان اجرا کنید.
انجام این کار بالقوه می‌تواند باعث خرابی داده‌ها شود.
برای رفع این مشکل، می‌توانید با استفاده از \f[V]--cache-dir\f[R]، به هر نسخه از rclone ساختار سلسله‌مراتبی کش مجزایی اختصاص دهید.
در صورتی که ریموت‌های مورد استفاده هم‌پوشانی نداشته باشند، نیازی به نگرانی در این مورد نیست..SS --vfs-cache-mode off
.PP
در این حالت (پیش‌فرض) خواندن و نوشتن مستقیماً از و روی فضای راه دور (remote) انجام می‌شود، بدون آنکه چیزی روی دیسک کَش شود.
.PP
این بدان معناست که برخی عملیات‌ها امکان‌پذیر نیستند:
.IP \[bu] 2
فایل‌ها را نمی‌توان هم‌زمان برای هر دو حالت خواندن و نوشتن باز کرد
.IP \[bu] 2
در فایل‌های بازشده برای نوشتن، تغییر موقعیت نشانگر (seek) ممکن نیست
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید دارای پرچم O_TRUNC باشند
.IP \[bu] 2
فایل‌هایی که برای خواندن همراه با O_TRUNC باز شوند، فقط‌نوشتنی باز خواهند شد
.IP \[bu] 2
فایل‌های بازشده به‌صورت فقط‌نوشتنی به‌گونه‌ای رفتار می‌کنند که گویی O_TRUNC داده شده است
.IP \[bu] 2
حالت‌های باز کردن O_APPEND و O_TRUNC نادیده گرفته می‌شوند
.IP \[bu] 2
در صورت شکست بارگذاری (upload)، امکان تلاش مجدد وجود ندارد
.SS --vfs-cache-mode minimal
.PP
این حالت بسیار شبیه به \[dq]off\[dq] است، با این تفاوت که فایل‌های بازشده برای خواندن و نوشتن روی دیسک بافر می‌شوند.
این امر باعث سازگاری بسیار بیشتر فایل‌های بازشده برای نوشتن می‌شود، در حالی که کمترین فضای ممکن از دیسک را مصرف می‌کند.
.PP
این عملیات‌ها امکان‌پذیر نیستند:
.IP \[bu] 2
در فایل‌های بازشده فقط برای نوشتن، تغییر موقعیت نشانگر (seek) ممکن نیست
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید دارای پرچم O_TRUNC باشند
.IP \[bu] 2
فایل‌های بازشده فقط برای نوشتن، O_APPEND و O_TRUNC را نادیده خواهند گرفت
.IP \[bu] 2
در صورت شکست بارگذاری، امکان تلاش مجدد وجود ندارد
.SS --vfs-cache-mode writes
.PP
در این حالت، فایل‌های بازشده به‌صورت فقط‌خواندنی همچنان مستقیماً از فضای راه دور خوانده می‌شوند، اما فایل‌های فقط‌نوشتنی و خواندنی/نوشتنی ابتدا روی دیسک بافر می‌شوند.
.PP
این حالت باید از تمامی عملیات‌های عادی سیستم‌فایل پشتیبانی کند.
.PP
اگر بارگذاری با شکست مواجه شود، تلاش مجدد در بازه‌های زمانی با افزایش نمایی تا حداکثر ۱ دقیقه انجام خواهد شد.
.SS --vfs-cache-mode full
.PP
در این حالت تمامی خواندن‌ها و نوشتن‌ها روی دیسک و از روی دیسک بافر می‌شوند.
هنگامی که داده‌ها از فضای راه دور خوانده می‌شوند، روی دیسک نیز بافر خواهند شد.
.PP
در این حالت، فایل‌های موجود در کَش به‌صورت فایل‌های کم‌پشت (sparse files) خواهند بود و rclone بخش‌هایی از فایل را که بارگیری کرده است پیگیری می‌کند.
.PP
بنابراین اگر برنامه‌ای تنها ابتدای هر فایل را بخواند، rclone نیز تنها ابتدای فایل را بافر خواهد کرد.
این فایل‌ها در کَش با اندازه کامل خود نمایش داده می‌شوند، اما در واقع فایل‌های کم‌پشتی هستند که تنها داده‌های بارگیری‌شده درون آن‌ها قرار دارد.
.PP
این حالت باید از تمامی عملیات‌های عادی سیستم‌فایل پشتیبانی کند و در غیر این صورت، کاملاً مشابه \f[V]--vfs-cache-mode\f[R] writes است.
.PP
هنگام خواندن یک فایل، rclone به اندازه \f[V]--buffer-size\f[R] به‌علاوه \f[V]--vfs-read-ahead\f[R] بایت جلوتر می‌خواند.
مقدار \f[V]--buffer-size\f[R] در حافظه بافر می‌شود در حالی که \f[V]--vfs-read-ahead\f[R] روی دیسک بافر خواهد شد.
.PP
هنگام استفاده از این حالت، توصیه می‌شود که \f[V]--buffer-size\f[R] بیش از حد بزرگ تنظیم نشود و در صورت نیاز، \f[V]--vfs-read-ahead\f[R] روی مقدار بزرگی تنظیم گردد.
.PP
\f[B]مهم:\f[R] همه سیستم‌های فایل از فایل‌های کم‌پشت پشتیبانی نمی‌کنند؛ به‌ویژه FAT/exFAT پشتیبانی ندارند.
اگر دایرکتوری کَش روی سیستم‌فایلی باشد که از فایل‌های کم‌پشت پشتیبانی نمی‌کند، rclone عملکرد بسیار ضعیفی خواهد داشت و در صورت شناسایی چنین سیستمی، یک پیام ERROR ثبت خواهد کرد.
.SS انگشت‌نگاری (Fingerprinting)
.PP
بخش‌های مختلف VFS از انگشت‌نگاری برای تشخیص تغییر نسخه محلی فایل نسبت به فایل راه دور استفاده می‌کنند.
اثرانگشت‌ها از موارد زیر ساخته می‌شوند:
.IP \[bu] 2
اندازه (size)
.IP \[bu] 2
زمان تغییر (modification time)
.IP \[bu] 2
هش (hash)
.PP
در صورتی که روی شیء در دسترس باشند.
.PP
در برخی backendها، خواندن بعضی از این مشخصه‌ها کُند است (نیازمند یک فراخوانی API اضافی برای هر شیء یا پردازش مضاعف روی شیء هستند).
.PP
به‌عنوان مثال، \f[V]hash\f[R] در backendهای \f[V]local\f[R] و \f[V]sftp\f[R] کُند است زیرا باید کل فایل خوانده شده و هش آن محاسبه شود؛ همچنین \f[V]modtime\f[R] در backendهای \f[V]s3\f[R]، \f[V]swift\f[R]، \f[V]ftp\f[R] و \f[V]qinqstor\f[R] کُند است زیرا برای دریافت آن نیاز به فراخوانی اضافی API دارند.
.PP
اگر از پرچم \f[V]--vfs-fast-fingerprint\f[R] استفاده کنید، rclone عملیات‌های کُند را در محاسبه اثرانگشت لحاظ نخواهد کرد.
این کار دقت انگشت‌نگاری را کاهش می‌دهد، اما سرعت آن را بسیار بالا برده و زمان باز کردن فایل‌های کَش‌شده را بهبود می‌بخشد.
.PP
اگر در حال اجرای یک کَش VFS بر روی backendهای \f[V]local\f[R]، \f[V]s3\f[R] یا \f[V]swift\f[R] هستید، استفاده از این پرچم توصیه می‌شود.
.PP
توجه داشته باشید که اگر مقدار این پرچم را تغییر دهید، ممکن است اثرانگشت فایل‌های موجود در کَش نامعتبر شده و نیاز به بارگیری مجدد فایل‌ها باشد..SS خواندن تکه‌تکه‌ای در VFS (VFS Chunked Reading)
.PP
هنگامی که rclone فایل‌ها را از یک ریموت می‌خواند، آن‌ها را به صورت تکه‌تکه (در قالب chunk) می‌خواند.
این بدان معناست که rclone به جای درخواست کل فایل، تکه مشخص‌شده را درخواست می‌کند.
این کار می‌تواند با درخواستِ صرفاً تکه‌هایی از ریموت که واقعاً خوانده می‌شوند، سهمیه دانلود مصرفی را برای برخی ریموت‌ها کاهش دهد؛ البته به بهای افزایش تعداد کل درخواست‌ها.
.PP
این پرچم‌ها رفتار تکه‌تکه‌سازی را کنترل می‌کنند:
.IP
.nf
\f[C]
    --vfs-read-chunk-size SizeSuffix        خواندن اشیاء مبدأ به صورت تکه‌تکه (پیش‌فرض 128M)
    --vfs-read-chunk-size-limit SizeSuffix  حداکثر اندازه دو برابر شدن تکه (پیش‌فرض off)
    --vfs-read-chunk-streams int            تعداد جریان‌های موازی برای خواندن هم‌زمان
\f[R]
.fi
.PP
رفتار تکه‌تکه‌سازی بسته به پارامتر
\f[V]--vfs-read-chunk-streams\f[R] متفاوت خواهد بود.
.SS \f[V]--vfs-read-chunk-streams\f[R] == 0
.PP
برنامه rclone خواندن را با تکه‌ای به اندازه
\f[V]--vfs-read-chunk-size\f[R] آغاز می‌کند و سپس با هر بار خواندن، اندازه آن را دو برابر می‌سازد.
هنگامی که \f[V]--vfs-read-chunk-size-limit\f[R] مشخص شده و بزرگتر
از \f[V]--vfs-read-chunk-size\f[R] باشد، اندازه تکه برای هر فایلِ باز
تنها تا رسیدن به مقدار مشخص‌شده دو برابر خواهد شد.
اگر مقدار برابر با \[dq]off\[dq] باشد (که حالت پیش‌فرض است)، محدودیت
غیرفعال است و اندازه تکه بدون محدودیت افزایش خواهد یافت.
.PP
با \f[V]--vfs-read-chunk-size 100M\f[R] و
\f[V]--vfs-read-chunk-size-limit 0\f[R] بخش‌های زیر
دانلود خواهند شد: 0-100M، 100M-200M، 200M-300M، 300M-400M و غیره.
هنگامی که \f[V]--vfs-read-chunk-size-limit 500M\f[R] مشخص شود، نتیجه
به صورت 0-100M، 100M-300M، 300M-700M، 700M-1200M، 1200M-1700M و غیره
خواهد بود.
.PP
تنظیم \f[V]--vfs-read-chunk-size\f[R] روی \f[V]0\f[R] یا \[dq]off\[dq]
خواندن تکه‌تکه‌ای را غیرفعال می‌کند.
.PP
تکه‌ها در حافظه بافر (موقتاً ذخیره) نخواهند شد.
.SS \f[V]--vfs-read-chunk-streams\f[R] > 0
.PP
برنامه rclone به تعداد \f[V]--vfs-read-chunk-streams\f[R] تکه با اندازه
\f[V]--vfs-read-chunk-size\f[R] را به طور هم‌زمان می‌خواند.
اندازه برای هر خواندن ثابت خواهد ماند.
.PP
این کار کارایی را روی پیوندهای با تأخیر بالا یا
پیوندهای با پهنای باند بسیار بالا به ذخیره‌سازهای شیء با کارایی بالا به طور چشمگیری بهبود می‌بخشد.
.PP
برای یافتن مقادیر بهینه برای
\f[V]--vfs-read-chunk-size\f[R] و \f[V]--vfs-read-chunk-streams\f[R]
به مقداری آزمون و خطا نیاز خواهد بود، چرا که این موارد به backend مورد استفاده و میزان تأخیر تا آن بستگی دارند.
.PP
برای ذخیره‌سازهای شیء با کارایی بالا (مانند AWS S3)، یک نقطه شروع مناسب
می‌تواند \f[V]--vfs-read-chunk-streams 16\f[R] و
\f[V]--vfs-read-chunk-size 4M\f[R] باشد.
در آزمایش‌های انجام‌شده با AWS S3، کارایی تقریباً متناسب با مقدار
تنظیم‌شده برای \f[V]--vfs-read-chunk-streams\f[R] مقیاس‌پذیر بود.
.PP
تنظیمات مشابه باید برای پیوندهای با تأخیر بالا نیز جوابگو باشد، اما بسته به
میزان تأخیر، ممکن است برای دستیابی به توان عملیاتی به مقادیر بیشتری از \f[V]--vfs-read-chunk-streams\f[R] نیاز باشد.
.SS کارایی VFS (VFS Performance)
.PP
این پرچم‌ها ممکن است برای فعال یا غیرفعال کردن قابلیت‌های VFS به دلایل
کارایی یا دلایل دیگر استفاده شوند.
همچنین قابلیت خواندن تکه‌تکه‌ای را ببینید.
.PP
به‌ویژه S3 و Swift سود بسیار زیادی از پرچم
\f[V]--no-modtime\f[R] می‌برند (یا برای تأثیری کمی متفاوت
از \f[V]--use-server-modtime\f[R] استفاده کنید)، زیرا هر بار خواندن زمان ویرایش نیازمند یک تراکنش است.
.IP
.nf
\f[C]
    --no-checksum     چک‌سام‌ها را هنگام بارگذاری/دانلود مقایسه نمی‌کند.
    --no-modtime      زمان ویرایش را نمی‌خواند/نمی‌نویسد (می‌تواند سرعت را افزایش دهد).
    --no-seek         اجازه پرش (seek) در فایل‌ها را نمی‌دهد.
    --read-only       تنها اجازه دسترسی فقط‌خواندنی را می‌دهد.
\f[R]
.fi
.PP
گاهی اوقات عملیات خواندن یا نوشتن به صورت خارج از ترتیب به rclone تحویل داده می‌شوند.
‏rclone به جای پرش (seek)، مدت کوتاهی منتظر می‌ماند تا عملیات متوالی بعدی خواندن یا نوشتن دریافت شود.
این پرچم‌ها تنها زمانی اثرگذار هستند که از فایل کَش روی دیسک استفاده نشود.
.IP
.nf
\f[C]
    --vfs-read-wait duration   مدت زمان انتظار برای خواندن متوالی قبل از پرش (پیش‌فرض 20ms)
    --vfs-write-wait duration  مدت زمان انتظار برای نوشتن متوالی قبل از اعلام خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
هنگام استفاده از کَش نوشتن VFS (\f[V]--vfs-cache-mode\f[R] با مقدار
writes یا full)، پرچم سراسری \f[V]--transfers\f[R] را می‌توان برای
تنظیم تعداد بارگذاری‌های موازی فایل‌های تغییریافته از کَش تنظیم کرد
(پرچم سراسری مرتبط \f[V]--checkers\f[R] تأثیری بر VFS ندارد).
.IP
.nf
\f[C]
    --transfers int  تعداد انتقال‌های هم‌زمان فایل برای اجرا (پیش‌فرض 4)
\f[R]
.fi.SS "پیوندهای نمادین (Symlinks)"
.PP
به‌طور پیش‌فرض VFS از پیوندهای نمادین (symlinks) پشتیبانی نمی‌کند.
با این حال، می‌توان این قابلیت را با هر یک از پرچم‌های زیر فعال کرد:
.IP
.nf
\f[C]
    --links      تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq].
    --vfs-links  تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
\f[R]
.fi
.PP
از آنجا که بیشتر سامانه‌های ذخیره‌سازی ابری مستقیماً از پیوندهای نمادین پشتیبانی نمی‌کنند، rclone پیوند نمادین را به‌صورت یک فایل معمولی با یک پسوند ویژه ذخیره می‌کند.
بنابراین فایلی که به‌صورت یک پیوند نمادین با نام \f[V]link-to-file.txt\f[R] ظاهر می‌شود، در فضای ابری به‌صورت \f[V]link-to-file.txt.rclonelink\f[R] ذخیره خواهد شد و محتوای آن مسیر مقصد پیوند نمادین خواهد بود.
.PP
توجه داشته باشید که \f[V]--links\f[R] تبدیل پیوند نمادین را به‌صورت سراسری در rclone فعال می‌کند \- این شامل هر backend که از این مفهوم پشتیبانی کند (برای مثال backend محلی یا local) می‌شود.
\f[V]--vfs-links\f[R] این قابلیت را صرفاً برای لایه VFS فعال می‌کند.
.PP
این سازوکار با روش مورد استفاده توسط backend محلی از طریق پرچم --local-links سازگار است (<https://rclone.org/local/#symlinks-junction-points>).
.PP
پرچم \f[V]--vfs-links\f[R] برای \f[V]rclone mount\f[R]، \f[V]rclone nfsmount\f[R] و \f[V]rclone serve nfs\f[R] طراحی شده است.
.PP
این ویژگی هنوز با سایر دستورات \f[V]rclone serve\f[R] آزمایش نشده است.
.PP
یکی از محدودیت‌های پیاده‌سازی فعلی این است که انتظار دارد فراخواننده، زیرپیوندهای نمادین (sub-symlinks) را حل کند.
برای مثال با فرض این درخت دایرکتوری:
.IP
.nf
\f[C]
\&.
├── dir
│\ \  └── file.txt
└── linked-dir -> dir
\f[R]
.fi
.PP
لایه VFS پیوند \f[V]linked-dir\f[R] را به‌درستی حل می‌کند، اما \f[V]linked-dir/file.txt\f[R] را حل نخواهد کرد.
این موضوع برای دستورهای آزمایش‌شده مشکلی ایجاد نمی‌کند اما ممکن است برای سایر دستورها مسئله‌ساز شود.
.PP
\f[B]توجه\f[R] داشته باشید که یک مشکل باز در رابطه با پشتیبانی از پیوندهای نمادین، یعنی گزارش شماره ۸۲۴۵ (<https://github.com/rclone/rclone/issues/8245>) وجود دارد که در آن وقتی پیوندهای نمادین به دایرکتوری‌هایی منتقل می‌شوند که فایلی با همان نام در آن‌ها وجود دارد (یا برعکس)، فایل‌های تکراری ایجاد می‌شوند.
.SS "حساسیت به بزرگی و کوچکی حروف در VFS (VFS Case Sensitivity)"
.PP
سیستم‌های فایل لینوکس به بزرگی و کوچکی حروف حساس هستند (case-sensitive): دو فایل می‌توانند تنها در بزرگی و کوچکی حروف با هم تفاوت داشته باشند، و هنگام باز کردن یک فایل باید دقیقاً همان حالت حروف استفاده شود.
.PP
سیستم‌های فایل در ویندوزهای مدرن به بزرگی و کوچکی حروف حساس نیستند اما حالت حروف را حفظ می‌کنند (case-insensitive but case-preserving): اگرچه فایل‌های موجود را می‌توان با هر حالتی از حروف باز کرد، اما حالت دقیق حروفی که برای ایجاد فایل استفاده شده حفظ می‌شود و برنامه‌ها می‌توانند آن را استعلام کنند.
مجاز نیست که در یک دایرکتوری یکسان، دو فایل تنها در بزرگی یا کوچکی حروف با یکدیگر تفاوت داشته باشند.
.PP
معمولاً سیستم‌های فایل در macOS نسبت به بزرگی و کوچکی حروف حساس نیستند.
امکان حساس کردن سیستم‌های فایل macOS به بزرگی و کوچکی حروف وجود دارد، اما این حالت پیش‌فرض نیست.
.PP
پرچم \f[V]--vfs-case-insensitive\f[R] در VFS چگونگی مدیریت این دو حالت را توسط rclone کنترل می‌کند.
اگر مقدار آن \[dq]false\[dq] باشد، rclone نام فایل‌ها را دست‌نخورده به remote ارسال می‌کند.
اگر این پرچم \[dq]true\[dq] باشد (یا بدون مقدار در خط فرمان درج شود)، rclone ممکن است یک «اصلاح» (\[dq]fixup\[dq]) را مطابق توضیحات زیر انجام دهد.
.PP
کاربر ممکن است نام فایلی را برای باز کردن/حذف/تغییر نام/غیره با حالتی از حروف متفاوت از آنچه روی remote ذخیره شده مشخص کند.
اگر یک آرگومان به فایلی موجود با دقیقاً همان نام اشاره کند، از حالت حروف فایل موجود روی دیسک استفاده خواهد شد.
با این حال، اگر نام فایلی با دقیقاً همان نام یافت نشود، اما نامی که تنها در بزرگی و کوچکی حروف با آن تفاوت دارد موجود باشد، rclone نام را به‌طور شفاف اصلاح خواهد کرد.
این اصلاح تنها زمانی رخ می‌دهد که یک فایل از قبل موجود درخواست شود.
حساسیت به حروف در نام فایل‌هایی که به‌تازگی توسط rclone ایجاد می‌شوند، توسط remote زیربنایی کنترل می‌شود.
.PP
توجه داشته باشید که حساسیت به بزرگی و کوچکی حروف در سیستم‌عامل اجراکننده rclone (مقصد یا target) ممکن است با حساسیت سیستم فایل ارائه‌شده توسط rclone (مبدأ یا source) متفاوت باشد.
این پرچم تعیین می‌کند که آیا برای برآورده کردن الزامات سیستم مقصد، «اصلاح» (\[dq]fixup\[dq]) انجام شود یا خیر.
.PP
اگر پرچم در خط فرمان مشخص نشود، مقدار پیش‌فرض آن به سیستم‌عاملی بستگی دارد که rclone در آن اجرا می‌شود: در Windows و macOS مقدار \[dq]true\[dq] و در غیر این صورت \[dq]false\[dq] است.
اگر پرچم بدون مقدار مشخص شود، مقدار آن \[dq]true\[dq] در نظر گرفته می‌شود.
.PP
پرچم \f[V]--no-unicode-normalization\f[R] کنترل می‌کند که آیا «اصلاح» (\[dq]fixup\[dq]) مشابهی برای نام‌فایل‌هایی که از نظر نگارش متفاوتند اما بر اساس استانداردهای یونیکد هم‌ارز ساختاری (canonically equivalent) محسوب می‌شوند (<https://en.wikipedia.org/wiki/Unicode_equivalence>) انجام شود یا خیر.
نرمال‌سازی یونیکد (Unicode normalization) می‌تواند به‌ویژه برای کاربران macOS مفید باشد؛ چرا که macOS فرم NFD را به جای فرم NFC مورداستفاده در اکثر پلتفرم‌های دیگر ترجیح می‌دهد.
بنابراین اکیداً توصیه می‌شود که مقدار پیش‌فرض \f[V]false\f[R] در macOS حفظ شود تا از مشکلات سازگاری کدگذاری کاراکترها جلوگیری به عمل آید.
.PP
در صورت وقوع حالت (احتمالاً نادر) وجود چندین نام فایل تکراری در یک دایرکتوری پس از اعمال نرمال‌سازی حروف و یونیکد، پرچم \f[V]--vfs-block-norm-dupes\f[R] امکان پنهان‌سازی این موارد تکراری را فراهم می‌کند.
این کار با هزینه کاهش کارایی همراه است، چرا که rclone هنگام فهرست کردن محتوای یک دایرکتوری ناچار است کل دایرکتوری را برای یافتن موارد تکراری پویش کند.
به همین دلیل، توصیه می‌شود در صورت عدم نیاز، این گزینه غیرفعال بماند.
با این حال، ممکن است کاربران macOS تمایل به استفاده از آن داشته باشند؛ زیرا در غیر این صورت، اگر یک دایرکتوری remote شامل هر دو نسخه NFC و NFD از یک نام فایل یکسان باشد، وضعیت غیرمعمولی رخ خواهد داد: هر دو نسخه فایل در نقطه mount نمایش داده می‌شوند و هر دو به ظاهر قابل ویرایش خواهند بود، اما ویرایش هر نسخه در عمل منجر به اعمال تغییرات صرفاً روی نسخه NFD در لایه‌های زیرین می‌شود.
پرچم \f[V]--vfs-block-norm-dupes\f[R] با تشخیص این سناریو، پنهان کردن موارد تکراری و ثبت خطا در گزارش وقایع (log)، مشابه با نحوه مدیریت این شرایط در \f[V]rclone sync\f[R]، از بروز این سردرگمی جلوگیری می‌کند..SS گزینه‌های دیسک VFS
.PP
این پرچم به شما امکان می‌دهد آمار مربوط به سیستم فایل را به صورت دستی
تنظیم کنید.
این قابلیت می‌تواند زمانی مفید باشد که این آمار نتوانند به صورت خودکار
و صحیح خوانده شوند.
.IP
.nf
\f[C]
    --vfs-disk-space-total-size    تنظیم دستی اندازه کل فضای دیسک (مثال: 256G، پیش‌فرض: -1)
\f[R]
.fi
.SS گزارش جایگزین بایت‌های مصرف‌شده
.PP
برخی بک‌اندها، به‌ویژه S3، مقدار بایت‌های مصرف‌شده را گزارش نمی‌دهند.
اگر نیاز دارید هنگام اجرای \f[V]df\f[R] روی سیستم فایل این اطلاعات در
دسترس باشند، پرچم \f[V]--vfs-used-is-size\f[R] را به rclone ارسال کنید.
با تنظیم این پرچم، rclone به‌جای اتکا به بک‌اند برای گزارش این اطلاعات،
مشابه \f[V]rclone size\f[R] کل ریموت را پویش کرده و خودش کل فضای استفاده‌شده
را محاسبه می‌کند.
.PP
\f[B]هشدار\f[R]: بر خلاف \f[V]rclone size\f[R]، این پرچم فیلترها را نادیده
می‌گیرد تا نتیجه دقیق باشد.
با این حال، این کار بسیار ناکارآمد است و ممکن است باعث فراخوانی‌های متعدد
API شده و هزینه‌های اضافی به همراه داشته باشد.
از آن فقط به عنوان آخرین راهکار و صرفاً به همراه کش استفاده کنید.
.SS متادیتای VFS
.PP
اگر از پرچم \f[V]--vfs-metadata-extension\f[R] استفاده کنید، می‌توانید
VFS را وادارید تا فایل‌های حاوی متادیتا (https://rclone.org/docs/#metadata) را
به صورت یک blob با ساختار JSON در دسترس قرار دهد.
این فایل‌ها در فهرست دایرکتوری نمایش داده نمی‌شوند، اما می‌توان روی آن‌ها
\f[V]stat\f[R] اجرا کرد و آن‌ها را باز نمود؛ و به محض انجام این کار، تا زمانی
که کش دایرکتوری منقضی شود، در فهرست‌های دایرکتوری ظاهر \f[B]خواهند شد\f[R].
.PP
توجه داشته باشید که برخی بک‌اندها متادیتا را ایجاد نمی‌کنند، مگر اینکه
پرچم \f[V]--metadata\f[R] را ارسال کرده باشید.
.PP
برای نمونه، با استفاده از \f[V]rclone mount\f[R] به همراه
\f[V]--metadata --vfs-metadata-extension .metadata\f[R] نتیجه زیر حاصل می‌شود:
.IP
.nf
\f[C]
$ ls -l /mnt/
total 1048577
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G

$ cat /mnt/1G.metadata
{
        \[dq]atime\[dq]: \[dq]2025-03-04T17:34:22.317069787Z\[dq],
        \[dq]btime\[dq]: \[dq]2025-03-03T16:03:37.708253808Z\[dq],
        \[dq]gid\[dq]: \[dq]1000\[dq],
        \[dq]mode\[dq]: \[dq]100664\[dq],
        \[dq]mtime\[dq]: \[dq]2025-03-03T16:03:39.640238323Z\[dq],
        \[dq]uid\[dq]: \[dq]1000\[dq]
}

$ ls -l /mnt/
total 1048578
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G
-rw-rw-r-- 1 user user        185 Mar  3 16:03 1G.metadata
\f[R]
.fi
.PP
اگر فایل فاقد متادیتا باشد، به صورت \f[V]{}\f[R] بازگردانده می‌شود و اگر
خطایی در خواندن متادیتا رخ دهد، خطا به صورت
\f[V]{\[dq]error\[dq]:\[dq]error string\[dq]}\f[R] بازگردانده خواهد شد.
.SS پروکسی احراز هویت
.PP
اگر پارامتر \f[V]--auth-proxy /path/to/program\f[R] را ارسال کنید، rclone
از آن برنامه برای ساخت بک‌اندها به صورت در لحظه (on the fly) استفاده می‌کند که
سپس برای احراز هویت درخواست‌های ورودی به کار گرفته می‌شوند.
این سازوکار از یک پروتکل ساده مبتنی بر JSON با ورودی روی STDIN و خروجی روی
STDOUT استفاده می‌کند.
.PP
\f[B]لطفاً توجه داشته باشید:\f[R] پرچم‌های \f[V]--auth-proxy\f[R] و
\f[V]--authorized-keys\f[R] نمی‌توانند هم‌زمان استفاده شوند؛ اگر
\f[V]--auth-proxy\f[R] تنظیم شده باشد، گزینه کلیدهای مجاز نادیده گرفته خواهد شد.
.PP
یک برنامه نمونه در مسیر
bin/test_proxy.py (https://github.com/rclone/rclone/blob/master/bin/test_proxy.py)
در کد منبع rclone موجود است.
.PP
وظیفه این برنامه دریافت \f[V]user\f[R] و \f[V]pass\f[R] در ورودی و تبدیل
آن‌ها به پیکربندی یک بک‌اند در STDOUT با قالب JSON است.
پارامترهای پیش‌فرض بک‌اند به این پیکربندی اضافه خواهند شد، اما از پیکربندی
متغیرهای محیط یا گزینه‌های خط فرمان استفاده نخواهد کرد \- ایجاد یک پیکربندی
کامل بر عهده برنامه پروکسی است.
.PP
این پیکربندی تولیدشده باید این پارامتر اضافه را داشته باشد:
.IP \[bu] 2
\f[V]_root\f[R] \- ریشه (root) مورد استفاده برای بک‌اند
.PP
و می‌تواند شامل این پارامترها باشد:
.IP \[bu] 2
\f[V]_obscure\f[R] \- رشته‌های جداشده با کاما برای پارامترهایی که باید مبهم‌سازی شوند
.IP \[bu] 2
\f[V]_secret_access_key\f[R] \- کلید مخفی برای احراز هویت کلید دسترسی S3 (پایین را ببینید)
.PP
اگر احراز هویت با گذرواژه توسط کلاینت استفاده شده باشد، ورودی به فرآیند پروکسی
(روی STDIN) شبیه به این خواهد بود:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]pass\[dq]: \[dq]mypassword\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
اگر احراز هویت با کلید عمومی توسط کلاینت انجام شده باشد، ورودی به فرآیند
پروکسی (روی STDIN) شبیه به این خواهد بود:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]public_key\[dq]: \[dq]AAAAB3NzaC1yc2EAAAADAQABAAABAQDuwESFdAe14hVS6omeyX7edc...JQdf\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
اگر کلاینت با کلید دسترسی S3 احراز هویت کرده باشد
(\f[V]rclone serve s3\f[R])، کلاینت هرگز کلید مخفی خود را ارسال نمی‌کند، بلکه تنها
امضای ساخته‌شده با آن را می‌فرستد؛ بنابراین ورودی تنها حاوی شناسه کلید دسترسی به عنوان
\f[V]user\f[R] و بدون \f[V]pass\f[R] یا \f[V]public_key\f[R] است:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]AKIAIOSFODNN7EXAMPLE\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
در این حالت برنامه باید کلید دسترسی مخفی را برای آن شناسه کلید دسترسی جستجو کند
و آن را در فیلد \f[V]_secret_access_key\f[R] در خروجی بازگرداند.
سپس rclone از آن کلید مخفی برای تأیید امضای روی درخواست استفاده می‌کند و در
صورت عدم تطابق، درخواست را رد خواهد کرد.
این بدان معناست که برنامه پروکسی مرجع اصلی (source of truth) هم برای اطلاعات
اعتباری و هم برای بک‌اَندی است که به آن متصل می‌شوند.
اگر برنامه \f[V]_secret_access_key\f[R] را بازنگرداند یا آن را خالی برگرداند،
درخواست رد می‌شود.
.PP
پاسخ برنامه برای یک شناسه کلید دسترسی کش می‌شود (پایین را ببینید)، اما حتی اگر
شناسه کلید دسترسی دائماً در حال استفاده باشد، پس از ۵ دقیقه مجدداً از برنامه
استعلام خواهد شد؛ بنابراین ابطال یک شناسه کلید دسترسی در برنامه حداکثر ظرف ۵ دقیقه
اعمال می‌شود.
یک کلید مخفی تعویض‌شده (rotated secret) در نخستین درخواستی که با آن امضا شده باشد اعمال می‌گردد.
.PP
کلید \f[V]client_ip\f[R] نشانی IPای را نگه می‌دارد که کلاینت از آن متصل شده است،
بدون شماره پورت.
می‌توان از آن برای محدود کردن ورودها به شبکه‌های خاص یا ثبت وقایع احراز هویت
به صورت متمرکز استفاده کرد.
اگر کلاینت فاقد نشانی IP باشد (برای مثال هنگام اتصال از طریق سوکت یونیکس)،
این کلید حذف می‌شود.
توجه داشته باشید که اگر rclone پشت یک پروکسی معکوس (reverse proxy) باشد، این مقدار
نشانی پروکسی معکوس خواهد بود نه کلاینت اصلی.
.PP
و به عنوان نمونه، این مقدار در خروجی STDOUT بازگردانده می‌شود:
.IP
.nf
\f[C]
{
  \[dq]type\[dq]: \[dq]sftp\[dq],
  \[dq]_root\[dq]: \[dq]\[dq],
  \[dq]_obscure\[dq]: \[dq]pass\[dq],
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]pass\[dq]: \[dq]mypassword\[dq],
  \[dq]host\[dq]: \[dq]sftp.example.com\[dq]
}
\f[R]
.fi.PP
این بدان معناست که یک backend از نوع SFTP به‌صورت بلادرنگ برای
\f[V]user\f[R] و \f[V]pass\f[R]/\f[V]public_key\f[R] بازگردانده‌شده در
خروجی به میزبان داده‌شده ایجاد خواهد شد.
توجه داشته باشید از آنجا که \f[V]_obscure\f[R] روی \f[V]pass\f[R] تنظیم شده است، rclone
پارامتر \f[V]pass\f[R] را پیش از ایجاد backend مبهم‌سازی (obscure) خواهد کرد (که
برای backendهای sftp الزامی است).
.PP
برنامه می‌تواند \f[V]user\f[R] ارائه‌شده را به هر روشی دستکاری کند؛ برای
نمونه به‌منظور ایجاد پراکسی برای چندین backend مختلف sftp، می‌توانید
\f[V]user\f[R] را به‌صورت \f[V]user\[at]example.com\f[R] قرار داده و سپس
\f[V]host\f[R] را در خروجی روی \f[V]example.com\f[R] و کاربر را روی
\f[V]user\f[R] تنظیم کنید.
به دلایل امنیتی، احتمالاً مایل خواهید بود \f[V]host\f[R] را به یک فهرست
محدود مقید کنید.
.PP
یک کَش داخلی از backendها بر اساس \f[V]user\f[R]، هشی از
\f[V]pass\f[R] یا \f[V]public_key\f[R]، و \f[V]client_ip\f[R] کلیدگذاری می‌شود.
این بدان معناست که اگر گذرواژه یا کلید عمومی کاربر تغییر کند، کلاینت از یک
نشانی IP جدید متصل شود، یا پراکسی پارامترهای پیکربندی متفاوتی را بازگرداند
(مانند یک \f[V]api_key\f[R] تغییریافته)، در درخواست بعدی به جای استفادهٔ مجدد از
مورد ذخیره‌شده در کَش، یک backend تازه ایجاد خواهد شد.
.PP
این قابلیت می‌تواند برای ساخت پراکسی‌های چندمنظوره برای هر نوع backend که
rclone از آن پشتیبانی می‌کند، استفاده شود.
.IP
.nf
\f[C]
rclone serve s3 remote:path [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --addr stringArray                              نشانی IP:Port یا :Port برای مقیدسازی کارساز (پیش‌فرض 127.0.0.1:8080)
      --allow-origin string                           مبدأیی که درخواست‌های بین‌دامنه (CORS) می‌توانند از آن اجرا شوند
      --auth-key stringArray                          تنظیم جفت‌کلید برای احراز هویت نسخه ۴: access_key_id,secret_access_key
      --auth-proxy string                             برنامه‌ای برای ایجاد backend از روی احراز هویت
      --baseurl string                                پیشوند برای URLها - برای ریشه خالی بگذارید
      --cert string                                   کلید TLS PEM (ترکیب گواهی و گواهی CA)
      --client-ca string                              مرجع صدور گواهی کلاینت (CA) برای اعتبارسنجی کلاینت‌ها
      --dir-cache-time Duration                       مدت‌زمان کَش کردن مدخل‌های دایرکتوری (پیش‌فرض 5m0s)
      --dir-perms FileMode                            مجوزهای دایرکتوری (پیش‌فرض 777)
      --disable-multipart-streaming                   بافر کردن بارگذاری‌های چندبخشی در حافظه به‌جای ارسال جریانی به backend
      --etag-hash string                              نوع هش مورد استفاده برای ETag، یا auto یا خالی برای غیرفعال‌سازی (پیش‌فرض \[dq]MD5\[dq])
      --file-perms FileMode                           مجوزهای فایل (پیش‌فرض 666)
      --force-path-style                              اگر true باشد استفاده از سبک دسترسی path، اگر false باشد سبک virtual hosted (پیش‌فرض true)
      --gid uint32                                    بازنویسی مقدار gid تعیین‌شده توسط سیستم‌فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1000)
  -h, --help                                          راهنمای s3
      --htpasswd string                               یک فایل htpasswd - در صورت عدم ارائه، احراز هویت انجام نمی‌شود
      --key string                                    کلید خصوصی TLS PEM
      --link-perms FileMode                           مجوزهای پیوند (پیش‌فرض 666)
      --max-header-bytes int                          بیشینه اندازه هدر درخواست (پیش‌فرض 4096)
      --min-tls-version string                        کمینه نسخهٔ قابل قبول TLS (پیش‌فرض \[dq]tls1.0\[dq])
      --multipart-expiry Duration                     لغو بارگذاری‌های چندبخشی ناقص و بی‌کار طولانی‌تر از این مقدار، 0 برای نگه‌داری همیشگی (پیش‌فرض 1d)
      --multipart-streaming-buffer-limit SizeSuffix   بیشینه حافظه بافرشده به ازای هر بارگذاری چندبخشی جریانی برای بخش‌های نامرتب، 0 برای نامحدود (پیش‌فرض 256Mi)
      --no-checksum                                   عدم مقایسه چِک‌سام‌ها هنگام بارگذاری/بارگیری
      --no-cleanup                                    عدم پاک‌سازی پوشه خالی پس از حذف شیء
      --no-modtime                                    عدم خواندن/نوشتن زمان ویرایش (می‌تواند سرعت را افزایش دهد)
      --no-seek                                       عدم اجازه جستجو (seek) در فایل‌ها
      --pass string                                   گذرواژه برای احراز هویت
      --poll-interval Duration                        زمان انتظار میان بررسی تغییرات، باید از dir-cache-time کمتر باشد و فقط برای ریموت‌های پشتیبانی‌شده (0 برای غیرفعال‌سازی) (پیش‌فرض 1m0s)
      --read-only                                     تنها اجازه دسترسی فقط‌خواندنی
      --realm string                                  قلمرو (realm) برای احراز هویت
      --response-header stringArray                   تنظیم هدر HTTP برای همه پاسخ‌ها، با جایگزینی مقادیر موجود
      --salt string                                   سالت (salt) درهم‌سازی گذرواژه (پیش‌فرض \[dq]dlPL2MqE\[dq])
      --server-read-timeout Duration                  مهلت زمانی خواندن داده توسط کارساز (پیش‌فرض 1h0m0s)
      --server-write-timeout Duration                 مهلت زمانی نوشتن داده توسط کارساز (پیش‌فرض 1h0m0s)
      --uid uint32                                    بازنویسی مقدار uid تعیین‌شده توسط سیستم‌فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1000)
      --umask FileMode                                بازنویسی بیت‌های مجوز تعیین‌شده توسط سیستم‌فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 002)
      --user string                                   نام کاربری برای احراز هویت
      --user-from-header string                       نام کاربری از یک هدر تعریف‌شده HTTP
      --vfs-block-norm-dupes                          در صورت وجود نام‌های فایل تکراری در یک دایرکتوری (پس از نرمال‌سازی)، ثبت خطا و پنهان کردن موارد تکراری (ممکن است بار پردازشی داشته باشد)
      --vfs-cache-max-age Duration                    حداکثر زمان از آخرین دسترسی به اشیاء در کَش (پیش‌فرض 1h0m0s)
      --vfs-cache-max-size SizeSuffix                 حداکثر اندازه کل اشیاء در کَش (پیش‌فرض off)
      --vfs-cache-min-free-space SizeSuffix           حداقل فضای خالی هدف روی دیسک حاوی کَش (پیش‌فرض off)
      --vfs-cache-mode CacheMode                      حالت کَش off|minimal|writes|full (پیش‌فرض off)
      --vfs-cache-poll-interval Duration              بازه زمانی بررسی کَش برای اشیاء بی‌استفاده (پیش‌فرض 1m0s)
      --vfs-case-insensitive                          در صورت پیدا نشدن نام فایل، یافتن تطابق غیرحساس به بزرگی و کوچکی حروف
      --vfs-disk-space-total-size SizeSuffix          تعیین فضای کل دیسک (پیش‌فرض off)
      --vfs-fast-fingerprint                          استفاده از اثرانگشت سریع (با دقت کمتر) برای تشخیص تغییرات
      --vfs-handle-caching Duration                   مدت‌زمان زنده نگه‌داشتن دستگیره فایل و بارگیرنده‌ها پس از آخرین بسته‌شدن (پیش‌فرض 5s)
      --vfs-links                                     ترجمه پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
      --vfs-metadata-extension string                 تنظیم پسوند برای خواندن فراداده از آن
      --vfs-read-ahead SizeSuffix                     پیش‌خوانی اضافه فراتر از --buffer-size هنگام استفاده از cache-mode full
      --vfs-read-chunk-size SizeSuffix                خواندن اشیاء مبدأ به‌صورت تکه‌ای (پیش‌فرض 128Mi)
      --vfs-read-chunk-size-limit SizeSuffix          اگر بزرگ‌تر از --vfs-read-chunk-size باشد، دوبرابر کردن اندازه تکه پس از هر خواندن تا رسیدن به حد (\[aq]off\[aq] نامحدود است) (پیش‌فرض off)
      --vfs-read-chunk-streams int                    تعداد جریان‌های موازی برای خواندن هم‌زمان
      --vfs-read-wait Duration                        مدت انتظار برای خواندن متوالی قبل از seek (پیش‌فرض 20ms)
      --vfs-refresh                                   تازه‌سازی بازگشتی کَش دایرکتوری در پس‌زمینه هنگام شروع
      --vfs-used-is-size rclone size                  استفاده از الگوریتم rclone size برای اندازهٔ استفاده‌شده (Used)
      --vfs-write-back Duration                       زمان بازنویسی فایل‌ها پس از آخرین استفاده هنگام استفاده از کَش (پیش‌فرض 5s)
      --vfs-write-wait Duration                       مدت انتظار برای نوشتن متوالی پیش از اعلام خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، به صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) مراجعه کنید..SS گزینه‌های فیلتر (Filter Options)
.PP
پرچم‌هایی برای فیلتر کردن فهرست‌های دایرکتوری
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های روی مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از یک فایل (برای خواندن از stdin از \- استفاده کنید)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود داشتن نام فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل منبع از یک فایل (برای خواندن از stdin از \- استفاده کنید)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل مبدأ از فایل بدون هیچ‌گونه پردازش روی خطوط (برای خواندن از stdin از \- استفاده کنید)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (برای خواندن از stdin از \- استفاده کنید)
  \-f, --filter stringArray                  افزودن یک قاعده فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (برای خواندن از stdin از \- استفاده کنید)
      --hash-filter string                  افراز نام فایل‌ها با هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (ناحساس به حروف کوچک و بزرگ)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از یک فایل (برای خواندن از stdin از \- استفاده کنید)
      --max-age Duration                    فقط انتقال فایل‌های جدیدتر از این برحسب s یا پسوندهای ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تعیین، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض \-1)
      --max-size SizeSuffix                 فقط انتقال فایل‌های کوچک‌تر از این برحسب KiB یا پسوندهای B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از یک فایل (برای خواندن از stdin از \- استفاده کنید)
      --metadata-filter stringArray         افزودن یک قاعده فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متاداده از یک فایل (برای خواندن از stdin از \- استفاده کنید)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از یک فایل (برای خواندن از stdin از \- استفاده کنید)
      --min-age Duration                    فقط انتقال فایل‌های قدیمی‌تر از این برحسب s یا پسوندهای ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 فقط انتقال فایل‌های بزرگ‌تر از این برحسب KiB یا پسوندهای B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone serve (<https://rclone.org/commands/rclone_serve>) \- ارائه یک ریموت بر بستر یک پروتکل.
.SH rclone serve sftp
.PP
ارائه ریموت از طریق SFTP.
.SS خلاصه دستور (SYNOPSIS)
.PP
اجرای یک سرور SFTP برای ارائه یک ریموت بر بستر SFTP.
این دستور می‌تواند با یک کلاینت SFTP استفاده شود یا می‌توانید ریموتی از نوع
sftp برای استفاده با آن بسازید.
.PP
می‌توانید از پرچم‌های فیلتر (مانند
\f[V]--include\f[R]، \f[V]--exclude\f[R]) برای کنترل موارد ارائه‌شده استفاده کنید.
.PP
سرور به تعداد اندکی از دستورات شل پاسخ خواهد داد، عمدتاً
md5sum، sha1sum و df، که آن را قادر می‌سازد تا هنگام دسترسی از یک ریموت sftp، پشتیبانی از چکسام‌ها
و قابلیت about را فراهم کند.
.PP
توجه داشته باشید که این سرور از اندازه بارِ بسته (payload) استاندارد 32 KiB استفاده می‌کند، بدین
معنی که نباید کلاینت را برای انتظار مقداری دیگر پیکربندی کنید، مثلاً
با گزینه chunk_size (<https://rclone.org/sftp/#sftp-chunk-size>) روی
یک ریموت sftp.
.PP
سرور خطاها را لاگ می‌کند.
از \f[V]\-v\f[R] برای مشاهده لاگ‌های دسترسی استفاده کنید.
.PP
\f[V]--bwlimit\f[R] برای انتقال فایل‌ها رعایت خواهد شد.
از \f[V]--stats\f[R] برای کنترل چاپ آمار استفاده کنید.
.PP
باید روشی برای احراز هویت تعیین کنید، یا با
\f[V]--user\f[R]/\f[V]--pass\f[R]، یا فایل کلیدهای مجاز (مکان آن را با
\f[V]--authorized-keys\f[R] مشخص کنید \- پیش‌فرض همانند
ssh است)، یا یک \f[V]--auth-proxy\f[R]، و یا تنظیم پرچم \f[V]--no-auth\f[R] برای
عدم احراز هویت هنگام ورود.
.PP
اگر یک \f[V]--key\f[R] میزبان ارائه ندهید، rclone انواع کلیدهای
rsa، ecdsa و ed25519 را ایجاد کرده و آن‌ها را برای استفاده‌های بعدی در دایرکتوری کش rclone
(دستور \f[V]rclone help flags cache-dir\f[R] را ببینید)
درون دایرکتوری \[dq]serve-sftp\[dq] ذخیره می‌کند.
.PP
به‌طور پیش‌فرض سرور به localhost:2022 متصل می‌شود \- اگر می‌خواهید از
خارج قابل دسترس باشد، برای مثال \f[V]--addr :2022\f[R] را ارائه دهید.
.PP
این دستور همچنین از اجرا با فعال‌سازی سوکت (socket activation) پشتیبانی می‌کند، که در این حالت
روی نخستین توصیف‌کننده پرونده (FD) ارسال‌شده شنود خواهد کرد.
این مورد می‌تواند با فایل‌های واحد .socket و .service پیکربندی شود، همان‌طور که در
<https://www.freedesktop.org/software/systemd/man/latest/systemd.socket.html>
شرح داده شده است.
.PP
فعال‌سازی سوکت را می‌توان به‌طور موردی با دستور
\f[V]systemd-socket-activate\f[R] آزمایش کرد:
.IP
.nf
\f[C]
systemd-socket-activate -l 2222 -- rclone serve sftp :local:vfs/
\f[R]
.fi
.PP
این کار rclone را در نخستین اتصال به پورت 2222 بر بستر TCP فعال (socket-activate) می‌کند.
.PP
توجه داشته باشید که مقدار پیش‌فرض \f[V]--vfs-cache-mode off\f[R] برای backend اس‌اف‌تی‌پی
rclone مناسب است، اما ممکن است با سایر کلاینت‌های SFTP مناسب نباشد.
.PP
اگر \f[V]--stdio\f[R] مشخص شده باشد، rclone سرویس SFTP را بر بستر stdio ارائه می‌دهد،
که می‌تواند از طریق \[ti]/.ssh/authorized_keys با sshd استفاده شود، برای مثال:
.IP
.nf
\f[C]
restrict,command=\[dq]rclone serve sftp --stdio ./photos\[dq] ssh-rsa ...
\f[R]
.fi
.PP
در سمت کلاینت هنگام استفاده از \f[V]--stdio\f[R] باید مقدار \f[V]--transfers 1\f[R] را تنظیم کنید.
در غیر این صورت چندین نمونه از سرور rclone توسط OpenSSH راه‌اندازی می‌شود
که می‌تواند به خطاهای \[dq]corrupted on transfer\[dq] منجر گردد.
علت این است که کلاینت بدون تفکیک انتخاب می‌کند که دستورات را به کدام
سرور بفرستد، در حالی که همه سرورها دید متفاوتی از وضعیت سیستم فایل دارند.
.PP
عبارت \[dq]restrict\[dq] در authorized_keys مانع استفاده از SHA1SUMs و MD5SUMs
می‌شود.
حذف \[dq]restrict\[dq] و استفاده از \f[V]--sftp-path-override\f[R] برای
فعال‌سازی بررسی چکسام امکان‌پذیر است اما امنیت کمتری دارد و در این حالت می‌توانید
از سرور SFTP ارائه‌شده توسط OpenSSH استفاده کنید..SS "VFS \- سامانه فایل مجازی (Virtual File System)"
.PP
این دستور از لایه VFS استفاده می‌کند.
این لایه اشیاء ذخیره‌سازی ابریِ مورد استفاده rclone را به ساختاری منطبق می‌کند که بسیار شبیه به یک سامانه فایل دیسکی عمل می‌کند.
.PP
اشیاء ذخیره‌سازی ابری ویژگی‌های فراوانی دارند که مانند فایل‌های دیسک نیست \- برای نمونه نمی‌توان اندازه آن‌ها را گسترش داد یا در میانه‌شان نوشت؛ بنابراین لایه VFS باید با این موضوع مقابله کند.
از آنجا که یک روش واحد و یگانه برای انجام این کار وجود ندارد، گزینه‌های گوناگونی در دسترس است که در ادامه توضیح داده شده‌اند.
.PP
لایه VFS همچنین یک کَش دایرکتوری را پیاده‌سازی می‌کند \- این قابلیت، اطلاعات مربوط به فایل‌ها و دایرکتوری‌ها (و نه داده‌ها) را در حافظه نگه‌داری (کَش) می‌کند.
.SS "کَش دایرکتوری VFS (VFS Directory Cache)"
.PP
با استفاده از پرچم \f[V]--dir-cache-time\f[R] می‌توانید مدت زمانی را کنترل کنید که یک دایرکتوری به‌روز در نظر گرفته شده و از بک‌اند (backend) بازخوانی مجدد نشود.
تغییرات اعمال‌شده از طریق VFS بلافاصله نمایان می‌شوند یا کَش را نامعتبر (invalidate) می‌کنند.
.IP
.nf
\f[C]
    --dir-cache-time duration   Time to cache directory entries for (default 5m0s)
    --poll-interval duration    Time to wait between polling for changes. Must be smaller than dir-cache-time. Only on supported remotes. Set to 0 to disable (default 1m0s)
\f[R]
.fi
.PP
با این حال، در صورتی که بک‌اندِ پیکربندی‌شده از نظرسنجی (polling) برای بررسی تغییرات پشتیبانی نکند، تغییراتی که مستقیماً از طریق رابط وب یا نسخه‌ای دیگر از rclone روی ذخیره‌سازی ابری اعمال شوند، تنها پس از منقضی شدن کَش دایرکتوری شناسایی خواهند شد.
اگر بک‌اند از نظرسنجی پشتیبانی کند، تغییرات در بازه زمانی نظرسنجی (polling interval) اعمال می‌شوند.
.PP
می‌توانید یک سیگنال \f[V]SIGHUP\f[R] به rclone ارسال کنید تا بدون در نظر گرفتن عمر کَش‌ها، تمام کَش‌های دایرکتوری را پاک‌سازی (flush) کند.
با فرض اجرای تنها یک نمونه از rclone، می‌توانید کَش را بدین صورت بازنشانی کنید:
.IP
.nf
\f[C]
kill -SIGHUP $(pidof rclone)
\f[R]
.fi
.PP
اگر rclone را با کنترل از راه دور پیکربندی کرده باشید، می‌توانید با استفاده از \f[V]rclone rc\f[R] کل کَش دایرکتوری را تخلیه نمایید:
.IP
.nf
\f[C]
rclone rc vfs/forget
\f[R]
.fi
.PP
یا برای فایل‌ها یا دایرکتوری‌های مشخص:
.IP
.nf
\f[C]
rclone rc vfs/forget file=path/to/file dir=path/to/dir
\f[R]
.fi
.SS "بافرسازی فایل VFS (VFS File Buffering)"
.PP
پرچم \f[V]--buffer-size\f[R] مقدار حافظه‌ای را مشخص می‌کند که برای بافربندی پیشاپیش داده‌ها استفاده خواهد شد.
.PP
هر فایلِ باز تلاش می‌کند مقدار داده مشخص‌شده را همواره در حافظه نگه‌داری کند.
داده‌های بافرشده به یک فایل باز محدود بوده و به اشتراک گذاشته نخواهند شد.
.PP
این پرچم حد بالایی برای حافظه مصرفی به ازای هر فایل باز تعیین می‌کند.
بافر تنها برای داده‌هایی حافظه مصرف می‌کند که دانلود شده اما هنوز خوانده نشده‌اند.
اگر بافر خالی باشد، تنها مقدار اندکی حافظه مصرف خواهد شد.
.PP
حداکثر حافظه استفاده‌شده توسط rclone برای بافربندی می‌تواند تا سقف
\f[V]--buffer-size * open files\f[R]
باشد.
.SS "کَش فایل VFS (VFS File Caching)"
.PP
این پرچم‌ها گزینه‌های کَش‌کردن فایل VFS را کنترل می‌کنند.
کَش‌کردن فایل جهت سازگار جلوه دادن لایه VFS با یک سامانه فایل عادی ضروری است.
می‌توان آن را به قیمت کاهش سطح سازگاری غیرفعال کرد.
.PP
برای نمونه، اگر بخواهید به‌طور هم‌زمان از یک فایل بخوانید و در آن بنویسید، باید کَش VFS را فعال کنید.
برای جزئیات بیشتر به بخش زیر مراجعه کنید.
.PP
توجه داشته باشید که کَش VFS از بک‌اندِ کَش (cache backend) مجزاست و ممکن است دریابید که به یکی از آن‌ها یا هر دو نیاز دارید.
.IP
.nf
\f[C]
    --cache-dir string                     Directory rclone will use for caching.
    --vfs-cache-mode CacheMode             Cache mode off|minimal|writes|full (default off)
    --vfs-cache-max-age duration           Max time since last access of objects in the cache (default 1h0m0s)
    --vfs-cache-max-size SizeSuffix        Max total size of objects in the cache (default off)
    --vfs-cache-min-free-space SizeSuffix  Target minimum free space on the disk containing the cache (default off)
    --vfs-cache-poll-interval duration     Interval to poll the cache for stale objects (default 1m0s)
    --vfs-write-back duration              Time to writeback files after last use when using cache (default 5s)
\f[R]
.fi
.PP
در صورت اجرا با \f[V]-vv\f[R]، دستور rclone مسیر قرارگیری کَش فایل را چاپ خواهد کرد.
فایل‌ها در ناحیه فایل‌های کَش کاربر ذخیره می‌شوند که وابسته به سیستم‌عامل است، اما می‌توان آن را با \f[V]--cache-dir\f[R] یا با تنظیم متغیر محیطی مناسب مهار کرد.
.PP
کَش دارای ۴ حالت مختلف است که توسط \f[V]--vfs-cache-mode\f[R] تعیین می‌شوند.
هرچه حالت کَش بالاتر باشد rclone سازگارتر عمل می‌کند، اما به بهای مصرف فضای دیسک بیشتر.
.PP
توجه داشته باشید که فایل‌ها تنها زمانی در ریموت بازنویسی (write back) می‌شوند که بسته شده باشند و به مدت \f[V]--vfs-write-back\f[R] ثانیه به آن‌ها دسترسی پیدا نشده باشد.
اگر rclone متوقف شود یا پیش از آپلود فایل‌ها به صورت ناگهانی بسته شود، این فایل‌ها در اجرای بعدی rclone با همان پرچم‌ها آپلود خواهند شد.
.PP
در صورت استفاده از \f[V]--vfs-cache-max-size\f[R] یا
\f[V]--vfs-cache-min-free-space\f[R] توجه داشته باشید که کَش ممکن است به دو دلیل از این سهمیه‌ها فراتر رود:
نخست به این دلیل که بررسی سهمیه تنها در هر بازه
\f[V]--vfs-cache-poll-interval\f[R]
انجام می‌شود.
دوم به این دلیل که فایل‌های باز را نمی‌توان از کَش بیرون راند (evict کرد).
هنگامی که حجم کَش از حد \f[V]--vfs-cache-max-size\f[R] یا
\f[V]--vfs-cache-min-free-space\f[R] فراتر رود، rclone تلاش می‌کند نخست فایل‌هایی را که کمترین دسترسی را داشته‌اند از کَش خارج کند.
دستور rclone با فایل‌هایی شروع می‌کند که بیشترین مدت بدون دسترسی مانده‌اند.
این راهبرد تخلیه کَش کارآمد است و فایل‌های مرتبط‌تر احتمال بیشتری برای باقی ماندن در کَش خواهند داشت.
.PP
گزینه \f[V]--vfs-cache-max-age\f[R] پس از سپری شدن زمان تعیین‌شده از آخرین دسترسی، فایل‌ها را از کَش بیرون می‌راند؛ این فرآیند بر پایه زمان آخرین دسترسی است، نه بر اساس زمانی که فایل برای نخستین بار به کَش افزوده شده است.
مقدار پیش‌فرضِ ۱ ساعت باعث می‌شود فایل‌هایی که به مدت ۱ ساعت هیچ دسترسی نداشته‌اند از کَش خارج شوند.
هنگامی که به یک فایل کَش‌شده دسترسی پیدا شود، زمان‌سنج ۱ ساعته به ۰ بازنشانی می‌شود و پیش از تخلیه، ۱ ساعت دیگر منتظر می‌ماند.
زمان را با نشانه‌گذاری‌های استاندارد مانند s (ثانیه)، m (دقیقه)، h (ساعت)، d (روز) و w (هفته) مشخص کنید.
.PP
شما \f[B]نباید\f[R] در صورت استفاده از
\f[V]--vfs-cache-mode > off\f[R]،
دو نسخه از rclone را با کَش VFS یکسان روی ریموت‌های یکسان یا هم‌پوشان اجرا کنید.
انجام این کار می‌تواند بالقوه باعث خرابی و فساد داده‌ها شود.
می‌توانید با اختصاص دادن سلسله‌مراتب کَش اختصاصی به هر rclone از طریق \f[V]--cache-dir\f[R]، این محدودیت را برطرف کنید.
در صورتی که ریموت‌های مورد استفاده هم‌پوشانی ندارند، نیازی به نگرانی در این مورد نیست..SS --vfs-cache-mode off
.PP
در این حالت (پیش‌فرض)، حافظهٔ نهان (کَش) مستقیماً از ریموت خوانده و بدون ذخیره‌سازی هیچ‌چیز روی دیسک، مستقیماً بر روی ریموت می‌نویسد.
.PP
این بدان معناست که برخی از عملیات‌ها امکان‌پذیر نخواهند بود:
.IP \[bu] 2
فایل‌ها نمی‌توانند هم‌زمان برای خواندن و نوشتن باز شوند
.IP \[bu] 2
روی فایل‌های باز شده برای نوشتن نمی‌توان پیمایش (seek) انجام داد
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید پرچم O_TRUNC برای آن‌ها تنظیم شده باشد
.IP \[bu] 2
فایل‌های باز شده برای خواندن همراه با O_TRUNC، به‌صورت فقط‌نوشتنی باز خواهند شد
.IP \[bu] 2
فایل‌های باز شده به‌صورت فقط‌نوشتنی به‌گونه‌ای عمل می‌کنند که گویی O_TRUNC مشخص شده است
.IP \[bu] 2
حالت‌های باز کردن O_APPEND و O_TRUNC نادیده گرفته می‌شوند
.IP \[bu] 2
در صورت شکست در بارگذاری، امکان تلاش مجدد وجود ندارد
.SS --vfs-cache-mode minimal
.PP
این حالت بسیار شبیه به \[dq]off\[dq] است، با این تفاوت که فایل‌های باز شده برای خواندن و نوشتن هم‌زمان، روی دیسک بافر می‌شوند.
این موضوع باعث می‌شود فایل‌های باز شده برای نوشتن سازگاری بسیار بیشتری داشته باشند، در حالی که حداقل فضای دیسک مصرف می‌شود.
.PP
این عملیات‌ها امکان‌پذیر نیستند:
.IP \[bu] 2
روی فایل‌های باز شده به‌صورت فقط‌نوشتنی نمی‌توان پیمایش (seek) انجام داد
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید O_TRUNC برای آن‌ها تنظیم شده باشد
.IP \[bu] 2
فایل‌های باز شده به‌صورت فقط‌نوشتنی O_APPEND و O_TRUNC را نادیده می‌گیرند
.IP \[bu] 2
در صورت شکست در بارگذاری، امکان تلاش مجدد وجود ندارد
.SS --vfs-cache-mode writes
.PP
در این حالت، فایل‌های باز شده به‌صورت فقط‌خواندنی همچنان مستقیماً از ریموت خوانده می‌شوند، اما فایل‌های فقط‌نوشتنی و خواندنی/نوشتنی ابتدا روی دیسک بافر می‌شوند.
.PP
این حالت باید از تمام عملیات‌های عادی سیستم‌فایل پشتیبانی کند.
.PP
در صورت شکست در بارگذاری، تلاش مجدد در فواصل زمانی با افزایش تصاعدی تا حداکثر ۱ دقیقه انجام خواهد شد.
.SS --vfs-cache-mode full
.PP
در این حالت، تمام عملیات‌های خواندن و نوشتن از دیسک و روی دیسک بافر می‌شوند.
هنگامی که داده‌ها از ریموت خوانده می‌شوند، بر روی دیسک نیز بافر خواهند شد.
.PP
در این حالت، فایل‌های موجود در کَش به‌صورت فایل‌های کم‌پشت (sparse files) خواهند بود و rclone بخش‌های دانلودشده از فایل‌ها را ردیابی خواهد کرد.
.PP
بنابراین اگر برنامه‌ای تنها ابتدای هر فایل را بخواند، rclone تنها ابتدای فایل را بافر می‌کند.
این فایل‌ها در کَش با اندازهٔ کامل خود نمایش داده می‌شوند، اما فایل‌هایی کم‌پشت هستند که تنها داده‌های دانلودشده در آن‌ها وجود دارند.
.PP
این حالت باید از تمام عملیات‌های عادی سیستم‌فایل پشتیبانی کند و در سایر موارد دقیقاً مشابه \f[V]--vfs-cache-mode\f[R] writes است.
.PP
هنگام خواندن یک فایل، rclone به اندازهٔ \f[V]--buffer-size\f[R] به علاوهٔ \f[V]--vfs-read-ahead\f[R] بایت جلوتر را پیش‌خوانی می‌کند.
مقدار \f[V]--buffer-size\f[R] در حافظه بافر می‌شود در حالی که \f[V]--vfs-read-ahead\f[R] روی دیسک بافر خواهد شد.
.PP
هنگام استفاده از این حالت، توصیه می‌شود مقدار \f[V]--buffer-size\f[R] بیش از حد بزرگ تنظیم نشود و در صورت نیاز، \f[V]--vfs-read-ahead\f[R] بزرگ‌تر در نظر گرفته شود.
.PP
\f[B]مهم:\f[R] همهٔ سیستم‌فایل‌ها از فایل‌های کم‌پشت (sparse files) پشتیبانی نمی‌کنند.
به‌ویژه سامانه‌های FAT/exFAT پشتیبانی نمی‌کنند.
اگر دایرکتوری کَش روی سیستم‌فایلی باشد که از فایل‌های کم‌پشت پشتیبانی نمی‌کند، rclone عملکرد بسیار ضعیفی خواهد داشت و در صورت تشخیص چنین وضعیتی، یک پیام ERROR ثبت خواهد کرد.
.SS اثرانگشت‌نگاری (Fingerprinting)
.PP
بخش‌های مختلف VFS از اثرانگشت‌نگاری استفاده می‌کنند تا بررسی کنند آیا نسخهٔ محلی یک فایل نسبت به فایل موجود در ریموت تغییر کرده است یا خیر.
اثرانگشت‌ها از موارد زیر ساخته می‌شوند:
.IP \[bu] 2
اندازه (size)
.IP \[bu] 2
زمان تغییر (modification time)
.IP \[bu] 2
کد هش (hash)
.PP
(در صورتی که روی یک شیء موجود باشند).
.PP
در برخی بَک‌اِندها، خواندن برخی از این مشخصه‌ها کُند است (به یک فراخوانی API اضافی برای هر شیء یا پردازش مضاعف نیاز دارند).
.PP
برای نمونه، \f[V]hash\f[R] در بَک‌اِندهای \f[V]local\f[R] و \f[V]sftp\f[R] کُند است؛ چرا که آن‌ها باید کل فایل را خوانده و هش آن را محاسبه کنند، و \f[V]modtime\f[R] در بَک‌اِندهای \f[V]s3\f[R]، \f[V]swift\f[R]، \f[V]ftp\f[R] و \f[V]qinqstor\f[R] کُند است؛ زیرا برای دریافت آن نیاز به یک فراخوانی API اضافی دارند.
.PP
اگر از پرچم \f[V]--vfs-fast-fingerprint\f[R] استفاده کنید، rclone عملیات‌های کُند را در اثرانگشت لحاظ نخواهد کرد.
این کار دقت اثرانگشت‌نگاری را کاهش می‌دهد اما سرعت آن را بسیار بالا می‌برد و زمان باز شدن فایل‌های کَش‌شده را بهبود می‌بخشد.
.PP
اگر کَش vfs را روی بَک‌اِندهای \f[V]local\f[R]، \f[V]s3\f[R] یا \f[V]swift\f[R] اجرا می‌کنید، استفاده از این پرچم توصیه می‌شود.
.PP
توجه داشته باشید که اگر مقدار این پرچم را تغییر دهید، ممکن است اثرانگشت فایل‌های موجود در کَش نامعتبر شده و نیاز باشد فایل‌ها دوباره دانلود شوند..SS خواندن تکه‌ای در VFS (VFS Chunked Reading)
.PP
هنگامی که rclone فایل‌ها را از یک ریموت می‌خواند، آن‌ها را به صورت تکه‌ای (chunk) دریافت می‌کند.
این بدان معناست که rclone به جای درخواست کل فایل، تکهٔ مشخص‌شده را می‌خواند.
این کار می‌تواند با درخواست تنها آن دسته از تکه‌هایی از ریموت که واقعاً خوانده می‌شوند، سهمیهٔ دانلود مصرف‌شده برای برخی ریموت‌ها را کاهش دهد؛ هرچند به قیمت افزایش تعداد درخواست‌ها تمام می‌شود.
.PP
این پرچم‌ها تکه‌بندی (chunking) را کنترل می‌کنند:
.IP
.nf
\f[C]
    --vfs-read-chunk-size SizeSuffix        خواندن اشیاء مبدأ به‌صورت تکه‌ای (پیش‌فرض 128M)
    --vfs-read-chunk-size-limit SizeSuffix  حداکثر اندازه در دو برابر شدن تکه‌ها (پیش‌فرض off)
    --vfs-read-chunk-streams int            تعداد جریان‌های موازی برای خواندن هم‌زمان
\f[R]
.fi
.PP
رفتار تکه‌بندی بسته به پارامتر
\f[V]--vfs-read-chunk-streams\f[R] متفاوت خواهد بود.
.SS \f[V]--vfs-read-chunk-streams\f[R] == 0
.PP
ابزار rclone خواندن را با تکه‌ای به اندازهٔ
\f[V]--vfs-read-chunk-size\f[R] آغاز کرده و سپس اندازه را برای هر خواندن دو برابر می‌کند.
هنگامی که \f[V]--vfs-read-chunk-size-limit\f[R] مشخص شده و بزرگتر از
\f[V]--vfs-read-chunk-size\f[R] باشد، اندازهٔ تکه برای هر فایل باز شده تنها تا زمان رسیدن به مقدار مشخص‌شده دو برابر خواهد شد.
اگر این مقدار برابر \[dq]off\[dq] باشد (که پیش‌فرض است)، محدودیت غیرفعال بوده و اندازهٔ تکه به‌طور نامحدود افزایش می‌یابد.
.PP
با \f[V]--vfs-read-chunk-size 100M\f[R] و
\f[V]--vfs-read-chunk-size-limit 0\f[R] بخش‌های زیر دانلود خواهند شد:
0-100M، 100M-200M، 200M-300M، 300M-400M و به همین ترتیب.
هنگامی که \f[V]--vfs-read-chunk-size-limit 500M\f[R] مشخص شود، نتیجه به‌صورت
0-100M، 100M-300M، 300M-700M، 700M-1200M، 1200M-1700M و غیره خواهد بود.
.PP
تنظیم \f[V]--vfs-read-chunk-size\f[R] روی \f[V]0\f[R] یا \[dq]off\[dq]
خواندن تکه‌ای را غیرفعال می‌کند.
.PP
تکه‌ها در حافظه بافر نخواهند شد.
.SS \f[V]--vfs-read-chunk-streams\f[R] > 0
.PP
ابزار rclone به تعداد \f[V]--vfs-read-chunk-streams\f[R] تکه به اندازهٔ
\f[V]--vfs-read-chunk-size\f[R] را به‌طور هم‌روند می‌خواند.
اندازه برای هر بار خواندن ثابت باقی خواهد ماند.
.PP
این قابلیت کارایی را در پیوندهای با تأخیر (latency) بالا یا پیوندهای با پهنای باند بسیار بالا به ذخیره‌سازهای شیء با کارایی بالا به‌طور چشمگیری بهبود می‌بخشد.
.PP
برای یافتن مقادیر بهینه برای
\f[V]--vfs-read-chunk-size\f[R] و \f[V]--vfs-read-chunk-streams\f[R]
به مقداری آزمون و خطا نیاز خواهد بود، زیرا این مقادیر به بک‌اند مورد استفاده و میزان تأخیر تا آن بستگی دارند.
.PP
برای ذخیره‌سازهای شیء با کارایی بالا (مانند AWS S3)، یک نقطهٔ شروع منطقی می‌تواند
\f[V]--vfs-read-chunk-streams 16\f[R] و
\f[V]--vfs-read-chunk-size 4M\f[R] باشد.
در آزمایش‌های انجام‌شده با AWS S3، مقیاس کارایی تقریباً متناسب با تنظیمات
\f[V]--vfs-read-chunk-streams\f[R] افزایش یافت.
.PP
تنظیمات مشابه باید برای پیوندهای با تأخیر بالا نیز کارایی داشته باشد، اما بسته به میزان تأخیر ممکن است برای دستیابی به توان عملیاتی (throughput) مناسب، به مقدار بیشتری از
\f[V]--vfs-read-chunk-streams\f[R] نیاز باشد.
.SS کارایی VFS (VFS Performance)
.PP
این پرچم‌ها ممکن است برای فعال یا غیرفعال کردن قابلیت‌های VFS به دلایل کارایی یا موارد دیگر استفاده شوند.
همچنین قابلیت خواندن تکه‌ای (chunked reading) را بررسی کنید.
.PP
به‌ویژه S3 و Swift سود فراوانی از پرچم
\f[V]--no-modtime\f[R] می‌برند (یا برای اثری کمی متفاوت از \f[V]--use-server-modtime\f[R] استفاده کنید)؛ چرا که هر بار خواندن زمان تغییر، نیازمند یک تراکنش است.
.IP
.nf
\f[C]
    --no-checksum     عدم مقایسه چک‌سام‌ها در بارگذاری/دانلود.
    --no-modtime      عدم خواندن/نوشتن زمان تغییر (می‌تواند سرعت را افزایش دهد).
    --no-seek         عدم اجازه پرش (seeking) درون فایل‌ها.
    --read-only       تنها اجازه دسترسی فقط‌خواندنی.
\f[R]
.fi
.PP
گاهی اوقات درخواست‌های خواندن یا نوشتن به‌صورت نامرتب به rclone تحویل داده می‌شوند.
به جای انجام عملیات seek، rclone مدت کوتاهی منتظر می‌ماند تا خواندن یا نوشتن مرتب وارد شود.
این پرچم‌ها تنها در صورتی اثرگذار خواهند بود که از فایل کش روی دیسک استفاده نشود.
.IP
.nf
\f[C]
    --vfs-read-wait duration   مدت زمان انتظار برای خواندن مرتب قبل از پرش (پیش‌فرض 20ms)
    --vfs-write-wait duration  مدت زمان انتظار برای نوشتن مرتب قبل از اعلام خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
هنگام استفاده از کش نوشتن VFS (\f[V]--vfs-cache-mode\f[R] با مقادیر
writes یا full)، پرچم سراسری \f[V]--transfers\f[R] را می‌توان برای تنظیم تعداد آپلودهای موازی فایل‌های تغییریافته از کش تنظیم نمود (پرچم سراسری مرتبط \f[V]--checkers\f[R] هیچ تأثیری بر VFS ندارد).
.IP
.nf
\f[C]
    --transfers int  تعداد انتقال‌های موازی فایل‌ها برای اجرا (پیش‌فرض 4)
\f[R]
.fi.SS پیوندهای نمادین (Symlinks)
.PP
به‌طور پیش‌فرض، VFS از پیوندهای نمادین پشتیبانی نمی‌کند.
با این حال، این قابلیت را می‌توان با هر یک از پرچم‌های زیر فعال کرد:
.IP
.nf
\f[C]
    --links      تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq].
    --vfs-links  تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
\f[R]
.fi
.PP
از آنجا که بیشتر سامانه‌های ذخیره‌سازی ابری مستقیماً از پیوندهای نمادین پشتیبانی نمی‌کنند، rclone پیوند نمادین را به‌صورت یک فایل معمولی با یک پسوند ویژه ذخیره می‌کند.
بنابراین فایلی که به شکل پیوند نمادین \f[V]link-to-file.txt\f[R] نمایش داده می‌شود، در فضای ذخیره‌سازی ابری به‌صورت \f[V]link-to-file.txt.rclonelink\f[R] ذخیره خواهد شد و محتوای آن، مسیر مقصد پیوند نمادین خواهد بود.
.PP
توجه داشته باشید که \f[V]--links\f[R] تبدیل پیوند نمادین را به‌طور سراسری در rclone فعال می‌کند \- این شامل هر backend که از این مفهوم پشتیبانی کند (برای نمونه backend محلی) می‌شود.
گزینهٔ \f[V]--vfs-links\f[R] تنها آن را برای لایهٔ VFS فعال می‌سازد.
.PP
این طرح با روش مورد استفاده توسط backend محلی با پرچم \f[V]--local-links\f[R] سازگار است (<https://rclone.org/local/#symlinks-junction-points>).
.PP
پرچم \f[V]--vfs-links\f[R] برای دستورهای \f[V]rclone mount\f[R]، \f[V]rclone nfsmount\f[R] و \f[V]rclone serve nfs\f[R] طراحی شده است.
.PP
این پرچم هنوز با سایر دستورهای \f[V]rclone serve\f[R] آزمایش نشده است.
.PP
یکی از محدودیت‌های پیاده‌سازی فعلی این است که انتظار دارد فراخواننده، زیر‌پیوندهای نمادین را برطرف (resolve) کند.
برای نمونه، با در نظر گرفتن این درخت دایرکتوری:
.IP
.nf
\f[C]
\&.
├── dir
│\ \  └── file.txt
└── linked-dir -> dir
\f[R]
.fi
.PP
لایهٔ VFS پیوند \f[V]linked-dir\f[R] را به‌درستی برطرف می‌کند، اما \f[V]linked-dir/file.txt\f[R] را برطرف نخواهد کرد.
این مورد برای دستورهای آزمایش‌شده مشکلی ایجاد نمی‌کند، اما ممکن است برای دستورهای دیگر مشکل‌ساز شود.
.PP
\f[B]توجه\f[R] داشته باشید که یک مشکل باز در پشتیبانی از پیوندهای نمادین وجود دارد: گزارش شمارهٔ #8245 (<https://github.com/rclone/rclone/issues/8245>) دربارهٔ ایجاد فایل‌های تکراری هنگام انتقال پیوندهای نمادین به دایرکتوری‌هایی که فایلی با همان نام در آن‌ها وجود دارد (یا برعکس).
.SS حساسیت VFS به حروف بزرگ و کوچک (VFS Case Sensitivity)
.PP
سیستم‌های فایل لینوکس به بزرگی و کوچکی حروف حساس هستند (case-sensitive): دو فایل می‌توانند تنها در بزرگی و کوچکی حروف با یکدیگر تفاوت داشته باشند، و هنگام باز کردن یک فایل باید دقیقاً همان بزرگی و کوچکی حروف استفاده شود.
.PP
سیستم‌های فایل در نسخه‌های جدید ویندوز به بزرگی و کوچکی حروف حساس نیستند اما حالت حروف را حفظ می‌کنند (case-insensitive but case-preserving): گرچه فایل‌های موجود را می‌توان با هر حالتی از حروف باز کرد، اما حالت دقیق حروفی که برای ایجاد فایل به کار رفته حفظ می‌شود و برنامه‌ها می‌توانند از آن پرس‌وجو کنند.
در یک دایرکتوری یکسان، وجود دو فایل که تنها در بزرگی و کوچکی حروف تفاوت دارند مجاز نیست.
.PP
معمولاً سیستم‌های فایل در macOS به بزرگی و کوچکی حروف حساس نیستند.
امکان حساس کردن سیستم‌های فایل macOS به حروف بزرگ و کوچک وجود دارد، اما این حالت پیش‌فرض نیست.
.PP
پرچم \f[V]--vfs-case-insensitive\f[R] در VFS چگونگی مدیریت این دو حالت را توسط rclone کنترل می‌کند.
اگر مقدار آن \[dq]false\[dq] باشد، rclone نام‌های فایل را همان‌گونه که هستند (as-is) به ریموت ارسال می‌کند.
اگر این پرچم \[dq]true\[dq] باشد (یا بدون مقدار در خط فرمان مشخص شود)، rclone ممکن است یک «اصلاح» (\[dq]fixup\[dq]) را طبق توضیحات زیر انجام دهد.
.PP
کاربر ممکن است نام فایلی را برای باز کردن/حذف/تغییر نام/غیره با حالتی از حروف متفاوت با آنچه در ریموت ذخیره شده است مشخص کند.
اگر یک آرگومان به فایلی موجود با دقیقاً همان نام اشاره کند، از حالت حروف فایل موجود روی دیسک استفاده خواهد شد.
با این حال، اگر نام فایلی با همان نام دقیق پیدا نشود اما نامی وجود داشته باشد که تنها در بزرگی و کوچکی حروف تفاوت دارد، rclone به‌طور شفاف نام را اصلاح می‌کند.
این اصلاح تنها زمانی رخ می‌دهد که یک فایل موجود درخواست شود.
حساسیت به بزرگی و کوچکی حروف برای نام فایل‌هایی که به تازگی توسط rclone ایجاد می‌شوند، توسط ریموت زیرین کنترل می‌شود.
.PP
توجه داشته باشید که حساسیت به حروف در سیستم‌عاملی که rclone را اجرا می‌کند (مقصد یا target) ممکن است با حساسیت سیستم فایلی که توسط rclone ارائه می‌شود (مبدأ یا source) تفاوت داشته باشد.
این پرچم کنترل می‌کند که آیا «اصلاح» (\[dq]fixup\[dq]) برای برآورده کردن نیازهای مقصد انجام شود یا خیر.
.PP
اگر این پرچم در خط فرمان مشخص نشود، مقدار پیش‌فرض آن به سیستم‌عاملی که rclone روی آن اجرا می‌شود بستگی دارد: در Windows و macOS برابر با \[dq]true\[dq]، و در غیر این صورت \[dq]false\[dq].
اگر پرچم بدون مقدار ارائه شود، برابر با \[dq]true\[dq] خواهد بود.
.PP
پرچم \f[V]--no-unicode-normalization\f[R] کنترل می‌کند که آیا «اصلاح» (\[dq]fixup\[dq]) مشابهی برای نام فایل‌هایی که متفاوت هستند اما از نظر یونیکد هم‌ارز محسوب می‌شوند (<https://en.wikipedia.org/wiki/Unicode_equivalence>) انجام شود یا خیر.
یکسان‌سازی یونیکد (Unicode normalization) می‌تواند به‌ویژه برای کاربران macOS مفید باشد، که فرم NFD را به جای فرم NFC (مورد استفاده در اکثر پلتفرم‌های دیگر) ترجیح می‌دهد.
بنابراین برای جلوگیری از مشکلات سازگاری کدگذاری، اکیداً توصیه می‌شود در macOS مقدار پیش‌فرض \f[V]false\f[R] حفظ شود.
.PP
در حالت (احتمالاً نادرِ) وجود چندین نام فایل تکراری در یک دایرکتوری پس از اعمال یکسان‌سازی یونیکد و تطبیق بزرگی و کوچکی حروف، پرچم \f[V]--vfs-block-norm-dupes\f[R] امکان پنهان‌سازی این موارد تکراری را فراهم می‌کند.
این قابلیت با افت کارایی همراه است، زیرا rclone هنگام فهرست کردن یک دایرکتوری باید کل دایرکتوری را برای یافتن موارد تکراری پویش کند.
به همین دلیل، توصیه می‌شود در صورت عدم نیاز، این گزینه غیرفعال بماند.
با این حال، ممکن است کاربران macOS مایل به استفاده از آن باشند؛ چرا که در غیر این صورت، اگر یک دایرکتوری در ریموت شامل هر دو نسخهٔ NFC و NFD از یک نام فایل باشد، وضعیت عجیبی رخ خواهد داد: هر دو نسخه از فایل در مانت قابل مشاهده خواهند بود و هر دو قابل ویرایش به نظر می‌رسند، اما ویرایش هر کدام از نسخه‌ها در عمل تنها به ویرایش نسخهٔ NFD در پس‌زمینه منجر خواهد شد.
پرچم \f[V]--vfs-block-norm-dupes\f[R] با شناسایی این سناریو، پنهان کردن موارد تکراری و ثبت خطا در گزارش، مشابه نحوهٔ برخورد با این موضوع در \f[V]rclone sync\f[R]، از این سردرگمی جلوگیری می‌کند..SS گزینه‌های دیسک VFS
.PP
این پرچم به شما امکان می‌دهد تا آمار مربوط به سیستم فایل را به‌صورت دستی
تنظیم کنید.
این ویژگی می‌تواند زمانی که این اطلاعات به‌طور خودکار و دقیق خوانده
نمی‌شوند، مفید باشد.
.IP
.nf
\f[C]
    --vfs-disk-space-total-size    تنظیم دستی اندازه کل فضای دیسک (مثال: 256G، پیش‌فرض: -1)
\f[R]
.fi
.SS گزارش جایگزین بایت‌های مصرف‌شده
.PP
برخی از backendها، به‌ویژه S3، میزان بایت‌های مصرف‌شده را گزارش نمی‌کنند.
اگر نیاز دارید این اطلاعات هنگام اجرای \f[V]df\f[R] روی سیستم فایل در
دسترس باشد، پرچم \f[V]--vfs-used-is-size\f[R] را به rclone ارسال کنید.
با تنظیم این پرچم، rclone به‌جای اتکا به backend برای گزارش این اطلاعات،
کل ریموت را مشابه با \f[V]rclone size\f[R] پویش کرده و کل فضای استفاده‌شده
را خودش محاسبه می‌کند.
.PP
\f[B]هشدار\f[R]: برخلاف \f[V]rclone size\f[R]، این پرچم فیلترها را نادیده
می‌گیرد تا نتیجه دقیق باشد.
با این حال، این کار بسیار ناکارآمد است و ممکن است باعث فراخوانی‌های متعدد
API و در نتیجه هزینه‌های اضافی شود.
از آن تنها به عنوان آخرین راهکار و فقط به همراه حافظهٔ نهان (caching) استفاده کنید.
.SS متادیتای VFS
.PP
اگر از پرچم \f[V]--vfs-metadata-extension\f[R] استفاده کنید، می‌توانید کاری
کنید که VFS فایل‌های حاوی
متادیتا (https://rclone.org/docs/#metadata) را به صورت یک شیء JSON ارائه دهد.
این فایل‌ها در فهرست دایرکتوری نمایش داده نمی‌شوند، اما می‌توان روی آن‌ها
\f[V]stat\f[R] گرفت و آن‌ها را باز کرد؛ و پس از اینکه باز شدند، تا زمان انقضای
حافظهٔ نهان دایرکتوری در فهرست دایرکتوری‌ها ظاهر \f[B]خواهند شد\f[R].
.PP
توجه داشته باشید که برخی از backendها متادیتا ایجاد نمی‌کنند، مگر اینکه
پرچم \f[V]--metadata\f[R] را ارسال کرده باشید.
.PP
برای نمونه، با استفاده از \f[V]rclone mount\f[R] به همراه
\f[V]--metadata --vfs-metadata-extension .metadata\f[R] خواهیم داشت:
.IP
.nf
\f[C]
$ ls -l /mnt/
total 1048577
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G

$ cat /mnt/1G.metadata
{
        \[dq]atime\[dq]: \[dq]2025-03-04T17:34:22.317069787Z\[dq],
        \[dq]btime\[dq]: \[dq]2025-03-03T16:03:37.708253808Z\[dq],
        \[dq]gid\[dq]: \[dq]1000\[dq],
        \[dq]mode\[dq]: \[dq]100664\[dq],
        \[dq]mtime\[dq]: \[dq]2025-03-03T16:03:39.640238323Z\[dq],
        \[dq]uid\[dq]: \[dq]1000\[dq]
}

$ ls -l /mnt/
total 1048578
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G
-rw-rw-r-- 1 user user        185 Mar  3 16:03 1G.metadata
\f[R]
.fi
.PP
اگر فایل متادیتایی نداشته باشد به‌صورت \f[V]{}\f[R] بازگردانده می‌شود، و در
صورت بروز خطا در خواندن متادیتا، خطا به‌شکل
\f[V]{\[dq]error\[dq]:\[dq]error string\[dq]}\f[R] برگردانده خواهد شد.
.SS پروکسی احراز هویت (Auth Proxy)
.PP
اگر پارامتر \f[V]--auth-proxy /path/to/program\f[R] را مشخص کنید، آنگاه
rclone از آن برنامه برای ساخت بلادرنگ backendهایی استفاده می‌کند که برای
احراز هویت درخواست‌های ورودی به کار می‌روند.
این سازوکار از یک پروتکل سادهٔ مبتنی بر JSON با ورودی روی STDIN و خروجی روی
STDOUT استفاده می‌کند.
.PP
\f[B]لطفاً توجه داشته باشید:\f[R] گزینه‌های \f[V]--auth-proxy\f[R] و
\f[V]--authorized-keys\f[R] نمی‌توانند هم‌زمان استفاده شوند؛ اگر
\f[V]--auth-proxy\f[R] تنظیم شده باشد، گزینهٔ کلیدهای مجاز نادیده گرفته خواهد
شد.
.PP
یک برنامهٔ نمونه با نام
bin/test_proxy.py (https://github.com/rclone/rclone/blob/master/bin/test_proxy.py)
در کد منبع rclone وجود دارد.
.PP
وظیفهٔ برنامه این است که \f[V]user\f[R] و \f[V]pass\f[R] را در ورودی دریافت
کرده و آن‌ها را به پیکربندی یک backend در خروجی STDOUT با قالب JSON تبدیل
کند.
پارامترهای پیش‌فرض backend به این پیکربندی اضافه خواهند شد، اما از
پیکربندی‌های متغیرهای محیطی یا گزینه‌های خط فرمان استفاده نخواهد کرد \- آماده‌سازی
یک پیکربندی کامل بر عهدهٔ برنامهٔ پروکسی است.
.PP
پیکربندی تولید‌شده باید این پارامتر اضافه را داشته باشد:
.IP \[bu] 2
\f[V]_root\f[R] \- ریشه (root) مورد استفاده برای backend
.PP
و می‌تواند این پارامترها را نیز داشته باشد:
.IP \[bu] 2
\f[V]_obscure\f[R] \- رشته‌های جداشده با کاما برای پارامترهایی که باید مبهم‌سازی شوند
.IP \[bu] 2
\f[V]_secret_access_key\f[R] \- کلید محرمانه برای احراز هویت کلید دسترسی S3 (پایین را ببینید)
.PP
اگر احراز هویت با گذرواژه توسط کلاینت استفاده شده باشد، ورودی به فرایند پروکسی
(روی STDIN) شبیه به این خواهد بود:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]pass\[dq]: \[dq]mypassword\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
اگر احراز هویت با کلید عمومی توسط کلاینت استفاده شده باشد، ورودی به فرایند
پروکسی (روی STDIN) شبیه به این خواهد بود:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]public_key\[dq]: \[dq]AAAAB3NzaC1yc2EAAAADAQABAAABAQDuwESFdAe14hVS6omeyX7edc...JQdf\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
اگر کلاینت با یک کلید دسترسی S3 احراز هویت کند
(\f[V]rclone serve s3\f[R])، کلاینت هرگز کلید محرمانهٔ خود را ارسال نمی‌کند،
بلکه فقط امضای تولیدشده با آن را می‌فرستد؛ بنابراین ورودی تنها شامل شناسه
کلید دسترسی به عنوان \f[V]user\f[R] بدون هیچ \f[V]pass\f[R] یا
\f[V]public_key\f[R] خواهد بود:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]AKIAIOSFODNN7EXAMPLE\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
در این حالت، برنامه باید کلید دسترسی محرمانه را برای آن شناسه کلید دسترسی
جستجو کند و آن را در فیلد \f[V]_secret_access_key\f[R] در خروجی بازگرداند.
سپس rclone از آن کلید محرمانه برای اعتبارسنجی امضای روی درخواست استفاده
می‌کند و در صورت عدم تطابق، درخواست را رد می‌نماید.
این بدان معناست که برنامهٔ پروکسی مرجع اصلی (source of truth) هم برای اطلاعات
احراز هویت و هم برای backend متناظر با آن‌ها است.
اگر برنامه \f[V]_secret_access_key\f[R] را بازنگرداند یا آن را خالی برگرداند،
درخواست رد می‌شود.
.PP
پاسخ برنامه برای یک شناسه کلید دسترسی در حافظهٔ نهان ذخیره می‌شود (پایین را
ببینید)، اما حتی در صورت استفادهٔ مداوم از شناسه کلید دسترسی، پس از ۵ دقیقه
مجدداً از برنامه استعلام می‌شود؛ بنابراین لغو یک شناسه کلید دسترسی در برنامه
ظرف ۵ دقیقه اعمال می‌گردد.
یک کلید محرمانهٔ جایگزین‌شده (rotated) با اولین درخواستی که با آن امضا شده
باشد اعمال خواهد شد.
.PP
کلید \f[V]client_ip\f[R] آدرس IP مبدأ کلاینت را بدون شماره پورت در بر دارد.
می‌توان از آن برای محدود کردن ورودها به شبکه‌های خاص، یا ثبت متمرکز تلاش‌های
احراز هویت استفاده کرد.
اگر کلاینت آدرس IP نداشته باشد (برای نمونه هنگام اتصال از طریق سوکت یونیکس)،
این فیلد حذف می‌شود.
توجه داشته باشید که اگر rclone پشت یک reverse proxy باشد، این آدرس، آدرس
reverse proxy خواهد بود نه کلاینت اصلی.
.PP
و به عنوان نمونه چنین خروجی‌ای را روی STDOUT بازگرداند:
.IP
.nf
\f[C]
{
  \[dq]type\[dq]: \[dq]sftp\[dq],
  \[dq]_root\[dq]: \[dq]\[dq],
  \[dq]_obscure\[dq]: \[dq]pass\[dq],
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]pass\[dq]: \[dq]mypassword\[dq],
  \[dq]host\[dq]: \[dq]sftp.example.com\[dq]
}
\f[R]
.fi.PP
این بدان معناست که یک backend از نوع SFTP در لحظه برای
\f[V]user\f[R] و \f[V]pass\f[R]/\f[V]public_key\f[R] بازگردانده‌شده در
خروجی به میزبان مشخص‌شده ایجاد می‌شود.
توجه داشته باشید از آنجا که \f[V]_obscure\f[R] بر روی \f[V]pass\f[R] تنظیم شده است، rclone
پارامتر \f[V]pass\f[R] را پیش از ایجاد backend مبهم‌سازی خواهد کرد (که
برای backendهای sftp الزامی است).
.PP
برنامه می‌تواند \f[V]user\f[R] ارائه‌شده را به هر شکلی دستکاری کند؛ برای
نمونه به‌منظور پروکسی کردن به چندین backend مختلف sftp، می‌توانید
\f[V]user\f[R] را برابر \f[V]user\[at]example.com\f[R] قرار داده و سپس در خروجی
\f[V]host\f[R] را برابر \f[V]example.com\f[R] و کاربر را برابر
\f[V]user\f[R] تنظیم کنید.
از نظر امنیتی احتمالاً مایل خواهید بود که \f[V]host\f[R] را به یک
فهرست محدود مقید کنید.
.PP
یک حافظهٔ موقت (cache) داخلی از backendها بر اساس \f[V]user\f[R]، درهم‌سازی (هش) از
\f[V]pass\f[R] یا \f[V]public_key\f[R]، و \f[V]client_ip\f[R] کلیدگذاری می‌شود.
این بدان معناست که اگر گذرواژه یا کلید عمومی کاربر تغییر کند، کلاینت
از یک نشانی IP جدید متصل شود، یا پراکسی پارامترهای پیکربندی متفاوتی را بازگرداند
(مانند یک \f[V]api_key\f[R] چرخش‌یافته)، در درخواست بعدی یک backend
تازه به جای استفادهٔ مجدد از مورد ذخیره‌شده در حافظهٔ موقت ایجاد خواهد شد.
.PP
این قابلیت می‌تواند برای ساخت پراکسی‌های چندمنظوره برای هر نوع backend که
rclone از آن پشتیبانی می‌کند، استفاده شود.
.IP
.nf
\f[C]
rclone serve sftp remote:path [flags]
\f[R]
.fi
.SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
      --addr string                            نشانی IP:Port یا :Port برای مقید کردن سرور به آن (پیش‌فرض \[dq]localhost:2022\[dq])
      --auth-proxy string                      برنامه‌ای برای ایجاد backend از روی اطلاعات احراز هویت
      --authorized-keys string                 فایل کلیدهای مجاز (پیش‌فرض \[dq]\[ti]/.ssh/authorized_keys\[dq])
      --dir-cache-time Duration                مدت‌زمان نگهداری مدخل‌های دایرکتوری در حافظهٔ موقت (پیش‌فرض 5m0s)
      --dir-perms FileMode                     مجوزهای دایرکتوری (پیش‌فرض 777)
      --file-perms FileMode                    مجوزهای فایل (پیش‌فرض 666)
      --gid uint32                             بازنویسی فیلد gid تنظیم‌شده توسط سیستم‌فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1000)
  -h, --help                                   راهنمای sftp
      --key stringArray                        فایل کلید خصوصی میزبان SSH (می‌تواند چند مقداری باشد، برای تولید خودکار خالی بگذارید)
      --link-perms FileMode                    مجوزهای پیوند (پیش‌فرض 666)
      --no-auth                                در صورت تنظیم، اتصالات بدون احراز هویت مجاز می‌شوند
      --no-checksum                            عدم مقایسهٔ چک‌سام‌ها (checksum) هنگام بارگذاری/بارگیری
      --no-modtime                             عدم خواندن/نوشتن زمان تغییر (می‌تواند سرعت را افزایش دهد)
      --no-seek                                عدم اجازهٔ پرش (seeking) در فایل‌ها
      --pass string                            گذرواژه برای احراز هویت
      --poll-interval Duration                 زمان انتظار بین بررسی تغییرات، باید کمتر از dir-cache-time باشد و فقط در remoteهای پشتیبانی‌شده (0 برای غیرفعال‌سازی) (پیش‌فرض 1m0s)
      --read-only                              فقط دسترسی خواندن مجاز باشد
      --stdio                                  اجرای یک سرور sftp بر روی stdin/stdout
      --uid uint32                             بازنویسی فیلد uid تنظیم‌شده توسط سیستم‌فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 1000)
      --umask FileMode                         بازنویسی بیت‌های مجوز تنظیم‌شده توسط سیستم‌فایل (در Windows پشتیبانی نمی‌شود) (پیش‌فرض 002)
      --user string                            نام کاربری برای احراز هویت
      --vfs-block-norm-dupes                   در صورت وجود نام‌های تکراری در یک دایرکتوری (پس از یکسان‌سازی)، ثبت خطا و پنهان کردن موارد تکراری (ممکن است بار پردازشی داشته باشد)
      --vfs-cache-max-age Duration             حداکثر زمان گذشته از آخرین دسترسی به اشیاء در حافظه موقت (پیش‌فرض 1h0m0s)
      --vfs-cache-max-size SizeSuffix          حداکثر اندازهٔ کل اشیاء در حافظه موقت (پیش‌فرض off)
      --vfs-cache-min-free-space SizeSuffix    حداقل فضای خالی هدف روی دیسک حاوی حافظه موقت (پیش‌فرض off)
      --vfs-cache-mode CacheMode               حالت حافظه موقت off|minimal|writes|full (پیش‌فرض off)
      --vfs-cache-poll-interval Duration       بازهٔ زمانی نظرسنجی حافظه موقت برای اشیاء بیات‌شده (پیش‌فرض 1m0s)
      --vfs-case-insensitive                   در صورت نیافتن نام فایل، یافتن تطابق غیرحساس به بزرگی و کوچکی حروف
      --vfs-disk-space-total-size SizeSuffix   مشخص کردن کل فضای دیسک (پیش‌فرض off)
      --vfs-fast-fingerprint                   استفاده از اثر انگشت‌های سریع (با دقت کمتر) برای تشخیص تغییرات
      --vfs-handle-caching Duration            مدت‌زمان نگه‌داشتن دستگیره فایل و دریافت‌کننده‌ها پس از آخرین بستن (پیش‌فرض 5s)
      --vfs-links                              ترجمه پیوندهای نمادین به/از فایل‌های معمولی با پسوند \[aq].rclonelink\[aq] برای VFS
      --vfs-metadata-extension string          تنظیم پسوند برای خواندن فراداده از آن
      --vfs-read-ahead SizeSuffix              پیش‌خوانی اضافی فراتر از --buffer-size هنگام استفاده از cache-mode full
      --vfs-read-chunk-size SizeSuffix         خواندن اشیاء مبدأ به‌صورت تکه‌ای (پیش‌فرض 128Mi)
      --vfs-read-chunk-size-limit SizeSuffix   اگر بزرگ‌تر از --vfs-read-chunk-size باشد، اندازه تکه پس از هر بار خواندن دو برابر می‌شود تا به این حد برسد (\[aq]off\[aq] نامحدود است) (پیش‌فرض off)
      --vfs-read-chunk-streams int             تعداد جریان‌های موازی برای خواندن هم‌زمان
      --vfs-read-wait Duration                 زمان انتظار برای خواندن متوالی قبل از پیمایش (پیش‌فرض 20ms)
      --vfs-refresh                            تازه‌سازی بازگشتی حافظه موقت دایرکتوری در پس‌زمینه هنگام شروع
      --vfs-used-is-size rclone size           استفاده از الگوریتم rclone size برای حجم استفاده‌شده
      --vfs-write-back Duration                زمان بازنویسی فایل‌ها پس از آخرین استفاده هنگام به‌کارگیری حافظه موقت (پیش‌فرض 5s)
      --vfs-write-wait Duration                زمان انتظار برای نوشتن متوالی پیش از ایجاد خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید..SS گزینه‌های فیلتر (Filter Options)
.PP
پرچم‌هایی برای فیلتر کردن فهرست‌های پوشه
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی استثنا شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از - برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن پوشه‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل مبدأ از فایل (استفاده از - برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل مبدأ از فایل بدون هرگونه پردازش روی خطوط (استفاده از - برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (استفاده از - برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قاعده فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --hash-filter string                  افرازبندی نام‌فایل‌ها با هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده‌گرفتن بزرگی و کوچکی حروف در فیلترها (ناحساس به حروف بزرگ و کوچک)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از - برای خواندن از stdin)
      --max-age Duration                    تنها انتقال فایل‌های تازه‌تر از این مقدار برحسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 تنها انتقال فایل‌های کوچک‌تر از این مقدار برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض غیرفعال)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (استفاده از - برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قاعده فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متاداده از یک فایل (استفاده از - برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از فایل (استفاده از - برای خواندن از stdin)
      --min-age Duration                    تنها انتقال فایل‌های قدیمی‌تر از این مقدار برحسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --min-size SizeSuffix                 تنها انتقال فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض غیرفعال)
\f[R]
.fi
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone serve (https://rclone.org/commands/rclone_serve) - ارائه یک
ریموت بر بستر یک پروتکل.
.SH rclone serve webdav
.PP
ارائه remote:path بر بستر WebDAV.
.SS خلاصه دستور (SYNOPSIS)
.PP
یک سرور WebDAV پایه‌ای را برای ارائه یک ریموت بر بستر HTTP از طریق پروتکل WebDAV
اجرا کنید.
این مورد می‌تواند با یک کلاینت WebDAV یا از طریق یک مرورگر وب مشاهده شود، یا
می‌توانید یک ریموت از نوع WebDAV برای خواندن و نوشتن در آن ایجاد کنید.
.SS گزینه‌های WebDAV
.SS --etag-hash
.PP
این گزینه هدر ETag را کنترل می‌کند.
بدون این پرچم، مقدار ETag بر اساس ModTime و Size شیء
تعیین خواهد شد.
.PP
اگر این پرچم روی \[dq]auto\[dq] تنظیم شود، rclone نخستین هش پشتیبانی‌شده در بک‌اند را انتخاب خواهد کرد، یا می‌توانید از یک هش نام‌گذاری‌شده مانند
\[dq]MD5\[dq] یا \[dq]SHA-1\[dq] استفاده کنید.
برای دیدن فهرست کامل از دستور hashsum (https://rclone.org/commands/rclone_hashsum) استفاده
کنید.
.SS فشرده‌سازی Gzip
.PP
هنگامی که کلاینت پشتیبانی از gzip را از طریق هدر درخواست \f[V]Accept-Encoding: gzip\f[R]
اعلام کند، سرور بدنه برخی پاسخ‌های معین (متن و XML،
از جمله پاسخ‌های PROPFIND در WebDAV) را با استفاده از gzip فشرده
خواهد کرد.
این کار مصرف پهنای باند را کاهش می‌دهد.
.SS دسترسی به WebDAV در Windows
.PP
پوشه به اشتراک گذاشته شده WebDAV می‌تواند به‌عنوان یک درایو در Windows نگاشت شود، اما
تنظیمات پیش‌فرض از آن جلوگیری می‌کنند.
اتصال Windows به سرور با استفاده از احراز هویت ناامن Basic
با شکست مواجه خواهد شد.
حتی هیچ پنجره ورود به سیستمی را نمایش نخواهد داد.
ویندوز نیازمند آن است که برای استفاده از Basic از اتصال SSL / HTTPS استفاده شود.
اگر تلاش کنید از طریق Add Network Location Wizard متصل شوید، با
خطای زیر مواجه خواهید شد: \[dq]The folder you entered does not appear to be
valid.
Please choose another\[dq].
با این حال، اگر کلید رجیستری زیر را در دستگاه
کلاینت تنظیم کنید، همچنان می‌توانید متصل شوید:
\f[V]HKEY_LOCAL_MACHINE\[rs]SYSTEM\[rs]CurrentControlSet\[rs]Services\[rs]WebClient\[rs]Parameters\[rs]BasicAuthLevel\f[R]
روی مقدار 2.
مقدار BasicAuthLevel می‌تواند روی مقادیر زیر تنظیم شود:
.IP
.nf
\f[C]
0 - احراز هویت Basic غیرفعال است
1 - احراز هویت Basic فقط برای اتصال‌های SSL فعال است
2 - احراز هویت Basic برای اتصال‌های SSL و برای اتصال‌های غیر SSL فعال است
\f[R]
.fi
.PP
در صورت نیاز، مقدار FileSizeLimitInBytes را به مقدار بالاتری افزایش دهید.
به رابط کاربری Services رفته و سپس سرویس WebClient را بازراه‌اندازی کنید..SS دسترسی به برنامه‌های کاربردی Office در WebDAV
.PP
به مسیر رجیستری زیر بروید:
\f[V]HKEY_CURRENT_USER\[rs]Software\[rs]Microsoft\[rs]Office\[rs][14.0/15.0/16.0]\[rs]Common\[rs]Internet\f[R]
یک مقدار DWORD جدید به نام BasicAuthLevel با مقدار 2 ایجاد کنید.
.IP
.nf
\f[C]
0 - Basic authentication disabled
1 - Basic authentication enabled for SSL connections only
2 - Basic authentication enabled for SSL and for non-SSL connections
\f[R]
.fi
.PP
<https://learn.microsoft.com/en-us/office/troubleshoot/powerpoint/office-opens-blank-from-sharepoint>
.SS سرویس‌دهی از طریق unix socket
.PP
می‌توانید webdav را به این صورت روی یک unix socket ارائه دهید:
.IP
.nf
\f[C]
rclone serve webdav --addr unix:///tmp/my.socket remote:path
\f[R]
.fi
.PP
و با استفاده از rclone و backend مربوط به webdav به این صورت به آن متصل شوید:
.IP
.nf
\f[C]
rclone --webdav-unix-socket /tmp/my.socket --webdav-url http://localhost lsf :webdav:
\f[R]
.fi
.PP
توجه داشته باشید که هیچ احراز هویتی روی پروتکل http وجود ندارد \- انتظار می‌رود این کار توسط مجوزهای دسترسی روی سوکت انجام شود.
.SS پیوندهای نمادین / Junction points
.PP
پروتکل webdav از پیوندهای نمادین (symlinks) یا junction pointها پشتیبانی نمی‌کند و به‌طور پیش‌فرض rclone آن‌ها را کاملاً نادیده می‌گیرد.
.PP
می‌توانید از \f[V]-L\f[R] استفاده کنید تا rclone پیوندهای نمادین را دنبال کند یا از \f[V]--local-links\f[R] استفاده کنید تا rclone فایل‌های \f[V].rclonelink\f[R] را به جای پیوندهای نمادین نمایش دهد.
.PP
\f[B]توجه:\f[R] از \f[V]--links\f[R] استفاده نکنید، زیرا از نسخه v1.69 این گزینه روی لایه VFS نیز اعمال می‌شود؛ از \f[V]--local-links\f[R] استفاده کنید که فقط روی backend محلی (local) اعمال می‌شود.
.SS گزینه‌های سرور
.PP
از \f[V]--addr\f[R] برای مشخص کردن آدرس IP و پورتی که سرور باید روی آن گوش فرا دهد استفاده کنید، مثلاً \f[V]--addr 1.2.3.4:8000\f[R] یا \f[V]--addr :8080\f[R] برای گوش دادن روی تمام IPها.
به‌طور پیش‌فرض فقط روی localhost گوش می‌دهد.
می‌توانید از پورت :0 استفاده کنید تا سیستم‌عامل یک پورت در دسترس را انتخاب کند.
.PP
اگر \f[V]--addr\f[R] را برای گوش دادن روی یک آدرس IP عمومی یا در دسترس در LAN تنظیم کنید، استفاده از احراز هویت توصیه می‌شود \- برای اطلاعات بیشتر بخش بعدی را ببینید.
.PP
می‌توانید با تنظیم url روی \f[V]unix:///path/to/socket\f[R] یا صرفاً با استفاده از یک مسیر مطلق، از یک unix socket استفاده کنید.
.PP
گزینه \f[V]--addr\f[R] می‌تواند برای گوش دادن روی چند IP/پورت/سوکت تکرار شود.
فعال‌سازی از طریق سوکت (Socket activation) که در ادامه شرح داده شده است نیز می‌تواند برای دستیابی به همین هدف استفاده شود.
.PP
از \f[V]--server-read-timeout\f[R] و \f[V]--server-write-timeout\f[R] می‌توان برای کنترل زمان‌های انقضا (timeouts) در سرور استفاده کرد.
توجه داشته باشید که این، کل زمان برای یک انتقال است.
.PP
گزینه \f[V]--max-header-bytes\f[R] حداکثر تعداد بایت‌هایی را که سرور در هدر HTTP می‌پذیرد، کنترل می‌کند.
.PP
از \f[V]--response-header\f[R] می‌توان برای تنظیم یک هدر HTTP برای تمام پاسخ‌ها استفاده کرد که مقادیر موجود را بازنویسی خواهد کرد.
این پرچم می‌تواند برای افزودن چندین هدر تکرار شود.
از قالب \f[V]Header-Name: value\f[R] استفاده کنید.
.PP
گزینه \f[V]--baseurl\f[R] پیشوند URLای که rclone از آن سرویس می‌دهد را کنترل می‌کند.
به‌طور پیش‌فرض rclone از ریشه سرویس می‌دهد.
اگر از \f[V]--baseurl \[dq]/rclone\[dq]\f[R] استفاده کنید، rclone از یک URL که با \[dq]/rclone/\[dq] شروع می‌شود سرویس خواهد داد.
این در حالتی که مایل باشید rclone serve را پراکسی کنید مفید است.
دستور rclone به‌طور خودکار کاراکترهای \[dq]/\[dq] را در ابتدا و انتهای \f[V]--baseurl\f[R] درج می‌کند، بنابراین \f[V]--baseurl \[dq]rclone\[dq]\f[R]، \f[V]--baseurl \[dq]/rclone\[dq]\f[R] و \f[V]--baseurl \[dq]/rclone/\[dq]\f[R] همگی به شکل یکسان در نظر گرفته می‌شوند.
.PP
گزینه \f[V]--disable-zip\f[R] می‌تواند برای غیرفعال کردن قابلیت بارگیری به‌صورت فشرده (zipping) تنظیم شود..SS پروتکل (Protocol)
.PP
سرور از HTTP/1.1 و HTTP/2 پشتیبانی می‌کند.
برای اتصالات TLS، به‌طور خودکار از HTTP/2 استفاده می‌شود.
برای اتصالات غیر TLS، متن خام HTTP/2 (h2c) پشتیبانی می‌شود که استفاده از HTTP/2 بدون رمزنگاری را ممکن می‌سازد.
.SS TLS (SSL)
.PP
به‌طور پیش‌فرض، این سرویس روی http ارائه می‌شود.
در صورت تمایل می‌توانید آن را روی https ارائه دهید.
باید پرچم‌های \f[V]--cert\f[R] و \f[V]--key\f[R] را مشخص کنید.
اگر مایل به اعتبارسنجی گواهی سمت کلاینت هستید، باید \f[V]--client-ca\f[R] را نیز مشخص کنید.
.PP
هنگامی که TLS پیکربندی می‌شود، هر شنونده‌ای که با \f[V]--addr\f[R] مشخص شده باشد، تحت TLS سرویس می‌دهد.
یک شنونده به صورت جداگانه می‌تواند پیشوند \f[V]http://\f[R] داشته باشد تا HTTP رمزگذاری‌نشده را روی آن نشانی ارائه دهد، یا پیشوند \f[V]tls://\f[R] تا به‌صراحت مشخص شود که باید با TLS ارائه شود.
استفاده از یک نشانی \f[V]tls://\f[R] بدون \f[V]--cert\f[R] و \f[V]--key\f[R] یک خطا است.
.PP
مقدار \f[V]--cert\f[R] باید روی مسیر فایلی تنظیم شود که حاوی یک گواهی با کدگذاری PEM، یا ادغام آن با گواهی مرجع صدور گواهی (CA) باشد.
مقدار \f[V]--key\f[R] باید روی مسیر فایلی حاوی کلید خصوصی با کدگذاری PEM تنظیم شود.
در صورت تنظیم \f[V]--client-ca\f[R]، باید آن را روی مسیر فایلی حاوی گواهی‌های مرجع صدور گواهی (CA) کلاینت با کدگذاری PEM تنظیم کرد.
.PP
گزینهٔ \f[V]--min-tls-version\f[R] حداقل نسخهٔ قابل قبول TLS است.
مقادیر معتبر عبارتند از \[dq]tls1.0\[dq]، \[dq]tls1.1\[dq]، \[dq]tls1.2\[dq] و \[dq]tls1.3\[dq] (پیش‌فرض \[dq]tls1.0\[dq]).
.SS فعال‌سازی سوکت (Socket activation)
.PP
به جای نشانی‌های شنود مشخص‌شده در بالا، rclone به تمام توصیف‌کننده‌های فایل (FD) ارسال‌شده توسط مدیر سرویس، در صورت وجود، گوش فرا خواهد داد (و هرگونه آرگومان ارائه‌شده با \f[V]--addr\f[R] را نادیده می‌گیرد).
.PP
این ویژگی به rclone اجازه می‌دهد تا به عنوان یک سرویس فعال‌شونده با سوکت (socket-activated) عمل کند.
می‌توان آن را با فایل‌های واحد .socket و .service همان‌طور که در
<https://www.freedesktop.org/software/systemd/man/latest/systemd.socket.html>
شرح داده شده است، پیکربندی کرد.
.PP
فعال‌سازی سوکت را می‌توان به‌طور موردی (ad-hoc) با دستور \f[V]systemd-socket-activate\f[R] آزمایش کرد:
.IP
.nf
\f[C]
systemd-socket-activate -l 8000 -- rclone serve
\f[R]
.fi
.PP
این دستور با برقراری نخستین اتصال به پورت 8000 از طریق TCP، سرویس rclone را با سوکت فعال خواهد کرد.
.SS الگو (Template)
.PP
گزینهٔ \f[V]--template\f[R] به کاربر امکان می‌دهد یک الگوی نشانه‌گذاری سفارشی را برای عملکردهای ارائهٔ HTTP و WebDAV تعیین کند.
سرور نشانه‌گذاری‌های زیر را صادر می‌کند تا درون الگو برای ارائهٔ صفحات مورد استفاده قرار گیرند:
.PP
.TS
tab(@);
lw(22.6n) lw(24.7n) lw(22.6n).
T{
پارامتر
T}@T{
زیرپارامتر
T}@T{
توضیحات
T}
_
T{
\&.Name
T}@T{
T}@T{
مسیر کامل یک فایل/دایرکتوری.
T}
T{
\&.Title
T}@T{
T}@T{
فهرست دایرکتوری مربوط به \[aq].Name\[aq].
T}
T{
\&.Sort
T}@T{
T}@T{
مرتب‌سازی فعلیِ مورد استفاده.
این مقدار از طریق پارامتر \[aq]?sort=\[aq] قابل تغییر است.
مقادیر ممکن: namedirfirst، name، size، time (پیش‌فرض namedirfirst).
T}
T{
\&.Order
T}@T{
T}@T{
ترتیب فعلیِ مورد استفاده.
این مقدار از طریق پارامتر \[aq]?order=\[aq] قابل تغییر است.
مقادیر ممکن: asc، desc (پیش‌فرض asc).
T}
T{
\&.Query
T}@T{
T}@T{
در حال حاضر استفاده نمی‌شود.
T}
T{
\&.Breadcrumb
T}@T{
T}@T{
امکان ایجاد ناوبری نسبی را فراهم می‌کند.
T}
T{
T}@T{
\&.Link
T}@T{
پیوندِ Text نسبت به ریشه.
T}
T{
T}@T{
\&.Text
T}@T{
نام (Name) دایرکتوری.
T}
T{
\&.Entries
T}@T{
T}@T{
اطلاعات مربوط به یک فایل/دایرکتوری خاص.
T}
T{
T}@T{
\&.URL
T}@T{
نشانی URL یک مدخل.
T}
T{
T}@T{
\&.Leaf
T}@T{
در حال حاضر همانند \[aq].URL\[aq] است، اما در نظر گرفته شده که فقط نام باشد.
T}
T{
T}@T{
\&.IsDir
T}@T{
مقدار بولی برای مشخص کردن اینکه آیا یک مدخل دایرکتوری است یا خیر.
T}
T{
T}@T{
\&.Size
T}@T{
اندازهٔ مدخل بر حسب بایت.
T}
T{
T}@T{
\&.ModTime
T}@T{
مهرزمانی UTC یک مدخل.
T}
.TE
.PP
سرور همچنین توابع زیر را در دسترس قرار می‌دهد تا بتوان از آن‌ها در الگو استفاده کرد.
این توابع به گسترش گزینه‌ها برای رندر پویای HTML کمک می‌کنند.
می‌توان از آن‌ها برای رندر کردن HTML بر اساس شرایط خاص استفاده کرد.
.PP
.TS
tab(@);
lw(35.0n) lw(35.0n).
T{
تابع
T}@T{
توضیحات
T}
_
T{
afterEpoch
T}@T{
زمان سپری‌شده از مبدأ زمانی (epoch) را برای زمان ارائه‌شده برمی‌گرداند.
T}
T{
contains
T}@T{
بررسی می‌کند که آیا زیررشتهٔ مشخص‌شده در رشتهٔ ارائه‌شده وجود دارد یا خیر.
T}
T{
hasPrefix
T}@T{
بررسی می‌کند که آیا رشتهٔ ارائه‌شده با پیشوند مشخص‌شده آغاز می‌شود یا خیر.
T}
T{
hasSuffix
T}@T{
بررسی می‌کند که آیا رشتهٔ ارائه‌شده با پسوند مشخص‌شده پایان می‌یابد یا خیر.
T}
.TE.SS احراز هویت (Authentication)
.PP
به طور پیش‌فرض، این دستور فایل‌ها را بدون نیاز به ورود ارائه می‌دهد.
.PP
می‌توانید از یک فایل htpasswd استفاده کنید که قابلیت تعریف کاربران زیادی را دارد، یا با پرچم‌های \f[V]--user\f[R] و
\f[V]--pass\f[R] یک نام‌کاربری و گذرواژه منفرد تعیین نمایید.
.PP
همچنین، می‌توانید مدیریت احراز هویت را به پراکسی معکوس (reverse proxy) بسپارید و از نام‌کاربری ارائه‌شده در هدر پیکربندی‌شده با
\f[V]--user-from-header\f[R] استفاده کنید (مانند
\f[V]--user-from-header=x-remote-user\f[R]).
اطمینان حاصل کنید که پراکسی مورد اعتماد است و هدرها جعل نمی‌شوند، زیرا
پیکربندی نادرست می‌تواند به دسترسی غیرمجاز منجر شود.
.PP
اگر هیچ‌کدام از روش‌های احراز هویت بالا پیکربندی نشده باشند و گواهی‌های کلاینت از طریق پرچم \f[V]--client-ca\f[R]
ارسال‌شده به سرور الزامی شده باشند، نام عمومی (common name) گواهی کلاینت به عنوان نام‌کاربری در نظر گرفته خواهد شد.
.PP
برای مشخص کردن فایل htpasswd از \f[V]--htpasswd /path/to/htpasswd\f[R] استفاده کنید.
این فایل با قالب استاندارد apache سازگار است و از MD5، SHA1 و BCrypt برای
احراز هویت پایه پشتیبانی می‌کند.
استفاده از Bcrypt توصیه می‌شود.
.PP
برای ساخت یک فایل htpasswd:
.IP
.nf
\f[C]
touch htpasswd
htpasswd -B htpasswd user
htpasswd -B htpasswd anotherUser
\f[R]
.fi
.PP
فایل گذرواژه را می‌توان در حین اجرای rclone به‌روزرسانی کرد.
.PP
برای تنظیم قلمرو احراز هویت (realm) از \f[V]--realm\f[R] استفاده کنید.
.PP
برای تغییر salt در درهم‌سازی گذرواژه از حالت پیش‌فرض، از \f[V]--salt\f[R] استفاده کنید.
.SS سیستم فایل مجازی (VFS - Virtual File System)
.PP
این دستور از لایهٔ VFS استفاده می‌کند.
این لایه اشیاء فضای ابری مورداستفادهٔ rclone را به چیزی بسیار شبیه به یک سیستم فایل دیسکی تطبیق می‌دهد.
.PP
اشیاء ذخیره‌سازی ابری ویژگی‌های متعددی دارند که مشابه فایل‌های روی دیسک نیستند \- شما نمی‌توانید اندازهٔ آن‌ها را افزایش دهید یا در میانهٔ آن‌ها بنویسید، بنابراین لایهٔ VFS باید این موضوع را مدیریت کند.
از آنجا که روش واحد و قطعی برای انجام این کار وجود ندارد، گزینه‌های مختلفی وجود دارند که در ادامه توضیح داده شده‌اند.
.PP
لایهٔ VFS همچنین یک حافظهٔ نهان (cache) دایرکتوری را پیاده‌سازی می‌کند \- این لایه اطلاعات مربوط به فایل‌ها و دایرکتوری‌ها (نه داده‌های اصلی) را در حافظهٔ موقت نگهداری می‌کند.
.SS حافظهٔ نهان دایرکتوری VFS (VFS Directory Cache)
.PP
با استفاده از پرچم \f[V]--dir-cache-time\f[R]، می‌توانید کنترل کنید که یک دایرکتوری تا چه مدت معتبر و به‌روز در نظر گرفته شود و اطلاعات آن مجدداً از بک‌اند دریافت نشود.
تغییرات اعمال‌شده از طریق VFS بلافاصله نمایان می‌شوند یا حافظهٔ نهان را بی‌اعتبار می‌کنند.
.IP
.nf
\f[C]
    --dir-cache-time duration   Time to cache directory entries for (default 5m0s)
    --poll-interval duration    Time to wait between polling for changes. Must be smaller than dir-cache-time. Only on supported remotes. Set to 0 to disable (default 1m0s)
\f[R]
.fi
.PP
با این حال، اگر بک‌اند پیکربندی‌شده از پایش دوره‌ای (polling) برای تغییرات پشتیبانی نکند، تغییراتی که مستقیماً از طریق رابط کاربری وب یا نسخه‌ای دیگر از rclone روی ذخیره‌ساز ابری ایجاد می‌شوند، تنها پس از انقضای حافظهٔ نهان دایرکتوری دریافت خواهند شد.
اگر بک‌اند از پایش دوره‌ای پشتیبانی کند، تغییرات در بازهٔ زمانی تعیین‌شده برای پایش شناسایی خواهند شد.
.PP
می‌توانید یک سیگنال \f[V]SIGHUP\f[R] به rclone ارسال کنید تا صرف‌نظر از مدت‌زمان ذخیره‌سازی، تمامی حافظه‌های نهان دایرکتوری را پاک‌سازی (flush) کند.
با فرض اینکه فقط یک نمونه از rclone در حال اجرا است، می‌توانید حافظهٔ نهان را به صورت زیر بازنشانی کنید:
.IP
.nf
\f[C]
kill -SIGHUP $(pidof rclone)
\f[R]
.fi
.PP
اگر rclone را با کنترل از راه دور پیکربندی کنید، می‌توانید از rclone rc برای پاک‌سازی کل حافظهٔ نهان دایرکتوری استفاده نمایید:
.IP
.nf
\f[C]
rclone rc vfs/forget
\f[R]
.fi
.PP
یا برای فایل‌ها و دایرکتوری‌های منفرد:
.IP
.nf
\f[C]
rclone rc vfs/forget file=path/to/file dir=path/to/dir
\f[R]
.fi.SS بافرسازی فایل در VFS
.PP
پرچم \f[V]--buffer-size\f[R] مقدار حافظه‌ای را تعیین می‌کند که برای بافر کردن پیشاپیش داده‌ها استفاده خواهد شد.
.PP
هر فایل باز تلاش می‌کند مقدار مشخص‌شده از داده را در تمام زمان‌ها در حافظه نگه‌دارد.
داده‌های بافرشده به یک فایل باز مقید هستند و به اشتراک گذاشته نخواهند شد.
.PP
این پرچم یک حد بالا برای حافظه مصرفی به ازای هر فایل باز است.
بافر تنها برای داده‌هایی که بارگیری شده‌اند اما هنوز خوانده نشده‌اند از حافظه استفاده خواهد کرد.
اگر بافر خالی باشد، تنها مقدار اندکی از حافظه مصرف خواهد شد.
.PP
حداکثر حافظه مصرفی rclone برای بافرسازی می‌تواند تا
\f[V]--buffer-size * open files\f[R] باشد.
.SS کش کردن فایل در VFS
.PP
این پرچم‌ها گزینه‌های کش کردن فایل در VFS را کنترل می‌کنند.
کش کردن فایل برای سازگار نشان دادن لایه VFS با یک سیستم فایل عادی ضروری است.
این سازوکار می‌تواند به قیمت از دست دادن مقداری از سازگاری غیرفعال شود.
.PP
برای نمونه اگر می‌خواهید هم‌زمان روی یک فایل بخوانید و بنویسید، باید کش VFS را فعال کنید.
برای جزئیات بیشتر به بخش‌های زیر مراجعه کنید.
.PP
توجه داشته باشید که کش VFS از backend کش مجزاست و ممکن است دریابید که به یکی از آن‌ها یا هر دو نیاز دارید.
.IP
.nf
\f[C]
    --cache-dir string                     Directory rclone will use for caching.
    --vfs-cache-mode CacheMode             Cache mode off|minimal|writes|full (default off)
    --vfs-cache-max-age duration           Max time since last access of objects in the cache (default 1h0m0s)
    --vfs-cache-max-size SizeSuffix        Max total size of objects in the cache (default off)
    --vfs-cache-min-free-space SizeSuffix  Target minimum free space on the disk containing the cache (default off)
    --vfs-cache-poll-interval duration     Interval to poll the cache for stale objects (default 1m0s)
    --vfs-write-back duration              Time to writeback files after last use when using cache (default 5s)
\f[R]
.fi
.PP
در صورت اجرا با \f[V]-vv\f[R]، دستور rclone مکان کش فایل را چاپ خواهد کرد.
فایل‌ها در ناحیه فایل‌های کش کاربر ذخیره می‌شوند که وابسته به سیستم‌عامل است، اما می‌توان آن را با \f[V]--cache-dir\f[R] یا با تنظیم متغیر محیطی مربوطه کنترل کرد.
.PP
حافظه کش دارای ۴ حالت مختلف است که توسط \f[V]--vfs-cache-mode\f[R] انتخاب می‌شوند.
هرچه حالت کش بالاتر باشد، سازگاری rclone به قیمت مصرف فضای دیسک بیشتر خواهد شد.
.PP
توجه داشته باشید که فایل‌ها تنها زمانی به ریموت بازنویسی می‌شوند که بسته شده باشند و به مدت \f[V]--vfs-write-back\f[R] ثانیه دسترسی به آن‌ها صورت نگرفته باشد.
اگر rclone بسته شود یا در حالی که فایل‌هایی هنوز بارگذاری نشده‌اند متوقف گردد، این فایل‌ها دفعه بعدی که rclone با همان پرچم‌ها اجرا شود، بارگذاری خواهند شد.
.PP
در صورت استفاده از \f[V]--vfs-cache-max-size\f[R] یا
\f[V]--vfs-cache-min-free-space\f[R] توجه داشته باشید که کش به دو دلیل ممکن است از این سهمیه‌ها فراتر رود.
نخست به این دلیل که وضعیت آن تنها در هر بازه زمانی \f[V]--vfs-cache-poll-interval\f[R] بررسی می‌شود.
دوم به این دلیل که فایل‌های باز را نمی‌توان از کش بیرون راند.
هنگامی که محدودیت \f[V]--vfs-cache-max-size\f[R] یا
\f[V]--vfs-cache-min-free-space\f[R] رد شود، rclone ابتدا تلاش می‌کند فایل‌هایی را که کمترین دسترسی را داشته‌اند از کش خارج کند.
rclone از فایل‌هایی آغاز خواهد کرد که برای طولانی‌ترین زمان بدون دسترسی بوده‌اند.
این راهبرد پاک‌سازی کش کارآمد است و احتمال این‌که فایل‌های مرتبط‌تر در کش باقی بمانند بیشتر خواهد بود.
.PP
پرچم \f[V]--vfs-cache-max-age\f[R] فایل‌ها را پس از گذشت زمان تعیین‌شده از آخرین دسترسی، از کش خارج می‌کند؛ مبنای این کار زمان دسترسی است، نه زمانی که فایل برای نخستین بار به کش اضافه شده است.
مقدار پیش‌فرض ۱ ساعت، شروع به حذف فایل‌هایی از کش می‌کند که به مدت ۱ ساعت دسترسی به آن‌ها صورت نگرفته باشد.
هنگامی که به یک فایل کش‌شده دسترسی پیدا شود، زمان‌سنج ۱ ساعته بازنشانی شده و پیش از حذف، ۱ ساعت دیگر منتظر خواهد ماند.
زمان را با نمادگذاری استاندارد (s، m، h، d، w) مشخص کنید.
.PP
شما \f[B]نباید\f[R] دو نسخه از rclone را با استفاده از کش VFS یکسان روی ریموت‌های یکسان یا دارای هم‌پوشانی در حالت \f[V]--vfs-cache-mode > off\f[R] اجرا کنید.
انجام این کار بالقوه می‌تواند منجر به خرابی داده‌ها شود.
می‌توانید با اختصاص سلسله‌مراتب کش مجزا به هر rclone از طریق \f[V]--cache-dir\f[R] این مشکل را دور بزنید.
اگر ریموت‌های مورد استفاده هم‌پوشانی ندارند، نیازی به نگرانی در این مورد نیست..SS --vfs-cache-mode off
.PP
در این حالت (حالت پیش‌فرض)، کَش مستقیماً از مقصد راه دور می‌خواند و مستقیماً روی آن می‌نویسد، بدون اینکه چیزی را روی دیسک ذخیره (کَش) کند.
.PP
این بدان معناست که برخی عملیات‌ها امکان‌پذیر نخواهند بود:
.IP \[bu] 2
فایل‌ها نمی‌توانند هم‌زمان برای خواندن و نوشتن باز شوند
.IP \[bu] 2
امکان پیمایش (seek) در فایل‌های باز شده برای نوشتن وجود ندارد
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید پرچم O_TRUNC را تنظیم کرده باشند
.IP \[bu] 2
فایل‌های باز شده برای خواندن با O_TRUNC به‌صورت فقط‌نوشتنی باز خواهند شد
.IP \[bu] 2
فایل‌های باز شده به‌صورت فقط‌نوشتنی به‌گونه‌ای رفتار خواهند کرد که گویی O_TRUNC مشخص شده است
.IP \[bu] 2
حالت‌های باز کردن O_APPEND و O_TRUNC نادیده گرفته می‌شوند
.IP \[bu] 2
اگر یک بارگذاری با شکست مواجه شود، تلاش مجدد امکان‌پذیر نخواهد بود
.SS --vfs-cache-mode minimal
.PP
این حالت بسیار شبیه به \[dq]off\[dq] است، با این تفاوت که فایل‌های باز شده برای خواندن و نوشتن روی دیسک بافر می‌شوند.
این موضوع باعث می‌شود فایل‌های باز شده برای نوشتن سازگاری بسیار بیشتری داشته باشند، اما کمترین فضای ممکن از دیسک مصرف شود.
.PP
این عملیات‌ها امکان‌پذیر نیستند:
.IP \[bu] 2
امکان پیمایش (seek) در فایل‌های باز شده به‌صورت فقط‌نوشتنی وجود ندارد
.IP \[bu] 2
فایل‌های موجود که برای نوشتن باز می‌شوند باید O_TRUNC را تنظیم کرده باشند
.IP \[bu] 2
فایل‌های باز شده به‌صورت فقط‌نوشتنی، گزینه‌های O_APPEND و O_TRUNC را نادیده می‌گیرند
.IP \[bu] 2
اگر یک بارگذاری شکست بخورد، تلاش مجدد امکان‌پذیر نخواهد بود
.SS --vfs-cache-mode writes
.PP
در این حالت، فایل‌های باز شده به‌صورت فقط‌خواندنی همچنان مستقیماً از مقصد راه دور خوانده می‌شوند، اما فایل‌های فقط‌نوشتنی و خواندنی/نوشتنی ابتدا روی دیسک بافر می‌شوند.
.PP
این حالت باید از تمامی عملیات‌های عادی سیستم‌فایل پشتیبانی کند.
.PP
اگر بارگذاری با شکست مواجه شود، تلاش مجدد در فواصل زمانی با افزایش تصاعدی تا حداکثر ۱ دقیقه انجام خواهد شد.
.SS --vfs-cache-mode full
.PP
در این حالت تمام خواندن‌ها و نوشتن‌ها از و به دیسک بافر می‌شوند.
هنگامی که داده‌ها از مقصد راه دور خوانده می‌شوند، بر روی دیسک نیز بافر خواهند شد.
.PP
در این حالت، فایل‌های موجود در کَش به‌صورت فایل‌های تنک (sparse files) خواهند بود و rclone رهگیری خواهد کرد که کدام بخش‌ها از فایل‌ها را دانلود کرده است.
.PP
بنابراین اگر برنامه‌ای تنها ابتدای هر فایل را بخواند، rclone فقط ابتدای فایل را بافر می‌کند.
این فایل‌ها در کَش با اندازه کامل خود نمایش داده می‌شوند، اما فایل‌های تنکی هستند که تنها داده‌های دانلود شده در آن‌ها وجود دارد.
.PP
این حالت باید از تمام عملیات‌های عادی سیستم‌فایل پشتیبانی کند و در سایر موارد کاملاً مشابه \f[V]--vfs-cache-mode\f[R] writes است.
.PP
هنگام خواندن یک فایل، rclone به اندازه \f[V]--buffer-size\f[R] به‌علاوه \f[V]--vfs-read-ahead\f[R] بایت جلوتر را پیش‌خوانی می‌کند.
مقدار \f[V]--buffer-size\f[R] در حافظه بافر می‌شود در حالی که \f[V]--vfs-read-ahead\f[R] روی دیسک بافر می‌گردد.
.PP
هنگام استفاده از این حالت، توصیه می‌شود که \f[V]--buffer-size\f[R] بیش از حد بزرگ تنظیم نشود و در صورت نیاز \f[V]--vfs-read-ahead\f[R] مقادیر بزرگ‌تری داشته باشد.
.PP
\f[B]مهم:\f[R] همه سیستم‌فایل‌ها از فایل‌های تنک پشتیبانی نمی‌کنند.
به‌ویژه FAT/exFAT پشتیبانی نمی‌کنند.
اگر دایرکتوری کَش روی سیستم‌فایلی باشد که از فایل‌های تنک پشتیبانی نمی‌کند، rclone عملکرد بسیار ضعیفی خواهد داشت و در صورت شناسایی چنین مواردی یک پیام ERROR ثبت خواهد کرد.
.SS انگشت‌نگاری (Fingerprinting)
.PP
بخش‌های مختلف VFS از انگشت‌نگاری استفاده می‌کنند تا ببینند آیا نسخه محلی فایل نسبت به فایل راه دور تغییر کرده است یا خیر.
اثرانگشت‌ها از موارد زیر ساخته می‌شوند:
.IP \[bu] 2
اندازه (size)
.IP \[bu] 2
زمان آخرین تغییر (modification time)
.IP \[bu] 2
درهم‌سازی (hash)
.PP
در صورتی که روی یک شیء موجود باشند.
.PP
در برخی بک‌اندها، خواندن بعضی از این مشخصه‌ها کُند است (به یک فراخوانی API اضافی برای هر شیء یا پردازش اضافی نیاز دارند).
.PP
به‌عنوان مثال، \f[V]hash\f[R] در بک‌اندهای \f[V]local\f[R] و \f[V]sftp\f[R] کُند است زیرا باید کل فایل را خوانده و هش آن را محاسبه کنند؛ همچنین \f[V]modtime\f[R] در بک‌اندهای \f[V]s3\f[R]، \f[V]swift\f[R]، \f[V]ftp\f[R] و \f[V]qinqstor\f[R] کُند است زیرا برای دریافت آن نیاز به انجام یک فراخوانی API اضافی دارند.
.PP
اگر از گزینه \f[V]--vfs-fast-fingerprint\f[R] استفاده کنید، rclone عملیات‌های کُند را در اثرانگشت لحاظ نخواهد کرد.
این کار دقت انگشت‌نگاری را کاهش می‌دهد اما سرعت آن را بسیار بالا می‌برد و زمان باز شدن فایل‌های کَش‌شده را بهبود می‌بخشد.
.PP
اگر در حال اجرای یک کَش vfs روی بک‌اندهای \f[V]local\f[R]، \f[V]s3\f[R] یا \f[V]swift\f[R] هستید، استفاده از این گزینه توصیه می‌شود.
.PP
توجه داشته باشید که اگر مقدار این گزینه را تغییر دهید، ممکن است اثرانگشت فایل‌های موجود در کَش نامعتبر شده و نیاز به بارگیری مجدد فایل‌ها باشد..SS خواندن تکه‌ای در VFS (VFS Chunked Reading)
.PP
هنگامی که rclone فایل‌ها را از یک ریموت می‌خواند، آن‌ها را به صورت تکه‌تکه می‌خواند.
این بدان معناست که rclone به جای درخواست کل فایل، تنها تکه مشخص‌شده را می‌خواند.
این کار می‌تواند با درخواست دادن تنها همان تکه‌هایی از ریموت که واقعاً خوانده می‌شوند، سهمیه دانلود مصرفی را در برخی ریموت‌ها کاهش دهد، به قیمت افزایش تعداد درخواست‌ها.
.PP
این پرچم‌ها عمل تکه‌بندی را کنترل می‌کنند:
.IP
.nf
\f[C]
    --vfs-read-chunk-size SizeSuffix        خواندن اشیای مبدأ به صورت تکه‌ای (پیش‌فرض 128M)
    --vfs-read-chunk-size-limit SizeSuffix  حداکثر اندازه دو برابر شدن تکه (پیش‌فرض off)
    --vfs-read-chunk-streams int            تعداد جریان‌های موازی برای خواندن هم‌زمان
\f[R]
.fi
.PP
رفتار تکه‌بندی بسته به پارامتر
\f[V]--vfs-read-chunk-streams\f[R] متفاوت خواهد بود.
.SS \f[V]--vfs-read-chunk-streams\f[R] == 0
.PP
برنامه rclone خواندن را با تکه‌ای به اندازه
\f[V]--vfs-read-chunk-size\f[R] آغاز می‌کند و سپس با هر بار خواندن، این اندازه را دو برابر می‌کند.
هنگامی که \f[V]--vfs-read-chunk-size-limit\f[R] مشخص شده و بزرگ‌تر
از \f[V]--vfs-read-chunk-size\f[R] باشد، اندازه تکه برای هر فایل باز فقط تا زمانی
دو برابر می‌شود که به مقدار مشخص‌شده برسد.
اگر مقدار \[dq]off\[dq] باشد که حالت پیش‌فرض است، محدودیت غیرفعال بوده
و اندازه تکه بدون محدودیت رشد خواهد کرد.
.PP
با تنظیم \f[V]--vfs-read-chunk-size 100M\f[R] و
\f[V]--vfs-read-chunk-size-limit 0\f[R] بخش‌های زیر
دانلود خواهند شد: 0-100M، 100M-200M، 200M-300M، 300M-400M و الی آخر.
هنگامی که \f[V]--vfs-read-chunk-size-limit 500M\f[R] مشخص شود، نتیجه
به صورت 0-100M، 100M-300M، 300M-700M، 700M-1200M، 1200M-1700M و الی آخر
خواهد بود.
.PP
تنظیم \f[V]--vfs-read-chunk-size\f[R] روی \f[V]0\f[R] یا \[dq]off\[dq]
خواندن تکه‌تکه‌ای را غیرفعال می‌کند.
.PP
تکه‌ها در حافظه بافر نخواهند شد.
.SS \f[V]--vfs-read-chunk-streams\f[R] > 0
.PP
برنامه rclone تعداد \f[V]--vfs-read-chunk-streams\f[R] تکه به اندازه
\f[V]--vfs-read-chunk-size\f[R] را به طور هم‌روند می‌خواند.
اندازه برای هر خواندن ثابت باقی خواهد ماند.
.PP
این کار عملکرد را روی پیوندهای با تأخیر زیاد یا
پیوندهای با پهنای باند بسیار بالا به مخازن شیء با کارایی بالا به شدت بهبود می‌بخشد.
.PP
برای یافتن مقادیر بهینه
\f[V]--vfs-read-chunk-size\f[R] و \f[V]--vfs-read-chunk-streams\f[R]
به مقداری آزمون و خطا نیاز خواهد بود، زیرا این مقادیر به بَک‌اند مورد استفاده
و میزان تأخیر تا آن بَک‌اند بستگی دارند.
.PP
برای مخازن شیء با کارایی بالا (مانند AWS S3)، یک نقطه شروع مناسب
می‌تواند \f[V]--vfs-read-chunk-streams 16\f[R] و
\f[V]--vfs-read-chunk-size 4M\f[R] باشد.
در آزمایش‌های انجام‌شده با AWS S3، کارایی تقریباً متناسب با مقدار
تنظیم‌شده برای \f[V]--vfs-read-chunk-streams\f[R] مقیاس‌پذیر بود.
.PP
تنظیمات مشابه باید برای پیوندهای با تأخیر بالا نیز کار کند، اما بسته به
میزان تأخیر ممکن است برای دستیابی به خروجی مناسب، به تعداد بیشتری از
\f[V]--vfs-read-chunk-streams\f[R] نیاز باشد.
.SS کارایی VFS (VFS Performance)
.PP
این پرچم‌ها ممکن است برای فعال/غیرفعال کردن قابلیت‌های VFS جهت بهبود
کارایی یا دلایل دیگر استفاده شوند.
همچنین بخش قابلیت خواندن تکه‌ای را ببینید.
.PP
به‌ویژه S3 و Swift از پرچم
\f[V]--no-modtime\f[R] سود فراوانی می‌برند (یا برای اثری کمی
متفاوت از \f[V]--use-server-modtime\f[R] استفاده کنید)، زیرا هر بار خواندن
زمان تغییر نیازمند یک تراکنش است.
.IP
.nf
\f[C]
    --no-checksum     عدم مقایسه چکسام‌ها هنگام بارگذاری/دانلود.
    --no-modtime      عدم خواندن/نوشتن زمان تغییر (می‌تواند سرعت را افزایش دهد).
    --no-seek         عدم اجازه پرش در فایل‌ها.
    --read-only       فقط اجازه دسترسی فقط‌خواندنی.
\f[R]
.fi
.PP
گاهی اوقات درخواست‌های خواندن یا نوشتن نامرتب به rclone تحویل داده می‌شوند.
برنامه rclone به جای پرش (seek)، زمان کوتاهی را برای رسیدن خواندن
یا نوشتن متوالی بعدی منتظر می‌ماند.
این پرچم‌ها تنها در صورتی اثرگذار هستند که از یک فایل کش روی دیسک استفاده نشود.
.IP
.nf
\f[C]
    --vfs-read-wait duration   مدت انتظار برای خواندن متوالی قبل از پرش (پیش‌فرض 20ms)
    --vfs-write-wait duration  مدت انتظار برای نوشتن متوالی قبل از صدور خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
هنگام استفاده از کش نوشتن VFS (\f[V]--vfs-cache-mode\f[R] با مقدار
writes یا full)، پرچم سراسری \f[V]--transfers\f[R] را می‌توان برای
تنظیم تعداد بارگذاری‌های موازی فایل‌های تغییر‌یافته از حافظه کش تنظیم کرد
(پرچم سراسری مرتبط \f[V]--checkers\f[R] هیچ تأثیری بر VFS ندارد).
.IP
.nf
\f[C]
    --transfers int  تعداد انتقال‌های موازی فایل برای اجرا (پیش‌فرض 4)
\f[R]
.fi.SS "پیوندهای نمادین (Symlinks)"
.PP
به‌طور پیش‌فرض VFS از پیوندهای نمادین (symlinks) پشتیبانی نمی‌کند.
با این حال، این ویژگی می‌تواند با هر یک از پرچم‌های زیر فعال شود:
.IP
.nf
\f[C]
    --links      تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq].
    --vfs-links  تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
\f[R]
.fi
.PP
از آنجا که بیشتر سامانه‌های ذخیره‌سازی ابری مستقیماً از پیوندهای نمادین پشتیبانی نمی‌کنند، rclone پیوند نمادین را به‌صورت یک فایل معمولی با یک پسوند ویژه ذخیره می‌کند.
بنابراین فایلی که به‌صورت یک پیوند نمادین \f[V]link-to-file.txt\f[R] دیده می‌شود، در فضای ذخیره‌سازی ابری به‌صورت \f[V]link-to-file.txt.rclonelink\f[R] ذخیره خواهد شد و محتوای آن، مسیر مقصد پیوند نمادین خواهد بود.
.PP
توجه داشته باشید که \f[V]--links\f[R] تبدیل پیوند نمادین را به‌طور سراسری در rclone فعال می‌کند \- این شامل هر بک‌اندی که از این مفهوم پشتیبانی کند (برای نمونه بک‌اند local) می‌شود.
\f[V]--vfs-links\f[R] آن را فقط برای لایهٔ VFS فعال می‌کند.
.PP
این سازوکار با روش مورد استفاده توسط بک‌اند local با پرچم \f[V]--local-links\f[R] سازگار است (<https://rclone.org/local/#symlinks-junction-points>).
.PP
پرچم \f[V]--vfs-links\f[R] برای دستورهای \f[V]rclone mount\f[R]، \f[V]rclone nfsmount\f[R] و \f[V]rclone serve nfs\f[R] طراحی شده است.
.PP
این گزینه هنوز با سایر دستورهای \f[V]rclone serve\f[R] آزمایش نشده است.
.PP
یکی از محدودیت‌های پیاده‌سازی فعلی این است که انتظار دارد فراخواننده، پیوندهای نمادین فرعی را تحلیل و تفکیک (resolve) کند.
برای مثال با فرض این درخت دایرکتوری:
.IP
.nf
\f[C]
\&.
├── dir
│\ \  └── file.txt
└── linked-dir -> dir
\f[R]
.fi
.PP
لایهٔ VFS پیوند \f[V]linked-dir\f[R] را به‌درستی برطرف می‌کند، اما \f[V]linked-dir/file.txt\f[R] را نه.
این مسئله برای دستورهای آزمایش‌شده مشکلی ایجاد نمی‌کند، اما ممکن است برای سایر دستورها مشکل‌ساز باشد.
.PP
\f[B]توجه\f[R] داشته باشید که یک مشکل حل‌نشده در پشتیبانی از پیوندهای نمادین وجود دارد (گزارش باگ شمارهٔ ۸۲۴۵ در <https://github.com/rclone/rclone/issues/8245>)؛ هنگامی که پیوندهای نمادین به دایرکتوری‌هایی منتقل می‌شوند که فایلی با همان نام در آن‌ها وجود دارد (یا برعکس)، فایل‌های تکراری ایجاد می‌شوند.
.SS "حساسیت VFS به حروف بزرگ و کوچک (VFS Case Sensitivity)"
.PP
سامانه‌های فایل Linux به بزرگی و کوچکی حروف حساس هستند (case-sensitive): دو فایل می‌توانند تنها در بزرگی و کوچکی حروف تفاوت داشته باشند، و هنگام باز کردن یک فایل باید دقیقاً از همان حالت حروف استفاده شود.
.PP
سامانه‌های فایل در Windows امروزی به بزرگی و کوچکی حروف حساس نیستند ولی حالت حروف را حفظ می‌کنند (case-insensitive اما case-preserving): اگرچه فایل‌های موجود را می‌توان با هر حالتی از حروف باز کرد، اما حالت دقیق حروفی که برای ساخت فایل به کار رفته حفظ می‌شود و برای استعلام برنامه‌ها در دسترس است.
در یک دایرکتوری، وجود دو فایل که تنها در بزرگی و کوچکی حروف با هم تفاوت دارند مجاز نیست.
.PP
سامانه‌های فایل در macOS معمولاً به بزرگی و کوچکی حروف حساس نیستند.
امکان حساس کردن سامانه‌های فایل macOS به بزرگی و کوچکی حروف وجود دارد، اما این حالت پیش‌فرض نیست.
.PP
پرچم \f[V]--vfs-case-insensitive\f[R] در لایهٔ VFS نحوهٔ رفتار rclone با این دو وضعیت را کنترل می‌کند.
اگر مقدار آن \[dq]false\[dq] باشد، rclone نام فایل‌ها را دست‌نخورده (as-is) به ریموت ارسال می‌کند.
اگر پرچم \[dq]true\[dq] باشد (یا بدون مقدار در خط فرمان آورده شود)، rclone ممکن است یک «اصلاح» (\[dq]fixup\[dq]) را مطابق توضیحات زیر انجام دهد.
.PP
کاربر ممکن است نام فایلی را برای باز کردن/حذف کردن/تغییر نام دادن/غیره با حالتی از حروف متفاوت از آنچه در ریموت ذخیره شده وارد کند.
اگر یک آرگومان به فایلی موجود با دقیقاً همان نام اشاره کند، از همان حالت حروف فایل موجود روی دیسک استفاده خواهد شد.
اما اگر نام فایلی با دقیقاً همان حالت حروف یافت نشود، ولی نامی وجود داشته باشد که تنها در بزرگی و کوچکی حروف تفاوت دارد، rclone به‌طور شفاف نام را اصلاح (fixup) می‌کند.
این اصلاح فقط هنگامی رخ می‌دهد که یک فایل موجود درخواست شده باشد.
حساسیت به حروف برای نام فایل‌هایی که به‌تازگی توسط rclone ایجاد می‌شوند توسط ریموت زیرین کنترل می‌شود.
.PP
توجه داشته باشید که حساسیت به بزرگی و کوچکی حروف در سیستم‌عامل اجراکنندهٔ rclone (مقصد) ممکن است با حساسیت به حروف در سامانهٔ فایل ارائه‌شده توسط rclone (مبدأ) متفاوت باشد.
این پرچم کنترل می‌کند که آیا برای برآورده کردن نیازهای مقصد، «اصلاح» (\[dq]fixup\[dq]) انجام گیرد یا خیر.
.PP
اگر این پرچم در خط فرمان مشخص نشود، مقدار پیش‌فرض آن به سیستم‌عاملی بستگی دارد که rclone در آن اجرا می‌شود: در Windows و macOS برابر \[dq]true\[dq]، و در غیر این صورت \[dq]false\[dq].
اگر پرچم بدون مقدار مشخص شود، برابر \[dq]true\[dq] خواهد بود.
.PP
پرچم \f[V]--no-unicode-normalization\f[R] کنترل می‌کند که آیا «اصلاح» (\[dq]fixup\[dq]) مشابهی برای نام‌فایل‌هایی که متفاوت‌اند اما از لحاظ یونیکد هم‌ارزی قانونی (canonically equivalent) دارند (<https://en.wikipedia.org/wiki/Unicode_equivalence>) انجام شود یا خیر.
نرمال‌سازی یونیکد به‌ویژه برای کاربران macOS که حالت NFD را به جای حالت NFC (مورد استفاده در اکثر پلتفرم‌های دیگر) ترجیح می‌دهد، بسیار سودمند است.
بنابراین اکیداً توصیه می‌شود که برای جلوگیری از مشکلات سازگاری کدگذاری در macOS، مقدار پیش‌فرض \f[V]false\f[R] حفظ شود.
.PP
در حالت (احتمالاً نادر) که یک دایرکتوری پس از اعمال یکسان‌سازی حروف و یونیکد، چندین نام‌فایل تکراری داشته باشد، پرچم \f[V]--vfs-block-norm-dupes\f[R] امکان پنهان کردن این موارد تکراری را فراهم می‌آورد.
این کار با افت کارایی همراه است، زیرا rclone هنگام فهرست کردن یک دایرکتوری مجبور است کل آن دایرکتوری را برای یافتن موارد تکراری پیمایش کند.
به همین دلیل، توصیه می‌شود در صورت عدم نیاز، این گزینه غیرفعال بماند.
با این وجود، کاربران macOS ممکن است استفاده از آن را در نظر بگیرند؛ زیرا در غیر این صورت، اگر یک دایرکتوری ریموت شامل هر دو نگارش NFC و NFD از یک نام‌فایل باشد، وضعیت عجیبی رخ خواهد داد: هر دو نسخه از فایل در محل مانت قابل مشاهده خواهند بود و هر دو قابل ویرایش به نظر می‌رسند، اما در عمل ویرایش هر کدام از آن‌ها تنها باعث ویرایش نسخهٔ NFD در پشت صحنه می‌شود.
پرچم \f[V]--vfs-block-norm-dupes\f[R] با شناسایی این وضعیت، پنهان کردن موارد تکراری و ثبت خطا در گزارش (log)، از این سردرگمی جلوگیری می‌کند؛ مشابه همان رفتاری که در \f[V]rclone sync\f[R] پیاده شده است..SS گزینه‌های دیسک VFS
.PP
این پرچم به شما امکان می‌دهد آمار مربوط به سامانه فایل را به صورت دستی
تنظیم کنید.
این قابلیت زمانی مفید است که این آمار نتوانند به صورت خودکار به درستی
خوانده شوند.
.IP
.nf
\f[C]
    --vfs-disk-space-total-size    تنظیم دستی اندازه کل فضای دیسک (مثال: 256G، پیش‌فرض: -1)
\f[R]
.fi
.SS گزارش جایگزین بایت‌های استفاده‌شده
.PP
برخی backendها، به ویژه S3، مقدار بایت‌های مصرف‌شده را گزارش نمی‌دهند.
اگر نیاز دارید که این اطلاعات هنگام اجرای \f[V]df\f[R] بر روی سامانه فایل
در دسترس باشد، پرچم \f[V]--vfs-used-is-size\f[R] را به rclone ارسال کنید.
با تنظیم این پرچم، rclone به جای اتکا به backend برای گزارش این اطلاعات،
تمام ریموت را همانند \f[V]rclone size\f[R] پیمایش کرده و فضای کل مصرف‌شده را
خودش محاسبه می‌کند.
.PP
\f[B]هشدار\f[R]: بر خلاف \f[V]rclone size\f[R]، این پرچم فیلترها را نادیده
می‌گیرد تا نتیجه دقیق باشد.
با این حال، این کار بسیار ناکارآمد است و ممکن است باعث فراخوانی‌های متعدد
API و در نتیجه تحمیل هزینه‌های اضافی شود.
از آن تنها به عنوان آخرین راهکار و فقط همراه با حافظه موقت (caching) استفاده کنید.
.SS فراداده VFS
.PP
اگر از پرچم \f[V]--vfs-metadata-extension\f[R] استفاده کنید، می‌توانید VFS
را وادار کنید فایل‌هایی را که حاوی فراداده (https://rclone.org/docs#metadata)
هستند به صورت یک شیء JSON نمایش دهد.
این فایل‌ها در فهرست دایرکتوری ظاهر نخواهند شد، اما می‌توان روی آن‌ها
\f[V]stat\f[R] زد و بازشان کرد؛ و به محض باز شدن، تا زمان انقضای حافظه موقت
دایرکتوری، در فهرست‌های دایرکتوری \f[B]ظاهر خواهند شد\f[R].
.PP
توجه داشته باشید که برخی backendها فراداده ایجاد نمی‌کنند مگر اینکه پرچم
\f[V]--metadata\f[R] را ارسال کنید.
.PP
برای نمونه، با استفاده از \f[V]rclone mount\f[R] به همراه
\f[V]--metadata --vfs-metadata-extension .metadata\f[R] چنین خروجی‌ای خواهیم داشت:
.IP
.nf
\f[C]
$ ls -l /mnt/
total 1048577
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G

$ cat /mnt/1G.metadata
{
        \[dq]atime\[dq]: \[dq]2025-03-04T17:34:22.317069787Z\[dq],
        \[dq]btime\[dq]: \[dq]2025-03-03T16:03:37.708253808Z\[dq],
        \[dq]gid\[dq]: \[dq]1000\[dq],
        \[dq]mode\[dq]: \[dq]100664\[dq],
        \[dq]mtime\[dq]: \[dq]2025-03-03T16:03:39.640238323Z\[dq],
        \[dq]uid\[dq]: \[dq]1000\[dq]
}

$ ls -l /mnt/
total 1048578
-rw-rw-r-- 1 user user 1073741824 Mar  3 16:03 1G
-rw-rw-r-- 1 user user        185 Mar  3 16:03 1G.metadata
\f[R]
.fi
.PP
اگر فایل فاقد فراداده باشد به صورت \f[V]{}\f[R] برگردانده می‌شود، و اگر
در خواندن فراداده خطایی رخ دهد، خطا به صورت
\f[V]{\[dq]error\[dq]:\[dq]error string\[dq]}\f[R] بازگردانده خواهد شد.
.SS پروکسی احراز هویت (Auth Proxy)
.PP
اگر پارامتر \f[V]--auth-proxy /path/to/program\f[R] را ارسال کنید،
rclone از آن برنامه برای ایجاد بلادرنگ backendها استفاده می‌کند که سپس
برای احراز هویت درخواست‌های دریافتی به کار می‌روند.
این سازوکار از یک پروتکل ساده مبتنی بر JSON با ورودی روی STDIN و خروجی روی
STDOUT استفاده می‌کند.
.PP
\f[B]لطفاً توجه داشته باشید:\f[R] گزینه‌های \f[V]--auth-proxy\f[R] و
\f[V]--authorized-keys\f[R] نمی‌توانند هم‌زمان استفاده شوند؛ در صورت تنظیم بودن
\f[V]--auth-proxy\f[R]، گزینه کلیدهای مجاز نادیده گرفته خواهد شد.
.PP
یک برنامه نمونه در مسیر
bin/test_proxy.py (https://github.com/rclone/rclone/blob/master/bin/test_proxy.py)
در سورس‌کد rclone وجود دارد.
.PP
وظیفه این برنامه دریافت \f[V]user\f[R] و \f[V]pass\f[R] در ورودی و تبدیل
آن‌ها به پیکربندی یک backend در قالب JSON روی STDOUT است.
این پیکربندی شامل تمام پارامترهای پیش‌فرض افزوده‌شده برای backend خواهد بود،
اما از پیکربندی متغیرهای محیطی یا گزینه‌های خط فرمان استفاده نخواهد کرد \-
ایجاد یک پیکربندی کامل، وظیفه برنامه پروکسی است.
.PP
این پیکربندی تولیدشده باید دارای این پارامتر اضافی باشد:
.IP \[bu] 2
\f[V]_root\f[R] \- ریشه (root) مورد استفاده برای backend
.PP
و می‌تواند شامل این پارامترها نیز باشد:
.IP \[bu] 2
\f[V]_obscure\f[R] \- رشته‌های جداشده با کاما برای پارامترهایی که باید مبهم‌سازی شوند
.IP \[bu] 2
\f[V]_secret_access_key\f[R] \- کلید مخفی (secret) برای احراز هویت access key در S3 (پایین را ببینید)
.PP
اگر احراز هویت با گذرواژه توسط کلاینت استفاده شده باشد، ورودی به فرایند پروکسی
(روی STDIN) شبیه به این خواهد بود:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]pass\[dq]: \[dq]mypassword\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
اگر احراز هویت با کلید عمومی (public-key) توسط کلاینت انجام شده باشد، ورودی به فرایند پروکسی
(روی STDIN) شبیه به این خواهد بود:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]public_key\[dq]: \[dq]AAAAB3NzaC1yc2EAAAADAQABAAABAQDuwESFdAe14hVS6omeyX7edc...JQdf\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
اگر کلاینت با یک access key مربوط به S3 احراز هویت کند
(\f[V]rclone serve s3\f[R])، کلاینت هرگز کلید مخفی (secret) خود را ارسال نمی‌کند،
بلکه تنها یک امضای ایجادشده با آن را می‌فرستد؛ بنابراین ورودی تنها حاوی access key ID
به عنوان \f[V]user\f[R] و بدون \f[V]pass\f[R] یا \f[V]public_key\f[R] خواهد بود:
.IP
.nf
\f[C]
{
  \[dq]user\[dq]: \[dq]AKIAIOSFODNN7EXAMPLE\[dq],
  \[dq]client_ip\[dq]: \[dq]192.168.1.1\[dq]
}
\f[R]
.fi
.PP
در این حالت، برنامه باید secret access key مربوط به آن access key ID را جستجو کرده
و آن را در فیلد \f[V]_secret_access_key\f[R] خروجی بازگرداند.
سپس rclone از آن secret برای تایید امضای روی درخواست استفاده می‌کند و در صورت عدم تطابق،
درخواست را رد می‌نماید.
این بدان معناست که برنامه پروکسی، مرجع اصلی (source of truth) هم برای اطلاعات
اعتبارسنجی و هم برای backend متناظر با آن‌ها است.
اگر برنامه \f[V]_secret_access_key\f[R] را برنگرداند یا آن را خالی بازگرداند،
درخواست رد می‌شود.
.PP
پاسخ برنامه برای یک access key ID در حافظه موقت ذخیره (cache) می‌شود (پایین را ببینید)، اما
حتی در صورتی که access key ID به طور مداوم در حال استفاده باشد، پس از ۵ دقیقه دوباره با
برنامه بررسی خواهد شد؛ بنابراین ابطال یک access key ID در برنامه ظرف ۵ دقیقه اعمال می‌شود.
یک کلید مخفی بازگردانی‌شده (rotated secret) در اولین درخواستی که با آن امضا شود اعمال خواهد شد.
.PP
کلید \f[V]client_ip\f[R] آدرس IP اتصال کلاینت را بدون شماره پورت در بر دارد.
از آن می‌توان برای محدود کردن ورودها به شبکه‌های خاص، یا ثبت متمرکز گزارش تلاش‌های
احراز هویت استفاده کرد.
اگر کلاینت فاقد آدرس IP باشد، برای مثال هنگام اتصال از طریق سوکت یونیکس (unix socket)،
این کلید حذف می‌شود.
توجه داشته باشید که اگر rclone پشت یک reverse proxy قرار داشته باشد، این مقدار آدرس
reverse proxy خواهد بود و نه آدرس کلاینت اصلی.
.PP
و به عنوان نمونه، چنین پاسخی را روی STDOUT بازمی‌گرداند:
.IP
.nf
\f[C]
{
  \[dq]type\[dq]: \[dq]sftp\[dq],
  \[dq]_root\[dq]: \[dq]\[dq],
  \[dq]_obscure\[dq]: \[dq]pass\[dq],
  \[dq]user\[dq]: \[dq]me\[dq],
  \[dq]pass\[dq]: \[dq]mypassword\[dq],
  \[dq]host\[dq]: \[dq]sftp.example.com\[dq]
}
\f[R]
.fi.PP
این بدان معناست که یک بک‌اند SFTP به‌صورت بلادرنگ برای
\f[V]user\f[R] و \f[V]pass\f[R]/\f[V]public_key\f[R] بازگردانده‌شده در
خروجی به میزبان مشخص‌شده ایجاد می‌شود.
توجه داشته باشید از آنجا که \f[V]_obscure\f[R] روی \f[V]pass\f[R] تنظیم شده است، rclone
پیش از ایجاد بک‌اند، پارامتر \f[V]pass\f[R] را مبهم‌سازی (obscure) خواهد کرد
(که برای بک‌اندهای sftp الزامی است).
.PP
برنامه می‌تواند \f[V]user\f[R] ارائه‌شده را به هر روشی دستکاری کند؛ برای
نمونه به‌منظور ایجاد پراکسی به چندین بک‌اند sftp مختلف، می‌توانید
\f[V]user\f[R] را برابر با \f[V]user\[at]example.com\f[R] قرار دهید و سپس
در خروجی، \f[V]host\f[R] را روی \f[V]example.com\f[R] و کاربر را روی
\f[V]user\f[R] تنظیم کنید.
به‌دلایل امنیتی احتمالاً مایل خواهید بود که \f[V]host\f[R] را به یک
فهرست محدود مقید کنید.
.PP
حافظه موقت (cache) داخلی بک‌اندها بر اساس \f[V]user\f[R]، هشی از
\f[V]pass\f[R] یا \f[V]public_key\f[R]، و \f[V]client_ip\f[R] کلیدگذاری می‌شود.
این بدان معناست که اگر گذرواژه یا کلید عمومی کاربر تغییر کند، کلاینت از یک
نشانی IP جدید متصل شود، یا پراکسی پارامترهای پیکربندی متفاوتی را برگرداند
(برای نمونه یک \f[V]api_key\f[R] دوره‌گردی‌شده/چرخش‌یافته)، در درخواست بعدی
به‌جای استفاده مجدد از نمونه ذخیره‌شده، یک بک‌اند تازه ایجاد خواهد شد.
.PP
از این سازوکار می‌توان برای ساخت پراکسی‌های چندمنظوره برای هر نوع بک‌اندی
که rclone پشتیبانی می‌کند، استفاده کرد.
.IP
.nf
\f[C]
rclone serve webdav remote:path [flags]
\f[R]
.fi
.SS گزینه‌ها (Options)
.IP
.nf
\f[C]
      --addr stringArray                       نشانی IP:Port یا :Port برای مقید کردن سرور به آن (پیش‌فرض 127.0.0.1:8080)
      --allow-origin string                    مبدأیی که درخواست میان‌دامنه (CORS) می‌تواند از آن اجرا شود
      --auth-proxy string                      برنامه‌ای برای ایجاد بک‌اند از طریق داده‌های احراز هویت
      --baseurl string                         پیشوند برای URLها - برای ریشه خالی بگذارید
      --cert string                            کلید TLS PEM (ترکیب گواهی و گواهی CA)
      --client-ca string                       مرجع صدور گواهی کلاینت (CA) جهت اعتبارسنجی کلاینت‌ها
      --dir-cache-time Duration                مدت‌زمان نگهداری مدخل‌های دایرکتوری در حافظه موقت (پیش‌فرض 5m0s)
      --dir-perms FileMode                     مجوزهای دایرکتوری (پیش‌فرض 777)
      --disable-dir-list                       غیرفعال کردن فهرست راهنمای HTML در درخواست GET برای دایرکتوری
      --disable-zip                            غیرفعال کردن بارگیری دایرکتوری‌ها در قالب فایل zip
      --etag-hash string                       هش مورد استفاده برای ETag، یا auto، یا خالی برای غیرفعال کردن
      --file-perms FileMode                    مجوزهای فایل (پیش‌فرض 666)
      --gid uint32                             بازنویسی مقدار gid تعیین‌شده توسط سیستم‌فایل (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض 1000)
  -h, --help                                   راهنمای webdav
      --htpasswd string                        یک فایل htpasswd - در صورت عدم ارائه، احراز هویتی انجام نمی‌شود
      --key string                             کلید خصوصی TLS PEM
      --link-perms FileMode                    مجوزهای پیوند (پیش‌فرض 666)
      --max-header-bytes int                   حداکثر اندازه سرآیند درخواست (پیش‌فرض 4096)
      --min-tls-version string                 حداقل نسخه قابل‌قبول TLS (پیش‌فرض \[dq]tls1.0\[dq])
      --no-checksum                            عدم مقایسه چک‌سام‌ها هنگام بارگذاری/بارگیری
      --no-modtime                             عدم خواندن/نوشتن زمان تغییر (می‌تواند سرعت را افزایش دهد)
      --no-seek                                عدم اجازه پرش (seeking) در فایل‌ها
      --pass string                            گذرواژه برای احراز هویت
      --poll-interval Duration                 زمان انتظار میان بررسی تغییرات، باید کمتر از dir-cache-time باشد و فقط در ریموت‌های پشتیبانی‌شده (0 برای غیرفعال کردن) (پیش‌فرض 1m0s)
      --read-only                              فقط اجازه دسترسی خواندنی داده شود
      --realm string                           حوزه (Realm) برای احراز هویت
      --response-header stringArray            تنظیم سرآیند HTTP برای تمام پاسخ‌ها و بازنویسی مقادیر موجود
      --salt string                            سالت هش کردن گذرواژه (پیش‌فرض \[dq]dlPL2MqE\[dq])
      --server-read-timeout Duration           مهلت زمانی سرور برای خواندن داده‌ها (پیش‌فرض 1h0m0s)
      --server-write-timeout Duration          مهلت زمانی سرور برای نوشتن داده‌ها (پیش‌فرض 1h0m0s)
      --template string                        قالب تعیین‌شده توسط کاربر
      --uid uint32                             بازنویسی مقدار uid تعیین‌شده توسط سیستم‌فایل (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض 1000)
      --umask FileMode                         بازنویسی بیت‌های مجوز تعیین‌شده توسط سیستم‌فایل (در ویندوز پشتیبانی نمی‌شود) (پیش‌فرض 002)
      --user string                            نام کاربری برای احراز هویت
      --user-from-header string                نام کاربری برگرفته از یک سرآیند HTTP مشخص
      --vfs-block-norm-dupes                   در صورت وجود نام‌های تکراری در یک دایرکتوری (پس از نرمال‌سازی)، ثبت خطا و پنهان کردن موارد تکراری (ممکن است هزینه کارایی داشته باشد)
      --vfs-cache-max-age Duration             حداکثر زمان از آخرین دسترسی به اشیاء در حافظه موقت (پیش‌فرض 1h0m0s)
      --vfs-cache-max-size SizeSuffix          حداکثر اندازه کل اشیاء موجود در حافظه موقت (پیش‌فرض off)
      --vfs-cache-min-free-space SizeSuffix    هدف حداقل فضای خالی دیسک شامل حافظه موقت (پیش‌فرض off)
      --vfs-cache-mode CacheMode               حالت کش off|minimal|writes|full (پیش‌فرض off)
      --vfs-cache-poll-interval Duration       بازه زمانی بررسی حافظه موقت برای یافتن اشیاء بیات‌شده (پیش‌فرض 1m0s)
      --vfs-case-insensitive                   اگر نام فایلی پیدا نشد، تطابق غیرحساس به بزرگ و کوچکی حروف بررسی شود
      --vfs-disk-space-total-size SizeSuffix   تعیین کل فضای دیسک (پیش‌فرض off)
      --vfs-fast-fingerprint                   استفاده از اثر انگشت‌های سریع (با دقت کمتر) برای تشخیص تغییرات
      --vfs-handle-caching Duration            مدت‌زمان نگهداری هندل فایل و دانلودکننده‌ها پس از آخرین بسته‌شدن (پیش‌فرض 5s)
      --vfs-links                              تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq] برای VFS
      --vfs-metadata-extension string          تنظیم پسوند برای خواندن فراداده از آن
      --vfs-read-ahead SizeSuffix              پیش‌خوانی اضافی مازاد بر --buffer-size هنگام استفاده از cache-mode full
      --vfs-read-chunk-size SizeSuffix         خواندن اشیاء مبدأ در قالب تکه‌ها (chunks) (پیش‌فرض 128Mi)
      --vfs-read-chunk-size-limit SizeSuffix   اگر از --vfs-read-chunk-size بیشتر باشد، دو برابر کردن اندازه تکه پس از هر بار خواندن تا رسیدن به حد نصاب (\[aq]off\[aq] نامحدود است) (پیش‌فرض off)
      --vfs-read-chunk-streams int             تعداد جریان‌های موازی برای خواندن هم‌زمان
      --vfs-read-wait Duration                 مدت‌زمان انتظار برای خواندن متوالی پیش از پرش (پیش‌فرض 20ms)
      --vfs-refresh                            تازه‌سازی بازگشتی حافظه موقت دایرکتوری در پس‌زمینه هنگام شروع
      --vfs-used-is-size rclone size           استفاده از الگوریتم اندازه rclone برای حجم استفاده‌شده
      --vfs-write-back Duration                مدت‌زمان بازنویسی فایل‌ها پس از آخرین استفاده در صورت استفاده از کش (پیش‌فرض 5s)
      --vfs-write-wait Duration                مدت‌زمان انتظار برای نوشتن متوالی پیش از اعلام خطا (پیش‌فرض 1s)
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری
(https://rclone.org/flags) را ببینید..SS گزینه‌های فیلتر (Filter Options)
.PP
پرچم‌هایی برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (از \- برای خواندن از stdin استفاده کنید)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام فایل‌های مبدأ از فایل (از \- برای خواندن از stdin استفاده کنید)
      --files-from-raw stringArray          خواندن فهرست نام فایل‌های مبدأ از فایل بدون هیچ پردازشی روی خطوط (از \- برای خواندن از stdin استفاده کنید)
      --files-from0 stringArray             خواندن فهرست نام فایل‌های مبدأ از فایل با استفاده از NUL به عنوان جداکننده (از \- برای خواندن از stdin استفاده کنید)
  -f, --filter stringArray                  افزودن یک قاعده فیلتر فایل
      --filter-from stringArray             خواندن الگوهای فیلتر فایل از یک فایل (از \- برای خواندن از stdin استفاده کنید)
      --hash-filter string                  افراز نام فایل‌ها با درهم‌سازی k/n یا تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (از \- برای خواندن از stdin استفاده کنید)
      --max-age Duration                    انتقال فایل‌های جدیدتر از این مقدار برحسب s یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض \-1)
      --max-size SizeSuffix                 انتقال فایل‌های کوچک‌تر از این مقدار برحسب KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنی کردن متادیتاهای منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متادیتا از فایل (از \- برای خواندن از stdin استفاده کنید)
      --metadata-filter stringArray         افزودن یک قاعده فیلتر متادیتا
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر متادیتا از یک فایل (از \- برای خواندن از stdin استفاده کنید)
      --metadata-include stringArray        شامل کردن متادیتاهای منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متادیتا از فایل (از \- برای خواندن از stdin استفاده کنید)
      --min-age Duration                    انتقال فایل‌های قدیمی‌تر از این مقدار برحسب s یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 انتقال فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone serve (https://rclone.org/commands/rclone_serve) \- سرویس‌دهی یک
ریموت بر بستر یک پروتکل.
.SH "rclone settier"
.PP
تغییر کلاس/سطح ذخیره‌سازی اشیاء در ریموت.
.SS خلاصه دستور (SYNOPSIS)
.PP
سطح یا کلاس ذخیره‌سازی را در ریموت (در صورت پشتیبانی) تغییر می‌دهد.
تعداد کمی از سرویس‌های ذخیره‌سازی ابری کلاس‌های ذخیره‌سازی متفاوتی را برای
اشیاء ارائه می‌دهند؛ برای نمونه AWS S3 و Glacier، ذخیره‌سازی Azure Blob با
سطوح Hot، Cool و Archive، سرویس Google Cloud Storage با Regional Storage،
Nearline، Coldline و غیره.
.PP
توجه داشته باشید که برخی تغییرات سطح دسترسی، دسترسی فوری به اشیاء را
غیرممکن می‌سازد.
برای نمونه تغییر سطح به Archive در Azure Blob Storage اشیاء را در وضعیت
منجمد (frozen) قرار می‌دهد و کاربر می‌تواند با تنظیم سطح به Hot/Cool آن‌ها
را بازیابی کند؛ به طور مشابه انتقال از S3 به Glacier شیء را غیرقابل
دسترس می‌کند.
.PP
می‌توانید از آن برای تغییر سطح یک شیء منفرد استفاده کنید:
.IP
.nf
\f[C]
rclone settier Cool remote:path/file
\f[R]
.fi
.PP
یا از فیلترهای rclone برای تعیین سطح تنها بر روی فایل‌های مشخص استفاده کنید:
.IP
.nf
\f[C]
rclone --include \[dq]*.txt\[dq] settier Hot remote:path/dir
\f[R]
.fi
.PP
یا فقط دایرکتوری ریموت را مشخص کنید تا تمام فایل‌های درون آن دایرکتوری
تغییر سطح داده شوند:
.IP
.nf
\f[C]
rclone settier tier remote:path/dir
\f[R]
.fi
.IP
.nf
\f[C]
rclone settier tier remote:path [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای settier
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone test
.PP
اجرای یک دستور آزمایشی
.SS "خلاصه دستور (SYNOPSIS)"
.PP
دستور rclone test برای اجرای دستورهای آزمایشی به کار می‌رود.
.PP
دستور آزمایشی مورد نظر خود را با زیردستور مشخص کنید، مانند:
.IP
.nf
\f[C]
rclone test memory remote:
\f[R]
.fi
.PP
هر زیردستور گزینه‌های مخصوص به خود را دارد که می‌توانید آن‌ها را در راهنمای مربوطه‌شان مشاهده کنید.
.PP
\f[B]توجه:\f[R] در اجرای این دستورها احتیاط کنید؛ آن‌ها ممکن است رفتارهای غیرمنتظره‌ای داشته باشند، بنابراین توصیه می‌شود ابتدا مستندات مربوط به آن‌ها را مطالعه فرمایید.
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای test
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.IP \[bu] 2
rclone test changenotify (https://rclone.org/commands/rclone_test_changenotify) \- ثبت وقایع هرگونه درخواست اعلان تغییر (change notify) برای ریموتِ ارائه‌شده.
.IP \[bu] 2
rclone test histogram (https://rclone.org/commands/rclone_test_histogram) \- ایجاد یک هیستوگرام از نویسه‌های نام فایل‌ها.
.IP \[bu] 2
rclone test info (https://rclone.org/commands/rclone_test_info) \- کشف محدودیت‌های نام فایل یا سایر محدودیت‌ها برای مسیرها.
.IP \[bu] 2
rclone test makefile (https://rclone.org/commands/rclone_test_makefile) \- ساخت فایل‌هایی با محتوای تصادفی و اندازه مشخص‌شده.
.IP \[bu] 2
rclone test makefiles (https://rclone.org/commands/rclone_test_makefiles) \- ایجاد یک ساختار سلسله‌مراتبی تصادفی از فایل‌ها درون یک دایرکتوری.
.IP \[bu] 2
rclone test memory (https://rclone.org/commands/rclone_test_memory) \- بارگذاری تمام اشیاء موجود در remote:path به درون حافظه و گزارش آمار حافظه.
.IP \[bu] 2
rclone test speed (https://rclone.org/commands/rclone_test_speed) \- اجرای آزمون سرعت اتصال به ریموت.
.SH rclone test changenotify
.PP
ثبت وقایع هرگونه درخواست اعلان تغییر (change notify) برای ریموتِ ارائه‌شده.
.IP
.nf
\f[C]
rclone test changenotify remote: [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help                     راهنمای changenotify
      --poll-interval Duration   مدت زمان انتظار بین بررسی برای تغییرات (پیش‌فرض 10s)
\f[R]
.fi
.PP
برای مشاهدهٔ گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone test (https://rclone.org/commands/rclone_test) \- اجرای یک دستور آزمایشی
.SH rclone test histogram
.PP
یک هیستوگرام از نویسه‌های نام فایل می‌سازد.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
این دستور یک خروجی JSON تولید می‌کند که هیستوگرام نویسه‌های به‌کاررفته در نام‌های فایل در remote:path مشخص‌شده را نشان می‌دهد.
.PP
این داده‌ها شامل هیچ‌گونه اطلاعات هویتی نیستند اما برای توسعه‌دهندگان rclone هنگام توسعه فشرده‌سازی نام فایل مفید هستند.
.IP
.nf
\f[C]
rclone test histogram [remote:path] [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای histogram
\f[R]
.fi
.PP
برای مشاهدهٔ گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone test (https://rclone.org/commands/rclone_test) \- اجرای یک دستور آزمایشی
.SH rclone test info
.PP
محدودیت‌های نام فایل یا سایر محدودیت‌ها را برای مسیرها شناسایی می‌کند.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
بررسی می‌کند که ایجاد چه نام‌های فایل و استفاده از چه روش‌های بارگذاری‌ای در مسیرهای ارائه‌شده ممکن است و طول آن‌ها چقدر می‌تواند باشد.
این کار ممکن است مدتی زمان ببرد.
این دستور فایل‌های آزمایشی را درون remote:path ارائه‌شده می‌نویسد.
برای هر یک، مقداری کد go در خروجی تولید می‌کند.
.PP
\f[B]توجه:\f[R] این کار می‌تواند فایل‌های غیرقابل‌حذف و خطرات دیگری ایجاد کند \- با احتیاط استفاده کنید!
.IP
.nf
\f[C]
rclone test info [remote:path]+ [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --all                    اجرای تمام آزمایش‌ها
      --check-base32768        بررسی امکان ذخیره تمام نویسه‌های ممکن base32768
      --check-control          بررسی نویسه‌های کنترلی
      --check-length           بررسی حداکثر طول نام فایل
      --check-normalization    بررسی یکسان‌سازی UTF-8
      --check-streaming        بررسی بارگذاری‌ها با اندازه فایل نامشخص
  -h, --help                   راهنمای info
      --keep-test-files        نگه‌داشتن فایل‌های آزمایشی پس از اجرا
      --upload-wait Duration   مدت انتظار پس از نوشتن یک فایل (پیش‌فرض 0s)
      --write-json string      نوشتن نتایج در فایل
\f[R]
.fi
.PP
برای مشاهدهٔ گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید..SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone test (https://rclone.org/commands/rclone_test) \- اجرای یک دستور آزمایشی
.SH rclone test makefile
.PP
ایجاد فایل‌هایی با محتوای تصادفی و به اندازه داده‌شده
.IP
.nf
\f[C]
rclone test makefile <size> [<file>]+ [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --ascii      تنها پر کردن فایل‌ها با بایت‌های قابل چاپ تصادفی ASCII
      --chargen    پر کردن فایل‌ها با یک الگوی chargen اسکی
  -h, --help       راهنمای makefile
      --pattern    پر کردن فایل‌ها با یک الگوی متناوب
      --seed int   بذر برای مولد اعداد تصادفی (0 برای تصادفی) (پیش‌فرض 1)
      --sparse     تنک ساختن فایل‌ها (sparse) (ظاهراً پر شده با ASCII 0x00)
      --zero       پر کردن فایل‌ها با ASCII 0x00
\f[R]
.fi
.PP
برای مشاهده گزینه‌های عمومی که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone test (https://rclone.org/commands/rclone_test) \- اجرای یک دستور آزمایشی
.SH rclone test makefiles
.PP
ایجاد یک سلسله‌مراتب فایل تصادفی در یک دایرکتوری
.IP
.nf
\f[C]
rclone test makefiles <dir> [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
      --ascii                      تنها پر کردن فایل‌ها با بایت‌های قابل چاپ تصادفی ASCII
      --chargen                    پر کردن فایل‌ها با یک الگوی chargen اسکی
      --files int                  تعداد فایل‌ها برای ایجاد (پیش‌فرض 1000)
      --files-per-directory int    میانگین تعداد فایل‌ها در هر دایرکتوری (پیش‌فرض 10)
      --flat                       در صورت تعیین، تمام فایل‌ها در دایرکتوری ریشه ایجاد می‌شوند
  -h, --help                       راهنمای makefiles
      --max-depth int              حداکثر عمق سلسله‌مراتب دایرکتوری (پیش‌فرض 10)
      --max-file-size SizeSuffix   حداکثر اندازه فایل‌ها برای ایجاد (پیش‌فرض 100)
      --max-name-length int        حداکثر اندازه نام فایل‌ها (پیش‌فرض 12)
      --min-file-size SizeSuffix   حداقل اندازه فایل برای ایجاد
      --min-name-length int        حداقل اندازه نام فایل‌ها (پیش‌فرض 4)
      --pattern                    پر کردن فایل‌ها با یک الگوی متناوب
      --seed int                   بذر برای مولد اعداد تصادفی (0 برای تصادفی) (پیش‌فرض 1)
      --sparse                     تنک ساختن فایل‌ها (sparse) (ظاهراً پر شده با ASCII 0x00)
      --zero                       پر کردن فایل‌ها با ASCII 0x00
\f[R]
.fi
.PP
برای مشاهده گزینه‌های عمومی که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone test (https://rclone.org/commands/rclone_test) \- اجرای یک دستور آزمایشی
.SH rclone test memory
.PP
بارگذاری تمام اشیاء در remote:path درون حافظه و گزارش آمار حافظه.
.IP
.nf
\f[C]
rclone test memory remote:path [flags]
\f[R]
.fi
.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help   راهنمای memory
\f[R]
.fi
.PP
برای مشاهده گزینه‌های عمومی که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید..SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone test (https://rclone.org/commands/rclone_test) \- اجرای یک دستور آزمایشی
.SH rclone test speed
.PP
اجرای آزمون سرعت با ریموت
.SS خلاصه دستور (SYNOPSIS)
.PP
اجرای آزمون سرعت با ریموت.
.PP
این دستور مجموعه‌ای از بارگذاری‌ها و بارگیری‌ها را با ریموت اجرا می‌کند و سرعت هر آزمون را با استفاده از اندازه‌ها و تعداد متغیر فایل‌ها اندازه‌گیری کرده و نمایش می‌دهد.
.PP
زمان آزمون ممکن است با سقف کم تعداد فایل‌ها و فایل‌های بزرگ نادرست باشد، زیرا از نتایج آزمون اولیه برای تعیین تعداد فایل‌های مورد استفاده در هر آزمون بعدی بهره می‌گیرد.
.PP
توصیه می‌شود برای خروجی ساده‌تر از پرچم \-q استفاده کنید.
برای نمونه:
.IP
.nf
\f[C]
rclone test speed remote: -q
\f[R]
.fi
.PP
\f[B]نکته:\f[R] این دستور فایل‌هایی را در یک پوشه با نام تصادفی روی ریموت ایجاد و حذف می‌کند که در صورت خروج تمیز به‌طور خودکار حذف خواهد شد.
.PP
می‌توانید از پرچم --json برای نمایش نتایج فقط در قالب JSON استفاده کنید.
.IP
.nf
\f[C]
rclone test speed <remote> [flags]
\f[R]
.fi
.SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
      --ascii                پر کردن فایل‌ها تنها با بایت‌های تصادفی و قابل چاپ ASCII
      --chargen              پر کردن فایل‌ها با یک الگوی chargen اسکی
      --file-cap int         حداکثر تعداد فایل‌ها در هر آزمون (پیش‌فرض 100)
  -h, --help                 راهنمای speed
      --json                 نمایش خروجی تنها در قالب JSON
      --large SizeSuffix     اندازه فایل‌های بزرگ (پیش‌فرض 1Gi)
      --medium SizeSuffix    اندازه فایل‌های متوسط (پیش‌فرض 10Mi)
      --pattern              پر کردن فایل‌ها با یک الگوی متناوب
      --seed int             سید برای تولیدکننده اعداد تصادفی (0 برای تصادفی) (پیش‌فرض 1)
      --small SizeSuffix     اندازه فایل‌های کوچک (پیش‌فرض 1Ki)
      --sparse               تنک ساختن فایل‌ها (نمایش به صورت پرشده با ASCII 0x00)
      --test-time Duration   مدت‌زمان اجرای هر آزمون (پیش‌فرض 15s)
      --zero                 پر کردن فایل‌ها با ASCII 0x00
\f[R]
.fi
.PP
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS همچنین ببینید (SEE ALSO)
.IP \[bu] 2
rclone test (https://rclone.org/commands/rclone_test) \- اجرای یک دستور آزمایشی
.SH rclone touch
.PP
ایجاد فایل جدید یا تغییر زمان ویرایش فایل.
.SS خلاصه دستور (SYNOPSIS)
.PP
تنظیم زمان ویرایش فایل(ها) به زمان فعلی بر اساس remote:path.
.PP
اگر remote:path وجود نداشته باشد، یک فایل با اندازه صفر ایجاد خواهد شد مگر اینکه \f[V]--no-create\f[R] یا \f[V]--recursive\f[R] مشخص شده باشد.
.PP
در صورت استفاده از \f[V]--recursive\f[R]، زمان ویرایش به‌طور بازگشتی روی همه فایل‌های موجود در این مسیر تنظیم می‌شود.
فیلترها پشتیبانی می‌شوند، و می‌توانید با پرچم‌های \f[V]--dry-run\f[R] یا \f[V]--interactive\f[R]/\f[V]-i\f[R] آن را بیازمایید.
این دستور به‌طور هم‌زمان \f[V]--transfers\f[R] فایل را دستکاری (touch) می‌کند.
.PP
اگر از \f[V]--timestamp\f[R] استفاده شود، زمان ویرایش به‌جای زمان فعلی، روی آن زمان مشخص تنظیم می‌شود.
زمان‌ها می‌توانند به یکی از حالت‌های زیر مشخص شوند:
.IP \[bu] 2
\[aq]YYMMDD\[aq] \- برای نمونه:
17.10.30
.IP \[bu] 2
\[aq]YYYY-MM-DDTHH:MM:SS\[aq] \- برای نمونه:
2006-01-02T15:04:05
.IP \[bu] 2
\[aq]YYYY-MM-DDTHH:MM:SS.SSS\[aq] \- برای نمونه:
2006-01-02T15:04:05.123456789
.PP
توجه داشته باشید که مقدار \f[V]--timestamp\f[R] در مبنای UTC است.
اگر زمان محلی را می‌خواهید، پرچم \f[V]--localtime\f[R] را اضافه کنید.
.PP
هنگام ایجاد یک فایل جدید می‌توان با \f[V]--metadata-set\f[R] متادیتا اضافه کرد.
برای نمونه: rclone touch remote:path -M --metadata-set key=value
.IP
.nf
\f[C]
rclone touch remote:path [flags]
\f[R]
.fi.SS "گزینه‌ها (OPTIONS)"
.IP
.nf
\f[C]
  -h, --help               راهنمایی برای touch
      --localtime          استفاده از زمان محلی به‌جای UTC برای برچسب زمان
  -C, --no-create          عدم ایجاد فایل در صورت عدم وجود (با --recursive ضمنی است)
  -R, --recursive          اعمال بازگشتی touch روی همهٔ فایل‌ها
  -t, --timestamp string   استفاده از زمان مشخص‌شده به‌جای زمان جاری روز
\f[R]
.fi
.PP
گزینه‌های مشترک با سایر دستورها در ادامه شرح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحهٔ پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "گزینه‌های مهم"
.PP
پرچم‌های مهم و کاربردی برای بیشتر دستورها
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال تغییرات دائمی
  -i, --interactive     فعال‌سازی حالت تعاملی
  -v, --verbose count   چاپ خروجی با جزئیات بسیار بیشتر (برای جزئیات بیشتر تکرار کنید)
\f[R]
.fi
.SS "گزینه‌های فیلتر"
.PP
پرچم‌هایی برای فیلتر کردن فهرست‌های دایرکتوری
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های مستثنا شده از همگام‌سازی در مقصد
      --exclude stringArray                 مستثنا کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از - برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنا کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل مبدأ از فایل (استفاده از - برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل مبدأ از فایل بدون هیچ‌گونه پردازش خط‌ها (استفاده از - برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (استفاده از - برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قاعدهٔ فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (استفاده از - برای خواندن از stdin)
      --hash-filter string                  بخش‌بندی نام‌های فایل بر اساس هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف بزرگ و کوچک)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از - برای خواندن از stdin)
      --max-age Duration                    تنها انتقال فایل‌های جدیدتر از این مقدار برحسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تعیین، محدود کردن عمق بازگشت به این مقدار (پیش‌فرض -1)
      --max-size SizeSuffix                 تنها انتقال فایل‌های کوچک‌تر از این مقدار برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنا کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (استفاده از - برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قاعدهٔ فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متاداده از یک فایل (استفاده از - برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از یک فایل (استفاده از - برای خواندن از stdin)
      --min-age Duration                    تنها انتقال فایل‌های قدیمی‌تر از این مقدار برحسب s یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 تنها انتقال فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS "گزینه‌های فهرست‌کردن"
.PP
پرچم‌هایی برای فهرست کردن دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت در دسترس بودن؛ مصرف حافظهٔ بیشتر اما تراکنش‌های کمتر
\f[R]
.fi
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SH rclone tree
.PP
فهرست کردن محتویات ریموت به‌صورت درختی.
.SS "خلاصه دستور (SYNOPSIS)"
.PP
محتویات یک ریموت را به روشی مشابه با دستور tree یونیکس فهرست می‌کند.
.PP
برای نمونه
.IP
.nf
\f[C]
$ rclone tree remote:path
/
├── file1
├── file2
├── file3
└── subdir
    ├── file4
    └── file5

1 directories, 5 files
\f[R]
.fi
.PP
می‌توانید از هر یک از گزینه‌های فیلترسازی با دستور tree استفاده کنید (مانند
\f[V]--include\f[R] و \f[V]--exclude\f[R]).
همچنین می‌توانید از \f[V]--fast-list\f[R] استفاده کنید.
.PP
دستور tree گزینه‌های متعددی برای کنترل نحوهٔ فهرست کردن دارد که با دستور
tree سازگار هستند؛ برای نمونه می‌توانید اندازهٔ فایل‌ها را با \f[V]--size\f[R] بگنجانید.
توجه داشته باشید که همهٔ آن‌ها گزینهٔ کوتاه ندارند، زیرا با گزینه‌های کوتاه
rclone تداخل پیدا می‌کنند.
.PP
برای پیمایش تعاملی‌تر ریموت، دستور
ncdu (https://rclone.org/commands/rclone_ncdu) را ببینید.
.IP
.nf
\f[C]
rclone tree remote:path [flags]
\f[R]
.fi.SS "گزینه‌ها (Options)"
.IP
.nf
\f[C]
  -a, --all             فهرست کردن همه فایل‌ها (فهرست کردن فایل‌های . نیز)
  -d, --dirs-only       تنها فهرست کردن دایرکتوری‌ها
      --dirsfirst       فهرست کردن دایرکتوری‌ها پیش از فایل‌ها (با -U غیرفعال می‌شود)
      --full-path       چاپ پیشوند مسیر کامل برای هر فایل
  -h, --help            راهنما برای tree
      --level int       پایین رفتن تنها تا سطح level از دایرکتوری‌ها
  -D, --modtime         چاپ تاریخ آخرین تغییر.
      --noindent        خطوط تورفتگی چاپ نشوند
      --noreport        خاموش کردن شمارش فایل/دایرکتوری در پایان فهرست درختی
  -o, --output string   ارسال خروجی به فایل به جای stdout
  -p, --protections     چاپ مجوزهای حفاظتی برای هر فایل.
  -Q, --quote           قرار دادن نام فایل‌ها در جفت‌گیومه (double quotes).
  -s, --size            چاپ اندازه هر فایل به بایت.
      --sort string     انتخاب مرتب‌سازی: name,version,size,mtime,ctime
      --sort-ctime      مرتب‌سازی فایل‌ها بر اساس زمان آخرین تغییر وضعیت (ctime)
  -t, --sort-modtime    مرتب‌سازی فایل‌ها بر اساس زمان آخرین تغییر (mtime)
  -r, --sort-reverse    معکوس کردن ترتیب مرتب‌سازی
  -U, --unsorted        نامرتب رها کردن فایل‌ها
      --version         مرتب‌سازی الفبایی-عددی فایل‌ها بر اساس نسخه
\f[R]
.fi
.PP
گزینه‌های مشترک با دیگر دستورها در ادامه توضیح داده شده‌اند.
برای گزینه‌های سراسری که در اینجا فهرست نشده‌اند، صفحه پرچم‌های سراسری (https://rclone.org/flags) را ببینید.
.SS "گزینه‌های فیلتر (Filter Options)"
.PP
پرچم‌هایی برای فیلتر کردن فهرست دایرکتوری‌ها
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (برای خواندن از stdin از - استفاده کنید)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل‌های مبدأ از فایل (برای خواندن از stdin از - استفاده کنید)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل‌های مبدأ از فایل بدون هیچ‌گونه پردازش روی خطوط (برای خواندن از stdin از - استفاده کنید)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل مبدأ از فایل با استفاده از NUL به عنوان جداکننده (برای خواندن از stdin از - استفاده کنید)
  -f, --filter stringArray                  افزودن یک قانون فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --hash-filter string                  افراز نام فایل‌ها با هش k/n یا به صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (ناحساس به حروف)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (برای خواندن از stdin از - استفاده کنید)
      --max-age Duration                    انتقال تنها فایل‌های جدیدتر از این مقدار بر حسب ثانیه یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --max-depth int                       در صورت تعیین، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض -1)
      --max-size SizeSuffix                 انتقال تنها فایل‌های کوچک‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
      --metadata-exclude stringArray        مستثنی کردن متاداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای متاداده از فایل (برای خواندن از stdin از - استفاده کنید)
      --metadata-filter stringArray         افزودن یک قانون فیلتر کردن متاداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن متاداده از یک فایل (برای خواندن از stdin از - استفاده کنید)
      --metadata-include stringArray        شامل کردن متاداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول متاداده از فایل (برای خواندن از stdin از - استفاده کنید)
      --min-age Duration                    انتقال تنها فایل‌های قدیمی‌تر از این مقدار بر حسب ثانیه یا پسوند ms|s|m|h|d|w|M|y (پیش‌فرض خاموش)
      --min-size SizeSuffix                 انتقال تنها فایل‌های بزرگ‌تر از این مقدار بر حسب KiB یا پسوند B|K|M|G|T|P (پیش‌فرض خاموش)
\f[R]
.fi
.SS "گزینه‌های فهرست‌بندی (Listing Options)"
.PP
پرچم‌هایی برای فهرست‌بندی دایرکتوری‌ها
.IP
.nf
\f[C]
      --default-time Time   زمانی که اگر modtime برای فایل‌ها و دایرکتوری‌ها ناشناخته باشد نشان داده می‌شود (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌بندی بازگشتی در صورت موجود بودن؛ حافظه بیشتر اما تراکنش‌های کمتری مصرف می‌کند
\f[R]
.fi
.SS "همچنین ببینید (See Also)"
.IP \[bu] 2
rclone (https://rclone.org/commands/rclone) \- نمایش راهنما برای دستورها، پرچم‌ها و backendهای rclone.
.SS "کپی کردن تک‌فایل‌ها (Copying single files)"
.PP
دستور rclone به طور معمول دایرکتوری‌ها را همگام‌سازی کرده یا رونوشت می‌گیرد.
با این حال، اگر ریموت مبدأ به یک فایل اشاره کند، rclone تنها همان فایل را کپی خواهد کرد.
ریموت مقصد باید به یک دایرکتوری اشاره کند \- در غیر این صورت rclone خطای زیر را خواهد داد:
\f[V]Failed to create file system for \[dq]remote:file\[dq]: is a file not a directory\f[R]
.PP
برای نمونه، فرض کنید ریموتی دارید که فایلی به نام
\f[V]test.jpg\f[R] دارد، آن‌گاه می‌توانید تنها همان فایل را این‌گونه کپی کنید:
.IP
.nf
\f[C]
rclone copy remote:test.jpg /tmp/download
\f[R]
.fi
.PP
فایل \f[V]test.jpg\f[R] درون
\f[V]/tmp/download\f[R] قرار خواهد گرفت.
.PP
این معادل مشخص کردن دستور زیر است:
.IP
.nf
\f[C]
rclone copy --files-from /tmp/files remote: /tmp/download
\f[R]
.fi
.PP
که در آن \f[V]/tmp/files\f[R] شامل این تک‌خط است:
.IP
.nf
\f[C]
test.jpg
\f[R]
.fi
.PP
توصیه می‌شود هنگام کپی کردن فایل‌های تکی از \f[V]copy\f[R] استفاده کنید، نه \f[V]sync\f[R].
آن‌ها تقریباً تأثیر یکسانی دارند اما \f[V]copy\f[R] حافظه بسیار کمتری مصرف خواهد کرد..SS ساختار مسیرهای راه دور
.PP
ساختار مسیرهایی که به دستور rclone داده می‌شوند به شرح زیر است.
.SS /path/to/dir
.PP
این ساختار به سیستم‌فایل محلی اشاره دارد.
.PP
در Windows \f[B]تنها\f[R] در مسیرهای محلی می‌توان از \f[V]\[rs]\f[R] به جای \f[V]/\f[R] استفاده کرد؛ در مسیرهای غیرمحلی حتماً باید از \f[V]/\f[R] استفاده شود.
برای اطلاعات بیشتر درباره مسیرهای مخصوص Windows، مستندات سیستم‌فایل محلی (https://rclone.org/local/#paths-on-windows) را ببینید.
.PP
نیازی نیست این مسیرها با \f[V]/\f[R] آغازین شروع شوند \- اگر چنین نباشد، مسیرها نسبت به دایرکتوری جاری در نظر گرفته خواهند شد.
.SS remote:path/to/dir
.PP
این ساختار به دایرکتوری \f[V]path/to/dir\f[R] روی \f[V]remote:\f[R] همان‌گونه که در فایل پیکربندی تعریف شده است (پیکربندی‌شده با \f[V]rclone config\f[R]) اشاره دارد.
.SS remote:/path/to/dir
.PP
در بیشتر backendها این ساختار به همان دایرکتوری \f[V]remote:path/to/dir\f[R] اشاره دارد و استفاده از آن قالب ترجیح داده می‌شود.
در تعداد بسیار اندکی از remoteها (مانند FTP، SFTP، Dropbox for business) این ساختار به دایرکتوری متفاوتی اشاره خواهد کرد.
در این موارد، مسیرهای بدون \f[V]/\f[R] آغازین به دایرکتوری \[dq]home\[dq] شما و مسیرهای دارای \f[V]/\f[R] آغازین به ریشه (root) اشاره خواهند داشت.
.SS :backend:path/to/dir
.PP
این یک ساختار پیشرفته برای ایجاد remoteها به صورت آنی (on the fly) است.
مقدار \f[V]backend\f[R] باید نام یا پیشوند یک backend (همان \f[V]type\f[R] در فایل پیکربندی) باشد و تمام پیکربندی لازم برای backend باید از طریق خط فرمان (یا در متغیرهای محیطی) ارائه شود.
.PP
در اینجا چند مثال آورده شده است:
.IP
.nf
\f[C]
rclone lsd --http-url https://pub.rclone.org :http:
\f[R]
.fi
.PP
برای فهرست کردن تمام دایرکتوری‌ها در ریشهٔ
\f[V]https://pub.rclone.org\f[R].
.IP
.nf
\f[C]
rclone lsf --http-url https://example.com :http:path/to/dir
\f[R]
.fi
.PP
برای فهرست کردن فایل‌ها و دایرکتوری‌ها در
\f[V]https://example.com/path/to/dir\f[R]
.IP
.nf
\f[C]
rclone copy --http-url https://example.com :http:path/to/dir /tmp/dir
\f[R]
.fi
.PP
برای کپی کردن فایل‌ها و دایرکتوری‌ها در
\f[V]https://example.com/path/to/dir\f[R] به \f[V]/tmp/dir\f[R].
.IP
.nf
\f[C]
rclone copy --sftp-host example.com :sftp:path/to/dir /tmp/dir
\f[R]
.fi
.PP
برای کپی کردن فایل‌ها و دایرکتوری‌ها از \f[V]example.com\f[R] در دایرکتوری
نسبی \f[V]path/to/dir\f[R] به \f[V]/tmp/dir\f[R] با استفاده از sftp.
.SS رشته‌های اتصال (Connection strings)
.PP
مثال‌های بالا را می‌توان با استفاده از نحو رشته اتصال نیز نوشت؛
بنابراین به جای ارائه آرگومان‌ها به عنوان پارامترهای خط فرمان مانند
\f[V]--http-url https://pub.rclone.org\f[R]، آنها به عنوان بخشی از
مشخصات remote در قالب نوعی رشته اتصال ارائه می‌شوند.
.IP
.nf
\f[C]
rclone lsd \[dq]:http,url=\[aq]https://pub.rclone.org\[aq]:\[dq]
rclone lsf \[dq]:http,url=\[aq]https://example.com\[aq]:path/to/dir\[dq]
rclone copy \[dq]:http,url=\[aq]https://example.com\[aq]:path/to/dir\[dq] /tmp/dir
rclone copy :sftp,host=example.com:path/to/dir /tmp/dir
\f[R]
.fi
.PP
این روش می‌تواند برای تغییر دادن remoteهای موجود و همچنین ساخت remoteهای جدید
با ساختار آنی (on the fly) به کار رود.
این مثال معادل افزودن پارامتر
\f[V]--drive-shared-with-me\f[R] به remote با نام
\f[V]gdrive:\f[R] است.
.IP
.nf
\f[C]
rclone lsf \[dq]gdrive,shared_with_me:path/to/dir\[dq]
\f[R]
.fi
.PP
مزیت اصلی استفاده از ساختار رشته اتصال این است که
تنها روی همان remote اعمال می‌شود، نه بر روی تمام remoteهای از آن نوع در خط فرمان.
یک سردرگمی رایج، تلاش برای کپی کردن یک فایل به‌اشتراک‌گذاشته‌شده در Google Drive
به درایو معمولی است که \f[B]کار نمی‌کند\f[R]؛ زیرا پرچم
\f[V]--drive-shared-with-me\f[R] هم بر مبدأ و هم بر مقصد اعمال می‌شود.
.IP
.nf
\f[C]
rclone copy --drive-shared-with-me gdrive:shared-file.txt gdrive:
\f[R]
.fi
.PP
با این حال با استفاده از ساختار رشته اتصال، این دستور به درستی کار می‌کند.
.IP
.nf
\f[C]
rclone copy \[dq]gdrive,shared_with_me:shared-file.txt\[dq] gdrive:
\f[R]
.fi
.PP
توجه داشته باشید که رشته اتصال تنها بر گزینه‌های
backend مستقیم (بی‌واسطه) تأثیر می‌گذارد.
اگر برای مثال gdriveCrypt یک crypt مبتنی بر gdrive باشد،
دستور زیر مطابق انتظار \f[B]کار نخواهد کرد\f[R]، چرا که
\f[V]shared_with_me\f[R] توسط backend کریپت نادیده گرفته می‌شود:
.IP
.nf
\f[C]
rclone copy \[dq]gdriveCrypt,shared_with_me:shared-file.txt\[dq] gdriveCrypt:
\f[R]
.fi
.PP
رشته‌های اتصال دارای نحو زیر هستند:
.IP
.nf
\f[C]
remote,parameter=value,parameter2=value2:path/to/dir
:backend,parameter=value,parameter2=value2:path/to/dir
\f[R]
.fi
.PP
اگر مقدار \f[V]parameter\f[R] دارای یک \f[V]:\f[R] یا \f[V],\f[R] باشد،
باید درون علامت نقل‌قول \f[V]\[dq]\f[R] یا \f[V]\[aq]\f[R] قرار گیرد، مانند:
.IP
.nf
\f[C]
remote,parameter=\[dq]colon:value\[dq],parameter2=\[dq]comma,value\[dq]:path/to/dir
:backend,parameter=\[aq]colon:value\[aq],parameter2=\[aq]comma,value\[aq]:path/to/dir
\f[R]
.fi
.PP
اگر یک مقدار نقل‌قول‌شده نیاز به گنجاندن همان علامت نقل‌قول داشته باشد،
باید دو بار تکرار شود، مانند:
.IP
.nf
\f[C]
remote,parameter=\[dq]with\[dq]\[dq]quote\[dq],parameter2=\[aq]with\[aq]\[aq]quote\[aq]:path/to/dir
\f[R]
.fi
.PP
این کار باعث می‌شود مقدار \f[V]parameter\f[R] برابر با \f[V]with\[dq]quote\f[R] و
مقدار \f[V]parameter2\f[R] برابر با \f[V]with\[aq]quote\f[R] شود.
.PP
اگر \f[V]=parameter\f[R] را درج نکنید، rclone مقدار
\f[V]=true\f[R] را جایگزین می‌کند که برای پرچم‌ها بسیار مناسب است.
برای مثال، جهت استفاده از s3 پیکربندی‌شده در متغیرهای محیطی می‌توانید بنویسید:
.IP
.nf
\f[C]
rclone lsd :s3,env_auth:
\f[R]
.fi
.PP
که معادل است با:
.IP
.nf
\f[C]
rclone lsd :s3,env_auth=true:
\f[R]
.fi.PP
توجه داشته باشید که در خط فرمان ممکن است لازم باشد این رشته‌های اتصال را با \f[V]\[dq]\f[R] یا \f[V]\[aq]\f[R] محصور کنید تا از تفسیر هرگونه نویسه خاص درون آن‌ها توسط پوسته جلوگیری شود.
.PP
اگر در کار با پوسته مهارت دارید، خواهید دانست کدام رشته‌ها مجاز و کدام غیرمجاز هستند، اما اگر مطمئن نیستید، آن‌ها را در \f[V]\[dq]\f[R] قرار داده و از \f[V]\[aq]\f[R] به‌عنوان نقل‌قول درونی استفاده کنید.
این نحو در تمامی سیستم‌عامل‌ها کار می‌کند.
.IP
.nf
\f[C]
rclone copy \[dq]:http,url=\[aq]https://example.com\[aq]:path/to/dir\[dq] /tmp/dir
\f[R]
.fi
.PP
در لینوکس/macOS برخی نویسه‌ها همچنان درون رشته‌های \f[V]\[dq]\f[R] در پوسته تفسیر می‌شوند (به‌ویژه \f[V]\[rs]\f[R]، \f[V]$\f[R] و \f[V]\[dq]\f[R])، بنابراین اگر رشته‌های شما شامل این نویسه‌ها هستند می‌توانید جای \f[V]\[dq]\f[R] و \f[V]\[aq]\f[R] را بدین‌گونه تغییر دهید.
(این نحو در Windows کار نمی‌کند.)
.IP
.nf
\f[C]
rclone copy \[aq]:http,url=\[dq]https://example.com\[dq]:path/to/dir\[aq] /tmp/dir
\f[R]
.fi
.PP
می‌توانید از rclone config string (<https://rclone.org/commands/rclone_config_string>) برای تبدیل یک ریموت به یک رشته اتصال استفاده کنید.
.SS "رشته‌های اتصال، پیکربندی و لاگ‌گیری (Connection strings, config and logging)"
.PP
اگر پیکربندی اضافی را از طریق پرچم خط فرمان، متغیر محیطی یا رشته اتصال به یک backend اعمال کنید، rclone پسوندی را بر اساس هش (hash) پیکربندی به نام ریموت اضافه می‌کند، برای نمونه:
.IP
.nf
\f[C]
rclone -vv lsf --s3-chunk-size 20M s3:
\f[R]
.fi
.PP
پیام لاگ زیر را به همراه دارد:
.IP
.nf
\f[C]
DEBUG : s3: detected overridden config - adding \[dq]{Srj1p}\[dq] suffix to name
\f[R]
.fi
.PP
این کار برای این است که rclone بتواند هنگام کش کردن backendها، ریموت تغییریافته را از ریموت دست‌نخورده تمیز دهد.
.PP
این موضوع تنها در لاگ‌ها قابل مشاهده خواهد بود.
.PP
این بدین معناست که backendهای بلادرنگ (on the fly) نظیر:
.IP
.nf
\f[C]
rclone -vv lsf :s3,env_auth:
\f[R]
.fi
.PP
نام‌های منحصر‌به‌فرد خود را دریافت خواهند کرد:
.IP
.nf
\f[C]
DEBUG : :s3: detected overridden config - adding \[dq]{YTu53}\[dq] suffix to name
\f[R]
.fi
.SS "نام‌های معتبر ریموت (Valid remote names)"
.PP
نام‌های ریموت به بزرگی و کوچکی حروف حساس هستند و باید از قوانین زیر پیروی کنند:
.IP \[bu] 2
می‌توانند شامل عدد، حرف، \f[V]_\f[R]، \f[V]-\f[R]، \f[V].\f[R]، \f[V]+\f[R]، \f[V]\[at]\f[R] و فاصله باشند.
.IP \[bu] 2
نباید با \f[V]-\f[R] یا فاصله آغاز شوند.
.IP \[bu] 2
نباید به فاصله ختم شوند.
.PP
از rclone نسخه 1.61 به بعد، هرگونه عدد و حرف یونیکد (Unicode) مجاز است، در حالی که در نسخه‌های قدیمی‌تر به ASCII ساده (0-9، A-Z، a-z) محدود بود.
اگر از یک پیکربندی rclone در پوسته‌های مختلف استفاده می‌کنید، که ممکن است با کدگذاری نویسه (character encoding) متفاوتی تنظیم شده باشند، باید احتیاط کنید و از نویسه‌هایی استفاده نمایید که در همه آن‌ها قابل نوشتن باشند.
این مشکل بیشتر در Windows به وجود می‌آید، جایی که کنسول به‌طور سنتی از مجموعه‌نویسه‌های غیر یونیکد استفاده می‌کند — که توسط اصطلاحاً \[dq]code page\[dq] تعریف می‌شود.
.PP
در Windows از نام‌های تک‌نویسه‌ای استفاده نکنید، زیرا موجب ابهام با نام درایوهای ویندوز می‌شود؛ به‌عنوان مثال: ریموتی با نام \f[V]C\f[R] از درایو \f[V]C\f[R] غیرقابل‌تشخیص است.
rclone همواره فرض می‌کند که نام تک‌حرفی به یک درایو اشاره دارد..SS افزودن پیکربندی سراسری به یک ریموت
.PP
امکان افزودن پیکربندی سراسری به پیکربندی ریموت وجود دارد که درست پیش از ایجاد ریموت اعمال خواهد شد.
.PP
این کار به دو روش قابل انجام است. روش نخست استفاده از \f[V]override.var = value\f[R] در فایل پیکربندی یا رشته اتصال (connection string) برای ایجاد تغییری موقت است، و روش دوم استفاده از \f[V]global.var = value\f[R] در فایل پیکربندی یا رشته اتصال برای اعمال تغییری دائمی است.
.PP
این موضوع در ادامه به‌طور کامل توضیح داده شده است.
.SS override.var
.PP
این ویژگی برای بازنویسی (override) یک متغیر سراسری \f[B]تنها\f[R] در طول مدت زمان ایجاد ریموت به کار می‌رود.
این تنظیم بر دیگر ریموت‌ها، حتی اگر هم‌زمان ایجاد شوند، تأثیری نخواهد گذاشت.
.PP
این قابلیت برای بازنویسی پیکربندی‌های شبکه‌ای که تنها برای آن ریموت خاص نیاز هستند بسیار کاربردی است.
برای نمونه، فرض کنید ریموتی دارید که به دلیل اجرا بر روی زیرساخت آزمایشی بدون گواهی معتبر، به \f[V]--no-check-certificate\f[R] نیاز دارد.
می‌توانید گزینه \f[V]--no-check-certificate\f[R] را به rclone بدهید، اما این کار بر روی \f[B]تمام\f[R] ریموت‌ها تأثیر می‌گذارد.
برای اینکه تأثیر آن تنها محدود به همین ریموت باشد، از یک override استفاده می‌کنید.
می‌توانید این مقدار را در فایل پیکربندی قرار دهید:
.IP
.nf
\f[C]
[remote]
type = XXX
\&...
override.no_check_certificate = true
\f[R]
.fi
.PP
یا آن را در رشته اتصال \f[V]remote,override.no_check_certificate=true:\f[R] (یا صرفاً \f[V]remote,override.no_check_certificate:\f[R]) به کار ببرید.
.PP
توجه داشته باشید که نام گزینه سراسری چگونه \f[V]--\f[R] ابتدایی خود را از دست می‌دهد، \f[V]-\f[R] با \f[V]_\f[R] جایگزین می‌شود و یک پیشوند \f[V]override.\f[R] دریافت می‌کند.
.PP
بازنویسی همه متغیرهای سراسری به این شکل منطقی نیست، زیرا این پیکربندی تنها هنگام ایجاد ریموت اعمال می‌شود.
در اینجا فهرستی غیرجامع از مواردی که ممکن است مفید باشند آورده شده است:
.IP \[bu] 2
\f[V]bind_addr\f[R]
.IP \[bu] 2
\f[V]ca_cert\f[R]
.IP \[bu] 2
\f[V]client_cert\f[R]
.IP \[bu] 2
\f[V]client_key\f[R]
.IP \[bu] 2
\f[V]connect_timeout\f[R]
.IP \[bu] 2
\f[V]disable_http2\f[R]
.IP \[bu] 2
\f[V]disable_http_keep_alives\f[R]
.IP \[bu] 2
\f[V]dump\f[R]
.IP \[bu] 2
\f[V]expect_continue_timeout\f[R]
.IP \[bu] 2
\f[V]headers\f[R]
.IP \[bu] 2
\f[V]http_proxy\f[R]
.IP \[bu] 2
\f[V]low_level_retries\f[R]
.IP \[bu] 2
\f[V]max_connections\f[R]
.IP \[bu] 2
\f[V]no_check_certificate\f[R]
.IP \[bu] 2
\f[V]no_gzip\f[R]
.IP \[bu] 2
\f[V]timeout\f[R]
.IP \[bu] 2
\f[V]traffic_class\f[R]
.IP \[bu] 2
\f[V]use_cookies\f[R]
.IP \[bu] 2
\f[V]use_server_modtime\f[R]
.IP \[bu] 2
\f[V]user_agent\f[R]
.PP
یک \f[V]override.var\f[R] بر تمام روش‌های دیگر پیکربندی اولویت خواهد داشت و آن‌ها را بازنویسی می‌کند، اما \f[B]تنها\f[R] برای مدت زمان ایجاد ریموت..SS global.var
.PP
این برای تنظیم یک متغیر سراسری \f[B]برای همه چیز\f[R] استفاده می‌شود.
متغیر سراسری درست پیش از ایجاد ریموت تنظیم می‌شود.
.PP
این قابلیت برای پارامترهایی (مانند پارامترهای sync) که نمی‌توانند
به عنوان یک \f[V]override\f[R] تنظیم شوند مفید است.
برای نمونه، فرض کنید ریموتی دارید که مایلید همیشه از
پرچم \f[V]--checksum\f[R] برای آن استفاده کنید.
می‌توانید پرچم \f[V]--checksum\f[R] را در هر بار اجرای خط فرمان به rclone
ارائه دهید، اما در عوض می‌توانید این را در فایل پیکربندی قرار دهید:
.IP
.nf
\f[C]
[remote]
type = XXX
\&...
global.checksum = true
\f[R]
.fi
.PP
یا از آن در رشته اتصال
\f[V]remote,global.checksum=true:\f[R] (یا صرفاً
\f[V]remote,global.checksum:\f[R]) استفاده کنید.
این کار معادل استفاده از پرچم \f[V]--checksum\f[R] است.
.PP
دقت کنید که چگونه نام پرچم سراسری \f[V]--\f[R] ابتدایی خود را از دست می‌دهد،
\f[V]-\f[R] در آن با \f[V]_\f[R] جایگزین می‌شود و پیشوند \f[V]global.\f[R]
می‌گیرد.
.PP
هر متغیر سراسری را می‌توان به این صورت تنظیم کرد و این کار دقیقاً معادل
استفاده از پرچم متناظر در خط فرمان است.
این بدان معناست که بر تمام کاربردهای rclone تأثیر خواهد گذاشت.
.PP
اگر دو ریموت یک متغیر سراسری یکسان را تنظیم کنند، متغیری که ابتدا
مقداردهی شده توسط دومی بازنویسی خواهد شد.
هنگام ایجاد ریموت، یک \f[V]global.var\f[R] بر تمامی روش‌های پیکربندی دیگر ارجحیت خواهد داشت.
.SS نقل‌قول و پوسته (Quoting and the shell)
.PP
هنگامی که دستورها را در رایانه خود تایپ می‌کنید، از چیزی به نام
پوسته خط فرمان استفاده می‌کنید.
این پوسته نویسه‌های گوناگون را به شیوه‌ای وابسته به سیستم‌عامل تفسیر می‌کند.
.PP
در اینجا به چند نکته و دام رایج اشاره شده است که ممکن است به کاربرانی که با
قوانین پوسته آشنایی ندارند کمک کند.
.SS Linux / macOS
.PP
اگر نام‌های شما دارای فاصله یا نویسه‌های کنترلی پوسته هستند (مانند
\f[V]*\f[R]، \f[V]?\f[R]، \f[V]$\f[R]، \f[V]\[aq]\f[R]، \f[V]\[dq]\f[R]
و غیره)
باید آن‌ها را داخل علامت نقل‌قول قرار دهید.
به‌طور پیش‌فرض از نقل‌قول تکی \f[V]\[aq]\f[R] استفاده کنید.
.IP
.nf
\f[C]
rclone copy \[aq]Important files?\[aq] remote:backup
\f[R]
.fi
.PP
اگر می‌خواهید یک \f[V]\[aq]\f[R] ارسال کنید، باید از
\f[V]\[dq]\f[R] استفاده نمایید؛ برای نمونه:
.IP
.nf
\f[C]
rclone copy \[dq]O\[aq]Reilly Reviews\[dq] remote:backup
\f[R]
.fi
.PP
قوانین نقل‌قول نویسه‌های کنترلی پیچیده است و در صورتی که
جزئیات کامل را می‌خواهید، باید به صفحه راهنمای پوسته خود مراجعه کنید.
.SS Windows
.PP
اگر نام‌های شما دارای فاصله هستند، باید آن‌ها را در \f[V]\[dq]\f[R] قرار دهید؛
برای نمونه:
.IP
.nf
\f[C]
rclone copy \[dq]E:\[rs]folder name\[rs]folder name\[rs]folder name\[dq] remote:backup
\f[R]
.fi
.PP
اگر از دایرکتوری ریشه به تنهایی استفاده می‌کنید، آن را داخل علامت نقل‌قول قرار ندهید
(برای دانستن علت، به شمارۀ ۴۶۴ در <https://github.com/rclone/rclone/issues/464> مراجعه کنید)؛ برای نمونه:
.IP
.nf
\f[C]
rclone copy E:\[rs] remote:backup
\f[R]
.fi.SS رونوشت از فایل‌ها یا دایرکتوری‌های دارای \f[V]:\f[R] در نام
.PP
ابزار rclone از \f[V]:\f[R] برای مشخص کردن نام ریموت استفاده می‌کند.
با این حال، این نویسه در سیستم‌عامل‌های غیر از ویندوز بخشی معتبر از نام فایل به شمار می‌رود.
تجزیه‌گر نام ریموت تنها تا اولین \f[V]/\f[R] به دنبال \f[V]:\f[R] می‌گردد؛ بنابراین اگر می‌خواهید روی چنین فایل یا دایرکتوری‌ای عملیاتی انجام دهید، از مسیر کامل که با \f[V]/\f[R] آغاز می‌شود استفاده کنید، یا \f[V]./\f[R] را به عنوان پیشوند دایرکتوری جاری به کار ببرید.
.PP
بنابراین برای همگام‌سازی دایرکتوری‌ای با نام \f[V]sync:me\f[R] در ریموتی با نام \f[V]remote:\f[R] از این دستور استفاده کنید:
.IP
.nf
\f[C]
rclone sync --interactive ./sync:me remote:path
\f[R]
.fi
.PP
یا
.IP
.nf
\f[C]
rclone sync --interactive /full/path/to/sync:me remote:path
\f[R]
.fi
.SS رونوشت سمت سرور
.PP
بیشتر ریموت‌ها (اما نه همه \- نمای کلی (https://rclone.org/overview/#optional-features) را ببینید) از رونوشت سمت سرور پشتیبانی می‌کنند.
.PP
این بدان معناست که اگر بخواهید پوشه‌ای را درون پوشه دیگری کپی کنید، rclone تمام فایل‌ها را بارگیری و دوباره بارگذاری نخواهد کرد؛ بلکه به سرور دستور می‌دهد تا آن‌ها را در همان محل کپی کند.
.PP
برای نمونه:
.IP
.nf
\f[C]
rclone copy s3:oldbucket s3:newbucket
\f[R]
.fi
.PP
محتویات \f[V]oldbucket\f[R] را بدون بارگیری و بارگذاری دوباره به \f[V]newbucket\f[R] کپی خواهد کرد.
.PP
ریموت‌هایی که از رونوشت سمت سرور پشتیبانی نمی‌کنند در این حالت عملیات بارگیری و بارگذاری مجدد را انجام \f[B]خواهند داد\f[R].
.PP
رونوشت‌های سمت سرور همراه با دستورهای \f[V]sync\f[R] و \f[V]copy\f[R] استفاده می‌شوند و هنگام استفاده از پرچم \f[V]-v\f[R] در لاگ‌ها مشخص خواهند شد.
دستور \f[V]move\f[R] نیز اگر ریموت مستقیماً از جابه‌جایی سمت سرور پشتیبانی نکند ممکن است از آن‌ها استفاده کند.
این کار از طریق صدور یک رونوشت سمت سرور و سپس حذف فایل اصلی انجام می‌شود که بسیار سریع‌تر از بارگیری و بارگذاری دوباره است.
.PP
رونوشت سمت سرور تنها در صورتی تلاش خواهد شد که نام ریموت‌ها یکسان باشد.
.PP
از این امکان می‌توان هنگام اسکریپت‌نویسی برای ایجاد بهینه نسخه‌های پشتیبان تفکیک‌شده بر اساس زمان استفاده کرد، برای نمونه:
.IP
.nf
\f[C]
rclone sync --interactive remote:current-backup remote:previous-backup
rclone sync --interactive /path/to/files remote:current-backup
\f[R]
.fi
.SS پشتیبانی از فراداده
.PP
فراداده، داده‌ای درباره یک فایل (یا دایرکتوری) است که محتوای آن فایل (یا دایرکتوری) محسوب نمی‌شود.
به طور معمول rclone در صورت امکان تنها زمان تغییر و نوع محتوا (MIME) را حفظ می‌کند.
.PP
ابزار rclone هنگام استفاده از پرچم \f[V]--metadata\f[R] یا \f[V]-M\f[R] از حفظ تمام فراداده‌های موجود روی فایل‌ها و دایرکتوری‌ها پشتیبانی می‌کند.
.PP
اینکه دقیقاً چه فراداده‌هایی پشتیبانی می‌شوند و این پشتیبانی چه مفهومی دارد، به بک‌اند بستگی دارد.
بک‌اندهایی که از فراداده پشتیبانی می‌کنند بخشی اختصاصی برای فراداده در مستندات خود دارند و در جدول قابلیت‌ها (https://rclone.org/overview/#features) فهرست شده‌اند (برای نمونه local (https://rclone.org/local/#metadata)، s3).
.PP
برخی بک‌اندها از فراداده پشتیبانی نمی‌کنند، برخی فقط از فراداده روی فایل‌ها پشتیبانی می‌کنند و برخی دیگر از فراداده روی هر دوی فایل‌ها و دایرکتوری‌ها پشتیبانی می‌نمایند.
.PP
ابزار rclone تنها از همگام‌سازی یک‌بارهٔ فراداده پشتیبانی می‌کند.
بدین معنا که فراداده تنها زمانی از شیء مبدأ به شیء مقصد همگام‌سازی خواهد شد که شیء مبدأ تغییر کرده باشد و نیاز به بارگذاری دوباره داشته باشد.
اگر پس از آن، فراداده روی شیء مبدأ بدون تغییر خود شیء تغییر کند، با شیء مقصد همگام‌سازی نخواهد شد.
این رفتار مشابه روشی است که rclone فیلد \f[V]Content-Type\f[R] را بدون پرچم \f[V]--metadata\f[R] همگام‌سازی می‌کند.
.PP
استفاده از \f[V]--metadata\f[R] هنگام همگام‌سازی از مسیر محلی به محلی، صفات فایل نظیر حالت فایل (file mode)، مالک، و صفات گسترش‌یافته (به جز در ویندوز) را حفظ خواهد کرد.
.PP
توجه داشته باشید که هنگام نخستین بارگذاری شیء، می‌توان فراداده‌های دلخواهی را با استفاده از پرچم \f[V]--metadata-set key=value\f[R] به اشیاء اضافه کرد.
این پرچم می‌تواند به دفعات مورد نیاز تکرار شود.
.PP
از پرچم --metadata-mapper می‌توان برای تعیین نام برنامه‌ای استفاده کرد که قادر است فراداده را هنگام کپی شدن از مبدأ به مقصد دگرگون کند.
.PP
ابزار rclone از \f[V]--metadata-set\f[R] و \f[V]--metadata-mapper\f[R] هنگام انجام \f[V]Move\f[R] سمت سرور و \f[V]Copy\f[R] سمت سرور پشتیبانی می‌کند، اما هنگام انجام \f[V]DirMove\f[R] سمت سرور (تغییر نام دایرکتوری) خیر، چرا که این کار مستلزم پیمایش بازگشتی در دایرکتوری است.
توجه داشته باشید که می‌توانید \f[V]DirMove\f[R] را با پرچم \f[V]--disable DirMove\f[R] غیرفعال کنید؛ در این صورت rclone برای تک‌تک اشیاء به استفاده از \f[V]Move\f[R] برمی‌گردد که در آن \f[V]--metadata-set\f[R] و \f[V]--metadata-mapper\f[R] پشتیبانی می‌شوند..SS انواع فراداده (Types of metadata)
.PP
فراداده به دو نوع تقسیم می‌شود:
فراداده‌های سیستمی و فراداده‌های کاربر.
.PP
به فراداده‌ای که بک‌اند خودش از آن استفاده می‌کند، فرادادهٔ سیستمی گفته می‌شود.
به عنوان مثال در بک‌اند \f[V]local\f[R]، فرادادهٔ سیستمی \f[V]uid\f[R] هنگام استفاده در یک پلتفرم مبتنی بر unix، شناسهٔ کاربر (user ID) فایل را ذخیره می‌کند.
.PP
فراداده‌های دلخواه فرادادهٔ کاربر نامیده می‌شوند و می‌توان آن‌ها را به هر شکل دلخواه تنظیم کرد.
.PP
هنگامی که اشیاء از یک بک‌اند به بک‌اند دیگر کپی می‌شوند، در صورت ارائه شدن فراداده‌های سیستمی، تلاش خواهد شد تا آن‌ها تفسیر شوند.
با کپی شدن اشیاء میان بک‌اندهای مختلف، ممکن است وضعیت فراداده‌ها از فرادادهٔ کاربر به فرادادهٔ سیستمی تغییر یابد.
برای نمونه، کپی کردن یک شیء از s3 فرادادهٔ \f[V]content-type\f[R] را تنظیم می‌کند.
در بک‌اندی که این مقدار را درک می‌کند (مانند \f[V]azureblob\f[R])، این مقدار به Content-Type شیء تبدیل خواهد شد.
در بک‌اندی که این مقدار را درک نمی‌کند (مانند بک‌اند \f[V]local\f[R])، این مقدار به فرادادهٔ کاربر تبدیل خواهد شد.
با این حال، اگر شیء محلی دوباره به s3 کپی شود، Content-Type به‌درستی تنظیم خواهد شد.
.SS ساختار فراداده (Metadata framework)
.PP
دستور Rclone یک چارچوب فراداده را پیاده‌سازی می‌کند که می‌تواند فراداده را از یک شیء خوانده و هنگام بارگذاری (و فقط هنگام بارگذاری) بر روی شیء بنویسد.
.PP
این فراداده به صورت یک دیکشنری با کلیدها و مقدارهای رشته‌ای ذخیره می‌شود.
.PP
محدودیت‌هایی در نام کلیدها وجود دارد (که ممکن است در آینده شفاف‌تر شوند):
.IP \[bu] 2
باید با حروف کوچک باشد
.IP \[bu] 2
می‌تواند شامل \f[V]a-z\f[R] و \f[V]0-9\f[R] همراه با \f[V].\f[R]، \f[V]-\f[R] یا \f[V]_\f[R] باشد
.IP \[bu] 2
طول آن به بک‌اند وابسته است
.PP
هر بک‌اند می‌تواند فراداده‌های سیستمی را که درک می‌کند، ارائه دهد.
برخی از بک‌اندها می‌توانند فراداده‌های دلخواه کاربر را نیز ذخیره کنند.
.PP
در صورت امکان، نام کلیدها استانداردسازی شده‌اند؛ بنابراین، به عنوان مثال این امکان وجود دارد که فرادادهٔ شیء از s3 به azureblob کپی شود و فراداده‌ها به شکلی مناسب ترجمه شوند.
.PP
برخی از بک‌اندها محدودیت‌هایی در اندازهٔ فراداده دارند و در صورت فراتر رفتن از این محدودیت‌ها، rclone در زمان بارگذاری خطا خواهد داد.
.SS حفظ فراداده (Metadata preservation)
.PP
هدف این پیاده‌سازی عبارت است از:
.IP "1." 3
حفظ فراداده تا جای ممکن
.IP "2." 3
تفسیر فراداده تا جای ممکن
.PP
نتیجهٔ مورد ۱ این است که می‌توانید یک شیء S3 را روی دیسک محلی کپی کرده و سپس بدون اتلاف داده به S3 بازگردانید.
به همین ترتیب، می‌توانید یک فایل محلی را همراه با مشخصه‌های فایل و ویژگی‌های گسترش‌یافته (xattrs) از دیسک محلی به s3 و مجدداً بدون از دست رفتن داده‌ها کپی کنید.
.PP
نتیجهٔ مورد ۲ این است که می‌توانید یک شیء S3 را همراه با فراداده به (مثلاً) Azureblob کپی کنید و فراداده روی شیء Azureblob نیز اعمال شود.
.SS فراداده‌های سیستمی استاندارد (Standard system metadata)
.PP
در اینجا جدولی از فراداده‌های سیستمی استاندارد آورده شده است که در صورت امکان، یک بک‌اند ممکن است آن‌ها را پیاده‌سازی کند.
.PP
.TS
tab(@);
lw(34.2n) lw(21.2n) lw(14.7n).
T{
کلید
T}@T{
توضیحات
T}@T{
مثال
T}
_
T{
mode
T}@T{
نوع فایل و حالت (mode): اکتال، سبک unix
T}@T{
0100664
T}
T{
uid
T}@T{
شناسه کاربری مالک: عدد ده‌دهی
T}@T{
500
T}
T{
gid
T}@T{
شناسه گروه مالک: عدد ده‌دهی
T}@T{
500
T}
T{
rdev
T}@T{
شناسه دستگاه (در صورت فایل ویژه) => هگزادسیمال
T}@T{
0
T}
T{
atime
T}@T{
زمان آخرین دسترسی: RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}
T{
mtime
T}@T{
زمان آخرین تغییر: RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}
T{
btime
T}@T{
زمان ایجاد فایل (تولد): RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}
T{
utime
T}@T{
زمان بارگذاری فایل: RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}
T{
cache-control
T}@T{
سربرگ Cache-Control
T}@T{
no-cache
T}
T{
content-disposition
T}@T{
سربرگ Content-Disposition
T}@T{
inline
T}
T{
content-encoding
T}@T{
سربرگ Content-Encoding
T}@T{
gzip
T}
T{
content-language
T}@T{
سربرگ Content-Language
T}@T{
en-US
T}
T{
content-type
T}@T{
سربرگ Content-Type
T}@T{
text/plain
T}
.TE
.PP
در صورت ارائه در فراداده، کلیدهای فرادادهٔ \f[V]mtime\f[R] و \f[V]content-type\f[R] نسبت به خواندن \f[V]Content-Type\f[R] یا زمان آخرین تغییر شیء مبدأ، اولویت خواهند داشت..PP
هش‌ها در فراداده‌های سامانه گنجانده نشده‌اند، زیرا از پیش روشی مشخص برای خواندن آن‌ها وجود دارد.
.SS "گزینه‌ها (OPTIONS)"
.PP
دستور rclone برای کنترل رفتار خود گزینه‌های متعددی دارد.
این موارد در ادامه و همچنین در صفحهٔ پرچم‌ها مستند شده‌اند.
.PP
گزینه‌هایی که پارامتر می‌پذیرند می‌توانند مقادیر را به دو روش دریافت کنند:
\f[V]--option=value\f[R] یا \f[V]--option value\f[R].
با این حال گزینه‌های بولی (true/false) رفتاری کمی متفاوت با سایر گزینه‌ها دارند، بدین صورت که \f[V]--boolean\f[R] گزینه را روی
\f[V]true\f[R] تنظیم می‌کند و عدم وجود این پرچم آن را روی \f[V]false\f[R] قرار می‌دهد.
همچنین می‌توان \f[V]--boolean=false\f[R] یا
\f[V]--boolean=true\f[R] را مشخص کرد.
توجه داشته باشید که \f[V]--boolean false\f[R] معتبر نیست \- این عبارت به صورت
\f[V]--boolean\f[R] پردازش شده و \f[V]false\f[R] به عنوان یک آرگومان خط فرمان اضافی برای rclone تفسیر می‌شود.
.PP
مقادیر رشته‌ای که به عنوان شناسه‌های ویژه شناخته می‌شوند، مانند
نام سطح گزارش برای تنظیم با گزینهٔ \f[V]--log-level\f[R]، به بزرگی و کوچکی حروف حساس نیستند؛ برای نمونه
\f[V]--log-level ERROR\f[R] و \f[V]--log-level error\f[R]
یکسان هستند.
.PP
گزینه‌هایی که بر اساس مستندات پارامتر \f[V]stringArray\f[R] می‌پذیرند، چندین مقدار را قبول می‌کنند.
برای ارسال بیش از یک مقدار، گزینه را تکرار کنید؛ به عنوان مثال:
\f[V]--include value1 --include value2\f[R].
سایر گزینه‌ها ممکن است تنها یک مقدار واحد بپذیرند و فقط باید یک بار مشخص شوند، اما پارامتر مشخص‌شده در آن‌ها ممکن است نشان‌دهندهٔ فهرستی از مقادیر جداشده با فاصله یا کاما باشد.
چنین گزینه‌هایی در مستندات با پارامتر \f[V]CommaSepList\f[R] (در صورت جداسازی با کاما) و \f[V]SpaceSepList\f[R] (در صورت جداسازی با فاصله) مشخص شده‌اند،
اگرچه برخی از آن‌ها ممکن است پارامترهای دیگری مانند
\f[V]DumpFlags\f[R] یا صرفاً \f[V]string\f[R] داشته باشند و متن راهنما توضیح می‌دهد که این مقدار به عنوان یک فهرست تفسیر خواهد شد.
.PP
مقادیر ممیز شناور دارای بخش اعشاری، صرف‌نظر از محلی‌سازی (locale) پیکربندی‌شده در سامانهٔ شما، باید از نقطه (\f[V].\f[R])
به عنوان جداکنندهٔ اعشار (رایج در کشورهای انگلیسی‌زبان) استفاده کنند.
نوع پارامتر \f[V]float\f[R] اعداد ممیز شناور دهدهی و شانزده‌شانزدهی (hexadecimal) را همان‌گونه که در نحو زبان Go برای مقادیر ممیز شناور
(https://go.dev/ref/spec#Floating-point_literals) تعریف شده است، می‌پذیرد.
.SS "گزینه‌های زمان و مدت‌زمان (Time and duration options)"
.PP
گزینه‌هایی که پارامتر \f[V]Time\f[R] یا \f[V]Duration\f[R] دریافت می‌کنند باید به صورت یک رشته با ساختار مشخص که زمان مطلق یا نسبی را شرح می‌دهد، تعیین شوند.
توجه داشته باشید که هر دو نوع پارامتر \f[V]Time\f[R] و \f[V]Duration\f[R] می‌توانند به صورت زمان مطلق یا نسبی بیان شوند، اما با تفسیرهایی متفاوت؛ به عنوان نمونه
هنگامی که یک زمان نسبی به عنوان مقدار \f[V]Time\f[R] فرستاده شود، به عنوان انحراف (offset) از زمان جاری در نظر گرفته خواهد شد.
.PP
یک زمان مطلق می‌تواند به صورت یک رشته در یکی از قالب‌های زیر تعیین شود:
.IP \[bu] 2
RFC3339 \- مانند
\f[V]2006-01-02T15:04:05Z\f[R] یا \f[V]2006-01-02T15:04:05+07:00\f[R]
.IP \[bu] 2
تاریخ و زمان بر اساس ISO8601، منطقهٔ زمانی محلی \- \f[V]2006-01-02T15:04:05\f[R]
.IP \[bu] 2
تاریخ و زمان بر اساس ISO8601، منطقهٔ زمانی محلی \- \f[V]2006-01-02 15:04:05\f[R]
.IP \[bu] 2
تاریخ بر اساس ISO8601 \- \f[V]2006-01-02\f[R] (YYYY-MM-DD)
.PP
زمان نسبی رشته‌ای است شامل دنباله‌ای از اعداد ده‌دهی (احتمالاً دارای علامت مثبت یا منفی)، هر یک با بخش اعشاری اختیاری، و هر یک با یک پسوند یکا.
اگر رشته تنها شامل یک عدد باشد، پسوند یکا اختیاری بوده و پیش‌فرض آن ثانیه خواهد بود؛ بدین معنا که
یک مقدار اعشاری ساده به عنوان تعداد ثانیه‌ها محاسبه می‌شود.
پسوندهای زیر معتبر هستند:
.IP \[bu] 2
\f[V]ms\f[R] \- میلی‌ثانیه
.IP \[bu] 2
\f[V]s\f[R] \- ثانیه
.IP \[bu] 2
\f[V]m\f[R] \- دقیقه
.IP \[bu] 2
\f[V]h\f[R] \- ساعت
.IP \[bu] 2
\f[V]d\f[R] \- روز
.IP \[bu] 2
\f[V]w\f[R] \- هفته
.IP \[bu] 2
\f[V]M\f[R] \- ماه
.IP \[bu] 2
\f[V]y\f[R] \- سال
.PP
مثال‌ها: \[dq]10\[dq]، \[dq]300ms\[dq]، \[dq]-1.5h\[dq] یا
\[dq]2h45m\[dq]..SS گزینه‌های اندازه
.PP
گزینه‌هایی که پارامتر SizeSuffix دریافت می‌کنند، می‌توانند به عنوان یک مقدار
عدد صحیح مشخص شوند، که در این حالت به‌طور پیش‌فرض نمایانگر مقداری بر حسب
KiB (مضرب‌هایی از ۱۰۲۴ بایت) در نظر گرفته خواهد شد.
این تفسیر را می‌توان با افزودن یک پسوند تغییر داد: \f[V]B\f[R] برای Byte،
\f[V]K\f[R] برای KiB، \f[V]M\f[R] برای MiB، \f[V]G\f[R] برای GiB،
\f[V]T\f[R] برای TiB و \f[V]P\f[R] برای PiB.
این‌ها واحدهای دودویی هستند، برای نمونه به ترتیب:
1، 2**10، 2**20، 2**30.
.PP
همچنین به \f[V]--human-readable\f[R] مراجعه کنید.
.SS گزینه‌های اصلی
.SS --backup-dir string
.PP
هنگام استفاده از sync (https://rclone.org/commands/rclone_sync)،
copy (https://rclone.org/commands/rclone_copy) یا
move (https://rclone.org/commands/rclone_move)، تمام فایل‌هایی که
قرار بوده بازنویسی یا حذف شوند، با همان ساختار سلسله‌مراتبی اصلی خود
به این دایرکتوری منتقل می‌شوند.
.PP
اگر \f[V]--suffix\f[R] تنظیم شده باشد، پسوند مربوطه به فایل‌های منتقل‌شده
اضافه خواهد شد.
اگر فایلی با همان مسیر (پس از اضافه شدن پسوند) در دایرکتوری موجود باشد،
رونویسی خواهد شد.
.PP
ریموت مورد استفاده باید از انتقال یا کپی سمت سرور (server-side move or copy)
پشتیبانی کند و باید از همان ریموت به عنوان مقصد همگام‌سازی (sync) استفاده کنید.
دایرکتوری پشتیبان نباید با دایرکتوری مقصد هم‌پوشانی داشته باشد، مگر آنکه
توسط یک قاعدهٔ فیلتر مستثنی شده باشد.
.PP
برای مثال
.IP
.nf
\f[C]
rclone sync --interactive /path/to/local remote:current --backup-dir remote:old
\f[R]
.fi
.PP
مسیر \f[V]/path/to/local\f[R] را با \f[V]remote:current\f[R] همگام‌سازی
می‌کند، اما هر فایلی را که قرار بوده به‌روزرسانی یا حذف شود در
\f[V]remote:old\f[R] ذخیره خواهد کرد.
.PP
اگر rclone را از طریق یک اسکریپت اجرا می‌کنید، شاید مایل باشید از تاریخ امروز
به عنوان نام دایرکتوری ارائه‌شده به \f[V]--backup-dir\f[R] برای ذخیرهٔ فایل‌های
قدیمی استفاده کنید، یا اینکه \f[V]--suffix\f[R] را همراه با تاریخ امروز ارسال
نمایید.
این کار را می‌توان با \f[V]--suffix $(date +%F)\f[R] در bash، و
\f[V]--suffix $(Get-Date -Format \[aq]yyyy-MM-dd\[aq])\f[R] در PowerShell
انجام داد.
.PP
به \f[V]--compare-dest\f[R] و \f[V]--copy-dest\f[R] مراجعه کنید.
.SS --bind string
.PP
نشانی محلی برای مقید شدن (bind) جهت برقراری اتصالات خروجی.
این نشانی می‌تواند یک آدرس IPv4 (مانند 1.2.3.4)، یک آدرس IPv6 (مانند 1234::789A)
یا یک نام میزبان باشد.
اگر نام میزبان تفکیک نشود یا به بیش از یک نشانی IP تفکیک گردد، خطایی رخ خواهد داد.
.PP
می‌توانید از \f[V]--bind 0.0.0.0\f[R] برای اجبار rclone به استفاده از
نشانی‌های IPv4، و از \f[V]--bind ::0\f[R] برای اجبار rclone به استفاده از
نشانی‌های IPv6 استفاده نمایید.
.SS --bwlimit BwTimetable
.PP
این گزینه محدودیت پهنای باند را کنترل می‌کند.
برای مثال
.IP
.nf
\f[C]
--bwlimit 10M
\f[R]
.fi
.PP
به معنای محدود کردن پهنای باند بارگذاری و بارگیری به 10 MiB/s خواهد بود.
\f[B]توجه:\f[R] این مقدار بر حسب \f[B]بایت\f[R] بر ثانیه است، نه \f[B]بیت\f[R]
بر ثانیه.
برای استفاده از یک حد منفرد، پهنای باند مورد نظر را بر حسب KiB/s مشخص کنید،
یا از یکی از پسوندهای B|K|M|G|T|P استفاده نمایید.
مقدار پیش‌فرض \f[V]0\f[R] است که به معنای عدم محدودسازی پهنای باند می‌باشد.
.PP
پهنای باند بارگذاری و بارگیری را می‌توان به‌طور جداگانه به صورت
\f[V]--bwlimit UP:DOWN\f[R] مشخص کرد، بنابراین
.IP
.nf
\f[C]
--bwlimit 10M:100k
\f[R]
.fi
.PP
به معنای محدود کردن پهنای باند بارگذاری به 10 MiB/s و پهنای باند بارگیری
به 100 KiB/s خواهد بود.
هر یک از این دو حد می‌تواند \[dq]off\[dq] باشد که به معنای عدم وجود محدودیت است؛
بنابراین تنها برای محدود کردن پهنای باند بارگذاری می‌توانید از دستور زیر استفاده کنید:
.IP
.nf
\f[C]
--bwlimit 10M:off
\f[R]
.fi
.PP
این دستور پهنای باند بارگذاری را به 10 MiB/s محدود می‌کند، اما پهنای باند بارگیری
بدون محدودیت خواهد بود.
.PP
در صورت تعیین به شیوهٔ بالا، محدودیت‌های پهنای باند برای تمام مدت زمان اجرای
برنامهٔ rclone باقی خواهند ماند.
.PP
همچنین امکان تعیین یک «جدول زمانی» (\[dq]timetable\[dq]) از محدودیت‌ها وجود دارد،
که باعث می‌شود محدودیت‌های خاصی در زمان‌های معینی اعمال شوند.
برای تعیین جدول زمانی، ورودی‌های خود را به صورت
\f[V]WEEKDAY-HH:MM,BANDWIDTH WEEKDAY-HH:MM,BANDWIDTH...\f[R] قالب‌بندی کنید که در آن:
مؤلفهٔ \f[V]WEEKDAY\f[R] اختیاری است.
.IP \[bu] 2
مؤلفهٔ \f[V]BANDWIDTH\f[R] می‌تواند یک عدد منفرد باشد، مانند \f[V]100k\f[R]،
یا یک جفت عدد برای بارگذاری:بارگیری، مانند \f[V]10M:1M\f[R].
.IP \[bu] 2
مؤلفهٔ \f[V]WEEKDAY\f[R] می‌تواند به صورت کلمهٔ کامل یا تنها با ۳ نویسهٔ نخست
نوشته شود.
این مؤلفه اختیاری است.
.IP \[bu] 2
مؤلفهٔ \f[V]HH:MM\f[R] ساعتی بین 00:00 تا 23:59 است.
.PP
ورودی‌ها را می‌توان با فاصله یا نقطه ویرگول (semicolon) از یکدیگر جدا کرد.
.PP
\f[B]نکته:\f[R] می‌توان از نقطه ویرگول به جای فاصله به عنوان جداکننده استفاده کرد
تا از بروز مشکلات تجزیه (parsing) در محیط‌هایی مانند Docker جلوگیری شود.
.PP
یک نمونه از جدول زمانی معمول برای جلوگیری از اشباع خط ارتباطی در ساعات کاری روز:
.PP
با استفاده از فاصله به عنوان جداکننده:
\f[V]--bwlimit \[dq]08:00,512k 12:00,10M 13:00,512k 18:00,30M 23:00,off\[dq]\f[R]
.PP
با استفاده از نقطه ویرگول به عنوان جداکننده:
\f[V]--bwlimit \[dq]08:00,512k;12:00,10M;13:00,512k;18:00,30M;23:00,off\[dq]\f[R]
.PP
در این مثال‌ها، پهنای باند انتقال در ساعت ۸ صبح هر روز روی 512 KiB/s تنظیم می‌شود.
در ظهر، به 10 MiB/s افزایش یافته و در ساعت ۱۳ (۱ بعد از ظهر) مجدداً به 512 KiB/s بازمی‌گردد.
در ساعت ۱۸ (۶ عصر)، محدودیت پهنای باند روی 30 MiB/s تنظیم خواهد شد، و در ساعت ۲۳ (۱۱ شب)
به‌طور کامل غیرفعال می‌شود (سرعت کامل).
هر زمانی بین ساعت ۱۱ شب تا ۸ صبح بدون محدودیت باقی خواهد ماند.
.PP
یک نمونه جدول زمانی همراه با \f[V]WEEKDAY\f[R] می‌تواند چنین باشد:
.PP
با استفاده از فاصله به عنوان جداکننده:
\f[V]--bwlimit \[dq]Mon-00:00,512 Fri-23:59,10M Sat-10:00,1M Sun-20:00,off\[dq]\f[R]
.PP
با استفاده از نقطه ویرگول به عنوان جداکننده:
\f[V]--bwlimit \[dq]Mon-00:00,512;Fri-23:59,10M;Sat-10:00,1M;Sun-20:00,off\[dq]\f[R]
.PP
این بدان معناست که پهنای باند انتقال در روز دوشنبه روی 512 KiB/s تنظیم خواهد شد.
پیش از پایان روز جمعه به 10 MiB/s افزایش می‌یابد.
در ساعت 10:00 روز شنبه روی 1 MiB/s تنظیم خواهد شد.
از ساعت 20:00 روز یکشنبه، نامحدود خواهد شد.
.PP
بازه زمانی‌های بدون \f[V]WEEKDAY\f[R] به کل روزهای هفته تعمیم داده می‌شوند.
بنابراین این مثال:
.IP
.nf
\f[C]
--bwlimit \[dq]Mon-00:00,512 12:00,1M Sun-20:00,off\[dq]
\f[R]
.fi
.PP
معادل این حالت است:
.IP
.nf
\f[C]
--bwlimit \[dq]Mon-00:00,512Mon-12:00,1M Tue-12:00,1M Wed-12:00,1M Thu-12:00,1M Fri-12:00,1M Sat-12:00,1M Sun-12:00,1M Sun-20:00,off\[dq]
\f[R]
.fi
.PP
محدودیت پهنای باند برای انتقال داده در تمامی پس‌انه‌ها اعمال می‌شود.
برای اکثر پس‌انه‌ها، پهنای باند فهرست‌کردن دایرکتوری (directory listing) نیز لحاظ می‌گردد
(استثناهای آن پس‌انه‌های غیر HTTP شامل \f[V]ftp\f[R]، \f[V]sftp\f[R] و \f[V]storj\f[R] هستند).
.PP
توجه داشته باشید که واحدها \f[B]Byte/s\f[R] هستند، نه \f[B]bit/s\f[R].
معمولاً اتصالات با bit/s سنجیده می‌شوند - برای تبدیل، آن را بر ۸ تقسیم کنید.
برای مثال، فرض کنید یک اتصال 10 Mbit/s دارید و می‌خواهید rclone از نیمی از آن یعنی 5 Mbit/s استفاده کند.
این مقدار برابر با 5/8 = 0.625 MiB/s است، بنابراین باید از پارامتر \f[V]--bwlimit 0.625M\f[R] برای rclone استفاده کنید..PP
در سیستم‌های Unix (شامل Linux، macOS، \&...)
محدودکنندهٔ پهنای باند را می‌توان با ارسال سیگنال \f[V]SIGUSR2\f[R]
به rclone تغییر وضعیت داد.
این امر امکان حذف محدودیت‌های یک انتقال طولانی‌مدت rclone
و بازگرداندن سریع آن به مقدار مشخص‌شده با \f[V]--bwlimit\f[R]
را در هنگام نیاز فراهم می‌کند.
با فرض اینکه تنها یک نمونه از rclone در حال اجرا است، می‌توانید
محدودکننده را به این صورت تغییر وضعیت دهید:
.IP
.nf
\f[C]
kill -SIGUSR2 $(pidof rclone)
\f[R]
.fi
.PP
اگر rclone را با قابلیت کنترل از راه دور پیکربندی کنید، می‌توانید
مقدار bwlimit را به‌صورت پویا تغییر دهید:
.IP
.nf
\f[C]
rclone rc core/bwlimit rate=1M
\f[R]
.fi
.SS --bwlimit-file BwTimetable
.PP
این گزینه محدودیت پهنای باند را به ازای هر فایل کنترل می‌کند.
برای مشاهدهٔ گزینه‌ها به پرچم \f[V]--bwlimit\f[R] مراجعه کنید.
.PP
به‌عنوان مثال، برای اینکه هیچ انتقالی سرعتی بیشتر از 1 MiB/s نداشته باشد از این الگو استفاده کنید:
.IP
.nf
\f[C]
--bwlimit-file 1M
\f[R]
.fi
.PP
این گزینه می‌تواند همراه با \f[V]--bwlimit\f[R] استفاده شود.
.PP
توجه داشته باشید که در صورت ارائهٔ جدول زمان‌بندی، انتقال فایل از زمان‌بندیِ
معتبر در هنگام شروع انتقال استفاده خواهد کرد.
.SS --buffer-size SizeSuffix
.PP
از بافری با این اندازه برای سرعت بخشیدن به انتقال فایل‌ها استفاده کنید.
هر \f[V]--transfer\f[R] این میزان حافظه را برای بافرسازی استفاده خواهد کرد.
.PP
هنگام استفاده از \f[V]mount\f[R] یا \f[V]cmount\f[R]، هر توصیف‌گر فایل باز
این میزان حافظه را برای بافرسازی مصرف می‌کند.
برای جزئیات بیشتر به مستندات
mount (https://rclone.org/commands/rclone_mount/#vfs-file-buffering)
مراجعه کنید.
.PP
برای غیرفعال کردن بافرسازی به منظور دستیابی به حداقل مصرف حافظه، آن را روی \f[V]0\f[R]
تنظیم کنید.
.PP
توجه داشته باشید که تخصیص حافظهٔ بافرها تحت تأثیر پرچم
--use-mmap قرار دارد.
.SS --cache-dir string
.PP
مشخص کردن دایرکتوری مورد استفادهٔ rclone برای کَش، جهت نادیده گرفتن مقدار
پیش‌فرض.
.PP
مقدار پیش‌فرض به سیستم‌عامل بستگی دارد:
.IP \[bu] 2
در Windows مسیر \f[V]%LocalAppData%\[rs]rclone\f[R]، در صورتی که \f[V]LocalAppData\f[R]
تعریف شده باشد.
.IP \[bu] 2
در macOS مسیر \f[V]$HOME/Library/Caches/rclone\f[R] در صورتی که \f[V]HOME\f[R]
تعریف شده باشد.
.IP \[bu] 2
در Unix مسیر \f[V]$XDG_CACHE_HOME/rclone\f[R] در صورتی که \f[V]XDG_CACHE_HOME\f[R]
تعریف شده باشد، در غیر این صورت \f[V]$HOME/.cache/rclone\f[R] در صورتی که \f[V]HOME\f[R]
تعریف شده باشد.
.IP \[bu] 2
حالت جایگزین نهایی (در تمام سیستم‌عامل‌ها) به \f[V]$TMPDIR/rclone\f[R]، که در آن \f[V]TMPDIR\f[R]
مقدار حاصل از --temp-dir است.
.PP
می‌توانید از دستور config
paths (https://rclone.org/commands/rclone_config_paths) برای مشاهدهٔ
مقدار کنونی استفاده کنید.
.PP
دایرکتوری کَش کاربرد فراوانی در قابلیت متصل‌سازی VFS File
Caching (https://rclone.org/commands/rclone_mount/#vfs-file-caching)
دارد، و همچنین توسط
serve (https://rclone.org/commands/rclone_serve)، رابط گرافیکی (GUI) و سایر بخش‌های
rclone نیز استفاده می‌شود..SS --check-first
.PP
اگر این پرچم تنظیم شود، در عملیات‌های
sync (https://rclone.org/commands/rclone_sync)،
copy (https://rclone.org/commands/rclone_copy) یا
move (https://rclone.org/commands/rclone_move)، rclone پیش از انجام هرگونه انتقال، تمام بررسی‌ها را برای تشخیص نیاز به انتقال فایل‌ها انجام می‌دهد.
در حالت عادی، rclone انتقال‌ها را در سریع‌ترین زمان ممکن آغاز می‌کند.
.PP
این پرچم می‌تواند در سامانه‌های دارای محدودیت ورودی/خروجی (IO) که در آن‌ها فرایند انتقال با فرایند بررسی تداخل پیدا می‌کند، مفید باشد.
.PP
همچنین برای تضمین ترتیب دقیق هنگام استفاده از \f[V]--order-by\f[R] کاربرد دارد.
.PP
اگر هنگام اجرای \f[V]rclone move\f[R] هر دو پرچم \f[V]--check-first\f[R] و \f[V]--order-by\f[R] تنظیم شده باشند، rclone از رشته انتقال برای حذف فایل‌های مبدأیی که نیازی به انتقال ندارند استفاده خواهد کرد.
این کار موجب ترتیب دقیق انتقال‌ها و حذف‌ها می‌شود، اما باعث خواهد شد که آمار انتقال شامل موارد بیشتری نسبت به حد انتظار باشد.
.PP
استفاده از این پرچم می‌تواند حافظه بیشتری مصرف کند، زیرا عملاً \f[V]--max-backlog\f[R] را روی نامحدود تنظیم می‌کند.
این بدان معناست که تمام اطلاعات اشیاء مورد نیاز برای انتقال، پیش از شروع انتقال‌ها در حافظه نگهداری می‌شوند.
.SS --checkers int
.PP
در ابتدا فقط تعداد بررسی‌کننده‌های فایل که به‌طور موازی اجرا می‌شدند را کنترل می‌کرد، به عنوان مثال در \f[V]rclone copy\f[R].
اکنون یک کنترل هم‌زمانی نسبتاً عمومی است که توسط \f[V]rclone\f[R] در چندین بخش استفاده می‌شود.
.PP
نکته: بررسی‌کننده‌ها برابری فایل‌ها را در طول همگام‌سازی بررسی می‌کنند.
برای برخی از سیستم‌های ذخیره‌سازی (مانند S3،‏ Swift،‏ Dropbox) این کار می‌تواند زمان قابل توجهی ببرد، به همین دلیل به صورت موازی اجرا می‌شوند.
.PP
حالت پیش‌فرض، اجرای موازی ۸ بررسی‌کننده است.
با این حال، در مورد backendهایی با پاسخ‌دهی کند ممکن است لازم باشد با تنظیم \f[V]--checkers\f[R] روی ۴ رشته یا کمتر، این پیش‌فرض را کاهش دهید (به جای افزایش آن).
این موضوع به‌ویژه در صورتی توصیه می‌شود که در مرحله بررسی فایل‌ها با کرش کردن سرور backend مواجه می‌شوید (مثلاً در پشتیبان‌گیری‌های بعدی یا تکمیلی که کپی فایل کمتری انجام می‌شود یا اصلاً انجام نمی‌شود و بررسی فایل‌ها بیشترین زمان را می‌گیرد).
این تنظیم را تنها با احتیاط کامل، هم‌زمان با پایش سلامت سرور و توان عملیاتی بررسی فایل‌ها افزایش دهید.
.SS -c, --checksum
.PP
در حالت عادی، rclone زمان تغییر (modification time) و اندازه فایل‌ها را برای یکسان بودن بررسی می‌کند.
اگر این پرچم را تنظیم کنید، rclone هش و اندازه فایل را برای تعیین برابری فایل‌ها بررسی خواهد کرد.
.PP
این گزینه زمانی مفید است که remote از تنظیم زمان تغییر پشتیبانی نمی‌کند و همگام‌سازی دقیق‌تری نسبت به صرفاً بررسی اندازه فایل مد نظر است.
.PP
این پرچم هنگام انتقال بین remoteهایی که نوع هش یکسانی را روی شیء ذخیره می‌کنند بسیار سودمند است؛ مانند Drive و Swift.
برای جزئیات درباره اینکه کدام remoteها از کدام نوع هش پشتیبانی می‌کنند، جدول موجود در بخش نمای کلی (https://rclone.org/overview) را ببینید.
.PP
به‌عنوان مثال، دستور \f[V]rclone --checksum sync s3:/bucket swift:/bucket\f[R] بسیار سریع‌تر از حالت بدون پرچم \f[V]--checksum\f[R] اجرا خواهد شد.
.PP
هنگام استفاده از این پرچم، rclone برخلاف حالت معمول، اگر mtime فایل‌های remote نادرست باشد آن‌ها را به‌روزرسانی نخواهد کرد.
.SS --color AUTO|NEVER|ALWAYS
.PP
مشخص می‌کند که چه زمانی رنگ‌ها (و سایر کدهای ANSI) باید به خروجی اضافه شوند.
.PP
مقدار \f[V]AUTO\f[R] تنها زمانی اجازه استفاده از کدهای ANSI را می‌دهد که خروجی یک ترمینال باشد.
این مقدار پیش‌فرض است.
.PP
مقدار \f[V]NEVER\f[R] هرگز اجازه استفاده از کدهای ANSI را نمی‌دهد.
.PP
مقدار \f[V]ALWAYS\f[R] صرف‌نظر از قالب خروجی (ترمینال یا فایل)، همیشه کدهای ANSI را اضافه می‌کند..SS --compare-dest stringArray
.PP
هنگام استفاده از sync (https://rclone.org/commands/rclone_sync)،
copy (https://rclone.org/commands/rclone_copy) یا
move (https://rclone.org/commands/rclone_move)، مسیرهای مشخص‌شده علاوه بر مقصد برای فایل‌ها بررسی می‌شوند.
اگر فایلی یکسان با مبدأ پیدا شود، آن فایل از مبدأ کپی \f[B]نمی‌شود\f[R].
این ویژگی برای کپی کردن تنها فایل‌هایی که از آخرین پشتیبان‌گیری تغییر کرده‌اند مفید است.
.PP
باید از همان ریموتی که برای مقصد sync استفاده شده، استفاده کنید.
دایرکتوری مقایسه نباید با دایرکتوری مقصد همپوشانی داشته باشد.
.PP
به \f[V]--copy-dest\f[R] و \f[V]--backup-dir\f[R] مراجعه کنید.
.SS --config string
.PP
مکان فایل پیکربندی rclone را مشخص می‌کند تا جایگزین مقدار پیش‌فرض شود.
برای مثال:
\f[V]rclone config --config=\[dq]rclone.conf\[dq]\f[R].
.PP
به دلیل تغییراتی که در نسخه‌های مختلف rclone با حفظ سازگاری عقبرو اعمال شده است، توضیح دقیق مقدار پیش‌فرض کمی پیچیده است، اما در بیشتر موارد به سادگی زیر است:
.IP \[bu] 2
\f[V]%APPDATA%/rclone/rclone.conf\f[R] در Windows
.IP \[bu] 2
\f[V]\[ti]/.config/rclone/rclone.conf\f[R] در سایر سیستم‌ها
.PP
منطق کامل به این صورت است: Rclone برای یافتن یک فایل پیکربندی موجود، مکان‌های زیر را به ترتیب اولویت بررسی خواهد کرد:
.IP "1." 3
\f[V]rclone.conf\f[R] (در دایرکتوری برنامه، جایی که فایل اجرایی rclone قرار دارد)
.IP "2." 3
\f[V]%APPDATA%/rclone/rclone.conf\f[R] (تنها در Windows)
.IP "3." 3
\f[V]$XDG_CONFIG_HOME/rclone/rclone.conf\f[R] (در تمام سیستم‌ها، از جمله Windows)
.IP "4." 3
\f[V]\[ti]/.config/rclone/rclone.conf\f[R] (برای توضیح نماد \[ti] به ادامه مراجعه کنید)
.IP "5." 3
\f[V]\[ti]/.rclone.conf\f[R]
.PP
اگر هیچ فایل پیکربندیِ موجودی یافت نشود، فایل جدیدی در مکان زیر ایجاد خواهد شد:
.IP \[bu] 2
در Windows: مکان ۲ که در بالا فهرست شد، مگر در حالت نامحتمل که \f[V]APPDATA\f[R] تعریف نشده باشد، که در این صورت مکان ۴ به جای آن استفاده می‌شود.
.IP \[bu] 2
در Unix: مکان ۳ اگر \f[V]XDG_CONFIG_HOME\f[R] تعریف شده باشد، در غیر این صورت مکان ۴.
.IP \[bu] 2
در صورت عدم امکان ایجاد دایرکتوری rclone، بازگشت به مکان ۵ (در تمام سیستم‌عامل‌ها)، اما اگر دایرکتوری خانگی (home) نیز پیدا نشد، به عنوان آخرین چاره مسیر \f[V].rclone.conf\f[R] نسبت به دایرکتوری کاری فعلی استفاده خواهد شد.
.PP
نماد \f[V]\[ti]\f[R] در مسیرهای بالا نمایانگر دایرکتوری خانگی کاربر فعلی در هر سیستم‌عاملی است و مقدار آن به شرح زیر تعریف می‌شود:
.IP \[bu] 2
در Windows: در صورت تعریف، \f[V]%HOME%\f[R]، در غیر این صورت \f[V]%USERPROFILE%\f[R]، یا در غیر این صورت \f[V]%HOMEDRIVE%\[rs]%HOMEPATH%\f[R].
.IP \[bu] 2
در Unix: در صورت تعریف، \f[V]$HOME\f[R]، در غیر این صورت با جستجوی کاربر فعلی در پایگاه داده کاربران مخصوص سیستم‌عامل (مانند فایل passwd)، یا استفاده از نتیجه دستور شل \f[V]cd && pwd\f[R].
.PP
اگر \f[V]rclone config file\f[R] را اجرا کنید، مکان پیش‌فرض برای خودتان را خواهید دید.
اجرای \f[V]rclone config touch\f[R] از وجود فایل پیکربندی اطمینان حاصل می‌کند و در صورت عدم وجود، یک فایل خالی در مکان پیش‌فرض می‌سازد.
.PP
این واقعیت که وجود فایل \f[V]rclone.conf\f[R] در همان دایرکتوریِ فایل اجرایی rclone همواره ترجیح داده می‌شود، به این معنی است که اجرای آن در حالت \[dq]قابل حمل (portable)\[dq] با دانلود فایل اجرایی rclone در یک دایرکتوری قابل نوشتن و سپس ایجاد یک فایل خالی \f[V]rclone.conf\f[R] در همان دایرکتوری بسیار آسان است.
.PP
اگر مکان روی رشته خالی \f[V]\[dq]\[dq]\f[R] یا مسیر فایلی با نام \f[V]notfound\f[R] یا دستگاه تهی سیستم‌عامل با مقدار \f[V]NUL\f[R] در Windows و \f[V]/dev/null\f[R] در سیستم‌های Unix تنظیم شود، آنگاه rclone فایل پیکربندی را تنها در حافظه نگه می‌دارد.
.PP
اگر هیچ فایل پیکربندی وجود نداشته باشد، ممکن است پیام ثبت وقایع \[dq]Config file not found - using defaults\[dq] را مشاهده کنید.
این پیام را می‌توان نادیده گرفت، به عنوان مثال اگر به طور کامل از rclone با ریموت‌های آنی (https://rclone.org/docs/#backend-path-to-dir) استفاده می‌کنید، می‌توانید با استفاده از فایل پیکربندی فقط در حافظه یا با ایجاد یک فایل پیکربندی خالی، همان‌طور که در بالا توضیح داده شد، این پیام را متوقف کنید.
.PP
فرمت فایل از نوع سادهٔ INI (https://en.wikipedia.org/wiki/INI_file#Format) است: بخش‌هایی متنی که با یک سرآیند \f[V][section]\f[R] آغاز شده و به دنبال آن مدخل‌های \f[V]key=value\f[R] در خطوط جداگانه می‌آیند.
در rclone، هر ریموت توسط بخش مخصوص به خود مشخص می‌شود که در آن نام بخش، نام ریموت را تعیین می‌کند.
گزینه‌ها به صورت مدخل‌های \f[V]key=value\f[R] مشخص می‌شوند، که در آن کلید، نام گزینه بدون پیشوند \f[V]--backend-\f[R]، با حروف کوچک و با استفاده از \f[V]_\f[R] به جای \f[V]-\f[R] است.
برای مثال، گزینه \f[V]--mega-hard-delete\f[R] با کلید \f[V]hard_delete\f[R] مطابقت دارد.
تنها گزینه‌های پس‌بند (backend) را می‌توان مشخص کرد.
یک کلید ویژه و اجباری \f[V]type\f[R] سامانه ذخیره‌سازی (https://rclone.org/overview) را مشخص می‌کند که مقدار آن همان نام داخلی با حروف کوچک است که توسط دستور \f[V]rclone help backends\f[R] بازگردانده می‌شود.
توضیحات با \f[V];\f[R] یا \f[V]#\f[R] در ابتدای یک خط مشخص می‌شوند.
.PP
مثال:
.IP
.nf
\f[C]
[megaremote]
type = mega
user = you\[at]example.com
pass = PDPcQVVjVtzFY-GTdDFozqBhTdsPg3qH
\f[R]
.fi
.PP
توجه داشته باشید که گذرواژه‌ها به شکل مبهم‌شده (https://rclone.org/commands/rclone_obscure) هستند.
همچنین، بسیاری از سامانه‌های ذخیره‌سازی به جای گذرواژه از احراز هویت مبتنی بر توکن استفاده می‌کنند که این امر نیازمند مراحل اضافی است.
استفاده از دستور تعاملی \f[V]rclone config\f[R] به جای ویرایش دستی فایل پیکربندی آسان‌تر و امن‌تر است.
.PP
فایل پیکربندی معمولاً حاوی اطلاعات ورود است و بنابراین باید دسترسی‌های محدودی داشته باشد تا تنها کاربر فعلی بتواند آن را بخواند.
Rclone هنگام نوشتن فایل تلاش می‌کند این موضوع را تضمین کند.
همچنین می‌توانید فایل را رمزگذاری کنید.
.PP
هنگامی که احراز هویت مبتنی بر توکن استفاده می‌شود، فایل پیکربندی باید قابل نوشتن باشد، زیرا rclone نیاز دارد توکن‌های داخل آن را به‌روزرسانی کند.
.PP
برای کاهش خطر خراب شدن یک فایل پیکربندی موجود، rclone هنگام ذخیره تغییرات مستقیماً روی آن نمی‌نویسد.
در عوض، ابتدا در یک فایل جدید و موقت می‌نویسد.
اگر از قبل فایل پیکربندی وجود داشته باشد، (در سیستم‌های Unix) سعی می‌کند مجوزهای آن را در فایل جدید منعکس کند.
سپس نام فایل موجود را به عنوان نسخه پشتیبان به یک نام موقت تغییر می‌دهد.
در مرحله بعد، rclone نام فایل جدید را به نام صحیح تغییر می‌دهد و در نهایت با حذف فایل پشتیبان پاک‌سازی را انجام می‌دهد.
.PP
اگر مسیر فایل پیکربندی که توسط rclone استفاده می‌شود یک پیوند نمادین باشد، این مسیر ارزیابی شده و rclone به جای بازنویسی پیوند نمادین، در مسیر حل‌شده می‌نویسد.
فایل‌های موقت استفاده‌شده در این فرآیند (که در بالا توضیح داده شد) در همان دایرکتوری والدِ فایل پیکربندیِ حل‌شده نوشته خواهند شد، اما اگر این دایرکتوری نیز یک پیوند نمادین باشد، ارزیابی نخواهد شد و فایل‌های موقت در مکان پیوند نمادینِ دایرکتوری نوشته می‌شوند..SS --contimeout Duration
.PP
تنظیم مهلت زمانی برقراری اتصال.
این مقدار باید در قالب زمانی go باشد؛ مانند \f[V]5s\f[R] برای ۵ ثانیه، \f[V]10m\f[R] برای ۱۰ دقیقه، یا \f[V]3h30m\f[R].
.PP
مهلت زمانی اتصال، مدت زمانی است که rclone برای برقراری ارتباط با یک سیستم ذخیره‌سازی شیء راه دور منتظر خواهد ماند.
مقدار پیش‌فرض آن \f[V]1m\f[R] است.
.SS --copy-dest stringArray
.PP
هنگام استفاده از sync (https://rclone.org/commands/rclone_sync)،
copy (https://rclone.org/commands/rclone_copy) یا
move (https://rclone.org/commands/rclone_move)، علاوه بر مقصد، مسیرهای مشخص‌شده نیز برای فایل‌ها بررسی می‌شوند.
این بخش مشابه \f[V]--compare-dest\f[R] عمل می‌کند، با این تفاوت که در \f[V]--copy-dest\f[R]، اگر فایلی همسان با مبدأ یافت شود، آن فایل به‌صورت سمت سرور (server-side) از مسیرهای مشخص‌شده به مقصد کپی می‌شود.
این سازوکار برای پشتیبان‌گیری افزایشی (incremental backup) بسیار مفید است.
.PP
ریموت مورد استفاده باید از کپی سمت سرور پشتیبانی کند و باید از همان ریموت به عنوان مقصد همگام‌سازی استفاده کنید.
دایرکتوری مقایسه نباید با دایرکتوری مقصد هم‌پوشانی داشته باشد.
.PP
همچنین \f[V]--compare-dest\f[R] و \f[V]--backup-dir\f[R] را ببینید.
.SS --dedupe-mode interactive|skip|first|newest|oldest|largest|smallest|rename|list
.PP
حالت اجرای دستور dedupe.
یکی از مقادیر \f[V]interactive\f[R]، \f[V]skip\f[R]، \f[V]first\f[R]،
\f[V]newest\f[R]، \f[V]oldest\f[R]، \f[V]largest\f[R]،
\f[V]smallest\f[R]، \f[V]rename\f[R] یا \f[V]list\f[R].
پیش‌فرض \f[V]interactive\f[R] است.
برای اطلاعات بیشتر در مورد مفهوم هر یک از این گزینه‌ها، دستور dedupe (https://rclone.org/commands/rclone_dedupe) را ببینید.
.SS --default-time Time
.PP
اگر یک فایل یا دایرکتوری دارای زمان تغییری باشد که rclone بتواند بخواند، rclone در عوض این زمان ثابت را نمایش خواهد داد.
.PP
پیش‌فرض \f[V]2000-01-01 00:00:00 UTC\f[R] است.
این مقدار را می‌توان به هر یک از روش‌های نشان‌داده‌شده در گزینه‌های زمان پیکربندی کرد.
.PP
به عنوان مثال، \f[V]--default-time 2020-06-01\f[R] برای تنظیم زمان پیش‌فرض روی ۱ ژوئن ۲۰۲۰ یا \f[V]--default-time 0s\f[R] برای تنظیم زمان پیش‌فرض روی زمان شروع به کار rclone.
.SS --disable string
.PP
این گزینه فهرستی از قابلیت‌های اختیاری (جداشده با ویرگول) را غیرفعال می‌کند.
برای مثال، جهت غیرفعال کردن انتقال سمت سرور و کپی سمت سرور از این دستور استفاده کنید:
.IP
.nf
\f[C]
--disable move,copy
\f[R]
.fi
.PP
نام ویژگی‌ها را می‌توان با هر نوع بزرگی یا کوچکی حروف (بدون حساسیت به حروف بزرگ و کوچک) وارد کرد.
.PP
برای مشاهده فهرستی از ویژگی‌هایی که می‌توان غیرفعال کرد، از این دستور استفاده کنید:
.IP
.nf
\f[C]
--disable help
\f[R]
.fi
.PP
ویژگی‌هایی که یک ریموت داراست را می‌توان در قالب JSON با دستور زیر مشاهده کرد:
.IP
.nf
\f[C]
rclone backend features remote:
\f[R]
.fi
.PP
برای آشنایی با عملکرد هر قابلیت، بخش بررسی کلی ویژگی‌ها (https://rclone.org/overview/#features) و ویژگی‌های اختیاری (https://rclone.org/overview/#optional-features) را ببینید.
.PP
توجه داشته باشید برخی قابلیت‌ها که پرچم‌های ویژگی \f[V]true\f[R]/\f[V]false\f[R] هستند را می‌توان با افزودن پیشوند \f[V]!\f[R] روی \f[V]true\f[R] تنظیم کرد.
برای مثال ویژگی \f[V]CaseInsensitive\f[R] را می‌توان با \f[V]--disable CaseInsensitive\f[R] به‌اجبار روی \f[V]false\f[R] و با \f[V]--disable \[aq]!CaseInsensitive\[aq]\f[R] به‌اجبار روی \f[V]true\f[R] قرار داد.
به‌طور کلی انجام این کار توصیه نمی‌شود، اما ممکن است در موارد اضطراری مفید باشد.
.PP
(توجه داشته باشید که \f[V]!\f[R] یک دستور پوسته است که در پلتفرم‌های شبه‌یونیکس باید آن را با نقل‌قول تکی یا با یک بک‌اسلش گریزدهی (escape) کنید.)
.PP
این پرچم می‌تواند برای اشکال‌زدایی و در شرایط استثنایی مفید باشد
(مانند زمانی که Google Drive حجم کل کپی‌های سمت سرور را به 100 GiB/day محدود می‌کند)..SS --disable-http2
.PP
این گزینه مانع از تلاش rclone برای استفاده از HTTP/2 در صورت در دسترس بودن می‌شود.
این کار گاهی اوقات می‌تواند به دلیل وجود مشکلی در کتابخانه استاندارد Go
(https://github.com/golang/go/issues/37373) سرعت انتقال را افزایش دهد.
.SS --dscp string
.PP
یک مقدار یا نام DSCP را برای استفاده در اتصالات مشخص می‌کند.
این امر می‌تواند به سیستم QoS برای شناسایی کلاس ترافیک کمک کند.
مقادیر BE، EF، DF، LE، CSx و AFxx مجاز هستند.
.PP
برای درک بهتر این فیلد، به توضیحات
Differentiated Services (https://en.wikipedia.org/wiki/Differentiated_services)
مراجعه کنید.
تنظیم این مقدار روی 1 (LE) به منظور شناسایی جریان در کلاس SCAVENGER می‌تواند از اشغال بیش از حد پهنای باند در شبکه‌ای با پشتیبانی از DiffServ جلوگیری کند
(RFC 8622 (https://tools.ietf.org/html/rfc8622)).
.PP
به عنوان مثال، اگر QoS را روی روتر به گونه‌ای پیکربندی کرده‌اید که LE را به درستی مدیریت کند،
اجرای دستور:
.IP
.nf
\f[C]
rclone copy --dscp LE from:/from to:/to
\f[R]
.fi
.PP
اولویت را نسبت به جریان‌های معمول اینترنت پایین‌تر می‌آورد.
.PP
این گزینه روی Windows هیچ تأثیری ندارد (ببینید:
golang/go#42728 (https://github.com/golang/go/issues/42728)).
.SS -n, --dry-run
.PP
یک اجرای آزمایشی بدون اعمال تغییرات دائمی انجام می‌دهد.
از این گزینه برای مشاهده اقداماتی که rclone بدون انجام واقعی انجام می‌دهد، استفاده کنید.
هنگام راه‌اندازی دستور
sync (https://rclone.org/commands/rclone_sync)
که فایل‌ها را در مقصد حذف می‌کند، بسیار مفید است.
.SS --expect-continue-timeout Duration
.PP
این گزینه مدت زمانی را مشخص می‌کند که در صورت وجود سرآیند \[dq]Expect: 100-continue\[dq] در درخواست، پس از نوشتن کامل سرآیندهای درخواست، باید برای اولین سرآیندهای پاسخ سرور منتظر ماند.
همه backendها از این قابلیت پشتیبانی نمی‌کنند.
.PP
مقدار صفر به معنی عدم وجود مهلت زمانی (timeout) است و باعث می‌شود بدنه درخواست بلافاصله و بدون منتظر ماندن برای تأیید سرور ارسال شود.
این مدت شامل زمان ارسال سرآیند درخواست نمی‌شود.
.PP
پیش‌فرض \f[V]1s\f[R] است.
برای غیرفعال کردن آن را روی \f[V]0\f[R] تنظیم کنید.
.SS --error-on-no-transfer
.PP
به طور پیش‌فرض، اگر هیچ خطایی رخ ندهد rclone با کد خروج 0 خارج خواهد شد.
.PP
این گزینه به rclone اجازه می‌دهد در صورتی که هیچ فایلی بین مبدأ و مقصد منتقل نشد، کد خروج 9 را بازگرداند.
این امر امکان استفاده از rclone در اسکریپت‌ها و اجرای اقدامات بعدی در صورت کپی شدن داده‌ها، یا صرف‌نظر از آن‌ها در غیر این صورت را فراهم می‌کند.
.PP
نکته مهم: فعال کردن این گزینه یک خطای معمولاً غیرمرگبار را به یک خطای بالقوه مرگبار تبدیل می‌کند \- لطفاً اسکریپت‌های خود را بررسی کرده و بر این اساس تنظیم نمایید!
.SS --fix-case
.PP
به طور معمول، همگام‌سازی با مقصدی که به بزرگی و کوچکی حروف حساس نیست (مانند macOS / Windows)، در صورتی که نام فایل‌های مبدأ و مقصد در بزرگی و کوچکی حروف تفاوت داشته باشند اما در غیر این صورت یکسان باشند، به تطابق نام فایل منجر نخواهد شد.
برای مثال، همگام‌سازی \f[V]hello.txt\f[R] با \f[V]HELLO.txt\f[R] به طور معمول باعث باقی ماندن نام فایل مقصد به صورت \f[V]HELLO.txt\f[R] می‌شود.
اگر \f[V]--fix-case\f[R] تنظیم شده باشد، آنگاه نام فایل \f[V]HELLO.txt\f[R] به \f[V]hello.txt\f[R] تغییر خواهد یافت تا با مبدأ مطابقت پیدا کند.
.PP
نکته مهم:
.IP \[bu] 2
نام‌های دایرکتوری با بزرگی و کوچکی نادرست حروف نیز اصلاح خواهند شد
.IP \[bu] 2
در صورت تنظیم بودن \f[V]--immutable\f[R]، گزینه \f[V]--fix-case\f[R] نادیده گرفته خواهد شد
.IP \[bu] 2
استفاده از \f[V]--local-case-sensitive\f[R] به جای این گزینه توصیه نمی‌شود؛ زیرا باعث حذف شدن \f[V]HELLO.txt\f[R] خواهد شد!
.IP \[bu] 2
نام فایل قدیمی مقصد نباید توسط فیلترها مستثنی شده باشد.
به خصوص در مورد
\f[V]--files-from\f[R] (https://rclone.org/filtering/#files-from-read-list-of-source-file-names)
دقت کنید، که از
\f[V]--ignore-case\f[R] (https://rclone.org/filtering/#ignore-case-make-searches-case-insensitive)
پیروی نمی‌کند!
.IP \[bu] 2
در remoteهایی که از انتقال سمت سرور پشتیبانی نمی‌کنند، \f[V]--fix-case\f[R] نیازمند بارگیری فایل و بارگذاری مجدد آن خواهد بود.
برای جلوگیری از این امر، از \f[V]--fix-case\f[R] استفاده نکنید..SS --fs-cache-expire-duration Duration
.PP
هنگام استفاده از rclone از طریق API، rclone ریموت‌های ساخته‌شده را به‌طور پیش‌فرض به مدت ۵ دقیقه در \[dq]fs cache\[dq] ذخیره (کش) می‌کند.
این بدان معناست که اگر کارهای مکرری را روی همان ریموت انجام دهید، rclone مجبور نخواهد بود آن را دوباره از ابتدا بسازد، که باعث کارآمدتر شدن آن می‌شود.
.PP
این پرچم مدت زمانی را که ریموت‌ها کش می‌شوند تنظیم می‌کند.
اگر آن را روی \f[V]0\f[R] (یا عددی منفی) قرار دهید، rclone اصلاً ریموت‌ها را کش نخواهد کرد.
.PP
توجه داشته باشید که اگر از برخی پرچم‌ها مانند \f[V]--backup-dir\f[R] استفاده کنید و این گزینه روی \f[V]0\f[R] تنظیم شده باشد، rclone ممکن است دو ریموت بسازد (یکی برای مبدأ یا مقصد و دیگری برای \f[V]--backup-dir\f[R])، در حالی که پیش‌تر ممکن بود تنها یک ریموت بسازد.
.SS --fs-cache-expire-interval Duration
.PP
این مشخص می‌کند که rclone هر چند وقت یک‌بار منقضی شدن ریموت‌های کش‌شده را بررسی کند.
برای اطلاعات بیشتر، مستندات \f[V]--fs-cache-expire-duration\f[R] در بالا را ببینید.
پیش‌فرض 60s است؛ برای غیرفعال کردن انقضا آن را روی 0 قرار دهید.
.SS --header stringArray
.PP
افزودن یک سرآیند (header) HTTP برای تمامی تراکنش‌ها.
این پرچم می‌تواند برای افزودن چندین سرآیند تکرار شود.
.PP
اگر می‌خواهید سرآیندها را فقط برای بارگذاری‌ها اضافه کنید از
\f[V]--header-upload\f[R] و اگر می‌خواهید سرآیندها را فقط برای
بارگیری‌ها اضافه کنید از \f[V]--header-download\f[R] استفاده کنید.
.PP
این پرچم برای تمامی بک‌اندهای مبتنی بر HTTP پشتیبانی می‌شود، حتی آن‌هایی که توسط
\f[V]--header-upload\f[R] و \f[V]--header-download\f[R] پشتیبانی نمی‌شوند؛
بنابراین می‌توان با احتیاط به عنوان یک راهکار جایگزین برای آن‌ها استفاده کرد.
.IP
.nf
\f[C]
rclone ls remote:test --header \[dq]X-Rclone: Foo\[dq] --header \[dq]X-LetMeIn: Yes\[dq]
\f[R]
.fi
.SS --header-download stringArray
.PP
افزودن یک سرآیند HTTP برای تمامی تراکنش‌های بارگیری (دانلود).
این پرچم می‌تواند برای افزودن چندین سرآیند تکرار شود.
.IP
.nf
\f[C]
rclone sync --interactive s3:test/src \[ti]/dst --header-download \[dq]X-Amz-Meta-Test: Foo\[dq] --header-download \[dq]X-Amz-Meta-Test2: Bar\[dq]
\f[R]
.fi
.PP
برای مشاهدهٔ بک‌اندهایی که در حال حاضر پشتیبانی می‌شوند، گزارش شمارهٔ ۵۹ گیت‌هاب (https://github.com/rclone/rclone/issues/59) را ببینید.
.SS --header-upload stringArray
.PP
افزودن یک سرآیند HTTP برای تمامی تراکنش‌های بارگذاری (آپلود).
این پرچم می‌تواند برای افزودن چندین سرآیند تکرار شود.
.IP
.nf
\f[C]
rclone sync --interactive \[ti]/src s3:test/dst --header-upload \[dq]Content-Disposition: attachment; filename=\[aq]cool.html\[aq]\[dq] --header-upload \[dq]X-Amz-Meta-Test: FooBar\[dq]
\f[R]
.fi
.PP
برای مشاهدهٔ بک‌اندهایی که در حال حاضر پشتیبانی می‌شوند، گزارش شمارهٔ ۵۹ گیت‌هاب (https://github.com/rclone/rclone/issues/59) را ببینید.
.SS --http-proxy string
.PP
از این گزینه برای تنظیم یک پروکسی HTTP جهت استفاده در تمامی سرویس‌های مبتنی بر HTTP استفاده کنید.
.PP
ابزار Rclone همچنین از متغیرهای محیطی استاندارد پروکسی HTTP پشتیبانی می‌کند که آن‌ها را به‌طور خودکار دریافت خواهد کرد.
این شیوهٔ معمول برای تنظیم پروکسی HTTP است، اما از این پرچم می‌توان برای لغو و جایگزینی (override) آن استفاده کرد.
.SS --human-readable
.PP
دستورهای Rclone مقادیر مربوط به اندازه‌ها (مانند تعداد بایت‌ها) و شمارش‌ها (مانند تعداد فایل‌ها) را به عنوان اعداد \f[I]خام\f[R] (raw) یا در قالب \f[I]خوانا برای انسان\f[R] نمایش می‌دهند.
.PP
در قالب خوانا برای انسان، مقادیر به واحدهای بزرگ‌تر مقیاس‌بندی شده، با یک پسوند که پس از مقدار نمایش داده می‌شود مشخص می‌شوند و تا سه رقم اعشار گرد می‌گردند.
ابزار Rclone به‌طور پیوسته از واحدهای باینری (توان‌های ۲) برای اندازه‌ها و از واحدهای دهدهی (توان‌های ۱۰) برای شمارش‌ها استفاده می‌کند.
پیشوند واحد برای اندازه مطابق با نماد استاندارد IEC است، مانند \f[V]Ki\f[R] برای کیبی (kibi).
در صورت استفاده با واحد بایت، \f[V]1 KiB\f[R] به معنای ۱۰۲۴ بایت است.
در خروجی‌های نوع فهرستی، تنها پیشوند واحد به مقدار ضمیمه می‌شود (مانند \f[V]9.762Ki\f[R])، در حالی که در خروجی‌های متنی‌تر، واحد کامل نشان داده می‌شود (مانند \f[V]9.762 KiB\f[R]).
برای شمارش‌ها از نماد استاندارد SI استفاده می‌شود، مانند پیشوند \f[V]k\f[R] برای کیلو.
در مورد تعداد فایل‌ها، \f[V]1k\f[R] به معنای ۱۰۰۰ فایل است.
.PP
دستورهای مختلف فهرست‌گیری (https://rclone.org/commands/rclone_ls) به‌طور پیش‌فرض اعداد خام را در خروجی نمایش می‌دهند.
گزینهٔ \f[V]--human-readable\f[R] باعث می‌شود که آن‌ها به جای آن مقادیر را در قالبی خوانا برای انسان (با پیشوند کوتاه واحد) نمایش دهند.
.PP
دستور about (https://rclone.org/commands/rclone_about) به‌طور پیش‌فرض خروجی را به صورت خوانا برای انسان نمایش می‌دهد و دارای گزینهٔ اختصاصی \f[V]--full\f[R] است تا به جای آن مقادیر خام را در خروجی چاپ کند.
.PP
دستور size (https://rclone.org/commands/rclone_size) هر دو مقدار خوانا برای انسان و اعداد خام را در یک خروجی یکسان ارائه می‌دهد.
.PP
دستور tree (https://rclone.org/commands/rclone_tree) نیز گزینهٔ \f[V]--human-readable\f[R] را مد نظر قرار می‌دهد، اما دقیقاً از همان نشانه‌گذاری سایر دستورها استفاده نخواهد کرد: مقدار را تا یک رقم اعشار گرد می‌کند و از پسوند تک‌حرفی استفاده می‌نماید، مانند \f[V]K\f[R] به جای \f[V]Ki\f[R].
دلیل این امر وابستگی آن به یک کتابخانهٔ خارجی است.
.PP
دستور تعاملی ncdu (https://rclone.org/commands/rclone_ncdu) به‌طور پیش‌فرض مقادیر را به صورت خوانا برای انسان نمایش می‌دهد و برای تغییر وضعیت این حالت، به کلید \f[V]u\f[R] پاسخ می‌دهد..SS --ignore-case-sync
.PP
استفاده از این گزینه باعث می‌شود rclone هنگام همگام‌سازی، بزرگی و کوچکی حروف در نام فایل‌ها را نادیده بگیرد؛ بنابراین اگر نام فایل‌های موجود یکسان باشد، حتی در صورت تفاوت در بزرگی و کوچکی حروف، فایل‌ها کپی یا همگام‌سازی نمی‌شوند.
.SS --ignore-checksum
.PP
به طور معمول rclone مطابقت چکسام (checksum) فایل‌های منتقل‌شده را بررسی می‌کند و در صورت عدم تطابق، خطای \[dq]corrupted on transfer\[dq] را صادر می‌کند.
.PP
می‌توانید از این گزینه برای نادیده گرفتن این بررسی استفاده کنید.
تنها زمانی باید از آن استفاده کنید که با پیام خطای \[dq]corrupted on transfer\[dq] مواجه شده‌اید و مطمئن هستید که می‌خواهید داده‌های بالقوه خراب را منتقل کنید.
.SS --ignore-existing
.PP
استفاده از این گزینه باعث می‌شود rclone بدون قید و شرط تمام فایل‌هایی را که در مقصد وجود دارند، بدون توجه به محتوای آن‌ها، نادیده بگیرد.
.PP
اگرچه این گزینه به طور کلی توصیه نمی‌شود، اما می‌تواند در مواردی که فایل‌های شما به دلیل رمزنگاری تغییر می‌کنند مفید باشد.
با این حال، در صورتی که انتقال نیمه‌کاره متوقف شده باشد، نمی‌تواند انتقال‌های ناقص را اصلاح کند.
.PP
هنگام اجرای دستور \f[V]move\f[R]/\f[V]moveto\f[R]، این پرچم در صورت وجود فایلی با همان نام در مقصد، فایل‌های رد شده را در مکان مبدأ بدون تغییر باقی می‌گذارد.
.SS --ignore-size
.PP
به طور معمول rclone برای بررسی یکسان بودن فایل‌ها، زمان تغییر (modification time) و اندازه آن‌ها را بررسی می‌کند.
اگر این پرچم را تنظیم کنید، rclone فقط زمان تغییر را بررسی خواهد کرد.
اگر \f[V]--checksum\f[R] تنظیم شده باشد، فقط چکسام را بررسی می‌کند.
.PP
همچنین باعث می‌شود rclone از بررسی یکسان بودن اندازه‌ها پس از انتقال صرف‌نظر کند.
.PP
این گزینه می‌تواند برای انتقال فایل‌ها به و از OneDrive که گاهی اندازه فایل‌های تصویری را به اشتباه گزارش می‌کند، مفید باشد (برای اطلاعات بیشتر به #399 (https://github.com/rclone/rclone/issues/399) مراجعه کنید).
.SS -I, --ignore-times
.PP
استفاده از این گزینه باعث می‌شود rclone بدون در نظر گرفتن وضعیت فایل‌ها در مقصد، بدون قید و شرط تمام فایل‌ها را آپلود کند.
.PP
به طور معمول rclone فایل‌هایی را که زمان تغییر و اندازه یکسانی داشته باشند (یا در صورت استفاده از \f[V]--checksum\f[R]، چکسام یکسانی داشته باشند) رد می‌کند.
.SS --immutable
.PP
با فایل‌های مبدأ و مقصد به عنوان فایل‌های تغییرناپذیر (immutable) رفتار می‌کند و اجازه اعمال تغییر را نمی‌دهد.
.PP
با تنظیم این گزینه، فایل‌ها طبق درخواست ایجاد و حذف می‌شوند، اما فایل‌های موجود هرگز به‌روزرسانی نخواهند شد.
اگر یک فایل موجود بین مبدأ و مقصد مطابقت نداشته باشد، rclone خطای
\f[V]Source and destination exist but do not match: immutable file modified\f[R] را نمایش می‌دهد.
.PP
توجه داشته باشید که تنها دستوراتی که فایل‌ها را منتقل می‌کنند (مانند
sync (https://rclone.org/commands/rclone_sync)،
copy (https://rclone.org/commands/rclone_copy) یا
move (https://rclone.org/commands/rclone_move)) تحت تأثیر این رفتار قرار می‌گیرند و فقط ویرایش و تغییر غیرمجاز است.
فایل‌ها همچنان ممکن است به طور صریح (مانند
delete (https://rclone.org/commands/rclone_delete)،
purge (https://rclone.org/commands/rclone_purge)) یا به طور ضمنی (مانند
sync (https://rclone.org/commands/rclone_sync)،
move (https://rclone.org/commands/rclone_move)) حذف شوند.
اگر می‌خواهید علاوه بر تغییر، از حذف نیز جلوگیری شود، از \f[V]copy --immutable\f[R] استفاده کنید.
.PP
این ویژگی می‌تواند به عنوان یک لایه حفاظتی اضافی برای مجموعه‌داده‌های تغییرناپذیر یا فقط‌افزودنی (append-only) (به‌ویژه آرشیوهای پشتیبان) که هرگونه تغییر در آن‌ها به منزله خرابی است و نباید منتشر شود، مفید باشد.
.SS --inplace
.PP
پرچم \f[V]--inplace\f[R] رفتار rclone را هنگام آپلود فایل‌ها به برخی از backendها (مقصدهایی که پرچم ویژگی \f[V]PartialUploads\f[R] در آن‌ها فعال است) تغییر می‌دهد، مانند:
.IP \[bu] 2
local
.IP \[bu] 2
ftp
.IP \[bu] 2
sftp
.IP \[bu] 2
pcloud
.PP
بدون پرچم \f[V]--inplace\f[R] (حالت پیش‌فرض)، rclone ابتدا داده‌ها را در یک فایل موقت با پسوندی مشابه این آپلود می‌کند، که در آن \f[V]XXXXXX\f[R] نمایانگر هش اثر انگشت فایل مبدأ است و \f[V].partial\f[R] مقدار --partial-suffix است (به طور پیش‌فرض \f[V].partial\f[R]).
.IP
.nf
\f[C]
original-file-name.XXXXXX.partial
\f[R]
.fi
.PP
(rclone در صورت لزوم با کوتاه کردن بخش \f[V]original-file-name\f[R] اطمینان حاصل می‌کند که نام نهایی طولانی‌تر از ۱۰۰ کاراکتر نباشد).
.PP
پس از اتمام آپلود، rclone نام فایل \f[V].partial\f[R] را به نام صحیح تغییر می‌دهد و در همان لحظه هر فایل موجود قبلی را بازنویسی می‌کند. اگر آپلود با شکست مواجه شود، فایل \f[V].partial\f[R] حذف خواهد شد.
.PP
این کار از مشاهده فایل‌های ناقص توسط سایر کاربران backend با نام جدیدشان جلوگیری کرده و مانع از بازنویسی فایل قدیمی تا زمان آپلود کامل فایل جدید می‌شود.
.PP
در صورت استفاده از پرچم \f[V]--inplace\f[R]، rclone بدون ایجاد فایل \f[V].partial\f[R]، فایل را مستقیماً با نام نهایی آپلود می‌کند.
.PP
این بدان معناست که در حین آپلود، یک فایل ناقص در فهرست دایرکتوری قابل مشاهده خواهد بود و هر فایل موجود به محض شروع آپلود بازنویسی می‌شود. اگر انتقال با شکست مواجه شود، فایل حذف خواهد شد. این موضوع می‌تواند در صورت بروز خطا در انتقال، باعث از دست رفتن فایل موجود شود.
.PP
توجه داشته باشید که در سیستم‌فایل محلی، در صورت عدم استفاده از \f[V]--inplace\f[R]، پیوندهای سخت یا hard linkها (فقط در یونیکس) شکسته خواهند شد. همچنین در صورت استفاده از \f[V]--inplace\f[R]، امکان به‌روزرسانی فایل‌های اجراییِ در حال اجرا را نخواهید داشت.
.PP
همچنین توجه داشته باشید که نسخه‌های rclone پیش از v1.63.0 به گونه‌ای رفتار می‌کنند که گویی پرچم \f[V]--inplace\f[R] همیشه فعال است..SS -i, --interactive
.PP
از این پرچم می‌توان برای اعلام به rclone جهت درخواست تأیید دستی پیش از انجام عملیات‌های مخرب استفاده کرد.
.PP
\f[B]توصیه می‌شود\f[R] که هنگام یادگیری rclone، به‌ویژه همراه با \f[V]rclone sync\f[R]، از این پرچم استفاده کنید.
.PP
برای مثال:
.IP
.nf
\f[C]
$ rclone delete --interactive /tmp/dir
rclone: delete \[dq]important-file.txt\[dq]?
y) Yes, this is OK (default)
n) No, skip this
s) Skip all delete operations with no more questions
!) Do all delete operations with no more questions
q) Exit rclone now.
y/n/s/!/q> n
\f[R]
.fi
.PP
معنی گزینه‌ها:
.IP \[bu] 2
\f[V]y\f[R]: \f[B]بله\f[R]، این عملیات انجام شود.
برای این کار می‌توانید کلید Return را نیز فشار دهید.
از شما برای هر مورد سؤال خواهد شد، مگر این‌که \f[V]s\f[R] یا
\f[V]!\f[R] را انتخاب کنید.
.IP \[bu] 2
\f[V]n\f[R]: \f[B]خیر\f[R]، این عملیات انجام نشود.
از شما برای هر مورد سؤال خواهد شد، مگر این‌که \f[V]s\f[R] یا
\f[V]!\f[R] را انتخاب کنید.
.IP \[bu] 2
\f[V]s\f[R]: \f[B]رد کردن\f[R] تمام عملیات‌های بعدی از این نوع
بدون پرسش دوباره.
این حالت تا زمان خروج rclone اعمال می‌شود.
اگر نوع دیگری از عملیات وجود داشته باشد، برای آن‌ها از شما سؤال پرسیده خواهد شد.
.IP \[bu] 2
\f[V]!\f[R]: \f[B]انجام همه\f[R] عملیات‌های بعدی بدون پرسش دوباره.
زمانی کاربرد دارد که تصمیم گرفته‌اید انجام چنین عملیاتی توسط rclone مشکلی ندارد.
این حالت تا زمان خروج rclone اعمال می‌شود.
اگر نوع دیگری از عملیات وجود داشته باشد، برای آن‌ها از شما سؤال پرسیده خواهد شد.
.IP \[bu] 2
\f[V]q\f[R]: \f[B]خروج\f[R] آنی از rclone، محض اطمینان!
.SS --leave-root
.PP
در طول اجرای rmdirs، دایرکتوری ریشه (root) حذف نخواهد شد، حتی اگر خالی باشد.
.SS -l, --links
.PP
به‌طور معمول rclone پیوندهای نمادین (symlinks) یا نقاط پیوند (junction points که در ویندوز رفتاری شبیه به symlink دارند) را نادیده می‌گیرد.
فایل‌های نادیده‌گرفته‌شده در عملیات sync کپی، جابه‌جا یا حذف نخواهند شد.
.PP
اگر از این پرچم استفاده کنید، rclone پیوندهای نمادین را از هر backend پشتیبانی‌شده کپی کرده و آن‌ها را به‌صورت فایل‌های متنی با پسوند
\f[V].rclonelink\f[R] در مقصد ذخیره می‌کند.
.PP
این فایل متنی حاوی مقصد پیوند نمادین خواهد بود.
.PP
پرچم \f[V]--links\f[R] / \f[V]-l\f[R] این ویژگی را برای تمام
backendهای پشتیبانی‌شده و VFS فعال می‌کند.
در صورت نیاز، پرچم‌های جداگانه‌ای برای فعال‌سازی آن فقط برای VFS
(\f[V]--vfs-links\f[R]) و backend محلی (\f[V]--local-links\f[R]) وجود دارد.
.SS --list-cutoff int
.PP
هنگام همگام‌سازی، rclone پیش از مقایسه ورودی‌های دایرکتوری نیاز دارد که
آن‌ها را مرتب‌سازی کند.
به‌طور پیش‌فرض در مقادیر پایین‌تر از این آستانه (۱٬۰۰۰٬۰۰۰)، rclone ورودی‌های دایرکتوری را در حافظه ذخیره می‌کند.
ذخیره ۱٬۰۰۰٬۰۰۰ ورودی تقریباً به ۱ گیگابایت حافظه RAM نیاز دارد.
بالاتر از این آستانه، rclone ورودی‌های دایرکتوری را روی دیسک ذخیره کرده و
بدون مصرف مقدار زیادی حافظه، آن‌ها را مرتب می‌کند.
.PP
انجام این کار بازدهی اندکی کمتر از مرتب‌سازی در حافظه دارد و
تنها برای backendهای مبتنی بر باکت (مانند s3، b2، azureblob و swift) عملکرد خوبی خواهد داشت؛
اما این‌ها تنها backendهایی هستند که احتمال می‌رود میلیون‌ها ورودی در یک دایرکتوری داشته باشند..SS --log-file string
.PP
ثبت تمام خروجی‌های rclone در یک فایل.
این گزینه به‌طور پیش‌فرض فعال نیست.
این ویژگی می‌تواند همراه با پرچم \f[V]-v\f[R] برای ردیابی مشکلات مربوط به همگام‌سازی مفید باشد.
برای اطلاعات بیشتر بخش گزارش‌گیری (logging) را ببینید.
.PP
اگر فایل وجود داشته باشد، rclone به انتهای آن اضافه خواهد کرد.
.PP
توجه داشته باشید که اگر از برنامه \f[V]logrotate\f[R] برای مدیریت لاگ‌های rclone استفاده می‌کنید، باید از گزینه \f[V]copytruncate\f[R] استفاده نمایید، زیرا rclone سیگنالی برای چرخش لاگ‌ها ندارد.
.PP
در غیر این صورت، می‌توانید از گزینه‌های زیر برای مدیریت چرخش داخلی لاگ‌های rclone استفاده کنید.
.SS --log-file-max-size SizeSuffix
.PP
حداکثر اندازه فایل لاگ پیش از چرخش (مانند \f[V]10M\f[R]).
این SizeSuffix به نزدیک‌ترین مبی‌بایت (MiB) یا در صورت کمتر بودن به 1 MiB گرد می‌شود.
.PP
اگر \f[V]--log-file\f[R] تنظیم نشده باشد، این گزینه نادیده گرفته خواهد شد.
.PP
اگر این گزینه تنظیم نشود، سایر گزینه‌های چرخش لاگ نادیده گرفته خواهند شد.
.PP
برای مثال، اگر پرچم‌های زیر استفاده شوند:
.IP
.nf
\f[C]
rclone --log-file rclone.log --log-file-max-size 1M --log-file-max-backups 3
\f[R]
.fi
.PP
سپس این دستور فایل‌های لاگی ایجاد خواهد کرد که شبیه به این هستند:
.IP
.nf
\f[C]
$ ls -l
-rw-------  1 user user  1048491 Apr 11 17:15 rclone-2025-04-11T17-15-29.998.log
-rw-------  1 user user  1048511 Apr 11 17:15 rclone-2025-04-11T17-15-30.467.log
-rw-------  1 user user  1048559 Apr 11 17:15 rclone-2025-04-11T17-15-30.543.log
-rw-------  1 user user   521602 Apr 11 17:15 rclone.log
\f[R]
.fi
.PP
که فایل \f[V]rclone.log\f[R] فایل جاری خواهد بود.
.SS --log-file-compress
.PP
در صورت تنظیم، فایل‌های لاگ چرخش‌یافته را با استفاده از gzip فشرده می‌کند.
این کار پسوند فایل‌های لاگ قدیمی را به \f[V].log.gz\f[R] تغییر می‌دهد.
.PP
پیش‌فرض false است \- فایل‌های لاگ فشرده نشوند.
.SS --log-file-max-age Duration
.PP
حداکثر مدت‌زمان نگهداری فایل‌های لاگ قدیمی (مانند \f[V]7d\f[R]).
این مقدار به نزدیک‌ترین روز، یا در صورت کمتر بودن به ۱ روز گرد می‌شود.
.PP
حالت پیش‌فرض نگهداری تمام فایل‌های لاگ قدیمی است.
.SS --log-file-max-backups int
.PP
حداکثر تعداد فایل‌های لاگ قدیمی برای نگهداری.
.PP
حالت پیش‌فرض نگهداری تمام فایل‌های لاگ قدیمی است.
.SS --log-format string
.PP
فهرستی از گزینه‌های قالب‌بندی لاگ که با کاما از هم جدا شده‌اند.
گزینه‌های پذیرفته‌شده عبارتند از:
.IP \[bu] 2
\f[V]date\f[R] \- افزودن تاریخ با قالب YYYY/MM/YY به لاگ.
.IP \[bu] 2
\f[V]time\f[R] \- افزودن زمان با قالب HH:MM:SS به لاگ.
.IP \[bu] 2
\f[V]microseconds\f[R] \- افزودن میکروثانیه به زمان با قالب
HH:MM:SS.SSSSSS.
.IP \[bu] 2
\f[V]UTC\f[R] \- ثبت لاگ‌ها بر اساس زمان UTC به‌جای زمان محلی.
.IP \[bu] 2
\f[V]longfile\f[R] \- افزودن نام فایل مبدأ و شماره خط مربوط به عبارت لاگ.
.IP \[bu] 2
\f[V]shortfile\f[R] \- افزودن نام فایل مبدأ و شماره خط مربوط به عبارت لاگ.
.IP \[bu] 2
\f[V]pid\f[R] \- افزودن شناسه فرایند (PID) به لاگ \- مفید برای استفاده همراه با
\f[V]rclone mount --daemon\f[R].
.IP \[bu] 2
\f[V]nolevel\f[R] \- عدم افزودن سطح گزارش (level) به لاگ.
.IP \[bu] 2
\f[V]json\f[R] \- معادل با افزودن \f[V]--use-json-log\f[R].
.PP
این موارد با ترتیبی که در بالا ذکر شد به خط لاگ افزوده می‌شوند.
.PP
قالب پیش‌فرض لاگ \f[V]\[dq]date,time\[dq]\f[R] است..SS --log-level LogLevel
.PP
این گزینه سطح گزارش را برای rclone تعیین می‌کند.
سطح پیش‌فرض گزارش \f[V]NOTICE\f[R] است.
.PP
سطح \f[V]DEBUG\f[R] معادل \f[V]-vv\f[R] است.
این سطح اطلاعات اشکال‌زدایی فراوانی را در خروجی نمایش می‌دهد \- که برای گزارش باگ‌ها و آگاهی دقیق از عملکرد rclone مفید است.
.PP
سطح \f[V]INFO\f[R] معادل \f[V]-v\f[R] است.
این سطح اطلاعات مربوط به هر انتقال را در خروجی نمایش داده و به‌طور پیش‌فرض آمار را هر یک دقیقه یک‌بار چاپ می‌کند.
.PP
اگر هیچ پرچم ثبتی مشخص نشود، \f[V]NOTICE\f[R] سطح پیش‌فرض گزارش خواهد بود.
در شرایط کارکرد عادی، اطلاعات بسیار کمی در خروجی نمایش می‌دهد.
این سطح هشدارها و رویدادهای مهم را ثبت می‌کند.
.PP
سطح \f[V]ERROR\f[R] معادل \f[V]-q\f[R] است.
این سطح تنها پیام‌های خطا را در خروجی نمایش می‌دهد.
.PP
همچنین بخش ثبت وقایع (logging) را ببینید.
.SS --windows-event-log-level LogLevel
.PP
در صورت پیکربندی این گزینه (پیش‌فرض \f[V]OFF\f[R] است)، گزارش‌های این سطح و بالاتر، \f[B]علاوه بر\f[R] گزارش‌های عادی، در رویدادنگار ویندوز (Windows event log) ثبت خواهند شد.
این موارد، صرف‌نظر از این‌که گزارش‌های اصلی برای چه قالبی پیکربندی شده باشند، در قالب JSON به‌صورتی که در زیر آمده است ثبت خواهند شد.
.PP
رویدادنگار ویندوز تنها ۳ سطح از نظر شدت دارد: \f[V]Info\f[R]، \f[V]Warning\f[R] و \f[V]Error\f[R].
در صورت فعال بودن، سطوح rclone به شکل زیر نگاشت می‌شوند:
.IP \[bu] 2
\f[V]Error\f[R] ← \f[V]ERROR\f[R] (و بالاتر)
.IP \[bu] 2
\f[V]Warning\f[R] ← \f[V]WARNING\f[R] (توجه داشته باشید که این سطح تعریف شده اما در حال حاضر استفاده نمی‌شود).
.IP \[bu] 2
\f[V]Info\f[R] ← \f[V]NOTICE\f[R]، \f[V]INFO\f[R] و \f[V]DEBUG\f[R].
.PP
چنانچه rclone مجوزهای کافی برای ساخت کلید رجیستری مورد نیاز را داشته باشد، منبع گزارش خود را \[dq]rclone\[dq] اعلام خواهد کرد.
در غیر این صورت گزارش‌ها تحت عنوان \[dq]Application\[dq] ثبت می‌شوند.
می‌توانید دستور \f[V]rclone version --windows-event-log-level DEBUG\f[R] را یک‌بار با دسترسی مدیر سیستم (administrator) اجرا کنید تا کلید رجیستری از پیش ایجاد شود.
.PP
\f[B]توجه\f[R] داشته باشید که سطح \f[V]--windows-event-log-level\f[R] باید بزرگ‌تر (دارای شدت بالاتر) یا مساوی با \f[V]--log-level\f[R] باشد.
برای مثال، برای ثبت DEBUG در یک فایل گزارش، اما ثبت خطاهای ERROR در رویدادنگار، از دستور زیر استفاده می‌کنید:
.IP
.nf
\f[C]
--log-file rclone.log --log-level DEBUG --windows-event-log-level ERROR
\f[R]
.fi
.PP
این گزینه تنها در پلتفرم‌های ویندوز پشتیبانی می‌شود.
.SS --use-json-log
.PP
این گزینه قالب گزارش را به JSON تغییر می‌دهد.
سپس پیام‌های گزارش به‌صورت اشیاء مجزای JSON با این فیلدها ارسال می‌شوند: \f[V]level\f[R]، \f[V]msg\f[R]، \f[V]source\f[R] و \f[V]time\f[R].
قالب حاصل چیزی است که گاهی با نام
newline-delimited
JSON (https://en.wikipedia.org/wiki/JSON_streaming#Newline-delimited_JSON)
(NDJSON) یا JSON Lines (JSONL) شناخته می‌شود.
این شیوه برای پردازش توسط ابزارهای سنتی خط‌محور و خط‌لوله‌های شل بسیار مناسب است، اما یک فایل گزارش کامل از نظر ساختاری JSON معتبر نیست و به تجزیه‌کننده‌ای نیاز دارد که بتواند آن را پردازش کند.
.PP
گزارش‌های JSON در یک خط تک چاپ خواهند شد، اما در اینجا برای وضوح بیشتر به‌صورت گسترده نمایش داده شده‌اند.
.IP
.nf
\f[C]
{
  \[dq]time\[dq]: \[dq]2025-05-13T17:30:51.036237518+01:00\[dq],
  \[dq]level\[dq]: \[dq]debug\[dq],
  \[dq]msg\[dq]: \[dq]4 go routines active\[rs]n\[dq],
  \[dq]source\[dq]: \[dq]cmd/cmd.go:298\[dq]
}
\f[R]
.fi
.PP
گزارش‌های مربوط به انتقال‌های کامل‌شده داده دارای اطلاعات اضافی \f[V]size\f[R] خواهند بود.
گزارش‌هایی که مربوط به شیء خاصی باشند، فیلدهای \f[V]object\f[R] و \f[V]objectType\f[R] را نیز شامل خواهند شد.
.IP
.nf
\f[C]
{
  \[dq]time\[dq]: \[dq]2025-05-13T17:38:05.540846352+01:00\[dq],
  \[dq]level\[dq]: \[dq]info\[dq],
  \[dq]msg\[dq]: \[dq]Copied (new) to: file2.txt\[dq],
  \[dq]size\[dq]: 6,
  \[dq]object\[dq]: \[dq]file.txt\[dq],
  \[dq]objectType\[dq]: \[dq]*local.Object\[dq],
  \[dq]source\[dq]: \[dq]operations/copy.go:368\[dq]
}
\f[R]
.fi
.PP
گزارش‌های آماری شامل یک فیلد \f[V]stats\f[R] خواهند بود که مشابه خروجی فراخوانی rc زیر است:
core/stats (https://rclone.org/rc/#core-stats).
.IP
.nf
\f[C]
{
  \[dq]time\[dq]: \[dq]2025-05-13T17:38:05.540912847+01:00\[dq],
  \[dq]level\[dq]: \[dq]info\[dq],
  \[dq]msg\[dq]: \[dq]...text version of the stats...\[dq],
  \[dq]stats\[dq]: {
    \[dq]bytes\[dq]: 6,
    \[dq]checks\[dq]: 0,
    \[dq]deletedDirs\[dq]: 0,
    \[dq]deletes\[dq]: 0,
    \[dq]elapsedTime\[dq]: 0.000904825,
    ...truncated for clarity...
    \[dq]totalBytes\[dq]: 6,
    \[dq]totalChecks\[dq]: 0,
    \[dq]totalTransfers\[dq]: 1,
    \[dq]transferTime\[dq]: 0.000882794,
    \[dq]transfers\[dq]: 1
  },
  \[dq]source\[dq]: \[dq]accounting/stats.go:569\[dq]
}
\f[R]
.fi.SS --low-level-retries int
.PP
این گزینه تعداد تلاش‌های مجدد سطح پایین که rclone انجام می‌دهد را کنترل می‌کند.
.PP
یک تلاش مجدد سطح پایین برای تکرار یک عملیات ناموفق \- معمولاً یک درخواست HTTP \- استفاده می‌شود.
این مورد ممکن است برای مثال بارگذاری یک بخش (chunk) از یک فایل بزرگ باشد.
شما تلاش‌های مجدد سطح پایین را در گزارش‌ها (log) با پرچم \f[V]-v\f[R] مشاهده خواهید کرد.
.PP
در عملیات‌های عادی نیازی به تغییر این مقدار از حالت پیش‌فرض نیست.
با این حال، اگر تعداد زیادی تلاش مجدد سطح پایین دریافت می‌کنید، ممکن است بخواهید این مقدار را کاهش دهید تا rclone سریع‌تر به یک تلاش مجدد سطح بالا (پرچم \f[V]--retries\f[R] را ببینید) منتقل شود.
.PP
تلاش‌های مجدد سطح پایین را با \f[V]--low-level-retries 1\f[R] غیرفعال کنید.
.SS --max-backlog int
.PP
این گزینه حداکثر تعداد فایل‌های مجاز در صف انتظار (backlog) برای عملیات‌های sync/copy/move است که در انتظار بررسی یا انتقال قرار دارند.
.PP
این مقدار می‌تواند به طور دلخواه بزرگ تنظیم شود.
تنها زمانی که صف در حال استفاده باشد حافظه مصرف خواهد شد.
توجه داشته باشید که در زمان استفاده از صف انتظار، حافظه‌ای از مرتبه N KiB مصرف خواهد شد.
.PP
تنظیم این مقدار به عددی بزرگ به rclone اجازه می‌دهد تا تعداد فایل‌های معلق را با دقت بیشتری محاسبه کند، زمان پایان تقریبی دقیق‌تری ارائه دهد و عملکرد \f[V]--order-by\f[R] را دقیق‌تر سازد.
.PP
تنظیم این مقدار به عددی کوچک، rclone را با فهرست‌های موجود در دوردست (remote) همگام‌تر می‌کند که ممکن است مطلوب باشد.
.PP
تنظیم این مقدار به یک عدد منفی، صف انتظار را تا حد ممکن بزرگ خواهد کرد.
.SS --max-buffer-memory SizeSuffix
.PP
در صورت تنظیم، بیش از مقدار حافظه تعیین‌شده به عنوان بافر تخصیص داده نمی‌شود.
اگر تنظیم نشود یا روی \f[V]0\f[R] یا \f[V]off\f[R] قرار گیرد، میزان حافظه در حال استفاده محدود نخواهد شد.
.PP
این مقدار شامل حافظه مصرفی بافرهای ایجاد شده توسط پرچم \f[V]--buffer\f[R] و بافرهای مورد استفاده در انتقال‌های چند‌رشته‌ای (multi-thread) می‌شود.
.PP
بیشتر انتقال‌های چندرشته‌ای حافظه اضافی مصرف نمی‌کنند، اما بسته به backend برخی این کار را انجام می‌دهند (مانند backend پروتکل s3 برای بارگذاری‌ها).
این بدان معناست که بین تنظیم مجموع \f[V]--transfers\f[R] روی بیشترین مقدار ممکن و مصرف حافظه، نوعی تعارض وجود دارد.
.PP
تنظیم \f[V]--max-buffer-memory\f[R] امکان کنترل حافظه بافر را فراهم می‌کند تا سیستم دچار بار اضافی نشود و در عین حال اجازه می‌دهد \f[V]--transfers\f[R] روی مقادیر بزرگ تنظیم شود.
.SS --max-connections int
.PP
این گزینه حداکثر تعداد فراخوانی‌های هم‌زمان به API مربوط به backend را تعیین می‌کند.
بسته به backend در حال استفاده و استفاده از HTTP1 در برابر HTTP2، ممکن است این مقدار تناظر یک‌به‌یک با اتصالات TCP یا HTTP نداشته باشد.
.PP
هنگام دانلود فایل‌ها، backendها تنها باز شدن اولیه جریان (stream) را محدود می‌کنند.
دانلود توده‌ای داده‌ها به عنوان یک اتصال در نظر گرفته نمی‌شود.
این یعنی پرچم \f[V]--max--connections\f[R] تعداد کل دانلودها را محدود نخواهد کرد.
.PP
توجه داشته باشید که این تنظیم می‌تواند باعث بروز بن‌بست (deadlock) شود، بنابراین باید با احتیاط استفاده شود.
.PP
اگر در حال انجام sync یا copy هستید، مطمئن شوید که \f[V]--max-connections\f[R] یکی بیشتر از مجموع \f[V]--transfers\f[R] و \f[V]--checkers\f[R] باشد.
.PP
اگر از \f[V]--check-first\f[R] استفاده می‌کنید، در این صورت \f[V]--max-connections\f[R] فقط باید یکی بیشتر از مقدار حداکثر بین \f[V]--checkers\f[R] و \f[V]--transfers\f[R] باشد.
.PP
بنابراین برای \f[V]--max-connections 3\f[R] شما از \f[V]--checkers 2 --transfers 2 --check-first\f[R] یا \f[V]--checkers 1 --transfers 1\f[R] استفاده خواهید کرد.
.PP
تنظیم این پرچم می‌تواند برای backendهایی که بارگذاری چندبخشی (multipart uploads) انجام می‌دهند مفید باشد تا تعداد بخش‌های در حال انتقال هم‌زمان را محدود کند..SS --max-delete int
.PP
این گزینه به rclone اعلام می‌کند که بیش از N فایل را حذف نکند.
اگر این حد فراتر رود، یک خطای مهلک (fatal error) ایجاد شده و rclone عملیات در حال انجام را متوقف خواهد کرد.
.SS --max-delete-size SizeSuffix
.PP
هنگامی که اندازه کل موارد حذف‌شده به میزان مشخص‌شده برسد، rclone حذف فایل‌ها را متوقف خواهد کرد.
پیش‌فرض آن غیرفعال (off) است.
.PP
اگر این حد فراتر رود، یک خطای مهلک ایجاد شده و rclone عملیات در حال انجام را متوقف خواهد کرد.
.SS --max-depth int
.PP
این گزینه عمق پیمایش بازگشتی را برای همه دستورها به جز purge تغییر می‌دهد.
.PP
بنابراین اگر دستور \f[V]rclone --max-depth 1 ls remote:path\f[R] را اجرا کنید، تنها فایل‌های موجود در بالاترین سطح دایرکتوری را خواهید دید.
استفاده از \f[V]--max-depth 2\f[R] بدین معناست که همه فایل‌های موجود در دو سطح اول دایرکتوری را مشاهده خواهید کرد و به همین ترتیب.
.PP
به دلایل تاریخی، دستور \f[V]lsd\f[R] به‌طور پیش‌فرض از مقدار ۱ برای \f[V]--max-depth\f[R] استفاده می‌کند \- می‌توانید این مورد را با پرچم خط فرمان تغییر دهید.
.PP
می‌توانید از این دستور برای غیرفعال کردن پیمایش بازگشتی (با \f[V]--max-depth 1\f[R]) استفاده کنید.
.PP
توجه داشته باشید که اگر از این گزینه به همراه \f[V]sync\f[R] و \f[V]--delete-excluded\f[R] استفاده کنید، فایل‌هایی که پیمایش نشده‌اند مستثنی تلقی شده و در مقصد حذف خواهند شد.
اگر مطمئن نیستید چه اتفاقی رخ خواهد داد، ابتدا با \f[V]--dry-run\f[R] آن را آزمایش کنید.
.SS --max-duration Duration
.PP
هنگامی که rclone به اندازه مدت‌زمان مشخص‌شده اجرا شود، انتقال را متوقف خواهد کرد.
پیش‌فرض آن غیرفعال (off) است.
.PP
با رسیدن به این حد، تمام انتقال‌ها فوراً متوقف خواهند شد.
از \f[V]--cutoff-mode\f[R] برای تغییر این رفتار استفاده کنید.
.PP
در صورت رسیدن به حد مدت‌زمان، rclone با کد خروج ۱۰ خارج خواهد شد.
.SS --max-transfer SizeSuffix
.PP
هنگامی که حجم داده‌های ارسالی به اندازه مشخص‌شده برسد، rclone انتقال را متوقف خواهد کرد.
پیش‌فرض آن غیرفعال (off) است.
.PP
با رسیدن به این حد، تمام انتقال‌ها فوراً متوقف خواهند شد.
از \f[V]--cutoff-mode\f[R] برای تغییر این رفتار استفاده کنید.
.PP
در صورت رسیدن به حد مجاز انتقال، rclone با کد خروج ۸ خارج خواهد شد.
.SS --cutoff-mode HARD|SOFT|CAUTIOUS
.PP
رفتار گزینه‌های \f[V]--max-transfer\f[R] و \f[V]--max-duration\f[R] را پیکربندی می‌کند.
.PP
حالت \f[V]HARD\f[R] به محض رسیدن rclone به حد تعیین‌شده، فوراً انتقال را متوقف می‌کند.
این حالت پیش‌فرض است.
.PP
حالت \f[V]SOFT\f[R] با رسیدن rclone به حد تعیین‌شده، از شروع انتقال‌های جدید جلوگیری می‌کند.
.PP
حالت \f[V]CAUTIOUS\f[R] تلاش می‌کند از رسیدن rclone به حد تعیین‌شده جلوگیری کند.
این حالت تنها برای \f[V]--max-transfer\f[R] کاربرد دارد.
.SS -M, --metadata
.PP
فعال کردن این پرچم به rclone امکان می‌دهد متادیتا را از مبدأ به مقصد کپی کند.
برای بک‌اند‌های محلی، این شامل مالکیت، مجوزها، xattr و غیره است.
برای اطلاعات بیشتر بخش metadata را ببینید.
.SS --metadata-mapper SpaceSepList
.PP
اگر پارامتر \f[V]--metadata-mapper /path/to/program\f[R] را تعیین کنید، rclone از آن برنامه برای نگاشت متادیتا از شیء مبدأ به شیء مقصد استفاده خواهد کرد.
.PP
آرگومان این پرچم باید یک دستور به همراه فهرستی اختیاری از آرگومان‌های جداشده با فاصله باشد.
اگر یکی از آرگومان‌ها حاوی فاصله است، آن را داخل \f[V]\[dq]\f[R] قرار دهید؛ اگر می‌خواهید نویسه لغوی \f[V]\[dq]\f[R] را در یک آرگومان داشته باشید، آرگومان را در \f[V]\[dq]\f[R] محصور کرده و \f[V]\[dq]\f[R] را دو برابر کنید.
برای اطلاعات بیشتر، مستندات کدگذاری CSV را ببینید (https://godoc.org/encoding/csv).
.IP
.nf
\f[C]
--metadata-mapper \[dq]python bin/test_metadata_mapper.py\[dq]
--metadata-mapper \[aq]python bin/test_metadata_mapper.py \[dq]argument with a space\[dq]\[aq]
--metadata-mapper \[aq]python bin/test_metadata_mapper.py \[dq]argument with \[dq]\[dq]two\[dq]\[dq] quotes\[dq]\[aq]
\f[R]
.fi
.PP
این قابلیت از یک پروتکل ساده مبتنی بر JSON با ورودی از STDIN و خروجی روی STDOUT استفاده می‌کند.
این برنامه به ازای هر فایل و دایرکتوری کپی‌شده فراخوانی خواهد شد و ممکن است فراخوانی‌ها به‌طور هم‌روند انجام گیرند.
.PP
وظیفه برنامه این است که یک بلوک داده متادیتا (blob) را در ورودی دریافت کرده و آن را در خروجی به یک متادیتای مناسب برای بک‌اند مقصد تبدیل کند.
.PP
ورودی برنامه (از طریق STDIN) ممکن است ساختاری شبیه به این داشته باشد.
این اطلاعات، بستری را برای \f[V]Metadata\f[R] فراهم می‌آورد که ممکن است حائز اهمیت باشد.
.IP \[bu] 2
\f[V]SrcFs\f[R] رشته پیکربندی ریموتی است که شیء در حال حاضر روی آن قرار دارد.
.IP \[bu] 2
\f[V]SrcFsType\f[R] نام بک‌اند مبدأ است.
.IP \[bu] 2
\f[V]DstFs\f[R] رشته پیکربندی ریموتی است که شیء به آن کپی می‌شود.
.IP \[bu] 2
\f[V]DstFsType\f[R] نام بک‌اند مقصد است.
.IP \[bu] 2
\f[V]Remote\f[R] مسیر شیء نسبت به ریشه است.
.IP \[bu] 2
\f[V]Size\f[R]، \f[V]MimeType\f[R] و \f[V]ModTime\f[R] ویژگی‌های شیء هستند.
.IP \[bu] 2
اگر این مورد یک دایرکتوری باشد، \f[V]IsDir\f[R] مقدارش \f[V]true\f[R] است (هنوز پیاده‌سازی نشده است).
.IP \[bu] 2
در صورت شناخته‌شده بودن، \f[V]ID\f[R] شناسه مبدأ شیء است.
.IP \[bu] 2
\f[V]Metadata\f[R] متادیتای اختصاصی بک‌اند است، همان‌طور که در مستندات بک‌اند شرح داده شده است.
.IP
.nf
\f[C]
{
  \[dq]SrcFs\[dq]: \[dq]gdrive:\[dq],
  \[dq]SrcFsType\[dq]: \[dq]drive\[dq],
  \[dq]DstFs\[dq]: \[dq]newdrive:user\[dq],
  \[dq]DstFsType\[dq]: \[dq]onedrive\[dq],
  \[dq]Remote\[dq]: \[dq]test.txt\[dq],
  \[dq]Size\[dq]: 6,
  \[dq]MimeType\[dq]: \[dq]text/plain; charset=utf-8\[dq],
  \[dq]ModTime\[dq]: \[dq]2022-10-11T17:53:10.286745272+01:00\[dq],
  \[dq]IsDir\[dq]: false,
  \[dq]ID\[dq]: \[dq]xyz\[dq],
  \[dq]Metadata\[dq]: {
    \[dq]btime\[dq]: \[dq]2022-10-11T16:53:11Z\[dq],
    \[dq]content-type\[dq]: \[dq]text/plain; charset=utf-8\[dq],
    \[dq]mtime\[dq]: \[dq]2022-10-11T17:53:10.286745272+01:00\[dq],
    \[dq]owner\[dq]: \[dq]user1\[at]domain1.com\[dq],
    \[dq]permissions\[dq]: \[dq]...\[dq],
    \[dq]description\[dq]: \[dq]my nice file\[dq],
    \[dq]starred\[dq]: \[dq]false\[dq]
  }
}
\f[R]
.fi
.PP
سپس برنامه باید ورودی را طبق نیاز ویرایش کرده و به STDOUT ارسال نماید.
فیلد بازگردانده‌شده \f[V]Metadata\f[R] به‌طور کامل برای شیء مقصد اعمال خواهد شد.
هر فیلد دیگری نادیده گرفته خواهد شد.
توجه داشته باشید که در این مثال، نام‌های کاربری و مجوزها را تبدیل کرده و متنی را به توضیحات اضافه می‌کنیم:
.IP
.nf
\f[C]
{
  \[dq]Metadata\[dq]: {
    \[dq]btime\[dq]: \[dq]2022-10-11T16:53:11Z\[dq],
    \[dq]content-type\[dq]: \[dq]text/plain; charset=utf-8\[dq],
    \[dq]mtime\[dq]: \[dq]2022-10-11T17:53:10.286745272+01:00\[dq],
    \[dq]owner\[dq]: \[dq]user1\[at]domain2.com\[dq],
    \[dq]permissions\[dq]: \[dq]...\[dq],
    \[dq]description\[dq]: \[dq]my nice file [migrated from domain1]\[dq],
    \[dq]starred\[dq]: \[dq]false\[dq]
  }
}
\f[R]
.fi.PP
فراداده‌ها را می‌توان در اینجا نیز حذف کرد.
.PP
یک برنامه نمونه پایتون برای پیاده‌سازی تبدیل‌های بالا می‌تواند چیزی شبیه به این باشد:
.IP
.nf
\f[C]
import sys, json

i = json.load(sys.stdin)
metadata = i[\[dq]Metadata\[dq]]
# Add tag to description
if \[dq]description\[dq] in metadata:
    metadata[\[dq]description\[dq]] += \[dq] [migrated from domain1]\[dq]
else:
    metadata[\[dq]description\[dq]] = \[dq][migrated from domain1]\[dq]
# Modify owner
if \[dq]owner\[dq] in metadata:
    metadata[\[dq]owner\[dq]] = metadata[\[dq]owner\[dq]].replace(\[dq]domain1.com\[dq], \[dq]domain2.com\[dq])
o = { \[dq]Metadata\[dq]: metadata }
json.dump(o, sys.stdout, indent=\[dq]\[rs]t\[dq])
\f[R]
.fi
.PP
می‌توانید این مثال را (کمی گسترش‌یافته‌تر) در کد منبع rclone در
bin/test_metadata_mapper.py (https://github.com/rclone/rclone/blob/master/bin/test_metadata_mapper.py) بیابید.
.PP
اگر می‌خواهید ورودی نگاشت‌کننده فراداده و خروجی بازگردانده‌شده از آن را در گزارش لاگ ببینید، می‌توانید از \f[V]-vv --dump mapper\f[R] استفاده کنید.
.PP
برای اطلاعات بیشتر، بخش metadata را ببینید.
.SS --metadata-set stringArray
.PP
مقدار را به صورت رشته‌ای در قالب \f[V]key=value\f[R] مشخص کنید تا هنگام بارگذاری، فراداده \f[V]key\f[R] با مقدار \f[V]value\f[R] افزوده شود.
این گزینه را می‌توان به هر تعداد دفعه که لازم است تکرار کرد.
برای اطلاعات بیشتر، بخش metadata را ببینید.
.SS --modify-window Duration
.PP
هنگام بررسی اینکه آیا فایلی تغییر یافته است یا خیر، این گزینه حداکثر اختلاف زمانی مجاز را تعیین می‌کند که فایلی می‌تواند داشته باشد و همچنان یکسان در نظر گرفته شود.
.PP
مقدار پیش‌فرض \f[V]1ns\f[R] است، مگر اینکه توسط یک ریموت لغو شود.
برای مثال OS X زمان‌های تغییر را تنها تا نزدیک‌ترین ثانیه ذخیره می‌کند، بنابراین اگر در حال خواندن و نوشتن روی یک سیستم فایل OS X هستید، این مقدار به‌طور پیش‌فرض \f[V]1s\f[R] خواهد بود.
.PP
این پرچم خط فرمان به شما اجازه می‌دهد آن مقدار پیش‌فرض محاسبه‌شده را لغو کنید.
.SS --multi-thread-write-buffer-size SizeSuffix
.PP
هنگام انتقال با چند رشته، rclone برای هر رشته تعداد بایت‌های مشخص‌شده را پیش از نوشتن روی دیسک، در حافظه بافر می‌کند.
.PP
این کار می‌تواند عملکرد را بهبود بخشد چنانچه سیستم فایل زیربنایی با تعداد زیادی نوشتن‌های کوچک در موقعیت‌های مختلف فایل به خوبی کنار نمی‌آید؛ بنابراین اگر متوجه شدید که سرعت انتقال به دلیل سرعت نوشتن دیسک محدود شده است، شاید بخواهید مقادیر مختلفی را آزمایش کنید.
به‌ویژه برای درایوهای مغناطیسی و سیستم‌های فایل ریموت، مقداری بالاتر می‌تواند مفید باشد.
.PP
با این حال، مقدار پیش‌فرض \f[V]128k\f[R] باید تقریباً برای همه کاربردها مناسب باشد، بنابراین پیش از تغییر آن مطمئن شوید که شبکه گلوگاه واقعی شما نباشد.
.PP
به عنوان یک نکته پایانی، اندازه تنها عامل نیست: اندازه بلوک (یا مفهوم مشابه) می‌تواند تأثیرگذار باشد.
در یک مورد، مشاهده کردیم که مضارب دقیق 16k بسیار بهتر از سایر مقادیر عمل کردند.
.SS --multi-thread-chunk-size SizeSuffix
.PP
به‌طور معمول اندازه تکه برای انتقال‌های چندرشته‌ای توسط بک‌اند تعیین می‌شود.
با این حال، برخی از بک‌اندها مانند \f[V]local\f[R] و \f[V]smb\f[R] (که \f[V]OpenWriterAt\f[R] را پیاده‌سازی می‌کنند اما \f[V]OpenChunkWriter\f[R] را خیر) اندازه تکه ذاتی ندارند.
.PP
در این حالت، از مقدار این گزینه استفاده می‌شود (پیش‌فرض 64Mi)..SS --multi-thread-cutoff SizeSuffix
.PP
هنگام انتقال فایل‌های با اندازه بیش از مقدار مشخص‌شده به backendهای دارای قابلیت، rclone برای انتقال فایل از چندین رشته (thread) استفاده می‌کند (پیش‌فرض 256M).
.PP
backendهای دارای قابلیت در بخش
نمای کلی (https://rclone.org/overview/#optional-features) با برچسب
\f[V]MultithreadUpload\f[R] مشخص شده‌اند.
(آن‌ها باید یکی از رابط‌های داخلی \f[V]OpenWriterAt\f[R] یا
\f[V]OpenChunkWriter\f[R] را پیاده‌سازی کنند).
در زمان نگارش این مستند، این موارد شامل \f[V]local\f[R]، \f[V]s3\f[R]،
\f[V]azureblob\f[R]، \f[V]b2\f[R]، \f[V]oracleobjectstorage\f[R] و
\f[V]smb\f[R] هستند.
.PP
روی دیسک محلی، rclone ابتدا فایل را پیش‌تخصیص (preallocate) می‌دهد (با استفاده از
\f[V]fallocate(FALLOC_FL_KEEP_SIZE)\f[R] در یونیکس یا
\f[V]NTSetInformationFile\f[R] در ویندوز که اجرای هر دوی آن‌ها زمانی نمی‌برد)،
سپس هر رشته مستقیماً در محل صحیح فایل می‌نویسد.
این بدان معناست که rclone فایل‌های تکه‌تکه‌شده (fragmented) یا تُنُک (sparse) ایجاد نخواهد کرد و
در پایان انتقال، هیچ زمانی صرف سرهم‌بندی فایل نخواهد شد.
.PP
تعداد رشته‌های مورد استفاده برای انتقال توسط
\f[V]--multi-thread-streams\f[R] کنترل می‌شود.
.PP
اگر مایلید اطلاعات مربوط به رشته‌ها را مشاهده کنید، از \f[V]-vv\f[R] استفاده نمایید.
.PP
این قابلیت با دستورهای sync (https://rclone.org/commands/rclone_sync)،
copy (https://rclone.org/commands/rclone_copy) و
move (https://rclone.org/commands/rclone_move) و همچنین دستورهای مشابه
copyto (https://rclone.org/commands/rclone_copyto) و
moveto (https://rclone.org/commands/rclone_moveto) کار می‌کند.
در صورتی که مقدار \f[V]--vfs-cache-mode\f[R] روی \f[V]writes\f[R] یا بالاتر تنظیم شده باشد،
انتقال‌های چندرشته‌ای در \f[V]rclone mount\f[R] و \f[V]rclone serve\f[R] نیز به کار گرفته خواهند شد.
.PP
بیشتر انتقال‌های چندرشته‌ای حافظه اضافی مصرف نمی‌کنند، اما برخی از آن‌ها چرا
(برای نمونه بارگذاری در s3).
در بدترین حالت، مصرف حافظه حداکثر می‌تواند برابر با \f[V]--transfers\f[R] *
\f[V]--multi-thread-chunk-size\f[R] * \f[V]--multi-thread-streams\f[R]
یا به‌طور خاص برای backend اس۳ برابر با \f[V]--transfers\f[R] *
\f[V]--s3-chunk-size\f[R] * \f[V]--s3-concurrency\f[R] باشد.
با این حال، می‌توانید از گزینه
--max-buffer-memory (https://rclone.org/docs/#max-buffer-memory) برای
کنترل حداکثر حافظه مصرفی در اینجا استفاده کنید.
.PP
\f[B]توجه:\f[R] این ویژگی \f[B]فقط\f[R] زمانی عمل می‌کند که مقصد از backendهای پشتیبانی‌شده باشد،
اما به عنوان مبدأ با هر backend کار خواهد کرد.
.PP
\f[B]توجه:\f[R] کپی‌های چندرشته‌ای برای حالت محلی به محلی (local to local) غیرفعال هستند
زیرا بدون آن سریع‌تر انجام می‌شوند، مگر اینکه
\f[V]--multi-thread-streams\f[R] به صورت صریح تنظیم شده باشد.
.PP
\f[B]توجه:\f[R] در ویندوز، استفاده از انتقال‌های چندرشته‌ای به دیسک محلی
باعث می‌شود فایل‌های خروجی به صورت
تُنُک (sparse) (https://en.wikipedia.org/wiki/Sparse_file) درآیند.
برای غیرفعال کردن فایل‌های تُنُک از \f[V]--local-no-sparse\f[R] استفاده کنید (که ممکن است باعث
تأخیرهای طولانی در ابتدای انتقال شود) یا با \f[V]--multi-thread-streams 0\f[R]
انتقال‌های چندرشته‌ای را غیرفعال نمایید.
.SS --multi-thread-streams int
.PP
هنگام استفاده از انتقال‌های چندرشته‌ای (به گزینه بالا
\f[V]--multi-thread-cutoff\f[R] مراجعه کنید) این گزینه تعداد جریان‌ها (streams) مورد استفاده را تنظیم می‌کند.
برای غیرفعال کردن انتقال‌های چندرشته‌ای مقدار را برابر \f[V]0\f[R] قرار دهید (پیش‌فرض 4).
.PP
اگر backend دارای تنظیمات \f[V]--backend-upload-concurrency\f[R] باشد (مانند
\f[V]--s3-upload-concurrency\f[R])، چنانچه مقدار آن بزرگ‌تر از
\f[V]--multi-thread-streams\f[R] باشد یا \f[V]--multi-thread-streams\f[R]
تعیین نشده باشد، به جای آن از این مقدار به عنوان تعداد انتقال‌ها استفاده خواهد شد.
.SS --name-transform stringArray
.PP
گزینه \f[V]--name-transform\f[R] امکان تبدیل نام مسیر را برای
دستورهای \f[V]rclone copy\f[R]، \f[V]rclone sync\f[R] و \f[V]rclone move\f[R] فراهم می‌کند.
این تبدیل‌ها تغییر نام فایل‌های مبدأ و مقصد را با اعمال پیشوندها، پسوندها و سایر دگرگونی‌ها در طول
عملیات انتقال امکان‌پذیر می‌سازند.
برای مشاهده مستندات جامع و مثال‌ها، ببینید:
\f[V]convmv\f[R] (https://rclone.org/commands/rclone_convmv).
.SS --no-check-dest
.PP
گزینه \f[V]--no-check-dest\f[R] می‌تواند همراه با \f[V]move\f[R] یا
\f[V]copy\f[R] استفاده شود و باعث می‌شود rclone در زمان کپی فایل‌ها مقصد را اصلاً بررسی نکند.
.PP
این بدان معناست که:
.IP \[bu] 2
فهرست فایل‌های مقصد خوانده نمی‌شود که فراخوانی‌های API را به حداقل می‌رساند
.IP \[bu] 2
فایل‌ها همیشه منتقل می‌شوند
.IP \[bu] 2
این امر می‌تواند در ریموت‌هایی که اجازه فایل تکراری می‌دهند (مانند
Google Drive) باعث ایجاد موارد هم‌نام و تکراری شود
.IP \[bu] 2
استفاده از \f[V]--retries 1\f[R] توصیه می‌شود، چرا که در غیر این صورت در صورت تلاش مجدد (retry)،
همه‌چیز دوباره منتقل خواهد شد
.PP
اگر مطمئن هستید هیچ‌یک از فایل‌ها در مقصد وجود ندارند، این پرچم برای به حداقل رساندن تراکنش‌ها بسیار کاربردی است.
.PP
این یک پرچم تخصصی است و بیشتر کاربران باید از آن صرف‌نظر کنند!.SS --no-gzip-encoding
.PP
سرآیند \f[V]Accept-Encoding: gzip\f[R] را تنظیم نمی‌کند.
این بدین معناست که rclone به‌طور خودکار از کارساز درخواست فایل‌های فشرده نخواهد کرد.
زمانی کاربرد دارد که کارساز را طوری تنظیم کرده باشید تا فایل‌ها را با
\f[V]Content-Encoding: gzip\f[R] برگرداند، اما خودتان فایل‌های فشرده بارگذاری کرده باشید.
.PP
در کارکرد عادی نیازی به تنظیم این گزینه نیست، و انجام آن
بازدهی انتقال شبکه rclone را کاهش می‌دهد.
.SS --no-traverse
.PP
پرچم \f[V]--no-traverse\f[R] کنترل می‌کند که آیا هنگام استفاده از دستورهای
\f[V]copy\f[R] یا \f[V]move\f[R]، سامانه فایل مقصد پیمایش شود یا خیر.
\f[V]--no-traverse\f[R] با \f[V]sync\f[R] سازگار نیست و در صورت ارائه به
همراه \f[V]sync\f[R] نادیده گرفته خواهد شد.
.PP
اگر تنها تعداد کمی از فایل‌ها را رونوشت می‌کنید (یا بیشتر فایل‌ها را فیلتر می‌کنید)
و/یا تعداد زیادی فایل در مقصد دارید، آنگاه \f[V]--no-traverse\f[R] مانع از
فهرست کردن مقصد توسط rclone شده و در زمان صرفه‌جویی می‌کند.
.PP
با این حال، اگر تعداد زیادی فایل را رونوشت می‌کنید، به‌ویژه در رونوشت‌هایی که
بسیاری از فایل‌های مد نظر تغییر نکرده‌اند و نیازی به رونوشت ندارند، نباید از
\f[V]--no-traverse\f[R] استفاده کنید.
.PP
برای نمونه‌ای از نحوه استفاده از آن، rclone copy (<https://rclone.org/commands/rclone_copy>) را
ببینید.
.SS --no-unicode-normalization
.PP
نویسه‌های یونیکد را در نام فایل‌ها در طول فرایند همگام‌سازی عادی‌سازی (normalize)
نکن.
.PP
گاهی اوقات یک سیستم‌عامل نام فایل‌های حاوی بخش‌های یونیکد را در شکل
تجزیه‌شده (decomposed) ذخیره می‌کند (به‌ویژه macOS).
برخی سامانه‌های ذخیره‌سازی ابری ممکن است سپس یونیکد را دوباره ترکیب (recompose) کنند،
که اگر داده‌ها مجدداً به سامانه فایل محلی رونوشت شوند، به ایجاد فایل‌های تکراری منجر می‌شود.
.PP
استفاده از این پرچم این قابلیت را غیرفعال کرده و با هر نویسه یونیکد به عنوان یک نویسه
یکتا رفتار می‌کند.
برای نمونه، به‌طور پیش‌فرض é و é به یک نویسه یکسان عادی‌سازی می‌شوند.
با \f[V]--no-unicode-normalization\f[R] با آن‌ها به عنوان نویسه‌های مجزا و یکتا
رفتار خواهد شد.
.SS --no-update-modtime
.PP
هنگام استفاده از این پرچم، rclone زمان تغییر (modification time) فایل‌های دوردست (remote)
را در صورت نادرست بودن، برخلاف حالت عادی به‌روزرسانی نخواهد کرد.
.PP
این پرچم می‌تواند زمانی استفاده شود که ریموت توسط ابزار دیگری نیز همگام‌سازی می‌شود
(برای نمونه، کلاینت Google Drive).
.SS --no-update-dir-modtime
.PP
هنگام استفاده از این پرچم، rclone زمان تغییر دایرکتوری‌های دوردست را در صورت نادرست
بودن، برخلاف حالت عادی به‌روزرسانی نخواهد کرد.
.SS --order-by string
.PP
پرچم \f[V]--order-by\f[R] ترتیبی را که فایل‌های موجود در صف انتظار (backlog)
در \f[V]rclone sync\f[R]، \f[V]rclone copy\f[R] و \f[V]rclone move\f[R]
پردازش می‌شوند، کنترل می‌کند.
.PP
رشته مرتب‌سازی به این صورت ساخته می‌شود.
بخش نخست معیاری را که اندازه‌گیری می‌شود توصیف می‌کند:
.IP \[bu] 2
\f[V]size\f[R] \- مرتب‌سازی بر اساس اندازه فایل‌ها
.IP \[bu] 2
\f[V]name\f[R] \- مرتب‌سازی بر اساس مسیر کامل فایل‌ها
.IP \[bu] 2
\f[V]modtime\f[R] \- مرتب‌سازی بر اساس تاریخ تغییر فایل‌ها
.PP
این مقدار می‌تواند یک اصلاح‌کننده داشته باشد که با یک ویرگول به آن پیوست می‌شود:
.IP \[bu] 2
\f[V]ascending\f[R] یا \f[V]asc\f[R] \- مرتب‌سازی به‌گونه‌ای که کوچک‌ترین (یا
قدیمی‌ترین) ابتدا پردازش شود
.IP \[bu] 2
\f[V]descending\f[R] یا \f[V]desc\f[R] \- مرتب‌سازی به‌گونه‌ای که بزرگ‌ترین (یا
جدیدترین) ابتدا پردازش شود
.IP \[bu] 2
\f[V]mixed\f[R] \- مرتب‌سازی به‌گونه‌ای که برای برخی رشته‌ها (threads) کوچک‌ترین ابتدا
پردازش شود و برای برخی دیگر بزرگ‌ترین
.PP
اگر اصلاح‌کننده \f[V]mixed\f[R] باشد، می‌تواند یک درصد اختیاری نیز داشته باشد
(که مقدار پیش‌فرض آن \f[V]50\f[R] است)، مانند:
\f[V]size,mixed,25\f[R] که بدین معناست ۲۵٪ از رشته‌ها باید کوچک‌ترین موارد و
۷۵٪ بزرگ‌ترین‌ها را بردارند.
رشته‌هایی که کوچک‌ترین را ابتدا برمی‌دارند همواره کوچک‌ترین را در اولویت قرار می‌دهند
و رشته‌های اولویت‌دهنده به بزرگ‌ترین‌ها نیز به همین ترتیب عمل می‌کنند.
حالت \f[V]mixed\f[R] می‌تواند برای به حداقل رساندن زمان انتقال هنگام انتقال ترکیبی
از فایل‌های بزرگ و کوچک مفید باشد \- فایل‌های بزرگ تضمین دریافت رشته‌های بارگذاری
و پهنای باند را دارند و فایل‌های کوچک به‌طور مداوم پردازش خواهند شد.
.PP
اگر هیچ اصلاح‌کننده‌ای ارائه نشود، ترتیب به‌صورت \f[V]ascending\f[R] خواهد بود.
.PP
برای نمونه:
.IP \[bu] 2
\f[V]--order-by size,desc\f[R] \- ابتدا بزرگ‌ترین فایل‌ها ارسال شوند
.IP \[bu] 2
\f[V]--order-by modtime,ascending\f[R] \- ابتدا قدیمی‌ترین فایل‌ها ارسال شوند
.IP \[bu] 2
\f[V]--order-by name\f[R] \- ابتدا فایل‌ها بر اساس ترتیب الفبایی مسیر ارسال شوند
.PP
اگر پرچم \f[V]--order-by\f[R] ارائه نشود یا با یک رشته خالی مشخص گردد،
از ترتیب پیش‌فرض استفاده خواهد شد که همان ترتیب اسکن است.
با \f[V]--checkers 1\f[R] این ترتیب بیشتر الفبایی است، اما با مقدار پیش‌فرض
\f[V]--checkers 8\f[R] تا حدی تصادفی خواهد بود..SS محدودیت‌ها (Limitations)
.PP
گزینهٔ \f[V]--order-by\f[R] یک پیمایش جداگانه روی داده‌ها انجام نمی‌دهد.
این بدان معناست که در شرایط زیر ممکن است برخی از فایل‌ها را خارج از ترتیب مشخص‌شده منتقل کند:
.IP \[bu] 2
هیچ فایلی در صف انتظار وجود نداشته باشد یا مبدأ هنوز به‌طور کامل پویش نشده باشد
.IP \[bu] 2
بیش از مقدار --max-backlog فایل در صف انتظار وجود داشته باشد
.PP
برنامهٔ rclone تمام تلاش خود را می‌کند تا مناسب‌ترین فایل در دسترس را منتقل کند، بنابراین در عمل این موضوع نباید مشکلی ایجاد نماید.
گزینهٔ \f[V]--order-by\f[R] را بیشتر به عنوان گزینه‌ای مبتنی بر «حداکثر تلاش» در نظر بگیرید تا ترتیبی بی‌نقص و قطعی.
.PP
اگر ترتیبی بی‌نقص می‌خواهید، باید --check-first را مشخص کنید که ابتدا پیش از انتقال هر فایلی، تمام فایل‌هایی را که نیاز به انتقال دارند می‌یابد.
.SS --partial-suffix string
.PP
هنگامی که از --inplace استفاده نمی‌شود، باعث می‌شود rclone از \f[V]--partial-suffix\f[R] به عنوان پسوند فایل‌های موقت استفاده کند.
.PP
محدودیت طول پسوند ۱۶ نویسه است.
.PP
مقدار پیش‌فرض \f[V].partial\f[R] است.
.SS --password-command SpaceSepList
.PP
این گزینه برنامه‌ای را مشخص می‌کند که هنگام اجرا گذرواژهٔ پیکربندی را ارائه می‌دهد.
این روش جایگزینی برای درخواست تعاملی گذرواژه توسط rclone یا تنظیم متغیر \f[V]RCLONE_CONFIG_PASS\f[R] است.
همچنین هنگام تنظیم گذرواژهٔ پیکربندی برای نخستین بار نیز به کار می‌رود.
.PP
آرگومان این گزینه باید دستوری به همراه فهرستی از آرگومان‌ها باشد که با فاصله از هم جدا شده‌اند.
اگر یکی از آرگومان‌ها شامل فاصله است، آن را داخل \f[V]\[dq]\f[R] قرار دهید؛ اگر می‌خواهید نویسهٔ صریح \f[V]\[dq]\f[R] را درون یک آرگومان قرار دهید، آن آرگومان را درون \f[V]\[dq]\f[R] محصور کرده و \f[V]\[dq]\f[R] را دو بار تکرار کنید.
برای اطلاعات بیشتر، کدگذاری CSV (<https://godoc.org/encoding/csv>) را ببینید.
.PP
برای مثال:
.IP
.nf
\f[C]
--password-command \[dq]echo hello\[dq]
--password-command \[aq]echo \[dq]hello with space\[dq]\[aq]
--password-command \[aq]echo \[dq]hello with \[dq]\[dq]quotes\[dq]\[dq] and space\[dq]\[aq]
\f[R]
.fi
.PP
توجه داشته باشید که هنگام تغییر گذرواژهٔ پیکربندی، متغیر محیطی \f[V]RCLONE_PASSWORD_CHANGE=1\f[R] تنظیم خواهد شد.
از این متغیر می‌توان برای تفکیک رمزگشایی اولیهٔ فایل پیکربندی از گذرواژهٔ جدید استفاده کرد.
.PP
برای اطلاعات بیشتر به بخش رمزنگاری پیکربندی (Configuration Encryption) مراجعه کنید.
.PP
یک مثال از Windows PowerShell را در ویکی (<https://github.com/rclone/rclone/wiki/Windows-Powershell-use-rclone-password-command-for-Config-file-password>) ببینید.
.SS -P, --progress
.PP
این گزینه باعث می‌شود rclone آمارها را در یک بلوک ثابت در ترمینال به‌روزرسانی کند و نمایی بی‌درنگ و هم‌زمان از فرایند انتقال ارائه دهد.
.PP
هرگونه پیام گزارش (log) در بالای این بلوک ثابت پیمایش خواهد شد.
پیام‌های گزارش، بلوک ثابت را به سمت پایین‌ترین بخش ترمینال می‌رانند تا در آنجا باقی بماند.
.PP
به‌طور معمول این وضعیت هر ۵۰۰ میلی‌ثانیه به‌روزرسانی می‌شود، اما این دورهٔ زمانی را می‌توان با گزینهٔ \f[V]--stats\f[R] لغو و بازنویسی کرد.
.PP
این گزینه می‌تواند برای داشتن نمایشی ساده‌تر به همراه گزینهٔ \f[V]--stats-one-line\f[R] استفاده شود.
.PP
برای تغییر طول نمایش نام فایل‌ها (متناسب با عرض‌های مختلف ترمینال)، گزینهٔ \f[V]--stats-file-name-length\f[R] را ببینید.
خروجی پیش‌فرض برای ترمینال‌هایی با عرض ۸۰ نویسه قالب‌بندی شده است.
.PP
نکته: در ویندوز تا زمانی که این باگ (<https://github.com/Azure/go-ansiterm/issues/26>) برطرف نشود، هنگام استفاده از \f[V]--progress\f[R] همهٔ نویسه‌های غیر ASCII با \f[V].\f[R] جایگزین خواهند شد..SS --progress-terminal-title
.PP
این پرچم، هنگام استفاده همراه با \f[V]-P/--progress\f[R]، رشتهٔ \f[V]ETA: %s\f[R] را در عنوان ترمینال چاپ خواهد کرد.
.SS -q, --quiet
.PP
این پرچم خروجی rclone را فقط به پیام‌های خطا محدود می‌کند.
.SS --refresh-times
.PP
پرچم \f[V]--refresh-times\f[R] می‌تواند برای به‌روزرسانی زمان ویرایش فایل‌های موجود، هنگامی که در بک‌اندهای فاقد پشتیبانی از هش ناهماهنگ هستند، استفاده شود.
.PP
این ویژگی زمانی مفید است که فایل‌ها را با برچسب‌های زمانی نادرست بارگذاری کرده‌اید و اکنون می‌خواهید آن‌ها را تصحیح کنید.
.PP
این پرچم \f[B]تنها\f[R] برای مقصدهایی مفید است که از هش پشتیبانی نمی‌کنند (مانند \f[V]crypt\f[R]).
.PP
این گزینه را می‌توان با هر یک از دستورهای همگام‌سازی
sync (https://rclone.org/commands/rclone_sync)،
copy (https://rclone.org/commands/rclone_copy) یا
move (https://rclone.org/commands/rclone_move) استفاده کرد.
.PP
برای استفاده از این پرچم باید همگام‌سازی بر اساس زمان ویرایش را انجام دهید (بنابراین نباید از \f[V]--size-only\f[R] یا \f[V]--checksum\f[R] استفاده کنید).
این پرچم در صورت استفاده از \f[V]--size-only\f[R] یا \f[V]--checksum\f[R] هیچ تأثیری نخواهد داشت.
.PP
اگر از این پرچم استفاده شود، هنگامی که rclone اقدام به بارگذاری فایلی می‌کند، وجود فایل مشابه در مقصد را بررسی خواهد کرد.
اگر اندازهٔ این فایل (و در صورت وجود، چِک‌سام آن) با منبع مطابقت داشته باشد اما برچسب زمانی متفاوتی داشته باشد، rclone به جای بارگذاری مجدد، برچسب زمانی را روی فایل مقصد به‌روزرسانی می‌کند.
اگر چِک‌سام مطابقت نداشته باشد، rclone فایل جدید را بارگذاری خواهد کرد.
اگر چِک‌سام وجود نداشته باشد (مانند یک بک‌اند \f[V]crypt\f[R])، rclone برچسب زمانی را به‌روزرسانی می‌کند.
.PP
توجه داشته باشید که برخی ریموت‌ها نمی‌توانند زمان ویرایش را بدون بارگذاری مجدد فایل تنظیم کنند، بنابراین این پرچم در آن‌ها چندان کاربردی ندارد.
.PP
به‌طور معمول، اگر در حال انجام همگام‌سازی بر اساس زمان ویرایش باشید، rclone بدون \f[V]--refresh-times\f[R] نیز زمان‌های ویرایش را به‌روزرسانی می‌کند، به شرطی که ریموت از چِک‌سام‌ها پشتیبانی کند \f[B]و\f[R] چِک‌سام‌های فایل مطابقت داشته باشند.
با این حال، اگر چِک‌سام‌ها موجود نباشند، rclone به جای تنظیم برچسب زمانی، فایل را بارگذاری خواهد کرد، زیرا این رفتار ایمن است.
.SS --retries int
.PP
در صورت بروز خطا، کل عملیات همگام‌سازی را به این تعداد دفعات مجدداً تکرار می‌کند (پیش‌فرض: ۳).
.PP
برخی ریموت‌ها ممکن است غیرقابل اعتماد باشند و چند بار تلاش مجدد کمک می‌کند فایل‌هایی که به دلیل خطا منتقل نشده‌اند، دوباره دریافت و منتقل شوند.
.PP
تلاش‌های مجدد را می‌توانید با \f[V]--retries 1\f[R] غیرفعال کنید.
.SS --retries-sleep Duration
.PP
فاصلهٔ زمانی بین هر بار تلاش مجدد مشخص‌شده توسط \f[V]--retries\f[R] را تعیین می‌کند.
.PP
پیش‌فرض \f[V]0\f[R] است.
برای غیرفعال کردن از \f[V]0\f[R] استفاده کنید.
.SS --server-side-across-configs
.PP
اجازه می‌دهد عملیات‌های سمت سرور (مانند copy یا move) بین پیکربندی‌های مختلف کار کنند.
.PP
این گزینه زمانی مفید است که بخواهید یک copy یا move سمت سرور را بین دو ریموت که از یک بک‌اند یکسان استفاده می‌کنند اما به روش متفاوتی پیکربندی شده‌اند، انجام دهید.
.PP
توجه داشته باشید که این ویژگی به‌طور پیش‌فرض فعال نیست، زیرا برای rclone آسان نیست که تشخیص دهد آیا این عملیات بین هر دو پیکربندی دلخواه کار خواهد کرد یا خیر.
.SS --size-only
.PP
به‌طور معمول rclone برای بررسی یکسان بودن فایل‌ها، زمان ویرایش و اندازهٔ آن‌ها را بررسی می‌کند.
اگر این پرچم را تنظیم کنید، rclone تنها اندازه را بررسی خواهد کرد.
.PP
این گزینه هنگام انتقال فایل‌ها از Dropbox که توسط کلاینت دسکتاپ تغییر یافته‌اند و چِک‌سام‌ها یا زمان‌های ویرایش را همانند rclone تنظیم نمی‌کند، می‌تواند مفید باشد..SS --stats Duration
.PP
دستوراتی که داده انتقال می‌دهند
(sync (https://rclone.org/commands/rclone_sync)،
copy (https://rclone.org/commands/rclone_copy)،
copyto (https://rclone.org/commands/rclone_copyto)،
move (https://rclone.org/commands/rclone_move)،
moveto (https://rclone.org/commands/rclone_moveto)) آمار انتقال داده را در بازه‌های زمانی منظم برای نمایش پیشرفت چاپ می‌کنند.
.PP
این گزینه بازه زمانی را تنظیم می‌کند.
.PP
مقدار پیش‌فرض \f[V]1m\f[R] است.
برای غیرفعال کردن از \f[V]0\f[R] استفاده کنید.
.PP
اگر بازه زمانی آمار را تنظیم کنید، همه دستورات می‌توانند آمار را نمایش دهند.
این قابلیت هنگام اجرای دستورات دیگر، مانند \f[V]check\f[R] یا
\f[V]mount\f[R]، می‌تواند مفید باشد.
.PP
آمارها به‌طور پیش‌فرض در سطح \f[V]INFO\f[R] ثبت می‌شوند که به این معنی است در سطح لاگ پیش‌فرض یعنی \f[V]NOTICE\f[R] نمایش داده نخواهند شد.
برای نمایش آن‌ها از \f[V]--stats-log-level NOTICE\f[R] یا \f[V]-v\f[R] استفاده کنید.
برای اطلاعات بیشتر درباره سطوح لاگ، بخش گزارش‌گیری (logging) را ببینید.
.PP
توجه داشته باشید که در macOS می‌توانید یک سیگنال SIGINFO (که معمولاً در ترمینال با ctrl-T ارسال می‌شود) بفرستید تا آمار بلافاصله چاپ شود.
.SS --stats-file-name-length int
.PP
به‌طور پیش‌فرض، خروجی \f[V]--stats\f[R] نام فایل‌ها و مسیرهای طولانی‌تر از ۴۰ نویسه را کوتاه می‌کند.
این رفتار معادل ارائه \f[V]--stats-file-name-length 40\f[R] است.
برای غیرفعال کردن هرگونه کوتاه‌سازی نام فایل‌های چاپ‌شده توسط آمار، از \f[V]--stats-file-name-length 0\f[R] استفاده کنید.
.SS --stats-log-level LogLevel
.PP
سطح گزارش‌گیری برای نمایش خروجی \f[V]--stats\f[R].
این مقدار می‌تواند \f[V]DEBUG\f[R]، \f[V]INFO\f[R]، \f[V]NOTICE\f[R] یا
\f[V]ERROR\f[R] باشد.
پیش‌فرض \f[V]INFO\f[R] است.
این بدان معناست که در سطح پیش‌فرض وقایع‌نگاری، یعنی \f[V]NOTICE\f[R]،
آمار نمایش داده نمی‌شود \- اگر می‌خواهید نمایش داده شود از
\f[V]--stats-log-level NOTICE\f[R] استفاده کنید.
برای جزئیات بیشتر درباره سطوح وقایع‌نگاری، بخش logging را ببینید.
.SS --stats-one-line
.PP
هنگامی که این گزینه مشخص شود، rclone آمار را در یک خط خلاصه کرده و تنها مهم‌ترین آمارها را نمایش می‌دهد.
.SS --stats-one-line-date
.PP
هنگامی که این گزینه مشخص شود، rclone آمار تک‌خطی را فعال کرده و یک رشته تاریخ را در ابتدای نمایش قرار می‌دهد.
پیش‌فرض \f[V]2006/01/02 15:04:05 -\f[R] است.
.SS --stats-one-line-date-format string
.PP
هنگامی که این گزینه مشخص شود، rclone آمار تک‌خطی را فعال کرده و یک رشته تاریخ دلخواه ارائه‌شده توسط کاربر را در ابتدای نمایش قرار می‌دهد.
رشته تاریخ حتماً باید داخل گیومه قرار گیرد.
برای نحو قالب‌بندی تاریخ از مشخصات golang (https://golang.org/pkg/time/#Time.Format) پیروی کنید.
.SS --stats-unit string
.PP
به‌طور پیش‌فرض، نرخ‌های انتقال داده بر حسب بایت بر ثانیه چاپ می‌شوند که معادل \f[V]--stats-unit bytes\f[R] است.
.PP
این گزینه با مشخص کردن \f[V]--stats-unit bits\f[R]، امکان چاپ نرخ داده بر حسب بیت بر ثانیه را فراهم می‌کند.
حجم داده منتقل‌شده همچنان بر حسب بایت گزارش خواهد شد.
.PP
نرخ انتقال بر پایه واحد دودویی (باینری) گزارش می‌شود، نه واحد SI.
بنابراین 1 Mbit/s برابر با ۱٬۰۴۸٬۵۷۶ bit/s است و نه ۱٬۰۰۰٬۰۰۰ bit/s.
.SS --suffix string
.PP
هنگام استفاده از sync (https://rclone.org/commands/rclone_sync)،
copy (https://rclone.org/commands/rclone_copy) یا
move (https://rclone.org/commands/rclone_move)، پسوند مشخص‌شده به هر فایلی که ممکن بود بازنویسی یا حذف شود اضافه خواهد شد.
اگر فایلی با همان مسیر (پس از اضافه شدن پسوند) از قبل وجود داشته باشد، بازنویسی خواهد شد.
.PP
ریموت مورد استفاده باید از move یا copy سمت سرور پشتیبانی کند و باید از همان ریموت به عنوان مقصد sync استفاده کنید.
.PP
این گزینه برای استفاده با فایل‌ها جهت اضافه کردن پسوند در دایرکتوری جاری یا به همراه \f[V]--backup-dir\f[R] کاربرد دارد.
برای اطلاعات بیشتر \f[V]--backup-dir\f[R] را ببینید.
.PP
برای مثال
.IP
.nf
\f[C]
rclone copy --interactive /path/to/local/file remote:current --suffix .bak
\f[R]
.fi
.PP
فایل‌های \f[V]/path/to/local\f[R] را در \f[V]remote:current\f[R] کپی می‌کند، اما به انتهای نام هر فایلی که قرار بود به‌روزرسانی یا حذف شود، پسوند .bak را اضافه می‌کند.
.PP
اگر از \f[V]rclone sync\f[R] به همراه \f[V]--suffix\f[R] و بدون \f[V]--backup-dir\f[R] استفاده می‌کنید، توصیه می‌شود یک قاعده فیلتر برای مستثنی کردن پسوند قرار دهید؛ در غیر این صورت دستور \f[V]sync\f[R] فایل‌های پشتیبان را حذف خواهد کرد.
.IP
.nf
\f[C]
rclone sync --interactive /path/to/local/file remote:current --suffix .bak --exclude \[dq]*.bak\[dq]
\f[R]
.fi.SS --suffix-keep-extension
.PP
هنگام استفاده از \f[V]--suffix\f[R]، فعال‌سازی این گزینه باعث می‌شود rclone پسوند تعیین‌شده توسط SUFFIX را به جای بعد از پسوند فایل‌های پشتیبان‌گیری شده، قبل از پسوند آن‌ها قرار دهد.
.PP
بنابراین فرض کنید از \f[V]--suffix -2019-01-01\f[R] استفاده کنیم؛ بدون این پرچم، از \f[V]file.txt\f[R] با نام \f[V]file.txt-2019-01-01\f[R] پشتیبان گرفته می‌شود و با این پرچم به \f[V]file-2019-01-01.txt\f[R] پشتیبان‌گیری خواهد شد.
این ویژگی می‌تواند برای اطمینان از اینکه فایل‌های دارای پسوند کمکی همچنان باز می‌شوند، مفید باشد.
.PP
اگر فایلی دو (یا چند) پسوند داشته باشد و دومین (یا پسوند بعدی) به عنوان یک نوع MIME معتبر شناخته شود، پسوند پشتیبان قبل از آن پسوند قرار خواهد گرفت.
بنابراین از \f[V]file.tar.gz\f[R] به صورت \f[V]file-2019-01-01.tar.gz\f[R] پشتیبان‌گیری می‌شود، در حالی که \f[V]file.badextension.gz\f[R] به صورت \f[V]file.badextension-2019-01-01.gz\f[R] ذخیره خواهد شد.
.SS --syslog
.PP
در سیستم‌عامل‌های پشتیبانی‌کننده (به‌جز Windows یا Plan9)، تمام خروجی لاگ‌ها را به syslog ارسال می‌کند.
.PP
این گزینه می‌تواند برای اجرای rclone درون یک اسکریپت یا هنگام استفاده از \f[V]rclone mount\f[R] مفید باشد.
.SS --syslog-facility string
.PP
در صورت استفاده از \f[V]--syslog\f[R]، این گزینه بخش لاگ‌اندازی (syslog facility) مانند \f[V]KERN\f[R] یا \f[V]USER\f[R] را مشخص می‌کند.
برای مشاهده فهرست گزینه‌های ممکن، \f[V]man syslog\f[R] را ببینید.
بخش پیش‌فرض \f[V]DAEMON\f[R] است.
.SS --temp-dir string
.PP
دایرکتوری مورد استفاده rclone برای فایل‌های موقت را مشخص می‌کند تا جایگزین مقدار پیش‌فرض شود.
مطمئن شوید که دایرکتوری وجود دارد و مجوزهای دسترسی لازم را داراست.
.PP
به طور پیش‌فرض، دایرکتوری موقت سیستم‌عامل استفاده خواهد شد:
.IP \[bu] 2
در سیستم‌های یونیکس، اگر \f[V]$TMPDIR\f[R] خالی نباشد از آن، وگرنه از \f[V]/tmp\f[R].
.IP \[bu] 2
در ویندوز، نخستین مقدار غیرخالی از میان \f[V]%TMP%\f[R]، \f[V]%TEMP%\f[R]، \f[V]%USERPROFILE%\f[R]، یا دایرکتوری ویندوز.
.PP
هنگامی که مقدار پیش‌فرض با این گزینه بازنویسی شود، مسیر مشخص‌شده به عنوان مقدار متغیر محیطی \f[V]TMPDIR\f[R] در سیستم‌های یونیکس و \f[V]TMP\f[R] و \f[V]TEMP\f[R] در ویندوز تنظیم خواهد شد.
.PP
می‌توانید از دستور config paths (https://rclone.org/commands/rclone_config_paths) برای مشاهده مقدار فعلی استفاده کنید.
.SS --tpslimit float
.PP
تعداد تراکنش‌ها در ثانیه را به این مقدار محدود می‌کند.
مقدار پیش‌فرض 0 است که به معنای تراکنش نامحدود در ثانیه است.
.PP
یک تراکنش تقریباً به عنوان یک فراخوانی API تعریف می‌شود؛ مفهوم دقیق آن به بک‌اند بستگی دارد.
برای بک‌اندهای مبتنی بر HTTP، شامل یک درخواست مانند HTTP PUT/GET/POST و پاسخ آن است.
برای FTP/SFTP، یک تراکنش رفت و برگشتی بر روی پروتکل TCP است.
.PP
برای مثال، جهت محدود کردن rclone به ۱۰ تراکنش در هر ثانیه از \f[V]--tpslimit 10\f[R]، یا برای ۱ تراکنش در هر ۲ ثانیه از \f[V]--tpslimit 0.5\f[R] استفاده کنید.
.PP
زمانی از این گزینه استفاده کنید که تعداد تراکنش‌های rclone در هر ثانیه باعث بروز مشکل در ارائه‌دهنده فضای ذخیره‌سازی ابری شود (برای مثال، منجر به مسدود شدن یا محدودیت نرخ/rate limit گردد).
.PP
این گزینه می‌تواند هنگام اجرای \f[V]rclone mount\f[R] جهت کنترل رفتار برنامه‌های مصرف‌کننده بسیار مفید باشد.
.PP
این محدودیت روی تمامی بک‌اندهای مبتنی بر HTTP و همچنین بک‌اندهای FTP و SFTP اعمال می‌شود.
بر روی بک‌اند محلی (local) یا بک‌اند Storj اعمال نخواهد شد.
.PP
همچنین \f[V]--tpslimit-burst\f[R] را ببینید.
.SS --tpslimit-burst int
.PP
حداکثر جهش ناگهانی (burst) تراکنش‌ها برای \f[V]--tpslimit\f[R] (پیش‌فرض \f[V]1\f[R]).
.PP
به طور معمول \f[V]--tpslimit\f[R] دقیقاً همان تعداد تراکنش در ثانیه تعیین‌شده را انجام می‌دهد.
اما اگر \f[V]--tps-burst\f[R] را تعیین کنید، rclone می‌تواند تعدادی از تراکنش‌های استفاده‌نشده در زمان بی‌کاری را ذخیره کند و جهشی تا سقف مقدار ارائه‌شده ایجاد نماید.
.PP
برای مثال اگر \f[V]--tpslimit-burst 10\f[R] را تعیین کنید، چنانچه rclone برای مدتی بیش از 10*\f[V]--tpslimit\f[R] بی‌کار مانده باشد، می‌تواند ۱۰ تراکنش را بسیار سریع پیش از اینکه دوباره محدود شوند، به انجام برساند.
.PP
این ویژگی برای افزایش کارایی \f[V]--tpslimit\f[R] بدون تغییر میانگین بلندمدت تعداد تراکنش‌ها در ثانیه به کار می‌رود..SS --track-renames
.PP
به‌طور پیش‌فرض، rclone تغییر نام فایل‌ها را دنبال نمی‌کند؛ بنابراین اگر نام یک فایل را به‌صورت محلی تغییر دهید و سپس آن را در یک ریموت همگام‌سازی کنید، rclone فایل قدیمی را در ریموت حذف کرده و نسخه جدیدی را بارگذاری می‌کند.
.PP
یک همگام‌سازی rclone با گزینه \f[V]--track-renames\f[R] مانند یک همگام‌سازی عادی اجرا می‌شود، اما اشیایی را که در مقصد وجود دارند ولی در مبدأ نیستند (که معمولاً حذف می‌شوند) و اشیایی را که در مبدأ وجود دارند ولی در مقصد نیستند (که معمولاً منتقل می‌شوند) ره‌گیری می‌کند. این اشیاء سپس نامزد تغییر نام در نظر گرفته می‌شوند.
.PP
پس از همگام‌سازی، rclone اشیاء فقط-مبدأ و فقط-مقصد را با استفاده از \f[V]--track-renames-strategy\f[R] مشخص‌شده مطابقت می‌دهد و یا نام شیء مقصد را تغییر می‌دهد یا شیء مبدأ را منتقل کرده و شیء مقصد را حذف می‌کند.
گزینه \f[V]--track-renames\f[R] مانند تمام همگام‌سازی‌های rclone بدون وضعیت (stateless) است.
.PP
برای استفاده از این پرچم، مقصد باید از کپی سمت سرور (server-side copy) یا انتقال سمت سرور (server-side move) پشتیبانی کند، و برای استفاده از یک \f[V]--track-renames-strategy\f[R] مبتنی بر هش (پیش‌فرض)، مبدأ و مقصد باید هش سازگار داشته باشند.
.PP
اگر مقصد از کپی یا انتقال سمت سرور پشتیبانی نکند، rclone به رفتار پیش‌فرض بازمی‌گردد و پیامی در سطح خطا (error) در کنسول ثبت می‌کند.
.PP
در صورتی که \f[V]--track-renames-strategy\f[R] شامل \f[V]hash\f[R] باشد، مقصدهای رمزنگاری‌شده در حال حاضر توسط \f[V]--track-renames\f[R] پشتیبانی نمی‌شوند.
.PP
توجه داشته باشید که \f[V]--track-renames\f[R] با \f[V]--no-traverse\f[R] ناسازگار است و برای ره‌گیری تمام گزینه‌های نامزد تغییر نام، حافظه اضافی مصرف می‌کند.
.PP
همچنین توجه داشته باشید که \f[V]--track-renames\f[R] با \f[V]--delete-before\f[R] ناسازگار است و به جای \f[V]--delete-during\f[R]، گزینه \f[V]--delete-after\f[R] را انتخاب خواهد کرد.
.SS --track-renames-strategy string
.PP
این گزینه معیارهای تطبیق فایل را برای \f[V]--track-renames\f[R] تغییر می‌دهد.
.PP
تطبیق توسط مجموعه‌ای از این نشانه‌ها که با ویرگول از هم جدا شده‌اند کنترل می‌شود:
.IP \[bu] 2
\f[V]modtime\f[R] \- زمان تغییر فایل \- در همه بک‌اندها پشتیبانی نمی‌شود
.IP \[bu] 2
\f[V]hash\f[R] \- هش محتوای فایل \- در همه بک‌اندها پشتیبانی نمی‌شود
.IP \[bu] 2
\f[V]leaf\f[R] \- نام فایل بدون احتساب نام پوشه آن
.IP \[bu] 2
\f[V]size\f[R] \- اندازه فایل (این معیار همیشه فعال است)
.PP
گزینه پیش‌فرض \f[V]hash\f[R] است.
.PP
استفاده از \f[V]--track-renames-strategy modtime,leaf\f[R] فایل‌ها را تنها بر اساس زمان تغییر، نام فایل (leaf) و اندازه مطابقت می‌دهد.
.PP
استفاده از \f[V]--track-renames-strategy modtime\f[R] یا \f[V]leaf\f[R] می‌تواند پشتیبانی از \f[V]--track-renames\f[R] را برای مقصدهای رمزنگاری‌شده فعال کند.
.PP
توجه داشته باشید که راهبرد \f[V]hash\f[R] در مقصدهای رمزنگاری‌شده پشتیبانی نمی‌شود.
.SS --delete-(before,during,after)
.PP
این گزینه به شما امکان می‌دهد مشخص کنید هنگام همگام‌سازی پوشه‌ها، فایل‌های موجود در مقصد در چه زمانی حذف شوند.
.PP
مشخص کردن مقدار \f[V]--delete-before\f[R]، تمام فایل‌های موجود در مقصد که در مبدأ نیستند را \f[I]پیش از\f[R] شروع انتقال فایل‌های جدید یا به‌روزشده حذف می‌کند.
این حالت دو گذر در سیستم‌های فایل انجام می‌دهد؛ یکی برای حذف‌ها و دیگری برای کپی‌ها.
.PP
مشخص کردن \f[V]--delete-during\f[R] فایل‌ها را حین بررسی و بارگذاری فایل‌ها حذف می‌کند.
این سریع‌ترین گزینه است و کمترین حافظه را مصرف می‌کند.
.PP
مشخص کردن \f[V]--delete-after\f[R] (مقدار پیش‌فرض)، حذف فایل‌ها را تا زمانی که همه فایل‌های جدید/به‌روزشده با موفقیت منتقل شوند به تعویق می‌اندازد.
فایل‌هایی که باید حذف شوند در مرحله کپی جمع‌آوری شده و پس از تکمیل موفقیت‌آمیز مرحله کپی حذف می‌گردند.
فایل‌های حذف‌شدنی در حافظه نگه داشته می‌شوند، بنابراین این حالت ممکن است حافظه بیشتری مصرف کند.
این امن‌ترین حالت است، زیرا فایل‌ها را تنها در صورتی حذف می‌کند که پیش از آن هیچ خطایی رخ نداده باشد.
اگر پیش از شروع حذف‌ها خطایی رخ داده باشد، پیام \f[V]not deleting files as there were IO errors\f[R] را دریافت خواهید کرد..SS --fast-list
.PP
هنگام انجام هر کاری که نیازمند فهرست‌گیری دایرکتوری است (برای نمونه
\f[V]sync\f[R]، \f[V]copy\f[R]، \f[V]ls\f[R] \- و در واقع تقریباً هر
دستور دیگری)، rclone راهبردهای متفاوتی برای انتخاب در پیش دارد.
.PP
راهبرد پایه‌ای این است که یک دایرکتوری را فهرست کرده و آن را پیش از
استفاده از فهرست‌گیری‌های بیشتر برای پردازش هر زیردایرکتوری، پردازش می‌کند.
این یک ویژگی اجباری در backend است که \f[V]List\f[R] نامیده می‌شود، به این
معنی که توسط همهٔ backendها پشتیبانی می‌شود.
این راهبرد حافظهٔ کمی مصرف می‌کند و از آنجا که قابلیت موازی‌سازی دارد، برای
عملیاتی که پردازش نتایج فهرست را در بر دارند سریع است.
.PP
برخی backendها از یک راهبرد جایگزین پشتیبانی می‌کنند که در آن همهٔ فایل‌های
موجود در زیر یک دایرکتوری را می‌توان در یک (یا تعداد کمی) تراکنش فهرست کرد.
نرم‌افزار rclone از این راهبرد جایگزین از طریق یک ویژگی اختیاری backend با نام
\f[V]ListR\f[R] (https://rclone.org/overview/#listr) پشتیبانی می‌کند.
می‌توانید در بخش ویژگی‌های اختیاری مستندات نمای کلی سیستم‌های ذخیره‌سازی
(https://rclone.org/overview/#optional-features) ببینید که این قابلیت برای
کدام backendها فعال است (این‌ها معمولاً موارد مبتنی بر باکت مانند
S3، B2، GCS و Swift هستند).
این راهبرد برای عملیات عمیقاً بازگشتی به تراکنش‌های کمتری نیاز دارد، که در
backendهایی که بابت این تراکنش‌ها هزینه دریافت می‌کنند یا محدودیت شدید نرخ درخواست دارند
بسیار حائز اهمیت است.
بسته به متغیرهای گوناگون، ممکن است سریع‌تر باشد (به دلیل تراکنش‌های کمتر) یا
کندتر (چون قابل موازی‌سازی نیست)، و اگر rclone ناچار باشد کل فهرست را در
حافظه نگه دارد، ممکن است حافظهٔ بیشتری بطلبد.
.PP
این‌که rclone کدام راهبرد فهرست‌گیری را برای یک عملیات مشخص انتخاب می‌کند
پیچیده است، اما به طور کلی سعی می‌کند بهترین گزینهٔ ممکن را برگزیند.
در شرایطی که نیازی به ذخیرهٔ فایل‌های فهرست‌شده در حافظه نباشد، مثلاً
برای انواع بازگشتی نامحدود دستور \f[V]ls\f[R]، اولویت را به \f[V]ListR\f[R]
می‌دهد.
در موقعیت‌های دیگر، اولویت را به \f[V]List\f[R] می‌دهد، مثلاً
برای \f[V]sync\f[R] و \f[V]copy\f[R] که نیاز دارد فایل‌های فهرست‌شده را
در حافظه نگه دارد، و در حال انجام عملیاتی روی آن‌هاست که موازی‌سازی می‌تواند
یک مزیت بسیار بزرگ باشد.
.PP
برنامهٔ rclone قادر نیست تمام پارامترهای مرتبط را برای تصمیم‌گیری دربارهٔ بهترین
راهبرد لحاظ کند، و بنابراین به شما امکان می‌دهد به دو شیوه بر این انتخاب اثر
بگذارید: می‌توانید با استفاده از گزینهٔ \f[V]--disable ListR\f[R] و غیرفعال کردن
این ویژگی از به‌کارگیری \f[V]ListR\f[R] جلوگیری کنید، یا با استفاده از گزینهٔ
\f[V]--fast-list\f[R] به rclone اجازه دهید تا در مواردی که معمولاً به دلیل
مصرف حافظهٔ بالاتر این کار را نمی‌کرد، از \f[V]ListR\f[R] استفاده کند.
برنامهٔ rclone در هر دو حالت باید همواره نتایج یکسانی ایجاد کند.
استفاده از \f[V]--disable ListR\f[R] یا \f[V]--fast-list\f[R] بر روی یک
remote که از \f[V]ListR\f[R] پشتیبانی نمی‌کند هیچ اثری ندارد؛ rclone صرفاً
آن را نادیده می‌گیرد.
.PP
یک قاعدهٔ سرانگشتی این است که اگر بابت تراکنش‌ها هزینه پرداخت می‌کنید و می‌توانید
کل فهرست همگام‌سازی را در حافظه جای دهید، استفاده از \f[V]--fast-list\f[R]
توصیه می‌شود.
اگر همگام‌سازی بسیار بزرگی در پیش دارید، از \f[V]--fast-list\f[R] استفاده نکنید،
چرا که در غیر این صورت با کمبود حافظه مواجه خواهید شد.
پیش از تصمیم‌گیری چند آزمایش انجام دهید و مقایسه کنید، و در صورت تردید فقط مقدار
پیش‌فرض را به حال خود رها کنید تا rclone خود تصمیم بگیرد؛ یعنی از
\f[V]--fast-list\f[R] استفاده نکنید.
.SS --timeout Duration
.PP
مهلت زمانی بی‌کاری (idle timeout) ورودی/خروجی (IO) را تعیین می‌کند.
اگر یک انتقال آغاز شود اما برای این مدت زمان مشخص بی‌کار بماند، اتصال
قطع‌شده و آسیب‌دیده تلقی می‌شود.
.PP
مقدار پیش‌فرض \f[V]5m\f[R] است.
برای غیرفعال کردن آن را روی \f[V]0\f[R] تنظیم کنید.
.SS --transfers int
.PP
تعداد انتقال فایل‌ها که به صورت موازی اجرا می‌شوند.
گاهی اگر remote خطاهای مهلت زمانی (timeout) زیادی می‌دهد، تنظیم این گزینه روی
یک عدد کوچک‌تر می‌تواند مفید باشد، یا اگر پهنای باند زیاد و یک remote سریع
در اختیار دارید، می‌توانید آن را به عدد بزرگ‌تری افزایش دهید.
.PP
حالت پیش‌فرض، اجرای ۴ انتقال فایل به صورت هم‌روند است.
.PP
اگر می‌خواهید انتقال‌های هر فایل را به صورت تکی کنترل کنید، به
--multi-thread-streams نگاهی بیندازید.
.SS -u, --update
.PP
این گزینه rclone را وادار می‌کند تا از هر فایلی که در مقصد وجود دارد و
زمان ویرایش آن جدیدتر از فایل مبدأ است، صرف‌نظر کند.
.PP
این قابلیت می‌تواند در جلوگیری از انتقال‌های غیرضروری هنگام انتقال به یک remote که
مستقیماً از زمان‌های ویرایش پشتیبانی نمی‌کند (یا هنگام استفاده از
\f[V]--use-server-modtime\f[R] برای اجتناب از فراخوانی‌های اضافی API) بسیار مفید باشد،
چرا که این شیوه دقیق‌تر از بررسی با \f[V]--size-only\f[R] و سریع‌تر از
استفاده از \f[V]--checksum\f[R] است.
روی چنین remoteهایی (یا هنگام استفاده از \f[V]--use-server-modtime\f[R]) زمانی
که بررسی می‌شود، زمان بارگذاری (upload) خواهد بود.
.PP
اگر یک فایل موجود در مقصد زمان ویرایشی قدیمی‌تر از فایل مبدأ داشته باشد، در
صورت متفاوت بودن اندازه‌ها به‌روزرسانی خواهد شد.
اگر اندازه‌ها یکسان باشند، در صورتی که چکسام متفاوت باشد یا در دسترس نباشد،
به‌روزرسانی انجام می‌گیرد.
.PP
اگر یک فایل موجود در مقصد زمان ویرایشی برابر (در محدودهٔ پنجرهٔ ویرایش
محاسبه‌شده) با فایل مبدأ داشته باشد، در صورت تفاوت در اندازه‌ها به‌روزرسانی
خواهد شد.
در این حالت چکسام بررسی نخواهد شد مگر اینکه پرچم \f[V]--checksum\f[R]
ارائه شده باشد.
.PP
در تمام موارد دیگر، فایل به‌روزرسانی نخواهد شد.
.PP
برای backendهایی که از زمان ویرایش پشتیبانی نکرده و در عوض از زمان‌های بارگذاری
استفاده می‌کنند، به‌کارگیری پرچم \f[V]--modify-window\f[R] را برای جبران
انحراف زمانی (time skew) میان مبدأ و backend در نظر داشته باشید.
با این حال، اگر backend از چکسام پشتیبانی نمی‌کند، توجه داشته باشید که همگام‌سازی
یا کپی در پنجرهٔ انحراف زمانی ممکن است به جهت ایمنی همچنان منجر به انتقال‌های اضافی شود..SS --use-mmap
.PP
اگر این پرچم تنظیم شود، rclone از حافظهٔ ناشناسی (anonymous memory) که توسط mmap در بسترهای مبتنی بر Unix و توسط VirtualAlloc در Windows تخصیص یافته است، برای بافرهای انتقال خود استفاده می‌کند (اندازه توسط \f[V]--buffer-size\f[R] کنترل می‌شود).
حافظه‌ای که بدین شکل تخصیص داده می‌شود وارد هیپ (heap) مربوط به Go نمی‌شود و پس از پایان کار می‌تواند بلافاصله به سیستم‌عامل بازگردانده شود.
.PP
اگر این پرچم تنظیم نشود، rclone بافرها را با استفاده از تخصیص‌دهندهٔ حافظهٔ Go تخصیص داده و آزاد می‌کند که ممکن است حافظهٔ بیشتری مصرف کند، زیرا صفحات حافظه با سماجت کمتری به سیستم‌عامل پس داده می‌شوند.
.PP
ممکن است این قابلیت روی همهٔ بسترها به‌خوبی کار نکند، از این رو به‌طور پیش‌فرض غیرفعال است؛ در آینده ممکن است به‌صورت پیش‌فرض فعال شود.
.SS --use-server-modtime
.PP
برخی از بک‌اندهای ذخیره‌سازی شیء (مانند Swift و S3) زمان تغییر فایل (modtime) را حفظ نمی‌کنند.
در این بک‌اندها، rclone زمان تغییر اصلی را به‌صورت فرادادهٔ اضافی روی شیء ذخیره می‌کند.
به‌طور پیش‌فرض، هنگامی که یک عملیات به modtime نیاز داشته باشد، یک فراخوانی API برای بازیابی فراداده انجام می‌دهد.
.PP
از این پرچم برای غیرفعال کردن فراخوانی اضافی API و تکیه بر زمان تغییر سرور استفاده کنید.
در مواردی مانند همگام‌سازی از مبدأ محلی به مقصد دوردست با استفاده از \f[V]--update\f[R]، دانستن اینکه فایل محلی جدیدتر از زمان آخرین بارگذاری آن به سرور دوردست است کفایت می‌کند.
در این موارد، این پرچم می‌تواند روند کار را سرعت بخشیده و تعداد فراخوانی‌های ضروری API را کاهش دهد.
.PP
این پرچم تنها روی برخی از بک‌اندها پشتیبانی می‌شود و در بک‌اندهای پشتیبانی‌نشده در سکوت نادیده گرفته خواهد شد.
بک‌اندهای پشتیبانی‌شده شامل \f[V]azureblob\f[R]، \f[V]oracleobjectstorage\f[R]، \f[V]s3\f[R] و \f[V]swift\f[R] هستند.
.PP
استفاده از این پرچم در یک عملیات همگام‌سازی بدون استفادهٔ هم‌زمان از \f[V]--update\f[R] باعث می‌شود تمام فایل‌هایی که در زمانی غیر از آخرین زمان بارگذاری تغییر کرده‌اند مجدداً بارگذاری شوند، که احتمالاً مطلوب شما نیست.
.SS -v, -vv, --verbose
.PP
با \f[V]-v\f[R] برنامهٔ rclone دربارهٔ هر فایلی که انتقال می‌یابد و شمار اندکی از رخدادهای مهم اطلاع می‌دهد.
.PP
با \f[V]-vv\f[R] برنامهٔ rclone بسیار پرحرف شده و دربارهٔ تک‌تک فایل‌هایی که بررسی و منتقل می‌کند گزارش می‌دهد.
لطفاً گزارش باگ‌ها را همراه با گزارشی با این تنظیم ارسال کنید.
.PP
هنگام تنظیم میزان پرحرفی (verbosity) با متغیر محیطی، به ترتیب از \f[V]RCLONE_VERBOSE=1\f[R] یا \f[V]RCLONE_VERBOSE=2\f[R] برای \f[V]-v\f[R] و \f[V]-vv\f[R] استفاده کنید.
.SS -V, --version
.PP
شمارهٔ نسخه را چاپ می‌کند
.SS گزینه‌های SSL/TLS
.PP
اتصالات خروجی SSL/TLS که rclone برقرار می‌کند را می‌توان با این گزینه‌ها کنترل کرد.
به‌عنوان مثال، این قابلیت می‌تواند با بک‌اندهای HTTP یا WebDAV بسیار سودمند باشد.
سرورهای HTTP برنامهٔ rclone مجموعه‌ای از پیکربندی‌های اختصاصی خود را برای SSL/TLS دارند که می‌توانید آن‌ها را در مستنداتشان بیابید.
.SS --ca-cert stringArray
.PP
این گزینه گواهی‌های مرجع صدور گواهی (CA) با کدگذاری PEM را بارگذاری کرده و از آن برای اعتبارسنجی گواهی‌های سرورهایی که rclone به آن‌ها متصل می‌شود استفاده می‌کند.
.PP
اگر گواهی‌هایی تولید کرده‌اید که توسط یک CA محلی امضا شده‌اند، برای اتصال به سرورهایی که از آن گواهی‌ها استفاده می‌کنند به این پرچم نیاز خواهید داشت.
.SS --client-cert string
.PP
این گزینه گواهی سمت کلاینت با کدگذاری PEM را بارگذاری می‌کند.
.PP
این پرچم برای احراز هویت متقابل TLS استفاده می‌شود (https://en.wikipedia.org/wiki/Mutual_authentication).
.PP
هنگام استفاده از این گزینه، پرچم \f[V]--client-key\f[R] نیز الزامی است.
.SS --client-key string
.PP
این گزینه کلید خصوصی سمت کلاینت با کدگذاری PEM را که برای احراز هویت متقابل TLS به کار می‌رود بارگذاری می‌کند.
در ترکیب با \f[V]--client-cert\f[R] استفاده می‌شود.
.PP
انواع پشتیبانی‌شده عبارتند از:
.IP \[bu] 2
رمزگذاری‌نشده PKCS#1 (\[dq]BEGIN RSA PRIVATE KEY\[dq])
.IP \[bu] 2
رمزگذاری‌نشده PKCS#8 (\[dq]BEGIN PRIVATE KEY\[dq])
.IP \[bu] 2
رمزگذاری‌شده PKCS#8 (\[dq]BEGIN ENCRYPTED PRIVATE KEY\[dq])
.IP \[bu] 2
رمزگذاری سنتی PEM (مانند سرآیندهای DEK-Info) که به‌طور خودکار شناسایی می‌شوند..SS --client-pass string
.PP
این گزینه می‌تواند برای ارائه یک گذرواژه اختیاری جهت رمزگشایی فایل کلید کلاینت استفاده شود.
.PP
\f[B]توجه:\f[R] گذرواژه باید مبهم‌سازی (obscure) شده باشد، بنابراین باید خروجی \f[V]rclone obscure YOURPASSWORD\f[R] باشد.
.SS --no-check-certificate
.PP
گزینه \f[V]--no-check-certificate\f[R] مشخص می‌کند که آیا کلاینت زنجیره گواهی و نام میزبانِ سرور را اعتبارسنجی کند یا خیر.
اگر \f[V]--no-check-certificate\f[R] مقدار true داشته باشد، TLS هر گواهی ارائه‌شده توسط سرور و هر نام میزبانی در آن گواهی را می‌پذیرد.
در این حالت، TLS در برابر حملات مرد میانی (man-in-the-middle) آسیب‌پذیر خواهد بود.
.PP
مقدار پیش‌فرض این گزینه \f[V]false\f[R] است.
.PP
\f[B]این گزینه فقط باید برای اهداف آزمایشی استفاده شود.\f[R]
.SS رمزنگاری پیکربندی (Configuration encryption)
.PP
فایل پیکربندی شما شامل اطلاعات لازم برای ورود به سرویس‌های ابری شماست.
این بدان معناست که باید فایل \f[V]rclone.conf\f[R] خود را در مکانی امن نگه دارید.
.PP
اگر در محیطی هستید که این کار امکان‌پذیر نیست، می‌توانید برای پیکربندی خود یک گذرواژه تعیین کنید.
این امر باعث می‌شود که هر بار هنگام اجرای rclone مجبور به ارائه گذرواژه باشید.
.PP
برای افزودن گذرواژه به پیکربندی rclone خود، دستور \f[V]rclone config\f[R] را اجرا کنید.
.IP
.nf
\f[C]
$ rclone config
Current remotes:

e) Edit existing remote
n) New remote
d) Delete remote
s) Set configuration password
q) Quit config
e/n/d/s/q>
\f[R]
.fi
.PP
وارد بخش \f[V]s\f[R] (Set configuration password) شوید:
.IP
.nf
\f[C]
e/n/d/s/q> s
Your configuration is not encrypted.
If you add a password, you will protect your login information to cloud services.
a) Add Password
q) Quit to main menu
a/q> a
Enter NEW configuration password:
password:
Confirm NEW password:
password:
Password set
Your configuration is encrypted.
c) Change Password
u) Unencrypt configuration
q) Quit to main menu
c/u/q>
\f[R]
.fi
.PP
اکنون پیکربندی شما رمزنگاری شده است و هر بار که rclone را اجرا می‌کنید باید گذرواژه را ارائه دهید.
برای جزئیات به بخش زیر مراجعه کنید.
در همان منو، می‌توانید گذرواژه را تغییر دهید یا رمزنگاری را به‌طور کامل از پیکربندی خود حذف کنید.
.PP
در صورت فراموشی یا از دست دادن گذرواژه، هیچ راهی برای بازیابی پیکربندی وجود ندارد.
.PP
همچنین می‌توانید از دستورهای زیر استفاده کنید:
.IP \[bu] 2
دستور \f[V]rclone config encryption set\f[R] (https://rclone.org/commands/rclone_config_encryption_set) برای تنظیم مستقیم رمزنگاری پیکربندی
.IP \[bu] 2
دستور \f[V]rclone config encryption remove\f[R] (https://rclone.org/commands/rclone_config_encryption_remove) برای حذف آن
.IP \[bu] 2
دستور \f[V]rclone config encryption check\f[R] (https://rclone.org/commands/rclone_config_encryption_check) برای بررسی صحت رمزنگاری آن.
.PP
ابزار rclone از nacl secretbox (https://godoc.org/golang.org/x/crypto/nacl/secretbox) استفاده می‌کند که آن هم به‌نوبه خود از XSalsa20 و Poly1305 برای رمزنگاری و اصالت‌سنجی پیکربندی شما با استفاده از رمزنگاری کلید-مخفی بهره می‌برد.
گذرواژه با الگوریتم SHA-256 هش می‌شود که کلید موردنیاز برای secretbox را تولید می‌کند.
گذرواژه هش‌شده ذخیره نمی‌شود.
.PP
اگرچه این روش امنیت بسیار خوبی فراهم می‌کند، اما توصیه نمی‌کنیم فایل پیکربندی رمزنگاری‌شده rclone خود را در صورت داشتن اطلاعات حساس در دسترس عموم قرار دهید، مگر اینکه از یک گذرواژه بسیار قوی استفاده کرده باشید.
.PP
اگر در محیط شما امن است، می‌توانید متغیر محیطی \f[V]RCLONE_CONFIG_PASS\f[R] را با گذرواژه خود مقداردهی کنید؛ در این صورت، از آن برای رمزگشایی پیکربندی استفاده خواهد شد.
.PP
می‌توانید این مقدار را از طریق یک اسکریپت برای یک نشست (session) تنظیم کنید.
برای سیستم‌های شبه‌یونیکس، این متن را در فایلی به نام \f[V]set-rclone-password\f[R] ذخیره کنید:
.IP
.nf
\f[C]
#!/bin/echo Source this file don\[aq]t run it

read -s RCLONE_CONFIG_PASS
export RCLONE_CONFIG_PASS
\f[R]
.fi
.PP
سپس هر زمان که مایل به استفاده بودید، فایل را فراخوانی (source) کنید.
از طریق پوسته می‌توانید دستور \f[V]source set-rclone-password\f[R] را اجرا نمایید.
سپس گذرواژه از شما پرسیده شده و در متغیر محیطی قرار می‌گیرد.
.PP
روشی جایگزین برای ارائه گذرواژه، فراهم کردن اسکریپتی است که گذرواژه را بازیابی کرده و در خروجی استاندارد چاپ می‌کند.
این اسکریپت باید دارای یک مسیر کامل (absolute path) باشد و به هیچ متغیر محیطی وابسته نباشد.
اسکریپت یا از طریق آرگومان خط فرمان \f[V]--password-command=\[dq]...\[dq]\f[R] یا از طریق متغیر محیطی \f[V]RCLONE_PASSWORD_COMMAND\f[R] مشخص می‌شود.
.PP
یک مثال کاربردی در این زمینه، استفاده از برنامه \f[V]passwordstore\f[R] برای بازیابی گذرواژه است:
.IP
.nf
\f[C]
export RCLONE_PASSWORD_COMMAND=\[dq]pass rclone/config\[dq]
\f[R]
.fi
.PP
اگر مدیر گذرواژه \f[V]passwordstore\f[R] نگه‌دارنده گذرواژه پیکربندی rclone باشد، استفاده از روش اسکریپت بدین معناست که گذرواژه عمدتاً توسط سامانه \f[V]passwordstore\f[R] محافظت می‌شود و هرگز به‌صورت متن خام در اسکریپت‌ها قرار نمی‌گیرد و با دستورهای استاندارد در دسترس قابل مشاهده نخواهد بود.
در نشست‌های طولانی‌مدت rclone کاملاً محتمل است که نسخه‌هایی از گذرواژه‌ها ناخواسته در فایل‌های لاگ یا حافظه موقت پیمایش ترمینال و غیره ثبت شوند.
استفاده از روش اسکریپتی برای ارائه گذرواژه، امنیت گذرواژه پیکربندی را به‌طور چشمگیری افزایش می‌دهد.
.PP
اگر rclone را درون یک اسکریپت اجرا می‌کنید، مگر در حالتی که از روش \f[V]--password-command\f[R] استفاده کنید، ممکن است بخواهید اعلان‌های درخواست گذرواژه را غیرفعال کنید.
برای این کار، پارامتر \f[V]--ask-password=false\f[R] را به rclone پاس دهید.
با این کار، اگر \f[V]RCLONE_CONFIG_PASS\f[R] حاوی یک گذرواژه معتبر نباشد و \f[V]--password-command\f[R] نیز ارائه نشده باشد، rclone به‌جای درخواست گذرواژه، با خطا متوقف می‌شود.
.PP
هنگام اجرای دستورهایی که ممکن است تحت تأثیر گزینه‌های موجود در فایل پیکربندی قرار گیرند، rclone طبق قوانین شرح‌داده‌شده در بالا به دنبال فایلی موجود می‌گردد و هر فایلی را که بیابد بارگذاری می‌کند.
اگر یک فایل رمزنگاری‌شده پیدا شود، این فرایند شامل رمزگشایی آن نیز خواهد بود که ممکن است منجر به درخواست گذرواژه شود.
زمانی که دستور خط فرمانی را اجرا می‌کنید که می‌دانید عملاً از محتویات چنین فایل پیکربندی استفاده نمی‌کند، می‌توانید با بازتعریف مکان فایل (override کردن مسیر)، مثلاً با یکی از مقادیر ویژه مستندشده برای پیکربندیِ صرفاً در حافظه (memory-only)، از بارگذاری آن جلوگیری کنید.
از آنجا که تنها گزینه‌های مربوط به backendها می‌توانند در فایل‌های پیکربندی ذخیره شوند، این کار معمولاً برای دستورهایی که با backendها سروکار ندارند (مانند \f[V]completion\f[R]) غیرضروری است.
با این حال، برای دستورهایی که به‌طور کلی بر روی backendها عمل می‌کنند اما بدون ارجاع به یک remote ذخیره‌شده به کار می‌روند (مانند فهرست کردن مسیرهای فایل‌سیستم محلی یا رشته‌های اتصال) کاربرد خواهد داشت:
\f[V]rclone --config=\[dq]\[dq] ls .\f[R].SS راهنمای سریع رمزنگاری پیکربندی
.PP
می‌توانید رمزنگاری پیکربندی را به‌سرعت و بدون قرارگیری داده‌ها به‌صورت متن آشکار
در حالت سکون یا انتقال اعمال کنید.
دستورالعمل‌های دقیق برای سیستم‌عامل‌های رایج:
.SS مک (Mac)
.IP \[bu] 2
تولید و ذخیره یک گذرواژه
.RS 2
.IP
.nf
\f[C]
security add-generic-password -a rclone -s config -w $(openssl rand -base64 40)
\f[R]
.fi
.RE
.IP \[bu] 2
افزودن دستور بازیابی به \f[V].zprofile\f[R] /
\f[V].profile\f[R] خود
.RS 2
.IP
.nf
\f[C]
export RCLONE_PASSWORD_COMMAND=\[dq]/usr/bin/security find-generic-password -a rclone -s config -w\[dq]
\f[R]
.fi
.RE
.SS لینوکس (Linux)
.IP \[bu] 2
پیش‌نیاز: لینوکس به‌طور پیش‌فرض به همراه یک مدیر گذرواژه ارائه نمی‌شود.
ابزار \[dq]pass\[dq] را با استفاده از یک مدیر بسته نصب کنید،
مانند
\f[V]apt install pass\f[R]، \f[V]yum install pass\f[R]،
و غیره (https://www.passwordstore.org/#download)؛ سپس یک
مخزن گذرواژه را راه‌اندازی اولیه کنید: \f[V]pass init rclone\f[R].
.IP \[bu] 2
تولید و ذخیره یک گذرواژه
.RS 2
.IP
.nf
\f[C]
echo $(openssl rand -base64 40) | pass insert -m rclone/config
\f[R]
.fi
.RE
.IP \[bu] 2
افزودن دستور بازیابی
.RS 2
.IP
.nf
\f[C]
export RCLONE_PASSWORD_COMMAND=\[dq]/usr/bin/pass rclone/config\[dq]
\f[R]
.fi
.RE
.SS ویندوز (Windows)
.IP \[bu] 2
تولید و ذخیره یک گذرواژه
.RS 2
.IP
.nf
\f[C]
New-Object -TypeName PSCredential -ArgumentList \[dq]rclone\[dq], (ConvertTo-SecureString -String ([System.Web.Security.Membership]::GeneratePassword(40, 10)) -AsPlainText -Force) | Export-Clixml -Path \[dq]rclone-credential.xml\[dq]
\f[R]
.fi
.RE
.IP \[bu] 2
افزودن دستور بازیابی گذرواژه
.RS 2
.IP
.nf
\f[C]
[Environment]::SetEnvironmentVariable(\[dq]RCLONE_PASSWORD_COMMAND\[dq], \[dq][System.Runtime.InteropServices.Marshal]::PtrToStringAuto([System.Runtime.InteropServices.Marshal]::SecureStringToBSTR((Import-Clixml -Path \[dq]rclone-credential.xml\[dq]).Password))\[dq])
\f[R]
.fi
.RE
.SS رمزنگاری فایل پیکربندی (همه سیستم‌ها)
.IP \[bu] 2
دستور \f[V]rclone config\f[R] را اجرا کرده و گزینه
\f[V]s) Set configuration password\f[R] را انتخاب کنید
.IP \[bu] 2
گذرواژه حاصل از مراحل قبل را افزوده یا به‌روزرسانی نمایید.SS "گزینه‌های توسعه‌دهنده (Developer options)"
.PP
این گزینه‌ها هنگام توسعه یا اشکال‌زدایی rclone مفید هستند.
همچنین گزینه‌های خاصِ ریموت دیگری نیز وجود دارند که در اینجا مستند نشده‌اند و برای آزمایش به کار می‌روند.
این گزینه‌ها با نام ریموت آغاز می‌شوند، مانند
\f[V]--drive-test-option\f[R] \- مستندات مربوط به ریموت مورد نظر را ببینید.
.SS --cpuprofile string
.PP
پروفایل پردازنده (CPU profile) را در یک فایل می‌نویسد.
این فایل را می‌توان با \f[V]go tool pprof\f[R] تحلیل کرد.
.SS --memprofile string
.PP
پروفایل حافظه (memory profile) را در یک فایل می‌نویسد.
این فایل را می‌توان با \f[V]go tool pprof\f[R] تحلیل کرد.
.SS --dump DumpFlags
.PP
پرچم \f[V]--dump\f[R] فهرستی از پرچم‌های جداشده با کاما را برای تخلیه و ثبت اطلاعات دریافت می‌کند.
.PP
توجه داشته باشید که برخی از هدرها، مانند \f[V]Accept-Encoding\f[R]، ممکن است دقیقاً همان‌طور که در درخواست نشان داده می‌شوند درست نباشند، و اگر انکودینگ خودکار gzip در کتابخانه‌های استاندارد Go فعال بوده باشد، ممکن است پاسخ هدر
\f[V]Content-Encoding\f[R] را نشان ندهد.
در این حالت بدنهٔ درخواست پیش از نمایش از حالت فشرده (gunzip) خارج خواهد شد.
.PP
پرچم‌های موجود عبارتند از:
.IP \[bu] 2
\f[V]headers\f[R] هدرهای HTTP را تخلیه و چاپ می‌کند.
هرگونه هدر \f[V]Authorization:\f[R] مستثنی خواهد شد، اما خروجی ممکن است همچنان حاوی اطلاعات حساس باشد.
می‌تواند بسیار پرحجم و پرگو باشد.
تنها برای اشکال‌زدایی مفید است.
اگر هدرهای \f[V]Authorization:\f[R] را می‌خواهید، از \f[V]auth\f[R] استفاده کنید.
.IP \[bu] 2
\f[V]auth\f[R] هدرهای HTTP را مانند \f[V]headers\f[R] تخلیه می‌کند، اما شامل تمام هدرهای \f[V]Authorization:\f[R] نیز می‌شود.
این بدان معناست که خروجی احتمالاً حاوی اطلاعات حساس خواهد بود.
برای تخلیه بدون هدرهای \f[V]Authorization:\f[R]، از \f[V]headers\f[R] استفاده کنید.
می‌تواند بسیار پرحجم باشد.
تنها برای اشکال‌زدایی مفید است.
این پرچم همچنین باعث می‌شود گزارش اشکال‌زدایی فرآیند پیکربندی (مانند
\f[V]rclone config -vv\f[R]) پاسخ‌های داده‌شده به پرسش‌ها، گذرواژه‌ها و توکن‌هایی را که در حالت عادی سانسور می‌شوند، نمایش دهد.
.IP \[bu] 2
\f[V]bodies\f[R] هدرها و بدنه‌های HTTP را تخلیه می‌کند.
ممکن است حاوی اطلاعات حساس باشد.
می‌تواند بسیار پرحجم باشد.
تنها برای اشکال‌زدایی مفید است.
توجه داشته باشید که بدنه‌ها در حافظه بافر می‌شوند، بنابراین برای فایل‌های بسیار بزرگ از این گزینه استفاده نکنید.
.IP \[bu] 2
\f[V]requests\f[R] مشابه \f[V]bodies\f[R] است، اما بدنه‌های درخواست و هدرهای پاسخ را تخلیه می‌کند.
برای اشکال‌زدایی مشکلات بارگیری (دانلود) مفید است.
.IP \[bu] 2
\f[V]responses\f[R] مشابه \f[V]bodies\f[R] است، اما بدنه‌های پاسخ و هدرهای درخواست را تخلیه می‌کند.
برای اشکال‌زدایی مشکلات بارگذاری (آپلود) مفید است.
.IP \[bu] 2
\f[V]filters\f[R] فیلترها را تخلیه و چاپ می‌کند.
برای مشاهدهٔ دقیق اینکه گزینه‌های include و exclude دقیقاً چه مواردی را پالایش می‌کنند، مفید است.
.IP \[bu] 2
\f[V]goroutines\f[R] فهرستی از goroutineهای در حال اجرا را در پایان دستور تخلیه می‌کند.
.IP \[bu] 2
\f[V]openfiles\f[R] فهرستی از فایل‌های باز را در پایان دستور تخلیه می‌کند.
این گزینه از دستور یونیکس \f[V]lsof\f[R] برای انجام این کار استفاده می‌کند، بنابراین برای استفاده از آن باید این دستور نصب شده باشد.
.IP \[bu] 2
\f[V]mapper\f[R] داده‌های خام (blobs) از نوع JSON که به برنامهٔ ارائه‌شده با \f[V]--metadata-mapper\f[R] ارسال شده و از آن دریافت می‌شوند را تخلیه می‌کند.
می‌تواند برای اشکال‌زدایی رابط نقشه‌بردار فراداده مفید باشد.
.IP \[bu] 2
\f[V]curl\f[R] درخواست HTTP را به‌صورت یک دستور \f[V]curl\f[R] تخلیه می‌کند.
می‌تواند همراه با سایر پرچم‌های اشکال‌زدایی HTTP (مانند
\f[V]requests\f[R]، \f[V]bodies\f[R]) استفاده شود.
به‌طور پیش‌فرض اطلاعات احراز هویت ماسک (پنهان) می‌شود \- برای اینکه دستورات curl شامل اطلاعات احراز هویت نیز باشند، آن را همراه با \f[V]auth\f[R] استفاده کنید.
.IP \[bu] 2
\f[V]errors\f[R] فقط تراکنش‌های HTTP را تخلیه می‌کند که با خطای قابل تلاش مجدد مواجه شده‌اند \- یعنی خطای انتقال، خطای HTTP 429 (تعداد درخواست‌های بیش از حد) یا خطای سرور HTTP 5xx.
سایر پرچم‌های dump کنترل می‌کنند چه چیزی تخلیه شود؛ بنابراین برای مثال از
\f[V]--dump errors,bodies\f[R] استفاده کنید تا فقط هدرها و بدنه‌های تراکنش‌های ناموفق تخلیه شوند.
به‌تنهایی، \f[V]--dump errors\f[R] هدرها را تخلیه می‌کند.
این گزینه به شما امکان می‌دهد اطلاعات عیب‌یابی اولین شکست را بدون شلوغیِ تخلیهٔ تک‌تک تراکنش‌ها ثبت کنید.
ممکن است حاوی اطلاعات حساس باشد.
.IP \[bu] 2
\f[V]trace\f[R] رویدادهای سطح اتصال را برای هر تراکنش HTTP با استفاده از بستهٔ \f[V]net/http/httptrace\f[R] در Go ثبت می‌کند \- تفکیک DNS، اتصال TCP، دست‌دادن TLS (از جمله نسخهٔ توافق‌شدهٔ TLS، سایفر، پروتکل ALPN و گواهی سرور)، استفادهٔ مجدد از اتصال، نوشتن درخواست و زمان تا دریافت اولین بایت پاسخ.
هر خط با زمان سپری‌شده از آغاز تراکنش برچسب‌گذاری می‌شود تا بتوانید ببینید زمان در کجا صرف شده است.
این پرچم مکمل سایر پرچم‌های dump است: این پرچم به‌جای آنچه ارسال شده، نحوهٔ رفتار اتصال را نشان می‌دهد؛ بنابراین برای اشکال‌زدایی مشکلات اتصال، DNS، TLS، پراکسی و keep-alive مفید است.
این پرچم هدرها یا بدنه‌ها را تخلیه نمی‌کند \- برای این منظور آن را با \f[V]headers\f[R] یا \f[V]bodies\f[R] ترکیب کنید..SS فیلترسازی (Filtering)
.PP
برای گزینه‌های فیلتر کردن
.IP \[bu] 2
\f[V]--delete-excluded\f[R]
.IP \[bu] 2
\f[V]--filter\f[R]
.IP \[bu] 2
\f[V]--filter-from\f[R]
.IP \[bu] 2
\f[V]--exclude\f[R]
.IP \[bu] 2
\f[V]--exclude-from\f[R]
.IP \[bu] 2
\f[V]--exclude-if-present\f[R]
.IP \[bu] 2
\f[V]--include\f[R]
.IP \[bu] 2
\f[V]--include-from\f[R]
.IP \[bu] 2
\f[V]--files-from\f[R]
.IP \[bu] 2
\f[V]--files-from-raw\f[R]
.IP \[bu] 2
\f[V]--files-from0\f[R]
.IP \[bu] 2
\f[V]--min-size\f[R]
.IP \[bu] 2
\f[V]--max-size\f[R]
.IP \[bu] 2
\f[V]--min-age\f[R]
.IP \[bu] 2
\f[V]--max-age\f[R]
.IP \[bu] 2
\f[V]--hash-filter\f[R]
.IP \[bu] 2
\f[V]--dump filters\f[R]
.IP \[bu] 2
\f[V]--metadata-include\f[R]
.IP \[bu] 2
\f[V]--metadata-include-from\f[R]
.IP \[bu] 2
\f[V]--metadata-exclude\f[R]
.IP \[bu] 2
\f[V]--metadata-exclude-from\f[R]
.IP \[bu] 2
\f[V]--metadata-filter\f[R]
.IP \[bu] 2
\f[V]--metadata-filter-from\f[R]
.PP
بخش فیلترسازی را ببینید (<https://rclone.org/filtering>).
.SS کنترل از راه دور (Remote control)
.PP
برای گزینه‌های کنترل از راه دور و دستورالعمل‌های نحوه کنترل از راه دور rclone:
.IP \[bu] 2
\f[V]--rc\f[R]
.IP \[bu] 2
هر موردی که با \f[V]--rc-\f[R] شروع شود
.PP
بخش کنترل از راه دور را ببینید (<https://rclone.org/rc>).
.SS گزارش‌گیری (Logging)
.PP
برنامه rclone دارای ۴ سطح گزارش‌گیری است: \f[V]ERROR\f[R]، \f[V]NOTICE\f[R]،
\f[V]INFO\f[R] و \f[V]DEBUG\f[R].
.PP
به‌طور پیش‌فرض، rclone گزارش‌ها را در خطای استاندارد (standard error) ثبت می‌کند.
این بدان معناست که می‌توانید خطای استاندارد را تغییر مسیر دهید و همچنان خروجی عادی
دستورهای rclone (مانند
\f[V]rclone ls\f[R]) را مشاهده کنید.
.PP
به‌طور پیش‌فرض، rclone پیام‌هایی در سطح \f[V]Error\f[R] و \f[V]Notice\f[R]
تولید می‌کند.
.PP
اگر از پرچم \f[V]-q\f[R] استفاده کنید، rclone تنها پیام‌های
\f[V]Error\f[R] را تولید خواهد کرد.
.PP
اگر از پرچم \f[V]-v\f[R] استفاده کنید، rclone پیام‌های \f[V]Error\f[R]،
\f[V]Notice\f[R] و \f[V]Info\f[R] را تولید می‌کند.
.PP
اگر از پرچم \f[V]-vv\f[R] استفاده کنید، rclone پیام‌های \f[V]Error\f[R]،
\f[V]Notice\f[R]، \f[V]Info\f[R] و \f[V]Debug\f[R] را تولید خواهد کرد.
.PP
همچنین می‌توانید سطوح گزارش‌گیری را با پرچم \f[V]--log-level\f[R] کنترل کنید.
.PP
اگر از گزینه \f[V]--log-file\f[R] استفاده کنید، rclone پیام‌های
\f[V]Error\f[R]، \f[V]Info\f[R] و \f[V]Debug\f[R] را به همراه
خطای استاندارد به یک فایل هدایت می‌کند.
.PP
اگر از پرچم \f[V]--syslog\f[R] استفاده کنید، rclone گزارش‌ها را به syslog می‌فرستد
و گزینه \f[V]--syslog-facility\f[R] مشخص می‌کند که از کدام facility استفاده شود.
.PP
دستور rclone پیشوند همه پیام‌های گزارش را با حروف بزرگِ سطح آن‌ها مشخص می‌کند (مانند
INFO) که این امر جستجو با grep در فایل گزارش را برای انواع اطلاعات آسان می‌سازد..SS "سنجه‌ها (Metrics)"
.PP
ابزار rclone می‌تواند سنجه‌ها را در قالب OpenMetrics/Prometheus منتشر کند.
.PP
برای فعال‌سازی نقطه پایانی (endpoint) سنجه‌ها، از پرچم \f[V]--metrics-addr\f[R] استفاده کنید.
همچنین اگر پرچم \f[V]--rc\f[R] و پرچم \f[V]--rc-enable-metrics\f[R] مشخص شده باشند،
یا در صورت استفاده از rclone rcd \f[V]--rc-enable-metrics\f[R]، سنجه‌ها می‌توانند
روی پورت \f[V]--rc-addr\f[R] نیز منتشر شوند.
.PP
ابزار rclone گزینه‌های پیکربندی گسترده‌ای را برای نقطه پایانی HTTP سنجه‌ها فراهم می‌کند.
این تنظیمات ذیل بخش Metrics دسته‌بندی شده‌اند و پیشوند \f[V]--metrics-*\f[R] دارند.
.PP
هنگامی که سنجه‌ها با \f[V]--rc-enable-metrics\f[R] فعال شوند، روی همان پورت مربوط
به rc API منتشر خواهند شد.
در این حالت، پرچم‌های \f[V]--metrics-*\f[R] نادیده گرفته می‌شوند و پیکربندی
نقطه پایانی HTTP توسط پارامترهای \f[V]--rc-*\f[R] مدیریت خواهد شد.
.SS "کد خروج (Exit code)"
.PP
اگر در حین اجرای دستور هرگونه خطایی رخ دهد، rclone با یک کد خروج غیرصفر خارج خواهد شد.
این امر به اسکریپت‌ها اجازه می‌دهد تا موارد شکست در عملیات‌های rclone را تشخیص دهند.
.PP
در طول مرحله راه‌اندازی، در صورت شناسایی خطا در پیکربندی، rclone فوراً خارج خواهد شد.
همواره بلافاصله پیش از خروج، یک پیام ثبت وقایع وجود خواهد داشت.
.PP
هنگامی که rclone در حال اجرا است، خطاها را در طول مسیر انباشته می‌کند و تنها در صورتی
با یک کد خروج غیرصفر خارج می‌شود که (پس از تلاش‌های مجدد) همچنان انتقال‌های ناموفقی
باقی مانده باشند.
به ازای هر خطای شمارش‌شده، یک پیام گزارش با اولویت بالا (قابل مشاهده با \f[V]-q\f[R])
وجود خواهد داشت که متن پیام و فایلی که موجب مشکل شده است را نشان می‌دهد.
همچنین هنگام شروع یک تلاش مجدد، پیامی با اولویت بالا نمایش داده می‌شود تا کاربر متوجه
شود پیام‌های خطای قبلی ممکن است پس از تلاش مجدد دیگر معتبر نباشند.
اگر rclone تلاش مجددی انجام داده باشد، در صورت موفقیت‌آمیز بودن آن، یک پیام با اولویت بالا
ثبت خواهد کرد.
.SS "فهرست کدهای خروج (List of exit codes)"
.IP \[bu] 2
\f[V]0\f[R] \- موفقیت
.IP \[bu] 2
\f[V]1\f[R] \- خطایی که در جای دیگری دسته‌بندی نشده است
.IP \[bu] 2
\f[V]2\f[R] \- خطای نحو یا نحوه استفاده
.IP \[bu] 2
\f[V]3\f[R] \- دایرکتوری پیدا نشد
.IP \[bu] 2
\f[V]4\f[R] \- فایل پیدا نشد
.IP \[bu] 2
\f[V]5\f[R] \- خطای موقت (خطایی که ممکن است با تلاش‌های مجدد بیشتر برطرف شود) (خطاهای Retry)
.IP \[bu] 2
\f[V]6\f[R] \- خطاهای با اهمیت کمتر (مانند خطاهای 461 از dropbox) (خطاهای NoRetry)
.IP \[bu] 2
\f[V]7\f[R] \- خطای مهلک (خطایی که تلاش‌های مجدد بیشتر آن را رفع نخواهد کرد، مانند تعلیق حساب کاربری) (خطاهای Fatal)
.IP \[bu] 2
\f[V]8\f[R] \- فراتر رفتن از حد انتقال \- رسیدن به سقف تعیین‌شده توسط --max-transfer
.IP \[bu] 2
\f[V]9\f[R] \- عملیات موفقیت‌آمیز بود، اما هیچ فایلی منتقل نشد (نیازمند \f[V]--error-on-no-transfer\f[R])
.IP \[bu] 2
\f[V]10\f[R] \- فراتر رفتن از مدت زمان \- رسیدن به سقف تعیین‌شده توسط --max-duration
.SS "متغیرهای محیطی (Environment variables)"
.PP
ابزار rclone را می‌توان به طور کامل با استفاده از متغیرهای محیطی پیکربندی کرد.
از این متغیرها می‌توان برای تنظیم مقادیر پیش‌فرض گزینه‌ها یا ورودی‌های فایل پیکربندی استفاده کرد.
.SS "گزینه‌ها (Options)"
.PP
مقدار پیش‌فرض هر گزینه‌ای در rclone می‌تواند توسط متغیرهای محیطی تعیین شود.
.PP
برای یافتن نام متغیر محیطی، ابتدا نام طولانی گزینه را در نظر بگیرید، \f[V]--\f[R] ابتدایی
آن را حذف کنید، \f[V]-\f[R] را به \f[V]_\f[R] تبدیل کنید، حروف را بزرگ کنید و عبارت
\f[V]RCLONE_\f[R] را به ابتدای آن بیفزایید.
.PP
برای مثال، برای تعیین همیشگی \f[V]--stats 5s\f[R]، متغیر محیطی \f[V]RCLONE_STATS=5s\f[R]
را تنظیم کنید.
اگر stats را در خط فرمان مشخص کنید، این مقدار تنظیم متغیر محیطی را بازنویسی (override) خواهد کرد.
.PP
یا برای استفاده همیشگی از سطل بازیافت در درایو با \f[V]--drive-use-trash\f[R]، مقدار
\f[V]RCLONE_DRIVE_USE_TRASH=true\f[R] را قرار دهید.
.PP
میزان پرگویی گزارش‌ها (Verbosity) کمی متفاوت است؛ معادل متغیر محیطی برای \f[V]--verbose\f[R]
یا \f[V]-v\f[R] برابر با \f[V]RCLONE_VERBOSE=1\f[R] است، و برای \f[V]-vv\f[R] برابر با
\f[V]RCLONE_VERBOSE=2\f[R] می‌باشد.
.PP
برای گزینه‌ها و متغیرهای محیطی از تجزیه‌کننده (parser) یکسانی استفاده می‌شود، بنابراین دقیقاً
ساختار یکسانی دارند.
.PP
گزینه‌های تنظیم‌شده توسط متغیرهای محیطی را می‌توان با پرچم \f[V]-vv\f[R] مشاهده کرد، مانند
\f[V]rclone version -vv\f[R].
.PP
با گزینه‌هایی که می‌توانند چندین بار تکرار شوند (از نوع \f[V]stringArray\f[R]) کمی متفاوت
رفتار می‌شود، زیرا متغیرهای محیطی را تنها یک‌بار می‌توان تعریف کرد.
به منظور فراهم کردن سازوکاری ساده جهت افزودن یک یا چند مورد، ورودی به عنوان یک رشته
کدگذاری‌شده با CSV (https://godoc.org/encoding/csv) در نظر گرفته می‌شود.
برای مثال
.PP
.TS
tab(@);
lw(36.7n) lw(33.3n).
T{
متغیر محیطی
T}@T{
گزینه‌های معادل
T}
_
T{
\f[V]RCLONE_EXCLUDE=\[dq]*.jpg\[dq]\f[R]
T}@T{
\f[V]--exclude \[dq]*.jpg\[dq]\f[R]
T}
T{
\f[V]RCLONE_EXCLUDE=\[dq]*.jpg,*.png\[dq]\f[R]
T}@T{
\f[V]--exclude \[dq]*.jpg\[dq]\f[R] \f[V]--exclude \[dq]*.png\[dq]\f[R]
T}
T{
\f[V]RCLONE_EXCLUDE=\[aq]\[dq]*.jpg\[dq],\[dq]*.png\[dq]\[aq]\f[R]
T}@T{
\f[V]--exclude \[dq]*.jpg\[dq]\f[R] \f[V]--exclude \[dq]*.png\[dq]\f[R]
T}
T{
\f[V]RCLONE_EXCLUDE=\[aq]\[dq]/directory with comma , in it /**\[dq]\[aq]\f[R]
T}@T{
\[ga]--exclude \[dq]/directory with comma , in it /**\[dq]
T}
.TE
.PP
اگر گزینه‌های \f[V]stringArray\f[R] هم به عنوان متغیرهای محیطی \f[B]و\f[R] هم گزینه‌های خط فرمان
تعریف شوند، تمام مقادیر استفاده خواهند شد..SS "فایل پیکربندی (Config file)"
.PP
می‌توانید مقادیر پیش‌فرض فایل پیکربندی را به ازای هر ریموت به‌طور جداگانه
تنظیم کنید.
نام گزینه‌های پیکربندی در صفحهٔ مربوط به هر بک‌اند مستند شده است.
.PP
برای یافتن نام متغیر محیطی که باید تنظیم کنید، عبارت
\f[V]RCLONE_CONFIG_\f[R] + نام ریموت + \f[V]_\f[R] + نام گزینهٔ فایل پیکربندی
را در نظر گرفته و همهٔ آن را با حروف بزرگ بنویسید.
توجه داشته باشید که یک پیامد در اینجا این است که نام ریموت باید به یک نام معتبر برای متغیر محیطی قابل تبدیل باشد؛ بنابراین تنها می‌تواند شامل حروف،
ارقام، یا نویسهٔ زیرخط (\f[V]_\f[R]) باشد.
.PP
برای نمونه، جهت پیکربندی یک ریموت S3 به نام \f[V]mys3:\f[R] بدون نیاز به
فایل پیکربندی (با استفاده از روش‌های یونیکس برای مقداردهی متغیرهای محیطی):
.IP
.nf
\f[C]
$ export RCLONE_CONFIG_MYS3_TYPE=s3
$ export RCLONE_CONFIG_MYS3_ACCESS_KEY_ID=XXX
$ export RCLONE_CONFIG_MYS3_SECRET_ACCESS_KEY=XXX
$ rclone lsd mys3:
          -1 2016-09-21 12:54:21        -1 my-bucket
$ rclone listremotes | grep mys3
mys3:
\f[R]
.fi
.PP
توجه داشته باشید اگر قصد دارید با استفاده از متغیرهای محیطی یک ریموت بسازید،
باید متغیر \f[V]..._TYPE\f[R] را همانند بالا تعریف کنید.
.PP
توجه داشته باشید که نام ریموت ایجادشده از طریق متغیر محیطی، بر خلاف ریموت‌های معمولی ذخیره‌شده در فایل پیکربندی (طبق آنچه در بالا توضیح داده شد)،
به بزرگ و کوچک بودن حروف حساس نیست.
باید نام را در متغیر محیطی با حروف بزرگ بنویسید، اما همان‌طور که در مثال بالا مشاهده می‌شود، ریموت با حروف کوچک فهرست شده و قابل دسترسی است؛ در عین حال
می‌توانید با حروف بزرگ نیز به همان ریموت ارجاع دهید:
.IP
.nf
\f[C]
$ rclone lsd mys3:
          -1 2016-09-21 12:54:21        -1 my-bucket
$ rclone lsd MYS3:
          -1 2016-09-21 12:54:21        -1 my-bucket
\f[R]
.fi
.PP
توجه داشته باشید که شما تنها می‌توانید گزینه‌های بک‌اندِ مستقیم (immediate backend) را تنظیم کنید؛ بنابراین اگر myS3Crypt یک ریموت crypt بر پایهٔ یک ریموت S3 باشد، متغیر RCLONE_CONFIG_MYS3CRYPT_ACCESS_KEY_ID هیچ اثری نخواهد داشت.
با این حال، RCLONE_S3_ACCESS_KEY_ID کلید دسترسی تمام ریموت‌هایی را که از S3 استفاده می‌کنند، از جمله myS3Crypt، تنظیم خواهد کرد.
.PP
همچنین توجه داشته باشید اکنون که rclone از رشته‌های اتصال (connection strings) پشتیبانی می‌کند، احتمالاً استفاده از آن‌ها ساده‌تر است که مثال بالا را به شکل زیر در می‌آورد:
.IP
.nf
\f[C]
rclone lsd :s3,access_key_id=XXX,secret_access_key=XXX:
\f[R]
.fi
.SS "اولویت (Precedence)"
.PP
روش‌های گوناگون پیکربندی بک‌اند با ترتیب زیر خوانده می‌شوند و نخستین موردی
که دارای مقدار باشد مورد استفاده قرار می‌گیرد.
.IP \[bu] 2
پارامترها در رشته‌های اتصال، مانند
\f[V]myRemote,skip_links:\f[R]
.IP \[bu] 2
مقادیر پرچم‌های ارائه‌شده در خط فرمان، مانند
\f[V]--skip-links\f[R]
.IP \[bu] 2
متغیرهای محیطی مخصوص به هر ریموت، مانند
\f[V]RCLONE_CONFIG_MYREMOTE_SKIP_LINKS\f[R] (به بالا مراجعه کنید).
.IP \[bu] 2
متغیرهای محیطی مخصوص بک‌اند، مانند
\f[V]RCLONE_LOCAL_SKIP_LINKS\f[R].
.IP \[bu] 2
متغیرهای محیطی عمومی بک‌اند، مانند
\f[V]RCLONE_SKIP_LINKS\f[R].
.IP \[bu] 2
فایل پیکربندی، مانند
\f[V]skip_links = true\f[R].
.IP \[bu] 2
مقادیر پیش‌فرض، مانند
\f[V]false\f[R] \- این مقادیر قابل تغییر نیستند.
.PP
بنابراین اگر هم گزینهٔ \f[V]--skip-links\f[R] در خط فرمان مشخص شده باشد و هم
متغیر محیطی \f[V]RCLONE_LOCAL_SKIP_LINKS\f[R] مقداردهی شده باشد، پرچم خط
فرمان اولویت خواهد داشت.
.PP
پیکربندی‌های بک‌اند که با متغیرهای محیطی تنظیم شده‌اند را می‌توان با پرچم
\f[V]-vv\f[R] مشاهده کرد، مانند
\f[V]rclone about myRemote: -vv\f[R].
.PP
برای پیکربندی‌های غیر بک‌اند، ترتیب اولویت به شرح زیر است:
.IP \[bu] 2
مقادیر پرچم‌های ارائه‌شده در خط فرمان، مانند
\f[V]--stats 5s\f[R].
.IP \[bu] 2
متغیرهای محیطی، مانند
\f[V]RCLONE_STATS=5s\f[R].
.IP \[bu] 2
مقادیر پیش‌فرض، مانند
\f[V]1m\f[R] \- این مقادیر قابل تغییر نیستند..SS "سایر متغیرهای محیطی"
.IP \[bu] 2
\f[V]RCLONE_CONFIG_PASS\f[R] برای نگه‌داری گذرواژه فایل پیکربندی شما تنظیم می‌شود (بخش Configuration Encryption را ببینید).
.IP \[bu] 2
\f[V]HTTP_PROXY\f[R]، \f[V]HTTPS_PROXY\f[R] و \f[V]NO_PROXY\f[R] (یا نسخه‌های با حروف کوچک آن‌ها).
.RS 2
.IP \[bu] 2
\f[V]HTTPS_PROXY\f[R] برای درخواست‌های https نسبت به \f[V]HTTP_PROXY\f[R] اولویت دارد.
.IP \[bu] 2
مقادیر محیطی می‌توانند یک URL کامل یا به صورت \[dq]host[:port]\[dq] باشند که در این صورت طرحواره \[dq]http\[dq] پیش‌فرض در نظر گرفته می‌شود.
.RE
.IP \[bu] 2
مقادیر \f[V]USER\f[R] و \f[V]LOGNAME\f[R] به عنوان گزینه‌های جایگزین برای نام کاربری فعلی استفاده می‌شوند.
روش اصلی برای یافتن نام کاربری وابسته به سیستم‌عامل است: Windows API در ویندوز، و شناسه کاربری واقعی در /etc/passwd در سیستم‌های یونیکس.
در این مستندات، از نام کاربری فعلی صرفاً با عنوان \f[V]$USER\f[R] یاد می‌شود.
.IP \[bu] 2
\f[V]RCLONE_CONFIG_DIR\f[R] \- rclone این متغیر را برای استفاده در فایل‌های پیکربندی و زیرپردازه‌ها \f[B]تنظیم می‌کند\f[R] تا به پوشه حاوی فایل پیکربندی اشاره کند.
.PP
گزینه‌های تعیین‌شده توسط متغیرهای محیطی با پرچم‌های \f[V]-vv\f[R] و \f[V]--log-level=DEBUG\f[R] قابل مشاهده هستند، به عنوان مثال:
\f[V]rclone version -vv\f[R].
.SH "پیکربندی rclone روی ماشین دوردست / بدون نمایشگر (headless)"
.PP
برخی از پیکربندی‌ها (آن‌هایی که شامل oauth2 هستند) به یک مرورگر وب متصل به اینترنت نیاز دارند.
.PP
اگر قصد دارید rclone را روی یک ماشین دوردست یا بدون نمایشگر (headless) که مرورگری روی آن در دسترس نیست (مانند یک NAS یا سروری در مرکز داده) راه‌اندازی کنید، باید از روش‌های جایگزین برای پیکربندی استفاده کنید.
سه روش برای این کار وجود دارد که در ادامه شرح داده شده‌اند.
.SS "پیکربندی با استفاده از rclone authorize"
.PP
روی ماشین بدون نمایشگر (headless)، دستور rclone config را اجرا کنید، اما به پرسش
\f[V]Use web browser to automatically authenticate rclone with remote?\f[R]
پاسخ \f[V]N\f[R] بدهید.
.IP
.nf
\f[C]
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.

y) Yes (default)
n) No
y/n> n

Option config_token.
For this to work, you will need rclone available on a machine that has
a web browser available.
For more help and alternate methods see: https://rclone.org/remote_setup
Execute the following on the machine with the web browser (same rclone
version recommended):
        rclone authorize \[dq]onedrive\[dq]
Then paste the result.
Enter a value.
config_token>
\f[R]
.fi
.PP
سپس روی ماشین دسکتاپ اصلی خود، rclone authorize را اجرا کنید
(https://rclone.org/commands/rclone_authorize).
.IP
.nf
\f[C]
rclone authorize \[dq]onedrive\[dq]
NOTICE: Make sure your Redirect URL is set to \[dq]http://localhost:53682\[dq] in your custom config.
NOTICE: If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth?state=xxxxxxxxxxxxxxxxxxxxxx
NOTICE: Log in and authorize rclone for access
NOTICE: Waiting for code...

Got code
Paste the following into your remote machine --->
SECRET_TOKEN
<---End paste
\f[R]
.fi
.PP
سپس به ماشین بدون نمایشگر (headless) بازگردید و کد را جای‌گذاری کنید.
.IP
.nf
\f[C]
config_token> SECRET_TOKEN
--------------------
[acd12]
client_id =
client_secret =
token = SECRET_TOKEN
--------------------
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d>
\f[R]
.fi.SS پیکربندی از طریق کپی کردن فایل پیکربندی
.PP
نرم‌افزار rclone تمام پیکربندی‌های خود را در یک فایل منفرد ذخیره می‌کند.
این فایل را می‌توان به راحتی جهت پیکربندی یک rclone راه دور (remote) کپی کرد (اگرچه برخی
از backendها از استفادهٔ مجدد یک پیکربندی پشتیبانی نمی‌کنند؛ برای اطمینان مستندات
backend خود را بررسی کنید).
.PP
کار را با اجرای rclone config جهت ایجاد فایل پیکربندی روی رایانهٔ محلی (desktop)
خود آغاز کنید.
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
سپس با اجرای rclone config file محل فایل را پیدا کنید.
.IP
.nf
\f[C]
$ rclone config file
Configuration file is stored at:
/home/user/.rclone.conf
\f[R]
.fi
.PP
در نهایت، فایل را به ماشین راه دور منتقل کرده (از طریق scp، برش و چسباندن، ftp،
sftp و غیره) و در محل مناسب قرار دهید (از rclone config file در ماشین راه دور
برای اطلاع از محل دقیق آن استفاده کنید).
.SS پیکربندی با استفاده از تونل SSH
.PP
اگر یک کلاینت SSH روی سیستم محلی خود نصب دارید، می‌توانید با استفاده از دستور زیر یک تونل
SSH برای هدایت پورت 53682 به ماشین بدون رابط گرافیکی (headless) راه‌اندازی کنید:
.IP
.nf
\f[C]
ssh -L localhost:53682:localhost:53682 username\[at]remote_server
\f[R]
.fi
.PP
سپس در ماشین headless دستور rclone config را اجرا کرده و به پرسش
\f[V]Use web browser to automatically authenticate rclone with remote?\f[R]
پاسخ \f[V]Y\f[R] بدهید.
.IP
.nf
\f[C]
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.

y) Yes (default)
n) No
y/n> y
NOTICE: Make sure your Redirect URL is set to \[dq]http://localhost:53682/\[dq] in your custom config.
NOTICE: If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth?state=xxxxxxxxxxxxxxxxxxxxxx
NOTICE: Log in and authorize rclone for access
NOTICE: Waiting for code...
\f[R]
.fi
.PP
در آخر، نشانی اینترنتی ارائه‌شده یعنی
\f[V]http://127.0.0.1:53682/auth?state=xxxxxxxxxxxxxxxxxxxxxx\f[R] را
در مرورگر ماشین محلی خود کپی و جای‌گذاری کرده، فرایند احراز هویت را به پایان برسانید و کار تمام است.
.SH "فیلترسازی، شامل‌سازی و مستثنی‌سازی (FILTERING, INCLUDES AND EXCLUDES)"
.PP
پرچم‌های فیلتر مشخص می‌کنند که دستورهای \f[V]sync\f[R]،
\f[V]move\f[R]، \f[V]ls\f[R]، \f[V]lsl\f[R]، \f[V]md5sum\f[R]،
\f[V]sha1sum\f[R]، \f[V]size\f[R]، \f[V]delete\f[R]، \f[V]check\f[R] و
دستورات مشابه در rclone بر روی چه فایل‌هایی اعمال شوند.
.PP
این فیلترها بر اساس الگوهای نام مسیر/فایل؛ فهرست‌های مسیر/فایل؛
عمر و اندازهٔ فایل، یا وجود یک فایل در یک دایرکتوری مشخص می‌شوند.
ریموت‌های مبتنی بر باکت (bucket) که فاقد مفهوم دایرکتوری هستند، فیلترها را به
روشی مشابه بر کلید شیء (object key)، عمر و اندازه اعمال می‌کنند.
.PP
دستور \f[V]purge\f[R] در rclone از فیلترها پیروی نمی‌کند.
.PP
برای آزمایش فیلترها بدون خطر آسیب رسیدن به داده‌ها، آن‌ها را به همراه
\f[V]rclone ls\f[R] یا با استفاده از پرچم‌های \f[V]--dry-run\f[R] و \f[V]-vv\f[R]
به کار ببرید.
.PP
الگوهای فیلتر rclone را تنها می‌توان در گزینه‌های خط فرمان فیلتر استفاده کرد،
نه در مشخصات یک ریموت (remote).
.PP
به عنوان مثال،
دستور \f[V]rclone copy \[dq]remote:dir*.jpg\[dq] /path/to/dir\f[R] اثر
فیلتری ندارد؛ در حالی که
\f[V]rclone copy remote:dir /path/to/dir --include \[dq]*.jpg\[dq]\f[R]
دارای اثر فیلتر است.
.PP
\f[B]مهم:\f[R] از ترکیب هم‌زمان هر دو مورد از پرچم‌های \f[V]--include...\f[R]،
\f[V]--exclude...\f[R] یا \f[V]--filter...\f[R] در یک دستور rclone خودداری کنید.
نتایج ممکن است آن چیزی نباشد که انتظار دارید؛ در عوض از یک پرچم \f[V]--filter...\f[R] استفاده کنید..SS الگوهای تطبیق نام مسیر/فایل
.SS نحو الگو (Pattern syntax)
.PP
در اینجا تعریف رسمی نحو الگو آورده شده است، مثال‌ها در ادامه آمده‌اند.
.PP
قوانین تطبیق Rclone از سبک glob پیروی می‌کنند:
.IP
.nf
\f[C]
*         با هر دنباله‌ای از نویسه‌های غیرجداکننده (/) مطابقت دارد
**        با هر دنباله‌ای از نویسه‌ها شامل جداکننده‌های / مطابقت دارد
?         با هر تک‌نویسهٔ غیرجداکننده (/) مطابقت دارد
[ [ ! ] { character-range } ]
          کلاس نویسه (نباید خالی باشد)
{ pattern-list }
          حالت‌های جایگزین الگو
{{ regexp }}
          عبارت باقاعده برای تطبیق
c         با نویسهٔ c مطابقت دارد (c != *, **, ?, \[rs], [, {, })
\[rs]c        با نویسهٔ رزرو شدهٔ c مطابقت دارد (c = *, **, ?, \[rs], [, {, }) یا کلاس نویسه
\f[R]
.fi
.PP
character-range:
.IP
.nf
\f[C]
c         با نویسهٔ c مطابقت دارد (c != \[rs], -, ])
\[rs]c        با نویسهٔ رزرو شدهٔ c مطابقت دارد (c = \[rs], -, ])
lo - hi   با نویسهٔ c برای lo <= c <= hi مطابقت دارد
\f[R]
.fi
.PP
pattern-list:
.IP
.nf
\f[C]
pattern { , pattern }
          الگوهای جداشده با کاما (بدون فاصله)
\f[R]
.fi
.PP
کلاس‌های نویسه (مرجع عبارات باقاعدهٔ Go را ببینید
(https://golang.org/pkg/regexp/syntax)) شامل موارد زیر است:
.IP
.nf
\f[C]
کلاس‌های نویسهٔ نام‌گذاری‌شده (مانند [\[rs]d], [\[ha]\[rs]d], [\[rs]D], [\[ha]\[rs]D])
کلاس‌های نویسهٔ Perl (مانند \[rs]s, \[rs]S, \[rs]w, \[rs]W)
کلاس‌های نویسهٔ ASCII (مانند [[:alnum:]], [[:alpha:]], [[:punct:]], [[:xdigit:]])
\f[R]
.fi
.PP
regexp برای کاربران پیشرفته جهت درج یک عبارت باقاعده \- برای اطلاعات بیشتر
به ادامه مراجعه کنید:
.IP
.nf
\f[C]
هر عبارت باقاعدهٔ re2 که حاوی \[ga]}}\[ga] نباشد
\f[R]
.fi
.PP
اگر الگوی فیلتر با یک \f[V]/\f[R] شروع شود، تنها در بالاترین سطح درخت دایرکتوری،
\f[B]نسبت به ریشهٔ ریموت\f[R] (نه لزوماً ریشهٔ درایو) مطابقت داده می‌شود.
اگر با \f[V]/\f[R] شروع نشود، تطبیق از \f[B]انتهای نام مسیر/فایل\f[R] آغاز
می‌شود، اما فقط با یک جزء کامل مسیر مطابقت می‌یابد \- باید از یک جداکنندهٔ
\f[V]/\f[R] یا ابتدای مسیر/فایل تطبیق داده شود.
.IP
.nf
\f[C]
file.jpg   - با \[dq]file.jpg\[dq] مطابقت دارد
           - با \[dq]directory/file.jpg\[dq] مطابقت دارد
           - با \[dq]afile.jpg\[dq] مطابقت ندارد
           - با \[dq]directory/afile.jpg\[dq] مطابقت ندارد
/file.jpg  - با \[dq]file.jpg\[dq] در دایرکتوری ریشهٔ ریموت مطابقت دارد
           - با \[dq]afile.jpg\[dq] مطابقت ندارد
           - با \[dq]directory/file.jpg\[dq] مطابقت ندارد
\f[R]
.fi
.PP
بالاترین سطح ریموت ممکن است بالاترین سطح درایو نباشد.
.PP
به‌عنوان مثال،
برای یک ساختار دایرکتوری محلی Microsoft Windows
.IP
.nf
\f[C]
F:
├── bkp
├── data
│   ├── excl
│   │   ├── 123.jpg
│   │   └── 456.jpg
│   ├── incl
│   │   └── document.pdf
\f[R]
.fi
.PP
برای کپی کردن محتویات پوشهٔ \f[V]data\f[R] به پوشهٔ \f[V]bkp\f[R] بدون در
نظر گرفتن محتویات زیرپوشهٔ \f[V]excl\f[R]، دستور زیر \f[V]F:\[rs]data\f[R]
و \f[V]F:\[rs]bkp\f[R] را به‌عنوان بالاترین سطح برای فیلتر کردن در نظر می‌گیرد.
.PP
\f[V]rclone copy F:\[rs]data\[rs] F:\[rs]bkp\[rs] --exclude=/excl/**\f[R]
.PP
\f[B]مهم:\f[R] در الگوهای نام مسیر/فایل از \f[V]/\f[R] استفاده کنید و نه
\f[V]\[rs]\f[R]، حتی اگر روی Microsoft Windows اجرا می‌کنید.
.PP
الگوهای ساده به حروف بزرگ و کوچک حساس هستند، مگر اینکه پرچم \f[V]--ignore-case\f[R]
استفاده شود.
.PP
بدون \f[V]--ignore-case\f[R] (پیش‌فرض)
.IP
.nf
\f[C]
potato - با \[dq]potato\[dq] مطابقت دارد
       - با \[dq]POTATO\[dq] مطابقت ندارد
\f[R]
.fi
.PP
با \f[V]--ignore-case\f[R]
.IP
.nf
\f[C]
potato - با \[dq]potato\[dq] مطابقت دارد
       - با \[dq]POTATO\[dq] مطابقت دارد
\f[R]
.fi.SS استفاده از عبارات باقاعده در الگوهای فیلتر
.PP
نحو الگوهای فیلتر برای آسان‌تر شدن کار کاربران، از نوع تطبیق سبک glob (مشابه آنچه
\f[V]bash\f[R] استفاده می‌کند) است.
با این حال، این روش کنترل کاملی بر روی تطبیق فراهم نمی‌کند، بنابراین rclone برای
کاربران پیشرفته نحو عبارات باقاعده (regular expression) را نیز ارائه می‌دهد.
.PP
نرم‌افزار rclone عموماً عبارات باقاعده به سبک Perl را می‌پذیرد؛ نحو
دقیق آن در مرجع عبارات باقاعده
Go (https://golang.org/pkg/regexp/syntax) تعریف شده است.
عبارات باقاعده باید درون \f[V]{{\f[R] \f[V]}}\f[R] قرار گیرند.
اگر glob با \f[V]/\f[R] شروع نشود، آن‌ها تنها با آخرین بخش مسیر مطابقت می‌یابند،
و اگر شروع شود با کل نام مسیر تطبیق داده می‌شوند.
توجه داشته باشید که rclone تلاشی برای تجزیه عبارت باقاعده ارائه‌شده
نمی‌کند؛ بدین معنا که استفاده از هرگونه فیلتر عبارت باقاعده مانع از
استفاده rclone از قوانین فیلتر دایرکتوری می‌شود، زیرا در عوض،
هر مسیر را در برابر عبارت(های) باقاعده ارائه‌شده بررسی خواهد کرد.
.PP
در اینجا نحوه تبدیل \f[V]{{regexp}}\f[R] به یک عبارت باقاعده کامل برای تطبیق با کل مسیر آورده شده است:
.IP
.nf
\f[C]
{{regexp}}  becomes (\[ha]|/)(regexp)$
/{{regexp}} becomes \[ha](regexp)$
\f[R]
.fi
.PP
نحو عبارت باقاعده می‌تواند با نحو glob ترکیب شود، برای مثال
.IP
.nf
\f[C]
*.{{jpe?g}} to match file.jpg, file.jpeg but not file.png
\f[R]
.fi
.PP
همچنین می‌توانید از پرچم‌های عبارت باقاعده استفاده کنید \- برای مثال برای حساس نبودن به حروف کوچک و بزرگ:
.IP
.nf
\f[C]
*.{{(?i)jpg}} to match file.jpg, file.JPG but not file.png
\f[R]
.fi
.PP
مراقب نویسه‌های عام (wildcard) در عبارات باقاعده باشید \- معمولاً نمی‌خواهید
آن‌ها در حالت عادی با جداکننده‌های مسیر تطابق پیدا کنند.
برای تطبیق با هر نام فایلی که با \f[V]start\f[R] شروع شده و با
\f[V]end\f[R] خاتمه می‌یابد بنویسید:
.IP
.nf
\f[C]
{{start[\[ha]/]*end\[rs].jpg}}
\f[R]
.fi
.PP
نه
.IP
.nf
\f[C]
{{start.*end\[rs].jpg}}
\f[R]
.fi
.PP
چرا که این حالت با دایرکتوری به نام \f[V]start\f[R] که حاوی فایلی با نام
\f[V]end.jpg\f[R] در آن باشد نیز مطابقت پیدا می‌کند، زیرا \f[V].*\f[R] با نویسه‌های
\f[V]/\f[R] تطابق خواهد یافت.
.PP
توجه داشته باشید که می‌توانید از \f[V]-vv --dump filters\f[R] برای نمایش الگوهای
فیلتر در قالب عبارت باقاعده استفاده کنید \- rclone الگوهای glob را با
تبدیل کردن آن‌ها به عبارات باقاعده پیاده‌سازی می‌کند.
.SS مثال‌های الگوی فیلتر
.PP
.TS
tab(@);
lw(19.2n) lw(14.0n) lw(12.2n) lw(24.5n).
T{
توضیحات
T}@T{
الگو
T}@T{
موارد منطبق
T}@T{
موارد غیرمنطبق
T}
_
T{
نویسه عام (Wildcard)
T}@T{
\f[V]*.jpg\f[R]
T}@T{
\f[V]/file.jpg\f[R]
T}@T{
\f[V]/file.png\f[R]
T}
T{
T}@T{
T}@T{
\f[V]/dir/file.jpg\f[R]
T}@T{
\f[V]/dir/file.png\f[R]
T}
T{
وابسته به ریشه (Rooted)
T}@T{
\f[V]/*.jpg\f[R]
T}@T{
\f[V]/file.jpg\f[R]
T}@T{
\f[V]/file.png\f[R]
T}
T{
T}@T{
T}@T{
\f[V]/file2.jpg\f[R]
T}@T{
\f[V]/dir/file.jpg\f[R]
T}
T{
جایگزین‌ها (Alternates)
T}@T{
\f[V]*.{jpg,png}\f[R]
T}@T{
\f[V]/file.jpg\f[R]
T}@T{
\f[V]/file.gif\f[R]
T}
T{
T}@T{
T}@T{
\f[V]/dir/file.png\f[R]
T}@T{
\f[V]/dir/file.gif\f[R]
T}
T{
نویسه عام مسیر (Path Wildcard)
T}@T{
\f[V]dir/**\f[R]
T}@T{
\f[V]/dir/anyfile\f[R]
T}@T{
\f[V]file.png\f[R]
T}
T{
T}@T{
T}@T{
\f[V]/subdir/dir/subsubdir/anyfile\f[R]
T}@T{
\f[V]/subdir/file.png\f[R]
T}
T{
هر نویسه‌ای (Any Char)
T}@T{
\f[V]*.t?t\f[R]
T}@T{
\f[V]/file.txt\f[R]
T}@T{
\f[V]/file.qxt\f[R]
T}
T{
T}@T{
T}@T{
\f[V]/dir/file.tzt\f[R]
T}@T{
\f[V]/dir/file.png\f[R]
T}
T{
بازه (Range)
T}@T{
\f[V]*.[a-z]\f[R]
T}@T{
\f[V]/file.a\f[R]
T}@T{
\f[V]/file.0\f[R]
T}
T{
T}@T{
T}@T{
\f[V]/dir/file.b\f[R]
T}@T{
\f[V]/dir/file.1\f[R]
T}
T{
گریز (Escape)
T}@T{
\f[V]*.\[rs]?\[rs]?\[rs]?\f[R]
T}@T{
\f[V]/file.???\f[R]
T}@T{
\f[V]/file.abc\f[R]
T}
T{
T}@T{
T}@T{
\f[V]/dir/file.???\f[R]
T}@T{
\f[V]/dir/file.def\f[R]
T}
T{
کلاس (Class)
T}@T{
\f[V]*.\[rs]d\[rs]d\[rs]d\f[R]
T}@T{
\f[V]/file.012\f[R]
T}@T{
\f[V]/file.abc\f[R]
T}
T{
T}@T{
T}@T{
\f[V]/dir/file.345\f[R]
T}@T{
\f[V]/dir/file.def\f[R]
T}
T{
عبارت باقاعده (Regexp)
T}@T{
\f[V]*.{{jpe?g}}\f[R]
T}@T{
\f[V]/file.jpeg\f[R]
T}@T{
\f[V]/file.png\f[R]
T}
T{
T}@T{
T}@T{
\f[V]/dir/file.jpg\f[R]
T}@T{
\f[V]/dir/file.jpeeg\f[R]
T}
T{
عبارت باقاعده ریشه‌دار (Rooted Regexp)
T}@T{
\f[V]/{{.*\[rs].jpe?g}}\f[R]
T}@T{
\f[V]/file.jpeg\f[R]
T}@T{
\f[V]/file.png\f[R]
T}
T{
T}@T{
T}@T{
\f[V]/file.jpg\f[R]
T}@T{
\f[V]/dir/file.jpg\f[R]
T}
.TE.SS نحوه اعمال قواعد فیلتر روی فایل‌ها
.PP
فیلترهای نام مسیر/فایل در rclone از یک یا چند پرچم (flag) زیر تشکیل شده‌اند:
.IP \[bu] 2
\f[V]--include\f[R]
.IP \[bu] 2
\f[V]--include-from\f[R]
.IP \[bu] 2
\f[V]--exclude\f[R]
.IP \[bu] 2
\f[V]--exclude-from\f[R]
.IP \[bu] 2
\f[V]--filter\f[R]
.IP \[bu] 2
\f[V]--filter-from\f[R]
.PP
می‌توان بیش از یک نمونه از هر پرچم را به کار برد.
.PP
ابزار rclone در داخل خود از یک فهرست ترکیبی از تمام قواعد شمول (include) و عدم شمول (exclude) استفاده می‌کند.
ترتیب پردازش قواعد می‌تواند بر نتیجه فیلتر تأثیر بگذارد.
.PP
تمام پرچم‌های هم‌نوع، صرف‌نظر از ترتیبی که انواع مختلف پرچم‌ها در خط فرمان قرار گرفته‌اند، با هم و طبق ترتیب بالا پردازش می‌شوند.
.PP
نمونه‌های متعدد از یک پرچم یکسان، از چپ به راست و با توجه به موقعیت آن‌ها در خط فرمان پردازش می‌شوند.
.PP
برای ترکیب و تغییر دادن ترتیب پردازش شمول‌ها و عدم شمول‌ها از پرچم‌های \f[V]--filter...\f[R] استفاده کنید.
.PP
در پرچم‌های \f[V]--include-from\f[R]، \f[V]--exclude-from\f[R] و \f[V]--filter-from\f[R]، قواعد از بالا به پایین فایلِ ارجاع‌شده پردازش می‌شوند.
.PP
اگر پرچم \f[V]--include\f[R] یا \f[V]--include-from\f[R] مشخص شده باشد، rclone یک قاعدهٔ \f[V]- **\f[R] ضمنی را در نظر می‌گیرد و آن را به انتهای فهرست قواعد داخلی خود اضافه می‌کند.
مشخص کردن یک قاعدهٔ \f[V]+\f[R] با یک پرچم \f[V]--filter...\f[R] موجب در نظر گرفتن چنین قاعدهٔ ضمنی نمی‌شود.
.PP
هر نام مسیر/فایل که از rclone عبور می‌کند با فهرست ترکیبی فیلترها تطبیق داده می‌شود.
در اولین تطابق با یک قاعده، نام مسیر/فایل شامل یا مستثنی می‌شود و هیچ قاعدهٔ فیلتر دیگری برای آن مسیر/فایل پردازش نخواهد شد.
.PP
اگر rclone پس از بررسی تمام قواعد (از جمله قاعدهٔ ضمنی در صورت لزوم)، هیچ تطابقی پیدا نکند، نام مسیر/فایل مشمول می‌شود.
.PP
هر مسیر/فایلی که در این مرحله مشمول شود، توسط دستور rclone پردازش می‌گردد.
.PP
پرچم‌های \f[V]--files-from\f[R]، \f[V]--files-from-raw\f[R] و \f[V]--files-from0\f[R] بر سایر گزینه‌های فیلتر اولویت دارند و نمی‌توان آن‌ها را با گزینه‌های فیلتر دیگر ترکیب کرد.
.PP
برای مشاهده فهرست ترکیبی قواعد داخلی در قالب عبارات باقاعده (regular expression) برای یک دستور، پرچم \f[V]--dump filters\f[R] را اضافه کنید.
اجرای دستور rclone با پرچم‌های \f[V]--dump filters\f[R] و \f[V]-vv\f[R] عناصر فیلتر داخلی را فهرست کرده و نحوه اعمال آن‌ها را بر هر مسیر/فایل مبدأ نشان می‌دهد.
در حال حاضر روشی برای ارسال مستقیم گزینه‌های فیلتر عبارت باقاعده به rclone ارائه نشده است، هرچند قواعد فیلتر کلاس نویسه (character class) حاوی کلاس‌های نویسه هستند.
مرجع عبارات باقاعده Go (https://golang.org/pkg/regexp/syntax)
.SS نحوه اعمال قواعد فیلتر روی دایرکتوری‌ها
.PP
دستورهای rclone روی نام‌های مسیر/فایل اعمال می‌شوند نه دایرکتوری‌ها.
کل محتویات یک دایرکتوری را می‌توان با الگوی \f[V]directory/*\f[R] یا به صورت بازگشتی با \f[V]directory/**\f[R] با یک فیلتر تطبیق داد.
.PP
قواعد فیلتر دایرکتوری با یک جداکننده پایانی \f[V]/\f[R] تعریف می‌شوند.
.PP
به عنوان مثال، \f[V]/directory/subdirectory/\f[R] یک قاعده فیلتر دایرکتوری rclone است.
.PP
دستورهای rclone می‌توانند از قواعد فیلتر دایرکتوری استفاده کنند تا مشخص شود که آیا به صورت بازگشتی وارد زیردایرکتوری‌ها شوند یا خیر.
این کار با جلوگیری از فهرست کردن دایرکتوری‌های غیرضروری، دسترسی به یک ریموت را بهینه‌سازی می‌کند.
اینکه آیا بهینه‌سازی مطلوب است یا خیر، به قواعد فیلتر مشخص‌شده و محتوای ریموت مبدأ بستگی دارد.
.PP
اگر از هرگونه فیلتر عبارت باقاعده استفاده شود، هیچ بهینه‌سازی بازگشتی در دایرکتوری امکان‌پذیر نخواهد بود، زیرا rclone باید هر مسیر را در برابر عبارت(های) باقاعده ارائه‌شده بررسی کند.
.PP
بهینه‌سازی بازگشت در دایرکتوری در صورتی رخ می‌دهد که یکی از شرایط زیر برقرار باشد:
.IP \[bu] 2
ریموت مبدأ از دستور پایه (primitive) \f[V]ListR\f[R] در rclone پشتیبانی نکند.
سرویس‌های local، sftp، Microsoft OneDrive و WebDAV از \f[V]ListR\f[R] پشتیبانی نمی‌کنند.
سرویس Google Drive و اکثر فضاهای ذخیره‌سازی نوع باکت (bucket) پشتیبانی می‌کنند.
فهرست کامل (https://rclone.org/overview/#optional-features)
.IP \[bu] 2
روی سایر ریموت‌ها (آن‌هایی که از \f[V]ListR\f[R] پشتیبانی می‌کنند)، در صورتی که دستور rclone به طور ذاتی بازگشتی نباشد، و به شرطی که با پرچم \f[V]--fast-list\f[R] اجرا نشده باشد.
دستورهای \f[V]ls\f[R]، \f[V]lsf -R\f[R] و \f[V]size\f[R] به طور ذاتی بازگشتی هستند اما \f[V]sync\f[R]، \f[V]copy\f[R] و \f[V]move\f[R] این‌گونه نیستند.
.IP \[bu] 2
هر زمانی که پرچم \f[V]--disable ListR\f[R] روی یک دستور rclone اعمال شود.
.PP
دستورهای rclone قواعد فیلتر دایرکتوری را از روی قواعد فیلتر مسیر/فایل استنباط می‌کنند.
برای مشاهده قواعد فیلتر دایرکتوری که rclone برای یک دستور استنباط کرده است، پرچم \f[V]--dump filters\f[R] را مشخص کنید.
.PP
به عنوان مثال، برای یک قاعده شمول:
.IP
.nf
\f[C]
/a/*.jpg
\f[R]
.fi
.PP
ابزار rclone قاعده شمول دایرکتوری زیر را استنباط می‌کند:
.IP
.nf
\f[C]
/a/
\f[R]
.fi
.PP
قواعد فیلتر دایرکتوری مشخص‌شده در یک دستور rclone می‌توانند دامنه دستور rclone را محدود کنند، اما فیلترهای مسیر/فایل همچنان باید تعیین شوند.
.PP
برای نمونه، دستور \f[V]rclone ls remote: --include /directory/\f[R] با هیچ فایلی تطابق نخواهد داشت.
از آنجا که این یک گزینه \f[V]--include\f[R] است، قاعده \f[V]--exclude **\f[R] به طور ضمنی در نظر گرفته می‌شود و الگوی \f[V]/directory/\f[R] تنها برای بهینه‌سازی دسترسی به ریموت با نادیده گرفتن همه‌چیز در خارج از آن دایرکتوری به کار می‌رود.
.PP
برای مثال، دستور \f[V]rclone ls remote: --filter-from filter-list.txt\f[R] با یک فایل \f[V]filter-list.txt\f[R]:
.IP
.nf
\f[C]
- /dir1/
- /dir2/
+ *.pdf
- **
\f[R]
.fi
.PP
تمام فایل‌های موجود در دایرکتوری‌های \f[V]dir1\f[R] یا \f[V]dir2\f[R] یا زیردایرکتوری‌های آن‌ها به طور کامل از فهرست‌گیری مستثنی می‌شوند.
تنها فایل‌های با پسوند \f[V]pdf\f[R] در ریشهٔ \f[V]remote:\f[R] یا زیردایرکتوری‌های آن فهرست می‌شوند.
قاعدهٔ \f[V]- **\f[R] از فهرست شدن هر مسیر/فایلی که قبلاً توسط قواعد بالا تطبیق نیافته باشد جلوگیری می‌کند.
.PP
گزینهٔ \f[V]exclude-if-present\f[R] بر اساس وجود یک فایل در یک دایرکتوری، یک قاعده عدم شمول دایرکتوری ایجاد می‌کند و نسبت به سایر قواعد فیلتر دایرکتوری rclone اولویت دارد.
.PP
هنگام استفاده از نحو فهرست الگو، اگر یک مورد الگو شامل \f[V]/\f[R] یا \f[V]**\f[R] باشد، rclone قادر نخواهد بود قاعده فیلتر دایرکتوری را از این فهرست الگو استنباط کند.
.PP
به عنوان مثال برای یک قاعده شمول:
.IP
.nf
\f[C]
{dir1/**,dir2/**}
\f[R]
.fi
.PP
ابزار rclone فقط فایل‌های زیر دایرکتوری‌های \f[V]dir1\f[R] یا \f[V]dir2\f[R] را تطبیق می‌دهد، اما نمی‌تواند از این فیلتر برای مستثنی کردن دایرکتوری \f[V]dir3\f[R] از پیمایش استفاده کند..PP
بهینه‌سازی بازگشت دایرکتوری ممکن است بر کارایی تأثیر بگذارد، اما معمولاً در نتیجه تأثیری ندارد.
یک استثنا در این مورد، عملیات sync همراه با گزینهٔ
\f[V]--create-empty-src-dirs\f[R] است که در آن هر دایرکتوری خالیِ پیمایش‌شده
ایجاد خواهد شد.
با مثال فهرست الگوی \f[V]{dir1/**,dir2/**}\f[R] در بالا، این کار باعث ایجاد یک
دایرکتوری خالی \f[V]dir3\f[R] در مقصد می‌شود (در صورتی که در مبدأ وجود داشته باشد).
تغییر فیلتر به \f[V]{dir1,dir2}/**\f[R]، یا تقسیم آن به دو قاعدهٔ include به‌صورت
\f[V]--include dir1/** --include dir2/**\f[R]، همان فایل‌ها را مطابقت می‌دهد
در حالی که دایرکتوری‌ها را نیز فیلتر می‌کند، با این نتیجه که دیگر دایرکتوری
خالی \f[V]dir3\f[R] ایجاد نخواهد شد.
.SS \f[V]--exclude\f[R] \- مستثنی کردن فایل‌های منطبق با الگو
.PP
نام‌های مسیر/فایل را بر اساس یک قاعدهٔ تک‌موردی استثنا از دستور rclone مستثنی می‌کند.
.PP
این پرچم می‌تواند تکرار شود.
برای ترتیب پردازش پرچم‌های فیلتر، موارد بالا را ببینید.
.PP
پرچم \f[V]--exclude\f[R] نباید همراه با پرچم‌های \f[V]--include\f[R]،
\f[V]--include-from\f[R]، \f[V]--filter\f[R] یا \f[V]--filter-from\f[R]
استفاده شود.
.PP
\f[V]--exclude\f[R] در صورت ترکیب با پرچم‌های \f[V]--files-from\f[R]،
\f[V]--files-from-raw\f[R] یا \f[V]--files-from0\f[R] هیچ تأثیری ندارد.
.PP
برای مثال،
\f[V]rclone ls remote: --exclude *.bak\f[R] تمام فایل‌های ‎.bak را از
فهرست‌بندی مستثنی می‌کند.
.PP
برای مثال،
\f[V]rclone size remote: --exclude \[dq]/dir/**\[dq]\f[R] اندازهٔ کل تمام فایل‌های
روی \f[V]remote:\f[R] را به استثنای موارد موجود در دایرکتوری ریشهٔ \f[V]dir\f[R]
و زیردایرکتوری‌های آن برمی‌گرداند.
.PP
برای مثال، در Microsoft Windows دستور
\f[V]rclone ls remote: --exclude \[dq]*\[rs][{JP,KR,HK}\[rs]]*\[dq]\f[R]
فایل‌های موجود در \f[V]remote:\f[R] را که فاقد \f[V][JP]\f[R]، \f[V][KR]\f[R]
یا \f[V][HK]\f[R] در نامشان هستند فهرست می‌کند.
علامت‌های نقل‌قول مانع از تفسیر نویسه‌های \f[V]\[rs]\f[R] توسط شل می‌شوند.
نویسه‌های \f[V]\[rs]\f[R] نویسه‌های \f[V][\f[R] و \f[V]]\f[R] را گریز می‌دهند (escape می‌کنند)
تا فیلتر rclone با آن‌ها به‌صورت لفظی رفتار کند نه به‌عنوان یک بازهٔ نویسه‌ای (character-range).
نویسه‌های \f[V]{\f[R] و \f[V]}\f[R] یک فهرست الگوی rclone را تعریف می‌کنند.
برای سایر سیستم‌عامل‌ها نقل‌قول‌های تکی لازم است، یعنی:
\f[V]rclone ls remote: --exclude \[aq]*\[rs][{JP,KR,HK}\[rs]]*\[aq]\f[R]
.SS \f[V]--exclude-from\f[R] \- خواندن الگوهای استثنا از فایل
.PP
نام‌های مسیر/فایل را بر اساس قواعد موجود در یک فایل مشخص، از دستور rclone
مستثنی می‌کند.
این فایل شامل فهرستی از توضیحات و قواعد الگو است.
.PP
به‌عنوان مثال در \f[V]exclude-file.txt\f[R]:
.IP
.nf
\f[C]
# a sample exclude rule file
*.bak
file2.jpg
\f[R]
.fi
.PP
دستور \f[V]rclone ls remote: --exclude-from exclude-file.txt\f[R] فایل‌های
روی \f[V]remote:\f[R] را به‌جز مواردی به نام \f[V]file2.jpg\f[R] یا دارای
پسوند \f[V].bak\f[R] فهرست می‌کند.
این معادل است با:
\f[V]rclone ls remote: --exclude file2.jpg --exclude \[dq]*.bak\[dq]\f[R].
.PP
این پرچم می‌تواند تکرار شود.
برای ترتیب پردازش پرچم‌های فیلتر، موارد بالا را ببینید.
.PP
پرچم \f[V]--exclude-from\f[R] در مواردی که چندین قاعدهٔ فیلترِ استثنا به یک
دستور rclone اعمال می‌شود، کاربردی است.
.PP
پرچم \f[V]--exclude-from\f[R] نباید همراه با پرچم‌های \f[V]--include\f[R]،
\f[V]--include-from\f[R]، \f[V]--filter\f[R] یا \f[V]--filter-from\f[R]
استفاده شود.
.PP
\f[V]--exclude-from\f[R] در صورت ترکیب با پرچم‌های \f[V]--files-from\f[R]،
\f[V]--files-from-raw\f[R] یا \f[V]--files-from0\f[R] هیچ تأثیری ندارد.
.PP
\f[V]--exclude-from\f[R] به همراه \f[V]-\f[R] قواعد فیلتر را از ورودی
استاندارد می‌خواند..SS \f[V]--include\f[R] \- شامل کردن فایل‌های منطبق با الگو
.PP
یک قاعدهٔ شمول بر اساس نام مسیرها/فایل‌ها به دستور rclone اضافه می‌کند.
.PP
این گزینه می‌تواند تکرار شود.
برای اطلاع از ترتیب پردازش گزینه‌های فیلتر، موارد بالا را ببینید.
.PP
گزینهٔ \f[V]--include\f[R] در صورت ترکیب با گزینه‌های
\f[V]--files-from\f[R]، \f[V]--files-from-raw\f[R] یا
\f[V]--files-from0\f[R] هیچ تأثیری ندارد.
.PP
گزینهٔ \f[V]--include\f[R] به معنی اعمال \f[V]--exclude **\f[R] در انتهای
فهرست فیلترهای داخلی rclone است.
بنابراین اگر گزینه‌های \f[V]--include\f[R] و \f[V]--include-from\f[R]
را با \f[V]--exclude\f[R]، \f[V]--exclude-from\f[R]،
\f[V]--filter\f[R] یا \f[V]--filter-from\f[R] ترکیب کنید، باید از قواعد
شمول برای تمام فایل‌هایی که می‌خواهید در عبارت include قرار گیرند استفاده نمایید.
برای انعطاف‌پذیری بیشتر از گزینهٔ \f[V]--filter-from\f[R] استفاده کنید.
.PP
به‌عنوان مثال،
دستور \f[V]rclone ls remote: --include \[dq]*.{png,jpg}\[dq]\f[R] فایل‌های
موجود در \f[V]remote:\f[R] با پسوند \f[V].png\f[R] و
\f[V].jpg\f[R] را فهرست می‌کند.
تمام فایل‌های دیگر مستثنی می‌شوند.
.PP
به‌عنوان مثال،
چندین دستور rclone copy را می‌توان با \f[V]--include\f[R]
و یک فهرست الگو ترکیب کرد.
.IP
.nf
\f[C]
rclone copy /vol1/A remote:A
rclone copy /vol1/B remote:B
\f[R]
.fi
.PP
معادل است با:
.IP
.nf
\f[C]
rclone copy /vol1 remote: --include \[dq]{A,B}/**\[dq]
\f[R]
.fi
.PP
به‌عنوان مثال،
دستور \f[V]rclone ls remote:/wheat --include \[dq]??[\[ha][:punct:]]*\[dq]\f[R]
فایل‌های دایرکتوری \f[V]wheat\f[R] در \f[V]remote:\f[R] (و
زیردایرکتوری‌های آن) را که نویسهٔ سوم آن‌ها علامت نگارشی نباشد فهرست می‌کند.
این مثال از یک کلاس نویسهٔ اسکی (https://golang.org/pkg/regexp/syntax)
استفاده می‌کند.
.SS \f[V]--include-from\f[R] \- خواندن الگوهای شمول از فایل
.PP
بر اساس قواعد موجود در یک فایل مشخص‌شده، نام مسیرها/فایل‌ها را به یک دستور rclone
اضافه می‌کند.
این فایل شامل فهرستی از توضیحات و قواعد الگو است.
.PP
به‌عنوان نمونه در \f[V]include-file.txt\f[R]:
.IP
.nf
\f[C]
# a sample include rule file
*.jpg
file2.avi
\f[R]
.fi
.PP
دستور \f[V]rclone ls remote: --include-from include-file.txt\f[R] فایل‌های
موجود در \f[V]remote:\f[R] با نام \f[V]file2.avi\f[R] یا پسوند
\f[V].jpg\f[R] را فهرست می‌کند.
این دستور معادل است با:
\f[V]rclone ls remote: --include file2.avi --include \[dq]*.jpg\[dq]\f[R].
.PP
این گزینه می‌تواند تکرار شود.
برای اطلاع از ترتیب پردازش گزینه‌های فیلتر، موارد بالا را ببینید.
.PP
گزینهٔ \f[V]--include-from\f[R] در مواردی که چندین قاعدهٔ فیلتر
شمول به یک دستور rclone اعمال می‌شود، کاربردی است.
.PP
گزینهٔ \f[V]--include-from\f[R] به معنی اعمال \f[V]--exclude **\f[R] در انتهای
یک فهرست فیلترهای داخلی rclone است.
بنابراین اگر گزینه‌های \f[V]--include\f[R] و \f[V]--include-from\f[R]
را با \f[V]--exclude\f[R]، \f[V]--exclude-from\f[R]،
\f[V]--filter\f[R] یا \f[V]--filter-from\f[R] ترکیب کنید، باید از قواعد
شمول برای تمام فایل‌هایی که می‌خواهید در عبارت include قرار گیرند استفاده نمایید.
برای انعطاف‌پذیری بیشتر از گزینهٔ \f[V]--filter-from\f[R] استفاده کنید.
.PP
گزینهٔ \f[V]--include-from\f[R] در صورت ترکیب با گزینه‌های
\f[V]--files-from\f[R]، \f[V]--files-from-raw\f[R] یا
\f[V]--files-from0\f[R] هیچ تأثیری ندارد.
.PP
گزینهٔ \f[V]--include-from\f[R] اگر پس از آن \f[V]-\f[R] بیاید، قواعد فیلتر را
از ورودی استاندارد می‌خواند..SS \f[V]--filter\f[R] \- افزودن یک قاعده پالایش فایل
.PP
مسیرها/نام‌های فایل را بر اساس یک قاعده واحد برای گنجاندن یا مستثنی کردن،
در قالب \f[V]+\f[R] یا \f[V]-\f[R]، برای دستور rclone مشخص می‌کند.
.PP
این پرچم می‌تواند تکرار شود.
برای اطلاع از ترتیبی که پرچم‌های فیلتر بر اساس آن پردازش می‌شوند، بخش بالا را ببینید.
.PP
گزینه \f[V]--filter +\f[R] با \f[V]--include\f[R] تفاوت دارد.
در مورد \f[V]--include\f[R]،‏ rclone قاعده
\f[V]--exclude *\f[R] را به طور ضمنی در نظر گرفته و آن را به انتهای فهرست قواعد
داخلی می‌افزاید.
اما \f[V]--filter...+\f[R] چنین قاعده‌ای را به صورت ضمنی اعمال نمی‌کند.
.PP
گزینه \f[V]--filter\f[R] هنگام ترکیب با پرچم‌های
\f[V]--files-from\f[R]، \f[V]--files-from-raw\f[R] یا
\f[V]--files-from0\f[R] هیچ تأثیری ندارد.
.PP
گزینه \f[V]--filter\f[R] نباید همراه با پرچم‌های \f[V]--include\f[R]،
\f[V]--include-from\f[R]، \f[V]--exclude\f[R] یا
\f[V]--exclude-from\f[R] استفاده شود.
.PP
برای نمونه:
دستور \f[V]rclone ls remote: --filter \[dq]- *.bak\[dq]\f[R] تمام
فایل‌های \f[V].bak\f[R] را از فهرست \f[V]remote:\f[R] مستثنی می‌کند.
.SS \f[V]--filter-from\f[R] \- خواندن الگوهای پالایش از یک فایل
.PP
مسیرها/نام‌های فایل را بر اساس قواعد موجود در یک فایل مشخص‌شده
به دستور rclone اضافه می‌کند.
این فایل شامل فهرستی از توضیحات و قواعد الگو است.
قواعد گنجاندن با \f[V]+\f[R] و قواعد مستثنی‌کردن با \f[V]-\f[R] آغاز می‌شوند.
علامت \f[V]!\f[R] قواعد موجود را پاک می‌کند.
قواعد به ترتیبی که تعریف شده‌اند پردازش می‌شوند.
.PP
این پرچم می‌تواند تکرار شود.
برای اطلاع از ترتیبی که پرچم‌های فیلتر بر اساس آن پردازش می‌شوند، بخش بالا را ببینید.
.PP
ترتیب قواعد فیلتر را طوری تنظیم کنید که محدودکننده‌ترین قاعده در ابتدا باشد و
به سمت پایین ادامه دهید.
.PP
خطوطی که با # یا ; آغاز می‌شوند نادیده گرفته شده و می‌توان از آن‌ها برای نوشتن
توضیحات استفاده کرد.
توضیحات درون‌خطی پشتیبانی نمی‌شوند.
\f[I]از \f[VI]-vv --dump filters\f[I] استفاده کنید تا ببینید چگونه در
عبارت باقاعده نهایی ظاهر می‌شوند.\f[R]
.PP
برای نمونه،
برای \f[V]filter-file.txt\f[R]:
.IP
.nf
\f[C]
# a sample filter rule file
- secret*.jpg
+ *.jpg
+ *.png
+ file2.avi
- /dir/tmp/** # WARNING! This text will be treated as part of the path.
- /dir/Trash/**
+ /dir/**
# exclude everything else
- *
\f[R]
.fi
.PP
دستور \f[V]rclone ls remote: --filter-from filter-file.txt\f[R] مسیرها/فایل‌های
روی \f[V]remote:\f[R] را فهرست می‌کند، شامل تمام فایل‌های \f[V]jpg\f[R] و
\f[V]png\f[R]، به استثنای هر موردی که با \f[V]secret*.jpg\f[R] مطابقت داشته باشد، و
شامل \f[V]file2.avi\f[R].
همچنین همه موارد موجود در دایرکتوری \f[V]dir\f[R] در ریشه
\f[V]remote\f[R] را در بر می‌گیرد، به جز \f[V]remote:dir/Trash\f[R] که آن
را مستثنی می‌کند.
هر چیز دیگری مستثنی می‌شود.
.PP
برای نمونه،
برای یک \f[V]filter-file.txt\f[R] جایگزین:
.IP
.nf
\f[C]
- secret*.jpg
+ *.jpg
+ *.png
+ file2.avi
- *
\f[R]
.fi
.PP
فایل‌های \f[V]file1.jpg\f[R]، \f[V]file3.png\f[R] و \f[V]file2.avi\f[R]
فهرست می‌شوند، در حالی که \f[V]secret17.jpg\f[R] و فایل‌های بدون پسوند
\f[V].jpg\f[R] یا \f[V].png\f[R] مستثنی می‌گردند.
.PP
برای نمونه،
برای یک \f[V]filter-file.txt\f[R] جایگزین:
.IP
.nf
\f[C]
+ *.jpg
+ *.gif
!
+ 42.doc
- *
\f[R]
.fi
.PP
تنها فایل 42.doc فهرست می‌شود.
قواعد پیشین توسط \f[V]!\f[R] پاک می‌شوند..SS \f[V]--files-from\f[R] \- خواندن فهرست نام‌های فایل‌های مبدأ
.PP
مسیرها/فایل‌ها را از روی فهرستی درون یک فایل مشخص‌شده به دستور rclone اضافه می‌کند.
rclone نام مسیرها/فایل‌ها را به ترتیب موجود در فهرست پردازش می‌کند، و نه هیچ فایل دیگری را.
.PP
هنگامی که از \f[V]--files-from\f[R]، \f[V]--files-from-raw\f[R] یا \f[V]--files-from0\f[R] استفاده شود، سایر پرچم‌های فیلتر (\f[V]--include\f[R]، \f[V]--include-from\f[R]،
\f[V]--exclude\f[R]، \f[V]--exclude-from\f[R]، \f[V]--filter\f[R] و
\f[V]--filter-from\f[R]) نادیده گرفته می‌شوند.
.PP
گزینهٔ \f[V]--files-from\f[R] فهرستی از فایل‌ها را به‌عنوان ورودی خود انتظار دارد.
فاصله‌های خالی ابتدا یا انتهای خطوط ورودی حذف می‌شوند.
خطوطی که با \f[V]#\f[R] یا \f[V];\f[R] آغاز شوند نادیده گرفته می‌شوند.
.PP
اگر پس از \f[V]--files-from\f[R] از \f[V]-\f[R] استفاده شود، فهرست فایل‌ها از ورودی استاندارد خوانده می‌شود.
.PP
دستورهای rclone به همراه پرچم \f[V]--files-from\f[R]، ریموت را می‌پیمایند و با نام‌های موجود در \f[V]--files-from\f[R] مانند مجموعه‌ای از فیلترها برخورد می‌کنند.
.PP
اگر پرچم‌های \f[V]--no-traverse\f[R] و \f[V]--files-from\f[R] با هم استفاده شوند، دستور rclone ریموت را نمی‌پیماید.
در عوض، به هر مسیر/فایلِ نام‌برده در فایل به‌صورت جداگانه رجوع می‌کند.
برای هر نام مسیر/فایل، معمولاً به ۱ فراخوانی API نیاز است.
این کار می‌تواند برای یک فهرست \f[V]--files-from\f[R] کوتاه و ریموتی حاوی فایل‌های فراوان کارآمد باشد.
.PP
اگر هر یک از نام‌های درون فایل \f[V]--files-from\f[R] در ریموت مبدأ موجود نباشد، دستورهای rclone خطایی صادر نمی‌کنند.
.PP
پرچم \f[V]--files-from\f[R] می‌تواند در یک دستور rclone تکرار شود تا نام‌های مسیر/فایل را از چندین فایل بخواند.
فایل‌ها از چپ به راست در خط فرمان خوانده می‌شوند.
.PP
مسیرهای درون فایل \f[V]--files-from\f[R] به‌صورت شروع‌شونده از ریشهٔ مشخص‌شده در دستور rclone تفسیر می‌شوند.
جداکننده‌های ابتدایی \f[V]/\f[R] نادیده گرفته می‌شوند.
اگر نیاز دارید ورودی به‌صورت خام پردازش شود، \f[V]--files-from-raw\f[R] را ببینید.
.PP
به‌عنوان مثال برای یک فایل \f[V]files-from.txt\f[R]:
.IP
.nf
\f[C]
# comment
file1.jpg
subdir/file2.jpg
\f[R]
.fi
.PP
دستور \f[V]rclone copy --files-from files-from.txt /home/me/pics remote:pics\f[R]
موارد زیر را، در صورت وجود و تنها همان فایل‌ها، کپی می‌کند.
.IP
.nf
\f[C]
/home/me/pics/file1.jpg        → remote:pics/file1.jpg
/home/me/pics/subdir/file2.jpg → remote:pics/subdir/file2.jpg
\f[R]
.fi
.PP
به‌عنوان مثال، برای کپی کردن فایل‌های زیر که با مسیر مطلق خود مشخص شده‌اند:
.IP
.nf
\f[C]
/home/user1/42
/home/user1/dir/ford
/home/user2/prefect
\f[R]
.fi
.PP
ابتدا یک زیرشاخهٔ مشترک پیدا کنید \- در این حالت \f[V]/home\f[R] \- و بقیه مسیر فایل‌ها را با یا بدون \f[V]/\f[R] ابتدایی درون \f[V]files-from.txt\f[R] قرار دهید، مانند:
.IP
.nf
\f[C]
user1/42
user1/dir/ford
user2/prefect
\f[R]
.fi
.PP
سپس آن‌ها را به یک ریموت کپی کنید:
.IP
.nf
\f[C]
rclone copy --files-from files-from.txt /home remote:backup
\f[R]
.fi
.PP
این سه فایل به این صورت منتقل می‌شوند:
.IP
.nf
\f[C]
/home/user1/42       → remote:backup/user1/important
/home/user1/dir/ford → remote:backup/user1/dir/file
/home/user2/prefect  → remote:backup/user2/stuff
\f[R]
.fi
.PP
یا اینکه اگر \f[V]/\f[R] به‌عنوان ریشه انتخاب شود، محتوای \f[V]files-from.txt\f[R] چنین خواهد بود:
.IP
.nf
\f[C]
/home/user1/42
/home/user1/dir/ford
/home/user2/prefect
\f[R]
.fi
.PP
دستور کپی به‌صورت زیر خواهد بود:
.IP
.nf
\f[C]
rclone copy --files-from files-from.txt / remote:backup
\f[R]
.fi
.PP
سپس یک دایرکتوری اضافی \f[V]home\f[R] روی ریموت ایجاد خواهد شد:
.IP
.nf
\f[C]
/home/user1/42       → remote:backup/home/user1/42
/home/user1/dir/ford → remote:backup/home/user1/dir/ford
/home/user2/prefect  → remote:backup/home/user2/prefect
\f[R]
.fi.SS \f[V]--files-from-raw\f[R] \- خواندن فهرست نام فایل‌های مبدأ بدون هیچ پردازشی
.PP
این پرچم همانند \f[V]--files-from\f[R] است، با این تفاوت که ورودی به‌صورت خام خوانده می‌شود.
خطوط دارای فاصله‌های خالی ابتدایی یا انتهایی، و خطوطی که با
\f[V];\f[R] یا \f[V]#\f[R] آغاز می‌شوند، بدون هیچ پردازشی خوانده می‌شوند.
دستور rclone lsf (<https://rclone.org/commands/rclone_lsf>) قالب سازگاری دارد
که می‌تواند برای خروجی گرفتن از فهرست فایل‌ها از ریموت‌ها جهت ورودی دادن به
\f[V]--files-from-raw\f[R] استفاده شود.
.SS \f[V]--files-from0\f[R] \- خواندن فهرست نام فایل‌های مبدأ جداشده با NUL
.PP
این پرچم همانند \f[V]--files-from-raw\f[R] است، با این تفاوت که ورودی به‌جای
خطوط جدید، با نویسه‌های NUL (\f[V]\[rs]0\f[R]) تفکیک می‌شود.
این ویژگی، امکان مدیریت نام فایل‌هایی را که حاوی نویسه‌های خط جدید (newline) هستند فراهم می‌کند.
.PP
این گزینه مشابه با گزینه \f[V]-print0\f[R] در \f[V]find\f[R] و گزینه
\f[V]-0\f[R] در \f[V]xargs\f[R] است.
.PP
به‌عنوان مثال، برای کپی کردن فایل‌های فهرست‌شده توسط \f[V]find\f[R]:
.IP
.nf
\f[C]
find /path -print0 | rclone copy --files-from0 - / remote:path
\f[R]
.fi
.SS \f[V]--ignore-case\f[R] \- غیرحساس کردن جستجوها به بزرگی و کوچکی حروف
.PP
به‌طور پیش‌فرض، الگوهای فیلتر rclone به بزرگی و کوچکی حروف حساس هستند.
پرچم \f[V]--ignore-case\f[R] تمام الگوهای فیلتر در خط فرمان را به بزرگی و کوچکی
حروف غیرحساس می‌کند.
.PP
به‌عنوان مثال،
\f[V]--include \[dq]zaphod.txt\[dq]\f[R] با فایل \f[V]Zaphod.txt\f[R] تطابق ندارد.
با استفاده از \f[V]--ignore-case\f[R] این تطابق برقرار می‌شود.
.SS نقل‌قول نویسه‌های ویژه پوسته
.PP
دستورات rclone با الگوهای فیلتری که شامل نویسه‌های ویژه پوسته (shell metacharacters) هستند
ممکن است در پوسته شما آن‌طور که انتظار می‌رود عمل نکنند و نیازمند نقل‌قول (کوت کردن) باشند.
.PP
به‌عنوان مثال، در linux و OSX (نویسه ویژه \f[V]*\f[R]):
.IP \[bu] 2
\f[V]--include \[rs]*.jpg\f[R]
.IP \[bu] 2
\f[V]--include \[aq]*.jpg\[aq]\f[R]
.IP \[bu] 2
\f[V]--include=\[aq]*.jpg\[aq]\f[R]
.PP
در Microsoft Windows فرایند بسط توسط خود دستور انجام می‌شود، نه پوسته؛ بنابراین
\f[V]--include *.jpg\f[R] نیازی به نقل‌قول ندارد.
.PP
اگر با خطای rclone:
\f[V]Command .... needs .... arguments maximum: you provided .... non flag arguments:\f[R]
مواجه شدید، علت معمولاً وجود فاصله در نام یک ریموت یا مقدار یک پرچم است.
راه‌حل در این صورت، نقل‌قول کردن (کوت کردن) مقادیر حاوی فاصله است.
.SS فیلترهای دیگر
.SS \f[V]--min-size\f[R] \- عدم انتقال فایل‌های کوچک‌تر از این مقدار
.PP
حداقل اندازه فایل را در حوزه دستور rclone کنترل می‌کند.
واحدهای پیش‌فرض \f[V]KiB\f[R] هستند اما اختصارات \f[V]B\f[R]،
\f[V]K\f[R]، \f[V]M\f[R]، \f[V]G\f[R]، \f[V]T\f[R] یا \f[V]P\f[R] نیز
معتبر می‌باشند.
.PP
به‌عنوان مثال،
\f[V]rclone ls remote: --min-size 50k\f[R] فایل‌های موجود در
\f[V]remote:\f[R] با اندازه ۵۰ کیلوبایت (\f[V]KiB\f[R]) یا بزرگ‌تر را فهرست می‌کند.
.PP
برای اطلاعات بیشتر، مستندات گزینه‌های اندازه (<https://rclone.org/docs#size-options>)
را ببینید.
.SS \f[V]--max-size\f[R] \- عدم انتقال فایل‌های بزرگ‌تر از این مقدار
.PP
حداکثر اندازه فایل را در حوزه دستور rclone کنترل می‌کند.
واحدهای پیش‌فرض \f[V]KiB\f[R] هستند اما اختصارات \f[V]B\f[R]،
\f[V]K\f[R]، \f[V]M\f[R]، \f[V]G\f[R]، \f[V]T\f[R] یا \f[V]P\f[R] نیز
معتبر می‌باشند.
.PP
به‌عنوان مثال،
\f[V]rclone ls remote: --max-size 1G\f[R] فایل‌های موجود در
\f[V]remote:\f[R] با اندازه ۱ گیگابایت (\f[V]GiB\f[R]) یا کوچک‌تر را فهرست می‌کند.
.PP
برای اطلاعات بیشتر، مستندات گزینه‌های اندازه (<https://rclone.org/docs#size-options>)
را ببینید..SS \f[V]--max-age\f[R] \- عدم انتقال فایل‌های قدیمی‌تر از این مقدار
.PP
حداکثر عمر فایل‌های موجود در دامنه یک دستور rclone را کنترل می‌کند.
.PP
گزینه \f[V]--max-age\f[R] فقط برای فایل‌ها اعمال می‌شود و نه دایرکتوری‌ها.
.PP
برای مثال،
دستور \f[V]rclone ls remote: --max-age 2d\f[R] فایل‌های موجود در
\f[V]remote:\f[R] با عمر ۲ روز یا کمتر را فهرست می‌کند.
.PP
برای اطلاع از قالب‌های معتبر، مستندات گزینه‌های زمان (https://rclone.org/docs/#time-options) را
ببینید.
.SS \f[V]--min-age\f[R] \- عدم انتقال فایل‌های جدیدتر از این مقدار
.PP
حداقل عمر فایل‌های موجود در دامنه یک دستور rclone را کنترل می‌کند.
(برای قالب‌های معتبر به \f[V]--max-age\f[R] مراجعه کنید)
.PP
گزینه \f[V]--min-age\f[R] فقط برای فایل‌ها اعمال می‌شود و نه دایرکتوری‌ها.
.PP
برای مثال،
دستور \f[V]rclone ls remote: --min-age 2d\f[R] فایل‌های موجود در
\f[V]remote:\f[R] با عمر ۲ روز یا بیشتر را فهرست می‌کند.
.PP
برای اطلاع از قالب‌های معتبر، مستندات گزینه‌های زمان (https://rclone.org/docs/#time-options) را
ببینید.
.SS \f[V]--hash-filter\f[R] \- انتخاب قطعی زیرمجموعه‌ای از فایل‌ها
.PP
پرچم \f[V]--hash-filter\f[R] امکان انتخاب یک زیرمجموعه معین و قطعی از فایل‌ها را فراهم می‌کند که برای موارد زیر مفید است:
.IP "1." 3
اجرای عملیات‌های همگام‌سازی بزرگ در میان چندین ماشین.
.IP "2." 3
بررسی زیرمجموعه‌ای از فایل‌ها برای پوسیدگی بیت (bitrot).
.IP "3." 3
هرگونه عملیات دیگری که در آن به نمونه‌ای از فایل‌ها نیاز باشد.
.SS نحوه استفاده (Syntax)
.PP
این پرچم دو پارامتر را دریافت می‌کند که به صورت یک کسر بیان می‌شوند:
.IP
.nf
\f[C]
--hash-filter K/N
\f[R]
.fi
.IP \[bu] 2
\f[V]N\f[R]: تعداد کل افرازها (باید یک عدد صحیح مثبت باشد).
.IP \[bu] 2
\f[V]K\f[R]: افراز مشخص برای انتخاب (یک عدد صحیح از
\f[V]0\f[R] تا \f[V]N\f[R]).
.PP
برای مثال:
.IP \[bu] 2
\f[V]--hash-filter 1/3\f[R]: یک‌سوم نخست فایل‌ها را انتخاب می‌کند.
.IP \[bu] 2
\f[V]--hash-filter 2/3\f[R] و \f[V]--hash-filter 3/3\f[R]: به‌ترتیب افرازهای دوم و سوم را انتخاب می‌کنند.
.PP
افرازها هیچ هم‌پوشانی با یکدیگر ندارند و تضمین می‌شود که تمام فایل‌ها بدون تکرار پوشش داده می‌شوند.
.SS انتخاب تصادفی افراز
.PP
برای انتخاب تصادفی یک افراز، از \f[V]\[at]\f[R] به عنوان \f[V]K\f[R] استفاده کنید:
.IP
.nf
\f[C]
--hash-filter \[at]/M
\f[R]
.fi
.PP
برای مثال، \f[V]--hash-filter \[at]/3\f[R] به‌طور تصادفی عددی بین 0 و 2 را انتخاب خواهد کرد.
این مقدار در طول تلاش‌های مجدد ثابت باقی می‌ماند.
.SS نحوه کارکرد
.IP \[bu] 2
ابزار Rclone مسیر کامل هر فایل را دریافت کرده، آن را به حروف کوچک تبدیل می‌کند و نرمال‌سازی یونیکد را روی آن اعمال می‌نماید.
.IP \[bu] 2
سپس مسیر نرمال‌شده را به یک عدد ۶۴ بیتی هش می‌کند.
.IP \[bu] 2
نتیجه هش به پیمانه \f[V]N\f[R] محاسبه می‌شود تا فایل به یک افراز تخصیص یابد.
.IP \[bu] 2
اگر افراز محاسبه‌شده با \f[V]K\f[R] مطابقت نداشته باشد، فایل کنار گذاشته می‌شود.
.IP \[bu] 2
اگر فایل کنار گذاشته نشود، ممکن است فیلترهای دیگر نیز اعمال شوند.
.PP
\f[B]مهم:\f[R] ابزار Rclone برای اعمال این فیلتر تمام دایرکتوری‌ها را پیمایش خواهد کرد..SS نکات استفاده
.IP \[bu] 2
استفاده همراه با \f[V]rclone sync\f[R] ایمن است؛ موارد انتخابی مبدا و مقصد
تطابق خواهند داشت.
.IP \[bu] 2
همراه با \f[V]--delete-excluded\f[R] استفاده \f[B]نکنید\f[R]، زیرا این کار
ممکن است فایل‌های انتخاب‌نشده را حذف کند.
.IP \[bu] 2
در صورت استفاده از \f[V]--files-from\f[R]، \f[V]--files-from-raw\f[R] یا
\f[V]--files-from0\f[R] نادیده گرفته می‌شود.
.SS مثال‌ها
.SS تقسیم فایل‌ها به ۴ بخش
.PP
با فرض اینکه دایرکتوری فعلی شامل \f[V]file1.jpg\f[R] تا
\f[V]file9.jpg\f[R] باشد:
.IP
.nf
\f[C]
$ rclone lsf --hash-filter 0/4 .
file1.jpg
file5.jpg

$ rclone lsf --hash-filter 1/4 .
file3.jpg
file6.jpg
file9.jpg

$ rclone lsf --hash-filter 2/4 .
file2.jpg
file4.jpg

$ rclone lsf --hash-filter 3/4 .
file7.jpg
file8.jpg

$ rclone lsf --hash-filter 4/4 . # the same as --hash-filter 0/4
file1.jpg
file5.jpg
\f[R]
.fi
.SS همگام‌سازی یک‌چهارم نخست فایل‌ها
.IP
.nf
\f[C]
rclone sync --hash-filter 1/4 source:path destination:path
\f[R]
.fi
.SS بررسی یکپارچگی ۱٪ تصادفی از فایل‌ها
.IP
.nf
\f[C]
rclone check --download --hash-filter \[at]/100 source:path destination:path
\f[R]
.fi
.SS سایر پرچم‌ها
.SS \f[V]--delete-excluded\f[R] \- حذف فایل‌های مستثنا شده از همگام‌سازی در مقصد
.PP
\f[B]مهم:\f[R] این پرچم برای داده‌های شما خطرناک است \- ابتدا همراه با
\f[V]--dry-run\f[R] و \f[V]-v\f[R] استفاده کنید.
.PP
در همراهی با \f[V]rclone sync\f[R]، پرچم \f[V]--delete-excluded\f[R]
هر فایلی را در مقصد که از دستور مستثنا شده باشد حذف می‌کند.
.PP
به‌عنوان مثال، دامنه \f[V]rclone sync --interactive A: B:\f[R] می‌تواند
محدود شود:
.IP
.nf
\f[C]
rclone --min-size 50k --delete-excluded sync A: B:
\f[R]
.fi
.PP
تمام فایل‌های موجود در \f[V]B:\f[R] که کمتر از 50 KiB هستند حذف می‌شوند زیرا
از دستور rclone sync مستثنا شده‌اند.
.SS \f[V]--dump filters\f[R] \- تخلیه فیلترها در خروجی
.PP
فیلترهای تعریف‌شده را در قالب عبارت باقاعده (regular expression) در خروجی
استاندارد تخلیه می‌کند.
.PP
برای اشکال‌زدایی مفید است..SS استثنا کردن دایرکتوری بر اساس یک فایل (Exclude directory based on a file)
.PP
پرچم \f[V]--exclude-if-present\f[R] بر اساس وجود یک فایل مشخص درون دایرکتوری،
تعیین می‌کند که آیا آن دایرکتوری در محدوده پردازش دستور rclone قرار بگیرد یا خیر.
این پرچم می‌تواند برای بررسی چندین نام فایل تکرار شود؛ وجود هر یک از آن‌ها
موجب استثنا شدن دایرکتوری خواهد شد.
.PP
این پرچم نسبت به سایر پرچم‌های فیلتر اولویت دارد.
.PP
برای مثال برای ساختار دایرکتوری زیر:
.IP
.nf
\f[C]
dir1/file1
dir1/dir2/file2
dir1/dir2/dir3/file3
dir1/dir2/dir3/.ignore
\f[R]
.fi
.PP
دستور \f[V]rclone ls --exclude-if-present .ignore dir1\f[R] موارد
\f[V]dir3\f[R]، \f[V]file3\f[R] یا \f[V].ignore\f[R] را فهرست نمی‌کند.
.SS فیلترهای فراداده (Metadata filters)
.PP
فیلترهای فراداده روش کاری بسیار مشابهی با فیلترهای معمولی نام فایل دارند،
با این تفاوت که با فراداده‌ها (https://rclone.org/docs/#metadata) روی
شیء مطابقت داده می‌شوند.
.PP
فراداده باید به‌صورت الگوهای \f[V]key=value\f[R] مشخص شود.
این الگوها می‌توانند با استفاده از الگوهای فیلتر عادی (wildcard) یا
عبارات باقاعده (regular expressions) تعریف شوند.
.PP
برای مثال، اگر بخواهید فقط فایل‌های محلی با حالت (mode) دسترسی
\f[V]100664\f[R] را فهرست کنید، می‌توانید این کار را انجام دهید:
.IP
.nf
\f[C]
rclone lsf -M --files-only --metadata-include \[dq]mode=100664\[dq] .
\f[R]
.fi
.PP
یا اگر بخواهید فایل‌هایی با \f[V]atime\f[R]، \f[V]mtime\f[R]
یا \f[V]btime\f[R] در یک تاریخ مشخص را نمایش دهید:
.IP
.nf
\f[C]
rclone lsf -M --files-only --metadata-include \[dq][abm]time=2022-12-16*\[dq] .
\f[R]
.fi
.PP
همانند فیلتر کردن فایل‌ها، فیلتر فراداده نیز فقط بر روی فایل‌ها اعمال
می‌شود و نه بر روی دایرکتوری‌ها.
.PP
فیلترها را می‌توان با استفاده از این پرچم‌ها اعمال کرد:
.IP \[bu] 2
\f[V]--metadata-include\f[R] \- شامل کردن فراداده‌های منطبق با الگو
.IP \[bu] 2
\f[V]--metadata-include-from\f[R] \- خواندن الگوهای شامل‌سازی فراداده از فایل
(استفاده از \- برای خواندن از stdin)
.IP \[bu] 2
\f[V]--metadata-exclude\f[R] \- استثنا کردن فراداده‌های منطبق با الگو
.IP \[bu] 2
\f[V]--metadata-exclude-from\f[R] \- خواندن الگوهای استثنا‌سازی فراداده از فایل
(استفاده از \- برای خواندن از stdin)
.IP \[bu] 2
\f[V]--metadata-filter\f[R] \- افزودن یک قاعده فیلتر فراداده
.IP \[bu] 2
\f[V]--metadata-filter-from\f[R] \- خواندن الگوهای فیلتر فراداده از یک فایل
(استفاده از \- برای خواندن از stdin)
.PP
هر پرچم می‌تواند تکرار شود.
برای جزئیات بیشتر به بخش نحوه اعمال قوانین فیلتر مراجعه کنید \- این پرچم‌ها
دقیقاً مشابه پرچم‌های فیلتر نام فایل عمل می‌کنند، اما به‌جای الگوهای نام فایل،
دارای الگوهای فراداده هستند.
.SS اشتباهات رایج (Common pitfalls)
.PP
متداول‌ترین مشکلات مرتبط با فیلترها در انجمن rclone
(https://forum.rclone.org) عبارتند از:
.IP \[bu] 2
عدم استفاده از مسیرهای نسبی نسبت به ریشه remote
.IP \[bu] 2
عدم استفاده از \f[V]/\f[R] برای تطابق از ریشه یک remote
.IP \[bu] 2
عدم استفاده از \f[V]**\f[R] برای تطبیق محتویات یک دایرکتوری.SH rclone gui
.PP
دستور \f[V]rclone gui\f[R] واسط گرافیکی وب (Web GUI) رسمی که همراه با rclone
ارائه می‌شود را راه‌اندازی می‌کند.
.PP
با این دستور، rclone می‌تواند یک واسط گرافیکی کاربر (GUI) تحت وب را ارائه دهد
که از طریق یک مرورگر وب معمولی قابل دسترسی است.
.PP
آن را در ترمینال اجرا کنید تا rclone مقداردهی اولیه شده و سپس GUI را آغاز کند.
.IP
.nf
\f[C]
rclone gui
\f[R]
.fi
.PP
این دستور گزارش‌هایی مانند نمونهٔ زیر تولید خواهد کرد.
پنجرهٔ ترمینال برای تداوم اجرای GUI باید باز بماند:
.IP
.nf
\f[C]
2026/04/14 11:36:04 NOTICE: Serving remote control on http://127.0.0.1:50803
2026/04/14 11:36:04 NOTICE: Serving GUI on http://127.0.0.1:50802
2026/04/14 11:36:04 NOTICE: GUI available at http://127.0.0.1:50802/login?pass=XXX&url=http%3A%2F%2F127.0.0.1%3A50803%2F&user=gui
\f[R]
.fi
.PP
شما همچنین می‌توانید هنگام اجرای GUI فلگ‌های اشکال‌زدایی را اضافه کنید؛
مانند \f[V]\-v\f[R] که خروجی گزارش‌های بیشتری را از سرور rc نمایش می‌دهد.
.SS "استفاده از رابط کاربری (Using the GUI)"
.PP
به‌محض باز شدن مرورگر، داشبورد (Dashboard) به شما نمایش داده می‌شود؛
صفحهٔ اصلی که در آن می‌توانید وضعیت ریموت‌ها و سیستم خود را مشاهده کنید.
.PP
در بالا، از سمت چپ، مجموعه‌ای از زبانه‌ها (تب‌ها) را مشاهده می‌کنید که
می‌توانید روی آن‌ها کلیک کنید.
در سمت راست، دکمهٔ خروج و در صورت انتشار نسخهٔ جدیدی از rclone، پیام
\[dq]Update available\[dq] نمایش داده خواهد شد.
.SS "داشبورد (Dashboard)"
.PP
معیارها (متریک‌ها) را به‌صورت زنده ببینید، از نزدیک شدن ظرفیت ریموت‌هایتان به
حداکثر مطلع شوید، و تغییرات نسخهٔ جاری (changelog) را بخوانید.
.SS "کاوشگر (Explorer)"
.PP
دیسک‌های محلی و ریموت‌ها را کاوش و مدیریت کنید، فایل‌ها و پوشه‌ها را بارگیری
کرده و فرایندهای انتقال را آغاز نمایید.
.SS "ریموت‌ها (Remotes)"
.PP
فهرست ریموت‌ها را مرور کرده و روی آن‌ها ضربه بزنید تا به کاوشگر هدایت شوید.
در آنجا می‌توانید در محتوای ریموت‌های خود گردش کنید، انتقال دهید، بارگیری نمایید
و حتی فایل‌ها را بارگذاری کنید.
.SS "اتصال‌ها (Mounts)"
.PP
ریموت‌ها را به‌عنوان درایوهای محلی روی رایانهٔ خود سوار (mount) کنید و اتصال‌های
موجود را بررسی نمایید.
.SS "سرویس‌دهنده‌ها (Serves)"
.PP
اطلاعات سریعی دربارهٔ نمونه‌های در حال ارائه (serve) فعال به دست آورید و موارد
جدیدی را آغاز کنید.
.SS "تنظیمات (Settings)"
.PP
فایل \f[V]rclone.conf\f[R] خود را به‌طور مستقیم ویرایش کرده و فلگ‌های
گزارش‌گیری و پارامترهای عملکرد را تنظیم نمایید.
.SS "نحوه کارکرد (How it works)"
.PP
هنگامی که \f[V]rclone gui\f[R] را اجرا می‌کنید، این اتفاقات رخ می‌دهد:
.IP \[bu] 2
برنامهٔ rclone رابط برنامه‌نویسی کنترل از راه دور (API با نام \[dq]rc\[dq]) را راه‌اندازی می‌کند.
.IP \[bu] 2
برنامهٔ rclone سرور دومی را برای میزبانی واسط گرافیکی وب (Web GUI) راه‌اندازی می‌کند.
.IP \[bu] 2
اگر درگاه (پورت)، نام کاربری یا گذرواژه مشخص نشده باشد، مقادیر ناموجود به‌طور خودکار
تولید می‌شوند.
.IP \[bu] 2
مگر اینکه گزینهٔ \f[V]\-\-no\-open\-browser\f[R] ارسال شده باشد، پنجرهٔ مرورگر باز
خواهد شد.
.IP \[bu] 2
نشانی URL از قبل حاوی نام کاربری و گذرواژه است؛ در این صورت رابط کاربری از
این مقادیر استفاده کرده و شما را به‌طور خودکار وارد سیستم می‌کند.
.SS "امنیت (Security)"
.PP
بسیار مهم است که ابتدا بیندیشید rclone به چه مواردی دسترسی دارد و ممکن است چه
اطلاعاتی را به اشتراک بگذارید.
.PP
چند تدبیر مناسب:
.IP \[bu] 2
از گزینهٔ \f[V]\-\-no\-auth\f[R] استفاده نکنید (این گزینه صرفاً برای آزمایش است).
.IP \[bu] 2
آن را در شبکهٔ محلی در دسترس قرار ندهید (مثلاً با
\f[V]\-\-api\-addr :5572 \-\-addr   :8080\f[R])، مگر اینکه به همهٔ دستگاه‌های
شبکهٔ محلی خود اطمینان داشته باشید.
استفاده از \f[V]127.0.0.1\f[R] یا \f[V]localhost\f[R] (حالت پیش‌فرض) ارجح است.
.IP \[bu] 2
در صورت استفاده از \f[V]\-\-user\f[R] و \f[V]\-\-pass\f[R]، از گذرواژه‌های قوی و
نام‌های کاربری غیرقابل‌حدس (نه مواردی مثل \[dq]admin\[dq] یا \[dq]rclone\[dq]) بهره بگیرید.
.IP \[bu] 2
اگر می‌خواهید آن را روی یک سرور میزبانی کرده و از راه دور به آن دسترسی داشته باشید،
مطمئن شوید که فقط رابط گرافیکی (GUI) را در معرض دسترسی قرار می‌دهید، نه RC API را.
آن‌ها روی درگاه‌های (پورت‌های) متفاوتی گوش می‌دهند.
.PP
اگر قصد دارید از راه دور به آن دسترسی داشته باشید اما تمایلی به راه‌اندازی پروکسی و
باز کردن درگاه‌ها ندارید، می‌توانید از Cloudflare Tunnels یا localhost.run یا
Tailscale استفاده کنید (که همگی رایگان هستند)..SS گزینه‌ها (OPTIONS)
.IP
.nf
\f[C]
      --addr stringArray       IPaddress:Port برای کارساز GUI (پیش‌فرض: درگاه خودکار localhost)
      --api-addr stringArray   IPaddress:Port برای کارساز RC API (پیش‌فرض: درگاه خودکار localhost)
      --enable-metrics         فعال‌سازی نقطه پایانی سازگار با OpenMetrics/Prometheus در /metrics
  -h, --help                   راهنمای gui
      --no-auth                عدم نیاز به احراز هویت برای RC API
      --no-open-browser        عدم باز کردن خودکار مرورگر
      --pass string            گذرواژه برای احراز هویت RC
      --user string            نام کاربری برای احراز هویت RC
\f[R]
.fi
.SS تاریخچه (History)
.PP
در نگارش 1.74، رابط کاربری گرافیکی (GUI) برای سهولت استفاده بازنویسی شد و درون rclone قرار گرفت.
بسته GUI به صورت یک فایل فشرده zip تعبیه‌شده در باینری rclone عرضه می‌شود
و در زمان اجرا از درون این فایل zip ارائه می‌گردد.
.SH "کنترل از راه دور rclone با API (Remote controlling rclone with its API)"
.PP
اگر rclone با پرچم \f[V]--rc\f[R] اجرا شود، یک کارساز HTTP را راه‌اندازی می‌کند
که می‌توان از آن برای کنترل از راه دور rclone با استفاده از API آن بهره برد.
.PP
شما می‌توانید برای دسترسی به API از دستور rc استفاده کنید یا مستقیماً
از طریق HTTP متصل شوید.
.PP
اگر صرفاً می‌خواهید یک کنترل از راه دور را اجرا کنید، دستور
rcd (https://rclone.org/commands/rclone_rcd) را ببینید.
.SS امنیت (Security)
.PP
\f[B]دسترسی به API مربوط به rc معادل دسترسی به شل (shell) در قالب کاربری است که rclone را اجرا می‌کند.\f[R]
با درگاه rc همانند یک ورود تعاملی به سیستم میزبان رفتار کنید.
.PP
هر فراخواننده‌ای که بتواند به API متصل شود (و در صورت فعال بودن احراز هویت، آن را پشت سر بگذارد)،
می‌تواند اقدامات زیر و موارد دیگر را انجام دهد:
.IP \[bu] 2
\f[B]اجرای دستورات سیستم‌عامل\f[R] در قالب کاربر rclone.
دستور \f[V]core/command\f[R] باینری rclone را با آرگومان‌های دلخواه مجدداً اجرا می‌کند،
و چندین گزینه پشتیبان (backend) نیز به اجرای برنامه‌ها در شل می‌پردازند؛ بنابراین حتی
ایجاد یک ریموت با \f[V]config/create\f[R] می‌تواند منجر به اجرای دستورات سیستمی شود.
.IP \[bu] 2
\f[B]خواندن و نوشتن هر فایلی\f[R] که برای فرایند rclone در دسترس باشد، از طریق
هدایت \f[V]operations/*\f[R] یا \f[V]sync/*\f[R] به یک ریموت \f[V]local\f[R]
(یا از طریق \f[V]--rc-files\f[R] / \f[V]--rc-serve\f[R]).
نوشتن فایل‌های دلخواه در قالب کاربر rclone به خودی خود مسیری برای اجرای کد است.
.IP \[bu] 2
\f[B]بازخوانی اطلاعات هویتی و اعتبارسنجی ذخیره‌شده.\f[R] پیکربندی‌های rclone معمولاً حاوی
اطلاعات محرمانه ارائه‌دهندگان ابری هستند.
دستور \f[V]config/dump\f[R] و موارد مشابه آن‌ها را افشا می‌کنند؛ بنابراین نفوذ به rc
به تمام backendهای پیکربندی‌شده دسترسی پیدا می‌کند.
.IP \[bu] 2
\f[B]تغییر رفتار زمان اجرای rclone\f[R] با
\f[V]options/set\f[R]، \f[B]مدیریت ریموت‌ها\f[R] با \f[V]config/*\f[R]،
و \f[B]متوقف کردن فرایند\f[R] با \f[V]core/quit\f[R].
.PP
در حال حاضر هیچ سازوکار سطح دسترسی یا محدوده‌بندی (scope) به ازای هر نقطه پایانی وجود ندارد:
احراز هویت به صورت صفر و یکی (همه‌یاهیچ) است.
اعطای هرگونه دسترسی، تمامی دسترسی‌های فوق را فراهم می‌کند.
.PP
در نتیجه:
.IP \[bu] 2
\f[B]سرویس rc را به آدرس شبکه‌ای که تحت کنترل شما نیست متصل (bind) نکنید.\f[R]
آدرس پیش‌فرض لوپ‌بک (\f[V]localhost:5572\f[R]) است؛ مگر اینکه دلیل خاصی برای تغییر آن داشته باشید،
آن را تغییر ندهید.
.IP \[bu] 2
\f[B]روی اتصالات غیر از لوپ‌بک از \f[VB]--rc-no-auth\f[B] استفاده نکنید.\f[R] این پرچم
احراز هویت را در نقاط پایانی دسترسی به ریموت‌ها غیرفعال می‌کند \[em] به
\f[V]--rc-no-auth\f[R] مراجعه کنید.
.IP \[bu] 2
\f[B]از احراز هویت و TLS استفاده کنید\f[R]
(\f[V]--rc-user\f[R]/\f[V]--rc-pass\f[R] یا \f[V]--rc-htpasswd\f[R]،
به همراه \f[V]--rc-cert\f[R]/\f[V]--rc-key\f[R]) هر زمان که درگاه توسط هر فردی
که کاملاً به او اعتماد ندارید قابل دسترسی است، و مقدار
\f[V]--rc-min-tls-version\f[R] را افزایش دهید.
.SS پارامترهای پشتیبانی‌شده (Supported parameters)
.SS --rc
.PP
پرچمی برای راه‌اندازی کارساز http جهت گوش فرادادن به درخواست‌های راه دور..SS --rc-addr=IP
.PP
آدرس IP:درگاه یا :درگاه برای مقید کردن (bind) سرور به آن.
(پیش‌فرض: \[dq]localhost:5572\[dq]).
.SS --rc-cert=KEY
.PP
کلید SSL PEM (ترکیب گواهی و گواهی CA).
.SS --rc-client-ca=PATH
.PP
مرجع صدور گواهی کلاینت (CA) برای اعتبارسنجی کلاینت‌ها.
.SS --rc-htpasswd=PATH
.PP
فایل htpasswd \- در صورت عدم ارائه، هیچ احراز هویتی انجام نمی‌شود.
.SS --rc-key=PATH
.PP
فایل کلید خصوصی TLS PEM.
.SS --rc-max-header-bytes=VALUE
.PP
حداکثر اندازه سرآیند درخواست (پیش‌فرض 4096).
.SS --rc-min-tls-version=VALUE
.PP
حداقل نسخه TLS قابل قبول.
مقادیر معتبر عبارتند از \[dq]tls1.0\[dq]، \[dq]tls1.1\[dq]، \[dq]tls1.2\[dq]
و \[dq]tls1.3\[dq] (پیش‌فرض \[dq]tls1.0\[dq]).
.SS --rc-user=VALUE
.PP
نام کاربری برای احراز هویت.
.SS --rc-pass=VALUE
.PP
گذرواژه برای احراز هویت.
.SS --rc-realm=VALUE
.PP
قلمرو (Realm) برای احراز هویت (پیش‌فرض \[dq]rclone\[dq]).
.SS --rc-server-read-timeout=DURATION
.PP
مهلت زمانی سرور برای خواندن داده‌ها (پیش‌فرض 1h0m0s).
.SS --rc-server-write-timeout=DURATION
.PP
مهلت زمانی سرور برای نوشتن داده‌ها (پیش‌فرض 1h0m0s).
.SS --rc-serve
.PP
فعال‌سازی سرویس‌دهی اشیاء ریموت از طریق رابط HTTP.
این بدان معناست که اشیاء به‌طور پیش‌فرض در
\f[V]http://127.0.0.1:5572/\f[R] در دسترس خواهند بود، بنابراین می‌توانید برای مشاهده فهرستی از ریموت‌ها به
\f[V]http://127.0.0.1:5572/\f[R] یا \f[V]http://127.0.0.1:5572/*\f[R] مراجعه کنید.
اشیاء را می‌توان با استفاده از این ساختار از ریموت‌ها درخواست کرد:
\f[V]http://127.0.0.1:5572/[remote:path]/path/to/object\f[R]
.PP
مگر اینکه برای سرور rc احراز هویت پیکربندی شده باشد
(\f[V]--rc-user\f[R]/\f[V]--rc-pass\f[R] یا \f[V]--rc-htpasswd\f[R]) یا
پرچم \f[V]--rc-no-auth\f[R] تنظیم شده باشد، فقط ریموت‌هایی که از قبل در فایل پیکربندی موجود هستند می‌توانند به این روش سرویس‌دهی شوند.
ریموت‌های درون‌خطی (مانند
\f[V][:webdav,url=...:]\f[R])، پارامترهای رشته اتصال و مسیرهای محلی خالص رد می‌شوند، زیرا نمونه‌سازی آن‌ها از طریق یک درخواست احراز هویت‌نشده می‌تواند دستوراتی را اجرا کند یا فایل‌های محلی دلخواه را بخواند.
.PP
پیش‌فرض غیرفعال (Off).
.SS گزینه‌های رشته اتصال global.* و rc
.PP
ریموت‌هایی که توسط rc ایجاد می‌شوند اجازه نمی‌دهند گزینه‌های \f[V]global.*\f[R] در رشته اتصال
(https://rclone.org/docs/#connection-strings)
پیکربندی سراسری فرایند rclone را تغییر دهند.
ریموت‌هایی که مستقیماً در خط فرمان ایجاد می‌شوند یا در فایل پیکربندی تعریف شده‌اند، تحت تأثیر قرار نمی‌گیرند.
.PP
یک گزینه \f[V]global.*\f[R] همچنان بر روی بَک‌اند خاصی که روی آن تنظیم شده اعمال می‌شود (دقیقاً مانند یک گزینه \f[V]override.*\f[R])، فقط به پیکربندی سراسری بقیه فرایند نشت نمی‌کند.
.SS --rc-serve-no-modtime
.PP
تنظیم این پرچم برای صرف‌نظر کردن از خواندن زمان تغییر (می‌تواند سرعت کارها را افزایش دهد).
.PP
پیش‌فرض غیرفعال (Off).
.SS --rc-files /path/to/directory
.PP
مسیر فایل‌های محلی برای سرویس‌دهی روی سرور HTTP.
.PP
اگر این گزینه تنظیم شود، rclone فایل‌های موجود در آن دایرکتوری را سرویس‌دهی خواهد کرد.
همچنین در صورت مشخص شدن، مسیر ریشه را در مرورگر وب باز می‌کند.
این گزینه برای پیاده‌سازی رابط‌های کاربری گرافیکی (GUI) مبتنی بر مرورگر برای قابلیت‌های rclone کاربرد دارد.
.PP
اگر \f[V]--rc-user\f[R] یا \f[V]--rc-pass\f[R] تنظیم شده باشد، نشانی اینترنتی که باز می‌شود اطلاعات احراز هویت را در ساختار نشانی به سبک
\f[V]http://user:pass\[at]localhost/\f[R] خواهد داشت.
.PP
پیش‌فرض غیرفعال (Off)..SS --rc-enable-metrics
.PP
فعال‌سازی نقطه پایانی (endpoint) سازگار با OpenMetrics/Prometheus در \f[V]/metrics\f[R].
اگر کنترل بیشتری روی متریک‌ها مورد نیاز است (برای مثال اجرای آن روی درگاهی دیگر یا با احراز هویت متفاوت)، می‌توان نقطه پایانی را در عوض با پرچم‌های \f[V]--metrics-*\f[R] فعال کرد.
.PP
پیش‌فرض خاموش (Off).
.SS --rc-web-gui
.PP
تنظیم این پرچم برای ارائه واسط کاربری وب (web gui) پیش‌فرض روی همان درگاه rclone.
.PP
پیش‌فرض خاموش (Off).
.SS --rc-allow-origin
.PP
تنظیم Access-Control-Allow-Origin مجاز برای درخواست‌های rc.
.PP
می‌تواند به همراه --rc-web-gui استفاده شود اگر rclone روی نشانی IP متفاوتی نسبت به web-gui در حال اجرا باشد.
.PP
پیش‌فرض نشانی IP است که rc روی آن اجرا می‌شود.
.SS --rc-web-fetch-url
.PP
تنظیم نشانی وب (URL) برای دریافت فایل‌های rclone-web-gui از آن.
.PP
پیش‌فرض
<https://api.github.com/repos/rclone/rclone-webui-react/releases/latest>.
.SS --rc-web-gui-update
.PP
تنظیم این پرچم برای بررسی و به‌روزرسانی rclone-webui-react از rc-web-fetch-url.
.PP
پیش‌فرض خاموش (Off).
.SS --rc-web-gui-force-update
.PP
تنظیم این پرچم برای به‌روزرسانی اجباری rclone-webui-react از rc-web-fetch-url.
.PP
پیش‌فرض خاموش (Off).
.SS --rc-web-gui-no-open-browser
.PP
تنظیم این پرچم برای غیرفعال کردن باز شدن خودکار مرورگر هنگام استفاده از web-gui.
.PP
پیش‌فرض خاموش (Off).
.SS --rc-job-expire-duration=DURATION
.PP
منقضی کردن کارهای ناهمگام (async) پایان‌یافته قدیمی‌تر از DURATION (پیش‌فرض 60s).
.SS --rc-job-expire-interval=DURATION
.PP
مدت زمان بازه برای بررسی کارهای ناهمگام (async) منقضی‌شده (پیش‌فرض 10s).
.SS --rc-no-auth
.PP
به‌طور پیش‌فرض rclone الزام می‌کند که احراز هویت روی واسط rc تنظیم شده باشد تا بتوان از هر متدی که به ریموت‌های rclone دسترسی دارد استفاده کرد.
برای نمونه دسترسی به \f[V]operations/list\f[R] رد می‌شود زیرا مستلزم ایجاد ریموت است، همچنین برای \f[V]sync/copy\f[R].
.PP
اگر این مورد تنظیم شود، هیچ احراز هویتی روی سرور برای استفاده از این متدها لازم نخواهد بود.
راهکار جایگزین استفاده از \f[V]--rc-user\f[R] و \f[V]--rc-pass\f[R] و به‌کارگیری این اطلاعات احراز هویت در درخواست است.
.PP
پیش‌فرض خاموش (Off).
.SS --rc-baseurl
.PP
پیشوند برای URLها.
.PP
پیش‌فرض root است.
.SS --rc-template
.PP
قالب مشخص‌شده توسط کاربر.
.SS دسترسی به کنترل از راه دور از طریق دستور rclone rc
.PP
خود Rclone پروتکل کنترل از راه دور را در دستور \f[V]rclone rc\f[R] خود پیاده‌سازی می‌کند.
.PP
می‌توانید به این شکل از آن استفاده کنید:
.IP
.nf
\f[C]
$ rclone rc rc/noop param1=one param2=two
{
    \[dq]param1\[dq]: \[dq]one\[dq],
    \[dq]param2\[dq]: \[dq]two\[dq]
}
\f[R]
.fi
.PP
اگر ریموت روی نشانی وب متفاوتی نسبت به پیش‌فرض \f[V]http://localhost:5572\f[R] در حال اجرا است، از گزینهٔ \f[V]--url\f[R] برای مشخص کردن آن استفاده کنید:
.IP
.nf
\f[C]
rclone rc --url http://some.remote:1234 rc/noop
\f[R]
.fi
.PP
یا اگر ریموت روی یک سوکت یونیکس (Unix socket) گوش می‌دهد، به جای آن از گزینهٔ \f[V]--unix-socket\f[R] استفاده کنید:
.IP
.nf
\f[C]
rclone rc --unix-socket /tmp/rclone.sock rc/noop
\f[R]
.fi
.PP
دستور \f[V]rclone rc\f[R] را به تنهایی و بدون هیچ آرگومانی اجرا کنید تا راهنمای دستورهای کنترل از راه دور نصب‌شده را ببینید.
توجه داشته باشید که این کار نیز مستلزم اتصال به سرور راه دور است..SS "ورودی JSON (JSON input)"
.PP
دستور \f[V]rclone rc\f[R] همچنین از پرچم \f[V]--json\f[R] پشتیبانی می‌کند که می‌توان از آن برای ارسال پارامترهای ورودی پیچیده‌تر استفاده کرد.
.IP
.nf
\f[C]
$ rclone rc --json \[aq]{ \[dq]p1\[dq]: [1,\[dq]2\[dq],null,4], \[dq]p2\[dq]: { \[dq]a\[dq]:1, \[dq]b\[dq]:2 } }\[aq] rc/noop
{
    \[dq]p1\[dq]: [
        1,
        \[dq]2\[dq],
        null,
        4
    ],
    \[dq]p2\[dq]: {
        \[dq]a\[dq]: 1,
        \[dq]b\[dq]: 2
    }
}
\f[R]
.fi
.PP
اگر پارامتری که ارسال می‌شود یک شیء (object) باشد، می‌توان آن را به جای استفاده از پرچم \f[V]--json\f[R] به عنوان یک رشتهٔ JSON ارسال کرد که خط فرمان را ساده‌تر می‌کند.
.IP
.nf
\f[C]
rclone rc operations/list fs=/tmp remote=test opt=\[aq]{\[dq]showHash\[dq]: true}\[aq]
\f[R]
.fi
.PP
به جای:
.IP
.nf
\f[C]
rclone rc operations/list --json \[aq]{\[dq]fs\[dq]: \[dq]/tmp\[dq], \[dq]remote\[dq]: \[dq]test\[dq], \[dq]opt\[dq]: {\[dq]showHash\[dq]: true}}\[aq]
\f[R]
.fi
.SS "پارامترهای ویژه (Special parameters)"
.PP
رابط rc از برخی پارامترهای ویژه پشتیبانی می‌کند که برای \f[B]تمام\f[R] دستورات اعمال می‌شوند.
این پارامترها با \f[V]_\f[R] آغاز می‌شوند تا نشان دهند که متمایز هستند.
.SS "اجرای کارهای ناهمگام با _async = true (Running asynchronous jobs with _async = true)"
.PP
هر فراخوانی rc به عنوان یک کار (job) دسته‌بندی شده و شناسهٔ یکتای خود را دریافت می‌کند.
به طور پیش‌فرض، کارها به محض ایجاد شدن و به صورت همگام اجرا می‌شوند.
.PP
اگر هنگام ارسال به یک فراخوانی rc مقدار \f[V]_async\f[R] برابر با true باشد، بلافاصله همراه با یک شناسهٔ کار (job id) و شناسهٔ اجرا (execute id) پاسخ داده خواهد شد و کار در پس‌زمینه اجرا می‌شود.
از فراخوانی \f[V]job/status\f[R] می‌توان برای دریافت اطلاعات کارِ در حال اجرا در پس‌زمینه استفاده کرد.
وضعیت کار را می‌توان تا حداکثر ۱ دقیقه پس از اتمام آن بررسی کرد.
.PP
توصیه می‌شود کارهایی که ممکن است اجرای طولانی داشته باشند، مانند
\f[V]sync/sync\f[R]، \f[V]sync/copy\f[R]، \f[V]sync/move\f[R] و
\f[V]operations/purge\f[R] با پرچم \f[V]_async\f[R] اجرا شوند تا از هرگونه مشکل احتمالی مربوط به اتمام مهلت زمانی (timeout) درخواست و پاسخ HTTP جلوگیری گردد.
.PP
به عنوان جایگزینی برای \f[V]_async\f[R]، می‌توانید سرآیند HTTP به صورت
\f[V]Prefer: respond-async\f[R] (استاندارد RFC 7240) را ارسال کنید.
این کار همان نتیجهٔ \f[V]_async = true\f[R] را دارد اما علاوه بر آن، به جای کد وضعیت 200، وضعیت HTTP با کد 202 (Accepted) را برمی‌گرداند و شامل یک سرآیند پاسخ \f[V]Preference-Applied: respond-async\f[R] است.
کد وضعیت 202 به کارخواه‌ها (کلاینت‌ها) این امکان را می‌دهد که بدون نیاز به بررسی بدنه، پاسخ ناهمگام را به سادگی از پاسخ تکمیل‌شده تشخیص دهند.
.PP
شروع یک کار با پرچم \f[V]_async\f[R]:
.IP
.nf
\f[C]
$ rclone rc --json \[aq]{ \[dq]p1\[dq]: [1,\[dq]2\[dq],null,4], \[dq]p2\[dq]: { \[dq]a\[dq]:1, \[dq]b\[dq]:2 }, \[dq]_async\[dq]: true }\[aq] rc/noop
{
    \[dq]jobid\[dq]: 2,
    \[dq]executeId\[dq]: \[dq]d794c33c-463e-4acf-b911-f4b23e4f40b7\[dq]
}
\f[R]
.fi
.PP
مقدار \f[V]jobid\f[R] یک شناسهٔ یکتا برای کار در این نمونه از rclone است.
مقدار \f[V]executeId\f[R] نمونهٔ فرایند rclone را مشخص می‌کند و پس از راه‌اندازی مجدد rclone تغییر می‌یابد.
در کنار یکدیگر، جفت (\f[V]executeId\f[R], \f[V]jobid\f[R]) یک کار را در طول راه‌اندازی‌های مجدد rclone به صورت یکتا مشخص می‌کنند.
.PP
وضعیت را بررسی کنید تا ببینید آیا کار به پایان رسیده است یا خیر.
برای اطلاعات بیشتر دربارهٔ معنای این پارامترهای بازگشتی، فراخوانی \f[V]job/status\f[R] را مشاهده کنید.
.IP
.nf
\f[C]
$ rclone rc --json \[aq]{ \[dq]jobid\[dq]:2 }\[aq] job/status
{
    \[dq]duration\[dq]: 0.000124163,
    \[dq]endTime\[dq]: \[dq]2018-10-27T11:38:07.911245881+01:00\[dq],
    \[dq]error\[dq]: \[dq]\[dq],
    \[dq]executeId\[dq]: \[dq]d794c33c-463e-4acf-b911-f4b23e4f40b7\[dq],
    \[dq]finished\[dq]: true,
    \[dq]id\[dq]: 2,
    \[dq]output\[dq]: {
        \[dq]_async\[dq]: true,
        \[dq]p1\[dq]: [
            1,
            \[dq]2\[dq],
            null,
            4
        ],
        \[dq]p2\[dq]: {
            \[dq]a\[dq]: 1,
            \[dq]b\[dq]: 2
        }
    },
    \[dq]startTime\[dq]: \[dq]2018-10-27T11:38:07.911121728+01:00\[dq],
    \[dq]success\[dq]: true
}
\f[R]
.fi
.PP
می‌توان از \f[V]job/list\f[R] برای نمایش کارهای در حال اجرا یا کارهایی که اخیراً پایان یافته‌اند به همراه وضعیتشان استفاده کرد:
.IP
.nf
\f[C]
$ rclone rc job/list
{
    \[dq]executeId\[dq]: \[dq]d794c33c-463e-4acf-b911-f4b23e4f40b7\[dq],
    \[dq]finished_ids\[dq]: [
        1
    ],
    \[dq]jobids\[dq]: [
        1,
        2
    ],
    \[dq]running_ids\[dq]: [
        2
    ]
}
\f[R]
.fi
.PP
این خروجی نشان‌دهندهٔ موارد زیر است: \- \f[V]executeId\f[R] \- شناسهٔ نمونهٔ کنونی rclone (برای تمام کارها یکسان است و پس از راه‌اندازی مجدد تغییر می‌کند) \- \f[V]jobids\f[R] \- آرایه‌ای از تمام شناسه‌های کار (هم کارهای در حال اجرا و هم کارهای تمام‌شده) \- \f[V]running_ids\f[R] \- آرایه‌ای از شناسه‌های کارهای در حال اجرای کنونی \- \f[V]finished_ids\f[R] \- آرایه‌ای از شناسه‌های کارهای پایان‌یافته.SS تنظیم فلگ‌های پیکربندی با _config
.PP
اگر می‌خواهید پیکربندی (معادل فلگ‌های سراسری) را تنها برای مدت یک فراخوانی rc تنظیم کنید، پارامتر \f[V]_config\f[R] را ارسال کنید.
.PP
از طرف دیگر، می‌توانید گزینه‌های پیکربندی را به‌صورت مسطح (flat) در بالاترین سطح از نگاشت پارامترها ارسال کنید.
نام گزینه‌ها همانند فلگ‌های CLI آن‌ها بدون \f[V]--\f[R] است و \f[V]-\f[R] با \f[V]_\f[R] جایگزین می‌شود (برای مثال \f[V]transfers\f[R] به‌جای \f[V]Transfers\f[R] درون \f[V]_config\f[R]).
.PP
این باید در همان قالبی باشد که کلید \f[V]main\f[R] بازگردانده‌شده توسط options/get دارد.
.IP
.nf
\f[C]
rclone rc --loopback options/get blocks=main
\f[R]
.fi
.PP
با این دستور می‌توانید راهنمایی بیشتری درباره این گزینه‌ها مشاهده کنید (برای اطلاعات بیشتر بخش بلوک‌های گزینه‌ها را ببینید).
.IP
.nf
\f[C]
rclone rc --loopback options/info blocks=main
\f[R]
.fi
.PP
برای مثال، اگر بخواهید یک sync را با پارامتر \f[V]--checksum\f[R] اجرا کنید، این پارامتر را در شیء JSON خود ارسال می‌کنید.
.IP
.nf
\f[C]
\[dq]_config\[dq]:{\[dq]CheckSum\[dq]: true}
\f[R]
.fi
.PP
یا آن را به‌صورت مسطح در بالاترین سطح ارسال کنید:
.IP
.nf
\f[C]
\[dq]checksum\[dq]: true
\f[R]
.fi
.PP
در صورت استفاده از \f[V]rclone rc\f[R] می‌توان آن را به شکل زیر ارسال کرد:
.IP
.nf
\f[C]
rclone rc sync/sync ... _config=\[aq]{\[dq]CheckSum\[dq]: true}\[aq]
\f[R]
.fi
.PP
یا به‌سادگی به‌صورت مسطح:
.IP
.nf
\f[C]
rclone rc sync/sync ... checksum=true
\f[R]
.fi
.PP
اگر هم پارامترهای مسطح و هم \f[V]_config\f[R] ارائه شوند، پارامترهای موجود در بلوک قدیمی \f[V]_config\f[R] اولویت خواهند داشت.
.PP
هر پارامتر پیکربندی که تنظیم نکنید، مقادیر پیش‌فرض سراسری را به ارث می‌برد که از طریق فلگ‌های خط فرمان یا متغیرهای محیطی تعیین شده‌اند.
.PP
توجه داشته باشید که امکان تنظیم برخی مقادیر به‌صورت رشته (string) یا عدد صحیح (integer) وجود دارد - برای اطلاعات بیشتر بخش انواع داده را ببینید.
در اینجا نمونه‌ای از تنظیم معادل \f[V]--buffer-size\f[R] در قالب رشته یا عدد صحیح آورده شده است.
.IP
.nf
\f[C]
\[dq]_config\[dq]:{\[dq]BufferSize\[dq]: \[dq]42M\[dq]}
\[dq]_config\[dq]:{\[dq]BufferSize\[dq]: 44040192}
\f[R]
.fi
.PP
یا مسطح:
.IP
.nf
\f[C]
\[dq]buffer_size\[dq]: \[dq]42M\[dq]
\[dq]buffer_size\[dq]: 44040192
\f[R]
.fi
.PP
اگر می‌خواهید بررسی کنید که انتساب \f[V]_config\f[R] به‌درستی کار کرده است یا خیر، فراخوانی \f[V]options/local\f[R] نشان می‌دهد که مقدار روی چه چیزی تنظیم شده است..SS تنظیم پرچم‌های فیلتر با _filter
.PP
اگر می‌خواهید فیلترها را تنها برای طول مدت یک فراخوانی rc تنظیم کنید،
پارامتر \f[V]_filter\f[R] را ارسال نمایید.
.PP
به عنوان روش جایگزین، می‌توانید گزینه‌های فیلتر را به صورت هم‌سطح (flat) در بالاترین
سطح نگاشت پارامترها ارسال کنید.
نام گزینه‌ها همانند پرچم‌های خط فرمان (CLI) آن‌ها است، بدون \f[V]--\f[R]
و با جایگزینی \f[V]-\f[R] با \f[V]_\f[R] (برای نمونه
\f[V]exclude\f[R] به جای \f[V]Exclude\f[R] درون
\f[V]_filter\f[R]).
.PP
این باید در همان قالبی باشد که کلید \f[V]filter\f[R] بازگردانده‌شده
توسط options/get دارد.
.IP
.nf
\f[C]
rclone rc --loopback options/get blocks=filter
\f[R]
.fi
.PP
می‌توانید با این دستور راهنمای بیشتری درباره این گزینه‌ها مشاهده کنید (برای
اطلاعات بیشتر به بخش بلوک‌های گزینه‌ها مراجعه نمایید).
.IP
.nf
\f[C]
rclone rc --loopback options/info blocks=filter
\f[R]
.fi
.PP
برای نمونه، اگر می‌خواهید یک همگام‌سازی را با این پرچم‌ها اجرا کنید
.IP
.nf
\f[C]
--max-size 1M --max-age 42s --include \[dq]a\[dq] --include \[dq]b\[dq]
\f[R]
.fi
.PP
می‌توانید این پارامتر را در داده خام JSON خود ارسال کنید:
.IP
.nf
\f[C]
\[dq]_filter\[dq]:{\[dq]MaxSize\[dq]:\[dq]1M\[dq], \[dq]IncludeRule\[dq]:[\[dq]a\[dq],\[dq]b\[dq]], \[dq]MaxAge\[dq]:\[dq]42s\[dq]}
\f[R]
.fi
.PP
یا آن‌ها را به صورت هم‌سطح در بالاترین سطح بفرستید:
.IP
.nf
\f[C]
\[dq]max_size\[dq]:\[dq]1M\[dq], \[dq]include\[dq]:[\[dq]a\[dq],\[dq]b\[dq]], \[dq]max_age\[dq]:\[dq]42s\[dq]
\f[R]
.fi
.PP
در صورت استفاده از \f[V]rclone rc\f[R] می‌توان آن را به این صورت ارسال کرد:
.IP
.nf
\f[C]
rclone rc ... _filter=\[aq]{\[dq]MaxSize\[dq]:\[dq]1M\[dq], \[dq]IncludeRule\[dq]:[\[dq]a\[dq],\[dq]b\[dq]], \[dq]MaxAge\[dq]:\[dq]42s\[dq]}\[aq]
\f[R]
.fi
.PP
یا به سادگی به صورت هم‌سطح:
.IP
.nf
\f[C]
rclone rc ... max_size=1M include=\[dq]a,b\[dq] max_age=42s
\f[R]
.fi
.PP
اگر هم پارامترهای هم‌سطح و هم \f[V]_filter\f[R] ارائه شوند،
پارامترهای موجود در بلوک قدیمی \f[V]_filter\f[R] اولویت خواهند داشت.
.PP
هر پارامتر فیلتری که تنظیم نکنید، مقادیر پیش‌فرض سراسری را که
با پرچم‌های خط فرمان یا متغیرهای محیطی تعیین شده‌اند، به ارث خواهد برد.
.PP
توجه داشته باشید که امکان تنظیم برخی مقادیر به صورت رشته یا عدد صحیح وجود دارد - برای
اطلاعات بیشتر بخش data types را ببینید.
در اینجا مثالی از تنظیم معادل \f[V]--buffer-size\f[R] در
قالب رشته یا عدد صحیح آمده است:
.IP
.nf
\f[C]
\[dq]_filter\[dq]:{\[dq]MinSize\[dq]: \[dq]42M\[dq]}
\[dq]_filter\[dq]:{\[dq]MinSize\[dq]: 44040192}
\f[R]
.fi
.PP
یا به صورت هم‌سطح:
.IP
.nf
\f[C]
\[dq]min_size\[dq]: \[dq]42M\[dq]
\f[R]
.fi
.PP
اگر می‌خواهید بررسی کنید که انتساب \f[V]_filter\f[R] به درستی عمل
کرده است، فراخوانی \f[V]options/local\f[R] نشان خواهد داد که مقدار
روی چه چیزی تنظیم شده است..SS اختصاص عملیات‌ها به گروه‌ها با _group = value
.PP
هر فراخوانی rc برای ردیابی معیارهایش گروه آمار (stats) مختص به خود را دارد.
به‌طور پیش‌فرض گروه‌بندی با نام گروه مرکب از پیشوند
\f[V]job/\f[R] و شناسه کار انجام می‌شود، مانند \f[V]job/1\f[R].
.PP
اگر \f[V]_group\f[R] مقداری داشته باشد، آمار آن درخواست تحت آن مقدار
گروه‌بندی خواهد شد.
این ویژگی به فراخواننده اجازه می‌دهد تا آمارها را با نام دلخواه خود گروه‌بندی کند.
.PP
آمار یک گروه خاص را می‌توان با ارسال \f[V]group\f[R] به
\f[V]core/stats\f[R] دریافت کرد:
.IP
.nf
\f[C]
$ rclone rc --json \[aq]{ \[dq]group\[dq]: \[dq]job/1\[dq] }\[aq] core/stats
{
    \[dq]speed\[dq]: 12345
    ...
}
\f[R]
.fi
.SS انواع داده (Data types)
.PP
هنگامی که API انواع داده را بازمی‌گرداند، این‌ها عمدتاً انواع ساده و سرراست
عدد صحیح (integer)، رشته (string) یا بولی (boolean) خواهند بود.
.PP
با این حال، برخی از انواع برگردانده‌شده توسط فراخوانی options/get و دریافت‌شده توسط
فراخوانی‌های options/set و همچنین پارامترهای \f[V]vfsOpt\f[R]،
\f[V]mountOpt\f[R] و \f[V]_config\f[R] عبارتند از:
.IP \[bu] 2
\f[V]Duration\f[R] \- این‌ها به صورت یک مدت‌زمان با عدد صحیح بر حسب
نانوثانیه برگردانده می‌شوند.
می‌توان آن‌ها را به صورت یک عدد صحیح تنظیم کرد، یا با یک رشته زمانی مانند
\[dq]5s\[dq] مشخص نمود.
برای اطلاعات بیشتر بخش گزینه‌ها (https://rclone.org/docs/#options) را
ببینید.
.IP \[bu] 2
\f[V]Size\f[R] \- این‌ها به صورت یک عدد صحیح از بایت‌ها برگردانده می‌شوند.
می‌توان آن‌ها را به صورت یک عدد صحیح یا با یک رشته دارای پسوند اندازه مانند
\[dq]10M\[dq] تنظیم کرد.
برای اطلاعات بیشتر بخش گزینه‌ها (https://rclone.org/docs/#options) را
ببینید.
.IP \[bu] 2
نوع شمارشی (مانند \f[V]CutoffMode\f[R]، \f[V]DumpFlags\f[R]،
\f[V]LogLevel\f[R]، \f[V]VfsCacheMode\f[R]) \- این‌ها به صورت یک عدد صحیح
برگردانده می‌شوند و می‌توانند به صورت عدد صحیح نیز مقداردهی شوند، اما برای
راحتی بیشتر می‌توان آن‌ها را به صورت رشته تنظیم کرد، مانند \[dq]HARD\[dq] برای
\f[V]CutoffMode\f[R] یا \[dq]DEBUG\[dq] برای \f[V]LogLevel\f[R].
.IP \[bu] 2
\f[V]BandwidthSpec\f[R] \- این مقدار به صورت یک رشته تنظیم و برگردانده می‌شود، مانند
\[dq]1M\[dq].
.SS بلوک‌های گزینه (Option blocks)
.PP
فراخوانی‌های options/info (برای پیکربندی اصلی) و config/providers (برای
پیکربندی backend) را می‌توان برای دریافت اطلاعات درباره گزینه‌های
پیکربندی rclone استفاده کرد.
این قابلیت برای ساخت رابط‌های کاربری جهت نمایش و تنظیم هر یک از گزینه‌های
rclone به کار می‌رود.
.PP
این اطلاعات شامل آرایه‌هایی از بلوک‌های \f[V]Option\f[R] است.
این بلوک‌ها قالب زیر را دارند.
هر بلوک یک گزینه منفرد را توصیف می‌کند.
.PP
.TS
tab(@);
lw(13.6n) lw(11.7n) lw(19.4n) lw(25.3n).
T{
فیلد
T}@T{
نوع
T}@T{
اختیاری
T}@T{
توضیحات
T}
_
T{
Name
T}@T{
string
T}@T{
N
T}@T{
نام گزینه در قالب snake_case
T}
T{
FieldName
T}@T{
string
T}@T{
N
T}@T{
نام فیلد استفاده‌شده در rc \- در صورت خالی بودن از Name استفاده می‌شود.
ممکن است برای فیلدهای تو در تو شامل \[dq].\[dq] باشد.
T}
T{
Help
T}@T{
string
T}@T{
N
T}@T{
راهنما، که با یک جمله در یک سطر آغاز می‌شود
T}
T{
Groups
T}@T{
string
T}@T{
Y
T}@T{
گروه‌هایی که این گزینه به آن‌ها تعلق دارد \- رشته جداشده با کاما برای
طبقه‌بندی گزینه‌ها
T}
T{
Provider
T}@T{
string
T}@T{
Y
T}@T{
تنظیم برای فیلتر کردن بر اساس فراهم‌کننده (provider)
T}
T{
Default
T}@T{
any
T}@T{
N
T}@T{
مقدار پیش‌فرض؛ در صورت تنظیم (و غیر nil یا \[dq]\[dq] بودن)، فیلد Required
کاری انجام نمی‌دهد
T}
T{
Value
T}@T{
any
T}@T{
N
T}@T{
مقداری که توسط فلگ‌ها تنظیم می‌شود
T}
T{
Examples
T}@T{
Examples
T}@T{
Y
T}@T{
مقادیر از پیش‌تعریف‌شده‌ای که می‌توان از فهرست انتخاب کرد (گزینه
چندگزینه‌ای)
T}
T{
ShortOpt
T}@T{
string
T}@T{
Y
T}@T{
گزینه خط فرمان کوتاه برای این مورد
T}
T{
Hide
T}@T{
Visibility
T}@T{
N
T}@T{
در صورت غیر صفر بودن، این گزینه از پیکربندی‌کننده یا خط فرمان پنهان
می‌شود
T}
T{
Required
T}@T{
bool
T}@T{
N
T}@T{
این گزینه الزامی است، به این معنی که مقدار نمی‌تواند خالی باشد مگر اینکه یک
پیش‌فرض وجود داشته باشد
T}
T{
IsPassword
T}@T{
bool
T}@T{
N
T}@T{
در صورتی تنظیم می‌شود که گزینه یک گذرواژه باشد
T}
T{
NoPrefix
T}@T{
bool
T}@T{
N
T}@T{
در صورتی تنظیم می‌شود که گزینه مربوطه نباید از پیشوند backend استفاده کند
T}
T{
Advanced
T}@T{
bool
T}@T{
N
T}@T{
در صورتی تنظیم می‌شود که این یک گزینه پیکربندی پیشرفته باشد
T}
T{
Exclusive
T}@T{
bool
T}@T{
N
T}@T{
در صورتی تنظیم می‌شود که پاسخ تنها بتواند یکی از مثال‌ها باشد (رشته خالی
مجاز است مگر اینکه Required یا Default تنظیم شده باشد)
T}
T{
Sensitive
T}@T{
bool
T}@T{
N
T}@T{
در صورتی تنظیم می‌شود که این گزینه هنگام استفاده از
\f[V]rclone config redacted\f[R] باید مخفی (سانسور) شود
T}
.TE.PP
نمونه‌ای از این می‌تواند پرچم \f[V]--log-level\f[R] باشد.
توجه داشته باشید که \f[V]Name\f[R] گزینه به پرچم خط فرمان تبدیل می‌شود که
در آن \f[V]_\f[R] با \f[V]-\f[R] جایگزین شده است.
.IP
.nf
\f[C]
{
    \[dq]Advanced\[dq]: false,
    \[dq]Default\[dq]: 5,
    \[dq]DefaultStr\[dq]: \[dq]NOTICE\[dq],
    \[dq]Examples\[dq]: [
        {
            \[dq]Help\[dq]: \[dq]\[dq],
            \[dq]Value\[dq]: \[dq]EMERGENCY\[dq]
        },
        {
            \[dq]Help\[dq]: \[dq]\[dq],
            \[dq]Value\[dq]: \[dq]ALERT\[dq]
        },
        ...
    ],
    \[dq]Exclusive\[dq]: true,
    \[dq]FieldName\[dq]: \[dq]LogLevel\[dq],
    \[dq]Groups\[dq]: \[dq]Logging\[dq],
    \[dq]Help\[dq]: \[dq]Log level DEBUG|INFO|NOTICE|ERROR\[dq],
    \[dq]Hide\[dq]: 0,
    \[dq]IsPassword\[dq]: false,
    \[dq]Name\[dq]: \[dq]log_level\[dq],
    \[dq]NoPrefix\[dq]: true,
    \[dq]Required\[dq]: true,
    \[dq]Sensitive\[dq]: false,
    \[dq]Type\[dq]: \[dq]LogLevel\[dq],
    \[dq]Value\[dq]: null,
    \[dq]ValueStr\[dq]: \[dq]NOTICE\[dq]
},
\f[R]
.fi
.PP
توجه داشته باشید که \f[V]Help\f[R] ممکن است چندخطی بوده و با
\f[V]\[rs]n\f[R] جدا شده باشد.
خط نخست همواره یک جمله کوتاه خواهد بود و این همان جمله‌ای است که
هنگام اجرای \f[V]rclone help flags\f[R] نمایش داده می‌شود.
.SS تعیین ریموت‌ها برای کار
.PP
ریموت‌ها بسته به دستور مورد استفاده، با پارامترهای \f[V]fs=\f[R]، \f[V]srcFs=\f[R]
و \f[V]dstFs=\f[R] مشخص می‌شوند.
.PP
این پارامترها مشابه سایر بخش‌های rclone می‌توانند یک رشته باشند؛ مانند
\f[V]s3:bucket/path\f[R] یا \f[V]:sftp:/my/dir\f[R].
همچنین می‌توان آن‌ها را به‌صورت بلاب‌های JSON مشخص کرد.
.PP
اگر یک بلاب JSON مشخص شود، باید شیئی از نگاشت رشته‌ها به
رشته‌ها باشد.
این مقادیر برای پیکربندی ریموت استفاده خواهند شد.
۳ مقدار ویژه وجود دارد که می‌توان آن‌ها را تنظیم کرد:
.IP \[bu] 2
\f[V]type\f[R] \- برای مشخص کردن ریموتی با نام \f[V]:type:\f[R]، روی \f[V]type\f[R] تنظیم می‌شود
.IP \[bu] 2
\f[V]_name\f[R] \- برای مشخص کردن ریموتی با نام \f[V]name:\f[R]، روی \f[V]name\f[R] تنظیم می‌شود
.IP \[bu] 2
\f[V]_root\f[R] \- ریشه ریموت را تنظیم می‌کند \- ممکن است خالی باشد
.PP
به‌طور معمول باید یکی از مقادیر \f[V]_name\f[R] یا \f[V]type\f[R] تنظیم شود.
اگر بک‌اند \f[V]local\f[R] مد نظر باشد، \f[V]type\f[R] باید روی
\f[V]local\f[R] تنظیم گردد.
اگر \f[V]_root\f[R] مشخص نشده باشد، مقدار پیش‌فرض آن ریشه
ریموت خواهد بود.
.PP
برای نمونه، این JSON معادل \f[V]remote:/tmp\f[R] است
.IP
.nf
\f[C]
{
    \[dq]_name\[dq]: \[dq]remote\[dq],
    \[dq]_root\[dq]: \[dq]/tmp\[dq]
}
\f[R]
.fi
.PP
و این معادل
\f[V]:sftp,host=\[aq]example.com\[aq]:/tmp\f[R] است
.IP
.nf
\f[C]
{
    \[dq]type\[dq]: \[dq]sftp\[dq],
    \[dq]host\[dq]: \[dq]example.com\[dq],
    \[dq]_root\[dq]: \[dq]/tmp\[dq]
}
\f[R]
.fi
.PP
و این معادل \f[V]/tmp/dir\f[R] است
.IP
.nf
\f[C]
{
    \[dq]type\[dq]: \[dq]local\[dq],
    \[dq]_root\[dq]: \[dq]/tmp/dir\[dq]
}
\f[R]
.fi.SS دستورهای پشتیبانی‌شده
.SS backend/command: اجرای یک دستور backend.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
command \- یک رشته شامل نام دستور
.IP \[bu] 2
fs \- یک رشته از نام remote، مانند
\[dq]drive:\[dq]
.IP \[bu] 2
arg \- فهرستی از آرگومان‌ها برای دستور backend
.IP \[bu] 2
opt \- یک نگاشت رشته به رشته از گزینه‌ها
.PP
بازمی‌گرداند:
.IP \[bu] 2
result \- نتیجه حاصل از دستور backend
.PP
مثال:
.IP
.nf
\f[C]
rclone rc backend/command command=noop fs=. -o echo=yes -o blue -a path1 -a path2
\f[R]
.fi
.PP
بازمی‌گرداند:
.IP
.nf
\f[C]
{
    \[dq]result\[dq]: {
        \[dq]arg\[dq]: [
            \[dq]path1\[dq],
            \[dq]path2\[dq]
        ],
        \[dq]name\[dq]: \[dq]noop\[dq],
        \[dq]opt\[dq]: {
            \[dq]blue\[dq]: \[dq]\[dq],
            \[dq]echo\[dq]: \[dq]yes\[dq]
        }
    }
}
\f[R]
.fi
.PP
توجه داشته باشید که این معادل مستقیم استفاده از این دستور \[dq]backend\[dq]
است:
.IP
.nf
\f[C]
rclone backend noop . -o echo=yes -o blue path1 path2
\f[R]
.fi
.PP
توجه داشته باشید که آرگومان‌ها باید با پرچم \[dq]-a\[dq] همراه باشند
.PP
برای اطلاعات بیشتر دستور backend را در (https://rclone.org/commands/rclone_backend)
ببینید.
.SS cache/expire: پاک‌سازی یک remote از کش
.PP
یک remote را از cache backend پاک‌سازی می‌کند.
از دایرکتوری یا فایل پشتیبانی می‌کند.
پارامترها: \- remote = مسیر به remote (الزامی) \- withData = true/false برای
حذف داده‌های کش‌شده (chunkها) نیز (اختیاری)
.PP
برای مثال:
.IP
.nf
\f[C]
rclone rc cache/expire remote=path/to/sub/folder/
rclone rc cache/expire remote=/ withData=true
\f[R]
.fi
.SS cache/fetch: واکشی تکه‌های فایل
.PP
اطمینان حاصل می‌کند که تکه‌های (chunks) مشخص‌شده فایل روی دیسک کش شده باشند.
.PP
پارامتر chunks= تکه‌های فایل را برای بررسی مشخص می‌کند.
این پارامتر یک فهرست جداشده با کاما از نمایه‌های برشی (slice) آرایه می‌پذیرد.
نمایه‌های برشی مشابه برش‌های پایتون هستند: start[:end]
.PP
مقدار start شماره تکه (chunk) مبتنی بر صفر از ابتدای فایل برای واکشی، به صورت
شامل‌شونده (inclusive) است.
مقدار end شماره تکه مبتنی بر صفر از ابتدای فایل برای واکشی، به صورت شامل‌نشونده
(exclusive) است.
هر دو مقدار می‌توانند منفی باشند، که در این صورت از انتهای فایل شمارش
می‌شوند.
مقدار \[dq]-5:\[dq] نمایانگر ۵ تکه آخر یک فایل است.
.PP
چند مثال معتبر عبارتند از: \[dq]:5,-5:\[dq] -> پنج تکه اول و آخر
\[dq]0,-2\[dq] -> تکه اول و ماقبل آخر
\[dq]0:10\[dq] -> ده تکه اول
.PP
هر پارامتری با کلیدی که با \[dq]file\[dq] آغاز می‌شود می‌تواند برای
مشخص کردن فایل‌ها جهت واکشی استفاده شود، مانند:
.IP
.nf
\f[C]
rclone rc cache/fetch chunks=0 file=hello file2=home/goodbye
\f[R]
.fi
.PP
هنگامی که یک crypt remote بر روی کش استفاده شود، نام فایل‌ها به صورت
خودکار رمزگذاری خواهند شد..SS cache/stats: دریافت آمار cache
.PP
نمایش آمار مربوط به remote از نوع cache.
.PP
\f[B]برای این فراخوانی احراز هویت لازم نیست.\f[R]
.SS config/create: ایجاد پیکربندی برای یک remote.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
name \- نام remote
.IP \[bu] 2
parameters \- یک نگاشت از جفت‌های { \[dq]key\[dq]: \[dq]value\[dq] }
.IP \[bu] 2
type \- نوع remote جدید
.IP \[bu] 2
opt \- یک دیکشنری از گزینه‌ها برای کنترل پیکربندی
.RS 2
.IP \[bu] 2
obscure \- اعلام اینکه گذرواژه‌ها متنی ساده بوده و نیازمند مبهم‌سازی (obscuring) هستند
.IP \[bu] 2
noObscure \- اعلام اینکه گذرواژه‌ها از قبل مبهم شده‌اند و نیازی به
مبهم‌سازی ندارند
.IP \[bu] 2
noOutput \- چیزی در stdout چاپ نشود
.IP \[bu] 2
nonInteractive \- با کاربر تعاملی نداشته باشد، پرسش‌ها را بازگرداند
.IP \[bu] 2
continue \- ادامه فرآیند پیکربندی با یک پاسخ
.IP \[bu] 2
all \- پرسیدن تمام پرسش‌های پیکربندی، نه فقط پرسش‌های پس از پیکربندی
.IP \[bu] 2
state \- وضعیتی که باید از آن مجدداً آغاز شود \- همراه با continue استفاده می‌شود
.IP \[bu] 2
result \- نتیجه‌ای که باید از آن مجدداً آغاز شود \- همراه با continue استفاده می‌شود
.RE
.PP
برای اطلاعات بیشتر در مورد موارد بالا به دستور config
create (https://rclone.org/commands/rclone_config_create)
مراجعه کنید.
.SS config/delete: حذف یک remote در فایل پیکربندی.
.PP
پارامترها:
.IP \[bu] 2
name \- نام remote برای حذف
.PP
برای اطلاعات بیشتر در مورد موارد بالا به دستور config
delete (https://rclone.org/commands/rclone_config_delete)
مراجعه کنید.
.SS config/dump: استخراج (dump) فایل پیکربندی.
.PP
یک شیء JSON برمی‌گرداند: \- key: value
.PP
به‌طوری که کلیدها نام‌های remote و مقادیر پارامترهای پیکربندی هستند.
.PP
برای اطلاعات بیشتر در مورد موارد بالا به دستور config dump (https://rclone.org/commands/rclone_config_dump)
مراجعه کنید.
.SS config/get: دریافت یک remote در فایل پیکربندی.
.PP
پارامترها:
.IP \[bu] 2
name \- نام remote برای دریافت
.PP
برای اطلاعات بیشتر در مورد موارد بالا به دستور config dump (https://rclone.org/commands/rclone_config_dump)
مراجعه کنید.
.SS config/listremotes: فهرست کردن remoteهای موجود در فایل پیکربندی و تعریف‌شده در متغیرهای محیطی.
.PP
برمی‌گرداند \- remotes \- آرایه‌ای از نام‌های remote
.PP
برای اطلاعات بیشتر در مورد موارد بالا به دستور listremotes (https://rclone.org/commands/rclone_listremotes)
مراجعه کنید.
.SS config/oauthstatus: دریافت وضعیت سرور احراز هویت OAuth.
.PP
وضعیت فعلی سرور احراز هویت OAuth را برمی‌گرداند.
.PP
یک شیء JSON برمی‌گرداند: \- status \- \[dq]running\[dq] یا \[dq]stopped\[dq]
\- authUrl \- نشانی URL برای مجوزدهی (تنها در صورتی که status برابر با
\[dq]running\[dq] باشد)
.PP
برای مثال
.IP
.nf
\f[C]
{
    \[dq]status\[dq]: \[dq]running\[dq],
    \[dq]authUrl\[dq]: \[dq]http://127.0.0.1:53682/auth?state=...\[dq]
}
\f[R]
.fi.SS config/oauthstop: متوقف کردن هر سرور در حال اجرای احراز هویت OAuth.
.PP
در صورت فعال بودن سرور احراز هویت OAuth، آن را متوقف می‌کند.
.PP
این دستور می‌تواند برای بازیابی از یک فرآیند قطع‌شدهٔ OAuth بدون راه‌اندازی مجدد rclone استفاده شود.
اگر هیچ فرآیند احراز هویت OAuth در حال اجرایی وجود نداشته باشد، یک خطا بازگردانده می‌شود.
.SS config/password: رمزگذاری پیکربندی یک ریموت.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
name \- نام ریموت
.IP \[bu] 2
parameters \- یک نگاشت از جفت‌های { \[dq]key\[dq]: \[dq]value\[dq] }
.PP
برای اطلاعات بیشتر درباره موارد فوق، دستور
config password (https://rclone.org/commands/rclone_config_password) را ببینید.
.SS config/paths: خواندن مسیر فایل پیکربندی و سایر مسیرهای مهم.
.PP
یک شیء JSON با کلیدهای زیر بازمی‌گرداند:
.IP \[bu] 2
config: مسیر فایل پیکربندی
.IP \[bu] 2
cache: مسیر ریشهٔ دایرکتوری کش
.IP \[bu] 2
temp: مسیر ریشهٔ دایرکتوری موقت
.PP
به‌عنوان مثال:
.IP
.nf
\f[C]
{
    \[dq]cache\[dq]: \[dq]/home/USER/.cache/rclone\[dq],
    \[dq]config\[dq]: \[dq]/home/USER/.rclone.conf\[dq],
    \[dq]temp\[dq]: \[dq]/tmp\[dq]
}
\f[R]
.fi
.PP
برای اطلاعات بیشتر درباره موارد فوق، دستور config paths (https://rclone.org/commands/rclone_config_paths) را ببینید.
.SS config/providers: نمایش نحوهٔ پیکربندی ارائه‌دهندگان در فایل پیکربندی.
.PP
یک شیء JSON بازمی‌گرداند: \- providers \- آرایه‌ای از اشیاء
.PP
برای اطلاعات بیشتر درباره موارد فوق، دستور
config providers (https://rclone.org/commands/rclone_config_providers) را ببینید.
.PP
توجه داشته باشید که بلوک‌های Options در همان قالبی هستند که توسط
\[dq]options/info\[dq] بازگردانده می‌شوند.
آن‌ها در بخش بلوک‌های گزینه توضیح داده شده‌اند.
.SS config/setpath: تنظیم مسیر فایل پیکربندی
.PP
پارامترها:
.IP \[bu] 2
path \- مسیر فایل پیکربندی مورد استفاده
.SS config/unlock: باز کردن قفل فایل پیکربندی.
.PP
در صورت قفل بودن فایل پیکربندی، قفل آن را باز می‌کند.
.PP
پارامترها:
.IP \[bu] 2
\[aq]configPassword\[aq] \- گذرواژه برای باز کردن قفل فایل پیکربندی
.PP
ایدهٔ خوبی است که پیش از اجرای این فراخوانی، AskPassword را غیرفعال کنید.
.SS config/unset: حذف کلیدها در یک ریموت درون فایل پیکربندی.
.PP
پارامترها:
.IP \[bu] 2
name \- نام ریموت
.IP \[bu] 2
keys \- فهرستی از نام‌های کلید برای حذف
.PP
خروجی:
.IP \[bu] 2
removed \- فهرستی از کلیدهایی که در عمل حذف شدند
.PP
برای اطلاعات بیشتر درباره موارد فوق، دستور config unset (https://rclone.org/commands/rclone_config_unset) را ببینید..SS config/update: به‌روزرسانی پیکربندی برای یک remote.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
name \- نام remote
.IP \[bu] 2
parameters \- نگاشتی از جفت‌های { \[dq]key\[dq]: \[dq]value\[dq] }
.IP \[bu] 2
opt \- فرهنگ‌داده‌ای از گزینه‌ها برای کنترل پیکربندی
.RS 2
.IP \[bu] 2
obscure \- اعلام اینکه گذرواژه‌ها به صورت متن خام هستند و نیاز به مبهم‌سازی دارند
.IP \[bu] 2
noObscure \- اعلام اینکه گذرواژه‌ها از قبل مبهم شده‌اند و نیازی به مبهم‌سازی ندارند
.IP \[bu] 2
noOutput \- چیزی در stdout چاپ نشود
.IP \[bu] 2
nonInteractive \- عدم تعامل با کاربر، بازگرداندن پرسش‌ها
.IP \[bu] 2
continue \- ادامه روند پیکربندی با یک پاسخ
.IP \[bu] 2
all \- پرسیدن تمام پرسش‌های پیکربندی، نه فقط موارد پس از پیکربندی
.IP \[bu] 2
state \- وضعیتی برای شروع مجدد \- مورد استفاده به همراه continue
.IP \[bu] 2
result \- نتیجه‌ای برای شروع مجدد \- مورد استفاده به همراه continue
.RE
.PP
برای اطلاعات بیشتر در مورد موارد فوق، دستور config
update (https://rclone.org/commands/rclone_config_update) را ببینید.
.SS core/bwlimit: تنظیم محدودیت پهنای باند.
.PP
این دستور محدودیت پهنای باند را بر اساس رشته داده‌شده تنظیم می‌کند.
این مقدار باید یک ورودی تکی برای محدودیت پهنای باند یا جفتی از پهنای باند upload:download باشد.
.PP
برای نمونه:
.IP
.nf
\f[C]
rclone rc core/bwlimit rate=off
{
    \[dq]bytesPerSecond\[dq]: -1,
    \[dq]bytesPerSecondTx\[dq]: -1,
    \[dq]bytesPerSecondRx\[dq]: -1,
    \[dq]rate\[dq]: \[dq]off\[dq]
}
rclone rc core/bwlimit rate=1M
{
    \[dq]bytesPerSecond\[dq]: 1048576,
    \[dq]bytesPerSecondTx\[dq]: 1048576,
    \[dq]bytesPerSecondRx\[dq]: 1048576,
    \[dq]rate\[dq]: \[dq]1M\[dq]
}
rclone rc core/bwlimit rate=1M:100k
{
    \[dq]bytesPerSecond\[dq]: 1048576,
    \[dq]bytesPerSecondTx\[dq]: 1048576,
    \[dq]bytesPerSecondRx\[dq]: 131072,
    \[dq]rate\[dq]: \[dq]1M\[dq]
}
\f[R]
.fi
.PP
اگر پارامتر rate ارائه نشود، وضعیت پهنای باند استعلام می‌گردد
.IP
.nf
\f[C]
rclone rc core/bwlimit
{
    \[dq]bytesPerSecond\[dq]: 1048576,
    \[dq]bytesPerSecondTx\[dq]: 1048576,
    \[dq]bytesPerSecondRx\[dq]: 1048576,
    \[dq]rate\[dq]: \[dq]1M\[dq]
}
\f[R]
.fi
.PP
قالب این پارامتر دقیقاً مشابه مقداری است که به --bwlimit ارسال می‌شود، به جز اینکه فقط یک مقدار پهنای باند را می‌توان مشخص کرد.
.PP
در هر دو حالت، \[dq]rate\[dq] به صورت یک رشته خوانا برای انسان، و \[dq]bytesPerSecond\[dq] به صورت یک عدد بازگردانده می‌شود..SS core/command: اجرای یک دستور ترمینال rclone از طریق rc.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
command \- یک رشته شامل نام دستور.
.IP \[bu] 2
arg \- فهرستی از آرگومان‌ها برای دستور بک‌اند.
.IP \[bu] 2
opt \- یک نگاشت رشته به رشته از گزینه‌ها.
.IP \[bu] 2
returnType \- یکی از مقادیر (\[dq]COMBINED_OUTPUT\[dq]، \[dq]STREAM\[dq]،
\[dq]STREAM_ONLY_STDOUT\[dq]، \[dq]STREAM_ONLY_STDERR\[dq]).
.RS 2
.IP \[bu] 2
در صورت تنظیم نشدن، مقدار پیش‌فرض \[dq]COMBINED_OUTPUT\[dq] است.
.IP \[bu] 2
مقدارهای بازگشتی STREAM خروجی را در بدنه پیام HTTP می‌نویسند.
.IP \[bu] 2
مقدار COMBINED_OUTPUT خروجی را در پارامتر \[dq]result\[dq]
می‌نویسد.
.RE
.PP
موارد بازگشتی:
.IP \[bu] 2
result \- نتیجه حاصل از دستور بک‌اند.
.RS 2
.IP \[bu] 2
تنها هنگام استفاده از returnType با مقدار \[dq]COMBINED_OUTPUT\[dq] تنظیم می‌شود.
.RE
.IP \[bu] 2
error \- در صورتی که rclone با کد خطا خارج شود، تنظیم می‌شود.
.IP \[bu] 2
returnType \- یکی از مقادیر (\[dq]COMBINED_OUTPUT\[dq]، \[dq]STREAM\[dq]،
\[dq]STREAM_ONLY_STDOUT\[dq]، \[dq]STREAM_ONLY_STDERR\[dq]).
.PP
مثال:
.IP
.nf
\f[C]
rclone rc core/command command=ls -a mydrive:/ -o max-depth=1
rclone rc core/command -a ls -a mydrive:/ -o max-depth=1
\f[R]
.fi
.PP
موارد بازگشتی:
.IP
.nf
\f[C]
{
    \[dq]error\[dq]: false,
    \[dq]result\[dq]: \[dq]<Raw command line output>\[dq]
}

OR
{
    \[dq]error\[dq]: true,
    \[dq]result\[dq]: \[dq]<Raw command line output>\[dq]
}
\f[R]
.fi
.SS core/disks: فهرست‌کردن دیسک‌های محلی
.PP
این دستور هیچ پارامتری نمی‌گیرد.
.PP
این فراخوانی برای برنامه‌های واسط گرافیکی (GUI) rclone است تا دیسک‌های محلی و
دایرکتوری‌های مهم را برای انجام انتقال داده‌ها شمارش و فهرست کنند.
فهرست بازگردانده شده شامل دایرکتوری ریشه، دایرکتوری خانگی کاربر
و هرگونه دیسک مانت‌شده خواهد بود.
موارد بازگردانده شده باید مستقیماً به‌عنوان ریموت قابل استفاده باشند.
.PP
موارد بازگشتی:
.IP \[bu] 2
disks
.RS 2
.IP \[bu] 2
این یک آرایه از رشته‌ها شامل نام دیسک‌های محلی است
.RE
.SS core/du: بازگرداندن میزان فضای مصرفی یک دیسک محلی متصل‌شده.
.PP
این فراخوانی میزان فضای مصرفی دیسک را برای دایرکتوری محلی ارسال‌شده در dir بازمی‌گرداند.
.PP
اگر دایرکتوری مشخص نشده باشد، به‌طور پیش‌فرض از دایرکتوری تعیین‌شده
توسط --cache-dir استفاده می‌شود.
.IP \[bu] 2
dir \- رشته (اختیاری)
.PP
موارد بازگشتی:
.IP
.nf
\f[C]
{
    \[dq]dir\[dq]: \[dq]/\[dq],
    \[dq]info\[dq]: {
        \[dq]Available\[dq]: 361769115648,
        \[dq]Free\[dq]: 361785892864,
        \[dq]Total\[dq]: 982141468672
    }
}
\f[R]
.fi
.PP
\f[B]برای این فراخوانی نیازی به احراز هویت نیست.\f[R].SS core/gc: یک بازیافت حافظه را اجرا می‌کند.
.PP
این دستور به go runtime اعلام می‌کند که یک دور بازیافت حافظه (garbage collection) را اجرا کند.
فراخوانی این مورد در حالت عادی ضروری نیست، اما می‌تواند برای
اشکال‌زدایی مشکلات حافظه مفید باشد.
.SS core/group-list: فهرستی از آمارها را برمی‌گرداند.
.PP
این دستور فهرستی از گروه‌های آماری که در حال حاضر در حافظه هستند را برمی‌گرداند.
.PP
مقادیر زیر را برمی‌گرداند:
.IP
.nf
\f[C]
{
    \[dq]groups\[dq]:  آرایه‌ای از نام‌های گروه‌ها:
        [
            \[dq]group1\[dq],
            \[dq]group2\[dq],
            ...
        ]
}
\f[R]
.fi
.PP
\f[B]برای این فراخوانی نیازی به احراز هویت نیست.\f[R]
.SS core/memstats: آمارهای حافظه را برمی‌گرداند
.PP
این دستور آمارهای حافظه برنامه در حال اجرا را برمی‌گرداند.
معنای هر یک از مقادیر در مستندات go شرح داده شده است:
https://golang.org/pkg/runtime/#MemStats
.PP
مهم‌ترین مقادیر برای بیشتر افراد عبارتند از:
.IP \[bu] 2
HeapAlloc \- این مقدار حافظه‌ای است که rclone واقعاً در حال استفاده از آن است
.IP \[bu] 2
HeapSys \- این مقدار حافظه‌ای است که rclone از سیستم‌عامل دریافت کرده است
.IP \[bu] 2
Sys \- این مجموع کل حافظه درخواست‌شده از سیستم‌عامل است
.RS 2
.IP \[bu] 2
این یک حافظه مجازی است، بنابراین ممکن است شامل حافظه استفاده‌نشده نیز باشد
.RE
.SS core/obscure: رشته ورودی را مبهم می‌کند.
.PP
یک رشته واضح ارسال کنید تا rclone آن را برای فایل پیکربندی مبهم کند: \-
clear \- string
.PP
خروجی: \- obscured \- string
.SS core/pid: شناسه فرآیند (PID) فرآیند جاری را برمی‌گرداند
.PP
این دستور PID فرآیند جاری را برمی‌گرداند.
برای متوقف کردن فرآیند rclone کاربرد دارد.
.SS core/quit: برنامه را خاتمه می‌دهد.
.PP
(اختیاری) یک کد خروج (exit code) برای استفاده در خاتمه دادن به برنامه ارسال کنید: \-
exitCode \- int
.SS core/stats: آمارهای مربوط به انتقال‌های جاری را برمی‌گرداند.
.PP
این دستور تمام آمارهای موجود را برمی‌گرداند:
.IP
.nf
\f[C]
rclone rc core/stats
\f[R]
.fi
.PP
اگر group مشخص نشود، مجموع آمارهای تمامی گروه‌ها بازگردانده
خواهد شد.
.PP
پارامترها
.IP \[bu] 2
group \- نام گروه آماری (string، اختیاری)
.IP \[bu] 2
short \- اگر true باشد، آرایه‌های transferring و checking بازگردانده نخواهند شد
(boolean، اختیاری)
.PP
مقادیر زیر را برمی‌گرداند:
.IP
.nf
\f[C]
{
    \[dq]bytes\[dq]: مجموع بایت‌های انتقال‌یافته از زمان شروع گروه،
    \[dq]checks\[dq]: تعداد فایل‌های بررسی‌شده،
    \[dq]deletedDirs\[dq]: تعداد پوشه‌های حذف‌شده،
    \[dq]deletes\[dq] : تعداد فایل‌های حذف‌شده،
    \[dq]elapsedTime\[dq]: زمان به ثانیه با ممیز شناور از زمان شروع rclone،
    \[dq]errors\[dq]: تعداد خطاها،
    \[dq]eta\[dq]: زمان تخمینی به ثانیه تا تکمیل گروه،
    \[dq]fatalError\[dq]: مقدار بولی نشان‌دهنده وقوع حداقل یک خطای مهلک،
    \[dq]lastError\[dq]: رشته آخرین خطا،
    \[dq]renames\[dq] : تعداد فایل‌های تغییرنام‌یافته،
    \[dq]listed\[dq] : تعداد مدخل‌های پوشه فهرست‌شده،
    \[dq]retryError\[dq]: مقدار بولی نشان‌دهنده وقوع حداقل یک خطای غیر NoRetryError،
        \[dq]serverSideCopies\[dq]: تعداد رونوشت‌های سمت سرور انجام‌شده،
        \[dq]serverSideCopyBytes\[dq]: تعداد بایت‌های رونوشت‌شده در سمت سرور،
        \[dq]serverSideMoves\[dq]: تعداد جابه‌جایی‌های سمت سرور انجام‌شده،
        \[dq]serverSideMoveBytes\[dq]: تعداد بایت‌های جابه‌جاشده در سمت سرور،
    \[dq]speed\[dq]: سرعت میانگین به بایت بر ثانیه از زمان شروع گروه،
    \[dq]totalBytes\[dq]: تعداد کل بایت‌ها در گروه،
    \[dq]totalChecks\[dq]: تعداد کل بررسی‌ها در گروه،
    \[dq]totalTransfers\[dq]: تعداد کل انتقال‌ها در گروه،
    \[dq]transferTime\[dq] : کل زمان صرف‌شده برای کارهای در حال اجرا،
    \[dq]transfers\[dq]: تعداد فایل‌های انتقال‌یافته،
    \[dq]transferring\[dq]: آرایه‌ای از انتقال‌های فایلِ در حال حاضر فعال:
        [
            {
                \[dq]bytes\[dq]: مجموع بایت‌های انتقال‌یافته برای این فایل،
                \[dq]eta\[dq]: زمان تخمینی به ثانیه تا تکمیل انتقال فایل
                \[dq]name\[dq]: نام فایل،
                \[dq]percentage\[dq]: پیشرفت انتقال فایل به درصد،
                \[dq]speed\[dq]: سرعت میانگین در کل مدت انتقال به بایت بر ثانیه،
                \[dq]speedAvg\[dq]: سرعت فعلی به بایت بر ثانیه به‌صورت میانگین متحرک وزن‌دار نمایی،
                \[dq]size\[dq]: اندازه فایل به بایت
            }
        ],
    \[dq]checking\[dq]: آرایه‌ای از نام‌های بررسی‌های فایلِ در حال حاضر فعال
        []
}
\f[R]
.fi
.PP
مقادیر مربوط به \[dq]transferring\[dq]، \[dq]checking\[dq] و
\[dq]lastError\[dq] تنها در صورتی تخصیص داده می‌شوند که داده‌ای در دسترس باشد.
مقدار \[dq]eta\[dq] در صورتی که نتوان آن را تعیین کرد، null خواهد بود.
.PP
\f[B]برای این فراخوانی نیازی به احراز هویت نیست.\f[R].SS core/stats-delete: حذف گروه آمار.
.PP
این دستور کل گروه آمار را حذف می‌کند.
.PP
پارامترها
.IP \[bu] 2
group \- نام گروه آمار (string)
.SS core/stats-reset: بازنشانی آمار.
.PP
این دستور شمارنده‌ها، خطاها و انتقال‌های پایان‌یافته را برای همه آمارها، یا در صورت ارائه group برای یک گروه آماری مشخص پاک می‌کند.
.PP
پارامترها
.IP \[bu] 2
group \- نام گروه آمار (string)
.SS core/transferred: بازگرداندن آمار انتقال‌های تکمیل‌شده.
.PP
این دستور آمار مربوط به انتقال‌های تکمیل‌شده را بازمی‌گرداند:
.IP
.nf
\f[C]
rclone rc core/transferred
\f[R]
.fi
.PP
اگر group مشخص نشده باشد، انتقال‌های تکمیل‌شده برای همه گروه‌ها بازگردانده خواهند شد.
.PP
توجه داشته باشید که تنها ۱۰۰ انتقال تکمیل‌شده اخیر بازگردانده می‌شوند.
.PP
پارامترها
.IP \[bu] 2
group \- نام گروه آمار (string)
.PP
مقادیر زیر را بازمی‌گرداند:
.IP
.nf
\f[C]
{
    \[dq]transferred\[dq]:  an array of completed transfers (including failed ones):
        [
            {
                \[dq]name\[dq]: name of the file,
                \[dq]size\[dq]: size of the file in bytes,
                \[dq]bytes\[dq]: total transferred bytes for this file,
                \[dq]checked\[dq]: if the transfer is only checked (skipped, deleted),
                \[dq]what\[dq]: the purpose of the transfer (transferring, deleting, checking, importing, hashing, merging, listing, moving, renaming),
                \[dq]timestamp\[dq]: integer representing millisecond unix epoch,
                \[dq]error\[dq]: string description of the error (empty if successful),
                \[dq]jobid\[dq]: id of the job that this transfer belongs to
            }
        ]
}
\f[R]
.fi
.PP
\f[B]احراز هویت برای این فراخوانی الزامی نیست.\f[R]
.SS core/version: نمایش نسخه فعلی rclone، Go و سیستم‌عامل.
.PP
این دستور نسخه‌های فعلی rclone، Go و سیستم‌عامل را نمایش می‌دهد:
.IP \[bu] 2
version \- نسخه rclone، برای مثال
\[dq]v1.71.2\[dq]
.IP \[bu] 2
decomposed \- شماره نسخه به‌صورت [major, minor, patch]
.IP \[bu] 2
isGit \- بولی (boolean) \- مقدار true اگر از روی نسخه git کامپایل شده باشد
.IP \[bu] 2
isBeta \- بولی (boolean) \- مقدار true اگر این یک نسخه بتا باشد
.IP \[bu] 2
os \- سیستم‌عامل در حال استفاده بر اساس GOOS در Go (برای مثال
\[dq]linux\[dq])
.IP \[bu] 2
osKernel \- نسخه هسته سیستم‌عامل (برای مثال
\[dq]6.8.0-86-generic (x86_64)\[dq])
.IP \[bu] 2
osVersion \- نسخه سیستم‌عامل (برای مثال
\[dq]ubuntu 24.04 (64 bit)\[dq])
.IP \[bu] 2
osArch \- معماری پردازنده مورد استفاده (برای مثال
\[dq]arm64 (ARMv8 compatible)\[dq])
.IP \[bu] 2
arch \- معماری پردازنده مورد استفاده بر اساس GOARCH در Go (برای مثال
\[dq]arm64\[dq])
.IP \[bu] 2
goVersion \- نسخه زمان اجرای Go مورد استفاده (برای مثال
\[dq]go1.25.0\[dq])
.IP \[bu] 2
linking \- نوع فایل اجرایی rclone (به‌صورت static یا dynamic)
.IP \[bu] 2
goTags \- برچسب‌های ساخت (build tags) جداشده با فاصله یا \[dq]none\[dq]
.PP
\f[B]احراز هویت برای این فراخوانی الزامی نیست.\f[R].SS debug/set-block-profile-rate: تنظیم runtime.SetBlockProfileRate برای تحلیل عملکرد انسداد (blocking profiling).
.PP
تابع SetBlockProfileRate کسری از رویدادهای انسداد goroutine را که در نمایه مسدودسازی (blocking profile) گزارش می‌شوند، کنترل می‌کند.
هدف تحلیل‌گر این است که به‌طور میانگین به ازای هر rate نانوثانیه زمان صرف‌شده در حالت مسدود، از یک رویداد انسداد نمونه‌برداری کند.
.PP
برای گنجاندن تمام رویدادهای انسداد در نمایه، مقدار rate = 1 را ارسال کنید.
برای غیرفعال کردن کامل تحلیل عملکرد، مقدار rate <= 0 را ارسال نمایید.
.PP
پس از فراخوانی این تابع، می‌توانید از دستور زیر برای مشاهده نمایه مسدودسازی استفاده کنید:
.IP
.nf
\f[C]
go tool pprof http://localhost:5572/debug/pprof/block
\f[R]
.fi
.PP
پارامترها:
.IP \[bu] 2
rate \- int
.SS debug/set-gc-percent: فراخوانی runtime/debug.SetGCPercent برای تنظیم درصد هدف زباله‌روبی (garbage collection).
.PP
تابع SetGCPercent درصد هدف زباله‌روبی را تنظیم می‌کند: زمانی که نسبت داده‌های تازه تخصیص‌یافته به داده‌های زنده باقی‌مانده پس از دور پیشین زباله‌روبی به این درصد برسد، یک چرخه جمع‌آوری زباله آغاز می‌شود.
تابع SetGCPercent مقدار تنظیم‌شده قبلی را برمی‌گرداند.
مقدار اولیه، مقدار متغیر محیطی GOGC در زمان راه‌اندازی است، یا در صورتی که این متغیر تنظیم نشده باشد، برابر با 100 خواهد بود.
.PP
این تنظیم ممکن است به منظور حفظ حد مجاز حافظه (memory limit) به‌طور موثر کاهش یابد.
یک درصد منفی عملاً زباله‌روبی را غیرفعال می‌کند، مگر اینکه به حد مجاز حافظه رسیده شود.
.PP
برای جزئیات بیشتر به https://pkg.go.dev/runtime/debug#SetMemoryLimit مراجعه کنید.
.PP
پارامترها:
.IP \[bu] 2
gc-percent \- int
.SS debug/set-mutex-profile-fraction: تنظیم runtime.SetMutexProfileFraction برای تحلیل عملکرد قفل‌های متقابل (mutex profiling).
.PP
تابع SetMutexProfileFraction کسری از رویدادهای نزاع قفل (mutex contention) را که در نمایه mutex گزارش می‌شوند، کنترل می‌کند.
به‌طور میانگین از هر rate رویداد، ۱ رویداد گزارش می‌شود (1/rate).
نرخ (rate) قبلی بازگردانده می‌شود.
.PP
برای غیرفعال کردن کامل تحلیل، مقدار rate را 0 قرار دهید.
برای صرفاً خواندن نرخ فعلی، مقدار rate < 0 را ارسال کنید.
(برای n>1 ممکن است جزئیات نمونه‌برداری تغییر کند.)
.PP
پس از تنظیم این مقدار، می‌توانید از دستور زیر برای تحلیل نزاع mutex استفاده کنید:
.IP
.nf
\f[C]
go tool pprof http://localhost:5572/debug/pprof/mutex
\f[R]
.fi
.PP
پارامترها:
.IP \[bu] 2
rate \- int
.PP
نتایج:
.IP \[bu] 2
previousRate \- int
.SS debug/set-soft-memory-limit: فراخوانی runtime/debug.SetMemoryLimit برای تنظیم یک حد مجاز انعطاف‌پذیر حافظه (soft memory limit) برای زمان اجرا (runtime).
.PP
تابع SetMemoryLimit یک حد مجاز انعطاف‌پذیر حافظه را برای زمان اجرا فراهم می‌کند.
.PP
محیط زمان اجرا (runtime) اقدامات متعددی را برای پایبندی به این سقف حافظه انجام می‌دهد، از جمله تنظیم تناوب چرخه‌های زباله‌روبی و بازگرداندن تهاجمی‌تر حافظه به سیستم زیرین.
این سقف حتی اگر GOGC=off باشد (یا اگر SetGCPercent(-1) اجرا شود) نیز رعایت خواهد شد.
.PP
حد ورودی بر حسب بایت تعیین می‌شود و شامل تمام حافظه‌های نگاشت‌شده (mapped)، مدیریت‌شده و آزادنشده توسط زمان اجرای Go است.
به‌ویژه، این حد فضای استفاده‌شده توسط فایل باینری Go و حافظه خارج از Go را به حساب نمی‌آورد؛ مانند حافظه مدیریت‌شده توسط سیستم زیرین از طرف فرآیند، یا حافظه مدیریت‌شده توسط کدهای غیر Go درون همان فرآیند.
نمونه‌هایی از منابع حافظه مستثنی‌شده عبارتند از: حافظه هسته سیستم‌عامل نگه‌داشته‌شده از طرف فرآیند، حافظه تخصیص‌یافته توسط کد C، و حافظه نگاشت‌شده توسط syscall.Mmap (زیرا توسط زمان اجرای Go مدیریت نمی‌شود).
.PP
تعیین حد صفر یا حدی که کمتر از میزان حافظه مصرفی توسط زمان اجرای Go باشد، ممکن است باعث شود زباله‌روب تقریباً به‌طور مداوم اجرا شود.
با این حال، برنامه ممکن است همچنان به کار خود ادامه دهد.
.PP
حد حافظه همواره توسط زمان اجرای Go رعایت می‌شود، بنابراین برای غیرفعال کردن مؤثر این رفتار، حد را مقدار بسیار بالایی قرار دهید.
مقدار math.MaxInt64 مقدار مرسوم برای غیرفعال کردن این حد است، اما مقادیر بسیار بیشتر از حافظه در دسترس سیستم زیرین نیز به همان اندازه خوب عمل می‌کنند.
.PP
برای یک راهنمای جامع که حد مجاز انعطاف‌پذیر حافظه را با جزئیات بیشتر توضیح می‌دهد و همچنین انواع سناریوها و کاربردهای متداول، https://go.dev/doc/gc-guide را مشاهده کنید.
.PP
تابع SetMemoryLimit حد حافظه تنظیم‌شده قبلی را برمی‌گرداند.
یک ورودی منفی حد را تغییر نمی‌دهد و امکان دریافت حد حافظه فعلی تنظیم‌شده را فراهم می‌سازد.
.PP
پارامترها:
.IP \[bu] 2
mem-limit \- int.SS fscache/clear: پاک‌سازی حافظهٔ پنهان Fs.
.PP
این دستور حافظهٔ پنهان fs را پاک‌سازی می‌کند.
اینجا مکانی است که ریموت‌های ایجادشده از backendها برای مدت کوتاهی در حافظهٔ پنهان نگهداری می‌شوند
تا فراخوانی‌های مکرر rc با کارایی بیشتری انجام شوند.
.PP
اگر پارامترهای یک backend را تغییر دهید، ممکن است بخواهید این دستور را فراخوانی کنید
تا پیش از ایجاد دوبارهٔ یک ریموت، نسخهٔ موجود آن از حافظهٔ پنهان پاک شود.
.SS fscache/entries: بازگرداندن تعداد ورودی‌های موجود در حافظهٔ پنهان fs.
.PP
این دستور تعداد ورودی‌های موجود در حافظهٔ پنهان fs را برمی‌گرداند.
.PP
خروجی \- entries \- تعداد آیتم‌های موجود در حافظهٔ پنهان
.SS job/batch: اجرای هم‌زمان دسته‌ای از دستورات rc در rclone.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
concurrency \- int \- اجرای هم‌زمان این تعداد دستور.
در صورت تنظیم نشدن، مقدار پیش‌فرض برابر با \f[V]--transfers\f[R] خواهد بود.
.IP \[bu] 2
inputs \- فهرستی از ورودی‌ها برای دستورات به همراه یک پارامتر اضافی \f[V]_path\f[R]
.IP
.nf
\f[C]
{
    \[dq]_path\[dq]: \[dq]rc/path\[dq],
    \[dq]param1\[dq]: \[dq]parameter for the path as documented\[dq],
    \[dq]param2\[dq]: \[dq]parameter for the path as documented, etc\[dq],
}
\f[R]
.fi
.PP
ورودی‌ها می‌توانند همانند استفادهٔ معمول از rc، از \f[V]_async\f[R]، \f[V]_group\f[R]، \f[V]_config\f[R]
و \f[V]_filter\f[R] استفاده کنند.
.PP
خروجی:
.IP \[bu] 2
results \- فهرستی از نتایج حاصل از دستورات، با یک ورودی به ازای هر مورد در
inputs.
.PP
برای مثال:
.IP
.nf
\f[C]
rclone rc job/batch --json \[aq]{
  \[dq]inputs\[dq]: [
    {
      \[dq]_path\[dq]: \[dq]rc/noop\[dq],
      \[dq]parameter\[dq]: \[dq]OK\[dq]
    },
    {
      \[dq]_path\[dq]: \[dq]rc/error\[dq],
      \[dq]parameter\[dq]: \[dq]BAD\[dq]
    }
  ]
}
\[aq]
\f[R]
.fi
.PP
نتیجهٔ حاصل:
.IP
.nf
\f[C]
{
  \[dq]results\[dq]: [
    {
      \[dq]parameter\[dq]: \[dq]OK\[dq]
    },
    {
      \[dq]error\[dq]: \[dq]arbitrary error on input map[parameter:BAD]\[dq],
      \[dq]input\[dq]: {
        \[dq]parameter\[dq]: \[dq]BAD\[dq]
      },
      \[dq]path\[dq]: \[dq]rc/error\[dq],
      \[dq]status\[dq]: 500
    }
  ]
}
\f[R]
.fi.SS job/list: فهرست شناسه‌های کارهای در حال اجرا
.PP
پارامترها: ندارد.
.PP
نتایج:
.IP \[bu] 2
executeId \- شناسه رشته‌ای از rclone در حال اجرا (پس از راه‌اندازی مجدد تغییر می‌کند)
.IP \[bu] 2
jobids \- آرایه‌ای از شناسه‌های کار عددی صحیح (با هر راه‌اندازی مجدد از ۱ شروع می‌شود)
.IP \[bu] 2
runningIds \- آرایه‌ای از شناسه‌های کار عددی صحیح که در حال اجرا هستند
.IP \[bu] 2
finishedIds \- آرایه‌ای از شناسه‌های کار عددی صحیح که به پایان رسیده‌اند
.PP
\f[B]احراز هویت برای این فراخوانی لازم نیست.\f[R]
.SS job/status: خواندن وضعیت شناسه کار
.PP
پارامترها:
.IP \[bu] 2
jobid \- شناسه کار (عدد صحیح).
.PP
نتایج:
.IP \[bu] 2
finished \- بولی (boolean)
.IP \[bu] 2
duration \- مدت زمان اجرای کار به ثانیه
.IP \[bu] 2
endTime \- زمان پایان کار (برای مثال
\[dq]2018-10-26T18:50:20.528746884+01:00\[dq])
.IP \[bu] 2
error \- خطای رخ‌داده از کار یا رشته خالی در صورت نبود خطا
.IP \[bu] 2
finished \- مقدار بولی نشان‌دهنده پایان یافتن یا نیافتن کار
.IP \[bu] 2
id \- همان‌طور که در بالا داده شده است
.IP \[bu] 2
executeId \- شناسه نمونه rclone (پس از راه‌اندازی مجدد تغییر می‌کند)؛ همراه با id یک کار را به طور یکتا مشخص می‌کند
.IP \[bu] 2
startTime \- زمان شروع کار (برای مثال
\[dq]2018-10-26T18:50:20.528336039+01:00\[dq])
.IP \[bu] 2
success \- بولی \- true برای موفقیت و در غیر این صورت false
.IP \[bu] 2
output \- خروجی کار، مشابه آنچه در صورت فراخوانی همگام بازگردانده می‌شد
.IP \[bu] 2
progress \- خروجی پیشرفت مربوط به کار زیربنایی
.PP
\f[B]احراز هویت برای این فراخوانی لازم نیست.\f[R]
.SS job/stop: متوقف کردن کار در حال اجرا
.PP
پارامترها:
.IP \[bu] 2
jobid \- شناسه کار (عدد صحیح).
.SS job/stopgroup: متوقف کردن تمام کارهای در حال اجرا در یک گروه
.PP
پارامترها:
.IP \[bu] 2
group \- نام گروه (رشته).
.SS mount/listmounts: نمایش نقاط اتصال فعلی
.PP
این دستور نقاط متصل‌شده فعلی را نشان می‌دهد، که می‌توان از آن‌ها برای انجام عمل unmount استفاده کرد.
.PP
این دستور پارامتری نمی‌پذیرد و مقادیر زیر را بازمی‌گرداند:
.IP \[bu] 2
mountPoints: فهرست نقاط اتصال فعلی
.PP
مثال:
.IP
.nf
\f[C]
rclone rc mount/listmounts
\f[R]
.fi
.SS mount/mount: ایجاد یک نقطه اتصال جدید
.PP
برنامه rclone به لینوکس، FreeBSD، macOS و ویندوز اجازه می‌دهد تا هر یک از سیستم‌های ذخیره‌سازی ابری Rclone را با استفاده از FUSE به عنوان یک سیستم فایل متصل (mount) کنند.
.PP
اگر هیچ mountType مشخص نشود، اولویت به این صورت در نظر گرفته می‌شود: ۱.
mount ۲. cmount ۳. mount2
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک مسیر ریموت برای متصل شدن (الزامی)
.IP \[bu] 2
mountPoint: مسیر معتبر روی رایانه محلی (الزامی)
.IP \[bu] 2
mountType: یکی از مقادیر (mount، cmount، mount2) که پیاده‌سازی اتصال مورد استفاده را مشخص می‌کند
.IP \[bu] 2
mountOpt: یک شیء JSON شامل گزینه‌های Mount.
.IP \[bu] 2
vfsOpt: یک شیء JSON شامل گزینه‌های VFS.
.PP
همچنین، می‌توانید گزینه‌های VFS و Mount را به صورت مسطح (flat) در بالاترین سطح نقشه پارامترها ارسال کنید.
نام گزینه‌ها همانند پرچم‌های CLI آن‌ها بدون \[aq]--\[aq] و با جایگزینی \[aq]-\[aq] با \[aq]_\[aq] است (برای مثال
\[aq]vfs_cache_mode\[aq] به جای \[aq]CacheMode\[aq] در داخل
\[aq]vfsOpt\[aq]، و \[aq]volname\[aq] به جای \[aq]VolName\[aq]
در داخل \[aq]mountOpt\[aq]).
.PP
اگر هم پارامترهای مسطح و هم بلوک‌های تو در توی \[aq]vfsOpt\[aq]/\[aq]mountOpt\[aq]
ارائه شوند، پارامترهای موجود در بلوک‌های تو در تو اولویت خواهند داشت.
.PP
در ویندوز، mountPoint می‌تواند روی \[dq]*\[dq] تنظیم شود تا حرف درایو بعدی موجود به طور خودکار اختصاص یابد، یا یک مسیر UNC اشتراک شبکه (برای مثال
\[dq]\[rs]server\[dq]) تا به عنوان یک درایو شبکه متصل شود.
در این موارد، حرف درایو واقعی در زمان اتصال تعیین می‌شود.
.PP
این دستور مقادیر زیر را بازمی‌گرداند:
.IP \[bu] 2
mountPoint: نقطه اتصال واقعی که استفاده شده است (این ممکن است با
ورودی متفاوت باشد، برای مثال
در ویندوز وقتی \[dq]*\[dq] ارسال می‌شود، حرف درایو اختصاص‌یافته
بازگردانده می‌شود)
.PP
مثال:
.IP
.nf
\f[C]
rclone rc mount/mount fs=mydrive: mountPoint=/home/<user>/mountPoint
rclone rc mount/mount fs=mydrive: mountPoint=/home/<user>/mountPoint mountType=mount
rclone rc mount/mount fs=TestDrive: mountPoint=/mnt/tmp vfsOpt=\[aq]{\[dq]CacheMode\[dq]: 2}\[aq] mountOpt=\[aq]{\[dq]AllowOther\[dq]: true}\[aq]
rclone rc mount/mount fs=TestDrive: mountPoint=/mnt/tmp vfs_cache_mode=writes volname=MyTestVolume
rclone rc mount/mount fs=mydrive: mountPoint=* mountType=cmount
\f[R]
.fi
.PP
گزینه‌های vfsOpt همان‌طور که در options/get شرح داده شده است هستند و می‌توان آن‌ها را در
بخش \[dq]vfs\[dq] هنگام اجرا دید، و گزینه‌های mountOpt را می‌توان در بخش
\[dq]mount\[dq] مشاهده کرد:
.IP
.nf
\f[C]
rclone rc options/get
\f[R]
.fi.SS mount/types: نمایش تمام انواع ممکن mount
.PP
این دستور تمام انواع ممکن mount را نمایش می‌دهد و آن‌ها را در قالب یک فهرست برمی‌گرداند.
.PP
این دستور هیچ پارامتری دریافت نمی‌کند و موارد زیر را برمی‌گرداند:
.IP \[bu] 2
mountTypes: فهرست انواع mount
.PP
انواع mount رشته‌هایی مانند \[dq]mount\[dq]، \[dq]mount2\[dq] و
\[dq]cmount\[dq] هستند و می‌توانند به عنوان پارامتر mountType به
دستور mount/mount ارسال شوند.
.PP
برای نمونه:
.IP
.nf
\f[C]
rclone rc mount/types
\f[R]
.fi
.SS mount/unmount: پیاده‌سازی (unmount) نقطه اتصال فعال انتخاب‌شده
.PP
نرم‌افزار rclone به لینوکس، FreeBSD، macOS و Windows اجازه می‌دهد هر یک از
سیستم‌های ذخیره‌سازی ابری Rclone را با استفاده از FUSE به عنوان یک سیستم فایل سوار (mount) کنند.
.PP
این دستور پارامترهای زیر را دریافت می‌کند:
.IP \[bu] 2
mountPoint: مسیر معتبر روی دستگاه محلی که نقطه اتصال در آن ایجاد شده است
(الزامی)
.PP
مثال:
.IP
.nf
\f[C]
rclone rc mount/unmount mountPoint=/home/<user>/mountPoint
\f[R]
.fi
.SS mount/unmountall: پیاده‌سازی (unmount) تمام نقاط اتصال فعال
.PP
نرم‌افزار rclone به لینوکس، FreeBSD، macOS و Windows اجازه می‌دهد هر یک از
سیستم‌های ذخیره‌سازی ابری Rclone را با استفاده از FUSE به عنوان یک سیستم فایل سوار (mount) کنند.
.PP
این دستور هیچ پارامتری دریافت نمی‌کند و در صورت عدم موفقیت در پیاده‌سازی، خطا برمی‌گرداند.
.PP
برای نمونه:
.IP
.nf
\f[C]
rclone rc mount/unmountall
\f[R]
.fi
.SS operations/about: بازگرداندن فضای استفاده‌شده در ریموت
.PP
این دستور پارامترهای زیر را دریافت می‌کند:
.IP \[bu] 2
fs \- یک رشته نام ریموت، برای نمونه:
\[dq]drive:\[dq]
.PP
نتیجه همانند خروجی حاصل از دستور rclone about --json است.
.PP
برای اطلاعات بیشتر در مورد موارد بالا، به دستور about (<https://rclone.org/commands/rclone_about>)
مراجعه کنید.
.SS operations/check: بررسی یکسان بودن مبدا و مقصد
.PP
تطابق فایل‌ها را در مبدا و مقصد بررسی می‌کند.
این دستور اندازه‌ها و هش‌ها را مقایسه کرده و گزارشی از فایل‌هایی که
مطابقت ندارند را ثبت می‌کند.
این عملیات تغییری در مبدا یا مقصد ایجاد نمی‌کند.
.PP
این دستور پارامترهای زیر را دریافت می‌کند:
.IP \[bu] 2
srcFs \- یک رشته نام ریموت، مانند
\[dq]drive:\[dq] برای مبدا، یا \[dq]/\[dq] برای سیستم فایل محلی
.IP \[bu] 2
dstFs \- یک رشته نام ریموت، مانند
\[dq]drive2:\[dq] برای مقصد، یا \[dq]/\[dq] برای سیستم فایل محلی
.IP \[bu] 2
download \- بررسی از طریق بارگیری (دانلود) به جای مقایسه هش
.IP \[bu] 2
checkFileHash \- در نظر گرفتن checkFileFs:checkFileRemote به عنوان یک فایل SUM با
هش‌هایی از نوع مشخص‌شده
.IP \[bu] 2
checkFileFs \- در نظر گرفتن checkFileFs:checkFileRemote به عنوان یک فایل SUM با
هش‌هایی از نوع مشخص‌شده
.IP \[bu] 2
checkFileRemote \- در نظر گرفتن checkFileFs:checkFileRemote به عنوان یک فایل SUM با
هش‌هایی از نوع مشخص‌شده
.IP \[bu] 2
oneWay \- بررسی فقط به صورت یک‌طرفه؛ فایل‌های مبدا باید در ریموت وجود داشته باشند
.IP \[bu] 2
combined \- ایجاد یک گزارش ترکیبی از تغییرات (پیش‌فرض false)
.IP \[bu] 2
missingOnSrc \- گزارش تمام فایل‌های ناموجود در مبدا (پیش‌فرض true)
.IP \[bu] 2
missingOnDst \- گزارش تمام فایل‌های ناموجود در مقصد (پیش‌فرض
true)
.IP \[bu] 2
match \- گزارش تمام فایل‌های منطبق (پیش‌فرض false)
.IP \[bu] 2
differ \- گزارش تمام فایل‌های غیرمنطبق (پیش‌فرض true)
.IP \[bu] 2
error \- گزارش تمام فایل‌های دارای خطا (در هش‌کردن یا خواندن) (پیش‌فرض true)
.PP
اگر گزینه download را مشخص کنید، داده‌ها را از هر دو ریموت بارگیری کرده
و آن‌ها را به صورت بلادرنگ در برابر یکدیگر بررسی می‌کند.
این قابلیت برای ریموت‌هایی که از هش پشتیبانی نمی‌کنند یا در صورتی که
واقعاً بخواهید تمام داده‌ها را بررسی کنید مفید است.
.PP
اگر گزینه سراسری size-only را ارسال کنید، تنها اندازه‌ها مقایسه می‌شوند
و هش‌ها بررسی نخواهند شد.
از این حالت برای یک بررسی سریع استفاده کنید.
.PP
اگر گزینه checkFileHash را با یک نام هش معتبر تعیین کنید،
مقدار checkFileFs:checkFileRemote باید به یک فایل متنی با قالب SUM اشاره کند.
در این حالت، فایل چکسام به عنوان مبدا و dstFs به عنوان مقصد در نظر
گرفته می‌شود.
توجه داشته باشید که در این حالت srcFs استفاده نمی‌شود و نباید تعیین گردد.
.PP
خروجی‌ها:
.IP \[bu] 2
success \- در صورت نبود خطا true، در غیر این صورت false
.IP \[bu] 2
status \- خلاصه متنی بررسی، OK یا یک رشته متنی
.IP \[bu] 2
hashType \- هش استفاده‌شده در بررسی، ممکن است وجود نداشته باشد
.IP \[bu] 2
combined \- آرایه‌ای از رشته‌های گزارش ترکیبی تغییرات
.IP \[bu] 2
missingOnSrc \- آرایه‌ای از رشته‌های تمام فایل‌های ناموجود در مبدا
.IP \[bu] 2
missingOnDst \- آرایه‌ای از رشته‌های تمام فایل‌های ناموجود در
مقصد
.IP \[bu] 2
match \- آرایه‌ای از رشته‌های تمام فایل‌های منطبق
.IP \[bu] 2
differ \- آرایه‌ای از رشته‌های تمام فایل‌های غیرمنطبق
.IP \[bu] 2
error \- آرایه‌ای از رشته‌های تمام فایل‌های دارای خطا (در هش‌کردن یا خواندن).SS operations/cleanup: پاک‌سازی فایل‌های درون سطل زباله در ریموت یا مسیر
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته از نام ریموت، برای نمونه:
\[dq]drive:\[dq]
.PP
برای اطلاعات بیشتر در مورد موارد بالا به دستور cleanup (https://rclone.org/commands/rclone_cleanup) مراجعه کنید.
.SS operations/copyfile: رونوشت یک فایل از ریموت مبدأ به ریموت مقصد
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
srcFs \- یک رشته از نام ریموت مانند
\[dq]drive:\[dq] برای مبدأ، یا \[dq]/\[dq] برای سیستم فایل محلی
.IP \[bu] 2
srcRemote \- مسیری درون آن ریموت مانند
\[dq]file.txt\[dq] برای مبدأ
.IP \[bu] 2
dstFs \- یک رشته از نام ریموت مانند
\[dq]drive2:\[dq] برای مقصد، یا \[dq]/\[dq] برای سیستم فایل محلی
.IP \[bu] 2
dstRemote \- مسیری درون آن ریموت مانند
\[dq]file2.txt\[dq] برای مقصد
.SS operations/copyurl: رونوشت نشانی URL به شیء
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته از نام ریموت مانند
\[dq]drive:\[dq]
.IP \[bu] 2
remote \- مسیری درون آن ریموت مانند
\[dq]dir\[dq]
.IP \[bu] 2
url \- رشته، نشانی URL برای خواندن از آن
.IP \[bu] 2
autoFilename \- بولی، برای دریافت نام فایل مقصد از url روی true تنظیم شود
.PP
برای اطلاعات بیشتر در مورد موارد بالا به دستور copyurl (https://rclone.org/commands/rclone_copyurl) مراجعه کنید.
.SS operations/delete: حذف فایل‌های موجود در مسیر
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته از نام ریموت مانند
\[dq]drive:\[dq]
.PP
برای اطلاعات بیشتر در مورد موارد بالا به دستور delete (https://rclone.org/commands/rclone_delete) مراجعه کنید.
.SS operations/deletefile: حذف تک‌فایل مشخص‌شده
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته از نام ریموت مانند
\[dq]drive:\[dq]
.IP \[bu] 2
remote \- مسیری درون آن ریموت مانند
\[dq]dir\[dq]
.PP
برای اطلاعات بیشتر در مورد موارد بالا به دستور deletefile (https://rclone.org/commands/rclone_deletefile) مراجعه کنید.
.SS operations/fsinfo: بازگرداندن اطلاعات درباره ریموت
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته از نام ریموت مانند
\[dq]drive:\[dq]
.PP
این دستور اطلاعاتی درباره ریموت داده‌شده بازمی‌گرداند؛
.IP
.nf
\f[C]
{
        // optional features and whether they are available or not
        \[dq]Features\[dq]: {
                \[dq]About\[dq]: true,
                \[dq]BucketBased\[dq]: false,
                \[dq]BucketBasedRootOK\[dq]: false,
                \[dq]CanHaveEmptyDirectories\[dq]: true,
                \[dq]CaseInsensitive\[dq]: false,
                \[dq]ChangeNotify\[dq]: false,
                \[dq]CleanUp\[dq]: false,
                \[dq]Command\[dq]: true,
                \[dq]Copy\[dq]: false,
                \[dq]DirCacheFlush\[dq]: false,
                \[dq]DirMove\[dq]: true,
                \[dq]Disconnect\[dq]: false,
                \[dq]DuplicateFiles\[dq]: false,
                \[dq]GetTier\[dq]: false,
                \[dq]IsLocal\[dq]: true,
                \[dq]ListR\[dq]: false,
                \[dq]MergeDirs\[dq]: false,
                \[dq]MetadataInfo\[dq]: true,
                \[dq]Move\[dq]: true,
                \[dq]OpenWriterAt\[dq]: true,
                \[dq]PublicLink\[dq]: false,
                \[dq]Purge\[dq]: true,
                \[dq]PutStream\[dq]: true,
                \[dq]PutUnchecked\[dq]: false,
                \[dq]ReadMetadata\[dq]: true,
                \[dq]ReadMimeType\[dq]: false,
                \[dq]ServerSideAcrossConfigs\[dq]: false,
                \[dq]SetTier\[dq]: false,
                \[dq]SetWrapper\[dq]: false,
                \[dq]Shutdown\[dq]: false,
                \[dq]SlowHash\[dq]: true,
                \[dq]SlowModTime\[dq]: false,
                \[dq]UnWrap\[dq]: false,
                \[dq]UserInfo\[dq]: false,
                \[dq]UserMetadata\[dq]: true,
                \[dq]WrapFs\[dq]: false,
                \[dq]WriteMetadata\[dq]: true,
                \[dq]WriteMimeType\[dq]: false
        },
        // Names of hashes available
        \[dq]Hashes\[dq]: [
                \[dq]md5\[dq],
                \[dq]sha1\[dq],
                \[dq]whirlpool\[dq],
                \[dq]crc32\[dq],
                \[dq]sha256\[dq],
                \[dq]dropbox\[dq],
                \[dq]mailru\[dq],
                \[dq]quickxor\[dq]
        ],
        \[dq]Name\[dq]: \[dq]local\[dq],        // Name as created
        \[dq]Precision\[dq]: 1,         // Precision of timestamps in ns
        \[dq]Root\[dq]: \[dq]/\[dq],            // Path as created
        \[dq]String\[dq]: \[dq]Local file system at /\[dq], // how the remote will appear in logs
        // Information about the system metadata for this backend
        \[dq]MetadataInfo\[dq]: {
                \[dq]System\[dq]: {
                        \[dq]atime\[dq]: {
                                \[dq]Help\[dq]: \[dq]Time of last access\[dq],
                                \[dq]Type\[dq]: \[dq]RFC 3339\[dq],
                                \[dq]Example\[dq]: \[dq]2006-01-02T15:04:05.999999999Z07:00\[dq]
                        },
                        \[dq]btime\[dq]: {
                                \[dq]Help\[dq]: \[dq]Time of file birth (creation)\[dq],
                                \[dq]Type\[dq]: \[dq]RFC 3339\[dq],
                                \[dq]Example\[dq]: \[dq]2006-01-02T15:04:05.999999999Z07:00\[dq]
                        },
                        \[dq]gid\[dq]: {
                                \[dq]Help\[dq]: \[dq]Group ID of owner\[dq],
                                \[dq]Type\[dq]: \[dq]decimal number\[dq],
                                \[dq]Example\[dq]: \[dq]500\[dq]
                        },
                        \[dq]mode\[dq]: {
                                \[dq]Help\[dq]: \[dq]File type and mode\[dq],
                                \[dq]Type\[dq]: \[dq]octal, unix style\[dq],
                                \[dq]Example\[dq]: \[dq]0100664\[dq]
                        },
                        \[dq]mtime\[dq]: {
                                \[dq]Help\[dq]: \[dq]Time of last modification\[dq],
                                \[dq]Type\[dq]: \[dq]RFC 3339\[dq],
                                \[dq]Example\[dq]: \[dq]2006-01-02T15:04:05.999999999Z07:00\[dq]
                        },
                        \[dq]rdev\[dq]: {
                                \[dq]Help\[dq]: \[dq]Device ID (if special file)\[dq],
                                \[dq]Type\[dq]: \[dq]hexadecimal\[dq],
                                \[dq]Example\[dq]: \[dq]1abc\[dq]
                        },
                        \[dq]uid\[dq]: {
                                \[dq]Help\[dq]: \[dq]User ID of owner\[dq],
                                \[dq]Type\[dq]: \[dq]decimal number\[dq],
                                \[dq]Example\[dq]: \[dq]500\[dq]
                        }
                },
                \[dq]Help\[dq]: \[dq]Textual help string\[rs]n\[dq]
        }
}
\f[R]
.fi
.PP
این دستور معادل خط فرمانی ندارد، بنابراین به‌جای آن از این دستور استفاده کنید:
.IP
.nf
\f[C]
rclone rc --loopback operations/fsinfo fs=remote:
\f[R]
.fi.SS operations/hashsum: تولید یک فایل hashsum برای تمام اشیاء موجود در مسیر.
.PP
یک فایل درهم‌سازی (هش) برای تمام اشیاء موجود در مسیر با استفاده از نوع هش مشخص‌شده تولید می‌کند.
خروجی در همان قالبی است که ابزارهای استاندارد md5sum/sha1sum ارائه می‌دهند.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته نام ریموت، برای مثال:
\[dq]drive:\[dq] برای مبدأ، \[dq]/\[dq] برای فایل‌سیستم محلی
.RS 2
.IP \[bu] 2
این می‌تواند به یک فایل اشاره کند و در این صورت تنها همان فایل در فهرست بازگردانده خواهد شد.
.RE
.IP \[bu] 2
hashType \- نوع هش مورد استفاده
.IP \[bu] 2
download \- بررسی از طریق بارگیری به جای هش (boolean)
.IP \[bu] 2
base64 \- خروجی دادن هش‌ها در قالب base64 به جای hex (boolean)
.PP
اگر پرچم download را مشخص کنید، داده‌ها را از ریموت دانلود کرده و درهم‌سازی را به‌طور بلادرنگ ایجاد می‌کند.
این قابلیت می‌تواند برای ریموت‌هایی که از هش ارائه‌شده پشتیبانی نمی‌کنند یا در صورتی که واقعاً قصد بررسی تمام داده‌ها را دارید مفید باشد.
.PP
توجه داشته باشید که اگر مایل به ارائه یک checkfile برای بررسی هش‌ها در برابر فایل‌های فعلی هستید، باید به جای operations/hashsum از operations/check استفاده کنید.
.PP
مقادیر بازگشتی:
.IP \[bu] 2
hashsum \- آرایه‌ای از رشته‌های مقادیر هش
.IP \[bu] 2
hashType \- نوع هش استفاده‌شده
.PP
مثال:
.IP
.nf
\f[C]
$ rclone rc --loopback operations/hashsum fs=bin hashType=MD5 download=true base64=true
{
    \[dq]hashType\[dq]: \[dq]md5\[dq],
    \[dq]hashsum\[dq]: [
        \[dq]WTSVLpuiXyJO_kGzJerRLg==  backend-versions.sh\[dq],
        \[dq]v1b_OlWCJO9LtNq3EIKkNQ==  bisect-go-rclone.sh\[dq],
        \[dq]VHbmHzHh4taXzgag8BAIKQ==  bisect-rclone.sh\[dq],
    ]
}
\f[R]
.fi
.PP
برای اطلاعات بیشتر در مورد موارد فوق، دستور hashsum (https://rclone.org/commands/rclone_hashsum) را ببینید.
.SS operations/hashsumfile: تولید یک هش برای یک فایل منفرد.
.PP
با استفاده از نوع هش مشخص‌شده، یک هش برای یک فایل منفرد تولید می‌کند.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته نام ریموت، برای مثال:
\[dq]drive:\[dq]
.IP \[bu] 2
remote \- مسیری در آن ریموت، برای مثال:
\[dq]file.txt\[dq]
.IP \[bu] 2
hashType \- نوع هش مورد استفاده
.IP \[bu] 2
download \- بررسی از طریق بارگیری به جای هش (boolean)
.IP \[bu] 2
base64 \- خروجی دادن هش‌ها در قالب base64 به جای hex (boolean)
.PP
اگر پرچم download را مشخص کنید، داده‌ها را از ریموت بارگیری کرده و هش را به‌طور بلادرنگ ایجاد می‌کند.
این قابلیت می‌تواند برای ریموت‌هایی که از هش ارائه‌شده پشتیبانی نمی‌کنند یا در صورتی که واقعاً قصد خواندن تمام داده‌ها را دارید مفید باشد.
.PP
مقادیر بازگشتی:
.IP \[bu] 2
hash \- هش مربوط به فایل
.IP \[bu] 2
hashType \- نوع هش استفاده‌شده
.PP
مثال:
.IP
.nf
\f[C]
$ rclone rc --loopback operations/hashsumfile fs=/ remote=/bin/bash hashType=MD5 download=true base64=true
{
    \[dq]hashType\[dq]: \[dq]md5\[dq],
    \[dq]hash\[dq]: \[dq]MDMw-fG2YXs7Uz5Nz-H68A==\[dq]
}
\f[R]
.fi
.PP
برای اطلاعات بیشتر در مورد موارد فوق، دستور hashsum (https://rclone.org/commands/rclone_hashsum) را ببینید..SS operations/list: فهرست کردن ریموت و مسیر مشخص‌شده در قالب JSON
.PP
این عملیات پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته نام ریموت، برای مثال
\[dq]drive:\[dq]
.IP \[bu] 2
remote \- یک مسیر در آن ریموت، برای مثال
\[dq]dir\[dq]
.IP \[bu] 2
opt \- یک dictionary از گزینه‌ها برای کنترل فهرست‌بندی (اختیاری)
.RS 2
.IP \[bu] 2
recurse \- در صورت تنظیم، پیمایش بازگشتی در دایرکتوری‌ها انجام می‌شود
.IP \[bu] 2
noModTime \- در صورت تنظیم، زمان تغییر بازگردانده می‌شود
.IP \[bu] 2
showEncrypted \- در صورت تنظیم، نام‌های رمزگشایی‌شده نمایش داده می‌شوند
.IP \[bu] 2
showOrigIDs \- در صورت تنظیم، شناسه‌های هر مورد در صورت مشخص بودن نمایش داده می‌شوند
.IP \[bu] 2
showHash \- در صورت تنظیم، یک dictionary از هش‌ها بازگردانده می‌شود
.IP \[bu] 2
noMimeType \- در صورت تنظیم، نوع‌های mime نمایش داده نمی‌شوند
.IP \[bu] 2
dirsOnly \- در صورت تنظیم، تنها دایرکتوری‌ها نمایش داده می‌شوند
.IP \[bu] 2
filesOnly \- در صورت تنظیم، تنها فایل‌ها نمایش داده می‌شوند
.IP \[bu] 2
metadata \- در صورت تنظیم، متادیتای اشیاء نیز بازگردانده می‌شود
.IP \[bu] 2
hashTypes \- یک array از رشته‌های انواع هش برای نمایش در صورت تنظیم بودن showHash
.RE
.PP
مقادیر بازگشتی:
.IP \[bu] 2
list
.RS 2
.IP \[bu] 2
این یک array از اشیاء است، همان‌طور که در دستور lsjson شرح داده شده است
.RE
.PP
برای اطلاعات بیشتر درباره موارد فوق و مثال‌ها، دستور lsjson (https://rclone.org/commands/rclone_lsjson) را ببینید.
.SS operations/mkdir: ایجاد یک دایرکتوری یا کانتینر مقصد
.PP
این عملیات پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته نام ریموت، برای مثال
\[dq]drive:\[dq]
.IP \[bu] 2
remote \- یک مسیر در آن ریموت، برای مثال
\[dq]dir\[dq]
.PP
برای اطلاعات بیشتر درباره موارد فوق، دستور mkdir (https://rclone.org/commands/rclone_mkdir) را ببینید.
.SS operations/movefile: انتقال یک فایل از ریموت مبدأ به ریموت مقصد
.PP
این عملیات پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
srcFs \- یک رشته نام ریموت، برای مثال
\[dq]drive:\[dq] برای مبدأ، \[dq]/\[dq] برای سیستم‌فایل محلی
.IP \[bu] 2
srcRemote \- یک مسیر در آن ریموت، برای مثال
\[dq]file.txt\[dq] برای مبدأ
.IP \[bu] 2
dstFs \- یک رشته نام ریموت، برای مثال
\[dq]drive2:\[dq] برای مقصد، \[dq]/\[dq] برای سیستم‌فایل محلی
.IP \[bu] 2
dstRemote \- یک مسیر در آن ریموت، برای مثال
\[dq]file2.txt\[dq] برای مقصد
.SS operations/publiclink: ایجاد یا دریافت یک پیوند عمومی به فایل یا پوشه داده‌شده.
.PP
این عملیات پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته نام ریموت، برای مثال
\[dq]drive:\[dq]
.IP \[bu] 2
remote \- یک مسیر در آن ریموت، برای مثال
\[dq]dir\[dq]
.IP \[bu] 2
unlink \- boolean \- در صورت تنظیم، پیوند را به جای افزودن حذف می‌کند
(اختیاری)
.IP \[bu] 2
expire \- string \- زمان انقضای پیوند، برای مثال
\[dq]1d\[dq] (اختیاری)
.PP
مقادیر بازگشتی:
.IP \[bu] 2
url \- نشانی وب (URL) منبع
.PP
برای اطلاعات بیشتر درباره موارد فوق، دستور link (https://rclone.org/commands/rclone_link) را ببینید..SS operations/purge: حذف یک دایرکتوری یا کانتینر و تمام محتویات آن
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته نام ریموت مانند
\[dq]drive:\[dq]
.IP \[bu] 2
remote \- یک مسیر در آن ریموت مانند
\[dq]dir\[dq]
.PP
برای اطلاعات بیشتر درباره موارد بالا، دستور purge (https://rclone.org/commands/rclone_purge) را ببینید.
.SS operations/rmdir: حذف یک دایرکتوری یا کانتینر خالی
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته نام ریموت مانند
\[dq]drive:\[dq]
.IP \[bu] 2
remote \- یک مسیر در آن ریموت مانند
\[dq]dir\[dq]
.PP
برای اطلاعات بیشتر درباره موارد بالا، دستور rmdir (https://rclone.org/commands/rclone_rmdir) را ببینید.
.SS operations/rmdirs: حذف تمام دایرکتوری‌های خالی در مسیر
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته نام ریموت مانند
\[dq]drive:\[dq]
.IP \[bu] 2
remote \- یک مسیر در آن ریموت مانند
\[dq]dir\[dq]
.IP \[bu] 2
leaveRoot \- مقدار بولی (boolean)، برای حذف نشدن ریشه روی true تنظیم می‌شود
.PP
برای اطلاعات بیشتر درباره موارد بالا، دستور rmdirs (https://rclone.org/commands/rclone_rmdirs) را ببینید.
.SS operations/settier: تغییر رده یا کلاس ذخیره‌سازی در تمامی فایل‌های مسیر
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته نام ریموت مانند
\[dq]drive:\[dq]
.PP
برای اطلاعات بیشتر درباره موارد بالا، دستور settier (https://rclone.org/commands/rclone_settier) را ببینید.
.SS operations/settierfile: تغییر رده یا کلاس ذخیره‌سازی روی تک‌فایل مشخص‌شده
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته نام ریموت مانند
\[dq]drive:\[dq]
.IP \[bu] 2
remote \- یک مسیر در آن ریموت مانند
\[dq]dir\[dq]
.SS operations/size: شمارش تعداد بایت‌ها و فایل‌ها در ریموت
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته نام ریموت مانند
\[dq]drive:path/to/dir\[dq]
.PP
مقادیر بازگشتی:
.IP \[bu] 2
count \- تعداد فایل‌ها
.IP \[bu] 2
bytes \- تعداد بایت‌های موجود در آن فایل‌ها
.PP
برای اطلاعات بیشتر درباره موارد بالا، دستور size (https://rclone.org/commands/rclone_size) را ببینید.
.SS operations/stat: ارائه اطلاعات درباره فایل یا دایرکتوری ارائه‌شده
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته نام ریموت مانند \[dq]drive:\[dq]
.IP \[bu] 2
remote \- یک مسیر در آن ریموت مانند \[dq]dir\[dq]
.IP \[bu] 2
opt \- یک دیکشنری از گزینه‌ها برای کنترل فهرست‌بندی (اختیاری)
.RS 2
.IP \[bu] 2
برای مشاهده گزینه‌ها operations/list را ببینید
.RE
.PP
نتیجه به صورت زیر است:
.IP \[bu] 2
item \- شیئی مشابه آنچه در دستور lsjson شرح داده شده است.
در صورت پیدا نشدن، مقدار آن null خواهد بود.
.PP
توجه داشته باشید که اگر تنها به فایل‌ها نیاز دارید، فعال کردن پرچم filesOnly در گزینه‌ها بسیار کارآمدتر است.
.PP
برای اطلاعات بیشتر درباره موارد بالا و مثال‌ها، دستور lsjson (https://rclone.org/commands/rclone_lsjson) را ببینید..SS operations/uploadfile: بارگذاری فایل با استفاده از multiform/form-data
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
fs \- یک رشته نام ریموت، برای مثال:
\[dq]drive:\[dq]
.IP \[bu] 2
remote \- یک مسیر در آن ریموت، برای مثال:
\[dq]dir\[dq]
.IP \[bu] 2
هر بخش در بدنه نمایانگر فایلی است که باید بارگذاری شود
.SS options/blocks: فهرست کردن تمام بلوک‌های گزینه‌ها
.PP
بازمی‌گرداند: \- options \- فهرستی از نام‌های بلوک‌های گزینه‌ها
.SS options/get: دریافت تمام گزینه‌های سراسری
.PP
شیئی را بازمی‌گرداند که کلیدهای آن نام بلوک‌های گزینه و مقادیر آن شیئی حاوی مقادیر فعلی گزینه‌ها است.
.PP
پارامترها:
.IP \[bu] 2
blocks: رشته اختیاری از بلوک‌های جداشده با کاما جهت گنجاندن
.RS 2
.IP \[bu] 2
اگر این مقدار داده نشود یا \[dq]\[dq] باشد، همه گنجانده می‌شوند
.RE
.PP
توجه داشته باشید که این‌ها گزینه‌های سراسری هستند و تحت تأثیر استفاده از پارامترهای _config و _filter قرار نمی‌گیرند.
اگر می‌خواهید پارامترهای تنظیم‌شده در _config یا _filter را بخوانید، از options/local استفاده کنید.
.PP
این دستور نام‌های داخلی گزینه در rclone را نشان می‌دهد که به‌جز چند استثنا، باید به‌سادگی با گزینه‌های بیرونی مطابقت داشته باشند.
.SS options/info: دریافت اطلاعات درباره تمام گزینه‌های سراسری
.PP
شیئی را بازمی‌گرداند که کلیدهای آن نام بلوک‌های گزینه و مقادیر آن آرایه‌ای از اشیاء شامل اطلاعات مربوط به هر گزینه است.
.PP
پارامترها:
.IP \[bu] 2
blocks: رشته اختیاری از بلوک‌های جداشده با کاما جهت گنجاندن
.RS 2
.IP \[bu] 2
اگر این مقدار داده نشود یا \[dq]\[dq] باشد، همه گنجانده می‌شوند
.RE
.PP
این اشیاء در همان قالبی هستند که توسط
\[dq]config/providers\[dq]
بازگردانده می‌شود.
آن‌ها در بخش بلوک‌های گزینه شرح داده شده‌اند.
.SS options/local: دریافت پیکربندی فعال فعلی برای این فراخوانی
.PP
شیئی را با کلیدهای \[dq]config\[dq] و \[dq]filter\[dq] بازمی‌گرداند.
کلید \[dq]config\[dq] شامل پیکربندی محلی و کلید
\[dq]filter\[dq] شامل فیلترهای محلی است.
.PP
توجه داشته باشید که این‌ها گزینه‌های محلی مختص این فراخوانی rc هستند.
اگر _config ارائه نشده باشد، همان گزینه‌های سراسری خواهند بود.
این موضوع در مورد \[dq]_filter\[dq] نیز صدق می‌کند.
.PP
این فراخوانی بیشتر برای بررسی این موضوع مفید است که آیا ارسال _config و _filter به‌درستی کار می‌کند یا خیر.
.PP
این دستور نام‌های داخلی گزینه در rclone را نشان می‌دهد که به‌جز چند استثنا، باید به‌سادگی با گزینه‌های بیرونی مطابقت داشته باشند.
.SS options/set: تنظیم یک گزینه
.PP
پارامترها:
.IP \[bu] 2
نام بلوک گزینه حاوی شیئی با
.RS 2
.IP \[bu] 2
key: value
.RE
.PP
به هر تعداد که نیاز باشد قابل تکرار است.
.PP
تنها گزینه‌هایی را که مایل به تغییرشان هستید ارسال کنید.
اگر گزینه‌ای ناشناخته باشد، در سکوت نادیده گرفته می‌شود.
همه گزینه‌ها در صورت تغییر به این شیوه اثربخش نخواهند بود.
.PP
برای مثال:
.PP
این دستور لاگ‌های سطح DEBUG (\-vv) را تنظیم می‌کند (این مقادیر را می‌توان با عدد یا رشته تنظیم کرد)
.IP
.nf
\f[C]
rclone rc options/set --json \[aq]{\[dq]main\[dq]: {\[dq]LogLevel\[dq]: \[dq]DEBUG\[dq]}}\[aq]
rclone rc options/set --json \[aq]{\[dq]main\[dq]: {\[dq]LogLevel\[dq]: 8}}\[aq]
\f[R]
.fi
.PP
و این لاگ‌های سطح INFO (\-v) را تنظیم می‌کند
.IP
.nf
\f[C]
rclone rc options/set --json \[aq]{\[dq]main\[dq]: {\[dq]LogLevel\[dq]: \[dq]INFO\[dq]}}\[aq]
\f[R]
.fi
.PP
و این لاگ‌های سطح NOTICE (عادی بدون \-v) را تنظیم می‌کند
.IP
.nf
\f[C]
rclone rc options/set --json \[aq]{\[dq]main\[dq]: {\[dq]LogLevel\[dq]: \[dq]NOTICE\[dq]}}\[aq]
\f[R]
.fi.SS pluginsctl/addPlugin: افزودن یک افزونه با استفاده از url
.PP
برای افزودن یک افزونه به webgui استفاده می‌شود.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
url \- نشانی http مخزن گیت‌هاب که افزونه در آن میزبانی می‌شود
(http://github.com/rclone/rclone-webui-react).
.PP
مثال:
.PP
rclone rc pluginsctl/addPlugin
.SS pluginsctl/getPluginsForType: دریافت افزونه‌ها با معیارهای نوع
.PP
تمام افزونه‌های ممکن را بر اساس نوع mime نمایش می‌دهد.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
type \- نوع mime پشتیبانی‌شده توسط یک افزونه بارگذاری‌شده، مانند
(video/mp4, audio/mp3).
.IP \[bu] 2
pluginType \- فیلتر کردن افزونه‌ها بر اساس نوع آن‌ها، مانند
(DASHBOARD, FILE_HANDLER, TERMINAL).
.PP
خروجی‌ها:
.IP \[bu] 2
loadedPlugins \- فهرست افزونه‌های عملیاتی فعلی.
.IP \[bu] 2
testPlugins \- فهرست افزونه‌های توسعه که موقتاً بارگذاری شده‌اند و معمولاً
روی سرور متفاوتی در حال اجرا هستند.
.PP
مثال:
.PP
rclone rc pluginsctl/getPluginsForType type=video/mp4
.SS pluginsctl/listPlugins: دریافت فهرست افزونه‌های بارگذاری‌شده فعلی
.PP
به شما امکان می‌دهد افزونه‌های فعال فعلی و جزئیات آن‌ها را دریافت کنید.
.PP
این دستور هیچ پارامتری نمی‌پذیرد و مقادیر زیر را برمی‌گرداند:
.IP \[bu] 2
loadedPlugins \- فهرست افزونه‌های عملیاتی فعلی.
.IP \[bu] 2
testPlugins \- فهرست افزونه‌های توسعه که موقتاً بارگذاری شده‌اند و معمولاً
روی سرور متفاوتی در حال اجرا هستند.
.PP
برای نمونه:
.PP
rclone rc pluginsctl/listPlugins
.SS pluginsctl/listTestPlugins: نمایش افزونه‌های آزمایشی بارگذاری‌شده فعلی
.PP
امکان فهرست کردن افزونه‌های آزمایشی را که مقدار rclone.test در package.json آن‌ها برابر با true تنظیم شده است فراهم می‌کند.
.PP
این دستور هیچ پارامتری نمی‌پذیرد و مقادیر زیر را برمی‌گرداند:
.IP \[bu] 2
loadedTestPlugins \- فهرست افزونه‌های آزمایشی که در حال حاضر در دسترس هستند.
.PP
برای نمونه:
.IP
.nf
\f[C]
rclone rc pluginsctl/listTestPlugins
\f[R]
.fi
.SS pluginsctl/removePlugin: حذف یک افزونه بارگذاری‌شده
.PP
به شما امکان می‌دهد یک افزونه را با استفاده از نام آن حذف کنید.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
name \- نام افزونه در قالب
\f[V]author\f[R]/\f[V]plugin_name\f[R].
.PP
برای نمونه:
.PP
rclone rc pluginsctl/removePlugin name=rclone/video-plugin
.SS pluginsctl/removeTestPlugin: حذف یک افزونه آزمایشی
.PP
به شما امکان می‌دهد یک افزونه را با استفاده از نام آن حذف کنید.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
name \- نام افزونه در قالب
\f[V]author\f[R]/\f[V]plugin_name\f[R].
.PP
مثال:
.IP
.nf
\f[C]
rclone rc pluginsctl/removeTestPlugin name=rclone/rclone-webui-react
\f[R]
.fi.SS rc/error: این دستور یک خطا بازمی‌گرداند
.PP
این دستور خطایی بازمی‌گرداند که ورودی را به عنوان بخشی از رشته‌ی خطای خود به همراه دارد.
برای آزمایش مدیریت خطا مفید است.
.PP
\f[B]احراز هویت برای این فراخوانی الزامی نیست.\f[R]
.SS rc/fatal: این دستور یک خطای مهلک بازمی‌گرداند
.PP
این دستور خطایی بازمی‌گرداند که ورودی را به عنوان بخشی از رشته‌ی خطای خود به همراه دارد.
برای آزمایش مدیریت خطا مفید است.
.SS rc/list: فهرست کردن تمام دستورهای ثبت‌شده‌ی کنترل از راه دور
.PP
این دستور تمامی دستورهای ثبت‌شده‌ی کنترل از راه دور را به عنوان یک نگاشت JSON در پاسخ commands فهرست می‌کند.
.PP
\f[B]احراز هویت برای این فراخوانی الزامی نیست.\f[R]
.SS rc/noop: بازتاب پارامترهای ورودی به پارامترهای خروجی
.PP
این دستور پارامترهای ورودی را برای اهداف آزمایشی به پارامترهای خروجی بازتاب می‌دهد.
می‌توان از آن برای بررسی فعال بودن rclone و اطمینان از عملکرد صحیح ارسال پارامترها استفاده کرد.
.PP
\f[B]احراز هویت برای این فراخوانی الزامی نیست.\f[R]
.SS rc/noopauth: بازتاب پارامترهای ورودی به پارامترهای خروجی با الزام به احراز هویت
.PP
این دستور پارامترهای ورودی را برای اهداف آزمایشی به پارامترهای خروجی بازتاب می‌دهد.
می‌توان از آن برای بررسی فعال بودن rclone و اطمینان از عملکرد صحیح ارسال پارامترها استفاده کرد.
.SS rc/panic: این دستور با ایجاد panic یک خطا بازمی‌گرداند
.PP
این دستور خطایی بازمی‌گرداند که ورودی را به عنوان بخشی از رشته‌ی خطای خود به همراه دارد.
برای آزمایش مدیریت خطا مفید است.
.SS serve/list: نمایش سرورهای در حال اجرا
.PP
نمایش سرورهای در حال اجرا همراه با شناسه.
.PP
این دستور هیچ پارامتری دریافت نمی‌کند و موارد زیر را بازمی‌گرداند:
.IP \[bu] 2
list: فهرست دستورهای در حال اجرای serve
.PP
هر عنصر از این فهرست شامل موارد زیر خواهد بود:
.IP \[bu] 2
id: شناسه سرور
.IP \[bu] 2
addr: نشانی‌ای که سرور روی آن در حال اجرا است
.IP \[bu] 2
params: پارامترهای استفاده‌شده برای راه‌اندازی سرور
.PP
برای نمونه:
.IP
.nf
\f[C]
rclone rc serve/list
\f[R]
.fi
.PP
مقدار بازگشتی:
.IP
.nf
\f[C]
{
    \[dq]list\[dq]: [
        {
            \[dq]addr\[dq]: \[dq][::]:4321\[dq],
            \[dq]id\[dq]: \[dq]nfs-ffc2a4e5\[dq],
            \[dq]params\[dq]: {
                \[dq]fs\[dq]: \[dq]remote:\[dq],
                \[dq]opt\[dq]: {
                    \[dq]ListenAddr\[dq]: \[dq]:4321\[dq]
                },
                \[dq]type\[dq]: \[dq]nfs\[dq],
                \[dq]vfsOpt\[dq]: {
                    \[dq]CacheMode\[dq]: \[dq]full\[dq]
                }
            }
        }
    ]
}
\f[R]
.fi.SS serve/start: ایجاد یک سرور جدید
.PP
یک سرور جدید با پارامترهای مشخص‌شده ایجاد می‌کند.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
\f[V]type\f[R] \- نوع سرور: \f[V]http\f[R]، \f[V]webdav\f[R]،
\f[V]ftp\f[R]، \f[V]sftp\f[R]، \f[V]nfs\f[R] و غیره.
.IP \[bu] 2
\f[V]fs\f[R] \- مسیر فضای ذخیره‌سازی دوردست (remote) برای سرویس‌دهی
.IP \[bu] 2
\f[V]addr\f[R] \- آدرس ip:port برای اجرای سرور بر روی آن، مانند \[dq]:1234\[dq] یا
\[dq]localhost:1234\[dq]
.PP
سایر پارامترها همان‌طور هستند که در مستندات گزینه‌های خط فرمان
rclone serve (https://rclone.org/commands/rclone_serve) شرح داده شده است.
برای تبدیل یک گزینه خط فرمان به یک پارامتر rc، علامت \f[V]--\f[R]
ابتدایی را حذف کرده و \f[V]-\f[R] را با \f[V]_\f[R] جایگزین کنید؛ بنابراین
\f[V]--vfs-cache-mode\f[R] تبدیل به \f[V]vfs_cache_mode\f[R] می‌شود.
.PP
پارامترهای گزینه (مانند VFS، پروکسی و گزینه‌های ویژه پروتکل)
را می‌توان به صورت هم‌سطح در بالاترین سطح نگاشت پارامترها یا درون
اشیاء تو در توی JSON ذیل کلیدهای \f[V]vfsOpt\f[R]، \f[V]proxyOpt\f[R] و
\f[V]opt\f[R] ارسال کرد (به عنوان مثال:
\f[V]vfsOpt=\[aq]{\[dq]CacheMode\[dq]: 2}\[aq]\f[R]،
\f[V]proxyOpt=\[aq]{\[dq]AuthProxy\[dq]: \[dq]http://127.0.0.1:8080\[dq]}\[aq]\f[R]).
اگر هم پارامترهای هم‌سطح و هم بلوک‌های تو در تو مشخص شوند، پارامترهای
موجود در بلوک‌های تو در تو اولویت خواهند داشت.
توجه داشته باشید که پارامترهای سراسری باید با \f[V]_config\f[R] و
\f[V]_filter\f[R] طبق آنچه در بالا شرح داده شد تنظیم شوند.
.PP
مثال‌ها:
.IP
.nf
\f[C]
rclone rc serve/start type=nfs fs=remote: addr=:4321 vfs_cache_mode=full
rclone rc serve/start --json \[aq]{\[dq]type\[dq]:\[dq]nfs\[dq],\[dq]fs\[dq]:\[dq]remote:\[dq],\[dq]addr\[dq]:\[dq]:1234\[dq],\[dq]vfs_cache_mode\[dq]:\[dq]full\[dq]}\[aq]
rclone rc serve/start type=webdav fs=remote: vfsOpt=\[aq]{\[dq]CacheMode\[dq]: 2}\[aq] proxyOpt=\[aq]{\[dq]AuthProxy\[dq]: \[dq]http://127.0.0.1:8080\[dq]}\[aq]
\f[R]
.fi
.PP
این دستور پاسخ زیر را باز می‌گرداند:
.IP
.nf
\f[C]
{
    \[dq]addr\[dq]: \[dq][::]:4321\[dq], // Address the server was started on
    \[dq]id\[dq]: \[dq]nfs-ecfc6852\[dq] // Unique identifier for the server instance
}
\f[R]
.fi
.PP
یا در صورتی که راه‌اندازی با خطا مواجه شود، یک پیام خطا می‌دهد.
.PP
سرور را با \f[V]serve/stop\f[R] متوقف کرده و سرورهای در حال اجرا
را با \f[V]serve/list\f[R] فهرست کنید.
.SS serve/stop: متوقف کردن سرویس‌دهی فعال انتخاب‌شده
.PP
یک نمونه در حال اجرای \f[V]serve\f[R] را بر اساس شناسه (ID) متوقف می‌کند.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
\f[V]id\f[R]: همان‌طور که توسط serve/start بازگردانده شده است
.PP
این دستور در صورت موفقیت یک پاسخ خالی و در غیر این صورت یک پیام خطا برمی‌گرداند.
.PP
مثال:
.IP
.nf
\f[C]
rclone rc serve/stop id=12345
\f[R]
.fi
.SS serve/stopall: متوقف کردن همه سرورهای فعال
.PP
همه سرورهای فعال را متوقف کنید.
.PP
این دستور تمام سرورهای فعال را متوقف خواهد کرد.
.IP
.nf
\f[C]
rclone rc serve/stopall
\f[R]
.fi.SS serve/types: نمایش تمام انواع ممکن serve
.PP
این دستور تمام انواع ممکن serve را نمایش داده و آن‌ها را به صورت یک فهرست بازمی‌گرداند.
.PP
این دستور هیچ پارامتری دریافت نمی‌کند و موارد زیر را بازمی‌گرداند:
.IP \[bu] 2
types: فهرستی از انواع serve، مانند \[dq]nfs\[dq]، \[dq]sftp\[dq] و غیره
.PP
انواع serve رشته‌هایی مانند \[dq]serve\[dq]، \[dq]serve2\[dq] و
\[dq]cserve\[dq] هستند و می‌توانند به عنوان پارامتر serveType به serve/start فرستاده شوند.
.PP
برای مثال:
.IP
.nf
\f[C]
rclone rc serve/types
\f[R]
.fi
.PP
خروجی بازگشتی:
.IP
.nf
\f[C]
{
    \[dq]types\[dq]: [
        \[dq]http\[dq],
        \[dq]sftp\[dq],
        \[dq]nfs\[dq]
    ]
}
\f[R]
.fi
.SS sync/bisync: انجام همگام‌سازی دوطرفه بین دو مسیر.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
path1 (الزامی) \- (string) یک رشته دایرکتوری ریموت، برای مثال
\f[V]drive:path1\f[R]
.IP \[bu] 2
path2 (الزامی) \- (string) یک رشته دایرکتوری ریموت، برای مثال
\f[V]drive:path2\f[R]
.IP \[bu] 2
dryRun \- (bool) حالت اجرای آزمایشی (dry-run)
.IP \[bu] 2
backupDir1 \- (string) گزینه --backup-dir برای Path1.
باید یک مسیر غیرهم‌پوشان در همان ریموت باشد.
.PD 0
.P
.PD
.IP \[bu] 2
backupDir2 \- (string) گزینه --backup-dir برای Path2.
باید یک مسیر غیرهم‌پوشان در همان ریموت باشد.
.PD 0
.P
.PD
.IP \[bu] 2
checkAccess \- (bool) اطمینان از یافت شدن فایل‌های مورد انتظار RCLONE_TEST در هر دو سیستم‌فایل Path1 و Path2، در غیر این صورت لغو عملیات.
.PD 0
.P
.PD
.IP \[bu] 2
checkFilename \- (string) نام فایل برای --check-access (پیش‌فرض:
RCLONE_TEST)
.PD 0
.P
.PD
.IP \[bu] 2
checkSync \- (string) کنترل مقایسه فهرست‌بندی‌های نهایی:
true|false|only (پیش‌فرض: true)
.PD 0
.P
.PD
.IP \[bu] 2
compare \- (string) فهرستی از گزینه‌های مقایسه اختصاصی bisync جدا شده با کاما، برای مثال:
\[aq]size,modtime,checksum\[aq] (پیش‌فرض: \[aq]size,modtime\[aq])
.PD 0
.P
.PD
.IP \[bu] 2
conflictLoser \- (ConflictLoserAction) اقدام لازم برای فایل بازنده در تداخل همگام‌سازی (هنگامی که برنده وجود دارد) یا هر دو فایل (هنگامی که برنده‌ای وجود ندارد): , num, pathname, delete (پیش‌فرض: num)
.PD 0
.P
.PD
.IP \[bu] 2
conflictResolve \- (string) حل خودکار تداخل‌ها با اولویت دادن به نسخه‌ای که عبارت است از:
none, path1, path2, newer, older, larger, smaller
(پیش‌فرض: none)
.PD 0
.P
.PD
.IP \[bu] 2
conflictSuffix \- (string) پسوند مورد استفاده هنگام تغییر نام --conflict-loser.
می‌تواند یک رشته یا دو رشته جدا شده با کاما برای تخصیص پسوندهای متفاوت به Path1/Path2 باشد.
(پیش‌فرض: \[aq]conflict\[aq])
.PD 0
.P
.PD
.IP \[bu] 2
createEmptySrcDirs \- (bool) همگام‌سازی ایجاد و حذف دایرکتوری‌های خالی.
(با --remove-empty-dirs ناسازگار است)
.PD 0
.P
.PD
.IP \[bu] 2
downloadHash \- (bool) محاسبه هش از طریق بارگیری در مواردی که روش دیگری در دسترس نیست.
(هشدار: ممکن است کند باشد و حجم زیادی داده مصرف کند!)
.PD 0
.P
.PD
.IP \[bu] 2
filtersFile \- (string) خواندن الگوهای فیلترسازی از یک فایل
.PD 0
.P
.PD
.IP \[bu] 2
force \- (bool) دور زدن بررسی ایمنی --max-delete و اجرای همگام‌سازی.
استفاده از آن همراه با --verbose پیشنهاد می‌شود
.PD 0
.P
.PD
.IP \[bu] 2
ignoreListingChecksum \- (bool) عدم استفاده از چک‌سام‌ها برای فهرست‌بندی‌ها (افزودن
--ignore-checksum برای صرف‌نظر کردن مضاعف از بررسی‌های چک‌سام پس از رونوشت)
.PD 0
.P
.PD
.IP \[bu] 2
maxLock \- (Duration) فایل‌های قفلی که قدیمی‌تر از این مقدار باشند منقضی در نظر گرفته می‌شوند
(پیش‌فرض: 0 (هرگز منقضی نمی‌شود)) (حداقل: 2m)
.PD 0
.P
.PD
.IP \[bu] 2
noCleanup \- (bool) نگه‌داشتن فایل‌های کاری (مفید برای عیب‌یابی و آزمایش).
.PD 0
.P
.PD
.IP \[bu] 2
noSlowHash \- (bool) نادیده گرفتن چک‌سام‌های فهرست‌بندی فقط در بک‌اند‌هایی که در آن‌ها کند هستند
.PD 0
.P
.PD
.IP \[bu] 2
recover \- (bool) بازیابی خودکار از وقفه بدون نیاز به
--resync.
.PD 0
.P
.PD
.IP \[bu] 2
removeEmptyDirs \- (bool) حذف تمام دایرکتوری‌های خالی در مرحله پاک‌سازی نهایی.
.PD 0
.P
.PD
.IP \[bu] 2
resilient \- (bool) اجازه به اجراهای آینده برای تلاش مجدد پس از برخی خطاهای کم‌اهمیت‌تر، به جای الزام به --resync.
.PD 0
.P
.PD
.IP \[bu] 2
resync \- (bool) اجرای همگام‌سازی مجدد (resync) را انجام می‌دهد.
معادل با --resync-mode path1.
توصیه می‌شود ابتدا از --verbose یا --dry-run استفاده کنید.
.PD 0
.P
.PD
.IP \[bu] 2
resyncMode \- (string) در حین resync، اولویت دادن به نسخه‌ای که عبارت است از: path1,
path2, newer, older, larger, smaller (پیش‌فرض: در صورت فعال بودن --resync مقدار path1، در غیر این صورت none برای عدم اجرای resync.).PD 0
.P
.PD
.IP \[bu] 2
slowHashSyncOnly - (bool) نادیده‌گرفتن چکسام‌های کُند برای فهرست‌گیری‌ها و تفاضل‌ها (deltas)، اما همچنان در نظر گرفتن آن‌ها هنگام فراخوانی‌های همگام‌سازی (sync).
.PD 0
.P
.PD
.IP \[bu] 2
workdir - (string) استفاده از یک دایرکتوری کاری سفارشی - کاربردی برای آزمایش.
(پیش‌فرض: /home/ncw/.cache/rclone/bisync)
.PP
برای اطلاعات بیشتر، راهنمای دستور bisync (https://rclone.org/commands/rclone_bisync) و
توضیحات کامل bisync (https://rclone.org/bisync) را ببینید.
.SS sync/copy: رونوشت یک دایرکتوری از ریموت مبدأ به ریموت مقصد
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
srcFs - یک رشته نام ریموت مانند
\[dq]drive:src\[dq] برای مبدأ
.IP \[bu] 2
dstFs - یک رشته نام ریموت مانند
\[dq]drive:dst\[dq] برای مقصد
.IP \[bu] 2
createEmptySrcDirs - در صورت تنظیم، دایرکتوری‌های خالی مبدأ در مقصد ایجاد می‌شوند
.PP
برای اطلاعات بیشتر در مورد موارد بالا، دستور copy (https://rclone.org/commands/rclone_copy) را
ببینید.
.SS sync/move: انتقال یک دایرکتوری از ریموت مبدأ به ریموت مقصد
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
srcFs - یک رشته نام ریموت مانند
\[dq]drive:src\[dq] برای مبدأ
.IP \[bu] 2
dstFs - یک رشته نام ریموت مانند
\[dq]drive:dst\[dq] برای مقصد
.IP \[bu] 2
createEmptySrcDirs - در صورت تنظیم، دایرکتوری‌های خالی مبدأ در مقصد ایجاد می‌شوند
.IP \[bu] 2
deleteEmptySrcDirs - در صورت تنظیم، دایرکتوری‌های خالی مبدأ حذف می‌شوند
.PP
برای اطلاعات بیشتر در مورد موارد بالا، دستور move (https://rclone.org/commands/rclone_move) را
ببینید.
.SS sync/sync: همگام‌سازی یک دایرکتوری از ریموت مبدأ به ریموت مقصد
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
srcFs - یک رشته نام ریموت مانند
\[dq]drive:src\[dq] برای مبدأ
.IP \[bu] 2
dstFs - یک رشته نام ریموت مانند
\[dq]drive:dst\[dq] برای مقصد
.IP \[bu] 2
createEmptySrcDirs - در صورت تنظیم، دایرکتوری‌های خالی مبدأ در مقصد ایجاد می‌شوند
.PP
برای اطلاعات بیشتر در مورد موارد بالا، دستور sync (https://rclone.org/commands/rclone_sync) را
ببینید.
.SS vfs/forget: فراموش‌کردن فایل‌ها یا دایرکتوری‌ها در حافظهٔ نهان (cache) دایرکتوری.
.PP
این دستور مسیرهای موجود در حافظهٔ نهان دایرکتوری را فراموش می‌کند و باعث می‌شود در
صورت نیاز، مجدداً از ریموت خوانده شوند.
.PP
اگر هیچ مسیری ارسال نشود، تمام مسیرهای موجود در حافظهٔ نهان دایرکتوری فراموش
خواهند شد.
.IP
.nf
\f[C]
rclone rc vfs/forget
\f[R]
.fi
.PP
در غیر این صورت، فایل‌ها یا دایرکتوری‌ها را به صورت file=path یا dir=path ارسال کنید.
هر کلید پارامتری که با file شروع شود آن فایل را فراموش می‌کند و هر کدام که با dir
شروع شود آن دایرکتوری را فراموش خواهد کرد؛ به عنوان مثال:
.IP
.nf
\f[C]
rclone rc vfs/forget file=hello file2=goodbye dir=home/junk
\f[R]
.fi
.PP
این دستور یک پارامتر \[dq]fs\[dq] می‌گیرد.
اگر این پارامتر ارائه نشود و تنها یک VFS در حال استفاده باشد، از همان VFS
استفاده خواهد شد.
اگر بیش از یک VFS در حال استفاده باشد، پارامتر \[dq]fs\[dq] باید حتماً
ارائه شود..SS vfs/list: فهرست کردن VFSهای فعال.
.PP
این دستور VFSهای فعال را فهرست می‌کند.
.PP
این دستور فهرستی را تحت کلید \[dq]vfses\[dq] برمی‌گرداند که مقادیر آن، نام‌های VFS هستند و می‌توان آن‌ها را در پارامتر \[dq]fs\[dq] به سایر دستورهای VFS ارسال کرد.
.PP
\f[B]برای این فراخوانی نیازی به احراز هویت نیست.\f[R]
.SS vfs/poll-interval: دریافت وضعیت یا به‌روزرسانی مقدار گزینهٔ poll-interval.
.PP
بدون ارائهٔ هیچ پارامتری، این دستور وضعیت کنونی تنظیم poll-interval را بازمی‌گرداند.
.PP
هنگامی که پارامتر interval=duration تنظیم شود، مقدار poll-interval به‌روزرسانی شده و تابع بررسی دوره‌ای (polling) مطلع می‌شود.
تنظیم interval=0 گزینهٔ poll-interval را غیرفعال می‌کند.
.IP
.nf
\f[C]
rclone rc vfs/poll-interval interval=5m
\f[R]
.fi
.PP
می‌توان از پارامتر timeout=duration برای مشخص کردن مدت‌زمان انتظار جهت اِعمال مقدار جدید توسط تابع بررسی دوره‌ای کنونی استفاده کرد.
اگر timeout کمتر یا مساوی ۰ باشد (که مقدار پیش‌فرض است)، به مدت نامحدود منتظر می‌ماند.
.PP
مقدار جدید poll-interval تنها در صورتی فعال خواهد شد که مهلت زمانی (timeout) به پایان نرسد.
.PP
اگر poll-interval به‌روزرسانی شود یا موقتاً غیرفعال گردد، بسته به ریموتِ مورد استفاده ممکن است برخی تغییرات توسط تابع بررسی دوره‌ای دریافت نشوند.
.PP
این دستور یک پارامتر \[dq]fs\[dq] می‌پذیرد.
اگر این پارامتر ارائه نشود و تنها یک VFS در حال استفاده باشد، همان VFS استفاده خواهد شد.
اگر بیش از یک VFS در حال استفاده باشد، پارامتر \[dq]fs\[dq] باید ارائه شود.
.SS vfs/queue: اطلاعات صف برای یک VFS.
.PP
این دستور اطلاعات مربوط به صف بارگذاری (upload) را برای VFS انتخاب‌شده برمی‌گرداند.
.PP
این ویژگی تنها زمانی مفید است که \f[V]--vfs-cache-mode\f[R] > off باشد.
اگر آن را در زمانی فراخوانی کنید که \f[V]--vfs-cache-mode\f[R] برابر off است، نتیجه‌ای خالی برمی‌گرداند.
.IP
.nf
\f[C]
{
    \[dq]queue\[dq]: // an array of files queued for upload
    [
        {
            \[dq]name\[dq]:      \[dq]file\[dq],   // string: name (full path) of the file,
            \[dq]id\[dq]:        123,      // integer: id of this item in the queue,
            \[dq]size\[dq]:      79,       // integer: size of the file in bytes
            \[dq]expiry\[dq]:    1.5       // float: time until file is eligible for transfer, lowest goes first
            \[dq]tries\[dq]:     1,        // integer: number of times we have tried to upload
            \[dq]delay\[dq]:     5.0,      // float: seconds between upload attempts
            \[dq]uploading\[dq]: false,    // boolean: true if item is being uploaded
        },
   ],
}
\f[R]
.fi
.PP
زمان \f[V]expiry\f[R]، مدت‌زمان باقی‌مانده تا واجد شرایط شدن فایل برای بارگذاری برحسب ثانیه با ممیز شناور است.
این مقدار ممکن است منفی شود.
از آنجا که rclone در هر لحظه تنها به تعداد \f[V]--transfers\f[R] فایل را انتقال می‌دهد، تنها کمترین زمان‌های انقضا به تعداد \f[V]--transfers\f[R] دارای \f[V]uploading\f[R] با مقدار \f[V]true\f[R] خواهند بود.
بنابراین ممکن است فایل‌هایی با زمان انقضای منفی وجود داشته باشند که مقدار \f[V]uploading\f[R] برای آن‌ها \f[V]false\f[R] باشد.
.PP
این دستور یک پارامتر \[dq]fs\[dq] می‌پذیرد.
اگر این پارامتر ارائه نشود و تنها یک VFS در حال استفاده باشد، همان VFS استفاده خواهد شد.
اگر بیش از یک VFS در حال استفاده باشد، پارامتر \[dq]fs\[dq] باید ارائه شود.
.PP
\f[B]برای این فراخوانی نیازی به احراز هویت نیست.\f[R].SS vfs/queue-set-expiry: تنظیم زمان انقضا برای آیتم موجود در صف بارگذاری.
.PP
از این دستور برای تغییر زمان \f[V]expiry\f[R] (انقضا) برای یک آیتم در صف بارگذاری استفاده می‌شود.
پیش از استفاده از این فراخوانی، باید \f[V]id\f[R] آیتم را با استفاده از \f[V]vfs/queue\f[R] بخوانید.
.PP
سپس می‌توانید \f[V]expiry\f[R] را برحسب ثانیه‌های ممیز شناور از زمان حال برای هنگامی که آیتم واجد شرایط بارگذاری است تنظیم کنید.
اگر می‌خواهید آیتم در اسرع وقت بارگذاری شود، آن را روی یک عدد منفی بزرگ (مانند \-1000000000) تنظیم کنید.
اگر می‌خواهید بارگذاری آیتم برای مدت طولانی به تعویق بیفتد، آن را روی یک عدد مثبت بزرگ قرار دهید.
.PP
تنظیم \f[V]expiry\f[R] برای آیتمی که بارگذاری آن از قبل آغاز شده است هیچ اثری نخواهد داشت \- بارگذاری آیتم بدون تغییر ادامه می‌یابد.
.PP
اگر این دستور در حالتی که \f[V]--vfs-cache-mode\f[R] روی off است فراخوانی شود، یا اگر \f[V]id\f[R] ارائه‌شده یافت نشود، خطایی بازمی‌گرداند.
.PP
این دستور پارامترهای زیر را می‌پذیرد:
.IP \[bu] 2
\f[V]fs\f[R] \- انتخاب VFS در حال استفاده (اختیاری)
.IP \[bu] 2
\f[V]id\f[R] \- یک شناسه عددی بازگردانده‌شده از \f[V]vfs/queue\f[R]
.IP \[bu] 2
\f[V]expiry\f[R] \- زمان انقضای جدید به صورت ثانیه‌های ممیز شناور
.IP \[bu] 2
\f[V]relative\f[R] \- در صورت تعیین، زمان انقضا به صورت نسبی نسبت به انقضای فعلی در نظر گرفته می‌شود (اختیاری، بولی)
.PP
این دستور در صورت موفقیت یک نتیجه خالی و در غیر این صورت یک خطا بازمی‌گرداند.
.PP
این دستور پارامتر \[dq]fs\[dq] را می‌پذیرد.
اگر این پارامتر ارائه نشود و تنها یک VFS در حال استفاده باشد، همان VFS استفاده خواهد شد.
اگر بیش از یک VFS در حال استفاده باشد، ارائه پارامتر \[dq]fs\[dq] الزامی است.
.SS vfs/refresh: تازه‌سازی کش دایرکتوری.
.PP
این دستور دایرکتوری‌های مسیرهای مشخص‌شده را خوانده و حافظه موقت (کش) دایرکتوری را تازه می‌کند.
.PP
اگر هیچ مسیری ارسال نشود، دایرکتوری ریشه (root) را تازه‌سازی خواهد کرد.
.IP
.nf
\f[C]
rclone rc vfs/refresh
\f[R]
.fi
.PP
در غیر این صورت، دایرکتوری‌ها را به صورت dir=path ارسال کنید.
هر کلید پارامتری که با dir شروع شود، آن دایرکتوری را تازه‌سازی خواهد کرد؛ مانند:
.IP
.nf
\f[C]
rclone rc vfs/refresh dir=home/junk dir2=data/misc
\f[R]
.fi
.PP
اگر پارامتر recursive=true داده شود، کل درخت دایرکتوری تازه خواهد شد.
این تازه‌سازی در صورت فعال بودن، از --fast-list استفاده خواهد کرد.
.PP
این دستور پارامتر \[dq]fs\[dq] را می‌پذیرد.
اگر این پارامتر ارائه نشود و تنها یک VFS در حال استفاده باشد، همان VFS استفاده خواهد شد.
اگر بیش از یک VFS در حال استفاده باشد، ارائه پارامتر \[dq]fs\[dq] الزامی است.
.SS vfs/stats: آمار مربوط به یک VFS.
.PP
این دستور آمار مربوط به VFS انتخاب‌شده را بازمی‌گرداند.
.IP
.nf
\f[C]
{
    // Status of the disk cache - only present if --vfs-cache-mode > off
    \[dq]diskCache\[dq]: {
        \[dq]bytesUsed\[dq]: 0,
        \[dq]erroredFiles\[dq]: 0,
        \[dq]files\[dq]: 0,
        \[dq]hashType\[dq]: 1,
        \[dq]outOfSpace\[dq]: false,
        \[dq]path\[dq]: \[dq]/home/user/.cache/rclone/vfs/local/mnt/a\[dq],
        \[dq]pathMeta\[dq]: \[dq]/home/user/.cache/rclone/vfsMeta/local/mnt/a\[dq],
        \[dq]uploadsInProgress\[dq]: 0,
        \[dq]uploadsQueued\[dq]: 0
    },
    \[dq]fs\[dq]: \[dq]/mnt/a\[dq],
    \[dq]inUse\[dq]: 1,
    // Status of the in memory metadata cache
    \[dq]metadataCache\[dq]: {
        \[dq]dirs\[dq]: 1,
        \[dq]files\[dq]: 0
    },
    // Options as returned by options/get
    \[dq]opt\[dq]: {
        \[dq]CacheMaxAge\[dq]: 3600000000000,
        // ...
        \[dq]WriteWait\[dq]: 1000000000
    }
}
\f[R]
.fi
.PP
این دستور پارامتر \[dq]fs\[dq] را می‌پذیرد.
اگر این پارامتر ارائه نشود و تنها یک VFS در حال استفاده باشد، همان VFS استفاده خواهد شد.
اگر بیش از یک VFS در حال استفاده باشد، ارائه پارامتر \[dq]fs\[dq] الزامی است.
.PP
\f[B]برای این فراخوانی نیازی به احراز هویت نیست.\f[R].SS دسترسی به کنترل از راه دور از طریق HTTP
.PP
ابزار Rclone یک پروتکل ساده مبتنی بر HTTP را پیاده‌سازی می‌کند.
.PP
هر نقطه پایانی (endpoint) یک شیء JSON را دریافت کرده و یک شیء JSON یا یک خطا برمی‌گرداند.
اشیای JSON در اصل نگاشتی از نام‌های رشته‌ای به مقادیر هستند.
.PP
تمام فراخوانی‌ها باید با استفاده از POST انجام شوند.
.PP
اشیای ورودی را می‌توان با استفاده از پارامترهای URL، پارامترهای POST یا با ارائه \[dq]Content-Type: application/json\[dq] و یک قطعه داده JSON در بدنه درخواست فرستاد.
در ادامه مثال‌هایی از این موارد با استفاده از \f[V]curl\f[R] آورده شده است.
.PP
پاسخ به صورت یک قطعه داده JSON در بدنه پاسخ خواهد بود.
این خروجی به گونه‌ای قالب‌بندی شده است که برای انسان خوانا باشد.
.SS خطاهای بازگشتی
.PP
اگر خطایی رخ دهد، یک وضعیت خطای HTTP (مانند 500) وجود خواهد داشت و بدنه پاسخ حاوی یک شیء خطای کدگذاری‌شده با JSON خواهد بود، مانند:
.IP
.nf
\f[C]
{
    \[dq]error\[dq]: \[dq]Expecting string value for key \[rs]\[dq]remote\[rs]\[dq] (was float64)\[dq],
    \[dq]input\[dq]: {
        \[dq]fs\[dq]: \[dq]/tmp\[dq],
        \[dq]remote\[dq]: 3
    },
    \[dq]status\[dq]: 400,
    \[dq]path\[dq]: \[dq]operations/rmdir\[dq]
}
\f[R]
.fi
.PP
کلیدهای موجود در پاسخ خطا عبارتند از:
.IP \[bu] 2
error \- رشته خطا
.IP \[bu] 2
input \- پارامترهای ورودی فراخوانی
.IP \[bu] 2
status \- کد وضعیت HTTP
.IP \[bu] 2
path \- مسیر فراخوانی
.SS CORS
.PP
سرور پشتیبانی اولیه‌ای از CORS را پیاده‌سازی می‌کند و تمام مبداها (origins) را برای آن مجاز می‌داند.
پاسخ به درخواست پیش‌پرواز (preflight) از نوع OPTIONS سرآیندهای درخواستی \[dq]Access-Control-Request-Headers\[dq] را بازتاب خواهد داد.
.SS استفاده از POST تنها با پارامترهای URL
.IP
.nf
\f[C]
curl -X POST \[aq]http://localhost:5572/rc/noop?potato=1&sausage=2\[aq]
\f[R]
.fi
.PP
پاسخ
.IP
.nf
\f[C]
{
    \[dq]potato\[dq]: \[dq]1\[dq],
    \[dq]sausage\[dq]: \[dq]2\[dq]
}
\f[R]
.fi
.PP
یک پاسخ خطا به این صورت خواهد بود:
.IP
.nf
\f[C]
curl -X POST \[aq]http://localhost:5572/rc/error?potato=1&sausage=2\[aq]
\f[R]
.fi
.IP
.nf
\f[C]
{
    \[dq]error\[dq]: \[dq]arbitrary error on input map[potato:1 sausage:2]\[dq],
    \[dq]input\[dq]: {
        \[dq]potato\[dq]: \[dq]1\[dq],
        \[dq]sausage\[dq]: \[dq]2\[dq]
    }
}
\f[R]
.fi
.PP
توجه داشته باشید که curl خطایی را به پوسته بازنمی‌گرداند، مگر اینکه از گزینه \f[V]-f\f[R] استفاده کنید
.IP
.nf
\f[C]
$ curl -f -X POST \[aq]http://localhost:5572/rc/error?potato=1&sausage=2\[aq]
curl: (22) The requested URL returned error: 400 Bad Request
$ echo $?
22
\f[R]
.fi.SS استفاده از POST با یک فرم
.IP
.nf
\f[C]
curl --data \[dq]potato=1\[dq] --data \[dq]sausage=2\[dq] http://localhost:5572/rc/noop
\f[R]
.fi
.PP
پاسخ
.IP
.nf
\f[C]
{
    \[dq]potato\[dq]: \[dq]1\[dq],
    \[dq]sausage\[dq]: \[dq]2\[dq]
}
\f[R]
.fi
.PP
توجه داشته باشید که می‌توانید این موارد را با پارامترهای URL نیز ترکیب کنید؛ در این حالت، اولویت با پارامترهای POST خواهد بود.
.IP
.nf
\f[C]
curl --data \[dq]potato=1\[dq] --data \[dq]sausage=2\[dq] \[dq]http://localhost:5572/rc/noop?rutabaga=3&sausage=4\[dq]
\f[R]
.fi
.PP
پاسخ
.IP
.nf
\f[C]
{
    \[dq]potato\[dq]: \[dq]1\[dq],
    \[dq]rutabaga\[dq]: \[dq]3\[dq],
    \[dq]sausage\[dq]: \[dq]4\[dq]
}
\f[R]
.fi
.SS استفاده از POST با یک JSON blob
.IP
.nf
\f[C]
curl -H \[dq]Content-Type: application/json\[dq] -X POST -d \[aq]{\[dq]potato\[dq]:2,\[dq]sausage\[dq]:1}\[aq] http://localhost:5572/rc/noop
\f[R]
.fi
.PP
پاسخ
.IP
.nf
\f[C]
{
    \[dq]password\[dq]: \[dq]xyz\[dq],
    \[dq]username\[dq]: \[dq]xyz\[dq]
}
\f[R]
.fi
.PP
در صورت نیاز، این مورد را نیز می‌توان با پارامترهای URL ترکیب کرد.
اولویت با JSON blob خواهد بود.
.IP
.nf
\f[C]
curl -H \[dq]Content-Type: application/json\[dq] -X POST -d \[aq]{\[dq]potato\[dq]:2,\[dq]sausage\[dq]:1}\[aq] \[aq]http://localhost:5572/rc/noop?rutabaga=3&potato=4\[aq]
\f[R]
.fi
.IP
.nf
\f[C]
{
    \[dq]potato\[dq]: 2,
    \[dq]rutabaga\[dq]: \[dq]3\[dq],
    \[dq]sausage\[dq]: 1
}
\f[R]
.fi
.SS اشکال‌زدایی rclone با pprof
.PP
اگر از گزینه \f[V]--rc\f[R] استفاده کنید، ابزارهای تحلیل کارایی (profiling) زبان go نیز روی همان درگاه فعال خواهند شد.
.PP
نقاط پایانی پروفایل‌سازی (profiling endpoints) از همان قواعد احراز هویت بقیه بخش‌های rc پیروی می‌کنند: آن‌ها تنها در صورتی ارائه می‌شوند که احراز هویت پیکربندی شده باشد (\f[V]--rc-user\f[R]/\f[V]--rc-pass\f[R] یا \f[V]--rc-htpasswd\f[R]) یا گزینه \f[V]--rc-no-auth\f[R] به کار رفته باشد.
برای اشکال‌زدایی روی درگاه پیش‌فرض localhost، آسان‌ترین روش استفاده از \f[V]--rc --rc-no-auth\f[R] است (اما هشدار مربوط به استفاده از \f[V]--rc-no-auth\f[R] روی اتصالات غیر loopback را مطالعه کنید).
.PP
برای استفاده از این موارد، ابتدا go را نصب کنید (https://golang.org/doc/install)..SS "اشکال‌زدایی مصرف حافظه (Debugging memory use)"
.PP
برای تحلیل (profile) میزان مصرف حافظه rclone می‌توانید دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
go tool pprof -web http://localhost:5572/debug/pprof/heap
\f[R]
.fi
.PP
این دستور باید صفحه‌ای را در مرورگر شما باز کند که نشان می‌دهد چه بخش‌هایی چقدر حافظه مصرف می‌کنند.
.PP
همچنین می‌توانید از گزینهٔ \f[V]-text\f[R] برای ایجاد یک خلاصهٔ متنی استفاده کنید:
.IP
.nf
\f[C]
$ go tool pprof -text http://localhost:5572/debug/pprof/heap
Showing nodes accounting for 1537.03kB, 100% of 1537.03kB total
      flat  flat%   sum%        cum   cum%
 1024.03kB 66.62% 66.62%  1024.03kB 66.62%  github.com/rclone/rclone/vendor/golang.org/x/net/http2/hpack.addDecoderNode
     513kB 33.38%   100%      513kB 33.38%  net/http.newBufioWriterSize
         0     0%   100%  1024.03kB 66.62%  github.com/rclone/rclone/cmd/all.init
         0     0%   100%  1024.03kB 66.62%  github.com/rclone/rclone/cmd/serve.init
         0     0%   100%  1024.03kB 66.62%  github.com/rclone/rclone/cmd/serve/restic.init
         0     0%   100%  1024.03kB 66.62%  github.com/rclone/rclone/vendor/golang.org/x/net/http2.init
         0     0%   100%  1024.03kB 66.62%  github.com/rclone/rclone/vendor/golang.org/x/net/http2/hpack.init
         0     0%   100%  1024.03kB 66.62%  github.com/rclone/rclone/vendor/golang.org/x/net/http2/hpack.init.0
         0     0%   100%  1024.03kB 66.62%  main.init
         0     0%   100%      513kB 33.38%  net/http.(*conn).readRequest
         0     0%   100%      513kB 33.38%  net/http.(*conn).serve
         0     0%   100%  1024.03kB 66.62%  runtime.main
\f[R]
.fi
.SS "اشکال‌زدایی نشت گوروتین‌ها (Debugging go routine leaks)"
.PP
نشت حافظه اغلب به دلیل نشت goroutineها رخ می‌دهد؛ به این صورت که حافظه‌ای را که باید توسط بازیافت حافظه (garbage collection) پاک‌سازی می‌شد، زنده نگه می‌دارند.
.PP
مشاهدهٔ تمام goroutineهای فعال با استفاده از:
.IP
.nf
\f[C]
curl http://localhost:5572/debug/pprof/goroutine?debug=1
\f[R]
.fi
.PP
یا مراجعه به نشانی <http://localhost:5572/debug/pprof/goroutine?debug=1> در مرورگر وب خود.
.SS "دیگر پروفایل‌ها برای بررسی (Other profiles to look at)"
.PP
می‌توانید خلاصه‌ای از پروفایل‌های موجود را در نشانی <http://localhost:5572/debug/pprof> مشاهده کنید.
.PP
نحوهٔ استفاده از برخی از آن‌ها به شرح زیر است:
.IP \[bu] 2
حافظه: \f[V]go tool pprof http://localhost:5572/debug/pprof/heap\f[R]
.IP \[bu] 2
گوروتین‌ها:
\f[V]curl http://localhost:5572/debug/pprof/goroutine?debug=1\f[R]
.IP \[bu] 2
پروفایل ۳۰ ثانیه‌ای پردازنده (CPU):
\f[V]go tool pprof http://localhost:5572/debug/pprof/profile\f[R]
.IP \[bu] 2
ردگیری ۵ ثانیه‌ای اجرا (execution trace):
\f[V]wget http://localhost:5572/debug/pprof/trace?seconds=5\f[R]
.IP \[bu] 2
پروفایل مسدود شدن گوروتین‌ها (Goroutine blocking profile)
.RS 2
.IP \[bu] 2
ابتدا با دستور زیر فعال کنید:
\f[V]rclone rc debug/set-block-profile-rate rate=1\f[R] (مستندات)
.IP \[bu] 2
\f[V]go tool pprof http://localhost:5572/debug/pprof/block\f[R]
.RE
.IP \[bu] 2
بررسی رقابت بر سر mutexها (Contended mutexes):
.RS 2
.IP \[bu] 2
ابتدا با دستور زیر فعال کنید:
\f[V]rclone rc debug/set-mutex-profile-fraction rate=1\f[R] (مستندات)
.IP \[bu] 2
\f[V]go tool pprof http://localhost:5572/debug/pprof/mutex\f[R]
.RE
.PP
برای اطلاعات بیشتر دربارهٔ نحوهٔ استفاده از پروفایل‌سازی، مستندات net/http/pprof (https://golang.org/pkg/net/http/pprof) را مشاهده کنید و برای یک مرور کلی، به پست وبلاگ تیم Go دربارهٔ پروفایل‌سازی برنامه‌های go (https://blog.golang.org/profiling-go-programs) مراجعه فرمایید.
.PP
قلاب پروفایل‌سازی (profiling hook) هیچ بار اضافی (overhead) تحمیل نمی‌کند، مگر این‌که استفاده شود (https://stackoverflow.com/q/26545159/164234)..SH "نمای کلی سیستم‌های ذخیره‌سازی ابری"
.PP
هر سیستم ذخیره‌سازی ابری تفاوت‌های اندکی با دیگری دارد.
rclone تلاش می‌کند یک رابط یکپارچه برای آن‌ها فراهم کند، اما برخی
از تفاوت‌های بنیادین همچنان نمایان می‌شوند.
.SS "ویژگی‌ها"
.PP
در اینجا نمایی کلی از ویژگی‌های اصلی هر سیستم ذخیره‌سازی ابری آورده شده است.
.SS "هش (Hash)"
.PP
سیستم ذخیره‌سازی ابری از انواع مختلف هش برای اشیاء پشتیبانی می‌کند.
هش‌ها هنگام انتقال داده‌ها به عنوان بررسی یکپارچگی استفاده می‌شوند و می‌توانند
به طور خاص با پرچم \f[V]--checksum\f[R] در همگام‌سازی‌ها و در
دستور \f[V]check\f[R] به کار روند.
.PP
برای اعتبارسنجی جمع‌های کنترلی هنگام انتقال بین سیستم‌های ذخیره‌سازی ابری،
آن‌ها باید از یک نوع هش مشترک پشتیبانی کنند.
.SS "زمان ویرایش (ModTime)"
.PP
تقریباً تمامی سیستم‌های ذخیره‌سازی ابری نوعی برچسب زمان را روی اشیاء
ذخیره می‌کنند، اما در چندین مورد از آن‌ها، این مقدار چیزی نیست که برای
همگام‌سازی مناسب باشد.
برای مثال،
برخی پس‌اندازها (backends) تنها برچسب زمانی را می‌نویسند که نشان‌دهنده
زمان بارگذاری است.
برای این که زمان برای همگام‌سازی کاربردی باشد، سیستم باید قادر به ذخیره
زمان ویرایش شیء مبدأ باشد.
اگر این‌گونه نباشد، rclone به‌طور پیش‌فرض تنها اندازه فایل را بررسی می‌کند،
اگرچه می‌توان آن را پیکربندی کرد تا هش فایل را نیز بررسی کند (با
پرچم \f[V]--checksum\f[R]).
در حالت ایده‌آل، همچنین باید امکان تغییر برچسب زمان یک فایل موجود بدون
نیاز به بارگذاری مجدد آن وجود داشته باشد.
.PP
.TS
tab(@);
lw(19.4n) lw(50.6n).
T{
کلید
T}@T{
توضیحات
T}
_
T{
\f[V]-\f[R]
T}@T{
عدم پشتیبانی از ModTime \- زمان‌ها احتمالاً زمان بارگذاری هستند
T}
T{
\f[V]R\f[R]
T}@T{
پشتیبانی از ModTime در فایل‌ها، اما بدون امکان تغییر بدون بارگذاری مجدد
T}
T{
\f[V]R/W\f[R]
T}@T{
پشتیبانی کامل از خواندن و نوشتن ModTime روی فایل‌ها
T}
T{
\f[V]DR\f[R]
T}@T{
پشتیبانی از ModTime در فایل‌ها و دایرکتوری‌ها، اما بدون امکان تغییر
بدون بارگذاری مجدد
T}
T{
\f[V]DR/W\f[R]
T}@T{
پشتیبانی کامل از خواندن و نوشتن ModTime روی فایل‌ها و دایرکتوری‌ها
T}
.TE
.PP
سیستم‌های ذخیره‌سازی با علامت \f[V]-\f[R] در ستون ModTime بدین معنا هستند
که زمان ویرایش خوانده‌شده از اشیاء، زمان ویرایش فایل هنگام بارگذاری
نیست.
این زمان به احتمال زیاد زمان بارگذاری فایل است، یا شاید چیزی دیگر
(مانند زمان ثبت عکس در Google Photos).
.PP
سیستم‌های ذخیره‌سازی با علامت \f[V]R\f[R] (به معنای فقط‌خواندنی) در ستون
ModTime به این معنی هستند که زمان ویرایش اشیاء نگهداری شده و هنگام
بارگذاری اشیاء به‌روز می‌شود، اما از تغییر اختصاصی زمان ویرایش
(عملیات \f[V]SetModTime\f[R]) بدون بارگذاری مجدد پشتیبانی نمی‌کنند،
و احتمالاً حتی بدون حذف قبلی فایل موجود نیز امکان‌پذیر نیست.
برخی عملیات در rclone، مانند دستورهای \f[V]copy\f[R] و \f[V]sync\f[R]،
به‌طور خودکار پشتیبانی از \f[V]SetModTime\f[R] را بررسی کرده و در صورت
لزوم برای همگام نگه‌داشتن زمان‌های ویرایش، دوباره بارگذاری می‌کنند.
سایر دستورها بدون پشتیبانی از \f[V]SetModTime\f[R] کار نخواهند کرد؛ مثلاً
دستور \f[V]touch\f[R] روی یک فایل موجود با شکست مواجه می‌شود، و تغییرات
تنها روی زمان ویرایش فایل‌ها در یک \f[V]mount\f[R] بدون هیچ هشداری
نادیده گرفته می‌شوند.
.PP
سیستم‌های ذخیره‌سازی با \f[V]R/W\f[R] (به معنای خواندن/نوشتن) در ستون
ModTime، بدین معنا هستند که آن‌ها از عملیات‌های مختص زمان ویرایش نیز
پشتیبانی می‌کنند.
.PP
سیستم‌های ذخیره‌سازی با \f[V]D\f[R] در ستون ModTime بدین معنا هستند که
نمادهای پس از آن، افزون بر فایل‌ها شامل دایرکتوری‌ها نیز می‌شوند..SS حساس نبودن به بزرگی و کوچکی حروف (Case Insensitive)
.PP
اگر یک سیستم ذخیره‌سازی ابری به بزرگی و کوچکی حروف حساس باشد (case sensitive)، امکان داشتن دو فایل که تفاوت آن‌ها تنها در بزرگی و کوچکی حروف است وجود دارد؛ مانند
\f[V]file.txt\f[R] و \f[V]FILE.txt\f[R].
اگر یک سیستم ذخیره‌سازی ابری به بزرگی و کوچکی حروف حساس نباشد (case insensitive)، چنین چیزی امکان‌پذیر نیست.
.PP
این موضوع می‌تواند هنگام همگام‌سازی بین یک سیستم حساس به حروف و یک سیستم غیرحساس مشکلاتی ایجاد کند.
نشانه این مشکل آن است که مهم نیست چند بار همگام‌سازی را اجرا کنید، این فرایند هرگز به‌طور کامل به پایان نمی‌رسد.
.PP
سیستم‌فایل محلی و SFTP بسته به سیستم‌عامل ممکن است به بزرگی و کوچکی حروف حساس باشند یا نباشند.
.IP \[bu] 2
Windows \- معمولاً حساس نیست، اگرچه بزرگی و کوچکی حروف حفظ می‌شود
.IP \[bu] 2
OSX \- معمولاً حساس نیست، اگرچه امکان قالب‌بندی آن به صورت حساس به بزرگی و کوچکی حروف وجود دارد
.IP \[bu] 2
Linux \- معمولاً حساس است، اما سیستم‌فایل‌های غیرحساس به حروف نیز وجود دارند (مانند حافظه‌های USB با قالب‌بندی FAT)
.PP
در بیشتر مواقع این امر مشکلی ایجاد نمی‌کند، زیرا کاربران معمولاً حتی در سیستم‌های حساس نیز از نام‌گذاری فایل‌هایی که تفاوتشان تنها در بزرگی و کوچکی حروف است خودداری می‌کنند.
.SS فایل‌های تکراری (Duplicate files)
.PP
اگر یک سیستم ذخیره‌سازی ابری اجازه فایل‌های تکراری را بدهد، ممکن است دارای دو شیء با نام یکسان باشد.
.PP
این موضوع هنگام همگام‌سازی \f[V]rclone\f[R] را به شدت دچار سردرگمی می‌کند \- از دستور
\f[V]rclone dedupe\f[R] برای تغییر نام یا حذف موارد تکراری استفاده کنید.
.SS نام‌های فایل محدودشده (Restricted filenames)
.PP
برخی از سیستم‌های ذخیره‌سازی ابری ممکن است محدودیت‌هایی برای نویسه‌های مجاز در نام فایل‌ها یا دایرکتوری‌ها داشته باشند.
هنگامی که \f[V]rclone\f[R] در حین بارگذاری فایل چنین نامی را شناسایی کند، نویسه‌های محدودشده را به‌طور شفاف با نویسه‌های ظاهراً مشابه یونیکد (Unicode) جایگزین خواهد کرد.
برای مدیریت مجموعه‌های مختلف نویسه‌های محدودشده در backendهای مختلف، rclone از سازوکاری به نام encoding استفاده می‌کند.
.PP
این فرایند طوری طراحی شده است که تا حد امکان از ابهام در نام فایل‌ها جلوگیری کند و جابه‌جایی شفاف فایل‌ها را میان چندین سیستم ذخیره‌سازی ابری امکان‌پذیر سازد.
.PP
نامی که \f[V]rclone\f[R] به کاربر نشان می‌دهد یا در خروجی لاگ ثبت می‌کند، فقط شامل حداقل مجموعه‌ای از نویسه‌های جایگزین‌شده خواهد بود تا از قالب‌بندی درست اطمینان حاصل شود و لزوماً همان نام واقعی مورد استفاده در فضای ذخیره‌سازی ابری نیست.
.PP
این تبدیل هنگام بارگیری فایل یا تحلیل آرگومان‌های \f[V]rclone\f[R] به‌صورت معکوس عمل می‌کند.
برای مثال، هنگام بارگذاری فایلی با نام \f[V]my file?.txt\f[R] در Onedrive، این نام در کنسول به‌صورت \f[V]my file?.txt\f[R] نمایش داده می‌شود، اما با نام \f[V]my file？.txt\f[R] در Onedrive ذخیره می‌گردد (نویسه \f[V]?\f[R] با نویسه مشابه \f[V]？\f[R] موسوم به \[dq]fullwidth question mark\[dq] جایگزین می‌شود).
تبدیل معکوس امکان خواندن فایل \f[V]unusual/name.txt\f[R] را از Google Drive با ارسال نام
\f[V]unusual／name.txt\f[R] در خط فرمان فراهم می‌کند (نویسه \f[V]/\f[R] باید با نویسه مشابه \f[V]／\f[R] جایگزین شود).
.SS هشدارها (Caveats)
.PP
سامانه کدگذاری نام فایل در بیشتر موارد به خوبی کار می‌کند، دست‌کم در مواردی که نام فایل‌ها به زبان انگلیسی یا زبان‌های مشابه نوشته شده باشند.
شاید حتی متوجه عملکرد آن نشوید: به سادگی کار می‌کند.
با این حال، در برخی موارد ممکن است به بروز مشکلاتی منجر شود؛
برای نمونه هنگامی که نام فایل‌ها به زبان چینی یا ژاپنی نوشته شده باشد، که در آن‌ها همیشه از انواع تمام‌عرض (fullwidth) علائم نگارشی یونیکد استفاده می‌شود.
.PP
در Windows، نویسه‌های \f[V]:\f[R]، \f[V]*\f[R] و \f[V]?\f[R] نمونه‌هایی از نویسه‌های محدودشده هستند.
اگر از این نویسه‌ها در نام فایل‌ها روی یک ریموت پشتیبانی‌کننده استفاده شود، Rclone هنگام بارگیری در Windows به‌طور شفاف آن‌ها را به معادل‌های تمام‌عرض یونیکد
\f[V]＊\f[R]، \f[V]？\f[R] و \f[V]：\f[R] تبدیل کرده و در زمان بارگذاری دوباره آن‌ها را برمی‌گرداند.
بدین ترتیب، فایل‌هایی با نام‌های غیرمجاز در Windows همچنان می‌توانند ذخیره شوند.
.PP
با این حال، اگر فایل‌هایی در سیستم Windows خود داشته باشید که از ابتدا همین نویسه‌های یونیکد در نام آن‌ها وجود داشته باشد، مشمول همین فرایند تبدیل خواهند شد.
برای نمونه اگر فایلی را در سیستم‌فایل Windows خود با نام
\f[V]Test：1.jpg\f[R] ایجاد کنید (که در آن \f[V]：\f[R] نماد دونقطه تمام‌عرض یونیکد است) و از rclone برای بارگذاری آن در Google Drive استفاده کنید که از \f[V]:\f[R] معمولی (halfwidth question mark) پشتیبانی می‌کند، rclone نویسه تمام‌عرض \f[V]：\f[R] را با نویسه نیم‌عرض \f[V]:\f[R] جایگزین کرده و فایل را با نام
\f[V]Test:1.jpg\f[R] در Google Drive ذخیره خواهد کرد.
از آنجا که هم Windows و هم Google Drive اجازه نام‌گذاری \f[V]Test：1.jpg\f[R] را می‌دهند، احتمالاً در این حالت بهتر بود rclone نام فایل را دست‌نخورده باقی می‌گذاشت.
.PP
در وضعیت معکوس؛ اگر فایلی با نام
\f[V]Test:1.jpg\f[R] در Google Drive خود داشته باشید (مثلاً بارگذاری‌شده از یک سیستم Linux که در آن نویسه \f[V]:\f[R] در نام فایل‌ها معتبر است)،
سپس بعداً از rclone برای رونوشت این فایل به رایانه Windows خود استفاده کنید، متوجه خواهید شد که روی دیسک محلی شما نام آن به
\f[V]Test：1.jpg\f[R] تغییر می‌یابد.
نام اصلی فایل به دلیل وجود \f[V]:\f[R] در Windows مجاز نیست و بنابراین rclone نام آن را تغییر می‌دهد تا انجام رونوشت امکان‌پذیر شود.
همه این‌ها مطلوب است؛ با این حال، این موضوع می‌تواند به یک مشکل نیز بینجامد: اگر از قبل فایل \f[I]متفاوتی\f[R] با نام \f[V]Test：1.jpg\f[R] در Windows داشتید و سپس از rclone برای رونوشت در هر یک از دو جهت استفاده کنید،
آنگاه Rclone فایلی را که در اصل نامش در Google Drive برابر \f[V]Test:1.jpg\f[R] بود و فایلی را که در اصل نامش در Windows برابر \f[V]Test：1.jpg\f[R] بود به عنوان یک فایل یکسان در نظر می‌گیرد و محتویات یکی را با دیگری جایگزین می‌کند.
.PP
مدیریت صحیح تمام مواردی از این قبیل در تمامی شرایط عملاً غیرممکن است، اما با سفارشی‌سازی گزینه encoding و تغییر مجموعه نویسه‌هایی که rclone باید تبدیل کند، باید بتوانید پیکربندی مناسبی برای شرایط خاص خود ایجاد کنید.
همچنین به مثال (https://rclone.org/overview/#encoding-example-windows) در زیر نگاه کنید.
.PP
(از Windows به عنوان نمونه‌ای از سیستم‌فایل با نویسه‌های محدودشده زیاد، و از Google drive به عنوان سیستم ذخیره‌سازی با محدودیت‌های اندک استفاده شد.).SS نویسه‌های محدودشده پیش‌فرض (Default restricted characters)
.PP
جدول زیر نویسه‌هایی را نشان می‌دهد که به‌طور پیش‌فرض جایگزین می‌شوند.
.PP
هنگامی که یک نویسهٔ جایگزین در نام یک فایل یافت شود، این نویسه با
نویسهٔ \f[V]‛\f[R] گریزدهی می‌شود تا از نام‌های مبهم فایل جلوگیری شود.
(به‌عنوان مثال،
فایلی به نام \f[V]␀.txt\f[R] به‌صورت \f[V]‛␀.txt\f[R] نشان داده خواهد شد)
.PP
هر backend ذخیره‌سازی ابری می‌تواند از مجموعه متفاوتی از نویسه‌ها استفاده کند که
در مستندات مربوط به هر backend مشخص خواهد شد.
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
NUL
T}@T{
0x00
T}@T{
␀
T}
T{
SOH
T}@T{
0x01
T}@T{
␁
T}
T{
STX
T}@T{
0x02
T}@T{
␂
T}
T{
ETX
T}@T{
0x03
T}@T{
␃
T}
T{
EOT
T}@T{
0x04
T}@T{
␄
T}
T{
ENQ
T}@T{
0x05
T}@T{
␅
T}
T{
ACK
T}@T{
0x06
T}@T{
␆
T}
T{
BEL
T}@T{
0x07
T}@T{
␇
T}
T{
BS
T}@T{
0x08
T}@T{
␈
T}
T{
HT
T}@T{
0x09
T}@T{
␉
T}
T{
LF
T}@T{
0x0A
T}@T{
␊
T}
T{
VT
T}@T{
0x0B
T}@T{
␋
T}
T{
FF
T}@T{
0x0C
T}@T{
␌
T}
T{
CR
T}@T{
0x0D
T}@T{
␍
T}
T{
SO
T}@T{
0x0E
T}@T{
␎
T}
T{
SI
T}@T{
0x0F
T}@T{
␏
T}
T{
DLE
T}@T{
0x10
T}@T{
␐
T}
T{
DC1
T}@T{
0x11
T}@T{
␑
T}
T{
DC2
T}@T{
0x12
T}@T{
␒
T}
T{
DC3
T}@T{
0x13
T}@T{
␓
T}
T{
DC4
T}@T{
0x14
T}@T{
␔
T}
T{
NAK
T}@T{
0x15
T}@T{
␕
T}
T{
SYN
T}@T{
0x16
T}@T{
␖
T}
T{
ETB
T}@T{
0x17
T}@T{
␗
T}
T{
CAN
T}@T{
0x18
T}@T{
␘
T}
T{
EM
T}@T{
0x19
T}@T{
␙
T}
T{
SUB
T}@T{
0x1A
T}@T{
␚
T}
T{
ESC
T}@T{
0x1B
T}@T{
␛
T}
T{
FS
T}@T{
0x1C
T}@T{
␜
T}
T{
GS
T}@T{
0x1D
T}@T{
␝
T}
T{
RS
T}@T{
0x1E
T}@T{
␞
T}
T{
US
T}@T{
0x1F
T}@T{
␟
T}
T{
/
T}@T{
0x2F
T}@T{
／
T}
T{
DEL
T}@T{
0x7F
T}@T{
␡
T}.TE
.PP
کدگذاری پیش‌فرض همچنین این نام‌های فایل را کدگذاری خواهد کرد، چرا که در بسیاری از سامانه‌های ذخیره‌سازی ابری مشکل‌ساز هستند.
.PP
.TS
tab(@);
l c.
T{
نام فایل
T}@T{
جایگزین
T}
_
T{
\&.
T}@T{
．
T}
T{
\&..
T}@T{
．．
T}
.TE
.SS بایت‌های نامعتبر UTF-8 (Invalid UTF-8 bytes)
.PP
برخی از backendها تنها از دنباله‌ای از بایت‌های خوش‌ساخت UTF-8 به عنوان نام فایل یا دایرکتوری پشتیبانی می‌کنند.
.PP
در این حالت، تمام بایت‌های نامعتبر UTF-8 با یک نمایش نقل‌قول‌شده از مقدار بایت جایگزین می‌شوند تا امکان بارگذاری فایل روی چنین backendی فراهم شود.
برای نمونه، بایت نامعتبر \f[V]0xFE\f[R] به صورت \f[V]‛FE\f[R] کدگذاری خواهد شد.
.PP
یک منبع رایج بایت‌های نامعتبر UTF-8، سیستم‌های فایل محلی هستند که نام‌ها را در کدگذاری متفاوتی غیر از UTF-8 یا UTF-16 (مانند latin1) ذخیره می‌کنند.
برای جزئیات بیشتر به بخش نام‌های فایل محلی (https://rclone.org/local/#filenames) مراجعه کنید.
.SS گزینه کدگذاری (Encoding option)
.PP
بیشتر backendها دارای یک گزینه کدگذاری هستند که به عنوان پرچم \f[V]--backend-encoding\f[R] مشخص می‌شود (که در آن \f[V]backend\f[R] نام backend موردنظر است)، یا به صورت پارامتر پیکربندی \f[V]encoding\f[R] (برای مشاهده آن باید تنظیمات پیشرفته را در \f[V]rclone config\f[R] انتخاب کنید).
.PP
این گزینه دارای یک مقدار پیش‌فرض است که نویسه‌ها را به گونه‌ای کدگذاری و رمزگشایی می‌کند تا بیشترین تعداد نویسه‌ها حفظ شوند (بالا را ببینید).
.PP
با این حال، این حالت در برخی سناریوها ممکن است نادرست باشد؛ برای نمونه اگر در یک سیستم فایل ویندوز نویسه‌های تمام‌عرض یونیکد \f[V]＊\f[R]، \f[V]؟\f[R] یا \f[V]：\f[R] دارید و می‌خواهید روی ریموت نیز دقیقاً به صورت همین نویسه‌ها باقی بمانند و به نویسه‌های معمولی (نیم‌عرض) \f[V]*\f[R]، \f[V]?\f[R] و \f[V]:\f[R] تبدیل نشوند.
.PP
پرچم‌های \f[V]--backend-encoding\f[R] به شما امکان می‌دهند این رفتار را تغییر دهید.
می‌توانید کدگذاری را به طور کامل با \f[V]--backend-encoding Raw\f[R] غیرفعال کنید یا \f[V]encoding = Raw\f[R] را در فایل پیکربندی تنظیم نمایید.
.PP
گزینه Encoding فهرستی از کدگذاری‌ها را که با کاما از هم جدا شده‌اند، می‌پذیرد.
با ارسال یک مقدار نامعتبر به این پرچم می‌توانید فهرستی از تمام مقادیر ممکن را مشاهده کنید؛ مانند:
\f[V]--local-encoding \[dq]help\[dq]\f[R].
دستور \f[V]rclone help flags encoding\f[R] مقادیر پیش‌فرض backendها را نمایش می‌دهد.
.PP
.TS
tab(@);
lw(21.7n) lw(24.1n) lw(24.1n).
T{
کدگذاری
T}@T{
نویسه‌ها
T}@T{
کدگذاری‌شده به عنوان
T}
_
T{
Asterisk
T}@T{
\f[V]*\f[R]
T}@T{
\f[V]＊\f[R]
T}
T{
BackQuote
T}@T{
\f[V]\[ga]\f[R]
T}@T{
\f[V]｀\f[R]
T}
T{
BackSlash
T}@T{
\f[V]\[rs]\f[R]
T}@T{
\f[V]＼\f[R]
T}
T{
Colon
T}@T{
\f[V]:\f[R]
T}@T{
\f[V]：\f[R]
T}
T{
CrLf
T}@T{
CR 0x0D, LF 0x0A
T}@T{
\f[V]␍\f[R], \f[V]␊\f[R]
T}
T{
Ctl
T}@T{
همه نویسه‌های کنترلی 0x00-0x1F
T}@T{
\f[V]␀␁␂␃␄␅␆␇␈␉␊␋␌␍␎␏␐␑␒␓␔␕␖␗␘␙␚␛␜␝␞␟\f[R]
T}
T{
Del
T}@T{
DEL 0x7F
T}@T{
\f[V]␡\f[R]
T}
T{
Dollar
T}@T{
\f[V]$\f[R]
T}@T{
\f[V]＄\f[R]
T}
T{
Dot
T}@T{
\f[V].\f[R] یا \f[V]..\f[R] به عنوان کل رشته
T}@T{
\f[V]．\f[R], \f[V]．．\f[R]
T}
T{
DoubleQuote
T}@T{
\f[V]\[dq]\f[R]
T}@T{
\f[V]＂\f[R]
T}
T{
Exclamation
T}@T{
\f[V]!\f[R]
T}@T{
\f[V]！\f[R]
T}
T{
Hash
T}@T{
\f[V]#\f[R]
T}@T{
\f[V]＃\f[R]
T}
T{
InvalidUtf8
T}@T{
یک نویسه نامعتبر UTF-8 (مانند latin1)
T}@T{
\f[V]\f[R]
T}
T{
LeftCrLfHtVt
T}@T{
CR 0x0D, LF 0x0A, HT 0x09, VT 0x0B در سمت چپ رشته
T}@T{
\f[V]␍\f[R], \f[V]␊\f[R], \f[V]␉\f[R], \f[V]␋\f[R]
T}
T{
LeftPeriod
T}@T{
\f[V].\f[R] در سمت چپ رشته
T}@T{
\f[V].\f[R]
T}
T{
LeftSpace
T}@T{
SPACE در سمت چپ رشته
T}@T{
\f[V]␠\f[R]
T}
T{
LeftTilde
T}@T{
\f[V]\[ti]\f[R] در سمت چپ رشته
T}@T{
\f[V]～\f[R]
T}
T{
LtGt
T}@T{
\f[V]<\f[R], \f[V]>\f[R]
T}@T{
\f[V]＜\f[R], \f[V]＞\f[R]
T}
T{
None ¹
T}@T{
NUL 0x00
T}@T{
␀
T}
T{
Percent
T}@T{
\f[V]%\f[R]
T}@T{
\f[V]％\f[R]
T}
T{
Pipe
T}@T{
|
T}@T{
\f[V]｜\f[R]
T}
T{
Question
T}@T{
\f[V]?\f[R]
T}@T{
\f[V]؟\f[R]
T}
T{
RightCrLfHtVt
T}@T{
CR 0x0D, LF 0x0A, HT 0x09, VT 0x0B در سمت راست رشته
T}@T{
\f[V]␍\f[R], \f[V]␊\f[R], \f[V]␉\f[R], \f[V]␋\f[R]
T}
T{
RightPeriod
T}@T{
\f[V].\f[R] در سمت راست رشته
T}@T{
\f[V].\f[R]
T}
T{
RightSpace
T}@T{
SPACE در سمت راست رشته
T}@T{
\f[V]␠\f[R]
T}
T{
Semicolon
T}@T{
\f[V];\f[R]
T}@T{
\f[V]；\f[R]
T}
T{
SingleQuote
T}@T{
\f[V]\[aq]\f[R]
T}@T{
\f[V]＇\f[R]
T}
T{
Slash
T}@T{
\f[V]/\f[R]
T}@T{
\f[V]／\f[R]
T}
T{
SquareBracket
T}@T{
\f[V][\f[R], \f[V]]\f[R]
T}@T{
\f[V]［\f[R], \f[V]］\f[R]
T}
.TE.TE
.PP
¹ کدگذاری از NUL 0x00 به ␀ همواره به‌صورت ضمنی انجام می‌شود، مگر در هنگام استفاده از Raw.
پیش‌تر در مستندات به‌اشتباه به عنوان غیرفعال‌کنندهٔ کدگذاری ثبت شده بود، و برای
حفظ سازگاری عقبرو، رفتار آن تغییر نکرده است.
.SS مثال کدگذاری: FTP
.PP
برای ارائه یک مثال مشخص، کدگذاری پیش‌فرض بک‌اند FTP بدین صورت است:
.IP
.nf
\f[C]
--ftp-encoding \[dq]Slash,Del,Ctl,RightSpace,Dot\[dq]
\f[R]
.fi
.PP
با این حال، فرض کنید سرور FTP روی Windows اجرا می‌شود و
نمی‌تواند هیچ‌یک از نویسه‌های نامعتبر Windows را در نام فایل‌ها داشته باشد.
شما در حال پشتیبان‌گیری از سرورهای Linux روی این سرور FTP هستید که این
نویسه‌ها را در نام فایل‌های خود دارند.
بنابراین باید مجموعهٔ Windows را که عبارت است از:
.IP
.nf
\f[C]
Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Ctl,RightSpace,RightPeriod,InvalidUtf8,Dot
\f[R]
.fi
.PP
به گزینه‌های موجود اضافه کنید، که نتیجه به صورت زیر خواهد بود:
.IP
.nf
\f[C]
Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Ctl,RightSpace,RightPeriod,InvalidUtf8,Dot,Del,RightSpace
\f[R]
.fi
.PP
این مورد را می‌توان با استفاده از پرچم \f[V]--ftp-encoding\f[R] یا با استفاده
از پارامتر \f[V]encoding\f[R] در فایل پیکربندی مشخص کرد.
.SS مثال کدگذاری: Windows
.PP
به عنوان مثالی دیگر، یک سیستم Windows را در نظر بگیرید که در آن فایلی با
نام \f[V]Test：1.jpg\f[R] وجود دارد، که در آن \f[V]：\f[R] نماد دونقطهٔ تمام‌پهنای (fullwidth) یونیکد است.
هنگام استفاده از rclone برای کپی کردن این فایل به یک ریموت که از \f[V]:\f[R]،
دونقطهٔ معمولی (halfwidth) پشتیبانی می‌کند (مانند Google Drive)، متوجه
خواهید شد که نام فایل به \f[V]Test:1.jpg\f[R] تغییر می‌یابد.
.PP
برای جلوگیری از این امر، می‌توانید مجموعه نویسه‌هایی را که rclone باید
برای فایل‌سیستم محلی تبدیل کند، با استفاده از آرگومان خط فرمان
\f[V]--local-encoding\f[R] تغییر دهید.
رفتار پیش‌فرض rclone در Windows معادل است با:
.IP
.nf
\f[C]
--local-encoding \[dq]Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Ctl,RightSpace,RightPeriod,InvalidUtf8,Dot\[dq]
\f[R]
.fi
.PP
اگر می‌خواهید از نویسه‌های تمام‌پهنای \f[V]：\f[R]، \f[V]＊\f[R] و
\f[V]？\f[R] در نام فایل‌های خود استفاده کنید بدون اینکه rclone هنگام
بارگذاری در یک ریموت آن‌ها را تغییر دهد، همان مقدار پیش‌فرض را مشخص کنید
اما بدون \f[V]Colon,Question,Asterisk\f[R]:
.IP
.nf
\f[C]
--local-encoding \[dq]Slash,LtGt,DoubleQuote,Pipe,BackSlash,Ctl,RightSpace,RightPeriod,InvalidUtf8,Dot\[dq]
\f[R]
.fi
.PP
همچنین، می‌توانید تبدیل هرگونه نویسه‌ای را با
\f[V]--local-encoding Raw\f[R] غیرفعال کنید.
.PP
به جای استفاده از آرگومان خط فرمان \f[V]--local-encoding\f[R]،
می‌توانید آن را به عنوان متغیر محیطی
(https://rclone.org/docs/#environment-variables)
\f[V]RCLONE_LOCAL_ENCODING\f[R] مقداردهی کنید، یا
یک ریموت از نوع \f[V]local\f[R] را در پیکربندی خود
تنظیم (https://rclone.org/docs/#configure) کرده، و گزینهٔ \f[V]encoding\f[R] را
در آنجا مشخص نمایید.
.PP
خطر انجام این کار در این است که اگر نام فایلی با نویسه‌های معمولی
(halfwidth) شامل \f[V]:\f[R]، \f[V]*\f[R] و \f[V]?\f[R] در فضای ابری خود داشته
باشید و تلاش کنید آن را روی فایل‌سیستم Windows خود دریافت نمایید، این
عملیات با خطا مواجه خواهد شد.
این نویسه‌ها در نام فایل‌های ویندوز مجاز نیستند، و شما به rclone
اعلام کرده‌اید که برای دور زدن این مشکل، آن‌ها را به گونه‌های مجاز
تمام‌پهنا (fullwidth) تبدیل نکند..SS نوع MIME (MIME Type)
.PP
انواع MIME (که با عنوان media types نیز شناخته می‌شوند) انواع اسناد را با استفاده از یک رده‌بندی متنی ساده دسته‌بندی می‌کنند، مانند
\f[V]text/html\f[R] یا \f[V]application/pdf\f[R].
.PP
برخی سیستم‌های ذخیره‌سازی ابری از خواندن (\f[V]R\f[R]) نوع MIME اشیاء و برخی از نوشتن (\f[V]W\f[R]) نوع MIME اشیاء پشتیبانی می‌کنند.
.PP
اگر فایل‌ها را مستقیماً از سیستم ذخیره‌سازی از طریق HTTP ارائه می‌دهید، نوع MIME می‌تواند حائز اهمیت باشد.
.PP
اگر در حال رونوشت از یک remote با پشتیبانی از خواندن (\f[V]R\f[R]) به یک remote با پشتیبانی از نوشتن (\f[V]W\f[R]) باشید، rclone انواع MIME را حفظ خواهد کرد.
در غیر این صورت، این موارد از روی پسوند فایل حدس زده می‌شوند، یا ممکن است خود remote نوع MIME را اختصاص دهد.
.SS متادیتا (Metadata)
.PP
Backendها ممکن است از خواندن یا نوشتن متادیتا پشتیبانی کنند یا نکنند.
آن‌ها ممکن است از خواندن و نوشتن متادیتای سیستم (متادیتای درونی آن backend) و/یا متادیتای کاربر (متادیتای عمومی) پشتیبانی کنند.
.PP
سطوح پشتیبانی از متادیتا عبارتند از:
.PP
.TS
tab(@);
lw(19.4n) lw(50.6n).
T{
کلید
T}@T{
توضیحات
T}
_
T{
\f[V]R\f[R]
T}@T{
فقط خواندن متادیتای سیستم، تنها برای فایل‌ها
T}
T{
\f[V]RW\f[R]
T}@T{
خواندن و نوشتن متادیتای سیستم، تنها برای فایل‌ها
T}
T{
\f[V]RWU\f[R]
T}@T{
خواندن و نوشتن متادیتای سیستم و خواندن و نوشتن متادیتای کاربر، تنها برای فایل‌ها
T}
T{
\f[V]DR\f[R]
T}@T{
فقط خواندن متادیتای سیستم برای فایل‌ها و دایرکتوری‌ها
T}
T{
\f[V]DRW\f[R]
T}@T{
خواندن و نوشتن متادیتای سیستم برای فایل‌ها و دایرکتوری‌ها
T}
T{
\f[V]DRWU\f[R]
T}@T{
خواندن و نوشتن متادیتای سیستم و خواندن و نوشتن متادیتای کاربر برای فایل‌ها و دایرکتوری‌ها
T}
.TE
.PP
برای اطلاعات بیشتر مستندات متادیتا را در <https://rclone.org/docs/#metadata> ببینید.
.SS ویژگی‌های اختیاری (Optional Features)
.PP
تمام remoteهای rclone از یک مجموعه دستورات پایه پشتیبانی می‌کنند.
سایر قابلیت‌ها به ویژگی‌های خاص هر backend وابسته هستند.
.SS پاک‌سازی کامل (Purge)
.PP
این قابلیت یک دایرکتوری را سریع‌تر از حذف تمامی فایل‌های درون آن دایرکتوری پاک می‌کند.
.SS رونوشت (Copy)
.PP
هنگام رونوشت برداشتن از یک شیء به همان remote و از همان remote استفاده می‌شود.
این ویژگی به عنوان رونوشت سمت سرور (server-side copy) شناخته می‌شود تا بتوانید یک فایل را بدون بارگیری و بارگذاری مجدد آن رونوشت‌برداری کنید.
این قابلیت در صورتی که از \f[V]rclone copy\f[R] یا \f[V]rclone move\f[R] استفاده کنید و remote مستقیماً از \f[V]Move\f[R] پشتیبانی نکند، استفاده می‌شود.
.PP
اگر سرور مستقیماً از \f[V]Copy\f[R] پشتیبانی نکند، برای عملیات رونوشت، فایل ابتدا بارگیری شده و سپس مجدداً بارگذاری می‌شود..SS Move
.PP
هنگام انتقال/تغییر نام یک شیء روی همان ریموت استفاده می‌شود.
این عمل به عنوان انتقال سمت سرور (server-side move) یک فایل شناخته می‌شود.
در صورت عدم پشتیبانی سرور از \f[V]DirMove\f[R]، این قابلیت در \f[V]rclone move\f[R] استفاده می‌شود.
.PP
اگر سرور قادر به انجام \f[V]Move\f[R] نباشد، rclone آن را با \f[V]Copy\f[R] و سپس حذف شبیه‌سازی می‌کند.
اگر سرور از \f[V]Copy\f[R] نیز پشتیبانی نکند، rclone فایل را دانلود کرده و دوباره آپلود می‌کند.
.SS DirMove
.PP
این قابلیت برای پیاده‌سازی \f[V]rclone move\f[R] جهت انتقال یک دایرکتوری در صورت امکان استفاده می‌شود.
اگر امکان‌پذیر نباشد، برای هر فایل از \f[V]Move\f[R] استفاده می‌کند (که در صورت لزوم به \f[V]Copy\f[R] و سپس دانلود و آپلود تنزل می‌یابد \- بخش \f[V]Move\f[R] را ببینید).
.SS CleanUp
.PP
برای خالی کردن سطل زباله در یک ریموت توسط \f[V]rclone cleanup\f[R] استفاده می‌شود.
.PP
اگر سرور قادر به انجام \f[V]CleanUp\f[R] نباشد، \f[V]rclone cleanup\f[R] خطایی را برمی‌گرداند.
.PP
‡‡ توجه داشته باشید که اگرچه Box این قابلیت را پیاده‌سازی کرده است، اما باید تک‌تک فایل‌ها را جداگانه حذف کند، بنابراین از خالی کردن سطل زباله از طریق رابط وب (WebUI) کندتر خواهد بود.
.SS ListR
.PP
ریموت از فهرست‌بندی بازگشتی برای فهرست کردن سریع تمام محتویات زیر یک دایرکتوری پشتیبانی می‌کند.
این قابلیت امکان عملکرد پرچم \f[V]--fast-list\f[R] را فراهم می‌سازد.
برای جزئیات بیشتر مستندات rclone (<https://rclone.org/docs/#fast-list>) را ببینید.
.SS StreamUpload
.PP
برخی ریموت‌ها اجازه می‌دهند فایل‌ها بدون دانستن قبلی حجم فایل آپلود شوند.
این قابلیت اجازه می‌دهد برخی عملیات بدون ذخیره موقت (spooling) فایل روی دیسک محلی کار کنند، مانند
\f[V]rclone rcat\f[R].
.SS MultithreadUpload
.PP
برخی ریموت‌ها اجازه می‌دهند داده‌های انتقالی به صورت قطعات موازی به ریموت ارسال شوند.
اگر پشتیبانی شود، rclone از کپی چندریسمانی (multi-thread) برای انتقال بسیار سریع‌تر فایل‌ها استفاده خواهد کرد.
.SS LinkSharing
.PP
مجوزهای لازم را روی فایل یا پوشه تنظیم کرده و پیوندی را چاپ می‌کند که به دیگران اجازه دسترسی به آن‌ها را می‌دهد، حتی اگر حسابی در آن ارائه‌دهنده ابری خاص نداشته باشند.
.SS About
.PP
دستور \f[V]about\f[R] در rclone اطلاعات سهمیه (quota) یک ریموت را چاپ می‌کند.
خروجی معمول شامل بایت‌های استفاده‌شده، آزاد، سهمیه و موارد موجود در سطل زباله است.
.PP
اگر ریموتی فاقد قابلیت about باشد، \f[V]rclone about remote:\f[R] خطایی برمی‌گرداند.
.PP
پشت‌بندهای فاقد قابلیت about نمی‌توانند فضای آزاد را برای rclone mount تعیین کنند، یا از سیاست \f[V]mfs\f[R] (بیشترین فضای خالی) به عنوان عضوی از یک ریموت union در rclone استفاده کنند.
.PP
دستور rclone about (<https://rclone.org/commands/rclone_about>) را ببینید.
.SS EmptyDir
.PP
ریموت از دایرکتوری‌های خالی پشتیبانی می‌کند.
برای جزئیات به بخش محدودیت‌ها (<https://rclone.org/bugs/#limitations>) مراجعه کنید.
اکثر ریموت‌های مبتنی بر شیء/باکت (Object/Bucket) از این قابلیت پشتیبانی نمی‌کنند.
.SH "سطوح (TIERS)"
.PP
پشت‌بندهای rclone به سطوحی تقسیم شده‌اند تا کاربران دیدی کلی از پایداری هر پشت‌بند داشته باشند.
.PP
.TS
tab(@);
l l l.
T{
سطح
T}@T{
برچسب
T}@T{
مفهوم مورد نظر
T}
_
T{
T}@T{
Core
T}@T{
مناسب محیط تولید، درجه یک
T}
T{
T}@T{
Stable
T}@T{
با پشتیبانی خوب، کاستی‌های جزئی
T}
T{
T}@T{
Supported
T}@T{
مناسب برای بسیاری از کاربردها؛ با هشدارهای شناخته‌شده
T}
T{
T}@T{
Experimental
T}@T{
با احتیاط استفاده شود؛ انتظار کاستی‌ها/تغییرات وجود دارد
T}
T{
T}@T{
Deprecated
T}@T{
دیگر نگهداری یا پشتیبانی نمی‌شود
T}
.TE.SS نمای کلی
.PP
در اینجا خلاصه‌ای از تمام backendها آورده شده است:
.SS امتیازدهی
.PP
نحوه امتیازدهی به backendها به این صورت است.
.SS ویژگی‌ها
.PP
این‌ها ویژگی‌های اختیاری مفیدی هستند که یک backend باید تقریباً به ترتیب اهمیت داشته باشد.
هر یک از این موارد یک امتیاز برای ستون ویژگی‌ها (Features) به همراه دارد.
.IP \[bu] 2
F1: هش‌ها (Hash(es))
.IP \[bu] 2
F2: زمان تغییر (Modtime)
.IP \[bu] 2
F3: بارگذاری جریانی (Stream upload)
.IP \[bu] 2
F4: رونوشت/انتقال (Copy/Move)
.IP \[bu] 2
F5: انتقال پوشه (DirMove)
.PD 0
.P
.PD
.IP \[bu] 2
F6: متاداده (Metadata)
.IP \[bu] 2
F7: بارگذاری چندبخشی (MultipartUpload)
.SS سطح‌بندی
.PP
سطح پس از تعیین این مشخصه‌ها مشخص می‌شود.
در سطح‌بندی مقداری صلاحدید مجاز است، زیرا برخی از این مشخصه‌ها مهم‌تر از سایرین هستند.
.PP
.TS
tab(@);
lw(5.5n) lw(9.2n) lw(11.1n) lw(13.8n) lw(16.6n) lw(13.8n).
T{
مشخصه
T}@T{
T1: Core
T}@T{
T2: Stable
T}@T{
T3: Supported
T}@T{
T4: Experimental
T}@T{
T5: Incubator
T}
_
T{
نگه‌دارنده‌ها
T}@T{
>=2
T}@T{
>=1
T}@T{
>=1
T}@T{
>=0
T}@T{
>=0
T}
T{
منبع API
T}@T{
رسمی
T}@T{
رسمی
T}@T{
هرکدام
T}@T{
هرکدام
T}@T{
هرکدام
T}
T{
ویژگی‌ها (F1-F7)
T}@T{
>=5/7
T}@T{
>=4/7
T}@T{
>=3/7
T}@T{
>=2/7
T}@T{
N/A
T}
T{
آزمون‌های یکپارچه‌سازی
T}@T{
همه سبز
T}@T{
همه سبز
T}@T{
تقریباً همه سبز
T}@T{
برخی ناپایدار (Flaky)
T}@T{
N/A
T}
T{
مدیریت خطا
T}@T{
Pacer
T}@T{
Pacer
T}@T{
تلاش مجدد
T}@T{
تلاش مجدد
T}@T{
N/A
T}
T{
یکپارچگی داده
T}@T{
هش‌ها، alt، modtime
T}@T{
هش‌ها یا alt
T}@T{
هش یا modtime
T}@T{
Best-effort
T}@T{
N/A
T}
T{
معیار عملکرد
T}@T{
بنچ‌مارک در حد 2x S3
T}@T{
مستندات بنچ‌مارک
T}@T{
شواهد تجربی کافیست
T}@T{
اختیاری
T}@T{
N/A
T}
T{
میزان پذیرش
T}@T{
استفاده گسترده
T}@T{
استفاده زیاد
T}@T{
کمی استفاده
T}@T{
N/A
T}@T{
N/A
T}
T{
جامعیت مستندات
T}@T{
کامل
T}@T{
کامل
T}@T{
پایه‌ای
T}@T{
حداقل
T}@T{
حداقل
T}
T{
امنیت
T}@T{
اصل حداقل دسترسی
T}@T{
محدوده‌های منطقی
T}@T{
احراز هویت Basic
T}@T{
کار می‌کند
T}@T{
کار می‌کند
T}
.TE.SH "پرچم‌های سراسری (GLOBAL FLAGS)"
.PP
این بخش گزینه‌ها و پرچم‌های سراسری را که در تمام دستورهای rclone در دسترس هستند، به تفکیک گروه شرح می‌دهد.
.SS "کپی (Copy)"
.PP
پرچم‌ها برای هر عملیاتی که می‌تواند یک فایل را کپی کند.
.IP
.nf
\f[C]
      --check-first                                 انجام تمام بررسی‌ها پیش از آغاز انتقال‌ها
  -c, --checksum                                    بررسی تغییرات با اندازه و چکسام (در صورت وجود، یا بازگشت به بررسی اندازه تنها)
      --compare-dest stringArray                    شامل کردن مسیرهای سمت سرور اضافی هنگام مقایسه
      --copy-dest stringArray                       متضمن --compare-dest است اما فایل‌ها را نیز از مسیرها به مقصد کپی می‌کند
      --cutoff-mode HARD|SOFT|CAUTIOUS              حالت توقف انتقال‌ها پس از رسیدن به حد مجاز انتقال: HARD|SOFT|CAUTIOUS (پیش‌فرض HARD)
      --ignore-case-sync                            نادیده گرفتن بزرگی و کوچکی حروف هنگام همگام‌سازی
      --ignore-checksum                             صرف‌نظر کردن از بررسی چکسام پس از کپی
      --ignore-existing                             صرف‌نظر کردن از تمام فایل‌هایی که در مقصد وجود دارند
      --ignore-size                                 نادیده گرفتن اندازه هنگام صرف‌نظر کردن؛ استفاده از modtime یا چکسام
  -I, --ignore-times                                صرف‌نظر نکردن از مواردی که اندازه و زمان یکسان دارند - انتقال تمام موارد بدون قید و شرط
      --immutable                                   عدم تغییر فایل‌ها؛ شکست عملیات در صورت تغییر یافتن فایل‌های موجود
      --inplace                                     دانلود مستقیم در فایل مقصد به جای دانلود اتمیک در فایل موقت و تغییر نام آن
  -l, --links                                       تبدیل پیوندهای نمادین به/از فایل‌های عادی با پسوند \[aq].rclonelink\[aq]
      --max-backlog int                             حداکثر تعداد اشیاء در صف انتظارهای همگام‌سازی یا بررسی (پیش‌فرض 10000)
      --max-duration Duration                       حداکثر مدت زمانی که rclone داده‌ها را انتقال می‌دهد (پیش‌فرض 0s)
      --max-transfer SizeSuffix                     حداکثر حجم داده برای انتقال (پیش‌فرض غیرفعال)
  -M, --metadata                                    در صورت تنظیم، حفظ فراداده هنگام کپی اشیاء
      --modify-window Duration                      حداکثر اختلاف زمانی برای یکسان در نظر گرفتن فایل‌ها (پیش‌فرض 1ns)
      --multi-thread-chunk-size SizeSuffix          اندازه تکه‌ها برای دانلودها / آپلودهای چندرشته‌ای، در صورت عدم تعیین توسط سیستم‌فایل (پیش‌فرض 64Mi)
      --multi-thread-cutoff SizeSuffix              استفاده از دانلود چندرشته‌ای برای فایل‌های بزرگ‌تر از این اندازه (پیش‌فرض 256Mi)
      --multi-thread-streams int                    تعداد رشته‌های مورد استفاده برای دانلود چندرشته‌ای (پیش‌فرض 4)
      --multi-thread-write-buffer-size SizeSuffix   اندازه بافر حافظه برای نوشتن در حالت چندرشته‌ای (پیش‌فرض 128Ki)
      --name-transform stringArray                  تبدیل مسیرها در طول فرآیند کپی
      --no-check-dest                               عدم بررسی مقصد؛ کپی کردن در هر صورت
      --no-traverse                                 عدم پیمایش سیستم‌فایل مقصد هنگام کپی
      --no-update-dir-modtime                       به‌روزرسانی نکردن زمان تغییر دایرکتوری‌ها
      --no-update-modtime                           به‌روزرسانی نکردن زمان تغییر مقصد در صورت یکسان بودن فایل‌ها
      --order-by string                             دستورالعمل‌ها برای نحوه اولویت‌بندی انتقال‌ها، مثلاً \[aq]size,descending\[aq]
      --partial-suffix string                       افزودن پسوند partial-suffix به نام فایل موقت هنگامی که --inplace استفاده نشده است (پیش‌فرض \[dq].partial\[dq])
      --refresh-times                               تازه‌سازی زمان تغییر (modtime) فایل‌های دوردست (ریموت)
      --server-side-across-configs                  اجازه به عملیات‌های سمت سرور (مانند کپی) برای کار بین پیکربندی‌های مختلف
      --size-only                                   صرف‌نظر کردن تنها بر اساس اندازه، نه زمان تغییر یا چکسام
      --streaming-upload-cutoff SizeSuffix          حد آستانه برای جابه‌جایی به آپلود تکه‌ای در صورت نامشخص بودن اندازه فایل؛ آغاز آپلود پس از رسیدن به این حد یا پایان فایل (پیش‌فرض 100Ki)
  -u, --update                                      صرف‌نظر کردن از فایل‌هایی که در مقصد جدیدتر هستند
\f[R]
.fi
.SS "همگام‌سازی (Sync)"
.PP
پرچم‌های مورد استفاده برای دستورهای همگام‌سازی (sync).
.IP
.nf
\f[C]
      --backup-dir string               تهیه نسخه پشتیبان در ساختار سلسله‌مراتبی بر پایه DIR
      --delete-after                    هنگام همگام‌سازی، حذف فایل‌ها در مقصد پس از انتقال (پیش‌فرض)
      --delete-before                   هنگام همگام‌سازی، حذف فایل‌ها در مقصد پیش از آغاز انتقال
      --delete-during                   هنگام همگام‌سازی، حذف فایل‌ها در حین انتقال
      --fix-case                        تغییر نام اجباری در مقصدِ غیرحساس به حروف کوچک و بزرگ برای مطابقت با مبدأ
      --ignore-errors                   حذف فایل‌ها حتی در صورت وجود خطاهای ورودی/خروجی (I/O)
      --list-cutoff int                 مرتب‌سازی فهرست‌های دایرکتوری روی دیسک فراتر از این آستانه جهت صرفه‌جویی در حافظه (پیش‌فرض 1000000)
      --max-delete int                  هنگام همگام‌سازی، محدود کردن تعداد موارد حذفی (پیش‌فرض \-1)
      --max-delete-size SizeSuffix      هنگام همگام‌سازی، محدود کردن مجموع حجم موارد حذفی (پیش‌فرض غیرفعال)
      --suffix string                   پسوند برای افزودن به فایل‌های تغییریافته
      --suffix-keep-extension           حفظ پسوند اصلی فایل هنگام استفاده از --suffix
      --track-renames                   هنگام همگام‌سازی، ردگیری تغییر نام فایل‌ها و انجام انتقال سمت سرور در صورت امکان
      --track-renames-strategy string   راهبردهای مورد استفاده هنگام همگام‌سازی با track-renames: hash|modtime|leaf (پیش‌فرض \[dq]hash\[dq])
\f[R]
.fi
.SS "مهم (Important)"
.PP
پرچم‌های مهم و کاربردی برای اکثر دستورها.
.IP
.nf
\f[C]
  -n, --dry-run         اجرای آزمایشی بدون اعمال هرگونه تغییر دائمی
  -i, --interactive     فعال کردن حالت تعاملی
  -v, --verbose count   چاپ خروجی با جزئیات بسیار بیشتر (تکرار برای جزئیات بیشتر)
\f[R]
.fi
.SS "بررسی (Check)"
.PP
پرچم‌های مورد استفاده برای دستورهای بررسی (check).
.IP
.nf
\f[C]
      --max-backlog int   حداکثر تعداد اشیاء در صف انتظارهای همگام‌سازی یا بررسی (پیش‌فرض 10000)
\f[R]
.fi.SS "شبکه (Networking)"
.PP
پرچم‌هایی برای امور عمومی شبکه و HTTP.
.IP
.nf
\f[C]
      --bind string                        نشانی محلی برای مقیدسازی (bind) در اتصالات خروجی، IPv4، IPv6 یا نام
      --bwlimit BwTimetable                محدودیت پهنای باند بر حسب KiB/s، یا استفاده از پسوند B|K|M|G|T|P یا یک جدول زمانی کامل
      --bwlimit-file BwTimetable           محدودیت پهنای باند به ازای هر فایل بر حسب KiB/s، یا استفاده از پسوند B|K|M|G|T|P یا یک جدول زمانی کامل
      --ca-cert stringArray                گواهی CA مورد استفاده برای اعتبارسنجی سرورها
      --client-cert string                 گواهی SSL کلاینت (PEM) برای احراز هویت دوطرفه TLS
      --client-key string                  کلید خصوصی SSL کلاینت (PEM) برای احراز هویت دوطرفه TLS
      --client-pass string                 گذرواژه کلید خصوصی SSL کلاینت (PEM) برای احراز هویت دوطرفه TLS (مبهم‌سازی‌شده) (مبهم‌سازی‌شده)
      --contimeout Duration                مهلت زمانی برقراری اتصال (پیش‌فرض 1m0s)
      --disable-http-keep-alives           غیرفعال‌سازی keep-aliveهای HTTP و استفاده یک‌باره از هر اتصال
      --disable-http2                      غیرفعال‌سازی HTTP/2 در انتقال سراسری (global transport)
      --dscp string                        تنظیم مقدار DSCP برای اتصالات، مقدار یا نام، مانند CS1، LE، DF، AF21
      --expect-continue-timeout Duration   مهلت زمانی هنگام استفاده از expect / 100-continue در HTTP (پیش‌فرض 1s)
      --header stringArray                 تنظیم سرایند HTTP برای تمام تراکنش‌ها
      --header-download stringArray        تنظیم سرایند HTTP برای تراکنش‌های بارگیری
      --header-upload stringArray          تنظیم سرایند HTTP برای تراکنش‌های بارگذاری
      --http-proxy string                  نشانی URL پیشکار HTTP
      --max-connections int                حداکثر تعداد اتصالات هم‌زمان به API پشتیبان، 0 برای نامحدود
      --no-check-certificate               اعتبارسنجی نکردن گواهی SSL سرور (ناامن)
      --no-gzip-encoding                   تنظیم نکردن Accept-Encoding: gzip
      --timeout Duration                   مهلت زمانی بیکاری ورودی/خروجی (پیش‌فرض 5m0s)
      --tpslimit float                     محدود کردن تراکنش‌های HTTP بر ثانیه به این مقدار
      --tpslimit-burst int                 حداکثر جهش ناگهانی تراکنش‌ها برای --tpslimit (پیش‌فرض 1)
      --use-cookies                        فعال‌سازی حافظه کوکی (cookiejar) نشست
      --user-agent string                  تنظیم user-agent روی یک رشته مشخص (پیش‌فرض \[dq]rclone/v1.75.1\[dq])
\f[R]
.fi
.SS "کارایی (Performance)"
.PP
پرچم‌های مفید برای افزایش کارایی.
.IP
.nf
\f[C]
      --buffer-size SizeSuffix   اندازه بافر درون حافظه هنگام خواندن فایل‌ها برای هر --transfer (پیش‌فرض 16Mi)
      --checkers int             تعداد بررسی‌کننده‌های هم‌زمان برای اجرا (پیش‌فرض 8)
      --transfers int            تعداد انتقال‌های هم‌زمان فایل (پیش‌فرض 4)
\f[R]
.fi
.SS "پیکربندی (Config)"
.PP
پرچم‌هایی برای پیکربندی عمومی rclone.
.IP
.nf
\f[C]
      --ask-password                        مجاز بودن درخواست گذرواژه برای پیکربندی رمزگذاری‌شده (پیش‌فرض true)
      --auto-confirm                        در صورت فعال بودن، تأییدیه کنسول درخواست نشود
      --cache-dir string                    پوشه‌ای که rclone برای حافظه موقت (کش) استفاده می‌کند (پیش‌فرض \[dq]$HOME/.cache/rclone\[dq])
      --color AUTO|NEVER|ALWAYS             زمان نمایش رنگ‌ها (و سایر کدهای ANSI) AUTO|NEVER|ALWAYS (پیش‌فرض AUTO)
      --config string                       فایل پیکربندی (پیش‌فرض \[dq]$HOME/.config/rclone/rclone.conf\[dq])
      --default-time Time                   زمانی که در صورت نامشخص بودن modtime برای فایل‌ها و پوشه‌ها نمایش داده می‌شود (پیش‌فرض 2000-01-01T00:00:00Z)
      --disable string                      غیرفعال‌سازی فهرستی از ویژگی‌ها که با کاما جدا شده‌اند (برای دیدن فهرست از --disable help استفاده کنید)
  -n, --dry-run                             اجرای آزمایشی بدون اعمال تغییرات دائمی
      --error-on-no-transfer                تنظیم وضعیت خروج 9 در صورتی که هیچ فایلی منتقل نشود، مفید در اسکریپت‌ها
      --fs-cache-expire-duration Duration   نگه‌داری ریموت‌ها در حافظه موقت برای این مدت (0 برای غیرفعال‌سازی کش) (پیش‌فرض 5m0s)
      --fs-cache-expire-interval Duration   بازه زمانی برای بررسی ریموت‌های منقضی‌شده (پیش‌فرض 1m0s)
      --human-readable                      چاپ اعداد در قالبی خوانا برای انسان، اندازه‌ها با پسوند Ki|Mi|Gi|Ti|Pi
  -i, --interactive                         فعال‌سازی حالت تعاملی
      --kv-lock-time Duration               حداکثر زمان برای قفل نگه‌داشتن پایگاه‌داده کلید-مقدار توسط فرایند (پیش‌فرض 1s)
      --low-level-retries int               تعداد دفعات تلاش مجدد سطح پایین (پیش‌فرض 10)
      --max-buffer-memory SizeSuffix        در صورت تنظیم، بیش از این مقدار حافظه به عنوان بافر تخصیص داده نشود (پیش‌فرض off)
      --no-console                          پنهان کردن پنجره کنسول (تنها در ویندوز پشتیبانی می‌شود)
      --no-unicode-normalization            عدم نرمال‌سازی نویسه‌های یونیکد در نام فایل‌ها
      --password-command SpaceSepList       دستور برای ارائه گذرواژه پیکربندی رمزگذاری‌شده
      --retries int                         تلاش دوباره عملیات در صورت شکست به این تعداد دفعات (پیش‌فرض 3)
      --retries-sleep Duration              بازه زمانی میان تلاش‌های دوباره در صورت شکست عملیات، مانند 500ms، 60s، 5m (0 برای غیرفعال‌سازی) (پیش‌فرض 0s)
      --temp-dir string                     پوشه‌ای که rclone برای فایل‌های موقت استفاده خواهد کرد (پیش‌فرض \[dq]/tmp\[dq])
      --use-mmap                            استفاده از تخصیص‌دهنده mmap (مستندات را ببینید)
      --use-server-modtime                  استفاده از زمان ویرایش سرور به جای فراداده شیء
\f[R]
.fi
.SS "اشکال‌زدایی (Debugging)"
.PP
پرچم‌هایی برای توسعه‌دهندگان.
.IP
.nf
\f[C]
      --cpuprofile string   نوشتن نمایه CPU در فایل
      --dump DumpFlags      فهرستی از موارد برای تخلیه (dump) از: headers, bodies, requests, responses, auth, filters, goroutines, openfiles, mapper, curl, errors, trace
      --dump-bodies         تخلیه سرایندها و بدنه HTTP \- ممکن است شامل اطلاعات حساس باشد
      --dump-headers        تخلیه سرایند‌های HTTP \- ممکن است شامل اطلاعات حساس باشد
      --memprofile string   نوشتن نمایه حافظه در فایل
\f[R]
.fi.SS فیلتر (Filter)
.PP
پرچم‌هایی برای فیلتر کردن فهرست‌های دایرکتوری.
.IP
.nf
\f[C]
      --delete-excluded                     حذف فایل‌های موجود در مقصد که از همگام‌سازی مستثنی شده‌اند
      --exclude stringArray                 مستثنی کردن فایل‌های منطبق با الگو
      --exclude-from stringArray            خواندن الگوهای استثنای فایل از فایل (استفاده از \- برای خواندن از stdin)
      --exclude-if-present stringArray      مستثنی کردن دایرکتوری‌ها در صورت وجود نام فایل
      --files-from stringArray              خواندن فهرست نام‌های فایل مبدأ از فایل (استفاده از \- برای خواندن از stdin)
      --files-from-raw stringArray          خواندن فهرست نام‌های فایل مبدأ از فایل بدون هیچ پردازشی روی خطوط (استفاده از \- برای خواندن از stdin)
      --files-from0 stringArray             خواندن فهرست نام‌های فایل مبدأ از فایل با استفاده از NUL به‌عنوان جداکننده (استفاده از \- برای خواندن از stdin)
  -f, --filter stringArray                  افزودن یک قانون فیلتر کردن فایل
      --filter-from stringArray             خواندن الگوهای فیلتر کردن فایل از یک فایل (استفاده از \- برای خواندن از stdin)
      --hash-filter string                  پارتیشن‌بندی نام فایل‌ها با هش k/n یا به‌صورت تصادفی \[at]/n
      --ignore-case                         نادیده گرفتن بزرگی و کوچکی حروف در فیلترها (غیرحساس به حروف بزرگ و کوچک)
      --include stringArray                 شامل کردن فایل‌های منطبق با الگو
      --include-from stringArray            خواندن الگوهای شمول فایل از فایل (استفاده از \- برای خواندن از stdin)
      --max-age Duration                    فقط انتقال فایل‌های جدیدتر از این مقدار برحسب ثانیه یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --max-depth int                       در صورت تنظیم، عمق بازگشت را به این مقدار محدود می‌کند (پیش‌فرض \-1)
      --max-size SizeSuffix                 فقط انتقال فایل‌های کوچک‌تر از این مقدار برحسب KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض غیرفعال)
      --metadata-exclude stringArray        مستثنی کردن فراداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای فراداده از فایل (استفاده از \- برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قانون فیلتر کردن فراداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن فراداده از یک فایل (استفاده از \- برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن فراداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول فراداده از فایل (استفاده از \- برای خواندن از stdin)
      --min-age Duration                    فقط انتقال فایل‌های قدیمی‌تر از این مقدار برحسب ثانیه یا با پسوند ms|s|m|h|d|w|M|y (پیش‌فرض غیرفعال)
      --min-size SizeSuffix                 فقط انتقال فایل‌های بزرگ‌تر از این مقدار برحسب KiB یا با پسوند B|K|M|G|T|P (پیش‌فرض غیرفعال)
\f[R]
.fi
.SS فهرست‌کردن (Listing)
.PP
پرچم‌هایی برای فهرست کردن دایرکتوری‌ها.
.IP
.nf
\f[C]
      --default-time Time   زمان نمایش در صورت نامشخص بودن modtime برای فایل‌ها و دایرکتوری‌ها (پیش‌فرض 2000-01-01T00:00:00Z)
      --fast-list           استفاده از فهرست‌کردن بازگشتی در صورت موجود بودن؛ مصرف حافظه بیشتر ولی تراکنش‌های کمتر
\f[R]
.fi
.SS گزارش‌گیری (Logging)
.PP
پرچم‌هایی برای ثبت گزارش و آمارها.
.IP
.nf
\f[C]
      --log-file string                     ثبت همه موارد در این فایل
      --log-file-compress                   در صورت تنظیم، فشرده‌سازی فایل‌های گزارش چرخش‌یافته با gzip
      --log-file-max-age Duration           حداکثر زمان نگهداری فایل‌های گزارش قدیمی (مانند \[dq]7d\[dq]) (پیش‌فرض 0s)
      --log-file-max-backups int            حداکثر تعداد فایل‌های گزارش قدیمی برای نگهداری
      --log-file-max-size SizeSuffix        حداکثر اندازه فایل گزارش پیش از چرخش آن (مانند \[dq]10M\[dq]) (پیش‌فرض غیرفعال)
      --log-format Bits                     فهرست جداشده با کاما از گزینه‌های قالب گزارش (پیش‌فرض date,time)
      --log-level LogLevel                  سطح گزارش DEBUG|INFO|NOTICE|ERROR (پیش‌فرض NOTICE)
      --log-systemd                         فعال‌سازی یکپارچگی با systemd برای ثبت‌کننده وقایع
      --max-stats-groups int                حداکثر تعداد گروه‌های آماری برای نگهداری در حافظه؛ در حداکثر، قدیمی‌ترین دور ریخته می‌شود (پیش‌فرض 1000)
  -P, --progress                            نمایش پیشرفت در حین انتقال
      --progress-terminal-title             نمایش پیشرفت در عنوان ترمینال (نیازمند \-P/\-\-progress)
  -q, --quiet                               چاپ کمترین اطلاعات ممکن
      --stats Duration                      بازه زمانی میان چاپ آمارها، مثلاً 500ms، 60s، 5m (0 برای غیرفعال‌سازی) (پیش‌فرض 1m0s)
      --stats-file-name-length int          حداکثر طول نام فایل در آمارها (0 برای بدون محدودیت) (پیش‌فرض 45)
      --stats-log-level LogLevel            سطح گزارش برای نمایش خروجی \-\-stats شامل DEBUG|INFO|NOTICE|ERROR (پیش‌فرض INFO)
      --stats-one-line                      جا دادن آمارها در یک خط
      --stats-one-line-date                 فعال‌سازی \-\-stats\-one\-line و افزودن پیشوند تاریخ/زمان کنونی
      --stats-one-line-date-format string   فعال‌سازی \-\-stats\-one\-line\-date و استفاده از تاریخ با قالب سفارشی: رشته تاریخ را در علامت نقل‌قول (\[dq]) قرار دهید، ببینید https://golang.org/pkg/time/#Time.Format
      --stats-unit string                   نمایش نرخ داده در آمارها به‌صورت \[aq]bits\[aq] یا \[aq]bytes\[aq] در ثانیه (پیش‌فرض \[dq]bytes\[dq])
      --syslog                              استفاده از Syslog برای ثبت گزارش
      --syslog-facility string              بخش (Facility) برای syslog، مثلاً KERN,USER (پیش‌فرض \[dq]DAEMON\[dq])
      --use-json-log                        استفاده از قالب گزارش json
  -v, --verbose count                       چاپ اطلاعات بسیار بیشتر (تکرار برای جزئیات بیشتر)
\f[R]
.fi
.SS فراداده (Metadata)
.PP
پرچم‌هایی برای کنترل فراداده.
.IP
.nf
\f[C]
  -M, --metadata                            در صورت تنظیم، حفظ فراداده هنگام کپی کردن اشیاء
      --metadata-exclude stringArray        مستثنی کردن فراداده‌های منطبق با الگو
      --metadata-exclude-from stringArray   خواندن الگوهای استثنای فراداده از فایل (استفاده از \- برای خواندن از stdin)
      --metadata-filter stringArray         افزودن یک قانون فیلتر کردن فراداده
      --metadata-filter-from stringArray    خواندن الگوهای فیلتر کردن فراداده از یک فایل (استفاده از \- برای خواندن از stdin)
      --metadata-include stringArray        شامل کردن فراداده‌های منطبق با الگو
      --metadata-include-from stringArray   خواندن الگوهای شمول فراداده از فایل (استفاده از \- برای خواندن از stdin)
      --metadata-mapper SpaceSepList        برنامه‌ای برای اجرا جهت تبدیل فراداده قبل از بارگذاری
      --metadata-set stringArray            افزودن فراداده key=value هنگام بارگذاری
\f[R]
.fi.SS "کنترل از راه دور (RC)"
.PP
پرچم‌هایی برای کنترل API کنترل از راه دور (Remote Control).
.IP
.nf
\f[C]
      --rc                                 فعال‌سازی سرور کنترل از راه دور
      --rc-addr stringArray                آدرس IPaddress:Port یا :Port برای مقید کردن (bind) سرور به آن (پیش‌فرض localhost:5572)
      --rc-allow-origin string             مبدأیی که درخواست‌های بین‌دامنه (CORS) می‌توانند از آن اجرا شوند
      --rc-baseurl string                  پیشوند برای URLها \- برای ریشه خالی بگذارید
      --rc-cert string                     کلید PEM مربوط به TLS (الحاق گواهی و گواهی CA)
      --rc-client-ca string                مرجع صدور گواهی (CA) کلاینت برای اعتبارسنجی کلاینت‌ها
      --rc-enable-metrics                  فعال‌سازی مسیر معیارهای Prometheus در سرور کنترل از راه دور
      --rc-files string                    مسیر فایل‌های محلی برای ارائه روی سرور HTTP
      --rc-htpasswd string                 یک فایل htpasswd \- در صورت عدم ارائه هیچ احراز هویتی انجام نمی‌شود
      --rc-job-expire-duration Duration    منقضی کردن کارهای ناهمگام (async) پایان‌یافته قدیمی‌تر از این مقدار (پیش‌فرض 1m0s)
      --rc-job-expire-interval Duration    بازه زمانی بررسی کارهای ناهمگام (async) منقضی‌شده (پیش‌فرض 10s)
      --rc-key string                      کلید خصوصی PEM مربوط به TLS
      --rc-max-header-bytes int            حداکثر اندازه هدر درخواست (پیش‌فرض 4096)
      --rc-min-tls-version string          حداقل نسخه TLS قابل قبول (پیش‌فرض \[dq]tls1.0\[dq])
      --rc-no-auth                         عدم الزام به احراز هویت برای روش‌های خاص
      --rc-pass string                     گذرواژه برای احراز هویت
      --rc-realm string                    قلمرو (Realm) برای احراز هویت
      --rc-response-header stringArray     تنظیم هدر HTTP برای همه پاسخ‌ها، بازنویسی مقادیر موجود
      --rc-salt string                     سالت (salt) برای هش کردن گذرواژه (پیش‌فرض \[dq]dlPL2MqE\[dq])
      --rc-serve                           فعال‌سازی ارائه شیءهای راه دور
      --rc-serve-no-modtime                زمان تغییر را نخوان (می‌تواند سرعت را افزایش دهد)
      --rc-server-read-timeout Duration    مهلت زمانی سرور برای خواندن داده‌ها (پیش‌فرض 1h0m0s)
      --rc-server-write-timeout Duration   مهلت زمانی سرور برای نوشتن داده‌ها (پیش‌فرض 1h0m0s)
      --rc-template string                 قالب مشخص‌شده توسط کاربر
      --rc-user string                     نام کاربری برای احراز هویت
      --rc-user-from-header string         نام کاربری از یک هدر HTTP تعریف‌شده
      --rc-web-fetch-url string            نشانی URL برای دریافت نسخه‌های webgui (پیش‌فرض \[dq]https://api.github.com/repos/rclone/rclone-webui-react/releases/latest\[dq])
      --rc-web-gui                         راه‌اندازی WebGUI روی localhost
      --rc-web-gui-force-update            اجبار به به‌روزرسانی به آخرین نسخه web gui
      --rc-web-gui-no-open-browser         مرورگر را به طور خودکار باز نکن
      --rc-web-gui-update                  بررسی و به‌روزرسانی به آخرین نسخه web gui
\f[R]
.fi
.SS "معیارها (Metrics)"
.PP
پرچم‌هایی برای کنترل نقطه پایانی (endpoint) HTTP معیارها..
.IP
.nf
\f[C]
      --metrics-addr stringArray                آدرس IPaddress:Port یا :Port برای مقید کردن (bind) سرور به آن
      --metrics-allow-origin string             مبدأیی که درخواست‌های بین‌دامنه (CORS) می‌توانند از آن اجرا شوند
      --metrics-baseurl string                  پیشوند برای URLها \- برای ریشه خالی بگذارید
      --metrics-cert string                     کلید PEM مربوط به TLS (الحاق گواهی و گواهی CA)
      --metrics-client-ca string                مرجع صدور گواهی (CA) کلاینت برای اعتبارسنجی کلاینت‌ها
      --metrics-htpasswd string                 یک فایل htpasswd \- در صورت عدم ارائه هیچ احراز هویتی انجام نمی‌شود
      --metrics-key string                      کلید خصوصی PEM مربوط به TLS
      --metrics-max-header-bytes int            حداکثر اندازه هدر درخواست (پیش‌فرض 4096)
      --metrics-min-tls-version string          حداقل نسخه TLS قابل قبول (پیش‌فرض \[dq]tls1.0\[dq])
      --metrics-pass string                     گذرواژه برای احراز هویت
      --metrics-realm string                    قلمرو (Realm) برای احراز هویت
      --metrics-response-header stringArray     تنظیم هدر HTTP برای همه پاسخ‌ها، بازنویسی مقادیر موجود
      --metrics-salt string                     سالت (salt) برای هش کردن گذرواژه (پیش‌فرض \[dq]dlPL2MqE\[dq])
      --metrics-server-read-timeout Duration    مهلت زمانی سرور برای خواندن داده‌ها (پیش‌فرض 1h0m0s)
      --metrics-server-write-timeout Duration   مهلت زمانی سرور برای نوشتن داده‌ها (پیش‌فرض 1h0m0s)
      --metrics-template string                 قالب مشخص‌شده توسط کاربر
      --metrics-user string                     نام کاربری برای احراز هویت
      --metrics-user-from-header string         نام کاربری از یک هدر HTTP تعریف‌شده
      --rc-enable-metrics                       فعال‌سازی مسیر معیارهای Prometheus در سرور کنترل از راه دور
\f[R]
.fi
.SS "بک‌اند (Backend)"
.PP
پرچم‌های فقط-بک‌اند (این‌ها می‌توانند در فایل پیکربندی نیز تنظیم شوند).
.IP
.nf
\f[C]
      --alias-description string                            شرح ریموت (remote)
      --alias-remote string                                 ریموت یا مسیری که باید نام مستعار (alias) شود
      --archive-description string                          شرح ریموت (remote)
      --archive-remote string                               ریموت پوشش‌داده‌شده برای خواندن آرشیوها از آن
      --azureblob-access-tier string                        لایه دسترسی (access tier) برای blob: hot، cool، cold یا archive
      --azureblob-account string                            نام حساب ذخیره‌سازی Azure
      --azureblob-archive-tier-delete                       حذف blobهای لایه archive پیش از رونویسی
      --azureblob-chunk-size SizeSuffix                     اندازه تکه بارگذاری (پیش‌فرض 4Mi)
      --azureblob-client-certificate-password string        گذرواژه فایل گواهی (اختیاری) (مبهم‌سازی‌شده)
      --azureblob-client-certificate-path string            مسیر فایل گواهی PEM یا PKCS12 حاوی کلید خصوصی
      --azureblob-client-id string                          شناسه کلاینت مورد استفاده
      --azureblob-client-secret string                      یکی از رمزهای کلاینت (client secret) مربوط به service principal
      --azureblob-client-send-certificate-chain             ارسال زنجیره گواهی هنگام استفاده از احراز هویت با گواهی
      --azureblob-connection-string string                  رشته اتصال ذخیره‌سازی (Connection String)
      --azureblob-copy-concurrency int                      همروندی برای کپی چندبخشی (پیش‌فرض 512)
      --azureblob-copy-cutoff SizeSuffix                    آستانه سوئیچ به کپی چندبخشی (پیش‌فرض 8Mi)
      --azureblob-copy-total-concurrency int                محدودیت همروندی سراسری برای تکه‌های کپی چندبخشی
      --azureblob-decompress                                در صورت تنظیم، شیءهای کدگذاری‌شده با gzip را از حالت فشرده خارج می‌کند
      --azureblob-delete-snapshots string                   تعیین نحوه برخورد با اسنپ‌شات‌ها هنگام حذف blob
      --azureblob-description string                        شرح ریموت (remote)
      --azureblob-directory-markers                         بارگذاری یک شیء خالی با اسلش در انتها هنگام ایجاد دایرکتوری جدید
      --azureblob-disable-checksum                          چکسام MD5 را با متاداده شیء ذخیره نکن
      --azureblob-disable-instance-discovery                صرف‌نظر از درخواست متاداده نمونه Microsoft Entra
      --azureblob-encoding Encoding                         کدگذاری برای بک‌اند (پیش‌فرض Slash,BackSlash,Del,Ctl,RightPeriod,InvalidUtf8)
      --azureblob-endpoint string                           نقطه پایانی (endpoint) برای سرویس
      --azureblob-env-auth                                  خواندن اطلاعات احراز هویت از زمان اجرا (متغیرهای محیطی، CLI یا MSI)
      --azureblob-key string                                کلید مشترک (Shared Key) حساب ذخیره‌سازی
      --azureblob-list-chunk int                            اندازه فهرست blob (پیش‌فرض 5000)
      --azureblob-msi-client-id string                      شناسه شیء (Object ID) مربوط به MSI انتساب‌یافته به کاربر، در صورت وجود
      --azureblob-msi-mi-res-id string                      شناسه منبع Azure مربوط به MSI انتساب‌یافته به کاربر، در صورت وجود
      --azureblob-msi-object-id string                      شناسه شیء (Object ID) مربوط به MSI انتساب‌یافته به کاربر، در صورت وجود
      --azureblob-no-check-container                        در صورت تنظیم، برای بررسی وجود کانتینر یا ایجاد آن تلاشی نکن
      --azureblob-no-head-object                            در صورت تنظیم، هنگام دریافت شیءها قبل از GET درخواست HEAD نفرست
      --azureblob-password string                           گذرواژه کاربر (مبهم‌سازی‌شده)
      --azureblob-public-access string                      سطح دسترسی عمومی یک کانتینر: blob یا container
      --azureblob-sas-url string                            نشانی SAS URL تنها برای دسترسی در سطح کانتینر
      --azureblob-service-principal-file string             مسیر فایل حاوی اعتبارنامه‌ها برای استفاده با یک service principal
      --azureblob-tenant string                             شناسه مستأجر (tenant) مربوط به service principal، که شناسه دایرکتوری نیز نامیده می‌شود
      --azureblob-upload-concurrency int                    همروندی برای بارگذاری‌های چندبخشی (پیش‌فرض 16)
      --azureblob-upload-cutoff string                      آستانه سوئیچ به بارگذاری تکه‌ای (<= 256 MiB) (منسوخ‌شده)
      --azureblob-use-az                                    استفاده از ابزار az در Azure CLI برای احراز هویت
      --azureblob-use-copy-blob                             استفاده از Copy Blob API هنگام کپی در همان حساب ذخیره‌سازی (پیش‌فرض true)
      --azureblob-use-emulator                              استفاده از شبیه‌ساز ذخیره‌سازی محلی اگر مقدار \[aq]true\[aq] داده شود
      --azureblob-use-msi                                   استفاده از هویت مدیریت‌شده سرویس (MSI) برای احراز هویت (فقط در Azure کار می‌کند)
      --azureblob-username string                           نام کاربری (معمولاً یک آدرس ایمیل)
      --azurefiles-account string                           نام حساب ذخیره‌سازی Azure
      --azurefiles-chunk-size SizeSuffix                    اندازه تکه بارگذاری (پیش‌فرض 4Mi)
      --azurefiles-client-certificate-password string       گذرواژه فایل گواهی (اختیاری) (مبهم‌سازی‌شده)
      --azurefiles-client-certificate-path string           مسیر فایل گواهی PEM یا PKCS12 حاوی کلید خصوصی
      --azurefiles-client-id string                         شناسه کلاینت مورد استفاده
      --azurefiles-client-secret string                     یکی از رمزهای کلاینت (client secret) مربوط به service principal
      --azurefiles-client-send-certificate-chain            ارسال زنجیره گواهی هنگام استفاده از احراز هویت با گواهی
      --azurefiles-connection-string string                 رشته اتصال ذخیره‌سازی (Connection String)
      --azurefiles-description string                       شرح ریموت (remote)
      --azurefiles-disable-instance-discovery               صرف‌نظر از درخواست متاداده نمونه Microsoft Entra
      --azurefiles-encoding Encoding                        کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,RightPeriod,InvalidUtf8,Dot)
      --azurefiles-endpoint string                          نقطه پایانی (endpoint) برای سرویس
      --azurefiles-env-auth                                 خواندن اطلاعات احراز هویت از زمان اجرا (متغیرهای محیطی، CLI یا MSI)
      --azurefiles-key string                               کلید مشترک (Shared Key) حساب ذخیره‌سازی
      --azurefiles-max-stream-size SizeSuffix               حداکثر اندازه برای فایل‌های جریانی (streamed) (پیش‌فرض 10Gi)
      --azurefiles-msi-client-id string                     شناسه شیء (Object ID) مربوط به MSI انتساب‌یافته به کاربر، در صورت وجود
      --azurefiles-msi-mi-res-id string                     شناسه منبع Azure مربوط به MSI انتساب‌یافته به کاربر، در صورت وجود
      --azurefiles-msi-object-id string                     شناسه شیء (Object ID) مربوط به MSI انتساب‌یافته به کاربر، در صورت وجود
      --azurefiles-password string                          گذرواژه کاربر (مبهم‌سازی‌شده)
      --azurefiles-sas-url string                           نشانی SAS URL تنها برای دسترسی در سطح کانتینر
      --azurefiles-service-principal-file string            مسیر فایل حاوی اعتبارنامه‌ها برای استفاده با یک service principal
      --azurefiles-share-name string                        نام اشتراک Azure Files
      --azurefiles-tenant string                            شناسه مستأجر (tenant) مربوط به service principal، که شناسه دایرکتوری نیز نامیده می‌شود
      --azurefiles-upload-concurrency int                   همروندی برای بارگذاری‌های چندبخشی (پیش‌فرض 16)
      --azurefiles-use-az                                   استفاده از ابزار az در Azure CLI برای احراز هویت
      --azurefiles-use-emulator                             استفاده از شبیه‌ساز ذخیره‌سازی محلی اگر مقدار \[aq]true\[aq] داده شود
      --azurefiles-use-msi                                  استفاده از هویت مدیریت‌شده سرویس (MSI) برای احراز هویت (فقط در Azure کار می‌کند)
      --azurefiles-username string                          نام کاربری (معمولاً یک آدرس ایمیل)
      --b2-account string                                   شناسه حساب یا شناسه Application Key
      --b2-chunk-size SizeSuffix                            اندازه تکه بارگذاری (پیش‌فرض 96Mi)
      --b2-copy-cutoff SizeSuffix                           آستانه سوئیچ به کپی چندبخشی (پیش‌فرض 4Gi)
      --b2-description string                               شرح ریموت (remote)
      --b2-disable-checksum                                 غیرفعال کردن چکسام برای فایل‌های بزرگ (> آستانه بارگذاری)
      --b2-download-auth-duration Duration                  زمان پیش از انقضای توکن مجوز پیوند عمومی بر حسب ثانیه یا با پسوند ms|s|m|h|d (پیش‌فرض 1w)
      --b2-download-url string                              نقطه پایانی سفارشی برای بارگیری‌ها
      --b2-encoding Encoding                                کدگذاری برای بک‌اند (پیش‌فرض Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
      --b2-endpoint string                                  نقطه پایانی (endpoint) برای سرویس
      --b2-hard-delete                                      حذف دائمی فایل‌ها هنگام حذف از ریموت، در غیر این صورت پنهان کردن آن‌ها
      --b2-key string                                       کلید برنامه (Application Key)
      --b2-lifecycle int                                    تنظیم تعداد روزهایی که فایل‌های حذف‌شده باید پس از ایجاد باکت نگهداری شوند
      --b2-sse-customer-algorithm string                    در صورت استفاده از SSE-C، الگوریتم رمزگذاری سمت سرور مورد استفاده هنگام ذخیره این شیء در B2
      --b2-sse-customer-key string                          برای استفاده از SSE-C، می‌توانید کلید رمزگذاری محرمانه را به صورت رشته سازگار با UTF-8 برای رمزگذاری/رمزگشایی داده‌ها ارائه دهید
      --b2-sse-customer-key-base64 string                   برای استفاده از SSE-C، می‌توانید کلید رمزگذاری محرمانه را در قالب Base64 برای رمزگذاری/رمزگشایی داده‌ها ارائه دهید
      --b2-sse-customer-key-md5 string                      در صورت استفاده از SSE-C می‌توانید چکسام MD5 کلید رمزگذاری محرمانه را ارائه دهید (اختیاری)
      --b2-test-mode string                                 یک رشته پرچم برای هدر X-Bz-Test-Mode جهت اشکال‌زدایی
      --b2-upload-concurrency int                           همروندی برای بارگذاری‌های چندبخشی (پیش‌فرض 4)
      --b2-upload-cutoff SizeSuffix                         آستانه سوئیچ به بارگذاری تکه‌ای (پیش‌فرض 200Mi)
      --b2-version-at Time                                  نمایش نسخه‌های فایل همان‌طور که در زمان مشخص‌شده بودند (پیش‌فرض غیرفعال)
      --b2-versions                                         گنجاندن نسخه‌های قدیمی در فهرست‌های دایرکتوری
      --box-access-token string                             توکن دسترسی اصلی برنامه Box
      --box-auth-url string                                 نشانی URL سرور احراز هویت
      --box-box-config-file string                          مکان فایل config.json برنامه Box
      --box-box-sub-type string                              (پیش‌فرض \[dq]user\[dq])
      --box-client-credentials                              استفاده از جریان OAuth اطلاعات کاربری کلاینت (client credentials)
      --box-client-id string                                شناسه کلاینت OAuth
      --box-client-secret string                            رمز کلاینت OAuth
      --box-commit-retries int                              حداکثر تعداد تلاش برای نهایی‌سازی (commit) فایل چندبخشی (پیش‌فرض 100)
      --box-description string                              شرح ریموت (remote)
      --box-encoding Encoding                               کدگذاری برای بک‌اند (پیش‌فرض Slash,BackSlash,Del,Ctl,RightSpace,InvalidUtf8,Dot)
      --box-impersonate string                              جعل هویت این شناسه کاربر هنگام استفاده از حساب سرویس
      --box-list-chunk int                                  اندازه تکه فهرست‌بندی بین 1 تا 1000 (پیش‌فرض 1000)
      --box-owned-by string                                 فقط نمایش مواردی که متعلق به لاگین (آدرس ایمیل) ارائه‌شده هستند
      --box-root-folder-id string                           برای اینکه rclone از یک پوشه غیرریشه به عنوان نقطه شروع استفاده کند پر کنید
      --box-token string                                    توکن دسترسی OAuth به صورت یک شیء JSON
      --box-token-url string                                نشانی URL سرور توکن
      --box-upload-cutoff SizeSuffix                        آستانه سوئیچ به بارگذاری چندبخشی (>= 50 MiB) (پیش‌فرض 50Mi)
      --cache-chunk-clean-interval Duration                 هر چند وقت یک‌بار کش باید پاک‌سازی حافظه تکه‌ها را انجام دهد (پیش‌فرض 1m0s)
      --cache-chunk-no-memory                               غیرفعال کردن کش درون‌حافظه‌ای برای ذخیره تکه‌ها هنگام جریان داده (streaming)
      --cache-chunk-path string                             دایرکتوری کش کردن فایل‌های تکه (پیش‌فرض \[dq]$HOME/.cache/rclone/cache-backend\[dq])
      --cache-chunk-size SizeSuffix                         اندازه یک تکه (داده‌های بخشی فایل) (پیش‌فرض 5Mi)
      --cache-chunk-total-size SizeSuffix                   کل فضایی که تکه‌ها می‌توانند روی دیسک محلی اشغال کنند (پیش‌فرض 10Gi)
      --cache-db-path string                                دایرکتوری ذخیره پایگاه داده متاداده ساختار فایل (پیش‌فرض \[dq]$HOME/.cache/rclone/cache-backend\[dq])
      --cache-db-purge                                      پاک کردن تمام داده‌های کش‌شده برای این ریموت هنگام شروع
      --cache-db-wait-time Duration                         مدت زمان انتظار برای در دسترس قرار گرفتن پایگاه داده \- 0 نامحدود است (پیش‌فرض 1s)
      --cache-description string                            شرح ریموت (remote)
      --cache-info-age Duration                             مدت زمان کش کردن اطلاعات ساختار فایل (فهرست دایرکتوری، اندازه فایل، زمان‌ها و غیره) (پیش‌فرض 6h0m0s)
      --cache-plex-insecure string                          صرف‌نظر از تمام اعتبارسنجی‌های گواهی هنگام اتصال به سرور Plex
      --cache-plex-password string                          گذرواژه کاربر Plex (مبهم‌سازی‌شده)
      --cache-plex-url string                               نشانی URL سرور Plex
      --cache-plex-username string                          نام کاربری کاربر Plex
      --cache-read-retries int                              تعداد دفعات تلاش مجدد برای خواندن از حافظه کش (پیش‌فرض 10)
      --cache-remote string                                 ریموت برای کش کردن
      --cache-rps int                                       محدود کردن تعداد درخواست‌ها در ثانیه به فایل‌سیستم منبع (-1 برای غیرفعال کردن) (پیش‌فرض -1)
      --cache-tmp-upload-path string                        دایرکتوری نگهداری فایل‌های موقت تا زمانی که بارگذاری شوند
      --cache-tmp-wait-time Duration                        چه مدت فایل‌ها باید قبل از بارگذاری در کش محلی ذخیره شوند (پیش‌فرض 15s)
      --cache-workers int                                   تعداد پردازنده‌های موازی (workers) برای بارگیری تکه‌ها (پیش‌فرض 4)
      --cache-writes                                        کش کردن داده‌های فایل در عملیات نوشتن از طریق فایل‌سیستم
      --chunker-chunk-size SizeSuffix                       فایل‌های بزرگ‌تر از اندازه تکه، به تکه‌ها تقسیم خواهند شد (پیش‌فرض 2Gi)
      --chunker-description string                          شرح ریموت (remote)
      --chunker-fail-hard                                   انتخاب نحوه مدیریت فایل‌هایی با تکه‌های ناموجود یا نامعتبر توسط chunker
      --chunker-hash-type string                            انتخاب نحوه مدیریت مجموع هش توسط chunker (پیش‌فرض \[dq]md5\[dq])
      --chunker-remote string                               ریموت برای تکه‌تکه کردن یا ادغام تکه‌ها
      --cloudinary-adjust-media-files-extensions            ‏Cloudinary قالب‌های چندرسانه‌ای را به عنوان یک صفت فایل در نظر می‌گیرد و آن را از نام حذف می‌کند، برخلاف اغلب فایل‌سیستم‌های دیگر (پیش‌فرض true)
      --cloudinary-api-key string                           کلید API سرویس Cloudinary
      --cloudinary-api-secret string                        رمز API سرویس Cloudinary
      --cloudinary-cloud-name string                        نام محیط (Environment Name) در Cloudinary
      --cloudinary-description string                       شرح ریموت (remote)
      --cloudinary-encoding Encoding                        کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,DoubleQuote,Question,Asterisk,Pipe,Hash,Percent,BackSlash,Del,Ctl,RightSpace,InvalidUtf8,Dot)
      --cloudinary-eventually-consistent-delay Duration     انتظار به مدت N ثانیه برای یکپارچگی نهایی (eventual consistency) پایگاه‌های داده پشتیبان عملیات بک‌اند (پیش‌فرض 0s)
      --cloudinary-media-extensions stringArray             پسوندهای رسانه‌ای پشتیبانی‌شده توسط Cloudinary (پیش‌فرض 3ds,3g2,3gp,ai,arw,avi,avif,bmp,bw,cr2,cr3,djvu,dng,eps3,fbx,flif,flv,gif,glb,gltf,hdp,heic,heif,ico,indd,jp2,jpe,jpeg,jpg,jxl,jxr,m2ts,mov,mp4,mpeg,mts,mxf,obj,ogv,pdf,ply,png,psd,svg,tga,tif,tiff,ts,u3ma,usdz,wdp,webm,webp,wmv)
      --cloudinary-upload-prefix string                     مشخص کردن نقطه پایانی API برای محیط‌های خارج از ایالات متحده
      --cloudinary-upload-preset string                     پیش‌تنظیم بارگذاری برای انتخاب نحوه دستکاری دارایی (asset) هنگام بارگذاری
      --combine-description string                          شرح ریموت (remote)
      --combine-upstreams SpaceSepList                      بالادست‌ها (upstreams) برای ترکیب
      --compress-description string                         شرح ریموت (remote)
      --compress-level string                               ‏GZIP (سطوح -2 تا 9):
      --compress-mode string                                حالت فشرده‌سازی (پیش‌فرض \[dq]gzip\[dq])
      --compress-ram-cache-limit SizeSuffix                 برخی ریموت‌ها اجازه بارگذاری فایل‌هایی با اندازه نامشخص را نمی‌دهند (پیش‌فرض 20Mi)
      --compress-remote string                              ریموت برای فشرده‌سازی
  -L, --copy-links                                          دنبال کردن پیوندهای نمادین (symlinks) و کپی کردن موردی که به آن اشاره شده است
      --crypt-description string                            شرح ریموت (remote)
      --crypt-directory-name-encryption                     گزینه رمزگذاری نام دایرکتوری‌ها یا دست‌نخورده باقی گذاشتن آن‌ها (پیش‌فرض true)
      --crypt-filename-encoding string                      نحوه کدگذاری نام فایل رمزگذاری‌شده به رشته متنی (پیش‌فرض \[dq]base32\[dq])
      --crypt-filename-encryption string                    نحوه رمزگذاری نام فایل‌ها (پیش‌فرض \[dq]standard\[dq])
      --crypt-no-data-encryption                            گزینه رمزگذاری داده‌های فایل یا رها کردن آن‌ها بدون رمزگذاری
      --crypt-pass-bad-blocks                               در صورت تنظیم، بلوک‌های خراب را به صورت تماماً صفر عبور می‌دهد
      --crypt-password string                               گذرواژه یا عبارت عبور برای رمزگذاری (مبهم‌سازی‌شده)
      --crypt-password2 string                              گذرواژه یا عبارت عبور برای سالت (مبهم‌سازی‌شده)
      --crypt-remote string                                 ریموت برای رمزگذاری/رمزگشایی
      --crypt-server-side-across-configs                    منسوخ‌شده: به جای آن از --server-side-across-configs استفاده کنید
      --crypt-show-mapping                                  برای تمام فایل‌های فهرست‌شده، نحوه رمزگذاری نام‌ها را نشان می‌دهد
      --crypt-strict-names                                  در صورت تنظیم، اگر crypt به نام فایلی برخورد کند که قابل رمزگشایی نیست، خطا می‌دهد
      --crypt-suffix string                                 در صورت تنظیم، پسوند پیش‌فرض \[dq].bin\[dq] را بازنویسی می‌کند (پیش‌فرض \[dq].bin\[dq])
      --doi-description string                              شرح ریموت (remote)
      --doi-doi string                                      شناسه DOI یا نشانی URL در doi.org
      --doi-doi-resolver-api-url string                     نشانی URL مربوط به API حل‌کننده (resolver) DOI برای استفاده
      --doi-provider string                                 ارائه‌دهنده DOI
      --drime-access-token string                           توکن دسترسی API
      --drime-chunk-size SizeSuffix                         اندازه تکه برای استفاده در بارگذاری (پیش‌فرض 5Mi)
      --drime-description string                            شرح ریموت (remote)
      --drime-encoding Encoding                             کدگذاری برای بک‌اند (پیش‌فرض Slash,BackSlash,Del,Ctl,LeftSpace,RightSpace,InvalidUtf8,Dot)
      --drime-hard-delete                                   حذف دائمی فایل‌ها به جای قرار دادن آن‌ها در سطل زباله
      --drime-list-chunk int                                تعداد مواردی که باید در هر فراخوانی فهرست شوند (پیش‌فرض 1000)
      --drime-root-folder-id string                         شناسه پوشه ریشه
      --drime-upload-concurrency int                        همروندی برای بارگذاری‌ها و کپی‌های چندبخشی (پیش‌فرض 4)
      --drime-upload-cutoff SizeSuffix                      آستانه سوئیچ به بارگذاری تکه‌ای (پیش‌فرض 5Mi)
      --drime-workspace-id string                           شناسه حساب
      --drive-acknowledge-abuse                             تنظیم برای اجازه بارگیری فایل‌هایی که خطای cannotDownloadAbusiveFile را برمی‌گردانند
      --drive-allow-import-name-change                      اجازه تغییر نوع فایل هنگام بارگذاری اسناد Google Docs
      --drive-auth-owner-only                               فقط فایل‌هایی را در نظر بگیر که متعلق به کاربر احراز هویت‌شده هستند
      --drive-auth-url string                               نشانی URL سرور احراز هویت
      --drive-chunk-size SizeSuffix                         اندازه تکه بارگذاری (پیش‌فرض 8Mi)
      --drive-client-credentials                            استفاده از جریان OAuth اطلاعات کاربری کلاینت (client credentials)
      --drive-client-id string                              شناسه کلاینت برنامه گوگل
      --drive-client-secret string                          رمز کلاینت برنامه گوگل
      --drive-copy-shortcut-content                         کپی محتویات میانبرها در سمت سرور به جای کپی خود میانبر
      --drive-description string                            شرح ریموت (remote)
      --drive-disable-http2                                 غیرفعال کردن استفاده drive از http2 (پیش‌فرض true)
      --drive-encoding Encoding                             کدگذاری برای بک‌اند (پیش‌فرض InvalidUtf8)
      --drive-env-auth                                      دریافت اطلاعات کاربری IAM از زمان اجرا (متغیرهای محیطی یا متاداده نمونه در صورت نبود متغیرهای محیطی)
      --drive-export-formats string                         فهرست جداشده با کاما از فرمت‌های ترجیحی برای بارگیری اسناد Google Docs (پیش‌فرض \[dq]docx,xlsx,pptx,svg\[dq])
      --drive-fast-list-bug-fix                             دور زدن یک باگ در فهرست‌بندی Google Drive (پیش‌فرض true)
      --drive-formats string                                منسوخ‌شده: export_formats را ببینید
      --drive-impersonate string                            جعل هویت این کاربر هنگام استفاده از حساب سرویس
      --drive-import-formats string                         فهرست جداشده با کاما از فرمت‌های ترجیحی برای بارگذاری اسناد Google Docs
      --drive-keep-revision-forever                         نگهداری دائمی آخرین بازبینی (head revision) جدید هر فایل
      --drive-list-chunk int                                اندازه تکه فهرست‌بندی 100-1000، مقدار 0 برای غیرفعال کردن (پیش‌فرض 1000)
      --drive-metadata-enforce-expansive-access             اینکه آیا درخواست باید قوانین دسترسی گسترده را اعمال کند یا خیر
      --drive-metadata-labels Bits                          کنترل اینکه آیا برچسب‌ها باید در متاداده خوانده یا نوشته شوند (پیش‌فرض غیرفعال)
      --drive-metadata-owner Bits                           کنترل اینکه آیا مالک باید در متاداده خوانده یا نوشته شود (پیش‌فرض read)
      --drive-metadata-permissions Bits                     کنترل اینکه آیا مجوزها باید در متاداده خوانده یا نوشته شوند (پیش‌فرض غیرفعال)
      --drive-pacer-burst int                               تعداد فراخوانی‌های API مجاز بدون مکث (sleep) (پیش‌فرض 100)
      --drive-pacer-min-sleep Duration                      حداقل زمان مکث میان فراخوانی‌های API (پیش‌فرض 100ms)
      --drive-resource-key string                           کلید منبع برای دسترسی به فایلی که از طریق پیوند به اشتراک گذاشته شده است
      --drive-root-folder-id string                         شناسه پوشه ریشه
      --drive-scope string                                  فهرست جداشده با کاما از حوزه‌هایی (scopes) که rclone باید هنگام درخواست دسترسی از drive استفاده کند
      --drive-server-side-across-configs                    منسوخ‌شده: به جای آن از --server-side-across-configs استفاده کنید
      --drive-service-account-credentials string            شیء JSON اعتبارنامه‌های حساب سرویس
      --drive-service-account-file string                   مسیر فایل JSON اعتبارنامه‌های حساب سرویس
      --drive-shared-with-me                                فقط نمایش فایل‌هایی که با من به اشتراک گذاشته شده‌اند
      --drive-show-all-gdocs                                نمایش همه اسناد Google Docs از جمله موارد غیرقابل خروجی‌گیری در فهرست‌ها
      --drive-size-as-quota                                 نمایش اندازه‌ها بر حسب سهمیه مصرف‌شده ذخیره‌سازی، نه اندازه واقعی
      --drive-skip-checksum-gphotos                         صرف‌نظر از چکسام‌ها فقط روی عکس‌ها و ویدیوهای Google Photos
      --drive-skip-dangling-shortcuts                       در صورت تنظیم، از فایل‌های میانبر معلق (بدون مقصد) صرف‌نظر می‌کند
      --drive-skip-gdocs                                    صرف‌نظر از اسناد Google Docs در تمام فهرست‌ها
      --drive-skip-shortcuts                                در صورت تنظیم، از فایل‌های میانبر صرف‌نظر می‌کند
      --drive-starred-only                                  فقط نمایش فایل‌های ستاره‌دار
      --drive-stop-on-download-limit                        در نظر گرفتن خطاهای محدودیت بارگیری به عنوان خطای مهلک
      --drive-stop-on-upload-limit                          در نظر گرفتن خطاهای محدودیت بارگذاری به عنوان خطای مهلک
      --drive-team-drive string                             شناسه درایو مشترک (Team Drive)
      --drive-token string                                  توکن دسترسی OAuth به صورت یک شیء JSON
      --drive-token-url string                              نشانی URL سرور توکن
      --drive-trashed-only                                  فقط نمایش فایل‌هایی که در سطل زباله هستند
      --drive-upload-cutoff SizeSuffix                      آستانه سوئیچ به بارگذاری تکه‌ای (پیش‌فرض 8Mi)
      --drive-use-created-date                              استفاده از تاریخ ایجاد فایل به جای تاریخ تغییر
      --drive-use-shared-date                               استفاده از تاریخ اشتراک‌گذاری فایل به جای تاریخ تغییر
      --drive-use-trash                                     ارسال فایل‌ها به سطل زباله به جای حذف دائمی (پیش‌فرض true)
      --drive-v2-download-min-size SizeSuffix               در صورتی که شیءها بزرگ‌تر باشند، از drive v2 API برای بارگیری استفاده می‌شود (پیش‌فرض غیرفعال)
      --dropbox-auth-url string                             نشانی URL سرور احراز هویت
      --dropbox-batch-mode string                           دسته‌بندی فایل برای بارگذاری sync|async|off (پیش‌فرض \[dq]sync\[dq])
      --dropbox-batch-size int                              حداکثر تعداد فایل‌ها در دسته بارگذاری
      --dropbox-batch-timeout Duration                      حداکثر زمان مجاز برای بیکار بودن دسته بارگذاری قبل از بارگذاری (پیش‌فرض 0s)
      --dropbox-chunk-size SizeSuffix                       اندازه تکه بارگذاری (< 150Mi) (پیش‌فرض 48Mi)
      --dropbox-client-credentials                          استفاده از جریان OAuth اطلاعات کاربری کلاینت (client credentials)
      --dropbox-client-id string                            شناسه کلاینت OAuth
      --dropbox-client-secret string                        رمز کلاینت OAuth
      --dropbox-description string                          شرح ریموت (remote)
      --dropbox-encoding Encoding                           کدگذاری برای بک‌اند (پیش‌فرض Slash,BackSlash,Del,RightSpace,InvalidUtf8,Dot)
      --dropbox-export-formats CommaSepList                 فهرست جداشده با کاما از فرمت‌های ترجیحی برای برون‌بری فایل‌ها (پیش‌فرض html,md)
      --dropbox-impersonate string                          جعل هویت این کاربر هنگام استفاده از حساب تجاری (Business)
      --dropbox-impersonate-admin string                    شناسه مدیر تیم برای استفاده هنگام انجام اقدامات به عنوان مدیر تیم
      --dropbox-pacer-min-sleep Duration                    حداقل زمان مکث میان فراخوانی‌های API (پیش‌فرض 10ms)
      --dropbox-root-namespace string                       تعیین شناسه فضای نام (namespace) متفاوتی در Dropbox به عنوان ریشه برای همه مسیرها
      --dropbox-shared-files                                دستور به rclone برای کار بر روی تک‌تک فایل‌های به‌اشتراک‌گذاشته‌شده
      --dropbox-shared-folders                              دستور به rclone برای کار بر روی پوشه‌های به‌اشتراک‌گذاشته‌شده
      --dropbox-show-all-exports                            نمایش همه فایل‌های قابل برون‌بری در فهرست‌ها
      --dropbox-skip-exports                                صرف‌نظر از فایل‌های قابل برون‌بری در تمام فهرست‌ها
      --dropbox-skip-shared-folders                         دستور به rclone برای صرف‌نظر از تمام پوشه‌های به‌اشتراک‌گذاشته‌شده
      --dropbox-skip-unowned-folders                        دستور به rclone برای صرف‌نظر از پوشه‌های به‌اشتراک‌گذاشته‌شده‌ای که متعلق به کاربر فعلی نیستند
      --dropbox-token string                                توکن دسترسی OAuth به صورت یک شیء JSON
      --dropbox-token-url string                            نشانی URL سرور توکن
      --fichier-api-key string                              کلید API شما، آن را از https://1fichier.com/console/params.pl دریافت کنید
      --fichier-cdn                                         در صورتی که مایل به استفاده از پیوندهای بارگیری CDN هستید تنظیم کنید
      --fichier-description string                          شرح ریموت (remote)
      --fichier-encoding Encoding                           کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,DoubleQuote,SingleQuote,BackQuote,Dollar,BackSlash,Del,Ctl,LeftSpace,RightSpace,InvalidUtf8,Dot)
      --fichier-file-password string                        اگر می‌خواهید یک فایل به‌اشتراک‌گذاشته‌شده محافظت‌شده با گذرواژه را بارگیری کنید، این پارامتر را اضافه کنید (مبهم‌سازی‌شده)
      --fichier-folder-password string                      اگر می‌خواهید فایل‌های موجود در یک پوشه به‌اشتراک‌گذاشته‌شده محافظت‌شده با گذرواژه را فهرست کنید، این پارامتر را اضافه کنید (مبهم‌سازی‌شده)
      --fichier-shared-folder string                        اگر می‌خواهید یک پوشه به‌اشتراک‌گذاشته‌شده را بارگیری کنید، این پارامتر را اضافه کنید
      --filefabric-description string                       شرح ریموت (remote)
      --filefabric-encoding Encoding                        کدگذاری برای بک‌اند (پیش‌فرض Slash,Del,Ctl,InvalidUtf8,Dot)
      --filefabric-permanent-token string                   توکن احراز هویت دائمی
      --filefabric-root-folder-id string                    شناسه پوشه ریشه
      --filefabric-token string                             توکن نشست (Session)
      --filefabric-token-expiry string                      زمان انقضای توکن
      --filefabric-url string                               نشانی URL مربوط به Enterprise File Fabric برای اتصال به آن
      --filefabric-version string                           نسخه خوانده‌شده از file fabric
      --filelu-chunk-size SizeSuffix                        اندازه تکه برای استفاده در بارگذاری. برای بارگذاری‌های چندبخشی استفاده می‌شود (پیش‌فرض 64Mi)
      --filelu-description string                           شرح ریموت (remote)
      --filelu-encoding Encoding                            کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,DoubleQuote,SingleQuote,BackQuote,Dollar,Colon,Question,Asterisk,Pipe,Hash,Percent,BackSlash,CrLf,Del,Ctl,LeftSpace,LeftPeriod,LeftTilde,LeftCrLfHtVt,RightSpace,RightPeriod,RightCrLfHtVt,InvalidUtf8,Dot,SquareBracket,Semicolon,Exclamation)
      --filelu-key string                                   کلید FileLu Rclone شما از بخش My Account
      --filelu-upload-cutoff SizeSuffix                     آستانه سوئیچ به بارگذاری تکه‌ای. هر فایلی بزرگ‌تر از این مقدار به صورت تکه‌هایی با اندازه chunk_size بارگذاری خواهد شد (پیش‌فرض 500Mi)
      --filen-api-key string                                کلید API حساب Filen شما (مبهم‌سازی‌شده)
      --filen-auth-version string                           نسخه احراز هویت (صرفاً برای استفاده داخلی)
\f[R]
.fi--filen-base-folder-uuid string                       UUID دایرکتوری ریشهٔ حساب (تنها برای استفادهٔ داخلی)
      --filen-description string                            توضیحات ریموت
      --filen-email string                                  ایمیل حساب Filen شما
      --filen-encoding Encoding                             کدگذاری برای بک‌اند (پیش‌فرض Slash,Del,Ctl,InvalidUtf8,Dot)
      --filen-master-keys string                            کلیدهای اصلی (تنها برای استفادهٔ داخلی)
      --filen-password string                               گذرواژهٔ حساب Filen شما (مبهم‌شده)
      --filen-private-key string                            کلید خصوصی RSA (تنها برای استفادهٔ داخلی)
      --filen-public-key string                             کلید عمومی RSA (تنها برای استفادهٔ داخلی)
      --filen-upload-concurrency int                        هم‌زمانی برای بارگذاری‌های تکه‌ای (پیش‌فرض 16)
      --filescom-api-key string                             کلید API استفاده‌شده برای احراز هویت در Files.com
      --filescom-description string                         توضیحات ریموت
      --filescom-encoding Encoding                          کدگذاری برای بک‌اند (پیش‌فرض Slash,BackSlash,Del,Ctl,RightSpace,RightCrLfHtVt,InvalidUtf8,Dot)
      --filescom-password string                            گذرواژهٔ استفاده‌شده برای احراز هویت در Files.com (مبهم‌شده)
      --filescom-site string                                زیردامنهٔ سایت شما (مانند mysite) یا دامنهٔ سفارشی (مانند myfiles.customdomain.com)
      --filescom-username string                            نام کاربری استفاده‌شده برای احراز هویت در Files.com
      --ftp-allow-insecure-tls-ciphers                      مجاز دانستن سایفرهای ناامن TLS
      --ftp-ask-password                                    اجازه برای درخواست گذرواژهٔ FTP در صورت نیاز
      --ftp-close-timeout Duration                          بیشینه زمان انتظار برای پاسخ به بستن اتصال (پیش‌فرض 1m0s)
      --ftp-concurrency int                                 بیشینه تعداد اتصالات هم‌زمان FTP، مقدار 0 برای نامحدود
      --ftp-description string                              توضیحات ریموت
      --ftp-disable-epsv                                    غیرفعال کردن استفاده از EPSV حتی در صورت اعلام پشتیبانی سرور
      --ftp-disable-mlsd                                    غیرفعال کردن استفاده از MLSD حتی در صورت اعلام پشتیبانی سرور
      --ftp-disable-tls13                                   غیرفعال کردن TLS 1.3 (راهکار موقت برای سرورهای FTP با TLS معیوب)
      --ftp-disable-utf8                                    غیرفعال کردن استفاده از UTF-8 حتی در صورت اعلام پشتیبانی سرور
      --ftp-encoding Encoding                               کدگذاری برای بک‌اند (پیش‌فرض Slash,Del,Ctl,RightSpace,Dot)
      --ftp-explicit-tls                                    استفاده از Explicit FTPS (پروتکل FTP روی TLS)
      --ftp-force-list-hidden                               استفاده از LIST \-a برای اجبار در فهرست کردن فایل‌ها و پوشه‌های پنهان. این گزینه استفاده از MLSD را غیرفعال می‌کند
      --ftp-host string                                     میزبان FTP برای اتصال
      --ftp-http-proxy string                               نشانی URL برای پراکسی HTTP CONNECT
      --ftp-idle-timeout Duration                           بیشینه زمان پیش از بستن اتصالات بیکار (پیش‌فرض 1m0s)
      --ftp-no-check-certificate                            عدم اعتبارسنجی گواهی TLS سرور
      --ftp-no-check-upload                                 بررسی نکردن صحت بارگذاری
      --ftp-pass string                                     گذرواژهٔ FTP (مبهم‌شده)
      --ftp-port int                                        شماره درگاه FTP (پیش‌فرض 21)
      --ftp-shut-timeout Duration                           بیشینه زمان انتظار برای وضعیت بسته شدن اتصال داده (پیش‌فرض 1m0s)
      --ftp-socks-proxy string                              میزبان پراکسی Socks 5
      --ftp-tls                                             استفاده از Implicit FTPS (پروتکل FTP روی TLS)
      --ftp-tls-cache-size int                              اندازهٔ حافظهٔ موقت نشست TLS برای همهٔ اتصالات کنترلی و داده (پیش‌فرض 32)
      --ftp-user string                                     نام کاربری FTP (پیش‌فرض \[dq]$USER\[dq])
      --ftp-writing-mdtm                                    استفاده از MDTM برای تنظیم زمان تغییر (ناسازگاری مربوط به VsFtpd)
      --gcs-access-token string                             توکن دسترسی کوتاه‌مدت
      --gcs-anonymous                                       دسترسی به باکت‌ها و اشیاء عمومی بدون اطلاعات کاربری
      --gcs-auth-url string                                 نشانی URL سرور احراز هویت
      --gcs-bucket-acl string                               فهرست کنترل دسترسی (ACL) برای باکت‌های جدید
      --gcs-bucket-policy-only                              بررسی‌های دسترسی باید از خط‌مشی‌های IAM در سطح باکت استفاده کنند
      --gcs-client-credentials                              استفاده از جریان اعتبارسنجی کلاینت OAuth
      --gcs-client-id string                                شناسهٔ کلاینت OAuth
      --gcs-client-secret string                            رمز کلاینت OAuth
      --gcs-decompress                                      در صورت تنظیم، اشیاء با کدگذاری gzip از حالت فشرده خارج می‌شوند
      --gcs-description string                              توضیحات ریموت
      --gcs-directory-markers                               بارگذاری یک شیء خالی با اسلش انتهایی هنگام ایجاد دایرکتوری جدید
      --gcs-encoding Encoding                               کدگذاری برای بک‌اند (پیش‌فرض Slash,CrLf,InvalidUtf8,Dot)
      --gcs-endpoint string                                 نقطهٔ پایانی سفارشی برای API فضای ذخیره‌سازی. برای استفاده از پیش‌فرض ارائه‌دهنده خالی بگذارید
      --gcs-env-auth                                        دریافت اطلاعات کاربری GCP IAM از محیط اجرا (متغیرهای محیطی یا فرا‌داده‌های نمونه در صورت نبود متغیرها)
      --gcs-location string                                 مکان برای باکت‌های تازه ایجادشده
      --gcs-no-check-bucket                                 در صورت تنظیم، برای بررسی وجود باکت یا ایجاد آن تلاشی نمی‌شود
      --gcs-object-acl string                               فهرست کنترل دسترسی (ACL) برای اشیاء جدید
      --gcs-project-number string                           شماره پروژه
      --gcs-service-account-file string                     مسیر فایل JSON اطلاعات کاربری Service Account
      --gcs-storage-class string                            کلاس ذخیره‌سازی مورد استفاده هنگام ذخیرهٔ اشیاء در Google Cloud Storage
      --gcs-token string                                    توکن دسترسی OAuth به صورت حباب JSON
      --gcs-token-url string                                نشانی URL سرور توکن
      --gcs-user-project string                             پروژهٔ کاربر
      --gofile-access-token string                          توکن دسترسی API
      --gofile-account-id string                            شناسهٔ حساب
      --gofile-description string                           توضیحات ریموت
      --gofile-encoding Encoding                            کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,LeftPeriod,RightPeriod,InvalidUtf8,Dot,Exclamation)
      --gofile-list-chunk int                               تعداد مواردی که در هر فراخوانی فهرست می‌شوند (پیش‌فرض 1000)
      --gofile-root-folder-id string                        شناسهٔ پوشهٔ ریشه
      --gphotos-auth-url string                             نشانی URL سرور احراز هویت
      --gphotos-batch-mode string                           دسته‌بندی بارگذاری فایل sync|async|off (پیش‌فرض \[dq]sync\[dq])
      --gphotos-batch-size int                              بیشینه تعداد فایل‌ها در دستهٔ بارگذاری
      --gphotos-batch-timeout Duration                      بیشینه زمان مجاز برای دستهٔ بارگذاری بیکار پیش از بارگذاری (پیش‌فرض 0s)
      --gphotos-client-credentials                          استفاده از جریان اعتبارسنجی کلاینت OAuth
      --gphotos-client-id string                            شناسهٔ کلاینت OAuth
      --gphotos-client-secret string                        رمز کلاینت OAuth
      --gphotos-description string                          توضیحات ریموت
      --gphotos-encoding Encoding                           کدگذاری برای بک‌اند (پیش‌فرض Slash,CrLf,InvalidUtf8,Dot)
      --gphotos-include-archived                            همچنین مشاهده و بارگیری رسانه‌های بایگانی‌شده
      --gphotos-proxy string                                استفاده از پراکسی gphotosdl برای بارگیری تصاویر با وضوح کامل
      --gphotos-read-only                                   تنظیم برای فقط‌خواندنی کردن بک‌اند Google Photos
      --gphotos-read-size                                   تنظیم برای خواندن اندازهٔ اقلام رسانه‌ای
      --gphotos-start-year int                              محدود کردن عکس‌های بارگیری به مواردی که پس از سال داده‌شده بارگذاری شده‌اند (پیش‌فرض 2000)
      --gphotos-token string                                توکن دسترسی OAuth به صورت حباب JSON
      --gphotos-token-url string                            نشانی URL سرور توکن
      --hasher-auto-size SizeSuffix                         به‌روزرسانی خودکار چکسام برای فایل‌های کوچک‌تر از این اندازه (به طور پیش‌فرض غیرفعال)
      --hasher-description string                           توضیحات ریموت
      --hasher-hashes CommaSepList                          فهرست جداشده با ویرگول از انواع چکسام پشتیبانی‌شده (پیش‌فرض md5,sha1)
      --hasher-max-age Duration                             بیشینه زمان نگهداری چکسام‌ها در حافظهٔ موقت (0 = بدون کش، off = کش دائمی) (پیش‌فرض off)
      --hasher-remote string                                ریموت برای ذخیرهٔ موقت چکسام‌ها (مانند myRemote:path)
      --hdfs-data-transfer-protection string                حفاظت از انتقال داده در Kerberos: authentication|integrity|privacy
      --hdfs-description string                             توضیحات ریموت
      --hdfs-encoding Encoding                              کدگذاری برای بک‌اند (پیش‌فرض Slash,Colon,Del,Ctl,InvalidUtf8,Dot)
      --hdfs-namenode CommaSepList                          گره‌ها و درگاه‌های نام در Hadoop
      --hdfs-service-principal-name string                  نام سرویس پرینسیپال Kerberos برای namenode
      --hdfs-username string                                نام کاربری Hadoop
      --hidrive-auth-url string                             نشانی URL سرور احراز هویت
      --hidrive-chunk-size SizeSuffix                       اندازهٔ تکه‌ها برای بارگذاری‌های تکه‌ای (پیش‌فرض 48Mi)
      --hidrive-client-credentials                          استفاده از جریان اعتبارسنجی کلاینت OAuth
      --hidrive-client-id string                            شناسهٔ کلاینت OAuth
      --hidrive-client-secret string                        رمز کلاینت OAuth
      --hidrive-description string                          توضیحات ریموت
      --hidrive-disable-fetching-member-count               دریافت نکردن تعداد اشیاء موجود در دایرکتوری‌ها مگر در صورت نیاز قطعی
      --hidrive-encoding Encoding                           کدگذاری برای بک‌اند (پیش‌فرض Slash,Dot)
      --hidrive-endpoint string                             نقطهٔ پایانی برای سرویس (پیش‌فرض \[dq]https://api.hidrive.strato.com/2.1\[dq])
      --hidrive-root-prefix string                          پوشهٔ ریشه/والد برای همهٔ مسیرها (پیش‌فرض \[dq]/\[dq])
      --hidrive-scope-access string                         مجوزهای دسترسی که rclone باید هنگام درخواست دسترسی از HiDrive استفاده کند (پیش‌فرض \[dq]rw\[dq])
      --hidrive-scope-role string                           سطح کاربری که rclone باید هنگام درخواست دسترسی از HiDrive استفاده کند (پیش‌فرض \[dq]user\[dq])
      --hidrive-token string                                توکن دسترسی OAuth به صورت حباب JSON
      --hidrive-token-url string                            نشانی URL سرور توکن
      --hidrive-upload-concurrency int                      هم‌زمانی برای بارگذاری‌های تکه‌ای (پیش‌فرض 4)
      --hidrive-upload-cutoff SizeSuffix                    آستانه برای بارگذاری‌های تکه‌ای (پیش‌فرض 96Mi)
      --http-description string                             توضیحات ریموت
      --http-headers CommaSepList                           تنظیم هدرهای HTTP برای همهٔ تراکنش‌ها
      --http-no-escape                                      گریز ندادن نویسه‌های ویژهٔ URL در نام مسیرها
      --http-no-head                                        استفاده نکردن از درخواست‌های HEAD
      --http-no-slash                                       تنظیم این گزینه در صورتی که دایرکتوری‌های سایت با / پایان نمی‌یابند
      --http-url string                                     نشانی URL میزبان HTTP برای اتصال
      --huaweidrive-auth-url string                         نشانی URL سرور احراز هویت
      --huaweidrive-chunk-size SizeSuffix                   اندازهٔ تکه‌های بارگذاری (پیش‌فرض 8Mi)
      --huaweidrive-client-credentials                      استفاده از جریان اعتبارسنجی کلاینت OAuth
      --huaweidrive-client-id string                        شناسهٔ کلاینت OAuth
      --huaweidrive-client-secret string                    رمز کلاینت OAuth
      --huaweidrive-description string                      توضیحات ریموت
      --huaweidrive-encoding Encoding                       کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,LeftSpace,LeftPeriod,LeftTilde,RightSpace,RightPeriod,InvalidUtf8,Dot)
      --huaweidrive-list-chunk int                          اندازهٔ تکهٔ فهرست‌بندی بین 1 تا 1000 (پیش‌فرض 1000)
      --huaweidrive-root-folder-id string                   شناسهٔ پوشهٔ ریشه
      --huaweidrive-token string                            توکن دسترسی OAuth به صورت حباب JSON
      --huaweidrive-token-url string                        نشانی URL سرور توکن
      --huaweidrive-upload-cutoff SizeSuffix                آستانه برای جابه‌جایی به بارگذاری با قابلیت ازسرگیری (پیش‌فرض 20Mi)
      --iclouddrive-apple-id string                         شناسهٔ Apple ID
      --iclouddrive-client-id string                        شناسهٔ کلاینت برای دسترسی به API سرویس iCloud (پیش‌فرض \[dq]d39ba9916b7251055b22c7f910e2ea796ee65e98b2ddecea8f5dde8d9d1a815d\[dq])
      --iclouddrive-description string                      توضیحات ریموت
      --iclouddrive-encoding Encoding                       کدگذاری برای بک‌اند (پیش‌فرض Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
      --iclouddrive-password string                         گذرواژه (مبهم‌شده)
      --iclouddrive-service string                          سرویس iCloud مورد استفاده (پیش‌فرض \[dq]drive\[dq])
      --imagekit-description string                         توضیحات ریموت
      --imagekit-encoding Encoding                          کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,DoubleQuote,Dollar,Question,Hash,Percent,BackSlash,Del,Ctl,InvalidUtf8,Dot,SquareBracket)
      --imagekit-endpoint string                            می‌توانید نشانی URL پایانی ImageKit.io خود را در [پیشخوان](https://imagekit.io/dashboard/developer/api-keys) بیابید
      --imagekit-only-signed Restrict unsigned image URLs   اگر در تنظیمات پیشخوان خود گزینهٔ Restrict unsigned image URLs را پیکربندی کرده‌اید، این را روی true بگذارید
      --imagekit-private-key string                         می‌توانید کلید خصوصی ImageKit.io خود را در [پیشخوان](https://imagekit.io/dashboard/developer/api-keys) بیابید
      --imagekit-public-key string                          می‌توانید کلید عمومی ImageKit.io خود را در [پیشخوان](https://imagekit.io/dashboard/developer/api-keys) بیابید
      --imagekit-upload-tags string                         برچسب‌ها برای افزودن به فایل‌های بارگذاری‌شده، مانند \[dq]tag1,tag2\[dq]
      --imagekit-versions                                   گنجاندن نسخه‌های قدیمی در فهرست‌های دایرکتوری
      --internetarchive-access-key-id string                کلید دسترسی IAS3
      --internetarchive-description string                  توضیحات ریموت
      --internetarchive-disable-checksum                    درخواست نکردن از سرور برای آزمایش در برابر چکسام MD5 محاسبه‌شده توسط rclone (پیش‌فرض true)
      --internetarchive-encoding Encoding                   کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,CrLf,Del,Ctl,InvalidUtf8,Dot)
      --internetarchive-endpoint string                     نقطهٔ پایانی IAS3 (پیش‌فرض \[dq]https://s3.us.archive.org\[dq])
      --internetarchive-front-endpoint string               میزبان فرانت‌اند InternetArchive (پیش‌فرض \[dq]https://archive.org\[dq])
      --internetarchive-item-derive                         تعیین اجرای اشتقاق روی آیتم IA یا خیر. در صورت تنظیم روی false، آیتم پس از بارگذاری توسط IA اشتقاق نمی‌یابد (پیش‌فرض true)
      --internetarchive-item-metadata stringArray           فراداده برای تنظیم روی آیتم IA؛ این با فراداده در سطح فایل که با \-\-metadata\-set تنظیم می‌شود متفاوت است
      --internetarchive-secret-access-key string            کلید مخفی IAS3 (گذرواژه)
      --internetarchive-wait-archive Duration               زمان انتظار برای پایان یافتن وظایف پردازشی سرور (به‌ویژه archive و book_op) (پیش‌فرض 0s)
      --internxt-chunk-size SizeSuffix                      اندازهٔ تکه‌ها برای بارگذاری‌های چندبخشی (پیش‌فرض 30Mi)
      --internxt-description string                         توضیحات ریموت
      --internxt-email string                               ایمیل حساب Internxt شما
      --internxt-encoding Encoding                          کدگذاری برای بک‌اند (پیش‌فرض Slash,BackSlash,CrLf,RightPeriod,InvalidUtf8,Dot)
      --internxt-pass string                                گذرواژه (مبهم‌شده)
      --internxt-skip-hash-validation                       صرف‌نظر کردن از اعتبارسنجی هش هنگام بارگیری فایل‌ها (پیش‌فرض true)
      --internxt-upload-concurrency int                     هم‌زمانی برای بارگذاری‌های چندبخشی (پیش‌فرض 4)
      --internxt-upload-cutoff SizeSuffix                   آستانه برای جابه‌جایی به بارگذاری چندبخشی (پیش‌فرض 100Mi)
      --jottacloud-auth-url string                          نشانی URL سرور احراز هویت
      --jottacloud-client-credentials                       استفاده از جریان اعتبارسنجی کلاینت OAuth
      --jottacloud-client-id string                         شناسهٔ کلاینت OAuth
      --jottacloud-client-secret string                     رمز کلاینت OAuth
      --jottacloud-description string                       توضیحات ریموت
      --jottacloud-encoding Encoding                        کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,Percent,Del,Ctl,InvalidUtf8,Dot)
      --jottacloud-hard-delete                              حذف دائمی فایل‌ها به جای انتقال آن‌ها به سطل زباله
      --jottacloud-md5-memory-limit SizeSuffix              فایل‌های بزرگ‌تر از این مقدار برای محاسبهٔ MD5 در صورت نیاز، روی دیسک کش می‌شوند (پیش‌فرض 10Mi)
      --jottacloud-no-versions                              جلوگیری از نسخه‌بندی سمت سرور با حذف فایل‌ها و ایجاد دوبارهٔ آن‌ها به جای بازنویسی
      --jottacloud-token string                             توکن دسترسی OAuth به صورت حباب JSON
      --jottacloud-token-url string                         نشانی URL سرور توکن
      --jottacloud-trashed-only                             تنها نمایش فایل‌هایی که در سطل زباله هستند
      --jottacloud-upload-resume-limit SizeSuffix           بارگذاری فایل‌های بزرگ‌تر از این مقدار در صورت بروز شکست قابلیت ازسرگیری دارد (پیش‌فرض 10Mi)
      --koofr-description string                            توضیحات ریموت
      --koofr-encoding Encoding                             کدگذاری برای بک‌اند (پیش‌فرض Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
      --koofr-endpoint string                               نقطهٔ پایانی API مورد استفاده برای Koofr
      --koofr-mountid string                                شناسهٔ مانت مورد استفاده
      --koofr-password string                               گذرواژهٔ شما برای rclone؛ یکی در https://app.koofr.net/app/admin/preferences/password بسازید (مبهم‌شده)
      --koofr-provider string                               ارائه‌دهندهٔ فضای ذخیره‌سازی خود را انتخاب کنید
      --koofr-setmtime                                      آیا بک‌اند از تنظیم زمان تغییر پشتیبانی می‌کند (پیش‌فرض true)
      --koofr-user string                                   نام کاربری شما
      --linkbox-description string                          توضیحات ریموت
      --linkbox-email string                                ایمیل برای ورود
      --linkbox-password string                             گذرواژه برای ورود (مبهم‌شده)
      --linkbox-token string                                توکن از https://www.linkbox.to/admin/account
      --local-case-insensitive                              وادار کردن فایل‌سیستم به گزارش خود به صورت حساس نبودن به حروف کوچک و بزرگ
      --local-case-sensitive                                وادار کردن فایل‌سیستم به گزارش خود به صورت حساس به حروف کوچک و بزرگ
      --local-description string                            توضیحات ریموت
      --local-encoding Encoding                             کدگذاری برای بک‌اند (پیش‌فرض Slash,Dot)
      --local-fatal-if-no-space                             مهلک تلقی کردن خطاهای کمبود فضا در حین انتقال‌ها
      --local-hashes CommaSepList                           فهرست جداشده با ویرگول از انواع چکسام پشتیبانی‌شده
      --local-links                                         ترجمهٔ پیوندهای نمادین به/از فایل‌های معمولی با پسوند \[aq].rclonelink\[aq] برای بک‌اند محلی
      --local-metadata-restore-special-bits                 بازیابی بیت‌های setuid، setgid و چسبنده (sticky) از فراداده
      --local-no-check-updated                              بررسی نکردن تغییر یافتن فایل‌ها در حین بارگذاری
      --local-no-clone                                      غیرفعال کردن کلونینگ reflink برای کپی‌های سمت سرور
      --local-no-preallocate                                غیرفعال کردن تخصیص پیشاپیش فضای دیسک برای فایل‌های انتقال‌یافته
      --local-no-set-modtime                                غیرفعال کردن تنظیم زمان تغییر
      --local-no-sparse                                     غیرفعال کردن فایل‌های کم‌پشت (sparse) برای بارگیری‌های چندرشته‌ای
      --local-nounc                                         غیرفعال کردن تبدیل UNC (نام‌های طولانی مسیر) در Windows
      --local-time-type mtime|atime|btime|ctime             تعیین نوع زمان بازگردانده‌شده (پیش‌فرض mtime)
      --local-unicode-normalization                         اعمال یکسان‌سازی یونیکد NFC روی مسیرها و نام‌های فایل
      --local-zero-size-links                               صفر فرض کردن اندازهٔ Stat برای پیوندها (و در عوض خواندن آن‌ها) (منسوخ)
      --mailru-auth-url string                              نشانی URL سرور احراز هویت
      --mailru-check-hash                                   عملی که دستور copy در صورت عدم تطابق یا نامعتبر بودن چکسام فایل باید انجام دهد (پیش‌فرض true)
      --mailru-client-credentials                           استفاده از جریان اعتبارسنجی کلاینت OAuth
      --mailru-client-id string                             شناسهٔ کلاینت OAuth
      --mailru-client-secret string                         رمز کلاینت OAuth
      --mailru-description string                           توضیحات ریموت
      --mailru-encoding Encoding                            کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,InvalidUtf8,Dot)
      --mailru-pass string                                  گذرواژه (مبهم‌شده)
      --mailru-speedup-enable                               صرف‌نظر کردن از بارگذاری کامل در صورت وجود فایلی با همان هش داده (پیش‌فرض true)
      --mailru-speedup-file-patterns string                 فهرست جداشده با ویرگول از الگوهای نام فایل واجد شرایط برای افزایش سرعت (قرار دادن با هش) (پیش‌فرض \[dq]*.mkv,*.avi,*.mp4,*.mp3,*.zip,*.gz,*.rar,*.pdf\[dq])
      --mailru-speedup-max-disk SizeSuffix                  این گزینه امکان غیرفعال کردن افزایش سرعت (قرار دادن با هش) را برای فایل‌های بزرگ فراهم می‌کند (پیش‌فرض 3Gi)
      --mailru-speedup-max-memory SizeSuffix                فایل‌های بزرگ‌تر از اندازهٔ ارائه‌شده در زیر همیشه روی دیسک هش می‌شوند (پیش‌فرض 32Mi)
      --mailru-token string                                 توکن دسترسی OAuth به صورت حباب JSON
      --mailru-token-url string                             نشانی URL سرور توکن
      --mailru-user string                                  نام کاربری (معمولاً ایمیل)
      --mega-2fa string                                     کد 2FA حساب MEGA شما در صورتی که حساب با آن تنظیم شده باشد
      --mega-debug                                          ارائهٔ خروجی اشکال‌زدایی بیشتر از Mega
      --mega-description string                             توضیحات ریموت
      --mega-encoding Encoding                              کدگذاری برای بک‌اند (پیش‌فرض Slash,InvalidUtf8,Dot)
      --mega-hard-delete                                    حذف دائمی فایل‌ها به جای انداختن آن‌ها در سطل زباله
      --mega-pass string                                    گذرواژه (مبهم‌شده)
      --mega-use-https                                      استفاده از HTTPS برای انتقال‌ها
      --mega-user string                                    نام کاربری
      --memory-description string                           توضیحات ریموت
      --memory-discard                                      در صورت تنظیم، همهٔ عملیات نوشتن نادیده گرفته شده و خواندن‌ها خطا برمی‌گردانند
      --netstorage-account string                           تنظیم نام حساب NetStorage
      --netstorage-description string                       توضیحات ریموت
      --netstorage-host string                              دامنه+مسیر میزبان NetStorage برای اتصال
      --netstorage-protocol string                          انتخاب بین پروتکل HTTP یا HTTPS (پیش‌فرض \[dq]https\[dq])
      --netstorage-secret string                            تنظیم کلید محرمانه/G2O حساب NetStorage برای احراز هویت (مبهم‌شده)
  -x, --one-file-system                                     عبور نکردن از مرزهای فایل‌سیستم (تنها unix/macOS)
      --onedrive-access-scopes SpaceSepList                 تنظیم دامنه‌های دسترسی مورد درخواست rclone (پیش‌فرض Files.Read Files.ReadWrite Files.Read.All Files.ReadWrite.All Sites.Read.All offline_access)
      --onedrive-auth-url string                            نشانی URL سرور احراز هویت
      --onedrive-av-override                                امکان بارگیری فایل‌هایی که سرور تشخیص ویروس برای آن‌ها داده است
      --onedrive-chunk-size SizeSuffix                      اندازهٔ تکه‌ها برای بارگذاری فایل‌ها \- باید مضربی از 320k (327,680 بایت) باشد (پیش‌فرض 10Mi)
      --onedrive-client-credentials                         استفاده از جریان اعتبارسنجی کلاینت OAuth
      --onedrive-client-id string                           شناسهٔ کلاینت OAuth
      --onedrive-client-secret string                       رمز کلاینت OAuth
      --onedrive-delta                                      در صورت تنظیم، rclone از فهرست‌بندی دلتا برای پیاده‌سازی فهرست‌بندی‌های بازگشتی استفاده خواهد کرد
      --onedrive-description string                         توضیحات ریموت
      --onedrive-drive-id string                            شناسهٔ درایو مورد استفاده
      --onedrive-drive-type string                          نوع درایو (personal | business | documentLibrary)
      --onedrive-encoding Encoding                          کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,LeftSpace,LeftTilde,RightSpace,RightPeriod,InvalidUtf8,Dot)
      --onedrive-expose-onenote-files                       تنظیم برای نمایش فایل‌های OneNote در فهرست‌بندی‌های دایرکتوری
      --onedrive-hard-delete                                حذف دائمی فایل‌ها هنگام پاک کردن
      --onedrive-hash-type string                           مشخص کردن نوع هش مورد استفاده برای بک‌اند (پیش‌فرض \[dq]auto\[dq])
      --onedrive-link-password string                       تنظیم گذرواژه برای پیوندهای ایجادشده با دستور link
      --onedrive-link-scope string                          تنظیم دامنهٔ پیوندهای ایجادشده با دستور link (پیش‌فرض \[dq]anonymous\[dq])
      --onedrive-link-type string                           تنظیم نوع پیوندهای ایجادشده با دستور link (پیش‌فرض \[dq]view\[dq])
      --onedrive-list-chunk int                             اندازهٔ تکهٔ فهرست‌بندی (پیش‌فرض 1000)
      --onedrive-metadata-permissions Bits                  کنترل اینکه آیا مجوزها باید در فراداده خوانده یا نوشته شوند (پیش‌فرض off)
      --onedrive-no-versions                                حذف همهٔ نسخه‌ها در عملیات‌های اصلاحی
      --onedrive-region string                              انتخاب منطقهٔ ابری ملی برای OneDrive (پیش‌فرض \[dq]global\[dq])
      --onedrive-root-folder-id string                      شناسهٔ پوشهٔ ریشه
      --onedrive-server-side-across-configs                 منسوخ: به جای آن از \-\-server\-side\-across\-configs استفاده کنید
      --onedrive-tenant string                              شناسهٔ مستأجر پرینسیپال سرویس؛ همچنین شناسهٔ دایرکتوری آن نیز نامیده می‌شود
      --onedrive-tenant-url string                          نشانی URL مستأجر برای دسترسی غیرمدیریتی به OneDrive
      --onedrive-token string                               توکن دسترسی OAuth به صورت حباب JSON
      --onedrive-token-url string                           نشانی URL سرور توکن
      --onedrive-upload-cutoff SizeSuffix                   آستانه برای جابه‌جایی به بارگذاری تکه‌ای (پیش‌فرض off)
      --oos-attempt-resume-upload                           در صورت true بودن، تلاش برای ازسرگیری بارگذاری چندبخشیِ قبلاً آغازشده برای شیء
      --oos-chunk-size SizeSuffix                           اندازهٔ تکه‌ها برای بارگذاری (پیش‌فرض 5Mi)
      --oos-compartment string                              مشخص کردن OCID بخش (compartment) در صورت نیاز به فهرست کردن باکت‌ها
      --oos-config-file string                              مسیر فایل پیکربندی OCI (پیش‌فرض \[dq]\[ti]/.oci/config\[dq])
      --oos-config-profile string                           نام نمایه درون فایل پیکربندی oci (پیش‌فرض \[dq]Default\[dq])
      --oos-copy-cutoff SizeSuffix                          آستانه برای جابه‌جایی به کپی چندبخشی (پیش‌فرض 4.656Gi)
      --oos-copy-timeout Duration                           زمان انقضای کپی (پیش‌فرض 1m0s)
      --oos-decompress                                      در صورت تنظیم، اشیاء با کدگذاری gzip از حالت فشرده خارج می‌شوند
      --oos-description string                              توضیحات ریموت
      --oos-disable-checksum                                ذخیره نکردن چکسام MD5 به همراه فرادادهٔ شیء
      --oos-encoding Encoding                               کدگذاری برای بک‌اند (پیش‌فرض Slash,InvalidUtf8,Dot)
      --oos-endpoint string                                 نقطهٔ پایانی برای API فضای ذخیره‌سازی شیء
      --oos-leave-parts-on-error                            در صورت true بودن، لغو نکردن فرایند بارگذاری هنگام بروز خطا و باقی گذاشتن تمام بخش‌های بارگذاری‌شدهٔ موفق برای بازیابی دستی
      --oos-max-upload-parts int                            بیشینه تعداد بخش‌ها در یک بارگذاری چندبخشی (پیش‌فرض 10000)
      --oos-namespace string                                فضای نام Object storage
      --oos-no-check-bucket                                 در صورت تنظیم، تلاشی برای بررسی وجود باکت یا ایجاد آن صورت نمی‌گیرد
      --oos-provider string                                 ارائه‌دهندهٔ احراز هویت خود را انتخاب کنید (پیش‌فرض \[dq]env_auth\[dq])
      --oos-region string                                   منطقهٔ Object storage
      --oos-sse-customer-algorithm string                   در صورت استفاده از SSE-C، هدر اختیاری که \[dq]AES256\[dq] را به عنوان الگوریتم رمزنگاری مشخص می‌کند
      --oos-sse-customer-key string                         برای استفاده از SSE-C، هدر اختیاری که کلید رمزنگاری ۲۵۶ بیتی کدگذاری‌شده با base64 را مشخص می‌کند
      --oos-sse-customer-key-file string                    برای استفاده از SSE-C، فایلی شامل رشتهٔ کدگذاری‌شده با base64 از کلید رمزنگاری AES-256 مرتبط
      --oos-sse-customer-key-sha256 string                  در صورت استفاده از SSE-C، هدر اختیاری که هش SHA256 کدگذاری‌شده با base64 کلید رمزنگاری را مشخص می‌کند
      --oos-sse-kms-key-id string                           در صورت استفاده از کلید اصلی خود در vault، این هدر مشخص‌کنندهٔ آن است
      --oos-storage-tier string                             کلاس ذخیره‌سازی مورد استفاده هنگام ذخیرهٔ اشیاء جدید در فضای ذخیره‌سازی. https://docs.oracle.com/en-us/iaas/Content/Object/Concepts/understandingstoragetiers.htm (پیش‌فرض \[dq]Standard\[dq])
      --oos-upload-concurrency int                          هم‌زمانی برای بارگذاری‌های چندبخشی (پیش‌فرض 10)
      --oos-upload-cutoff SizeSuffix                        آستانه برای جابه‌جایی به بارگذاری تکه‌ای (پیش‌فرض 200Mi)
      --opendrive-access string                             فایل‌ها و پوشه‌ها با این مجوز دسترسی بارگذاری خواهند شد (پیش‌فرض private) (پیش‌فرض \[dq]private\[dq])
      --opendrive-chunk-size SizeSuffix                     فایل‌ها در تکه‌هایی با این اندازه بارگذاری خواهند شد (پیش‌فرض 10Mi)
      --opendrive-description string                        توضیحات ریموت
      --opendrive-encoding Encoding                         کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,LeftSpace,LeftCrLfHtVt,RightSpace,RightCrLfHtVt,InvalidUtf8,Dot)
      --opendrive-password string                           گذرواژه (مبهم‌شده)
      --opendrive-username string                           نام کاربری
      --pcloud-auth-url string                              نشانی URL سرور احراز هویت
      --pcloud-client-credentials                           استفاده از جریان اعتبارسنجی کلاینت OAuth
      --pcloud-client-id string                             شناسهٔ کلاینت OAuth
      --pcloud-client-secret string                         رمز کلاینت OAuth
      --pcloud-description string                           توضیحات ریموت
      --pcloud-encoding Encoding                            کدگذاری برای بک‌اند (پیش‌فرض Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
      --pcloud-hostname string                              نام میزبان برای اتصال (پیش‌فرض \[dq]api.pcloud.com\[dq])
      --pcloud-password string                              گذرواژهٔ pcloud شما (مبهم‌شده)
      --pcloud-root-folder-id string                        این مورد را پر کنید تا rclone از یک پوشهٔ غیرریشه به عنوان نقطهٔ شروع استفاده کند (پیش‌فرض \[dq]d0\[dq])
      --pcloud-token string                                 توکن دسترسی OAuth به صورت حباب JSON
      --pcloud-token-url string                             نشانی URL سرور توکن
      --pcloud-username string                              نام کاربری pcloud شما
      --pikpak-chunk-size SizeSuffix                        اندازهٔ تکه‌ها برای بارگذاری‌های چندبخشی (پیش‌فرض 5Mi)
      --pikpak-description string                           توضیحات ریموت
      --pikpak-device-id string                             شناسهٔ دستگاه مورد استفاده برای مجوزدهی
      --pikpak-encoding Encoding                            کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Ctl,LeftSpace,RightSpace,RightPeriod,InvalidUtf8,Dot)
      --pikpak-hash-memory-limit SizeSuffix                 فایل‌های بزرگ‌تر از این اندازه برای محاسبهٔ هش در صورت نیاز، روی دیسک کش می‌شوند (پیش‌فرض 10Mi)
      --pikpak-no-media-link                                استفاده از پیوندهای اصلی فایل به جای پیوندهای چندرسانه‌ای
      --pikpak-pass string                                  گذرواژهٔ Pikpak (مبهم‌شده)
      --pikpak-root-folder-id string                        شناسهٔ پوشهٔ ریشه
      --pikpak-trashed-only                                 تنها نمایش فایل‌هایی که در سطل زباله هستند
      --pikpak-upload-concurrency int                       هم‌زمانی برای بارگذاری‌های چندبخشی (پیش‌فرض 4)
      --pikpak-upload-cutoff SizeSuffix                     آستانه برای جابه‌جایی به بارگذاری تکه‌ای (پیش‌فرض 200Mi)
      --pikpak-use-trash                                    ارسال فایل‌ها به سطل زباله به جای حذف دائمی (پیش‌فرض true)
      --pikpak-user string                                  نام کاربری Pikpak
      --pikpak-user-agent string                            عامل کاربر (User Agent) HTTP برای pikpak (پیش‌فرض \[dq]Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:129.0) Gecko/20100101 Firefox/129.0\[dq])
      --pixeldrain-api-key string                           کلید API برای حساب pixeldrain شما
      --pixeldrain-api-url string                           نقطهٔ پایانی API برای اتصال. در بیشتر موارد دست‌نخورده گذاشتن آن مشکلی ایجاد نمی‌کند (پیش‌فرض \[dq]https://pixeldrain.com/api\[dq])
      --pixeldrain-description string                       توضیحات ریموت
      --pixeldrain-root-folder-id string                    ریشهٔ فایل‌سیستم مورد استفاده (پیش‌فرض \[dq]me\[dq])
      --premiumizeme-auth-url string                        نشانی URL سرور احراز هویت
      --premiumizeme-client-credentials                     استفاده از جریان اعتبارسنجی کلاینت OAuth
      --premiumizeme-client-id string                       شناسهٔ کلاینت OAuth
      --premiumizeme-client-secret string                   رمز کلاینت OAuth
      --premiumizeme-description string                     توضیحات ریموت
      --premiumizeme-encoding Encoding                      کدگذاری برای بک‌اند (پیش‌فرض Slash,DoubleQuote,BackSlash,Del,Ctl,InvalidUtf8,Dot)
      --premiumizeme-token string                           توکن دسترسی OAuth به صورت حباب JSON
      --premiumizeme-token-url string                       نشانی URL سرور توکن
      --protondrive-2fa string                              کد 2FA
      --protondrive-app-version string                      رشتهٔ نسخهٔ برنامه
      --protondrive-description string                      توضیحات ریموت
      --protondrive-enable-caching                          کش کردن فرادادهٔ فایل‌ها و پوشه‌ها جهت کاهش فراخوانی‌های API (پیش‌فرض true)
      --protondrive-encoding Encoding                       کدگذاری برای بک‌اند (پیش‌فرض Slash,LeftSpace,RightSpace,InvalidUtf8,Dot)
      --protondrive-mailbox-password string                 گذرواژهٔ صندوق پستی حساب دومرحله‌ای proton شما (مبهم‌شده)
      --protondrive-original-file-size                      بازگرداندن اندازهٔ فایل پیش از رمزنگاری (پیش‌فرض true)
      --protondrive-otp-secret-key string                   کلید مخفی OTP (مبهم‌شده)
      --protondrive-password string                         گذرواژهٔ حساب proton شما (مبهم‌شده)
      --protondrive-replace-existing-draft                  ایجاد نسخهٔ جدید در صورت تشخیص تداخل نام فایل
      --protondrive-username string                         نام کاربری حساب proton شما
      --putio-auth-url string                               نشانی URL سرور احراز هویت
      --putio-client-credentials                            استفاده از جریان اعتبارسنجی کلاینت OAuth
      --putio-client-id string                              شناسهٔ کلاینت OAuth
      --putio-client-secret string                          رمز کلاینت OAuth
      --putio-description string                            توضیحات ریموت--putio-encoding Encoding                             کدگذاری برای بک‌اند (پیش‌فرض Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
      --putio-token string                                  توکن دسترسی OAuth به‌صورت یک blob جی‌سان
      --putio-token-url string                              نشانی URL سرور توکن
      --qingstor-access-key-id string                       شناسه کلید دسترسی QingStor
      --qingstor-chunk-size SizeSuffix                      اندازه تکه برای استفاده در بارگذاری (پیش‌فرض 4Mi)
      --qingstor-connection-retries int                     تعداد تلاش‌های مجدد اتصال (پیش‌فرض 3)
      --qingstor-description string                         توضیحات ریموت
      --qingstor-encoding Encoding                          کدگذاری برای بک‌اند (پیش‌فرض Slash,Ctl,InvalidUtf8)
      --qingstor-endpoint string                            نشانی URL نقطه پایانی برای اتصال به API کینگ‌استور (QingStor)
      --qingstor-env-auth                                   دریافت اعتبارنامه‌های QingStor از محیط زمان اجرا
      --qingstor-secret-access-key string                   کلید دسترسی محرمانه QingStor (گذرواژه)
      --qingstor-upload-concurrency int                     هم‌زمانی برای بارگذاری‌های چندبخشی (پیش‌فرض 1)
      --qingstor-upload-cutoff SizeSuffix                   حد آستانه برای جابه‌جایی به بارگذاری تکه‌ای (پیش‌فرض 200Mi)
      --qingstor-zone string                                منطقه (Zone) برای اتصال
      --quatrix-api-key string                              کلید API برای دسترسی به حساب Quatrix
      --quatrix-description string                          توضیحات ریموت
      --quatrix-effective-upload-time string                زمان بارگذاری مطلوب برای یک تکه (پیش‌فرض \[dq]4s\[dq])
      --quatrix-encoding Encoding                           کدگذاری برای بک‌اند (پیش‌فرض Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
      --quatrix-hard-delete                                 حذف دائمی فایل‌ها به جای انتقال آن‌ها به سطل زباله
      --quatrix-host string                                 نام میزبان حساب Quatrix
      --quatrix-maximal-summary-chunk-size SizeSuffix       حداکثر مجموع تمام تکه‌ها؛ نباید کمتر از \[aq]transfers\[aq]*\[aq]minimal_chunk_size\[aq] باشد (پیش‌فرض 95.367Mi)
      --quatrix-minimal-chunk-size SizeSuffix               حداقل اندازه برای یک تکه (پیش‌فرض 9.537Mi)
      --quatrix-skip-project-folders                        نادیده گرفتن پوشه‌های پروژه در عملیات‌ها
      --s3-access-key-id string                             شناسه کلید دسترسی AWS
      --s3-acl string                                       فهرست کنترل دسترسی از پیش‌آماده (Canned ACL) مورد استفاده هنگام ساخت باکت‌ها و ذخیره یا رونوشت اشیاء
      --s3-bucket-acl string                                فهرست کنترل دسترسی از پیش‌آماده (Canned ACL) مورد استفاده هنگام ساخت باکت‌ها
      --s3-bucket-object-lock-enabled                       فعال‌سازی قفل شیء (Object Lock) هنگام ایجاد باکت‌های جدید
      --s3-bypass-governance-retention                      اجازه حذف یا ویرایش اشیاء قفل‌شده با حالت GOVERNANCE
      --s3-chunk-size SizeSuffix                            اندازه تکه مورد استفاده برای بارگذاری (پیش‌فرض 5Mi)
      --s3-copy-cutoff SizeSuffix                           حد آستانه برای جابه‌جایی به رونوشت چندبخشی (پیش‌فرض 4.656Gi)
      --s3-decompress                                       در صورت تنظیم، اشیاء کدگذاری‌شده با gzip را از حالت فشرده خارج می‌کند
      --s3-description string                               توضیحات ریموت
      --s3-directory-bucket                                 تنظیم برای استفاده از باکت‌های دایرکتوری AWS
      --s3-directory-markers                                بارگذاری یک شیء خالی با اسلش در انتها هنگام ایجاد دایرکتوری جدید
      --s3-disable-checksum                                 عدم ذخیره جمع مقابله‌ای MD5 به همراه فراداده‌های شیء
      --s3-disable-http2                                    غیرفعال‌سازی استفاده از http2 برای بک‌اندهای S3
      --s3-download-url string                              نقطه پایانی سفارشی برای بارگیری‌ها
      --s3-encoding Encoding                                کدگذاری برای بک‌اند (پیش‌فرض Slash,InvalidUtf8,Dot)
      --s3-endpoint string                                  نقطه پایانی برای S3 API
      --s3-env-auth                                         دریافت اعتبارنامه‌های AWS از محیط زمان اجرا (متغیرهای محیطی یا فراداده‌های EC2/ECS در صورت نبود متغیرها)
      --s3-force-path-style                                 در صورت true استفاده از سبک دسترسی مسیری و در صورت false استفاده از سبک میزبانی مجازی (پیش‌فرض true)
      --s3-ibm-api-key string                               کلید API آی‌بی‌ام برای دریافت توکن IAM
      --s3-ibm-iam-endpoint string                          نقطه پایانی IBM IAM مورد استفاده برای احراز هویت
      --s3-ibm-resource-instance-id string                  شناسه نمونه سرویس IBM
      --s3-leave-parts-on-error                             در صورت true، خودداری از فراخوانی لغو بارگذاری هنگام بروز خطا و باقی گذاشتن تمام بخش‌های بارگذاری‌شده روی S3 برای بازیابی دستی
      --s3-list-chunk int                                   اندازه تکه فهرست‌بندی (پاسخ فهرست برای هر درخواست ListObject در S3) (پیش‌فرض 1000)
      --s3-list-url-encode Tristate                         کدگذاری درگاه وبی (URL encode) فهرست‌ها: true/false/unset (پیش‌فرض unset)
      --s3-list-version int                                 نسخه ListObjects مورد استفاده: 1، 2 یا 0 برای خودکار
      --s3-list-versions-oldest-first Tristate              تنظیم در صورتی که بک‌اند نسخه‌های شیء را از قدیمی‌ترین بازگرداند (پیش‌فرض unset)
      --s3-location-constraint string                       محدودیت مکانی - باید منطبق با Region تنظیم شود
      --s3-max-upload-parts int                             حداکثر تعداد بخش‌ها در یک بارگذاری چندبخشی (پیش‌فرض 10000)
      --s3-might-gzip Tristate                              این گزینه را در صورتی تنظیم کنید که ممکن است بک‌اند اشیاء را با gzip فشرده کند (پیش‌فرض unset)
      --s3-no-check-bucket                                  در صورت تنظیم، تلاشی برای بررسی وجود باکت یا ایجاد آن صورت نمی‌گیرد
      --s3-no-head                                          در صورت تنظیم، عدم ارسال درخواست HEAD برای بررسی یکپارچگی اشیاء بارگذاری‌شده
      --s3-no-head-object                                   در صورت تنظیم، عدم اجرای HEAD قبل از GET هنگام دریافت اشیاء
      --s3-no-system-metadata                               جلوگیری از تنظیم و خواندن فراداده‌های سیستمی
      --s3-object-lock-legal-hold-status string             وضعیت توقیف قانونی (legal hold) قفل شیء برای اعمال هنگام بارگذاری یا رونوشت اشیاء
      --s3-object-lock-mode string                          حالت Object Lock برای اعمال هنگام بارگذاری یا رونوشت اشیاء
      --s3-object-lock-retain-until-date string             تاریخ نگه‌داری قفل شیء برای اعمال هنگام بارگذاری یا رونوشت اشیاء
      --s3-object-lock-set-after-upload                     تنظیم قفل شیء از طریق فراخوانی‌های جداگانه API پس از بارگذاری
      --s3-object-lock-supported Tristate                   اینکه آیا ارائه‌دهنده از S3 Object Lock پشتیبانی می‌کند یا خیر (پیش‌فرض unset)
      --s3-profile string                                   پروفایل مورد استفاده در فایل مشترک اعتبارنامه‌ها
      --s3-provider string                                  انتخاب ارائه‌دهنده S3
      --s3-region string                                    منطقه (Region) برای اتصال
      --s3-requester-pays                                   فعال‌سازی گزینه پرداخت توسط درخواست‌کننده هنگام تعامل با باکت S3
      --s3-role-arn string                                  شناسه ARN مربوط به نقش IAM برای واگذاری (assume)
      --s3-role-external-id string                          شناسه خارجی (External ID) برای نقش واگذارشده
      --s3-role-session-duration string                     مدت نشست برای نقش واگذارشده
      --s3-role-session-name string                         نام نشست برای نقش واگذارشده
      --s3-sdk-log-mode Bits                                تنظیم برای اشکال‌زدایی SDK (پیش‌فرض Off)
      --s3-secret-access-key string                         کلید دسترسی محرمانه AWS (گذرواژه)
      --s3-server-side-encryption string                    الگوریتم رمزنگاری سمت سرور مورد استفاده هنگام ذخیره این شیء در S3
      --s3-session-token string                             یک توکن نشست AWS
      --s3-shared-credentials-file string                   مسیر فایل مشترک اعتبارنامه‌ها
      --s3-sign-accept-encoding Tristate                    تنظیم در صورتی که rclone باید Accept-Encoding را به عنوان بخشی از امضا بگنجاند (پیش‌فرض unset)
      --s3-sse-customer-algorithm string                    در صورت استفاده از SSE-C، الگوریتم رمزنگاری سمت سرور مورد استفاده هنگام ذخیره این شیء در S3
      --s3-sse-customer-key string                          برای استفاده از SSE-C می‌توانید کلید رمزنگاری محرمانه برای رمزگذاری/رمزگشایی داده‌های خود را ارائه دهید
      --s3-sse-customer-key-base64 string                   در صورت استفاده از SSE-C باید کلید رمزنگاری محرمانه کدگذاری‌شده در قالب base64 را برای رمزگذاری/رمزگشایی داده‌ها مشخص کنید
      --s3-sse-customer-key-md5 string                      در صورت استفاده از SSE-C می‌توانید جمع مقابله‌ای MD5 کلید رمزنگاری محرمانه را ارائه دهید (اختیاری)
      --s3-sse-kms-key-id string                            در صورت استفاده از شناسه KMS، باید ARN کلید را ارائه دهید
      --s3-storage-class string                             کلاس ذخیره‌سازی مورد استفاده هنگام ذخیره اشیاء جدید در S3
      --s3-upload-concurrency int                           هم‌زمانی برای بارگذاری‌ها و رونوشت‌های چندبخشی (پیش‌فرض 4)
      --s3-upload-cutoff SizeSuffix                         حد آستانه برای جابه‌جایی به بارگذاری تکه‌ای (پیش‌فرض 200Mi)
      --s3-use-accelerate-endpoint                          در صورت true، استفاده از نقطه پایانی پرسرعت (accelerated) در AWS S3
      --s3-use-accept-encoding-gzip Accept-Encoding: gzip   ارسال یا عدم ارسال سرآیند Accept-Encoding: gzip (پیش‌فرض unset)
      --s3-use-already-exists Tristate                      تنظیم در صورتی که rclone باید خطاهای BucketAlreadyExists را هنگام ساخت باکت گزارش کند (پیش‌فرض unset)
      --s3-use-arn-region                                   در صورت true، پشتیبانی از arn region را برای سرویس فعال می‌کند
      --s3-use-data-integrity-protections Tristate          در صورت true، استفاده از محافظت‌های یکپارچگی داده AWS S3 (پیش‌فرض unset)
      --s3-use-dual-stack                                   در صورت true، استفاده از نقطه پایانی دوپشته‌ای AWS S3 (پشتیبانی از IPv6)
      --s3-use-multipart-etag Tristate                      استفاده از ETag در بارگذاری‌های چندبخشی برای اعتبارسنجی (پیش‌فرض unset)
      --s3-use-multipart-uploads Tristate                   تنظیم در صورتی که rclone باید از بارگذاری‌های چندبخشی استفاده کند (پیش‌فرض unset)
      --s3-use-presigned-request                            استفاده از درخواست از پیش امضاشده یا PutObject برای بارگذاری‌های تک‌بخشی
      --s3-use-unsigned-payload Tristate                    استفاده از بار داده بدون امضا در PutObject (پیش‌فرض unset)
      --s3-use-x-id Tristate                                تنظیم در صورتی که rclone باید پارامترهای نشانی وب x-id را اضافه کند (پیش‌فرض unset)
      --s3-v2-auth                                          در صورت true، استفاده از احراز هویت نسخه ۲ (v2)
      --s3-version-at Time                                  نمایش نسخه‌های فایل همان‌طور که در زمان مشخص‌شده بودند (پیش‌فرض off)
      --s3-version-deleted                                  نمایش نشانگرهای فایل حذف‌شده هنگام استفاده از نسخه‌ها
      --s3-versions                                         گنجاندن نسخه‌های قدیمی در فهرست‌های دایرکتوری
      --seafile-2fa                                         احراز هویت دومرحله‌ای (مقدار \[aq]true\[aq] اگر حساب دارای 2FA فعال باشد)
      --seafile-create-library                              ایجاد کتابخانه توسط rclone در صورت عدم وجود آن
      --seafile-description string                          توضیحات ریموت
      --seafile-encoding Encoding                           کدگذاری برای بک‌اند (پیش‌فرض Slash,DoubleQuote,BackSlash,Ctl,InvalidUtf8,Dot)
      --seafile-library string                              نام کتابخانه
      --seafile-library-key string                          گذرواژه کتابخانه (فقط برای کتابخانه‌های رمزگذاری‌شده) (مبهم)
      --seafile-pass string                                 گذرواژه (مبهم)
      --seafile-url string                                  نشانی URL میزبان seafile برای اتصال
      --seafile-user string                                 نام کاربری (معمولاً آدرس ایمیل)
      --sftp-ask-password                                   اجازه درخواست گذرواژه SFTP در صورت نیاز
      --sftp-blake3sum-command string                       دستور مورد استفاده برای خواندن درهم‌سازهای BLAKE3
      --sftp-chunk-size SizeSuffix                          اندازه تکه برای بارگذاری و بارگیری (پیش‌فرض 32Ki)
      --sftp-ciphers SpaceSepList                           فهرست جداشده با فاصله از رمزها برای رمزگذاری نشست، به ترتیب اولویت
      --sftp-concurrency int                                حداکثر تعداد درخواست‌های در حال انتظار برای یک فایل (پیش‌فرض 64)
      --sftp-connections int                                حداکثر تعداد اتصالات هم‌زمان SFTP، مقدار 0 برای نامحدود
      --sftp-copy-is-hardlink                               تنظیم برای فعال‌سازی رونوشت‌های سمت سرور با استفاده از پیوندهای سخت (hardlink)
      --sftp-crc32sum-command string                        دستور مورد استفاده برای خواندن درهم‌سازهای CRC-32
      --sftp-description string                             توضیحات ریموت
      --sftp-disable-concurrent-reads                       در صورت تنظیم، عدم استفاده از خواندن‌های هم‌زمان
      --sftp-disable-concurrent-writes                      در صورت تنظیم، عدم استفاده از نوشتن‌های هم‌زمان
      --sftp-disable-hashcheck                              غیرفعال‌سازی اجرای دستورهای SSH برای تعیین در دسترس بودن درهم‌سازی فایل‌های ریموت
      --sftp-encoding Encoding                              کدگذاری برای بک‌اند (پیش‌فرض Slash,Del,Ctl,Dot)
      --sftp-hashes CommaSepList                            فهرست جداشده با کاما از انواع جمع‌های مقابله‌ای پشتیبانی‌شده
      --sftp-host string                                    میزبان SSH برای اتصال
      --sftp-host-key-algorithms SpaceSepList               فهرست جداشده با فاصله از الگوریتم‌های کلید میزبان، به ترتیب اولویت
      --sftp-host-keys CommaSepList                         کلیدهای میزبان پین‌شده برای این ریموت، مورد استفاده برای تأیید سرور
      --sftp-http-proxy string                              نشانی URL برای پراکسی HTTP CONNECT
      --sftp-idle-timeout Duration                          حداکثر زمان پیش از بستن اتصالات بیکار (پیش‌فرض 1m0s)
      --sftp-key-exchange SpaceSepList                      فهرست جداشده با فاصله از الگوریتم‌های تبادل کلید، به ترتیب اولویت
      --sftp-key-file string                                مسیر فایل کلید خصوصی کدگذاری‌شده با PEM
      --sftp-key-file-pass string                           عبارت عبور برای رمزگشایی فایل کلید خصوصی کدگذاری‌شده با PEM (مبهم)
      --sftp-key-pem string                                 کلید خصوصی خام با کدگذاری PEM
      --sftp-key-use-agent                                  در صورت تنظیم، استفاده از ssh-agent را اجباری می‌کند
      --sftp-known-hosts-file string                        مسیر اختیاری به فایل known_hosts
      --sftp-macs SpaceSepList                              فهرست جداشده با فاصله از الگوریتم‌های MAC (کد اصالت‌سنجی پیام)، به ترتیب اولویت
      --sftp-md5sum-command string                          دستور مورد استفاده برای خواندن درهم‌سازهای MD5
      --sftp-pass string                                    گذرواژه SSH؛ برای استفاده از ssh-agent خالی بگذارید (مبهم)
      --sftp-path-override string                           بازنویسی مسیر مورد استفاده توسط دستورهای پوسته SSH
      --sftp-pin-host-key                                   پین کردن کلید میزبان سرور در اولین اتصال (اعتماد در اولین استفاده یا TOFU)
      --sftp-port int                                       شماره درگاه SSH (پیش‌فرض 22)
      --sftp-pubkey string                                  گواهی عمومی SSH برای احراز هویت مبتنی بر گواهی عمومی
      --sftp-pubkey-file string                             مسیر اختیاری به فایل کلید عمومی
      --sftp-server-command string                          مسیر یا دستور را برای اجرای سرور sftp در میزبان دوردست مشخص می‌کند
      --sftp-set-env SpaceSepList                           متغیرهای محیطی برای ارسال به sftp و دستورها
      --sftp-set-modtime                                    در صورت تنظیم، زمان ویرایش روی ریموت تنظیم می‌شود (پیش‌فرض true)
      --sftp-sha1sum-command string                         دستور مورد استفاده برای خواندن درهم‌سازهای SHA-1
      --sftp-sha256sum-command string                       دستور مورد استفاده برای خواندن درهم‌سازهای SHA-256
      --sftp-shell-type string                              نوع پوسته SSH در سرور ریموت، در صورت وجود
      --sftp-skip-links                                     تنظیم برای صرف‌نظر از تمام پیوندهای نمادین و سایر فایل‌های غیرعادی
      --sftp-socks-proxy string                             میزبان پراکسی Socks 5
      --sftp-ssh SpaceSepList                               مسیر و آرگومان‌های باینری خارجی ssh
      --sftp-subsystem string                               زیرسیستم SSH2 را در میزبان ریموت مشخص می‌کند (پیش‌فرض \[dq]sftp\[dq])
      --sftp-use-fstat                                      در صورت تنظیم، استفاده از fstat به جای stat
      --sftp-use-insecure-cipher                            فعال‌سازی استفاده از رمزها و روش‌های تبادل کلید ناامن
      --sftp-user string                                    نام کاربری SSH (پیش‌فرض \[dq]$USER\[dq])
      --sftp-xxh128sum-command string                       دستور مورد استفاده برای خواندن درهم‌سازهای XXH128
      --sftp-xxh3sum-command string                         دستور مورد استفاده برای خواندن درهم‌سازهای XXH3
      --shade-api-key string                                یک کلید API برای حساب شما
      --shade-chunk-size SizeSuffix                         اندازه تکه مورد استفاده برای بارگذاری (پیش‌فرض 64Mi)
      --shade-description string                            توضیحات ریموت
      --shade-drive-id string                               شناسه درایو شما، این مورد در تنظیمات درایو قابل مشاهده است. پیکربندی‌های جداگانه rclone باید برای هر درایو ایجاد شوند
      --shade-encoding Encoding                             کدگذاری برای بک‌اند (پیش‌فرض Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
      --shade-endpoint string                               نقطه پایانی برای سرویس
      --shade-max-upload-parts int                          حداکثر تعداد بخش‌ها در یک بارگذاری چندبخشی (پیش‌فرض 10000)
      --shade-token string                                  توکن JWT برای انجام عملیات Shade FS. این مقدار را تنظیم نکنید - rclone آن را به‌طور خودکار تنظیم خواهد کرد
      --shade-token-expiry string                           زمان انقضای توکن JWT. این مقدار را تنظیم نکنید - rclone آن را به‌طور خودکار تنظیم خواهد کرد
      --shade-upload-concurrency int                        هم‌زمانی برای بارگذاری‌ها و رونوشت‌های چندبخشی. این تعداد تکه‌های همان فایل است که به صورت هم‌زمان بارگذاری می‌شوند (پیش‌فرض 4)
      --sharefile-auth-url string                           نشانی URL سرور احراز هویت
      --sharefile-chunk-size SizeSuffix                     اندازه تکه بارگذاری (پیش‌فرض 64Mi)
      --sharefile-client-credentials                        استفاده از گردش کار اعتبارات کارخواه (Client Credentials) در OAuth
      --sharefile-client-id string                          شناسه کلاینت OAuth
      --sharefile-client-secret string                      رمز کلاینت OAuth
      --sharefile-description string                        توضیحات ریموت
      --sharefile-encoding Encoding                         کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Ctl,LeftSpace,LeftPeriod,RightSpace,RightPeriod,InvalidUtf8,Dot)
      --sharefile-endpoint string                           نقطه پایانی برای فراخوانی‌های API
      --sharefile-root-folder-id string                     شناسه پوشه ریشه
      --sharefile-token string                              توکن دسترسی OAuth به‌صورت یک blob جی‌سان
      --sharefile-token-url string                          نشانی URL سرور توکن
      --sharefile-upload-cutoff SizeSuffix                  حد آستانه برای جابه‌جایی به بارگذاری چندبخشی (پیش‌فرض 128Mi)
      --sia-api-password string                             گذرواژه API دیمن Sia (مبهم)
      --sia-api-url string                                  نشانی URL مربوط به API دیمن Sia مانند http://sia.daemon.host:9980 (پیش‌فرض \[dq]http://127.0.0.1:9980\[dq])
      --sia-description string                              توضیحات ریموت
      --sia-encoding Encoding                               کدگذاری برای بک‌اند (پیش‌فرض Slash,Question,Hash,Percent,Del,Ctl,InvalidUtf8,Dot)
      --sia-user-agent string                               عامل کاربر Siad (پیش‌فرض \[dq]Sia-Agent\[dq])
      --skip-links                                          عدم هشدار درباره پیوندهای نمادین نادیده‌گرفته‌شده
      --skip-specials                                       عدم هشدار درباره لوله‌ها (pipes)، سوکت‌ها و اشیاء دستگاهیِ نادیده‌گرفته‌شده
      --smb-case-insensitive                                اینکه آیا سرور طوری پیکربندی شده که به بزرگی و کوچکی حروف حساس نباشد (پیش‌فرض true)
      --smb-description string                              توضیحات ریموت
      --smb-domain string                                   نام دامنه برای احراز هویت NTLM (پیش‌فرض \[dq]WORKGROUP\[dq])
      --smb-encoding Encoding                               کدگذاری برای بک‌اند (پیش‌فرض Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Ctl,RightSpace,RightPeriod,InvalidUtf8,Dot)
      --smb-hide-special-share                              پنهان‌سازی اشتراک‌های ویژه (مانند $print) که کاربران نباید به آن‌ها دسترسی داشته باشند (پیش‌فرض true)
      --smb-host string                                     نام میزبان سرور SMB برای اتصال
      --smb-idle-timeout Duration                           حداکثر زمان پیش از بستن اتصالات بیکار (پیش‌فرض 1m0s)
      --smb-kerberos-ccache string                          مسیر حافظه موقت اعتبارنامه کربروس (krb5cc)
      --smb-pass string                                     گذرواژه SMB (مبهم)
      --smb-port int                                        شماره درگاه SMB (پیش‌فرض 445)
      --smb-spn string                                      نام اصلی سرویس (SPN)
      --smb-use-kerberos                                    استفاده از احراز هویت Kerberos
      --smb-user string                                     نام کاربری SMB (پیش‌فرض \[dq]$USER\[dq])
      --storj-access-grant string                           مجوز دسترسی (Access grant)
      --storj-api-key string                                کلید API
      --storj-description string                            توضیحات ریموت
      --storj-passphrase string                             عبارت عبور رمزنگاری
      --storj-provider string                               انتخاب یک روش احراز هویت (پیش‌فرض \[dq]existing\[dq])
      --storj-satellite-address string                      آدرس ماهواره (پیش‌فرض \[dq]us1.storj.io\[dq])
      --sugarsync-access-key-id string                      شناسه کلید دسترسی Sugarsync
      --sugarsync-app-id string                             شناسه برنامه Sugarsync
      --sugarsync-authorization string                      مجوز Sugarsync
      --sugarsync-authorization-expiry string               انقضای مجوز Sugarsync
      --sugarsync-deleted-id string                         شناسه پوشه حذف‌شده در Sugarsync
      --sugarsync-description string                        توضیحات ریموت
      --sugarsync-encoding Encoding                         کدگذاری برای بک‌اند (پیش‌فرض Slash,Ctl,InvalidUtf8,Dot)
      --sugarsync-hard-delete                               حذف دائمی فایل‌ها در صورت مقدار درست
      --sugarsync-private-access-key string                 کلید دسترسی خصوصی Sugarsync
      --sugarsync-refresh-token string                      توکن نوسازی Sugarsync
      --sugarsync-root-id string                            شناسه ریشه Sugarsync
      --sugarsync-user string                               کاربر Sugarsync
      --swift-application-credential-id string              شناسه اعتبارنامه برنامه (OS_APPLICATION_CREDENTIAL_ID)
      --swift-application-credential-name string            نام اعتبارنامه برنامه (OS_APPLICATION_CREDENTIAL_NAME)
      --swift-application-credential-secret string          رمز اعتبارنامه برنامه (OS_APPLICATION_CREDENTIAL_SECRET)
      --swift-auth string                                   نشانی URL احراز هویت برای سرور (OS_AUTH_URL)
      --swift-auth-token string                             توکن احراز هویت از روش دیگر احراز هویت - اختیاری (OS_AUTH_TOKEN)
      --swift-auth-version int                              نسخه احراز هویت - اختیاری - در صورتی که URL فاقد شماره نسخه است روی (1,2,3) تنظیم شود (ST_AUTH_VERSION)
      --swift-chunk-size SizeSuffix                         فایل‌های بزرگ‌تر از این اندازه تکه‌تکه خواهند شد (پیش‌فرض 5Gi)
      --swift-description string                            توضیحات ریموت
      --swift-domain string                                 دامنه کاربر - اختیاری (احراز هویت v3) (OS_USER_DOMAIN_NAME)
      --swift-encoding Encoding                             کدگذاری برای بک‌اند (پیش‌فرض Slash,InvalidUtf8)
      --swift-endpoint-type string                          نوع نقطه پایانی برای انتخاب از کاتالوگ سرویس (OS_ENDPOINT_TYPE) (پیش‌فرض \[dq]public\[dq])
      --swift-env-auth                                      دریافت اعتبارنامه‌های swift از متغیرهای محیطی در قالب استاندارد OpenStack
      --swift-fetch-until-empty-page                        هنگام صفحه‌بندی، همیشه دریافت کن مگر اینکه یک صفحه خالی بازگردانده شود
      --swift-key string                                    کلید API یا گذرواژه (OS_PASSWORD)
      --swift-leave-parts-on-error                          در صورت true، خودداری از فراخوانی لغو بارگذاری هنگام بروز خطا
      --swift-no-chunk                                      عدم تقسیم فایل‌ها به تکه‌ها هنگام بارگذاری جریانی
      --swift-no-large-objects                              غیرفعال‌سازی پشتیبانی از اشیاء بزرگ ایستا و پویا
      --swift-partial-page-fetch-threshold int              هنگام صفحه‌بندی، در صورتی که صفحه کنونی در این درصد از حد مجاز باشد، دریافت کن
      --swift-region string                                 نام منطقه - اختیاری (OS_REGION_NAME)
      --swift-storage-policy string                         سیاست ذخیره‌سازی مورد استفاده هنگام ایجاد یک کانتینر جدید
      --swift-storage-url string                            نشانی URL فضای ذخیره‌سازی - اختیاری (OS_STORAGE_URL)
      --swift-tenant string                                 نام مستأجر - اختیاری برای احراز هویت v1، در غیر این صورت این مورد یا tenant_id الزامی است (OS_TENANT_NAME یا OS_PROJECT_NAME)
      --swift-tenant-domain string                          دامنه مستأجر - اختیاری (احراز هویت v3) (OS_PROJECT_DOMAIN_NAME)
      --swift-tenant-id string                              شناسه مستأجر - اختیاری برای احراز هویت v1، در غیر این صورت این مورد یا tenant الزامی است (OS_TENANT_ID)
      --swift-use-segments-container Tristate               انتخاب مقصد برای بخش‌های اشیاء بزرگ (پیش‌فرض unset)
      --swift-user string                                   نام کاربری برای ورود (OS_USERNAME)
      --swift-user-id string                                شناسه کاربر برای ورود - اختیاری - اکثر سیستم‌های swift از کاربر استفاده کرده و این را خالی می‌گذارند (احراز هویت v3) (OS_USER_ID)
      --ulozto-app-token string                             توکن برنامه جهت شناسایی برنامه. کلید API برنامه را می‌توان در API یافت
      --ulozto-description string                           توضیحات ریموت
      --ulozto-encoding Encoding                            کدگذاری برای بک‌اند (پیش‌فرض Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot)
      --ulozto-list-page-size int                           اندازه یک صفحه منفرد برای دستورهای فهرست. ۱-۵۰۰ (پیش‌فرض 500)
      --ulozto-password string                              گذرواژه کاربر (مبهم)
      --ulozto-root-folder-slug string                      در صورت تنظیم، rclone از این پوشه به عنوان پوشه ریشه برای تمام عملیات‌ها استفاده خواهد کرد. برای مثال،
      --ulozto-username string                              نام کاربری مبنا (principal) برای اجرای عملیات با آن
      --union-action-policy string                          سیاست انتخاب بالادست در دسته ACTION (پیش‌فرض \[dq]epall\[dq])
      --union-cache-time int                                زمان حافظه موقت (کَش) برای فضای مصرف‌شده و آزاد (به ثانیه) (پیش‌فرض 120)
      --union-create-policy string                          سیاست انتخاب بالادست در دسته CREATE (پیش‌فرض \[dq]epmfs\[dq])
      --union-description string                            توضیحات ریموت
      --union-min-free-space SizeSuffix                     حداقل فضای آزاد مناسب برای سیاست‌های lfs/eplfs (پیش‌فرض 1Gi)
      --union-search-policy string                          سیاست انتخاب بالادست در دسته SEARCH (پیش‌فرض \[dq]ff\[dq])
      --union-upstreams string                              فهرستی از بالادست‌ها که با فاصله جدا شده‌اند
      --webdav-auth-redirect                                حفظ احراز هویت در بازنشانی مسیر (redirect)
      --webdav-bearer-token string                          توکن حامل (Bearer) به جای کاربر/گذرواژه (برای مثال یک Macaroon)
      --webdav-bearer-token-command string                  دستور لازم برای اجرا جهت دریافت توکن حامل
      --webdav-description string                           توضیحات ریموت
      --webdav-encoding string                              کدگذاری برای بک‌اند
      --webdav-headers CommaSepList                         تنظیم سرآیندهای HTTP برای تمام تراکنش‌ها
      --webdav-nextcloud-chunk-size SizeSuffix              اندازه تکه بارگذاری Nextcloud (پیش‌فرض 10Mi)
      --webdav-owncloud-exclude-mounts                      استثنا کردن حافظه‌های متصل‌شده (mount شده) در ownCloud
      --webdav-owncloud-exclude-shares                      استثنا کردن اشتراک‌های ownCloud
      --webdav-pacer-min-sleep Duration                     حداقل زمان درنگ میان فراخوانی‌های API (پیش‌فرض 10ms)
      --webdav-pass string                                  گذرواژه (مبهم)
      --webdav-unix-socket string                           مسیر سوکت دامنه یونیکس برای اتصال به آن، به جای باز کردن مستقیم اتصال TCP
      --webdav-url string                                   نشانی URL میزبان http برای اتصال
      --webdav-user string                                  نام کاربری
      --webdav-vendor string                                نام وب‌گاه/سرویس/نرم‌افزار WebDAV مورد استفاده شما
      --yandex-auth-url string                              نشانی URL سرور احراز هویت
      --yandex-client-credentials                           استفاده از گردش کار اعتبارات کارخواه (Client Credentials) در OAuth
      --yandex-client-id string                             شناسه کلاینت OAuth
      --yandex-client-secret string                         رمز کلاینت OAuth
      --yandex-description string                           توضیحات ریموت
      --yandex-encoding Encoding                            کدگذاری برای بک‌اند (پیش‌فرض Slash,Del,Ctl,InvalidUtf8,Dot)
      --yandex-hard-delete                                  حذف دائمی فایل‌ها به جای انتقال آن‌ها به سطل زباله
      --yandex-spoof-ua                                     تنظیم عامل کاربر (User Agent) مطابق با نسخه رسمی کلاینت دیسک یاندکس؛ ممکن است به عملکرد بارگذاری کمک کند (پیش‌فرض true)
      --yandex-token string                                 توکن دسترسی OAuth به‌صورت یک blob جی‌سان
      --yandex-token-url string                             نشانی URL سرور توکن
      --yandex-upload-wait Duration                         مدت‌زمان انتظار پس از بارگذاری پیش از تنظیم زمان ویرایش (پیش‌فرض 0s)
      --zoho-auth-url string                                نشانی URL سرور احراز هویت
      --zoho-client-credentials                             استفاده از گردش کار اعتبارات کارخواه (Client Credentials) در OAuth
      --zoho-client-id string                               شناسه کلاینت OAuth
      --zoho-client-secret string                           رمز کلاینت OAuth
      --zoho-description string                             توضیحات ریموت
      --zoho-encoding Encoding                              کدگذاری برای بک‌اند (پیش‌فرض Del,Ctl,InvalidUtf8)
      --zoho-list-folder-burst int                          تعداد فهرست‌بندی‌های متوالی مجاز از همان پوشه پیش از اعمال محدودیت توسط --zoho-list-folder-limit (پیش‌فرض 6)
      --zoho-list-folder-limit int                          حداکثر تعداد مجاز فهرست‌بندی همان پوشه در هر --zoho-list-folder-window (پیش‌فرض 19)
      --zoho-list-folder-window Duration                    بازه زمانی برای --zoho-list-folder-limit (پیش‌فرض 1m0s)
      --zoho-region string                                  منطقه (Region) در Zoho برای اتصال
      --zoho-root-folder-id string                          شناسه پوشه ریشه
      --zoho-token string                                   توکن دسترسی OAuth به‌صورت یک blob جی‌سان
      --zoho-token-url string                               نشانی URL سرور توکن
      --zoho-tpslimit float                                 حداکثر تعداد تراکنش‌های API بر ثانیه (پیش‌فرض 6)
      --zoho-tpslimit-burst int                             تعداد فراخوانی‌های پشت‌سرهمِ مجاز API بدون توقف، برای --zoho-tpslimit (پیش‌فرض 1)
      --zoho-upload-cutoff SizeSuffix                       حد آستانه برای جابه‌جایی به API بارگذاری فایل‌های بزرگ (>= 10 MiB) (پیش‌فرض 10Mi)
\f[R].fi
.SH "پلاگین ولوم داکر (Docker Volume Plugin)"
.SS "مقدمه (Introduction)"
.PP
داکر ۱.۹ پشتیبانی از ایجاد ولوم‌های نام‌گذاری‌شده
(https://docs.docker.com/storage/volumes)
از طریق رابط خط فرمان
(https://docs.docker.com/engine/reference/commandline/volume_create)
و مونت کردن آن‌ها در کانتینرها را به عنوان راهکاری برای به اشتراک‌گذاری داده‌ها میان آن‌ها اضافه کرده است.
از داکر ۱.۱۰ به بعد می‌توانید ولوم‌های نام‌گذاری‌شده را با Docker
Compose (https://docs.docker.com/compose)
بر اساس تعاریف موجود در فایل‌های
docker-compose.yml (https://docs.docker.com/compose/compose-file/compose-file-v2/#volume-configuration-reference)
برای استفاده توسط گروه‌های کانتینری روی یک میزبان منفرد ایجاد کنید.
از داکر ۱.۱۲، ولوم‌ها توسط Docker
Swarm (https://docs.docker.com/engine/swarm/key-concepts)
که در Docker Engine گنجانده شده پشتیبانی می‌شوند و از روی تعاریف موجود در فایل‌های swarm compose
v3 (https://docs.docker.com/compose/compose-file/compose-file-v3/#volume-configuration-reference)
برای استفاده به همراه \f[I]swarm stacks\f[R] در میان چندین گره کلاستر ایجاد می‌گردند.
.PP
پلاگین‌های ولوم داکر
(https://docs.docker.com/engine/extend/plugins_volume)
درایور پیش‌فرض ولوم \f[V]local\f[R] داکر را با ولوم‌های دارای وضعیت (stateful) که بین کانتینرها و میزبان‌ها به اشتراک گذاشته می‌شوند ارتقا می‌دهند.
برخلاف ولوم‌های محلی، هنگام حذف چنین ولوم‌هایی داده‌های شما پاک \f[I]نخواهند\f[R] شد.
پلاگین‌ها می‌توانند به صورت مدیریت‌شده توسط دیمن داکر، به عنوان یک سرویس سیستمی بومی (تحت systemd، \f[I]sysv\f[R] یا \f[I]upstart\f[R]) یا به شکل یک فایل اجرایی مستقل اجرا شوند.
برنامهٔ Rclone می‌تواند در تمام این حالت‌ها به عنوان پلاگین ولوم داکر اجرا گردد.
این ابزار از طریق API پلاگین
(https://docs.docker.com/engine/extend/plugin_api)
با دیمن محلی داکر تعامل برقرار می‌کند و وظیفهٔ مونت کردن سیستم‌های فایل راه دور در کانتینرهای داکر را بر عهده دارد؛ بنابراین باید روی همان میزبانی که دیمن داکر در حال اجراست یا روی تک‌تک گره‌های Swarm اجرا شود.
.SS "شروع به کار (Getting started)"
.PP
در اولین مثال از ولوم rclone با پروتکل SFTP (https://rclone.org/sftp)
به همراه Docker engine روی یک ماشین مستقل اوبونتو استفاده خواهیم کرد.
.PP
کار را با نصب Docker (https://docs.docker.com/engine/install)
روی میزبان آغاز کنید.
.PP
درایور \f[I]FUSE\f[R] پیش‌نیاز مونت کردن rclone است و باید روی میزبان نصب شود:
.IP
.nf
\f[C]
sudo apt-get -y install fuse3
\f[R]
.fi
.PP
دو دایرکتوری مورد نیاز پلاگین داکر rclone را ایجاد کنید:
.IP
.nf
\f[C]
sudo mkdir -p /var/lib/docker-plugins/rclone/config
sudo mkdir -p /var/lib/docker-plugins/rclone/cache
\f[R]
.fi
.PP
پلاگین مدیریت‌شدهٔ rclone داکر را متناسب با معماری خود (در اینجا
\f[V]amd64\f[R]) نصب کنید:
.IP
.nf
\f[C]
docker plugin install rclone/docker-volume-rclone:amd64 args=\[dq]-v\[dq] --alias rclone --grant-all-permissions
docker plugin list
\f[R]
.fi
.PP
ولوم SFTP خود را ایجاد کنید (https://rclone.org/sftp/#standard-options):
.IP
.nf
\f[C]
docker volume create firstvolume -d rclone -o type=sftp -o sftp-host=_hostname_ -o sftp-user=_username_ -o sftp-pass=_password_ -o allow-other=true
\f[R]
.fi
.PP
توجه داشته باشید که از آنجا که همهٔ گزینه‌ها ایستا هستند، حتی نیازی به اجرای
\f[V]rclone config\f[R] یا ساخت فایل \f[V]rclone.conf\f[R] ندارید (اما
دایرکتوری \f[V]config\f[R] همچنان باید وجود داشته باشد).
در ساده‌ترین حالت می‌توانید از \f[V]localhost\f[R] به عنوان
\f[I]hostname\f[R] و از اطلاعات هویتی SSH خود به عنوان \f[I]username\f[R] و
\f[I]password\f[R] استفاده کنید.
همچنین می‌توانید مسیر راه دور را به دایرکتوری خانگی خود روی میزبان تغییر دهید،
برای مثال \f[V]-o path=/home/username\f[R].
.PP
اکنون زمان ایجاد یک کانتینر آزمایشی و مونت کردن ولوم در آن است:
.IP
.nf
\f[C]
docker run --rm -it -v firstvolume:/mnt --workdir /mnt ubuntu:latest bash
\f[R]
.fi
.PP
اگر همه‌چیز به درستی پیش برود، وارد کانتینر جدید خواهید شد و مستقیماً به مسیر ریموت مونت‌شدهٔ SFTP منتقل می‌شوید.
می‌توانید دستور \f[V]ls\f[R] را برای مشاهدهٔ محتویات دایرکتوری مونت‌شده تایپ کنید یا کارهای دیگر خود را انجام دهید.
پس از اتمام کار، \f[V]exit\f[R] را وارد کنید.
کانتینر متوقف خواهد شد اما ولوم باقی می‌ماند و آمادهٔ استفادهٔ مجدد است.
هنگامی که دیگر نیازی به آن نداشتید، آن را حذف کنید:
.IP
.nf
\f[C]
docker volume list
docker volume remove firstvolume
\f[R]
.fi
.PP
اکنون بیایید \f[B]موردی پیشرفته‌تر\f[R] را امتحان کنیم: ولوم Google
Drive (https://rclone.org/drive) روی Docker Swarm چندگره‌ای.
.PP
باید کار را با نصب Docker و FUSE، ایجاد دایرکتوری‌های پلاگین و نصب پلاگین rclone روی \f[I]تک‌تک\f[R] گره‌های swarm آغاز کنید.
سپس Swarm را راه‌اندازی کنید (https://docs.docker.com/engine/swarm/swarm-mode).
.PP
ولوم‌های Google Drive به یک توکن دسترسی (access token) نیاز دارند که از طریق مرورگر وب قابل تنظیم بوده و به صورت دوره‌ای توسط rclone تمدید می‌شود.
پلاگین مدیریت‌شده قادر به اجرای مرورگر نیست، بنابراین از روشی مشابه با راه‌اندازی rclone در سیستم‌های بدون محیط گرافیکی
(https://rclone.org/remote_setup) استفاده خواهیم کرد.
.PP
دستور rclone config (https://rclone.org/commands/rclone_config_create) را روی
یک ماشین \f[I]دیگر\f[R] مجهز به \f[I]مرورگر وب\f[R] و رابط کاربری گرافیکی اجرا کنید.
ریموت Google Drive را ایجاد کنید
(https://rclone.org/drive/#standard-options).
پس از اتمام، فایل \f[V]rclone.conf\f[R] به دست آمده را به کلاستر Swarm منتقل کرده و آن را در مسیر
\f[V]/var/lib/docker-plugins/rclone/config/rclone.conf\f[R] روی
\f[I]تمامی\f[R] گره‌ها ذخیره نمایید.
به طور پیش‌فرض این مسیر فقط برای کاربر ریشه (root) قابل دسترسی است، بنابراین به مجوزهای مناسب نیاز خواهید داشت.
پیکربندی نهایی مشابه زیر خواهد بود:
.IP
.nf
\f[C]
[gdrive]
type = drive
scope = drive
drive_id = 1234567...
root_folder_id = 0Abcd...
token = {\[dq]access_token\[dq]:...}
\f[R]
.fi
.PP
اکنون فایلی به نام \f[V]example.yml\f[R] با توصیف swarm stack مشابه زیر ایجاد کنید:
.IP
.nf
\f[C]
version: \[aq]3\[aq]
services:
  heimdall:
    image: linuxserver/heimdall:latest
    ports: [8080:80]
    volumes: [configdata:/config]
volumes:
  configdata:
    driver: rclone
    driver_opts:
      remote: \[aq]gdrive:heimdall\[aq]
      allow_other: \[aq]true\[aq]
      vfs_cache_mode: full
      poll_interval: 0
\f[R]
.fi
.PP
و استک را مستقر کنید:
.IP
.nf
\f[C]
docker stack deploy example -c ./example.yml
\f[R]
.fi
.PP
پس از چند ثانیه، داکر توصیف پردازش‌شدهٔ استک را روی کلاستر توزیع کرده، سرویس \f[V]example_heimdall\f[R] را روی پورت
\f[I]8080\f[R] ایجاد می‌کند، کانتینرهای سرویس را روی یک یا چند گره کلاستر اجرا کرده و ولوم \f[V]example_configdata\f[R] را از پلاگین‌های rclone روی میزبان‌های گره درخواست می‌نماید.
می‌توانید از دستورهای زیر برای تأیید نتایج استفاده کنید:.IP
.nf
\f[C]
docker service ls
docker service ps example_heimdall
docker volume ls
\f[R]
.fi
.PP
مرورگر خود را به \f[V]http://cluster.host.address:8080\f[R] هدایت کرده و با سرویس کار کنید.
پس از اتمام کار، آن را با دستور \f[V]docker stack remove example\f[R] متوقف نمایید.
توجه داشته باشید که حجم(های) \f[V]example_configdata\f[R] که بنا به نیاز روی گره‌های خوشه ایجاد شده‌اند، همراه با stack به‌طور خودکار حذف نخواهند شد، بلکه برای استفاده‌های بعدی باقی می‌مانند.
می‌توانید آن‌ها را با اجرای دستی دستور \f[V]docker volume remove example_configdata\f[R] در هر گره حذف کنید.
.SS ایجاد حجم‌ها از طریق خط فرمان (Creating Volumes via CLI)
.PP
حجم‌ها را می‌توان با دستور
docker volume create (https://docs.docker.com/engine/reference/commandline/volume_create)
ایجاد کرد.
در اینجا چند مثال آورده شده است:
.IP
.nf
\f[C]
docker volume create vol1 -d rclone -o remote=storj: -o vfs-cache-mode=full
docker volume create vol2 -d rclone -o remote=:storj,access_grant=xxx:heimdall
docker volume create vol3 -d rclone -o type=storj -o path=heimdall -o storj-access-grant=xxx -o poll-interval=0
\f[R]
.fi
.PP
به پرچم \f[V]-d rclone\f[R] توجه کنید که به docker اعلام می‌کند حجم را از درایور rclone درخواست کند.
این سازوکار حتی اگر درایور مدیریت‌شده را با نام کامل آن \f[V]rclone/docker-volume-rclone\f[R] نصب کرده باشید نیز کار می‌کند، زیرا گزینه \f[V]--alias rclone\f[R] را مشخص کرده‌اید.
.PP
حجم‌ها را می‌توان به صورت زیر بررسی کرد:
.IP
.nf
\f[C]
docker volume list
docker volume inspect vol1
\f[R]
.fi
.SS پیکربندی حجم (Volume Configuration)
.PP
پرچم‌های rclone و گزینه‌های حجم از طریق پرچم \f[V]-o\f[R] در دستور
\f[V]docker volume create\f[R] تنظیم می‌شوند.
آن‌ها شامل پارامترهای مختص backend و همچنین گزینه‌های mount و
\f[I]VFS\f[R] هستند.
همچنین چند گزینه ویژه \f[V]-o\f[R] وجود دارد: \f[V]remote\f[R]،
\f[V]fs\f[R]، \f[V]type\f[R]، \f[V]path\f[R]، \f[V]mount-type\f[R] و
\f[V]persist\f[R].
.PP
گزینه \f[V]remote\f[R] نام یک remote موجود را از فایل پیکربندی، همراه با یک دونقطه در انتها و در صورت تمایل با یک مسیر remote مشخص می‌کند.
سینتکس کامل را در مستندات rclone
(https://rclone.org/docs/#syntax-of-remote-paths) ببینید.
این گزینه می‌تواند نام مستعار \f[V]fs\f[R] را داشته باشد تا از تداخل با پارامتر
\f[I]remote\f[R] در backendهایی مانند \f[I]crypt\f[R] یا
\f[I]alias\f[R] جلوگیری شود.
.PP
سینتکس \f[V]remote=:backend:dir/subdir\f[R] می‌تواند برای ایجاد remoteهای
آنی (بدون پیکربندی) به کار رود
(https://rclone.org/docs/#backend-path-to-dir)، در حالی که گزینه‌های
\f[V]type\f[R] و \f[V]path\f[R] جایگزین ساده‌تری برای این منظور ارائه می‌دهند.
استفاده از دو گزینه مجزا:
.IP
.nf
\f[C]
-o type=backend -o path=dir/subdir
\f[R]
.fi
.PP
معادل سینتکس ترکیبی زیر است:
.IP
.nf
\f[C]
-o remote=:backend:dir/subdir
\f[R]
.fi
.PP
اما مسلماً مقداردهی آن در اسکریپت‌ها آسان‌تر است.
بخش \f[V]path\f[R] اختیاری است.
.PP
گزینه‌های Mount و VFS
(https://rclone.org/commands/rclone_serve_docker/#options) و همچنین
پارامترهای backend (https://rclone.org/flags/#backend) همانند پرچم‌های خط فرمان
همتای خود بدون پیشوند \f[V]--\f[R] نام‌گذاری می‌شوند.
در صورت تمایل می‌توانید در نام گزینه‌ها به جای خط تیره از زیرخط (underscore) استفاده کنید.
برای مثال، \f[V]--vfs-cache-mode full\f[R] تبدیل می‌شود به
\f[V]-o vfs-cache-mode=full\f[R] یا \f[V]-o vfs_cache_mode=full\f[R].
پرچم‌های بولی خط فرمان که بدون مقدار هستند، مقدار \f[V]true\f[R] را دریافت می‌کنند؛ مثلاً
\f[V]--allow-other\f[R] تبدیل می‌شود به \f[V]-o allow-other=true\f[R] یا
\f[V]-o allow_other=true\f[R].
.PP
لطفاً توجه داشته باشید که تنها می‌توانید پارامترهایی را برای backendای تعیین کنید
که مستقیماً توسط نوع backend مربوط به \f[V]remote\f[R] سوارشده ارجاع داده شده است.
اگر این یک backend پوشش‌دهنده مانند \f[I]alias\f[R]، \f[I]chunker\f[R] یا \f[I]crypt\f[R] باشد،
نمی‌توانید گزینه‌هایی را برای remote یا backend ارجاع‌شده مشخص کنید.
این محدودیت توسط تجزیه‌گر رشته اتصال rclone اعمال شده است.
تنها راهکار جایگزین این است که افزونه را با \f[V]rclone.conf\f[R] تغذیه کنید یا
آرگومان‌های افزونه را پیکربندی نمایید (پایین را ببینید)..SS گزینه‌های ویژه Volume (Special Volume Options)
.PP
گزینهٔ \f[V]mount-type\f[R] روش سوار کردن (mount) را تعیین می‌کند و به‌طور کلی می‌تواند
یکی از این موارد باشد: \f[V]mount\f[R]، \f[V]cmount\f[R] یا \f[V]mount2\f[R].
این گزینه می‌تواند با نام مستعار \f[V]mount_type\f[R] نیز به کار رود.
باید توجه داشت که افزونهٔ مدیریت‌شدهٔ docker برای rclone در حال حاضر
از روش \f[V]cmount\f[R] پشتیبانی نمی‌کند و به \f[V]mount2\f[R] نیز به‌ندرت
نیاز است.
پیش‌فرض این گزینه نخستین روش یافت‌شده است، که معمولاً
\f[V]mount\f[R] می‌باشد، بنابراین عموماً به آن نیازی نخواهید داشت.
.PP
گزینهٔ \f[V]persist\f[R] یک گزینهٔ بولی (true/false) رزرو شده است.
در آینده، این گزینه امکان ماندگاری ریموت‌های آنی (on-the-fly) را در فایل
\f[V]rclone.conf\f[R] افزونه فراهم خواهد کرد.
.SS رشته‌های اتصال (Connection Strings)
.PP
مقدار \f[V]remote\f[R] می‌تواند با رشته‌های
اتصال (https://rclone.org/docs/#connection-strings) به عنوان روشی جایگزین
جهت ارائهٔ پارامترهای backend گسترش یابد.
این حالت با گزینه‌های backend دستور \f[V]-o\f[R] معادل است، با یک
\f[I]تفاوت نحوی\f[R].
درون رشتهٔ اتصال، پیشوند backend باید از نام پارامترها حذف شود، اما در
آرایهٔ \f[V]-o param=value\f[R] باید حضور داشته باشد.
برای نمونه، آرایهٔ گزینهٔ زیر را:
.IP
.nf
\f[C]
-o remote=:sftp:/home -o sftp-host=localhost
\f[R]
.fi
.PP
با رشتهٔ اتصال معادل مقایسه کنید:
.IP
.nf
\f[C]
-o remote=:sftp,host=localhost:/home
\f[R]
.fi
.PP
این تفاوت از آنجا ناشی می‌شود که گزینه‌های پرچم \f[V]-o key=val\f[R] نه
تنها شامل پارامترهای backend، بلکه شامل پرچم‌های mount/VFS و احتمالاً سایر
تنظیمات نیز می‌شوند.
همچنین این امکان را می‌دهد تا گزینهٔ \f[V]remote\f[R] از
\f[V]crypt-remote\f[R] (یا پارامترهای backend با نام مشابه) متمایز گردد و
به دلیل جایگزینی شفاف‌تر مقادیر، اسکریپت‌نویسی را آسان‌تر می‌سازد.
.SS استفاده با Swarm یا Compose (Using with Swarm or Compose)
.PP
هر دو ابزار \f[I]Docker Swarm\f[R] و \f[I]Docker Compose\f[R] از فایل‌های متنی با
قالب YAML (http://yaml.org/spec/1.2/spec.html) برای توصیف گروه‌ها (stackها)ی
کانتینرها، ویژگی‌ها، شبکه‌ها و حجم‌های (volumes) آن‌ها استفاده می‌کنند.
ابزار \f[I]Compose\f[R] از قالب compose
v2 (https://docs.docker.com/compose/compose-file/compose-file-v2/#volume-configuration-reference)
و \f[I]Swarm\f[R] از قالب compose
v3 (https://docs.docker.com/compose/compose-file/compose-file-v3/#volume-configuration-reference)
استفاده می‌کند.
آن‌ها تا حد زیادی مشابه یکدیگر هستند؛ تفاوت‌های آن‌ها در مستندات
docker (https://docs.docker.com/compose/compose-file/compose-versioning/#upgrading) توضیح داده شده است.
.PP
حجم‌ها توسط زیرشاخه‌های گرهٔ سطح‌بالای
\f[V]volumes:\f[R] توصیف می‌شوند.
هر یک از آن‌ها باید متناسب با حجم مربوطه نام‌گذاری شده و حداقل دارای دو
عنصر باشد: مقدار مشخص \f[V]driver: rclone\f[R] و ساختار
\f[V]driver_opts:\f[R] که همان نقش پرچم‌های خط فرمان
\f[V]-o key=val\f[R] را ایفا می‌کند:
.IP
.nf
\f[C]
volumes:
  volume_name_1:
    driver: rclone
    driver_opts:
      remote: \[aq]gdrive:\[aq]
      allow_other: \[aq]true\[aq]
      vfs_cache_mode: full
      token: \[aq]{\[dq]type\[dq]: \[dq]borrower\[dq], \[dq]expires\[dq]: \[dq]2021-12-31\[dq]}\[aq]
      poll_interval: 0
\f[R]
.fi
.PP
به چند نکتهٔ مهم توجه کنید:
.IP \[bu] 2
قالب YAML استفاده از \f[V]_\f[R] را به جای \f[V]-\f[R] در نام گزینه‌ها ترجیح می‌دهد.
.IP \[bu] 2
قالب YAML با نقل‌قول‌های تکی و دوتایی به صورت یکسان برخورد می‌کند.
رشته‌های ساده و اعداد صحیح را می‌توان بدون نقل‌قول قرار داد.
.IP \[bu] 2
مقادیر بولی باید مانند \f[V]\[aq]true\[aq]\f[R] یا
\f[V]\[dq]false\[dq]\f[R] در نقل‌قول قرار گیرند، چرا که این دو کلمه توسط YAML رزرو شده‌اند.
.IP \[bu] 2
رشتهٔ فایل‌سیستم با کلید \f[V]remote\f[R] (یا
\f[V]fs\f[R]) مشخص می‌شود.
معمولاً می‌توانید از نقل‌قول در اینجا صرف‌نظر کنید، اما اگر رشته با دونقطه پایان یابد،
\f[B]باید\f[R] آن را مانند
\f[V]remote: \[dq]storage_box:\[dq]\f[R] در نقل‌قول قرار دهید.
.IP \[bu] 2
قالب YAML نسبت به آکولادهای احاطه‌کننده در مقادیر حساس است، چرا که این در واقع
نحو دیگری برای نگاشت‌های کلید/مقدار
(http://yaml.org/spec/1.2/spec.html#id2790832) است.
برای نمونه، توکن‌های دسترسی JSON معمولاً حاوی نقل‌قول‌های دوتایی و
آکولادهای احاطه‌کننده هستند، بنابراین باید آن‌ها را درون نقل‌قول تکی بگذارید..SS نصب به‌صورت افزونه مدیریت‌شده
.PP
دیمن Docker می‌تواند افزونه‌ها را از یک رجیستری ایمیج نصب کرده و آن‌ها را به‌صورت مدیریت‌شده (managed) اجرا کند.
ما ایمیج افزونهٔ
docker-volume-rclone (https://hub.docker.com/p/rclone/docker-volume-rclone)
را روی Docker Hub (https://hub.docker.com) نگهداری می‌کنیم.
.PP
افزونه حجم Rclone نیازمند \f[B]Docker Engine >= 19.03.15\f[R] است.
.PP
این افزونه پیش از نصب، نیازمند وجود دو دایرکتوری روی میزبان است.
توجه داشته باشید که افزونه آن‌ها را به‌صورت خودکار ایجاد \f[B]نخواهد کرد\f[R].
به‌طور پیش‌فرض، این دایرکتوری‌ها باید در مسیرهای زیر روی میزبان موجود باشند (اگرچه می‌توانید مسیرها را تغییر دهید):
.IP \[bu] 2
مسیر \f[V]/var/lib/docker-plugins/rclone/config\f[R] برای فایل پیکربندی
\f[V]rclone.conf\f[R] رزرو شده است و \f[B]باید\f[R] وجود داشته باشد، حتی اگر
خالی بوده و فایل پیکربندی موجود نباشد.
.IP \[bu] 2
مسیر \f[V]/var/lib/docker-plugins/rclone/cache\f[R] فایل وضعیت افزونه و
همچنین کش‌های اختیاری VFS را نگه می‌دارد.
.PP
می‌توانید افزونهٔ
مدیریت‌شده (https://docs.docker.com/engine/reference/commandline/plugin_install)
را با تنظیمات پیش‌فرض به‌صورت زیر نصب کنید:
.IP
.nf
\f[C]
docker plugin install rclone/docker-volume-rclone:amd64 --grant-all-permissions --alias rclone
\f[R]
.fi
.PP
بخش \f[V]:amd64\f[R] در مشخصات ایمیج که پس از دو‌نقطه می‌آید، \f[I]برچسب (tag)\f[R] نامیده می‌شود.
معمولاً می‌خواهید آخرین نسخهٔ افزونه را برای معماری سیستم خود نصب کنید.
در این حالت، برچسب صرفاً نام معماری خواهد بود، مانند \f[V]amd64\f[R] در بالا.
معماری‌های زیر در حال حاضر برای افزونه در دسترس هستند:
.IP \[bu] 2
\f[V]amd64\f[R]
.IP \[bu] 2
\f[V]arm64\f[R]
.IP \[bu] 2
\f[V]arm-v7\f[R]
.PP
گاهی ممکن است نسخه‌ای خاص از افزونه را بخواهید، نه آخرین نسخهٔ آن را.
در این صورت باید از برچسب ایمیج به شکل
\f[V]:ARCHITECTURE-VERSION\f[R] استفاده کنید.
برای مثال، جهت نصب نسخهٔ \f[V]v1.56.2\f[R] افزونه روی معماری
\f[V]arm64\f[R] باید از برچسب \f[V]arm64-1.56.2\f[R] استفاده کنید (توجه داشته باشید که
حرف \f[V]v\f[R] حذف شده است)، بنابراین مشخصات کامل ایمیج به‌صورت
\f[V]rclone/docker-volume-rclone:arm64-1.56.2\f[R] درمی‌آید.
.PP
ما برچسب \f[V]latest\f[R] را نیز برای افزونه ارائه می‌دهیم، اما از آن‌جا که تا زمان نگارش این متن docker
از افزونه‌های چندمعماری پشتیبانی نمی‌کند، این برچسب در حال حاضر یک \f[B]نام مستعار برای \f[VB]amd64\f[B]\f[R] است.
طبق قرارداد، برچسب \f[V]latest\f[R] پیش‌فرض بوده و می‌تواند
حذف شود؛ بنابراین هم \f[V]rclone/docker-volume-rclone:latest\f[R] و هم صرفاً
\f[V]rclone/docker-volume-rclone\f[R] به آخرین نگارش افزونه برای پلتفرم \f[V]amd64\f[R] اشاره خواهند داشت.
.PP
همچنین بخش \f[V]amd64\f[R] را می‌توان از برچسب‌های نسخه‌دار افزونه rclone حذف کرد.
برای مثال، مرجع ایمیج rclone به‌صورت
\f[V]rclone/docker-volume-rclone:amd64-1.56.2\f[R] می‌تواند برای راحتی به‌صورت
\f[V]rclone/docker-volume-rclone:1.56.2\f[R] خلاصه شود.
با این حال، برای معماری‌های غیر اینتل همچنان باید از برچسب کامل استفاده کنید،
زیرا اجرای \f[V]amd64\f[R] یا \f[V]latest\f[R] ناموفق خواهد بود.
.PP
افزونهٔ مدیریت‌شده در واقع یک کانتینر ویژه است که در یک فضای نام (namespace)
مجزا از کانتینرهای عادی docker اجرا می‌شود.
درون آن دستور \f[V]rclone serve docker\f[R] اجرا می‌گردد.
دایرکتوری‌های config و cache در زمان راه‌اندازی به‌صورت bind-mount به درون کانتینر متصل می‌شوند.
دیمن docker به یک سوکت unix که توسط دستور درون کانتینر ایجاد شده است متصل می‌شود.
این دستور اتصالات راه‌دور را بر حسب تقاضا درون خود ایجاد کرده، سپس سازوکار docker
آن‌ها را از طریق فضاهای نام اتصال (mount namespaces) هسته منتشر ساخته و به‌صورت
bind-mount به کانتینرهای کاربری درخواست‌کننده متصل می‌کند.
.PP
می‌توانید پس از نصب، زمانی که افزونه غیرفعال است (در حال استفاده نیست)، برخی از تنظیمات آن را تغییر دهید؛ برای نمونه:
.IP
.nf
\f[C]
docker plugin disable rclone
docker plugin set rclone RCLONE_VERBOSE=2 config=/etc/rclone args=\[dq]--vfs-cache-mode=writes --allow-other\[dq]
docker plugin enable rclone
docker plugin inspect rclone
\f[R]
.fi
.PP
توجه داشته باشید که اگر docker از غیرفعال‌سازی افزونه خودداری کرد، باید تمام حجم‌های فعال متصل به آن
و همچنین کانتینرها و سرویس‌های swarm استفاده‌کننده از آن‌ها را پیدا کرده و حذف کنید.
این کار نسبتاً دشوار و زمان‌بر است، بنابراین لطفاً از پیش با دقت برنامه‌ریزی کنید.
.PP
می‌توانید تنظیمات زیر را تغییر دهید: \f[V]args\f[R]، \f[V]config\f[R]،
\f[V]cache\f[R]، \f[V]HTTP_PROXY\f[R]، \f[V]HTTPS_PROXY\f[R]،
\f[V]NO_PROXY\f[R] و \f[V]RCLONE_VERBOSE\f[R].
همگام نگه‌داشتن تنظیمات افزونه در سراسر گره‌های کلاستر swarm وظیفهٔ \f[I]شما\f[R] است.
.PP
تنظیم \f[V]args\f[R] آرگومان‌های خط فرمان را برای
دستور \f[V]rclone serve docker\f[R] مشخص می‌کند (به‌طور پیش‌فرض \f[I]none\f[R]).
آرگومان‌ها باید با فاصله از هم جدا شوند، بنابراین معمولاً مایل خواهید بود آن‌ها را در خط فرمان
docker plugin set (https://docs.docker.com/engine/reference/commandline/plugin_set)
داخل نقل‌قول (کوتیشن) قرار دهید.
هم پرچم‌های
serve docker (https://rclone.org/commands/rclone_serve_docker#options)
و هم پرچم‌های عمومی rclone (https://rclone.org/flags) پشتیبانی می‌شوند،
از جمله پارامترهای backend که به‌عنوان پیش‌فرض برای ایجاد حجم به کار خواهند رفت.
توجه داشته باشید که در صورت خالی بودن مقدار \f[V]args\f[R]، افزونه (به دلیل این
باگ docker (https://github.com/moby/moby/blob/v20.10.7/plugin/v2/plugin.go#L195))
با خطا مواجه خواهد شد.
به‌عنوان یک راه‌حل جایگزین، برای نمونه از
\f[V]args=\[dq]-v\[dq]\f[R] استفاده کنید.
.PP
تنظیم \f[V]config=/host/dir\f[R] مسیر جایگزینی را روی میزبان برای دایرکتوری config تعیین می‌کند.
افزونه فایل \f[V]rclone.conf\f[R] را در اینجا جستجو خواهد کرد.
عدم وجود فایل پیکربندی خطا محسوب نمی‌شود، اما دایرکتوری حتماً باید موجود باشد.
لطفاً توجه داشته باشید که افزونه ممکن است به‌طور دوره‌ای فایل پیکربندی را بازنویسی کند، برای نمونه
هنگامی که توکن‌های دسترسی به فضای ذخیره‌سازی را تمدید می‌کند.
این نکته را در نظر داشته باشید و بکوشید از شرایط رقابتی (race condition) بین افزونه و سایر نمونه‌های
rclone روی میزبان که ممکن است هم‌زمان قصد تغییر پیکربندی را داشته باشند و منجر به خرابی \f[V]rclone.conf\f[R] شوند، جلوگیری کنید.
همچنین می‌توانید فایل‌هایی مانند کلیدهای خصوصی برای ریموت‌های SFTP را در این دایرکتوری قرار دهید.
فقط توجه داشته باشید که این مسیر در داخل کانتینر افزونه روی مسیر پیش‌تعریف‌شدهٔ \f[V]/data/config\f[R] متصل (bind-mount) می‌شود.
برای مثال، اگر نام فایل کلید شما روی میزبان \f[V]sftp-box1.key\f[R] باشد، گزینهٔ پیکربندی حجم مربوطه باید به‌صورت
\f[V]-o sftp-key-file=/data/config/sftp-box1.key\f[R] تعیین شود.
.PP
تنظیم \f[V]cache=/host/dir\f[R] مسیر جایگزینی را روی میزبان برای
دایرکتوری \f[I]cache\f[R] مشخص می‌کند.
افزونه کش‌های VFS را در اینجا نگه می‌دارد.
همچنین فایل \f[V]docker-plugin.state\f[R] را در این دایرکتوری ایجاد و نگهداری خواهد کرد.
هنگامی که افزونه راه‌اندازی مجدد یا دوباره نصب شود، برای بازسازی حجم‌هایی که پیش‌تر وجود داشته‌اند به این فایل مراجعه می‌کند.
با این حال، پس از راه‌اندازی مجدد، این حجم‌ها دوباره به درون کانتینرهای مصرف‌کننده متصل نخواهند شد.
معمولاً این امر مشکلی نیست، زیرا دیمن docker به‌طور عادی کانتینرهای کاربری متأثر را پس از بروز خطاها،
راه‌اندازی مجدد دیمن یا راه‌اندازی مجدد میزبان، دوباره راه‌اندازی می‌کند.
.PP
تنظیم \f[V]RCLONE_VERBOSE\f[R] سطح پرحرفی (verbosity) افزونه را از \f[V]0\f[R] (صرفاً خطاها، به‌طور پیش‌فرض)
تا \f[V]2\f[R] (اشکال‌زدایی) تعیین می‌کند.
میزان پرحرفی را می‌توان از طریق \f[V]args=\[dq]-v [-v] ...\[dq]\f[R] نیز تنظیم کرد.
از آن‌جا که آرگومان‌ها عمومی‌تر هستند، به‌ندرت به این تنظیم نیاز خواهید داشت.
خروجی افزونه به‌طور پیش‌فرض لاگ دیمن docker را روی میزبان محلی تغذیه می‌کند.
مدخل‌های لاگ به‌صورت \f[I]خطا (error)\f[R] در لاگ docker منعکس می‌شوند، اما سطح واقعی تعیین‌شده توسط rclone
را در رشتهٔ پیام کپسوله‌شده حفظ می‌کنند.
.PP
متغیرهای \f[V]HTTP_PROXY\f[R]، \f[V]HTTPS_PROXY\f[R] و \f[V]NO_PROXY\f[R]
تنظیمات پروکسی افزونه را سفارشی‌سازی می‌کنند.
.PP
می‌توانید گزینه‌های سفارشی افزونه را مستقیماً هنگام نصب آن، \f[I]یک‌باره\f[R] تنظیم کنید:
.IP
.nf
\f[C]
docker plugin remove rclone
docker plugin install rclone/docker-volume-rclone:amd64 \[rs]
       --alias rclone --grant-all-permissions \[rs]
       args=\[dq]-v --allow-other\[dq] config=/etc/rclone
docker plugin inspect rclone
\f[R]
.fi.SS بررسی‌های سلامت (Healthchecks)
.PP
پروتکل docker plugin volume راهکاری برای افزونه‌ها فراهم نمی‌کند تا دیمن docker را از در دسترس بودن یا نبودن یک volume مطلع سازند.
به‌عنوان یک راهکار موقت می‌توانید یک healthcheck تنظیم کنید تا از پاسخ‌گو بودن نقطه اتصال (mount) اطمینان حاصل شود، برای نمونه:
.IP
.nf
\f[C]
services:
  my_service:
    image: my_image
    healthcheck:
      test: ls /path/to/rclone/mount || exit 1
      interval: 1m
      timeout: 15s
      retries: 3
      start_period: 15s
\f[R]
.fi
.SS اجرای افزونه تحت Systemd (Running Plugin under Systemd)
.PP
در بیشتر موارد باید حالت مدیریت‌شده (managed mode) را ترجیح دهید.
علاوه بر این، MacOS و Windows از افزونه‌های بومی Docker پشتیبانی نمی‌کنند.
لطفاً در این سیستم‌ها از حالت managed استفاده کنید.
تنها در صورتی ادامه دهید که از Linux استفاده می‌کنید.
.PP
ابتدا، rclone را نصب کنید (https://rclone.org/install).
برای آزمایش می‌توانید فقط آن را اجرا کنید (عبارت \f[V]rclone serve docker\f[R] را تایپ کرده و کلید Enter را بزنید).
.PP
بسته \f[I]FUSE\f[R] را نصب کنید:
.IP
.nf
\f[C]
sudo apt-get -y install fuse
\f[R]
.fi
.PP
دو فایل پیکربندی systemd زیر را بارگیری کنید:
docker-volume-rclone.service (https://raw.githubusercontent.com/rclone/rclone/master/contrib/docker-plugin/systemd/docker-volume-rclone.service)
و
docker-volume-rclone.socket (https://raw.githubusercontent.com/rclone/rclone/master/contrib/docker-plugin/systemd/docker-volume-rclone.socket).
.PP
آن‌ها را در دایرکتوری \f[V]/etc/systemd/system/\f[R] قرار دهید:
.IP
.nf
\f[C]
cp docker-volume-plugin.service /etc/systemd/system/
cp docker-volume-plugin.socket  /etc/systemd/system/
\f[R]
.fi
.PP
لطفاً توجه داشته باشید که تمام دستورات این بخش باید با دسترسی کاربر ریشه (\f[I]root\f[R]) اجرا شوند، اما ما پیشوند \f[V]sudo\f[R] را برای رعایت اختصار حذف کرده‌ایم.
اکنون دایرکتوری‌های مورد نیاز سرویس را بسازید:
.IP
.nf
\f[C]
mkdir -p /var/lib/docker-volumes/rclone
mkdir -p /var/lib/docker-plugins/rclone/config
mkdir -p /var/lib/docker-plugins/rclone/cache
\f[R]
.fi
.PP
سرویس افزونه docker را در حالت فعال‌سازی با سوکت (socket activated) اجرا کنید:
.IP
.nf
\f[C]
systemctl daemon-reload
systemctl start docker-volume-rclone.service
systemctl enable docker-volume-rclone.socket
systemctl start docker-volume-rclone.socket
systemctl restart docker
\f[R]
.fi
.PP
یا سرویس را به‌طور مستقیم اجرا کنید:
.IP \[bu] 2
دستور \f[V]systemctl daemon-reload\f[R] را اجرا کنید تا systemd پیکربندی جدید را اعمال کند.
.IP \[bu] 2
دستور \f[V]systemctl enable docker-volume-rclone.service\f[R] را اجرا کنید تا سرویس جدید هنگام روشن شدن دستگاه به‌طور خودکار آغاز به کار کند.
.IP \[bu] 2
دستور \f[V]systemctl start docker-volume-rclone.service\f[R] را برای شروع سرویس در همین لحظه اجرا کنید.
.IP \[bu] 2
دستور \f[V]systemctl restart docker\f[R] را اجرا کنید تا دیمن docker مجدداً راه‌اندازی شده و سوکت افزونه جدید را شناسایی کند.
توجه داشته باشید که این مرحله در حالت managed که docker از تغییرات وضعیت افزونه آگاه است، لازم نیست.
.PP
هر دو روش از دیدگاه کاربر معادل یکدیگر هستند، اما من شخصاً فعال‌سازی با سوکت را ترجیح می‌دهم..SS "عیب‌یابی (Troubleshooting)"
.PP
می‌توانید تنظیمات افزونهٔ مدیریت‌شده را (https://docs.docker.com/engine/extend/#debugging-plugins) با دستورهای زیر مشاهده کنید:
.IP
.nf
\f[C]
docker plugin list
docker plugin inspect rclone
\f[R]
.fi
.PP
توجه داشته باشید که docker (حتی آخرین نسخهٔ 20.10.7) مقادیر واقعی \f[V]args\f[R] را نمایش نمی‌دهد، بلکه تنها مقادیر پیش‌فرض را نشان می‌دهد.
.PP
برای مشاهدهٔ خروجی افزونهٔ مدیریت‌شده به عنوان بخشی از لاگ دیمن docker، از دستور \f[V]journalctl --unit docker\f[R] استفاده کنید.
توجه داشته باشید که docker خطوط افزونه را به عنوان \f[I]errors\f[R] نشان می‌دهد، اما سطح واقعی آن‌ها از طریق رشتهٔ پیام کپسوله‌شده قابل مشاهده است.
.PP
شما معمولاً آخرین نسخه از افزونهٔ مدیریت‌شده را برای بستر (platform) خود نصب خواهید کرد.
برای چاپ نسخهٔ واقعی نصب‌شده، دستورهای زیر را به کار ببرید:
.IP
.nf
\f[C]
PLUGID=$(docker plugin list --no-trunc | awk \[aq]/rclone/{print$1}\[aq])
sudo runc --root /run/docker/runtime-runc/plugins.moby exec $PLUGID rclone version
\f[R]
.fi
.PP
حتی می‌توانید از \f[V]runc\f[R] برای اجرای شل (shell) درون کانتینر افزونه استفاده کنید:
.IP
.nf
\f[C]
sudo runc --root /run/docker/runtime-runc/plugins.moby exec --tty $PLUGID bash
\f[R]
.fi
.PP
همچنین می‌توانید از curl برای بررسی اتصال‌پذیری سوکت افزونه استفاده کنید:
.IP
.nf
\f[C]
docker plugin list --no-trunc
PLUGID=123abc...
sudo curl -H Content-Type:application/json -XPOST -d {} --unix-socket /run/docker/plugins/$PLUGID/rclone.sock http://localhost/Plugin.Activate
\f[R]
.fi
.PP
اگرچه این کار به‌ندرت مورد نیاز است.
.PP
اگر افزونه به درستی کار نمی‌کند، و فقط به عنوان آخرین راهکار پس از تلاش برای عیب‌یابی با روش‌های فوق، می‌توانید وضعیت (state) افزونه را پاک کنید.
\f[B]توجه داشته باشید که احتمالاً همهٔ حجم‌های rclone docker موجود باید دوباره ایجاد شوند.\f[R] همان‌طور که پیش‌تر گفته شد، ممکن است به این کار نیاز باشد زیرا نصب مجدد، فایل‌های وضعیت موجود را پاک نمی‌کند تا بازیابی آسان میسر باشد.
.IP
.nf
\f[C]
docker plugin disable rclone # disable the plugin to ensure no interference
sudo rm /var/lib/docker-plugins/rclone/cache/docker-plugin.state # removing the plugin state
docker plugin enable rclone # re-enable the plugin afterward
\f[R]
.fi
.SS "نکات قابل توجه (Caveats)"
.PP
در پایان می‌خواهم به یک \f[I]نکتهٔ مهم دربارهٔ به‌روزرسانی تنظیمات حجم (volume)\f[R] اشاره کنم.
رابط خط فرمان Docker CLI دستور اختصاصی مانند \f[V]docker volume update\f[R] ندارد.
ممکن است اجرای \f[V]docker volume create\f[R] با گزینه‌های به‌روزرسانی‌شده روی یک حجم موجود وسوسه‌انگیز به نظر برسد، اما یک تله در این میان وجود دارد.
این دستور هیچ کاری انجام نخواهد داد و حتی خطایی نیز برنمی‌گرداند.
امیدوارم نگهدارندگان docker روزی این مشکل را برطرف کنند.
در این فاصله آگاه باشید که باید قبل از ایجاد مجدد حجم با تنظیمات جدید، ابتدا حجم قبلی را حذف کنید:
.IP
.nf
\f[C]
docker volume remove my_vol
docker volume create my_vol -d rclone -o opt1=new_val1 ...
\f[R]
.fi
.PP
و بررسی کنید که تنظیمات به‌روزرسانی شده باشند:
.IP
.nf
\f[C]
docker volume list
docker volume inspect my_vol
\f[R]
.fi
.PP
اگر docker از حذف حجم خودداری کرد، باید کانتینرها یا سرویس‌های swarm که از آن استفاده می‌کنند را پیدا کرده و ابتدا آن‌ها را متوقف کنید..SS Bisync
.PP
دستور \f[V]bisync\f[R] یک \f[B]دستور پیشرفته\f[R] به شمار می‌رود، بنابراین با احتیاط از آن استفاده کنید.
پیش از استفاده، اطمینان حاصل کنید که کل راهنما (https://rclone.org/bisync) (به‌ویژه بخش محدودیت‌ها) را خوانده و متوجه شده‌اید؛ در غیر این صورت ممکن است داده‌ها از دست بروند.
پرسش‌ها را می‌توانید در انجمن Rclone (https://forum.rclone.org) مطرح کنید.
.SS "شروع به کار (Getting started)"
.IP \[bu] 2
برنامه rclone را نصب کرده (https://rclone.org/install) و ریموت‌های خود را پیکربندی کنید.
.IP \[bu] 2
دستور Bisync دایرکتوری کاری خود را در
\f[V]\[ti]/.cache/rclone/bisync\f[R] روی Linux،
\f[V]/Users/yourusername/Library/Caches/rclone/bisync\f[R] روی Mac یا
\f[V]C:\[rs]Users\[rs]MyLogin\[rs]AppData\[rs]Local\[rs]rclone\[rs]bisync\f[R]
روی Windows ایجاد می‌کند.
اطمینان حاصل کنید که این مکان قابل نوشتن باشد.
.IP \[bu] 2
دستور bisync را با پرچم \f[V]--resync\f[R] و با تعیین مسیرهای ریشه دایرکتوری‌های همگام‌سازی محلی و دوردست اجرا کنید.
.IP \[bu] 2
برای دفعات بعدی اجرای همگام‌سازی، پرچم \f[V]--resync\f[R] را حذف کنید.
(\f[B]مهم!\f[R])
.IP \[bu] 2
برای مستثنی کردن فایل‌ها و دایرکتوری‌های غیرضروری از همگام‌سازی، استفاده از یک فایل فیلترها را در نظر بگیرید.
.IP \[bu] 2
برای ایمنی بیشتر، راه‌اندازی ویژگی --check-access را در نظر داشته باشید.
.IP \[bu] 2
در Linux یا Mac، تنظیم یک مدخل crontab را در نظر بگیرید.
به لطف فایل‌های قفلی که bisync نگهداری می‌کند، این دستور می‌تواند با اطمینان در وظایف هم‌روند cron اجرا شود.
.PP
به‌عنوان مثال، نخستین دستور شما ممکن است به این شکل باشد:
.IP
.nf
\f[C]
rclone bisync remote1:path1 remote2:path2 --create-empty-src-dirs --compare size,modtime,checksum --slow-hash-sync-only --resilient -MvP --drive-skip-gdocs --fix-case --resync --dry-run
\f[R]
.fi
.PP
اگر همه‌چیز مناسب به نظر می‌رسد، آن را دوباره بدون \f[V]--dry-run\f[R] اجرا کنید.
پس از آن، \f[V]--resync\f[R] را نیز حذف کنید.
.PP
در اینجا گزارش یک اجرای نمونه آمده است (برچسب‌های زمانی برای وضوح بیشتر حذف شده‌اند):
.IP
.nf
\f[C]
rclone bisync /testdir/path1/ /testdir/path2/ --verbose
INFO  : Synching Path1 \[dq]/testdir/path1/\[dq] with Path2 \[dq]/testdir/path2/\[dq]
INFO  : Path1 checking for diffs
INFO  : - Path1    File is new                         - file11.txt
INFO  : - Path1    File is newer                       - file2.txt
INFO  : - Path1    File is newer                       - file5.txt
INFO  : - Path1    File is newer                       - file7.txt
INFO  : - Path1    File was deleted                    - file4.txt
INFO  : - Path1    File was deleted                    - file6.txt
INFO  : - Path1    File was deleted                    - file8.txt
INFO  : Path1:    7 changes:    1 new,    3 newer,    0 older,    3 deleted
INFO  : Path2 checking for diffs
INFO  : - Path2    File is new                         - file10.txt
INFO  : - Path2    File is newer                       - file1.txt
INFO  : - Path2    File is newer                       - file5.txt
INFO  : - Path2    File is newer                       - file6.txt
INFO  : - Path2    File was deleted                    - file3.txt
INFO  : - Path2    File was deleted                    - file7.txt
INFO  : - Path2    File was deleted                    - file8.txt
INFO  : Path2:    7 changes:    1 new,    3 newer,    0 older,    3 deleted
INFO  : Applying changes
INFO  : - Path1    Queue copy to Path2                 - /testdir/path2/file11.txt
INFO  : - Path1    Queue copy to Path2                 - /testdir/path2/file2.txt
INFO  : - Path2    Queue delete                        - /testdir/path2/file4.txt
NOTICE: - WARNING  New or changed in both paths        - file5.txt
NOTICE: - Path1    Renaming Path1 copy                 - /testdir/path1/file5.txt..path1
NOTICE: - Path1    Queue copy to Path2                 - /testdir/path2/file5.txt..path1
NOTICE: - Path2    Renaming Path2 copy                 - /testdir/path2/file5.txt..path2
NOTICE: - Path2    Queue copy to Path1                 - /testdir/path1/file5.txt..path2
INFO  : - Path2    Queue copy to Path1                 - /testdir/path1/file6.txt
INFO  : - Path1    Queue copy to Path2                 - /testdir/path2/file7.txt
INFO  : - Path2    Queue copy to Path1                 - /testdir/path1/file1.txt
INFO  : - Path2    Queue copy to Path1                 - /testdir/path1/file10.txt
INFO  : - Path1    Queue delete                        - /testdir/path1/file3.txt
INFO  : - Path2    Do queued copies to                 - Path1
INFO  : - Path1    Do queued copies to                 - Path2
INFO  : -          Do queued deletes on                - Path1
INFO  : -          Do queued deletes on                - Path2
INFO  : Updating listings
INFO  : Validating listings for Path1 \[dq]/testdir/path1/\[dq] vs Path2 \[dq]/testdir/path2/\[dq]
INFO  : Bisync successful
\f[R]
.fi.SS نحو خط فرمان (Command line syntax)
.IP
.nf
\f[C]
$ rclone bisync --help
کاربرد:
  rclone bisync remote1:path1 remote2:path2 [flags]

آرگومان‌های موقعیتی:
  Path1, Path2  مسیر محلی، یا فضای ذخیره‌سازی ریموت با \[aq]:\[aq] به همراه مسیر اختیاری.
                برای مشاهده فهرست ریموت‌های پیکربندی‌شده، \[aq]rclone listremotes\[aq] را وارد کنید.

گزینه‌های اختیاری:
      --backup-dir1 string                   مسیر --backup-dir برای Path1. باید یک مسیر غیرهمپوشان روی همان ریموت باشد.
      --backup-dir2 string                   مسیر --backup-dir برای Path2. باید یک مسیر غیرهمپوشان روی همان ریموت باشد.
      --check-access                         اطمینان از یافت‌شدن فایل‌های موردانتظار RCLONE_TEST در هر دو سیستم‌فایل Path1 و Path2، در غیر این صورت لغو عملیات.
      --check-filename string                نام فایل برای --check-access (پیش‌فرض: RCLONE_TEST)
      --check-sync string                    کنترل مقایسه فهرست‌های نهایی: true|false|only (پیش‌فرض: true) (پیش‌فرض \[dq]true\[dq])
      --compare string                       فهرست جداشده با کاما از گزینه‌های مقایسه مختص bisync مانند \[aq]size,modtime,checksum\[aq] (پیش‌فرض: \[aq]size,modtime\[aq])
      --conflict-loser ConflictLoserAction   اقدام لازم روی بازنده تداخل همگام‌سازی (وقتی برنده‌ای هست) یا هر دو فایل (وقتی برنده‌ای نیست): , num, pathname, delete (پیش‌فرض: num)
      --conflict-resolve string              حل خودکار تداخل‌ها با ترجیح نسخه‌ای که: none, path1, path2, newer, older, larger, smaller (پیش‌فرض: none) (پیش‌فرض \[dq]none\[dq])
      --conflict-suffix string               پسوند مورد استفاده هنگام تغییر نام --conflict-loser. می‌تواند یک رشته یا دو رشته جداشده با کاما برای تخصیص پسوندهای متفاوت به Path1/Path2 باشد. (پیش‌فرض: \[aq]conflict\[aq])
      --create-empty-src-dirs                همگام‌سازی ایجاد و حذف دایرکتوری‌های خالی. (ناسازگار با --remove-empty-dirs)
      --download-hash                        محاسبه هش با بارگیری در صورت عدم دسترسی از راه‌های دیگر. (هشدار: ممکن است کند باشد و حجم زیادی مصرف کند!)
      --filters-file string                  خواندن الگوهای فیلتر از یک فایل
      --force                                دور زدن بررسی ایمنی --max-delete و اجرای همگام‌سازی. استفاده به همراه --verbose توصیه می‌شود
  -h, --help                                 راهنمای bisync
      --ignore-listing-checksum              عدم استفاده از چکسام‌ها برای فهرست‌ها (افزودن --ignore-checksum برای نادیده‌گرفتن مضاعف بررسی چکسام پس از کپی)
      --max-lock Duration                    منقضی فرض کردن فایل‌های قفل قدیمی‌تر از این مدت (پیش‌فرض: 0 (هرگز منقضی نشود)) (حداقل: 2m) (پیش‌فرض 0s)
      --no-cleanup                           نگه‌داشتن فایل‌های کاری (مفید برای عیب‌یابی و آزمایش).
      --no-slow-hash                         نادیده‌گرفتن چکسام فهرست‌ها فقط در بک‌اندهایی که در آن‌ها کند هستند
      --recover                              بازیابی خودکار از وقفه‌ها بدون نیاز به --resync.
      --remove-empty-dirs                    حذف همه دایرکتوری‌های خالی در مرحله پاک‌سازی نهایی.
      --resilient                            امکان تلاش مجدد در اجراهای بعدی پس از برخی خطاهای کم‌اهمیت‌تر، به جای الزام به --resync.
  -1, --resync                               اجرای همگام‌سازی مجدد (resync). معادل --resync-mode path1. استفاده از --verbose یا --dry-run در ابتدا توصیه می‌شود.
      --resync-mode string                   در طول resync، ترجیح دادن نسخه‌ای که: path1, path2, newer, older, larger, smaller (پیش‌فرض: path1 اگر --resync داده شود، در غیر این صورت none برای عدم resync.) (پیش‌فرض \[dq]none\[dq])
      --retries int                          تعداد دفعات تلاش مجدد در صورت شکست عملیات‌ها (نیازمند --resilient). (پیش‌فرض 3)
      --retries-sleep Duration               فاصله زمانی بین تلاش‌های مجدد در صورت شکست عملیات‌ها، مثلاً 500ms, 60s, 5m (مقدار 0 برای غیرفعال‌سازی) (پیش‌فرض 0s)
      --slow-hash-sync-only                  نادیده‌گرفتن چکسام‌های کند برای فهرست‌ها و دلتاها، اما لحاظ کردن آن‌ها در فراخوانی‌های sync.
      --workdir string                       استفاده از دایرکتوری کاری سفارشی - مفید برای آزمایش. (پیش‌فرض: {WORKDIR})
      --max-delete PERCENT                   بررسی ایمنی حداکثر درصد مجاز فایل‌های حذف‌شده. در صورت فراتر رفتن، اجرای bisync لغو خواهد شد. (پیش‌فرض: 50%)
  -n, --dry-run                              اجرای آزمایشی بدون اعمال تغییرات - هیچ فایلی کپی یا حذف نمی‌شود.
  -v, --verbose                              افزایش سطح گزارش‌گیری (verbosity). برای جزئیات بیشتر می‌تواند بیش از یک بار مشخص شود.
\f[R]
.fi
.PP
پرچم‌های دلخواه rclone می‌توانند در خط فرمان bisync
(https://rclone.org/commands/rclone_bisync) مشخص شوند؛ به عنوان مثال:
\f[V]rclone bisync ./testdir/path1/ gdrive:testdir/path2/ --drive-skip-gdocs -v -v --timeout 10s\f[R]
توجه داشته باشید که برهم‌کنش پرچم‌های گوناگون rclone با جریان فرایند bisync
هنوز به‌طور کامل آزمایش نشده است.
.SS مسیرها (Paths)
.PP
آرگومان‌های Path1 و Path2 می‌توانند ارجاعاتی به هر ترکیبی از مسیرهای دایرکتوری
محلی (مطلق یا نسبی)، مسیرهای UNC (\f[V]//server/share/path\f[R])،
مسیرهای درایو Windows (همراه با حرف درایو و \f[V]:\f[R]) یا
ریموت‌های پیکربندی‌شده (https://rclone.org/docs/#syntax-of-remote-paths) به
همراه مسیرهای اختیاری زیردایرکتوری باشند.
ارجاعات ابری با داشتن یک \f[V]:\f[R] در آرگومان تشخیص داده می‌شوند (پشتیبانی
Windows در زیر را ببینید).
.PP
با Path1 و Path2 به‌طور یکسان رفتار می‌شود؛ به این صورت که هیچ‌کدام اولویتی برای
تغییرات فایل ندارند (به‌جز در طول \f[V]--resync\f[R])، و بازدهی دسترسی نیز
بسته به این که یک ریموت روی Path1 باشد یا Path2 تغییری نمی‌کند.
.PP
فهرست‌های موجود در دایرکتوری کاری bisync (پیش‌فرض:
\f[V]\[ti]/.cache/rclone/bisync\f[R]) بر اساس آرگومان‌های Path1 و
Path2 نام‌گذاری می‌شوند تا بتوان همگام‌سازی‌های جداگانه‌ای را برای دایرکتوری‌های مجزا
درون درخت تنظیم کرد، مانند:
\f[V]path_to_local_tree..dropbox_subdir.lst\f[R].
.PP
پس از همگام‌سازی، هر دایرکتوری خالی در هر دو سیستم‌فایل Path1 و Path2
به‌طور پیش‌فرض حذف نمی‌شود، مگر اینکه
\f[V]--create-empty-src-dirs\f[R] مشخص شده باشد.
اگر پرچم \f[V]--remove-empty-dirs\f[R] مشخص شود، در آخرین مرحله فرایند،
تمام دایرکتوری‌های خالی در هر دو مسیر پاک‌سازی خواهند شد.
.SS پرچم‌های خط فرمان (Command-line flags)
.SS --resync
.PP
این گزینه عملاً باعث می‌شود هر دو سیستم‌فایل Path1 و Path2 شامل یک
ابرمجموعه منطبق از همه فایل‌ها باشند.
به‌طور پیش‌فرض، فایل‌های موجود در Path2 که در Path1 وجود ندارند به
Path1 کپی می‌شوند، و فرایند سپس درخت Path1 را به Path2 کپی می‌کند.
.PP
توالی \f[V]--resync\f[R] تقریباً معادل دستورهای زیر است
(اما برای گزینه‌های دیگر \f[V]--resync-mode\f[R] را ببینید):
.IP
.nf
\f[C]
rclone copy Path2 Path1 --ignore-existing [--create-empty-src-dirs]
rclone copy Path1 Path2 [--create-empty-src-dirs]
\f[R]
.fi
.PP
دایرکتوری‌های پایه در هر دو سیستم‌فایل Path1 و Path2 باید وجود داشته باشند، در غیر
این صورت bisync شکست خواهد خورد.
این مورد برای ایمنی لازم است - تا bisync بتواند معتبر بودن هر دو مسیر را
تأیید کند.
.PP
هنگام استفاده از \f[V]--resync\f[R]، نسخه جدیدتر یک فایل در سیستم‌فایل Path2
(به‌طور پیش‌فرض) با نسخه سیستم‌فایل Path1 بازنویسی خواهد شد.
(توجه داشته باشید که این رفتار کاملاً متقارن نیست
(https://github.com/rclone/rclone/issues/5681#issuecomment-938761815)،
و گزینه‌های متقارن‌تری را می‌توان با پرچم \f[V]--resync-mode\f[R]
مشخص کرد.)
تغییرات (deltas) را با دقت و با استفاده از
--dry-run (https://rclone.org/flags/#non-backend-flags) ارزیابی کنید.
.PP
برای اجرای همگام‌سازی مجدد (resync)، یکی از مسیرها می‌تواند خالی باشد (هیچ فایلی
در درخت مسیر وجود نداشته باشد).
اجرای resync باید به وجود فایل‌ها در هر دو مسیر منجر شود، در غیر این صورت یک
اجرای عادی غیر-resync با شکست مواجه خواهد شد.
.PP
در یک اجرای غیر-resync، خالی بودن هر یک از مسیرها (نبود هیچ فایلی در درخت)
با این خطا شکست می‌خورد:
\f[V]Empty current PathN listing. Cannot sync to an empty directory: X.pathN.lst\f[R]
این یک بررسی ایمنی است تا اطمینان حاصل شود که یک مسیر خالی غیرمنتظره منجر به
حذف \f[B]همه چیز\f[R] در مسیر دیگر نشود.
.PP
توجه داشته باشید که \f[V]--resync\f[R] به معنی \f[V]--resync-mode path1\f[R]
است، مگر اینکه \f[V]--resync-mode\f[R] متفاوتی صراحتاً مشخص شده باشد.
نیازی به استفاده هم‌زمان از هر دو پرچم \f[V]--resync\f[R] و
\f[V]--resync-mode\f[R] نیست \-\- هر یک از آن‌ها بدون دیگری کافی است.
.PP
\f[B]نکته:\f[R] گزینه \f[V]--resync\f[R] (شامل \f[V]--resync-mode\f[R])
فقط باید در سه شرایط خاص (و نادر) استفاده شود:
.IP "1." 3
این \f[I]نخستین\f[R] اجرای bisync شما (بین این دو مسیر) است
.IP "2." 3
به‌تازگی تغییراتی در تنظیمات bisync خود ایجاد کرده‌اید (مانند ویرایش
محتویات \f[V]--filters-file\f[R])
.IP "3." 3
در اجرای قبلی خطایی رخ داده است، و در نتیجه، bisync اکنون
برای بازیابی به \f[V]--resync\f[R] نیاز دارد
.PP
در سایر مواقع، باید از \f[V]--resync\f[R] \f[I]صرف‌نظر کنید\f[R].
دلیل این است که \f[V]--resync\f[R] تنها هر سمت را به سمت دیگر \f[I]کپی\f[R]
(نه \f[I]همگام‌سازی\f[R]) می‌کند.
بنابراین، اگر برای هر اجرای bisync از \f[V]--resync\f[R] استفاده کنید،
هرگز حذف یک فایل ممکن نخواهد بود \-\- فایل حذف‌شده همواره در پایان هر اجرا
مجدداً ظاهر می‌شود (زیرا از سمت دیگر که هنوز در آن وجود دارد کپی می‌شود).
به همین ترتیب، تغییر نام یک فایل همیشه منجر به یک نسخه تکراری (هم نام قدیم
و هم نام جدید) در هر دو سمت خواهد شد.
.PP
اگر متوجه شدید که وقفه‌های مکرر ناشی از مورد شماره ۳ مشکل‌ساز است، به جای
اجرای خودکار \f[V]--resync\f[R]، راهکار پیشنهادی استفاده از پرچم‌های
\f[V]--resilient\f[R]، \f[V]--recover\f[R] و \f[V]--conflict-resolve\f[R]
است (به همراه حالت Graceful Shutdown در صورت نیاز) تا یک پیکربندی بسیار مقاوم
و خودکفا (\[dq]تنظیم کن و فراموشش کن\[dq]) برای bisync ایجاد شود که بتواند
به‌طور خودکار از تقریباً هر وقفه‌ای که با آن مواجه می‌شود بازیابی شود.
افزودن چیزی شبیه به موارد زیر را در نظر بگیرید:
.IP
.nf
\f[C]
--resilient --recover --max-lock 2m --conflict-resolve newer
\f[R]
.fi.SS --resync-mode CHOICE
.PP
در صورتی که فایلی در حین یک \f[V]--resync\f[R] در هر دو طرف متفاوت باشد، \f[V]--resync-mode\f[R] مشخص می‌کند که کدام نسخه روی نسخهٔ دیگر بازنویسی (overwrite) خواهد شد.
گزینه‌های پشتیبانی‌شده مشابه \f[V]--conflict-resolve\f[R] هستند.
برای همهٔ گزینه‌های زیر، نسخه‌ای که نگه داشته می‌شود به عنوان \[dq]برنده\[dq] (winner) و نسخه‌ای که رونویسی (حذف) می‌شود به عنوان \[dq]بازنده\[dq] (loser) نامیده می‌شود.
نام گزینه‌ها بر اساس \[dq]برنده\[dq] تعیین شده است:
.IP \[bu] 2
\f[V]path1\f[R] \- (پیش‌فرض) \- نسخهٔ موجود در Path1 بدون قید و شرط برنده در نظر گرفته می‌شود (صرف‌نظر از \f[V]modtime\f[R] و \f[V]size\f[R]، در صورت وجود).
این گزینه می‌تواند در صورتی مفید باشد که در زمان اجرای \f[V]--resync\f[R]، یکی از طرفین قابل اعتمادتر یا به‌روزتر از دیگری باشد.
.IP \[bu] 2
\f[V]path2\f[R] \- مشابه \f[V]path1\f[R]، با این تفاوت که نسخهٔ path2 به عنوان برنده در نظر گرفته می‌شود.
.IP \[bu] 2
\f[V]newer\f[R] \- فایل تازه‌تر (بر اساس \f[V]modtime\f[R]) بدون در نظر گرفتن اینکه از کدام طرف آمده، برنده محسوب می‌شود.
این ممکن است منجر به ترکیبی از برخی برندگان از Path1 و برخی برندگان از Path2 شود.
(پیاده‌سازی این حالت مشابه اجرای \f[V]rclone copy --update\f[R] در هر دو جهت است.)
.IP \[bu] 2
\f[V]older\f[R] \- مشابه \f[V]newer\f[R]، با این تفاوت که فایل قدیمی‌تر به عنوان برنده و فایل جدیدتر به عنوان بازنده در نظر گرفته می‌شود.
.IP \[bu] 2
\f[V]larger\f[R] \- فایل بزرگ‌تر (بر اساس \f[V]size\f[R]) برنده در نظر گرفته می‌شود (صرف‌نظر از \f[V]modtime\f[R]، در صورت وجود).
این می‌تواند گزینه‌ای مفید برای remoteهایی باشد که از \f[V]modtime\f[R] پشتیبانی نمی‌کنند، یا برای فایل‌هایی (مانند فایل‌های لاگ) که در طول زمان معمولاً افزایش حجم دارند نه کاهش.
.IP \[bu] 2
\f[V]smaller\f[R] \- فایل کوچک‌تر (بر اساس \f[V]size\f[R]) برنده در نظر گرفته می‌شود (صرف‌نظر از \f[V]modtime\f[R]، در صورت وجود).
.PP
برای تمام گزینه‌های بالا، به موارد زیر توجه داشته باشید:
.IP \[bu] 2
اگر هر یک از remoteهای زیربنایی از روش انتخابی پشتیبانی نکنند، نادیده گرفته شده و به مقدار پیش‌فرض یعنی \f[V]path1\f[R] بازمی‌گردد.
(برای مثال، اگر \f[V]--resync-mode newer\f[R] تنظیم شده باشد، اما یکی از مسیرها از یک remote استفاده کند که از \f[V]modtime\f[R] پشتیبانی نمی‌کند.)
.IP \[bu] 2
اگر نتوان برنده‌ای را تعیین کرد زیرا مشخصهٔ روش انتخابی وجود ندارد یا یکسان است، این مشخصه نادیده گرفته می‌شود و bisync در عوض با بررسی سایر روش‌های فعال \f[V]--compare\f[R]، تلاش می‌کند تشخیص دهد که آیا فایل‌ها متفاوت هستند یا خیر.
(برای نمونه، اگر \f[V]--resync-mode newer\f[R] تنظیم شده باشد، اما مقادیر modtime در Path1 و Path2 یکسان باشند، bisync اندازه‌ها را مقایسه خواهد کرد.)
اگر bisync به این نتیجه برسد که فایل‌ها تفاوت دارند، اولویت به هر کدام داده می‌شود که در آن لحظه \[dq]source\[dq] باشد.
(در عمل، این یک مزیت جزئی به Path2 می‌دهد، زیرا کپی 2to1 قبل از کپی 1to2 انجام می‌شود.)
اگر فایل‌ها تفاوتی \f[I]نداشته باشند\f[R]، چیزی کپی نمی‌شود (زیرا هر دو طرف از قبل صحیح هستند).
.IP \[bu] 2
این گزینه‌ها فقط برای فایل‌هایی اعمال می‌شوند که در هر دو طرف وجود دارند (با نام و مسیر نسبی یکسان).
فایل‌هایی که \f[I]تنها\f[R] در یک طرف هستند و در طرف دیگر وجود ندارند، در طول \f[V]--resync\f[R] \f[I]همواره\f[R] به طرف دیگر کپی می‌شوند (این یکی از تفاوت‌های اصلی بین اجراهای resync و اجراهای عادی است).
.IP \[bu] 2
گزینه‌های \f[V]--conflict-resolve\f[R]، \f[V]--conflict-loser\f[R] و \f[V]--conflict-suffix\f[R] در طول \f[V]--resync\f[R] اعمال نمی‌شوند و برخلاف این پرچم‌ها، هیچ فایلی در حین \f[V]--resync\f[R] تغییر نام نمی‌یابد.
وقتی فایلی در طول \f[V]--resync\f[R] در هر دو طرف متفاوت باشد، همواره یک نسخه روی نسخهٔ دیگر بازنویسی می‌شود (درست مانند \f[V]rclone copy\f[R]).
(استفاده از \f[V]--backup-dir\f[R] را برای نگهداری نسخهٔ پشتیبان از نسخهٔ بازنده در نظر بگیرید.)
.IP \[bu] 2
برخلاف \f[V]--conflict-resolve\f[R]، پرچم \f[V]--resync-mode none\f[R] یک گزینهٔ معتبر نیست (یا بهتر بگوییم، به عنوان \[dq]عدم resync\[dq] تفسیر می‌شود، مگر اینکه \f[V]--resync\f[R] نیز مشخص شده باشد، که در این حالت نادیده گرفته خواهد شد.)
.IP \[bu] 2
برندگان و بازندگان فقط در سطح فایل‌های جداگانه تعیین می‌شوند (در حال حاضر گزینه‌ای برای انتخاب کامل و اتمیک یک دایرکتوری برنده وجود ندارد، اگرچه گزینه‌های \f[V]path1\f[R] و \f[V]path2\f[R] معمولاً نتیجه‌ای مشابه تولید می‌کنند.)
.IP \[bu] 2
جهت حفظ سازگاری عقبرو (backward-compatibility)، پرچم \f[V]--resync\f[R] به معنای \f[V]--resync-mode path1\f[R] خواهد بود، مگر اینکه یک \f[V]--resync-mode\f[R] دیگر به طور صریح مشخص شود.
به طور مشابه، تمام گزینه‌های \f[V]--resync-mode\f[R] (به جز \f[V]none\f[R]) به صورت ضمنی بیانگر \f[V]--resync\f[R] هستند؛ بنابراین نیازی به استفادهٔ هم‌زمان از هر دو پرچم \f[V]--resync\f[R] و \f[V]--resync-mode\f[R] نیست \- استفاده از هر کدام به تنهایی کافی است..SS --check-access
.PP
فایل‌های بررسی دسترسی یک تدبیر ایمنی مضاعف در برابر از دست رفتن داده‌ها هستند.
bisync اطمینان حاصل می‌کند که فایل‌های منطبق \f[V]RCLONE_TEST\f[R] را در مکان‌های یکسان در سیستم‌فایل‌های Path1 و Path2 پیدا کند.
فایل‌های \f[V]RCLONE_TEST\f[R] به‌طور خودکار تولید نمی‌شوند.
برای اینکه \f[V]--check-access\f[R] موفق شود، ابتدا باید یکی از این دو کار را انجام دهید:
\f[B]A)\f[R] یک یا چند فایل \f[V]RCLONE_TEST\f[R] را در هر دو سیستم قرار دهید، یا \f[B]B)\f[R] گزینه \f[V]--check-filename\f[R] را روی نام فایلی تنظیم کنید که هم‌اکنون در مکان‌های مختلف در سرتاسر مجموعه فایل‌های همگام‌شده شما استفاده می‌شود.
روش‌های توصیه‌شده برای \f[B]A)\f[R] شامل موارد زیر است:
.IP \[bu] 2
\f[V]rclone touch Path1/RCLONE_TEST\f[R] (ایجاد یک فایل جدید)
.IP \[bu] 2
\f[V]rclone copyto Path1/RCLONE_TEST Path2/RCLONE_TEST\f[R] (رونوشت از یک فایل موجود)
.IP \[bu] 2
\f[V]rclone copy Path1/RCLONE_TEST Path2/RCLONE_TEST  --include \[dq]RCLONE_TEST\[dq]\f[R]
(رونوشت از چندین فایل به‌صورت هم‌زمان و بازگشتی)
.IP \[bu] 2
ایجاد دستی فایل‌ها (خارج از rclone)
.IP \[bu] 2
اجرای یک‌باره \f[V]bisync\f[R] \f[I]بدون\f[R] \f[V]--check-access\f[R] برای تنظیم فایل‌های منطبق روی هر دو سیستم‌فایل نیز کار خواهد کرد، اما به دلیل احتمال خطای کاربر ترجیح داده نمی‌شود (شما موقتاً این ویژگی ایمنی را غیرفعال می‌کنید).
.PP
توجه داشته باشید که \f[V]--check-access\f[R] همچنان بر روی \f[V]--resync\f[R] اعمال می‌شود، بنابراین \f[V]bisync --resync --check-access\f[R] به عنوان روشی برای تنظیم اولیه فایل‌ها کار نخواهد کرد (این برای اطمینان از این است که bisync نتواند ناخواسته کلید ایمنی خود را دور بزند (https://forum.rclone.org/t/bisync-bugs-and-feature-requests/37636#:~:text=3.%20%2D%2Dcheck%2Daccess%20doesn%27t%20always%20fail%20when%20it%20should)).
.PP
برچسب‌های زمانی و محتویات فایل‌ها برای فایل‌های \f[V]RCLONE_TEST\f[R] اهمیتی ندارند، تنها نام‌ها و مکان‌ها مهم هستند.
اگر در درخت همگام‌سازی خود پیوندهای نمادین دارید، توصیه می‌شود فایل‌های \f[V]RCLONE_TEST\f[R] را در درخت دایرکتوری مقصدِ پیوند قرار دهید تا چنانچه درخت مقصد در دسترس نباشد، از اینکه bisync تصور کند دسته‌ای از فایل‌ها حذف شده‌اند محافظت به عمل آید.
همچنین پرچم --check-filename را ببینید.
.SS --check-filename
.PP
نام فایل(ها)ی مورد استفاده در اعتبارسنجی سلامت دسترسی.
مقدار پیش‌فرض \f[V]--check-filename\f[R] برابر با \f[V]RCLONE_TEST\f[R] است.
یک یا چند فایل با این نام فایل باید به صورت همگام‌شده میان مجموعه فایل‌های مبدأ و مقصد شما وجود داشته باشند تا \f[V]--check-access\f[R] با موفقیت انجام شود.
برای جزئیات بیشتر به --check-access مراجعه کنید.
.SS --compare
.PP
از نسخه \f[V]v1.66\f[R]، برنامه bisync به طور کامل از مقایسه بر اساس هر ترکیبی از size، modtime و checksum پشتیبانی می‌کند (محدودیت قبلی روی backendهای فاقد پشتیبانی از modtime برداشته شده است).
.PP
به‌طور پیش‌فرض (بدون پرچم \f[V]--compare\f[R])، bisync همان گزینه‌های مقایسه \f[V]sync\f[R] را به ارث می‌برد (یعنی به‌طور پیش‌فرض \f[V]size\f[R] و \f[V]modtime\f[R]، مگر اینکه با پرچم‌هایی مانند \f[V]--checksum\f[R] (https://rclone.org/docs/#c-checksum) یا \f[V]--size-only\f[R] تغییر یافته باشند).
.PP
اگر پرچم \f[V]--compare\f[R] تنظیم شود، این مقادیر پیش‌فرض را بازنویسی می‌کند.
این قابلیت در صورتی مفید است که بخواهید بر اساس ترکیب‌هایی مقایسه انجام دهید که هم‌اکنون در \f[V]sync\f[R] پشتیبانی نمی‌شوند، مانند مقایسه هم‌زمان هر سه مورد \f[V]size\f[R] و \f[V]modtime\f[R] و \f[V]checksum\f[R] (یا صرفاً \f[V]modtime\f[R] و \f[V]checksum\f[R]).
.PP
گزینه \f[V]--compare\f[R] یک فهرست جداشده با کاما دریافت می‌کند و مقادیری که در حال حاضر پشتیبانی می‌شوند شامل \f[V]size\f[R]، \f[V]modtime\f[R] و \f[V]checksum\f[R] هستند.
برای نمونه، اگر می‌خواهید size و checksum را مقایسه کنید، اما modtime را مقایسه نکنید، این‌گونه عمل می‌کنید:
.IP
.nf
\f[C]
--compare size,checksum
\f[R]
.fi
.PP
یا اگر بخواهید هر سه مورد را مقایسه کنید:
.IP
.nf
\f[C]
--compare size,modtime,checksum
\f[R]
.fi
.PP
گزینه \f[V]--compare\f[R] پرچم‌های متناقض را لغو و بازنویسی می‌کند.
برای نمونه، اگر پرچم‌های متناقض \f[V]--compare checksum --size-only\f[R] را تنظیم کنید، گزینه \f[V]--size-only\f[R] نادیده گرفته می‌شود و bisync ویژگی checksum را مقایسه خواهد کرد، نه size را.
برای جلوگیری از سردرگمی، توصیه می‌شود \f[I]یا\f[R] از \f[V]--compare\f[R] استفاده کنید و یا از پرچم‌های استاندارد \f[V]sync\f[R]، و هر دو را با هم به کار نبرید.
.PP
اگر \f[V]--compare\f[R] شامل \f[V]checksum\f[R] باشد و هر دو ریموت از checksum پشتیبانی کنند اما هیچ نوع هش مشترکی میان آن‌ها وجود نداشته باشد، checksumها \f[I]تنها\f[R] برای مقایسه‌های درون یک سمت در نظر گرفته می‌شوند (جهت تعیین مواردی که از زمان همگام‌سازی پیشین تغییر کرده‌اند)، نه برای مقایسه در برابر سمت مقابل.
اگر یک سمت از checksum پشتیبانی کند و سمت دیگر پشتیبانی نکند، checksumها تنها در همان سمتی که پشتیبانی دارد لحاظ خواهند شد.
.PP
هنگام مقایسه با \f[V]checksum\f[R] و/یا \f[V]size\f[R] بدون \f[V]modtime\f[R]، برنامه bisync نمی‌تواند تشخیص دهد که آیا یک فایل \f[V]newer\f[R] است یا \f[V]older\f[R] -- تنها می‌تواند تشخیص دهد که \f[V]changed\f[R] است یا \f[V]unchanged\f[R].
(اگر در هر دو سمت \f[V]changed\f[R] باشد، bisync همچنان بررسی استاندارد برابری را انجام می‌دهد تا مگر در صورت لزوم قطعی، از اعلام تداخل همگام‌سازی خودداری کند.)
.PP
توصیه می‌شود هنگام تغییر تنظیمات \f[V]--compare\f[R]، یک بار \f[V]--resync\f[R] اجرا کنید؛ در غیر این صورت ممکن است فایل‌های فهرست پیشین شما حاوی مشخصاتی که مایل به مقایسه آن‌ها هستید نباشند (برای نمونه، اگر پیش از این چک‌سام‌ها را مقایسه نمی‌کردید، مقادیر ذخیره‌شده checksum نخواهند داشت)..SS --ignore-listing-checksum
.PP
هنگامی که \f[V]--checksum\f[R] یا \f[V]--compare checksum\f[R] تنظیم شده باشد، bisync هنگام ایجاد فهرست‌ها برای هر دو مسیر، چک‌سام‌ها را (برای backendهایی که از آن‌ها پشتیبانی می‌کنند) دریافت (یا تولید) کرده و آن‌ها را در فایل‌های فهرست ذخیره می‌کند.
گزینهٔ \f[V]--ignore-listing-checksum\f[R] این رفتار را غیرفعال می‌کند، که ممکن است سرعت کار را به‌طور چشمگیری افزایش دهد، به‌ویژه در backendهایی (مانند local (https://rclone.org/local)) که هش‌ها باید در لحظه محاسبه شوند، نه اینکه از پیش دریافت گردند.
لطفاً به موارد زیر توجه داشته باشید:
.IP \[bu] 2
از نسخهٔ \f[V]v1.66\f[R] به بعد، هنگامی که نه \f[V]--checksum\f[R] و نه \f[V]--compare checksum\f[R] در حال استفاده نباشند، گزینهٔ \f[V]--ignore-listing-checksum\f[R] اکنون به‌طور خودکار تنظیم می‌شود (چرا که از چک‌سام‌ها برای هیچ منظوری استفاده نخواهد شد).
.IP \[bu] 2
گزینهٔ \f[V]--ignore-listing-checksum\f[R] با \f[V]--ignore-checksum\f[R] (https://rclone.org/docs#ignore-checksum) یکسان نیست، و ممکن است بخواهید از یکی از آن‌ها یا هر دو استفاده کنید.
به طور خلاصه: \f[V]--ignore-listing-checksum\f[R] مشخص می‌کند که آیا چک‌سام‌ها هنگام پویش برای یافتن تفاوت‌ها در نظر گرفته شوند یا خیر، در حالی که \f[V]--ignore-checksum\f[R] کنترل می‌کند که در صورت وجود تفاوت، آیا در عملیات‌های کپی/همگام‌سازی پس از آن چک‌سام‌ها لحاظ شوند یا خیر.
.IP \[bu] 2
مگر اینکه \f[V]--ignore-listing-checksum\f[R] ارسال شده باشد، bisync در حال حاضر هش‌ها را برای یک مسیر محاسبه می‌کند \f[I]حتی زمانی که هیچ هش مشترکی با مسیر دیگر وجود نداشته باشد\f[R] (برای مثال، یک ریموت crypt (https://rclone.org/crypt#modification-times-and-hashes)).
این می‌تواند همچنان مفید باشد، زیرا هش‌ها همچنان برای تشخیص تغییرات در همان سمت به کار خواهند رفت (اگر \f[V]--checksum\f[R] یا \f[V]--compare checksum\f[R] تنظیم شده باشد)، حتی اگر نتوان از آن‌ها برای مقایسه با سمت مقابل استفاده کرد.
.IP \[bu] 2
اگر مایلید چک‌سام‌های فهرست‌برداری را \f[I]فقط\f[R] در ریموت‌هایی که محاسبهٔ آن‌ها کند است نادیده بگیرید، استفاده از \f[V]--no-slow-hash\f[R] (یا \f[V]--slow-hash-sync-only\f[R]) را به جای \f[V]--ignore-listing-checksum\f[R] در نظر بگیرید.
.IP \[bu] 2
اگر \f[V]--ignore-listing-checksum\f[R] هم‌زمان با \f[V]--compare checksum\f[R] (یا \f[V]--checksum\f[R]) استفاده شود، چک‌سام‌ها برای تغییرات تفاضلی (delta) در bisync نادیده گرفته می‌شوند، اما همچنان در عملیات همگام‌سازی پس از آن در نظر گرفته خواهند شد (اگر تفاوت‌ها بر اساس modtime یا size تشخیص داده شده باشند).
.SS --no-slow-hash
.PP
در برخی ریموت‌ها (به‌ویژه \f[V]local\f[R])، چک‌سام‌ها می‌توانند سرعت اجرای bisync را به‌شدت کاهش دهند، زیرا هش‌ها قابل ذخیره‌سازی نیستند و لازم است هنگام درخواست به‌صورت بلادرنگ محاسبه شوند.
در ریموت‌های دیگر (مانند \f[V]drive\f[R])، آن‌ها عملاً هیچ زمانی به فرایند اضافه نمی‌کنند.
پرچم \f[V]--no-slow-hash\f[R] به‌طور خودکار چک‌سام‌ها را در ریموت‌هایی که کند هستند نادیده می‌گیرد، در حالی که همچنان آن‌ها را در بقیه مقایسه می‌کند (با فرض اینکه \f[V]--compare\f[R] شامل \f[V]checksum\f[R] باشد).
این پرچم زمانی کاربرد دارد که یکی از مسیرهای bisync شما کند است اما شما همچنان برای یک همگام‌سازی مطمئن‌تر، می‌خواهید چک‌سام‌ها را در مسیر دیگر بررسی کنید.
.SS --slow-hash-sync-only
.PP
مشابه با \f[V]--no-slow-hash\f[R] است، با این تفاوت که هش‌های کند همچنان در حین فراخوانی‌های همگام‌سازی در نظر گرفته می‌شوند.
آن‌ها همچنان برای تعیین تغییرات تفاضلی (delta) در نظر گرفته نمی‌شوند، و در فهرست‌ها نیز گنجانده نخواهند شد.
همچنین در حین اجرای \f[V]--resync\f[R] نادیده گرفته می‌شوند.
مورد کاربرد اصلی این پرچم زمانی است که تعداد بسیار زیادی فایل دارید، اما تعداد نسبتاً اندکی از آن‌ها از یک اجرا تا اجرای بعدی تغییر می‌کنند -- بنابراین نمی‌خواهید کل درخت فایل‌هایتان را هر بار بررسی کنید (زیرا بسیار زمان‌بر خواهد بود)، اما همچنان تمایل دارید چک‌سام‌ها را برای گروه کوچکتری از فایل‌ها که تغییر در \f[V]modtime\f[R] یا \f[V]size\f[R] آن‌ها شناسایی شده است لحاظ کنید.
به یاد داشته باشید که این افزایش سرعت با یک مصالحه در امنیت همراه است: اگر محتوای فایلی بدون تغییر در \f[V]modtime\f[R] یا \f[V]size\f[R] آن تغییر کند، bisync آن را شناسایی نخواهد کرد و همگام‌سازی نخواهد شد.
.PP
گزینهٔ \f[V]--slow-hash-sync-only\f[R] تنها در صورتی مفید است که هر دو ریموت از یک نوع هش مشترک پشتیبانی کنند (در غیر این صورت، bisync به‌طور خودکار به حالت \f[V]--no-slow-hash\f[R] بازمی‌گردد).
هر دو گزینهٔ \f[V]--no-slow-hash\f[R] و \f[V]--slow-hash-sync-only\f[R] بدون استفاده از \f[V]--compare checksum\f[R] (یا \f[V]--checksum\f[R]) هیچ اثری نخواهند داشت..SS --download-hash
.PP
اگر \f[V]--download-hash\f[R] تنظیم شود، در صورت عدم دسترسی به چsumک‌سام‌ها از روش‌های معمول (برای نمونه، یک ریموت که از آن‌ها پشتیبانی نمی‌کند)، bisync بیشترین تلاش خود را به کار می‌بندد تا با دانلود و محاسبه بلادرنگ (on-the-fly)، چک‌سام MD5 را به دست آورد.
توجه داشته باشید از آنجا که rclone باید تمام فایل را دانلود کند، این کار ممکن است سرعت اجرای bisync را به‌شدت کاهش دهد و همچنین احتمالاً حجم داده زیادی مصرف کند؛ بنابراین برای مسیرهای bisync با حجم کل فایل‌های بالا عملاً کاربردی نخواهد بود.
با این حال، می‌تواند گزینه مناسبی برای همگام‌سازی فایل‌های کوچک اما حیاتی با بیشترین دقت باشد (برای نمونه، یک مخزن کد منبع روی یک ریموت \f[V]crypt\f[R]).
یک مزیت دیگر نسبت به روش‌هایی مانند \f[V]cryptcheck\f[R] (https://rclone.org/commands/rclone_cryptcheck) این است که فایل اصلی برای مقایسه نیاز نیست (برای مثال، \f[V]--download-hash\f[R] می‌تواند برای همگام‌سازی دوسویه دو ریموت مختلف crypt با گذرواژه‌های متفاوت به کار رود).
.PP
هنگامی که \f[V]--download-hash\f[R] تنظیم شده باشد، bisync همچنان ابتدا به دنبال چک‌سام‌های بهینه‌تر می‌گردد و تنها زمانی که هیچ‌کدام یافت نشوند، به دانلود فایل متوسل می‌شود.
این پرچم نسبت به پرچم‌های ناسازگار مانند \f[V]--no-slow-hash\f[R] اولویت دارد.
گزینه \f[V]--download-hash\f[R] برای Google Docs و سایر فایل‌های با حجم نامشخص مناسب نیست، زیرا چک‌سام آن‌ها از یک اجرا تا اجرای بعدی تغییر می‌کند (به دلیل تغییرات جزئی در ساختار داخلی فایل خروجی تولیدشده).
بنابراین، bisync به‌طور خودکار \f[V]--download-hash\f[R] را برای فایل‌های با اندازه کمتر از ۰ نادیده می‌گیرد.
.PP
همچنین ببینید: بک‌اند \f[V]Hasher\f[R] (https://rclone.org/hasher)، دستور \f[V]cryptcheck\f[R] (https://rclone.org/commands/rclone_cryptcheck)، گزینه \f[V]rclone check --download\f[R] (https://rclone.org/commands/rclone_check) و دستور \f[V]md5sum\f[R] (https://rclone.org/commands/rclone_md5sum).
.SS --max-delete
.PP
به عنوان یک بررسی امنیتی، اگر بیش از درصد مشخص‌شده در \f[V]--max-delete\f[R] از فایل‌ها در هر یک از سیستم‌های فایل Path1 یا Path2 حذف شده باشند، bisync بدون اعمال هیچ تغییری، همراه با یک پیام هشدار لغو خواهد شد.
مقدار پیش‌فرض \f[V]--max-delete\f[R] برابر با \f[V]50%\f[R] است.
یکی از راه‌های فعال شدن این محدودیت، تغییر نام پوشه‌ای است که بیش از نیمی از فایل‌های شما را شامل می‌شود.
این کار برای bisync به صورت دسته‌ای از فایل‌های حذف‌شده و دسته‌ای از فایل‌های جدید به نظر خواهد رسید.
این بررسی امنیتی برای جلوگیری از حذف تمامی فایل‌ها در هر دو سیستم فایل توسط bisync به دلیل اختلال موقت دسترسی به شبکه، یا در صورتی که کاربر به اشتباه فایل‌ها را در یک طرف حذف کرده باشد، طراحی شده است.
برای اجبار به همگام‌سازی، می‌توانید حد درصد حذف متفاوتی تعیین کنید، برای مثال \f[V]--max-delete 75\f[R] (امکان حذف تا ۷۵٪)، یا از \f[V]--force\f[R] برای نادیده گرفتن این بررسی استفاده کنید.
.PP
همچنین بررسی تغییر همه فایل‌ها (all files changed check) را ببینید.
.SS --filters-file
.PP
با استفاده از قابلیت‌های فیلتر rclone می‌توانید انواع فایل‌ها یا زیرشاخه‌های دایرکتوری را از همگام‌سازی مستثنی کنید.
بخش فیلترهای bisync و مستندات عمومی \f[V]--filter-from\f[R] (https://rclone.org/filtering/#filter-from-read-filtering-patterns-from-a-file) را ببینید.
یک فایل نمونه فیلترها، حاوی فیلترهایی برای فایل‌های غیرمجاز جهت همگام‌سازی با Dropbox است.
.PP
اگر تغییراتی در فایل فیلترهای خود ایجاد کنید، bisync نیازمند یک بار اجرا با گزینه \f[V]--resync\f[R] خواهد بود.
این یک قابلیت امنیتی است که از ناپدید به نظر رسیدن فایل‌های موجود در سمت Path1 و/یا Path2 (به دلیل مستثنی شدن آن‌ها در فهرست‌های جدید) جلوگیری می‌کند؛ چرا که در غیر این صورت bisync فریب خورده و آن‌ها را به عنوان فایل‌های حذف‌شده (در مقایسه با فهرست‌های اجرای قبلی) در نظر می‌گیرد و سپس اقدام به حذف واقعی آن‌ها خواهد کرد.
.PP
برای جلوگیری از وقوع این موضوع، bisync هش MD5 فایل فیلترها را محاسبه کرده و این هش را در یک فایل \f[V].md5\f[R] در همان محل فایل فیلترهای شما ذخیره می‌کند.
در اجرای بعدی با تنظیم بودن \f[V]--filters-file\f[R]، bisync هش MD5 فایل فیلترهای فعلی را دوباره محاسبه کرده و آن را با هش ذخیره‌شده در فایل \f[V].md5\f[R] مقایسه می‌کند.
اگر آن‌ها مطابقت نداشته باشند، اجرا با یک خطای حیاتی لغو شده و بدین ترتیب شما را وادار به اجرای \f[V]--resync\f[R] می‌کند، که به احتمال زیاد از بروز یک فاجعه جلوگیری خواهد کرد..SS --conflict-resolve CHOICE
.PP
در bisync، یک \[dq]تداخل\[dq] فایلی است که در \f[I]هر دو طرف\f[R] (نسبت به اجرای قبلی) \f[I]جدید\f[R] یا \f[I]تغییریافته\f[R] است و در حال حاضر در هر دو طرف \f[I]یکسان نیست\f[R].
گزینهٔ \f[V]--conflict-resolve\f[R] نحوهٔ برخورد bisync با چنین سناریویی را کنترل می‌کند.
گزینه‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.IP \[bu] 2
\f[V]none\f[R] \- (پیش‌فرض) \- تلاشی برای انتخاب برنده نکن، هر دو فایل را بر اساس تنظیمات \f[V]--conflict-loser\f[R] و \f[V]--conflict-suffix\f[R] نگه داشته و تغییر نام بده.
برای مثال، با تنظیمات پیش‌فرض، \f[V]file.txt\f[R] در Path1 به \f[V]file.txt.conflict1\f[R] و \f[V]file.txt\f[R] در Path2 به \f[V]file.txt.conflict2\f[R] تغییر نام می‌یابد.
هر دو در طول اجرا در مسیر مقابل کپی می‌شوند، بنابراین در نهایت هر دو طرف یک نسخه از هر دو فایل را خواهند داشت.
(از آنجا که \f[V]none\f[R] حالت پیش‌فرض است، نیازی به تعیین \f[V]--conflict-resolve none\f[R] نیست \-\- می‌توانید این پرچم را نادیده بگیرید.)
.IP \[bu] 2
\f[V]newer\f[R] \- فایل تازه‌تر (بر اساس \f[V]modtime\f[R]) به عنوان برنده در نظر گرفته شده و بدون تغییر نام کپی می‌شود.
فایل قدیمی‌تر (\[dq]بازنده\[dq]) بر اساس تنظیمات \f[V]--conflict-loser\f[R] و \f[V]--conflict-suffix\f[R] مدیریت می‌شود (یا تغییر نام می‌یابد یا حذف می‌شود).
برای مثال، اگر \f[V]file.txt\f[R] در Path1 جدیدتر از \f[V]file.txt\f[R] در Path2 باشد، نتیجه در هر دو طرف (با سایر تنظیمات پیش‌فرض) \f[V]file.txt\f[R] (برنده از Path1) و \f[V]file.txt.conflict1\f[R] (بازنده از Path2) خواهد بود.
.IP \[bu] 2
\f[V]older\f[R] \- همانند \f[V]newer\f[R]، با این تفاوت که فایل قدیمی‌تر به عنوان برنده و فایل جدیدتر به عنوان بازنده در نظر گرفته می‌شود.
.IP \[bu] 2
\f[V]larger\f[R] \- فایل بزرگ‌تر (بر اساس \f[V]size\f[R]) برنده در نظر گرفته می‌شود (صرف‌نظر از \f[V]modtime\f[R]، در صورت وجود).
.IP \[bu] 2
\f[V]smaller\f[R] \- فایل کوچک‌تر (بر اساس \f[V]size\f[R]) برنده در نظر گرفته می‌شود (صرف‌نظر از \f[V]modtime\f[R]، در صورت وجود).
.IP \[bu] 2
\f[V]path1\f[R] \- نسخهٔ Path1 بدون قید و شرط برنده در نظر گرفته می‌شود (صرف‌نظر از \f[V]modtime\f[R] و \f[V]size\f[R]، در صورت وجود).
این گزینه می‌تواند زمانی مفید باشد که یک طرف معمولاً قابل‌اعتمادتر یا به‌روزتر از طرف دیگر باشد.
.IP \[bu] 2
\f[V]path2\f[R] \- همانند \f[V]path1\f[R]، با این تفاوت که نسخهٔ Path2 برنده در نظر گرفته می‌شود.
.PP
برای تمامی گزینه‌های فوق، به نکات زیر توجه کنید:
.IP \[bu] 2
اگر هر یک از ریموت‌های زیربنایی از روش انتخاب‌شده پشتیبانی نکنند، نادیده گرفته شده و به \f[V]none\f[R] بازگردانی می‌شود.
(برای مثال، اگر \f[V]--conflict-resolve newer\f[R] تنظیم شده باشد، اما یکی از مسیرها از ریموتی استفاده کند که از \f[V]modtime\f[R] پشتیبانی نمی‌کند.)
.IP \[bu] 2
اگر نتوان برنده‌ای را تعیین کرد به این دلیل که ویژگی مربوط به روش انتخابی وجود ندارد یا برابر است، نادیده گرفته شده و به \f[V]none\f[R] بازگردانی می‌شود.
(برای مثال، اگر \f[V]--conflict-resolve newer\f[R] تنظیم شده باشد، اما \f[V]modtime\f[R] در Path1 و Path2 یکسان باشد، حتی اگر اندازه‌ها متفاوت باشند.)
.IP \[bu] 2
اگر محتوای فایل در حال حاضر در هر دو طرف یکسان باشد، یک \[dq]تداخل\[dq] در نظر گرفته نمی‌شود، حتی اگر از زمان همگام‌سازی قبلی در هر دو طرف جدید یا تغییر یافته باشد.
(برای مثال، اگر تغییری در یک طرف ایجاد کرده و سپس آن را از راه‌های دیگر با طرف دیگر همگام کرده باشید.)
بنابراین، هیچ‌یک از پرچم‌های حل تداخل در این سناریو اعمال نمی‌شوند.
.IP \[bu] 2
پرچم‌های حل تداخل در طول یک \f[V]--resync\f[R] اعمال نمی‌شوند، چرا که هیچ \[dq]اجرای قبلی\[dq] وجود ندارد (اما گزینه‌های مشابه را در \f[V]--resync-mode\f[R] ببینید.)
.SS --conflict-loser CHOICE
.PP
گزینهٔ \f[V]--conflict-loser\f[R] تعیین می‌کند چه بر سر \[dq]بازندهٔ\[dq] یک تداخل همگام‌سازی (زمانی که \f[V]--conflict-resolve\f[R] یک برنده تعیین کرده است) یا بر سر هر دو فایل (زمانی که برنده‌ای وجود ندارد) می‌آید.
گزینه‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.IP \[bu] 2
\f[V]num\f[R] \- (پیش‌فرض) \- شماره‌گذاری خودکار تداخل‌ها با افزودن خودکار شمارهٔ در دسترس بعدی به \f[V]--conflict-suffix\f[R]، به ترتیب زمانی.
برای مثال، با تنظیمات پیش‌فرض، نخستین تداخل برای \f[V]file.txt\f[R] به \f[V]file.txt.conflict1\f[R] تغییر نام می‌یابد.
اگر \f[V]file.txt.conflict1\f[R] از قبل وجود داشته باشد، به جای آن از \f[V]file.txt.conflict2\f[R] استفاده خواهد شد (و به همین ترتیب، تا حداکثر ۹۲۲۳۳۷۲۰۳۶۸۵۴۷۷۵۸۰۷ تداخل).
.IP \[bu] 2
\f[V]pathname\f[R] \- تغییر نام تداخل‌ها بر اساس سمتی که از آن آمده‌اند، که رفتار پیش‌فرض قبل از \f[V]v1.66\f[R] بود.
برای مثال، با \f[V]--conflict-suffix path\f[R]، فایل \f[V]file.txt\f[R] از Path1 به \f[V]file.txt.path1\f[R] و \f[V]file.txt\f[R] از Path2 به \f[V]file.txt.path2\f[R] تغییر نام خواهند یافت.
اگر دو پسوند نامتقارن و ناهمسان ارائه شود (مانند \f[V]--conflict-suffix cloud,local\f[R])، رقم انتهایی حذف می‌شود.
نکتهٔ مهم اینکه با \f[V]pathname\f[R]، هیچ شماره‌گذاری خودکاری فراتر از \f[V]2\f[R] وجود ندارد، بنابراین اگر \f[V]file.txt.path2\f[R] به نحوی از قبل وجود داشته باشد، رونویسی خواهد شد.
استفاده از یک متغیر پویای تاریخ در \f[V]--conflict-suffix\f[R] (به پایین مراجعه کنید) یکی از راه‌های ممکن برای جلوگیری از این موضوع است.
همچنین توجه داشته باشید که تداخل در تداخل (conflicts-of-conflicts) در صورتی که تداخل اصلی به‌صورت دستی حل نشود امکان‌پذیر است \-\- برای مثال، اگر به هر دلیلی \f[V]file.txt.path1\f[R] را در هر دو طرف ویرایش کنید، و این ویرایش‌ها متفاوت باشند، نتیجه \f[V]file.txt.path1.path1\f[R] و \f[V]file.txt.path1.path2\f[R] خواهد بود (علاوه بر \f[V]file.txt.path2\f[R]).
.IP \[bu] 2
\f[V]delete\f[R] \- تنها برنده را نگه دار و بازنده را به جای تغییر نام، حذف کن.
اگر برنده‌ای قابل تعیین نباشد (برای جزئیات در مورد چگونگی رخ دادن این حالت، \f[V]--conflict-resolve\f[R] را ببینید)، \f[V]delete\f[R] نادیده گرفته شده و به جای آن از گزینهٔ پیش‌فرض \f[V]num\f[R] استفاده می‌شود (یعنی هر دو نسخه نگهداری و تغییر نام داده می‌شوند و هیچ‌کدام حذف نمی‌شوند).
گزینهٔ \f[V]delete\f[R] ذاتاً مخرب‌ترین گزینه است، بنابراین تنها با احتیاط از آن استفاده کنید.
.PP
برای تمام گزینه‌های بالا، توجه داشته باشید که اگر برنده تعیین نشود (برای جزئیات درباره نحوهٔ رخ دادن این اتفاق به \f[V]--conflict-resolve\f[R] مراجعه کنید)، یا اگر \f[V]--conflict-resolve\f[R] در حال استفاده نباشد، \f[I]هر دو\f[R] فایل تغییر نام خواهند یافت..SS --conflict-suffix STRING[,STRING]
.PP
گزینهٔ \f[V]--conflict-suffix\f[R] پسوندی را کنترل می‌کند که هنگام تغییر نام یک \f[V]--conflict-loser\f[R] توسط bisync الحاق می‌شود (پیش‌فرض:
\f[V]conflict\f[R]).
گزینهٔ \f[V]--conflict-suffix\f[R] یک رشته یا دو رشتهٔ جدا شده با کاما را می‌پذیرد تا پسوندهای متفاوتی را به Path1 در برابر Path2 اختصاص دهد.
این ممکن است بعداً در شناسایی منشأ تعارض مفید باشد.
(برای مثال،
\f[V]--conflict-suffix dropboxconflict,laptopconflict\f[R])
.PP
با \f[V]--conflict-loser num\f[R]، همیشه یک عدد به پسوند الحاق می‌شود.
با \f[V]--conflict-loser pathname\f[R]، عدد تنها زمانی الحاق می‌شود که یک پسوند مشخص شده باشد (یا زمانی که دو پسوند یکسان مشخص شده باشند).
به این معنی که با \f[V]--conflict-loser pathname\f[R]، تمام موارد زیر نتیجه‌ای دقیقاً یکسان ایجاد می‌کنند:
.IP
.nf
\f[C]
--conflict-suffix path
--conflict-suffix path,path
--conflict-suffix path1,path2
\f[R]
.fi
.PP
پسوندها می‌توانند به کوتاهی ۱ نویسه باشند.
به‌طور پیش‌فرض، پسوند پس از هر پسوند فایل دیگری افزوده می‌شود (مثلاً
\f[V]file.jpg.conflict1\f[R])، با این حال، این رفتار را می‌توان با پرچم
\f[V]--suffix-keep-extension\f[R] (https://rclone.org/docs/#suffix-keep-extension)
تغییر داد (یعنی به طوری که در عوض به \f[V]file.conflict1.jpg\f[R] منجر شود).
.PP
گزینهٔ \f[V]--conflict-suffix\f[R] از چندین \f[I]متغیر پویای تاریخ\f[R] در صورت قرار گرفتن درون آکولاد به صورت الگوهای تطبیق (glob) پشتیبانی می‌کند.
این امر می‌تواند برای ردیابی تاریخ و/یا زمانی که هر تعارض توسط bisync مدیریت شده است مفید باشد.
برای مثال:
.IP
.nf
\f[C]
--conflict-suffix {DateOnly}-conflict
// result: myfile.txt.2006-01-02-conflict1
\f[R]
.fi
.PP
تمام قالب‌های توصیف‌شده در اینجا (ثابت‌های Time.Layout در go) (https://pkg.go.dev/time#pkg-constants) و در اینجا (مثال‌های Time.Format در go) (https://pkg.go.dev/time#example-Time.Format)
پشتیبانی می‌شوند، اما دقت کنید که قالب انتخابی شما از نویسه‌هایی که در ریموت‌های شما غیرمجاز هستند استفاده نکند (برای مثال، macOS اجازهٔ وجود دونقطه را در نام فایل‌ها نمی‌دهد، و همچنین بهتر است از اسلش‌ها خودداری شود زیرا اغلب به عنوان جداکنندهٔ دایرکتوری تفسیر می‌شوند.)
برای حل این مشکل ویژه، یک گزینهٔ اضافی
\f[V]{MacFriendlyTime}\f[R] (یا صرفاً \f[V]{mac}\f[R]) پشتیبانی می‌شود
که خروجی آن به صورت \f[V]2006-01-02 0304PM\f[R] خواهد بود.
.PP
توجه داشته باشید که \f[V]--conflict-suffix\f[R] کاملاً مستقل از پرچم اصلی
\f[V]--sufix\f[R] (https://rclone.org/docs/#suffix-string)
در rclone است.
این امر عمدی است، زیرا ممکن است کاربران بخواهند در صورت استفاده از \f[V]--backup-dir\f[R]، از هر دو پرچم به‌طور هم‌زمان استفاده کنند.
.PP
در نهایت، توجه داشته باشید که حالت پیش‌فرض در bisync پیش از \f[V]v1.66\f[R] تغییر نام موارد تعارض با \f[V]..path1\f[R] و \f[V]..path2\f[R] بود (با دو نقطه، و \f[V]path\f[R] به جای \f[V]conflict\f[R].)
اکنون Bisync به صورت پیش‌فرض از یک نقطه به جای دو نقطه استفاده می‌کند، اما می‌توان با گنجاندن نقطه‌های اضافی در رشتهٔ پسوند مشخص‌شده، آن‌ها را اضافه کرد.
به عنوان مثال، برای رفتاری معادل با پیش‌فرض قبلی، از این دستور استفاده کنید:
.IP
.nf
\f[C]
[--conflict-resolve none] --conflict-loser pathname --conflict-suffix .path
\f[R]
.fi
.SS --check-sync
.PP
عملکرد check-sync که به‌طور پیش‌فرض فعال است، بررسی می‌کند که آیا تمام فایل‌های مشابه در هر دو فهرست تاریخچهٔ Path1 و Path2 وجود دارند یا خیر.
این بررسی جامعیت \f[I]check-sync\f[R] به‌طور پیش‌فرض در پایان اجرای همگام‌سازی انجام می‌شود.
هرگونه کپی/حذف ناموفقِ به‌دام‌نیفتاده بین دو مسیر ممکن است منجر به تفاوت‌هایی بین دو فهرست و اختلاف محتوای ردیابی‌نشدهٔ فایل بین دو مسیر شود.
اجرای مجدد همگام‌سازی (resync) این خطا را تصحیح خواهد کرد.
.PP
توجه داشته باشید که بررسی جامعیتِ فعال به صورت پیش‌فرض، بارگذاری هر دو فهرست نهایی Path1 و Path2 را به صورت محلی اجرا می‌کند و در نتیجه به مدت‌زمان اجرای همگام‌سازی می‌افزاید.
استفاده از \f[V]--check-sync=false\f[R] آن را غیرفعال کرده و ممکن است زمان اجرای همگام‌سازی را برای تعداد بسیار زیادی از فایل‌ها به‌طور چشمگیری کاهش دهد.
.PP
این بررسی را می‌توان به‌صورت دستی با \f[V]--check-sync=only\f[R] اجرا کرد.
این گزینه تنها بررسی جامعیت را اجرا می‌کند و بدون همگام‌سازی واقعی خاتمه می‌یابد.
.PP
توجه داشته باشید که در حال حاضر، \f[V]--check-sync\f[R] \f[B]تنها رونوشت‌های فهرست را بررسی می‌کند و نه فایل‌های واقعی روی ریموت‌ها را.\f[R] همچنین توجه داشته باشید که رونوشت‌های فهرست از تغییراتی که در حین یا پس از آخرین اجرای bisync رخ داده است آگاه نخواهند شد، زیرا این تغییرات در اجرای بعدی کشف می‌شوند.
بنابراین، در حالی که فهرست‌ها باید همیشه در پایان اجرای bisync با \f[I]یکدیگر\f[R] مطابقت داشته باشند، در صورتی که تغییراتی در حین یا پس از اجرا وجود داشته باشد، \f[I]طبیعی است\f[R] که با ریموت‌های زیرین مطابقت نداشته باشند و ریموت‌ها نیز با یکدیگر منطبق نباشند.
این امر عادی است و هرگونه تفاوت در اجرای بعدی شناسایی و همگام‌سازی خواهد شد.
.PP
برای یک بررسی جامعیت دقیق از وضعیت فعلی ریموت‌ها (در مقابل صرفاً رونوشت‌های فهرست آن‌ها)، استفاده از \f[V]check\f[R]
(یا
\f[V]cryptcheck\f[R] (https://rclone.org/commands/rclone_cryptcheck)،
اگر حداقل یکی از مسیرها یک ریموت \f[V]crypt\f[R] باشد) را به جای
\f[V]--check-sync\f[R] مد نظر قرار دهید، با در نظر داشتن این نکته که در صورت تغییر فایل‌ها در حین یا پس از آخرین اجرای bisync، بروز تفاوت‌ها مورد انتظار است.
.PP
به‌عنوان مثال، یک توالی احتمالی می‌تواند به این شکل باشد:
.IP "1." 3
اجرای زمان‌بندی‌شدهٔ معمول bisync:
.RS 4
.IP
.nf
\f[C]
rclone bisync Path1 Path2 -MPc --check-access --max-delete 10 --filters-file /path/to/filters.txt -v --no-cleanup --ignore-listing-checksum --disable ListR --checkers=16 --drive-pacer-min-sleep=10ms --create-empty-src-dirs --resilient
\f[R]
.fi
.RE
.IP "2." 3
بررسی جامعیت دوره‌ای و مستقل (احتمالاً زمان‌بندی‌شده به‌صورت شبانه یا هفتگی):
.RS 4
.IP
.nf
\f[C]
rclone check -MvPc Path1 Path2 --filter-from /path/to/filters.txt
\f[R]
.fi
.RE
.IP "3." 3
اگر تفاوت‌هایی یافت شد، گزینه‌هایی برای تصحیح آن‌ها در اختیار دارید.
اگر یک طرف به‌روزتر است و می‌خواهید طرف دیگر را با آن مطابقت دهید، می‌توانید این دستور را اجرا کنید:
.RS 4
.IP
.nf
\f[C]
rclone sync Path1 Path2 --filter-from /path/to/filters.txt --create-empty-src-dirs -MPc -v
\f[R]
.fi
.RE
.PP
(یا جابه‌جا کردن Path1 و Path2 تا Path2 به منبع مرجع و موثق تبدیل شود)
.PP
یا اگر هیچ‌کدام از طرفین کاملاً به‌روز نیست، می‌توانید یک
\f[V]--resync\f[R] اجرا کنید تا دوباره با یکدیگر هماهنگ شوند (اما به خاطر داشته باشید که این کار می‌تواند باعث بازگشت مجدد فایل‌های حذف‌شده شود.)
.PP
*همچنین توجه داشته باشید که \f[V]rclone check\f[R] در حال حاضر شامل دایرکتوری‌های خالی نمی‌شود، بنابراین اگر می‌خواهید بدانید که آیا دایرکتوری خالیِ ناهمگامی وجود دارد یا خیر، می‌توانید دستور \f[V]rclone sync\f[R] بالا را با افزودن \f[V]--dry-run\f[R] اجرا کنید.
.PP
همچنین ببینید: Concurrent modifications، \f[V]--resilient\f[R].SS --resilient
.PP
به‌طور پیش‌فرض، بیشتر خطاها یا وقفه‌ها باعث لغو اجرای bisync و نیاز به
\f[V]--resync\f[R] برای بازیابی می‌شوند.
این یک ویژگی ایمنی است تا از اجرای دوبارهٔ bisync پیش از بررسی شرایط
توسط کاربر جلوگیری کند.
با این حال، در برخی موارد ممکن است bisync سخت‌گیرانه عمل کرده و حتی
در شرایطی که واقعاً نیازی نیست، قفلی اعمال کند؛ مانند خطاهای کم‌اهمیت‌تری
که ممکن است در اجرای بعدی خودبه‌خود برطرف شوند.
هنگامی که \f[V]--resilient\f[R] مشخص شود، bisync تمام توان خود را
برای بازیابی و خوداصلاحی به کار می‌گیرد و تنها به عنوان آخرین چاره و
زمانی که دخالت انسان کاملاً ضروری باشد، به \f[V]--resync\f[R] نیاز پیدا می‌کند.
کاربرد مدنظر این گزینه، اجرای bisync به عنوان یک فرایند پس‌زمینه
(مانند زمان‌بندی از طریق cron) است.
.PP
هنگام استفاده از حالت \f[V]--resilient\f[R]، برنامهٔ bisync همچنان
خطا را گزارش کرده و متوقف می‌شود، با این حال جلوی اجراهای بعدی را
مسدود نمی‌کند \- بدین ترتیب امکان تلاش دوباره در زمان‌بندی عادی بعدی،
بدون نیاز اولیه به \f[V]--resync\f[R] فراهم می‌گردد.
نمونه‌هایی از این خطاهای قابل تلاش مجدد شامل شکست در آزمایش‌های دسترسی،
نبود فایل‌های فهرست‌بندی (listing) و تشخیص تغییرات در فیلترها هستند.
این سازوکارهای ایمنی همچنان مانع ادامهٔ اجرای \f[I]کنونی\f[R]
می‌شوند \- تفاوت در این است که اگر تا زمان اجرای \f[I]بعدی\f[R]
شرایط بهبود یافته باشد، اجرای بعدی اجازهٔ پیشروی خواهد داشت.
برخی خطاهای جدی‌تر حتی در حالت \f[V]--resilient\f[R] نیز برای
جلوگیری از دست رفتن داده‌ها، انسداد مبتنی بر \f[V]--resync\f[R] را
اعمال خواهند کرد.
.PP
رفتار \f[V]--resilient\f[R] ممکن است در نسخه‌های آینده تغییر کند.
(همچنین ببینید: \f[V]--recover\f[R]، \f[V]--max-lock\f[R]، Graceful Shutdown)
.SS --recover
.PP
اگر \f[V]--recover\f[R] تنظیم شده باشد، در صورت بروز وقفه‌ای ناگهانی
یا هرگونه خاموش شدن غیرعادی (un-graceful shutdown)، bisync در اجرای بعدی
به جای الزام به اجرای \f[V]--resync\f[R]، تلاش خواهد کرد به‌طور خودکار
بازیابی شود.
برنامهٔ bisync می‌تواند با نگهداری همیشگی یک فهرست‌بندی \[dq]پشتیبان\[dq]
که نمایانگر وضعیت هر دو مسیر پس از آخرین همگام‌سازی موفقِ ثبت‌شده است،
بازیابی پایداری انجام دهد.
سپس bisync می‌تواند وضعیت کنونی را با این تصویر لحظه‌ای (snapshot)
مقایسه کند تا مشخص سازد چه تغییراتی نیاز به تلاش دوباره دارند.
تغییراتی که پس از این snapshot همگام شده‌اند (در طول اجرایی که بعداً دچار
وقفه شد) برای bisync به گونه‌ای به نظر می‌رسند که گویی \[dq]در هر دو طرف
جدید یا تغییر‌یافته\[dq] هستند، اما در بیشتر موارد مشکلی ایجاد نمی‌کند؛
چرا که bisync صرفاً \[dq]بررسی برابری\[dq] معمول خود را انجام داده و درمی‌یابد
نیازی به اقدامی روی این فایل‌ها نیست، زیرا از قبل در هر دو سو یکسان هستند.
.PP
در رویداد نادری که فایلی طی اجرایی که بعداً متوقف می‌شود با موفقیت همگام شده،
و سپس همان فایل پیش از اجرای بعدی دوباره تغییر کند، bisync آن را یک
تداخل همگام‌سازی (sync conflict) تشخیص می‌دهد و متناسب با آن اقدام می‌کند.
(از دیدگاه bisync، این فایل از زمان آخرین همگام‌سازی مورد اعتماد در هر دو طرف
تغییر یافته و فایل‌های دو طرف در حال حاضر یکسان نیستند.)
بنابراین، \f[V]--recover\f[R] احتمال بروز تداخل را اندکی افزایش می‌دهد \-
هرچند در عمل این موضوع بسیار نادر است، زیرا شرایط لازم برای وقوع آن کاملاً خاص هستند.
در صورت داشتن حق انتخاب، می‌توان این خطر را با به‌کارگیری حالت
\[dq]Graceful Shutdown\[dq] در bisync (که با ارسال \f[V]SIGINT\f[R] یا
فشردن \f[V]Ctrl+C\f[R] فعال می‌شود) به جای وادار کردن به توقف ناگهانی، کاهش داد.
.PP
گزینه‌های \f[V]--recover\f[R] و \f[V]--resilient\f[R] مشابه‌اند اما با یکدیگر
تفاوت دارند \- فرق اصلی این است که \f[V]--resilient\f[R] بر محور
\f[I]تلاش مجدد\f[R] است، در حالی که \f[V]--recover\f[R] مربوط به
\f[I]بازیابی\f[R] است.
بیشتر کاربران احتمالاً به هر دو نیاز خواهند داشت.
گزینهٔ \f[V]--resilient\f[R] هنگامی که bisync به دلیل سازوکارهای ایمنی
نظیر رد شدن در \f[V]--check-access\f[R] یا تشخیص تغییر فیلتر تصمیم به
توقف خودکار گرفته باشد، امکان تلاش دوباره را فراهم می‌آورد.
گزینهٔ \f[V]--resilient\f[R] وقفه‌های خارجی مانند خاموش کردن رایانه
توسط کاربر در حین همگام‌سازی را پوشش نمی‌دهد \- این دقیقاً کاری است که
\f[V]--recover\f[R] برای آن در نظر گرفته شده است.
.SS --max-lock
.PP
برنامهٔ bisync از فایل‌های قفل (lock files) به عنوان یک ویژگی ایمنی
استفاده می‌کند تا حین فعالیت خود، از تداخل سایر اجراهای bisync جلوگیری به عمل آورد.
‏bisync در شرایط عادی این فایل‌های قفل را در پایان اجرا حذف می‌کند،
اما اگر bisync به طور ناگهانی دچار وقفه شود، این فایل‌ها بر جای می‌مانند.
به‌طور پیش‌فرض، آن‌ها مانع از تمامی اجراهای بعدی می‌شوند تا زمانی که
کاربر فرصت کند وضعیت را به‌صورت دستی بررسی کرده و قفل را بردارد.
به عنوان یک راهکار جایگزین، می‌توان از \f[V]--max-lock\f[R] استفاده کرد
تا این فایل‌ها پس از مدت مشخصی به‌طور خودکار منقضی شوند؛ بدین ترتیب اجراهای
آینده برای همیشه مسدود نخواهند شد و بازیابی خودکار امکان‌پذیر می‌شود.
مقدار \f[V]--max-lock\f[R] می‌تواند هر بازهٔ زمانی معادل \f[V]2m\f[R] یا
بیشتر (یا \f[V]0\f[R] برای غیرفعال‌سازی) باشد.
در صورت تنظیم، فایل‌های قفل قدیمی‌تر از این بازه، \[dq]منقضی‌شده\[dq]
قلمداد می‌شوند و اجراهای بعدی مجاز به نادیده گرفتن آن‌ها و ادامهٔ کار خواهند بود.
(توجه داشته باشید که مدت‌زمان \f[V]--max-lock\f[R] باید توسط فرایندی
تنظیم شده باشد که فایل قفل را بر جای گذاشته است \- نه فرایند بعدی که آن را تفسیر می‌کند.)
.PP
در صورت تعیین، bisync همچنین برای ایمنی بیشتر، این فایل‌های قفل را در
طول اجرا هر \f[V]--max-lock منهای یک دقیقه\f[R] یک‌بار \[dq]تمدید\[dq] می‌کند.
(برای نمونه، با \f[V]--max-lock 5m\f[R]، برنامهٔ bisync تا زمان اتمام
اجرا، فایل قفل را هر ۴ دقیقه یک‌بار (برای ۵ دقیقهٔ دیگر) تمدید می‌نماید.)
به عبارت دیگر، نباید ممکن باشد زمان انقضای یک فایل قفل در حالی فرا برسد
که فرایند ایجادکنندهٔ آن همچنان در حال اجرا است \- بنابراین می‌توانید تا حد
زیادی اطمینان داشته باشید هر فایل قفل \f[I]منقضی‌شده‌ای\f[R] که پیدا
می‌کنید، توسط یک اجرای دچار وقفه بر جای مانده است، نه اجرایی که همچنان
در حال اجرا بوده و تنها کمی به طول انجامیده است.
.PP
چنانچه یک فایل قفل وجود داشته باشد اما محتویات آن ناخوانا باشد (برای مثال
به دلیل نوشتن ناقص یا خطای دیسک)، در صورتی که \f[V]--max-lock\f[R]
روی مقداری بزرگ‌تر از \f[V]0\f[R] تنظیم شده باشد، منقضی‌شده تلقی می‌شود.
اگر \f[V]--max-lock\f[R] برابر با \f[V]0\f[R] بوده یا تنظیم نشده باشد،
یک فایل قفل ناخوانا منجر به ایجاد خطا شده و اجراهای آینده را تا زمان حذف
دستی آن مسدود خواهد کرد.
.PP
اگر \f[V]--max-lock\f[R] برابر با \f[V]0\f[R] باشد یا تعیین نشده باشد،
حالت پیش‌فرض این است که فایل‌های قفل هرگز منقضی نخواهند شد و اجراهای آتی
(برای همین دو مسیر مشابه در bisync) را برای همیشه مسدود می‌سازند.
.PP
برای بیشترین تاب‌آوری در برابر اختلالات، تنظیم یک مدت‌زمان نسبتاً کوتاه
مانند \f[V]--max-lock 2m\f[R] به همراه \f[V]--resilient\f[R] و
\f[V]--recover\f[R]، و همچنین یک زمان‌بندی نسبتاً پرتکرار با cron را
مدنظر قرار دهید.
نتیجه، یک اجرای بسیار مستحکم از نوع \[dq]یک‌بار تنظیم کن و فراموش کن\[dq]
(set-it-and-forget-it) برای bisync خواهد بود که بدون نیاز به مداخلهٔ
کاربر و اجرای \f[V]--resync\f[R]، می‌تواند پس از تقریباً هرگونه وقفه‌ای
که رخ دهد، به‌طور خودکار به وضعیت عادی بازگردد.
(همچنین ببینید: حالت Graceful Shutdown).SS --backup-dir1 و --backup-dir2
.PP
از \f[V]v1.66\f[R] به بعد،
\f[V]--backup-dir\f[R] (https://rclone.org/docs/#backup-dir-string) در
bisync پشتیبانی می‌شود.
از آنجا که \f[V]--backup-dir\f[R] باید مسیری غیرهمپوشان روی همان ریموت باشد،
Bisync پرچم‌های جدید \f[V]--backup-dir1\f[R] و
\f[V]--backup-dir2\f[R] را برای پشتیبانی از دایرکتوری‌های پشتیبان‌گیری جداگانه برای
\f[V]Path1\f[R] و \f[V]Path2\f[R] معرفی کرده است (در غیر این صورت همگام‌سازی دوطرفه بین
ریموت‌های مختلف با \f[V]--backup-dir\f[R] ممکن نبود).
\f[V]--backup-dir1\f[R] و \f[V]--backup-dir2\f[R] می‌توانند از ریموت‌های
متفاوتی نسبت به یکدیگر استفاده کنند، اما \f[V]--backup-dir1\f[R] باید از همان ریموتِ
\f[V]Path1\f[R] و \f[V]--backup-dir2\f[R] باید از همان ریموتِ
\f[V]Path2\f[R] استفاده کند.
هر دایرکتوری پشتیبان‌گیری نباید با مسیر bisync متناظر خود همپوشانی داشته باشد،
مگر اینکه توسط یک قاعده فیلتر مستثنی شده باشد.
.PP
گزینه استاندارد \f[V]--backup-dir\f[R] نیز در صورتی که هر دو مسیر از یک ریموت
استفاده کنند کار خواهد کرد (اما توجه داشته باشید که فایل‌های حذف‌شده از هر دو مسیر
در همان دایرکتوری با یکدیگر ترکیب می‌شوند).
اگر هر یک از گزینه‌های \f[V]--backup-dir1\f[R] یا \f[V]--backup-dir2\f[R] تنظیم شوند،
اولویت داشته و \f[V]--backup-dir\f[R] را نادیده می‌گیرند.
.PP
مثال:
.IP
.nf
\f[C]
rclone bisync /Users/someuser/some/local/path/Bisync gdrive:Bisync --backup-dir1 /Users/someuser/some/local/path/BackupDir --backup-dir2 gdrive:BackupDir --suffix -2023-08-26 --suffix-keep-extension --check-access --max-delete 10 --filters-file /Users/someuser/some/local/path/bisync_filters.txt --no-cleanup --ignore-listing-checksum --checkers=16 --drive-pacer-min-sleep=10ms --create-empty-src-dirs --resilient -MvP --drive-skip-gdocs --fix-case
\f[R]
.fi
.PP
در این مثال، اگر کاربر فایلی را در
\f[V]/Users/someuser/some/local/path/Bisync\f[R] حذف کند، bisync این حذف را
با انتقال فایل متناظر از \f[V]gdrive:Bisync\f[R] به \f[V]gdrive:BackupDir\f[R]
به طرف دیگر منتقل می‌کند.
اگر کاربر فایلی را از \f[V]gdrive:Bisync\f[R] حذف کند، bisync آن را از
\f[V]/Users/someuser/some/local/path/Bisync\f[R] به
\f[V]/Users/someuser/some/local/path/BackupDir\f[R] انتقال می‌دهد.
.PP
در صورت تغییر نام به دلیل تداخل در همگام‌سازی، تغییر نام به عنوان حذف تلقی
نمی‌شود، مگر اینکه تداخل پیشینی با همان نام از قبل وجود داشته باشد و رونویسی گردد.
.PP
همچنین ببینید: \f[V]--suffix\f[R] (https://rclone.org/docs/#suffix-string)،
\f[V]--suffix-keep-extension\f[R] (https://rclone.org/docs/#suffix-keep-extension)
.SS عملکرد (Operation)
.SS جزئیات جریان اجرا (Runtime flow details)
.PP
دستور bisync فهرست فایل‌های سیستم‌فایل‌های \f[V]Path1\f[R] و \f[V]Path2\f[R]
را از اجرای قبلی نگه‌داری می‌کند.
در هر اجرای متوالی، کارهای زیر انجام خواهد شد:
.IP \[bu] 2
فهرست کردن فایل‌ها در \f[V]path1\f[R] و \f[V]path2\f[R]، و بررسی تغییرات
در هر دو طرف.
تغییرات شامل فایل‌های \f[V]New\f[R]، \f[V]Newer\f[R]، \f[V]Older\f[R] و
\f[V]Deleted\f[R] است.
.IP \[bu] 2
اعمال تغییرات از \f[V]path1\f[R] به \f[V]path2\f[R] و بالعکس.
.SS تدابیر ایمنی (Safety measures)
.IP \[bu] 2
فایل قفل (Lock file) در مواقعی که عملیات به طول می‌انجامد از اجراهای هم‌زمان متعدد جلوگیری می‌کند.
این مورد به‌ویژه زمانی که bisync از طریق زمان‌بند cron اجرا می‌شود بسیار کاربردی است.
.IP \[bu] 2
مدیریت تداخل در تغییرات به‌صورت غیرمخرب از طریق ایجاد نسخه‌های فایلی
\f[V].conflict1\f[R]، \f[V].conflict2\f[R] و غیره، مطابق با تنظیمات
\f[V]--conflict-resolve\f[R]، \f[V]--conflict-loser\f[R] و \f[V]--conflict-suffix\f[R].
.IP \[bu] 2
بررسی سلامت دسترسی به سیستم‌فایل با استفاده از فایل‌های \f[V]RCLONE_TEST\f[R]
(پرچم \f[V]--check-access\f[R] را ببینید).
.IP \[bu] 2
لغو عملیات در صورت حذف بیش از حد \- در برابر شرایطی که شکست در فهرست‌گیری
به عنوان حذف شدن همه فایل‌ها تلقی شود، محافظت می‌کند.
پرچم‌های \f[V]--max-delete\f[R] و \f[V]--force\f[R] را ببینید.
.IP \[bu] 2
در صورت بروز رویدادی فاجعه‌بار، bisync به یک وضعیت امن می‌رود تا مانع
از آسیب توسط اجراهای بعدی شود.
(بخش Error Handling را ببینید)
.SS بررسی‌های همگام‌سازی عادی (Normal sync checks)
.PP
.TS
tab(@);
lw(8.4n) lw(28.4n) lw(15.7n) lw(17.5n).
T{
نوع
T}@T{
توضیحات
T}@T{
نتیجه
T}@T{
پیاده‌سازی
T}
_
T{
Path2 new
T}@T{
فایل در Path2 جدید است و در Path1 وجود ندارد
T}@T{
نسخه Path2 باقی می‌ماند
T}@T{
\f[V]rclone copy\f[R] از Path2 به Path1
T}
T{
Path2 newer
T}@T{
فایل در Path2 تازه‌تر است و در Path1 تغییری نکرده
T}@T{
نسخه Path2 باقی می‌ماند
T}@T{
\f[V]rclone copy\f[R] از Path2 به Path1
T}
T{
Path2 deleted
T}@T{
فایل در Path2 حذف شده و در Path1 تغییری نکرده
T}@T{
فایل حذف می‌شود
T}@T{
\f[V]rclone delete\f[R] روی Path1
T}
T{
Path1 new
T}@T{
فایل در Path1 جدید است و در Path2 وجود ندارد
T}@T{
نسخه Path1 باقی می‌ماند
T}@T{
\f[V]rclone copy\f[R] از Path1 به Path2
T}
T{
Path1 newer
T}@T{
فایل در Path1 تازه‌تر است و در Path2 تغییری نکرده
T}@T{
نسخه Path1 باقی می‌ماند
T}@T{
\f[V]rclone copy\f[R] از Path1 به Path2
T}
T{
Path1 older
T}@T{
فایل در Path1 قدیمی‌تر است و در Path2 تغییری نکرده
T}@T{
\f[I]نسخه Path1 باقی می‌ماند\f[R]
T}@T{
\f[V]rclone copy\f[R] از Path1 به Path2
T}
T{
Path2 older
T}@T{
فایل در Path2 قدیمی‌تر است و در Path1 تغییری نکرده
T}@T{
\f[I]نسخه Path2 باقی می‌ماند\f[R]
T}@T{
\f[V]rclone copy\f[R] از Path2 به Path1
T}
T{
Path1 deleted
T}@T{
فایل دیگر روی Path1 وجود ندارد
T}@T{
فایل حذف می‌شود
T}@T{
\f[V]rclone delete\f[R] روی Path2
T}
.TE.SS بررسی‌های غیرمعمول همگام‌سازی
.PP
.TS
tab(@);
lw(17.2n) lw(21.0n) lw(19.4n) lw(12.4n).
T{
نوع
T}@T{
شرح
T}@T{
نتیجه
T}@T{
پیاده‌سازی
T}
_
T{
Path1 جدید/تغییریافته و Path2 جدید/تغییریافته و Path1 == Path2
T}@T{
فایل در Path1 جدید/تغییریافته و در Path2 جدید/تغییریافته است و نسخهٔ Path1 در حال حاضر همسان با Path2 است
T}@T{
بدون تغییر
T}@T{
هیچ
T}
T{
Path1 جدید و Path2 جدید
T}@T{
فایل در Path1 جدید و در Path2 جدید است (و نسخهٔ Path1 همسان با Path2 نیست)
T}@T{
مدیریت تعارض‌ها طبق تنظیمات \f[V]--conflict-resolve\f[R] و \f[V]--conflict-loser\f[R]
T}@T{
پیش‌فرض: \f[V]rclone copy\f[R] فایل تغییرنام‌یافتهٔ \f[V]Path2.conflict2\f[R] به Path1، \f[V]rclone copy\f[R] فایل تغییرنام‌یافتهٔ \f[V]Path1.conflict1\f[R] به Path2
T}
T{
Path2 جدیدتر و Path1 تغییریافته
T}@T{
فایل در Path2 جدیدتر است و در Path1 نیز تغییر یافته است (جدیدتر/قدیمی‌تر/اندازه) (و نسخهٔ Path1 همسان با Path2 نیست)
T}@T{
مدیریت تعارض‌ها طبق تنظیمات \f[V]--conflict-resolve\f[R] و \f[V]--conflict-loser\f[R]
T}@T{
پیش‌فرض: \f[V]rclone copy\f[R] فایل تغییرنام‌یافتهٔ \f[V]Path2.conflict2\f[R] به Path1، \f[V]rclone copy\f[R] فایل تغییرنام‌یافتهٔ \f[V]Path1.conflict1\f[R] به Path2
T}
T{
Path2 جدیدتر و Path1 حذف‌شده
T}@T{
فایل در Path2 جدیدتر است و در Path1 نیز حذف شده است
T}@T{
نسخهٔ Path2 باقی می‌ماند
T}@T{
\f[V]rclone copy\f[R] از Path2 به Path1
T}
T{
Path2 حذف‌شده و Path1 تغییریافته
T}@T{
فایل در Path2 حذف شده است و در Path1 تغییر یافته است (جدیدتر/قدیمی‌تر/اندازه)
T}@T{
نسخهٔ Path1 باقی می‌ماند
T}@T{
\f[V]rclone copy\f[R] از Path1 به Path2
T}
T{
Path1 حذف‌شده و Path2 تغییریافته
T}@T{
فایل در Path1 حذف شده است و در Path2 تغییر یافته است (جدیدتر/قدیمی‌تر/اندازه)
T}@T{
نسخهٔ Path2 باقی می‌ماند
T}@T{
\f[V]rclone copy\f[R] از Path2 به Path1
T}
.TE
.PP
از \f[V]rclone v1.64\f[R]، اکنون bisync در تشخیص تعارض‌های همگام‌سازی \f[I]مثبت کاذب\f[R] که پیش‌تر به تغییر نام‌ها و ایجاد موارد تکراری غیرضروری منجر می‌شد، عملکرد بهتری دارد.
اکنون، هنگامی که bisync به فایلی می‌رسد که قصد تغییر نام آن را دارد (به دلیل جدید/تغییریافته بودن در هر دو طرف)، ابتدا بررسی می‌کند که آیا نسخه‌های Path1 و Path2 در حال حاضر \f[I]همسان\f[R] هستند یا خیر (با استفاده از همان تابع پایه‌ایِ \f[V]check\f[R]).
اگر bisync به این نتیجه برسد که فایل‌ها همسان هستند، از آن‌ها صرف‌نظر کرده و عبور می‌کند.
در غیر این صورت، مانند قبل، نسخه‌های تکراریِ تغییرنام‌یافته ایجاد خواهد کرد.
این رفتار همچنین تجربهٔ تغییر نام دایرکتوری‌ها را بهبود می‌بخشد (https://forum.rclone.org/t/bisync-bugs-and-feature-requests/37636#:~:text=Renamed%20directories)، چرا که تا زمانی که تغییر یکسانی در هر دو طرف انجام شده باشد، دیگر نیازی به \f[V]--resync\f[R] نخواهد بود..SS "بررسی تغییر تمام فایل‌ها (All files changed check)"
.PP
اگر \f[I]تمام\f[R] فایل‌های موجود قبلی در هر یک از سامانه‌های فایل تغییر کرده باشند (برای نمونه، برچسب‌های زمانی به دلیل تغییر منطقه زمانی سیستم تغییر کرده باشند)، \f[V]bisync\f[R] بدون اعمال هیچ‌گونه تغییری متوقف خواهد شد.
فایل‌های جدید برای این بررسی در نظر گرفته نمی‌شوند.
می‌توانید از \f[V]--force\f[R] برای اجبار در همگام‌سازی استفاده کنید (سمتی که دارای فایل‌های با برچسب زمانی تغییریافته باشد اولویت خواهد داشت).
به‌عنوان روشی جایگزین، می‌توان از \f[V]--resync\f[R] استفاده کرد (نسخه‌های موجود در Path1 به Path2 فرستاده خواهند شد).
وضعیت را با دقت بسنجید و شاید بهتر باشد پیش از نهایی کردن تغییرات، از \f[V]--dry-run\f[R] استفاده کنید.
.SS "زمان‌های ویرایش (Modification times)"
.PP
به‌طور پیش‌فرض، \f[V]bisync\f[R] فایل‌ها را بر اساس زمان ویرایش و اندازه مقایسه می‌کند.
اگر شما یا برنامه‌تان محتوای فایلی را بدون تغییر زمان ویرایش و اندازه آن تغییر دهید، آن‌گاه \f[V]bisync\f[R] متوجه این تغییر \f[I]نخواهد\f[R] شد و در نتیجه آن را به سمت دیگر کپی نمی‌کند.
به‌عنوان روشی جایگزین، مقایسه با مجموع مقابله‌ای (checksum) را در نظر داشته باشید (در صورتی که ریموت‌های شما از آن پشتیبانی کنند).
برای جزئیات بیشتر به \f[V]--compare\f[R] مراجعه کنید.
.SS "مدیریت خطاها (Error handling)"
.PP
برخی از خطاهای حیاتی \f[V]bisync\f[R]، مانند شکست در کپی یا انتقال فایل، منجر به قفل شدن اجراهای بعدی \f[V]bisync\f[R] خواهند شد.
این قفل به این دلیل اعمال می‌شود که وضعیت همگام‌سازی و تاریخچه سامانه‌های فایل Path1 و Path2 قابل اعتماد نیستند، بنابراین مسدود کردن هرگونه تغییر بعدی تا زمانی که شرایط بررسی شود ایمن‌تر است.
راهکار بازیابی، اجرای مجدد با گزینه \f[V]--resync\f[R] است.
.PP
توصیه می‌شود در ابتدا از \f[V]--resync --dry-run --verbose\f[R] استفاده کنید و پیش از اجرای \f[V]--resync\f[R] بدون گزینه \f[V]--dry-run\f[R]، تغییراتی را که اعمال خواهند شد \f[I]به‌دقت\f[R] بررسی نمایید.
.PP
بیشتر این رویدادها به دلیل وضعیت خطا ناشی از یک فراخوانی درونی رخ می‌دهند.
در صورت بروز چنین خطای حیاتی، نام فایل‌های فهرست‌بندی \f[V]{...}.path1.lst\f[R] و \f[V]{...}.path2.lst\f[R] با افزودن پسوند \f[V].lst-err\f[R] تغییر می‌یابد، که این امر اجراهای بعدی \f[V]bisync\f[R] را مسدود می‌سازد (زیرا فایل‌های عادی با پسوند \f[V].lst\f[R] پیدا نمی‌شوند).
برنامه \f[V]bisync\f[R] آن‌ها را در زیرپوشه \f[V]bisync\f[R] از دایرکتوری حافظه موقت (cache) ابزار \f[V]rclone\f[R] نگه می‌دارد، که در لینوکس معمولاً در مسیر \f[V]${HOME}/.cache/rclone/bisync/\f[R] قرار دارد.
.PP
برخی از خطاها موقتی در نظر گرفته می‌شوند و اجرای مجدد \f[V]bisync\f[R] مسدود نخواهد شد.
تنها \f[I]بازگشت وضعیت بحرانی (critical return)\f[R] مانع از اجراهای بعدی \f[V]bisync\f[R] می‌گردد.
.PP
همچنین ببینید: \f[V]--resilient\f[R]، \f[V]--recover\f[R]، \f[V]--max-lock\f[R] و Graceful Shutdown
.SS "فایل قفل (Lock file)"
.PP
هنگامی که \f[V]bisync\f[R] در حال اجرا است، یک فایل قفل در دایرکتوری کاری \f[V]bisync\f[R] ایجاد می‌شود که در لینوکس معمولاً در مسیر \f[V]\[ti]/.cache/rclone/bisync/PATH1..PATH2.lck\f[R] قرار دارد.
اگر \f[V]bisync\f[R] دچار فروپاشی (crash) یا توقف (hang) شود، فایل قفل در جای خود باقی می‌ماند و هرگونه اجرای بعدی \f[V]bisync\f[R] را \f[I]برای همان مسیرها\f[R] مسدود می‌کند.
به‌عنوان بخشی از فرایند عیب‌یابی، این فایل قفل را حذف کنید.
فایل قفل هنگامی که اجرای قبلی زمان زیادی طول می‌کشد، به‌طور مؤثری از اجراهای بعدی (برای نمونه، برنامه‌ریزی‌شده توسط \f[I]cron\f[R]) جلوگیری می‌کند.
فایل قفل حاوی \f[I]PID\f[R] فرایند مسدودکننده است که ممکن است در اشکال‌زدایی کمک کند.
فایل‌های قفل را می‌توان با استفاده از گزینه \f[V]--max-lock\f[R] طوری تنظیم کرد که پس از مدت معینی به‌طور خودکار منقضی شوند.
.PP
\f[B]توجه\f[R] داشته باشید که اگرچه اجرای هم‌زمان \f[V]bisync\f[R] مجاز است، اما \f[I]بسیار محتاط باشید\f[R] که هیچ تداخلی در درخت‌های در حال همگام‌سازی بین اجراهای هم‌زمان وجود نداشته باشد، مبادا فایل‌های تکراری، حذف ناخواسته فایل‌ها و آشفتگی کلی رخ دهد.
.SS "وضعیت‌های خروج (Exit codes)"
.PP
دستور \f[V]rclone bisync\f[R] کدهای خروج زیر را به برنامه فراخوان بازمی‌گرداند:
.IP \[bu] 2
\f[V]0\f[R] در یک اجرای موفق،
.IP \[bu] 2
\f[V]1\f[R] برای اجرای ناموفق غیرحیاتی (ممکن است اجرای مجدد موفقیت‌آمیز باشد)،
.IP \[bu] 2
\f[V]2\f[R] در صورت خطای نحوی یا روش استفاده نادرست،
.IP \[bu] 2
\f[V]7\f[R] برای اجرایی که به‌صورت بحرانی متوقف شده است (برای بازیابی به \f[V]--resync\f[R] نیاز دارد).
.PP
همچنین بخش مربوط به کدهای خروج (<https://rclone.org/docs/#exit-code>) را در مستندات اصلی ببینید..SS "خاتمه آرام (Graceful Shutdown)"
.PP
دستور bisync دارای یک حالت \[dq]خاتمه آرام\[dq] (Graceful Shutdown) است که با ارسال \f[V]SIGINT\f[R] یا فشردن \f[V]Ctrl+C\f[R] در حین اجرا فعال می‌شود.
پس از فعال شدن، bisync تمام تلاش خود را به کار خواهد بست تا پیش از اتمام زمان‌سنج به شکلی تمیز خارج شود.
اگر bisync در میانه انتقال فایل‌ها باشد، تلاش خواهد کرد تا با تکمیل آنچه آغاز کرده و نپذیرفتن موارد جدید، صف خود را با نظم خالی کند.
اگر نتواند ظرف ۳۰ ثانیه این کار را به انجام برساند، انتقال‌های در حال انجام را لغو کرده و حداکثر ۶۰ ثانیه به خود فرصت می‌دهد تا کارها را جمع‌بندی کند، وضعیت خود را برای اجرای بعدی ذخیره نماید و خارج شود.
با پرچم‌های \f[V]-vP\f[R]، به‌روزرسانی‌های مداوم وضعیت و یک تأیید نهایی از موفق بودن یا نبودن خاتمه آرام را مشاهده خواهید کرد.
.PP
در هر مرحله‌ای از توالی \[dq]خاتمه آرام\[dq]، ارسال یک \f[V]SIGINT\f[R] یا فشردن مجدد \f[V]Ctrl+C\f[R] موجب خروج فوری و ناگهانی خواهد شد که اوضاع را در وضعیتی آشفته‌تر رها می‌کند.
معمولاً در صورت استفاده از حالت \f[V]--recover\f[R]، همچنان یک بازیابی مطمئن امکان‌پذیر خواهد بود؛ در غیر این صورت لازم است یک بار \f[V]--resync\f[R] انجام دهید.
.PP
اگر قصد استفاده از حالت خاتمه آرام را دارید، توصیه می‌شود از گزینه‌های \f[V]--resilient\f[R] و \f[V]--recover\f[R] استفاده کنید، و بسیار مهم است که از \f[V]--inplace\f[R] (https://rclone.org/docs/#inplace) استفاده \fBنکنید\fR؛ در غیر این صورت خطر باقی ماندن فایل‌های ناقص در یک سمت وجود خواهد داشت که ممکن است در اجرای بعدی به اشتباه به عنوان فایل‌های واقعی در نظر گرفته شوند.
همچنین توجه داشته باشید که در صورت توقف ناگهانی، یک فایل قفل (lock file) بر جای خواهد ماند تا مانع از اجراهای هم‌زمان شود.
لازم است پیش از اقدام به اجرای بعدی، آن را حذف کنید (یا در صورت استفاده از \f[V]--max-lock\f[R]، صبر کنید تا خودش منقضی شود).
.SS "محدودیت‌ها (Limitations)"
.SS "بک‌اندهای پشتیبانی‌شده (Supported backends)"
.PP
سازگاری bisync در برابر تمام بک‌اندهای rclone از طریق آزمون‌های یکپارچه‌سازی بررسی می‌شود.
بیشتر بک‌اندها (شامل تمام بک‌اندهایی که در زیر فهرست نشده‌اند) به عنوان کاملاً پشتیبانی‌شده و فاقد مشکلات شناخته‌شده در نظر گرفته می‌شوند.
با این وجود، گاهی اوقات این آزمون‌ها مشکلاتی را با برخی بک‌اندهای خاص نشان می‌دهند که معمولاً به محدودیت‌های خاص ارائه‌دهنده و فراتر از کنترل rclone مربوط می‌شوند (برای نمونه، نویسه‌های خاص غیرمجاز و کدگذاری‌های نام فایل).
.PP
بک‌اندهای زیر دارای مشکلات شناخته‌شده‌ای هستند که نیاز به بررسی بیشتر دارند:
.IP \[bu] 2
\f[V]TestHuaweiDrive\f[R] (\f[V]huaweidrive\f[R])
.RS 2
.IP \[bu] 2
\f[V]TestBisyncRemoteLocal/ext_paths\f[R] (https://pub.rclone.org/integration-tests/current/huaweidrive-cmd.bisync-TestHuaweiDrive-1.txt)
.IP \[bu] 2
\f[V]TestBisyncRemoteLocal/extended_filenames\f[R] (https://pub.rclone.org/integration-tests/current/huaweidrive-cmd.bisync-TestHuaweiDrive-1.txt)
.IP \[bu] 2
\f[V]TestBisyncRemoteLocal/normalization\f[R] (https://pub.rclone.org/integration-tests/current/huaweidrive-cmd.bisync-TestHuaweiDrive-1.txt)
.IP \[bu] 2
\f[V]TestBisyncLocalRemote/ext_paths\f[R] (https://pub.rclone.org/integration-tests/current/huaweidrive-cmd.bisync-TestHuaweiDrive-1.txt)
.IP \[bu] 2
\f[V]TestBisyncLocalRemote/extended_filenames\f[R] (https://pub.rclone.org/integration-tests/current/huaweidrive-cmd.bisync-TestHuaweiDrive-1.txt)
.IP \[bu] 2
۳ مورد دیگر (https://pub.rclone.org/integration-tests/current)
.RE
.IP \[bu] 2
\f[V]TestPcloud\f[R] (\f[V]pcloud\f[R])
.RS 2
.IP \[bu] 2
\f[V]TestBisyncRemoteLocal/createemptysrcdirs\f[R] (https://pub.rclone.org/integration-tests/current/pcloud-cmd.bisync-TestPcloud-1.txt)
.IP \[bu] 2
\f[V]TestBisyncLocalRemote/resolve\f[R] (https://pub.rclone.org/integration-tests/current/pcloud-cmd.bisync-TestPcloud-1.txt)
.IP \[bu] 2
\f[V]TestBisyncRemoteRemote/createemptysrcdirs\f[R] (https://pub.rclone.org/integration-tests/current/pcloud-cmd.bisync-TestPcloud-1.txt)
.RE
.IP \[bu] 2
به‌روزرسانی شده: 2026-09-04-010006
.PP
بک‌اندهای زیر یا اخیراً آزمایش نشده‌اند یا مشکلات شناخته‌شده‌ای دارند که در حال حاضر غیرقابل حل در نظر گرفته می‌شوند:
.IP \[bu] 2
\f[V]TestArchive\f[R] (\f[V]archive\f[R])
.IP \[bu] 2
\f[V]TestCache\f[R] (\f[V]cache\f[R])
.IP \[bu] 2
\f[V]TestDrime\f[R] (\f[V]drime\f[R])
.IP \[bu] 2
\f[V]TestDropbox\f[R] (\f[V]dropbox\f[R])
.RS 2
.IP \[bu] 2
\f[V]TestBisyncRemoteLocal/normalization\f[R]
.IP \[bu] 2
\f[V]TestBisyncLocalRemote/normalization\f[R]
.IP \[bu] 2
\f[V]TestBisyncRemoteRemote/normalization\f[R]
.RE
.IP \[bu] 2
\f[V]TestFileLu\f[R] (\f[V]filelu\f[R])
.IP \[bu] 2
\f[V]TestFilesCom\f[R] (\f[V]filescom\f[R])
.IP \[bu] 2
\f[V]TestImageKit\f[R] (\f[V]imagekit\f[R])
.IP \[bu] 2
\f[V]TestJottacloud\f[R] (\f[V]jottacloud\f[R])
.IP \[bu] 2
\f[V]TestLinkbox\f[R] (\f[V]linkbox\f[R])
.IP \[bu] 2
\f[V]TestMailru\f[R] (\f[V]mailru\f[R])
.IP \[bu] 2
\f[V]TestMega\f[R] (\f[V]mega\f[R])
.IP \[bu] 2
\f[V]TestOpenDrive\f[R] (\f[V]opendrive\f[R])
.IP \[bu] 2
\f[V]TestOracleObjectStorage\f[R] (\f[V]oracleobjectstorage\f[R])
.IP \[bu] 2
\f[V]TestPikPak\f[R] (\f[V]pikpak\f[R])
.IP \[bu] 2
\f[V]TestPixeldrain\f[R] (\f[V]pixeldrain\f[R])
.IP \[bu] 2
\f[V]TestProtonDrive\f[R] (\f[V]protondrive\f[R])
.IP \[bu] 2
\f[V]TestPutio\f[R] (\f[V]putio\f[R])
.IP \[bu] 2
\f[V]TestQuatrix\f[R] (\f[V]quatrix\f[R])
.IP \[bu] 2
\f[V]TestS3GCS\f[R] (\f[V]s3\f[R])
.RS 2
.IP \[bu] 2
\f[V]TestBisyncRemoteRemote/extended_filenames\f[R]
.RE
.IP \[bu] 2
\f[V]TestS3Rclone\f[R] (\f[V]s3\f[R])
.IP \[bu] 2
\f[V]TestSFTPRsyncNet\f[R] (\f[V]sftp\f[R])
.IP \[bu] 2
\f[V]TestStorj\f[R] (\f[V]storj\f[R])
.IP \[bu] 2
\f[V]TestWebdavNextcloud\f[R] (\f[V]webdav\f[R])
.IP \[bu] 2
\f[V]TestWebdavOwncloud\f[R] (\f[V]webdav\f[R])
.IP \[bu] 2
\f[V]TestnStorage\f[R] (\f[V]netstorage\f[R]) (اطلاعات
بیشتر (https://github.com/rclone/rclone/blob/master/fstest/test_all/config.yaml))
.PP
فهرست‌های فوق برای هر انتشار پایدار rclone به‌روزرسانی می‌شوند.
برای مشاهده نتایج آزمون که شبانه بر اساس آخرین نسخه آزمایشی (beta) به‌روزرسانی می‌شوند، به صفحه وضعیت آزمون یکپارچه‌سازی
rclone (https://pub.rclone.org/integration-tests/current) مراجعه کنید.
.PP
نسخه‌های بتای اولیه \f[V]rclone bisync\f[R] نیازمند این بودند که هر دو بک‌اندِ زیربنایی از زمان‌های تغییر (modification times) پشتیبانی کنند، و در غیر این صورت از اجرا خودداری می‌کردند.
این محدودیت از نسخه \f[V]v1.66\f[R] برداشته شده است، زیرا bisync اکنون از مقایسه مجموع مقابله‌ای (checksum) و/یا اندازه به‌جای (یا علاوه بر) زمان تغییر پشتیبانی می‌کند.
برای جزئیات بیشتر به \f[V]--compare\f[R] مراجعه کنید..SS "تغییرات هم‌روند (Concurrent modifications)"
.PP
هنگام استفاده از ریموت‌های \f[B]Local، FTP یا SFTP\f[R] همراه با
\f[V]--inplace\f[R] (https://rclone.org/docs/#inplace)، ابزار rclone هنگام کپی کردن،
فایل‌های \f[I]موقت\f[R] در مقصد ایجاد نمی‌کند؛ بنابراین در صورت قطع اتصال،
فایل ایجادشده ممکن است ناقص یا خراب شود، که این خرابی به احتمال زیاد
در همگام‌سازی بعدی به مسیر اصلی نیز سرایت خواهد کرد و منجر به از دست رفتن داده‌ها می‌شود.
از این رو توصیه می‌شود از \f[V]--inplace\f[R] \f[I]صرف‌نظر کنید\f[R].
.PP
فایل‌هایی که \f[B]در طول اجرای\f[R] یک نشست bisync تغییر می‌کنند ممکن است منجر به از دست رفتن داده‌ها شوند.
پیش از \f[V]rclone v1.66\f[R]، این وضعیت معمولاً در محیط‌های بسیار پویا دیده می‌شد،
جایی که در حین همگام‌سازی، سیستم‌فایل زیر بار سنگین پردازش‌های در حال اجرا قرار می‌گرفت.
از نسخهٔ \f[V]rclone v1.66\f[R]، ابزار bisync بازطراحی شد تا از یک مدل
\[dq]تصویر لحظه‌ای (snapshot)\[dq] استفاده کند، که خطرات ناشی از تغییرات حین
همگام‌سازی را تا حد زیادی کاهش می‌دهد.
تغییراتی که در طول همگام‌سازی جاری شناسایی نشوند، در همگام‌سازی بعدی
شناسایی خواهند شد و دیگر باعث نخواهند شد که کل فرایند اجرا با یک خطای بحرانی متوقف شود.
علاوه بر این، برای ایمنی بیشتر، سازوکاری تعبیه شده است تا فایل‌هایی را که نیازمند
بررسی مجدد داخلی در دفعات بعد هستند علامت‌گذاری کند.
بنابراین دیگر نباید لازم باشد همگام‌سازی را تنها در ساعات خلوت و آرام انجام دهید
\-\- با این حال، توجه داشته باشید که اگر فایلی دقیقاً در همان لحظه‌ای که توسط bisync خوانده یا نوشته
می‌شود تغییر کند، همچنان ممکن است خطا رخ دهد (مشابه آنچه در \f[V]rclone sync\f[R] رخ می‌دهد).
(همچنین ببینید:
\f[V]--ignore-checksum\f[R] (https://rclone.org/docs/#ignore-checksum)،
\f[V]--local-no-check-updated\f[R] (https://rclone.org/local/#local-no-check-updated))
.SS "دایرکتوری‌های خالی (Empty directories)"
.PP
به‌طور پیش‌فرض، دایرکتوری‌های خالی جدید یا حذف‌شده در یک مسیر، به سمت دیگر منتقل
\f[I]نمی‌شوند\f[R].
زیرا bisync (و rclone) ذاتاً روی فایل‌ها کار می‌کنند، نه دایرکتوری‌ها.
با این حال، این رفتار را می‌توان با گزینهٔ \f[V]--create-empty-src-dirs\f[R] تغییر داد،
که سازوکار آن تا حد زیادی مشابه عملکردش در
\f[V]sync\f[R] (https://rclone.org/commands/rclone_sync) و
\f[V]copy\f[R] (https://rclone.org/commands/rclone_copy) است.
در صورت استفاده از آن، دایرکتوری‌های خالی ایجادشده یا حذف‌شده در یک سمت،
در سمت دیگر نیز ایجاد یا حذف خواهند شد.
نکات زیر باید مد نظر قرار گیرند:
.IP \[bu] 2
گزینهٔ \f[V]--create-empty-src-dirs\f[R] با
\f[V]--remove-empty-dirs\f[R] سازگار نیست.
تنها از یکی از آن‌ها استفاده کنید (یا هیچ‌کدام).
.IP \[bu] 2
توصیه نمی‌شود بدون اجرای \f[V]-- resync\f[R]، بین
\f[V]--create-empty-src-dirs\f[R] و حالت پیش‌فرض (بدون
\f[V]--create-empty-src-dirs\f[R]) جابه‌جا شوید.
دلیل این است که ممکن است این‌گونه به نظر برسد که همهٔ دایرکتوری‌ها (نه فقط موارد خالی)
ایجاد یا حذف شده‌اند، در حالی که در واقعیت شما فقط وضعیت نمایش آن‌ها را بین
مرئی یا نامرئی برای bisync تغییر داده‌اید.
این وضعیت نگران‌کننده‌تر از واقعیت خود به نظر می‌رسد، اما همچنان بهتر است
تنها از یکی از حالات استفاده کنید و در صورت نیاز به تغییر، از \f[V]--resync\f[R] بهره ببرید.
.SS "دایرکتوری‌های تغییرنام‌یافته (Renamed directories)"
.PP
به‌طور پیش‌فرض، تغییر نام یک پوشه در سمت Path1 منجر به حذف تمام
فایل‌ها در سمت Path2 و سپس کپی مجدد تمام فایل‌ها از Path1 به
Path2 می‌شود.
ابزار bisync این رویداد را به منزلهٔ حذف تمام فایل‌ها در دایرکتوری با نام قدیمی
و جدید بودن تمام فایل‌ها در دایرکتوری با نام جدید تلقی می‌کند.
.PP
یک راهکار توصیه‌شده استفاده از
\f[V]--track-renames\f[R] (https://rclone.org/docs/#track-renames) است
که از نسخهٔ \f[V]rclone v1.66\f[R] در bisync پشتیبانی می‌شود.
توجه داشته باشید که \f[V]--track-renames\f[R] در طول
\f[V]--resync\f[R] در دسترس نیست، چرا که \f[V]--resync\f[R] هیچ فایلی را حذف نمی‌کند
(\f[V]--track-renames\f[R] تنها از \f[V]sync\f[R] پشتیبانی می‌کند، نه
\f[V]copy\f[R]).
.PP
در غیر این صورت، مؤثرترین و کارآمدترین روش برای تغییر نام یک
دایرکتوری، تغییر نام آن به نامی یکسان در هر دو طرف است.
(از نسخهٔ \f[V]rclone v1.64\f[R] به بعد، دیگر پس از انجام این کار نیازی به اجرای \f[V]--resync\f[R]
نیست، زیرا bisync به‌طور خودکار یکسان بودن Path1 و Path2 را تشخیص خواهد داد.)
.PP
توجه داشته باشید که اگرچه گزینهٔ --track-renames تضمین می‌کند فایل‌های
تغییرنام‌یافته/منتقل‌شده حذف و مجدداً آپلود نشوند، اما برای مقاصد
گزینهٔ --max-delete همچنان به عنوان فایل‌های حذف‌شده شمارش می‌شوند (زیرا این بررسی
پیش از عملیات تشخیص تغییر نام انجام می‌گیرد).
این گزارش موضوع را ببینید (https://github.com/rclone/rclone/issues/8685)..SS استفاده پیش‌فرض از \f[V]--fast-list\f[R]
.PP
برخلاف بیشتر دستورات دیگر rclone، دستور bisync به‌طور پیش‌فرض از
\f[V]--fast-list\f[R] (https://rclone.org/docs/#fast-list)
برای بک‌اندهایی که از آن پشتیبانی می‌کنند، استفاده می‌کند.
در بسیاری از موارد این رفتار مطلوب است، اما سناریوهایی وجود دارند که
در آن‌ها ممکن است bisync \f[I]بدون\f[R] \f[V]--fast-list\f[R] سریع‌تر عمل کند؛
همچنین یک مشکل شناخته‌شده مربوط به کاربران Google Drive با دایرکتوری‌های خالی زیاد
وجود دارد (https://github.com/rclone/rclone/commit/cbf3d4356135814921382dd3285d859d15d0aa77).
در حال حاضر، روش توصیه‌شده برای پرهیز از استفاده از \f[V]--fast-list\f[R]،
افزودن \f[V]--disable ListR\f[R] به تمام دستورات bisync است.
رفتار پیش‌فرض ممکن است در نسخه‌های آینده تغییر کند.
.SS حساسیت به بزرگی و کوچکی حروف (و یونیکد)
.PP
از نسخهٔ \f[V]v1.66\f[R] به بعد، تفاوت‌های بزرگی و کوچکی حروف و اشکال یونیکد دیگر خطای
بحرانی ایجاد نمی‌کنند و نرمال‌سازی (هنگام مقایسه میان سیستم‌های فایل)
بر اساس همان گزینه‌ها و پیش‌فرض‌های \f[V]rclone sync\f[R] مدیریت می‌شود.
برای کنترل دقیق‌تر این رفتار گزینه‌های زیر (که همگی توسط bisync پشتیبانی می‌شوند) را
ببینید:
.IP \[bu] 2
\f[V]--fix-case\f[R] (https://rclone.org/docs/#fix-case)
.IP \[bu] 2
\f[V]--ignore-case-sync\f[R] (https://rclone.org/docs/#ignore-case-sync)
.IP \[bu] 2
\f[V]--no-unicode-normalization\f[R] (https://rclone.org/docs/#no-unicode-normalization)
.IP \[bu] 2
\f[V]--local-unicode-normalization\f[R] (https://rclone.org/local/#local-unicode-normalization)
و
\f[V]--local-case-sensitive\f[R] (https://rclone.org/local/#local-case-sensitive)
(احتیاط: معمولاً این موارد آن چیزی نیستند که می‌خواهید.)
.PP
توجه داشته باشید در وضعیت (احتمالاً نادر) استفاده از \f[V]--fix-case\f[R]،
چنانچه فایلی در هر دو طرف جدید/تغییریافته باشد و چکسام‌ها مطابقت داشته باشند
اما بزرگی و کوچکی حروف نام فایل یکسان نباشد، برای مقاصد \f[V]--fix-case\f[R]
نام فایل در Path1 برنده در نظر گرفته می‌شود (نام فایل در Path2 تغییر داده خواهد شد تا با آن مطابقت پیدا کند).
.SS پشتیبانی از Windows
.PP
دستور bisync روی Windows 8.1، Windows 10 Pro 64-bit و روی
Windows GitHub runners آزمایش شده است.
.PP
حروف درایو مجاز هستند، از جمله حروف درایو نگاشت‌شده به درایوهای شبکه
(\f[V]rclone bisync J:\[rs]localsync GDrive:\f[R]).
اگر حرف درایو مشخص نشود، درایو جاری پوسته پیش‌فرض خواهد بود.
حروف درایو یک نویسهٔ تک به همراه \f[V]:\f[R] هستند، بنابراین نام‌های ابری
باید بیش از یک نویسه باشند.
.PP
مسیرهای مطلق (با یا بدون حرف درایو) و مسیرهای نسبی
(با یا بدون حرف درایو) پشتیبانی می‌شوند.
.PP
دایرکتوری کاری در مسیر
\f[V]C:\[rs]Users\[rs]MyLogin\[rs]AppData\[rs]Local\[rs]rclone\[rs]bisync\f[R]
ایجاد می‌شود.
.PP
توجه داشته باشید که خروجی bisync ممکن است ترکیبی از اسلش \f[V]/\f[R] و بک‌اسلش
\f[V]\[rs]\f[R] را نمایش دهد.
.PP
مراقب عدم حساسیت به بزرگی و کوچکی حروف در نام‌گذاری فایل و دایرکتوری در Windows در مقابل
حساسیت به آن در Linux باشید.
.SS فیلتر کردن
.PP
برای نحوه نوشتن و تفسیر قوانین فیلتر، مستندات فیلتر کردن (https://rclone.org/filtering)
را ببینید.
.PP
گزینهٔ \f[V]--filters-file\f[R] در bisync سازوکار فیلترسازی
--filter-from (https://rclone.org/filtering/#filter-from-read-filtering-patterns-from-a-file)
در rclone را اندکی گسترش می‌دهد.
برای هر بار اجرای bisync می‌توانید \f[I]فقط یک\f[R]
\f[V]--filters-file\f[R] ارائه دهید.
گزینه‌های \f[V]--include*\f[R]، \f[V]--exclude*\f[R] و \f[V]--filter\f[R]
نیز پشتیبانی می‌شوند.
.SS نحوه فیلتر کردن دایرکتوری‌ها
.PP
فیلتر کردن بخش‌هایی از درخت دایرکتوری یک قابلیت حیاتی برای همگام‌سازی است.
.PP
نمونه‌هایی از درخت‌های دایرکتوری (همیشه در زیر سطح ریشهٔ Path1/Path2)
که ممکن است بخواهید آن‌ها را از همگام‌سازی خود مستثنی کنید:
.IP \[bu] 2
درخت‌های دایرکتوری که فقط شامل فایل‌های واسط ساخت نرم‌افزار هستند.
.IP \[bu] 2
درخت‌های دایرکتوری حاوی داده‌ها و فایل‌های موقت برنامه‌ها مانند
درخت \f[V]C:\[rs]Users\[rs]MyLogin\[rs]AppData\[rs]\f[R] در Windows.
.IP \[bu] 2
درخت‌های دایرکتوری حاوی فایل‌هایی که حجیم هستند، اهمیت کمتری دارند یا به‌طور مداوم
توسط فرایندهای در حال اجرا دستکاری و بازنویسی می‌شوند.
.PP
از سوی دیگر، ممکن است تنها دایرکتوری‌های خاصی وجود داشته باشند که بخواهید واقعاً
آن‌ها را همگام‌سازی کنید و تمام موارد دیگر را مستثنی نمایید.
مثال فیلترهای سبک include را برای دایرکتوری‌های کاربری Windows در زیر ببینید..SS دستورالعمل‌های نوشتن فایل فیلترها
.IP "1." 3
با مستثنی کردن درخت‌های دایرکتوری شروع کنید:
.RS 4
.IP \[bu] 2
برای مثال:
\f[V]- /AppData/\f[R]
.IP \[bu] 2
وجود \f[V]**\f[R] در انتها ضروری نیست.
زمانی که یک سطح دایرکتوری خاص مستثنی شود، rclone دیگر هیچ‌چیز زیر آن را
بررسی نخواهد کرد.
.IP \[bu] 2
دایرکتوری‌هایی را که غیرضروری هستند، حجم زیادی دارند، مرتباً دستخوش تغییرات موقت می‌شوند، یا ممکن است مشکل دسترسی یا مجوز داشته باشند مستثنی کنید.
.IP \[bu] 2
مستثنی کردن این دایرکتوری‌ها در ابتدا، عملیات‌های rclone را (بسیار) سریع‌تر می‌کند.
.IP \[bu] 2
فایل‌های خاص را نیز می‌توان مستثنی کرد، مانند مثال مستثنی‌سازی‌های Dropbox در زیر.
.RE
.IP "2." 3
تصمیم بگیرید که آیا آسان‌تر (یا تمیزتر) است که:
.RS 4
.IP \[bu] 2
دایرکتوری‌های انتخابی را شامل کرده و در نتیجه \f[I]هر چیز دیگری را مستثنی کنید\f[R] \-\- یا \-\-
.IP \[bu] 2
دایرکتوری‌های انتخابی را مستثنی کرده و در نتیجه \f[I]هر چیز دیگری را شامل کنید\f[R]
.RE
.IP "3." 3
شامل کردن دایرکتوری‌های انتخابی:
.RS 4
.IP \[bu] 2
خطوطی مانند \f[V]+ /Documents/PersonalFiles/**\f[R] را اضافه کنید تا دایرکتوری‌هایی
که باید در همگام‌سازی گنجانده شوند مشخص گردند.
.IP \[bu] 2
وجود \f[V]**\f[R] در انتها تعیین می‌کند که کل عمق درخت دایرکتوری
مشخص‌شده گنجانده شود.
.IP \[bu] 2
در فیلترهای سبک گنجاندن (Include)، فایل‌های موجود در ریشهٔ Path1/Path2 گنجانده
نمی‌شوند.
آن‌ها را می‌توان با \f[V]+ /*\f[R] شامل کرد.
.IP \[bu] 2
فایل‌های RCLONE_TEST را درون این درخت‌های دایرکتوری گنجانده‌شده قرار دهید.
این فایل‌ها تنها در این درخت‌های دایرکتوری جستجو خواهند شد.
.IP \[bu] 2
کار را با مستثنی کردن همهٔ موارد دیگر از طریق افزودن \f[V]- **\f[R] در انتهای
فایل فیلترها به پایان برسانید.
.IP \[bu] 2
مرحلهٔ ۴ را نادیده بگیرید.
.RE
.IP "4." 3
مستثنی کردن دایرکتوری‌های انتخابی:
.RS 4
.IP \[bu] 2
خطوط بیشتری مانند مرحلهٔ ۱ اضافه کنید.
به عنوان مثال: \f[V]-/Desktop/tempfiles/\f[R] یا \f[V]- /testdir/\f[R].
مجدداً، وجود \f[V]**\f[R] در انتها ضروری نیست.
.IP \[bu] 2
خط \f[V]- **\f[R] را به فایل اضافه \f[I]نکنید\f[R].
بدون این خط، هر آنچه صراحتاً مستثنی نشده باشد،
گنجانده خواهد شد.
.IP \[bu] 2
مرحلهٔ ۳ را نادیده بگیرید.
.RE
.PP
چند قانون برای نحو (syntax) فایل فیلتر به منظور بسط مستندات فیلترسازی (<https://rclone.org/filtering>):
.IP \[bu] 2
خطوط می‌توانند با فاصله و تب آغاز شوند \- rclone فاصله‌های خالی ابتدای خط را حذف می‌کند.
.IP \[bu] 2
اگر اولین نویسهٔ غیرفاصله \f[V]#\f[R] باشد، آن خط یک توضیح (comment) است و نادیده گرفته خواهد شد.
.IP \[bu] 2
خطوط خالی نادیده گرفته می‌شوند.
.IP \[bu] 2
نخستین نویسهٔ غیرفاصله در یک خط فیلتر باید \f[V]+\f[R] یا \f[V]-\f[R] باشد.
.IP \[bu] 2
دقیقاً ۱ فاصله بین \f[V]+/-\f[R] و عبارت مسیر مجاز است.
.IP \[bu] 2
در عبارت‌های مسیر فقط از اسلش روبه‌جلو (\f[V]/\f[R]) استفاده می‌شود، حتی در ویندوز.
.IP \[bu] 2
باقی‌ماندهٔ خط به عنوان عبارت مسیر در نظر گرفته می‌شود.
فاصله‌های خالی انتهای خط دقیقاً همان‌طور که هستند در نظر گرفته می‌شوند و احتمالاً یک خطا هستند..SS نمونه فیلترهای سبک شمول (include-style) برای دایرکتوری‌های کاربر ویندوز
.PP
این نمونه‌ی \f[I]سبک شمول (include-style)\f[R] در ویندوز بر پایه تنظیم ریشه همگام‌سازی
(Path1) روی \f[V]C:\[rs]Users\[rs]MyLogin\f[R] است.
راهبرد بر این است که دایرکتوری‌های مشخصی برای همگام‌سازی با یک درایو
تحت شبکه (Path2) انتخاب شوند.
.IP \[bu] 2
الگوی \f[V]- /AppData/\f[R] کل درخت داده‌های ذخیره‌شده‌ی ویندوز را که
نیازی به همگام‌سازی ندارند مستثنی می‌کند.
در مورد من، AppData بیش از ۱۱ گیگابایت داده دارد که برایم اهمیتی ندارند، و
برخی زیردایرکتوری‌ها زیر AppData وجود دارند که برای حساب کاربری من قابل دسترسی نیستند
و منجر به توقف‌های بحرانی (critical aborts) در bisync می‌شوند.
.IP \[bu] 2
ویندوز فایل‌های کَشی را ایجاد می‌کند که با هر دو حالت حروف کوچک و بزرگ
\f[V]NTUSER\f[R] در \f[V]C:\[rs]Users\[rs]MyLogin\f[R] آغاز می‌شوند.
این فایل‌ها ممکن است پویا و قفل‌شده باشند و عموماً \f[I]بی‌اهمیت\f[R] هستند.
.IP \[bu] 2
تنها چند دایرکتوری با داده‌های \f[I]من\f[R] وجود دارند که واقعاً می‌خواهم
به صورت \f[V]+ /<path>\f[R] همگام‌سازی شوند.
با انتخاب صرفاً درخت‌های دایرکتوری مد نظرم، از بیش از دوازده دایرکتوری
که برنامه‌های گوناگون در \f[V]C:\[rs]Users\[rs]MyLogin\[rs]Documents\f[R]
می‌سازند اجتناب می‌کنم.
.IP \[bu] 2
با افزودن خط \f[V]+ /*\f[R]، فایل‌های موجود در ریشه نقطه همگام‌سازی،
\f[V]C:\[rs]Users\[rs]MyLogin\f[R]، را شامل کنید.
.IP \[bu] 2
این یک فایل فیلتر به سبک Include است، بنابراین با
\f[V]- **\f[R] پایان می‌یابد که هر چیزی را که صراحتاً شامل نشده است مستثنی می‌کند.
.IP
.nf
\f[C]
- /AppData/
- NTUSER*
- ntuser*
+ /Documents/Family/**
+ /Documents/Sketchup/**
+ /Documents/Microcapture_Photo/**
+ /Documents/Microcapture_Video/**
+ /Desktop/**
+ /Pictures/**
+ /*
- **
\f[R]
.fi
.PP
همچنین توجه داشته باشید که ویندوز چندین پیوند \[dq]library\[dq] مانند
\f[V]C:\[rs]Users\[rs]MyLogin\[rs]My Documents\[rs]My Music\f[R]
را پیاده‌سازی می‌کند که به \f[V]C:\[rs]Users\[rs]MyLogin\[rs]Music\f[R] اشاره دارند.
برنامه rclone این‌ها را به عنوان پیوند می‌بیند، بنابراین اگر می‌خواهید این پیوندها را
دنبال کنید، باید \f[V]--links\f[R] را به خط فرمان bisync اضافه کنید.
من دریافتم که در تلاش برای دنبال کردن پیوندها با خطاهای دسترسی مواجه می‌شوم،
بنابراین پرچم \f[V]--links\f[R] در rclone را قرار نمی‌دهم، اما در این صورت با انبوهی
از پیام‌های مزاحم \f[V]Can\[aq]t follow symlink\&...\f[R] از سوی rclone درباره دنبال نکردن پیوندها روبه‌رو می‌شوید.
این پیام‌های مزاحم را می‌توان با افزودن \f[V]--quiet\f[R] به خط فرمان bisync
فرونشاند.
.SS نمونه فایل‌های فیلتر به سبک exclude برای استفاده با Dropbox
.IP \[bu] 2
سرویس Dropbox همگام‌سازی فایل‌های موقت و فایل‌های پیکربندی/داده‌ی ذکرشده را مجاز نمی‌داند.
فیلترهای \f[V]- <filename>\f[R] این فایل‌ها را در هر کجای درخت همگام‌سازی
که باشند مستثنی می‌کنند.
افزودن استثناهای مشابه برای انواع فایل‌هایی را که نیازی به همگام‌سازی آن‌ها ندارید،
مانند فایل‌های core dump و ساخت نرم‌افزار، مد نظر قرار دهید.
.IP \[bu] 2
آزمایش‌های bisync پوشه‌ی \f[V]/testdir/\f[R] را در بالاترین سطح درخت همگام‌سازی
ایجاد می‌کنند و معمولاً پس از آزمایش، این درخت را حذف می‌کنند.
اگر در زمان وجود درخت \f[V]/testdir/\f[R] یک همگام‌سازی عادی اجرا شود،
مرحله‌ی \f[V]--check-access\f[R] ممکن است به دلیل فایل‌های نامتوازن RCLONE_TEST با شکست مواجه شود.
فیلتر \f[V]- /testdir/\f[R] از همگام‌سازی این درخت جلوگیری می‌کند.
اگر آزمایش‌های مربوط به توسعه‌ی bisync را انجام نمی‌دهید، نیازی به این استثنا ندارید.
.IP \[bu] 2
هر چیز دیگری در زیر ریشه Path1/Path2 همگام‌سازی خواهد شد.
.IP \[bu] 2
فایل‌های RCLONE_TEST ممکن است در هر جایی از درخت، از جمله ریشه، قرار داده شوند.
.SS نمونه فایل فیلتر برای Dropbox
.IP
.nf
\f[C]
# فایل فیلتر برای استفاده با bisync
# برای قوانین فیلترسازی https://rclone.org/filtering را ببینید
# توجه: در صورت اعمال تغییرات در این فایل، حتماً باید یک اجرای --resync انجام دهید.
#         با --dry-run اجرا کنید تا ببینید چه تغییراتی اعمال خواهند شد.

# سرویس Dropbox برخی فایل‌ها را همگام‌سازی نمی‌کند، بنابراین آنها را در اینجا فیلتر کنید.
# https://help.dropbox.com/installs-integrations/sync-uploads/files-not-syncing را ببینید
- .dropbox.attr
- \[ti]*.tmp
- \[ti]$*
- .\[ti]*
- desktop.ini
- .dropbox

# برای آزمایش bisync استفاده می‌شود، بنابراین از اجراهای عادی مستثنی شده است
- /testdir/

# سایر فیلترهای نمونه
#- /TiBU/
#- /Photos/
\f[R]
.fi.SS نحوه مدیریت فیلترها توسط --check-access
.PP
در ابتدای یک اجرای bisync، فهرست فایل‌ها برای Path1 و Path2 با اعمال \f[V]--filters-file\f[R] کاربر جمع‌آوری می‌شود.
در طول مرحله بررسی دسترسی (check access)، ابزار bisync این فهرست‌ها را برای یافتن فایل‌های \f[V]RCLONE_TEST\f[R] پویش می‌کند.
هر فایل \f[V]RCLONE_TEST\f[R] که توسط \f[V]--filters-file\f[R] پنهان شده باشد در این فهرست‌ها قرار \f[I]نمی‌گیرد\f[R] و بنابراین در مرحله بررسی دسترسی، بررسی نخواهد شد.
.SS عیب‌یابی (Troubleshooting)
.SS خواندن لاگ‌های bisync
.PP
در اینجا دو نمونه از اجرای عادی آورده شده است.
مورد اول یک فایل جدیدتر روی ریموت دارد.
مورد دوم هیچ تفاوتی (دلتا) بین مبدأ محلی و ریموت ندارد.
.IP
.nf
\f[C]
2021/05/16 00:24:38 INFO  : Synching Path1 \[dq]/path/to/local/tree/\[dq] with Path2 \[dq]dropbox:/\[dq]
2021/05/16 00:24:38 INFO  : Path1 checking for diffs
2021/05/16 00:24:38 INFO  : - Path1    File is new                         - file.txt
2021/05/16 00:24:38 INFO  : Path1:    1 changes:    1 new,    0 newer,    0 older,    0 deleted
2021/05/16 00:24:38 INFO  : Path2 checking for diffs
2021/05/16 00:24:38 INFO  : Applying changes
2021/05/16 00:24:38 INFO  : - Path1    Queue copy to Path2                 - dropbox:/file.txt
2021/05/16 00:24:38 INFO  : - Path1    Do queued copies to                 - Path2
2021/05/16 00:24:38 INFO  : Updating listings
2021/05/16 00:24:38 INFO  : Validating listings for Path1 \[dq]/path/to/local/tree/\[dq] vs Path2 \[dq]dropbox:/\[dq]
2021/05/16 00:24:38 INFO  : Bisync successful

2021/05/16 00:36:52 INFO  : Synching Path1 \[dq]/path/to/local/tree/\[dq] with Path2 \[dq]dropbox:/\[dq]
2021/05/16 00:36:52 INFO  : Path1 checking for diffs
2021/05/16 00:36:52 INFO  : Path2 checking for diffs
2021/05/16 00:36:52 INFO  : No changes found
2021/05/16 00:36:52 INFO  : Updating listings
2021/05/16 00:36:52 INFO  : Validating listings for Path1 \[dq]/path/to/local/tree/\[dq] vs Path2 \[dq]dropbox:/\[dq]
2021/05/16 00:36:52 INFO  : Bisync successful
\f[R]
.fi
.SS رفتار نامتعارف در اجرای آزمایشی (Dry run oddity)
.PP
پیام‌های \f[V]--dry-run\f[R] ممکن است نشان دهند که تلاشی برای حذف برخی فایل‌ها صورت خواهد گرفت.
به عنوان مثال، اگر فایلی روی Path2 جدید باشد و در Path1 وجود نداشته باشد، در حالت عادی به Path1 کپی می‌شود، اما با فعال بودن \f[V]--dry-run\f[R] این کپی‌ها انجام نمی‌گیرند که باعث می‌شود تلاشی برای حذف آن از روی Path2 ثبت شود، که البته این حذف نیز مجدداً توسط --dry-run مسدود می‌شود:
\f[V]... Not deleting as --dry-run\f[R].
.PP
تمام این وضعیت گیج‌کننده یک اثر جانبی ناشی از پرچم \f[V]--dry-run\f[R] است.
حذف‌های پیشنهادی را با دقت بررسی کنید؛ اگر فایل‌ها قرار بوده در Path1 کپی شوند، می‌توان هشدارهای حذف در Path2 را نادیده گرفت.
.SS تلاش‌های مجدد (Retries)
.PP
ابزار Rclone سازوکار تلاش مجدد توکار دارد.
اگر آن را با \f[V]--verbose\f[R] اجرا کنید، پیام‌های خطا و تلاش مجدد مشابه آنچه در زیر نشان داده شده است را مشاهده خواهید کرد.
این مورد معمولاً یک باگ نیست.
اگر در پایان اجرا عبارت \f[V]Bisync successful\f[R] را مشاهده کردید و خبری از \f[V]Bisync critical error\f[R] یا \f[V]Bisync aborted\f[R] نبود، اجرا موفقیت‌آمیز بوده است و می‌توانید پیام‌های خطا را نادیده بگیرید.
.PP
اجرای زیر یک خطای موقتی را نشان می‌دهد.
خطوط \f[I]5\f[R] و \f[I]6\f[R] پیام‌های سطح پایین هستند.
خط \f[I]6\f[R] یک پیام \f[I]هشدار (warning)\f[R] منتقل‌شده به سطوح بالاتر است که خطا را اعلام می‌کند.
ابزار Rclone معمولاً دستورهای ناموفق را دوباره امتحان می‌کند، بنابراین ممکن است پیام‌های متعددی از این دست در لاگ دیده شود.
.PP
از آنجا که در خط \f[I]7\f[R] هیچ پیام خطا/هشدار نهایی دیده نمی‌شود، rclone پس از یک تلاش مجدد از خطا بازیابی شده و عملیات کلی همگام‌سازی با موفقیت انجام گرفته است.
.IP
.nf
\f[C]
1: 2021/05/14 00:44:12 INFO  : Synching Path1 \[dq]/path/to/local/tree\[dq] with Path2 \[dq]dropbox:\[dq]
2: 2021/05/14 00:44:12 INFO  : Path1 checking for diffs
3: 2021/05/14 00:44:12 INFO  : Path2 checking for diffs
4: 2021/05/14 00:44:12 INFO  : Path2:  113 changes:   22 new,    0 newer,    0 older,   91 deleted
5: 2021/05/14 00:44:12 ERROR : /path/to/local/tree/objects/af: error listing: unexpected end of JSON input
6: 2021/05/14 00:44:12 NOTICE: WARNING  listing try 1 failed.                 - dropbox:
7: 2021/05/14 00:44:12 INFO  : Bisync successful
\f[R]
.fi
.PP
این لاگ یک \f[I]خطای بحرانی (Critical failure)\f[R] را نشان می‌دهد که برای بازیابی از آن اجرای \f[V]--resync\f[R] الزامی است.
بخش «مدیریت خطاهای زمان اجرا» (Runtime Error Handling) را ببینید.
.IP
.nf
\f[C]
2021/05/12 00:49:40 INFO  : Google drive root \[aq]\[aq]: Waiting for checks to finish
2021/05/12 00:49:40 INFO  : Google drive root \[aq]\[aq]: Waiting for transfers to finish
2021/05/12 00:49:40 INFO  : Google drive root \[aq]\[aq]: not deleting files as there were IO errors
2021/05/12 00:49:40 ERROR : Attempt 3/3 failed with 3 errors and: not deleting files as there were IO errors
2021/05/12 00:49:40 ERROR : Failed to sync: not deleting files as there were IO errors
2021/05/12 00:49:40 NOTICE: WARNING  rclone sync try 3 failed.           - /path/to/local/tree/
2021/05/12 00:49:40 ERROR : Bisync aborted. Must run --resync to recover.
\f[R]
.fi.SS بارگیری‌های مسدودشده فایل‌های \[dq]آلوده\[dq] یا \[dq]مخرب\[dq]
.PP
Google Drive فیلتری برای انواع مشخصی از فایل‌ها (\f[V].exe\f[R]،
\f[V].apk\f[R] و غیره) دارد که به‌طور پیش‌فرض نمی‌توانند از Google
Drive در سیستم‌فایل محلی کپی شوند.
اگر با مشکلی مواجه شدید، با \f[V]--verbose\f[R] اجرا کنید تا
مشخصاً ببینید کدام فایل‌ها خطا تولید می‌کنند.
اگر خطای دریافتی
\f[V]This file has been identified as malware or spam and cannot be downloaded\f[R]
بود، استفاده از پرچم
--drive-acknowledge-abuse (https://rclone.org/drive/#drive-acknowledge-abuse) را در نظر بگیرید.
.SS اسناد Google Docs (و دیگر فایل‌های با اندازه نامشخص)
.PP
از نسخه \f[V]v1.66\f[R]، اسناد Google
Docs (https://rclone.org/drive/#import-export-of-google-documents)
(شامل Google Sheets، Slides و غیره)
در bisync پشتیبانی می‌شوند و مشمول همان گزینه‌ها، مقادیر پیش‌فرض و
محدودیت‌های موجود در \f[V]rclone sync\f[R] هستند.
هنگام همگام‌سازی دوطرفه درایو با بک‌اندهای غیردرایو، جهت درایو به غیردرایو با
\f[V]--drive-export-formats\f[R] (https://rclone.org/drive/#drive-export-formats)
(پیش‌فرض \f[V]\[dq]docx,xlsx,pptx,svg\[dq]\f[R]) و جهت غیردرایو به
درایو با
\f[V]--drive-import-formats\f[R] (https://rclone.org/drive/#drive-import-formats)
(پیش‌فرض خالی) کنترل می‌شود.
.PP
برای نمونه، با قالب‌های خروجی/ورودی پیش‌فرض، یک Google Sheet در
سمت درایو با یک فایل \f[V].xlsx\f[R] در
سمت غیردرایو همگام‌سازی خواهد شد.
در جهت معکوس، فایل‌های \f[V].xlsx\f[R] با نام‌هایی که
با یک Google Sheet موجود همخوانی دارند با همان Google Sheet همگام می‌شوند،
در حالی که فایل‌های \f[V].xlsx\f[R] که با هیچ Google Sheet موجودی همخوانی ندارند
به عنوان فایل‌های عادی \f[V].xlsx\f[R] در درایو کپی خواهند شد (بدون
تبدیل به Sheets، هرچند واسط کاربری مرورگر وب Google Drive ممکن است
همچنان امکان باز کردن آن به عنوان یک شیت را به شما بدهد).
.PP
اگر \f[V]--drive-import-formats\f[R] تنظیم شده باشد (که به‌طور پیش‌فرض تنظیم نیست)،
در صورتی که هیچ Google Doc موجودی با نام مشابه وجود نداشته باشد،
تمام قالب‌های مشخص‌شده به Google Docs تبدیل خواهند شد.
احتیاط: چنین تبدیلی می‌تواند با اتلاف داده (lossy) همراه باشد، و در بیشتر
موارد احتمالاً چیزی نیست که مد نظرتان باشد!
.PP
برای همگام‌سازی دوطرفه Google Docs به شکل پیوندهای میان‌بر URL (مشابه
روش \[dq]Drive for Desktop\[dq])، از این مورد استفاده کنید: \f[V]--drive-export-formats url\f[R]
(یا
روش‌های جایگزین (https://rclone.org/drive/#exportformats:~:text=available%20Google%20Documents.-,Extension,macOS,-Standard%20options)).
.PP
توجه داشته باشید که این فایل‌های پیوند در سمت غیردرایو قابل ویرایش نیستند -- اگر
سعی کنید یک فایل پیوند ویرایش‌شده را به درایو بازگردانید، با خطا مواجه خواهید شد.
آن‌ها قابل حذف هستند (و این کار منجر به حذف Google
Doc متناظر خواهد شد).
اگر در سمت غیردرایو یک فایل \f[V].url\f[R] ایجاد کنید که با یک
Google Doc موجود مطابقت نداشته باشد، اجرای bisync تنها موجب کپی شدن
همان فایل متنی \f[V].url\f[R] در درایو می‌شود (هیچ Google Doc ساخته
نخواهد شد).
بنابراین، به عنوان یک قاعده کلی، آن‌ها را در سمت غیردرایو جایگزین‌های فقط‌خواندنی
در نظر بگیرید و همه تغییرات خود را در سمت درایو اعمال کنید.
.PP
به همین ترتیب، حتی با دیگر قالب‌های خروجی، بهتر است جابه‌جایی یا تغییر نام
Google Docs فقط در سمت درایو انجام شود.
زیرا در غیر این صورت، bisync این عمل را به عنوان حذف یک فایل
و ایجاد فایلی دیگر در نظر می‌گیرد و بر این اساس، سند Google Doc را حذف کرده و
فایل جدیدی در مسیر جدید می‌سازد.
(اینکه آیا آن فایل جدید یک Google Doc باشد یا نه، به
\f[V]--drive-import-formats\f[R] بستگی دارد).
.PP
در نهایت، دقت داشته باشید که تمام اسناد Google Docs در سمت درایو اندازه‌ای برابر با
\f[V]-1\f[R] دارند و فاقد چکسام (checksum) هستند.
بنابراین، نمی‌توان آن‌ها را به‌طور قابل اطمینان با پرچم‌های \f[V]--checksum\f[R]
یا \f[V]--size-only\f[R] همگام‌سازی کرد.
(به بیان دقیق‌تر: آن‌ها همچنان ایجاد یا حذف خواهند شد و موتور بررسی تغییرات bisync
تغییرات را شناسایی کرده و آن‌ها را برای همگام‌سازی در صف قرار می‌دهد، اما
تابع همگام‌سازی زیرین آن‌ها را یکسان در نظر گرفته و نادیده می‌گیرد).
برای دور زدن این مشکل، به جای \f[V]--checksum\f[R] یا \f[V]--size-only\f[R]
از حالت پیش‌فرض (modtime و اندازه) استفاده کنید.
.PP
برای نادیده گرفتن کامل Google Docs، از گزینه
\f[V]--drive-skip-gdocs\f[R] (https://rclone.org/drive/#drive-skip-gdocs) استفاده کنید.
.SS مثال‌های کاربردی
.SS Cron
.PP
ابزار Rclone هنوز قابلیت داخلی برای پایش سیستم‌فایل محلی جهت تشخیص
تغییرات ندارد و باید به‌صورت دوره‌ای اجرا شود.
در ویندوز این کار را می‌توان با استفاده از \f[I]Task Scheduler\f[R] انجام داد، در لینوکس
می‌توانید از \f[I]Cron\f[R] استفاده کنید که در زیر شرح داده شده است.
.PP
مثال نخست، یک همگام‌سازی را هر ۵ دقیقه میان یک دایرکتوری محلی
و یک سرور OwnCloud اجرا می‌کند و خروجی در یک فایل گزارش ثبت می‌شود:
.IP
.nf
\f[C]
# Minute (0-59)
#      Hour (0-23)
#           Day of Month (1-31)
#                Month (1-12 or Jan-Dec)
#                     Day of Week (0-6 or Sun-Sat)
#                         Command
  */5  *    *    *    *   /path/to/rclone bisync /local/files MyCloud: --check-access --filters-file /path/to/bysync-filters.txt --log-file /path/to//bisync.log
\f[R]
.fi
.PP
برای جزئیات عبارات بازه زمانی crontab به
ساختار crontab (https://www.man7.org/linux/man-pages/man1/crontab.1p.html#INPUT_FILES)
مراجعه کنید.
.PP
اگر \f[V]rclone bisync\f[R] را به عنوان یک وظیفه cron اجرا می‌کنید، خروجی‌های stdout/stderr
را به یک فایل هدایت کنید.
مثال دوم یک همگام‌سازی با Dropbox را هر ساعت اجرا کرده و تمام stdout
(از طریق \f[V]>>\f[R]) و stderr (از طریق \f[V]2>&1\f[R]) را در یک فایل لاگ ثبت می‌کند.
.IP
.nf
\f[C]
0 * * * * /path/to/rclone bisync /path/to/local/dropbox Dropbox: --check-access --filters-file /home/user/filters.txt >> /path/to/logs/dropbox-run.log 2>&1
\f[R]
.fi.SS اشتراک‌گذاری درخت پوشه رمزگذاری‌شده بین میزبان‌ها
.PP
ابزار bisync می‌تواند یک پوشه محلی را با یک سرویس ابری همگام نگه دارد، اما اگر بخواهید فایل‌های بسیار حساسی را همگام‌سازی کنید چه؟
.PP
استفاده از یک سرویس ابری برای تبادل فایل‌های شخصیِ روزمره و همچنین حساس، میان شبکه خانگی، لپ‌تاپ شخصی در هنگام سفر و رایانه کاری است.
داده‌های روزمره حساس نیستند.
برای داده‌های حساس، یک ریموت crypt در rclone (<https://rclone.org/crypt>) پیکربندی کنید تا به زیرپوشه‌ای درون درخت دیسک محلی که با Dropbox همگام (bisync) می‌شود اشاره کند، و سپس یک bisync برای این دایرکتوری crypt محلی با دایرکتوری دیگری در خارج از درخت اصلیِ همگام‌سازی برقرار کنید.
.SS راه‌اندازی در سرور لینوکس
.IP \[bu] 2
مسیر \f[V]/path/to/DBoxroot\f[R] ریشه درخت همگام‌سازی محلی من است.
زیرپوشه‌های متعددی در آن وجود دارد.
.IP \[bu] 2
مسیر \f[V]/path/to/DBoxroot/crypt\f[R] زیرپوشه ریشه برای فایل‌های رمزگذاری‌شده است.
این مقصد دایرکتوری محلی به عنوان یک ریموت crypt در rclone با نام \f[V]Dropcrypt:\f[R] تنظیم شده است.
قطعه‌کد rclone.conf در زیر را ببینید.
.IP \[bu] 2
مسیر \f[V]/path/to/my/unencrypted/files\f[R] ریشه فایل‌های حساس من است \- رمزگذاری‌نشده و خارج از درختی که با Dropbox همگام می‌شود.
.IP \[bu] 2
برای همگام‌سازی فایل‌های رمزگذاری‌نشده محلی خود با نسخه‌های رمزگذاری‌شده Dropbox، دستور \f[V]bisync /path/to/my/unencrypted/files DropCrypt:\f[R] را به طور دستی اجرا می‌کنم.
این مرحله را می‌توان در قالب یک اسکریپت قرار داد تا قبل و بعد از همگام‌سازی کامل درخت Dropbox در مرحله آخر اجرا شود و در نتیجه فایل‌های حساس همیشه به‌طور فعال همگام بمانند.
.IP \[bu] 2
دستور \f[V]bisync /path/to/DBoxroot Dropbox:\f[R] به‌طور دوره‌ای از طریق cron اجرا می‌شود و کل درخت همگام‌سازی محلی من را با Dropbox همگام نگه می‌دارد.
.SS راه‌اندازی در لپ‌تاپ ویندوز
.IP \[bu] 2
کلاینت Dropbox اجرا می‌شود تا درخت محلی
\f[V]C:\[rs]Users\[rs]MyLogin\[rs]Dropbox\f[R] را همواره با Dropbox همگام نگه دارد.
می‌توانستم به جای آن از \f[V]rclone bisync\f[R] استفاده کنم.
.IP \[bu] 2
یک درخت دایرکتوری مجزا در مسیر
\f[V]C:\[rs]Users\[rs]MyLogin\[rs]Documents\[rs]DropLocal\f[R] میزبان درخت فایل‌ها/پوشه‌های رمزگذاری‌نشده است.
.IP \[bu] 2
برای همگام‌سازی فایل‌های رمزگذاری‌نشده محلی خود با نسخه‌های رمزگذاری‌شده Dropbox، دستور زیر را به صورت دستی اجرا می‌کنم:
\f[V]rclone bisync C:\[rs]Users\[rs]MyLogin\[rs]Documents\[rs]DropLocal Dropcrypt:\f[R].
.IP \[bu] 2
سپس کلاینت Dropbox تغییرات را با Dropbox همگام‌سازی می‌کند.
.SS قطعه‌کد rclone.conf
.IP
.nf
\f[C]
[Dropbox]
type = dropbox
\&...

[Dropcrypt]
type = crypt
remote = /path/to/DBoxroot/crypt          # on the Linux server
remote = C:\[rs]Users\[rs]MyLogin\[rs]Dropbox\[rs]crypt   # on the Windows notebook
filename_encryption = standard
directory_name_encryption = true
password = ...
\&...
\f[R]
.fi
.SS آزمایش
.PP
این بخش را فقط در صورتی بخوانید که در حال توسعه برای rclone هستید.
برای کار با آزمون‌های bisync، باید کد منبع rclone را به صورت محلی در اختیار داشته باشید.
.PP
ابزار Bisync دارای یک چارچوب آزمون اختصاصی است که در فایل
\f[V]bisync_test.go\f[R] واقع در درخت منبع rclone پیاده‌سازی شده است.
مجموعه آزمون‌ها مبتنی بر دستور \f[V]go test\f[R] است.
مجموعه‌ای از آزمون‌ها در زیرپوشه‌های دایرکتوری
\f[V]cmd/bisync/testdata\f[R] ذخیره شده‌اند.
آزمون‌های تکی را می‌توان با نام دایرکتوری آن‌ها فراخوانی کرد، برای مثال:
\f[V]go test . -case basic -remote local -remote2 gdrive: -v\f[R]
.PP
آزمون‌ها یک پوشه موقت در ریموت ایجاد کرده و پس از پایان کار آن را پاکسازی (purge) می‌کنند.
اگر در حین اجرای آزمون خطاهای متناوب رخ دهد و rclone مجدداً تلاش کند، این خطاها دریافت شده و به عنوان MISCOMPAREهای نامعتبر نشانه‌گذاری می‌شوند.
اجرای مجدد آزمون باعث عبور موفقیت‌آمیز آن خواهد شد.
چنین شکست‌هایی را به عنوان نویز در نظر بگیرید..SS ساختار دستور آزمون
.IP
.nf
\f[C]
usage: go test ./cmd/bisync [options...]

گزینه‌ها:
  -case NAME        نام(های) مورد آزمون برای اجرا. نام‌های چندگانه باید
                    با کاما از هم جدا شوند. می‌توانید برای راحتی، پیشوند
                    \[ga]test_\[ga] را حذف کرده و \[ga]_\[ga] را با \[ga]-\[ga] در نام آزمون جایگزین کنید.
                    اگر \[ga]all\[ga] نباشد، نام(ها) باید به دایرکتوری‌ای زیر
                    \[ga]./cmd/bisync/testdata\[ga] نگاشت شوند.
                    برای اجرای همه آزمون‌ها از \[ga]all\[ga] استفاده کنید (پیش‌فرض: all)
  -remote PATH1     مقدار \[ga]local\[ga] یا نام سرویس ابری به همراه \[ga]:\[ga] (پیش‌فرض: local)
  -remote2 PATH2    مقدار \[ga]local\[ga] یا نام سرویس ابری به همراه \[ga]:\[ga] (پیش‌فرض: local)
  -no-compare       غیرفعال کردن مقایسه نتایج آزمون با دایرکتوری golden
                    (پیش‌فرض: compare)
  -no-cleanup       غیرفعال کردن پاک‌سازی دایرکتوری‌های آزمون Path1 و Path2.
                    مفید برای عیب‌یابی. (پیش‌فرض: cleanup)
  -golden           ذخیره نتایج در دایرکتوری golden (پیش‌فرض: false)
                    این گزینه می‌تواند برای چندین آزمون استفاده شود.
  -debug            چاپ پیام‌های اشکال‌زدایی
  -stop-at NUM      توقف آزمون پس از شماره مرحله داده‌شده. (پیش‌فرض: اجرا تا پایان)
                    در صورتی که آزمون واقعاً زودتر از موعد پایان یابد، شامل
                    \[ga]-no-compare\[ga] و \[ga]-no-cleanup\[ga] می‌شود. فقط برای یک مورد آزمون معنادار است.
  -refresh-times    اجبار به تازه‌سازی زمان تغییر مقصد (modtime)، مفید برای Dropbox
                    (پیش‌فرض: false)
  -verbose          اجرای آزمون‌ها با جزئیات کامل
\f[R]
.fi
.PP
نکته: برخلاف گزینه‌های rclone که باید پیشوند دو خط تیره
(\f[V]--\f[R]) داشته باشند، گزینه‌های دستور آزمون می‌توانند با یک خط تیره
(\f[V]-\f[R]) یا دو خط تیره مشخص شوند.
.SS اجرای آزمون‌ها
.IP \[bu] 2
دستور \f[V]go test . -case basic -remote local -remote2 local\f[R] مورد
آزمون \f[V]test_basic\f[R] را تنها با استفاده از سیستم‌فایل محلی اجرا می‌کند و
یک دایرکتوری محلی را با یک دایرکتوری محلی دیگر همگام‌سازی می‌نماید.
خروجی اسکریپت آزمون به کنسول فرستاده می‌شود، در حالی که خروجی دستورهای درون scenario.txt
به فایل \f[V].../workdir/test.log\f[R] ارسال می‌شود که
در نهایت با نسخه مرجع (golden copy) مقایسه می‌گردد.
.IP \[bu] 2
نخستین آرگومان پس از \f[V]go test\f[R] باید نام نسبی دایرکتوری
حاوی کد منبع bisync باشد.
اگر آزمون‌ها را مستقیماً از همان‌جا اجرا کنید، این آرگومان \f[V].\f[R]
(دایرکتوری جاری) خواهد بود، همان‌طور که در بیشتر مثال‌های زیر آمده است.
اگر آزمون‌های bisync را از دایرکتوری منبع rclone اجرا می‌کنید،
دستور باید به صورت \f[V]go test ./cmd/bisync ...\f[R] باشد.
.IP \[bu] 2
موتور آزمون خروجی rclone را دستکاری می‌کند تا از امکان مقایسه با
فهرست‌ها و گزارش‌های مرجع (golden) اطمینان حاصل شود.
.IP \[bu] 2
سناریوهای آزمون در \f[V]./cmd/bisync/testdata\f[R] قرار دارند.
آرگومان \f[V]-case\f[R] آزمون باید با نام کامل یک زیردایرکتوری
زیر آن دایرکتوری مطابقت داشته باشد.
نام هر زیردایرکتوری آزمون روی دیسک باید با \f[V]test_\f[R] آغاز شود؛
این پیشوند را می‌توان برای کوتاهی در خط فرمان نادیده گرفت.
همچنین، برای راحتی کار می‌توان خط‌های زیرین در نام را با خط تیره جایگزین کرد.
.IP \[bu] 2
دستور \f[V]go test . -remote local -remote2 local -case all\f[R] همه
آزمون‌ها را اجرا می‌کند.
.IP \[bu] 2
‏Path1 و Path2 می‌توانند کلیدواژه \f[V]local\f[R] یا نام سرویس‌های
ابری پیکربندی‌شده باشند.
دستور \f[V]go test . -remote gdrive: -remote2 dropbox: -case basic\f[R]
آزمون را میان این دو سرویس، بدون انتقال هیچ فایلی به سیستم‌فایل محلی اجرا خواهد کرد.
.IP \[bu] 2
خروجی‌های کنسول stdout و stderr اجرای آزمون را می‌توان به یک فایل هدایت کرد،
مانند:
\f[V]go test . -remote gdrive: -remote2 local -case all > runlog.txt 2>&1\f[R]
.SS روند اجرای آزمون
.IP "1." 3
راه‌اندازی پایه در دایرکتوری \f[V]initial\f[R] مورد آزمون بر روی
سیستم‌فایل‌های Path1 و Path2 اعمال می‌شود (از طریق rclone copy دایرکتوری
initial به Path1، و سپس rclone sync از Path1 به Path2).
.IP "2." 3
دستورهای موجود در فایل scenario.txt اعمال می‌شوند و خروجی آن‌ها به فایل
\f[V]test.log\f[R] در دایرکتوری کاری آزمون هدایت می‌گردد.
به طور معمول، نخستین دستور واقعی در فایل \f[V]scenario.txt\f[R] اجرای یک
\f[V]--resync\f[R] است که فایل‌های مبنای \f[V]{...}.path1.lst\f[R] و
\f[V]{...}.path2.lst\f[R] را در دایرکتوری کاری آزمون (\f[V].../workdir/\f[R]
به صورت نسبی نسبت به دایرکتوری موقت آزمون) مستقر می‌کند.
دستورهای گوناگون و ثبت وضعیت فهرست‌ها (listing snapshots) در طول آزمون انجام می‌شوند.
.IP "3." 3
در پایان، محتویات دایرکتوری کاری آزمون با محتویات دایرکتوری
مرجع (golden) مربوط به مورد آزمون مقایسه می‌شود..SS "نکاتی درباره آزمایش (Notes about testing)"
.IP \[bu] 2
موردهای آزمون در دایرکتوری‌های جداگانه زیر
\f[V]./cmd/bisync/testdata\f[R] قرار دارند.
ارجاع خط فرمان به یک آزمون به عنوان ارجاعی به یک دایرکتوری زیر
\f[V]testdata\f[R] درک می‌شود.
برای نمونه،
\f[V]go test ./cmd/bisync -case dry-run -remote gdrive: -remote2 local\f[R]
به مورد آزمون در \f[V]./cmd/bisync/testdata/test_dry_run\f[R] اشاره دارد.
.IP \[bu] 2
دایرکتوری کاری آزمون در \f[V].../workdir\f[R] به صورت نسبی نسبت به یک
دایرکتوری موقت آزمون، معمولاً زیر \f[V]/tmp\f[R] در لینوکس، واقع شده است.
.IP \[bu] 2
درخت همگام‌سازی آزمایشی محلی در یک دایرکتوری موقت با نامی شبیه
\f[V]bisync.XXX\f[R] زیر دایرکتوری موقت سیستم ایجاد می‌شود.
.IP \[bu] 2
درخت همگام‌سازی آزمایشی ریموت در یک دایرکتوری موقت زیر
\f[V]<remote:>/bisync.XXX/\f[R] قرار دارد.
.IP \[bu] 2
زیردایرکتوری‌های \f[V]path1\f[R] و/یا \f[V]path2\f[R] در یک دایرکتوری موقت
زیر ریموت آزمایشی محلی یا ابری مربوطه ایجاد می‌شوند.
.IP \[bu] 2
به‌طور پیش‌فرض، دایرکتوری‌های آزمایشی Path1 و Path2 و همچنین workdir پس
از هر بار اجرای آزمون حذف خواهند شد.
پرچم \f[V]-no-cleanup\f[R] پاک‌سازی این دایرکتوری‌ها را هنگام اعتبارسنجی
و اشکال‌زدایی یک آزمون معین غیرفعال می‌کند.
این دایرکتوری‌ها صرف‌نظر از استفاده از \f[V]-no-cleanup\f[R]، پیش از اجرای
یک آزمون دیگر پاک‌سازی (flush) خواهند شد.
.IP \[bu] 2
احتمالاً مایل خواهید بود \f[V]- /testdir/\f[R] را به \f[V]--filters-file\f[R]
عادی bisync خود بیفزایید تا همگام‌سازی‌های عادی برای همگام‌سازی دایرکتوری‌های موقت
آزمون تلاش نکنند؛ چرا که ممکن است در برخی موردهای آزمون مغایرت‌های
\f[V]RCLONE_TEST\f[R] وجود داشته باشد که در غیر این صورت سیستم
\f[V]--check-access\f[R] را دچار خطا می‌کند.
سازوکار \f[V]--check-access\f[R] به صورت کدگذاری‌شده (hard-coded) تنظیم
شده تا فایل‌های \f[V]RCLONE_TEST\f[R] زیر \f[V]bisync/testdata\f[R] را
نادیده بگیرد، بنابراین موردهای آزمون حتی در صورت وجود عدم تطابق فایل بررسی
در درخت آزمون، می‌توانند در درخت همگام‌سازی‌شده قرار گیرند.
.IP \[bu] 2
برخی از آزمون‌های Dropbox ممکن است شکست بخورند، به‌ویژه با چاپ پیام زیر:
\f[V]src and dst identical but can\[aq]t set mod time without deleting and re-uploading\f[R]
این رفتار مورد انتظار است و به دلیل نحوه مدیریت زمان‌های تغییر توسط Dropbox رخ می‌دهد.
برای جبران این موضوع باید از پرچم آزمایشی \f[V]-refresh-times\f[R] استفاده کنید.
.IP \[bu] 2
اگر آزمون‌های Dropbox برای شما به محدودیت تعداد درخواست برخورد کردند و پیام خطای
\f[V]too_many_requests/...: Too many requests or write operations.\f[R]
را چاپ نمودند، دستورالعمل‌های Dropbox App ID را دنبال کنید
(<https://rclone.org/dropbox/#get-your-own-dropbox-app-id>).
.SS "به‌روزرسانی نتایج مرجع (Updating golden results)"
.PP
گاهی اوقات حتی یک تغییر ناچیز در سورس‌کد bisync می‌تواند سبب ایجاد تغییرات اندکی
شود که در فایل‌های لاگ متعددی پخش می‌شوند.
به‌روزرسانی دستی آن‌ها کابوس خواهد بود.
.PP
پرچم \f[V]-golden\f[R] فایل‌های \f[V]test.log\f[R] و فهرست‌های
\f[V]*.lst\f[R] مربوط به هر مورد آزمون را در دایرکتوری‌های مرجع (golden)
مربوطه ذخیره می‌کند.
نتایج مرجع به‌طور خودکار شامل رشته‌های عمومی به جای مسیرهای محلی یا ابری خواهند بود،
به این معنی که هنگام اجرا با یک سرویس ابری دیگر نیز باید مطابقت داشته باشند.
.PP
جریان کاری معمول شما ممکن است به صورت زیر باشد:
.IP "1." 3
سورس‌کدهای rclone را به صورت محلی با Git کلون کنید (git-clone)
.IP "2." 3
سورس‌کد bisync را تغییر داده و بررسی کنید که بیلد (build) شود
.IP "3." 3
کل مجموعه آزمون را اجرا کنید: \f[V]go test ./cmd/bisync -remote local\f[R]
.IP "4." 3
اگر برخی از آزمون‌ها تفاوت لاگ نشان دادند، آن‌ها را جداگانه بررسی کنید، برای نمونه:
\f[V]go test ./cmd/bisync -remote local -case basic\f[R]
.IP "5." 3
اگر از درستی تفاوت‌ها مطمئن شدید، همه آزمون‌ها را یک‌باره مرجع‌گذاری (goldenize) کنید:
\f[V]go test ./cmd/bisync -remote local -golden\f[R]
.IP "6." 3
از مقایسه کلمه‌ای استفاده کنید: \f[V]git diff --word-diff ./cmd/bisync/testdata/\f[R].
لطفاً توجه داشته باشید که مقایسه عادی در سطح خط (line-level) معمولاً در اینجا بی‌فایده است.
.IP "7." 3
اختلافات را \f[I]به‌دقت\f[R] بررسی کنید!
.IP "8." 3
تغییرات را \f[I]تنها\f[R] در صورتی ثبت (commit) کنید (\f[V]git commit\f[R]) که مطمئن هستید.
در صورت عدم اطمینان، تغییرات کد خود را ذخیره کرده و سپس تفاوت‌های لاگ را از git پاک کنید:
\f[V]git reset [--hard]\f[R]..SS ساختار سناریوهای آزمون
.IP \[bu] 2
\f[V]<testname>/initial/\f[R] شامل درختی از فایل‌ها است که به عنوان
وضعیت اولیه روی هر دو دایرکتوری آزمون Path1 و Path2 تنظیم خواهد شد.
.IP \[bu] 2
\f[V]<testname>/modfiles/\f[R] شامل فایل‌هایی است که برای دستکاری
فایل‌سیستم‌های Path1 و/یا Path2 استفاده خواهند شد.
.IP \[bu] 2
\f[V]<testname>/golden/\f[R] شامل محتوای مورد انتظار دایرکتوری کاری
آزمون (\f[V]workdir\f[R]) پس از تکمیل مورد آزمون است.
.IP \[bu] 2
\f[V]<testname>/scenario.txt\f[R] شامل بدنهٔ آزمون در قالب دستورهای
مختلف برای تغییر فایل‌ها، اجرای bisync، و تهیهٔ نماگرفت (snapshot)
از فهرست‌ها است.
خروجی این دستورها برای مقایسه با فایل‌های مرجع (golden) در
\f[V].../workdir/test.log\f[R] ذخیره می‌شود.
.SS دستورهای آزمون پشتیبانی‌شده
.IP \[bu] 2
\f[V]test <some message>\f[R] چاپ خط در کنسول و در \f[V]test.log\f[R]:
\f[V]test sync is working correctly with options x, y, z\f[R]
.IP \[bu] 2
\f[V]copy-listings <prefix>\f[R] ذخیرهٔ یک رونوشت از تمام فهرست‌های
\f[V].lst\f[R] در دایرکتوری کاری آزمون با پیشوند مشخص‌شده:
\f[V]save-listings exclude-pass-run\f[R]
.IP \[bu] 2
\f[V]move-listings <prefix>\f[R] مشابه \f[V]copy-listings\f[R] اما مبدأ
را حذف می‌کند
.IP \[bu] 2
\f[V]purge-children <dir>\f[R] تمام فایل‌های فرزند را حذف و تمامی
زیردایرکتوری‌های فرزند زیر دایرکتوری داده‌شده را پاکسازی (purge)
می‌کند اما والد را دست‌نخورده نگه می‌دارد.
این رفتار برای آزمون‌ها با Google Drive مهم است زیرا حذف و ساخت
مجدد والد، شناسهٔ (ID) آن را تغییر می‌دهد.
.IP \[bu] 2
\f[V]delete-file <file>\f[R] حذف یک تک‌فایل.
.IP \[bu] 2
\f[V]delete-glob <dir> <pattern>\f[R] حذف گروهی از فایل‌های واقع در عمق
یک سطح از دایرکتوری مشخص‌شده که نام آن‌ها با الگوی glob داده‌شده
مطابقت دارد.
.IP \[bu] 2
\f[V]touch-glob YYYY-MM-DD <dir> <pattern>\f[R] تغییر زمان ویرایش
(modification time) روی گروهی از فایل‌ها.
.IP \[bu] 2
\f[V]touch-copy YYYY-MM-DD <source-file> <dest-dir>\f[R] تغییر زمان
ویرایش فایل و سپس رونوشت آن به مقصد.
.IP \[bu] 2
\f[V]copy-file <source-file> <dest-dir>\f[R] رونوشت یک تک‌فایل به
دایرکتوری داده‌شده.
.IP \[bu] 2
\f[V]copy-as <source-file> <dest-file>\f[R] مشابه مورد بالا اما مقصد
باید هم شامل دایرکتوری و هم نام فایل جدید در مقصد باشد.
.IP \[bu] 2
\f[V]copy-dir <src> <dst>\f[R] و \f[V]sync-dir <src> <dst>\f[R]
رونوشت/همگام‌سازی یک دایرکتوری.
معادل \f[V]rclone copy\f[R] و \f[V]rclone sync\f[R].
.IP \[bu] 2
\f[V]list-dirs <dir>\f[R] معادل با
\f[V]rclone lsf -R --dirs-only <dir>\f[R]
.IP \[bu] 2
\f[V]bisync [options]\f[R] اجرای bisync در برابر \f[V]-remote\f[R] و
\f[V]-remote2\f[R].
.SS عبارت‌های جایگزینی پشتیبانی‌شده
.IP \[bu] 2
\f[V]{testdir/}\f[R] \- دایرکتوری ریشهٔ مورد آزمون
.IP \[bu] 2
\f[V]{datadir/}\f[R] \- دایرکتوری \f[V]modfiles\f[R] زیر ریشهٔ مورد آزمون
.IP \[bu] 2
\f[V]{workdir/}\f[R] \- دایرکتوری کاری موقت آزمون
.IP \[bu] 2
\f[V]{path1/}\f[R] \- ریشهٔ درخت دایرکتوری آزمون Path1
.IP \[bu] 2
\f[V]{path2/}\f[R] \- ریشهٔ درخت دایرکتوری آزمون Path2
.IP \[bu] 2
\f[V]{session}\f[R] \- نام پایهٔ فهرست‌های آزمون
.IP \[bu] 2
\f[V]{/}\f[R] \- جداکنندهٔ مسیر مختص سیستم‌عامل
.IP \[bu] 2
\f[V]{spc}\f[R]، \f[V]{tab}\f[R]، \f[V]{eol}\f[R] \- فاصلهٔ خالی (whitespace)
.IP \[bu] 2
\f[V]{chr:HH}\f[R] \- بایت خام با کد هگزادسیمال مشخص‌شده
.PP
نتایج جایگزینی عبارت‌هایی با نام شبیه به \f[V]{dir/}\f[R] به \f[V]/\f[R]
(یا بک‌اسلش در ویندوز) ختم می‌شوند، بنابراین نیازی به درج اسلش در نحوهٔ
استفاده نیست، به عنوان مثال:
\f[V]delete-file {path1/}file1.txt\f[R]..SS بنچمارک‌ها (Benchmarks)
.PP
\f[I]این بخش در حال تکمیل است.\f[R]
.PP
در اینجا چند نمونه داده برای مقیاس، زمان‌های اجرا و میزان مصرف حافظه آورده شده است.
.PP
مجموعه داده نخست بین یک دیسک محلی و Dropbox اندازه‌گیری شد.
سرعت دانلود speedtest.net (https://speedtest.net) حدود \[ti]170
Mbps و سرعت آپلود \[ti]10 Mbps بود.
تعداد ۵۰۰ فایل (هرکدام حدود \[ti]9.5 MB) از قبل همگام‌سازی شده بودند.
تعداد ۵۰ فایل در یک دایرکتوری جدید اضافه شدند، هرکدام \[ti]9.5 MB، در
مجموع حدود \[ti]475 MB.
.PP
.TS
tab(@);
lw(23.8n) lw(35.0n) lw(11.2n).
T{
تغییر
T}@T{
عملیات و زمان‌ها
T}@T{
زمان کل اجرا
T}
_
T{
۵۰۰ فایل همگام‌شده (بدون نیاز به جابه‌جایی)
T}@T{
۱ بار فهرست‌گیری برای Path1 و Path2
T}@T{
1.5 ثانیه
T}
T{
۵۰۰ فایل همگام‌شده با --check-access
T}@T{
۱ بار فهرست‌گیری برای Path1 و Path2
T}@T{
1.5 ثانیه
T}
T{
۵۰ فایل جدید در ریموت
T}@T{
صف ۵۰ کپی رو به پایین: 27 ثانیه
T}@T{
29 ثانیه
T}
T{
جابه‌جایی دایرکتوری محلی
T}@T{
صف ۵۰ کپی رو به بالا: 410 ثانیه، ۵۰ حذف رو به بالا: 9 ثانیه
T}@T{
421 ثانیه
T}
T{
جابه‌جایی دایرکتوری ریموت
T}@T{
صف ۵۰ کپی رو به پایین: 31 ثانیه، ۵۰ حذف رو به پایین: <1 ثانیه
T}@T{
33 ثانیه
T}
T{
حذف دایرکتوری محلی
T}@T{
صف ۵۰ حذف رو به بالا: 9 ثانیه
T}@T{
13 ثانیه
T}
.TE
.PP
داده‌های بعدی از سناریوی واقعی یک کاربر به دست آمده است.
آن‌ها حدود \[ti]400GB داده شامل ۱.۹۶ میلیون فایل داشتند که میان یک
دیسک محلی Windows و یک فضای ابری ریموت همگام‌سازی می‌شد.
طول مسیر کامل فایل‌ها به‌طور میانگین ۳۵ نویسه بود (که در زمان بارگذاری
و مقدار RAM موردنیاز تأثیرگذار است).
.IP \[bu] 2
بارگذاری فهرست پیشین در حافظه (۱.۹۶ میلیون فایل، اندازه فایل فهرست
140 MB) حدود \[ti]30 ثانیه طول کشید و نزدیک به 1 GB از RAM را اشغال کرد.
.IP \[bu] 2
دریافت یک فهرست تازه از سیستم‌فایل محلی (که فایل خروجی 140 MB را تولید
کرد) حدود XXX ثانیه زمان برد.
.IP \[bu] 2
دریافت یک فهرست تازه از سیستم‌فایل ریموت (که فایل خروجی 140 MB را تولید
کرد) حدود XXX ثانیه زمان برد.
سرعت دانلود شبکه XXX Mb/s اندازه‌گیری شد.
.IP \[bu] 2
پس از بارگذاری فهرست‌های پیشین و فعلی Path1 و Path2 (در مجموع چهار مورد
جهت بارگذاری، هربار دو مورد هم‌زمان)، محاسبه تفاوت‌ها (deltas) بسیار
سریع انجام شد (چند ثانیه برای این مورد آزمایشی)، و زمان انتقال هر فایلی
که باید کپی می‌شد، کاملاً تحت تأثیر پهنای باند شبکه قرار داشت..SS "مراجع (References)"
.PP
پیاده‌سازی \f[V]bisync\f[R] در \f[V]rclone\f[R] از پروژه
rclonesync-V2 (https://github.com/cjnaz/rclonesync-V2) شامل
مستندات و سازوکارهای آزمون، با پشتیبانی و تشویق کامل
\[at]cjnaz (https://github.com/cjnaz) مشتق شده است.
.PP
دستور \f[V]rclone bisync\f[R] از نظر ماهیت شبیه به پروژه‌های دیگر زیر است:
.IP \[bu] 2
unison (https://github.com/bcpierce00/unison)
.IP \[bu] 2
syncthing (https://github.com/syncthing/syncthing)
.IP \[bu] 2
cjnaz/rclonesync (https://github.com/cjnaz/rclonesync-V2)
.IP \[bu] 2
ConorWilliams/rsinc (https://github.com/ConorWilliams/rsinc)
.IP \[bu] 2
jwink3101/syncrclone (https://github.com/Jwink3101/syncrclone)
.IP \[bu] 2
DavideRossi/upback (https://github.com/DavideRossi/upback)
.PP
ابزار Bisync از فن همگام‌سازی تفاضلی (differential synchronization) بهره می‌گیرد که مبتنی بر
نگهداری تاریخچه تغییرات انجام‌شده توسط هر دو طرف همگام‌سازی است.
بخش \f[I]Dual Shadow Method\f[R] را در مقاله Neil Fraser (https://neil.fraser.name/writing/sync)
ببینید.
.PP
همچنین به مقالات پژوهشی متعددی از Benjamin Pierce
(http://www.cis.upenn.edu/%7Ebcpierce/papers/index.shtml#File%20Synchronization)
درباره \f[I]Unison\f[R] و همگام‌سازی به‌طور کلی توجه کنید.
.SS "تغییرات (Changelog)"
.SS \f[V]v1.74.2\f[R]
.IP \[bu] 2
رفع مشکلی که در صورت استفاده از مقدار غیرپیش‌فرض برای \f[V]--conflict-resolve\f[R]،
باعث رفتار غیرمنتظره در \f[V]--conflict-loser pathname\f[R] می‌شد.
.SS \f[V]v1.74\f[R]
.IP \[bu] 2
افزودن چندین پارامتر جاافتاده \f[V]rc\f[R].
.IP \[bu] 2
پارامترهای اختیاری \f[V]rc\f[R] اکنون واقعاً اختیاری هستند.
.IP \[bu] 2
خروجی \f[V]rc\f[R] اکنون اطلاعات ساختاریافته‌تری ارائه می‌دهد.
.SS \f[V]v1.71\f[R]
.IP \[bu] 2
دستور \f[V]bisync\f[R] اکنون رسماً از مرحله آزمایشی (beta) خارج شده است.
.IP \[bu] 2
رفع مشکلی که اگر \f[V]path2\f[R] دارای هش‌های کُند بود و از \f[V]--no-slow-hash\f[R]
یا \f[V]--slow-hash-sync-only\f[R] استفاده می‌شد، نوع هش به نادرستی تنظیم می‌شد.
.IP \[bu] 2
رفع مشکلی که هنگام اجرای هم‌زمان چندین bisync از طریق \f[V]rc\f[R]
موجب بروز خطا می‌شد.
.SS \f[V]v1.69.1\f[R]
.IP \[bu] 2
رفع مشکلی که در شرایطی خاص باعث می‌شد فهرست‌بندی‌ها تغییرات هم‌زمان را ثبت نکنند.
.SS \f[V]v1.68\f[R]
.IP \[bu] 2
رفع مشکلی در بک‌اندها (backends) که زمان‌های ویرایش (modtimes) را به دقت پایین‌تری گرد می‌کردند.
.SS \f[V]v1.67\f[R]
.IP \[bu] 2
افزودن آزمون‌های یکپارچه‌سازی در برابر تمام بک‌اندها.
.SS \f[V]v1.66\f[R]
.IP \[bu] 2
عملیات کپی و حذف اکنون به جای دو عملیات، در قالب یک عملیات مدیریت می‌شوند.
.IP \[bu] 2
پشتیبانی از \f[V]--track-renames\f[R] و \f[V]--backup-dir\f[R] اضافه شد.
.IP \[bu] 2
مشکل شناخته‌شده بارگذاری‌های ناقص روی
\f[V]local\f[R]/\f[V]ftp\f[R]/\f[V]sftp\f[R] برطرف شد (مگر در صورت استفاده از \f[V]--inplace\f[R]).
.IP \[bu] 2
فهرست‌های نهایی اکنون از نتایج sync ایجاد می‌شوند تا از فهرست‌بندی دوباره بی‌نیاز شود.
.IP \[bu] 2
ابزار Bisync اکنون در برابر تغییراتی که در حین اجرای bisync رخ می‌دهند بسیار تاب‌آورتر است
و بسیار کمتر در معرض خطاهای حیاتی یا تغییرات شناسایی‌نشده قرار دارد.
.IP \[bu] 2
ابزار Bisync اکنون قادر است در موارد عدم قطعیت فهرست فایل‌ها را به عقب بازگرداند (rollback)،
و فایل را برای بررسی مجدد در نوبت بعدی نشانه‌گذاری کند.
.IP \[bu] 2
پشتیبانی از رنگ‌های پایه ترمینال اضافه شد که با
\f[V]--color\f[R] (https://rclone.org/docs/#color-autoneveralways)
(\f[V]AUTO\f[R]|\f[V]NEVER\f[R]|\f[V]ALWAYS\f[R]) قابل کنترل است.
.IP \[bu] 2
تصاویر لحظه‌ای (snapshots) اولیه فهرست‌بندی Path1 و Path2 اکنون به‌صورت هم‌زمان
و با استفاده از همان زیرساخت \[dq]march\[dq] دستورهای \f[V]check\f[R] و \f[V]sync\f[R]
ایجاد می‌شوند؛ جهت افزایش کارایی و کاهش خطر خطا
(https://forum.rclone.org/t/bisync-bugs-and-feature-requests/37636#:~:text=4.%20Listings%20should%20alternate%20between%20paths%20to%20minimize%20errors).
.IP \[bu] 2
اصلاح مدیریت استانداردسازی یونیکد (unicode normalization) و عدم حساسیت به بزرگی و کوچکی حروف،
همراه با پشتیبانی از \f[V]--fix-case\f[R] (https://rclone.org/docs/#fix-case)،
\f[V]--ignore-case-sync\f[R] و
\f[V]--no-unicode-normalization\f[R] (https://rclone.org/docs/#no-unicode-normalization).
.IP \[bu] 2
گزینه \f[V]--resync\f[R] اکنون بسیار بهینه‌تر عمل می‌کند (به‌ویژه برای کاربران \f[V]--create-empty-src-dirs\f[R]).
.IP \[bu] 2
سندهای Google Docs (و فایل‌های دیگری که اندازه نامشخص دارند) اکنون پشتیبانی می‌شوند
(با همان گزینه‌های موجود در \f[V]sync\f[R]).
.IP \[bu] 2
بررسی‌های برابری پیش از تغییر نام تعارضِ همگام‌سازی، زمانی که \f[V]check\f[R] در دسترس نباشد،
اکنون به جای \f[V]--size-only\f[R] به \f[V]cryptcheck\f[R] (در صورت امکان) یا \f[V]--download\f[R]
عقب‌گرد می‌کنند.
.IP \[bu] 2
هنگامی که پیکربندی‌ها با پرچم‌های اختصاصی بک‌اند بازنویسی می‌شوند، Bisync دیگر در یافتن
فایل فهرست‌بندی صحیح با خطا مواجه نمی‌شود.
.IP \[bu] 2
دستور Bisync اکنون از مقایسه بر اساس هر ترکیبی از اندازه (size)، زمان ویرایش (modtime) و چک‌سام
به‌طور کامل پشتیبانی می‌کند، که باعث رفع محدودیت پیشین در بک‌آندهای بدون پشتیبانی از modtime می‌شود.
.IP \[bu] 2
دستور Bisync اکنون از حالت خروج باوقار (\[dq]Graceful Shutdown\[dq]) پشتیبانی می‌کند
تا بتوان اجرا را بدون نیاز به \f[V]--resync\f[R] به‌طور تمیز لغو کرد.
.IP \[bu] 2
پرچم جدید \f[V]--recover\f[R] امکان بازیابی پایدار در صورت بروز اختلال را بدون نیاز به \f[V]--resync\f[R]
فراهم می‌سازد.
.IP \[bu] 2
تنظیم جدید \f[V]--max-lock\f[R] اجازه می‌دهد فایل‌های قفل به‌طور خودکار تمدید و منقضی شوند
تا بازیابی خودکار پس از توقف ناگهانی اجرا بهتر صورت گیرد.
.IP \[bu] 2
دستور Bisync اکنون از حل خودکار تعارضات و سفارشی‌سازی رفتار تغییر نام با پرچم‌های جدید
\f[V]--conflict-resolve\f[R]، \f[V]--conflict-loser\f[R] و \f[V]--conflict-suffix\f[R] پشتیبانی می‌کند.
.IP \[bu] 2
پرچم جدید \f[V]--resync-mode\f[R] کنترل بیشتری را برای نگه‌داشتن نسخه دلخواه فایل در طول
\f[V]--resync\f[R] فراهم می‌کند.
.IP \[bu] 2
دستور Bisync اکنون از
\f[V]--retries\f[R] (https://rclone.org/docs/#retries-int) و
\f[V]--retries-sleep\f[R] (هنگام فعال بودن \f[V]--resilient\f[R]) پشتیبانی می‌کند..SS \f[V]v1.64\f[R]
.IP \[bu] 2
رفع مشکلی (https://forum.rclone.org/t/bisync-bugs-and-feature-requests/37636#:~:text=1.%20Dry%20runs%20are%20not%20completely%20dry)
که باعث می‌شد اجرای آزمایشی (dry run) به طور ناخواسته تغییرات فیلتر را ثبت (commit) کند
.IP \[bu] 2
رفع مشکلی (https://forum.rclone.org/t/bisync-bugs-and-feature-requests/37636#:~:text=2.%20%2D%2Dresync%20deletes%20data%2C%20contrary%20to%20docs)
که باعث می‌شد \f[V]--resync\f[R] به اشتباه پوشه‌های خالی و فایل‌های تکراری منحصر‌به‌فرد در Path2 را حذف کند
.IP \[bu] 2
اکنون \f[V]--check-access\f[R] در حین \f[V]--resync\f[R] اجباری شده است،
که از دست رفتن داده‌ها را در سناریوهای خاصی از خطای کاربر جلوگیری می‌کند (https://forum.rclone.org/t/bisync-bugs-and-feature-requests/37636#:~:text=%2D%2Dcheck%2Daccess%20doesn%27t%20always%20fail%20when%20it%20should)
.IP \[bu] 2
رفع مشکلی (https://forum.rclone.org/t/bisync-bugs-and-feature-requests/37636#:~:text=5.%20Bisync%20reads%20files%20in%20excluded%20directories%20during%20delete%20operations)
که باعث می‌شد bisync به دلیل فیلترهای بیش از حد گسترده در حین عملیات حذف، فایل‌های بیشتری را نسبت به آنچه لازم است بررسی کند
.IP \[bu] 2
بهبود در تشخیص تعارض‌های کاذب تغییرات (https://forum.rclone.org/t/bisync-bugs-and-feature-requests/37636#:~:text=1.%20Identical%20files%20should%20be%20left%20alone%2C%20even%20if%20new/newer/changed%20on%20both%20sides)
(فایل‌های یکسان اکنون به جای تغییر نام، دست‌نخورده باقی می‌مانند)
.IP \[bu] 2
افزوده شدن پشتیبانی از
\f[V]--create-empty-src-dirs\f[R] (https://forum.rclone.org/t/bisync-bugs-and-feature-requests/37636#:~:text=3.%20Bisync%20should%20create/delete%20empty%20directories%20as%20sync%20does%2C%20when%20%2D%2Dcreate%2Dempty%2Dsrc%2Ddirs%20is%20passed)
.IP \[bu] 2
افزوده شدن حالت آزمایشی \f[V]--resilient\f[R] برای امکان بازیابی از
خطاهای خود-اصلاح‌شونده (https://forum.rclone.org/t/bisync-bugs-and-feature-requests/37636#:~:text=2.%20Bisync%20should%20be%20more%20resilient%20to%20self%2Dcorrectable%20errors)
.IP \[bu] 2
افزوده شدن پرچم جدید \f[V]--ignore-listing-checksum\f[R]
(https://forum.rclone.org/t/bisync-bugs-and-feature-requests/37636#:~:text=6.%20%2D%2Dignore%2Dchecksum%20should%20be%20split%20into%20two%20flags%20for%20separate%20purposes)
جهت تمایز از \f[V]--ignore-checksum\f[R]
.IP \[bu] 2
بهبودهای کارایی (https://forum.rclone.org/t/bisync-bugs-and-feature-requests/37636#:~:text=6.%20Deletes%20take%20several%20times%20longer%20than%20copies)
برای ریموت‌های بزرگ
.IP \[bu] 2
بهبودهای مستندات و آزمایش‌ها
.SH "امضای انتشار (Release signing)"
.PP
هش‌های باینری‌های انتشار rclone با یک کلید عمومی PGP/GPG امضا شده‌اند.
این موضوع را می‌توان همان‌طور که در ادامه توضیح داده شده، به صورت دستی راستی‌آزمایی کرد.
.PP
همین سازوکار توسط rclone
selfupdate (https://rclone.org/commands/rclone_selfupdate) نیز برای راستی‌آزمایی اینکه انتشار پیش از نصب به‌روزرسانی جدید دستکاری نشده است، استفاده می‌شود.
این کار، هش SHA256 و امضا را با یک کلید عمومی که درون باینری rclone کامپایل شده است، بررسی می‌کند.
.SS "کلید امضای انتشار (Release signing key)"
.PP
می‌توانید کلید امضای انتشار را از منابع زیر به دست آورید:
.IP \[bu] 2
از KEYS در این وب‌سایت \- این فایل همچنین شامل تمام کلیدهای امضای گذشته است.
.IP \[bu] 2
مخزن git میزبانی‌شده در GitHub \-
<https://github.com/rclone/rclone/blob/master/docs/content/KEYS>
.IP \[bu] 2
\f[V]gpg --keyserver hkps://keys.openpgp.org --search nick\[at]craig-wood.com\f[R]
.IP \[bu] 2
\f[V]gpg --keyserver hkps://keyserver.ubuntu.com --search nick\[at]craig-wood.com\f[R]
.IP \[bu] 2
<https://www.craig-wood.com/nick/pub/pgp-key.txt>
.PP
پس از وارد کردن (import) کلید، بررسی و تأیید کنید که اثر انگشت (fingerprint) یکی از کلیدها با \f[V]FBF737ECE9F8AB18604BD2AC93935E02FF3B54FA\f[R] مطابقت داشته باشد؛ چرا که این کلید برای امضا استفاده می‌شود.
.PP
توصیه می‌کنیم اثر انگشت نمایش‌داده‌شده در بالا را از طریق دامنه‌های فهرست‌شده در زیر بررسی متقابل (cross-check) کنید.
با بررسی متقابل صحت اثر انگشت در چندین دامنه، می‌توانید مطمئن شوید که کلید صحیح را دریافت کرده‌اید.
.IP \[bu] 2
کد منبع این صفحه در
GitHub (https://github.com/rclone/rclone/blob/master/docs/content/release_signing.md).
.IP \[bu] 2
از طریق DNS با دستور \f[V]dig key.rclone.org txt\f[R]
.PP
اگر هر موردی یافتید که مطابقت نداشت، لطفاً بلافاصله با توسعه‌دهندگان تماس بگیرید..SS نحوه تأیید اصالت انتشار
.PP
در دایرکتوری انتشار، فایل‌های مربوط به انتشار و فایل‌هایی با نام‌های \f[V]MD5SUMS\f[R]، \f[V]SHA1SUMS\f[R] و \f[V]SHA256SUMS\f[R] را مشاهده خواهید کرد.
.IP
.nf
\f[C]
$ rclone lsf --http-url https://downloads.rclone.org/v1.63.1 :http:
MD5SUMS
SHA1SUMS
SHA256SUMS
rclone-v1.63.1-freebsd-386.zip
rclone-v1.63.1-freebsd-amd64.zip
\&...
rclone-v1.63.1-windows-arm64.zip
rclone-v1.63.1.tar.gz
version.txt
\f[R]
.fi
.PP
فایل‌های \f[V]MD5SUMS\f[R]، \f[V]SHA1SUMS\f[R] و \f[V]SHA256SUMS\f[R] حاوی هش‌های فایل‌های دودویی موجود در دایرکتوری انتشار به همراه یک امضا هستند.
.PP
برای مثال:
.IP
.nf
\f[C]
$ rclone cat --http-url https://downloads.rclone.org/v1.63.1 :http:SHA256SUMS
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

f6d1b2d7477475ce681bdce8cb56f7870f174cb6b2a9ac5d7b3764296ea4a113  rclone-v1.63.1-freebsd-386.zip
7266febec1f01a25d6575de51c44ddf749071a4950a6384e4164954dff7ac37e  rclone-v1.63.1-freebsd-amd64.zip
\&...
66ca083757fb22198309b73879831ed2b42309892394bf193ff95c75dff69c73  rclone-v1.63.1-windows-amd64.zip
bbb47c16882b6c5f2e8c1b04229378e28f68734c613321ef0ea2263760f74cd0  rclone-v1.63.1-windows-arm64.zip
-----BEGIN PGP SIGNATURE-----

iF0EARECAB0WIQT79zfs6firGGBL0qyTk14C/ztU+gUCZLVKJQAKCRCTk14C/ztU
+pZuAJ0XJ+QWLP/3jCtkmgcgc4KAwd/rrwCcCRZQ7E+oye1FPY46HOVzCFU3L7g=
=8qrL
-----END PGP SIGNATURE-----
\f[R]
.fi
.SS بارگیری فایل‌ها
.PP
گام نخست، بارگیری فایل دودویی و فایل SUMs و بررسی تطابق مقادیر آن‌ها است.
در اینجا ما \f[V]rclone-v1.63.1-windows-amd64.zip\f[R] را بارگیری می‌کنیم \- فایل دودویی (یا فایل‌های دودویی) مناسب برای معماری سیستم خود را انتخاب کنید.
ما همچنین \f[V]SHA256SUMS\f[R] را انتخاب کرده‌ایم چرا که بیشترین امنیت را فراهم می‌کند.
برای امنیت بیشتر می‌توانید انواع دیگر هش را نیز بررسی و تأیید کنید.
دستور \f[V]rclone selfupdate\f[R] صرفاً فایل \f[V]SHA256SUMS\f[R] را اعتبارسنجی می‌کند.
.IP
.nf
\f[C]
mkdir /tmp/check
cd /tmp/check
rclone copy --http-url https://downloads.rclone.org/v1.63.1 :http:SHA256SUMS .
rclone copy --http-url https://downloads.rclone.org/v1.63.1 :http:rclone-v1.63.1-windows-amd64.zip .
\f[R]
.fi
.SS تأیید امضاها
.PP
ابتدا امضاهای موجود روی فایل SHA256 را تأیید کنید.
.PP
کلید را وارد (import) کنید.
برای روش‌های تأیید صحت این کلید، به بخش‌های بالا مراجعه کنید.
.IP
.nf
\f[C]
$ gpg --keyserver keyserver.ubuntu.com --receive-keys FBF737ECE9F8AB18604BD2AC93935E02FF3B54FA
gpg: key 93935E02FF3B54FA: public key \[dq]Nick Craig-Wood <nick\[at]craig-wood.com>\[dq] imported
gpg: Total number processed: 1
gpg:               imported: 1
\f[R]
.fi
.PP
سپس امضا را بررسی کنید:
.IP
.nf
\f[C]
$ gpg --verify SHA256SUMS 
gpg: Signature made Mon 17 Jul 2023 15:03:17 BST
gpg:                using DSA key FBF737ECE9F8AB18604BD2AC93935E02FF3B54FA
gpg: Good signature from \[dq]Nick Craig-Wood <nick\[at]craig-wood.com>\[dq] [ultimate]
\f[R]
.fi
.PP
بررسی کنید که امضا معتبر بوده و از اثر انگشت (fingerprint) نشان‌داده‌شده در بالا استفاده می‌کند.
.PP
در صورت تمایل، این مراحل را برای \f[V]MD5SUMS\f[R] و \f[V]SHA1SUMS\f[R] تکرار کنید..SS اعتبارسنجی هش‌ها
.PP
اکنون که می‌دانیم امضاهای روی هش‌ها معتبر هستند، می‌توانیم تطابق فایل‌های باینری با هش‌ها را بررسی کرده و فرایند اعتبارسنجی را کامل کنیم.
.IP
.nf
\f[C]
$ sha256sum -c SHA256SUMS 2>&1 | grep OK
rclone-v1.63.1-windows-amd64.zip: OK
\f[R]
.fi
.PP
یا بررسی را با rclone انجام دهید
.IP
.nf
\f[C]
$ rclone hashsum sha256 -C SHA256SUMS rclone-v1.63.1-windows-amd64.zip 
2023/09/11 10:53:58 NOTICE: SHA256SUMS: improperly formatted checksum line 0
2023/09/11 10:53:58 NOTICE: SHA256SUMS: improperly formatted checksum line 1
2023/09/11 10:53:58 NOTICE: SHA256SUMS: improperly formatted checksum line 49
2023/09/11 10:53:58 NOTICE: SHA256SUMS: 4 warning(s) suppressed...
= rclone-v1.63.1-windows-amd64.zip
2023/09/11 10:53:58 NOTICE: Local file system at /tmp/check: 0 differences found
2023/09/11 10:53:58 NOTICE: Local file system at /tmp/check: 1 matching files
\f[R]
.fi
.SS اعتبارسنجی هم‌زمان امضاها و هش‌ها
.PP
می‌توانید امضاها و هش‌ها را در یک خط فرمان مانند زیر اعتبارسنجی کنید:
.IP
.nf
\f[C]
$ h=$(gpg --decrypt SHA256SUMS) && echo \[dq]$h\[dq] | sha256sum - -c --ignore-missing
gpg: Signature made Mon 17 Jul 2023 15:03:17 BST
gpg:                using DSA key FBF737ECE9F8AB18604BD2AC93935E02FF3B54FA
gpg: Good signature from \[dq]Nick Craig-Wood <nick\[at]craig-wood.com>\[dq] [ultimate]
gpg:                 aka \[dq]Nick Craig-Wood <nick\[at]memset.com>\[dq] [unknown]
rclone-v1.63.1-windows-amd64.zip: OK
\f[R]
.fi
.SH 1Fichier
.PP
این یک بک‌اند برای سرویس ذخیره‌سازی ابری 1fichier (https://1fichier.com) است.
توجه داشته باشید که برای استفاده از API، اشتراک Premium الزامی است.
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند به هر میزان عمقی که نیاز است باشند، برای نمونه
\f[V]remote:directory/subdirectory\f[R].
.SS پیکربندی
.PP
راه‌اندازی اولیه برای 1Fichier شامل دریافت کلید API از وب‌سایت است که باید آن را در مرورگر خود انجام دهید.
.PP
در اینجا مثالی از نحوهٔ ایجاد یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / 1Fichier
   \[rs] \[dq]fichier\[dq]
[snip]
Storage> fichier
** See help for fichier backend at: https://rclone.org/fichier **

Your API Key, get it from https://1fichier.com/console/params.pl
Enter a string value. Press Enter for the default (\[dq]\[dq]).
api_key> example_key

Edit advanced config? (y/n)
y) Yes
n) No
y/n> 
Remote config
Configuration complete.
Options:
- type: fichier
- api_key: example_key
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (عبارت
\f[V]remote\f[R] را با نامی که برای ریموت خود انتخاب کرده‌اید جایگزین کنید):
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح حساب 1Fichier شما
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در حساب 1Fichier شما
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به دایرکتوری‌ای به نام backup در 1Fichier
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها (Modification times and hashes)
.PP
1Fichier از زمان‌های تغییر پشتیبانی نمی‌کند.
این سرویس از الگوریتم هش Whirlpool پشتیبانی می‌کند.
.SS فایل‌های تکراری (Duplicated files)
.PP
1Fichier (برخلاف یک سیستم‌فایل معمولی) می‌تواند دو فایل با نام و مسیر کاملاً یکسان داشته باشد.
.PP
فایل‌های تکراری باعث بروز مشکل در همگام‌سازی می‌شوند و پیام‌هایی درباره موارد تکراری در لاگ (log) مشاهده خواهید کرد.
.SS نویسه‌های محدودشده در نام فایل (Restricted filename characters)
.PP
علاوه بر مجموعه نویسه‌های محدودشده پیش‌فرض (https://rclone.org/overview/#restricted-characters)، نویسه‌های زیر نیز جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
T{
<
T}@T{
0x3C
T}@T{
＜
T}
T{
>
T}@T{
0x3E
T}@T{
＞
T}
T{
\[dq]
T}@T{
0x22
T}@T{
＂
T}
T{
$
T}@T{
0x24
T}@T{
＄
T}
T{
\[ga]
T}@T{
0x60
T}@T{
｀
T}
T{
\[aq]
T}@T{
0x27
T}@T{
＇
T}
.TE
.PP
نام فایل‌ها همچنین نمی‌تواند با نویسه‌های زیر شروع شده یا پایان یابد.
این نویسه‌ها تنها در صورتی جایگزین می‌شوند که اولین یا آخرین نویسه در نام باشند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
SP
T}@T{
0x20
T}@T{
␠
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند شد (https://rclone.org/overview/#invalid-utf8)، چرا که امکان استفاده از آن‌ها در رشته‌های JSON وجود ندارد..SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد ویژه fichier (1Fichier) آمده است.
.SS --fichier-api-key
.PP
کلید API شما؛ آن را از https://1fichier.com/console/params.pl دریافت کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: api_key
.IP \[bu] 2
متغیر محیطی: RCLONE_FICHIER_API_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته ویژه fichier (1Fichier) آمده است.
.SS --fichier-shared-folder
.PP
اگر می‌خواهید یک پوشه هم‌رسانی‌شده را بارگیری کنید، این پارامتر را اضافه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: shared_folder
.IP \[bu] 2
متغیر محیطی: RCLONE_FICHIER_SHARED_FOLDER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --fichier-file-password
.PP
اگر می‌خواهید یک فایل هم‌رسانی‌شده دارای گذرواژه را بارگیری کنید، این پارامتر را
اضافه کنید.
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی شود - دستور rclone
obscure (https://rclone.org/commands/rclone_obscure) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: file_password
.IP \[bu] 2
متغیر محیطی: RCLONE_FICHIER_FILE_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --fichier-folder-password
.PP
اگر می‌خواهید فایل‌های درون یک پوشه هم‌رسانی‌شده دارای گذرواژه را
فهرست کنید، این پارامتر را اضافه کنید.
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی شود - دستور rclone
obscure (https://rclone.org/commands/rclone_obscure) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: folder_password
.IP \[bu] 2
متغیر محیطی: RCLONE_FICHIER_FOLDER_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --fichier-cdn
.PP
اگر مایلید از پیوندهای بارگیری CDN استفاده کنید، این گزینه را تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: cdn
.IP \[bu] 2
متغیر محیطی: RCLONE_FICHIER_CDN
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --fichier-encoding
.PP
کدگذاری برای后端 (Backend).
.PP
برای اطلاعات بیشتر بخش encoding را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_FICHIER_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,LtGt,DoubleQuote,SingleQuote,BackQuote,Dollar,BackSlash,Del,Ctl,LeftSpace,RightSpace,InvalidUtf8,Dot.SS --fichier-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_FICHIER_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS "محدودیت‌ها (Limitations)"
.PP
دستور \f[V]rclone about\f[R] توسط بک‌اند 1Fichier پشتیبانی نمی‌شود.
بک‌اندهایی که این قابلیت را ندارند، نمی‌توانند فضای خالی را برای یک rclone mount تعیین کنند یا از سیاست \f[V]mfs\f[R] (بیشترین فضای خالی) به‌عنوان عضوی از یک ریموت union در rclone استفاده نمایند.
.PP
فهرست بک‌اندهایی که از rclone about پشتیبانی نمی‌کنند (https://rclone.org/overview/#optional-features) و rclone about (https://rclone.org/commands/rclone_about) را ببینید.
.SH "نام مستعار (Alias)"
.PP
ریموت \f[V]alias\f[R] نام جدیدی را برای ریموتی دیگر فراهم می‌کند.
.PP
مسیرها می‌توانند به هر عمق دلخواهی باشند یا یک مسیر محلی باشند؛ مانند
\f[V]remote:directory/subdirectory\f[R] یا
\f[V]/directory/subdirectory\f[R].
.PP
در طول راه‌اندازی اولیه با \f[V]rclone config\f[R]، ریموت مقصد را مشخص خواهید کرد.
ریموت مقصد می‌تواند یک مسیر محلی یا ریموت دیگری باشد.
.PP
می‌توان از زیرپوشه‌ها در ریموت مقصد استفاده کرد.
فرض کنید یک ریموت نام مستعار به نام \f[V]backup\f[R] با مقصد
\f[V]mydrive:private/backup\f[R] وجود دارد.
فراخوانی \f[V]rclone mkdir backup:desktop\f[R] دقیقاً معادل
فراخوانی \f[V]rclone mkdir mydrive:private/backup/desktop\f[R] است.
.PP
هیچ پردازش خاصی برای مسیرهای حاوی بخش‌های \f[V]..\f[R] صورت نخواهد گرفت.
فراخوانی \f[V]rclone mkdir backup:../desktop\f[R] دقیقاً معادل
فراخوانی \f[V]rclone mkdir mydrive:private/backup/../desktop\f[R] است.
مسیر خالی به عنوان یک ریموت مجاز نیست.
برای ایجاد نام مستعار برای دایرکتوری جاری، به جای آن از \f[V].\f[R] استفاده کنید.
.PP
ریموت مقصد همچنین می‌تواند یک رشته اتصال
(https://rclone.org/docs/#connection-strings) باشد.
این قابلیت می‌تواند برای اصلاح پیکربندی یک ریموت برای کاربردهای گوناگون به کار رود؛
به عنوان مثال نام مستعار \f[V]myDriveTrash\f[R] با ریموت مقصد
\f[V]myDrive,trashed_only:\f[R] می‌تواند تنها برای نمایش فایل‌های موجود در سطل زباله
در \f[V]myDrive\f[R] استفاده شود.
.SS "پیکربندی (Configuration)"
.PP
در اینجا مثالی از نحوه ایجاد یک نام مستعار به نام \f[V]remote\f[R] برای یک
پوشه محلی آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Alias for an existing remote
   \[rs] \[dq]alias\[dq]
[snip]
Storage> alias
Remote or path to alias.
Can be \[dq]myremote:path/to/dir\[dq], \[dq]myremote:bucket\[dq], \[dq]myremote:\[dq] or \[dq]/local/path\[dq].
remote> /mnt/storage/backup
Remote config
Configuration complete.
Options:
- type: alias
- remote: /mnt/storage/backup
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
Current remotes:

Name                 Type
====                 ====
remote               alias

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> q
\f[R]
.fi
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (به جای
\f[V]remote\f[R] نامی را که به ریموت خود اختصاص داده‌اید جایگزین کنید):
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح \f[V]/mnt/storage/backup\f[R]
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در \f[V]/mnt/storage/backup\f[R]
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
کپی کردن یک دایرکتوری محلی دیگر در دایرکتوری نام مستعار به نام source
.IP
.nf
\f[C]
rclone copy /home/source remote:source
\f[R]
.fi.SS "گزینه‌های استاندارد"
.PP
در اینجا گزینه‌های استاندارد مختص alias (نام مستعار برای یک ریموت موجود)
آمده است.
.SS --alias-remote
.PP
ریموت یا مسیری که قرار است برای آن نام مستعار ایجاد شود.
.PP
می‌تواند \[dq]myremote:path/to/dir\[dq]، \[dq]myremote:bucket\[dq]،
\[dq]myremote:\[dq] یا \[dq]/local/path\[dq] باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: remote
.IP \[bu] 2
متغیر محیطی: RCLONE_ALIAS_REMOTE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: true
.SS "گزینه‌های پیشرفته"
.PP
در اینجا گزینه‌های پیشرفتهٔ مختص alias (نام مستعار برای یک ریموت
موجود) آمده است.
.SS --alias-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_ALIAS_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SH "ارائه‌دهندگان فضای ذخیره‌سازی Amazon S3 (Amazon S3 Storage Providers)"
.PP
بک‌اند S3 می‌تواند با چندین ارائه‌دهندهٔ مختلف استفاده شود:
.IP \[bu] 2
AWS S3
.IP \[bu] 2
Alibaba Cloud (Aliyun) Object Storage System (OSS)
.IP \[bu] 2
Ceph
.IP \[bu] 2
China Mobile Ecloud Elastic Object Storage (EOS)
.IP \[bu] 2
Cloudflare R2
.IP \[bu] 2
Arvan Cloud Object Storage (AOS)
.IP \[bu] 2
Bizfly Cloud Simple Storage
.IP \[bu] 2
Cubbit DS3
.IP \[bu] 2
DigitalOcean Spaces
.IP \[bu] 2
Dreamhost
.IP \[bu] 2
Exaba
.IP \[bu] 2
Fastly Object Storage
.IP \[bu] 2
FileLu S5 (S3-Compatible Object Storage)
.IP \[bu] 2
GCS
.IP \[bu] 2
Hetzner
.IP \[bu] 2
Hitachi Content Platform (HCP)
.IP \[bu] 2
Huawei OBS
.IP \[bu] 2
IBM COS S3
.IP \[bu] 2
IDrive e2
.IP \[bu] 2
Impossible Cloud
.IP \[bu] 2
Intercolo Object Storage
.IP \[bu] 2
IONOS Cloud
.IP \[bu] 2
Leviia Object Storage
.IP \[bu] 2
Liara Object Storage
.IP \[bu] 2
Linode Object Storage
.IP \[bu] 2
Magalu Object Storage
.IP \[bu] 2
MEGA S4 Object Storage
.IP \[bu] 2
Minio
.IP \[bu] 2
Outscale
.IP \[bu] 2
OVHcloud
.IP \[bu] 2
Petabox
.IP \[bu] 2
Pure Storage FlashBlade
.IP \[bu] 2
Qiniu Cloud Object Storage (Kodo)
.IP \[bu] 2
Rabata Cloud Storage
.IP \[bu] 2
RackCorp Object Storage
.IP \[bu] 2
Rclone Serve S3
.IP \[bu] 2
Scaleway
.IP \[bu] 2
Scality (RING / ARTESCA)
.IP \[bu] 2
Seagate Lyve Cloud
.IP \[bu] 2
SeaweedFS
.IP \[bu] 2
Selectel
.IP \[bu] 2
Servercore Object Storage
.IP \[bu] 2
Spectra Logic
.IP \[bu] 2
Storj
.IP \[bu] 2
Synology C2 Object Storage
.IP \[bu] 2
Tencent Cloud Object Storage (COS)
.IP \[bu] 2
US3
.IP \[bu] 2
Wasabi
.IP \[bu] 2
Zadara Object Storage
.IP \[bu] 2
Zata
.IP \[bu] 2
Zero Services (ZERO-Z3)
.PP
مسیرها به‌صورت \f[V]remote:bucket\f[R] (یا \f[V]remote:\f[R] برای دستور
\f[V]lsd\f[R]) مشخص می‌شوند.
همچنین می‌توانید زیرپوشه‌ها را نیز مشخص کنید، مانند:
\f[V]remote:bucket/path/to/dir\f[R].
.PP
پس از ایجاد یک ریموت (بخش مربوط به ارائه‌دهندهٔ خاص در بالا را ببینید)،
می‌توانید از آن به‌شکل زیر استفاده کنید:
.PP
مشاهدهٔ تمام باکت‌ها
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
ایجاد یک باکت جدید
.IP
.nf
\f[C]
rclone mkdir remote:bucket
\f[R]
.fi
.PP
فهرست کردن محتویات یک باکت
.IP
.nf
\f[C]
rclone ls remote:bucket
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با باکت ریموت و حذف هرگونه
فایل اضافی موجود در باکت.
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory remote:bucket
\f[R]
.fi.SS "پیکربندی (Configuration)"
.PP
در اینجا نمونه‌ای از ایجاد یک پیکربندی s3 برای ارائه‌دهنده AWS S3 آورده شده است.
بیشتر این موارد برای سایر ارائه‌دهندگان نیز صدق می‌کند و هرگونه تفاوت در ادامه شرح داده شده است.
.PP
ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] \[dq]s3\[dq]
[snip]
Storage> s3
Choose your S3 provider.
Choose a number from below, or type in your own value
 1 / Amazon Web Services (AWS) S3
   \[rs] \[dq]AWS\[dq]
 2 / Ceph Object Storage
   \[rs] \[dq]Ceph\[dq]
 3 / DigitalOcean Spaces
   \[rs] \[dq]DigitalOcean\[dq]
 4 / Dreamhost DreamObjects
   \[rs] \[dq]Dreamhost\[dq]
 5 / IBM COS S3
   \[rs] \[dq]IBMCOS\[dq]
 6 / Minio Object Storage
   \[rs] \[dq]Minio\[dq]
 7 / Wasabi Object Storage
   \[rs] \[dq]Wasabi\[dq]
 8 / Any other S3 compatible provider
   \[rs] \[dq]Other\[dq]
provider> 1
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars). Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own value
 1 / Enter AWS credentials in the next step
   \[rs] \[dq]false\[dq]
 2 / Get AWS credentials from the environment (env vars or IAM)
   \[rs] \[dq]true\[dq]
env_auth> 1
AWS Access Key ID - leave blank for anonymous access or runtime credentials.
access_key_id> XXX
AWS Secret Access Key (password) - leave blank for anonymous access or runtime credentials.
secret_access_key> YYY
Region to connect to.
Choose a number from below, or type in your own value
   / The default endpoint - a good choice if you are unsure.
 1 | US Region, Northern Virginia, or Pacific Northwest.
   | Leave location constraint empty.
   \[rs] \[dq]us-east-1\[dq]
   / US East (Ohio) Region
 2 | Needs location constraint us-east-2.
   \[rs] \[dq]us-east-2\[dq]
   / US West (Oregon) Region
 3 | Needs location constraint us-west-2.
   \[rs] \[dq]us-west-2\[dq]
   / US West (Northern California) Region
 4 | Needs location constraint us-west-1.
   \[rs] \[dq]us-west-1\[dq]
   / Canada (Central) Region
 5 | Needs location constraint ca-central-1.
   \[rs] \[dq]ca-central-1\[dq]
   / EU (Ireland) Region
 6 | Needs location constraint EU or eu-west-1.
   \[rs] \[dq]eu-west-1\[dq]
   / EU (London) Region
 7 | Needs location constraint eu-west-2.
   \[rs] \[dq]eu-west-2\[dq]
   / EU (Frankfurt) Region
 8 | Needs location constraint eu-central-1.
   \[rs] \[dq]eu-central-1\[dq]
   / Asia Pacific (Singapore) Region
 9 | Needs location constraint ap-southeast-1.
   \[rs] \[dq]ap-southeast-1\[dq]
   / Asia Pacific (Sydney) Region
10 | Needs location constraint ap-southeast-2.
   \[rs] \[dq]ap-southeast-2\[dq]
   / Asia Pacific (Tokyo) Region
11 | Needs location constraint ap-northeast-1.
   \[rs] \[dq]ap-northeast-1\[dq]
   / Asia Pacific (Seoul)
12 | Needs location constraint ap-northeast-2.
   \[rs] \[dq]ap-northeast-2\[dq]
   / Asia Pacific (Mumbai)
13 | Needs location constraint ap-south-1.
   \[rs] \[dq]ap-south-1\[dq]
   / Asia Pacific (Hong Kong) Region
14 | Needs location constraint ap-east-1.
   \[rs] \[dq]ap-east-1\[dq]
   / South America (Sao Paulo) Region
15 | Needs location constraint sa-east-1.
   \[rs] \[dq]sa-east-1\[dq]
region> 1
Endpoint for S3 API.
Leave blank if using AWS to use the default endpoint for the region.
endpoint>
Location constraint - must be set to match the Region. Used when creating buckets only.
Choose a number from below, or type in your own value
 1 / Empty for US Region, Northern Virginia, or Pacific Northwest.
   \[rs] \[dq]\[dq]
 2 / US East (Ohio) Region.
   \[rs] \[dq]us-east-2\[dq]
 3 / US West (Oregon) Region.
   \[rs] \[dq]us-west-2\[dq]
 4 / US West (Northern California) Region.
   \[rs] \[dq]us-west-1\[dq]
 5 / Canada (Central) Region.
   \[rs] \[dq]ca-central-1\[dq]
 6 / EU (Ireland) Region.
   \[rs] \[dq]eu-west-1\[dq]
 7 / EU (London) Region.
   \[rs] \[dq]eu-west-2\[dq]
 8 / EU Region.
   \[rs] \[dq]EU\[dq]
 9 / Asia Pacific (Singapore) Region.
   \[rs] \[dq]ap-southeast-1\[dq]
10 / Asia Pacific (Sydney) Region.
   \[rs] \[dq]ap-southeast-2\[dq]
11 / Asia Pacific (Tokyo) Region.
   \[rs] \[dq]ap-northeast-1\[dq]
12 / Asia Pacific (Seoul)
   \[rs] \[dq]ap-northeast-2\[dq]
13 / Asia Pacific (Mumbai)
   \[rs] \[dq]ap-south-1\[dq]
14 / Asia Pacific (Hong Kong)
   \[rs] \[dq]ap-east-1\[dq]
15 / South America (Sao Paulo) Region.
   \[rs] \[dq]sa-east-1\[dq]
location_constraint> 1
Canned ACL used when creating buckets and/or storing objects in S3.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Choose a number from below, or type in your own value
 1 / Owner gets FULL_CONTROL. No one else has access rights (default).
   \[rs] \[dq]private\[dq]
 2 / Owner gets FULL_CONTROL. The AllUsers group gets READ access.
   \[rs] \[dq]public-read\[dq]
   / Owner gets FULL_CONTROL. The AllUsers group gets READ and WRITE access.
 3 | Granting this on a bucket is generally not recommended.
   \[rs] \[dq]public-read-write\[dq]
 4 / Owner gets FULL_CONTROL. The AuthenticatedUsers group gets READ access.
   \[rs] \[dq]authenticated-read\[dq]
   / Object owner gets FULL_CONTROL. Bucket owner gets READ access.
 5 | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.
   \[rs] \[dq]bucket-owner-read\[dq]
   / Both the object owner and the bucket owner get FULL_CONTROL over the object.
 6 | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.
   \[rs] \[dq]bucket-owner-full-control\[dq]
acl> 1
The server-side encryption algorithm used when storing this object in S3.
Choose a number from below, or type in your own value
 1 / None
   \[rs] \[dq]\[dq]
 2 / AES256
   \[rs] \[dq]AES256\[dq]
server_side_encryption> 1
The storage class to use when storing objects in S3.
Choose a number from below, or type in your own value
 1 / Default
   \[rs] \[dq]\[dq]
 2 / Standard storage class
   \[rs] \[dq]STANDARD\[dq]
 3 / Reduced redundancy storage class
   \[rs] \[dq]REDUCED_REDUNDANCY\[dq]
 4 / Standard Infrequent Access storage class
   \[rs] \[dq]STANDARD_IA\[dq]
 5 / One Zone Infrequent Access storage class
   \[rs] \[dq]ONEZONE_IA\[dq]
 6 / Glacier Flexible Retrieval storage class
   \[rs] \[dq]GLACIER\[dq]
 7 / Glacier Deep Archive storage class
   \[rs] \[dq]DEEP_ARCHIVE\[dq]
 8 / Intelligent-Tiering storage class
   \[rs] \[dq]INTELLIGENT_TIERING\[dq]
 9 / Glacier Instant Retrieval storage class
   \[rs] \[dq]GLACIER_IR\[dq]
storage_class> 1
Remote config
Configuration complete.
Options:
- type: s3
- provider: AWS
- env_auth: false
- access_key_id: XXX
- secret_access_key: YYY
- region: us-east-1
- endpoint:
- location_constraint:
- acl: private
- server_side_encryption:
- storage_class:
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d>
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها
.SS زمان‌های تغییر
.PP
زمان تغییر به عنوان متاداده روی شیء در قالب
\f[V]X-Amz-Meta-Mtime\f[R] به صورت عدد ممیز شناور از مبدا زمان (epoch)، با دقت
۱ نانوثانیه ذخیره می‌شود.
.PP
اگر زمان تغییر نیاز به به‌روزرسانی داشته باشد، در صورتی که شیء بتواند در
یک بخش کپی شود، rclone تلاش خواهد کرد یک کپی سمت سرور برای به‌روزرسانی زمان
تغییر انجام دهد.
در صورتی که شیء بزرگ‌تر از 5Gb باشد یا در فضای ذخیره‌سازی Glacier یا Glacier
Deep Archive قرار داشته باشد، شیء به جای کپی شدن، بارگذاری خواهد شد.
.PP
توجه داشته باشید که خواندن این مقدار از شیء نیازمند یک درخواست اضافی
\f[V]HEAD\f[R] است، چرا که این متاداده در فهرست‌های شیء بازگردانده نمی‌شود.
.SS هش‌ها
.PP
برای شیء‌های کوچکی که به صورت چندبخشی بارگذاری نشده‌اند (شیء‌هایی با اندازه
کمتر از \f[V]--s3-upload-cutoff\f[R] در صورت بارگذاری با rclone)،
ابزار rclone از هدر \f[V]ETag:\f[R] به عنوان چکسام MD5 استفاده می‌کند.
.PP
با این حال برای شیء‌هایی که به صورت چندبخشی بارگذاری شده‌اند یا دارای رمزنگاری
سمت سرور (SSE-AWS یا SSE-C) هستند، هدر \f[V]ETag\f[R] دیگر هش MD5 داده‌ها
نیست؛ بنابراین rclone یک متاداده اضافی به نام
\f[V]X-Amz-Meta-Md5chksum\f[R] اضافه می‌کند که یک هش MD5 انکودشده با base64
است (در همان قالبی که برای \f[V]Content-MD5\f[R] لازم است).
می‌توانید از base64 -d و hexdump برای بررسی دستی این مقدار استفاده کنید:
.IP
.nf
\f[C]
echo \[aq]VWTGdNx3LyXQDfA0e2Edxw==\[aq] | base64 -d | hexdump
\f[R]
.fi
.PP
یا می‌توانید از دستور \f[V]rclone check\f[R] برای اطمینان از صحت هش‌ها استفاده کنید.
.PP
برای شیء‌های بزرگ، محاسبه این هش ممکن است زمان‌بر باشد، بنابراین افزودن این
هش را می‌توان با \f[V]--s3-disable-checksum\f[R] غیرفعال کرد.
این کار بدین معنا خواهد بود که این شیء‌ها چکسام MD5 ندارند.
.PP
توجه داشته باشید که خواندن این مقدار از شیء نیازمند یک درخواست اضافی
\f[V]HEAD\f[R] است، چرا که این متاداده در فهرست‌های شیء بازگردانده نمی‌شود.
.SS کاهش هزینه‌ها
.SS پرهیز از درخواست‌های HEAD برای خواندن زمان تغییر
.PP
به طور پیش‌فرض، rclone از زمان تغییر شیء‌های ذخیره‌شده در S3 برای همگام‌سازی
استفاده می‌کند.
این مقدار در متاداده شیء ذخیره می‌شود که متأسفانه خواندن آن نیازمند یک
درخواست اضافی HEAD است که می‌تواند هزینه‌بر باشد (از نظر زمان و هزینه مالی).
.PP
زمان تغییر به طور پیش‌فرض برای تمامی عملیاتی که نیازمند بررسی زمان آخرین
به‌روزرسانی فایل هستند استفاده می‌شود.
این قابلیت به rclone اجازه می‌دهد با ریموت بیشتر مانند یک فایل‌سیستم واقعی رفتار
کند، اما در S3 ناکارآمد است زیرا برای دریافت متاداده نیازمند یک فراخوانی اضافی API است.
.PP
می‌توان هنگام همگام‌سازی (با استفاده از \f[V]rclone sync\f[R] یا
\f[V]rclone copy\f[R]) به چند روش مختلف از فراخوانی‌های اضافی API پرهیز کرد
که هر کدام مزایا و معایب خود را دارند.
.IP \[bu] 2
\f[V]--size-only\f[R]
.RS 2
.IP \[bu] 2
فقط اندازه فایل‌ها را بررسی می‌کند.
.IP \[bu] 2
از هیچ تراکنش اضافی استفاده نمی‌کند.
.IP \[bu] 2
اگر اندازه فایل تغییر نکند، rclone متوجه تغییر آن نخواهد شد.
.IP \[bu] 2
\f[V]rclone sync --size-only /path/to/source s3:bucket\f[R]
.RE
.IP \[bu] 2
\f[V]--checksum\f[R]
.RS 2
.IP \[bu] 2
اندازه و چکسام MD5 فایل‌ها را بررسی می‌کند.
.IP \[bu] 2
از هیچ تراکنش اضافی استفاده نمی‌کند.
.IP \[bu] 2
دقیق‌ترین روش ممکن برای تشخیص تغییرات است.
.IP \[bu] 2
باعث می‌شود مبدأ یک چکسام MD5 را بخواند که اگر دیسک محلی باشد، فعالیت دیسکی زیادی ایجاد خواهد کرد.
.IP \[bu] 2
اگر مبدأ و مقصد هر دو S3 باشند، این گزینه برای حداکثر کارایی \f[B]توصیه‌شده\f[R] است.
.IP \[bu] 2
\f[V]rclone sync --checksum /path/to/source s3:bucket\f[R]
.RE
.IP \[bu] 2
\f[V]--update --use-server-modtime\f[R]
.RS 2
.IP \[bu] 2
از هیچ تراکنش اضافی استفاده نمی‌کند.
.IP \[bu] 2
زمان تغییر برابر با زمان بارگذاری شیء می‌شود.
.IP \[bu] 2
برای بسیاری از عملیات‌ها، این مقدار جهت تشخیص نیاز به بارگذاری کافی است.
.IP \[bu] 2
استفاده از \f[V]--update\f[R] همراه با \f[V]--use-server-modtime\f[R]،
از فراخوانی‌های اضافی API جلوگیری کرده و فایل‌هایی را که زمان تغییر محلی آن‌ها
جدیدتر از زمان آخرین بارگذاری است آپلود می‌کند.
.IP \[bu] 2
فایل‌هایی که با برچسب زمانی در گذشته ایجاد شده‌اند توسط همگام‌سازی نادیده گرفته خواهند شد.
.IP \[bu] 2
\f[V]rclone sync --update --use-server-modtime /path/to/source s3:bucket\f[R]
.RE
.PP
این گزینه‌ها می‌توانند و باید در ترکیب با \f[V]--fast-list\f[R] استفاده شوند \- به پایین مراجعه کنید.
.PP
اگر از \f[V]rclone mount\f[R] یا هر دستوری که از VFS استفاده می‌کند (مانند
\f[V]rclone serve\f[R]) استفاده می‌کنید، ممکن است بخواهید استفاده از گزینه
VFS به نام \f[V]--no-modtime\f[R] را در نظر بگیرید که مانع از خواندن زمان
تغییر برای هر شیء توسط rclone می‌شود.
همچنین در صورتی که مشکلی ندارید زمان تغییر شیء‌ها همان زمان بارگذاری باشد،
می‌توانید از \f[V]--use-server-modtime\f[R] استفاده کنید..SS اجتناب از درخواست‌های GET برای خواندن فهرست دایرکتوری‌ها
.PP
پیمایش پیش‌فرض دایرکتوری در rclone پردازش جداگانهٔ هر دایرکتوری است.
این کار به ازای هر دایرکتوری یک فراخوانی API انجام می‌دهد.
استفاده از پرچم \f[V]--fast-list\f[R] باعث می‌شود ابتدا تمام اطلاعات مربوط به
اشیاء با تعداد کمتری فراخوانی API (یک فراخوانی به ازای هر ۱۰۰۰ شیء) درون حافظه خوانده شود.
برای جزئیات بیشتر به مستندات rclone (https://rclone.org/docs/#fast-list) مراجعه کنید.
.IP
.nf
\f[C]
rclone sync --fast-list --checksum /path/to/source s3:bucket
\f[R]
.fi
.PP
پرچم \f[V]--fast-list\f[R] تعداد تراکنش‌های API را در ازای مصرف حافظه کاهش می‌دهد.
به عنوان یک برآورد تقریبی، rclone به ازای هر شیء ذخیره‌شده ۱ کیلوبایت حافظه مصرف می‌کند؛
بنابراین استفاده از \f[V]--fast-list\f[R] در همگام‌سازی یک میلیون شیء، تقریباً ۱
گیبی‌بایت از حافظهٔ رم (RAM) را استفاده خواهد کرد.
.PP
اگر تنها تعداد کمی فایل را درون یک مخزن بزرگ کپی می‌کنید،
استفاده از \f[V]--no-traverse\f[R] ایدهٔ مناسبی است.
این گزینه اشیاء را مستقیماً و به جای فهرست‌بندی دایرکتوری‌ها پیدا می‌کند.
می‌توانید با استفاده از \f[V]--max-age\f[R] و \f[V]--no-traverse\f[R]،
یک همگام‌سازی \[dq]تکمیلی\[dq] بسیار کم‌هزینه را تنها برای کپی کردن فایل‌های اخیر انجام دهید، مانند:
.IP
.nf
\f[C]
rclone copy --max-age 24h --no-traverse /path/to/source s3:bucket
\f[R]
.fi
.PP
سپس می‌توانید دستور کامل \f[V]rclone sync\f[R] را با فواصل زمانی طولانی‌تری اجرا کنید.
.PP
توجه داشته باشید که در همگام‌سازی تکمیلی نیازی به \f[V]--fast-list\f[R] نیست.
.SS اجتناب از درخواست‌های HEAD پس از PUT
.PP
به طور پیش‌فرض، rclone برای هر شیئی که بارگذاری می‌کند یک درخواست HEAD ارسال می‌نماید.
این کار برای اطمینان از بارگذاری صحیح شیء انجام می‌شود.
.PP
می‌توانید این قابلیت را با گزینهٔ --s3-no-head غیرفعال کنید - برای جزئیات بیشتر به توضیحات آن مراجعه کنید.
.PP
تنظیم این پرچم احتمال خطاهای شناسایی‌نشده در بارگذاری را افزایش می‌دهد.
.SS افزایش کارایی
.SS استفاده از کپی سمت سرور (server-side copy)
.PP
اگر اشیاء را میان باکت‌های S3 در همان منطقه (region) کپی می‌کنید،
باید از کپی سمت سرور استفاده کنید.
این روش بسیار سریع‌تر از بارگیری و بارگذاری مجدد اشیاء است، زیرا داده‌ای منتقل نمی‌شود.
.PP
برای اینکه rclone از کپی سمت سرور استفاده کند، باید از یک ریموت یکسان برای
مبدأ و مقصد استفاده کنید.
.IP
.nf
\f[C]
rclone copy s3:source-bucket s3:destination-bucket
\f[R]
.fi
.PP
هنگام استفاده از کپی سمت سرور، کارایی بر اساس نرخ ارسال درخواست‌های API از rclone به S3 محدود می‌شود.
برای افزایش تعداد درخواست‌های API که rclone ارسال می‌کند، به ادامه مراجعه فرمایید.
.SS افزایش نرخ درخواست‌های API
.PP
می‌توانید نرخ درخواست‌های API به S3 را با افزایش موازی‌سازی از طریق گزینه‌های
\f[V]--transfers\f[R] و \f[V]--checkers\f[R] بالا ببرید.
.PP
دستور rclone مقادیر پیش‌فرض بسیار محافظه‌کارانه‌ای را برای این تنظیمات استفاده می‌کند،
زیرا همهٔ ارائه‌دهندگان از نرخ‌های بالای درخواست پشتیبانی نمی‌کنند.
بسته به ارائه‌دهندهٔ خود، می‌توانید تعداد transfers و checkers را به میزان چشمگیری افزایش دهید.
.PP
به عنوان مثال، در AWS S3 می‌توانید تعداد checkers را به مقادیری مانند ۲۰۰ افزایش دهید.
اگر در حال انجام کپی سمت سرور هستید، می‌توانید تعداد transfers را نیز تا ۲۰۰ افزایش دهید.
.IP
.nf
\f[C]
rclone sync --transfers 200 --checkers 200 --checksum s3:source-bucket s3:destination-bucket
\f[R]
.fi
.PP
برای یافتن بهینه‌ترین تنظیمات متناسب با پیکربندی خود، نیاز است این مقادیر را آزمایش کنید..SS یکپارچگی داده‌ها
.PP
ابزار rclone تمام تلاش خود را می‌کند تا با استفاده از هش‌های گوناگون، تک‌تک بخش‌های بارگذاری یا بارگیری به ارائه‌دهنده s3 را اعتبارسنجی کند.
.PP
هر تراکنش HTTP به/از ارائه‌دهنده دارای سرآیند \f[V]X-Amz-Content-Sha256\f[R] یا \f[V]Content-Md5\f[R] است تا از خرابی بدنه HTTP جلوگیری کند.
سرآیند HTTP نیز با امضای ارسال‌شده در سرآیند \f[V]Authorization\f[R] محافظت می‌شود.
.PP
تمام ارتباطات با ارائه‌دهنده برای رمزنگاری و حفاظت بیشتر در برابر خطا بر بستر https انجام می‌شود.
.SS بارگذاری‌های تک‌بخشی
.IP \[bu] 2
ابزار rclone بارگذاری‌های تک‌بخشی را با استفاده از هش MD5 خوانده‌شده از مبدأ، همراه با سرآیند \f[V]Content-Md5\f[R] بارگذاری می‌کند.
ارائه‌دهنده پس از دریافت داده‌ها، صحت آن را بررسی می‌کند.
.IP \[bu] 2
سپس rclone یک درخواست HEAD ارسال می‌کند (غیرفعال‌سازی با \f[V]--s3-no-head\f[R]) تا مقدار \f[V]ETag\f[R] بازگردانده‌شده را که همان MD5 فایل است بخواند و آن را با آنچه ارسال کرده تطبیق دهد.
.PP
توجه داشته باشید که اگر مبدأ فاقد هش MD5 باشد، بارگذاری‌های تک‌بخشی فاقد حفاظت از طریق هش خواهند بود.
در این حالت توصیه می‌شود از \f[V]--s3-upload-cutoff 0\f[R] استفاده کنید تا تمام فایل‌ها به‌صورت چندبخشی بارگذاری شوند.
.SS بارگذاری‌های چندبخشی
.PP
برای فایل‌های بزرگ‌تر از \f[V]--s3-upload-cutoff\f[R]، نرم‌افزار rclone فایل را برای بارگذاری به چند بخش تقسیم می‌کند.
.IP \[bu] 2
هر بخش هم با \f[V]X-Amz-Content-Sha256\f[R] و هم با \f[V]Content-Md5\f[R] محافظت می‌شود.
.PP
هنگامی که rclone بارگذاری تمام بخش‌ها را به پایان رساند، با ارسال اطلاعات زیر فرایند بارگذاری را تکمیل می‌کند:
.IP \[bu] 2
هش MD5 هر بخش
.IP \[bu] 2
تعداد بخش‌ها
.IP \[bu] 2
تمامی این اطلاعات با یک \f[V]X-Amz-Content-Sha256\f[R] محافظت می‌شوند.
.PP
ارائه‌دهنده هش MD5 تمام بخش‌های دریافت‌شده را با آنچه rclone ارسال کرده مطابقت می‌دهد و در صورت صحت، وضعیت OK را بازمی‌گرداند.
.PP
سپس rclone یک درخواست HEAD ارسال می‌کند (غیرفعال‌سازی با \f[V]--s3-no-head\f[R]) و بررسی می‌کند که ETag مطابق انتظار باشد (در این حالت باید مجموع هش‌های MD5 تمام بخش‌ها به‌همراه تعداد بخش‌ها در انتهای آن باشد).
.PP
اگر مبدأ دارای مجموع هش MD5 باشد، rclone سرآیند \f[V]X-Amz-Meta-Md5chksum\f[R] را به آن پیوست می‌کند؛ چرا که \f[V]ETag\f[R] برای یک بارگذاری چندبخشی را نمی‌توان به‌سادگی با فایل مقایسه کرد، زیرا محاسبه آن نیازمند دانستن اندازه تکه‌ها (chunk size) است.
.SS بارگیری‌ها
.PP
ابزار rclone هش MD5 داده‌های بارگیری‌شده را با ETag یا فراداده \f[V]X-Amz-Meta-Md5chksum\f[R] (در صورت وجود، که rclone هنگام بارگذاری‌های چندبخشی ارسال می‌کند) بررسی می‌کند.
.SS بررسی‌های تکمیلی
.PP
در هر مرحله، rclone و ارائه‌دهنده در حال ارسال و بررسی هش‌های \f[B]همه‌چیز\f[R] هستند.
ابزار rclone به‌طور عمدی پس از بارگذاری، یک درخواست HEAD برای هر شیء ارسال می‌کند تا جهت امنیت بیشتر اطمینان یابد که داده‌ها بدون نقص دریافت شده‌اند.
(می‌توانید این رفتار را با \f[V]--s3-no-head\f[R] غیرفعال کنید).
.PP
اگر به اطمینان بیشتری از سالم بودن داده‌های خود نیاز دارید، می‌توانید از \f[V]rclone check\f[R] برای بررسی هش‌های محلی در مقایسه با سمت ریموت استفاده کنید.
.PP
و اگر در بالاترین سطح احتیاط هستید، از \f[V]rclone check --download\f[R] استفاده کنید که فایل‌ها را بارگیری کرده و آن‌ها را با نسخه‌های محلی مقایسه می‌کند.
(توجه داشته باشید که این کار از دیسک استفاده نمی‌کند \- فایل‌ها به‌صورت مستقیم در حافظه رم جریان می‌یابند).
.SS نسخه‌ها
.PP
هنگامی که نسخه‌بندی باکت فعال است (این کار در rclone با دستور \f[V]rclone backend versioning\f[R] انجام می‌شود)، با بارگذاری نسخه جدیدی از یک فایل توسط rclone، نسخه جدیدی از آن ایجاد می‌شود (https://docs.aws.amazon.com/AmazonS3/latest/userguide/Versioning.html).
به همین ترتیب، هنگام حذف یک فایل، نسخه قدیمی به عنوان مخفی علامت‌گذاری شده و همچنان در دسترس خواهد بود.
.PP
نسخه‌های قدیمی فایل‌ها، در صورت وجود، با استفاده از پرچم \f[V]--s3-versions\f[R] قابل مشاهده هستند.
.PP
همچنین می‌توان با استفاده از پرچم \f[V]--s3-version-at\f[R]، وضعیت یک باکت را در یک نقطه زمانی خاص مشاهده کرد.
این پرچم نسخه‌های فایل را دقیقاً همان‌گونه که در آن زمان بوده‌اند نشان می‌دهد؛ فایل‌هایی که پس از آن حذف شده‌اند را نمایش داده و فایل‌هایی را که پس از آن زمان ایجاد شده‌اند پنهان می‌کند.
.PP
اگر مایلید تمام نسخه‌های قدیمی را حذف کنید، می‌توانید از دستور \f[V]rclone backend cleanup-hidden remote:bucket\f[R] استفاده نمایید که همه نسخه‌های قدیمی و مخفی فایل‌ها را حذف کرده و نسخه‌های جاری را دست‌نخورده باقی می‌گذارد.
همچنین می‌توانید یک مسیر مشخص کنید تا تنها نسخه‌های قدیمی ذیل آن مسیر حذف شوند، مانند:
\f[V]rclone backend cleanup-hidden remote:bucket/path/to/stuff\f[R].
.PP
هنگامی که یک باکت را \f[V]purge\f[R] می‌کنید، ابتدا تمام نسخه‌های جاری و قدیمی حذف شده و سپس خود باکت حذف خواهد شد.
.PP
اما استفاده از دستور \f[V]delete\f[R] تنها باعث می‌شود نسخه‌های جاری فایل‌ها به نسخه‌های قدیمیِ مخفی تبدیل شوند.
.PP
در ادامه نمونه‌ای از نحوه فهرست‌گیری و بازیابی یک نسخه قدیمی و سپس \f[V]cleanup\f[R] نسخه‌های قدیمی نمایش داده شده است.
.PP
نمایش نسخه فعلی و تمام نسخه‌ها با استفاده از پرچم \f[V]--s3-versions\f[R].
.IP
.nf
\f[C]
$ rclone -q ls s3:cleanup-test
        9 one.txt

$ rclone -q --s3-versions ls s3:cleanup-test
        9 one.txt
        8 one-v2016-07-04-141032-000.txt
       16 one-v2016-07-04-141003-000.txt
       15 one-v2016-07-02-155621-000.txt
\f[R]
.fi
.PP
بازیابی یک نسخه قدیمی
.IP
.nf
\f[C]
$ rclone -q --s3-versions copy s3:cleanup-test/one-v2016-07-04-141003-000.txt /tmp

$ ls -l /tmp/one-v2016-07-04-141003-000.txt
-rw-rw-r-- 1 ncw ncw 16 Jul  2 17:46 /tmp/one-v2016-07-04-141003-000.txt
\f[R]
.fi
.PP
پاک‌سازی تمام نسخه‌های قدیمی و تأیید حذف شدن آن‌ها.
.IP
.nf
\f[C]
$ rclone -q backend cleanup-hidden s3:cleanup-test

$ rclone -q ls s3:cleanup-test
        9 one.txt

$ rclone -q --s3-versions ls s3:cleanup-test
        9 one.txt
\f[R]
.fi.SS "ملاحظات نام‌گذاری نسخه‌ها"
.PP
هنگام استفاده از گزینه \f[V]--s3-versions\f[R]، ابزار rclone برای تشخیص این‌که آیا اشیاء نسخه هستند یا خیر، به نام فایل اتکا می‌کند.
نام‌های نسخه‌ها با درج برچسب زمانی بین نام فایل و پسوند آن ایجاد می‌شوند.
.IP
.nf
\f[C]
        9 file.txt
        8 file-v2023-07-17-161032-000.txt
       16 file-v2023-06-15-141003-000.txt
\f[R]
.fi
.PP
اگر فایل‌های واقعی با نام‌هایی مشابه نسخه‌ها وجود داشته باشند، رفتار \f[V]--s3-versions\f[R] می‌تواند غیرقابل‌پیش‌بینی باشد.
.SS پاک‌سازی
.PP
اگر \f[V]rclone cleanup s3:bucket\f[R] را اجرا کنید، تمام بارگذاری‌های چندبخشی معلق قدیمی‌تر از ۲۴ ساعت حذف خواهند شد.
می‌توانید از گزینه \f[V]--interactive\f[R]/\f[V]i\f[R] یا \f[V]--dry-run\f[R] استفاده کنید تا دقیقاً ببینید چه کاری انجام خواهد داد.
اگر می‌خواهید کنترل بیشتری بر تاریخ انقضا داشته باشید، دستور \f[V]rclone backend cleanup s3:bucket -o max-age=1h\f[R] را اجرا کنید تا تمام بارگذاری‌های قدیمی‌تر از یک ساعت منقضی شوند.
می‌توانید از \f[V]rclone backend list-multipart-uploads s3:bucket\f[R] برای مشاهده بارگذاری‌های چندبخشی معلق استفاده کنید.
.SS "نویسه‌های محدودشده در نام فایل"
.PP
سرویس S3 هر رشته معتبر UTF-8 را به عنوان کلید می‌پذیرد.
.PP
بایت‌های نامعتبر UTF-8 جایگزین خواهند شد (https://rclone.org/overview/#invalid-utf8)، چرا که نمی‌توان از آن‌ها در XML استفاده کرد.
.PP
نویسه‌های زیر جایگزین می‌شوند زیرا هنگام کار با REST API مشکل‌ساز هستند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
NUL
T}@T{
0x00
T}@T{
␀
T}
T{
/
T}@T{
0x2F
T}@T{
／
T}
.TE
.PP
سازوکار کدگذاری این نام‌های فایل را نیز کدگذاری خواهد کرد، زیرا به نظر می‌رسد به‌درستی با SDK کار نمی‌کنند:
.PP
.TS
tab(@);
l c.
T{
نام فایل
T}@T{
جایگزین
T}
_
T{
\&.
T}@T{
．
T}
T{
\&..
T}@T{
．．
T}
.TE.SS نکته مهم درباره اسلش‌های دوتایی (\f[V]//\f[R])
.PP
کلیدهای اشیاء دارای اسلش‌های رو به جلو متوالی (\f[V]//\f[R]) توسط rclone
\f[B]پشتیبانی نمی‌شوند\f[R].
.PP
هنگامی که rclone با یک کلید شیء حاوی \f[V]//\f[R] (مانند
\f[V]a//b\f[R]) مواجه می‌شود، مسیر را برای استفاده از یک اسلش تکی نرمال‌سازی می‌کند (مانند
\f[V]a/b\f[R]).
این نرمال‌سازی می‌تواند هنگام تلاش برای دسترسی به شیء اصلی باعث خطاهای \[dq]object not found\[dq] شود، زیرا rclone به جای کلید واقعی شیء، به دنبال مسیر نرمال‌شده خواهد گشت.
.PP
\f[B]مثال:\f[R] \- کلید شیء اصلی در S3: \f[V]folder//file.txt\f[R]
\- تفسیر rclone از آن: \f[V]folder/file.txt\f[R] \- نتیجه:
خطای \[dq]object not found\[dq] هنگام تلاش برای دسترسی به
\f[V]folder//file.txt\f[R]
.PP
\f[B]راهکار:\f[R] هنگام استفاده از rclone، از به کار بردن اسلش‌های رو به جلو متوالی
(\f[V]//\f[R]) در کلیدهای اشیاء S3 خودداری کنید.
اگر از پیش اشیائی دارید که در کلیدهای آن‌ها \f[V]//\f[R] وجود دارد،
باید نام آن‌ها را برای استفاده از اسلش تکی تغییر دهید یا از راه‌های دیگر به آن‌ها دسترسی پیدا کنید.
.SS بارگذاری‌های چندبخشی (Multipart uploads)
.PP
rclone از بارگذاری‌های چندبخشی با S3 پشتیبانی می‌کند، به این معنی که می‌تواند
فایل‌های بزرگ‌تر از 5 GiB را بارگذاری کند.
.PP
توجه داشته باشید فایل‌هایی که \f[I]هم\f[R] با بارگذاری چندبخشی
\f[I]و هم\f[R] از طریق ریموت‌های crypt بارگذاری می‌شوند، فاقد چک‌سام‌های MD5 هستند.
.PP
rclone در نقطه‌ای که توسط \f[V]--s3-upload-cutoff\f[R] مشخص شده است،
از بارگذاری تک‌بخشی به بارگذاری چندبخشی تغییر حالت می‌دهد.
این مقدار می‌تواند حداکثر 5 GiB و حداقل 0 باشد (یعنی فایل‌ها همیشه به صورت چندبخشی بارگذاری شوند).
.PP
اندازه تکه‌ها (chunks) مورد استفاده در بارگذاری چندبخشی با
\f[V]--s3-chunk-size\f[R] و تعداد تکه‌هایی که به صورت هم‌روند بارگذاری می‌شوند با
\f[V]--s3-upload-concurrency\f[R] مشخص می‌شود.
.PP
بارگذاری‌های چندبخشی از حافظه اضافی معادل: \f[V]--transfers\f[R]
× \f[V]--s3-upload-concurrency\f[R] × \f[V]--s3-chunk-size\f[R] استفاده خواهند کرد.
بارگذاری‌های تک‌بخشی حافظه اضافی مصرف نمی‌کنند.
.PP
انتقال‌های تک‌بخشی بسته به تاخیر زمانی (latency) شما تا S3 می‌توانند سریع‌تر یا کندتر از انتقال‌های چندبخشی باشند \- هر چه تاخیر بیشتر باشد، احتمال اینکه انتقال‌های تک‌بخشی سریع‌تر عمل کنند بیشتر است.
.PP
افزایش \f[V]--s3-upload-concurrency\f[R] بازدهی (throughput) را افزایش می‌دهد (مقدار 8 منطقی خواهد بود) و افزایش \f[V]--s3-chunk-size\f[R] نیز بازدهی را بالا می‌برد (مقدار 16M منطقی است).
افزایش هر یک از این‌ها حافظه بیشتری مصرف خواهد کرد.
مقادیر پیش‌فرض به اندازه کافی بهینه هستند تا بدون مصرف حافظه بیش از حد، بیشترین کارایی ممکن را حاصل کنند.
.SS باکت‌ها و منطقه‌ها (Buckets and Regions)
.PP
در Amazon S3 می‌توانید باکت‌ها را با استفاده از هر منطقه‌ای فهرست کنید (\f[V]rclone lsd\f[R])، اما محتوای یک باکت تنها از منطقه‌ای که در آن ایجاد شده قابل دسترسی است.
اگر تلاش کنید از منطقه نادرستی به یک باکت دسترسی پیدا کنید، خطای زیر را دریافت خواهید کرد:
\f[V]incorrect region, the bucket is not in \[aq]XXX\[aq] region\f[R].
.SS احراز هویت (Authentication)
.PP
روش‌های متعددی برای ارائه مجموعه‌ای از اعتبارنامه‌های AWS به \f[V]rclone\f[R] وجود دارد؛ چه با استفاده از متغیرهای محیطی و چه بدون آن‌ها.
.PP
روش‌های مختلف احراز هویت به این ترتیب ارزیابی می‌شوند:
.IP \[bu] 2
مستقیماً در فایل پیکربندی rclone (مقدار \f[V]env_auth = false\f[R] در فایل پیکربندی):
.RS 2
.IP \[bu] 2
گزینه‌های \f[V]access_key_id\f[R] و \f[V]secret_access_key\f[R] الزامی هستند.
.IP \[bu] 2
گزینه \f[V]session_token\f[R] می‌تواند هنگام استفاده از AWS STS به صورت اختیاری تنظیم شود.
.RE
.IP \[bu] 2
پیکربندی زمان اجرا (\f[V]env_auth = true\f[R] در فایل پیکربندی):
.RS 2
.IP \[bu] 2
برون‌ریزی (export) متغیرهای محیطی زیر پیش از اجرای \f[V]rclone\f[R]:
.RS 2
.IP \[bu] 2
شناسه Access Key: \f[V]AWS_ACCESS_KEY_ID\f[R] یا \f[V]AWS_ACCESS_KEY\f[R]
.IP \[bu] 2
کلید Secret Access: \f[V]AWS_SECRET_ACCESS_KEY\f[R] یا
\f[V]AWS_SECRET_KEY\f[R]
.IP \[bu] 2
توکن Session: \f[V]AWS_SESSION_TOKEN\f[R] (اختیاری)
.RE
.IP \[bu] 2
یا، استفاده از یک نمایه (پروفایل) نام‌گذاری‌شده
(https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html):
.RS 2
.IP \[bu] 2
فایل‌های نمایه، فایل‌های استانداردی هستند که توسط ابزارهای AWS CLI استفاده می‌شوند
.IP \[bu] 2
به طور پیش‌فرض از فایل نمایه در دایرکتوری خانگی شما (مانند
\f[V]\[ti]/.aws/credentials\f[R] در سیستم‌های مبتنی بر یونیکس) و نمایه
\[dq]default\[dq] استفاده خواهد شد؛ برای تغییر آن، این متغیرهای محیطی یا کلیدهای پیکربندی را تنظیم کنید:
.RS 2
.IP \[bu] 2
متغیر \f[V]AWS_SHARED_CREDENTIALS_FILE\f[R] یا کلید پیکربندی \f[V]shared_credentials_file\f[R] برای تعیین فایل مورد نظر.
.IP \[bu] 2
متغیر \f[V]AWS_PROFILE\f[R] یا کلید پیکربندی \f[V]profile\f[R] برای تعیین نمایه مورد استفاده.
.RE
.RE
.IP \[bu] 2
یا، اجرای \f[V]rclone\f[R] در یک تسک ECS همراه با نقش IAM (فقط AWS).
.IP \[bu] 2
یا، اجرای \f[V]rclone\f[R] روی یک نمونه EC2 همراه با نقش IAM (فقط AWS).
.IP \[bu] 2
یا، اجرای \f[V]rclone\f[R] در یک پاد EKS با یک نقش IAM که به یک service account مرتبط است (فقط AWS).
.IP \[bu] 2
یا، استفاده از اعتبارنامه‌های فرآیند
(https://docs.aws.amazon.com/sdkref/latest/guide/feature-process-credentials.html)
برای خواندن پیکربندی از یک برنامه خارجی.
.RE
.PP
با مقدار \f[V]env_auth = true\f[R]، نرم‌افزار rclone (که از SDK for Go v2 استفاده می‌کند)
باید از تمامی روش‌های احراز هویت
(https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html)
که توسط ابزار CLI \f[V]aws\f[R] و سایر SDKهای AWS پشتیبانی می‌شوند، پشتیبانی کند.
.PP
اگر هیچ‌یک از این گزینه‌ها در نهایت اعتبارنامه‌های AWS را برای \f[V]rclone\f[R]
فراهم نکنند، تعامل با S3 بدون احراز هویت انجام خواهد شد (برای اطلاعات بیشتر بخش دسترسی ناشناس را ببینید)..SS "پذیرش نقش (دسترسی بین‌حسابی - Assume Role)"
.PP
اگر نیاز به دسترسی به منابع S3 در یک حساب AWS دیگر دارید، می‌توانید
از قابلیت پذیرش نقش IAM (اصطلاحاً Assume Role) استفاده کنید.
این ویژگی برای سناریوهای دسترسی بین‌حسابی (Cross-Account) کاربرد دارد،
جایی که شما در یک حساب دارای اعتبارنامه هستید اما باید به منابع موجود در
حسابی دیگر دسترسی داشته باشید.
.PP
جهت استفاده از assume role، پارامترهای زیر را پیکربندی کنید:
.IP \[bu] 2
\f[V]role_arn\f[R] \- شناسه ARN (نام منبع آمازون) مربوط به نقش IAM جهت
پذیرش در حساب مقصد.
قالب: \f[V]arn:aws:iam::ACCOUNT-ID:role/ROLE-NAME\f[R]
.IP \[bu] 2
\f[V]role_session_name\f[R] (اختیاری) \- نامی برای نشست نقش پذیرفته‌شده.
در صورت عدم تعیین، rclone به‌طور خودکار نامی تولید خواهد کرد.
.IP \[bu] 2
\f[V]role_session_duration\f[R] (اختیاری) \- مدت زمانی که اعتبارنامه‌های
نقش پذیرفته‌شده دارای اعتبار هستند.
در صورت عدم تعیین، مقدار پیش‌فرض AWS استفاده خواهد شد (معمولاً ۱ ساعت).
.IP \[bu] 2
\f[V]role_external_id\f[R] (اختیاری) \- یک شناسه خارجی که بر اساس سیاست
اعتماد (trust policy) نقش برای امنیت بیشتر الزامی شده است.
این پارامتر معمولاً زمانی به کار می‌رود که نقش توسط شخص ثالث در دسترس قرار می‌گیرد.
.PP
قابلیت assume role هم با اعتبارنامه‌های مستقیم
(\f[V]env_auth = false\f[R]) و هم با احراز هویت مبتنی بر محیط
(\f[V]env_auth = true\f[R]) کار می‌کند.
rclone ابتدا با استفاده از اعتبارنامه‌های پایه احراز هویت کرده، سپس از
همان اعتبارنامه‌ها برای پذیرش نقش تعیین‌شده استفاده می‌کند.
.PP
نمونه پیکربندی برای دسترسی بین‌حسابی:
.IP
.nf
\f[C]
[s3-cross-account]
type = s3
provider = AWS
env_auth = true
region = us-east-1
role_arn = arn:aws:iam::123456789012:role/CrossAccountS3Role
role_session_name = rclone-session
role_external_id = unique-role-external-id-12345
\f[R]
.fi
.PP
در این مثال:
\- اعتبارنامه‌های پایه از محیط به دست می‌آیند (نقش IAM، فایل اعتبارنامه‌ها، یا متغیرهای محیطی)
\- این اعتبارنامه‌ها سپس برای پذیرش نقش \f[V]CrossAccountS3Role\f[R] در حساب \f[V]123456789012\f[R] استفاده می‌شوند
\- یک شناسه خارجی مطابق با الزامات سیاست اعتماد نقش جهت امنیت بیشتر ارائه شده است
.PP
سیاست اعتماد نقش هدف در حساب مقصد باید به حساب یا کاربر مبدأ اجازه پذیرش آن را بدهد.
نمونه سیاست اعتماد:
.IP
.nf
\f[C]
{
  \[dq]Version\[dq]: \[dq]2012-10-17\[dq],
  \[dq]Statement\[dq]: [
    {
      \[dq]Effect\[dq]: \[dq]Allow\[dq],
      \[dq]Principal\[dq]: {
        \[dq]AWS\[dq]: \[dq]arn:aws:iam::SOURCE-ACCOUNT-ID:root\[dq]
      },
      \[dq]Action\[dq]: \[dq]sts:AssumeRole\[dq],
      \[dq]Condition\[dq]: {
        \[dq]StringEquals\[dq]: {
          \[dq]sts:ExternalID\[dq]: \[dq]unique-role-external-id-12345\[dq]
        }
      }
    }
  ]
}
\f[R]
.fi
.SS "مجوزهای S3 (S3 Permissions)"
.PP
هنگام استفاده از زیرفرمان \f[V]sync\f[R] در \f[V]rclone\f[R]،
حداقل مجوزهای زیر باید روی باکتی که در آن نوشته می‌شود در دسترس باشند:
.IP \[bu] 2
\f[V]ListBucket\f[R]
.IP \[bu] 2
\f[V]DeleteObject\f[R]
.IP \[bu] 2
\f[V]GetObject\f[R]
.IP \[bu] 2
\f[V]PutObject\f[R]
.IP \[bu] 2
\f[V]PutObjectACL\f[R]
.IP \[bu] 2
\f[V]CreateBucket\f[R] (مگر در صورت استفاده از s3-no-check-bucket)
.PP
هنگام استفاده از زیرفرمان \f[V]lsd\f[R]، داشتن مجوز \f[V]ListAllMyBuckets\f[R]
الزامی است.
.PP
نمونه سیاست:
.IP
.nf
\f[C]
{
  \[dq]Version\[dq]: \[dq]2012-10-17\[dq],
  \[dq]Statement\[dq]: [
    {
      \[dq]Effect\[dq]: \[dq]Allow\[dq],
      \[dq]Principal\[dq]: {
        \[dq]AWS\[dq]: \[dq]arn:aws:iam::USER_SID:user/USER_NAME\[dq]
      },
      \[dq]Action\[dq]: [
        \[dq]s3:ListBucket\[dq],
        \[dq]s3:DeleteObject\[dq],
        \[dq]s3:GetObject\[dq],
        \[dq]s3:PutObject\[dq],
        \[dq]s3:PutObjectAcl\[dq]
      ],
      \[dq]Resource\[dq]: [
        \[dq]arn:aws:s3:::BUCKET_NAME/*\[dq],
        \[dq]arn:aws:s3:::BUCKET_NAME\[dq]
      ]
    },
    {
      \[dq]Effect\[dq]: \[dq]Allow\[dq],
      \[dq]Action\[dq]: \[dq]s3:ListAllMyBuckets\[dq],
      \[dq]Resource\[dq]: \[dq]arn:aws:s3:::*\[dq]
    }
  ]
}
\f[R]
.fi
.PP
نکاتی در رابطه با موارد فوق:
.IP "1." 3
این سیاستی است که می‌تواند هنگام ساخت باکت استفاده شود.
فرض بر این است که \f[V]USER_NAME\f[R] از قبل ساخته شده است.
.IP "2." 3
مدخل Resource باید شامل هر دو ARN منبع باشد، چرا که یکی بیانگر باکت
و دیگری بیانگر اشیاء درون باکت است.
.IP "3." 3
هنگام استفاده از s3-no-check-bucket در صورتی که باکت از قبل وجود داشته باشد،
نیازی به گنجاندن \f[V]\[dq]arn:aws:s3:::BUCKET_NAME\[dq]\f[R] نیست.
.PP
جهت ارجاع، این یک اسکریپت Ansible است
(<https://gist.github.com/ebridges/ebfc9042dd7c756cd101cfa807b7ae2b>)
که یک یا چند باکت سازگار با \f[V]rclone sync\f[R] تولید می‌کند..SS سامانه مدیریت کلید (KMS)
.PP
اگر از رمزنگاری سمت سرور با KMS استفاده می‌کنید، باید مطمئن شوید که
rclone با \f[V]server_side_encryption = aws:kms\f[R] پیکربندی شده باشد؛
در غیر این صورت قادر به انتقال اشیاء کوچک نخواهید بود \- چرا که این کار
خطاهای چکسام (checksum) ایجاد خواهد کرد.
.SS سرویس‌های Glacier و Glacier Deep Archive
.PP
شما می‌توانید اشیاء را با استفاده از کلاس ذخیره‌سازی glacier بارگذاری کرده یا با
استفاده از یک خط‌مشی چرخه عمر
(lifecycle policy) (http://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-lifecycle.html)
آن‌ها را به glacier منتقل کنید. باکت همچنان می‌تواند به طور عادی همگام‌سازی شده یا کپی دریافت کند،
اما اگر rclone سعی کند به داده‌های کلاس ذخیره‌سازی glacier دسترسی پیدا کند، خطایی مانند
زیر را مشاهده خواهید کرد.
.IP
.nf
\f[C]
2017/09/11 19:07:43 Failed to sync: failed to open source object: Object in GLACIER, restore first: path/to/file
\f[R]
.fi
.PP
در این حالت، پیش از دسترسی به محتویات شیء، لازم است شیء (یا اشیاء) مربوطه را
بازیابی (restore) کنید (http://docs.aws.amazon.com/AmazonS3/latest/user-guide/restore-archived-objects.html).
بخش بازیابی در ادامه نشان می‌دهد که چگونه می‌توان این کار را با rclone انجام داد.
.PP
توجه داشته باشید که rclone تنها با S3 API ارتباط برقرار می‌کند و از Glacier Vault API
پشتیبانی نمی‌کند؛ بنابراین rclone نمی‌تواند مستقیماً به Glacier Vaultها دسترسی پیدا کند.
.SS باکت S3 با قابلیت Object Lock فعال
.PP
طبق مستندات AWS درباره‌ی S3 Object
Lock (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-overview.html#object-lock-permission):
.RS
.PP
اگر یک دوره نگهداری (retention period) پیش‌فرض روی یک باکت پیکربندی کنید، درخواست‌های
بارگذاری اشیاء در چنین باکتی حتماً باید شامل هدر Content-MD5 باشند.
.RE
.PP
هنگام بارگذاری اشیاء با پارامترهای Object Lock، نرم‌افزار rclone به طور خودکار هدر Content-MD5 را
محاسبه و ارسال می‌کند. به هیچ پیکربندی خاصی نیاز نیست.
.SS تنظیم دوره نگهداری Object Lock
.PP
برنامه rclone از تنظیم نگهداری Object Lock روی اشیاء بارگذاری‌شده با گزینه‌های
زیر پشتیبانی می‌کند:
.IP \[bu] 2
\f[V]--s3-object-lock-mode\f[R] \- تنظیم حالت Object Lock (به صورت GOVERNANCE
یا COMPLIANCE)
.IP \[bu] 2
\f[V]--s3-object-lock-retain-until-date\f[R] \- تنظیم تاریخ نگهداری
(قالب RFC3339 یا بازه زمانی مانند \f[V]365d\f[R]، \f[V]24h\f[R])
.IP \[bu] 2
\f[V]--s3-object-lock-legal-hold-status\f[R] \- تنظیم توقیف قانونی (legal hold) (به صورت ON
یا OFF)
.PP
مثال \- بارگذاری فایل‌ها با دوره نگهداری ۱ ساله تحت حالت GOVERNANCE:
.IP
.nf
\f[C]
rclone copy local:/data remote:bucket \[rs]
    --s3-object-lock-mode GOVERNANCE \[rs]
    --s3-object-lock-retain-until-date 365d
\f[R]
.fi
.SS کپی کردن تنظیمات Object Lock از مبدأ
.PP
هنگام استفاده از \f[V]--metadata\f[R]، می‌توانید از مقدار ویژه
\f[V]copy\f[R] برای حفظ تنظیمات Object Lock شیء مبدأ استفاده کنید:
.IP
.nf
\f[C]
rclone copy source:bucket dest:bucket \[rs]
    --metadata \[rs]
    --s3-object-lock-mode copy \[rs]
    --s3-object-lock-retain-until-date copy
\f[R]
.fi
.PP
شما همچنین می‌توانید مقادیر کپی‌شده و مقادیر صریح را ترکیب کنید.
برای مثال، جهت تغییر حالت از COMPLIANCE به GOVERNANCE ضمن
حفظ تاریخ نگهداری اصلی:
.IP
.nf
\f[C]
rclone copy source:bucket dest:bucket \[rs]
    --metadata \[rs]
    --s3-object-lock-mode GOVERNANCE \[rs]
    --s3-object-lock-retain-until-date copy
\f[R]
.fi.SS گزینه‌های تکمیلی Object Lock
.IP \[bu] 2
\f[V]--s3-bypass-governance-retention\f[R] \- برای حذف یا
بازنویسی اشیاء دارای حالت نگهداری GOVERNANCE پیش از به پایان رسیدن
تاریخ نگهداری الزامی است
.IP \[bu] 2
\f[V]--s3-bucket-object-lock-enabled\f[R] \- فعال‌سازی Object Lock هنگام
ایجاد یک باکت جدید با \f[V]rclone mkdir\f[R]
.IP \[bu] 2
\f[V]--s3-object-lock-set-after-upload\f[R] \- تنظیم Object Lock از طریق
فراخوانی‌های جداگانه API پس از بارگذاری (برای ارائه‌دهندگانی که از
هدرهای Object Lock هنگام فراخوانی PUT پشتیبانی نمی‌کنند)
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص s3 (ارائه‌دهندگان فضای ذخیره‌سازی سازگار با Amazon S3 شامل AWS، Alibaba، ArvanCloud، BizflyCloud، Ceph، ChinaMobile، Cloudflare، Cubbit، DigitalOcean، Dreamhost، Exaba، Fastly، FileLu، FlashBlade، GCS، HCP، Hetzner، HuaweiOBS، IBMCOS، IDrive، ImpossibleCloud، Intercolo، IONOS، Leviia، Liara، Linode، LyveCloud، Magalu، Mega، Minio، Netease، Outscale، OVHcloud، Petabox، Qiniu، Rabata، RackCorp، Rclone، Scaleway، Scality، SeaweedFS، Selectel، Servercore، SpectraLogic، Storj، Synology، TencentCOS، US3، Wasabi، Zadara، Zata، ZeroServices و Other) آورده شده است.
.SS --s3-provider
.PP
ارائه‌دهنده S3 خود را انتخاب کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: provider
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_PROVIDER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]AWS\[dq]
.RS 2
.IP \[bu] 2
Amazon Web Services (AWS) S3
.RE
.IP \[bu] 2
\[dq]Alibaba\[dq]
.RS 2
.IP \[bu] 2
سامانه ذخیره‌سازی شیء Alibaba Cloud (OSS) که پیش‌تر Aliyun نام داشت
.RE
.IP \[bu] 2
\[dq]ArvanCloud\[dq]
.RS 2
.IP \[bu] 2
فضای ذخیره‌سازی شیء ابر آروان (AOS)
.RE
.IP \[bu] 2
\[dq]BizflyCloud\[dq]
.RS 2
.IP \[bu] 2
Bizfly Cloud Simple Storage
.RE
.IP \[bu] 2
\[dq]Ceph\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Ceph
.RE
.IP \[bu] 2
\[dq]ChinaMobile\[dq]
.RS 2
.IP \[bu] 2
China Mobile Ecloud Elastic Object Storage (EOS)
.RE
.IP \[bu] 2
\[dq]Cloudflare\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی Cloudflare R2
.RE
.IP \[bu] 2
\[dq]Cubbit\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Cubbit DS3
.RE
.IP \[bu] 2
\[dq]DigitalOcean\[dq]
.RS 2
.IP \[bu] 2
DigitalOcean Spaces
.RE
.IP \[bu] 2
\[dq]Dreamhost\[dq]
.RS 2
.IP \[bu] 2
Dreamhost DreamObjects
.RE
.IP \[bu] 2
\[dq]Exaba\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Exaba
.RE
.IP \[bu] 2
\[dq]Fastly\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Fastly
.RE
.IP \[bu] 2
\[dq]FileLu\[dq]
.RS 2
.IP \[bu] 2
FileLu S5 (ذخیره‌سازی شیء سازگار با S3)
.RE
.IP \[bu] 2
\[dq]FlashBlade\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Pure Storage FlashBlade
.RE
.IP \[bu] 2
\[dq]GCS\[dq]
.RS 2
.IP \[bu] 2
Google Cloud Storage
.RE
.IP \[bu] 2
\[dq]HCP\[dq]
.RS 2
.IP \[bu] 2
پلتفرم محتوای هیتاچی (Hitachi Content Platform - HCP)
.RE
.IP \[bu] 2
\[dq]Hetzner\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Hetzner
.RE
.IP \[bu] 2
\[dq]HuaweiOBS\[dq]
.RS 2
.IP \[bu] 2
سرویس ذخیره‌سازی شیء Huawei
.RE
.IP \[bu] 2
\[dq]IBMCOS\[dq]
.RS 2
.IP \[bu] 2
IBM COS S3
.RE
.IP \[bu] 2
\[dq]IDrive\[dq]
.RS 2
.IP \[bu] 2
IDrive e2
.RE
.IP \[bu] 2
\[dq]ImpossibleCloud\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Impossible Cloud
.RE
.IP \[bu] 2
\[dq]Intercolo\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Intercolo
.RE
.IP \[bu] 2
\[dq]IONOS\[dq]
.RS 2
.IP \[bu] 2
IONOS Cloud
.RE
.IP \[bu] 2
\[dq]Leviia\[dq]
.RS 2.IP \[bu] 2
ذخیره‌سازی شیء Leviia
.RE
.IP \[bu] 2
\[dq]Liara\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Liara
.RE
.IP \[bu] 2
\[dq]Linode\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Linode
.RE
.IP \[bu] 2
\[dq]LyveCloud\[dq]
.RS 2
.IP \[bu] 2
فضای ابری Seagate Lyve
.RE
.IP \[bu] 2
\[dq]Magalu\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Magalu
.RE
.IP \[bu] 2
\[dq]Mega\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء MEGA S4
.RE
.IP \[bu] 2
\[dq]Minio\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Minio
.RE
.IP \[bu] 2
\[dq]Netease\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Netease (NOS)
.RE
.IP \[bu] 2
\[dq]Outscale\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء OUTSCALE (OOS)
.RE
.IP \[bu] 2
\[dq]OVHcloud\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء OVHcloud
.RE
.IP \[bu] 2
\[dq]Petabox\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Petabox
.RE
.IP \[bu] 2
\[dq]Qiniu\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Qiniu (Kodo)
.RE
.IP \[bu] 2
\[dq]Rabata\[dq]
.RS 2
.IP \[bu] 2
فضای ذخیره‌سازی ابری Rabata
.RE
.IP \[bu] 2
\[dq]RackCorp\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء RackCorp
.RE
.IP \[bu] 2
\[dq]Rclone\[dq]
.RS 2
.IP \[bu] 2
سرور S3 در Rclone
.RE
.IP \[bu] 2
\[dq]Scaleway\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Scaleway
.RE
.IP \[bu] 2
\[dq]Scality\[dq]
.RS 2
.IP \[bu] 2
Scality (RING / ARTESCA)
.RE
.IP \[bu] 2
\[dq]SeaweedFS\[dq]
.RS 2
.IP \[bu] 2
SeaweedFS S3
.RE
.IP \[bu] 2
\[dq]Selectel\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Selectel
.RE
.IP \[bu] 2
\[dq]Servercore\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Servercore
.RE
.IP \[bu] 2
\[dq]SpectraLogic\[dq]
.RS 2
.IP \[bu] 2
Spectra Logic Black Pearl
.RE
.IP \[bu] 2
\[dq]Storj\[dq]
.RS 2
.IP \[bu] 2
Storj (درگاه سازگار با S3)
.RE
.IP \[bu] 2
\[dq]Synology\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Synology C2
.RE
.IP \[bu] 2
\[dq]TencentCOS\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Tencent Cloud (COS)
.RE
.IP \[bu] 2
\[dq]US3\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء US3
.RE
.IP \[bu] 2
\[dq]Wasabi\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Wasabi
.RE
.IP \[bu] 2
\[dq]Zadara\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی شیء Zadara
.RE
.IP \[bu] 2
\[dq]Zata\[dq]
.RS 2
.IP \[bu] 2
Zata (درگاه سازگار با S3)
.RE
.IP \[bu] 2
\[dq]ZeroServices\[dq]
.RS 2
.IP \[bu] 2
Zero Services GmbH (ZERO-Z3)
.RE
.IP \[bu] 2
\[dq]Other\[dq]
.RS 2
.IP \[bu] 2
هر ارائه‌دهندهٔ دیگر سازگار با S3
.RE
.RE.SS --s3-env-auth
.PP
دریافت گواهی‌های اعتبارسنجی AWS از زمان اجرا (متغیرهای محیطی یا فراداده‌های EC2/ECS در صورت نبود متغیرهای محیطی).
.PP
تنها در صورتی اعمال می‌شود که access_key_id و secret_access_key خالی باشند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: env_auth
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_ENV_AUTH
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]false\[dq]
.RS 2
.IP \[bu] 2
وارد کردن گواهی‌های اعتبارسنجی AWS در مرحله بعد.
.RE
.IP \[bu] 2
\[dq]true\[dq]
.RS 2
.IP \[bu] 2
دریافت گواهی‌های اعتبارسنجی AWS از محیط (متغیرهای محیطی یا IAM).
.RE
.RE
.SS --s3-access-key-id
.PP
شناسه کلید دسترسی AWS.
.PP
برای دسترسی ناشناس یا گواهی‌های اعتبارسنجی زمان اجرا، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: access_key_id
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_ACCESS_KEY_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --s3-secret-access-key
.PP
کلید دسترسی محرمانه AWS (گذرواژه).
.PP
برای دسترسی ناشناس یا گواهی‌های اعتبارسنجی زمان اجرا، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: secret_access_key
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_SECRET_ACCESS_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --s3-region
.PP
ناحیه برای اتصال.
.PP
اگر از یک کلون S3 استفاده می‌کنید و ناحیه‌ای ندارید، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: region
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_REGION
.IP \[bu] 2
ارائه‌دهنده:
AWS,BizflyCloud,Ceph,Cloudflare,Cubbit,DigitalOcean,Dreamhost,Exaba,Fastly,FileLu,GCS,HCP,Hetzner,HuaweiOBS,IBMCOS,ImpossibleCloud,Intercolo,IONOS,Leviia,LyveCloud,Minio,Netease,Outscale,OVHcloud,Petabox,Qiniu,Rabata,RackCorp,Scaleway,Scality,SeaweedFS,Selectel,Servercore,Synology,Wasabi,Zadara,Zata,ZeroServices,Other
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]us-east-1\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی پیش‌فرض \- انتخابی مناسب در صورت عدم اطمینان.
.IP \[bu] 2
ناحیه ایالات متحده، ویرجینیای شمالی یا شمال غرب اقیانوس آرام.
.IP \[bu] 2
محدودیت مکان (location constraint) را خالی بگذارید.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]us-east-2\[dq]
.RS 2
.IP \[bu] 2
ناحیه شرق ایالات متحده (اوهایو).
.IP \[bu] 2
نیازمند محدودیت مکان us-east-2 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]us-west-1\[dq]
.RS 2
.IP \[bu] 2
ناحیه غرب ایالات متحده (کالیفرنیای شمالی).
.IP \[bu] 2
نیازمند محدودیت مکان us-west-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]us-west-2\[dq]
.RS 2
.IP \[bu] 2
ناحیه غرب ایالات متحده (اورگن).
.IP \[bu] 2
نیازمند محدودیت مکان us-west-2 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ca-central-1\[dq]
.RS 2
.IP \[bu] 2
ناحیه کانادا (مرکزی).
.IP \[bu] 2
نیازمند محدودیت مکان ca-central-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]eu-west-1\[dq]
.RS 2
.IP \[bu] 2
ناحیه اتحادیه اروپا (ایرلند).
.IP \[bu] 2
نیازمند محدودیت مکان EU یا eu-west-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]eu-west-2\[dq]
.RS 2
.IP \[bu] 2
ناحیه اتحادیه اروپا (لندن).
.IP \[bu] 2
نیازمند محدودیت مکان eu-west-2 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]eu-west-3\[dq]
.RS 2
.IP \[bu] 2
ناحیه اتحادیه اروپا (پاریس).
.IP \[bu] 2
نیازمند محدودیت مکان eu-west-3 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]eu-north-1\[dq]
.RS 2
.IP \[bu] 2
ناحیه اتحادیه اروپا (استکهلم).
.IP \[bu] 2
نیازمند محدودیت مکان eu-north-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]eu-south-1\[dq]
.RS 2
.IP \[bu] 2
ناحیه اتحادیه اروپا (میلان)..IP \[bu] 2
نیازمند قید مکانی eu-south-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]eu-central-1\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ اروپا (فرانکفورت).
.IP \[bu] 2
نیازمند قید مکانی eu-central-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ap-southeast-1\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ آسیا و اقیانوسیه (سنگاپور).
.IP \[bu] 2
نیازمند قید مکانی ap-southeast-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ap-southeast-2\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ آسیا و اقیانوسیه (سیدنی).
.IP \[bu] 2
نیازمند قید مکانی ap-southeast-2 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ap-northeast-1\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ آسیا و اقیانوسیه (توکیو).
.IP \[bu] 2
نیازمند قید مکانی ap-northeast-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ap-northeast-2\[dq]
.RS 2
.IP \[bu] 2
آسیا و اقیانوسیه (سئول).
.IP \[bu] 2
نیازمند قید مکانی ap-northeast-2 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ap-northeast-3\[dq]
.RS 2
.IP \[bu] 2
آسیا و اقیانوسیه (اوساکا-محلی).
.IP \[bu] 2
نیازمند قید مکانی ap-northeast-3 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ap-south-1\[dq]
.RS 2
.IP \[bu] 2
آسیا و اقیانوسیه (مومبای).
.IP \[bu] 2
نیازمند قید مکانی ap-south-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ap-east-1\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ آسیا و اقیانوسیه (هنگ‌کنگ).
.IP \[bu] 2
نیازمند قید مکانی ap-east-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]sa-east-1\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ آمریکای جنوبی (سائو پائولو).
.IP \[bu] 2
نیازمند قید مکانی sa-east-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]il-central-1\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ اسرائیل (تل‌آویو).
.IP \[bu] 2
نیازمند قید مکانی il-central-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]me-south-1\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ خاورمیانه (بحرین).
.IP \[bu] 2
نیازمند قید مکانی me-south-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]af-south-1\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ آفریقا (کیپ‌تاون).
.IP \[bu] 2
نیازمند قید مکانی af-south-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]cn-north-1\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ چین (پکن).
.IP \[bu] 2
نیازمند قید مکانی cn-north-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]cn-northwest-1\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ چین (نینگ‌شیا).
.IP \[bu] 2
نیازمند قید مکانی cn-northwest-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]us-gov-east-1\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ AWS GovCloud (US-East).
.IP \[bu] 2
نیازمند قید مکانی us-gov-east-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]us-gov-west-1\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ AWS GovCloud (US).
.IP \[bu] 2
نیازمند قید مکانی us-gov-west-1 است.
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]hn\[dq]
.RS 2
.IP \[bu] 2
هانوی
.IP \[bu] 2
ارائه‌دهنده: BizflyCloud
.RE
.IP \[bu] 2
\[dq]hcm\[dq]
.RS 2
.IP \[bu] 2
هوشی‌مین
.IP \[bu] 2
ارائه‌دهنده: BizflyCloud
.RE.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
اگر مطمئن نیستید از این مقدار استفاده کنید.
.IP \[bu] 2
از امضاهای v4 و یک ناحیه خالی استفاده خواهد کرد.
.IP \[bu] 2
ارائه‌دهنده:
Ceph,DigitalOcean,Dreamhost,Exaba,GCS,HCP,IBMCOS,Leviia,LyveCloud,Minio,Netease,Scality,SeaweedFS,Wasabi,Other
.RE
.IP \[bu] 2
\[dq]other-v2-signature\[dq]
.RS 2
.IP \[bu] 2
تنها در صورتی از این مقدار استفاده کنید که امضاهای v4 کار نکنند.
.IP \[bu] 2
به‌عنوان مثال،
نسخه‌های پیش از Jewel/v10 در CEPH.
.IP \[bu] 2
ارائه‌دهنده:
Ceph,DigitalOcean,Dreamhost,Exaba,GCS,HCP,IBMCOS,Leviia,LyveCloud,Minio,Netease,Scality,SeaweedFS,Wasabi,Other
.RE
.IP \[bu] 2
\[dq]auto\[dq]
.RS 2
.IP \[bu] 2
باکت‌های R2 جهت کاهش تأخیر به‌طور خودکار در سراسر مراکز داده Cloudflare توزیع می‌شوند.
.IP \[bu] 2
ارائه‌دهنده: Cloudflare
.RE
.IP \[bu] 2
\[dq]eu-west-1\[dq]
.RS 2
.IP \[bu] 2
غرب اروپا
.IP \[bu] 2
ارائه‌دهنده: Cubbit
.RE
.IP \[bu] 2
\[dq]au-east-1\[dq]
.RS 2
.IP \[bu] 2
شرق استرالیا ۱
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]eu-central\[dq]
.RS 2
.IP \[bu] 2
مرکز اروپا
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]eu-south-1\[dq]
.RS 2
.IP \[bu] 2
جنوب اروپا ۱
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]eu-west-1\[dq]
.RS 2
.IP \[bu] 2
غرب اروپا ۱
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]jp-central-1\[dq]
.RS 2
.IP \[bu] 2
مرکز ژاپن ۱
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]uk-east-1\[dq]
.RS 2
.IP \[bu] 2
شرق بریتانیا ۱
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]us-central-1\[dq]
.RS 2
.IP \[bu] 2
مرکز ایالات متحده ۱
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]us-east\[dq]
.RS 2
.IP \[bu] 2
شرق ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]us-east-1\[dq]
.RS 2
.IP \[bu] 2
شرق ایالات متحده ۱
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]us-west\[dq]
.RS 2
.IP \[bu] 2
غرب ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]us-west-1\[dq]
.RS 2
.IP \[bu] 2
غرب ایالات متحده ۱
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]global\[dq]
.RS 2
.IP \[bu] 2
سراسری
.IP \[bu] 2
ارائه‌دهنده: FileLu
.RE
.IP \[bu] 2
\[dq]us-east\[dq]
.RS 2
.IP \[bu] 2
آمریکای شمالی (US-East)
.IP \[bu] 2
ارائه‌دهنده: FileLu
.RE
.IP \[bu] 2
\[dq]eu-central\[dq]
.RS 2
.IP \[bu] 2
اروپا (EU-Central)
.IP \[bu] 2
ارائه‌دهنده: FileLu
.RE
.IP \[bu] 2
\[dq]ap-southeast\[dq]
.RS 2
.IP \[bu] 2
آسیا و اقیانوسیه (AP-Southeast)
.IP \[bu] 2
ارائه‌دهنده: FileLu
.RE
.IP \[bu] 2
\[dq]me-central\[dq]
.RS 2
.IP \[bu] 2
خاورمیانه (ME-Central)
.IP \[bu] 2
ارائه‌دهنده: FileLu
.RE
.IP \[bu] 2
\[dq]hel1\[dq]
.RS 2
.IP \[bu] 2
هلسینکی
.IP \[bu] 2
ارائه‌دهنده: Hetzner
.RE
.IP \[bu] 2
\[dq]fsn1\[dq]
.RS 2
.IP \[bu] 2
فالکن‌اشتاین.IP \[bu] 2
ارائه‌دهنده: Hetzner
.RE
.IP \[bu] 2
\[dq]nbg1\[dq]
.RS 2
.IP \[bu] 2
نورنبرگ
.IP \[bu] 2
ارائه‌دهنده: Hetzner
.RE
.IP \[bu] 2
\[dq]af-south-1\[dq]
.RS 2
.IP \[bu] 2
AF-Johannesburg
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]ap-southeast-2\[dq]
.RS 2
.IP \[bu] 2
AP-Bangkok
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]ap-southeast-3\[dq]
.RS 2
.IP \[bu] 2
AP-Singapore
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]cn-east-3\[dq]
.RS 2
.IP \[bu] 2
CN East-Shanghai1
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]cn-east-2\[dq]
.RS 2
.IP \[bu] 2
CN East-Shanghai2
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]cn-north-1\[dq]
.RS 2
.IP \[bu] 2
CN North-Beijing1
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]cn-north-4\[dq]
.RS 2
.IP \[bu] 2
CN North-Beijing4
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]cn-south-1\[dq]
.RS 2
.IP \[bu] 2
CN South-Guangzhou
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]ap-southeast-1\[dq]
.RS 2
.IP \[bu] 2
CN-Hong Kong
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]sa-argentina-1\[dq]
.RS 2
.IP \[bu] 2
LA-Buenos Aires1
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]sa-peru-1\[dq]
.RS 2
.IP \[bu] 2
LA-Lima1
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]na-mexico-1\[dq]
.RS 2
.IP \[bu] 2
LA-Mexico City1
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]sa-chile-1\[dq]
.RS 2
.IP \[bu] 2
LA-Santiago2
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]sa-brazil-1\[dq]
.RS 2
.IP \[bu] 2
LA-Sao Paulo1
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]ru-northwest-2\[dq]
.RS 2
.IP \[bu] 2
RU-Moscow2
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]eu-central-2\[dq]
.RS 2
.IP \[bu] 2
فرانکفورت، آلمان
.IP \[bu] 2
ارائه‌دهنده: ImpossibleCloud
.RE
.IP \[bu] 2
\[dq]eu-west-1\[dq]
.RS 2
.IP \[bu] 2
آمستردام، هلند
.IP \[bu] 2
ارائه‌دهنده: ImpossibleCloud
.RE
.IP \[bu] 2
\[dq]eu-west-2\[dq]
.RS 2
.IP \[bu] 2
لندن، بریتانیا
.IP \[bu] 2
ارائه‌دهنده: ImpossibleCloud
.RE
.IP \[bu] 2
\[dq]eu-west-3\[dq]
.RS 2
.IP \[bu] 2
پاریس، فرانسه
.IP \[bu] 2
ارائه‌دهنده: ImpossibleCloud
.RE
.IP \[bu] 2
\[dq]eu-east-1\[dq]
.RS 2
.IP \[bu] 2
پوزنان، لهستان
.IP \[bu] 2
ارائه‌دهنده: ImpossibleCloud
.RE
.IP \[bu] 2
\[dq]eu-north-1\[dq]
.RS 2
.IP \[bu] 2
کپنهاگ، دانمارک
.IP \[bu] 2
ارائه‌دهنده: ImpossibleCloud
.RE
.IP \[bu] 2
\[dq]us-east-1\[dq]
.RS 2.IP \[bu] 2
نیویورک، ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: ImpossibleCloud
.RE
.IP \[bu] 2
\[dq]de-fra\[dq]
.RS 2
.IP \[bu] 2
فرانکفورت، آلمان
.IP \[bu] 2
ارائه‌دهنده: Intercolo
.RE
.IP \[bu] 2
\[dq]de\[dq]
.RS 2
.IP \[bu] 2
فرانکفورت، آلمان
.IP \[bu] 2
ارائه‌دهنده: IONOS,OVHcloud
.RE
.IP \[bu] 2
\[dq]eu-central-2\[dq]
.RS 2
.IP \[bu] 2
برلین، آلمان
.IP \[bu] 2
ارائه‌دهنده: IONOS
.RE
.IP \[bu] 2
\[dq]eu-central-3\[dq]
.RS 2
.IP \[bu] 2
برلین، آلمان
.IP \[bu] 2
ارائه‌دهنده: IONOS
.RE
.IP \[bu] 2
\[dq]eu-central-4\[dq]
.RS 2
.IP \[bu] 2
فرانکفورت، آلمان
.IP \[bu] 2
ارائه‌دهنده: IONOS
.RE
.IP \[bu] 2
\[dq]eu-south-2\[dq]
.RS 2
.IP \[bu] 2
لوگرونیو، اسپانیا
.IP \[bu] 2
ارائه‌دهنده: IONOS
.RE
.IP \[bu] 2
\[dq]us-central-1\[dq]
.RS 2
.IP \[bu] 2
لنکسا، ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IONOS
.RE
.IP \[bu] 2
\[dq]eu-west-2\[dq]
.RS 2
.IP \[bu] 2
پاریس، فرانسه
.IP \[bu] 2
ارائه‌دهنده: Outscale
.RE
.IP \[bu] 2
\[dq]us-east-2\[dq]
.RS 2
.IP \[bu] 2
نیوجرسی، ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: Outscale
.RE
.IP \[bu] 2
\[dq]us-west-1\[dq]
.RS 2
.IP \[bu] 2
کالیفرنیا، ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: Outscale
.RE
.IP \[bu] 2
\[dq]cloudgouv-eu-west-1\[dq]
.RS 2
.IP \[bu] 2
SecNumCloud، پاریس، فرانسه
.IP \[bu] 2
ارائه‌دهنده: Outscale
.RE
.IP \[bu] 2
\[dq]ap-northeast-1\[dq]
.RS 2
.IP \[bu] 2
توکیو، ژاپن
.IP \[bu] 2
ارائه‌دهنده: Outscale
.RE
.IP \[bu] 2
\[dq]gra\[dq]
.RS 2
.IP \[bu] 2
گراولین، فرانسه
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]rbx\[dq]
.RS 2
.IP \[bu] 2
روبه، فرانسه
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]sbg\[dq]
.RS 2
.IP \[bu] 2
استراسبورگ، فرانسه
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]eu-west-par\[dq]
.RS 2
.IP \[bu] 2
پاریس، فرانسه (3AZ)
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]uk\[dq]
.RS 2
.IP \[bu] 2
لندن، بریتانیا
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]waw\[dq]
.RS 2
.IP \[bu] 2
ورشو، لهستان
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]bhs\[dq]
.RS 2
.IP \[bu] 2
بوهارنوآ، کانادا
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]ca-east-tor\[dq]
.RS 2
.IP \[bu] 2
تورنتو، کانادا
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]sgp\[dq]
.RS 2
.IP \[bu] 2
سنگاپور
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]ap-southeast-syd\[dq]
.RS 2
.IP \[bu] 2
سیدنی، استرالیا
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE.IP \[bu] 2
\[dq]ap-south-mum\[dq]
.RS 2
.IP \[bu] 2
بمبئی، هند
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]us-east-va\[dq]
.RS 2
.IP \[bu] 2
وینت هیل، ویرجینیا، ایالات متحده آمریکا
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]us-west-or\[dq]
.RS 2
.IP \[bu] 2
هیلزبورو، اورگان، ایالات متحده آمریکا
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]rbx-archive\[dq]
.RS 2
.IP \[bu] 2
روبه، فرانسه (آرشیو سرد)
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]us-east-1\[dq]
.RS 2
.IP \[bu] 2
شرق ایالات متحده (ویرجینیای
شمالی)
.IP \[bu] 2
ارائه‌دهنده: Petabox,Rabata
.RE
.IP \[bu] 2
\[dq]eu-central-1\[dq]
.RS 2
.IP \[bu] 2
اروپا (فرانکفورت)
.IP \[bu] 2
ارائه‌دهنده: Petabox
.RE
.IP \[bu] 2
\[dq]ap-southeast-1\[dq]
.RS 2
.IP \[bu] 2
آسیا و اقیانوسیه (سنگاپور)
.IP \[bu] 2
ارائه‌دهنده: Petabox
.RE
.IP \[bu] 2
\[dq]me-south-1\[dq]
.RS 2
.IP \[bu] 2
خاورمیانه (بحرین)
.IP \[bu] 2
ارائه‌دهنده: Petabox
.RE
.IP \[bu] 2
\[dq]sa-east-1\[dq]
.RS 2
.IP \[bu] 2
آمریکای جنوبی (سائوپائولو)
.IP \[bu] 2
ارائه‌دهنده: Petabox
.RE
.IP \[bu] 2
\[dq]cn-east-1\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی پیش‌فرض \- اگر مطمئن نیستید، انتخابی مناسب است.
.IP \[bu] 2
منطقه ۱ شرق چین.
.IP \[bu] 2
نیازمند محدودیت مکانی cn-east-1 است.
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]cn-east-2\[dq]
.RS 2
.IP \[bu] 2
منطقه ۲ شرق چین.
.IP \[bu] 2
نیازمند محدودیت مکانی cn-east-2 است.
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]cn-north-1\[dq]
.RS 2
.IP \[bu] 2
منطقه ۱ شمال چین.
.IP \[bu] 2
نیازمند محدودیت مکانی cn-north-1 است.
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]cn-south-1\[dq]
.RS 2
.IP \[bu] 2
منطقه ۱ جنوب چین.
.IP \[bu] 2
نیازمند محدودیت مکانی cn-south-1 است.
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]us-north-1\[dq]
.RS 2
.IP \[bu] 2
منطقه آمریکای شمالی.
.IP \[bu] 2
نیازمند محدودیت مکانی us-north-1 است.
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]ap-southeast-1\[dq]
.RS 2
.IP \[bu] 2
منطقه ۱ جنوب شرق آسیا.
.IP \[bu] 2
نیازمند محدودیت مکانی ap-southeast-1 است.
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]ap-northeast-1\[dq]
.RS 2
.IP \[bu] 2
منطقه ۱ شمال شرق آسیا.
.IP \[bu] 2
نیازمند محدودیت مکانی ap-northeast-1 است.
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]eu-west-1\[dq]
.RS 2
.IP \[bu] 2
اروپا (ایرلند)
.IP \[bu] 2
ارائه‌دهنده: Rabata
.RE
.IP \[bu] 2
\[dq]eu-west-2\[dq]
.RS 2
.IP \[bu] 2
اروپا (لندن)
.IP \[bu] 2
ارائه‌دهنده: Rabata
.RE
.IP \[bu] 2
\[dq]global\[dq]
.RS 2
.IP \[bu] 2
منطقه CDN جهانی (تمام موقعیت‌ها)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au\[dq]
.RS 2
.IP \[bu] 2
استرالیا (تمام ایالت‌ها)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au-nsw\[dq]
.RS 2.IP \[bu] 2
منطقه NSW (استرالیا)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au-qld\[dq]
.RS 2
.IP \[bu] 2
منطقه QLD (استرالیا)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au-vic\[dq]
.RS 2
.IP \[bu] 2
منطقه VIC (استرالیا)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au-wa\[dq]
.RS 2
.IP \[bu] 2
منطقه پرت (استرالیا)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]ph\[dq]
.RS 2
.IP \[bu] 2
منطقه مانیل (فیلیپین)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]th\[dq]
.RS 2
.IP \[bu] 2
منطقه بانکوک (تایلند)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]hk\[dq]
.RS 2
.IP \[bu] 2
منطقه هنگ‌کنگ (HK)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]mn\[dq]
.RS 2
.IP \[bu] 2
منطقه اولان‌باتور (مغولستان)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]kg\[dq]
.RS 2
.IP \[bu] 2
منطقه بیشکک (قرقیزستان)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]id\[dq]
.RS 2
.IP \[bu] 2
منطقه جاکارتا (اندونزی)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]jp\[dq]
.RS 2
.IP \[bu] 2
منطقه توکیو (ژاپن)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]sg\[dq]
.RS 2
.IP \[bu] 2
منطقه سنگاپور (SG)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]de\[dq]
.RS 2
.IP \[bu] 2
منطقه فرانکفورت (آلمان)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]us\[dq]
.RS 2
.IP \[bu] 2
منطقه ایالات متحده (AnyCast)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]us-east-1\[dq]
.RS 2
.IP \[bu] 2
منطقه نیویورک (ایالات متحده)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]us-west-1\[dq]
.RS 2
.IP \[bu] 2
منطقه فریمونت (ایالات متحده)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]nz\[dq]
.RS 2
.IP \[bu] 2
منطقه اوکلند (نیوزیلند)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]nl-ams\[dq]
.RS 2
.IP \[bu] 2
آمستردام، هلند
.IP \[bu] 2
ارائه‌دهنده: Scaleway
.RE
.IP \[bu] 2
\[dq]fr-par\[dq]
.RS 2
.IP \[bu] 2
پاریس، فرانسه
.IP \[bu] 2
ارائه‌دهنده: Scaleway
.RE
.IP \[bu] 2
\[dq]pl-waw\[dq]
.RS 2
.IP \[bu] 2
ورشو، لهستان
.IP \[bu] 2
ارائه‌دهنده: Scaleway
.RE
.IP \[bu] 2
\[dq]ru-1\[dq]
.RS 2
.IP \[bu] 2
سن پترزبورگ
.IP \[bu] 2
ارائه‌دهنده: Selectel,Servercore
.RE
.IP \[bu] 2
\[dq]ru-3\[dq]
.RS 2
.IP \[bu] 2
سن پترزبورگ
.IP \[bu] 2
ارائه‌دهنده: Selectel
.RE
.IP \[bu] 2
\[dq]ru-7\[dq]
.RS 2
.IP \[bu] 2
مسکو.IP \[bu] 2
ارائه‌دهنده: Selectel,Servercore
.RE
.IP \[bu] 2
\[dq]gis-1\[dq]
.RS 2
.IP \[bu] 2
مسکو
.IP \[bu] 2
ارائه‌دهنده: Selectel,Servercore
.RE
.IP \[bu] 2
\[dq]kz-1\[dq]
.RS 2
.IP \[bu] 2
قزاقستان
.IP \[bu] 2
ارائه‌دهنده: Selectel
.RE
.IP \[bu] 2
\[dq]uz-2\[dq]
.RS 2
.IP \[bu] 2
ازبکستان
.IP \[bu] 2
ارائه‌دهنده: Selectel
.RE
.IP \[bu] 2
\[dq]uz-2\[dq]
.RS 2
.IP \[bu] 2
تاشکند، ازبکستان
.IP \[bu] 2
ارائه‌دهنده: Servercore
.RE
.IP \[bu] 2
\[dq]kz-1\[dq]
.RS 2
.IP \[bu] 2
آلماتی، قزاقستان
.IP \[bu] 2
ارائه‌دهنده: Servercore
.RE
.IP \[bu] 2
\[dq]eu-001\[dq]
.RS 2
.IP \[bu] 2
منطقه ۱ اروپا
.IP \[bu] 2
ارائه‌دهنده: Synology
.RE
.IP \[bu] 2
\[dq]eu-002\[dq]
.RS 2
.IP \[bu] 2
منطقه ۲ اروپا
.IP \[bu] 2
ارائه‌دهنده: Synology
.RE
.IP \[bu] 2
\[dq]us-001\[dq]
.RS 2
.IP \[bu] 2
منطقه ۱ آمریکا
.IP \[bu] 2
ارائه‌دهنده: Synology
.RE
.IP \[bu] 2
\[dq]us-002\[dq]
.RS 2
.IP \[bu] 2
منطقه ۲ آمریکا
.IP \[bu] 2
ارائه‌دهنده: Synology
.RE
.IP \[bu] 2
\[dq]tw-001\[dq]
.RS 2
.IP \[bu] 2
آسیا (تایوان)
.IP \[bu] 2
ارائه‌دهنده: Synology
.RE
.IP \[bu] 2
\[dq]us-east-1\[dq]
.RS 2
.IP \[bu] 2
منطقه پیش‌فرض.
.IP \[bu] 2
محدودیت مکان (location constraint) را خالی بگذارید.
.IP \[bu] 2
ارائه‌دهنده: Zadara
.RE
.IP \[bu] 2
\[dq]us-east-1\[dq]
.RS 2
.IP \[bu] 2
ایندور، مادیا پرادش، هند
.IP \[bu] 2
ارائه‌دهنده: Zata
.RE
.IP \[bu] 2
\[dq]zero-fra1\[dq]
.RS 2
.IP \[bu] 2
فرانکفورت ۱
.IP \[bu] 2
ارائه‌دهنده: ZeroServices
.RE
.IP \[bu] 2
\[dq]zero-fra2\[dq]
.RS 2
.IP \[bu] 2
فرانکفورت ۲
.IP \[bu] 2
ارائه‌دهنده: ZeroServices
.RE
.IP \[bu] 2
\[dq]zero-eyl1\[dq]
.RS 2
.IP \[bu] 2
اییل ۱
.IP \[bu] 2
ارائه‌دهنده: ZeroServices
.RE
.RE.SS --s3-endpoint
.PP
نقطه پایانی برای S3 API.
.PP
هنگام استفاده از یک کلون S3 ضروری است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_ENDPOINT
.IP \[bu] 2
ارائه‌دهنده:
AWS,Alibaba,ArvanCloud,BizflyCloud,Ceph,ChinaMobile,Cloudflare,Cubbit,DigitalOcean,Dreamhost,Exaba,Fastly,FileLu,FlashBlade,GCS,HCP,Hetzner,HuaweiOBS,IBMCOS,ImpossibleCloud,Intercolo,IONOS,Leviia,Liara,Linode,LyveCloud,Magalu,Mega,Minio,Netease,Outscale,OVHcloud,Petabox,Qiniu,Rabata,RackCorp,Rclone,Scaleway,Scality,SeaweedFS,Selectel,Servercore,SpectraLogic,Storj,Synology,TencentCOS,US3,Wasabi,Zadara,Zata,ZeroServices,Other
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]oss-accelerate.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
شتاب‌دهی سراسری
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-accelerate-overseas.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
شتاب‌دهی سراسری (خارج از سرزمین اصلی چین)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-cn-hangzhou.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
شرق چین ۱ (هانگژو)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-cn-shanghai.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
شرق چین ۲ (شانگهای)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-cn-qingdao.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
شمال چین ۱ (چینگ‌دائو)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-cn-beijing.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
شمال چین ۲ (پکن)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-cn-zhangjiakou.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
شمال چین ۳ (ژانگ‌جیاکو)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-cn-huhehaote.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
شمال چین ۵ (هوهوت)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-cn-wulanchabu.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
شمال چین ۶ (اولانچاب)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-cn-shenzhen.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
جنوب چین ۱ (شنژن)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-cn-heyuan.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
جنوب چین ۲ (هه‌یوان)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-cn-guangzhou.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
جنوب چین ۳ (گوانگژو)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-cn-chengdu.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
غرب چین ۱ (چنگدو)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-cn-hongkong.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
هنگ‌کنگ (هنگ‌کنگ)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-us-west-1.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
غرب آمریکا ۱ (سیلیکون‌ولی)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-us-east-1.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
شرق آمریکا ۱ (ویرجینیا)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-ap-southeast-1.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
آسیای جنوب شرقی، جنوب شرق ۱ (سنگاپور)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-ap-southeast-2.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
آسیا پاسیفیک، جنوب شرق ۲ (سیدنی)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-ap-southeast-3.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
آسیای جنوب شرقی، جنوب شرق ۳ (کوالالامپور)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-ap-southeast-5.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
آسیا پاسیفیک، جنوب شرق ۵ (جاکارتا)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE.IP \[bu] 2
\[dq]oss-ap-northeast-1.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
آسیا\-اقیانوسیه شمال‌شرقی ۱ (ژاپن)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-ap-south-1.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
آسیا\-اقیانوسیه جنوبی ۱ (بمبئی)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-eu-central-1.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
اروپای مرکزی ۱ (فرانکفورت)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-eu-west-1.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
اروپای غربی (لندن)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]oss-me-east-1.aliyuncs.com\[dq]
.RS 2
.IP \[bu] 2
خاورمیانه ۱ (دبی)
.IP \[bu] 2
ارائه‌دهنده: Alibaba
.RE
.IP \[bu] 2
\[dq]s3.ir-thr-at1.arvanstorage.ir\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی پیش‌فرض \- گزینه‌ای مناسب در صورت عدم اطمینان.
.IP \[bu] 2
تهران ایران (سیمین)
.IP \[bu] 2
ارائه‌دهنده: ArvanCloud
.RE
.IP \[bu] 2
\[dq]s3.ir-tbz-sh1.arvanstorage.ir\[dq]
.RS 2
.IP \[bu] 2
تبریز ایران (شهریار)
.IP \[bu] 2
ارائه‌دهنده: ArvanCloud
.RE
.IP \[bu] 2
\[dq]hn.ss.bfcplatform.vn\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی هانوی
.IP \[bu] 2
ارائه‌دهنده: BizflyCloud
.RE
.IP \[bu] 2
\[dq]hcm.ss.bfcplatform.vn\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی هوشی‌مین
.IP \[bu] 2
ارائه‌دهنده: BizflyCloud
.RE
.IP \[bu] 2
\[dq]eos-wuxi-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی پیش‌فرض \- گزینه‌ای مناسب در صورت عدم اطمینان.
.IP \[bu] 2
شرق چین (سوژو)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-jinan-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
شرق چین (جینان)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-ningbo-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
شرق چین (هانگژو)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-shanghai-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
شرق چین (شانگهای-۱)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-zhengzhou-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
مرکز چین (ژنگژو)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-hunan-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
مرکز چین (چانگشا-۱)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-zhuzhou-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
مرکز چین (چانگشا-۲)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-guangzhou-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
جنوب چین (گوانگژو-۲)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-dongguan-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
جنوب چین (گوانگژو-۳)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-beijing-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
شمال چین (پکن-۱)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-beijing-2.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
شمال چین (پکن-۲)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-beijing-4.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
شمال چین (پکن-۳)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-huhehaote-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
شمال چین (هوهه‌هوت)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE.IP \[bu] 2
\[dq]eos-chengdu-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
جنوب‌غربی چین (چنگدو)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-chongqing-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
جنوب‌غربی چین (چونگ‌کینگ)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-guiyang-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
جنوب‌غربی چین (گوئی‌یانگ)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-xian-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
شمال‌غربی چین (شی‌آن)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-yunnan.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
یون‌نان چین (کون‌مینگ)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-yunnan-2.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
یون‌نان چین (کون‌مینگ\-۲)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-tianjin-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
تیانجین چین (تیانجین)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-jilin-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
جی‌لین چین (چانگچون)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-hubei-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
هوبئی چین (شیانگ‌یان)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-jiangxi-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
جیانگ‌شی چین (نانچانگ)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-gansu-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
گانسو چین (لانژو)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-shanxi-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
شان‌شی چین (تای‌یوان)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-liaoning-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
لیائونینگ چین (شن‌یانگ)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-hebei-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
هه‌بئی چین (شیجیاژوانگ)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-fujian-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
فوجیان چین (شیامن)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-guangxi-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
گوانگ‌شی چین (نان‌نینگ)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]eos-anhui-1.cmecloud.cn\[dq]
.RS 2
.IP \[bu] 2
آن‌هوئی چین (هواینان)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]s3.cubbit.eu\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ذخیره‌سازی شیء Cubbit DS3
.IP \[bu] 2
ارائه‌دهنده: Cubbit
.RE
.IP \[bu] 2
\[dq]s3.{tenant_name}.cubbit.eu\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی چندمستأجری \- مقدار {tenant_name} را با نام مستأجر
واقعی خود جایگزین کنید.
این گزینه را مستقیماً انتخاب نکنید
.IP \[bu] 2
ارائه‌دهنده: Cubbit
.RE
.IP \[bu] 2
\[dq]syd1.digitaloceanspaces.com\[dq]
.RS 2
.IP \[bu] 2
DigitalOcean Spaces سیدنی ۱
.IP \[bu] 2
ارائه‌دهنده: DigitalOcean
.RE
.IP \[bu] 2
\[dq]sfo3.digitaloceanspaces.com\[dq]
.RS 2
.IP \[bu] 2
DigitalOcean Spaces سان‌فرانسیسکو ۳
.IP \[bu] 2
ارائه‌دهنده: DigitalOcean
.RE
.IP \[bu] 2
\[dq]sfo2.digitaloceanspaces.com\[dq]
.RS 2
.IP \[bu] 2
DigitalOcean Spaces سان‌فرانسیسکو ۲
.IP \[bu] 2
ارائه‌دهنده: DigitalOcean
.RE
.IP \[bu] 2
\[dq]fra1.digitaloceanspaces.com\[dq]
.RS 2.IP \[bu] 2
DigitalOcean Spaces فرانکفورت ۱
.IP \[bu] 2
ارائه‌دهنده: DigitalOcean
.RE
.IP \[bu] 2
\[dq]nyc3.digitaloceanspaces.com\[dq]
.RS 2
.IP \[bu] 2
DigitalOcean Spaces نیویورک ۳
.IP \[bu] 2
ارائه‌دهنده: DigitalOcean
.RE
.IP \[bu] 2
\[dq]ams3.digitaloceanspaces.com\[dq]
.RS 2
.IP \[bu] 2
DigitalOcean Spaces آمستردام ۳
.IP \[bu] 2
ارائه‌دهنده: DigitalOcean
.RE
.IP \[bu] 2
\[dq]sgp1.digitaloceanspaces.com\[dq]
.RS 2
.IP \[bu] 2
DigitalOcean Spaces سنگاپور ۱
.IP \[bu] 2
ارائه‌دهنده: DigitalOcean
.RE
.IP \[bu] 2
\[dq]lon1.digitaloceanspaces.com\[dq]
.RS 2
.IP \[bu] 2
DigitalOcean Spaces لندن ۱
.IP \[bu] 2
ارائه‌دهنده: DigitalOcean
.RE
.IP \[bu] 2
\[dq]tor1.digitaloceanspaces.com\[dq]
.RS 2
.IP \[bu] 2
DigitalOcean Spaces تورنتو ۱
.IP \[bu] 2
ارائه‌دهنده: DigitalOcean
.RE
.IP \[bu] 2
\[dq]blr1.digitaloceanspaces.com\[dq]
.RS 2
.IP \[bu] 2
DigitalOcean Spaces بنگلور ۱
.IP \[bu] 2
ارائه‌دهنده: DigitalOcean
.RE
.IP \[bu] 2
\[dq]objects-us-east-1.dream.io\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی Dream Objects
.IP \[bu] 2
ارائه‌دهنده: Dreamhost
.RE
.IP \[bu] 2
\[dq]au-east-1.object.fastlystorage.app\[dq]
.RS 2
.IP \[bu] 2
AU East 1
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]eu-central.object.fastlystorage.app\[dq]
.RS 2
.IP \[bu] 2
EU Central
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]eu-south-1.object.fastlystorage.app\[dq]
.RS 2
.IP \[bu] 2
EU South 1
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]eu-west-1.object.fastlystorage.app\[dq]
.RS 2
.IP \[bu] 2
EU West 1
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]jp-central-1.object.fastlystorage.app\[dq]
.RS 2
.IP \[bu] 2
JP Central 1
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]uk-east-1.object.fastlystorage.app\[dq]
.RS 2
.IP \[bu] 2
UK East 1
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]us-central-1.object.fastlystorage.app\[dq]
.RS 2
.IP \[bu] 2
US Central 1
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]us-east.object.fastlystorage.app\[dq]
.RS 2
.IP \[bu] 2
US East
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]us-east-1.object.fastlystorage.app\[dq]
.RS 2
.IP \[bu] 2
US East 1
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]us-west.object.fastlystorage.app\[dq]
.RS 2
.IP \[bu] 2
US West
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]us-west-1.object.fastlystorage.app\[dq]
.RS 2
.IP \[bu] 2
US West 1
.IP \[bu] 2
ارائه‌دهنده: Fastly
.RE
.IP \[bu] 2
\[dq]s5lu.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی سراسری FileLu S5
.IP \[bu] 2
ارائه‌دهنده: FileLu
.RE
.IP \[bu] 2
\[dq]us.s5lu.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ناحیه آمریکای شمالی (US-East)
.IP \[bu] 2
ارائه‌دهنده: FileLu
.RE
.IP \[bu] 2
\[dq]eu.s5lu.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ناحیه اروپا (EU-Central)
.IP \[bu] 2
ارائه‌دهنده: FileLu
.RE
.IP \[bu] 2
\[dq]ap.s5lu.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ناحیه آسیا و اقیانوسیه (AP-Southeast)
.IP \[bu] 2
ارائه‌دهنده: FileLu
.RE.IP \[bu] 2
\[dq]me.s5lu.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی منطقه خاورمیانه (ME-Central)
.IP \[bu] 2
ارائه‌دهنده: FileLu
.RE
.IP \[bu] 2
\[dq]https://storage.googleapis.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی Google Cloud Storage
.IP \[bu] 2
ارائه‌دهنده: GCS
.RE
.IP \[bu] 2
\[dq]hel1.your-objectstorage.com\[dq]
.RS 2
.IP \[bu] 2
هلسینکی
.IP \[bu] 2
ارائه‌دهنده: Hetzner
.RE
.IP \[bu] 2
\[dq]fsn1.your-objectstorage.com\[dq]
.RS 2
.IP \[bu] 2
فالکن‌اشتاین
.IP \[bu] 2
ارائه‌دهنده: Hetzner
.RE
.IP \[bu] 2
\[dq]nbg1.your-objectstorage.com\[dq]
.RS 2
.IP \[bu] 2
نورنبرگ
.IP \[bu] 2
ارائه‌دهنده: Hetzner
.RE
.IP \[bu] 2
\[dq]obs.af-south-1.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
AF-Johannesburg
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]obs.ap-southeast-2.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
AP-Bangkok
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]obs.ap-southeast-3.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
AP-Singapore
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]obs.cn-east-3.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
CN East-Shanghai1
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]obs.cn-east-2.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
CN East-Shanghai2
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]obs.cn-north-1.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
CN North-Beijing1
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]obs.cn-north-4.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
CN North-Beijing4
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]obs.cn-south-1.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
CN South-Guangzhou
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]obs.ap-southeast-1.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
CN-Hong Kong
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]obs.sa-argentina-1.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
LA-Buenos Aires1
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]obs.sa-peru-1.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
LA-Lima1
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]obs.na-mexico-1.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
LA-Mexico City1
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]obs.sa-chile-1.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
LA-Santiago2
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]obs.sa-brazil-1.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
LA-Sao Paulo1
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]obs.ru-northwest-2.myhuaweicloud.com\[dq]
.RS 2
.IP \[bu] 2
RU-Moscow2
.IP \[bu] 2
ارائه‌دهنده: HuaweiOBS
.RE
.IP \[bu] 2
\[dq]s3.us.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی فرامنطقه‌ای ایالات متحده (US Cross Region)
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.dal.us.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی دالاس در فرامنطقه‌ای ایالات متحده (US Cross Region Dallas)
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.wdc.us.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی واشینگتن دی‌سی در فرامنطقه‌ای ایالات متحده (US Cross Region Washington DC).IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.sjc.us.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی بین‌منطقه‌ای سن خوزه ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.us.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی بین‌منطقه‌ای ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.dal.us.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی بین‌منطقه‌ای دالاس ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.wdc.us.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی بین‌منطقه‌ای واشینگتن دی‌سی ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.sjc.us.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی بین‌منطقه‌ای سن خوزه ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.us-east.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی منطقه شرق ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.us-east.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی منطقه شرق ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.us-south.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی منطقه جنوب ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.us-south.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی منطقه جنوب ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.eu.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی بین‌منطقه‌ای اروپا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.fra.eu.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی بین‌منطقه‌ای فرانکفورت اروپا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.mil.eu.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی بین‌منطقه‌ای میلان اروپا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.ams.eu.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی بین‌منطقه‌ای آمستردام اروپا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.eu.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی بین‌منطقه‌ای اروپا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.fra.eu.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی بین‌منطقه‌ای فرانکفورت اروپا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.mil.eu.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی بین‌منطقه‌ای میلان اروپا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.ams.eu.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی بین‌منطقه‌ای آمستردام اروپا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.eu-gb.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی بریتانیا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.eu-gb.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی بریتانیا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.eu-de.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی منطقه DE اروپا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.eu-de.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی منطقه DE اروپا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.ap.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی بین‌منطقه‌ای APAC
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.tok.ap.cloud-object-storage.appdomain.cloud\[dq]
.RS 2.IP \[bu] 2
نقطه پایانی فرامنطقه‌ای توکیو APAC
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.hkg.ap.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی فرامنطقه‌ای هنگ‌کنگ APAC
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.seo.ap.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی فرامنطقه‌ای سئول APAC
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.ap.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی فرامنطقه‌ای APAC
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.tok.ap.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی فرامنطقه‌ای توکیو APAC
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.hkg.ap.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی فرامنطقه‌ای هنگ‌کنگ APAC
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.seo.ap.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی فرامنطقه‌ای سئول APAC
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.jp-tok.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی منطقه‌ای ژاپن APAC
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.jp-tok.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی منطقه‌ای ژاپن APAC
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.au-syd.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی منطقه‌ای استرالیا APAC
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.au-syd.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی منطقه‌ای استرالیا APAC
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.ams03.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی تک‌سایتی آمستردام
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.ams03.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی تک‌سایتی آمستردام
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.che01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی تک‌سایتی چنای
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.che01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی تک‌سایتی چنای
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.mel01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی تک‌سایتی ملبورن
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.mel01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی تک‌سایتی ملبورن
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.osl01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی تک‌سایتی اسلو
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.osl01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی تک‌سایتی اسلو
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.tor01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی تک‌سایتی تورنتو
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.tor01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی تک‌سایتی تورنتو
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.seo01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی تک‌سایتی سئول
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.seo01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی تک‌سایتی سئول
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE.IP \[bu] 2
\[dq]s3.mon01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی تک‌سایتی مونترال
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.mon01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی تک‌سایتی مونترال
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.mex01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی تک‌سایتی مکزیک
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.mex01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی تک‌سایتی مکزیک
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.sjc04.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی تک‌سایتی سن خوزه
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.sjc04.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی تک‌سایتی سن خوزه
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.mil01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی تک‌سایتی میلان
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.mil01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی تک‌سایتی میلان
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.hkg02.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی تک‌سایتی هنگ‌کنگ
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.hkg02.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی تک‌سایتی هنگ‌کنگ
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.par01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی تک‌سایتی پاریس
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.par01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی تک‌سایتی پاریس
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.sng01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی تک‌سایتی سنگاپور
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]s3.private.sng01.cloud-object-storage.appdomain.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی خصوصی تک‌سایتی سنگاپور
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]eu-central-2.storage.impossibleapi.net\[dq]
.RS 2
.IP \[bu] 2
فرانکفورت، آلمان
.IP \[bu] 2
ارائه‌دهنده: ImpossibleCloud
.RE
.IP \[bu] 2
\[dq]eu-west-1.storage.impossibleapi.net\[dq]
.RS 2
.IP \[bu] 2
آمستردام، هلند
.IP \[bu] 2
ارائه‌دهنده: ImpossibleCloud
.RE
.IP \[bu] 2
\[dq]eu-west-2.storage.impossibleapi.net\[dq]
.RS 2
.IP \[bu] 2
لندن، بریتانیا
.IP \[bu] 2
ارائه‌دهنده: ImpossibleCloud
.RE
.IP \[bu] 2
\[dq]eu-west-3.storage.impossibleapi.net\[dq]
.RS 2
.IP \[bu] 2
پاریس، فرانسه
.IP \[bu] 2
ارائه‌دهنده: ImpossibleCloud
.RE
.IP \[bu] 2
\[dq]eu-east-1.storage.impossibleapi.net\[dq]
.RS 2
.IP \[bu] 2
پوزنان، لهستان
.IP \[bu] 2
ارائه‌دهنده: ImpossibleCloud
.RE
.IP \[bu] 2
\[dq]eu-north-1.storage.impossibleapi.net\[dq]
.RS 2
.IP \[bu] 2
کپنهاگ، دانمارک
.IP \[bu] 2
ارائه‌دهنده: ImpossibleCloud
.RE
.IP \[bu] 2
\[dq]us-east-1.storage.impossibleapi.net\[dq]
.RS 2
.IP \[bu] 2
نیویورک، ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: ImpossibleCloud
.RE
.IP \[bu] 2
\[dq]de-fra.i3storage.com\[dq]
.RS 2
.IP \[bu] 2
فرانکفورت، آلمان
.IP \[bu] 2
ارائه‌دهنده: Intercolo
.RE
.IP \[bu] 2
\[dq]s3.eu-central-1.ionoscloud.com\[dq]
.RS 2
.IP \[bu] 2
فرانکفورت، آلمان.IP \[bu] 2
ارائه‌دهنده: IONOS
.RE
.IP \[bu] 2
\[dq]s3.eu-central-2.ionoscloud.com\[dq]
.RS 2
.IP \[bu] 2
برلین، آلمان
.IP \[bu] 2
ارائه‌دهنده: IONOS
.RE
.IP \[bu] 2
\[dq]s3.eu-central-3.ionoscloud.com\[dq]
.RS 2
.IP \[bu] 2
برلین، آلمان
.IP \[bu] 2
ارائه‌دهنده: IONOS
.RE
.IP \[bu] 2
\[dq]s3.eu-central-4.ionoscloud.com\[dq]
.RS 2
.IP \[bu] 2
فرانکفورت، آلمان
.IP \[bu] 2
ارائه‌دهنده: IONOS
.RE
.IP \[bu] 2
\[dq]s3.eu-south-2.ionoscloud.com\[dq]
.RS 2
.IP \[bu] 2
لوگرونیو، اسپانیا
.IP \[bu] 2
ارائه‌دهنده: IONOS
.RE
.IP \[bu] 2
\[dq]s3.us-central-1.ionoscloud.com\[dq]
.RS 2
.IP \[bu] 2
لنکسا، آمریکا
.IP \[bu] 2
ارائه‌دهنده: IONOS
.RE
.IP \[bu] 2
\[dq]s3.leviia.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی پیش‌فرض
.IP \[bu] 2
Leviia
.IP \[bu] 2
ارائه‌دهنده: Leviia
.RE
.IP \[bu] 2
\[dq]storage.iran.liara.space\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی پیش‌فرض
.IP \[bu] 2
ایران
.IP \[bu] 2
ارائه‌دهنده: Liara
.RE
.IP \[bu] 2
\[dq]nl-ams-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
آمستردام، NL (nl-ams-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]us-southeast-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
آتلانتا، GA، US (us-southeast-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]in-maa-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
چنای، IN (in-maa-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]us-ord-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
شیکاگو، IL، US (us-ord-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]eu-central-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
فرانکفورت، DE (eu-central-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]id-cgk-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
جاکارتا، ID (id-cgk-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]gb-lon-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
لندن 2، UK (gb-lon-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]us-lax-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
لس‌آنجلس، CA، US (us-lax-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]es-mad-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
مادرید، ES (es-mad-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]us-mia-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
میامی، FL، US (us-mia-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]it-mil-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
میلان، IT (it-mil-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]us-east-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
نیوآرک، NJ، US (us-east-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]jp-osa-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
اوساکا، JP (jp-osa-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]fr-par-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
پاریس، FR (fr-par-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]br-gru-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
سائوپائولو، BR (br-gru-1).IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]us-sea-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
سیاتل، WA، ایالات متحده (us-sea-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]ap-south-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
سنگاپور، SG (ap-south-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]sg-sin-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
سنگاپور ۲، SG (sg-sin-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]se-sto-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
استکهلم، SE (se-sto-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]jp-tyo-1.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
توکیو ۳، JP (jp-tyo-1)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]us-iad-10.linodeobjects.com\[dq]
.RS 2
.IP \[bu] 2
واشینگتن، DC، ایالات متحده (us-iad-10)
.IP \[bu] 2
ارائه‌دهنده: Linode
.RE
.IP \[bu] 2
\[dq]s3.us-west-1.{account_name}.lyve.seagate.com\[dq]
.RS 2
.IP \[bu] 2
US West 1 \- کالیفرنیا
.IP \[bu] 2
ارائه‌دهنده: LyveCloud
.RE
.IP \[bu] 2
\[dq]s3.eu-west-1.{account_name}.lyve.seagate.com\[dq]
.RS 2
.IP \[bu] 2
EU West 1 \- ایرلند
.IP \[bu] 2
ارائه‌دهنده: LyveCloud
.RE
.IP \[bu] 2
\[dq]br-se1.magaluobjects.com\[dq]
.RS 2
.IP \[bu] 2
سائو پائولو، SP (BR)، br-se1
.IP \[bu] 2
ارائه‌دهنده: Magalu
.RE
.IP \[bu] 2
\[dq]br-ne1.magaluobjects.com\[dq]
.RS 2
.IP \[bu] 2
فورتالزا، CE (BR)، br-ne1
.IP \[bu] 2
ارائه‌دهنده: Magalu
.RE
.IP \[bu] 2
\[dq]s3.eu-luxembourg-1.megas4.com\[dq]
.RS 2
.IP \[bu] 2
Mega S4 لوکزامبورگ ۱
.IP \[bu] 2
ارائه‌دهنده: Mega
.RE
.IP \[bu] 2
\[dq]s3.eu-luxembourg-2.megas4.com\[dq]
.RS 2
.IP \[bu] 2
Mega S4 لوکزامبورگ ۲
.IP \[bu] 2
ارائه‌دهنده: Mega
.RE
.IP \[bu] 2
\[dq]s3.eu-amsterdam-1.megas4.com\[dq]
.RS 2
.IP \[bu] 2
Mega S4 آمستردام ۱
.IP \[bu] 2
ارائه‌دهنده: Mega
.RE
.IP \[bu] 2
\[dq]s3.eu-amsterdam-2.megas4.com\[dq]
.RS 2
.IP \[bu] 2
Mega S4 آمستردام ۲
.IP \[bu] 2
ارائه‌دهنده: Mega
.RE
.IP \[bu] 2
\[dq]s3.eu-paris-1.megas4.com\[dq]
.RS 2
.IP \[bu] 2
Mega S4 پاریس ۱
.IP \[bu] 2
ارائه‌دهنده: Mega
.RE
.IP \[bu] 2
\[dq]s3.eu-paris-2.megas4.com\[dq]
.RS 2
.IP \[bu] 2
Mega S4 پاریس ۲
.IP \[bu] 2
ارائه‌دهنده: Mega
.RE
.IP \[bu] 2
\[dq]s3.eu-barcelona-1.megas4.com\[dq]
.RS 2
.IP \[bu] 2
Mega S4 بارسلونا ۱
.IP \[bu] 2
ارائه‌دهنده: Mega
.RE
.IP \[bu] 2
\[dq]s3.eu-barcelona-2.megas4.com\[dq]
.RS 2
.IP \[bu] 2
Mega S4 بارسلونا ۲
.IP \[bu] 2
ارائه‌دهنده: Mega
.RE
.IP \[bu] 2
\[dq]s3.ca-montreal-1.megas4.com\[dq]
.RS 2
.IP \[bu] 2
Mega S4 مونترال ۱
.IP \[bu] 2
ارائه‌دهنده: Mega
.RE
.IP \[bu] 2
\[dq]s3.ca-montreal-2.megas4.com\[dq]
.RS 2
.IP \[bu] 2
Mega S4 مونترال ۲
.IP \[bu] 2
ارائه‌دهنده: Mega
.RE
.IP \[bu] 2
\[dq]s3.ca-vancouver-1.megas4.com\[dq]
.RS 2
.IP \[bu] 2
Mega S4 ونکوور ۱
.IP \[bu] 2
ارائه‌دهنده: Mega
.RE
.IP \[bu] 2
\[dq]s3.ca-vancouver-2.megas4.com\[dq]
.RS 2
.IP \[bu] 2
Mega S4 ونکوور ۲
.IP \[bu] 2
ارائه‌دهنده: Mega
.RE
.IP \[bu] 2
\[dq]s3.ap-tokyo-1.megas4.com\[dq]
.RS 2.IP \[bu] 2
Mega S4 توکیو ۱
.IP \[bu] 2
ارائه‌دهنده: Mega
.RE
.IP \[bu] 2
\[dq]s3.ap-tokyo-2.megas4.com\[dq]
.RS 2
.IP \[bu] 2
Mega S4 توکیو ۲
.IP \[bu] 2
ارائه‌دهنده: Mega
.RE
.IP \[bu] 2
\[dq]oos.eu-west-2.outscale.com\[dq]
.RS 2
.IP \[bu] 2
Outscale EU West 2 (پاریس)
.IP \[bu] 2
ارائه‌دهنده: Outscale
.RE
.IP \[bu] 2
\[dq]oos.us-east-2.outscale.com\[dq]
.RS 2
.IP \[bu] 2
Outscale US east 2 (نیوجرسی)
.IP \[bu] 2
ارائه‌دهنده: Outscale
.RE
.IP \[bu] 2
\[dq]oos.us-west-1.outscale.com\[dq]
.RS 2
.IP \[bu] 2
Outscale EU West 1 (کالیفرنیا)
.IP \[bu] 2
ارائه‌دهنده: Outscale
.RE
.IP \[bu] 2
\[dq]oos.cloudgouv-eu-west-1.outscale.com\[dq]
.RS 2
.IP \[bu] 2
Outscale SecNumCloud (پاریس)
.IP \[bu] 2
ارائه‌دهنده: Outscale
.RE
.IP \[bu] 2
\[dq]oos.ap-northeast-1.outscale.com\[dq]
.RS 2
.IP \[bu] 2
Outscale AP Northeast 1 (ژاپن)
.IP \[bu] 2
ارائه‌دهنده: Outscale
.RE
.IP \[bu] 2
\[dq]s3.gra.io.cloud.ovh.net\[dq]
.RS 2
.IP \[bu] 2
OVHcloud گراولین، فرانسه
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.rbx.io.cloud.ovh.net\[dq]
.RS 2
.IP \[bu] 2
OVHcloud روبه، فرانسه
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.sbg.io.cloud.ovh.net\[dq]
.RS 2
.IP \[bu] 2
OVHcloud استراسبورگ، فرانسه
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.eu-west-par.io.cloud.ovh.net\[dq]
.RS 2
.IP \[bu] 2
OVHcloud پاریس، فرانسه (3AZ)
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.de.io.cloud.ovh.net\[dq]
.RS 2
.IP \[bu] 2
OVHcloud فرانکفورت، آلمان
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.uk.io.cloud.ovh.net\[dq]
.RS 2
.IP \[bu] 2
OVHcloud لندن، بریتانیا
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.waw.io.cloud.ovh.net\[dq]
.RS 2
.IP \[bu] 2
OVHcloud ورشو، لهستان
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.bhs.io.cloud.ovh.net\[dq]
.RS 2
.IP \[bu] 2
OVHcloud بوارنوا، کانادا
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.ca-east-tor.io.cloud.ovh.net\[dq]
.RS 2
.IP \[bu] 2
OVHcloud تورنتو، کانادا
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.sgp.io.cloud.ovh.net\[dq]
.RS 2
.IP \[bu] 2
OVHcloud سنگاپور
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.ap-southeast-syd.io.cloud.ovh.net\[dq]
.RS 2
.IP \[bu] 2
OVHcloud سیدنی، استرالیا
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.ap-south-mum.io.cloud.ovh.net\[dq]
.RS 2
.IP \[bu] 2
OVHcloud بمبئی، هند
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.us-east-va.io.cloud.ovh.us\[dq]
.RS 2
.IP \[bu] 2
OVHcloud وینت هیل، ویرجینیا، ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.us-west-or.io.cloud.ovh.us\[dq]
.RS 2
.IP \[bu] 2
OVHcloud هیلزبورو، اورگان، ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.rbx-archive.io.cloud.ovh.net\[dq]
.RS 2
.IP \[bu] 2
OVHcloud روبه، فرانسه (Cold Archive)
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]s3.petabox.io\[dq]
.RS 2
.IP \[bu] 2
US East (ویرجینیای
شمالی)
.IP \[bu] 2
ارائه‌دهنده: Petabox
.RE.IP \[bu] 2
\[dq]s3.us-east-1.petabox.io\[dq]
.RS 2
.IP \[bu] 2
شرق ایالات متحده (ویرجینیای
شمالی)
.IP \[bu] 2
ارائه‌دهنده: Petabox
.RE
.IP \[bu] 2
\[dq]s3.eu-central-1.petabox.io\[dq]
.RS 2
.IP \[bu] 2
اروپا (فرانکفورت)
.IP \[bu] 2
ارائه‌دهنده: Petabox
.RE
.IP \[bu] 2
\[dq]s3.ap-southeast-1.petabox.io\[dq]
.RS 2
.IP \[bu] 2
آسیا و اقیانوسیه (سنگاپور)
.IP \[bu] 2
ارائه‌دهنده: Petabox
.RE
.IP \[bu] 2
\[dq]s3.me-south-1.petabox.io\[dq]
.RS 2
.IP \[bu] 2
خاورمیانه (بحرین)
.IP \[bu] 2
ارائه‌دهنده: Petabox
.RE
.IP \[bu] 2
\[dq]s3.sa-east-1.petabox.io\[dq]
.RS 2
.IP \[bu] 2
آمریکای جنوبی (سائو پائولو)
.IP \[bu] 2
ارائه‌دهنده: Petabox
.RE
.IP \[bu] 2
\[dq]s3-cn-east-1.qiniucs.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ۱ شرق چین
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]s3-cn-east-2.qiniucs.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ۲ شرق چین
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]s3-cn-north-1.qiniucs.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ۱ شمال چین
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]s3-cn-south-1.qiniucs.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ۱ جنوب چین
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]s3-us-north-1.qiniucs.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ۱ آمریکای شمالی
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]s3-ap-southeast-1.qiniucs.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ۱ جنوب شرقی آسیا
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]s3-ap-northeast-1.qiniucs.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ۱ شمال شرقی آسیا
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]s3.us-east-1.rabata.io\[dq]
.RS 2
.IP \[bu] 2
شرق ایالات متحده (ویرجینیای
شمالی)
.IP \[bu] 2
ارائه‌دهنده: Rabata
.RE
.IP \[bu] 2
\[dq]s3.eu-west-1.rabata.io\[dq]
.RS 2
.IP \[bu] 2
غرب اروپا (ایرلند)
.IP \[bu] 2
ارائه‌دهنده: Rabata
.RE
.IP \[bu] 2
\[dq]s3.eu-west-2.rabata.io\[dq]
.RS 2
.IP \[bu] 2
غرب اروپا (لندن)
.IP \[bu] 2
ارائه‌دهنده: Rabata
.RE
.IP \[bu] 2
\[dq]s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی سراسری (AnyCast)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی استرالیا (Anycast)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au-nsw.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی سیدنی (استرالیا)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au-qld.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی بریزبن (استرالیا)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au-vic.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ملبورن (استرالیا)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au-wa.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی پرث (استرالیا)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]ph.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی مانیل (فیلیپین)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]th.s3.rackcorp.com\[dq]
.RS 2.IP \[bu] 2
نقطه پایانی بانکوک (تایلند)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]hk.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی هنگ‌کنگ (HK)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]mn.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی اولان‌باتور (مغولستان)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]kg.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی بیشکک (قرقیزستان)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]id.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی جاکارتا (اندونزی)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]jp.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی توکیو (ژاپن)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]sg.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی سنگاپور (SG)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]de.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی فرانکفورت (آلمان)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]us.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ایالات متحده (AnyCast)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]us-east-1.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی نیویورک (ایالات متحده)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]us-west-1.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی فریمونت (ایالات متحده)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]nz.s3.rackcorp.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی اوکلند (نیوزیلند)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]s3.nl-ams.scw.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی آمستردام
.IP \[bu] 2
ارائه‌دهنده: Scaleway
.RE
.IP \[bu] 2
\[dq]s3.fr-par.scw.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی پاریس
.IP \[bu] 2
ارائه‌دهنده: Scaleway
.RE
.IP \[bu] 2
\[dq]s3.pl-waw.scw.cloud\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ورشو
.IP \[bu] 2
ارائه‌دهنده: Scaleway
.RE
.IP \[bu] 2
\[dq]localhost:8333\[dq]
.RS 2
.IP \[bu] 2
SeaweedFS S3 localhost
.IP \[bu] 2
ارائه‌دهنده: SeaweedFS
.RE
.IP \[bu] 2
\[dq]s3.ru-1.storage.selcloud.ru\[dq]
.RS 2
.IP \[bu] 2
سنت پترزبورگ
.IP \[bu] 2
ارائه‌دهنده: Selectel
.RE
.IP \[bu] 2
\[dq]s3.ru-3.storage.selcloud.ru\[dq]
.RS 2
.IP \[bu] 2
سنت پترزبورگ
.IP \[bu] 2
ارائه‌دهنده: Selectel
.RE
.IP \[bu] 2
\[dq]s3.ru-7.storage.selcloud.ru\[dq]
.RS 2
.IP \[bu] 2
مسکو
.IP \[bu] 2
ارائه‌دهنده: Selectel,Servercore
.RE
.IP \[bu] 2
\[dq]s3.gis-1.storage.selcloud.ru\[dq]
.RS 2
.IP \[bu] 2
مسکو
.IP \[bu] 2
ارائه‌دهنده: Selectel,Servercore
.RE
.IP \[bu] 2
\[dq]s3.kz-1.storage.selcloud.ru\[dq]
.RS 2
.IP \[bu] 2
قزاقستان
.IP \[bu] 2
ارائه‌دهنده: Selectel
.RE
.IP \[bu] 2
\[dq]s3.uz-2.storage.selcloud.ru\[dq]
.RS 2
.IP \[bu] 2
ازبکستان
.IP \[bu] 2
ارائه‌دهنده: Selectel
.RE
.IP \[bu] 2
\[dq]s3.ru-1.storage.selcloud.ru\[dq]
.RS 2
.IP \[bu] 2
سنت پترزبورگ.IP \[bu] 2
ارائه‌دهنده: Servercore
.RE
.IP \[bu] 2
\[dq]s3.uz-2.srvstorage.uz\[dq]
.RS 2
.IP \[bu] 2
تاشکند، ازبکستان
.IP \[bu] 2
ارائه‌دهنده: Servercore
.RE
.IP \[bu] 2
\[dq]s3.kz-1.srvstorage.kz\[dq]
.RS 2
.IP \[bu] 2
آلماتی، قزاقستان
.IP \[bu] 2
ارائه‌دهنده: Servercore
.RE
.IP \[bu] 2
\[dq]gateway.storjshare.io\[dq]
.RS 2
.IP \[bu] 2
درگاه میزبانی‌شده جهانی
.IP \[bu] 2
ارائه‌دهنده: Storj
.RE
.IP \[bu] 2
\[dq]eu-001.s3.synologyc2.net\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ۱ اروپا (EU)
.IP \[bu] 2
ارائه‌دهنده: Synology
.RE
.IP \[bu] 2
\[dq]eu-002.s3.synologyc2.net\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ۲ اروپا (EU)
.IP \[bu] 2
ارائه‌دهنده: Synology
.RE
.IP \[bu] 2
\[dq]us-001.s3.synologyc2.net\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ۱ ایالات متحده (US)
.IP \[bu] 2
ارائه‌دهنده: Synology
.RE
.IP \[bu] 2
\[dq]us-002.s3.synologyc2.net\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ۲ ایالات متحده (US)
.IP \[bu] 2
ارائه‌دهنده: Synology
.RE
.IP \[bu] 2
\[dq]tw-001.s3.synologyc2.net\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی ۱ تایوان (TW)
.IP \[bu] 2
ارائه‌دهنده: Synology
.RE
.IP \[bu] 2
\[dq]cos.ap-beijing.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه پکن
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.ap-nanjing.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه نانجینگ
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.ap-shanghai.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه شانگهای
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.ap-guangzhou.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه گوانگ‌ژو
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.ap-chengdu.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه چنگدو
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.ap-chongqing.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه چونگ‌چینگ
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.ap-hongkong.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه هنگ‌کنگ (چین)
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.ap-singapore.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه سنگاپور
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.ap-mumbai.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه بمبئی
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.ap-seoul.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه سئول
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.ap-bangkok.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه بانکوک
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.ap-tokyo.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه توکیو
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.na-siliconvalley.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه دره سیلیکون
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.na-ashburn.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه ویرجینیا
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.na-toronto.myqcloud.com\[dq]
.RS 2.IP \[bu] 2
منطقه تورنتو
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.eu-frankfurt.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه فرانکفورت
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.eu-moscow.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
منطقه مسکو
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]cos.accelerate.myqcloud.com\[dq]
.RS 2
.IP \[bu] 2
استفاده از نقطه پایانی شتاب‌دهنده Tencent COS
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.IP \[bu] 2
\[dq]s3-cn-bj.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
شمال چین (پکن ۲)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-cn-wlcb.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
شمال چین (اولانچاب)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-cn-sh2.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
شانگهای
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-cn-gd.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
جنوب چین (گوانگ‌ژو)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-hk.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
هنگ‌کنگ
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-us-ca.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
ایالات متحده (لس‌آنجلس)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-sg.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
سنگاپور
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-idn-jakarta.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
اندونزی (جاکارتا)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-tw-tp.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
تایوان (تایپه)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-afr-nigeria.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
نیجریه (لاگوس)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-bra-saopaulo.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
برزیل (سائوپائولو)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-uae-dubai.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
امارات متحده عربی (دبی)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-ge-fra.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
آلمان (فرانکفورت)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-vn-sng.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
ویتنام (شهر هوشی‌مین)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-us-ws.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
ایالات متحده (واشینگتن)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-ind-mumbai.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
هند (بمبئی)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-kr-seoul.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
سئول (کره جنوبی)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-jpn-tky.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
ژاپن (توکیو)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-th-bkk.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
بانکوک (تایلند)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE.IP \[bu] 2
\[dq]s3-uk-london.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
بریتانیا (لندن)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-rus-mosc.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
روسیه (مسکو)
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-cn-guiyang1.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
گوی‌یانگ ۱
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3-pk-khi.ufileos.com\[dq]
.RS 2
.IP \[bu] 2
پاکستان
.IP \[bu] 2
ارائه‌دهنده: US3
.RE
.IP \[bu] 2
\[dq]s3.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
Wasabi US East 1 (ویرجینیای
شمالی)
.IP \[bu] 2
ارائه‌دهنده: Wasabi
.RE
.IP \[bu] 2
\[dq]s3.us-east-2.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
Wasabi US East 2 (ویرجینیای
شمالی)
.IP \[bu] 2
ارائه‌دهنده: Wasabi
.RE
.IP \[bu] 2
\[dq]s3.us-central-1.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
Wasabi US Central 1 (تگزاس)
.IP \[bu] 2
ارائه‌دهنده: Wasabi
.RE
.IP \[bu] 2
\[dq]s3.us-west-1.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
Wasabi US West 1 (اورگن)
.IP \[bu] 2
ارائه‌دهنده: Wasabi
.RE
.IP \[bu] 2
\[dq]s3.ca-central-1.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
Wasabi CA Central 1 (تورنتو)
.IP \[bu] 2
ارائه‌دهنده: Wasabi
.RE
.IP \[bu] 2
\[dq]s3.eu-central-1.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
Wasabi EU Central 1 (آمستردام)
.IP \[bu] 2
ارائه‌دهنده: Wasabi
.RE
.IP \[bu] 2
\[dq]s3.eu-central-2.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
Wasabi EU Central 2 (فرانکفورت)
.IP \[bu] 2
ارائه‌دهنده: Wasabi
.RE
.IP \[bu] 2
\[dq]s3.eu-west-1.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
Wasabi EU West 1 (لندن)
.IP \[bu] 2
ارائه‌دهنده: Wasabi
.RE
.IP \[bu] 2
\[dq]s3.eu-west-2.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
Wasabi EU West 2 (پاریس)
.IP \[bu] 2
ارائه‌دهنده: Wasabi
.RE
.IP \[bu] 2
\[dq]s3.eu-south-1.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
Wasabi EU South 1 (میلان)
.IP \[bu] 2
ارائه‌دهنده: Wasabi
.RE
.IP \[bu] 2
\[dq]s3.ap-northeast-1.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی Wasabi AP Northeast 1 (توکیو)
.IP \[bu] 2
ارائه‌دهنده: Wasabi
.RE
.IP \[bu] 2
\[dq]s3.ap-northeast-2.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی Wasabi AP Northeast 2 (اوساکا)
.IP \[bu] 2
ارائه‌دهنده: Wasabi
.RE
.IP \[bu] 2
\[dq]s3.ap-southeast-1.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
Wasabi AP Southeast 1 (سنگاپور)
.IP \[bu] 2
ارائه‌دهنده: Wasabi
.RE
.IP \[bu] 2
\[dq]s3.ap-southeast-2.wasabisys.com\[dq]
.RS 2
.IP \[bu] 2
Wasabi AP Southeast 2 (سیدنی)
.IP \[bu] 2
ارائه‌دهنده: Wasabi
.RE
.IP \[bu] 2
\[dq]idr01.zata.ai\[dq]
.RS 2
.IP \[bu] 2
نقطه پایانی جنوب آسیا
.IP \[bu] 2
ارائه‌دهنده: Zata
.RE
.IP \[bu] 2
\[dq]fra1.s3.zeroservices.eu\[dq]
.RS 2
.IP \[bu] 2
فرانکفورت ۱
.IP \[bu] 2
ارائه‌دهنده: ZeroServices
.RE
.IP \[bu] 2
\[dq]fra.s3.zeroservices.eu\[dq]
.RS 2
.IP \[bu] 2
فرانکفورت ۲
.IP \[bu] 2
ارائه‌دهنده: ZeroServices
.RE
.IP \[bu] 2
\[dq]eyl1.s3.zeroservices.eu\[dq]
.RS 2
.IP \[bu] 2
Eyl 1
.IP \[bu] 2
ارائه‌دهنده: ZeroServices
.RE
.RE.SS --s3-location-constraint
.PP
محدودیت مکانی \- باید متناسب با Region تنظیم شود.
.PP
اگر مطمئن نیستید، خالی بگذارید.
تنها هنگام ایجاد باکت‌ها استفاده می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: location_constraint
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_LOCATION_CONSTRAINT
.IP \[bu] 2
ارائه‌دهنده:
AWS,ArvanCloud,Ceph,ChinaMobile,DigitalOcean,Dreamhost,Exaba,GCS,HCP,Hetzner,IBMCOS,ImpossibleCloud,LyveCloud,Minio,Netease,Qiniu,Rabata,RackCorp,Scality,SeaweedFS,Synology,Wasabi,Zata,ZeroServices,Other
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
خالی برای US Region، ویرجینیای شمالی، یا شمال‌غربی اقیانوس آرام
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]us-east-2\[dq]
.RS 2
.IP \[bu] 2
منطقه US East (اوهایو)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]us-west-1\[dq]
.RS 2
.IP \[bu] 2
منطقه US West (کالیفرنیای شمالی)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]us-west-2\[dq]
.RS 2
.IP \[bu] 2
منطقه US West (اورگن)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ca-central-1\[dq]
.RS 2
.IP \[bu] 2
منطقه Canada (مرکزی)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]eu-west-1\[dq]
.RS 2
.IP \[bu] 2
منطقه EU (ایرلند)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]eu-west-2\[dq]
.RS 2
.IP \[bu] 2
منطقه EU (لندن)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]eu-west-3\[dq]
.RS 2
.IP \[bu] 2
منطقه EU (پاریس)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]eu-north-1\[dq]
.RS 2
.IP \[bu] 2
منطقه EU (استکهلم)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]eu-south-1\[dq]
.RS 2
.IP \[bu] 2
منطقه EU (میلان)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]EU\[dq]
.RS 2
.IP \[bu] 2
منطقه EU
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ap-southeast-1\[dq]
.RS 2
.IP \[bu] 2
منطقه آسیا و اقیانوسیه (سنگاپور)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ap-southeast-2\[dq]
.RS 2
.IP \[bu] 2
منطقه آسیا و اقیانوسیه (سیدنی)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ap-northeast-1\[dq]
.RS 2
.IP \[bu] 2
منطقه آسیا و اقیانوسیه (توکیو)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ap-northeast-2\[dq]
.RS 2
.IP \[bu] 2
منطقه آسیا و اقیانوسیه (سئول)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ap-northeast-3\[dq]
.RS 2
.IP \[bu] 2
منطقه آسیا و اقیانوسیه (Osaka-Local)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ap-south-1\[dq]
.RS 2
.IP \[bu] 2
منطقه آسیا و اقیانوسیه (بمبئی)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ap-east-1\[dq]
.RS 2
.IP \[bu] 2
منطقه آسیا و اقیانوسیه (هنگ‌کنگ)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]sa-east-1\[dq]
.RS 2
.IP \[bu] 2
منطقه آمریکای جنوبی (سائوپائولو)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]il-central-1\[dq]
.RS 2
.IP \[bu] 2
منطقه اسرائیل (تل‌آویو)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE.IP \[bu] 2
\[dq]me-south-1\[dq]
.RS 2
.IP \[bu] 2
منطقه خاورمیانه (بحرین)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]af-south-1\[dq]
.RS 2
.IP \[bu] 2
منطقه آفریقا (کیپ‌تاون)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]cn-north-1\[dq]
.RS 2
.IP \[bu] 2
منطقه چین (پکن)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]cn-northwest-1\[dq]
.RS 2
.IP \[bu] 2
منطقه چین (نینگ‌شیا)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]us-gov-east-1\[dq]
.RS 2
.IP \[bu] 2
منطقه AWS GovCloud (شرق آمریکا)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]us-gov-west-1\[dq]
.RS 2
.IP \[bu] 2
منطقه AWS GovCloud (آمریکا)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]ir-thr-at1\[dq]
.RS 2
.IP \[bu] 2
تهران، ایران (سیمین)
.IP \[bu] 2
ارائه‌دهنده: ArvanCloud
.RE
.IP \[bu] 2
\[dq]ir-tbz-sh1\[dq]
.RS 2
.IP \[bu] 2
تبریز، ایران (شهریار)
.IP \[bu] 2
ارائه‌دهنده: ArvanCloud
.RE
.IP \[bu] 2
\[dq]wuxi1\[dq]
.RS 2
.IP \[bu] 2
شرق چین (سوژو)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]jinan1\[dq]
.RS 2
.IP \[bu] 2
شرق چین (جینان)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]ningbo1\[dq]
.RS 2
.IP \[bu] 2
شرق چین (هانگژو)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]shanghai1\[dq]
.RS 2
.IP \[bu] 2
شرق چین (شانگهای\-۱)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]zhengzhou1\[dq]
.RS 2
.IP \[bu] 2
مرکز چین (ژنگژو)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]hunan1\[dq]
.RS 2
.IP \[bu] 2
مرکز چین (چانگشا\-۱)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]zhuzhou1\[dq]
.RS 2
.IP \[bu] 2
مرکز چین (چانگشا\-۲)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]guangzhou1\[dq]
.RS 2
.IP \[bu] 2
جنوب چین (گوانگژو\-۲)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]dongguan1\[dq]
.RS 2
.IP \[bu] 2
جنوب چین (گوانگژو\-۳)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]beijing1\[dq]
.RS 2
.IP \[bu] 2
شمال چین (پکن\-۱)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]beijing2\[dq]
.RS 2
.IP \[bu] 2
شمال چین (پکن\-۲)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]beijing4\[dq]
.RS 2
.IP \[bu] 2
شمال چین (پکن\-۳)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]huhehaote1\[dq]
.RS 2
.IP \[bu] 2
شمال چین (هوهوت)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]chengdu1\[dq]
.RS 2
.IP \[bu] 2
جنوب غربی چین (چنگدو)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]chongqing1\[dq]
.RS 2
.IP \[bu] 2
جنوب غربی چین (چونگ‌چینگ).IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]guiyang1\[dq]
.RS 2
.IP \[bu] 2
جنوب‌غربی چین (گوی‌یانگ)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]xian1\[dq]
.RS 2
.IP \[bu] 2
شمال‌غربی چین (شی‌آن)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]yunnan\[dq]
.RS 2
.IP \[bu] 2
یون‌نان چین (کون‌مینگ)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]yunnan2\[dq]
.RS 2
.IP \[bu] 2
یون‌نان چین (کون‌مینگ\-۲)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]tianjin1\[dq]
.RS 2
.IP \[bu] 2
تیانجین چین (تیانجین)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]jilin1\[dq]
.RS 2
.IP \[bu] 2
جی‌لین چین (چانگچون)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]hubei1\[dq]
.RS 2
.IP \[bu] 2
هوبئی چین (شیانگ‌یان)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]jiangxi1\[dq]
.RS 2
.IP \[bu] 2
جیانگ‌شی چین (نان‌چانگ)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]gansu1\[dq]
.RS 2
.IP \[bu] 2
گانسو چین (لانژو)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]shanxi1\[dq]
.RS 2
.IP \[bu] 2
شانشی چین (تای‌یوان)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]liaoning1\[dq]
.RS 2
.IP \[bu] 2
لیائونینگ چین (شن‌یانگ)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]hebei1\[dq]
.RS 2
.IP \[bu] 2
هبئی چین (شیجیاژوانگ)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]fujian1\[dq]
.RS 2
.IP \[bu] 2
فوجیان چین (شیامن)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]guangxi1\[dq]
.RS 2
.IP \[bu] 2
گوانگ‌شی چین (نان‌نینگ)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]anhui1\[dq]
.RS 2
.IP \[bu] 2
آن‌هوئی چین (هواینان)
.IP \[bu] 2
ارائه‌دهنده: ChinaMobile
.RE
.IP \[bu] 2
\[dq]us-standard\[dq]
.RS 2
.IP \[bu] 2
فرامنطقه‌ای ایالات متحده استاندارد
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]us-vault\[dq]
.RS 2
.IP \[bu] 2
فرامنطقه‌ای ایالات متحده والت
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]us-cold\[dq]
.RS 2
.IP \[bu] 2
فرامنطقه‌ای ایالات متحده سرد
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]us-flex\[dq]
.RS 2
.IP \[bu] 2
فرامنطقه‌ای ایالات متحده فلکس
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]us-east-standard\[dq]
.RS 2
.IP \[bu] 2
منطقه شرق ایالات متحده استاندارد
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]us-east-vault\[dq]
.RS 2
.IP \[bu] 2
منطقه شرق ایالات متحده والت
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]us-east-cold\[dq]
.RS 2
.IP \[bu] 2
منطقه شرق ایالات متحده سرد
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]us-east-flex\[dq]
.RS 2.IP \[bu] 2
رده Flex ناحیه شرق ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]us-south-standard\[dq]
.RS 2
.IP \[bu] 2
رده Standard ناحیه جنوب ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]us-south-vault\[dq]
.RS 2
.IP \[bu] 2
رده Vault ناحیه جنوب ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]us-south-cold\[dq]
.RS 2
.IP \[bu] 2
رده Cold ناحیه جنوب ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]us-south-flex\[dq]
.RS 2
.IP \[bu] 2
رده Flex ناحیه جنوب ایالات متحده
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]eu-standard\[dq]
.RS 2
.IP \[bu] 2
رده Standard فرامنطقه‌ای اروپا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]eu-vault\[dq]
.RS 2
.IP \[bu] 2
رده Vault فرامنطقه‌ای اروپا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]eu-cold\[dq]
.RS 2
.IP \[bu] 2
رده Cold فرامنطقه‌ای اروپا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]eu-flex\[dq]
.RS 2
.IP \[bu] 2
رده Flex فرامنطقه‌ای اروپا
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]eu-gb-standard\[dq]
.RS 2
.IP \[bu] 2
رده Standard بریتانیای کبیر
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]eu-gb-vault\[dq]
.RS 2
.IP \[bu] 2
رده Vault بریتانیای کبیر
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]eu-gb-cold\[dq]
.RS 2
.IP \[bu] 2
رده Cold بریتانیای کبیر
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]eu-gb-flex\[dq]
.RS 2
.IP \[bu] 2
رده Flex بریتانیای کبیر
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]ap-standard\[dq]
.RS 2
.IP \[bu] 2
رده Standard آسیا\-اقیانوسیه (APAC)
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]ap-vault\[dq]
.RS 2
.IP \[bu] 2
رده Vault آسیا\-اقیانوسیه (APAC)
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]ap-cold\[dq]
.RS 2
.IP \[bu] 2
رده Cold آسیا\-اقیانوسیه (APAC)
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]ap-flex\[dq]
.RS 2
.IP \[bu] 2
رده Flex آسیا\-اقیانوسیه (APAC)
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]mel01-standard\[dq]
.RS 2
.IP \[bu] 2
رده Standard ملبورن
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]mel01-vault\[dq]
.RS 2
.IP \[bu] 2
رده Vault ملبورن
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]mel01-cold\[dq]
.RS 2
.IP \[bu] 2
رده Cold ملبورن
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]mel01-flex\[dq]
.RS 2
.IP \[bu] 2
رده Flex ملبورن
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]tor01-standard\[dq]
.RS 2
.IP \[bu] 2
رده Standard تورنتو
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]tor01-vault\[dq]
.RS 2
.IP \[bu] 2
رده Vault تورنتو
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE.IP \[bu] 2
\[dq]tor01-cold\[dq]
.RS 2
.IP \[bu] 2
تورنتو سرد
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]tor01-flex\[dq]
.RS 2
.IP \[bu] 2
تورنتو فلکس
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]cn-east-1\[dq]
.RS 2
.IP \[bu] 2
منطقه ۱ شرق چین
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]cn-east-2\[dq]
.RS 2
.IP \[bu] 2
منطقه ۲ شرق چین
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]cn-north-1\[dq]
.RS 2
.IP \[bu] 2
منطقه ۱ شمال چین
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]cn-south-1\[dq]
.RS 2
.IP \[bu] 2
منطقه ۱ جنوب چین
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]us-north-1\[dq]
.RS 2
.IP \[bu] 2
منطقه ۱ آمریکای شمالی
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]ap-southeast-1\[dq]
.RS 2
.IP \[bu] 2
منطقه ۱ جنوب شرق آسیا
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]ap-northeast-1\[dq]
.RS 2
.IP \[bu] 2
منطقه ۱ شمال شرق آسیا
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]us-east-1\[dq]
.RS 2
.IP \[bu] 2
شرق ایالات متحده (ویرجینیای شمالی)
.IP \[bu] 2
ارائه‌دهنده: Rabata
.RE
.IP \[bu] 2
\[dq]eu-west-1\[dq]
.RS 2
.IP \[bu] 2
اتحادیه اروپا (ایرلند)
.IP \[bu] 2
ارائه‌دهنده: Rabata
.RE
.IP \[bu] 2
\[dq]eu-west-2\[dq]
.RS 2
.IP \[bu] 2
اتحادیه اروپا (لندن)
.IP \[bu] 2
ارائه‌دهنده: Rabata
.RE
.IP \[bu] 2
\[dq]global\[dq]
.RS 2
.IP \[bu] 2
منطقه جهانی CDN
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au\[dq]
.RS 2
.IP \[bu] 2
استرالیا (تمام موقعیت‌ها)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au-nsw\[dq]
.RS 2
.IP \[bu] 2
منطقه NSW (استرالیا)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au-qld\[dq]
.RS 2
.IP \[bu] 2
منطقه QLD (استرالیا)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au-vic\[dq]
.RS 2
.IP \[bu] 2
منطقه VIC (استرالیا)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]au-wa\[dq]
.RS 2
.IP \[bu] 2
منطقه پرث (استرالیا)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]ph\[dq]
.RS 2
.IP \[bu] 2
منطقه مانیل (فیلیپین)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]th\[dq]
.RS 2
.IP \[bu] 2
منطقه بانکوک (تایلند)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]hk\[dq]
.RS 2
.IP \[bu] 2
منطقه هنگ‌کنگ (HK)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]mn\[dq]
.RS 2
.IP \[bu] 2
منطقه اولان‌باتور (مغولستان)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]kg\[dq]
.RS 2.IP \[bu] 2
منطقه بیشکک (قرقیزستان)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]id\[dq]
.RS 2
.IP \[bu] 2
منطقه جاکارتا (اندونزی)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]jp\[dq]
.RS 2
.IP \[bu] 2
منطقه توکیو (ژاپن)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]sg\[dq]
.RS 2
.IP \[bu] 2
منطقه سنگاپور (SG)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]de\[dq]
.RS 2
.IP \[bu] 2
منطقه فرانکفورت (آلمان)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]us\[dq]
.RS 2
.IP \[bu] 2
منطقه ایالات متحده (AnyCast)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]us-east-1\[dq]
.RS 2
.IP \[bu] 2
منطقه نیویورک (ایالات متحده)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]us-west-1\[dq]
.RS 2
.IP \[bu] 2
منطقه فریمونت (ایالات متحده)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.IP \[bu] 2
\[dq]nz\[dq]
.RS 2
.IP \[bu] 2
منطقه اوکلند (نیوزیلند)
.IP \[bu] 2
ارائه‌دهنده: RackCorp
.RE
.RE
.SS --s3-acl
.PP
دسترسی ACL آماده (Canned ACL) مورد استفاده هنگام ایجاد باکت‌ها و ذخیره‌سازی یا رونوشت اشیاء.
.PP
این ACL برای ایجاد اشیاء استفاده می‌شود و در صورتی که bucket_acl تنظیم نشده باشد،
برای ایجاد باکت‌ها نیز به کار می‌رود.
.PP
برای اطلاعات بیشتر مراجعه کنید به:
https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
.PP
توجه داشته باشید که این ACL هنگام رونوشت سمت سرور اشیاء اعمال می‌شود، زیرا S3
دسترسی‌های ACL را از مبدأ رونوشت نمی‌کند، بلکه مقدار جدیدی می‌نویسد.
.PP
اگر acl یک رشته خالی باشد، هیچ سرآیند X-Amz-Acl: اضافه نخواهد شد و
مقدار پیش‌فرض (private) استفاده می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: acl
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_ACL
.IP \[bu] 2
ارائه‌دهنده:
AWS,Alibaba,ArvanCloud,BizflyCloud,Ceph,ChinaMobile,Cubbit,DigitalOcean,Dreamhost,Exaba,FileLu,GCS,HCP,Hetzner,HuaweiOBS,IBMCOS,IDrive,ImpossibleCloud,Intercolo,IONOS,Leviia,Liara,Linode,LyveCloud,Magalu,Minio,Netease,Outscale,OVHcloud,Petabox,Qiniu,RackCorp,Scaleway,Scality,SeaweedFS,TencentCOS,US3,Wasabi,Zata,ZeroServices,Other
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]private\[dq]
.RS 2
.IP \[bu] 2
مالک دسترسی FULL_CONTROL را دریافت می‌کند.
.IP \[bu] 2
هیچ‌کس دیگری حق دسترسی ندارد (پیش‌فرض).
.IP \[bu] 2
ارائه‌دهنده:
AWS,Alibaba,ArvanCloud,BizflyCloud,Ceph,ChinaMobile,Cubbit,DigitalOcean,Dreamhost,Exaba,FileLu,GCS,HCP,Hetzner,HuaweiOBS,IDrive,ImpossibleCloud,Intercolo,IONOS,Leviia,Liara,Linode,LyveCloud,Magalu,Minio,Netease,Outscale,OVHcloud,Petabox,Qiniu,RackCorp,Scaleway,Scality,SeaweedFS,US3,Wasabi,Zata,ZeroServices,Other
.RE
.IP \[bu] 2
\[dq]public-read\[dq]
.RS 2
.IP \[bu] 2
مالک دسترسی FULL_CONTROL را دریافت می‌کند.
.IP \[bu] 2
گروه AllUsers دسترسی READ را دریافت می‌کند.
.IP \[bu] 2
ارائه‌دهنده:
AWS,Alibaba,ArvanCloud,BizflyCloud,Ceph,ChinaMobile,Cubbit,DigitalOcean,Dreamhost,Exaba,FileLu,GCS,HCP,Hetzner,HuaweiOBS,IDrive,ImpossibleCloud,Intercolo,IONOS,Leviia,Liara,Linode,LyveCloud,Magalu,Minio,Netease,Outscale,OVHcloud,Petabox,Qiniu,RackCorp,Scaleway,Scality,SeaweedFS,TencentCOS,US3,Wasabi,Zata,ZeroServices,Other
.RE
.IP \[bu] 2
\[dq]public-read-write\[dq]
.RS 2
.IP \[bu] 2
مالک دسترسی FULL_CONTROL را دریافت می‌کند.
.IP \[bu] 2
گروه AllUsers دسترسی READ و WRITE را دریافت می‌کند.
.IP \[bu] 2
اعطای این دسترسی روی یک باکت عموماً توصیه نمی‌شود.
.IP \[bu] 2
ارائه‌دهنده:
AWS,Alibaba,ArvanCloud,BizflyCloud,Ceph,ChinaMobile,Cubbit,DigitalOcean,Dreamhost,Exaba,FileLu,GCS,HCP,Hetzner,HuaweiOBS,IDrive,ImpossibleCloud,Intercolo,IONOS,Leviia,Liara,Linode,LyveCloud,Magalu,Minio,Netease,Outscale,OVHcloud,Petabox,Qiniu,RackCorp,Scaleway,Scality,SeaweedFS,TencentCOS,Wasabi,Zata,ZeroServices,Other
.RE
.IP \[bu] 2
\[dq]authenticated-read\[dq]
.RS 2
.IP \[bu] 2
مالک دسترسی FULL_CONTROL را دریافت می‌کند.
.IP \[bu] 2
گروه AuthenticatedUsers دسترسی READ را دریافت می‌کند.
.IP \[bu] 2
ارائه‌دهنده:
AWS,Alibaba,ArvanCloud,BizflyCloud,Ceph,ChinaMobile,Cubbit,DigitalOcean,Dreamhost,Exaba,FileLu,GCS,HCP,Hetzner,HuaweiOBS,IDrive,ImpossibleCloud,Intercolo,IONOS,Leviia,Liara,Linode,LyveCloud,Magalu,Minio,Netease,Outscale,OVHcloud,Petabox,Qiniu,RackCorp,Scaleway,Scality,SeaweedFS,TencentCOS,Wasabi,Zata,ZeroServices,Other
.RE
.IP \[bu] 2
\[dq]bucket-owner-read\[dq]
.RS 2
.IP \[bu] 2
مالک شیء دسترسی FULL_CONTROL را دریافت می‌کند.
.IP \[bu] 2
مالک باکت دسترسی READ را دریافت می‌کند.
.IP \[bu] 2
در صورت مشخص کردن این Canned ACL هنگام ایجاد باکت، Amazon S3 آن را نادیده
می‌گیرد.
.IP \[bu] 2
ارائه‌دهنده:
AWS,Alibaba,ArvanCloud,BizflyCloud,Ceph,Cubbit,DigitalOcean,Dreamhost,Exaba,FileLu,GCS,HCP,Hetzner,HuaweiOBS,IDrive,ImpossibleCloud,Intercolo,IONOS,Leviia,Liara,Linode,LyveCloud,Magalu,Minio,Netease,Outscale,OVHcloud,Petabox,Qiniu,RackCorp,Scaleway,Scality,SeaweedFS,TencentCOS,Wasabi,Zata,ZeroServices,Other
.RE
.IP \[bu] 2
\[dq]bucket-owner-full-control\[dq]
.RS 2
.IP \[bu] 2
هم مالک شیء و هم مالک باکت دسترسی FULL_CONTROL بر روی
شیء را دریافت می‌کنند.
.IP \[bu] 2
در صورت مشخص کردن این Canned ACL هنگام ایجاد باکت، Amazon S3 آن را نادیده
می‌گیرد.
.IP \[bu] 2
ارائه‌دهنده:
AWS,Alibaba,ArvanCloud,BizflyCloud,Ceph,Cubbit,DigitalOcean,Dreamhost,Exaba,FileLu,GCS,HCP,Hetzner,HuaweiOBS,IDrive,ImpossibleCloud,Intercolo,IONOS,Leviia,Liara,Linode,LyveCloud,Magalu,Minio,Netease,Outscale,OVHcloud,Petabox,Qiniu,RackCorp,Scaleway,Scality,SeaweedFS,TencentCOS,Wasabi,Zata,ZeroServices,Other
.RE
.IP \[bu] 2
\[dq]private\[dq]
.RS 2
.IP \[bu] 2
مالک دسترسی FULL_CONTROL را دریافت می‌کند.
.IP \[bu] 2
هیچ‌کس دیگری حق دسترسی ندارد (پیش‌فرض)..IP \[bu] 2
این acl در IBM Cloud (Infra)، IBM Cloud (Storage) و
On-Premise COS در دسترس است.
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]public-read\[dq]
.RS 2
.IP \[bu] 2
مالک دسترسی FULL_CONTROL دریافت می‌کند.
.IP \[bu] 2
گروه AllUsers دسترسی READ دریافت می‌کند.
.IP \[bu] 2
این acl در IBM Cloud (Infra)، IBM Cloud (Storage) و
On-Premise IBM COS در دسترس است.
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]public-read-write\[dq]
.RS 2
.IP \[bu] 2
مالک دسترسی FULL_CONTROL دریافت می‌کند.
.IP \[bu] 2
گروه AllUsers دسترسی READ و WRITE دریافت می‌کند.
.IP \[bu] 2
این acl در IBM Cloud (Infra) و On-Premise IBM COS در دسترس است.
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]authenticated-read\[dq]
.RS 2
.IP \[bu] 2
مالک دسترسی FULL_CONTROL دریافت می‌کند.
.IP \[bu] 2
گروه AuthenticatedUsers دسترسی READ دریافت می‌کند.
.IP \[bu] 2
روی باکت‌ها پشتیبانی نمی‌شود.
.IP \[bu] 2
این acl در IBM Cloud (Infra) و On-Premise IBM COS در دسترس است.
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.RE
.IP \[bu] 2
\[dq]default\[dq]
.RS 2
.IP \[bu] 2
مالک دسترسی Full_CONTROL دریافت می‌کند.
.IP \[bu] 2
هیچ‌کس دیگری حق دسترسی ندارد (پیش‌فرض).
.IP \[bu] 2
ارائه‌دهنده: TencentCOS
.RE
.RE
.SS --s3-server-side-encryption
.PP
الگوریتم رمزنگاری سمت سرور که هنگام ذخیره‌سازی این شیء در
S3 استفاده می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: server_side_encryption
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_SERVER_SIDE_ENCRYPTION
.IP \[bu] 2
ارائه‌دهنده: AWS,Ceph,ChinaMobile,Minio
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام
.IP \[bu] 2
ارائه‌دهنده: AWS,Ceph,ChinaMobile,Minio
.RE
.IP \[bu] 2
\[dq]AES256\[dq]
.RS 2
.IP \[bu] 2
AES256
.IP \[bu] 2
ارائه‌دهنده: AWS,Ceph,ChinaMobile,Minio
.RE
.IP \[bu] 2
\[dq]aws:kms\[dq]
.RS 2
.IP \[bu] 2
aws:kms
.IP \[bu] 2
ارائه‌دهنده: AWS,Ceph,Minio
.RE
.RE.SS --s3-sse-kms-key-id
.PP
در صورت استفاده از شناسهٔ KMS، باید ARN کلید را ارائه دهید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sse_kms_key_id
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_SSE_KMS_KEY_ID
.IP \[bu] 2
ارائه‌دهنده: AWS,Ceph,Minio
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام
.RE
.IP \[bu] 2
\[dq]arn:aws:kms:us-east-1:*\[dq]
.RS 2
.IP \[bu] 2
arn:aws:kms:*
.RE
.RE
.SS --s3-storage-class
.PP
کلاس ذخیره‌سازی مورد استفاده هنگام ذخیره اشیاء جدید در S3.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: storage_class
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_STORAGE_CLASS
.IP \[bu] 2
ارائه‌دهنده:
AWS,Alibaba,ArvanCloud,ChinaMobile,Liara,Magalu,OVHcloud,Qiniu,Scaleway,TencentCOS,US3
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
پیش‌فرض
.IP \[bu] 2
ارائه‌دهنده: AWS,Alibaba,ChinaMobile,OVHcloud,TencentCOS,US3
.RE
.IP \[bu] 2
\[dq]STANDARD\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی استاندارد
.IP \[bu] 2
ارائه‌دهنده:
AWS,Alibaba,ArvanCloud,ChinaMobile,Liara,Magalu,OVHcloud,Qiniu,TencentCOS,US3
.RE
.IP \[bu] 2
\[dq]REDUCED_REDUNDANCY\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی با افزونگی کاهش‌یافته
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]STANDARD_IA\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی دسترسی کم‌تکرار استاندارد
.IP \[bu] 2
ارائه‌دهنده: AWS,OVHcloud
.RE
.IP \[bu] 2
\[dq]ONEZONE_IA\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی دسترسی کم‌تکرار تک‌منطقه‌ای
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]GLACIER\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی بازیابی انعطاف‌پذیر Glacier
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]DEEP_ARCHIVE\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی بایگانی عمیق Glacier
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]INTELLIGENT_TIERING\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی لایه‌بندی هوشمند (Intelligent-Tiering)
.IP \[bu] 2
ارائه‌دهنده: AWS
.RE
.IP \[bu] 2
\[dq]GLACIER_IR\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی بازیابی فوری Glacier
.IP \[bu] 2
ارائه‌دهنده: AWS,Magalu
.RE
.IP \[bu] 2
\[dq]GLACIER\[dq]
.RS 2
.IP \[bu] 2
حالت ذخیره‌سازی بایگانی
.IP \[bu] 2
ارائه‌دهنده: Alibaba,ChinaMobile,Qiniu
.RE
.IP \[bu] 2
\[dq]STANDARD_IA\[dq]
.RS 2
.IP \[bu] 2
حالت ذخیره‌سازی دسترسی کم‌تکرار
.IP \[bu] 2
ارائه‌دهنده: Alibaba,ChinaMobile,TencentCOS,US3
.RE
.IP \[bu] 2
\[dq]EXPRESS_ONEZONE\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی با کارایی بالا
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]ONEZONE_IA\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی دسترسی کم‌تکرار استاندارد
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]GLACIER\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی بایگانی فعال
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]GLACIER_IR\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی بایگانی فعال
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]DEEP_ARCHIVE\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی بایگانی سرد
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]INTELLIGENT_TIERING\[dq]
.RS 2.IP \[bu] 2
کلاس ذخیره‌سازی استاندارد
.IP \[bu] 2
ارائه‌دهنده: OVHcloud
.RE
.IP \[bu] 2
\[dq]LINE\[dq]
.RS 2
.IP \[bu] 2
حالت ذخیره‌سازی با دسترسی کم‌تکرار
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]DEEP_ARCHIVE\[dq]
.RS 2
.IP \[bu] 2
حالت ذخیره‌سازی آرشیو عمیق
.IP \[bu] 2
ارائه‌دهنده: Qiniu
.RE
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
پیش‌فرض.
.IP \[bu] 2
ارائه‌دهنده: Scaleway
.RE
.IP \[bu] 2
\[dq]STANDARD\[dq]
.RS 2
.IP \[bu] 2
کلاس استاندارد برای هر نوع بارگذاری.
.IP \[bu] 2
مناسب برای محتوای درخواستی مانند استریمینگ یا CDN.
.IP \[bu] 2
در دسترس در تمامی مناطق.
.IP \[bu] 2
ارائه‌دهنده: Scaleway
.RE
.IP \[bu] 2
\[dq]GLACIER\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی آرشیوی.
.IP \[bu] 2
هزینه‌ها پایین‌تر است، اما برای دسترسی ابتدا باید بازیابی شود.
.IP \[bu] 2
تنها در منطقه FR-PAR در دسترس است.
.IP \[bu] 2
ارائه‌دهنده: Scaleway
.RE
.IP \[bu] 2
\[dq]ONEZONE_IA\[dq]
.RS 2
.IP \[bu] 2
تک‌منطقه‌ای - دسترسی کم‌تکرار.
.IP \[bu] 2
انتخابی مناسب برای ذخیره نسخه‌های پشتیبان ثانویه یا داده‌هایی با بازتولید
آسان.
.IP \[bu] 2
در دسترس در تمامی مناطق.
.IP \[bu] 2
ارائه‌دهنده: Scaleway
.RE
.IP \[bu] 2
\[dq]ARCHIVE\[dq]
.RS 2
.IP \[bu] 2
حالت ذخیره‌سازی آرشیو
.IP \[bu] 2
ارائه‌دهنده: TencentCOS,US3
.RE
.RE
.SS --s3-ibm-api-key
.PP
کلید IBM API که برای دریافت توکن IAM استفاده می‌شود
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: ibm_api_key
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_IBM_API_KEY
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --s3-ibm-resource-instance-id
.PP
شناسهٔ نمونه سرویس IBM
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: ibm_resource_instance_id
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_IBM_RESOURCE_INSTANCE_ID
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --s3-bucket-object-lock-enabled
.PP
فعال‌سازی قفل شیء (Object Lock) هنگام ایجاد باکت‌های جدید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: bucket_object_lock_enabled
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_BUCKET_OBJECT_LOCK_ENABLED
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفتهٔ ویژهٔ s3 (ارائه‌دهندگان ذخیره‌سازی سازگار با
Amazon S3 شامل AWS، Alibaba، ArvanCloud، BizflyCloud، Ceph،
ChinaMobile، Cloudflare، Cubbit، DigitalOcean، Dreamhost، Exaba، Fastly،
FileLu، FlashBlade، GCS، HCP، Hetzner، HuaweiOBS، IBMCOS، IDrive،
ImpossibleCloud، Intercolo، IONOS، Leviia، Liara، Linode، LyveCloud،
Magalu، Mega، Minio، Netease، Outscale، OVHcloud، Petabox، Qiniu،
Rabata، RackCorp، Rclone، Scaleway، Scality، SeaweedFS، Selectel،
Servercore، SpectraLogic، Storj، Synology، TencentCOS، US3، Wasabi،
Zadara، Zata، ZeroServices و Other) آورده شده‌اند.
.SS --s3-bucket-acl
.PP
فهرست کنترل دسترسی پیش‌ساخته (Canned ACL) که هنگام ایجاد باکت‌ها استفاده می‌شود.
.PP
برای اطلاعات بیشتر مراجعه کنید به
https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
.PP
توجه داشته باشید که این ACL تنها هنگام ایجاد باکت‌ها اعمال می‌شود.
اگر تنظیم نشده باشد، در عوض از \[dq]acl\[dq] استفاده می‌شود.
.PP
اگر \[dq]acl\[dq] و \[dq]bucket_acl\[dq] رشته‌های خالی باشند، هیچ هدر
X-Amz-Acl: اضافه نمی‌شود و از مقدار پیش‌فرض (private) استفاده خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: bucket_acl
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_BUCKET_ACL
.IP \[bu] 2
ارائه‌دهنده:
AWS,Alibaba,ArvanCloud,BizflyCloud,Ceph,ChinaMobile,Cubbit,DigitalOcean,Dreamhost,Exaba,FileLu,GCS,HCP,Hetzner,HuaweiOBS,IBMCOS,IDrive,ImpossibleCloud,Intercolo,IONOS,Leviia,Liara,Linode,LyveCloud,Magalu,Mega,Minio,Netease,Outscale,OVHcloud,Petabox,Qiniu,RackCorp,Scaleway,SeaweedFS,Servercore,TencentCOS,US3,Wasabi,Zata,ZeroServices,Other
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]private\[dq]
.RS 2
.IP \[bu] 2
مالک دسترسی FULL_CONTROL دریافت می‌کند.
.IP \[bu] 2
هیچ‌کس دیگری حق دسترسی ندارد (پیش‌فرض).
.RE
.IP \[bu] 2
\[dq]public-read\[dq]
.RS 2
.IP \[bu] 2
مالک دسترسی FULL_CONTROL دریافت می‌کند.
.IP \[bu] 2
گروه AllUsers دسترسی READ دریافت می‌کند.
.RE
.IP \[bu] 2
\[dq]public-read-write\[dq]
.RS 2
.IP \[bu] 2
مالک دسترسی FULL_CONTROL دریافت می‌کند.
.IP \[bu] 2
گروه AllUsers دسترسی READ و WRITE دریافت می‌کند.
.IP \[bu] 2
اعطای این دسترسی روی یک باکت عموماً توصیه نمی‌شود.
.RE
.IP \[bu] 2
\[dq]authenticated-read\[dq]
.RS 2
.IP \[bu] 2
مالک دسترسی FULL_CONTROL دریافت می‌کند.
.IP \[bu] 2
گروه AuthenticatedUsers دسترسی READ دریافت می‌کند.
.RE
.RE.SS --s3-requester-pays
.PP
گزینه «پرداخت توسط درخواست‌دهنده» (requester pays) را هنگام تعامل با باکت S3 فعال می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: requester_pays
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_REQUESTER_PAYS
.IP \[bu] 2
ارائه‌دهنده: AWS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-sse-customer-algorithm
.PP
در صورت استفاده از SSE-C، الگوریتم رمزنگاری سمت سرور که هنگام ذخیره این شیء در S3 استفاده می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sse_customer_algorithm
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_SSE_CUSTOMER_ALGORITHM
.IP \[bu] 2
ارائه‌دهنده: AWS,Ceph,ChinaMobile,Minio
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام
.RE
.IP \[bu] 2
\[dq]AES256\[dq]
.RS 2
.IP \[bu] 2
AES256
.RE
.RE
.SS --s3-sse-customer-key
.PP
برای استفاده از SSE-C می‌توانید کلید رمزنگاری محرمانه‌ای را که جهت رمزنگاری/رمزگشایی داده‌هایتان به کار می‌رود، ارائه دهید.
.PP
به عنوان جایگزین می‌توانید از --sse-customer-key-base64 استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sse_customer_key
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_SSE_CUSTOMER_KEY
.IP \[bu] 2
ارائه‌دهنده: AWS,Ceph,ChinaMobile,Minio
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام
.RE
.RE
.SS --s3-sse-customer-key-base64
.PP
در صورت استفاده از SSE-C باید کلید رمزنگاری محرمانه را با قالب base64 برای رمزنگاری/رمزگشایی داده‌هایتان ارائه دهید.
.PP
به عنوان جایگزین می‌توانید از --sse-customer-key استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sse_customer_key_base64
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_SSE_CUSTOMER_KEY_BASE64
.IP \[bu] 2
ارائه‌دهنده: AWS,Ceph,ChinaMobile,Minio
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام
.RE
.RE.SS --s3-sse-customer-key-md5
.PP
در صورت استفاده از SSE-C می‌توانید چکسام MD5 کلید رمزنگاری محرمانه را ارائه دهید
(اختیاری).
.PP
اگر آن را خالی بگذارید، این مقدار به‌طور خودکار از روی sse_customer_key ارائه‌شده
محاسبه می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sse_customer_key_md5
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_SSE_CUSTOMER_KEY_MD5
.IP \[bu] 2
ارائه‌دهنده: AWS,Ceph,ChinaMobile,Minio
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام
.RE
.RE
.SS --s3-upload-cutoff
.PP
آستانه تغییر حالت به بارگذاری چندتکه‌ای (chunked).
.PP
هر فایلی بزرگ‌تر از این مقدار، در تکه‌هایی به اندازه chunk_size بارگذاری خواهد شد.
حداقل مقدار 0 و حداکثر آن 5 GiB است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 200Mi
.SS --s3-chunk-size
.PP
اندازه تکه (chunk) برای استفاده در بارگذاری.
.PP
هنگام بارگذاری فایل‌های بزرگ‌تر از upload_cutoff یا فایل‌هایی با اندازه نامشخص
(برای مثال از طریق \[dq]rclone rcat\[dq] یا بارگذاری‌شده با \[dq]rclone mount\[dq]
یا google photos یا google docs)، آن‌ها با استفاده از این اندازه تکه به‌صورت چندبخشی (multipart)
بارگذاری خواهند شد.
.PP
توجه داشته باشید که به ازای هر انتقال، به تعداد \[dq]--s3-upload-concurrency\[dq] تکه
با این اندازه در حافظه بافر می‌شوند.
.PP
اگر فایل‌های حجیم را روی پیوندهای پرسرعت انتقال می‌دهید و حافظه کافی در اختیار دارید،
افزایش این مقدار سرعت انتقال را افزایش خواهد داد.
.PP
ابزار Rclone هنگام بارگذاری فایلی حجیم با اندازه معلوم، به‌طور خودکار اندازه تکه را
افزایش می‌دهد تا زیر محدودیت ۱۰٬۰۰۰ تکه باقی بماند.
.PP
فایل‌های با اندازه نامعلوم با همان chunk_size پیکربندی‌شده بارگذاری می‌شوند.
از آنجا که اندازه تکه پیش‌فرض 5 MiB است و حداکثر می‌تواند ۱۰٬۰۰۰ تکه وجود داشته باشد،
این بدان معناست که در حالت پیش‌فرض حداکثر اندازه فایلی که می‌توانید به‌صورت جریانی (stream)
بارگذاری کنید 48 GiB است.
اگر مایلید فایل‌های بزرگ‌تری را به‌صورت جریانی بارگذاری کنید، باید chunk_size را افزایش دهید.
.PP
افزایش اندازه تکه باعث کاهش دقت آمار پیشرفت نمایش‌داده‌شده با پرچم \[dq]-P\[dq] می‌شود.
Rclone به محض اینکه تکه‌ای توسط AWS SDK بافر شود، آن را ارسال‌شده تلقی می‌کند، در حالی
که در واقع ممکن است هنوز در حال بارگذاری باشد.
اندازه تکه بزرگ‌تر به معنای بافر بزرگ‌تر AWS SDK و انحراف بیشتر گزارش پیشرفت از واقعیت است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 5Mi.SS --s3-max-upload-parts
.PP
بیشینه تعداد بخش‌ها در یک بارگذاری چندبخشی (multipart upload).
.PP
این گزینه بیشینه تعداد تکه‌های چندبخشی مورد استفاده هنگام انجام یک بارگذاری چندبخشی را تعیین می‌کند.
.PP
این گزینه می‌تواند در صورتی که یک سرویس از مشخصات 10,000 تکه‌ای AWS S3 پشتیبانی نکند، مفید باشد.
.PP
هنگام بارگذاری یک فایل بزرگ با اندازه مشخص، rclone به‌طور خودکار اندازه تکه‌ها را افزایش می‌دهد تا تعداد آن‌ها از این حد فراتر نرود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: max_upload_parts
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_MAX_UPLOAD_PARTS
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 10000
.SS --s3-copy-cutoff
.PP
حد آستانه برای جابجایی به رونوشت چندبخشی (multipart copy).
.PP
هر فایلی بزرگ‌تر از این مقدار که نیاز به رونوشت در سمت سرور داشته باشد، در تکه‌هایی با این اندازه کپی خواهد شد.
.PP
کمینه مقدار 1 بایت و بیشینه آن 5 GiB است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: copy_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_COPY_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 4.656Gi
.SS --s3-disable-checksum
.PP
چکسام MD5 همراه با فراداده شیء ذخیره نشود.
.PP
در حالت عادی rclone پیش از بارگذاری ورودی، چکسام MD5 آن را محاسبه می‌کند تا بتواند آن را به فراداده شیء اضافه نماید.
این کار برای بررسی صحت داده‌ها عالی است اما می‌تواند باعث تاخیرهای طولانی در آغاز بارگذاری فایل‌های بزرگ شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_checksum
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_DISABLE_CHECKSUM
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-shared-credentials-file
.PP
مسیر فایل اطلاعات احراز هویت مشترک (shared credentials).
.PP
اگر env_auth = true باشد، rclone می‌تواند از فایل اعتبارنامه‌های مشترک استفاده کند.
.PP
اگر این متغیر خالی باشد، rclone به دنبال متغیر محیطی \[dq]AWS_SHARED_CREDENTIALS_FILE\[dq] می‌گردد.
اگر مقدار متغیر محیطی نیز خالی باشد، به‌طور پیش‌فرض از دایرکتوری خانگی کاربر جاری استفاده خواهد شد.
.IP
.nf
\f[C]
Linux/OSX: \[dq]$HOME/.aws/credentials\[dq]
Windows:   \[dq]%USERPROFILE%\[rs].aws\[rs]credentials\[dq]
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: shared_credentials_file
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_SHARED_CREDENTIALS_FILE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --s3-profile
.PP
پروفایل مورد استفاده در فایل اعتبارنامه‌های مشترک (shared credentials).
.PP
اگر env_auth = true باشد، rclone می‌تواند از یک فایل اعتبارنامه‌های مشترک استفاده کند.
این متغیر کنترل می‌کند که از کدام پروفایل در آن فایل استفاده شود.
.PP
اگر خالی باشد، مقدار پیش‌فرض متغیر محیطی
\[dq]AWS_PROFILE\[dq] در نظر گرفته می‌شود و چنانچه این متغیر محیطی
نیز تنظیم نشده باشد، برابر با \[dq]default\[dq] خواهد بود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: profile
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_PROFILE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --s3-session-token
.PP
یک توکن نشست AWS.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: session_token
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_SESSION_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --s3-role-arn
.PP
شناسه ARN نقش IAM برای تصدی (assume).
.PP
اگر از assume role استفاده نمی‌کنید، آن را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: role_arn
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_ROLE_ARN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --s3-role-session-name
.PP
نام نشست برای نقش تصدی‌شده (assumed role).
.PP
اگر خالی باشد، یک نام نشست به‌طور خودکار ایجاد خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: role_session_name
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_ROLE_SESSION_NAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --s3-role-session-duration
.PP
مدت‌زمان نشست برای نقش تصدی‌شده (assumed role).
.PP
اگر خالی باشد، از مدت‌زمان پیش‌فرض نشست استفاده خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: role_session_duration
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_ROLE_SESSION_DURATION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --s3-role-external-id
.PP
شناسه خارجی (External ID) برای نقش تصدی‌شده (assumed role).
.PP
اگر از شناسه خارجی استفاده نمی‌کنید، آن را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: role_external_id
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_ROLE_EXTERNAL_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --s3-upload-concurrency
.PP
همزمانی برای بارگذاری‌ها و رونوشت‌های چندبخشی (multipart).
.PP
این مقدار، تعداد قطعاتی از یک فایل یکسان است که به‌طور هم‌زمان
برای بارگذاری‌ها و رونوشت‌های چندبخشی بارگذاری می‌شوند.
.PP
اگر تعداد کمی از فایل‌های حجیم را روی پیوندهای پرسرعت بارگذاری می‌کنید
و این بارگذاری‌ها تمام پهنای‌باند شما را به‌کار نمی‌گیرند، افزایش این مقدار
ممکن است به افزایش سرعت انتقال‌ها کمک کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_UPLOAD_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 4
.SS --s3-force-path-style
.PP
در صورت true بودن، از دسترسی سبک مسیر (path style) و در صورت false بودن، از سبک میزبانی مجازی (virtual hosted style) استفاده می‌شود.
.PP
اگر این گزینه true باشد (پیش‌فرض)، rclone از دسترسی path style استفاده خواهد کرد و اگر
false باشد، rclone از سبک virtual path استفاده می‌کند.
برای اطلاعات بیشتر
مستندات AWS S3 را ببینید: (https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html)
.PP
برخی ارائه‌دهندگان (مانند
AWS، Aliyun OSS، Netease COS یا Tencent COS) نیازمند تنظیم این گزینه روی false هستند
\- rclone این کار را بر اساس تنظیمات ارائه‌دهنده به‌طور خودکار انجام خواهد داد.
.PP
توجه داشته باشید اگر باکت شما یک نام معتبر DNS ندارد، یعنی
شامل \[aq].\[aq] یا \[aq]_\[aq] است، باید این گزینه را روی true تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: force_path_style
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_FORCE_PATH_STYLE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --s3-v2-auth
.PP
در صورت true بودن، از احراز هویت v2 استفاده می‌شود.
.PP
اگر این گزینه false باشد (پیش‌فرض)، rclone از احراز هویت v4 استفاده خواهد کرد.
اگر تنظیم شود، rclone از احراز هویت v2 استفاده می‌کند.
.PP
تنها زمانی از این گزینه استفاده کنید که امضاهای v4 کار نمی‌کنند؛ برای نمونه
نسخه‌های پیش از Jewel/v10 در CEPH.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: v2_auth
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_V2_AUTH
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-use-dual-stack
.PP
در صورت true بودن، از نقطه پایانی دوپشته‌ای (dual-stack endpoint) در AWS S3 (پشتیبانی از IPv6) استفاده می‌شود.
.PP
مستندات AWS را درباره Dualstack Endpoints ببینید:
(https://docs.aws.amazon.com/AmazonS3/latest/userguide/dual-stack-endpoints.html)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_dual_stack
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_USE_DUAL_STACK
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --s3-use-accelerate-endpoint
.PP
اگر روی true تنظیم شود، از اندپوینت شتاب‌یافته (accelerated endpoint) مربوط به AWS S3 استفاده می‌کند.
.PP
ببینید: شتاب‌دهی انتقال AWS S3 <https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration-examples.html>
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_accelerate_endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_USE_ACCELERATE_ENDPOINT
.IP \[bu] 2
ارائه‌دهنده: AWS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-use-arn-region
.PP
اگر روی true تنظیم شود، پشتیبانی از ناحیهٔ (region) مبتنی بر arn را برای سرویس فعال می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_arn_region
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_USE_ARN_REGION
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-leave-parts-on-error
.PP
اگر روی true تنظیم شود، در صورت بروز خطا از فراخوانی لغو بارگذاری (abort upload) خودداری کرده و تمام بخش‌های با موفقیت بارگذاری‌شده را برای بازیابی دستی روی S3 باقی می‌گذارد.
.PP
برای ازسرگیری بارگذاری‌ها در نشست‌های مختلف، این گزینه باید روی true تنظیم شود.
.PP
هشدار: ذخیره‌سازی بخش‌های یک بارگذاری چندبخشی (multipart upload) ناقص جزء فضای مصرفی در S3 محاسبه شده و در صورت پاکسازی نشدن، هزینه‌های اضافی در بر خواهد داشت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: leave_parts_on_error
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_LEAVE_PARTS_ON_ERROR
.IP \[bu] 2
ارائه‌دهنده: AWS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-list-chunk
.PP
اندازهٔ قطعهٔ فهرست‌بندی (فهرست پاسخ برای هر درخواست ListObject در S3).
.PP
این گزینه در مشخصات AWS S3 با نام‌های \[dq]MaxKeys\[dq]، \[dq]max-items\[dq] یا \[dq]page-size\[dq] نیز شناخته می‌شود.
اکثر سرویس‌ها فهرست پاسخ را حتی در صورت درخواست مقادیر بیشتر، به ۱۰۰۰ شیء محدود می‌کنند.
در AWS S3 این یک حداکثر سراسری است و نمی‌توان آن را تغییر داد؛ ببینید AWS S3 <https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html>.
در Ceph، این مقدار با استفاده از گزینهٔ \[dq]rgw list buckets max chunk\[dq] قابل افزایش است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_chunk
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_LIST_CHUNK
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 1000
.SS --s3-list-version
.PP
نسخهٔ ListObjects مورد استفاده: 1، 2 یا 0 برای خودکار.
.PP
هنگامی که S3 در ابتدا راه‌اندازی شد، تنها فراخوانی ListObjects را برای شمارش و فهرست کردن اشیاء در یک باکت ارائه می‌داد.
.PP
با این حال در مه ۲۰۱۶ فراخوانی ListObjectsV2 معرفی شد.
این نسخه کارایی بسیار بالاتری دارد و در صورت امکان همواره باید مورد استفاده قرار گیرد.
.PP
اگر روی مقدار پیش‌فرض، یعنی 0 تنظیم شود، rclone بر اساس ارائه‌دهندهٔ مشخص‌شده حدس می‌زند که کدام متد فهرست‌بندی اشیاء را فراخوانی کند.
اگر حدس آن نادرست باشد، می‌توان آن را در اینجا به‌صورت دستی تنظیم کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_version
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_LIST_VERSION
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 0.SS --s3-list-url-encode
.PP
تعیین اینکه آیا فهرست‌ها کدگذاری URL (URL encode) شوند یا خیر: true/false/unset
.PP
برخی ارائه‌دهندگان از کدگذاری URL در فهرست‌بندی پشتیبانی می‌کنند و در صورت دردسترس بودن، هنگام استفاده از نویسه‌های کنترلی در نام فایل‌ها، این روش مطمئن‌تر است.
اگر این گزینه روی unset (پیش‌فرض) تنظیم شده باشد، rclone با توجه به تنظیمات ارائه‌دهنده نحوهٔ اعمال را انتخاب می‌کند، اما شما می‌توانید انتخاب rclone را در اینجا لغو و جایگزین کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_url_encode
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_LIST_URL_ENCODE
.IP \[bu] 2
نوع: Tristate
.IP \[bu] 2
پیش‌فرض: unset
.SS --s3-no-check-bucket
.PP
در صورت تنظیم، تلاشی برای بررسی وجود داشتن باکت یا ایجاد آن انجام نمی‌شود.
.PP
اگر می‌دانید باکت از قبل وجود دارد، این گزینه می‌تواند برای به حداقل رساندن تعداد تراکنش‌های انجام‌شده توسط rclone مفید باشد.
.PP
همچنین در صورتی که کاربر مورد استفاده مجوزهای ایجاد باکت را نداشته باشد، ممکن است به این گزینه نیاز باشد.
پیش از نسخهٔ v1.52.0، این مورد به دلیل وجود یک باگ بدون خطا و در سکوت رد می‌شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_check_bucket
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_NO_CHECK_BUCKET
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-no-head
.PP
در صورت تنظیم، برای بررسی یکپارچگی روی اشیاء بارگذاری‌شده درخواست HEAD ارسال نمی‌شود.
.PP
این گزینه می‌تواند هنگام تلاش برای به حداقل رساندن تعداد تراکنش‌های انجام‌شده توسط rclone مفید باشد.
.PP
تنظیم آن بدین معناست که اگر rclone پس از بارگذاری یک شیء با متد PUT یک پیام 200 OK دریافت کند، فرض را بر این می‌گذارد که شیء به‌درستی بارگذاری شده است.
.PP
به‌طور خاص، چنین فرض خواهد شد:
.IP \[bu] 2
متاداده، از جمله modtime، کلاس ذخیره‌سازی (storage class) و content type همانند موارد بارگذاری‌شده است
.IP \[bu] 2
اندازه شیء همانند مورد بارگذاری‌شده است
.PP
موارد زیر را از پاسخ دریافتی برای یک PUT تک‌بخشی (single part) می‌خواند:
.IP \[bu] 2
مقدار MD5SUM
.IP \[bu] 2
تاریخ بارگذاری
.PP
برای بارگذاری‌های چندبخشی (multipart)، این موارد خوانده نمی‌شوند.
.PP
اگر شیء مبدئی با طول نامشخص بارگذاری شود، آن‌گاه rclone یک درخواست HEAD ارسال \f[B]خواهد کرد\f[R].
.PP
تنظیم این پرچم احتمال بروز شکست‌های شناسایی‌نشده در بارگذاری، به‌ویژه اندازهٔ نادرست را افزایش می‌دهد؛ بنابراین برای استفادهٔ عادی توصیه نمی‌شود.
در عمل، شانس وقوع یک شکست بارگذاری شناسایی‌نشده حتی با وجود این پرچم بسیار کم است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_head
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_NO_HEAD
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --s3-no-head-object
.PP
در صورت تنظیم، هنگام دریافت اشیاء، پیش از GET درخواست HEAD ارسال نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_head_object
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_NO_HEAD_OBJECT
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر، بخش encoding را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,InvalidUtf8,Dot
.SS --s3-disable-http2
.PP
غیرفعال‌سازی استفاده از http2 برای backendهای S3.
.PP
در حال حاضر یک مشکل حل‌نشده در backend مربوط به S3 (به‌ویژه minio) و HTTP/2 وجود دارد.
HTTP/2 به‌طور پیش‌فرض برای backend مربوط به S3 فعال است، اما می‌توان آن را از اینجا غیرفعال کرد.
پس از برطرف شدن این مشکل، این پرچم حذف خواهد شد.
.PP
ببینید: https://github.com/rclone/rclone/issues/4673,
https://github.com/rclone/rclone/issues/3631
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_http2
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_DISABLE_HTTP2
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-download-url
.PP
نقطه پایانی سفارشی برای بارگیری‌ها.
این معمولاً روی نشانی اینترنتی CloudFront CDN تنظیم می‌شود؛ زیرا AWS S3 هزینه ترافیک خروجی ارزان‌تری برای داده‌های بارگیری‌شده از طریق شبکه CloudFront ارائه می‌دهد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: download_url
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_DOWNLOAD_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --s3-directory-markers
.PP
بارگذاری یک شیء خالی با یک اسلش پایانی هنگام ایجاد یک دایرکتوری جدید.
.PP
پوشه‌های خالی در ریموت‌های مبتنی بر bucket پشتیبانی نمی‌شوند؛ این گزینه یک شیء خالی که با \[dq]/\[dq] خاتمه می‌یابد ایجاد می‌کند تا پوشه ماندگار شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: directory_markers
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_DIRECTORY_MARKERS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --s3-use-multipart-etag
.PP
تعیین استفاده از ETag در بارگذاری‌های چندبخشی (multipart) جهت اعتبارسنجی.
.PP
این مقدار باید برابر با true، false یا بدون مقدار (unset) رها شود تا از پیش‌فرض ارائه‌دهنده استفاده گردد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_multipart_etag
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_USE_MULTIPART_ETAG
.IP \[bu] 2
نوع: Tristate
.IP \[bu] 2
پیش‌فرض: unset
.SS --s3-use-unsigned-payload
.PP
تعیین استفاده از بار دادهٔ امضانشده (unsigned payload) در PutObject.
.PP
برنامه rclone هنگام فراخوانی PutObject باید از تغییر مکان اشاره‌گر (seeking) در بدنه توسط AWS SDK جلوگیری کند. ارائه‌دهندهٔ AWS می‌تواند چکسام‌ها را در دنباله (trailer) اضافه کند تا از seek جلوگیری شود، اما سایر ارائه‌دهندگان قادر به این کار نیستند.
.PP
این مقدار باید برابر با true، false یا بدون مقدار (unset) رها شود تا از پیش‌فرض ارائه‌دهنده استفاده گردد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_unsigned_payload
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_USE_UNSIGNED_PAYLOAD
.IP \[bu] 2
نوع: Tristate
.IP \[bu] 2
پیش‌فرض: unset
.SS --s3-use-presigned-request
.PP
تعیین استفاده از درخواست پیش‌امضاشده (presigned request) یا PutObject برای بارگذاری‌های تک‌بخشی.
.PP
اگر این مقدار false باشد، rclone از PutObject موجود در AWS SDK برای بارگذاری شیء استفاده خواهد کرد.
.PP
نسخه‌های rclone قدیمی‌تر از 1.59 از درخواست‌های پیش‌امضاشده برای بارگذاری اشیاء تک‌بخشی استفاده می‌کردند و تنظیم این پرچم روی true آن قابلیت را مجدداً فعال می‌کند. استفاده از این پرچم نباید ضروری باشد مگر در شرایط استثنایی یا برای آزمایش.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_presigned_request
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_USE_PRESIGNED_REQUEST
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-use-data-integrity-protections
.PP
در صورت تنظیم بر روی true، از قابلیت‌های محافظت از یکپارچگی دادهٔ AWS S3 استفاده می‌شود.
.PP
مستندات AWS دربارهٔ محافظت‌های یکپارچگی داده را ببینید (https://docs.aws.amazon.com/sdkref/latest/guide/feature-dataintegrity.html)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_data_integrity_protections
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_USE_DATA_INTEGRITY_PROTECTIONS
.IP \[bu] 2
نوع: Tristate
.IP \[bu] 2
پیش‌فرض: unset
.SS --s3-versions
.PP
گنجاندن نسخه‌های قدیمی در فهرست‌بندی‌های دایرکتوری.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: versions
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_VERSIONS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --s3-version-at
.PP
نمایش نسخه‌های فایل آن‌گونه که در زمان مشخص‌شده بوده‌اند.
.PP
پارامتر باید یک تاریخ، \[dq]2006-01-02\[dq]، تاریخ و زمان
\[dq]2006-01-02 15:04:05\[dq] یا بازه‌ای از زمان گذشته، مانند
\[dq]100d\[dq] یا \[dq]1h\[dq] باشد.
.PP
توجه داشته باشید که هنگام استفاده از این گزینه هیچ عملیات نوشتن فایلی مجاز نیست، بنابراین
نمی‌توانید فایل‌ها را بارگذاری یا حذف کنید.
.PP
برای قالب‌های معتبر، مستندات گزینه‌های زمان (<https://rclone.org/docs/#time-options>) را
ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: version_at
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_VERSION_AT
.IP \[bu] 2
نوع: Time
.IP \[bu] 2
پیش‌فرض: off
.SS --s3-version-deleted
.PP
نمایش نشانگرهای فایل‌های حذف‌شده هنگام استفاده از نسخه‌ها.
.PP
این گزینه نشانگرهای فایل‌های حذف‌شده را در فهرست‌بندی هنگام استفاده از نسخه‌ها نمایش می‌دهد.
این موارد به عنوان فایل‌هایی با اندازهٔ ۰ ظاهر خواهند شد.
تنها عملیاتی که می‌توان روی آن‌ها انجام داد، حذف است.
.PP
حذف یک نشانگر حذف، نسخهٔ قبلی را آشکار خواهد کرد.
.PP
فایل‌های حذف‌شده همیشه همراه با برچسب زمان نمایش داده می‌شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: version_deleted
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_VERSION_DELETED
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-decompress
.PP
در صورت تنظیم، اشیاء کدگذاری‌شده با gzip را از حالت فشرده خارج می‌کند.
.PP
امکان بارگذاری اشیاء در S3 با مقدار تنظیم‌شدهٔ \[dq]Content-Encoding:
gzip\[dq] وجود دارد.
به طور معمول rclone این فایل‌ها را به عنوان اشیاء فشرده دانلود می‌کند.
.PP
اگر این پرچم تنظیم شود، rclone این فایل‌ها با
\[dq]Content-Encoding: gzip\[dq] را به محض دریافت از حالت فشرده خارج می‌کند.
این بدان معناست که rclone نمی‌تواند اندازه و هش را بررسی کند، اما محتوای
فایل از حالت فشرده خارج خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: decompress
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_DECOMPRESS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-might-gzip
.PP
اگر احتمال دارد بک‌اند اشیاء را با gzip فشرده کند، این گزینه را تنظیم کنید.
.PP
به طور معمول ارائه‌دهندگان هنگام دانلود اشیاء، آن‌ها را تغییر نمی‌دهند.
اگر شیئی با \f[V]Content-Encoding: gzip\f[R] بارگذاری نشده باشد،
هنگام دانلود نیز این مقدار تنظیم نخواهد شد.
.PP
با این حال برخی از ارائه‌دهندگان ممکن است اشیاء را حتی در صورتی که با
\f[V]Content-Encoding: gzip\f[R] بارگذاری نشده باشند، با gzip فشرده کنند (مانند Cloudflare).
.PP
یکی از نشانه‌های این مسئله دریافت خطاهایی مانند این است:
.IP
.nf
\f[C]
ERROR corrupted on transfer: sizes differ NNN vs MMM
\f[R]
.fi
.PP
اگر این پرچم را تنظیم کنید و rclone شیئی را با Content-Encoding: gzip تنظیم‌شده و
کدگذاری انتقال تکه‌تکه (chunked transfer encoding) دانلود کند، rclone
شیء را در لحظه از حالت فشرده خارج خواهد کرد.
.PP
اگر این گزینه روی unset (پیش‌فرض) تنظیم شده باشد، rclone بر اساس تنظیم ارائه‌دهنده
تصمیم می‌گیرد که چه چیزی اعمال شود، اما می‌توانید انتخاب rclone را در اینجا نادیده بگیرید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: might_gzip
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_MIGHT_GZIP
.IP \[bu] 2
نوع: Tristate
.IP \[bu] 2
پیش‌فرض: unset.SS --s3-use-accept-encoding-gzip
.PP
آیا سربرگ \f[V]Accept-Encoding: gzip\f[R] ارسال شود یا خیر.
.PP
به‌طور پیش‌فرض، rclone تا حد امکان سربرگ \f[V]Accept-Encoding: gzip\f[R] را برای بارگیری اشیاء فشرده‌شده به درخواست اضافه می‌کند.
.PP
با این حال برخی ارائه‌دهندگان مانند Google Cloud Storage ممکن است سربرگ‌های HTTP را تغییر دهند که باعث از بین رفتن امضای درخواست می‌شود.
.PP
نشانه‌ای از این حالت، دریافت خطاهایی شبیه به این خواهد بود:
.IP
.nf
\f[C]
SignatureDoesNotMatch: The request signature we calculated does not match the signature you provided.
\f[R]
.fi
.PP
در این حالت، ممکن است بخواهید غیرفعال کردن این گزینه را امتحان کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_accept_encoding_gzip
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_USE_ACCEPT_ENCODING_GZIP
.IP \[bu] 2
نوع: Tristate
.IP \[bu] 2
پیش‌فرض: unset
.SS --s3-no-system-metadata
.PP
جلوگیری از تنظیم و خواندن فراداده‌های سیستم
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_system_metadata
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_NO_SYSTEM_METADATA
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-use-already-exists
.PP
تعیین می‌کند که آیا rclone باید هنگام ایجاد باکت، خطاهای BucketAlreadyExists را گزارش کند یا خیر.
.PP
در مقطعی از تکامل پروتکل s3، هنگام تلاش برای ایجاد باکتی که از قبل متعلق به کاربر بود، AWS به‌جای خطای \f[V]BucketAlreadyExists\f[R] شروع به بازگرداندن خطای \f[V]AlreadyOwnedByYou\f[R] کرد.
.PP
متأسفانه پیاده‌سازی‌های انجام‌شده توسط کلون‌های s3 کمی ناسازگار است؛ برخی \f[V]AlreadyOwnedByYou\f[R] را بازمی‌گردانند، برخی \f[V]BucketAlreadyExists\f[R] و برخی دیگر اصلاً خطایی بازنمی‌گردانند.
.PP
این موضوع برای rclone حائز اهمیت است زیرا در بسیاری از عملیات‌ها (مگر اینکه از \f[V]--s3-no-check-bucket\f[R] استفاده شده باشد) با ایجاد باکت از وجود آن اطمینان حاصل می‌کند.
.PP
اگر rclone بداند که ارائه‌دهنده می‌تواند \f[V]AlreadyOwnedByYou\f[R] بازگرداند یا هیچ خطایی برنمی‌گرداند، در این صورت می‌تواند هنگام تلاش کاربر برای ایجاد باکتی که در مالکیت او نیست، خطاهای \f[V]BucketAlreadyExists\f[R] را گزارش دهد. در غیر این صورت rclone خطای \f[V]BucketAlreadyExists\f[R] را نادیده می‌گیرد که می‌تواند منجر به سردرگمی شود.
.PP
این مقدار باید به‌طور خودکار برای تمام ارائه‌دهندگانی که rclone می‌شناسد به‌درستی تنظیم شود - در غیر این صورت لطفاً یک گزارش باگ ارسال کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_already_exists
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_USE_ALREADY_EXISTS
.IP \[bu] 2
نوع: Tristate
.IP \[bu] 2
پیش‌فرض: unset
.SS --s3-use-multipart-uploads
.PP
تعیین می‌کند که آیا rclone باید از بارگذاری‌های چندبخشی (multipart uploads) استفاده کند یا خیر.
.PP
اگر می‌خواهید استفاده از بارگذاری چندبخشی را غیرفعال کنید، می‌توانید این مقدار را تغییر دهید. این کار در شرایط عادی نباید لازم باشد.
.PP
این مقدار باید به‌طور خودکار برای تمام ارائه‌دهندگانی که rclone می‌شناسد به‌درستی تنظیم شود - در غیر این صورت لطفاً یک گزارش باگ ارسال کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_multipart_uploads
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_USE_MULTIPART_UPLOADS
.IP \[bu] 2
نوع: Tristate
.IP \[bu] 2
پیش‌فرض: unset.SS --s3-list-versions-oldest-first
.PP
اگر backend نسخه‌های شیء را از قدیمی‌ترین به جدیدترین بازمی‌گرداند، این گزینه را تنظیم کنید.
.PP
استاندارد S3 نسخه‌های شیء را از جدیدترین به قدیمی‌ترین بازمی‌گرداند.
برخی از backendها (مانند Hitachi HCP) در عوض آن‌ها را از قدیمی‌ترین به جدیدترین برمی‌گردانند.
.PP
اگر \-\-s3\-version\-at یا \-\-s3\-versions نتایج نادرستی با backend شما تولید می‌کنند، این رفتار خاص (quirk) را فعال کنید.
.PP
این مقدار باید برای تمامی ارائه‌دهندگانی که rclone می‌شناسد به طور خودکار و صحیح تنظیم شود \- اگر این‌گونه نیست، لطفاً یک گزارش باگ ارسال کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_versions_oldest_first
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_LIST_VERSIONS_OLDEST_FIRST
.IP \[bu] 2
نوع: Tristate
.IP \[bu] 2
پیش‌فرض: unset
.SS --s3-use-x-id
.PP
در صورتی تنظیم شود که rclone باید پارامترهای URL با عنوان x-id را اضافه کند.
.PP
اگر می‌خواهید از اضافه کردن پارامترهای URL با عنوان x-id توسط AWS SDK جلوگیری کنید، می‌توانید این گزینه را تغییر دهید.
.PP
این مورد در عملکرد عادی نباید ضروری باشد.
.PP
این مقدار باید برای تمامی ارائه‌دهندگانی که rclone می‌شناسد به طور خودکار و صحیح تنظیم شود \- اگر این‌گونه نیست، لطفاً یک گزارش باگ ارسال کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_x_id
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_USE_X_ID
.IP \[bu] 2
نوع: Tristate
.IP \[bu] 2
پیش‌فرض: unset
.SS --s3-sign-accept-encoding
.PP
در صورتی تنظیم شود که rclone باید Accept-Encoding را به عنوان بخشی از امضا بگنجاند.
.PP
اگر می‌خواهید از گنجاندن Accept-Encoding به عنوان بخشی از امضا توسط rclone جلوگیری کنید، می‌توانید این گزینه را تغییر دهید.
.PP
این مورد در عملکرد عادی نباید ضروری باشد.
.PP
این مقدار باید برای تمامی ارائه‌دهندگانی که rclone می‌شناسد به طور خودکار و صحیح تنظیم شود \- اگر این‌گونه نیست، لطفاً یک گزارش باگ ارسال کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sign_accept_encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_SIGN_ACCEPT_ENCODING
.IP \[bu] 2
نوع: Tristate
.IP \[bu] 2
پیش‌فرض: unset
.SS --s3-directory-bucket
.PP
جهت استفاده از AWS Directory Buckets تنظیم شود
.PP
اگر از یک AWS Directory Bucket استفاده می‌کنید، این پرچم را تنظیم نمایید.
.PP
این گزینه تضمین می‌کند که هیچ سرایند \f[V]Content-Md5\f[R] ارسال نشود و اطمینان می‌دهد که سرایندهای \f[V]ETag\f[R] به عنوان مقادیر مجموع MD5 تفسیر نشوند.
سرایند \f[V]X-Amz-Meta-Md5chksum\f[R] روی تمام اشیاء، چه به صورت تک‌بخشی یا چندبخشی (multipart) بارگذاری شده باشند، تنظیم خواهد شد.
.PP
این مورد همچنین \f[V]no_check_bucket = true\f[R] را تنظیم می‌کند.
.PP
توجه داشته باشید که Directory Buckets از موارد زیر پشتیبانی نمی‌کنند:
.IP \[bu] 2
نسخه‌بندی (Versioning)
.IP \[bu] 2
\f[V]Content-Encoding: gzip\f[R]
.PP
محدودیت‌های rclone در کار با Directory Buckets:
.IP \[bu] 2
برنامه rclone در حال حاضر از ایجاد Directory Buckets با
\f[V]rclone mkdir\f[R]
.IP \[bu] 2
\&...
یا حذف آن‌ها با \f[V]rclone rmdir\f[R] پشتیبانی نمی‌کند
.IP \[bu] 2
هنگام اجرای \f[V]rclone lsf\f[R] در بالاترین سطح، Directory Buckets نمایش داده نمی‌شوند.
.IP \[bu] 2
برنامه rclone هنوز قادر به حذف پوشه‌های ایجادشده به صورت خودکار نیست.
از نظر تئوری این مورد باید با \f[V]directory_markers = true\f[R] کار کند اما
کار نمی‌کند.
.IP \[bu] 2
به نظر می‌رسد پوشه‌ها در فهرست‌های بازگشتی (ListR) ظاهر نمی‌شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: directory_bucket
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_DIRECTORY_BUCKET
.IP \[bu] 2
ارائه‌دهنده: AWS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --s3-sdk-log-mode
.PP
تنظیم برای اشکال‌زدایی SDK
.PP
این گزینه می‌تواند با فهرستی از توابع زیر که با کاما از هم جدا شده‌اند تنظیم شود:
.IP \[bu] 2
\f[V]Signing\f[R]
.IP \[bu] 2
\f[V]Retries\f[R]
.IP \[bu] 2
\f[V]Request\f[R]
.IP \[bu] 2
\f[V]RequestWithBody\f[R]
.IP \[bu] 2
\f[V]Response\f[R]
.IP \[bu] 2
\f[V]ResponseWithBody\f[R]
.IP \[bu] 2
\f[V]DeprecatedUsage\f[R]
.IP \[bu] 2
\f[V]RequestEventMessage\f[R]
.IP \[bu] 2
\f[V]ResponseEventMessage\f[R]
.PP
از \f[V]Off\f[R] برای غیرفعال‌سازی و از \f[V]All\f[R] برای فعال‌سازی تمامی سطوح لاگ استفاده کنید.
برای مشاهده لاگ‌های سطح اشکال‌زدایی (debug) باید از \f[V]-vv\f[R] استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sdk_log_mode
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_SDK_LOG_MODE
.IP \[bu] 2
نوع: Bits
.IP \[bu] 2
پیش‌فرض: Off
.SS --s3-ibm-iam-endpoint
.PP
نقطه پایانی (Endpoint) سامانه IBM IAM برای استفاده در احراز هویت.
.PP
برای استفاده از نقطه پایانی عمومی پیش‌فرض، آن را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: ibm_iam_endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_IBM_IAM_ENDPOINT
.IP \[bu] 2
ارائه‌دهنده: IBMCOS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --s3-object-lock-mode
.PP
حالت Object Lock برای اعمال هنگام بارگذاری یا کپی اشیاء.
.PP
این گزینه را برای اعمال حالت ماندگاری Object Lock روی اشیاء تنظیم کنید.
در صورت عدم تنظیم، هیچ حالت Object Lock اعمال نمی‌شود (حتی همراه با --metadata).
.PP
نکته: برای فعال‌سازی ماندگاری Object Lock، باید هر دو مورد
object_lock_mode و object_lock_retain_until_date را تنظیم کنید.
تنظیم تنها یکی از آن‌ها هیچ تأثیری ندارد.
.IP \[bu] 2
GOVERNANCE: تنظیم حالت Object Lock به GOVERNANCE
.IP \[bu] 2
COMPLIANCE: تنظیم حالت Object Lock به COMPLIANCE
.IP \[bu] 2
copy: کپی حالت از شیء مبدأ (نیازمند --metadata)
.PP
ببینید:
https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: object_lock_mode
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_OBJECT_LOCK_MODE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]GOVERNANCE\[dq]
.RS 2
.IP \[bu] 2
تنظیم حالت Object Lock به GOVERNANCE
.RE
.IP \[bu] 2
\[dq]COMPLIANCE\[dq]
.RS 2
.IP \[bu] 2
تنظیم حالت Object Lock به COMPLIANCE
.RE
.IP \[bu] 2
\[dq]copy\[dq]
.RS 2
.IP \[bu] 2
کپی از شیء مبدأ (نیازمند --metadata)
.RE
.RE.SS --s3-object-lock-retain-until-date
.PP
تاریخ نگهداری قفل شیء (Object Lock retention until date) برای اعمال هنگام بارگذاری یا رونوشت اشیاء.
.PP
این گزینه را برای اعمال تاریخ نگهداری قفل شیء روی اشیاء تنظیم کنید.
در صورت عدم تنظیم، هیچ تاریخ نگهداری اعمال نخواهد شد (حتی با \-\-metadata).
.PP
نکته: برای فعال‌سازی نگهداری قفل شیء، باید هر دو مورد
object_lock_mode و object_lock_retain_until_date را تنظیم کنید.
تنظیم تنها یکی از آن‌ها هیچ اثری ندارد.
.PP
مقادیر قابل قبول: \- قالب RFC 3339: 2030-01-02T15:04:05Z \- مدت‌زمان از اکنون:
365d، 1y، 6M (روز، سال، ماه) \- copy: رونوشت تاریخ از شیء مبدأ
(نیازمند \-\-metadata)
.PP
ببینید:
https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: object_lock_retain_until_date
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_OBJECT_LOCK_RETAIN_UNTIL_DATE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]copy\[dq]
.RS 2
.IP \[bu] 2
رونوشت از شیء مبدأ (نیازمند \-\-metadata)
.RE
.IP \[bu] 2
\[dq]2030-01-01T00:00:00Z\[dq]
.RS 2
.IP \[bu] 2
تنظیم تاریخ مشخص (قالب RFC 3339)
.RE
.IP \[bu] 2
\[dq]365d\[dq]
.RS 2
.IP \[bu] 2
تنظیم نگهداری برای ۳۶۵ روز از اکنون
.RE
.IP \[bu] 2
\[dq]1y\[dq]
.RS 2
.IP \[bu] 2
تنظیم نگهداری برای ۱ سال از اکنون
.RE
.RE
.SS --s3-object-lock-legal-hold-status
.PP
وضعیت توقیف قانونی قفل شیء (Object Lock legal hold status) برای اعمال هنگام بارگذاری یا رونوشت اشیاء.
.PP
این گزینه را برای اعمال توقیف قانونی قفل شیء روی اشیاء تنظیم کنید.
در صورت عدم تنظیم، هیچ توقیف قانونی اعمال نمی‌شود (حتی با \-\-metadata).
.PP
نکته: توقیف قانونی مستقل از نگهداری است و می‌تواند به‌طور جداگانه تنظیم شود.
.IP \[bu] 2
ON: فعال‌سازی توقیف قانونی
.IP \[bu] 2
OFF: غیرفعال‌سازی توقیف قانونی
.IP \[bu] 2
copy: رونوشت وضعیت توقیف قانونی از شیء مبدأ (نیازمند
\-\-metadata)
.PP
ببینید:
https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: object_lock_legal_hold_status
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_OBJECT_LOCK_LEGAL_HOLD_STATUS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]ON\[dq]
.RS 2
.IP \[bu] 2
فعال‌سازی توقیف قانونی
.RE
.IP \[bu] 2
\[dq]OFF\[dq]
.RS 2
.IP \[bu] 2
غیرفعال‌سازی توقیف قانونی
.RE
.IP \[bu] 2
\[dq]copy\[dq]
.RS 2
.IP \[bu] 2
رونوشت از شیء مبدأ (نیازمند \-\-metadata)
.RE
.RE.SS --s3-bypass-governance-retention
.PP
اجازه حذف یا ویرایش اشیاء قفل‌شده با حالت GOVERNANCE را می‌دهد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: bypass_governance_retention
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_BYPASS_GOVERNANCE_RETENTION
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-object-lock-set-after-upload
.PP
تنظیم Object Lock از طریق فراخوانی‌های جداگانهٔ API پس از بارگذاری.
.PP
از این گزینه برای ارائه‌دهندگان سازگار با S3 استفاده کنید که از تنظیم هدرهای
Object Lock در طول عملیات‌های PUT پشتیبانی نمی‌کنند.
هنگام فعال بودن، Object Lock پس از تکمیل بارگذاری، از طریق فراخوانی‌های جداگانهٔ
PutObjectRetention و PutObjectLegalHold در API تنظیم می‌شود.
.PP
این کار فراخوانی‌های اضافی API را به ازای هر شیء اضافه می‌کند، بنابراین تنها
در صورتی آن را فعال کنید که ارائه‌دهندهٔ شما به آن نیاز داشته باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: object_lock_set_after_upload
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_OBJECT_LOCK_SET_AFTER_UPLOAD
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --s3-object-lock-supported
.PP
اینکه آیا ارائه‌دهنده از S3 Object Lock پشتیبانی می‌کند یا خیر.
.PP
این مقدار باید true، false یا برای استفاده از پیش‌فرض ارائه‌دهنده،
تنظیم‌نشده (unset) رها شود.
.PP
برای ارائه‌دهندگانی که به طور کامل از API مربوط به S3 Object Lock
پشتیبانی نمی‌کنند، روی false تنظیم کنید (به عنوان مثال
GCS که از هدرهای غیراستاندارد برای bypass governance retention استفاده می‌کند و
Legal Hold را از طریق S3 API پیاده‌سازی نکرده است).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: object_lock_supported
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_OBJECT_LOCK_SUPPORTED
.IP \[bu] 2
نوع: Tristate
.IP \[bu] 2
پیش‌فرض: unset
.SS --s3-description
.PP
توضیحات remote.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_S3_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS متاداده (Metadata)
.PP
متاداده‌های کاربر به عنوان کلیدهای x-amz-meta- ذخیره می‌شوند.
کلیدهای متادادهٔ S3 به بزرگی و کوچکی حروف حساس نیستند و همیشه با حروف
کوچک برگردانده می‌شوند.
.PP
در اینجا موارد متاداده‌های سیستمی ممکن برای بک‌اند s3 آمده است.
.PP
.TS
tab(@);
lw(11.1n) lw(11.1n) lw(11.1n) lw(16.6n) lw(20.3n).
T{
نام
T}@T{
راهنما
T}@T{
نوع
T}@T{
مثال
T}@T{
فقط‌خواندنی
T}
_
T{
btime
T}@T{
زمان پیدایش (ایجاد) فایل که از هدر Last-Modified خوانده می‌شود
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}@T{
\f[B]Y\f[R]
T}
T{
cache-control
T}@T{
هدر Cache-Control
T}@T{
string
T}@T{
no-cache
T}@T{
N
T}
T{
content-disposition
T}@T{
هدر Content-Disposition
T}@T{
string
T}@T{
inline
T}@T{
N
T}
T{
content-encoding
T}@T{
هدر Content-Encoding
T}@T{
string
T}@T{
gzip
T}@T{
N
T}
T{
content-language
T}@T{
هدر Content-Language
T}@T{
string
T}@T{
en-US
T}@T{
N
T}
T{
content-type
T}@T{
هدر Content-Type
T}@T{
string
T}@T{
text/plain
T}@T{
N
T}
T{
mtime
T}@T{
زمان آخرین تغییر، خوانده‌شده از متاداده‌های rclone
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}@T{
N
T}
T{
object-lock-legal-hold-status
T}@T{
وضعیت توقیف قانونی (legal hold) در Object Lock: مقدار ON یا OFF
T}@T{
string
T}@T{
OFF
T}@T{
N
T}
T{
object-lock-mode
T}@T{
حالت Object Lock: مقدار GOVERNANCE یا COMPLIANCE
T}@T{
string
T}@T{
GOVERNANCE
T}@T{
N
T}
T{
object-lock-retain-until-date
T}@T{
تاریخ نگهداری تا زمان مشخص در Object Lock
T}@T{
RFC 3339
T}@T{
2030-01-02T15:04:05Z
T}@T{
N
T}
T{
tier
T}@T{
سطح (Tier) شیء
T}@T{
string
T}@T{
GLACIER
T}@T{
\f[B]Y\f[R]
T}
.TE.PP
برای اطلاعات بیشتر مستندات metadata (<https://rclone.org/docs/#metadata>) را ببینید.
.SS دستورهای Backend
.PP
در اینجا دستورهای ویژه backend مربوط به s3 آورده شده‌اند.
.PP
آن‌ها را با دستور زیر اجرا کنید:
.IP
.nf
\f[C]
rclone backend COMMAND remote:
\f[R]
.fi
.PP
راهنمای زیر توضیح خواهد داد که هر دستور چه آرگومان‌هایی می‌گیرد.
.PP
برای اطلاعات بیشتر درباره نحوه ارسال گزینه‌ها و آرگومان‌ها، دستور backend (<https://rclone.org/commands/rclone_backend>) را ببینید.
.PP
این‌ها را می‌توان با استفاده از دستور rc به صورت backend/command (<https://rclone.org/rc/#backend-command>) روی یک backend در حال اجرا، اجرا کرد.
.SS restore
.PP
بازیابی شیءها از رده آرشیو GLACIER یا INTELLIGENT-TIERING.
.IP
.nf
\f[C]
rclone backend restore remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور می‌تواند برای بازیابی یک یا چند شیء از GLACIER به فضای ذخیره‌سازی عادی یا از رده Archive Access / Deep Archive Access در INTELLIGENT-TIERING به رده Frequent Access استفاده شود.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend restore s3:bucket/path/to/ --include /object -o priority=PRIORITY -o lifetime=DAYS
rclone backend restore s3:bucket/path/to/directory -o priority=PRIORITY -o lifetime=DAYS
rclone backend restore s3:bucket -o priority=PRIORITY -o lifetime=DAYS
rclone backend restore s3:bucket/path/to/directory -o priority=PRIORITY
\f[R]
.fi
.PP
این پرچم همچنین از فیلترها پیروی می‌کند.
ابتدا با پرچم‌های \-\-interactive/\-i یا \-\-dry\-run آزمایش کنید.
.IP
.nf
\f[C]
rclone --interactive backend restore --include \[dq]*.txt\[dq] s3:bucket/path -o priority=Standard -o lifetime=1
\f[R]
.fi
.PP
تمام شیءهای نمایش‌داده‌شده برای بازیابی نشانه‌گذاری خواهند شد، سپس:
.IP
.nf
\f[C]
rclone backend restore --include \[dq]*.txt\[dq] s3:bucket/path -o priority=Standard -o lifetime=1
\f[R]
.fi
.PP
این دستور فهرستی از دیکشنری‌های وضعیت را با کلیدهای Remote و Status بازمی‌گرداند.
در صورت موفقیت‌آمیز بودن مقدار Status برابر با OK و در غیر این صورت یک پیام خطا خواهد بود.
.IP
.nf
\f[C]
[
    {
        \[dq]Status\[dq]: \[dq]OK\[dq],
        \[dq]Remote\[dq]: \[dq]test.txt\[dq]
    },
    {
        \[dq]Status\[dq]: \[dq]OK\[dq],
        \[dq]Remote\[dq]: \[dq]test/file4.txt\[dq]
    }
]
\f[R]
.fi
.PP
گزینه‌ها:
.IP \[bu] 2
\[dq]description\[dq]: توضیحات اختیاری برای این کار.
.IP \[bu] 2
\[dq]lifetime\[dq]: طول عمر نسخه فعال به روز؛ برای فضای ذخیره‌سازی
INTELLIGENT-TIERING نادیده گرفته می‌شود.
.IP \[bu] 2
\[dq]priority\[dq]: اولویت بازیابی: Standard|Expedited|Bulk.SS restore-status
.PP
نمایش وضعیت اشیایی که از GLACIER یا INTELLIGENT-TIERING در حال بازیابی هستند.
.IP
.nf
\f[C]
rclone backend restore-status remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور می‌تواند برای نمایش وضعیت اشیایی که از GLACIER به فضای ذخیره‌سازی عادی یا از لایه‌های Archive Access / Deep Archive Access در INTELLIGENT-TIERING به لایهٔ Frequent Access در حال بازیابی هستند استفاده شود.
.PP
مثال‌های استفاده:
.IP
.nf
\f[C]
rclone backend restore-status s3:bucket/path/to/object
rclone backend restore-status s3:bucket/path/to/directory
rclone backend restore-status -o all s3:bucket/path/to/directory
\f[R]
.fi
.PP
این دستور از فیلترها پیروی نمی‌کند.
.PP
این دستور فهرستی از دیکشنری‌های وضعیت را برمی‌گرداند:
.IP
.nf
\f[C]
[
    {
        \[dq]Remote\[dq]: \[dq]file.txt\[dq],
        \[dq]VersionID\[dq]: null,
        \[dq]RestoreStatus\[dq]: {
            \[dq]IsRestoreInProgress\[dq]: true,
            \[dq]RestoreExpiryDate\[dq]: \[dq]2023-09-06T12:29:19+01:00\[dq]
        },
        \[dq]StorageClass\[dq]: \[dq]GLACIER\[dq]
    },
    {
        \[dq]Remote\[dq]: \[dq]test.pdf\[dq],
        \[dq]VersionID\[dq]: null,
        \[dq]RestoreStatus\[dq]: {
            \[dq]IsRestoreInProgress\[dq]: false,
            \[dq]RestoreExpiryDate\[dq]: \[dq]2023-09-06T12:29:19+01:00\[dq]
        },
        \[dq]StorageClass\[dq]: \[dq]DEEP_ARCHIVE\[dq]
    },
    {
        \[dq]Remote\[dq]: \[dq]test.gz\[dq],
        \[dq]VersionID\[dq]: null,
        \[dq]RestoreStatus\[dq]: {
            \[dq]IsRestoreInProgress\[dq]: true,
            \[dq]RestoreExpiryDate\[dq]: \[dq]null\[dq]
        },
        \[dq]StorageClass\[dq]: \[dq]INTELLIGENT_TIERING\[dq]
    }
]
\f[R]
.fi
.PP
گزینه‌ها:
.IP \[bu] 2
\[dq]all\[dq]: در صورت تنظیم، همهٔ اشیاء نمایش داده می‌شوند، نه فقط مواردی که وضعیت بازیابی دارند.
.SS list-multipart-uploads
.PP
فهرست کردن بارگذاری‌های چندبخشی (multipart uploads) ناتمام.
.IP
.nf
\f[C]
rclone backend list-multipart-uploads remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور بارگذاری‌های چندبخشی ناتمام را در قالب JSON فهرست می‌کند.
.PP
مثال‌های استفاده:
.IP
.nf
\f[C]
rclone backend list-multipart s3:bucket/path/to/object
\f[R]
.fi
.PP
این دستور دیکشنری‌ای از باکت‌ها (buckets) را برمی‌گرداند که مقادیر آن فهرستی از بارگذاری‌های چندبخشی ناتمام است.
.PP
می‌توانید آن را بدون باکت فراخوانی کنید که در این صورت همهٔ باکت‌ها را فهرست می‌کند، یا با یک باکت، یا با یک باکت و مسیر.
.IP
.nf
\f[C]
{
    \[dq]rclone\[dq]: [
        {
            \[dq]Initiated\[dq]: \[dq]2020-06-26T14:20:36Z\[dq],
            \[dq]Initiator\[dq]: {
                \[dq]DisplayName\[dq]: \[dq]XXX\[dq],
                \[dq]ID\[dq]: \[dq]arn:aws:iam::XXX:user/XXX\[dq]
            },
            \[dq]Key\[dq]: \[dq]KEY\[dq],
            \[dq]Owner\[dq]: {
                \[dq]DisplayName\[dq]: null,
                \[dq]ID\[dq]: \[dq]XXX\[dq]
            },
            \[dq]StorageClass\[dq]: \[dq]STANDARD\[dq],
            \[dq]UploadId\[dq]: \[dq]XXX\[dq]
        }
    ],
    \[dq]rclone-1000files\[dq]: [],
    \[dq]rclone-dst\[dq]: []
}
\f[R]
.fi.SS cleanup
.PP
حذف بارگذاری‌های چندبخشی ناتمام.
.IP
.nf
\f[C]
rclone backend cleanup remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور بارگذاری‌های چندبخشی ناتمام با قدمت بیش از
max-age را که به‌طور پیش‌فرض ۲۴ ساعت است، حذف می‌کند.
.PP
توجه داشته باشید که می‌توانید از --interactive/-i یا --dry-run به همراه این دستور استفاده کنید تا
ببینید چه عملیاتی انجام خواهد شد.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend cleanup s3:bucket/path/to/object
rclone backend cleanup -o max-age=7w s3:bucket/path/to/object
\f[R]
.fi
.PP
مدت‌زمان‌ها مانند سایر بخش‌های rclone تجزیه می‌شوند؛ مانند 2h، 7d، 7w و غیره.
.PP
گزینه‌ها:
.IP \[bu] 2
\[dq]max-age\[dq]: بیشینهٔ قدمت بارگذاری برای حذف.
.SS cleanup-hidden
.PP
حذف نسخه‌های قدیمی فایل‌ها.
.IP
.nf
\f[C]
rclone backend cleanup-hidden remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور تمام نسخه‌های قدیمی پنهانِ فایل‌ها را در یک باکت با
نسخه‌بندی فعال حذف می‌کند.
.PP
توجه داشته باشید که می‌توانید از --interactive/-i یا --dry-run به همراه این دستور استفاده کنید تا
ببینید چه عملیاتی انجام خواهد شد.
.PP
مثال کاربرد:
.IP
.nf
\f[C]
rclone backend cleanup-hidden s3:bucket/path/to/dir
\f[R]
.fi
.SS versioning
.PP
تنظیم/دریافت پشتیبانی از نسخه‌بندی برای یک باکت.
.IP
.nf
\f[C]
rclone backend versioning remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور در صورت ارسال یک پارامتر، پشتیبانی از نسخه‌بندی را تنظیم می‌کند و سپس
وضعیت فعلی نسخه‌بندی را برای باکت ارائه‌شده بازمی‌گرداند.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend versioning s3:bucket # read status only
rclone backend versioning s3:bucket Enabled
rclone backend versioning s3:bucket Suspended
\f[R]
.fi
.PP
این دستور ممکن است \[dq]Enabled\[dq]، \[dq]Suspended\[dq] یا
\[dq]Unversioned\[dq] را بازگرداند.
توجه داشته باشید که پس از فعال‌سازی نسخه‌بندی، وضعیت نمی‌تواند دوباره
به \[dq]Unversioned\[dq] بازگردانده شود..SS set
.PP
دستور set برای به‌روزرسانی پارامترهای پیکربندی.
.IP
.nf
\f[C]
rclone backend set remote: [options] [<arguments>+]
\f[R]
.fi
.PP
از این دستور set می‌توان برای به‌روزرسانی پارامترهای پیکربندی یک backend در حال اجرای s3 استفاده کرد.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend set s3: [-o opt_name=opt_value] [-o opt_name2=opt_value2]
rclone rc backend/command command=set fs=s3: [-o opt_name=opt_value] [-o opt_name2=opt_value2]
rclone rc backend/command command=set fs=s3: -o session_token=X -o access_key_id=X -o secret_access_key=X
\f[R]
.fi
.PP
نام کلیدهای گزینه‌ها همانند نام آن‌ها در فایل پیکربندی است.
.PP
این دستور در صورت فراخوانی با پارامترهای جدید، اتصال به backend مربوط به s3 را دوباره برقرار می‌کند.
تنها نیاز است پارامترهای جدید ارسال شوند، چرا که سایر مقادیر به‌طور پیش‌فرض برابر با مقادیر در حال استفاده خواهند بود.
.PP
این دستور خروجی خاصی برنمی‌گرداند.
.SS دسترسی ناشناس به باکت‌های عمومی
.PP
اگر می‌خواهید از rclone برای دسترسی به یک باکت عمومی استفاده کنید، آن را با مقادیر خالی برای \f[V]access_key_id\f[R] و \f[V]secret_access_key\f[R] پیکربندی نمایید.
پیکربندی شما در نهایت باید مشابه این باشد:
.IP
.nf
\f[C]
[anons3]
type = s3
provider = AWS
\f[R]
.fi
.PP
سپس طبق معمول همراه با نام باکت عمومی از آن استفاده کنید، به عنوان مثال:
.IP
.nf
\f[C]
rclone lsd anons3:1000genomes
\f[R]
.fi
.PP
شما قادر به فهرست کردن و رونوشت برداشتن از داده‌ها خواهید بود، اما امکان بارگذاری داده نخواهید داشت.
.PP
همچنین می‌توانید این کار را به‌طور کامل از طریق خط فرمان انجام دهید:
.IP
.nf
\f[C]
rclone lsd :s3,provider=AWS:1000genomes
\f[R]
.fi
.SS ارائه‌دهندگان (Providers)
.SS AWS S3
.PP
این همان ارائه‌دهنده‌ای است که به عنوان مثال اصلی استفاده شده و در بخش پیکربندی بالا شرح داده شده است.
.SS باکت‌های دایرکتوری AWS (AWS Directory Buckets)
.PP
از نگارش v1.69 ابزار rclone، باکت‌های دایرکتوری (<https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html>) پشتیبانی می‌شوند.
.PP
باید پارامتر پیکربندی \f[V]directory_bucket = true\f[R] را تنظیم کرده یا از گزینهٔ \f[V]--s3-directory-bucket\f[R] استفاده کنید.
.PP
توجه داشته باشید که rclone هنوز قادر به انجام موارد زیر نیست:
.IP \[bu] 2
ایجاد باکت‌های دایرکتوری
.IP \[bu] 2
فهرست کردن باکت‌های دایرکتوری
.PP
برای اطلاعات بیشتر پرچم \-\-s3\-directory\-bucket را ببینید..SS AWS Snowball Edge
.PP
سخت‌افزار AWS Snowball (https://aws.amazon.com/snowball) یک دستگاه فیزیکی است
که برای انتقال داده‌های حجیم به AWS به کار می‌رود.
رابط نرم‌افزاری اصلی آن، فضای ذخیره‌سازی شیء S3 است.
.PP
برای استفاده از rclone با دستگاه‌های AWS Snowball Edge، آن را به صورت استاندارد برای
یک \[aq]S3 Compatible Service\[aq] پیکربندی کنید.
.PP
اگر از rclone پیش از نگارش v1.59 استفاده می‌کنید، حتماً \f[V]upload_cutoff = 0\f[R] را
تنظیم کنید؛ در غیر این صورت با خطاهای سرآیند احراز هویت روبرو خواهید شد، چرا که
دستگاه snowball از احراز هویت بر پایه پارامتر کوئری پشتیبانی نمی‌کند.
.PP
در rclone نگارش v1.59 یا بالاتر، نیازی به تنظیم \f[V]upload_cutoff\f[R]
نخواهد بود.
.PP
برای نمونه:
.IP
.nf
\f[C]
[snowball]
type = s3
provider = Other
access_key_id = YOUR_ACCESS_KEY
secret_access_key = YOUR_SECRET_KEY
endpoint = http://[IP of Snowball]:8080
upload_cutoff = 0
\f[R]
.fi
.SS Alibaba OSS
.PP
در اینجا مثالی از انجام پیکربندی برای Alibaba Cloud (Aliyun)
OSS (https://www.alibabacloud.com/product/oss) آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> oss
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] \[dq]s3\[dq]
[snip]
Storage> s3
Choose your S3 provider.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / Amazon Web Services (AWS) S3
   \[rs] \[dq]AWS\[dq]
 2 / Alibaba Cloud Object Storage System (OSS) formerly Aliyun
   \[rs] \[dq]Alibaba\[dq]
 3 / Ceph Object Storage
   \[rs] \[dq]Ceph\[dq]
[snip]
provider> Alibaba
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Enter a boolean value (true or false). Press Enter for the default (\[dq]false\[dq]).
Choose a number from below, or type in your own value
 1 / Enter AWS credentials in the next step
   \[rs] \[dq]false\[dq]
 2 / Get AWS credentials from the environment (env vars or IAM)
   \[rs] \[dq]true\[dq]
env_auth> 1
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
access_key_id> accesskeyid
AWS Secret Access Key (password)
Leave blank for anonymous access or runtime credentials.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
secret_access_key> secretaccesskey
Endpoint for OSS API.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / East China 1 (Hangzhou)
   \[rs] \[dq]oss-cn-hangzhou.aliyuncs.com\[dq]
 2 / East China 2 (Shanghai)
   \[rs] \[dq]oss-cn-shanghai.aliyuncs.com\[dq]
 3 / North China 1 (Qingdao)
   \[rs] \[dq]oss-cn-qingdao.aliyuncs.com\[dq]
[snip]
endpoint> 1
Canned ACL used when creating buckets and storing or copying objects.

Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / Owner gets FULL_CONTROL. No one else has access rights (default).
   \[rs] \[dq]private\[dq]
 2 / Owner gets FULL_CONTROL. The AllUsers group gets READ access.
   \[rs] \[dq]public-read\[dq]
   / Owner gets FULL_CONTROL. The AllUsers group gets READ and WRITE access.
[snip]
acl> 1
The storage class to use when storing new objects in OSS.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / Default
   \[rs] \[dq]\[dq]
 2 / Standard storage class
   \[rs] \[dq]STANDARD\[dq]
 3 / Archive storage mode.
   \[rs] \[dq]GLACIER\[dq]
 4 / Infrequent access storage mode.
   \[rs] \[dq]STANDARD_IA\[dq]
storage_class> 1
Edit advanced config? (y/n)
y) Yes
n) No
y/n> n
Remote config
--------------------
[oss]
type = s3
provider = Alibaba
env_auth = false
access_key_id = accesskeyid
secret_access_key = secretaccesskey
endpoint = oss-cn-hangzhou.aliyuncs.com
acl = private
storage_class = Standard
--------------------
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS ArvanCloud
.PP
‏ArvanCloud (https://www.arvancloud.com/en/products/cloud-storage)
سرویس ذخیره‌سازی شیء‌محور ArvanCloud (Object Storage) فراتر از فضای محدود و سنتی ذخیره‌سازی فایل عمل می‌کند.
این سرویس دسترسی به فایل‌های پشتیبان و بایگانی‌شده را فراهم کرده و امکان به‌اشتراک‌گذاری آن‌ها را ممکن می‌سازد.
فایل‌هایی مانند تصویر پروفایل در برنامه، تصاویر ارسال‌شده توسط کاربران یا اسناد اسکن‌شده می‌توانند به‌سادگی و با امنیت بالا در سرویس Object Storage ذخیره شوند.
.PP
‏ArvanCloud یک رابط S3 ارائه می‌دهد که می‌تواند برای استفاده با rclone به صورت زیر پیکربندی شود.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
n/s> n
name> ArvanCloud
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Amazon S3 (also Dreamhost, Ceph, ChinaMobile, ArvanCloud, Liara, Minio)
   \[rs] \[dq]s3\[dq]
[snip]
Storage> s3
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars). Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own value
 1 / Enter AWS credentials in the next step
   \[rs] \[dq]false\[dq]
 2 / Get AWS credentials from the environment (env vars or IAM)
   \[rs] \[dq]true\[dq]
env_auth> 1
AWS Access Key ID - leave blank for anonymous access or runtime credentials.
access_key_id> YOURACCESSKEY
AWS Secret Access Key (password) - leave blank for anonymous access or runtime credentials.
secret_access_key> YOURSECRETACCESSKEY
Region to connect to.
Choose a number from below, or type in your own value
   / The default endpoint - a good choice if you are unsure.
 1 | US Region, Northern Virginia, or Pacific Northwest.
   | Leave location constraint empty.
   \[rs] \[dq]us-east-1\[dq]
[snip]
region> 
Endpoint for S3 API.
Leave blank if using ArvanCloud to use the default endpoint for the region.
Specify if using an S3 clone such as Ceph.
endpoint> s3.arvanstorage.com
Location constraint - must be set to match the Region. Used when creating buckets only.
Choose a number from below, or type in your own value
 1 / Empty for Iran-Tehran Region.
   \[rs] \[dq]\[dq]
[snip]
location_constraint>
Canned ACL used when creating buckets and/or storing objects in S3.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Choose a number from below, or type in your own value
 1 / Owner gets FULL_CONTROL. No one else has access rights (default).
   \[rs] \[dq]private\[dq]
[snip]
acl>
The server-side encryption algorithm used when storing this object in S3.
Choose a number from below, or type in your own value
 1 / None
   \[rs] \[dq]\[dq]
 2 / AES256
   \[rs] \[dq]AES256\[dq]
server_side_encryption>
The storage class to use when storing objects in S3.
Choose a number from below, or type in your own value
 1 / Default
   \[rs] \[dq]\[dq]
 2 / Standard storage class
   \[rs] \[dq]STANDARD\[dq]
storage_class>
Remote config
--------------------
[ArvanCloud]
env_auth = false
access_key_id = YOURACCESSKEY
secret_access_key = YOURSECRETACCESSKEY
region = ir-thr-at1
endpoint = s3.arvanstorage.com
location_constraint =
acl =
server_side_encryption =
storage_class =
--------------------
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
این پیکربندی باعث می‌شود فایل تنظیمات به شکل زیر درآید:
.IP
.nf
\f[C]
[ArvanCloud]
type = s3
provider = ArvanCloud
env_auth = false
access_key_id = YOURACCESSKEY
secret_access_key = YOURSECRETACCESSKEY
region =
endpoint = s3.arvanstorage.com
location_constraint =
acl =
server_side_encryption =
storage_class =
\f[R]
.fi.SS BizflyCloud
.PP
سرویس Bizfly Cloud Simple Storage (https://bizflycloud.vn/simple-storage) یک
سرویس سازگار با S3 همراه با ناحیه‌هایی در هانوی (HN) و شهر هوشی‌مین
(HCM) است.
.PP
از نقطه پایانی (endpoint) مربوط به ناحیه خود استفاده کنید:
.IP \[bu] 2
HN: \f[V]hn.ss.bfcplatform.vn\f[R]
.IP \[bu] 2
HCM: \f[V]hcm.ss.bfcplatform.vn\f[R]
.PP
یک پیکربندی کمینه شبیه به این خواهد بود:
.IP
.nf
\f[C]
[bizfly]
type = s3
provider = BizflyCloud
env_auth = false
access_key_id = YOUR_ACCESS_KEY
secret_access_key = YOUR_SECRET_KEY
region = HN
endpoint = hn.ss.bfcplatform.vn
location_constraint =
acl =
server_side_encryption =
storage_class =
\f[R]
.fi
.PP
برای شهر هوشی‌مین، \f[V]region\f[R] و \f[V]endpoint\f[R] را به \f[V]HCM\f[R] و
\f[V]hcm.ss.bfcplatform.vn\f[R] تغییر دهید.
.SS Ceph
.PP
سامانه Ceph (https://ceph.com) یک سیستم ذخیره‌سازی توزیع‌شده، یکپارچه
و متن‌باز است که برای کارایی عالی، قابلیت اطمینان و مقیاس‌پذیری طراحی شده است.
این سیستم یک رابط ذخیره‌سازی شیء سازگار با S3 دارد.
.PP
برای استفاده از rclone با Ceph، مانند بالا عمل کنید اما مقدار region را خالی
بگذارید و endpoint را تنظیم نمایید.
در نهایت فایل پیکربندی شما باید شبیه به این باشد:
.IP
.nf
\f[C]
[ceph]
type = s3
provider = Ceph
env_auth = false
access_key_id = XXX
secret_access_key = YYY
region =
endpoint = https://ceph.endpoint.example.com
location_constraint =
acl =
server_side_encryption =
storage_class =
\f[R]
.fi
.PP
اگر از نسخه قدیمی‌تری از CEPH (مانند
10.2.x Jewel) و نسخه‌ای از rclone پیش از v1.59 استفاده می‌کنید، ممکن است نیاز
باشد پارامتر \f[V]--s3-upload-cutoff 0\f[R] را مشخص کنید یا آن را به‌صورت
\f[V]upload_cutoff 0\f[R] در فایل پیکربندی قرار دهید تا اشکالی را که
باعث شکست در بارگذاری فایل‌های کوچک می‌شود، دور بزنید.
.PP
همچنین توجه داشته باشید که Ceph گاهی در گذرواژه‌هایی که به کاربران
می‌دهد از \f[V]/\f[R] استفاده می‌کند.
اگر کلید دسترسی محرمانه را با استفاده از ابزارهای خط فرمان بخوانید، یک خروجی JSON
دریافت خواهید کرد که در آن \f[V]/\f[R] به‌صورت \f[V]\[rs]/\f[R] گریز داده شده است.
اطمینان حاصل کنید که در کلید دسترسی محرمانه فقط \f[V]/\f[R] را می‌نویسید.
.PP
برای مثال، خروجی ساختار Ceph شبیه به این خواهد بود (کلیدهای نامربوط
حذف شده‌اند):
.IP
.nf
\f[C]
{
    \[dq]user_id\[dq]: \[dq]xxx\[dq],
    \[dq]display_name\[dq]: \[dq]xxxx\[dq],
    \[dq]keys\[dq]: [
        {
            \[dq]user\[dq]: \[dq]xxx\[dq],
            \[dq]access_key\[dq]: \[dq]xxxxxx\[dq],
            \[dq]secret_key\[dq]: \[dq]xxxxxx\[rs]/xxxx\[dq]
        }
    ],
}
\f[R]
.fi
.PP
به این دلیل که این یک خروجی json است، \f[V]/\f[R] را به‌صورت
\f[V]\[rs]/\f[R] کدگذاری می‌کند؛ بنابراین اگر از کلید محرمانه به‌صورت \f[V]xxxxxx/xxxx\f[R]
استفاده کنید، به‌درستی کار خواهد کرد..SS China Mobile Ecloud Elastic Object Storage (EOS)
.PP
در اینجا مثالی از ایجاد پیکربندی برای China Mobile Ecloud Elastic Object
Storage (EOS) (<https://ecloud.10086.cn/home/product-introduction/eos>)
آورده شده است.
ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> ChinaMobile
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
 ...
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] (s3)
 ...
Storage> s3
Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 ...
 4 / China Mobile Ecloud Elastic Object Storage (EOS)
   \[rs] (ChinaMobile)
 ...
provider> ChinaMobile
Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth>
Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> accesskeyid
Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> secretaccesskey
Option endpoint.
Endpoint for China Mobile Ecloud Elastic Object Storage (EOS) API.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / The default endpoint - a good choice if you are unsure.
 1 | East China (Suzhou)
   \[rs] (eos-wuxi-1.cmecloud.cn)
 2 / East China (Jinan)
   \[rs] (eos-jinan-1.cmecloud.cn)
 3 / East China (Hangzhou)
   \[rs] (eos-ningbo-1.cmecloud.cn)
 4 / East China (Shanghai-1)
   \[rs] (eos-shanghai-1.cmecloud.cn)
 5 / Central China (Zhengzhou)
   \[rs] (eos-zhengzhou-1.cmecloud.cn)
 6 / Central China (Changsha-1)
   \[rs] (eos-hunan-1.cmecloud.cn)
 7 / Central China (Changsha-2)
   \[rs] (eos-zhuzhou-1.cmecloud.cn)
 8 / South China (Guangzhou-2)
   \[rs] (eos-guangzhou-1.cmecloud.cn)
 9 / South China (Guangzhou-3)
   \[rs] (eos-dongguan-1.cmecloud.cn)
10 / North China (Beijing-1)
   \[rs] (eos-beijing-1.cmecloud.cn)
11 / North China (Beijing-2)
   \[rs] (eos-beijing-2.cmecloud.cn)
12 / North China (Beijing-3)
   \[rs] (eos-beijing-4.cmecloud.cn)
13 / North China (Huhehaote)
   \[rs] (eos-huhehaote-1.cmecloud.cn)
14 / Southwest China (Chengdu)
   \[rs] (eos-chengdu-1.cmecloud.cn)
15 / Southwest China (Chongqing)
   \[rs] (eos-chongqing-1.cmecloud.cn)
16 / Southwest China (Guiyang)
   \[rs] (eos-guiyang-1.cmecloud.cn)
17 / Nouthwest China (Xian)
   \[rs] (eos-xian-1.cmecloud.cn)
18 / Yunnan China (Kunming)
   \[rs] (eos-yunnan.cmecloud.cn)
19 / Yunnan China (Kunming-2)
   \[rs] (eos-yunnan-2.cmecloud.cn)
20 / Tianjin China (Tianjin)
   \[rs] (eos-tianjin-1.cmecloud.cn)
21 / Jilin China (Changchun)
   \[rs] (eos-jilin-1.cmecloud.cn)
22 / Hubei China (Xiangyan)
   \[rs] (eos-hubei-1.cmecloud.cn)
23 / Jiangxi China (Nanchang)
   \[rs] (eos-jiangxi-1.cmecloud.cn)
24 / Gansu China (Lanzhou)
   \[rs] (eos-gansu-1.cmecloud.cn)
25 / Shanxi China (Taiyuan)
   \[rs] (eos-shanxi-1.cmecloud.cn)
26 / Liaoning China (Shenyang)
   \[rs] (eos-liaoning-1.cmecloud.cn)
27 / Hebei China (Shijiazhuang)
   \[rs] (eos-hebei-1.cmecloud.cn)
28 / Fujian China (Xiamen)
   \[rs] (eos-fujian-1.cmecloud.cn)
29 / Guangxi China (Nanning)
   \[rs] (eos-guangxi-1.cmecloud.cn)
30 / Anhui China (Huainan)
   \[rs] (eos-anhui-1.cmecloud.cn)
endpoint> 1
Option location_constraint.
Location constraint - must match endpoint.
Used when creating buckets only.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / East China (Suzhou)
   \[rs] (wuxi1)
 2 / East China (Jinan)
   \[rs] (jinan1)
 3 / East China (Hangzhou)
   \[rs] (ningbo1)
 4 / East China (Shanghai-1)
   \[rs] (shanghai1)
 5 / Central China (Zhengzhou)
   \[rs] (zhengzhou1)
 6 / Central China (Changsha-1)
   \[rs] (hunan1)
 7 / Central China (Changsha-2)
   \[rs] (zhuzhou1)
 8 / South China (Guangzhou-2)
   \[rs] (guangzhou1)
 9 / South China (Guangzhou-3)
   \[rs] (dongguan1)
10 / North China (Beijing-1)
   \[rs] (beijing1)
11 / North China (Beijing-2)
   \[rs] (beijing2)
12 / North China (Beijing-3)
   \[rs] (beijing4)
13 / North China (Huhehaote)
   \[rs] (huhehaote1)
14 / Southwest China (Chengdu)
   \[rs] (chengdu1)
15 / Southwest China (Chongqing)
   \[rs] (chongqing1)
16 / Southwest China (Guiyang)
   \[rs] (guiyang1)
17 / Nouthwest China (Xian)
   \[rs] (xian1)
18 / Yunnan China (Kunming)
   \[rs] (yunnan)
19 / Yunnan China (Kunming-2)
   \[rs] (yunnan2)
20 / Tianjin China (Tianjin)
   \[rs] (tianjin1)
21 / Jilin China (Changchun)
   \[rs] (jilin1)
22 / Hubei China (Xiangyan)
   \[rs] (hubei1)
23 / Jiangxi China (Nanchang)
   \[rs] (jiangxi1)
24 / Gansu China (Lanzhou)
   \[rs] (gansu1)
25 / Shanxi China (Taiyuan)
   \[rs] (shanxi1)
26 / Liaoning China (Shenyang)
   \[rs] (liaoning1)
27 / Hebei China (Shijiazhuang)
   \[rs] (hebei1)
28 / Fujian China (Xiamen)
   \[rs] (fujian1)
29 / Guangxi China (Nanning)
   \[rs] (guangxi1)
30 / Anhui China (Huainan)
   \[rs] (anhui1)
location_constraint> 1
Option acl.
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
   / Owner gets FULL_CONTROL.
 2 | The AllUsers group gets READ access.
   \[rs] (public-read)
   / Owner gets FULL_CONTROL.
 3 | The AllUsers group gets READ and WRITE access.
   | Granting this on a bucket is generally not recommended.
   \[rs] (public-read-write)
   / Owner gets FULL_CONTROL.
 4 | The AuthenticatedUsers group gets READ access.
   \[rs] (authenticated-read)
   / Object owner gets FULL_CONTROL.
acl> private
Option server_side_encryption.
The server-side encryption algorithm used when storing this object in S3.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / None
   \[rs] ()
 2 / AES256
   \[rs] (AES256)
server_side_encryption>
Option storage_class.
The storage class to use when storing new objects in ChinaMobile.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Default
   \[rs] ()
 2 / Standard storage class
   \[rs] (STANDARD)
 3 / Archive storage mode
   \[rs] (GLACIER)
 4 / Infrequent access storage mode
   \[rs] (STANDARD_IA)
storage_class>
Edit advanced config?
y) Yes
n) No (default)
y/n> n
--------------------
[ChinaMobile]
type = s3
provider = ChinaMobile
access_key_id = accesskeyid
secret_access_key = secretaccesskey
endpoint = eos-wuxi-1.cmecloud.cn
location_constraint = wuxi1
acl = private
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R].fi
.SS Cloudflare R2
.PP
فضای ذخیره‌سازی Cloudflare R2 (https://blog.cloudflare.com/r2-open-beta) به توسعه‌دهندگان اجازه می‌دهد تا مقادیر زیادی از داده‌های بدون ساختار را بدون هزینه‌های گزاف پهنای باند خروجی که معمولاً با سرویس‌های معمولی ذخیره‌سازی ابری همراه است، ذخیره کنند.
.PP
در اینجا مثالی از ایجاد یک پیکربندی Cloudflare R2 آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این فرمان شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند.
.PP
توجه داشته باشید که تمام باکت‌ها خصوصی هستند و همگی در همان ناحیهٔ \[dq]auto\[dq] ذخیره می‌شوند.
برای به اشتراک‌گذاری عمومی محتوای یک باکت، استفاده از Cloudflare workers ضروری است.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> r2
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
\&...
XX / Amazon S3 Compliant Storage Providers including AWS, Alibaba, Ceph, China Mobile, Cloudflare, ArvanCloud, DigitalOcean, Dreamhost, Huawei OBS, IBM COS, Lyve Cloud, Minio, Magalu, Netease, RackCorp, Scaleway, SeaweedFS, Storj, Synology, Tencent COS and Wasabi
   \[rs] (s3)
\&...
Storage> s3
Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
\&...
XX / Cloudflare R2 Storage
   \[rs] (Cloudflare)
\&...
provider> Cloudflare
Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 1
Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> ACCESS_KEY
Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> SECRET_ACCESS_KEY
Option region.
Region to connect to.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / R2 buckets are automatically distributed across Cloudflare\[aq]s data centers for low latency.
   \[rs] (auto)
region> 1
Option endpoint.
Endpoint for S3 API.
Required when using an S3 clone.
Enter a value. Press Enter to leave empty.
endpoint> https://ACCOUNT_ID.r2.cloudflarestorage.com
Edit advanced config?
y) Yes
n) No (default)
y/n> n
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
این کار باعث می‌شود پیکربندی شما چیزی شبیه به این باشد:
.IP
.nf
\f[C]
[r2]
type = s3
provider = Cloudflare
access_key_id = ACCESS_KEY
secret_access_key = SECRET_ACCESS_KEY
region = auto
endpoint = https://ACCOUNT_ID.r2.cloudflarestorage.com
acl = private
\f[R]
.fi
.PP
اکنون برای دیدن باکت‌های خود \f[V]rclone lsf r2:\f[R] و برای مشاهدهٔ درون یک باکت \f[V]rclone lsf r2:bucket\f[R] را اجرا کنید.
.PP
برای توکن‌های R2 با مجوز \[dq]Object Read & Write\[dq]، ممکن است لازم باشد \f[V]no_check_bucket = true\f[R] را نیز اضافه کنید تا بارگذاری اشیاء به درستی کار کند.
.PP
توجه داشته باشید که Cloudflare فایل‌های بارگذاری‌شده با \f[V]Content-Encoding: gzip\f[R] را به طور پیش‌فرض از حالت فشرده خارج می‌کند که این رفتار با عملکرد AWS متفاوت است.
اگر این موضوع باعث ایجاد مشکل می‌شود، فایل‌ها را با \f[V]--header-upload \[dq]Cache-Control: no-transform\[dq]\f[R] بارگذاری کنید.
.PP
پیامد این امر آن است که \f[V]Content-Encoding: gzip\f[R] هرگز در متادیتا در Cloudflare ظاهر نخواهد شد..SS Cubbit DS3
.PP
فضای ذخیره‌سازی شیء Cubbit (https://www.cubbit.io/ds3-cloud) یک پلتفرم ابری ذخیره‌سازی شیء با توزیع جغرافیایی است.
.PP
برای اتصال به Cubbit DS3 به یک جفت کلید دسترسی (access key) و کلید محرمانه (secret key) نیاز خواهید داشت.
می‌توانید برای دریافت این کلیدها از این
راهنما (https://docs.cubbit.io/getting-started/quickstart#api-keys) پیروی کنید.
هنگامی که \f[V]rclone config\f[R] آن‌ها را درخواست کرد، به این کلیدها نیاز خواهد بود.
.PP
ناحیه پیش‌فرض معادل \f[V]eu-west-1\f[R] خواهد بود و نقطه پایانی (endpoint)
باید به صورت \f[V]s3.cubbit.eu\f[R] مشخص شود.
اگر یک نقطه پایانی سفارشی برای مستأجر (tenant) تنظیم کرده‌اید، باید از
\f[V]s3.{tenant_name}.cubbit.eu\f[R] استفاده کنید، زیرا نقطه پایانی عمومی
\f[V]s3.cubbit.eu\f[R] در این حالت کار نخواهد کرد.
.PP
در طول کل فرایند ایجاد یک ریموت جدید با اجرای
\f[V]rclone config\f[R]، به هر اعلان باید همان‌طور که در زیر نشان داده شده پاسخ داده شود:
.IP
.nf
\f[C]
name> cubbit-ds3 (or any name you like)
Storage> s3
provider> Cubbit
env_auth> false
access_key_id> YOUR_ACCESS_KEY
secret_access_key> YOUR_SECRET_KEY
region> eu-west-1 (or leave empty)
endpoint> s3.cubbit.eu (or s3.{tenant_name}.cubbit.eu)
acl>
\f[R]
.fi
.PP
فایل پیکربندی حاصل باید شبیه به این باشد:
.IP
.nf
\f[C]
[cubbit-ds3]
type = s3
provider = Cubbit
access_key_id = ACCESS_KEY
secret_access_key = SECRET_KEY
region = eu-west-1
endpoint = s3.cubbit.eu
\f[R]
.fi
.PP
سپس می‌توانید استفاده از Cubbit DS3 را با rclone آغاز کنید.
به عنوان مثال، برای ایجاد یک باکت (bucket) جدید و کپی کردن فایل‌ها در آن، می‌توانید اجرا کنید:
.IP
.nf
\f[C]
rclone mkdir cubbit-ds3:my-bucket
rclone copy /path/to/files cubbit-ds3:my-bucket
\f[R]
.fi
.SS DigitalOcean Spaces
.PP
سرویس Spaces (https://www.digitalocean.com/products/object-storage) یک سرویس ذخیره‌سازی شیء
سازگار با S3 (https://developers.digitalocean.com/documentation/spaces)
از ارائه‌دهنده ابری DigitalOcean است.
.PP
برای اتصال به DigitalOcean Spaces به یک کلید دسترسی (access key) و کلید محرمانه
(secret key) نیاز خواهید داشت.
این کلیدها را می‌توان در برگه Applications &
API (https://cloud.digitalocean.com/settings/api/tokens) در کنترل‌پنل
DigitalOcean دریافت کرد.
هنگامی که \f[V]rclone config\f[R] مقادیر
\f[V]access_key_id\f[R] و \f[V]secret_access_key\f[R] را درخواست می‌کند، به آن‌ها نیاز خواهد بود.
.PP
هنگامی که اعلان مربوط به \f[V]region\f[R] یا \f[V]location_constraint\f[R] نمایش داده شد،
کلید enter را فشار دهید تا مقدار پیش‌فرض اعمال شود.
ناحیه باید در تنظیمات \f[V]endpoint\f[R] گنجانده شود (مانند
\f[V]nyc3.digitaloceanspaces.com\f[R]).
برای سایر تنظیمات می‌توان از مقادیر پیش‌فرض استفاده کرد.
.PP
در طول کل فرایند ایجاد یک ریموت جدید با اجرای
\f[V]rclone config\f[R]، به هر اعلان باید همان‌طور که در زیر نشان داده شده پاسخ داده شود:
.IP
.nf
\f[C]
Storage> s3
env_auth> 1
access_key_id> YOUR_ACCESS_KEY
secret_access_key> YOUR_SECRET_KEY
region>
endpoint> nyc3.digitaloceanspaces.com
location_constraint>
acl>
storage_class>
\f[R]
.fi
.PP
فایل پیکربندی حاصل باید شبیه به این باشد:
.IP
.nf
\f[C]
[spaces]
type = s3
provider = DigitalOcean
env_auth = false
access_key_id = YOUR_ACCESS_KEY
secret_access_key = YOUR_SECRET_KEY
region =
endpoint = nyc3.digitaloceanspaces.com
location_constraint =
acl =
server_side_encryption =
storage_class =
\f[R]
.fi
.PP
پس از پیکربندی، می‌توانید یک Space جدید بسازید و کپی کردن فایل‌ها را آغاز کنید.
به عنوان مثال:
.IP
.nf
\f[C]
rclone mkdir spaces:my-new-space
rclone copy /path/to/files spaces:my-new-space
\f[R]
.fi.SS Dreamhost
.PP
سرویس Dreamhost DreamObjects (https://www.dreamhost.com/cloud/storage) یک سامانه ذخیره‌سازی شیء مبتنی بر CEPH است.
.PP
برای استفاده از rclone با Dreamhost، پیکربندی را مطابق بالا انجام دهید اما فیلد region را خالی گذاشته و endpoint را تنظیم کنید.
در نهایت پرونده پیکربندی شما باید شبیه به این باشد:
.IP
.nf
\f[C]
[dreamobjects]
type = s3
provider = DreamHost
env_auth = false
access_key_id = your_access_key
secret_access_key = your_secret_key
region =
endpoint = objects-us-west-1.dream.io
location_constraint =
acl = private
server_side_encryption =
storage_class =
\f[R]
.fi
.SS Exaba
.PP
سرویس Exaba (https://exaba.com) یک سامانه ذخیره‌سازی محلی (on-premises) و سازگار با S3 برای ارائه‌دهندگان خدمات و سازمان‌های بزرگ است.
استقرار آن سریع بوده و دارای مدیریت پویای گره‌ها، حسابداری چندمستأجری (tenant accounting) و سامانه مدیریت کلید توکار است.
این سرویس ذخیره‌سازی امن و با کارایی بالای داده‌ها را به همراه قیمت‌گذاری انعطاف‌پذیر و مبتنی بر مصرف فراهم می‌کند.
.PP
یک نسخه کانتینری با نام exaba/exaba (https://hub.docker.com/r/exaba/exaba) برای کاربران نهایی رایگان است و می‌توانید دستورالعمل‌های راه‌اندازی آن را در همان صفحه بیابید.
برای راه‌اندازی کانتینر، ابتدا باید وارد بخش مدیریت (به‌طور پیش‌فرض روی پورت 9006) شوید، سپس می‌توانید از خدمات روی پورت 9000 استفاده کنید.
.PP
در صورت نیاز به راهنمایی بیشتر، می‌توانید به کانال اسلک پشتیبانی exaba
(https://join.slack.com/t/exabasupport/shared_invite/zt-3b5jycjs3-0gDNyv60xKsAdNgjX72amQ)
نیز بپیوندید.
.PP
مراحل اجرای تعاملی دستور \f[V]rclone config\f[R] ممکن است شبیه به نمونه زیر باشد، اما جزئیات بسته به نحوه دقیق راه‌اندازی کانتینر توسط شما ممکن است متفاوت باشد.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> exaba

Option Storage.
Type of storage to configure.
Storage> s3

Option provider.
Choose your S3 provider.
provider> Exaba

Option env_auth.
env_auth> 1

Option access_key_id.
access_key_id> XXX

Option secret_access_key.
secret_access_key> YYY

Option region.
region>

Option endpoint.
endpoint> http://127.0.0.1:9000

Option location_constraint.
location_constraint>

Option acl.
acl>

Edit advanced config?
y) Yes
n) No (default)
y/n> n
\f[R]
.fi
.PP
و پیکربندی تولیدشده در نهایت به این شکل خواهد بود:
.IP
.nf
\f[C]
[exaba]
type = s3
provider = Exaba
access_key_id = XXX
secret_access_key = XXX
endpoint = http://127.0.0.1:9000
\f[R]
.fi.SS ذخیره‌سازی شیء Fastly (Fastly Object Storage)
.PP
سرویس Fastly Object Storage (https://www.fastly.com/products/storage) یک سرویس ذخیره‌سازی شیء سازگار با S3 از Fastly است.
این سرویس سه منطقه (US East، US West و EU Central) را به همراه رمزنگاری اجباری سمت سرور فراهم می‌کند.
.PP
در اینجا مثالی از ایجاد یک پیکربندی آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> fastly

Option Storage.
Type of storage to configure.
Storage> s3

Option provider.
Choose your S3 provider.
provider> Fastly

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
env_auth> false

Option access_key_id.
AWS Access Key ID.
access_key_id> YOUR_ACCESS_KEY

Option secret_access_key.
AWS Secret Access Key (password).
secret_access_key> YOUR_SECRET_KEY

Option region.
Region where your bucket will be created and your data stored.
region> us-east

Option endpoint.
Endpoint for S3 API.
endpoint> us-east.object.fastlystorage.app

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: s3
- provider: Fastly
- access_key_id: YOUR_ACCESS_KEY
- secret_access_key: YOUR_SECRET_KEY
- region: us-east
- endpoint: us-east.object.fastlystorage.app
Keep this \[dq]fastly\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
فایل پیکربندی حاصل باید به صورت زیر باشد:
.IP
.nf
\f[C]
[fastly]
type = s3
provider = Fastly
access_key_id = YOUR_ACCESS_KEY
secret_access_key = YOUR_SECRET_KEY
region = us-east
endpoint = us-east.object.fastlystorage.app
\f[R]
.fi.SS ذخیره‌سازی ابری گوگل (Google Cloud Storage)
.PP
سرویس GoogleCloudStorage (https://cloud.google.com/storage/docs) یک سرویس
ذخیره‌سازی شیء با قابلیت هم‌کنش‌پذیری با S3 (https://cloud.google.com/storage/docs/interoperability)
از Google Cloud Platform است.
.PP
برای اتصال به Google Cloud Storage به یک کلید دسترسی (access key) و یک کلید
محرمانه (secret key) نیاز خواهید داشت.
این کلیدها را می‌توان با ساخت یک کلید
HMAC (https://cloud.google.com/storage/docs/authentication/managing-hmackeys) دریافت کرد.
.IP
.nf
\f[C]
[gs]
type = s3
provider = GCS
access_key_id = your_access_key
secret_access_key = your_secret_key
endpoint = https://storage.googleapis.com
\f[R]
.fi
.PP
\f[B]توجه\f[R] داشته باشید که گزینهٔ \f[V]--s3-versions\f[R] هنگام نیاز به
صفحه‌بندی دایرکتوری (directory paging) با GCS کار نمی‌کند.
در این حالت Rclone خطای زیر را بازمی‌گرداند:
.IP
.nf
\f[C]
s3 protocol error: received versions listing with IsTruncated set with no NextKeyMarker
\f[R]
.fi
.PP
این مورد مربوط به باگ شمارهٔ
#312292516 (https://issuetracker.google.com/u/0/issues/312292516) در گوگل است.
.SS ذخیره‌سازی شیء هتزنر (Hetzner Object Storage)
.PP
در ادامه یک نمونه از ایجاد پیکربندی برای Hetzner Object
Storage (https://www.hetzner.com/storage/object-storage) آورده شده است.
ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند.
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> my-hetzner
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
 XX / Amazon S3 Compliant Storage Providers including AWS, Alibaba, ArvanCloud, Ceph, ChinaMobile, Cloudflare, DigitalOcean, Dreamhost, GCS, Hetzner, HuaweiOBS, IBMCOS, IDrive, IONOS, LyveCloud, Leviia, Liara, Linode, Magalu, Minio, Netease, Outscale, Petabox, RackCorp, Rclone, Scaleway, SeaweedFS, Selectel, Storj, Synology, TencentCOS, Wasabi, Qiniu and others
   \[rs] (s3)
[snip]
Storage> s3
Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / Hetzner Object Storage
   \[rs] (Hetzner)
[snip]
provider> Hetzner
Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 
Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> ACCESS_KEY
Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> SECRET_KEY
Option region.
Region to connect to.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Helsinki
   \[rs] (hel1)
 2 / Falkenstein
   \[rs] (fsn1)
 3 / Nuremberg
   \[rs] (nbg1)
region> 
Option endpoint.
Endpoint for Hetzner Object Storage
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Helsinki
   \[rs] (hel1.your-objectstorage.com)
 2 / Falkenstein
   \[rs] (fsn1.your-objectstorage.com)
 3 / Nuremberg
   \[rs] (nbg1.your-objectstorage.com)
endpoint> 
Option location_constraint.
Location constraint - must be set to match the Region.
Leave blank if not sure. Used when creating buckets only.
Enter a value. Press Enter to leave empty.
location_constraint> 
Option acl.
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
If the acl is an empty string then no X-Amz-Acl: header is added and
the default (private) will be used.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
   / Owner gets FULL_CONTROL.
 2 | The AllUsers group gets READ access.
   \[rs] (public-read)
acl> 
Edit advanced config?
y) Yes
n) No (default)
y/n> 
Configuration complete.
Options:
- type: s3
- provider: Hetzner
- access_key_id: ACCESS_KEY
- secret_access_key: SECRET_KEY
Keep this \[dq]my-hetzner\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> 
Current remotes:

Name                 Type
====                 ====
my-hetzner           s3

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> 
\f[R]
.fi
.PP
در نتیجه، فایل پیکربندی به این شکل خواهد بود:
.IP
.nf
\f[C]
[my-hetzner]
type = s3
provider = Hetzner
access_key_id = ACCESS_KEY
secret_access_key = SECRET_KEY
region = hel1
endpoint = hel1.your-objectstorage.com
acl = private
\f[R]
.fi.SS Hitachi Content Platform (HCP)
.PP
در اینجا نمونه‌ای از انجام پیکربندی برای Hitachi Content Platform
(HCP) (https://www.hitachivantara.com/en-us/products/storage/content-platform.html)
آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این کار شما را در طول یک فرایند راه‌اندازی تعاملی هدایت خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> my-hcp
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
 XX / Amazon S3 Compliant Storage Providers including AWS, Alibaba, ArvanCloud, Ceph, ChinaMobile, Cloudflare, DigitalOcean, Dreamhost, GCS, HCP, Hetzner, HuaweiOBS, IBMCOS, IDrive, IONOS, LyveCloud, Leviia, Liara, Linode, Magalu, Minio, Netease, Outscale, Petabox, RackCorp, Rclone, Scaleway, SeaweedFS, Selectel, Storj, Synology, TencentCOS, Wasabi, Qiniu and others
   \[rs] (s3)
[snip]
Storage> s3
Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / Hitachi Content Platform (HCP)
   \[rs] (HCP)
[snip]
provider> HCP
Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 
Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> ACCESS_KEY
Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> SECRET_KEY
Option endpoint.
Endpoint for HCP S3 compatible API.
Enter a value. Press Enter to leave empty.
endpoint> https://hcp.example.com
Edit advanced config?
y) Yes
n) No (default)
y/n> 
Configuration complete.
Options:
- type: s3
- provider: HCP
- access_key_id: ACCESS_KEY
- secret_access_key: SECRET_KEY
- endpoint: https://hcp.example.com
Keep this \[dq]my-hcp\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> 
Current remotes:

Name                 Type
====                 ====
my-hcp               s3

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> 
\f[R]
.fi
.PP
این کار باعث می‌شود فایل پیکربندی بدین صورت شکل بگیرد:
.IP
.nf
\f[C]
[my-hcp]
type = s3
provider = HCP
access_key_id = ACCESS_KEY
secret_access_key = SECRET_KEY
endpoint = https://hcp.example.com
\f[R]
.fi.SS "محدودیت‌های شناخته‌شده (Known limitations)"
.PP
این محدودیت‌ها در HCP نسخهٔ 9.7.x مشاهده شده‌اند.
.PP
\f[B]اشیای دایرکتوری خودکار\f[R]
.PP
هنگامی که یک شیء ذخیره می‌شود، HCP به‌طور خودکار اشیای دایرکتوری صفر\-بایتی (کلیدهایی که به
\f[V]/\f[R] ختم می‌شوند) را برای هر بخش از مسیر ایجاد می‌کند.
این اشیای دایرکتوری به‌صورت داخلی توسط HCP مدیریت می‌شوند: حذف یکی از آن‌ها از طریق
S3 API آن را حذف نمی‌کند، بلکه یک نشانگر حذف (delete marker) با یک
شناسهٔ نسخهٔ ویژه (\f[V]-3\f[R]) ایجاد می‌کند که خودش قابل حذف نیست.
در نتیجه، rclone نمی‌تواند یک باکت را در HCP به‌طور کامل پاکسازی (purge) کند \[em] اشیای
دایرکتوری باقی‌مانده پس از یک عملیات \f[V]purge\f[R] یا
\f[V]delete\f[R] باقی خواهند ماند.
.PP
\f[B]خروج شفاف از فشرده‌سازی gzip\f[R]
.PP
سرویس HCP پیش از ذخیره‌سازی اشیایی که با \f[V]Content-Encoding: gzip\f[R] بارگذاری شده‌اند، آن‌ها را
به‌صورت شفاف از فشرده‌سازی خارج می‌کند (https://docs.hitachivantara.com/r/en-us/content-platform/9.6.x/mk-95hcph002/using-the-hitachi-api-for-amazon-s3/working-with-objects/creating-an-object).
این بدان معناست که شیء ذخیره‌شده حاوی داده‌های خام (فشرده‌نشده) است، در حالی
که \f[V]Content-MD5\f[R] ارسال‌شده توسط rclone بر روی بایت‌های فشرده محاسبه شده بود.
سرویس HCP چنین بارگذاری‌هایی را با خطای \f[V]BadDigest\f[R] رد خواهد کرد.
برای جلوگیری از این امر، هنگام استفاده از HCP مقدار \f[V]content-encoding: gzip\f[R] را در
فراداده‌های شیء تنظیم نکنید.
.SS "Huawei OBS"
.PP
سرویس Object Storage Service (OBS) یک ذخیره‌سازی ابری پایدار، امن، کارآمد و با
کاربری آسان ارائه می‌دهد که به شما امکان می‌دهد تقریباً هر حجم از داده‌های
ساختارنیافته را در هر قالبی ذخیره کرده و از هر کجایی به آن دسترسی داشته باشید.
.PP
سرویس OBS یک رابط S3 ارائه می‌دهد؛ می‌توانید پیکربندی زیر را کپی و ویرایش کرده
و آن را به فایل پیکربندی rclone خود اضافه کنید.
.IP
.nf
\f[C]
[obs]
type = s3
provider = HuaweiOBS
access_key_id = your-access-key-id
secret_access_key = your-secret-access-key
region = af-south-1
endpoint = obs.af-south-1.myhuaweicloud.com
acl = private
\f[R]
.fi
.PP
یا همچنین می‌توانید از طریق خط فرمان تعاملی اقدام به پیکربندی کنید:
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> obs
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] (s3)
[snip]
Storage> s3
Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
 9 / Huawei Object Storage Service
   \[rs] (HuaweiOBS)
[snip]
provider> 9
Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 1
Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> your-access-key-id
Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> your-secret-access-key
Option region.
Region to connect to.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / AF-Johannesburg
   \[rs] (af-south-1)
 2 / AP-Bangkok
   \[rs] (ap-southeast-2)
[snip]
region> 1
Option endpoint.
Endpoint for OBS API.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / AF-Johannesburg
   \[rs] (obs.af-south-1.myhuaweicloud.com)
 2 / AP-Bangkok
   \[rs] (obs.ap-southeast-2.myhuaweicloud.com)
[snip]
endpoint> 1
Option acl.
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
[snip]
acl> 1
Edit advanced config?
y) Yes
n) No (default)
y/n>
--------------------
[obs]
type = s3
provider = HuaweiOBS
access_key_id = your-access-key-id
secret_access_key = your-secret-access-key
region = af-south-1
endpoint = obs.af-south-1.myhuaweicloud.com
acl = private
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
Current remotes:

Name                 Type
====                 ====
obs                  s3

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> q
\f[R]
.fi.SS IBM COS (S3)
.PP
اطلاعات ذخیره‌شده در IBM Cloud Object Storage رمزگذاری شده و در چندین موقعیت جغرافیایی توزیع می‌شوند و از طریق پیاده‌سازی API مربوط به S3 قابل دسترسی هستند.
این سرویس از فناوری‌های ذخیره‌سازی توزیع‌شده ارائه‌شده توسط IBM\[cq]s Cloud Object Storage System (که پیش‌تر Cleversafe نامیده می‌شد) بهره می‌برد.
برای اطلاعات بیشتر ببینید: <http://www.ibm.com/cloud/object-storage>
.PP
برای پیکربندی دسترسی به IBM COS S3، مراحل زیر را دنبال کنید:
.IP " 1." 4
دستور rclone config را اجرا کرده و گزینه n را برای یک ریموت جدید انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
2018/02/14 14:13:11 NOTICE: Config file \[dq]C:\[rs]\[rs]Users\[rs]\[rs]a\[rs]\[rs].config\[rs]\[rs]rclone\[rs]\[rs]rclone.conf\[dq] not found - using defaults
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
\f[R]
.fi
.RE
.IP " 2." 4
نامی برای پیکربندی وارد کنید.
.RS 4
.IP
.nf
\f[C]
name> <YOUR NAME>
\f[R]
.fi
.RE
.IP " 3." 4
فضای ذخیره‌سازی \[dq]s3\[dq] را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
Choose a number from below, or type in your own value
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] \[dq]s3\[dq]
[snip]
Storage> s3
\f[R]
.fi
.RE
.IP " 4." 4
گزینه IBM COS را به عنوان ارائه‌دهنده فضای ذخیره‌سازی S3 انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
Choose the S3 provider.
Choose a number from below, or type in your own value
   1 / Choose this option to configure Storage to AWS S3
     \[rs] \[dq]AWS\[dq]
   2 / Choose this option to configure Storage to Ceph Systems
     \[rs] \[dq]Ceph\[dq]
   3 /  Choose this option to configure Storage to Dreamhost
     \[rs] \[dq]Dreamhost\[dq]
   4 / Choose this option to the configure Storage to IBM COS S3
     \[rs] \[dq]IBMCOS\[dq]
   5 / Choose this option to the configure Storage to Minio
     \[rs] \[dq]Minio\[dq]
   Provider>4
\f[R]
.fi
.RE
.IP " 5." 4
کلید دسترسی (Access Key) و Secret را وارد کنید.
.RS 4
.IP
.nf
\f[C]
AWS Access Key ID - leave blank for anonymous access or runtime credentials.
access_key_id> <>
AWS Secret Access Key (password) - leave blank for anonymous access or runtime credentials.
secret_access_key> <>
\f[R]
.fi
.RE
.IP " 6." 4
نقطه پایانی (endpoint) را برای IBM COS مشخص کنید.
برای IBM COS عمومی (Public)، از گزینه‌های زیر انتخاب کنید.
برای IBM COS محلی (On Premise)، یک نشانی endpoint وارد کنید.
.RS 4
.IP
.nf
\f[C]
Endpoint for IBM COS S3 API.
Specify if using an IBM COS On Premise.
Choose a number from below, or type in your own value
 1 / US Cross Region Endpoint
   \[rs] \[dq]s3-api.us-geo.objectstorage.softlayer.net\[dq]
 2 / US Cross Region Dallas Endpoint
   \[rs] \[dq]s3-api.dal.us-geo.objectstorage.softlayer.net\[dq]
 3 / US Cross Region Washington DC Endpoint
   \[rs] \[dq]s3-api.wdc-us-geo.objectstorage.softlayer.net\[dq]
 4 / US Cross Region San Jose Endpoint
   \[rs] \[dq]s3-api.sjc-us-geo.objectstorage.softlayer.net\[dq]
 5 / US Cross Region Private Endpoint
   \[rs] \[dq]s3-api.us-geo.objectstorage.service.networklayer.com\[dq]
 6 / US Cross Region Dallas Private Endpoint
   \[rs] \[dq]s3-api.dal-us-geo.objectstorage.service.networklayer.com\[dq]
 7 / US Cross Region Washington DC Private Endpoint
   \[rs] \[dq]s3-api.wdc-us-geo.objectstorage.service.networklayer.com\[dq]
 8 / US Cross Region San Jose Private Endpoint
   \[rs] \[dq]s3-api.sjc-us-geo.objectstorage.service.networklayer.com\[dq]
 9 / US Region East Endpoint
   \[rs] \[dq]s3.us-east.objectstorage.softlayer.net\[dq]
10 / US Region East Private Endpoint
   \[rs] \[dq]s3.us-east.objectstorage.service.networklayer.com\[dq]
11 / US Region South Endpoint
[snip]
34 / Toronto Single Site Private Endpoint
   \[rs] \[dq]s3.tor01.objectstorage.service.networklayer.com\[dq]
endpoint>1
\f[R]
.fi
.RE
.IP " 7." 4
محدودیت مکان (Location Constraint) را برای IBM COS مشخص کنید.
هنگام استفاده از IBM Cloud عمومی (Public)، محدودیت مکان باید با endpoint مطابقت داشته باشد.
برای COS محلی (on-prem)، گزینه‌ای از این فهرست انتخاب نکرده و کلید enter را فشار دهید.
.RS 4
.IP
.nf
\f[C]
 1 / US Cross Region Standard
   \[rs] \[dq]us-standard\[dq]
 2 / US Cross Region Vault
   \[rs] \[dq]us-vault\[dq]
 3 / US Cross Region Cold
   \[rs] \[dq]us-cold\[dq]
 4 / US Cross Region Flex
   \[rs] \[dq]us-flex\[dq]
 5 / US East Region Standard
   \[rs] \[dq]us-east-standard\[dq]
 6 / US East Region Vault
   \[rs] \[dq]us-east-vault\[dq]
 7 / US East Region Cold
   \[rs] \[dq]us-east-cold\[dq]
 8 / US East Region Flex
   \[rs] \[dq]us-east-flex\[dq]
 9 / US South Region Standard
   \[rs] \[dq]us-south-standard\[dq]
10 / US South Region Vault
   \[rs] \[dq]us-south-vault\[dq]
[snip]
32 / Toronto Flex
   \[rs] \[dq]tor01-flex\[dq]
location_constraint>1
\f[R]
.fi
.RE
.IP " 8." 4
یک canned ACL مشخص کنید.
سرویس IBM Cloud (Storage) از \[dq]public-read\[dq] و
\[dq]private\[dq] پشتیبانی می‌کند.
سرویس IBM Cloud(Infra) از تمام canned ACLها پشتیبانی می‌کند.
سرویس On-Premise COS از تمام canned ACLها پشتیبانی می‌کند.
.RS 4
.IP
.nf
\f[C]
Canned ACL used when creating buckets and/or storing objects in S3.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Choose a number from below, or type in your own value
      1 / Owner gets FULL_CONTROL. No one else has access rights (default). This acl is available on IBM Cloud (Infra), IBM Cloud (Storage), On-Premise COS
      \[rs] \[dq]private\[dq]
      2  / Owner gets FULL_CONTROL. The AllUsers group gets READ access. This acl is available on IBM Cloud (Infra), IBM Cloud (Storage), On-Premise IBM COS
      \[rs] \[dq]public-read\[dq]
      3 / Owner gets FULL_CONTROL. The AllUsers group gets READ and WRITE access. This acl is available on IBM Cloud (Infra), On-Premise IBM COS
      \[rs] \[dq]public-read-write\[dq]
      4  / Owner gets FULL_CONTROL. The AuthenticatedUsers group gets READ access. Not supported on Buckets. This acl is available on IBM Cloud (Infra) and On-Premise IBM COS
      \[rs] \[dq]authenticated-read\[dq]
acl> 1
\f[R]
.fi
.RE.IP " 9." 4
پیکربندی نمایش‌داده‌شده را بررسی کرده و برای ذخیرهٔ \[dq]remote\[dq] تأیید کنید، سپس خارج شوید.
فایل پیکربندی باید شبیه به این باشد
.RS 4
.IP
.nf
\f[C]
[xxx]
type = s3
Provider = IBMCOS
access_key_id = xxx
secret_access_key = yyy
endpoint = s3-api.us-geo.objectstorage.softlayer.net
location_constraint = us-standard
acl = private
\f[R]
.fi
.RE
.IP "10." 4
دستورهای rclone را اجرا کنید
.IP
.nf
\f[C]
1) Create a bucket.
   rclone mkdir IBM-COS-XREGION:newbucket
2) List available buckets.
   rclone lsd IBM-COS-XREGION:
   -1 2017-11-08 21:16:22        -1 test
   -1 2018-02-14 20:16:39        -1 newbucket
3) List contents of a bucket.
    rclone ls IBM-COS-XREGION:newbucket
    18685952 test.exe
4) Copy a file from local to remote.
   rclone copy /Users/file.txt IBM-COS-XREGION:newbucket
5) Copy a file from remote to local.
   rclone copy IBM-COS-XREGION:newbucket/file.txt .
6) Delete a file on remote.
   rclone delete IBM-COS-XREGION:newbucket/file.txt
\f[R]
.fi
.SS احراز هویت IBM IAM
.PP
در صورت استفاده از احراز هویت IBM IAM با IBM API KEY، لازم است این پارامترهای اضافی را تکمیل کنید
.IP "1." 3
برای env_auth مقدار false را انتخاب کنید
.IP "2." 3
مقدارهای \f[V]access_key_id\f[R] و \f[V]secret_access_key\f[R] را خالی بگذارید
.IP "3." 3
مقدار \f[V]ibm_api_key\f[R] خود را جای‌گذاری کنید
.RS 4
.IP
.nf
\f[C]
Option ibm_api_key.
IBM API Key to be used to obtain IAM token
Enter a value of type string. Press Enter for the default (1).
ibm_api_key>
\f[R]
.fi
.RE
.IP "4." 3
مقدار \f[V]ibm_resource_instance_id\f[R] خود را جای‌گذاری کنید
.RS 4
.IP
.nf
\f[C]
Option ibm_resource_instance_id.
IBM service instance id
Enter a value of type string. Press Enter for the default (2).
ibm_resource_instance_id>
\f[R]
.fi
.RE
.IP "5." 3
در تنظیمات پیشرفته برای \f[V]v2_auth\f[R] مقدار true را تایپ کنید
.RS 4
.IP
.nf
\f[C]
Option v2_auth.
If true use v2 authentication.
If this is false (the default) then rclone will use v4 authentication.
If it is set then rclone will use v2 authentication.
Use this only if v4 signatures don\[aq]t work, e.g. pre Jewel/v10 CEPH.
Enter a boolean value (true or false). Press Enter for the default (true).
v2_auth>
\f[R]
.fi
.RE.SS IDrive e2
.PP
در اینجا مثالی از ایجاد یک پیکربندی IDrive e2 (<https://www.idrive.com/e2>) آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> e2

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] (s3)
[snip]
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / IDrive e2
   \[rs] (IDrive)
[snip]
provider> IDrive

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> YOUR_ACCESS_KEY

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> YOUR_SECRET_KEY

Option acl.
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
   / Owner gets FULL_CONTROL.
 2 | The AllUsers group gets READ access.
   \[rs] (public-read)
   / Owner gets FULL_CONTROL.
 3 | The AllUsers group gets READ and WRITE access.
   | Granting this on a bucket is generally not recommended.
   \[rs] (public-read-write)
   / Owner gets FULL_CONTROL.
 4 | The AuthenticatedUsers group gets READ access.
   \[rs] (authenticated-read)
   / Object owner gets FULL_CONTROL.
 5 | Bucket owner gets READ access.
   | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.
   \[rs] (bucket-owner-read)
   / Both the object owner and the bucket owner get FULL_CONTROL over the object.
 6 | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.
   \[rs] (bucket-owner-full-control)
acl> 

Edit advanced config?
y) Yes
n) No (default)
y/n> 

Configuration complete.
Options:
- type: s3
- provider: IDrive
- access_key_id: YOUR_ACCESS_KEY
- secret_access_key: YOUR_SECRET_KEY
- endpoint: q9d9.la12.idrivee2-5.com
Keep this \[dq]e2\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS Impossible Cloud
.PP
Impossible Cloud (https://www.impossiblecloud.com) یک ارائه‌دهنده اروپایی ذخیره‌سازی اشیاء سازگار با S3 با ناحیه‌هایی در اروپا و ایالات متحده است.
.PP
نکته: Impossible Cloud فیلدهای فراداده سیستمی \f[V]Cache-Control\f[R]،
\f[V]Content-Disposition\f[R]، \f[V]Content-Encoding\f[R] یا
\f[V]Content-Language\f[R] را هنگام واکشی حفظ نمی‌کند، حتی اگر در زمان بارگذاری
تنظیم شده باشند.
از آنجا که سربرگ پاسخ \f[V]Content-Encoding\f[R] نیز حذف می‌شود،
پرچم \f[V]--s3-decompress\f[R] هیچ تأثیری بر اشیاء ذخیره‌شده در آنجا
نخواهد داشت.
سایر فراداده‌ها مانند \f[V]Content-Type\f[R] و زمان تغییر، به صورت عادی
حفظ و بازگردانده می‌شوند.
.PP
در اینجا یک نمونه از ایجاد پیکربندی برای Impossible Cloud آورده شده است.
ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این کار شما را در یک فرآیند راه‌اندازی تعاملی راهنمایی خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> my-impossible-cloud
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
 XX / Amazon S3 Compliant Storage Providers including AWS, Alibaba, ArvanCloud, Ceph, ChinaMobile, Cloudflare, DigitalOcean, Dreamhost, GCS, Hetzner, HuaweiOBS, IBMCOS, IDrive, ImpossibleCloud, IONOS, LyveCloud, Leviia, Liara, Linode, Magalu, Minio, Netease, Outscale, Petabox, RackCorp, Rclone, Scaleway, SeaweedFS, Selectel, Storj, Synology, TencentCOS, Wasabi, Qiniu and others
   \[rs] (s3)
[snip]
Storage> s3
Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / Impossible Cloud Object Storage
   \[rs] (ImpossibleCloud)
[snip]
provider> ImpossibleCloud
Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 
Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> ACCESS_KEY
Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> SECRET_KEY
Option region.
Region to connect to.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Frankfurt, Germany
   \[rs] (eu-central-2)
 2 / Amsterdam, Netherlands
   \[rs] (eu-west-1)
 3 / London, UK
   \[rs] (eu-west-2)
 4 / Paris, France
   \[rs] (eu-west-3)
 5 / Poznań, Poland
   \[rs] (eu-east-1)
 6 / Copenhagen, Denmark
   \[rs] (eu-north-1)
 7 / New York, USA
   \[rs] (us-east-1)
region> 1
Option endpoint.
Endpoint for Impossible Cloud Object Storage
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Frankfurt, Germany
   \[rs] (eu-central-2.storage.impossibleapi.net)
 2 / Amsterdam, Netherlands
   \[rs] (eu-west-1.storage.impossibleapi.net)
 3 / London, UK
   \[rs] (eu-west-2.storage.impossibleapi.net)
 4 / Paris, France
   \[rs] (eu-west-3.storage.impossibleapi.net)
 5 / Poznań, Poland
   \[rs] (eu-east-1.storage.impossibleapi.net)
 6 / Copenhagen, Denmark
   \[rs] (eu-north-1.storage.impossibleapi.net)
 7 / New York, USA
   \[rs] (us-east-1.storage.impossibleapi.net)
endpoint> 1
Option location_constraint.
Location constraint - must be set to match the Region.
Leave blank if not sure. Used when creating buckets only.
Enter a value. Press Enter to leave empty.
location_constraint> 
Option acl.
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
If the acl is an empty string then no X-Amz-Acl: header is added and
the default (private) will be used.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
   / Owner gets FULL_CONTROL.
 2 | The AllUsers group gets READ access.
   \[rs] (public-read)
acl> 
Edit advanced config?
y) Yes
n) No (default)
y/n> 
Configuration complete.
Options:
- type: s3
- provider: ImpossibleCloud
- access_key_id: ACCESS_KEY
- secret_access_key: SECRET_KEY
- region: eu-central-2
- endpoint: eu-central-2.storage.impossibleapi.net
Keep this \[dq]my-impossible-cloud\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> 
Current remotes:

Name                 Type
====                 ====
my-impossible-cloud  s3

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> 
\f[R]
.fi
.PP
در نتیجه، فایل پیکربندی به شکل زیر خواهد بود:
.IP
.nf
\f[C]
[my-impossible-cloud]
type = s3
provider = ImpossibleCloud
access_key_id = ACCESS_KEY
secret_access_key = SECRET_KEY
region = eu-central-2
endpoint = eu-central-2.storage.impossibleapi.net
acl = private
\f[R]
.fi.SS ذخیره‌سازی شیء Intercolo (Intercolo Object Storage)
.PP
سرویس Intercolo Object Storage (https://intercolo.de/object-storage) یک فضای ذخیره‌سازی ابری سازگار با S3، با قیمت‌گذاری شفاف و منطبق با مقررات GDPR ارائه می‌دهد که در فرانکفورت آلمان میزبانی می‌شود.
.PP
در اینجا نمونه‌ای از نحوهٔ ایجاد یک پیکربندی برای Intercolo آورده شده است.
.PP
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند.
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> intercolo

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
 xx / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] (s3)
[snip]
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
xx / Intercolo Object Storage
   \[rs] (Intercolo)
[snip]
provider> Intercolo

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> false

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> ACCESS_KEY

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> SECRET_KEY

Option region.
Region where your bucket will be created and your data stored.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Frankfurt, Germany
   \[rs] (de-fra)
region> 1

Option endpoint.
Endpoint for Intercolo Object Storage.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Frankfurt, Germany
   \[rs] (de-fra.i3storage.com)
endpoint> 1

Option acl.
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
If the acl is an empty string then no X-Amz-Acl: header is added and
the default (private) will be used.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
 [snip]
acl> 

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: s3
- provider: Intercolo
- access_key_id: ACCESS_KEY
- secret_access_key: SECRET_KEY
- region: de-fra
- endpoint: de-fra.i3storage.com
Keep this \[dq]intercolo\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
در نهایت فایل پیکربندی به این شکل خواهد بود:
.IP
.nf
\f[C]
[intercolo]
type = s3
provider = Intercolo
access_key_id = ACCESS_KEY
secret_access_key = SECRET_KEY
region = de-fra
endpoint = de-fra.i3storage.com
\f[R]
.fi.SS IONOS Cloud
.PP
سرویس IONOS S3 Object Storage (https://cloud.ionos.com/storage/object-storage)
یک سرویس ارائه‌شده توسط IONOS برای ذخیره‌سازی و دسترسی به داده‌های
بدون ساختار است.
برای اتصال به این سرویس، به یک access key و یک secret key نیاز خواهید داشت.
این کلیدها را می‌توانید در Data Center Designer (https://dcd.ionos.com) با رفتن
به مسیر \f[B]Manager resources\f[R] > \f[B]Object Storage Key
Manager\f[R] پیدا کنید.
.PP
در ادامه نمونه‌ای از پیکربندی آورده شده است.
ابتدا دستور \f[V]rclone config\f[R] را اجرا کنید.
این کار شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند.
برای افزودن ریموت جدید، \f[V]n\f[R] را وارد کرده و سپس یک نام وارد نمایید:
.IP
.nf
\f[C]
Enter name for new remote.
name> ionos-fra
\f[R]
.fi
.PP
برای انتخاب نوع اتصال، \f[V]s3\f[R] را تایپ کنید:
.IP
.nf
\f[C]
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] (s3)
[snip]
Storage> s3
\f[R]
.fi
.PP
عبارت \f[V]IONOS\f[R] را وارد کنید:
.IP
.nf
\f[C]
Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / IONOS Cloud
   \[rs] (IONOS)
[snip]
provider> IONOS
\f[R]
.fi
.PP
برای انتخاب گزینهٔ پیش‌فرض
\f[V]Enter AWS credentials in the next step\f[R] کلید Enter را فشار دهید:
.IP
.nf
\f[C]
Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth>
\f[R]
.fi
.PP
شناسهٔ Access Key و Secret key خود را وارد نمایید.
این مقادیر را می‌توانید از طریق Data Center
Designer (https://dcd.ionos.com) و کلیک روی منوی \[dq]Manager
resources\[dq] / \[dq]Object Storage Key Manager\[dq] دریافت کنید.
.IP
.nf
\f[C]
Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> YOUR_ACCESS_KEY

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> YOUR_SECRET_KEY
\f[R]
.fi
.PP
منطقه‌ای (region) را که باکت شما در آن قرار دارد انتخاب کنید:
.IP
.nf
\f[C]
Option region.
Region where your bucket will be created and your data stored.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Frankfurt, Germany
   \[rs] (de)
 2 / Berlin, Germany
   \[rs] (eu-central-2)
 3 / Logrono, Spain
   \[rs] (eu-south-2)
region> 2
\f[R]
.fi
.PP
نقطهٔ پایانی (endpoint) مربوط به همان منطقه را انتخاب کنید:
.IP
.nf
\f[C]
Option endpoint.
Endpoint for IONOS S3 Object Storage.
Specify the endpoint from the same region.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Frankfurt, Germany
   \[rs] (s3-eu-central-1.ionoscloud.com)
 2 / Berlin, Germany
   \[rs] (s3-eu-central-2.ionoscloud.com)
 3 / Logrono, Spain
   \[rs] (s3-eu-south-2.ionoscloud.com)
endpoint> 1
\f[R]
.fi
.PP
برای انتخاب گزینه پیش‌فرض کلید Enter را فشار دهید یا تنظیمات ACL
مورد نظر خود را تعیین کنید:
.IP
.nf
\f[C]
Option acl.
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
   / Owner gets FULL_CONTROL.
[snip]
acl>
\f[R]
.fi
.PP
برای صرف‌نظر از پیکربندی پیشرفته، کلید Enter را فشار دهید:
.IP
.nf
\f[C]
Edit advanced config?
y) Yes
n) No (default)
y/n>
\f[R]
.fi
.PP
برای ذخیره پیکربندی کلید Enter را فشار دهید، و سپس با فشردن \f[V]q\f[R] از فرایند
پیکربندی خارج شوید:
.IP
.nf
\f[C]
Configuration complete.
Options:
- type: s3
- provider: IONOS
- access_key_id: YOUR_ACCESS_KEY
- secret_access_key: YOUR_SECRET_KEY
- endpoint: s3-eu-central-1.ionoscloud.com
Keep this \[dq]ionos-fra\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.PP
انجام شد!
اکنون می‌توانید چند دستور را امتحان کنید (برای macOS، به جای \f[V]rclone\f[R] از \f[V]./rclone\f[R] استفاده کنید).
.IP "1)" 3
ایجاد یک باکت (نام باید در کل IONOS S3 یکتا باشد)
.RS 4
.IP
.nf
\f[C]
rclone mkdir ionos-fra:my-bucket
\f[R]
.fi
.RE
.IP "2)" 3
فهرست کردن باکت‌های موجود
.RS 4
.IP
.nf
\f[C]
rclone lsd ionos-fra:
\f[R]
.fi
.RE
.IP "3)" 3
کپی یک فایل از محلی به ریموت
.RS 4
.IP
.nf
\f[C]
rclone copy /Users/file.txt ionos-fra:my-bucket
\f[R]
.fi
.RE
.IP "4)" 3
فهرست کردن محتویات یک باکت
.RS 4
.IP
.nf
\f[C]
rclone ls ionos-fra:my-bucket
\f[R]
.fi
.RE
.IP "5)" 3
کپی یک فایل از ریموت به محلی
.RS 4
.IP
.nf
\f[C]
rclone copy ionos-fra:my-bucket/file.txt
\f[R]
.fi
.RE
.SS ذخیره‌سازی ابری شیء Leviia (Leviia Cloud Object Storage)
.PP
ذخیره‌سازی شیء Leviia (https://www.leviia.com/object-storage)، پشتیبان‌گیری
و امن‌سازی داده‌های شما در یک ابر ۱۰۰٪ فرانسوی و مستقل از GAFAM..
.PP
برای پیکربندی دسترسی به Leviia، مراحل زیر را دنبال کنید:
.IP "1." 3
دستور \f[V]rclone config\f[R] را اجرا کرده و برای یک ریموت جدید \f[V]n\f[R] را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
rclone config
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
\f[R]
.fi
.RE
.IP "2." 3
نام پیکربندی را وارد کنید.
برای نمونه، نام آن را \[aq]leviia\[aq] بگذارید.
.RS 4
.IP
.nf
\f[C]
name> leviia
\f[R]
.fi
.RE
.IP "3." 3
فضای ذخیره‌سازی \f[V]s3\f[R] را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
Choose a number from below, or type in your own value
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] (s3)
[snip]
Storage> s3
\f[R]
.fi
.RE
.IP "4." 3
ارائه‌دهندهٔ \f[V]Leviia\f[R] را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
Choose a number from below, or type in your own value
1 / Amazon Web Services (AWS) S3
   \[rs] \[dq]AWS\[dq]
[snip]
15 / Leviia Object Storage
   \[rs] (Leviia)
[snip]
provider> Leviia
\f[R]
.fi
.RE
.IP "5." 3
شناسهٔ SecretId و SecretKey مربوط به Leviia را وارد کنید.
.RS 4
.IP
.nf
\f[C]
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Enter a boolean value (true or false). Press Enter for the default (\[dq]false\[dq]).
Choose a number from below, or type in your own value
 1 / Enter AWS credentials in the next step
   \[rs] \[dq]false\[dq]
 2 / Get AWS credentials from the environment (env vars or IAM)
   \[rs] \[dq]true\[dq]
env_auth> 1
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
access_key_id> ZnIx.xxxxxxxxxxxxxxx
AWS Secret Access Key (password)
Leave blank for anonymous access or runtime credentials.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
secret_access_key> xxxxxxxxxxx
\f[R]
.fi
.RE
.IP "6." 3
نقطهٔ پایانی (endpoint) را برای Leviia انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
   / The default endpoint
 1 | Leviia.
   \[rs] (s3.leviia.com)
[snip]
endpoint> 1
\f[R]
.fi
.RE
.IP "7." 3
سطح دسترسی (acl) را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
   / Owner gets FULL_CONTROL.
 2 | The AllUsers group gets READ access.
   \[rs] (public-read)
[snip]
acl> 1
Edit advanced config? (y/n)
y) Yes
n) No (default)
y/n> n
Remote config
--------------------
[leviia]
- type: s3
- provider: Leviia
- access_key_id: ZnIx.xxxxxxx
- secret_access_key: xxxxxxxx
- endpoint: s3.leviia.com
- acl: private
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
Current remotes:

Name                 Type
====                 ====
leviia                s3
\f[R]
.fi
.RE.SS لیارا (Liara)
.PP
در اینجا نمونه‌ای از ایجاد یک پیکربندی برای فضای ذخیره‌سازی اشیاء لیارا (<https://liara.ir/landing/object-storage>) آورده شده است.
ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی هدایت خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
n/s> n
name> Liara
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Amazon S3 (also Dreamhost, Ceph, ChinaMobile, ArvanCloud, Liara, Minio)
   \[rs] \[dq]s3\[dq]
[snip]
Storage> s3
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars). Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own value
 1 / Enter AWS credentials in the next step
   \[rs] \[dq]false\[dq]
 2 / Get AWS credentials from the environment (env vars or IAM)
   \[rs] \[dq]true\[dq]
env_auth> 1
AWS Access Key ID - leave blank for anonymous access or runtime credentials.
access_key_id> YOURACCESSKEY
AWS Secret Access Key (password) - leave blank for anonymous access or runtime credentials.
secret_access_key> YOURSECRETACCESSKEY
Region to connect to.
Choose a number from below, or type in your own value
   / The default endpoint
 1 | US Region, Northern Virginia, or Pacific Northwest.
   | Leave location constraint empty.
   \[rs] \[dq]us-east-1\[dq]
[snip]
region>
Endpoint for S3 API.
Leave blank if using Liara to use the default endpoint for the region.
Specify if using an S3 clone such as Ceph.
endpoint> storage.iran.liara.space
Canned ACL used when creating buckets and/or storing objects in S3.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Choose a number from below, or type in your own value
 1 / Owner gets FULL_CONTROL. No one else has access rights (default).
   \[rs] \[dq]private\[dq]
[snip]
acl>
The server-side encryption algorithm used when storing this object in S3.
Choose a number from below, or type in your own value
 1 / None
   \[rs] \[dq]\[dq]
 2 / AES256
   \[rs] \[dq]AES256\[dq]
server_side_encryption>
The storage class to use when storing objects in S3.
Choose a number from below, or type in your own value
 1 / Default
   \[rs] \[dq]\[dq]
 2 / Standard storage class
   \[rs] \[dq]STANDARD\[dq]
storage_class>
Remote config
--------------------
[Liara]
env_auth = false
access_key_id = YOURACCESSKEY
secret_access_key = YOURSECRETACCESSKEY
endpoint = storage.iran.liara.space
location_constraint =
acl =
server_side_encryption =
storage_class =
--------------------
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
این عمل فایل پیکربندی را به شکل زیر درمی‌آورد:
.IP
.nf
\f[C]
[Liara]
type = s3
provider = Liara
env_auth = false
access_key_id = YOURACCESSKEY
secret_access_key = YOURSECRETACCESSKEY
region =
endpoint = storage.iran.liara.space
location_constraint =
acl =
server_side_encryption =
storage_class =
\f[R]
.fi.SS Linode
.PP
در اینجا نمونه‌ای از ایجاد پیکربندی برای Linode Object
Storage (https://www.linode.com/products/object-storage) آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> linode

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...Linode, ...and others
   \[rs] (s3)
[snip]
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / Linode Object Storage
   \[rs] (Linode)
[snip]
provider> Linode

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> ACCESS_KEY

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> SECRET_ACCESS_KEY

Option endpoint.
Endpoint for Linode Object Storage API.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Amsterdam (Netherlands), nl-ams-1
   \[rs] (nl-ams-1.linodeobjects.com)
 2 / Atlanta, GA (USA), us-southeast-1
   \[rs] (us-southeast-1.linodeobjects.com)
 3 / Chennai (India), in-maa-1
   \[rs] (in-maa-1.linodeobjects.com)
 4 / Chicago, IL (USA), us-ord-1
   \[rs] (us-ord-1.linodeobjects.com)
 5 / Frankfurt (Germany), eu-central-1
   \[rs] (eu-central-1.linodeobjects.com)
 6 / Jakarta (Indonesia), id-cgk-1
   \[rs] (id-cgk-1.linodeobjects.com)
 7 / London 2 (Great Britain), gb-lon-1
   \[rs] (gb-lon-1.linodeobjects.com)
 8 / Los Angeles, CA (USA), us-lax-1
   \[rs] (us-lax-1.linodeobjects.com)
 9 / Madrid (Spain), es-mad-1
   \[rs] (es-mad-1.linodeobjects.com)
10 / Melbourne (Australia), au-mel-1
   \[rs] (au-mel-1.linodeobjects.com)
11 / Miami, FL (USA), us-mia-1
   \[rs] (us-mia-1.linodeobjects.com)
12 / Milan (Italy), it-mil-1
   \[rs] (it-mil-1.linodeobjects.com)
13 / Newark, NJ (USA), us-east-1
   \[rs] (us-east-1.linodeobjects.com)
14 / Osaka (Japan), jp-osa-1
   \[rs] (jp-osa-1.linodeobjects.com)
15 / Paris (France), fr-par-1
   \[rs] (fr-par-1.linodeobjects.com)
16 / São Paulo (Brazil), br-gru-1
   \[rs] (br-gru-1.linodeobjects.com)
17 / Seattle, WA (USA), us-sea-1
   \[rs] (us-sea-1.linodeobjects.com)
18 / Singapore, ap-south-1
   \[rs] (ap-south-1.linodeobjects.com)
19 / Singapore 2, sg-sin-1
   \[rs] (sg-sin-1.linodeobjects.com)
20 / Stockholm (Sweden), se-sto-1
   \[rs] (se-sto-1.linodeobjects.com)
21 / Washington, DC, (USA), us-iad-1
   \[rs] (us-iad-1.linodeobjects.com)
endpoint> 5

Option acl.
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
If the acl is an empty string then no X-Amz-Acl: header is added and
the default (private) will be used.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
[snip]
acl> 

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: s3
- provider: Linode
- access_key_id: ACCESS_KEY
- secret_access_key: SECRET_ACCESS_KEY
- endpoint: eu-central-1.linodeobjects.com
Keep this \[dq]linode\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
در نتیجه فایل پیکربندی به این صورت خواهد بود:
.IP
.nf
\f[C]
[linode]
type = s3
provider = Linode
access_key_id = ACCESS_KEY
secret_access_key = SECRET_ACCESS_KEY
endpoint = eu-central-1.linodeobjects.com
\f[R]
.fi.SS Magalu
.PP
در اینجا مثالی از ایجاد یک پیکربندی Magalu Object Storage (<https://magalu.cloud/object-storage>) آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> magalu

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...Magalu, ...and others
   \[rs] (s3)
[snip]
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / Magalu Object Storage
   \[rs] (Magalu)
[snip]
provider> Magalu

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 1

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> ACCESS_KEY

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> SECRET_ACCESS_KEY

Option endpoint.
Endpoint for Magalu Object Storage API.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / São Paulo, SP (BR), br-se1
   \[rs] (br-se1.magaluobjects.com)
 2 / Fortaleza, CE (BR), br-ne1
   \[rs] (br-ne1.magaluobjects.com)
endpoint> 2

Option acl.
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
If the acl is an empty string then no X-Amz-Acl: header is added and
the default (private) will be used.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
[snip]
acl> 

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: s3
- provider: magalu
- access_key_id: ACCESS_KEY
- secret_access_key: SECRET_ACCESS_KEY
- endpoint: br-ne1.magaluobjects.com
Keep this \[dq]magalu\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
این کار باعث می‌شود فایل پیکربندی به این صورت درآید:
.IP
.nf
\f[C]
[magalu]
type = s3
provider = Magalu
access_key_id = ACCESS_KEY
secret_access_key = SECRET_ACCESS_KEY
endpoint = br-ne1.magaluobjects.com
\f[R]
.fi.SS MEGA S4
.PP
ذخیره‌سازی شیء MEGA S4 (<https://mega.io/objectstorage>) یک سامانه ذخیره‌سازی شیء سازگار با S3 است.
این سرویس دارای یک سطح قیمت‌گذاری واحد و بدون هزینه اضافی برای انتقال داده‌ها یا درخواست‌های API است و در طرح‌های Pro فعلی گنجانده شده است.
.PP
در اینجا نمونه‌ای از نحوه انجام پیکربندی آورده شده است.
ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرآیند راه‌اندازی تعاملی راهنمایی خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> megas4

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS,... Mega, ...
   \[rs] (s3)
[snip]
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / MEGA S4 Object Storage
   \[rs] (Mega)
[snip]
provider> Mega

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth>

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> XXX

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> XXX

Option endpoint.
Endpoint for S3 API.
Required when using an S3 clone.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Mega S4 eu-central-1 (Amsterdam)
   \[rs] (s3.eu-central-1.s4.mega.io)
 2 / Mega S4 eu-central-2 (Bettembourg)
   \[rs] (s3.eu-central-2.s4.mega.io)
 3 / Mega S4 ca-central-1 (Montreal)
   \[rs] (s3.ca-central-1.s4.mega.io)
 4 / Mega S4 ca-west-1 (Vancouver)
   \[rs] (s3.ca-west-1.s4.mega.io)
endpoint> 1

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: s3
- provider: Mega
- access_key_id: XXX
- secret_access_key: XXX
- endpoint: s3.eu-central-1.s4.mega.io
Keep this \[dq]megas4\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
در نتیجه، فایل پیکربندی به صورت زیر خواهد بود.
.IP
.nf
\f[C]
[megas4]
type = s3
provider = Mega
access_key_id = XXX
secret_access_key = XXX
endpoint = s3.eu-central-1.s4.mega.io
\f[R]
.fi.SS Minio
.PP
Minio (https://minio.io) یک سرور ذخیره‌سازی شیء (object storage) است که برای
توسعه‌دهندگان برنامه‌های ابری و DevOps ساخته شده است.
.PP
نصب آن بسیار آسان است و یک سرور سازگار با S3 فراهم می‌کند که
می‌تواند توسط rclone مورد استفاده قرار گیرد.
.PP
برای استفاده از آن، Minio را طبق دستورالعمل‌های
اینجا (https://docs.minio.io/docs/minio-quickstart-guide) نصب کنید.
.PP
هنگامی که Minio پیکربندی می‌شود، خروجی‌ای مشابه این چاپ خواهد کرد
.IP
.nf
\f[C]
Endpoint:  http://192.168.1.106:9000  http://172.23.0.1:9000
AccessKey: USWUXHGYZQYFYFFIT3RE
SecretKey: MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03
Region:    us-east-1
SQS ARNs:  arn:minio:sqs:us-east-1:1:redis arn:minio:sqs:us-east-1:2:redis

Browser Access:
   http://192.168.1.106:9000  http://172.23.0.1:9000

Command-line Access: https://docs.minio.io/docs/minio-client-quickstart-guide
   $ mc config host add myminio http://192.168.1.106:9000 USWUXHGYZQYFYFFIT3RE MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03

Object API (Amazon S3 compatible):
   Go:         https://docs.minio.io/docs/golang-client-quickstart-guide
   Java:       https://docs.minio.io/docs/java-client-quickstart-guide
   Python:     https://docs.minio.io/docs/python-client-quickstart-guide
   JavaScript: https://docs.minio.io/docs/javascript-client-quickstart-guide
   .NET:       https://docs.minio.io/docs/dotnet-client-quickstart-guide

Drive Capacity: 26 GiB Free, 165 GiB Total
\f[R]
.fi
.PP
این جزئیات باید به این صورت در \f[V]rclone config\f[R] وارد شوند.
توجه داشته باشید که وارد کردن region مطابق آنچه در بالا آمده، حائز اهمیت است.
.IP
.nf
\f[C]
env_auth> 1
access_key_id> USWUXHGYZQYFYFFIT3RE
secret_access_key> MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03
region> us-east-1
endpoint> http://192.168.1.106:9000
location_constraint>
server_side_encryption>
\f[R]
.fi
.PP
که باعث می‌شود فایل پیکربندی به این شکل درآید
.IP
.nf
\f[C]
[minio]
type = s3
provider = Minio
env_auth = false
access_key_id = USWUXHGYZQYFYFFIT3RE
secret_access_key = MOJRH0mkL1IPauahWITSVvyDrQbEEIwljvmxdq03
region = us-east-1
endpoint = http://192.168.1.106:9000
location_constraint =
server_side_encryption =
\f[R]
.fi
.PP
بنابراین پس از راه‌اندازی، برای مثال، جهت کپی کردن فایل‌ها به یک bucket
.IP
.nf
\f[C]
rclone copy /path/to/files minio:bucket
\f[R]
.fi
.SS Netease NOS
.PP
برای Netease NOS، از طریق ابزار پیکربندی
\f[V]rclone config\f[R] اقدام کرده و ارائه‌دهنده را روی \f[V]Netease\f[R] تنظیم کنید.
این کار به‌طور خودکار مقدار \f[V]force_path_style = false\f[R] را تعیین می‌کند که
برای کارکرد صحیح آن ضروری است..SS Outscale
.PP
سرویس ذخیره‌سازی شیء اوت‌اسکیل
(OOS) (https://en.outscale.com/storage/outscale-object-storage) یک
سرویس ذخیره‌سازی در ردهٔ سازمانی و سازگار با S3 است که توسط OUTSCALE،
برندی از Dassault Systèmes ارائه می‌شود.
برای اطلاعات بیشتر دربارهٔ OOS، مستندات رسمی را ببینید
(https://docs.outscale.com/en/userguide/OUTSCALE-Object-Storage-OOS.html).
.PP
در اینجا نمونه‌ای از یک پیکربندی OOS آورده شده است که می‌توانید آن را در
فایل پیکربندی rclone خود جای‌گذاری کنید:
.IP
.nf
\f[C]
[outscale]
type = s3
provider = Outscale
env_auth = false
access_key_id = ABCDEFGHIJ0123456789
secret_access_key = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
region = eu-west-2
endpoint = oos.eu-west-2.outscale.com
acl = private
\f[R]
.fi
.PP
همچنین می‌توانید برای طی کردن مراحل راه‌اندازی تعاملی، \f[V]rclone config\f[R]
را اجرا کنید:
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
\f[R]
.fi
.IP
.nf
\f[C]
Enter name for new remote.
name> outscale
\f[R]
.fi
.IP
.nf
\f[C]
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
 X / Amazon S3 Compliant Storage Providers including AWS, ...Outscale, ...and others
   \[rs] (s3)
[snip]
Storage> outscale
\f[R]
.fi
.IP
.nf
\f[C]
Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / OUTSCALE Object Storage (OOS)
   \[rs] (Outscale)
[snip]
provider> Outscale
\f[R]
.fi
.IP
.nf
\f[C]
Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 
\f[R]
.fi
.IP
.nf
\f[C]
Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> ABCDEFGHIJ0123456789
\f[R]
.fi
.IP
.nf
\f[C]
Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
\f[R]
.fi
.IP
.nf
\f[C]
Option region.
Region where your bucket will be created and your data stored.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Paris, France
   \[rs] (eu-west-2)
 2 / New Jersey, USA
   \[rs] (us-east-2)
 3 / California, USA
   \[rs] (us-west-1)
 4 / SecNumCloud, Paris, France
   \[rs] (cloudgouv-eu-west-1)
 5 / Tokyo, Japan
   \[rs] (ap-northeast-1)
region> 1
\f[R]
.fi
.IP
.nf
\f[C]
Option endpoint.
Endpoint for S3 API.
Required when using an S3 clone.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Outscale EU West 2 (Paris)
   \[rs] (oos.eu-west-2.outscale.com)
 2 / Outscale US east 2 (New Jersey)
   \[rs] (oos.us-east-2.outscale.com)
 3 / Outscale EU West 1 (California)
   \[rs] (oos.us-west-1.outscale.com)
 4 / Outscale SecNumCloud (Paris)
   \[rs] (oos.cloudgouv-eu-west-1.outscale.com)
 5 / Outscale AP Northeast 1 (Japan)
   \[rs] (oos.ap-northeast-1.outscale.com)
endpoint> 1
\f[R]
.fi
.IP
.nf
\f[C]
Option acl.
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
If the acl is an empty string then no X-Amz-Acl: header is added and
the default (private) will be used.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
[snip]
acl> 1
\f[R]
.fi
.IP
.nf
\f[C]
Edit advanced config?
y) Yes
n) No (default)
y/n> n
\f[R]
.fi
.IP
.nf
\f[C]
Configuration complete.
Options:
- type: s3
- provider: Outscale
- access_key_id: ABCDEFGHIJ0123456789
- secret_access_key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
- endpoint: oos.eu-west-2.outscale.com
Keep this \[dq]outscale\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS OVHcloud
.PP
سرویس OVHcloud Object
Storage (https://www.ovhcloud.com/en-ie/public-cloud/object-storage) یک
پلتفرم ذخیره‌سازی شیء همه‌منظوره و سازگار با S3 است که در تمام مناطق
OVHcloud در دسترس قرار دارد.
برای استفاده از این پلتفرم، به یک access key و secret key نیاز خواهید داشت.
برای کسب اطلاعات بیشتر دربارهٔ آن و نحوهٔ تعامل با این پلتفرم، مستندات آن را
در (https://ovh.to/8stqhuo) مشاهده کنید.
.PP
در اینجا نمونه‌ای از ایجاد یک پیکربندی OVHcloud Object Storage با
استفاده از \f[V]rclone config\f[R] آورده شده است:
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> ovhcloud-rbx

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[...]
 XX / Amazon S3 Compliant Storage Providers including AWS, Alibaba, ArvanCloud, Ceph, ChinaMobile, Cloudflare, DigitalOcean, Dreamhost, GCS, HuaweiOBS, IBMCOS, IDrive, IONOS, LyveCloud, Leviia, Liara, Linode, Magalu, Minio, Netease, Outscale, OVHcloud, Petabox, RackCorp, Rclone, Scaleway, SeaweedFS, Selectel, Storj, Synology, TencentCOS, Wasabi, Qiniu and others
   \[rs] (s3)
[...]
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[...]
XX / OVHcloud Object Storage
   \[rs] (OVHcloud)
[...]
provider> OVHcloud

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 1

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> my_access

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> my_secret

Option region.
Region where your bucket will be created and your data stored.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Gravelines, France
   \[rs] (gra)
 2 / Roubaix, France
   \[rs] (rbx)
 3 / Strasbourg, France
   \[rs] (sbg)
 4 / Paris, France (3AZ)
   \[rs] (eu-west-par)
 5 / Frankfurt, Germany
   \[rs] (de)
 6 / London, United Kingdom
   \[rs] (uk)
 7 / Warsaw, Poland
   \[rs] (waw)
 8 / Beauharnois, Canada
   \[rs] (bhs)
 9 / Toronto, Canada
   \[rs] (ca-east-tor)
10 / Singapore
   \[rs] (sgp)
11 / Sydney, Australia
   \[rs] (ap-southeast-syd)
12 / Mumbai, India
   \[rs] (ap-south-mum)
13 / Vint Hill, Virginia, USA
   \[rs] (us-east-va)
14 / Hillsboro, Oregon, USA
   \[rs] (us-west-or)
15 / Roubaix, France (Cold Archive)
   \[rs] (rbx-archive)
region> 2

Option endpoint.
Endpoint for OVHcloud Object Storage.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / OVHcloud Gravelines, France
   \[rs] (s3.gra.io.cloud.ovh.net)
 2 / OVHcloud Roubaix, France
   \[rs] (s3.rbx.io.cloud.ovh.net)
 3 / OVHcloud Strasbourg, France
   \[rs] (s3.sbg.io.cloud.ovh.net)
 4 / OVHcloud Paris, France (3AZ)
   \[rs] (s3.eu-west-par.io.cloud.ovh.net)
 5 / OVHcloud Frankfurt, Germany
   \[rs] (s3.de.io.cloud.ovh.net)
 6 / OVHcloud London, United Kingdom
   \[rs] (s3.uk.io.cloud.ovh.net)
 7 / OVHcloud Warsaw, Poland
   \[rs] (s3.waw.io.cloud.ovh.net)
 8 / OVHcloud Beauharnois, Canada
   \[rs] (s3.bhs.io.cloud.ovh.net)
 9 / OVHcloud Toronto, Canada
   \[rs] (s3.ca-east-tor.io.cloud.ovh.net)
10 / OVHcloud Singapore
   \[rs] (s3.sgp.io.cloud.ovh.net)
11 / OVHcloud Sydney, Australia
   \[rs] (s3.ap-southeast-syd.io.cloud.ovh.net)
12 / OVHcloud Mumbai, India
   \[rs] (s3.ap-south-mum.io.cloud.ovh.net)
13 / OVHcloud Vint Hill, Virginia, USA
   \[rs] (s3.us-east-va.io.cloud.ovh.us)
14 / OVHcloud Hillsboro, Oregon, USA
   \[rs] (s3.us-west-or.io.cloud.ovh.us)
15 / OVHcloud Roubaix, France (Cold Archive)
   \[rs] (s3.rbx-archive.io.cloud.ovh.net)
endpoint> 2

Option acl.
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
If the acl is an empty string then no X-Amz-Acl: header is added and
the default (private) will be used.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
   / Owner gets FULL_CONTROL.
 2 | The AllUsers group gets READ access.
   \[rs] (public-read)
   / Owner gets FULL_CONTROL.
 3 | The AllUsers group gets READ and WRITE access.
   | Granting this on a bucket is generally not recommended.
   \[rs] (public-read-write)
   / Owner gets FULL_CONTROL.
 4 | The AuthenticatedUsers group gets READ access.
   \[rs] (authenticated-read)
   / Object owner gets FULL_CONTROL.
 5 | Bucket owner gets READ access.
   | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.
   \[rs] (bucket-owner-read)
   / Both the object owner and the bucket owner get FULL_CONTROL over the object.
 6 | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.
   \[rs] (bucket-owner-full-control)
acl> 1

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: s3
- provider: OVHcloud
- access_key_id: my_access
- secret_access_key: my_secret
- region: rbx
- endpoint: s3.rbx.io.cloud.ovh.net
- acl: private
Keep this \[dq]ovhcloud-rbx\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.PP
اکنون فایل پیکربندی شما باید به این شکل باشد:
.IP
.nf
\f[C]
[ovhcloud-rbx]
type = s3
provider = OVHcloud
access_key_id = my_access
secret_access_key = my_secret
region = rbx
endpoint = s3.rbx.io.cloud.ovh.net
acl = private
\f[R]
.fi
.SS Petabox
.PP
در اینجا مثالی برای ایجاد یک پیکربندی Petabox (<https://petabox.io>) آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
n/s> n

Enter name for new remote.
name> My Petabox Storage

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] \[dq]s3\[dq]
[snip]
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / Petabox Object Storage
   \[rs] (Petabox)
[snip]
provider> Petabox

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 1

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> YOUR_ACCESS_KEY_ID

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> YOUR_SECRET_ACCESS_KEY

Option region.
Region where your bucket will be created and your data stored.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / US East (N. Virginia)
   \[rs] (us-east-1)
 2 / Europe (Frankfurt)
   \[rs] (eu-central-1)
 3 / Asia Pacific (Singapore)
   \[rs] (ap-southeast-1)
 4 / Middle East (Bahrain)
   \[rs] (me-south-1)
 5 / South America (São Paulo)
   \[rs] (sa-east-1)
region> 1

Option endpoint.
Endpoint for Petabox S3 Object Storage.
Specify the endpoint from the same region.
Choose a number from below, or type in your own value.
 1 / US East (N. Virginia)
   \[rs] (s3.petabox.io)
 2 / US East (N. Virginia)
   \[rs] (s3.us-east-1.petabox.io)
 3 / Europe (Frankfurt)
   \[rs] (s3.eu-central-1.petabox.io)
 4 / Asia Pacific (Singapore)
   \[rs] (s3.ap-southeast-1.petabox.io)
 5 / Middle East (Bahrain)
   \[rs] (s3.me-south-1.petabox.io)
 6 / South America (São Paulo)
   \[rs] (s3.sa-east-1.petabox.io)
endpoint> 1

Option acl.
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
If the acl is an empty string then no X-Amz-Acl: header is added and
the default (private) will be used.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
   / Owner gets FULL_CONTROL.
 2 | The AllUsers group gets READ access.
   \[rs] (public-read)
   / Owner gets FULL_CONTROL.
 3 | The AllUsers group gets READ and WRITE access.
   | Granting this on a bucket is generally not recommended.
   \[rs] (public-read-write)
   / Owner gets FULL_CONTROL.
 4 | The AuthenticatedUsers group gets READ access.
   \[rs] (authenticated-read)
   / Object owner gets FULL_CONTROL.
 5 | Bucket owner gets READ access.
   | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.
   \[rs] (bucket-owner-read)
   / Both the object owner and the bucket owner get FULL_CONTROL over the object.
 6 | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.
   \[rs] (bucket-owner-full-control)
acl> 1

Edit advanced config?
y) Yes
n) No (default)
y/n> No

Configuration complete.
Options:
- type: s3
- provider: Petabox
- access_key_id: YOUR_ACCESS_KEY_ID
- secret_access_key: YOUR_SECRET_ACCESS_KEY
- region: us-east-1
- endpoint: s3.petabox.io
Keep this \[dq]My Petabox Storage\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
این کار باعث می‌شود فایل پیکربندی به این صورت درآید:
.IP
.nf
\f[C]
[My Petabox Storage]
type = s3
provider = Petabox
access_key_id = YOUR_ACCESS_KEY_ID
secret_access_key = YOUR_SECRET_ACCESS_KEY
region = us-east-1
endpoint = s3.petabox.io
\f[R]
.fi.SS Pure Storage FlashBlade
.PP
سامانه
Pure Storage FlashBlade (https://www.purestorage.com/products/unstructured-data-storage.html)
یک ذخیره‌ساز شیء با کارایی بالا و سازگار با S3 است.
.PP
سامانه FlashBlade از بیشتر قابلیت‌های مدرن S3 پشتیبانی می‌کند، از جمله:
.IP \[bu] 2
ListObjectsV2
.IP \[bu] 2
بارگذاری‌های چندبخشی (Multipart uploads) با ETagهای سازگار با AWS
.IP \[bu] 2
الگوریتم‌های پیشرفته بررسی صحت (SHA256، CRC32، CRC32C) به همراه پشتیبانی از trailer
(نسخه +Purity//FB 4.4.2)
.IP \[bu] 2
نسخه‌بندی اشیاء و مدیریت چرخه حیات
.IP \[bu] 2
درخواست‌های سبک Virtual hosted (نیازمند پیکربندی DNS)
.PP
برای پیکربندی rclone جهت استفاده از Pure Storage FlashBlade:
.PP
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> flashblade

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
 4 / Amazon S3 Compliant Storage Providers including AWS, Alibaba, ArvanCloud, Ceph, ChinaMobile, Cloudflare, DigitalOcean, Dreamhost, FlashBlade, GCS, HuaweiOBS, IBMCOS, IDrive, IONOS, LyveCloud, Leviia, Liara, Linode, Magalu, Minio, Netease, Outscale, Petabox, RackCorp, Rclone, Scaleway, SeaweedFS, Selectel, Storj, Synology, TencentCOS, Wasabi, Qiniu and others
   \[rs] (s3)
[snip]
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
 9 / Pure Storage FlashBlade Object Storage
   \[rs] (FlashBlade)
[snip]
provider> FlashBlade

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 1

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> ACCESS_KEY_ID

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> SECRET_ACCESS_KEY

Option endpoint.
Endpoint for S3 API.
Required when using an S3 clone.
Enter a value. Press Enter to leave empty.
endpoint> https://s3.flashblade.example.com

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: s3
- provider: FlashBlade
- access_key_id: ACCESS_KEY_ID
- secret_access_key: SECRET_ACCESS_KEY
- endpoint: https://s3.flashblade.example.com
Keep this \[dq]flashblade\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
این کار منجر به ذخیره پیکربندی زیر در
\f[V]\[ti]/.config/rclone/rclone.conf\f[R] می‌شود:
.IP
.nf
\f[C]
[flashblade]
type = s3
provider = FlashBlade
access_key_id = ACCESS_KEY_ID
secret_access_key = SECRET_ACCESS_KEY
endpoint = https://s3.flashblade.example.com
\f[R]
.fi
.PP
نکته: مقدار endpoint در FlashBlade باید همان S3 data VIP باشد.
برای درخواست‌های سبک virtual-hosted، از پیکربندی صحیح DNS اطمینان حاصل کنید:
زیردامنه‌های نام میزبانِ endpoint باید به یک FlashBlade data VIP تحلیل (resolve) شوند.
برای نمونه، اگر endpoint شما
\f[V]https://s3.flashblade.example.com\f[R] باشد، در این صورت
\f[V]bucket-name.s3.flashblade.example.com\f[R] نیز باید به
همان data VIP تحلیل شود..SS ذخیره‌سازی ابری اشیاء Qiniu (Kodo)
.PP
سرویس ذخیره‌سازی ابری اشیاء Qiniu
(Kodo) (https://www.qiniu.com/en/products/kodo) با فناوری هسته‌ای کاملاً
مستقل که کارایی آن در تجربیات مکرر کاربران اثبات شده است، جایگاه پیشرو و
برتر بازار را در دست دارد.
از Kodo می‌توان به‌طور گسترده در مدیریت حجم عظیمی از داده‌ها استفاده کرد.
.PP
برای پیکربندی دسترسی به Qiniu Kodo، مراحل زیر را دنبال کنید:
.IP "1." 3
دستور \f[V]rclone config\f[R] را اجرا کرده و برای ایجاد یک ریموت جدید، گزینهٔ \f[V]n\f[R] را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
rclone config
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
\f[R]
.fi
.RE
.IP "2." 3
نام پیکربندی را وارد کنید.
برای مثال، نام آن را \[aq]qiniu\[aq] بگذارید.
.RS 4
.IP
.nf
\f[C]
name> qiniu
\f[R]
.fi
.RE
.IP "3." 3
نوع ذخیره‌سازی \f[V]s3\f[R] را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
Choose a number from below, or type in your own value
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] (s3)
[snip]
Storage> s3
\f[R]
.fi
.RE
.IP "4." 3
ارائه‌دهندهٔ \f[V]Qiniu\f[R] را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
Choose a number from below, or type in your own value
1 / Amazon Web Services (AWS) S3
   \[rs] \[dq]AWS\[dq]
[snip]
22 / Qiniu Object Storage (Kodo)
   \[rs] (Qiniu)
[snip]
provider> Qiniu
\f[R]
.fi
.RE
.IP "5." 3
شناسه‌های SecretId و SecretKey مربوط به Qiniu Kodo خود را وارد کنید.
.RS 4
.IP
.nf
\f[C]
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Enter a boolean value (true or false). Press Enter for the default (\[dq]false\[dq]).
Choose a number from below, or type in your own value
 1 / Enter AWS credentials in the next step
   \[rs] \[dq]false\[dq]
 2 / Get AWS credentials from the environment (env vars or IAM)
   \[rs] \[dq]true\[dq]
env_auth> 1
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
access_key_id> AKIDxxxxxxxxxx
AWS Secret Access Key (password)
Leave blank for anonymous access or runtime credentials.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
secret_access_key> xxxxxxxxxxx
\f[R]
.fi
.RE
.IP "6." 3
نقطهٔ پایانی (endpoint) را برای Qiniu Kodo انتخاب کنید.
این نقطهٔ پایانی استاندارد برای ناحیه‌های مختلف است.
.RS 4
.IP
.nf
\f[C]
   / The default endpoint - a good choice if you are unsure.
 1 | East China Region 1.
   | Needs location constraint cn-east-1.
   \[rs] (cn-east-1)
   / East China Region 2.
 2 | Needs location constraint cn-east-2.
   \[rs] (cn-east-2)
   / North China Region 1.
 3 | Needs location constraint cn-north-1.
   \[rs] (cn-north-1)
   / South China Region 1.
 4 | Needs location constraint cn-south-1.
   \[rs] (cn-south-1)
   / North America Region.
 5 | Needs location constraint us-north-1.
   \[rs] (us-north-1)
   / Southeast Asia Region 1.
 6 | Needs location constraint ap-southeast-1.
   \[rs] (ap-southeast-1)
   / Northeast Asia Region 1.
 7 | Needs location constraint ap-northeast-1.
   \[rs] (ap-northeast-1)
[snip]
endpoint> 1

Option endpoint.
Endpoint for Qiniu Object Storage.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / East China Endpoint 1
   \[rs] (s3-cn-east-1.qiniucs.com)
 2 / East China Endpoint 2
   \[rs] (s3-cn-east-2.qiniucs.com)
 3 / North China Endpoint 1
   \[rs] (s3-cn-north-1.qiniucs.com)
 4 / South China Endpoint 1
   \[rs] (s3-cn-south-1.qiniucs.com)
 5 / North America Endpoint 1
   \[rs] (s3-us-north-1.qiniucs.com)
 6 / Southeast Asia Endpoint 1
   \[rs] (s3-ap-southeast-1.qiniucs.com)
 7 / Northeast Asia Endpoint 1
   \[rs] (s3-ap-northeast-1.qiniucs.com)
endpoint> 1

Option location_constraint.
Location constraint - must be set to match the Region.
Used when creating buckets only.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / East China Region 1
   \[rs] (cn-east-1)
 2 / East China Region 2
   \[rs] (cn-east-2)
 3 / North China Region 1
   \[rs] (cn-north-1)
 4 / South China Region 1
   \[rs] (cn-south-1)
 5 / North America Region 1
   \[rs] (us-north-1)
 6 / Southeast Asia Region 1
   \[rs] (ap-southeast-1)
 7 / Northeast Asia Region 1
   \[rs] (ap-northeast-1)
location_constraint> 1
\f[R]
.fi
.RE
.IP "7." 3
تنظیمات acl و storage class را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
   / Owner gets FULL_CONTROL.
 2 | The AllUsers group gets READ access.
   \[rs] (public-read)
[snip]
acl> 2
The storage class to use when storing new objects in Tencent COS.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / Standard storage class
   \[rs] (STANDARD)
 2 / Infrequent access storage mode
   \[rs] (LINE)
 3 / Archive storage mode
   \[rs] (GLACIER)
 4 / Deep archive storage mode
   \[rs] (DEEP_ARCHIVE)
[snip]
storage_class> 1
Edit advanced config? (y/n)
y) Yes
n) No (default)
y/n> n
Remote config
--------------------
[qiniu]
- type: s3
- provider: Qiniu
- access_key_id: xxx
- secret_access_key: xxx
- region: cn-east-1
- endpoint: s3-cn-east-1.qiniucs.com
- location_constraint: cn-east-1
- acl: public-read
- storage_class: STANDARD
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
Current remotes:

Name                 Type
====                 ====
qiniu                s3
\f[R]
.fi
.RE.SS FileLu S5
.PP
فضای ذخیره‌سازی شیء FileLu S5 (<https://s5lu.com>) یک سیستم ذخیره‌سازی شیء سازگار با S3 است.
این سرویس چندین گزینهٔ منطقه (Global، US-East، EU-Central، AP-Southeast و ME-Central) را ضمن استفاده از یک نقطهٔ پایانی واحد
(\f[V]s5lu.com\f[R]) ارائه می‌دهد.
FileLu S5 با قیمت‌گذاری قابل پیش‌بینی و بدون هزینه‌های پنهان برای انتقال داده یا درخواست‌های API، برای مقیاس‌پذیری، امنیت و سادگی طراحی شده است.
.PP
در اینجا نمونه‌ای از انجام پیکربندی آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این کار شما را در مراحل یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> s5lu

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS,... FileLu, ...
   \[rs] (s3)
[snip]
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / FileLu S5 Object Storage
   \[rs] (FileLu)
[snip]
provider> FileLu

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth>

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> XXX

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> XXX

Option endpoint.
Endpoint for S3 API.
Required when using an S3 clone.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Global
   \[rs] (global)
 2 / North America (US-East)
   \[rs] (us-east)
 3 / Europe (EU-Central)
   \[rs] (eu-central)
 4 / Asia Pacific (AP-Southeast)
   \[rs] (ap-southeast)
 5 / Middle East (ME-Central)
   \[rs] (me-central)
region> 1

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: s3
- provider: FileLu
- access_key_id: XXX
- secret_access_key: XXX
- endpoint: s5lu.com
Keep this \[dq]s5lu\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
در نهایت فایل پیکربندی بدین صورت خواهد بود:
.IP
.nf
\f[C]
[s5lu]
type = s3
provider = FileLu
access_key_id = XXX
secret_access_key = XXX
endpoint = s5lu.com
\f[R]
.fi.SS Rabata
.PP
‏Rabata (https://rabata.io) یک سرویس ذخیره‌سازی ابری امن و سازگار با S3 است که ضمن پشتیبانی از APIهای استاندارد S3، قیمت‌گذاری ثابت و شفافی (بدون هزینه برای درخواست‌های API) ارائه می‌دهد.
این سرویس برای پشتیبان‌گیری، ذخیره‌سازی داده‌های برنامه‌ها، جریان‌های کاری رسانه‌ای و کاربردهای بایگانی مناسب است.
.PP
کپی سمت سرور (Server side copy) در Rabata پیاده‌سازی نشده است، که همچنین به این معنی است که زمان تغییر (modification time) اشیاء قابل به‌روزرسانی نیست.
.PP
پیکربندی Rclone:
.IP
.nf
\f[C]
rclone config
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> Rabata

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] (s3)
[snip]
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / Rabata Cloud Storage
   \[rs] (Rabata)
[snip]
provider> Rabata

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> ACCESS_KEY_ID

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> SECRET_ACCESS_KEY

Option region.
Region where your bucket will be created and your data stored.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / US East (N. Virginia)
   \[rs] (us-east-1)
 2 / EU (Ireland)
   \[rs] (eu-west-1)
 3 / EU (London)
   \[rs] (eu-west-2)
region> 3

Option endpoint.
Endpoint for Rabata Object Storage.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / US East (N. Virginia)
   \[rs] (s3.us-east-1.rabata.io)
 2 / EU West (Ireland)
   \[rs] (s3.eu-west-1.rabata.io)
 3 / EU West (London)
   \[rs] (s3.eu-west-2.rabata.io)
endpoint> 3

Option location_constraint.
location where your bucket will be created and your data stored.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / US East (N. Virginia)
   \[rs] (us-east-1)
 2 / EU (Ireland)
   \[rs] (eu-west-1)
 3 / EU (London)
   \[rs] (eu-west-2)
location_constraint> 3

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: s3
- provider: Rabata
- access_key_id: ACCESS_KEY_ID
- secret_access_key: SECRET_ACCESS_KEY
- region: eu-west-2
- endpoint: s3.eu-west-2.rabata.io
- location_constraint: eu-west-2
Keep this \[dq]rabata\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y

Current remotes:

Name                 Type
====                 ====
rabata               s3
\f[R]
.fi.SS RackCorp
.PP
ذخیره‌سازی شیء RackCorp (https://www.rackcorp.com/storage/s3storage) یک بستر ذخیره‌سازی شیء سازگار با S3 از ارائه‌دهنده ابری شما، RackCorp، است.
این سرویس سریع، قابل اعتماد، مقرون‌به‌صرفه و مستقر در موقعیت‌های مکانی راهبردی متعددی است که توسط دیگران پوشش داده نشده‌اند، تا اطمینان حاصل شود که می‌توانید حاکمیت داده را حفظ کنید.
.PP
پیش از آنکه بتوانید از ذخیره‌سازی شیء RackCorp استفاده کنید، باید برای یک حساب کاربری در درگاه ما (https://portal.rackcorp.com) ثبت‌نام کنید (https://www.rackcorp.com/signup).
سپس می‌توانید به آسانی یک \f[V]access key\f[R]، یک \f[V]secret key\f[R] و باکت‌های (\f[V]buckets\f[R]) مد نظرتان را در موقعیت مکانی مورد نظر خود ایجاد نمایید.
این مشخصات برای مراحل بعدی پیکربندی، زمانی که \f[V]rclone config\f[R] از شما مقادیر \f[V]access_key_id\f[R] و \f[V]secret_access_key\f[R] را درخواست می‌کند، لازم هستند.
.PP
پیکربندی شما در نهایت باید تقریباً به این شکل باشد:
.IP
.nf
\f[C]
[RCS3-demo-config]
type = s3
provider = RackCorp
env_auth = true
access_key_id = YOURACCESSKEY
secret_access_key = YOURSECRETACCESSKEY
region = au-nsw
endpoint = s3.rackcorp.com
location_constraint = au-nsw
\f[R]
.fi
.SS Rclone Serve S3
.PP
ابزار rclone می‌تواند هر ریموتی را از طریق پروتکل S3 ارائه (serve) کند.
برای جزئیات بیشتر به مستندات rclone serve s3 (https://rclone.org/commands/rclone_serve_s3) مراجعه کنید.
.PP
برای نمونه، جهت ارائه دادن \f[V]remote:path\f[R] روی s3، سرور را بدین صورت اجرا کنید:
.IP
.nf
\f[C]
rclone serve s3 --auth-key ACCESS_KEY_ID,SECRET_ACCESS_KEY remote:path
\f[R]
.fi
.PP
این پیکربندی با یک ریموت rclone که به شکل زیر تعریف شده باشد، سازگار خواهد بود:
.IP
.nf
\f[C]
[serves3]
type = s3
provider = Rclone
endpoint = http://127.0.0.1:8080
access_key_id = ACCESS_KEY_ID
secret_access_key = SECRET_ACCESS_KEY
use_multipart_uploads = false
\f[R]
.fi
.PP
توجه داشته باشید که تنظیم \f[V]use_multipart_uploads = false\f[R] به منظور دور زدن یک باگ (https://rclone.org/commands/rclone_serve_s3/#bugs) است که در آینده برطرف خواهد شد.
.SS Scaleway
.PP
بستر ذخیره‌سازی شیء Scaleway (https://www.scaleway.com/object-storage) به شما امکان می‌دهد هر چیزی را از نسخه‌های پشتیبان، لاگ‌ها و دارایی‌های وب گرفته تا اسناد و تصاویر ذخیره کنید.
فایل‌ها را می‌توان از طریق کنسول Scaleway بارگذاری کرد، یا از طریق API و CLI آن یا با استفاده از هر ابزار سازگار با S3 انتقال داد.
.PP
سرویس Scaleway یک رابط S3 فراهم می‌کند که می‌تواند برای استفاده با rclone به این صورت پیکربندی شود:
.IP
.nf
\f[C]
[scaleway]
type = s3
provider = Scaleway
env_auth = false
endpoint = s3.nl-ams.scw.cloud
access_key_id = SCWXXXXXXXXXXXXXX
secret_access_key = 1111111-2222-3333-44444-55555555555555
region = nl-ams
location_constraint = nl-ams
acl = private
upload_cutoff = 5M
chunk_size = 5M
copy_cutoff = 5M
\f[R]
.fi
.PP
سرویس Scaleway Glacier (https://www.scaleway.com/en/glacier-cold-storage) جایگزین ارزان‌قیمت S3 Glacier از سوی Scaleway است و دقیقاً مانند S3 با پذیرش \f[V]storage_class\f[R] با مقدار \[dq]GLACIER\[dq] کار می‌کند.
بنابراین می‌توانید ریموت خود را با گزینهٔ \f[V]storage_class = GLACIER\f[R] پیکربندی کنید تا بارگذاری‌ها مستقیماً در Scaleway Glacier انجام شوند.
فراموش نکنید که در این وضعیت پس از آپلود امکان خواندن مستقیم فایل‌ها وجود ندارد؛ پیش از آنکه قادر به خواندن آن‌ها باشید باید ابتدا آن‌ها را به کلاس ذخیره‌سازی \[dq]STANDARD\[dq] بازیابی (restore) کنید (به بخش \[dq]restore\[dq] در بالا مراجعه نمایید)..SS Scality
.PP
هر دو محصول RING و ARTESCA از Scality (https://www.scality.com) یک API ذخیره‌سازی شیء سازگار با S3 ارائه می‌دهند که با استفاده از \f[V]s3\f[R] به‌عنوان type و \f[V]Scality\f[R] به‌عنوان provider با rclone کار می‌کند.
.PP
هر دو محصول کلون‌های S3 هستند، بنابراین همیشه باید \f[V]endpoint\f[R] را روی S3 API مربوط به استقرار خود تنظیم کنید (سرویس S3 Connector در RING، یا endpoint سرویس داده S3 در ARTESCA).
ارائه‌دهنده \f[V]Scality\f[R] از آدرس‌دهی مبتنی بر مسیر (\f[V]endpoint/bucket/key\f[R]) استفاده می‌کند که به‌صورت پیش‌فرض پشتیبانی می‌شود و به هیچ مدخل DNS برای wildcard یا virtual-host نیازی ندارد.
.PP
کلید دسترسی (access key)، کلید محرمانه (secret key) و endpoint خود را از مدیر سیستم Scality دریافت کنید (در ARTESCA این مقادیر برای هر حساب کاربری در رابط کاربری زیر مسیر \f[I]Identity > Accounts\f[R] ایجاد می‌شوند؛ در RING با \f[V]vaultclient\f[R] یا S3 Console ساخته می‌شوند).
.PP
در اینجا مثالی از ایجاد یک پیکربندی Scality آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند.
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> scality

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
 XX / Amazon S3 Compliant Storage Providers including AWS, ...Scaleway, Scality, SeaweedFS, ...
   \[rs] (s3)
[snip]
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / Scality (RING / ARTESCA)
   \[rs] (Scality)
[snip]
provider> Scality

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth>

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> S3_ACCESS_KEY

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> S3_SECRET_KEY

Option region.
Region to connect to.
Leave blank if you are using an S3 clone and you don\[aq]t have a region.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Use this if unsure.
 1 | Will use v4 signatures and an empty region.
   \[rs] ()
   / Use this only if v4 signatures don\[aq]t work.
 2 | E.g. pre Jewel/v10 CEPH.
   \[rs] (other-v2-signature)
region>

Option endpoint.
Endpoint for S3 API.
Required when using an S3 clone.
Enter a value. Press Enter to leave empty.
endpoint> https://s3.example.com

Edit advanced config?
y) Yes
n) No (default)
y/n>

Configuration complete.
Options:
- type: s3
- provider: Scality
- access_key_id: S3_ACCESS_KEY
- secret_access_key: S3_SECRET_KEY
- endpoint: https://s3.example.com
Keep this \[dq]scality\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
در نهایت فایل پیکربندی به این صورت خواهد بود:
.IP
.nf
\f[C]
[scality]
type = s3
provider = Scality
access_key_id = S3_ACCESS_KEY
secret_access_key = S3_SECRET_KEY
endpoint = https://s3.example.com
\f[R]
.fi.SS Seagate Lyve Cloud
.PP
سرویس Seagate Lyve
Cloud (https://www.seagate.com/gb/en/services/cloud/storage) یک بستر ذخیره‌سازی شیء سازگار با S3 از شرکت Seagate (https://seagate.com)
است که برای استفاده‌های سازمانی در نظر گرفته شده است.
.PP
در اینجا مراحل پیکربندی برای یک ریموت به نام \f[V]remote\f[R] آورده شده است \- البته
می‌توانید نام دیگری را انتخاب کنید.
توجه داشته باشید که برای ایجاد یک access key و secret key ابتدا باید
یک حساب سرویس (service account) بسازید.
.IP
.nf
\f[C]
$ rclone config
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
\f[R]
.fi
.PP
پشتانهٔ \f[V]s3\f[R] را انتخاب کنید
.IP
.nf
\f[C]
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] (s3)
[snip]
Storage> s3
\f[R]
.fi
.PP
گزینهٔ \f[V]LyveCloud\f[R] را به‌عنوان ارائه‌دهندهٔ S3 انتخاب کنید
.IP
.nf
\f[C]
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / Seagate Lyve Cloud
   \[rs] (LyveCloud)
[snip]
provider> LyveCloud
\f[R]
.fi
.PP
حالت پیش‌فرض را بپذیرید (تنها کلید Enter را فشار دهید) تا access key و secret را
در فایل پیکربندی وارد کنید.
.IP
.nf
\f[C]
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth>
\f[R]
.fi
.IP
.nf
\f[C]
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> XXX
\f[R]
.fi
.IP
.nf
\f[C]
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> YYY
\f[R]
.fi
.PP
بخش منطقه (region) را خالی بگذارید
.IP
.nf
\f[C]
Region to connect to.
Leave blank if you are using an S3 clone and you don\[aq]t have a region.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Use this if unsure.
 1 | Will use v4 signatures and an empty region.
   \[rs] ()
   / Use this only if v4 signatures don\[aq]t work.
 2 | E.g. pre Jewel/v10 CEPH.
   \[rs] (other-v2-signature)
region>
\f[R]
.fi
.PP
آدرس نقطهٔ پایانی (endpoint) سرویس Lyve Cloud خود را وارد کنید.
این فیلد نمی‌تواند خالی بماند.
.IP
.nf
\f[C]
Endpoint for Lyve Cloud S3 API.
Required when using an S3 clone.
Please type in your LyveCloud endpoint.
Examples:
- s3.us-west-1.{account_name}.lyve.seagate.com (US West 1 - California)
- s3.eu-west-1.{account_name}.lyve.seagate.com (US West 1 - Ireland)
Enter a value.
endpoint> s3.us-west-1.global.lyve.seagate.com
\f[R]
.fi
.PP
بخش location constraint را خالی بگذارید
.IP
.nf
\f[C]
Location constraint - must be set to match the Region.
Leave blank if not sure. Used when creating buckets only.
Enter a value. Press Enter to leave empty.
location_constraint>
\f[R]
.fi
.PP
فهرست کنترل دسترسی (ACL) پیش‌فرض (\f[V]private\f[R]) را انتخاب کنید.
.IP
.nf
\f[C]
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
[snip]
acl>
\f[R]
.fi
.PP
و فایل پیکربندی در نهایت باید به این شکل باشد:
.IP
.nf
\f[C]
[remote]
type = s3
provider = LyveCloud
access_key_id = XXX
secret_access_key = YYY
endpoint = s3.us-east-1.lyvecloud.seagate.com
\f[R]
.fi.SS SeaweedFS
.PP
سامانهٔ SeaweedFS (https://github.com/chrislusf/seaweedfs) یک سامانه ذخیره‌سازی توزیع‌شده برای blobها، اشیاء، فایل‌ها و دریاچه داده (data lake) با جستجوی دیسک O(1) و ذخیره‌گاه فراداده فایلی مقیاس‌پذیر است.
این سامانه دارای رابط ذخیره‌سازی شیء سازگار با S3 است.
همچنین SeaweedFS می‌تواند به‌عنوان درگاه (gateway) به ذخیره‌گاه‌های شیء دوردستِ سازگار با S3 (https://github.com/chrislusf/seaweedfs/wiki/Gateway-to-Remote-Object-Storage) عمل کند تا داده‌ها و فراداده‌ها را با بازنویسی ناهمگام (asynchronous write back) حافظهٔ نهان (cache) کند، که موجب سرعت محلی بالا و کمینه‌سازی هزینه دسترسی می‌شود.
.PP
با فرض اینکه SeaweedFS از طریق \f[V]weed shell\f[R] بدین شکل پیکربندی شده باشد:
.IP
.nf
\f[C]
> s3.bucket.create -name foo
> s3.configure -access_key=any -secret_key=any -buckets=foo -user=me -actions=Read,Write,List,Tagging,Admin -apply
{
  \[dq]identities\[dq]: [
    {
      \[dq]name\[dq]: \[dq]me\[dq],
      \[dq]credentials\[dq]: [
        {
          \[dq]accessKey\[dq]: \[dq]any\[dq],
          \[dq]secretKey\[dq]: \[dq]any\[dq]
        }
      ],
      \[dq]actions\[dq]: [
        \[dq]Read:foo\[dq],
        \[dq]Write:foo\[dq],
        \[dq]List:foo\[dq],
        \[dq]Tagging:foo\[dq],
        \[dq]Admin:foo\[dq]
      ]
    }
  ]
}
\f[R]
.fi
.PP
جهت استفاده از rclone با SeaweedFS، پیکربندی بالا در نهایت باید به چیزی شبیه به این در فایل پیکربندی شما منجر شود:
.IP
.nf
\f[C]
[seaweedfs_s3]
type = s3
provider = SeaweedFS
access_key_id = any
secret_access_key = any
endpoint = localhost:8333
\f[R]
.fi
.PP
بنابراین پس از راه‌اندازی، برای مثال جهت کپی کردن فایل‌ها به درون یک باکت:
.IP
.nf
\f[C]
rclone copy /path/to/files seaweedfs_s3:foo
\f[R]
.fi
.SS Selectel
.PP
فضای ذخیره‌سازی ابری Selectel (https://selectel.ru/services/cloud/storage) یک سامانه ذخیره‌سازی سازگار با S3 است که از ویژگی‌هایی چون ذخیره‌سازی با افزونگی سه‌گانه، مقیاس‌پذیری خودکار، دسترسی‌پذیری بالا و سامانه جامع IAM برخوردار است.
.PP
سرویس Selectel در وب‌سایت خود بخشی برای پیکربندی rclone (https://docs.selectel.ru/en/cloud/object-storage/tools/rclone) دارد که نحوه ایجاد کلیدهای معتبر API را شرح می‌دهد.
.PP
از نگارش v1.69 نرم‌افزار rclone، سرویس Selectel پشتیبانی می‌شود \- لطفاً نوع ارائه‌دهنده را \f[V]Selectel\f[R] انتخاب کنید.
.PP
توجه داشته باشید که باید از دسترسی نوع \[dq]vHosted\[dq] برای باکت‌ها استفاده کنید (که حالت پیش‌فرض و توصیه‌شده است)، نه روش \[dq]path style\[dq].
.PP
می‌توانید با استفاده از دستور \f[V]rclone config\f[R] یک ارائه‌دهنده جدید به شکل زیر ایجاد کنید:
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> selectel

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Amazon S3 Compliant Storage Providers including ..., Selectel, ...
   \[rs] (s3)
[snip]
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / Selectel Object Storage
   \[rs] (Selectel)
[snip]
provider> Selectel

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 1

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> ACCESS_KEY

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> SECRET_ACCESS_KEY

Option region.
Region where your data stored.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / St. Petersburg
   \[rs] (ru-1)
region> 1

Option endpoint.
Endpoint for Selectel Object Storage.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Saint Petersburg
   \[rs] (s3.ru-1.storage.selcloud.ru)
endpoint> 1

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: s3
- provider: Selectel
- access_key_id: ACCESS_KEY
- secret_access_key: SECRET_ACCESS_KEY
- region: ru-1
- endpoint: s3.ru-1.storage.selcloud.ru
Keep this \[dq]selectel\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
و در نهایت فایل پیکربندی شما باید شکلی شبیه به این داشته باشد:
.IP
.nf
\f[C]
[selectel]
type = s3
provider = Selectel
access_key_id = ACCESS_KEY
secret_access_key = SECRET_ACCESS_KEY
region = ru-1
endpoint = s3.ru-1.storage.selcloud.ru
\f[R]
.fi.SS Servercore
.PP
سرویس Servercore Object
Storage (https://servercore.com/services/object-storage) یک سامانهٔ
ذخیره‌سازی شیء سازگار با S3 است که راهکارهای ذخیره‌سازی مقیاس‌پذیر و امنی را
برای کسب‌وکارها در هر اندازه‌ای ارائه می‌دهد.
.PP
نمونه پیکربندی rclone:
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> servercore

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Amazon S3 Compliant Storage Providers including ..., Servercore, ...
   \[rs] (s3)
[snip]
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / Servercore Object Storage
   \[rs] (Servercore)
[snip]
provider> Servercore

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 1

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> ACCESS_KEY

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> SECRET_ACCESS_KEY

Option region.
Region where your is data stored.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / St. Petersburg
   \[rs] (ru-1)
 2 / Moscow
   \[rs] (gis-1)
 3 / Moscow
   \[rs] (ru-7)
 4 / Tashkent, Uzbekistan
   \[rs] (uz-2)
 5 / Almaty, Kazakhstan
   \[rs] (kz-1)
region> 1

Option endpoint.
Endpoint for Servercore Object Storage.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Saint Petersburg
   \[rs] (s3.ru-1.storage.selcloud.ru)
 2 / Moscow
   \[rs] (s3.gis-1.storage.selcloud.ru)
 3 / Moscow
   \[rs] (s3.ru-7.storage.selcloud.ru)
 4 / Tashkent, Uzbekistan
   \[rs] (s3.uz-2.srvstorage.uz)
 5 / Almaty, Kazakhstan
   \[rs] (s3.kz-1.srvstorage.kz)
endpoint> 1

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: s3
- provider: Servercore
- access_key_id: ACCESS_KEY
- secret_access_key: SECRET_ACCESS_KEY
- region: ru-1
- endpoint: s3.ru-1.storage.selcloud.ru
Keep this \[dq]servercore\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS Spectra Logic
.PP
سامانه
Spectra Logic (https://www.spectralogic.com/blackpearl-nearline-object-gateway)
یک درگاه ذخیره‌سازی شیء درون‌سازمانی (on-prem) و سازگار با S3 است که فضای ذخیره‌سازی
شیء محلی را ارائه می‌دهد و داده‌ها را بر اساس خط‌مشی‌ها ذیل یک فضای نام یکپارچه
جهت پشتیبان‌گیری و بایگانی، به نوارهای Spectra و ابرهای عمومی لایه‌بندی می‌کند.
.PP
این درگاه سازگار با S3 با استفاده از \f[V]rclone config\f[R] با نوع
\f[V]s3\f[R] و با نام ارائه‌دهندهٔ \f[V]SpectraLogic\f[R] پیکربندی می‌شود.
در ادامه نمونه‌ای از اجرای این ابزار پیکربندی آورده شده است.
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> spectralogic

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Amazon S3 Compliant Storage Providers including ..., SpectraLogic, ...
   \[rs] (s3)
[snip]
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
[snip]
XX / SpectraLogic BlackPearl
   \[rs] (SpectraLogic)
[snip]
provider> SpectraLogic

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 1

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> ACCESS_KEY

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> SECRET_ACCESS_KEY

Option endpoint.
Endpoint for S3 API.
Required when using an S3 clone.
Enter a value. Press Enter to leave empty.
endpoint> https://bp.example.com

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: s3
- provider: SpectraLogic
- access_key_id: ACCESS_KEY
- secret_access_key: SECRET_ACCESS_KEY
- endpoint: https://bp.example.com
Keep this \[dq]spectratest\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
و در نهایت پیکربندی شما باید به این شکل باشد:
.IP
.nf
\f[C]
[spectratest]
type = s3
provider = SpectraLogic
access_key_id = ACCESS_KEY
secret_access_key = SECRET_ACCESS_KEY
endpoint = https://bp.example.com
\f[R]
.fi.SS Storj
.PP
سرویس Storj یک فضای ذخیره‌سازی ابری غیرمتمرکز است که می‌تواند از طریق پروتکل بومی خود یا یک درگاه (gateway) سازگار با S3 مورد استفاده قرار گیرد.
.PP
درگاه سازگار با S3 با استفاده از \f[V]rclone config\f[R] با نوع \f[V]s3\f[R] و با نام ارائه‌دهندهٔ \f[V]Storj\f[R] پیکربندی می‌شود. در ادامه یک نمونه از اجرای ابزار پیکربندی آورده شده است.
.IP
.nf
\f[C]
Type of storage to configure.
Storage> s3
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 1
Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> XXXX (as shown when creating the access grant)
Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> XXXX (as shown when creating the access grant)
Option endpoint.
Endpoint of the Shared Gateway.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / EU1 Shared Gateway
   \[rs] (gateway.eu1.storjshare.io)
 2 / US1 Shared Gateway
   \[rs] (gateway.us1.storjshare.io)
 3 / Asia-Pacific Shared Gateway
   \[rs] (gateway.ap1.storjshare.io)
endpoint> 1 (as shown when creating the access grant)
Edit advanced config?
y) Yes
n) No (default)
y/n> n
\f[R]
.fi
.PP
توجه داشته باشید که اعتبارنامه‌های s3 هنگام ایجاد یک access grant تولید می‌شوند (https://docs.storj.io/dcs/api-reference/s3-compatible-gateway#usage).
.SS رفتارهای خاص بک‌اند (Backend quirks)
.IP \[bu] 2
گزینهٔ \f[V]--chunk-size\f[R] اجباراً برابر با 64 MiB یا بیشتر در نظر گرفته می‌شود.
این کار حافظهٔ بیشتری نسبت به مقدار پیش‌فرض 5 MiB مصرف خواهد کرد.
.IP \[bu] 2
کپی سمت سرور (Server side copy) غیرفعال است زیرا در حال حاضر در درگاه پشتیبانی نمی‌شود.
.IP \[bu] 2
دستورهای GetTier و SetTier پشتیبانی نمی‌شوند.
.SS باگ‌های بک‌اند (Backend bugs)
.PP
به‌دلیل مشکل شمارهٔ ۳۹ (https://github.com/storj/gateway-mt/issues/39)، بارگذاری فایل‌های چندبخشی (multipart) از طریق درگاه S3 باعث از دست رفتن فراداده‌های (metadata) آن‌ها می‌شود.
برای اهداف rclone، این بدان معناست که زمان تغییر ذخیره نمی‌شود و همچنین هیچ MD5SUM ذخیره نخواهد شد (در صورتی که از مبدأ در دسترس باشد).
.PP
این موضوع پیامدهای زیر را در پی دارد:
.IP \[bu] 2
استفاده از \f[V]rclone rcat\f[R] با شکست مواجه خواهد شد زیرا فراداده‌ها پس از بارگذاری مطابقت ندارند
.IP \[bu] 2
بارگذاری فایل‌ها با \f[V]rclone mount\f[R] به همان دلیل با شکست مواجه خواهد شد
.RS 2
.IP \[bu] 2
این مشکل را می‌توان با استفاده از \f[V]--vfs-cache-mode writes\f[R] یا \f[V]--vfs-cache-mode full\f[R] یا با تنظیم یک مقدار بزرگ برای \f[V]--s3-upload-cutoff\f[R] برطرف کرد
.RE
.IP \[bu] 2
فایل‌هایی که از طریق بارگذاری چندبخشی ارسال می‌شوند، زمان تغییر (modtime) خود را نخواهند داشت
.RS 2
.IP \[bu] 2
این بدان معناست که \f[V]rclone sync\f[R] احتمالاً به‌طور مداوم سعی در بارگذاری مجدد فایل‌های بزرگ‌تر از \f[V]--s3-upload-cutoff\f[R] خواهد داشت
.IP \[bu] 2
این مشکل را می‌توان با \f[V]--checksum\f[R] یا \f[V]--size-only\f[R] یا تنظیم یک مقدار بزرگ برای \f[V]--s3-upload-cutoff\f[R] برطرف کرد
.IP \[bu] 2
با این حال، حداکثر مقدار مجاز برای \f[V]--s3-upload-cutoff\f[R] برابر با 5GiB است
.RE
.PP
یک راهکار عمومی، تنظیم \f[V]--s3-upload-cutoff 5G\f[R] است.
این کار باعث می‌شود rclone فایل‌های کوچک‌تر از 5GiB را به‌صورت تک‌بخشی بارگذاری کند.
توجه داشته باشید که این مقدار را می‌توان در فایل پیکربندی با \f[V]upload_cutoff = 5G\f[R] تعیین کرد یا در تنظیمات پیشرفته پیکربندی نمود.
اگر به‌طور منظم فایل‌های بزرگ‌تر از 5G را جابه‌جا می‌کنید، استفاده از \f[V]--checksum\f[R] یا \f[V]--size-only\f[R] در \f[V]rclone sync\f[R] راهکار پیشنهادی است..SS مقایسه با پروتکل بومی
.PP
برای بهره‌مندی از رمزنگاری سمت کلاینت و همچنین دستیابی به بهترین کارایی بارگیری ممکن، از پروتکل بومی استفاده کنید.
بارگذاری‌ها به‌صورت محلی با کدگذاری حذفی (erasure-coded) انجام می‌شوند؛ بنابراین، بارگذاری ۱ گیگابایت داده منجر به ارسال ۲٫۶۸ گیگابایت داده به گره‌های ذخیره‌سازی در سراسر شبکه خواهد شد.
.PP
برای افزایش کارایی بارگذاری و کاهش بار روی سیستم‌ها و شبکهٔ خود، از این backend و درگاه میزبانی‌شدهٔ (Hosted Gateway) سازگار با S3 استفاده کنید.
بارگذاری‌ها در سمت سرور رمزنگاری و با روش کدگذاری حذفی (erasure-coded) پردازش خواهند شد؛ بنابراین، بارگذاری ۱ گیگابایت داده تنها به بارگذاری ۱ گیگابایت داده در گره‌های ذخیره‌سازی در سراسر شبکه منجر می‌شود.
.PP
برای مقایسهٔ دقیق‌تر لطفاً مستندات backend مربوط به storj را بررسی کنید.
.SS فضای ذخیره‌سازی شیء Synology C2
.PP
فضای ذخیره‌سازی شیء Synology C2
(<https://c2.synology.com/en-global/object-storage/overview>)
یک راهکار ذخیره‌سازی ابری امن، سازگار با S3 و مقرون‌به‌صرفه را بدون هزینهٔ درخواست‌های API، هزینهٔ بارگیری و جریمهٔ حذف ارائه می‌دهد.
.PP
درگاه سازگار با S3 با استفاده از \f[V]rclone config\f[R] با نوع \f[V]s3\f[R] و با نام ارائه‌دهندهٔ
\f[V]Synology\f[R] پیکربندی می‌شود.
در ادامه یک نمونه از اجرای ابزار پیکربندی آورده شده است.
.PP
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این فرمان شما را در یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config

n/s/q> n

Enter name for new remote.1
name> syno

Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value

XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] \[dq]s3\[dq]

Storage> s3

Choose your S3 provider.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 24 / Synology C2 Object Storage
   \[rs] (Synology)

provider> Synology

Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Enter a boolean value (true or false). Press Enter for the default (\[dq]false\[dq]).
Choose a number from below, or type in your own value
 1 / Enter AWS credentials in the next step
   \[rs] \[dq]false\[dq]
 2 / Get AWS credentials from the environment (env vars or IAM)
   \[rs] \[dq]true\[dq]

env_auth> 1

AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a string value. Press Enter for the default (\[dq]\[dq]).

access_key_id> accesskeyid

AWS Secret Access Key (password)
Leave blank for anonymous access or runtime credentials.
Enter a string value. Press Enter for the default (\[dq]\[dq]).

secret_access_key> secretaccesskey

Region where your data stored.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Europe Region 1
   \[rs] (eu-001)
 2 / Europe Region 2
   \[rs] (eu-002)
 3 / US Region 1
   \[rs] (us-001)
 4 / US Region 2
   \[rs] (us-002)
 5 / Asia (Taiwan)
   \[rs] (tw-001)

region > 1

Option endpoint.
Endpoint for Synology C2 Object Storage API.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / EU Endpoint 1
   \[rs] (eu-001.s3.synologyc2.net)
 2 / US Endpoint 1
   \[rs] (us-001.s3.synologyc2.net)
 3 / TW Endpoint 1
   \[rs] (tw-001.s3.synologyc2.net)

endpoint> 1

Option location_constraint.
Location constraint - must be set to match the Region.
Leave blank if not sure. Used when creating buckets only.
Enter a value. Press Enter to leave empty.
location_constraint>

Edit advanced config? (y/n)
y) Yes
n) No
y/n> y

Option no_check_bucket.
If set, don\[aq]t attempt to check the bucket exists or create it.
This can be useful when trying to minimise the number of transactions
rclone does if you know the bucket exists already.
It can also be needed if the user you are using does not have bucket
creation permissions. Before v1.52.0 this would have passed silently
due to a bug.
Enter a boolean value (true or false). Press Enter for the default (true).

no_check_bucket> true

Configuration complete.
Options:
- type: s3
- provider: Synology
- region: eu-001
- endpoint: eu-001.s3.synologyc2.net
- no_check_bucket: true
Keep this \[dq]syno\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote

y/e/d> y
\f[R]
.fi.SS Tencent COS
.PP
سرویس ذخیره‌سازی ابری شیء تِنسِنت یا
(COS) (https://intl.cloud.tencent.com/product/cos) Tencent Cloud Object Storage
یک سرویس ذخیره‌سازی توزیع‌شده است که توسط Tencent Cloud برای داده‌های غیرساختاریافته ارائه می‌شود.
این سرویس امن، پایدار، کلان‌مقیاس، دردسترس، کم‌تأخیر و کم‌هزینه است.
.PP
برای پیکربندی دسترسی به Tencent COS، مراحل زیر را دنبال کنید:
.IP "1." 3
دستور \f[V]rclone config\f[R] را اجرا کرده و برای ایجاد یک ریموت جدید، گزینهٔ \f[V]n\f[R] را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
rclone config
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
\f[R]
.fi
.RE
.IP "2." 3
نامی برای این پیکربندی وارد کنید.
برای مثال، نام آن را \[aq]cos\[aq] بگذارید.
.RS 4
.IP
.nf
\f[C]
name> cos
\f[R]
.fi
.RE
.IP "3." 3
ذخیره‌ساز نوع \f[V]s3\f[R] را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
Choose a number from below, or type in your own value
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] \[dq]s3\[dq]
[snip]
Storage> s3
\f[R]
.fi
.RE
.IP "4." 3
ارائه‌دهندهٔ \f[V]TencentCOS\f[R] را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
Choose a number from below, or type in your own value
1 / Amazon Web Services (AWS) S3
   \[rs] \[dq]AWS\[dq]
[snip]
11 / Tencent Cloud Object Storage (COS)
   \[rs] \[dq]TencentCOS\[dq]
[snip]
provider> TencentCOS
\f[R]
.fi
.RE
.IP "5." 3
شناسهٔ SecretId و کلید SecretKey مربوط به حساب Tencent Cloud خود را وارد کنید.
.RS 4
.IP
.nf
\f[C]
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Enter a boolean value (true or false). Press Enter for the default (\[dq]false\[dq]).
Choose a number from below, or type in your own value
 1 / Enter AWS credentials in the next step
   \[rs] \[dq]false\[dq]
 2 / Get AWS credentials from the environment (env vars or IAM)
   \[rs] \[dq]true\[dq]
env_auth> 1
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
access_key_id> AKIDxxxxxxxxxx
AWS Secret Access Key (password)
Leave blank for anonymous access or runtime credentials.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
secret_access_key> xxxxxxxxxxx
\f[R]
.fi
.RE
.IP "6." 3
نقطهٔ پایانی (endpoint) مورد نظر برای Tencent COS را انتخاب کنید.
این گزینه نقطهٔ پایانی استاندارد برای مناطق (regions) مختلف است.
.RS 4
.IP
.nf
\f[C]
 1 / Beijing Region.
   \[rs] \[dq]cos.ap-beijing.myqcloud.com\[dq]
 2 / Nanjing Region.
   \[rs] \[dq]cos.ap-nanjing.myqcloud.com\[dq]
 3 / Shanghai Region.
   \[rs] \[dq]cos.ap-shanghai.myqcloud.com\[dq]
 4 / Guangzhou Region.
   \[rs] \[dq]cos.ap-guangzhou.myqcloud.com\[dq]
[snip]
endpoint> 4
\f[R]
.fi
.RE
.IP "7." 3
سطح دسترسی (acl) و کلاس ذخیره‌سازی (storage class) را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / Owner gets Full_CONTROL. No one else has access rights (default).
   \[rs] \[dq]default\[dq]
[snip]
acl> 1
The storage class to use when storing new objects in Tencent COS.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / Default
   \[rs] \[dq]\[dq]
[snip]
storage_class> 1
Edit advanced config? (y/n)
y) Yes
n) No (default)
y/n> n
Remote config
--------------------
[cos]
type = s3
provider = TencentCOS
env_auth = false
access_key_id = xxx
secret_access_key = xxx
endpoint = cos.ap-guangzhou.myqcloud.com
acl = default
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
Current remotes:

Name                 Type
====                 ====
cos                  s3
\f[R]
.fi
.RE.SS نقطه پایانی شتاب سراسری Tencent COS
.PP
هنگام استفاده از نقطه پایانی شتاب سراسری
(\f[V]cos.accelerate.myqcloud.com\f[R])، rclone به‌طور خودکار
\f[V]no_check_bucket = true\f[R] را تنظیم می‌کند، زیرا این نقطه پایانی شتاب‌دهی
از فراخوانی \f[V]CreateBucket\f[R] که توسط rclone برای اطمینان از وجود یک
باکت استفاده می‌شود، پشتیبانی نمی‌کند.
شتاب سراسری قابلیتی برای هر باکت به‌صورت جداگانه است، بنابراین ابتدا باید
باکت را در یک منطقه فیزیکی بسازید و سپس آن را در کنسول Tencent Cloud
فعال کنید.
.SS US3
.PP
فضای ذخیره‌سازی شیء US3 (https://www.ucloud.cn/site/product/ufile.html) سرویسی است
که فضای ذخیره‌سازی ابری را برای فایل‌های بدون ساختار برنامه‌های اینترنتی
ارائه می‌دهد.
.PP
برای پیکربندی دسترسی به US3، مراحل زیر را دنبال کنید:
1.
ابتدا اجرا کنید:
\f[V]console     rclone config     No remotes found, make a new one?     n) New remote     s) Set configuration password     q) Quit config     n/s/q> n\f[R]
2.
نام پیکربندی را وارد کنید.
برای مثال، نام آن را \[aq]US3\[aq] بگذارید.
.IP
.nf
\f[C]
name> US3
\f[R]
.fi
.IP "3." 3
ذخیره‌سازی \f[V]s3\f[R] را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
Choose a number from below, or type in your own value
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] \[dq]s3\[dq]
[snip]
Storage> s3
\f[R]
.fi
.RE
.IP "4." 3
ارائه‌دهنده \f[V]US3\f[R] را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
 Choose a number from below, or type in your own value.
 XX / Amazon Web Services (AWS) S3
    \[rs] (AWS)
 [snip]
 XX / UCloud Object Storage (US3)
    \[rs] (US3)
 [snip]
 provider> US3
\f[R]
.fi
.RE
.IP "5." 3
SecretId و SecretKey مربوط به US3 خود را وارد کنید.
.RS 4
.IP
.nf
\f[C]
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
Choose a number from below, or type in your own value
 1 / Enter AWS credentials in the next step
   \[rs] \[dq]false\[dq]
 2 / Get AWS credentials from the environment (env vars or IAM)
   \[rs] \[dq]true\[dq]
env_auth> 1
Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> AKIDxxxxxxxxxx
AWS Secret Access Key (password)
Leave blank for anonymous access or runtime credentials.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
secret_access_key> xxxxxxxxxxx
\f[R]
.fi
.RE
.IP "6." 3
نقطه پایانی را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
 Option endpoint.
 Endpoint for S3 API.
 Required when using an S3 clone.
 Choose a number from below, or type in your own value.
 Press Enter to leave empty.
 1 / North China (Beijing 2).
   \[rs] \[dq]s3-cn-bj.ufileos.com\[dq]
 2 / North China (Ulanqab).
   \[rs] \[dq]s3-cn-wlcb.ufileos.com\[dq]
 3 / Shanghai.
   \[rs] \[dq]s3-cn-sh2.ufileos.com\[dq]
 4 / South China (Guangzhou).
   \[rs] \[dq]s3-cn-gd.ufileos.com\[dq]
[snip]
endpoint> 1
\f[R]
.fi
.RE
.IP "7." 3
acl و کلاس ذخیره‌سازی را انتخاب کنید.
.RS 4
.IP
.nf
\f[C]
Option acl.
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
If the acl is an empty string then no X-Amz-Acl: header is added and
the default (private) will be used.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
  / Owner gets FULL_CONTROL.
1 | No one else has access rights (default).
  \[rs] (private)
  / Owner gets FULL_CONTROL.
2 | The AllUsers group gets READ access.
  \[rs] (public-read)
acl> 1

The storage class to use when storing new objects in US3.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / Default
   \[rs] \[dq]\[dq]
[snip]
storage_class> 1
Edit advanced config? (y/n)
y) Yes
n) No (default)
y/n> n

 Configuration complete. 
 Options:
 - type: s3
 - provider: US3
 - access_key_id: xx
 - secret_access_key: xx
 - endpoint: s3-cn-bj.ufileos.com
 - acl: private

 Keep this \[dq]US3\[dq] remote?
 y) Yes this is OK (default)
 e) Edit this remote
 d) Delete this remote
 y/e/d> y
 Current remotes:

 Name                 Type
 ====                 ====
 US3                  s3
\f[R]
.fi
.RE.SS Wasabi
.PP
سرویس Wasabi (https://wasabi.com) یک سرویس ذخیره‌سازی ابری شیءگرا برای طیف گسترده‌ای از کاربردها و موارد استفاده است.
Wasabi برای افراد و سازمان‌هایی طراحی شده است که به یک زیرساخت ذخیره‌سازی داده با کارایی بالا، قابل اعتماد و امن با حداقل هزینه نیاز دارند.
.PP
سرویس Wasabi یک رابط S3 ارائه می‌دهد که می‌توان آن را به این صورت برای استفاده با rclone پیکربندی کرد.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
n/s> n
name> wasabi
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Amazon S3 (also Dreamhost, Ceph, ChinaMobile, ArvanCloud, Minio, Liara)
   \[rs] \[dq]s3\[dq]
[snip]
Storage> s3
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars). Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own value
 1 / Enter AWS credentials in the next step
   \[rs] \[dq]false\[dq]
 2 / Get AWS credentials from the environment (env vars or IAM)
   \[rs] \[dq]true\[dq]
env_auth> 1
AWS Access Key ID - leave blank for anonymous access or runtime credentials.
access_key_id> YOURACCESSKEY
AWS Secret Access Key (password) - leave blank for anonymous access or runtime credentials.
secret_access_key> YOURSECRETACCESSKEY
Region to connect to.
Choose a number from below, or type in your own value
   / The default endpoint - a good choice if you are unsure.
 1 | US Region, Northern Virginia, or Pacific Northwest.
   | Leave location constraint empty.
   \[rs] \[dq]us-east-1\[dq]
[snip]
region> us-east-1
Endpoint for S3 API.
Leave blank if using AWS to use the default endpoint for the region.
Specify if using an S3 clone such as Ceph.
endpoint> s3.wasabisys.com
Location constraint - must be set to match the Region. Used when creating buckets only.
Choose a number from below, or type in your own value
 1 / Empty for US Region, Northern Virginia, or Pacific Northwest.
   \[rs] \[dq]\[dq]
[snip]
location_constraint>
Canned ACL used when creating buckets and/or storing objects in S3.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Choose a number from below, or type in your own value
 1 / Owner gets FULL_CONTROL. No one else has access rights (default).
   \[rs] \[dq]private\[dq]
[snip]
acl>
The server-side encryption algorithm used when storing this object in S3.
Choose a number from below, or type in your own value
 1 / None
   \[rs] \[dq]\[dq]
 2 / AES256
   \[rs] \[dq]AES256\[dq]
server_side_encryption>
The storage class to use when storing objects in S3.
Choose a number from below, or type in your own value
 1 / Default
   \[rs] \[dq]\[dq]
 2 / Standard storage class
   \[rs] \[dq]STANDARD\[dq]
 3 / Reduced redundancy storage class
   \[rs] \[dq]REDUCED_REDUNDANCY\[dq]
 4 / Standard Infrequent Access storage class
   \[rs] \[dq]STANDARD_IA\[dq]
storage_class>
Remote config
--------------------
[wasabi]
env_auth = false
access_key_id = YOURACCESSKEY
secret_access_key = YOURSECRETACCESSKEY
region = us-east-1
endpoint = s3.wasabisys.com
location_constraint =
acl =
server_side_encryption =
storage_class =
--------------------
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
با این کار، فایل پیکربندی نهایی به این صورت خواهد بود.
.IP
.nf
\f[C]
[wasabi]
type = s3
provider = Wasabi
env_auth = false
access_key_id = YOURACCESSKEY
secret_access_key = YOURSECRETACCESSKEY
region =
endpoint = s3.wasabisys.com
location_constraint =
acl =
server_side_encryption =
storage_class =
\f[R]
.fi.SS ذخیره‌سازی شیء Zadara (Zadara Object Storage)
.PP
سرویس Zadara Object Storage (<https://www.zadara.com>) یک راهکار ذخیره‌سازی کاملاً مدیریت‌شده، در رده سازمانی و سازگار با S3 است که امکان ذخیره‌سازی شیء مقیاس‌پذیر و چندمستأجری (multi-tenant) را با گزینه‌های استقرار منعطف (محلی، ترکیبی یا ابری) فراهم می‌کند.
.PP
سرویس Zadara Object Storage می‌تواند با استفاده از \f[V]rclone config\f[R] با نوع \f[V]s3\f[R] و نام ارائه‌دهنده \f[V]Zadara\f[R] پیکربندی شود. در ادامه نمونه‌ای از اجرای فرایند پیکربندی آورده شده است.
.PP
اطلاعات احراز هویت و endpoint، از جمله فیلد region، باید از رابط مدیریت Zadara Object Storage دریافت شوند.
.PP
برای پیکربندی دسترسی به Zadara Object Storage، ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.IP
.nf
\f[C]
This will guide you through an interactive setup process:

No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
n/s> n

Enter name for new remote.
name> Zadara-Object-Storage

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
 
 XX / Amazon S3 Compliant Storage Providers including AWS ...
   \[rs] (s3)

Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 
XX / Zadara Object Storage
   \[rs] (Zadara)

provider> Zadara

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> S3_ACCESS_KEY

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> S3_SECRET_KEY

Option region.
Region to connect to.
Leave blank if you are using an S3 clone and you don\[aq]t have a region.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / The default region.
 1 | Leave location constraint empty.
   \[rs] (us-east-1)
region> 

Option endpoint.
Endpoint for S3 API.
Required when using an S3 clone.
Enter a value. Press Enter to leave empty.
endpoint> https://vsa-00000001-public-zadara-cloud-01.zadarazios.com

Edit advanced config?
y) Yes
n) No (default)
y/n> 

Configuration complete.
Options:
- type: s3
- provider: Zadara
- access_key_id: S3_ACCESS_KEY
- secret_access_key: S3_SECRET_KEY
- endpoint: https://vsa-00000001-public-zadara-cloud-01.zadarazios.com
Keep this \[dq]Zadara-Object-Storage\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
این کار باعث می‌شود فایل پیکربندی به این شکل درآید:
.IP
.nf
\f[C]
[Zadara-Object-Storage]
type = s3
provider = Zadara
access_key_id = S3_ACCESS_KEY
secret_access_key = S3_SECRET_KEY
endpoint = https://vsa-00000001-public-zadara-cloud-01.zadarazios.com
\f[R]
.fi.SS ذخیره‌سازی شیء Zata (Zata Object Storage)
.PP
سرویس ذخیره‌سازی شیء Zata (https://zata.ai) یک راهکار ذخیره‌سازی ابری امن و سازگار با S3 ارائه می‌دهد که برای مقیاس‌پذیری و کارایی بالا طراحی شده و برای انواع نیازهای ذخیره‌سازی داده‌ها ایده‌آل است.
.PP
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.IP
.nf
\f[C]
This will guide you through an interactive setup process:

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> n

Enter name for new remote.
name> my zata storage 

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
 
XX / Amazon S3 Compliant Storage Providers including AWS, ...
   \[rs] (s3)
 
Storage> s3

Option provider.
Choose your S3 provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 
XX / Zata (S3 compatible Gateway)
   \[rs] (Zata)

provider> Zata

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own boolean value (true or false).
Press Enter for the default (false).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth>

Option access_key_id.
AWS Access Key ID.
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
access_key_id> \[dq]your key\[dq]

Option secret_access_key.
AWS Secret Access Key (password).
Leave blank for anonymous access or runtime credentials.
Enter a value. Press Enter to leave empty.
secret_access_key> \[dq]your secret key\[dq]

Option region.
Region where you can connect with.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Indore, Madhya Pradesh, India
   \[rs] (us-east-1)
region> 1

Option endpoint.
Endpoint for Zata Object Storage.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / South Asia Endpoint
   \[rs] (idr01.zata.ai)
endpoint> 1

Option location_constraint.
Location constraint - must be set to match the Region.
Leave blank if not sure. Used when creating buckets only.
Enter a value. Press Enter to leave empty.
location_constraint>

Option acl.
Canned ACL used when creating buckets and storing or copying objects.
This ACL is used for creating objects and if bucket_acl isn\[aq]t set, for creating buckets too.
For more info visit https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl
Note that this ACL is applied when server-side copying objects as S3
doesn\[aq]t copy the ACL from the source but rather writes a fresh one.
If the acl is an empty string then no X-Amz-Acl: header is added and
the default (private) will be used.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
   / Owner gets FULL_CONTROL.
 1 | No one else has access rights (default).
   \[rs] (private)
   / Owner gets FULL_CONTROL.
 2 | The AllUsers group gets READ access.
   \[rs] (public-read)
   / Owner gets FULL_CONTROL.
 3 | The AllUsers group gets READ and WRITE access.
   | Granting this on a bucket is generally not recommended.
   \[rs] (public-read-write)
   / Owner gets FULL_CONTROL.
 4 | The AuthenticatedUsers group gets READ access.
   \[rs] (authenticated-read)
   / Object owner gets FULL_CONTROL.
 5 | Bucket owner gets READ access.
   | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.
   \[rs] (bucket-owner-read)
   / Both the object owner and the bucket owner get FULL_CONTROL over the object.
 6 | If you specify this canned ACL when creating a bucket, Amazon S3 ignores it.
   \[rs] (bucket-owner-full-control)
acl>

Edit advanced config?
y) Yes
n) No (default)
y/n>

Configuration complete.
Options:
- type: s3
- provider: Zata
- access_key_id: xxx
- secret_access_key: xxx
- region: us-east-1
- endpoint: idr01.zata.ai
Keep this \[dq]my zata storage\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d>
\f[R]
.fi
.PP
در نتیجه فایل پیکربندی به صورت زیر خواهد بود:
.IP
.nf
\f[C]
[my zata storage]
type = s3
provider = Zata
access_key_id = xxx
secret_access_key = xxx
region = us-east-1
endpoint = idr01.zata.ai
\f[R]
.fi.SS Zero Services (ZERO-Z3)
.PP
شرکت Zero Services GmbH (https://lp.zeroservices.eu/zero-z3) فضای ذخیره‌سازی شیء سازگار با S3 به نام ZERO-Z3 را ارائه می‌دهد که در اتحادیه اروپا روی شبکه اختصاصی خود (AS215197) میزبانی می‌شود.
این سرویس بر پایه Ceph RADOS Gateway ساخته شده است.
.PP
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.IP
.nf
\f[C]
This will guide you through an interactive setup process:

n) New remote
n/s/q> n

Enter name for new remote.
name> zero-z3

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Amazon S3 Compliant Storage Providers including AWS, ..., ZeroServices, ... and others
   \[rs] (s3)
Storage> s3

Option provider.
Choose your S3 provider.
[snip]
XX / Zero Services GmbH (ZERO-Z3)
   \[rs] (ZeroServices)
provider> ZeroServices

Option env_auth.
Get AWS credentials from runtime (environment variables or EC2/ECS meta data if no env vars).
 1 / Enter AWS credentials in the next step.
   \[rs] (false)
 2 / Get AWS credentials from the environment (env vars or IAM).
   \[rs] (true)
env_auth> 1

Option access_key_id.
AWS Access Key ID.
access_key_id> ACCESS_KEY

Option secret_access_key.
AWS Secret Access Key (password).
secret_access_key> SECRET_KEY

Option region.
Region to connect to.
 1 / Frankfurt 1
   \[rs] (zero-fra1)
 2 / Frankfurt 2
   \[rs] (zero-fra2)
 3 / Eyl 1
   \[rs] (zero-eyl1)
region> 2

Option endpoint.
Endpoint for ZERO-Z3.
 1 / Frankfurt 1
   \[rs] (fra1.s3.zeroservices.eu)
 2 / Frankfurt 2
   \[rs] (fra.s3.zeroservices.eu)
 3 / Eyl 1
   \[rs] (eyl1.s3.zeroservices.eu)
endpoint> 2

Option acl.
Canned ACL used when creating buckets and storing or copying objects.
[snip]
acl> 1

Edit advanced config?
y/n> n

Configuration complete.
Options:
- type: s3
- provider: ZeroServices
- access_key_id: ACCESS_KEY
- secret_access_key: SECRET_KEY
- region: zero-fra2
- endpoint: fra.s3.zeroservices.eu
Keep this \[dq]zero-z3\[dq] remote?
y/e/d> y
\f[R]
.fi.SS "مصرف حافظه (Memory usage)"
.PP
شایع‌ترین دلیل مصرف زیاد حافظه توسط rclone، وجود یک دایرکتوری واحد با میلیون‌ها فایل درون آن است.
با وجود اینکه s3 در واقع مفهومی به نام دایرکتوری ندارد، rclone همگام‌سازی را دایرکتوری به دایرکتوری انجام می‌دهد تا با سیستم‌های فایل معمولی سازگار باشد.
.PP
دستور rclone هر دایرکتوری را به صورت اشیاء rclone در حافظه بارگذاری می‌کند.
هر شیء rclone حدود 0.5k تا 1k از حافظه را اشغال می‌کند، یعنی تقریباً ۱ گیگابایت به ازای هر ۱٬۰۰۰٬۰۰۰ فایل، و همگام‌سازی آن دایرکتوری تا زمانی که به طور کامل در حافظه بارگذاری نشود آغاز نمی‌گردد.
بنابراین، شروع همگام‌سازی برای دایرکتوری‌های بزرگ ممکن است زمان زیادی طول بکشد.
.PP
برای همگام‌سازی دایرکتوری‌ای با ۱۰۰٬۰۰۰٬۰۰۰ فایل درون آن، به حدود ۱۰۰ گیگابایت حافظه نیاز خواهید داشت.
در نقطه‌ای تأمین این مقدار حافظه دشوار می‌شود، از این رو یک راهکار جایگزین برای این موضوع وجود دارد (https://github.com/rclone/rclone/wiki/Big-syncs-with-millions-of-files) که نیازمند اندکی اسکریپت‌نویسی است.
.PP
در آینده rclone به یک حالت همگام‌سازی مجهز خواهد شد که عملاً همین راهکار را به صورت توکار در rclone پیاده‌سازی می‌کند.
.SS "محدودیت‌ها (Limitations)"
.PP
دستور \f[V]rclone about\f[R] توسط بک‌اند S3 پشتیبانی نمی‌شود.
بک‌اندهایی که فاقد این قابلیت هستند، نمی‌توانند فضای آزاد را برای یک \f[V]rclone mount\f[R] تعیین کنند یا از سیاست \f[V]mfs\f[R] (بیشترین فضای خالی) به عنوان عضوی از ریموت union در rclone بهره ببرند.
.PP
فهرست بک‌اندهایی که از rclone about پشتیبانی نمی‌کنند (https://rclone.org/overview/#optional-features) و مستندات rclone about (https://rclone.org/commands/rclone_about) را ببینید.
.SH "آرشیو (ARCHIVE)"
.PP
بک‌اند Archive امکان دسترسی فقط‌خواندنی به محتوای فایل‌های آرشیو موجود در فضای ابری را بدون نیاز به دریافت کامل فایل آرشیو فراهم می‌کند.
این بدان معناست که می‌توانید یک فایل آرشیو بزرگ را mount کرده و به جای استخراج تمام آن، تنها از بخش‌هایی که برنامه شما نیاز دارد استفاده کنید.
.PP
فایل‌های آرشیو بر اساس پسوندشان شناسایی می‌شوند.
.PP
.TS
tab(@);
l l.
T{
آرشیو
T}@T{
پسوند
T}
_
T{
Zip
T}@T{
\f[V].zip\f[R]
T}
T{
Squashfs
T}@T{
\f[V].sqfs\f[R]
T}
.TE
.PP
انواع فایل‌های آرشیو پشتیبانی‌شده سازگار با ابری (cloud friendly) هستند \- یک فایل مجزا را می‌توان بدون نیاز به بارگیری تمام آرشیو پیدا کرد و دانلود نمود.
.PP
اگر صرفاً می‌خواهید آرشیوها را بسازید، فهرست کنید یا استخراج نمایید و قصد mount کردن آن‌ها را ندارید، استفاده از دستورات \f[V]rclone archive\f[R] می‌تواند برایتان راحت‌تر باشد.
.IP \[bu] 2
rclone archive create (https://rclone.org/commands/rclone_archive_create)
.IP \[bu] 2
rclone archive list (https://rclone.org/commands/rclone_archive_list)
.IP \[bu] 2
rclone archive extract (https://rclone.org/commands/rclone_archive_extract)
.PP
این دستورات از طیف وسیع‌تری از آرشیوهای ناسازگار با ابر پشتیبانی می‌کنند (به جز squashfs)، اما نمی‌توان از آن‌ها برای \f[V]rclone mount\f[R] یا سایر دستورات rclone (مانند \f[V]rclone check\f[R]) استفاده کرد..SS "پیکربندی (Configuration)"
.PP
بهترین حالت استفاده از این backend، بدون پیکربندی است.
.PP
برای استفاده از آن، رشتهٔ \f[V]:archive:\f[R] را پیش از یک remote دیگر قرار دهید؛ مثلاً \f[V]remote:dir\f[R] را به \f[V]:archive:remote:dir\f[R] تبدیل کنید.
.PP
تمام آرشیوهای موجود در \f[V]remote:dir\f[R] به دایرکتوری تبدیل می‌شوند و تمام فایل‌ها را می‌توان به صورت جداگانه از درون آن‌ها خواند.
.PP
برای مثال:
.IP
.nf
\f[C]
$ rclone lsf s3:rclone/dir
100files.sqfs
100files.zip
\f[R]
.fi
.PP
توجه کنید که \f[V]100files.zip\f[R] و \f[V]100files.sqfs\f[R] اکنون دایرکتوری هستند:
.IP
.nf
\f[C]
$ rclone lsf :archive:s3:rclone/dir
100files.sqfs/
100files.zip/
\f[R]
.fi
.PP
که می‌توانیم محتویات درون آن‌ها را مشاهده کنیم:
.IP
.nf
\f[C]
$ rclone lsf :archive:s3:rclone/dir/100files.zip/
cofofiy5jun
gigi
hevupaz5z
kacak/
kozemof/
lamapaq4
qejahen
quhenen2rey
soboves8
vibat/
wose
xade
zilupot
\f[R]
.fi
.PP
فایل‌هایی که درون آرشیو قرار ندارند، به طور معمول قابل خواندن و نوشتن هستند.
فایل‌های موجود در یک آرشیو تنها قابل خواندن هستند.
.PP
همچنین می‌توان از backend آرشیو در یک فایل پیکربندی استفاده کرد.
از متغیر \f[V]remote\f[R] برای اشاره به مقصد آرشیو استفاده کنید.
.IP
.nf
\f[C]
[remote]
type = archive
remote = s3:rclone/dir/100files.zip
\f[R]
.fi
.PP
خروجی می‌دهد:
.IP
.nf
\f[C]
$ rclone lsf remote:
cofofiy5jun
gigi
hevupaz5z
kacak/
\&...
\f[R]
.fi
.SS "زمان‌های تغییر (Modification times)"
.PP
زمان‌های تغییر با دقتی که به نوع آرشیو بستگی دارد، حفظ می‌شوند.
.IP
.nf
\f[C]
$ rclone lsl --max-depth 1 :archive:s3:rclone/dir/100files.zip
       12 2025-10-27 14:39:20.000000000 cofofiy5jun
       81 2025-10-27 14:39:20.000000000 gigi
       58 2025-10-27 14:39:20.000000000 hevupaz5z
        6 2025-10-27 14:39:20.000000000 lamapaq4
       43 2025-10-27 14:39:20.000000000 qejahen
       66 2025-10-27 14:39:20.000000000 quhenen2rey
       95 2025-10-27 14:39:20.000000000 soboves8
       71 2025-10-27 14:39:20.000000000 wose
       76 2025-10-27 14:39:20.000000000 xade
       15 2025-10-27 14:39:20.000000000 zilupot
\f[R]
.fi
.PP
برای فایل‌های \f[V]zip\f[R] و \f[V]squashfs\f[R] این مقدار 1s است..SS "هش‌ها (Hashes)"
.PP
این‌که کدام هش پشتیبانی می‌شود، به نوع آرشیو بستگی دارد.
فایل‌های Zip از CRC32 استفاده می‌کنند، در حالی که Squashfs از هیچ هشی پشتیبانی نمی‌کند.
برای نمونه:
.IP
.nf
\f[C]
$ rclone hashsum crc32 :archive:s3:rclone/dir/100files.zip/
b2288554  cofofiy5jun
a87e62b6  wose
f90f630b  xade
c7d0ef29  gigi
f1c64740  soboves8
cb7b4a5d  quhenen2rey
5115242b  kozemof/fonaxo
afeabd9a  qejahen
71202402  kozemof/fijubey5di
bd99e512  kozemof/napux
\&...
\f[R]
.fi
.PP
هش‌ها هنگام خوانده شدن فایل از آرشیو بررسی می‌شوند و در صورت امکان به عنوان بخشی از همگام‌سازی مورد استفاده قرار می‌گیرند.
.IP
.nf
\f[C]
$ rclone copy -vv :archive:s3:rclone/dir/100files.zip /tmp/100files
\&...
2025/10/27 14:56:44 DEBUG : kacak/turovat5c/yuyuquk: crc32 = abd05cc8 OK
2025/10/27 14:56:44 DEBUG : kacak/turovat5c/yuyuquk.aeb661dc.partial: renamed to: kacak/turovat5c/yuyuquk
2025/10/27 14:56:44 INFO  : kacak/turovat5c/yuyuquk: Copied (new)
\&...
\f[R]
.fi
.SS Zip
.PP
قالب فایل Zip (https://en.wikipedia.org/wiki/ZIP_(file_format)) یک قالب آرشیو پرکاربرد است که یک یا چند فایل و پوشه را در یک فایل واحد بسته‌بندی می‌کند، در درجه اول برای ذخیره‌سازی یا انتقال آسان‌تر.
این قالب معمولاً از فشرده‌سازی (بیشتر الگوریتم DEFLATE) برای کاهش حجم کلی محتوای آرشیو شده استفاده می‌کند.
فایل‌های Zip به‌طور بومی توسط بیشتر سیستم‌عامل‌های امروزی پشتیبانی می‌شوند.
.PP
ابزار Rclone از ویژگی‌های پیشرفته زیر در فایل‌های Zip پشتیبانی نمی‌کند:
.IP \[bu] 2
تقسیم آرشیوهای بزرگ به بخش‌های کوچک‌تر
.IP \[bu] 2
محافظت با گذرواژه
.IP \[bu] 2
فشرده‌سازی Zstd
.SS Squashfs
.PP
Squashfs یک قالب سیستم‌فایل فشرده و فقط‌خواندنی است که عمدتاً در سیستم‌های مبتنی بر لینوکس استفاده می‌شود.
این قالب برای فشرده‌سازی کل یک سیستم‌فایل (شامل فایل‌ها، دایرکتوری‌ها و فراداده‌ها) در یک فایل آرشیو واحد طراحی شده است، که پس از آن می‌تواند مستقیماً سوار (mount) شده و خوانده شود و به صورت یک ساختار دایرکتوری عادی نمایان گردد.
به دلیل فقط‌خواندنی بودن و فشردگی بالا، Squashfs برای CD/USBهای زنده (Live)، دستگاه‌های تعبیه‌شده با فضای ذخیره‌سازی محدود و توزیع بسته‌های نرم‌افزاری ایدئال است، زیرا در فضا صرفه‌جویی کرده و یکپارچگی فایل‌های اصلی را تضمین می‌کند.
.PP
ابزار Rclone از قالب‌های فشرده‌سازی squashfs زیر پشتیبانی می‌کند:
.IP \[bu] 2
\f[V]Gzip\f[R]
.IP \[bu] 2
\f[V]Lzma\f[R]
.IP \[bu] 2
\f[V]Xz\f[R]
.IP \[bu] 2
\f[V]Zstd\f[R]
.PP
این موارد هنوز کار نمی‌کنند:
.IP \[bu] 2
\f[V]Lzo\f[R] \- هنوز پشتیبانی نمی‌شود
.IP \[bu] 2
\f[V]Lz4\f[R] \- خراب با خطای \[dq]error decompressing: lz4: bad magic
number\[dq]
.PP
ابزار Rclone با اندازه‌های بزرگ بلوک squashfs بیشترین سرعت را دارد.
برای نمونه:
.IP
.nf
\f[C]
mksquashfs 100files 100files.sqfs -comp zstd -b 1M
\f[R]
.fi.SS "محدودیت‌ها (Limitations)"
.PP
فایل‌ها در بک‌اند archive فقط‌خواندنی هستند.
هنوز امکان ایجاد آرشیوها با بک‌اند archive وجود ندارد.
با این حال، شما \f[B]می‌توانید\f[R] با rclone archive
create آرشیو بسازید (<https://rclone.org/commands/rclone_archive_create>).
.PP
تنها از آرشیوهای \f[V].zip\f[R] و \f[V].sqfs\f[R] پشتیبانی می‌شود، چرا
که این‌ها تنها فرمت‌های رایج آرشیو هستند که خواندن فهرست دایرکتوری را
از درون آرشیو بدون نیاز به بارگیری کل آن آسان می‌کنند.
.PP
در بخش داخلی، بک‌اند archive از VFS برای دسترسی به فایل‌ها استفاده
می‌کند.
هنوز امکان پیکربندی VFS داخلی وجود ندارد، هرچند ممکن است قابلیتی مفید
باشد.
.SS "فرمت‌های آرشیو (Archive Formats)"
.PP
در اینجا جدولی برای رتبه‌بندی فرمت‌های رایج آرشیو از نظر «بهینه‌سازی
ابری» آمده است که بر اساس توانایی آن‌ها در دسترسی به یک فایل منفرد بدون
خواندن کل آرشیو سنجیده می‌شود.
.PP
این قابلیت به این بستگی دارد که آیا فرمت دارای یک \f[B]نمایه\f[R] (یا
\[dq]فهرست محتوا\[dq]) مرکزی است که برنامه بتواند ابتدا آن را بخواند تا
مکان دقیق یک فایل خاص را بیابد یا خیر.
.PP
.TS
tab(@);
lw(17.5n) lw(17.5n) lw(17.5n) lw(17.5n).
T{
فرمت
T}@T{
پسوندها
T}@T{
بهینه‌سازی ابری
T}@T{
توضیحات
T}
_
T{
\f[B]ZIP\f[R]
T}@T{
\f[V].zip\f[R]
T}@T{
\f[B]عالی\f[R]
T}@T{
\f[B]فایل‌های Zip دارای یک نمایه\f[R] (همان \[dq]central directory\[dq])
ذخیره‌شده در \f[I]انتهای\f[R] فایل هستند.
برنامه می‌تواند به انتهای فایل پرش کند (seek)، نمایه را بخواند تا مکان
و اندازه فایل را بیابد، و سپس مستقیماً به داده‌های آن فایل پرش کند تا
آن را استخراج نماید.
T}
T{
\f[B]SquashFS\f[R]
T}@T{
\f[V].squashfs\f[R], \f[V].sqfs\f[R], \f[V].sfs\f[R]
T}@T{
\f[B]عالی\f[R]
T}@T{
این یک \f[I]ایمیج سیستم‌فایل\f[R] فشرده و فقط‌خواندنی است، نه صرفاً یک
آرشیو.
این فرمت \f[B]به‌طور خاص برای دسترسی تصادفی طراحی شده است\f[R].
این ساختار از متادیتا و جدول‌های نمایه استفاده می‌کند تا به سیستم اجازه
دهد فایل‌ها یا بلوک‌های داده منفرد را بر حسب تقاضا پیدا کرده و از حالت
فشرده خارج کند.
T}
T{
\f[B]ISO Image\f[R]
T}@T{
\f[V].iso\f[R]
T}@T{
\f[B]عالی\f[R]
T}@T{
همانند SquashFS، این یک \f[I]ایمیج سیستم‌فایل\f[R] (برای رسانه‌های نوری)
است.
این ایمیج شامل یک سیستم‌فایل (مانند ISO 9660 یا UDF) همراه با یک
\f[B]فهرست محتوا در مکانی مشخص\f[R] است که امکان دسترسی مستقیم به هر فایل
را بدون خواندن کل دیسک فراهم می‌کند.
T}
T{
\f[B]RAR\f[R]
T}@T{
\f[V].rar\f[R]
T}@T{
\f[B]خوب\f[R]
T}@T{
فرمت RAR از حالت‌های \[dq]non-solid\[dq] و \[dq]solid\[dq] پشتیبانی
می‌کند.
در حالت متداول \f[B]non-solid\f[R]، فایل‌ها به‌طور جداگانه فشرده می‌شوند
و یک نمایه امکان استخراج آسان فایل منفرد را فراهم می‌کند (مانند ZIP).
در حالت \[dq]solid\[dq]، این رتبه \[dq]بسیار ضعیف\[dq] خواهد بود.
T}
T{
\f[B]7z\f[R]
T}@T{
\f[V].7z\f[R]
T}@T{
\f[B]ضعیف\f[R]
T}@T{
به‌طور پیش‌فرض، 7z از آرشیوهای \[dq]solid\[dq] برای به حداکثر رساندن
فشرده‌سازی استفاده می‌کند.
این کار فایل‌ها را به عنوان یک جریان پیوسته فشرده می‌سازد.
برای استخراج یک فایل از میانه، ابتدا باید تمام فایل‌های قبلی از حالت
فشرده خارج شوند.
(اگر صراحتاً به صورت \[dq]non-solid\[dq] ایجاد شود، رتبه آن
\[dq]عالی\[dq] خواهد بود).
T}
T{
\f[B]tar\f[R]
T}@T{
\f[V].tar\f[R]
T}@T{
\f[B]ضعیف\f[R]
T}@T{
فرمت \[dq]Tape Archive\[dq] یک فرمت \f[I]جریانی\f[R] و \f[B]فاقد نمایه
مرکزی\f[R] است.
برای یافتن یک فایل، باید آرشیو را از ابتدا بخوانید و سرآیند هر فایل را
یکی‌یکی بررسی کنید تا به مورد دلخواه برسید.
این کار کُند است، اما نیازی به خارج کردن داده‌ها از حالت فشرده ندارد.
T}
T{
\f[B]Gzipped Tar\f[R]
T}@T{
\f[V].tar.gz\f[R], \f[V].tgz\f[R]
T}@T{
\f[B]بسیار ضعیف\f[R]
T}@T{
این یک فایل \f[V]tar\f[R] است (که خود از پیش \[dq]ضعیف\[dq] است) که با
\f[V]gzip\f[R] به صورت یک \f[B]جریان واحد و غیرقابل پرش (non-seekable)\f[R]
فشرده شده است.
امکان پرش (seek) وجود ندارد.
برای دستیابی به \f[I]هر\f[R] فایلی، باید \f[I]کل\f[R] آرشیو را از ابتدا تا
آن فایل از حالت فشرده خارج کنید.
T}
T{
\f[B]Bzipped/XZ Tar\f[R]
T}@T{
\f[V].tar.bz2\f[R], \f[V].tar.xz\f[R]
T}@T{
\f[B]بسیار ضعیف\f[R]
T}@T{
اصول کار این فرمت مشابه \f[V]tar.gz\f[R] است.
کل آرشیو یک بلوک فشرده بزرگ است که دسترسی تصادفی را غیرممکن می‌سازد.
T}
.TE.SS ایده‌هایی برای بهبود
.PP
افزودن پشتیبانی از ISO نسبتاً آسان خواهد بود، زیرا کتابخانه‌ای که استفاده می‌کنیم (go-diskfs (https://github.com/diskfs/go-diskfs)) از آن پشتیبانی می‌کند.
همچنین می‌توانیم \f[V]ext4\f[R] و \f[V]fat32\f[R] را نیز به همان روش اضافه کنیم،
اما طبق تجربه، این موارد به عنوان فایل چندان رایج نیستند و بنابراین احتمالاً ارزشش را ندارد.
go-diskfs همچنین می‌تواند پارتیشن‌ها را بخواند که بالقوه می‌توانیم از آن بهره‌مند شویم.
.PP
امکان افزودن پشتیبانی از نوشتن وجود دارد، اما این مورد تنها برای ایجاد آرشیوهای جدید خواهد بود، نه برای به‌روزرسانی آرشیوهای موجود.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مخصوص archive (خواندن آرشیوها) آورده شده است.
.SS --archive-remote
.PP
ریموت مورد نظر جهت پوشش‌دهی برای خواندن آرشیوها از آن.
.PP
به‌طور معمول باید شامل یک \[aq]:\[aq] و یک مسیر باشد، مانند
\[dq]myremote:path/to/dir\[dq]، \[dq]myremote:bucket\[dq] یا
\[dq]myremote:\[dq].
.PP
اگر این مقدار خالی رها شود، backend مربوط به archive از ریشه به عنوان ریموت استفاده خواهد کرد.
.PP
این بدان معناست که می‌توانید از :archive:remote:path استفاده کنید و این معادل تنظیم remote=\[dq]remote:path\[dq] خواهد بود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: remote
.IP \[bu] 2
متغیر محیطی: RCLONE_ARCHIVE_REMOTE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مخصوص archive (خواندن آرشیوها) آورده شده است.
.SS --archive-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_ARCHIVE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS متادیتا
.PP
هرگونه متادیتای پشتیبانی‌شده توسط ریموت زیربنایی خوانده و نوشته می‌شود.
.PP
برای اطلاعات بیشتر مستندات metadata (https://rclone.org/docs/#metadata) را ببینید.
.SH Backblaze B2
.PP
سیستم B2 سامانه ذخیره‌سازی ابری Backblaze است (https://www.backblaze.com/cloud-storage).
.PP
مسیرها به صورت \f[V]remote:bucket\f[R] (یا \f[V]remote:\f[R] برای دستور \f[V]lsd\f[R]) مشخص می‌شوند.
همچنین می‌توانید زیرپوشه‌ها را نیز وارد کنید، مانند
\f[V]remote:bucket/path/to/dir\f[R].
.SS پیکربندی
.PP
در اینجا مثالی از ایجاد یک پیکربندی b2 آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این فرمان شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند.
برای احراز هویت به Account ID (یک عدد هگز کوتاه) و Master Application Key (یک عدد هگز طولانی) یا یک Application Key نیاز خواهید داشت که روش توصیه‌شده است.
برای جزئیات بیشتر در مورد ایجاد و استفاده از یک Application Key بخش‌های بعدی را ببینید.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
q) Quit config
n/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Backblaze B2
   \[rs] \[dq]b2\[dq]
[snip]
Storage> b2
Account ID or Application Key ID
account> 123456789abc
Application Key
key> 0123456789abcdef0123456789abcdef0123456789
Endpoint for the service - leave blank normally.
endpoint>
Remote config
Configuration complete.
Options:
- type: b2
- account: 123456789abc
- key: 0123456789abcdef0123456789abcdef0123456789
- endpoint:
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
این ریموت \f[V]remote\f[R] نامیده می‌شود و اکنون می‌تواند به این صورت استفاده شود:
.PP
مشاهده همه باکت‌ها
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
ایجاد یک باکت جدید
.IP
.nf
\f[C]
rclone mkdir remote:bucket
\f[R]
.fi
.PP
فهرست کردن محتویات یک باکت
.IP
.nf
\f[C]
rclone ls remote:bucket
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با باکت ریموت، با حذف هرگونه فایل اضافی در باکت.
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory remote:bucket
\f[R]
.fi.SS کلیدهای برنامه (Application Keys)
.PP
سرویس B2 از چندین کلید برنامه (Application Key) برای مجوزهای دسترسی مختلف به
باکت‌های B2 پشتیبانی می‌کند
(https://www.backblaze.com/docs/cloud-storage-application-keys).
.PP
شما می‌توانید از این کلیدها با rclone نیز استفاده کنید؛ برای این کار به
rclone نسخهٔ 1.43 یا بالاتر نیاز خواهید داشت.
.PP
مستندات Backblaze را برای ایجاد یک Application Key با مجوزهای لازم دنبال کرده و
\f[V]applicationKeyId\f[R] را به عنوان \f[V]account\f[R] و خود
\f[V]Application Key\f[R] را به عنوان \f[V]key\f[R] اضافه کنید.
.PP
توجه داشته باشید که باید \f[I]applicationKeyId\f[R] را به عنوان
\f[V]account\f[R] قرار دهید \[en] نمی‌توانید از Account ID اصلی استفاده کنید.
اگر این کار را امتحان کنید، B2 خطاهای 401 را برمی‌گرداند.
.SS --fast-list
.PP
این ریموت از \f[V]--fast-list\f[R] پشتیبانی می‌کند که به شما امکان می‌دهد
در ازای مصرف حافظهٔ بیشتر، از تعداد تراکنش‌های کمتری استفاده کنید.
برای جزئیات بیشتر به مستندات rclone
(https://rclone.org/docs/#fast-list) مراجعه کنید.
.SS زمان‌های تغییر (Modification times)
.PP
زمان تغییر به عنوان فراداده روی شیء در
\f[V]X-Bz-Info-src_last_modified_millis\f[R] به صورت میلی‌ثانیه از تاریخ
1970-01-01 طبق استاندارد Backblaze ذخیره می‌شود.
ابزارهای دیگر باید بتوانند از این مقدار به عنوان زمان تغییر استفاده کنند.
.PP
زمان‌های تغییر در فرایند همگام‌سازی استفاده می‌شوند و کاملاً پشتیبانی می‌شوند.
توجه داشته باشید که اگر نیاز به به‌روزرسانی زمان تغییر روی یک شیء باشد،
نسخهٔ جدیدی از آن شیء ایجاد خواهد شد.
.SS نویسه‌های محدودشده در نام فایل (Restricted filename characters)
.PP
علاوه بر مجموعه نویسه‌های محدودشدهٔ
پیش‌فرض (https://rclone.org/overview/#restricted-characters)، نویسه‌های
زیر نیز جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند
شد (https://rclone.org/overview/#invalid-utf8)، چرا که نمی‌توان از آن‌ها
در رشته‌های JSON استفاده کرد.
.PP
توجه داشته باشید که از 2020-05 شرکت Backblaze اجازهٔ استفاده از نویسه‌های \ را در
نام فایل‌ها داد.
rclone کدگذاری خود را تغییر نداده است زیرا این امر می‌تواند باعث انتقال مجدد
فایل‌ها در همگام‌سازی‌ها شود.
اگر می‌خواهید rclone نویسهٔ \ را جایگزین نکند، گزینهٔ \f[V]--b2-encoding\f[R]
در زیر را بررسی کرده و \f[V]BackSlash\f[R] را از رشته حذف کنید.
این مورد می‌تواند در تنظیمات (config) تعیین شود.
.SS چک‌سام‌های SHA1 (SHA1 checksums)
.PP
چک‌سام‌های SHA1 فایل‌ها هنگام بارگذاری و بارگیری بررسی می‌شوند و در فرایند
همگام‌سازی مورد استفاده قرار خواهند گرفت.
.PP
فایل‌های بزرگ (بزرگ‌تر از محدودیت در \f[V]--b2-upload-cutoff\f[R])
که به صورت تکه‌تکه بارگذاری می‌شوند، همان‌طور که Backblaze توصیه کرده است
چک‌سام SHA1 خود را روی شیء به عنوان
\f[V]X-Bz-Info-large_file_sha1\f[R] ذخیره می‌کنند.
.PP
برای این‌که یک فایل بزرگ با چک‌سام SHA1 بارگذاری شود، مبدأ باید از چک‌سام‌های
SHA1 پشتیبانی کند.
دیسک محلی از چک‌سام‌های SHA1 پشتیبانی می‌کند، بنابراین انتقال فایل‌های بزرگ
از دیسک محلی دارای SHA1 خواهد بود.
برای بررسی دقیق این‌که کدام ریموت‌ها از SHA1 پشتیبانی می‌کنند، نمای کلی
(https://rclone.org/overview/#features) را ببینید.
.PP
مبدأهایی که از SHA1 پشتیبانی نمی‌کنند، به‌ویژه \f[V]crypt\f[R]، فایل‌های
بزرگ را بدون چک‌سام‌های SHA1 بارگذاری خواهند کرد.
این مشکل ممکن است در آینده برطرف شود (ببینید
#1767 (https://github.com/rclone/rclone/issues/1767)).
.PP
فایل‌هایی با اندازهٔ کمتر از \f[V]--b2-upload-cutoff\f[R] صرف‌نظر از مبدأ،
همیشه یک SHA1 خواهند داشت..SS "انتقال‌ها (Transfers)"
.PP
شرکت Backblaze پیشنهاد می‌کند که برای بیشترین سرعت، تعداد زیادی انتقال را به‌طور هم‌زمان انجام دهید.
در آزمایش‌های انجام‌شده روی لپ‌تاپ من که مجهز به SSD بود، تنظیم بهینه حدود
\f[V]--transfers 32\f[R] بود، هرچند ممکن است مقادیر بالاتر نیز باعث بهبود اندکی در سرعت شوند.
مقدار بهینه برای شما بسته به سخت‌افزارتان، اندازهٔ فایل‌ها، میزان باری که می‌خواهید روی رایانهٔ خود اعمال کنید و غیره، ممکن است متفاوت باشد.
با این حال، مقدار پیش‌فرض \f[V]--transfers 4\f[R] قطعاً برای Backblaze B2 بسیار کم است.
.PP
توجه داشته باشید که بارگذاری فایل‌های بزرگ (به‌طور پیش‌فرض بزرگ‌تر از 200 MiB) به‌صورت پیش‌فرض از یک بافر رَم (RAM) به میزان 96 MiB استفاده خواهد کرد.
در هر لحظه حداکثر می‌تواند به تعداد \f[V]--transfers\f[R] از این بافرها در حال استفاده باشد، بنابراین این امر حد بالای حافظهٔ مصرفی را تعیین می‌کند.
.SS "نسخه‌ها (Versions)"
.PP
تنظیمات پیش‌فرض B2 بر نگه‌داری نسخه‌های قدیمی فایل‌ها قرار دارد.
این بدان معناست که وقتی rclone نسخهٔ جدیدی از یک فایل را بارگذاری می‌کند، یک نسخهٔ جدید از
آن ایجاد می‌کند (https://www.backblaze.com/docs/cloud-storage-file-versions).
به همین ترتیب، هنگامی که فایلی را حذف می‌کنید، نسخهٔ قبلی به عنوان مخفی (hidden) علامت‌گذاری شده و همچنان در دسترس خواهد بود.
.PP
اینکه آیا B2 نسخه‌های قدیمی فایل‌ها را نگه دارد یا خیر، می‌تواند برای هر باکت به‌صورت جداگانه با استفاده از \[dq]Lifecycle settings\[dq] در پنل کاربری B2، یا هنگام ایجاد باکت با پرچم \f[V]--b2-lifecycle\f[R] و یا پس از ایجاد با استفاده از دستور \f[V]rclone backend lifecycle\f[R] تنظیم شود.
.PP
شما می‌توانید با استفاده از پرچم \f[V]--b2-hard-delete\f[R] حالت \[dq]حذف قطعی (hard delete)\[dq] فایل‌ها را برگزینید که به جای پنهان کردن فایل‌ها هنگام حذف، آن‌ها را برای همیشه پاک می‌کند.
.PP
نسخه‌های قدیمی فایل‌ها، در صورت در دسترس بودن، با پرچم
\f[V]--b2-versions\f[R] قابل مشاهده هستند.
این موارد را می‌توان در صورت نیاز با \f[V]delete\f[R] پاک کرد.
.PP
همچنین می‌توان با استفاده از پرچم \f[V]--b2-version-at\f[R] یک باکت را همان‌گونه که در مقطع زمانی مشخصی بوده است مشاهده کرد.
این کار نسخه‌های فایل را همان‌گونه که در آن زمان مشخص بوده‌اند نشان می‌دهد؛ فایل‌هایی که پس از آن حذف شده‌اند را نمایش داده و فایل‌هایی که از آن زمان به بعد ایجاد شده‌اند را پنهان می‌کند.
.PP
اگر می‌خواهید تمام نسخه‌های قدیمی و بارگذاری‌های ناتمام فایل‌های بزرگ را حذف کنید، می‌توانید از دستور
\f[V]rclone cleanup remote:bucket\f[R]
استفاده کنید که تمام نسخه‌های قدیمی فایل‌ها را پاک کرده و فایل‌های فعلی را دست‌نخورده باقی می‌گذارد.
همچنین می‌توانید یک مسیر را مشخص کنید تا تنها نسخه‌های قدیمی زیر آن مسیر حذف شوند، مانند:
\f[V]rclone cleanup remote:bucket/path/to/stuff\f[R].
.PP
توجه داشته باشید که اگر فایل‌های ناقص بارگذاری‌شده بیش از یک روز قدمت داشته باشند، دستور \f[V]cleanup\f[R] آن‌ها را از باکت حذف خواهد کرد.
اگر می‌خواهید کنترل بیشتری روی زمان انقضا داشته باشید، دستور
\f[V]rclone backend cleanup b2:bucket -o max-age=1h\f[R]
را اجرا کنید تا تمام بارگذاری‌های ناتمام فایل‌های بزرگ قدیمی‌تر از یک ساعت را حذف کند، در حالی که نسخه‌های قدیمی دست‌نخورده باقی می‌مانند.
.PP
اگر می‌خواهید تمام نسخه‌های قدیمی را حذف کنید و در عین حال فایل‌های فعلی و بارگذاری‌های ناتمام فایل‌های بزرگ دست‌نخورده باقی بمانند، می‌توانید از دستور
\f[V]rclone backend cleanup-hidden remote:bucket\f[R]
استفاده نمایید.
همچنین می‌توانید یک مسیر تعیین کنید تا تنها نسخه‌های قدیمی زیر آن مسیر حذف شوند، به عنوان مثال:
\f[V]rclone backend cleanup-hidden remote:bucket/path/to/stuff\f[R].
.PP
هنگامی که یک باکت را \f[V]purge\f[R] می‌کنید، نسخه‌های فعلی و قدیمی حذف شده و سپس خود باکت حذف خواهد شد.
.PP
با این حال دستور \f[V]delete\f[R] باعث می‌شود نسخه‌های فعلی فایل‌ها به نسخه‌های قدیمیِ پنهان تبدیل شوند.
.PP
در ادامه نشستی کاری آورده شده است که فهرست‌گیری و بازیابی یک نسخهٔ قدیمی و سپس یک \f[V]cleanup\f[R] از نسخه‌های قدیمی را نشان می‌دهد.
.PP
نمایش نسخهٔ فعلی و تمام نسخه‌ها با پرچم \f[V]--b2-versions\f[R].
.IP
.nf
\f[C]
$ rclone -q ls b2:cleanup-test
        9 one.txt

$ rclone -q --b2-versions ls b2:cleanup-test
        9 one.txt
        8 one-v2016-07-04-141032-000.txt
       16 one-v2016-07-04-141003-000.txt
       15 one-v2016-07-02-155621-000.txt
\f[R]
.fi
.PP
بازیابی یک نسخهٔ قدیمی
.IP
.nf
\f[C]
$ rclone -q --b2-versions copy b2:cleanup-test/one-v2016-07-04-141003-000.txt /tmp

$ ls -l /tmp/one-v2016-07-04-141003-000.txt
-rw-rw-r-- 1 ncw ncw 16 Jul  2 17:46 /tmp/one-v2016-07-04-141003-000.txt
\f[R]
.fi
.PP
پاک‌سازی تمام نسخه‌های قدیمی و نمایش حذف شدن آن‌ها.
.IP
.nf
\f[C]
$ rclone -q cleanup b2:cleanup-test

$ rclone -q ls b2:cleanup-test
        9 one.txt

$ rclone -q --b2-versions ls b2:cleanup-test
        9 one.txt
\f[R]
.fi.SS "نکته مهم نام‌گذاری نسخه‌ها (Versions naming caveat)"
.PP
هنگام استفاده از گزینهٔ \f[V]--b2-versions\f[R]، ابزار rclone برای تشخیص این‌که آیا اشیاء نسخه هستند یا خیر، به نام فایل اتکا می‌کند.
نام نسخه‌ها با درج برچسب زمان (timestamp) میان نام فایل و پسوند آن ساخته می‌شود.
.IP
.nf
\f[C]
        9 file.txt
        8 file-v2023-07-17-161032-000.txt
       16 file-v2023-06-15-141003-000.txt
\f[R]
.fi
.PP
اگر فایل‌های واقعی با نام‌هایی مشابه با نام نسخه‌ها وجود داشته باشند، رفتار \f[V]--b2-versions\f[R] می‌تواند غیرقابل‌پیش‌بینی باشد.
.SS "مصرف داده (Data usage)"
.PP
دانستن تعداد درخواست‌های ارسال‌شده به کارساز در سناریوهای مختلف مفید است.
.PP
تمام دستورهای کپی، ۴ درخواست زیر را ارسال می‌کنند:
.IP
.nf
\f[C]
/b2api/v4/b2_authorize_account
/b2api/v1/b2_create_bucket
/b2api/v1/b2_list_buckets
/b2api/v1/b2_list_file_names
\f[R]
.fi
.PP
درخواست \f[V]b2_list_file_names\f[R] به ازای هر ۱۰۰۰ فایل در مسیر دوردست (remote) یک بار ارسال می‌شود و چsum (چک‌سام) و زمان ویرایش فایل‌های فهرست‌شده را ارائه می‌دهد.
از نسخهٔ 1.33، گزارش باگ
#818 (<https://github.com/rclone/rclone/issues/818>) باعث می‌شود در صورت استفاده از B2 به همراه Crypt، درخواست‌های اضافی ارسال شوند.
هنگامی که یک عملیات کپی نیازی به بارگذاری هیچ فایلی نداشته باشد، درخواست دیگری ارسال نخواهد شد.
.PP
بارگذاری فایل‌هایی که نیازی به تکه‌تکه شدن (chunking) ندارند، به ازای هر بارگذاری فایل ۲ درخواست ارسال می‌کند:
.IP
.nf
\f[C]
/b2api/v1/b2_get_upload_url
/b2api/v1/b2_upload_file/
\f[R]
.fi
.PP
بارگذاری فایل‌هایی که به تکه‌تکه شدن نیاز دارند، ۲ درخواست (یک درخواست برای شروع و یک درخواست برای اتمام بارگذاری) و ۲ درخواست دیگر به ازای هر قطعه (chunk) ارسال می‌کند:
.IP
.nf
\f[C]
/b2api/v1/b2_start_large_file
/b2api/v1/b2_get_upload_part_url
/b2api/v1/b2_upload_part/
/b2api/v1/b2_finish_large_file
\f[R]
.fi
.SS "مشاهده نسخه‌ها با --b2-versions (Viewing versions with --b2-versions)"
.PP
نسخه‌ها را می‌توان با گزینهٔ \f[V]--b2-versions\f[R] مشاهده کرد.
هنگامی که این گزینه تعیین شده باشد، rclone نسخه‌های قدیمی‌تر فایل‌ها را نمایش داده و بر روی آن‌ها عمل می‌کند.
برای مثال:
.PP
فهرست کردن بدون \f[V]--b2-versions\f[R]
.IP
.nf
\f[C]
$ rclone -q ls b2:cleanup-test
        9 one.txt
\f[R]
.fi
.PP
و با این گزینه:
.IP
.nf
\f[C]
$ rclone -q --b2-versions ls b2:cleanup-test
        9 one.txt
        8 one-v2016-07-04-141032-000.txt
       16 one-v2016-07-04-141003-000.txt
       15 one-v2016-07-02-155621-000.txt
\f[R]
.fi
.PP
این خروجی نشان می‌دهد که نسخهٔ فعلی دست‌نخورده باقی مانده اما نسخه‌های قدیمی‌تر نیز قابل مشاهده هستند.
تاریخ UTC بارگذاری آن‌ها بر روی کارساز با دقت نزدیک‌ترین میلی‌ثانیه به انتهای نام آن‌ها ضمیمه شده است.
.PP
توجه داشته باشید که هنگام استفاده از \f[V]--b2-versions\f[R] هیچ‌گونه عملیات نوشتن فایل مجاز نیست، بنابراین نمی‌توانید فایل‌ها را بارگذاری یا حذف کنید..SS B2 و rclone link
.PP
برنامه Rclone از تولید پیوندهای اشتراک‌گذاری فایل برای مخزن‌های (bucket) خصوصی B2 پشتیبانی می‌کند.
این پیوندها می‌توانند برای مثال برای یک فایل باشند:
.IP
.nf
\f[C]
\&./rclone link B2:bucket/path/to/file.txt
https://f002.backblazeb2.com/file/bucket/path/to/file.txt?Authorization=xxxxxxxx
\f[R]
.fi
.PP
یا در صورت اجرا روی یک دایرکتوری، دریافت خواهید کرد:
.IP
.nf
\f[C]
\&./rclone link B2:bucket/path
https://f002.backblazeb2.com/file/bucket/path?Authorization=xxxxxxxx
\f[R]
.fi
.PP
سپس می‌توانید از توکن احراز هویت (بخشی از نشانی وب از \f[V]?Authorization=\f[R] به بعد) برای هر مسیر فایلی در آن دایرکتوری استفاده کنید.
برای مثال:
.IP
.nf
\f[C]
https://f002.backblazeb2.com/file/bucket/path/to/file1?Authorization=xxxxxxxx
https://f002.backblazeb2.com/file/bucket/path/file2?Authorization=xxxxxxxx
https://f002.backblazeb2.com/file/bucket/path/folder/file3?Authorization=xxxxxxxx
\f[R]
.fi
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد ویژه‌ی b2 (Backblaze B2) آورده شده است.
.SS --b2-account
.PP
شناسه حساب (Account ID) یا شناسه کلید برنامه (Application Key ID).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: account
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_ACCOUNT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: true
.SS --b2-key
.PP
کلید برنامه (Application Key).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: key
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: true
.SS --b2-hard-delete
.PP
حذف دائمی فایل‌ها هنگام حذف از ریموت، در غیر این صورت پنهان‌سازی فایل‌ها.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hard_delete
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_HARD_DELETE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته‌ی ویژه‌ی b2 (Backblaze B2) آورده شده است.
.SS --b2-endpoint
.PP
نقطه پایانی (Endpoint) برای سرویس.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_ENDPOINT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false.SS --b2-test-mode
.PP
یک رشته پرچم برای هدر X-Bz-Test-Mode جهت اشکال‌زدایی.
.PP
این گزینه صرفاً برای مقاصد اشکال‌زدایی است.
تنظیم آن روی یکی از رشته‌های زیر باعث می‌شود b2 خطاهای مشخصی را بازگرداند:
.IP \[bu] 2
\[dq]fail_some_uploads\[dq]
.IP \[bu] 2
\[dq]expire_some_account_authorization_tokens\[dq]
.IP \[bu] 2
\[dq]force_cap_exceeded\[dq]
.PP
این مقادیر در هدر \[dq]X-Bz-Test-Mode\[dq] تنظیم خواهند شد که در چک‌لیست یکپارچه‌سازی‌های b2 مستند شده است (https://www.backblaze.com/docs/cloud-storage-integration-checklist).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: test_mode
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_TEST_MODE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --b2-versions
.PP
شامل کردن نسخه‌های قدیمی در فهرست‌بندی‌های دایرکتوری.
.PP
توجه داشته باشید که هنگام استفاده از این گزینه، هیچ عملیات نوشتن روی فایل مجاز نیست، بنابراین نمی‌توانید فایل‌ها را بارگذاری کرده یا آن‌ها را حذف کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: versions
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_VERSIONS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --b2-version-at
.PP
نمایش نسخه‌های فایل به همان شکلی که در زمان مشخص‌شده وجود داشته‌اند.
.PP
توجه داشته باشید که هنگام استفاده از این گزینه، هیچ عملیات نوشتن روی فایل مجاز نیست، بنابراین نمی‌توانید فایل‌ها را بارگذاری کرده یا آن‌ها را حذف کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: version_at
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_VERSION_AT
.IP \[bu] 2
نوع: Time
.IP \[bu] 2
پیش‌فرض: off
.SS --b2-upload-cutoff
.PP
حد آستانه برای جابجایی به بارگذاری چندتکه‌ای (chunked upload).
.PP
فایل‌های بزرگ‌تر از این اندازه، در تکه‌هایی با اندازهٔ \[dq]--b2-chunk-size\[dq] بارگذاری خواهند شد.
.PP
این مقدار نباید بزرگ‌تر از 4.657 GiB (برابر با 5 GB) تنظیم شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 200Mi
.SS --b2-copy-cutoff
.PP
حد آستانه برای جابجایی به کپی چندبخشی (multipart copy).
.PP
هر فایلی بزرگ‌تر از این اندازه که نیاز به کپی سمت سرور داشته باشد، در تکه‌هایی با این اندازه کپی خواهد شد.
.PP
حداقل مقدار 0 و حداکثر آن 4.6 GiB است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: copy_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_COPY_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 4Gi.SS --b2-chunk-size
.PP
اندازه تکه‌های بارگذاری.
.PP
هنگام بارگذاری فایل‌های بزرگ، فایل را به این اندازه تکه‌تکه می‌کند.
.PP
باید در حافظه جای گیرد.
این تکه‌ها در حافظه بافر می‌شوند و ممکن است حداکثر به تعداد
\[dq]--transfers\[dq] تکه به‌طور هم‌زمان در حال بارگذاری باشند.
.PP
۵٬۰۰۰٬۰۰۰ بایت حداقل اندازه است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 96Mi
.SS --b2-upload-concurrency
.PP
هم‌زمانی برای بارگذاری‌های چندبخشی (multipart).
.PP
این تعداد تکه‌هایی از یک فایل یکسان است که به‌صورت هم‌زمان
بارگذاری می‌شوند.
.PP
توجه داشته باشید که تکه‌ها در حافظه ذخیره می‌شوند و ممکن است حداکثر تا
\[dq]--transfers\[dq] * \[dq]--b2-upload-concurrency\[dq] تکه به‌طور
هم‌زمان در حافظه نگه‌داری شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_UPLOAD_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 4
.SS --b2-disable-checksum
.PP
غیرفعال‌سازی چکسام برای فایل‌های بزرگ (بزرگ‌تر از آستانه upload cutoff).
.PP
به‌طور معمول rclone پیش از بارگذاری ورودی، چکسام SHA1 آن را محاسبه می‌کند
تا بتواند آن را به متادیتای شیء بیفزاید.
این کار برای بررسی صحت داده‌ها عالی است، اما می‌تواند باعث تاخیرهای طولانی
در شروع بارگذاری فایل‌های بزرگ شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_checksum
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_DISABLE_CHECKSUM
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --b2-download-url
.PP
اندپوینت (endpoint) سفارشی برای بارگیری‌ها.
.PP
این مقدار معمولاً روی نشانی اینترنتی CDN شرکت Cloudflare تنظیم می‌شود،
زیرا Backblaze برای داده‌های بارگیری‌شده از طریق شبکه Cloudflare، ترافیک
خروجی (egress) رایگان ارائه می‌دهد.
ابزار rclone با ارسال یک هدر \[dq]Authorization\[dq] با باکت‌های خصوصی کار می‌کند.
اگر اندپوینت سفارشی درخواست‌ها را برای احراز هویت بازنویسی می‌کند (برای مثال
در Cloudflare Workers)، این هدر باید به‌درستی مدیریت شود.
در صورتی که می‌خواهید از اندپوینت ارائه‌شده توسط Backblaze استفاده کنید، آن را خالی بگذارید.
.PP
نشانی اینترنتی (URL) ارائه‌شده در اینجا باید پروتکل را داشته باشد و نباید
اسلش پایانی داشته باشد یا زیرمسیر /file/bucket را مشخص کند، زیرا rclone
فایل‌ها را با \[dq]{download_url}/file/{bucket_name}/{path}\[dq] درخواست خواهد کرد.
.PP
مثال: > https://mysubdomain.mydomain.tld (بدون \[dq]/\[dq]،
\[dq]file\[dq] یا \[dq]bucket\[dq] در انتها)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: download_url
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_DOWNLOAD_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --b2-download-auth-duration
.PP
زمان پیش از منقضی شدن توکن احراز هویت پیوند عمومی بر حسب ثانیه یا با
پسوندهای ms|s|m|h|d.
.PP
این گزینه در ترکیب با \[dq]rclone link\[dq] جهت در دسترس قرار دادن فایل‌ها
برای عموم استفاده می‌شود و مدت‌زمان پیش از انقضای توکن مجوز
دانلود را تعیین می‌کند.
.PP
کمترین مقدار ۱ ثانیه است.
بیشترین مقدار یک هفته است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: download_auth_duration
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_DOWNLOAD_AUTH_DURATION
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 1w
.SS --b2-lifecycle
.PP
تعیین تعداد روزهایی که فایل‌های حذف‌شده هنگام ایجاد یک
باکت (bucket) باید نگهداری شوند.
.PP
هنگام ایجاد باکت، این پارامتر برای ایجاد یک قاعده چرخه حیات (lifecycle rule)
برای کل باکت به کار می‌رود.
.PP
اگر lifecycle برابر 0 (پیش‌فرض) باشد، هیچ قاعده چرخه‌حیاتی ایجاد نمی‌شود و
رفتار پیش‌فرض B2 اعمال می‌گردد.
این رفتار شامل نگهداری نسخه‌های فایل‌ها پس از حذف و بازنویسی (overwrite) به
مدت نامحدود است.
.PP
اگر lifecycle بزرگ‌تر از 0 باشد، یک قاعده تکی ایجاد می‌شود که تعداد
روزهای پیش از حذف دائمی یک فایلِ حذف‌شده یا بازنویسی‌شده را
تنظیم می‌کند.
این مورد در مستندات b2 با عنوان daysFromHidingToDeleting شناخته می‌شود.
.PP
کمترین مقدار برای این پارامتر ۱ روز است.
.PP
همچنین می‌توانید hard_delete را در پیکربندی فعال کنید که باعث می‌شود
حذف فایل‌ها نسخه‌ای ایجاد نکند، اما بازنویسی‌ها همچنان منجر به
ایجاد نسخه خواهند شد.
.PP
برای تنظیم چرخه‌های حیات پس از ایجاد باکت، rclone backend lifecycle را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: lifecycle
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_LIFECYCLE
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 0
.SS --b2-encoding
.PP
کدگذاری (encoding) برای backend.
.PP
برای اطلاعات بیشتر، بخش کدگذاری را در نمای کلی
(<https://rclone.org/overview/#encoding>) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot
.SS --b2-sse-customer-algorithm
.PP
در صورت استفاده از SSE-C، الگوریتم رمزگذاری سمت سرور که هنگام ذخیره
این شیء در B2 استفاده می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sse_customer_algorithm
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_SSE_CUSTOMER_ALGORITHM
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام
.RE
.IP \[bu] 2
\[dq]AES256\[dq]
.RS 2
.IP \[bu] 2
استاندارد رمزگذاری پیشرفته (طول کلید ۲۵۶ بیت)
.RE
.RE.SS --b2-sse-customer-key
.PP
برای استفاده از SSE-C، می‌توانید کلید رمزگذاری محرمانه را در قالب یک رشته سازگار با UTF-8 جهت رمزگذاری/رمزگشایی داده‌های خود ارائه دهید.
.PP
همچنین می‌توانید به جای آن از \-\-sse\-customer\-key\-base64 استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sse_customer_key
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_SSE_CUSTOMER_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام
.RE
.RE
.SS --b2-sse-customer-key-base64
.PP
برای استفاده از SSE-C، می‌توانید کلید رمزگذاری محرمانه را با فرمت Base64 جهت رمزگذاری/رمزگشایی داده‌های خود ارائه دهید.
.PP
همچنین می‌توانید به جای آن از \-\-sse\-customer\-key استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sse_customer_key_base64
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_SSE_CUSTOMER_KEY_BASE64
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام
.RE
.RE
.SS --b2-sse-customer-key-md5
.PP
در صورت استفاده از SSE-C، می‌توانید چک‌سام MD5 کلید رمزگذاری محرمانه را ارائه دهید (اختیاری).
.PP
اگر آن را خالی بگذارید، به‌طور خودکار از روی sse_customer_key ارائه‌شده محاسبه می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sse_customer_key_md5
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_SSE_CUSTOMER_KEY_MD5
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام
.RE
.RE
.SS --b2-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_B2_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر.SS دستورهای بک‌اند (Backend)
.PP
در اینجا دستورهای مختص بک‌اند b2 آورده شده‌اند.
.PP
اجرای آن‌ها با دستور زیر انجام می‌شود:
.IP
.nf
\f[C]
rclone backend COMMAND remote:
\f[R]
.fi
.PP
راهنمای زیر توضیح خواهد داد که هر دستور چه آرگومان‌هایی می‌پذیرد.
.PP
برای اطلاعات بیشتر در مورد نحوه ارسال گزینه‌ها و آرگومان‌ها، دستور backend (<https://rclone.org/commands/rclone_backend>) را ببینید.
.PP
این موارد را می‌توان روی یک بک‌اندِ در حال اجرا با استفاده از دستور rc به شکل backend/command (<https://rclone.org/rc/#backend-command>) اجرا کرد.
.SS lifecycle
.PP
خواندن یا تنظیم چرخه حیات (lifecycle) برای یک باکت (bucket).
.IP
.nf
\f[C]
rclone backend lifecycle remote: [options] [<arguments>+]
\f[R]
.fi
.PP
از این دستور می‌توان برای خواندن یا تنظیم چرخه حیات یک باکت استفاده کرد.
.PP
برای نمایش قواعد فعلی چرخه حیات:
.IP
.nf
\f[C]
rclone backend lifecycle b2:bucket
\f[R]
.fi
.PP
این دستور خروجی‌ای شبیه به زیر را نمایش می‌دهد که بیانگر قواعد چرخه حیات است.
.IP
.nf
\f[C]
[
    {
        \[dq]daysFromHidingToDeleting\[dq]: 1,
        \[dq]daysFromUploadingToHiding\[dq]: null,
        \[dq]daysFromStartingToCancelingUnfinishedLargeFiles\[dq]: null,
        \[dq]fileNamePrefix\[dq]: \[dq]\[dq]
    }
]
\f[R]
.fi
.PP
اگر هیچ قاعده چرخه حیاتی وجود نداشته باشد (حالت پیش‌فرض)، صرفاً \f[V][]\f[R] برگردانده می‌شود.
.PP
برای تنظیم مجدد قواعد فعلی چرخه حیات:
.IP
.nf
\f[C]
rclone backend lifecycle b2:bucket -o daysFromHidingToDeleting=30
rclone backend lifecycle b2:bucket -o daysFromUploadingToHiding=5 -o daysFromHidingToDeleting=1
\f[R]
.fi
.PP
این دستور اجرا خواهد شد و سپس قواعد جدید چرخه حیات را مانند بالا چاپ می‌کند.
.PP
ابزار Rclone تنها اجازه می‌دهد چرخه‌های حیات را برای کل باکت با \[dq]\[dq] = fileNamePrefix تنظیم کنید.
.PP
شما نمی‌توانید نسخه‌بندی را در B2 غیرفعال کنید.
بهترین کاری که می‌توانید انجام دهید، تنظیم daysFromHidingToDeleting روی ۱ روز است.
همچنین می‌توانید hard_delete را در پیکربندی فعال کنید که به این معنی خواهد بود که حذف‌ها باعث ایجاد نسخه جدید نمی‌شوند، اما رونویسی‌ها همچنان باعث ایجاد نسخه‌های جدید خواهند شد.
.IP
.nf
\f[C]
rclone backend lifecycle b2:bucket -o daysFromHidingToDeleting=1
\f[R]
.fi
.PP
ببینید: <https://www.backblaze.com/docs/cloud-storage-lifecycle-rules>
.PP
گزینه‌ها:
.IP \[bu] 2
\[dq]daysFromHidingToDeleting\[dq]: پس از اینکه یک فایل برای این تعداد روز مخفی ماند، حذف می‌شود.
مقدار 0 به معنای خاموش بودن است.
.IP \[bu] 2
\[dq]daysFromStartingToCancelingUnfinishedLargeFiles\[dq]: هرگونه نسخه ناتمام از فایل‌های بزرگ را پس از این تعداد روز لغو می‌کند.
.IP \[bu] 2
\[dq]daysFromUploadingToHiding\[dq]: پس از گذشت این تعداد روز از بارگذاری، فایل مخفی می‌شود..SS cleanup
.PP
حذف بارگذاری‌های ناتمام فایل‌های حجیم.
.IP
.nf
\f[C]
rclone backend cleanup remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور بارگذاری‌های ناتمام فایل‌های حجیمی را که عمر آن‌ها بیشتر از max-age است (با مقدار پیش‌فرض ۲۴ ساعت)، حذف می‌کند.
.PP
توجه داشته باشید که می‌توانید از --interactive/-i یا --dry-run همراه با این دستور استفاده کنید تا ببینید چه عملیاتی انجام خواهد شد.
.IP
.nf
\f[C]
rclone backend cleanup b2:bucket/path/to/object
rclone backend cleanup -o max-age=7w b2:bucket/path/to/object
\f[R]
.fi
.PP
مدت‌زمان‌ها مطابق با سایر بخش‌های rclone تجزیه می‌شوند؛ مانند 2h، 7d، 7w و غیره.
.PP
گزینه‌ها:
.IP \[bu] 2
\[dq]max-age\[dq]: حداکثر عمر بارگذاری جهت حذف.
.SS cleanup-hidden
.PP
حذف نسخه‌های قدیمی فایل‌ها.
.IP
.nf
\f[C]
rclone backend cleanup-hidden remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور هرگونه نسخه پنهان و قدیمی فایل‌ها را حذف می‌کند.
.PP
توجه داشته باشید که می‌توانید از --interactive/-i یا --dry-run همراه با این دستور استفاده کنید تا ببینید چه عملیاتی انجام خواهد شد.
.IP
.nf
\f[C]
rclone backend cleanup-hidden b2:bucket/path/to/dir
\f[R]
.fi
.SS "محدودیت‌ها (Limitations)"
.PP
دستور \f[V]rclone about\f[R] توسط بک‌اند B2 پشتیبانی نمی‌شود.
بک‌اندهایی که این قابلیت را ندارند، نمی‌توانند فضای خالی را برای یک rclone mount مشخص کنند یا از سیاست \f[V]mfs\f[R] (بیشترین فضای خالی) به‌عنوان عضوی از یک ریموت union در rclone استفاده نمایند.
.PP
فهرست بک‌اندهایی که از rclone about پشتیبانی نمی‌کنند را در (https://rclone.org/overview/#optional-features) و مستندات rclone about را در (https://rclone.org/commands/rclone_about) ببینید.
.SH Box
.PP
مسیرها به‌صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند تا هر عمقی که نیاز است باشند، مانند:
\f[V]remote:directory/subdirectory\f[R].
.PP
راه‌اندازی اولیه برای Box مستلزم دریافت یک توکن از Box است که می‌توانید آن را از طریق مرورگر خود، یا با یک فایل config.json دانلودشده از Box برای احراز هویت JWT انجام دهید.
دستور \f[V]rclone config\f[R] شما را مرحله‌به‌مرحله راهنمایی می‌کند.
.SS "پیکربندی (Configuration)"
.PP
در اینجا مثالی از نحوه ساخت یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این کار شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Box
   \[rs] \[dq]box\[dq]
[snip]
Storage> box
Box App Client Id - leave blank normally.
client_id> 
Box App Client Secret - leave blank normally.
client_secret>
Box App config.json location
Leave blank normally.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
box_config_file>
Box App Primary Access Token
Leave blank normally.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
access_token>

Enter a string value. Press Enter for the default (\[dq]user\[dq]).
Choose a number from below, or type in your own value
 1 / Rclone should act on behalf of a user
   \[rs] \[dq]user\[dq]
 2 / Rclone should act on behalf of a service account
   \[rs] \[dq]enterprise\[dq]
box_sub_type>
Remote config
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y) Yes
n) No
y/n> y
If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth?state=XXXXXXXXXXXXXXXXXXXXXX
Log in and authorize rclone for access
Waiting for code...
Got code
Configuration complete.
Options:
- type: box
- client_id:
- client_secret:
- token: {\[dq]access_token\[dq]:\[dq]XXX\[dq],\[dq]token_type\[dq]:\[dq]bearer\[dq],\[dq]refresh_token\[dq]:\[dq]XXX\[dq],\[dq]expiry\[dq]:\[dq]XXX\[dq]}
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
برای نحوه راه‌اندازی بر روی سیستمی که مرورگر وب متصل به اینترنت ندارد، مستندات راه‌اندازی ریموت را در (https://rclone.org/remote_setup) ببینید.
.PP
توجه داشته باشید که rclone یک وب‌سرور را روی سیستم محلی شما اجرا می‌کند تا توکن بازگردانده‌شده از Box را دریافت کند.
این سرویس تنها از لحظه باز شدن مرورگر تا زمان دریافت کد تأیید اجرا می‌شود.
این وب‌سرور روی \f[V]http://127.0.0.1:53682\f[R] اجرا می‌شود و اگر از فایروال میزبان استفاده می‌کنید، ممکن است لازم باشد آن را موقتاً باز کنید.
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (به‌جای \f[V]remote\f[R] نامی را که به ریموت خود اختصاص داده‌اید قرار دهید):
.PP
فهرست کردن دایرکتوری‌های سطح بالای Box شما:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌های موجود در Box شما:
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به یک دایرکتوری در Box به نام backup:
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS استفاده از rclone با حساب سازمانی (Enterprise) دارای SSO
.PP
اگر نوع حساب شما در Box از نوع سازمانی (\[dq]Enterprise\[dq]) همراه با ورود یکپارچه (SSO) است، برای استفاده از Box با rclone باید یک گذرواژه بسازید.
این کار در حساب سازمانی Box شما با رفتن به تنظیمات (Settings)، برگهٔ \[dq]Account\[dq] و سپس تعیین گذرواژه در فیلد \[dq]Authentication\[dq] امکان‌پذیر است.
.PP
پس از انجام این کار، می‌توانید حساب سازمانی Box خود را طبق همان روندی که پیش‌تر شرح داده شد و با استفاده از گذرواژه‌ای که به‌تازگی تنظیم کرده‌اید، راه‌اندازی کنید.
.SS توکن نوسازی نامعتبر (Invalid refresh token)
.PP
طبق مستندات Box
(https://developer.box.com/v2.0/docs/oauth-20#section-6-using-the-access-and-refresh-tokens):
.RS
.PP
هر refresh_token تنها برای یک بار استفاده در طول ۶۰ روز معتبر است.
.RE
.PP
این بدان معناست که اگر:
.IP \[bu] 2
به مدت ۶۰ روز از ریموت Box استفاده نکنید
.IP \[bu] 2
فایل پیکربندی حاوی refresh token مربوط به Box را کپی کرده و در دو مکان مختلف استفاده نمایید
.IP \[bu] 2
هنگام نوسازی توکن با خطا مواجه شوید
.PP
آن‌گاه rclone خطایی برمی‌گرداند که شامل متن
\f[V]Invalid refresh token\f[R]
خواهد بود.
.PP
برای برطرف کردن این مشکل، باید دوباره از oauth2 برای به‌روزرسانی refresh token استفاده کنید.
می‌توانید از روش‌های شرح‌داده‌شده در مستندات راه‌اندازی ریموت
(https://rclone.org/remote_setup)
استفاده نمایید؛ با در نظر داشتن این نکته که اگر از روش کپی کردن فایل پیکربندی استفاده می‌کنید، نباید از آن ریموت روی رایانه‌ای که احراز هویت را در آن انجام داده‌اید استفاده کنید.
.PP
نحوهٔ انجام این کار در ادامه آمده است:
.IP
.nf
\f[C]
$ rclone config
Current remotes:

Name                 Type
====                 ====
remote               box

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> e
Choose a number from below, or type in an existing value
 1 > remote
remote> remote
Configuration complete.
Options:
- type: box
- token: {\[dq]access_token\[dq]:\[dq]XXX\[dq],\[dq]token_type\[dq]:\[dq]bearer\[dq],\[dq]refresh_token\[dq]:\[dq]XXX\[dq],\[dq]expiry\[dq]:\[dq]2017-07-08T23:40:08.059167677+01:00\[dq]}
Keep this \[dq]remote\[dq] remote?
Edit remote
Value \[dq]client_id\[dq] = \[dq]\[dq]
Edit? (y/n)>
y) Yes
n) No
y/n> n
Value \[dq]client_secret\[dq] = \[dq]\[dq]
Edit? (y/n)>
y) Yes
n) No
y/n> n
Remote config
Token already configured - replace it?
y) Yes
n) No
y/n> y
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y) Yes
n) No
y/n> y
If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth
Log in and authorize rclone for access
Waiting for code...
Got code
Configuration complete.
Options:
- type: box
- token: {\[dq]access_token\[dq]:\[dq]YYY\[dq],\[dq]token_type\[dq]:\[dq]bearer\[dq],\[dq]refresh_token\[dq]:\[dq]YYY\[dq],\[dq]expiry\[dq]:\[dq]2017-07-23T12:22:29.259137901+01:00\[dq]}
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها
.PP
سرویس Box اجازه می‌دهد زمان‌های تغییر روی اشیاء با دقت ۱ ثانیه تنظیم شوند.
این زمان‌ها برای تشخیص این‌که آیا اشیاء نیاز به همگام‌سازی دارند یا خیر استفاده خواهند شد.
.PP
سرویس Box از هش‌های نوع SHA1 پشتیبانی می‌کند، بنابراین می‌توانید از پرچم
\f[V]--checksum\f[R] استفاده کنید.
.SS نویسه‌های محدودشده در نام فایل
.PP
علاوه بر مجموعه نویسه‌های محدودشده پیش‌فرض
(https://rclone.org/overview/#restricted-characters)، نویسه‌های
زیر نیز جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
.TE
.PP
نام‌های فایل همچنین نمی‌توانند با نویسه‌های زیر خاتمه یابند.
این نویسه‌ها تنها در صورتی جایگزین می‌شوند که آخرین نویسه در نام باشند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
SP
T}@T{
0x20
T}@T{
␠
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند
شد (https://rclone.org/overview/#invalid-utf8)، زیرا نمی‌توان
از آن‌ها در رشته‌های JSON استفاده کرد.
.SS انتقال‌ها
.PP
برای فایل‌های بزرگ‌تر از 50 MiB، ابزار rclone از انتقال تکه‌تکه استفاده خواهد کرد.
ابزار rclone حداکثر تا \f[V]--transfers\f[R] تکه را به طور هم‌زمان بارگذاری می‌کند
(مشترک بین تمام بارگذاری‌های چندبخشی).
تکه‌ها در حافظه بافر می‌شوند و معمولاً 8 MiB هستند، بنابراین افزایش
\f[V]--transfers\f[R] مصرف حافظه را افزایش خواهد داد.
.SS حذف فایل‌ها
.PP
بسته به تنظیمات سازمانی مربوط به کاربر شما، مورد یا واقعاً از Box حذف
می‌شود و یا به سطل زباله منتقل می‌گردد.
.PP
تخلیه سطل زباله از طریق دستور cleanup در rclone پشتیبانی می‌شود، با این حال
این دستور هر فایل و پوشه حذف‌شده را به صورت جداگانه پاک می‌کند، بنابراین
ممکن است زمان بسیار زیادی طول بکشد.
تخلیه سطل زباله از طریق WebUI این محدودیت را ندارد، بنابراین توصیه
می‌شود سطل زباله را از طریق WebUI خالی کنید.
.SS شناسه پوشه ریشه
.PP
می‌توانید \f[V]root_folder_id\f[R] را برای rclone تنظیم کنید.
این پوشه‌ای است (که با \f[V]Folder ID\f[R] آن شناسایی می‌شود) که
rclone آن را به عنوان ریشه درایو Box شما در نظر می‌گیرد.
.PP
به طور معمول این مقدار را خالی می‌گذارید و خود rclone ریشه صحیح را برای
استفاده تعیین خواهد کرد.
.PP
با این حال می‌توانید این مقدار را برای محدود کردن rclone به یک سلسله‌مراتب
پوشه خاص تنظیم کنید.
.PP
برای انجام این کار باید \f[V]Folder ID\f[R] پوشه‌ای را که می‌خواهید rclone
نمایش دهد پیدا کنید.
این شناسه، آخرین بخش نشانی اینترنتی هنگامی خواهد بود که پوشه مربوطه را
در رابط تحت وب Box باز می‌کنید.
.PP
بنابراین اگر پوشه‌ای که می‌خواهید rclone استفاده کند نشانی وبی شبیه به
\f[V]https://app.box.com/folder/11xxxxxxxxx8\f[R] در مرورگر دارد، آن‌گاه
از \f[V]11xxxxxxxxx8\f[R] به عنوان \f[V]root_folder_id\f[R] در
پیکربندی استفاده کنید..SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص box (Box) آورده شده است.
.SS --box-client-id
.PP
شناسه کلاینت OAuth (OAuth Client Id).
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --box-client-secret
.PP
کلید محرمانه کلاینت OAuth (OAuth Client Secret).
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --box-box-config-file
.PP
مکان فایل config.json برای Box App
.PP
در حالت عادی خالی بگذارید.
.PP
علامت \f[V]\[ti]\f[R] در ابتدای نام فایل و همچنین متغیرهای محیطی نظیر \f[V]${RCLONE_CONFIG_DIR}\f[R] بسط داده خواهند شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: box_config_file
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_BOX_CONFIG_FILE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --box-access-token
.PP
توکن دسترسی اصلی Box App
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: access_token
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_ACCESS_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --box-box-sub-type
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: box_sub_type
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_BOX_SUB_TYPE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]user\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]user\[dq]
.RS 2
.IP \[bu] 2
Rclone باید از طرف یک کاربر عمل کند.
.RE
.IP \[bu] 2
\[dq]enterprise\[dq]
.RS 2
.IP \[bu] 2
Rclone باید از طرف یک حساب خدماتی (Service Account) عمل کند.
.RE
.RE.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته ویژه box (Box) آورده شده است.
.SS --box-token
.PP
توکن دسترسی OAuth به‌صورت یک داده JSON (JSON blob).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --box-auth-url
.PP
نشانی URL سرور احراز هویت (Auth).
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، این فیلد را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --box-token-url
.PP
نشانی URL سرور توکن.
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، این فیلد را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --box-client-credentials
.PP
استفاده از جریان احراز هویت Client Credentials در OAuth.
.PP
این گزینه از جریان Client Credentials در OAUTH2 همان‌طور که در RFC 6749 شرح داده شده است استفاده می‌کند.
.PP
توجه داشته باشید که این گزینه توسط همه بک‌اندها (backends) پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --box-root-folder-id
.PP
این گزینه را پر کنید تا rclone از پوشه‌ای غیر از ریشه به‌عنوان نقطه آغاز خود استفاده کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_folder_id
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_ROOT_FOLDER_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]0\[dq]
.SS --box-upload-cutoff
.PP
آستانه تغییر به بارگذاری چندبخشی (multipart upload) (>= 50 MiB).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 50Mi.SS --box-commit-retries
.PP
حداکثر دفعات تلاش برای ثبت نهایی (commit) یک فایل چندبخشی (multipart).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: commit_retries
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_COMMIT_RETRIES
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 100
.SS --box-list-chunk
.PP
اندازه تکه‌های فهرست‌بندی (chunk) بین ۱ تا ۱۰۰۰.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_chunk
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_LIST_CHUNK
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 1000
.SS --box-owned-by
.PP
فقط نمایش مواردی که متعلق به حساب کاربری (نشانی ایمیل) مشخص‌شده هستند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: owned_by
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_OWNED_BY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --box-impersonate
.PP
جعل هویت (impersonate) این شناسه کاربری هنگام استفاده از یک حساب خدماتی (service account).
.PP
تنظیم این گزینه به rclone اجازه می‌دهد تا هنگام استفاده از یک حساب خدماتی JWT، با مقداردهی سرایند as-user از جانب کاربر دیگری عمل کند.
.PP
شناسه کاربری، همان شناسه یک کاربر در Box است.
شناسه‌های کاربری را می‌توان برای هر کاربری از طریق نقطه پایانی (endpoint) GET /users، که فقط در دسترس مدیران (admins) است، یا با فراخوانی GET /users/me همراه با یک نشست کاربری احرازهویت‌شده به دست آورد.
.PP
ببینید: https://developer.box.com/guides/authentication/jwt/as-user
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: impersonate
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_IMPERSONATE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --box-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر بخش کدگذاری در نمای کلی (https://rclone.org/overview/#encoding) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,BackSlash,Del,Ctl,RightSpace,InvalidUtf8,Dot
.SS --box-description
.PP
توضیحات remote.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_BOX_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS "محدودیت‌ها (Limitations)"
.PP
توجه داشته باشید که Box به بزرگی و کوچکی حروف حساس نیست (case-insensitive)، بنابراین نمی‌توانید هم‌زمان فایلی به نام
\[dq]Hello.doc\[dq] و فایلی به نام \[dq]hello.doc\[dq] داشته باشید.
.PP
نام‌های فایل در Box نمی‌توانند شامل نویسه \f[V]\[rs]\f[R] باشند.
ابزار rclone این نویسه را به معادل یونی‌کد با ظاهری یکسان یعنی
\f[V]＼\f[R] (U+FF3C Fullwidth Reverse Solidus) و برعکس نگاشت می‌کند.
.PP
سرویس Box تنها از نام‌های فایل با حداکثر طول ۲۵۵ نویسه پشتیبانی می‌کند.
.PP
سرویس Box دارای محدودیت‌های نرخ فراخوانی API
(https://developer.box.com/guides/api-calls/permissions-and-errors/rate-limits)
است که گاهی اوقات سرعت rclone را کاهش می‌دهد.
.PP
دستور \f[V]rclone about\f[R] توسط بک‌اند Box پشتیبانی نمی‌شود.
بک‌اندهایی که فاقد این قابلیت هستند نمی‌توانند فضای خالی را برای یک
\f[V]rclone mount\f[R] تعیین کنند یا از سیاست \f[V]mfs\f[R] (بیشترین فضای خالی - most free space) به عنوان عضوی
از یک ریموت union در rclone استفاده نمایند.
.PP
فهرست بک‌اندهایی که از rclone about پشتیبانی نمی‌کنند را در
(https://rclone.org/overview/#optional-features) و
rclone about را در (https://rclone.org/commands/rclone_about) ببینید.
.SS "دریافت شناسه برنامه اختصاصی Box (Get your own Box App ID)"
.PP
نحوه ایجاد App ID اختصاصی Box برای rclone به شرح زیر است:
.IP "1." 3
به Box Developer Console (https://app.box.com/developers/console)
رفته و وارد حساب کاربری خود شوید، سپس روی \f[V]My Apps\f[R] در نوار کناری کلیک کنید.
روی \f[V]Create New App\f[R] کلیک کرده و \f[V]Custom App\f[R] را انتخاب نمایید.
.IP "2." 3
در نخستین صفحه از کادر بازشده، می‌توانید تقریباً هر مقداری که مایلید وارد کنید.
مقدار \f[V]App Name\f[R] می‌تواند دلخواه باشد.
برای \f[V]Purpose\f[R] گزینه automation را انتخاب کنید تا از پر کردن موارد دیگر
بی‌نیاز شوید.
روی \f[V]Next\f[R] کلیک کنید.
.IP "3." 3
در صفحه دوم از فرآیند ساخت، گزینه
\f[V]User Authentication (OAuth 2.0)\f[R] را انتخاب نمایید.
سپس روی \f[V]Create App\f[R] کلیک کنید.
.IP "4." 3
اکنون باید در زبانه \f[V]Configuration\f[R] برنامه جدید خود باشید.
اگر نیستید، در بالای صفحه وب روی آن کلیک کنید.
مقادیر \f[V]Client ID\f[R] و \f[V]Client Secret\f[R] را کپی و یادداشت نمایید، چرا که برای
rclone به آن‌ها نیاز خواهید داشت.
.IP "5." 3
در زیر بخش \[dq]OAuth 2.0 Redirect URI\[dq]، نشانی
\f[V]http://127.0.0.1:53682\f[R] را اضافه کنید.
.IP "6." 3
برای \f[V]Application Scopes\f[R]، گزینه‌های
\f[V]Read all files and folders stored in Box\f[R] و
\f[V]Write all files and folders stored in box\f[R] را انتخاب کنید (با فرض این‌که
می‌خواهید هر دو کار را انجام دهید).
سایر گزینه‌ها را علامت‌نخورده باقی بگذارید.
در بالا سمت راست روی \f[V]Save Changes\f[R] کلیک کنید.
.SH "حافظه پنهان (Cache)"
.PP
ریموت \f[V]cache\f[R] یک ریموت موجود دیگر را در بر می‌گیرد و ساختار فایل
و داده‌های آن را برای کارهای طولانی‌مدت مانند
\f[V]rclone mount\f[R] ذخیره می‌کند.
.PP
این قابلیت \f[B]منسوخ شده (deprecated)\f[R] است، بنابراین استفاده از آن در
نصب‌های جدید توصیه نمی‌شود و ممکن است در آینده حذف گردد.
.SS "وضعیت (Status)"
.PP
کد بک‌اند cache در حال حاضر کار می‌کند اما نگه‌دارنده‌ای ندارد، بنابراین باگ‌های
حل‌نشده‌ای دارد (https://github.com/rclone/rclone/issues?q=is%3Aopen+is%3Aissue+label%3Abug+label%3A%22Remote%3A+Cache%22)
که برطرف نمی‌شوند.
.PP
بک‌اند cache در نهایت قرار است به نفع لایه کش VFS که سازگاری و یکپارچگی عمیق‌تری با rclone دارد، به مرور کنار گذاشته شود.
.PP
تا زمانی که این اتفاق بیفتد، توصیه می‌کنیم تنها در صورتی از بک‌اند cache استفاده کنید که
ببینید بدون آن قادر به کار نیستید.
مستندات آنلاین متعددی وجود دارند که استفاده از بک‌اند cache را برای
به حداقل رساندن درخواست‌های API شرح می‌دهند؛ اما در مجموع این آموزش‌ها قدیمی هستند
و بک‌اند cache دیگر در آن سناریوها مورد نیاز نیست.
.SS "پیکربندی (Configuration)"
.PP
برای شروع تنها کافی است یک ریموت از پیش تعریف‌شده داشته باشید که بتواند با
\f[V]cache\f[R] پیکربندی شود.
.PP
در ادامه مثالی از نحوه ایجاد ریموتی با نام \f[V]test-cache\f[R] آمده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرآیند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
n/r/c/s/q> n
name> test-cache
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Cache a remote
   \[rs] \[dq]cache\[dq]
[snip]
Storage> cache
Remote to cache.
Normally should contain a \[aq]:\[aq] and a path, e.g. \[dq]myremote:path/to/dir\[dq],
\[dq]myremote:bucket\[dq] or maybe \[dq]myremote:\[dq] (not recommended).
remote> local:/test
Optional: The URL of the Plex server
plex_url> http://127.0.0.1:32400
Optional: The username of the Plex user
plex_username> dummyusername
Optional: The password of the Plex user
y) Yes type in my own password
g) Generate random password
n) No leave this optional password blank
y/g/n> y
Enter the password:
password:
Confirm the password:
password:
The size of a chunk. Lower value good for slow connections but can affect seamless reading.
Default: 5M
Choose a number from below, or type in your own value
 1 / 1 MiB
   \[rs] \[dq]1M\[dq]
 2 / 5 MiB
   \[rs] \[dq]5M\[dq]
 3 / 10 MiB
   \[rs] \[dq]10M\[dq]
chunk_size> 2
How much time should object info (file size, file hashes, etc.) be stored in cache. Use a very high value if you don\[aq]t plan on changing the source FS from outside the cache.
Accepted units are: \[dq]s\[dq], \[dq]m\[dq], \[dq]h\[dq].
Default: 5m
Choose a number from below, or type in your own value
 1 / 1 hour
   \[rs] \[dq]1h\[dq]
 2 / 24 hours
   \[rs] \[dq]24h\[dq]
 3 / 24 hours
   \[rs] \[dq]48h\[dq]
info_age> 2
The maximum size of stored chunks. When the storage grows beyond this size, the oldest chunks will be deleted.
Default: 10G
Choose a number from below, or type in your own value
 1 / 500 MiB
   \[rs] \[dq]500M\[dq]
 2 / 1 GiB
   \[rs] \[dq]1G\[dq]
 3 / 10 GiB
   \[rs] \[dq]10G\[dq]
chunk_total_size> 3
Remote config
--------------------
[test-cache]
remote = local:/test
plex_url = http://127.0.0.1:32400
plex_username = dummyusername
plex_password = *** ENCRYPTED ***
chunk_size = 5M
info_age = 48h
chunk_total_size = 10G
\f[R]
.fi
.PP
سپس می‌توانید مانند زیر از آن استفاده کنید،
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح درایو:
.IP
.nf
\f[C]
rclone lsd test-cache:
\f[R]
.fi.PP
فهرست کردن تمام فایل‌های موجود در درایو شما
.IP
.nf
\f[C]
rclone ls test-cache:
\f[R]
.fi
.PP
برای راه‌اندازی یک اتصال (mount) دارای حافظهٔ موقت (کَش)
.IP
.nf
\f[C]
rclone mount --allow-other test-cache: /var/tmp/test-cache
\f[R]
.fi
.SS قابلیت‌های نوشتن
.SS بارگذاری برون‌خط (Offline uploading)
.PP
در راستای تلاش برای قابل‌اطمینان‌تر کردن نوشتن از طریق حافظهٔ موقت، پشتیبان (backend)
اکنون از این ویژگی پشتیبانی می‌کند که می‌توان آن را با مشخص کردن یک
\f[V]cache-tmp-upload-path\f[R] فعال کرد.
.PP
یک فایل هنگام استفاده از این ویژگی این وضعیت‌ها را طی می‌کند:
.IP "1." 3
یک بارگذاری آغاز می‌شود (معمولاً با کپی کردن یک فایل روی ریموت کش)
.IP "2." 3
هنگامی که کپی به مکان موقت تکمیل شد، فایل بخشی از ریموت کش‌شده
محسوب شده و مانند هر فایل دیگری به نظر رسیده و رفتار می‌کند (شامل خواندن
نیز می‌شود)
.IP "3." 3
پس از سپری شدن \f[V]cache-tmp-wait-time\f[R] و رسیدن نوبت فایل،
از \f[V]rclone move\f[R] برای انتقال فایل به ارائه‌دهندهٔ ابری استفاده می‌شود
.IP "4." 3
خواندن فایل در حین بارگذاری همچنان امکان‌پذیر است، اما بیشتر تغییرات روی
آن ممنوع خواهد بود
.IP "5." 3
پس از اتمام انتقال، قفل فایل برای اعمال تغییرات باز می‌شود زیرا مانند هر
فایل عادی دیگری خواهد شد
.IP "6." 3
اگر فایل در حین خوانده شدن از طریق \f[V]cache\f[R]، از مسیر موقت
حذف شود، آنگاه \f[V]cache\f[R] به سادگی منبع را به ارائه‌دهندهٔ ابری جابه‌جا
می‌کند بدون آنکه وقفه‌ای در خواندن رخ دهد (هرچند ممکن است لغزش کوتاهی ایجاد شود)
.PP
فایل‌ها به صورت متوالی بارگذاری می‌شوند و در هر لحظه تنها یک فایل بارگذاری خواهد شد.
بارگذاری‌ها در یک صف ذخیره شده و بر اساس ترتیب افزوده شدن پردازش خواهند شد.
صف و فضای ذخیره‌سازی موقت در طول راه‌اندازی‌های مجدد پایدار می‌مانند، اما
می‌توان در هنگام راه‌اندازی با پرچم \f[V]--cache-db-purge\f[R] آن‌ها را پاک‌سازی کرد.
.SS پشتیبانی از نوشتن
.PP
عملیات نوشتن از طریق \f[V]cache\f[R] پشتیبانی می‌شود.
یک نکتهٔ مهم این است که یک ریموت کشِ متصل‌شده (mounted)، هیچ سازوکار تلاش مجدد
یا بازگشتی (fallback) به عملیات بارگذاری اضافه نمی‌کند.
این موضوع به پیاده‌سازی ریموتِ پوشش‌داده‌شده (wrapped remote) بستگی خواهد داشت.
برای نوشتن‌های مطمئن، استفاده از \f[V]Offline uploading\f[R] را در نظر بگیرید.
.PP
یک حالت خاص با \f[V]cache-writes\f[R] پوشش داده شده است که در صورت فعال بودن،
داده‌های فایل را هم‌زمان با بارگذاری کَش می‌کند و باعث می‌شود بلافاصله پس از
اتمام بارگذاری، فایل از طریق حافظهٔ ذخیره‌سازی کش در دسترس باشد.
.SS قابلیت‌های خواندن
.SS اتصالات چندگانه
.PP
برای خنثی کردن تأخیر بالای شبکه میان رایانه محلی که rclone روی آن اجرا می‌شود
و ارائه‌دهندگان ابری، ریموت کش می‌تواند درخواست‌های متعدد را برای تکه‌های کوچک‌تر
فایل به ارائه‌دهندهٔ ابری ارسال کرده و آن‌ها را به صورت محلی ادغام کند؛ جایی که
تقریباً بلافاصله، پیش از آن‌که برنامه‌خواننده به آن‌ها نیاز داشته باشد، در دسترس خواهند بود.
.PP
این عملکرد مشابه بافرینگ (buffering) هنگام پخش آنلاین فایل‌های رسانه‌ای است.
Rclone در اطراف نشانگر فعلی باقی می‌ماند اما همواره نهایت تلاش خود را می‌کند
تا جلوتر پیش برود و داده‌ها را از قبل آماده کند.
.SS یکپارچه‌سازی با Plex
.PP
یکپارچه‌سازی مستقیمی با Plex وجود دارد که به حافظهٔ موقت امکان می‌دهد هنگام خواندن
فایل تشخیص دهد آیا فایل در حال پخش است یا خیر.
این امر به کَش کمک می‌کند تا نحوهٔ پرس‌وجو از ارائه‌دهندهٔ ابری را بسته به اینکه برای
چه کاری نیاز است تطبیق دهد.
.PP
پویش‌ها (Scans) حداقل تعداد پردازشگرها (workers) یعنی (۱) را خواهند داشت،
در حالی که در صورت پخش تأییدشده، کَش تعداد پردازشگرهای پیکربندی‌شده را به کار می‌گیرد.
.PP
این یکپارچه‌سازی زمینه را برای بهبودهای کارایی بیشتر باز می‌کند که در آینده
نزدیک مورد بررسی قرار خواهند گرفت.
.PP
\f[B]نکته:\f[R] در صورتی که گزینه‌های Plex پیکربندی نشوند، \f[V]cache\f[R]
با گزینه‌های پیکربندی‌شدهٔ خود و بدون تغییر در هیچ‌یک از تنظیماتش عمل خواهد کرد.
.PP
نحوهٔ فعال‌سازی:
دستور \f[V]rclone config\f[R] را اجرا کرده و تمامی گزینه‌های مربوط به Plex
(نقطه پایانی (endpoint)، نام کاربری و گذرواژه) را در ریموت خود مشخص کنید
تا به صورت خودکار فعال شود.
.PP
تنظیمات تحت تأثیر:
.IP \[bu] 2
\f[V]cache-workers\f[R]: \f[I]مقدار پیکربندی‌شده\f[R] در زمان پخش تأییدشده یا
\f[I]1\f[R] در بقیه مواقع.SS اعتبارسنجی گواهی (Certificate Validation)
.PP
هنگامی که سرور Plex به گونه‌ای پیکربندی شده باشد که تنها اتصال‌های امن را بپذیرد، می‌توان از نشانی‌های \f[V].plex.direct\f[R] برای اطمینان از موفقیت‌آمیز بودن اعتبارسنجی گواهی استفاده کرد.
این نشانی‌ها به صورت داخلی توسط Plex برای اتصال امن به سرور Plex استفاده می‌شوند.
.PP
قالب این نشانی‌ها به شرح زیر است:
.PP
\f[V]https://ip-with-dots-replaced.server-hash.plex.direct:32400\f[R]
.PP
بخش \f[V]ip-with-dots-replaced\f[R] می‌تواند هر آدرس IPv4 باشد که در آن نقطه‌ها با خط تیره جایگزین شده‌اند، برای نمونه \f[V]127.0.0.1\f[R] تبدیل به \f[V]127-0-0-1\f[R] می‌شود.
.PP
برای به‌دست آوردن بخش \f[V]server-hash\f[R]، ساده‌ترین راه مراجعه به پیوند زیر است:
.PP
<https://plex.tv/api/resources?includeHttps=1&X-Plex-Token=your-plex-token>
.PP
این صفحه فهرستی از تمام سرورهای Plex در دسترس برای حساب کاربری شما را به همراه حداقل یک پیوند \f[V].plex.direct\f[R] برای هرکدام نمایش می‌دهد.
یکی از نشانی‌ها را کپی کرده و آدرس IP را با آدرس دلخواه جایگزین کنید.
از این مقدار می‌توان به عنوان \f[V]plex_url\f[R] استفاده کرد.
.SS مشکلات شناخته‌شده
.SS دستور Mount و \-\-dir-cache-time
.PP
گزینه \f[V]\-\-dir-cache-time\f[R] نخستین لایه از حافظه موقت دایرکتوری را که در سطح لایه mount عمل می‌کند، کنترل می‌نماید.
از آنجا که این سازوکار حافظه پنهان مستقل از پس‌بند \f[V]cache\f[R] است، مدخل‌های خود را بر اساس زمان پیکربندی‌شده مدیریت خواهد کرد.
.PP
برای جلوگیری از مواجهه با حالتی که کش دایرکتوری حاوی داده‌های منسوخ و حافظه پنهان حاوی داده‌های صحیح باشد، سعی کنید \f[V]\-\-dir-cache-time\f[R] را روی زمانی کمتر از \f[V]\-\-cache-info-age\f[R] تنظیم کنید.
مقادیر پیش‌فرض از قبل به همین شیوه پیکربندی شده‌اند.
.SS پشتیبانی از Windows - آزمایشی
.PP
چندین مشکل در عملکرد \f[V]mount\f[R] در ویندوز وجود دارد که هنوز نیازمند بررسی است.
تا زمان ارائه اصلاحیه‌ها برای این سیستم‌عامل، باید آن را آزمایشی در نظر گرفت.
.PP
به نظر می‌رسد بیشتر مشکلات به تفاوت میان فایل‌سیستم‌ها در توزیع‌های مختلف لینوکس و ویندوز مربوط باشد، چرا که حافظه موقت به شدت به آن‌ها وابسته است.
.PP
هرگونه گزارش یا بازخورد در مورد نحوه رفتار حافظه موقت (cache) در این سیستم‌عامل با استقبال مواجه خواهد شد.
.IP \[bu] 2
گزارش Issue #1935 (https://github.com/rclone/rclone/issues/1935)
.IP \[bu] 2
گزارش Issue #1907 (https://github.com/rclone/rclone/issues/1907)
.IP \[bu] 2
گزارش Issue #1834 (https://github.com/rclone/rclone/issues/1834)
.SS خطر محدودسازی نرخ درخواست (Throttling)
.PP
در نسخه‌های بعدی پس‌بند cache، از قابلیت تجمیع اتصالات (pooling) ارائه‌دهنده ابری برای همگام‌سازی استفاده خواهد شد و هم‌زمان نوشتن از طریق آن در برابر خطاها مقاوم‌تر می‌شود.
.PP
بهبودهایی برای اضافه کردن این موارد در حال انجام است، اما در این میان نگرانی به‌جایی وجود دارد که انقضای فهرست‌های حافظه موقت ممکن است به دلیل پرس‌وجوهای مکرر برای سوارکردن‌های (mounts) بسیار بزرگ، به محدودسازی نرخ درخواست یا مسدودسازی از سمت ارائه‌دهنده ابری منجر شود.
.PP
چند توصیه:
.IP \[bu] 2
از بازه زمانی بسیار کوچک برای اطلاعات مدخل‌ها (\f[V]\-\-cache-info-age\f[R]) استفاده نکنید.
.IP \[bu] 2
اگرچه عملیات نوشتن هنوز بهینه‌سازی نشده است، همچنان می‌توانید از طریق \f[V]cache\f[R] بنویسید که در صورت پیکربندی مناسب، این مزیت را به همراه دارد که فایل به طور هم‌زمان به حافظه موقت نیز افزوده می‌شود.
.PP
بهبودهای آینده:
.IP \[bu] 2
گزارش Issue #1937 (https://github.com/rclone/rclone/issues/1937)
.IP \[bu] 2
گزارش Issue #1936 (https://github.com/rclone/rclone/issues/1936).SS cache و crypt
.PP
یک سناریوی رایج، نگه‌داری داده‌هایتان به‌صورت رمزگذاری‌شده در ارائه‌دهندهٔ ابری
با استفاده از ریموت \f[V]crypt\f[R] است.
\f[V]crypt\f[R] از روش مشابهی برای دربرگرفتن یک ریموت موجود استفاده کرده
و این تبدیل را به‌شکلی یکپارچه مدیریت می‌کند.
.PP
در صورت دربرگرفتن ریموت‌ها با این ترتیب، مشکلی وجود دارد: \f[B]cloud
remote\f[R] -> \f[B]crypt\f[R] -> \f[B]cache\f[R]
.PP
در طول آزمایش‌ها، با قرارگیری ریموت‌ها در این ترتیب با مسدودسازی‌های زیادی مواجه شدم.
گمان می‌کنم این مسئله ممکن است به نحوهٔ باز کردن فایل‌ها توسط crypt در ارائه‌دهندهٔ ابری
مربوط باشد؛ که باعث می‌شود این‌طور به نظر برسد که در حال بارگیری کامل فایل
به‌جای دریافت تکه‌های کوچک (chunks) هستیم.
سازمان‌دهی ریموت‌ها به این ترتیب نتایج بهتری به همراه دارد: \f[B]cloud
remote\f[R] -> \f[B]cache\f[R] -> \f[B]crypt\f[R]
.SS مسیرهای مطلق ریموت (absolute remote paths)
.PP
بک‌اند \f[V]cache\f[R] نمی‌تواند تفاوت بین مسیرهای نسبی و مطلق را
برای ریموتِ دربرگرفته‌شده تشخیص دهد.
هر مسیری که در تنظیمات پیکربندی \f[V]remote\f[R] و در خط فرمان مشخص شود،
عیناً به ریموت دربرگرفته‌شده ارسال می‌شود؛ اما برای ذخیرهٔ تکه‌ها روی دیسک،
مسیر با حذف هرگونه نویسهٔ \f[V]/\f[R] ابتدایی به‌صورت نسبی درمی‌آید.
.PP
این رفتار برای بیشتر انواع بک‌اندها اهمیتی ندارد، اما بک‌اندهایی وجود دارند
که در آن‌ها یک \f[V]/\f[R] ابتدایی دایرکتوری مؤثر را تغییر می‌دهد؛ به عنوان مثال
در بک‌اند \f[V]sftp\f[R]، مسیرهایی که با \f[V]/\f[R] آغاز می‌شوند نسبت به ریشهٔ
کارساز SSH هستند و مسیرهای بدون آن نسبت به دایرکتوری خانگی کاربر در نظر گرفته می‌شوند.
در نتیجه \f[V]sftp:bin\f[R] و \f[V]sftp:/bin\f[R] از پوشهٔ کش یکسانی استفاده خواهند کرد،
حتی اگر نمایانگر دایرکتوری متفاوتی در کارساز SSH باشند.
.SS کش و کنترل از راه دور (--rc)
.PP
بک‌اند Cache از حالت جدید \f[V]--rc\f[R] در rclone پشتیبانی می‌کند و می‌تواند
از طریق نقاط پایانی زیر از راه دور کنترل شود: به‌طور پیش‌فرض، اگر این پرچم را مشخص نکنید،
شنونده غیرفعال است.
.SS rc cache/expire
.PP
پاک‌سازی یک ریموت از بک‌اند کش.
از دایرکتوری یا فایل پشتیبانی می‌کند.
در صورتی که cache توسط crypt دربرگرفته شده باشد، هم از نام‌های فایل
رمزگذاری‌شده و هم رمزگذاری‌نشده پشتیبانی می‌کند.
.PP
پارامترها:
.IP \[bu] 2
\f[B]remote\f[R] = مسیر به ریموت \f[B](الزامی)\f[R]
.IP \[bu] 2
\f[B]withData\f[R] = مقدار true/false برای حذف داده‌های کش‌شده (تکه‌ها) نیز \f[I](اختیاری، به‌طور پیش‌فرض false)\f[R]
.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص cache (کش کردن یک ریموت) آورده شده است.
.SS --cache-remote
.PP
ریموتی که باید کش شود.
.PP
به‌طور معمول باید شامل یک \[aq]:\[aq] و یک مسیر باشد، مانند
\[dq]myremote:path/to/dir\[dq]، \[dq]myremote:bucket\[dq] یا شاید
\[dq]myremote:\[dq] (توصیه نمی‌شود).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: remote
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_REMOTE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --cache-plex-url
.PP
آدرس URL کارساز Plex.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: plex_url
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_PLEX_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --cache-plex-username
.PP
نام کاربری کاربر Plex.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: plex_username
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_PLEX_USERNAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --cache-plex-password
.PP
گذرواژه کاربر Plex.
.PP
\f[B]نکته:\f[R] ورودی این مورد باید مبهم‌سازی شده باشد \- دستور rclone
obscure (https://rclone.org/commands/rclone_obscure) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: plex_password
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_PLEX_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --cache-chunk-size
.PP
اندازه یک تکه (داده‌های بخشی فایل).
.PP
برای اتصال‌های کندتر از مقادیر کم‌تر استفاده کنید.
اگر اندازه تکه تغییر کند، تمام تکه‌های دانلودشده نامعتبر خواهند شد و
مسیر cache-chunk-path باید پاک‌سازی شود؛ در غیر این صورت خطاهای غیرمنتظره EOF
رخ خواهند داد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 5Mi
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]1M\[dq]
.RS 2
.IP \[bu] 2
1 MiB
.RE
.IP \[bu] 2
\[dq]5M\[dq]
.RS 2
.IP \[bu] 2
5 MiB
.RE
.IP \[bu] 2
\[dq]10M\[dq]
.RS 2
.IP \[bu] 2
10 MiB
.RE
.RE
.SS --cache-info-age
.PP
مدت زمان نگهداری اطلاعات ساختار فایل در حافظه موقت (فهرست دایرکتوری‌ها،
اندازه فایل، زمان‌ها و غیره).
اگر تمام عملیات‌های نوشتن از طریق حافظه موقت انجام شوند، می‌توانید با خیال راحت
این مقدار را بسیار بزرگ در نظر بگیرید، زیرا مخزن حافظه موقت نیز به‌صورت
بلادرنگ به‌روزرسانی خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: info_age
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_INFO_AGE
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 6h0m0s
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]1h\[dq]
.RS 2
.IP \[bu] 2
۱ ساعت
.RE
.IP \[bu] 2
\[dq]24h\[dq]
.RS 2
.IP \[bu] 2
۲۴ ساعت
.RE
.IP \[bu] 2
\[dq]48h\[dq]
.RS 2
.IP \[bu] 2
۴۸ ساعت
.RE
.RE.SS --cache-chunk-total-size
.PP
مجموع حجمی که تکه‌ها (chunks) می‌توانند روی دیسک محلی اشغال کنند.
.PP
اگر کش از این مقدار فراتر رود، شروع به حذف قدیمی‌ترین تکه‌ها می‌کند تا زمانی که حجم آن به زیر این مقدار برسد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_total_size
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_CHUNK_TOTAL_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 10Gi
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]500M\[dq]
.RS 2
.IP \[bu] 2
500 MiB
.RE
.IP \[bu] 2
\[dq]1G\[dq]
.RS 2
.IP \[bu] 2
1 GiB
.RE
.IP \[bu] 2
\[dq]10G\[dq]
.RS 2
.IP \[bu] 2
10 GiB
.RE
.RE
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مخصوص cache (کش کردن یک ریموت) آورده شده است.
.SS --cache-plex-insecure
.PP
صرف‌نظر کردن از تمام مراحل اعتبارسنجی گواهی‌نامه هنگام اتصال به سرور Plex.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: plex_insecure
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_PLEX_INSECURE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --cache-db-path
.PP
دایرکتوری برای ذخیره‌سازی پایگاه‌داده فراداده‌های ساختار فایل.
.PP
از نام ریموت به عنوان نام فایل پایگاه‌داده استفاده می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: db_path
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_DB_PATH
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]$HOME/.cache/rclone/cache-backend\[dq]
.SS --cache-chunk-path
.PP
دایرکتوری برای ذخیره‌سازی موقت (کش) فایل‌های تکه (chunks).
.PP
مسیری که داده‌های جزئی فایل (تکه‌ها) به صورت محلی در آن ذخیره می‌شوند.
نام ریموت به انتهای مسیر نهایی اضافه می‌شود.
.PP
این پیکربندی از \[dq]--cache-db-path\[dq] پیروی می‌کند.
اگر مکان سفارشی را برای \[dq]--cache-db-path\[dq] مشخص کنید و
مسیری را برای \[dq]--cache-chunk-path\[dq] تعیین نکنید، آنگاه
\[dq]--cache-chunk-path\[dq] از همان مسیر
\[dq]--cache-db-path\[dq] استفاده خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_path
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_CHUNK_PATH
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]$HOME/.cache/rclone/cache-backend\[dq].SS --cache-db-purge
.PP
پاک کردن همهٔ داده‌های کَش‌شدهٔ این ریموت (remote) در زمان راه‌اندازی.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: db_purge
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_DB_PURGE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --cache-chunk-clean-interval
.PP
فواصل زمانی انجام پاک‌سازی فضای ذخیره‌سازی تکه‌ها (chunks) توسط کَش.
.PP
مقدار پیش‌فرض برای بیشتر کاربران مناسب است.
اگر متوجه شدید که کَش بیش از حد از \[dq]cache-chunk-total-size\[dq]
تجاوز می‌کند، این مقدار را کاهش دهید تا پاک‌سازی در فواصل زمانی کوتاه‌تر
و به دفعات بیشتری انجام شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_clean_interval
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_CHUNK_CLEAN_INTERVAL
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 1m0s
.SS --cache-read-retries
.PP
تعداد دفعات تلاش مجدد برای خواندن از فضای ذخیره‌سازی کَش.
.PP
از آنجا که خواندن از یک جریان (stream) کَش مستقل از دانلود داده‌های فایل
است، ممکن است خواننده‌ها به نقطه‌ای برسند که دادهٔ دیگری در کَش
موجود نباشد.
در اغلب موارد اگر کَش قادر به ارائهٔ بیشتر داده‌های فایل نباشد، این امر
می‌تواند نشان‌دهندهٔ وجود مشکل در اتصال شبکه باشد.
.PP
برای اتصالات بسیار کند، این مقدار را تا نقطه‌ای افزایش دهید که جریان
قادر به تأمین داده باشد، هرچند تجربهٔ شما با مکث و وقفه‌های فراوان همراه خواهد بود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: read_retries
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_READ_RETRIES
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 10
.SS --cache-workers
.PP
تعداد پردازه‌های کاری (workers) که برای دانلود تکه‌ها باید به‌طور موازی اجرا شوند.
.PP
مقادیر بالاتر به معنای پردازش موازی بیشتر (نیازمند CPU قوی‌تر) و
درخواست‌های هم‌زمان بیشتر به ارائه‌دهندهٔ ابری است.
این امر بر جنبه‌های گوناگونی از قبیل محدودیت‌های API ارائه‌دهندهٔ ابری
و فشار بیشتر بر سخت‌افزاری که rclone روی آن اجرا می‌شود اثر می‌گذارد،
اما از سوی دیگر موجب روان‌تر شدن جریان‌ها شده و داده‌ها بسیار سریع‌تر
در دسترس خواننده‌ها قرار خواهند گرفت.
.PP
\f[B]نکته\f[R]: در صورت فعال بودن قابلیت اختیاری یکپارچه‌سازی با Plex، این
تنظیم با نوع خواندن در حال انجام تطبیق یافته و مقدار تعیین‌شده در اینجا به عنوان
حداکثر تعداد پردازه‌های کاری مجاز به کار گرفته خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: workers
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_WORKERS
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 4
.SS --cache-chunk-no-memory
.PP
غیرفعال کردن کَش درون‌حافظه‌ای برای ذخیرهٔ تکه‌ها در حین استریم (streaming).
.PP
به‌طور پیش‌فرض، کَش در حین استریم داده‌های فایل را در RAM نیز نگه‌داری می‌کند
تا آن‌ها را در سریع‌ترین زمان ممکن در اختیار خواننده‌ها قرار دهد.
.PP
این داده‌های موقت به محض خوانده شدن دور ریخته می‌شوند و تعداد تکه‌های
ذخیره‌شده از تعداد پردازه‌های کاری (workers) تجاوز نمی‌کند.
با این وجود، بسته به تنظیمات دیگری مانند \[dq]cache-chunk-size\[dq] و
\[dq]cache-workers\[dq]، در صورت وجود جریان‌های موازی (خواندن هم‌زمان
چندین فایل)، این ردپای حافظه می‌تواند افزایش یابد.
.PP
چنانچه سخت‌افزار اجازه می‌دهد، از این قابلیت برای ارائهٔ کارایی کلی بهتر حین
استریم استفاده کنید؛ با این حال در صورت کمبود RAM روی ماشین محلی، می‌توان
آن را غیرفعال کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_no_memory
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_CHUNK_NO_MEMORY
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --cache-rps
.PP
تعداد درخواست‌ها در هر ثانیه به فایل‌سیستم منبع را محدود می‌کند (مقدار \-1 برای غیرفعال‌سازی).
.PP
این تنظیم یک محدودیت قطعی (hard limit) بر تعداد درخواست‌ها در هر ثانیه که حافظه موقت (cache) به سرویس‌دهنده ابری دوردست ارسال می‌کند اعمال کرده و با تنظیم زمان‌های انتظار میان خواندن‌ها تلاش می‌کند این مقدار را رعایت کند.
.PP
اگر متوجه شدید که از طریق حافظه موقت در سرویس‌دهنده ابری مسدود یا محدود می‌شوید و می‌دانید که تعداد کمتری از درخواست‌ها در هر ثانیه امکان ادامه کار را به شما می‌دهد، می‌توانید از این تنظیم استفاده کنید.
.PP
یک توازن مناسب بین تمام تنظیمات دیگر معمولاً این گزینه را غیرضروری می‌سازد، اما همچنان برای سناریوهای خاص در دسترس است.
.PP
\f[B]نکته\f[R]: این گزینه تعداد درخواست‌ها را در حین جریان‌های داده (streams) محدود می‌کند، اما سایر فراخوانی‌های API به ارائه‌دهنده ابری مانند فهرست کردن محتوای دایرکتوری‌ها همچنان انجام خواهند شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: rps
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_RPS
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: \-1
.SS --cache-writes
.PP
داده‌های فایل را هنگام نوشتن از طریق فایل‌سیستم در حافظه موقت ذخیره می‌کند.
.PP
اگر نیاز دارید فایل‌ها را بلافاصله پس از بارگذاری از طریق حافظه موقت بخوانید، می‌توانید این پرچم را فعال کنید تا هم‌زمان در حین بارگذاری، داده‌های آن‌ها در حافظه موقت نیز ذخیره شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: writes
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_WRITES
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --cache-tmp-upload-path
.PP
دایرکتوری نگهداری فایل‌های موقت تا زمانی که بارگذاری شوند.
.PP
این مسیری است که حافظه موقت به عنوان فضای ذخیره‌سازی موقت برای فایل‌های جدیدی که باید در سرویس‌دهنده ابری بارگذاری شوند، استفاده خواهد کرد.
.PP
مشخص کردن یک مقدار، این قابلیت را فعال می‌کند.
بدون آن، این ویژگی کاملاً غیرفعال بوده و فایل‌ها به طور مستقیم در سرویس‌دهنده ابری بارگذاری خواهند شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: tmp_upload_path
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_TMP_UPLOAD_PATH
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --cache-tmp-wait-time
.PP
مدت زمانی که فایل‌ها باید پیش از بارگذاری، در حافظه موقت محلی نگهداری شوند.
.PP
این مدت زمانی است که یک فایل باید در مسیر موقت \f[I]cache-tmp-upload-path\f[R] منتظر بماند تا برای بارگذاری انتخاب شود.
.PP
توجه داشته باشید که در هر لحظه تنها یک فایل بارگذاری می‌شود و در صورت تشکیل صف برای این منظور، ممکن است شروع بارگذاری بیشتر طول بکشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: tmp_wait_time
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_TMP_WAIT_TIME
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 15s.SS --cache-db-wait-time
.PP
مدت‌زمان انتظار برای دردسترس قرار گرفتن پایگاه‌داده (DB) \- مقدار 0 به معنای نامحدود است.
.PP
در هر لحظه تنها یک فرآیند می‌تواند پایگاه‌داده را باز نگه دارد، بنابراین rclone پیش از بازگرداندن خطا، به مدت این بازه برای در دسترس قرار گرفتن پایگاه‌داده منتظر می‌ماند.
.PP
اگر آن را روی 0 تنظیم کنید، برای همیشه منتظر خواهد ماند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: db_wait_time
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_DB_WAIT_TIME
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 1s
.SS --cache-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_CACHE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS "دستورهای پسانه (Backend commands)"
.PP
در اینجا دستورهای ویژهٔ پسانهٔ cache آورده شده است.
.PP
آن‌ها را به این صورت اجرا کنید:
.IP
.nf
\f[C]
rclone backend COMMAND remote:
\f[R]
.fi
.PP
راهنمای زیر مشخص می‌کند که هر دستور چه آرگومان‌هایی دریافت می‌کند.
.PP
برای اطلاعات بیشتر دربارهٔ نحوهٔ ارسال گزینه‌ها و آرگومان‌ها، دستور backend (https://rclone.org/commands/rclone_backend) را ببینید.
.PP
این دستورها را می‌توان بر روی یک پسانهٔ در حال اجرا با استفاده از دستور rc به‌صورت backend/command (https://rclone.org/rc/#backend-command) نیز اجرا کرد.
.SS stats
.PP
چاپ آمار پسانهٔ cache در قالب JSON.
.IP
.nf
\f[C]
rclone backend stats remote: [options] [<arguments>+]
\f[R]
.fi
.SH "تکه‌کننده (Chunker)"
.PP
لایهٔ هم‌پوشان (overlay) \f[V]chunker\f[R] در هنگام بارگذاری روی ریموتِ پوشش‌یافته (wrapped remote)، فایل‌های بزرگ را به‌صورت شفاف به قطعات کوچک‌تر تقسیم کرده و هنگام بارگیری، مجدداً آن‌ها را به‌طور یکپارچه سرهم‌بندی می‌کند.
این قابلیت امکان دور زدن مؤثر محدودیت‌های حجم اعمال‌شده از سوی ارائه‌دهندگان فضای ذخیره‌سازی را فراهم می‌کند.
.SS "پیکربندی (Configuration)"
.PP
برای استفاده از آن، ابتدا ریموت زیرین را مطابق دستورالعمل‌های پیکربندی همان ریموت راه‌اندازی کنید.
همچنین می‌توانید به جای یک ریموت، از یک مسیر محلی استفاده نمایید.
.PP
ابتدا بررسی کنید که ریموت انتخابی شما به‌درستی کار می‌کند \- ما در اینجا آن را \f[V]remote:path\f[R] می‌نامیم.
توجه داشته باشید هر چیزی درون \f[V]remote:path\f[R] تکه‌تکه خواهد شد و هر چه بیرون از آن باشد تکه‌تکه نخواهد شد.
این بدان معناست که اگر از یک ریموت مبتنی بر باکت (مانند S3، B2، swift) استفاده می‌کنید، احتمالاً باید باکت را در ریموت به شکل \f[V]s3:bucket\f[R] مشخص کنید.
.PP
اکنون \f[V]chunker\f[R] را با استفاده از \f[V]rclone config\f[R] پیکربندی کنید.
برای تفکیک آن از خود \f[V]remote\f[R]، نام این ریموت را \f[V]overlay\f[R] می‌گذاریم.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> overlay
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Transparently chunk/split large files
   \[rs] \[dq]chunker\[dq]
[snip]
Storage> chunker
Remote to chunk/unchunk.
Normally should contain a \[aq]:\[aq] and a path, e.g. \[dq]myremote:path/to/dir\[dq],
\[dq]myremote:bucket\[dq] or maybe \[dq]myremote:\[dq] (not recommended).
Enter a string value. Press Enter for the default (\[dq]\[dq]).
remote> remote:path
Files larger than chunk size will be split in chunks.
Enter a size with suffix K,M,G,T. Press Enter for the default (\[dq]2G\[dq]).
chunk_size> 100M
Choose how chunker handles hash sums. All modes but \[dq]none\[dq] require metadata.
Enter a string value. Press Enter for the default (\[dq]md5\[dq]).
Choose a number from below, or type in your own value
 1 / Pass any hash supported by wrapped remote for non-chunked files, return nothing otherwise
   \[rs] \[dq]none\[dq]
 2 / MD5 for composite files
   \[rs] \[dq]md5\[dq]
 3 / SHA1 for composite files
   \[rs] \[dq]sha1\[dq]
 4 / MD5 for all files
   \[rs] \[dq]md5all\[dq]
 5 / SHA1 for all files
   \[rs] \[dq]sha1all\[dq]
 6 / Copying a file to chunker will request MD5 from the source falling back to SHA1 if unsupported
   \[rs] \[dq]md5quick\[dq]
 7 / Similar to \[dq]md5quick\[dq] but prefers SHA1 over MD5
   \[rs] \[dq]sha1quick\[dq]
hash_type> md5
Edit advanced config? (y/n)
y) Yes
n) No
y/n> n
Remote config
--------------------
[overlay]
type = chunker
remote = remote:bucket
chunk_size = 100M
hash_type = md5
--------------------
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS مشخص‌کردن ریموت
.PP
در استفادهٔ معمول، اطمینان حاصل کنید که نام ریموت شامل \f[V]:\f[R] باشد.
اگر ریموت را بدون \f[V]:\f[R] مشخص کنید، rclone از یک دایرکتوری محلی با همان نام استفاده خواهد کرد.
بنابراین اگر از ریموتی مانند \f[V]/path/to/secret/files\f[R] استفاده کنید، rclone محتوا را در آن دایرکتوری تکه‌بندی خواهد کرد.
اگر از ریموتی با نام \f[V]name\f[R] استفاده کنید، rclone فایل‌ها را در دایرکتوری‌ای به نام \f[V]name\f[R] درون دایرکتوری جاری قرار می‌دهد.
.SS تکه‌بندی
.PP
هنگامی که rclone بارگذاری فایلی را آغاز می‌کند، chunker اندازهٔ فایل را بررسی می‌کند.
اگر اندازهٔ آن از اندازهٔ تکهٔ پیکربندی‌شده بیشتر نباشد، chunker صرفاً فایل را به ریموت پوشش‌یافته (wrapped) تحویل می‌دهد (با این حال، به هشدار زیر توجه کنید).
اگر فایلی بزرگ باشد، chunker به‌طور شفاف داده‌ها را به تکه‌هایی با نام‌های موقت برش داده و آن‌ها را یکی پس از دیگری، در لحظه جاری (stream) می‌کند.
هر تکه از داده شامل تعداد بایت‌های مشخص‌شده خواهد بود، به‌جز آخرین تکه که ممکن است دادهٔ کمتری داشته باشد.
اگر اندازهٔ فایل از قبل مشخص نباشد (که به آن بارگذاری جریانی یا streaming upload می‌گویند)، chunker به‌طور داخلی یک رونوشت موقت ایجاد کرده، اندازهٔ آن را ثبت می‌کند و فرایند بالا را تکرار می‌نماید.
.PP
هنگامی که بارگذاری به پایان می‌رسد، در نهایت نام فایل‌های موقتِ تکه‌ها تغییر می‌یابد.
این طرح تضمین می‌کند که عملیات می‌توانند به‌صورت موازی اجرا شوند و از دید بیرون، اتمیک (atomic) به نظر برسند.
روش مشابهی با تکه‌های موقتِ پنهان برای سایر عملیات (کپی، انتقال، تغییر نام و غیره) به کار می‌رود.
اگر عملیاتی با شکست مواجه شود، تکه‌های پنهان معمولاً حذف می‌شوند و فایل ترکیبی مقصد دست‌نخورده باقی می‌ماند.
.PP
هنگامی که بارگیری یک فایل ترکیبی درخواست می‌شود، chunker با الحاق مرتب تکه‌های داده، آن را به‌طور شفاف سرهم می‌کند.
از آنجا که این تقسیم‌بندی بسیار ساده است، حتی می‌توان تکه‌های داده را به‌صورت دستی به یکدیگر متصل کرد تا محتوای اصلی به دست آید.
.PP
هنگامی که دستور \f[V]list\f[R] در rclone دایرکتوری‌ای را در ریموت پوشش‌یافته اسکن می‌کند، فایل‌های تکهٔ بالقوه محاسبه، گروه‌بندی و در قالب مدخل‌های ترکیبی دایرکتوری سرهم می‌شوند.
تمامی تکه‌های موقت پنهان هستند.
.PP
دستور list و سایر دستورها گاهی ممکن است با فایل‌های ترکیبی‌ای مواجه شوند که دارای تکه‌های گم‌شده یا نامعتبر هستند؛ برای مثال، تکه‌هایی که زیر سایهٔ یک دایرکتوری یا فایل دیگر با نام مشابه قرار گرفته‌اند.
این موضوع معمولاً به این معنی است که سیستم‌فایل پوشش‌یافته مستقیماً دستکاری شده یا آسیب دیده است.
اگر chunker یک تکهٔ گم‌شده را شناسایی کند، به‌طور پیش‌فرض یک هشدار چاپ می‌کند و از کل گروه ناقص تکه‌ها صرف‌نظر می‌نماید، اما اجرای دستور جاری را ادامه می‌دهد.
می‌توانید پرچم \f[V]--chunker-fail-hard\f[R] را تنظیم کنید تا دستورها در چنین مواردی با پیام خطا متوقف شوند.
.PP
\f[B]هشدار\f[R]: در وضعیت کنونی، chunker همیشه یک فایل موقت در backend ایجاد کرده و سپس نام آن را تغییر می‌دهد، حتی اگر اندازهٔ فایل کمتر از آستانهٔ تکه‌بندی باشد.
این امر منجر به فراخوانی‌های غیرضروری API می‌شود و هنگام جابه‌جایی فایل‌هایی که عمدتاً کوچک هستند، می‌تواند پهنای باند و نرخ انتقال داده (throughput) را در برخی backendها (مانند Box) به‌شدت محدود کند.
یک راهکار برای این مشکل، استفاده از chunker تنها برای فایل‌های بزرگ‌تر از آستانهٔ تکه‌بندی از طریق \f[V]--min-size\f[R] و سپس اجرای یک دستور جداگانه بدون chunker برای فایل‌های باقی‌مانده است.
.SS نام تکه‌ها
.PP
قالب پیش‌فرض نام تکه‌ها \f[V]*.rclone_chunk.###\f[R] است؛ بنابراین به‌طور پیش‌فرض نام‌های تکه \f[V]BIG_FILE_NAME.rclone_chunk.001\f[R]، \f[V]BIG_FILE_NAME.rclone_chunk.002\f[R] و غیره خواهد بود.
می‌توانید با استفاده از گزینهٔ فایل پیکربندیِ \f[V]name_format\f[R]، قالب نام دیگری را تعیین کنید.
این قالب از ستاره \f[V]*\f[R] به عنوان جانگهدار نام اصلی فایل و از یک یا چند نویسهٔ هش \f[V]#\f[R] متوالی به عنوان جانگهدار شمارهٔ ترتیبی تکه استفاده می‌کند.
باید دقیقاً یک نویسهٔ ستاره وجود داشته باشد.
تعداد نویسه‌های هش متوالی، حداقل طول رشتهٔ نشان‌دهندهٔ شمارهٔ تکه را تعیین می‌کند.
اگر شمارهٔ ده‌دهی تکه ارقام کمتری نسبت به تعداد هش‌ها داشته باشد، از سمت چپ با صفر پر می‌شود (left-padded).
اگر رشتهٔ ده‌دهی طولانی‌تر باشد، دست‌نخورده باقی می‌ماند.
به‌طور پیش‌فرض شماره‌گذاری از ۱ آغاز می‌شود، اما گزینهٔ دیگری نیز وجود دارد که به کاربر اجازه می‌دهد شماره‌گذاری را از ۰ شروع کند؛ مثلاً برای سازگاری با نرم‌افزارهای قدیمی (legacy).
.PP
برای نمونه، اگر قالب نام \f[V]big_*-##.part\f[R] باشد و نام فایل اصلی \f[V]data.txt\f[R] بوده و شماره‌گذاری از ۰ آغاز شود، نخستین تکه \f[V]big_data.txt-00.part\f[R]، نود و نهمین تکه \f[V]big_data.txt-98.part\f[R]، و سیصد و دومین تکه \f[V]big_data.txt-301.part\f[R] نام خواهد گرفت.
.PP
توجه داشته باشید که \f[V]list\f[R] ورودی‌های ترکیبی دایرکتوری را تنها زمانی سرهم می‌کند که نام تکه‌ها با قالب پیکربندی‌شده مطابقت داشته باشند، و با نام‌های فایلی که نامنطبق هستند مانند فایل‌های عادی و تکه‌بندی‌نشده رفتار می‌کند.
.PP
هنگام استفاده از تراکنش‌های \f[V]norename\f[R]، نام تکه‌ها افزون بر این یک پسوند نسخهٔ فایلِ یکتا نیز خواهند داشت.
برای نمونه، \f[V]BIG_FILE_NAME.rclone_chunk.001_bp562k\f[R]..SS "متادیتا (Metadata)"
.PP
به جز تکه‌های داده (data chunks)، ابزار chunker به صورت پیش‌فرض یک شیء متادیتا برای فایل ترکیبی ایجاد می‌کند.
نام این شیء برگرفته از نام فایل اصلی است.
ابزار chunker به کاربر اجازه می‌دهد متادیتا را به طور کامل غیرفعال کند (قالب \f[V]none\f[R]).
توجه داشته باشید که معمولاً برای فایل‌های کوچک‌تر از اندازه تکه (chunk size) پیکربندی‌شده، متادیتایی ایجاد نمی‌شود.
این رفتار ممکن است در انتشار‌های آینده rclone تغییر کند.
.SS "قالب متادیتای ساده JSON (Simple JSON metadata format)"
.PP
این قالب پیش‌فرض است.
این قالب از مجموع هش‌ها (hash sums) و اعتبارسنجی تکه‌ها برای فایل‌های ترکیبی پشتیبانی می‌کند.
اشیاء متادیتا حامل فیلدهای زیر هستند:
.IP \[bu] 2
\f[V]ver\f[R] \- نسخه قالب، در حال حاضر \f[V]1\f[R]
.IP \[bu] 2
\f[V]size\f[R] \- اندازه کل فایل ترکیبی
.IP \[bu] 2
\f[V]nchunks\f[R] \- تعداد تکه‌های داده در فایل
.IP \[bu] 2
\f[V]md5\f[R] \- مجموع هش MD5 فایل ترکیبی (در صورت وجود)
.IP \[bu] 2
\f[V]sha1\f[R] \- مجموع هش SHA1 (در صورت وجود)
.IP \[bu] 2
\f[V]txn\f[R] \- مشخص‌کننده نسخه فعلی فایل
.PP
هیچ فیلدی برای نام فایل ترکیبی وجود ندارد، زیرا نام آن دقیقاً برابر با نام شیء متادیتا روی ریموت بسته‌بندی‌شده (wrapped remote) است.
لطفاً برای جزئیات مربوط به مجموع هش‌ها و نحوه مدیریت زمان تغییر، به بخش‌های مربوطه مراجعه کنید.
.SS "بدون متادیتا (No metadata)"
.PP
می‌توانید با تنظیم گزینه قالب متادیتا روی \f[V]none\f[R]، اشیاء متادیتا را غیرفعال کنید.
در این حالت، chunker دایرکتوری را برای تمام فایل‌هایی که از قالب نام‌گذاری تکه پیکربندی‌شده پیروی می‌کنند پویش کرده، آن‌ها را با شناسایی تکه‌های دارای نام پایه یکسان گروه‌بندی می‌کند و نام گروه‌ها را به عنوان فایل‌های ترکیبی مجازی نمایش می‌دهد.
این روش نسبت به حالتی که متادیتا در آن فعال است، بیشتر در معرض خطاهای مربوط به مفقود شدن تکه (به‌ویژه مفقود شدن آخرین تکه) قرار دارد.
.SS "مجموع هش‌ها (Hashsums)"
.PP
ابزار chunker تنها زمانی از مجموع هش‌ها پشتیبانی می‌کند که متادیتای سازگار موجود باشد.
از این رو، اگر قالب متادیتا را برابر با \f[V]none\f[R] انتخاب کنید، chunker مجموع هش را به صورت \f[V]UNSUPPORTED\f[R] گزارش خواهد کرد.
.PP
لطفاً توجه داشته باشید که به طور پیش‌فرض، متادیتا فقط برای فایل‌های ترکیبی ذخیره می‌شود.
اگر فایلی کوچک‌تر از اندازه تکه پیکربندی‌شده باشد، chunker درخواست‌های هش را به صورت شفاف به ریموت بسته‌بندی‌شده هدایت می‌کند؛ بنابراین پشتیبانی به آن بستگی دارد.
در صورتی که ریموت بسته‌بندی‌شده از آن نوع هش پشتیبانی نکند، برای فایل‌های کوچک یک رشته خالی به عنوان مجموع هش از نوع درخواستی دریافت خواهید کرد.
.PP
بسیاری از بک‌اندهای ذخیره‌سازی از انواع هش MD5 و SHA1 پشتیبانی می‌کنند و chunker نیز همین‌طور است.
با chunker می‌توانید یکی یا دیگری را انتخاب کنید، اما نه هر دو را.
نوع MD5 به عنوان نوعی با بیشترین میزان پشتیبانی، به صورت پیش‌فرض تنظیم شده است.
از آنجا که chunker هش‌ها را برای فایل‌های ترکیبی نگه می‌دارد و برای فایل‌های تکه‌تکه‌نشده به هش ریموت بسته‌بندی‌شده رجوع می‌کند، توصیه می‌کنیم همان نوع هشی را انتخاب کنید که توسط ریموت بسته‌بندی‌شده پشتیبانی می‌شود تا فهرست فایل‌های شما یکپارچه و هماهنگ باشد.
.PP
اگر بک‌اند ذخیره‌سازی شما از MD5 یا SHA1 پشتیبانی نمی‌کند اما به هشینگ یکنواخت فایل‌ها نیاز دارید، chunker را با \f[V]md5all\f[R] یا \f[V]sha1all\f[R] پیکربندی کنید.
این دو حالت، هش مشخص‌شده را برای تمام فایل‌ها تضمین می‌کنند.
اگر ریموت بسته‌بندی‌شده از آن پشتیبانی نکند، chunker متادیتا را به تمامی فایل‌ها، حتی فایل‌های کوچک اضافه خواهد کرد.
با این وجود، این کار می‌تواند تعداد فایل‌های کوچک را در فضای ذخیره‌سازی دو برابر کرده و هزینه‌های سرویس اضافی به همراه داشته باشد.
حتی می‌توانید با ایجاد اشیاء متادیتای جانبی (sidecar meta objects)، از chunker برای اجبار به پشتیبانی از md5/sha1 در هر ریموت دیگری استفاده کنید؛ به عنوان مثال با تنظیم \f[V]hash_type=sha1all\f[R] برای اجبار مجموع هش‌ها و \f[V]chunk_size=1P\f[R] برای غیرفعال‌سازی مؤثر تکه‌تکه‌سازی.
.PP
به طور معمول، هنگامی که فایلی به یک ریموت تحت کنترل chunker کپی می‌شود، chunker هش سازگار فایل را از مبدأ فایل درخواست می‌کند و در صورت نیافتن آن، به محاسبه بلادرنگ (on-the-fly) متوسل می‌شود.
این فرایند مقداری بار پردازشی اضافی بر CPU تحمیل می‌کند، اما تضمین می‌دهد که مجموع هش مورد نظر در دسترس باشد.
همچنین اگر نوع مجموع هش در مبدأ و مقصد متفاوت باشد، chunker عملیات کپی یا انتقال سمت سرور (server-side) را رد خواهد کرد که این موضوع نیز منجر به مصرف پهنای باند اضافی شبکه می‌شود.
در برخی موارد نادر ممکن است این امر نامطلوب باشد، بنابراین chunker دو انتخاب اختیاری ارائه می‌دهد: \f[V]sha1quick\f[R] و \f[V]md5quick\f[R].
اگر مبدأ از نوع هش اصلی پشتیبانی نکند و حالت سریع (quick mode) فعال باشد، chunker تلاش خواهد کرد تا به نوع ثانویه بازگردد.
این کار در مصرف پردازنده و پهنای باند صرفه‌جویی می‌کند، اما می‌تواند منجر به مجموع هش‌های خالی در مقصد شود.
مراقب پیامدها باشید: اگر مجموع هش‌های سازگار بین مبدأ و مقصد یافت نشود، دستور \f[V]sync\f[R] (گاهی اوقات بی‌صدا) به مقایسه زمان/اندازه بازخواهد گشت..SS زمان‌های تغییر (Modification times)
.PP
ابزار Chunker زمان‌های تغییر را با استفاده از ریموت پوشش‌داده‌شده ذخیره می‌کند، بنابراین پشتیبانی از آن به ریموت مربوطه وابسته است.
برای یک فایل کوچک تکه‌تکه نشده، لایهٔ chunker صرفاً زمان تغییر فایل در ریموت پوشش‌داده‌شده را دستکاری می‌کند.
برای یک فایل ترکیبی دارای فراداده (metadata)، ابزار chunker زمان تغییر شیء فراداده را در ریموت پوشش‌داده‌شده دریافت و تنظیم می‌کند.
اگر فایل تکه‌تکه شده باشد اما قالب فراداده روی \f[V]none\f[R] تنظیم شده باشد، chunker از زمان تغییر اولین تکه داده استفاده خواهد کرد.
.SS مهاجرت‌ها (Migrations)
.PP
روش اصولی برای مهاجرت به اندازه تکه، نوع هش، شیوهٔ تراکنش یا طرح نام‌گذاری تکه‌های متفاوت به این ترتیب است:
.IP \[bu] 2
تمام فایل‌های تکه‌تکه‌شدهٔ خود را در یک دایرکتوری جمع‌آوری کنید و ریموت chunker خود را طوری تنظیم کنید که به آن اشاره کند.
.IP \[bu] 2
یک دایرکتوری دیگر (ترجیحاً در همان فضای ذخیره‌سازی ابری) بسازید و یک ریموت جدید با قالب فراداده، نوع هش، نام‌گذاری تکه و غیره دلخواه پیکربندی کنید.
.IP \[bu] 2
اکنون دستور \f[V]rclone sync --interactive oldchunks: newchunks:\f[R] را اجرا کنید تا تمام داده‌های شما به‌طور شفاف در حین انتقال تبدیل شوند.
این فرایند ممکن است کمی زمان ببرد، با این حال chunker در صورت امکان تلاش می‌کند از کپی سمت سرور استفاده کند.
.IP \[bu] 2
پس از بررسی صحت داده‌ها، می‌توانید بخش پیکربندی ریموت قدیمی را حذف کنید.
.PP
اگر rclone در حین انجام یک عملیات طولانی روی یک فایل ترکیبی بزرگ متوقف (kill) شود، ممکن است تکه‌های موقت پنهان در دایرکتوری باقی بمانند.
این تکه‌ها توسط دستور \f[V]list\f[R] نشان داده نخواهند شد اما سهمیه فضای حساب شما را مصرف می‌کنند.
لطفاً توجه داشته باشید که دستور \f[V]deletefile\f[R] فقط تکه‌های فعال یک فایل را حذف می‌کند.
به عنوان یک راه‌حل موقت، می‌توانید از ریموتِ سیستم فایل پوشش‌داده‌شده برای دیدن آن‌ها استفاده کنید.
یک راه آسان برای خلاص شدن از شر زباله‌های پنهان این است که دایرکتوری شلوغ‌شده را با استفاده از ریموت chunker در جای دیگری کپی کرده و دایرکتوری اصلی را پاک‌سازی (purge) کنید.
دستور \f[V]copy\f[R] تنها تکه‌های فعال را کپی می‌کند، در حالی که \f[V]purge\f[R] همه‌چیز از جمله زباله‌ها را حذف خواهد کرد.
.SS هشدارها و محدودیت‌ها (Caveats and Limitations)
.PP
ابزار Chunker نیازمند آن است که ریموت پوشش‌داده‌شده از عملیات سمت سرور \f[V]move\f[R] (یا \f[V]copy\f[R] + \f[V]delete\f[R]) پشتیبانی کند، در غیر این صورت صراحتاً از شروع به کار خودداری می‌کند.
دلیل این امر آن است که پس از اتمام موفقیت‌آمیز عملیات، فایل‌های تکهٔ موقت به‌صورت داخلی به نام‌های نهایی خود تغییر نام داده می‌شوند.
.PP
ابزار Chunker شماره تکه را در نام فایل کدگذاری می‌کند، بنابراین با تنظیمات پیش‌فرض \f[V]name_format\f[R] تعداد ۱۷ نویسه به نام فایل اضافه می‌شود.
همچنین chunker در حین انجام عملیات، ۷ نویسه پسوند موقت اضافه می‌کند.
بسیاری از سیستم‌های فایل، نام پایه فایل بدون مسیر را به ۲۵۵ نویسه محدود می‌کنند.
استفاده از ریموت crypt در rclone به عنوان سیستم فایل پایه، نام فایل را به ۱۴۳ نویسه محدود می‌کند.
بنابراین، بیشینهٔ طول نام برای بیشتر فایل‌ها ۲۳۱ نویسه و برای chunker بر روی crypt برابر با ۱۱۹ نویسه است.
کاربر در صورت نیاز می‌تواند قالب نام را به عنوان مثال به \f[V]*.rcc##\f[R] تغییر دهد و ۱۰ نویسه صرفه‌جویی کند (به شرطی که حداکثر ۹۹ تکه برای هر فایل وجود داشته باشد).
.PP
توجه داشته باشید که عملیات جابه‌جایی (move) پیاده‌سازی‌شده با روش copy-and-delete ممکن است نزد برخی ارائه‌دهندگان ذخیره‌سازی ابری مشمول هزینهٔ مضاعف شود.
.PP
هنگامی که \f[V]rclone config\f[R] را روی یک ریموت فعال اجرا کرده و قالب نام تکه‌ها را تغییر دهید، Chunker به‌طور خودکار تکه‌های موجود را تغییر نام نخواهد داد.
توجه داشته باشید که در نتیجهٔ این کار، ممکن است برخی از فایل‌هایی که پیش از تغییر به عنوان تکه شناسایی می‌شدند در فهرست دایرکتوری به عنوان فایل‌های عادی نمایش داده شوند و بالعکس.
همین هشدار برای اندازه تکه‌ها (chunk size) نیز برقرار است.
اگر تغییر تنظیمات حیاتی تکه‌تکه‌سازی ضرورت مبرم دارد، باید فرایند مهاجرت داده‌ها را طبق آنچه در بالا توضیح داده شد اجرا کنید.
.PP
اگر ریموت پوشش‌داده‌شده به بزرگی و کوچکی حروف حساس نباشد، لایهٔ chunker نیز این ویژگی را به ارث خواهد برد (بنابراین نمی‌توانید فایلی به نام \[dq]Hello.doc\[dq] و \[dq]hello.doc\[dq] را در یک دایرکتوری داشته باشید).
.PP
ابزار Chunker ارائه‌شده در نگارش‌های rclone تا \f[V]v1.54\f[R] گاهی ممکن است نتواند فراداده‌های تولیدشده توسط نگارش‌های اخیر rclone را تشخیص دهد.
توصیه می‌کنیم کاربران برای جلوگیری از آسیب دیدن داده‌ها، rclone را به‌روز نگه دارند.
.PP
تغییر \f[V]transactions\f[R] خطرناک است و به مهاجرت صریح داده‌ها نیاز دارد..SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص به chunker (تکه‌تکه کردن/تقسیم شفاف فایل‌های حجیم) آورده شده است.
.SS --chunker-remote
.PP
ریموتی که باید عمل تکه‌تکه کردن/یکپارچه‌سازی روی آن انجام شود.
.PP
به طور معمول باید شامل یک \[aq]:\[aq] و یک مسیر باشد، مانند
\[dq]myremote:path/to/dir\[dq]، \[dq]myremote:bucket\[dq] یا شاید
\[dq]myremote:\[dq] (توصیه نمی‌شود).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: remote
.IP \[bu] 2
متغیر محیطی: RCLONE_CHUNKER_REMOTE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: true
.SS --chunker-chunk-size
.PP
فایل‌های بزرگ‌تر از اندازه تکه (chunk size) به قطعات کوچک‌تر تقسیم خواهند شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_CHUNKER_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 2Gi
.SS --chunker-hash-type
.PP
انتخاب نحوه مدیریت مجموع هش (hash sum) توسط chunker.
.PP
تمام حالت‌ها به جز \[dq]none\[dq] نیازمند فراداده (metadata) هستند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hash_type
.IP \[bu] 2
متغیر محیطی: RCLONE_CHUNKER_HASH_TYPE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]md5\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]none\[dq]
.RS 2
.IP \[bu] 2
ارسال هر هشی که توسط ریموت بسته‌بندی‌شده (wrapped remote) برای فایل‌های تکه‌تکه‌نشده پشتیبانی می‌شود.
.IP \[bu] 2
در غیر این صورت چیزی برنمی‌گرداند.
.RE
.IP \[bu] 2
\[dq]md5\[dq]
.RS 2
.IP \[bu] 2
استفاده از MD5 برای فایل‌های ترکیبی.
.RE
.IP \[bu] 2
\[dq]sha1\[dq]
.RS 2
.IP \[bu] 2
استفاده از SHA1 برای فایل‌های ترکیبی.
.RE
.IP \[bu] 2
\[dq]md5all\[dq]
.RS 2
.IP \[bu] 2
استفاده از MD5 برای تمام فایل‌ها.
.RE
.IP \[bu] 2
\[dq]sha1all\[dq]
.RS 2
.IP \[bu] 2
استفاده از SHA1 برای تمام فایل‌ها.
.RE
.IP \[bu] 2
\[dq]md5quick\[dq]
.RS 2
.IP \[bu] 2
هنگام کپی کردن فایل به chunker، هش MD5 از مبدأ درخواست خواهد شد.
.IP \[bu] 2
در صورت عدم پشتیبانی، بازگشت به عنوان جایگزین به SHA1.
.RE
.IP \[bu] 2
\[dq]sha1quick\[dq]
.RS 2
.IP \[bu] 2
مشابه \[dq]md5quick\[dq]، اما ترجیح دادن SHA1 بر MD5.
.RE
.RE.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مختص chunker (تقسیم/تکه‌تکه کردن شفاف فایل‌های بزرگ) آورده شده است.
.SS --chunker-name-format
.PP
قالب رشته‌ای برای نام فایل‌های تکه.
.PP
دو جانگهدار عبارتند از: نام پایهٔ فایل (*) و شمارهٔ تکه (#...).
باید یک و تنها یک نویسهٔ ستاره و یک یا چند نویسهٔ هش متوالی وجود داشته باشد.
اگر شمارهٔ تکه ارقام کمتری از تعداد هش‌ها داشته باشد، از سمت چپ با صفر پر می‌شود.
اگر ارقام بیشتری در شماره وجود داشته باشد، همان‌طور که هست باقی می‌ماند.
فایل‌های تکهٔ احتمالی در صورتی که نامشان با قالب داده‌شده مطابقت نداشته باشد، نادیده گرفته می‌شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: name_format
.IP \[bu] 2
متغیر محیطی: RCLONE_CHUNKER_NAME_FORMAT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]*.rclone_chunk.###\[dq]
.SS --chunker-start-from
.PP
حداقل شمارهٔ معتبر تکه.
معمولاً 0 یا 1.
.PP
به‌طور پیش‌فرض شماره‌های تکه از 1 شروع می‌شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: start_from
.IP \[bu] 2
متغیر محیطی: RCLONE_CHUNKER_START_FROM
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 1
.SS --chunker-meta-format
.PP
قالب شیء فراداده یا \[dq]none\[dq].
.PP
به‌طور پیش‌فرض \[dq]simplejson\[dq].
فراداده یک فایل کوچک JSON است که هم‌نام فایل مرکب نام‌گذاری شده است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: meta_format
.IP \[bu] 2
متغیر محیطی: RCLONE_CHUNKER_META_FORMAT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]simplejson\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]none\[dq]
.RS 2
.IP \[bu] 2
اصلاً از فایل‌های فراداده استفاده نشود.
.IP \[bu] 2
نیازمند نوع هش \[dq]none\[dq] است.
.RE
.IP \[bu] 2
\[dq]simplejson\[dq]
.RS 2
.IP \[bu] 2
قالب ساده JSON از جمع‌های مقابله‌ای هش و اعتبارسنجی تکه‌ها پشتیبانی می‌کند.
.IP \[bu] 2
شامل فیلدهای زیر است: ver، size، nchunks، md5، sha1.
.RE
.RE
.SS --chunker-fail-hard
.PP
انتخاب نحوهٔ مدیریت فایل‌های با تکه‌های ناقص یا نامعتبر توسط chunker.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: fail_hard
.IP \[bu] 2
متغیر محیطی: RCLONE_CHUNKER_FAIL_HARD
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]true\[dq]
.RS 2
.IP \[bu] 2
گزارش خطاها و متوقف کردن دستور جاری.
.RE
.IP \[bu] 2
\[dq]false\[dq]
.RS 2
.IP \[bu] 2
هشدار به کاربر، رد کردن فایل ناقص و ادامه دادن فرآیند.
.RE
.RE.SS --chunker-transactions
.PP
انتخاب نحوه مدیریت فایل‌های موقت توسط chunker در حین تراکنش‌ها.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: transactions
.IP \[bu] 2
متغیر محیطی: RCLONE_CHUNKER_TRANSACTIONS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]rename\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]rename\[dq]
.RS 2
.IP \[bu] 2
تغییر نام فایل‌های موقت پس از یک تراکنش موفق.
.RE
.IP \[bu] 2
\[dq]norename\[dq]
.RS 2
.IP \[bu] 2
باقی گذاشتن نام فایل‌های موقت و ثبت شناسه تراکنش در فایل فراداده (metadata).
.IP \[bu] 2
وجود فراداده برای تراکنش‌های norename الزامی است (قالب متا نمی‌تواند
\[dq]none\[dq] باشد).
.IP \[bu] 2
اگر از تراکنش‌های norename استفاده می‌کنید باید مراقب باشید که Rclone را
تنزل ندهید
.IP \[bu] 2
زیرا نسخه‌های قدیمی‌تر Rclone از این روش تراکنش پشتیبانی نمی‌کنند و
.IP \[bu] 2
فایل‌های دستکاری‌شده با تراکنش‌های norename را اشتباه تفسیر خواهند کرد.
.IP \[bu] 2
این روش آزمایشی (EXPERIMENTAL) است، از آن در سیستم‌های محیط عملیاتی (production) استفاده نکنید.
.RE
.IP \[bu] 2
\[dq]auto\[dq]
.RS 2
.IP \[bu] 2
بسته به قابلیت‌های backend، از rename یا norename استفاده خواهد شد.
.IP \[bu] 2
اگر قالب متا بر روی \[dq]none\[dq] تنظیم شده باشد، همواره از تراکنش‌های rename
استفاده خواهد شد.
.IP \[bu] 2
این روش آزمایشی (EXPERIMENTAL) است، از آن در سیستم‌های محیط عملیاتی (production) استفاده نکنید.
.RE
.RE
.SS --chunker-description
.PP
توضیحات remote.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_CHUNKER_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SH Cloudinary
.PP
این یک backend برای پلتفرم Cloudinary (https://cloudinary.com) است
.SS "درباره Cloudinary"
.PP
سرویس Cloudinary (https://cloudinary.com) یک پلتفرم API تصویر و ویدیو است.
مورد اعتماد ۱٫۵ میلیون توسعه‌دهنده و ۱۰٬۰۰۰ سازمان و شرکت با رشد سریع
به‌عنوان بخشی حیاتی از پشته فناوری آن‌ها برای ارائه تجربه‌های بصری جذاب.
.SS "حساب‌ها و قیمت‌گذاری"
.PP
برای استفاده از این backend، باید یک حساب رایگان
(https://cloudinary.com/users/register_free) در Cloudinary بسازید.
با یک طرح رایگان با محدودیت‌های مصرف سخاوتمندانه شروع کنید.
سپس با گسترش نیازمندی‌هایتان، به طرحی که به بهترین شکل متناسب با نیازهای شماست
ارتقا دهید.
جزئیات قیمت‌گذاری (https://cloudinary.com/pricing) را مشاهده کنید..SS امن‌سازی اعتبارنامه‌ها (Securing Your Credentials)
.PP
لطفاً به
مستندات (https://rclone.org/docs/#configuration-encryption-cheatsheet) مراجعه کنید.
.SS پیکربندی (Configuration)
.PP
در اینجا مثالی از ایجاد پیکربندی Cloudinary آورده شده است.
.PP
ابتدا یک حساب کاربری در
cloudinary.com (https://cloudinary.com/users/register_free) ایجاد کرده و
یک طرح (plan) انتخاب کنید.
.PP
باید وارد حساب خود شوید و \f[V]API Key\f[R] و
\f[V]API Secret\f[R] حساب کاربری خود را از بخش توسعه‌دهندگان (developer) دریافت کنید.
.PP
اکنون اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
مراحل راه‌اندازی تعاملی را دنبال کنید:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter the name for the new remote.
name> cloudinary-media-library

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / cloudinary.com
\[rs] (cloudinary)
[snip]
Storage> cloudinary

Option cloud_name.
You can find your cloudinary.com cloud_name in your [dashboard](https://console.cloudinary.com/pm/developer-dashboard)
Enter a value.
cloud_name> ****************************

Option api_key.
You can find your cloudinary.com api key in your [dashboard](https://console.cloudinary.com/pm/developer-dashboard)
Enter a value.
api_key> ****************************

Option api_secret.
You can find your cloudinary.com api secret in your [dashboard](https://console.cloudinary.com/pm/developer-dashboard)
This value must be a single character, one of the following: y, g.
y/g> y
Enter a value.
api_secret> ****************************

Option upload_prefix.
[Upload prefix](https://cloudinary.com/documentation/cloudinary_sdks#configuration_parameters) to specify alternative data center
Enter a value.
upload_prefix>

Option upload_preset.
[Upload presets](https://cloudinary.com/documentation/upload_presets) can be defined for different upload profiles
Enter a value.
upload_preset>

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: cloudinary
- api_key: ****************************
- api_secret: ****************************
- cloud_name: ****************************
- upload_prefix:
- upload_preset:

Keep this \[dq]cloudinary-media-library\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح Media Library:
.IP
.nf
\f[C]
rclone lsd cloudinary-media-library:
\f[R]
.fi
.PP
ایجاد یک دایرکتوری جدید:
.IP
.nf
\f[C]
rclone mkdir cloudinary-media-library:directory
\f[R]
.fi
.PP
فهرست کردن محتویات یک دایرکتوری:
.IP
.nf
\f[C]
rclone ls cloudinary-media-library:directory
\f[R]
.fi.SS زمان تغییر و هش‌ها
.PP
سرویس Cloudinary برای هر عملیات Put موفقیت‌آمیز، مقادیر md5 و برچسب‌های زمانی را به‌طور خودکار و به‌صورت فقط‌خواندنی ذخیره می‌کند.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص cloudinary (Cloudinary) آورده شده است.
.SS --cloudinary-cloud-name
.PP
نام محیط در Cloudinary
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: cloud_name
.IP \[bu] 2
متغیر محیطی: RCLONE_CLOUDINARY_CLOUD_NAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: true
.SS --cloudinary-api-key
.PP
کلید API سرویس Cloudinary
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: api_key
.IP \[bu] 2
متغیر محیطی: RCLONE_CLOUDINARY_API_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: true
.SS --cloudinary-api-secret
.PP
راز API سرویس Cloudinary
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: api_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_CLOUDINARY_API_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: true
.SS --cloudinary-upload-prefix
.PP
تعیین نقطه پایانی API برای محیط‌های خارج از ایالات متحده
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_prefix
.IP \[bu] 2
متغیر محیطی: RCLONE_CLOUDINARY_UPLOAD_PREFIX
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --cloudinary-upload-preset
.PP
پیش‌تنظیم بارگذاری برای انتخاب نحوه دستکاری فایل‌ها هنگام بارگذاری
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_preset
.IP \[bu] 2
متغیر محیطی: RCLONE_CLOUDINARY_UPLOAD_PRESET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مختص cloudinary (Cloudinary) آورده شده است.
.SS --cloudinary-encoding
.PP
کدگذاری برای Backend.
.PP
برای اطلاعات بیشتر، بخش encoding را در نمای کلی
(https://rclone.org/overview/#encoding) مشاهده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_CLOUDINARY_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,LtGt,DoubleQuote,Question,Asterisk,Pipe,Hash,Percent,BackSlash,Del,Ctl,RightSpace,InvalidUtf8,Dot.SS --cloudinary-eventually-consistent-delay
.PP
مدت زمان N ثانیه برای دستیابی به سازگاری نهایی (eventual consistency) در پایگاه‌های داده‌ای که از عملیات backend پشتیبانی می‌کنند، منتظر می‌ماند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: eventually_consistent_delay
.IP \[bu] 2
متغیر محیطی: RCLONE_CLOUDINARY_EVENTUALLY_CONSISTENT_DELAY
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 0s
.SS --cloudinary-adjust-media-files-extensions
.PP
سرویس Cloudinary فرمت‌های رسانه را به عنوان یک صفتِ فایل مدیریت کرده و آن را از نام فایل حذف می‌کند، که برخلاف اکثر سامانه‌های فایل دیگر است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: adjust_media_files_extensions
.IP \[bu] 2
متغیر محیطی: RCLONE_CLOUDINARY_ADJUST_MEDIA_FILES_EXTENSIONS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --cloudinary-media-extensions
.PP
پسوندهای رسانه‌ای پشتیبانی‌شده در Cloudinary.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: media_extensions
.IP \[bu] 2
متغیر محیطی: RCLONE_CLOUDINARY_MEDIA_EXTENSIONS
.IP \[bu] 2
نوع: stringArray
.IP \[bu] 2
پیش‌فرض: [3ds 3g2 3gp ai arw avi avif bmp bw cr2 cr3 djvu dng eps3 fbx
flif flv gif glb gltf hdp heic heif ico indd jp2 jpe jpeg jpg jxl jxr
m2ts mov mp4 mpeg mts mxf obj ogv pdf ply png psd svg tga tif tiff ts
u3ma usdz wdp webm webp wmv]
.SS --cloudinary-description
.PP
توضیحات remote.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_CLOUDINARY_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SH "Citrix ShareFile"
.PP
سرویس Citrix ShareFile (https://sharefile.com) یک سرویس امن اشتراک‌گذاری و انتقال فایل است که برای کسب‌وکارها طراحی شده است.
.SS "پیکربندی (Configuration)"
.PP
راه‌اندازی اولیه Citrix ShareFile شامل دریافت یک توکن از Citrix ShareFile است که می‌توانید آن را در مرورگر خود دریافت کنید.
دستور \f[V]rclone config\f[R] شما را در این مراحل راهنمایی می‌کند.
.PP
در اینجا مثالی از نحوه ساخت یک remote به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی هدایت می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
XX / Citrix Sharefile
   \[rs] \[dq]sharefile\[dq]
Storage> sharefile
** See help for sharefile backend at: https://rclone.org/sharefile **

ID of the root folder

Leave blank to access \[dq]Personal Folders\[dq].  You can use one of the
standard values here or any folder ID (long hex number ID).
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / Access the Personal Folders. (Default)
   \[rs] \[dq]\[dq]
 2 / Access the Favorites folder.
   \[rs] \[dq]favorites\[dq]
 3 / Access all the shared folders.
   \[rs] \[dq]allshared\[dq]
 4 / Access all the individual connectors.
   \[rs] \[dq]connectors\[dq]
 5 / Access the home, favorites, and shared folders as well as the connectors.
   \[rs] \[dq]top\[dq]
root_folder_id> 
Edit advanced config? (y/n)
y) Yes
n) No
y/n> n
Remote config
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y) Yes
n) No
y/n> y
If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth?state=XXX
Log in and authorize rclone for access
Waiting for code...
Got code
Configuration complete.
Options:
- type: sharefile
- endpoint: https://XXX.sharefile.com
- token: {\[dq]access_token\[dq]:\[dq]XXX\[dq],\[dq]token_type\[dq]:\[dq]bearer\[dq],\[dq]refresh_token\[dq]:\[dq]XXX\[dq],\[dq]expiry\[dq]:\[dq]2019-09-30T19:41:45.878561877+01:00\[dq]}
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
برای نحوه راه‌اندازی آن روی دستگاهی بدون دسترسی به مرورگر وبِ متصل به اینترنت، مستندات راه‌اندازی remote (https://rclone.org/remote_setup) را ببینید.
.PP
توجه داشته باشید که rclone یک وب‌سرور روی دستگاه محلی شما اجرا می‌کند تا توکن بازگردانده شده از Citrix ShareFile را دریافت کند.
این وب‌سرور فقط از لحظه باز کردن مرورگر تا زمان دریافت کد تأیید اجرا می‌شود.
این سرویس روی \f[V]http://127.0.0.1:53682\f[R] قرار دارد و در صورت استفاده از فایروال میزبان، ممکن است لازم باشد آن را موقتاً باز کنید.
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (به جای \f[V]remote\f[R]، نامی را که به remote خود داده‌اید بگذارید):
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح ShareFile شما
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در ShareFile شما
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به دایرکتوری ShareFile با نام backup
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi
.PP
مسیرها می‌توانند تا هر عمقی که نیاز است ایجاد شوند، مانند \f[V]remote:directory/subdirectory\f[R]..SS زمان‌های تغییر و هش‌ها
.PP
سرویس ShareFile اجازه می‌دهد زمان‌های تغییر (modification times) روی اشیاء با دقت ۱ ثانیه تنظیم شوند.
از این زمان‌ها برای تشخیص این‌که آیا اشیاء نیاز به همگام‌سازی دارند یا خیر استفاده می‌شود.
.PP
سرویس ShareFile از هش‌های نوع MD5 پشتیبانی می‌کند، بنابراین می‌توانید از پرچم
\f[V]--checksum\f[R] استفاده کنید.
.SS انتقال‌ها
.PP
برای فایل‌های بزرگ‌تر از 128 MiB، ابزار rclone از انتقال چندتکه‌ای (chunked transfer) استفاده خواهد کرد.
ابزار rclone تا سقف \f[V]--transfers\f[R] تکه را به طور هم‌زمان بارگذاری می‌کند
(که بین تمام بارگذاری‌های چندبخشی به اشتراک گذاشته می‌شود).
تکه‌ها در حافظه بافر می‌شوند و معمولاً 64 MiB هستند، بنابراین افزایش
\f[V]--transfers\f[R] مصرف حافظه را افزایش خواهد داد.
.SS نویسه‌های غیرمجاز در نام فایل
.PP
علاوه بر مجموعه‌نویسه‌های محدودشده پیش‌فرض
(https://rclone.org/overview/#restricted-characters)، نویسه‌های
زیر نیز جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
T{
*
T}@T{
0x2A
T}@T{
＊
T}
T{
<
T}@T{
0x3C
T}@T{
＜
T}
T{
>
T}@T{
0x3E
T}@T{
＞
T}
T{
?
T}@T{
0x3F
T}@T{
؟
T}
T{
:
T}@T{
0x3A
T}@T{
：
T}
T{
|
T}@T{
0x7C
T}@T{
｜
T}
T{
\[dq]
T}@T{
0x22
T}@T{
＂
T}
.TE
.PP
همچنین نام‌های فایل نمی‌توانند با نویسه‌های زیر شروع شده یا پایان یابند.
این نویسه‌ها تنها در صورتی جایگزین می‌شوند که اولین یا آخرین نویسه در
نام باشند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
SP
T}@T{
0x20
T}@T{
␠
T}
T{
\&.
T}@T{
0x2E
T}@T{
．
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند
شد (https://rclone.org/overview/#invalid-utf8)، زیرا نمی‌توان از آن‌ها
در رشته‌های JSON استفاده کرد..SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص sharefile (Citrix Sharefile) آورده شده است.
.SS --sharefile-client-id
.PP
شناسه کلاینت OAuth.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_SHAREFILE_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sharefile-client-secret
.PP
کلید محرمانه کلاینت OAuth.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_SHAREFILE_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sharefile-root-folder-id
.PP
شناسه پوشه ریشه.
.PP
برای دسترسی به \[dq]Personal Folders\[dq] خالی بگذارید.
می‌توانید از یکی از مقادیر استاندارد در اینجا یا هر شناسه پوشه‌ای (شناسه عددی هگزادسیمال طولانی) استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_folder_id
.IP \[bu] 2
متغیر محیطی: RCLONE_SHAREFILE_ROOT_FOLDER_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
دسترسی به Personal Folders (پیش‌فرض).
.RE
.IP \[bu] 2
\[dq]favorites\[dq]
.RS 2
.IP \[bu] 2
دسترسی به پوشه Favorites (برگزیده‌ها).
.RE
.IP \[bu] 2
\[dq]allshared\[dq]
.RS 2
.IP \[bu] 2
دسترسی به تمام پوشه‌های هم‌رسانی‌شده.
.RE
.IP \[bu] 2
\[dq]connectors\[dq]
.RS 2
.IP \[bu] 2
دسترسی به تمام متصل‌کننده‌های (connectors) جداگانه.
.RE
.IP \[bu] 2
\[dq]top\[dq]
.RS 2
.IP \[bu] 2
دسترسی به پوشه‌های خانه (home)، برگزیده‌ها، و هم‌رسانی‌شده و همچنین متصل‌کننده‌ها.
.RE
.RE.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مربوط به sharefile (Citrix Sharefile) آورده شده است.
.SS --sharefile-token
.PP
توکن دسترسی OAuth به‌صورت یک JSON blob.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_SHAREFILE_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sharefile-auth-url
.PP
نشانی اینترنتی (URL) سرور احراز هویت.
.PP
جهت استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_SHAREFILE_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sharefile-token-url
.PP
نشانی اینترنتی (URL) سرور توکن.
.PP
جهت استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_SHAREFILE_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sharefile-client-credentials
.PP
استفاده از جریان OAuth اعتبارسنجی کلاینت (client credentials).
.PP
این گزینه از جریان Client Credentials در OAUTH2 مطابق با RFC
6749 استفاده می‌کند.
.PP
توجه داشته باشید که این گزینه توسط همه پشتوانه‌ها (backends) پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_SHAREFILE_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --sharefile-upload-cutoff
.PP
حد آستانه برای جابجایی به بارگذاری چندبخشی (multipart upload).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_SHAREFILE_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 128Mi
.SS --sharefile-chunk-size
.PP
اندازه تکه‌های بارگذاری.
.PP
باید توانی از ۲ و بزرگ‌تر یا مساوی 256k باشد (>= 256k).
.PP
بزرگ‌تر کردن این مقدار کارایی را بهبود می‌بخشد، اما توجه داشته باشید که هر تکه
به ازای هر انتقال در حافظه بافر می‌شود.
.PP
کاهش دادن این مقدار مصرف حافظه را کاهش می‌دهد اما کارایی را کم می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_SHAREFILE_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 64Mi.SS --sharefile-endpoint
.PP
نقطه پایانی (Endpoint) برای فراخوانی‌های API.
.PP
این مقدار معمولاً به عنوان بخشی از فرایند oauth به صورت خودکار شناسایی می‌شود، اما می‌توان آن را به صورت دستی روی مقداری مانند https://XXX.sharefile.com تنظیم کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_SHAREFILE_ENDPOINT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sharefile-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر، بخش کدگذاری را در نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_SHAREFILE_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Ctl,LeftSpace,LeftPeriod,RightSpace,RightPeriod,InvalidUtf8,Dot
.SS --sharefile-description
.PP
شرح remote.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_SHAREFILE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS "محدودیت‌ها (Limitations)"
.PP
توجه داشته باشید که ShareFile به حروف بزرگ و کوچک حساس نیست (case insensitive)، بنابراین نمی‌توانید هم‌زمان فایلی به نام \[dq]Hello.doc\[dq] و فایلی به نام \[dq]hello.doc\[dq] داشته باشید.
.PP
سامانه ShareFile تنها از نام فایل‌هایی با حداکثر ۲۵۶ نویسه طول پشتیبانی می‌کند.
.PP
دستور \f[V]rclone about\f[R] توسط backend سیتریکس ShareFile پشتیبانی نمی‌شود. پایگاه‌های پشتیبان بدون این قابلیت نمی‌توانند فضای آزاد را برای rclone mount تعیین کنند یا از سیاست \f[V]mfs\f[R] (بیشترین فضای خالی) به عنوان عضوی از یک remote از نوع rclone union بهره ببرند.
.PP
فهرست backendهایی که از rclone about پشتیبانی نمی‌کنند (https://rclone.org/overview/#optional-features) و rclone about (https://rclone.org/commands/rclone_about) را ببینید.
.SH "رمزنگاری (Crypt)"
.PP
ریموت‌های \f[V]crypt\f[R] در rclone سایر remoteها را رمزنگاری و رمزگشایی می‌کنند.
.PP
یک remote از نوع \f[V]crypt\f[R] مستقیماً به یک سامانه ذخیره‌سازی (https://rclone.org/overview) دسترسی پیدا نمی‌کند، بلکه remote دیگری را پوشش می‌دهد که آن هم به نوبه خود به سامانه ذخیره‌سازی دسترسی دارد.
این سازوکار شبیه به نحوه کارکرد alias (https://rclone.org/alias)، union (https://rclone.org/union)، chunker (https://rclone.org/chunker) و چند مورد دیگر است.
این امر کاربرد آن را بسیار انعطاف‌پذیر می‌سازد، چرا که می‌توانید یک لایه، در این مورد یک لایه رمزنگاری، بر روی هر backend دیگری، حتی در چندین لایه، اضافه کنید.
قابلیت‌های rclone مانند هر remote دیگری قابل استفاده هستند، برای نمونه می‌توانید یک remote از نوع crypt را سوار (mount) کنید (https://rclone.org/commands/rclone_mount).
.PP
دسترسی به یک سامانه ذخیره‌سازی از طریق یک remote از نوع crypt، رمزنگاری سمت کلاینت را محقق می‌سازد؛ این کار نگهداری داده‌ها را در مکانی که اطمینان ندارید به خطر نخواهد افتاد، امن می‌کند.
هنگام کار با remote از نوع \f[V]crypt\f[R]، نرم‌افزار rclone به صورت خودکار در هنگام نیاز و در لحظه (on the fly)، داده‌ها را روی سامانه محلی شما (پیش از بارگذاری) رمزنگاری و (پس از بارگیری) رمزگشایی می‌کند و داده‌ها را در حالت سکون در remote بسته‌بندی‌شده به صورت رمزگذاری‌شده باقی می‌گذارد.
اگر با استفاده از برنامه‌ای به جز rclone به سامانه ذخیره‌سازی دسترسی پیدا کنید، یا با استفاده مستقیم از rclone به remote پوشش‌داده‌شده متصل شوید، هیچ‌گونه رمزنگاری/رمزگشایی انجام نخواهد شد: بارگیری محتوای موجود صرفاً قالب رمزشده (درهم‌ریخته) را به شما تحویل می‌دهد، و هر آنچه بارگذاری کنید رمزنگاری \f[I]نخواهد\f[R] شد.
.PP
رمزنگاری با یک الگوریتم کلید مخفی (که رمزنگاری کلید متقارن نیز نامیده می‌شود) انجام می‌گیرد، که در آن از یک گذرواژه (یا عبارت عبور) برای تولید کلید رمزنگاری واقعی استفاده می‌شود.
گذرواژه می‌تواند توسط کاربر وارد شود، یا می‌توانید انتخاب کنید که rclone آن را ایجاد کند.
این گذرواژه در فایل پیکربندی، به صورت اندکی مبهم‌شده ذخیره خواهد شد.
اگر در محیطی هستید که نمی‌توانید امنیت فایل پیکربندی خود را حفظ کنید، باید رمزنگاری پیکربندی (https://rclone.org/docs/#configuration-encryption) را به عنوان محافظ به کار ببرید.
تا زمانی که این فایل پیکربندی را در اختیار دارید، قادر خواهید بود داده‌های خود را رمزگشایی کنید.
بدون فایل پیکربندی نیز، تا زمانی که گذرواژه را به خاطر داشته باشید (یا آن را در مکانی امن نگه دارید)، می‌توانید پیکربندی را دوباره ایجاد کرده و به داده‌های موجود دسترسی پیدا کنید.
همچنین می‌توانید برای دسترسی به همان داده‌ها، یک remote متناظر در یک سامانه دیگر پیکربندی کنید.
برای راهنمایی درباره تغییر گذرواژه، بخش زیر را ببینید.
.PP
رمزنگاری از salt رمزشناختی (https://en.wikipedia.org/wiki/Salt_(cryptography)) برای جابه‌جایی کلید رمزنگاری استفاده می‌کند تا بتوان یک رشته یکسان را به روش‌های گوناگون رمزگذاری کرد.
هنگام پیکربندی remote از نوع crypt، وارد کردن salt یا واگذاری تولید یک salt یکتا به rclone اختیاری است.
در صورت عدم تعیین، rclone از یک رشته یکتای داخلی استفاده می‌کند.
معمولاً در علم رمزشناسی، salt همراه با محتوای رمزگذاری‌شده ذخیره می‌شود و کاربر نیازی به حفظ کردن آن ندارد.
در rclone وضعیت بدین صورت نیست، چرا که rclone هیچ‌گونه اطلاعات اضافی را بر روی remoteها ذخیره نمی‌کند.
استفاده از salt سفارشی در واقع مانند گذرواژه دومی است که باید به خاطر سپرده شود.
.PP
رمزنگاری محتوای فایل با استفاده از NaCl SecretBox (https://godoc.org/golang.org/x/crypto/nacl/secretbox)، مبتنی بر رمزنگار XSalsa20 و الگوریتم Poly1305 برای تضمین یکپارچگی انجام می‌شود.
نام‌ها (نام‌های فایل و دایرکتوری) نیز به صورت پیش‌فرض رمزگذاری می‌شوند، اما این کار پیامدهایی دارد و از این رو امکان غیرفعال کردن آن وجود دارد..SS "پیکربندی (Configuration)"
.PP
در اینجا مثالی از نحوهٔ ایجاد یک ریموت به نام \f[V]secret\f[R] آورده شده است.
.PP
برای استفاده از \f[V]crypt\f[R]، ابتدا ریموت زیرین را راه‌اندازی کنید.
دستورالعمل‌های \f[V]rclone config\f[R] را برای backend مورد نظر دنبال کنید.
.PP
پیش از پیکربندی ریموت crypt، بررسی کنید که ریموت زیرین به درستی کار می‌کند.
در این مثال، نام ریموت زیرین \f[V]remote\f[R] است.
ما یک مسیر \f[V]path\f[R] را درون این ریموت برای نگهداری محتوای رمزنگاری‌شده پیکربندی خواهیم کرد.
هر چیزی درون \f[V]remote:path\f[R] رمزنگاری خواهد شد و هر چیزی خارج از آن رمزنگاری نمی‌شود.
.PP
\f[V]crypt\f[R] را با استفاده از \f[V]rclone config\f[R] پیکربندی کنید.
در این مثال، ریموت \f[V]crypt\f[R] به نام \f[V]secret\f[R] نام‌گذاری شده تا از \f[V]remote\f[R] زیرین متمایز باشد.
.PP
پس از پایان کار، می‌توانید از ریموت crypt با نام \f[V]secret\f[R] دقیقاً مانند هر ریموت دیگری استفاده کنید؛ برای مثال:
\f[V]rclone copy D:\[rs]docs secret:\[rs]docs\f[R]، و rclone در صورت نیاز، رمزنگاری و رمزگشایی را در لحظه انجام می‌دهد.
اگر مستقیماً به ریموت پوشش‌یافتهٔ \f[V]remote:path\f[R] دسترسی پیدا کنید، رمزنگاری را دور خواهید زد؛ هر آنچه بخوانید به شکل رمزنگاری‌شده خواهد بود و هر آنچه بنویسید بدون رمزنگاری ذخیره می‌شود.
برای جلوگیری از مشکلات، بهتر است یک مسیر اختصاصی برای محتوای رمزنگاری‌شده پیکربندی کرده و منحصراً از طریق یک ریموت crypt به آن دسترسی داشته باشید.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> secret
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / Encrypt/Decrypt a remote
   \[rs] \[dq]crypt\[dq]
[snip]
Storage> crypt
** See help for crypt backend at: https://rclone.org/crypt **

Remote to encrypt/decrypt.
Normally should contain a \[aq]:\[aq] and a path, eg \[dq]myremote:path/to/dir\[dq],
\[dq]myremote:bucket\[dq] or maybe \[dq]myremote:\[dq] (not recommended).
Enter a string value. Press Enter for the default (\[dq]\[dq]).
remote> remote:path
How to encrypt the filenames.
Enter a string value. Press Enter for the default (\[dq]standard\[dq]).
Choose a number from below, or type in your own value.
   / Encrypt the filenames.
 1 | See the docs for the details.
   \[rs] \[dq]standard\[dq]
 2 / Very simple filename obfuscation.
   \[rs] \[dq]obfuscate\[dq]
   / Don\[aq]t encrypt the file names.
 3 | Adds a \[dq].bin\[dq] extension only.
   \[rs] \[dq]off\[dq]
filename_encryption>
Option to either encrypt directory names or leave them intact.

NB If filename_encryption is \[dq]off\[dq] then this option will do nothing.
Enter a boolean value (true or false). Press Enter for the default (\[dq]true\[dq]).
Choose a number from below, or type in your own value
 1 / Encrypt directory names.
   \[rs] \[dq]true\[dq]
 2 / Don\[aq]t encrypt directory names, leave them intact.
   \[rs] \[dq]false\[dq]
directory_name_encryption>
Password or pass phrase for encryption.
y) Yes type in my own password
g) Generate random password
y/g> y
Enter the password:
password:
Confirm the password:
password:
Password or pass phrase for salt. Optional but recommended.
Should be different to the previous password.
y) Yes type in my own password
g) Generate random password
n) No leave this optional password blank (default)
y/g/n> g
Password strength in bits.
64 is just about memorable
128 is secure
1024 is the maximum
Bits> 128
Your password is: JAsJvRcgR-_veXNfy_sGmQ
Use this password? Please note that an obscured version of this
password (and not the password itself) will be stored under your
configuration file, so keep this generated password in a safe place.
y) Yes (default)
n) No
y/n>
Edit advanced config? (y/n)
y) Yes
n) No (default)
y/n>
Remote config
--------------------
[secret]
type = crypt
remote = remote:path
password = *** ENCRYPTED ***
password2 = *** ENCRYPTED ***
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d>
\f[R]
.fi
.PP
\f[B]مهم\f[R] گذرواژهٔ crypt ذخیره‌شده در \f[V]rclone.conf\f[R] به صورت ساده مبهم‌سازی (obscured) شده است.
این کار تنها آن را در برابر بررسی‌های سطحی محافظت می‌کند.
این مورد امن نیست، مگر اینکه رمزنگاری پیکربندی (https://rclone.org/docs/#configuration-encryption) برای \f[V]rclone.conf\f[R] تعیین شده باشد.
.PP
استفاده از یک عبارت‌عبور طولانی توصیه می‌شود، یا این‌که \f[V]rclone config\f[R] می‌تواند یک عبارت تصادفی تولید کند.
.PP
گذرواژهٔ مبهم‌سازی‌شده با استفاده از AES-CTR با یک کلید ایستا (static key) ساخته می‌شود.
مقدار IV (nonce) عیناً در ابتدای گذرواژهٔ مبهم‌سازی‌شده ذخیره می‌شود.
این کلید ایستا میان تمامی نسخه‌های rclone مشترک است.
.PP
اگر rclone را با همان گذرواژه‌ها/عبارت‌های‌عبور در جای دیگری مجدداً پیکربندی کنید سازگار خواهد بود، اما نسخهٔ مبهم‌سازی‌شده به دلیل salt متفاوت، تفاوت خواهد داشت.
.PP
ابزار rclone موارد زیر را رمزنگاری نمی‌کند:
.IP \[bu] 2
طول فایل \- این مقدار در محدودهٔ 16 بایت قابل محاسبه است
.IP \[bu] 2
زمان تغییر \- برای همگام‌سازی استفاده می‌شود.SS تعیین ریموت (Specifying the remote)
.PP
هنگام پیکربندی ریموت برای رمزنگاری/رمزگشایی، می‌توانید هر رشته‌ای را که rclone به عنوان مبدأ/مقصد دستورهای دیگر می‌پذیرد، مشخص کنید.
.PP
مورد استفادهٔ اصلی، تعیین مسیر در یک ریموت از پیش پیکربندی‌شده است (مانند
\f[V]remote:path/to/dir\f[R] یا \f[V]remote:bucket\f[R])، به‌گونه‌ای که داده‌ها در یک مکان دوردست غیرقابل‌اعتماد به صورت رمزنگاری‌شده ذخیره شوند.
.PP
شما همچنین می‌توانید یک مسیر فایل‌سیستم محلی را مشخص کنید، مانند
\f[V]/path/to/dir\f[R] در لینوکس، یا \f[V]C:\[rs]path\[rs]to\[rs]dir\f[R] در
ویندوز.
با ایجاد یک ریموت crypt که به چنین مسیری در فایل‌سیستم محلی اشاره می‌کند، می‌توانید از rclone به عنوان ابزاری صرفاً برای رمزنگاری محلی فایل‌ها استفاده کنید، برای مثال جهت نگهداری فایل‌های رمزنگاری‌شده روی یک درایو USB جداشدنی.
.PP
\f[B]نکته\f[R]: رشته‌ای که فاقد \f[V]:\f[R] باشد، توسط rclone به عنوان یک مسیر نسبی در فایل‌سیستم محلی در نظر گرفته خواهد شد.
برای مثال، اگر نام \f[V]remote\f[R] را بدون \f[V]:\f[R] انتهایی وارد کنید، به عنوان یک زیردایرکتوری از دایرکتوری جاری با نام \[dq]remote\[dq] در نظر گرفته می‌شود.
.PP
اگر یک مسیر \f[V]remote:path/to/dir\f[R] مشخص شود، rclone فایل‌های رمزنگاری‌شده را در \f[V]path/to/dir\f[R] روی ریموت ذخیره می‌کند.
با فعال بودن رمزنگاری نام فایل، فایل‌های ذخیره‌شده در
\f[V]secret:subdir/subfile\f[R] در مسیر رمزنگاری‌نشدهٔ
\f[V]path/to/dir\f[R] ذخیره می‌شوند، اما جزء \f[V]subdir/subpath\f[R]
رمزنگاری می‌گردد.
.PP
مسیری که مشخص می‌کنید الزامی به وجود داشتن ندارد؛ rclone در صورت نیاز آن را ایجاد خواهد کرد.
.PP
اگر قصد دارید از ریموت پوشش‌داده‌شده (wrapped remote) هم مستقیماً برای نگهداری محتوای رمزنگاری‌نشده و هم از طریق یک ریموت crypt برای محتوای رمزنگاری‌شده استفاده کنید، توصیه می‌شود ریموت crypt را به دایرکتوری مجزایی درون ریموت پوشش‌داده‌شده ارجاع دهید.
اگر از یک سیستم ذخیره‌سازی مبتنی بر باکت استفاده می‌کنید (مانند
Swift، S3، Google Compute Storage، B2)، به‌طور کلی توصیه می‌شود ریموت crypt را روی یک باکت خاص اعمال کنید (\f[V]s3:bucket\f[R]).
در صورتی که آن را روی ریشهٔ کامل فضای ذخیره‌سازی (\f[V]s3:\f[R]) اعمال کرده و از رمزنگاری اختیاری نام فایل استفاده کنید، rclone نام باکت را نیز رمزنگاری خواهد کرد.
.SS تغییر گذرواژه (Changing password)
.PP
در صورتی که گذرواژه، یا فایل پیکربندی حاوی شکل اندکی مبهم‌شدهٔ گذرواژه، افشا شده یا به خطر بیفتد، باید داده‌های خود را با یک گذرواژهٔ جدید مجدداً رمزنگاری کنید.
از آنجا که rclone از رمزنگاری با کلید مخفی استفاده می‌کند، که در آن کلید رمزنگاری مستقیماً از گذرواژهٔ نگهداری‌شده روی کلاینت تولید می‌شود، امکان تغییر گذرواژه/کلید داده‌هایی که پیش‌تر رمزنگاری شده‌اند وجود ندارد.
صرفاً تغییر دادن گذرواژهٔ پیکربندی‌شده برای یک ریموت crypt موجود بدان معناست که دیگر قادر به رمزگشایی هیچ‌یک از محتواهای قبلاً رمزنگاری‌شده نخواهید بود.
تنها راهکار ممکن این است که همه چیز را از طریق یک ریموت crypt که با گذرواژهٔ جدیدتان پیکربندی شده است، مجدداً بارگذاری کنید.
.PP
بسته به حجم داده‌ها، پهنای باند، سهمیهٔ ذخیره‌سازی و موارد دیگر، رویکردهای متفاوتی وجود دارد که می‌توانید اتخاذ کنید:
.IP \[bu] 2
اگر همه چیز را در مکانی دیگر دارید، برای مثال روی سیستم محلی خود، می‌توانید تمامی فایل‌های رمزنگاری‌شدهٔ پیشین را حذف کنید، گذرواژهٔ ریموت crypt پیکربندی‌شدهٔ خود را تغییر دهید (یا پیکربندی crypt را حذف کرده و مجدداً بسازید)، و سپس همه چیز را از آن مکان دیگر دوباره بارگذاری نمایید.
.IP \[bu] 2
اگر فضای کافی روی سیستم ذخیره‌سازی دارید، می‌توانید یک ریموت crypt جدید بسازید که به دایرکتوری مجزایی روی همان backend اشاره کند، و سپس با استفاده از rclone همه‌چیز را از ریموت crypt اصلی به ریموت جدید کپی کنید؛ با این کار عملاً همه چیز در حین انتقال با گذرواژهٔ قدیمی رمزگشایی شده و با گذرواژهٔ جدید مجدداً رمزنگاری می‌شود.
پس از پایان کار، دایرکتوری ریموت crypt اصلی و در نهایت پیکربندی rclone crypt مربوط به گذرواژهٔ پیشین را حذف کنید.
همهٔ داده‌ها از سیستم ذخیره‌سازی دریافت شده و مجدداً به آن ارسال می‌شوند، بنابراین پهنای باند شما نصف خواهد شد و اگر در سیستم ذخیره‌سازی سهمیهٔ بارگذاری و بارگیری دارید، دو برابر محاسبه می‌شود.
.PP
\f[B]نکته\f[R]: یک مشکل امنیتی در رابطه با تولیدکنندهٔ تصادفی گذرواژه در نگارش 1.53.3 از rclone (منتشرشده در 2020-11-19) برطرف شده است.
گذرواژه‌های تولیدشده توسط rclone config در نگارش 1.49.0 (منتشرشده در 2019-08-26) تا 1.53.2 (منتشرشده در 2020-10-26) امن در نظر گرفته نمی‌شوند و باید تغییر یابند.
اگر گذرواژه‌تان را خودتان تعیین کرده‌اید، یا برای ایجاد آن از نگارش‌های قدیمی‌تر از 1.49.0 یا جدیدتر از 1.53.2 از rclone استفاده کرده‌اید، شما تحت تأثیر این مشکل \f[I]نیستید\f[R].
برای جزئیات بیشتر و دریافت ابزاری جهت بررسی اینکه آیا تحت تأثیر قرار گرفته‌اید یا خیر، گزارش شمارهٔ #4783 (https://github.com/rclone/rclone/issues/4783) را ببینید..SS "مثال (Example)"
.PP
ساختار فایل زیر را با استفاده از رمزنگاری نام فایل \[dq]standard\[dq] ایجاد کنید.
.IP
.nf
\f[C]
plaintext/
├── file0.txt
├── file1.txt
└── subdir
    ├── file2.txt
    ├── file3.txt
    └── subsubdir
        └── file4.txt
\f[R]
.fi
.PP
این‌ها را به ریموت کپی کرده و فهرست کنید
.IP
.nf
\f[C]
$ rclone -q copy plaintext secret:
$ rclone -q ls secret:
        7 file1.txt
        6 file0.txt
        8 subdir/file2.txt
       10 subdir/subsubdir/file4.txt
        9 subdir/file3.txt
\f[R]
.fi
.PP
ریموت crypt به این صورت دیده می‌شود
.IP
.nf
\f[C]
$ rclone -q ls remote:path
       55 hagjclgavj2mbiqm6u6cnjjqcg
       54 v05749mltvv1tf4onltun46gls
       57 86vhrsv86mpbtd3a0akjuqslj8/dlj7fkq4kdq72emafg7a7s41uo
       58 86vhrsv86mpbtd3a0akjuqslj8/7uu829995du6o42n32otfhjqp4/b9pausrfansjth5ob3jkdqd4lc
       56 86vhrsv86mpbtd3a0akjuqslj8/8njh1sk437gttmep3p70g81aps
\f[R]
.fi
.PP
ساختار دایرکتوری حفظ می‌شود
.IP
.nf
\f[C]
$ rclone -q ls secret:subdir
        8 file2.txt
        9 file3.txt
       10 subsubdir/file4.txt
\f[R]
.fi
.PP
بدون رمزنگاری نام فایل، پسوندهای \f[V].bin\f[R] به نام‌های اصلی اضافه می‌شوند.
این امر مانع از تلاش ارائه‌دهنده فضای ابری برای تفسیر محتوای فایل می‌شود.
.IP
.nf
\f[C]
$ rclone -q ls remote:path
       54 file0.txt.bin
       57 subdir/file3.txt.bin
       56 subdir/file2.txt.bin
       58 subdir/subsubdir/file4.txt.bin
       55 file1.txt.bin
\f[R]
.fi
.SS "حالت‌های رمزنگاری نام فایل (File name encryption modes)"
.PP
Off
.IP \[bu] 2
نام‌های فایل یا ساختار دایرکتوری را پنهان نمی‌کند
.IP \[bu] 2
امکان استفاده از نام‌های فایل طولانی‌تر را فراهم می‌کند (\[ti]246 نویسه)
.IP \[bu] 2
می‌تواند از زیرمسیرها استفاده کرده و تک‌فایل‌ها را کپی کند
.PP
Standard
.IP \[bu] 2
نام‌های فایل رمزنگاری می‌شوند
.IP \[bu] 2
نام‌های فایل نمی‌توانند خیلی طولانی باشند (\[ti]143 نویسه)
.IP \[bu] 2
می‌تواند از زیرمسیرها استفاده کرده و تک‌فایل‌ها را کپی کند
.IP \[bu] 2
ساختار دایرکتوری نمایان است
.IP \[bu] 2
نام‌های فایل یکسان دارای نام‌های بارگذاری‌شده یکسانی خواهند بود
.IP \[bu] 2
می‌تواند از میانبرها برای کوتاه‌کردن بازگشت دایرکتوری استفاده کند
.PP
Obfuscation
.PP
این یک چرخش (\[dq]rotate\[dq]) ساده روی نام فایل است که در آن هر فایل دارای یک فاصله rot بر اساس نام فایل است.
Rclone این فاصله را در ابتدای نام فایل ذخیره می‌کند.
فایلی با نام \[dq]hello\[dq] ممکن است تبدیل به \[dq]53.jgnnq\[dq] شود.
.PP
حالت Obfuscation (مبهم‌سازی) یک رمزنگاری قوی برای نام فایل‌ها نیست، اما مانع از آن می‌شود که ابزارهای پویش خودکار متوجه الگوهای نام فایل شوند.
این حالت یک حد واسط میان \[dq]off\[dq] و \[dq]standard\[dq] است که امکان استفاده از نام‌های طولانی‌تر را در بخش‌های مسیر فراهم می‌آورد.
.PP
در مورد برخی از نام‌های فایل مبتنی بر یونیکد این احتمال وجود دارد که مبهم‌سازی ضعیف عمل کرده و نویسه‌های کوچک را به معادل‌های بزرگ آن‌ها نگاشت کند.
.PP
برای محافظت قوی نمی‌توان به Obfuscation اتکا کرد.
.IP \[bu] 2
نام‌های فایل بسیار خفیف مبهم‌سازی می‌شوند
.IP \[bu] 2
نام‌های فایل می‌توانند طولانی‌تر از رمزنگاری استاندارد باشند
.IP \[bu] 2
می‌تواند از زیرمسیرها استفاده کرده و تک‌فایل‌ها را کپی کند
.IP \[bu] 2
ساختار دایرکتوری نمایان است
.IP \[bu] 2
نام‌های فایل یکسان دارای نام‌های بارگذاری‌شده یکسانی خواهند بود
.PP
سیستم‌های ذخیره‌سازی ابری دارای محدودیت‌هایی در طول نام فایل و طول کل مسیر هستند که rclone در صورت استفاده از رمزنگاری نام فایل \[dq]Standard\[dq] با احتمال بیشتری از آن‌ها فراتر می‌رود.
در مواردی که طول نام فایل‌ها ۱۴۳ نویسه یا کمتر باشد، بدون در نظر گرفتن ارائه‌دهنده فضای ابری، نباید مشکلی رخ دهد.
.PP
یک گزینه پیشرفته آزمایشی با نام \f[V]filename_encoding\f[R] اکنون برای برطرف کردن این مشکل تا حدی ارائه شده است.
برای سامانه‌های ذخیره‌سازی ابری با نام‌های فایل حساس به حروف بزرگ و کوچک (مانند Google Drive)، می‌توان از \f[V]base64\f[R] برای کاهش طول نام فایل استفاده کرد.
برای سیستم‌های ذخیره‌سازی ابری که به صورت داخلی از UTF-16 برای ذخیره نام فایل‌ها استفاده می‌کنند (مانند OneDrive، Dropbox، Box)، می‌توان از \f[V]base32768\f[R] برای کاهش چشمگیر طول نام فایل استفاده نمود.
.PP
یک حالت رمزنگاری جایگزین برای نام فایل در آینده rclone ممکن است محدودیت‌های طول مسیر ارائه‌دهنده پشتیبان (backend) را تاب بیاورد..SS رمزنگاری نام دایرکتوری (Directory name encryption)
.PP
ابزار Crypt گزینه رمزنگاری نام‌های دایرکتوری یا دست‌نخورده باقی گذاشتن آن‌ها را ارائه می‌دهد.
دو گزینه وجود دارد:
.PP
True
.PP
کل مسیر فایل شامل نام‌های دایرکتوری را رمزنگاری می‌کند. مثال:
\f[V]1/12/123.txt\f[R] به این صورت رمزنگاری می‌شود:
\f[V]p0e52nreeaj0a5ea7s64m4j72s/l42g6771hnv3an9cgc8cr2n1ng/qgm4avr35m5loi1th53ato71v0\f[R]
.PP
False
.PP
تنها نام فایل‌ها را رمزنگاری کرده و از نام دایرکتوری‌ها صرف‌نظر می‌کند. مثال:
\f[V]1/12/123.txt\f[R] به این صورت رمزنگاری می‌شود:
\f[V]1/12/qgm4avr35m5loi1th53ato71v0\f[R]
.SS زمان‌های تغییر و هش‌ها (Modification times and hashes)
.PP
ابزار Crypt زمان‌های تغییر را با استفاده از ریموت زیرین ذخیره می‌کند، بنابراین پشتیبانی از آن به ریموت وابسته است.
.PP
هش‌ها برای crypt ذخیره نمی‌شوند.
با این حال، یکپارچگی داده‌ها توسط یک اعتبارسنج رمزشناختی بسیار قوی محافظت می‌شود.
.PP
برای بررسی یکپارچگی یک ریموت رمزنگاری‌شده، به جای دستور \f[V]rclone check\f[R] که نمی‌تواند چِک‌سام‌ها را به‌درستی بررسی کند، از دستور \f[V]rclone cryptcheck\f[R] استفاده کنید.
.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مخصوص به crypt (رمزنگاری/رمزگشایی یک ریموت) آورده شده است.
.SS --crypt-remote
.PP
ریموت مورد نظر جهت رمزنگاری/رمزگشایی.
.PP
به‌طور معمول باید شامل یک \[aq]:\[aq] و یک مسیر باشد، مانند
\[dq]myremote:path/to/dir\[dq]، \[dq]myremote:bucket\[dq] یا احتمالاً
\[dq]myremote:\[dq] (توصیه نمی‌شود).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: remote
.IP \[bu] 2
متغیر محیطی: RCLONE_CRYPT_REMOTE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --crypt-filename-encryption
.PP
نحوه رمزنگاری نام‌ فایل‌ها.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: filename_encryption
.IP \[bu] 2
متغیر محیطی: RCLONE_CRYPT_FILENAME_ENCRYPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]standard\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]standard\[dq]
.RS 2
.IP \[bu] 2
رمزنگاری نام فایل‌ها.
.IP \[bu] 2
برای جزئیات بیشتر به مستندات مراجعه کنید.
.RE
.IP \[bu] 2
\[dq]obfuscate\[dq]
.RS 2
.IP \[bu] 2
مبهم‌سازی بسیار ساده نام فایل.
.RE
.IP \[bu] 2
\[dq]off\[dq]
.RS 2
.IP \[bu] 2
نام فایل‌ها را رمزنگاری نمی‌کند.
.IP \[bu] 2
تنها یک پسوند \[dq].bin\[dq] یا \[dq]suffix\[dq] اضافه می‌کند.
.RE
.RE.SS --crypt-directory-name-encryption
.PP
گزینه‌ای برای رمزگذاری نام‌های دایرکتوری یا دست‌نخورده باقی گذاشتن آن‌ها.
.PP
توجه: اگر filename_encryption برابر با \[dq]off\[dq] باشد، این گزینه هیچ کاری انجام نخواهد داد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: directory_name_encryption
.IP \[bu] 2
متغیر محیطی: RCLONE_CRYPT_DIRECTORY_NAME_ENCRYPTION
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]true\[dq]
.RS 2
.IP \[bu] 2
رمزگذاری نام‌های دایرکتوری.
.RE
.IP \[bu] 2
\[dq]false\[dq]
.RS 2
.IP \[bu] 2
نام‌های دایرکتوری را رمزگذاری نکن، آن‌ها را دست‌نخورده باقی بگذار.
.RE
.RE
.SS --crypt-password
.PP
گذرواژه یا عبارت عبور برای رمزگذاری.
.PP
\f[B]توجه:\f[R] ورودی این گزینه باید مبهم‌سازی شود \- به rclone obscure (https://rclone.org/commands/rclone_obscure) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: password
.IP \[bu] 2
متغیر محیطی: RCLONE_CRYPT_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --crypt-password2
.PP
گذرواژه یا عبارت عبور برای سالت (salt).
.PP
اختیاری است اما توصیه می‌شود.
باید با گذرواژه قبلی متفاوت باشد.
.PP
\f[B]توجه:\f[R] ورودی این گزینه باید مبهم‌سازی شود \- به rclone obscure (https://rclone.org/commands/rclone_obscure) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: password2
.IP \[bu] 2
متغیر محیطی: RCLONE_CRYPT_PASSWORD2
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS "گزینه‌های پیشرفته (Advanced options)"
.PP
در اینجا گزینه‌های پیشرفته مختص به crypt (رمزگذاری/رمزگشایی یک ریموت) آورده شده است.
.SS --crypt-server-side-across-configs
.PP
منسوخ‌شده: به‌جای آن از \-\-server\-side\-across\-configs استفاده کنید.
.PP
به عملیات‌های سمت سرور (مانند copy) اجازه می‌دهد تا میان پیکربندی‌های مختلف crypt عمل کنند.
.PP
معمولاً این گزینه چیزی نیست که بخواهید، اما اگر دو ریموت crypt دارید که به یک بک‌اند یکسان اشاره می‌کنند، می‌توانید از آن استفاده کنید.
.PP
این گزینه می‌تواند برای نمونه برای تغییر نوع رمزگذاری نام فایل بدون بارگذاری مجدد تمام داده‌ها به کار رود.
تنها کافی است دو بک‌اند crypt ایجاد کنید که با همان یک پارامتر تغییریافته به دو دایرکتوری مختلف اشاره کنند و از rclone move برای جابه‌جایی فایل‌ها میان ریموت‌های crypt استفاده نمایید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: server_side_across_configs
.IP \[bu] 2
متغیر محیطی: RCLONE_CRYPT_SERVER_SIDE_ACROSS_CONFIGS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --crypt-show-mapping
.PP
برای تمامی فایل‌های فهرست‌شده، نحوه رمزگذاری نام‌ها را نشان می‌دهد.
.PP
اگر این پرچم تنظیم شود، برای هر فایلی که از ریموت درخواست فهرست شدن آن داده می‌شود، یک خط (در سطح INFO) حاوی نام رمزگشایی‌شده و نام رمزگذاری‌شده فایل ثبت خواهد شد.
.PP
این قابلیت به شما امکان می‌دهد تشخیص دهید کدام نام‌های رمزگذاری‌شده متعلق به چه نام‌های رمزگشایی‌شده‌ای هستند؛ مناسب برای زمان‌هایی که نیاز است با نام‌های رمزگذاری‌شده فایل‌ها کاری انجام دهید یا جهت اهداف اشکال‌زدایی.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: show_mapping
.IP \[bu] 2
متغیر محیطی: RCLONE_CRYPT_SHOW_MAPPING
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --crypt-no-data-encryption
.PP
گزینه‌ای برای رمزگذاری داده‌های فایل یا باقی گذاشتن آن‌ها به صورت رمزگذاری‌نشده.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_data_encryption
.IP \[bu] 2
متغیر محیطی: RCLONE_CRYPT_NO_DATA_ENCRYPTION
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]true\[dq]
.RS 2
.IP \[bu] 2
داده‌های فایل رمزگذاری نشوند و رمزگذاری‌نشده باقی بمانند.
.RE
.IP \[bu] 2
\[dq]false\[dq]
.RS 2
.IP \[bu] 2
داده‌های فایل رمزگذاری شوند.
.RE
.RE
.SS --crypt-pass-bad-blocks
.PP
اگر تنظیم شود، بلوک‌های خراب را تماماً به‌صورت 0 رد می‌کند.
.PP
این گزینه نباید در شرایط عادی فعال باشد؛ بلکه تنها باید زمانی تنظیم شود که قصد بازیابی یک فایل رمزگذاری‌شده همراه با خطا را داشته باشید و بخواهید تا حد ممکن بخش‌های بیشتری از فایل را نجات دهید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pass_bad_blocks
.IP \[bu] 2
متغیر محیطی: RCLONE_CRYPT_PASS_BAD_BLOCKS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --crypt-strict-names
.PP
اگر تنظیم شود، هنگامی که crypt با نام فایلی برخورد کند که قابل رمزگشایی نیست، خطا ایجاد می‌کند.
.PP
(به‌طور پیش‌فرض، rclone صرفاً یک پیام NOTICE در لاگ ثبت کرده و روال عادی را ادامه می‌دهد.)
این وضعیت زمانی ممکن است پیش بیاید که فایل‌های رمزگذاری‌شده و رمزگذاری‌نشده در یک دایرکتوری نگه‌داری شوند (که توصیه نمی‌شود).
همچنین ممکن است نشان‌دهنده مشکلی جدی‌تر باشد که نیاز به بررسی دارد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: strict_names
.IP \[bu] 2
متغیر محیطی: RCLONE_CRYPT_STRICT_NAMES
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --crypt-filename-encoding
.PP
نحوه کدگذاری نام فایل رمزگذاری‌شده به یک رشته متنی.
.PP
این گزینه می‌تواند به کوتاه‌تر کردن نام فایل رمزگذاری‌شده کمک کند.
گزینه مناسب به نحوه محاسبه طول نام فایل توسط ریموت شما و حساس بودن آن به حروف بزرگ و کوچک بستگی دارد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: filename_encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_CRYPT_FILENAME_ENCODING
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]base32\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]base32\[dq]
.RS 2
.IP \[bu] 2
کدگذاری با استفاده از base32.
مناسب برای تمام ریموت‌ها.
.RE
.IP \[bu] 2
\[dq]base64\[dq]
.RS 2
.IP \[bu] 2
کدگذاری با استفاده از base64.
مناسب برای ریموت‌های حساس به حروف بزرگ و کوچک.
.RE
.IP \[bu] 2
\[dq]base32768\[dq]
.RS 2
.IP \[bu] 2
کدگذاری با استفاده از base32768.
مناسب در صورتی که ریموت شما UTF-16 یا
.IP \[bu] 2
نقطه کد یونیکد را به جای طول بایت‌های UTF-8 شمارش کند.
(مانند Onedrive، Dropbox)
.RE
.RE
.SS --crypt-suffix
.PP
در صورت تنظیم شدن، پسوند پیش‌فرض \[dq].bin\[dq] را جایگزین خواهد کرد.
.PP
تنظیم پسوند روی \[dq]none\[dq] منجر به یک پسوند خالی خواهد شد.
این مورد ممکن است زمانی که طول مسیر بحرانی است مفید باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: suffix
.IP \[bu] 2
متغیر محیطی: RCLONE_CRYPT_SUFFIX
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq].bin\[dq]
.SS --crypt-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_CRYPT_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS فراداده (Metadata)
.PP
هر فراداده‌ای که توسط ریموت زیرین پشتیبانی شود، خوانده و نوشته می‌شود.
.PP
برای اطلاعات بیشتر مستندات فراداده (https://rclone.org/docs/#metadata) را ببینید..SS دستورات backend
.PP
در اینجا دستورات مختص backend از نوع crypt آورده شده است.
.PP
آن‌ها را بدین صورت اجرا کنید:
.IP
.nf
\f[C]
rclone backend COMMAND remote:
\f[R]
.fi
.PP
راهنمای زیر توضیح می‌دهد که هر دستور چه آرگومان‌هایی می‌پذیرد.
.PP
برای اطلاعات بیشتر در مورد نحوه ارسال گزینه‌ها و آرگومان‌ها، دستور backend (https://rclone.org/commands/rclone_backend) را ببینید.
.PP
این موارد را می‌توان بر روی یک backend در حال اجرا با استفاده از دستور rc به صورت backend/command (https://rclone.org/rc/#backend-command) اجرا کرد.
.SS encode
.PP
کدگذاری نام فایل(های) داده‌شده.
.IP
.nf
\f[C]
rclone backend encode remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور نام فایل‌های داده‌شده به عنوان آرگومان را کدگذاری کرده و فهرستی از رشته‌های نتایج کدگذاری‌شده را بازمی‌گرداند.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend encode crypt: file1 [file2...]
rclone rc backend/command command=encode fs=crypt: file1 [file2...]
\f[R]
.fi
.SS decode
.PP
رمزگشایی نام فایل(های) داده‌شده.
.IP
.nf
\f[C]
rclone backend decode remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور نام فایل‌های داده‌شده به عنوان آرگومان را رمزگشایی کرده و فهرستی از رشته‌های نتایج رمزگشایی‌شده را بازمی‌گرداند.
اگر هر یک از ورودی‌ها نامعتبر باشد، خطایی بازگردانده خواهد شد.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend decode crypt: encryptedfile1 [encryptedfile2...]
rclone rc backend/command command=decode fs=crypt: encryptedfile1 [encryptedfile2...]
\f[R]
.fi
.SS پشتیبان‌گیری از یک remote رمزنگاری‌شده
.PP
اگر مایلید از یک remote رمزنگاری‌شده پشتیبان بگیرید، توصیه می‌شود که از \f[V]rclone sync\f[R] روی فایل‌های رمزنگاری‌شده استفاده کنید و اطمینان حاصل کنید که گذرواژه‌ها در remote رمزنگاری‌شده جدید یکسان هستند.
.PP
این کار مزایای زیر را در پی خواهد داشت:
.IP \[bu] 2
دستور \f[V]rclone sync\f[R] در هنگام کپی کردن، چکسام‌ها را بررسی خواهد کرد
.IP \[bu] 2
می‌توانید از \f[V]rclone check\f[R] بین remoteهای رمزنگاری‌شده استفاده کنید
.IP \[bu] 2
فایل‌ها را بدون ضرورت رمزگشایی و مجدداً رمزگذاری نمی‌کنید
.PP
برای مثال، فرض کنید remote اصلی شما در \f[V]remote:\f[R] قرار دارد و نسخه رمزنگاری‌شده آن در \f[V]eremote:\f[R] با مسیر \f[V]remote:crypt\f[R] است.
سپس remote جدید \f[V]remote2:\f[R] و نسخه رمزنگاری‌شده \f[V]eremote2:\f[R] را با مسیر \f[V]remote2:crypt\f[R] و با استفاده از همان گذرواژه‌های \f[V]eremote:\f[R] تنظیم می‌کنید.
.PP
برای همگام‌سازی دو remote، این دستور را اجرا می‌کنید:
.IP
.nf
\f[C]
rclone sync --interactive remote:crypt remote2:crypt
\f[R]
.fi
.PP
و برای بررسی یکپارچگی، این دستور را اجرا می‌کنید:
.IP
.nf
\f[C]
rclone check remote:crypt remote2:crypt
\f[R]
.fi.SS "قالب‌های فایل"
.SS "رمزنگاری فایل"
.PP
فایل‌ها به‌صورت ۱:۱ از فایل مبدأ به شیء مقصد رمزنگاری می‌شوند.
فایل دارای یک سرایند است و به تکه‌ها تقسیم می‌شود.
.SS "سرایند"
.IP \[bu] 2
۸ بایت رشته جادویی \f[V]RCLONE\[rs]x00\[rs]x00\f[R]
.IP \[bu] 2
۲۴ بایت Nonce (IV)
.PP
نانس اولیه از تولیدکننده اعداد تصادفی امن از نظر رمزنگاری در سیستم‌عامل تولید می‌شود.
این نانس برای هر تکه‌ای که خوانده می‌شود افزایش می‌یابد تا اطمینان حاصل شود که هر نانس برای هر بلوک نوشته‌شده یکتا است.
احتمال استفاده مجدد از یک نانس بسیار ناچیز است.
اگر یک اگزابایت داده (۱۰¹⁸ بایت) می‌نوشتید، احتمال استفاده مجدد از یک نانس تقریباً ۲×۱۰⁻³² می‌بود.
.SS "تکه (Chunk)"
.PP
هر تکه شامل ۶۴ کیبی‌بایت داده خواهد بود، به‌جز آخرین تکه که ممکن است داده کمتری داشته باشد.
تکه داده در قالب استاندارد NaCl SecretBox است.
ابزار SecretBox از XSalsa20 و Poly1305 برای رمزنگاری و اصالت‌سنجی پیام‌ها استفاده می‌کند.
.PP
هر تکه شامل موارد زیر است:
.IP \[bu] 2
۱۶ بایت کد اصالت‌سنجی Poly1305
.IP \[bu] 2
۱ تا ۶۵۵۳۶ بایت داده رمزنگاری‌شده با XSalsa20
.PP
اندازه تکه ۶۴ کیلوبایتی به‌عنوان بهترین اندازه از نظر کارایی انتخاب شد (کمتر از این مقدار زمان زیادی از اصالت‌سنج می‌گیرد و بیشتر از این مقدار به دلیل اثرات حافظه نهان (cache)، عملکرد افت می‌کند).
توجه داشته باشید که این تکه‌ها در حافظه بافر می‌شوند، بنابراین نمی‌توانند بیش از حد بزرگ باشند.
.PP
این روش از یک کلید ۳۲ بایتی (کلید ۲۵۶ بیتی) مشتق‌شده از گذرواژه کاربر استفاده می‌کند.
.SS "مثال‌ها"
.PP
یک فایل ۱ بایتی به صورت زیر رمزنگاری می‌شود:
.IP \[bu] 2
۳۲ بایت سرایند
.IP \[bu] 2
۱۷ بایت تکه داده
.PP
در مجموع ۴۹ بایت
.PP
یک فایل ۱ مبی‌بایتی (۱۰۴۸۵۷۶ بایت) به صورت زیر رمزنگاری می‌شود:
.IP \[bu] 2
۳۲ بایت سرایند
.IP \[bu] 2
۱۶ تکه ۶۵۵۵۲ بایتی
.PP
در مجموع ۱۰۴۸۸۶۴ بایت (۰٫۰۳٪ سربار).
این میزان سربار برای فایل‌های بزرگ است.
.SS "رمزنگاری نام"
.PP
نام‌های فایل بخش‌به‌بخش رمزنگاری می‌شوند \- مسیر به رشته‌هایی که با \f[V]/\f[R] از هم جدا شده‌اند تفکیک شده و این رشته‌ها به‌صورت مجزا رمزنگاری می‌گردند.
.PP
بخش‌های نام فایل پیش از رمزنگاری، با استفاده از PKCS#7 تا مضربی از ۱۶ بایت تکمیل (pad) می‌شوند.
.PP
سپس با EME و با استفاده از AES با کلید ۲۵۶ بیتی رمزنگاری می‌شوند.
روش EME (ECB-Mix-ECB) یک حالت رمزنگاری بلوک‌بزرگ است که در مقاله سال ۲۰۰۳ با عنوان \[dq]A Parallelizable Enciphering Mode\[dq] توسط Halevi و Rogaway ارائه شد.
.PP
این امر منجر به یک رمزنگاری قطعی (deterministic) می‌شود که دقیقاً همان چیزی است که ما می‌خواهیم \- یک نام فایل یکسان باید به مقداری یکسان رمزنگاری شود، در غیر این صورت نمی‌توانیم آن را در سامانه ذخیره‌سازی ابری پیدا کنیم.
.PP
این بدان معناست که:
.IP \[bu] 2
نام‌های فایلی که یکسان هستند، به‌طور یکسان رمزنگاری می‌شوند
.IP \[bu] 2
نام‌های فایلی که شروع یکسانی دارند، پیشوند مشترکی نخواهند داشت
.PP
یک رشته نسخه به فرم \f[V]-vYYYY-MM-DD-HHMMSS-NNN\f[R] در انتهای نام فایل (همان‌طور که توسط \f[V]--b2-versions\f[R] / \f[V]--s3-versions\f[R] اضافه می‌شود) به‌صورت متن خام باقی می‌ماند تا فایل‌های نسخه‌بندی‌شده قابل یافتن باشند.
نام دایرکتوری‌ها به‌طور کامل رمزنگاری می‌شود.
برنامه Rclone پیش از نسخه v1.76 چنین پسوندی را در نام دایرکتوری‌ها نیز به‌صورت متن خام باقی می‌گذاشت، بنابراین دایرکتوری با چنین نامی که توسط نسخه‌های قدیمی‌تر rclone ایجاد شده باشد در فهرست‌ها با یک هشدار نمایش داده می‌شود، اما تا زمانی که در ریموتِ زیرین به نام ارائه‌شده در هشدار تغییر نام داده نشود، نمی‌توان آن را باز کرد یا حذف نمود.
.PP
در اینجا از یک کلید ۳۲ بایتی (۲۵۶ بیت) و یک IV شانزده بایتی (۱۲۸ بیت) استفاده می‌شود که هر دو از گذرواژه کاربر مشتق شده‌اند.
.PP
پس از رمزنگاری، آن‌ها با استفاده از نسخه اصلاح‌شده‌ای از کدگذاری استاندارد \f[V]base32\f[R] طبق شرح RFC4648 نوشته می‌شوند.
کدگذاری استاندارد به دو شیوه تغییر یافته است:
.IP \[bu] 2
به حروف کوچک تبدیل می‌شود (هیچ‌کس نام فایل با حروف بزرگ را دوست ندارد!)
.IP \[bu] 2
نویسه تکمیل‌کننده (padding) \f[V]=\f[R] حذف می‌شود
.PP
از \f[V]base32\f[R] به‌جای \f[V]base64\f[R] (که کارآمدتر است) استفاده می‌شود تا rclone بتواند در ریموت‌های غیرحساس به حروف کوچک و بزرگ (مانند Windows، Box، Dropbox، Onedrive و غیره) قابل استفاده باشد..SS "مشتق‌سازی کلید (Key derivation)"
.PP
برنامهٔ rclone از \f[V]scrypt\f[R] با پارامترهای \f[V]N=16384, r=8, p=1\f[R]
به همراه یک سالت (salt) اختیاری ارائه‌شده توسط کاربر (password2) برای مشتق‌سازی ۸۰ بایت
(۳۲+۳۲+۱۶) مادهٔ کلید مورد نیاز استفاده می‌کند.
اگر کاربر سالتی ارائه ندهد، rclone از یک سالت داخلی استفاده می‌کند.
.PP
الگوریتم \f[V]scrypt\f[R] اجرای حملهٔ واژه‌نامه‌ای (dictionary attack) را روی داده‌های
رمزنگاری‌شدهٔ rclone عملاً ناممکن می‌سازد.
برای محافظت کامل در برابر این موضوع، همیشه باید از یک سالت استفاده کنید.
.SS "همچنین ببینید (SEE ALSO)"
.IP \[bu] 2
rclone cryptdecode (https://rclone.org/commands/rclone_cryptdecode) \-
نمایش نگاشت مستقیم/معکوس نام‌های فایل رمزنگاری‌شده.
.SH "فشرده‌سازی (Compress)"
.SS "هشدار (Warning)"
.PP
این ریموت در حال حاضر \f[B]آزمایشی (experimental)\f[R] است.
ممکن است عملکرد آن با اختلال مواجه شده و داده‌ها از دست بروند.
مسئولیت هرگونه اقدام با این ریموت بر عهدهٔ خودتان است.
لطفاً خطرات مرتبط با استفاده از کدهای آزمایشی را مد نظر داشته باشید و
از این ریموت در کاربردهای حیاتی استفاده نکنید.
.PP
ریموت \f[V]Compress\f[R] قابلیت فشرده‌سازی را به یک ریموت دیگر می‌افزاید.
بهترین کاربرد آن برای ریموت‌هایی است که شامل تعداد زیادی فایل بزرگِ با قابلیت فشرده‌سازی هستند.
.SS "پیکربندی (Configuration)"
.PP
برای استفاده از این ریموت، تنها کاری که باید انجام دهید مشخص کردن ریموت دیگر و
یک حالت فشرده‌سازی برای استفاده است:
.IP
.nf
\f[C]
$ rclone config
Current remotes:

Name                 Type
====                 ====
remote_to_press      sometype

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> n
name> compress

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
\&...
12 / Compress a remote
   \[rs] (compress)
\&...
Storage> compress

Option remote.
Remote to compress.
Enter a value.
remote> remote_to_press:subdir 

Option mode.
Compression mode.
Choose a number from below, or type in your own value of type string.
Press Enter for the default (gzip).
 1 / Standard gzip compression with fastest parameters.
   \[rs] (gzip)
 2 / Zstandard compression \[em] fast modern algorithm offering adjustable speed-to-compression tradeoffs.
   \[rs] (zstd)
mode> gzip

Option level.
GZIP (levels -2 to 9):
- -2 \[em] Huffman encoding only. Only use if you know what you\[aq]re doing.
- -1 (default) \[em] recommended; equivalent to level 5.
- 0 \[em] turns off compression.
- 1\[en]9 \[em] increase compression at the cost of speed. Going past 6 generally offers very little return.
 
ZSTD (levels 0 to 4):
- 0 \[em] turns off compression entirely.
- 1 \[em] fastest compression with the lowest ratio.
- 2 (default) \[em] good balance of speed and compression.
- 3 \[em] better compression, but uses about 2\[en]3x more CPU than the default.
- 4 \[em] best possible compression ratio (highest CPU cost).
 
Notes:
- Choose GZIP for wide compatibility; ZSTD for better speed/ratio tradeoffs.
- Negative gzip levels: -2 = Huffman-only, -1 = default (≈ level 5).
Enter a value.
level> -1

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: compress
- remote: remote_to_press:subdir
- mode: gzip
- level: -1
Keep this \[dq]compress\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS الگوریتم‌های فشرده‌سازی
.IP \[bu] 2
\f[B]GZIP\f[R] \[en] الگوریتمی شناخته‌شده و فراگیر که توازن مناسبی میان سرعت و نسبت فشرده‌سازی برقرار می‌کند.
این الگوریتم از سطوح فشرده‌سازی \-2 تا 9 پشتیبانی می‌کند که مقدار پیش‌فرض \-1 (تقریباً معادل سطح 5) حد میانهٔ کارآمدی را برای بیشتر سناریوها فراهم می‌سازد.
.IP \[bu] 2
\f[B]Zstandard (zstd)\f[R] \[en] الگوریتمی نوین و با کارایی بالا که کنترل دقیقی بر توازن میان سرعت و بازدهی فشرده‌سازی ارائه می‌دهد.
سطوح فشرده‌سازی از 0 (بدون فشرده‌سازی) تا 4 (حداکثر فشرده‌سازی) متغیر است.
.SS انواع فایل
.PP
اگر یک ریموت بسته‌بندی‌شده با compress را باز کنید، مشاهده خواهید کرد که فایل‌های متعددی با پسوند متناظر با الگوریتم فشرده‌سازی انتخابی شما وجود دارند.
این فایل‌ها استانداردی هستند که می‌توان با برنامه‌های مختلف آرشیو آن‌ها را باز کرد، اما دارای فراداده‌های پنهانی هستند که امکان استفاده از آن‌ها توسط rclone را فراهم می‌سازد.
گرچه می‌توانید به دلخواه این فایل‌ها را بارگیری کرده و از حالت فشرده خارج کنید، اما فایل‌ها را به صورت دستی حذف \f[B]نکنید\f[R] یا نام آن‌ها را تغییر ندهید.
فایل‌های فاقد فایل‌های فرادادهٔ صحیح، توسط rclone شناسایی نخواهند شد.
.SS نام فایل‌ها
.PP
فایل‌های فشرده‌شده به صورت \f[V]*.###########.gz\f[R] نام‌گذاری خواهند شد که در آن \f[V]*\f[R] فایل اصلی بوده و بخش \f[V]#\f[R] اندازهٔ کدگذاری‌شده به روش base64 از فایل غیرفشرده است.
نام فایل‌ها نباید توسط چیزی به جز بک‌اند فشرده‌سازی rclone تغییر یابد.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص به compress (فشرده‌سازی یک ریموت) آمده است.
.SS --compress-remote
.PP
ریموت مورد نظر برای فشرده‌سازی.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: remote
.IP \[bu] 2
متغیر محیطی: RCLONE_COMPRESS_REMOTE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --compress-mode
.PP
حالت فشرده‌سازی.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: mode
.IP \[bu] 2
متغیر محیطی: RCLONE_COMPRESS_MODE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]gzip\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]gzip\[dq]
.RS 2
.IP \[bu] 2
فشرده‌سازی استاندارد gzip با سریع‌ترین پارامترها.
.RE
.IP \[bu] 2
\[dq]zstd\[dq]
.RS 2
.IP \[bu] 2
فشرده‌سازی Zstandard \[em] الگوریتمی سریع و نوین با امکان تنظیم توازن میان سرعت و فشرده‌سازی.
.RE
.RE
.SS --compress-level
.PP
GZIP (سطوح \-2 تا 9): \- \-2 \[em] فقط کدگذاری هافمن (Huffman).
تنها در صورتی استفاده کنید که می‌دانید چه کاری انجام می‌دهید.
\- \-1 (پیش‌فرض) \[em] توصیه می‌شود؛ معادل سطح 5.
\- 0 \[em] فشرده‌سازی را خاموش می‌کند.
\- 1\[en]9 \[em] افزایش فشرده‌سازی به بهای کاهش سرعت.
فراتر رفتن از سطح 6 عموماً بازدهی چندانی به همراه ندارد.
.PP
ZSTD (سطوح 0 تا 4): \- 0 \[em] فشرده‌سازی را به طور کامل غیرفعال می‌کند.
\- 1 \[em] سریع‌ترین فشرده‌سازی با کمترین نسبت تراکم.
\- 2 (پیش‌فرض) \[em] توازن مناسب میان سرعت و فشرده‌سازی.
\- 3 \[em] فشرده‌سازی بهتر، اما حدود 2\[en]3 برابر CPU بیشتری نسبت به حالت پیش‌فرض مصرف می‌کند.
\- 4 \[em] بهترین نسبت فشرده‌سازی ممکن (بالاترین بار پردازشی CPU).
.PP
نکات: \- برای سازگاری گسترده، GZIP را انتخاب کنید؛ برای توازن بهتر سرعت/نسبت، ZSTD را برگزینید.
\- سطوح منفی gzip: مقدار \-2 = فقط هافمن، مقدار \-1 = پیش‌فرض (≈ سطح 5).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: level
.IP \[bu] 2
متغیر محیطی: RCLONE_COMPRESS_LEVEL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مخصوص compress (فشرده‌سازی یک ریموت) آورده شده است.
.SS --compress-ram-cache-limit
.PP
برخی از ریموت‌ها اجازه بارگذاری فایل‌ها با اندازه نامشخص را نمی‌دهند.
در این حالت برای تعیین اندازه فایل فشرده، نیاز است که آن فایل در حافظه موقت (کش) ذخیره شود.
.PP
فایل‌های کوچک‌تر از این حد در RAM کش می‌شوند و فایل‌های بزرگ‌تر از این حد روی دیسک ذخیره خواهند شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: ram_cache_limit
.IP \[bu] 2
متغیر محیطی: RCLONE_COMPRESS_RAM_CACHE_LIMIT
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 20Mi
.SS --compress-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_COMPRESS_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS فراداده (Metadata)
.PP
هرگونه فراداده‌ای که توسط ریموت زیربنایی پشتیبانی شود، خوانده و نوشته می‌شود.
.PP
برای اطلاعات بیشتر مستندات فراداده (<https://rclone.org/docs/#metadata>) را ببینید.
.SH Combine
.PP
بک‌اند \f[V]combine\f[R] ریموت‌ها را در یک درخت دایرکتوری واحد ادغام می‌کند.
.PP
برای نمونه ممکن است یک ریموت برای تصاویر روی یک ارائه‌دهنده داشته باشید:
.IP
.nf
\f[C]
$ rclone tree s3:imagesbucket
/
├── image1.jpg
└── image2.jpg
\f[R]
.fi
.PP
و ریموتی برای فایل‌ها روی ارائه‌دهنده‌ای دیگر:
.IP
.nf
\f[C]
$ rclone tree drive:important/files
/
├── file1.txt
└── file2.txt
\f[R]
.fi
.PP
بک‌اند \f[V]combine\f[R] می‌تواند این‌ها را در یک ساختار دایرکتوری ساختگی مانند این ترکیب کند:
.IP
.nf
\f[C]
$ rclone tree combined:
/
├── files
│   ├── file1.txt
│   └── file2.txt
└── images
    ├── image1.jpg
    └── image2.jpg
\f[R]
.fi
.PP
شما این کار را با مشخص کردن پارامتر \f[V]upstreams\f[R] در پیکربندی به این صورت انجام می‌دهید:
.IP
.nf
\f[C]
upstreams = images=s3:imagesbucket files=drive:important/files
\f[R]
.fi
.PP
در طول راه‌اندازی اولیه با \f[V]rclone config\f[R] شما ریموت‌های upstream را به صورت یک فهرست جداشده با فاصله مشخص خواهید کرد.
ریموت‌های upstream می‌توانند مسیرهای محلی یا ریموت‌های دیگر باشند..SS "پیکربندی (Configuration)"
.PP
در اینجا مثالی از نحوه ساخت یک combine با نام \f[V]remote\f[R] برای
نمونه بالا آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
\&...
XX / Combine several remotes into one
   \[rs] (combine)
\&...
Storage> combine
Option upstreams.
Upstreams for combining
These should be in the form
    dir=remote:path dir2=remote2:path
Where before the = is specified the root directory and after is the remote to
put there.
Embedded spaces can be added using quotes
    \[dq]dir=remote:path with space\[dq] \[dq]dir2=remote2:path with space\[dq]
Enter a fs.SpaceSepList value.
upstreams> images=s3:imagesbucket files=drive:important/files
Configuration complete.
Options:
- type: combine
- upstreams: images=s3:imagesbucket files=drive:important/files
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.SS "پیکربندی برای درایوهای اشتراکی Google Drive"
.PP
ابزار Rclone دارای یک قابلیت سودمند برای ساخت یک backend از نوع combine جهت
دسترسی به تمامی درایوهای اشتراکی است که به آن‌ها دسترسی دارید.
.PP
با فرض اینکه نام ریموت اصلی Google Drive شما (غیر از درایو اشتراکی)
\f[V]drive:\f[R] باشد، دستور زیر را اجرا می‌کنید:
.IP
.nf
\f[C]
rclone backend -o config drives drive:
\f[R]
.fi
.PP
این دستور خروجی‌ای شبیه به این تولید خواهد کرد:
.IP
.nf
\f[C]
[My Drive]
type = alias
remote = drive,team_drive=0ABCDEF-01234567890,root_folder_id=:

[Test Drive]
type = alias
remote = drive,team_drive=0ABCDEFabcdefghijkl,root_folder_id=:

[AllDrives]
type = combine
upstreams = \[dq]My Drive=My Drive:\[dq] \[dq]Test Drive=Test Drive:\[dq]
\f[R]
.fi
.PP
اگر سپس این پیکربندی را به فایل پیکربندی خود اضافه کنید (آن را با
\f[V]rclone config file\f[R] پیدا کنید)، آن‌گاه می‌توانید در یک مکان و
با ریموت \f[V]AllDrives:\f[R] به تمام درایوهای اشتراکی دسترسی داشته باشید.
.PP
برای اطلاعات کامل، مستندات Google Drive را در <https://rclone.org/drive/#drives> ببینید..SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مربوط به combine (ترکیب چند ریموت در یکی) آورده شده است.
.SS --combine-upstreams
.PP
مبدأها (upstreams) برای ترکیب.
.PP
این مقادیر باید در این قالب باشند:
.IP
.nf
\f[C]
dir=remote:path dir2=remote2:path
\f[R]
.fi
.PP
به طوری که قبل از = دایرکتوری ریشه مشخص شده و بعد از آن ریموتی است که باید در آنجا قرار گیرد.
.PP
فاصله‌های خالی درون نام‌ها را می‌توان با استفاده از نقل‌قول اضافه کرد:
.IP
.nf
\f[C]
\[dq]dir=remote:path with space\[dq] \[dq]dir2=remote2:path with space\[dq]
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upstreams
.IP \[bu] 2
متغیر محیطی: RCLONE_COMBINE_UPSTREAMS
.IP \[bu] 2
نوع: SpaceSepList
.IP \[bu] 2
پیش‌فرض:
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مربوط به combine (ترکیب چند ریموت در یکی) آورده شده است.
.SS --combine-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_COMBINE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS متادیتا (Metadata)
.PP
هرگونه متادیتای پشتیبانی‌شده توسط ریموت زیرین خوانده و نوشته می‌شود.
.PP
برای اطلاعات بیشتر به مستندات متادیتا (https://rclone.org/docs/#metadata) مراجعه کنید.
.SH DOI
.PP
ریموت DOI یک ریموت فقط‌خواندنی برای خواندن فایل‌ها از شناسه‌های اشیاء دیجیتال (DOI) است.
.PP
در حال حاضر، بک‌اند DOI از DOIهای میزبانی‌شده در موارد زیر پشتیبانی می‌کند:
.IP \[bu] 2
InvenioRDM (https://inveniosoftware.org/products/rdm)
.RS 2
.IP \[bu] 2
Zenodo (https://zenodo.org)
.IP \[bu] 2
CaltechDATA (https://data.caltech.edu)
.IP \[bu] 2
سایر مخازن InvenioRDM (https://inveniosoftware.org/showcase)
.RE
.IP \[bu] 2
Dataverse (https://dataverse.org)
.RS 2
.IP \[bu] 2
Harvard Dataverse (https://dataverse.harvard.edu)
.IP \[bu] 2
سایر مخازن Dataverse (https://dataverse.org/installations)
.RE
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند تا هر عمقی که نیاز باشد مشخص شوند، مانند
\f[V]remote:directory/subdirectory\f[R]..SS پیکربندی (Configuration)
.PP
در اینجا مثالی از نحوه ساخت یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
Enter name for new remote.
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / DOI datasets
   \[rs] (doi)
[snip]
Storage> doi
Option doi.
The DOI or the doi.org URL.
Enter a value.
doi> 10.5281/zenodo.5876941
Edit advanced config?
y) Yes
n) No (default)
y/n> n
Configuration complete.
Options:
- type: doi
- doi: 10.5281/zenodo.5876941
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص doi (مجموعه‌داده‌های DOI) آورده شده است.
.SS --doi-doi
.PP
شناسه DOI یا نشانی وب doi.org.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: doi
.IP \[bu] 2
متغیر محیطی: RCLONE_DOI_DOI
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مختص doi (مجموعه‌داده‌های DOI) آورده شده است.
.SS --doi-provider
.PP
ارائه‌دهنده DOI.
.PP
ارائه‌دهنده DOI را می‌توان زمانی تنظیم کرد که rclone یک ارائه‌دهنده پشتیبانی‌شده DOI را به‌طور خودکار تشخیص ندهد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: provider
.IP \[bu] 2
متغیر محیطی: RCLONE_DOI_PROVIDER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]auto\[dq]
.RS 2
.IP \[bu] 2
تشخیص خودکار ارائه‌دهنده
.RE
.IP \[bu] 2
\[dq]zenodo\[dq]
.RS 2
.IP \[bu] 2
Zenodo
.RE
.IP \[bu] 2
\[dq]dataverse\[dq]
.RS 2
.IP \[bu] 2
Dataverse
.RE
.IP \[bu] 2
\[dq]invenio\[dq]
.RS 2
.IP \[bu] 2
Invenio
.RE
.RE.SS --doi-doi-resolver-api-url
.PP
نشانی URL مربوط به API تفکیک‌کننده DOI برای استفاده.
.PP
تفکیک‌کننده DOI را می‌توان برای آزمایش یا در مواردی که نمی‌توان از API
رسمی (canonical) تفکیک‌کننده DOI استفاده کرد، تنظیم نمود.
.PP
به طور پیش‌فرض \[dq]https://doi.org/api\[dq] است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: doi_resolver_api_url
.IP \[bu] 2
متغیر محیطی: RCLONE_DOI_DOI_RESOLVER_API_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --doi-description
.PP
توضیحات remote.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_DOI_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS دستورهای Backend
.PP
در اینجا دستورات مختص backend مربوط به doi آورده شده است.
.PP
آن‌ها را به این صورت اجرا کنید:
.IP
.nf
\f[C]
rclone backend COMMAND remote:
\f[R]
.fi
.PP
راهنمای زیر مشخص می‌کند که هر دستور چه آرگومان‌هایی دریافت می‌کند.
.PP
برای اطلاعات بیشتر درباره نحوه ارسال گزینه‌ها و آرگومان‌ها، دستور
backend (https://rclone.org/commands/rclone_backend) را ببینید.
.PP
این دستورات را می‌توان با استفاده از دستور rc به شکل
backend/command (https://rclone.org/rc/#backend-command) بر روی یک backend در حال اجرا، اجرا کرد.
.SS metadata
.PP
نمایش فراداده‌های مربوط به DOI.
.IP
.nf
\f[C]
rclone backend metadata remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور یک شیء JSON حاوی اطلاعاتی درباره DOI را برمی‌گرداند.
.PP
مثال کاربرد:
.IP
.nf
\f[C]
rclone backend metadata doi:
\f[R]
.fi
.PP
این دستور یک شیء JSON را برمی‌گرداند که نشان‌دهنده فراداده‌های مربوط به DOI است.
.SS set
.PP
دستور set برای به‌روزرسانی پارامترهای پیکربندی.
.IP
.nf
\f[C]
rclone backend set remote: [options] [<arguments>+]
\f[R]
.fi
.PP
از این دستور set می‌توان برای به‌روزرسانی پارامترهای پیکربندی یک
backend فعال doi استفاده کرد.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend set doi: [-o opt_name=opt_value] [-o opt_name2=opt_value2]
rclone rc backend/command command=set fs=doi: [-o opt_name=opt_value] [-o opt_name2=opt_value2]
rclone rc backend/command command=set fs=doi: -o doi=NEW_DOI
\f[R]
.fi
.PP
نام کلیدهای گزینه‌ها دقیقاً همانند نام آن‌ها در فایل پیکربندی است.
.PP
هنگام فراخوانی این دستور با پارامترهای جدید، اتصال به backend مربوط به doi
بازسازی می‌شود.
تنها نیاز است پارامترهای جدید ارسال شوند، چرا که مقادیر دیگر به طور
پیش‌فرض همان مقادیر در حال استفاده خواهند بود.
.PP
این دستور چیزی برنمی‌گرداند..SH Drime
.PP
سرویس Drime (https://drime.cloud) یک سرویس ذخیره‌سازی و انتقال ابری است که بر تحویل سریع و پایدار فایل‌ها تمرکز دارد.
این سرویس هم طرح‌های رایگان و هم پولی را با تأکید بر بارگذاری پرسرعت و اشتراک‌گذاری پیوند ارائه می‌دهد.
.PP
برای راه‌اندازی Drime باید وارد حساب کاربری خود شوید، به بخش Settings و سپس Developer بروید و یک توکن به عنوان کلید دسترسی API ایجاد کنید.
نام مناسبی به آن اختصاص دهید و توکن را برای استفاده در پیکربندی کپی کنید.
.SS "پیکربندی (Configuration)"
.PP
در اینجا نحوه اجرای \f[V]rclone config\f[R] برای ایجاد یک ریموت به نام \f[V]remote\f[R] آورده شده است.
.PP
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
سپس مراحل راه‌اندازی تعاملی را دنبال کنید:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> remote

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
XX / Drime
   \[rs] (drime)
Storage> drime

Option access_token.
API Access token
You can get this from the web control panel.
Enter a value. Press Enter to leave empty.
access_token> YOUR_API_ACCESS_TOKEN

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: drime
- access_token: YOUR_API_ACCESS_TOKEN
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
پس از اتمام پیکربندی، می‌توانید از \f[V]rclone\f[R] به صورت زیر استفاده کنید (مقدار \f[V]remote\f[R] را با نامی که به ریموت خود داده‌اید جایگزین کنید):
.PP
فهرست کردن دایرکتوری‌ها و فایل‌ها در بالاترین سطح Drime شما:
.IP
.nf
\f[C]
rclone lsf remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به دایرکتوری‌ای به نام backup در Drime:
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها (Modification times and hashes)
.PP
سرویس Drime از زمان‌های تغییر یا هش‌ها پشتیبانی نمی‌کند.
.PP
این بدان معناست که به‌طور پیش‌فرض، همگام‌سازی‌ها تنها از اندازه فایل برای
تعیین اینکه آیا به به‌روزرسانی نیاز است یا خیر استفاده خواهند کرد.
.PP
می‌توانید از پرچم \f[V]--update\f[R] استفاده کنید که از زمان بارگذاری
شیء استفاده می‌کند.
برای بسیاری از عملیات‌ها، این مقدار برای تشخیص اینکه آیا تغییر کرده است یا خیر کافی خواهد بود.
با این حال، در صورت استفاده از \f[V]--update\f[R]، فایل‌هایی که با برچسب زمانی در گذشته
ایجاد شده باشند در همگام‌سازی نادیده گرفته خواهند شد.
.SS نویسه‌های محدودشده در نام فایل (Restricted filename characters)
.PP
علاوه بر مجموعه پیش‌فرض نویسه‌های
محدودشده (https://rclone.org/overview/#restricted-characters)، نویسه‌های
زیر نیز جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
.TE
.PP
نام فایل‌ها همچنین نمی‌تواند با نویسه‌های زیر شروع شود یا پایان یابد.
این موارد تنها در صورتی جایگزین می‌شوند که اولین یا آخرین نویسه در
نام باشند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
SP
T}@T{
0x20
T}@T{
␠
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین
خواهند شد (https://rclone.org/overview/#invalid-utf8)، چرا که امکان
استفاده از آن‌ها در رشته‌های JSON وجود ندارد.
.SS شناسه پوشه ریشه (Root folder ID)
.PP
می‌توانید مقدار \f[V]root_folder_id\f[R] را برای rclone تنظیم کنید.
این همان دایرکتوری است (که با \f[V]Folder ID\f[R] مشخص می‌شود) که
rclone آن را ریشه درایو Drime شما در نظر می‌گیرد.
.PP
در حالت عادی این مقدار را خالی می‌گذارید و rclone ریشه صحیح را برای
استفاده خودش تعیین کرده و مقدار را در فایل پیکربندی وارد می‌کند.
.PP
با این حال می‌توانید آن را تنظیم کنید تا rclone به یک سلسله‌مراتب
پوشه خاص محدود شود.
.PP
به منظور انجام این کار، باید \f[V]Folder ID\f[R] دایرکتوری مورد نظر
برای نمایش در rclone را بیابید.
.PP
می‌توانید این کار را با rclone انجام دهید:
.IP
.nf
\f[C]
$ rclone lsf -Fip --dirs-only remote:
d6341f53-ee65-4f29-9f59-d11e8070b2a0;Files/
f4f5c9b8-6ece-478b-b03e-4538edfe5a1c;Photos/
d50e356c-29ca-4b27-a3a7-494d91026e04;Videos/
\f[R]
.fi
.PP
شناسه‌ای که باید استفاده شود بخش قبل از \f[V];\f[R] است، بنابراین می‌توانید مقدار زیر را تنظیم کنید:
.IP
.nf
\f[C]
root_folder_id = d6341f53-ee65-4f29-9f59-d11e8070b2a0
\f[R]
.fi
.PP
تا rclone به دایرکتوری \f[V]Files\f[R] محدود شود..SS "گزینه‌های استاندارد (Standard options)"
.PP
در اینجا گزینه‌های استاندارد مخصوص drime (Drime) آمده است.
.SS --drime-access-token
.PP
توکن دسترسی API
.PP
می‌توانید این مقدار را از کنترل‌پنل تحت وب دریافت کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: access_token
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIME_ACCESS_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS "گزینه‌های پیشرفته (Advanced options)"
.PP
در اینجا گزینه‌های پیشرفته مخصوص drime (Drime) آمده است.
.SS --drime-root-folder-id
.PP
شناسه (ID) پوشه ریشه
.PP
در حالت عادی این مقدار را خالی بگذارید؛ rclone آن را به‌طور خودکار پر خواهد کرد.
.PP
اگر می‌خواهید rclone به پوشه خاصی محدود شود، می‌توانید این مقدار را وارد کنید \- برای اطلاعات بیشتر مستندات را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_folder_id
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIME_ROOT_FOLDER_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --drime-workspace-id
.PP
شناسه حساب کاربری (Account ID)
.PP
در حالت عادی این مقدار را خالی بگذارید، مگر اینکه بخواهید یک Workspace ID را مشخص کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: workspace_id
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIME_WORKSPACE_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --drime-list-chunk
.PP
تعداد مواردی که در هر فراخوانی فهرست می‌شوند
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_chunk
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIME_LIST_CHUNK
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 1000
.SS --drime-hard-delete
.PP
حذف دائمی فایل‌ها به جای انتقال آن‌ها به سطل زباله.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hard_delete
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIME_HARD_DELETE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --drime-upload-cutoff
.PP
حد آستانه برای تغییر به بارگذاری تکه‌ای (chunked).
.PP
هر فایلی بزرگ‌تر از این مقدار، در تکه‌هایی به اندازهٔ chunk_size بارگذاری خواهد شد.
حداقل 0 و حداکثر 5 GiB است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIME_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 5Mi
.SS --drime-chunk-size
.PP
اندازهٔ تکه برای استفاده در بارگذاری.
.PP
هنگام بارگذاری فایل‌های بزرگ‌تر از upload_cutoff یا فایل‌هایی با اندازهٔ نامشخص
(برای نمونه از طریق \[dq]rclone rcat\[dq] یا بارگذاری‌شده با \[dq]rclone mount\[dq] یا
google photos یا google docs)، آن‌ها به عنوان بارگذاری‌های چندبخشی (multipart) با استفاده
از این اندازهٔ تکه بارگذاری خواهند شد.
.PP
توجه داشته باشید که به ازای هر انتقال، به تعداد \[dq]--drime-upload-concurrency\[dq] تکه با این اندازه در حافظه بافر می‌شود.
.PP
اگر فایل‌های حجیم را روی پیوندهای پرسرعت انتقال می‌دهید و حافظهٔ کافی در اختیار دارید،
افزایش این مقدار سرعت انتقال را افزایش خواهد داد.
.PP
هنگام بارگذاری یک فایل بزرگ با اندازهٔ مشخص، Rclone به طور خودکار اندازهٔ تکه را افزایش می‌دهد تا تعداد تکه‌ها زیر محدودیت 10,000 تکه باقی بماند.
.PP
فایل‌های با اندازهٔ نامشخص با مقدار chunk_size پیکربندی‌شده بارگذاری می‌شوند.
از آنجا که اندازهٔ پیش‌فرض هر تکه 5 MiB است و حداکثر می‌تواند 10,000 تکه وجود داشته باشد،
این بدان معناست که به طور پیش‌فرض حداکثر اندازهٔ فایلی که می‌توانید به صورت جریانی (stream)
بارگذاری کنید 48 GiB است.
اگر می‌خواهید فایل‌های بزرگ‌تری را به صورت جریانی بارگذاری کنید، باید chunk_size را افزایش دهید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIME_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 5Mi
.SS --drime-upload-concurrency
.PP
میزان همزمانی برای بارگذاری‌ها و رونوشت‌های چندبخشی (multipart).
.PP
این مقدار، تعداد تکه‌هایی از یک فایل است که به طور هم‌زمان برای بارگذاری‌ها و
رونوشت‌های چندبخشی آپلود می‌شوند.
.PP
اگر تعداد کمی فایل حجیم را روی پیوندهای پرسرعت بارگذاری می‌کنید و این بارگذاری‌ها به طور
کامل از پهنای باند شما استفاده نمی‌کنند، افزایش این مقدار ممکن است به بالا بردن سرعت انتقال‌ها کمک کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIME_UPLOAD_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 4
.SS --drime-encoding
.PP
کدگذاری مورد استفاده برای بک‌اند.
.PP
برای اطلاعات بیشتر، بخش کدگذاری در بررسی کلی
(https://rclone.org/overview/#encoding) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIME_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,BackSlash,Del,Ctl,LeftSpace,RightSpace,InvalidUtf8,Dot.SS --drime-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIME_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS محدودیت‌ها
.PP
سرویس Drime تنها از نام‌های فایل با حداکثر طول ۲۵۵ بایت پشتیبانی می‌کند، که در آن نام‌های فایل با کدگذاری UTF8 کدگذاری شده‌اند.
.SH Dropbox
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرهای Dropbox می‌توانند به هر عمق دلخواهی باشند، مانند
\f[V]remote:directory/subdirectory\f[R].
.SS پیکربندی
.PP
راه‌اندازی اولیه Dropbox شامل دریافت یک توکن از Dropbox است که باید آن را در مرورگر خود انجام دهید.
دستور \f[V]rclone config\f[R] شما را در این فرآیند راهنمایی می‌کند.
.PP
در اینجا نمونه‌ای از نحوه ساخت یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این کار شما را در یک فرآیند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
n) New remote
d) Delete remote
q) Quit config
e/n/d/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Dropbox
   \[rs] \[dq]dropbox\[dq]
[snip]
Storage> dropbox
Dropbox App Key - leave blank normally.
app_key>
Dropbox App Secret - leave blank normally.
app_secret>
Remote config
Please visit:
https://www.dropbox.com/1/oauth2/authorize?client_id=XXXXXXXXXXXXXXX&response_type=code
Enter the code: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX_XXXXXXXXXX
Configuration complete.
Options:
- type: dropbox
- app_key:
- app_secret:
- token: XXXXXXXXXXXXXXXXXXXXXXXXXXXXX_XXXX_XXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
برای نحوه راه‌اندازی روی دستگاهی که مرورگر وب متصل به اینترنت در دسترس ندارد، به مستندات راه‌اندازی ریموت (https://rclone.org/remote_setup) مراجعه کنید.
.PP
توجه داشته باشید که rclone یک وب‌سرور را بر روی دستگاه محلی شما اجرا می‌کند تا توکن بازگردانده شده از Dropbox را دریافت کند.
این وب‌سرور تنها از لحظه باز کردن مرورگر تا زمان دریافت کد تأیید اجرا می‌شود.
این سرور روی \f[V]http://127.0.0.1:53682\f[R] اجرا می‌شود و اگر فایروال میزبان را فعال کرده‌اید، ممکن است لازم باشد آن را موقتاً رفع مسدودی کنید، یا از حالت دستی (manual) استفاده نمایید.
.PP
سپس می‌توانید به این شکل از آن استفاده کنید:
.PP
فهرست کردن دایرکتوری‌ها در سطح بالای Dropbox شما:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در Dropbox شما:
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به دایرکتوری‌ای به نام backup در Dropbox:
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS دراپ‌باکس سازمانی (Dropbox for business)
.PP
برنامهٔ Rclone از Dropbox for business و پوشه‌های تیمی (Team Folders) پشتیبانی می‌کند.
.PP
هنگام استفاده از Dropbox for business، عبارت‌های \f[V]remote:\f[R] و
\f[V]remote:path/to/file\f[R] به پوشهٔ شخصی شما اشاره خواهند داشت.
.PP
اگر می‌خواهید Team Folders را مشاهده کنید، باید یک \f[V]/\f[R] در ابتدای
مسیر قرار دهید؛ بنابراین \f[V]rclone lsd remote:/\f[R] به ریشه اشاره خواهد کرد و
همهٔ پوشه‌های تیمی و پوشهٔ کاربری شما را نمایش می‌دهد.
.PP
سپس می‌توانید از پوشه‌های تیمی بدین صورت استفاده کنید: \f[V]remote:/TeamFolder\f[R] و
\f[V]remote:/TeamFolder/path/to/file\f[R].
.PP
وجود \f[V]/\f[R] ابتدایی برای یک حساب شخصی دراپ‌باکس هیچ اثری نخواهد داشت،
اما یک تراکنش HTTP اضافی مصرف می‌کند و بنابراین باید از آن خودداری کرد.
.SS زمان‌های تغییر و هش‌ها (Modification times and hashes)
.PP
دراپ‌باکس از زمان‌های تغییر فایل پشتیبانی می‌کند، اما تنها راه تنظیم
زمان تغییر، بارگذاری مجدد فایل است.
.PP
این بدان معناست که اگر داده‌های خود را با نسخهٔ قدیمی‌تری از
rclone بارگذاری کرده‌اید که از v2 API و زمان‌های تغییر پشتیبانی نمی‌کرد، rclone
تصمیم خواهد گرفت تمام داده‌های قدیمی شما را برای تصحیح زمان‌های تغییر دوباره بارگذاری کند.
اگر نمی‌خواهید این اتفاق بیفتد، از گزینهٔ \f[V]--size-only\f[R] یا
\f[V]--checksum\f[R] برای جلوگیری از آن استفاده کنید.
.PP
دراپ‌باکس از نوع هش اختصاصی
خود (https://www.dropbox.com/developers/reference/content-hash) پشتیبانی می‌کند که
صحت آن برای همهٔ انتقال‌ها بررسی می‌شود.
.SS نویسه‌های غیرمجاز نام فایل (Restricted filename characters)
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
NUL
T}@T{
0x00
T}@T{
␀
T}
T{
/
T}@T{
0x2F
T}@T{
／
T}
T{
DEL
T}@T{
0x7F
T}@T{
␡
T}
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
.TE
.PP
نام فایل‌ها همچنین نمی‌تواند با نویسه‌های زیر خاتمه یابد.
این موارد تنها در صورتی جایگزین می‌شوند که آخرین نویسه در نام باشند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
SP
T}@T{
0x20
T}@T{
␠
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند
شد (https://rclone.org/overview/#invalid-utf8)، زیرا نمی‌توان از آن‌ها
در رشته‌های JSON استفاده کرد..SS "بارگذاری‌ها در حالت دسته‌ای (Batch mode uploads)"
.PP
استفاده از بارگذاری در حالت دسته‌ای (batch mode) هنگام استفاده از API دراپ‌باکس (Dropbox) برای کارایی بسیار حائز اهمیت است.
برای اطلاعات بیشتر راهنمای کارایی Dropbox را ببینید (<https://developers.dropbox.com/dbx-performance-guide>).
.PP
۳ حالت وجود دارد که rclone می‌تواند برای بارگذاری‌ها از آن‌ها استفاده کند.
.SS --dropbox-batch-mode off
.PP
در این حالت rclone از دسته‌بندی بارگذاری‌ها استفاده نخواهد کرد.
این حالت قبل از نگارش v1.55 برنامه rclone پیش‌فرض بود.
این حالت این عیب را دارد که احتمال مواجهه با خطاهای \f[V]too_many_requests\f[R] مشابه این بسیار بالاست:
.IP
.nf
\f[C]
NOTICE: too_many_requests/.: Too many requests or write operations. Trying again in 15 seconds.
\f[R]
.fi
.PP
هنگامی که rclone این خطاها را دریافت می‌کند، باید قبل از ادامه دادن ۱۵ ثانیه یا گاهی اوقات ۳۰۰ ثانیه منتظر بماند که این امر سرعت انتقال‌ها را بسیار کاهش می‌دهد.
.PP
این اتفاق به‌ویژه زمانی رخ می‌دهد که مقدار \f[V]--transfers\f[R] بزرگ باشد، بنابراین استفاده از این حالت به جز برای سازگاری یا بررسی مشکلات توصیه نمی‌شود.
.SS --dropbox-batch-mode sync
.PP
در این حالت rclone بارگذاری‌ها را تا اندازه‌ای که توسط \f[V]--dropbox-batch-size\f[R] مشخص شده دسته‌بندی کرده و همه را با هم ثبت (commit) می‌کند.
.PP
استفاده از این حالت بدین معناست که می‌توانید از پارامتر \f[V]--transfers\f[R] با مقادیر بسیار بالاتری (۳۲ یا ۶۴ به خوبی کار می‌کند) بدون دریافت خطاهای \f[V]too_many_requests\f[R] استفاده کنید.
.PP
این حالت یکپارچگی کامل داده‌ها را تضمین می‌کند.
.PP
توجه داشته باشید که ممکن است هنگام خروج از rclone، تا زمانی که در این حالت آخرین دسته را به پایان برساند، وقفه‌ای ایجاد شود.
.SS --dropbox-batch-mode async
.PP
در این حالت rclone بارگذاری‌ها را تا اندازه‌ای که توسط \f[V]--dropbox-batch-size\f[R] مشخص شده دسته‌بندی کرده و همه را با هم ثبت (commit) می‌کند.
.PP
با این حال، منتظر بازگردانده شدن وضعیت دسته به فراخواننده نمی‌ماند.
این به این معناست که rclone می‌تواند از اندازه دسته بسیار بزرگ‌تری (بسیار بزرگ‌تر از \f[V]--transfers\f[R]) استفاده کند، به قیمت عدم امکان بررسی وضعیت بارگذاری.
.PP
این حالت حداکثر سرعت بارگذاری ممکن را، به‌ویژه برای تعداد زیادی فایل کوچک، فراهم می‌کند؛ هرچند در این حالت rclone نمی‌تواند بررسی کند که فایل به درستی بارگذاری شده است یا خیر.
.PP
اگر از این حالت استفاده می‌کنید، اجرای \[dq]rclone check\[dq] پس از تکمیل انتقال توصیه می‌شود.
یا می‌توانید یک انتقال اولیه را با \f[V]--dropbox-batch-mode async\f[R] انجام دهید و سپس یک انتقال نهایی با \f[V]--dropbox-batch-mode sync\f[R] (پیش‌فرض) انجام دهید.
.PP
توجه داشته باشید که ممکن است هنگام خروج از rclone، تا زمانی که در این حالت آخرین دسته را به پایان برساند، وقفه‌ای ایجاد شود.
.SS "برون‌بری فایل‌ها (Exporting files)"
.PP
برخی فایل‌ها در Dropbox «قابل برون‌بری» (\[dq]exportable\[dq]) هستند، مانند اسناد Dropbox Paper.
این فایل‌ها برای دانلود شدن باید به قالب دیگری تبدیل شوند.
اغلب چندین قالب برای تبدیل در دسترس است.
.PP
هنگامی که rclone یک فایل قابل برون‌بری را دانلود می‌کند، قالب دانلود را بر اساس تنظیم \f[V]--dropbox-export-formats\f[R] انتخاب می‌کند.
به‌طور پیش‌فرض، قالب‌های برون‌بری \f[V]html,md\f[R] هستند که مقادیر پیش‌فرض معقولی برای Dropbox Paper به شمار می‌روند.
.PP
برنامه rclone نخستین شناسه قالب موجود در فهرست قالب‌های برون‌بری را که Dropbox برای فایل مربوطه پشتیبانی می‌کند، انتخاب می‌کند.
اگر هیچ قالبی در این فهرست قابل استفاده نباشد، rclone قالب پیش‌فرضی را که Dropbox پیشنهاد می‌دهد انتخاب خواهد کرد.
.PP
برنامه rclone پسوند فایل را متناسب با قالب برون‌بری تغییر خواهد داد.
در اینجا چند مثال از نحوه نگاشت پسوندها آورده شده است:
.PP
.TS
tab(@);
l l l.
T{
نوع فایل
T}@T{
نام فایل در Dropbox
T}@T{
نام فایل در rclone
T}
_
T{
Paper
T}@T{
mydoc.paper
T}@T{
mydoc.html
T}
T{
الگوی Paper
T}@T{
mydoc.papert
T}@T{
mydoc.papert.html
T}
T{
سایر
T}@T{
mydoc
T}@T{
mydoc.html
T}
.TE
.PP
\f[I]درون‌ریزی\f[R] فایل‌های قابل برون‌بری هنوز توسط rclone پشتیبانی نمی‌شود.
.PP
در ادامه پسوندهای برون‌بری پشتیبانی‌شده و شناخته‌شده توسط rclone آمده است.
توجه داشته باشید که rclone در حال حاضر از سایر قالب‌هایی که در این فهرست نیستند، حتی در صورتی که Dropbox از آن‌ها پشتیبانی کند، پشتیبانی نمی‌کند.
همچنین، Dropbox می‌تواند فهرست قالب‌های پشتیبانی‌شده را در هر زمانی تغییر دهد.
.PP
.TS
tab(@);
l l l.
T{
شناسه قالب
T}@T{
نام
T}@T{
توضیحات
T}
_
T{
html
T}@T{
HTML
T}@T{
سند HTML
T}
T{
md
T}@T{
Markdown
T}@T{
قالب متنی Markdown
T}
.TE.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد ویژهٔ dropbox (Dropbox) آورده شده است.
.SS --dropbox-client-id
.PP
شناسه کلاینت OAuth (OAuth Client Id).
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --dropbox-client-secret
.PP
کلید مخفی کلاینت OAuth (OAuth Client Secret).
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفتهٔ ویژهٔ dropbox (Dropbox) آورده شده است.
.SS --dropbox-token
.PP
توکن دسترسی OAuth به‌صورت یک حباب JSON (JSON blob).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --dropbox-auth-url
.PP
نشانی URL سرور احراز هویت (Auth server).
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --dropbox-token-url
.PP
نشانی URL سرور توکن (Token server).
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --dropbox-client-credentials
.PP
استفاده از جریان اطلاعات کاربری کلاینت (Client Credentials Flow) در OAuth.
.PP
این گزینه از جریان OAUTH2 Client Credentials Flow همان‌طور که در RFC
6749 توصیف شده است استفاده می‌کند.
.PP
توجه داشته باشید که این گزینه توسط همهٔ بک‌اندها پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --dropbox-chunk-size
.PP
اندازه تکه‌های بارگذاری (< 150Mi).
.PP
هر فایلی بزرگ‌تر از این مقدار، در تکه‌هایی با این اندازه بارگذاری خواهد شد.
.PP
توجه داشته باشید که تکه‌ها در حافظه بافر می‌شوند (هر بار یک تکه) تا rclone بتواند تلاش‌های مجدد را مدیریت کند.
تنظیم این مقدار روی عددی بزرگ‌تر، سرعت را اندکی افزایش می‌دهد (در آزمایش‌ها حداکثر ۱۰٪ برای 128 MiB) که به بهای مصرف حافظهٔ بیشتر تمام می‌شود.
اگر با کمبود حافظه مواجه هستید، می‌توان آن را روی مقدار کمتری تنظیم کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 48Mi
.SS --dropbox-impersonate
.PP
جعل هویت این کاربر هنگام استفاده از یک حساب تجاری.
.PP
توجه داشته باشید که اگر می‌خواهید از impersonate استفاده کنید، باید مطمئن شوید که این پرچم هنگام اجرای \[dq]rclone config\[dq] تنظیم شده است، زیرا این امر باعث می‌شود rclone دامنهٔ مجوز \[dq]members.read\[dq] را درخواست کند که در حالت عادی انجام نمی‌دهد.
این مورد برای جستجوی آدرس ایمیل اعضا و تبدیل آن به شناسهٔ داخلی که Dropbox در API استفاده می‌کند، ضروری است.
.PP
استفاده از دامنهٔ \[dq]members.read\[dq] نیازمند تأیید یک مدیر تیم Dropbox در طول فرایند OAuth است.
.PP
برای استفاده از این گزینه باید از برنامهٔ اختصاصی خود استفاده کنید (با تنظیم client_id و client_secret خود)، زیرا در حال حاضر مجموعه دسترسی‌های پیش‌فرض rclone شامل \[dq]members.read\[dq] نمی‌شود.
این مورد پس از اینکه نسخهٔ v1.55 یا جدیدتر در همه‌جا مورد استفاده قرار گیرد، می‌تواند افزوده شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: impersonate
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_IMPERSONATE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --dropbox-impersonate-admin
.PP
شناسهٔ مدیر تیم برای استفاده هنگام انجام اقدامات به عنوان مدیر تیم.
.PP
این گزینه هدر Dropbox-API-Select-Admin را با شناسهٔ عضو تیم ارائه‌شده (برای مثال \[dq]dbmid:...\[dq]) تنظیم می‌کند.
.PP
این گزینه شناسهٔ عضو تیم را مستقیماً دریافت می‌کند، نه یک آدرس ایمیل را.
.PP
توجه داشته باشید که اگر می‌خواهید از impersonate_admin استفاده کنید، باید مطمئن شوید این پرچم هنگام اجرای \[dq]rclone config\[dq] تنظیم شده باشد؛ زیرا این کار باعث می‌شود rclone دامنهٔ مجوز \[dq]team_data.member\[dq] را درخواست کند که در حالت عادی درخواست نمی‌کند.
.PP
استفاده از دامنهٔ \[dq]team_data.member\[dq] نیازمند تأیید یک مدیر تیم Dropbox در طول فرایند OAuth خواهد بود.
.PP
برای استفاده از این گزینه باید از برنامهٔ اختصاصی خود استفاده کنید (با تنظیم client_id و client_secret خود)، زیرا در حال حاضر مجموعه دسترسی‌های پیش‌فرض rclone شامل \[dq]team_data.member\[dq] نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: impersonate_admin
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_IMPERSONATE_ADMIN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --dropbox-shared-files
.PP
به rclone دستور می‌دهد که روی تک‌تک فایل‌های هم‌رسانی‌شده کار کند.
.PP
در این حالت، قابلیت‌های rclone به‌شدت محدود است \- تنها عملیات فهرست‌گیری
(ls،‏ lsl و غیره)
و عملیات خواندن (مانند بارگیری) در این حالت پشتیبانی می‌شوند.
تمام عملیات دیگر غیرفعال خواهند شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: shared_files
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_SHARED_FILES
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS \-\-dropbox\-shared\-folders
.PP
به rclone دستور می‌دهد تا روی پوشه‌های اشتراک‌گذاری‌شده کار کند.
.PP
هنگامی که این پرچم بدون مسیر مشخصی استفاده شود، تنها عملیات فهرست‌گیری (List) پشتیبانی می‌شود
و تمام پوشه‌های اشتراک‌گذاری‌شده‌ی در دسترس فهرست خواهند شد.
اگر مسیری را مشخص کنید، بخش اول مسیر به عنوان نام پوشه اشتراک‌گذاری‌شده
تفسیر می‌شود.
سپس rclone تلاش می‌کند تا این پوشه اشتراکی را به فضای نام ریشه (root namespace) متصل (mount) کند.
در صورت موفقیت، rclone به طور عادی روی پوشه اشتراک‌گذاری‌شده پیش می‌رود.
اکنون این پوشه اشتراکی تا حد زیادی شبیه به یک پوشه معمولی عمل کرده و تمام
عملیات استاندارد پشتیبانی می‌شوند.
.PP
توجه داشته باشید که پوشه اشتراک‌گذاری‌شده پس از آن از حالت اتصال خارج (unmount) نمی‌شود،
بنابراین پس از اولین استفاده از یک پوشه اشتراکی مشخص، می‌توان گزینه
\-\-dropbox\-shared\-folders را نادیده گرفت.
.PP
همچنین برای روشی جایگزین جهت کار با پوشه‌های اشتراکی، گزینه \-\-dropbox\-root\-namespace را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: shared_folders
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_SHARED_FOLDERS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS \-\-dropbox\-skip\-shared\-folders
.PP
به rclone دستور می‌دهد از تمام پوشه‌های اشتراک‌گذاری‌شده صرف‌نظر کند.
.PP
در صورت تنظیم، هر پوشه‌ای که یک نقطه اتصال پوشه اشتراکی باشد، صرف‌نظر از مالکیت آن،
از فهرست پوشه‌ها حذف خواهد شد.
این قابلیت زمانی مفید است که بخواهید از پوشه‌های اشتراکی به طور جداگانه و با استفاده از
یک ریموت مجزا که با فضای نام پوشه اشتراکی پیکربندی شده است، پشتیبان بگیرید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: skip_shared_folders
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_SKIP_SHARED_FOLDERS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS \-\-dropbox\-skip\-unowned\-folders
.PP
به rclone دستور می‌دهد پوشه‌های اشتراک‌گذاری‌شده‌ای را که متعلق به کاربر فعلی نیستند نادیده بگیرد.
.PP
در صورت تنظیم، هر پوشه‌ای که یک نقطه اتصال پوشه اشتراکی بوده و متعلق به کاربر فعلی نباشد،
از فهرست دایرکتوری‌ها حذف خواهد شد.
این قابلیت هنگام پشتیبان‌گیری از چندین حساب کاربری Dropbox که پوشه‌های اشتراکی مشترکی دارند،
جهت جلوگیری از تکثیر داده‌های تکراری میان حساب‌ها بسیار مفید است.
.PP
نکته: در Dropbox Business، مالکیت «Team Folders» در اختیار تیم است.
برای اعضای معمولی تیم، این پوشه‌ها به عنوان «بدون مالک» (\[aq]unowned\[aq]) (دسترسی ویرایشگر/بیننده)
ارزیابی می‌شوند و با این پرچم حذف خواهند شد.
برای پشتیبان‌گیری از پوشه‌های Team Folders، از این پرچم استفاده نکنید یا عملیات پشتیبان‌گیری را با
یک حساب مدیر تیم (Team Admin) انجام دهید.
.PP
اگر گزینه \-\-dropbox\-skip\-shared\-folders نیز فعال باشد، این پرچم بی‌اثر خواهد بود.
.PP
این گزینه به ازای هر نقطه اتصال پوشه اشتراکی، یک فراخوانی API اضافی ایجاد می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: skip_unowned_folders
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_SKIP_UNOWNED_FOLDERS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS \-\-dropbox\-pacer\-min\-sleep
.PP
حداقل زمان انتظار (sleep) بین فراخوانی‌های API.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pacer_min_sleep
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_PACER_MIN_SLEEP
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 10ms.SS --dropbox-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر، بخش encoding را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,BackSlash,Del,RightSpace,InvalidUtf8,Dot
.SS --dropbox-root-namespace
.PP
مشخص کردن یک شناسه فضای‌نام (namespace ID) متفاوت Dropbox برای استفاده به‌عنوان ریشه تمام
مسیرها.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_namespace
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_ROOT_NAMESPACE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --dropbox-export-formats
.PP
فهرست جداشده با کاما از قالب‌های ترجیحی برای برون‌بری فایل‌ها
.PP
دسترسی به برخی فایل‌های خاص Dropbox تنها با برون‌بری آن‌ها به قالبی دیگر
امکان‌پذیر است.
این موارد شامل اسناد Dropbox Paper می‌شوند.
.PP
برای هر یک از این فایل‌ها، rclone نخستین قالب این فهرست را
که از نظر Dropbox معتبر باشد انتخاب خواهد کرد.
اگر هیچ‌کدام معتبر نباشد، قالب پیش‌فرض Dropbox را انتخاب خواهد کرد.
.PP
قالب‌های شناخته‌شده عبارت‌اند از: \[dq]html\[dq]، \[dq]md\[dq] (markdown)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: export_formats
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_EXPORT_FORMATS
.IP \[bu] 2
نوع: CommaSepList
.IP \[bu] 2
پیش‌فرض: html,md
.SS --dropbox-skip-exports
.PP
نادیده گرفتن فایل‌های قابل برون‌بری در تمام فهرست‌ها.
.PP
در صورت مشخص شدن، فایل‌های قابل برون‌بری عملاً برای rclone نامرئی می‌شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: skip_exports
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_SKIP_EXPORTS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --dropbox-show-all-exports
.PP
نمایش تمام فایل‌های قابل برون‌بری در فهرست‌ها.
.PP
افزودن این پرچم امکان کپی سمت سرور را برای تمام فایل‌های قابل برون‌بری
فراهم می‌کند.
توجه داشته باشید که rclone در این حالت پسوندی به نام فایل‌های قابل برون‌بری
اضافه نمی‌کند.
.PP
هنگام تلاش برای دانلود فایل‌های قابل برون‌بری از این پرچم استفاده \f[B]نکنید\f[R]
\- rclone در دانلود آن‌ها ناموفق خواهد بود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: show_all_exports
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_SHOW_ALL_EXPORTS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --dropbox-batch-mode
.PP
دسته‌بندی بارگذاری فایل: sync|async|off.
.PP
این گزینه حالت دسته‌بندی (batch mode) مورد استفاده توسط rclone را تعیین می‌کند.
.PP
برای اطلاعات کامل، مستندات اصلی را ببینید: (https://rclone.org/dropbox/#batch-mode)
.PP
این گزینه ۳ مقدار ممکن دارد:
.IP \[bu] 2
off - بدون دسته‌بندی
.IP \[bu] 2
sync - بارگذاری دسته‌ای و بررسی تکمیل فرآیند (پیش‌فرض)
.IP \[bu] 2
async - بارگذاری دسته‌ای و عدم بررسی تکمیل فرآیند
.PP
برنامه rclone هنگام خروج، هرگونه دستهٔ باقی‌مانده را می‌بندد که ممکن است باعث ایجاد تاخیر در خروج شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: batch_mode
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_BATCH_MODE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]sync\[dq]
.SS --dropbox-batch-size
.PP
حداکثر تعداد فایل‌ها در یک دستهٔ بارگذاری.
.PP
این گزینه اندازهٔ دسته فایل‌ها را برای بارگذاری تعیین می‌کند.
این مقدار باید کمتر از ۱۰۰۰ باشد.
.PP
به‌طور پیش‌فرض این مقدار 0 است، به این معنی که rclone اندازهٔ دسته را بسته به تنظیمات batch_mode محاسبه خواهد کرد.
.IP \[bu] 2
batch_mode: async - مقدار پیش‌فرض batch_size برابر 100 است
.IP \[bu] 2
batch_mode: sync - مقدار پیش‌فرض batch_size برابر با مقدار --transfers است
.IP \[bu] 2
batch_mode: off - استفاده نمی‌شود
.PP
برنامه rclone هنگام خروج، هرگونه دستهٔ باقی‌مانده را می‌بندد که ممکن است موجب تاخیر در هنگام خروج شود.
.PP
تنظیم این مقدار در صورتی که تعداد زیادی فایل کوچک را بارگذاری می‌کنید ایدهٔ بسیار خوبی است، زیرا سرعت کار را تا حد زیادی افزایش می‌دهد.
می‌توانید برای به حداکثر رساندن توان عملیاتی از --transfers 32 استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: batch_size
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_BATCH_SIZE
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 0
.SS --dropbox-batch-timeout
.PP
حداکثر زمان مجاز برای بیکار ماندن یک دستهٔ بارگذاری پیش از شروع ارسال.
.PP
اگر یک دستهٔ بارگذاری بیش از این مدت بیکار بماند، بارگذاری خواهد شد.
.PP
مقدار پیش‌فرض این گزینه 0 است، بدین معنی که rclone بر اساس batch_mode مورد استفاده، یک مقدار پیش‌فرض معقول را انتخاب خواهد کرد.
.IP \[bu] 2
batch_mode: async - مقدار پیش‌فرض batch_timeout برابر 10s است
.IP \[bu] 2
batch_mode: sync - مقدار پیش‌فرض batch_timeout برابر 500ms است
.IP \[bu] 2
batch_mode: off - استفاده نمی‌شود
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: batch_timeout
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_BATCH_TIMEOUT
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 0s.SS --dropbox-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_DROPBOX_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS محدودیت‌ها (Limitations)
.PP
توجه داشته باشید که Dropbox به حروف کوچک و بزرگ حساس نیست (case-insensitive)، بنابراین نمی‌توانید هم‌زمان فایلی به نام \[dq]Hello.doc\[dq] و فایلی به نام \[dq]hello.doc\[dq] داشته باشید.
.PP
برخی نام‌های فایل مانند \f[V]thumbs.db\f[R] وجود دارند که Dropbox قادر به ذخیره آن‌ها نیست.
فهرست کاملی از آن‌ها در بخش \[dq]Ignored Files\[dq] این سند (https://www.dropbox.com/en/help/145) آمده است.
در صورتی که rclone برای بارگذاری فایلی با یکی از این نام‌ها تلاش کند، پیام خطای
\f[V]File name disallowed - not uploading\f[R] را صادر می‌کند، اما همگام‌سازی با شکست مواجه نخواهد شد.
.PP
اگر برای همگام‌سازی فایل‌های دارای کپی‌رایت تلاش کنید، ممکن است خطاهایی رخ دهد؛ زیرا Dropbox سامانه تشخیص کپی‌رایت اختصاصی خود را دارد (https://techcrunch.com/2014/03/30/how-dropbox-knows-when-youre-sharing-copyrighted-stuff-without-actually-looking-at-your-stuff) که از دانلود این‌گونه فایل‌ها جلوگیری می‌کند.
این امر موجب بازگرداندن خطای
\f[V]ERROR : /path/to/your/file: Failed to copy: failed to open source object: path/restricted_content/.\f[R]
می‌شود.
.PP
اگر بیش از ۱۰٬۰۰۰ فایل در یک دایرکتوری داشته باشید، دستور
\f[V]rclone purge dropbox:dir\f[R] خطای
\f[V]Failed to purge: There are too many files involved in this operation\f[R] را برمی‌گرداند.
به‌عنوان راه‌حل، ابتدا یک \f[V]rclone delete dropbox:dir\f[R] و در ادامه
یک \f[V]rclone rmdir dropbox:dir\f[R] اجرا کنید.
.PP
هنگام استفاده از \f[V]rclone link\f[R]، اگر از یک حساب غیرشخصی استفاده می‌کنید باید
\f[V]--expire\f[R] را تنظیم کنید، در غیر این صورت ممکن است وضعیت قابلیت مشاهده (visibility) درست نباشد.
(توجه داشته باشید که \f[V]--expire\f[R] در حساب‌های شخصی پشتیبانی نمی‌شود).
گفت‌وگوی انجمن (https://forum.rclone.org/t/rclone-link-dropbox-permissions/23211)
و گزارش مشکل SDK در Dropbox
(https://github.com/dropbox/dropbox-sdk-go-unofficial/issues/75) را ببینید.
.PP
زمان‌های تغییر برای اسناد Dropbox Paper دقیق نیستند و ممکن است تا مدتی پس از ویرایش سند تغییر نکنند.
برای اطمینان از دریافت تغییرات اخیر در همگام‌سازی، یا در حدود یک ساعت صبر کنید یا از \f[V]--ignore-times\f[R] برای تحمیل یک همگام‌سازی کامل استفاده نمایید.
.SS دریافت App ID اختصاصی Dropbox (Get your own Dropbox App ID)
.PP
هنگامی که از rclone با Dropbox در پیکربندی پیش‌فرض استفاده می‌کنید، از App ID متعلق به rclone استفاده می‌کنید.
این شناسه بین تمام کاربران rclone به اشتراک گذاشته شده است.
.PP
روش ایجاد App ID اختصاصی Dropbox برای rclone به شرح زیر است:
.IP "1." 3
با حساب کاربری Dropbox خود وارد کنسول برنامه Dropbox شوید
(https://www.dropbox.com/developers/apps/create) (نیازی نیست همان حسابی باشد که می‌خواهید به آن دسترسی داشته باشید)
.IP "2." 3
یک API انتخاب کنید => این گزینه معمولاً باید \f[V]Dropbox API\f[R] باشد
.IP "3." 3
نوع دسترسی مورد نظر خود را انتخاب کنید => \f[V]Full Dropbox\f[R] یا
\f[V]App Folder\f[R].
اگر می‌خواهید از Team Folders استفاده کنید، گزینه \f[V]Full Dropbox\f[R] الزامی است (اینجا را ببینید:
(https://www.dropboxforum.com/t5/Dropbox-API-Support-Feedback/How-to-create-team-folder-inside-my-app-s-folder/m-p/601005/highlight/true#M27911)).
.IP "4." 3
برای برنامه خود نامی تعیین کنید.
نام برنامه در سطح سراسری (global) یکتا است، بنابراین برای مثال نمی‌توانید از
\f[V]rclone\f[R] استفاده کنید
.IP "5." 3
روی دکمه \f[V]Create App\f[R] کلیک کنید
.IP "6." 3
به برگه \f[V]Permissions\f[R] بروید.
حداقل این مجوزها را فعال کنید: \f[V]account_info.read\f[R]،
\f[V]files.metadata.write\f[R]، \f[V]files.content.write\f[R]،
\f[V]files.content.read\f[R]، \f[V]sharing.write\f[R].
کادرهای انتخاب \f[V]files.metadata.read\f[R] و \f[V]sharing.read\f[R] نیز
علامت خواهند خورد.
روی \f[V]Submit\f[R] کلیک کنید
.IP "7." 3
به برگه \f[V]Settings\f[R] بروید.
بخش \f[V]OAuth2 - Redirect URIs\f[R] را با
\f[V]http://localhost:53682\f[R] پر کرده و روی \f[V]Add\f[R] کلیک کنید
.IP "8." 3
مقادیر \f[V]App key\f[R] و \f[V]App secret\f[R] را در برگه
\f[V]Settings\f[R] پیدا کنید.
از این مقادیر در rclone config برای افزودن یک ریموت جدید یا ویرایش یک
ریموت موجود استفاده کنید.
تنظیم \f[V]App key\f[R] متناظر با \f[V]client_id\f[R] در rclone config
است و \f[V]App secret\f[R] متناظر با \f[V]client_secret\f[R] می‌باشد.SH Enterprise File Fabric
.PP
این backend از Enterprise File Fabric™ متعلق به Storage Made Easy (https://storagemadeeasy.com/about) پشتیبانی می‌کند که یک راهکار نرم‌افزاری برای ادغام و یکپارچه‌سازی ذخیره‌سازی فایل و شیء (File and Object Storage) فراهم کرده و از طریق یک فایل‌سیستم سراسری در دسترس است.
.SS "پیکربندی (Configuration)"
.PP
راه‌اندازی اولیه برای backend مربوط به Enterprise File Fabric شامل دریافت یک توکن (token) از Enterprise File Fabric است که باید آن را از طریق مرورگر خود انجام دهید.
\f[V]rclone config\f[R] شما را در طول این مراحل هدایت می‌کند.
.PP
در اینجا نمونه‌ای از نحوهٔ ایجاد یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / Enterprise File Fabric
   \[rs] \[dq]filefabric\[dq]
[snip]
Storage> filefabric
** See help for filefabric backend at: https://rclone.org/filefabric **

URL of the Enterprise File Fabric to connect to
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / Storage Made Easy US
   \[rs] \[dq]https://storagemadeeasy.com\[dq]
 2 / Storage Made Easy EU
   \[rs] \[dq]https://eu.storagemadeeasy.com\[dq]
 3 / Connect to your Enterprise File Fabric
   \[rs] \[dq]https://yourfabric.smestorage.com\[dq]
url> https://yourfabric.smestorage.com
ID of the root folder
Leave blank normally.

Fill in to make rclone start with directory of a given ID.

Enter a string value. Press Enter for the default (\[dq]\[dq]).
root_folder_id> 
Permanent Authentication Token

A Permanent Authentication Token can be created in the Enterprise File
Fabric, on the users Dashboard under Security, there is an entry
you\[aq]ll see called \[dq]My Authentication Tokens\[dq]. Click the Manage button
to create one.

These tokens are normally valid for several years.

For more info see: https://docs.storagemadeeasy.com/organisationcloud/api-tokens

Enter a string value. Press Enter for the default (\[dq]\[dq]).
permanent_token> xxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxx
Edit advanced config? (y/n)
y) Yes
n) No (default)
y/n> n
Remote config
Configuration complete.
Options:
- type: filefabric
- url: https://yourfabric.smestorage.com
- permanent_token: xxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxx
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (نام ریموت خود را جایگزین \f[V]remote\f[R] کنید):
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح (top level) از Enterprise File Fabric شما
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در Enterprise File Fabric شما
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به دایرکتوری‌ای به نام backup در Enterprise File Fabric
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها
.PP
سرویس Enterprise File Fabric امکان تنظیم زمان‌های تغییر فایل‌ها را با دقت ۱ ثانیه
فراهم می‌کند.
از این زمان‌ها برای تشخیص این‌که آیا اشیاء نیاز به همگام‌سازی دارند یا خیر استفاده خواهد شد.
.PP
در حال حاضر Enterprise File Fabric از هیچ‌گونه هش داده‌ای پشتیبانی
نمی‌کند.
.SS نویسه‌های محدودشده در نام فایل
.PP
مجموعه پیش‌فرض نویسه‌های محدودشده
(https://rclone.org/overview/#restricted-characters) جایگزین خواهد
شد.
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین
خواهند شد (https://rclone.org/overview/#invalid-utf8)، چرا که امکان استفاده
از آن‌ها در رشته‌های JSON وجود ندارد.
.SS فایل‌های خالی
.PP
فایل‌های خالی توسط Enterprise File Fabric پشتیبانی نمی‌شوند.
بنابراین rclone یک فایل خالی را به صورت یک نویسه فاصله منفرد با نوع mime
معادل \f[V]application/vnd.rclone.empty.file\f[R] بارگذاری می‌کند و با فایل‌های دارای آن
نوع mime به عنوان فایل خالی رفتار می‌شود.
.SS شناسه پوشه ریشه (Root folder ID)
.PP
شما می‌توانید \f[V]root_folder_id\f[R] را برای rclone تنظیم کنید.
این همان دایرکتوری است (که با \f[V]Folder ID\f[R] خود مشخص می‌شود) که
rclone آن را به عنوان ریشه Enterprise File Fabric شما در نظر می‌گیرد.
.PP
در حالت عادی این مقدار را خالی می‌گذارید و خود rclone ریشه مناسب
را برای استفاده تعیین خواهد کرد.
.PP
با این حال می‌توانید این مقدار را تنظیم کنید تا rclone به سلسله‌مراتب پوشه
خاصی محدود شود.
.PP
برای انجام این کار باید \f[V]Folder ID\f[R] دایرکتوری‌ای را که می‌خواهید
rclone نمایش دهد، پیدا کنید.
این شناسه‌ها در رابط وب نمایش داده نمی‌شوند، اما می‌توانید از
\f[V]rclone lsf\f[R] برای یافتن آن‌ها استفاده کنید، برای مثال:
.IP
.nf
\f[C]
$ rclone lsf --dirs-only -Fip --csv filefabric:
120673758,Burnt PDFs/
120673759,My Quick Uploads/
120673755,My Syncs/
120673756,My backups/
120673757,My contacts/
120673761,S3 Storage/
\f[R]
.fi
.PP
شناسه مربوط به \[dq]S3 Storage\[dq] برابر با \f[V]120673761\f[R] خواهد بود.
.SS گزینه‌های استاندارد
.PP
در ادامه گزینه‌های استاندارد مختص به filefabric (Enterprise File
Fabric) آمده است.
.SS --filefabric-url
.PP
آدرس اینترنتی (URL) مربوط به Enterprise File Fabric برای اتصال به آن.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: url
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEFABRIC_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]https://storagemadeeasy.com\[dq]
.RS 2
.IP \[bu] 2
Storage Made Easy ایالات متحده
.RE
.IP \[bu] 2
\[dq]https://eu.storagemadeeasy.com\[dq]
.RS 2
.IP \[bu] 2
Storage Made Easy اروپا
.RE
.IP \[bu] 2
\[dq]https://yourfabric.smestorage.com\[dq]
.RS 2
.IP \[bu] 2
اتصال به Enterprise File Fabric شما
.RE
.RE.SS --filefabric-root-folder-id
.PP
شناسه پوشه ریشه.
.PP
در حالت عادی خالی بگذارید.
.PP
برای اینکه rclone با دایرکتوری با یک شناسه معین شروع به کار کند، این مقدار را پر کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_folder_id
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEFABRIC_ROOT_FOLDER_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --filefabric-permanent-token
.PP
توکن احراز هویت دائمی.
.PP
یک توکن احراز هویت دائمی را می‌توان در Enterprise File Fabric ایجاد کرد؛ در پیشخوان کاربر (Dashboard) در بخش Security، مدخلی به نام \[dq]My Authentication Tokens\[dq] مشاهده خواهید کرد.
برای ساخت یکی روی دکمه Manage کلیک کنید.
.PP
این توکن‌ها معمولاً برای چندین سال معتبر هستند.
.PP
برای اطلاعات بیشتر ببینید:
https://docs.storagemadeeasy.com/organisationcloud/api-tokens
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: permanent_token
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEFABRIC_PERMANENT_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مربوط به filefabric (Enterprise File Fabric) آورده شده است.
.SS --filefabric-token
.PP
توکن نشست (Session Token).
.PP
این یک توکن نشست است که rclone آن را در فایل پیکربندی کش می‌کند.
این توکن معمولاً به مدت ۱ ساعت معتبر است.
.PP
این مقدار را تنظیم نکنید \- rclone آن را به‌طور خودکار تنظیم خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEFABRIC_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --filefabric-token-expiry
.PP
زمان انقضای توکن.
.PP
این مقدار را تنظیم نکنید \- rclone آن را به‌طور خودکار تنظیم خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_expiry
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEFABRIC_TOKEN_EXPIRY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --filefabric-version
.PP
نسخه خوانده‌شده از file fabric.
.PP
این مقدار را تنظیم نکنید \- rclone آن را به‌طور خودکار تنظیم خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: version
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEFABRIC_VERSION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --filefabric-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر، بخش کدگذاری را در نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEFABRIC_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,Del,Ctl,InvalidUtf8,Dot
.SS --filefabric-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEFABRIC_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SH FileLu
.PP
سرویس FileLu (https://filelu.com) یک ارائه‌دهنده فضای ذخیره‌سازی ابری قابل اعتماد است که امکاناتی مانند بارگذاری امن فایل، دانلود، گزینه‌های ذخیره‌سازی منعطف و قابلیت‌های اشتراک‌گذاری را ارائه می‌دهد.
با پشتیبانی از ظرفیت‌های ذخیره‌سازی بالا و یکپارچگی روان با rclone، سرویس FileLu مدیریت فایل‌ها را در فضای ابری آسان می‌سازد.
خدمات پشتیبان‌گیری فایل چندسکویی آن به شما امکان می‌دهد از هر دستگاه متصل به اینترنت، فایل‌ها را بارگذاری کرده و نسخه پشتیبان تهیه کنید.
.PP
\f[B]نکته\f[R] اکنون FileLu دارای یک backend کامل S3 به نام FileLu S5 است که یک ذخیره‌ساز شیء سازگار با استاندارد صنعتی S3 به شمار می‌رود.
.SS پیکربندی (Configuration)
.PP
در اینجا مثالی از نحوه ایجاد یک ریموت به نام \f[V]filelu\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> filelu
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
xx / FileLu Cloud Storage
   \[rs] \[dq]filelu\[dq]
[snip]
Storage> filelu
Enter your FileLu Rclone Key:
key> YOUR_FILELU_RCLONE_KEY RC_xxxxxxxxxxxxxxxxxxxxxxxx
Configuration complete.

Keep this \[dq]filelu\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS مسیرها (Paths)
.PP
مسیری بدون \f[V]/\f[R] آغازین در دایرکتوری \f[V]Rclone\f[R] عمل خواهد کرد.
.PP
مسیری با \f[V]/\f[R] آغازین در ریشه عمل می‌کند؛ جایی که می‌توانید دایرکتوری \f[V]Rclone\f[R] را مشاهده کنید.
.IP
.nf
\f[C]
$ rclone lsf TestFileLu:/
CCTV/
Camera/
Documents/
Music/
Photos/
Rclone/
Vault/
Videos/
\f[R]
.fi
.SS دستورهای نمونه (Example Commands)
.PP
ایجاد یک پوشهٔ جدید به نام \f[V]foldername\f[R] در دایرکتوری \f[V]Rclone\f[R]:
.IP
.nf
\f[C]
rclone mkdir filelu:foldername
\f[R]
.fi
.PP
حذف یک پوشه در FileLu:
.IP
.nf
\f[C]
rclone rmdir filelu:/folder/path/
\f[R]
.fi
.PP
حذف یک فایل در FileLu:
.IP
.nf
\f[C]
rclone delete filelu:/hello.txt
\f[R]
.fi
.PP
فهرست کردن فایل‌ها از حساب کاربری FileLu:
.IP
.nf
\f[C]
rclone ls filelu:
\f[R]
.fi
.PP
فهرست کردن تمام پوشه‌ها:
.IP
.nf
\f[C]
rclone lsd filelu:
\f[R]
.fi
.PP
کپی کردن یک فایل مشخص در ریشهٔ FileLu:
.IP
.nf
\f[C]
rclone copy D:\[rs]hello.txt filelu:
\f[R]
.fi
.PP
کپی کردن فایل‌ها از یک دایرکتوری محلی به یک دایرکتوری FileLu:
.IP
.nf
\f[C]
rclone copy D:/local-folder filelu:/remote-folder/path/
\f[R]
.fi
.PP
بارگیری یک فایل از FileLu در یک دایرکتوری محلی:
.IP
.nf
\f[C]
rclone copy filelu:/file-path/hello.txt D:/local-folder
\f[R]
.fi
.PP
انتقال فایل‌ها از یک دایرکتوری محلی به یک دایرکتوری FileLu:
.IP
.nf
\f[C]
rclone move D:\[rs]local-folder filelu:/remote-path/
\f[R]
.fi
.PP
همگام‌سازی فایل‌ها از یک دایرکتوری محلی با یک دایرکتوری FileLu:
.IP
.nf
\f[C]
rclone sync --interactive D:/local-folder filelu:/remote-path/
\f[R]
.fi
.PP
سوار کردن (mount) ریموت بر روی لینوکس محلی:
.IP
.nf
\f[C]
rclone mount filelu: /root/mnt --vfs-cache-mode full
\f[R]
.fi
.PP
سوار کردن (mount) ریموت بر روی ویندوز محلی:
.IP
.nf
\f[C]
rclone mount filelu: D:/local_mnt --vfs-cache-mode full
\f[R]
.fi
.PP
دریافت اطلاعات فضای ذخیره‌سازی حساب FileLu:
.IP
.nf
\f[C]
rclone about filelu:
\f[R]
.fi
.PP
تمام دستورهای دیگر rclone توسط این بک‌اند پشتیبانی می‌شوند..SS استفاده از FolderID به جای مسیر پوشه
.PP
ما برای جلوگیری از بروز خطا در مواردی که کاربران نام‌ها یا مسیرهای پوشه یکسان دارند، به جای نام پوشه از FolderID استفاده می‌کنیم.
برای نمونه، اگر کاربری دو یا سه پوشه به نام
\[dq]test_folders\[dq] داشته باشد، سامانه ممکن است دچار سردرگمی شود و نداند
کدام پوشه را جابه‌جا کند.
در سامانه‌های ذخیره‌سازی بزرگ که برخی کاربران صدها هزار
پوشه و چندین میلیون فایل دارند، نام‌ها یا مسیرهای پوشه تکراری
بسیار رایج هستند.
.SS زمان‌های تغییر و هش‌ها
.PP
سرویس FileLu هم از زمان‌های ویرایش و هم از هش‌های MD5 پشتیبانی می‌کند.
.PP
سرویس FileLu تنها از نام‌های فایل و نام‌های پوشه تا حداکثر ۲۵۵ نویسه
پشتیبانی می‌کند، که در آن هر نویسه یک نویسهٔ یونیکد (Unicode) است.
.SS فایل‌های تکراری
.PP
هنگام بارگذاری و همگام‌سازی از طریق Rclone، سرویس FileLu اجازهٔ بارگذاری
فایل‌های تکراری در یک دایرکتوری یکسان را نمی‌دهد.
با این حال، شما می‌توانید فایل‌های تکراری را بارگذاری کنید، به شرطی که در دایرکتوری‌ها
(پوشه‌ها)ی متفاوتی قرار داشته باشند.
.SS عدم موفقیت در ورود / اعتبارنامه یا کلید نامعتبر
.PP
اطمینان حاصل کنید که کلید Rclone صحیح را در اختیار دارید، که در بخش My
Account (https://filelu.com/account) قابل مشاهده است.
هر بار که در My Account گزینهٔ Rclone را خاموش و روشن (OFF و ON) کنید، یک کلید جدید
به صورت RC_xxxxxxxxxxxxxxxxxxxx تولید می‌شود.
حتماً پیکربندی Rclone خود را با کلید جدید به‌روزرسانی کنید.
.PP
اگر برای نخستین بار به ریموت FileLu خود متصل می‌شوید و با خطایی
مانند خطای زیر مواجه می‌شوید:
.IP
.nf
\f[C]
Failed to create file system for \[dq]my-filelu-remote:\[dq]: couldn\[aq]t login: Invalid credentials
\f[R]
.fi
.PP
اطمینان حاصل کنید که Rclone Key شما درست است.
.SS متوقف‌شدن فرایند (\f[V]killed\f[R])
.PP
حساب‌های دارای فایل‌های حجیم یا کلان‌داده‌های (متادیتای) گسترده ممکن است در طول
عملیات فهرست‌گیری/همگام‌سازی با مصرف حافظهٔ قابل توجهی مواجه شوند.
اطمینان حاصل کنید سامانه‌ای که \f[V]rclone\f[R] را اجرا می‌کند، حافظه و پردازنده (CPU) کافی
برای مدیریت این عملیات‌ها را داشته باشد.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مخصوص filelu (فضای ذخیره‌سازی ابری FileLu) آورده شده است.
.SS --filelu-key
.PP
کلید FileLu Rclone شما از بخش My Account
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: key
.IP \[bu] 2
متغیر محیطی: RCLONE_FILELU_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مخصوص filelu (فضای ذخیره‌سازی ابری FileLu) آورده شده است.
.SS --filelu-upload-cutoff
.PP
آستانهٔ سوئیچ به بارگذاری تکه‌ای (chunked).
هر فایلی بزرگ‌تر از این مقدار، در قطعاتی به اندازهٔ chunk_size بارگذاری خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_FILELU_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 500Mi
.SS --filelu-chunk-size
.PP
اندازهٔ هر تکه برای استفاده در بارگذاری.
برای بارگذاری‌های چندبخشی (multipart) استفاده می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_FILELU_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 64Mi.SS --filelu-encoding
.PP
کدگذاری برای بک‌اند.
.PP
برای اطلاعات بیشتر، بخش کدگذاری را در
بررسی کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_FILELU_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,LtGt,DoubleQuote,SingleQuote,BackQuote,Dollar,Colon,Question,Asterisk,Pipe,Hash,Percent,BackSlash,CrLf,Del,Ctl,LeftSpace,LeftPeriod,LeftTilde,LeftCrLfHtVt,RightSpace,RightPeriod,RightCrLfHtVt,InvalidUtf8,Dot,SquareBracket,Semicolon,Exclamation
.SS --filelu-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_FILELU_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS "محدودیت‌ها (Limitations)"
.PP
این بک‌اند از یک کتابخانهٔ سفارشی که API سرویس FileLu را پیاده‌سازی می‌کند، بهره می‌برد.
اگرچه این بک‌اند از انتقال فایل‌ها پشتیبانی می‌کند، اما ممکن است برخی از قابلیت‌های پیشرفته هنوز در دسترس نباشند.
لطفاً برای عیب‌یابی و دریافت به‌روزرسانی‌ها، هرگونه مشکل را به انجمن rclone (https://forum.rclone.org)
گزارش دهید.
.PP
برای کسب اطلاعات بیشتر، به وبگاه FileLu
(https://filelu.com) مراجعه کنید.
.SH Filen
.SS "پیکربندی (Configuration)"
.PP
راه‌اندازی اولیه برای Filen مستلزم آن است که یک کلید API برای حساب خود دریافت کنید؛ در حال حاضر این کار تنها با استفاده از
Filen CLI (https://github.com/FilenCloudDienste/filen-cli) امکان‌پذیر است.
این بدان معناست که ابتدا باید CLI را دانلود کرده، وارد حساب خود شوید (login) و سپس دستور
\f[V]export-api-key\f[R] را اجرا کنید.
.PP
\f[B]نکته:\f[R] اگر گذرواژهٔ حساب Filen خود را تغییر دهید، باید پیکربندی rclone خود را با گذرواژهٔ جدید و یک کلید API صادر شدهٔ مجدد (از طریق \f[V]export-api-key\f[R]) به‌روزرسانی کنید.
.PP
در اینجا نمونه‌ای از نحوهٔ ایجاد یک ریموت با نام \f[V]FilenRemote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
 rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

name> FilenRemote
Option Storage.

Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Filen
   \[rs] \[dq]filen\[dq]
[snip]
Storage> filen

Option Email.
The email of your Filen account
Enter a value.
Email> youremail\[at]provider.com

Option Password.
The password of your Filen account
Choose an alternative below.
y) Yes, type in my own password
g) Generate random password
y/g> y
Enter the password:
password:
Confirm the password:
password:

Option API Key.
An API Key for your Filen account
Get this using the Filen CLI export-api-key command
You can download the Filen CLI from https://github.com/FilenCloudDienste/filen-cli
Choose an alternative below.
y) Yes, type in my own password
g) Generate random password
y/g> y
Enter the password:
password:
Confirm the password:
password:

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: filen
- Email: youremail\[at]provider.com
- Password: *** ENCRYPTED ***
- API Key: *** ENCRYPTED ***
Keep this \[dq]FilenRemote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها
.PP
زمان‌های تغییر برای فایل‌ها به‌طور کامل پشتیبانی می‌شوند؛ برای دایرکتوری‌ها، تنها زمان ایجاد اهمیت دارد.
.PP
سرویس Filen از هش‌های Blake3 پشتیبانی می‌کند.
.SS نویسه‌های محدودشده برای نام فایل
.PP
بایت‌های نامعتبر UTF-8 جایگزین خواهند شد (https://rclone.org/overview/#invalid-utf8)
.SS کلید API
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص به filen (Filen) آورده شده است.
.SS --filen-email
.PP
ایمیل حساب Filen شما
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: email
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEN_EMAIL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --filen-password
.PP
رمز عبور حساب Filen شما
.PP
\f[B]نکته:\f[R] ورودی این مقدار باید مبهم‌سازی شود \- به rclone obscure (https://rclone.org/commands/rclone_obscure) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: password
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEN_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --filen-api-key
.PP
کلید API برای حساب Filen شما
.PP
این مقدار را با استفاده از دستور export-api-key در Filen CLI دریافت کنید. می‌توانید Filen CLI را از https://github.com/FilenCloudDienste/filen-cli بارگیری کنید.
.PP
\f[B]نکته:\f[R] ورودی این مقدار باید مبهم‌سازی شود \- به rclone obscure (https://rclone.org/commands/rclone_obscure) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: api_key
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEN_API_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفتهٔ مختص به filen (Filen) آورده شده است.
.SS --filen-upload-concurrency
.PP
همزمانی برای بارگذاری‌های چندبخشی (chunked).
.PP
این مقدار حد بالایی است برای اینکه چه تعداد انتقال به‌صورت هم‌روند برای یک فایل اجرا شوند.
تنظیم این گزینه روی مقداری کوچک‌تر از 1 باعث بن‌بست (deadlock) بارگذاری‌ها خواهد شد.
.PP
اگر تعداد کمی از فایل‌های حجیم را روی پیوندهای پرسرعت بارگذاری می‌کنید و این بارگذاری‌ها از تمام پهنای باند شما استفاده نمی‌کنند، افزایش این مقدار می‌تواند به افزایش سرعت انتقال‌ها کمک کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEN_UPLOAD_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 16.SS --filen-encoding
.PP
کدگذاری برای بک‌اند.
.PP
برای اطلاعات بیشتر، بخش کدگذاری در نمای کلی (https://rclone.org/overview/#encoding) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEN_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,Del,Ctl,InvalidUtf8,Dot
.SS --filen-master-keys
.PP
کلیدهای اصلی (فقط برای استفاده داخلی)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: master_keys
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEN_MASTER_KEYS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --filen-private-key
.PP
کلید خصوصی RSA (فقط برای استفاده داخلی)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: private_key
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEN_PRIVATE_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --filen-public-key
.PP
کلید عمومی RSA (فقط برای استفاده داخلی)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: public_key
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEN_PUBLIC_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --filen-auth-version
.PP
نسخه احراز هویت (فقط برای استفاده داخلی)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_version
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEN_AUTH_VERSION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --filen-base-folder-uuid
.PP
شناسه UUID دایرکتوری ریشه حساب (فقط برای استفاده داخلی)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: base_folder_uuid
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEN_BASE_FOLDER_UUID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --filen-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_FILEN_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SH Files.com
.PP
سرویس Files.com (https://www.files.com) یک سرویس ذخیره‌سازی ابری است که
روشی امن و آسان را برای ذخیره و به‌اشتراک‌گذاری فایل‌ها فراهم می‌کند.
.PP
راه‌اندازی اولیه برای filescom نیازمند احراز هویت با حساب
Files.com شما است.
می‌توانید این کار را با وارد کردن زیردامنهٔ سایت، نام کاربری و
گذرواژهٔ خود انجام دهید.
همچنین می‌توانید با استفاده از یک کلید API از
Files.com (https://www.files.com/docs/sdk-and-apis/api-keys) احراز هویت کنید.
دستور \f[V]rclone config\f[R] مراحل آن را قدم‌به‌قدم برای شما پیش می‌برد.
.SS پیکربندی (Configuration)
.PP
در اینجا نمونه‌ای از نحوهٔ ساخت یک ریموت به نام \f[V]remote\f[R] آمده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این کار شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> remote

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Files.com
  \[rs] \[dq]filescom\[dq]
[snip]
Storage> filescom

Option site.
Your site subdomain (e.g. mysite) or custom domain (e.g. myfiles.customdomain.com)
Enter a value. Press Enter to leave empty.
site> mysite

Option username.
The username used to authenticate with Files.com.
Enter a value. Press Enter to leave empty.
username> user

Option password.
The password used to authenticate with Files.com.
Choose an alternative below. Press Enter for the default (n).
y) Yes, type in my own password
g) Generate random password
n) No, leave this optional password blank (default)
y/g/n> y
Enter the password:
password:
Confirm the password:
password:

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: filescom
- site: mysite
- username: user
- password: *** ENCRYPTED ***
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
پس از پیکربندی می‌توانید از rclone استفاده کنید.
.PP
مشاهدهٔ تمام فایل‌ها در بالاترین سطح:
.IP
.nf
\f[C]
rclone lsf remote:
\f[R]
.fi
.PP
ایجاد یک دایرکتوری جدید در ریشه:
.IP
.nf
\f[C]
rclone mkdir remote:dir
\f[R]
.fi
.PP
فهرست‌کردن بازگشتی محتویات:
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با دایرکتوری ریموت، و حذف
هرگونه فایل اضافی در دایرکتوری:
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory remote:dir
\f[R]
.fi.SS هش‌ها (Hashes)
.PP
در دسامبر ۲۰۲۴ \f[V]files.com\f[R] پشتیبانی از چک‌سام‌های بیشتری را آغاز کرد (https://www.files.com/blog/2024/11/01/new-modern-checksum-options-now-available-with-opt).
.PP
با این حال اگر به هش‌ها نیاز دارید، \f[B]باید\f[R] با رفتن به بخش \[dq]File Integrity\[dq] در \[dq]Data Governance\[dq] آن‌ها را در سایت خود فعال کنید تا تنظیمات پیکربندی شده و الگوریتم‌های چک‌سامی که با نیازمندی‌های شما مطابقت دارند انتخاب شوند.
.PP
در حال حاضر Rclone برای استفاده در همگام‌سازی تنها از CRC32 و MD5 پشتیبانی می‌کند، اما انتخاب چک‌سام‌های بیشتر تأثیری بر عملیات rclone نخواهد داشت.
.PP
برای استفاده با rclone، انتخاب حداقل MD5 توصیه می‌شود تا rclone بتواند بررسی صحت سرتاسری را انجام دهد.
.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص به filescom (Files.com) آمده است.
.SS --filescom-site
.PP
زیردامنه سایت شما (مانند mysite) یا دامنه سفارشی (مانند myfiles.customdomain.com).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: site
.IP \[bu] 2
متغیر محیطی: RCLONE_FILESCOM_SITE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --filescom-username
.PP
نام کاربری مورد استفاده برای احراز هویت با Files.com.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: username
.IP \[bu] 2
متغیر محیطی: RCLONE_FILESCOM_USERNAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --filescom-password
.PP
گذرواژه مورد استفاده برای احراز هویت با Files.com.
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی شود - مستندات rclone obscure (https://rclone.org/commands/rclone_obscure) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: password
.IP \[bu] 2
متغیر محیطی: RCLONE_FILESCOM_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مختص به filescom (Files.com) آمده است.
.SS --filescom-api-key
.PP
کلید API مورد استفاده برای احراز هویت با Files.com.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: api_key
.IP \[bu] 2
متغیر محیطی: RCLONE_FILESCOM_API_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --filescom-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر بخش encoding را در نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_FILESCOM_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,BackSlash,Del,Ctl,RightSpace,RightCrLfHtVt,InvalidUtf8,Dot.SS --filescom-description
.PP
توضیحات مربوط به ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_FILESCOM_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SH FTP
.PP
‏FTP همان پروتکل انتقال فایل (File Transfer Protocol) است.
پشتیبانی Rclone از FTP با استفاده از بسته
github.com/jlaffaye/ftp (https://godoc.org/github.com/jlaffaye/ftp)
ارائه می‌شود.
.PP
محدودیت‌های بک‌اند FTP در Rclone
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
اگر مسیر با \f[V]/\f[R] آغاز نشود، نسبت به دایرکتوری خانگی کاربر سنجیده می‌شود.
مسیر خالی \f[V]remote:\f[R] به دایرکتوری خانگی کاربر اشاره دارد.
.SS "پیکربندی (Configuration)"
.PP
برای ایجاد یک پیکربندی FTP به نام \f[V]remote\f[R]، دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
دستور rclone config شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند.
تعریف حداقلی یک ریموت FTP در rclone تنها به host، نام کاربری (username) و گذرواژه (password) نیاز دارد.
برای سرور FTP ناشناس (anonymous)، بخش زیر را ببینید.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
n/r/c/s/q> n
name> remote
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / FTP
   \[rs] \[dq]ftp\[dq]
[snip]
Storage> ftp
** See help for ftp backend at: https://rclone.org/ftp **

FTP host to connect to
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / Connect to ftp.example.com
   \[rs] \[dq]ftp.example.com\[dq]
host> ftp.example.com
FTP username
Enter a string value. Press Enter for the default (\[dq]$USER\[dq]).
user> 
FTP port number
Enter a signed integer. Press Enter for the default (21).
port> 
FTP password
y) Yes type in my own password
g) Generate random password
y/g> y
Enter the password:
password:
Confirm the password:
password:
Use FTP over TLS (Implicit)
Enter a boolean value (true or false). Press Enter for the default (\[dq]false\[dq]).
tls> 
Use FTP over TLS (Explicit)
Enter a boolean value (true or false). Press Enter for the default (\[dq]false\[dq]).
explicit_tls> 
Remote config
Configuration complete.
Options:
- type: ftp
- host: ftp.example.com
- pass: *** ENCRYPTED ***
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
برای مشاهده همه دایرکتوری‌ها در دایرکتوری خانگی \f[V]remote\f[R]:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
ایجاد یک دایرکتوری جدید:
.IP
.nf
\f[C]
rclone mkdir remote:path/to/directory
\f[R]
.fi
.PP
فهرست کردن محتویات یک دایرکتوری:
.IP
.nf
\f[C]
rclone ls remote:path/to/directory
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با دایرکتوری ریموت و حذف فایل‌های اضافی در دایرکتوری مقصد:
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory remote:directory
\f[R]
.fi.SS اف‌تی‌پی ناشناس (Anonymous FTP)
.PP
هنگام اتصال به یک کارساز FTP که ورود ناشناس (anonymous) را مجاز می‌داند، می‌توانید از نام کاربری ویژهٔ \[dq]anonymous\[dq] استفاده کنید.
به‌طور سنتی، این حساب کاربری هر رشته‌ای را به عنوان گذرواژه می‌پذیرد، هرچند استفاده از گذرواژه‌های \[dq]anonymous\[dq] یا \[dq]guest\[dq] رایج است.
برخی کارسازها وارد کردن یک نشانی ایمیل معتبر را به عنوان گذرواژه الزامی می‌دانند.
.PP
استفاده از ریموت‌های آنی (on-the-fly) یا رشتهٔ اتصال (https://rclone.org/docs/#connection-strings) دسترسی به چنین کارسازهایی را بدون نیاز به هیچ پیکربندی اولیه‌ای آسان می‌کند.
موارد زیر مثال‌هایی از این موضوع هستند:
.IP
.nf
\f[C]
rclone lsf :ftp: --ftp-host=speedtest.tele2.net --ftp-user=anonymous --ftp-pass=$(rclone obscure dummy)
rclone lsf :ftp,host=speedtest.tele2.net,user=anonymous,pass=$(rclone obscure dummy):
\f[R]
.fi
.PP
مثال‌های بالا در شل‌های لینوکس و در PowerShell کار می‌کنند، اما در Command Prompt ویندوز کار نمی‌کنند.
آن‌ها دستور rclone obscure (https://rclone.org/commands/rclone_obscure) را برای ساخت یک رشتهٔ گذرواژه در قالب مورد نیاز گزینهٔ pass اجرا می‌کنند.
مثال‌های زیر دقیقاً یکسان هستند، با این تفاوت که از نمای متنی از پیش مبهم‌شدهٔ (obscured) همان گذرواژهٔ \[dq]dummy\[dq] استفاده می‌کنند، و بنابراین حتی در Command Prompt ویندوز نیز کار می‌کنند:
.IP
.nf
\f[C]
rclone lsf :ftp: --ftp-host=speedtest.tele2.net --ftp-user=anonymous --ftp-pass=IXs2wc8OJOz7SYLBk47Ji1rHTmxM
rclone lsf :ftp,host=speedtest.tele2.net,user=anonymous,pass=IXs2wc8OJOz7SYLBk47Ji1rHTmxM:
\f[R]
.fi
.SS تی‌ال‌اس ضمنی (Implicit TLS)
.PP
ابزار rclone FTP از کارسازهای FTP بر بستر TLS ضمنی (FTPS) پشتیبانی می‌کند.
این قابلیت باید در پیکربندی بک‌اند FTP برای ریموت یا با \f[V]--ftp-tls\f[R] فعال شود.
درگاه پیش‌فرض FTPS برابر با \f[V]990\f[R] است، نه \f[V]21\f[R]، و می‌تواند با \f[V]--ftp-port\f[R] تنظیم شود.
.SS گزینه‌های TLS (TLS Options)
.PP
گزینه‌های TLS برای TLS ضمنی و صریح را می‌توان با استفاده از پرچم‌های زیر که مختص بک‌اند FTP هستند تنظیم کرد:
.IP
.nf
\f[C]
--ftp-no-check-certificate     عدم اعتبارسنجی گواهی TLS کارساز
--ftp-disable-tls13            غیرفعال‌سازی TLS 1.3 (راهکار دورزدن برای کارسازهای FTP با TLS معیوب)
--ftp-tls-cache-size int       اندازهٔ حافظه موقت نشست TLS برای تمامی اتصال‌های داده و کنترلی (پیش‌فرض 32)
\f[R]
.fi
.PP
با این حال، هر یک از پرچم‌های عمومی TLS نیز می‌توانند استفاده شوند؛ مانند:
.IP
.nf
\f[C]
--ca-cert stringArray          گواهی CA مورد استفاده برای اعتبارسنجی کارسازها
--client-cert string           گواهی SSL کلاینت (PEM) برای احراز هویت دوجانبهٔ TLS
--client-key string            کلید خصوصی SSL کلاینت (PEM) برای احراز هویت دوجانبهٔ TLS
--no-check-certificate         عدم اعتبارسنجی گواهی SSL کارساز (ناامن)
\f[R]
.fi
.PP
اگر لازم است این موارد در فایل پیکربندی قرار داده شوند تا فقط بر بک‌اند FTP اعمال شوند، از ساختار \f[V]override\f[R] استفاده کنید؛ به عنوان مثال:
.IP
.nf
\f[C]
override.ca_cert = XXX
override.client_cert = XXX
override.client_key = XXX
\f[R]
.fi
.SS نویسه‌های محدودشده در نام فایل (Restricted filename characters)
.PP
علاوه بر مجموعه نویسه‌های محدودشدهٔ پیش‌فرض (https://rclone.org/overview/#restricted-characters)، نویسه‌های زیر نیز جایگزین می‌شوند:
.PP
نام فایل‌ها نمی‌توانند به نویسه‌های زیر ختم شوند.
جایگزینی تنها محدود به آخرین نویسه در نام فایل است:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
SP
T}@T{
0x20
T}@T{
␠
T}
.TE
.PP
همهٔ کارسازهای FTP قادر به پذیرش تمام نویسه‌ها در نام فایل‌ها نیستند؛ به عنوان مثال:
.PP
.TS
tab(@);
l c.
T{
کارساز FTP
T}@T{
نویسه‌های غیرمجاز
T}
_
T{
proftpd
T}@T{
\f[V]*\f[R]
T}
T{
pureftpd
T}@T{
\f[V]\[rs] [ ]\f[R]
T}
.TE
.PP
راهنمای پیکربندی تعاملی این بک‌اند مجموعه‌ای از تنظیمات کدگذاری منطقی را برای کارسازهای اصلی FTP ارائه می‌دهد: ProFTPd، PureFTPd، VsFTPd.
کافی است هنگام درخواست، شمارهٔ گزینهٔ مورد نظر را وارد کنید..SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص ftp (FTP) آورده شده است.
.SS --ftp-host
.PP
میزبان FTP جهت اتصال.
.PP
به‌عنوان مثال:
\[dq]ftp.example.com\[dq].
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: host
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_HOST
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --ftp-user
.PP
نام کاربری FTP.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_USER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]$USER\[dq]
.SS --ftp-port
.PP
شماره پورت FTP.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: port
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_PORT
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 21
.SS --ftp-pass
.PP
گذرواژه FTP.
.PP
\f[B]توجه:\f[R] ورودی این مقدار باید مبهم‌سازی شود \- به rclone
obscure (https://rclone.org/commands/rclone_obscure) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pass
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_PASS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --ftp-tls
.PP
استفاده از FTPS ضمنی (FTP over TLS).
.PP
هنگام استفاده از FTP ضمنی بر بستر TLS، کلاینت درست از همان ابتدا با استفاده از TLS
متصل می‌شود که سازگاری با سرورهای فاقد پشتیبانی از TLS را از بین می‌برد.
این مورد معمولاً روی پورت 990 به‌جای پورت 21 ارائه می‌شود.
نمی‌توان آن را در ترکیب با FTPS صریح استفاده کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: tls
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_TLS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --ftp-explicit-tls
.PP
استفاده از FTPS صریح (FTP over TLS).
.PP
هنگام استفاده از FTP صریح بر بستر TLS، کلاینت به‌طور صریح امنیت را از سرور
درخواست می‌کند تا اتصال متن ساده را به یک اتصال رمزنگاری‌شده ارتقا دهد.
نمی‌توان آن را در ترکیب با FTPS ضمنی استفاده کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: explicit_tls
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_EXPLICIT_TLS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته ویژه ftp (FTP) آورده شده است.
.SS --ftp-concurrency
.PP
حداکثر تعداد اتصال‌های هم‌زمان FTP؛ مقدار 0 برای نامحدود.
.PP
توجه داشته باشید که تنظیم این مقدار به احتمال بسیار زیاد باعث ایجاد بن‌بست (deadlock) می‌شود، بنابراین باید با احتیاط استفاده شود.
.PP
اگر در حال انجام sync یا copy هستید، اطمینان حاصل کنید که مقدار هم‌زمانی یکی بیشتر از مجموع \f[V]--transfers\f[R] و \f[V]--checkers\f[R] باشد.
.PP
اگر از \f[V]--check-first\f[R] استفاده می‌کنید، تنها کافی است یکی بیشتر از بیشینه بین \f[V]--checkers\f[R] و \f[V]--transfers\f[R] باشد.
.PP
بنابراین برای \f[V]concurrency 3\f[R] باید از \f[V]--checkers 2 --transfers 2 --check-first\f[R] یا \f[V]--checkers 1 --transfers 1\f[R] استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 0
.SS --ftp-no-check-certificate
.PP
عدم اعتبارسنجی گواهی TLS سرور.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_check_certificate
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_NO_CHECK_CERTIFICATE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --ftp-disable-epsv
.PP
غیرفعال کردن استفاده از EPSV حتی در صورتی که سرور اعلام پشتیبانی کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_epsv
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_DISABLE_EPSV
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --ftp-disable-mlsd
.PP
غیرفعال کردن استفاده از MLSD حتی در صورتی که سرور اعلام پشتیبانی کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_mlsd
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_DISABLE_MLSD
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --ftp-disable-utf8
.PP
غیرفعال کردن استفاده از UTF-8 حتی در صورتی که سرور اعلام پشتیبانی کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_utf8
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_DISABLE_UTF8
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --ftp-writing-mdtm
.PP
استفاده از MDTM برای تنظیم زمان ویرایش (رفتار خاص VsFtpd)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: writing_mdtm
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_WRITING_MDTM
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --ftp-force-list-hidden
.PP
استفاده از LIST \-a برای اجبار به فهرست‌کردن فایل‌ها و پوشه‌های مخفی.
این کار استفاده از MLSD را غیرفعال خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: force_list_hidden
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_FORCE_LIST_HIDDEN
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --ftp-idle-timeout
.PP
حداکثر زمان قبل از بستن اتصال‌های بیکار.
.PP
اگر در زمان تعیین‌شده هیچ اتصالی به استخر اتصال بازگردانده نشود، rclone استخر اتصال را خالی خواهد کرد.
.PP
برای باز نگه‌داشتن اتصال‌ها به مدت نامحدود، مقدار را روی 0 تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: idle_timeout
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_IDLE_TIMEOUT
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 1m0s
.SS --ftp-close-timeout
.PP
حداکثر زمان انتظار برای دریافت پاسخ بسته‌شدن.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: close_timeout
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_CLOSE_TIMEOUT
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 1m0s
.SS --ftp-tls-cache-size
.PP
اندازه حافظه پنهان نشست TLS برای تمامی اتصال‌های کنترل و داده.
.PP
حافظه پنهان TLS امکان ازسرگیری نشست‌های TLS و استفاده مجدد از PSK را بین اتصالات فراهم می‌کند.
اگر اندازه پیش‌فرض کافی نیست و باعث بروز خطاهای ازسرگیری TLS می‌شود، آن را افزایش دهید.
به‌طور پیش‌فرض فعال است.
برای غیرفعال کردن از 0 استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: tls_cache_size
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_TLS_CACHE_SIZE
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 32
.SS --ftp-disable-tls13
.PP
غیرفعال‌سازی TLS 1.3 (راهکاری برای سرورهای FTP با پیاده‌سازی معیوب TLS)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_tls13
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_DISABLE_TLS13
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --ftp-allow-insecure-tls-ciphers
.PP
مجاز کردن سایفرهای ناامن TLS
.PP
تنظیم این گزینه، علاوه بر مقادیر پیش‌فرض امن، اجازه استفاده از سایفرهای TLS زیر را می‌دهد:
.IP \[bu] 2
TLS_RSA_WITH_AES_128_GCM_SHA256
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: allow_insecure_tls_ciphers
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_ALLOW_INSECURE_TLS_CIPHERS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --ftp-shut-timeout
.PP
حداکثر زمان انتظار برای وضعیت بسته‌شدن اتصال داده.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: shut_timeout
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_SHUT_TIMEOUT
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 1m0s
.SS --ftp-ask-password
.PP
اجازه درخواست گذرواژه FTP در صورت نیاز.
.PP
اگر این گزینه تنظیم شود و گذرواژه‌ای ارائه نشده باشد، rclone درخواست گذرواژه خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: ask_password
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_ASK_PASSWORD
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --ftp-socks-proxy
.PP
میزبان پروکسی Socks 5.
.PP
از قالب‌های user:pass\[at]host:port، user\[at]host:port و host:port پشتیبانی می‌کند.
.PP
مثال:
.IP
.nf
\f[C]
myUser:myPass\[at]localhost:9005
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: socks_proxy
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_SOCKS_PROXY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --ftp-http-proxy
.PP
نشانی اینترنتی (URL) برای پروکسی HTTP CONNECT
.PP
این گزینه را روی نشانی اینترنتی (URL) یک پروکسی HTTP تنظیم کنید که از فعل HTTP CONNECT پشتیبانی می‌کند.
.PP
از قالب‌های http://user:pass\[at]host:port، http://host:port و http://host پشتیبانی می‌کند.
.PP
مثال:
.IP
.nf
\f[C]
http://myUser:myPass\[at]proxyhostname.example.com:8000
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: http_proxy
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_HTTP_PROXY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --ftp-no-check-upload
.PP
عدم بررسی صحت بارگذاری
.PP
به‌طور معمول rclone پس از بارگذاری یک فایل، وجود فایل بارگذاری‌شده را بررسی می‌کند
تا مطمئن شود اندازه و زمان ویرایش آن مطابق انتظار است.
.PP
این پرچم مانع از انجام این بررسی‌ها توسط rclone می‌شود.
این کار امکان بارگذاری در پوشه‌های فقط‌نوشتنی (write only) را فراهم می‌کند.
.PP
اگر در یک پوشهٔ فقط‌نوشتنی بارگذاری می‌کنید، احتمالاً نیاز خواهید داشت از
پرچم \-\-inplace نیز استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_check_upload
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_NO_CHECK_UPLOAD
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --ftp-encoding
.PP
کدگذاری برای پسانه (backend).
.PP
برای اطلاعات بیشتر، بخش encoding را در
نمای کلی (<https://rclone.org/overview/#encoding>) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,Del,Ctl,RightSpace,Dot
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]Asterisk,Ctl,Dot,Slash\[dq]
.RS 2
.IP \[bu] 2
کارساز ProFTPd نمی‌تواند \[aq]*\[aq] را در نام فایل‌ها مدیریت کند
.RE
.IP \[bu] 2
\[dq]BackSlash,Ctl,Del,Dot,RightSpace,Slash,SquareBracket\[dq]
.RS 2
.IP \[bu] 2
کارساز PureFTPd نمی‌تواند \[aq][]\[aq] یا \[aq]*\[aq] را در نام فایل‌ها مدیریت کند
.RE
.IP \[bu] 2
\[dq]Ctl,LeftPeriod,Slash\[dq]
.RS 2
.IP \[bu] 2
کارساز VsFTPd نمی‌تواند نام فایل‌هایی که با نقطه آغاز می‌شوند را مدیریت کند
.RE
.RE
.SS --ftp-description
.PP
توضیحات ریموت (remote).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_FTP_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS "محدودیت‌ها (Limitations)"
.PP
کارگزارهای FTP که به‌عنوان ریموت‌های rclone عمل می‌کنند باید از حالت \f[V]passive\f[R]
پشتیبانی کنند.
این حالت قابل تغییر و پیکربندی نیست زیرا \f[V]passive\f[R] تنها حالت پشتیبانی‌شده
است.
پیاده‌سازی FTP در rclone با حالت \f[V]active\f[R] سازگار نیست، زیرا کتابخانه‌ای
که از آن استفاده می‌کند از این حالت پشتیبانی
نمی‌کند (<https://github.com/jlaffaye/ftp/issues/29>).
به‌دلیل نگرانی‌های امنیتی، این حالت احتمالاً هرگز پشتیبانی نخواهد شد.
.PP
پسانهٔ FTP در rclone از هیچ چِک‌سامی (checksum) پشتیبانی نمی‌کند، اما می‌تواند اندازهٔ
فایل‌ها را مقایسه کند.
.PP
دستور \f[V]rclone about\f[R] توسط پسانهٔ FTP پشتیبانی نمی‌شود.
پسانه‌های بدون این قابلیت نمی‌توانند فضای آزاد را برای یک mount در rclone تعیین کنند
یا از خط‌مشی \f[V]mfs\f[R] (بیشترین فضای خالی) به‌عنوان عضوی از یک ریموت union در rclone
استفاده کنند.
.PP
فهرست پسانه‌هایی که از rclone about پشتیبانی
نمی‌کنند (<https://rclone.org/overview/#optional-features>) و
مستندات rclone about (<https://rclone.org/commands/rclone_about>) را ببینید.
.PP
پیاده‌سازی: \f[V]--dump headers\f[R]،
\f[V]--dump bodies\f[R]، \f[V]--dump auth\f[R] برای اشکال‌زدایی همانند پسانه‌های
مبتنی بر HTTP در rclone نیست \- سطح جزئیات و کنترل دقیق کمتری دارد.
.PP
گزینهٔ \f[V]--timeout\f[R] پشتیبانی نمی‌شود (اما \f[V]--contimeout\f[R] پشتیبانی می‌شود).
.PP
گزینهٔ \f[V]--bind\f[R] پشتیبانی نمی‌شود.
.PP
پسانهٔ FTP در rclone قابلیت پشتیبانی از جابه‌جایی در سمت سرور (server-side move) را
دارد، اما در حال حاضر این کار انجام نمی‌شود.
.PP
متغیر محیطی \f[V]ftp_proxy\f[R] در حال حاضر پشتیبانی نمی‌شود..SS زمان‌های تغییر (Modification times)
.PP
زمان تغییر فایل (برچسب‌های زمان) با تفکیک‌پذیری ۱ ثانیه برای کارگزارهای اصلی FTP پشتیبانی می‌شود: ProFTPd، PureFTPd، VsFTPd و کارگزار FTP FileZilla.
کارگزار \f[V]VsFTPd\f[R] دارای پیاده‌سازی غیراستانداردی از دستورات پروتکل مرتبط با زمان است و به یک تنظیم پیکربندی ویژه نیاز دارد:
\f[V]writing_mdtm = true\f[R].
.PP
پشتیبانی از زمان دقیق فایل در دیگر کارگزارهای FTP بسته به اینکه چه افزونه‌های پروتکلی را اعلان می‌کنند، متفاوت است.
اگر تمام افزونه‌های \f[V]MLSD\f[R]، \f[V]MDTM\f[R] و \f[V]MFTM\f[R] موجود باشند، rclone از آن‌ها در کنار یکدیگر برای ارائه زمان دقیق استفاده خواهد کرد.
در غیر این صورت، زمان‌هایی که روی کارگزار FTP از طریق rclone مشاهده می‌کنید مربوط به زمان آخرین بارگذاری فایل خواهند بود.
.PP
می‌توانید از دستور زیر برای بررسی اینکه آیا rclone می‌تواند با کارگزار FTP شما از زمان دقیق استفاده کند بهره ببرید:
\f[V]rclone backend features your_ftp_remote:\f[R] (دو‌نقطه انتهایی مهم است).
به دنبال عددی در خط نشانه‌گذاری‌شده با \f[V]Precision\f[R] بگردید که مشخص‌کننده دقت زمان ریموت بر حسب نانوثانیه است.
مقدار \f[V]1000000000\f[R] به این معنی است که دقت زمان فایل ۱ ثانیه‌ای در دسترس است.
مقدار \f[V]3153600000000000000\f[R] (یا یک عدد بزرگ دیگر) به معنی \[dq]پشتیبانی‌نشده\[dq] است.
.SH Gofile
.PP
پلتفرم Gofile (https://gofile.io) یک بستر ذخیره‌سازی و توزیع محتوا است.
هدف آن ارائه بیشترین خدمات ممکن به‌صورت رایگان یا با هزینه‌ای بسیار کم است.
.PP
راه‌اندازی اولیه Gofile شامل ورود به رابط وب و رفتن به بخش \[dq]My Profile\[dq] است.
مقدار \[dq]Account API token\[dq] را برای استفاده در فایل پیکربندی کپی کنید.
.PP
توجه داشته باشید اگر مایلید rclone را به Gofile متصل کنید، به یک حساب پریمیوم نیاز خواهید داشت.
.SS پیکربندی (Configuration)
.PP
در اینجا مثالی از نحوه ایجاد یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> remote

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
XX / Gofile
   \[rs] (gofile)
Storage> gofile

Option access_token.
API Access token
You can get this from the web control panel.
Enter a value. Press Enter to leave empty.
access_token> YOURACCESSTOKEN

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: gofile
- access_token: YOURACCESSTOKEN
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (عبارت \f[V]remote\f[R] را با نامی که به ریموت خود اختصاص داده‌اید جایگزین کنید):
.PP
فهرست کردن دایرکتوری‌ها و فایل‌ها در بالاترین سطح Gofile شما:
.IP
.nf
\f[C]
rclone lsf remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به یک دایرکتوری در Gofile به نام backup:
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها
.PP
Gofile از زمان‌های تغییر با دقت ۱ ثانیه پشتیبانی می‌کند.
.PP
Gofile از هش‌های MD5 پشتیبانی می‌کند، بنابراین می‌توانید از پرچم \f[V]--checksum\f[R]
استفاده کنید.
.SS نویسه‌های محدودشده در نام فایل
.PP
علاوه بر مجموعه پیش‌فرض نویسه‌های محدودشده
(https://rclone.org/overview/#restricted-characters)، نویسه‌های زیر
نیز جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
!
T}@T{
0x21
T}@T{
！
T}
T{
\[dq]
T}@T{
0x22
T}@T{
＂
T}
T{
*
T}@T{
0x2A
T}@T{
＊
T}
T{
:
T}@T{
0x3A
T}@T{
：
T}
T{
<
T}@T{
0x3C
T}@T{
＜
T}
T{
>
T}@T{
0x3E
T}@T{
＞
T}
T{
?
T}@T{
0x3F
T}@T{
？
T}
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
T{
|
T}@T{
0x7C
T}@T{
｜
T}
.TE
.PP
همچنین نام‌های فایل نمی‌توانند با نویسه‌های زیر آغاز شوند یا پایان یابند.
این نویسه‌ها تنها در صورتی جایگزین می‌شوند که نویسه نخست یا پایانی
در نام باشند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\&.
T}@T{
0x2E
T}@T{
．
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند
شد (https://rclone.org/overview/#invalid-utf8)، زیرا نمی‌توان
از آن‌ها در رشته‌های JSON استفاده کرد..SS پیوندهای عمومی (Public Links)
.PP
Gofile از \f[V]rclone link\f[R] برای ایجاد پیوندهای عمومی به فایل‌ها یا
دایرکتوری‌ها پشتیبانی می‌کند.
اگر یک دایرکتوری را مشخص کنید، به صورت یک فایل \f[V]zip\f[R] بارگیری خواهد شد.
می‌توانید از پرچم \f[V]--expire\f[R] برای تعیین مدت زمانی که پیوند باید
معتبر باشد استفاده کنید.
توجه داشته باشید که \f[V]rclone link --unlink\f[R] همه پیوندهای عمومی
یک فایل را حذف می‌کند.
.SS شناسه پوشه ریشه (Root folder ID)
.PP
می‌توانید \f[V]root_folder_id\f[R] را برای rclone تنظیم کنید.
این همان دایرکتوری است (که با \f[V]Folder ID\f[R] خود شناسایی می‌شود) که
rclone آن را به عنوان ریشه درایو Gofile شما در نظر می‌گیرد.
.PP
در حالت عادی این مقدار را خالی می‌گذارید و خود rclone ریشه صحیح را
برای استفاده تشخیص داده و مقدار آن را در فایل پیکربندی وارد می‌کند.
.PP
با این حال، می‌توانید این مقدار را برای محدود کردن rclone به سلسله‌مراتب
یک پوشه خاص تنظیم کنید.
.PP
برای انجام این کار باید \f[V]Folder ID\f[R] دایرکتوری مورد نظری را که
می‌خواهید rclone نمایش دهد، بیابید.
.PP
می‌توانید این کار را با rclone انجام دهید:
.IP
.nf
\f[C]
$ rclone lsf -Fip --dirs-only remote:
d6341f53-ee65-4f29-9f59-d11e8070b2a0;Files/
f4f5c9b8-6ece-478b-b03e-4538edfe5a1c;Photos/
d50e356c-29ca-4b27-a3a7-494d91026e04;Videos/
\f[R]
.fi
.PP
شناسه‌ای که باید استفاده شود بخش قبل از \f[V];\f[R] است، بنابراین می‌توانید مقدار زیر را تنظیم کنید:
.IP
.nf
\f[C]
root_folder_id = d6341f53-ee65-4f29-9f59-d11e8070b2a0
\f[R]
.fi
.PP
تا rclone به دایرکتوری \f[V]Files\f[R] محدود شود.
.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد ویژه gofile (Gofile) آورده شده است.
.SS --gofile-access-token
.PP
توکن دسترسی API
.PP
می‌توانید آن را از کنترل‌پنل وب دریافت کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: access_token
.IP \[bu] 2
متغیر محیطی: RCLONE_GOFILE_ACCESS_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته ویژه gofile (Gofile) آورده شده است.
.SS --gofile-root-folder-id
.PP
شناسه پوشه ریشه
.PP
در حالت عادی این را خالی بگذارید؛ rclone آن را به‌طور خودکار پر می‌کند.
.PP
اگر می‌خواهید rclone به یک پوشه خاص محدود شود می‌توانید آن را پر کنید \- برای اطلاعات بیشتر مستندات را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_folder_id
.IP \[bu] 2
متغیر محیطی: RCLONE_GOFILE_ROOT_FOLDER_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --gofile-account-id
.PP
شناسه حساب کاربری
.PP
در حالت عادی این مقدار را خالی بگذارید؛ rclone آن را به‌طور خودکار پر خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: account_id
.IP \[bu] 2
متغیر محیطی: RCLONE_GOFILE_ACCOUNT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --gofile-list-chunk
.PP
تعداد مواردی که در هر فراخوانی فهرست می‌شوند
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_chunk
.IP \[bu] 2
متغیر محیطی: RCLONE_GOFILE_LIST_CHUNK
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 1000
.SS --gofile-encoding
.PP
کدگذاری برای بک‌اند.
.PP
برای اطلاعات بیشتر، بخش کدگذاری را در بررسی کلی (<https://rclone.org/overview/#encoding>) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_GOFILE_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,LeftPeriod,RightPeriod,InvalidUtf8,Dot,Exclamation
.SS --gofile-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_GOFILE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS محدودیت‌ها (Limitations)
.PP
Gofile تنها از نام‌فایل‌هایی تا حداکثر ۲۵۵ نویسه پشتیبانی می‌کند، که هر نویسه یک نویسهٔ یونیکد است.
.PP
دایرکتوری‌ها نباید برای بیش از \f[V]24h\f[R] کَش شوند، در غیر این صورت ممکن است فایل‌های درون دایرکتوری قابل دانلود نباشند.
در عمل، این بدین معناست که هنگام استفاده از دستورات rclone مبتنی بر VFS مانند
\f[V]rclone mount\f[R] باید اطمینان حاصل کنید که مقدار \f[V]--dir-cache-time\f[R]
کمتر از \f[V]24h\f[R] باشد.
.PP
توجه داشته باشید که Gofile در حال حاضر در مجموع به ۱۰۰٬۰۰۰ مورد محدود است.
اگر تلاش کنید مواردی بیشتر از این مقدار را بارگذاری کنید، با
\f[V]error-limit-100000\f[R]
مواجه خواهید شد.
این محدودیت ممکن است در آینده برداشته شود.
.SS فایل‌های تکراری (Duplicated files)
.PP
Gofile قادر است فایل‌هایی با نام‌های تکراری داشته باشد.
برای نمونه، دو فایل با نام \f[V]hello.txt\f[R] در یک دایرکتوری یکسان.
.PP
برنامه rclone نمی‌تواند چنین مواردی را با یک سیستم‌فایل معمولی همگام‌سازی کند، اما این موضوع با دستور
\f[V]rclone dedupe\f[R] قابل اصلاح است.
.PP
فایل‌های تکراری در فرایند همگام‌سازی ایجاد مشکل می‌کنند و پیام‌هایی دربارهٔ فایل‌های تکراری در گزارش‌ها (log) مشاهده خواهید کرد.
.PP
برای اصلاح فایل‌های تکراری از \f[V]rclone dedupe\f[R] استفاده کنید..SH "فضای ذخیره‌سازی ابری گوگل (Google Cloud Storage)"
.PP
مسیرها به‌صورت \f[V]remote:bucket\f[R] مشخص می‌شوند (یا \f[V]remote:\f[R] برای
دستور \f[V]lsd\f[R]).
همچنین می‌توانید زیرپوشه‌ها را نیز وارد کنید، مانند
\f[V]remote:bucket/path/to/dir\f[R].
.SS "پیکربندی (Configuration)"
.PP
راه‌اندازی اولیه برای Google Cloud Storage شامل دریافت یک توکن از
Google Cloud Storage است که باید آن را در مرورگر خود انجام دهید.
دستور \f[V]rclone config\f[R] مراحل این کار را مرحله‌به‌مرحله به شما نشان می‌دهد.
.PP
در اینجا مثالی از نحوهٔ ایجاد یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا این دستور را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
n) New remote
d) Delete remote
q) Quit config
e/n/d/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Google Cloud Storage (this is not Google Drive)
   \[rs] \[dq]google cloud storage\[dq]
[snip]
Storage> google cloud storage
Google Application Client Id - leave blank normally.
client_id>
Google Application Client Secret - leave blank normally.
client_secret>
Project number optional - needed only for list/create/delete buckets - see your developer console.
project_number> 12345678
Service Account Credentials JSON file path - needed only if you want use SA instead of interactive login.
service_account_file>
Access Control List for new objects.
Choose a number from below, or type in your own value
 1 / Object owner gets OWNER access, and all Authenticated Users get READER access.
   \[rs] \[dq]authenticatedRead\[dq]
 2 / Object owner gets OWNER access, and project team owners get OWNER access.
   \[rs] \[dq]bucketOwnerFullControl\[dq]
 3 / Object owner gets OWNER access, and project team owners get READER access.
   \[rs] \[dq]bucketOwnerRead\[dq]
 4 / Object owner gets OWNER access [default if left blank].
   \[rs] \[dq]private\[dq]
 5 / Object owner gets OWNER access, and project team members get access according to their roles.
   \[rs] \[dq]projectPrivate\[dq]
 6 / Object owner gets OWNER access, and all Users get READER access.
   \[rs] \[dq]publicRead\[dq]
object_acl> 4
Access Control List for new buckets.
Choose a number from below, or type in your own value
 1 / Project team owners get OWNER access, and all Authenticated Users get READER access.
   \[rs] \[dq]authenticatedRead\[dq]
 2 / Project team owners get OWNER access [default if left blank].
   \[rs] \[dq]private\[dq]
 3 / Project team members get access according to their roles.
   \[rs] \[dq]projectPrivate\[dq]
 4 / Project team owners get OWNER access, and all Users get READER access.
   \[rs] \[dq]publicRead\[dq]
 5 / Project team owners get OWNER access, and all Users get WRITER access.
   \[rs] \[dq]publicReadWrite\[dq]
bucket_acl> 2
Location for the newly created buckets.
Choose a number from below, or type in your own value
 1 / Empty for default location (US).
   \[rs] \[dq]\[dq]
 2 / Multi-regional location for Asia.
   \[rs] \[dq]asia\[dq]
 3 / Multi-regional location for Europe.
   \[rs] \[dq]eu\[dq]
 4 / Multi-regional location for United States.
   \[rs] \[dq]us\[dq]
 5 / Taiwan.
   \[rs] \[dq]asia-east1\[dq]
 6 / Tokyo.
   \[rs] \[dq]asia-northeast1\[dq]
 7 / Singapore.
   \[rs] \[dq]asia-southeast1\[dq]
 8 / Sydney.
   \[rs] \[dq]australia-southeast1\[dq]
 9 / Belgium.
   \[rs] \[dq]europe-west1\[dq]
10 / London.
   \[rs] \[dq]europe-west2\[dq]
11 / Iowa.
   \[rs] \[dq]us-central1\[dq]
12 / South Carolina.
   \[rs] \[dq]us-east1\[dq]
13 / Northern Virginia.
   \[rs] \[dq]us-east4\[dq]
14 / Ohio.
   \[rs] \[dq]us-east5\[dq]
15 / Oregon.
   \[rs] \[dq]us-west1\[dq]
location> 12
The storage class to use when storing objects in Google Cloud Storage.
Choose a number from below, or type in your own value
 1 / Default
   \[rs] \[dq]\[dq]
 2 / Multi-regional storage class
   \[rs] \[dq]MULTI_REGIONAL\[dq]
 3 / Regional storage class
   \[rs] \[dq]REGIONAL\[dq]
 4 / Nearline storage class
   \[rs] \[dq]NEARLINE\[dq]
 5 / Coldline storage class
   \[rs] \[dq]COLDLINE\[dq]
 6 / Durable reduced availability storage class
   \[rs] \[dq]DURABLE_REDUCED_AVAILABILITY\[dq]
storage_class> 5
Remote config
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y) Yes
n) No
y/n> y
If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth
Log in and authorize rclone for access
Waiting for code...
Got code
Configuration complete.
Options:
- type: google cloud storage
- client_id:
- client_secret:
- token: {\[dq]AccessToken\[dq]:\[dq]xxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\[dq],\[dq]RefreshToken\[dq]:\[dq]x/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxxxx\[dq],\[dq]Expiry\[dq]:\[dq]2014-07-17T20:49:14.929208288+01:00\[dq],\[dq]Extra\[dq]:null}
- project_number: 12345678
- object_acl: private
- bucket_acl: private
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
برای اطلاع از نحوهٔ راه‌اندازی روی دستگاهی که به مرورگر وب متصل به اینترنت دسترسی
ندارد، مستندات راه‌اندازی ریموت را در (https://rclone.org/remote_setup)
ببینید.
.PP
توجه داشته باشید که در صورت استفاده از مرورگر وب برای احراز هویت خودکار، rclone
یک وب‌سرور روی سیستم محلی شما اجرا می‌کند تا توکن بازگردانده‌شده از Google را دریافت کند.
این سرور تنها از لحظهٔ باز شدن مرورگر تا زمان دریافت کد تأیید اجرا می‌شود.
این سرویس روی \f[V]http://127.0.0.1:53682/\f[R] اجرا می‌شود و در صورتی که فایروال
روی میزبان فعال باشد، ممکن است نیاز به باز کردن موقت آن داشته باشید، یا اینکه از
حالت دستی استفاده کنید.
.PP
این ریموت \f[V]remote\f[R] نامیده می‌شود و اکنون می‌تواند به این صورت استفاده شود:
.PP
مشاهدهٔ تمام باکت‌های موجود در پروژه شما:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
ایجاد یک باکت جدید:
.IP
.nf
\f[C]
rclone mkdir remote:bucket
\f[R]
.fi.PP
فهرست کردن محتویات یک باکت (bucket)
.IP
.nf
\f[C]
rclone ls remote:bucket
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با باکت دوردست، همراه با حذف فایل‌های اضافی موجود در باکت.
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory remote:bucket
\f[R]
.fi
.SS پشتیبانی از حساب سرویس (Service Account)
.PP
شما می‌توانید rclone را با Google Cloud Storage در حالت خودکار و بدون نظارت (unattended) پیکربندی کنید؛ یعنی بدون وابستگی به یک حساب کاربری نهایی خاص در گوگل.
این ویژگی زمانی مفید است که بخواهید فایل‌ها را روی ماشین‌هایی همگام‌سازی کنید که کاربری در آن‌ها وارد نشده است، مانند ماشین‌های ساخت و کامپایل (build machines).
.PP
جهت دریافت اعتبارنامه‌ها برای Service Accountهای IAM در Google Cloud Platform (https://cloud.google.com/iam/docs/service-accounts)، لطفاً به بخش Service Account (https://console.cloud.google.com/permissions/serviceaccounts) در Google Developer Console مراجعه کنید.
حساب‌های سرویس رفتاری دقیقاً مشابه مجوزهای عادی \f[V]User\f[R] در ACLهای Google Cloud Storage (https://cloud.google.com/storage/docs/access-control) دارند، بنابراین می‌توانید دسترسی آن‌ها را محدود کنید (مثلاً آن‌ها را فقط‌خواندنی کنید).
پس از ایجاد حساب، یک فایل JSON شامل اعتبارنامه‌های Service Account روی ماشین شما بارگیری خواهد شد.
این اعتبارنامه‌ها همان مواردی هستند که rclone برای احراز هویت از آن‌ها استفاده خواهد کرد.
.PP
جهت استفاده از Service Account به جای گردش توکن OAuth2، مسیر مربوط به اعتبارنامه‌های حساب سرویس خود را در اعلان \f[V]service_account_file\f[R] وارد کنید تا rclone از گردش احراز هویت مبتنی بر مرورگر استفاده نکند.
چنانچه ترجیح می‌دهید محتویات فایل اعتبارنامه را مستقیماً درون فایل پیکربندی rclone قرار دهید، می‌توانید گزینه \f[V]service_account_credentials\f[R] را با محتوای واقعی فایل مقداردهی کنید، یا متغیر محیطی معادل آن را تنظیم نمایید.
.SS احراز هویت حساب سرویس با توکن‌های دسترسی (Access Tokens)
.PP
یکی دیگر از گزینه‌ها برای احراز هویت حساب سرویس، استفاده از توکن‌های دسترسی از طریق دستور \f[I]gcloud impersonate-service-account\f[R] است.
توکن‌های دسترسی با اجتناب از کاربرد فایل کلید JSON (که ممکن است لو برود یا به مخاطره بیفتد)، امنیت را حفظ می‌کنند.
آن‌ها همچنین گردش ورود با oauth را دور می‌زنند، که این کار در ماشین‌های مجازی (VM) دوردست فاقد مرورگر وب ساده‌تر است.
.PP
چنانچه از قبل یک حساب سرویس فعال دارید، به مرحله ۳ بروید.
.SS ۱. ایجاد یک حساب سرویس با استفاده از
.IP
.nf
\f[C]
gcloud iam service-accounts create gcs-read-only
\f[R]
.fi
.PP
همچنین می‌توانید از یک حساب سرویس موجود نیز مجدداً استفاده کنید (مانند موردی که در بالا ایجاد شد).
.SS ۲. الصاق یک نقش Viewer (فقط‌خواندنی) یا User (خواندنی\-نوشتنی) به حساب سرویس
.IP
.nf
\f[C]
$ PROJECT_ID=my-project
$ gcloud --verbose iam service-accounts add-iam-policy-binding \[rs]
   gcs-read-only\[at]${PROJECT_ID}.iam.gserviceaccount.com  \[rs]
   --member=serviceAccount:gcs-read-only\[at]${PROJECT_ID}.iam.gserviceaccount.com \[rs]
   --role=roles/storage.objectViewer
\f[R]
.fi
.PP
از کنسول Google Cloud برای تعیین یک نقش محدودتر استفاده کنید.
برخی نقش‌های از پیش تعریف‌شده مرتبط:
.IP \[bu] 2
\f[I]roles/storage.objectUser\f[R] \-\- دسترسی خواندنی\-نوشتنی اما بدون امتیازات مدیریتی
.IP \[bu] 2
\f[I]roles/storage.objectViewer\f[R] \-\- دسترسی فقط‌خواندنی به اشیاء (objects)
.IP \[bu] 2
\f[I]roles/storage.admin\f[R] \-\- ایجاد باکت‌ها و نقش‌های مدیریتی.SS ۳. دریافت یک کلید دسترسی موقت برای حساب سرویس
.IP
.nf
\f[C]
$ gcloud auth application-default print-access-token  \[rs]
   --impersonate-service-account \[rs]
      gcs-read-only\[at]${PROJECT_ID}.iam.gserviceaccount.com  

ya29.c.c0ASRK0GbAFEewXD [truncated]
\f[R]
.fi
.SS ۴. به‌روزرسانی تنظیمات \f[V]access_token\f[R]
.PP
هنگامی که عبارت \f[I]waiting for code\f[R] را مشاهده کردید، کلیدهای \f[V]CTRL-C\f[R] را فشار دهید.
این کار پیکربندی را بدون اجرای فرایند oauth ذخیره می‌کند.
.IP
.nf
\f[C]
rclone config update ${REMOTE_NAME} access_token ya29.c.c0Axxxx
\f[R]
.fi
.SS ۵. اجرای rclone طبق روال معمول
.IP
.nf
\f[C]
rclone ls dev-gcs:${MY_BUCKET}/
\f[R]
.fi
.SS اطلاعات بیشتر درباره حساب‌های سرویس (Service Accounts)
.IP \[bu] 2
مستندات رسمی GCS
(https://cloud.google.com/compute/docs/access/service-accounts)
.IP \[bu] 2
راهنمای حساب‌های سرویس با استفاده از Key Files (امنیت کمتر، اما مفاهیم
مشابه) (https://forum.rclone.org/t/access-using-google-service-account/24822/2)
.SS دسترسی ناشناس (Anonymous Access)
.PP
برای بارگیری اشیایی که دسترسی عمومی را مجاز می‌دانند، می‌توانید rclone را
با تنظیم \f[V]anonymous\f[R] بر روی \f[V]true\f[R] برای استفاده از دسترسی ناشناس پیکربندی کنید.
با دسترسی غیرمجاز نمی‌توانید فایل‌ها را بنویسید یا ایجاد کنید، بلکه تنها
می‌توانید آن دسته از باکت‌ها و اشیایی را که دسترسی خواندن عمومی دارند بخوانید یا فهرست کنید.
.SS گواهی‌های پیش‌فرض برنامه (Application Default Credentials)
.PP
اگر هیچ منبع گواهی دیگری ارائه نشود، rclone به
Application Default Credentials (https://cloud.google.com/video-intelligence/docs/common/auth#authenticating_with_application_default_credentials)
بازمی‌گردد. این قابلیت هم زمانی که از قبل احراز هویت را برای حساب توسعه‌دهنده خود
پیکربندی کرده‌اید و هم در محیط عملیاتی هنگام اجرا روی میزبان google compute مفید است.
توجه داشته باشید که در صورت اجرا در docker، ممکن است لازم باشد دستورهای بیشتری را روی ماشین
google compute خود اجرا کنید - این صفحه (https://cloud.google.com/container-registry/docs/advanced-authentication#gcloud_as_a_docker_credential_helper) را ببینید.
.PP
توجه داشته باشید که در صورت استفاده از Application Default Credentials،
نیازی به پیکربندی صریح شماره پروژه نیست.
.SS --fast-list
.PP
این ریموت از \f[V]--fast-list\f[R] پشتیبانی می‌کند که به شما امکان می‌دهد در ازای مصرف حافظه
بیشتر، از تراکنش‌های کمتری استفاده کنید.
برای جزئیات بیشتر به مستندات rclone (https://rclone.org/docs/#fast-list) مراجعه کنید.
.SS سرآیندهای آپلود سفارشی
.PP
می‌توانید با استفاده از پرچم \f[V]--header-upload\f[R] سرآیندهای آپلود سفارشی را تنظیم کنید.
Google Cloud Storage همان‌طور که در مستندات کار با فراداده
(https://cloud.google.com/storage/docs/gsutil/addlhelp/WorkingWithObjectMetadata)
توضیح داده شده است، از سرآیندهای زیر پشتیبانی می‌کند:
.IP \[bu] 2
Cache-Control
.IP \[bu] 2
Content-Disposition
.IP \[bu] 2
Content-Encoding
.IP \[bu] 2
Content-Language
.IP \[bu] 2
Content-Type
.IP \[bu] 2
X-Goog-Storage-Class
.IP \[bu] 2
X-Goog-Meta-
.PP
به‌عنوان مثال: \f[V]--header-upload \[dq]Content-Type text/potato\[dq]\f[R]
.PP
توجه داشته باشید که آخرین مورد برای تنظیم فراداده‌های سفارشی به فرمت
\f[V]--header-upload \[dq]x-goog-meta-key: value\[dq]\f[R] است..SS زمان‌های تغییر
.PP
سرویس Google Cloud Storage به‌طور بومی md5sum را ذخیره می‌کند.
ابزار gsutil شرکت گوگل (https://cloud.google.com/storage/docs/gsutil)
زمان تغییر را با دقت یک ثانیه به‌صورت
\f[V]goog-reserved-file-mtime\f[R] در فراداده‌ی فایل ذخیره می‌کند.
.PP
برای اطمینان از سازگاری با gsutil، ابزار rclone زمان تغییر را در
۲ مدخل فراداده‌ی جداگانه ذخیره می‌کند.
\f[V]mtime\f[R] از قالب RFC3339 با دقت یک نانوثانیه استفاده می‌کند.
\f[V]goog-reserved-file-mtime\f[R] از قالب برچسب زمانی یونیکس (Unix timestamp) با
دقت یک ثانیه استفاده می‌کند.
جهت خواندن زمان تغییر از فراداده‌ی شیء، rclone فراداده‌ها را به
ترتیب زیر می‌خواند: \f[V]mtime\f[R]،
\f[V]goog-reserved-file-mtime\f[R]، زمان به‌روزرسانی شیء (object updated time).
.PP
توجه داشته باشید که پنجره‌ی تغییرات (modify window) پیش‌فرض rclone برابر با 1ns است.
فایل‌های بارگذاری‌شده توسط gsutil تنها دارای برچسب‌های زمانی با دقت
یک ثانیه هستند.
اگر از rclone برای همگام‌سازی فایل‌هایی استفاده کنید که پیش‌تر با gsutil بارگذاری شده‌اند، rclone
تلاش خواهد کرد زمان تغییر را برای همه‌ی این فایل‌ها به‌روزرسانی کند.
برای جلوگیری از این به‌روزرسانی‌های احتمالاً غیرضروری، از
\f[V]--modify-window 1s\f[R] استفاده کنید.
.SS نویسه‌های محدودشده در نام فایل
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
NUL
T}@T{
0x00
T}@T{
␀
T}
T{
LF
T}@T{
0x0A
T}@T{
␊
T}
T{
CR
T}@T{
0x0D
T}@T{
␍
T}
T{
/
T}@T{
0x2F
T}@T{
／
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند
شد (https://rclone.org/overview/#invalid-utf8)، چرا که استفاده
از آن‌ها در رشته‌های JSON امکان‌پذیر نیست.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد ویژه‌ی google cloud storage (سرویس
Google Cloud Storage؛ توجه داشته باشید که این سرویس Google Drive نیست) آورده شده است.
.SS --gcs-client-id
.PP
شناسه کلاینت OAuth (OAuth Client Id).
.PP
در حالت عادی این مقدار را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false.SS --gcs-client-secret
.PP
کلید مخفی کلاینت OAuth (OAuth Client Secret).
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --gcs-project-number
.PP
شماره پروژه.
.PP
اختیاری \- تنها برای فهرست/ایجاد/حذف باکت‌ها نیاز است \- کنسول توسعه‌دهنده خود را بررسی کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: project_number
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_PROJECT_NUMBER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --gcs-user-project
.PP
پروژه کاربر.
.PP
اختیاری \- تنها برای پرداخت توسط درخواست‌دهنده (requester pays) نیاز است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user_project
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_USER_PROJECT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --gcs-service-account-file
.PP
مسیر فایل JSON اطلاعات هویتی حساب خدماتی (Service Account).
.PP
در حالت عادی خالی بگذارید.
تنها در صورتی نیاز است که بخواهید به جای ورود تعاملی از SA استفاده کنید.
.PP
علامت \f[V]\[ti]\f[R] در ابتدای نام فایل همانند متغیرهای محیطی نظیر \f[V]${RCLONE_CONFIG_DIR}\f[R] بسط داده خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: service_account_file
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_SERVICE_ACCOUNT_FILE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --gcs-anonymous
.PP
دسترسی به باکت‌ها و اشیاء عمومی بدون نیاز به اطلاعات احراز هویت.
.PP
اگر صرفاً قصد بارگیری فایل‌ها را دارید و اطلاعات هویتی را پیکربندی نمی‌کنید، آن را روی \[aq]true\[aq] تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: anonymous
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_ANONYMOUS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --gcs-object-acl
.PP
فهرست کنترل دسترسی برای اشیاء جدید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: object_acl
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_OBJECT_ACL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]authenticatedRead\[dq]
.RS 2
.IP \[bu] 2
مالک شیء دسترسی OWNER دریافت می‌کند.
.IP \[bu] 2
تمام کاربران احراز هویت‌شده دسترسی READER دریافت می‌کنند.
.RE
.IP \[bu] 2
\[dq]bucketOwnerFullControl\[dq]
.RS 2
.IP \[bu] 2
مالک شیء دسترسی OWNER دریافت می‌کند.
.IP \[bu] 2
مالکان تیم پروژه دسترسی OWNER دریافت می‌کنند.
.RE
.IP \[bu] 2
\[dq]bucketOwnerRead\[dq]
.RS 2
.IP \[bu] 2
مالک شیء دسترسی OWNER دریافت می‌کند.
.IP \[bu] 2
مالکان تیم پروژه دسترسی READER دریافت می‌کنند.
.RE
.IP \[bu] 2
\[dq]private\[dq]
.RS 2
.IP \[bu] 2
مالک شیء دسترسی OWNER دریافت می‌کند.
.IP \[bu] 2
در صورت خالی بودن، مقدار پیش‌فرض است.
.RE
.IP \[bu] 2
\[dq]projectPrivate\[dq]
.RS 2
.IP \[bu] 2
مالک شیء دسترسی OWNER دریافت می‌کند.
.IP \[bu] 2
اعضای تیم پروژه بر اساس نقش‌های خود دسترسی دریافت می‌کنند.
.RE
.IP \[bu] 2
\[dq]publicRead\[dq]
.RS 2
.IP \[bu] 2
مالک شیء دسترسی OWNER دریافت می‌کند.
.IP \[bu] 2
تمام کاربران دسترسی READER دریافت می‌کنند.
.RE
.RE
.SS --gcs-bucket-acl
.PP
فهرست کنترل دسترسی برای باکت‌های جدید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: bucket_acl
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_BUCKET_ACL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]authenticatedRead\[dq]
.RS 2
.IP \[bu] 2
مالکان تیم پروژه دسترسی OWNER دریافت می‌کنند.
.IP \[bu] 2
تمام کاربران احراز هویت‌شده دسترسی READER دریافت می‌کنند.
.RE
.IP \[bu] 2
\[dq]private\[dq]
.RS 2
.IP \[bu] 2
مالکان تیم پروژه دسترسی OWNER دریافت می‌کنند.
.IP \[bu] 2
در صورت خالی بودن، مقدار پیش‌فرض است.
.RE
.IP \[bu] 2
\[dq]projectPrivate\[dq]
.RS 2
.IP \[bu] 2
اعضای تیم پروژه بر اساس نقش‌های خود دسترسی دریافت می‌کنند.
.RE
.IP \[bu] 2
\[dq]publicRead\[dq]
.RS 2
.IP \[bu] 2
مالکان تیم پروژه دسترسی OWNER دریافت می‌کنند.
.IP \[bu] 2
تمام کاربران دسترسی READER دریافت می‌کنند.
.RE
.IP \[bu] 2
\[dq]publicReadWrite\[dq]
.RS 2
.IP \[bu] 2
مالکان تیم پروژه دسترسی OWNER دریافت می‌کنند.
.IP \[bu] 2
تمام کاربران دسترسی WRITER دریافت می‌کنند.
.RE
.RE.SS --gcs-bucket-policy-only
.PP
بررسی‌های دسترسی باید از خط‌مشی‌های IAM در سطح باکت استفاده کنند.
.PP
اگر می‌خواهید اشیاء را در باکتی بارگذاری کنید که Bucket Policy Only برای آن تنظیم شده است، باید این گزینه را تنظیم کنید.
.PP
هنگامی که این گزینه تنظیم شده باشد، rclone:
.IP \[bu] 2
ACLهای تنظیم‌شده روی باکت‌ها را نادیده می‌گیرد
.IP \[bu] 2
ACLهای تنظیم‌شده روی اشیاء را نادیده می‌گیرد
.IP \[bu] 2
باکت‌ها را با تنظیم فعال Bucket Policy Only ایجاد می‌کند
.PP
مستندات: https://cloud.google.com/storage/docs/bucket-policy-only
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: bucket_policy_only
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_BUCKET_POLICY_ONLY
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --gcs-location
.PP
موقعیت مکانی برای باکت‌های تازه‌ساخته‌شده.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: location
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_LOCATION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
خالی برای مکان پیش‌فرض (US)
.RE
.IP \[bu] 2
\[dq]asia\[dq]
.RS 2
.IP \[bu] 2
مکان چندمنطقه‌ای برای آسیا
.RE
.IP \[bu] 2
\[dq]eu\[dq]
.RS 2
.IP \[bu] 2
مکان چندمنطقه‌ای برای اروپا
.RE
.IP \[bu] 2
\[dq]us\[dq]
.RS 2
.IP \[bu] 2
مکان چندمنطقه‌ای برای ایالات متحده
.RE
.IP \[bu] 2
\[dq]asia-east1\[dq]
.RS 2
.IP \[bu] 2
تایوان
.RE
.IP \[bu] 2
\[dq]asia-east2\[dq]
.RS 2
.IP \[bu] 2
هنگ‌کنگ
.RE
.IP \[bu] 2
\[dq]asia-northeast1\[dq]
.RS 2
.IP \[bu] 2
توکیو
.RE
.IP \[bu] 2
\[dq]asia-northeast2\[dq]
.RS 2
.IP \[bu] 2
اوساکا
.RE
.IP \[bu] 2
\[dq]asia-northeast3\[dq]
.RS 2
.IP \[bu] 2
سئول
.RE
.IP \[bu] 2
\[dq]asia-south1\[dq]
.RS 2
.IP \[bu] 2
بمبئی
.RE
.IP \[bu] 2
\[dq]asia-south2\[dq]
.RS 2
.IP \[bu] 2
دهلی
.RE
.IP \[bu] 2
\[dq]asia-southeast1\[dq]
.RS 2
.IP \[bu] 2
سنگاپور
.RE
.IP \[bu] 2
\[dq]asia-southeast2\[dq]
.RS 2
.IP \[bu] 2
جاکارتا
.RE
.IP \[bu] 2
\[dq]australia-southeast1\[dq]
.RS 2
.IP \[bu] 2
سیدنی
.RE
.IP \[bu] 2
\[dq]australia-southeast2\[dq]
.RS 2
.IP \[bu] 2
ملبورن
.RE
.IP \[bu] 2
\[dq]europe-north1\[dq]
.RS 2
.IP \[bu] 2
فنلاند
.RE
.IP \[bu] 2
\[dq]europe-west1\[dq]
.RS 2
.IP \[bu] 2
بلژیک
.RE
.IP \[bu] 2
\[dq]europe-west2\[dq]
.RS 2
.IP \[bu] 2
لندن
.RE
.IP \[bu] 2
\[dq]europe-west3\[dq]
.RS 2
.IP \[bu] 2
فرانکفورت
.RE
.IP \[bu] 2
\[dq]europe-west4\[dq]
.RS 2
.IP \[bu] 2
هلند
.RE
.IP \[bu] 2
\[dq]europe-west6\[dq]
.RS 2
.IP \[bu] 2
زوریخ
.RE
.IP \[bu] 2
\[dq]europe-central2\[dq]
.RS 2
.IP \[bu] 2
ورشو
.RE
.IP \[bu] 2
\[dq]us-central1\[dq]
.RS 2
.IP \[bu] 2
آیووا
.RE.IP \[bu] 2
\[dq]us-east1\[dq]
.RS 2
.IP \[bu] 2
کارولینای جنوبی
.RE
.IP \[bu] 2
\[dq]us-east4\[dq]
.RS 2
.IP \[bu] 2
ویرجینیای شمالی
.RE
.IP \[bu] 2
\[dq]us-east5\[dq]
.RS 2
.IP \[bu] 2
اوهایو
.RE
.IP \[bu] 2
\[dq]us-west1\[dq]
.RS 2
.IP \[bu] 2
اورگن
.RE
.IP \[bu] 2
\[dq]us-west2\[dq]
.RS 2
.IP \[bu] 2
کالیفرنیا
.RE
.IP \[bu] 2
\[dq]us-west3\[dq]
.RS 2
.IP \[bu] 2
سالت‌لیک‌سیتی
.RE
.IP \[bu] 2
\[dq]us-west4\[dq]
.RS 2
.IP \[bu] 2
لاس‌وگاس
.RE
.IP \[bu] 2
\[dq]northamerica-northeast1\[dq]
.RS 2
.IP \[bu] 2
مونترآل
.RE
.IP \[bu] 2
\[dq]northamerica-northeast2\[dq]
.RS 2
.IP \[bu] 2
تورنتو
.RE
.IP \[bu] 2
\[dq]southamerica-east1\[dq]
.RS 2
.IP \[bu] 2
سائوپائولو
.RE
.IP \[bu] 2
\[dq]southamerica-west1\[dq]
.RS 2
.IP \[bu] 2
سانتیاگو
.RE
.IP \[bu] 2
\[dq]asia1\[dq]
.RS 2
.IP \[bu] 2
ناحیه دوگانه: asia-northeast1 و asia-northeast2.
.RE
.IP \[bu] 2
\[dq]eur4\[dq]
.RS 2
.IP \[bu] 2
ناحیه دوگانه: europe-north1 و europe-west4.
.RE
.IP \[bu] 2
\[dq]nam4\[dq]
.RS 2
.IP \[bu] 2
ناحیه دوگانه: us-central1 و us-east1.
.RE
.RE.SS --gcs-storage-class
.PP
کلاس ذخیره‌سازی مورد استفاده هنگام ذخیره اشیاء در Google Cloud Storage.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: storage_class
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_STORAGE_CLASS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
پیش‌فرض
.RE
.IP \[bu] 2
\[dq]MULTI_REGIONAL\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی چندمنطقه‌ای (Multi-regional)
.RE
.IP \[bu] 2
\[dq]REGIONAL\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی منطقه‌ای (Regional)
.RE
.IP \[bu] 2
\[dq]NEARLINE\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی Nearline
.RE
.IP \[bu] 2
\[dq]COLDLINE\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی Coldline
.RE
.IP \[bu] 2
\[dq]ARCHIVE\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی آرشیو (Archive)
.RE
.IP \[bu] 2
\[dq]DURABLE_REDUCED_AVAILABILITY\[dq]
.RS 2
.IP \[bu] 2
کلاس ذخیره‌سازی با دسترسی کاهش‌یافته و بادوام (Durable reduced availability)
.RE
.RE
.SS --gcs-env-auth
.PP
دریافت اعتبارنامه‌های GCP IAM در زمان اجرا (متغیرهای محیطی یا فراداده نمونه در صورت نبود متغیرهای محیطی).
.PP
تنها در صورتی اعمال می‌شود که service_account_file و service_account_credentials خالی باشند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: env_auth
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_ENV_AUTH
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]false\[dq]
.RS 2
.IP \[bu] 2
اعتبارنامه‌ها را در مرحله بعد وارد کنید.
.RE
.IP \[bu] 2
\[dq]true\[dq]
.RS 2
.IP \[bu] 2
دریافت اعتبارنامه‌های GCP IAM از محیط (متغیرهای محیطی یا IAM).
.RE
.RE.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مختص google cloud storage (فضای ذخیره‌سازی ابری گوگل (این سرویس Google Drive نیست)) آمده است.
.SS --gcs-token
.PP
توکن دسترسی OAuth در قالب یک JSON blob.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --gcs-auth-url
.PP
نشانی URL سرور احراز هویت.
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --gcs-token-url
.PP
نشانی URL سرور توکن.
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --gcs-client-credentials
.PP
استفاده از جریان OAuth اطلاعات اعتباری کلاینت (client credentials).
.PP
این گزینه از جریان Client Credentials در OAUTH2 به صورتی که در RFC
6749 توصیف شده است استفاده می‌کند.
.PP
توجه داشته باشید که این گزینه توسط همه پیشرانه‌ها (backends) پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --gcs-access-token
.PP
توکن دسترسی کوتاه‌مدت.
.PP
در حالت عادی خالی بگذارید.
تنها در صورتی نیاز است که بخواهید به‌جای ورود تعاملی، از توکن دسترسی
کوتاه‌مدت استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: access_token
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_ACCESS_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --gcs-directory-markers
.PP
بارگذاری یک شیء خالی با اسلش در انتها هنگام ایجاد یک دایرکتوری جدید
.PP
پوشه‌های خالی در ریموت‌های مبتنی بر باکت (bucket) پشتیبانی نمی‌شوند؛ این گزینه یک شیء خالی که به \[dq]/\[dq] ختم می‌شود ایجاد می‌کند تا پوشه ماندگار شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: directory_markers
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_DIRECTORY_MARKERS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --gcs-no-check-bucket
.PP
در صورت تنظیم، برای بررسی وجود باکت یا ایجاد آن تلاشی نمی‌شود.
.PP
این گزینه در صورتی که از قبل بدانید باکت وجود دارد، برای به حداقل رساندن تعداد تراکنش‌های انجام‌شده توسط rclone می‌تواند مفید باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_check_bucket
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_NO_CHECK_BUCKET
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --gcs-decompress
.PP
در صورت تنظیم، اشیاء کدگذاری‌شده با gzip را از حالت فشرده خارج می‌کند.
.PP
بارگذاری اشیاء در GCS با تنظیم \[dq]Content-Encoding: gzip\[dq] امکان‌پذیر است.
به طور معمول rclone این فایل‌ها را به عنوان اشیاء فشرده بارگیری می‌کند.
.PP
اگر این پرچم تنظیم شده باشد، rclone این فایل‌های دارای \[dq]Content-Encoding: gzip\[dq] را به محض دریافت از حالت فشرده خارج می‌کند.
این بدان معناست که rclone نمی‌تواند اندازه و هش را بررسی کند، اما محتوای فایل از حالت فشرده خارج خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: decompress
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_DECOMPRESS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --gcs-endpoint
.PP
نقطه پایانی (endpoint) سفارشی برای API ذخیره‌سازی.
برای استفاده از پیش‌فرض ارائه‌دهنده، این مقدار را خالی بگذارید.
.PP
هنگام استفاده از یک endpoint سفارشی که شامل یک زیرمسیر است (مانند example.org/custom/endpoint)، به دلیل محدودیتی در کتابخانه کلاینت Google API Go زیرین، این زیرمسیر در طول عملیات بارگذاری نادیده گرفته خواهد شد.
عملیات بارگیری و فهرست‌گیری با مسیر کامل endpoint به درستی کار خواهند کرد.
اگر برای بارگذاری‌ها به پشتیبانی از زیرمسیر نیاز دارید، از به‌کارگیری زیرمسیرها در پیکربندی endpoint سفارشی خود خودداری کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_ENDPOINT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]storage.example.org\[dq]
.RS 2
.IP \[bu] 2
تعیین یک endpoint سفارشی
.RE
.IP \[bu] 2
\[dq]storage.example.org:4443\[dq]
.RS 2
.IP \[bu] 2
تعیین یک endpoint سفارشی همراه با درگاه (port)
.RE
.IP \[bu] 2
\[dq]storage.example.org:4443/gcs/api\[dq]
.RS 2
.IP \[bu] 2
تعیین یک زیرمسیر؛ یادداشت را ببینید، بارگذاری‌ها از مسیر سفارشی استفاده نخواهند کرد!
.RE
.RE.SS --gcs-encoding
.PP
کدگذاری برای بک‌اند.
.PP
برای اطلاعات بیشتر بخش کدگذاری را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,CrLf,InvalidUtf8,Dot
.SS --gcs-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_GCS_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.SS "محدودیت‌ها (Limitations)"
.PP
دستور \f[V]rclone about\f[R] توسط بک‌اند Google Cloud Storage
پشتیبانی نمی‌شود.
بک‌اندهایی که فاقد این قابلیت هستند نمی‌توانند فضای خالی را برای یک
\f[V]rclone mount\f[R] مشخص کنند یا از خط‌مشی \f[V]mfs\f[R] (بیشترین فضای خالی) به عنوان عضوی
از یک ریموت رپوشانی/ترکیبی (union remote) در rclone استفاده کنند.
.PP
بخش «فهرست بک‌اندهایی که از rclone about پشتیبانی نمی‌کنند» (https://rclone.org/overview/#optional-features)
و rclone about (https://rclone.org/commands/rclone_about) را ببینید.
.SH "گوگل درایو (Google Drive)"
.PP
مسیرها به صورت \f[V]drive:path\f[R] مشخص می‌شوند.
.PP
مسیرهای Drive می‌توانند تا هر عمقی که نیاز است ادامه یابند، مانند
\f[V]drive:directory/subdirectory\f[R].
.SS "پیکربندی (Configuration)"
.PP
راه‌اندازی اولیه برای drive شامل دریافت یک توکن از Google Drive است
که باید آن را در مرورگر وب خود انجام دهید.
دستور \f[V]rclone config\f[R] شما را مرحله به مرحله راهنمایی می‌کند.
.PP
در اینجا نمونه‌ای از نحوه ساخت یک ریموت با نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
n/r/c/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Google Drive
   \[rs] \[dq]drive\[dq]
[snip]
Storage> drive
Google Application Client Id
Leave blank to use rclone\[aq]s shared client_id, or if you are using a service account.
The shared client_id is being retired and will stop working during 2026, so creating your own is now strongly recommended.
See https://rclone.org/drive/#making-your-own-client-id for how to create your own.
client_id>
Google Application Client Secret
Leave blank to use rclone\[aq]s shared client_id, or if you are using a service account.
If you created your own client_id then enter its client secret here.
client_secret>
Scope that rclone should use when requesting access from drive.
Choose a number from below, or type in your own value
 1 / Full access all files, excluding Application Data Folder.
   \[rs] \[dq]drive\[dq]
 2 / Read-only access to file metadata and file contents.
   \[rs] \[dq]drive.readonly\[dq]
   / Access to files created by rclone only.
 3 | These are visible in the drive website.
   | File authorization is revoked when the user deauthorizes the app.
   \[rs] \[dq]drive.file\[dq]
   / Allows read and write access to the Application Data folder.
 4 | This is not visible in the drive website.
   \[rs] \[dq]drive.appfolder\[dq]
   / Allows read-only access to file metadata but
 5 | does not allow any access to read or download file content.
   \[rs] \[dq]drive.metadata.readonly\[dq]
scope> 1
Service Account Credentials JSON file path - needed only if you want use SA instead of interactive login.
service_account_file>
Remote config
rclone\[aq]s shared Google Drive client_id is being retired and will stop working during 2026.
Create your own to avoid interruption: https://rclone.org/drive/#making-your-own-client-id

Continue using the shared client_id anyway?
y) Yes
n) No (default)
y/n> n
Google Application Client Id
client_id> 1234567890-abcdefghijklmnop.apps.googleusercontent.com
Google Application Client Secret
client_secret> GOCSPX-your-client-secret
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y) Yes
n) No
y/n> y
If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth
Log in and authorize rclone for access
Waiting for code...
Got code
Configure this as a Shared Drive (Team Drive)?
y) Yes
n) No
y/n> n
Configuration complete.
Options:
type: drive
- client_id: 1234567890-abcdefghijklmnop.apps.googleusercontent.com
- client_secret: GOCSPX-your-client-secret
- scope: drive
- root_folder_id:
- service_account_file:
- token: {\[dq]access_token\[dq]:\[dq]XXX\[dq],\[dq]token_type\[dq]:\[dq]Bearer\[dq],\[dq]refresh_token\[dq]:\[dq]XXX\[dq],\[dq]expiry\[dq]:\[dq]2014-03-16T13:57:58.955387075Z\[dq]}
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
برای نحوه راه‌اندازی روی دستگاهی که مرورگر وب متصل به اینترنت
در دسترس ندارد، مستندات راه‌اندازی ریموت (https://rclone.org/remote_setup) را ببینید.
.PP
توجه داشته باشید که rclone در صورت استفاده از مرورگر وب برای احراز هویت خودکار،
یک وب‌سرور روی دستگاه محلی شما اجرا می‌کند تا توکن بازگردانده شده از Google را دریافت کند.
این وب‌سرور تنها از لحظه باز شدن مرورگر شما تا زمان دریافت کد تأیید اجرا می‌شود.
این سرویس روی \f[V]http://127.0.0.1:53682\f[R] فعال است و چنانچه فایروال میزبان را اجرا کرده‌اید،
ممکن است لازم باشد آن را موقتاً رفع مسدودیت کنید، یا از حالت دستی استفاده نمایید.
.PP
سپس می‌توانید مانند زیر از آن استفاده کنید،
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح Drive خود
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در Drive خود
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi.PP
برای رونوشت کردن یک دایرکتوری محلی به یک دایرکتوری در drive به نام backup:
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi
.SS حوزه‌های دسترسی (Scopes)
.PP
ابزار Rclone به شما امکان می‌دهد حوزه دسترسی (scope) مد نظر خود را برای استفاده
توسط rclone مشخص کنید.
این کار نوع توکن اعطاشده به rclone را تغییر می‌دهد.
حوزه‌های دسترسی در
اینجا (https://developers.google.com/drive/v3/web/about-auth) تعریف شده‌اند.
.PP
استفاده از فهرستی جداشده با کاما مجاز است؛ به عنوان مثال:
\f[V]drive.readonly,drive.file\f[R].
.PP
حوزه‌های دسترسی عبارتند از:
.SS drive
.PP
این حوزه پیش‌فرض است و دسترسی کامل به تمامی فایل‌ها را ممکن می‌سازد، به‌جز
پوشه داده‌های برنامه (Application Data Folder؛ به بخش زیر مراجعه کنید).
.PP
اگر مطمئن نیستید، این گزینه را انتخاب کنید.
.SS drive.readonly
.PP
این حوزه دسترسی فقط‌خواندنی به تمام فایل‌ها را فراهم می‌کند.
فایل‌ها قابل فهرست‌بندی و بارگیری هستند، اما امکان بارگذاری، تغییر نام یا حذف آن‌ها وجود ندارد.
.SS drive.file
.PP
با این حوزه دسترسی، rclone تنها می‌تواند فایل‌ها و پوشه‌هایی را که خودش ایجاد
کرده است بخواند/مشاهده کند/تغییر دهد.
.PP
بنابراین اگر فایل‌هایی را از طریق رابط کاربری وب drive (یا هر روش دیگری) بارگذاری
کرده باشید، برای rclone قابل مشاهده نخواهند بود.
.PP
این ویژگی زمانی مفید است که از rclone برای پشتیبان‌گیری از داده‌ها استفاده می‌کنید
و می‌خواهید مطمئن شوید اطلاعات محرمانه موجود در drive شما برای rclone نمایان نیست.
.PP
فایل‌های ایجادشده با این حوزه در رابط وب قابل مشاهده هستند.
.SS drive.appfolder
.PP
این گزینه یک فضای اختصاصی و خصوصی جهت ذخیره فایل‌ها به rclone اختصاص می‌دهد.
Rclone قادر به مشاهده سایر فایل‌های موجود در drive شما نخواهد بود و شما نیز
نمی‌توانید فایل‌های rclone را از طریق رابط وب مشاهده کنید.
.SS drive.metadata.readonly
.PP
این حوزه تنها دسترسی فقط‌خواندنی به نام فایل‌ها را فراهم می‌کند.
این گزینه به rclone اجازه بارگیری یا بارگذاری داده‌ها، یا تغییر نام یا حذف
فایل‌ها و دایرکتوری‌ها را نمی‌دهد.
.SS شناسه پوشه ریشه (Root folder ID)
.PP
این گزینه به بخش تنظیمات پیشرفته منتقل شده است.
شما می‌توانید \f[V]root_folder_id\f[R] را برای rclone تعیین کنید.
این دایرکتوری (که توسط \f[V]Folder ID\f[R] آن شناسایی می‌شود) همان مسیری است که
rclone آن را ریشه drive شما در نظر می‌گیرد.
.PP
در حالت معمول این فیلد را خالی بگذارید تا rclone ریشه مناسب را خودش شناسایی کند.
.PP
با این حال، می‌توانید این مقدار را تنظیم کنید تا دسترسی rclone را به یک سلسله‌مراتب
پوشه‌ای خاص محدود کنید، یا به داده‌های موجود در زبانه \[dq]Computers\[dq] در
رابط وب drive (جایی که فایل‌های برنامه دسکتاپ Backup and Sync گوگل ذخیره می‌شوند) دسترسی یابید.
با این وجود، این روش آسان‌ترین راه نیست.
به جای آن، می‌توانید یک میانبر (shortcut) به پوشه‌ای در \[dq]Computers\[dq]
ایجاد کرده و آن را در \[dq]My Drive\[dq] قرار دهید. برای این منظور، روی پوشه کلیک راست کرده،
گزینه \[dq]Organize\[dq] و سپس \[dq]Add shortcut\[dq] را در رابط وب Google Drive انتخاب کنید.
به‌محض اضافه شدن میانبر به \[dq]My Drive\[dq]، ابزار rclone آن پوشه را نمایش داده
و امکان کار با آن را فراهم می‌سازد.
بخش میانبرها (Shortcuts) را نیز ببینید.
.PP
اگر تصمیم گرفتید پوشه ریشه خود را تغییر دهید، باید
\f[V]Folder ID\f[R] دایرکتوری‌ای را که می‌خواهید rclone نمایش دهد پیدا کنید.
این شناسه، آخرین بخش از آدرس اینترنتی (URL) هنگام باز کردن پوشه مربوطه در رابط وب drive است.
.PP
بنابراین اگر پوشه‌ای که می‌خواهید rclone استفاده کند در مرورگر آدرسی شبیه به
\f[V]https://drive.google.com/drive/folders/1XyfxxxxxxxxxxxxxxxxxxxxxxxxxKHCh\f[R]
داشته باشد، مقدار \f[V]1XyfxxxxxxxxxxxxxxxxxxxxxxxxxKHCh\f[R]
را به عنوان \f[V]root_folder_id\f[R] در پیکربندی قرار دهید.
.PP
\f[B]نکته:\f[R] به نظر می‌رسد پوشه‌های موجود در زبانه \[dq]Computers\[dq] هنگام
استفاده از rclone فقط‌خواندنی هستند (drive خطای 500 می‌دهد)؛ البته آنها در رابط وب
Google Drive نیز فقط‌خواندنی می‌باشند، احتمالاً به این دلیل که این پوشه‌ها توسط ابزار دسکتاپ
Google Drive مدیریت می‌شوند.
پوشه‌های سطح بالا در \[dq]Computers\[dq] فقط‌خواندنی هستند، اما می‌توانید با استفاده
از rclone با پوشه‌های درون آن‌ها تعامل داشته باشید.
اینها همان پوشه‌هایی هستند که همانند توضیحات بالا می‌توانید برایشان میانبر نیز بسازید.
.PP
به نظر نمی‌رسد رابط برنامه‌نویسی (API) برای یافتن شناسه پوشه‌های زبانه
\[dq]Computers\[dq] وجود داشته باشد - اگر اطلاعات دیگری در این زمینه دارید لطفاً با ما تماس بگیرید!
.PP
همچنین توجه داشته باشید که rclone هنوز نمی‌تواند به داده‌های موجود در زیر
زبانه \[dq]Backups\[dq] در رابط وب Google Drive دسترسی داشته باشد..SS پشتیبانی از Service Account
.PP
شما می‌توانید rclone را با Google Drive در حالت بدون نظارت (unattended)، یعنی بدون وابستگی به یک حساب Google کاربر نهایی خاص، راه‌اندازی کنید.
این قابلیت زمانی مفید است که بخواهید فایل‌ها را روی ماشین‌هایی همگام‌سازی کنید که کاربر فعال واردشده‌ای ندارند؛ برای نمونه ماشین‌های ساخت (build machines).
.PP
برای استفاده از یک Service Account به‌جای جریان توکن OAuth2، در هنگام اجرای \f[V]rclone config\f[R] مسیر اعتبارنامه‌های Service Account خود را در اعلان \f[V]service_account_file\f[R] وارد کنید؛ در این صورت rclone از جریان احراز هویت مبتنی بر مرورگر استفاده نخواهد کرد.
اگر ترجیح می‌دهید محتویات فایل اعتبارنامه را مستقیماً درون فایل پیکربندی rclone قرار دهید، می‌توانید به‌جای آن، \f[V]service_account_credentials\f[R] را با محتوای واقعی فایل مقداردهی کنید، یا متغیر محیطی معادل آن را تنظیم نمایید.
.SS مورد کاربرد \- حساب Google Workspace و Drive اختصاصی
.PP
فرض کنید شما مدیر (administrator) یک Google Workspace هستید.
هدف، خواندن یا نوشتن داده‌ها روی حساب Drive یک فرد است که عضوی از این دامنه است.
ما دامنه را <example.com> و کاربر را <foo@example.com> می‌نامیم.
.PP
برای انجام این کار باید چند مرحله را طی کنیم:
.SS ۱. ساخت یک service account برای example.com
.IP \[bu] 2
برای ساخت یک service account و دریافت اعتبارنامه‌های آن، به Google Developer Console (https://console.developers.google.com) بروید.
.IP \[bu] 2
شما باید یک پروژه داشته باشید \- اگر ندارید یکی بسازید و مطمئن شوید که روی پروژهٔ انتخابی قرار دارید.
.IP \[bu] 2
سپس به \[dq]IAM & admin\[dq] -> \[dq]Service Accounts\[dq] بروید.
.IP \[bu] 2
از دکمهٔ \[dq]Create Service Account\[dq] استفاده کنید.
بخش‌های \[dq]Service account name\[dq] و \[dq]Service account ID\[dq] را با مقداری که کلاینت شما را مشخص کند، پر کنید.
.IP \[bu] 2
گزینهٔ \[dq]Create And Continue\[dq] را انتخاب کنید.
مراحل ۲ و ۳ اختیاری هستند.
.IP \[bu] 2
روی service account تازه‌ساخته‌شده کلیک کنید.
.IP \[bu] 2
روی \[dq]Keys\[dq] و سپس \[dq]Add Key\[dq] و بعد از آن روی \[dq]Create new key\[dq] کلیک کنید.
.IP \[bu] 2
نوع \[dq]JSON\[dq] را انتخاب کرده و روی create کلیک کنید.
.IP \[bu] 2
با این کار یک فایل JSON کوچک دانلود می‌شود که rclone از آن برای احراز هویت استفاده خواهد کرد.
.PP
اگر زمانی به حذف این دسترسی نیاز پیدا کردید، دکمهٔ \[dq]Delete service account key\[dq] را فشار دهید.
.SS ۲. مجاز کردن دسترسی API به Google Drive دامنهٔ example.com
.IP \[bu] 2
به کنسول مدیریتی Workspace دامنهٔ example.com به نشانی (https://admin.google.com) بروید.
.IP \[bu] 2
وارد بخش \[dq]Security\[dq] شوید (یا از نوار جستجو استفاده کنید).
.IP \[bu] 2
گزینهٔ \[dq]Access and data control\[dq] و سپس \[dq]API controls\[dq] را انتخاب کنید.
.IP \[bu] 2
روی \[dq]Manage domain-wide delegation\[dq] کلیک کنید.
.IP \[bu] 2
روی \[dq]Add new\[dq] کلیک کنید.
.IP \[bu] 2
در فیلد \[dq]Client ID\[dq]، شناسهٔ \[dq]Client ID\[dq] مربوط به service account را وارد کنید \- این مقدار در Developer Console زیر بخش \[dq]IAM & Admin\[dq] -> \[dq]Service Accounts\[dq]، و سپس \[dq]View Client ID\[dq] برای service account تازه‌ساخته‌شده قابل مشاهده است.
این مقدار یک رشتهٔ عددی \[ti]21 کاراکتری است.
.IP \[bu] 2
در فیلد بعدی، \[dq]OAuth Scopes\[dq]، مقدار
\f[V]https://www.googleapis.com/auth/drive\f[R]
را برای اعطای دسترسی خواندن/نوشتن به‌طور خاص به Google Drive وارد کنید.
همچنین می‌توانید از
\f[V]https://www.googleapis.com/auth/drive.readonly\f[R]
برای دسترسی فقط‌خواندنی همراه با \f[V]--drive-scope=drive.readonly\f[R] استفاده کنید.
.IP \[bu] 2
روی \[dq]Authorise\[dq] کلیک کنید.
.SS ۳. پیکربندی rclone با فرض یک نصب جدید
.IP
.nf
\f[C]
rclone config

n/s/q> n         # New
name>gdrive      # Gdrive is an example name
Storage>         # Type drive
client_id>       # Can be left blank
client_secret>   # Can be left blank
scope>           # Select the scope use used in step 2
root_folder_id>  # Can be left blank
service_account_file> /home/foo/myJSONfile.json # Path to the JSON file you downloaded in step 1.
y/n>             # Auto config, n
\f[R]
.fi.SS ۴. بررسی کارکرد درست (Verify that it\[aq]s working)
.IP \[bu] 2
\f[V]rclone -v --drive-impersonate foo\[at]example.com lsf gdrive:backup\f[R]
.IP \[bu] 2
عملکرد آرگومان‌ها به این شرح است:
.RS 2
.IP \[bu] 2
\f[V]-v\f[R] \- گزارش‌دهی پرجزئیات (verbose)
.IP \[bu] 2
\f[V]--drive-impersonate foo\[at]example.com\f[R] \- بخشی که کار اصلی را انجام می‌دهد، با جا زدن خود به جای کاربر foo.
.IP \[bu] 2
\f[V]lsf\f[R] \- فهرست کردن فایل‌ها به روشی مناسب برای تجزیه (parsing)
.IP \[bu] 2
\f[V]gdrive:backup\f[R] \- استفاده از ریموت به نام gdrive و کار در پوشه‌ای با نام backup.
.RE
.PP
نکته: در صورتی که پوشه ریشه (root) مشخصی را روی gdrive پیکربندی کرده‌اید و rclone هنگام استفاده از \f[V]--drive-impersonate\f[R] نمی‌تواند به محتویات آن پوشه دسترسی پیدا کند، در عوض این کار را انجام دهید:
.IP \[bu] 2
در رابط تحت وب gdrive، پوشه ریشه خود را با کاربر/ایمیل Service Account جدیدی که در مرحله ۱ ساختید/انتخاب کردید به اشتراک بگذارید
.IP \[bu] 2
از rclone بدون تعیین گزینه \f[V]--drive-impersonate\f[R] استفاده کنید، به این صورت: \f[V]rclone -v lsf gdrive:backup\f[R]
.SS درایوهای اشتراکی (Shared drives / team drives)
.PP
اگر می‌خواهید ریموت را طوری پیکربندی کنید که به یک Google Shared Drive (که پیش‌تر با نام Team Drives شناخته می‌شد) اشاره کند، به پرسش \f[V]Configure this as a Shared Drive (Team Drive)?\f[R] پاسخ \f[V]y\f[R] دهید.
.PP
این کار فهرست Shared Driveها را از google دریافت کرده و به شما امکان می‌دهد مشخص کنید می‌خواهید از کدام‌یک استفاده کنید. همچنین در صورت تمایل می‌توانید شناسه (ID) یک Shared Drive را وارد نمایید.
.PP
برای مثال:
.IP
.nf
\f[C]
Configure this as a Shared Drive (Team Drive)?
y) Yes
n) No
y/n> y
Fetching Shared Drive list...
Choose a number from below, or type in your own value
 1 / Rclone Test
   \[rs] \[dq]xxxxxxxxxxxxxxxxxxxx\[dq]
 2 / Rclone Test 2
   \[rs] \[dq]yyyyyyyyyyyyyyyyyyyy\[dq]
 3 / Rclone Test 3
   \[rs] \[dq]zzzzzzzzzzzzzzzzzzzz\[dq]
Enter a Shared Drive ID> 1
Configuration complete.
Options:
- type: drive
- client_id:
- client_secret:
- token: {\[dq]AccessToken\[dq]:\[dq]xxxx.x.xxxxx_xxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\[dq],\[dq]RefreshToken\[dq]:\[dq]1/xxxxxxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxx\[dq],\[dq]Expiry\[dq]:\[dq]2014-03-16T13:57:58.955387075Z\[dq],\[dq]Extra\[dq]:null}
- team_drive: xxxxxxxxxxxxxxxxxxxx
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.SS --fast-list
.PP
این ریموت از \f[V]--fast-list\f[R] پشتیبانی می‌کند که به شما اجازه می‌دهد در ازای مصرف حافظه بیشتر، از تراکنش‌های کمتری استفاده کنید. برای جزئیات بیشتر به مستندات rclone در <https://rclone.org/docs/#fast-list> مراجعه کنید.
.PP
این کار با ترکیب چندین فراخوانی \f[V]list\f[R] در یک درخواست API واحد انجام می‌شود.
.PP
نحوه کارکرد آن از طریق ترکیب چندین فیلترِ \f[V]\[aq]%s\[aq] in parents\f[R] در یک عبارت واحد است. برای فهرست کردن محتویات دایرکتوری‌های a و b و c، درخواست‌های زیر توسط تابع معمولی \f[V]List\f[R] ارسال خواهند شد:
.IP
.nf
\f[C]
trashed=false and \[aq]a\[aq] in parents
trashed=false and \[aq]b\[aq] in parents
trashed=false and \[aq]c\[aq] in parents
\f[R]
.fi
.PP
این درخواست‌ها اکنون می‌توانند در قالب یک درخواست واحد ادغام شوند:
.IP
.nf
\f[C]
trashed=false and (\[aq]a\[aq] in parents or \[aq]b\[aq] in parents or \[aq]c\[aq] in parents)
\f[R]
.fi
.PP
پیاده‌سازی \f[V]ListR\f[R] تا سقف ۵۰ فیلتر \f[V]parents\f[R] را در یک درخواست قرار می‌دهد. این تابع از مقدار \f[V]--checkers\f[R] برای تعیین تعداد درخواست‌های موازیِ در حال اجرا استفاده می‌کند.
.PP
در آزمایش‌ها، این درخواست‌های دسته‌ای تا ۲۰ برابر سریع‌تر از روش عادی بودند. اجرای دستور زیر بر روی پوشه‌هایی با اندازه‌های مختلف نتایج زیر را نشان می‌دهد:
.IP
.nf
\f[C]
rclone lsjson -vv -R --checkers=6 gdrive:folder
\f[R]
.fi
.PP
پوشه کوچک (۲۲۰ دایرکتوری، ۷۰۰ فایل):
.IP \[bu] 2
بدون \f[V]--fast-list\f[R]: ۳۸ ثانیه
.IP \[bu] 2
با \f[V]--fast-list\f[R]: ۱۰ ثانیه
.PP
پوشه بزرگ (۱۰۶۰۰ دایرکتوری، ۳۹۰۰۰ فایل):
.IP \[bu] 2
بدون \f[V]--fast-list\f[R]: ۲۲:۰۵ دقیقه
.IP \[bu] 2
با \f[V]--fast-list\f[R]: ۵۸ ثانیه.SS زمان‌های تغییر و هش‌ها (Modification times and hashes)
.PP
Google drive زمان‌های تغییر را با دقت ۱ میلی‌ثانیه ذخیره می‌کند.
.PP
الگوریتم‌های هش MD5، SHA1 و SHA256 پشتیبانی می‌شوند.
با این حال، توجه داشته باشید که بخش کوچکی از فایل‌های بارگذاری‌شده ممکن است فاقد هش‌های SHA1
یا SHA256 باشند، به‌ویژه اگر پیش از سال ۲۰۱۸ بارگذاری شده باشند.
.SS نویسه‌های محدودشده در نام فایل (Restricted filename characters)
.PP
تنها بایت‌های نامعتبر UTF-8 جایگزین خواهند شد
(https://rclone.org/overview/#invalid-utf8)، زیرا نمی‌توان از
آن‌ها در رشته‌های JSON استفاده کرد.
.PP
برخلاف سایر بک‌اندها، \f[V]/\f[R] نیز می‌تواند در نام‌ها استفاده شود و
\f[V].\f[R] یا \f[V]..\f[R] نام‌های معتبری هستند.
.SS ویرایش‌ها (Revisions)
.PP
Google drive ویرایش‌های فایل‌ها را ذخیره می‌کند.
هنگامی که با استفاده از rclone تغییری را در یک فایل موجود در google drive بارگذاری می‌کنید،
یک ویرایش جدید از آن فایل ایجاد خواهد شد.
.PP
ویرایش‌ها از خط‌مشی استاندارد گوگل پیروی می‌کنند که در زمان نگارش به شرح زیر بود:
.IP \[bu] 2
پس از ۳۰ روز یا ۱۰۰ ویرایش (هرکدام زودتر برسد) حذف می‌شوند.
.IP \[bu] 2
در سهمیه فضای ذخیره‌سازی کاربر محاسبه نمی‌شوند.
.SS حذف فایل‌ها (Deleting files)
.PP
به‌طور پیش‌فرض rclone هنگام حذف فایل‌ها، همه آن‌ها را به سطل زباله منتقل می‌کند.
اگر حذف دائمی آن‌ها مورد نیاز است، از پرچم
\f[V]--drive-use-trash=false\f[R] استفاده کنید، یا متغیر محیطی
معادل آن را تنظیم نمایید.
.SS میان‌برها (Shortcuts)
.PP
در مارس ۲۰۲۰، Google قابلیت جدیدی را در Google Drive به نام
میان‌برهای درایو معرفی کرد (https://support.google.com/drive/answer/9700156)
(رابط برنامه‌نویسی (https://developers.google.com/drive/api/v3/shortcuts)).
این میان‌برها (تا سپتامبر ۲۰۲۰) جایگزین امکان قرارگیری هم‌زمان فایل‌ها یا پوشه‌ها
در چندین پوشه می‌شوند
(https://cloud.google.com/blog/products/g-suite/simplifying-google-drives-folder-structure-and-sharing-models).
.PP
میان‌برها فایل‌هایی هستند که به فایل‌های دیگر در Google Drive پیوند دارند، تا حدودی
شبیه یک symlink در یونیکس، با این تفاوت که به داده‌های زیرین فایل اشاره می‌کنند
(برای نمونه
inode در اصطلاحات یونیکس)، بنابراین در صورت تغییر نام یا جابه‌جایی مبدأ
خراب نمی‌شوند.
.PP
به‌طور پیش‌فرض rclone با این موارد به شرح زیر برخورد می‌کند:
.PP
برای میان‌برهایی که به فایل‌ها اشاره دارند:
.IP \[bu] 2
هنگام فهرست‌گیری، میان‌برِ فایل به‌صورت فایل مقصد ظاهر می‌شود.
.IP \[bu] 2
هنگام بارگیری، محتوای فایل مقصد بارگیری می‌شود.
.IP \[bu] 2
هنگام به‌روزرسانی فایل میان‌بر با یک فایل غیرمیان‌بر، میان‌بر
حذف شده و سپس فایل جدید در جای میان‌بر بارگذاری می‌شود.
.IP \[bu] 2
هنگام جابه‌جایی سمت سرور (تغییر نام)، نام میان‌بر تغییر می‌کند، نه
فایل مقصد.
.IP \[bu] 2
هنگام رونوشت سمت سرور، خود میان‌بر رونوشت می‌شود، نه محتوای
آن.
(مگر اینکه \f[V]--drive-copy-shortcut-content\f[R] در حال استفاده باشد که در این صورت
محتوای میان‌بر رونوشت می‌شود).
.IP \[bu] 2
هنگام حذف، میان‌بر حذف می‌شود نه فایل پیوندداده‌شده.
.IP \[bu] 2
هنگام تنظیم زمان تغییر، زمان تغییر فایل پیوندداده‌شده
تنظیم خواهد شد.
.PP
برای میان‌برهایی که به پوشه‌ها اشاره دارند:
.IP \[bu] 2
هنگام فهرست‌گیری، میان‌بر به‌صورت یک پوشه ظاهر می‌شود و آن پوشه
شامل محتویات پوشه پیوندداده‌شده خواهد بود (شامل تمام
زیرپوشه‌ها).
.IP \[bu] 2
هنگام بارگیری، محتوای پوشه پیوندداده‌شده و زیرمحتواهای آن
بارگیری می‌شوند.
.IP \[bu] 2
هنگام بارگذاری در یک پوشه میان‌بر، فایل در پوشه
پیوندداده‌شده قرار خواهد گرفت.
.IP \[bu] 2
هنگام جابه‌جایی سمت سرور (تغییر نام)، نام میان‌بر تغییر می‌کند، نه
پوشه مقصد.
.IP \[bu] 2
هنگام رونوشت سمت سرور، محتوای پوشه پیوندداده‌شده رونوشت می‌شود،
نه میان‌بر.
.IP \[bu] 2
هنگام حذف با \f[V]rclone rmdir\f[R] یا \f[V]rclone purge\f[R]،
میان‌بر حذف می‌شود نه پوشه پیوندداده‌شده.
.IP \[bu] 2
\f[B]توجه\f[R] هنگام حذف با \f[V]rclone remove\f[R] یا
\f[V]rclone mount\f[R]، محتویات پوشه پیوندداده‌شده
حذف خواهند شد.
.PP
دستور rclone backend (https://rclone.org/commands/rclone_backend)
می‌تواند برای ایجاد میان‌برها استفاده شود.
.PP
میان‌برها را می‌توان با پرچم
\f[V]--drive-skip-shortcuts\f[R] یا تنظیم پیکربندی متناظر
\f[V]skip_shortcuts\f[R] به‌طور کامل نادیده گرفت.
.PP
هنگامی که \f[V]rclone lsf --format i\f[R] یک میان‌بر فایل را فهرست می‌کند، فیلد ID
شامل شناسه فایل هدف و به دنبال آن شناسه میان‌بر است که با یک نویسه برگه (tab) از هم جدا
شده‌اند.
این تب داخلی با \f[V]--separator\f[R] تغییر نمی‌کند.
.PP
اگر میان‌بر پوشه‌ای داشته باشید که به یکی از پوشه‌های والد خود اشاره کند،
منجر به یک فراخوانی بازگشتی بی‌پایان خواهد شد.
Rclone این مورد را تشخیص داده، میان‌بر مشکل‌ساز را از فهرست‌گیری کنار می‌گذارد
و یک ERROR ثبت می‌کند، تا مابقی درایو همچنان قابل رونوشت باشد..SS "خالی کردن سطل زباله (Emptying trash)"
.PP
اگر مایلید سطل زباله خود را خالی کنید، می‌توانید از دستور
\f[V]rclone cleanup remote:\f[R]
استفاده کنید که تمام فایل‌های درون سطل زباله شما را برای همیشه حذف خواهد کرد.
این دستور هیچ آرگومان مسیری نمی‌پذیرد.
.PP
توجه داشته باشید که حتی با وجود اینکه دستور ظرف چند ثانیه به پایان می‌رسد، خالی شدن سطل زباله توسط Google Drive مدتی زمان می‌برد (از چند دقیقه تا چند روز).
هیچ خروجی‌ای چاپ نمی‌شود، بنابراین حتی با استفاده از \-v یا \-vv نیز هیچ تأییدیه‌ای نمایش داده نخواهد شد.
.SS "اطلاعات سهمیه (Quota information)"
.PP
برای مشاهده سهمیه فعلی خود می‌توانید از دستور
\f[V]rclone about remote:\f[R]
استفاده کنید که محدودیت استفاده (سهمیه)، میزان فضای استفاده‌شده در Google Drive، اندازه تمام فایل‌های موجود در سطل زباله (Trash) و فضای اشغال‌شده توسط سایر سرویس‌های Google مانند Gmail را نمایش می‌دهد.
این دستور هیچ آرگومان مسیری نمی‌پذیرد.
.SS "درون‌ریزی/برون‌ریزی اسناد گوگل (Import/Export of google documents)"
.PP
اسناد Google documents را می‌توان از Google Drive برون‌ریزی کرد و در آن بارگذاری نمود.
.PP
هنگامی که rclone یک سند Google doc را دانلود می‌کند، قالبی را بر اساس تنظیمات \f[V]--drive-export-formats\f[R] برای دریافت انتخاب می‌کند.
به طور پیش‌فرض، قالب‌های برون‌ریزی \f[V]docx,xlsx,pptx,svg\f[R] هستند که یک پیش‌فرض منطقی برای اسناد قابل ویرایش محسوب می‌شوند.
.PP
هنگام انتخاب یک قالب، rclone فهرست ارائه‌شده را به ترتیب بررسی می‌کند و اولین قالب فایلی را از فهرست انتخاب می‌کند که سند قابلیت برون‌ریزی به آن را داشته باشد.
اگر فایل نتواند به هیچ‌یک از قالب‌های موجود در فهرست قالب‌ها صادر شود، آنگاه rclone قالبی را از فهرست پیش‌فرض برمی‌گزیند.
.PP
اگر یک نسخه بایگانی را ترجیح می‌دهید، می‌توانید از
\f[V]--drive-export-formats pdf\f[R]
استفاده کنید، یا اگر قالب‌های openoffice/libreoffice را ترجیح می‌دهید، می‌توانید از
\f[V]--drive-export-formats ods,odt,odp\f[R]
استفاده نمایید.
.PP
توجه داشته باشید که rclone پسوند را به سند Google doc اضافه می‌کند؛ بنابراین اگر نام آن در google docs برابر با \f[V]My Spreadsheet\f[R] باشد، به صورت \f[V]My Spreadsheet.xlsx\f[R] یا \f[V]My Spreadsheet.pdf\f[R] و غیره برون‌ریزی خواهد شد.
.PP
هنگام درون‌ریزی فایل‌ها به Google Drive، rclone تمام فایل‌های دارای پسوندی که در \f[V]--drive-import-formats\f[R] آمده باشد را به نوع سند مرتبط با آن‌ها تبدیل می‌کند.
rclone به طور پیش‌فرض هیچ فایلی را تبدیل نمی‌کند، زیرا تبدیل یک فرآیند همراه با اتلاف (lossy) است.
.PP
تبدیل باید به فایلی با همان پسوند منجر شود، هنگامی که قوانین \f[V]--drive-export-formats\f[R] بر روی سند بارگذاری‌شده اعمال می‌شوند.
.PP
در اینجا چند مثال از تبدیل‌های مجاز و غیرمجاز آورده شده است.
.PP
.TS
tab(@);
lw(17.2n) lw(17.2n) lw(12.3n) lw(14.7n) lw(8.6n).
T{
export-formats
T}@T{
import-formats
T}@T{
پسوند بارگذاری
T}@T{
پسوند سند
T}@T{
مجاز
T}
_
T{
odt
T}@T{
odt
T}@T{
odt
T}@T{
odt
T}@T{
بله
T}
T{
odt
T}@T{
docx,odt
T}@T{
odt
T}@T{
odt
T}@T{
بله
T}
T{
T}@T{
docx
T}@T{
docx
T}@T{
docx
T}@T{
بله
T}
T{
T}@T{
odt
T}@T{
odt
T}@T{
docx
T}@T{
خیر
T}
T{
odt,docx
T}@T{
docx,odt
T}@T{
docx
T}@T{
odt
T}@T{
خیر
T}
T{
docx,odt
T}@T{
docx,odt
T}@T{
docx
T}@T{
docx
T}@T{
بله
T}
T{
docx,odt
T}@T{
docx,odt
T}@T{
odt
T}@T{
docx
T}@T{
خیر
T}
.TE
.PP
این محدودیت را می‌توان با مشخص کردن گزینه
\f[V]--drive-allow-import-name-change\f[R]
غیرفعال کرد.
هنگام استفاده از این پرچم، rclone می‌تواند چندین نوع فایل مختلف را که در نهایت به همان نوع سند تبدیل می‌شوند به طور همزمان تبدیل کند؛ برای مثال با
\f[V]--drive-import-formats docx,odt,txt\f[R]\&،
تمام فایل‌های دارای این پسوندها به سندی تبدیل می‌شوند که به صورت یک فایل docx نمایش داده می‌شود.
در صورتی که چندین فایل دارای نام پایه (stem) یکسانی باشند، این کار خطر مضاعف رونویسی شدن یک سند را در پی دارد.
بسیاری از عملیات‌های rclone این تغییر نام را به هیچ وجه مدیریت نمی‌کنند.
آن‌ها هنگام کپی کردن فایل‌ها فرض را بر یکسان بودن نام می‌گذارند و در صورت تغییر نام ممکن است فایل را دوباره کپی کنند یا آن‌ها را حذف نمایند.
.PP
در اینجا پسوندهای ممکن برای برون‌ریزی به همراه انواع MIME متناظر با آن‌ها آورده شده است.
بیشتر این موارد را می‌توان برای درون‌ریزی نیز به کار برد، اما موارد بیشتری هم وجود دارند که در اینجا فهرست نشده‌اند.
برخی از این موارد اضافی ممکن است تنها زمانی در دسترس باشند که سیستم‌عامل مدخل‌های صحیح نوع MIME را فراهم کرده باشد.
.PP
این فهرست در هر زمان ممکن است توسط Google Drive تغییر کند و شاید نمایانگر تبدیلات موجود در زمان حاضر نباشد.
.PP
.TS
tab(@);
lw(19.7n) lw(24.1n) lw(26.2n).
T{
پسوند
T}@T{
نوع MIME
T}@T{
توضیحات
T}
_
T{
bmp
T}@T{
image/bmp
T}@T{
قالب Bitmap ویندوز
T}
T{
csv
T}@T{
text/csv
T}@T{
قالب استاندارد CSV برای صفحات گسترده
T}
T{
doc
T}@T{
application/msword
T}@T{
فایل کلاسیک Word
T}
T{
docx
T}@T{
application/vnd.openxmlformats-officedocument.wordprocessingml.document
T}@T{
سند Microsoft Office
T}
T{
epub
T}@T{
application/epub+zip
T}@T{
قالب کتاب الکترونیکی (E-book)
T}
T{
html
T}@T{
text/html
T}@T{
یک سند HTML
T}
T{
jpg
T}@T{
image/jpeg
T}@T{
یک فایل تصویر JPEG
T}
T{
json
T}@T{
application/vnd.google-apps.script+json
T}@T{
قالب متنی JSON برای اسکریپت‌های Google Apps
T}
T{
md
T}@T{
text/markdown
T}@T{
قالب متنی Markdown
T}
T{
odp
T}@T{
application/vnd.oasis.opendocument.presentation
T}@T{
ارائه Openoffice
T}
T{
ods
T}@T{
application/vnd.oasis.opendocument.spreadsheet
T}@T{
صفحه گسترده Openoffice
T}
T{
ods
T}@T{
application/x-vnd.oasis.opendocument.spreadsheet
T}@T{
صفحه گسترده Openoffice
T}
T{
odt
T}@T{
application/vnd.oasis.opendocument.text
T}@T{
سند Openoffice
T}
T{
pdf
T}@T{
application/pdf
T}@T{
قالب Adobe PDF
T}
T{
pjpeg
T}@T{
image/pjpeg
T}@T{
تصویر JPEG تدریجی (Progressive)
T}
T{
png
T}@T{
image/png
T}@T{
قالب تصویر PNG
T}
T{
pptx
T}@T{
application/vnd.openxmlformats-officedocument.presentationml.presentation
T}@T{
Microsoft Office Powerpoint
T}
T{
rtf
T}@T{
application/rtf
T}@T{
قالب متن غنی (Rich Text Format)
T}
T{
svg
T}@T{
image/svg+xml
T}@T{
قالب گرافیک برداری مقیاس‌پذیر (SVG)
T}
T{
tsv
T}@T{
text/tab-separated-values
T}@T{
قالب استاندارد TSV برای صفحات گسترده
T}
T{
txt
T}@T{
text/plain
T}@T{
متن ساده (Plain Text)
T}
T{
wmf
T}@T{
application/x-msmetafile
T}@T{
فایل تصویر برداری ویندوز (Windows Meta File)
T}
T{
xls
T}@T{
application/vnd.ms-excel
T}@T{
فایل کلاسیک Excel
T}
T{
xlsx
T}@T{
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
T}@T{
صفحه گسترده Microsoft Office
T}
T{
zip
T}@T{
application/zip
T}@T{
یک فایل ZIP حاوی HTML، تصاویر و CSS
T}
.TE.TE
.PP
اسناد Google همچنین می‌توانند به عنوان فایل‌های پیوند برون‌بری شوند.
این فایل‌ها در صورت باز شدن، پنجره‌ای از مرورگر را برای وب‌سایت Google Docs مربوط به آن سند باز می‌کنند.
پسوند فایل پیوند باید به عنوان یک پارامتر برای
\f[V]--drive-export-formats\f[R] مشخص شود.
آن‌ها با تمام Google Documents موجود مطابقت خواهند داشت.
.PP
.TS
tab(@);
l l l.
T{
پسوند
T}@T{
توضیحات
T}@T{
پشتیبانی سیستم‌عامل
T}
_
T{
desktop
T}@T{
مدخل دسکتاپ مشخص‌شده توسط freedesktop.org
T}@T{
Linux
T}
T{
link.html
T}@T{
یک سند HTML دارای تغییر مسیر
T}@T{
همه
T}
T{
url
T}@T{
فایل پیوند به سبک INI
T}@T{
macOS, Windows
T}
T{
webloc
T}@T{
قالب XML ویژهٔ macOS
T}@T{
macOS
T}
.TE
.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص به drive (Google Drive) آورده شده است.
.SS --drive-client-id
.PP
شناسهٔ کلاینت برنامهٔ گوگل (Google Application Client Id). در صورت استفاده از یک service account یا برای استفاده از client_id مشترک rclone، این مقدار را خالی بگذارید.
شناسهٔ مشترک client_id در حال از رده خارج شدن است و در طول سال ۲۰۲۶ از کار خواهد افتاد، بنابراین اکنون ایجاد شناسهٔ اختصاصی خودتان اکیداً توصیه می‌شود.
برای مشاهدهٔ نحوهٔ ایجاد شناسهٔ خود، https://rclone.org/drive/#making-your-own-client-id را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --drive-client-secret
.PP
رمز کلاینت برنامهٔ گوگل (Google Application Client Secret). در صورت استفاده از یک service account یا برای استفاده از client_id مشترک rclone، این مقدار را خالی بگذارید.
اگر client_id اختصاصی خود را ساخته‌اید، client secret آن را در اینجا وارد کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --drive-scope
.PP
فهرستی جداشده با کاما از دامنه‌های دسترسی (scopes) که rclone باید هنگام درخواست دسترسی از drive استفاده کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: scope
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_SCOPE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]drive\[dq]
.RS 2
.IP \[bu] 2
دسترسی کامل به همه فایل‌ها، به استثنای پوشه Application Data.
.RE
.IP \[bu] 2
\[dq]drive.readonly\[dq]
.RS 2
.IP \[bu] 2
دسترسی فقط‌خواندنی به فراداده‌ها و محتوای فایل‌ها.
.RE
.IP \[bu] 2
\[dq]drive.file\[dq]
.RS 2
.IP \[bu] 2
دسترسی تنها به فایل‌های ایجادشده توسط rclone.
.IP \[bu] 2
این فایل‌ها در وب‌سایت drive قابل مشاهده هستند.
.IP \[bu] 2
مجوز فایل با لغو دسترسی برنامه توسط کاربر باطل می‌شود.
.RE
.IP \[bu] 2
\[dq]drive.appfolder\[dq]
.RS 2
.IP \[bu] 2
امکان دسترسی خواندن و نوشتن به پوشه Application Data را فراهم می‌کند.
.IP \[bu] 2
این پوشه در وب‌سایت drive قابل مشاهده نیست.
.RE
.IP \[bu] 2
\[dq]drive.metadata.readonly\[dq]
.RS 2
.IP \[bu] 2
امکان دسترسی فقط‌خواندنی به فراداده فایل‌ها را فراهم می‌کند اما
.IP \[bu] 2
هیچ دسترسی برای خواندن یا بارگیری محتوای فایل نمی‌دهد.
.RE
.RE
.SS --drive-service-account-file
.PP
مسیر فایل JSON اعتبارنامه‌های Service Account.
.PP
در حالت عادی خالی بگذارید.
تنها در صورتی مورد نیاز است که بخواهید به جای ورود تعاملی از SA استفاده کنید.
.PP
علامت \f[V]\[ti]\f[R] در ابتدای نام فایل و همچنین متغیرهای محیطی نظیر \f[V]${RCLONE_CONFIG_DIR}\f[R] بسط داده خواهند شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: service_account_file
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_SERVICE_ACCOUNT_FILE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مخصوص drive (Google Drive) آورده شده است.
.SS --drive-token
.PP
توکن دسترسی OAuth در قالب یک JSON blob.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --drive-auth-url
.PP
نشانی اینترنتی (URL) سرور احراز هویت.
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --drive-token-url
.PP
نشانی اینترنتی (URL) سرور توکن.
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --drive-client-credentials
.PP
استفاده از جریان اعتبارسنجی client credentials در OAuth.
.PP
این گزینه از جریان Client Credentials در OAUTH2 همان‌طور که در RFC
6749 توصیف شده است، استفاده خواهد کرد.
.PP
توجه داشته باشید که این گزینه توسط همهٔ بک‌اندها پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-root-folder-id
.PP
شناسهٔ پوشهٔ ریشه.
در حالت عادی خالی بگذارید.
.PP
برای دسترسی به پوشه‌های \[dq]Computers\[dq] (مستندات را ببینید)، یا برای این‌که rclone
از یک پوشهٔ غیر ریشه به عنوان نقطهٔ شروع خود استفاده کند، این فیلد را پر کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_folder_id
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_ROOT_FOLDER_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --drive-service-account-credentials
.PP
دادهٔ JSON اعتبارنامه‌های Service Account.
.PP
در حالت عادی خالی بگذارید.
تنها در صورتی نیاز است که بخواهید به‌جای ورود تعاملی از SA استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: service_account_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_SERVICE_ACCOUNT_CREDENTIALS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --drive-team-drive
.PP
شناسه درایو مشترک (Shared Drive یا همان Team Drive).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: team_drive
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_TEAM_DRIVE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --drive-auth-owner-only
.PP
فقط فایل‌هایی که در مالکیت کاربر احراز هویت‌شده هستند در نظر گرفته شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_owner_only
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_AUTH_OWNER_ONLY
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-use-trash
.PP
انتقال فایل‌ها به سطل زباله به‌جای حذف دائمی آن‌ها.
.PP
پیش‌فرض برابر با true است، به این معنی که فایل‌ها به سطل زباله فرستاده می‌شوند.
به‌جای آن برای حذف دائمی فایل‌ها از \f[V]--drive-use-trash=false\f[R] استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_trash
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_USE_TRASH
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --drive-copy-shortcut-content
.PP
کپی سمت سرور محتویات میانبرها به‌جای خود میانبر.
.PP
هنگام انجام کپی سمت سرور، rclone در حالت عادی میانبرها را به‌صورت میانبر کپی می‌کند.
.PP
اگر این پرچم استفاده شود، rclone هنگام انجام کپی‌های سمت سرور به‌جای خود میانبرها، محتویات میانبرها را کپی خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: copy_shortcut_content
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_COPY_SHORTCUT_CONTENT
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-skip-gdocs
.PP
نادیده گرفتن اسناد گوگل (Google Docs) در تمام فهرست‌ها.
.PP
در صورت تعیین، اسناد گوگل عملاً برای rclone نامرئی می‌شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: skip_gdocs
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_SKIP_GDOCS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-show-all-gdocs
.PP
نمایش تمام اسناد گوگل در فهرست‌ها، از جمله مواردی که قابل خروجی‌گرفتن نیستند.
.PP
اگر بدون این پرچم یک کپی سمت سرور را روی Google Form امتحان کنید، با این خطا مواجه خواهید شد:
.IP
.nf
\f[C]
No export formats found for \[dq]application/vnd.google-apps.form\[dq]
\f[R]
.fi
.PP
با این حال، افزودن این پرچم امکان کپی سمت سرور فُرم را فراهم می‌کند.
.PP
توجه داشته باشید که rclone در این حالت پسوندی به نام فایل‌های اسناد گوگل اضافه نمی‌کند.
.PP
هنگام تلاش برای دانلود اسناد گوگل از این پرچم استفاده \f[B]نکنید\f[R] \- دانلود آن‌ها توسط rclone با شکست مواجه خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: show_all_gdocs
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_SHOW_ALL_GDOCS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --drive-skip-checksum-gphotos
.PP
صرف‌نظر کردن از مجموع وارسی (checksum) تنها برای عکس‌ها و ویدیوهای Google.
.PP
اگر هنگام انتقال عکس‌ها یا ویدیوهای Google با خطاهای مجموع وارسی مواجه می‌شوید، از این گزینه استفاده کنید.
.PP
تنظیم این پرچم باعث می‌شود که عکس‌ها و ویدیوهای Google مجموع وارسی خالی برگردانند.
.PP
عکس‌های Google با قرار داشتن در فضای \[dq]photos\[dq] شناسایی می‌شوند.
.PP
خرابی مجموع‌های وارسی به این دلیل است که Google تصویر/ویدیو را تغییر می‌دهد اما مجموع وارسی آن را به‌روزرسانی نمی‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: skip_checksum_gphotos
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_SKIP_CHECKSUM_GPHOTOS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-shared-with-me
.PP
فقط نمایش فایل‌هایی که با من به اشتراک گذاشته شده‌اند.
.PP
به rclone دستور می‌دهد که روی پوشه \[dq]Shared with me\[dq] شما عمل کند (جایی که Google Drive امکان دسترسی به فایل‌ها و پوشه‌هایی را می‌دهد که دیگران با شما به اشتراک گذاشته‌اند).
.PP
این گزینه هم با دستورهای \[dq]list\[dq] (مانند lsd،‏ lsl و غیره) و هم با دستورهای \[dq]copy\[dq] (مانند copy،‏ sync و غیره)، و همچنین با تمامی دستورهای دیگر کار می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: shared_with_me
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_SHARED_WITH_ME
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-trashed-only
.PP
فقط نمایش فایل‌هایی که در سطل زباله قرار دارند.
.PP
این گزینه فایل‌های درون سطل زباله را در ساختار دایرکتوری اصلی آن‌ها نمایش می‌دهد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: trashed_only
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_TRASHED_ONLY
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-starred-only
.PP
فقط نمایش فایل‌هایی که ستاره‌دار هستند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: starred_only
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_STARRED_ONLY
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-formats
.PP
منسوخ‌شده: به export_formats مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: formats
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_FORMATS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --drive-export-formats
.PP
فهرستی جداشده با کاما از قالب‌های ترجیحی برای بارگیری اسناد Google Docs.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: export_formats
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_EXPORT_FORMATS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]docx,xlsx,pptx,svg\[dq]
.SS --drive-import-formats
.PP
فهرستی جداشده با کاما از قالب‌های ترجیحی برای بارگذاری اسناد Google Docs.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: import_formats
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_IMPORT_FORMATS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --drive-allow-import-name-change
.PP
اجازه تغییر نوع فایل هنگام بارگذاری اسناد Google Docs.
.PP
به‌عنوان مثال،
file.doc به file.docx.
این امر باعث سردرگمی ابزار sync شده و هر بار فایل مجدداً بارگذاری می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: allow_import_name_change
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_ALLOW_IMPORT_NAME_CHANGE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-use-created-date
.PP
استفاده از تاریخ ایجاد فایل به جای تاریخ تغییر.
.PP
زمانی کاربرد دارد که داده‌ها را بارگیری می‌کنید و می‌خواهید به جای تاریخ آخرین تغییر، از تاریخ ایجاد فایل استفاده شود.
.PP
\f[B]هشدار\f[R]: این پرچم ممکن است پیامدهای غیرمنتظره‌ای در بر داشته باشد.
.PP
هنگام بارگذاری در درایو شما، تمام فایل‌ها بازنویسی خواهند شد مگر اینکه از زمان ایجادشان تغییری نکرده باشند؛
و عکس این حالت هنگام بارگیری رخ خواهد داد.
با استفاده از پرچم \[dq]--checksum\[dq] می‌توان از این اثر جانبی جلوگیری کرد.
.PP
این قابلیت برای حفظ تاریخ ثبت عکس‌ها به‌صورت ثبت‌شده در Google Photos پیاده‌سازی شده است.
ابتدا باید گزینه \[dq]Create a Google Photos folder\[dq] را در تنظیمات Google Drive خود علامت بزنید.
سپس می‌توانید عکس‌ها را به‌صورت محلی کپی کرده یا انتقال دهید و تاریخ گرفته‌شدن (ایجاد) تصویر را به عنوان تاریخ تغییر فایل تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_created_date
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_USE_CREATED_DATE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-use-shared-date
.PP
استفاده از تاریخ به‌اشتراک‌گذاری فایل به جای تاریخ تغییر.
.PP
توجه داشته باشید که همانند \[dq]--drive-use-created-date\[dq]، این پرچم نیز ممکن است هنگام بارگذاری یا بارگیری فایل‌ها پیامدهای غیرمنتظره‌ای داشته باشد.
.PP
اگر هر دو پرچم و \[dq]--drive-use-created-date\[dq] تنظیم شده باشند، از تاریخ ایجاد استفاده خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_shared_date
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_USE_SHARED_DATE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --drive-list-chunk
.PP
اندازه تکه‌های فهرست‌بندی بین ۱۰۰ تا ۱۰۰۰، مقدار ۰ برای غیرفعال کردن.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_chunk
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_LIST_CHUNK
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 1000
.SS --drive-impersonate
.PP
جعل هویت این کاربر هنگام استفاده از یک service account.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: impersonate
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_IMPERSONATE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --drive-upload-cutoff
.PP
حد آستانه برای تغییر وضعیت به بارگذاری تکه‌ای (chunked upload).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 8Mi
.SS --drive-chunk-size
.PP
اندازه تکه بارگذاری.
.PP
باید توانی از ۲ و بزرگ‌تر یا مساوی با 256k باشد.
.PP
بزرگ‌تر کردن این مقدار کارایی را بهبود می‌بخشد، اما توجه داشته باشید که هر تکه به ازای هر انتقال در حافظه بافر می‌شود.
.PP
کاهش این مقدار مصرف حافظه را کم می‌کند اما کارایی را کاهش خواهد داد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 8Mi
.SS --drive-acknowledge-abuse
.PP
برای مجاز کردن بارگیری فایل‌هایی تنظیم می‌شود که خطای cannotDownloadAbusiveFile را برمی‌گردانند.
.PP
اگر بارگیری یک فایل خطای \[dq]This file has been identified as malware or spam and cannot be downloaded\[dq] را با کد خطای \[dq]cannotDownloadAbusiveFile\[dq] برگرداند، این گزینه را به rclone بدهید تا مشخص شود خطرات بارگیری فایل را پذیرفته‌اید و rclone فایل را در هر صورت بارگیری خواهد کرد.
.PP
توجه داشته باشید که اگر از service account استفاده می‌کنید، برای کارکرد این گزینه به دسترسی Manager (و نه Content Manager) نیاز خواهد بود.
اگر SA دسترسی لازم را نداشته باشد، Google صرفاً این پرچم را نادیده می‌گیرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: acknowledge_abuse
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_ACKNOWLEDGE_ABUSE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --drive-keep-revision-forever
.PP
نگه‌داری بازبینی اصلی (head revision) جدید هر فایل برای همیشه.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: keep_revision_forever
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_KEEP_REVISION_FOREVER
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-size-as-quota
.PP
نمایش اندازه‌ها بر مبنای میزان مصرف سهمیه ذخیره‌سازی، نه اندازه واقعی.
.PP
نمایش اندازه یک فایل بر مبنای سهمیه ذخیره‌سازی مصرف‌شده.
این مقدار برابر با نسخه فعلی به‌علاوه هر نسخه قدیمی‌تری است که روی نگه‌داری همیشگی تنظیم شده باشد.
.PP
\f[B]هشدار\f[R]: این پرچم ممکن است پیامدهای غیرمنتظره‌ای در پی داشته باشد.
.PP
تنظیم این پرچم در پیکربندی شما توصیه نمی‌شود \- کاربرد پیشنهادی، استفاده از شکل پرچم \-\-drive\-size\-as\-quota تنها هنگام اجرای rclone ls/lsl/lsf/lsjson/etc است.
.PP
اگر از این پرچم برای همگام‌سازی استفاده می‌کنید (که توصیه نمی‌شود)، در این صورت باید از \-\-ignore size نیز استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: size_as_quota
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_SIZE_AS_QUOTA
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-v2-download-min-size
.PP
در صورتی که حجم اشیاء بیشتر باشد، از drive v2 API برای بارگیری استفاده می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: v2_download_min_size
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_V2_DOWNLOAD_MIN_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: off
.SS --drive-pacer-min-sleep
.PP
حداقل زمان توقف (sleep) بین فراخوانی‌های API.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pacer_min_sleep
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_PACER_MIN_SLEEP
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 100ms
.SS --drive-pacer-burst
.PP
تعداد فراخوانی‌های مجاز API بدون ایجاد توقف.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pacer_burst
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_PACER_BURST
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 100
.SS --drive-server-side-across-configs
.PP
منسوخ شده: به‌جای آن از \-\-server\-side\-across\-configs استفاده کنید.
.PP
اجازه به عملیات‌های سمت سرور (مانند
copy) برای کار میان پیکربندی‌های مختلف drive.
.PP
این ویژگی می‌تواند زمانی که مایل به انجام یک کپی سمت سرور بین دو Google Drive مختلف هستید مفید باشد.
توجه داشته باشید که این گزینه به‌طور پیش‌فرض فعال نیست، زیرا به‌سادگی نمی‌توان تشخیص داد که آیا میان هر دو پیکربندی دلخواهی کار خواهد کرد یا خیر.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: server_side_across_configs
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_SERVER_SIDE_ACROSS_CONFIGS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --drive-disable-http2
.PP
غیرفعال کردن استفاده drive از http2.
.PP
در حال حاضر یک مشکل حل‌نشده میان بک‌اند Google Drive و
HTTP/2 وجود دارد.
از این رو HTTP/2 به‌طور پیش‌فرض برای بک‌اند drive غیرفعال است اما می‌تواند
از اینجا دوباره فعال شود.
هنگامی که این مشکل برطرف شود، این پرچم حذف خواهد شد.
.PP
ببینید: https://github.com/rclone/rclone/issues/3631
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_http2
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_DISABLE_HTTP2
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --drive-stop-on-upload-limit
.PP
مهلک تلقی کردن خطاهای مربوط به سقف بارگذاری.
.PP
در زمان نگارش این متن، تنها امکان بارگذاری ۷۵۰ GiB داده در روز در
Google Drive وجود دارد (این یک محدودیت مستند نشده است).
هنگامی که به این سقف رسیده شود، Google Drive پیام خطای کمی متفاوت
تولید می‌کند.
هنگامی که این پرچم تنظیم شود، باعث می‌شود این خطاها مهلک در نظر گرفته شوند.
این خطاها همگام‌سازی در حال انجام را متوقف خواهند کرد.
.PP
توجه داشته باشید که این تشخیص به رشته‌های پیام خطا متکی است که
Google آن‌ها را مستند نمی‌کند؛ بنابراین ممکن است در آینده با مشکل مواجه شود.
.PP
ببینید: https://github.com/rclone/rclone/issues/3857
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: stop_on_upload_limit
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_STOP_ON_UPLOAD_LIMIT
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-stop-on-download-limit
.PP
مهلک تلقی کردن خطاهای مربوط به سقف بارگیری.
.PP
در زمان نگارش این متن، تنها امکان بارگیری ۱۰ TiB داده در روز از
Google Drive وجود دارد (این یک محدودیت مستند نشده است).
هنگامی که به این سقف رسیده شود، Google Drive پیام خطای کمی متفاوت
تولید می‌کند.
هنگامی که این پرچم تنظیم شود، باعث می‌شود این خطاها مهلک در نظر گرفته شوند.
این خطاها همگام‌سازی در حال انجام را متوقف خواهند کرد.
.PP
توجه داشته باشید که این تشخیص به رشته‌های پیام خطا متکی است که
Google آن‌ها را مستند نمی‌کند؛ بنابراین ممکن است در آینده با مشکل مواجه شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: stop_on_download_limit
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_STOP_ON_DOWNLOAD_LIMIT
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-skip-shortcuts
.PP
در صورت تنظیم، صرف‌نظر کردن از فایل‌های میان‌بر (shortcut).
.PP
در حالت عادی rclone ارجاع فایل‌های میان‌بر را دنبال می‌کند (dereference) و باعث می‌شود به‌گونه‌ای
به‌نظر برسند که گویی فایل اصلی هستند (بخش shortcuts را ببینید).
اگر این پرچم تنظیم شود، rclone فایل‌های میان‌بر را کاملاً نادیده خواهد گرفت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: skip_shortcuts
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_SKIP_SHORTCUTS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --drive-skip-dangling-shortcuts
.PP
اگر تنظیم شود، فایل‌های میانبر معلق (dangling shortcut) نادیده گرفته می‌شوند.
.PP
اگر این گزینه تنظیم شود، rclone هیچ میانبر معلقی را در فهرست‌بندی‌ها نمایش نخواهد داد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: skip_dangling_shortcuts
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_SKIP_DANGLING_SHORTCUTS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-resource-key
.PP
کلید منبع (Resource key) برای دسترسی به فایلی که با پیوند به اشتراک گذاشته شده است.
.PP
اگر نیاز به دسترسی به فایل‌های به اشتراک گذاشته‌شده با پیوندی مانند این دارید:
.IP
.nf
\f[C]
https://drive.google.com/drive/folders/XXX?resourcekey=YYY&usp=sharing
\f[R]
.fi
.PP
آنگاه باید از بخش نخست یعنی \[dq]XXX\[dq] به عنوان \[dq]root_folder_id\[dq] و از بخش دوم یعنی \[dq]YYY\[dq] به عنوان \[dq]resource_key\[dq] استفاده کنید؛ در غیر این صورت هنگام تلاش برای دسترسی به پوشه با خطای 404 not found مواجه خواهید شد.
.PP
ببینید: https://developers.google.com/drive/api/guides/resource-keys
.PP
این الزامِ کلید منبع تنها برای زیرمجموعه‌ای از فایل‌های قدیمی اعمال می‌شود.
.PP
همچنین توجه داشته باشید به نظر می‌رسد یک‌بار باز کردن پوشه در رابط تحت وب (با همان کاربری که rclone را با آن احراز هویت کرده‌اید) کافی است تا دیگر نیازی به کلید منبع نباشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: resource_key
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_RESOURCE_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --drive-fast-list-bug-fix
.PP
دور زدن یک اشکال در فهرست‌بندی Google Drive.
.PP
به‌طور معمول rclone هنگام استفاده از --fast-list (ListR) اشکالی را در Google Drive دور می‌زند که در آن گاهی اوقات جستجوی \[dq](A in parents) or (B in parents)\[dq] هیچ نتیجه‌ای برنمی‌گرداند.
شماره‌های #3114، #4289 و https://issuetracker.google.com/issues/149522397 را ببینید.
.PP
برنامه rclone این مورد را از طریق نیافتن هیچ موردی در بیش از یک پوشه هنگام فهرست‌بندی تشخیص می‌دهد و آن‌ها را به صورت فهرست‌هایی از پوشه‌های مجزا دوباره امتحان می‌کند.
.PP
این بدان معناست که اگر تعداد زیادی پوشه خالی داشته باشید، rclone در نهایت همه آن‌ها را به صورت تک‌تک فهرست می‌کند و این امر می‌تواند فراخوانی‌های API بسیار بیشتری مصرف کند.
.PP
این پرچم امکان غیرفعال کردن راهکار دور زدن را فراهم می‌کند.
استفاده از آن در حالت عادی توصیه \f[B]نمی‌شود\f[R] \- مگر در موارد خاصی که با مشکل مواجه شده‌اید، مانند وجود تعداد زیادی پوشه خالی.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: fast_list_bug_fix
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_FAST_LIST_BUG_FIX
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --drive-metadata-owner
.PP
کنترل این که آیا مالک (owner) باید در متادیتا خوانده یا نوشته شود.
.PP
مالک بخشی استاندارد از متادیتای فایل است، بنابراین خواندن آن آسان است. اما همیشه تعیین مالک از طریق متادیتا مطلوب نیست.
.PP
توجه داشته باشید که نمی‌توانید مالک را در Shared Drives تنظیم کنید، و تعیین مالکیت باعث ارسال یک رایانامه به مالک جدید می‌شود (این مورد قابل غیرفعال‌سازی نیست)، و همچنین نمی‌توانید مالکیت را به فردی خارج از سازمان خود منتقل کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: metadata_owner
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_METADATA_OWNER
.IP \[bu] 2
نوع: Bits
.IP \[bu] 2
پیش‌فرض: read
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]off\[dq]
.RS 2
.IP \[bu] 2
مقدار نه خوانده شود و نه نوشته شود
.RE
.IP \[bu] 2
\[dq]read\[dq]
.RS 2
.IP \[bu] 2
فقط مقدار خوانده شود
.RE
.IP \[bu] 2
\[dq]write\[dq]
.RS 2
.IP \[bu] 2
فقط مقدار نوشته شود
.RE
.IP \[bu] 2
\[dq]failok\[dq]
.RS 2
.IP \[bu] 2
اگر نوشتن با شکست مواجه شد، فقط خطاها ثبت شوند، فرآیند انتقال ناموفق نشود
.RE
.IP \[bu] 2
\[dq]read,write\[dq]
.RS 2
.IP \[bu] 2
مقدار هم خوانده و هم نوشته شود.
.RE
.RE.SS --drive-metadata-permissions
.PP
کنترل اینکه آیا مجوزها باید در فراداده خوانده یا نوشته شوند.
.PP
خواندن فرادادهٔ مجوزها از فایل‌ها سریع انجام می‌شود، اما تنظیم مجوزها از روی فراداده همیشه مطلوب نیست.
.PP
توجه داشته باشید که rclone هرگونه مجوز موروثی در Shared Drives و هرگونه مجوز مالک در My Drives را نادیده می‌گیرد، زیرا این موارد در فرادادهٔ مالک تکرار شده‌اند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: metadata_permissions
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_METADATA_PERMISSIONS
.IP \[bu] 2
نوع: Bits
.IP \[bu] 2
پیش‌فرض: off
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]off\[dq]
.RS 2
.IP \[bu] 2
مقدار خوانده یا نوشته نشود
.RE
.IP \[bu] 2
\[dq]read\[dq]
.RS 2
.IP \[bu] 2
فقط مقدار خوانده شود
.RE
.IP \[bu] 2
\[dq]write\[dq]
.RS 2
.IP \[bu] 2
فقط مقدار نوشته شود
.RE
.IP \[bu] 2
\[dq]failok\[dq]
.RS 2
.IP \[bu] 2
در صورت شکست در نوشتن، تنها خطاها ثبت شوند و فرایند انتقال با شکست مواجه نشود
.RE
.IP \[bu] 2
\[dq]read,write\[dq]
.RS 2
.IP \[bu] 2
مقدار خوانده و نوشته شود.
.RE
.RE
.SS --drive-metadata-labels
.PP
کنترل اینکه آیا برچسب‌ها باید در فراداده خوانده یا نوشته شوند.
.PP
خواندن فرادادهٔ برچسب‌ها از فایل‌ها نیازمند یک تراکنش API اضافی است و سرعت فهرست‌کردن را کاهش می‌دهد.
همچنین تنظیم برچسب‌ها از روی فراداده همیشه مطلوب نیست.
.PP
قالب برچسب‌ها در مستندات API درایو در نشانی https://developers.google.com/drive/api/reference/rest/v3/Label مستند شده است \- rclone صرفاً یک خروجی JSON از این قالب ارائه می‌دهد.
.PP
هنگام تنظیم برچسب‌ها، برچسب و فیلدها باید از قبل وجود داشته باشند \- rclone آن‌ها را ایجاد نخواهد کرد.
این بدان معناست که اگر برچسب‌ها را بین دو حساب کاربری مختلف منتقل می‌کنید، باید برچسب‌ها را از قبل ایجاد کرده و از نگاشت‌کنندهٔ فراداده (metadata mapper) برای تبدیل شناسه‌ها بین دو حساب استفاده نمایید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: metadata_labels
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_METADATA_LABELS
.IP \[bu] 2
نوع: Bits
.IP \[bu] 2
پیش‌فرض: off
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]off\[dq]
.RS 2
.IP \[bu] 2
مقدار خوانده یا نوشته نشود
.RE
.IP \[bu] 2
\[dq]read\[dq]
.RS 2
.IP \[bu] 2
فقط مقدار خوانده شود
.RE
.IP \[bu] 2
\[dq]write\[dq]
.RS 2
.IP \[bu] 2
فقط مقدار نوشته شود
.RE
.IP \[bu] 2
\[dq]failok\[dq]
.RS 2
.IP \[bu] 2
در صورت شکست در نوشتن، تنها خطاها ثبت شوند و فرایند انتقال با شکست مواجه نشود
.RE
.IP \[bu] 2
\[dq]read,write\[dq]
.RS 2
.IP \[bu] 2
مقدار خوانده و نوشته شود.
.RE
.RE.SS --drive-metadata-enforce-expansive-access
.PP
تعیین این‌که آیا درخواست باید قوانین دسترسی گسترده (expansive access) را اعمال کند یا خیر.
.PP
از فوریه ۲۰۲۶ این پرچم به‌طور پیش‌فرض فعال خواهد بود، بنابراین می‌توان از آن پیش از موعد برای آزمایش استفاده کرد.
.PP
مشاهده کنید:
https://developers.google.com/workspace/drive/api/guides/limited-expansive-access
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: metadata_enforce_expansive_access
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_METADATA_ENFORCE_EXPANSIVE_ACCESS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --drive-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر بخش کدگذاری را در نمای کلی (https://rclone.org/overview/#encoding) مشاهده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: InvalidUtf8
.SS --drive-env-auth
.PP
دریافت اعتبارنامه‌های IAM از زمان اجرا (متغیرهای محیطی یا در صورت نبود آن‌ها، فراداده‌های نمونه).
.PP
تنها در صورتی اعمال می‌شود که service_account_file و service_account_credentials خالی باشند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: env_auth
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_ENV_AUTH
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]false\[dq]
.RS 2
.IP \[bu] 2
وارد کردن اعتبارنامه‌ها در مرحله بعد.
.RE
.IP \[bu] 2
\[dq]true\[dq]
.RS 2
.IP \[bu] 2
دریافت اعتبارنامه‌های GCP IAM از محیط (متغیرهای محیطی یا IAM).
.RE
.RE
.SS --drive-description
.PP
توضیحات remote.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_DRIVE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS متاداده (Metadata)
.PP
متاداده کاربر در فیلد properties شیء drive ذخیره می‌شود.
.PP
متاداده روی فایل‌ها و دایرکتوری‌ها پشتیبانی می‌شود.
.PP
در اینجا موارد ممکن متاداده سیستم برای بک‌اند drive آورده شده است.
.PP
.TS
tab(@);
lw(11.1n) lw(11.1n) lw(11.1n) lw(16.6n) lw(20.3n).
T{
نام
T}@T{
راهنما
T}@T{
نوع
T}@T{
مثال
T}@T{
فقط‌خواندنی
T}
_
T{
btime
T}@T{
زمان ایجاد (تولد) فایل با دقت میلی‌ثانیه.
توجه داشته باشید که این مورد تنها در بارگذاری‌های تازه قابل نوشتن است \- برای
به‌روزرسانی‌ها قابل نوشتن نیست.
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999Z07:00
T}@T{
N
T}
T{
content-type
T}@T{
نوع MIME فایل.
T}@T{
string
T}@T{
text/plain
T}@T{
N
T}
T{
copy-requires-writer-permission
T}@T{
اینکه آیا گزینه‌های کپی، چاپ یا بارگیری این فایل باید برای
خوانندگان و نظردهندگان غیرفعال شوند یا خیر.
T}@T{
boolean
T}@T{
true
T}@T{
N
T}
T{
description
T}@T{
توضیح کوتاهی درباره فایل.
T}@T{
string
T}@T{
Contract for signing
T}@T{
N
T}
T{
folder-color-rgb
T}@T{
رنگ یک پوشه یا میان‌بر پوشه به‌صورت یک رشته هگز RGB.
T}@T{
string
T}@T{
881133
T}@T{
N
T}
T{
labels
T}@T{
برچسب‌های ضمیمه‌شده به این فایل در خروجی JSON از قالب Google Drive.
فعال‌سازی با \-\-drive\-metadata\-labels.
T}@T{
JSON
T}@T{
[]
T}@T{
N
T}
T{
mtime
T}@T{
زمان آخرین تغییر با دقت میلی‌ثانیه.
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999Z07:00
T}@T{
N
T}
T{
owner
T}@T{
مالک فایل.
معمولاً یک نشانی ایمیل.
فعال‌سازی با \-\-drive\-metadata\-owner.
T}@T{
string
T}@T{
user\[at]example.com
T}@T{
N
T}
T{
permissions
T}@T{
مجوزها در خروجی JSON از قالب Google Drive.
در درایوهای اشتراکی، این موارد تنها در صورتی وجود خواهند داشت که
به‌ارث‌رسیده نباشند.
فعال‌سازی با \-\-drive\-metadata\-permissions.
T}@T{
JSON
T}@T{
{}
T}@T{
N
T}
T{
starred
T}@T{
اینکه آیا کاربر فایل را ستاره‌دار کرده است یا خیر.
T}@T{
boolean
T}@T{
false
T}@T{
N
T}
T{
viewed-by-me
T}@T{
اینکه آیا فایل توسط این کاربر مشاهده شده است یا خیر.
T}@T{
boolean
T}@T{
true
T}@T{
\f[B]Y\f[R]
T}
T{
writers-can-share
T}@T{
اینکه آیا کاربرانی که فقط مجوز نوشتن دارند می‌توانند مجوزهای
فایل را تغییر دهند یا خیر.
برای موارد موجود در درایوهای اشتراکی مقداردهی نمی‌شود و نادیده گرفته می‌شود.
T}@T{
boolean
T}@T{
false
T}@T{
N
T}
.TE
.PP
برای اطلاعات بیشتر مستندات متاداده (https://rclone.org/docs/#metadata) را ببینید..SS دستورهای backend
.PP
در اینجا دستورهای مخصوص backend درایو (drive) آورده شده است.
.PP
اجرای آن‌ها با:
.IP
.nf
\f[C]
rclone backend COMMAND remote:
\f[R]
.fi
.PP
راهنمای زیر توضیح می‌دهد که هر دستور چه آرگومان‌هایی دریافت می‌کند.
.PP
برای اطلاعات بیشتر درباره نحوه ارسال گزینه‌ها و آرگومان‌ها، دستور backend (https://rclone.org/commands/rclone_backend) را ببینید.
.PP
این موارد را می‌توان روی یک backend در حال اجرا با استفاده از دستور rc به نام backend/command (https://rclone.org/rc/#backend-command) اجرا کرد.
.SS get
.PP
دستور get برای واکشی پارامترهای پیکربندی drive.
.IP
.nf
\f[C]
rclone backend get remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این یک دستور get است که برای واکشی پارامترهای مختلف پیکربندی drive استفاده می‌شود.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend get drive: [-o service_account_file] [-o chunk_size]
rclone rc backend/command command=get fs=drive: [-o service_account_file] [-o chunk_size]
\f[R]
.fi
.PP
گزینه‌ها:
.IP \[bu] 2
\[dq]chunk_size\[dq]: نمایش اندازه فعلی قطعه بارگذاری (chunk size).
.IP \[bu] 2
\[dq]service_account_file\[dq]: نمایش فایل حساب سرویس (service account) فعلی.
.SS set
.PP
دستور set برای به‌روزرسانی پارامترهای پیکربندی drive.
.IP
.nf
\f[C]
rclone backend set remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این یک دستور set است که برای به‌روزرسانی پارامترهای مختلف پیکربندی drive استفاده می‌شود.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend set drive: [-o service_account_file=sa.json] [-o chunk_size=67108864]
rclone rc backend/command command=set fs=drive: [-o service_account_file=sa.json] [-o chunk_size=67108864]
\f[R]
.fi
.PP
گزینه‌ها:
.IP \[bu] 2
\[dq]chunk_size\[dq]: به‌روزرسانی اندازه فعلی قطعه بارگذاری (chunk size).
.IP \[bu] 2
\[dq]service_account_file\[dq]: به‌روزرسانی فایل حساب سرویس (service account) فعلی.
.SS shortcut
.PP
ایجاد میان‌بر از فایل‌ها یا دایرکتوری‌ها.
.IP
.nf
\f[C]
rclone backend shortcut remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور میان‌برهایی از فایل‌ها یا دایرکتوری‌ها ایجاد می‌کند.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend shortcut drive: source_item destination_shortcut
rclone backend shortcut drive: source_item -o target=drive2: destination_shortcut
\f[R]
.fi
.PP
در مثال اول، یک میان‌بر از \[dq]source_item\[dq] (که می‌تواند یک فایل یا یک دایرکتوری باشد) به \[dq]destination_shortcut\[dq] ایجاد می‌شود.
مسیرهای \[dq]source_item\[dq] و \[dq]destination_shortcut\[dq] باید مسیرهای نسبی از \[dq]drive:\[dq] باشند.
.PP
در مثال دوم، یک میان‌بر از \[dq]source_item\[dq] به صورت نسبی به \[dq]drive:\[dq] به \[dq]destination_shortcut\[dq] به صورت نسبی به \[dq]drive2:\[dq] ایجاد می‌شود.
اگر کاربری که با \[dq]drive2:\[dq] احراز هویت شده اجازه خواندن فایل‌ها از \[dq]drive:\[dq] را نداشته باشد، این دستور ممکن است با خطای دسترسی شکست بخورد.
.PP
گزینه‌ها:
.IP \[bu] 2
\[dq]target\[dq]: ریموت مقصد اختیاری برای ایجاد میان‌بر در آن..SS drives
.PP
فهرست کردن درایوهای اشتراکی (Shared Drives) موجود برای این حساب کاربری.
.IP
.nf
\f[C]
rclone backend drives remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور درایوهای اشتراکی (Team Drives) موجود برای این حساب کاربری را فهرست می‌کند.
.PP
مثال استفاده:
.IP
.nf
\f[C]
rclone backend [-o config] drives drive:
\f[R]
.fi
.PP
این دستور فهرستی از اشیاء به قالب JSON شبیه به این بازمی‌گرداند:
.IP
.nf
\f[C]
[
    {
        \[dq]id\[dq]: \[dq]0ABCDEF-01234567890\[dq],
        \[dq]kind\[dq]: \[dq]drive#teamDrive\[dq],
        \[dq]name\[dq]: \[dq]My Drive\[dq]
    },
    {
        \[dq]id\[dq]: \[dq]0ABCDEFabcdefghijkl\[dq],
        \[dq]kind\[dq]: \[dq]drive#teamDrive\[dq],
        \[dq]name\[dq]: \[dq]Test Drive\[dq]
    }
]
\f[R]
.fi
.PP
با پارامتر \-o config، خروجی به قالبی مناسب برای افزودن به یک فایل پیکربندی تولید می‌شود تا برای تمام درایوهای پیداشده نام‌های مستعار (alias) و یک درایو ترکیبی بسازد.
.IP
.nf
\f[C]
[My Drive]
type = alias
remote = drive,team_drive=0ABCDEF-01234567890,root_folder_id=:

[Test Drive]
type = alias
remote = drive,team_drive=0ABCDEFabcdefghijkl,root_folder_id=:

[AllDrives]
type = combine
upstreams = \[dq]My Drive=My Drive:\[dq] \[dq]Test Drive=Test Drive:\[dq]
\f[R]
.fi
.PP
افزودن این موارد به فایل پیکربندی rclone باعث می‌شود درایوهای تیمی ذکرشده با نام‌های مستعار نمایش‌داده‌شده قابل دسترس باشند.
هر نویسه غیرمجاز با \[dq]_\[dq] جایگزین می‌شود و به نام‌های تکراری شماره پسوند اضافه خواهد شد.
این کار همچنین یک ریموت به نام AllDrives اضافه می‌کند که تمام درایوهای اشتراکی را به صورت ترکیب‌شده در یک درخت دایرکتوری نمایش می‌دهد.
.SS untrash
.PP
بازیابی فایل‌ها و دایرکتوری‌ها از سطل زباله.
.IP
.nf
\f[C]
rclone backend untrash remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور تمام فایل‌ها و دایرکتوری‌های موجود در دایرکتوری ارائه‌شده را به صورت بازگشتی از سطل زباله بازیابی می‌کند.
.PP
مثال استفاده:
.IP
.nf
\f[C]
rclone backend untrash drive:directory
rclone backend --interactive untrash drive:directory subdir
\f[R]
.fi
.PP
این دستور یک دایرکتوری اختیاری برای بازیابی دریافت می‌کند که استفاده از آن را از طریق API آسان‌تر می‌سازد.
.PP
از پرچم‌های \-\-interactive/\-i یا \-\-dry\-run برای مشاهده آنچه بازیابی خواهد شد، پیش از اجرای واقعی، استفاده کنید.
.PP
نتیجه:
.IP
.nf
\f[C]
{
    \[dq]Untrashed\[dq]: 17,
    \[dq]Errors\[dq]: 0
}
\f[R]
.fi.SS copyid
.PP
کپی فایل‌ها بر اساس شناسه (ID).
.IP
.nf
\f[C]
rclone backend copyid remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور فایل‌ها را بر اساس شناسه (ID) کپی می‌کند.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend copyid drive: ID path
rclone backend copyid drive: ID1 path1 ID2 path2
\f[R]
.fi
.PP
این دستور، فایل drive با شناسه ارائه‌شده را به مسیر مشخص‌شده (یک مسیر rclone که درون برنامه به rclone copyto فرستاده می‌شود) کپی می‌کند.
جفت‌های شناسه (ID) و مسیر می‌توانند تکرار شوند.
.PP
مسیر باید به یک / ختم شود تا نشان دهد فایل با همان نام فعلی در این دایرکتوری کپی شود.
اگر به / ختم نشود، آخرین بخش مسیر به عنوان نام فایل استفاده خواهد شد.
.PP
اگر مقصد یک backend از نوع drive باشد، در صورت امکان کپی سمت سرور (server-side copying) انجام خواهد شد.
.PP
پیش از اقدام به کپی، از پرچم‌های --interactive/-i یا --dry-run برای مشاهده آنچه کپی خواهد شد استفاده کنید.
.SS moveid
.PP
انتقال فایل‌ها بر اساس شناسه (ID).
.IP
.nf
\f[C]
rclone backend moveid remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور فایل‌ها را بر اساس شناسه (ID) منتقل می‌کند.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend moveid drive: ID path
rclone backend moveid drive: ID1 path1 ID2 path2
\f[R]
.fi
.PP
این دستور، فایل drive با شناسه ارائه‌شده را به مسیر مشخص‌شده (یک مسیر rclone که درون برنامه به rclone moveto فرستاده می‌شود) منتقل می‌کند.
.PP
مسیر باید به یک / ختم شود تا نشان دهد فایل با همان نام فعلی به این دایرکتوری منتقل شود.
اگر به / ختم نشود، آخرین بخش مسیر به عنوان نام فایل استفاده خواهد شد.
.PP
اگر مقصد یک backend از نوع drive باشد، در صورت امکان انتقال سمت سرور (server-side moving) انجام خواهد شد.
.PP
پیش از انتقال، از پرچم‌های --interactive/-i یا --dry-run برای مشاهده آنچه جابه‌جا خواهد شد استفاده کنید.
.SS exportformats
.PP
تخلیه (dump) قالب‌های صادرات (export) برای مقاصد اشکال‌زدایی.
.IP
.nf
\f[C]
rclone backend exportformats remote: [options] [<arguments>+]
\f[R]
.fi
.SS importformats
.PP
تخلیه (dump) قالب‌های واردات (import) برای مقاصد اشکال‌زدایی.
.IP
.nf
\f[C]
rclone backend importformats remote: [options] [<arguments>+]
\f[R]
.fi.SS query
.PP
فهرست کردن فایل‌ها با استفاده از زبان پرس‌وجوی Google Drive.
.IP
.nf
\f[C]
rclone backend query remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور فایل‌ها را بر اساس یک پرس‌وجو فهرست می‌کند.
.PP
مثال کاربرد:
.IP
.nf
\f[C]
rclone backend query drive: query
\f[R]
.fi
.PP
نحو پرس‌وجو در Google Drive Search query terms and operators (https://developers.google.com/drive/api/guides/ref-search-terms) مستند شده است.
.PP
برای مثال:
.IP
.nf
\f[C]
rclone backend query drive: \[dq]\[aq]0ABc9DEFGHIJKLMNop0QRatUVW3X\[aq] in parents and name contains \[aq]foo\[aq]\[dq]
\f[R]
.fi
.PP
اگر پرس‌وجو شامل نویسه‌های لفظی \[aq] یا \ باشد، این نویسه‌ها باید با نویسه‌های \ گریز داده (escape) شوند.
\[dq]\[aq]\[dq] به \[dq]\[aq]\[dq] و \[dq]\[dq] به
\[dq]\[rs]\[dq] تبدیل می‌شود؛ برای مثال برای مطابقت با فایلی با نام \[dq]foo \[aq]
\&.txt\[dq]:
.IP
.nf
\f[C]
rclone backend query drive: \[dq]name = \[aq]foo \[rs]\[aq] \[rs]\[rs]\[rs].txt\[aq]\[dq]
\f[R]
.fi
.PP
نتیجه یک آرایهٔ JSON از موارد منطبق است؛ برای مثال:
.IP
.nf
\f[C]
[
    {
        \[dq]createdTime\[dq]: \[dq]2017-06-29T19:58:28.537Z\[dq],
        \[dq]id\[dq]: \[dq]0AxBe_CDEF4zkGHI4d0FjYko2QkD\[dq],
        \[dq]md5Checksum\[dq]: \[dq]68518d16be0c6fbfab918be61d658032\[dq],
        \[dq]mimeType\[dq]: \[dq]text/plain\[dq],
        \[dq]modifiedTime\[dq]: \[dq]2024-02-02T10:40:02.874Z\[dq],
        \[dq]name\[dq]: \[dq]foo \[aq] \[rs]\[rs].txt\[dq],
        \[dq]parents\[dq]: [
            \[dq]0BxAe_BCDE4zkFGZpcWJGek0xbzC\[dq]
        ],
        \[dq]resourceKey\[dq]: \[dq]0-ABCDEFGHIXJQpIGqBJq3MC\[dq],
        \[dq]sha1Checksum\[dq]: \[dq]8f284fa768bfb4e45d076a579ab3905ab6bfa893\[dq],
        \[dq]size\[dq]: \[dq]311\[dq],
        \[dq]webViewLink\[dq]: \[dq]https://drive.google.com/file/d/0AxBe_CDEF4zkGHI4d0FjYko2QkD/view?usp=drivesdk\[rs]u0026resourcekey=0-ABCDEFGHIXJQpIGqBJq3MC\[dq]
    }
]
\[ga]\[ga]\[ga]console

### rescue

Rescue or delete any orphaned files.

\[ga]\[ga]\[ga]console
rclone backend rescue remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور هرگونه فایل یا دایرکتوری یتیم (orphaned) را نجات داده یا حذف می‌کند.
.PP
گاهی ممکن است فایل‌ها در Google Drive یتیم شوند.
این بدان معناست که آن‌ها دیگر در هیچ پوشه‌ای در Google Drive قرار ندارند.
.PP
این دستور آن فایل‌ها را یافته و یا به دایرکتوری مشخص‌شده توسط شما نجات می‌دهد (منتقل می‌کند) یا آن‌ها را حذف می‌نماید.
.PP
این دستور به ۳ روش قابل استفاده است.
.PP
نخست، فهرست کردن تمام فایل‌های یتیم:
.IP
.nf
\f[C]
rclone backend rescue drive:
\f[R]
.fi
.PP
دوم، نجات دادن تمام فایل‌های یتیم به دایرکتوری مشخص‌شده:
.IP
.nf
\f[C]
rclone backend rescue drive: \[dq]relative/path/to/rescue/directory\[dq]
\f[R]
.fi
.PP
برای مثال، جهت نجات تمام فایل‌های یتیم به دایرکتوری‌ای به نام \[dq]Orphans\[dq] در بالاترین سطح:
.IP
.nf
\f[C]
rclone backend rescue drive: Orphans
\f[R]
.fi
.PP
سوم، حذف تمام فایل‌های یتیم و فرستادن به سطل زباله:
.IP
.nf
\f[C]
rclone backend rescue drive: -o delete
\f[R]
.fi.SS محدودیت‌ها (Limitations)
.PP
سرویس Drive دارای محدودیت‌های نرخ تبادل (rate limiting) نسبتاً زیادی است.
این امر باعث می‌شود rclone تنها به انتقال حدود ۲ فایل در هر ثانیه محدود شود.
فایل‌های تکی ممکن است بسیار سریع‌تر و با سرعت‌های صدها مگابایت بر ثانیه (MiB/s) انتقال یابند، اما انتقال تعداد زیادی فایل کوچک ممکن است زمان زیادی ببرد.
.PP
کپی‌های سمت سرور (Server-side copies) نیز مشمول محدودیت نرخ جداگانه‌ای هستند.
اگر با خطاهای «User rate limit exceeded» مواجه شدید، دست‌کم ۲۴ ساعت صبر کرده و دوباره تلاش کنید.
اگر ترجیح می‌دهید، می‌توانید با استفاده از \f[V]--disable copy\f[R] کپی‌های سمت سرور را غیرفعال کنید تا فایل‌ها به جای کپی مستقیم، دانلود و سپس آپلود شوند.
.SS محدودیت‌های Google Docs
.PP
اسناد Google Docs در دستوراتی مانند \f[V]rclone ls\f[R]، \f[V]rclone ncdu\f[R] و غیره با اندازهٔ \-1 و در هر ابزاری که از لایهٔ VFS استفاده می‌کند، مانند \f[V]rclone mount\f[R] و \f[V]rclone serve\f[R]، با اندازهٔ 0 نمایش داده می‌شوند.
هنگام محاسبهٔ مجموع مقادیر دایرکتوری، برای نمونه در \f[V]rclone size\f[R] و \f[V]rclone ncdu\f[R]، آن‌ها به عنوان فایل‌های خالی به شمار می‌آیند.
.PP
این موضوع به این دلیل است که rclone نمی‌تواند اندازهٔ اسناد Google Docs را بدون دانلود کردن آن‌ها تشخیص دهد.
.PP
اسناد Google Docs با دستورات \f[V]rclone sync\f[R]، \f[V]rclone copy\f[R] و غیره به درستی انتقال می‌یابند، چرا که rclone می‌داند هنگام انتقال باید اندازهٔ آن‌ها را نادیده بگیرد.
.PP
با این حال یک پیامد نامطلوب این امر آن است که ممکن است نتوانید اسناد Google Docs را با استفاده از \f[V]rclone mount\f[R] دانلود کنید.
اگر این کار ناموفق باشد، فایلی با اندازهٔ 0 دریافت خواهید کرد.
اگر دوباره تلاش کنید، ممکن است سند اندازهٔ صحیح خود را به دست آورده و قابل دانلود شود.
اینکه این فرایند کار کند یا خیر، به برنامه‌ای که به نقطهٔ اتصال (mount) دسترسی پیدا می‌کند و سیستم‌عامل در حال اجرای شما بستگی دارد \- آزمایش کنید تا ببینید آیا برای شما کار می‌کند یا خیر!
.SS فایل‌های تکراری
.PP
گاهی اوقات، بدون دلیلی که تاکنون قابل ردیابی باشد، Drive فایلی را که rclone آپلود می‌کند تکراری می‌کند.
برخلاف سایر ریموت‌ها، Drive می‌تواند فایل‌های تکراری با نام یکسان داشته باشد.
.PP
فایل‌های تکراری در فرایند همگام‌سازی اختلال ایجاد می‌کنند و پیام‌هایی دربارهٔ موارد تکراری در لاگ مشاهده خواهید کرد.
.PP
برای برطرف کردن فایل‌های تکراری از دستور \f[V]rclone dedupe\f[R] استفاده کنید.
.PP
توجه داشته باشید که این مشکل صرفاً مربوط به rclone نیست؛ حتی Google Photos در Android نیز گاهی اوقات فایل‌ها را در Drive تکراری می‌سازد.
.SS به نظر می‌رسد rclone در حال کپی مجدد فایل‌هایی است که نباید کپی شوند
.PP
محتمل‌ترین علت این مسئله، مشکل فایل‌های تکراری ذکر شده در بالا است \- دستور \f[V]rclone dedupe\f[R] را اجرا کرده و لاگ‌های خود را برای یافتن پیام‌های مربوط به اشیاء یا دایرکتوری‌های تکراری بررسی کنید.
.PP
این مورد همچنین می‌تواند ناشی از تأخیر یا کش شدن داده‌ها در سمت Google Drive هنگام مقایسهٔ فهرست دایرکتوری‌ها باشد؛ به‌ویژه در درایوهای تیمی (Team Drives) که در ترکیب با گزینهٔ --fast-list استفاده می‌شوند.
فایل‌هایی که اخیراً آپلود شده‌اند ممکن است هنگام استفاده از --fast-list در فهرست دایرکتوری ارسالی به rclone ظاهر نشوند.
.PP
صبر کردن به مدت زمانی معقول بین تلاش‌ها (تقریباً حدود ۱ ساعت برآورد می‌شود) و/یا عدم استفاده از گزینهٔ --fast-list، هر دو در پیشگیری از بروز این مشکل مؤثر خواهند بود.
.SS احتمال در دسترس نبودن درهم‌سازهای SHA1 یا SHA256
.PP
تمام فایل‌ها دارای درهم‌سازهای MD5 هستند، اما بخش کوچکی از فایل‌های آپلود شده ممکن است فاقد درهم‌سازهای SHA1 یا SHA256 باشند، به‌ویژه اگر پیش از سال ۲۰۱۸ آپلود شده باشند.
.SS ساخت client_id اختصاصی خود
.PP
هنگامی که از rclone با Google Drive در پیکربندی پیش‌فرض استفاده می‌کنید، در واقع از client_id برنامهٔ rclone بهره می‌برید.
این شناسه میان تمام کاربران rclone به اشتراک گذاشته شده است.
.PP
\f[B]این client_id اشتراکی در حال کنار گذاشته شدن است و در طول سال ۲۰۲۶ از کار خواهد افتاد.\f[R] برای جلوگیری از اختلال در دسترسی، باید client_id اختصاصی خود را بسازید و استفاده کنید؛ بنابراین ایجاد آن اکنون اجباری است و صرفاً یک پیشنهاد محسوب نمی‌شود.
ریموت‌های جدیدی که با \f[V]rclone config\f[R] ساخته می‌شوند، در صورت خالی گذاشتن client_id به شما هشدار خواهند داد.
.PP
استفاده از client_id اختصاصی مزایای دیگری نیز دارد.
یک محدودیت سراسری برای تعداد پرس‌وجوهای مجاز در هر ثانیه برای هر client_id از سوی گوگل تعیین شده است.
اگر چندین سرویس فعال دارید، توصیه می‌شود برای هر سرویس از یک کلید API مجزا استفاده کنید.
سهمیهٔ پیش‌فرض گوگل ۱۰ تراکنش در ثانیه است؛ بنابراین توصیه می‌شود زیر این حد باقی بمانید، زیرا درخواست‌های بیشتر باعث اعمال محدودیت نرخ روی rclone و در نتیجه کندی عملکرد خواهد شد.
.PP
دستورالعمل ساخت Google Drive client ID برای rclone:
.IP " 1." 4
با حساب گوگل خود وارد Google API Console (https://console.developers.google.com) شوید.
فرقی نمی‌کند از چه حساب گوگلی استفاده می‌کنید.
(نیازی نیست حتماً همان حسابی باشد که قصد دسترسی به Google Drive آن را دارید)
.IP " 2." 4
یک پروژه را انتخاب کرده یا پروژه‌ای جدید بسازید.
.IP " 3." 4
در بخش \[dq]ENABLE APIS AND SERVICES\[dq] عبارت \[dq]Drive\[dq] را جستجو کرده و \[dq]Google Drive API\[dq] را فعال (enable) کنید.
.IP " 4." 4
روی \[dq]Credentials\[dq] در پنل سمت چپ کلیک کنید (نه روی \[dq]Create credentials\[dq] که ویزارد را باز می‌کند).
.IP " 5." 4
اگر از قبل یک \[dq]Oauth Consent Screen\[dq] پیکربندی کرده‌اید، به مرحلهٔ بعد بروید؛ در غیر این صورت، روی دکمهٔ \[dq]CONFIGURE CONSENT SCREEN\[dq] (نزدیک گوشهٔ بالا سمت راست در پنل سمت راست) کلیک کرده و سپس روی \[dq]Get started\[dq] کلیک کنید.
در صفحهٔ بعد، یک \[dq]Application name\[dq] وارد کنید (وارد کردن \[dq]rclone\[dq] کافی است)؛ یک \[dq]User Support Email\[dq] وارد نمایید (ایمیل شخصی خودتان مناسب است)؛ سپس در بخش Audience گزینهٔ \[dq]External\[dq] را انتخاب کنید.
در ادامه اطلاعات تماس خود را وارد کرده، شرایط را بپذیرید و روی \[dq]Create\[dq] کلیک کنید.
اکنون باید rclone (یا نام پروژهٔ خود) را در کادری در بالا سمت چپ صفحه ببینید.
.RS 4
.PP
(نکته: اگر کاربر GSuite هستید، می‌توانید در مرحلهٔ بالا به جای \[dq]External\[dq] گزینهٔ \[dq]Internal\[dq] را انتخاب کنید، اما این کار دسترسی API را صرفاً به کاربران Google Workspace در سازمان شما محدود می‌کند).
.PP
همچنین باید دامنه‌های دسترسی (scopes) مورد نیاز را اضافه کنید (https://developers.google.com/drive/api/guides/api-specific-auth)، شامل:
.IP \[bu] 2
\f[V]https://www.googleapis.com/auth/docs\f[R]
.IP \[bu] 2
\f[V]https://www.googleapis.com/auth/drive\f[R] به منظور امکان ویرایش، ساخت و حذف فایل‌ها با rclone.
.IP \[bu] 2
\f[V]https://www.googleapis.com/auth/drive.metadata.readonly\f[R] که ممکن است افزودن آن نیز لازم باشد.
.PP
برای انجام این کار، روی Data Access در پنل سمت چپ کلیک کنید، روی \[dq]add or remove scopes\[dq] کلیک نموده، سه مورد فوق را برگزینید و update را بزنید؛ یا به کادر متنی \[dq]Manually add scopes\[dq] (در پایین صفحه) مراجعه کرده و عبارت
\[dq]https://www.googleapis.com/auth/docs,https://www.googleapis.com/auth/drive,https://www.googleapis.com/auth/drive.metadata.readonly\[dq]
را وارد کنید، روی add to table و سپس update کلیک نمایید.
.PP
اکنون باید هر سه دامنهٔ دسترسی (scope) را در صفحهٔ Data access مشاهده کنید.
حال روی save در پایین صفحه کلیک کنید!
.RE
.IP " 6." 4
پس از افزودن scopeها، روی Audience کلیک کنید.
به پایین صفحه رفته و روی \[dq]+ Add users\[dq] کلیک کنید.
خود را به عنوان یک کاربر آزمایشی (test user) اضافه کرده و save را بزنید.
.IP " 7." 4
به بخش Overview در پنل سمت چپ بروید و روی \[dq]Create OAuth client\[dq] کلیک کنید.
نوع برنامه (application type) را \[dq]Desktop app\[dq] انتخاب کرده و روی \[dq]Create\[dq] کلیک کنید.
(نام پیش‌فرض انتخابی مناسب است)
.IP " 8." 4
شناسهٔ client ID و رمز client secret به شما نشان داده خواهد شد.
این مقادیر را یادداشت کنید.
(اگر در مرحلهٔ ۵ گزینهٔ \[dq]External\[dq] را انتخاب کردید، به مرحلهٔ ۹ بروید.
اگر گزینهٔ \[dq]Internal\[dq] را انتخاب کردید نیازی به انتشار نیست و می‌توانید مستقیماً به مرحلهٔ ۱۰ بروید، اما درایو مقصد شما باید عضوی از همان Google Workspace باشد.)
.IP " 9." 4
به بخش \[dq]Audience\[dq] رفته و سپس روی دکمهٔ \[dq]PUBLISH APP\[dq] کلیک کرده و آن را تأیید کنید.
اگر تاکنون خود را به عنوان کاربر آزمایشی اضافه نکرده‌اید، اکنون این کار را انجام دهید.
.IP "10." 4
شناسه‌های client ID و client secret یادداشت‌شده را به rclone ارائه دهید.
.IP "11." 4
فرآیند احراز هویت تحت وب را از داخل دستور \f[V]rclone config\f[R] اجرا کنید؛ هنگامی که پیام \[dq]Token already configured \- replace it?\[dq] نمایش داده شد، با وارد کردن \[dq]Y\[dq] آن را تأیید نمایید.
.PP
توجه داشته باشید که به دلیل اقدامات اخیر گوگل در خصوص «ارتقای امنیت» (enhanced security)، از نظر تئوری ملزم به ثبت برنامه برای بررسی (\[dq]submit your app for verification\[dq]) و انتظار چند هفته‌ای(!) برای تأیید آن‌ها هستید؛ در عمل، می‌توانید مستقیماً ادامه داده و از client ID و client secret در rclone استفاده کنید. تنها نکته، نمایش یک صفحهٔ هشدار امنیتی هنگام اتصال از طریق مرورگر خواهد بود تا rclone بتواند token-id خود را دریافت کند (اما چون این مرحله فقط یک بار در زمان پیکربندی ریموت انجام می‌شود، چندان نگران‌کننده نیست).
نگه‌داشتن برنامه در وضعیت آزمایشی (\[dq]Testing\[dq]) نیز کارساز است، اما محدودیت آن این است که دسترسی‌های اعطا شده پس از یک هفته منقضی می‌شوند و نیاز مداوم به تمدید آن‌ها ممکن است خسته‌کننده باشد.
اگر به هر دلیلی انقضای هفتگی برای شما مشکلی به وجود نمی‌آورد، نگه‌داشتن برنامه در حالت testing نیز کاملاً کافی خواهد بود..PP
در بیشتر موارد اعتبارسنجی در واقع الزامی نیست.
Google تعدادی از دسته‌بندی‌های برنامه (https://support.google.com/cloud/answer/13464323) را از اعتبارسنجی اجباری معاف می‌کند، از جمله:
.IP \[bu] 2
\f[B]برنامه‌های استفاده شخصی (Personal Use apps)\f[R]: اگر برنامه برای استفاده شخصی شما باشد (کمتر از ۱۰۰ کاربر)، شما و تعداد محدود کاربرانتان می‌توانید بدون نیاز به اعتبارسنجی به استفاده از آن ادامه دهید \- فقط کافیست در هنگام ورود، از صفحه هشدار \[dq]unverified app\[dq] عبور کنید.
اعتبارسنجی تنها در صورتی لازم است که بخواهید تعداد کاربران خود را به بیش از ۱۰۰ کاربر افزایش دهید.
.IP \[bu] 2
\f[B]برنامه‌های توسعه/آزمایش/مرحله‌بندی (Development/Testing/Staging apps)\f[R]: برنامه‌ها در حالت توسعه، آزمایش یا مرحله‌بندی مشمول اعتبارسنجی نمی‌شوند (اما تا زمان تأیید، به سقف ۱۰۰ کاربر و نمایش هشدار برنامه تأییدنشده محدود هستند).
.PP
بنابراین برای استفاده معمول و شخصی rclone، می‌توانید برنامه را تأییدنشده باقی بگذارید، صفحه هشدار را بپذیرید، و آن را منتشر (publish) کنید (به‌جای رها کردن آن در وضعیت \[dq]Testing\[dq]) تا از انقضای هفتگی مجوز که در بالا توضیح داده شد جلوگیری شود.
.PP
(با تشکر از \[at]balazer در github برای این دستورالعمل‌ها.)
.PP
گاهی اوقات، ایجاد رضایت‌نامه OAuth در Google API Console با خطای \[dq]The request failed because changes to one of the field of the resource is not supported\[dq] مواجه می‌شود.
به‌عنوان یک راهکار جایگزین و آسان، کلید Google Drive API مورد نیاز می‌تواند در صفحه
Python Quickstart (https://developers.google.com/drive/api/v3/quickstart/python)
ایجاد شود.
تنها کافی است دکمه Enable the Drive API را فشار دهید تا Client ID و Secret را دریافت کنید.
توجه داشته باشید که این کار به‌طور خودکار یک پروژه جدید در API Console ایجاد می‌کند.
.SH "Google Photos"
.PP
بک‌اند rclone برای Google
Photos (https://www.google.com/photos/about) یک بک‌اند تخصصی
برای انتقال عکس‌ها و ویدیوها به و از Google Photos است.
.PP
\f[B]توجه:\f[R] رابط برنامه‌نویسی کاربردی Google Photos API که rclone از آن استفاده می‌کند، دارای محدودیت‌های متعددی است، بنابراین لطفاً بخش محدودیت‌ها را به دقت مطالعه کنید تا مطمئن شوید برای استفاده شما مناسب است.
.PP
\f[B]توجه:\f[R] از ۳۱ مارس ۲۰۲۵، rclone تنها می‌تواند عکس‌هایی را دانلود کند که خودش بارگذاری کرده باشد.
این محدودیت به دلیل تغییرات خط‌مشی‌های Google است.
ممکن است لازم باشد پس از ارتقا به rclone v1.70، دستور \f[V]rclone config reconnect remote:\f[R] را اجرا کنید تا rclone مجدداً به درستی کار کند.
.SS "پیکربندی (Configuration)"
.PP
راه‌اندازی اولیه برای Google Cloud Storage شامل دریافت یک توکن از
Google Photos است که باید آن را در مرورگر وب خود انجام دهید.
دستور \f[V]rclone config\f[R] شما را در این مراحل راهنمایی می‌کند.
.PP
در اینجا یک مثال از نحوه ایجاد یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این کار شما را در یک فرآیند راه‌اندازی تعاملی راهنمایی خواهد کرد:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / Google Photos
   \[rs] \[dq]google photos\[dq]
[snip]
Storage> google photos
** See help for google photos backend at: https://rclone.org/googlephotos **

OAuth Client Id.
Creating your own is now strongly recommended.
If you leave this blank rclone uses a shared client_id which is being retired and will stop working during 2026.
See https://rclone.org/googlephotos/#making-your-own-client-id for how to create your own.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
client_id> 
OAuth Client Secret.
Leave blank to use rclone\[aq]s shared client_id.
If you created your own client_id then enter its client secret here.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
client_secret> 
Set to make the Google Photos backend read only.

If you choose read only then rclone will only request read only access
to your photos, otherwise rclone will request full access.
Enter a boolean value (true or false). Press Enter for the default (\[dq]false\[dq]).
read_only> 
Edit advanced config? (y/n)
y) Yes
n) No
y/n> n
Remote config
rclone\[aq]s shared Google Photos client_id is being retired and will stop working during 2026.
Create your own to avoid interruption: https://rclone.org/googlephotos/#making-your-own-client-id

Continue using the shared client_id anyway?
y) Yes
n) No (default)
y/n> n
OAuth Client Id.
client_id> 1234567890-abcdefghijklmnop.apps.googleusercontent.com
OAuth Client Secret.
client_secret> GOCSPX-your-client-secret
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y) Yes
n) No
y/n> y
If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth
Log in and authorize rclone for access
Waiting for code...
Got code

*** IMPORTANT: All media items uploaded to Google Photos with rclone
*** are stored in full resolution at original quality.  These uploads
*** will count towards storage in your Google Account.

Configuration complete.
Options:
- type: google photos
- token: {\[dq]access_token\[dq]:\[dq]XXX\[dq],\[dq]token_type\[dq]:\[dq]Bearer\[dq],\[dq]refresh_token\[dq]:\[dq]XXX\[dq],\[dq]expiry\[dq]:\[dq]2019-06-28T17:38:04.644930156+01:00\[dq]}
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
برای اطلاع از نحوه راه‌اندازی روی دستگاهی که فاقد مرورگر وب متصل به اینترنت
است، مستندات راه‌اندازی ریموت (https://rclone.org/remote_setup) را
مشاهده کنید.
.PP
توجه داشته باشید در صورت استفاده از مرورگر وب برای احراز هویت خودکار،
rclone یک وب‌سرور روی ماشین محلی شما اجرا می‌کند تا توکن بازگردانده شده از Google را دریافت کند.
این وب‌سرور تنها از لحظه باز کردن مرورگر تا لحظه دریافت کد اعتبارسنجی اجرا می‌شود.
این سرویس روی \f[V]http://127.0.0.1:53682\f[R] فعال است و در صورتی که فایروال میزبان فعال باشد ممکن است نیاز به رفع انسداد موقت آن داشته باشید، یا از حالت دستی استفاده کنید.
.PP
این ریموت \f[V]remote\f[R] نامیده می‌شود و اکنون می‌تواند به این صورت مورد استفاده قرار گیرد
.PP
مشاهده تمام آلبوم‌ها در تصاویر شما
.IP
.nf
\f[C]
rclone lsd remote:album
\f[R]
.fi
.PP
ساخت یک آلبوم جدید
.IP
.nf
\f[C]
rclone mkdir remote:album/newAlbum
\f[R]
.fi
.PP
فهرست کردن محتویات یک آلبوم
.IP
.nf
\f[C]
rclone ls remote:album/newAlbum
\f[R]
.fi.PP
همگام‌سازی \f[V]/home/local/images\f[R] با Google Photos، همراه با حذف هرگونه فایل اضافی در آلبوم.
.IP
.nf
\f[C]
rclone sync --interactive /home/local/image remote:album/newAlbum
\f[R]
.fi
.SS "ساختار (Layout)"
.PP
از آن‌جا که Google Photos یک سامانه ذخیره‌سازی ابری همه‌منظوره نیست، پشتانه (backend) به‌گونه‌ای سازمان‌دهی شده است که به پیمایش آن توسط شما کمک کند.
.PP
پوشه‌های زیر \f[V]media\f[R] روش‌های متفاوتی برای دسته‌بندی رسانه‌ها را نشان می‌دهند.
هر فایل چندین بار ظاهر خواهد شد.
بنابراین اگر می‌خواهید از Google Photos خود نسخه پشتیبان تهیه کنید، می‌توانید از \f[V]remote:media/by-month\f[R] پشتیبان بگیرید.
(\f[B]نکته:\f[R] \f[V]remote:media/by-day\f[R] در حال حاضر بسیار کُند است، بنابراین از آن برای همگام‌سازی اجتناب کنید.)
.PP
توجه داشته باشید که تمام عکس‌ها و ویدیوهای شما در جایی زیر \f[V]media\f[R] ظاهر می‌شوند، اما ممکن است زیر \f[V]album\f[R] نمایش داده نشوند مگر اینکه آن‌ها را در آلبوم‌ها قرار داده باشید.
.IP
.nf
\f[C]
/
- upload
    - file1.jpg
    - file2.jpg
    - ...
- media
    - all
        - file1.jpg
        - file2.jpg
        - ...
    - by-year
        - 2000
            - file1.jpg
            - ...
        - 2001
            - file2.jpg
            - ...
        - ...
    - by-month
        - 2000
            - 2000-01
                - file1.jpg
                - ...
            - 2000-02
                - file2.jpg
                - ...
        - ...
    - by-day
        - 2000
            - 2000-01-01
                - file1.jpg
                - ...
            - 2000-01-02
                - file2.jpg
                - ...
        - ...
- album
    - album name
    - album name/sub
- shared-album
    - album name
    - album name/sub
- feature
    - favorites
        - file1.jpg
        - file2.jpg
\f[R]
.fi
.PP
دو بخش قابل‌نوشتن در این درخت وجود دارد: پوشه \f[V]upload\f[R] و زیرپوشه‌های پوشه \f[V]album\f[R].
.PP
پوشه \f[V]upload\f[R] برای بارگذاری فایل‌هایی است که نمی‌خواهید در آلبوم‌ها قرار گیرند.
این پوشه در ابتدا خالی خواهد بود و فایل‌هایی را که بارگذاری کرده‌اید تنها برای یک نشست rclone نگه می‌دارد، و با راه‌اندازی دوباره rclone مجدداً خالی می‌شود.
کاربرد این بخش برای زمانی است که حجم زیادی از فایل‌ها را در اختیار دارید و فقط می‌خواهید یک‌بار آن‌ها را به Google Photos منتقل کنید.
برای همگام‌سازی مکرر، بارگذاری در \f[V]album\f[R] عملکرد بهتری خواهد داشت.
.PP
پوشه‌های درون پوشه \f[V]album\f[R] نیز قابل‌نوشتن هستند و می‌توانید پوشه‌های (آلبوم‌های) جدیدی زیر \f[V]album\f[R] ایجاد کنید.
اگر فایل‌ها را به همراه یک سلسله‌مراتب پوشه‌ای در آن کپی کنید، rclone آلبوم‌هایی حاوی نویسه \f[V]/\f[R] در نامشان ایجاد خواهد کرد.
به عنوان مثال اگر دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone copy /path/to/images remote:album/images
\f[R]
.fi
.PP
و پوشه images شامل موارد زیر باشد:
.IP
.nf
\f[C]
images
    - file1.jpg
    dir
        file2.jpg
    dir2
        dir3
            file3.jpg
\f[R]
.fi
.PP
آنگاه rclone آلبوم‌های زیر را به همراه فایل‌های مربوطه ایجاد خواهد کرد:
.IP \[bu] 2
images
.RS 2
.IP \[bu] 2
file1.jpg
.RE
.IP \[bu] 2
images/dir
.RS 2
.IP \[bu] 2
file2.jpg
.RE
.IP \[bu] 2
images/dir2/dir3
.RS 2
.IP \[bu] 2
file3.jpg
.RE
.PP
این بدان معناست که می‌توانید از مسیر \f[V]album\f[R] تقریباً مانند یک سامانه فایل عادی استفاده کنید و این مسیر مقصد مناسبی برای همگام‌سازی مکرر است.
.PP
پوشه \f[V]shared-album\f[R] آلبوم‌های به‌اشتراک‌گذاشته‌شده با شما یا توسط شما را نشان می‌دهد.
این بخش مشابه برگه Sharing در رابط کاربری وب Google Photos است..SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص به google photos (Google Photos) آورده شده است.
.SS --gphotos-client-id
.PP
شناسه کلاینت OAuth (OAuth Client Id).
.PP
ساخت شناسه اختصاصی اکنون اکیداً توصیه می‌شود.
اگر این فیلد را خالی بگذارید، rclone از یک client_id اشتراکی استفاده می‌کند که در حال بازنشستگی است و در طول سال ۲۰۲۶ از کار خواهد افتاد.
برای نحوه ساخت شناسه اختصاصی خود، به https://rclone.org/googlephotos/#making-your-own-client-id مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --gphotos-client-secret
.PP
رمز کلاینت OAuth (OAuth Client Secret).
.PP
برای استفاده از client_id اشتراکی rclone، این مقدار را خالی بگذارید.
اگر client_id اختصاصی خود را ساخته‌اید، رمز کلاینت (client secret) آن را در اینجا وارد کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --gphotos-read-only
.PP
تنظیم برای فقط‌خواندنی کردن backend مربوط به Google Photos.
.PP
اگر حالت فقط‌خواندنی را انتخاب کنید، rclone فقط دسترسی فقط‌خواندنی به عکس‌های شما را درخواست می‌کند؛ در غیر این صورت، rclone درخواست دسترسی کامل خواهد داشت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: read_only
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_READ_ONLY
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مختص به google photos (Google Photos) آورده شده است.
.SS --gphotos-token
.PP
توکن دسترسی OAuth به‌صورت یک JSON blob.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --gphotos-auth-url
.PP
نشانی URL سرور احراز هویت (Auth server).
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، این فیلد را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false.SS --gphotos-token-url
.PP
آدرس URL سرور توکن (Token).
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، این مقدار را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --gphotos-client-credentials
.PP
استفاده از جریان OAuth اعتبارسنجی کلاینت (Client Credentials).
.PP
این گزینه از جریان Client Credentials در OAUTH2 همان‌طور که در RFC
6749 توصیف شده است، استفاده می‌کند.
.PP
توجه داشته باشید که این گزینه توسط همهٔ backendها پشتیبانی نمیشود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --gphotos-read-size
.PP
تنظیم برای خواندن اندازهٔ آیتم‌های رسانه‌ای.
.PP
به‌طور معمول rclone اندازهٔ آیتم‌های رسانه‌ای را نمی‌خواند زیرا این کار نیازمند
یک تراکنش اضافی است.
این مورد برای همگام‌سازی (syncing) ضروری نیست.
با این حال rclone mount نیاز دارد که پیش از خواندن فایل‌ها از اندازهٔ آن‌ها مطلع
باشد، بنابراین در صورتی که قصد خواندن رسانه‌ها را دارید، تنظیم این پرچم هنگام استفاده
از rclone mount توصیه می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: read_size
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_READ_SIZE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --gphotos-start-year
.PP
سال؛ دانلود عکس‌ها را به مواردی محدود می‌کند که پس از سال تعیین‌شده بارگذاری
شده باشند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: start_year
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_START_YEAR
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 2000
.SS --gphotos-include-archived
.PP
مشاهده و بارگیری رسانه‌های بایگانی‌شده نیز انجام شود.
.PP
به‌طور پیش‌فرض، rclone رسانه‌های بایگانی‌شده را درخواست نمی‌کند.
بنابراین هنگام همگام‌سازی، رسانه‌های بایگانی‌شده در فهرست‌های دایرکتوری دیده
نشده و منتقل نمی‌شوند.
.PP
توجه داشته باشید که رسانه‌های موجود در آلبوم‌ها صرف‌نظر از وضعیت بایگانی‌شان،
همواره قابل مشاهده و همگام‌سازی هستند.
.PP
با فعال کردن این پرچم، رسانه‌های بایگانی‌شده همیشه در فهرست‌های دایرکتوری
دیده شده و منتقل می‌شوند.
.PP
بدون این پرچم، رسانه‌های بایگانی‌شده در فهرست‌های دایرکتوری نشان داده نخواهند شد
و منتقل نمی‌شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: include_archived
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_INCLUDE_ARCHIVED
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --gphotos-proxy
.PP
استفاده از پراکسی gphotosdl برای بارگیری تصاویر با وضوح کامل.
.PP
رابط کاربری برنامه‌نویسی گوگل (Google API) تصاویری و ویدیوهایی را ارائه می‌دهد که دارای وضوح کامل نیستند، و/یا داده‌های EXIF آن‌ها وجود ندارد.
.PP
با این حال، در صورت استفاده از پراکسی gphotosdl می‌توانید تصاویر اصلی و دست‌نخورده را بارگیری کنید.
.PP
این ابزار یک مرورگر بدون رابط کاربری گرافیکی (headless) را در پس‌زمینه اجرا می‌کند.
.PP
نرم‌افزار را از
gphotosdl (<https://github.com/rclone/gphotosdl>) بارگیری کنید.
.PP
ابتدا با دستور زیر اجرا کنید:
.IP
.nf
\f[C]
gphotosdl -login
\f[R]
.fi
.PP
سپس هنگامی که وارد google photos شدید، پنجره مرورگر را ببندید و دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
gphotosdl
\f[R]
.fi
.PP
سپس پارامتر
\f[V]--gphotos-proxy \[dq]http://localhost:8282\[dq]\f[R] را مشخص کنید تا rclone از این پراکسی استفاده کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: proxy
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_PROXY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --gphotos-encoding
.PP
کدگذاری برای بک‌اند (backend).
.PP
برای اطلاعات بیشتر بخش کدگذاری را در
نمای کلی (<https://rclone.org/overview/#encoding>) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,CrLf,InvalidUtf8,Dot
.SS --gphotos-batch-mode
.PP
دسته‌بندی بارگذاری فایل sync|async|off.
.PP
این گزینه حالت دسته‌ای استفاده‌شده توسط rclone را تنظیم می‌کند.
.PP
این گزینه ۳ مقدار ممکن دارد:
.IP \[bu] 2
off \- بدون دسته‌بندی
.IP \[bu] 2
sync \- دسته‌بندی بارگذاری‌ها و بررسی تکمیل فرایند (پیش‌فرض)
.IP \[bu] 2
async \- بارگذاری دسته‌ای بدون بررسی وضعیت تکمیل فرایند
.PP
ابزار rclone هنگام خروج، تمام دسته‌های باقی‌مانده و معلق را خواهد بست که ممکن است باعث ایجاد تأخیر در هنگام خروج شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: batch_mode
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_BATCH_MODE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]sync\[dq].SS --gphotos-batch-size
.PP
حداکثر تعداد فایل‌ها در یک دسته بارگذاری.
.PP
این گزینه اندازه دسته فایل‌ها را برای بارگذاری تعیین می‌کند.
این مقدار باید کمتر از ۵۰ باشد.
.PP
به‌طور پیش‌فرض این مقدار 0 است، به این معنی که rclone اندازه دسته را بسته به تنظیمات batch_mode محاسبه خواهد کرد.
.IP \[bu] 2
batch_mode: async \- اندازه پیش‌فرض batch_size برابر ۵۰ است
.IP \[bu] 2
batch_mode: sync \- اندازه پیش‌فرض batch_size مشابه مقدار \-\-transfers است
.IP \[bu] 2
batch_mode: off \- استفاده نمی‌شود
.PP
ابزار rclone هنگام خروج، تمام دسته‌های باقی‌مانده را خواهد بست که ممکن است باعث تاخیری در هنگام خروج شود.
.PP
اگر فایل‌های کوچک زیادی را بارگذاری می‌کنید، تنظیم این گزینه ایده بسیار خوبی است زیرا سرعت بارگذاری آن‌ها را بسیار بیشتر می‌کند.
می‌توانید برای بیشینه‌سازی توان عملیاتی از \-\-transfers 32 استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: batch_size
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_BATCH_SIZE
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 0
.SS --gphotos-batch-timeout
.PP
حداکثر زمان مجاز برای بیکار ماندن یک دسته بارگذاری پیش از ارسال.
.PP
اگر یک دسته بارگذاری بیش از این مدت بیکار بماند، بارگذاری خواهد شد.
.PP
مقدار پیش‌فرض 0 است، به این معنی که rclone یک مقدار پیش‌فرض مناسب را بر اساس batch_mode مورد استفاده انتخاب می‌کند.
.IP \[bu] 2
batch_mode: async \- مقدار پیش‌فرض batch_timeout برابر 10s است
.IP \[bu] 2
batch_mode: sync \- مقدار پیش‌فرض batch_timeout برابر 1s است
.IP \[bu] 2
batch_mode: off \- استفاده نمی‌شود
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: batch_timeout
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_BATCH_TIMEOUT
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 0s
.SS --gphotos-description
.PP
توضیحات ریموت (remote).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_GPHOTOS_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS محدودیت‌ها (Limitations)
.PP
تنها تصاویر و ویدیوها قابل بارگذاری هستند.
اگر اقدام به بارگذاری مواردی غیر از ویدیو یا تصویر، یا فرمت‌هایی کنید که Google Photos قادر به شناسایی آن‌ها نیست، rclone فایل را بارگذاری خواهد کرد، اما Google Photos هنگام تبدیل آن به یک آیتم رسانه‌ای خطا می‌دهد.
.PP
\f[B]توجه:\f[R] از ۳۱ مارس ۲۰۲۵، rclone تنها می‌تواند عکس‌هایی را که خودش بارگذاری کرده است دانلود کند.
این محدودیت به دلیل تغییرات در خط‌مشی Google اعمال شده است.
ممکن است پس از ارتقا به rclone نسخه v1.70 برای عملکرد دوباره rclone نیاز باشد دستور \f[V]rclone config reconnect remote:\f[R] را اجرا کنید.
.PP
توجه داشته باشید که تمامی آیتم‌های رسانه‌ای بارگذاری‌شده در Google Photos از طریق API با وضوح کامل و با \[dq]کیفیت اصلی\[dq] (original quality) ذخیره می‌شوند و جزو سهمیه ذخیره‌سازی در حساب Google شما \f[B]محاسبه خواهند شد\f[R].
این API روشی برای بارگذاری در حالت \[dq]کیفیت بالا\[dq] (high quality) ارائه \f[B]نمی‌دهد\f[R]..
.PP
دستور \f[V]rclone about\f[R] توسط بک‌اند Google Photos پشتیبانی نمی‌شود.
بک‌اندهای فاقد این قابلیت نمی‌توانند فضای خالی را برای یک نقطه متصل‌شده (mount) در rclone تعیین کنند یا از سیاست \f[V]mfs\f[R] (بیشترین فضای خالی) به‌عنوان عضوی از یک ریموت union در rclone استفاده نمایند.
.PP
فهرست بک‌اندهایی که از rclone about پشتیبانی نمی‌کنند را ببینید
(https://rclone.org/overview/#optional-features)
همچنین rclone about را ببینید
(https://rclone.org/commands/rclone_about).SS بارگیری تصاویر
.PP
هنگامی که تصاویر بارگیری می‌شوند، موقعیت مکانی EXIF حذف می‌گردد (مطابق با مستندات و آزمایش‌های من).
این یک محدودیت در Google Photos API است و ذیل باگ
#112096115 (https://issuetracker.google.com/issues/112096115) پوشش داده شده است.
.PP
\f[B]در حال حاضر Google API اجازه نمی‌دهد عکس‌ها با وضوح اصلی بارگیری شوند.
این نکته بسیار حائز اهمیت است اگر برای نمونه، به \[dq]Google Photos\[dq] به‌عنوان نسخه پشتیبان عکس‌هایتان تکیه کرده‌اید.
شما قادر نخواهید بود از rclone برای بارگیری مجدد تصاویر اصلی استفاده کنید.
به‌عنوان آخرین راهکار می‌توانید از \[aq]google takeout\[aq] برای بازیابی عکس‌های اصلی استفاده نمایید.\f[R]
.PP
\f[B]توجه:\f[R] شما \f[B]می‌توانید\f[R] از پرچم --gphotos-proxy برای استفاده از یک مرورگر headless جهت بارگیری تصاویر با وضوح کامل استفاده کنید.
.SS بارگیری ویدیوها
.PP
هنگامی که ویدیوها بارگیری می‌شوند، در مقایسه با بارگیری از طریق رابط وب Google Photos، در قالب نسخه‌ای بسیار فشرده‌شده از ویدیو دریافت می‌گردند.
این مورد ذیل باگ
#113672044 (https://issuetracker.google.com/issues/113672044) پوشش داده شده است.
.PP
\f[B]توجه:\f[R] شما \f[B]می‌توانید\f[R] از پرچم --gphotos-proxy برای استفاده از یک مرورگر headless جهت بارگیری تصاویر با وضوح کامل استفاده کنید.
.SS موارد تکراری
.PP
اگر نام فایلی در یک دایرکتوری تکراری باشد، rclone شناسه فایل (file ID) را به نام آن اضافه می‌کند.
بنابراین دو فایل با نام \f[V]file.jpg\f[R] به‌صورت
\f[V]file {123456}.jpg\f[R] و \f[V]file {ABCDEF}.jpg\f[R] ظاهر خواهند شد (متأسفانه شناسه‌های واقعی بسیار طولانی‌تر هستند!).
.PP
اگر یک تصویر مشابه (با داده‌های باینری یکسان) را دو بار بارگذاری کنید، Google Photos نسخه تکراری آن را حذف می‌کند (deduplicate).
با این حال، نام فایل حاصل از بارگذاری نخست را حفظ خواهد کرد که ممکن است rclone را سردرگم کند.
برای مثال، اگر تصویری را در \f[V]upload\f[R] بارگذاری کنید و سپس همان تصویر را در \f[V]album/my_album\f[R] آپلود نمایید، نام فایل تصویر در
\f[V]album/my_album\f[R] همان نامی خواهد بود که در ابتدا با آن بارگذاری شده بود،
نه نامی که با آن در \f[V]album\f[R] بارگذاری کردید.
در عمل این موضوع نباید مشکلات چندانی ایجاد کند.
.SS زمان‌های تغییر
.PP
تاریخ نمایش داده شده برای رسانه در Google Photos، تاریخ ایجاد آن است که بر اساس اطلاعات EXIF تعیین می‌شود، یا در صورتی که این اطلاعات مشخص نباشد، تاریخ بارگذاری خواهد بود.
.PP
این مورد توسط rclone قابل تغییر نیست و برابر با تاریخ تغییر رسانه روی دیسک محلی نمی‌باشد.
این بدان معناست که rclone نمی‌تواند از تاریخ‌های Google Photos برای مقاصد همگام‌سازی استفاده کند.
.SS اندازه
.PP
در Google Photos API، اندازه رسانه بازگردانده نمی‌شود.
این بدان معناست که هنگام همگام‌سازی با Google Photos، برنامه rclone تنها می‌تواند بررسی وجود فایل را انجام دهد.
.PP
خواندن اندازه رسانه امکان‌پذیر است، اما این کار نیازمند یک درخواست HTTP HEAD اضافی به‌ازای هر قلم رسانه است و بنابراین \f[B]بسیار کند\f[R] بوده و تعداد زیادی تراکنش مصرف می‌کند.
این قابلیت را می‌توان با گزینه \f[V]--gphotos-read-size\f[R] یا پارامتر پیکربندی
\f[V]read_size = true\f[R] فعال کرد.
.PP
اگر می‌خواهید از این backend همراه با \f[V]rclone mount\f[R] استفاده کنید، ممکن است لازم باشد این پرچم را فعال کنید (بسته به سیستم‌عامل شما و برنامه‌ای که از عکس‌ها استفاده می‌کند)، در غیر این صورت ممکن است نتوانید رسانه را از mount بخوانید.
باید آزمایش کنید تا ببینید آیا بدون این پرچم برای شما کار می‌کند یا خیر.
.SS آلبوم‌ها
.PP
برنامه rclone فقط می‌تواند فایل‌ها را در آلبوم‌هایی که خودش ایجاد کرده بارگذاری کند.
این یک محدودیت در Google Photos
API (https://developers.google.com/photos/library/guides/manage-albums) است.
.PP
برنامه rclone تنها می‌تواند فایل‌هایی را که خودش بارگذاری کرده از آلبوم‌هایی که خودش ایجاد کرده حذف نماید.
.SS حذف فایل‌ها
.PP
برنامه rclone می‌تواند فایل‌ها را از آلبوم‌هایی که خودش ایجاد کرده حذف کند، اما توجه داشته باشید که Google Photos API اجازه حذف دائمی رسانه‌ها را نمی‌دهد، بنابراین این رسانه‌ها همچنان باقی خواهند ماند.
باگ شماره #109759781 (https://issuetracker.google.com/issues/109759781) را ببینید.
.PP
برنامه rclone نمی‌تواند فایل‌ها را در هیچ کجایی به جز زیرمسیر \f[V]album\f[R] حذف کند..SS "حذف آلبوم‌ها"
.PP
رابط برنامه‌نویسی Google Photos API از حذف آلبوم‌ها پشتیبانی نمی‌کند \- گزارش باگ
#135714733 (<https://issuetracker.google.com/issues/135714733>) را ببینید.
.SS "ساخت client_id اختصاصی خودتان"
.PP
هنگامی که از rclone با Google photos در پیکربندی پیش‌فرض آن استفاده می‌کنید، از client_id متعلق به rclone بهره می‌برید.
این شناسه بین تمام کاربران rclone به اشتراک گذاشته شده است.
.PP
\f[B]این client_id اشتراکی در حال بازنشستگی است و در طول سال ۲۰۲۶ از کار خواهد افتاد.\f[R] برای جلوگیری از اختلال در سرویس، باید client_id اختصاصی خود را ایجاد کرده و از آن استفاده کنید؛ بنابراین ساخت آن اکنون به‌جای اختیاری بودن، الزامی است.
ریموت‌های جدید ایجادشده با \f[V]rclone config\f[R] در صورت خالی گذاشتن client_id به شما هشدار خواهند داد.
.PP
لطفاً مراحل موجود در مستندات google drive (<https://rclone.org/drive/#making-your-own-client-id>) را با اعمال تفاوت‌های زیر دنبال کنید:
.IP \[bu] 2
در مرحله‌ی ۳، به‌جای فعال‌سازی \[dq]Google Drive API\[dq]، عبارت \[dq]Photos Library API\[dq] را جستجو و فعال کنید.
.IP \[bu] 2
در مرحله‌ی ۵، باید دامنه‌های دسترسی (scopes) متفاوتی را اضافه کنید.
به‌جای موارد مربوط به drive، از این دامنه‌ها استفاده کنید:
.IP
.nf
\f[C]
https://www.googleapis.com/auth/photoslibrary.appendonly
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata
\f[R]
.fi
.SH Hasher
.PP
بک‌اند Hasher یک بک‌اند لایه‌ای (overlay) ویژه برای ساخت ریموت‌هایی است که چکسام‌ها (checksums) را برای سایر ریموت‌ها مدیریت می‌کنند.
عملکردهای اصلی آن عبارتند از:
.IP \[bu] 2
شبیه‌سازی انواع هش‌هایی که توسط بک‌اندها پیاده‌سازی نشده‌اند
.IP \[bu] 2
کَش کردن چکسام‌ها برای کمک به هش‌کردن کندِ فایل‌های محلی بزرگ یا فایل‌های (S)FTP
.IP \[bu] 2
پیش‌بارگذاری (Warm up) کَش چکسام‌ها از فایل‌های SUM خارجی
.SS "شروع به کار"
.PP
برای استفاده از Hasher، ابتدا ریموت زیرین را طبق دستورالعمل‌های پیکربندی همان ریموت راه‌اندازی کنید.
همچنین می‌توانید به‌جای یک ریموت، از یک مسیر محلی استفاده کنید.
بررسی کنید که ریموت پایه‌ی شما به‌درستی کار می‌کند.
.PP
در اینجا فرض می‌کنیم ریموت پایه را \f[V]myRemote:path\f[R] می‌نامیم.
توجه داشته باشید که هر چیزی درون \f[V]myRemote:path\f[R] باشد توسط hasher مدیریت خواهد شد و هر چه خارج از آن باشد نخواهد شد.
این بدان معناست که اگر از یک ریموت مبتنی بر باکت (S3، B2، Swift) استفاده می‌کنید، باید باکت را در مشخصات ریموت قرار دهید: \f[V]s3:bucket\f[R].
.PP
اکنون می‌توانید پیکربندی را به‌صورت تعاملی یا دستی ادامه دهید.
.SS "پیکربندی تعاملی"
.PP
دستور \f[V]rclone config\f[R] را اجرا کنید:
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> Hasher1
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Handle checksums for other remotes
   \[rs] \[dq]hasher\[dq]
[snip]
Storage> hasher
Remote to cache checksums for, like myremote:mypath.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
remote> myRemote:path
Comma separated list of supported checksum types.
Enter a string value. Press Enter for the default (\[dq]md5,sha1\[dq]).
hashsums> md5
Maximum time to keep checksums in cache. 0 = no cache, off = cache forever.
max_age> off
Edit advanced config? (y/n)
y) Yes
n) No
y/n> n
Remote config
--------------------
[Hasher1]
type = hasher
remote = myRemote:path
hashsums = md5
max_age = off
--------------------
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS پیکربندی دستی
.PP
برای دیدن مسیر فایل پیکربندی فعال فعلی، دستور \f[V]rclone config path\f[R] را اجرا کنید؛
این مسیر معمولاً \f[V]YOURHOME/.config/rclone/rclone.conf\f[R] است.
آن را در ویرایشگر متن دلخواه خود باز کرده، بخش مربوط به ریموت پایه را پیدا کنید
و همانند مثال‌های زیر، بخش جدیدی برای hasher بسازید:
.IP
.nf
\f[C]
[Hasher1]
type = hasher
remote = myRemote:path
hashes = md5
max_age = off

[Hasher2]
type = hasher
remote = /local/path
hashes = dropbox,sha1
max_age = 24h
\f[R]
.fi
.PP
ابزار Hasher اساساً پارامترهای زیر را می‌گیرد:
.IP \[bu] 2
پارامتر \f[V]remote\f[R] الزامی است
.IP \[bu] 2
پارامتر \f[V]hashes\f[R] فهرستی جداشده با کاما از چِک‌سام‌های پشتیبانی‌شده است (به‌طور
پیش‌فرض \f[V]md5,sha1\f[R])
.IP \[bu] 2
پارامتر \f[V]max_age\f[R] \- حداکثر زمان نگهداری مقدار یک چِک‌سام در حافظهٔ پنهان؛
مقدار \f[V]0\f[R] حافظهٔ پنهان را به‌طور کامل غیرفعال می‌کند و \f[V]off\f[R] آن را
\[dq]برای همیشه\[dq] (یعنی تا زمانی که فایل‌ها تغییر کنند) ذخیره خواهد کرد
.PP
مطمئن شوید که \f[V]remote\f[R] دارای علامت دونقطه (\f[V]:\f[R]) باشد.
اگر ریموت را بدون دونقطه مشخص کنید، rclone از یک دایرکتوری محلی با همان نام استفاده خواهد کرد.
بنابراین اگر از ریموتی مانند \f[V]/local/path\f[R] استفاده کنید، rclone هش‌ها را برای آن دایرکتوری مدیریت خواهد کرد.
اگر عیناً از \f[V]remote = name\f[R] استفاده کنید، rclone فایل‌ها را
\f[B]در دایرکتوری‌ای به نام \f[VB]name\f[B] واقع در دایرکتوری جاری\f[R] قرار می‌دهد.
.SS کاربرد
.SS عملیات پایه
.PP
اکنون می‌توانید به‌جای ریموت پایه از آن به‌صورت \f[V]Hasher2:subdir/file\f[R] استفاده کنید.
هنگامی که یک فایل به‌طور کامل خوانده یا بازنویسی شود، Hasher حافظهٔ پنهان را به‌طور شفاف با چِک‌سام‌های جدید به‌روزرسانی می‌کند؛ مانند:
.IP
.nf
\f[C]
rclone copy External:path/file Hasher:dest/path
rclone cat Hasher:path/to/file > /dev/null
\f[R]
.fi
.PP
روش تازه‌سازی \f[B]تمام\f[R] چِک‌سام‌های ذخیره‌شده در حافظهٔ پنهان (حتی موارد پشتیبانی‌نشده توسط backend پایه) برای یک زیردرخت، \f[B]دانلود مجدد\f[R] تمامی فایل‌های آن زیردرخت است.
برای مثال، از \f[V]hashsum --download\f[R] با استفاده از \f[B]هر\f[R] هش‌سام پشتیبانی‌شده‌ای در خط فرمان استفاده کنید (هدف ما صرفاً خواندن دوباره است):
.IP
.nf
\f[C]
rclone hashsum MD5 --download Hasher:path/to/subtree > /dev/null
rclone backend dump Hasher:path/to/subtree
\f[R]
.fi
.PP
می‌توانید با استفاده از دستورهای سفارشی backend، حافظهٔ پنهان hashsum را چاپ کرده یا پاک کنید (drop):
.IP
.nf
\f[C]
rclone backend dump Hasher:dir/subdir
rclone backend drop Hasher:
\f[R]
.fi
.SS پیش‌مقداردهی از یک فایل SUM
.PP
ابزار Hasher از دو دستور backend پشتیبانی می‌کند: دستور عمومی \f[V]import\f[R] برای فایل SUM و دستور سریع‌تر اما کمتر سازگارِ \f[V]stickyimport\f[R].
.IP
.nf
\f[C]
rclone backend import Hasher:dir/subdir SHA1 /path/to/SHA1SUM [--checkers 4]
\f[R]
.fi
.PP
به‌جای SHA1 می‌تواند هر هشی باشد که توسط ریموت پشتیبانی می‌شود.
آرگومان آخر می‌تواند به یک فایل متنی در قالب SUM، چه محلی و چه در \f[V]other-remote:path\f[R]، اشاره کند.
دستور فایل SUM را تجزیه کرده، سپس مسیر مشخص‌شده در آرگومان نخست را پیمایش می‌کند، از اثرانگشت‌های فعلی تصویر لحظه‌ای (snapshot) می‌گیرد و مدخل‌های حافظهٔ پنهان را متناسب با آن پر می‌کند.
.IP \[bu] 2
مسیرها در فایل SUM به‌صورت نسبی نسبت به \f[V]hasher:dir/subdir\f[R] در نظر گرفته می‌شوند.
.IP \[bu] 2
این دستور صحت مقادیر ارائه‌شده را بررسی \f[B]نخواهد کرد\f[R].
شما \f[B]باید بدانید\f[R] چه کاری انجام می‌دهید.
.IP \[bu] 2
این یک عملیات یک‌باره است.
فایل SUM به ریموت \[dq]پیوست\[dq] نخواهد شد.
اگر اثرانگشت شیء تغییر کند، مدخل‌های حافظهٔ پنهان همچنان بعداً می‌توانند بازنویسی شوند.
.IP \[bu] 2
پیمایش درخت بسته به اندازهٔ آن می‌تواند زمان زیادی ببرد.
می‌توانید برای سریع‌تر شدن، مقدار \f[V]--checkers\f[R] را افزایش دهید؛
یا اگر اثرانگشت‌ها و سازگاری داده‌ها برایتان مهم نیست، از \f[V]stickyimport\f[R] استفاده کنید.
.IP
.nf
\f[C]
rclone backend stickyimport hasher:path/to/data sha1 remote:/path/to/sum.sha1
\f[R]
.fi
.PP
دستور \f[V]stickyimport\f[R] شبیه به \f[V]import\f[R] است اما بسیار سریع‌تر عمل می‌کند زیرا نیازی به اجرای stat روی فایل‌های موجود ندارد و از پیمایش اولیهٔ درخت صرف‌نظر می‌کند.
به‌جای مقید کردن مدخل‌های حافظهٔ پنهان به اثرانگشت فایل، مدخل‌های \f[I]چسبنده\f[R] (sticky) ایجاد می‌کند که صرفاً به نام فایل مقید هستند و اندازه، زمان تغییر و غیره را نادیده می‌گیرند.
چنین مدخل‌های هشی را تنها می‌توان با \f[V]purge\f[R]، \f[V]delete\f[R]، \f[V]backend drop\f[R] یا خواندن/بازنویسی کامل دوبارهٔ فایل‌ها جایگزین کرد..SS مرجع پیکربندی (Configuration reference)
.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص hasher (چک‌سام‌های بهتر برای ریموت‌های دیگر) آورده شده است.
.SS --hasher-remote
.PP
ریموت مورد نظر برای کش کردن چک‌سام‌ها (به عنوان مثال myRemote:path).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: remote
.IP \[bu] 2
متغیر محیطی: RCLONE_HASHER_REMOTE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: true
.SS --hasher-hashes
.PP
فهرست جداشده با کاما از انواع چک‌سام‌های پشتیبانی‌شده.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hashes
.IP \[bu] 2
متغیر محیطی: RCLONE_HASHER_HASHES
.IP \[bu] 2
نوع: CommaSepList
.IP \[bu] 2
پیش‌فرض: md5,sha1
.SS --hasher-max-age
.PP
حداکثر زمان نگهداری چک‌سام‌ها در کش (0 = بدون کش، off = کش برای همیشه).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: max_age
.IP \[bu] 2
متغیر محیطی: RCLONE_HASHER_MAX_AGE
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: off
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مختص hasher (چک‌سام‌های بهتر برای ریموت‌های دیگر) آورده شده است.
.SS --hasher-auto-size
.PP
به‌روزرسانی خودکار چک‌سام برای فایل‌های کوچک‌تر از این اندازه (به‌طور پیش‌فرض غیرفعال است).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auto_size
.IP \[bu] 2
متغیر محیطی: RCLONE_HASHER_AUTO_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 0
.SS --hasher-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_HASHER_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS متاداده (Metadata)
.PP
هرگونه متاداده‌ای که توسط ریموت زیربنایی پشتیبانی شود، خوانده و نوشته می‌شود.
.PP
برای اطلاعات بیشتر مستندات متاداده (https://rclone.org/docs/#metadata) را ببینید..SS دستورهای backend
.PP
در اینجا دستورهای ویژهٔ backend مربوط به hasher آمده است.
.PP
آن‌ها را بدین صورت اجرا کنید:
.IP
.nf
\f[C]
rclone backend COMMAND remote:
\f[R]
.fi
.PP
راهنمای زیر توضیح می‌دهد که هر دستور چه آرگومان‌هایی می‌پذیرد.
.PP
برای اطلاعات بیشتر در مورد چگونگی ارسال گزینه‌ها و آرگومان‌ها، دستور backend (<https://rclone.org/commands/rclone_backend>) را ببینید.
.PP
این دستورها را می‌توان بر روی یک backend در حال اجرا با استفاده از دستور rc به نام backend/command (<https://rclone.org/rc/#backend-command>) اجرا کرد.
.SS drop
.PP
دور ریختن حافظهٔ موقت (کَش).
.IP
.nf
\f[C]
rclone backend drop remote: [options] [<arguments>+]
\f[R]
.fi
.PP
پاک‌سازی و دور ریختن کامل حافظهٔ موقت مربوط به چِک‌سام (checksum).
.PP
مثال کاربرد:
.IP
.nf
\f[C]
rclone backend drop hasher:
\f[R]
.fi
.SS dump
.PP
تخلیهٔ (Dump) پایگاه‌داده.
.IP
.nf
\f[C]
rclone backend dump remote: [options] [<arguments>+]
\f[R]
.fi
.PP
تخلیهٔ رکوردهای حافظهٔ موقت تحت پوشش remote جاری.
.SS fulldump
.PP
تخلیهٔ کامل پایگاه‌داده.
.IP
.nf
\f[C]
rclone backend fulldump remote: [options] [<arguments>+]
\f[R]
.fi
.PP
تخلیهٔ تمام رکوردهای حافظهٔ موقت در پایگاه‌داده.
.SS import
.PP
وارد کردن یک فایل SUM.
.IP
.nf
\f[C]
rclone backend import remote: [options] [<arguments>+]
\f[R]
.fi
.PP
اصلاح و به‌روزرسانی حافظهٔ موقت هش از روی یک فایل SUM و پیوند دادن چِک‌سام‌ها به فایل‌ها بر پایهٔ اندازه/زمان.
.PP
مثال کاربرد:
.IP
.nf
\f[C]
rclone backend import hasher:subdir md5 /path/to/sum.md5
\f[R]
.fi.SS stickyimport
.PP
انجام درون‌ریزی سریع یک فایل SUM.
.IP
.nf
\f[C]
rclone backend stickyimport remote: [options] [<arguments>+]
\f[R]
.fi
.PP
پر کردن حافظهٔ موقت (کَش) هش از یک فایل SUM بدون اعتبارسنجی اثرانگشت‌های فایل.
.PP
مثال کاربرد:
.IP
.nf
\f[C]
rclone backend stickyimport hasher:subdir md5 remote:path/to/sum.md5
\f[R]
.fi
.SS جزئیات پیاده‌سازی (پیشرفته)
.PP
این بخش نحوهٔ عملکرد عملیات مختلف rclone بر روی یک ریموت hasher را توضیح می‌دهد.
.PP
\f[B]سلب مسئولیت.
این بخش پیاده‌سازی فعلی را توصیف می‌کند که ممکن است در نسخه‌های آیندهٔ rclone تغییر کند!.\f[R]
.SS دستور Hashsum
.PP
دستور \f[V]rclone hashsum\f[R] (یا \f[V]md5sum\f[R] یا \f[V]sha1sum\f[R]):
.IP "1." 3
اگر هش درخواستی توسط سطح پایین‌تر پشتیبانی شود، صرفاً آن را عبور می‌دهد.
.IP "2." 3
اگر اندازهٔ شیء کمتر از \f[V]auto_size\f[R] باشد، شیء را بارگیری کرده و هش‌های \f[I]درخواستی\f[R] را در لحظه محاسبه می‌کند.
.IP "3." 3
اگر پشتیبانی نشود و اندازهٔ آن به حد کافی بزرگ باشد، اثرانگشت شیء (\f[V]fingerprint\f[R]) را ایجاد می‌کند (شامل اندازه، زمان تغییر یا modtime در صورت پشتیبانی، و اولین هشِ \f[I]دیگری\f[R] که یافت شود).
.IP "4." 3
اگر تطابق دقیق در حافظهٔ موقت برای ریموت درخواستی یافت شود، هش ذخیره‌شده را بازمی‌گرداند.
.IP "5." 3
اگر ریموت یافت شود اما اثرانگشت مطابقت نداشته باشد، ورودی را پاکسازی (purge) کرده و به مرحلهٔ ۶ می‌رود.
.IP "6." 3
اگر ریموت یافت نشود یا نوع هش درخواستی را نداشته باشد، یا پس از مرحلهٔ ۵: شیء را بارگیری کرده، تمام هش‌های \f[I]پشتیبانی‌شده\f[R] را در لحظه محاسبه نموده و در حافظهٔ موقت ذخیره می‌کند؛ سپس هش درخواستی را بازمی‌گرداند.
.SS سایر عملیات
.IP \[bu] 2
هر زمان که هشی درخواست شود، از منطق مراحل ۱ تا ۴ از دستور \f[V]hashsum\f[R] در بالا پیروی می‌شود
.IP \[bu] 2
هرگاه فایلی \f[B]به‌طور کامل\f[R] بارگذاری یا بارگیری شود، جریان داده ضبط شده تا تمام هش‌های پشتیبانی‌شده در لحظه محاسبه شوند و پایگاه داده به‌روزرسانی گردد
.IP \[bu] 2
دستور \f[V]move\f[R] سمت سرور کلیدهای ورودی‌های موجود در حافظهٔ موقت را به‌روزرسانی می‌کند
.IP \[bu] 2
دستور \f[V]deletefile\f[R] یک ورودی منفرد را از حافظهٔ موقت حذف می‌کند
.IP \[bu] 2
دستور \f[V]purge\f[R] تمام ورودی‌های حافظهٔ موقت را در زیر مسیر پاکسازی‌شده حذف خواهد کرد
.PP
توجه داشته باشید که تنظیم \f[V]max_age = 0\f[R] کَش کردن چکسام را کاملاً غیرفعال می‌کند.
.PP
اگر \f[V]max_age = off\f[R] را تنظیم کنید، چکسام‌های موجود در حافظهٔ موقت هرگز منقضی نمی‌شوند، مگر اینکه فایل را به‌طور کامل بازنویسی یا حذف کنید.
.SS فضای ذخیره‌سازی کَش
.PP
چکسام‌های کَش‌شده به‌عنوان فایل‌های پایگاه دادهٔ \f[V]bolt\f[R] در پوشهٔ کَش rclone ذخیره می‌شوند که معمولاً \f[V]\[ti]/.cache/rclone/kv/\f[R] است.
پایگاه‌های داده به ازای هر بک‌اند \f[I]پایه\f[R] (base) به صورت مجزا نگهداری می‌شوند و نام‌گذاری آن‌ها مانند \f[V]BaseRemote\[ti]hasher.bolt\f[R] است.
چکسام‌ها برای چندین \f[V]alias\f[R] متصل به یک بک‌اند پایهٔ یکسان، در یک پایگاه دادهٔ واحد ذخیره خواهند شد.
تمام مسیرهای محلی به عنوان نام‌های مستعار (alias) به بک‌اند \f[V]local\f[R] در نظر گرفته می‌شوند (مگر اینکه رمزگذاری یا تکه‌تکه شده باشند) و در \f[V]\[ti]/.cache/rclone/kv/local\[ti]hasher.bolt\f[R] ذخیره می‌گردند.
پایگاه‌های داده می‌توانند بین چندین فرایند rclone به اشتراک گذاشته شوند..SH "هوآوی درایو (Huawei Drive)"
.PP
مسیرها به صورت \f[V]huaweidrive:path\f[R] مشخص می‌شوند.
.PP
مسیرهای Huawei Drive می‌توانند تا هر عمقی که نیاز است ادامه یابند، مانند
\f[V]huaweidrive:directory/subdirectory\f[R].
.SS "پیکربندی (Configuration)"
.PP
راه‌اندازی اولیه برای Huawei Drive شامل دریافت یک توکن از Huawei
Drive است که باید آن را در مرورگر وب خود انجام دهید.
\f[V]rclone config\f[R] شما را در این مراحل راهنمایی می‌کند.
.PP
در اینجا نمونه‌ای از نحوهٔ ساخت یک ریموت به نام \f[V]remote\f[R] آمده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرآیند راه‌اندازی تعاملی راهنمایی خواهد کرد:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
n/r/c/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Huawei Drive
   \[rs] \[dq]huaweidrive\[dq]
[snip]
Storage> huaweidrive
OAuth Client Id - leave blank to use rclone\[aq]s default.
client_id> 
OAuth Client Secret - leave blank to use rclone\[aq]s default.
client_secret>
Remote config
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y) Yes
n) No
y/n> y
If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth
Log in and authorize rclone for access
Waiting for code...
Got code
Configuration complete.
Options:
- type: huaweidrive
- client_id: 
- client_secret: 
- token: {\[dq]access_token\[dq]:\[dq]XXX\[dq],\[dq]token_type\[dq]:\[dq]Bearer\[dq],\[dq]refresh_token\[dq]:\[dq]XXX\[dq],\[dq]expiry\[dq]:\[dq]2024-03-16T13:57:58.955387075Z\[dq]}
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
برای چگونگی راه‌اندازی بر روی ماشینی که به مرورگر وب با دسترسی اینترنت مجهز نیست، مستندات راه‌اندازی ریموت را در <https://rclone.org/remote_setup> ببینید.
.PP
توجه داشته باشید که اگر از مرورگر وب برای احراز هویت خودکار استفاده می‌کنید، rclone یک وب‌سرور بر روی ماشین محلی شما اجرا می‌کند تا توکن بازگردانده شده از سوی Huawei را جمع‌آوری کند.
این سرور تنها از لحظهٔ باز شدن مرورگر تا زمان دریافت کد تأیید اجرا خواهد بود.
این سرویس روی \f[V]http://127.0.0.1:53682\f[R] قرار دارد و در صورتی که فایروال میزبان فعال باشد، ممکن است نیاز به رفع انسداد موقت آن داشته باشید یا از حالت دستی استفاده کنید.
.PP
سپس می‌توانید به این شکل از آن استفاده کنید:
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح درایو:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمامی فایل‌ها در درایو شما:
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به دایرکتوری‌ای به نام backup در درایو:
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS دریافت Client ID و Secret اختصاصی خود
.PP
هنگامی که از rclone با Huawei Drive در پیکربندی پیش‌فرض استفاده می‌کنید،
از client_id متعلق به rclone استفاده می‌شود.
این شناسه بین تمامی کاربران rclone مشترک است.
از سوی Huawei یک محدودیت نرخ سراسری (global rate limit) بر روی تعداد
پرس‌وجوهای بر ثانیه برای هر client_id اعمال شده است.
.PP
اکیداً توصیه می‌شود از Client ID اختصاصی خود استفاده کنید، زیرا شناسه
پیش‌فرض rclone به شدت مورد استفاده قرار می‌گیرد.
اگر چندین سرویس در حال اجرا دارید، توصیه می‌شود برای هر سرویس از یک
Client ID جداگانه استفاده کنید تا از بروز مشکلات محدودیت نرخ جلوگیری شود.
.PP
نحوه ایجاد Client ID اختصاصی Huawei Drive برای rclone به شرح زیر است:
.PP
برای دستورالعمل‌های راه‌اندازی کامل، راهنماهای جامع زیر را دنبال کنید:
.IP \[bu] 2
مقدمات برنامه تحت وب Huawei HMS Core
(https://developer.huawei.com/consumer/cn/doc/HMSCore-Guides/web-preparations-0000001050050891)
.IP \[bu] 2
مقدمات سرور Huawei HMS Core
(https://developer.huawei.com/consumer/cn/doc/HMSCore-Guides/server-preparations-0000001050185577#section194911701377)
.PP
ابزار rclone برای اتصال به Huawei Drive از روش دسترسی برنامه تحت وب
(web application) استفاده می‌کند.
پیش از شروع، باید مجوز ورود سریع را از طریق Huawei Account Open Service
پیاده‌سازی کنید.
با در دست داشتن اطلاعات مجوز کاربر، rclone می‌تواند APIهای سرویس
Huawei Cloud Drive را فراخوانی کند.
.SS ایجاد برنامه سرور (Server Application)
.PP
پیش از دسترسی به سرویس Drive، توسعه‌دهندگان باید ابتدا یک برنامه سرور
ایجاد کنند.
برای جزئیات بیشتر، لطفاً به بخش WEB Application Access Development Preparation
در \[dq]Huawei Account Service Development Guide\[dq] مراجعه کنید.
.SS فعال‌سازی کلید برنامه Drive
.IP "1." 3
به وب‌سایت AppGallery Connect وارد شوید و روی \[dq]My Projects\[dq]
کلیک کنید.
.IP "2." 3
پروژه خود را در فهرست پروژه‌ها پیدا کنید، برنامه‌ای را که نیازمند دسترسی
به Drive است انتخاب کرده و روی \[dq]API Management\[dq] کلیک کنید.
.IP "3." 3
در بخش \[dq]API Management\[dq] از صفحه \[dq]Project Settings\[dq]، روی
کلید سمت راست Drive Kit کلیک کنید تا مطمئن شوید در وضعیت فعال (open)
قرار دارد.
.SS امضای اعلامیه حریم خصوصی و توافق‌نامه کاربری Huawei Cloud Drive
.PP
به نشانی <https://cloud.huawei.com> مراجعه کنید.
کاربرانی که برای اولین بار وارد می‌شوند، باید پیش از استفاده از
Huawei Cloud Drive Service این توافق‌نامه را امضا (تأیید) کنند.
.SS دسترسی برنامه برای دریافت توکن احراز هویت (Access Token)
.PP
برنامه‌هایی که به Drive دسترسی پیدا می‌کنند باید از توکن احراز هویت
Access Token استفاده کنند.
برای روش‌های خاص دریافت آن، لطفاً به بخش WEB Application Access
Development Guide در \[dq]Huawei Account Service Development Guide\[dq]
مراجعه نمایید.
.PP
خلاصه گام‌های کلیدی:
.IP "1." 3
با حساب کاربری Huawei خود وارد
Huawei Developer Console (https://developer.huawei.com/consumer/en/console)
شوید.
.IP "2." 3
یک پروژه جدید ایجاد کرده یا یکی از پروژه‌های موجود را انتخاب کنید.
.IP "3." 3
به بخش \[dq]Manage APIs\[dq] رفته و API مربوط به \[dq]Drive Kit\[dq]
را فعال کنید.
.IP "4." 3
در پنل سمت چپ روی \[dq]Credentials\[dq] کلیک کنید.
.IP "5." 3
روی \[dq]Create Credentials\[dq] کلیک کرده و \[dq]OAuth client ID\[dq]
را انتخاب نمایید.
.IP "6." 3
گزینه \[dq]Web application\[dq] را به عنوان نوع برنامه انتخاب کنید.
.IP "7." 3
نشانی \f[V]http://localhost:53682/\f[R] را به \[dq]Authorized redirect
URIs\[dq] اضافه کنید.
.IP "8." 3
روی \[dq]Create\[dq] کلیک کرده و Client ID و Client Secret را یادداشت
نمایید.
.IP "9." 3
هنگام پیکربندی rclone، مقادیر Client ID و Client Secret یادداشت‌شده را
ارائه دهید..SS محدوده‌ها (Scopes)
.PP
ابزار rclone هنگام دسترسی به Huawei Drive از محدوده‌های OAuth2 زیر استفاده می‌کند:
.IP \[bu] 2
\f[V]https://www.huawei.com/auth/drive\f[R] \- دسترسی کامل به فایل‌های Huawei
Drive (به‌جز پوشه داده‌های برنامه)
.IP \[bu] 2
\f[V]https://www.huawei.com/auth/drive.file\f[R] \- دسترسی به فایل‌های
ایجادشده توسط برنامه
.IP \[bu] 2
\f[V]openid\f[R] \- احراز هویت OpenID Connect
.IP \[bu] 2
\f[V]profile\f[R] \- دسترسی به اطلاعات پایه‌ای نمایه
.PP
محدوده \f[V]drive.file\f[R] در مجموعه پیش‌فرضی که توسط rclone استفاده
می‌شود گنجانده شده است.
.PP
محدوده‌های جایگزین موجود (که به‌صورت پیش‌فرض توسط rclone استفاده نمی‌شوند):
.IP \[bu] 2
\f[V]https://www.huawei.com/auth/drive.appdata\f[R] \- دسترسی به پوشه
داده‌های برنامه
.IP \[bu] 2
\f[V]https://www.huawei.com/auth/drive.readonly\f[R] \- دسترسی فقط‌خواندنی
به فراداده و محتوای فایل
.IP \[bu] 2
\f[V]https://www.huawei.com/auth/drive.metadata\f[R] \- دسترسی خواندن/نوشتن
فقط به فراداده فایل
.IP \[bu] 2
\f[V]https://www.huawei.com/auth/drive.metadata.readonly\f[R] \-
دسترسی فقط‌خواندنی فقط به فراداده فایل
.PP
محدوده‌های پیش‌فرض، دسترسی خواندن/نوشتن را به تمامی فایل‌های موجود در Huawei
Drive شما فراهم می‌کنند.
.SS زمان‌های تغییر و هش‌ها (Modification times and hashes)
.PP
سرویس Huawei Drive از تنظیم زمان‌های تغییر پشتیبانی نمی‌کند.
این API همواره از برچسب‌های زمانی سمت سرور استفاده می‌کند، بنابراین زمان‌های
تغییر فایل از مبدأ در طول بارگذاری حفظ نمی‌شوند.
زمان‌های تغییر به‌صورت فراداده فقط‌خواندنی (\f[V]mtime\f[R]،
\f[V]btime\f[R]) در دسترس هستند.
.PP
الگوریتم هش SHA256 برای تأیید یکپارچگی فایل پشتیبانی می‌شود.
.SS نویسه‌های محدودشده در نام فایل (Restricted filename characters)
.PP
سرویس Huawei Drive محدودیت‌های سخت‌گیرانه‌ای برای نام‌های فایل و دایرکتوری دارد:
.IP \[bu] 2
نمی‌تواند شامل این موارد باشد: \f[V]< > | : \[dq] * ? / \[rs]\f[R] یا نویسه‌های ایموجی
.IP \[bu] 2
نمی‌تواند دقیقاً \f[V]. ..\f[R] باشد
.IP \[bu] 2
حداکثر طول: 250 بایت
.IP \[bu] 2
نقل‌قول‌های تکی باید در فراخوانی‌های API با \f[V]\[rs]\[aq]\f[R] گریز داده شوند
.PP
این محدودیت‌ها توسط کدگذاری rclone مدیریت می‌شوند:
.IP \[bu] 2
بک‌اسلش‌ها \f[V]\[rs]\f[R] کدگذاری می‌شوند
.IP \[bu] 2
توالی‌های نامعتبر UTF-8 کدگذاری می‌شوند
.PD 0
.P
.PD
.IP \[bu] 2
فاصله‌های سمت راست کدگذاری می‌شوند
.PP
نویسه‌های نامعتبر با توجه به تنظیمات کدگذاری جایگزین خواهند
شد (https://rclone.org/overview/#invalid-utf8).
.SS بارگذاری‌های ادامه‌پذیر (Resumable uploads)
.PP
سرویس Huawei Drive از بارگذاری ادامه‌پذیر برای فایل‌های بزرگ‌تر از حد آستانه
بارگذاری (پیش‌فرض 20MB) پشتیبانی می‌کند.
فایل‌ها به‌صورت تکه‌تکه بارگذاری می‌شوند که امکان بازیابی در صورت قطعی شبکه
را فراهم می‌سازد.
.SS محدودیت‌های اندازه فایل (File size limits)
.PP
حداکثر اندازه فایل برای Huawei Drive برابر با 50 GiB است.
.SS اطلاعات سهمیه (Quota information)
.PP
برای مشاهده سهمیه فعلی خود می‌توانید از دستور
\f[V]rclone about remote:\f[R] استفاده کنید که اطلاعات مصرف و
سهمیه شما را نمایش می‌دهد..SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص به huaweidrive (Huawei Drive) آورده شده است.
.SS --huaweidrive-client-id
.PP
شناسه کلاینت OAuth.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_HUAWEIDRIVE_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --huaweidrive-client-secret
.PP
کلید مخفی کلاینت OAuth.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_HUAWEIDRIVE_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مختص به huaweidrive (Huawei Drive) آورده شده است.
.SS --huaweidrive-token
.PP
توکن دسترسی OAuth به‌صورت یک شیء JSON (JSON blob).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_HUAWEIDRIVE_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --huaweidrive-auth-url
.PP
نشانی اینترنتی (URL) سرور احراز هویت.
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_HUAWEIDRIVE_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --huaweidrive-token-url
.PP
نشانی اینترنتی (URL) سرور توکن.
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_HUAWEIDRIVE_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --huaweidrive-client-credentials
.PP
استفاده از جریان اعتبارسنجی کلاینت (client credentials) در OAuth.
.PP
این مورد از جریان Client Credentials در OAUTH2 طبق آنچه در RFC
6749 شرح داده شده است استفاده خواهد کرد.
.PP
توجه داشته باشید که این گزینه توسط همه backendها پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_HUAWEIDRIVE_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --huaweidrive-root-folder-id
.PP
شناسه پوشه ریشه (root).
.PP
معمولاً این مقدار به‌طور خودکار شناسایی می‌شود، اما در صورت عدم موفقیت یا برای افزایش سرعت راه‌اندازی، می‌توانید آن را به‌صورت دستی تنظیم کنید.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_folder_id
.IP \[bu] 2
متغیر محیطی: RCLONE_HUAWEIDRIVE_ROOT_FOLDER_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --huaweidrive-chunk-size
.PP
اندازه قطعه (chunk) بارگذاری.
.PP
باید توانی از ۲ و >= 256k و <= 64MB باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_HUAWEIDRIVE_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 8Mi
.SS --huaweidrive-list-chunk
.PP
اندازه قطعه فهرست‌بندی بین ۱ تا ۱۰۰۰.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_chunk
.IP \[bu] 2
متغیر محیطی: RCLONE_HUAWEIDRIVE_LIST_CHUNK
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 1000
.SS --huaweidrive-upload-cutoff
.PP
آستانه تغییر وضعیت به بارگذاری قابل‌ازسرگیری (resumable upload).
.PP
هر فایلی بزرگ‌تر از این مقدار، با استفاده از بارگذاری قابل‌ازسرگیری بارگذاری خواهد شد.
حداقل مقدار 0 و حداکثر آن 20 MiB است (محدودیت Huawei Drive API برای بارگذاری‌های تک‌درخواستی).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_HUAWEIDRIVE_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 20Mi
.SS --huaweidrive-encoding
.PP
کدگذاری برای بک‌اند.
.PP
برای اطلاعات بیشتر، بخش کدگذاری را در نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_HUAWEIDRIVE_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,LeftSpace,LeftPeriod,LeftTilde,RightSpace,RightPeriod,InvalidUtf8,Dot.SS --huaweidrive-description
.PP
توضیحات ریموت (remote).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_HUAWEIDRIVE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS فراداده (Metadata)
.PP
سرویس Huawei Drive از خواندن و نوشتن فراداده‌های سفارشی پشتیبانی می‌کند.
.PP
فراداده کاربر را می‌توان با استفاده از فیلد \[dq]properties\[dq] در API تنظیم کرد.
فراداده سیستم شامل اطلاعات استاندارد فایل است، از قبیل:
\- content-type: نوع MIME شیء
\- description: توضیحات ارائه‌شده توسط کاربر
\- favorite: وضعیت علامت‌گذاری فایل به عنوان مورد علاقه
\- btime/mtime/utime: برچسب‌های زمانی گوناگون
\- sha256: هش فایل
\- recycled/has-thumbnail: پرچم‌های وضعیت فایل
.PP
کلیدهای فراداده سفارشی می‌توانند هر رشته‌ای باشند و در ویژگی‌های (properties) فایل ذخیره می‌شوند.
.PP
در اینجا موارد ممکن فراداده سیستم برای backend مربوط به huaweidrive آورده شده است.
.PP
.TS
tab(@);
lw(11.1n) lw(11.1n) lw(11.1n) lw(16.6n) lw(20.3n).
T{
نام
T}@T{
راهنما
T}@T{
نوع
T}@T{
مثال
T}@T{
فقط‌خواندنی
T}
_
T{
btime
T}@T{
زمان ایجاد فایل (RFC 3339)
T}@T{
RFC 3339
T}@T{
T}@T{
\f[B]Y\f[R]
T}
T{
content-type
T}@T{
نوع MIME شیء
T}@T{
string
T}@T{
T}@T{
\f[B]Y\f[R]
T}
T{
description
T}@T{
توضیحات فایل
T}@T{
string
T}@T{
T}@T{
N
T}
T{
favorite
T}@T{
آیا فایل به عنوان مورد علاقه علامت‌گذاری شده است (true/false)
T}@T{
string
T}@T{
T}@T{
N
T}
T{
has-thumbnail
T}@T{
آیا فایل دارای تصویر بندانگشتی است (true/false)
T}@T{
string
T}@T{
T}@T{
\f[B]Y\f[R]
T}
T{
mtime
T}@T{
زمان آخرین تغییر محتوای فایل (RFC 3339)
T}@T{
RFC 3339
T}@T{
T}@T{
\f[B]Y\f[R]
T}
T{
recycled
T}@T{
آیا فایل در سطل بازیافت قرار دارد (true/false)
T}@T{
string
T}@T{
T}@T{
\f[B]Y\f[R]
T}
T{
sha256
T}@T{
هش SHA256 فایل
T}@T{
string
T}@T{
T}@T{
\f[B]Y\f[R]
T}
T{
utime
T}@T{
زمان آخرین ویرایش فایل توسط کاربر فعلی (RFC 3339)
T}@T{
RFC 3339
T}@T{
T}@T{
\f[B]Y\f[R]
T}
.TE
.PP
برای اطلاعات بیشتر مستندات فراداده (<https://rclone.org/docs/#metadata>) را ببینید..SS محدودیت‌ها
.PP
سرویس Huawei Drive دارای محدودیت نرخ درخواست (rate limiting) است که ممکن است باعث شود rclone به منظور جلوگیری از برخورد با محدودیت‌ها، سرعت انتقال‌ها را کاهش دهد.
.SS محدودیت‌های نام فایل
.IP \[bu] 2
نام فایل‌ها نمی‌تواند شامل این نویسه‌ها باشد: \f[V]< > | : \[dq] * ? / \[rs]\f[R]
.IP \[bu] 2
نام فایل‌ها نمی‌تواند دقیقاً \f[V]. ..\f[R] باشد
.IP \[bu] 2
حداکثر طول نام فایل ۲۵۰ بایت است
.IP \[bu] 2
برخی نویسه‌های یونیکد از جمله ایموجی‌ها پشتیبانی نمی‌شوند
.SS محدودیت‌های نرخ API
.PP
سرویس Huawei Drive محدودیت‌های نرخ درخواست API اعمال می‌کند.
rclone با عقب‌نشینی زمانی (back-off) هنگام برخورد با این محدودیت‌ها، آن‌ها را به‌طور خودکار مدیریت می‌کند.
.SS انقضای توکن OAuth2
.IP \[bu] 2
توکن‌های دسترسی (Access tokens) پس از ۱ ساعت منقضی می‌شوند
.IP \[bu] 2
توکن‌های نوسازی (Refresh tokens) پس از ۱۸۰ روز منقضی می‌شوند
.PD 0
.P
.PD
.IP \[bu] 2
rclone در صورت نیاز به‌طور خودکار توکن‌ها را نوسازی خواهد کرد
.SS محدودیت‌های اندازه فایل
.IP \[bu] 2
حداکثر اندازه فایل ۵۰ گیبی‌بایت (GiB) است
.IP \[bu] 2
فایل‌های بزرگ‌تر از این مقدار قابل بارگذاری نیستند
.SS رفتار بارگذاری
.IP \[bu] 2
فایل‌های کوچک‌تر از \f[V]upload_cutoff\f[R] (پیش‌فرض 20MB) در یک درخواست تکی با استفاده از روش محتوا یا چندبخشی (multipart) بارگذاری می‌شوند
.IP \[bu] 2
فایل‌های بزرگ‌تر با استفاده از بارگذاری‌های قابل ازسرگیری (resumable) با اندازه قطعه (chunk size) قابل تنظیم بارگذاری می‌شوند
.IP \[bu] 2
حداکثر اندازه یک قطعه تکی برای بارگذاری‌های قابل ازسرگیری 64MB است
.IP \[bu] 2
بارگذاری‌های قابل ازسرگیری از تلاش مجدد خودکار در صورت بروز خطاهای شبکه پشتیبانی می‌کنند
.IP \[bu] 2
تأیید هش SHA256 برای فایل‌های بارگذاری‌شده پشتیبانی می‌شود
.SS عملیات سمت سرور
.IP \[bu] 2
کپی سمت سرور: فایل‌ها را می‌توان بدون نیاز به بارگیری و بارگذاری مجدد، درون Huawei Drive کپی کرد
.IP \[bu] 2
انتقال سمت سرور: فایل‌ها و دایرکتوری‌ها را می‌توان در سمت سرور منتقل کرد یا تغییر نام داد
.IP \[bu] 2
انتقال دایرکتوری: کل دایرکتوری‌ها را می‌توان با یک فراخوانی واحد API جابه‌جا کرد
.SS عملیات دایرکتوری
.IP \[bu] 2
سرویس Huawei Drive از ایجاد دایرکتوری‌های خالی پشتیبانی می‌کند
.IP \[bu] 2
فهرست‌گیری بازگشتی از طریق \f[V]--fast-list\f[R] برای پیمایش کارآمد دایرکتوری پشتیبانی می‌شود
.IP \[bu] 2
سرویس Huawei Drive دارای یک پوشه ویژه \[dq]applicationData\[dq] برای داده‌های اختصاصی برنامه است (از طریق پیکربندی پیش‌فرض rclone قابل دسترسی نیست)
.SS مدیریت خطا
.PP
خطاهای رایج و معانی آن‌ها:
.IP \[bu] 2
\f[V]401 Unauthorized\f[R]: اعتبارنامه‌های نامعتبر یا توکن منقضی‌شده
.IP \[bu] 2
\f[V]403 Forbidden\f[R]: معمولاً نشان‌دهنده مجوزهای ناکافی یا فراتر رفتن از سهمیه API است
.IP \[bu] 2
\f[V]404 Not Found\f[R]: فایل یا دایرکتوری وجود ندارد
.IP \[bu] 2
\f[V]409 Conflict\f[R]: دایرکتوری از قبل وجود دارد
.IP \[bu] 2
\f[V]429 Too Many Requests\f[R]: از محدودیت نرخ API فراتر رفته است، rclone به‌طور خودکار دوباره تلاش خواهد کرد
.SS بهینه‌سازی کارایی
.PP
برای کارایی بهتر:
.IP \[bu] 2
افزایش مقدار \f[V]--transfers\f[R] برای عملیات‌های هم‌زمان (پیش‌فرض ۴ است)
.IP \[bu] 2
تنظیم \f[V]chunk_size\f[R] بر اساس سرعت شبکه و اندازه‌های فایل شما
.IP \[bu] 2
استفاده از \f[V]--fast-list\f[R] برای عملیات روی دایرکتوری‌های حاوی فایل‌های پرتعداد جهت کاهش فراخوانی‌های API.SS پشتیبان‌گیری
.PP
سرویس Huawei Drive با در نظر گرفتن نکاتی برای پشتیبان‌گیری مناسب است:
.IP \[bu] 2
برای حفظ ساختار دقیق دایرکتوری، به‌جای \f[V]rclone copy\f[R] از \f[V]rclone sync\f[R] استفاده کنید
.IP \[bu] 2
استفاده از \f[V]--backup-dir\f[R] را برای نگه‌داری فایل‌های حذف‌شده در نظر بگیرید
.IP \[bu] 2
برای داده‌های حیاتی، انتقال‌ها را با پرچم \f[V]--checksum\f[R] راستی‌آزمایی کنید
.IP \[bu] 2
محدودیت اندازه فایل 50 GiB برای هر فایل مجزا را مد نظر داشته باشید
.SS قابلیت‌های پشتیبانی‌شده
.PP
سرویس Huawei Drive از قابلیت‌های زیر در rclone پشتیبانی می‌کند:
.IP \[bu] 2
\f[V]Copy\f[R] \- کپی سمت سرور فایل‌ها
.IP \[bu] 2
\f[V]Move\f[R] \- انتقال/تغییر نام سمت سرور فایل‌ها
.IP \[bu] 2
\f[V]DirMove\f[R] \- انتقال سمت سرور دایرکتوری‌ها
.IP \[bu] 2
\f[V]ListR\f[R] \- فهرست‌بندی بازگشتی برای \f[V]--fast-list\f[R]
.IP \[bu] 2
\f[V]About\f[R] \- اطلاعات سهمیه فضای ذخیره‌سازی
.IP \[bu] 2
\f[V]Purge\f[R] \- حذف دایرکتوری و تمام محتویات آن
.IP \[bu] 2
\f[V]CleanUp\f[R] \- خالی کردن سطل زباله
.IP \[bu] 2
\f[V]UserInfo\f[R] \- دریافت اطلاعات حساب کاربری
.IP \[bu] 2
\f[V]Metadata\f[R] \- خواندن و نوشتن فراداده/ویژگی‌های فایل
.IP \[bu] 2
\f[V]ChangeNotify\f[R] \- بررسی دوره‌ای برای تغییرات در ریموت (استفاده‌شده توسط
\f[V]rclone mount\f[R] و \f[V]rclone rc vfs/poll-interval\f[R])
.SS ادغام با سایر سرویس‌ها
.PP
می‌توان از Huawei Drive به‌عنوان بک‌اند برای عملیات مختلف rclone استفاده کرد:
.IP \[bu] 2
سوار کردن (Mount) به‌عنوان سیستم‌فایل محلی با استفاده از \f[V]rclone mount\f[R]
.IP \[bu] 2
ارائه از طریق HTTP با استفاده از \f[V]rclone serve http\f[R]
.IP \[bu] 2
ارائه از طریق FTP با استفاده از \f[V]rclone serve ftp\f[R]
.IP \[bu] 2
ارائه از طریق WebDAV با استفاده از \f[V]rclone serve webdav\f[R]
.PP
توجه داشته باشید که ممکن است برخی عملیات به دلیل محدودیت‌های API و تأخیر شبکه، کندتر از فضای ذخیره‌سازی محلی باشند.
.SH HDFS
.PP
سامانه HDFS (https://hadoop.apache.org/docs/stable/hadoop-project-dist/hadoop-hdfs/HdfsDesign.html)
یک سیستم‌فایل توزیع‌شده و بخشی از چارچوب Apache
Hadoop (https://hadoop.apache.org) است.
.PP
مسیرها به‌صورت \f[V]remote:\f[R] یا
\f[V]remote:path/to/dir\f[R] مشخص می‌شوند.
.SS پیکربندی
.PP
در اینجا نمونه‌ای از نحوه ساخت یک ریموت با نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این کار شما را در فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[skip]
XX / Hadoop distributed file system
   \[rs] \[dq]hdfs\[dq]
[skip]
Storage> hdfs
** See help for hdfs backend at: https://rclone.org/hdfs **

hadoop name node and port
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / Connect to host namenode at port 8020
   \[rs] \[dq]namenode:8020\[dq]
namenode> namenode.hadoop:8020
hadoop user name
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / Connect to hdfs as root
   \[rs] \[dq]root\[dq]
username> root
Edit advanced config? (y/n)
y) Yes
n) No (default)
y/n> n
Remote config
Configuration complete.
Options:
- type: hdfs
- namenode: namenode.hadoop:8020
- username: root
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
Current remotes:

Name                 Type
====                 ====
hadoop               hdfs

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> q
\f[R]
.fi
.PP
این ریموت \f[V]remote\f[R] نام دارد و اکنون می‌توان به این شکل از آن استفاده کرد
.PP
مشاهده تمام دایرکتوری‌های سطح بالا
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن محتویات یک دایرکتوری
.IP
.nf
\f[C]
rclone ls remote:directory
\f[R]
.fi
.PP
همگام‌سازی \f[V]directory\f[R] ریموت با \f[V]/home/local/directory\f[R]،
همراه با حذف هرگونه فایل اضافه.
.IP
.nf
\f[C]
rclone sync --interactive remote:directory /home/local/directory
\f[R]
.fi.SS راه‌اندازی نمونه HDFS اختصاصی خود برای آزمایش
.PP
می‌توانید با یک راه‌اندازی
دستی (https://hadoop.apache.org/docs/stable/hadoop-project-dist/hadoop-common/SingleCluster.html)
شروع کنید یا از ایمیج docker مربوط به آزمون‌ها استفاده نمایید:
.PP
اگر می‌خواهید ایمیج docker را بسازید:
.IP
.nf
\f[C]
git clone https://github.com/rclone/rclone.git
cd rclone/fstest/testserver/images/test-hdfs
docker build --rm -t rclone/test-hdfs .
\f[R]
.fi
.PP
یا می‌توانید تنها از آخرین نسخه ارسال‌شده استفاده کنید:
.IP
.nf
\f[C]
docker run --rm --name \[dq]rclone-hdfs\[dq] -p 127.0.0.1:9866:9866 -p 127.0.0.1:8020:8020 --hostname \[dq]rclone-hdfs\[dq] rclone/test-hdfs
\f[R]
.fi
.PP
\f[B]نکته:\f[R] برای راه‌اندازی به چند ثانیه زمان نیاز دارد.
.PP
برای این ایمیج docker، ریموت (remote) باید به این صورت پیکربندی شود:
.IP
.nf
\f[C]
[remote]
type = hdfs
namenode = 127.0.0.1:8020
username = root
\f[R]
.fi
.PP
می‌توانید این ایمیج را با \f[V]docker kill rclone-hdfs\f[R] متوقف
کنید (\f[B]نکته:\f[R] این ایمیج از volumeها استفاده نمی‌کند، بنابراین تمام داده‌های
بارگذاری‌شده از دست خواهند رفت.)
.SS زمان‌های تغییر
.PP
زمان با دقت ۱ ثانیه ذخیره می‌شود.
.SS مجموع بررسی (Checksum)
.PP
هیچ مجموع بررسی پیاده‌سازی نشده است.
.SS اطلاعات میزان استفاده
.PP
می‌توانید از دستور \f[V]rclone about remote:\f[R] استفاده کنید که
اندازه سامانه فایل و میزان استفاده فعلی را نمایش می‌دهد.
.SS نویسه‌های غیرمجاز در نام فایل
.PP
علاوه بر مجموعه پیش‌فرض نویسه‌های
غیرمجاز (https://rclone.org/overview/#restricted-characters)، نویسه‌های
زیر نیز جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
:
T}@T{
0x3A
T}@T{
：
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین
خواهند شد (https://rclone.org/overview/#invalid-utf8).
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص به hdfs (سامانه فایل توزیع‌شده Hadoop)
آورده شده‌اند..SS --hdfs-namenode
.PP
گره‌های نام (name nodes) و درگاه‌های Hadoop.
.PP
برای مثال
\[dq]namenode-1:8020,namenode-2:8020,...\[dq] برای اتصال به namenodeهای میزبان روی درگاه 8020.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: namenode
.IP \[bu] 2
متغیر محیطی: RCLONE_HDFS_NAMENODE
.IP \[bu] 2
نوع: CommaSepList
.IP \[bu] 2
پیش‌فرض:
.SS --hdfs-username
.PP
نام کاربری Hadoop.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: username
.IP \[bu] 2
متغیر محیطی: RCLONE_HDFS_USERNAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]root\[dq]
.RS 2
.IP \[bu] 2
اتصال به hdfs با کاربر root.
.RE
.RE
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مخصوص hdfs (سیستم فایل توزیع‌شده Hadoop) آمده است.
.SS --hdfs-service-principal-name
.PP
نام Service Principal مربوط به Kerberos برای namenode.
.PP
احراز هویت KERBEROS را فعال می‌کند.
مشخص‌کننده Service Principal Name (به صورت SERVICE/FQDN) برای namenode است.
برای مثال
\[dq]hdfs/namenode.hadoop.docker\[dq] برای namenode در حال اجرا به عنوان سرویس \[aq]hdfs\[aq] با FQDN معادل \[aq]namenode.hadoop.docker\[aq].
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: service_principal_name
.IP \[bu] 2
متغیر محیطی: RCLONE_HDFS_SERVICE_PRINCIPAL_NAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --hdfs-data-transfer-protection
.PP
حفاظت از انتقال داده در Kerberos: شامل authentication|integrity|privacy.
.PP
مشخص می‌کند که آیا احراز هویت، بررسی یکپارچگی امضای داده و رمزنگاری داده‌های در حال انتقال هنگام ارتباط با datanodeها الزامی است یا خیر.
مقادیر مجاز عبارتند از \[aq]authentication\[aq]، \[aq]integrity\[aq] و \[aq]privacy\[aq].
تنها در صورت فعال بودن KERBEROS استفاده می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: data_transfer_protection
.IP \[bu] 2
متغیر محیطی: RCLONE_HDFS_DATA_TRANSFER_PROTECTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]privacy\[dq]
.RS 2
.IP \[bu] 2
اطمینان از فعال بودن احراز هویت، یکپارچگی و رمزنگاری.
.RE
.RE.SS --hdfs-encoding
.PP
کدگذاری برای بک‌اند.
.PP
برای اطلاعات بیشتر، بخش کدگذاری در بررسی اجمالی (https://rclone.org/overview/#encoding) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_HDFS_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,Colon,Del,Ctl,InvalidUtf8,Dot
.SS --hdfs-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_HDFS_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS "محدودیت‌ها (Limitations)"
.IP \[bu] 2
از Erasure coding پشتیبانی نمی‌شود، گزارش شماره
#8808 (https://github.com/rclone/rclone/issues/8808) را ببینید.
.IP \[bu] 2
عملیات \f[V]Move\f[R] یا \f[V]DirMove\f[R] سمت سرور وجود ندارد.
.IP \[bu] 2
چک‌سام‌ها پیاده‌سازی نشده‌اند.
.SH HiDrive
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند به هر عمق مورد نیازی باشند، مانند
\f[V]remote:directory/subdirectory\f[R].
.PP
راه‌اندازی اولیه HiDrive شامل دریافت یک توکن از HiDrive است
که باید آن را در مرورگر خود انجام دهید.
فرمان \f[V]rclone config\f[R] شما را مرحله به مرحله راهنمایی می‌کند.
.SS "پیکربندی (Configuration)"
.PP
در اینجا نمونه‌ای از نحوه ایجاد یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این فرمان شما را در فرآیند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found - make a new one
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / HiDrive
   \[rs] \[dq]hidrive\[dq]
[snip]
Storage> hidrive
OAuth Client Id - Leave blank normally.
client_id>
OAuth Client Secret - Leave blank normally.
client_secret>
Access permissions that rclone should use when requesting access from HiDrive.
Leave blank normally.
scope_access>
Edit advanced config?
y/n> n
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y/n> y
If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth?state=xxxxxxxxxxxxxxxxxxxxxx
Log in and authorize rclone for access
Waiting for code...
Got code
Configuration complete.
Options:
- type: hidrive
- token: {\[dq]access_token\[dq]:\[dq]xxxxxxxxxxxxxxxxxxxx\[dq],\[dq]token_type\[dq]:\[dq]Bearer\[dq],\[dq]refresh_token\[dq]:\[dq]xxxxxxxxxxxxxxxxxxxxxxx\[dq],\[dq]expiry\[dq]:\[dq]xxxxxxxxxxxxxxxxxxxxxxx\[dq]}
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
\f[B]باید توجه داشته باشید که از توکن‌های OAuth می‌توان برای دسترسی به حساب شما استفاده کرد و بنابراین نباید با افراد دیگر به اشتراک گذاشته شوند.\f[R] برای اطلاعات بیشتر بخش زیر را ببینید.
.PP
برای نحوه راه‌اندازی روی دستگاهی که مرورگر وب متصل به اینترنت در دسترس ندارد، مستندات راه‌اندازی ریموت (https://rclone.org/remote_setup) را ببینید.
.PP
توجه داشته باشید که rclone یک وب‌سرور را روی دستگاه محلی شما اجرا می‌کند تا توکن بازگردانده شده از HiDrive را دریافت کند.
این سرور تنها از لحظه باز شدن مرورگر تا زمان دریافت کد تأیید اجرا می‌شود.
وب‌سرور روی \f[V]http://127.0.0.1:53682\f[R] اجرا می‌شود.
اگر پورت محلی \f[V]53682\f[R] توسط فایروال محافظت شده است، ممکن است برای تکمیل اعتبارسنجی نیاز باشد فایروال را موقتاً باز کنید.
.PP
پس از پیکربندی می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (\f[V]remote\f[R] را با نامی که به ریموت خود داده‌اید جایگزین کنید):
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح از پوشه ریشه HiDrive شما
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در سیستم فایل HiDrive شما
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به دایرکتوری HiDrive به نام backup
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS امن نگه‌داشتن توکن‌ها
.PP
تمام توکن‌های OAuth توسط rclone به صورت متن رمزنگاری‌نشده در فایل
پیکربندی ریموت ذخیره می‌شوند.
هر فردی می‌تواند با داشتن یک refresh-token معتبر، بدون نیاز به دانستن
گذرواژهٔ شما به سیستم‌فایل HiDrive دسترسی پیدا کند.
بنابراین باید اطمینان حاصل کنید که هیچ‌کس دیگری به پیکربندی شما دسترسی
ندارد.
.PP
رمزنگاری فایل پیکربندی rclone امکان‌پذیر است.
می‌توانید با مشاهدهٔ مستندات رمزنگاری پیکربندی
(https://rclone.org/docs/#configuration-encryption) اطلاعات لازم را برای
امن‌سازی فایل پیکربندی خود به دست آورید.
.SS نامعتبر بودن توکن تازه‌سازی (refresh token)
.PP
همان‌طور که در راهنمای OAuth مربوط به HiDrive
(https://developer.hidrive.com/basics-flows) مشخص شده است، هر
\f[V]refresh_token\f[R] (برای Native Applications) به مدت ۶۰ روز اعتبار دارد.
در صورت استفاده برای دسترسی به HiDrive، اعتبار آن به صورت خودکار تمدید
خواهد شد.
.PP
این بدان معناست که اگر:
.IP \[bu] 2
به مدت ۶۰ روز از ریموت HiDrive استفاده نکنید
.PP
آن‌گاه rclone خطایی بازمی‌گرداند که نشان می‌دهد توکن تازه‌سازی (refresh token)
\f[I]نامعتبر (invalid)\f[R] یا \f[I]منقضی (expired)\f[R] شده است.
.PP
برای رفع این مشکل، باید دوباره به rclone اجازهٔ دسترسی به حساب HiDrive خود را
بدهید.
.PP
با اجرای:
.IP
.nf
\f[C]
rclone config reconnect remote:
\f[R]
.fi
.PP
این فرآیند بسیار شبیه به فرآیند راه‌اندازی اولیه است که پیش‌تر نمونهٔ آن
آورده شد.
.SS زمان‌های تغییر و هش‌ها
.PP
سرویس HiDrive اجازه می‌دهد زمان تغییر اشیاء با دقت ۱ ثانیه تنظیم شود.
.PP
سرویس HiDrive از نوع هش اختصاصی خود (https://static.hidrive.com/dev/0001)
پشتیبانی می‌کند که برای بررسی صحت و یکپارچگی محتوای فایل‌ها پس از انتقال
موفق استفاده می‌شود.
.SS نویسه‌های محدودشده در نام فایل
.PP
سرویس HiDrive نمی‌تواند فایل‌ها یا پوشه‌هایی را که در نام خود شامل \f[V]/\f[R]
(0x2F) یا بایت تهی (0x00) هستند ذخیره کند.
استفاده از سایر نویسه‌ها در نام فایل‌ها یا پوشه‌ها مجاز است.
علاوه بر این، فایل‌ها یا پوشه‌ها نمی‌توانند با هیچ‌یک از این موارد نام‌گذاری شوند:
\f[V].\f[R] یا \f[V]..\f[R]
.PP
بنابراین، اگر فایل‌ها یا پوشه‌ها با چنین نام‌هایی ذخیره یا فراخوانی شوند، rclone
به صورت خودکار این نویسه‌ها را جایگزین خواهد کرد.
.PP
برای آگاهی از نحوهٔ عملکرد کلی این کدگذاری نام فایل، می‌توانید به مستندات اصلی
(https://rclone.org/overview/#restricted-filenames) مراجعه کنید.
.PP
به یاد داشته باشید که HiDrive تنها از نام فایل‌ها یا پوشه‌هایی با طول ۲۵۵
نویسه یا کمتر پشتیبانی می‌کند.
.SS انتقال‌ها
.PP
سرویس HiDrive اندازهٔ فایل را در هر درخواست منفرد به حداکثر 2 GiB محدود
می‌کند.
جهت امکان‌پذیر ساختن ذخیره‌سازی فایل‌های بزرگ‌تر و دستیابی به عملکرد بهتر در
بارگذاری، بک‌اند hidrive برای فایل‌های بزرگ‌تر از 96 MiB از روش انتقال
تکه‌تکه (chunked transfer) استفاده خواهد کرد.
دستور rclone چندین بخش/تکه از فایل را به طور هم‌زمان بارگذاری می‌کند.
تکه‌هایی که در حال بارگذاری هستند در حافظه موقت (buffer) قرار می‌گیرند،
بنابراین ممکن است بخواهید در سیستم‌هایی با منابع محدود این رفتار را مهار
کنید.
.PP
می‌توانید این رفتار را با استفاده از گزینه‌های زیر سفارشی‌سازی کنید:
.IP \[bu] 2
\f[V]chunk_size\f[R]: اندازهٔ قطعات فایل
.IP \[bu] 2
\f[V]upload_cutoff\f[R]: فایل‌هایی با اندازهٔ بزرگ‌تر یا برابر با این مقدار
از انتقال تکه‌تکه استفاده خواهند کرد
.IP \[bu] 2
\f[V]upload_concurrency\f[R]: تعداد قطعات فایل که به طور هم‌زمان بارگذاری
می‌شوند
.PP
برای جزئیات بیشتر، بخش زیر دربارهٔ گزینه‌های پیکربندی را ببینید..SS پوشه ریشه (Root folder)
.PP
شما می‌توانید پوشه ریشه را برای rclone تنظیم کنید.
این دایرکتوری همان دایرکتوری‌ای است که rclone آن را به عنوان ریشه HiDrive شما در نظر می‌گیرد.
.PP
معمولاً این مقدار را خالی می‌گذارید و rclone از ریشه حساب کاربری استفاده می‌کند.
.PP
با این حال، می‌توانید این مقدار را تنظیم کنید تا rclone به یک سلسله‌مراتب پوشه‌ای خاص محدود شود.
.PP
روش کار به این صورت است که مقدار گزینه \f[V]root_prefix\f[R] به ابتدای هر مسیری که توسط rclone مورد دسترسی قرار می‌گیرد افزوده می‌شود.
برای نمونه، دو روش زیر برای دسترسی به دایرکتوری خانگی معادل یکدیگر هستند:
.IP
.nf
\f[C]
rclone lsd --hidrive-root-prefix=\[dq]/users/test/\[dq] remote:path
rclone lsd remote:/users/test/path
\f[R]
.fi
.PP
برای جزئیات بیشتر، به بخش زیر درباره گزینه‌های پیکربندی مراجعه کنید.
.SS تعداد اعضای دایرکتوری (Directory member count)
.PP
به‌طور پیش‌فرض، rclone تعداد اعضای موجود در یک دایرکتوری را دریافت می‌کند.
برای نمونه، دستور \f[V]rclone lsd\f[R] از این اطلاعات استفاده می‌کند.
.PP
دریافت این اطلاعات هزینه‌های زمانی مضاعفی را به API سرویس HiDrive تحمیل می‌کند.
هنگام کار با ساختارهای دایرکتوری بزرگ، ممکن است دور زدن این هزینه زمانی مطلوب باشد، به‌ویژه زمانی که این اطلاعات صراحتاً مورد نیاز نباشد.
بدین منظور، می‌توان از گزینه \f[V]disable_fetching_member_count\f[R] استفاده کرد.
.PP
برای جزئیات بیشتر، به بخش زیر درباره گزینه‌های پیکربندی مراجعه کنید.
.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص hidrive (HiDrive) آورده شده است.
.SS --hidrive-client-id
.PP
شناسه کلاینت OAuth (OAuth Client Id).
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --hidrive-client-secret
.PP
کلید مخفی کلاینت OAuth (OAuth Client Secret).
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --hidrive-scope-access
.PP
مجوزهای دسترسی که rclone هنگام درخواست دسترسی از HiDrive باید استفاده کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: scope_access
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_SCOPE_ACCESS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]rw\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]rw\[dq]
.RS 2
.IP \[bu] 2
دسترسی خواندن و نوشتن به منابع.
.RE
.IP \[bu] 2
\[dq]ro\[dq]
.RS 2
.IP \[bu] 2
دسترسی فقط‌خواندنی به منابع.
.RE
.RE.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مخصوص hidrive (HiDrive) آورده شده است.
.SS --hidrive-token
.PP
توکن دسترسی OAuth در قالب داده JSON (JSON blob).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --hidrive-auth-url
.PP
نشانی اینترنتی (URL) سرور احراز هویت.
.PP
برای استفاده از پیش‌فرض‌های ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --hidrive-token-url
.PP
نشانی اینترنتی (URL) سرور توکن.
.PP
برای استفاده از پیش‌فرض‌های ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --hidrive-client-credentials
.PP
استفاده از جریان OAuth مبتنی بر Client Credentials.
.PP
این گزینه از OAUTH2 client Credentials Flow همان‌طور که در RFC
6749 شرح داده شده است استفاده خواهد کرد.
.PP
توجه داشته باشید که این گزینه توسط همه بک‌اندها پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --hidrive-scope-role
.PP
سطح کاربری که rclone هنگام درخواست دسترسی از HiDrive باید استفاده کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: scope_role
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_SCOPE_ROLE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]user\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]user\[dq]
.RS 2
.IP \[bu] 2
دسترسی در سطح کاربر به مجوزهای مدیریتی.
.IP \[bu] 2
این گزینه در بیشتر موارد کافی خواهد بود.
.RE
.IP \[bu] 2
\[dq]admin\[dq]
.RS 2
.IP \[bu] 2
دسترسی گسترده به مجوزهای مدیریتی.
.RE
.IP \[bu] 2
\[dq]owner\[dq]
.RS 2
.IP \[bu] 2
دسترسی کامل به مجوزهای مدیریتی.
.RE
.RE.SS --hidrive-root-prefix
.PP
پوشه ریشه/والد برای تمام مسیرها.
.PP
این گزینه را پر کنید تا از پوشه مشخص‌شده به‌عنوان والد تمام مسیرهای ارائه‌شده به ریموت استفاده شود.
به این ترتیب rclone می‌تواند از هر پوشه‌ای به‌عنوان نقطه شروع خود استفاده کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_prefix
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_ROOT_PREFIX
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]/\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]/\[dq]
.RS 2
.IP \[bu] 2
بالاترین دایرکتوری در دسترس برای rclone.
.IP \[bu] 2
اگر rclone از یک حساب کاربری عادی HiDrive استفاده کند، این مقدار معادل با \[dq]root\[dq] خواهد بود.
.RE
.IP \[bu] 2
\[dq]root\[dq]
.RS 2
.IP \[bu] 2
بالاترین دایرکتوری حساب کاربری HiDrive
.RE
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
مشخص می‌کند که هیچ پیشوند ریشه‌ای (root-prefix) برای مسیرهای شما وجود ندارد.
.IP \[bu] 2
هنگام استفاده از این مقدار، همواره باید مسیرهای این ریموت را با یک والد معتبر مشخص کنید، مانند
\[dq]remote:/path/to/dir\[dq] یا \[dq]remote:root/path/to/dir\[dq].
.RE
.RE
.SS --hidrive-endpoint
.PP
نقطه پایانی (Endpoint) برای سرویس.
.PP
این نشانی اینترنتی (URL) است که فراخوانی‌های API به آن فرستاده خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_ENDPOINT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]https://api.hidrive.strato.com/2.1\[dq]
.SS --hidrive-disable-fetching-member-count
.PP
تعداد اشیاء درون دایرکتوری‌ها را دریافت نکن، مگر آنکه کاملاً ضروری باشد.
.PP
اگر تعداد اشیاء موجود در زیردایرکتوری‌ها واکشی نشود، ممکن است درخواست‌ها سریع‌تر انجام گیرند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_fetching_member_count
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_DISABLE_FETCHING_MEMBER_COUNT
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --hidrive-chunk-size
.PP
اندازه تکه برای بارگذاری‌های تکه‌تکه (chunked).
.PP
هر فایلی بزرگ‌تر از حد آستانه (cutoff) پیکربندی‌شده (یا فایل‌هایی با اندازه نامشخص) در تکه‌هایی با این اندازه بارگذاری خواهد شد.
.PP
حد بالای این مقدار 2147483647 بایت (حدود 2.000Gi) است.
این حداکثر میزان بایتی است که یک عملیات بارگذاری منفرد پشتیبانی می‌کند.
تنظیم این مقدار فراتر از حد مجاز یا بر روی یک مقدار منفی، موجب شکست بارگذاری‌ها خواهد شد.
.PP
تنظیم این گزینه روی مقادیر بزرگ‌تر ممکن است سرعت بارگذاری را به بهای مصرف حافظه بیشتر افزایش دهد.
برای صرفه‌جویی در مصرف حافظه می‌توان آن را بر روی مقادیر کوچک‌تر تنظیم نمود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 48Mi.SS --hidrive-upload-cutoff
.PP
حد آستانه/قطع برای بارگذاری‌های تکه‌ای (chunked).
.PP
هر فایلی بزرگ‌تر از این مقدار باشد، در تکه‌هایی با اندازهٔ تنظیم‌شده در chunksize بارگذاری خواهد شد.
.PP
حد بالای این مقدار 2147483647 بایت (حدود 2.000Gi) است.
این حداکثر میزان بایتی است که یک عملیات بارگذاری منفرد پشتیبانی می‌کند.
تنظیم مقداری بالاتر از این حد بالا، باعث شکست بارگذاری‌ها خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 96Mi
.SS --hidrive-upload-concurrency
.PP
همزمانی برای بارگذاری‌های تکه‌ای (chunked).
.PP
این حد بالا برای تعداد انتقال‌هایی است که می‌توانند برای یک فایل به‌صورت هم‌زمان اجرا شوند.
تنظیم این مقدار روی عددی کوچک‌تر از 1 باعث ایجاد بن‌بست (deadlock) در بارگذاری‌ها خواهد شد.
.PP
اگر تعداد کمی از فایل‌های حجیم را از طریق اتصال‌های پرسرعت بارگذاری می‌کنید و این بارگذاری‌ها به‌طور کامل از پهنای باند شما استفاده نمی‌کنند، افزایش این مقدار می‌تواند به تسریع انتقال‌ها کمک کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_UPLOAD_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 4
.SS --hidrive-encoding
.PP
کدگذاری برای بک‌اند.
.PP
برای اطلاعات بیشتر، بخش کدگذاری را در نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,Dot
.SS --hidrive-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_HIDRIVE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS محدودیت‌ها (Limitations)
.SS پیوندهای نمادین (Symbolic links)
.PP
سرویس HiDrive بر اساس طراحی خود قادر به ذخیرهٔ پیوندهای نمادین (\f[I]symlinks\f[R]) است؛ برای نمونه، هنگامی که از یک بایگانی zip استخراج می‌شوند.
.PP
هیچ سازوکار مستقیمی برای مدیریت پیوندهای نمادین بومی (native) در ریموت‌ها وجود ندارد.
به همین دلیل، این پیاده‌سازی تصمیم گرفته است که هرگونه پیوند نمادین بومی موجود در ریموت را نادیده بگیرد.
ابزار rclone قادر به دسترسی یا نمایش پیوندهای نمادین ذخیره‌شده در ریموت hidrive نخواهد بود.
این بدان معناست که پیوندهای نمادین را نمی‌توان به‌صورت جداگانه حذف کرد، کپی نمود یا انتقال داد، مگر هنگام حذف، کپی یا انتقال پوشهٔ والد آن‌ها.
.PP
\f[I]این مورد روی فایل‌های \f[VI].rclonelink\f[I] که rclone برای کدگذاری و ذخیرهٔ پیوندهای نمادین استفاده می‌کند، تأثیری ندارد.\f[R].SS فایل‌های تنک (Sparse files)
.PP
امکان ذخیره کردن فایل‌های تنک (sparse files) در HiDrive وجود دارد.
.PP
توجه داشته باشید که کپی کردن یک فایل تنک باعث گسترش حفره‌ها به نواحی بایت‌های تهی
(null-byte یا 0x00) خواهد شد که به نوبه خود فضای دیسک را اشغال می‌کنند.
به همین ترتیب، هنگام بارگیری یک فایل تنک، فایل حاصل به جای حفره‌های فایل،
دارای نواحی بایت‌های تهی خواهد بود.
.SH HTTP
.PP
ریموت HTTP یک ریموت فقط‌خواندنی برای خواندن فایل‌های یک وب‌سرور است.
وب‌سرور باید فهرست فایل‌ها را ارائه دهد تا rclone بتواند آن‌ها را خوانده و
به یک ریموت تبدیل کند.
این قابلیت با وب‌سرورهای متداول مانند Apache/Nginx/Caddy آزمایش شده است
و به احتمال زیاد با فهرست فایل‌های اکثر وب‌سرورها کار خواهد کرد.
(اگر کار نکرد، لطفاً یک issue ثبت کنید یا یک pull request ارسال نمایید!)
.PP
مسیرها به صورت \f[V]remote:\f[R] یا \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
عبارت \f[V]remote:\f[R] نشان‌دهنده url پیکربندی‌شده است، و هر مسیری که پس از آن
بیاید، طبق استاندارد URL نسبت به این url حل‌وفصل خواهد شد.
بدین معنا که با url ریموت \f[V]https://beta.rclone.org/branch\f[R] و
مسیر \f[V]fix\f[R]، نشانی حل‌شده برابر با
\f[V]https://beta.rclone.org/branch/fix\f[R] خواهد بود، در حالی که با مسیر
\f[V]/fix\f[R] نشانی نهایی \f[V]https://beta.rclone.org/fix\f[R]
خواهد بود، زیرا مسیر مطلق از ریشه دامنه حل‌وفصل می‌شود.
.PP
اگر مسیری که پس از \f[V]remote:\f[R] می‌آید به \f[V]/\f[R] ختم شود،
فرض می‌شود که به یک دایرکتوری اشاره دارد.
اگر مسیر به \f[V]/\f[R] ختم نشود، یک درخواست HEAD ارسال شده
و از پاسخ آن برای تصمیم‌گیری درباره فایل یا دایرکتوری بودن آن استفاده
می‌شود (برای مشاهده جزئیات با \f[V]-vv\f[R] اجرا کنید).
هنگامی که --http-no-head مشخص شده باشد، مسیری بدون \f[V]/\f[R] پایانی
همیشه به عنوان فایل در نظر گرفته می‌شود.
اگر rclone به اشتباه مسیر را یک فایل فرض کند، راه‌حل این است که
مسیر را با \f[V]/\f[R] در انتها مشخص کنید.
وقتی می‌دانید که مسیر یک دایرکتوری است، پایان دادن به آن با \f[V]/\f[R]
همیشه بهتر است زیرا از درخواست اولیه HEAD جلوگیری می‌کند.
.PP
برای دانلود صرفاً یک فایل تکی، استفاده از
copyurl (<https://rclone.org/commands/rclone_copyurl>) ساده‌تر است.
.SS پیکربندی (Configuration)
.PP
در اینجا نمونه‌ای از نحوه ایجاد یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در مراحل یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / HTTP
   \[rs] \[dq]http\[dq]
[snip]
Storage> http
URL of http host to connect to
Choose a number from below, or type in your own value
 1 / Connect to example.com
   \[rs] \[dq]https://example.com\[dq]
url> https://beta.rclone.org
Remote config
Configuration complete.
Options:
- type: http
- url: https://beta.rclone.org
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
Current remotes:

Name                 Type
====                 ====
remote               http

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> q
\f[R]
.fi
.PP
این ریموت \f[V]remote\f[R] نامیده می‌شود و اکنون می‌توان به این صورت از آن استفاده کرد:
.PP
مشاهده تمام دایرکتوری‌های سطح بالا:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن محتویات یک دایرکتوری:
.IP
.nf
\f[C]
rclone ls remote:directory
\f[R]
.fi
.PP
همگام‌سازی دایرکتوری ریموت \f[V]directory\f[R] با \f[V]/home/local/directory\f[R]،
همراه با حذف فایل‌های اضافی:
.IP
.nf
\f[C]
rclone sync --interactive remote:directory /home/local/directory
\f[R]
.fi.SS فقط‌خواندنی
.PP
این ریموت فقط‌خواندنی است \- شما نمی‌توانید فایل‌ها را در یک سرور HTTP بارگذاری کنید.
.SS سرورهای بدون فهرست‌بندی دایرکتوری
.PP
معمولاً rclone برای یافتن فایل‌ها نیاز دارد که سرور HTTP یک فهرست دایرکتوری قابل تجزیه بازگرداند.
اما اگر مسیر مستقیماً به یک تک فایل اشاره کند (یعنی به \f[V]/\f[R] ختم نشود و درخواست اولیه HEAD آن را به عنوان یک فایل گزارش دهد)، rclone فهرست‌بندی دایرکتوری والد را کاملاً نادیده گرفته و مستقیماً به فایل دسترسی پیدا می‌کند.
.PP
این بدان معناست که تا زمانی که نشانی URL دقیق هر فایل را بدانید، می‌توانید از rclone برای بارگیری فایل‌های مجزا در سرورهای HTTP که فهرست‌بندی دایرکتوری در آن‌ها غیرفعال است استفاده کنید.
برای مثال، سروری را در نظر بگیرید که \f[V]https://example.com/path/file.txt\f[R] را ارائه می‌دهد اما برای \f[V]https://example.com/path/\f[R] یک خطا یا پاسخی غیرقابل تجزیه بازمی‌گرداند:
.IP
.nf
\f[C]
rclone copy --http-url https://example.com :http:path/file.txt /tmp/
\f[R]
.fi
.PP
همچنین می‌توانید از این به عنوان یک ریموت در سایر دستورات rclone نیز استفاده کنید:
.IP
.nf
\f[C]
rclone hashsum crc32 --http-url \[dq]https://getsamplefiles.com\[dq] :archive::http:download/zip/sample-1.zip
\f[R]
.fi
.PP
اگر صرفاً می‌خواهید یک یا چند فایل را از طریق URL بارگیری کنید، استفاده از copyurl (https://rclone.org/commands/rclone_copyurl) کارآمدتر است.
.SS زمان‌های تغییر
.PP
بیشتر سرورهای HTTP زمان را با دقت ۱ ثانیه ذخیره می‌کنند.
.SS چک‌سام (Checksum)
.PP
هیچ چک‌سامی ذخیره نمی‌شود.
.SS استفاده بدون فایل پیکربندی
.PP
از آنجا که ریموت http تنها یک پارامتر پیکربندی دارد، استفاده از آن بدون فایل پیکربندی آسان است:
.IP
.nf
\f[C]
rclone lsd --http-url https://beta.rclone.org :http:
\f[R]
.fi
.PP
یا:
.IP
.nf
\f[C]
rclone lsd :http,url=\[aq]https://beta.rclone.org\[aq]:
\f[R]
.fi
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص http (HTTP) آورده شده است.
.SS --http-url
.PP
نشانی URL میزبان HTTP برای اتصال به آن.
.PP
برای مثال
\[dq]https://example.com\[dq]، یا
\[dq]https://user:pass\[at]example.com\[dq] برای استفاده از یک نام کاربری و
گذرواژه.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: url
.IP \[bu] 2
متغیر محیطی: RCLONE_HTTP_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true.SS --http-no-escape
.PP
نویسه‌های متای URL در نام‌های مسیر اسکیپ (escape) نشوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_escape
.IP \[bu] 2
متغیر محیطی: RCLONE_HTTP_NO_ESCAPE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفتهٔ ویژهٔ http (HTTP) آورده شده است.
.SS --http-headers
.PP
تنظیم سرآیندهای HTTP برای تمامی تراکنش‌ها.
.PP
از این گزینه برای تنظیم سرآیندهای اضافی HTTP در تمام تراکنش‌ها استفاده کنید.
.PP
قالب ورودی، فهرستی جداشده با کاما از جفت‌های کلید,مقدار (key,value) است.
کدگذاری استاندارد CSV (<https://godoc.org/encoding/csv>) می‌تواند استفاده شود.
.PP
برای نمونه، جهت تنظیم Cookie از \[aq]Cookie,name=value\[aq] یا
\[aq]\[dq]Cookie\[dq],\[dq]name=value\[dq]\[aq] استفاده کنید.
.PP
می‌توانید چندین سرآیند را تنظیم کنید، مثلاً:
\[aq]\[dq]Cookie\[dq],\[dq]name=value\[dq],\[dq]Authorization\[dq],\[dq]xxx\[dq]\[aq].
.PP
این سرآیندها تنها به میزبان مشخص‌شده در URL پیکربندی‌شده ارسال می‌شوند.
اگر کارساز به میزبان دیگری (شامل یک زیردامنه یا یک
درگاه متفاوت) هدایت مجدد (redirect) انجام دهد، سرآیندها به آن، یا به هر جهش دیگری در
آن زنجیرهٔ هدایت مجدد ارسال نمی‌شوند.
هنگامی که سرآیندها تنظیم شده باشند، هدایت مجدد از https به http رد می‌شود زیرا
آن‌ها را در قالب متنی آشکار (cleartext) ارسال خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: headers
.IP \[bu] 2
متغیر محیطی: RCLONE_HTTP_HEADERS
.IP \[bu] 2
نوع: CommaSepList
.IP \[bu] 2
پیش‌فرض:
.SS --http-no-slash
.PP
اگر وبگاه نام دایرکتوری‌ها را با / پایان نمی‌دهد، این گزینه را تنظیم کنید.
.PP
اگر وبگاه مقصد شما در انتهای نام دایرکتوری‌ها از /
استفاده نمی‌کند، این گزینه را به کار ببرید.
.PP
علامت / در انتهای یک مسیر، روشی است که rclone به‌طور معمول به کمک آن تفاوت
میان فایل‌ها و دایرکتوری‌ها را تشخیص می‌دهد.
اگر این پرچم تنظیم شود، rclone با تمامی فایل‌های دارای Content-Type:
text/html به عنوان دایرکتوری رفتار کرده و به جای بارگیری،
URLها را از درون آن‌ها می‌خواند.
.PP
توجه داشته باشید که این کار ممکن است سبب شود rclone فایل‌های HTML واقعی را با
دایرکتوری‌ها اشتباه بگیرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_slash
.IP \[bu] 2
متغیر محیطی: RCLONE_HTTP_NO_SLASH
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --http-no-head
.PP
عدم استفاده از درخواست‌های HEAD.
.PP
درخواست‌های HEAD عمدتاً برای یافتن اندازهٔ فایل‌ها در فهرست دایرکتوری استفاده می‌شوند.
اگر بارگذاری وبگاه شما بسیار کند است، می‌توانید این گزینه را امتحان کنید.
در حالت عادی rclone برای هر فایل بالقوه در فهرست دایرکتوری یک درخواست HEAD ارسال می‌کند تا:
.IP \[bu] 2
اندازهٔ آن را بیابد
.IP \[bu] 2
واقعی بودن و وجود آن را بررسی کند
.IP \[bu] 2
بررسی کند که آیا یک دایرکتوری است یا خیر
.PP
اگر این گزینه را تنظیم کنید، rclone درخواست HEAD را انجام نخواهد داد.
این کار باعث می‌شود فهرست کردن دایرکتوری بسیار سریع‌تر انجام گیرد، اما rclone
زمان‌ها یا اندازه‌های هیچ فایلی را نخواهد داشت، و ممکن است برخی فایل‌ها که وجود خارجی
ندارند نیز در فهرست ظاهر شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_head
.IP \[bu] 2
متغیر محیطی: RCLONE_HTTP_NO_HEAD
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --http-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_HTTP_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS متاداده (Metadata)
.PP
کلیدهای متادادهٔ HTTP به حروف بزرگ و کوچک حساس نیستند و همواره با حروف کوچک بازگردانده می‌شوند.
.PP
در اینجا موارد متادادهٔ سیستمی ممکن برای backend مربوط به http آورده شده است.
.PP
.TS
tab(@);
lw(11.1n) lw(11.1n) lw(11.1n) lw(16.6n) lw(20.3n).
T{
نام
T}@T{
راهنما
T}@T{
نوع
T}@T{
مثال
T}@T{
فقط‌خواندنی
T}
_
T{
cache-control
T}@T{
سرآیند Cache-Control
T}@T{
string
T}@T{
no-cache
T}@T{
N
T}
T{
content-disposition
T}@T{
سرآیند Content-Disposition
T}@T{
string
T}@T{
inline
T}@T{
N
T}
T{
content-disposition-filename
T}@T{
نام فایل دریافت‌شده از سرآیند Content-Disposition
T}@T{
string
T}@T{
file.txt
T}@T{
N
T}
T{
content-encoding
T}@T{
سرآیند Content-Encoding
T}@T{
string
T}@T{
gzip
T}@T{
N
T}
T{
content-language
T}@T{
سرآیند Content-Language
T}@T{
string
T}@T{
en-US
T}@T{
N
T}
T{
content-type
T}@T{
سرآیند Content-Type
T}@T{
string
T}@T{
text/plain
T}@T{
N
T}
.TE
.PP
برای اطلاعات بیشتر مستندات متاداده (<https://rclone.org/docs/#metadata>) را ببینید..SS دستورات بک‌اند (Backend commands)
.PP
در این‌جا دستورات مخصوص بک‌اند http آمده است.
.PP
آن‌ها را با این دستور اجرا کنید:
.IP
.nf
\f[C]
rclone backend COMMAND remote:
\f[R]
.fi
.PP
راهنمای زیر توضیح می‌دهد که هر دستور چه آرگومان‌هایی می‌پذیرد.
.PP
برای اطلاعات بیشتر در مورد نحوه ارسال گزینه‌ها و آرگومان‌ها، دستور backend (<https://rclone.org/commands/rclone_backend>) را ببینید.
.PP
این دستورات را می‌توان روی یک بک‌اندِ در حال اجرا با استفاده از دستور rc به صورت backend/command (<https://rclone.org/rc/#backend-command>) اجرا کرد.
.SS set
.PP
دستور set برای به‌روزرسانی پارامترهای پیکربندی (config).
.IP
.nf
\f[C]
rclone backend set remote: [options] [<arguments>+]
\f[R]
.fi
.PP
از این دستور set می‌توان برای به‌روزرسانی پارامترهای پیکربندی یک بک‌اند http در حال اجرا استفاده کرد.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend set remote: [-o opt_name=opt_value] [-o opt_name2=opt_value2]
rclone rc backend/command command=set fs=remote: [-o opt_name=opt_value] [-o opt_name2=opt_value2]
rclone rc backend/command command=set fs=remote: -o url=https://example.com
\f[R]
.fi
.PP
کلیدهای گزینه‌ها دقیقاً همانند فایل پیکربندی نام‌گذاری شده‌اند.
.PP
این دستور هنگام فراخوانی با پارامترهای جدید، اتصال به بک‌اند http را بازسازی می‌کند.
تنها نیاز است پارامترهای جدید ارسال شوند، زیرا مقادیر دیگر به‌طور پیش‌فرض همان مقادیرِ در حال استفاده خواهند بود.
.PP
این دستور چیزی برنمی‌گرداند.
.SS محدودیت‌ها (Limitations)
.PP
دستور \f[V]rclone about\f[R] توسط بک‌اند HTTP پشتیبانی نمی‌شود.
بک‌اندهایی که این قابلیت را ندارند نمی‌توانند فضای خالی را برای یک rclone mount مشخص کنند یا از خط‌مشی \f[V]mfs\f[R] (بیشترین فضای خالی یا most free space) به عنوان عضوی از یک ریموت union در rclone استفاده نمایند.
.PP
فهرست بک‌اندهایی که از rclone about پشتیبانی نمی‌کنند (<https://rclone.org/overview/#optional-features>) و rclone about (<https://rclone.org/commands/rclone_about>) را ببینید.
.SH ImageKit
.PP
این یک بک‌اند برای سرویس ذخیره‌سازی ImageKit.io (<https://imagekit.io>) است.
.PP
سرویس ImageKit.io (<https://imagekit.io>) بهینه‌سازی، تبدیل و تحویل CDN تصاویر و ویدیوها را به صورت آنی (real-time) فراهم می‌کند.
بیش از ۱٬۰۰۰ کسب‌وکار و ۷۰٬۰۰۰ توسعه‌دهنده برای تصاویر و ویدیوهای خود در وب به ImageKit اعتماد دارند.
.PP
برای استفاده از این بک‌اند، لازم است یک حساب کاربری (<https://imagekit.io/registration>) در ImageKit بسازید.
می‌توانید کار را با یک پلن رایگان با محدودیت‌های سخاوتمندانه آغاز کنید.
سپس، همگام با رشد نیازهایتان، به طرحی که بیشترین تطابق را با نیاز شما دارد ارتقا دهید.
جزئیات قیمت‌گذاری (<https://imagekit.io/plans>) را مشاهده کنید.
.SS پیکربندی (Configuration)
.PP
در این‌جا مثالی از انجام پیکربندی imagekit آورده شده است.
.PP
ابتدا یک حساب کاربری در ImageKit.io (<https://imagekit.io>) ایجاد کرده و یک طرح انتخاب کنید.
.PP
باید وارد حساب خود شوید و مقادیر \f[V]publicKey\f[R] و \f[V]privateKey\f[R] را برای حساب کاربری‌تان از بخش توسعه‌دهندگان (developer section) دریافت کنید.
.PP
اکنون اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در مراحل یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter the name for the new remote.
name> imagekit-media-library

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / ImageKit.io
\[rs] (imagekit)
[snip]
Storage> imagekit
  
Option endpoint.
You can find your ImageKit.io URL endpoint in your [dashboard](https://imagekit.io/dashboard/developer/api-keys)
Enter a value.
endpoint> https://ik.imagekit.io/imagekit_id  

Option public_key.
You can find your ImageKit.io public key in your [dashboard](https://imagekit.io/dashboard/developer/api-keys)
Enter a value.
public_key> public_****************************

Option private_key.
You can find your ImageKit.io private key in your [dashboard](https://imagekit.io/dashboard/developer/api-keys)
Enter a value.
private_key> private_****************************

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: imagekit
- endpoint: https://ik.imagekit.io/imagekit_id
- public_key: public_****************************
- private_key: private_****************************

Keep this \[dq]imagekit-media-library\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح Media Library:
.IP
.nf
\f[C]
rclone lsd imagekit-media-library:
\f[R]
.fi
.PP
ساختن یک دایرکتوری جدید:
.IP
.nf
\f[C]
rclone mkdir imagekit-media-library:directory
\f[R]
.fi
.PP
فهرست کردن محتویات یک دایرکتوری:
.IP
.nf
\f[C]
rclone ls imagekit-media-library:directory
\f[R]
.fi.SS زمان تغییر و هش‌ها
.PP
ImageKit هنوز از زمان‌های تغییر یا هش‌ها پشتیبانی نمی‌کند.
.SS چک‌سام‌ها
.PP
هیچ چک‌سامی پشتیبانی نمی‌شود.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص به imagekit (ImageKit.io) آورده شده‌اند.
.SS --imagekit-endpoint
.PP
می‌توانید نشانی پایانی (URL endpoint) ImageKit.io خود را در داشبورد خود بیابید (https://imagekit.io/dashboard/developer/api-keys)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_IMAGEKIT_ENDPOINT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --imagekit-public-key
.PP
می‌توانید کلید عمومی ImageKit.io خود را در داشبورد خود بیابید (https://imagekit.io/dashboard/developer/api-keys)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: public_key
.IP \[bu] 2
متغیر محیطی: RCLONE_IMAGEKIT_PUBLIC_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --imagekit-private-key
.PP
می‌توانید کلید خصوصی ImageKit.io خود را در داشبورد خود بیابید (https://imagekit.io/dashboard/developer/api-keys)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: private_key
.IP \[bu] 2
متغیر محیطی: RCLONE_IMAGEKIT_PRIVATE_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مختص به imagekit (ImageKit.io) آورده شده‌اند.
.SS --imagekit-only-signed
.PP
اگر \f[V]Restrict unsigned image URLs\f[R] را در تنظیمات داشبورد خود پیکربندی کرده‌اید، این مقدار را روی true تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: only_signed
.IP \[bu] 2
متغیر محیطی: RCLONE_IMAGEKIT_ONLY_SIGNED
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --imagekit-versions
.PP
گنجاندن نسخه‌های قدیمی در فهرست دایرکتوری‌ها.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: versions
.IP \[bu] 2
متغیر محیطی: RCLONE_IMAGEKIT_VERSIONS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --imagekit-upload-tags
.PP
برچسب‌هایی که باید به فایل‌های بارگذاری‌شده اضافه شوند، مانند
\[dq]tag1,tag2\[dq].
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_tags
.IP \[bu] 2
متغیر محیطی: RCLONE_IMAGEKIT_UPLOAD_TAGS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --imagekit-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر بخش encoding را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_IMAGEKIT_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,LtGt,DoubleQuote,Dollar,Question,Hash,Percent,BackSlash,Del,Ctl,InvalidUtf8,Dot,SquareBracket
.SS --imagekit-description
.PP
توضیحات remote.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_IMAGEKIT_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS متاداده (Metadata)
.PP
هر متاداده‌ای که توسط remote زیرین پشتیبانی شود خوانده و نوشته می‌شود.
.PP
در ادامه موارد متاداده سیستمی ممکن برای backend مربوط به imagekit آورده شده است.
.PP
.TS
tab(@);
lw(11.1n) lw(11.1n) lw(11.1n) lw(16.6n) lw(20.3n).
T{
نام
T}@T{
راهنما
T}@T{
نوع
T}@T{
مثال
T}@T{
فقط‌خواندنی
T}
_
T{
aws-tags
T}@T{
برچسب‌های تولیدشده توسط هوش مصنوعی با AWS Rekognition مرتبط با تصویر
T}@T{
string
T}@T{
tag1,tag2
T}@T{
\f[B]Y\f[R]
T}
T{
btime
T}@T{
زمان ایجاد فایل خوانده‌شده از سرآیند Last-Modified
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}@T{
\f[B]Y\f[R]
T}
T{
custom-coordinates
T}@T{
مختصات سفارشی فایل
T}@T{
string
T}@T{
0,0,100,100
T}@T{
\f[B]Y\f[R]
T}
T{
file-type
T}@T{
نوع فایل
T}@T{
string
T}@T{
image
T}@T{
\f[B]Y\f[R]
T}
T{
google-tags
T}@T{
برچسب‌های تولیدشده توسط هوش مصنوعی با Google Cloud Vision مرتبط با تصویر
T}@T{
string
T}@T{
tag1,tag2
T}@T{
\f[B]Y\f[R]
T}
T{
has-alpha
T}@T{
آیا تصویر دارای کانال آلفا است یا خیر
T}@T{
bool
T}@T{
T}@T{
\f[B]Y\f[R]
T}
T{
height
T}@T{
ارتفاع تصویر یا ویدیو به پیکسل
T}@T{
int
T}@T{
T}@T{
\f[B]Y\f[R]
T}
T{
is-private-file
T}@T{
آیا فایل خصوصی است یا خیر
T}@T{
bool
T}@T{
T}@T{
\f[B]Y\f[R]
T}
T{
mtime
T}@T{
زمان آخرین تغییر، خوانده‌شده از فیلد updatedAt فایل
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}@T{
\f[B]Y\f[R]
T}
T{
size
T}@T{
اندازه شیء به بایت
T}@T{
int64
T}@T{
T}@T{
\f[B]Y\f[R]
T}
T{
tags
T}@T{
برچسب‌های مرتبط با فایل
T}@T{
string
T}@T{
tag1,tag2
T}@T{
\f[B]Y\f[R]
T}
T{
width
T}@T{
پهنای تصویر یا ویدیو به پیکسل
T}@T{
int
T}@T{
T}@T{
\f[B]Y\f[R]
T}
.TE.PP
برای اطلاعات بیشتر، مستندات فراداده (<https://rclone.org/docs/#metadata>) را ببینید.
.SH "iCloud Drive و Photos"
.SS "پیکربندی (Configuration)"
.PP
راه‌اندازی اولیه برای یک backend مربوط به iCloud، شامل دریافت یک توکن/نشست معتمد (trust token/session) است.
در این فرایند از گذرواژه معمول Apple ID شما به همراه احراز هویت دو مرحله‌ای (2FA) استفاده می‌شود که از طریق اعلان در دستگاه مورد اعتماد یا کد پیامک‌شده به شماره تلفن مورد اعتماد تأیید می‌گردد.
.PP
\f[B]مهم\f[R]: گذرواژه‌های ویژه برنامه (App-specific passwords) پذیرفته نمی‌شوند.
تنها از گذرواژه معمول Apple ID خود و 2FA استفاده کنید.
.PP
این backend برای دو سرویس شرکت Apple به کار می‌رود:
.IP \[bu] 2
\f[V]drive\f[R] \- سرویس iCloud Drive (پیش‌فرض)
.IP \[bu] 2
\f[V]photos\f[R] \- سرویس iCloud Photos
.PP
دستور \f[V]rclone config\f[R] شما را در مراحل ایجاد توکن راهنمایی می‌کند.
توکن معتمد به مدت ۳۰ روز معتبر است.
پس از این مدت باید با استفاده از \f[V]rclone reconnect\f[R] یا \f[V]rclone config\f[R] مجدداً احراز هویت کنید.
.SS "احراز هویت (Authentication)"
.PP
ابزار rclone با استفاده از پروتکل SRP (گذرواژه امن از راه دور / Secure Remote Password) (<https://en.wikipedia.org/wiki/Secure_Remote_Password_protocol>) با Apple احراز هویت می‌کند؛ همان پروتکلی که توسط رابط وب iCloud استفاده می‌شود.
گذرواژه شما هرگز به کارسازهای Apple ارسال نمی‌شود \-\- در عوض، یک اثبات رمزنگاری مبادله می‌شود که بدون افشای گذرواژه، دانستن آن را تأیید می‌کند.
.PP
مراحل احراز هویت عبارت است از:
.IP "1." 3
ابزار rclone نشستی را با سرویس هویت سنجی Apple آغاز می‌کند
.IP "2." 3
تبادل کلید SRP انجام می‌شود (گذرواژه شما به‌صورت محلی برای تولید کلید به کار می‌رود)
.IP "3." 3
شرکت Apple اعلانی برای 2FA به دستگاه‌های مورد اعتماد شما ارسال می‌کند، یا امکان درخواست کد از طریق پیامک را فراهم می‌سازد
.IP "4." 3
پس از ورود کد 2FA، ابزار rclone یک توکن معتمد برای نشست‌های بعدی دریافت می‌کند
.PP
در اینجا نمونه‌ای از نحوه ایجاد یک ریموت Photos به نام
\f[V]icloudphotos\f[R] آورده شده است.
برای iCloud Drive، مقدار \f[V]service\f[R] را روی مقدار پیش‌فرض آن یعنی
\f[V]drive\f[R] باقی بگذارید.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در فرایند راه‌اندازی تعاملی هدایت می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> icloudphotos
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / iCloud Drive
   \[rs] (iclouddrive)
[snip]
Storage> iclouddrive
Option service.
iCloud service to use.
Choose a number from below, or type in your own value of type string.
Press Enter for the default (drive).
 1 / iCloud Drive
   \[rs] (drive)
 2 / iCloud Photos
   \[rs] (photos)
service> 2
Option apple_id.
Apple ID.
Enter a value.
apple_id> APPLEID  
Option password.
Password.
Choose an alternative below.
y) Yes, type in my own password
g) Generate random password
y/g> y
Enter the password:
password:
Confirm the password:
password:
Edit advanced config?
y) Yes
n) No (default)
y/n> n
Option config_2fa.
Two-factor authentication: enter your 2FA code or type \[aq]sms\[aq] for a text message
Enter a value.
config_2fa> 2FACODE
Remote config
--------------------
[icloudphotos]
- type: iclouddrive
- service: photos
- apple_id: APPLEID
- password: *** ENCRYPTED ***
- cookies: ****************************
- trust_token: ****************************
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS تصاویر آی‌کلاد (iCloud Photos)
.PP
بک‌اند iCloud Drive همچنین از دسترسی به iCloud Photos با
تنظیم گزینهٔ \f[V]service\f[R] روی \f[V]photos\f[R] پشتیبانی می‌کند:
.IP
.nf
\f[C]
rclone lsd iclouddrive: --iclouddrive-service photos
\f[R]
.fi
.PP
این پیکربندی یک سلسله‌مراتب فقط‌خواندنی با ریشه در کتابخانه‌های عکس را نمایش می‌دهد:
.IP \[bu] 2
\f[B]سطح ۱\f[R]: کتابخانه‌های عکس \[em] کتابخانهٔ شخصی شما
(\f[V]PrimarySync\f[R]) و هرگونه کتابخانهٔ عکس اشتراکی
(\f[V]SharedSync-XXXX\f[R])
.IP \[bu] 2
\f[B]سطح ۲+\f[R]: آلبوم‌ها و پوشه‌های درون یک کتابخانه، به‌صورت
تودرتو و بازگشتی همانند Apple Photos
.IP \[bu] 2
\f[B]سطح برگ\f[R]: عکس‌ها/ویدیوهای درون یک آلبوم، شامل فایل‌های همراه
\f[V].MOV\f[R] برای Live Photo
.PP
مثال‌ها:
.IP
.nf
\f[C]
# فهرست کتابخانه‌ها
rclone lsd iclouddrive: --iclouddrive-service photos

# فهرست آلبوم‌ها در کتابخانه اصلی شما
rclone lsd iclouddrive:PrimarySync/ --iclouddrive-service photos

# فهرست عکس‌ها در یک آلبوم
rclone ls iclouddrive:PrimarySync/All\[rs] Photos/ --iclouddrive-service photos

# بارگیری یک عکس
rclone copy iclouddrive:PrimarySync/Favorites/IMG_0001.HEIC /tmp/ --iclouddrive-service photos
\f[R]
.fi
.PP
شما می‌توانید یکی از این دو کار را انجام دهید:
.IP \[bu] 2
تنظیم \f[V]service = photos\f[R] در \f[V]rclone config\f[R] برای یک
ریموت اختصاصی Photos
.IP \[bu] 2
نگه‌داشتن \f[V]service = drive\f[R] و ارسال
\f[V]--iclouddrive-service photos\f[R] در هنگام نیاز
.SS متاداده (Metadata)
.PP
با گزینهٔ \f[V]--metadata\f[R]، مدخل‌های Photos این کلیدهای
متادادهٔ فقط‌خواندنی را ارائه می‌دهند:
.IP \[bu] 2
\f[V]width\f[R]
.IP \[bu] 2
\f[V]height\f[R]
.IP \[bu] 2
\f[V]added-time\f[R]
.IP \[bu] 2
\f[V]favorite\f[R]
.IP \[bu] 2
\f[V]hidden\f[R]
.PP
این کلیدهای متاداده تنها زمانی در دسترس هستند که \f[V]service = photos\f[R] باشد.
.SS حافظه پنهان (Caching)
.PP
سرویس iCloud Photos فهرست آلبوم‌ها را برای دسترسی سریع‌تر بعدی در دیسک ذخیره می‌کند.
در نخستین اجرا، فهرست‌کردن یک آلبوم بزرگ از افرازهای موازی
\f[V]startRank\f[R] برای واکشی هم‌زمان صفحه‌ها استفاده می‌کند.
پس از آن، یک بررسی سبک تغییرات (\[ti]200ms) مشخص می‌کند که آیا
حافظه پنهان همچنان معتبر است یا خیر.
.PP
محل حافظه پنهان:
\f[V]\[ti]/.cache/rclone/iclouddrive-photos/<remote>/<zone>/\f[R]
.PP
برای پاک‌کردن حافظه پنهان: آن دایرکتوری را حذف کنید یا دستور
\f[V]rclone config reconnect\f[R] را اجرا نمایید.
.SS سوار کردن با FUSE (FUSE mounts)
.PP
برای سوار کردن iCloud Photos از طریق \f[V]rclone mount\f[R]، پرچم‌های
زیر توصیه می‌شوند:
.IP
.nf
\f[C]
rclone mount remote: /mnt/photos \[rs]
    --iclouddrive-service photos \[rs]
    --vfs-refresh \[rs]
    --dir-cache-time 1h \[rs]
    --vfs-cache-mode full \[rs]
    --attr-timeout 1m \[rs]
    --read-only
\f[R]
.fi
.IP \[bu] 2
\f[V]--vfs-refresh\f[R] حافظه پنهان دایرکتوری‌ها را در زمان آغاز سوار شدن
در پس‌زمینه از پیش آماده می‌کند تا آلبوم‌ها هنگام مرور آماده باشند
.IP \[bu] 2
\f[V]--dir-cache-time 1h\f[R] مدت‌زمان ماندگاری حافظه پنهان در حافظه
(in-memory) را فراتر از مقدار پیش‌فرض ۵ دقیقه افزایش می‌دهد (تشخیص تغییرات سریع است، بنابراین این کار ایمن است)
.IP \[bu] 2
\f[V]--vfs-cache-mode full\f[R] عکس‌ها و ویدیوهای بارگیری‌شده را برای
دسترسی مکرر سریع روی دیسک محلی ذخیره می‌کند
.IP \[bu] 2
\f[V]--attr-timeout 1m\f[R] درخواست‌های بررسی مشخصه‌های هسته را کاهش می‌دهد
(ایمن است زیرا بک‌اند فقط‌خواندنی است)
.IP \[bu] 2
\f[V]--read-only\f[R] از خطاهای گیج‌کنندهٔ نوشتن جلوگیری می‌کند
.PP
اولین فهرست‌کردن یک آلبوم بسیار بزرگ (مانند
۷۵٬۰۰۰ مورد در \[dq]All Photos\[dq]) به دلیل محدودیت‌های صفحه‌بندی API می‌تواند چند دقیقه طول بکشد.
این اتفاق فقط یک‌بار رخ می‌دهد \[em] فهرست‌کردن‌های بعدی از حافظه پنهان روی دیسک استفاده می‌کنند..SS محدودیت‌ها
.PP
سرویس iCloud Photos فقط‌خواندنی است.
عملیات‌های بارگذاری، حذف، تغییر نام و جابه‌جایی پشتیبانی نمی‌شوند.
.SS حفاظت پیشرفته از داده‌ها (Advanced Data Protection)
.PP
قابلیت حفاظت پیشرفته از داده‌ها (Advanced Data Protection) پشتیبانی می‌شود.
.PP
در iPhone، مسیر Settings \f[V]>\f[R] Apple Account \f[V]>\f[R] iCloud
\f[V]>\f[R] \[aq]Access iCloud Data on the Web\[aq] باید روشن (ON) باشد.
.PP
اگر ADP روی حساب شما فعال باشد، rclone پس از اعتبارسنجی دومرحله‌ای (2FA) کوکی‌های PCS را درخواست می‌کند.
Apple ممکن است پیش از صدور این کوکی‌ها، به تأیید در یک دستگاه مورد اعتماد نیاز داشته باشد.
.SS عیب‌یابی
.SS خطاهای کوکی PCS با ADP
.PP
اگر پیام \f[V]Missing PCS cookies from the request\f[R] یا خطای
\f[V]requestPCS:\f[R] را مشاهده کردید، فرایند تأیید ADP با موفقیت
انجام نشده است.
.PP
بررسی کنید که \[aq]Access iCloud Data on the Web\[aq] فعال باشد و
هرگونه درخواست تأیید را در دستگاه مورد اعتماد خود بپذیرید.
.PP
سپس \f[V]rclone reconnect remote:\f[R] را اجرا کنید.
.PP
اگر ریموت همچنان وضعیت احراز هویت قدیمی دارد، فیلدهای \f[V]cookies\f[R]
و \f[V]trust_token\f[R] را در پیکربندی پاک کنید، یا ریموت را حذف کرده و دوباره
آن را بسازید.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد اختصاصی iclouddrive (شامل iCloud Drive و
Photos) آمده است.
.SS --iclouddrive-service
.PP
سرویس iCloud مورد استفاده.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: service
.IP \[bu] 2
متغیر محیطی: RCLONE_ICLOUDDRIVE_SERVICE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]drive\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]drive\[dq]
.RS 2
.IP \[bu] 2
iCloud Drive
.RE
.IP \[bu] 2
\[dq]photos\[dq]
.RS 2
.IP \[bu] 2
iCloud Photos
.RE
.RE
.SS --iclouddrive-apple-id
.PP
شناسه Apple ID.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: apple_id
.IP \[bu] 2
متغیر محیطی: RCLONE_ICLOUDDRIVE_APPLE_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --iclouddrive-password
.PP
گذرواژه.
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی شود \- به rclone
obscure (https://rclone.org/commands/rclone_obscure) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: password
.IP \[bu] 2
متغیر محیطی: RCLONE_ICLOUDDRIVE_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مربوط به iclouddrive (شامل iCloud Drive و
Photos) آمده است.
.SS --iclouddrive-client-id
.PP
شناسه کلاینت (Client ID) برای دسترسی به API سرویس iCloud.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_ICLOUDDRIVE_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض:
\[dq]d39ba9916b7251055b22c7f910e2ea796ee65e98b2ddecea8f5dde8d9d1a815d\[dq]
.SS --iclouddrive-encoding
.PP
کدگذاری برای پس‌بخش (backend).
.PP
برای اطلاعات بیشتر بخش کدگذاری را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_ICLOUDDRIVE_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot
.SS --iclouddrive-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_ICLOUDDRIVE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS فراداده (Metadata)
.PP
فراداده فقط‌خواندنی است و تنها برای سرویس Photos در دسترس می‌باشد.
.PP
در اینجا موارد فراداده سیستمی ممکن برای پس‌بخش iclouddrive آمده است.
.PP
.TS
tab(@);
lw(11.1n) lw(11.1n) lw(11.1n) lw(16.6n) lw(20.3n).
T{
نام
T}@T{
راهنما
T}@T{
نوع
T}@T{
مثال
T}@T{
فقط‌خواندنی
T}
_
T{
added-time
T}@T{
زمان افزوده‌شدن مورد به کتابخانه iCloud
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05Z
T}@T{
\f[B]Y\f[R]
T}
T{
favorite
T}@T{
مشخص می‌کند که آیا مورد به عنوان موردعلاقه علامت‌گذاری شده است یا خیر
T}@T{
bool
T}@T{
T}@T{
\f[B]Y\f[R]
T}
T{
height
T}@T{
ارتفاع تصویر به پیکسل
T}@T{
int
T}@T{
T}@T{
\f[B]Y\f[R]
T}
T{
hidden
T}@T{
مشخص می‌کند که آیا مورد پنهان است یا خیر
T}@T{
bool
T}@T{
T}@T{
\f[B]Y\f[R]
T}
T{
width
T}@T{
عرض تصویر به پیکسل
T}@T{
int
T}@T{
T}@T{
\f[B]Y\f[R]
T}
.TE
.PP
برای اطلاعات بیشتر مستندات فراداده (https://rclone.org/docs/#metadata) را ببینید..SH "اینترنت آرشیو (Internet Archive)"
.PP
بک‌اند Internet Archive از آیتم‌های روی
archive.org (<https://archive.org>) استفاده می‌کند.
.PP
برای API مورد استفاده این بک‌اند، به مستندات
IAS3 API (<https://archive.org/services/docs/api/ias3.html>) مراجعه کنید.
.PP
مسیرها به صورت \f[V]remote:bucket\f[R] (یا \f[V]remote:\f[R] برای
دستور \f[V]lsd\f[R]) مشخص می‌شوند.
همچنین می‌توانید زیرشاخه‌ها را نیز درج کنید، به عنوان مثال
\f[V]remote:item/path/to/dir\f[R].
.PP
برخلاف S3، فهرست کردن تمام آیتم‌های بارگذاری‌شده توسط شما پشتیبانی نمی‌شود.
.PP
پس از ساخت یک ریموت، می‌توانید به این شکل از آن استفاده کنید:
.PP
ایجاد یک آیتم جدید
.IP
.nf
\f[C]
rclone mkdir remote:item
\f[R]
.fi
.PP
فهرست کردن محتویات یک آیتم
.IP
.nf
\f[C]
rclone ls remote:item
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با آیتم ریموت، و حذف هرگونه
فایل اضافی در آیتم.
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory remote:item
\f[R]
.fi
.SS "نکات (Notes)"
.PP
به دلیل معماری Internet Archive، این سرویس عملیات‌های نوشتن
(و پردازش‌های پسین اضافی) را در یک صف به ازای هر آیتم قرار می‌دهد.
می‌توانید صف آیتم را در
<https://catalogd.archive.org/history/item-name-here> بررسی کنید.
به همین دلیل، همه بارگذاری‌ها/حذف‌ها بلافاصله نمایش داده نمی‌شوند و
در دسترس قرار گرفتن آن‌ها مدتی زمان می‌برد.
صف هر آیتم در صف دیگری به نام Item Deriver Queue قرار می‌گیرد.
می‌توانید وضعیت صف Item Deriver Queue را در
اینجا (<https://catalogd.archive.org/catalog.php?whereami=1>) بررسی کنید. این صف
دارای محدودیت است و ممکن است مانع از بارگذاری یا حتی حذف توسط شما شود.
برای عملکرد بهتر، باید از بارگذاری تعداد زیادی فایل کوچک خودداری کنید.
.PP
می‌توانید با تنظیم مقداری غیرصفر برای کلید \f[V]wait_archive\f[R]،
به صورت اختیاری منتظر بمانید تا پردازش سرور به پایان برسد.
با منتظر نگه داشتن آن، rclone می‌تواند مقایسه عادی فایل‌ها را انجام دهد.
اطمینان حاصل کنید که مقدار به اندازه کافی بزرگی (مثلاً
\f[V]30m0s\f[R] برای فایل‌های کوچک‌تر) تنظیم کرده باشید، زیرا بسته
به صف سرور ممکن است زمان زیادی طول بکشد.
.SS "درباره فراداده (About metadata)"
.PP
این بک‌اند از تنظیم، به‌روزرسانی و خواندن فراداده (metadata) هر
فایل پشتیبانی می‌کند.
این فراداده به صورت فراداده فایل در Internet Archive نمایش داده خواهد شد.
با این حال، برخی فیلدها توسط هر دو سرویس Internet Archive و rclone رزرو شده‌اند.
.PP
موارد زیر توسط Internet Archive رزرو شده‌اند:
.IP \[bu] 2
\f[V]name\f[R]
.IP \[bu] 2
\f[V]source\f[R]
.IP \[bu] 2
\f[V]size\f[R]
.IP \[bu] 2
\f[V]md5\f[R]
.IP \[bu] 2
\f[V]crc32\f[R]
.IP \[bu] 2
\f[V]sha1\f[R]
.IP \[bu] 2
\f[V]format\f[R]
.IP \[bu] 2
\f[V]old_version\f[R]
.IP \[bu] 2
\f[V]viruscheck\f[R]
.IP \[bu] 2
\f[V]summation\f[R]
.PP
تلاش برای مقداردهی این کلیدها با یک هشدار نادیده گرفته می‌شود.
تنها تنظیم \f[V]mtime\f[R] یک استثنا است.
انجام این کار رفتاری یکسان با تنظیم ModTime خواهد داشت.
.PP
ابزار rclone تمام کلیدهایی را که با \f[V]rclone-\f[R] شروع می‌شوند رزرو می‌کند.
مقداردهی به این کلیدها هشدارهایی در پی خواهد داشت، اما مقادیر
طبق درخواست تنظیم می‌شوند.
.PP
اگر چندین مقدار برای یک کلید وجود داشته باشد، فقط مقدار اول برگردانده می‌شود.
این یک محدودیت در rclone است که تنها از یک مقدار برای هر کلید پشتیبانی می‌کند.
این وضعیت ممکن است در زمان انجام کپی سمت سرور فعال شود.
.PP
خواندن فراداده همچنین مقادیر سفارشی (که غیراستاندارد بوده و رزرو نشده‌اند) را
نیز فراهم می‌کند..SS فیلتر کردن فایل‌های تولیدشده به‌صورت خودکار
.PP
سرویس Internet Archive پس از بارگذاری به‌طور خودکار فایل‌های متادیتا ایجاد می‌کند.
این امر می‌تواند هنگام اجرای \f[V]rclone sync\f[R] مشکلاتی ایجاد کند، چرا که rclone
برای حذف آن‌ها تلاش می‌کند و ناموفق می‌ماند.
این فایل‌های متادیتا تغییرپذیر نیستند، زیرا به‌صورت خودکار توسط
Internet Archive ایجاد می‌شوند.
.PP
این فایل‌های ایجادشده خودکار را می‌توان با استفاده از فیلتر کردن متادیتا
(<https://rclone.org/filtering/#metadata>) از همگام‌سازی مستثنی کرد.
.IP
.nf
\f[C]
rclone sync ... --metadata-exclude \[dq]source=metadata\[dq] --metadata-exclude \[dq]format=Metadata\[dq]
\f[R]
.fi
.PP
این دستور تمام فایل‌هایی را که دارای پرچم‌های
\f[V]source=metadata\f[R] یا \f[V]format=Metadata\f[R] هستند (که
به فایل‌های خودکار تولیدشده Internet Archive اضافه می‌شوند)، از همگام‌سازی خارج می‌کند.
.SS پیکربندی
.PP
در اینجا نمونه‌ای از ایجاد یک پیکربندی internetarchive آورده شده است.
بخش عمده آن برای سایر ارائه‌دهندگان نیز صدق می‌کند و هرگونه تفاوت
در ادامه شرح داده شده است.
.PP
ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرآیند راه‌اندازی تعاملی راهنمایی خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
XX / InternetArchive Items
   \[rs] (internetarchive)
Storage> internetarchive
Option access_key_id.
IAS3 Access Key.
Leave blank for anonymous access.
You can find one here: https://archive.org/account/s3.php
Enter a value. Press Enter to leave empty.
access_key_id> XXXX
Option secret_access_key.
IAS3 Secret Key (password).
Leave blank for anonymous access.
Enter a value. Press Enter to leave empty.
secret_access_key> XXXX
Edit advanced config?
y) Yes
n) No (default)
y/n> y
Option endpoint.
IAS3 Endpoint.
Leave blank for default value.
Enter a string value. Press Enter for the default (https://s3.us.archive.org).
endpoint> 
Option front_endpoint.
Host of InternetArchive Frontend.
Leave blank for default value.
Enter a string value. Press Enter for the default (https://archive.org).
front_endpoint> 
Option disable_checksum.
Don\[aq]t store MD5 checksum with object metadata.
Normally rclone will calculate the MD5 checksum of the input before
uploading it so it can ask the server to check the object against checksum.
This is great for data integrity checking but can cause long delays for
large files to start uploading.
Enter a boolean value (true or false). Press Enter for the default (true).
disable_checksum> true
Option encoding.
The encoding for the backend.
See the [encoding section in the overview](https://rclone.org/overview/#encoding) for more info.
Enter a encoder.MultiEncoder value. Press Enter for the default (Slash,Question,Hash,Percent,Del,Ctl,InvalidUtf8,Dot).
encoding> 
Edit advanced config?
y) Yes
n) No (default)
y/n> n
Configuration complete.
Options:
- type: internetarchive
- access_key_id: XXXX
- secret_access_key: XXXX
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS "گزینه‌های استاندارد (Standard options)"
.PP
در اینجا گزینه‌های استاندارد مختص internetarchive (Internet Archive) آورده شده است.
.SS --internetarchive-access-key-id
.PP
کلید دسترسی IAS3.
.PP
برای دسترسی ناشناس، خالی بگذارید.
می‌توانید یکی را از اینجا دریافت کنید: https://archive.org/account/s3.php
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: access_key_id
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNETARCHIVE_ACCESS_KEY_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --internetarchive-secret-access-key
.PP
کلید مخفی IAS3 (گذرواژه).
.PP
برای دسترسی ناشناس، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: secret_access_key
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNETARCHIVE_SECRET_ACCESS_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --internetarchive-item-derive
.PP
اینکه آیا فرایند اشتقاق (derive) روی آیتم IA اجرا شود یا خیر.
اگر روی false تنظیم شود، آیتم پس از بارگذاری توسط IA مشتق (derive) نخواهد شد.
فرایند اشتقاق، تعدادی فایل ثانویه از بارگذاری ایجاد می‌کند تا استفاده از آن در وب کاربردی‌تر شود.
تنظیم این گزینه روی false برای بارگذاری فایل‌هایی مفید است که از قبل در قالبی هستند که IA می‌تواند آن‌ها را نمایش دهد، یا برای کاهش بار روی زیرساخت IA مفید است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: item_derive
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNETARCHIVE_ITEM_DERIVE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS "گزینه‌های پیشرفته (Advanced options)"
.PP
در اینجا گزینه‌های پیشرفته مختص internetarchive (Internet Archive) آورده شده است.
.SS --internetarchive-endpoint
.PP
نقطه پایانی IAS3.
.PP
برای مقدار پیش‌فرض، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNETARCHIVE_ENDPOINT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]https://s3.us.archive.org\[dq]
.SS --internetarchive-front-endpoint
.PP
میزبان بخش کاربری (Frontend) متعلق به InternetArchive.
.PP
برای مقدار پیش‌فرض، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: front_endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNETARCHIVE_FRONT_ENDPOINT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]https://archive.org\[dq].SS --internetarchive-item-metadata
.PP
متاداده‌ای که باید روی آیتم IA تنظیم شود؛ این با متاداده در سطح فایل که با استفاده از --metadata-set تنظیم می‌شود، متفاوت است.
قالب به صورت key=value است و پیشوند \[aq]x-archive-meta-\[aq] به‌طور خودکار اضافه می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: item_metadata
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNETARCHIVE_ITEM_METADATA
.IP \[bu] 2
نوع: stringArray
.IP \[bu] 2
پیش‌فرض: []
.SS --internetarchive-disable-checksum
.PP
از سرور درخواست نشود که داده را در برابر چک‌سام MD5 محاسبه‌شده توسط rclone بررسی کند.
به‌طور معمول rclone پیش از بارگذاری ورودی، چک‌سام MD5 آن را محاسبه می‌کند تا بتواند از سرور بخواهد شیء را در برابر چک‌سام ارزیابی کند.
این قابلیت برای بررسی یکپارچگی داده‌ها عالی است اما می‌تواند باعث ایجاد تأخیرهای طولانی در آغاز بارگذاری فایل‌های بزرگ شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_checksum
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNETARCHIVE_DISABLE_CHECKSUM
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --internetarchive-wait-archive
.PP
مهلت زمانی برای انتظار جهت اتمام وظایف پردازشی سرور (به‌ویژه archive و book_op).
تنها در صورتی فعال کنید که لازم باشد اعمال قطعی تغییرات پس از عملیات نوشتن تضمین شود.
0 برای غیرفعال کردن انتظار.
در صورت به پایان رسیدن مهلت زمانی، هیچ خطایی ایجاد نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: wait_archive
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNETARCHIVE_WAIT_ARCHIVE
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 0s
.SS --internetarchive-encoding
.PP
کدگذاری برای بک‌اند.
.PP
برای اطلاعات بیشتر، بخش کدگذاری را در نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNETARCHIVE_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,LtGt,CrLf,Del,Ctl,InvalidUtf8,Dot
.SS --internetarchive-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNETARCHIVE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS "متادیتا (Metadata)"
.PP
فیلدهای متادیتای ارائه‌شده توسط Internet Archive.
اگر برای یک کلید چندین مقدار وجود داشته باشد، فقط نخستین مقدار بازگردانده می‌شود.
این محدودیت Rclone است که برای هر کلید تنها از یک مقدار پشتیبانی می‌کند.
.PP
مالک می‌تواند کلیدهای سفارشی اضافه کند.
قابلیت متادیتا تمامی کلیدها از جمله این موارد را دریافت می‌کند.
.PP
در اینجا موارد متادیتای سیستمی ممکن برای بک‌اند internetarchive
آمده است.
.PP
.TS
tab(@);
lw(11.1n) lw(11.1n) lw(11.1n) lw(16.6n) lw(20.3n).
T{
نام
T}@T{
راهنما
T}@T{
نوع
T}@T{
مثال
T}@T{
فقط‌خواندنی
T}
_
T{
crc32
T}@T{
مقدار CRC32 محاسبه‌شده توسط Internet Archive
T}@T{
string
T}@T{
01234567
T}@T{
\f[B]Y\f[R]
T}
T{
format
T}@T{
نام قالب شناسایی‌شده توسط Internet Archive
T}@T{
string
T}@T{
Comma-Separated Values
T}@T{
\f[B]Y\f[R]
T}
T{
md5
T}@T{
هش MD5 محاسبه‌شده توسط Internet Archive
T}@T{
string
T}@T{
01234567012345670123456701234567
T}@T{
\f[B]Y\f[R]
T}
T{
mtime
T}@T{
زمان آخرین تغییر، مدیریت‌شده توسط Rclone
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z
T}@T{
\f[B]Y\f[R]
T}
T{
name
T}@T{
مسیر کامل فایل، بدون بخش bucket
T}@T{
filename
T}@T{
backend/internetarchive/internetarchive.go
T}@T{
\f[B]Y\f[R]
T}
T{
old_version
T}@T{
این‌که آیا فایل توسط پرچم keep-old-version جایگزین و منتقل شده است یا خیر
T}@T{
boolean
T}@T{
true
T}@T{
\f[B]Y\f[R]
T}
T{
rclone-ia-mtime
T}@T{
زمان آخرین تغییر، مدیریت‌شده توسط Internet Archive
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z
T}@T{
N
T}
T{
rclone-mtime
T}@T{
زمان آخرین تغییر، مدیریت‌شده توسط Rclone
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z
T}@T{
N
T}
T{
rclone-update-track
T}@T{
مقدار تصادفی استفاده‌شده توسط Rclone برای ردیابی تغییرات در Internet Archive
T}@T{
string
T}@T{
aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
T}@T{
N
T}
T{
sha1
T}@T{
هش SHA1 محاسبه‌شده توسط Internet Archive
T}@T{
string
T}@T{
0123456701234567012345670123456701234567
T}@T{
\f[B]Y\f[R]
T}
T{
size
T}@T{
اندازه فایل بر حسب بایت
T}@T{
decimal number
T}@T{
123456
T}@T{
\f[B]Y\f[R]
T}
T{
source
T}@T{
منبع فایل
T}@T{
string
T}@T{
original
T}@T{
\f[B]Y\f[R]
T}
T{
summation
T}@T{
برای نحوه استفاده به https://forum.rclone.org/t/31922 مراجعه کنید
T}@T{
string
T}@T{
md5
T}@T{
\f[B]Y\f[R]
T}
T{
viruscheck
T}@T{
آخرین باری که فرایند viruscheck برای فایل اجرا شد (؟)
T}@T{
unixtime
T}@T{
1654191352
T}@T{
\f[B]Y\f[R]
T}
.TE.PP
برای اطلاعات بیشتر، مستندات متاداده (https://rclone.org/docs/#metadata) را ببینید.
.SH "درایو Internxt (Internxt Drive)"
.PP
سرویس Internxt Drive (https://internxt.com) یک سرویس ذخیره‌سازی ابری با رمزنگاری دانش‌صفر (zero-knowledge) است.
.PP
مسیرها به‌صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند تا هر اندازه که نیاز است عمیق باشند، برای مثال
\f[V]remote:directory/subdirectory\f[R].
.SS "محدودیت‌ها (Limitations)"
.PP
\f[B]نکته:\f[R] بک‌اِند Internxt ممکن است با همهٔ انواع حساب‌های کاربری کار نکند.
لطفاً برای بررسی سازگاری rclone با اشتراک خود، به جزئیات پلن‌های Internxt (https://internxt.com/pricing) مراجعه کرده یا
با پشتیبانی Internxt (https://help.internxt.com) تماس بگیرید.
.SS "پیکربندی (Configuration)"
.PP
در اینجا مثالی از نحوهٔ ساخت یک ریموت به نام \f[V]internxt\f[R] آورده شده است.
دستور \f[V]rclone config\f[R] را اجرا کرده و اعلان‌ها را دنبال کنید:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> internxt
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Internxt Drive
   \[rs] \[dq]internxt\[dq]
[snip]
Storage> internxt

Option email.
Email of your Internxt account.
Enter a value.
email> user\[at]example.com

Option pass.
Password.
Enter a value.
password>

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: internxt
- email: user\[at]example.com
- pass: *** ENCRYPTED ***
Keep this \[dq]internxt\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
اگر احراز هویت دو مرحله‌ای را روی حساب Internxt خود فعال کرده باشید،
در هنگام ورود از شما خواسته می‌شود که کد را وارد کنید.
.SS "ملاحظات امنیتی (Security Considerations)"
.PP
فرایند احراز هویت، گذرواژه و عبارت یادآور (mnemonic) شما را در فایل
پیکربندی rclone ذخیره می‌کند.
\f[B]اکیداً توصیه می‌شود\f[R] برای محافظت از این اطلاعات حساس،
پیکربندی rclone خود را رمزنگاری کنید:
.IP
.nf
\f[C]
rclone config password
\f[R]
.fi
.PP
این دستور از شما می‌خواهد گذرواژه‌ای تعیین کنید که کل فایل
پیکربندی شما را رمزنگاری می‌کند..SS مثال‌های کاربردی
.IP
.nf
\f[C]
# فهرست کردن فایل‌ها
rclone ls internxt:

# کپی کردن فایل‌ها به Internxt
rclone copy /local/path internxt:remote/path

# همگام‌سازی دایرکتوری محلی با Internxt
rclone sync /local/path internxt:remote/path

# سوار کردن Internxt Drive به عنوان یک فایل‌سیستم محلی
rclone mount internxt: /path/to/mountpoint

# بررسی میزان مصرف فضای ذخیره‌سازی
rclone about internxt:
\f[R]
.fi
.SS زمان‌های تغییر و هش‌ها
.PP
بک‌اند Internxt از هش‌ها پشتیبانی نمی‌کند.
.PP
زمان‌های تغییر از سرور خوانده می‌شوند اما نمی‌توان آن‌ها را تنظیم کرد.
این بک‌اند دقت \f[V]ModTimeNotSupported\f[R] را گزارش می‌دهد، بنابراین
از زمان‌های تغییر برای مقایسه‌های همگام‌سازی استفاده نخواهد شد.
.SS نویسه‌های محدودشده در نام فایل
.PP
بک‌اند Internxt مجموعه‌نویسه‌های محدودشده پیش‌فرض را جایگزین می‌کند
(https://rclone.org/overview/#restricted-characters).
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مربوط به internxt (Internxt Drive) آورده شده است.
.SS --internxt-email
.PP
ایمیل حساب Internxt شما.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: email
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNXT_EMAIL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --internxt-pass
.PP
گذرواژه.
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی شود - rclone
obscure (https://rclone.org/commands/rclone_obscure) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pass
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNXT_PASS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مربوط به internxt (Internxt Drive) آورده شده است.
.SS --internxt-skip-hash-validation
.PP
صرف‌نظر کردن از اعتبارسنجی هش هنگام دانلود فایل‌ها.
.PP
به‌طور پیش‌فرض، اعتبارسنجی هش غیرفعال است.
برای فعال‌سازی اعتبارسنجی، مقدار این گزینه را برابر false قرار دهید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: skip_hash_validation
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNXT_SKIP_HASH_VALIDATION
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true.SS --internxt-upload-concurrency
.PP
هم‌زمانی برای بارگذاری‌های چندبخشی (multipart).
.PP
این مقدار بیانگر تعداد تکه‌های یک فایل است که به‌صورت هم‌زمان بارگذاری
می‌شوند.
.PP
توجه داشته باشید که هر تکه در حافظه میان‌گیر (buffer) می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNXT_UPLOAD_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 4
.SS --internxt-upload-cutoff
.PP
حد آستانه برای تغییر حالت به بارگذاری چندبخشی.
.PP
هر فایلی بزرگ‌تر از این مقدار، در تکه‌هایی به اندازهٔ chunk_size بارگذاری خواهد شد.
حداقل مقدار 100 MiB و حداکثر آن 5 GiB است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNXT_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 100Mi
.SS --internxt-chunk-size
.PP
اندازهٔ هر تکه برای بارگذاری‌های چندبخشی.
.PP
فایل‌های بزرگ‌تر از upload_cutoff در تکه‌هایی به این اندازه بارگذاری خواهند شد.
.PP
میزان مصرف حافظه تقریباً برابر با chunk_size * upload_concurrency است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNXT_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 30Mi
.SS --internxt-encoding
.PP
رمزگذاری برای backend.
.PP
برای اطلاعات بیشتر، بخش encoding را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNXT_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,BackSlash,CrLf,RightPeriod,InvalidUtf8,Dot
.SS --internxt-description
.PP
توضیحات ریموت (remote).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_INTERNXT_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SH Jottacloud
.PP
سرویس Jottacloud یک ارائه‌دهنده خدمات ذخیره‌سازی ابری متعلق به یک شرکت نروژی است که از مراکز داده اختصاصی خود در نروژ استفاده می‌کند.
.PP
علاوه بر سرویس رسمی در
jottacloud.com (<https://www.jottacloud.com>)، این ارائه‌دهنده
راهکارهای برچسب‌سفید (white-label) را نیز به شرکت‌های مختلف ارائه می‌دهد.
موارد زیر در حال حاضر توسط این backend پشتیبانی می‌شوند که همان‌طور که در
ادامه شرح داده شده، از پیکربندی احراز هویت متفاوتی استفاده می‌کنند:
.IP \[bu] 2
Elkjøp (به همراه شرکت‌های زیرمجموعه):
.RS 2
.IP \[bu] 2
Elkjøp Cloud (cloud.elkjop.no)
.IP \[bu] 2
Elgiganten Cloud (cloud.elgiganten.dk)
.IP \[bu] 2
Elgiganten Cloud (cloud.elgiganten.se)
.IP \[bu] 2
ELKO Cloud (cloud.elko.is)
.IP \[bu] 2
Gigantti Cloud (cloud.gigantti.fi)
.RE
.IP \[bu] 2
Telia
.RS 2
.IP \[bu] 2
Telia Cloud (cloud.telia.se)
.IP \[bu] 2
Telia Sky (sky.telia.no)
.RE
.IP \[bu] 2
Tele2
.RS 2
.IP \[bu] 2
Tele2 Cloud (mittcloud.tele2.se)
.RE
.IP \[bu] 2
Onlime
.RS 2
.IP \[bu] 2
Onlime (onlime.dk)
.RE
.IP \[bu] 2
MediaMarkt
.RS 2
.IP \[bu] 2
MediaMarkt Cloud (mediamarkt.jottacloud.com)
.IP \[bu] 2
Let\[aq]s Go Cloud (letsgo.jotta.cloud)
.RE
.IP \[bu] 2
Phonero
.RS 2
.IP \[bu] 2
Phonero Sky (sky.phonero.no)
.RE
.PP
مسیرها به‌صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند تا هر عمق مورد نیازی مشخص شوند، مثلاً
\f[V]remote:directory/subdirectory\f[R].
.SS "احراز هویت (Authentication)"
.PP
احراز هویت در Jottacloud به‌طور کلی مبتنی بر OAuth و OpenID
Connect (OIDC) است.
بسته به اینکه از کدام سرویس استفاده می‌کنید، حالت‌های مختلفی برای انتخاب
وجود دارد؛ برای نمونه، ممکن است یک سرویس با برچسب‌سفید تنها از یکی از آن‌ها
پشتیبانی کند.
توجه داشته باشید که مستنداتی برای اتکا وجود ندارد، بنابراین توضیحات
ارائه‌شده در اینجا بر اساس مشاهدات تجربی بوده و ممکن است دقیق نباشد.
.PP
سرویس Jottacloud از دو سازوکار امنیتی اختیاری OAuth استفاده می‌کند که با عنوان‌های
\[dq]Refresh Token Rotation\[dq] و \[dq]Automatic Reuse
Detection\[dq] شناخته می‌شوند و این موضوع پیامدهایی در پی دارد.
توکن‌های دسترسی (access tokens) معمولاً انقضای یک‌ساعته دارند که پس از آن باید
نوسازی (چرخش/rotate) شوند؛ عملیاتی که نیازمند ارائه توکن نوسازی (refresh token)
است.
ابزار Rclone این کار را به‌طور خودکار انجام می‌دهد.
این رفتار استاندارد OAuth است.
اما در Jottacloud، چنین عملیات نوسازی‌ای نه‌تنها یک توکن دسترسی جدید، بلکه یک
توکن نوسازی جدید نیز ایجاد می‌کند و توکن نوسازی پیشین ارائه‌شده را باطل می‌سازد.
این سرویس تاریخچه توکن‌های نوسازی را که گاهی با نام خانواده توکن (token family)
شناخته می‌شود و از توکن نوسازی اولیه صادرشده پس از احراز هویت اولیه منشعب
شده‌اند، پیگیری می‌کند.
از این سازوکار برای تشخیص هرگونه تلاش در جهت استفاده مجدد از توکن‌های نوسازی قدیمی
استفاده می‌شود و در صورت وقوع، بلافاصله توکن نوسازی فعلی و در واقع کل خانواده
توکن نوسازی باطل می‌گردند.
.PP
هنگامی که توکن نوسازی فعلی باطل شود، دفعه بعد که rclone تلاش کند نوسازی توکن
را انجام دهد، با خطایی مشابه پیام زیر مواجه خواهد شد:
.IP
.nf
\f[C]
CRITICAL: Failed to create file system for \[dq]remote:\[dq]: (...): couldn\[aq]t fetch token: invalid_grant: maybe token expired? - try refreshing with \[dq]rclone config reconnect remote:\[dq]
\f[R]
.fi
.PP
اگر rclone را با سطح گزارش‌دهی تفصیلی ۲ (\f[V]-vv\f[R]) اجرا کنید، یک پیام
اشکال‌زدایی (debug) با توضیحات خطای اضافی از پاسخ OAuth را مشاهده خواهید کرد:
.IP
.nf
\f[C]
DEBUG : remote: got fatal oauth error: oauth2: \[dq]invalid_grant\[dq] \[dq]Session doesn\[aq]t have required client\[dq]
\f[R]
.fi
.PP
(توضیح خطا پیش‌تر به‌جای \[dq]Session doesn\[aq]t have required client\[dq]
عبارت \[dq]Stale token\[dq] بود، بنابراین ممکن است در توضیحات قدیمی‌تر این شرایط،
ارجاعاتی به آن را ببینید.)
.PP
هنگامی که این اتفاق می‌افتد، برای اینکه بتوانید دوباره از remote خود استفاده
کنید باید مجدداً احراز هویت انجام دهید؛ برای نمونه با استفاده از دستور
config reconnect (<https://rclone.org/commands/rclone_config_reconnect>)
همان‌طور که در پیام خطا پیشنهاد شده است.
این کار یک توکن نوسازی (خانواده توکن) کاملاً جدید ایجاد خواهد کرد.
.PP
یک مثال معمول از چگونگی رخ دادن این وضعیت زمانی است که یک remote از Jottacloud
را با rclone در یک مکان ایجاد می‌کنید و سپس فایل پیکربندی را به مکان دومی
کپی کرده و در آنجا نیز برای دسترسی به همان remote از rclone استفاده می‌کنید.
در نهایت، تلاشی برای نوسازی توکن با یک توکن باطل‌شده رخ خواهد داد (یعنی استفاده
مجدد از refresh token)، که در نتیجه هر دو نمونه با خطای \[dq]invalid_grant\[dq]
مواجه خواهند شد.
کپی کردن پیکربندی‌های remote امکان‌پذیر است، اما پس از آن باید با استفاده از
دستور config reconnect (<https://rclone.org/commands/rclone_config_reconnect>)
توکن یکی از آن‌ها را جایگزین کنید.
.PP
می‌توانید در رابط کاربری وب سرویس خود، با رفتن به بخش \[dq]Settings\[dq] و سپس
\[dq]Security\[dq] نمایی کلی از توکن‌های فعال خود مشاهده کنید (که در این صورت
به آدرس <https://www.jottacloud.com/web/secure> یا مشابه آن هدایت می‌شوید).
در پایین آن صفحه، بخشی به نام \[dq]My logged in devices\[dq] وجود دارد.
این بخش شامل فهرستی از مدخل‌ها است که ظاهراً نشان‌دهنده توکن‌های نوسازی معتبر فعلی،
یا خانواده توکن‌های نوسازی هستند.
از سمت راست آن فهرست می‌توانید با کلیک روی یک دکمه (\[dq]X\[dq]) آن را باطل
(لغو) کنید؛ این بدان معناست که همچنان با استفاده از توکن دسترسی فعلی تا زمان انقضای
آن دسترسی خواهید داشت، اما قادر به انجام عملیات نوسازی توکن نخواهید بود.
توجه داشته باشید که کل قابلیت \[dq]My logged in devices\[dq] ظاهراً در حالت‌های
مختلف احراز هویت و هنگام استفاده از سرویس‌های مختلف (برچسب‌سفید) رفتارهای
متفاوتی از خود نشان می‌دهد..SS استاندارد (Standard)
.PP
این یک گونه از OAuth است که برای برنامه‌های خط فرمان طراحی شده است.
این روش عمدتاً توسط سرویس رسمی (jottacloud.com) پشتیبانی می‌شود، اما
ممکن است توسط برخی از سرویس‌های ارائه‌دهنده با نام تجاری دیگر (white-label) نیز پشتیبانی گردد.
اطلاعات لازم برای انجام احراز هویت، مانند نام دامنه و نقطه پایانی (endpoint) برای اتصال،
به‌صورت خودکار شناسایی می‌شوند (این اطلاعات درون توکن ورود ارائه‌شده کدگذاری شده است
که در ادامه توضیح داده خواهد شد)، بنابراین نیازی نیست مشخص کنید کدام سرویس را
پیکربندی می‌کنید.
.PP
هنگام پیکربندی یک ریموت، از شما خواسته می‌شود یک توکن ورود شخصی یک‌بارمصرف
وارد کنید که باید آن را به‌صورت دستی از تنظیمات امنیتی حساب کاربری در رابط تحت
وب سرویس ایجاد نمایید.
برخلاف OAuth سنتی، شما نیازی به یک مرورگر وب روی همان دستگاه ندارید، بلکه فقط
کافی است در جایی به یک مرورگر وب دسترسی داشته باشید و بتوانید رشته تولیدشده
را در نشست پیکربندی rclone جای‌گذاری (paste) کنید.
وارد رابط کاربری وب سرویس خود شوید، به بخش \[dq]Settings\[dq] و سپس
\[dq]Security\[dq] بروید، یا برای سرویس رسمی، از پیوند مستقیمی که هنگام پیکربندی
ریموت توسط rclone به شما ارائه می‌شود استفاده کنید: <https://www.jottacloud.com/web/secure>.
به پایین صفحه و به بخش \[dq]Personal login token\[dq] بروید و روی دکمه
\[dq]Generate\[dq] کلیک کنید.
رشته نمایش‌داده‌شده را کپی کرده و در جایی که rclone درخواست می‌کند قرار دهید.
سپس rclone از این رشته برای ارسال درخواست اولیه توکن استفاده می‌کند و یک توکن OAuth
معمولی دریافت می‌نماید که آن را در پیکربندی ریموت شما ذخیره می‌کند.
پس از آن، یک ورودی جدید نیز در فهرست \[dq]My logged in devices\[dq] در رابط وب
با نام دستگاه و نام برنامه \[dq]Jottacloud CLI\[dq] ایجاد خواهد شد.
.PP
هر بار که یک توکن جدید به این شیوه ایجاد می‌شود (یعنی یک توکن ورود شخصی جدید
تولید شده و با یک توکن OAuth مبادله می‌گردد)، یک خانواده توکن بازنشانی (refresh token)
کاملاً جدید با یک ورودی تازه در فهرست \[dq]My logged in devices\[dq] دریافت می‌کنید.
تا زمانی که ریموت‌ها را به همین صورت جداگانه پیکربندی کنید، می‌توانید هر تعداد ریموت
که مایلید بسازید و از چندین نمونه rclone روی همان دستگاه یا دستگاه‌های مختلف
استفاده کنید، بدون اینکه با مشکل استفاده مجدد از توکن بازنشانی که در بالا توضیح
داده شد مواجه شوید.
.SS سنتی (Traditional)
.PP
جی‌کلود (Jottacloud) همچنین از یک گونه سنتی‌تر OAuth پشتیبانی می‌کند.
بیشتر سرویس‌های white-label از این روش پشتیبانی می‌کنند و برای بسیاری از آنها این
تنها گزینه موجود است، زیرا از توکن‌های ورود شخصی پشتیبانی نمی‌کنند.
این روش به نام‌های دامنه و نقاط پایانی از پیش تعریف‌شده و ویژه هر سرویس متکی است
و rclone مستلزم آن است که مشخص کنید کدام سرویس را پیکربندی می‌نمایید.
این امر همچنین بدان معناست که هرگونه تغییر در سرویس‌های موجود یا افزودن سرویس‌های
white-label جدید، نیازمند به‌روزرسانی در پیاده‌سازی بک‌اند rclone است.
.PP
هنگام پیکربندی یک ریموت، باید به‌صورت تعاملی وارد یک وب‌سایت احراز هویت OAuth
شوید و یک کد مجازسازی یک‌بارمصرف در پشت صحنه به rclone ارسال می‌شود که از آن
برای درخواست توکن OAuth استفاده می‌کند.
این بدان معناست که باید روی دستگاهی باشید که دارای یک مرورگر وب متصل به اینترنت باشد.
اگر به آن روی سیستمی نیاز دارید که چنین امکانی ندارد، باید پیکربندی را روی سیستم
دیگری انجام دهید و آن را از آنجا کپی کنید.
بک‌اند Jottacloud از دستور \f[V]rclone authorize\f[R] پشتیبانی نمی‌کند.
برای جزئیات بیشتر به مستندات راه‌اندازی ریموت مراجعه کنید.
.PP
سرویس Jottacloud هنگام احراز هویت با استفاده از این روش، نوعی مدیریت نشست
سخت‌گیرانه اعمال می‌کند.
این امر منجر به بروز مواردی غیرمنتظره از خطای \[dq]invalid_grant\[dq] می‌شود
که در بالا توضیح داده شد، و عملاً شما را تنها به استفاده از یک احراز هویت فعال
روی همان دستگاه محدود می‌سازد.
یعنی شما فقط می‌توانید یک ریموت rclone بسازید و حتی نمی‌توانید با وجود یک ریموت
rclone پیکربندی‌شده، با کلاینت دسکتاپ رسمی سرویس وارد شوید؛ در غیر این صورت،
در نهایت تمام نشست‌های شما نامعتبر خواهند شد و مجبور به احراز هویت مجدد می‌شوید.
.PP
پس از موفقیت در احراز هویت، ورودی جدیدی در فهرست \[dq]My logged in devices\[dq]
در رابط وب نمایان می‌شود که نشان‌دهنده نشست شما است.
این مورد معمولاً با نام برنامه \[dq]Jottacloud for Desktop\[dq] یا نامی مشابه
فهرست می‌شود (این مورد به پیکربندی سرویس white-label بستگی دارد).
.SS قدیمی (Legacy)
.PP
در ابتدا Jottacloud از نوعی OAuth استفاده می‌کرد که نیازمند مشخص کردن نام کاربری
و گذرواژه حساب شما بود.
هنگامی که Jottacloud به روش‌های جدیدتر مهاجرت کرد، برخی نسخه‌های white-label
(نسخه‌های مربوط به Elkjøp) همچنان تا مدت‌ها از این روش قدیمی استفاده می‌کردند.
در حال حاضر هیچ کاربرد شناخته‌شده‌ای برای این روش وجود ندارد؛ هرچند هنوز توسط
rclone پشتیبانی می‌شود، اما این پشتیبانی در نسخه‌های آینده حذف خواهد شد..SS پیکربندی (Configuration)
.PP
در اینجا مثالی از نحوهٔ ایجاد یک ریموت به نام \f[V]remote\f[R] با
تنظیمات پیش‌فرض آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> remote

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Jottacloud
   \[rs] (jottacloud)
[snip]
Storage> jottacloud

Option client_id.
OAuth Client Id.
Leave blank normally.
Enter a value. Press Enter to leave empty.
client_id>

Option client_secret.
OAuth Client Secret.
Leave blank normally.
Enter a value. Press Enter to leave empty.
client_secret>

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Option config_type.
Type of authentication.
Choose a number from below, or type in an existing value of type string.
Press Enter for the default (standard).
   / Standard authentication.
   | This is primarily supported by the official service, but may also be
   | supported by some white-label services. It is designed for command-line
 1 | applications, and you will be asked to enter a single-use personal login
   | token which you must manually generate from the account security settings
   | in the web interface of your service.
   \[rs] (standard)
   / Traditional authentication.
   | This is supported by the official service and all white-label services
   | that rclone knows about. You will be asked which service to connect to.
 2 | It has a limitation of only a single active authentication at a time. You
   | need to be on, or have access to, a machine with an internet-connected
   | web browser.
   \[rs] (traditional)
   / Legacy authentication.
 3 | This is no longer supported by any known services and not recommended
   | used. You will be asked for your account\[aq]s username and password.
   \[rs] (legacy)
config_type> 1

Option config_login_token.
Personal login token.
Generate it from the account security settings in the web interface of your
service, for the official service on https://www.jottacloud.com/web/secure.
Enter a value.
config_login_token> <your token here>

Use a non-standard device/mountpoint?
Choosing no, the default, will let you access the storage used for the archive
section of the official Jottacloud client. If you instead want to access the
sync or the backup section, for example, you must choose yes.
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: jottacloud
- configVersion: 1
- client_id: jottacli
- client_secret:
- tokenURL: https://id.jottacloud.com/auth/realms/jottacloud/protocol/openid-connect/token
- token: {........}
- username: 2940e57271a93d987d6f8a21
- device: Jotta
- mountpoint: Archive
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] بدین صورت استفاده کنید (نامی
را که به ریموت خود داده‌اید، جایگزین \f[V]remote\f[R] کنید):
.PP
فهرست کردن دایرکتوری‌های بالاترین سطح Jottacloud شما
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در Jottacloud شما
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به دایرکتوری‌ای در Jottacloud به نام backup
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS دستگاه‌ها و نقاط اتصال (Devices and Mountpoints)
.PP
کلاینت رسمی Jottacloud برای هر رایانه‌ای که روی آن نصب می‌شود، یک دستگاه ثبت می‌کند و آن‌ها را در بخش پشتیبان‌گیری رابط کاربری نمایش می‌دهد.
برای هر پوشه‌ای که برای پشتیبان‌گیری انتخاب می‌کنید، یک نقطه اتصال درون این دستگاه ایجاد می‌کند.
یک دستگاه توکار به نام Jotta وجود دارد که دارای شرایط خاصی است و شامل نقاط اتصال Archive، Sync و چند مورد دیگر است که برای قابلیت‌های متناظر در کلاینت‌های رسمی استفاده می‌شوند.
.PP
در اکثر موارد هنگام کار با rclone، مایل خواهید بود از دستگاه/نقطه اتصال استاندارد Jotta/Archive استفاده کنید.
با این حال، ممکن است برای نمونه بخواهید به فایل‌های حاصل از قابلیت sync یا پشتیبان‌گیری کلاینت‌های رسمی دسترسی پیدا کنید؛ بنابراین rclone گزینه انتخاب سایر دستگاه‌ها و نقاط اتصال را در طول پیکربندی فراهم می‌کند.
.PP
شما مجاز به ایجاد دستگاه‌ها و نقاط اتصال جدید هستید.
تمامی دستگاه‌ها به جز دستگاه توکار Jotta، توسط کلاینت‌های رسمی Jottacloud به عنوان دستگاه‌های پشتیبان‌گیری در نظر گرفته می‌شوند و نقاط اتصال روی آن‌ها مجموعه‌های پشتیبان‌گیری مجزا هستند.
.PP
در دستگاه توکار Jotta، تنها نقاط اتصال توکار و موجود قابل انتخاب هستند.
افزون بر Archive و Sync ذکر شده، این دستگاه ممکن است شامل چندین نقطه اتصال دیگر مانند Latest، Links، Shared و Trash باشد.
تمام این موارد نقاط اتصال ویژه‌ای هستند که ساختار داخلی متفاوتی نسبت به نقاط اتصال «معمولی» دارند.
ابزار rclone تنها تا حد بسیار محدودی از آن‌ها پشتیبانی می‌کند.
به طور کلی باید از این موارد اجتناب کنید، مگر اینکه کاملاً بدانید چه کاری انجام می‌دهید.
.SS --fast-list
.PP
این بک‌اند از \f[V]--fast-list\f[R] پشتیبانی می‌کند که به شما امکان می‌دهد در ازای مصرف حافظه بیشتر، از تراکنش‌های کمتری استفاده کنید.
برای جزئیات بیشتر مستندات rclone (<https://rclone.org/docs/#fast-list>) را ببینید.
.PP
توجه داشته باشید که پیاده‌سازی این قابلیت در Jottacloud همیشه تنها از یک درخواست API برای دریافت کل فهرست استفاده می‌کند، بنابراین برای پوشه‌های بزرگ ممکن است باعث زمان انتظار طولانی پیش از نمایش اولین نتایج شود.
.PP
همچنین توجه داشته باشید که در rclone نسخه 1.58 و جدیدتر، اطلاعات مربوط به انواع MIME (<https://rclone.org/overview/#mime-type>) و فراداده utime در هنگام استفاده از \f[V]--fast-list\f[R] در دسترس نیستند.
.SS زمان‌های تغییر و هش‌ها (Modification times and hashes)
.PP
سرویس Jottacloud امکان تنظیم زمان‌های تغییر (modification times) را بر روی اشیاء با دقت ۱ ثانیه فراهم می‌کند.
این زمان‌ها برای تشخیص اینکه آیا اشیاء نیاز به همگام‌سازی دارند یا خیر استفاده می‌شوند.
.PP
سرویس Jottacloud از هش‌های نوع MD5 پشتیبانی می‌کند، بنابراین می‌توانید از پرچم \f[V]--checksum\f[R] استفاده کنید.
.PP
توجه داشته باشید که Jottacloud پیش از بارگذاری به هش MD5 نیاز دارد، بنابراین اگر مبدأ فاقد چکسام MD5 باشد، فایل پیش از بارگذاری به طور موقت روی دیسک (در مسیری که توسط --temp-dir (<https://rclone.org/docs/#temp-dir-string>) مشخص شده است) ذخیره (کَش) خواهد شد.
فایل‌های کوچک در حافظه کش می‌شوند - پرچم --jottacloud-md5-memory-limit را ببینید.
هنگام بارگذاری از دیسک محلی، چکسام مبدأ همیشه در دسترس است، بنابراین این موضوع اعمال نمی‌شود.
از نسخه 1.52 به بعد rclone، همین امر برای ریموت‌های رمزگذاری‌شده نیز صادق است (در نسخه‌های قدیمی‌تر، بک‌اند crypt هش‌ها را برای بارگذاری‌ها از دیسک محلی محاسبه نمی‌کرد، بنابراین بک‌اند Jottacloud مجبور بود همان‌طور که در بالا توضیح داده شد این کار را انجام دهد).
.SS نویسه‌های محدودشده نام فایل (Restricted filename characters)
.PP
علاوه بر مجموعه پیش‌فرض نویسه‌های محدودشده (<https://rclone.org/overview/#restricted-characters>)، نویسه‌های زیر نیز جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\[dq]
T}@T{
0x22
T}@T{
＂
T}
T{
*
T}@T{
0x2A
T}@T{
＊
T}
T{
:
T}@T{
0x3A
T}@T{
：
T}
T{
<
T}@T{
0x3C
T}@T{
＜
T}
T{
>
T}@T{
0x3E
T}@T{
＞
T}
T{
?
T}@T{
0x3F
T}@T{
？
T}
T{
|
T}@T{
0x7C
T}@T{
｜
T}
T{
%
T}@T{
0x25
T}@T{
％
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند شد (<https://rclone.org/overview/#invalid-utf8>)، زیرا نمی‌توان از آن‌ها در رشته‌های XML استفاده کرد..SS حذف فایل‌ها
.PP
به‌طور پیش‌فرض، rclone هنگام حذف فایل‌ها آن‌ها را به سطل زباله می‌فرستد.
آن‌ها پس از ۳۰ روز به‌طور خودکار برای همیشه حذف خواهند شد.
می‌توانید با استفاده از پرچم \f[V]\-\-jottacloud\-hard\-delete\f[R] یا تنظیم متغیر محیطی معادل آن، از سطل زباله صرف‌نظر کرده و فایل‌ها را فوراً به‌طور دائم حذف کنید.
خالی کردن سطل زباله توسط دستور
cleanup (<https://rclone.org/commands/rclone_cleanup>) پشتیبانی می‌شود.
.SS نسخه‌ها
.PP
Jottacloud از نسخه‌بندی فایل‌ها پشتیبانی می‌کند.
هنگامی که rclone نسخه جدیدی از یک فایل را بارگذاری می‌کند، یک نسخه جدید از آن می‌سازد.
در حال حاضر rclone فقط از بازیابی نسخه فعلی پشتیبانی می‌کند، اما نسخه‌های قدیمی‌تر از طریق وب‌سایت Jottacloud قابل دسترسی هستند.
.PP
نسخه‌بندی را می‌توان با گزینه \f[V]\-\-jottacloud\-no\-versions\f[R] غیرفعال کرد.
این کار با حذف فایل ریموت پیش از بارگذاری نسخه جدید انجام می‌شود.
اگر بارگذاری شکست بخورد، هیچ نسخه‌ای از فایل در ریموت در دسترس نخواهد بود.
.SS اطلاعات سهمیه
.PP
برای مشاهده سهمیه فعلی خود می‌توانید از دستور
\f[V]rclone about remote:\f[R] استفاده کنید که محدودیت استفاده شما (مگر اینکه نامحدود باشد) و میزان مصرف فعلی را نمایش می‌دهد.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص jottacloud (Jottacloud) آورده شده است.
.SS \-\-jottacloud\-client\-id
.PP
شناسه کلاینت OAuth (OAuth Client Id).
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_JOTTACLOUD_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS \-\-jottacloud\-client\-secret
.PP
رمز کلاینت OAuth (OAuth Client Secret).
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_JOTTACLOUD_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مختص jottacloud (Jottacloud) آورده شده است.
.SS \-\-jottacloud\-token
.PP
توکن دسترسی OAuth به‌صورت یک داده خرد JSON (JSON blob).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_JOTTACLOUD_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS \-\-jottacloud\-auth\-url
.PP
آدرس URL سرور احراز هویت.
.PP
برای استفاده از پیش‌فرض‌های ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_JOTTACLOUD_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --jottacloud-token-url
.PP
نشانی وب سرور توکن.
.PP
برای استفاده از پیش‌فرض‌های ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_JOTTACLOUD_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --jottacloud-client-credentials
.PP
استفاده از جریان OAuth اعتبارنامه‌های کلاینت (client credentials).
.PP
این گزینه از جریان Client Credentials در OAUTH2 طبق آنچه در RFC
6749 شرح داده شده است، استفاده خواهد کرد.
.PP
توجه داشته باشید که این گزینه توسط همه پیشرانه‌ها (backends) پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_JOTTACLOUD_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --jottacloud-md5-memory-limit
.PP
فایل‌های بزرگ‌تر از این مقدار، در صورت نیاز برای محاسبه MD5 روی دیسک موقتاً ذخیره (cache) خواهند شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: md5_memory_limit
.IP \[bu] 2
متغیر محیطی: RCLONE_JOTTACLOUD_MD5_MEMORY_LIMIT
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 10Mi
.SS --jottacloud-trashed-only
.PP
تنها نمایش فایل‌هایی که در سطل زباله هستند.
.PP
این گزینه فایل‌های حذف‌شده را در ساختار دایرکتوری اصلی آن‌ها نشان می‌دهد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: trashed_only
.IP \[bu] 2
متغیر محیطی: RCLONE_JOTTACLOUD_TRASHED_ONLY
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --jottacloud-hard-delete
.PP
حذف دائمی فایل‌ها به جای انتقال آن‌ها به سطل زباله.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hard_delete
.IP \[bu] 2
متغیر محیطی: RCLONE_JOTTACLOUD_HARD_DELETE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --jottacloud-upload-resume-limit
.PP
در صورتی که بارگذاری با شکست مواجه شود، امکان ازسرگیری بارگذاری برای فایل‌های بزرگ‌تر از این مقدار وجود دارد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_resume_limit
.IP \[bu] 2
متغیر محیطی: RCLONE_JOTTACLOUD_UPLOAD_RESUME_LIMIT
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 10Mi.SS --jottacloud-no-versions
.PP
جلوگیری از نسخه‌بندی سمت سرور با حذف فایل‌ها و ایجاد مجدد آن‌ها به جای بازنویسی‌شان.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_versions
.IP \[bu] 2
متغیر محیطی: RCLONE_JOTTACLOUD_NO_VERSIONS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --jottacloud-encoding
.PP
کدگذاری برای بک‌اند.
.PP
برای اطلاعات بیشتر بخش کدگذاری را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_JOTTACLOUD_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,Percent,Del,Ctl,InvalidUtf8,Dot
.SS --jottacloud-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_JOTTACLOUD_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS فراداده (Metadata)
.PP
سرویس Jottacloud پشتیبانی محدودی از فراداده دارد که در حال حاضر شامل مجموعه‌ای گسترده
از برچسب‌های زمانی است.
.PP
موارد فرادادهٔ سیستمی ممکن برای بک‌اند jottacloud در اینجا آورده شده است.
.PP
.TS
tab(@);
lw(11.1n) lw(11.1n) lw(11.1n) lw(16.6n) lw(20.3n).
T{
نام
T}@T{
راهنما
T}@T{
نوع
T}@T{
مثال
T}@T{
فقط‌خواندنی
T}
_
T{
btime
T}@T{
زمان ایجاد (birth) فایل، خوانده‌شده از فرادادهٔ rclone
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}@T{
N
T}
T{
content-type
T}@T{
نوع MIME، همچنین با عنوان media type شناخته می‌شود
T}@T{
string
T}@T{
text/plain
T}@T{
\f[B]Y\f[R]
T}
T{
mtime
T}@T{
زمان آخرین تغییر، خوانده‌شده از فرادادهٔ rclone
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}@T{
N
T}
T{
utime
T}@T{
زمان آخرین بارگذاری، هنگامی که ویرایش فعلی ایجاد شد، تولیدشده توسط بک‌اند
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}@T{
\f[B]Y\f[R]
T}
.TE
.PP
برای اطلاعات بیشتر، مستندات فراداده (https://rclone.org/docs/#metadata) را ببینید..SS "محدودیت‌ها (Limitations)"
.PP
توجه داشته باشید که Jottacloud به حروف بزرگ و کوچک حساس نیست، بنابراین نمی‌توانید به‌طور هم‌زمان فایلی به نام \[dq]Hello.doc\[dq] و فایلی به نام \[dq]hello.doc\[dq] داشته باشید.
.PP
تعداد قابل‌توجهی نویسه وجود دارند که نمی‌توانند در نام فایل‌های Jottacloud استفاده شوند.
ابزار Rclone این نام‌ها را به و از معادل‌های یونیکد با ظاهر یکسان نگاشت می‌کند.
برای نمونه، اگر نام فایلی دارای ? باشد، به جای آن به ？ نگاشت خواهد شد.
.PP
سرویس Jottacloud تنها از نام فایل‌هایی تا حداکثر ۲۵۵ نویسه پشتیبانی می‌کند.
.SS "عیب‌یابی (Troubleshooting)"
.PP
سرویس Jottacloud رفتارهای متناقضی را در رابطه با فایل‌ها و پوشه‌های حذف‌شده نشان می‌دهد که ممکن است باعث ناموفق بودن عملیات‌های Copy، Move و DirMove روی مسیرهای از پیش حذف‌شده شود.
خالی کردن سطل زباله در چنین مواردی به رفع مشکل کمک خواهد کرد.
.SH Koofr
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند به هر میزان که نیاز است تودرتو باشند، مانند
\f[V]remote:directory/subdirectory\f[R].
.SS "پیکربندی (Configuration)"
.PP
راه‌اندازی اولیه برای Koofr شامل ایجاد یک گذرواژه اختصاصی برنامه برای rclone است.
می‌توانید این کار را با باز کردن برنامه تحت وب Koofr (https://app.koofr.net/app/admin/preferences/password)،
تعیین یک نام مناسب برای گذرواژه مانند \f[V]rclone\f[R] و کلیک روی دکمه generate انجام دهید.
.PP
در ادامه نمونه‌ای از نحوه ایجاد یک ریموت به نام \f[V]koofr\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرآیند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> koofr
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
22 / Koofr, Digi Storage and other Koofr-compatible storage providers
   \[rs] (koofr)
[snip]
Storage> koofr
Option provider.
Choose your storage provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Koofr, https://app.koofr.net
   \[rs] (koofr)
 2 / Digi Storage, https://storage.rcs-rds.ro
   \[rs] (digistorage)
 3 / Any other Koofr API compatible storage service
   \[rs] (other)
provider> 1    
Option user.
Your user name.
Enter a value.
user> USERNAME
Option password.
Your password for rclone (generate one at https://app.koofr.net/app/admin/preferences/password).
Choose an alternative below.
y) Yes, type in my own password
g) Generate random password
y/g> y
Enter the password:
password:
Confirm the password:
password:
Edit advanced config?
y) Yes
n) No (default)
y/n> n
Remote config
--------------------
[koofr]
type = koofr
provider = koofr
user = USERNAME
password = *** ENCRYPTED ***
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
اگر از نمونه‌های محلی (on-premise) یا اختصاصی (white label) سرویس Koofr استفاده می‌کنید، می‌توانید پیکربندی پیشرفته را برای وارد کردن URL اختصاصی سرویس خود ویرایش کنید، یا یک نقطه اتصال (mount) جایگزین را به جای فضای ذخیره‌سازی اصلی خود برگزینید.
.PP
پس از پیکربندی می‌توانید از \f[V]rclone\f[R] به صورت زیر استفاده کنید:
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح Koofr شما:
.IP
.nf
\f[C]
rclone lsd koofr:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در Koofr شما:
.IP
.nf
\f[C]
rclone ls koofr:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به دایرکتوری‌ای در Koofr به نام backup:
.IP
.nf
\f[C]
rclone copy /home/source koofr:backup
\f[R]
.fi.SS نویسه‌های محدودشده نام فایل
.PP
علاوه بر مجموعه پیش‌فرض نویسه‌های محدودشده
(https://rclone.org/overview/#restricted-characters)، نویسه‌های زیر نیز
جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند
شد (https://rclone.org/overview/#invalid-utf8)، چرا که امکان
استفاده از آن‌ها در رشته‌های XML وجود ندارد.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص koofr (شامل Koofr، Digi Storage و
سایر ارائه‌دهندگان ذخیره‌سازی سازگار با Koofr) آمده است.
.SS --koofr-provider
.PP
ارائه‌دهنده ذخیره‌سازی خود را انتخاب کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: provider
.IP \[bu] 2
متغیر محیطی: RCLONE_KOOFR_PROVIDER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]koofr\[dq]
.RS 2
.IP \[bu] 2
Koofr، https://app.koofr.net
.RE
.IP \[bu] 2
\[dq]digistorage\[dq]
.RS 2
.IP \[bu] 2
Digi Storage، https://storage.rcs-rds.ro
.RE
.IP \[bu] 2
\[dq]other\[dq]
.RS 2
.IP \[bu] 2
هر سرویس ذخیره‌سازی دیگر سازگار با Koofr API
.RE
.RE
.SS --koofr-endpoint
.PP
نقطه پایانی Koofr API برای استفاده.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_KOOFR_ENDPOINT
.IP \[bu] 2
ارائه‌دهنده: other
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true.SS --koofr-user
.PP
نام کاربری شما.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user
.IP \[bu] 2
متغیر محیطی: RCLONE_KOOFR_USER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --koofr-password
.PP
گذرواژه شما برای rclone؛ یکی در نشانی زیر ایجاد کنید:
https://app.koofr.net/app/admin/preferences/password.
.PP
\f[B]نکته:\f[R] ورودی این مقدار باید مبهم‌سازی شود \- مستندات rclone
obscure (https://rclone.org/commands/rclone_obscure) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: password
.IP \[bu] 2
متغیر محیطی: RCLONE_KOOFR_PASSWORD
.IP \[bu] 2
ارائه‌دهنده: koofr
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS گزینه‌های پیشرفته
.PP
در این بخش گزینه‌های پیشرفته مربوط به koofr (شامل Koofr، Digi Storage و
سایر ارائه‌دهندگان ذخیره‌سازی سازگار با Koofr) آمده است.
.SS --koofr-mountid
.PP
شناسه اتصال (Mount ID) برای اتصالِ مورد استفاده.
.PP
در صورت حذف، از اتصال اصلی (primary) استفاده می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: mountid
.IP \[bu] 2
متغیر محیطی: RCLONE_KOOFR_MOUNTID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --koofr-setmtime
.PP
آیا backend از تنظیم زمان تغییر (modification time) پشتیبانی می‌کند یا خیر.
.PP
اگر از شناسه اتصالی استفاده می‌کنید که به یک backend از نوع Dropbox یا
Amazon Drive اشاره دارد، این مقدار را برابر false قرار دهید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: setmtime
.IP \[bu] 2
متغیر محیطی: RCLONE_KOOFR_SETMTIME
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --koofr-encoding
.PP
کدگذاری (encoding) برای backend.
.PP
برای اطلاعات بیشتر بخش encoding را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_KOOFR_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot.SS --koofr-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_KOOFR_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS محدودیت‌ها
.PP
توجه داشته باشید که Koofr به بزرگی و کوچکی حروف حساس نیست، بنابراین نمی‌توانید فایلی با نام
\[dq]Hello.doc\[dq] و فایلی با نام \[dq]hello.doc\[dq] را به‌طور هم‌زمان داشته باشید.
.SS ارائه‌دهندگان
.SS Koofr
.PP
این ارائه‌دهنده اصلی فضای ذخیره‌سازی Koofr (https://koofr.eu) است که به عنوان
مثال اصلی استفاده شده و در بخش پیکربندی بالا توضیح داده شده است.
.SS Digi Storage
.PP
سرویس Digi Storage (https://www.digi.ro/servicii/online/digi-storage) یک
فضای ذخیره‌سازی ابری ارائه‌شده توسط Digi.ro (https://www.digi.ro) است
که یک API سازگار با Koofr ارائه می‌دهد.
.PP
در اینجا نمونه‌ای از نحوه ایجاد یک ریموت به نام \f[V]ds\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> ds
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
22 / Koofr, Digi Storage and other Koofr-compatible storage providers
   \[rs] (koofr)
[snip]
Storage> koofr
Option provider.
Choose your storage provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Koofr, https://app.koofr.net
   \[rs] (koofr)
 2 / Digi Storage, https://storage.rcs-rds.ro
   \[rs] (digistorage)
 3 / Any other Koofr API compatible storage service
   \[rs] (other)
provider> 2
Option user.
Your user name.
Enter a value.
user> USERNAME
Option password.
Your password for rclone (generate one at https://storage.rcs-rds.ro/app/admin/preferences/password).
Choose an alternative below.
y) Yes, type in my own password
g) Generate random password
y/g> y
Enter the password:
password:
Confirm the password:
password:
Edit advanced config?
y) Yes
n) No (default)
y/n> n
--------------------
[ds]
type = koofr
provider = digistorage
user = USERNAME
password = *** ENCRYPTED ***
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS سایر (Other)
.PP
همچنین می‌توانید تنها با ارائهٔ URL پایه جهت اتصال، از یک ارائه‌دهندهٔ فضای ذخیره‌سازی عمومی یا خصوصی دیگر که سرویسی سازگار با Koofr API را اجرا می‌کند استفاده کنید.
.PP
در ادامه مثالی از نحوهٔ ایجاد یک ریموت به نام \f[V]other\f[R] آورده شده است. ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند پیکربندی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> other
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
22 / Koofr, Digi Storage and other Koofr-compatible storage providers
   \[rs] (koofr)
[snip]
Storage> koofr
Option provider.
Choose your storage provider.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
 1 / Koofr, https://app.koofr.net
   \[rs] (koofr)
 2 / Digi Storage, https://storage.rcs-rds.ro
   \[rs] (digistorage)
 3 / Any other Koofr API compatible storage service
   \[rs] (other)
provider> 3
Option endpoint.
The Koofr API endpoint to use.
Enter a value.
endpoint> https://koofr.other.org
Option user.
Your user name.
Enter a value.
user> USERNAME
Option password.
Your password for rclone (generate one at your service\[aq]s settings page).
Choose an alternative below.
y) Yes, type in my own password
g) Generate random password
y/g> y
Enter the password:
password:
Confirm the password:
password:
Edit advanced config?
y) Yes
n) No (default)
y/n> n
--------------------
[other]
type = koofr
provider = other
endpoint = https://koofr.other.org
user = USERNAME
password = *** ENCRYPTED ***
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SH Linkbox
.PP
Linkbox یک درایو ابری خصوصی است (https://linkbox.to).
.SS "پیکربندی (Configuration)"
.PP
در اینجا نمونه‌ای از ایجاد یک ریموت برای Linkbox آورده شده است.
.PP
شما به موارد زیر نیاز خواهید داشت: \- یک توکن API از https://www.linkbox.to/admin/account
\- ایمیل و گذرواژهٔ حساب Linkbox شما
.PP
\f[B]نکته:\f[R] از نسخهٔ v1.74، علاوه بر توکن API، ایمیل و گذرواژه نیز الزامی هستند.
توکن API برای بارگذاری‌ها و اعمال تغییرات استفاده می‌شود، در حالی که
احراز هویت با ایمیل/گذرواژه برای فهرست‌کردن و بارگیری فایل‌ها به کار می‌رود.
اگر از قبل یک ریموت Linkbox دارید، باید با اجرای \f[V]rclone config\f[R]
آن را مجدداً پیکربندی کنید تا ریموت ویرایش شده و ایمیل و گذرواژه افزوده شوند.
.PP
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرآیند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> remote

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
XX / Linkbox
   \[rs] (linkbox)
Storage> XX

Option token.
Token from https://www.linkbox.to/admin/account
Enter a value.
token> YOUR_API_TOKEN

Option email.
Email for login
Enter a value.
email> your\[at]email.com

Option password.
Password for login
Enter a value.
password> YOUR_PASSWORD

Configuration complete.
Options:
- type: linkbox
- token: XXXXXXXXXXX
- email: your\[at]email.com
- password: *** ENCRYPTED ***
Keep this \[dq]linkbox\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.SS "گزینه‌های استاندارد (Standard options)"
.PP
در اینجا گزینه‌های استاندارد ویژهٔ linkbox (Linkbox) آورده شده‌اند.
.SS --linkbox-token
.PP
توکن از https://www.linkbox.to/admin/account
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_LINKBOX_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true.SS --linkbox-email
.PP
ایمیل برای ورود به سیستم
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: email
.IP \[bu] 2
متغیر محیطی: RCLONE_LINKBOX_EMAIL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --linkbox-password
.PP
گذرواژه برای ورود به سیستم
.PP
\f[B]نکته:\f[R] ورودی این مقدار باید مبهم‌سازی شود \- به rclone obscure
(https://rclone.org/commands/rclone_obscure) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: password
.IP \[bu] 2
متغیر محیطی: RCLONE_LINKBOX_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفتهٔ ویژهٔ linkbox (Linkbox) آمده است.
.SS --linkbox-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_LINKBOX_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS محدودیت‌ها (Limitations)
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند شد
(https://rclone.org/overview/#invalid-utf8)، چرا که نمی‌توان از آن‌ها در
رشته‌های JSON استفاده کرد.
.SH "فضای ابری Mail.ru (Mail.ru Cloud)"
.PP
سرویس Mail.ru Cloud (https://cloud.mail.ru) یک فضای ذخیره‌سازی ابری است که
توسط شرکت اینترنتی روسی Mail.Ru Group (https://mail.ru) ارائه می‌شود.
کلاینت دسکتاپ رسمی آن Disk-O: (https://disk-o.cloud/en) است
که برای Windows و Mac OS در دسترس می‌باشد.
.SS "ویژگی‌های برجسته (Features highlights)"
.IP \[bu] 2
مسیرها می‌توانند تا هر عمقی که لازم است باشند؛ مانند
\f[V]remote:directory/subdirectory\f[R]
.IP \[bu] 2
فایل‌ها دارای ویژگی \f[V]last modified time\f[R] هستند، اما دایرکتوری‌ها
این ویژگی را ندارند
.IP \[bu] 2
فایل‌های حذف‌شده به‌طور پیش‌فرض به سطل زباله منتقل می‌شوند
.IP \[bu] 2
فایل‌ها و دایرکتوری‌ها می‌توانند از طریق پیوندهای عمومی به اشتراک گذاشته شوند
.IP \[bu] 2
بارگذاری جزئی یا جاری‌سازی (streaming) پشتیبانی نمی‌شود؛ اندازهٔ فایل باید
پیش از بارگذاری مشخص باشد
.IP \[bu] 2
حداکثر اندازهٔ فایل برای حساب‌های رایگان به 2G محدود است و برای حساب‌های
پولی نامحدود است
.IP \[bu] 2
فضای ذخیره‌سازی هش تمام فایل‌ها را نگه می‌دارد و یکسان‌سازی شفاف داده‌ها (deduplication)
را انجام می‌دهد؛ الگوریتم درهم‌سازی یک SHA1 تغییریافته است
.IP \[bu] 2
اگر فایل خاصی از قبل در فضای ذخیره‌سازی موجود باشد، می‌توان به‌جای بارگذاری
طولانی فایل، هش فایل را سریعاً ارسال کرد (این بهینه‌سازی توسط rclone پشتیبانی
می‌شود).SS "پیکربندی (Configuration)"
.PP
در اینجا نمونه‌ای از ایجاد یک پیکربندی mailru آورده شده است.
.PP
ابتدا یک حساب کاربری Mail.ru Cloud بسازید و یک تعرفه انتخاب کنید.
.PP
باید وارد حساب خود شوید و یک گذرواژه برنامه (app password) برای rclone بسازید.
ابزار Rclone با نام کاربری و گذرواژه عادی شما \f[B]کار نخواهد کرد\f[R] -
و خطایی مانند
\f[V]oauth2: server response missing access_token\f[R]
صادر خواهد کرد.
.IP \[bu] 2
روی نمایه کاربر خود در بالا سمت راست کلیک کنید.
.IP \[bu] 2
به بخش امنیت / \[dq]Пароль и безопасность\[dq] بروید.
.IP \[bu] 2
روی گذرواژه برای برنامه‌ها / \[dq]Пароли для внешних приложений\[dq] کلیک کنید.
.IP \[bu] 2
گذرواژه را اضافه کنید - یک نام به آن بدهید - مثلاً \[dq]rclone\[dq].
.IP \[bu] 2
سطح دسترسی را انتخاب کنید.
در حال حاضر بنا به دلایلی، فقط انتخاب \[dq]Full access to Cloud\[dq] (WebDav) برای Rclone
کار نمی‌کند.
باید گزینه \[dq]Full access to Mail, Cloud and Calendar\[dq]
(همه‌ی پروتکل‌ها) را انتخاب کنید.
(موضوع در
forum.rclone.org به نشانی <https://forum.rclone.org/t/failed-to-create-file-system-for-mailru-failed-to-authorize-oauth2-invalid-username-or-password-username-or-password-is-incorrect/49298>)
.IP \[bu] 2
گذرواژه را رونوشت کرده و در مراحل زیر از آن استفاده کنید - گذرواژه ورود عادی شما
کار نخواهد کرد.
.PP
اکنون اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / Mail.ru Cloud
   \[rs] \[dq]mailru\[dq]
[snip]
Storage> mailru
User name (usually email)
Enter a string value. Press Enter for the default (\[dq]\[dq]).
user> username\[at]mail.ru
Password

This must be an app password - rclone will not work with your normal
password. See the Configuration section in the docs for how to make an
app password.
y) Yes type in my own password
g) Generate random password
y/g> y
Enter the password:
password:
Confirm the password:
password:
Skip full upload if there is another file with same data hash.
This feature is called \[dq]speedup\[dq] or \[dq]put by hash\[dq]. It is especially efficient
in case of generally available files like popular books, video or audio clips
[snip]
Enter a boolean value (true or false). Press Enter for the default (\[dq]true\[dq]).
Choose a number from below, or type in your own value
 1 / Enable
   \[rs] \[dq]true\[dq]
 2 / Disable
   \[rs] \[dq]false\[dq]
speedup_enable> 1
Edit advanced config? (y/n)
y) Yes
n) No
y/n> n
Remote config
Configuration complete.
Options:
- type: mailru
- user: username\[at]mail.ru
- pass: *** ENCRYPTED ***
- speedup_enable: true
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
پیکربندی این بک‌اند نیازی به مرورگر وب محلی ندارد.
می‌توانید از بک‌اند پیکربندی‌شده همان‌طور که در زیر نشان داده شده است استفاده کنید:
.PP
مشاهده دایرکتوری‌های سطح بالا:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
ساخت یک دایرکتوری جدید:
.IP
.nf
\f[C]
rclone mkdir remote:directory
\f[R]
.fi
.PP
فهرست کردن محتویات یک دایرکتوری:
.IP
.nf
\f[C]
rclone ls remote:directory
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با مسیر دوردست، به همراه حذف تمام فایل‌های اضافی در آن مسیر:
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory remote:directory
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها
.PP
فایل‌ها از مشخصهٔ زمان تغییر با دقت تا ۱ ثانیه پشتیبانی می‌کنند.
دایرکتوری‌ها فاقد زمان تغییر هستند، که به‌صورت \[dq]Jan 1 1970\[dq]
نمایش داده می‌شود.
.PP
هش‌های فایل با یک الگوریتم سفارشی Mail.ru بر پایهٔ SHA1 پشتیبانی
می‌شوند.
اگر اندازهٔ فایل کمتر یا مساوی با اندازهٔ بلوک SHA1 (۲۰ بایت) باشد،
هش آن صرفاً همان داده‌هایش است که از سمت راست با بایت‌های صفر پر
(right-pad) شده است.
هش فایل‌های بزرگ‌تر به‌صورت SHA1 از پیوست کردن بایت‌های دادهٔ فایل
با نمایش ده‌دهی طول داده محاسبه می‌شود.
.SS خالی کردن سطل زباله
.PP
حذف یک فایل یا دایرکتوری در واقع آن را به سطل زباله منتقل می‌کند، که
برای rclone قابل مشاهده نیست اما در مرورگر وب دیده می‌شود.
فایل درون سطل زباله همچنان بخشی از کل سهمیه را اشغال می‌کند.
اگر می‌خواهید سطل زبالهٔ خود را خالی کرده و مقداری از سهمیه را آزاد
کنید، می‌توانید از دستور \f[V]rclone cleanup remote:\f[R] استفاده
کنید که تمام فایل‌های درون سطل زبالهٔ شما را برای همیشه حذف خواهد
کرد.
این دستور هیچ آرگومان مسیری دریافت نمی‌کند.
.SS اطلاعات سهمیه
.PP
برای مشاهدهٔ سهمیهٔ فعلی خود می‌توانید از دستور
\f[V]rclone about remote:\f[R] استفاده کنید که محدودیت استفاده
(سهمیه) و میزان مصرف فعلی را نمایش می‌دهد.
.SS نویسه‌های محدودشده در نام فایل
.PP
علاوه بر مجموعه پیش‌فرض نویسه‌های
محدودشده (https://rclone.org/overview/#restricted-characters)،
نویسه‌های زیر نیز جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\[dq]
T}@T{
0x22
T}@T{
＂
T}
T{
*
T}@T{
0x2A
T}@T{
＊
T}
T{
:
T}@T{
0x3A
T}@T{
：
T}
T{
<
T}@T{
0x3C
T}@T{
＜
T}
T{
>
T}@T{
0x3E
T}@T{
＞
T}
T{
?
T}@T{
0x3F
T}@T{
؟
T}
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
T{
|
T}@T{
0x7C
T}@T{
｜
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند
شد (https://rclone.org/overview/#invalid-utf8)، چرا که نمی‌توان
از آن‌ها در رشته‌های JSON استفاده کرد..SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد ویژهٔ mailru (فضای ابری Mail.ru) آورده شده است.
.SS --mailru-client-id
.PP
شناسه کارخواه OAuth (OAuth Client Id).
.PP
در حالت معمول خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --mailru-client-secret
.PP
رمز کارخواه OAuth (OAuth Client Secret).
.PP
در حالت معمول خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --mailru-user
.PP
نام کاربری (معمولاً ایمیل).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_USER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --mailru-pass
.PP
گذرواژه.
.PP
این مقدار باید یک گذرواژهٔ اختصاصی برنامه (app password) باشد - rclone با گذرواژهٔ عادی شما کار نخواهد کرد.
برای نحوهٔ ساخت گذرواژهٔ برنامه، بخش پیکربندی (Configuration) را در مستندات ببینید.
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی شده باشد - دستور rclone obscure را ببینید (https://rclone.org/commands/rclone_obscure).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pass
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_PASS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --mailru-speedup-enable
.PP
اگر فایل دیگری با هش دادهٔ یکسان وجود داشته باشد، از بارگذاری کامل صرف‌نظر می‌شود.
.PP
این قابلیت \[dq]speedup\[dq] یا \[dq]put by hash\[dq] نامیده می‌شود.
این ویژگی به‌ویژه برای فایل‌های در دسترس عموم مانند کتاب‌های محبوب، ویدیوها یا کلیپ‌های صوتی بسیار کارآمد است، چرا که فایل‌ها بر اساس هش در تمام حساب‌های همهٔ کاربران mailru جستجو می‌شوند.
اگر فایل منبع یکتا یا رمزنگاری‌شده باشد، این قابلیت بی‌معنی و ناکارآمد خواهد بود.
لطفاً توجه داشته باشید که rclone ممکن است برای محاسبهٔ پیشاپیش هش محتوا و تصمیم‌گیری دربارهٔ لزوم بارگذاری کامل، به حافظه و فضای دیسک محلی نیاز داشته باشد.
همچنین، اگر rclone اندازهٔ فایل را از پیش نداند (برای نمونه در جریان‌سازی داده‌ها یا بارگذاری‌های جزئی)، حتی این بهینه‌سازی را امتحان هم نخواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: speedup_enable
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_SPEEDUP_ENABLE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]true\[dq]
.RS 2
.IP \[bu] 2
فعال
.RE
.IP \[bu] 2
\[dq]false\[dq]
.RS 2
.IP \[bu] 2
غیرفعال
.RE
.RE.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مختص mailru (Mail.ru Cloud) آورده شده است.
.SS --mailru-token
.PP
توکن دسترسی OAuth به‌صورت یک JSON blob.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --mailru-auth-url
.PP
نشانی اینترنتی (URL) سرور احراز هویت (Auth).
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --mailru-token-url
.PP
نشانی اینترنتی (URL) سرور توکن.
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --mailru-client-credentials
.PP
استفاده از جریان اعتبارسنجی کلاینت (client credentials) در OAuth.
.PP
این گزینه از جریان OAUTH2 client Credentials Flow همان‌طور که در RFC 6749 شرح داده شده است استفاده می‌کند.
.PP
توجه داشته باشید که این گزینه توسط همه بک‌اندها پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --mailru-speedup-file-patterns
.PP
فهرستی از الگوهای نام فایل جداشده با کاما که واجد شرایط افزایش سرعت (ارسال با هش / put by hash) هستند.
.PP
الگوها نسبت به کوچکی و بزرگی حروف حساس نیستند و می‌توانند شامل نویسه‌های عام \[aq]*\[aq] یا \[aq]?\[aq] باشند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: speedup_file_patterns
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_SPEEDUP_FILE_PATTERNS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض:
\[dq]\f[I].mkv,\f[R].avi,\f[I].mp4,\f[R].mp3,\f[I].zip,\f[R].gz,\f[I].rar,\f[R].pdf\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
فهرست خالی افزایش سرعت (put by hash) را کاملاً غیرفعال می‌کند.
.RE
.IP \[bu] 2
\[dq]*\[dq]
.RS 2
.IP \[bu] 2
برای تمام فایل‌ها افزایش سرعت امتحان خواهد شد.
.RE
.IP \[bu] 2
\[dq]\f[I].mkv,\f[R].avi,\f[I].mp4,\f[R].mp3\[dq]
.RS 2
.IP \[bu] 2
افزایش سرعت با هش (put by hash) فقط برای فایل‌های صوتی/تصویری متداول امتحان می‌شود.
.RE
.IP \[bu] 2
\[dq]\f[I].zip,\f[R].gz,\f[I].rar,\f[R].pdf\[dq]
.RS 2
.IP \[bu] 2
افزایش سرعت فقط برای فایل‌های آرشیو متداول یا کتاب‌های PDF امتحان می‌شود.
.RE
.RE.SS --mailru-speedup-max-disk
.PP
این گزینه به شما امکان می‌دهد شتاب‌دهی (بارگذاری از طریق هش یا put by hash) را برای فایل‌های بزرگ غیرفعال کنید.
.PP
دلیل آن این است که محاسبه مقدماتی هش می‌تواند حافظه RAM یا فضای دیسک شما را به پایان برساند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: speedup_max_disk
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_SPEEDUP_MAX_DISK
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 3Gi
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]0\[dq]
.RS 2
.IP \[bu] 2
غیرفعال‌سازی کامل شتاب‌دهی (بارگذاری از طریق هش).
.RE
.IP \[bu] 2
\[dq]1G\[dq]
.RS 2
.IP \[bu] 2
فایل‌های بزرگ‌تر از 1Gb به‌طور مستقیم بارگذاری خواهند شد.
.RE
.IP \[bu] 2
\[dq]3G\[dq]
.RS 2
.IP \[bu] 2
اگر کمتر از 3Gb فضای خالی روی دیسک محلی دارید، این گزینه را انتخاب کنید.
.RE
.RE
.SS --mailru-speedup-max-memory
.PP
فایل‌های بزرگ‌تر از اندازه تعیین‌شده در زیر، همیشه روی دیسک هش می‌شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: speedup_max_memory
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_SPEEDUP_MAX_MEMORY
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 32Mi
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]0\[dq]
.RS 2
.IP \[bu] 2
محاسبه مقدماتی هش همیشه در یک مکان موقت روی دیسک انجام خواهد شد.
.RE
.IP \[bu] 2
\[dq]32M\[dq]
.RS 2
.IP \[bu] 2
بیش از 32Mb از حافظه RAM را به محاسبه مقدماتی هش اختصاص ندهید.
.RE
.IP \[bu] 2
\[dq]256M\[dq]
.RS 2
.IP \[bu] 2
حداکثر 256Mb حافظه RAM آزاد برای محاسبات هش دارید.
.RE
.RE
.SS --mailru-check-hash
.PP
رفتار دستور copy در صورت عدم تطابق یا نامعتبر بودن چکسام (checksum) فایل.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: check_hash
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_CHECK_HASH
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]true\[dq]
.RS 2
.IP \[bu] 2
با خطا متوقف شود.
.RE
.IP \[bu] 2
\[dq]false\[dq]
.RS 2
.IP \[bu] 2
نادیده گرفته و ادامه دهد.
.RE
.RE.SS --mailru-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر بخش کدگذاری را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,InvalidUtf8,Dot
.SS --mailru-description
.PP
توضیحات remote.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_MAILRU_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS محدودیت‌ها
.PP
محدودیت‌های اندازه فایل به حساب کاربری شما بستگی دارد.
اندازه هر فایل برای یک حساب رایگان به 2G محدود بوده و برای
طرح‌های پولی نامحدود است.
لطفاً برای اطلاع از محدودیت‌های کل حجم بارگذاری‌شده به وب‌سایت Mail.ru مراجعه کنید.
.PP
توجه داشته باشید که Mailru به حروف بزرگ و کوچک حساس نیست؛ بنابراین نمی‌توانید فایلی با نام
\[dq]Hello.doc\[dq] و فایلی با نام \[dq]hello.doc\[dq] داشته باشید.
.SH Mega
.PP
سرویس Mega (https://mega.nz) یک فضای ذخیره‌سازی ابری و میزبانی فایل است
که به خاطر قابلیت امنیتی خود، یعنی رمزگذاری محلی تمام فایل‌ها پیش از بارگذاری،
شناخته می‌شود.
این امر مانع از دسترسی هر فردی (از جمله کارکنان Mega) به
فایل‌ها بدون دانستن کلید استفاده‌شده برای رمزگذاری می‌شود.
.PP
این یک backend برای Mega در rclone است که از قابلیت‌های انتقال فایل
Mega با استفاده از همان رمزگذاری سمت کاربر پشتیبانی می‌کند.
.PP
\f[B]نکته:\f[R] فضای ذخیره‌سازی شیء MEGA S4 که یک فضای ذخیره‌سازی شیء سازگار با S3 است
نیز با rclone کار می‌کند و برای پروژه‌های جدید توصیه می‌شود.
.PP
مسیرها به‌صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند به هر عمق مورد نیازی باشند؛ مانند
\f[V]remote:directory/subdirectory\f[R].
.SS پیکربندی
.PP
در اینجا مثالی از نحوه ایجاد یک remote با نام \f[V]remote\f[R] آورده شده است.
ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این کار شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Mega
   \[rs] \[dq]mega\[dq]
[snip]
Storage> mega
User name
user> you\[at]example.com
Password.
y) Yes type in my own password
g) Generate random password
n) No leave this optional password blank
y/g/n> y
Enter the password:
password:
Confirm the password:
password:
Remote config
Configuration complete.
Options:
- type: mega
- user: you\[at]example.com
- pass: *** ENCRYPTED ***
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
\f[B]نکته:\f[R] کلیدهای رمزگذاری باید قبلاً پس از یک ورود عادی از طریق مرورگر
ایجاد شده باشند؛ در غیر این صورت، تلاش برای استفاده از اطلاعات اعتباری در \f[V]rclone\f[R] با شکست مواجه خواهد شد.
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به‌صورت زیر استفاده کنید (\f[V]remote\f[R]
را با نامی که به remote خود داده‌اید جایگزین کنید):
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح Mega شما
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در Mega شما
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی در یک دایرکتوری Mega به نام backup
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها
.PP
Mega هنوز از زمان‌های تغییر یا هش‌ها پشتیبانی نمی‌کند.
.SS نویسه‌های محدودشده در نام فایل
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
NUL
T}@T{
0x00
T}@T{
␀
T}
T{
/
T}@T{
0x2F
T}@T{
／
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند شد (https://rclone.org/overview/#invalid-utf8)، چرا که نمی‌توان از آن‌ها در رشته‌های JSON استفاده کرد.
.SS فایل‌های تکراری
.PP
در Mega (برخلاف یک سیستم‌فایل معمولی) ممکن است دو فایل با نام و مسیر کاملاً یکسان وجود داشته باشند.
.PP
فایل‌های تکراری در همگام‌سازی اختلال ایجاد می‌کنند و پیام‌هایی دربارهٔ موارد تکراری در لاگ مشاهده خواهید کرد.
.PP
برای برطرف کردن فایل‌های تکراری از \f[V]rclone dedupe\f[R] استفاده کنید.
.SS خطا در ورود به سیستم
.SS شیء یافت نشد
.PP
اگر برای نخستین بار جهت آزمایش دسترسی و همگام‌سازی به ریموت Mega خود متصل می‌شوید، ممکن است خطایی مانند زیر دریافت کنید:
.IP
.nf
\f[C]
Failed to create file system for \[dq]my-mega-remote:\[dq]:
couldn\[aq]t login: Object (typically, node or user) not found
\f[R]
.fi
.PP
مراحل عیب‌یابی که اغلب در انجمن rclone
(https://forum.rclone.org/search?q=mega) توصیه می‌شوند با ابزار
\f[B]MEGAcmd\f[R] آغاز می‌گردند.
توجه داشته باشید که این به دستور رسمی C++ از
<https://github.com/meganz/MEGAcmd> اشاره دارد، نه دستوری که با زبان go
توسط t3rm1n4l/megacmd ساخته شده و دیگر نگهداری نمی‌شود.
.PP
دستورالعمل‌های نصب MEGAcmd را دنبال کرده و همان‌طور که توصیه شده است، دسترسی به
ریموت خود را امتحان کنید.
می‌توانید بررسی کنید که آیا امکان ورود با استفاده از MEGAcmd وجود دارد یا خیر، و
اطلاعات عیب‌یابی مفیدی به دست آورید و در تالار گفتگو جستجو کنید یا با دیگران
همکاری نمایید.
.IP
.nf
\f[C]
MEGA CMD> login me\[at]example.com
Password:
Fetching nodes ...
Loading transfers from local cache
Login complete as me\[at]example.com
me\[at]example.com:/$ 
\f[R]
.fi
.PP
توجه داشته باشید که برخی کاربران با گذرواژه‌های حاوی نویسه‌های خاص با مشکلاتی مواجه
شده‌اند.
اگر نمی‌توانید با rclone وارد شوید اما MEGAcmd بدون مشکل وارد می‌شود، گذرواژهٔ
خود را موقتاً به نویسه‌های صرفاً الفبایی-عددی تغییر دهید، شاید مشکل برطرف شود..SS مسدود شدن دسترسی بر اثر دستورهای مکرر
.PP
به نظر می‌رسد ریموت‌های Mega در شرایط \[dq]استفادهٔ سنگین\[dq] مسدود می‌شوند (ورودها را رد می‌کنند).
ما هنوز قواعد دقیق این مسدودسازی را نیافته‌ایم، اما به نظر می‌رسد این مسئله به دستورهای متوالی و سریع rclone مرتبط باشد.
.PP
برای نمونه، اجرای ۹۰ بار متوالی دستور
\f[V]rclone link remote:file\f[R] باعث \[dq]مسدود شدن\[dq] ریموت می‌شود.
این یک موقعیت غیرعادی نیست؛ مثلاً زمانی پیش می‌آید که می‌خواهید پیوندهای عمومی یک دایرکتوری با صدها فایل را به دست آورید...
تقریباً پس از یک هفته، ریموت دوباره ورودهای rclone را به صورت عادی خواهد پذیرفت.
.PP
می‌توانید با سوار کردن ریموت با دستور
\f[V]rclone mount\f[R] این مشکل را کاهش دهید.
این روش تنها هنگام سوار کردن (mount) وارد شده و هنگام پیاده‌سازی (unmount) خارج می‌شود.
همچنین می‌توانید \f[V]rclone rcd\f[R] را اجرا کرده و سپس از \f[V]rclone rc\f[R]
برای اجرای دستورها از طریق API استفاده کنید تا از ورود مجدد در هر بار جلوگیری شود.
.PP
در حال حاضر Rclone نشست‌های mega را نمی‌بندد (می‌توانید آن‌ها را در رابط وب مشاهده کنید)، با این وجود بستن نشست‌ها نیز مشکل را برطرف نمی‌کند.
.PP
اگر بین دستورهای rclone سه ثانیه فاصله بیندازید، از مسدود شدن ریموت جلوگیری خواهد شد.
ما قواعد دقیق مسدودسازی را مشخص نکرده‌ایم؛ شاید بتوان یک دستور را ۸۰ بار بدون درنگ اجرا کرد و با ۳ ثانیه صبر کردن و سپس ادامه دادن، از مسدود شدن دوری کرد...
.PP
توجه داشته باشید که این موارد بر اساس آزمون و خطا به دست آمده و ممکن است یک قانون قطعی و تغییرناپذیر نباشد.
.PP
به نظر می‌رسد ابزارهای دیگر این مشکل مسدودسازی را ایجاد نمی‌کنند، زیرا آن‌ها رویکرد کاری متفاوتی دارند (مبتنی بر وضعیت یا state-based، با استفاده از sessionID به جای هر بار ورود) که با رویکرد بدون وضعیت (stateless) فعلی rclone سازگار نیست.
.PP
توجه داشته باشید که پس از مسدود شدن، استفاده از ابزارهای دیگر (مانند megacmd) یک راهکار قطعی نیست: برای یک ریموت مسدودشده، زمان‌های ورود megacmd به طور متوالی به این صورت مشاهده شده است: ۷ دقیقه، ۲۰ دقیقه، ۳۰ دقیقه، ۳۰ دقیقه، ۳۰ دقیقه.
با این وجود دسترسی از طریق وب دست‌نخورده باقی می‌ماند.
.PP
تحقیقات در رابطه با راهکارهای مبتنی بر وقفه (timeout)، تنظیم‌کننده سرعت (pacer)، تلاش مجدد (retrial) و tpslimits همچنان ادامه دارد؛ اگر نکتهٔ مرتبطی یافتید، لطفاً آن را در انجمن مطرح کنید.
.PP
بنابراین، اگر rclone به خوبی کار می‌کرد و ناگهان قادر به ورود نیستید در حالی که از صحت نام کاربری و گذرواژه مطمئن هستید، به احتمال زیاد ریموت شما برای مدتی مسدود شده است.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص به mega (Mega) آورده شده است.
.SS --mega-user
.PP
نام کاربری.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user
.IP \[bu] 2
متغیر محیطی: RCLONE_MEGA_USER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: true
.SS --mega-pass
.PP
گذرواژه.
.PP
\f[B]نکته\f[R] ورودی این گزینه باید مبهم‌سازی شده باشد - مستندات rclone obscure (<https://rclone.org/commands/rclone_obscure>) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pass
.IP \[bu] 2
متغیر محیطی: RCLONE_MEGA_PASS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: true.SS --mega-2fa
.PP
کد 2FA حساب MEGA شما، در صورتی که حساب با آن تنظیم شده باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: 2fa
.IP \[bu] 2
متغیر محیطی: RCLONE_MEGA_2FA
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مخصوص mega (Mega) آورده شده است.
.SS --mega-debug
.PP
چاپ خروجی اشکال‌زدایی بیشتر از Mega.
.PP
اگر این پرچم (همراه با \-vv) تنظیم شود، اطلاعات اشکال‌زدایی بیشتری را
از backend مربوط به mega چاپ خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: debug
.IP \[bu] 2
متغیر محیطی: RCLONE_MEGA_DEBUG
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --mega-hard-delete
.PP
حذف دائمی فایل‌ها به جای انداختن آن‌ها در سطل زباله.
.PP
به طور معمول backend مربوط به mega تمام موارد حذفی را به جای حذف دائمی
به سطل زباله منتقل می‌کند.
اگر این گزینه را مشخص کنید، rclone در عوض اشیاء را برای همیشه حذف خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hard_delete
.IP \[bu] 2
متغیر محیطی: RCLONE_MEGA_HARD_DELETE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --mega-use-https
.PP
استفاده از HTTPS برای انتقال‌ها.
.PP
‏MEGA به صورت پیش‌فرض از اتصالات متنی ساده HTTP استفاده می‌کند.
برخی از ISPها اتصالات HTTP را محدود (throttle) می‌کنند که باعث می‌شود
انتقال‌ها بسیار کند شوند.
فعال کردن این گزینه، MEGA را مجبور می‌کند برای همه انتقال‌ها از HTTPS استفاده کند.
‏HTTPS معمولاً ضروری نیست زیرا در هر حال تمام داده‌ها از قبل رمزگذاری شده‌اند.
فعال کردن آن مصرف CPU را افزایش داده و سربار شبکه اضافه می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_https
.IP \[bu] 2
متغیر محیطی: RCLONE_MEGA_USE_HTTPS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --mega-encoding
.PP
کدگذاری (encoding) برای backend.
.PP
برای اطلاعات بیشتر، بخش encoding را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_MEGA_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,InvalidUtf8,Dot.SS --mega-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_MEGA_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS فرآیند \f[V]killed\f[R] (Process killed)
.PP
در حساب‌هایی با فایل‌های بزرگ یا موارد دیگر، مصرف حافظه هنگام اجرای دستورالعمل‌های list/sync می‌تواند به‌طور چشمگیری افزایش یابد.
هنگام اجرا روی ارائه‌دهندگان ابری (مانند AWS با EC2)، بررسی کنید که آیا نوع نمونه (instance type) حافظه/CPU کافی برای اجرای دستورات دارد یا خیر.
پس از ارسال دستورات، از ابزارهای پایش منابع برای بررسی وضعیت استفاده کنید.
به این گزارش خطا مراجعه کنید:
(https://forum.rclone.org/t/rclone-with-mega-appears-to-work-only-in-some-accounts/40233/4).
.SS محدودیت‌ها (Limitations)
.PP
این backend از کتابخانهٔ go-mega در زبان Go استفاده می‌کند
(https://github.com/t3rm1n4l/go-mega) که یک کتابخانهٔ متن‌باز Go
برای پیاده‌سازی Mega API است.
به‌نظر نمی‌رسد هیچ مستنداتی برای پروتکل mega فراتر از کد منبع
mega C++ SDK (https://github.com/meganz/sdk) وجود داشته باشد، بنابراین
احتمالاً خطاهای متعددی همچنان در این کتابخانه باقی مانده است.
.PP
سرویس Mega اجازهٔ وجود فایل‌های تکراری را می‌دهد که این امر ممکن است rclone را دچار سردرگمی کند.
.SH "حافظه (Memory)"
.PP
بک‌اند memory یک بک‌اند درون حافظه (RAM) است.
این بک‌اند داده‌های خود را به‌صورت دائمی ذخیره نمی‌کند \- برای این منظور از بک‌اند local استفاده کنید.
.PP
بک‌اند memory مانند یک ریموت مبتنی بر باکت (مانند s3) رفتار می‌کند.
از آنجا که هیچ پارامتری ندارد، می‌توانید به‌سادگی از آن با نام
ریموت \f[V]:memory:\f[R] استفاده کنید.
.SS پیکربندی (Configuration)
.PP
در صورت تمایل، می‌توانید آن را با \f[V]rclone config\f[R] نیز به‌صورت
یک ریموت پیکربندی کنید:
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / Memory
   \[rs] \[dq]memory\[dq]
[snip]
Storage> memory
** See help for memory backend at: https://rclone.org/memory **

Remote config

Configuration complete.
Options:
- type: memory
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
از آنجا که بک‌اند memory داده‌ها را به‌طور دائم ذخیره نمی‌کند، بیشترین کاربرد آن برای
آزمایش یا همراه با یک rclone server یا rclone mount است؛ به‌عنوان مثال:
.IP
.nf
\f[C]
rclone mount :memory: /mnt/tmp
rclone serve webdav :memory:
rclone serve sftp :memory:
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها
.PP
بک‌اند memory از هش‌های MD5 و زمان‌های تغییر با دقت ۱ نانوثانیه (1 nS) پشتیبانی می‌کند.
.SS نویسه‌های محدودشده نام فایل
.PP
بک‌اند memory مجموعه نویسه‌های محدودشده پیش‌فرض را جایگزین می‌کند (https://rclone.org/overview/#restricted-characters).
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مختص memory (سیستم ذخیره‌سازی شیء در حافظه) آمده است.
.SS --memory-discard
.PP
در صورت تنظیم، تمام عملیات نوشتن دور ریخته شده و عملیات خواندن یک خطا برمی‌گردانند.
.PP
اگر تنظیم شود، هنگام آپلود فایل‌ها، محتویات ذخیره نمی‌شوند.
به نظر می‌رسد فایل‌ها آپلود شده‌اند اما در هنگام خواندن با خطا مواجه می‌شوند.
مجموع MD5 فایل‌ها در هنگام آپلود محاسبه می‌شود که زمان پردازنده بسیار ناچیزی مصرف کرده و امکان بررسی صحت انتقال را فراهم می‌کند.
.PP
این گزینه می‌تواند برای آزمایش کارایی مفید باشد.
.PP
احتمالاً ساده‌ترین روش، استفاده از نحو رشته اتصال (connection string) است:
.IP
.nf
\f[C]
:memory,discard:bucket
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: discard
.IP \[bu] 2
متغیر محیطی: RCLONE_MEMORY_DISCARD
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --memory-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_MEMORY_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SH Akamai NetStorage
.PP
مسیرها به صورت \f[V]remote:\f[R] مشخص می‌شوند. شما می‌توانید زیرپوشه‌ها را نیز اضافه کنید، مانند
\f[V]remote:/path/to/dir\f[R].
اگر CP code دارید، می‌توانید از آن به عنوان پوشه بعد از دامنه استفاده کنید، مانند <domain>/<cpcode>/<internal directories within cpcode>.
.PP
برای نمونه، پیکربندی این مورد معمولاً با یا بدون CP code انجام می‌شود:
.IP \[bu] 2
\f[B]همراه با CP code\f[R].
\f[V][your-domain-prefix]-nsu.akamaihd.net/123456/subdirectory/\f[R]
.IP \[bu] 2
\f[B]بدون CP code\f[R].
\f[V][your-domain-prefix]-nsu.akamaihd.net\f[R]
.PP
مشاهده تمام باکت‌ها:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
راه‌اندازی اولیه Netstorage نیازمند دریافت یک حساب کاربری (account) و کلید امنیتی (secret) است.
از \f[V]rclone config\f[R] برای هدایت گام‌به‌گام در فرآیند راه‌اندازی استفاده کنید..SS "پیکربندی (Configuration)"
.PP
در اینجا مثالی از نحوه ایجاد یک ریموت به نام \f[V]ns1\f[R] آورده شده است.
.IP "1." 3
برای شروع فرایند پیکربندی تعاملی، این دستور را وارد کنید:
.RS 4
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.RE
.IP "2." 3
برای ایجاد یک ریموت جدید، \f[V]n\f[R] را تایپ کنید.
.RS 4
.IP
.nf
\f[C]
n) New remote
d) Delete remote
q) Quit config
e/n/d/q> n
\f[R]
.fi
.RE
.IP "3." 3
برای این مثال، هنگامی که به اعلان name> رسیدید، \f[V]ns1\f[R] را وارد کنید.
.RS 4
.IP
.nf
\f[C]
name> ns1
\f[R]
.fi
.RE
.IP "4." 3
به عنوان نوع فضای ذخیره‌سازی برای پیکربندی، \f[V]netstorage\f[R] را وارد کنید.
.RS 4
.IP
.nf
\f[C]
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
XX / NetStorage
   \[rs] \[dq]netstorage\[dq]
Storage> netstorage
\f[R]
.fi
.RE
.IP "5." 3
میان پروتکل HTTP یا HTTPS یکی را انتخاب کنید.
بیشتر کاربران باید HTTPS را انتخاب کنند که پیش‌فرض است.
پروتکل HTTP عمدتاً برای اهداف اشکال‌زدایی ارائه شده است.
.RS 4
.IP
.nf
\f[C]
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / HTTP protocol
   \[rs] \[dq]http\[dq]
 2 / HTTPS protocol
   \[rs] \[dq]https\[dq]
protocol> 1
\f[R]
.fi
.RE
.IP "6." 3
میزبان NetStorage، کد CP و هر مسیر محتوای لازم خود را با استفاده از این قالب مشخص کنید: \f[V]<domain>/<cpcode>/<content>/\f[R]
.RS 4
.IP
.nf
\f[C]
Enter a string value. Press Enter for the default (\[dq]\[dq]).
host> baseball-nsu.akamaihd.net/123456/content/
\f[R]
.fi
.RE
.IP "7." 3
نام حساب کاربری netstorage را تنظیم کنید.
.RS 4
.IP
.nf
\f[C]
Enter a string value. Press Enter for the default (\[dq]\[dq]).
account> username
\f[R]
.fi
.RE
.IP "8." 3
کلید مخفی (secret) یا کلید G2O حساب NetStorage را که برای اهداف احراز هویت استفاده می‌شود تنظیم کنید.
گزینه \f[V]y\f[R] را برای تعیین گذرواژه خودتان انتخاب کرده و سپس کلید مخفی را وارد کنید.
نکته: کلید مخفی با رمزنگاری کدگذاری‌شده به صورت هگزادسیمال در فایل \f[V]rclone.conf\f[R] ذخیره می‌شود.
.RS 4
.IP
.nf
\f[C]
y) Yes type in my own password
g) Generate random password
y/g> y
Enter the password:
password:
Confirm the password:
password:
\f[R]
.fi
.RE
.IP "9." 3
خلاصه را مشاهده کرده و پیکربندی ریموت خود را تأیید کنید.
.RS 4
.IP
.nf
\f[C]
[ns1]
type = netstorage
protocol = http
host = baseball-nsu.akamaihd.net/123456/content/
account = username
secret = *** ENCRYPTED ***
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.RE
.PP
این ریموت \f[V]ns1\f[R] نام دارد و اکنون آماده استفاده است..SS نمونه‌های عملیات
.PP
با این نمونه‌ها کار با rclone و NetStorage را آغاز کنید.
برای مشاهده دستورهای بیشتر rclone، از <https://rclone.org/commands> دیدن کنید.
.SS مشاهده محتویات یک دایرکتوری در پروژه شما
.IP
.nf
\f[C]
rclone lsd ns1:/974012/testing/
\f[R]
.fi
.SS همگام‌سازی محتویات محلی با ریموت
.IP
.nf
\f[C]
rclone sync . ns1:/974012/testing/
\f[R]
.fi
.SS بارگذاری محتوای محلی روی ریموت
.IP
.nf
\f[C]
rclone copy notes.txt ns1:/974012/testing/
\f[R]
.fi
.SS حذف محتوا روی ریموت
.IP
.nf
\f[C]
rclone delete ns1:/974012/testing/notes.txt
\f[R]
.fi
.SS جابه‌جایی یا کپی محتوا بین کدهای CP
.PP
اعتبارنامه‌های شما باید به دو کد CP روی یک ریموت یکسان دسترسی داشته باشند.
نمی‌توانید عملیات‌ها را بین ریموت‌های مختلف انجام دهید.
.IP
.nf
\f[C]
rclone move ns1:/974012/testing/notes.txt ns1:/974450/testing2/
\f[R]
.fi
.SS ویژگی‌ها
.SS پشتیبانی از پیوندهای نمادین (Symlink)
.PP
بک‌اند NetStorage رفتار \f[V]--links, -l\f[R] در rclone را تغییر می‌دهد.
هنگام بارگذاری، به جای ایجاد فایل .rclonelink، از API مربوط به \[dq]symlink\[dq] به منظور ایجاد پیوند نمادین متناظر روی ریموت استفاده می‌شود.
فایل .rclonelink ایجاد نخواهد شد، جلوی بارگذاری گرفته می‌شود و تنها فایل پیوند نمادینی که با نام فایل منبع بدون پسوند مطابقت دارد بر روی ریموت ایجاد خواهد شد.
.PP
این امر عملاً به دستورهایی مانند copy/copyto، move/moveto و sync اجازه می‌دهد دایرکتوری‌های دارای پیوند نمادین را از محلی به ریموت بارگذاری کرده و از ریموت به محلی دانلود کنند.
به دلیل محدودیت‌های داخلی rclone، امکان بارگذاری یک فایل پیوند نمادین مجزا به هر بک‌اند ریموت وجود ندارد.
همواره می‌توانید از دستور \[dq]backend symlink\[dq] برای ایجاد پیوند نمادین روی سرور NetStorage استفاده کنید؛ به بخش \[dq]symlink\[dq] در ادامه مراجعه نمایید.
.PP
فایل‌های پیوند نمادین مجزا بر روی ریموت می‌توانند با دستورهایی مانند \[dq]cat\[dq] برای چاپ نام مقصد، یا \[dq]delete\[dq] برای حذف پیوند نمادین، یا copy، copy/to و move/moveto برای بارگیری از ریموت به محلی استفاده شوند.
نکته: فایل‌های پیوند نمادین مجزا بر روی ریموت باید با احتساب پسوند .rclonelink مشخص شوند.
.PP
\f[B]نکته\f[R]: هیچ فایلی با پسوند .rclonelink نباید روی سرور وجود داشته باشد، زیرا در عمل امکان بارگذاری/ایجاد فایلی با پسوند .rclonelink از طریق rclone وجود ندارد؛ چنین فایلی تنها در صورتی می‌تواند وجود داشته باشد که به روشی غیر از rclone به صورت دستی روی ریموت ایجاد شده باشد.
.SS دایرکتوری‌های ضمنی (Implicit) در برابر صریح (Explicit)
.PP
در NetStorage، دایرکتوری‌ها می‌توانند در یکی از دو حالت وجود داشته باشند:
.IP "1." 3
\f[B]دایرکتوری صریح (Explicit Directory)\f[R].
این یک دایرکتوری فیزیکی واقعی است که شما در یک گروه ذخیره‌سازی ایجاد کرده‌اید.
.IP "2." 3
\f[B]دایرکتوری ضمنی (Implicit Directory)\f[R].
این مفهوم به دایرکتوری‌ای در یک مسیر اشاره دارد که به صورت فیزیکی ایجاد نشده است.
برای مثال، هنگام بارگذاری یک فایل، زیردایرکتوری‌های ناموجود می‌توانند در مسیر مقصد مشخص شوند.
‏NetStorage این‌ها را به عنوان \[dq]ضمنی\[dq] ایجاد می‌کند. در حالی که این دایرکتوری‌ها به صورت فیزیکی ایجاد نشده‌اند، اما به صورت ضمنی وجود دارند و مسیر ذکر شده با فایل بارگذاری‌شده مرتبط می‌شود.
.PP
‏Rclone تمام بارگذاری‌های فایل و دستورهای mkdir را برای ریموت NetStorage رهگیری کرده و به طور صریح دستور mkdir را برای هر دایرکتوری در مسیر بارگذاری اجرا می‌کند.
این امر به سازگاری با سایر سرویس‌های Akamai مانند SFTP و Content Management Shell (CMShell) کمک خواهد کرد.
‏Rclone صحت عملیات‌ها را با دایرکتوری‌های ضمنی که ممکن است در نتیجه استفاده مستقیم از یک API بارگذاری ایجاد شده باشند، تضمین نمی‌کند..SS پشتیبانی از \f[V]--fast-list\f[R] / ListR
.PP
ریموت NetStorage با استفاده از اکشن \[dq]list\[dq] در NetStorage API، از قابلیت ListR برای بازگرداندن یک فهرست الفبایی از تمام اشیاء درون CP code مشخص‌شده و پیمایش بازگشتی در زیردایرکتوری‌ها به هنگام مواجهه با آن‌ها، پشتیبانی می‌کند.
.IP \[bu] 2
\f[B]ابزار Rclone به‌طور پیش‌فرض برای برخی دستورها از روش ListR استفاده می‌کند\f[R].
دستورهایی مانند \f[V]lsf -R\f[R] به‌طور پیش‌فرض از ListR استفاده خواهند کرد.
برای غیرفعال کردن این مورد، گزینهٔ \f[V]--disable listR\f[R] را تعیین کنید تا از روش غیربازگشتی فهرست کردن اشیاء استفاده شود.
.IP \[bu] 2
\f[B]ابزار Rclone برای برخی دستورها از روش ListR استفاده نخواهد کرد\f[R].
دستورهایی مانند \f[V]sync\f[R] به‌طور پیش‌فرض از ListR استفاده نمی‌کنند.
برای اجبار به استفاده از روش ListR، گزینهٔ \f[V]--fast-list\f[R] را اضافه کنید.
.PP
استفاده از روش ListR مزایا و معایبی دارد؛ به مستندات rclone مراجعه کنید (<https://rclone.org/docs/#fast-list>).
به‌طور کلی، اجرای دستور sync روی یک ساختار درختی عمیقِ موجود در ریموت با پرچم \[dq]--fast-list\[dq] سریع‌تر اجرا خواهد شد، اما استفادهٔ بیشتر از حافظه را به عنوان یک اثر جانبی به همراه دارد.
این کار همچنین ممکن است منجر به استفاده بیشتر از پردازنده (CPU) شود، اما کل عملیات سریع‌تر تکمیل می‌گردد.
.PP
\f[B]نکته\f[R]: یک محدودیت شناخته‌شده وجود دارد که هنگام استفاده از روش ListR، دستور \[dq]lsf -R\[dq] تعداد فایل‌های موجود در دایرکتوری و اندازهٔ دایرکتوری را \-1 نمایش می‌دهد.
راهکار جایگزین این است که در صورت اهمیت داشتن این اعداد در خروجی، پرچم \[dq]--disable listR\[dq] ارسال شود.
.SS Purge
.PP
ریموت NetStorage با استفاده از اکشن API تحت عنوان \[dq]quick-delete\[dq] در NetStorage، از قابلیت purge پشتیبانی می‌کند.
اکشن quick-delete بنا به دلایل امنیتی به‌طور پیش‌فرض غیرفعال است و می‌تواند از طریق پورتال Akamai برای حساب کاربری فعال شود.
ابزار Rclone در ابتدا تلاش می‌کند از اکشن quick-delete برای دستور purge استفاده کند و در صورتی که این عملکرد غیرفعال باشد، به روش حذف استاندارد بازمی‌گردد.
.PP
\f[B]نکته\f[R]: برای ملاحظات مربوط به استفاده از \[dq]quick-delete\[dq]، مستندات NetStorage Usage API (<https://learn.akamai.com/en-us/webhelp/netstorage/netstorage-http-api-developer-guide/GUID-15836617-9F50-405A-833C-EA2556756A30.html>) را مطالعه کنید.
به‌طور کلی، استفاده از روش quick-delete ساختار درختی را فوراً حذف نخواهد کرد و اشیاء هدف‌گذاری‌شده برای quick-delete ممکن است همچنان در دسترس باشند.
.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد ویژهٔ netstorage (سرویس Akamai NetStorage) آورده شده است.
.SS --netstorage-host
.PP
دامنه+مسیر (Domain+path) میزبان NetStorage جهت اتصال.
.PP
قالب باید به صورت \f[V]<domain>/<internal folders>\f[R] باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: host
.IP \[bu] 2
متغیر محیطی: RCLONE_NETSTORAGE_HOST
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --netstorage-account
.PP
تنظیم نام حساب کاربری NetStorage.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: account
.IP \[bu] 2
متغیر محیطی: RCLONE_NETSTORAGE_ACCOUNT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --netstorage-secret
.PP
تنظیم کلید رمز/G2O حساب NetStorage برای احراز هویت.
.PP
لطفاً گزینهٔ \[aq]y\[aq] را برای تنظیم گذرواژهٔ خود انتخاب کرده و سپس کلید رمز خود را وارد کنید.
.PP
\f[B]توجه\f[R]: ورودی این گزینه باید مبهم‌سازی شده باشد \- دستور rclone obscure (<https://rclone.org/commands/rclone_obscure>) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: secret
.IP \[bu] 2
متغیر محیطی: RCLONE_NETSTORAGE_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مختص netstorage (سامانه Akamai
NetStorage) آمده است.
.SS --netstorage-protocol
.PP
انتخاب بین پروتکل HTTP یا HTTPS.
.PP
بیشتر کاربران باید HTTPS را انتخاب کنند که پیش‌فرض است.
HTTP در اصل برای اهداف اشکال‌زدایی ارائه شده است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: protocol
.IP \[bu] 2
متغیر محیطی: RCLONE_NETSTORAGE_PROTOCOL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]https\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]http\[dq]
.RS 2
.IP \[bu] 2
پروتکل HTTP
.RE
.IP \[bu] 2
\[dq]https\[dq]
.RS 2
.IP \[bu] 2
پروتکل HTTPS
.RE
.RE
.SS --netstorage-description
.PP
توضیحات ریموت (remote).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_NETSTORAGE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS دستورهای Backend
.PP
در اینجا دستورهای مختص backend نت‌استوریج آورده شده است.
.PP
آن‌ها را به این صورت اجرا کنید:
.IP
.nf
\f[C]
rclone backend COMMAND remote:
\f[R]
.fi
.PP
راهنمای زیر توضیح خواهد داد که هر دستور چه آرگومان‌هایی دریافت می‌کند.
.PP
برای اطلاعات بیشتر درباره نحوه ارسال گزینه‌ها و آرگومان‌ها، دستور
backend (https://rclone.org/commands/rclone_backend)
را ببینید.
.PP
این دستورها را می‌توان بر روی یک backend در حال اجرا با استفاده از دستور rc به‌صورت
backend/command (https://rclone.org/rc#backend-command)
اجرا کرد.
.SS du
.PP
بازگرداندن اطلاعات میزان مصرف دیسک برای یک دایرکتوری مشخص‌شده.
.IP
.nf
\f[C]
rclone backend du remote: [options] [<arguments>+]
\f[R]
.fi
.PP
اطلاعات مصرفی بازگردانده شده، شامل دایرکتوری مورد نظر و همچنین تمام فایل‌های
ذخیره‌شده در هر زیردایرکتوری موجود می‌باشد..SS symlink
.PP
می‌توانید با عملیات symlink، یک پیوند نمادین در ObjectStore ایجاد کنید.
.IP
.nf
\f[C]
rclone backend symlink remote: [options] [<arguments>+]
\f[R]
.fi
.PP
موقعیت مسیر مورد نظر (شامل زیردایرکتوری‌های مربوطه) که به شیء هدف پیوند نمادین ختم می‌شود (برای نمونه،
/links/mylink).
در صورت وجود، پسوند فایل شیء را نیز قید کنید.
.PP
نمونه استفاده:
.IP
.nf
\f[C]
rclone backend symlink <src> <path>
\f[R]
.fi
.SH Microsoft Azure Blob Storage
.PP
مسیرها به‌صورت \f[V]remote:container\f[R] (یا \f[V]remote:\f[R]
برای دستور \f[V]lsd\f[R]) مشخص می‌شوند.
همچنین می‌توانید زیردایرکتوری‌ها را نیز وارد کنید، مانند
\f[V]remote:container/path/to/dir\f[R].
.SS "پیکربندی (Configuration)"
.PP
در اینجا نمونه‌ای از ایجاد پیکربندی Microsoft Azure Blob Storage
آورده شده است.
برای یک ریموت به نام \f[V]remote\f[R].
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در فرایند تعاملی راه‌اندازی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Microsoft Azure Blob Storage
   \[rs] \[dq]azureblob\[dq]
[snip]
Storage> azureblob
Storage Account Name
account> account_name
Storage Account Key
key> base64encodedkey==
Endpoint for the service - leave blank normally.
endpoint> 
Remote config
Configuration complete.
Options:
- type: azureblob
- account: account_name
- key: base64encodedkey==
- endpoint:
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
مشاهده همه کانتینرها
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
ایجاد یک کانتینر جدید
.IP
.nf
\f[C]
rclone mkdir remote:container
\f[R]
.fi
.PP
فهرست کردن محتویات یک کانتینر
.IP
.nf
\f[C]
rclone ls remote:container
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با کانتینر ریموت، با حذف
هرگونه فایل اضافی در کانتینر.
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory remote:container
\f[R]
.fi.SS --fast-list
.PP
این ریموت از \f[V]--fast-list\f[R] پشتیبانی می‌کند که به شما امکان می‌دهد در ازای مصرف حافظه بیشتر، از تراکنش‌های کمتری استفاده کنید.
برای جزئیات بیشتر به مستندات rclone (<https://rclone.org/docs/#fast-list>) مراجعه کنید.
.SS زمان‌های تغییر و هش‌ها
.PP
زمان تغییر به عنوان فراداده روی شیء با کلید \f[V]mtime\f[R] ذخیره می‌شود.
این مقدار با استفاده از قالب زمانی RFC3339 با دقت نانوثانیه ذخیره می‌شود.
فراداده در زمان فهرست‌گیری پوشه‌ها ارائه می‌شود، بنابراین استفاده از آن هیچ بار کاری و افت عملکردی ندارد.
.PP
اگر مایلید از زمان استاندارد \f[V]LastModified\f[R] در Azure که روی شیء ذخیره شده به عنوان زمان تغییر استفاده کنید، پرچم \f[V]--use-server-modtime\f[R] را به کار ببرید.
توجه داشته باشید که rclone نمی‌تواند \f[V]LastModified\f[R] را تنظیم کند، بنابراین در صورت استفاده از \f[V]--use-server-modtime\f[R]، استفاده از پرچم \f[V]--update\f[R] هنگام همگام‌سازی توصیه می‌شود.
.PP
هش‌های MD5 همراه با blobها ذخیره می‌شوند.
با این حال، blobهایی که به صورت چندبخشی بارگذاری شده‌اند، تنها در صورتی هش MD5 دارند که ریموت مبدأ قادر به ارائه هش‌های MD5 بوده باشد، مانند دیسک محلی.
.SS فراداده و برچسب‌ها
.PP
هنگامی که \f[V]--metadata\f[R] فعال باشد (یا هنگام استفاده از \f[V]--metadata-set\f[R] / \f[V]--metadata-mapper\f[R])، ابزار rclone می‌تواند فراداده‌های دلخواه را به سرایندهای Azure Blob، فراداده‌های کاربر و برچسب‌ها نگاشت کند.
.IP \[bu] 2
سرایندها: این کلیدها را در فراداده تنظیم کنید تا به سرایندهای متناظر blob نگاشت شوند:
.RS 2
.IP \[bu] 2
\f[V]cache-control\f[R]، \f[V]content-disposition\f[R]،
\f[V]content-encoding\f[R]، \f[V]content-language\f[R]،
\f[V]content-type\f[R].
.RE
.IP \[bu] 2
فراداده کاربر: هر کلید غیررزروشدهٔ دیگری به عنوان فراداده کاربر نوشته می‌شود (کلیدها به حروف کوچک نرمال‌سازی می‌شوند).
کلیدهایی که با \f[V]x-ms-\f[R] آغاز می‌شوند رزرو شده هستند و به عنوان فراداده کاربر ذخیره نمی‌شوند.
.IP \[bu] 2
برچسب‌ها: مقدار \f[V]x-ms-tags\f[R] را به عنوان فهرستی از جفت‌های \f[V]key=value\f[R] جداشده با کاما مشخص کنید، مانند
\f[V]x-ms-tags=env=dev,team=sync\f[R].
این مقادیر به عنوان برچسب‌های blob در زمان بارگذاری و در رونوشت‌های سمت سرور اعمال می‌شوند.
فاصله‌های خالی پیرامون کلیدها/مقادیر نادیده گرفته می‌شوند.
.IP \[bu] 2
بازنویسی زمان تغییر: مقدار \f[V]mtime\f[R] را در قالب RFC3339/RFC3339Nano ارائه دهید تا زمان تغییر ذخیره‌شده در فراداده کاربر بازنویسی شود.
اگر \f[V]mtime\f[R] قابل تجزیه نباشد، rclone یک پیام اشکال‌زدایی ثبت کرده و از بازنویسی صرف‌نظر می‌کند.
.PP
یادداشت‌ها: \- ابزار rclone از کلیدهای رزروشدهٔ \f[V]x-ms-*\f[R] (به جز \f[V]x-ms-tags\f[R]) برای فراداده کاربر صرف‌نظر می‌کند.
.SS کارایی
.PP
هنگام بارگذاری فایل‌های حجیم، افزایش مقدار \f[V]--azureblob-upload-concurrency\f[R] باعث افزایش کارایی در ازای مصرف حافظهٔ بیشتر خواهد شد.
مقدار پیش‌فرض ۱۶ به منظور کاهش مصرف حافظه، بسیار محافظه‌کارانه تعیین شده است.
شاید لازم باشد برای بهره‌گیری کامل از یک اتصال ۱ گیگابیت بر ثانیه در انتقال یک فایل، این مقدار را به ۶۴ یا بالاتر افزایش دهید.
.SS نویسه‌های محدودشده در نام فایل
.PP
علاوه بر مجموعه نویسه‌های محدودشده پیش‌فرض (<https://rclone.org/overview/#restricted-characters>)، نویسه‌های زیر نیز جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
/
T}@T{
0x2F
T}@T{
／
T}
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
.TE
.PP
نام فایل‌ها همچنین نمی‌توانند با نویسه‌های زیر پایان یابند.
این موارد تنها در صورتی جایگزین می‌شوند که آخرین نویسه در نام فایل باشند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\&.
T}@T{
0x2E
T}@T{
．
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند شد (<https://rclone.org/overview/#invalid-utf8>)، زیرا نمی‌توان از آن‌ها در رشته‌های JSON استفاده کرد..SS "احراز هویت (Authentication)"
.PP
چندین روش برای ارائه اطلاعات اعتبارسنجی برای Azure Blob Storage وجود دارد.
rclone آن‌ها را به ترتیب بخش‌های زیر بررسی می‌کند.
.SS "احراز هویت از طریق متغیرهای محیطی (Env Auth)"
.PP
اگر پارامتر پیکربندی \f[V]env_auth\f[R] برابر با \f[V]true\f[R] باشد، rclone
اطلاعات اعتبارسنجی را از محیط یا زمان اجرا دریافت خواهد کرد.
.PP
این ابزار روش‌های احراز هویت را به ترتیب زیر امتحان می‌کند:
.IP "1." 3
متغیرهای محیطی
.IP "2." 3
اطلاعات اعتبارسنجی Managed Service Identity
.IP "3." 3
اطلاعات اعتبارسنجی Azure CLI (همان‌طور که توسط ابزار az استفاده می‌شود)
.PP
این موارد در بخش‌های بعدی شرح داده شده‌اند
.SS "احراز هویت محیطی: ۱. متغیرهای محیطی (Env Auth: 1. Environment Variables)"
.PP
اگر \f[V]env_auth\f[R] تنظیم شده باشد و متغیرهای محیطی موجود باشند،
بسته به اینکه کدام متغیرهای محیطی مقداردهی شده باشند، rclone یک
service principal را با یک کلید مخفی (secret) یا گواهی، یا یک کاربر را با
یک گذرواژه احراز هویت می‌کند.
پیکربندی را از این متغیرها و به ترتیب زیر می‌خواند:
.IP "1." 3
موجودیت خدمت (Service principal) با client secret
.RS 4
.IP \[bu] 2
\f[V]AZURE_TENANT_ID\f[R]: شناسه tenant مربوط به service principal.
همچنین شناسه \[dq]directory\[dq] آن نیز نامیده می‌شود.
.IP \[bu] 2
\f[V]AZURE_CLIENT_ID\f[R]: شناسه کلاینت (client ID) مربوط به service principal
.IP \[bu] 2
\f[V]AZURE_CLIENT_SECRET\f[R]: یکی از کلیدهای مخفی کلاینت (client secrets) مربوط به service principal
.RE
.IP "2." 3
موجودیت خدمت (Service principal) با گواهی (certificate)
.RS 4
.IP \[bu] 2
\f[V]AZURE_TENANT_ID\f[R]: شناسه tenant مربوط به service principal.
همچنین شناسه \[dq]directory\[dq] آن نیز نامیده می‌شود.
.IP \[bu] 2
\f[V]AZURE_CLIENT_ID\f[R]: شناسه کلاینت (client ID) مربوط به service principal
.IP \[bu] 2
\f[V]AZURE_CLIENT_CERTIFICATE_PATH\f[R]: مسیر فایل گواهی PEM یا PKCS12
شامل کلید خصوصی.
.IP \[bu] 2
\f[V]AZURE_CLIENT_CERTIFICATE_PASSWORD\f[R]: (اختیاری) گذرواژه مربوط به
فایل گواهی.
.IP \[bu] 2
\f[V]AZURE_CLIENT_SEND_CERTIFICATE_CHAIN\f[R]: (اختیاری) مشخص می‌کند
که آیا درخواست احراز هویت شامل سرآیند x5c برای پشتیبانی از احراز هویت مبتنی بر
subject name / issuer خواهد بود یا خیر.
هنگامی که روی \[dq]true\[dq] یا \[dq]1\[dq] تنظیم شود، درخواست‌های احراز هویت
شامل سرآیند x5c خواهند بود.
.RE
.IP "3." 3
کاربر با نام کاربری و گذرواژه
.RS 4
.IP \[bu] 2
\f[V]AZURE_TENANT_ID\f[R]: (اختیاری) شناسه tenant برای احراز هویت در آن.
پیش‌فرض: \[dq]organizations\[dq].
.IP \[bu] 2
\f[V]AZURE_CLIENT_ID\f[R]: شناسه کلاینت برنامه‌ای که کاربر با آن احراز هویت
می‌کند
.IP \[bu] 2
\f[V]AZURE_USERNAME\f[R]: نام کاربری (معمولاً یک نشانی ایمیل)
.IP \[bu] 2
\f[V]AZURE_PASSWORD\f[R]: گذرواژه کاربر
.RE
.IP "4." 3
هویت بار کاری (Workload Identity)
.RS 4
.IP \[bu] 2
\f[V]AZURE_TENANT_ID\f[R]: شناسه Tenant برای احراز هویت در آن
.IP \[bu] 2
\f[V]AZURE_CLIENT_ID\f[R]: شناسه کلاینت برنامه‌ای که کاربر با آن احراز هویت
می‌کند
.IP \[bu] 2
\f[V]AZURE_FEDERATED_TOKEN_FILE\f[R]: مسیر فایل توکن projected service account
.IP \[bu] 2
\f[V]AZURE_AUTHORITY_HOST\f[R]: مرجع (Authority) نقطه پایانی Azure Active Directory
(پیش‌فرض: login.microsoftonline.com).
.RE.SS Env Auth: ۲. اعتبارنامه‌های Managed Service Identity
.PP
هنگام استفاده از Managed Service Identity، اگر ماشین مجازی یا مقیاس‌پذیر (VM(SS)) که این برنامه روی آن اجرا می‌شود دارای یک هویت تخصیص‌یافته توسط سیستم (system-assigned identity) باشد، به‌طور پیش‌فرض از آن استفاده خواهد شد.
اگر منبع فاقد هویت تخصیص‌یافته توسط سیستم باشد اما دقیقاً یک هویت تخصیص‌یافته توسط کاربر (user-assigned identity) داشته باشد، هویت تخصیص‌یافته توسط کاربر به‌طور پیش‌فرض استفاده خواهد شد.
.PP
اگر منبع چندین هویت تخصیص‌یافته توسط کاربر داشته باشد، باید \f[V]env_auth\f[R] را لغو کرده و به جای آن \f[V]use_msi\f[R] را مقداردهی کنید.
بخش \f[V]use_msi\f[R] را ببینید.
.PP
اگر در ابرهای غیرمتصل (disconnected) یا ابرهای خصوصی مانند Azure Stack کار می‌کنید، ممکن است بخواهید
\f[V]disable_instance_discovery = true\f[R]
را تنظیم کنید.
این گزینه مشخص می‌کند که آیا rclone پیش از احراز هویت، متادیتای نمونهٔ Microsoft Entra را از
\f[V]https://login.microsoft.com\f[R]
درخواست کند یا خیر.
تنظیم این مقدار روی \f[V]true\f[R] این درخواست را نادیده می‌گیرد و مسئولیت اطمینان از معتبر و قابل اعتماد بودن مرجع (authority) پیکربندی‌شده را بر عهدهٔ شما می‌گذارد.
.SS Env Auth: ۳. اعتبارنامه‌های Azure CLI (همان‌طور که توسط ابزار az استفاده می‌شود)
.PP
اعتبارنامه‌های ایجادشده با ابزار \f[V]az\f[R] می‌توانند با استفاده از
\f[V]env_auth\f[R]
خوانده و استفاده شوند.
.PP
به‌عنوان مثال اگر بخواهید با یک service principal به این صورت وارد شوید:
.IP
.nf
\f[C]
az login --service-principal -u XXX -p XXX --tenant XXX
\f[R]
.fi
.PP
سپس می‌توانید مانند زیر به منابع rclone دسترسی داشته باشید:
.IP
.nf
\f[C]
rclone lsf :azureblob,env_auth,account=ACCOUNT:CONTAINER
\f[R]
.fi
.PP
یا
.IP
.nf
\f[C]
rclone lsf --azureblob-env-auth --azureblob-account=ACCOUNT :azureblob:CONTAINER
\f[R]
.fi
.PP
که معادل استفاده از ابزار \f[V]az\f[R] است:
.IP
.nf
\f[C]
az storage blob list --container-name CONTAINER --account-name ACCOUNT --auth-mode login
\f[R]
.fi
.SS حساب کاربری و کلید اشتراکی (Account and Shared Key)
.PP
این سرراست‌ترین روش و در عین حال دارای کمترین انعطاف‌پذیری است.
تنها کافی است گزینه‌های \f[V]account\f[R] و \f[V]key\f[R] را تکمیل کرده و باقی موارد را خالی بگذارید.
.SS نشانی اینترنتی SAS (SAS URL)
.PP
این می‌تواند یک SAS URL در سطح حساب کاربری یا در سطح کانتینر باشد.
.PP
برای استفاده از آن، \f[V]account\f[R] و \f[V]key\f[R] را خالی بگذارید و
\f[V]sas_url\f[R]
را پر کنید.
.PP
یک SAS URL در سطح حساب یا کانتینر را می‌توان از درگاه Azure یا Azure Storage Explorer به دست آورد.
برای دریافت یک SAS URL در سطح کانتینر، در مرورگر Azure Blob در درگاه Azure روی کانتینر مورد نظر راست‌کلیک کنید.
.PP
اگر از یک SAS URL در سطح کانتینر استفاده کنید، عملیات rclone تنها روی همان کانتینر خاص مجاز خواهد بود؛ برای مثال:
.IP
.nf
\f[C]
rclone ls azureblob:container
\f[R]
.fi
.PP
همچنین می‌توانید تک‌کانتینر مذکور را از مسیر ریشه فهرست کنید.
این کار تنها کانتینر مشخص‌شده توسط SAS URL را نمایش خواهد داد.
.IP
.nf
\f[C]
$ rclone lsd azureblob:
container/
\f[R]
.fi
.PP
توجه داشته باشید که نمی‌توانید هیچ کانتینر دیگری را ببینید یا به آن دسترسی پیدا کنید \- این کار با خطا مواجه خواهد شد:
.IP
.nf
\f[C]
rclone ls azureblob:othercontainer
\f[R]
.fi
.PP
آدرس‌های SAS URL در سطح کانتینر برای اعطای دسترسی موقت به اشخاص ثالث به یک کانتینر واحد، یا قرار دادن اعتبارنامه‌ها در یک محیط غیرقابل اعتماد مانند سرور ساخت CI مفید هستند..SS شناسه خدمت با کلید مخفی کلاینت (Service principal with client secret)
.PP
اگر این متغیرها تنظیم شده باشند، rclone با استفاده از یک شناسه خدمت (service principal) و یک کلید مخفی کلاینت (client secret) احراز هویت خواهد کرد.
.IP \[bu] 2
\f[V]tenant\f[R]: شناسهٔ مستأجر (tenant ID) شناسه خدمت؛ همچنین به عنوان شناسهٔ \[dq]directory\[dq] نیز نامیده می‌شود.
.IP \[bu] 2
\f[V]client_id\f[R]: شناسهٔ کلاینت (client ID) مربوط به شناسه خدمت.
.IP \[bu] 2
\f[V]client_secret\f[R]: یکی از کلیدهای مخفی کلاینتِ شناسه خدمت.
.PP
همچنین می‌توان با استفاده از گزینهٔ پیکربندی \f[V]service_principal_file\f[R]، این اعتبارنامه‌ها را درون یک فایل قرار داد.
.SS شناسه خدمت با گواهی (Service principal with certificate)
.PP
اگر این متغیرها تنظیم شده باشند، rclone با استفاده از یک شناسه خدمت به همراه گواهی (certificate) احراز هویت خواهد کرد.
.IP \[bu] 2
\f[V]tenant\f[R]: شناسهٔ مستأجر (tenant ID) شناسه خدمت؛ همچنین به عنوان شناسهٔ \[dq]directory\[dq] نیز نامیده می‌شود.
.IP \[bu] 2
\f[V]client_id\f[R]: شناسهٔ کلاینت شناسه خدمت.
.IP \[bu] 2
\f[V]client_certificate_path\f[R]: مسیر فایل گواهی PEM یا PKCS12 شامل کلید خصوصی (private key).
.IP \[bu] 2
\f[V]client_certificate_password\f[R]: (اختیاری) گذرواژهٔ فایل گواهی.
.IP \[bu] 2
\f[V]client_send_certificate_chain\f[R]: (اختیاری) مشخص می‌کند که آیا درخواست احراز هویت شامل یک سرآیند x5c برای پشتیبانی از احراز هویت مبتنی بر نام موضوع/صادرکننده (subject name / issuer) باشد یا خیر.
هنگامی که روی \[dq]true\[dq] یا \[dq]1\[dq] تنظیم شود، درخواست‌های احراز هویت شامل سرآیند x5c خواهند بود.
.PP
\f[B]نکته:\f[R] مقدار \f[V]client_certificate_password\f[R] باید مبهم‌سازی (obscure) شود \-
rclone obscure (<https://rclone.org/commands/rclone_obscure>) را ببینید.
.SS کاربر با نام کاربری و گذرواژه (User with username and password)
.PP
اگر این متغیرها تنظیم شده باشند، rclone با استفاده از نام کاربری و گذرواژه احراز هویت خواهد کرد.
.IP \[bu] 2
\f[V]tenant\f[R]: (اختیاری) مستأجر (tenant) مورد نظر برای احراز هویت.
پیش‌فرض بر روی \[dq]organizations\[dq] است.
.IP \[bu] 2
\f[V]client_id\f[R]: شناسهٔ کلاینت برنامه‌ای که کاربر برای آن احراز هویت می‌شود.
.IP \[bu] 2
\f[V]username\f[R]: نام کاربری (معمولاً یک نشانی ایمیل).
.IP \[bu] 2
\f[V]password\f[R]: گذرواژهٔ کاربر.
.PP
مایکروسافت این روش احراز هویت را پیشنهاد نمی‌کند، زیرا امنیت آن نسبت به سایر روش‌های احراز هویت کمتر است.
این روش تعاملی نیست، بنابراین با هیچ شکلی از احراز هویت چندعاملی (MFA) سازگار نیست و برنامه باید از قبل رضایت کاربر یا مدیر سیستم را داشته باشد.
این اعتبارنامه تنها می‌تواند حساب‌های کاری و تحصیلی را احراز هویت کند؛ این روش قادر به احراز هویت حساب‌های شخصی مایکروسافت نیست.
.PP
\f[B]نکته:\f[R] مقدار \f[V]password\f[R] باید مبهم‌سازی (obscure) شود \-
rclone obscure (<https://rclone.org/commands/rclone_obscure>) را ببینید.
.SS اعتبارنامه‌های هویت خدمات مدیریت‌شده (Managed Service Identity Credentials)
.PP
اگر \f[V]use_msi\f[R] تنظیم شده باشد، از اعتبارنامه‌های هویت خدمات مدیریت‌شده (MSI) استفاده می‌شود.
این احراز هویت تنها هنگام اجرا درون یکی از سرویس‌های Azure کار می‌کند.
برای استفاده از این روش، \f[V]env_auth\f[R] باید غیرفعال (unset) باشد.
.PP
با این حال، اگر چندین هویت کاربری برای انتخاب دارید، باید دقیقاً با استفاده از یکی از پارامترهای
\f[V]msi_object_id\f[R]، \f[V]msi_client_id\f[R] یا
\f[V]msi_mi_res_id\f[R] به‌طور صریح مشخص شوند.
.PP
اگر هیچ‌کدام از \f[V]msi_object_id\f[R]، \f[V]msi_client_id\f[R] یا
\f[V]msi_mi_res_id\f[R] تنظیم نشده باشند، این معادل استفاده از
\f[V]env_auth\f[R] خواهد بود.
.SS اعتبارنامه‌های هویت فدراسیونی (Federated Identity Credentials)
.PP
اگر این متغیرها تنظیم شده باشند، rclone با استفاده از هویت فدراسیونی (federated identity) احراز هویت خواهد کرد.
.IP \[bu] 2
\f[V]tenant\f[R]: شناسهٔ مستأجر (tenant ID) مربوط به فضای ذخیره‌سازی.
.IP \[bu] 2
\f[V]client_id\f[R]: شناسهٔ کلاینت برنامه‌ای که کاربر با استفاده از آن به فضای ذخیره‌سازی متصل و احراز هویت می‌شود.
.IP \[bu] 2
\f[V]msi_client_id\f[R]: شناسهٔ کلاینت هویت مدیریت‌شدهٔ برنامه‌ای که کاربر برای آن احراز هویت خواهد شد.
.PP
به‌طور پیش‌فرض، مقدار \[dq]api://AzureADTokenExchange\[dq] به عنوان دامنه (scope) برای دریافت توکن از طریق MSI استفاده می‌شود.
سپس این توکن با استفاده از \[aq]tenant\[aq] و \[aq]client_id\[aq] با توکن واقعی ذخیره‌سازی مبادله می‌گردد..SS ابزار Azure CLI با نام \f[V]az\f[R]
.PP
اگر \f[V]use_az\f[R] تنظیم شده باشد، از ابزار Azure CLI با نام
\f[V]az\f[R] (https://learn.microsoft.com/en-us/cli/azure) به عنوان تنها
روش احراز هویت استفاده می‌شود.
.PP
تنظیم این گزینه می‌تواند زمانی مفید باشد که بخواهید از CLI ابزار \f[V]az\f[R] روی
میزبانی استفاده کنید که دارای System Managed Identity است اما مایل به استفاده از آن نیستید.
.PP
گزینه \f[V]env_auth\f[R] را هم‌زمان تنظیم نکنید.
.SS دسترسی ناشناس (Anonymous)
.PP
اگر می‌خواهید به منابعی با دسترسی عمومی ناشناس دسترسی داشته باشید،
فقط \f[V]account\f[R] را تنظیم کنید.
می‌توانید این کار را بدون ساخت یک پیکربندی rclone انجام دهید:
.IP
.nf
\f[C]
rclone lsf :azureblob,account=ACCOUNT:CONTAINER
\f[R]
.fi
.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص azureblob (Microsoft Azure
Blob Storage) آمده است.
.SS --azureblob-account
.PP
نام حساب ذخیره‌سازی Azure (Azure Storage Account Name).
.PP
این گزینه را روی نام Azure Storage Account مورد استفاده تنظیم کنید.
.PP
برای استفاده از SAS URL یا Emulator این مقدار را خالی بگذارید، در غیر این صورت باید تنظیم شود.
.PP
اگر این مقدار خالی باشد و env_auth تنظیم شده باشد، در صورت امکان از
متغیر محیطی \f[V]AZURE_STORAGE_ACCOUNT_NAME\f[R] خوانده خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: account
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_ACCOUNT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azureblob-env-auth
.PP
خواندن اطلاعات احراز هویت در زمان اجرا (متغیرهای محیطی، CLI یا MSI).
.PP
برای اطلاعات کامل، مستندات احراز هویت را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: env_auth
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_ENV_AUTH
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --azureblob-key
.PP
کلید مشترک حساب ذخیره‌سازی (Storage Account Shared Key).
.PP
برای استفاده از SAS URL یا Emulator خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: key
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azureblob-sas-url
.PP
نشانی SAS URL فقط برای دسترسی در سطح کانتینر.
.PP
در صورت استفاده از account/key یا Emulator خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sas_url
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_SAS_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --azureblob-connection-string
.PP
رشته اتصال فضای ذخیره‌سازی (Storage Connection String).
.PP
رشته اتصال برای فضای ذخیره‌سازی.
در صورت استفاده از سایر روش‌های احراز هویت، این فیلد را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: connection_string
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_CONNECTION_STRING
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.SS --azureblob-tenant
.PP
شناسه مستأجر (Tenant ID) مربوط به service principal.
همچنین شناسه دایرکتوری (directory ID) آن نیز نامیده می‌شود.
.PP
در صورت استفاده از موارد زیر این مقدار را تنظیم کنید: \- Service principal با client secret \- Service
principal با certificate \- کاربر با نام کاربری و گذرواژه (username and password)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: tenant
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_TENANT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.SS --azureblob-client-id
.PP
شناسه کلاینت (client ID) مورد استفاده.
.PP
در صورت استفاده از موارد زیر این مقدار را تنظیم کنید: \- Service principal با client secret \- Service
principal با certificate \- کاربر با نام کاربری و گذرواژه (username and password)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.SS --azureblob-client-secret
.PP
یکی از کلیدهای محرمانه کلاینت (client secrets) مربوط به service principal.
.PP
در صورت استفاده از Service principal با client secret این مقدار را تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.SS --azureblob-client-certificate-path
.PP
مسیر فایل گواهی PEM یا PKCS12 شامل کلید خصوصی (private key).
.PP
در صورت استفاده از Service principal با certificate این مقدار را تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_certificate_path
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_CLIENT_CERTIFICATE_PATH
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.SS --azureblob-client-certificate-password
.PP
گذرواژه فایل گواهی (اختیاری).
.PP
در صورت استفاده از Service principal با certificate، تنظیم این مقدار اختیاری است
.PP
و در صورتی که گواهی دارای گذرواژه باشد.
.PP
\f[B]نکته\f[R] ورودی این مقدار باید مبهم‌سازی شود \- به rclone
obscure (https://rclone.org/commands/rclone_obscure) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_certificate_password
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_CLIENT_CERTIFICATE_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مربوط به azureblob (فضای ذخیره‌سازی Microsoft Azure Blob) آورده شده است.
.SS --azureblob-client-send-certificate-chain
.PP
ارسال زنجیره گواهی (certificate chain) هنگام استفاده از احراز هویت مبتنی بر گواهی.
.PP
مشخص می‌کند که آیا درخواست احراز هویت شامل سربرگ x5c برای پشتیبانی از احراز هویت مبتنی بر subject name / issuer باشد یا خیر.
هنگامی که روی true تنظیم شود، درخواست‌های احراز هویت شامل سربرگ x5c خواهند بود.
.PP
در صورت استفاده از «Service principal with certificate»، می‌توانید به صورت اختیاری این گزینه را تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_send_certificate_chain
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_CLIENT_SEND_CERTIFICATE_CHAIN
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --azureblob-username
.PP
نام کاربری (معمولاً یک نشانی ایمیل)
.PP
در صورت استفاده از «User with username and password»، این گزینه را تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: username
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_USERNAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azureblob-password
.PP
گذرواژه کاربر
.PP
در صورت استفاده از «User with username and password»، این گزینه را تنظیم کنید.
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی (obscure) شده باشد \- دستور rclone obscure (https://rclone.org/commands/rclone_obscure) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: password
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azureblob-service-principal-file
.PP
مسیر فایل حاوی اطلاعات هویتی (credentials) جهت استفاده همراه با یک service principal.
.PP
در حالت عادی خالی بگذارید.
تنها در صورتی مورد نیاز است که بخواهید به جای ورود تعاملی از یک service principal استفاده کنید.
.IP
.nf
\f[C]
$ az ad sp create-for-rbac --name \[dq]<name>\[dq] \[rs]
  --role \[dq]Storage Blob Data Owner\[dq] \[rs]
  --scopes \[dq]/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account>/blobServices/default/containers/<container>\[dq] \[rs]
  > azure-principal.json
\f[R]
.fi
.PP
برای جزئیات بیشتر به صفحات \[dq]Create an Azure service principal\[dq] (https://docs.microsoft.com/en-us/cli/azure/create-an-azure-service-principal-azure-cli) و \[dq]Assign an Azure role for access to blob data\[dq] (https://docs.microsoft.com/en-us/azure/storage/common/storage-auth-aad-rbac-cli) مراجعه کنید.
.PP
ممکن است قرار دادن مستقیم اطلاعات هویتی در فایل پیکربندی rclone زیر کلیدهای \f[V]client_id\f[R]، \f[V]tenant\f[R] و \f[V]client_secret\f[R] به‌جای تنظیم \f[V]service_principal_file\f[R] راحت‌تر باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: service_principal_file
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_SERVICE_PRINCIPAL_FILE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --azureblob-disable-instance-discovery
.PP
صرف‌نظر کردن از درخواست متاداده‌های نمونهٔ Microsoft Entra
.PP
این گزینه تنها باید توسط برنامه‌هایی که در ابرهای تفکیک‌شده (disconnected) یا ابرهای خصوصی مانند Azure Stack احراز هویت می‌کنند، روی true تنظیم شود.
.PP
این مورد مشخص می‌کند که آیا rclone پیش از احراز هویت، متاداده‌های نمونهٔ Microsoft Entra را از \f[V]https://login.microsoft.com\f[R] درخواست کند یا خیر.
.PP
تنظیم این مقدار روی true این درخواست را نادیده می‌گیرد و شما را مسئول اطمینان از معتبر و قابل اعتماد بودن مرجع (authority) پیکربندی‌شده می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_instance_discovery
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_DISABLE_INSTANCE_DISCOVERY
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --azureblob-use-msi
.PP
استفاده از هویت سرویس مدیریت‌شده (MSI) برای احراز هویت (تنها در Azure کار می‌کند).
.PP
در صورت تنظیم روی true، به جای SAS token یا کلید حساب، از یک هویت سرویس مدیریت‌شده (https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources) برای احراز هویت در Azure Storage استفاده می‌شود.
.PP
اگر ماشین مجازی یا مجموعه‌مقیاس ماشین مجازی (VM/VMSS) که این برنامه روی آن در حال اجراست دارای یک هویت تخصیص‌یافته توسط سیستم (system-assigned) باشد، به‌طور پیش‌فرض از آن استفاده خواهد شد.
اگر منبع فاقد هویت تخصیص‌یافته توسط سیستم بوده اما دقیقاً یک هویت تخصیص‌یافته توسط کاربر (user-assigned) داشته باشد، به‌طور پیش‌فرض از هویت تخصیص‌یافته توسط کاربر استفاده خواهد شد.
اگر منبع دارای چندین هویت تخصیص‌یافته توسط کاربر باشد، هویت مورد استفاده باید دقیقاً با استفاده از یکی از پارامترهای msi_object_id، msi_client_id یا msi_mi_res_id به‌طور صریح مشخص شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_msi
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_USE_MSI
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --azureblob-msi-object-id
.PP
شناسه شیء (Object ID) مربوط به MSI تخصیص‌یافته توسط کاربر جهت استفاده، در صورت وجود.
.PP
در صورت مشخص شدن msi_client_id یا msi_mi_res_id خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: msi_object_id
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_MSI_OBJECT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azureblob-msi-client-id
.PP
شناسه شیء (Object ID) مربوط به MSI تخصیص‌یافته توسط کاربر جهت استفاده، در صورت وجود.
.PP
در صورت مشخص شدن msi_object_id یا msi_mi_res_id خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: msi_client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_MSI_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azureblob-msi-mi-res-id
.PP
شناسه منبع (resource ID) در Azure مربوط به MSI تخصیص‌یافته توسط کاربر جهت استفاده، در صورت وجود.
.PP
در صورت مشخص شدن msi_client_id یا msi_object_id خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: msi_mi_res_id
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_MSI_MI_RES_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --azureblob-use-emulator
.PP
در صورت مقداردهی با \[aq]true\[aq]، از شبیه‌ساز محلی فضای ذخیره‌سازی استفاده می‌کند.
.PP
در صورت استفاده از نقطه پایانی (endpoint) واقعی فضای ذخیره‌سازی azure، این مقدار را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_emulator
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_USE_EMULATOR
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --azureblob-use-az
.PP
استفاده از ابزار Azure CLI به نام az برای احراز هویت
.PP
تنظیم برای استفاده از ابزار Azure CLI به نام
az (https://learn.microsoft.com/en-us/cli/azure) به عنوان تنها روش احراز هویت.
.PP
تنظیم این گزینه زمانی می‌تواند مفید باشد که بخواهید از az CLI بر روی میزبانی با یک هویت مدیریت‌شده سیستمی (System Managed Identity) استفاده کنید که تمایلی به استفاده از آن ندارید.
.PP
هم‌زمان با این گزینه، env_auth را تنظیم نکنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_az
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_USE_AZ
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --azureblob-endpoint
.PP
نقطه پایانی (Endpoint) برای سرویس.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_ENDPOINT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azureblob-upload-cutoff
.PP
حد آستانه برای جابه‌جایی به بارگذاری تکه‌ای (<= 256 MiB) (منسوخ شده).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azureblob-chunk-size
.PP
اندازه تکه‌های بارگذاری (Upload chunk size).
.PP
توجه داشته باشید که این مقدار در حافظه نگهداری می‌شود و ممکن است حداکثر تا
\[dq]--transfers\[dq] * \[dq]--azureblob-upload-concurrency\[dq] تکه به‌صورت هم‌زمان در حافظه ذخیره شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 4Mi.SS --azureblob-upload-concurrency
.PP
هم‌زمانی برای بارگذاری‌های چندبخشی (multipart uploads).
.PP
این مقدار، تعداد تکه‌هایی از یک فایل یکسان است که به‌طور هم‌زمان
بارگذاری می‌شوند.
.PP
اگر تعداد کمی از فایل‌های حجیم را روی پیوندهای پرسرعت بارگذاری می‌کنید
و این بارگذاری‌ها به‌طور کامل از پهنای باند شما استفاده نمی‌کنند، افزایش
این مقدار می‌تواند به بالابردن سرعت انتقال‌ها کمک کند.
.PP
در آزمایش‌ها، سرعت بارگذاری تقریباً به‌صورت خطی با هم‌زمانی بارگذاری
افزایش می‌یابد.
برای نمونه، جهت پر کردن ظرفیت یک پیوند گیگابیتی ممکن است نیاز باشد این مقدار
به 64 افزایش یابد.
توجه داشته باشید که این کار حافظهٔ بیشتری مصرف خواهد کرد.
.PP
توجه داشته باشید که تکه‌ها در حافظه ذخیره می‌شوند و ممکن است حداکثر تا
\[dq]--transfers\[dq] * \[dq]--azureblob-upload-concurrency\[dq] تکه
به‌طور هم‌زمان در حافظه نگهداری شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_UPLOAD_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 16
.SS --azureblob-copy-cutoff
.PP
آستانهٔ جابه‌جایی به رونوشت چندبخشی (multipart copy).
.PP
هر فایلی بزرگ‌تر از این مقدار که نیاز به رونوشت سمت سرور داشته باشد،
با استفاده از put block list API در تکه‌هایی به اندازهٔ chunk_size رونوشت
خواهد شد.
.PP
فایل‌های کوچک‌تر از این حد با استفاده از Copy Blob API رونوشت می‌شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: copy_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_COPY_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 8Mi
.SS --azureblob-copy-concurrency
.PP
هم‌زمانی برای رونوشت چندبخشی.
.PP
این مقدار، تعداد تکه‌هایی از یک فایل یکسان است که به‌طور هم‌زمان
رونوشت می‌شوند.
.PP
این تکه‌ها در حافظه بافر نمی‌شوند و مایکروسافت در مستندات azcopy توصیه
می‌کند که این مقدار بزرگ‌تر از 1000 تنظیم شود.
.PP
https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-optimize#increase-concurrency
.PP
در آزمایش‌ها، سرعت رونوشت تقریباً به‌صورت خطی با هم‌زمانی رونوشت افزایش می‌یابد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: copy_concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_COPY_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 512
.SS --azureblob-copy-total-concurrency
.PP
محدودیت سراسری هم‌زمانی برای تکه‌های رونوشت چندبخشی.
.PP
این گزینه تعداد کل تکه‌های رونوشت چندبخشی را که به‌طور هم‌زمان
در بین تمام فایل‌ها در حال اجرا هستند، محدود می‌کند.
.PP
برای غیرفعال کردن این محدودکننده، مقدار آن را روی 0 تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: copy_total_concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_COPY_TOTAL_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 0.SS --azureblob-use-copy-blob
.PP
تعیین می‌کند که آیا هنگام رونوشت به همان حساب ذخیره‌سازی (storage account)، از Copy Blob API استفاده شود یا خیر.
.PP
اگر روی true (پیش‌فرض) تنظیم شده باشد، rclone حتی زمانی که اندازه بزرگ‌تر از copy_cutoff باشد، برای رونوشت‌ها به همان حساب ذخیره‌سازی از Copy Blob API استفاده خواهد کرد.
.PP
برنامه rclone فرض می‌کند که حساب ذخیره‌سازی یکسان به‌معنای پیکربندی یکسان است و وجود حساب ذخیره‌سازی یکسان را در پیکربندی‌های مختلف بررسی نمی‌کند.
.PP
نیازی به تغییر دادن این مقدار نیست.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_copy_blob
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_USE_COPY_BLOB
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --azureblob-list-chunk
.PP
اندازه فهرست blob.
.PP
این گزینه تعداد blobهای درخواستی در هر قطعه (chunk) از فهرست‌گیری را تعیین می‌کند.
پیش‌فرض، حداکثر مقدار یعنی 5000 است.
درخواست‌های \[dq]List blobs\[dq] برای تکمیل شدن، مجاز به صرف ۲ دقیقه به‌ازای هر مگابایت هستند.
اگر یک عملیات به‌طور میانگین بیش از ۲ دقیقه به‌ازای هر مگابایت طول بکشد، با اتمام مهلت زمانی (time out) مواجه خواهد شد (
منبع (https://docs.microsoft.com/en-us/rest/api/storageservices/setting-timeouts-for-blob-service-operations#exceptions-to-default-timeout-interval)
).
از این گزینه می‌توان برای محدود کردن تعداد موارد blob بازگردانده‌شده، جهت جلوگیری از اتمام مهلت زمانی استفاده کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_chunk
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_LIST_CHUNK
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 5000
.SS --azureblob-access-tier
.PP
سطح دسترسی (Access tier) برای blob: hot، cool، cold یا archive.
.PP
blobهای بایگانی‌شده را می‌توان با تنظیم سطح دسترسی روی hot، cool یا cold بازیابی کرد.
اگر قصد دارید از سطح دسترسی پیش‌فرض که در سطح حساب (account level) تنظیم شده استفاده کنید، این فیلد را خالی بگذارید.
.PP
اگر هیچ \[dq]access tier\[dq] مشخص نشده باشد، rclone هیچ سطحی را اعمال نمی‌کند.
برنامه rclone عملیات \[dq]Set Tier\[dq] را هنگام بارگذاری روی blobها اعمال می‌کند؛ اگر اشیاء تغییر نیافته باشند، مشخص کردن \[dq]access tier\[dq] به مقدار جدید هیچ تأثیری نخواهد داشت.
اگر blobها در ریموت در \[dq]archive tier\[dq] باشند، تلاش برای انجام عملیات انتقال داده از ریموت مجاز نخواهد بود.
کاربر ابتدا باید با تغییر سطح دسترسی blob به \[dq]Hot\[dq]، \[dq]Cool\[dq] یا \[dq]Cold\[dq] آن را بازیابی کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: access_tier
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_ACCESS_TIER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azureblob-archive-tier-delete
.PP
حذف blobهای سطح بایگانی (archive tier) پیش از بازنویسی.
.PP
blobهای سطح بایگانی را نمی‌توان به‌روزرسانی کرد.
بنابراین بدون این پرچم، اگر برای به‌روزرسانی یک blob در سطح بایگانی تلاش کنید، rclone این خطا را ایجاد خواهد کرد:
.IP
.nf
\f[C]
can\[aq]t update archive tier blob without --azureblob-archive-tier-delete
\f[R]
.fi
.PP
با تنظیم این پرچم، rclone پیش از تلاش برای بازنویسی یک blob در سطح بایگانی، blob موجود را قبل از بارگذاری نسخه جایگزین آن حذف خواهد کرد.
این کار در صورت شکست در بارگذاری (برخلاف به‌روزرسانی یک blob عادی) ممکن است موجب از دست رفتن داده‌ها شود و همچنین ممکن است هزینه بیشتری به دنبال داشته باشد، زیرا حذف زودهنگام blobهای سطح بایگانی ممکن است مشمول هزینه اضافی شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: archive_tier_delete
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_ARCHIVE_TIER_DELETE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --azureblob-disable-checksum
.PP
چکسام MD5 را در فراداده شیء ذخیره نمی‌کند.
.PP
در حالت عادی rclone پیش از بارگذاری ورودی، چکسام MD5 آن را محاسبه می‌کند
تا بتواند آن را به فراداده شیء اضافه کند.
این کار برای بررسی یکپارچگی داده‌ها عالی است اما می‌تواند در شروع بارگذاری
فایل‌های بزرگ تاخیرهای طولانی ایجاد کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_checksum
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_DISABLE_CHECKSUM
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --azureblob-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر بخش encoding را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,BackSlash,Del,Ctl,RightPeriod,InvalidUtf8
.SS --azureblob-public-access
.PP
سطح دسترسی عمومی یک container: به صورت blob یا container.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: public_access
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_PUBLIC_ACCESS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
کانتینر و blobهای آن تنها با یک درخواست مجاز (authorized) قابل دسترسی
هستند.
.IP \[bu] 2
این مقدار پیش‌فرض است.
.RE
.IP \[bu] 2
\[dq]blob\[dq]
.RS 2
.IP \[bu] 2
داده‌های blob درون این container از طریق درخواست ناشناس (anonymous) قابل خواندن هستند.
.RE
.IP \[bu] 2
\[dq]container\[dq]
.RS 2
.IP \[bu] 2
امکان دسترسی کامل خواندن عمومی برای داده‌های container و blob.
.RE
.RE
.SS --azureblob-directory-markers
.PP
بارگذاری یک شیء خالی به همراه یک اسلش در انتها هنگام ایجاد یک دایرکتوری جدید
.PP
پوشه‌های خالی در ریموت‌های مبتنی بر باکت پشتیبانی نمی‌شوند؛ این گزینه یک شیء
خالی که به \[dq]/\[dq] ختم می‌شود ایجاد می‌کند تا پوشه ماندگار بماند.
.PP
این شیء همچنین دارای فراداده \[dq]hdi_isfolder = true\[dq] است تا با
استاندارد مایکروسافت مطابقت داشته باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: directory_markers
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_DIRECTORY_MARKERS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --azureblob-no-check-container
.PP
در صورت تنظیم، تلاشی برای بررسی وجود کانتینر یا ایجاد آن صورت نمی‌گیرد.
.PP
اگر از قبل می‌دانید که کانتینر وجود دارد، این گزینه می‌تواند برای به حداقل رساندن تعداد تراکنش‌های انجام‌شده توسط rclone مفید باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_check_container
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_NO_CHECK_CONTAINER
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --azureblob-no-head-object
.PP
در صورت تنظیم، هنگام دریافت اشیاء، پیش از GET درخواست HEAD ارسال نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_head_object
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_NO_HEAD_OBJECT
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --azureblob-delete-snapshots
.PP
جهت تعیین نحوه برخورد با اسنپ‌شات‌ها هنگام حذف blob تنظیم می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: delete_snapshots
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_DELETE_SNAPSHOTS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
انتخاب‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
به‌طور پیش‌فرض، اگر یک blob دارای اسنپ‌شات باشد، عملیات حذف با شکست مواجه می‌شود
.RE
.IP \[bu] 2
\[dq]include\[dq]
.RS 2
.IP \[bu] 2
تعیین \[aq]include\[aq] برای حذف blob ریشه و تمامی اسنپ‌شات‌های آن
.RE
.IP \[bu] 2
\[dq]only\[dq]
.RS 2
.IP \[bu] 2
تعیین \[aq]only\[aq] فقط برای حذف اسنپ‌شات‌ها و نگه‌داشتن blob ریشه.
.RE
.RE
.SS --azureblob-decompress
.PP
در صورت تنظیم، اشیاء کدگذاری‌شده با gzip از حالت فشرده خارج می‌شوند.
.PP
امکان آپلود اشیاء در Azure Blob Storage با تنظیم \[dq]Content-Encoding: gzip\[dq] وجود دارد.
به‌طور معمول rclone این فایل‌ها را به عنوان اشیاء فشرده دانلود می‌کند.
.PP
اگر این پرچم تنظیم شود، rclone به محض دریافت این فایل‌های دارای \[dq]Content-Encoding: gzip\[dq]، آن‌ها را از حالت فشرده خارج می‌کند.
این بدان معناست که rclone نمی‌تواند اندازه و هش را بررسی کند، اما محتوای فایل از حالت فشرده خارج خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: decompress
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_DECOMPRESS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --azureblob-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREBLOB_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS متادیتا (Metadata)
.PP
متادیتای کاربر به‌صورت کلیدهای x-ms-meta- ذخیره می‌شود.
کلیدهای متادیتای Azure به حروف بزرگ و کوچک حساس نیستند و همیشه با
حروف کوچک برگردانده می‌شوند.
.PP
در ادامه موارد متادیتای سیستمی ممکن برای backend مربوط به azureblob آمده است.
.PP
.TS
tab(@);
lw(11.1n) lw(11.1n) lw(11.1n) lw(16.6n) lw(20.3n).
T{
نام
T}@T{
راهنما
T}@T{
نوع
T}@T{
مثال
T}@T{
فقط‌خواندنی
T}
_
T{
cache-control
T}@T{
سربرگ Cache-Control
T}@T{
string
T}@T{
no-cache
T}@T{
N
T}
T{
content-disposition
T}@T{
سربرگ Content-Disposition
T}@T{
string
T}@T{
inline
T}@T{
N
T}
T{
content-encoding
T}@T{
سربرگ Content-Encoding
T}@T{
string
T}@T{
gzip
T}@T{
N
T}
T{
content-language
T}@T{
سربرگ Content-Language
T}@T{
string
T}@T{
en-US
T}@T{
N
T}
T{
content-type
T}@T{
سربرگ Content-Type
T}@T{
string
T}@T{
text/plain
T}@T{
N
T}
T{
mtime
T}@T{
زمان آخرین تغییر، خوانده‌شده از متادیتای rclone
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}@T{
N
T}
T{
tier
T}@T{
سطح (Tier) شیء
T}@T{
string
T}@T{
Hot
T}@T{
\f[B]Y\f[R]
T}
.TE
.PP
برای اطلاعات بیشتر، مستندات متادیتا (https://rclone.org/docs/#metadata) را ببینید..SS هدرهای بارگذاری سفارشی (Custom upload headers)
.PP
می‌توانید هدرهای بارگذاری سفارشی را با گزینهٔ \f[V]--header-upload\f[R]
تنظیم کنید.
.IP \[bu] 2
Cache-Control
.IP \[bu] 2
Content-Disposition
.IP \[bu] 2
Content-Encoding
.IP \[bu] 2
Content-Language
.IP \[bu] 2
Content-Type
.IP \[bu] 2
X-MS-Tags
.PP
برای مثال: \f[V]--header-upload \[dq]Content-Type: text/potato\[dq]\f[R] یا
\f[V]--header-upload \[dq]X-MS-Tags: foo=bar\[dq]\f[R].
.SS محدودیت‌ها (Limitations)
.PP
چک‌سوم‌های MD5 تنها در صورتی با فایل‌های تکه‌تکه‌شده (chunked) بارگذاری می‌شوند
که منبع دارای چک‌سوم MD5 باشد.
این موضوع همیشه برای عملیات کپی از سیستم محلی به Azure صدق می‌کند.
.PP
دستور \f[V]rclone about\f[R] توسط بک‌اند ذخیره‌سازی Microsoft Azure Blob
پشتیبانی نمی‌شود.
بک‌اندهایی که فاقد این قابلیت هستند نمی‌توانند فضای خالی را برای یک mount
در rclone محاسبه کنند یا از سیاست \f[V]mfs\f[R] (بیشترین فضای خالی) به عنوان
عضوی از یک ریموت union در rclone استفاده نمایند.
.PP
فهرست بک‌اندهایی که از rclone about پشتیبانی نمی‌کنند را در
(https://rclone.org/overview/#optional-features) و rclone about را در
(https://rclone.org/commands/rclone_about) ببینید.
.SS پشتیبانی از شبیه‌ساز ذخیره‌سازی آژور (Azure Storage Emulator Support)
.PP
می‌توانید rclone را با شبیه‌ساز فضای ذخیره‌سازی (معمولاً
\f[I]azurite\f[R]) اجرا کنید.
.PP
برای این کار، کافی است طبق دستورالعمل‌های بخش مقدمه، یک ریموت جدید را با
\f[V]rclone config\f[R] راه‌اندازی کرده و در تنظیمات پیشرفته، گزینهٔ
\f[V]use_emulator\f[R] را روی \f[V]true\f[R] تنظیم کنید.
نیازی به ارائه نام حساب پیش‌فرض یا کلید حساب ندارید،
اما می‌توانید آن‌ها را در گزینه‌های \f[V]account\f[R] و \f[V]key\f[R]
بازنویسی کنید.
(پیش از نسخهٔ 1.61 این مقادیر به‌طور ثابت روی \f[V]devstoreaccount1\f[R]
مربوط به \f[I]azurite\f[R] تنظیم شده بودند.)
.PP
همچنین اگر می‌خواهید به نمونه‌ای از شبیه‌ساز ذخیره‌سازی که روی ماشین دیگری
در حال اجراست دسترسی پیدا کنید، می‌توانید پارامتر \f[V]endpoint\f[R] را در
تنظیمات پیشرفته تغییر داده و آن را روی
\f[V]http(s)://<host>:<port>/devstoreaccount1\f[R] تنظیم کنید (برای مثال:
\f[V]http://10.254.2.5:10000/devstoreaccount1\f[R]).
.SH "ذخیره‌سازی پرونده‌های مایکروسافت آژور (Microsoft Azure Files Storage)"
.PP
مسیرها به صورت \f[V]remote:\f[R] مشخص می‌شوند. همچنین می‌توانید دایرکتوری‌های فرعی
را نیز وارد کنید؛ برای مثال:
\f[V]remote:path/to/dir\f[R].
.SS پیکربندی (Configuration)
.PP
در اینجا مثالی از ایجاد پیکربندی Microsoft Azure Files Storage
برای ریموتی با نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Microsoft Azure Files Storage
   \[rs] \[dq]azurefiles\[dq]
[snip]

Option account.
Azure Storage Account Name.
Set this to the Azure Storage Account Name in use.
Leave blank to use SAS URL or connection string, otherwise it needs to be set.
If this is blank and if env_auth is set it will be read from the
environment variable \[ga]AZURE_STORAGE_ACCOUNT_NAME\[ga] if possible.
Enter a value. Press Enter to leave empty.
account> account_name

Option share_name.
Azure Files Share Name.
This is required and is the name of the share to access.
Enter a value. Press Enter to leave empty.
share_name> share_name

Option env_auth.
Read credentials from runtime (environment variables, CLI or MSI).
See the [authentication docs](/azurefiles#authentication) for full info.
Enter a boolean value (true or false). Press Enter for the default (false).
env_auth> 

Option key.
Storage Account Shared Key.
Leave blank to use SAS URL or connection string.
Enter a value. Press Enter to leave empty.
key> base64encodedkey==

Option sas_url.
SAS URL.
Leave blank if using account/key or connection string.
Enter a value. Press Enter to leave empty.
sas_url> 

Option connection_string.
Azure Files Connection String.
Enter a value. Press Enter to leave empty.
connection_string> 
[snip]

Configuration complete.
Options:
- type: azurefiles
- account: account_name
- share_name: share_name
- key: base64encodedkey==
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> 
\f[R]
.fi
.PP
پس از پایان پیکربندی می‌توانید از rclone استفاده کنید.
.PP
مشاهدهٔ همهٔ فایل‌ها در سطح اصلی:
.IP
.nf
\f[C]
rclone lsf remote:
\f[R]
.fi
.PP
ایجاد یک دایرکتوری جدید در ریشه:
.IP
.nf
\f[C]
rclone mkdir remote:dir
\f[R]
.fi
.PP
فهرست کردن محتویات به صورت بازگشتی:
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با دایرکتوری ریموت و حذف هرگونه فایل
اضافی موجود در دایرکتوری مقصد:
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory remote:dir
\f[R]
.fi.SS زمان تغییر (Modified time)
.PP
زمان تغییر به عنوان ویژگی SMB \f[V]LastWriteTime\f[R] روی فایل‌ها ذخیره
می‌شود.
دقت آن ۱۰۰ نانوثانیه است.
.SS کارایی (Performance)
.PP
هنگام بارگذاری فایل‌های بزرگ، افزایش مقدار
\f[V]--azurefiles-upload-concurrency\f[R] کارایی را به بهای مصرف حافظهٔ
بیشتر افزایش می‌دهد.
مقدار پیش‌فرض ۱۶ کاملاً محافظه‌کارانه جهت مصرف کمتر حافظه تنظیم شده است.
برای بهره‌برداری کامل از پیوند 1 GBit/s با انتقال یک فایل تکی، ممکن است
نیاز باشد مقدار آن به ۶۴ یا بالاتر افزایش یابد.
.SS نویسه‌های غیرمجاز نام فایل (Restricted filename characters)
.PP
علاوه بر مجموعه نویسه‌های غیرمجاز پیش‌فرض
(https://rclone.org/overview/#restricted-characters)، نویسه‌های زیر نیز
جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\[dq]
T}@T{
0x22
T}@T{
＂
T}
T{
*
T}@T{
0x2A
T}@T{
＊
T}
T{
:
T}@T{
0x3A
T}@T{
：
T}
T{
<
T}@T{
0x3C
T}@T{
＜
T}
T{
>
T}@T{
0x3E
T}@T{
＞
T}
T{
?
T}@T{
0x3F
T}@T{
？
T}
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
T{
|
T}@T{
0x7C
T}@T{
｜
T}
.TE
.PP
همچنین نام فایل‌ها نمی‌تواند با نویسه‌های زیر خاتمه یابد.
این نویسه‌ها تنها در صورتی جایگزین می‌شوند که آخرین نویسه در نام فایل باشند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\&.
T}@T{
0x2E
T}@T{
．
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند
شد (https://rclone.org/overview/#invalid-utf8)، چرا که امکان استفاده از
آن‌ها در رشته‌های JSON وجود ندارد..SS هش‌ها (Hashes)
.PP
هش‌های MD5 همراه با فایل‌ها ذخیره می‌شوند.
همه فایل‌ها دارای هش MD5 نخواهند بود، چرا که این مقادیر باید همراه با فایل بارگذاری شوند.
.SS احراز هویت (Authentication)
.PP
راه‌های متعددی برای ارائه اطلاعات احراز هویت در Azure Files Storage وجود دارد.
ابزار rclone آن‌ها را به ترتیب بخش‌های زیر بررسی و امتحان می‌کند.
.SS احراز هویت محیطی (Env Auth)
.PP
اگر پارامتر پیکربندی \f[V]env_auth\f[R] برابر با \f[V]true\f[R] باشد، rclone اطلاعات احراز هویت را از متغیرهای محیطی یا زمان اجرا دریافت خواهد کرد.
.PP
این روش‌های احراز هویت را به این ترتیب امتحان می‌کند:
.IP "1." 3
متغیرهای محیطی (Environment Variables)
.IP "2." 3
اطلاعات احراز هویت Managed Service Identity
.IP "3." 3
اطلاعات احراز هویت Azure CLI (همان‌گونه که توسط ابزار az استفاده می‌شود)
.PP
این موارد در بخش‌های زیر شرح داده شده‌اند
.SS احراز هویت محیطی: ۱. متغیرهای محیطی (Env Auth: 1. Environment Variables)
.PP
اگر \f[V]env_auth\f[R] تنظیم شده باشد و متغیرهای محیطی موجود باشند، rclone بسته به اینکه کدام متغیرهای محیطی مقداردهی شده‌اند، یک service principal را با یک کلید مخفی (secret) یا گواهی (certificate)، یا یک کاربر را با گذرواژه احراز هویت می‌کند.
پیکربندی را از این متغیرها و با اولویت زیر می‌خواند:
.IP "1." 3
حساب Service principal به همراه client secret
.RS 4
.IP \[bu] 2
\f[V]AZURE_TENANT_ID\f[R]: شناسه مربوط به tenant متعلق به service principal؛ همچنین شناسه \[dq]directory\[dq] نیز نامیده می‌شود.
.IP \[bu] 2
\f[V]AZURE_CLIENT_ID\f[R]: شناسه کلاینت (client ID) متعلق به service principal
.IP \[bu] 2
\f[V]AZURE_CLIENT_SECRET\f[R]: یکی از کلیدهای مخفی کلاینت (client secrets) متعلق به service principal
.RE
.IP "2." 3
حساب Service principal به همراه گواهی (certificate)
.RS 4
.IP \[bu] 2
\f[V]AZURE_TENANT_ID\f[R]: شناسه مربوط به tenant متعلق به service principal؛ همچنین شناسه \[dq]directory\[dq] نیز نامیده می‌شود.
.IP \[bu] 2
\f[V]AZURE_CLIENT_ID\f[R]: شناسه کلاینت (client ID) متعلق به service principal
.IP \[bu] 2
\f[V]AZURE_CLIENT_CERTIFICATE_PATH\f[R]: مسیر فایل گواهی PEM یا PKCS12 شامل کلید خصوصی.
.IP \[bu] 2
\f[V]AZURE_CLIENT_CERTIFICATE_PASSWORD\f[R]: (اختیاری) گذرواژه فایل گواهی.
.IP \[bu] 2
\f[V]AZURE_CLIENT_SEND_CERTIFICATE_CHAIN\f[R]: (اختیاری) مشخص می‌کند که آیا درخواست احراز هویت شامل هدر x5c برای پشتیبانی از احراز هویت مبتنی بر subject name / issuer خواهد بود یا خیر.
هنگامی که روی \[dq]true\[dq] یا \[dq]1\[dq] تنظیم شود، درخواست‌های احراز هویت شامل هدر x5c می‌شوند.
.RE
.IP "3." 3
کاربر با نام کاربری و گذرواژه
.RS 4
.IP \[bu] 2
\f[V]AZURE_TENANT_ID\f[R]: (اختیاری) شناسه tenant برای احراز هویت در آن.
پیش‌فرض برابر با \[dq]organizations\[dq] است.
.IP \[bu] 2
\f[V]AZURE_CLIENT_ID\f[R]: شناسه کلاینت (client ID) برنامه‌ای که کاربر برای آن احراز هویت می‌کند
.IP \[bu] 2
\f[V]AZURE_USERNAME\f[R]: نام کاربری (معمولاً یک نشانی رایانامه)
.IP \[bu] 2
\f[V]AZURE_PASSWORD\f[R]: گذرواژه کاربر
.RE
.IP "4." 3
هویت بار کاری (Workload Identity)
.RS 4
.IP \[bu] 2
\f[V]AZURE_TENANT_ID\f[R]: شناسه Tenant برای احراز هویت در آن
.IP \[bu] 2
\f[V]AZURE_CLIENT_ID\f[R]: شناسه کلاینت برنامه‌ای که کاربر برای آن احراز هویت می‌کند
.IP \[bu] 2
\f[V]AZURE_FEDERATED_TOKEN_FILE\f[R]: مسیر فایل توکن پیش‌بینی‌شده حساب سرویس (projected service account token file)
.IP \[bu] 2
\f[V]AZURE_AUTHORITY_HOST\f[R]: مرجع اعتبارسنجی (Authority) نقطه پایانی Azure Active Directory (پیش‌فرض: login.microsoftonline.com).
.RE.SS "احراز هویت محیطی (Env Auth): ۲. اعتبارنامه‌های Managed Service Identity"
.PP
هنگام استفاده از Managed Service Identity، اگر VM(SS) که این برنامه
روی آن در حال اجرا است دارای یک هویت انتساب‌یافته به سیستم (system-assigned identity) باشد، به‌طور پیش‌فرض از آن استفاده خواهد شد.
اگر منبع فاقد هویت انتساب‌یافته به سیستم باشد اما دقیقاً یک هویت
انتساب‌یافته به کاربر (user-assigned identity) داشته باشد، به‌طور پیش‌فرض از هویت انتساب‌یافته به کاربر استفاده خواهد شد.
.PP
اگر منبع دارای چندین هویت انتساب‌یافته به کاربر است، باید مقدار
\f[V]env_auth\f[R] را لغو کرده و به جای آن \f[V]use_msi\f[R] را تنظیم نمایید.
بخش \f[V]use_msi\f[R] را ببینید.
.PP
اگر در ابرهای مجزا و بدون ارتباط خارجی (disconnected clouds) یا ابرهای خصوصی نظیر
Azure Stack فعالیت می‌کنید، ممکن است بخواهید
\f[V]disable_instance_discovery = true\f[R] را تنظیم کنید.
این گزینه تعیین می‌کند که آیا rclone قبل از احراز هویت، فرادادهٔ نمونهٔ
Microsoft Entra را از \f[V]https://login.microsoft.com\f[R] درخواست
کند یا خیر.
تنظیم این گزینه روی \f[V]true\f[R] باعث نادیده گرفتن این درخواست می‌شود و مسئولیت
اطمینان از معتبر و قابل اعتماد بودن مرجع (authority) پیکربندی‌شده
بر عهدهٔ شما خواهد بود.
.SS "احراز هویت محیطی (Env Auth): ۳. اعتبارنامه‌های Azure CLI (مورد استفاده در ابزار az)"
.PP
اعتبارنامه‌های ایجادشده با ابزار \f[V]az\f[R] را می‌توان با استفاده از
\f[V]env_auth\f[R] واکشی کرد.
.PP
برای نمونه اگر با یک service principal به این صورت وارد شوید:
.IP
.nf
\f[C]
az login --service-principal -u XXX -p XXX --tenant XXX
\f[R]
.fi
.PP
آنگاه می‌توانید به منابع rclone به این شکل دسترسی پیدا کنید:
.IP
.nf
\f[C]
rclone lsf :azurefiles,env_auth,account=ACCOUNT:
\f[R]
.fi
.PP
یا
.IP
.nf
\f[C]
rclone lsf --azurefiles-env-auth --azurefiles-account=ACCOUNT :azurefiles:
\f[R]
.fi
.SS "حساب و کلید مشترک (Account and Shared Key)"
.PP
این روش ساده‌ترین و در عین حال با انعطاف‌پذیریِ کمینه است.
تنها کافی است گزینه‌های \f[V]account\f[R] و \f[V]key\f[R] را پر کنید و
بقیه را خالی بگذارید.
.SS "آدرس اینترنتی SAS (SAS URL)"
.PP
برای استفاده از آن، فیلدهای \f[V]account\f[R]، \f[V]key\f[R] و
\f[V]connection_string\f[R] را خالی بگذارید و \f[V]sas_url\f[R] را مقداردهی نمایید.
.SS "رشته اتصال (Connection String)"
.PP
برای استفاده از آن، مقادیر \f[V]account\f[R]، \f[V]key\f[R] و \[dq]sas_url\[dq] را
خالی بگذارید و \f[V]connection_string\f[R] را پر کنید.
.SS "شناسه اصلی سرویس با رمز کلاینت (Service principal with client secret)"
.PP
اگر این متغیرها تنظیم شده باشند، rclone با استفاده از یک service
principal به همراه یک client secret احراز هویت خواهد کرد.
.IP \[bu] 2
\f[V]tenant\f[R]: شناسهٔ (ID) مستأجرِ (tenant) متعلق به service principal.
همچنین شناسهٔ \[dq]directory\[dq] آن نیز خوانده می‌شود.
.IP \[bu] 2
\f[V]client_id\f[R]: شناسهٔ کلاینت (client ID) برای service principal
.IP \[bu] 2
\f[V]client_secret\f[R]: یکی از رمزهای کلاینت (client secrets) برای
service principal
.PP
همچنین این اعتبارنامه‌ها را می‌توان با استفاده از گزینهٔ پیکربندی
\f[V]service_principal_file\f[R] در یک فایل قرار داد.
.SS "شناسه اصلی سرویس با گواهی (Service principal with certificate)"
.PP
اگر این متغیرها تنظیم شده باشند، rclone با استفاده از یک service
principal به همراه گواهی احراز هویت خواهد کرد.
.IP \[bu] 2
\f[V]tenant\f[R]: شناسهٔ (ID) مستأجرِ (tenant) متعلق به service principal.
همچنین شناسهٔ \[dq]directory\[dq] آن نیز خوانده می‌شود.
.IP \[bu] 2
\f[V]client_id\f[R]: شناسهٔ کلاینت (client ID) برای service principal
.IP \[bu] 2
\f[V]client_certificate_path\f[R]: مسیر یک فایل گواهی PEM یا PKCS12
شامل کلید خصوصی (private key).
.IP \[bu] 2
\f[V]client_certificate_password\f[R]: (اختیاری) گذرواژهٔ فایل
گواهی.
.IP \[bu] 2
\f[V]client_send_certificate_chain\f[R]: (اختیاری) مشخص می‌کند که آیا یک
درخواست احراز هویت شامل هدر x5c برای پشتیبانی از احراز هویت مبتنی بر
نام موضوع / صادرکننده (subject name / issuer) باشد یا خیر.
هنگامی که روی \[dq]true\[dq] یا \[dq]1\[dq] تنظیم شود، درخواست‌های احراز هویت
شامل هدر x5c خواهند بود.
.PP
\f[B]توجه:\f[R] مقدار \f[V]client_certificate_password\f[R] باید مبهم‌سازی (obscured) شود \-
به دستور rclone obscure (<https://rclone.org/commands/rclone_obscure>) مراجعه کنید..SS کاربر با نام کاربری و گذرواژه (User with username and password)
.PP
در صورت تنظیم این متغیرها، rclone با استفاده از نام کاربری و گذرواژه احراز هویت خواهد کرد.
.IP \[bu] 2
\f[V]tenant\f[R]: (اختیاری) مستأجر (tenant) برای احراز هویت در آن. پیش‌فرض: \[dq]organizations\[dq].
.IP \[bu] 2
\f[V]client_id\f[R]: شناسه کلاینت (client ID) برنامه‌ای که کاربر با آن احراز هویت خواهد شد
.IP \[bu] 2
\f[V]username\f[R]: یک نام کاربری (معمولاً یک نشانی ایمیل)
.IP \[bu] 2
\f[V]password\f[R]: گذرواژه کاربر
.PP
مایکروسافت این نوع احراز هویت را توصیه نمی‌کند، زیرا نسبت به سایر روش‌های احراز هویت امنیت کمتری دارد.
این روش تعاملی نیست، بنابراین با هیچ شکلی از احراز هویت چندعاملی (MFA) سازگار نبوده و برنامه باید از قبل رضایت کاربر یا مدیر را دریافت کرده باشد.
این اعتبارنامه تنها می‌تواند حساب‌های کاری و تحصیلی را احراز هویت کند؛ این روش قادر به احراز هویت حساب‌های شخصی مایکروسافت نیست.
.PP
\f[B]توجه:\f[R] مقدار \f[V]password\f[R] باید مبهم‌سازی (obscure) شود \- مستندات rclone obscure (https://rclone.org/commands/rclone_obscure) را ببینید.
.SS اعتبارنامه‌های هویت خدمات مدیریت‌شده (Managed Service Identity Credentials)
.PP
اگر \f[V]use_msi\f[R] تنظیم شده باشد، از اعتبارنامه‌های هویت خدمات مدیریت‌شده (MSI) استفاده می‌شود.
این احراز هویت تنها هنگام اجرا در یکی از سرویس‌های Azure کار می‌کند.
برای استفاده از این قابلیت، \f[V]env_auth\f[R] نباید تنظیم شده باشد.
.PP
با این حال، اگر چندین هویت کاربری برای انتخاب دارید، باید دقیقاً با استفاده از یکی از پارامترهای
\f[V]msi_object_id\f[R]، \f[V]msi_client_id\f[R] یا
\f[V]msi_mi_res_id\f[R] به صورت صریح مشخص شوند.
.PP
اگر هیچ‌یک از متغیرهای \f[V]msi_object_id\f[R]، \f[V]msi_client_id\f[R] یا
\f[V]msi_mi_res_id\f[R] تنظیم نشده باشند، این حالت معادل استفاده از
\f[V]env_auth\f[R] خواهد بود.
.SS اعتبارنامه‌های هویت فدرال (Federated Identity Credentials)
.PP
در صورت تنظیم این متغیرها، rclone با استفاده از هویت فدرال احراز هویت خواهد کرد.
.IP \[bu] 2
\f[V]tenant\f[R]: شناسه مستأجر (tenant ID) فضای ذخیره‌سازی
.IP \[bu] 2
\f[V]client_id\f[R]: شناسه کلاینت (client ID) برنامه‌ای که کاربر برای احراز هویت در فضای ذخیره‌سازی استفاده می‌کند
.IP \[bu] 2
\f[V]msi_client_id\f[R]: شناسه کلاینت هویت مدیریت‌شده (MSI client ID) برنامه‌ای که کاربر با آن احراز هویت خواهد کرد
.PP
به‌طور پیش‌فرض از \[dq]api://AzureADTokenExchange\[dq] به‌عنوان دامنه (scope) برای دریافت توکن از طریق MSI استفاده می‌شود.
سپس این توکن با استفاده از \[aq]tenant\[aq] و \[aq]client_id\[aq] با توکن واقعی فضای ذخیره‌سازی مبادله می‌شود.
.SS ابزار Azure CLI به نام \f[V]az\f[R]
.PP
در صورت تنظیم \f[V]use_az\f[R]، از ابزار خط فرمان Azure به نام
\f[V]az\f[R] (https://learn.microsoft.com/en-us/cli/azure) به‌عنوان تنها روش احراز هویت استفاده می‌شود.
.PP
تنظیم این گزینه می‌تواند در صورتی مفید باشد که بخواهید از رابط خط فرمان \f[V]az\f[R] روی میزبانی با «هویت مدیریت‌شده سیستمی» (System Managed Identity) استفاده کنید که مایل به به‌کارگیری آن هویت نیستید.
.PP
هم‌زمان \f[V]env_auth\f[R] را تنظیم نکنید.
.SS گزینه‌های استاندارد (Standard options)
.PP
در این بخش گزینه‌های استاندارد مختص azurefiles (فایل‌های Microsoft Azure) آورده شده است.
.SS --azurefiles-account
.PP
نام حساب ذخیره‌سازی Azure (Azure Storage Account Name).
.PP
این گزینه را روی نام حساب ذخیره‌سازی Azure مورد استفاده تنظیم کنید.
.PP
برای استفاده از نشانی اینترنتی SAS یا شبیه‌ساز (Emulator) آن را خالی بگذارید؛ در غیر این صورت باید تنظیم شود.
.PP
اگر این مقدار خالی باشد و env_auth تنظیم شده باشد، در صورت امکان از متغیر محیطی \f[V]AZURE_STORAGE_ACCOUNT_NAME\f[R] خوانده خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: account
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_ACCOUNT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false.SS --azurefiles-env-auth
.PP
خواندن اطلاعات احراز هویت از زمان اجرا (متغیرهای محیطی، CLI یا MSI).
.PP
برای اطلاعات کامل، مستندات احراز هویت را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: env_auth
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_ENV_AUTH
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --azurefiles-key
.PP
کلید مشترک حساب ذخیره‌سازی (Storage Account Shared Key).
.PP
جهت استفاده از SAS URL یا Emulator، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: key
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azurefiles-sas-url
.PP
آدرس SAS URL تنها برای دسترسی در سطح کانتینر (container).
.PP
در صورت استفاده از حساب/کلید (account/key) یا Emulator، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sas_url
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_SAS_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azurefiles-connection-string
.PP
رشته اتصال ذخیره‌سازی (Storage Connection String).
.PP
رشته اتصال برای فضای ذخیره‌سازی.
در صورت استفاده از سایر روش‌های احراز هویت، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: connection_string
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_CONNECTION_STRING
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azurefiles-tenant
.PP
شناسه tenant مربوط به service principal.
همچنین شناسه دایرکتوری (directory ID) آن نیز نامیده می‌شود.
.PP
اگر از موارد زیر استفاده می‌کنید، این مقدار را تنظیم کنید: \- Service principal همراه با client secret \- Service
principal همراه با گواهی (certificate) \- کاربر همراه با نام کاربری و گذرواژه
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: tenant
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_TENANT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azurefiles-client-id
.PP
شناسه کلاینت (client) مورد استفاده.
.PP
اگر از موارد زیر استفاده می‌کنید، این مقدار را تنظیم کنید: \- Service principal همراه با client secret \- Service
principal همراه با گواهی (certificate) \- کاربر همراه با نام کاربری و گذرواژه
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --azurefiles-client-secret
.PP
یکی از کلیدهای مخفی کلاینت (client secret) مربوط به service principal
.PP
در صورت استفاده از «Service principal با client secret» این مقدار را تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azurefiles-client-certificate-path
.PP
مسیر فایل گواهی PEM یا PKCS12 شامل کلید خصوصی (private key).
.PP
در صورت استفاده از «Service principal با گواهی (certificate)» این مقدار را تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_certificate_path
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_CLIENT_CERTIFICATE_PATH
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azurefiles-client-certificate-password
.PP
گذرواژه فایل گواهی (اختیاری).
.PP
در صورت استفاده از «Service principal با گواهی» این گزینه را به صورت اختیاری تنظیم کنید
.PP
و در صورتی که گواهی دارای گذرواژه باشد.
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی شود - دستور rclone obscure را ببینید (<https://rclone.org/commands/rclone_obscure>).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_certificate_password
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_CLIENT_CERTIFICATE_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azurefiles-share-name
.PP
نام اشتراک Azure Files (Share Name).
.PP
این گزینه الزامی است و نام اشتراکی است که باید به آن دسترسی پیدا کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: share_name
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_SHARE_NAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مخصوص azurefiles (Microsoft Azure Files) آورده شده است.
.SS --azurefiles-client-send-certificate-chain
.PP
ارسال زنجیره گواهی هنگام استفاده از احراز هویت با گواهی.
.PP
مشخص می‌کند که آیا درخواست احراز هویت شامل هدر x5c برای پشتیبانی از احراز هویت مبتنی بر subject name / issuer باشد یا خیر.
هنگامی که روی true تنظیم شود، درخواست‌های احراز هویت شامل هدر x5c خواهند بود.
.PP
در صورت استفاده از «Service principal با گواهی» این گزینه را به صورت اختیاری تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_send_certificate_chain
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_CLIENT_SEND_CERTIFICATE_CHAIN
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --azurefiles-username
.PP
نام کاربری (معمولاً یک نشانی رایانامه)
.PP
اگر از «کاربر با نام کاربری و گذرواژه» استفاده می‌کنید، این مورد را تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: username
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_USERNAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azurefiles-password
.PP
گذرواژه کاربر
.PP
اگر از «کاربر با نام کاربری و گذرواژه» استفاده می‌کنید، این مورد را تنظیم کنید.
.PP
\f[B]توجه:\f[R] ورودی این گزینه باید مبهم‌سازی (obscure) شود \- به rclone obscure (https://rclone.org/commands/rclone_obscure) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: password
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azurefiles-service-principal-file
.PP
مسیر فایل حاوی اطلاعات احراز هویت برای استفاده با یک service principal.
.PP
در حالت عادی خالی بگذارید.
تنها در صورتی نیاز است که بخواهید به‌جای ورود تعاملی، از یک service principal استفاده کنید.
.IP
.nf
\f[C]
$ az ad sp create-for-rbac --name \[dq]<name>\[dq] \[rs]
  --role \[dq]Storage Blob Data Owner\[dq] \[rs]
  --scopes \[dq]/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account>/blobServices/default/containers/<container>\[dq] \[rs]
  > azure-principal.json
\f[R]
.fi
.PP
برای جزئیات بیشتر به صفحه‌های \[dq]Create an Azure service principal\[dq] (https://docs.microsoft.com/en-us/cli/azure/create-an-azure-service-principal-azure-cli) و \[dq]Assign an Azure role for access to blob data\[dq] (https://docs.microsoft.com/en-us/azure/storage/common/storage-auth-aad-rbac-cli) مراجعه کنید.
.PP
شاید راحت‌تر باشد که اطلاعات احراز هویت را به‌جای تنظیم \f[V]service_principal_file\f[R]، مستقیماً در فایل پیکربندی rclone زیر کلیدهای \f[V]client_id\f[R]، \f[V]tenant\f[R] و \f[V]client_secret\f[R] قرار دهید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: service_principal_file
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_SERVICE_PRINCIPAL_FILE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azurefiles-disable-instance-discovery
.PP
صرف‌نظر از درخواست فراداده نمونه Microsoft Entra
.PP
این گزینه فقط باید توسط برنامه‌هایی روی true تنظیم شود که در ابرهای مجزا (disconnected clouds) یا ابرهای خصوصی مانند Azure Stack احراز هویت می‌کنند.
.PP
این گزینه مشخص می‌کند که آیا rclone قبل از احراز هویت، متادیتای نمونه Microsoft Entra را از \f[V]https://login.microsoft.com\f[R] درخواست کند یا خیر.
.PP
تنظیم این گزینه بر روی true باعث نادیده گرفتن این درخواست می‌شود، که مسئولیت اطمینان از معتبر و قابل اعتماد بودن مرجع (authority) پیکربندی‌شده را بر عهده خودتان می‌گذارد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_instance_discovery
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_DISABLE_INSTANCE_DISCOVERY
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --azurefiles-use-msi
.PP
استفاده از هویت سرویس مدیریت‌شده (MSI) برای احراز هویت (تنها در Azure کار می‌کند).
.PP
در صورت تنظیم روی true، برای احراز هویت در Azure Storage به جای توکن SAS یا کلید حساب، از یک هویت سرویس مدیریت‌شده
(https://docs.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources)
استفاده می‌شود.
.PP
اگر VM(SS) که این برنامه روی آن اجرا می‌شود دارای یک هویت انتساب‌داده‌شده توسط سیستم (system-assigned) باشد، به‌طور پیش‌فرض از آن استفاده خواهد شد.
اگر منبع فاقد هویت system-assigned بوده اما دقیقاً یک هویت انتساب‌داده‌شده توسط کاربر (user-assigned) داشته باشد، به‌طور پیش‌فرض از هویت user-assigned استفاده می‌شود.
اگر منبع دارای چندین هویت user-assigned باشد، هویت مورد استفاده باید به‌طور صریح با استفاده از دقیقاً یکی از پارامترهای msi_object_id، msi_client_id یا msi_mi_res_id مشخص گردد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_msi
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_USE_MSI
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --azurefiles-msi-object-id
.PP
شناسه شیء (Object ID) مربوط به MSI انتساب‌داده‌شده توسط کاربر برای استفاده، در صورت وجود.
.PP
در صورت تعیین msi_client_id یا msi_mi_res_id خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: msi_object_id
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_MSI_OBJECT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azurefiles-msi-client-id
.PP
شناسه شیء (Object ID) مربوط به MSI انتساب‌داده‌شده توسط کاربر برای استفاده، در صورت وجود.
.PP
در صورت تعیین msi_object_id یا msi_mi_res_id خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: msi_client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_MSI_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azurefiles-msi-mi-res-id
.PP
شناسه منبع Azure مربوط به MSI انتساب‌داده‌شده توسط کاربر برای استفاده، در صورت وجود.
.PP
در صورت تعیین msi_client_id یا msi_object_id خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: msi_mi_res_id
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_MSI_MI_RES_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azurefiles-use-emulator
.PP
در صورت مشخص شدن به‌عنوان \[aq]true\[aq]، از شبیه‌ساز فضای ذخیره‌سازی محلی استفاده می‌کند.
.PP
در صورت استفاده از نقطه پایانی (endpoint) واقعی Azure Storage خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_emulator
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_USE_EMULATOR
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --azurefiles-use-az
.PP
استفاده از ابزار Azure CLI یعنی az برای احراز هویت
.PP
این گزینه را برای استفاده از ابزار Azure CLI یعنی
az (https://learn.microsoft.com/en-us/cli/azure) به عنوان تنها روش
احراز هویت تنظیم کنید.
.PP
تنظیم این گزینه می‌تواند زمانی مفید باشد که بخواهید از az CLI روی میزبانی با
یک System Managed Identity استفاده کنید که مایل به استفاده از آن نیستید.
.PP
هم‌زمان env_auth را تنظیم نکنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_az
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_USE_AZ
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --azurefiles-endpoint
.PP
نقطه پایانی (Endpoint) سرویس.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_ENDPOINT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --azurefiles-chunk-size
.PP
اندازه تکه‌های بارگذاری (upload chunk size).
.PP
توجه داشته باشید که این مقدار در حافظه ذخیره می‌شود و ممکن است حداکثر تا
\[dq]--transfers\[dq] * \[dq]--azurefile-upload-concurrency\[dq] تکه
به صورت هم‌زمان در حافظه نگه‌داری شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 4Mi
.SS --azurefiles-upload-concurrency
.PP
میزان هم‌زمانی در بارگذاری‌های چندبخشی (multipart uploads).
.PP
این مقدار، تعداد تکه‌های یک فایل مشابه است که به صورت هم‌زمان
بارگذاری می‌شوند.
.PP
اگر تعداد کمی فایل حجیم را روی اتصالات پرسرعت بارگذاری می‌کنید
و این بارگذاری‌ها به طور کامل از پهنای باند شما استفاده نمی‌کنند،
افزایش این مقدار می‌تواند به بالا بردن سرعت انتقال‌ها کمک کند.
.PP
توجه داشته باشید که تکه‌ها در حافظه ذخیره می‌شوند و ممکن است حداکثر تا
\[dq]--transfers\[dq] * \[dq]--azurefile-upload-concurrency\[dq] تکه
به طور هم‌زمان در حافظه نگه‌داری شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_UPLOAD_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 16
.SS --azurefiles-max-stream-size
.PP
حداکثر اندازه برای فایل‌های جاری‌سازی‌شده (streamed).
.PP
سرویس Azure files باید از قبل بداند که اندازه فایل چقدر خواهد بود.
زمانی که rclone از این مقدار اطلاعی ندارد، در عوض از این مقدار استفاده می‌کند.
.PP
این مقدار هنگامی استفاده خواهد شد که rclone در حال جاری‌سازی داده‌ها باشد؛
رایج‌ترین کاربردها عبارتند از:
.IP \[bu] 2
بارگذاری فایل‌ها با \f[V]--vfs-cache-mode off\f[R] به همراه
\f[V]rclone mount\f[R]
.IP \[bu] 2
استفاده از \f[V]rclone rcat\f[R]
.IP \[bu] 2
کپی کردن فایل‌هایی با طول نامشخص
.PP
شما به این مقدار فضای خالی در اشتراک (share) نیاز خواهید داشت زیرا فایل
به صورت موقت این اندازه خواهد بود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: max_stream_size
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_MAX_STREAM_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 10Gi.SS --azurefiles-encoding
.PP
کدگذاری برای بک‌اند.
.PP
برای اطلاعات بیشتر بخش کدگذاری در بررسی کلی را در (<https://rclone.org/overview/#encoding>) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,RightPeriod,InvalidUtf8,Dot
.SS --azurefiles-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_AZUREFILES_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS "سرآیندهای سفارشی بارگذاری (Custom upload headers)"
.PP
می‌توانید با استفاده از پرچم \f[V]--header-upload\f[R] سرآیندهای سفارشی برای بارگذاری تنظیم کنید.
.IP \[bu] 2
Cache-Control
.IP \[bu] 2
Content-Disposition
.IP \[bu] 2
Content-Encoding
.IP \[bu] 2
Content-Language
.IP \[bu] 2
Content-Type
.PP
به‌عنوان مثال: \f[V]--header-upload \[dq]Content-Type: text/potato\[dq]\f[R]
.SS "محدودیت‌ها (Limitations)"
.PP
چک‌سام‌های MD5 تنها در صورتی همراه با فایل‌های چندبخشی (chunked) بارگذاری می‌شوند که مبدأ دارای چک‌سام MD5 باشد.
این وضعیت همیشه برای کپی از سیستم محلی به azure برقرار است.
.SH "مایکروسافت وان‌درایو (Microsoft OneDrive)"
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند به هر عمق مورد نیازی باشند، مانند:
\f[V]remote:directory/subdirectory\f[R].
.SS "پیکربندی (Configuration)"
.PP
راه‌اندازی اولیه OneDrive نیازمند دریافت یک توکن از Microsoft است که باید آن را در مرورگر وب خود دریافت کنید.
فرمان \f[V]rclone config\f[R] شما را مرحله‌به‌مرحله راهنمایی می‌کند.
.PP
در اینجا نمونه‌ای از نحوه ساخت یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرآیند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> n
name> remote
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / Microsoft OneDrive
   \[rs] \[dq]onedrive\[dq]
[snip]
Storage> onedrive
Microsoft App Client Id
Leave blank normally.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
client_id>
Microsoft App Client Secret
Leave blank normally.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
client_secret>
Edit advanced config? (y/n)
y) Yes
n) No
y/n> n
Remote config
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y) Yes
n) No
y/n> y
If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth
Log in and authorize rclone for access
Waiting for code...
Got code
Choose a number from below, or type in an existing value
 1 / OneDrive Personal or Business
   \[rs] \[dq]onedrive\[dq]
 2 / Sharepoint site
   \[rs] \[dq]sharepoint\[dq]
 3 / Type in driveID
   \[rs] \[dq]driveid\[dq]
 4 / Type in SiteID
   \[rs] \[dq]siteid\[dq]
 5 / Search a Sharepoint site
   \[rs] \[dq]search\[dq]
Your choice> 1
Found 1 drives, please select the one you want to use:
0: OneDrive (business) id=b!Eqwertyuiopasdfghjklzxcvbnm-7mnbvcxzlkjhgfdsapoiuytrewqk
Chose drive to use:> 0
Found drive \[aq]root\[aq] of type \[aq]business\[aq], URL: https://org-my.sharepoint.com/personal/you/Documents
Is that okay?
y) Yes
n) No
y/n> y
Configuration complete.
Options:
- type: onedrive
- token: {\[dq]access_token\[dq]:\[dq]youraccesstoken\[dq],\[dq]token_type\[dq]:\[dq]Bearer\[dq],\[dq]refresh_token\[dq]:\[dq]yourrefreshtoken\[dq],\[dq]expiry\[dq]:\[dq]2018-08-26T22:39:52.486512262+08:00\[dq]}
- drive_id: b!Eqwertyuiopasdfghjklzxcvbnm-7mnbvcxzlkjhgfdsapoiuytrewqk
- drive_type: business
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
برای اطلاع از نحوه راه‌اندازی روی سامانه‌ای که فاقد مرورگر وب متصل به اینترنت است، به اسناد راه‌اندازی ریموت در (<https://rclone.org/remote_setup>) مراجعه کنید.
.PP
توجه داشته باشید که rclone برای جمع‌آوری توکن برگشتی از Microsoft یک وب‌سرور روی سیستم محلی شما اجرا می‌کند.
این وب‌سرور تنها از لحظه باز کردن مرورگر تا زمان بازگردانی کد تأیید در حال اجرا خواهد بود.
این سرویس روی \f[V]http://127.0.0.1:53682\f[R] قرار دارد و چنانچه فایروال محلی فعال است، ممکن است نیاز باشد آن را به‌طور موقت آزاد کنید.
.PP
پس از اتمام پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (به جای \f[V]remote\f[R] نامی را که برای ریموت خود تعیین کرده‌اید قرار دهید):
.PP
فهرست کردن دایرکتوری‌ها در سطح بالای OneDrive:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در OneDrive:
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi.PP
برای رونوشت کردن یک دایرکتوری محلی به یک دایرکتوری OneDrive به نام backup:
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi
.SS دریافت Client ID و Key اختصاصی خود
.PP
برنامه rclone در هنگام ارتباط با OneDrive از یک Client ID پیش‌فرض استفاده می‌کند، مگر این‌که یک \f[V]client_id\f[R] سفارشی در پیکربندی مشخص شده باشد.
شناسه Client ID و Key پیش‌فرض هنگام ارسال درخواست‌ها، میان تمام کاربران rclone به اشتراک گذاشته می‌شوند.
.PP
در صورتی که شناسه پیش‌فرض برای شما مناسب نیست، می‌توانید Client ID اختصاصی خود را ایجاد کرده و استفاده کنید.
به عنوان مثال، ممکن است با محدودیت نرخ درخواست (throttling) مواجه شوید.
.SS ایجاد Client ID برای OneDrive Personal
.PP
برای ایجاد Client ID اختصاصی خود، لطفاً مراحل زیر را دنبال کنید:
.IP "1." 3
نشانی
<https://portal.azure.com/?quickstart=true#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/Overview>
را باز کرده و سپس زیر منوی \f[V]Add\f[R] روی \f[V]App registration\f[R] کلیک کنید.
.RS 4
.IP \[bu] 2
اگر حساب Azure نساخته‌اید، از شما خواسته می‌شود که ایجاد کنید.
این حساب رایگان است، اما برای تأیید هویت باید شماره تلفن، آدرس و کارت اعتباری ارائه دهید.
.RE
.IP "2." 3
یک نام برای برنامه خود وارد کنید، نوع حساب را
\f[V]Accounts in any organizational    directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts    (e.g. Skype, Xbox)\f[R]
انتخاب کنید، در بخش \f[V]Redirect URI\f[R] گزینه \f[V]Web\f[R] را برگزینید، سپس عبارت \f[V]http://localhost:53682/\f[R] را تایپ کنید (رونوشت و جای‌گذاری نکنید) و روی Register کلیک نمایید.
شناسه \f[V]Application (client) ID\f[R] واقع در زیر نام برنامه را کپی کرده و برای استفاده‌های بعدی نگه دارید.
.IP "3." 3
زیر بخش \f[V]manage\f[R] گزینه \f[V]Certificates & secrets\f[R] را انتخاب کرده و روی \f[V]New client secret\f[R] کلیک کنید.
یک توضیح وارد کنید (می‌تواند هر چیزی باشد) و مقدار \f[V]Expires\f[R] را روی ۲۴ ماه تنظیم نمایید.
مقدار \f[I]Value\f[R] آن کلید مخفی را برای استفاده‌های بعدی کپی و نگهداری کنید (بعداً قادر به دیدن این مقدار \f[I]نخواهید بود\f[R]).
.IP "4." 3
زیر بخش \f[V]manage\f[R] گزینه \f[V]API permissions\f[R] را انتخاب کرده، روی \f[V]Add a permission\f[R] کلیک کنید و \f[V]Microsoft Graph\f[R] و سپس \f[V]delegated permissions\f[R] را انتخاب نمایید.
.IP "5." 3
مجوزهای زیر را جستجو و انتخاب کنید: \f[V]Files.Read\f[R]،
\f[V]Files.ReadWrite\f[R]، \f[V]Files.Read.All\f[R]،
\f[V]Files.ReadWrite.All\f[R]، \f[V]offline_access\f[R]،
\f[V]User.Read\f[R] و \f[V]Sites.Read.All\f[R] (اگر محدوده‌های دسترسی سفارشی پیکربندی شده‌اند، مجوزها را متناسب با آن انتخاب کنید).
پس از انتخاب، روی \f[V]Add permissions\f[R] در پایین صفحه کلیک کنید.
.PP
اکنون برنامه کامل شده است.
دستور \f[V]rclone config\f[R] را برای ایجاد یا ویرایش یک ریموت OneDrive اجرا کنید.
شناسه برنامه (app ID) و گذرواژه را به ترتیب به عنوان Client ID و Secret وارد کنید.
برنامه rclone شما را در مراحل باقی‌مانده راهنمایی خواهد کرد.
.PP
گزینه access_scopes به شما امکان می‌دهد مجوزهای درخواست‌شده توسط rclone را پیکربندی کنید.
برای اطلاعات بیشتر درباره محدوده‌های مختلف، به مستندات مایکروسافت
(https://docs.microsoft.com/en-us/graph/permissions-reference#files-permissions)
مراجعه کنید.
.PP
در صورتی که هنگام پیکربندی ریموت
(https://github.com/rclone/rclone/pull/5883)
نیاز به جستجوی سایت‌های SharePoint داشته باشید، مجوز \f[V]Sites.Read.All\f[R] الزامی است.
با این حال، اگر این مجوز اختصاص داده نشده باشد، باید \f[V]Sites.Read.All\f[R] را از محدوده‌های دسترسی خود خارج کنید یا در گزینه‌های پیشرفته مقدار گزینه \f[V]disable_site_permission\f[R] را روی true قرار دهید.
.SS ایجاد Client ID برای OneDrive Business
.PP
مراحل مربوط به OneDrive Personal ممکن است بسته به تنظیمات امنیتی سازمان برای OneDrive Business کار کند یا نکند.
یک خطای رایج این است که ناشر برنامه تأیید نشده است (publisher of the App is not verified).
.PP
می‌توانید برای تأیید حساب خود اقدام کنید
(https://docs.microsoft.com/en-us/azure/active-directory/develop/publisher-verification-overview)
یا همان‌طور که در زیر نشان داده شده است، دسترسی برنامه را فقط به سازمان خود محدود نمایید.
.IP "1." 3
اطمینان حاصل کنید که برنامه را با حساب تجاری خود ایجاد می‌کنید.
.IP "2." 3
مراحل فوق را برای ایجاد یک برنامه دنبال کنید.
با این حال، در اینجا به نوع حساب متفاوتی نیاز داریم:
\f[V]Accounts in this organizational directory only (*** - Single tenant)\f[R].
توجه داشته باشید که پس از ایجاد برنامه نیز می‌توانید نوع حساب را تغییر دهید.
.IP "3." 3
شناسه مستأجر یا سازمان (tenant ID) سازمان خود را پیدا کنید
(https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-how-to-find-tenant).
.IP "4." 3
در پیکربندی rclone، مقدار \f[V]auth_url\f[R] را روی
\f[V]https://login.microsoftonline.com/YOUR_TENANT_ID/oauth2/v2.0/authorize\f[R]
تنظیم کنید.
.IP "5." 3
در پیکربندی rclone، مقدار \f[V]token_url\f[R] را روی
\f[V]https://login.microsoftonline.com/YOUR_TENANT_ID/oauth2/v2.0/token\f[R]
تنظیم کنید.
.PP
نکته: اگر در منطقه جغرافیایی خاصی (special region) قرار دارید، ممکن است در مراحل ۴ و ۵ به هاست متفاوتی نیاز داشته باشید.
چند راهنمایی در اینجا آورده شده است
(https://github.com/rclone/rclone/blob/bc23bf11db1c78c6ebbf8ea538fbebf7058b4176/backend/onedrive/onedrive.go#L86)..SS استفاده از جریان اعتبارسنجی OAuth Client Credential
.PP
جریان اعتبارسنجی OAuth Client Credential به rclone اجازه می‌دهد به‌جای بهره‌گیری از بستر یک حساب کاربری Azure AD، مستقیماً از مجوزهای مرتبط با برنامه سازمانی (Enterprise) در Azure AD استفاده کند.
.PP
این جریان را می‌توان با دنبال کردن مراحل زیر فعال کرد:
.IP "1." 3
ثبت برنامه سازمانی (Enterprise App registration) را در درگاه Azure AD انجام دهید و همان‌طور که در بالا توضیح داده شد یک Client ID و Client Secret دریافت کنید.
.IP "2." 3
اطمینان حاصل کنید که برنامه مجوزهای مناسب را دارد و آن‌ها به‌عنوان \f[I]Application Permissions\f[R] تخصیص یافته‌اند.
.IP "3." 3
ریموت (remote) را پیکربندی کنید، و مطمئن شوید که \f[I]Client ID\f[R] و \f[I]Client Secret\f[R] به‌درستی وارد شده‌اند.
.IP "4." 3
در بخش \f[I]Advanced Config\f[R]، برای \f[V]client_credentials\f[R] مقدار \f[V]true\f[R] را وارد کرده و در بخش \f[V]tenant\f[R] شناسه مستأجر (tenant ID) را وارد کنید.
.PP
هنگام انتخاب نوع اتصال برای کار با جریان client credentials، توجه داشته باشید که به‌ویژه گزینه \[dq]onedrive\[dq] کار نمی‌کند.
می‌توانید از گزینه \[dq]sharepoint\[dq] استفاده کنید، یا در صورتی که شناسه درایو صحیح پیدا نشد، آن را به‌صورت دستی با گزینه \[dq]driveid\[dq] وارد نمایید.
.PP
برای پشتیبان‌گیری از داده‌های هر کاربر با استفاده از این جریان، مجوزهای لازم در Microsoft Graph از نوع \f[I]Application permissions\f[R] (مانند \f[V]Files.Read.All\f[R]، \f[V]Sites.Read.All\f[R] و/یا \f[V]Sites.Selected\f[R]) را به برنامه Azure AD خود اعطا کنید.
با این مجوزها، rclone می‌تواند به درایوهای سراسر tenant دسترسی داشته باشد، اما باید بداند \f[I]کدام کاربر یا درایو\f[R] مد نظر شماست.
یک \f[V]drive_id\f[R] مشخص مربوط به OneDrive آن کاربر، یا یک شناسه سایت SharePoint برای کتابخانه‌های SharePoint تعیین کنید.
می‌توانید شناسه درایو یک کاربر را با استفاده از Microsoft Graph (مثلاً \f[V]/users/{userUPN}/drive\f[R]) به دست آورده و سپس آن را در rclone پیکربندی کنید.
پس از ارائه شناسه درایو صحیح، rclone با استفاده از توکن مخصوص برنامه (app-only token) و بدون نیاز به اطلاعات کاربری شخص، از داده‌های آن کاربر نسخه پشتیبان تهیه خواهد کرد.
.PP
\f[B]نکته\f[R] تخصیص مستقیم مجوزها به برنامه به این معنی است که هر فردی دارای \f[I]Client ID\f[R] و \f[I]Client Secret\f[R] می‌تواند به فایل‌های OneDrive شما دسترسی پیدا کند.
در حفاظت از این اطلاعات هویتی دقت کافی به عمل آورید.
.SS دسترسی غیرمدیر به Business OneDrive
.PP
اگر دسترسی مدیر (admin) به OneDrive for Business سازمان خود ندارید، همچنان می‌توانید با وارد کردن دستی URL مستأجر SharePoint و drive ID متصل شوید.
این کار با جایگزین کردن نشانی پایه API از نقطه پایانی (endpoint) استاندارد Microsoft Graph به نقطه پایانی SharePoint v2.0 انجام می‌شود.
.SS مراحل دریافت دستی اطلاعات اعتبارسنجی
.IP "1." 3
مرورگر خود را باز کرده و به \f[V]https://[your-tenant].sharepoint.com\f[R] بروید.
.IP "2." 3
ابزارهای توسعه‌دهنده (Developer Tools) را باز کرده (کلید F12 را فشار دهید) و به برگه \f[B]Network\f[R] بروید.
.IP "3." 3
در درخواست‌های شبکه عبارت \f[V]driveAccessToken\f[R] را جستجو کنید.
.IP "4." 3
اطلاعات زیر را از پاسخ استخراج کنید:
.RS 4
.IP
.nf
\f[C]
\[dq].driveUrl\[dq]: \[dq]{tenant_url}/v2.0/drives/{drive_id}\[dq],
\[dq].driveAccessToken\[dq]: \[dq]access_token={access_token}\[dq]
\f[R]
.fi
.RE
.SS پیکربندی Rclone
.PP
از مقادیر استخراج‌شده برای پیکربندی ریموت خود استفاده کنید:
.IP
.nf
\f[C]
type = onedrive
token = {\[dq]access_token\[dq]:\[dq]{access_token}\[dq],\[dq]token_type\[dq]:\[dq]Bearer\[dq],\[dq]refresh_token\[dq]:\[dq]\[dq],\[dq]expiry\[dq]:\[dq]2045-12-31T23:59:59Z\[dq]}
drive_id = {drive_id}
tenant_url = {tenant_url}
drive_type = business
\f[R]
.fi
.PP
از آنجا که زمان دقیق انقضا از طریق ترافیک وب قابل تشخیص نیست، تاریخ انقضا را روی زمانی در آینده تنظیم کنید.
توجه داشته باشید که توکن در نهایت منقضی خواهد شد و لازم است این فرایند را برای دریافت یک توکن جدید تکرار کنید..SS زمان‌های تغییر و هش‌ها (Modification times and hashes)
.PP
سرویس OneDrive امکان تنظیم زمان تغییر اشیاء را با دقت ۱ ثانیه فراهم می‌کند.
از این زمان‌ها برای تشخیص این‌که آیا اشیاء نیاز به همگام‌سازی دارند یا خیر، استفاده خواهد شد.
.PP
سرویس‌های OneDrive Personal، OneDrive for Business و Sharepoint Server از
QuickXorHash (https://docs.microsoft.com/en-us/onedrive/developer/code-snippets/quickxorhash) پشتیبانی می‌کنند.
.PP
پیش از rclone 1.62، هش پیش‌فرض برای OneDrive Personal برابر با
\f[V]SHA1\f[R] بود.
برای rclone 1.62 و بالاتر، پیش‌فرض برای تمام بک‌اندهای OneDrive برابر با
\f[V]QuickXorHash\f[R] است.
.PP
از ژوئیه ۲۰۲۳، پشتیبانی از \f[V]SHA1\f[R] در OneDrive Personal به نفع \f[V]QuickXorHash\f[R] در حال منسوخ شدن است.
در صورت لزوم، اگر این موضوع در گردش کار شما اهمیت دارد، می‌توان از پرچم \f[V]--onedrive-hash-type\f[R] (یا
گزینهٔ پیکربندی \f[V]hash_type\f[R]) برای انتخاب \f[V]SHA1\f[R]
در طول دورهٔ گذار استفاده کرد.
.PP
برای تمام انواع OneDrive می‌توانید از پرچم \f[V]--checksum\f[R] استفاده کنید.
.SS --fast-list
.PP
این ریموت از \f[V]--fast-list\f[R] پشتیبانی می‌کند که به شما امکان می‌دهد در ازای مصرف حافظهٔ بیشتر، از تراکنش‌های کمتری
استفاده کنید.
برای جزئیات بیشتر به مستندات rclone (https://rclone.org/docs/#fast-list) مراجعه
کنید.
.PP
این قابلیت باید با پرچم \f[V]--onedrive-delta\f[R] (یا
\f[V]delta = true\f[R] در فایل پیکربندی) فعال شود، زیرا می‌تواند باعث افت
کارایی شود.
.PP
این کار با استفاده از امکانات فهرست‌بندی دلتای OneDrive انجام می‌شود که
تمامی فایل‌های موجود در ریموت را با بازدهی بسیار بالایی بازمی‌گرداند.
این روش بسیار کارآمدتر از فهرست‌بندی بازگشتی دایرکتوری‌ها است و روش
توصیه‌شدهٔ مایکروسافت برای خواندن تمام اطلاعات فایل‌ها از یک درایو می‌باشد.
.PP
این ویژگی می‌تواند به همراه \f[V]rclone mount\f[R] و rclone rc vfs/refresh
recursive=true (https://rclone.org/rc/#vfs-refresh) برای پر کردن بسیار سریع
اطلاعات تمامی فایل‌ها در نقطهٔ اتصال مفید باشد.
.PP
رابط برنامه‌نویسی (API) استفاده‌شده برای فهرست‌بندی بازگشتی (\f[V]ListR\f[R]) تنها از
فهرست‌بندی از ریشهٔ درایو پشتیبانی می‌کند.
هرچه از ریشه دورتر شوید، این روش به طور فزاینده‌ای ناکارآمدتر می‌شود، زیرا rclone مجبور است فایل‌های خارج از
دایرکتوری مورد نظر شما را نادیده بگیرد.
.PP
برخی دستورها (مانند \f[V]rclone lsf -R\f[R]) به صورت پیش‌فرض از \f[V]ListR\f[R]
استفاده می‌کنند؛ در صورت نیاز می‌توانید آن را با \f[V]--disable ListR\f[R]
غیرفعال کنید.
.SS نویسه‌های محدودشده در نام فایل (Restricted filename characters)
.PP
علاوه بر مجموعه نویسه‌های محدودشدهٔ
پیش‌فرض (https://rclone.org/overview/#restricted-characters)، نویسه‌های
زیر نیز جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\[dq]
T}@T{
0x22
T}@T{
＂
T}
T{
*
T}@T{
0x2A
T}@T{
＊
T}
T{
:
T}@T{
0x3A
T}@T{
：
T}
T{
<
T}@T{
0x3C
T}@T{
＜
T}
T{
>
T}@T{
0x3E
T}@T{
＞
T}
T{
?
T}@T{
0x3F
T}@T{
？
T}
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
T{
|
T}@T{
0x7C
T}@T{
｜
T}
.TE
.PP
همچنین نام فایل‌ها نمی‌تواند با نویسه‌های زیر خاتمه یابد.
این نویسه‌ها تنها در صورتی جایگزین می‌شوند که آخرین نویسه در نام فایل باشند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
SP
T}@T{
0x20
T}@T{
␠
T}
T{
\&.
T}@T{
0x2E
T}@T{
．
T}
.TE
.PP
همچنین نام فایل‌ها نمی‌تواند با نویسه‌های زیر آغاز شود.
این نویسه‌ها تنها در صورتی جایگزین می‌شوند که اولین نویسه در نام فایل باشند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
SP
T}@T{
0x20
T}@T{
␠
T}
T{
\[ti]
T}@T{
0x7E
T}@T{
～
T}
.TE.PP
بایت‌های نامعتبر UTF\-8 نیز جایگزین خواهند شد
(https://rclone.org/overview/#invalid-utf8)، چرا که نمی‌توان از آن‌ها در
رشته‌های JSON استفاده کرد.
.SS "حذف فایل‌ها"
.PP
هر فایلی که با rclone حذف کنید، به سطل زباله (trash) منتقل خواهد شد.
مایکروسافت هیچ APIای برای حذف دائمی فایل‌ها یا خالی کردن سطل زباله
ارائه نمی‌دهد، بنابراین باید این کار را با یکی از برنامه‌های مایکروسافت
یا از طریق وب‌سایت OneDrive انجام دهید.
.SS "گزینه‌های استاندارد"
.PP
در اینجا گزینه‌های استاندارد مختص onedrive (Microsoft OneDrive) آورده شده است.
.SS --onedrive-client-id
.PP
شناسه کلاینت OAuth.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --onedrive-client-secret
.PP
کلید مخفی کلاینت OAuth.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --onedrive-region
.PP
انتخاب منطقه ابری ملی برای OneDrive.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: region
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_REGION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]global\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]global\[dq]
.RS 2
.IP \[bu] 2
ابر جهانی مایکروسافت (Microsoft Cloud Global)
.RE
.IP \[bu] 2
\[dq]us\[dq]
.RS 2
.IP \[bu] 2
ابر مایکروسافت برای دولت ایالات متحده (Microsoft Cloud for US Government)
.RE
.IP \[bu] 2
\[dq]de\[dq]
.RS 2
.IP \[bu] 2
ابر مایکروسافت آلمان (منسوخ‌شده \- ابتدا منطقه global را امتحان کنید).
.RE
.IP \[bu] 2
\[dq]cn\[dq]
.RS 2
.IP \[bu] 2
Azure و Office 365 اداره‌شده توسط Vnet Group در چین
.RE
.RE.SS --onedrive-tenant
.PP
شناسهٔ مستأجر (tenant) مربوط به service principal.
همچنین به آن شناسهٔ دایرکتوری (directory ID) نیز گفته می‌شود.
.PP
در صورت استفاده از فرآیند اعتبارنامهٔ کلاینت (Client Credential flow)، این مورد را تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: tenant
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_TENANT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفتهٔ ویژهٔ onedrive (Microsoft OneDrive) آورده شده‌اند.
.SS --onedrive-token
.PP
توکن دسترسی OAuth در قالب یک JSON blob.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --onedrive-auth-url
.PP
نشانی اینترنتی (URL) سرور احراز هویت.
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، این مقدار را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --onedrive-token-url
.PP
نشانی اینترنتی (URL) سرور توکن.
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، این مقدار را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --onedrive-client-credentials
.PP
استفاده از فرآیند اعتبارسنجی کلاینت (client credentials) در OAuth.
.PP
این گزینه از OAUTH2 client Credentials Flow همان‌طور که در RFC 6749 شرح داده شده است استفاده خواهد کرد.
.PP
توجه داشته باشید که این گزینه توسط همهٔ Backendها پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --onedrive-upload-cutoff
.PP
آستانه جابجایی به بارگذاری تکه‌ای (chunked upload).
.PP
هر فایلی بزرگ‌تر از این مقدار در تکه‌هایی به اندازه chunk_size بارگذاری خواهد شد.
.PP
این گزینه به‌طور پیش‌فرض غیرفعال است، زیرا بارگذاری با استفاده از روش تک‌بخشی (single part) باعث می‌شود rclone در OneDrive تجاری دو برابر فضای ذخیره‌سازی مصرف کند؛ چرا که وقتی rclone پس از بارگذاری زمان ویرایش را تنظیم می‌کند، OneDrive نسخه جدیدی ایجاد می‌کند.
.PP
ببینید: https://github.com/rclone/rclone/issues/1716
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: off
.SS --onedrive-tenant-url
.PP
نشانی URL مستأجر (tenant URL) برای دسترسی غیرمدیریتی به OneDrive.
.PP
این گزینه را روی نشانی URL مستأجر SharePoint خود تنظیم کنید تا به‌جای Microsoft Graph API استاندارد، از نقطه پایانی SharePoint v2.0 API استفاده شود.
این قابلیت امکان دسترسی به OneDrive تجاری را بدون نیاز به رضایت مدیر (admin consent) فراهم می‌کند.
.PP
این نشانی URL را می‌توان در ابزارهای توسعه‌دهنده مرورگرتان با جستجوی \[dq]driveAccessToken\[dq] در درخواست‌های شبکه پیدا کرد.
به دنبال فیلد \[dq].driveUrl\[dq] بگردید که حاوی نشانی URL مستأجر و شناسه درایو است.
.PP
مثال: https://your-tenant.sharepoint.com/_api
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: tenant_url
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_TENANT_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --onedrive-chunk-size
.PP
اندازه تکه‌ها برای بارگذاری فایل‌ها \- باید مضربی از 320k (327,680 بایت) باشد.
.PP
فایل‌های بزرگ‌تر از این اندازه تکه‌تکه خواهند شد \- باید مضربی از 320k (327,680 بایت) باشد و نباید از 250M (262,144,000 بایت) تجاوز کند، در غیر این صورت ممکن است با خطای
\[dq]Microsoft.SharePoint.Client.InvalidClientQueryException: The request message is too big.\[dq] مواجه شوید.
توجه داشته باشید که تکه‌ها در حافظه بافر می‌شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 10Mi
.SS --onedrive-drive-id
.PP
شناسه درایوی که باید استفاده شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: drive_id
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_DRIVE_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --onedrive-drive-type
.PP
نوع درایو (personal | business | documentLibrary).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: drive_type
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_DRIVE_TYPE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --onedrive-root-folder-id
.PP
شناسهٔ پوشه ریشه.
.PP
این مورد در حالت عادی نیاز نیست، اما در شرایط خاص ممکن است شناسه پوشه‌ای را که می‌خواهید به آن دسترسی داشته باشید بدانید، ولی امکان رسیدن به آن از طریق پیمایش مسیر وجود نداشته باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_folder_id
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_ROOT_FOLDER_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --onedrive-access-scopes
.PP
تنظیم حوزه‌های دسترسی که باید توسط rclone درخواست شوند.
.PP
یک فهرست سفارشی جداشده با فاصله شامل تمام حوزه‌های دسترسی که rclone باید درخواست کند را انتخاب کرده یا به صورت دستی وارد کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: access_scopes
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_ACCESS_SCOPES
.IP \[bu] 2
نوع: SpaceSepList
.IP \[bu] 2
پیش‌فرض: Files.Read Files.ReadWrite Files.Read.All Files.ReadWrite.All
Sites.Read.All offline_access
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]Files.Read Files.ReadWrite Files.Read.All Files.ReadWrite.All
Sites.Read.All offline_access\[dq]
.RS 2
.IP \[bu] 2
دسترسی خواندن و نوشتن به تمام منابع
.RE
.IP \[bu] 2
\[dq]Files.Read Files.Read.All Sites.Read.All offline_access\[dq]
.RS 2
.IP \[bu] 2
دسترسی فقط خواندنی به تمام منابع
.RE
.IP \[bu] 2
\[dq]Files.Read Files.ReadWrite Files.Read.All Files.ReadWrite.All
offline_access\[dq]
.RS 2
.IP \[bu] 2
دسترسی خواندن و نوشتن به تمام منابع، بدون امکان مرور سایت‌های SharePoint.
.IP \[bu] 2
مشابه حالتی که disable_site_permission برابر true تنظیم شده باشد
.RE
.RE
.SS --onedrive-expose-onenote-files
.PP
تنظیم برای نمایش فایل‌های OneNote در فهرست پوشه‌ها.
.PP
به‌طور پیش‌فرض، rclone فایل‌های OneNote را در فهرست پوشه‌ها پنهان می‌کند زیرا عملیاتی مانند \[dq]Open\[dq] و \[dq]Update\[dq] روی آن‌ها کار نمی‌کنند.
اما این رفتار ممکن است مانع از حذف آن‌ها توسط شما نیز بشود.
اگر می‌خواهید فایل‌های OneNote را حذف کنید یا در غیر این صورت تمایل دارید در فهرست پوشه‌ها نمایش داده شوند، این گزینه را تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: expose_onenote_files
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_EXPOSE_ONENOTE_FILES
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --onedrive-server-side-across-configs
.PP
منسوخ شده: به جای آن از --server-side-across-configs استفاده کنید.
.PP
اجازه دادن به عملیات‌های سمت سرور (مانند کپی) برای کارکرد میان پیکربندی‌های مختلف onedrive.
.PP
این ویژگی در صورتی کار خواهد کرد که در حال کپی کردن بین دو درایو OneDrive
\f[I]Personal\f[R] باشید و فایل‌های مورد نظر برای کپی از قبل میان آن‌ها به اشتراک
گذاشته شده باشند.
علاوه بر این، برای کاربری که مجوزهای دسترسی هم بین Onedrive for \f[I]business\f[R] و
\f[I]SharePoint\f[R] تحت \f[I]same tenant\f[R]، و هم بین
\f[I]SharePoint\f[R] و یک \f[I]SharePoint\f[R] دیگر تحت
\f[I]same tenant\f[R] را دارد نیز باید عمل کند.
در سایر موارد، rclone به کپی معمولی بازمی‌گردد (که کمی کندتر خواهد بود).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: server_side_across_configs
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_SERVER_SIDE_ACROSS_CONFIGS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --onedrive-list-chunk
.PP
اندازه تکه‌های فهرست‌گیری.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_chunk
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_LIST_CHUNK
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 1000
.SS --onedrive-no-versions
.PP
حذف همه نسخه‌ها در عملیات‌های تغییر و ویرایش.
.PP
سرویس Onedrive for business زمانی که rclone فایل‌های جدید را با بازنویسی روی فایل موجود بارگذاری می‌کند و هنگامی که زمان ویرایش را تنظیم می‌کند، نسخه‌هایی ایجاد می‌کند.
.PP
این نسخه‌ها فضایی از سهمیه ذخیره‌سازی را اشغال می‌کنند.
.PP
این پرچم پس از بارگذاری فایل و تنظیم زمان ویرایش، نسخه‌ها را بررسی کرده و همه نسخه‌ها به جز آخرین نسخه را حذف می‌کند.
.PP
\f[B]توجه:\f[R] سرویس Onedrive personal در حال حاضر قادر به حذف نسخه‌ها نیست، بنابراین از این پرچم در آنجا استفاده نکنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_versions
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_NO_VERSIONS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --onedrive-hard-delete
.PP
حذف دائمی فایل‌ها هنگام پاک کردن.
.PP
به طور معمول فایل‌ها هنگام حذف به سطل بازیافت فرستاده می‌شوند.
فعال کردن این پرچم باعث حذف دائمی آن‌ها می‌شود.
با احتیاط استفاده کنید.
.PP
حساب‌های شخصی OneDrive از API مربوط به permanentDelete پشتیبانی نمی‌کنند؛ این قابلیت تنها برای کتابخانه‌های اسناد OneDrive for Business و SharePoint اعمال می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hard_delete
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_HARD_DELETE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --onedrive-link-scope
.PP
تعیین دامنه پیوندهای ایجاد شده با دستور link.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: link_scope
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_LINK_SCOPE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]anonymous\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]anonymous\[dq]
.RS 2
.IP \[bu] 2
هر کسی که پیوند را در اختیار داشته باشد، بدون نیاز به ورود دسترسی دارد.
.IP \[bu] 2
این مورد می‌تواند شامل افراد خارج از سازمان شما نیز بشود.
.IP \[bu] 2
پشتیبانی از پیوند ناشناس ممکن است توسط مدیر سیستم غیرفعال شده باشد.
.RE
.IP \[bu] 2
\[dq]organization\[dq]
.RS 2
.IP \[bu] 2
هر کسی که به سازمان (tenant) شما وارد شده باشد می‌تواند از پیوند برای دسترسی استفاده کند.
.IP \[bu] 2
فقط در OneDrive for Business و SharePoint در دسترس است.
.RE
.RE
.SS --onedrive-link-type
.PP
تعیین نوع پیوندهای ایجاد شده با دستور link.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: link_type
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_LINK_TYPE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]view\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]view\[dq]
.RS 2
.IP \[bu] 2
یک پیوند فقط‌خواندنی به مورد ایجاد می‌کند.
.RE
.IP \[bu] 2
\[dq]edit\[dq]
.RS 2
.IP \[bu] 2
یک پیوند خواندن و نوشتن به مورد ایجاد می‌کند.
.RE
.IP \[bu] 2
\[dq]embed\[dq]
.RS 2
.IP \[bu] 2
یک پیوند قابل جاسازی به مورد ایجاد می‌کند.
.RE
.RE
.SS --onedrive-link-password
.PP
تعیین گذرواژه برای پیوندهای ایجاد شده با دستور link.
.PP
در زمان نگارش، این قابلیت فقط با حساب‌های کاربری شخصی و پولیِ OneDrive کار می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: link_password
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_LINK_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --onedrive-hash-type
.PP
تعیین نوع درهم‌سازی (هش) مورد استفاده برای backend.
.PP
این گزینه نوع هش مورد استفاده را مشخص می‌کند.
اگر روی \[dq]auto\[dq] تنظیم شود، از هش پیش‌فرض یعنی
QuickXorHash استفاده خواهد کرد.
.PP
پیش از rclone 1.62، هش SHA1 به‌طور پیش‌فرض برای Onedrive
Personal استفاده می‌شد.
برای 1.62 و جدیدتر، پیش‌فرض استفاده از QuickXorHash برای همه
انواع onedrive است.
اگر هش SHA1 مد نظر است، این گزینه را متناسب با آن تنظیم کنید.
.PP
از ژوئیه ۲۰۲۳، QuickXorHash تنها هش موجود برای هر دو سرویس
OneDrive for Business و OneDrive Personal خواهد بود.
.PP
این مقدار می‌تواند روی \[dq]none\[dq] تنظیم شود تا از هیچ هشی استفاده نشود.
.PP
اگر هش درخواستی روی شیء وجود نداشته باشد، به صورت یک رشته خالی برگردانده
می‌شود که توسط rclone به عنوان یک هش ناموجود در نظر گرفته می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hash_type
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_HASH_TYPE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]auto\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]auto\[dq]
.RS 2
.IP \[bu] 2
انتخاب بهترین هش توسط rclone
.RE
.IP \[bu] 2
\[dq]quickxor\[dq]
.RS 2
.IP \[bu] 2
QuickXor
.RE
.IP \[bu] 2
\[dq]sha1\[dq]
.RS 2
.IP \[bu] 2
SHA1
.RE
.IP \[bu] 2
\[dq]sha256\[dq]
.RS 2
.IP \[bu] 2
SHA256
.RE
.IP \[bu] 2
\[dq]crc32\[dq]
.RS 2
.IP \[bu] 2
CRC32
.RE
.IP \[bu] 2
\[dq]none\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام - عدم استفاده از هیچ هشی
.RE
.RE
.SS --onedrive-av-override
.PP
امکان بارگیری فایل‌هایی را فراهم می‌کند که کارساز (سرور) فکر می‌کند ویروسی هستند.
.PP
سرور onedrive/sharepoint ممکن است فایل‌های بارگذاری‌شده را با یک نرم‌افزار
ضدویروس بررسی کند.
اگر هرگونه ویروس یا بدافزار احتمالی را شناسایی کند، مانع دانلود فایل
خواهد شد.
.PP
در این حالت، پیامی شبیه به این را مشاهده خواهید کرد:
.IP
.nf
\f[C]
server reports this file is infected with a virus - use --onedrive-av-override to download anyway: Infected (name of virus): 403 Forbidden: 
\f[R]
.fi
.PP
اگر ۱۰۰٪ مطمئن هستید که با این حال می‌خواهید این فایل را بارگیری کنید،
از پرچم --onedrive-av-override یا مقدار av_override = true در فایل
پیکربندی استفاده کنید.
.PP
در صورت تنظیم، فایل‌های نشانه‌گذاری‌شده به‌عنوان بدافزار از طریق
Microsoft Graph beta APIs با Prefer: forceInfectedDownload
(ابتدا contentStream و سپس /content) بارگیری می‌شوند.
فایل‌های سالم همچنان از نقطه پایانی (endpoint) پایدار v1.0 استفاده می‌کنند.
.PP
این یک API بتا است و ممکن است تغییر کند.
این قابلیت با مجوزهای برنامه‌ای (client_credentials) به صورت پایدار و قابل اطمینان کار می‌کند.
با ورود تفویض‌شده (کاربر یا delegated) در OneDrive for Business، مایکروسافت اغلب همچنان بارگیری را مسدود می‌کند.
پیکربندی‌های tenant_url به پارامتر پرسمان (query parameter) قدیمی AVOverride پس‌گرد (fallback) می‌کنند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: av_override
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_AV_OVERRIDE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --onedrive-delta
.PP
اگر تنظیم شود، rclone از فهرست‌بندی دلتا برای پیاده‌سازی فهرست‌بندی‌های بازگشتی استفاده خواهد کرد.
.PP
اگر این پرچم تنظیم شود، بک‌اند onedrive پشتیبانی از \f[V]ListR\f[R] را برای فهرست‌بندی‌های بازگشتی اعلان خواهد کرد.
.PP
تنظیم این پرچم سرعت این موارد را به‌شدت افزایش می‌دهد:
.IP
.nf
\f[C]
rclone lsf -R onedrive:
rclone size onedrive:
rclone rc vfs/refresh recursive=true
\f[R]
.fi
.PP
\f[B]با این حال\f[R]، API فهرست‌بندی دلتا \f[B]تنها\f[R] در ریشه درایو کار می‌کند.
اگر از آن در جایی غیر از ریشه استفاده کنید، از ریشه به‌صورت بازگشتی پیمایش کرده و تمام داده‌هایی را که زیر دایرکتوری درخواستی شما نیستند دور می‌ریزد.
بنابراین خروجی صحیح خواهد بود اما ممکن است چندان کارآمد نباشد.
.PP
به همین دلیل است که این پرچم به‌صورت پیش‌فرض تنظیم نشده است.
.PP
به عنوان یک قاعده کلی، اگر تقریباً تمام داده‌های شما زیر دایرکتوری ریشه rclone باشد (یعنی \f[V]root/directory\f[R] در \f[V]onedrive:root/directory\f[R])، استفاده از این پرچم یک جهش بزرگ در کارایی خواهد بود.
اگر بیشتر داده‌های شما زیر ریشه قرار ندارند، استفاده از این پرچم افت شدید کارایی را به همراه خواهد داشت.
.PP
استفاده از آن در صورتی توصیه می‌شود که onedrive خود را در ریشه (یا نزدیک به ریشه هنگام استفاده از crypt) سوار (mount) کرده باشید و از دستور \f[V]rc vfs/refresh\f[R] در rclone استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: delta
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_DELTA
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --onedrive-metadata-permissions
.PP
کنترل این‌که آیا مجوزها در فراداده (metadata) خوانده یا نوشته شوند.
.PP
خواندن فراداده‌های مجوز از فایل‌ها می‌تواند به‌سرعت انجام شود، اما تنظیم مجوزها از روی فراداده همیشه مطلوب نیست.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: metadata_permissions
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_METADATA_PERMISSIONS
.IP \[bu] 2
نوع: Bits
.IP \[bu] 2
پیش‌فرض: off
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]off\[dq]
.RS 2
.IP \[bu] 2
عدم خواندن یا نوشتن مقدار
.RE
.IP \[bu] 2
\[dq]read\[dq]
.RS 2
.IP \[bu] 2
تنها خواندن مقدار
.RE
.IP \[bu] 2
\[dq]write\[dq]
.RS 2
.IP \[bu] 2
تنها نوشتن مقدار
.RE
.IP \[bu] 2
\[dq]read,write\[dq]
.RS 2
.IP \[bu] 2
خواندن و نوشتن مقدار.
.RE
.IP \[bu] 2
\[dq]failok\[dq]
.RS 2
.IP \[bu] 2
در صورت شکست در نوشتن فقط خطاها ثبت شوند، انتقال با شکست مواجه نشود
.RE
.RE.SS --onedrive-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر، بخش کدگذاری را در بررسی اجمالی (<https://rclone.org/overview/#encoding>) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,LeftSpace,LeftTilde,RightSpace,RightPeriod,InvalidUtf8,Dot
.SS --onedrive-description
.PP
توضیحات remote.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_ONEDRIVE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS "متادیتا (Metadata)"
.PP
سرویس OneDrive هم برای فایل‌ها و هم برای دایرکتوری‌ها از System Metadata (نه User Metadata، تا زمان نگارش این مستند) پشتیبانی می‌کند.
بخش زیادی از متادیتا فقط‌خواندنی است، و تفاوت‌هایی بین OneDrive Personal و Business وجود دارد (برای جزئیات به جدول زیر مراجعه کنید).
.PP
همچنین در صورت تنظیم \f[V]--onedrive-metadata-permissions\f[R]، مجوزها نیز پشتیبانی می‌شوند.
مقادیر پذیرفته‌شده برای \f[V]--onedrive-metadata-permissions\f[R] عبارتند از
\[dq]\f[V]read\f[R]\[dq]،‏ \[dq]\f[V]write\f[R]\[dq]،‏
\[dq]\f[V]read,write\f[R]\[dq] و \[dq]\f[V]off\f[R]\[dq] (پیش‌فرض).
مقدار \[dq]\f[V]write\f[R]\[dq] از افزودن مجوزهای جدید، به‌روزرسانی
\[dq]role\[dq] در مجوزهای موجود و حذف مجوزها پشتیبانی می‌کند.
به‌روزرسانی و حذف نیازمند مشخص بودن شناسهٔ مجوز (Permission ID) هستند، بنابراین توصیه می‌شود
در صورتی که مایل به به‌روزرسانی/حذف مجوزها هستید، به جای
\[dq]\f[V]write\f[R]\[dq] از \[dq]\f[V]read,write\f[R]\[dq] استفاده کنید.
.PP
مجوزها در قالب JSON و با استفاده از همان شِمای
OneDrive API (<https://learn.microsoft.com/en-us/onedrive/developer/rest-api/resources/permission?view=odsp-graph-online>)
خوانده/نوشته می‌شوند که تفاوت اندکی بین OneDrive Personal و Business دارد.
.PP
مثال برای OneDrive Personal:
.IP
.nf
\f[C]
[
    {
        \[dq]id\[dq]: \[dq]1234567890ABC!123\[dq],
        \[dq]grantedTo\[dq]: {
            \[dq]user\[dq]: {
                \[dq]id\[dq]: \[dq]ryan\[at]contoso.com\[dq]
            },
            \[dq]application\[dq]: {},
            \[dq]device\[dq]: {}
        },
        \[dq]invitation\[dq]: {
            \[dq]email\[dq]: \[dq]ryan\[at]contoso.com\[dq]
        },
        \[dq]link\[dq]: {
            \[dq]webUrl\[dq]: \[dq]https://1drv.ms/t/s!1234567890ABC\[dq]
        },
        \[dq]roles\[dq]: [
            \[dq]read\[dq]
        ],
        \[dq]shareId\[dq]: \[dq]s!1234567890ABC\[dq]
    }
]
\f[R]
.fi
.PP
مثال برای OneDrive Business:
.IP
.nf
\f[C]
[
    {
        \[dq]id\[dq]: \[dq]48d31887-5fad-4d73-a9f5-3c356e68a038\[dq],
        \[dq]grantedToIdentities\[dq]: [
            {
                \[dq]user\[dq]: {
                    \[dq]displayName\[dq]: \[dq]ryan\[at]contoso.com\[dq]
                },
                \[dq]application\[dq]: {},
                \[dq]device\[dq]: {}
            }
        ],
        \[dq]link\[dq]: {
            \[dq]type\[dq]: \[dq]view\[dq],
            \[dq]scope\[dq]: \[dq]users\[dq],
            \[dq]webUrl\[dq]: \[dq]https://contoso.sharepoint.com/:w:/t/design/a577ghg9hgh737613bmbjf839026561fmzhsr85ng9f3hjck2t5s\[dq]
        },
        \[dq]roles\[dq]: [
            \[dq]read\[dq]
        ],
        \[dq]shareId\[dq]: \[dq]u!LKj1lkdlals90j1nlkascl\[dq]
    },
    {
        \[dq]id\[dq]: \[dq]5D33DD65C6932946\[dq],
        \[dq]grantedTo\[dq]: {
            \[dq]user\[dq]: {
                \[dq]displayName\[dq]: \[dq]John Doe\[dq],
                \[dq]id\[dq]: \[dq]efee1b77-fb3b-4f65-99d6-274c11914d12\[dq]
            },
            \[dq]application\[dq]: {},
            \[dq]device\[dq]: {}
        },
        \[dq]roles\[dq]: [
            \[dq]owner\[dq]
        ],
        \[dq]shareId\[dq]: \[dq]FWxc1lasfdbEAGM5fI7B67aB5ZMPDMmQ11U\[dq]
    }
]
\f[R]
.fi
.PP
برای نوشتن مجوزها، یک کلید متادیتای \[dq]permissions\[dq] را با استفاده از همین قالب ارسال کنید.
ابزار
\f[V]--metadata-mapper\f[R] (<https://rclone.org/docs/#metadata-mapper>)
می‌تواند برای این کار بسیار مفید باشد.
.PP
هنگام افزودن مجوزها، می‌توان یک نشانی ایمیل در مشخصه‌های
\f[V]User.ID\f[R] یا \f[V]DisplayName\f[R] از
\f[V]grantedTo\f[R] یا \f[V]grantedToIdentities\f[R] ارائه داد.
همچنین می‌توان یک ObjectID را در \f[V]User.ID\f[R] ارائه داد.
جهت افزودن مجوز برای یک کاربر، حداقل باید یک گیرندهٔ معتبر ارائه شود.
ایجاد پیوند عمومی (Public Link) نیز در صورتی که \f[V]Link.Scope\f[R] روی
\f[V]\[dq]anonymous\[dq]\f[R] تنظیم شده باشد، پشتیبانی می‌شود.
.PP
نمونه درخواست برای افزودن مجوز \[dq]read\[dq] با استفاده از
\f[V]--metadata-mapper\f[R]:
.IP
.nf
\f[C]
{
    \[dq]Metadata\[dq]: {
        \[dq]permissions\[dq]: \[dq][{\[rs]\[dq]grantedToIdentities\[rs]\[dq]:[{\[rs]\[dq]user\[rs]\[dq]:{\[rs]\[dq]id\[rs]\[dq]:\[rs]\[dq]ryan\[at]contoso.com\[rs]\[dq]}}],\[rs]\[dq]roles\[rs]\[dq]:[\[rs]\[dq]read\[rs]\[dq]]}]\[dq]
    }
}
\f[R]
.fi
.PP
توجه داشته باشید که اگر مجوزی متداخل از قبل برای فایل/پوشه وجود داشته باشد، ممکن است افزودن مجوز با شکست مواجه شود.
.PP
برای به‌روزرسانی یک مجوز موجود، هم شناسهٔ مجوز (Permission ID) و هم
\f[V]roles\f[R] جدید را برای انتساب وارد کنید.
مشخصهٔ \f[V]roles\f[R] تنها ویژگی‌ای است که قابل تغییر است.
.PP
برای حذف مجوزها، یک blob که تنها شامل مجوزهایی است که می‌خواهید نگه دارید ارسال کنید (که می‌تواند برای حذف همه، خالی باشد).
توجه داشته باشید که نقش \f[V]owner\f[R] نادیده گرفته خواهد شد، زیرا قابل حذف نیست.
.PP
توجه داشته باشید که هم خواندن و هم نوشتن مجوزها نیازمند فراخوانی‌های اضافی API است؛
بنابراین اگر نیازی به خواندن یا نوشتن مجوزها ندارید، توصیه می‌شود
از \f[V]--onedrive-metadata-permissions\f[R] صرف‌نظر کنید.
.PP
متادیتا و مجوزها هم برای پوشه‌ها (دایرکتوری‌ها) و هم برای فایل‌ها پشتیبانی می‌شوند.
توجه داشته باشید که تنظیم \f[V]mtime\f[R] یا \f[V]btime\f[R] روی یک پوشه، تنها در OneDrive Business نیازمند یک فراخوانی اضافی API است.
.PP
سرویس OneDrive در حال حاضر از User Metadata پشتیبانی نمی‌کند.
هنگام نوشتن متادیتا، تنها مشخصه‌های سیستمیِ قابل‌نوشتن اعمال خواهند شد
\-\- هرگونه کلیدِ فقط‌خواندنی یا ناشناخته ارسال شود، نادیده گرفته خواهد شد..PP
نکته: برای مشاهده متادیتا و مجوزهای هر فایل یا پوشه، اجرا کنید:
.IP
.nf
\f[C]
rclone lsjson remote:path --stat -M --onedrive-metadata-permissions read
\f[R]
.fi
.PP
در ادامه موارد ممکن متادیتای سیستم برای backend مربوط به onedrive آورده شده است.
.PP
.TS
tab(@);
lw(11.1n) lw(11.1n) lw(11.1n) lw(16.6n) lw(20.3n).
T{
نام
T}@T{
راهنما
T}@T{
نوع
T}@T{
مثال
T}@T{
فقط‌خواندنی
T}
_
T{
btime
T}@T{
زمان ایجاد فایل (birth) با دقت ثانیه (میلی‌ثانیه برای OneDrive
Personal).
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05Z
T}@T{
خیر
T}
T{
content-type
T}@T{
نوع MIME فایل.
T}@T{
string
T}@T{
text/plain
T}@T{
\f[B]بله\f[R]
T}
T{
created-by-display-name
T}@T{
نام نمایشی کاربری که مورد را ایجاد کرده است.
T}@T{
string
T}@T{
John Doe
T}@T{
\f[B]بله\f[R]
T}
T{
created-by-id
T}@T{
شناسه (ID) کاربری که مورد را ایجاد کرده است.
T}@T{
string
T}@T{
48d31887-5fad-4d73-a9f5-3c356e68a038
T}@T{
\f[B]بله\f[R]
T}
T{
description
T}@T{
توضیح کوتاهی درباره فایل.
حداکثر ۱۰۲۴ نویسه.
دیگر توسط Microsoft پشتیبانی نمی‌شود.
T}@T{
string
T}@T{
Contract for signing
T}@T{
خیر
T}
T{
id
T}@T{
شناسه یکتای مورد درون OneDrive.
T}@T{
string
T}@T{
01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K
T}@T{
\f[B]بله\f[R]
T}
T{
last-modified-by-display-name
T}@T{
نام نمایشی کاربری که آخرین بار مورد را تغییر داده است.
T}@T{
string
T}@T{
John Doe
T}@T{
\f[B]بله\f[R]
T}
T{
last-modified-by-id
T}@T{
شناسه (ID) کاربری که آخرین بار مورد را تغییر داده است.
T}@T{
string
T}@T{
48d31887-5fad-4d73-a9f5-3c356e68a038
T}@T{
\f[B]بله\f[R]
T}
T{
malware-detected
T}@T{
اینکه آیا OneDrive وجود بدافزار در این مورد را تشخیص داده است یا خیر.
T}@T{
boolean
T}@T{
true
T}@T{
\f[B]بله\f[R]
T}
T{
mtime
T}@T{
زمان آخرین تغییر با دقت ثانیه (میلی‌ثانیه برای OneDrive Personal).
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05Z
T}@T{
خیر
T}
T{
package-type
T}@T{
در صورت وجود، نشان می‌دهد که این مورد به‌جای یک پوشه یا فایل، یک بسته (package) است.
با بسته‌ها در برخی زمینه‌ها مانند فایل و در برخی دیگر مانند پوشه رفتار می‌شود.
T}@T{
string
T}@T{
oneNote
T}@T{
\f[B]بله\f[R]
T}
T{
permissions
T}@T{
مجوزها در یک dump به قالب JSON از ساختار OneDrive.
فعال‌سازی با --onedrive-metadata-permissions.
ویژگی‌ها: id، grantedTo، grantedToIdentities، invitation،
inheritedFrom، link، roles، shareId
T}@T{
JSON
T}@T{
{}
T}@T{
خیر
T}
T{
shared-by-id
T}@T{
شناسه (ID) کاربری که مورد را به اشتراک گذاشته است (در صورت به‌اشتراک‌گذاری).
T}@T{
string
T}@T{
48d31887-5fad-4d73-a9f5-3c356e68a038
T}@T{
\f[B]بله\f[R]
T}
T{
shared-owner-id
T}@T{
شناسه (ID) مالک مورد به‌اشتراک‌گذاشته‌شده (در صورت به‌اشتراک‌گذاری).
T}@T{
string
T}@T{
48d31887-5fad-4d73-a9f5-3c356e68a038
T}@T{
\f[B]بله\f[R]
T}
T{
shared-scope
T}@T{
در صورت به‌اشتراک‌گذاری، دامنه نحوه به‌اشتراک‌گذاری مورد را مشخص می‌کند: anonymous،
organization، یا users.
T}@T{
string
T}@T{
users
T}@T{
\f[B]بله\f[R]
T}
T{
shared-time
T}@T{
زمان به‌اشتراک‌گذاری مورد، با دقت ثانیه (میلی‌ثانیه برای OneDrive
Personal).
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05Z
T}@T{
\f[B]بله\f[R]
T}
T{
utime
T}@T{
زمان بارگذاری با دقت ثانیه (میلی‌ثانیه برای OneDrive Personal).
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05Z
T}@T{
\f[B]بله\f[R]
T}
.TE.PP
برای اطلاعات بیشتر، مستندات متادیتا (https://rclone.org/docs/#metadata) را ببینید.
.SS جعل هویت سایر کاربران به عنوان مدیر
.PP
برخلاف Google Drive و جعل هویت هر کاربر دامنه از طریق حساب‌های کاربری خدماتی (service accounts)، در OneDrive لازم است به عنوان یک حساب کاربری مدیر (admin) احراز هویت کرده و به صورت دستی برای هر کاربری که می‌خواهید هویتش را جعل کنید، یک ریموت راه‌اندازی نمایید.
.IP "1." 3
در Microsoft 365 Admin Center (https://admin.microsoft.com)، هر کاربری را که نیاز به \[dq]جعل هویت\[dq] او دارید باز کرده و به بخش OneDrive بروید.
سرتیتری با عنوان \[dq]Get access to files\[dq] وجود دارد که باید برای ایجاد پیوند روی آن کلیک کنید؛ این کار پیوندی با قالب
\f[V]https://{tenant}-my.sharepoint.com/personal/{user_name_domain_tld}\f[R]
ایجاد می‌کند و همچنین مجوزها را به‌گونه‌ای تغییر می‌دهد که کاربر مدیر شما به آن دسترسی داشته باشد.
.IP "2." 3
سپس در powershell دستورات زیر را اجرا کنید:
.RS 4
.IP
.nf
\f[C]
Install-Module Microsoft.Graph -Scope CurrentUser -Repository PSGallery -Force
Import-Module Microsoft.Graph.Files
Connect-MgGraph -Scopes \[dq]Files.ReadWrite.All\[dq]
# Follow the steps to allow access to your admin user
# Then run this for each user you want to impersonate to get the Drive ID
Get-MgUserDefaultDrive -UserId \[aq]{emailaddress}\[aq]
# This will give you output of the format:
# Name     Id                                                                 DriveType CreatedDateTime
# ----     --                                                                 --------- ---------------
# OneDrive b!XYZ123                                                           business  14/10/2023    1:00:58 pm
\f[R]
.fi
.RE
.IP "3." 3
سپس در rclone یک ریموت از نوع onedrive اضافه کنید و از گزینه
\f[V]Type in driveID\f[R] با DriveID به‌دست‌آمده از مرحله قبل استفاده نمایید.
برای هر کاربر یک ریموت.
سپس شناسه درایو تأیید می‌شود و در حالت ایده‌آل پیامی مانند
\f[V]Found drive \[dq]root\[dq] of type \[dq]business\[dq]\f[R] دریافت خواهید کرد که
شامل نشانی وب (URL) با قالب زیر خواهد بود:
\f[V]https://{tenant}-my.sharepoint.com/personal/{user_name_domain_tld}/Documents\f[R]
.SS محدودیت‌ها
.PP
اگر به مدت ۹۰ روز از rclone استفاده نکنید، توکن نوسازی (refresh token) منقضی خواهد شد.
این امر موجب بروز مشکلاتی در احراز هویت می‌شود.
رفع این مورد با اجرای دستور
\f[V]rclone config reconnect remote:\f[R]
برای دریافت توکن و توکن نوسازی جدید، بسیار آسان است.
.SS نام‌گذاری
.PP
توجه داشته باشید که OneDrive به بزرگی و کوچکی حروف حساس نیست (case insensitive)، بنابراین نمی‌توانید هم‌زمان فایلی با نام \[dq]Hello.doc\[dq] و فایلی با نام \[dq]hello.doc\[dq] داشته باشید.
.PP
تعداد زیادی نویسه وجود دارد که نمی‌توانند در نام فایل‌های OneDrive حضور داشته باشند.
این نویسه‌ها در پلتفرم‌های ویندوز مجاز نیستند، اما در پلتفرم‌های غیرویندوزی رایج می‌باشند.
نرم‌افزار Rclone این نام‌ها را به معادل یونیکد با ظاهر یکسان (و بالعکس) نگاشت خواهد کرد.
برای نمونه، اگر فایلی شامل \f[V]?\f[R] باشد، در عوض به
\f[V]？\f[R] نگاشت می‌شود.
.SS اندازه‌های فایل
.PP
حداکثر اندازه مجاز فایل هم برای OneDrive Personal و هم برای OneDrive for Business برابر با ۲۵۰ گیبی‌بایت (250 GiB) است (به‌روزشده در ۱۳ ژانویه ۲۰۲۱) (https://support.microsoft.com/en-us/office/invalid-file-names-and-file-types-in-onedrive-and-sharepoint-64883a5d-228e-48f5-b3d2-eb39e07630fa?ui=en-us&rs=en-us&ad=us#individualfilesize).
.SS طول مسیر
.PP
کل مسیر، از جمله نام فایل، برای OneDrive ،OneDrive for Business و SharePoint Online باید کمتر از ۴۰۰ نویسه باشد.
اگر با استفاده از rclone نام فایل‌ها و پوشه‌ها را رمزگذاری می‌کنید، ممکن است بخواهید به این محدودیت توجه داشته باشید زیرا نام‌های رمزگذاری‌شده معمولاً طولانی‌تر از نام‌های اصلی هستند.
.SS تعداد فایل‌ها
.PP
به نظر می‌رسد OneDrive با حداقل ۵۰٬۰۰۰ فایل در یک پوشه مشکلی ندارد، اما در ۱۰۰٬۰۰۰ فایل rclone هنگام فهرست کردن محتویات دایرکتوری با خطاهایی مانند
\f[V]couldn\[cq]t list files: UnknownError:\f[R]
مواجه خواهد شد.
برای اطلاعات بیشتر شماره ۲۷۰۷# (https://github.com/rclone/rclone/issues/2707) را ببینید.
.PP
یک سند رسمی درباره محدودیت‌های انواع مختلف OneDrive را می‌توان در
اینجا (https://support.office.com/en-us/article/invalid-file-names-and-file-types-in-onedrive-onedrive-for-business-and-sharepoint-64883a5d-228e-48f5-b3d2-eb39e07630fa)
یافت..SS "نسخه‌ها (Versions)"
.PP
هر تغییری در یک فایل در OneDrive باعث می‌شود این سرویس نسخه جدیدی از فایل را ایجاد کند.
این موضوع جزو سهمیه مصرفی کاربر محاسبه می‌شود.
به‌عنوان مثال، تغییر زمان ویرایش (modification time) یک فایل باعث ایجاد نسخه دومی می‌شود، بنابراین به نظر می‌رسد فایل دو برابر فضا مصرف می‌کند.
.PP
به‌عنوان مثال دستور \f[V]copy\f[R] تحت تأثیر این مسئله قرار می‌گیرد، زیرا rclone ابتدا فایل را کپی می‌کند و سپس زمان ویرایش آن را مطابق با فایل مبدأ تنظیم می‌نماید که این امر نسخه دیگری را مصرف می‌کند.
.PP
می‌توانید از دستور \f[V]rclone cleanup\f[R] (به پایین مراجعه کنید) برای حذف همه نسخه‌های قدیمی استفاده کنید.
.PP
یا می‌توانید پارامتر \f[V]no_versions\f[R] را روی \f[V]true\f[R] تنظیم کنید و rclone نسخه‌ها را پس از عملیاتی که نسخه‌های جدید ایجاد می‌کنند، حذف خواهد کرد.
این کار نیازمند تراکنش‌های اضافی است، بنابراین فقط در صورت نیاز آن را فعال کنید.
.PP
\f[B]نکته\f[R] در زمان نگارش این مستند، Onedrive Personal نسخه‌ها را ایجاد می‌کند (اما نه برای تنظیم زمان ویرایش)، ولی API مربوط به حذف آن‌ها خطای \[dq]API not found\[dq] را برمی‌گرداند؛ بنابراین cleanup و \f[V]no_versions\f[R] نباید در Onedrive Personal استفاده شوند.
.SS "غیرفعال‌سازی نسخه‌بندی (Disabling versioning)"
.PP
از اکتبر ۲۰۱۸ به بعد، کاربران دیگر به‌طور پیش‌فرض قادر به غیرفعال‌سازی نسخه‌بندی نخواهند بود.
دلیل این امر این است که مایکروسافت یک به‌روزرسانی (https://techcommunity.microsoft.com/t5/Microsoft-OneDrive-Blog/New-Updates-to-OneDrive-and-SharePoint-Team-Site-Versioning/ba-p/204390) در این سازوکار اعمال کرده است.
برای تغییر این تنظیم پیش‌فرض جدید، اجرای یک دستور PowerShell توسط مدیر (admin) سامانه SharePoint الزامی است.
اگر مدیر سیستم هستید، می‌توانید این دستورها را در PowerShell اجرا کنید تا آن تنظیم را تغییر دهید:
.IP "1." 3
\f[V]Install-Module -Name Microsoft.Online.SharePoint.PowerShell\f[R]
(در صورتی که قبلاً آن را نصب نکرده‌اید)
.IP "2." 3
\f[V]Import-Module Microsoft.Online.SharePoint.PowerShell -DisableNameChecking\f[R]
.IP "3." 3
\f[V]Connect-SPOService -Url https://YOURSITE-admin.sharepoint.com -Credential YOU\[at]YOURSITE.COM\f[R]
(جایگزین کردن \f[V]YOURSITE\f[R]، \f[V]YOU\f[R] و \f[V]YOURSITE.COM\f[R] با مقادیر واقعی؛ با این کار اطلاعات ورود شما پرسیده خواهد شد)
.IP "4." 3
\f[V]Set-SPOTenant -EnableMinimumVersionRequirement $False\f[R]
.IP "5." 3
\f[V]Disconnect-SPOService\f[R] (جهت قطع اتصال از سرور)
.PP
\f[I]در زیر مراحل غیرفعال‌سازی نسخه‌بندی برای کاربران عادی آمده است.
اگر گزینه \[dq]No Versioning\[dq] را مشاهده نمی‌کنید، مطمئن شوید که پیش‌نیازهای بالا برآورده شده باشند.\f[R]
.PP
کاربر Weropol (https://github.com/Weropol) روشی برای غیرفعال کردن نسخه‌بندی در OneDrive پیدا کرده است.
.IP "1." 3
با کلیک کردن روی نماد چرخ‌دنده در بالای صفحه OneDrive Business، منوی تنظیمات را باز کنید.
.IP "2." 3
روی Site settings کلیک کنید.
.IP "3." 3
پس از ورود به صفحه Site settings، به مسیر Site Administration > Site libraries and lists بروید.
.IP "4." 3
روی Customize \[dq]Documents\[dq] کلیک کنید.
.IP "5." 3
روی General Settings > Versioning Settings کلیک کنید.
.IP "6." 3
در بخش Document Version History، گزینه No versioning را انتخاب کنید.
نکته: این کار ایجاد نسخه‌های جدید فایل را غیرفعال می‌کند، اما هیچ‌یک از نسخه‌های قبلی را حذف نخواهد کرد.
اسناد شما در امان هستند.
.IP "7." 3
با کلیک روی OK، تغییرات را اعمال کنید.
.IP "8." 3
از rclone برای بارگذاری یا تغییر فایل‌ها استفاده کنید.
(من همچنین از پرچم \-\-no\-update\-modtime استفاده می‌کنم)
.IP "9." 3
پس از استفاده از rclone، تنظیمات نسخه‌بندی را بازگردانی کنید.
(اختیاری)
.SS "پاک‌سازی (Cleanup)"
.PP
سرویس OneDrive از دستور \f[V]rclone cleanup\f[R] پشتیبانی می‌کند که باعث می‌شود rclone تمام فایل‌های موجود در مسیر ارائه‌شده را بررسی کرده و تمام نسخه‌ها به‌جز نسخه فعلی را حذف نماید.
از آنجا که این کار مستلزم پیمایش تمام فایل‌ها و سپس پرس‌وجو از هر فایل برای یافتن نسخه‌ها است، می‌تواند بسیار کند باشد.
برنامه rclone بررسی‌ها را به‌صورت موازی به تعداد \f[V]--checkers\f[R] انجام می‌دهد.
این دستور همچنین از \f[V]--interactive\f[R]/\f[V]i\f[R] یا \f[V]--dry-run\f[R] پشتیبانی می‌کند که روشی عالی برای مشاهده کارهایی است که انجام خواهد شد.
.IP
.nf
\f[C]
rclone cleanup --interactive remote:path/subdir # interactively remove all old version for path/subdir
rclone cleanup remote:path/subdir               # unconditionally remove all old version for path/subdir
\f[R]
.fi
.PP
\f[B]نکته مهم\f[R] در حال حاضر Onedrive personal قادر به حذف نسخه‌ها نیست..SS عیب‌یابی (Troubleshooting)
.SS محدودسازی شدید یا مسدود شدن در SharePoint
.PP
اگر با محدودسازی شدید نرخ درخواست‌ها (throttling) مواجه شدید یا در SharePoint مسدود شده‌اید،
ممکن است تنظیم صریح عامل کاربر (user agent) با پرچمی شبیه به این به رفع مشکل کمک کند:
\f[V]--user-agent \[dq]ISV|rclone.org|rclone/v1.55.1\[dq]\f[R]
.PP
جزئیات دقیق را می‌توانید در مستندات مایکروسافت بیابید: Avoid
getting throttled or blocked in SharePoint
Online (https://docs.microsoft.com/en-us/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online#how-to-decorate-your-http-traffic-to-avoid-throttling)
.SS تفاوت‌های غیرمنتظره در اندازه/هش فایل در Sharepoint
.PP
این یک مشکل
شناخته‌شده (https://github.com/OneDrive/onedrive-api-docs/issues/935#issuecomment-441741631)
است که Sharepoint (نه OneDrive یا OneDrive for Business) فایل‌های بارگذاری‌شده،
به‌ویژه فایل‌های Office (.docx، .xlsx و غیره) را بدون اطلاع تغییر می‌دهد که
باعث شکست در بررسی‌های اندازه فایل و هش (hash) می‌شود.
همچنین شرایط دیگری نیز وجود دارد که باعث می‌شود OneDrive اندازه‌های فایل ناسازگاری را گزارش کند.
برای استفاده از rclone با چنین فایل‌های تحت‌تأثیری در Sharepoint، می‌توانید
این بررسی‌ها را با آرگومان‌های خط فرمان زیر غیرفعال کنید:
.IP
.nf
\f[C]
--ignore-checksum --ignore-size
\f[R]
.fi
.PP
روش دیگر، در صورتی که دسترسی نوشتن به فایل‌های OneDrive دارید، ممکن است
بتوانید با انجام مراحل زیر این مشکل را برای برخی فایل‌ها برطرف کنید.
رابط تحت وب OneDrive (https://onedrive.live.com) را باز کرده و فایل‌های
تحت‌تأثیر را پیدا کنید (که در پیام‌های خطا/لاگ rclone مشخص خواهند بود).
تنها کافی است روی هر یک از این فایل‌ها کلیک کنید تا OneDrive آن‌ها را در وب باز کند.
این کار باعث می‌شود هر فایل در جای خود به قالبی تبدیل شود که از نظر عملکردی معادل است
اما دیگر مغایرت اندازه ایجاد نمی‌کند.
پس از تبدیل تمام فایل‌های مشکل‌دار، دیگر به گزینه‌های نادیده‌گیری بالا نیازی نخواهید داشت.
.SS دریافت خطای \[dq]item not found\[dq] هنگام جایگزینی/حذف فایل‌های موجود در Sharepoint
.PP
این یک مشکل
شناخته‌شده (https://github.com/OneDrive/onedrive-api-docs/issues/1068) است
که Sharepoint (نه OneDrive یا OneDrive for Business) ممکن است هنگام تلاش کاربران
برای جایگزینی یا حذف فایل‌های بارگذاری‌شده، خطای \[dq]item not found\[dq] بازگرداند؛
به نظر می‌رسد این مشکل عمدتاً فایل‌های Office (.docx، .xlsx و غیره)
و فایل‌های وب (.html، .aspx و غیره) را تحت تأثیر قرار می‌دهد.
به عنوان یک راهکار موقت، می‌توانید از آرگومان خط فرمان \f[V]--backup-dir <BACKUP_DIR>\f[R]
استفاده کنید تا rclone فایل‌های در حال جایگزینی/حذف را به یک دایرکتوری پشتیبان مشخص
منتقل کند (به جای جایگزینی/حذف مستقیم آن‌ها).
برای مثال، جهت هدایت rclone برای انتقال فایل‌ها به پوشه
\f[V]rclone-backup-dir\f[R] در بک‌اند \f[V]mysharepoint\f[R]، می‌توانید
از این گزینه استفاده کنید:
.IP
.nf
\f[C]
--backup-dir mysharepoint:rclone-backup-dir
\f[R]
.fi
.SS access_denied (AADSTS65005)
.IP
.nf
\f[C]
Error: access_denied
Code: AADSTS65005
Description: Using application \[aq]rclone\[aq] is currently not supported for your organization [YOUR_ORGANIZATION] because it is in an unmanaged state. An administrator needs to claim ownership of the company by DNS validation of [YOUR_ORGANIZATION] before the application rclone can be provisioned.
\f[R]
.fi
.PP
این بدان معناست که rclone نمی‌تواند از API مربوط به OneDrive for Business با حساب
شما استفاده کند.
شما نمی‌توانید کار زیادی در این رابطه انجام دهید، شاید بهتر باشد به مدیران سیستم خود ایمیل بفرستید.
.PP
با این حال، روش‌های دیگری نیز برای تعامل با حساب OneDrive شما وجود دارد.
نگاهی به بک‌اند WebDAV بیندازید:
<https://rclone.org/webdav/#sharepoint>
.SS invalid_grant (AADSTS50076)
.IP
.nf
\f[C]
Error: invalid_grant
Code: AADSTS50076
Description: Due to a configuration change made by your administrator, or because you moved to a new location, you must use multi-factor authentication to access \[aq]...\[aq].
\f[R]
.fi
.PP
اگر پس از فعال‌سازی احراز هویت چندعاملی (multi-factor authentication)
برای حساب خود خطای بالا را مشاهده کردید، می‌توانید با نوسازی توکن تازه‌سازی OAuth خود آن را برطرف کنید.
برای این کار، \f[V]rclone config\f[R] را اجرا کرده و گزینه ویرایش بک‌اند
OneDrive خود را انتخاب کنید.
سپس، نیازی به اعمال هیچ تغییری ندارید تا زمانی که به این سؤال برسید:
\f[V]Token already configured - replace it?\f[R].
در پاسخ به این سؤال، \f[V]y\f[R] را انتخاب کرده و مراحل را برای تازه‌سازی
توکن خود دنبال کنید، دقیقاً مانند اولین باری که بک‌اند پیکربندی شد.
پس از این مرحله، rclone باید دوباره برای این بک‌اند کار کند..SS خطای Invalid request هنگام ایجاد پیوندهای همگانی
.PP
در Sharepoint و OneDrive for Business، ممکن است \f[V]rclone link\f[R]
خطای \[dq]Invalid request\[dq] را برگرداند.
یک دلیل احتمالی این است که مدیر سازمان اجازه ایجاد پیوندهای همگانی
را برای سازمان/کتابخانه Sharepoint نداده است.
برای اصلاح مجوزها به عنوان یک مدیر سیستم، به این مستندات نگاهی بیندازید:
1 (https://docs.microsoft.com/en-us/sharepoint/turn-external-sharing-on-or-off)،
2 (https://support.microsoft.com/en-us/office/set-up-and-manage-access-requests-94b26e0b-2822-49d4-929a-8455698654b3).
.SS عدم امکان دسترسی به فایل‌های \f[V]Shared\f[R] with me
.PP
فایل‌های Shared with me در حال حاضر توسط rclone پشتیبانی
نمی‌شوند (https://github.com/rclone/rclone/issues/4062)، اما یک
راهکار موقت وجود دارد:
.IP "1." 3
به https://onedrive.live.com مراجعه کنید (https://onedrive.live.com)
.IP "2." 3
روی یک مورد در \f[V]Shared\f[R] راست‌کلیک کرده و سپس
روی \f[V]Add shortcut to My files\f[R] در منوی زمینه کلیک کنید
[IMAGE: make_shortcut (https://user-images.githubusercontent.com/60313789/206118040-7e762b3b-aa61-41a1-8649-cc18889f3572.png)]
.IP "3." 3
میانبر در \f[V]My files\f[R] ظاهر خواهد شد؛ می‌توانید با
rclone به آن دسترسی داشته باشید، و مانند یک پوشه/فایل معمولی رفتار خواهد کرد.
[IMAGE: in_my_files (https://i.imgur.com/0S8H3li.png)]
[IMAGE: rclone_mount (https://i.imgur.com/2Iq66sW.png)]
.SS تصاویر Live Photos بارگذاری‌شده از iOS (کلیپ‌های ویدیویی کوتاه در فایل‌های .heic)
.PP
برنامه iOS مربوط به OneDrive قابلیت بارگذاری و
ذخیره‌سازی (https://techcommunity.microsoft.com/t5/microsoft-onedrive-blog/live-photos-come-to-onedrive/ba-p/1953452)
تصاویر Live Photos (https://support.apple.com/en-gb/HT207310) را در سال ۲۰۲۰ معرفی کرد.
استفاده و بارگیری این Live Photoهای بارگذاری‌شده متأسفانه
هنوز در دست تکمیل است و هنگام کپی کردن،
همگام‌سازی و متصل کردن (mount) \[en] چه در rclone و چه در کلاینت بومی
OneDrive در Windows \[en] چندین مشکل ایجاد می‌کند.
.PP
اگر یکی از Live Photoهای خود را در رابط وب OneDrive پیدا کنید،
علت ریشه‌ای به‌راحتی قابل مشاهده است.
سپس عکس را از رابط وب بارگیری کنید.
خواهید دید که اندازه فایل .heic بارگیری‌شده از
اندازه نمایش‌داده‌شده در رابط وب کوچک‌تر است.
فایل بارگیری‌شده به این دلیل کوچک‌تر است که فقط حاوی یک تک‌فریم
(عکس ثابت) استخراج‌شده از Live Photo (ویدیو) ذخیره‌شده در OneDrive است.
.PP
این تفاوت اندازه باعث می‌شود \f[V]rclone copy/sync\f[R] مکرراً
عکس‌های تغییرنیافته را چیزی شبیه به این دوباره کپی کند:
.IP
.nf
\f[C]
DEBUG : 20230203_123826234_iOS.heic: Sizes differ (src 4470314 vs dst 1298667)
DEBUG : 20230203_123826234_iOS.heic: sha1 = fc2edde7863b7a7c93ca6771498ac797f8460750 OK
INFO  : 20230203_123826234_iOS.heic: Copied (replaced existing)
\f[R]
.fi
.PP
این کپی‌های مجدد را می‌توان با افزودن \f[V]--ignore-size\f[R] دور زد.
لطفاً توجه داشته باشید که این راهکار فقط تصویر ثابت را همگام می‌کند نه
کلیپ ویدیویی را، و متکی به این است که تاریخ‌های اصلاح بر روی
تمامی فایل‌ها در همه شرایط به‌درستی به‌روزرسانی شوند.
.PP
این تفاوت در اندازه همچنین باعث می‌شود \f[V]rclone check\f[R]
خطاهای اندازه را چیزی شبیه به این گزارش دهد:
.IP
.nf
\f[C]
ERROR : 20230203_123826234_iOS.heic: sizes differ
\f[R]
.fi
.PP
این خطاهای بررسی را می‌توان با افزودن \f[V]--ignore-size\f[R] نادیده گرفت.
.PP
این تفاوت اندازه همچنین باعث می‌شود بارگیری در \f[V]rclone mount\f[R]
با خطایی شبیه به این با شکست مواجه شود:
.IP
.nf
\f[C]
ERROR : 20230203_123826234_iOS.heic: ReadFileHandle.Read error: low level retry 1/10: unexpected EOF
\f[R]
.fi
.PP
یا شبیه به این هنگام استفاده از \f[V]--cache-mode=full\f[R]:
.IP
.nf
\f[C]
INFO  : 20230203_123826234_iOS.heic: vfs cache: downloader: error count now 1: vfs reader: failed to write to cache file: 416 Requested Range Not Satisfiable:
ERROR : 20230203_123826234_iOS.heic: vfs cache: failed to download: vfs reader: failed to write to cache file: 416 Requested Range Not Satisfiable:
\f[R]
.fi.SH OpenDrive
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند به هر میزان که لازم باشد دارای عمق باشند؛ مانند:
\f[V]remote:directory/subdirectory\f[R].
.SS "پیکربندی (Configuration)"
.PP
در اینجا مثالی از نحوهٔ ایجاد یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این فرمان شما را در یک فرآیند پیکربندی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
n) New remote
d) Delete remote
q) Quit config
e/n/d/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / OpenDrive
   \[rs] \[dq]opendrive\[dq]
[snip]
Storage> opendrive
Username
username>
Password
y) Yes type in my own password
g) Generate random password
y/g> y
Enter the password:
password:
Confirm the password:
password:
Configuration complete.
Options:
- type: opendrive
- username:
- password: *** ENCRYPTED ***
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح OpenDrive شما:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در OpenDrive شما:
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به یک دایرکتوری در OpenDrive به نام backup:
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi
.SS "زمان‌های تغییر و هش‌ها (Modification times and hashes)"
.PP
سرویس OpenDrive امکان تنظیم زمان‌های تغییر (modification times) را روی اشیاء با دقت ۱ ثانیه فراهم می‌کند.
این اطلاعات برای تشخیص اینکه آیا اشیاء نیاز به همگام‌سازی دارند یا خیر به کار می‌روند.
.PP
الگوریتم هش MD5 پشتیبانی می‌شود..SS نویسه‌های محدودشده در نام فایل
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
NUL
T}@T{
0x00
T}@T{
␀
T}
T{
/
T}@T{
0x2F
T}@T{
／
T}
T{
\[dq]
T}@T{
0x22
T}@T{
＂
T}
T{
*
T}@T{
0x2A
T}@T{
＊
T}
T{
:
T}@T{
0x3A
T}@T{
：
T}
T{
<
T}@T{
0x3C
T}@T{
＜
T}
T{
>
T}@T{
0x3E
T}@T{
＞
T}
T{
?
T}@T{
0x3F
T}@T{
؟
T}
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
T{
|
T}@T{
0x7C
T}@T{
｜
T}
.TE
.PP
نام‌های فایل همچنین نمی‌توانند با نویسه‌های زیر آغاز شوند یا پایان یابند.
این نویسه‌ها تنها در صورتی جایگزین می‌شوند که نخستین یا واپسین نویسه در
نام باشند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
SP
T}@T{
0x20
T}@T{
␠
T}
T{
HT
T}@T{
0x09
T}@T{
␉
T}
T{
LF
T}@T{
0x0A
T}@T{
␊
T}
T{
VT
T}@T{
0x0B
T}@T{
␋
T}
T{
CR
T}@T{
0x0D
T}@T{
␍
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند شد
(https://rclone.org/overview/#invalid-utf8)، چرا که نمی‌توان
از آن‌ها در رشته‌های JSON استفاده کرد..SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص opendrive (OpenDrive) آمده است.
.SS --opendrive-username
.PP
نام کاربری.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: username
.IP \[bu] 2
متغیر محیطی: RCLONE_OPENDRIVE_USERNAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --opendrive-password
.PP
گذرواژه.
.PP
\f[B]توجه:\f[R] ورودی این گزینه باید مبهم‌سازی شده باشد \- دستور rclone obscure (<https://rclone.org/commands/rclone_obscure>) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: password
.IP \[bu] 2
متغیر محیطی: RCLONE_OPENDRIVE_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مختص opendrive (OpenDrive) آمده است.
.SS --opendrive-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر، بخش کدگذاری در بررسی کلی (<https://rclone.org/overview/#encoding>) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_OPENDRIVE_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,LeftSpace,LeftCrLfHtVt,RightSpace,RightCrLfHtVt,InvalidUtf8,Dot
.SS --opendrive-chunk-size
.PP
فایل‌ها در تکه‌هایی با این اندازه بارگذاری خواهند شد.
.PP
توجه داشته باشید که این تکه‌ها در حافظه بافر می‌شوند، بنابراین افزایش دادن اندازه آن‌ها مصرف حافظه را بیشتر خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_OPENDRIVE_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 10Mi
.SS --opendrive-access
.PP
فایل‌ها و پوشه‌ها با این سطح مجوز دسترسی بارگذاری خواهند شد (پیش‌فرض
private)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: access
.IP \[bu] 2
متغیر محیطی: RCLONE_OPENDRIVE_ACCESS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]private\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]private\[dq]
.RS 2
.IP \[bu] 2
دسترسی فایل یا پوشه می‌تواند به‌گونه‌ای اعطا شود که به کاربران منتخب امکان مشاهده، خواندن یا نوشتن مواردی که برای آن‌ها کاملاً ضروری است را بدهد.
.RE
.IP \[bu] 2
\[dq]public\[dq]
.RS 2
.IP \[bu] 2
فایل یا پوشه می‌تواند توسط هر کسی از طریق یک مرورگر وب بارگیری شود.
پیوند را می‌توان به هر روشی به اشتراک گذاشت،
.RE
.IP \[bu] 2
\[dq]hidden\[dq]
.RS 2
.IP \[bu] 2
دسترسی به فایل یا پوشه دارای همان محدودیت‌های Public است، به شرطی که کاربر نشانی اینترنتی (URL) پیوند فایل یا پوشه را برای دسترسی به محتویات بداند.
.RE
.RE.SS --opendrive-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_OPENDRIVE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS "محدودیت‌ها (Limitations)"
.PP
توجه داشته باشید که OpenDrive به حروف کوچک و بزرگ حساس نیست (case-insensitive)، بنابراین نمی‌توانید هم‌زمان فایلی به نام \[dq]Hello.doc\[dq] و فایلی با نام \[dq]hello.doc\[dq] داشته باشید.
.PP
کاراکترهای متعددی وجود دارند که نمی‌توانند در نام فایل‌های OpenDrive قرار گیرند.
این کاراکترها در پلتفرم‌های Windows مجاز نیستند، اما در پلتفرم‌های غیر Windows رایج هستند.
ابزار Rclone این نام‌ها را به معادل‌های یونیکد با ظاهر یکسان و بالعکس نگاشت (map) می‌کند.
به عنوان مثال، اگر فایلی شامل \f[V]?\f[R] باشد، به جای آن به \f[V]？\f[R] نگاشت خواهد شد.
.PP
دستور \f[V]rclone about\f[R] توسط بک‌اند OpenDrive پشتیبانی نمی‌شود.
بک‌اندهایی که فاقد این قابلیت هستند نمی‌توانند فضای خالی را برای اتصال (mount) در rclone تعیین کنند یا از خط‌مشی \f[V]mfs\f[R] (بیشترین فضای خالی) به عنوان عضوی از یک ریموت union در rclone استفاده نمایند.
.PP
«فهرست بک‌اندهایی که از rclone about پشتیبانی نمی‌کنند» (https://rclone.org/overview/#optional-features) و «rclone about» (https://rclone.org/commands/rclone_about) را ببینید.
.SH "ذخیره‌سازی شیء اوراکل (Oracle Object Storage)"
.PP
فضای ذخیره‌سازی شیء ارائه‌شده توسط زیرساخت ابری اوراکل (OCI).
اطلاعات بیشتر در <oracle.com>:
.IP \[bu] 2
نمای کلی Oracle Object Storage (https://docs.oracle.com/iaas/Content/Object/Concepts/objectstorageoverview.htm)
.IP \[bu] 2
پرسش‌های متداول Oracle Object Storage (https://www.oracle.com/cloud/storage/object-storage/faq)
.PP
مسیرها به صورت \f[V]remote:bucket\f[R] (یا \f[V]remote:\f[R] برای دستور \f[V]lsd\f[R]) مشخص می‌شوند.
همچنین می‌توانید زیرپوشه‌ها را نیز مشخص کنید؛ مانند \f[V]remote:bucket/path/to/dir\f[R].
.PP
نمونه دستور برای انتقال آرتیفکت‌های محلی به remote:bucket در ذخیره‌سازی شیء اوراکل:
.IP
.nf
\f[C]
rclone -vvv  --progress --stats-one-line --max-stats-groups 10 --log-format date,time,UTC,longfile --fast-list --buffer-size 256Mi --oos-no-check-bucket --oos-upload-cutoff 10Mi --multi-thread-cutoff 16Mi --multi-thread-streams 3000 --transfers 3000 --checkers 64  --retries 2  --oos-chunk-size 10Mi --oos-upload-concurrency 10000  --oos-attempt-resume-upload --oos-leave-parts-on-error sync ./artifacts  remote:bucket -vv
\f[R]
.fi
.SS "پیکربندی (Configuration)"
.PP
در اینجا مثالی از ایجاد پیکربندی برای ذخیره‌سازی شیء اوراکل آورده شده است.
دستور \f[V]rclone config\f[R] مراحل را قدم به قدم به شما راهنمایی می‌کند.
.PP
در اینجا مثالی از نحوه ساخت یک ریموت به نام \f[V]remote\f[R] آمده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد:
.IP
.nf
\f[C]
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> n

Enter name for new remote.
name> remote

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / Oracle Cloud Infrastructure Object Storage
   \[rs] (oracleobjectstorage)
Storage> oracleobjectstorage

Option provider.
Choose your Auth Provider
Choose a number from below, or type in your own string value.
Press Enter for the default (env_auth).
 1 / automatically pickup the credentials from runtime(env), first one to provide auth wins
   \[rs] (env_auth)
   / use an OCI user and an API key for authentication.
 2 | you\[cq]ll need to put in a config file your tenancy OCID, user OCID, region, the path, fingerprint to an API key.
   | https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdkconfig.htm
   \[rs] (user_principal_auth)
   / use instance principals to authorize an instance to make API calls.
 3 | each instance has its own identity, and authenticates using the certificates that are read from instance metadata.
   | https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/callingservicesfrominstances.htm
   \[rs] (instance_principal_auth)
   / use workload identity to grant Kubernetes pods policy-driven access to Oracle Cloud
 4 | Infrastructure (OCI) resources using OCI Identity and Access Management (IAM).
   | https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contenggrantingworkloadaccesstoresources.htm
   \[rs] (workload_identity_auth)
 5 / use resource principals to make API calls
   \[rs] (resource_principal_auth)
 6 / no credentials needed, this is typically for reading public buckets
   \[rs] (no_auth)
provider> 2

Option namespace.
Object storage namespace
Enter a value.
namespace> idbamagbg734

Option compartment.
Object storage compartment OCID
Enter a value.
compartment> ocid1.compartment.oc1..aaaaaaaapufkxc7ame3sthry5i7ujrwfc7ejnthhu6bhanm5oqfjpyasjkba

Option region.
Object storage Region
Enter a value.
region> us-ashburn-1

Option endpoint.
Endpoint for Object storage API.
Leave blank to use the default endpoint for the region.
Enter a value. Press Enter to leave empty.
endpoint> 

Option config_file.
Full Path to OCI config file
Choose a number from below, or type in your own string value.
Press Enter for the default (\[ti]/.oci/config).
 1 / oci configuration file location
   \[rs] (\[ti]/.oci/config)
config_file> /etc/oci/dev.conf

Option config_profile.
Profile name inside OCI config file
Choose a number from below, or type in your own string value.
Press Enter for the default (Default).
 1 / Use the default profile
   \[rs] (Default)
config_profile> Test

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: oracleobjectstorage
- namespace: idbamagbg734
- compartment: ocid1.compartment.oc1..aaaaaaaapufkxc7ame3sthry5i7ujrwfc7ejnthhu6bhanm5oqfjpyasjkba
- region: us-ashburn-1
- provider: user_principal_auth
- config_file: /etc/oci/dev.conf
- config_profile: Test
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
مشاهده تمام باکت‌ها.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
ساخت یک باکت (bucket) جدید
.IP
.nf
\f[C]
rclone mkdir remote:bucket
\f[R]
.fi
.PP
فهرست‌کردن محتویات یک باکت
.IP
.nf
\f[C]
rclone ls remote:bucket
rclone ls remote:bucket --max-depth 1
\f[R]
.fi
.SS ارائه‌دهندگان احراز هویت (Authentication Providers)
.PP
سرویس OCI روش‌های گوناگونی برای احراز هویت دارد.
جهت کسب اطلاعات بیشتر دربارهٔ روش‌های احراز هویت لطفاً به روش‌های احراز هویت OCI مراجعه کنید
(https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdk_authentication_methods.htm).
این گزینه‌ها را می‌توان در فایل پیکربندی rclone تعیین کرد.
.PP
ابزار rclone از ارائه‌دهندگان احراز هویت OCI زیر پشتیبانی می‌کند:
.IP
.nf
\f[C]
User Principal
Instance Principal
Resource Principal
Workload Identity
No authentication
\f[R]
.fi
.SS ارائه‌دهنده User Principal
.PP
نمونه فایل پیکربندی rclone برای ارائه‌دهنده احراز هویت User Principal:
.IP
.nf
\f[C]
[oos]
type = oracleobjectstorage
namespace = id<redacted>34
compartment = ocid1.compartment.oc1..aa<redacted>ba
region = us-ashburn-1
provider = user_principal_auth
config_file = /home/opc/.oci/config
config_profile = Default
\f[R]
.fi
.PP
مزایا:
.IP \[bu] 2
می‌توان از این روش از هر سروری درون OCI، به صورت درون‌سازمانی (on-premises) یا از سایر ارائه‌دهندگان ابری استفاده کرد.
.PP
ملاحظات:
.IP \[bu] 2
باید دسترسی‌ها / خط‌مشی‌های (policy) کاربر را پیکربندی کنید تا اجازهٔ دسترسی به حافظهٔ شیء (object storage) داده شود.
.IP \[bu] 2
بار کاری مدیریت کاربران و کلیدها.
.IP \[bu] 2
اگر کاربر حذف شود، فایل پیکربندی دیگر کار نخواهد کرد و ممکن است باعث اختلال در خودکارسازی‌هایی شود که از این اطلاعات احراز هویت کاربر استفاده می‌کنند.
.SS ارائه‌دهنده Instance Principal
.PP
یک نمونهٔ محاسباتی (compute instance) در OCI می‌تواند با استفاده از هویت و گواهی‌های خود به عنوان یک instance principal مجاز به استفاده از rclone شود.
با این رویکرد نیازی به ذخیره و مدیریت اطلاعات احراز هویت (credentials) نیست.
.PP
نمونه فایل پیکربندی rclone برای ارائه‌دهنده احراز هویت Instance Principal:
.IP
.nf
\f[C]
[opc\[at]rclone \[ti]]$ cat \[ti]/.config/rclone/rclone.conf
[oos]
type = oracleobjectstorage
namespace = id<redacted>fn
compartment = ocid1.compartment.oc1..aa<redacted>k7a
region = us-ashburn-1
provider = instance_principal_auth
\f[R]
.fi
.PP
مزایا:
.IP \[bu] 2
با instance principalها، نیازی به پیکربندی اطلاعات احراز هویت کاربر و انتقال یا ذخیرهٔ آن روی دیسک در نمونه‌های محاسباتی یا چرخاندن (rotate) منظم اطلاعات احراز هویت ندارید.
.IP \[bu] 2
نیازی به درگیر شدن با کاربران و کلیدها نخواهید داشت.
.IP \[bu] 2
کمک شایانی به خودکارسازی می‌کند، زیرا نیازی به مدیریت کلیدهای دسترسی، کلیدهای خصوصی کاربر، ذخیرهٔ آن‌ها در گاوصندوق (vault)، استفاده از KMS و غیره ندارید.
.PP
ملاحظات:
.IP \[bu] 2
باید یک گروه پویا (dynamic group) پیکربندی کنید که این نمونه عضو آن باشد و خط‌مشی خواندن object storage را به آن گروه پویا اضافه نمایید.
.IP \[bu] 2
هر کسی که به این ماشین دسترسی داشته باشد می‌تواند دستورهای CLI را اجرا کند.
.IP \[bu] 2
تنها برای نمونه‌های محاسباتی OCI کاربرد دارد.
روی نمونه‌ها یا منابع خارجی قابل استفاده نیست..SS Resource Principal
.PP
احراز هویت Resource Principal بسیار شبیه به احراز هویت Instance Principal است، اما برای منابعی به کار می‌رود که نمونه‌های محاسباتی (Compute Instances) نیستند، مانند توابع بدون سرور (https://docs.oracle.com/en-us/iaas/Content/Functions/Concepts/functionsoverview.htm).
برای استفاده از Resource Principal مطمئن شوید که فرایند Rclone با تنظیم این متغیرهای محیطی در فرایند خود اجرا شده است.
.IP
.nf
\f[C]
export OCI_RESOURCE_PRINCIPAL_VERSION=2.2
export OCI_RESOURCE_PRINCIPAL_REGION=us-ashburn-1
export OCI_RESOURCE_PRINCIPAL_PRIVATE_PEM=/usr/share/model-server/key.pem
export OCI_RESOURCE_PRINCIPAL_RPST=/usr/share/model-server/security_token
\f[R]
.fi
.PP
نمونه فایل پیکربندی rclone برای ارائه‌دهنده احراز هویت Resource Principal:
.IP
.nf
\f[C]
[oos]
type = oracleobjectstorage
namespace = id<redacted>34
compartment = ocid1.compartment.oc1..aa<redacted>ba
region = us-ashburn-1
provider = resource_principal_auth
\f[R]
.fi
.SS Workload Identity
.PP
احراز هویت Workload Identity ممکن است هنگام اجرای Rclone از درون یک پاد Kubernetes روی یک کلاستر Container Engine for Kubernetes (OKE) استفاده شود.
برای جزئیات بیشتر درباره پیکربندی Workload Identity، به بخش «اعطای دسترسی بارهای کاری به منابع OCI» (https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contenggrantingworkloadaccesstoresources.htm) مراجعه کنید.
برای استفاده از Workload Identity، مطمئن شوید Rclone با تنظیم این متغیرهای محیطی در فرایند خود اجرا شده است.
.IP
.nf
\f[C]
export OCI_RESOURCE_PRINCIPAL_VERSION=2.2
export OCI_RESOURCE_PRINCIPAL_REGION=us-ashburn-1
\f[R]
.fi
.SS بدون احراز هویت (No authentication)
.PP
باکت‌های عمومی برای خواندن اشیاء به هیچ سازوکار احراز هویتی نیاز ندارند.
نمونه فایل پیکربندی rclone برای حالت بدون احراز هویت:
.IP
.nf
\f[C]
[oos]
type = oracleobjectstorage
namespace = id<redacted>34
compartment = ocid1.compartment.oc1..aa<redacted>ba
region = us-ashburn-1
provider = no_auth
\f[R]
.fi
.SS زمان‌های تغییر و هش‌ها (Modification times and hashes)
.PP
زمان تغییر به‌عنوان فراداده روی شیء تحت عنوان \f[V]opc-meta-mtime\f[R] به‌صورت ممیز شناور بر حسب ثانیه از مبدأ زمان (epoch)، با دقت ۱ نانوثانیه ذخیره می‌شود.
.PP
اگر زمان تغییر نیاز به به‌روزرسانی داشته باشد، rclone تلاش خواهد کرد یک کپی سمت سرور انجام دهد تا در صورتی که شیء بتواند در یک بخش تک‌قسمتی کپی شود، زمان تغییر آن به‌روز شود.
در صورتی که اندازه شیء بزرگ‌تر از ۵ گیگابایت باشد، شیء به‌جای کپی شدن، بارگذاری مجدد خواهد شد.
.PP
توجه داشته باشید که خواندن این مقدار از شیء نیازمند یک درخواست \f[V]HEAD\f[R] اضافی است، زیرا این فراداده در فهرست‌های شیء بازگردانده نمی‌شود.
.PP
الگوریتم هش MD5 پشتیبانی می‌شود.
.SS بارگذاری‌های چندبخشی (Multipart uploads)
.PP
ابزار rclone از بارگذاری‌های چندبخشی با OOS پشتیبانی می‌کند، به این معنی که می‌تواند فایل‌های بزرگ‌تر از ۵ گیبی‌بایت (GiB) را بارگذاری کند.
.PP
توجه داشته باشید فایل‌هایی که \f[I]هم\f[R] با بارگذاری چندبخشی \f[I]و هم\f[R] از طریق ریموت‌های crypt بارگذاری می‌شوند فاقد هش MD5 هستند.
.PP
ابزار rclone از آستانه تعیین‌شده توسط \f[V]--oos-upload-cutoff\f[R] بارگذاری را از تک‌بخشی به چندبخشی تغییر می‌دهد.
این مقدار می‌تواند حداکثر ۵ گیبی‌بایت و حداقل ۰ باشد (یعنی فایل‌ها همواره به‌صورت چندبخشی بارگذاری شوند).
.PP
اندازه تکه‌ها (chunks) مورد استفاده در بارگذاری چندبخشی توسط \f[V]--oos-chunk-size\f[R] و تعداد تکه‌هایی که به‌طور هم‌روند بارگذاری می‌شوند توسط \f[V]--oos-upload-concurrency\f[R] مشخص می‌شود.
.PP
بارگذاری‌های چندبخشی به میزان \f[V]--transfers\f[R] * \f[V]--oos-upload-concurrency\f[R] * \f[V]--oos-chunk-size\f[R] حافظه اضافی مصرف خواهند کرد.
بارگذاری‌های تک‌بخشی حافظه اضافی مصرف نمی‌کنند.
.PP
انتقال‌های تک‌بخشی بسته به میزان تأخیر شما تا oos می‌توانند سریع‌تر یا کندتر از انتقال‌های چندبخشی باشند - هرچه تأخیر بیشتر باشد، احتمال اینکه انتقال‌های تک‌بخشی سریع‌تر باشند بیشتر است.
.PP
افزایش \f[V]--oos-upload-concurrency\f[R] باعث افزایش گذردهی (throughput) خواهد شد (مقدار ۸ می‌تواند معقول باشد) و افزایش \f[V]--oos-chunk-size\f[R] نیز گذردهی را بالا می‌برد (مقدار 16M معقول خواهد بود).
افزایش هر یک از این گزینه‌ها حافظه بیشتری مصرف خواهد کرد.
مقادیر پیش‌فرض به اندازه کافی بزرگ هستند تا بدون مصرف بیش از حد حافظه، بیشترین کارایی ممکن را به دست آورند..SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص oracleobjectstorage (سرویس Oracle
Cloud Infrastructure Object Storage) آمده است.
.SS --oos-provider
.PP
ارائه‌دهنده احراز هویت (Auth Provider) خود را انتخاب کنید
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: provider
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_PROVIDER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]env_auth\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]env_auth\[dq]
.RS 2
.IP \[bu] 2
دریافت خودکار اطلاعات احراز هویت از محیط اجرا (env)؛ اولین موردی که
احراز هویت را ارائه دهد اعمال می‌شود
.RE
.IP \[bu] 2
\[dq]user_principal_auth\[dq]
.RS 2
.IP \[bu] 2
استفاده از یک کاربر OCI و یک API key برای احراز هویت.
.IP \[bu] 2
باید tenancy OCID، کاربر user OCID، منطقه (region)، مسیر و fingerprint یک API key را در یک فایل پیکربندی قرار دهید.
.IP \[bu] 2
https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdkconfig.htm
.RE
.IP \[bu] 2
\[dq]instance_principal_auth\[dq]
.RS 2
.IP \[bu] 2
استفاده از instance principalها برای مجاز کردن یک نمونه (instance) جهت برقراری فراخوانی‌های API.
.IP \[bu] 2
هر نمونه هویت مختص به خود را دارد و با استفاده از گواهی‌های خوانده‌شده از متادیتای نمونه احراز هویت می‌کند.
.IP \[bu] 2
https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/callingservicesfrominstances.htm
.RE
.IP \[bu] 2
\[dq]workload_identity_auth\[dq]
.RS 2
.IP \[bu] 2
استفاده از workload identity برای اعطای دسترسی مبتنی بر پالیسی به بارهای کاری OCI Container Engine for Kubernetes جهت دسترسی به منابع OCI از طریق OCI Identity and Access Management (IAM).
.IP \[bu] 2
https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contenggrantingworkloadaccesstoresources.htm
.RE
.IP \[bu] 2
\[dq]resource_principal_auth\[dq]
.RS 2
.IP \[bu] 2
استفاده از resource principalها برای برقراری فراخوانی‌های API
.RE
.IP \[bu] 2
\[dq]no_auth\[dq]
.RS 2
.IP \[bu] 2
بدون نیاز به اطلاعات احراز هویت؛ این حالت معمولاً برای خواندن باکت‌های عمومی (public buckets) استفاده می‌شود
.RE
.RE
.SS --oos-namespace
.PP
فضای نام (namespace) ذخیره‌سازی شیء
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: namespace
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_NAMESPACE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true.SS --oos-compartment
.PP
در صورت نیاز به فهرست کردن باکت‌ها (buckets)، OCID مربوط به compartment را مشخص کنید.
.PP
فهرست کردن اشیاء بدون OCID مربوط به compartment نیز کار می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: compartment
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_COMPARTMENT
.IP \[bu] 2
ارائه‌دهنده: !no_auth
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.SS --oos-region
.PP
منطقه (Region) سرویس Object storage
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: region
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_REGION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: بله
.SS --oos-endpoint
.PP
نقطه پایانی (Endpoint) برای API سرویس Object storage.
.PP
برای استفاده از نقطه پایانی پیش‌فرض منطقه، این فیلد را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_ENDPOINT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.SS --oos-config-file
.PP
مسیر فایل پیکربندی OCI
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: config_file
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_CONFIG_FILE
.IP \[bu] 2
ارائه‌دهنده: user_principal_auth
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]\[ti]/.oci/config\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[ti]/.oci/config\[dq]
.RS 2
.IP \[bu] 2
محل فایل پیکربندی oci
.RE
.RE
.SS --oos-config-profile
.PP
نام پروفایل درون فایل پیکربندی oci
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: config_profile
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_CONFIG_PROFILE
.IP \[bu] 2
ارائه‌دهنده: user_principal_auth
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]Default\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]Default\[dq]
.RS 2
.IP \[bu] 2
استفاده از پروفایل پیش‌فرض
.RE
.RE.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مختص oracleobjectstorage (ذخیره‌سازی شیء در زیرساخت ابری اوراکل \- Oracle Cloud Infrastructure Object Storage) آورده شده است.
.SS --oos-storage-tier
.PP
کلاس ذخیره‌سازی مورد استفاده هنگام ذخیره اشیاء جدید در حافظه.
https://docs.oracle.com/en-us/iaas/Content/Object/Concepts/understandingstoragetiers.htm
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: storage_tier
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_STORAGE_TIER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]Standard\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]Standard\[dq]
.RS 2
.IP \[bu] 2
رده ذخیره‌سازی استاندارد، این رده پیش‌فرض است
.RE
.IP \[bu] 2
\[dq]InfrequentAccess\[dq]
.RS 2
.IP \[bu] 2
رده ذخیره‌سازی InfrequentAccess
.RE
.IP \[bu] 2
\[dq]Archive\[dq]
.RS 2
.IP \[bu] 2
رده ذخیره‌سازی Archive
.RE
.RE
.SS --oos-upload-cutoff
.PP
نقطه آستانه برای جابجایی به بارگذاری تکه‌ای (chunked upload).
.PP
هر فایلی بزرگ‌تر از این مقدار، در تکه‌هایی به اندازه chunk_size بارگذاری خواهد شد.
حداقل مقدار 0 و حداکثر آن 5 GiB است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 200Mi
.SS --oos-chunk-size
.PP
اندازه هر تکه (chunk) برای استفاده در بارگذاری.
.PP
هنگام بارگذاری فایل‌های بزرگ‌تر از upload_cutoff یا فایل‌هایی با اندازه نامشخص (برای مثال
از طریق \[dq]rclone rcat\[dq] یا بارگذاری‌شده با \[dq]rclone mount\[dq])، آن‌ها
به صورت چندبخشی (multipart upload) با استفاده از این اندازه تکه بارگذاری خواهند شد.
.PP
توجه داشته باشید که به ازای هر انتقال، به تعداد \[dq]upload_concurrency\[dq] تکه با این اندازه
در حافظه بافر می‌شود.
.PP
اگر فایل‌های حجیم را بر روی اتصالات پرسرعت منتقل می‌کنید و حافظه رم کافی دارید،
افزایش این مقدار سرعت انتقال را افزایش خواهد داد.
.PP
ابزار Rclone هنگام بارگذاری فایلی حجیم با اندازه مشخص، اندازه تکه را به‌طور خودکار افزایش می‌دهد
تا تعداد تکه‌ها کمتر از محدودیت ۱۰,۰۰۰ باقی بماند.
.PP
فایل‌های با اندازه نامشخص با مقدارِ chunk_size پیکربندی‌شده بارگذاری می‌شوند.
از آنجا که اندازه پیش‌فرض تکه‌ها 5 MiB است و حداکثر می‌تواند ۱۰,۰۰۰ تکه وجود داشته باشد،
این بدان معناست که در حالت پیش‌فرض حداکثر اندازه فایلی که می‌توانید به صورت جریانی (stream)
بارگذاری کنید 48 GiB است.
اگر مایل به بارگذاری جریانی فایل‌های بزرگ‌تری هستید، باید chunk_size را افزایش دهید.
.PP
افزایش اندازه تکه، دقت آمار پیشرفت نمایش‌داده‌شده با پرچم \[dq]-P\[dq] را کاهش می‌دهد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 5Mi.SS --oos-max-upload-parts
.PP
حداکثر تعداد بخش‌ها در یک بارگذاری چندبخشی.
.PP
این گزینه حداکثر تعداد تکه‌های چندبخشی مورد استفاده هنگام انجام یک بارگذاری چندبخشی را تعیین می‌کند.
.PP
سرویس OCI دارای محدودیت حداکثر 10,000 تکه است.
.PP
ابزار rclone هنگام بارگذاری یک فایل بزرگ با اندازه مشخص، اندازه هر تکه را به‌طور خودکار افزایش می‌دهد تا زیر این محدودیت تعداد تکه‌ها باقی بماند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: max_upload_parts
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_MAX_UPLOAD_PARTS
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 10000
.SS --oos-upload-concurrency
.PP
همزمانی برای بارگذاری‌های چندبخشی.
.PP
این مقدار، تعداد تکه‌های مربوط به یک فایل یکسان است که به‌طور همزمان بارگذاری می‌شوند.
.PP
اگر تعداد کمی از فایل‌های حجیم را روی پیوندهای پرسرعت بارگذاری می‌کنید و این بارگذاری‌ها به‌طور کامل از پهنای باند شما استفاده نمی‌کنند، افزایش این مقدار می‌تواند به تسریع انتقال‌ها کمک کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_UPLOAD_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 10
.SS --oos-copy-cutoff
.PP
آستانه تغییر به رونوشت چندبخشی.
.PP
هر فایلی بزرگ‌تر از این مقدار که نیاز به رونوشت در سمت سرور داشته باشد، در تکه‌هایی با این اندازه کپی خواهد شد.
.PP
حداقل مقدار 0 و حداکثر آن 5 GiB است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: copy_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_COPY_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 4.656Gi
.SS --oos-copy-timeout
.PP
مهلت زمانی برای رونوشت.
.PP
رونوشت یک عملیات ناهمگام است؛ مهلت زمانی را برای منتظر ماندن جهت موفقیت رونوشت مشخص کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: copy_timeout
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_COPY_TIMEOUT
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 1m0s
.SS --oos-disable-checksum
.PP
عدم ذخیره مجموع مقابله‌ای (checksum) MD5 در متادیتای شیء.
.PP
به‌طور معمول rclone پیش از بارگذاری ورودی، چکسام MD5 آن را محاسبه می‌کند تا بتواند آن را به متادیتای شیء اضافه کند.
این قابلیت برای بررسی یکپارچگی داده‌ها بسیار مناسب است اما می‌تواند باعث ایجاد تأخیرهای طولانی در شروع بارگذاری فایل‌های حجیم شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_checksum
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_DISABLE_CHECKSUM
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --oos-encoding
.PP
کدگذاری برای بک‌اند.
.PP
برای اطلاعات بیشتر، بخش کدگذاری (encoding) را در
بررسی کلی (https://rclone.org/overview/#encoding) مشاهده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,InvalidUtf8,Dot
.SS --oos-leave-parts-on-error
.PP
در صورت تنظیم روی درست (true)، هنگام بروز خطا از فراخوانی لغو بارگذاری (abort upload) خودداری می‌کند و تمام بخش‌های با موفقیت بارگذاری‌شده را برای بازیابی دستی باقی می‌گذارد.
.PP
برای ازسرگیری بارگذاری‌ها در میان نشست‌های مختلف، این مقدار باید روی true تنظیم شود.
.PP
هشدار: ذخیره‌سازی بخش‌های یک بارگذاری چندبخشیِ ناتمام، جزو فضای مصرفی در ذخیره‌سازی شیء (object storage) محاسبه شده و در صورت پاک‌سازی نشدن، هزینه‌های اضافی در پی خواهد داشت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: leave_parts_on_error
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_LEAVE_PARTS_ON_ERROR
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --oos-attempt-resume-upload
.PP
در صورت تنظیم روی درست (true)، تلاش می‌کند تا بارگذاری چندبخشی آغازشده قبلی برای این شیء را از سر بگیرد.
این کار از طریق ادامه بارگذاری‌ها از نشست پیشین، به تسریع انتقال‌های چندبخشی کمک خواهد کرد.
.PP
هشدار: اگر اندازه قطعه (chunk size) در نشست ازسرگرفته‌شده با نشست ناتمام قبلی متفاوت باشد، بارگذاری چندبخشی لغو شده و یک بارگذاری چندبخشی جدید با اندازه قطعه جدید آغاز می‌شود.
.PP
برای ازسرگیری و بهینه‌سازی به‌منظور نادیده گرفتن بخش‌هایی که از قبل با موفقیت بارگذاری شده‌اند، پرچم leave_parts_on_error باید true باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: attempt_resume_upload
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_ATTEMPT_RESUME_UPLOAD
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --oos-no-check-bucket
.PP
در صورت تنظیم، تلاشی برای بررسی وجود باکت (bucket) یا ساخت آن انجام نمی‌دهد.
.PP
این گزینه در صورتی که می‌دانید باکت از قبل وجود دارد، برای به حداقل رساندن تعداد تراکنش‌های انجام‌شده توسط rclone می‌تواند مفید باشد.
.PP
همچنین در حالتی که کاربر مورد استفاده دسترسی‌های لازم برای ایجاد باکت را ندارد، ممکن است به این گزینه نیاز باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_check_bucket
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_NO_CHECK_BUCKET
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --oos-sse-customer-key-file
.PP
برای استفاده از SSE-C، فایلی شامل رشته کدگذاری‌شده با base64 از کلید رمزنگاری AES-256 مرتبط با شیء.
لطفاً توجه داشته باشید که تنها یکی از موارد
sse_customer_key_file|sse_customer_key|sse_kms_key_id مورد نیاز است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sse_customer_key_file
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_SSE_CUSTOMER_KEY_FILE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
None
.RE
.RE.SS --oos-sse-customer-key
.PP
برای استفاده از SSE-C، سرآیند اختیاری که کلید رمزگذاری ۲۵۶ بیتی کدگذاری‌شده با base64 را برای رمزگذاری یا رمزگشایی داده‌ها مشخص می‌کند.
لطفاً توجه داشته باشید تنها یکی از موارد
sse_customer_key_file|sse_customer_key|sse_kms_key_id
مورد نیاز است.
برای اطلاعات بیشتر، بخش Using Your Own Keys for Server-Side Encryption را ببینید:
(https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sse_customer_key
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_SSE_CUSTOMER_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام
.RE
.RE
.SS --oos-sse-customer-key-sha256
.PP
در صورت استفاده از SSE-C، سرآیند اختیاری که هش SHA256 کدگذاری‌شده با base64 کلید رمزگذاری را مشخص می‌کند.
این مقدار برای بررسی یکپارچگی کلید رمزگذاری استفاده می‌شود.
بخش Using Your Own Keys for Server-Side Encryption را ببینید:
(https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sse_customer_key_sha256
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_SSE_CUSTOMER_KEY_SHA256
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام
.RE
.RE
.SS --oos-sse-kms-key-id
.PP
در صورت استفاده از کلید اصلی اختصاصی خود در vault، این سرآیند شناسه OCID
(https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm)
یک کلید رمزگذاری اصلی را مشخص می‌کند که برای فراخوانی سرویس Key Management جهت تولید کلید رمزگذاری داده یا رمزگذاری و رمزگشایی یک کلید رمزگذاری داده به کار می‌رود.
لطفاً توجه داشته باشید تنها یکی از موارد
sse_customer_key_file|sse_customer_key|sse_kms_key_id
مورد نیاز است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sse_kms_key_id
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_SSE_KMS_KEY_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام
.RE
.RE.SS --oos-sse-customer-algorithm
.PP
در صورت استفاده از SSE-C، سرآیند اختیاری که \[dq]AES256\[dq] را به عنوان الگوریتم رمزنگاری مشخص می‌کند.
سرویس Object Storage از \[dq]AES256\[dq] به عنوان الگوریتم رمزنگاری پشتیبانی می‌کند.
برای اطلاعات بیشتر، بخش Using Your Own Keys for Server-Side Encryption
(https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sse_customer_algorithm
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_SSE_CUSTOMER_ALGORITHM
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.IP \[bu] 2
نمونه‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
هیچ‌کدام
.RE
.IP \[bu] 2
\[dq]AES256\[dq]
.RS 2
.IP \[bu] 2
AES256
.RE
.RE
.SS --oos-decompress
.PP
در صورت تنظیم، این گزینه اشیاء کدگذاری‌شده با gzip را از حالت فشرده خارج می‌کند.
.PP
امکان بارگذاری اشیاء در Object Storage با تنظیم
\[dq]Content-Encoding: gzip\[dq] وجود دارد.
در حالت عادی rclone این فایل‌ها را به عنوان اشیاء فشرده بارگیری خواهد کرد.
.PP
اگر این پرچم تنظیم شود، rclone این فایل‌ها را با
\[dq]Content-Encoding: gzip\[dq] هنگام دریافت از حالت فشرده خارج می‌کند.
این بدان معناست که rclone نمی‌تواند اندازه و هش را بررسی کند، اما محتوای فایل
از حالت فشرده خارج خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: decompress
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_DECOMPRESS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --oos-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_OOS_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS متاداده (Metadata)
.PP
متاداده‌های کاربر به عنوان کلیدهای opc-meta- ذخیره می‌شوند.
.PP
در اینجا موارد متاداده‌های سیستمی ممکن برای بک‌اند oracleobjectstorage
آمده است.
.PP
.TS
tab(@);
lw(11.1n) lw(11.1n) lw(11.1n) lw(16.6n) lw(20.3n).
T{
نام
T}@T{
راهنما
T}@T{
نوع
T}@T{
نمونه
T}@T{
فقط‌خواندنی
T}
_
T{
opc-meta-atime
T}@T{
زمان آخرین دسترسی
T}@T{
ISO 8601
T}@T{
2025-06-30T22:27:43-04:00
T}@T{
N
T}
T{
opc-meta-btime
T}@T{
زمان ایجاد فایل (birth)
T}@T{
ISO 8601
T}@T{
2025-06-30T22:27:43-04:00
T}@T{
N
T}
T{
opc-meta-gid
T}@T{
شناسه گروه مالک
T}@T{
decimal number
T}@T{
500
T}@T{
N
T}
T{
opc-meta-mode
T}@T{
نوع و حالت فایل
T}@T{
octal, unix style
T}@T{
0100664
T}@T{
N
T}
T{
opc-meta-mtime
T}@T{
زمان آخرین تغییر
T}@T{
ISO 8601
T}@T{
2025-06-30T22:27:43-04:00
T}@T{
N
T}
T{
opc-meta-uid
T}@T{
شناسه کاربری مالک
T}@T{
decimal number
T}@T{
500
T}@T{
N
T}
.TE
.PP
برای اطلاعات بیشتر مستندات متاداده (https://rclone.org/docs/#metadata) را ببینید..SS دستورهای backend
.PP
در اینجا دستورهای مخصوص backend مربوط به oracleobjectstorage آورده شده است.
.PP
آن‌ها را به این صورت اجرا کنید:
.IP
.nf
\f[C]
rclone backend COMMAND remote:
\f[R]
.fi
.PP
راهنمای زیر توضیح می‌دهد که هر دستور چه آرگومان‌هایی دریافت می‌کند.
.PP
برای اطلاعات بیشتر در مورد نحوهٔ ارسال گزینه‌ها و آرگومان‌ها، دستور backend (https://rclone.org/commands/rclone_backend) را ببینید.
.PP
این دستورها را می‌توان بر روی یک backend در حال اجرا با استفاده از دستور rc به نام backend/command (https://rclone.org/rc/#backend-command) اجرا کرد.
.SS rename
.PP
تغییر نام یک شیء.
.IP
.nf
\f[C]
rclone backend rename remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور می‌تواند برای تغییر نام یک شیء استفاده شود.
.PP
مثال استفاده:
.IP
.nf
\f[C]
rclone backend rename oos:bucket relative-object-path-under-bucket object-new-name
\f[R]
.fi
.SS list-multipart-uploads
.PP
فهرست کردن بارگذاری‌های چندبخشی ناتمام.
.IP
.nf
\f[C]
rclone backend list-multipart-uploads remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور بارگذاری‌های چندبخشی ناتمام را در قالب JSON فهرست می‌کند.
.PP
مثال استفاده:
.IP
.nf
\f[C]
rclone backend list-multipart-uploads oos:bucket/path/to/object
\f[R]
.fi
.PP
این دستور یک دیکشنری از bucketها بازمی‌گرداند که مقادیر آن، فهرست‌هایی از بارگذاری‌های چندبخشی ناتمام است.
.PP
می‌توانید آن را بدون bucket فراخوانی کنید که در این صورت تمام bucketها را فهرست می‌کند، یا با یک bucket، و یا با یک bucket و مسیر.
.IP
.nf
\f[C]
{
    \[dq]test-bucket\[dq]: [
        {
            \[dq]namespace\[dq]: \[dq]test-namespace\[dq],
            \[dq]bucket\[dq]: \[dq]test-bucket\[dq],
            \[dq]object\[dq]: \[dq]600m.bin\[dq],
            \[dq]uploadId\[dq]: \[dq]51dd8114-52a4-b2f2-c42f-5291f05eb3c8\[dq],
            \[dq]timeCreated\[dq]: \[dq]2022-07-29T06:21:16.595Z\[dq],
            \[dq]storageTier\[dq]: \[dq]Standard\[dq]
        }
    ]
}

### cleanup

Remove unfinished multipart uploads.

\[ga]\[ga]\[ga]console
rclone backend cleanup remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور بارگذاری‌های چندبخشی ناتمام با عمر بیشتر از max-age را که مقدار پیش‌فرض آن ۲۴ ساعت است، حذف می‌کند.
.PP
توجه داشته باشید که می‌توانید از \-\-interactive/\-i یا \-\-dry\-run با این دستور استفاده کنید تا ببینید چه کاری انجام خواهد داد.
.PP
مثال‌های استفاده:
.IP
.nf
\f[C]
rclone backend cleanup oos:bucket/path/to/object
rclone backend cleanup -o max-age=7w oos:bucket/path/to/object
\f[R]
.fi
.PP
مدت‌زمان‌ها همانند بقیهٔ بخش‌های rclone تجزیه می‌شوند؛ مانند 2h، 7d، 7w و غیره.
.PP
گزینه‌ها:
.IP \[bu] 2
\[dq]max-age\[dq]: حداکثر عمر بارگذاری برای حذف..SS restore
.PP
بازیابی اشیاء از فضای ذخیره‌سازی Archive به Standard.
.IP
.nf
\f[C]
rclone backend restore remote: [options] [<arguments>+]
\f[R]
.fi
.PP
از این دستور می‌توان برای بازیابی یک یا چند شیء از فضای ذخیره‌سازی Archive به
Standard استفاده کرد.
.PP
مثال‌های استفاده:
.IP
.nf
\f[C]
rclone backend restore oos:bucket/path/to/directory -o hours=HOURS
rclone backend restore oos:bucket -o hours=HOURS
\f[R]
.fi
.PP
این پرچم از فیلترها نیز پیروی می‌کند.
ابتدا با پرچم‌های \-\-interactive/\-i یا \-\-dry\-run آزمایش کنید:
.IP
.nf
\f[C]
rclone --interactive backend restore --include \[dq]*.txt\[dq] oos:bucket/path -o hours=72
\f[R]
.fi
.PP
تمام اشیاء نشان‌داده‌شده برای بازیابی علامت‌گذاری خواهند شد، سپس:
.IP
.nf
\f[C]
rclone backend restore --include \[dq]*.txt\[dq] oos:bucket/path -o hours=72
\f[R]
.fi
.PP
این دستور فهرستی از دیکشنری‌های وضعیت را با کلیدهای Object Name و Status
بازمی‌گرداند.
مقدار Status در صورت موفقیت برابر با \[dq]RESTORED\[dq] و در غیر این صورت یک پیام خطا
خواهد بود.
.IP
.nf
\f[C]
[
    {
        \[dq]Object\[dq]: \[dq]test.txt\[dq]
        \[dq]Status\[dq]: \[dq]RESTORED\[dq],
    },
    {
        \[dq]Object\[dq]: \[dq]test/file4.txt\[dq]
        \[dq]Status\[dq]: \[dq]RESTORED\[dq],
    }
]
\f[R]
.fi
.PP
گزینه‌ها:
.IP \[bu] 2
\[dq]hours\[dq]: تعداد ساعت‌هایی که این شیء بازیابی خواهد شد.
پیش‌فرض ۲۴ ساعت است.
.SS آموزش‌ها (Tutorials)
.SS سوار کردن باکت‌ها (https://rclone.org/oracleobjectstorage/tutorial_mount)
.SH QingStor
.PP
مسیرها به‌صورت \f[V]remote:bucket\f[R] (یا \f[V]remote:\f[R] برای
دستور \f[V]lsd\f[R]) مشخص می‌شوند.
همچنین می‌توانید زیرشاخه‌ها را نیز وارد کنید، مانند
\f[V]remote:bucket/path/to/dir\f[R].
.SS پیکربندی (Configuration)
.PP
در اینجا نمونه‌ای از ایجاد یک پیکربندی QingStor آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
n/r/c/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / QingStor Object Storage
   \[rs] \[dq]qingstor\[dq]
[snip]
Storage> qingstor
Get QingStor credentials from runtime. Only applies if access_key_id and secret_access_key is blank.
Choose a number from below, or type in your own value
 1 / Enter QingStor credentials in the next step
   \[rs] \[dq]false\[dq]
 2 / Get QingStor credentials from the environment (env vars or IAM)
   \[rs] \[dq]true\[dq]
env_auth> 1
QingStor Access Key ID - leave blank for anonymous access or runtime credentials.
access_key_id> access_key
QingStor Secret Access Key (password) - leave blank for anonymous access or runtime credentials.
secret_access_key> secret_key
Enter an endpoint URL to connection QingStor API.
Leave blank will use the default value \[dq]https://qingstor.com:443\[dq]
endpoint>
Zone connect to. Default is \[dq]pek3a\[dq].
Choose a number from below, or type in your own value
   / The Beijing (China) Three Zone
 1 | Needs location constraint pek3a.
   \[rs] \[dq]pek3a\[dq]
   / The Shanghai (China) First Zone
 2 | Needs location constraint sh1a.
   \[rs] \[dq]sh1a\[dq]
zone> 1
Number of connection retry.
Leave blank will use the default value \[dq]3\[dq].
connection_retries>
Remote config
Configuration complete.
Options:
- type: qingstor
- env_auth: false
- access_key_id: access_key
- secret_access_key: secret_key
- endpoint:
- zone: pek3a
- connection_retries:
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
این ریموت \f[V]remote\f[R] نامیده می‌شود و اکنون می‌تواند به این صورت استفاده شود:
.PP
مشاهدهٔ تمام باکت‌ها
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
ساخت یک باکت جدید
.IP
.nf
\f[C]
rclone mkdir remote:bucket
\f[R]
.fi
.PP
فهرست کردن محتویات یک باکت
.IP
.nf
\f[C]
rclone ls remote:bucket
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با باکت ریموت، با حذف هرگونه
فایل اضافی در باکت.
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory remote:bucket
\f[R]
.fi.SS --fast-list
.PP
این ریموت از \f[V]--fast-list\f[R] پشتیبانی می‌کند که به شما امکان می‌دهد در ازای مصرف حافظه بیشتر، از تعداد تراکنش‌های کمتری استفاده کنید.
برای جزئیات بیشتر به مستندات rclone (https://rclone.org/docs/#fast-list) مراجعه کنید.
.SS آپلودهای چندبخشی (Multipart uploads)
.PP
برنامه rclone از آپلودهای چندبخشی در QingStor پشتیبانی می‌کند، به این معنی که می‌تواند فایل‌های بزرگ‌تر از 5 GiB را آپلود کند.
توجه داشته باشید فایل‌هایی که با آپلود چندبخشی ارسال می‌شوند فاقد MD5SUM هستند.
.PP
توجه داشته باشید که آپلودهای چندبخشی ناقص و قدیمی‌تر از ۲۴ ساعت را می‌توان با دستور \f[V]rclone cleanup remote:bucket\f[R] فقط برای یک باکت، یا با \f[V]rclone cleanup remote:\f[R] برای همه باکت‌ها حذف کرد.
سرویس QingStor هرگز آپلودهای چندبخشی ناقص را حذف نمی‌کند، بنابراین ممکن است اجرای گاه‌به‌گاه این دستور لازم باشد.
.SS باکت‌ها و ناحیه (Buckets and Zone)
.PP
در QingStor می‌توانید باکت‌ها را با استفاده از هر ناحیه‌ای فهرست کنید (\f[V]rclone lsd\f[R])، اما محتوای یک باکت تنها از ناحیه‌ای که در آن ایجاد شده قابل دسترسی است.
اگر تلاش کنید از ناحیه نادرست به یک باکت دسترسی پیدا کنید، با این خطا مواجه خواهید شد:
\f[V]incorrect zone, the bucket is not in \[aq]XXX\[aq] zone\f[R].
.SS احراز هویت (Authentication)
.PP
دو روش برای ارائه اطلاعات احراز هویت QingStor به \f[V]rclone\f[R] وجود دارد.
به ترتیب اولویت:
.IP \[bu] 2
مستقیماً در فایل پیکربندی rclone (همان‌طور که توسط \f[V]rclone config\f[R] پیکربندی شده است)
.RS 2
.IP \[bu] 2
تنظیم \f[V]access_key_id\f[R] و \f[V]secret_access_key\f[R]
.RE
.IP \[bu] 2
پیکربندی زمان اجرا (Runtime):
.RS 2
.IP \[bu] 2
تنظیم \f[V]env_auth\f[R] روی \f[V]true\f[R] در فایل پیکربندی
.IP \[bu] 2
صادر کردن (export) متغیرهای محیطی زیر پیش از اجرای \f[V]rclone\f[R]:
.RS 2
.IP \[bu] 2
شناسه کلید دسترسی: \f[V]QS_ACCESS_KEY_ID\f[R] یا \f[V]QS_ACCESS_KEY\f[R]
.IP \[bu] 2
کلید دسترسی محرمانه: \f[V]QS_SECRET_ACCESS_KEY\f[R] یا \f[V]QS_SECRET_KEY\f[R]
.RE
.RE
.SS نویسه‌های محدودشده در نام فایل (Restricted filename characters)
.PP
نویسه‌های کنترلی 0x00-0x1F و / مطابق با مجموعه پیش‌فرض نویسه‌های محدودشده (https://rclone.org/overview/#restricted-characters) جایگزین می‌شوند.
توجه داشته باشید که 0x7F جایگزین نمی‌شود.
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند شد (https://rclone.org/overview/#invalid-utf8)، زیرا نمی‌توان از آن‌ها در رشته‌های JSON استفاده کرد.
.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد ویژه qingstor (فضای ذخیره‌سازی شیء QingCloud) آورده شده است.
.SS --qingstor-env-auth
.PP
دریافت اطلاعات احراز هویت QingStor از زمان اجرا.
.PP
تنها زمانی اعمال می‌شود که access_key_id و secret_access_key خالی باشند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: env_auth
.IP \[bu] 2
متغیر محیطی: RCLONE_QINGSTOR_ENV_AUTH
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]false\[dq]
.RS 2
.IP \[bu] 2
اطلاعات احراز هویت QingStor را در مرحله بعد وارد کنید.
.RE
.IP \[bu] 2
\[dq]true\[dq]
.RS 2
.IP \[bu] 2
دریافت اطلاعات احراز هویت QingStor از محیط (متغیرهای محیطی یا IAM).
.RE
.RE.SS --qingstor-access-key-id
.PP
شناسه کلید دسترسی (Access Key ID) مربوط به QingStor.
.PP
جهت دسترسی ناشناس یا استفاده از اطلاعات هویتی زمان اجرا، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: access_key_id
.IP \[bu] 2
متغیر محیطی: RCLONE_QINGSTOR_ACCESS_KEY_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --qingstor-secret-access-key
.PP
کلید دسترسی محرمانه (گذرواژه) مربوط به QingStor.
.PP
جهت دسترسی ناشناس یا استفاده از اطلاعات هویتی زمان اجرا، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: secret_access_key
.IP \[bu] 2
متغیر محیطی: RCLONE_QINGSTOR_SECRET_ACCESS_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --qingstor-endpoint
.PP
نشانی وب (URL) نقطه پایانی را برای اتصال به API سرویس QingStor وارد کنید.
.PP
در صورت خالی گذاشتن، از مقدار پیش‌فرض
\[dq]https://qingstor.com:443\[dq] استفاده خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_QINGSTOR_ENDPOINT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --qingstor-zone
.PP
منطقه (Zone) مورد نظر برای اتصال.
.PP
پیش‌فرض \[dq]pek3a\[dq] است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: zone
.IP \[bu] 2
متغیر محیطی: RCLONE_QINGSTOR_ZONE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]pek3a\[dq]
.RS 2
.IP \[bu] 2
منطقه سه پکن (چین).
.IP \[bu] 2
نیازمند قید مکان (location constraint) pek3a است.
.RE
.IP \[bu] 2
\[dq]sh1a\[dq]
.RS 2
.IP \[bu] 2
منطقه یک شانگهای (چین).
.IP \[bu] 2
نیازمند قید مکان (location constraint) sh1a است.
.RE
.IP \[bu] 2
\[dq]gd2a\[dq]
.RS 2
.IP \[bu] 2
منطقه دو گوانگ‌دونگ (چین).
.IP \[bu] 2
نیازمند قید مکان (location constraint) gd2a است.
.RE
.RE.SS گزینه‌های پیشرفته
.PP
در این بخش گزینه‌های پیشرفته ویژه qingstor (ذخیره‌سازی شیء QingCloud) آورده شده است.
.SS --qingstor-connection-retries
.PP
تعداد دفعات تلاش مجدد برای اتصال.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: connection_retries
.IP \[bu] 2
متغیر محیطی: RCLONE_QINGSTOR_CONNECTION_RETRIES
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 3
.SS --qingstor-upload-cutoff
.PP
آستانه تغییر حالت به بارگذاری تکه‌ای (chunked).
.PP
هر فایلی بزرگ‌تر از این مقدار در قالب تکه‌هایی به اندازه chunk_size بارگذاری خواهد شد.
حداقل مقدار 0 و حداکثر آن 5 GiB است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_QINGSTOR_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 200Mi
.SS --qingstor-chunk-size
.PP
اندازه هر تکه برای استفاده در بارگذاری.
.PP
هنگام بارگذاری فایل‌های بزرگ‌تر از upload_cutoff، آن‌ها به صورت بارگذاری چندبخشی (multipart) با استفاده از این اندازه تکه ارسال خواهند شد.
.PP
توجه داشته باشید که به ازای هر انتقال، به تعداد \[dq]--qingstor-upload-concurrency\[dq] تکه از این اندازه در حافظه بافر می‌شود.
.PP
اگر فایل‌های بزرگ را روی پیوندهای پرسرعت انتقال می‌دهید و حافظه رم کافی دارید، افزایش این مقدار سرعت انتقال را بهبود می‌بخشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_QINGSTOR_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 4Mi
.SS --qingstor-upload-concurrency
.PP
همزمانی برای بارگذاری‌های چندبخشی (multipart).
.PP
این مقدار بیانگر تعداد تکه‌های مربوط به یک فایل یکسان است که به طور همزمان بارگذاری می‌شوند.
.PP
توجه: اگر این مقدار را بزرگ‌تر از ۱ (> 1) قرار دهید، چکسام (checksum) بارگذاری‌های چندبخشی مخدوش می‌شود (اگرچه خود فایل‌های بارگذاری‌شده دچار خرابی نمی‌شوند).
.PP
اگر تعداد کمی فایل بزرگ را روی خطوط پرسرعت بارگذاری می‌کنید و این بارگذاری‌ها به طور کامل از پهنای باند شما استفاده نمی‌کنند، افزایش این مقدار ممکن است به سریع‌تر شدن انتقال کمک کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_QINGSTOR_UPLOAD_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 1
.SS --qingstor-encoding
.PP
کدگذاری برای后端 (backend).
.PP
برای اطلاعات بیشتر، بخش کدگذاری را در نمای کلی (<https://rclone.org/overview/#encoding>) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_QINGSTOR_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,Ctl,InvalidUtf8.SS --qingstor-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_QINGSTOR_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS محدودیت‌ها
.PP
دستور \f[V]rclone about\f[R] توسط بک‌اند qingstor پشتیبانی نمی‌شود.
بک‌اندهایی که فاقد این قابلیت هستند نمی‌توانند فضای خالی را برای یک
mount در rclone تعیین کنند یا از سیاست \f[V]mfs\f[R] (بیشترین فضای خالی) به‌عنوان عضوی
از یک ریموت union در rclone استفاده کنند.
.PP
«فهرست بک‌اندهایی که از rclone about پشتیبانی نمی‌کنند» (https://rclone.org/overview/#optional-features) و
rclone about (https://rclone.org/commands/rclone_about) را ببینید.
.SH Quatrix
.PP
سرویس Quatrix محصول Maytech همان اشتراک‌گذاری امن و منطبق فایل Quatrix است |
Maytech (https://www.maytech.net/products/quatrix-business).
.PP
مسیرها به‌صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند به هر عمق دلخواهی باشند؛ مانند
\f[V]remote:directory/subdirectory\f[R].
.PP
راه‌اندازی اولیه Quatrix نیازمند دریافت یک کلید API از Quatrix است.
می‌توانید کلید API را در نمایه کاربر در
\f[V]https://<account>/profile/api-keys\f[R] یا با کمک API دریافت کنید
\-
<https://docs.maytech.net/quatrix/quatrix-api/api-explorer#/API-Key/post_api_key_create>.
.PP
مستندات کامل Swagger برای
Quatrix (https://docs.maytech.net/quatrix/quatrix-api/api-explorer) را ببینید.
.SS پیکربندی
.PP
در اینجا نمونه‌ای از نحوه ایجاد یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Quatrix by Maytech
   \[rs] \[dq]quatrix\[dq]
[snip]
Storage> quatrix
API key for accessing Quatrix account.
api_key> your_api_key
Host name of Quatrix account.
host> example.quatrix.it

Configuration complete.
Options:
- type: quatrix
- api_key: your_api_key
- host: example.quatrix.it
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (به جای
\f[V]remote\f[R] نامی را که به ریموت خود داده‌اید بگذارید):
.PP
فهرست کردن دایرکتوری‌ها در سطح بالای Quatrix شما
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن همه فایل‌ها در Quatrix شما
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به یک دایرکتوری در Quatrix به نام backup
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS اعتبار کلید API (API key validity)
.PP
کلید API بدون تاریخ انقضا ایجاد می‌شود.
این کلید تا زمانی که آن را در حساب کاربری خود حذف یا غیرفعال نکنید معتبر خواهد بود.
پس از غیرفعال‌سازی، کلید API می‌تواند مجدداً فعال شود.
اگر کلید API حذف شد و کلید جدیدی ایجاد گردید، می‌توانید آن را در rclone config
به‌روزرسانی کنید.
همین روند در صورت تغییر نام میزبان (hostname) نیز صدق می‌کند.
.IP
.nf
\f[C]
$ rclone config
Current remotes:

Name                 Type
====                 ====
remote               quatrix

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> e
Choose a number from below, or type in an existing value
 1 > remote
remote> remote
Configuration complete.
Options:
- type: quatrix
- host: some_host.quatrix.it
- api_key: your_api_key
Keep this \[dq]remote\[dq] remote?
Edit remote
Option api_key.
API key for accessing Quatrix account
Enter a string value. Press Enter for the default (your_api_key)
api_key>
Option host.
Host name of Quatrix account
Enter a string value. Press Enter for the default (some_host.quatrix.it).

Configuration complete.
Options:
- type: quatrix
- host: some_host.quatrix.it
- api_key: your_api_key
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.SS زمان‌های تغییر و هش‌ها (Modification times and hashes)
.PP
سرویس Quatrix اجازه می‌دهد زمان‌های تغییر روی اشیاء با دقت ۱
میکروثانیه تنظیم شوند.
از این زمان‌ها برای تشخیص اینکه آیا اشیاء نیاز به همگام‌سازی دارند یا خیر استفاده خواهد شد.
.PP
سرویس Quatrix از هش‌ها پشتیبانی نمی‌کند، بنابراین نمی‌توانید از پرچم
\f[V]--checksum\f[R] استفاده کنید.
.SS نویسه‌های محدودشده در نام فایل (Restricted filename characters)
.PP
نام‌های فایل در Quatrix به حروف بزرگ و کوچک حساس هستند و محدودیت‌هایی دارند؛ مانند
اینکه حداکثر طول نام فایل ۲۵۵ و حداقل طول آن ۱ نویسه است.
یک نام فایل نمی‌تواند برابر با \f[V].\f[R] یا \f[V]..\f[R] باشد و نباید شامل
\f[V]/\f[R]، \f[V]\[rs]\f[R] یا نویسه‌های غیرقابل‌چاپ ascii باشد.
.SS انتقال‌ها (Transfers)
.PP
برای فایل‌های بزرگ‌تر از 50 MiB، ابزار rclone از انتقال تکه‌ای (chunked transfer) استفاده خواهد کرد.
ابزار rclone حداکثر تا \f[V]--transfers\f[R] تکه را به‌طور هم‌زمان بارگذاری می‌کند
(که بین تمام بارگذاری‌های چندبخشی به اشتراک گذاشته می‌شود).
تکه‌ها در حافظه بافر می‌شوند و اندازهٔ حداقل تکه به‌طور پیش‌فرض 10_000_000
بایت است که در پیکربندی پیشرفته قابل تغییر می‌باشد؛
بنابراین افزایش \f[V]--transfers\f[R] مصرف حافظه را افزایش خواهد داد.
اندازهٔ تکه دارای یک حد حداکثری است که به‌طور پیش‌فرض روی 100_000_000
بایت تنظیم شده و در پیکربندی پیشرفته قابل تغییر است.
اندازهٔ تکهٔ بارگذاری‌شده بسته به سرعت بارگذاری به‌صورت پویا تغییر خواهد کرد.
کل حافظهٔ مصرفی برابر است با تعداد انتقال‌ها ضرب در حداقل اندازهٔ تکه.
در صورتی که حافظهٔ آزادی برای بارگذاری تخصیص یافته باشد (که برابر است با
تفاضل \f[V]maximal_summary_chunk_size\f[R] و
\f[V]minimal_chunk_size\f[R] * \f[V]transfers\f[R])، اندازهٔ تکه ممکن است
در صورت بالا بودن سرعت بارگذاری افزایش یابد.
همچنین در صورت بروز مشکل در سرعت بارگذاری، می‌تواند کاهش یابد.
اگر هیچ حافظهٔ آزادی در دسترس نباشد، اندازهٔ تمام تکه‌ها برابر با
\f[V]minimal_chunk_size\f[R] خواهد بود..SS حذف فایل‌ها
.PP
فایل‌هایی که با rclone حذف می‌کنید به سطل زباله (Trash) منتقل شده و به مدت
۳۰ روز در آنجا نگهداری خواهند شد.
همچنین Quatrix یک API برای حذف دائمی فایل‌ها و یک API برای خالی کردن سطل
زباله ارائه می‌دهد تا بتوانید فایل‌ها را به‌صورت دائمی از حساب کاربری
خود حذف کنید.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص به quatrix (Quatrix by Maytech) آمده است.
.SS --quatrix-api-key
.PP
کلید API برای دسترسی به حساب کاربری Quatrix
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: api_key
.IP \[bu] 2
متغیر محیطی: RCLONE_QUATRIX_API_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --quatrix-host
.PP
نام میزبان (Host) حساب کاربری Quatrix
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: host
.IP \[bu] 2
متغیر محیطی: RCLONE_QUATRIX_HOST
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مختص به quatrix (Quatrix by Maytech) آمده است.
.SS --quatrix-encoding
.PP
رمزگذاری (encoding) برای بک‌اند.
.PP
برای اطلاعات بیشتر بخش رمزگذاری را در نمای کلی
(https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_QUATRIX_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot
.SS --quatrix-effective-upload-time
.PP
زمان بارگذاری مورد نظر برای هر قطعه (chunk)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: effective_upload_time
.IP \[bu] 2
متغیر محیطی: RCLONE_QUATRIX_EFFECTIVE_UPLOAD_TIME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]4s\[dq]
.SS --quatrix-minimal-chunk-size
.PP
حداقل اندازه برای هر قطعه (chunk)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: minimal_chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_QUATRIX_MINIMAL_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 9.537Mi.SS --quatrix-maximal-summary-chunk-size
.PP
حداکثر مجموع برای همه تکه‌ها (chunks).
نباید کمتر از
\[aq]transfers\[aq]*\[aq]minimal_chunk_size\[aq]
باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: maximal_summary_chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_QUATRIX_MAXIMAL_SUMMARY_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 95.367Mi
.SS --quatrix-hard-delete
.PP
حذف دائمی فایل‌ها به جای انتقال آن‌ها به سطل زباله.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hard_delete
.IP \[bu] 2
متغیر محیطی: RCLONE_QUATRIX_HARD_DELETE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --quatrix-skip-project-folders
.PP
صرف‌نظر کردن از پوشه‌های پروژه در عملیات‌ها.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: skip_project_folders
.IP \[bu] 2
متغیر محیطی: RCLONE_QUATRIX_SKIP_PROJECT_FOLDERS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --quatrix-description
.PP
توضیحات ریموت (remote).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_QUATRIX_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS میزان استفاده از فضای ذخیره‌سازی (Storage usage)
.PP
میزان استفاده از فضای ذخیره‌سازی در Quatrix در هنگام خرید بر اساس حساب کاربری محدود می‌شود.
شما می‌توانید هر کاربری را با سقف ذخیره‌سازی کمتری محدود کنید.
در صورتی که کاربر سقف سفارشی نداشته باشد، سقف حساب کاربری اعمال می‌شود.
به محض اینکه به سقف مجاز برسید، بارگذاری فایل‌ها با خطا مواجه خواهد شد.
این مشکل با آزادسازی فضا یا افزایش سهمیه (quota) قابل رفع است.
.SS عملیات‌های سمت سرور (Server-side operations)
.PP
سرویس Quatrix از عملیات‌های سمت سرور (کپی و جابه‌جایی) پشتیبانی می‌کند.
در صورت بروز تداخل، فایل‌ها در حین عملیات سمت سرور بازنویسی می‌شوند.
.SH Sia
.PP
سرویس Sia (sia.tech (https://sia.tech)) یک پلتفرم ذخیره‌سازی ابری غیرمتمرکز مبتنی بر فناوری بلاک‌چین (https://wikipedia.org/wiki/Blockchain) است.
با rclone می‌توانید از آن همانند هر فایل‌سیستم ریموت دیگری استفاده کنید یا پوشه‌های Sia را به‌صورت محلی سوار (mount) نمایید.
فناوری پشت آن شامل مفاهیم جدیدی نظیر Siacoin و کیف پول (Wallet)، بلاک‌چین و اجماع (Consensus)، اجاره‌کردن (Renting) و میزبانی (Hosting) و غیره است.
اگر در آن تازه‌کار هستید، بهتر است ابتدا با استفاده از مستندات پشتیبانی عالی آن‌ها (https://support.sia.tech) با آن آشنا شوید.
.SS مقدمه (Introduction)
.PP
پیش از آنکه بتوانید از rclone به همراه Sia استفاده کنید، نیاز خواهید داشت که یک نسخه در حال اجرا از \f[V]Sia-UI\f[R] یا \f[V]siad\f[R] (دیمن Sia) را به‌صورت محلی روی رایانه خود یا روی شبکه محلی (مانند یک NAS) داشته باشید.
لطفاً راهنمای شروع به کار (https://sia.tech/get-started) را دنبال کرده و یکی از آن‌ها را نصب کنید.
.PP
برنامه rclone با برقراری ارتباط با دیمن Sia از طریق HTTP API (https://docs.sia.tech) که معمولاً روی درگاه \f[I]9980\f[R] در دسترس است، با شبکه Sia تعامل برقرار می‌کند.
به‌طور پیش‌فرض دیمن را به‌صورت محلی روی همان رایانه اجرا خواهید کرد، بنابراین امن است که گذرواژه API را خالی بگذارید (نشانی API برابر با \f[V]http://127.0.0.1:9980\f[R] خواهد بود که دسترسی خارجی را غیرممکن می‌سازد).
.PP
با این حال، اگر می‌خواهید به دیمن Sia اجراشده روی یک گره (node) دیگر دسترسی داشته باشید، برای مثال به‌دلیل محدودیت‌های حافظه یا به این دلیل که می‌خواهید یک دیمن واحد را بین چندین نمونه rclone و Sia-UI به اشتراک بگذارید، باید تمهیدات بیشتری اتخاذ کنید:
.IP \[bu] 2
اطمینان حاصل کنید که \f[I]Sia daemon\f[R] را مستقیماً یا درون یک کانتینر docker (https://github.com/SiaFoundation/siad/pkgs/container/siad) نصب کرده‌اید، چرا که Sia-UI این حالت را به‌طور بومی پشتیبانی نمی‌کند.
.IP \[bu] 2
آن را روی درگاهی با دسترسی خارجی اجرا کنید؛ برای مثال آرگومان‌های \f[V]--api-addr :9980\f[R] و \f[V]--disable-api-security\f[R] را در خط فرمان دیمن مشخص نمایید.
.IP \[bu] 2
برای دیمن \f[V]siad\f[R] گذرواژه API را از طریق متغیر محیطی \f[V]SIA_API_PASSWORD\f[R] یا فایلی متنی به نام \f[V]apipassword\f[R] در دایرکتوری دیمن اجباری کنید.
.IP \[bu] 2
گزینه بک‌اند \f[V]api_password\f[R] در rclone را با مقداری از مکان‌های فوق تنظیم نمایید.
.PP
نکات:
.IP "1." 3
اگر کیف پول شما قفل باشد، rclone نمی‌تواند آن را به‌طور خودکار باز کند.
باید از قبل با استفاده از Sia-UI یا از طریق خط فرمان \f[V]siac wallet unlock\f[R] قفل آن را باز کنید.
همچنین می‌توانید کاری کنید که \f[V]siad\f[R] هنگام راه‌اندازی با اجرای آن به همراه متغیر محیطی \f[V]SIA_WALLET_PASSWORD\f[R] کیف پول شما را به‌طور خودکار باز کند.
.IP "2." 3
اگر \f[V]siad\f[R] نتواند متغیر \f[V]SIA_API_PASSWORD\f[R] یا فایل \f[V]apipassword\f[R] را در دایرکتوری \f[V]SIA_DIR\f[R] بیابد، یک گذرواژه تصادفی تولید کرده و آن را در فایل متنی با نام \f[V]apipassword\f[R] زیر دایرکتوری \f[V]YOUR_HOME/.sia/\f[R] در Unix یا
\f[V]C:\[rs]Users\[rs]YOUR_HOME\[rs]AppData\[rs]Local\[rs]Sia\[rs]apipassword\f[R]
در Windows ذخیره خواهد کرد.
هنگام پیکربندی گذرواژه در rclone این نکته را به خاطر داشته باشید.
.IP "3." 3
تنها راه استفاده از \f[V]siad\f[R] بدون گذرواژه API، اجرای آن \f[B]روی localhost\f[R] با آرگومان خط فرمان \f[V]--authorize-api=false\f[R] است، اما این کار ناامن بوده و \f[B]اکیداً منع می‌شود\f[R]..SS پیکربندی
.PP
در اینجا مثالی از نحوهٔ ایجاد یک ریموت \f[V]sia\f[R] با نام
\f[V]mySia\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> mySia
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
\&...
29 / Sia Decentralized Cloud
   \[rs] \[dq]sia\[dq]
\&...
Storage> sia
Sia daemon API URL, like http://sia.daemon.host:9980.
Note that siad must run with --disable-api-security to open API port for other hosts (not recommended).
Keep default if Sia daemon runs on localhost.
Enter a string value. Press Enter for the default (\[dq]http://127.0.0.1:9980\[dq]).
api_url> http://127.0.0.1:9980
Sia Daemon API Password.
Can be found in the apipassword file located in HOME/.sia/ or in the daemon directory.
y) Yes type in my own password
g) Generate random password
n) No leave this optional password blank (default)
y/g/n> y
Enter the password:
password:
Confirm the password:
password:
Edit advanced config?
y) Yes
n) No (default)
y/n> n
--------------------
[mySia]
type = sia
api_url = http://127.0.0.1:9980
api_password = *** ENCRYPTED ***
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
پس از انجام پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید:
.IP \[bu] 2
فهرست کردن دایرکتوری‌ها در بالاترین سطح فضای ذخیره‌سازی Sia شما
.RS 2
.IP
.nf
\f[C]
rclone lsd mySia:
\f[R]
.fi
.RE
.IP \[bu] 2
فهرست کردن تمام فایل‌ها در فضای ذخیره‌سازی Sia شما
.RS 2
.IP
.nf
\f[C]
rclone ls mySia:
\f[R]
.fi
.RE
.IP \[bu] 2
بارگذاری یک دایرکتوری محلی به دایرکتوری Sia به نام \f[I]backup\f[R]
.RS 2
.IP
.nf
\f[C]
rclone copy /home/source mySia:backup
\f[R]
.fi
.RE.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص به sia (ابر غیرمتمرکز Sia) آمده است.
.SS --sia-api-url
.PP
نشانی URL مربوط به API دیمن Sia، مانند http://sia.daemon.host:9980.
.PP
توجه داشته باشید که siad باید با \-\-disable\-api\-security اجرا شود تا درگاه API برای سایر میزبان‌ها باز شود (توصیه نمی‌شود).
اگر دیمن Sia روی localhost اجرا می‌شود، مقدار پیش‌فرض را تغییر ندهید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: api_url
.IP \[bu] 2
متغیر محیطی: RCLONE_SIA_API_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]http://127.0.0.1:9980\[dq]
.SS --sia-api-password
.PP
گذرواژه API دیمن Sia.
.PP
می‌توان آن را در فایل apipassword واقع در HOME/.sia/ یا در دایرکتوری دیمن پیدا کرد.
.PP
\f[B]نکته:\f[R] ورودی این مقدار باید مبهم‌سازی شود - rclone obscure (https://rclone.org/commands/rclone_obscure) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: api_password
.IP \[bu] 2
متغیر محیطی: RCLONE_SIA_API_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مختص به sia (ابر غیرمتمرکز Sia) آمده است.
.SS --sia-user-agent
.PP
عامل کاربر (User Agent) siad
.PP
دیمن Sia به‌طور پیش‌فرض به دلایل امنیتی به عامل کاربر \[aq]Sia-Agent\[aq] نیاز دارد
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user_agent
.IP \[bu] 2
متغیر محیطی: RCLONE_SIA_USER_AGENT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]Sia-Agent\[dq]
.SS --sia-encoding
.PP
کدگذاری (encoding) برای backend.
.PP
برای اطلاعات بیشتر، بخش encoding را در نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_SIA_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,Question,Hash,Percent,Del,Ctl,InvalidUtf8,Dot
.SS --sia-description
.PP
توضیحات ریموت (remote).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_SIA_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false.SS "محدودیت‌ها (Limitations)"
.IP \[bu] 2
زمان‌های تغییر پشتیبانی نمی‌شوند
.IP \[bu] 2
چک‌سام‌ها پشتیبانی نمی‌شوند
.IP \[bu] 2
دستور \f[V]rclone about\f[R] پشتیبانی نمی‌شود
.IP \[bu] 2
در حال حاضر rclone فقط می‌تواند با \f[I]Siad\f[R] یا \f[I]Sia-UI\f[R] کار کند،
\f[B]دیمن SkyNet هنوز پشتیبانی نمی‌شود.\f[R]
.IP \[bu] 2
سیستم Sia اجازه استفاده از نویسه‌های کنترلی یا نمادهایی مانند علامت سؤال و پوند (#) را در نام فایل‌ها نمی‌دهد.
برنامه rclone آن‌ها را به‌طور شفاف برای شما کدگذاری (https://rclone.org/overview/#encoding) می‌کند،
اما بهتر است از این موضوع مطلع باشید.
.SH Swift
.PP
منظور از Swift همان OpenStack Object
Storage (https://docs.openstack.org/swift/latest) است.
پیاده‌سازی‌های تجاری آن عبارتند از:
.IP \[bu] 2
Rackspace Cloud Files (https://www.rackspace.com/cloud/files)
.IP \[bu] 2
Memset Memstore (https://www.memset.com/cloud/storage)
.IP \[bu] 2
OVH Object
Storage (https://www.ovhcloud.com/en/public-cloud/object-storage)
.IP \[bu] 2
Oracle Cloud
Storage (https://docs.oracle.com/en-us/iaas/integration/doc/configure-object-storage.html)
.IP \[bu] 2
Blomp Cloud Storage (https://www.blomp.com/cloud-storage)
.IP \[bu] 2
IBM Bluemix Cloud ObjectStorage
Swift (https://console.bluemix.net/docs/infrastructure/objectstorage-swift/index.html)
.PP
مسیرها به صورت \f[V]remote:container\f[R] (یا \f[V]remote:\f[R]
برای دستور \f[V]lsd\f[R]) مشخص می‌شوند.
همچنین می‌توانید زیردایرکتوری‌ها را نیز وارد کنید، مانند
\f[V]remote:container/path/to/dir\f[R].
.SS "پیکربندی (Configuration)"
.PP
در اینجا نمونه‌ای از ایجاد یک پیکربندی swift آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در فرایند راه‌اندازی تعاملی راهنمایی می‌کند.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / OpenStack Swift (Rackspace Cloud Files, Blomp Cloud Storage, Memset Memstore, OVH)
   \[rs] \[dq]swift\[dq]
[snip]
Storage> swift
Get swift credentials from environment variables in standard OpenStack form.
Choose a number from below, or type in your own value
 1 / Enter swift credentials in the next step
   \[rs] \[dq]false\[dq]
 2 / Get swift credentials from environment vars. Leave other fields blank if using this.
   \[rs] \[dq]true\[dq]
env_auth> true
User name to log in (OS_USERNAME).
user> 
API key or password (OS_PASSWORD).
key> 
Authentication URL for server (OS_AUTH_URL).
Choose a number from below, or type in your own value
 1 / Rackspace US
   \[rs] \[dq]https://auth.api.rackspacecloud.com/v1.0\[dq]
 2 / Rackspace UK
   \[rs] \[dq]https://lon.auth.api.rackspacecloud.com/v1.0\[dq]
 3 / Rackspace v2
   \[rs] \[dq]https://identity.api.rackspacecloud.com/v2.0\[dq]
 4 / Memset Memstore UK
   \[rs] \[dq]https://auth.storage.memset.com/v1.0\[dq]
 5 / Memset Memstore UK v2
   \[rs] \[dq]https://auth.storage.memset.com/v2.0\[dq]
 6 / OVH
   \[rs] \[dq]https://auth.cloud.ovh.net/v3\[dq]
 7  / Blomp Cloud Storage
   \[rs] \[dq]https://authenticate.ain.net\[dq]
auth> 
User ID to log in - optional - most swift systems use user and leave this blank (v3 auth) (OS_USER_ID).
user_id> 
User domain - optional (v3 auth) (OS_USER_DOMAIN_NAME)
domain> 
Tenant name - optional for v1 auth, this or tenant_id required otherwise (OS_TENANT_NAME or OS_PROJECT_NAME)
tenant> 
Tenant ID - optional for v1 auth, this or tenant required otherwise (OS_TENANT_ID)
tenant_id> 
Tenant domain - optional (v3 auth) (OS_PROJECT_DOMAIN_NAME)
tenant_domain> 
Region name - optional (OS_REGION_NAME)
region> 
Storage URL - optional (OS_STORAGE_URL)
storage_url> 
Auth Token from alternate authentication - optional (OS_AUTH_TOKEN)
auth_token> 
AuthVersion - optional - set to (1,2,3) if your auth URL has no version (ST_AUTH_VERSION)
auth_version> 
Endpoint type to choose from the service catalogue (OS_ENDPOINT_TYPE)
Choose a number from below, or type in your own value
 1 / Public (default, choose this if not sure)
   \[rs] \[dq]public\[dq]
 2 / Internal (use internal service net)
   \[rs] \[dq]internal\[dq]
 3 / Admin
   \[rs] \[dq]admin\[dq]
endpoint_type> 
Remote config
--------------------
[test]
env_auth = true
user = 
key = 
auth = 
user_id = 
domain = 
tenant = 
tenant_id = 
tenant_domain = 
region = 
storage_url = 
auth_token = 
auth_version = 
endpoint_type = 
--------------------
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
این ریموت \f[V]remote\f[R] نامیده می‌شود و اکنون می‌تواند به این صورت استفاده شود:
.PP
مشاهده تمام کانتینرها
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
ایجاد یک کانتینر جدید
.IP
.nf
\f[C]
rclone mkdir remote:container
\f[R]
.fi
.PP
فهرست کردن محتویات یک کانتینر
.IP
.nf
\f[C]
rclone ls remote:container
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با کانتینر ریموت، و حذف
هرگونه فایل اضافی موجود در کانتینر.
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory remote:container
\f[R]
.fi.SS پیکربندی از یک فایل اعتبارسنجی OpenStack
.PP
یک فایل اعتبارسنجی (credentials) در OpenStack معمولاً شبیه به این است (بدون کامنت‌ها):
.IP
.nf
\f[C]
export OS_AUTH_URL=https://a.provider.net/v2.0
export OS_TENANT_ID=ffffffffffffffffffffffffffffffff
export OS_TENANT_NAME=\[dq]1234567890123456\[dq]
export OS_USERNAME=\[dq]123abc567xy\[dq]
echo \[dq]Please enter your OpenStack Password: \[dq]
read -sr OS_PASSWORD_INPUT
export OS_PASSWORD=$OS_PASSWORD_INPUT
export OS_REGION_NAME=\[dq]SBG1\[dq]
if [ -z \[dq]$OS_REGION_NAME\[dq] ]; then unset OS_REGION_NAME; fi
\f[R]
.fi
.PP
فایل پیکربندی باید چیزی شبیه به این باشد، که در آن
\f[V]$OS_USERNAME\f[R] بیانگر مقدار متغیر \f[V]OS_USERNAME\f[R]
است \- در مثال بالا \f[V]123abc567xy\f[R].
.IP
.nf
\f[C]
[remote]
type = swift
user = $OS_USERNAME
key = $OS_PASSWORD
auth = $OS_AUTH_URL
tenant = $OS_TENANT_NAME
\f[R]
.fi
.PP
توجه داشته باشید که ممکن است لازم باشد (یا نباشد) \f[V]region\f[R] را نیز تنظیم کنید \- ابتدا بدون آن امتحان کنید.
.SS پیکربندی از طریق متغیرهای محیطی
.PP
در صورت تمایل، می‌توانید rclone را طوری پیکربندی کنید که با استفاده از مجموعه‌ای استاندارد از متغیرهای محیطی OpenStack از swift استفاده کند.
.PP
هنگام انجام مراحل پیکربندی، مطمئن شوید که برای \f[V]env_auth\f[R] مقدار \f[V]true\f[R] را انتخاب کرده و سایر موارد را خالی بگذارید.
.PP
سپس rclone هر پارامتر پیکربندی خالی را با استفاده از متغیرهای محیطی استاندارد OpenStack از محیط مقداردهی می‌کند.
فهرستی از این متغیرها (https://godoc.org/github.com/ncw/swift#Connection.ApplyEnvironment) در مستندات کتابخانه swift وجود دارد.
.SS استفاده از روش احراز هویت جایگزین
.PP
اگر سامانه OpenStack شما از یک روش احراز هویت غیراستاندارد استفاده می‌کند که ممکن است هنوز توسط rclone یا کتابخانه زیرین swift پشتیبانی نشود، می‌توانید احراز هویت را به صورت خارجی انجام دهید (به‌عنوان مثال، فراخوانی دستی دستورات \f[V]openstack\f[R] برای دریافت توکن).
سپس، تنها کافی است دو متغیر پیکربندی \f[V]auth_token\f[R] و \f[V]storage_url\f[R] را ارسال کنید.
اگر هر دوی آن‌ها ارائه شوند، سایر متغیرها نادیده گرفته می‌شوند.
rclone تلاشی برای احراز هویت انجام نخواهد داد، بلکه فرض می‌کند از قبل احراز هویت شده است و از این دو متغیر برای دسترسی به سامانه OpenStack استفاده خواهد کرد.
.SS استفاده از rclone بدون فایل پیکربندی
.PP
در صورت تمایل، می‌توانید از rclone به همراه swift بدون فایل پیکربندی استفاده کنید، مانند زیر:
.IP
.nf
\f[C]
source openstack-credentials-file
export RCLONE_CONFIG_MYREMOTE_TYPE=swift
export RCLONE_CONFIG_MYREMOTE_ENV_AUTH=true
rclone lsd myremote:
\f[R]
.fi
.SS --fast-list
.PP
این ریموت از \f[V]--fast-list\f[R] پشتیبانی می‌کند که به شما امکان می‌دهد در ازای مصرف حافظه بیشتر، از تراکنش‌های کمتری استفاده کنید.
برای جزئیات بیشتر به مستندات rclone در (https://rclone.org/docs/#fast-list) مراجعه کنید..SS --update و --use-server-modtime
.PP
همان‌طور که در ادامه آمده است، زمان ویرایش در فرادادهٔ شیء ذخیره می‌شود.
این مقدار به‌طور پیش‌فرض برای تمامی عملیاتی که نیازمند بررسی زمان آخرین به‌روزرسانی فایل هستند استفاده می‌شود.
این قابلیت به rclone امکان می‌دهد تا با ریموت همانند یک سیستم فایل واقعی رفتار کند، اما به دلیل نیاز به یک فراخوانی اضافه API جهت دریافت فراداده، ناکارآمد است.
.PP
برای بسیاری از عملیات، زمان آخرین بارگذاری شیء روی ریموت برای تعیین اینکه آیا شیء \[dq]تغییر یافته (dirty)\[dq] است یا خیر کفایت می‌کند.
با استفاده از \f[V]--update\f[R] به همراه \f[V]--use-server-modtime\f[R]، می‌توانید از فراخوانی اضافه API جلوگیری کرده و صرفاً فایل‌هایی را بارگذاری کنید که زمان ویرایش محلی آن‌ها جدیدتر از زمان آخرین بارگذاری‌شان است.
.SS زمان‌های ویرایش و هش‌ها
.PP
زمان ویرایش به‌صورت فراداده روی شیء در \f[V]X-Object-Meta-Mtime\f[R] به‌شکل عدد ممیز شناور از مبدأ زمان (epoch) با دقت ۱ نانوثانیه ذخیره می‌شود.
.PP
این یک استاندارد دوفاکتو (که از جمله در python-swiftclient رسمی استفاده می‌شود) برای ذخیره زمان ویرایش یک شیء است.
.PP
الگوریتم هش MD5 پشتیبانی می‌شود.
.SS نویسه‌های محدودشده در نام فایل
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
NUL
T}@T{
0x00
T}@T{
␀
T}
T{
/
T}@T{
0x2F
T}@T{
／
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند شد (https://rclone.org/overview/#invalid-utf8)، چرا که امکان استفاده از آن‌ها در رشته‌های JSON وجود ندارد.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص swift (OpenStack Swift (Rackspace Cloud Files, Blomp Cloud Storage, Memset Memstore, OVH)) آورده شده است.
.SS --swift-env-auth
.PP
دریافت اعتبارنامه‌های swift از متغیرهای محیطی در قالب استاندارد OpenStack.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: env_auth
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_ENV_AUTH
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]false\[dq]
.RS 2
.IP \[bu] 2
اعتبارنامه‌های swift را در مرحله بعد وارد کنید.
.RE
.IP \[bu] 2
\[dq]true\[dq]
.RS 2
.IP \[bu] 2
دریافت اعتبارنامه‌های swift از متغیرهای محیطی.
.IP \[bu] 2
در صورت استفاده از این گزینه، سایر فیلدها را خالی بگذارید.
.RE
.RE.SS --swift-user
.PP
نام کاربری برای ورود به سیستم (OS_USERNAME).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_USER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.SS --swift-key
.PP
کلید API یا گذرواژه (OS_PASSWORD).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: key
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.SS --swift-auth
.PP
نشانی اینترنتی (URL) احراز هویت برای سرور (OS_AUTH_URL).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_AUTH
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]https://auth.api.rackspacecloud.com/v1.0\[dq]
.RS 2
.IP \[bu] 2
Rackspace ایالات متحده
.RE
.IP \[bu] 2
\[dq]https://lon.auth.api.rackspacecloud.com/v1.0\[dq]
.RS 2
.IP \[bu] 2
Rackspace بریتانیا
.RE
.IP \[bu] 2
\[dq]https://identity.api.rackspacecloud.com/v2.0\[dq]
.RS 2
.IP \[bu] 2
Rackspace نسخه ۲
.RE
.IP \[bu] 2
\[dq]https://auth.storage.memset.com/v1.0\[dq]
.RS 2
.IP \[bu] 2
Memset Memstore بریتانیا
.RE
.IP \[bu] 2
\[dq]https://auth.storage.memset.com/v2.0\[dq]
.RS 2
.IP \[bu] 2
Memset Memstore بریتانیا نسخه ۲
.RE
.IP \[bu] 2
\[dq]https://auth.cloud.ovh.net/v3\[dq]
.RS 2
.IP \[bu] 2
OVH
.RE
.IP \[bu] 2
\[dq]https://authenticate.ain.net\[dq]
.RS 2
.IP \[bu] 2
فضای ذخیره‌سازی ابری Blomp
.RE
.RE.SS --swift-user-id
.PP
شناسه کاربر (User ID) برای ورود \- اختیاری \- بیشتر سامانه‌های swift از user استفاده می‌کنند و این مقدار را خالی می‌گذارند (احراز هویت نسخه ۳) (OS_USER_ID).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user_id
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_USER_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --swift-domain
.PP
دامنه کاربر \- اختیاری (احراز هویت نسخه ۳) (OS_USER_DOMAIN_NAME)
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: domain
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_DOMAIN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --swift-tenant
.PP
نام مستأجر (Tenant name) \- برای احراز هویت نسخه ۱ اختیاری است، در غیر این صورت این مورد یا tenant_id الزامی است (OS_TENANT_NAME یا OS_PROJECT_NAME).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: tenant
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_TENANT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --swift-tenant-id
.PP
شناسه مستأجر (Tenant ID) \- برای احراز هویت نسخه ۱ اختیاری است، در غیر این صورت این مورد یا tenant الزامی است (OS_TENANT_ID).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: tenant_id
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_TENANT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --swift-tenant-domain
.PP
دامنه مستأجر (Tenant domain) \- اختیاری (احراز هویت نسخه ۳) (OS_PROJECT_DOMAIN_NAME).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: tenant_domain
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_TENANT_DOMAIN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --swift-region
.PP
نام ناحیه (Region name) \- اختیاری (OS_REGION_NAME).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: region
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_REGION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false.SS --swift-storage-url
.PP
آدرس URL فضای ذخیره‌سازی \- اختیاری (OS_STORAGE_URL).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: storage_url
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_STORAGE_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --swift-auth-token
.PP
توکن احراز هویت (Auth Token) از روش احراز هویت جایگزین \- اختیاری (OS_AUTH_TOKEN).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_token
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_AUTH_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --swift-application-credential-id
.PP
شناسه اعتبارنامه‌ی برنامه (OS_APPLICATION_CREDENTIAL_ID).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: application_credential_id
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_APPLICATION_CREDENTIAL_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --swift-application-credential-name
.PP
نام اعتبارنامه‌ی برنامه (OS_APPLICATION_CREDENTIAL_NAME).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: application_credential_name
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_APPLICATION_CREDENTIAL_NAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --swift-application-credential-secret
.PP
رمز اعتبارنامه‌ی برنامه (OS_APPLICATION_CREDENTIAL_SECRET).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: application_credential_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_APPLICATION_CREDENTIAL_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --swift-auth-version
.PP
نسخه احراز هویت (AuthVersion) \- اختیاری \- اگر URL احراز هویت فاقد نسخه باشد، روی (1,2,3) تنظیم شود (ST_AUTH_VERSION).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_version
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_AUTH_VERSION
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 0
.SS --swift-endpoint-type
.PP
نوع نقطه پایانی (Endpoint type) برای انتخاب از کاتالوگ سرویس (OS_ENDPOINT_TYPE).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: endpoint_type
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_ENDPOINT_TYPE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]public\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]public\[dq]
.RS 2
.IP \[bu] 2
عمومی (پیش‌فرض، در صورت عدم اطمینان این گزینه را انتخاب کنید)
.RE
.IP \[bu] 2
\[dq]internal\[dq]
.RS 2
.IP \[bu] 2
داخلی (استفاده از شبکه داخلی سرویس)
.RE
.IP \[bu] 2
\[dq]admin\[dq]
.RS 2
.IP \[bu] 2
مدیر (Admin)
.RE
.RE.SS --swift-storage-policy
.PP
سیاست ذخیره‌سازی مورد استفاده هنگام ایجاد یک ظرف (container) جدید.
.PP
این گزینه سیاست ذخیره‌سازی مشخص‌شده را هنگام ایجاد یک ظرف جدید اعمال می‌کند.
این سیاست پس از آن قابل تغییر نیست.
مقادیر پیکربندی مجاز و معنای آن‌ها به ارائه‌دهندهٔ ذخیره‌سازی Swift شما بستگی دارد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: storage_policy
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_STORAGE_POLICY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[dq]
.RS 2
.IP \[bu] 2
پیش‌فرض
.RE
.IP \[bu] 2
\[dq]pcs\[dq]
.RS 2
.IP \[bu] 2
ذخیره‌سازی ابری عمومی OVH (OVH Public Cloud Storage)
.RE
.IP \[bu] 2
\[dq]pca\[dq]
.RS 2
.IP \[bu] 2
آرشیو ابری عمومی OVH (OVH Public Cloud Archive)
.RE
.RE
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفتهٔ مختص به swift (شامل OpenStack Swift (Rackspace Cloud Files, Blomp Cloud Storage, Memset Memstore, OVH)) آورده شده‌اند.
.SS --swift-leave-parts-on-error
.PP
در صورت تنظیم روی true، از فراخوانی لغو بارگذاری (abort upload) در صورت بروز خطا خودداری می‌کند.
.PP
برای از سرگیری بارگذاری‌ها در نشست‌های مختلف باید روی true تنظیم شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: leave_parts_on_error
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_LEAVE_PARTS_ON_ERROR
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --swift-fetch-until-empty-page
.PP
هنگام صفحه‌بندی، همواره اطلاعات را واکشی می‌کند مگر اینکه صفحه‌ای خالی دریافت شود.
.PP
اگر فهرست‌های rclone اشیاء کمتری را نسبت به حد انتظار نشان می‌دهند، یا اگر همگام‌سازی‌های مکرر اشیاء بدون تغییر را دوباره رونوشت می‌کنند، استفاده از این گزینه را در نظر بگیرید.
.PP
فعال کردن این گزینه بی‌خطر است، اما ممکن است rclone فراخوانی‌های API بیشتری نسبت به حد نیاز ایجاد کند.
.PP
این گزینه یکی از دو راهکار موقت برای مدیریت پیاده‌سازی‌هایی از Swift API است که صفحه‌بندی را طبق انتظار انجام نمی‌دهند.
همچنین \[dq]partial_page_fetch_threshold\[dq] را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: fetch_until_empty_page
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_FETCH_UNTIL_EMPTY_PAGE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --swift-partial-page-fetch-threshold
.PP
در زمان صفحه‌بندی، اگر صفحهٔ فعلی در محدودهٔ این درصد از حد نصاب (limit) باشد، دریافت اطلاعات انجام می‌شود.
.PP
اگر فهرست‌بندی‌های rclone اشیایی کمتر از حد انتظار را نشان می‌دهند، یا اگر همگام‌سازی‌های مکرر اشیاء بدون تغییر را کپی می‌کنند، استفاده از این گزینه را در نظر بگیرید.
.PP
فعال‌سازی این گزینه بی‌خطر است، اما ممکن است rclone فراخوانی‌های API بیشتری از حد نیاز برقرار کند.
.PP
این یکی از دو راهکار جایگزین برای مدیریت پیاده‌سازی‌هایی از Swift API است که صفحه‌بندی را طبق انتظار پیاده‌سازی نکرده‌اند.
همچنین بخش \[dq]fetch_until_empty_page\[dq] را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: partial_page_fetch_threshold
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_PARTIAL_PAGE_FETCH_THRESHOLD
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 0
.SS --swift-chunk-size
.PP
فایل‌های بزرگ‌تر از این اندازه تکه‌تکه خواهند شد.
.PP
فایل‌های بزرگ‌تر از این اندازه در یک ظرف (container) \f[V]_segments\f[R] یا یک دایرکتوری \f[V].file-segments\f[R] تکه‌تکه می‌شوند.
(برای اطلاعات بیشتر گزینهٔ \f[V]use_segments_container\f[R] را ببینید).
پیش‌فرض برای این مورد 5 GiB است که حداکثر مقدار آن نیز می‌باشد، به این معنی که تنها فایل‌های بزرگ‌تر از این اندازه تکه‌تکه خواهند شد.
.PP
برنامه rclone فایل‌های تکه‌تکه شده را به عنوان اشیاء بزرگ پویا (DLO) بارگذاری می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 5Gi
.SS --swift-no-chunk
.PP
عدم تکه‌تکه کردن فایل‌ها در هنگام بارگذاری جریانی.
.PP
هنگام انجام بارگذاری‌های جریانی (مانند استفاده از \f[V]rcat\f[R] یا \f[V]mount\f[R] همراه با \f[V]--vfs-cache-mode off\f[R]) تنظیم این پرچم باعث می‌شود که بک‌اند swift فایل‌های تکه‌تکه شده را بارگذاری نکند.
.PP
این کار حداکثر اندازهٔ بارگذاری جریانی را به 5 GiB محدود می‌کند.
این امر مفید است زیرا کار با فایل‌های تکه‌تکه نشده آسان‌تر بوده و دارای MD5SUM هستند.
.PP
برنامه rclone هنگام انجام عملیات کپی عادی، همچنان فایل‌های بزرگ‌تر از \f[V]chunk_size\f[R] را تکه‌تکه خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_chunk
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_NO_CHUNK
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --swift-no-large-objects
.PP
غیرفعال کردن پشتیبانی از اشیاء بزرگ ایستا و پویا
.PP
سوییفت نمی‌تواند فایل‌های بزرگ‌تر از 5 GiB را به صورت شفاف ذخیره کند.
دو طرح برای تکه‌تکه کردن فایل‌های بزرگ وجود دارد: اشیاء بزرگ ایستا (SLO) یا اشیاء بزرگ پویا (DLO)؛ و API به rclone اجازه نمی‌دهد بدون ارسال یک درخواست HEAD روی شیء، تشخیص دهد که آیا یک فایل شیء بزرگ ایستا است یا پویا.
از آنجا که این‌ها باید به شیوه‌های متفاوتی پردازش شوند، rclone ناچار است برای نمونه هنگام خواندن چکسام‌ها، درخواست‌های HEAD برای اشیاء ارسال کند.
.PP
هنگامی که \f[V]no_large_objects\f[R] تنظیم شده باشد، rclone فرض می‌کند که هیچ شیء بزرگ ایستا یا پویایی ذخیره نشده است.
این بدان معنی است که می‌تواند ارسال درخواست‌های اضافی HEAD را متوقف کند که این کار به‌ویژه هنگام انجام انتقال از swift به swift با فعال بودن \f[V]--checksum\f[R]، کارایی را به شدت افزایش می‌دهد.
.PP
تنظیم این گزینه متضمن \f[V]no_chunk\f[R] است و همچنین باعث می‌شود هیچ فایلی به صورت تکه‌تکه بارگذاری نشود، بنابراین بارگذاری فایل‌های بزرگ‌تر از 5 GiB با شکست مواجه خواهد شد.
.PP
اگر این گزینه را تنظیم کنید و در عمل اشیاء بزرگ ایستا یا پویا \f[B]وجود داشته باشند\f[R]، هش‌های نادرستی برای آن‌ها به دست خواهد آمد.
دانلودها موفقیت‌آمیز خواهند بود، اما سایر عملیات‌ها نظیر Remove و Copy با شکست مواجه خواهند شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_large_objects
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_NO_LARGE_OBJECTS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --swift-use-segments-container
.PP
انتخاب مقصد برای بخش‌های اشیاء بزرگ (large object segments)
.PP
سامانه Swift نمی‌تواند فایل‌های بزرگ‌تر از ۵ گیبی‌بایت (5 GiB) را به‌طور شفاف ذخیره کند و rclone برای بارگذاری فایل‌های بزرگ‌تر از \f[V]chunk_size\f[R] (پیش‌فرض ۵ گیبی‌بایت)، آن‌ها را تکه‌تکه می‌کند.
.PP
اگر این مقدار \f[V]true\f[R] باشد، تکه‌ها در یک مخزن (container) اضافی هم‌نام با مخزن مقصد اما با پسوند \f[V]_segments\f[R] ذخیره می‌شوند.
این بدان معناست که هیچ داده تکراری در مخزن اصلی وجود نخواهد داشت، اما داشتن یک مخزن دیگر ممکن است همیشه قابل قبول نباشد.
.PP
اگر این مقدار \f[V]false\f[R] باشد، تکه‌ها در یک دایرکتوری \f[V].file-segments\f[R] در ریشه مخزن ذخیره می‌شوند.
این دایرکتوری هنگام فهرست کردن مخزن نادیده گرفته می‌شود.
برخی ارائه‌دهندگان (مانند Blomp) به این حالت نیاز دارند، زیرا ایجاد مخازن اضافی در آن‌ها مجاز نیست.
اگر نمایش دایرکتوری \f[V].file-segments\f[R] در ریشه مد نظر باشد، این پرچم باید روی \f[V]true\f[R] تنظیم شود.
.PP
اگر این مقدار \f[V]unset\f[R] (پیش‌فرض) باشد، rclone مقدار مورد استفاده را انتخاب خواهد کرد.
مقدار آن \f[V]false\f[R] خواهد بود، مگر اینکه rclone هرگونه \f[V]auth_url\f[R] را شناسایی کند که می‌داند به مقدار \f[V]true\f[R] نیاز دارند.
در این صورت پیامی در لاگ DEBUG مشاهده خواهید کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_segments_container
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_USE_SEGMENTS_CONTAINER
.IP \[bu] 2
نوع: Tristate
.IP \[bu] 2
پیش‌فرض: unset
.SS --swift-encoding
.PP
کدگذاری (encoding) برای بک‌اند.
.PP
برای اطلاعات بیشتر، بخش انکودینگ را در نمای کلی
(<https://rclone.org/overview/#encoding>) مشاهده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,InvalidUtf8
.SS --swift-description
.PP
توضیحات ریموت (remote).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_SWIFT_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS "محدودیت‌ها (Limitations)"
.PP
رابط برنامه‌نویسی Swift API مقدار درستی از MD5SUM را برای فایل‌های تکه‌تکه‌شده
(Dynamic یا Static Large Objects) برنمی‌گرداند؛ بنابراین rclone مقدار MD5SUM را برای
این فایل‌ها بررسی یا استفاده نخواهد کرد.
.SS "عیب‌یابی (Troubleshooting)"
.SS "بروز خطای Failed to create file system for \[dq]remote:\[dq]: Bad Request در rclone"
.PP
به دلیل یک رفتار عجیب در کتابخانه زیربنایی swift، در صورت شکست احراز هویت در Swift، به جای یک خطای گویاتر، خطای \[dq]Bad
Request\[dq] برگردانده می‌شود.
.PP
بنابراین این موضوع به احتمال زیاد به این معنی است که نام کاربری / گذرواژه شما اشتباه است.
می‌توانید با پرچم \f[V]--dump bodies\f[R] بررسی دقیق‌تری انجام دهید.
.PP
همچنین این خطا ممکن است به دلیل مشخص کردن منطقه (region) در مواردی باشد که نباید مشخص می‌شد (مانند
OVH)..SS خطای Rclone با عنوان Failed to create file system: Response didn\[aq]t have storage url and auth token
.PP
این موضوع به احتمال زیاد به دلیل فراموش‌کردن مشخص‌کردن tenant هنگام راه‌اندازی ریموت swift رخ می‌دهد.
.SS آرشیو ابری OVH (OVH Cloud Archive)
.PP
برای استفاده از rclone با آرشیو ابری OVH، ابتدا از دستور \f[V]rclone config\f[R] برای راه‌اندازی یک بک‌اند \f[V]swift\f[R] همراه با OVH استفاده کنید و \f[V]pca\f[R] را به عنوان \f[V]storage_policy\f[R] برگزینید.
.SS بارگذاری اشیاء (Uploading Objects)
.PP
بارگذاری اشیاء در آرشیو ابری OVH هیچ تفاوتی با ذخیره‌سازی شیء (object storage) ندارد؛ به سادگی دستور مورد نظر خود (move، copy یا sync) را برای بارگذاری اشیاء اجرا کنید.
پس از بارگذاری، اشیاء در کنترل‌پنل OVH در وضعیت \[dq]Frozen\[dq] (منجمد) نمایش داده می‌شوند.
.SS بازیابی اشیاء (Retrieving Objects)
.PP
برای بازیابی اشیاء به صورت معمول از \f[V]rclone copy\f[R] استفاده کنید.
اگر اشیاء در وضعیت منجمد باشند، rclone درخواست خارج‌شدن همه آن‌ها از حالت انجماد را ارسال می‌کند و در انتهای خروجی با پیامی مشابه پیام زیر منتظر می‌ماند:
.IP
.nf
\f[C]
2019/03/23 13:06:33 NOTICE: Received retry after error - sleeping until 2019-03-23T13:16:33.481657164+01:00 (9m59.99985121s)
\f[R]
.fi
.PP
ابزار Rclone به مدت زمان مشخص‌شده منتظر می‌ماند و سپس مجدداً عملیات کپی را تلاش می‌کند.
.SH pCloud
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند تا عمق دلخواه تعیین شوند، مانند:
\f[V]remote:directory/subdirectory\f[R].
.SS پیکربندی (Configuration)
.PP
راه‌اندازی اولیه pCloud نیازمند دریافت یک توکن از pCloud است که باید آن را در مرورگر وب خود انجام دهید.
دستور \f[V]rclone config\f[R] شما را مرحله به مرحله در این مسیر هدایت می‌کند.
.PP
در اینجا نمونه‌ای از نحوه ساخت یک ریموت به نام \f[V]remote\f[R] آورده شده است. ابتدا این دستور را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Pcloud
   \[rs] \[dq]pcloud\[dq]
[snip]
Storage> pcloud
Pcloud App Client Id - leave blank normally.
client_id> 
Pcloud App Client Secret - leave blank normally.
client_secret> 
Edit advanced config?
y) Yes
n) No (default)
y/n> n
Remote config
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y) Yes
n) No
y/n> y
If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth
Log in and authorize rclone for access
Waiting for code...
Got code
Configuration complete.
Options:
- type: pcloud
- client_id:
- client_secret:
- token: {\[dq]access_token\[dq]:\[dq]XXX\[dq],\[dq]token_type\[dq]:\[dq]bearer\[dq],\[dq]expiry\[dq]:\[dq]0001-01-01T00:00:00Z\[dq]}
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
برای چگونگی راه‌اندازی روی دستگاهی که مرورگر وب با دسترسی اینترنت در دسترس ندارد، مستندات راه‌اندازی ریموت (https://rclone.org/remote_setup) را ببینید.
.PP
توجه داشته باشید اگر از پیکربندی ریموت با rclone authorize استفاده می‌کنید در حالی که سرور pcloud شما در منطقه EU (اروپا) قرار دارد، باید hostname را در \[aq]Edit advanced config\[aq] مشخص کنید، در غیر این صورت ممکن است با خطای توکن مواجه شوید.
.PP
توجه داشته باشید که rclone یک وب‌سرور روی سیستم محلی شما اجرا می‌کند تا توکن برگشتی از pCloud را دریافت نماید.
این سرویس تنها از لحظه باز شدن مرورگر تا زمانی که کد تأیید را دریافت کنید فعال است.
این وب‌سرور روی \f[V]http://127.0.0.1:53682\f[R] اجرا می‌شود و در صورتی که فایروال میزبان فعال باشد ممکن است نیاز باشد موقتاً مسدودسازی آن را غیرفعال کنید.
.PP
پس از انجام پیکربندی، می‌توانید از \f[V]rclone\f[R] به شکل زیر استفاده کنید (عبارت \f[V]remote\f[R] را با نامی که برای ریموت خود برگزیده‌اید جایگزین کنید):
.PP
فهرست‌کردن دایرکتوری‌ها در بالاترین سطح pCloud شما:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست‌کردن تمام فایل‌ها در pCloud شما:
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی‌کردن یک دایرکتوری محلی به دایرکتوری‌ای در pCloud به نام backup:
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS زمان‌های تغییر و درهم‌سازها
.PP
سرویس pCloud امکان تنظیم زمان‌های تغییر روی اشیاء را با دقت ۱ ثانیه
فراهم می‌کند.
از این زمان‌ها برای تشخیص این‌که آیا اشیاء نیاز به همگام‌سازی دارند یا خیر
استفاده خواهد شد.
برای تنظیم زمان تغییر، pCloud نیازمند بارگذاری مجدد شیء است.
.PP
سرویس pCloud از درهم‌سازهای MD5 و SHA1 در منطقه US، و درهم‌سازهای SHA1 و
SHA256 در منطقه EU پشتیبانی می‌کند، بنابراین می‌توانید از پرچم
\f[V]--checksum\f[R] استفاده کنید.
.SS نویسه‌های محدودشده در نام فایل
.PP
علاوه بر مجموعه پیش‌فرض نویسه‌های محدودشده
(https://rclone.org/overview/#restricted-characters)، نویسه‌های زیر نیز
جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند
شد (https://rclone.org/overview/#invalid-utf8)، زیرا نمی‌توان از آن‌ها
در رشته‌های JSON استفاده کرد.
.SS حذف فایل‌ها
.PP
فایل‌های حذف‌شده به سطل زباله منتقل خواهند شد.
سطح اشتراک شما تعیین می‌کند که موارد چه مدت در سطل زباله باقی بمانند.
از \f[V]rclone cleanup\f[R] می‌توان برای خالی کردن سطل زباله استفاده کرد.
.SS خالی کردن سطل زباله
.PP
به دلیل محدودیت API، دستور \f[V]rclone cleanup\f[R] تنها در صورتی کار
خواهد کرد که نام کاربری و گذرواژه خود را در گزینه‌های پیشرفته برای این
backend تنظیم کرده باشید.
از آنجا که به‌طور کلی می‌خواهیم از ذخیره گذرواژه‌های کاربر در فایل
پیکربندی rclone اجتناب کنیم، توصیه می‌کنیم تنها در صورتی این مورد را تنظیم
کنید که به اجرای دستور \f[V]rclone cleanup\f[R] نیاز داشته باشید.
.SS شناسه پوشه ریشه
.PP
شما می‌توانید مقدار \f[V]root_folder_id\f[R] را برای rclone تعیین کنید.
این همان دایرکتوری است (که با \f[V]Folder ID\f[R] آن شناسایی می‌شود) که
rclone آن را به عنوان ریشه درایو pCloud شما در نظر می‌گیرد.
.PP
به‌طور معمول این مقدار را خالی می‌گذارید و خود rclone ریشه صحیح را برای
استفاده تعیین خواهد کرد.
.PP
با این حال، می‌توانید آن را برای محدود کردن rclone به سلسله‌مراتب یک پوشه
خاص تنظیم کنید.
.PP
برای انجام این کار باید \f[V]Folder ID\f[R] دایرکتوری مورد نظری را که
می‌خواهید rclone نمایش دهد پیدا کنید.
این کار با اجرای دستور \f[V]rclone lsf\f[R] با استفاده از یک پیکربندی
اولیه که شامل پارامتر \f[V]root_folder_id\f[R] نباشد، قابل انجام است.
.PP
این دستور دایرکتوری‌های موجود را فهرست می‌کند و به شما امکان می‌دهد
Folder ID مناسب را برای استفاده‌های بعدی بیابید.
.PP
مثال:
.IP
.nf
\f[C]
$ rclone lsf --dirs-only -Fip --csv TestPcloud:
dxxxxxxxx2,My Music/
dxxxxxxxx3,My Pictures/
dxxxxxxxx4,My Videos/
\f[R]
.fi
.PP
بنابراین اگر پوشه‌ای که می‌خواهید rclone استفاده کند \[dq]My Music/\[dq]
است، از شناسه بازگردانده‌شده از دستور \f[V]rclone lsf\f[R] (به عنوان مثال
\f[V]dxxxxxxxx2\f[R]) به عنوان مقدار متغیر \f[V]root_folder_id\f[R] در
فایل پیکربندی استفاده کنید..SS اعلان‌های تغییر و سوار کردن (Change notifications and mounts)
.PP
پشتیبان pCloud از به‌روزرسانی‌های بلادرنگ برای سوار کردن‌های (mounts) rclone از طریق اعلان‌های تغییر پشتیبانی می‌کند.
ابزار rclone از API مربوط به diff long‑polling سرویس pCloud برای تشخیص تغییرات استفاده می‌کند و هنگام رخ دادن تغییرات، فهرست دایرکتوری‌ها را در سیستم‌فایل سوارشده به‌طور خودکار بازخوانی (refresh) می‌نماید.
.PP
نکات و رفتار:
.IP \[bu] 2
هنگام استفاده از \f[V]rclone mount\f[R] به‌طور خودکار کار می‌کند و نیازی به پیکربندی اضافی ندارد.
.IP \[bu] 2
محدودهٔ اعلان‌ها در سطح دایرکتوری است (directory‑scoped): هنگامی که rclone تغییری را تشخیص می‌دهد، دایرکتوری تحت‌تأثیر را بازخوانی می‌کند تا فایل‌های جدید، حذف‌شده یا تغییرنام‌یافته بلافاصله نمایان شوند.
.IP \[bu] 2
به‌روزرسانی‌ها تقریباً بلادرنگ هستند.
پشتیبان از روش اتصال طولانی (long‑poll) با فواصل زمانی کوتاه نظرسنجی پشتیبان (fallback polling) استفاده می‌کند، بنابراین باید تغییرات را به‌سرعت و بدون نیاز به بازخوانی دستی مشاهده کنید.
.PP
اگر می‌خواهید اعلان‌ها را اشکال‌زدایی یا بررسی کنید، می‌توانید از دستور کمکی زیر استفاده کنید:
.IP
.nf
\f[C]
rclone test changenotify remote:
\f[R]
.fi
.PP
این دستور اعلان‌های تغییر دریافتی را برای ریموت داده‌شده ثبت (log) می‌کند.
.SS گزینه‌های استاندارد (Standard options)
.PP
در ادامه گزینه‌های استاندارد مخصوص pcloud (Pcloud) آمده است.
.SS --pcloud-client-id
.PP
شناسه کلاینت OAuth (OAuth Client Id).
.PP
معمولاً خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_PCLOUD_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --pcloud-client-secret
.PP
کلید مخفی کلاینت OAuth (OAuth Client Secret).
.PP
معمولاً خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_PCLOUD_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در ادامه گزینه‌های پیشرفته مخصوص pcloud (Pcloud) آمده است.
.SS --pcloud-token
.PP
توکن دسترسی OAuth به‌صورت یک JSON blob.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_PCLOUD_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --pcloud-auth-url
.PP
نشانی وب (URL) کارساز احراز هویت.
.PP
برای استفاده از پیش‌فرض‌های ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_PCLOUD_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --pcloud-token-url
.PP
نشانی وب (URL) کارساز توکن.
.PP
برای استفاده از پیش‌فرض‌های ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_PCLOUD_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --pcloud-client-credentials
.PP
استفاده از جریان اعتبارسنجی کارخواه (client credentials) در OAuth.
.PP
این گزینه از «جریان اعتبارسنجی کارخواه» OAUTH2 همان‌طور که در RFC 6749 شرح داده شده است استفاده خواهد کرد.
.PP
توجه داشته باشید که این گزینه توسط همهٔ پس‌انه‌ها (backends) پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_PCLOUD_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --pcloud-encoding
.PP
کدگذاری برای پس‌انه.
.PP
برای اطلاعات بیشتر بخش کدگذاری در بررسی کلی (<https://rclone.org/overview/#encoding>) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_PCLOUD_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot
.SS --pcloud-root-folder-id
.PP
این مقدار را مشخص کنید تا rclone از یک پوشهٔ غیر ریشه به عنوان نقطهٔ شروع خود استفاده کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_folder_id
.IP \[bu] 2
متغیر محیطی: RCLONE_PCLOUD_ROOT_FOLDER_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]d0\[dq]
.SS --pcloud-hostname
.PP
نام میزبان برای اتصال.
.PP
این مقدار معمولاً هنگامی که rclone در ابتدا اتصال oauth را برقرار می‌کند تنظیم می‌شود؛ با این حال اگر از پیکربندی از راه دور (remote config) با rclone authorize استفاده می‌کنید، باید آن را به صورت دستی مقداردهی کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hostname
.IP \[bu] 2
متغیر محیطی: RCLONE_PCLOUD_HOSTNAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]api.pcloud.com\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]api.pcloud.com\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ اصلی/ایالات متحده
.RE
.IP \[bu] 2
\[dq]eapi.pcloud.com\[dq]
.RS 2
.IP \[bu] 2
ناحیهٔ اروپا
.RE
.RE.SS --pcloud-username
.PP
نام کاربری pcloud شما.
.PP
این گزینه تنها زمانی لازم است که بخواهید از دستور cleanup استفاده کنید.
به دلیل وجود یک باگ در API سرویس pcloud، رابط کاربری برنامه‌نویسی مربوطه از احراز هویت OAuth پشتیبانی نمی‌کند، بنابراین ناچاریم برای آن به احراز هویت با نام کاربری و گذرواژه اتکا کنیم.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: username
.IP \[bu] 2
متغیر محیطی: RCLONE_PCLOUD_USERNAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --pcloud-password
.PP
گذرواژه pcloud شما.
.PP
\f[B]نکته:\f[R] ورودی این مقدار باید مبهم‌سازی (obscure) شود \- دستور rclone obscure را ببینید (https://rclone.org/commands/rclone_obscure).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: password
.IP \[bu] 2
متغیر محیطی: RCLONE_PCLOUD_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --pcloud-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_PCLOUD_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SH PikPak
.PP
‏PikPak یک فضای ذخیره‌سازی ابری خصوصی است (https://mypikpak.com).
.PP
مسیرها به‌صورت \f[V]remote:path\f[R] مشخص می‌شوند و می‌توانند تا هر عمق دلخواهی باشند، مانند
\f[V]remote:directory/subdirectory\f[R].
.SS پیکربندی (Configuration)
.PP
در اینجا نمونه‌ای از ایجاد یک ریموت برای PikPak آورده شده است.
.PP
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter name for new remote.
name> remote

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
XX / PikPak
   \[rs] (pikpak)
Storage> XX

Option user.
Pikpak username.
Enter a value.
user> USERNAME

Option pass.
Pikpak password.
Choose an alternative below.
y) Yes, type in my own password
g) Generate random password
y/g> y
Enter the password:
password:
Confirm the password:
password:

Edit advanced config?
y) Yes
n) No (default)
y/n> 

Configuration complete.
Options:
- type: pikpak
- user: USERNAME
- pass: *** ENCRYPTED ***
- token: {\[dq]access_token\[dq]:\[dq]eyJ...\[dq],\[dq]token_type\[dq]:\[dq]Bearer\[dq],\[dq]refresh_token\[dq]:\[dq]os...\[dq],\[dq]expiry\[dq]:\[dq]2023-01-26T18:54:32.170582647+09:00\[dq]}
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها (Modification times and hashes)
.PP
PikPak زمان‌های تغییر را روی اشیاء نگه‌داری می‌کند و هنگام بارگذاری اشیاء آن‌ها را به‌روزرسانی می‌نماید، اما از تغییرِ صرفِ زمان تغییر پشتیبانی نمی‌کند.
.PP
الگوریتم درهم‌سازی MD5 پشتیبانی می‌شود.
.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مخصوص pikpak (PikPak) آورده شده است.
.SS --pikpak-user
.PP
نام کاربری Pikpak.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user
.IP \[bu] 2
متغیر محیطی: RCLONE_PIKPAK_USER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: true
.SS --pikpak-pass
.PP
گذرواژه Pikpak.
.PP
\f[B]توجه:\f[R] ورودی این گزینه باید مبهم‌سازی شود \- به rclone
obscure (https://rclone.org/commands/rclone_obscure) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pass
.IP \[bu] 2
متغیر محیطی: RCLONE_PIKPAK_PASS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: true
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مخصوص pikpak (PikPak) آورده شده است.
.SS --pikpak-device-id
.PP
شناسه دستگاه مورد استفاده برای مجوزدهی (authorization).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: device_id
.IP \[bu] 2
متغیر محیطی: RCLONE_PIKPAK_DEVICE_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --pikpak-user-agent
.PP
عامل کاربر HTTP برای pikpak.
.PP
پیش‌فرض آن \[dq]Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:129.0)
Gecko/20100101 Firefox/129.0\[dq] یا مقداری از \[dq]--pikpak-user-agent\[dq]
است که در خط فرمان ارائه شده باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user_agent
.IP \[bu] 2
متغیر محیطی: RCLONE_PIKPAK_USER_AGENT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:129.0)
Gecko/20100101 Firefox/129.0\[dq]
.SS --pikpak-root-folder-id
.PP
شناسه پوشه ریشه.
در حالت عادی خالی بگذارید.
.PP
این گزینه را پر کنید تا rclone از پوشه‌ای غیر از ریشه به‌عنوان نقطه آغاز خود استفاده کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_folder_id
.IP \[bu] 2
متغیر محیطی: RCLONE_PIKPAK_ROOT_FOLDER_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false.SS --pikpak-use-trash
.PP
انتقال فایل‌ها به سطل زباله به‌جای حذف دائمی آن‌ها.
.PP
مقدار پیش‌فرض true است، یعنی فایل‌ها به سطل زباله منتقل می‌شوند.
برای حذف دائمی فایل‌ها، به‌جای آن از \f[V]--pikpak-use-trash=false\f[R] استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_trash
.IP \[bu] 2
متغیر محیطی: RCLONE_PIKPAK_USE_TRASH
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --pikpak-trashed-only
.PP
فقط نمایش فایل‌هایی که در سطل زباله هستند.
.PP
این گزینه فایل‌های موجود در سطل زباله را در ساختار دایرکتوری اصلی آن‌ها نشان می‌دهد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: trashed_only
.IP \[bu] 2
متغیر محیطی: RCLONE_PIKPAK_TRASHED_ONLY
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --pikpak-no-media-link
.PP
استفاده از پیوندهای اصلی فایل به‌جای پیوندهای رسانه‌ای.
.PP
این گزینه از بروز مشکلات ناشی از پیوندهای رسانه‌ای نامعتبر جلوگیری می‌کند، اما ممکن است سرعت دانلود را کاهش دهد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_media_link
.IP \[bu] 2
متغیر محیطی: RCLONE_PIKPAK_NO_MEDIA_LINK
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --pikpak-hash-memory-limit
.PP
فایل‌های بزرگ‌تر از این مقدار، در صورت نیاز به محاسبه هش (hash)، بر روی دیسک کَش خواهند شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hash_memory_limit
.IP \[bu] 2
متغیر محیطی: RCLONE_PIKPAK_HASH_MEMORY_LIMIT
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 10Mi
.SS --pikpak-upload-cutoff
.PP
آستانه تغییر به بارگذاری تکه‌ای (chunked upload).
.PP
هر فایلی بزرگ‌تر از این مقدار، در قطعاتی به اندازه chunk_size بارگذاری خواهد شد.
حداقل مقدار 0 و حداکثر آن 5 GiB است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_PIKPAK_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 200Mi
.SS --pikpak-chunk-size
.PP
اندازه قطعات برای بارگذاری‌های چندبخشی (multipart).
.PP
فایل‌های حجیم در قطعاتی با این اندازه بارگذاری خواهند شد.
.PP
توجه داشته باشید که این اطلاعات در حافظه نگه‌داری می‌شوند و ممکن است حداکثر تا
\[dq]--transfers\[dq] * \[dq]--pikpak-upload-concurrency\[dq] قطعه
به‌طور هم‌زمان در حافظه قرار گیرد.
.PP
اگر فایل‌های حجیم را از طریق اتصالات پرسرعت منتقل می‌کنید و حافظه کافی در اختیار دارید، افزایش این مقدار سرعت انتقال را بهبود می‌بخشد.
.PP
ابزار Rclone هنگام بارگذاری فایل‌های بزرگی که اندازه آن‌ها مشخص است، اندازه قطعات را به‌طور خودکار افزایش می‌دهد تا تعداد قطعات زیر محدودیت ۱۰٬۰۰۰ باقی بماند.
.PP
افزایش اندازه قطعات، دقت آمار پیشرفت نمایش‌داده‌شده با پرچم \[dq]-P\[dq] را کاهش می‌دهد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_PIKPAK_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 5Mi.SS --pikpak-upload-concurrency
.PP
هم‌زمانی برای بارگذاری‌های چندبخشی.
.PP
این مقدار، تعداد قطعاتی از یک فایل یکسان است که به‌طور هم‌زمان در بارگذاری‌های چندبخشی آپلود می‌شوند.
.PP
توجه داشته باشید که قطعات در حافظه نگه‌داری می‌شوند و ممکن است تا
\[dq]--transfers\[dq] * \[dq]--pikpak-upload-concurrency\[dq] قطعه
به‌طور هم‌زمان در حافظه ذخیره شوند.
.PP
اگر تعداد کمی فایل حجیم را از طریق اتصال‌های پرسرعت بارگذاری می‌کنید
و این بارگذاری‌ها به‌طور کامل از پهنای باند شما استفاده نمی‌کنند، افزایش
این مقدار ممکن است به افزایش سرعت انتقال کمک کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_PIKPAK_UPLOAD_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 4
.SS --pikpak-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر، بخش encoding را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_PIKPAK_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Ctl,LeftSpace,RightSpace,RightPeriod,InvalidUtf8,Dot
.SS --pikpak-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_PIKPAK_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS دستورهای Backend
.PP
در این بخش دستورهای ویژهٔ backend مربوط به pikpak آمده است.
.PP
آن‌ها را به این صورت اجرا کنید:
.IP
.nf
\f[C]
rclone backend COMMAND remote:
\f[R]
.fi
.PP
راهنمای زیر توضیح می‌دهد که هر دستور چه آرگومان‌هایی می‌پذیرد.
.PP
برای اطلاعات بیشتر در مورد نحوهٔ ارسال گزینه‌ها و آرگومان‌ها، دستور
backend (https://rclone.org/commands/rclone_backend) را ببینید.
.PP
این دستورها را می‌توان روی یک backend در حال اجرا با استفاده از دستور rc
با عنوان backend/command (https://rclone.org/rc/#backend-command) اجرا کرد.
.SS addurl
.PP
افزودن وظیفهٔ دانلود آفلاین برای url.
.IP
.nf
\f[C]
rclone backend addurl remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور یک وظیفهٔ دانلود آفلاین برای url اضافه می‌کند.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend addurl pikpak:dirpath url
rclone backend addurl pikpak:dirpath url -o name=custom_filename.zip
\f[R]
.fi
.PP
دانلودها در \[aq]dirpath\[aq] ذخیره خواهند شد.
اگر \[aq]dirpath\[aq] نامعتبر باشد، دانلود به پوشهٔ پیش‌فرض
\[aq]My Pack\[aq] بازمی‌گردد.
.PP
گزینه‌ها:
.IP \[bu] 2
\[dq]name\[dq]: نام فایل سفارشی برای فایل دانلود شده..SS decompress
.PP
درخواست خارج‌سازی یک یا چند فایل از حالت فشرده در یک پوشه.
.IP
.nf
\f[C]
rclone backend decompress remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این دستور درخواست خارج کردن فایل یا فایل‌هایی در یک پوشه از حالت فشرده را ارسال می‌کند.
.PP
مثال‌های کاربرد:
.IP
.nf
\f[C]
rclone backend decompress pikpak:dirpath {filename} -o password=password
rclone backend decompress pikpak:dirpath {filename} -o delete-src-file
\f[R]
.fi
.PP
یک آرگومان اختیاری \[aq]filename\[aq] می‌تواند برای فایلی واقع در \[aq]pikpak:dirpath\[aq] مشخص شود.
می‌توانید برای فایل‌های محافظت‌شده با گذرواژه، \[aq]-o password=password\[aq] را مشخص کنید.
همچنین، برای حذف فایل‌های مبدأ پس از اتمام استخراج، \[aq]-o delete-src-file\[aq] را منتقل نمایید.
.PP
نتیجه:
.IP
.nf
\f[C]
{
    \[dq]Decompressed\[dq]: 17,
    \[dq]SourceDeleted\[dq]: 0,
    \[dq]Errors\[dq]: 0
}
\f[R]
.fi
.SS "محدودیت‌ها (Limitations)"
.SS "هش‌ها ممکن است خالی باشند (Hashes may be empty)"
.PP
سرویس PikPak از هش MD5 پشتیبانی می‌کند، اما گاهی اوقات به‌ویژه برای فایل‌های بارگذاری‌شده توسط کاربر، مقدار آن خالی برگردانده می‌شود.
.SS "فایل‌های حذف‌شده همچنان با trashed-only قابل مشاهده هستند (Deleted files still visible with trashed-only)"
.PP
فایل‌های حذف‌شده حتی پس از خالی کردن سطل زباله نیز همچنان با \f[V]--pikpak-trashed-only\f[R] قابل مشاهده خواهند بود.
این مورد پس از چند روز برطرف می‌شود.
.SH "پیکسل‌درین (Pixeldrain)"
.PP
این بک‌اندی برای ویژگی سیستم‌فایل پریمیوم Pixeldrain است.
این مورد با محصول رایگان اشتراک‌گذاری فایل pixeldrain تفاوت دارد.
سیستم‌فایل نیازمند یک اشتراک Pro یا طرح اعتباری (Prepaid) است.
اطلاعات بیشتر درباره اشتراک‌ها در <https://pixeldrain.com/#pro>.
.PP
نمای کلی از ویژگی‌ها و محدودیت‌های سیستم‌فایل در راهنمای سیستم‌فایل (<https://pixeldrain.com/filesystem>) در pixeldrain موجود است.
.SS "استفاده با حساب کاربری (Usage with account)"
.PP
برای استفاده از سیستم‌فایل شخصی به یک حساب کاربری pixeldrain (<https://pixeldrain.com/register>) و طرح اعتباری (Prepaid) یا یکی از اشتراک‌های مبتنی بر Patreon نیاز خواهید داشت.
پس از ثبت‌نام و تهیه اشتراک، سیستم‌فایل شخصی شما در این پیوند در دسترس خواهد بود: <https://pixeldrain.com/d/me>.
.PP
به صفحه کلیدهای API (<https://pixeldrain.com/user/api_keys>) در حساب کاربری خود رفته و یک کلید API جدید برای rclone ایجاد کنید.
سپس \f[V]rclone config\f[R] را اجرا کرده و از آن کلید API برای ساخت یک بک‌اند جدید استفاده نمایید.
.PP
مثال:
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
d) Delete remote
c) Copy remote
s) Set configuration password
q) Quit config
n/d/c/s/q> n

Enter name for new remote.
name> pixeldrainfs

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
\&...
XX / Pixeldrain Filesystem
   \[rs] (pixeldrain)
\&...
Storage> pixeldrain

Option api_key.
API key for your pixeldrain account.
Found on https://pixeldrain.com/user/api_keys.
Enter a value. Press Enter to leave empty.
api_key> b1bb1e81-9b7b-406b-986a-c9b20be76e15

Option directory_id.
Root of the filesystem to use. Set to \[aq]me\[aq] to use your personal filesystem.
Set to a shared directory ID to use a shared directory.
Enter a string value. Press Enter for the default (me).
directory_id>

Edit advanced config?
y) Yes
n) No (default)
y/n>

Configuration complete.
Options:
- type: pixeldrain
- api_key: b1bb1e81-9b7b-406b-986a-c9b20be76e15
Keep this \[dq]pixeldrainfs\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d>

Current remotes:

Name                 Type
====                 ====
pixeldrainfs         pixeldrain

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> q
\f[R]
.fi.SS استفاده بدون حساب کاربری
.PP
امکان دسترسی فقط‌خواندنی به دایرکتوری‌های هم‌رسانی‌شده به‌صورت عمومی از طریق rclone وجود دارد.
برای این کار تنها به یک شناسه دایرکتوری نیاز دارید.
شناسه دایرکتوری را می‌توان در نشانی وب (URL) یک دایرکتوری هم‌رسانی‌شده پیدا کرد؛ این نشانی شبیه \f[V]https://pixeldrain.com/d/abcd1234\f[R] خواهد بود که در آن \f[V]abcd1234\f[R] شناسه دایرکتوری است.
شناسه‌های دایرکتوری در سیستم فایل خودتان را نیز می‌توان با دستور \f[V]lsf\f[R] فهرست کرد:
.PP
\f[V]rclone lsf Pixeldrain: --dirs-only -Fpi\f[R]
.PP
این دستور دایرکتوری‌های موجود در دایرکتوری خانگی \f[V]Pixeldrain\f[R] شما و شناسه‌های عمومی آن‌ها را نمایش می‌دهد.
.PP
این شناسه دایرکتوری را در پیکربندی rclone وارد کنید تا بتوانید به دایرکتوری دسترسی داشته باشید.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد ویژه pixeldrain (سیستم فایل Pixeldrain) آورده شده است.
.SS --pixeldrain-api-key
.PP
کلید API برای حساب کاربری pixeldrain شما.
قابل دریافت از https://pixeldrain.com/user/api_keys.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: api_key
.IP \[bu] 2
متغیر محیطی: RCLONE_PIXELDRAIN_API_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --pixeldrain-root-folder-id
.PP
ریشه سیستم فایل مورد استفاده.
.PP
برای استفاده از سیستم فایل شخصی خود، آن را روی \[aq]me\[aq] تنظیم کنید.
برای استفاده از یک دایرکتوری هم‌رسانی‌شده، آن را روی شناسه دایرکتوری هم‌رسانی‌شده تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_folder_id
.IP \[bu] 2
متغیر محیطی: RCLONE_PIXELDRAIN_ROOT_FOLDER_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]me\[dq]
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته ویژه pixeldrain (سیستم فایل Pixeldrain) آورده شده است.
.SS --pixeldrain-api-url
.PP
نقطه پایانی API برای برقراری اتصال.
در بیشتر موارد بهتر است این مقدار روی پیش‌فرض باقی بماند.
تغییر این مقدار تنها برای اهداف آزمایشی در نظر گرفته شده است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: api_url
.IP \[bu] 2
متغیر محیطی: RCLONE_PIXELDRAIN_API_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]https://pixeldrain.com/api\[dq]
.SS --pixeldrain-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_PIXELDRAIN_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS فراداده (Metadata)
.PP
‏Pixeldrain از حالت‌های فایل (file modes) و زمان‌های ایجاد پشتیبانی می‌کند.
.PP
در ادامه موارد ممکن فرادادهٔ سیستم برای backend مربوط به pixeldrain آمده است.
.PP
.TS
tab(@);
lw(11.1n) lw(11.1n) lw(11.1n) lw(16.6n) lw(20.3n).
T{
نام
T}@T{
راهنما
T}@T{
نوع
T}@T{
مثال
T}@T{
فقط‌خواندنی
T}
_
T{
btime
T}@T{
زمان ایجاد فایل (ساخت)
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}@T{
N
T}
T{
mode
T}@T{
حالت فایل
T}@T{
اکتال، سبک یونیکس
T}@T{
755
T}@T{
N
T}
T{
mtime
T}@T{
زمان آخرین تغییر
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}@T{
N
T}
.TE
.PP
برای اطلاعات بیشتر، مستندات فراداده (https://rclone.org/docs/#metadata) را ببینید.
.SH premiumize.me
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند تا هر عمقی که نیاز است ادامه یابند، مانند
\f[V]remote:directory/subdirectory\f[R].
.SS پیکربندی (Configuration)
.PP
راه‌اندازی اولیه برای premiumize.me (https://premiumize.me) شامل
دریافت یک توکن از premiumize.me است که باید آن را در مرورگر خود انجام دهید.
دستور \f[V]rclone config\f[R] شما را در این فرایند راهنمایی می‌کند.
.PP
در اینجا مثالی از نحوه ساخت یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / premiumize.me
   \[rs] \[dq]premiumizeme\[dq]
[snip]
Storage> premiumizeme
** See help for premiumizeme backend at: https://rclone.org/premiumizeme **

Remote config
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y) Yes
n) No
y/n> y
If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth
Log in and authorize rclone for access
Waiting for code...
Got code
Configuration complete.
Options:
- type: premiumizeme
- token: {\[dq]access_token\[dq]:\[dq]XXX\[dq],\[dq]token_type\[dq]:\[dq]Bearer\[dq],\[dq]refresh_token\[dq]:\[dq]XXX\[dq],\[dq]expiry\[dq]:\[dq]2029-08-07T18:44:15.548915378+01:00\[dq]}
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> 
\f[R]
.fi
.PP
برای اطلاع از نحوه راه‌اندازی آن روی ماشینی بدون مرورگر وب متصل به اینترنت،
مستندات راه‌اندازی ریموت (https://rclone.org/remote_setup) را ببینید.
.PP
توجه داشته باشید که rclone یک وب‌سرور روی ماشین محلی شما اجرا می‌کند تا
توکن بازگردانده‌شده از premiumize.me را دریافت کند.
این وب‌سرور تنها از لحظه باز کردن مرورگر تا لحظه دریافت کد تأیید اجرا می‌شود.
این سرور روی \f[V]http://127.0.0.1:53682\f[R] فعال است و در صورت
استفاده از فایروال میزبان، ممکن است لازم باشد آن را موقتاً باز کنید.
.PP
پس از انجام پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (نام
\f[V]remote\f[R] را با نامی که به ریموت خود داده‌اید جایگزین کنید):
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح premiumize.me شما
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در premiumize.me شما
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به دایرکتوری‌ای به نام backup در premiumize.me
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها
.PP
سرویس premiumize.me از زمان‌های تغییر یا هش‌ها پشتیبانی نمی‌کند، بنابراین
همگام‌سازی به‌طور پیش‌فرض به بررسی \f[V]--size-only\f[R] تغییر می‌یابد.
توجه داشته باشید که استفاده از \f[V]--update\f[R] کار خواهد کرد.
.SS نویسه‌های محدودشده نام فایل
.PP
علاوه بر مجموعه پیش‌فرض نویسه‌های محدودشده
(<https://rclone.org/overview/#restricted-characters>)، نویسه‌های زیر نیز
جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
T{
\[dq]
T}@T{
0x22
T}@T{
＂
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند
شد (<https://rclone.org/overview/#invalid-utf8>)، چرا که نمی‌توان از آن‌ها
در رشته‌های JSON استفاده کرد.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مخصوص premiumizeme (premiumize.me) آمده است.
.SS --premiumizeme-client-id
.PP
شناسه کلاینت OAuth.
.PP
در حالت معمول خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
Config: client_id
.IP \[bu] 2
Env Var: RCLONE_PREMIUMIZEME_CLIENT_ID
.IP \[bu] 2
Type: string
.IP \[bu] 2
Required: false
.SS --premiumizeme-client-secret
.PP
راز کلاینت OAuth.
.PP
در حالت معمول خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
Config: client_secret
.IP \[bu] 2
Env Var: RCLONE_PREMIUMIZEME_CLIENT_SECRET
.IP \[bu] 2
Type: string
.IP \[bu] 2
Required: false
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مخصوص premiumizeme (premiumize.me) آمده است.
.SS --premiumizeme-token
.PP
توکن دسترسی OAuth در قالب یک JSON blob.
.PP
ویژگی‌ها:
.IP \[bu] 2
Config: token
.IP \[bu] 2
Env Var: RCLONE_PREMIUMIZEME_TOKEN
.IP \[bu] 2
Type: string
.IP \[bu] 2
Required: false.SS --premiumizeme-auth-url
.PP
نشانی وب (URL) سرور احراز هویت.
.PP
برای استفاده از پیش‌فرض‌های ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_PREMIUMIZEME_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --premiumizeme-token-url
.PP
نشانی وب (URL) سرور توکن.
.PP
برای استفاده از پیش‌فرض‌های ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_PREMIUMIZEME_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --premiumizeme-client-credentials
.PP
استفاده از جریان OAuth نوع client credentials.
.PP
این گزینه از OAUTH2 client Credentials Flow همان‌طور که در RFC
6749 شرح داده شده است استفاده خواهد کرد.
.PP
توجه داشته باشید که این گزینه توسط همه بک‌اندها پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_PREMIUMIZEME_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --premiumizeme-encoding
.PP
کدگذاری (encoding) برای بک‌اند.
.PP
برای اطلاعات بیشتر، بخش encoding را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_PREMIUMIZEME_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,DoubleQuote,BackSlash,Del,Ctl,InvalidUtf8,Dot
.SS --premiumizeme-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_PREMIUMIZEME_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS "محدودیت‌ها (Limitations)"
.PP
توجه داشته باشید که premiumize.me به بزرگی و کوچکی حروف حساس نیست (case insensitive)، بنابراین نمی‌توانید فایلی
به نام \[dq]Hello.doc\[dq] و فایل دیگری به نام \[dq]hello.doc\[dq] داشته باشید.
.PP
نام فایل‌ها در premiumize.me نمی‌تواند شامل نویسه‌های \f[V]\[rs]\f[R] یا
\f[V]\[dq]\f[R] باشد.
rclone این نویسه‌ها را از و به معادل‌های یونیکد هم‌شکل
\f[V]＼\f[R] و \f[V]＂\f[R] نگاشت می‌کند.
.PP
سرویس premiumize.me تنها از نام فایل‌هایی با حداکثر طول ۲۵۵ نویسه پشتیبانی می‌کند..SH "پروتون درایو (Proton Drive)"
.PP
پروتون درایو (https://proton.me/drive) یک گاوصندوق سوئیسی با رمزنگاری سرتاسری برای فایل‌های شماست که از داده‌هایتان محافظت می‌کند.
.PP
این یک backend در rclone برای Proton Drive است که از قابلیت‌های انتقال فایل Proton Drive با استفاده از همان رمزنگاری سمت کلاینت پشتیبانی می‌کند.
.PP
با توجه به اینکه Proton Drive مستندات API خود را منتشر نمی‌کند، این backend با نهایت تلاش از طریق خواندن کد منبع باز کلاینت و بررسی ترافیک Proton Drive در مرورگر پیاده‌سازی شده است.
.PP
\f[B]توجه:\f[R] این backend در حال حاضر در مرحلهٔ آزمایشی (Beta) است.
تصور می‌شود که عملکرد آن صحیح بوده و تمام آزمون‌های یکپارچگی را با موفقیت پشت سر می‌گذارد.
با این حال، پروتکل Proton Drive در طول زمان تکامل یافته و ممکن است حساب‌هایی وجود داشته باشند که با آن سازگار نباشند.
در صورت مشاهدهٔ هرگونه ناسازگاری، لطفاً آن را در انجمن rclone (https://forum.rclone.org) گزارش دهید.
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند به هر عمق مورد نیازی مشخص شوند، مانند:
\f[V]remote:directory/subdirectory\f[R].
.SS "پیکربندی‌ها (Configurations)"
.PP
در اینجا مثالی از نحوهٔ ساخت یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Proton Drive
   \[rs] \[dq]protondrive\[dq]
[snip]
Storage> protondrive
User name
user> you\[at]protonmail.com
Password.
y) Yes type in my own password
g) Generate random password
n) No leave this optional password blank
y/g/n> y
Enter the password:
password:
Confirm the password:
password:
Option 2fa.
2FA code (if the account requires one)
Enter a value. Press Enter to leave empty.
2fa> 123456
Remote config
Configuration complete.
Options:
- type: protondrive
- user: you\[at]protonmail.com
- pass: *** ENCRYPTED ***
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
\f[B]نکته:\f[R] کلیدهای رمزنگاری Proton Drive باید پیش‌تر پس از یک ورود عادی از طریق مرورگر ایجاد شده باشند؛ در غیر این صورت، تلاش برای استفاده از اطلاعات ورود در \f[V]rclone\f[R] با شکست مواجه خواهد شد.
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (نام \f[V]remote\f[R] را با نامی که به ریموت خود اختصاص داده‌اید جایگزین نمایید):
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح Proton Drive شما:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در Proton Drive شما:
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به دایرکتوری‌ای به نام backup در Proton Drive:
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها
.PP
ابزار Proton Drive Bridge هنوز از به‌روزرسانی زمان‌های تغییر پشتیبانی نمی‌کند.
.PP
الگوریتم هش SHA1 پشتیبانی می‌شود.
.SS نویسه‌های محدودشده نام فایل
.PP
بایت‌های نامعتبر UTF-8 جایگزین خواهند شد (https://rclone.org/overview/#invalid-utf8)، همچنین فاصله‌های (space) ابتدا و انتها حذف می‌شوند (مرجع کد (https://github.com/ProtonMail/WebClients/blob/b4eba99d241af4fdae06ff7138bd651a40ef5d3c/applications/drive/src/app/store/_links/validation.ts#L51)).
.SS فایل‌های تکراری
.PP
سرویس Proton Drive نمی‌تواند دو فایل با نام و مسیر کاملاً یکسان داشته باشد. در صورت بروز تداخل، بسته به پیکربندی پیشرفته، ممکن است فایل بازنویسی شود یا نشود.
.SS گذرواژه صندوق پستی (https://proton.me/support/the-difference-between-the-mailbox-password-and-login-password)
.PP
لطفاً گذرواژه صندوق پستی خود را در بخش پیکربندی پیشرفته تنظیم کنید.
.SS نهان‌سازی (Caching)
.PP
حافظه نهان (کش) در حال حاضر برای حالتی طراحی شده است که rclone تنها نمونه‌ای باشد که عملیات را روی نقطه اتصال (mount point) انجام می‌دهد.
سیستم رویداد، که همان سیستم API پروتون برای آگاهی از تغییرات ایجادشده در درایو است، هنوز پیاده‌سازی نشده است؛ بنابراین به‌روزرسانی‌های کلاینت‌های دیگر در حافظه نهان منعکس نخواهند شد.
از این رو، اگر کلاینت‌های هم‌روند به یک نقطه اتصال مشترک دسترسی داشته باشند، ممکن است در نهان‌سازی داده‌های قدیمی و نامعتبر (stale data) مشکل ایجاد شود.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مخصوص protondrive (Proton Drive) آورده شده است.
.SS --protondrive-username
.PP
نام کاربری حساب proton شما
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: username
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_USERNAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --protondrive-password
.PP
گذرواژه حساب proton شما.
.PP
\f[B]توجه:\f[R] ورودی این گزینه باید مبهم‌سازی شود - دستور rclone obscure (https://rclone.org/commands/rclone_obscure) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: password
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --protondrive-2fa
.PP
کد 2FA
.PP
این مقدار می‌تواند با --protondrive-2fa=000000 نیز مشخص شود
.PP
کد 2FA حساب proton drive شما، در صورتی که حساب با احراز هویت دو مرحله‌ای پیکربندی شده باشد
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: 2fa
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_2FA
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --protondrive-otp-secret-key
.PP
کلید مخفی OTP
.PP
این مقدار می‌تواند با --protondrive-otp-secret-key=ABCDEFGHIJKLMNOPQRSTUVWXYZ234567 نیز مشخص شود
.PP
کلید مخفی OTP حساب proton drive شما، در صورتی که حساب با احراز هویت دو مرحله‌ای پیکربندی شده باشد
.PP
\f[B]توجه:\f[R] ورودی این گزینه باید مبهم‌سازی شود - دستور rclone obscure (https://rclone.org/commands/rclone_obscure) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: otp_secret_key
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_OTP_SECRET_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مختص protondrive (Proton Drive) آمده است.
.SS --protondrive-mailbox-password
.PP
گذرواژه صندوق پستی (mailbox password) حساب پروتون دوگذرواژه‌ای شما.
.PP
برای کسب اطلاعات بیشتر درباره گذرواژه صندوق پستی، لطفاً مقاله رسمی پایگاه دانش زیر را بررسی کنید:
https://proton.me/support/the-difference-between-the-mailbox-password-and-login-password
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی شود \- دستور rclone obscure (https://rclone.org/commands/rclone_obscure) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: mailbox_password
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_MAILBOX_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --protondrive-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر، بخش کدگذاری در نمای کلی (https://rclone.org/overview#encoding) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,LeftSpace,RightSpace,InvalidUtf8,Dot
.SS --protondrive-original-file-size
.PP
بازگرداندن اندازه فایل پیش از رمزنگاری
.PP
اندازه فایل رمزنگاری‌شده با اندازه فایل اصلی متفاوت (بزرگ‌تر) خواهد بود.
مگر اینکه دلیلی برای بازگرداندن اندازه فایل پس از انجام رمزنگاری وجود داشته باشد،
در غیر این صورت این گزینه را روی true تنظیم کنید، زیرا قابلیت‌هایی مانند Open()
که باید اندازه محتوای اصلی به آن‌ها داده شود، به درستی عمل نخواهند کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: original_file_size
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_ORIGINAL_FILE_SIZE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --protondrive-app-version
.PP
رشته نسخه برنامه
.IP
.nf
\f[C]
        رشته نسخه برنامه، کلاینتی را که در حال حاضر درخواست API را ارسال می‌کند،
        مشخص می‌سازد. یکپارچه‌سازی‌های شخص‌ثالث Proton Drive باید از قالب
        external-drive-<project>\[at]<version> استفاده کنند. اگر این گزینه خالی
        رها شود، rclone مقداری سازگار را از نسخه خودش استخراج می‌کند. این مقدار
        با هر درخواست API ارسال می‌شود؛ خود این گزینه اختیاری است.
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: app_version
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_APP_VERSION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --protondrive-replace-existing-draft
.PP
ایجاد یک بازبینی (revision) جدید هنگام تشخیص تداخل نام فایل
.PP
هنگامی که بارگذاری یک فایل لغو شود یا پیش از اتمام با شکست مواجه گردد، یک پیش‌نویس (draft) ایجاد خواهد شد و بارگذاری بعدی همان فایل در همان مکان، به عنوان یک تداخل گزارش می‌شود.
.PP
این مقدار می‌تواند با استفاده از --protondrive-replace-existing-draft=true نیز تنظیم شود.
.PP
اگر این گزینه روی true تنظیم شود، پیش‌نویس جایگزین شده و سپس عملیات بارگذاری از سر گرفته خواهد شد.
اگر کلاینت‌های دیگری نیز به طور هم‌زمان در حال بارگذاری در همان مکان فایل باشند، رفتار برنامه در حال حاضر نامشخص است.
برای آزمون‌های یکپارچه‌سازی (integration tests) باید مقدار آن روی true تنظیم شود.
اگر این گزینه روی false تنظیم گردد، خطای \[dq]a draft exist - usually this means a file is being uploaded at another client, or, there was a failed upload attempt\[dq] بازگردانده شده و هیچ بارگذاری انجام نخواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: replace_existing_draft
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_REPLACE_EXISTING_DRAFT
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --protondrive-enable-caching
.PP
کَش کردن فراداده‌های (metadata) فایل‌ها و پوشه‌ها برای کاهش فراخوانی‌های API
.PP
توجه: اگر ProtonDrive را به عنوان یک VFS سوار (mount) می‌کنید، لطفاً این قابلیت را غیرفعال کنید، زیرا پیاده‌سازی فعلی در صورت ایجاد تغییرات خارجی، کَش را به‌روزرسانی یا پاک نمی‌کند.
.PP
فایل‌ها و پوشه‌ها در ProtonDrive به صورت پیوندهایی همراه با دسته‌کلیدها (keyrings) نشان داده می‌شوند که برای بهبود عملکرد و کاهش بار روی سرور API، می‌توان آن‌ها را کَش کرد.
.PP
کَش در حال حاضر برای حالتی در نظر گرفته شده که rclone تنها نمونه‌ای باشد که روی نقطه اتصال (mount point) عملیات انجام می‌دهد.
سامانه رویداد (event system)، که سامانه API پروتون برای نمایش تغییرات رخ‌داده در درایو است، هنوز پیاده‌سازی نشده است؛ بنابراین به‌روزرسانی‌های ارسال‌شده از سوی سایر کلاینت‌ها در کَش اعمال نخواهند شد.
از این رو، اگر کلاینت‌های هم‌زمان به یک نقطه اتصال دسترسی داشته باشند، ممکن است در اثر استفاده از داده‌های کهنه (stale) در کَش با مشکل مواجه شویم.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: enable_caching
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_ENABLE_CACHING
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --protondrive-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS محدودیت‌ها (Limitations)
.PP
این backend از
Proton-API-Bridge (https://github.com/henrybear327/Proton-API-Bridge)
استفاده می‌کند که بر پایه
go-proton-api (https://github.com/henrybear327/go-proton-api)،
یک انشعاب از مخزن رسمی
(https://github.com/ProtonMail/go-proton-api) توسعه یافته است.
.PP
هیچ مستندات رسمی برای API از سوی Proton Drive ارائه نشده است.
اما به لطف متن‌باز شدن
proton-go-api (https://github.com/ProtonMail/go-proton-api)
و پایگاه‌کد کلاینت‌های تحت وب، iOS و Android توسط Proton، نیازی نیست که صرفاً با بررسی ترافیک کلاینت وب، APIها را به طور کامل مهندسی معکوس کنیم!
.PP
کتابخانه proton-go-api (https://github.com/ProtonMail/go-proton-api)
ساختارهای پایه‌ای فراخوانی‌های API و مدیریت خطا، مانند عقب‌نشینی نمایی (exponential back-off) خطای 429 را فراهم می‌کند، اما اساساً تنها یک رابط حداقلی (barebone) برای Proton API به شمار می‌رود.
به عنوان مثال، قابلیت‌های رمزگذاری و رمزگشایی فایل‌های Proton Drive در این کتابخانه ارائه نشده است.
.PP
پروژه Proton-API-Bridge تلاش می‌کند این کمبود را برطرف کند تا بتوان rclone را به سرعت بر بستر آن توسعه داد.
این پایگاه‌کد وظایف پیچیده قبل و بعد از فراخوانی Proton APIها، به ویژه طرح رمزگذاری پیچیده را مدیریت می‌کند و به توسعه‌دهندگان اجازه می‌دهد تا ویژگی‌های مورد نیاز سایر نرم‌افزارها را بر پایه آن پیاده‌سازی کنند.
از آنجا که مستندات رسمی در دسترس نیست، احتمالاً خطاهای متعددی در این کتابخانه وجود دارد..SH put.io
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرهای put.io می‌توانند به هر عمق دلخواهی باشند، مانند:
\f[V]remote:directory/subdirectory\f[R].
.SS "پیکربندی (Configuration)"
.PP
راه‌اندازی اولیه برای put.io نیازمند دریافت یک توکن (token) از put.io است که
باید آن را در مرورگر وب خود انجام دهید.
دستور \f[V]rclone config\f[R] شما را در این مراحل راهنمایی می‌کند.
.PP
در اینجا مثالی از نحوه ایجاد یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> putio
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / Put.io
   \[rs] \[dq]putio\[dq]
[snip]
Storage> putio
** See help for putio backend at: https://rclone.org/putio **

Remote config
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y) Yes
n) No
y/n> y
If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth
Log in and authorize rclone for access
Waiting for code...
Got code
--------------------
[putio]
type = putio
token = {\[dq]access_token\[dq]:\[dq]XXXXXXXX\[dq],\[dq]expiry\[dq]:\[dq]0001-01-01T00:00:00Z\[dq]}
--------------------
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
Current remotes:

Name                 Type
====                 ====
putio                putio

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> q
\f[R]
.fi
.PP
برای چگونگی راه‌اندازی آن روی دستگاهی بدون دسترسی به مرورگر وب متصل به اینترنت،
مستندات راه‌اندازی ریموت (<https://rclone.org/remote_setup>) را ببینید.
.PP
توجه داشته باشید که در صورت استفاده از مرورگر وب برای احراز هویت خودکار،
rclone یک وب‌سرور روی سیستم محلی شما اجرا می‌کند تا توکن بازگردانده شده از put.io را جمع‌آوری کند.
این سرور تنها از لحظه باز شدن مرورگر تا زمان دریافت کد تأیید اجرا می‌شود.
این سرویس روی \f[V]http://127.0.0.1:53682\f[R] فعال است و در صورت فعال بودن فایروال میزبان، ممکن است لازم باشد موقتاً آن را باز کنید یا از حالت دستی استفاده نمایید.
.PP
سپس می‌توانید به شکل زیر از آن استفاده کنید:
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح put.io شما:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در put.io شما:
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
کپی کردن یک دایرکتوری محلی به یک دایرکتوری در put.io به نام backup:
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS نویسه‌های محدودشده در نام فایل
.PP
علاوه بر مجموعه نویسه‌های محدودشدهٔ پیش‌فرض (https://rclone.org/overview/#restricted-characters)، نویسه‌های زیر نیز جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند شد (https://rclone.org/overview/#invalid-utf8)، زیرا نمی‌توان از آن‌ها در رشته‌های JSON استفاده کرد.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استانداردِ مختص putio (Put.io) آورده شده است.
.SS --putio-client-id
.PP
شناسه کلاینت OAuth.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_PUTIO_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --putio-client-secret
.PP
کلید محرمانه کلاینت OAuth.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_PUTIO_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفتهٔ مختص putio (Put.io) آورده شده است.
.SS --putio-token
.PP
توکن دسترسی OAuth در قالب یک بلوک داده JSON (JSON blob).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_PUTIO_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --putio-auth-url
.PP
نشانی URL سرور احراز هویت.
.PP
جهت استفاده از پیش‌فرض‌های ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_PUTIO_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --putio-token-url
.PP
آدرس اینترنتی (URL) سرور توکن.
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_PUTIO_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --putio-client-credentials
.PP
استفاده از جریان اعتبارسنجی کلاینت (OAuth flow).
.PP
این گزینه از OAUTH2 client Credentials Flow آن‌طور که در RFC
6749 شرح داده شده است، استفاده می‌کند.
.PP
توجه داشته باشید که این گزینه توسط همه backendها پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_PUTIO_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --putio-encoding
.PP
کدگذاری (encoding) برای backend.
.PP
برای اطلاعات بیشتر، بخش encoding را در نمای
کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_PUTIO_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot
.SS --putio-description
.PP
توضیحات ریموت (remote).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_PUTIO_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS محدودیت‌ها (Limitations)
.PP
سرویس put.io دارای محدودیت نرخ درخواست (rate limiting) است.
هنگامی که به یک محدودیت برخورد کنید، rclone پس از انتظار به میزان زمان درخواستی توسط سرور، به‌طور خودکار تلاش مجدد می‌کند.
.PP
اگر می‌خواهید هرگز با این محدودیت‌ها مواجه نشوید، می‌توانید از پرچم
\f[V]--tpslimit\f[R] با یک مقدار کم استفاده کنید.
توجه داشته باشید که محدودیت‌های اعمال‌شده ممکن است برای عملیات مختلف متفاوت باشند،
و ممکن است در طول زمان تغییر کنند.
.SH Proton Drive
.PP
سرویس Proton Drive (https://proton.me/drive) یک گاوصندوق ابری سوئیسی با رمزگذاری سرتاسری (end-to-end encrypted) برای فایل‌های شماست که از داده‌هایتان محافظت می‌کند.
.PP
این یک backend در rclone برای Proton Drive است که از قابلیت‌های انتقال فایل Proton Drive با بهره‌گیری از همان رمزگذاری سمت کلاینت پشتیبانی می‌کند.
.PP
با توجه به این که Proton Drive مستندات API خود را منتشر نمی‌کند، این backend با نهایت تلاش از طریق بررسی کد منبعِ متن‌باز کلاینت و تحلیل ترافیک Proton Drive در مرورگر پیاده‌سازی شده است.
.PP
\f[B]توجه:\f[R] این backend در حال حاضر در وضعیت آزمایشی (Beta) قرار دارد.
عملکرد آن معتبر ارزیابی شده و تمامی آزمون‌های یکپارچه‌سازی را با موفقیت می‌گذراند.
با این حال، پروتکل Proton Drive در طول زمان تغییر یافته است و ممکن است حساب‌هایی وجود داشته باشند که با آن سازگار نباشند.
لطفاً در صورت مشاهده هرگونه ناسازگاری، موضوع را در تالار گفتگوی rclone (https://forum.rclone.org) مطرح کنید.
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند تا هر عمق مورد نیازی مشخص شوند، به عنوان مثال:
\f[V]remote:directory/subdirectory\f[R]..SS پیکربندی‌ها
.PP
در اینجا مثالی از نحوه ساخت یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرآیند راه‌اندازی تعاملی هدایت می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Proton Drive
   \[rs] \[dq]protondrive\[dq]
[snip]
Storage> protondrive
User name
user> you\[at]protonmail.com
Password.
y) Yes type in my own password
g) Generate random password
n) No leave this optional password blank
y/g/n> y
Enter the password:
password:
Confirm the password:
password:
Option 2fa.
2FA code (if the account requires one)
Enter a value. Press Enter to leave empty.
2fa> 123456
Remote config
Configuration complete.
Options:
- type: protondrive
- user: you\[at]protonmail.com
- pass: *** ENCRYPTED ***
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
\f[B]نکته:\f[R] کلیدهای رمزنگاری Proton Drive باید از قبل و از طریق یک ورود عادی با مرورگر ایجاد شده باشند، در غیر این صورت تلاش برای استفاده از اطلاعات کاربری در \f[V]rclone\f[R] ناموفق خواهد بود.
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به شکل زیر استفاده کنید (\f[V]remote\f[R] را با نامی که برای ریموت خود تعیین کرده‌اید جایگزین کنید):
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح Proton Drive شما
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمامی فایل‌ها در Proton Drive شما
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به دایرکتوری با نام backup در Proton Drive
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها
.PP
پل Proton Drive هنوز از به‌روزرسانی زمان‌های تغییر پشتیبانی نمی‌کند.
.PP
الگوریتم هش SHA1 پشتیبانی می‌شود.
.SS نویسه‌های محدودشده در نام فایل
.PP
بایت‌های نامعتبر UTF-8 جایگزین خواهند شد (https://rclone.org/overview/#invalid-utf8)، همچنین فاصله‌های ابتدا و انتها حذف می‌شوند (ارجاع به کد (https://github.com/ProtonMail/WebClients/blob/b4eba99d241af4fdae06ff7138bd651a40ef5d3c/applications/drive/src/app/store/_links/validation.ts#L51)).
.SS فایل‌های تکراری
.PP
در Proton Drive نمی‌توان دو فایل با نام و مسیر دقیقاً یکسان داشت.
در صورت بروز تداخل، بسته به پیکربندی پیشرفته، ممکن است فایل بازنویسی شود یا نشود.
.SS گذرواژهٔ صندوق پستی (https://proton.me/support/the-difference-between-the-mailbox-password-and-login-password)
.PP
لطفاً گذرواژهٔ صندوق پستی (mailbox password) خود را در بخش پیکربندی پیشرفته تنظیم کنید.
.SS حافظه‌پنهان‌سازی (Caching)
.PP
حافظهٔ پنهان در حال حاضر برای شرایطی طراحی شده است که rclone تنها نمونهٔ در حال انجام عملیات روی نقطهٔ اتصال (mount point) باشد.
سیستم رویدادها (event system)، که همان سیستم رابط برنامه‌نویسی (API) پروتون برای آگاهی از تغییرات ایجادشده روی درایو است، هنوز پیاده‌سازی نشده است؛ بنابراین تغییرات اعمال‌شده از سوی دیگر کلاینت‌ها در حافظهٔ پنهان منعکس نخواهد شد.
از این رو، اگر کلاینت‌های هم‌زمان به یک نقطهٔ اتصال مشترک دسترسی داشته باشند، ممکن است با مشکل ذخیره‌سازی داده‌های قدیمی (stale) در حافظهٔ پنهان مواجه شویم.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مربوط به protondrive (Proton Drive) آورده شده است.
.SS --protondrive-username
.PP
نام کاربری حساب پروتون شما.
.PP
ویژگی‌ها:
.IP \[bu] 2
Config: username
.IP \[bu] 2
Env Var: RCLONE_PROTONDRIVE_USERNAME
.IP \[bu] 2
Type: string
.IP \[bu] 2
Required: true
.SS --protondrive-password
.PP
گذرواژهٔ حساب پروتون شما.
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی شود - مستندات rclone obscure را ببینید (https://rclone.org/commands/rclone_obscure).
.PP
ویژگی‌ها:
.IP \[bu] 2
Config: password
.IP \[bu] 2
Env Var: RCLONE_PROTONDRIVE_PASSWORD
.IP \[bu] 2
Type: string
.IP \[bu] 2
Required: true
.SS --protondrive-2fa
.PP
کد اعتبارسنجی دومرحله‌ای (2FA).
.PP
این مقدار می‌تواند با استفاده از --protondrive-2fa=000000 نیز تعیین شود.
.PP
کد 2FA حساب پروتون درایو شما در صورتی که احراز هویت دومرحله‌ای برای حساب فعال شده باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
Config: 2fa
.IP \[bu] 2
Env Var: RCLONE_PROTONDRIVE_2FA
.IP \[bu] 2
Type: string
.IP \[bu] 2
Required: false
.SS --protondrive-otp-secret-key
.PP
کلید مخفی OTP.
.PP
این مقدار می‌تواند با استفاده از --protondrive-otp-secret-key=ABCDEFGHIJKLMNOPQRSTUVWXYZ234567 نیز تعیین شود.
.PP
کلید مخفی OTP حساب پروتون درایو شما در صورتی که حساب با احراز هویت دومرحله‌ای تنظیم شده باشد.
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی شود - مستندات rclone obscure را ببینید (https://rclone.org/commands/rclone_obscure).
.PP
ویژگی‌ها:
.IP \[bu] 2
Config: otp_secret_key
.IP \[bu] 2
Env Var: RCLONE_PROTONDRIVE_OTP_SECRET_KEY
.IP \[bu] 2
Type: string
.IP \[bu] 2
Required: false.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفتهٔ ویژهٔ protondrive (Proton Drive) آورده شده‌اند.
.SS --protondrive-mailbox-password
.PP
گذرواژهٔ صندوق پستیِ حساب Proton دوگذرواژه‌ای شما.
.PP
برای اطلاعات بیشتر در رابطه با گذرواژهٔ صندوق پستی، لطفاً مقالهٔ پایگاه دانش رسمی زیر را بررسی کنید:
https://proton.me/support/the-difference-between-the-mailbox-password-and-login-password
.PP
\f[B]توجه:\f[R] ورودی این مقدار باید مبهم‌سازی شود - rclone obscure (https://rclone.org/commands/rclone_obscure) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: mailbox_password
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_MAILBOX_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --protondrive-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر بخش کدگذاری در بررسی اجمالی (https://rclone.org/overview/#encoding) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,LeftSpace,RightSpace,InvalidUtf8,Dot
.SS --protondrive-original-file-size
.PP
بازگرداندن اندازهٔ فایل پیش از رمزگذاری
.PP
اندازهٔ فایل رمزگذاری‌شده با اندازهٔ فایل اصلی متفاوت (بزرگ‌تر) خواهد بود.
مگر اینکه دلیلی برای بازگرداندن اندازهٔ فایل پس از انجام رمزگذاری وجود داشته باشد، در غیر این صورت این گزینه را روی true تنظیم کنید؛ چرا که قابلیت‌هایی مانند Open() که نیازمند دریافت اندازهٔ محتوای اصلی هستند، به‌درستی عمل نخواهند کرد
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: original_file_size
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_ORIGINAL_FILE_SIZE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --protondrive-app-version
.PP
رشتهٔ نگارش برنامه
.IP
.nf
\f[C]
        رشتهٔ نگارش برنامه، کلاینتی را که در حال حاضر درخواست API را ارسال
        می‌کند شناسایی می‌نماید. یکپارچه‌سازی‌های شخص ثالث با Proton Drive
        باید از قالب external-drive-<project>\[at]<version> استفاده کنند. اگر
        این گزینه خالی رها شود، rclone مقداری سازگار را از نگارش خود مشتق
        می‌کند. این مقدار با هر درخواست API ارسال می‌شود؛ خود این گزینه
        اختیاری است.
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: app_version
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_APP_VERSION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --protondrive-replace-existing-draft
.PP
ایجاد یک بازبینی (revision) جدید هنگام تشخیص تداخل نام فایل
.PP
هنگامی که بارگذاری یک فایل پیش از اتمام لغو شده یا با شکست مواجه شود، یک پیش‌نویس (draft) ایجاد می‌شود و بارگذاری بعدی همان فایل در همان مکان، به عنوان تداخل گزارش خواهد شد.
.PP
این مقدار می‌تواند با --protondrive-replace-existing-draft=true نیز تنظیم شود.
.PP
اگر این گزینه بر روی true تنظیم شود، پیش‌نویس جایگزین شده و سپس عملیات بارگذاری مجدداً آغاز می‌شود.
اگر کلاینت‌های دیگری نیز هم‌زمان در همان مکان فایل در حال بارگذاری باشند، رفتار آن در حال حاضر نامشخص است.
برای آزمون‌های یکپارچه‌سازی (integration tests) باید روی true تنظیم شود.
اگر این گزینه روی false تنظیم شود، خطای \[dq]a draft exist - usually this means a file is being uploaded at another client, or, there was a failed upload attempt\[dq] بازگردانده شده و هیچ بارگذاری‌ای انجام نخواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: replace_existing_draft
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_REPLACE_EXISTING_DRAFT
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --protondrive-enable-caching
.PP
فراداده‌های (metadata) فایل‌ها و پوشه‌ها را برای کاهش فراخوانی‌های API کَش می‌کند
.PP
توجه: اگر ProtonDrive را به عنوان یک VFS سوار (mount) می‌کنید، لطفاً این قابلیت را غیرفعال کنید، زیرا پیاده‌سازی فعلی هنگام ایجاد تغییرات خارجی، کَش را به‌روزرسانی یا پاک نمی‌کند.
.PP
فایل‌ها و پوشه‌ها در ProtonDrive به صورت پیوندهایی با دسته‌کلیدها (keyrings) نشان داده می‌شوند که می‌توان برای بهبود کارایی و کاهش بار روی سرور API، آن‌ها را کَش کرد.
.PP
این کَش در حال حاضر برای حالتی ساخته شده است که rclone تنها نمونه‌ای باشد که روی نقطه اتصال (mount point) عملیات انجام می‌دهد.
سیستم رویداد (event system) که سازوکار Proton API برای نمایش تغییرات در درایو است، هنوز پیاده‌سازی نشده است؛ بنابراین به‌روزرسانی‌های کلاینت‌های دیگر در کَش بازتاب نخواهند یافت.
از این رو، اگر کلاینت‌های هم‌روند به طور هم‌زمان به همان نقطه اتصال دسترسی داشته باشند، ممکن است با مشکل کَش شدن داده‌های کهنه (stale) مواجه شویم.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: enable_caching
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_ENABLE_CACHING
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --protondrive-description
.PP
توضیحات ریموت (remote).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_PROTONDRIVE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS "محدودیت‌ها (Limitations)"
.PP
این بک‌اند از
Proton-API-Bridge (https://github.com/henrybear327/Proton-API-Bridge)
استفاده می‌کند که بر پایه
go-proton-api (https://github.com/henrybear327/go-proton-api)،
انشعابی از مخزن رسمی
(https://github.com/ProtonMail/go-proton-api)
است.
.PP
هیچ مستندات رسمی برای API از سوی Proton Drive ارائه نشده است.
اما به لطف متن‌باز شدن
proton-go-api (https://github.com/ProtonMail/go-proton-api)
و پایه‌کدهای کلاینت وب، iOS و Android توسط Proton، نیازی نیست APIها را صرفاً با رصد ترافیک کلاینت وب به طور کامل مهندسی معکوس کنیم!
.PP
کتابخانه proton-go-api (https://github.com/ProtonMail/go-proton-api)
بخش‌های بنیادین فراخوانی‌های API و مدیریت خطاها، مانند عقب‌نشینی نمایی (exponential back-off) برای خطای 429 را فراهم می‌کند، اما اساساً تنها یک رابط کاربری حداقلی (barebone) برای Proton API است.
به عنوان مثال، رمزگذاری و رمزگشایی فایل Proton Drive در این کتابخانه ارائه نشده است.
.PP
پروژه Proton-API-Bridge تلاش می‌کند این کمبود را برطرف کند تا rclone بتواند به سرعت بر پایه آن توسعه یابد.
این پایه‌کد وظایف پیچیده قبل و بعد از فراخوانی Proton API، به‌ویژه طرح رمزنگاری پیچیده را مدیریت می‌کند و به توسعه‌دهندگان اجازه می‌دهد قابلیت‌هایی را برای سایر نرم‌افزارها بر روی این پایه‌کد پیاده‌سازی کنند.
از آنجا که مستندات رسمی در دسترس نیست، احتمالاً خطاهایی در این کتابخانه وجود دارد..SH Seafile
.PP
این یک بک‌اند برای سرویس ذخیره‌سازی Seafile (https://www.seafile.com) است:
.IP \[bu] 2
هم با نسخهٔ رایگان و عمومی (Community Edition) و هم با نسخهٔ حرفه‌ای (Professional Edition) کار می‌کند.
.IP \[bu] 2
تمام نسخه‌های 6.x، 7.x، 8.x و 9.x از Seafile پشتیبانی می‌شوند.
.IP \[bu] 2
کتابخانه‌های رمزنگاری‌شده نیز پشتیبانی می‌شوند.
.IP \[bu] 2
از کاربرانی با احراز هویت دو مرحله‌ای (2FA) فعال پشتیبانی می‌کند.
.IP \[bu] 2
استفاده از توکن واسط برنامه‌نویسی کتابخانه (Library API Token) پشتیبانی \f[B]نمی‌شود\f[R].
.SS "پیکربندی (Configuration)"
.PP
دو حالت مجزا برای راه‌اندازی ریموت شما وجود دارد:
.IP \[bu] 2
ریموت خود را به \f[B]ریشهٔ سرور\f[R] متصل می‌کنید، به این معنی که در طول پیکربندی هیچ کتابخانه‌ای را مشخص نمی‌کنید: مسیرها به صورت \f[V]remote:library\f[R] مشخص می‌شوند.
همچنین می‌توانید زیرپوشه‌ها را نیز وارد کنید، مانند
\f[V]remote:library/path/to/dir\f[R].
.IP \[bu] 2
در حین پیکربندی، ریموت خود را به یک کتابخانهٔ خاص متصل می‌کنید:
مسیرها به صورت \f[V]remote:path/to/dir\f[R] مشخص می‌شوند.
\f[B]در صورت استفاده از کتابخانه‌های رمزنگاری‌شده، این حالت توصیه می‌شود\f[R].
(\f[I]این حالت احتمالاً کمی سریع‌تر از حالت ریشه است\f[R])
.SS "پیکربندی در حالت ریشه (Configuration in root mode)"
.PP
در اینجا مثالی از ایجاد پیکربندی seafile برای کاربری \f[B]بدون\f[R] احراز هویت دو مرحله‌ای آورده شده است.
ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند.
برای احراز هویت به نشانی URL سرور، ایمیل (یا نام کاربری) و گذرواژهٔ خود نیاز خواهید داشت.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> seafile
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / Seafile
   \[rs] \[dq]seafile\[dq]
[snip]
Storage> seafile
** See help for seafile backend at: https://rclone.org/seafile **

URL of seafile host to connect to
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / Connect to cloud.seafile.com
   \[rs] \[dq]https://cloud.seafile.com\[dq]
url> http://my.seafile.server
User name (usually email address)
Enter a string value. Press Enter for the default (\[dq]\[dq]).
user> me\[at]example.com
Password
y) Yes type in my own password
g) Generate random password
n) No leave this optional password blank (default)
y/g> y
Enter the password:
password:
Confirm the password:
password:
Two-factor authentication (\[aq]true\[aq] if the account has 2FA enabled)
Enter a boolean value (true or false). Press Enter for the default (\[dq]false\[dq]).
2fa> false
Name of the library. Leave blank to access all non-encrypted libraries.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
library>
Library password (for encrypted libraries only). Leave blank if you pass it through the command line.
y) Yes type in my own password
g) Generate random password
n) No leave this optional password blank (default)
y/g/n> n
Edit advanced config? (y/n)
y) Yes
n) No (default)
y/n> n
Remote config
Two-factor authentication is not enabled on this account.
--------------------
[seafile]
type = seafile
url = http://my.seafile.server
user = me\[at]example.com
pass = *** ENCRYPTED ***
2fa = false
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
نام این ریموت \f[V]seafile\f[R] گذاشته شده است.
این ریموت به ریشهٔ سرور seafile شما اشاره می‌کند و اکنون می‌توانید به صورت زیر از آن استفاده کنید:
.PP
مشاهدهٔ تمام کتابخانه‌ها
.IP
.nf
\f[C]
rclone lsd seafile:
\f[R]
.fi
.PP
ایجاد یک کتابخانهٔ جدید
.IP
.nf
\f[C]
rclone mkdir seafile:library
\f[R]
.fi
.PP
فهرست کردن محتویات یک کتابخانه
.IP
.nf
\f[C]
rclone ls seafile:library
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با کتابخانهٔ ریموت و حذف تمام فایل‌های اضافی در آن کتابخانه.
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory seafile:library
\f[R]
.fi.SS پیکربندی در حالت کتابخانه
.PP
در اینجا نمونه‌ای از پیکربندی در حالت کتابخانه با کاربری که احراز هویت دومرحله‌ای (2FA) را فعال کرده، آورده شده است.
کد 2FA شما در انتهای پیکربندی پرسیده خواهد شد و سعی می‌شود تا هویت شما تأیید شود:
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> seafile
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / Seafile
   \[rs] \[dq]seafile\[dq]
[snip]
Storage> seafile
** See help for seafile backend at: https://rclone.org/seafile **

URL of seafile host to connect to
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
 1 / Connect to cloud.seafile.com
   \[rs] \[dq]https://cloud.seafile.com\[dq]
url> http://my.seafile.server
User name (usually email address)
Enter a string value. Press Enter for the default (\[dq]\[dq]).
user> me\[at]example.com
Password
y) Yes type in my own password
g) Generate random password
n) No leave this optional password blank (default)
y/g> y
Enter the password:
password:
Confirm the password:
password:
Two-factor authentication (\[aq]true\[aq] if the account has 2FA enabled)
Enter a boolean value (true or false). Press Enter for the default (\[dq]false\[dq]).
2fa> true
Name of the library. Leave blank to access all non-encrypted libraries.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
library> My Library
Library password (for encrypted libraries only). Leave blank if you pass it through the command line.
y) Yes type in my own password
g) Generate random password
n) No leave this optional password blank (default)
y/g/n> n
Edit advanced config? (y/n)
y) Yes
n) No (default)
y/n> n
Remote config
Two-factor authentication: please enter your 2FA code
2fa code> 123456
Authenticating...
Success!
--------------------
[seafile]
type = seafile
url = http://my.seafile.server
user = me\[at]example.com
pass = 
2fa = true
library = My Library
--------------------
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
متوجه خواهید شد که گذرواژه شما در پیکربندی خالی است.
زیرا گذرواژه تنها یک‌بار برای احراز هویت شما مورد نیاز است.
.PP
شما در حین پیکربندی \f[V]My Library\f[R] را مشخص کردید.
ریشه این ریموت به ریشه کتابخانه \f[V]My Library\f[R] اشاره می‌کند:
.PP
مشاهده تمام فایل‌های درون کتابخانه:
.IP
.nf
\f[C]
rclone lsd seafile:
\f[R]
.fi
.PP
ایجاد یک دایرکتوری جدید درون کتابخانه:
.IP
.nf
\f[C]
rclone mkdir seafile:directory
\f[R]
.fi
.PP
فهرست کردن محتویات یک دایرکتوری:
.IP
.nf
\f[C]
rclone ls seafile:directory
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با کتابخانه ریموت، با حذف فایل‌های اضافی در کتابخانه:
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory seafile:
\f[R]
.fi.SS --fast-list
.PP
نسخه ۷ به بالای Seafile از \f[V]--fast-list\f[R] پشتیبانی می‌کند که به شما امکان می‌دهد در ازای مصرف حافظه بیشتر، از تراکنش‌های کمتری استفاده کنید.
برای جزئیات بیشتر به مستندات rclone (https://rclone.org/docs/#fast-list) مراجعه کنید.
لطفاً توجه داشته باشید که این مورد در کارساز seafile نسخه 6.x پشتیبانی نمی‌شود.
.SS نویسه‌های محدودشده نام فایل
.PP
علاوه بر مجموعه نویسه‌های محدودشده پیش‌فرض (https://rclone.org/overview/#restricted-characters)، نویسه‌های زیر نیز جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
/
T}@T{
0x2F
T}@T{
／
T}
T{
\[dq]
T}@T{
0x22
T}@T{
＂
T}
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند شد (https://rclone.org/overview/#invalid-utf8)، زیرا نمی‌توان از آن‌ها در رشته‌های JSON استفاده کرد.
.SS Seafile و rclone link
.PP
ابزار Rclone فقط از ایجاد پیوندهای اشتراک‌گذاری برای کتابخانه‌های غیررمزگذاری‌شده پشتیبانی می‌کند.
این پیوندها می‌توانند برای یک فایل یا یک دایرکتوری باشند:
.IP
.nf
\f[C]
$ rclone link seafile:seafile-tutorial.doc
http://my.seafile.server/f/fdcd8a2f93f84b8b90f4
\f[R]
.fi
.PP
یا در صورت اجرا روی یک دایرکتوری، خروجی زیر را دریافت خواهید کرد:
.IP
.nf
\f[C]
$ rclone link seafile:dir
http://my.seafile.server/d/9ea2455f6f55478bbb0d
\f[R]
.fi
.PP
لطفاً توجه داشته باشید که پیوند اشتراک‌گذاری برای هر فایل یا دایرکتوری یکتا است.
اگر دستور link را روی یک فایل یا دایرکتوری که از قبل به اشتراک گذاشته شده است اجرا کنید، دقیقاً همان پیوند را دریافت خواهید کرد.
.SS سازگاری
.PP
این قابلیت با استفاده از تصویر داکر seafile (https://github.com/haiwen/seafile-docker) بر روی این نسخه‌ها به‌طور فعال توسعه یافته است:
.IP \[bu] 2
ویرایش جامعه 6.3.4
.IP \[bu] 2
ویرایش جامعه 7.0.5
.IP \[bu] 2
ویرایش جامعه 7.1.3
.IP \[bu] 2
ویرایش جامعه 9.0.10
.PP
نسخه‌های پایین‌تر از 6.0 پشتیبانی نمی‌شوند.
نسخه‌های بین 6.0 و 6.3 آزمایش نشده‌اند و ممکن است به‌درستی کار نکنند.
.PP
هر نسخه جدید از \f[V]rclone\f[R] به‌طور خودکار در برابر آخرین تصویر داکر (https://hub.docker.com/r/seafileltd/seafile-mc) کارساز جامعه seafile آزمایش می‌شود..SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص به seafile (seafile) آمده است.
.SS --seafile-url
.PP
نشانی اینترنتی (URL) میزبان seafile برای اتصال.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: url
.IP \[bu] 2
متغیر محیطی: RCLONE_SEAFILE_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]https://cloud.seafile.com\[dq]
.RS 2
.IP \[bu] 2
اتصال به cloud.seafile.com.
.RE
.RE
.SS --seafile-user
.PP
نام کاربری (معمولاً نشانی ایمیل).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user
.IP \[bu] 2
متغیر محیطی: RCLONE_SEAFILE_USER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --seafile-pass
.PP
گذرواژه.
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی شود \- به rclone obscure (https://rclone.org/commands/rclone_obscure) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pass
.IP \[bu] 2
متغیر محیطی: RCLONE_SEAFILE_PASS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --seafile-2fa
.PP
احراز هویت دو مرحله‌ای (\[aq]true\[aq] اگر حساب کاربری دارای 2FA فعال باشد).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: 2fa
.IP \[bu] 2
متغیر محیطی: RCLONE_SEAFILE_2FA
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --seafile-library
.PP
نام کتابخانه.
.PP
برای دسترسی به همه کتابخانه‌های رمزگذاری‌نشده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: library
.IP \[bu] 2
متغیر محیطی: RCLONE_SEAFILE_LIBRARY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --seafile-library-key
.PP
گذرواژهٔ کتابخانه (تنها برای کتابخانه‌های رمزگذاری‌شده).
.PP
اگر آن را از طریق خط فرمان ارسال می‌کنید، خالی بگذارید.
.PP
\f[B]توجه:\f[R] ورودی این گزینه باید مبهم‌سازی (obscure) شود - دستور rclone
obscure (https://rclone.org/commands/rclone_obscure) را ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: library_key
.IP \[bu] 2
متغیر محیطی: RCLONE_SEAFILE_LIBRARY_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفتهٔ مختص seafile (seafile) آورده شده است.
.SS --seafile-create-library
.PP
آیا rclone در صورت عدم وجود کتابخانه باید آن را ایجاد کند یا خیر.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: create_library
.IP \[bu] 2
متغیر محیطی: RCLONE_SEAFILE_CREATE_LIBRARY
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --seafile-encoding
.PP
کدگذاری برای بک‌اند.
.PP
برای اطلاعات بیشتر بخش کدگذاری را در
بررسی اجمالی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_SEAFILE_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,DoubleQuote,BackSlash,Ctl,InvalidUtf8,Dot
.SS --seafile-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_SEAFILE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SH SFTP
.PP
پروتکل SFTP همان پروتکل امن (یا SSH) انتقال
فایل است (https://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol).
.PP
بک‌اند SFTP را می‌توان با چندین ارائه‌دهندهٔ مختلف استفاده کرد:
.IP \[bu] 2
Hetzner Storage Box
.IP \[bu] 2
rsync.net
.PP
پروتکل SFTP بر بستر SSH v2 اجرا می‌شود و به‌صورت استاندارد در اکثر
نصب‌های امروزی SSH وجود دارد.
.PP
مسیرها به‌صورت \f[V]remote:path\f[R] مشخص می‌شوند.
اگر مسیر با یک \f[V]/\f[R] آغاز نشود، نسبت به دایرکتوری خانگی کاربر
در نظر گرفته می‌شود.
مسیر خالی \f[V]remote:\f[R] به دایرکتوری خانگی کاربر اشاره دارد.
برای نمونه، دستور \f[V]rclone lsd remote:\f[R] دایرکتوری خانگی کاربری را که در
پیکربندی ریموت rclone تنظیم شده است فهرست می‌کند
(\f[V]یعنی /home/sftpuser\f[R]).
با این حال، \f[V]rclone lsd remote:/\f[R] دایرکتوری ریشهٔ دستگاه دوردست را
فهرست می‌کند (یعنی
\f[V]/\f[R]).
.PP
توجه داشته باشید که برخی از کارگزارهای SFTP به / ابتدایی نیاز دارند - Synology
نمونهٔ بارزی از این مورد است.
از سوی دیگر، rsync.net و Hetzner از کاربران می‌خواهند که / ابتدایی را
حذف کنند.
.PP
توجه داشته باشید که به‌طور پیش‌فرض rclone تلاش می‌کند دستورهای پوسته را
روی کارگزار اجرا کند؛ ملاحظات دسترسی پوسته (shell access considerations) را ببینید..SS "پیکربندی (Configuration)"
.PP
در اینجا نمونه‌ای از ایجاد یک پیکربندی SFTP آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / SSH/SFTP
   \[rs] \[dq]sftp\[dq]
[snip]
Storage> sftp
SSH host to connect to
Choose a number from below, or type in your own value
 1 / Connect to example.com
   \[rs] \[dq]example.com\[dq]
host> example.com
SSH username
Enter a string value. Press Enter for the default (\[dq]$USER\[dq]).
user> sftpuser
SSH port number
Enter a signed integer. Press Enter for the default (22).
port>
SSH password, leave blank to use ssh-agent.
y) Yes type in my own password
g) Generate random password
n) No leave this optional password blank
y/g/n> n
Path to unencrypted PEM-encoded private key file, leave blank to use ssh-agent.
key_file>
Remote config
Configuration complete.
Options:
- type: sftp
- host: example.com
- user: sftpuser
- port:
- pass:
- key_file:
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
این ریموت \f[V]remote\f[R] نام‌گذاری شده است و اکنون می‌توان از آن به این شکل استفاده کرد:
.PP
مشاهده تمام دایرکتوری‌ها در دایرکتوری خانگی (home):
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
مشاهده تمام دایرکتوری‌ها در دایرکتوری ریشه (root):
.IP
.nf
\f[C]
rclone lsd remote:/
\f[R]
.fi
.PP
ایجاد یک دایرکتوری جدید:
.IP
.nf
\f[C]
rclone mkdir remote:path/to/directory
\f[R]
.fi
.PP
فهرست کردن محتویات یک دایرکتوری:
.IP
.nf
\f[C]
rclone ls remote:path/to/directory
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با دایرکتوری دوردست، همراه با حذف
فایل‌های اضافی موجود در دایرکتوری:
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory remote:directory
\f[R]
.fi
.PP
سوار کردن (mount) مسیر دوردست \f[V]/srv/www-data/\f[R] روی مسیر محلی
\f[V]/mnt/www-data\f[R]:
.IP
.nf
\f[C]
rclone mount remote:/srv/www-data/ /mnt/www-data
\f[R]
.fi.SS "احراز هویت SSH"
.PP
ریموت SFTP از سه روش احراز هویت پشتیبانی می‌کند:
.IP \[bu] 2
گذرواژه
.IP \[bu] 2
فایل کلید، شامل کلیدهای امضاشده با گواهی
.IP \[bu] 2
ssh-agent
.PP
فایل‌های کلید باید فایل‌های کلید خصوصی با کدگذاری PEM باشند.
برای نمونه \f[V]/home/$USER/.ssh/id_rsa\f[R].
تنها فایل‌های رمزنشدۀ OpenSSH یا رمزشده با PEM پشتیبانی می‌شوند.
.PP
فایل کلید را می‌توان در یک فایل خارجی (key_file) مشخص کرد یا
درون فایل پیکربندی rclone قرار داد (key_pem).
در صورت استفاده از key_pem در فایل پیکربندی، ورودی باید در یک
خط واحد باشد و خط جدید (\[aq]\[aq] یا \[aq]\[aq]) خطوط را از هم جدا کند؛
یعنی:
.IP
.nf
\f[C]
key_pem = -----BEGIN RSA PRIVATE KEY-----\[rs]nMaMbaIXtE\[rs]n0gAMbMbaSsd\[rs]nMbaass\[rs]n-----END RSA PRIVATE KEY-----
\f[R]
.fi
.PP
این دستور آن را برای استفاده در فایل پیکربندی جهت مقدار key_pem به‌طور صحیح تولید می‌کند:
.IP
.nf
\f[C]
awk \[aq]{printf \[dq]%s\[rs]\[rs]n\[dq], $0}\[aq] < \[ti]/.ssh/id_rsa
\f[R]
.fi
.PP
اگر \f[V]pass\f[R]، \f[V]key_file\f[R]، یا
\f[V]key_pem\f[R] یا \f[V]ask_password\f[R] را مشخص نکنید، rclone تلاش خواهد کرد
تا با یک ssh-agent ارتباط برقرار کند.
همچنین می‌توانید \f[V]key_use_agent\f[R] را تعیین کنید تا استفاده از یک
ssh-agent اجباری شود.
در این حالت، می‌توان \f[V]key_file\f[R] یا \f[V]key_pem\f[R] را نیز
برای اجبار به استفاده از یک کلید خاص در ssh-agent تعیین کرد.
.PP
در حال حاضر استفاده از یک ssh-agent تنها راه برای بارگذاری کلیدهای رمزشدهٔ OpenSSH
است.
.PP
اگر گزینهٔ \f[V]ask_password\f[R] را تنظیم کنید، rclone در صورت نیاز و زمانی که هیچ
گذرواژه‌ای پیکربندی نشده باشد، درخواست گذرواژه خواهد کرد.
.SS "کلیدهای امضاشده با گواهی"
.PP
در احراز هویت سنتی مبتنی بر کلید، شما فقط کلید خصوصی خود را
پیکربندی می‌کنید و کلید عمومی تعبیه‌شده در آن در طول فرایند
احراز هویت استفاده خواهد شد.
.PP
اگر گواهی دارید، می‌توانید از آن برای امضای کلید عمومی خود استفاده کنید،
که یک گواهی کاربر SSH جداگانه ایجاد می‌کند و باید به جای
کلید عمومی سادهٔ استخراج‌شده از کلید خصوصی استفاده شود.
سپس باید مسیر فایل کلید عمومی گواهی کاربر را
در \f[V]pubkey_file\f[R] یا محتوای فایل را در \f[V]pubkey\f[R] مشخص کنید.
.PP
نکته: این فایل همان کلید عمومی سنتی جفت‌شده با کلید خصوصی شما
که معمولاً در \f[V]/home/$USER/.ssh/id_rsa.pub\f[R] ذخیره می‌شود، نیست.
تنظیم این مسیر در \f[V]pubkey_file\f[R] کار نخواهد کرد.
.PP
مثال:
.IP
.nf
\f[C]
[remote]
type = sftp
host = example.com
user = sftpuser
key_file = \[ti]/id_rsa
pubkey_file = \[ti]/id_rsa-cert.pub
\f[R]
.fi
.PP
اگر یک گواهی را با یک کلید خصوصی ادغام (الحاق) کنید، می‌توانید فایل
ادغام‌شده را در هر دو مکان مشخص کنید.
.PP
نکته: گواهی باید ابتدا در فایل قرار گیرد.
برای نمونه:
.IP
.nf
\f[C]
cat id_rsa-cert.pub id_rsa > merged_key
\f[R]
.fi.SS اعتبارسنجی کلید میزبان (Host key validation)
.PP
به‌طور پیش‌فرض، rclone کلید میزبان سرور را برای اعتبارسنجی بررسی نمی‌کند.
این موضوع می‌تواند به یک مهاجم اجازه دهد تا سرور را با سرور خود جایگزین کند و چنانچه از احراز هویت با گذرواژه استفاده کنید، ممکن است منجر به افشای آن گذرواژه شود.
هر بار که backend در این حالت راه‌اندازی شود، rclone هشدار
\f[V]No host key validation is being performed\f[R] را صادر خواهد کرد.
.PP
تطبیق کلید میزبان با استفاده از فایل‌های استاندارد \f[V]known_hosts\f[R] در ssh، با فعال کردن گزینه \f[V]known_hosts_file\f[R] امکان‌پذیر است.
این گزینه می‌تواند به فایل نگهداری‌شده توسط \f[V]OpenSSH\f[R] یا به یک فایل اختصاصی دیگر اشاره کند.
برای غیرفعال کردن صریح بررسی کلید میزبان و بی‌صدا کردن هشدار، می‌توان گزینه
\f[V]known_hosts_file\f[R] را روی \f[V]none\f[R] تنظیم کرد.
.PP
به‌عنوان روشی جایگزین، rclone می‌تواند کلیدهای میزبان سرور را در تنظیم
\f[V]host_keys\f[R] درون فایل پیکربندی نگهداری کند.
این مورد می‌تواند به‌طور خودکار با \f[V]--sftp-pin-host-key\f[R] به‌روزرسانی شود.
.PP
این گزینه‌ها در ادامه توضیح داده شده‌اند.
.SS استفاده از فایل known_hosts برنامه OpenSSH (Using the OpenSSH known_hosts file)
.PP
نحوه استفاده از فایل \f[V]known_hosts\f[R] متعلق به OpenSSH به شکل زیر است:
.IP
.nf
\f[C]
[remote]
type = sftp
host = example.com
user = sftpuser
pass = 
known_hosts_file = \[ti]/.ssh/known_hosts
\f[R]
.fi
.PP
همچنین می‌توانید فایل known hosts اختصاصی خود را به این صورت ایجاد کنید:
.IP
.nf
\f[C]
ssh-keyscan -t dsa,rsa,ecdsa,ed25519 example.com >> known_hosts
\f[R]
.fi
.PP
برخی محدودیت‌ها وجود دارد:
.IP \[bu] 2
ابزار \f[V]rclone\f[R] این فایل را برای شما \f[I]مدیریت نخواهد کرد\f[R].
اگر کلید موجود نباشد یا اشتباه باشد، اتصال رد خواهد شد.
.IP \[bu] 2
اگر سرور برای کلید میزبان مبتنی بر گواهی تنظیم شده باشد، ورودی موجود در فایل
\f[V]known_hosts\f[R] \f[I]باید\f[R] ورودی
\f[V]\[at]cert-authority\f[R] برای CA باشد.
.PP
اگر کلید میزبان ارائه‌شده توسط سرور با کلید درون فایل مطابقت نداشته باشد (یا موجود نباشد)، اتصال متوقف شده و خطایی مانند زیر بازگردانده می‌شود:
.IP
.nf
\f[C]
NewFs: couldn\[aq]t connect SSH: ssh: handshake failed: knownhosts: key mismatch
\f[R]
.fi
.PP
یا
.IP
.nf
\f[C]
NewFs: couldn\[aq]t connect SSH: ssh: handshake failed: knownhosts: key is unknown
\f[R]
.fi
.PP
اگر خطایی مانند زیر مشاهده کردید:
.IP
.nf
\f[C]
NewFs: couldn\[aq]t connect SSH: ssh: handshake failed: ssh: no authorities for hostname: example.com:22
\f[R]
.fi
.PP
در این صورت، احتمالاً سرور یک گواهی میزبان امضاشده توسط CA ارائه داده است و لازم است ورودی \f[V]\[at]cert-authority\f[R] مناسب را اضافه کنید.
.PP
تنظیم \f[V]known_hosts_file\f[R] می‌تواند در حین اجرای \f[V]rclone config\f[R] به‌عنوان یک گزینه پیشرفته تنظیم شود..SS پین کردن کلید میزبان
.PP
به عنوان جایگزینی برای نگهداری فایل \f[V]known_hosts\f[R]، برنامهٔ rclone از
پین کردن کلید میزبان بر اساس اعتماد در اولین استفاده (TOFU یا Trust On First Use)
از طریق پرچم خط فرمان \f[V]--sftp-pin-host-key\f[R] پشتیبانی می‌کند.
.PP
گردش کار پیشنهادی بدین صورت است:
.IP "1." 3
برای نخستین اتصال به یک ریموت جدید، rclone را یک بار با
\f[V]--sftp-pin-host-key\f[R] اجرا کنید.
rclone کلید میزبان سرور را در گزینهٔ پیکربندی \f[V]host_keys\f[R] ریموت ثبت کرده
و اثر انگشت SHA256 آن را گزارش می‌کند:
.RS 4
.IP
.nf
\f[C]
$ rclone --sftp-pin-host-key lsd remote:
2026/01/01 12:00:00 NOTICE: sftp://sftpuser\[at]example.com:22/: Accepted ssh-ed25519 host key SHA256:abc... for example.com:22 on first use
2026/01/01 12:00:00 NOTICE: sftp://sftpuser\[at]example.com:22/: Pinned ssh-ed25519 host key SHA256:abc... for example.com:22 in config
\f[R]
.fi
.RE
.IP "2." 3
برای دفعات بعدی اجرا، این پرچم را حذف کنید.
rclone به کلیدهای پین‌شده در \f[V]host_keys\f[R] مراجعه کرده و در صورت هرگونه
عدم تطابق، از برقراری اتصال خودداری می‌کند.
.PP
این سازوکار یک بهبود اساسی نسبت به حالت پیش‌فرضِ عدم اعتبارسنجی کلید میزبان است،
اما توجه داشته باشید که خود اتصال اول احراز هویت نشده است.
rclone تغییرات بعدی کلید را تشخیص می‌دهد، نه نفوذگر مرد میانی (man-in-the-middle) را
که از همان اولین اتصال در مسیر قرار داشته است.
بهتر است نخستین اتصال را روی یک شبکهٔ امن و مورد اعتماد برقرار کرده یا اثر انگشتی
را که rclone گزارش می‌کند، با مقداری که توسط مدیر سرور به‌صورت خارج از کانال
ارائه شده تطبیق دهید.
.PP
اگر گزینهٔ \f[V]known_hosts_file\f[R] نیز تنظیم شده باشد، اولویت با آن خواهد بود و
\f[V]--sftp-pin-host-key\f[R] نادیده گرفته می‌شود.
.PP
پس از اولین اتصال موفق، فایل پیکربندی شامل خط جدیدی خواهد بود:
.IP
.nf
\f[C]
[remote]
type = sftp
host = example.com
user = sftpuser
pass = 
host_keys = ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA...
\f[R]
.fi
.PP
فیلد \f[V]host_keys\f[R] در صورتی که خالی نباشد، همواره با کلید میزبان ارائه‌شده
اعتبارسنجی می‌شود، بنابراین می‌توانید بدون اجرای دستور با پرچم ذکر شده، یک کلید
شناخته‌شده را دستی پین کنید.
هر ورودی، کلید عمومی کامل است — یعنی فیلدهای الگوریتم و base64 از یک خط در
known_hosts — و نه اثر انگشت SHA256 آن:
.IP
.nf
\f[C]
rclone config update remote host_keys \[dq]ssh-ed25519 AAAAC3...\[dq]
\f[R]
.fi
.PP
تنظیم دائمی \f[V]pin_host_key = true\f[R] در فایل پیکربندی توصیه نمی‌شود:
تا زمانی که این گزینه فعال باشد، rclone هر الگوریتم کلید میزبان جدیدی را که سرور
در آینده ارائه دهد می‌پذیرد، که این امر سطح اعتماد را فراتر از پین اولیه گسترش می‌دهد.
استفاده از \f[V]--sftp-pin-host-key\f[R] به صورت پرچم یک‌باره تضمین می‌کند که هر
رویداد اعتمادسازی بدون احراز هویت، یک تصمیم آگاهانه باشد.
.SS پین کردن مجدد پس از تغییر معتبر کلید
.PP
اگر کلید میزبان سرور به‌صورت موجه تغییر کند (rotate شود)، rclone با خطایی حاوی
هر دو اثر انگشت SHA256 ذخیره‌شده و ارائه‌شده، اتصال را رد خواهد کرد.
برای پذیرفتن کلید جدید، مقدار ذخیره‌شده را پاک کرده و دستور را یک بار دیگر با
پرچم اجرا کنید:
.IP
.nf
\f[C]
rclone config update remote host_keys \[dq]\[dq]
rclone --sftp-pin-host-key lsd remote:
\f[R]
.fi
.PP
همچنین می‌توانید \f[V]host_keys\f[R] را مستقیماً ویرایش کرده تا مقدار جدید را
جایگزین یا اضافه نمایید.
ثبت چندین ورودی (که با کاما از یکدیگر جدا شوند) پشتیبانی می‌شود..SS "محدودیت‌ها (Limitations)"
.IP \[bu] 2
اگر سرور از یک گواهی میزبان امضاشده توسط \f[V]\[at]cert-authority\f[R] استفاده کند، پین‌کردن کلید میزبان نمی‌تواند آن را اعتبارسنجی کند (گواهی به‌طور دوره‌ای دوباره صادر می‌شود حتی اگر CA زیربنایی بدون تغییر بماند).
به‌جای آن از \f[V]known_hosts_file\f[R] با یک مدخل \f[V]\[at]cert-authority\f[R] استفاده کنید.
.IP \[bu] 2
ریموت‌های در لحظه (\f[V]:sftp,host=...:\f[R]) نمی‌توانند کلید پین‌شده را به‌صورت پایدار ذخیره کنند \- rclone در هر بار اجرا یک هشدار ثبت کرده و مجدداً کلید سرور را می‌پذیرد، بنابراین این پرچم فقط ثبت اثرانگشت (fingerprint) در نخستین اتصال را فراهم می‌کند.
ریموت‌های نام‌گذاری‌شده‌ای که با بازنویسی رشته اتصال (\f[V]remote,port=2022:\f[R]) استفاده می‌شوند مشکلی ندارند: کلید پین‌شده در بخش پیکربندی ریموت ذخیره می‌شود.
.IP \[bu] 2
اگر گزینه \f[V]ssh\f[R] تنظیم شده باشد، برنامه ssh پیکربندی‌شده اتصال را برقرار کرده و اعتبارسنجی کلید میزبان اختصاصی خود را انجام می‌دهد، بنابراین \f[V]host_keys\f[R] بررسی نمی‌شود و \f[V]--sftp-pin-host-key\f[R] چیزی را پین نمی‌کند.
.IP \[bu] 2
نقاط پایانی SFTP با توزیع بار (Load-balanced) که برای هر گره بک‌اند کلید میزبان متفاوتی ارائه می‌دهند، در صورتی که اتصال بعدی به گره متفاوتی هدایت شود، باعث عدم تطابق خواهند شد.
پس از پاک‌کردن \f[V]host_keys\f[R] دوباره با \f[V]--sftp-pin-host-key\f[R] اجرا کنید، یا مرحله نخستین اتصال را تا زمانی تکرار کنید که کلید هر گره مشاهده شود و سپس ورودی‌های اضافی را به‌صورت دستی (جداشده با کاما) به \f[V]host_keys\f[R] اضافه کنید.
.IP \[bu] 2
ابزار rclone هنوز از افزونه \f[V]hostkeys\[at]openssh.com\f[R] در OpenSSH پشتیبانی نمی‌کند؛ سازوکاری غیر RFC که به کلاینت‌ها کمک می‌کند در طول چرخش کلیدها، کلیدهای میزبان اضافی را دریافت کنند.
این مورد در بالادست در نشانی زیر در حال پیگیری است:
https://github.com/golang/go/issues/37245
.SS "ssh-agent در macOS (ssh-agent on macOS)"
.PP
توجه داشته باشید که به نظر می‌رسد به دلیل تغییرات اخیر در این سیستم‌عامل، مشکلات مختلفی در استفاده از ssh-agent در macOS وجود دارد.
کارآمدترین راهکار به نظر می‌رسد اجرای یک ssh-agent در هر نشست باشد، برای مثال:
.IP
.nf
\f[C]
eval \[ga]ssh-agent -s\[ga] && ssh-add -A
\f[R]
.fi
.PP
و سپس در پایان نشست:
.IP
.nf
\f[C]
eval \[ga]ssh-agent -k\[ga]
\f[R]
.fi
.PP
البته این دستورات می‌توانند در اسکریپت‌ها نیز استفاده شوند.
.SS "دسترسی شل (Shell access)"
.PP
برخی از قابلیت‌های بک‌اند SFTP به دسترسی شل راه‌دور و امکان اجرای دستورات وابسته است.
این موارد شامل checksum و در برخی موارد about نیز می‌شود.
دستورات شلی که باید اجرا شوند ممکن است در انواع مختلف شل متفاوت باشند، و همچنین نقل‌قول/گریز (quoting/escaping) آرگومان‌های مسیر فایل حاوی نویسه‌های خاص ممکن است فرق داشته باشد.
بنابراین rclone باید بداند با چه نوع شلی مواجه است، و اینکه آیا دسترسی شل اصلاً در دسترس هست یا خیر.
.PP
بیشتر سرورها روی نسخه‌ای از Unix اجرا می‌شوند و می‌توان یک شل پایه یونیکسی را بدون تمایز بیشتر فرض کرد.
سیستم‌عامل‌های Windows 10، Server 2019 و نسخه‌های جدیدتر نیز می‌توانند یک سرور SSH اجرا کنند که پورتی از OpenSSH است (راهنمای رسمی نصب را ببینید: https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse).
در سرور Windows مدیریت شل متفاوت است: اگرچه می‌توان آن را برای استفاده از یک شل از نوع یونیکس مانند Cygwin bash نیز تنظیم کرد، حالت پیش‌فرض استفاده از Windows Command Prompt (cmd.exe) است و PowerShell یک جایگزین توصیه‌شده است.
همه این موارد رفتارهای متفاوتی دارند که rclone باید آنها را مدیریت کند.
.PP
ابزار rclone تلاش می‌کند نخستین باری که به ریموت SFTP متصل می‌شوید، نوع شل مورداستفاده در سرور را به‌طور خودکار تشخیص دهد.
اگر نشست شل از راه دور با موفقیت ایجاد شود، به دنبال نشانه‌هایی مبنی بر CMD یا PowerShell خواهد گشت و در صورتی که چیز دیگری شناسایی نشود، به Unix بازمی‌گردد.
اگر حتی امکان ایجاد یک نشست شل از راه دور وجود نداشته باشد، اجرای دستورات شل به‌طور کامل غیرفعال خواهد شد.
نتیجه در پیکربندی ریموت SFTP و در گزینه \f[V]shell_type\f[R] ذخیره می‌شود تا تشخیص خودکار تنها یک‌بار انجام گیرد.
اگر پیش از نخستین اجرا مقداری را به‌صورت دستی برای این گزینه تنظیم کنید، تشخیص خودکار نادیده گرفته می‌شود و اگر بعداً مقدار دیگری را تعیین کنید، جایگزین هر مقدار موجود خواهد شد.
مقدار \f[V]none\f[R] می‌تواند برای جلوگیری از هرگونه تلاش جهت اجرای دستورات شل تنظیم شود، برای مثال اگر این کار در سرور مجاز نباشد.
اگر در پیکربندی مقدار \f[V]shell_type = none\f[R] را دارید، نباید ssh تنظیم شده باشد.
.PP
هنگامی که سرور rclone serve sftp باشد (https://rclone.org/commands/rclone_serve_sftp)، ریموت SFTP در rclone آن را به عنوان یک شل از نوع Unix تشخیص می‌دهد \- حتی اگر روی Windows در حال اجرا باشد.
این سرور در واقع شل ندارد، اما دستورات ورودی مطابق با موارد خاصی را که بک‌اند SFTP برای شل‌های Unix به آنها تکیه دارد (مانند \f[V]md5sum\f[R] و \f[V]df\f[R]) می‌پذیرد.
همچنین قواعد گریز رشته (string escape) استفاده‌شده برای شل یونیکس را مدیریت می‌کند.
بنابراین تعامل با آن به عنوان یک شل از نوع Unix از سوی یک ریموت SFTP همیشه صحیح خواهد بود و از تمام قابلیت‌ها پشتیبانی می‌کند..SS ملاحظات دسترسی به شل
.PP
منطق تشخیص خودکار نوع شل که در بالا توضیح داده شد، بدین معناست که rclone به‌طور پیش‌فرض در اولین دسترسی به یک ریموت sftp جدید، تلاش می‌کند یک دستور شل را اجرا کند.
اگر یک ریموت sftp را بدون فایل پیکربندی تنظیم کنید، مثلاً یک ریموت بی‌درنگ (on the fly) (https://rclone.org/docs/#backend-path-to-dir)، rclone جایی برای ذخیره نتیجه نخواهد داشت و در هر بار دسترسی، دستور را دوباره اجرا خواهد کرد.
برای جلوگیری از این امر، باید گزینه \f[V]shell_type\f[R] را به‌صراحت روی مقدار صحیح تنظیم کنید، یا اگر می‌خواهید از اجرای هرگونه دستور شل راه دور توسط rclone جلوگیری کنید، آن را روی \f[V]none\f[R] قرار دهید.
.PP
همچنین توجه به این نکته مهم است که از آنجا که نوع شل نحوه نقل‌قول (quoting) و گریزدهی (escaping) مسیرهای فایل استفاده‌شده به‌عنوان آرگومان‌های خط فرمان را تعیین می‌کند، پیکربندی نوع شل اشتباه ممکن است شما را در معرض اکسپلویت‌های تزریق دستور (command injection) قرار دهد.
حتماً نوع شل تشخیص داده‌شده به‌طور خودکار را تأیید کنید، یا صراحتاً نوع شلی را که می‌دانید درست است تنظیم نمایید، یا تا زمانی که اطمینان حاصل نکرده‌اید، دسترسی به شل را غیرفعال کنید.
.SS مجموع مقابله‌ای (Checksum)
.PP
پروتکل SFTP به‌طور ذاتی از مجموع‌های مقابله‌ای (هش فایل) پشتیبانی نمی‌کند، اما اگر همان لاگین به شل دسترسی داشته باشد و بتواند دستورات راه دور را اجرا کند، rclone قادر است از محاسبه مجموع مقابله‌ای استفاده کند.
اگر دستوری وجود داشته باشد که بتواند مجموع‌های مقابله‌ای سازگار را روی سیستم راه دور محاسبه کند، می‌توان rclone را طوری پیکربندی کرد که هر زمان نیاز به مجموع مقابله‌ای بود، آن را اجرا کرده و نتایج را بازخوانی کند.
به‌طور پیش‌فرض MD5 و SHA-1 در نظر گرفته می‌شوند، اما CRC32، SHA-256، BLAKE3، XXH3 و XXH128 نیز پشتیبانی می‌شوند؛ گزینه \f[V]hashes\f[R] را می‌توان برای تعیین اینکه کدام‌یک در نظر گرفته شوند، تنظیم کرد.
.PP
به‌طور معمول این کار مستلزم در دسترس بودن یک ابزار خارجی روی سرور است.
برای مثال، برای مجموع‌های مقابله‌ای MD5، ابزار rclone به‌طور پیش‌فرض دستورات \f[V]md5sum\f[R]، \f[V]md5\f[R] و \f[V]rclone md5sum\f[R] را امتحان می‌کند و اولین موردی که قابل استفاده باشد، انتخاب خواهد شد.
این ابزارها معمولاً باید در PATH سیستم راه دور باشند تا پیدا شوند.
.PP
در برخی موارد، خود شل قادر به محاسبه مجموع مقابله‌ای است.
PowerShell نمونه‌ای از چنین شلی است.
اگر rclone تشخیص دهد که شل راه دور PowerShell است—که به احتمال زیاد به این معنی است که یک سرور Windows OpenSSH است—هنگامی که هیچ دستور خارجی برای محاسبه مجموع مقابله‌ای پیدا نشود، rclone از یک بلوک اسکریپت از پیش تعریف‌شده برای تولید مجموع‌های مقابله‌ای MD5، SHA-1 و SHA-256 استفاده خواهد کرد (بخش ملاحظات دسترسی به شل را ببینید).
این ویژگی وجود نسخه 4.0 یا جدیدتر PowerShell را فرض می‌کند.
.PP
گزینه‌های \f[V]md5sum_command\f[R]، \f[V]sha1_command\f[R] و غیره را می‌توان برای سفارشی‌سازی دستوراتی که برای محاسبه مجموع مقابله‌ای اجرا می‌شوند استفاده کرد.
به عنوان مثال، می‌توانید یک مسیر مشخص را برای محل قرارگیری فایل اجرایی md5sum تعیین کنید، یا ابزار دیگری را مشخص کنید که مجموع‌های مقابله‌ای را در قالبی سازگار چاپ کند.
این مقدار می‌تواند شامل آرگومان‌های خط فرمان یا حتی بلوک‌های اسکریپت شل همانند PowerShell باشد.
ابزار Rclone زیردستورهای
hashsum (https://rclone.org/commands/rclone_hashsum)،
md5sum (https://rclone.org/commands/rclone_md5sum) و
sha1sum (https://rclone.org/commands/rclone_sha1sum)
دارد که از قالب سازگار استفاده می‌کنند، بدین معنا که اگر یک فایل اجرایی rclone روی سرور داشته باشید، می‌تواند مورد استفاده قرار گیرد.
همان‌طور که در بالا ذکر شد، اگر این موارد در PATH پیدا شوند، به‌طور خودکار انتخاب خواهند شد؛ اما در غیر این صورت می‌توانید مقداری مانند
\f[V]/path/to/rclone md5sum\f[R] را به عنوان مقدار گزینه
\f[V]md5sum_command\f[R] تنظیم کنید تا مطمئن شوید یک فایل اجرایی خاص استفاده می‌شود.
.PP
محاسبه مجموع مقابله‌ای راه دور توصیه می‌شود و به‌طور پیش‌فرض فعال است.
اولین باری که rclone از یک ریموت SFTP استفاده می‌کند، اگر گزینه‌های
\f[V]md5sum_command\f[R] یا \f[V]sha1_command\f[R] تنظیم نشده باشند، بررسی می‌کند که آیا هر یک از دستورات پیش‌فرض برای هر کدام از آن‌ها، همان‌طور که در بالا توضیح داده شد، قابل استفاده است یا خیر.
نتیجه در پیکربندی ریموت ذخیره می‌شود، بنابراین دفعه بعد از همان استفاده خواهد کرد.
اگر هیچ‌یک از دستورات پیش‌فرض برای یک الگوریتم خاص قابل استفاده نباشد، مقدار \f[V]none\f[R] تنظیم خواهد شد و این الگوریتم توسط ریموت پشتیبانی نخواهد شد.
.PP
اگر به سرورهای SFTP متصل می‌شوید که تحت کنترل شما نیستند و اجرای دستورات شل راه دور در آن‌ها ممنوع است، ممکن است غیرفعال کردن کامل محاسبه مجموع مقابله‌ای ضروری باشد.
گزینه پیکربندی \f[V]disable_hashcheck\f[R] را روی \f[V]true\f[R] تنظیم کنید تا محاسبه مجموع مقابله‌ای کاملاً غیرفعال شود (با تنظیم گزینه \f[V]hashes\f[R] روی \f[V]none\f[R] یا گزینه‌های \f[V]md5sum_command\f[R]، \f[V]sha1_command\f[R] و غیره روی \f[V]none\f[R] نیز به همین نتیجه می‌رسید).
گزینه \f[V]shell_type\f[R] را روی \f[V]none\f[R] تنظیم کنید تا نه‌تنها محاسبه مجموع مقابله‌ای غیرفعال شود، بلکه تمام قابلیت‌های دیگر که بر پایه اجرای دستورات شل راه دور هستند نیز غیرفعال گردند..SS زمان‌های تغییر و هش‌ها (Modification times and hashes)
.PP
زمان‌های تغییر با دقت ۱ ثانیه در کارساز ذخیره می‌شوند.
.PP
زمان‌های تغییر در همگام‌سازی استفاده می‌شوند و به‌طور کامل پشتیبانی می‌شوند.
.PP
برخی از کارسازهای SFTP تنظیم یا تغییر زمان ویرایش فایل را پس از بارگذاری غیرفعال می‌کنند (برای مثال، برخی پیکربندی‌های خاص ProFTPd با mod_sftp).
اگر از یکی از این کارسازها استفاده می‌کنید، می‌توانید گزینهٔ \f[V]set_modtime = false\f[R] را در پیکربندی backend مربوط به rclone تنظیم کنید تا این رفتار غیرفعال شود.
.SS دستور About (About command)
.PP
دستور \f[V]about\f[R] فضای کل، فضای خالی و فضای استفاده‌شده را در ریموت برای دیسکِ مسیر مشخص‌شده یا در صورت عدم تعیین، برای دیسک ریشه (root) در ریموت بازمی‌گرداند.
.PP
پروتکل SFTP معمولاً از دستور
about (https://rclone.org/commands/rclone_about) پشتیبانی می‌کند، اما این امر به کارساز بستگی دارد.
اگر کارساز افزونهٔ آماری VFS ویژهٔ سازنده را پیاده‌سازی کرده باشد، که معمولاً در نمونه‌های OpenSSH چنین است، از آن استفاده خواهد شد.
در غیر این صورت، چنانچه همان حساب کاربری به یک شل یونیکس دسترسی داشته باشد که در آن دستور \f[V]df\f[R] در دسترس است (مثلاً در PATH ریموت)، به جای آن از این دستور استفاده خواهد شد.
اگر شل کارساز PowerShell باشد، احتمالاً با یک کارساز OpenSSH ویندوزی، rclone از یک دستور توکار شل استفاده خواهد کرد (دسترسی شل را ببینید).
اگر هیچ‌یک از موارد بالا قابل اعمال نباشد، اجرای \f[V]about\f[R] با شکست مواجه خواهد شد.
.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص sftp (SSH/SFTP) آورده شده است.
.SS --sftp-host
.PP
میزبان SSH برای اتصال.
.PP
برای مثال:
\[dq]example.com\[dq].
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: host
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_HOST
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: true
.SS --sftp-user
.PP
نام کاربری SSH.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_USER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]$USER\[dq]
.SS --sftp-port
.PP
شماره پورت SSH.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: port
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_PORT
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 22
.SS --sftp-pass
.PP
گذرواژهٔ SSH؛ برای استفاده از ssh-agent خالی بگذارید.
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی (obscure) شود - به rclone
obscure (https://rclone.org/commands/rclone_obscure) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pass
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_PASS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false.SS --sftp-key-pem
.PP
کلید خصوصی خام با کدگذاری PEM.
.PP
توجه داشته باشید که این مقدار باید در یک خط واحد باشد و انتهای خطوط با \[aq]\[aq] جایگزین شده باشد، مانند:
.IP
.nf
\f[C]
key_pem = -----BEGIN RSA PRIVATE KEY-----\[rs]nMaMbaIXtE\[rs]n0gAMbMbaSsd\[rs]nMbaass\[rs]n-----END RSA PRIVATE KEY-----
\f[R]
.fi
.PP
این دستور خط واحد را به درستی تولید می‌کند:
.IP
.nf
\f[C]
awk \[aq]{printf \[dq]%s\[rs]\[rs]n\[dq], $0}\[aq] < \[ti]/.ssh/id_rsa
\f[R]
.fi
.PP
در صورت تعیین، پارامتر key_file را بازنویسی خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: key_pem
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_KEY_PEM
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.SS --sftp-key-file
.PP
مسیر فایل کلید خصوصی با کدگذاری PEM.
.PP
برای استفاده از ssh-agent، این گزینه را خالی بگذارید یا key-use-agent را تنظیم کنید.
.PP
نویسهٔ \f[V]\[ti]\f[R] در ابتدای نام فایل و همچنین متغیرهای محیطی نظیر \f[V]${RCLONE_CONFIG_DIR}\f[R] بسط داده خواهند شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: key_file
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_KEY_FILE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.SS --sftp-key-file-pass
.PP
عبارت عبور (passphrase) برای رمزگشایی فایل کلید خصوصی کدگذاری‌شده با PEM.
.PP
فقط فایل‌های کلید رمزگذاری‌شده با PEM (قالب قدیمی OpenSSH) پشتیبانی می‌شوند.
کلیدهای رمزگذاری‌شده در قالب جدید OpenSSH قابل استفاده نیستند.
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی (obscure) شود \- به rclone obscure (<https://rclone.org/commands/rclone_obscure>) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: key_file_pass
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_KEY_FILE_PASS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر
.SS --sftp-pubkey
.PP
گواهی عمومی SSH برای احراز هویت بر پایهٔ گواهی عمومی.
اگر گواهی امضاشده‌ای دارید که می‌خواهید برای احراز هویت استفاده کنید، این گزینه را تنظیم کنید.
در صورت تعیین، pubkey_file را بازنویسی خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pubkey
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_PUBKEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: خیر.SS --sftp-pubkey-file
.PP
مسیر اختیاری به فایل کلید عمومی.
.PP
اگر گواهی امضاشده‌ای دارید که می‌خواهید برای احراز هویت از آن استفاده کنید، این گزینه را تنظیم کنید.
.PP
علامت \f[V]\[ti]\f[R] در ابتدای نام فایل و همچنین متغیرهای محیطی نظیر \f[V]${RCLONE_CONFIG_DIR}\f[R] بسط داده خواهند شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pubkey_file
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_PUBKEY_FILE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --sftp-key-use-agent
.PP
در صورت تنظیم، استفاده از ssh-agent را اجباری می‌کند.
.PP
هنگامی که key-file نیز تنظیم شده باشد، فایل \[dq].pub\[dq] مربوط به key-file مشخص‌شده خوانده می‌شود و تنها کلید مرتبط از ssh-agent درخواست می‌گردد.
این کار از خطاهای
\f[V]Too many authentication failures for *username*\f[R] در مواقعی که ssh-agent حاوی کلیدهای زیادی است، جلوگیری می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: key_use_agent
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_KEY_USE_AGENT
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --sftp-use-insecure-cipher
.PP
فعال‌سازی استفاده از رمزها و روش‌های تبادل کلید ناامن.
.PP
این گزینه استفاده از رمزها و روش‌های تبادل کلید ناامن زیر را فعال می‌کند:
.IP \[bu] 2
aes128-cbc
.IP \[bu] 2
aes192-cbc
.IP \[bu] 2
aes256-cbc
.IP \[bu] 2
3des-cbc
.IP \[bu] 2
diffie-hellman-group-exchange-sha256
.IP \[bu] 2
diffie-hellman-group-exchange-sha1
.PP
این الگوریتم‌ها ناامن هستند و ممکن است به مهاجم اجازه دهند داده‌های متنی ساده (plaintext) را بازیابی کند.
.PP
اگر از گزینه‌های پیشرفته ciphers یا key_exchange استفاده می‌کنید، این مقدار باید false باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_insecure_cipher
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_USE_INSECURE_CIPHER
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]false\[dq]
.RS 2
.IP \[bu] 2
استفاده از فهرست رمزهای پیش‌فرض.
.RE
.IP \[bu] 2
\[dq]true\[dq]
.RS 2
.IP \[bu] 2
استفاده از رمز aes128-cbc و روش‌های تبادل کلید diffie-hellman-group-exchange-sha256 و diffie-hellman-group-exchange-sha1 را فعال می‌کند.
.RE
.RE.SS --sftp-disable-hashcheck
.PP
غیرفعال کردن اجرای دستورهای SSH برای تعیین در دسترس بودن هش فایل دوردست (remote).
.PP
برای فعال ماندن بررسی هش (توصیه‌شده)، این گزینه را خالی بگذارید یا روی false تنظیم کنید؛ برای غیرفعال کردن بررسی هش، مقدار آن را روی true قرار دهید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_hashcheck
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_DISABLE_HASHCHECK
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --sftp-ssh
.PP
مسیر و آرگومان‌های باینری خارجی ssh.
.PP
در حالت عادی، rclone از کتابخانه داخلی ssh خود برای اتصال به سرور SFTP استفاده می‌کند.
با این حال، این کتابخانه تمام گزینه‌های ممکن ssh را پیاده‌سازی نمی‌کند؛ بنابراین ممکن است استفاده از یک باینری خارجی ssh مطلوب باشد.
.PP
در صورت استفاده از این گزینه، rclone تمام پیکربندی‌های داخلی را نادیده می‌گیرد و انتظار دارد که باینری ssh را به همراه کاربر/میزبان/درگاه (user/host/port) و هر گزینه دیگری که نیاز دارید پیکربندی کنید.
.PP
\f[B]مهم:\f[R] دستور ssh باید بدون درخواست گذرواژه وارد شود، بنابراین لازم است با کلیدها یا گواهی‌ها پیکربندی شود.
.PP
برنامه rclone دستور ارائه‌شده را یا همراه با آرگومان‌های اضافی \[dq]-s sftp\[dq] برای دسترسی به زیرسیستم SFTP اجرا خواهد کرد، یا با افزودن دستورهایی مانند \[dq]md5sum /path/to/file\[dq] به انتهای آن، چک‌سام‌ها را می‌خواند.
.PP
هر آرگومانی که شامل فاصله باشد باید درون \[dq]گیومه دوتایی (double quotes)\[dq] محصور شود.
.PP
نمونه‌ای از تنظیمات می‌تواند به این صورت باشد:
.IP
.nf
\f[C]
ssh -o ServerAliveInterval=20 user\[at]example.com
\f[R]
.fi
.PP
توجه داشته باشید که هنگام استفاده از باینری خارجی ssh، rclone برای هر هشی که محاسبه می‌کند یک اتصال ssh جدید برقرار می‌سازد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: ssh
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_SSH
.IP \[bu] 2
نوع: SpaceSepList
.IP \[bu] 2
پیش‌فرض:
.SS "گزینه‌های پیشرفته (Advanced options)"
.PP
در اینجا گزینه‌های پیشرفته مختص sftp (SSH/SFTP) آورده شده‌اند.
.SS --sftp-known-hosts-file
.PP
مسیر اختیاری به فایل known_hosts.
.PP
این مقدار را برای فعال‌سازی اعتبارسنجی کلید میزبان سرور (host key) تنظیم کنید.
برای خاموش کردن اعلان \[dq]No host key validation\[dq]، آن را برابر \f[V]none\f[R] قرار دهید.
.PP
علامت \f[V]\[ti]\f[R] در ابتدای نام فایل و همچنین متغیرهای محیطی نظیر \f[V]${RCLONE_CONFIG_DIR}\f[R] گسترش خواهند یافت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: known_hosts_file
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_KNOWN_HOSTS_FILE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]\[ti]/.ssh/known_hosts\[dq]
.RS 2
.IP \[bu] 2
استفاده از فایل known_hosts متعلق به OpenSSH.
.RE
.RE.SS --sftp-pin-host-key
.PP
پین کردن کلید میزبان سرور در نخستین اتصال (اعتماد در نخستین استفاده یا Trust On First Use).
.PP
برای یک‌بار استفاده به عنوان پرچم خط فرمان \f[V]--sftp-pin-host-key\f[R]
در نظر گرفته شده است.
rclone را یک‌بار با این پرچم اجرا کنید تا کلید میزبان سرور در گزینه
پیکربندی host_keys ضبط شود.
در اجراهای بعدی (بدون این پرچم)، host_keys بررسی شده و هرگونه
عدم تطابق رد می‌شود.
.PP
تنظیم دائمی این گزینه در فایل پیکربندی توصیه نمی‌شود.
تا زمانی که این گزینه فعال باشد، rclone هر الگوریتم جدید کلید میزبان را
که سرور بعداً ارائه دهد نیز می‌پذیرد، که این امر سطح اعتماد را فراتر از
پین اولیه گسترش می‌دهد.
برای پین کردن یک کلید جدید پس از یک تغییر معتبر کلید، دستور را دوباره با این پرچم اجرا کنید.
.PP
اتصال نخست احراز هویت نشده است، بنابراین در حالت ایده‌آل آن را روی یک شبکه
قابل‌اعتماد انجام دهید یا اثرانگشت ثبت‌شده در گزارش‌های rclone را با
اثرانگشتی که به‌صورت برون‌باندی (out of band) دریافت کرده‌اید مطابقت دهید.
.PP
اگر known_hosts_file نیز تنظیم شده باشد، آن گزینه اولویت خواهد داشت و
این گزینه نادیده گرفته می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pin_host_key
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_PIN_HOST_KEY
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --sftp-host-keys
.PP
کلیدهای میزبان پین‌شده برای این ریموت، که جهت تأیید سرور استفاده می‌شوند.
.PP
فهرستی جداشده با کاما از ورودی‌های \[dq]algo base64-key\[dq] (مشابه با
قالب فیلدهای دوم و سوم در یک خط known_hosts مربوط به OpenSSH).
معمولاً با یک‌بار اجرا به همراه --sftp-pin-host-key به‌طور خودکار پر می‌شود،
اما می‌توان آن را دستی نیز تنظیم کرد تا کلید عمومی سرور که به‌صورت
برون‌باندی دریافت شده پین شود.
توجه داشته باشید که هر ورودی، کلید عمومی کامل است، نه اثرانگشت SHA256 آن.
.PP
در صورت خالی نبودن، کلید میزبان ارائه‌شده باید با یکی از ورودی‌ها مطابقت
داشته باشد، در غیر این صورت اتصال رد می‌شود.
برای پین کردن دوباره پس از یک تغییر معتبر کلید، این گزینه را پاک کرده و
مجدداً با --sftp-pin-host-key متصل شوید، یا مقدار را مستقیماً ویرایش کنید.
.PP
حداکثر ۱۶ ورودی را می‌توان پین کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: host_keys
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_HOST_KEYS
.IP \[bu] 2
نوع: CommaSepList
.IP \[bu] 2
پیش‌فرض:
.SS --sftp-ask-password
.PP
اجازه درخواست گذرواژه SFTP در صورت نیاز.
.PP
اگر این گزینه تنظیم شده باشد و هیچ گذرواژه‌ای ارائه نشده باشد، rclone: \- گذرواژه را درخواست می‌کند \- با ssh agent ارتباط برقرار نمی‌کند
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: ask_password
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_ASK_PASSWORD
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --sftp-path-override
.PP
بازنویسی مسیر مورد استفاده توسط دستورهای پوسته SSH.
.PP
این گزینه امکان محاسبه چِک‌سام (checksum) را هنگامی که مسیرهای SFTP و SSH متفاوت هستند فراهم می‌کند.
این مسئله از جمله بر دستگاه‌های Synology NAS تأثیر می‌گذارد.
.PP
به‌عنوان مثال،
اگر پوشه‌های اشتراکی در دایرکتوری‌هایی که نشان‌دهنده volumeها هستند قرار داشته باشند:
.IP
.nf
\f[C]
rclone sync /home/local/directory remote:/directory --sftp-path-override /volume2/directory
\f[R]
.fi
.PP
به‌عنوان مثال،
اگر دایرکتوری خانه (home directory) در پوشه اشتراکی به نام \[dq]home\[dq] قرار داشته باشد:
.IP
.nf
\f[C]
rclone sync /home/local/directory remote:/home/directory --sftp-path-override /volume1/homes/USER/directory
\f[R]
.fi
.PP
برای تعیین تنها مسیر به ریشه (root) ریموت SFTP، و اجازه دادن به rclone
برای افزودن خودکار زیرمسیرهای نسبی (از جمله unwrapping/رمزگشایی ریموت‌ها در صورت نیاز)،
نویسه \[aq]\[at]\[aq] را به ابتدای مسیر اضافه کنید.
.PP
به‌عنوان مثال،
اولین مثال بالا را می‌توان به‌صورت زیر بازنویسی کرد:
.IP
.nf
\f[C]
rclone sync /home/local/directory remote:/directory --sftp-path-override \[at]/volume2
\f[R]
.fi
.PP
توجه داشته باشید که هنگام استفاده از این روش با پوشه‌های \[dq]home\[dq] در Synology،
باید مسیر کامل \[dq]/homes/USER\[dq] به جای \[dq]/home\[dq] مشخص شود.
.PP
به‌عنوان مثال،
دومین مثال بالا باید به‌صورت زیر بازنویسی شود:
.IP
.nf
\f[C]
rclone sync /home/local/directory remote:/homes/USER/directory --sftp-path-override \[at]/volume1
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: path_override
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_PATH_OVERRIDE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --sftp-encoding
.PP
کدگذاری برای بک‌اند.
.PP
برای اطلاعات بیشتر بخش کدگذاری را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,Del,Ctl,Dot
.SS --sftp-set-modtime
.PP
در صورت تنظیم، زمان تغییر را روی ریموت تنظیم می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: set_modtime
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_SET_MODTIME
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --sftp-shell-type
.PP
نوع پوستهٔ SSH روی سرور ریموت، در صورت وجود.
.PP
برای تشخیص خودکار خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: shell_type
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_SHELL_TYPE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]none\[dq]
.RS 2
.IP \[bu] 2
بدون دسترسی به پوسته
.RE
.IP \[bu] 2
\[dq]unix\[dq]
.RS 2
.IP \[bu] 2
پوستهٔ Unix
.RE
.IP \[bu] 2
\[dq]powershell\[dq]
.RS 2
.IP \[bu] 2
PowerShell
.RE
.IP \[bu] 2
\[dq]cmd\[dq]
.RS 2
.IP \[bu] 2
خط فرمان ویندوز
.RE
.RE
.SS --sftp-hashes
.PP
فهرست جداشده با کاما از انواع چکسام‌های پشتیبانی‌شده.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hashes
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_HASHES
.IP \[bu] 2
نوع: CommaSepList
.IP \[bu] 2
پیش‌فرض:.SS --sftp-md5sum-command
.PP
دستور مورد استفاده برای خواندن هش‌های MD5.
.PP
برای تشخیص خودکار خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: md5sum_command
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_MD5SUM_COMMAND
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sftp-sha1sum-command
.PP
دستور مورد استفاده برای خواندن هش‌های SHA-1.
.PP
برای تشخیص خودکار خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sha1sum_command
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_SHA1SUM_COMMAND
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sftp-crc32sum-command
.PP
دستور مورد استفاده برای خواندن هش‌های CRC-32.
.PP
برای تشخیص خودکار خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: crc32sum_command
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_CRC32SUM_COMMAND
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sftp-sha256sum-command
.PP
دستور مورد استفاده برای خواندن هش‌های SHA-256.
.PP
برای تشخیص خودکار خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: sha256sum_command
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_SHA256SUM_COMMAND
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sftp-blake3sum-command
.PP
دستور مورد استفاده برای خواندن هش‌های BLAKE3.
.PP
برای تشخیص خودکار خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: blake3sum_command
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_BLAKE3SUM_COMMAND
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sftp-xxh3sum-command
.PP
دستور مورد استفاده برای خواندن هش‌های XXH3.
.PP
برای تشخیص خودکار خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: xxh3sum_command
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_XXH3SUM_COMMAND
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --sftp-xxh128sum-command
.PP
دستوری که برای خواندن هش‌های XXH128 استفاده می‌شود.
.PP
برای تشخیص خودکار، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: xxh128sum_command
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_XXH128SUM_COMMAND
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sftp-skip-links
.PP
تنظیم برای نادیده‌گرفتن پیوندهای نمادین و هرگونه فایل غیرعادی دیگر.
.PP
این گزینه فقط بر فهرست‌بندی تأثیر می‌گذارد: پیوندهای نمادین و سایر فایل‌های غیرعادی از فهرست دایرکتوری‌ها حذف می‌شوند.
این یک سازوکار امنیتی نیست و مانع از دنبال کردن پیوندهای نمادین روی سرور در هنگام نوشتن نمی‌شود \- محدود کردن یک حساب SFTP به یک دایرکتوری باید در سمت سرور اعمال شود (برای مثال با یک chroot jail یا مجوزهای محدودشده).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: skip_links
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_SKIP_LINKS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --sftp-subsystem
.PP
زیرسیستم SSH2 را روی میزبان دوردست مشخص می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: subsystem
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_SUBSYSTEM
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]sftp\[dq]
.SS --sftp-server-command
.PP
مسیر یا دستور را برای اجرای سرور sftp روی میزبان دوردست مشخص می‌کند.
.PP
هنگامی که server_command تعریف شده باشد، گزینه subsystem نادیده گرفته می‌شود.
.PP
در صورت افزودن server_command به فایل پیکربندی، توجه داشته باشید که نباید در گیومه قرار گیرد، زیرا باعث شکست rclone می‌شود.
.PP
یک مثال کاربردی:
.IP
.nf
\f[C]
[remote_name]
type = sftp
server_command = sudo /usr/libexec/openssh/sftp-server
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: server_command
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_SERVER_COMMAND
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sftp-use-fstat
.PP
در صورت تنظیم، به‌جای stat از fstat استفاده می‌کند.
.PP
برخی سرورها تعداد فایل‌های باز را محدود می‌کنند و فراخوانی Stat پس از باز کردن فایل موجب خطایی از سمت سرور خواهد شد.
تنظیم این پرچم باعث فراخوانی Fstat به‌جای Stat می‌شود که روی یک فایل هندل از پیش بازشده اجرا می‌گردد.
.PP
مشخص شده است که این گزینه به سرورهای IBM Sterling SFTP که سطح \[dq]extractability\[dq] آن‌ها روی ۱ تنظیم شده است (به این معنی که در هر زمان تنها ۱ فایل می‌تواند باز باشد) کمک می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_fstat
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_USE_FSTAT
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --sftp-disable-concurrent-reads
.PP
در صورت تنظیم، از خواندن‌های هم‌روند استفاده نمی‌شود.
.PP
در حالت عادی، استفاده از خواندن‌های هم‌روند ایمن است و عدم استفاده از آن‌ها
کارایی را کاهش می‌دهد، بنابراین این گزینه به‌طور پیش‌فرض غیرفعال است.
.PP
برخی کارسازها تعداد دفعاتی را که یک فایل می‌تواند بارگیری شود محدود می‌کنند.
استفاده از خواندن‌های هم‌روند می‌تواند این محدودیت را فعال کند، بنابراین اگر کارسازی دارید
که این خطا را بازمی‌گرداند:
.IP
.nf
\f[C]
Failed to copy: file does not exist
\f[R]
.fi
.PP
در این صورت ممکن است نیاز باشد این پرچم را فعال کنید.
.PP
اگر خواندن‌های هم‌روند غیرفعال شوند، گزینه use_fstat نادیده گرفته می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_concurrent_reads
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_DISABLE_CONCURRENT_READS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --sftp-disable-concurrent-writes
.PP
در صورت تنظیم، از نوشتن‌های هم‌روند استفاده نمی‌شود.
.PP
به‌طور معمول rclone برای بارگذاری فایل‌ها از نوشتن‌های هم‌روند استفاده می‌کند.
این کار کارایی را به‌ویژه برای کارسازهای دوردست به‌طور چشمگیری بهبود می‌بخشد.
.PP
این گزینه در صورت لزوم، نوشتن‌های هم‌روند را غیرفعال می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: disable_concurrent_writes
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_DISABLE_CONCURRENT_WRITES
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --sftp-idle-timeout
.PP
حداکثر زمان پیش از بستن اتصالات بیکار.
.PP
اگر در زمان تعیین‌شده هیچ اتصالی به استخر اتصالات بازگردانده نشود،
rclone استخر اتصالات را خالی خواهد کرد.
.PP
برای باز نگه داشتن نامحدود اتصالات، مقدار را روی 0 قرار دهید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: idle_timeout
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_IDLE_TIMEOUT
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 1m0s
.SS --sftp-chunk-size
.PP
اندازه قطعه (chunk) برای بارگذاری و بارگیری.
.PP
این گزینه حداکثر اندازه محموله داده (payload) را در بسته‌های پروتکل SFTP کنترل می‌کند.
استاندارد RFC این مقدار را به ۳۲۷۶۸ بایت (32k) محدود می‌کند که همان مقدار پیش‌فرض است.
با این حال، بسیاری از کارسازها از اندازه‌های بزرگ‌تر پشتیبانی می‌کنند که معمولاً به حداکثر
اندازه کل بسته ۲۵۶k محدود است، و تنظیم آن روی مقداری بزرگ‌تر، سرعت انتقال را در
پیوندهای با تأخیر بالا به‌طور چشمگیری افزایش می‌دهد.
این شامل OpenSSH نیز می‌شود و برای نمونه، مقدار 255k به‌خوبی کار می‌کند؛
فضای کافی برای سربار (overhead) باقی می‌گذارد و همچنان در محدوده حداکثر اندازه کل بسته ۲۵۶k قرار دارد.
.PP
حتماً پیش از استفاده از مقادیر بالاتر از 32k آزمایش‌های کاملی انجام دهید و تنها در صورتی
از آن استفاده کنید که همیشه به یک کارساز یکسان متصل می‌شوید یا پس از انجام آزمایش‌های
به اندازه کافی گسترده باشد.
اگر هنگام کپی کردن فایل‌های بزرگ‌تر خطاهایی مانند \[dq]failed to send packet payload: EOF\[dq]،
موارد مکرر \[dq]connection lost\[dq] یا \[dq]corrupted on transfer\[dq] دریافت کردید،
مقدار را کاهش دهید.
کارسازی که توسط rclone serve sftp اجرا می‌شود بسته‌ها را با حداکثر محموله استاندارد 32k
ارسال می‌کند، بنابراین هنگام بارگیری فایل‌ها نباید chunk_size دیگری تنظیم کنید، اما این
کارساز بسته‌هایی با اندازه کل تا 256k را می‌پذیرد؛ بنابراین برای بارگذاری‌ها می‌توان
chunk_size را مشابه مثال OpenSSH در بالا تنظیم کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 32Ki.SS --sftp-concurrency
.PP
حداکثر تعداد درخواست‌های معلق برای یک فایل
.PP
این گزینه حداکثر تعداد درخواست‌های معلق (outstanding) برای یک فایل را کنترل می‌کند.
افزایش آن باعث افزایش توان عملیاتی روی پیوندهای با تاخیر زیاد می‌شود، اما به بهای
مصرف حافظه بیشتر تمام خواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 64
.SS --sftp-connections
.PP
حداکثر تعداد اتصالات هم‌زمان SFTP؛ مقدار 0 به معنای نامحدود است.
.PP
توجه داشته باشید که تنظیم این گزینه به احتمال بسیار زیاد باعث ایجاد بن‌بست (deadlock) می‌شود،
بنابراین باید با احتیاط استفاده شود.
.PP
اگر در حال اجرای sync یا copy هستید، اطمینان حاصل کنید که connections یک واحد بیشتر
از مجموع \f[V]--transfers\f[R] و \f[V]--checkers\f[R] باشد.
.PP
اگر از \f[V]--check-first\f[R] استفاده می‌کنید، تنها کافی است یک واحد بیشتر
از بیشترین مقدار بین \f[V]--checkers\f[R] و \f[V]--transfers\f[R] باشد.
.PP
بنابراین برای \f[V]connections 3\f[R] باید از
\f[V]--checkers 2 --transfers 2 --check-first\f[R] یا
\f[V]--checkers 1 --transfers 1\f[R] استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: connections
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_CONNECTIONS
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 0
.SS --sftp-set-env
.PP
متغیرهای محیطی برای ارسال به sftp و دستورات
.PP
متغیرهای محیطی را در این قالب تنظیم کنید:
.IP
.nf
\f[C]
VAR=value
\f[R]
.fi
.PP
تا به کلاینت sftp و هر دستور در حال اجرا (مانند md5sum) منتقل شوند.
.PP
چندین متغیر را با فاصله از یکدیگر جدا کنید، مانند:
.IP
.nf
\f[C]
VAR1=value VAR2=value
\f[R]
.fi
.PP
و متغیرهای دارای فاصله را داخل علامت نقل‌قول قرار دهید، مانند:
.IP
.nf
\f[C]
\[dq]VAR3=value with space\[dq] \[dq]VAR4=value with space\[dq] VAR5=nospacehere
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: set_env
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_SET_ENV
.IP \[bu] 2
نوع: SpaceSepList
.IP \[bu] 2
پیش‌فرض:.SS --sftp-ciphers
.PP
فهرستی از سایفرها (رمزها) جدا شده با فاصله برای استفاده در رمزنگاری نشست،
به ترتیب اولویت.
.PP
حداقل یکی از آن‌ها باید با پیکربندی کارساز مطابقت داشته باشد.
این مورد می‌تواند برای نمونه با استفاده از ssh \-Q cipher بررسی شود.
.PP
اگر use_insecure_cipher برابر با true باشد، این گزینه نباید تنظیم شود.
.PP
مثال:
.IP
.nf
\f[C]
aes128-ctr aes192-ctr aes256-ctr aes128-gcm\[at]openssh.com aes256-gcm\[at]openssh.com
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: ciphers
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_CIPHERS
.IP \[bu] 2
نوع: SpaceSepList
.IP \[bu] 2
پیش‌فرض:
.SS --sftp-key-exchange
.PP
فهرستی از الگوریتم‌های تبادل کلید جدا شده با فاصله، به ترتیب اولویت.
.PP
حداقل یکی از آن‌ها باید با پیکربندی کارساز مطابقت داشته باشد.
این مورد می‌تواند برای نمونه با استفاده از ssh \-Q kex بررسی شود.
.PP
اگر use_insecure_cipher برابر با true باشد، این گزینه نباید تنظیم شود.
.PP
مثال:
.IP
.nf
\f[C]
sntrup761x25519-sha512\[at]openssh.com curve25519-sha256 curve25519-sha256\[at]libssh.org ecdh-sha2-nistp256
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: key_exchange
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_KEY_EXCHANGE
.IP \[bu] 2
نوع: SpaceSepList
.IP \[bu] 2
پیش‌فرض:
.SS --sftp-macs
.PP
فهرستی از الگوریتم‌های MAC (کد اصالت‌سنجی پیام) جدا شده با فاصله،
به ترتیب اولویت.
.PP
حداقل یکی از آن‌ها باید با پیکربندی کارساز مطابقت داشته باشد.
این مورد می‌تواند برای نمونه با استفاده از ssh \-Q mac بررسی شود.
.PP
مثال:
.IP
.nf
\f[C]
umac-64-etm\[at]openssh.com umac-128-etm\[at]openssh.com hmac-sha2-256-etm\[at]openssh.com
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: macs
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_MACS
.IP \[bu] 2
نوع: SpaceSepList
.IP \[bu] 2
پیش‌فرض:
.SS --sftp-host-key-algorithms
.PP
فهرستی از الگوریتم‌های کلید میزبان جدا شده با فاصله، به ترتیب اولویت.
.PP
حداقل یکی از آن‌ها باید با پیکربندی کارساز مطابقت داشته باشد.
این مورد می‌تواند برای نمونه با استفاده از ssh \-Q HostKeyAlgorithms بررسی شود.
.PP
نکته: این مورد می‌تواند بر نتیجهٔ مذاکره کلید با کارساز تأثیر بگذارد،
حتی اگر اعتبارسنجی کلید میزبان کارساز فعال نشده باشد.
.PP
مثال:
.IP
.nf
\f[C]
ssh-ed25519 ssh-rsa ssh-dss
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: host_key_algorithms
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_HOST_KEY_ALGORITHMS
.IP \[bu] 2
نوع: SpaceSepList
.IP \[bu] 2
پیش‌فرض:.SS --sftp-socks-proxy
.PP
میزبان پروکسی Socks 5.
.PP
از قالب‌های user:pass\[at]host:port، user\[at]host:port و host:port پشتیبانی می‌کند.
.PP
مثال:
.IP
.nf
\f[C]
myUser:myPass\[at]localhost:9005
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: socks_proxy
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_SOCKS_PROXY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sftp-http-proxy
.PP
نشانی اینترنتی (URL) برای پروکسی HTTP CONNECT.
.PP
این گزینه را روی نشانی اینترنتی یک پروکسی HTTP که از دستور HTTP CONNECT پشتیبانی می‌کند، تنظیم کنید.
.PP
از قالب‌های http://user:pass\[at]host:port، http://host:port و http://host پشتیبانی می‌کند.
.PP
مثال:
.IP
.nf
\f[C]
http://myUser:myPass\[at]proxyhostname.example.com:8000
\f[R]
.fi
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: http_proxy
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_HTTP_PROXY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sftp-copy-is-hardlink
.PP
برای فعال‌سازی رونوشت‌های سمت سرور با استفاده از پیوندهای سخت (hardlinks) این گزینه را تنظیم کنید.
.PP
پروتکل SFTP دستوری برای رونوشت تعریف نمی‌کند، بنابراین در حالت معمول رونوشت‌های سمت سرور در بک‌اند sftp مجاز نیستند.
.PP
با این حال، پروتکل SFTP از ایجاد پیوند سخت پشتیبانی می‌کند و در صورت فعال‌سازی این پرچم، بک‌اند sftp از رونوشت‌های سمت سرور پشتیبانی خواهد کرد. این رونوشت‌ها با ایجاد یک پیوند سخت از مبدا به مقصد پیاده‌سازی می‌شوند.
.PP
همه سرورهای sftp از این قابلیت پشتیبانی نمی‌کنند.
.PP
توجه داشته باشید که ایجاد پیوند سخت میان دو فایل هیچ فضای اضافی مصرف نمی‌کند، زیرا مبدا و مقصد همان فایل یکسان خواهند بود.
.PP
این ویژگی ممکن است برای پشتیبان‌گیری‌های ایجاد شده با --copy-dest مفید باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: copy_is_hardlink
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_COPY_IS_HARDLINK
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --sftp-description
.PP
توضیحات ریموت (remote).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_SFTP_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS "محدودیت‌ها (Limitations)"
.PP
در برخی سرورهای SFTP (مانند Synology) مسیرها برای SSH و SFTP متفاوت هستند، بنابراین هش‌ها نمی‌توانند به درستی محاسبه شوند.
می‌توانید از \f[V]--sftp-path-override\f[R] یا \f[V]disable_hashcheck\f[R] استفاده کنید.
.PP
تنها ssh agent پشتیبانی‌شده در Windows، برنامه pageant متعلق به Putty است.
.PP
کتابخانه SSH در Go به دلیل مسائل امنیتی، استفاده از رمزنگار aes128-cbc را به طور پیش‌فرض غیرفعال کرده است.
این مورد می‌تواند به ازای هر اتصال با تنظیم مقدار \f[V]use_insecure_cipher\f[R] در فایل پیکربندی بر روی \f[V]true\f[R] دوباره فعال شود.
جزئیات بیشتر درباره ناامنی این رمزنگار را می‌توانید در این مقاله (http://www.isg.rhul.ac.uk/~kp/SandPfinal.pdf) بیابید.
.PP
پروتکل SFTP در plan9 پشتیبانی نمی‌شود تا زمانی که این مشکل (https://github.com/pkg/sftp/issues/156) برطرف شود.
.PP
توجه داشته باشید از آنجا که SFTP مبتنی بر HTTP نیست، گزینه‌های زیر با آن کار نمی‌کنند: \f[V]--dump headers\f[R]، \f[V]--dump bodies\f[R]، \f[V]--dump auth\f[R].
.PP
توجه داشته باشید که هر دو گزینه \f[V]--timeout\f[R] و \f[V]--contimeout\f[R] پشتیبانی می‌شوند.
.SS rsync.net
.PP
سرویس rsync.net از طریق بک‌اند SFTP پشتیبانی می‌شود.
.PP
مستندات rsync.net را برای مثال‌های rclone ببینید (https://www.rsync.net/products/rclone.html).
.SS Hetzner Storage Box
.PP
سرویس Hetzner Storage Box از طریق بک‌اند SFTP روی درگاه ۲۳ پشتیبانی می‌شود.
.PP
برای جزئیات، مستندات Hetzner را ببینید (https://docs.hetzner.com/robot/storage-box/access/access-ssh-rsync-borg#rclone)
.SH Shade
.PP
این یک بک‌اند برای بستر Shade (https://shade.inc) است.
.SS "درباره Shade (About Shade)"
.PP
سرویس Shade (https://shade.inc) یک NAS ابری مبتنی بر هوش مصنوعی است که فایل‌های ابری شما را مانند یک دیسک محلی در دسترس قرار می‌دهد و برای جریان‌های کاری رسانه‌ای و خلاقانه بهینه‌سازی شده است.
این بستر دسترسی سریع و امن را همراه با جست‌وجوی زبان طبیعی، اشتراک‌گذاری آسان و فضای ذخیره‌سازی ابری مقیاس‌پذیر فراهم می‌کند.
.SS "حساب‌ها و قیمت‌گذاری (Accounts & Pricing)"
.PP
برای استفاده از این بک‌اند، باید یک حساب کاربری رایگان (https://app.shade.inc) در Shade ایجاد کنید.
می‌توانید با یک حساب رایگان شروع کرده و ۲۰ گیگابایت فضای ذخیره‌سازی به صورت رایگان دریافت کنید.
.SS "کاربرد (Usage)"
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند به هر عمق مورد نیازی تعیین شوند، مانند \f[V]remote:directory/subdirectory\f[R].
.SS "پیکربندی (Configuration)"
.PP
در اینجا نمونه‌ای از ایجاد پیکربندی Shade آورده شده است.
.PP
ابتدا یک حساب کاربری رایگان (https://app.shade.inc) ایجاد کرده و یک طرح را انتخاب کنید.
.PP
باید وارد حساب خود شوید و به ترتیب \f[V]API Key\f[R] و \f[V]Drive ID\f[R] را از بخش تنظیمات حساب کاربری و درایو ایجادشده به دست آورید.
.PP
اکنون اجرا کنید:
.PP
\f[V]rclone config\f[R]
.PP
این فرایند تعاملی را دنبال کنید:
.IP
.nf
\f[C]
$ rclone config
e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> n

Enter name for new remote.
name> Shade

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[OTHER OPTIONS]
xx / Shade FS
   \[rs] (shade)
[OTHER OPTIONS]
Storage> xx

Option drive_id.
The ID of your drive, see this in the drive settings. Individual rclone configs must be made per drive.
Enter a value.
drive_id> [YOUR_ID]

Option api_key.
An API key for your account.
Enter a value.
api_key> [YOUR_API_KEY]

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: shade
- drive_id: [YOUR_ID]
- api_key: [YOUR_API_KEY]
Keep this \[dq]Shade\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها
.PP
سرویس Shade از هش‌ها و نوشتن زمان‌های تغییر (mod times) پشتیبانی نمی‌کند.
.SS انتقال‌ها
.PP
سرویس Shade به‌طور پیش‌فرض از بارگذاری‌های چندبخشی (multipart uploads) استفاده می‌کند.
این بدان معناست که فایل‌ها تکه‌تکه شده و به‌صورت هم‌روند به Shade ارسال خواهند شد.
به منظور پیکربندی تعداد بارگذاری‌های همزمانی که می‌خواهید استفاده کنید،
گزینه \[aq]concurrency\[aq] را در بخش تنظیمات پیشرفته مشخص کنید.
توجه داشته باشید که این کار حافظه بیشتری مصرف کرده و درخواست‌های http بیشتری ایجاد می‌کند.
.SS حذف فایل‌ها
.PP
لطفاً توجه داشته باشید که هنگام حذف فایل‌ها در Shade از طریق rclone، فایل
به‌جای انتقال به سطل زباله، فوراً حذف خواهد شد.
این بدان معناست که فایل قابل بازیابی نخواهد بود.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مربوط به shade (Shade FS) آورده شده است.
.SS --shade-drive-id
.PP
شناسه (ID) درایو شما؛ این مورد را در تنظیمات درایو مشاهده کنید.
برای هر درایو باید پیکربندی‌های مجزای rclone ایجاد شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: drive_id
.IP \[bu] 2
متغیر محیطی: RCLONE_SHADE_DRIVE_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: true
.SS --shade-api-key
.PP
یک کلید API برای حساب کاربری شما.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: api_key
.IP \[bu] 2
متغیر محیطی: RCLONE_SHADE_API_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: true
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مربوط به shade (Shade FS) آورده شده است.
.SS --shade-endpoint
.PP
نقطه پایانی (Endpoint) برای سرویس.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: endpoint
.IP \[bu] 2
متغیر محیطی: RCLONE_SHADE_ENDPOINT
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --shade-chunk-size
.PP
اندازه تکه (Chunk size) مورد استفاده برای بارگذاری.
.PP
هر فایلی بزرگتر از این مقدار باشد، در تکه‌هایی با این اندازه بارگذاری خواهد شد.
.PP
توجه داشته باشید که این مقدار به ازای هر انتقال در حافظه نگهداری می‌شود، بنابراین افزایش آن
مصرف حافظه را افزایش خواهد داد.
.PP
حداقل 5MB و حداکثر 5GB است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_SHADE_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 64Mi.SS --shade-upload-concurrency
.PP
همزمانی برای بارگذاری‌ها و رونوشت‌های چندبخشی.
این مقدار، تعداد تکه‌هایی از یک فایل است که به‌صورت همزمان
برای بارگذاری‌ها و رونوشت‌های چندبخشی بارگذاری می‌شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_concurrency
.IP \[bu] 2
متغیر محیطی: RCLONE_SHADE_UPLOAD_CONCURRENCY
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 4
.SS --shade-max-upload-parts
.PP
حداکثر تعداد بخش‌ها در یک بارگذاری چندبخشی.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: max_upload_parts
.IP \[bu] 2
متغیر محیطی: RCLONE_SHADE_MAX_UPLOAD_PARTS
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 10000
.SS --shade-token
.PP
توکن JWT برای انجام عملیات‌های Shade FS.
این مقدار را تنظیم نکنید \- rclone آن را به‌طور خودکار تنظیم خواهد کرد
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_SHADE_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --shade-token-expiry
.PP
زمان انقضای توکن JWT.
این مقدار را تنظیم نکنید \- rclone آن را به‌طور خودکار تنظیم خواهد کرد
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_expiry
.IP \[bu] 2
متغیر محیطی: RCLONE_SHADE_TOKEN_EXPIRY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --shade-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر، بخش کدگذاری را در
بررسی اجمالی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_SHADE_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot
.SS --shade-description
.PP
توضیحات remote.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_SHADE_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS محدودیت‌ها
.PP
توجه داشته باشید که Shade به بزرگی و کوچکی حروف حساس نیست؛ بنابراین نمی‌توانید به‌طور هم‌زمان فایلی به نام
\[dq]Hello.doc\[dq] و فایلی به نام \[dq]hello.doc\[dq] داشته باشید.
.PP
سرویس Shade تنها از نام‌های فایل تا حداکثر ۲۵۵ نویسه پشتیبانی می‌کند.
.PP
دستور \f[V]rclone about\f[R] توسط backend مربوط به Shade پشتیبانی نمی‌شود.
پشتوانه‌های (backends) فاقد این قابلیت نمی‌توانند فضای خالی را برای یک rclone mount مشخص کنند یا از سیاست \f[V]mfs\f[R] (بیشترین فضای خالی) به‌عنوان عضوی از یک ریموت union در rclone استفاده نمایند.
.PP
فهرست پشتوانه‌هایی که از rclone about پشتیبانی نمی‌کنند (https://rclone.org/overview/#optional-features) و همچنین rclone about (https://rclone.org/commands/rclone_about) را ببینید.
.SS "دستورهای Backend"
.PP
در اینجا دستورهای اختصاصی backend مربوط به shade آورده شده‌اند.
.PP
آن‌ها را به این صورت اجرا کنید:
.IP
.nf
\f[C]
rclone backend COMMAND remote:
\f[R]
.fi
.PP
راهنمای زیر توضیح می‌دهد که هر دستور چه آرگومان‌هایی می‌پذیرد.
.PP
برای اطلاعات بیشتر دربارهٔ نحوهٔ ارسال گزینه‌ها و آرگومان‌ها، دستور backend (https://rclone.org/commands/rclone_backend) را ببینید.
.PP
این موارد را می‌توان روی یک backend در حال اجرا با استفاده از دستور rc مربوط به backend/command (https://rclone.org/rc/#backend-command) اجرا کرد.
.SH SMB
.PP
پروتکل SMB یک پروتکل ارتباطی برای اشتراک‌گذاری فایل‌ها از طریق
شبکه است (https://en.wikipedia.org/wiki/Server_Message_Block).
.PP
این بخش برای ارتباط با پروتکل SMB به کتابخانهٔ go-smb2 متکی است (https://github.com/CloudSoda/go-smb2).
.PP
مسیرها به‌صورت \f[V]remote:sharename\f[R] (یا \f[V]remote:\f[R]
برای دستور \f[V]lsd\f[R]) مشخص می‌شوند.
همچنین می‌توانید دایرکتوری‌های فرعی را نیز اضافه کنید، مانند
\f[V]remote:item/path/to/dir\f[R].
.SS نکات
.PP
بخش نخست مسیر باید نام اشتراک (share) باشد که هنگام آغاز اشتراک‌گذاری در Windows تعیین کرده‌اید.
در smbd، این مقدار همان عنوان بخش در فایل \f[V]smb.conf\f[R] (معمولاً در
\f[V]/etc/samba/\f[R]) است.
اگر مطمئن نیستید، می‌توانید با پرس‌وجو از ریشه، اشتراک‌ها را بیابید (مانند
\f[V]rclone lsd remote:\f[R]).
.PP
بدیهی است که از طریق rclone نمی‌توانید به چاپگرهای به‌اشتراک‌گذاشته‌شده دسترسی داشته باشید.
.PP
نمی‌توانید برای ورود از دسترسی ناشناس (Anonymous) استفاده کنید؛
در عوض باید کاربر \f[V]guest\f[R] را با گذرواژهٔ خالی به کار ببرید.
کلاینت rclone تلاش می‌کند هنگام بارگذاری فایل‌ها با کدگذاری فاصله‌ها و نقطه‌های انتهایی، از نام‌گذاری 8.3 اجتناب کند.
علاوه بر این، backend محلی (local) در ویندوز (https://rclone.org/local/#paths-on-windows) می‌تواند با استفاده از مسیرهای UNC به‌صورت
\f[V]\[rs]\[rs]server\[rs]share\f[R] به سرورهای SMB دسترسی یابد.
این قابلیت برای سیستم‌عامل‌های غیرویندوزی مانند Linux و macOS صدق نمی‌کند.
.SS پیکربندی
.PP
در ادامه نمونه‌ای از ساخت یک پیکربندی SMB آورده شده است.
.PP
ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در طول یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد.
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
XX / SMB / CIFS
   \[rs] (smb)
Storage> smb

Option host.
Samba hostname to connect to.
E.g. \[dq]example.com\[dq].
Enter a value.
host> localhost

Option user.
Samba username.
Enter a string value. Press Enter for the default (lesmi).
user> guest

Option port.
Samba port number.
Enter a signed integer. Press Enter for the default (445).
port> 

Option pass.
Samba password.
Choose an alternative below. Press Enter for the default (n).
y) Yes, type in my own password
g) Generate random password
n) No, leave this optional password blank (default)
y/g/n> g
Password strength in bits.
64 is just about memorable
128 is secure
1024 is the maximum
Bits> 64
Your password is: XXXX
Use this password? Please note that an obscured version of this 
password (and not the password itself) will be stored under your 
configuration file, so keep this generated password in a safe place.
y) Yes (default)
n) No
y/n> y

Option domain.
Domain name for NTLM authentication.
Enter a string value. Press Enter for the default (WORKGROUP).
domain> 

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: samba
- host: localhost
- user: guest
- pass: *** ENCRYPTED ***
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> d
\f[R]
.fi.SS "گزینه‌های استاندارد (Standard options)"
.PP
در اینجا گزینه‌های استاندارد مختص به smb (SMB / CIFS) آورده شده‌اند.
.SS --smb-host
.PP
نام میزبان (hostname) کارساز SMB برای اتصال به آن.
.PP
برای مثال:
\[dq]example.com\[dq].
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: host
.IP \[bu] 2
متغیر محیطی: RCLONE_SMB_HOST
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --smb-user
.PP
نام کاربری SMB.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user
.IP \[bu] 2
متغیر محیطی: RCLONE_SMB_USER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]$USER\[dq]
.SS --smb-port
.PP
شماره درگاه (پورت) SMB.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: port
.IP \[bu] 2
متغیر محیطی: RCLONE_SMB_PORT
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 445
.SS --smb-pass
.PP
گذرواژه SMB.
.PP
\f[B]توجه:\f[R] ورودی این گزینه باید مبهم‌سازی شود \- به rclone
obscure رجوع کنید (https://rclone.org/commands/rclone_obscure).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pass
.IP \[bu] 2
متغیر محیطی: RCLONE_SMB_PASS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --smb-domain
.PP
نام دامنه برای احراز هویت NTLM.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: domain
.IP \[bu] 2
متغیر محیطی: RCLONE_SMB_DOMAIN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]WORKGROUP\[dq]
.SS --smb-spn
.PP
نام اصلی خدمت (Service Principal Name).
.PP
برنامه rclone این نام را به کارساز ارائه می‌دهد.
برخی کارسازها از این مورد برای احراز هویت تکمیلی استفاده می‌کنند و اغلب
لازم است برای خوشه‌ها (clusters) تنظیم شود.
برای مثال:
.IP
.nf
\f[C]
cifs/remotehost:1020
\f[R]
.fi
.PP
اگر مطمئن نیستید خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: spn
.IP \[bu] 2
متغیر محیطی: RCLONE_SMB_SPN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --smb-use-kerberos
.PP
استفاده از احراز هویت Kerberos.
.PP
در صورت تنظیم، rclone به جای NTLM از احراز هویت Kerberos استفاده خواهد کرد.
این مورد نیازمند در دسترس بودن پیکربندی و کش اعتبارنامه (credentials cache) معتبر Kerberos در مکان‌های پیش‌فرض یا تعیین‌شده توسط متغیرهای محیطی KRB5_CONFIG و KRB5CCNAME است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: use_kerberos
.IP \[bu] 2
متغیر محیطی: RCLONE_SMB_USE_KERBEROS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در این بخش گزینه‌های پیشرفته مختص smb (SMB / CIFS) آورده شده‌اند.
.SS --smb-idle-timeout
.PP
حداکثر زمان پیش از بستن اتصالات بیکار (idle).
.PP
اگر در مدت‌زمان مشخص‌شده هیچ اتصالی به استخر اتصالات (connection pool) بازگردانده نشود، rclone استخر اتصالات را خالی خواهد کرد.
.PP
برای باز نگه داشتن نامحدود اتصالات، مقدار را روی 0 تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: idle_timeout
.IP \[bu] 2
متغیر محیطی: RCLONE_SMB_IDLE_TIMEOUT
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 1m0s
.SS --smb-hide-special-share
.PP
مخفی کردن اشتراک‌های ویژه (مانند
print$) که کاربران نباید به آن‌ها دسترسی داشته باشند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hide_special_share
.IP \[bu] 2
متغیر محیطی: RCLONE_SMB_HIDE_SPECIAL_SHARE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --smb-case-insensitive
.PP
تعیین این‌که آیا سرور برای عدم حساسیت به بزرگی و کوچکی حروف (case-insensitive) پیکربندی شده است یا خیر.
.PP
روی اشتراک‌های ویندوز همیشه true است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: case_insensitive
.IP \[bu] 2
متغیر محیطی: RCLONE_SMB_CASE_INSENSITIVE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --smb-kerberos-ccache
.PP
مسیر کش اعتبارنامه Kerberos (krb5cc).
.PP
متغیر محیطی پیش‌فرض KRB5CCNAME را بازنویسی کرده و به این نمونه از backend مربوط به SMB اجازه می‌دهد از یک فایل کش Kerberos متفاوت استفاده کند.
این ویژگی هنگام سوار کردن (mount) چندین SMB با اعتبارنامه‌های مختلف یا اجرا در محیط‌های چندکاربره کاربردی است.
.PP
قالب‌های پشتیبانی‌شده: - FILE:/path/to/ccache \[en] استفاده از فایل مشخص‌شده.
- DIR:/path/to/ccachedir \[en] استفاده از فایل اصلی درون دایرکتوری مشخص‌شده.
- /path/to/ccache \[en] تفسیرشده به عنوان مسیر فایل.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: kerberos_ccache
.IP \[bu] 2
متغیر محیطی: RCLONE_SMB_KERBEROS_CCACHE
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --smb-encoding
.PP
کدگذاری مورد استفاده برای backend.
.PP
برای اطلاعات بیشتر، بخش کدگذاری را در نمای کلی
(<https://rclone.org/overview/#encoding>) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_SMB_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض:
Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Ctl,RightSpace,RightPeriod,InvalidUtf8,Dot
.SS --smb-description
.PP
توضیحات remote.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_SMB_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SH Storj
.PP
سرویس Storj (<https://storj.io>) در حال بازتعریف فضای ابری است تا از آیندهٔ داده‌ها به‌شیوه‌ای پایدار و اقتصادی پشتیبانی کند.
استورج از عرضهٔ گسترده و جهانی منابع بلااستفاده بهره می‌برد تا امنیت، پایداری و کارایی بهتری را در خدمات ارائه دهد.
با Storj تا ۹۰٪ کاهش هزینه‌ها و کاهش ردپای کربن را تجربه کنید.
.PP
استورج یک سرویس ذخیره‌سازی شیء (object storage) رمزگذاری‌شده، امن و مقرون‌به‌صرفه است که به شما امکان می‌دهد مقادیر انبوهی از داده‌ها را به‌صورت غیرمتمرکز ذخیره، پشتیبان‌گیری و بایگانی کنید.
.SS "گزینه‌های Backend"
.PP
از Storj می‌توان هم با این backend بومی و هم با backend مربوط به s3 با استفاده از درگاه سازگار با S3 استورج (<https://rclone.org/s3/#storj>) (اشتراکی یا خصوصی) استفاده کرد.
.PP
از این backend برای بهره‌مندی از رمزگذاری سمت کلاینت و همچنین دستیابی به بهترین عملکرد ممکن در بارگیری (دانلود) استفاده کنید.
بارگذاری‌ها به‌صورت محلی تحت کدگذاری پاک‌شدگی (erasure coding) قرار می‌گیرند، بنابراین بارگذاری ۱ گیگابایت داده منجر به ارسال ۲٫۶۸ گیگابایت داده به گره‌های ذخیره‌سازی در سراسر شبکه خواهد شد.
.PP
از backend مربوط به s3 و یکی از درگاه‌های میزبانی‌شدهٔ سازگار با S3 برای افزایش کارایی بارگذاری و کاهش بار روی سیستم‌ها و شبکهٔ خود استفاده کنید.
بارگذاری‌ها در سمت سرور رمزگذاری شده و تحت erasure coding قرار می‌گیرند، بنابراین بارگذاری ۱ گیگابایت داده تنها به ارسال ۱ گیگابایت داده به گره‌های ذخیره‌سازی در سراسر شبکه منتهی می‌شود.
.PP
مقایسهٔ شانه‌به‌شانه با جزئیات بیشتر:
.IP \[bu] 2
ویژگی‌ها:
.RS 2
.IP \[bu] 2
\f[I]Storj backend\f[R]: از پروتکل بومی RPC استفاده می‌کند و مستقیماً به گره‌های ذخیره‌سازی میزبان داده متصل می‌شود.
به منابع CPU بیشتری برای کدگذاری/کدگشایی نیاز دارد، دارای تقویت ترافیک شبکه (به‌ویژه هنگام بارگذاری) است و اتصالات TCP متعددی را مصرف می‌کند.
.IP \[bu] 2
\f[I]S3 backend\f[R]: از REST API سازگار با S3 از طریق درگاه‌های اشتراکی استفاده می‌کند.
تقویت ترافیک شبکه وجود ندارد، اما کارایی به درگاه‌های اشتراکی وابسته است و کلید رمزگذاری محرمانه با درگاه به اشتراک گذاشته می‌شود.
.RE
.IP \[bu] 2
کاربرد معمول:
.RS 2
.IP \[bu] 2
\f[I]Storj backend\f[R]: محیط‌های سرور و دسکتاپ‌هایی با منابع، سرعت اینترنت و پایداری اتصال کافی؛ و برنامه‌هایی که در آن‌ها رمزگذاری سمت کلاینت Storj الزامی است.
.IP \[bu] 2
\f[I]S3 backend\f[R]: دسکتاپ‌ها و موارد مشابه با منابع، سرعت اینترنت یا اتصال محدود.
.RE
.IP \[bu] 2
امنیت:
.RS 2
.IP \[bu] 2
\f[I]Storj backend\f[R]: \f[B]قوی\f[R].
کلید رمزگذاری خصوصی نیازی به خروج از رایانهٔ محلی ندارد.
.IP \[bu] 2
\f[I]S3 backend\f[R]: \f[B]ضعیف‌تر\f[R].
کلید رمزگذاری خصوصی با سرویس احراز هویت درگاه میزبانی‌شده (<https://docs.storj.io/dcs/api-reference/s3-compatible-gateway#security-and-encryption>) به اشتراک گذاشته می‌شود، جایی که به‌صورت رمزگذاری‌شده ذخیره می‌شود.
در صورت ترکیب با backend مربوط به crypt در rclone، امنیت آن می‌تواند تقویت شود.
.RE
.IP \[bu] 2
مصرف پهنای باند (بارگذاری):
.RS 2
.IP \[bu] 2
\f[I]Storj backend\f[R]: \f[B]بیشتر\f[R].
از آنجا که داده‌ها در سمت کلاینت erasure code می‌شوند، هم داده‌های اصلی و هم بیت‌های برابری (parities) باید بارگذاری شوند.
حدود \[ti]۲٫۷ برابر دادهٔ بیشتری برای بارگذاری لازم است.
کلاینت ممکن است بارگذاری را با تعداد گره‌های حتی بیشتری (حدود \[ti]۳٫۷ برابر بیشتر) آغاز کند و بارگذاری‌های کُند را رها یا متوقف کند.
.IP \[bu] 2
\f[I]S3 backend\f[R]: \f[B]معمولی\f[R].
تنها داده‌های خام بارگذاری می‌شوند و عملیات erasure coding روی درگاه انجام می‌گیرد.
.RE
.IP \[bu] 2
مصرف پهنای باند (بارگیری):
.RS 2
.IP \[bu] 2
\f[I]Storj backend\f[R]: \f[B]تقریباً معمولی\f[R].
تنها به حداقل مقدار داده نیاز است، اما برای اجتناب از ارائه‌دهندگان دادهٔ بسیار کُند، از چند منبع بیشتر استفاده شده و کُندترین‌ها نادیده گرفته می‌شوند (حداکثر ۱٫۲ برابر سربار).
.IP \[bu] 2
\f[I]S3 backend\f[R]: \f[B]معمولی\f[R].
تنها داده‌های خام دریافت می‌شوند و بازسازی erasure coding روی درگاه اشتراکی رخ می‌دهد.
.RE
.IP \[bu] 2
مصرف پردازنده (CPU):
.RS 2
.IP \[bu] 2
\f[I]Storj backend\f[R]: \f[B]بیشتر\f[R]، اما قابل پیش‌بینی‌تر.
عملیات Erasure code و رمزگذاری/رمزگشایی به‌صورت محلی انجام می‌شود که به بار پردازشی قابل‌توجهی نیاز دارد.
.IP \[bu] 2
\f[I]S3 backend\f[R]: \f[B]کمتر\f[R].
عملیات Erasure code و رمزگذاری/رمزگشایی روی درگاه‌های اشتراکی s3 انجام می‌شود (و بنابراین به بار کاری فعلی روی درگاه‌ها وابسته است).
.RE
.IP \[bu] 2
مصرف اتصالات TCP:
.RS 2
.IP \[bu] 2
\f[I]Storj backend\f[R]: \f[B]بالا\f[R].
به یک اتصال مستقیم به هر یک از گره‌های Storj نیاز است که منجر به ۱۱۰ اتصال در بارگذاری و ۳۵ اتصال در بارگیری به ازای هر قطعهٔ ۶۴ مگابایتی می‌شود.
همهٔ اتصالات به‌طور فعال استفاده نمی‌شوند (اتصالات کند هرس می‌شوند)، اما همهٔ آن‌ها باز می‌شوند.
ممکن است تنظیم محدودیت حداکثر فایل‌های باز (<https://rclone.org/storj/#known-issues>) لازم باشد.
.IP \[bu] 2
\f[I]S3 backend\f[R]: \f[B]معمولی\f[R].
به ازای هر رشتهٔ (thread) بارگیری/بارگذاری، تنها یک اتصال به درگاه اشتراکی نیاز است.
.RE
.IP \[bu] 2
کارایی کلی:
.RS 2
.IP \[bu] 2
\f[I]Storj backend\f[R]: با منابع کافی (پردازنده و پهنای باند)، backend مربوط به \f[I]storj\f[R] می‌تواند حتی تا ۲ برابر کارایی بهتری ارائه دهد.
داده‌ها به‌جای درگاه، مستقیماً از/به کلاینت بارگیری یا بارگذاری می‌شوند.
.IP \[bu] 2
\f[I]S3 backend\f[R]: می‌تواند در دستگاه‌های لبه (edge) با پردازنده و پهنای باند محدود سریع‌تر باشد؛ زیرا درگاه‌های اشتراکی سازگار با S3 رمزگذاری/رمزگشایی و erasure coding را بر عهده می‌گیرند و تقویت ترافیک شبکه رخ نمی‌دهد.
.RE
.IP \[bu] 2
تمرکززدایی:
.RS 2
.IP \[bu] 2
\f[I]Storj backend\f[R]: \f[B]بالا\f[R].
داده‌ها مستقیماً از شبکهٔ ابری توزیع‌شدهٔ ارائه‌دهندگان ذخیره‌سازی دریافت می‌شوند.
.IP \[bu] 2
\f[I]S3 backend\f[R]: \f[B]پایین\f[R].
نیازمند یک درگاه S3 فعال است (چه خودمیزبان باشد و چه میزبانی‌شده توسط Storj).
.RE.IP \[bu] 2
محدودیت‌ها:
.RS 2
.IP \[bu] 2
\f[I]بک‌اند Storj\f[R]: اجرای \f[V]rclone checksum\f[R] بدون بارگیری امکان‌پذیر نیست، زیرا متادیتای checksum هنگام بارگذاری محاسبه نمی‌شود
.IP \[bu] 2
\f[I]بک‌اند S3\f[R]: کلید رمزنگاری محرمانه با gateway به اشتراک گذاشته می‌شود
.RE
.SS پیکربندی
.PP
برای ایجاد یک پیکربندی Storj جدید به یکی از موارد زیر نیاز دارید:
.IP \[bu] 2
یک Access Grant که شخص دیگری با شما به اشتراک گذاشته است.
.IP \[bu] 2
یک API Key (https://storj.dev/learn/concepts/access/access-grants/api-key) از پروژهٔ Storj که در آن عضو هستید.
.PP
در اینجا نمونه‌ای از نحوهٔ ایجاد یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی خواهد کرد:
.SS راه‌اندازی با Access Grant
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / Storj Decentralized Cloud Storage
   \[rs] \[dq]storj\[dq]
[snip]
Storage> storj
** See help for storj backend at: https://rclone.org/storj **

Choose an authentication method.
Enter a string value. Press Enter for the default (\[dq]existing\[dq]).
Choose a number from below, or type in your own value
 1 / Use an existing access grant.
   \[rs] \[dq]existing\[dq]
 2 / Create a new access grant from satellite address, API key, and passphrase.
   \[rs] \[dq]new\[dq]
provider> existing
Access Grant.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
access_grant> your-access-grant-received-by-someone-else
Remote config
Configuration complete.
Options:
- type: storj
- access_grant: your-access-grant-received-by-someone-else
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.SS راه‌اندازی با API Key و Passphrase
.IP
.nf
\f[C]
No remotes found, make a new one\[rs]?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / Storj Decentralized Cloud Storage
   \[rs] \[dq]storj\[dq]
[snip]
Storage> storj
** See help for storj backend at: https://rclone.org/storj **

Choose an authentication method.
Enter a string value. Press Enter for the default (\[dq]existing\[dq]).
Choose a number from below, or type in your own value
 1 / Use an existing access grant.
   \[rs] \[dq]existing\[dq]
 2 / Create a new access grant from satellite address, API key, and passphrase.
   \[rs] \[dq]new\[dq]
provider> new
Satellite Address. Custom satellite address should match the format: \[ga]<nodeid>\[at]<address>:<port>\[ga].
Enter a string value. Press Enter for the default (\[dq]us1.storj.io\[dq]).
Choose a number from below, or type in your own value
 1 / US1
   \[rs] \[dq]us1.storj.io\[dq]
 2 / EU1
   \[rs] \[dq]eu1.storj.io\[dq]
 3 / AP1
   \[rs] \[dq]ap1.storj.io\[dq]
satellite_address> 1
API Key.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
api_key> your-api-key-for-your-storj-project
Encryption Passphrase. To access existing objects enter passphrase used for uploading.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
passphrase> your-human-readable-encryption-passphrase
Remote config
Configuration complete.
Options:
- type: storj
- satellite_address: 12EayRS2V1kEsWESU9QMRseFhdxYxKicsiFmxrsLZHeLUtdps3S\[at]us1.storj.io:7777
- api_key: your-api-key-for-your-storj-project
- passphrase: your-human-readable-encryption-passphrase
- access_grant: the-access-grant-generated-from-the-api-key-and-passphrase
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص به storj (ذخیره‌سازی ابری غیرمتمرکز Storj) آورده شده است.
.SS --storj-provider
.PP
یک روش احراز هویت را انتخاب کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: provider
.IP \[bu] 2
متغیر محیطی: RCLONE_STORJ_PROVIDER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]existing\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]existing\[dq]
.RS 2
.IP \[bu] 2
استفاده از یک مجوز دسترسی (access grant) موجود.
.RE
.IP \[bu] 2
\[dq]new\[dq]
.RS 2
.IP \[bu] 2
ایجاد یک مجوز دسترسی جدید از طریق نشانی ماهواره (satellite address)، کلید API و عبارت عبور (passphrase).
.RE
.RE
.SS --storj-access-grant
.PP
مجوز دسترسی (Access grant).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: access_grant
.IP \[bu] 2
متغیر محیطی: RCLONE_STORJ_ACCESS_GRANT
.IP \[bu] 2
ارائه‌دهنده: existing
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --storj-satellite-address
.PP
نشانی ماهواره (Satellite address).
.PP
نشانی سفارشی ماهواره باید با این قالب مطابقت داشته باشد:
\f[V]<nodeid>\[at]<address>:<port>\f[R].
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: satellite_address
.IP \[bu] 2
متغیر محیطی: RCLONE_STORJ_SATELLITE_ADDRESS
.IP \[bu] 2
ارائه‌دهنده: new
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]us1.storj.io\[dq]
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]us1.storj.io\[dq]
.RS 2
.IP \[bu] 2
US1
.RE
.IP \[bu] 2
\[dq]eu1.storj.io\[dq]
.RS 2
.IP \[bu] 2
EU1
.RE
.IP \[bu] 2
\[dq]ap1.storj.io\[dq]
.RS 2
.IP \[bu] 2
AP1
.RE
.RE.SS --storj-api-key
.PP
کلید API.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: api_key
.IP \[bu] 2
متغیر محیطی: RCLONE_STORJ_API_KEY
.IP \[bu] 2
ارائه‌دهنده: new
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --storj-passphrase
.PP
عبارت عبور رمزنگاری.
.PP
برای دسترسی به اشیاء موجود، عبارت عبور استفاده‌شده هنگام بارگذاری را وارد کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: passphrase
.IP \[bu] 2
متغیر محیطی: RCLONE_STORJ_PASSPHRASE
.IP \[bu] 2
ارائه‌دهنده: new
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مختص به storj (فضای ذخیره‌سازی ابری غیرمتمرکز Storj) آمده است.
.SS --storj-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_STORJ_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS کاربرد
.PP
مسیرها به صورت \f[V]remote:bucket\f[R] (یا \f[V]remote:\f[R] برای
دستور \f[V]lsf\f[R]) مشخص می‌شوند.
همچنین می‌توانید زیردایرکتوری‌ها را نیز وارد کنید، مانند
\f[V]remote:bucket/path/to/dir\f[R].
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید.
.SS ساخت یک باکت جدید
.PP
از دستور \f[V]mkdir\f[R] برای ایجاد یک باکت جدید استفاده کنید، مثلاً
\f[V]bucket\f[R].
.IP
.nf
\f[C]
rclone mkdir remote:bucket
\f[R]
.fi
.SS فهرست کردن همه باکت‌ها
.PP
از دستور \f[V]lsf\f[R] برای فهرست کردن همه باکت‌ها استفاده کنید.
.IP
.nf
\f[C]
rclone lsf remote:
\f[R]
.fi
.PP
به نویسه دونقطه (\f[V]:\f[R]) در انتهای خط فرمان توجه کنید.
.SS حذف یک باکت
.PP
از دستور \f[V]rmdir\f[R] برای حذف یک باکت خالی استفاده کنید.
.IP
.nf
\f[C]
rclone rmdir remote:bucket
\f[R]
.fi
.PP
از دستور \f[V]purge\f[R] برای حذف یک باکت غیرخالی به همراه تمامی
محتویات آن استفاده کنید.
.IP
.nf
\f[C]
rclone purge remote:bucket
\f[R]
.fi.SS بارگذاری اشیاء
.PP
برای بارگذاری یک شیء از دستور \f[V]copy\f[R] استفاده کنید.
.IP
.nf
\f[C]
rclone copy --progress /home/local/directory/file.ext remote:bucket/path/to/dir/
\f[R]
.fi
.PP
گزینهٔ \f[V]--progress\f[R] برای نمایش اطلاعات پیشرفت کار است.
اگر نیازی به این اطلاعات ندارید، آن را حذف کنید.
.PP
از یک پوشه در مسیر محلی برای بارگذاری تمامی اشیاء آن استفاده کنید.
.IP
.nf
\f[C]
rclone copy --progress /home/local/directory/ remote:bucket/path/to/dir/
\f[R]
.fi
.PP
تنها فایل‌های تغییریافته کپی خواهند شد.
.SS فهرست کردن اشیاء
.PP
برای فهرست کردن بازگشتی تمام اشیاء درون یک باکت، از دستور \f[V]ls\f[R]
استفاده کنید.
.IP
.nf
\f[C]
rclone ls remote:bucket
\f[R]
.fi
.PP
پوشه را به مسیر دوردست (remote) اضافه کنید تا تمام اشیاء درون این
پوشه به‌صورت بازگشتی فهرست شوند.
.IP
.nf
\f[C]
$ rclone ls remote:bucket
/path/to/dir/
\f[R]
.fi
.PP
برای فهرست کردن غیربازگشتی تمام اشیاء درون یک باکت یا یک پوشه، از دستور
\f[V]lsf\f[R] استفاده کنید.
.IP
.nf
\f[C]
rclone lsf remote:bucket/path/to/dir/
\f[R]
.fi
.SS بارگیری اشیاء
.PP
برای بارگیری یک شیء از دستور \f[V]copy\f[R] استفاده کنید.
.IP
.nf
\f[C]
rclone copy --progress remote:bucket/path/to/dir/file.ext /home/local/directory/
\f[R]
.fi
.PP
گزینهٔ \f[V]--progress\f[R] برای نمایش اطلاعات پیشرفت کار است.
اگر نیازی به این اطلاعات ندارید، آن را حذف کنید.
.PP
از یک پوشه در مسیر دوردست (remote) برای بارگیری تمامی اشیاء آن استفاده کنید.
.IP
.nf
\f[C]
rclone copy --progress remote:bucket/path/to/dir/ /home/local/directory/
\f[R]
.fi
.SS حذف اشیاء
.PP
برای حذف یک شیء منفرد از دستور \f[V]deletefile\f[R] استفاده کنید.
.IP
.nf
\f[C]
rclone deletefile remote:bucket/path/to/dir/file.ext
\f[R]
.fi
.PP
برای حذف تمام اشیاء درون یک پوشه از دستور \f[V]delete\f[R] استفاده کنید.
.IP
.nf
\f[C]
rclone delete remote:bucket/path/to/dir/
\f[R]
.fi.SS چاپ حجم کل اشیاء
.PP
از دستور \f[V]size\f[R] برای چاپ حجم کل اشیاء در یک باکت یا یک پوشه استفاده کنید.
.IP
.nf
\f[C]
rclone size remote:bucket/path/to/dir/
\f[R]
.fi
.SS همگام‌سازی دو مکان
.PP
از دستور \f[V]sync\f[R] برای همگام‌سازی مبدأ با مقصد استفاده کنید؛ به‌گونه‌ای که تنها مقصد تغییر کند و فایل‌های اضافی حذف شوند.
.IP
.nf
\f[C]
rclone sync --interactive --progress /home/local/directory/ remote:bucket/path/to/dir/
\f[R]
.fi
.PP
پرچم \f[V]--progress\f[R] برای نمایش اطلاعات پیشرفت کار است. در صورتی که به این اطلاعات نیازی ندارید، آن را حذف کنید.
.PP
از آنجا که این عملیات می‌تواند باعث از دست رفتن داده‌ها شود، ابتدا با پرچم \f[V]--dry-run\f[R] آن را بیازمایید تا دقیقاً ببینید چه مواردی کپی و حذف خواهند شد.
.PP
همگام‌سازی می‌تواند از Storj به سیستم فایل محلی نیز انجام شود.
.IP
.nf
\f[C]
rclone sync --interactive --progress remote:bucket/path/to/dir/ /home/local/directory/
\f[R]
.fi
.PP
یا بین دو باکت Storj.
.IP
.nf
\f[C]
rclone sync --interactive --progress remote-us:bucket/path/to/dir/ remote-europe:bucket/path/to/dir/
\f[R]
.fi
.PP
یا حتی بین یک ذخیره‌سازی ابری دیگر و Storj.
.IP
.nf
\f[C]
rclone sync --interactive --progress s3:bucket/path/to/dir/ storj:bucket/path/to/dir/
\f[R]
.fi
.SS محدودیت‌ها
.PP
دستور \f[V]rclone about\f[R] توسط پس‌بند Storj در rclone پشتیبانی نمی‌شود. پس‌بندهای فاقد این قابلیت نمی‌توانند فضای آزاد را برای یک rclone mount تعیین کنند یا از سیاست \f[V]mfs\f[R] (بیشترین فضای آزاد) به‌عنوان عضوی از یک remote ترکیبی (union) در rclone بهره ببرند.
.PP
به فهرست پس‌بندهایی که از rclone about پشتیبانی نمی‌کنند
(<https://rclone.org/overview/#optional-features>)
و rclone about
(<https://rclone.org/commands/rclone_about>)
مراجعه کنید.
.SS مشکلات شناخته‌شده
.PP
اگر با خطاهایی مانند \f[V]too many open files\f[R] مواجه شدید، این حالت معمولاً زمانی رخ می‌دهد که از حد پیش‌فرض \f[V]ulimit\f[R] برای حداکثر فایل‌های باز سیستم فراتر رفته باشید.
پروتکل بومی Storj تعداد زیادی اتصال TCP باز می‌کند (که هر یک از آن‌ها یک فایل باز به‌شمار می‌رود).
برای یک جریان بارگذاری واحد، می‌توانید انتظار باز شدن ۱۱۰ اتصال TCP را داشته باشید.
برای یک جریان بارگیری واحد، می‌توانید انتظار ۳۵ اتصال را داشته باشید.
این دسته از اتصالات برای هر قطعهٔ 64 MiB باز خواهد شد و همچنین باید انتظار استفادهٔ مجدد از اتصالات TCP را داشته باشید.
اگر انتقال‌های زیادی انجام دهید، در نهایت به اکثر گره‌های ذخیره‌سازی (هزاران گره) اتصال باز خواهید کرد.
.PP
برای رفع این موارد، لطفاً محدودیت‌های سیستم خود را افزایش دهید.
می‌توانید این کار را با اجرای دستور \f[V]ulimit -n 65536\f[R] دقیقاً پیش از اجرای rclone انجام دهید.
برای تغییر دائمی‌تر محدودیت‌ها، می‌توانید این مقدار را به اسکریپت راه‌اندازی پوستهٔ خود، مانند
\f[V]$HOME/.bashrc\f[R] اضافه کنید، یا پیکربندی سراسری سیستم را که معمولاً در
\f[V]/etc/sysctl.conf\f[R] و/یا
\f[V]/etc/security/limits.conf\f[R] قرار دارد تغییر دهید؛ اما لطفاً به راهنمای سیستم‌عامل خود مراجعه کنید..SH SugarSync
.PP
سرویس SugarSync (https://sugarsync.com) یک سرویس ابری است که امکان همگام‌سازی فعال فایل‌ها را میان رایانه‌ها و سایر دستگاه‌ها برای پشتیبان‌گیری، دسترسی، همگام‌سازی و اشتراک‌گذاری فایل فراهم می‌کند.
.SS پیکربندی (Configuration)
.PP
راه‌اندازی اولیه SugarSync شامل دریافت یک توکن از SugarSync است که می‌توانید آن را با rclone انجام دهید.
فرمان \f[V]rclone config\f[R] شما را در این مراحل راهنمایی می‌کند.
.PP
در اینجا نمونه‌ای از نحوه ایجاد یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این فرمان شما را در یک فرایند راه‌اندازی تعاملی هدایت می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / Sugarsync
   \[rs] \[dq]sugarsync\[dq]
[snip]
Storage> sugarsync
** See help for sugarsync backend at: https://rclone.org/sugarsync **

Sugarsync App ID.
Leave blank to use rclone\[aq]s.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
app_id> 
Sugarsync Access Key ID.
Leave blank to use rclone\[aq]s.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
access_key_id> 
Sugarsync Private Access Key
Leave blank to use rclone\[aq]s.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
private_access_key> 
Permanently delete files if true
otherwise put them in the deleted files.
Enter a boolean value (true or false). Press Enter for the default (\[dq]false\[dq]).
hard_delete> 
Edit advanced config? (y/n)
y) Yes
n) No (default)
y/n> n
Remote config
Username (email address)> nick\[at]craig-wood.com
Your Sugarsync password is only required during setup and will not be stored.
password:
Configuration complete.
Options:
- type: sugarsync
- refresh_token: https://api.sugarsync.com/app-authorization/XXXXXXXXXXXXXXXXXX
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
توجه داشته باشید که فرایند پیکربندی، ایمیل و گذرواژه شما را درخواست می‌کند اما آن‌ها را ذخیره نمی‌کند؛ بلکه تنها برای دریافت توکن اولیه از آن‌ها استفاده می‌کند.
.PP
پس از انجام پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (نام ریموت خود را به جای \f[V]remote\f[R] قرار دهید):
.PP
فهرست کردن دایرکتوری‌ها (پوشه‌های همگام‌سازی) در بالاترین سطح از SugarSync شما:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن همه فایل‌ها در پوشه \[dq]Test\[dq] در SugarSync:
.IP
.nf
\f[C]
rclone ls remote:Test
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به پوشه‌ای در SugarSync به نام backup:
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند تا عمق مورد نیاز مشخص شوند، به عنوان مثال \f[V]remote:directory/subdirectory\f[R].
.PP
\f[B]نکته مهم:\f[R] شما نمی‌توانید در پوشه بالاترین سطح فایلی ایجاد کنید؛ بلکه باید یک پوشه بسازید که rclone آن را به عنوان یک \[dq]Sync Folder\[dq] در SugarSync ایجاد خواهد کرد..SS زمان‌های تغییر و هش‌ها
.PP
سرویس SugarSync از زمان‌های تغییر یا هش‌ها پشتیبانی نمی‌کند، بنابراین
همگام‌سازی به‌طور پیش‌فرض با بررسی \f[V]--size-only\f[R] انجام خواهد شد.
توجه داشته باشید که استفاده از \f[V]--update\f[R] کار خواهد کرد، زیرا rclone می‌تواند زمان
بارگذاری فایل‌ها را بخواند.
.SS نویسه‌های محدودشده نام فایل
.PP
سرویس SugarSync نویسه‌های مجموعه پیش‌فرض نویسه‌های محدودشده
(https://rclone.org/overview/#restricted-characters) را به‌جز DEL جایگزین می‌کند.
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند
شد (https://rclone.org/overview/#invalid-utf8)، زیرا نمی‌توان از آن‌ها
در رشته‌های XML استفاده کرد.
.SS حذف فایل‌ها
.PP
فایل‌های حذف‌شده به‌طور پیش‌فرض به پوشه \[dq]Deleted items\[dq] منتقل
می‌شوند.
.PP
با این حال، اگر می‌خواهید فایل‌ها بلافاصله حذف شوند، می‌توانید پرچم \f[V]--sugarsync-hard-delete\f[R] را
ارائه داده یا پارامتر پیکربندی \f[V]hard_delete = true\f[R] را
تنظیم کنید.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مخصوص sugarsync (Sugarsync) آورده شده است.
.SS --sugarsync-app-id
.PP
شناسه برنامه Sugarsync (App ID).
.PP
جهت استفاده از شناسه rclone، این مقدار را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: app_id
.IP \[bu] 2
متغیر محیطی: RCLONE_SUGARSYNC_APP_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sugarsync-access-key-id
.PP
شناسه کلید دسترسی Sugarsync (Access Key ID).
.PP
جهت استفاده از کلید rclone، این مقدار را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: access_key_id
.IP \[bu] 2
متغیر محیطی: RCLONE_SUGARSYNC_ACCESS_KEY_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sugarsync-private-access-key
.PP
کلید دسترسی خصوصی Sugarsync (Private Access Key).
.PP
جهت استفاده از کلید rclone، این مقدار را خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: private_access_key
.IP \[bu] 2
متغیر محیطی: RCLONE_SUGARSYNC_PRIVATE_ACCESS_KEY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --sugarsync-hard-delete
.PP
در صورت true بودن، فایل‌ها به‌صورت دائمی حذف می‌شوند؛ در غیر این صورت درون بخش فایل‌های
حذف‌شده قرار می‌گیرند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hard_delete
.IP \[bu] 2
متغیر محیطی: RCLONE_SUGARSYNC_HARD_DELETE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفتهٔ ویژهٔ sugarsync (Sugarsync) آورده شده است.
.SS --sugarsync-refresh-token
.PP
توکن تازه‌سازی Sugarsync.
.PP
در حالت عادی خالی بگذارید؛ به‌طور خودکار توسط rclone پیکربندی می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: refresh_token
.IP \[bu] 2
متغیر محیطی: RCLONE_SUGARSYNC_REFRESH_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --sugarsync-authorization
.PP
مجوز دسترسی Sugarsync.
.PP
در حالت عادی خالی بگذارید؛ به‌طور خودکار توسط rclone پیکربندی می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: authorization
.IP \[bu] 2
متغیر محیطی: RCLONE_SUGARSYNC_AUTHORIZATION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --sugarsync-authorization-expiry
.PP
تاریخ انقضای مجوز دسترسی Sugarsync.
.PP
در حالت عادی خالی بگذارید؛ به‌طور خودکار توسط rclone پیکربندی می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: authorization_expiry
.IP \[bu] 2
متغیر محیطی: RCLONE_SUGARSYNC_AUTHORIZATION_EXPIRY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --sugarsync-user
.PP
کاربر Sugarsync.
.PP
در حالت عادی خالی بگذارید؛ به‌طور خودکار توسط rclone پیکربندی می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user
.IP \[bu] 2
متغیر محیطی: RCLONE_SUGARSYNC_USER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --sugarsync-root-id
.PP
شناسه ریشه Sugarsync.
.PP
در حالت عادی خالی بگذارید؛ به‌طور خودکار توسط rclone پیکربندی می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_id
.IP \[bu] 2
متغیر محیطی: RCLONE_SUGARSYNC_ROOT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --sugarsync-deleted-id
.PP
شناسه پوشهٔ حذف‌شده‌های Sugarsync.
.PP
در حالت عادی خالی بگذارید؛ به‌طور خودکار توسط rclone پیکربندی می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: deleted_id
.IP \[bu] 2
متغیر محیطی: RCLONE_SUGARSYNC_DELETED_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false.SS --sugarsync-encoding
.PP
کدگذاری (encoding) برای بک‌اند.
.PP
برای اطلاعات بیشتر بخش encoding را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_SUGARSYNC_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,Ctl,InvalidUtf8,Dot
.SS --sugarsync-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_SUGARSYNC_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS محدودیت‌ها (Limitations)
.PP
دستور \f[V]rclone about\f[R] توسط بک‌اند SugarSync پشتیبانی نمی‌شود.
بک‌اندهای فاقد این قابلیت نمی‌توانند فضای خالی را برای یک
\f[V]rclone mount\f[R] تعیین کنند یا از سیاست \f[V]mfs\f[R] (بیشترین فضای خالی) به‌عنوان عضوی
از یک ریموت union در rclone استفاده نمایند.
.PP
فهرست بک‌اندهایی که از rclone about پشتیبانی نمی‌کنند
(https://rclone.org/overview/#optional-features) و rclone
about (https://rclone.org/commands/rclone_about) را ببینید.
.SH Uloz.to
.PP
مسیرها به صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند به هر عمق مورد نیازی باشند، مانند
\f[V]remote:directory/subdirectory\f[R].
.PP
راه‌اندازی اولیه Uloz.to شامل وارد کردن اطلاعات کاربری است.
دستور \f[V]rclone config\f[R] شما را مرحله به مرحله راهنمایی می‌کند.
.SS پیکربندی (Configuration)
.PP
در اینجا مثالی از نحوه ساخت یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Uloz.to
   \[rs] \[dq]ulozto\[dq]
[snip]
Storage> ulozto

Option app_token.
The application token identifying the app. An app API key can be either found in the API doc 
https://uloz.to/upload-resumable-api-beta or obtained from customer service.
Enter a value. Press Enter to leave empty.
app_token> token_value

Option username.
The username of the principal to operate as.
Enter a value. Press Enter to leave empty.
username> user

Option password.
The password for the user.
Choose an alternative below. Press Enter for the default (n).
y) Yes, type in my own password
g) Generate random password
n) No, leave this optional password blank (default)
y/g/n> y
Enter the password:
password:
Confirm the password:
password:

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (به جای
\f[V]remote\f[R] نامی را که به ریموت خود اختصاص داده‌اید جایگزین نمایید):
.PP
فهرست کردن پوشه‌ها در پوشه سطح ریشه:
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در پوشه ریشه شما:
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک پوشه محلی به یک پوشه Uloz.to به نام backup:
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS اعتبارنامه‌های کاربر (User credentials)
.PP
تنها روش قابل اطمینان، احراز هویت کاربر با استفاده از نام کاربری و گذرواژه است.
سرویس Uloz.to یک کلید API نیز ارائه می‌دهد، اما برای استفاده در برنامه‌های داخلی خود Uloz.to رزرو شده است و استفاده از آن در شرایط دیگر قابل اطمینان نیست.
.SS زمان‌های ویرایش و هش‌ها (Modification times and hashes)
.PP
سرویس Uloz.to به کاربر اجازه نمی‌دهد زمان ویرایش سفارشی تعیین کند، یا هش‌ها را پس از بارگذاری دریافت نماید.
در نتیجه، این ادغام از یک فیلد با قالب آزاد که API فراهم می‌کند برای کدگذاری برچسب‌های زمانی و هش‌های ارائه‌شده توسط کلاینت استفاده می‌کند.
برچسب‌های زمانی با دقت میکروثانیه ذخیره می‌شوند.
.PP
یک هش MD5 محاسبه‌شده توسط سرور برای فایل در هنگام بارگذاری اعتبارسنجی می‌شود.
پس از آن، backend فقط هش‌های محاسبه‌شده در سمت کلاینت را ارائه می‌دهد.
همچنین می‌توان هش‌ها را هنگام ایجاد پیوند بارگیری فایل دریافت کرد، اما این کار برای موارد استفاده مشابه \f[V]list\f[R] غیرعملی است.
.SS نویسه‌های محدودشده در نام فایل (Restricted filename characters)
.PP
علاوه بر مجموعه نویسه‌های محدودشده پیش‌فرض (https://rclone.org/overview/#restricted-characters) نویسه‌های زیر نیز جایگزین می‌شوند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند شد (https://rclone.org/overview/#invalid-utf8)، زیرا نمی‌توان از آن‌ها در رشته‌های JSON استفاده کرد.
.SS انتقال‌ها (Transfers)
.PP
در حال حاضر تمامی فایل‌ها با استفاده از یک درخواست HTTP منفرد بارگذاری می‌شوند، بنابراین برای بارگذاری فایل‌های حجیم یک اتصال پایدار ضروری است.
ابزار Rclone هم‌زمان تا سقف \f[V]--transfers\f[R] تکه را بارگذاری خواهد کرد (که میان تمام بارگذاری‌ها به اشتراک گذاشته می‌شود).
.SS حذف فایل‌ها (Deleting files)
.PP
به‌طور پیش‌فرض، فایل‌ها به سطل بازیافت منتقل می‌شوند در حالی که پوشه‌ها فوراً حذف می‌شوند.
فایل‌های حذف‌شده پس از ۳۰ روز ماندن در سطل بازیافت، برای همیشه پاک می‌شوند.
.PP
خالی کردن سطل زباله در حال حاضر در rclone پیاده‌سازی نشده است.
.SS شناسه پوشه ریشه (Root folder ID)
.PP
شما می‌توانید \f[V]root_folder_slug\f[R] را برای rclone تنظیم کنید.
این پوشه‌ای است (که با \f[V]Folder slug\f[R] خود شناخته می‌شود) که rclone آن را به عنوان ریشه درایو Uloz.to شما در نظر می‌گیرد.
.PP
در حالت عادی این مقدار را خالی می‌گذارید و خود rclone ریشه صحیح را برای استفاده تعیین می‌کند.
با این حال می‌توانید این مقدار را تنظیم کنید تا rclone را به سلسله‌مراتب پوشه خاصی محدود نمایید.
.PP
برای انجام این کار باید \f[V]Folder slug\f[R] پوشه‌ای را که می‌خواهید به عنوان ریشه استفاده کنید بیابید.
این مقدار آخرین بخش از URL هنگام باز کردن پوشه مربوطه در رابط کاربری وب Uloz.to خواهد بود.
.PP
برای مثال، برای کاوش در پوشه‌ای با نشانی اینترنتی
\f[V]https://uloz.to/fm/my-files/foobar\f[R]، باید از \f[V]foobar\f[R] به عنوان اسلاگ ریشه استفاده شود.
.PP
می‌توان از \f[V]root_folder_slug\f[R] در کنار یک مسیر مشخص در مسیر ریموت استفاده کرد.
برای مثال، اگر \f[V]root_folder_slug\f[R] ریموت شما با \f[V]/foo/bar\f[R] مطابقت داشته باشد، \f[V]remote:baz/qux\f[R] به \f[V]ABSOLUTE_ULOZTO_ROOT/foo/bar/baz/qux\f[R] اشاره خواهد کرد..SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص ulozto (Uloz.to) آمده است.
.SS --ulozto-app-token
.PP
توکن برنامه که برنامه را شناسایی می‌کند.
کلید API برنامه را می‌توان در مستندات API در آدرس
https://uloz.to/upload-resumable-api-beta یافت یا از خدمات مشتریان دریافت کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: app_token
.IP \[bu] 2
متغیر محیطی: RCLONE_ULOZTO_APP_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --ulozto-username
.PP
نام کاربری هویتی که عملیات تحت آن انجام می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: username
.IP \[bu] 2
متغیر محیطی: RCLONE_ULOZTO_USERNAME
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --ulozto-password
.PP
گذرواژه کاربر.
.PP
\f[B]توجه:\f[R] ورودی این مقدار باید مبهم‌سازی (obscure) شده باشد \- به rclone
obscure (https://rclone.org/commands/rclone_obscure) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: password
.IP \[bu] 2
متغیر محیطی: RCLONE_ULOZTO_PASSWORD
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مختص ulozto (Uloz.to) آمده است.
.SS --ulozto-root-folder-slug
.PP
در صورت تنظیم، rclone از این پوشه به‌عنوان پوشه ریشه برای تمام
عملیات استفاده خواهد کرد.
برای مثال، اگر slug مشخص‌کننده \[aq]foo/bar/\[aq] باشد،
\[aq]ulozto:baz\[aq] معادل \[aq]ulozto:foo/bar/baz\[aq]
بدون تنظیم هیچ root slug خواهد بود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_folder_slug
.IP \[bu] 2
متغیر محیطی: RCLONE_ULOZTO_ROOT_FOLDER_SLUG
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --ulozto-list-page-size
.PP
اندازه یک صفحه برای دستورهای فهرست‌گیری (list).
1-500
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_page_size
.IP \[bu] 2
متغیر محیطی: RCLONE_ULOZTO_LIST_PAGE_SIZE
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 500.SS --ulozto-encoding
.PP
کدگذاری برای پشتوانه (backend).
.PP
برای اطلاعات بیشتر، بخش کدگذاری را در
نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_ULOZTO_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot
.SS --ulozto-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_ULOZTO_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS "محدودیت‌ها (Limitations)"
.PP
نام‌های فایل Uloz.to نمی‌توانند شامل نویسهٔ \f[V]\[rs]\f[R] باشند.
دستور rclone این نویسه را به معادل یونیکد هم‌شکل آن یعنی
\f[V]＼\f[R] (U+FF3C Fullwidth Reverse Solidus) و برعکس نگاشت می‌کند.
.PP
سرویس Uloz.to تنها از نام‌های فایل با طول حداکثر ۲۵۵ نویسه پشتیبانی می‌کند.
.PP
سرویس Uloz.to نرخ دسترسی به API را محدود (rate limit) می‌کند، اما جزئیات دقیق آن
فاش نشده است.
آزمایش‌های عملی نشان می‌دهند که مواجه شدن با محدودیت نرخ در طول استفادهٔ معمول
بسیار نادر است، اگرچه با تعداد بالاتر فایل‌های آپلودشده به‌طور هم‌زمان، غیرممکن نیست.
.PP
دستور \f[V]rclone about\f[R] توسط پشتوانهٔ Uloz.to پشتیبانی نمی‌شود.
اگرچه یک نقطهٔ پایانی (endpoint) برای دریافت اطلاعات رابط کاربری وجود دارد،
اما در API ارائه نشده است.
پشتوانه‌های فاقد این قابلیت نمی‌توانند فضای خالی را برای یک سوار کردن (mount) در rclone
تعیین کنند یا از سیاست \f[V]mfs\f[R] (بیشترین فضای خالی \- most free space) به‌عنوان عضوی
از یک ریموت union در rclone استفاده نمایند.
.PP
بخش فهرست پشتوانه‌هایی که از rclone about پشتیبانی نمی‌کنند در
(https://rclone.org/overview/#optional-features) و
rclone about را در (https://rclone.org/commands/rclone_about) ببینید.
.SH "اتحادیه (Union)"
.PP
پشتوانهٔ \f[V]union\f[R] چندین ریموت را به یکدیگر متصل می‌کند تا نمایی
واحد و یکپارچه از آن‌ها ایجاد کند.
.PP
در طول راه‌اندازی اولیه با \f[V]rclone config\f[R] شما ریموت‌های بالادستی (upstream)
را به‌صورت فهرستی جداشده با فاصله (space) مشخص خواهید کرد.
ریموت‌های بالادستی می‌توانند مسیرهای محلی یا ریموت‌های دیگر باشند.
.PP
صفت‌های \f[V]:ro\f[R]، \f[V]:nc\f[R] و \f[V]:writeback\f[R] می‌توانند به انتهای ریموت
پیوست شوند تا ریموت را به‌عنوان \f[B]فقط‌خواندنی (read only)\f[R]،
\f[B]بدون ایجاد (no create)\f[R] یا \f[B]writeback\f[R] برچسب‌گذاری کنند؛ مانند
\f[V]remote:directory/subdirectory:ro\f[R] یا
\f[V]remote:directory/subdirectory:nc\f[R].
.IP \[bu] 2
\f[V]:ro\f[R] به این معنی است که فایل‌ها فقط از اینجا خوانده می‌شوند و هرگز در آن نوشته نخواهند شد
.IP \[bu] 2
\f[V]:nc\f[R] به این معنی است که فایل‌ها یا دایرکتوری‌های جدید در اینجا ایجاد نخواهند شد
.IP \[bu] 2
\f[V]:writeback\f[R] به این معنی است که فایل‌های یافت‌شده در ریموت‌های مختلف، در اینجا
بازنویسی خواهند شد.
برای اطلاعات بیشتر بخش writeback را ببینید.
.PP
می‌توان از زیرپوشه‌ها در ریموت‌های بالادستی استفاده کرد.
یک ریموت union به نام \f[V]backup\f[R] را با ریموت‌های
\f[V]mydrive:private/backup\f[R] در نظر بگیرید.
اجرای دستور \f[V]rclone mkdir backup:desktop\f[R] دقیقاً معادل
اجرای \f[V]rclone mkdir mydrive:private/backup/desktop\f[R] است.
.PP
هیچ پردازش ویژه‌ای برای مسیرهای حاوی بخش‌های \f[V]..\f[R] وجود ندارد.
اجرای دستور \f[V]rclone mkdir backup:../desktop\f[R] دقیقاً معادل
اجرای \f[V]rclone mkdir mydrive:private/backup/../desktop\f[R] است..SS پیکربندی
.PP
در اینجا مثالی از نحوه ایجاد یک union به نام \f[V]remote\f[R] برای
پوشه‌های محلی آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Union merges the contents of several remotes
   \[rs] \[dq]union\[dq]
[snip]
Storage> union
List of space separated upstreams.
Can be \[aq]upstreama:test/dir upstreamb:\[aq], \[aq]\[rs]\[dq]upstreama:test/space:ro dir\[rs]\[dq] upstreamb:\[aq], etc.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
upstreams> remote1:dir1 remote2:dir2 remote3:dir3
Policy to choose upstream on ACTION class.
Enter a string value. Press Enter for the default (\[dq]epall\[dq]).
action_policy>
Policy to choose upstream on CREATE class.
Enter a string value. Press Enter for the default (\[dq]epmfs\[dq]).
create_policy>
Policy to choose upstream on SEARCH class.
Enter a string value. Press Enter for the default (\[dq]ff\[dq]).
search_policy>
Cache time of usage and free space (in seconds). This option is only useful when a path preserving policy is used.
Enter a signed integer. Press Enter for the default (\[dq]120\[dq]).
cache_time>
Remote config
Configuration complete.
Options:
- type: union
- upstreams: remote1:dir1 remote2:dir2 remote3:dir3
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
Current remotes:

Name                 Type
====                 ====
remote               union

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> q
\f[R]
.fi
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید:
.PP
فهرست کردن دایرکتوری‌های سطح بالا در \f[V]remote1:dir1\f[R]،
\f[V]remote2:dir2\f[R] و \f[V]remote3:dir3\f[R]
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در \f[V]remote1:dir1\f[R]، \f[V]remote2:dir2\f[R] و
\f[V]remote3:dir3\f[R]
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
کپی کردن یک دایرکتوری محلی دیگر در دایرکتوری union به نام source، که
در \f[V]remote3:dir3\f[R] قرار خواهد گرفت
.IP
.nf
\f[C]
rclone copy C:\[rs]source remote:source
\f[R]
.fi.SS "رفتار / سیاست‌ها (Behavior / Policies)"
.PP
رفتار بک‌اند union از
trapexit/mergerfs (https://github.com/trapexit/mergerfs) الهام گرفته شده است.
تمام توابع در ۳ دسته گروه‌بندی می‌شوند: \f[B]action\f[R]،
\f[B]create\f[R] و \f[B]search\f[R].
به این توابع و دسته‌ها می‌توان سیاستی اختصاص داد که تعیین می‌کند
هنگام اجرای آن رفتار، چه فایل یا دایرکتوری‌ای انتخاب شود.
هر سیاستی را می‌توان به یک تابع یا دسته اختصاص داد، اگرچه ممکن است برخی از آن‌ها
در عمل چندان مفید نباشند.
برای نمونه: \f[B]rand\f[R] (تصادفی) ممکن است برای ایجاد فایل
(create) مفید باشد، اما در صورت وجود بیش از یک نسخه از فایل، استفاده از آن برای
\f[V]delete\f[R] می‌تواند به رفتار بسیار عجیبی منجر شود.
.SS "طبقه‌بندی توابع / دسته‌ها (Function / Category classifications)"
.PP
.TS
tab(@);
lw(5.8n) lw(15.0n) lw(49.2n).
T{
دسته
T}@T{
توضیحات
T}@T{
توابع
T}
_
T{
action
T}@T{
نوشتن روی فایل موجود
T}@T{
move، rmdir، rmdirs، delete، purge و copy، sync (به‌عنوان مقصد، زمانی که فایل وجود دارد)
T}
T{
create
T}@T{
ایجاد فایل ناموجود
T}@T{
copy، sync (به‌عنوان مقصد، زمانی که فایل وجود ندارد)
T}
T{
search
T}@T{
خواندن و فهرست‌کردن فایل
T}@T{
ls، lsd، lsl، cat، md5sum، sha1sum و copy، sync (به‌عنوان مبدأ)
T}
T{
N/A
T}@T{
T}@T{
size، about
T}
.TE
.SS "حفظ مسیر (Path Preservation)"
.PP
سیاست‌ها، همان‌طور که در زیر شرح داده شده است، از دو نوع اساسی هستند:
\f[V]path preserving\f[R] (حفظ‌کننده مسیر) و \f[V]non-path preserving\f[R] (عدم حفظ مسیر).
.PP
تمام سیاست‌هایی که با \f[V]ep\f[R] آغاز می‌شوند (\f[B]epff\f[R]،
\f[B]eplfs\f[R]، \f[B]eplus\f[R]، \f[B]epmfs\f[R]، \f[B]eprand\f[R])
از نوع \f[V]path preserving\f[R] هستند.
\f[V]ep\f[R] مخفف \f[V]existing path\f[R] (مسیر موجود) است.
.PP
یک سیاست حفظ مسیر (path preserving) تنها بالادست‌هایی (upstreams) را در نظر می‌گیرد که
مسیر نسبیِ در حال دسترسی، از قبل در آن‌ها موجود باشد.
.PP
هنگام استفاده از سیاست‌های غیرحافظ مسیر (non-path preserving)، مسیرها در صورت نیاز
در بالادست‌های هدف ایجاد خواهند شد.
.SS "سیاست‌های مرتبط با سهمیه (Quota Relevant Policies)"
.PP
برخی از سیاست‌ها به اطلاعات سهمیه (quota) متکی هستند.
این سیاست‌ها تنها باید در صورتی استفاده شوند که بالادست‌های شما از
فیلدهای سهمیه مربوطه پشتیبانی کنند.
.PP
.TS
tab(@);
l l.
T{
سیاست
T}@T{
فیلد مورد نیاز
T}
_
T{
lfs, eplfs
T}@T{
Free
T}
T{
mfs, epmfs
T}@T{
Free
T}
T{
lus, eplus
T}@T{
Used
T}
T{
lno, eplno
T}@T{
Objects
T}
.TE
.PP
برای بررسی اینکه آیا بالادست شما از فیلد مورد نظر پشتیبانی می‌کند یا خیر، دستور
\f[V]rclone about remote: [flags]\f[R] را اجرا کرده و بررسی کنید که آیا فیلد
مورد نیاز وجود دارد یا خیر..SS "فیلترها (Filters)"
.PP
سیاست‌ها (Policies) اساساً ریموت‌های بالادست (upstream remotes) را جستجو کرده و فهرستی از فایل‌ها / مسیرها را برای کارکرد توابع ایجاد می‌کنند.
سیاست مسئول فیلتر کردن و مرتب‌سازی است.
نوع سیاست مرتب‌سازی را تعیین می‌کند، اما فیلتر کردن همان‌طور که در زیر شرح داده شده تا حد زیادی یکنواخت است.
.IP \[bu] 2
هیچ‌یک از سیاست‌های \f[B]search\f[R] فیلتر انجام نمی‌دهند.
.IP \[bu] 2
تمام سیاست‌های \f[B]action\f[R] ریموت‌هایی را که با عنوان \f[B]read-only\f[R] نشانه‌گذاری شده‌اند، فیلتر (حذف) می‌کنند.
.IP \[bu] 2
تمام سیاست‌های \f[B]create\f[R] ریموت‌هایی را که با عنوان \f[B]read-only\f[R] یا \f[B]no-create\f[R] نشانه‌گذاری شده‌اند، فیلتر (حذف) می‌کنند.
.PP
اگر همهٔ ریموت‌ها فیلتر شوند، یک خطا بازگردانده خواهد شد.
.SS "توضیحات سیاست‌ها (Policy descriptions)"
.PP
تعریف سیاست‌ها از trapexit/mergerfs (https://github.com/trapexit/mergerfs) الهام گرفته شده است، اما دقیقاً یکسان نیست.
برخی تعاریف سیاست‌ها ممکن است به دلیل تأخیر بسیار بیشتر سیستم‌های فایل راه دور (remote file systems) متفاوت باشند.
.PP
.TS
tab(@);
lw(16.2n) lw(53.8n).
T{
سیاست
T}@T{
توضیحات
T}
_
T{
all
T}@T{
دسته‌بندی \f[B]search\f[R]: همانند \f[B]epall\f[R].
دسته‌بندی \f[B]action\f[R]: همانند \f[B]epall\f[R].
دسته‌بندی \f[B]create\f[R]: عمل روی تمام بالادست‌ها (upstreams).
T}
T{
epall (existing path, all)
T}@T{
دسته‌بندی \f[B]search\f[R]: با توجه به این ترتیب پیکربندی‌شده، روی اولین موردی که مسیر نسبی در آن وجود دارد عمل می‌کند.
دسته‌بندی \f[B]action\f[R]: اعمال روی تمام موارد یافته‌شده.
دسته‌بندی \f[B]create\f[R]: عمل روی تمام بالادست‌هایی که مسیر نسبی در آن‌ها وجود دارد.
T}
T{
epff (existing path, first found)
T}@T{
روی اولین موردی که تا زمان پاسخگویی بالادست‌ها یافت شود و مسیر نسبی در آن وجود داشته باشد، عمل می‌کند.
T}
T{
eplfs (existing path, least free space)
T}@T{
از میان تمام بالادست‌هایی که مسیر نسبی در آن‌ها وجود دارد، موردی با کمترین فضای خالی انتخاب می‌شود.
T}
T{
eplus (existing path, least used space)
T}@T{
از میان تمام بالادست‌هایی که مسیر نسبی در آن‌ها وجود دارد، موردی با کمترین فضای استفاده‌شده انتخاب می‌شود.
T}
T{
eplno (existing path, least number of objects)
T}@T{
از میان تمام بالادست‌هایی که مسیر نسبی در آن‌ها وجود دارد، موردی با کمترین تعداد اشیاء (objects) انتخاب می‌شود.
T}
T{
epmfs (existing path, most free space)
T}@T{
از میان تمام بالادست‌هایی که مسیر نسبی در آن‌ها وجود دارد، موردی با بیشترین فضای خالی انتخاب می‌شود.
T}
T{
eprand (existing path, random)
T}@T{
سیاست \f[B]epall\f[R] را فراخوانی کرده و سپس به‌صورت تصادفی انتخاب می‌کند.
تنها یک بالادست را بازمی‌گرداند.
T}
T{
ff (first found)
T}@T{
دسته‌بندی \f[B]search\f[R]: همانند \f[B]epff\f[R].
دسته‌بندی \f[B]action\f[R]: همانند \f[B]epff\f[R].
دسته‌بندی \f[B]create\f[R]: عمل روی اولین موردی که تا زمان پاسخگویی بالادست‌ها یافت شود.
T}
T{
lfs (least free space)
T}@T{
دسته‌بندی \f[B]search\f[R]: همانند \f[B]eplfs\f[R].
دسته‌بندی \f[B]action\f[R]: همانند \f[B]eplfs\f[R].
دسته‌بندی \f[B]create\f[R]: انتخاب بالادست با کمترین فضای خالی در دسترس.
T}
T{
lus (least used space)
T}@T{
دسته‌بندی \f[B]search\f[R]: همانند \f[B]eplus\f[R].
دسته‌بندی \f[B]action\f[R]: همانند \f[B]eplus\f[R].
دسته‌بندی \f[B]create\f[R]: انتخاب بالادست با کمترین فضای استفاده‌شده.
T}
T{
lno (least number of objects)
T}@T{
دسته‌بندی \f[B]search\f[R]: همانند \f[B]eplno\f[R].
دسته‌بندی \f[B]action\f[R]: همانند \f[B]eplno\f[R].
دسته‌بندی \f[B]create\f[R]: انتخاب بالادست با کمترین تعداد اشیاء.
T}
T{
mfs (most free space)
T}@T{
دسته‌بندی \f[B]search\f[R]: همانند \f[B]epmfs\f[R].
دسته‌بندی \f[B]action\f[R]: همانند \f[B]epmfs\f[R].
دسته‌بندی \f[B]create\f[R]: انتخاب بالادست با بیشترین فضای خالی در دسترس.
T}
T{
newest
T}@T{
فایل / دایرکتوری دارای بیشترین مقدار mtime (جدیدترین زمان تغییر) را انتخاب می‌کند.
T}
T{
rand (random)
T}@T{
سیاست \f[B]all\f[R] را فراخوانی کرده و سپس به‌صورت تصادفی انتخاب می‌کند.
تنها یک بالادست را بازمی‌گرداند.
T}
.TE.SS بازنویسی (Writeback)
.PP
برچسب \f[V]:writeback\f[R] روی یک ریموت بالادست (upstream) می‌تواند برای ایجاد یک سامانه حافظه نهان (cache) ساده مانند زیر استفاده شود:
.IP
.nf
\f[C]
[union]
type = union
action_policy = all
create_policy = all
search_policy = ff
upstreams = /local:writeback remote:dir
\f[R]
.fi
.PP
هنگامی که فایل‌ها برای خواندن باز می‌شوند، اگر فایل در \f[V]remote:dir\f[R] باشد اما در \f[V]/local\f[R] موجود نباشد، rclone پیش از بازگرداندن ارجاع به فایل در \f[V]/local\f[R]، آن را به‌طور کامل در \f[V]/local\f[R] کپی خواهد کرد.
این کپی با معادل دستور \f[V]rclone copy\f[R] انجام خواهد شد، بنابراین در صورت پیکربندی، از \f[V]--multi-thread-streams\f[R] استفاده خواهد کرد.
هرگونه کپی با یک پیام در سطح INFO ثبت خواهد شد.
.PP
هنگامی که فایل‌ها نوشته می‌شوند، در هر دو مسیر \f[V]remote:dir\f[R] و \f[V]/local\f[R] نوشته خواهند شد.
.PP
می‌توان هر تعداد ریموت دلخواهی را به \f[V]upstreams\f[R] اضافه کرد، اما تنها باید یک برچسب \f[V]:writeback\f[R] وجود داشته باشد.
.PP
دستور rclone ریموت دارای \f[V]:writeback\f[R] را به هیچ روش دیگری به جز نوشتن مجدد فایل‌ها در آن، مدیریت نمی‌کند.
بنابراین اگر نیاز دارید فایل‌های قدیمی را منقضی کنید یا اندازه را مدیریت نمایید، باید این کار را خودتان انجام دهید.
.SS گزینه‌های استاندارد (Standard options)
.PP
در اینجا گزینه‌های استاندارد مختص به union (اتحادیه محتویات چند سامانه فایل بالادست را ادغام می‌کند) آورده شده است.
.SS --union-upstreams
.PP
فهرستی از بالادست‌ها که با فاصله (space) از هم جدا شده‌اند.
.PP
می‌تواند \[aq]upstreama:test/dir upstreamb:\[aq]، یا \[aq]\[dq]upstreama:test/space:ro dir\[dq] upstreamb:\[aq] و غیره باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upstreams
.IP \[bu] 2
متغیر محیطی: RCLONE_UNION_UPSTREAMS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --union-action-policy
.PP
شیوه‌نامه برای انتخاب بالادست در دسته‌بندی ACTION.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: action_policy
.IP \[bu] 2
متغیر محیطی: RCLONE_UNION_ACTION_POLICY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]epall\[dq]
.SS --union-create-policy
.PP
شیوه‌نامه برای انتخاب بالادست در دسته‌بندی CREATE.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: create_policy
.IP \[bu] 2
متغیر محیطی: RCLONE_UNION_CREATE_POLICY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]epmfs\[dq].SS --union-search-policy
.PP
سیاست انتخاب بالادست در دسته‌بندی SEARCH.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: search_policy
.IP \[bu] 2
متغیر محیطی: RCLONE_UNION_SEARCH_POLICY
.IP \[bu] 2
نوع: string
.IP \[bu] 2
پیش‌فرض: \[dq]ff\[dq]
.SS --union-cache-time
.PP
مدت‌زمان نگهداری کش فضای مصرفی و آزاد (به ثانیه).
.PP
این گزینه تنها زمانی کاربرد دارد که یک سیاست حفظ مسیر به کار گرفته شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: cache_time
.IP \[bu] 2
متغیر محیطی: RCLONE_UNION_CACHE_TIME
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 120
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در این بخش گزینه‌های پیشرفته مختص به union آورده شده است (union محتویات چند سامانه فایل بالادست را ادغام می‌کند).
.SS --union-min-free-space
.PP
حداقل فضای آزاد قابل‌قبول برای سیاست‌های lfs/eplfs.
.PP
اگر فضای آزاد یک ریموت از این مقدار کمتر باشد، برای استفاده در سیاست‌های lfs یا eplfs در نظر گرفته نخواهد شد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: min_free_space
.IP \[bu] 2
متغیر محیطی: RCLONE_UNION_MIN_FREE_SPACE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 1Gi
.SS --union-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_UNION_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS فراداده (Metadata)
.PP
هرگونه فراداده پشتیبانی‌شده توسط ریموت زیرین خوانده شده و نوشته می‌شود.
.PP
برای اطلاعات بیشتر مستندات فراداده (https://rclone.org/docs/#metadata) را ببینید.
.SH WebDAV
.PP
مسیرها به‌صورت \f[V]remote:path\f[R] مشخص می‌شوند.
.PP
مسیرها می‌توانند تا هر عمق موردنیازی باشند، مانند:
\f[V]remote:directory/subdirectory\f[R].
.SS پیکربندی (Configuration)
.PP
برای پیکربندی ریموت WebDAV به یک URL برای آن و یک نام کاربری و گذرواژه نیاز خواهید داشت.
اگر نوع سامانه‌ای را که به آن متصل می‌شوید بدانید، rclone می‌تواند قابلیت‌های بیشتری را فعال کند.
.PP
در اینجا نمونه‌ای از نحوه ایجاد یک ریموت به نام \f[V]remote\f[R] آورده شده است.
ابتدا اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / WebDAV
   \[rs] \[dq]webdav\[dq]
[snip]
Storage> webdav
URL of http host to connect to
Choose a number from below, or type in your own value
 1 / Connect to example.com
   \[rs] \[dq]https://example.com\[dq]
url> https://example.com/remote.php/webdav
Name of the WebDAV site/service/software you are using
Choose a number from below, or type in your own value
 1 / Fastmail Files
   \[rs] (fastmail)
 2 / Nextcloud
   \[rs] (nextcloud)
 3 / Owncloud
   \[rs] (owncloud)
 4 / Sharepoint Online, authenticated by Microsoft account
   \[rs] (sharepoint)
 5 / Sharepoint with NTLM authentication, usually self-hosted or on-premises
   \[rs] (sharepoint-ntlm)
 6 / rclone WebDAV server to serve a remote over HTTP via the WebDAV protocol
   \[rs] (rclone)
 7 / Other site/service or software
   \[rs] (other)
vendor> 2
User name
user> user
Password.
y) Yes type in my own password
g) Generate random password
n) No leave this optional password blank
y/g/n> y
Enter the password:
password:
Confirm the password:
password:
Bearer token instead of user/pass (e.g. a Macaroon)
bearer_token>
Remote config
Configuration complete.
Options:
- type: webdav
- url: https://example.com/remote.php/webdav
- vendor: nextcloud
- user: user
- pass: *** ENCRYPTED ***
- bearer_token:
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (\f[V]remote\f[R] را با نامی که به ریموت خود داده‌اید جایگزین کنید):
.PP
فهرست کردن دایرکتوری‌ها در بالاترین سطح WebDAV شما
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
فهرست کردن تمام فایل‌ها در WebDAV شما
.IP
.nf
\f[C]
rclone ls remote:
\f[R]
.fi
.PP
برای کپی کردن یک دایرکتوری محلی به یک دایرکتوری WebDAV به نام backup
.IP
.nf
\f[C]
rclone copy /home/source remote:backup
\f[R]
.fi.SS زمان‌های تغییر و هش‌ها
.PP
WebDAV معمولی از زمان‌های تغییر پشتیبانی نمی‌کند.
با این حال، هنگام استفاده با Fastmail Files، ownCloud یا Nextcloud، ابزار rclone از
زمان‌های تغییر پشتیبانی خواهد کرد.
.PP
به همین ترتیب WebDAV معمولی از هش‌ها پشتیبانی نمی‌کند؛ اما هنگام استفاده با
Fastmail Files، ownCloud یا Nextcloud، ابزار rclone از هش‌های SHA1 و MD5 پشتیبانی
خواهد کرد.
بسته به نسخه دقیق ownCloud یا Nextcloud، ممکن است هش‌ها روی تمام اشیاء ظاهر
شوند، یا تنها روی اشیائی که همراه با آن‌ها هشی بارگذاری شده است.
در Nextcloud، ابزار rclone از سرور می‌خواهد تا SHA1 بارگذاری‌هایی را که هشی برای
ارسال نداشتند (مانند بارگذاری‌های جریانی)، و همچنین پس از تنظیم زمان تغییر
(که هش ذخیره‌شده را حذف می‌کند)، محاسبه کند.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص webdav (WebDAV) آورده شده است.
.SS --webdav-url
.PP
نشانی URL میزبان http برای اتصال به آن.
.PP
برای نمونه:
https://example.com.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: url
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: true
.SS --webdav-vendor
.PP
نام وبگاه/سرویس/نرم‌افزار WebDAV که از آن استفاده می‌کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: vendor
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_VENDOR
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]fastmail\[dq]
.RS 2
.IP \[bu] 2
Fastmail Files
.RE
.IP \[bu] 2
\[dq]nextcloud\[dq]
.RS 2
.IP \[bu] 2
Nextcloud
.RE
.IP \[bu] 2
\[dq]owncloud\[dq]
.RS 2
.IP \[bu] 2
سرور WebDAV مبتنی بر PHP برای Owncloud 10
.RE
.IP \[bu] 2
\[dq]infinitescale\[dq]
.RS 2
.IP \[bu] 2
ownCloud Infinite Scale
.RE
.IP \[bu] 2
\[dq]sharepoint\[dq]
.RS 2
.IP \[bu] 2
سرویس Sharepoint Online، احراز هویت با حساب Microsoft
.RE
.IP \[bu] 2
\[dq]sharepoint-ntlm\[dq]
.RS 2
.IP \[bu] 2
سرویس Sharepoint با احراز هویت NTLM، معمولاً خودمیزبان (self-hosted) یا درون‌سازمانی (on-premises)
.RE
.IP \[bu] 2
\[dq]rclone\[dq]
.RS 2
.IP \[bu] 2
سرور WebDAV ابزار rclone برای سرویس‌دهی یک ریموت بر بستر HTTP از طریق پروتکل WebDAV
.RE
.IP \[bu] 2
\[dq]other\[dq]
.RS 2
.IP \[bu] 2
سایر وبگاه‌ها/سرویس‌ها یا نرم‌افزارها
.RE
.RE.SS --webdav-user
.PP
نام کاربری.
.PP
در صورتی که از احراز هویت NTLM استفاده شود، نام کاربری باید در قالب \[aq]Domain\[aq] باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: user
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_USER
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --webdav-pass
.PP
گذرواژه.
.PP
\f[B]نکته:\f[R] ورودی این گزینه باید مبهم‌سازی شود \- به rclone obscure (https://rclone.org/commands/rclone_obscure) مراجعه کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pass
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_PASS
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --webdav-bearer-token
.PP
توکن حامل (Bearer token) به جای نام کاربری/گذرواژه (برای نمونه Macaroon).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: bearer_token
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_BEARER_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS گزینه‌های پیشرفته (Advanced options)
.PP
در اینجا گزینه‌های پیشرفته مخصوص webdav (WebDAV) آورده شده است.
.SS --webdav-bearer-token-command
.PP
دستوری که برای دریافت توکن حامل (bearer token) اجرا می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: bearer_token_command
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_BEARER_TOKEN_COMMAND
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --webdav-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر بخش کدگذاری را در بررسی اجمالی (https://rclone.org/overview/#encoding) ببینید.
.PP
کدگذاری پیش‌فرض برای sharepoint-ntlm برابر با
Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,Hash,Percent,BackSlash,Del,Ctl,LeftSpace,LeftTilde,RightSpace,RightPeriod,InvalidUtf8
و در غیر این صورت identity است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_ENCODING
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --webdav-headers
.PP
تنظیم هدرهای HTTP برای تمامی تراکنش‌ها.
.PP
از این گزینه برای تنظیم هدرهای HTTP اضافی برای تمامی تراکنش‌ها استفاده کنید.
.PP
قالب ورودی فهرستی از جفت‌های key,value است که با ویرگول از یکدیگر جدا شده‌اند.
می‌توان از کدگذاری استاندارد CSV (https://godoc.org/encoding/csv) استفاده کرد.
.PP
برای نمونه، جهت تنظیم یک Cookie از \[aq]Cookie,name=value\[aq] یا
\[aq]\[dq]Cookie\[dq],\[dq]name=value\[dq]\[aq] استفاده کنید.
.PP
می‌توانید چندین هدر را تنظیم کنید، مانند:
\[aq]\[dq]Cookie\[dq],\[dq]name=value\[dq],\[dq]Authorization\[dq],\[dq]xxx\[dq]\[aq].
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: headers
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_HEADERS
.IP \[bu] 2
نوع: CommaSepList
.IP \[bu] 2
پیش‌فرض:
.SS --webdav-pacer-min-sleep
.PP
حداقل زمان توقف میان فراخوانی‌های API.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: pacer_min_sleep
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_PACER_MIN_SLEEP
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 10ms
.SS --webdav-nextcloud-chunk-size
.PP
اندازه تکه‌های بارگذاری Nextcloud.
.PP
توصیه می‌کنیم نمونه NextCloud خود را پیکربندی کنید تا حداکثر اندازه تکه را برای عملکرد بهتر در بارگذاری به 1 گیگابایت افزایش دهید.
ببینید:
https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/big_file_upload_configuration.html#adjust-chunk-size-on-nextcloud-side
.PP
برای غیرفعال کردن بارگذاری تکه‌ای، آن را روی 0 تنظیم کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: nextcloud_chunk_size
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_NEXTCLOUD_CHUNK_SIZE
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 10Mi
.SS --webdav-owncloud-exclude-shares
.PP
مستثنی کردن اشتراک‌گذاری‌های ownCloud
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: owncloud_exclude_shares
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_OWNCLOUD_EXCLUDE_SHARES
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --webdav-owncloud-exclude-mounts
.PP
مستثنی کردن فضاهای ذخیره‌سازی متصل‌شده (mounted) در ownCloud
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: owncloud_exclude_mounts
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_OWNCLOUD_EXCLUDE_MOUNTS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --webdav-unix-socket
.PP
مسیر یک سوکت دامنه یونیکس (unix domain socket) برای برقراری ارتباط، به‌جای باز کردن مستقیم یک اتصال TCP
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: unix_socket
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_UNIX_SOCKET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --webdav-auth-redirect
.PP
حفظ احراز هویت در هنگام تغییر مسیر (redirect).
.PP
اگر سرور هنگام تلاش rclone برای خواندن یک فایل، آن را به یک دامنه جدید تغییر مسیر دهد، در حالت عادی rclone سرآیند Authorization: را از درخواست حذف می‌کند.
.PP
این یک اقدام امنیتی استاندارد است تا از ارسال اطلاعات هویتی شما به یک وب‌سرور ناشناخته جلوگیری شود.
.PP
با این حال، در برخی شرایط این رفتار مطلوب است.
اگر هنگام تلاش rclone برای خواندن فایل‌ها از سرور webdav با خطایی مانند \[dq]401 Unauthorized\[dq] مواجه شدید، می‌توانید این گزینه را امتحان کنید.
.PP
توجه داشته باشید که فعال‌سازی این گزینه همچنین اجازه می‌دهد تا در صورت تغییر مسیر از HTTPS به HTTP توسط سرور، اطلاعات هویتی شما روی یک اتصال متن‌آشکار (plaintext) HTTP ارسال شود؛ کاری که rclone در غیر این صورت از انجام آن خودداری می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_redirect
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_AUTH_REDIRECT
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --webdav-description
.PP
توضیحات ریموت (remote).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_WEBDAV_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS نکات مربوط به ارائه‌دهندگان (Provider notes)
.PP
برای نکات مربوط به ارائه‌دهندگان خاص، موارد زیر را ببینید.
.SS Fastmail Files
.PP
از \f[V]https://webdav.fastmail.com/\f[R] یا یکی از زیرپوشه‌های آن به‌عنوان URL، و از رایانامه Fastmail خود به‌صورت \f[V]username\[at]domain.tld\f[R] به‌عنوان نام کاربری استفاده کنید.
این مستندات (https://www.fastmail.help/hc/en-us/articles/360058752854-App-passwords) را برای ساخت یک گذرواژه برنامه (app password) با دسترسی به \f[V]Files (WebDAV)\f[R] دنبال کرده و از آن به‌عنوان گذرواژه استفاده کنید.
.PP
سرویس Fastmail از زمان‌های اصلاح‌شده با استفاده از سرآیند \f[V]X-OC-Mtime\f[R] پشتیبانی می‌کند.
.SS ownCloud
.PP
روی آیکون چرخ‌دنده تنظیمات در پایین سمت راست صفحه کلیک کنید؛ این کار URL مربوط به WebDAV را که rclone در مرحله پیکربندی به آن نیاز دارد نمایش می‌دهد.
این نشانی چیزی شبیه به \f[V]https://example.com/remote.php/webdav/\f[R] خواهد بود.
.PP
سرویس ownCloud از زمان‌های اصلاح‌شده با استفاده از سرآیند \f[V]X-OC-Mtime\f[R] پشتیبانی می‌کند.
.SS Nextcloud
.PP
این سرویس دقیقاً مشابه ownCloud پیکربندی می‌شود.
توجه داشته باشید که Nextcloud در ابتدا بر خلاف ownCloud از ارسال جریانی (streaming) فایل‌ها (\f[V]rcat\f[R]) پشتیبانی نمی‌کرد، اما به نظر می‌رسد این مورد (https://github.com/nextcloud/nextcloud-snap/issues/365) از تاریخ ۲۰۲۰-۱۱-۲۷ برطرف شده است (آزمایش‌شده با rclone نسخه v1.53.1 و Nextcloud Server نسخه v19)..SS ownCloud Infinite Scale
.PP
نشانی وب (URL) مربوط به WebDAV برای Infinite Scale را می‌توان در پانل جزئیات هر فضا (space) در Infinite Scale پیدا کرد، در صورتی که نمایش آن در تنظیمات شخصی کاربر از طریق جعبهٔ انتخاب (checkbox) فعال شده باشد.
.PP
ابزار Infinite Scale با پروتکل بارگذاری تکه‌تکهٔ tus (<https://tus.io>) کار می‌کند.
اندازهٔ هر تکه (chunk size) در حال حاضر روی ۱۰ مگابایت ثابت است.
.SS Sharepoint Online
.PP
ابزار Rclone می‌تواند با Sharepoint ارائه‌شده توسط حساب‌های کاربری OneDrive for Business یا Office365 Education استفاده شود.
این ویژگی تنها برای تعداد معدودی از این حساب‌ها لازم است، که عمدتاً حساب‌های Office365 Education هستند.
این حساب‌ها گاهی اوقات توسط مالک دامنه تأیید نشده‌اند: github#1975 (<https://github.com/rclone/rclone/issues/1975>)
.PP
این بدان معناست که این حساب‌ها را نمی‌توان با استفاده از API رسمی اضافه کرد (سایر حساب‌ها باید با گزینهٔ \[dq]onedrive\[dq] کار کنند).
با این وجود، دسترسی به آن‌ها از طریق webdav امکان‌پذیر است.
.PP
برای استفاده از یک ریموت sharepoint با rclone، آن را به این صورت اضافه کنید: ابتدا باید URL ریموت خود را به دست آورید:
.IP \[bu] 2
برای باز کردن OneDrive خود یا ورود به سیستم، به اینجا (<https://onedrive.live.com/about/en-us/signin>) بروید
.IP \[bu] 2
اکنون به نوار آدرس مرورگر خود نگاه کنید؛ URL باید به این شکل باشد:
\f[V]https://[YOUR-DOMAIN]-my.sharepoint.com/personal/[YOUR-EMAIL]/_layouts/15/onedrive.aspx\f[R]
.PP
شما تنها تا بخش آدرس ایمیل به این URL نیاز خواهید داشت.
پس از آن، به احتمال زیاد مایل به افزودن \[dq]/Documents\[dq] خواهید بود.
این زیرشاخه حاوی داده‌های واقعی ذخیره‌شده در OneDrive شماست.
.PP
ریموت را به این صورت به rclone اضافه کنید: مقدار \f[V]url\f[R] را به عنوان
\f[V]https://[YOUR-DOMAIN]-my.sharepoint.com/personal/[YOUR-EMAIL]/Documents\f[R]
پیکربندی کرده و از ایمیل و گذرواژهٔ معمول حساب کاربری خود برای \f[V]user\f[R] و
\f[V]pass\f[R] استفاده کنید.
اگر احراز هویت دومرحله‌ای (2FA) را فعال کرده‌اید، باید یک گذرواژهٔ برنامه (app password) ایجاد کنید.
مقدار \f[V]vendor\f[R] را روی \f[V]sharepoint\f[R] تنظیم نمایید.
.PP
فایل پیکربندی شما باید به این شکل باشد:
.IP
.nf
\f[C]
[sharepoint]
type = webdav
url = https://[YOUR-DOMAIN]-my.sharepoint.com/personal/[YOUR-EMAIL]/Documents
vendor = sharepoint
user = YourEmailAddress
pass = encryptedpassword
\f[R]
.fi
.SS "Sharepoint با احراز هویت NTLM (Sharepoint with NTLM Authentication)"
.PP
از این گزینه در صورتی استفاده کنید که Sharepoint (میزبانی‌شدهٔ) شما به حساب‌های OneDrive متصل نبوده و از احراز هویت NTLM استفاده می‌کند.
.PP
برای به دست آوردن مقدار پیکربندی \f[V]url\f[R]، همانند بالا، ابتدا در مرورگر خود به دایرکتوری مورد نظر بروید تا URL را دریافت کنید، سپس همه چیز را بعد از نام دایرکتوری بازشده حذف کنید.
.PP
مثال: اگر URL به این صورت باشد:
<https://example.sharepoint.com/sites/12345/Documents/Forms/AllItems.aspx>
.PP
پیکربندی مورد استفاده به این صورت خواهد بود:
<https://example.sharepoint.com/sites/12345/Documents>
.PP
مقدار \f[V]vendor\f[R] را برابر \f[V]sharepoint-ntlm\f[R] قرار دهید.
.PP
پروتکل NTLM از ترکیب نام دامنه و نام کاربری برای احراز هویت استفاده می‌کند؛ \f[V]user\f[R] را به صورت \f[V]DOMAIN\[rs]username\f[R] تنظیم کنید.
.PP
فایل پیکربندی شما باید به این شکل باشد:
.IP
.nf
\f[C]
[sharepoint]
type = webdav
url = https://[YOUR-DOMAIN]/some-path-to/Documents
vendor = sharepoint-ntlm
user = DOMAIN\[rs]user
pass = encryptedpassword
\f[R]
.fi.SS پرچم‌های الزامی برای SharePoint
.PP
از آنجا که SharePoint پردازش‌های خاصی روی سندهای بارگذاری‌شده انجام می‌دهد، شما
قادر نخواهید بود از اندازهٔ سند یا هش سندها برای مقایسهٔ اینکه آیا فایلی از زمان بارگذاری تغییر کرده است یا خیر / کدام فایل جدیدتر است، استفاده کنید.
.PP
برای فراخوانی‌های Rclone در رونوشت فایل‌ها (به‌ویژه فایل‌های Office مانند .docx،
\&.xlsx و غیره)
از/به SharePoint (مانند copy، sync و غیره)، باید این پرچم‌ها را اضافه کنید تا مطمئن شوید Rclone از ویژگی تاریخ و زمان \[dq]Last Modified\[dq] برای مقایسهٔ سندهای شما استفاده می‌کند:
.IP
.nf
\f[C]
--ignore-size --ignore-checksum --update
\f[R]
.fi
.SS Rclone
.PP
اگر ریموت‌ها را روی WebDAV ارائه‌شده توسط rclone میزبانی می‌کنید، از این گزینه استفاده کنید.
برای جزئیات بیشتر rclone serve webdav را بخوانید.
.PP
دستور rclone serve با استفاده از سرایند \f[V]X-OC-Mtime\f[R] از زمان‌های تغییر پشتیبانی می‌کند.
.SS dCache
.PP
سامانهٔ dCache یک سیستم ذخیره‌سازی است که از پروتکل‌ها و طرح‌های احراز هویت/مجوزدهی متعددی پشتیبانی می‌کند.
برای کلاینت‌های WebDAV، به کاربران امکان می‌دهد با نام کاربری و گذرواژه (BASIC)، X.509، Kerberos و توکن‌های حامل (bearer tokens) گوناگون، از جمله Macaroons (https://www.dcache.org/manuals/workshop-2017-05-29-Umea/000-Final/anupam_macaroons_v02.pdf)
و توکن‌های دسترسی OpenID-Connect (https://en.wikipedia.org/wiki/OpenID_Connect) احراز هویت کنند.
.PP
پیکربندی را طبق روال معمول با نوع \f[V]other\f[R] انجام دهید.
نام کاربری یا گذرواژه‌ای وارد نکنید، در عوض Macaroon خود را به‌عنوان \f[V]bearer_token\f[R] وارد نمایید.
.PP
پیکربندی در نهایت چیزی شبیه به این خواهد بود:
.IP
.nf
\f[C]
[dcache]
type = webdav
url = https://dcache...
vendor = other
user =
pass =
bearer_token = your-macaroon
\f[R]
.fi
.PP
یک
اسکریپت (https://github.com/sara-nl/GridScripts/blob/master/get-macaroon)
وجود دارد که یک Macaroon را از یک اندپوینت WebDAV در dCache دریافت کرده و یک فایل پیکربندی rclone ایجاد می‌کند.
.PP
همچنین می‌توان Macaroonها را از کلاینت مرورگر وب/جاوااسکریپت dCacheView که همراه با dCache ارائه می‌شود دریافت کرد.
.SS OpenID-Connect
.PP
همچنین dCache از احراز هویت با توکن‌های دسترسی OpenID-Connect پشتیبانی می‌کند.
پروتکل OpenID-Connect پروتکلی (مبتنی بر OAuth 2.0) است که به سرویس‌ها اجازه می‌دهد کاربرانی را که نزد یک سرویس مرکزی احراز هویت کرده‌اند، شناسایی کنند.
.PP
پشتیبانی از OpenID-Connect در rclone در حال حاضر با استفاده از بستهٔ نرم‌افزاری دیگری به نام
oidc-agent (https://github.com/indigo-dc/oidc-agent)
انجام می‌شود.
این یک ابزار خط فرمانی است که دریافت توکن دسترسی را تسهیل می‌کند.
پس از نصب و پیکربندی، با اجرای دستور \f[V]oidc-token\f[R] یک توکن دسترسی به دست می‌آید.
مثال زیر یک توکن دسترسی (کوتاه‌شده) را نشان می‌دهد که از تأمین‌کنندهٔ OIDC با عنوان \f[I]XDC\f[R] دریافت شده است.
.IP
.nf
\f[C]
paul\[at]celebrimbor:\[ti]$ oidc-token XDC
eyJraWQ[...]QFXDt0
paul\[at]celebrimbor:\[ti]$
\f[R]
.fi
.PP
\f[B]نکته\f[R] پیش از آنکه دستور \f[V]oidc-token\f[R] کار کند،
توکن نوسازی (refresh token) باید در oidc agent بارگذاری شود.
این کار با دستور \f[V]oidc-add\f[R] انجام می‌شود (مانند
\f[V]oidc-add XDC\f[R]).
این کار معمولاً یک‌بار در هر نشست ورود (login session) انجام می‌پذیرد.
جزئیات کامل دربارهٔ این موضوع و نحوهٔ ثبت oidc-agent با تأمین‌کنندهٔ OIDC شما در مستندات
oidc-agent (https://indigo-dc.gitbooks.io/oidc-agent)
ارائه شده است.
.PP
گزینهٔ پیکربندی \f[V]bearer_token_command\f[R] در rclone برای واکشی توکن دسترسی از oidc-agent استفاده می‌شود.
.PP
به‌عنوان یک اندپوینت WebDAV معمولی با استفاده از سازندهٔ \[aq]other\[aq] پیکربندی کنید و نام کاربری و گذرواژه را خالی بگذارید.
هنگام درخواست، ویرایش پیکربندی پیشرفته را انتخاب کنید و دستور لازم برای دریافت توکن حامل را وارد نمایید (مانند \f[V]oidc-agent XDC\f[R]).
.PP
مثال پیکربندی زیر یک اندپوینت WebDAV را نشان می‌دهد که از oidc-agent برای ارائهٔ توکن دسترسی از تأمین‌کنندهٔ OIDC با عنوان \f[I]XDC\f[R] استفاده می‌کند.
.IP
.nf
\f[C]
[dcache]
type = webdav
url = https://dcache.example.org
vendor = other
bearer_token_command = oidc-token XDC
\f[R]
.fi.SH "یاندکس دیسک (Yandex Disk)"
.PP
یاندکس دیسک (https://disk.yandex.com) یک راهکار ذخیره‌سازی ابری است که توسط یاندکس (https://yandex.com) ارائه شده است.
.SS "پیکربندی (Configuration)"
.PP
در ادامه نمونه‌ای از ایجاد یک پیکربندی yandex آورده شده است.
ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
n/s> n
name> remote
Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / Yandex Disk
   \[rs] \[dq]yandex\[dq]
[snip]
Storage> yandex
Yandex Client Id - leave blank normally.
client_id>
Yandex Client Secret - leave blank normally.
client_secret>
Remote config
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y) Yes
n) No
y/n> y
If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth
Log in and authorize rclone for access
Waiting for code...
Got code
Configuration complete.
Options:
- type: yandex
- client_id:
- client_secret:
- token: {\[dq]access_token\[dq]:\[dq]xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\[dq],\[dq]token_type\[dq]:\[dq]OAuth\[dq],\[dq]expiry\[dq]:\[dq]2016-12-29T12:27:11.362788025Z\[dq]}
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
\f[R]
.fi
.PP
برای چگونگی راه‌اندازی آن روی ماشینی بدون مرورگر وب متصل به اینترنت، مستندات راه‌اندازی ریموت (https://rclone.org/remote_setup) را ببینید.
.PP
توجه داشته باشید که \f[V]rclone\f[R] یک وب‌سرور روی ماشین محلی شما اجرا می‌کند تا توکن بازگردانده‌شده از Yandex Disk را دریافت کند.
این وب‌سرور تنها از لحظه باز شدن مرورگر تا لحظه دریافت کد تأیید اجرا می‌شود.
این سرویس روی \f[V]http://127.0.0.1:53682\f[R] فعال است و در صورتی که فایروال میزبان فعال باشد، ممکن است نیاز به رفع مسدودیت موقت آن داشته باشید.
.PP
پس از پیکربندی، می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید (به جای \f[V]remote\f[R] نامی را که به ریموت خود اختصاص داده‌اید قرار دهید):
.PP
مشاهده دایرکتوری‌های سطح بالا
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
ایجاد یک دایرکتوری جدید
.IP
.nf
\f[C]
rclone mkdir remote:directory
\f[R]
.fi
.PP
فهرست کردن محتویات یک دایرکتوری
.IP
.nf
\f[C]
rclone ls remote:directory
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با مسیر ریموت، با حذف هرگونه فایل اضافی در مسیر مقصد.
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory remote:directory
\f[R]
.fi
.PP
مسیرهای Yandex می‌توانند به میزان مورد نیاز تودرتو باشند، به عنوان مثال:
\f[V]remote:directory/subdirectory\f[R]..SS زمان‌های تغییر و هش‌ها
.PP
زمان‌های تغییر پشتیبانی می‌شوند و با دقت ۱ نانوثانیه در متادیتای سفارشی به نام \f[V]rclone_modified\f[R] در قالب RFC3339 همراه با نانوثانیه‌ها ذخیره می‌گردند.
.PP
الگوریتم هش MD5 به‌طور بومی توسط Yandex Disk پشتیبانی می‌شود.
.SS خالی کردن سطل زباله
.PP
اگر مایل به خالی کردن سطل زباله خود هستید، می‌توانید از دستور
\f[V]rclone cleanup remote:\f[R] استفاده کنید که تمامی فایل‌های سطل زباله را برای همیشه حذف خواهد کرد.
این دستور هیچ آرگومان مسیری نمی‌پذیرد.
.SS اطلاعات سهمیه (Quota)
.PP
برای مشاهده سهمیه فعلی خود می‌توانید از دستور
\f[V]rclone about remote:\f[R] استفاده کنید که محدودیت استفاده (سهمیه) و میزان مصرف فعلی شما را نمایش می‌دهد.
.SS نویسه‌های محدودشده در نام فایل
.PP
مجموعه پیش‌فرض نویسه‌های محدودشده
(https://rclone.org/overview/#restricted-characters) جایگزین می‌شوند.
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند
شد (https://rclone.org/overview/#invalid-utf8)، زیرا نمی‌توان از آن‌ها در رشته‌های JSON استفاده کرد.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص yandex (Yandex Disk) آورده شده است.
.SS --yandex-client-id
.PP
شناسه کلاینت OAuth (OAuth Client Id).
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_YANDEX_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --yandex-client-secret
.PP
رمز کلاینت OAuth (OAuth Client Secret).
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_YANDEX_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مختص yandex (Yandex Disk) آورده شده است.
.SS --yandex-token
.PP
توکن دسترسی OAuth در قالب یک JSON blob.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_YANDEX_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false
.SS --yandex-auth-url
.PP
نشانی اینترنتی (URL) سرور احراز هویت.
.PP
برای استفاده از پیش‌فرض‌های ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_YANDEX_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
ضروری: false.SS --yandex-token-url
.PP
نشانی اینترنتی (URL) سرور توکن.
.PP
جهت استفاده از پیش‌فرض‌های ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_YANDEX_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --yandex-client-credentials
.PP
استفاده از جریان اعتبارسنجی client credentials در OAuth.
.PP
این گزینه از جریان Client Credentials در OAUTH2، همان‌طور که در RFC 6749 شرح داده شده است، استفاده خواهد کرد.
.PP
توجه داشته باشید که این گزینه توسط همهٔ backendها پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_YANDEX_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --yandex-hard-delete
.PP
حذف دائمی فایل‌ها به جای انتقال آن‌ها به سطل زباله.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hard_delete
.IP \[bu] 2
متغیر محیطی: RCLONE_YANDEX_HARD_DELETE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --yandex-encoding
.PP
کدگذاری برای backend.
.PP
برای اطلاعات بیشتر بخش encoding را در نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_YANDEX_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,Del,Ctl,InvalidUtf8,Dot
.SS --yandex-spoof-ua
.PP
تنظیم شناسه کاربر (User Agent) برای مطابقت با نسخهٔ رسمی کلاینت Yandex Disk.
ممکن است به کارایی بارگذاری کمک کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: spoof_ua
.IP \[bu] 2
متغیر محیطی: RCLONE_YANDEX_SPOOF_UA
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: true
.SS --yandex-upload-wait
.PP
میزان انتظار پس از بارگذاری پیش از تنظیم زمان تغییر (modification time).
.PP
سرویس Yandex Disk پس از اتمام بارگذاری، آن را به‌صورت ناهمگام روی سرورهای خود نهایی می‌کند.
اگر زمان تغییر در حالی که این نهایی‌سازی هنوز در جریان است تنظیم شود، سرور خطاهای 500 Internal Server Error بازمی‌گرداند.
.PP
اگر هنگام بارگذاری با خطاهای 500 مواجه می‌شوید، تنظیم این مقدار روی 2s معمولاً برای متوقف کردن آن‌ها کافی است، هرچند به بهای کندتر شدن بارگذاری‌ها تمام می‌شود.
.PP
پشتیبانی Yandex مقداری بین 1.5s تا 3s را پیشنهاد می‌کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_wait
.IP \[bu] 2
متغیر محیطی: RCLONE_YANDEX_UPLOAD_WAIT
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 0s.SS --yandex-description
.PP
توضیحات ریموت.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_YANDEX_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS محدودیت‌ها
.PP
هنگام بارگذاری فایل‌های بسیار بزرگ (بزرگ‌تر از حدود ۵ گیبی‌بایت) نیاز خواهید داشت
که مقدار پارامتر \f[V]--timeout\f[R] را افزایش دهید.
این امر به این دلیل است که Yandex پیش از بازگرداندن تأییدیه مبنی بر اتمام بارگذاری
فایل، مکث می‌کند (احتمالاً برای محاسبه‌ی MD5SUM کل فایل).
رفتار پیش‌فرض rclone در مواجهه با مهلت زمانی (timeout)، تلقی کردن مکث ۵ دقیقه‌ای
به عنوان خطا و بستن اتصال است \- در صورتی که این اتفاق بیفتد خطاهای
\f[V]net/http: timeout awaiting response headers\f[R] را در گزارش‌ها
مشاهده خواهید کرد.
تنظیم مهلت زمانی روی دو برابر حداکثر اندازه‌ی فایل بر حسب گیبی‌بایت باید کافی باشد؛
بنابراین اگر می‌خواهید یک فایل ۳۰ گیبی‌بایتی را بارگذاری کنید، مهلت زمانی را روی
\f[V]2 * 30 = 60m\f[R] قرار دهید، یعنی \f[V]--timeout 60m\f[R].
.PP
اگر درست پس از بارگذاری‌ها، به‌ویژه هنگام بارگذاری هم‌زمان چندین فایل، با خطای
\f[V]500 Internal Server Error\f[R] مواجه شدید، تنظیم
\f[V]--yandex-upload-wait 2s\f[R] را امتحان کنید.
سرویس Yandex Disk فرایند بارگذاری را روی سرورهای خود به‌صورت ناهمگام نهایی می‌کند
و ممکن است اندکی قبل از آماده شدن کامل فایل، وضعیت را تکمیل‌شده گزارش دهد؛
بنابراین دسترسی زودهنگام به متادیتای فایل موجب بروز این خطاها می‌شود.
پشتیبانی Yandex توصیه می‌کند پس از هر بارگذاری بین ۱.۵ تا ۳ ثانیه صبر کنید.
.PP
داشتن یک حساب Yandex Mail برای استفاده از اشتراک Yandex.Disk الزامی است.
تولید توکن بدون حساب ایمیل انجام خواهد شد، اما Rclone قادر به انجام
هیچ عملیاتی نخواهد بود.
.IP
.nf
\f[C]
[403 - DiskUnsupportedUserAccountTypeError] User account type is not supported.
\f[R]
.fi
.SH Zoho Workdrive
.PP
سرویس Zoho WorkDrive (https://www.zoho.com/workdrive) یک راهکار ذخیره‌سازی ابری
است که توسط Zoho (https://zoho.com) توسعه یافته است.
.SS پیکربندی
.PP
در اینجا مثالی از ایجاد پیکربندی zoho آورده شده است.
ابتدا دستور زیر را اجرا کنید:
.IP
.nf
\f[C]
rclone config
\f[R]
.fi
.PP
این دستور شما را در یک فرایند راه‌اندازی تعاملی راهنمایی می‌کند:
.IP
.nf
\f[C]
No remotes found, make a new one?
n) New remote
s) Set configuration password
n/s> n
name> remote
Type of storage to configure.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
Choose a number from below, or type in your own value
[snip]
XX / Zoho
   \[rs] \[dq]zoho\[dq]
[snip]
Storage> zoho
** See help for zoho backend at: https://rclone.org/zoho **

OAuth Client Id
Leave blank normally.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
client_id> 
OAuth Client Secret
Leave blank normally.
Enter a string value. Press Enter for the default (\[dq]\[dq]).
client_secret> 
Edit advanced config? (y/n)
y) Yes
n) No (default)
y/n> n
Remote config
Use web browser to automatically authenticate rclone with remote?
 * Say Y if the machine running rclone has a web browser you can use
 * Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y) Yes (default)
n) No
y/n> 
If your browser doesn\[aq]t open automatically go to the following link: http://127.0.0.1:53682/auth?state=LVn0IHzxej1ZkmQw31d0wQ
Log in and authorize rclone for access
Waiting for code...
Got code
Choose a number from below, or type in your own value
 1 / MyTeam
   \[rs] \[dq]4u28602177065ff22426787a6745dba8954eb\[dq]
Enter a Team ID> 1
Choose a number from below, or type in your own value
 1 / General
   \[rs] \[dq]4u2869d2aa6fca04f4f2f896b6539243b85b1\[dq]
Enter a Workspace ID> 1
Configuration complete.
Options:
- type: zoho
- token: {\[dq]access_token\[dq]:\[dq]xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\[dq],\[dq]token_type\[dq]:\[dq]Zoho-oauthtoken\[dq],\[dq]refresh_token\[dq]:\[dq]xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\[dq],\[dq]expiry\[dq]:\[dq]2020-10-12T00:54:52.370275223+02:00\[dq]}
- root_folder_id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Keep this \[dq]remote\[dq] remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> 
\f[R]
.fi
.PP
برای اطلاع از نحوه‌ی راه‌اندازی روی سامانه‌ای که به مرورگر وب متصل به اینترنت دسترسی
ندارد، اسناد راه‌اندازی ریموت (https://rclone.org/remote_setup) را ببینید.
.PP
برنامه Rclone برای دریافت توکن احراز هویت از Zoho Workdrive، یک وب‌سرور را روی
رایانه‌ی محلی شما اجرا می‌کند.
این وب‌سرور فقط از لحظه‌ی باز شدن مرورگر تا زمان دریافت توکن فعال است.
وب‌سرور روی \f[V]http://127.0.0.1:53682\f[R] اجرا می‌شود.
اگر درگاه محلی \f[V]53682\f[R] توسط فایروال مسدود شده است، ممکن است لازم باشد
برای تکمیل فرایند احراز هویت، فایروال را موقتاً باز کنید.
.PP
پس از پیکربندی می‌توانید از \f[V]rclone\f[R] به این صورت استفاده کنید
(به جای \f[V]remote\f[R]، نامی را که به ریموت خود اختصاص داده‌اید وارد کنید):
.PP
مشاهده‌ی دایرکتوری‌های سطح بالا
.IP
.nf
\f[C]
rclone lsd remote:
\f[R]
.fi
.PP
ایجاد یک دایرکتوری جدید
.IP
.nf
\f[C]
rclone mkdir remote:directory
\f[R]
.fi
.PP
فهرست کردن محتویات یک دایرکتوری
.IP
.nf
\f[C]
rclone ls remote:directory
\f[R]
.fi
.PP
همگام‌سازی \f[V]/home/local/directory\f[R] با مسیر ریموت، و حذف هرگونه فایل
اضافی موجود در آن مسیر.
.IP
.nf
\f[C]
rclone sync --interactive /home/local/directory remote:directory
\f[R]
.fi
.PP
مسیرهای Zoho می‌توانند تا هر عمق مورد نیازی مشخص شوند، مانند
\f[V]remote:directory/subdirectory\f[R]..SS زمان‌های تغییر و مقادیر هش
.PP
زمان‌های تغییر در حال حاضر برای Zoho Workdrive پشتیبانی نمی‌شوند.
.PP
هیچ الگوریتم هشی پشتیبانی نمی‌شود.
.SS اطلاعات میزان مصرف
.PP
برای مشاهدهٔ سهمیهٔ فعلی خود می‌توانید از دستور
\f[V]rclone about remote:\f[R] استفاده کنید که میزان مصرف فعلی
شما را نمایش می‌دهد.
.SS نویسه‌های محدودشدهٔ نام فایل
.PP
تنها نویسه‌های کنترلی و UTF-8 نامعتبر جایگزین می‌شوند.
علاوه بر این، بیشتر نویسه‌های تمام‌عرض یونیکد به‌هیچ‌وجه پشتیبانی نمی‌شوند
و هنگام بارگذاری از نام فایل‌ها حذف خواهند شد.
.SS گزینه‌های استاندارد
.PP
در اینجا گزینه‌های استاندارد مختص zoho (Zoho) آورده شده است.
.SS --zoho-client-id
.PP
شناسهٔ کلاینت OAuth.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_id
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_CLIENT_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --zoho-client-secret
.PP
رمز کلاینت OAuth.
.PP
در حالت عادی خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_secret
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_CLIENT_SECRET
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.SS --zoho-region
.PP
ناحیهٔ Zoho برای اتصال.
.PP
باید از ناحیه‌ای استفاده کنید که سازمان شما در آن ثبت شده است.
اگر مطمئن نیستید، از همان دامنهٔ سطح‌بالایی استفاده کنید که در
مرورگر خود به آن متصل می‌شوید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: region
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_REGION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
اجباری: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]com\[dq]
.RS 2
.IP \[bu] 2
ایالات متحده / سراسری
.RE
.IP \[bu] 2
\[dq]eu\[dq]
.RS 2
.IP \[bu] 2
اروپا
.RE
.IP \[bu] 2
\[dq]in\[dq]
.RS 2
.IP \[bu] 2
هند
.RE
.IP \[bu] 2
\[dq]jp\[dq]
.RS 2
.IP \[bu] 2
ژاپن
.RE
.IP \[bu] 2
\[dq]com.cn\[dq]
.RS 2
.IP \[bu] 2
چین
.RE
.IP \[bu] 2
\[dq]com.au\[dq]
.RS 2
.IP \[bu] 2
استرالیا
.RE
.RE.SS "گزینه‌های پیشرفته (Advanced options)"
.PP
در اینجا گزینه‌های پیشرفته مختص zoho (Zoho) آمده است.
.SS --zoho-token
.PP
توکن دسترسی OAuth به‌صورت یک JSON blob.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_TOKEN
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --zoho-auth-url
.PP
نشانی اینترنتی (URL) سرور احراز هویت.
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: auth_url
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_AUTH_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --zoho-token-url
.PP
نشانی اینترنتی (URL) سرور توکن.
.PP
برای استفاده از مقادیر پیش‌فرض ارائه‌دهنده، خالی بگذارید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: token_url
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_TOKEN_URL
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS --zoho-client-credentials
.PP
استفاده از جریان OAuth با اعتبارسنجی کلاینت (client credentials).
.PP
این گزینه از جریان Client Credentials در OAUTH2 طبق آنچه در RFC
6749 شرح داده شده است استفاده خواهد کرد.
.PP
توجه داشته باشید که این گزینه توسط همه بک‌اندها پشتیبانی نمی‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: client_credentials
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_CLIENT_CREDENTIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --zoho-root-folder-id
.PP
شناسه پوشه ریشه.
.PP
در حالت عادی خالی بگذارید.
.PP
این فیلد را تکمیل کنید تا rclone از یک پوشه غیر ریشه به‌عنوان نقطه آغازین خود استفاده کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: root_folder_id
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_ROOT_FOLDER_ID
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS --zoho-upload-cutoff
.PP
آستانهٔ جابه‌جایی به API بارگذاری فایل‌های بزرگ (>= 10 MiB).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: upload_cutoff
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_UPLOAD_CUTOFF
.IP \[bu] 2
نوع: SizeSuffix
.IP \[bu] 2
پیش‌فرض: 10Mi
.SS --zoho-tpslimit
.PP
حداکثر تعداد تراکنش‌های API در هر ثانیه.
.PP
سرویس Zoho WorkDrive نرخ دسترسی به API خود را محدود می‌کند و هنگامی که فراخوانی‌ها بیش از حد سریع باشند، خطای HTTP 429 (خطای F7008، با پیام \[dq]Request rate limit exceeded\[dq]) بازمی‌گرداند؛ بنابراین فراخوانی‌های API داده (list، upload، download، copy، move، delete) با این نرخ تنظیم می‌شوند.
.PP
برای غیرفعال کردن سقف، آن را روی 0 تنظیم کنید که با --tpslimit سراسری هماهنگ است؛ با این حال تنظیم سرعت را نمی‌توان کاملاً خاموش کرد زیرا عقب‌نشینی (backoff) و Retry-After همواره اعمال می‌شوند.
.PP
مقدار پیش‌فرض 6 یک نرخ ایمن و پایدار است.
مقادیر بالاتر می‌توانند باعث توقف‌های طولانی Retry-After ناشی از خطای 429 شوند که توان عملیاتی را بدتر می‌کند، بنابراین فقط در صورتی آن را افزایش دهید که حساب شما ظرفیت بیشتری را تحمل کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: tpslimit
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_TPSLIMIT
.IP \[bu] 2
نوع: float64
.IP \[bu] 2
پیش‌فرض: 6
.SS --zoho-tpslimit-burst
.PP
تعداد فراخوانی‌های API مجاز به‌صورت متوالی و بدون وقفه (sleeping)، برای --zoho-tpslimit.
.PP
این مقدار ظرفیت سطل توکن (token-bucket) است.
برای Zoho آن را روی 1 نگه دارید: مقدار burst بزرگ‌تر از 1 اجازه می‌دهد پس از یک وقفهٔ بی‌باری، چندین فراخوانی به‌طور هم‌زمان ارسال شوند که می‌تواند خوشه‌های هم‌زمانی از خطاهای 429 ایجاد کند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: tpslimit_burst
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_TPSLIMIT_BURST
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 1
.SS --zoho-list-folder-limit
.PP
حداکثر دفعات مجاز فهرست‌کردن یک پوشهٔ یکسان در هر --zoho-list-folder-window.
.PP
سرویس Zoho WorkDrive نرخ دسترسی API فهرست‌بندی خود (GET files/{id}/files) را به‌ازای هر پوشه، مستقل از --zoho-tpslimit محدود می‌کند: فهرست‌کردن بیش از حد یک پوشه در مدت‌زمانی کوتاه، خطای HTTP 429 (خطای F7008) با جریمهٔ Retry-After چند دقیقه‌ای بازمی‌گرداند؛ چیزی که یک حلقهٔ فشردهٔ بررسی وضعیت (tight polling loop) حتی در یک نرخ کلی پایین نیز ممکن است با آن مواجه شود.
طبق اندازه‌گیری‌های عملی، Zoho در هر بازهٔ زمانی لغزانِ حدوداً ۶۰ ثانیه‌ای، اجازهٔ \[ti]19 بار فهرست‌کردن یک پوشه را می‌دهد و تلاش بیستم ناموفق خواهد بود، که مقادیر پیش‌فرض (19 در هر 60s) دقیقاً همین رفتار را شبیه‌سازی می‌کنند.
.PP
این یک سقف واقعی به‌ازای هر بازه برای هر نوع الگوی ترافیکی است: هر بازه با عبور متوالیِ تعداد --zoho-list-folder-burst فهرست‌بندی آغاز می‌شود (burst در هر مرز بازه مجدداً فعال می‌شود) و بقیه با فاصلهٔ --zoho-list-folder-window/(limit - burst) از یکدیگر پخش می‌شوند (مقادیر پیش‌فرض حدود \[ti]4.6s فاصله می‌دهند)، در حالی که گزارش لغزانی از فهرست‌بندی‌های اخیر، سقف را در مرزهای بازه اعمال می‌کند.
مقدار 0 محدودکننده را غیرفعال می‌کند.
تنها فهرست‌بندی‌های مکرر یک پوشه به تأخیر می‌افتند؛ پوشه‌های مختلف، یا پوشه‌ای که کمتر از --zoho-list-folder-burst بار فهرست شده باشد، هرگز دچار تأخیر نمی‌شوند.
.PP
مقدار بالاتر به معنای فهرست‌بندی‌های بیشتر در هر بازه است، نه ایمنی بیشتر: افزایش آن به بالاتر از 19 خطای F7008 را ایجاد می‌کند.
برای ایجاد حاشیهٔ امن بیشتر آن را کاهش دهید، هرچند به قیمت کاهش سرعت پاسخ‌گویی فهرست‌بندی تمام می‌شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_folder_limit
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_LIST_FOLDER_LIMIT
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 19.SS --zoho-list-folder-window
.PP
پنجره زمانی برای \-\-zoho\-list\-folder\-limit.
.PP
مقدار پیش‌فرض 60s (نمایش‌داده‌شده به‌صورت 1m0s) با پنجره لغزان واقعی Zoho مطابقت دارد: حداکثر به تعداد \-\-zoho\-list\-folder\-limit فهرست‌کردن یک پوشه در هر پنجره‌ای با این طول مجاز است.
یک عدد تنها بر حسب ثانیه پردازش می‌شود (\[dq]60\[dq] = \[dq]60s\[dq]).
.PP
برای داشتن حاشیه امنیت بیشتر، آن را افزایش دهید (یا حد مجاز را کاهش دهید)؛ فاصله پیوسته میان فهرست‌کردن‌های یک پوشه مشابه عبارت است از window/(limit - burst).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_folder_window
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_LIST_FOLDER_WINDOW
.IP \[bu] 2
نوع: Duration
.IP \[bu] 2
پیش‌فرض: 1m0s
.SS --zoho-list-folder-burst
.PP
تعداد دفعات فهرست‌کردن پشت‌سرهم یک پوشه پیش از آنکه \-\-zoho\-list\-folder\-limit سرعت آن‌ها را تنظیم کند.
.PP
این رگبار (burst) از دل \-\-zoho\-list\-folder\-limit کسر می‌شود، بنابراین افزایش آن هرگز مجموع در هر پنجره را افزایش نمی‌دهد: این تعداد فهرست‌کردن می‌تواند بلافاصله انجام شود و مابقی (limit - burst) با فواصل زمانی window/(limit - burst) از هم قرار می‌گیرند.
رگبار در مرز هر پنجره زمانی مجدداً فعال می‌شود (RE-ARMS)، بنابراین فهرست‌کردن مداوم در هر پنجره یک رگبار تازه دریافت می‌کند، در حالی که گزارش لغزانِ فهرست‌کردن‌های اخیر همچنان سقف هر پنجره را اعمال می‌کند.
پوشه‌ای که فقط چند بار فهرست شود (حالت رایج \- یک همگام‌سازی که یک دایرکتوری را چند بار فهرست کرده و سپس عبور می‌کند) هرگز معطل نخواهد شد.
.PP
مقدار پیش‌فرض 6 بزرگ‌ترین رگباری است که به‌صورت زنده تحت سقف پیش‌فرض ۱۹ مورد در هر ۶۰ ثانیه تأیید شده است (رگبارهای ۴، ۵ و ۶ همگی بدون خطا اجرا شدند؛ یک آزمایش فراتر از سقف دقیقاً در بیستمین فهرست‌کردن در یک پنجره منجر به خطای F7008 شد).
آن را بسیار کمتر از حدود ۱۵ (\[ti]15) نگه دارید \- Zoho بدون در نظر گرفتن پنجره زمانی، یک سقف لحظه‌ای پشت‌سرهم حدود ۱۵\-۱۶ نیز دارد.
برای سرعت‌بندی از دومین فهرست‌کردن، آن را روی 1 تنظیم کنید.
مقادیر >= حد مجاز به limit - 1 محدود می‌شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: list_folder_burst
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_LIST_FOLDER_BURST
.IP \[bu] 2
نوع: int
.IP \[bu] 2
پیش‌فرض: 6
.SS --zoho-encoding
.PP
کدگذاری برای بک‌اند.
.PP
برای اطلاعات بیشتر، بخش encoding را در نمای کلی (https://rclone.org/overview/#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Del,Ctl,InvalidUtf8
.SS --zoho-description
.PP
توضیحات remote.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_ZOHO_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false.SS راه‌اندازی client_id اختصاصی خود
.PP
برای Zoho توصیه می‌کنیم client_id اختصاصی خود را تنظیم کنید.
برای این کار، باید مراحل زیر را انجام دهید:
.IP "1." 3
به Zoho API Console (https://api-console.zoho.com) وارد شوید.
.IP "2." 3
یک کلاینت جدید از نوع \[dq]Server-based Application\[dq] ایجاد کنید.
نام و وب‌سایت اهمیتی ندارند، اما باید redirect URL به نشانی
\f[V]http://localhost:53682\f[R] را اضافه کنید.
.IP "3." 3
پس از ایجاد کلاینت، می‌توانید به برگهٔ تنظیمات (settings) رفته و آن را
در دیگر مناطق (regions) فعال کنید.
.PP
اکنون می‌توان از client id و client secret در rclone استفاده کرد.
.SH "سیستم فایل محلی (Local Filesystem)"
.PP
مسیرهای محلی مانند مسیرهای عادی سیستم فایل مشخص می‌شوند، مانند
\f[V]/path/to/wherever\f[R]؛ بنابراین
.IP
.nf
\f[C]
rclone sync --interactive /home/source /tmp/destination
\f[R]
.fi
.PP
مسیر \f[V]/home/source\f[R] را با \f[V]/tmp/destination\f[R] همگام‌سازی خواهد کرد.
.SS پیکربندی
.PP
برای حفظ یکپارچگی، می‌توان یک ریموت از نوع
\f[V]local\f[R] را نیز در فایل پیکربندی تنظیم کرد و با استفاده از مسیرهای ریموت rclone به سیستم فایل محلی دسترسی داشت، مانند
\f[V]remote:path/to/wherever\f[R]؛ اما احتمالاً آسان‌تر است که این کار را نکنید.
.SS زمان‌های تغییر
.PP
ابزار rclone زمان‌های تغییر را با دقتی که توسط سیستم‌عامل تعیین می‌شود، می‌خواند و می‌نویسد.
معمولاً این مقدار در Linux برابر با 1ns، در Windows برابر با 10 ns و در OS X برابر با 1 Second است.
.SS نام فایل‌ها
.PP
نام فایل‌ها روی دیسک باید با کدگذاری UTF-8 ذخیره شوند.
این حالت معمول برای Windows و OS X است.
.PP
در دنیای Linux ابهام کمی بیشتر است، اما توزیع‌های جدید نام فایل‌ها را با کدگذاری UTF-8 ذخیره می‌کنند.
اگر از یک سیستم فایل قدیمی Linux با نام‌های غیر UTF-8 (مانند latin1) استفاده می‌کنید، می‌توانید از ابزار \f[V]convmv\f[R] برای تبدیل سیستم فایل به UTF-8 استفاده کنید.
این ابزار در مدیر بسته‌های بیشتر توزیع‌ها در دسترس است.
.PP
اگر یک نام فایل نامعتبر (غیر UTF-8) خوانده شود، نویسه‌های نامعتبر با یک نمایش نقل‌قول‌شده از بایت‌های نامعتبر جایگزین خواهند شد.
نام \f[V]gro\[rs]xdf\f[R] به صورت \f[V]gro‛DF\f[R] منتقل خواهد شد.
ابزار \f[V]rclone\f[R] در این حالت یک پیام اشکال‌زدایی صادر خواهد کرد (برای مشاهده از \f[V]-v\f[R] استفاده کنید)، مانند:
.IP
.nf
\f[C]
Local file system at .: Replacing invalid UTF-8 characters in \[dq]gro\[rs]xdf\[dq]
\f[R]
.fi
.SS نویسه‌های محدودشده
.PP
در بک‌اند محلی، محدودیت‌های مربوط به نویسه‌های قابل استفاده در نام فایل‌ها یا دایرکتوری‌ها به سیستم‌عامل بستگی دارد.
برای بررسی اینکه rclone به‌طور پیش‌فرض در سیستم شما چه مواردی را جایگزین می‌کند، دستور
\f[V]rclone help flags local-encoding\f[R] را اجرا کنید.
.PP
در پلتفرم‌های غیر Windows، هنگام پردازش نام فایل‌ها نویسه‌های زیر جایگزین می‌شوند.
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
NUL
T}@T{
0x00
T}@T{
␀
T}
T{
/
T}@T{
0x2F
T}@T{
／
T}
.TE
.PP
هنگام اجرا در Windows، نویسه‌های زیر جایگزین می‌شوند.
این فهرست بر اساس قواعد نام‌گذاری فایل در Windows
(https://docs.microsoft.com/windows/desktop/FileIO/naming-a-file#naming-conventions) تهیه شده است.
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
NUL
T}@T{
0x00
T}@T{
␀
T}
T{
SOH
T}@T{
0x01
T}@T{
␁
T}
T{
STX
T}@T{
0x02
T}@T{
␂
T}
T{
ETX
T}@T{
0x03
T}@T{
␃
T}
T{
EOT
T}@T{
0x04
T}@T{
␄
T}
T{
ENQ
T}@T{
0x05
T}@T{
␅
T}
T{
ACK
T}@T{
0x06
T}@T{
␆
T}
T{
BEL
T}@T{
0x07
T}@T{
␇
T}
T{
BS
T}@T{
0x08
T}@T{
␈
T}
T{
HT
T}@T{
0x09
T}@T{
␉
T}
T{
LF
T}@T{
0x0A
T}@T{
␊
T}
T{
VT
T}@T{
0x0B
T}@T{
␋
T}
T{
FF
T}@T{
0x0C
T}@T{
␌
T}
T{
CR
T}@T{
0x0D
T}@T{
␍
T}
T{
SO
T}@T{
0x0E
T}@T{
␎
T}
T{
SI
T}@T{
0x0F
T}@T{
␏
T}
T{
DLE
T}@T{
0x10
T}@T{
␐
T}
T{
DC1
T}@T{
0x11
T}@T{
␑
T}
T{
DC2
T}@T{
0x12
T}@T{
␒
T}
T{
DC3
T}@T{
0x13
T}@T{
␓
T}
T{
DC4
T}@T{
0x14
T}@T{
␔
T}
T{
NAK
T}@T{
0x15
T}@T{
␕
T}
T{
SYN
T}@T{
0x16
T}@T{
␖
T}
T{
ETB
T}@T{
0x17
T}@T{
␗
T}
T{
CAN
T}@T{
0x18
T}@T{
␘
T}
T{
EM
T}@T{
0x19
T}@T{
␙
T}
T{
SUB
T}@T{
0x1A
T}@T{
␚
T}
T{
ESC
T}@T{
0x1B
T}@T{
␛
T}
T{
FS
T}@T{
0x1C
T}@T{
␜
T}
T{
GS
T}@T{
0x1D
T}@T{
␝
T}
T{
RS
T}@T{
0x1E
T}@T{
␞
T}
T{
US
T}@T{
0x1F
T}@T{
␟
T}
T{
/
T}@T{
0x2F
T}@T{
／
T}
T{
\[dq]
T}@T{
0x22
T}@T{
＂
T}
T{
*
T}@T{
0x2A
T}@T{
＊
T}
T{
:
T}@T{
0x3A
T}@T{
：
T}
T{
<
T}@T{
0x3C
T}@T{
＜
T}
T{
>
T}@T{
0x3E
T}@T{
＞
T}
T{
?
T}@T{
0x3F
T}@T{
？
T}
T{
\[rs]
T}@T{
0x5C
T}@T{
＼
T}
T{
|
T}@T{
0x7C
T}@T{
｜
T}
.TE.TE
.PP
نام‌های فایل در Windows همچنین نمی‌توانند با نویسه‌های زیر خاتمه یابند.
این نویسه‌ها تنها در صورتی جایگزین می‌شوند که آخرین نویسه در نام باشند:
.PP
.TS
tab(@);
l c c.
T{
نویسه
T}@T{
مقدار
T}@T{
جایگزین
T}
_
T{
SP
T}@T{
0x20
T}@T{
␠
T}
T{
\&.
T}@T{
0x2E
T}@T{
．
T}
.TE
.PP
بایت‌های نامعتبر UTF-8 نیز جایگزین خواهند شد
(https://rclone.org/overview/#invalid-utf8)، چرا که امکان
تبدیل آن‌ها به UTF-16 وجود ندارد.
.SS مسیرها در Windows
.PP
در Windows روش‌های متعددی برای مشخص کردن مسیر به یک منبع سامانهٔ فایل
وجود دارد.
مسیرهای محلی می‌توانند مطلق باشند، مانند
\f[V]C:\[rs]path\[rs]to\[rs]wherever\f[R]، یا نسبی، مانند
\f[V]..\[rs]wherever\f[R].
مسیرهای شبکه‌ای در قالب UNC مانند \f[V]\[rs]\[rs]server\[rs]share\f[R] نیز
پشتیبانی می‌شوند.
جداکنندهٔ مسیر می‌تواند \f[V]\[rs]\f[R] (مانند
\f[V]C:\[rs]path\[rs]to\[rs]wherever\f[R]) یا \f[V]/\f[R] (مانند
\f[V]C:/path/to/wherever\f[R]) باشد.
طول این مسیرها برای فایل‌ها به ۲۵۹ نویسه و برای دایرکتوری‌ها به ۲۴۷
نویسه محدود شده است، اما قالب مسیر بسط‌یافتهٔ دیگری وجود دارد که این
محدودیت را به (تقریباً) ۳۲٬۷۶۷ نویسه افزایش می‌دهد.
این قالب نیازمند مسیرهای مطلق و استفاده از پیشوند
\f[V]\[rs]\[rs]?\[rs]\f[R] است، برای نمونه:
\f[V]\[rs]\[rs]?\[rs]D:\[rs]some\[rs]very\[rs]long\[rs]path\f[R].
برای سهولت کار، rclone به‌طور خودکار مسیرهای معمولی را به مسیرهای
بسط‌یافتهٔ متناظر تبدیل می‌کند، بنابراین در اکثر موارد نیازی نیست
نگران این موضوع باشید (توضیحات بیشتر در ادامه آمده است).
همچنین با استفاده از همان پیشوند \f[V]\[rs]\[rs]?\[rs]\f[R] می‌توان
مسیر حجم‌هایی را که با شناسهٔ GUID مشخص شده‌اند تعیین کرد، مانند
\f[V]\[rs]\[rs]?\[rs]Volume{b75e2c83-0000-0000-0000-602f00000000}\[rs]some\[rs]path\f[R].
.SS مسیرهای طولانی
.PP
دستور rclone مسیرهای طولانی را به‌طور خودکار با تبدیل تمام مسیرها به
قالب مسیر بسط‌یافته
(https://docs.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation)
مدیریت می‌کند، که امکان استفاده از مسیرهایی تا ۳۲٬۷۶۷ نویسه را فراهم می‌سازد.
.PP
این تبدیل تضمین می‌کند که مسیرها مطلق بوده و پیشوند
\f[V]\[rs]\[rs]?\[rs]\f[R] به آن‌ها اضافه می‌شود.
به همین دلیل است که مشاهده خواهید کرد مسیرهای شما، برای نمونه
\f[V].\[rs]files\f[R] در خروجی به‌صورت مسیر
\f[V]\[rs]\[rs]?\[rs]C:\[rs]files\f[R]، و
\f[V]\[rs]\[rs]server\[rs]share\f[R] به‌صورت
\f[V]\[rs]\[rs]?\[rs]UNC\[rs]server\[rs]share\f[R] نمایش داده می‌شوند.
.PP
با این حال، در موارد نادر ممکن است این امر در درایورهای سامانه‌فایل
دارای باگ مانند EncFS (https://github.com/rclone/rclone/issues/261) مشکلاتی ایجاد کند.
برای غیرفعال کردن سراسری تبدیل UNC، این خطوط را به فایل
\f[V].rclone.conf\f[R] خود اضافه کنید:
.IP
.nf
\f[C]
[local]
nounc = true
\f[R]
.fi
.PP
اگر می‌خواهید تبدیل UNC را به‌صورت انتخابی غیرفعال کنید، می‌توانید آن را به یک
مدخل جداگانه مانند زیر اضافه نمایید:
.IP
.nf
\f[C]
[nounc]
type = local
nounc = true
\f[R]
.fi
.PP
و rclone را این‌گونه به کار ببرید:
.PP
\f[V]rclone copy c:\[rs]src nounc:z:\[rs]dst\f[R]
.PP
این کار در \f[V]c:\[rs]src\f[R] از مسیرهای UNC استفاده می‌کند، اما در
\f[V]z:\[rs]dst\f[R] خیر.
البته در صورتی که طول مسیر مطلق یک فایل روی z از ۲۵۹ نویسه فراتر رود، این کار
مشکلاتی ایجاد خواهد کرد؛ بنابراین تنها در صورت ضرورت از این گزینه استفاده کنید..SS پیوندهای نمادین / نقاط اتصال (Symlinks / Junction points)
.PP
به طور معمول rclone پیوندهای نمادین (symlinks) یا نقاط اتصال (junction points، که در ویندوز رفتاری شبیه به پیوندهای نمادین دارند) را نادیده می‌گیرد.
.PP
اگر گزینهٔ \f[V]--copy-links\f[R] یا \f[V]-L\f[R] را مشخص کنید، rclone پیوند نمادین را دنبال کرده و فایل یا دایرکتوری مورد اشاره را کپی می‌کند.
توجه داشته باشید که این پرچم با \f[V]--links\f[R] /
\f[V]-l\f[R] ناسازگار است.
.PP
این پرچم برای تمامی دستورها اعمال می‌شود.
.PP
برای مثال، فرض کنید ساختار دایرکتوری‌ای به این صورت دارید:
.IP
.nf
\f[C]
$ tree /tmp/a
/tmp/a
├── b -> ../b
├── expected -> ../expected
├── one
└── two
    └── three
\f[R]
.fi
.PP
سپس می‌توانید تفاوت را با و بدون این پرچم به این صورت مشاهده کنید:
.IP
.nf
\f[C]
$ rclone ls /tmp/a
        6 one
        6 two/three
\f[R]
.fi
.PP
و
.IP
.nf
\f[C]
$ rclone -L ls /tmp/a
     4174 expected
        6 one
        6 two/three
        6 b/two
        6 b/one
\f[R]
.fi
.SS --local-links, --links, -l
.PP
به طور معمول rclone پیوندهای نمادین یا نقاط اتصال (که در ویندوز رفتاری شبیه به پیوندهای نمادین دارند) را نادیده می‌گیرد.
.PP
اگر این پرچم را مشخص کنید، rclone پیوندهای نمادین را از حافظهٔ محلی کپی کرده و آن‌ها را به عنوان فایل‌های متنی با پسوند
\f[V].rclonelink\f[R] در حافظهٔ دوردست ذخیره می‌کند.
.PP
این فایل متنی حاوی مقصد پیوند نمادین خواهد بود (مثال را ببینید).
.PP
این پرچم برای تمامی دستورها اعمال می‌شود.
.PP
برای مثال، فرض کنید ساختار دایرکتوری‌ای به این صورت دارید:
.IP
.nf
\f[C]
$ tree /tmp/a
/tmp/a
├── file1 -> ./file4
└── file2 -> /home/user/file3
\f[R]
.fi
.PP
کپی کردن کل دایرکتوری با \[aq]-l\[aq]:
.IP
.nf
\f[C]
rclone copy -l /tmp/a/ remote:/tmp/a/
\f[R]
.fi
.PP
فایل‌های دوردست با پسوند \f[V].rclonelink\f[R] ایجاد می‌شوند:
.IP
.nf
\f[C]
$ rclone ls remote:/tmp/a
       5 file1.rclonelink
      14 file2.rclonelink
\f[R]
.fi
.PP
فایل‌های دوردست شامل مقصد پیوندهای نمادین خواهند بود:
.IP
.nf
\f[C]
$ rclone cat remote:/tmp/a/file1.rclonelink
\&./file4

$ rclone cat remote:/tmp/a/file2.rclonelink
/home/user/file3
\f[R]
.fi
.PP
کپی کردن دوبارهٔ آن‌ها با \[aq]-l\[aq]:
.IP
.nf
\f[C]
$ rclone copy -l remote:/tmp/a/ /tmp/b/

$ tree /tmp/b
/tmp/b
├── file1 -> ./file4
└── file2 -> /home/user/file3
\f[R]
.fi
.PP
با این حال، در صورت کپی بازگشتی بدون \[aq]-l\[aq]:
.IP
.nf
\f[C]
$ rclone copyto remote:/tmp/a/ /tmp/b/

$ tree /tmp/b
/tmp/b
├── file1.rclonelink
└── file2.rclonelink
\f[R]
.fi
.PP
اگر می‌خواهید یک تک‌فایل را با \f[V]-l\f[R] کپی کنید، باید از پسوند
\f[V].rclonelink\f[R] استفاده کنید.
.IP
.nf
\f[C]
$ rclone copy -l remote:/tmp/a/file1.rclonelink /tmp/c

$ tree /tmp/c
/tmp/c
└── file1 -> ./file4
\f[R]
.fi
.PP
توجه داشته باشید که \f[V]--local-links\f[R] این ویژگی را صرفاً برای بک‌اند محلی (local backend) فعال می‌کند.
\f[V]--links\f[R] و \f[V]-l\f[R] این ویژگی را برای تمام بک‌اندهای پشتیبانی‌شده و VFS فعال می‌سازند.
.PP
توجه داشته باشید که این پرچم با \f[V]-copy-links\f[R] /
\f[V]-L\f[R] ناسازگار است..SS مقصدهای پیوند نمادین و مقصد
.PP
هنگامی که rclone یک فایل \f[V].rclonelink\f[R] را به عنوان پیوند نمادین (symlink) روی فضای ذخیره‌سازی محلی بازسازی می‌کند، این پیوند می‌تواند به هر جایی اشاره کند — از جمله با یک مسیر مطلق یا مسیری با استفاده از \f[V]../\f[R] — به مکانی خارج از دایرکتوری مورد نظری که درون آن کپی می‌کنید.
این رفتاری عادی است؛ rclone دقیقاً همان مقصدی را که پیوند داشته بازتولید می‌کند تا نسخه‌های پشتیبان بدون نقص بازگردانی شوند.
.PP
کاری که rclone انجام \f[B]نخواهد داد\f[R]، \f[I]نوشتن از طریق\f[R] چنین پیوندی است.
اگر یک ریموت که از آن کپی می‌کنید، هم حاوی یک پیوند نمادین باشد و هم فایل یا دایرکتوری دیگری که باید درون آن قرار گیرد — برای مثال یک \f[V]dir.rclonelink\f[R] که به نقطه‌ای خارج از مقصد اشاره دارد، در کنار یک \f[V]dir/file.txt\f[R] — ابزار rclone هنگام نوشتن \f[V]dir/file.txt\f[R] از دنبال کردن پیوند نمادین خودداری می‌کند.
فایل مورد نظر همراه با یک خطا نادیده گرفته می‌شود، مابقی فرآیند انتقال ادامه می‌یابد، و فایل نادیده‌گرفته‌شده در خلاصه خطاهای چاپ‌شده در انتهای اجرا شمارش می‌شود.
.PP
این ویژگی از شما در برابر یک ریموت مخرب یا آسیب‌دیده محافظت می‌کند که بخواهد با استفاده از \f[V]-l\f[R] / \f[V]--links\f[R] یک پیوند نمادین ایجاد کرده و سپس از طریق آن، در مکانی بیرون از مقصد تعیین‌شده بنویسد.
جابه‌جایی‌های عادی پیوندهای نمادین، و پیوندهایی که درون دایرکتوری مقصد باقی می‌مانند، تحت تأثیر این موضوع قرار نمی‌گیرند.
.PP
اگر عمداً از قبل یک دایرکتوری با پیوند نمادین در داخل مقصد خود ایجاد کرده‌اید و می‌خواهید rclone در دایرکتوری مورد اشارهٔ آن بنویسد، برای آن عملیات کپی از \f[V]-l\f[R] / \f[V]--links\f[R] استفاده نکنید، یا ابتدا آن پیوند نمادین را حذف کنید.
.SS محدود کردن فایل‌سیستم‌ها با --one-file-system
.PP
در حالت عادی rclone به صورت بازگشتی از تمام فایل‌سیستم‌های مونت‌شده عبور می‌کند.
.PP
با این حال اگر گزینه \f[V]--one-file-system\f[R] یا \f[V]-x\f[R] را تنظیم کنید، این کار به rclone اعلام می‌کند که در فایل‌سیستم مشخص‌شده توسط ریشه باقی بماند و وارد فایل‌سیستم‌های دیگر نشود.
.PP
برای مثال اگر سلسله‌مراتبی از دایرکتوری‌ها به این شکل داشته باشید:
.IP
.nf
\f[C]
root
├── disk1     - disk1 mounted on the root
│\ \  └── file3 - stored on disk1
├── disk2     - disk2 mounted on the root
│\ \  └── file4 - stored on disk12
├── file1     - stored on the root disk
└── file2     - stored on the root disk
\f[R]
.fi
.PP
استفاده از \f[V]rclone --one-file-system copy root remote:\f[R] تنها \f[V]file1\f[R] و \f[V]file2\f[R] را کپی خواهد کرد.
به عنوان مثال:
.IP
.nf
\f[C]
$ rclone -q --one-file-system ls root
        0 file1
        0 file2
\f[R]
.fi
.IP
.nf
\f[C]
$ rclone -q ls root
        0 disk1/file3
        0 disk2/file4
        0 file1
        0 file2
\f[R]
.fi
.PP
\f[B]نکته:\f[R] ابزار Rclone (مانند اغلب ابزارهای یونیکس نظیر \f[V]du\f[R]، \f[V]rsync\f[R] و \f[V]tar\f[R]) با یک bind mount به همان دستگاه، مانند عضوی از همان فایل‌سیستم رفتار می‌کند.
.PP
\f[B]نکته:\f[R] این پرچم تنها در سیستم‌های مبتنی بر یونیکس موجود است.
در سیستم‌هایی که این قابلیت پشتیبانی نمی‌شود (مانند Windows)، نادیده گرفته خواهد شد..SS گزینه‌های پیشرفته
.PP
در اینجا گزینه‌های پیشرفته مخصوص local (دیسک محلی) آورده شده است.
.SS --local-nounc
.PP
غیرفعال کردن تبدیل UNC (نام‌های مسیر طولانی) در Windows.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: nounc
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_NOUNC
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]true\[dq]
.RS 2
.IP \[bu] 2
نام‌های فایل طولانی را غیرفعال می‌کند.
.RE
.RE
.SS --copy-links / -L
.PP
دنبال کردن پیوندهای نمادین (symlinks) و کپی کردن موردی که به آن اشاره شده است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: copy_links
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_COPY_LINKS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --local-links
.PP
تبدیل پیوندهای نمادین (symlinks) به/از فایل‌های معمولی با پسوند \[aq].rclonelink\[aq] برای backend محلی.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: links
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_LINKS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --skip-links
.PP
عدم نمایش هشدار درباره پیوندهای نمادین (symlinks) نادیده‌گرفته‌شده.
.PP
این پرچم پیام‌های هشدار درباره پیوندهای نمادین (symlinks) یا نقاط اتصال (junction points) نادیده‌گرفته‌شده را غیرفعال می‌کند، چرا که شما صراحتاً تأیید کرده‌اید که باید نادیده گرفته شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: skip_links
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_SKIP_LINKS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --skip-specials
.PP
عدم نمایش هشدار درباره لوله‌ها (pipes)، سوکت‌ها (sockets) و اشیاء دستگاهی (device objects) نادیده‌گرفته‌شده.
.PP
این پرچم پیام‌های هشدار درباره لوله‌ها (pipes)، سوکت‌ها (sockets) و اشیاء دستگاهی (device objects) نادیده‌گرفته‌شده را غیرفعال می‌کند، چرا که شما صراحتاً تأیید کرده‌اید که باید نادیده گرفته شوند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: skip_specials
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_SKIP_SPECIALS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --local-zero-size-links
.PP
فرض صفر بودن اندازه Stat پیوندها (و خواندن آن‌ها به جای آن)
(منسوخ‌شده).
.PP
در گذشته rclone از اندازه Stat پیوندها به عنوان اندازه پیوند استفاده می‌کرد، اما این کار در چندین مورد با شکست مواجه می‌شود:
.IP \[bu] 2
Windows
.IP \[bu] 2
در برخی فایل‌سیستم‌های مجازی (مانند LucidLink)
.IP \[bu] 2
Android
.PP
بنابراین اکنون rclone همیشه پیوند را می‌خواند.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: zero_size_links
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_ZERO_SIZE_LINKS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --local-unicode-normalization
.PP
اعمال نرمال‌سازی یونیکد NFC روی مسیرها و نام فایل‌ها.
.PP
این پرچم می‌تواند برای نرمال‌سازی نام فایل‌های خوانده‌شده از فایل‌سیستم محلی به فرم یونیکد NFC استفاده شود.
.PP
به‌طور معمول rclone کدگذاری نام فایل‌هایی را که از فایل‌سیستم می‌خواند تغییر نمی‌دهد.
.PP
این ویژگی می‌تواند هنگام استفاده از macOS مفید باشد، زیرا این سیستم‌عامل معمولاً یونیکد تجزیه‌شده (NFD) ارائه می‌دهد که در برخی زبان‌ها (مانند کره‌ای) در بعضی سیستم‌عامل‌ها به‌درستی نمایش داده نمی‌شود.
.PP
توجه داشته باشید که rclone در روال همگام‌سازی نام فایل‌ها را با نرمال‌سازی یونیکد مقایسه می‌کند، بنابراین این پرچم معمولاً نباید استفاده شود.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: unicode_normalization
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_UNICODE_NORMALIZATION
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --local-no-check-updated
.PP
بررسی نکردن تغییر فایل‌ها در حین بارگذاری.
.PP
به‌طور معمول rclone اندازه و زمان تغییر فایل‌ها را هنگام بارگذاری بررسی می‌کند و اگر فایل در طول بارگذاری تغییر کند، با پیامی که با \[dq]can\[aq]t copy \- source file is being updated\[dq] آغاز می‌شود عملیات را متوقف می‌کند.
.PP
با این حال در برخی فایل‌سیستم‌ها ممکن است این بررسی زمان تغییر با خطا مواجه شود (برای نمونه Glusterfs شماره 2206 در <https://github.com/rclone/rclone/issues/2206>)، بنابراین این بررسی را می‌توان با این پرچم غیرفعال کرد.
.PP
اگر این پرچم تنظیم شود، rclone تمام تلاش خود را برای انتقال فایلی که در حال به‌روزرسانی است به کار خواهد بست.
اگر تنها به انتهای فایل مواردی افزوده می‌شود (مانند یک فایل log)، در این صورت rclone فایل log را با اندازه‌ای که در اولین بار مشاهده آن داشت منتقل خواهد کرد.
.PP
اگر فایل در سراسر آن تغییر یابد (نه اینکه فقط به انتهای آن افزوده شود)، انتقال ممکن است با شکست در بررسی هش (hash check) مواجه شود.
.PP
به‌طور دقیق‌تر، هنگامی که برای نخستین بار stat() روی فایل فراخوانی شد:
.IP \[bu] 2
تنها اندازه‌ای را که stat ارائه داده انتقال می‌دهیم
.IP \[bu] 2
تنها مجموع مقابله‌ای (checksum) اندازه‌ای را که stat ارائه داده محاسبه می‌کنیم
.IP \[bu] 2
اطلاعات stat فایل را به‌روزرسانی نمی‌کنیم
.PP
\f[B]توجه:\f[R] از این پرچم روی Windows Volume Shadow (VSS) استفاده نکنید.
به دلایلی نامعلوم، فایل‌ها در یک VSS گاهی بین فهرست پوشه (جایی که مقدار اولیه stat در Windows از آن می‌آید) و زمانی که stat مستقیماً روی آن‌ها فراخوانی می‌شود، اندازه‌های متفاوتی نشان می‌دهند.
سایر ابزارهای کپی همیشه از مقدار مستقیم stat استفاده می‌کنند و تنظیم این پرچم این سازوکار را غیرفعال خواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_check_updated
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_NO_CHECK_UPDATED
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --one-file-system / -x
.PP
عدم عبور از مرزهای فایل‌سیستم (فقط unix/macOS).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: one_file_system
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_ONE_FILE_SYSTEM
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --local-case-sensitive
.PP
فایل‌سیستم را وادار می‌کند تا خود را حساس به بزرگی و کوچکی حروف گزارش دهد.
.PP
به‌طور معمول، backend محلی در Windows/macOS خود را غیرحساس به بزرگی و کوچکی حروف، و برای سایر سیستم‌ها حساس به بزرگی و کوچکی حروف معرفی می‌کند.
از این پرچم برای لغو انتخاب پیش‌فرض استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: case_sensitive
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_CASE_SENSITIVE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --local-case-insensitive
.PP
فایل‌سیستم را وادار می‌کند تا خود را غیرحساس به بزرگی و کوچکی حروف گزارش دهد.
.PP
به‌طور معمول، backend محلی در Windows/macOS خود را غیرحساس به بزرگی و کوچکی حروف، و برای سایر سیستم‌ها حساس به بزرگی و کوچکی حروف معرفی می‌کند.
از این پرچم برای لغو انتخاب پیش‌فرض استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: case_insensitive
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_CASE_INSENSITIVE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --local-no-clone
.PP
غیرفعال‌سازی کلونینگ reflink برای رونوشت‌های سمت سرور.
.PP
به‌طور معمول، برای انتقال‌های محلی به محلی، rclone در صورت امکان فایل را \[dq]کلون\[dq] می‌کند و تنها در صورتی که کلون‌سازی پشتیبانی نشود، به \[dq]کپی کردن\[dq] رجوع می‌کند.
.PP
کلون‌سازی یک رونوشت سطحی (یا \[dq]reflink\[dq]) ایجاد می‌کند که در ابتدا بلوک‌ها را با فایل اصلی به اشتراک می‌گذارد.
برخلاف یک \[dq]hardlink\[dq]، این دو فایل مستقل هستند و در صورت تغییرات بعدی، هیچ‌کدام بر دیگری تأثیر نخواهد گذاشت.
.PP
کلون‌سازی معمولاً نسبت به کپی کردن ارجحیت دارد، زیرا بسیار سریع‌تر است و به‌طور پیش‌فرض داده‌های تکراری در آن حذف می‌شود (یعنی داشتن دو فایل یکسان، فضای ذخیره‌سازی بیشتری نسبت به داشتن تنها یکی مصرف نمی‌کند).
با این حال، برای مواردی که افزونگی داده‌ها ترجیح داده می‌شود، می‌توان از --local-no-clone برای غیرفعال کردن کلون‌سازی و اجبار رونوشت‌های \[dq]عمیق\[dq] استفاده کرد.
.PP
در حال حاضر، کلون‌سازی تنها هنگام استفاده از APFS در macOS پشتیبانی می‌شود (ممکن است در آینده پشتیبانی از سایر پلتفرم‌ها اضافه شود).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_clone
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_NO_CLONE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --local-no-preallocate
.PP
غیرفعال‌سازی تخصیص از پیش فضای دیسک برای فایل‌های منتقل‌شده.
.PP
تخصیص از پیش فضای دیسک به جلوگیری از تکه‌تکه‌شدن (fragmentation) سیستم‌فایل کمک می‌کند.
با این حال، برخی از لایه‌های سیستم‌فایل مجازی (مانند Google Drive File Stream)
ممکن است به اشتباه اندازه واقعی فایل را برابر با فضای از پیش تخصیص‌یافته تنظیم کنند
که باعث شکست در بررسی‌های checksum و اندازه فایل می‌شود.
از این پرچم برای غیرفعال کردن تخصیص از پیش استفاده کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_preallocate
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_NO_PREALLOCATE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --local-no-sparse
.PP
غیرفعال‌سازی فایل‌های پراکنده (sparse files) برای دریافت‌های چندرشته‌ای.
.PP
در سیستم‌عامل‌های Windows، برنامه rclone هنگام انجام دریافت‌های چندرشته‌ای فایل‌های
پراکنده ایجاد می‌کند.
این کار از مکث‌های طولانی در فایل‌های بزرگ که در آن سیستم‌عامل فایل را با صفر پر می‌کند،
جلوگیری می‌نماید.
با این حال ممکن است فایل‌های پراکنده نامطلوب باشند زیرا باعث تکه‌تکه‌شدن دیسک می‌شوند
و کار با آن‌ها می‌تواند کُند باشد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_sparse
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_NO_SPARSE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --local-no-set-modtime
.PP
غیرفعال‌سازی تنظیم modtime.
.PP
به طور معمول rclone زمان تغییر فایل‌ها را پس از اتمام بارگذاری آن‌ها به‌روزرسانی
می‌کند.
این امر می‌تواند در سیستم‌عامل‌های Linux هنگامی که کاربری که rclone تحت آن اجرا می‌شود
مالک فایل بارگذاری‌شده نباشد، مانند زمان کپی در یک اتصال CIFS متعلق به کاربری دیگر،
باعث بروز مشکلات دسترسی شود.
اگر این گزینه فعال باشد، rclone پس از کپی کردن فایل دیگر modtime را به‌روزرسانی
نخواهد کرد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: no_set_modtime
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_NO_SET_MODTIME
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --local-metadata-restore-special-bits
.PP
بازیابی بیت‌های setuid، setgid و sticky از فراداده (metadata).
.PP
هنگام بازیابی فراداده با --metadata، برنامه rclone مقدار \[dq]mode\[dq] را از مبدأ
اعمال می‌کند.
به طور پیش‌فرض rclone فقط بیت‌های مجوز را اعمال کرده و بیت‌های setuid، setgid و
sticky را حذف می‌کند.
.PP
مقدار \[dq]mode\[dq] از ریموت مبدأ می‌آید که ممکن است قابل اعتماد نباشد.
بازیابی بیت setuid یا setgid بر روی محتوای تازه نوشته‌شده و تحت کنترل مبدأ می‌تواند
یک باینری setuid ایجاد کند، که این امر به‌ویژه هنگام بازیابی از یک منبع نامعتبر در
حین اجرا به عنوان کاربر ریشه (root) خطرناک است.
به همین دلیل این بیت‌ها به‌طور پیش‌فرض بازیابی نمی‌شوند.
.PP
اگر به منبع اعتماد دارید و می‌خواهید بیت‌های setuid، setgid و sticky بازیابی شوند \-
برای مثال هنگام بازیابی نسخه پشتیبان سیستمی که توسط rclone ایجاد شده است \- این پرچم
را فعال کنید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: metadata_restore_special_bits
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_METADATA_RESTORE_SPECIAL_BITS
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false.SS --local-fatal-if-no-space
.PP
تبدیل خطاهای کمبود فضا به خطاهای مهلک در حین انتقال.
.PP
در صورت فعال بودن، بروز خطای ENOSPC در حین نوشتن، یک خطای مهلک برمی‌گرداند تا rclone به‌جای تلاش دوباره، عملیات را بی‌درنگ متوقف کند.
برای اسکریپت‌های پشتیبان‌گیری که هنگام پر شدن دیسک باید با اعلان خطا متوقف شوند و در حلقهٔ تلاش مجدد گیر نکنند، مفید است.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: fatal_if_no_space
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_FATAL_IF_NO_SPACE
.IP \[bu] 2
نوع: bool
.IP \[bu] 2
پیش‌فرض: false
.SS --local-time-type
.PP
مشخص کردن نوع زمان بازگردانده‌شده.
.PP
به‌طور معمول rclone تمام عملیات را بر اساس mtime یا همان زمان تغییر محتوا (Modification time) انجام می‌دهد.
.PP
اگر این پرچم را تنظیم کنید، rclone مقدار زمان اصلاح را برابر با مقداری که اینجا تعیین کرده‌اید بازمی‌گرداند.
بنابراین اگر از \[dq]rclone lsl --local-time-type ctime\[dq] استفاده کنید، ctimeها را در فهرست خروجی خواهید دید.
.PP
اگر سیستم‌عامل از بازگرداندن time_type مشخص‌شده پشتیبانی نکند، rclone آن را بی‌سروصدا با زمان تغییر محتوا که در همهٔ سیستم‌های عامل پشتیبانی می‌شود جایگزین می‌کند.
.IP \[bu] 2
مقدار mtime در همهٔ سیستم‌های عامل پشتیبانی می‌شود
.IP \[bu] 2
مقدار atime در همهٔ سیستم‌های عامل به جز plan9 و js پشتیبانی می‌شود
.IP \[bu] 2
مقدار btime فقط در سیستم‌های عامل Windows، macOS، freebsd و netbsd پشتیبانی می‌شود
.IP \[bu] 2
مقدار ctime در همهٔ سیستم‌های عامل به جز Windows، plan9 و js پشتیبانی می‌شود
.PP
توجه داشته باشید که تنظیم زمان همچنان زمان تغییر محتوا (modified time) را تغییر خواهد داد، بنابراین این گزینه فقط برای خواندن کاربرد دارد.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: time_type
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_TIME_TYPE
.IP \[bu] 2
نوع: mtime|atime|btime|ctime
.IP \[bu] 2
پیش‌فرض: mtime
.IP \[bu] 2
مثال‌ها:
.RS 2
.IP \[bu] 2
\[dq]mtime\[dq]
.RS 2
.IP \[bu] 2
زمان آخرین تغییر محتوا.
.RE
.IP \[bu] 2
\[dq]atime\[dq]
.RS 2
.IP \[bu] 2
زمان آخرین دسترسی.
.RE
.IP \[bu] 2
\[dq]btime\[dq]
.RS 2
.IP \[bu] 2
زمان ایجاد.
.RE
.IP \[bu] 2
\[dq]ctime\[dq]
.RS 2
.IP \[bu] 2
زمان آخرین تغییر وضعیت.
.RE
.RE.SS --local-hashes
.PP
فهرست جداشده با کاما از انواع چکسام‌های (checksum) پشتیبانی‌شده.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: hashes
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_HASHES
.IP \[bu] 2
نوع: CommaSepList
.IP \[bu] 2
پیش‌فرض:
.SS --local-encoding
.PP
کدگذاری مربوط به بک‌اند (backend).
.PP
برای اطلاعات بیشتر، بخش encoding را در
overview (https://rclone.org/overview#encoding) ببینید.
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: encoding
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_ENCODING
.IP \[bu] 2
نوع: Encoding
.IP \[bu] 2
پیش‌فرض: Slash,Dot
.SS --local-description
.PP
توضیحات ریموت (remote).
.PP
ویژگی‌ها:
.IP \[bu] 2
پیکربندی: description
.IP \[bu] 2
متغیر محیطی: RCLONE_LOCAL_DESCRIPTION
.IP \[bu] 2
نوع: string
.IP \[bu] 2
الزامی: false
.SS "متاداده (Metadata)"
.PP
بسته به این‌که کدام سیستم‌عامل در حال استفاده است، بک‌اند محلی ممکن است فقط بخشی
از متاداده‌های سیستم را بازگرداند.
تنظیم متاداده سیستم روی همه سیستم‌عامل‌ها پشتیبانی می‌شود، اما تنظیم متاداده
کاربر فقط در linux، freebsd، netbsd، macOS و Solaris پشتیبانی می‌گردد.
این قابلیت هنوز روی Windows پشتیبانی \f[B]نمی‌شود\f[R] (ببینید:
pkg/attrs#47 (https://github.com/pkg/xattr/issues/47)).
.PP
متاداده کاربر به‌صورت مشخصه‌های توسعه‌یافته (که ممکن است توسط همه
سیستم‌های فایل پشتیبانی نشوند) تحت پیشوند \[dq]user.*\[dq] ذخیره می‌شود.
.PP
متاداده روی فایل‌ها و دایرکتوری‌ها پشتیبانی می‌شود.
.PP
هنگام بازیابی متاداده با \f[V]--metadata\f[R]، رکلون (rclone) مقادیر
\[dq]mode\[dq]، \[dq]uid\[dq] و \[dq]gid\[dq] را از مبدأ اعمال می‌کند.
این مقادیر از ریموت مبدأ می‌آیند که ممکن است قابل اعتماد نباشد؛ بنابراین بازیابی
متاداده به‌عنوان ریشه (root) از یک منبع غیرقابل اعتماد می‌تواند مالکیت فایل را تغییر دهد و
توصیه نمی‌شود.
بیت‌های setuid، setgid و sticky به‌طور پیش‌فرض بازیابی نمی‌شوند \- پرچم
\f[V]--local-metadata-restore-special-bits\f[R] را ببینید.
.PP
در ادامه موارد ممکن متاداده سیستم برای بک‌اند محلی آورده شده است.
.PP
.TS
tab(@);
lw(11.1n) lw(11.1n) lw(11.1n) lw(16.6n) lw(20.3n).
T{
نام
T}@T{
راهنما
T}@T{
نوع
T}@T{
مثال
T}@T{
فقط‌خواندنی
T}
_
T{
atime
T}@T{
زمان آخرین دسترسی
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}@T{
N
T}
T{
btime
T}@T{
زمان ایجاد (تولد) فایل
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}@T{
N
T}
T{
gid
T}@T{
شناسه گروهی مالک
T}@T{
عدد ده‌دهی
T}@T{
500
T}@T{
N
T}
T{
mode
T}@T{
نوع و حالت فایل
T}@T{
هشت‌هشتی، سبک یونیکس
T}@T{
0100664
T}@T{
N
T}
T{
mtime
T}@T{
زمان آخرین تغییر
T}@T{
RFC 3339
T}@T{
2006-01-02T15:04:05.999999999Z07:00
T}@T{
N
T}
T{
rdev
T}@T{
شناسه دستگاه (در صورت فایل ویژه)
T}@T{
هگزادسیمال
T}@T{
1abc
T}@T{
N
T}
T{
uid
T}@T{
شناسه کاربری مالک
T}@T{
عدد ده‌دهی
T}@T{
500
T}@T{
N
T}
.TE
.PP
برای اطلاعات بیشتر، مستندات metadata (https://rclone.org/docs#metadata) را ببینید..SS دستورات Backend
.PP
در اینجا دستورات مختص backend محلی (local) آورده شده است.
.PP
اجرای آن‌ها با:
.IP
.nf
\f[C]
rclone backend COMMAND remote:
\f[R]
.fi
.PP
راهنمای زیر توضیح خواهد داد که هر دستور چه آرگومان‌هایی می‌گیرد.
.PP
برای اطلاعات بیشتر درباره نحوه ارسال گزینه‌ها و آرگومان‌ها، دستور backend (https://rclone.org/commands/rclone_backend) را ببینید.
.PP
این دستورات را می‌توان با استفاده از دستور rc به نشانی backend/command (https://rclone.org/rc/#backend-command) روی یک backend در حال اجرا فراخوانی کرد.
.SS noop
.PP
یک عملیات پوچ (null operation) برای آزمایش دستورات backend.
.IP
.nf
\f[C]
rclone backend noop remote: [options] [<arguments>+]
\f[R]
.fi
.PP
این یک دستور آزمایشی است که گزینه‌هایی برای تغییر دادن خروجی دارد.
.PP
گزینه‌ها:
.IP \[bu] 2
\[dq]echo\[dq]: بازتاب دادن آرگومان‌های ورودی (Echo).
.IP \[bu] 2
\[dq]error\[dq]: بازگرداندن یک خطا بر اساس مقدار گزینه.
.SH "گزارش تغییرات (CHANGELOG)"
.SS v1.75.1 \- 2026-09-04
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.75.0...v1.75.1)
.IP \[bu] 2
امنیت
.RS 2
.IP \[bu] 2
archive
.RS 2
.IP \[bu] 2
رفع پیمایش مسیر zip slip در فایل‌های zip غیرقابل‌اعتماد GHSA-66hp-wgxq-6f5q CVE-PENDING (Nick Craig-Wood)
.IP \[bu] 2
پنهان‌سازی هر مدخل بایگانی که از دایرکتوری در حال فهرست‌بندی خارج می‌شود GHSA-66hp-wgxq-6f5q (Nick Craig-Wood)
.IP \[bu] 2
رد نام‌های مدخل ناامن هنگام mount کردن ایمیج‌های squashfs شناسه GHSA-66hp-wgxq-6f5q (Nick Craig-Wood)
.IP \[bu] 2
رفع تطابق ریشه زیردایرکتوری zip با دایرکتوری‌های هم‌سطح GHSA-66hp-wgxq-6f5q (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل مدخل zip با نام \[dq].\[dq] که سایر فایل‌ها را پنهان می‌کرد GHSA-66hp-wgxq-6f5q (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای \[dq]directory not found\[dq] برای مسیرهای بایگانی حاوی \[dq]./\[dq] یا \[dq]//\[dq] شناسه GHSA-66hp-wgxq-6f5q (Nick Craig-Wood)
.RE
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
رفع چندین CVE با ارتقا به go1.26.6 (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
CVE-2026-56860: net/url: پیچیدگی درجه دوم در resolvePath
.IP \[bu] 2
CVE-2026-56858: html/template: ردیابی زمینه عبارت منظم (regexp) در JavaScript
.IP \[bu] 2
CVE-2026-56862: crypto/tls: محدود کردن پیام‌های دست‌تکانی پذیرفته‌شده پس از دست‌تکانی (post-handshake)
.IP \[bu] 2
CVE-2026-56853: net/http: اعمال ReadHeaderTimeout روی بررسی رمزگذاری‌نشده HTTP/2
.IP \[bu] 2
CVE-2026-56859: encoding/xml: محافظ عمق بازگشت هنگام دیکود
.IP \[bu] 2
CVE-2026-33818: encoding/asn1: اعمال حداکثر عمق بازگشت
.IP \[bu] 2
CVE-2026-46600: net: رخداد خطای وحشت (panic) هنگام تجزیه رکورد منبع نامعتبر SVCB یا HTTPS در dnsmessage
.IP \[bu] 2
CVE-2026-39821: net/http: رد برچسب‌های کدگذاری‌شده Punycode با کاراکترهای صرفاً ASCII در idna
.RE
.IP \[bu] 2
به‌روزرسانی golang.org/x/crypto به v0.56.0 جهت رفع چندین CVE (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
CVE-2026-56854: ssh: گزینه حیاتی source-address برای فراخوانی‌های احراز هویت غیرکلید عمومی اعمال نمی‌شد
.IP \[bu] 2
CVE-2026-78662: ssh: یک همتای مخرب می‌توانست درخواست‌های ورودی کانال نامشخص را اشباع کرده و اتصال را دچار بن‌بست کند
.IP \[bu] 2
CVE-2026-56855: ssh: یک همتای مخرب می‌توانست پیام‌های ساختگی روی یک کانال برقرارشده ارسال کرده و اتصال را دچار بن‌بست کند
.RE
.IP \[bu] 2
به‌روزرسانی golang.org/x/image به v0.45.0 جهت رفع CVE-2026-46603 (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
CVE-2026-46603: تخصیص بیش از حد حافظه هنگام رمزگشایی VP8L
.RE
.RE
.IP \[bu] 2
fs: محدود کردن مدخل‌های فهرست دایرکتوری که از ریشه خارج می‌شوند GHSA-3vxh-3pcx-9m8q GHSA-38xv-hf3p-h7mq CVE-PENDING (Nick Craig-Wood)
.IP \[bu] 2
fshttp: عدم ارسال مقادیر \f[V]--header\f[R] به سایر میزبان‌ها در زمان تغییر مسیر (redirect) شناسه GHSA-486v-q2wf-fp2r CVE-PENDING (Nick Craig-Wood)
.IP \[bu] 2
http: عدم نشت هدرهای پیکربندی‌شده به سایر میزبان‌ها یا در بستر متن ساده در زمان redirect شناسه GHSA-486v-q2wf-fp2r CVE-PENDING (Nick Craig-Wood)
.IP \[bu] 2
lib/rest: بررسی تنزل درجه HTTPS نسبت به درخواست اصلی هنگام redirect شناسه GHSA-486v-q2wf-fp2r CVE-PENDING (Nick Craig-Wood)
.IP \[bu] 2
local
.RS 2
.IP \[bu] 2
رفع خروج متادیتای دایرکتوری از ریشه از طریق یک پیوند نمادین (symlink) تعبیه‌شده GHSA-f8g7-2xjc-7mfh CVE-PENDING (Nick Craig-Wood)
.IP \[bu] 2
رفع خروج btime از ریشه از طریق یک پیوند نمادین تعبیه‌شده GHSA-f8g7-2xjc-7mfh CVE-PENDING (Nick Craig-Wood)
.IP \[bu] 2
رفع panic در درخواست Range فراتر از انتهای یک symlink شناسه GHSA-p6m2-r3w9-mpxw CVE-PENDING (Nick Craig-Wood)
.RE
.IP \[bu] 2
serve docker
.RS 2
.IP \[bu] 2
رد نام‌های volume که از دایرکتوری پایه خارج می‌شوند GHSA-p6vx-hf7p-98j6 (Nick Craig-Wood)
.IP \[bu] 2
رد نام‌های volume که به خود دایرکتوری پایه منتهی می‌شوند GHSA-p6vx-hf7p-98j6 (Nick Craig-Wood)
.IP \[bu] 2
اشتقاق مجدد نقطه اتصال (mountpoint) حجم بر اساس نام هنگام بازیابی وضعیت GHSA-p6vx-hf7p-98j6 (Nick Craig-Wood)
.RE
.IP \[bu] 2
serve ftp: رفع اشتراک‌گذاری اعتبارنامه‌های نشست‌های auth-proxy بر اساس نام کاربری GHSA-c476-6w5q-jw77 CVE-PENDING (Nick Craig-Wood)
.IP \[bu] 2
serve s3
.RS 2
.IP \[bu] 2
رفع اتمام حافظه ناشی از اندازه قطعه multipart اعلام‌شده توسط کلاینت GHSA-2p48-j3qc-rx9f CVE-PENDING (Nick Craig-Wood)
.IP \[bu] 2
رد اندازه‌های نامعتبر قطعه multipart در بافر مرتب‌سازی مجدد GHSA-2p48-j3qc-rx9f (Nick Craig-Wood)
.IP \[bu] 2
رفع پذیرش هر درخواست امضا شده با یک کلید محرمانه خالی توسط auth proxy شناسه GHSA-xwwr-4h3p-r22c CVE-PENDING (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
\f[B]نکته:\f[R] پروتکل auth proxy برای \f[V]serve s3\f[R] تغییر کرده است \- برنامه پراکسی اکنون شناسه access key را با نام \f[V]user\f[R] دریافت می‌کند و باید کلید محرمانه را به عنوان \f[V]_secret_access_key\f[R] بازگرداند
.RE
.IP \[bu] 2
رفع پذیرش اعتبارنامه‌های \f[V]--auth-key\f[R] سایر سرورها توسط هر سرور (Nick Craig-Wood)
.IP \[bu] 2
رفع ثبت گزارش گمراه‌کننده دسترسی ناشناس هنگام استفاده از auth proxy از طریق rc شناسه GHSA-p569-5gjg-9cmj CVE-PENDING (Nick Craig-Wood)
.RE.IP \[bu] 2
serve sftp: رفع نادیده گرفته‌شدن بی‌صدای auth proxy پیکربندی‌شده از طریق rc
GHSA-p569-5gjg-9cmj CVE-PENDING (Nick Craig-Wood)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
رفع نشت حافظه در rcd با اجرای طولانی‌مدت (nielash)
.IP \[bu] 2
رفع نشت حافظه از گروه‌های stats در rcd با اجرای طولانی‌مدت (nielash)
.IP \[bu] 2
رفع سرریز burst در bwlimit (Rayan Salhab)
.RE
.IP \[bu] 2
bisync
.RS 2
.IP \[bu] 2
رفع نشت حافظه هنگام اجرا از طریق rc (nielash)
.IP \[bu] 2
رفع ثبت‌شدن انتقال‌های ناموفق فایل‌های خالی به‌عنوان همگام‌سازی‌شده (Nick
Craig-Wood)
.RE
.IP \[bu] 2
build: تعیین go1.26 به‌عنوان حداقل نسخهٔ مورد نیاز بر اساس نیازمندی
golang.org/x/crypto v0.56.0 (Nick Craig-Wood)
.IP \[bu] 2
config: سانسور مقادیر پیکربندی متغیرهای محیطی در گزارش‌ها (Pastalikek65)
.IP \[bu] 2
اصلاحات مستندات (Anton Karpov, CAOShurong, Dean Chen, Nick Craig-Wood,
Recoordinate, Rodrigo Rodrigues, Shantanav Mukherjee, shaurya)
.IP \[bu] 2
lib/batcher: جلوگیری از شرایط رقابتی میان commitها و خاموش‌شدن برنامه (Loi Nguyen)
.IP \[bu] 2
lib/transform: رفع panic در \f[V]truncate_keep_extension\f[R] (VXNCXNX)
.IP \[bu] 2
multipart: رفع ذخیره شدن اشیاء ناقص در آپلودهای تکه‌ای (chunked) هنگام پایان زودهنگام منبع (Nick Craig-Wood)
.IP \[bu] 2
operations: رفع ناقص شدن بی‌صدای آپلودهای جریانی هنگام پایان زودهنگام منبع (Nick Craig-Wood)
.IP \[bu] 2
serve
.RS 2
.IP \[bu] 2
رفع نشت نمونه‌های VFS هنگام شکست در راه‌اندازی یا خاموش شدن سرور (Hakan
İSMAİL)
.IP \[bu] 2
ارسال آدرس IP کلاینت به auth proxy (am-at-enrollvb)
.RE
.IP \[bu] 2
serve http: جلوگیری از اسکرول به بالای صفحه هنگام بارگذاری مجدد (Sune Mølgaard)
.IP \[bu] 2
serve nfs: رفع خطای EIO هنگام ایجاد پیوندهای نمادین با \f[V]--vfs-links\f[R]
(SillyZir)
.IP \[bu] 2
serve s3
.RS 2
.IP \[bu] 2
رفع حذف یا معیوب‌شدن شیء در کلید مربوطه در اثر آپلودهای ناموفق (Nick
Craig-Wood)
.IP \[bu] 2
رفع خرابی (crash) هنگام لغو یک multipart upload در حین آپلود یکی از بخش‌ها
(Nick Craig-Wood)
.IP \[bu] 2
رفع تنظیم نشدن modtime زمانی که فقط فرادادهٔ mtime در درخواست PUT ارائه می‌شود
(Nick Craig-Wood)
.IP \[bu] 2
انجام تمام multipart uploadها از طریق VFS به‌منظور رعایت
\f[V]--bwlimit\f[R] و نمایش در آمارها (Nick Craig-Wood)
.IP \[bu] 2
رزرو پیشوند \f[V].rclone_temp_\f[R] برای اشیاء موقت (Nick
Craig-Wood)
.IP \[bu] 2
پاک‌سازی multipart uploadهای رهاشده پس از \f[V]--multipart-expiry\f[R]
(Nick Craig-Wood)
.RE
.IP \[bu] 2
vfscache
.RS 2
.IP \[bu] 2
رفع بن‌بست (deadlock) خواننده هنگام کاهش اندازهٔ مورد به کمتر از آفست خواندن
(Dave)
.IP \[bu] 2
رفع رشد نامحدود پیام گزارش هنگام رخداد مکرر خطاهای نوشتن (Vijay
Misal)
.RE
.IP \[bu] 2
walk: توقف پیمایش دایرکتوری در صورت لغو شدن context (Rahman
Yilmaz)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
همگام‌سازی به‌روزرسانی‌های poll با خاموش شدن برنامه (Loi Nguyen)
.IP \[bu] 2
قطعی‌سازی چرخهٔ حیات خاموش شدن poll (Loi Nguyen)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
رفع عدم تطابق هش با \f[V]no_data_encryption\f[R] در بک‌اندهایی که
هش‌های آپلود را بررسی می‌کنند (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل نام دایرکتوری‌هایی که شبیه نام فایل‌های نسخه‌بندی‌شده هستند (TowyTowy)
.IP \[bu] 2
هشدار دربارهٔ دایرکتوری‌هایی با نام‌های رمزنگاری‌شدهٔ قدیمی و مشابه فایل‌های نسخه‌بندی‌شده (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
رفع مشکل احراز هویت مبدا در کپی سمت سرور Entra ID (Edward Klesel)
.IP \[bu] 2
رفع خطاهای کاذب خرابی vfs cache هنگام خواندن‌های تکه‌ای (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Azurefiles
.RS 2
.IP \[bu] 2
رفع ایجاد فایل‌های پرشده با صفر هنگام پایان زودهنگام منبع (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
رفع آپلود موفق فایل‌های ناقص هنگام پایان زودهنگام منبع
(Rohit Behera)
.RE
.IP \[bu] 2
Compress
.RS 2
.IP \[bu] 2
رفع ایجاد اشیاء معیوب هنگام پایان زودهنگام منبع (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
فهرست نکردن فایل‌های سطل بازیافت هنگام انتقال دایرکتوری به سطل بازیافت
(alliasgher)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
حفظ مسیرهای خروجی Paper هنگام lookup (Loi Nguyen)
.IP \[bu] 2
رفع متوقف نشدن درخواست‌های در حال انجام هنگام لغو شدن context (مانند
محدودیت \f[V]--max-duration\f[R]) (debaditya)
.IP \[bu] 2
رفع پایان نیافتن آپلودهای تکه‌ای (chunked) مربوط به فایل‌های ناقص (Nick Craig-Wood)
.IP \[bu] 2
تلاش مجدد نکردن برای درخواست‌های آپلود تکه‌ای در صورت لغو شدن آپلود (Nick Craig-Wood)
.IP \[bu] 2
رمزگشایی نام فایل‌های به‌اشتراک‌گذاشته‌شدهٔ دریافتی (Sanjay Kanth A)
.IP \[bu] 2
رفع مشکل ChangeNotify در صورت تفاوت در بزرگی و کوچکی حروف میان ریشه و Dropbox
(Loi Nguyen)
.RE
.IP \[bu] 2
Filelu
.RS 2
.IP \[bu] 2
رفع آپلود موفق فایل‌های ناقص هنگام پایان زودهنگام منبع (Nick Craig-Wood)
.IP \[bu] 2
رفع مسیر ریشهٔ تکراری در زمان ایجاد پوشه‌های multipart (kingston125)
.RE.IP \[bu] 2
Huaweidrive
.RS 2
.IP \[bu] 2
رفع مشکل بارگذاری موفقیت‌آمیز فایل‌های ناقص هنگامی که منبع پیش از موعد
به پایان می‌رسد (Rohit Behera)
.RE
.IP \[bu] 2
Iclouddrive
.RS 2
.IP \[bu] 2
رفع شکست بارگذاری‌ها در کانتینر برنامه با خطای 412 (Christian De Santis)
.RE
.IP \[bu] 2
Internetarchive
.RS 2
.IP \[bu] 2
رفع مشکل ایجاد فایل‌های خراب هنگامی که منبع پیش از موعد به پایان می‌رسد (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Internxt
.RS 2
.IP \[bu] 2
ماندگار کردن توکن چرخش‌یافتهٔ بازگردانده‌شده توسط فراخوانی user info (0rangeSeaW0lf)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
رفع خطای 403 Forbidden در پیکربندی onedrive شخصی (machsix)
.IP \[bu] 2
بازگشت به وارد کردن دستی شناسهٔ درایو در صورت عدم موفقیت در فهرست‌کردن درایو (SillyZir)
.IP \[bu] 2
عدم تلاش مجدد برای تکهٔ بارگذاری چندبخشی در صورت دریافت 404 (نشست بارگذاری پیدا نشد)
(water)
.RE
.IP \[bu] 2
Overview
.RS 2
.IP \[bu] 2
رفع خطای \[dq]internal error: no overview data found\[dq] در معماری‌های
۳۲ بیتی (Nick Craig-Wood)
.RE
.IP \[bu] 2
Pikpak
.RS 2
.IP \[bu] 2
رفع مشکل ایجاد فایل‌های ناقص هنگامی که منبع پیش از موعد به پایان می‌رسد (Nick
Craig-Wood)
.IP \[bu] 2
رفع گزارش موفقیت برای بارگذاری‌های تک‌بخشی ناقص هنگامی که منبع پیش از موعد
به پایان می‌رسد (Nick Craig-Wood)
.RE
.IP \[bu] 2
Protondrive
.RS 2
.IP \[bu] 2
رفع خوانده نشدن فایل‌های بارگذاری‌شده با v1.75.0 در برنامه‌های Proton
(Nick Craig-Wood)
.IP \[bu] 2
رفع بارگذاری‌های خراب پس از خطای تلاش مجدد برای بارگذاری (Nick Craig-Wood)
.RE
.IP \[bu] 2
Quatrix
.RS 2
.IP \[bu] 2
رفع مشکل تلاش‌های مجدد در بارگذاری تکه‌ها و رفع نشت حافظه (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
به‌روزرسانی پایانه‌های Mega (Nick Craig-Wood)
.IP \[bu] 2
تلقی موفقیت UploadPart بدون ETag به‌عنوان خطای قابل تلاش مجدد (CAOShurong)
.IP \[bu] 2
رفع شکست رونوشت سمت سرور با \f[V]--s3-no-head-object\f[R] (Anatoly
Tarnavsky)
.RE
.IP \[bu] 2
Sia
.RS 2
.IP \[bu] 2
رفع مشکل ایجاد فایل‌های خراب هنگامی که منبع پیش از موعد به پایان می‌رسد (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
استفادهٔ مجدد از اتصال بارگذاری برای SetModTime (alliasgher)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
رفع شکست SetModTime و نبود هش‌ها در Nextcloud (Nick Craig-Wood)
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
رفع مشکل بارگذاری موفقیت‌آمیز فایل‌های ناقص هنگامی که منبع پیش از موعد
به پایان می‌رسد (Rohit Behera)
.RE.SS v1.75.0 - 2026-07-31
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.74.0...v1.75.0)
.IP \[bu] 2
ارائه‌دهندگان جدید S3
.RS 2
.IP \[bu] 2
Scality (https://rclone.org/s3/#scality) (RING / ARTESCA)
.IP \[bu] 2
Zero Services (https://rclone.org/s3/#zero-z3) (ZERO-Z3)
.RE
.IP \[bu] 2
امنیت
.RS 2
.IP \[bu] 2
archive: عدم فروپاشی هنگام مواجهه با ایمیج‌های نامعتبر squashfs
GHSA-6jcg-q3wp-x2f4 (Nick Craig-Wood)
.IP \[bu] 2
ftp: رفع مشکل تزریق دستور ftp زمانی که کدگذاری شامل CRLF نباشد
GHSA-8c48-q9wj-3w37 CVE-2026-71311 (Nick Craig-Wood)
.IP \[bu] 2
lib/http: استفاده از TLS روی تمامی شنونده‌های \f[V]--addr\f[R] زمانی که
\f[V]--cert\f[R] و \f[V]--key\f[R] تنظیم شده باشند GHSA-mfvx-7rcj-9m5g (Nick
Craig-Wood)
.IP \[bu] 2
lib/proxy: رفع مشکل هدرهای نامحدود HTTP CONNECT که موجب رخ دادن OOM می‌شدند
GHSA-xhf4-832v-7xcr CVE-2026-71310 (Nick Craig-Wood)
.IP \[bu] 2
local: جلوگیری از خروج نام فایل‌های مبدأ از دایرکتوری مقصد
GHSA-7p4m-qxvv-g567 CVE-2026-71313 (Nick Craig-Wood)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
عدم افشای گرداننده‌های دیباگ pprof روی سرور احراز هویت‌نشده
GHSA-mfvx-7rcj-9m5g CVE-PENDING (Nick Craig-Wood)
.IP \[bu] 2
الزام به احراز هویت جهت فهرست کردن ریموت‌ها با \f[V]--rc-serve\f[R]
GHSA-mfvx-7rcj-9m5g (Nick Craig-Wood)
.IP \[bu] 2
رفع نشت ردپای پشته هنگام بروز وحشت (panic) GHSA-gwfq-86j8-7qhv (Nick Craig-Wood)
.RE
.IP \[bu] 2
s3
.RS 2
.IP \[bu] 2
رفع نشت گواهی‌های اعتباری در تغییر مسیر، رد کردن تغییر مسیرهای HTTPS->HTTP و حذف اسرار
GHSA-8mxv-9xhp-86h4 (Nick Craig-Wood)
.IP \[bu] 2
حذف توکن نشست S3 Express در تغییر مسیرهای بین چند میزبان
GHSA-8mxv-9xhp-86h4 (Nick Craig-Wood)
.RE
.IP \[bu] 2
serve ftp: استفاده از مقایسه زمان‌ثابت (constant time) برای بررسی گذرواژه
GHSA-mfvx-7rcj-9m5g (Nick Craig-Wood)
.IP \[bu] 2
serve restic: رفع پیمایش مسیر (path traversal) به خارج از دایرکتوری ارائه‌شده
GHSA-45pq-889g-fcgh CVE-2026-71309 (Nick Craig-Wood)
.IP \[bu] 2
serve sftp: عدم فروپاشی کل سرور هنگام دریافت درخواست نامعتبر
GHSA-6jcg-q3wp-x2f4 (Nick Craig-Wood)
.IP \[bu] 2
sftp: رفع مشکل تزریق دستور از طریق نام‌فایل‌های دستکاری‌شده در ریموت‌های PowerShell
GHSA-2m8m-jhrm-w6j2 CVE-2026-71312 (Nick Craig-Wood)
.IP \[bu] 2
vfs: عدم فروپاشی فرایند در صورت بروز وحشت (panic) در پشتیبان روی یک goroutine
پس‌زمینه GHSA-6jcg-q3wp-x2f4 (Nick Craig-Wood)
.IP \[bu] 2
webdav
.RS 2
.IP \[bu] 2
رفع مشکل نشت اطلاعات اعتباری در تغییر مسیرهای HTTPS به HTTP GHSA-h4mf-4v27-hggj
(Nick Craig-Wood)
.IP \[bu] 2
Tus: رفع فروپاشی احتمالی ناشی از اشاره‌گر تهی (nil pointer) GHSA-3x6r-wxxg-53vv (Nick
Craig-Wood)
.RE
.IP \[bu] 2
به‌روزرسانی \f[V]google.golang.org/grpc\f[R] برای رفع چندین مشکل امنیتی
(Nick Craig-Wood)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
build: به‌روزرسانی تمام وابستگی‌ها (Nick Craig-Wood)
.IP \[bu] 2
config
.RS 2
.IP \[bu] 2
افزودن دستور \f[V]config unset\f[R] برای حذف گزینه‌ها از یک ریموت (Nick
Craig-Wood)
.IP \[bu] 2
افزودن tier به راهنمای گام‌به‌گام پیکربندی (dougal)
.RE
.IP \[bu] 2
docker serve
.RS 2
.IP \[bu] 2
افزودن مهلت زمانی به بازیابی حجم تا ریموت‌های کند مانع راه‌اندازی نشوند
(Nick Craig-Wood)
.IP \[bu] 2
بازیابی هم‌روند حجم‌ها تا یک ریموت کُند مانع عملکرد سایرین نشود
(Nick Craig-Wood)
.IP \[bu] 2
همان‌توان (idempotent) کردن Create جهت جلوگیری از خطای \[dq]volume already exists\[dq] پس از راه‌اندازی مجدد
(Nick Craig-Wood)
.RE
.IP \[bu] 2
اصلاحات مستندات (blackflytech, dougal, Giridhar, KTibow, mathieulongtin, Nick
Craig-Wood, p1, Socialpranker, Søren Lindberg, yashanil98)
.IP \[bu] 2
filter
.RS 2
.IP \[bu] 2
پشتیبانی از جایگزین‌های تو در توی \f[V]{}\f[R] در فیلترهای glob (maximilize)
.IP \[bu] 2
افزودن \f[V]--files-from0\f[R] برای پشتیبانی از ورودی‌های جداشده با NUL (Gaurav)
.RE
.IP \[bu] 2
fserrors: تبدیل خطای \[dq]server sent GOAWAY\[dq] در http2 به یک خطای قابل تلاش مجدد
(phatlc)
.IP \[bu] 2
fshttp
.RS 2
.IP \[bu] 2
افزودن \f[V]--dump errors\f[R] برای ثبت اطلاعات فقط تراکنش‌های ناموفق HTTP (Nick
Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--dump trace\f[R] برای ثبت وقایع سطح اتصال از طریق httptrace
(Nick Craig-Wood)
.RE
.IP \[bu] 2
gui
.RS 2
.IP \[bu] 2
ارائه فایل‌های ایستا با فشرده‌سازی gzip/deflate (Leon Brocard)
.IP \[bu] 2
رعایت مقدار صریح \f[V]--rc-allow-origin\f[R] به جای استخراج همیشگی آن از آدرس bind
(Kyue)
.IP \[bu] 2
به‌روزرسانی نسخه تعبیه‌شده به 1.1.11 (Nick Craig-Wood)
.RE
.IP \[bu] 2
mount2: افزودن \f[V]--allow-idmap\f[R] برای اعلان FUSE_ALLOW_IDMAP
(Valerij Fredriksen)
.IP \[bu] 2
nfsmount: فراخوانی مستقیم mount_nfs در OpenBSD تا گزینه -T پذیرفته شود
(Socialpranker)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
پاسخ با کد 202 در صورت ارسال هدر \f[V]prefer-async\f[R] (FTCHD)
.IP \[bu] 2
افزودن \f[V]config/oauthstop\f[R] و \f[V]config/oauthstatus\f[R] برای
کنترل شنونده oauth (FTCHD)
.IP \[bu] 2
گنجاندن URL مجوزدهی OAuth در پاسخ \f[V]config/oauthstatus\f[R] در rc
(Hakan İSMAİL)
.IP \[bu] 2
امکان تنظیم گزینه‌های config و filter در rc به صورت پارامترهای مسطح (Hakan
İSMAİL)
.RE
.IP \[bu] 2
serve
.RS 2
.IP \[bu] 2
پشتیبانی از هدرهای سفارشی پاسخ http (kkocdko)
.IP \[bu] 2
به‌روزرسانی کنترل از راه دور serve برای پذیرش گزینه‌های تو در تو و همچنین مسطح
(Hakan İSMAİL)
.RE
.IP \[bu] 2
serve dlna: محدود کردن بدنه درخواست‌های SOAP (Acts1631)
.IP \[bu] 2
serve nfs
.RS 2
.IP \[bu] 2
امکان‌پذیر کردن اتصال (mount) زیرمسیرهای ریموت ارائه‌شده برای کلاینت‌های NFS (Nick
Craig-Wood).IP \[bu] 2
اعلان AUTH_UNIX تا کلاینت‌های NFS در *BSD بتوانند متصل (mount) شوند (Socialpranker)
.RE
.IP \[bu] 2
‏serve s3: ارسال جریانی بارگذاری‌های چندبخشی به بک‌اند به‌جای بافر کردن در حافظه (Nick Craig-Wood)
.IP \[bu] 2
serve sftp
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]statvfs\[at]openssh.com\f[R] جهت گزارش مصرف دیسک (Nick Craig-Wood)
.IP \[bu] 2
استفاده از atime درخواستی هنگام تنظیم زمان‌های فایل (Nick Craig-Wood)
.RE
.IP \[bu] 2
‏serve webdav: افزودن فشرده‌سازی gzip برای پاسخ‌های فشرده‌پذیر (Leon Brocard)
.IP \[bu] 2
‏serve http: افزودن پرچم \f[V]--disable-dir-list\f[R] (Leon Brocard)
.RE
.IP \[bu] 2
رفع باگ‌ها (Bug Fixes)
.RS 2
.IP \[bu] 2
‏archive/squashfs: رفع خواندن ایمیج‌های بدون جدول fragment یا xattr (maximilize)
.IP \[bu] 2
‏chunkedreader: رفع خطاهای کاذب هنگام بسته‌شدن زودهنگام یک جریان موازی (Nick Craig-Wood)
.IP \[bu] 2
config
.RS 2
.IP \[bu] 2
رفع نادیده‌گرفته‌شدن config_template_file و config_template از طریق config/create (hexbinoct)
.IP \[bu] 2
رفع نرمال‌سازی هنگام مبهم‌سازی گذرواژه‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
‏docker serve: رفع اتمام مهلت زمانی (timeout) افزونه هنگام راه‌اندازی مجدد در صورت وجود اتصالات فعال حجم‌ها (Nick Craig-Wood)
.IP \[bu] 2
‏fs: رفع نمایش گذرواژه‌ها و نشانه‌ها در گزارش اشکال‌زدایی هنگام اجرای rclone config (Nick Craig-Wood)
.IP \[bu] 2
‏gui: رفع درخواست‌های متقاطع API (cross-origin) هنگام اتصال به آدرس عام‌نویسه (wildcard) (FTCHD)
.IP \[bu] 2
‏hash: رفع اندازه هش‌ساز xxh128 (Yuhang Cao)
.IP \[bu] 2
‏log: رفع عوارض جانبی هنگام واردکردن rclone به عنوان یک کتابخانه (Sven Rebhan)
.IP \[bu] 2
march
.RS 2
.IP \[bu] 2
رفع فهرست‌کردن غیرضروری دایرکتوری dst پس از پایان فهرست‌کردن src (Nick Craig-Wood)
.IP \[bu] 2
رفع نشت goroutine در کارهای ناهمگام پایان‌یافته rc (Yash Anil)
.RE
.IP \[bu] 2
‏nfsmount: رفع ناسازگاری گزینه‌های mount_nfs با OpenBSD (Socialpranker)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
رفع مشکل \f[V]operations/stat\f[R] برای دایرکتوری‌هایی با دایرکتوری والد بزرگ (Nick Craig-Wood)
.IP \[bu] 2
رفع نادیده‌گرفته‌شدن پارامترهای \f[V]_filter\f[R] و \f[V]_config\f[R] توسط دستورهای \f[V]mount/*\f[R] (Hakan İSMAİL)
.RE
.IP \[bu] 2
‏serve: رفع استفاده پراکسی احراز هویت از پارامترهای کهنه پیکربندی هنگام ایجاد بک‌اند (Nick Craig-Wood)
.IP \[bu] 2
serve s3
.RS 2
.IP \[bu] 2
رفع نمایش بارگذاری‌های چندبخشی لغوشده به‌صورت شبح (Nick Craig-Wood)
.IP \[bu] 2
رفع اتمیک نبودن بارگذاری‌های چندبخشی جریانی (Nick Craig-Wood)
.IP \[bu] 2
رفع خطاهای OOM و InvalidPart در بارگذاری‌های چندبخشی هم‌روند (Nick Craig-Wood)
.RE
.IP \[bu] 2
‏sync: رفع تغییر نام \f[V]--fix-case\f[R] در بک‌اندهایی که پیش از رونویسی به بارگذاری نیاز دارند (Nick Craig-Wood)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
پشتیبانی از گزینه‌های مسطح VFS و Mount در دستور RC مربوط به mount (Hakan İSMAİL)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع خطای ورودی/خروجی با ایجاد مجدد فایل حافظه پنهان در صورت حذف شدن آن (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای \[dq]invalid seek position\[dq] زمانی که فایل‌های حافظه پنهان از ریموت بزرگتر هستند (Nick Craig-Wood)
.IP \[bu] 2
رفع متوقف نشدن تایمر پس‌نویسی حافظه پنهان vfs هنگامی که به سقف \f[V]--transfers\f[R] می‌رسد (Nick Craig-Wood)
.IP \[bu] 2
رفع فروپاشی هنگام اشتراک یک VFS یکسان میان چندین سوارکردن یا سرور (Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--local-fatal-if-no-space\f[R] (ferrumclaudepilgrim)
.IP \[bu] 2
عدم تبدیل ریشه‌های نسبی به مسیرهای مطلق (Nick Craig-Wood)
.RE
.IP \[bu] 2
Archive
.RS 2
.IP \[bu] 2
رفع شکست فهرست‌کردن squashfs با خطای آرگومان نامعتبر پس از به‌روزرسانی (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
رفع حذف شدن MD5 در خواندن‌های محدوده‌ای که باعث بارگیری مجدد حافظه پنهان vfs می‌شد (Nick Craig-Wood)
.IP \[bu] 2
افزودن پرچم \f[V]use_arrow_list\f[R] برای فهرست‌بندی آزمایشی با Apache Arrow (Nick Craig-Wood)
.IP \[bu] 2
فهرست‌کردن کانتینرهای بسیار بزرگ به‌صورت موازی با \f[V]list_parallelism\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azurefiles
.RS 2
.IP \[bu] 2
رفع modtime نادرست پس از بارگذاری فایل یا تنظیم modtime آن (Nick Craig-Wood)
.IP \[bu] 2
بهبود دقت modtime از ۱ ثانیه به ۱۰۰ نانوثانیه (Nick Craig-Wood)
.RE
.IP \[bu] 2
Combine
.RS 2
.IP \[bu] 2
عدم بازگرداندن پیام خطا به‌عنوان نام ریموت برای شیء نامعتبر (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drime
.RS 2
.IP \[bu] 2
حذف فیلد کهنه mux_status از Item (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
هشدار در ویزارد پیکربندی پیش از استفاده از client_id مشترک (Nick Craig-Wood)
.IP \[bu] 2
تشخیص حلقه‌های میانبر برای جلوگیری از بازگشت نامتناهی (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از impersonate_admin (Gaurav)
.IP \[bu] 2
افزودن \f[V]--dropbox-skip-shared-folders\f[R] و \f[V]--dropbox-skip-unowned-folders\f[R] (Gaurav).IP \[bu] 2
کاهش یک فراخوانی API در Rmdir (Socialpranker)
.IP \[bu] 2
استفاده بسیار کمتر از حافظه هنگام بارگذاری فایل‌های کوچک (Nick Craig-Wood)
.IP \[bu] 2
حذف یک فراخوانی غیرضروری API هنگام بارگذاری فایل‌های کوچک (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Filen
.RS 2
.IP \[bu] 2
رفع نادرست بودن modtime پس از به‌روزرسانی فایل یا تنظیم modtime آن (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Filescom
.RS 2
.IP \[bu] 2
رفع مفقود شدن هش MD5 پس از بارگذاری فایل (Nick Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
رفع نادرست بودن modtime پس از بارگذاری فایل یا تنظیم modtime آن
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Googlephotos
.RS 2
.IP \[bu] 2
هشدار در دستیار پیکربندی پیش از استفاده از client_id مشترک (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Hasher
.RS 2
.IP \[bu] 2
رفع عدم ذخیره‌سازی هش‌ها در bolt DB توسط Update پس از جایگزینی فایل (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Hdfs
.RS 2
.IP \[bu] 2
رفع نادرست بودن modtime پس از بارگذاری فایل یا تنظیم modtime آن
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Hidrive
.RS 2
.IP \[bu] 2
رفع نادرست بودن modtime پس از تنظیم modtime فایل (Nick
Craig-Wood)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
عدم فهرست کردن دایرکتوری والد هنگام اشاره به یک تک‌فایل (Nick
Craig-Wood)
.IP \[bu] 2
افزودن Prefer به هدر Access-Control-Allow-Headers در CORS (sijie-Z)
.RE
.IP \[bu] 2
Iclouddrive
.RS 2
.IP \[bu] 2
رفع خطای \[dq]cannot unmarshal number\[dq] هنگام فهرست کردن آلبوم‌های عکس
(Nick Craig-Wood)
.IP \[bu] 2
رفع شکست 2FA با خطای 409 حتی در صورت معتبر بودن کد (Punya Jain)
.RE
.IP \[bu] 2
Imagekit
.RS 2
.IP \[bu] 2
رفع بازگرداندن داده‌های نادرست توسط Open همراه با RangeOption (Nick Craig-Wood)
.IP \[bu] 2
افزودن mtime به فراداده‌های موجود (Nick Craig-Wood)
.RE
.IP \[bu] 2
Internxt
.RS 2
.IP \[bu] 2
افزودن متدهای Move و DirMove برای عملیات سمت سرور روی فایل‌ها و دایرکتوری‌ها
(jzunigax2)
.IP \[bu] 2
مدیریت خطاهای محدودیت اندازه فایل در حین بارگذاری (jzunigax2)
.IP \[bu] 2
نمایش خطای ورود مجدد هنگام شکست احراز هویت دوباره در NewFs (0rangeSeaW0lf)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
رفع نادرست بودن modtime پس از تنظیم modtime فایل (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Linkbox
.RS 2
.IP \[bu] 2
تلاش مجدد در پاسخ‌های چالش HTML محافظت از ربات به جای شکست (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Mailru
.RS 2
.IP \[bu] 2
رفع نادرست بودن modtime پس از به‌روزرسانی فایل یا تنظیم modtime آن (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Mega
.RS 2
.IP \[bu] 2
رفع نمایش دوباره فایل‌ها در فهرست‌ها پس از تغییر نام (Nick Craig-Wood)
.IP \[bu] 2
رفع ناپدید شدن فایل‌های منتقل‌شده از فهرست‌ها میان ریموت‌ها (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Netstorage
.RS 2
.IP \[bu] 2
رفع مفقود شدن هش MD5 پس از بارگذاری فایل (Nick Craig-Wood)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از حالت بدون دسترسی مدیر (no admin mode) (TaterLi)
.IP \[bu] 2
در نظر گرفتن بارگیری preauth با وضعیت غیر 2xx به عنوان خطا (ifloppy)
.IP \[bu] 2
بارگیری فایل‌های علامت‌گذاری‌شده به عنوان بدافزار از طریق هدر Prefer در Graph (ifloppy)
.RE
.IP \[bu] 2
Opendrive
.RS 2
.IP \[bu] 2
رفع بازگرداندن هش و modtime نادرست توسط اشیاء بارگذاری‌شده (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Oracleobjectstorage
.RS 2
.IP \[bu] 2
رفع فروپاشی هنگام بارگیری اشیاء با طول نامشخص (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینه \f[V]--oos-decompress\f[R] برای بارگیری فایل‌های کدگذاری‌شده با gzip (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Pixeldrain
.RS 2
.IP \[bu] 2
رفع نادرست بودن modtime و مفقود شدن هش پس از بارگذاری فایل (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Protondrive
.RS 2
.IP \[bu] 2
پیاده‌سازی منطق مناسب برای تلاش مجدد (tomholford)
.IP \[bu] 2
رفع خطای gopenpgp: invalid data: user ID signature with wrong type روی
حساب دامنه اختصاصی (Nick Craig-Wood)
.IP \[bu] 2
رفع توقف‌های طولانی‌مدت در صورت شکست‌های دائمی اعتبارسنجی (Nick Craig-Wood)
.IP \[bu] 2
رفع نادرست بودن modtime پس از بارگذاری فایل (Nick Craig-Wood)
.RE
.IP \[bu] 2
Putio
.RS 2
.IP \[bu] 2
رفع نادرست بودن modtime پس از تنظیم modtime فایل (Nick
Craig-Wood).IP \[bu] 2
رفع شکست حذف‌های همگام‌سازی با خطای 400 TRASH_LOCK_TIMEOUT (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Quatrix
.RS 2
.IP \[bu] 2
رفع مقدار نادرست modtime پس از بارگذاری فایل (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن ارائه‌دهنده Zero Services (ZERO-Z3) (Zero Services GmbH)
.IP \[bu] 2
افزودن ارائه‌دهنده Scality (RING / ARTESCA) (Dzmitry Nianakhau)
.RE
.IP \[bu] 2
Seafile
.RS 2
.IP \[bu] 2
رفع مشکل همگام‌سازی مکرر فایل‌های با اندازه یکسان در rclone (TowyTowy)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن \f[V]--sftp-pin-host-key\f[R] \- تثبیت کلید میزبان با روش اعتماد در اولین استفاده (Trust On First Use)
(Nick Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--sftp-encoding\f[R] (Puneet Dixit)
.IP \[bu] 2
عدم تلاش مجدد برای خطاهای دائمی اتصال (Nick Craig-Wood)
.IP \[bu] 2
امکان بی‌صدا کردن هشدار عدم اعتبارسنجی hostkey (Noah Zalev)
.IP \[bu] 2
رفع اجرای دستورات پوسته cmd برای مسیرهای حاوی بسط متغیر یا
نویسه‌های خط جدید (Nick Craig-Wood)
.RE
.IP \[bu] 2
Shade
.RS 2
.IP \[bu] 2
تلاش مجدد در صورت خطاهای سرور به‌جای متوقف کردن انتقال (Nick Craig-Wood)
.IP \[bu] 2
رفع شکست بارگذاری‌ها با خطای EOF هنگام تکمیل بارگذاری‌های چندبخشی (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
رفع مشکل بارگذاری مجدد گواهی‌های احراز هویت Kerberos برای هر اتصال (Nick
Craig-Wood)
.IP \[bu] 2
رفع نشت اتصال TCP هنگام شکست در برقراری اتصال (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل جابه‌جایی سمت سرور پوشه‌های حاوی نویسه‌های خاص در نام
(Nick Craig-Wood)
.IP \[bu] 2
رفع خطاهای کاذب \[dq]Directory already exists\[dq] هنگام جابه‌جایی
پوشه‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Ulozto
.RS 2
.IP \[bu] 2
رفع مشکل از دست رفتن فایل‌ها هنگام جابه‌جایی سمت سرور بین ریموت‌های با ریشه متفاوت
(Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
رفع مقدار نادرست modtime پس از تنظیم modtime فایل (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
رفع خطاهای 500 با انتظار برای تکمیل بارگذاری‌ها قبل از تنظیم modtime
(Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل نبود هش MD5 پس از بارگذاری فایل (Nick Craig-Wood)
.IP \[bu] 2
رفع بازگشت تصادفی modtime به زمان بارگذاری پس از آپلود (Nick
Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--yandex-upload-wait\f[R] جهت رفع خطاهای 500 هنگام بارگذاری
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Zoho
.RS 2
.IP \[bu] 2
رعایت سرآیند \f[V]Retry-After\f[R] در پاسخ‌های 429 (Erol Ozcan)
.IP \[bu] 2
افزودن \f[V]--zoho-tpslimit\f[R] و \f[V]--zoho-tpslimit-burst\f[R] (Erol
Ozcan)
.IP \[bu] 2
ثبت گزارش محدودسازی نرخ (throttling) تنها یک‌بار در هر رخداد در سطح NOTICE (Erol Ozcan)
.IP \[bu] 2
محدودسازی نرخ برای فهرست‌گیری‌های مکرر از یک پوشه (Erol Ozcan)
.IP \[bu] 2
رفع ناپایداری آزمون محدودکننده فهرست پوشه‌ها تحت فهرست‌گیری‌های هم‌زمان (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل رونویسی فایل بزرگ که به‌جای جایگزینی، یک نسخهٔ تکراری ایجاد می‌کرد (Erol
Ozcan)
.IP \[bu] 2
در نظر گرفتن خطای R008 unauthorized به عنوان پوشه یافت نشد (Erol Ozcan)
.IP \[bu] 2
حفظ \f[V]root_folder_id\f[R] هنگام اتصال مجدد و امکان تنظیم آن
(Erol Ozcan)
.RE.SS v1.74.4 - 2026-07-08
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.74.3...v1.74.4)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
رفع نشت goroutine در ResetCounters (Nick Craig-Wood)
.IP \[bu] 2
رفع نشت goroutine در NewStatsGroup برای کارهای rc بدون انتقال
(Sanjays2402)
.RE
.IP \[bu] 2
archive extract: رفع آسیب‌پذیری پیمایش مسیر که به آرشیوها اجازه خروج از
مقصد را می‌داد CVE-2026-59732 (Nick Craig-Wood)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
رفع چندین CVE با ارتقا به go1.26.5 (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
CVE-2026-39822: os: فرار از ریشه از طریق پیوند نمادین به‌همراه اسلش پایانی
.IP \[bu] 2
CVE-2026-42505: crypto/tls: نشت حریم خصوصی در Encrypted Client Hello
.RE
.IP \[bu] 2
به‌روزرسانی golang.org/x/image به v0.43.0 برای رفع آسیب‌پذیری‌های رمزگشایی
تصویر (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
CVE-2026-46604: خطای panic هنگام رمزگشایی تصویر TIFF با strip offset خارج
از محدوده
.IP \[bu] 2
CVE-2026-46602: مصرف حافظه نامحدود به دلیل نبود محدودیت روی اندازه کاشی‌های
TIFF
.IP \[bu] 2
CVE-2026-46601: خطای panic هنگام عدم تطابق اندازه کانال آلفای WEBP VP8
.IP \[bu] 2
CVE-2026-33813: خطای panic هنگام رمزگشایی تصویر بزرگ WEBP در بسترهای ۳۲ بیتی
.RE
.RE
.IP \[bu] 2
cmd/mount2
.RS 2
.IP \[bu] 2
رفع مشکل ایجاد فایل NFS با پیاده‌سازی Mknod (Sandy Luppino)
.IP \[bu] 2
رفع خطای ESTALE روی NFS با گزارش شماره‌های inode پایدار (Sandy Luppino)
.IP \[bu] 2
رفع مشکل فهرست‌بندی دایرکتوری NFS با پشتیبانی از آفست‌های غیرصفر Seekdir
(Sandy Luppino)
.RE
.IP \[bu] 2
completion: رفع خرابی نام‌های غیر ASCII در تکمیل خودکار powershell (Yash
Anil)
.IP \[bu] 2
اصلاحات مستندات (Bryan Stenson, Castronaut, Filippo, Gaurav, happysnaker,
Jan-Philipp Reßler, Nick Craig-Wood, user77)
.IP \[bu] 2
filter: رفع توقف کپی \f[V]--files-from\f[R] در اولین فایل غیرقابل خواندن
(Nick Craig-Wood)
.IP \[bu] 2
fs
.RS 2
.IP \[bu] 2
رفع نادیده گرفته شدن گزینه خط فرمان هنگام تنظیم روی مقدار پیش‌فرض آن (Nick
Craig-Wood)
.IP \[bu] 2
رفع آفست منفی هنگامی که درخواست پسوند Range از اندازه شیء فراتر می‌رود
(Amit Mishra)
.RE
.IP \[bu] 2
gui: به‌روزرسانی نگارش تعبیه‌شده به 1.1.10 (Nick Craig-Wood)
.IP \[bu] 2
ncdu: رفع تکرار فشرده شدن کلیدها در Windows با تثبیت tcell روی v2.9.0
(Nick Craig-Wood)
.IP \[bu] 2
serve restic: رفع دور زدن جداسازی \f[V]--private-repos\f[R]
شناسه CVE-2026-59733 (Nick Craig-Wood)
.IP \[bu] 2
serve s3
.RS 2
.IP \[bu] 2
رفع خطای کاذب 404 در HEAD/GET هنگام بازنویسی VFS (max)
.IP \[bu] 2
رفع پیمایش مسیر که به کلاینت‌ها امکان دیدن فایل‌ها در ریشه را می‌داد
GHSA-8v25-v8p6-qf7v (Nick Craig-Wood)
.RE
.IP \[bu] 2
serve webdav: رفع شکست بازنویسی MOVE بدون سرآیند Overwrite
(Sanjay Santhanam)
.IP \[bu] 2
serve/http: اصلاح \f[V]--disable-zip\f[R] برای کارکرد روی rc (Nick
Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع قفل کردن هنگام بازگشایی مجدد فایل در طول مهلت حافظه پنهان دستگیره (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
جلوگیری از خروج پیوندهای نمادین \f[V]--links\f[R] از دایرکتوری مقصد
CVE-2026-54572 (Nick Craig-Wood)
.IP \[bu] 2
عدم بازیابی بیت‌های setuid/setgid/sticky از فراداده به‌طور پیش‌فرض
GHSA-945v-v9p3-v5xw (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
هشدار هنگام رد شدن از سندهای غیرقابل خروجی‌گیری Google (Nick Craig-Wood)
.IP \[bu] 2
رفع نویسه سرگردان %!(EXTRA) در پیام ثبت رویداد سند غیرقابل خروجی‌گیری Google
(Nick Craig-Wood)
.IP \[bu] 2
هشدار هنگام استفاده از client_id اشتراکی rclone (Nick Craig-Wood)
.RE
.IP \[bu] 2
Filelu
.RS 2
.IP \[bu] 2
رفع مدیریت مسیر فهرست‌بندی بازگشتی و پالایش فایل‌ها (kingston125)
.RE
.IP \[bu] 2
Googlephotos
.RS 2
.IP \[bu] 2
هشدار هنگام استفاده از client_id اشتراکی rclone (Nick Craig-Wood)
.RE
.IP \[bu] 2
Mega
.RS 2
.IP \[bu] 2
انتظار برای رویدادهای سرور پس از بارگذاری، حذف و انتقال (Nick Craig-Wood)
.IP \[bu] 2
رفع نمایش مجدد فایل‌های به‌طور دائم حذف‌شده در فهرست‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
حذف نشانه جلسه (session token) در بازمسیردهی‌های بین‌میزبانی (IceLocke)
.IP \[bu] 2
حذف نشانه امنیتی STS در بازمسیردهی درون‌میزبانی HTTPS->HTTP
شناسه GHSA-cf44-9pgv-m4xc (Nick Craig-Wood)
.IP \[bu] 2
اصلاح نگاشت خطا در GetObject برای مطابقت با HeadObject (lewoberst)
.IP \[bu] 2
تصحیح حداقل مقدار مستندشده \f[V]copy_cutoff\f[R] به ۱ بایت (max)
.IP \[bu] 2
رفع خطای 403 هنگام سوار کردن یک پیشوند در صورت مجاز نبودن HEAD (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
رفع مشکل برای IBM iSeries و اعتبارسنجی امضا (dithwick)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
رفع تداخل وضعیت ویژگی‌ها در پاسخ‌های multi-status (nako-ruru)
.RE.SS v1.74.3 - 2026-06-05
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.74.2...v1.74.3)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
رفع اجرای دستور بدون احراز هویت از طریق ریموت‌های درون‌خطی \f[V]--rc-serve\f[R]، شناسه CVE-2026-49980 (Nick Craig-Wood)
.IP \[bu] 2
جلوگیری از تغییر پیکربندی توسط گزینه‌های رشته اتصال \f[V]global.*\f[R]، شناسه CVE-2026-49980 (Nick Craig-Wood)
.RE
.IP \[bu] 2
build: رفع چندین CVE با ارتقا به go1.26.4 (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
CVE-2026-42504: mime: پیچیدگی درجه دوم در WordDecoder.DecodeHeader
.IP \[bu] 2
CVE-2026-42507: net/textproto: ورودی‌های دلخواه بدون هیچ‌گونه گریزدهی در خطاها گنجانده می‌شوند
.IP \[bu] 2
CVE-2026-27145: crypto/x509: تفکیک نام میزبان کاندید فقط یک‌بار
.RE
.IP \[bu] 2
log: رفع مبدأ اشتباه \f[V]file:line\f[R] در لاگ‌های JSON حاصل از ساخت‌های نهایی (Nick Craig-Wood)
.IP \[bu] 2
mount2: رفع خالی بودن فهرست دایرکتوری در خواندن مجدد (Janne Beate Bakeng)
.IP \[bu] 2
serve s3: رفع مشکل بازگرداندن شماره بخش‌های اشتباه در صفحه‌بندی چندبخشی \f[V]ListParts\f[R] (Nick Craig-Wood)
.IP \[bu] 2
serve sftp
.RS 2
.IP \[bu] 2
رفع خراب شدن فایل هنگامی که کلاینت بارگذاری را از سر می‌گیرد (Nick Craig-Wood)
.IP \[bu] 2
رفع نادیده گرفته شدن بی‌صدای درخواست truncate (Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع بازگرداندن map خالی به‌جای nil توسط \f[V]getXattr\f[R] (Leon Brocard)
.RE
.IP \[bu] 2
Drime
.RS 2
.IP \[bu] 2
رفع شکست کپی و انتقال سمت سرور با خطای Cloudflare 520 (Nick Craig-Wood)
.IP \[bu] 2
رفع بارگذاری فایل‌ها در دایرکتوری اشتباه (Nick Craig-Wood)
.IP \[bu] 2
حذف گزینه پیکربندی تکراری upload_cutoff (Nick Craig-Wood)
.IP \[bu] 2
رفع خالی ماندن پوشه تغییرنام‌یافته در VFS پس از تغییر نام دایرکتوری (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
رفع شکست انتقال سمت سرور در درایوهای اشتراکی دارای دایرکتوری‌های تکراری (Nick Craig-Wood)
.RE
.IP \[bu] 2
Iclouddrive
.RS 2
.IP \[bu] 2
رفع مشکل دریافت کوکی ADP/PCS برای iCloud Drive (Yakov Till)
.IP \[bu] 2
رفع خطای \[dq]Index has invalid data\[dq] هنگام فهرست‌بندی iCloud Photos (Nick Craig-Wood)
.RE.SS v1.74.2 - 2026-05-22
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.74.1...v1.74.2)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
به‌روزرسانی golang.org/x/net به v0.55.0 برای رسیدگی به:
.RS 2
.IP \[bu] 2
CVE-2026-42506: html: مدیریت نادرست المان‌های دارای فضای نام (namespaced) در محتوای خارجی
.IP \[bu] 2
CVE-2026-39821: idna: عدم رد برچسب‌های کدگذاری‌شده با Punycode که فقط شامل کاراکترهای ASCII هستند
.IP \[bu] 2
CVE-2026-42502: html: مدیریت نادرست المان‌های HTML در محتوای خارجی
.IP \[bu] 2
CVE-2026-25680: html: منع سرویس (DoS) هنگام تجزیه HTML دلخواه
.IP \[bu] 2
CVE-2026-25681: html: مدیریت نادرست ارجاعات نویسه در گره‌های DOCTYPE
.IP \[bu] 2
CVE-2026-27136: html: صفات تکراری می‌توانند موجب XSS شوند
.RE
.IP \[bu] 2
به‌روزرسانی golang.org/x/crypto به v0.52.0 برای رسیدگی به:
.RS 2
.IP \[bu] 2
CVE-2026-46598: ssh/agent: ورودی‌های ناهنجار می‌توانند منجر به panic در کلاینت شوند
.IP \[bu] 2
CVE-2026-46597: ssh: محاسبات بایتی موجب underflow و panic می‌شود
.IP \[bu] 2
CVE-2026-39828: ssh: دور زدن محدودیت‌های گواهی
.IP \[bu] 2
CVE-2026-39835: ssh: رخ دادن panic در سرور هنگام CheckHostKey/Authenticate
.IP \[bu] 2
CVE-2026-39833: ssh/agent: عدم اعمال محدودیت‌های کلید
.IP \[bu] 2
CVE-2026-39832: ssh/agent: نادیده گرفته شدن محدودیت‌های agent هنگام بازارسال (forwarding) کلیدها
.IP \[bu] 2
CVE-2026-39827: ssh: نشت حافظه هنگام رد کانال‌ها می‌تواند به DoS منجر شود
.IP \[bu] 2
CVE-2026-39830: ssh: کلاینت می‌تواند باعث deadlock در سرور روی پاسخ‌های غیرمنتظره شود
.IP \[bu] 2
CVE-2026-39829: ssh: پارامترهای ناهنجار RSA/DSA ممکن است باعث DoS شوند
.IP \[bu] 2
CVE-2026-39831: ssh: دور زدن تعامل فیزیکی کلیدهای امنیتی FIDO/U2F
.IP \[bu] 2
CVE-2026-39834: ssh: حلقه بی‌نهایت هنگام نوشتن روی کانال‌های بزرگ
.IP \[bu] 2
CVE-2026-42508: ssh/knownhosts: دور زدن احراز هویت از طریق اعمال نشدن وضعیت \[at]revoked
.IP \[bu] 2
CVE-2026-46595: ssh: عدم اعمال مجوزهای VerifiedPublicKeyCallback
.RE
.IP \[bu] 2
به‌روزرسانی golang.org/x/image به v0.41.0 برای رسیدگی به:
.RS 2
.IP \[bu] 2
CVE-2026-42500: bmp: رخ دادن panic هنگام خواندن اندیس پالت خارج از محدوده
.IP \[bu] 2
CVE-2026-33809: tiff: مصرف بیش از حد منابع در باز کردن فشرده‌سازی PackBits
.RE
.IP \[bu] 2
به‌روزرسانی golang.org/x/sys به نسخه v0.45.0 برای رسیدگی به:
.RS 2
.IP \[bu] 2
CVE-2026-39824: windows: سرریز عدد صحیح در NewNTUnicodeString
.RE
.IP \[bu] 2
به‌روزرسانی github.com/go-git/go-billy/v5 به 5.9.0 برای رفع CVE-2026-44740
.IP \[bu] 2
bisync: رفع نام مسیر --conflict-loser همراه با --conflict-resolve newer (توسط nielash)
.IP \[bu] 2
gui: به‌روزرسانی انتشار تعبیه‌شده به 1.1.8 (توسط Nick Craig-Wood)
.IP \[bu] 2
lib/http: جایگزینی h2c.NewHandler منسوخ‌شده با http.Server.Protocols (توسط Nick Craig-Wood)
.IP \[bu] 2
rc: حذف ثبت تکراری گزینه metrics_addr (توسط Nick Craig-Wood)
.IP \[bu] 2
vfs/vfscache: رفع شکست خاموش نوشتن هنگام اتصال (mount) با remote:. (توسط Lucky945H)
.RE
.IP \[bu] 2
اصلاحات مستندات (توسط FTCHD، Iizuki، Leon Brocard، Nick Craig-Wood)
.RE
.IP \[bu] 2
Drime
.RS 2
.IP \[bu] 2
رفع خطای file doesn\[aq]t exists هنگام تلاش برای حذف (توسط John Volk)
.IP \[bu] 2
رفع خطاهای 500 هنگام فهرست کردن پوشه‌های اشتراکی (توسط Alvinwylim)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
پشتیبانی از سرویس ارائه‌دهنده اختصاصی (whitelabel) بنام Phonero Sky (توسط Tore Anderson)
.RE
.IP \[bu] 2
Protondrive
.RS 2
.IP \[bu] 2
رفع خطای corrupted on transfer: sha1 hashes differ (توسط William Tange)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن نقاط پایانی (endpoints) جدید MEGA S4 روی megas4.com شامل منطقه آسیا-اقیانوسیه (توسط Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
رعایت auth_redirect در دستور PROPFIND برای listAll (توسط Sai Asish Y)
.RE.SS v1.74.1 - 2026-05-08
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.74.0...v1.74.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
bisync: رفع پیام خطای retryable without \f[V]--resync\f[R] هنگامی که \f[V]--resync\f[R] با شکست بحرانی مواجه می‌شود (Gustavo V.
F.)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
رفع چندین آسیب‌پذیری CVE با ارتقا به go1.26.3 (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
CVE-2026-42501: cmd/go: پروکسی ماژول مخرب می‌تواند پایگاه داده چکسام را دور بزند
.IP \[bu] 2
CVE-2026-39825: net/http/httputil: ابزار ReverseProxy پرس‌وجوها با بیش از urlmaxqueryparams پارامتر را هدایت می‌کند
.IP \[bu] 2
CVE-2026-39836: net: بروز panic در Dial و LookupPort هنگام پردازش بایت NUL در Windows
.IP \[bu] 2
CVE-2026-42499: net/mail: الحاق درجه دوم رشته در consumePhrase
.IP \[bu] 2
CVE-2026-39820: net/mail: الحاق درجه دوم رشته در consumeComment
.IP \[bu] 2
CVE-2026-39819: cmd/go: دستور \[dq]go bug\[dq] پیوندهای نمادین را در نام فایل‌های موقت قابل پیش‌بینی دنبال می‌کند
.IP \[bu] 2
CVE-2026-39817: cmd/go: دستور \[dq]go tool pack\[dq] مسیرهای خروجی را پاکسازی نمی‌کند
.IP \[bu] 2
CVE-2026-33814: net/http: حلقه بی‌نهایت در انتقال HTTP/2 در صورت دریافت SETTINGS_MAX_FRAME_SIZE نامعتبر
.IP \[bu] 2
CVE-2026-39826: html/template: دور زدن سیستم گریز (escaper) منجر به XSS می‌شود
.IP \[bu] 2
CVE-2026-33811: net: کرش هنگام مدیریت پاسخ‌های طولانی CNAME
.IP \[bu] 2
CVE-2026-39823: html/template: دور زدن گریزدهی نشانی وب meta content منجر به بروز XSS می‌شود
.RE
.IP \[bu] 2
به‌روزرسانی golang.org/x/net به v0.53.0 جهت رفع CVE-2026-33814 (Nick
Craig-Wood)
.RE
.IP \[bu] 2
cmd/serve/s3: بازگرداندن فهرست اشیاء طبق ترتیب کلیدها (Leon Brocard)
.RE
.IP \[bu] 2
Cloudinary
.RS 2
.IP \[bu] 2
اصلاح تلاش مجدد برای همه خطاها و تصحیح واحدهای خواب pacer (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drime
.RS 2
.IP \[bu] 2
اصلاح آپلود فایل‌های حجیم که به جای پوشه پیکربندی‌شده در ریشه درایو قرار می‌گرفتند (Nick Craig-Wood)
.IP \[bu] 2
اصلاح بارگذاری فایل‌های 100..200M (Nick Craig-Wood)
.RE
.IP \[bu] 2
Protondrive
.RS 2
.IP \[bu] 2
مسیریابی HTTP از طریق ترنسپورت rclone (Nick Craig-Wood)
.IP \[bu] 2
مسیریابی ثبت گزارش‌های کتابخانه از طریق ثبت‌کننده rclone (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای segfault هنگام کپی فایل‌های فاقد متادیتای بازبینی (Nick
Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
اصلاح فراخوانی STS در هر درخواست با کش کردن اعتبارنامه‌های AssumeRole (Nick
Craig-Wood)
.IP \[bu] 2
افزودن ناحیه‌های جدید Fastly Object Storage (Leon Brocard)
.RE.SS v1.74.0 - 2026-05-01
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.73.0...v1.74.0)
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
Huawei Drive (https://rclone.org/huaweidrive) (王一赫)
.IP \[bu] 2
iCloud Photos (https://rclone.org/iclouddrive/#icloud-photos) (فقط‌خواندنی) (Yakov Till)
.IP \[bu] 2
ارائه‌دهندگان جدید S3
.RS 2
.IP \[bu] 2
Fastly Object Storage (https://rclone.org/s3/#fastly) (Leon Brocard)
.IP \[bu] 2
HCP (https://rclone.org/s3/#hcp) (Chris)
.IP \[bu] 2
Impossible Cloud (https://rclone.org/s3/#impossible-cloud) (Nick
Craig-Wood)
.IP \[bu] 2
UCloud US3 (https://rclone.org/s3/#us3) (jinkeyuu)
.IP \[bu] 2
Zadara (https://rclone.org/s3/#zadara) (Shlomi Avihou)
.RE
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
gui (https://rclone.org/gui): راه‌اندازی رابط گرافیکی وب توکار جدید برای عملیات پایه‌ای rclone (FTCHD, Nick Craig-Wood)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
به‌روزرسانی \f[V]golang.org/x/image/webp\f[R] به v0.39.0 جهت رفع
CVE-2026-33813 (Nick Craig-Wood)
.IP \[bu] 2
ارتقای \f[V]github.com/Azure/go-ntlmssp\f[R] به 0.1.1 جهت رفع
CVE-2026-32952 (dependabot[bot])
.IP \[bu] 2
به‌روزرسانی به go1.26 و تعیین go1.25 به عنوان حداقل نسخه مورد نیاز (Nick
Craig-Wood)
.IP \[bu] 2
به‌روزرسانی تمام وابستگی‌ها (Nick Craig-Wood)
.IP \[bu] 2
مدرن‌سازی کد Go با استفاده از go fix برای go1.25 (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل ساخت در \f[V]loong64\f[R] و \f[V]s390x\f[R] (Suyun)
.RE
.IP \[bu] 2
docs
.RS 2
.IP \[bu] 2
مدرن‌سازی طراحی وب‌سایت rclone.org (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکالات (albertony, Enduriel, Jason, Luke Cyca, mathieulongtin, Nick
Craig-Wood, SyoBoN)
.RE
.IP \[bu] 2
fshttp: افزودن \f[V]--dump curl\f[R] جهت تخلیه درخواست‌های HTTP به صورت دستورهای curl (Nick Craig-Wood)
.IP \[bu] 2
graphics: بهینه‌سازی بدون اتلاف تصاویر با ImageOptim (Leon Brocard)
.IP \[bu] 2
listremotes: افزودن پرچم \f[V]--exact\f[R] برای فیلتر کردن (Anton Bordwine)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
تغییر حالت پیش‌فرض احراز هویت به گونه‌ای که همه نقاط پایانی نیازمند احراز هویت باشند مگر آنکه انصراف داده شود (Nick
Craig-Wood)
.IP \[bu] 2
افزودن \f[V]core/disks\f[R] جهت شمارش دیسک‌های متصل (Nick Craig-Wood)
.IP \[bu] 2
افزودن آمار \f[V]deletedDirs\f[R] به خروجی راهنمای \f[V]core/stats\f[R]
(Billy Hughes)
.RE
.IP \[bu] 2
serve http
.RS 2
.IP \[bu] 2
افزودن favicon توکار یدکی (Leon Brocard)
.IP \[bu] 2
افزودن فشرده‌سازی gzip برای پاسخ‌های متنی (Leon Brocard)
.IP \[bu] 2
حالت تاریک برای مرورگر فایل (FTCHD)
.IP \[bu] 2
افزودن پشتیبانی از HTTP/2 متن‌آشکار (cleartext) برای تمام سرورهای http (TheBabu)
.RE
.IP \[bu] 2
touch: افزودن متادیتا هنگام استفاده از \f[V]--metadata-set\f[R] (Prakhar
Chhalotre)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
به‌روزرسانی قالب خروجی متد String جهت شفافیت بیشتر در نمایش نرخ انتقال (Prakhar Chhalotre)
.IP \[bu] 2
رفع مشکل \f[V]rcat\f[R]/\f[V]copyurl\f[R] برای \f[V]files.com\f[R] (Nick
Craig-Wood)
.RE
.IP \[bu] 2
bisync
.RS 2
.IP \[bu] 2
افزودن پارامترهای rc مفقود (nielash)
.IP \[bu] 2
افزودن اطلاعات ساختاریافته‌تر به خروجی rc (nielash)
.IP \[bu] 2
تولید خودکار اسناد راهنمای rc (nielash)
.IP \[bu] 2
رفع مشکل مدیریت فایل‌های قفل غیرقابل خواندن (lif)
.IP \[bu] 2
رفع ناپایداری آزمون TestBisyncConcurrent از طریق افزایش آنتروپی نام تصادفی (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل آزمون‌های یکپارچه‌سازی پس از تغییرات در لاگ‌های sftp (Nick Craig-Wood)
.RE
.IP \[bu] 2
copyurl: رفع نادیده گرفته شدن \f[V]--upload-headers\f[R] و
\f[V]--download-headers\f[R] (Andriy Senyshyn)
.IP \[bu] 2
librclone/ctest: افزودن پشتیبانی از Windows و رفع مشکل مدیریت حافظه
(BizaNator)
.IP \[bu] 2
log: رفع رقابت داده‌ای (data race) در فیلد OutputHandler.format (Nick Craig-Wood)
.IP \[bu] 2
operations
.RS 2
.IP \[bu] 2
کپی چندنخی: تخصیص حافظه پیش از ایجاد goroutineها (Nick
Craig-Wood)
.RE
.IP \[bu] 2
serve dlna: رفع مشکل سازگاری با تلویزیون‌های سامسونگ (Nick Craig-Wood)
.IP \[bu] 2
serve nfs: رفع مشکل تنظیم نشدن پرچم EOF در پاسخ READ هنگام رسیدن به انتهای فایل (Nick Craig-Wood)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
rc: رفع مشکل بازنویسی متقابل نقاط اتصالی که با mountPoint \[dq]*\[dq] ایجاد شده‌اند (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع کندی \f[V]nfs serve\f[R] با افزودن \f[V]--vfs-handle-caching\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
افزودن پارامتر context به New() جهت انتشار پیکربندی (Nick Craig-Wood)
.IP \[bu] 2
جایگزینی \f[V]context.TODO\f[R]/\f[V]Background\f[R] با کانتکست ذخیره‌شدهٔ VFS (Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
حذف فراخوانی‌های fadvise که موجب رقابت بر سر spinlock می‌شدند (Patrick Farrell)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
افزودن \f[V]--azureblob-copy-total-concurrency\f[R] جهت محدود کردن هم‌زمانی کل کپی‌های چندبخشی (Duncan F).IP \[bu] 2
افزودن محاسبه بلادرنگ کپی سمت سرور (Nick Craig-Wood)
.IP \[bu] 2
افزودن پرچم \f[V]--azureblob-decompress\f[R] برای بارگیری فایل‌های کدگذاری‌شده با gzip
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Azurefiles
.RS 2
.IP \[bu] 2
رفع نبود سربرگ \f[V]x-ms-file-request-intent\f[R] همراه با OAuth (Nick
Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
افزودن محاسبه بلادرنگ کپی سمت سرور (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drime
.RS 2
.IP \[bu] 2
پیاده‌سازی About (Cohinem)
.IP \[bu] 2
رفع مشکل فهرست‌گیری دایرکتوری‌های بزرگ (John Volk)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن آزمون یکپارچه‌سازی برای مدیریت نام پوشه‌های دارای علامت نقل‌قول تکی
(Prakhar Chhalotre)
.RE
.IP \[bu] 2
Filelu
.RS 2
.IP \[bu] 2
افزودن نوع پاسخ آغازین چندبخشی (multipart init) (kingston125)
.IP \[bu] 2
مهاجرت فراخوانی‌های API به \f[V]lib/rest\f[R] (kingston125)
.RE
.IP \[bu] 2
Filen
.RS 2
.IP \[bu] 2
امکان تلاش مجدد جداگانه برای تکه‌های بارگذاری چندرشته‌ای (Enduriel)
.RE
.IP \[bu] 2
Iclouddrive
.RS 2
.IP \[bu] 2
جایگزینی ورود با متن‌آشکار با احراز هویت SRP (Mike GIllan)
.IP \[bu] 2
استفاده از مبدأ پویا برای سربرگ‌های احراز هویت SRP (Xiangzhe)
.IP \[bu] 2
کوچک کردن حروف Apple ID برای احراز هویت SRP (Mike GIllan)
.IP \[bu] 2
افزودن پشتیبانی فقط‌خواندنی از iCloud Photos و احراز هویت SRP (Yakov Till)
.RE
.IP \[bu] 2
Internxt
.RS 2
.IP \[bu] 2
پیاده‌سازی بارگذاری‌های چندبخشی (José Zúniga)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
افزودن کدگذاری نویسه درصد به کدگذاری پیش‌فرض بک‌اند
(albertony)
.RE
.IP \[bu] 2
Linkbox
.RS 2
.IP \[bu] 2
رفع مشکل بارگیری فایل‌ها با استفاده از API وب (Nick Craig-Wood)
.RE
.IP \[bu] 2
Mega
.RS 2
.IP \[bu] 2
رفع خرابی هنگام شکست در ورود با کلیدهای احراز هویت قبلی (Andrew
Gunnerson)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
رفع مشکل فهرست‌گیری بازگشتی از ریشه (Nick Craig-Wood)
.RE
.IP \[bu] 2
Pikpak
.RS 2
.IP \[bu] 2
پشتیبانی از نام‌فایل‌های سفارشی برای دستور بک‌اند addurl (wiserain)
.RE
.IP \[bu] 2
Protondrive
.RS 2
.IP \[bu] 2
همگام‌سازی بک‌اند با پشته جدیدتر Proton SDK (tdawe)
.IP \[bu] 2
به‌روزرسانی به جدیدترین go-proton-api برای استفاده از میزبان جدید (dlaumen)
.IP \[bu] 2
رفع مشکل moveto و DirMove سمت سرور مطابق با API فعلی (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن ارائه‌دهنده Fastly Object Storage (Leon Brocard)
.IP \[bu] 2
افزودن ارائه‌دهنده HCP و رفتار خاص \f[V]list_versions_oldest_first\f[R] (Chris)
.IP \[bu] 2
افزودن Impossible Cloud به عنوان یک ارائه‌دهنده جدید S3 (Nick Craig-Wood)
.IP \[bu] 2
افزودن ارائه‌دهنده UCloud Object Storage (#9230) (jinkeyuu)
.IP \[bu] 2
افزودن ارائه‌دهنده Zadara Object Storage (Shlomi Avihou)
.IP \[bu] 2
حذف ارائه‌دهنده StackPath Object Storage (Leon Brocard)
.IP \[bu] 2
افزودن محاسبه بلادرنگ کپی سمت سرور (Nick Craig-Wood)
.IP \[bu] 2
افزودن کلاس‌های ذخیره‌سازی OVHcloud (Bjoern Franke)
.IP \[bu] 2
افزودن پشتیبانی از Object Lock (Chris)
.IP \[bu] 2
افزودن منطقه‌های جدید Fastly Object Storage (Leon Brocard)
.IP \[bu] 2
Scaleway: مقدار ONEZONE_IA در همه منطقه‌ها در دسترس است، GLACIER فقط در FR-PAR
(Bjoern Franke)
.IP \[bu] 2
Ionos: به‌روزرسانی منطقه‌ها و پایانه‌ها (hxnd)
.IP \[bu] 2
IBM COS: ارائه ibm_iam_endpoint به عنوان پارامتری قابل پیکربندی برای احراز هویت
مبتنی بر IBM IAM (Bhagyashreek8)
.IP \[bu] 2
رفع Content-MD5 برای بارگذاری‌های Object Lock و افزودن رفتار خاص GCS (Chris)
.IP \[bu] 2
رفع پس‌رفت مربوط به شکست PutObject با خواننده‌های غیرقابل پیمایش (Chris)
.IP \[bu] 2
رفع نادیده گرفته شدن پرچم \f[V]--s3-versions\f[R] توسط cleanup-hidden هنگام
شکست GetBucketVersioning (Chris)
.IP \[bu] 2
رفع شکست ایجاد باکت در Ceph/radosgw (Jan Heylen)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
هشدار به کاربر در صورت عدم پیکربندی اعتبارسنجی کلید میزبان (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
مجاز دانستن تغییر مسیرها در PROPFIND برای فراداده (Brian Bockelman)
.IP \[bu] 2
درخواست تنها مشخصه‌های مورد نیاز در listAll برای بهبود کارایی
(ZRHan)
.IP \[bu] 2
بهینه‌سازی کارایی با استفاده از \f[V]Depth=0\f[R] برای درخواست‌های فراداده
(ZRHan)
.RE.SS v1.73.5 - 2026-04-19
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.73.4...v1.73.5)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
operations: افزودن AuthRequired به operations/fsinfo جهت جلوگیری از ایجاد backend به شماره CVE-2026-41179 (Nick Craig-Wood)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن AuthRequired به options/set برای جلوگیری از دور زدن احراز هویت CVE-2026-41176 (Nick Craig-Wood)
.IP \[bu] 2
گرفتن Snapshot از NoAuth در هنگام راه‌اندازی برای جلوگیری از دور زدن احراز هویت در زمان اجرا CVE-2026-41176 (Nick Craig-Wood)
.RE
.IP \[bu] 2
filter: رفع مشکل ثبت لاگ‌های دیباگ که پیش از پیکربندی لاگر اجرا می‌شدند (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azureblob
.RS 2
.IP \[bu] 2
افزودن پیشوند User-Agent مربوط به Microsoft Partner Network (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drime
.RS 2
.IP \[bu] 2
رفع اشکال JSON unmarshalling در User.EntryPermissions (a1pcm)
.RE
.IP \[bu] 2
Iclouddrive
.RS 2
.IP \[bu] 2
رفع خطای \[aq]directory not found\[aq] هنگامی که نام دایرکتوری شامل نشانه‌های اکسان (accent marks) است (Brais Couce)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع شکست بررسی باکت در اندپوینت CDN مربوط به TencentCOS (Mozi)
.IP \[bu] 2
رفع رد شدن پارامتر خالی delimiter توسط سرور Archiware P5 (Nick Craig-Wood)
.RE
.SS v1.73.4 - 2026-04-08
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.73.3...v1.73.4)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
بروزرسانی به go 1.25.9 برای رفع چندین آسیب‌پذیری CVE (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
CVE-2026-32282: بسته os: تابع Root.Chmod در لینوکس می‌تواند پیوندهای نمادین (symlinks) را به خارج از ریشه دنبال کند
.IP \[bu] 2
CVE-2026-32289: بسته html/template: زمینه متغیر الگوی جاوااسکریپت (JS template literal) به نادرستی ردگیری می‌شد
.IP \[bu] 2
CVE-2026-33810: بسته crypto/x509: محدودیت‌های مستثنا شده DNS به درستی بر دامنه‌های دارای نویسه عام (wildcard) اعمال نمی‌شد
.IP \[bu] 2
CVE-2026-27144: بسته cmd/compile: تبدیل بدون‌عمل (no-op) رابط، بررسی همپوشانی را دور می‌زند
.IP \[bu] 2
CVE-2026-27143: بسته cmd/compile: احتمال خرابی حافظه پس از حذف بررسی محدوده (bound check elimination)
.IP \[bu] 2
CVE-2026-32288: بسته archive/tar: تخصیص نامحدود حافظه هنگام تجزیه ساختار قدیمی نقشه تنک گنو (GNU sparse map)
.IP \[bu] 2
CVE-2026-32283: بسته crypto/tls: پیام‌های متعدد دست‌تکانی به‌روزرسانی کلید می‌تواند باعث بن‌بست اتصال شود
.IP \[bu] 2
CVE-2026-27140: بسته cmd/go: دور زدن لایه اعتماد هنگام استفاده از cgo و SWIG
.IP \[bu] 2
CVE-2026-32280: بسته crypto/x509: پردازش غیرمنتظره در حین ساخت زنجیره (chain building)
.IP \[bu] 2
CVE-2026-32281: بسته crypto/x509: اعتبارسنجی ناکارآمد خط‌مشی
.RE
.IP \[bu] 2
رفع اشکال منع سرویس (DoS) ناشی از Panic در EventStream Decoder از AWS SDK for Go v2 SDK (dependabot[bot])
.IP \[bu] 2
بروزرسانی golang.org/x/image به 0.38.0 برای رفع CVE-2026-33809 (dependabot[bot])
.RE
.IP \[bu] 2
docs
.RS 2
.IP \[bu] 2
اصلاح سطح سربرگ برای گزینه metadata (Clément Notin)
.IP \[bu] 2
رفع اشکالات markdown در مستندات mount (albertony)
.IP \[bu] 2
اصلاح پیوند به گونه‌ای که وابسته به زبان خاصی نباشد (Ross Smith II)
.IP \[bu] 2
اشاره به پشتیبانی از macOS 10.15 (Catalina) در نسخه v1.70.3 (kapitainsky)
.RE
.RE
.IP \[bu] 2
Filen
.RS 2
.IP \[bu] 2
بروزرسانی نسخه SDK (Enduriel)
.RE.SS v1.73.3 \- 2026-03-23
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.73.2...v1.73.3)
.IP \[bu] 2
رفع اشکالات
.RS 2
.IP \[bu] 2
ساخت
.RS 2
.IP \[bu] 2
به‌روزرسانی به google.golang.org/grpc 1.79.3 جهت رفع CVE-2026-33186
(dependabot[bot])
.IP \[bu] 2
به‌روزرسانی به github.com/buger/jsonparser 1.1.2 جهت رفع GHSA-6g7g-w4f8-9c9x
(dependabot[bot])
.RE
.IP \[bu] 2
اصلاحات مستندات
.RS 2
.IP \[bu] 2
افزودن متن به برچسب برای نمایش اطلاعات نسخه معرفی‌شده (Jan-Philipp
Reßler)
.IP \[bu] 2
شفاف‌سازی اینکه تغییر گذرواژه Filen نیازمند به‌روزرسانی گذرواژه و کلید API در پیکربندی rclone است (Jason)
.IP \[bu] 2
s3: شفاف‌سازی پشتیبانی چندمستأجری (multi tenant) برای Cubbit (Marco Ferretti)
.IP \[bu] 2
jottacloud: رفع پیوند خراب (albertony)
.RE
.IP \[bu] 2
lib/rest: رفع مشکل URLPathEscapeAll که باعث اختلال در سرورهای WebDAV (مانند nzbdav) با تطبیق دقیق مسیر می‌شد (Andrew Furman)
.IP \[bu] 2
list: رفع خطای panic ناشی از اشاره‌گر nil در Sorter هنگامی که ایجاد فایل موقت با شکست مواجه می‌شود
(Nick Craig-Wood)
.RE
.SS v1.73.2 \- 2026-03-06
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.73.1...v1.73.2)
.IP \[bu] 2
رفع اشکالات
.RS 2
.IP \[bu] 2
ساخت
.RS 2
.IP \[bu] 2
به‌روزرسانی به go 1.25.8 جهت رفع CVE-2026-27137 CVE-2026-27138 CVE-2026-25679
CVE-2026-27142 (Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی github.com/cloudflare/circl به v1.6.3 جهت رفع CVE-2026-1229 (Nick
Craig-Wood)
.IP \[bu] 2
به‌روزرسانی به golang.org/x/net v0.51.0 جهت رفع CVE-2026-27141 (Nick
Craig-Wood)
.RE
.IP \[bu] 2
اصلاحات مستندات:
.RS 2
.IP \[bu] 2
bisync: افزودن گروه Sync به دستور bisync (Jan-Philipp Reßler)
.IP \[bu] 2
تذکر اینکه --use-server-modtime فقط روی برخی بک‌اندها کار می‌کند (Nick
Craig-Wood)
.IP \[bu] 2
مستندسازی عدم پشتیبانی از کلیدهای شیء S3 با اسلش دوتایی (Adam Kasztenny)
.IP \[bu] 2
اصلاح سلسله‌مراتب سربرگ‌ها برای mount.md (Dark Dragon)
.IP \[bu] 2
رفع غلط تایپی گزینه جدید drive در گزارش تغییرات (razorloves)
.RE
.RE
.IP \[bu] 2
Archive
.RS 2
.IP \[bu] 2
Extract: رفع اشکال استخراج با پیشوند \[dq]./\[dq] از مسیرهای مدخل‌های فایل tar
(Varun Chawla)
.RE
.IP \[bu] 2
Drime
.RS 2
.IP \[bu] 2
رفع مشکل نادیده گرفته شدن شناسه workspace در فایل‌های آپلود شده به صورت قطعه‌ای (chunk-uploaded) (a1pcm)
.RE
.IP \[bu] 2
Internxt
.RS 2
.IP \[bu] 2
رفع خطاهای Entry doesn\[aq]t belong in directory در ویندوز (jzunigax2)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
گریزدهی (escape) نویسه‌های رزرو شده در بخش‌های مسیر URL (Varun Chawla)
.IP \[bu] 2
افزودن هدرهای ناموجود برای CORS (Romāns Potašovs)
.RE.SS v1.73.1 - 2026-02-17
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.73.0...v1.73.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting: رفع مشکل عدم نمایش آمار سمت سرور در core/stats rc (Nick
Craig-Wood)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
رفع CVE-2025-68121 با به‌روزرسانی go به 1.25.7 یا جدیدتر (Nick Craig-Wood)
.IP \[bu] 2
ارتقای github.com/go-chi/chi/v5 از 5.2.3 به 5.2.5 برای رفع GO-2026-4316
(albertony)
.RE
.IP \[bu] 2
docs: گسترش مستندات copyurl با افزودن مثالی از FILENAMEهای CSV که با یک مسیر
آغاز می‌شوند.
(Jack Kelly)
.IP \[bu] 2
march: رفع خطای runtime: program exceeds 10000-thread limit (Nick Craig-Wood)
.IP \[bu] 2
pacer
.RS 2
.IP \[bu] 2
رفع بن‌بست بین توکن pacer و --max-connections (Nick Craig-Wood)
.IP \[bu] 2
خواندن دوباره مدت زمان خواب (sleep time) از آنجا که ممکن است کهنه باشد (Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
Drime
.RS 2
.IP \[bu] 2
رفع مشکل ایجاد فایل‌ها و دایرکتوری‌ها در فضای کاری (workspace) پیش‌فرض (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Filelu
.RS 2
.IP \[bu] 2
جلوگیری از بافر کردن کل فایل در حافظه (kingston125)
.IP \[bu] 2
افزودن پشتیبانی از بارگذاری چندبخشی (multipart upload) با حد آستانه (cutoff) قابل پیکربندی (kingston125)
.RE
.IP \[bu] 2
Filen
.RS 2
.IP \[bu] 2
رفع مشکل عدم توانایی مقصدهای ۳۲ بیتی در فهرست کردن دایرکتوری‌ها (Enduriel)
.IP \[bu] 2
رفع panic بالقوه در صورت بروز خطا حین بارگذاری (Enduriel)
.RE
.IP \[bu] 2
Internxt
.RS 2
.IP \[bu] 2
پیاده‌سازی ورود مجدد ذیل منطق نوسازی (refresh)، بهبود منطق تلاش مجدد (José
Zúniga) -S3
.IP \[bu] 2
تنظیم list_version روی 2 برای پیکربندی FileLu S3 (kingston125)
.RE
.SS v1.73.0 - 2026-01-30
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.72.0...v1.73.0)
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
Shade (https://rclone.org/shade) (jhasse-shade)
.IP \[bu] 2
Drime (https://rclone.org/drime) (dougal)
.IP \[bu] 2
Filen (https://rclone.org/filen) (Enduriel)
.IP \[bu] 2
Internxt (https://rclone.org/internxt) (jzunigax2)
.IP \[bu] 2
ارائه‌دهندگان جدید S3
.RS 2
.IP \[bu] 2
Bizfly Cloud Simple Storage (https://rclone.org/s3/#bizflycloud)
(vupn0712)
.RE
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
docs: افزودن سطوح پشتیبانی (Support Tiers) (https://rclone.org/tiers) به مستندات
(Nick Craig-Wood)
.IP \[bu] 2
rc: افزودن
operations/hashsumfile (https://rclone.org/rc/#operations-hashsumfile)
جهت محاسبه هش تنها برای یک فایل (Nick Craig-Wood)
.IP \[bu] 2
serve webdav: پیاده‌سازی دانلود دایرکتوری به عنوان فایل Zip (Leo)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
fs: رفع مشکل bwlimit: گزارش‌دهی صحیح (Mikel Olasagasti Uranga)
.IP \[bu] 2
log: رفع مشکل اضافه شدن خط جدید اضافی توسط systemd (dougal)
.IP \[bu] 2
docs: اصلاحات (albertony, darkdragon-001, Duncan Smart, hyusap,
Marc-Philip, Nick Craig-Wood, vicerace, vyv03354, yuval-cloudinary, yy)
.IP \[bu] 2
serve s3: مهلک (fatal) کردن خطاهای \f[V]--s3-auth-key\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
رفع مشکل پشتیبانی از mount در OpenBSD.
(Nick Owens)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از متادیتا و تگ‌ها در مسیرهای بارگذاری و کپی (Cliff Frey)
.IP \[bu] 2
تفکیک احراز هویت مشترک در قالب یک کتابخانه (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azurefiles
.RS 2
.IP \[bu] 2
تفکیک احراز هویت مشترک در قالب یک کتابخانه (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
پشتیبانی از احراز هویت با کلیدهای برنامه‌ای جدید با دسترسی محدود به باکت
(DianaNites)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن گزینه \f[V]--drive-metadata-enforce-expansive-access\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
رفع کرش هنگام تلاش برای ایجاد میانبر به یک Google doc (Nick
Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از احراز هویت پراکسی http (Nicolas Dessart)
.RE
.IP \[bu] 2
Mega
.RS 2
.IP \[bu] 2
بازگردانی راهکار موقت TLS (necaran)
.RE
.IP \[bu] 2
Memory
.RS 2
.IP \[bu] 2
افزودن گزینه \f[V]--memory-discard\f[R] برای تست سرعت (Nick Craig-Wood)
.RE
.IP \[bu] 2
OneDrive
.RS 2
.IP \[bu] 2
رفع مشکل لغو بارگذاری چندبخشی (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل تنظیم زمان ویرایش روی دایرکتوری‌ها برای OneDrive Personal (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل عدم پشتیبانی OneDrive Personal از description (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل الزام به ورود به سیستم (require sign in) برای OneDrive Personal (Nick Craig-Wood).IP \[bu] 2
رفع مشکل مجوزها در OneDrive Personal (Nick Craig-Wood)
.RE
.IP \[bu] 2
Oracle Object Storage
.RS 2
.IP \[bu] 2
حذف تخصیص غیرضروری حافظه heap (Qingwei Li)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]ChangeNotify\f[R] برای فعال‌سازی به‌روزرسانی‌های بلادرنگ در
mount (masrlinu)
.RE
.IP \[bu] 2
Protondrive
.RS 2
.IP \[bu] 2
به‌روزرسانی برای استفاده از فورک‌های ماژول‌های بالادست به منظور رفع موانع توسعه (Nick
Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن قابلیت تعیین نقش IAM برای تعامل میان‌حسابی (cross-account)
(Vladislav Tropnikov)
.IP \[bu] 2
Linode: به‌روزرسانی endpointها برای استفاده از استاندارد ISO 3166-1 alpha-2
(jbagwell-akamai)
.IP \[bu] 2
رفع مشکل نادیده گرفتن storage class توسط Copy (vupn0712)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از احراز هویت پراکسی http (Nicolas Dessart)
.IP \[bu] 2
حذف تخصیص غیرضروری حافظه heap (Qingwei Li)
.RE
.SS v1.72.1 - 2025-12-10
.PP
مشاهدهٔ کامیت‌ها (https://github.com/rclone/rclone/compare/v1.72.0...v1.72.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
build: به‌روزرسانی به go1.25.5 برای رفع
CVE-2025-61729 (https://pkg.go.dev/vuln/GO-2025-4155)
.IP \[bu] 2
اصلاحات مستندات (Duncan Smart, Nick Craig-Wood)
.IP \[bu] 2
configfile: رفع مشکل پشتیبانی از پیکربندی پایپ‌شده (piped config) (Jonas Tingeborn)
.IP \[bu] 2
log
.RS 2
.IP \[bu] 2
رفع مشکل عدم درج PID در خروجی لاگ JSON (Tingsong Xu)
.IP \[bu] 2
رفع مشکل ارسال نشدن backtrace به \-\-log\-file (Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
بهبود مستندات پارامتر endpoint (Johannes Rothe)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن ناحیه‌های (regions) ناموجود برای ارائه‌دهنده Selectel (Nick Craig-Wood)
.RE
.SS v1.72.0 - 2025-11-21
.PP
مشاهدهٔ کامیت‌ها (https://github.com/rclone/rclone/compare/v1.71.0...v1.72.0)
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
بک‌اند Archive برای خواندن آرشیوها روی فضای ذخیره‌سازی ابری.
(Nick Craig-Wood)
.RE
.IP \[bu] 2
ارائه‌دهندگان جدید S3
.RS 2
.IP \[bu] 2
Cubbit Object Storage (https://rclone.org/s3/#Cubbit) (Marco Ferretti)
.IP \[bu] 2
FileLu S5 Object Storage (https://rclone.org/s3/#filelu-s5)
(kingston125)
.IP \[bu] 2
Hetzner Object Storage (https://rclone.org/s3/#hetzner) (spiffytech)
.IP \[bu] 2
Intercolo Object Storage (https://rclone.org/s3/#intercolo) (Robin Rolf)
.IP \[bu] 2
ذخیره‌سازی ابری امن سازگار با S3 شرکت Rabata
(https://rclone.org/s3/#Rabata) (dougal)
.IP \[bu] 2
Servercore Object Storage (https://rclone.org/s3/#servercore) (dougal)
.IP \[bu] 2
SpectraLogic (https://rclone.org/s3/#spectralogic) (dougal)
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
rclone archive (https://rclone.org/commands/rclone_archive): دستوری برای
ایجاد و خواندن فایل‌های آرشیو (Fawzib Rojas)
.IP \[bu] 2
rclone config
string (https://rclone.org/commands/rclone_config_string): برای ساخت
رشته‌های اتصال (Nick Craig-Wood)
.IP \[bu] 2
rclone test speed (https://rclone.org/commands/rclone_test_speed): افزودن
دستوری برای آزمایش سرعت ریموت مشخص‌شده (dougal)
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
backends: به بسیاری از بک‌اندها رابط فهرست‌بندی صفحه‌بندی‌شده (\f[V]ListP\f[R])
افزوده شد
.RS 2
.IP \[bu] 2
این امر امکان نمایش میزان پیشرفت هنگام فهرست کردن دایرکتوری‌های بزرگ و کاهش مصرف
حافظه را فراهم می‌آورد
.RE
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
ارتقای golang.org/x/crypto از 0.43.0 به 0.45.0 برای رفع CVE-2025-58181
(dependabot[bot])
.IP \[bu] 2
مدرن‌سازی کدها و آزمون‌ها (Nick Craig-Wood, russcoss, juejinyuxitu,
reddaisyy, dulanting, Oleksandr Redko)
.IP \[bu] 2
به‌روزرسانی تمامی وابستگی‌ها (Nick Craig-Wood)
.IP \[bu] 2
فعال‌سازی پشتیبانی از \f[V]aix/ppc64\f[R] (Lakshmi-Surekha)
.RE
.IP \[bu] 2
check: بهبود گزارش‌دهی تفاوت‌ها در اندازه‌ها و محتوا
(albertony)
.IP \[bu] 2
copyurl: افزودن \f[V]\-\-url\f[R] برای خواندن URLها از فایل CSV (S-Pegg1,
dougal)
.IP \[bu] 2
docs:
.RS 2
.IP \[bu] 2
بررسی انطباق نگارشی (linting) مارک‌داون (albertony)
.IP \[bu] 2
اصلاحات (albertony, Andrew Gunnerson, anon-pradip, Claudius Ellsel,
dougal, iTrooz, Jean-Christophe Cura, Joseph Brownlee, kapitainsky, Matt
LaPaglia, n4n5, Nick Craig-Wood, nielash, SublimePeace, Ted Robertson,
vastonus)
.RE
.IP \[bu] 2
fs: حذف فراخوانی غیرضروری Seek روی فایل لاگ (Aneesh Agrawal)
.IP \[bu] 2
hashsum: بهبود قالب خروجی هنگام فهرست کردن الگوریتم‌ها (albertony)
.IP \[bu] 2
lib/http: تمیزکاری دندانه‌گذاری و سایر فاصله‌های خالی در الگوی http serve
(albertony)
.IP \[bu] 2
lsf: افزودن پشتیبانی از قالب‌های زمانی \f[V]unix\f[R] و \f[V]unixnano\f[R]
(Motte)
.IP \[bu] 2
oauthutil: بهبود لاگ‌های اشکال‌زدایی در فرایند بازنشانی توکن (token refresh) (albertony)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن job/batch (https://rclone.org/rc/#job-batch) برای ارسال دسته‌ای دستورهای
rc جهت اجرای هم‌زمان (Nick Craig-Wood).IP \[bu] 2
افزودن \f[V]runningIds\f[R] و \f[V]finishedIds\f[R] به
job/list (https://rclone.org/rc/#job-list) (n4n5)
.IP \[bu] 2
افزودن \f[V]osVersion\f[R]، \f[V]osKernel\f[R] و \f[V]osArch\f[R] به
core/version (https://rclone.org/rc/#core-version) (Nick Craig-Wood)
.IP \[bu] 2
اطمینان از اینکه خطاهای مهلک اجرا شده از طریق rc باعث از کار افتادن rclone نمی‌شوند (Nick
Craig-Wood)
.IP \[bu] 2
افزودن \f[V]executeId\f[R] به وضعیت کارها در
job/list (https://rclone.org/rc/#job-list) (Nikolay Kiryanov)
.IP \[bu] 2
\f[V]config/unlock\f[R]: تغییر نام پارامتر به \f[V]configPassword\f[R]
و همچنین پذیرش نام قدیمی (Nick Craig-Wood)
.RE
.IP \[bu] 2
serve http: دانلود پوشه‌ها به صورت zip (dougal)
.RE
.IP \[bu] 2
رفع اشکال‌ها
.RS 2
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
رفع خطای tls: failed to verify certificate: x509: negative serial number
(Nick Craig-Wood)
.RE
.IP \[bu] 2
march
.RS 2
.IP \[bu] 2
رفع مشکل کندی شدید \f[V]--no-traverse\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
serve s3: اصلاح خروجی لاگ جهت حذف پیام‌های EXTRA (iTrooz)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
Windows: بهبود پیام خطا در صورت عدم وجود WinFSP (divinity76)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
افزودن \f[V]--skip-specials\f[R] برای نادیده گرفتن فایل‌های خاص (Adam Dinwoodie)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
افزودن رابط ListP (dougal)
.RE
.IP \[bu] 2
Azurefiles
.RS 2
.IP \[bu] 2
افزودن رابط ListP (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
افزودن رابط ListP (dougal)
.IP \[bu] 2
افزودن پشتیبانی از رمزنگاری سمت سرور (fries1234)
.IP \[bu] 2
رفع خطای \[dq]expected a FileSseMode but found: \[aq]\[aq]\[dq] (dougal)
.IP \[bu] 2
امکان حذف مجزای نسخه‌های قدیمی با \f[V]--b2-versions\f[R]
(dougal)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
افزودن رابط ListP (Nick Craig-Wood)
.IP \[bu] 2
امکان پیکربندی با محتوای فایل پیکربندی (Dominik Sander)
.RE
.IP \[bu] 2
Compress
.RS 2
.IP \[bu] 2
افزودن فشرده‌سازی zstd (Alex)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن رابط ListP (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
افزودن رابط ListP (Nick Craig-Wood)
.IP \[bu] 2
رفع خطا هنگام جابه‌جایی اشیاء تازه‌ساخته‌شده (Nick Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
اصلاح پشتیبانی از پراکسی SOCKS (dougal)
.IP \[bu] 2
اصلاح انتقال‌ها از سرورهایی که پیام 250 ok برمی‌گردانند (jijamik)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
افزودن رابط ListP (dougal)
.IP \[bu] 2
اصلاح \f[V]--gcs-storage-class\f[R] جهت کار با کپی سمت سرور برای
اشیاء (Riaz Arbi)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
افزودن فراداده پایه و ارائه آن از طریق serve (Oleg Kunitsyn)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از Let\[aq]s Go Cloud (از MediaMarkt) به‌عنوان سرویس
whitelabel (albertony)
.IP \[bu] 2
افزودن پشتیبانی از MediaMarkt Cloud به‌عنوان سرویس whitelabel (albertony)
.IP \[bu] 2
افزودن پشتیبانی از احراز هویت سنتی oauth برای سرویس اصلی نیز
(albertony)
.IP \[bu] 2
لغو تلاش‌ها برای اجرای دستور پشتیبانی‌نشده rclone authorize (albertony)
.IP \[bu] 2
بهبود مدیریت تازه‌سازی توکن (albertony)
.IP \[bu] 2
رفع مشکل احراز هویت قدیمی (legacy) (albertony)
.IP \[bu] 2
اصلاح احراز هویت برای سرویس‌های whitelabel از شرکت‌های تابعه Elkjøp
(albertony)
.RE
.IP \[bu] 2
Mega
.RS 2
.IP \[bu] 2
پیاده‌سازی ورود با احراز هویت دومرحله‌ای (2FA) (iTrooz)
.RE
.IP \[bu] 2
Memory
.RS 2
.IP \[bu] 2
افزودن رابط ListP (dougal)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
افزودن رابط ListP (Nick Craig-Wood)
.RE
.IP \[bu] 2
Oracle Object Storage
.RS 2
.IP \[bu] 2
افزودن رابط ListP (dougal)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
افزودن رابط ListP (Nick Craig-Wood)
.RE
.IP \[bu] 2
Proton Drive
.RS 2.IP \[bu] 2
ورود خودکار 2FA با کلید محرمانه OTP (Microscotch)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
ساده‌تر کردن افزودن ارائه‌دهندگان جدید S3 (dougal)
.IP \[bu] 2
افزودن سازگاری (quirk) \f[V]--s3-use-data-integrity-protections\f[R] برای رفع خطای
BadDigest در Alibaba و Tencent (hunshcn)
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--upload-header\f[R]، \f[V]If-Match\f[R] و
\f[V]If-None-Match\f[R] (Sean Turner)
.IP \[bu] 2
رفع رفتار کپی تک‌فایل با دسترسی پایین (hunshcn)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
رفع فرایندهای زامبی SSH با \f[V]--sftp-ssh\f[R] (Copilot)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
بهینه‌سازی کارایی اتصال smb با اجتناب از بررسی‌های stat در حین
مقداردهی اولیه (Sudipto Baral)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
افزودن رابط ListP (dougal)
.IP \[bu] 2
اگر storage_policy تنظیم نشده باشد، از خط‌مشی کانتینرهای ریشه استفاده شود (Andrew
Ruthven)
.IP \[bu] 2
گزارش مصرف دیسک در کانتینرهای segment (Andrew Ruthven)
.RE
.IP \[bu] 2
Ulozto
.RS 2
.IP \[bu] 2
پیاده‌سازی قابلیت About (Lukas Krejci)
.IP \[bu] 2
رفع بازگرداندن صفحه خطای HTML در بارگیری‌ها (aliaj1)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
بهینه‌سازی دریافت bearer token با singleflight (hunshcn)
.IP \[bu] 2
افزودن رابط ListP (Nick Craig-Wood)
.IP \[bu] 2
استفاده از SpaceSepList برای تجزیه دستور bearer token (hunshcn)
.IP \[bu] 2
افزودن سرآیند \f[V]Access-Control-Max-Age\f[R] برای کش‌کردن پیش‌درخواست‌های CORS
(viocha)
.IP \[bu] 2
رفع کمبود حافظه با sharepoint-ntlm هنگام بارگذاری فایل‌های بزرگ (Nick
Craig-Wood)
.RE
.SS v1.71.2 - 2025-10-20
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.71.1...v1.71.2)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
به‌روزرسانی Go به 1.25.3
.IP \[bu] 2
به‌روزرسانی نسخه Alpine تصویر Docker برای رفع CVE-2025-9230
.RE
.IP \[bu] 2
bisync: رفع شرایط رقابتی هنگام استفاده هم‌زمان از CaptureOutput (Nick
Craig-Wood)
.IP \[bu] 2
اصلاحات مستندات (albertony, dougal, iTrooz, Matt LaPaglia, Nick Craig-Wood)
.IP \[bu] 2
index: افزودن ارائه‌دهندگان از قلم‌افتاده (dougal)
.IP \[bu] 2
serve http: رفع باگ: ثبت نشانی (URL) در لاگ هنگام شروع (dougal)
.RE
.IP \[bu] 2
Azurefiles
.RS 2
.IP \[bu] 2
رفع عدم انتظار رونوشت سمت سرور برای تکمیل فرایند (Vikas Bhansali)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
رفع بارگذاری‌های بالای 1TB (dougal)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
افزودن منطقه us-east5 (Dulani Woods)
.RE
.IP \[bu] 2
Mega
.RS 2
.IP \[bu] 2
رفع خطاهای 402 payment required (Nick Craig-Wood)
.RE
.IP \[bu] 2
Pikpak
.RS 2
.IP \[bu] 2
رفع تلاش‌های مجدد غیرضروری با استفاده از پارامتر expire در URL (Youfu Zhang)
.RE.SS v1.71.1 - 2025-09-24
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.71.0...v1.71.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
bisync: رفع مدیریت خطا برای تداخل‌های تغییرنام‌یافته (nielash)
.IP \[bu] 2
march: رفع بن‌بست هنگام استفاده از --fast-list در همگام‌سازی‌ها (Nick Craig-Wood)
.IP \[bu] 2
operations: رفع تداخل نسبی نام‌ها برای کپی‌های غیر --inplace (Nick
Craig-Wood)
.IP \[bu] 2
pacer: رفع بن‌بست با --max-connections (Nick Craig-Wood)
.IP \[bu] 2
اصلاحات مستندات (albertony, anon-pradip, Claudius Ellsel, dougal,
Jean-Christophe Cura, Nick Craig-Wood, nielash)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
عدم ثبت unmount موفقیت‌آمیز به عنوان خطا در گزارش (Tilman Vogel)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع مشکل خاتمه یافتن serve توسط SIGHUP به جای تخلیه حافظه پنهان دایرکتوری‌ها (dougal)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع خطای \[dq]Access is denied\[dq] دستور rmdir در windows (nielash)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
رفع مشکل about پس از تغییر در مقدار بازگشتی API (Nick Craig-Wood)
.RE
.IP \[bu] 2
Combine
.RS 2
.IP \[bu] 2
انتشار قابلیت SlowHash (skbeh)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
به‌روزرسانی دستورالعمل‌های ایجاد client ID اختصاصی (Ed Craig-Wood)
.RE
.IP \[bu] 2
Internet Archive
.RS 2
.IP \[bu] 2
رفع مشکل کپی سمت سرور برای فایل‌های دارای فاصله (Nick Craig-Wood)
.RE
.SS v1.71.0 - 2025-08-22
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.70.0...v1.71.0)
.IP \[bu] 2
ارائه‌دهندگان جدید S3
.RS 2
.IP \[bu] 2
Exaba (https://rclone.org/s3/#exaba) (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
ما با Exaba همکاری داشته‌ایم و آن‌ها از کاربران پیشگام،
میزبان‌های شخصی و آزمایش‌کنندگان استقبال می‌کنند
.RE
.IP \[bu] 2
OVHcloud Object Storage (https://rclone.org/s3/#ovhcloud) (Florent
Vennetier)
.IP \[bu] 2
Zata (https://rclone.org/s3/#Zata) ($\[at]M\[at]RTH_)
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
امکان بازنویسی یا تعیین پیکربندی سراسری هنگام ایجاد backend (https://rclone.org/docs/#globalconfig) (Nick Craig-Wood)
.IP \[bu] 2
bisync: ارتقا از نسخه آزمایشی (beta) به پایدار (stable) (nielash)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
به‌روزرسانی به go1.25 و تعیین go1.24 به عنوان حداقل نسخه مورد نیاز (Nick
Craig-Wood)
.IP \[bu] 2
به‌روزرسانی تمامی وابستگی‌ها (Nick Craig-Wood)
.IP \[bu] 2
ارتقای golangci-lint به نسخه v2 و اصلاح کد و پیکربندی (albertony)
.IP \[bu] 2
افزودن اعتبارسنجی markdown به گردش‌کار و اصلاح تمامی مستندات (albertony)
.IP \[bu] 2
گسترش بررسی ویرایش فایل‌های تولید خودکار به تمامی کامیت‌ها در یک pull request (albertony)
.IP \[bu] 2
تعیین شل پیش‌فرض روی bash در build.yml (Ross Smith II)
.RE
.IP \[bu] 2
config
.RS 2
.IP \[bu] 2
یکپارچه‌سازی تجزیه گزینه‌های \f[V]Duration\f[R] (albertony)
.IP \[bu] 2
افزودن خطا در صورت مشخص شدن \f[V]RCLONE_CONFIG_PASS\f[R] اما عدم
رمزگشایی پیکربندی (n4n5)
.RE
.IP \[bu] 2
copy, copyto: پیاده‌سازی پرچم‌های گزارش‌گیر برای ذخیره نتیجه همگام‌سازی (Marvin
Rösch)
.IP \[bu] 2
اصلاحات مستندات (albertony, Ali Zein Yousuf, Binbin Qian, curlwget, Ed
Craig-Wood, jinjingroad, Lucas Bremgartner, n4n5, Nick Craig-Wood)
.IP \[bu] 2
hash: افزودن پشتیبانی از BLAKE3, XXH3, XXH128 (albertony)
.IP \[bu] 2
http
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--client-pass\f[R] برای فایل‌های \f[V]--client-key\f[R]
رمزگذاری‌شده (Nick Craig-Wood)
.IP \[bu] 2
امکان تنظیم \f[V]--http-proxy\f[R] از طریق خط فرمان (Nick
Craig-Wood)
.RE
.IP \[bu] 2
lib/mmap: تبدیل به استفاده از unsafe.Slice جهت پرهیز از به‌کارگیری
reflect.SliceHeader منسوخ‌شده (cui)
.IP \[bu] 2
lib/transform: پرهیز از ورودی خالی در charmap (albertony)
.IP \[bu] 2
log: افزودن گزینه‌های چرخش گزارش هنگام استفاده از
\f[V]--log-file\f[R] (https://rclone.org/docs/#log-file-string) (Nick
Craig-Wood)
.IP \[bu] 2
move, moveto: پیاده‌سازی پرچم‌های گزارش‌گیر برای ذخیره نتیجه همگام‌سازی (Marvin
Rösch)
.IP \[bu] 2
pool: یکپارچه‌سازی حافظه میان multipart و asyncreader جهت استفاده از یک pool واحد
(Nick Craig-Wood)
.IP \[bu] 2
purge: خروج با خطای مهلک در صورت مشخص بودن فیلترها روی
\f[V]rclone purge\f[R] (Nick Craig-Wood)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن \f[V]config/unlock\f[R] برای باز کردن قفل فایل پیکربندی (n4n5)
.IP \[bu] 2
اصلاح \f[V]config/listremotes\f[R] برای ارسال یک آرایه خالی به جای nil
(n4n5)
.IP \[bu] 2
مقداردهی عکس لحظه‌ای انتقال با مقدار \[dq]what\[dq] (Timothy Jacobs)
.RE
.IP \[bu] 2
serve sftp: افزودن پشتیبانی از مقادیر هش بیشتر (crc32, sha256, blake3, xxh3,
xxh128) (albertony)
.IP \[bu] 2
transform: افزودن \f[V]truncate_keep_extension\f[R] و
\f[V]truncate_bytes\f[R] (nielash)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
about: رفع سرریز احتمالی about در backendهای مختلف (Nick
Craig-Wood)
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
رفع آمارهای نادرست با \f[V]--transfers=1\f[R] (Yu Xin).IP \[bu] 2
رفع مشکل آمار (\f[V]speed=0\f[R] و \f[V]eta=nil\f[R]) هنگام شروع کارها از
طریق rc (Nick Craig-Wood)
.RE
.IP \[bu] 2
bisync
.RS 2
.IP \[bu] 2
رفع مشکل اجراهای هم‌روند از طریق rc (nielash)
.IP \[bu] 2
رفع تنظیمات \f[V]--no-slow-hash\f[R] روی path2 (nielash)
.RE
.IP \[bu] 2
config: رفع مشکل خواندن توکن‌های پیست‌شدهٔ بیش از ۴۰۹۵ بایت (Nick
Craig-Wood)
.IP \[bu] 2
oauthutil: رفع خرابی ناشی از اشاره‌گر تهی (nil pointer) هنگام شروع با توکن
منقضی‌شده (Nick Craig-Wood)
.IP \[bu] 2
operations: رفع باز ماندن بیش از حد اتصالات هنگام استفاده از
\f[V]--max-buffer-memory\f[R] (Nick Craig-Wood)
.IP \[bu] 2
pool: رفع بن‌بست (deadlock) در صورت استفاده هم‌زمان از
\f[V]--max-buffer-memory\f[R] و انتقال‌های چندبخشی (Nick Craig-Wood)
.IP \[bu] 2
rc: رفع مشکل نادیده گرفتن پارامتر \f[V]oneWay\f[R] توسط
\f[V]operations/check\f[R] (houance)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
رفع مشکل شناسایی پیوندهای نمادین در فهرست‌بندی دایرکتوری‌ها (huangnauh)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
قابلیت پیکربندی هش‌های پشتیبانی‌شده (albertony)
.IP \[bu] 2
رفع مشکل \f[V]--copy-links\f[R] در Windows هنگام فهرست‌بندی Junction pointها
(Anagh Kumar Baranwal)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از احراز هویت مبتنی بر client assertion (Vikas Bhansali)
.IP \[bu] 2
رفع بن‌بست هنگام استفاده از \f[V]--max-connections\f[R] همراه با خطاهای
\f[V]InvalidBlockOrBlob\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع محاسبهٔ مضاعف در بارگذاری‌های چندبخشی (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azurefiles
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از احراز هویت مبتنی بر client assertion (Vikas Bhansali)
.IP \[bu] 2
رفع پاک شدن هش هنگام تنظیم modtime (nielash)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
رفع خطای about: cannot unmarshal number 1.0e+18 into Go struct field (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Combine
.RS 2
.IP \[bu] 2
رفع خطاهای عدم یافتن دایرکتوری در رابط ListP (Nick Craig-Wood)
.RE
.IP \[bu] 2
Filescom
.RS 2
.IP \[bu] 2
مستندسازی نیاز به فعال‌سازی هش‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
مجاز کردن الگوریتم‌های رمزنگاری ناامن TLS (Anagh Kumar Baranwal)
.IP \[bu] 2
تنظیم پیش‌فرض پیکربندی TLS بر روی پیکربندی سراسری TLS (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
این تغییر امکان استفاده از \f[V]--ca-cert\f[R]، \f[V]--client-cert\f[R] و غیره
را فراهم می‌کند.
.IP \[bu] 2
همچنین امکان استفاده از \f[V]override.ca_cert = XXX\f[R] در فایل پیکربندی
فراهم می‌شود.
.RE
.RE
.IP \[bu] 2
Googlephotos
.RS 2
.IP \[bu] 2
افزودن هشدار برای اصلاحات سازگاری Google Photos (raider13209)
.RE
.IP \[bu] 2
Imagekit
.RS 2
.IP \[bu] 2
بازگرداندن خطای صحیح هنگام تلاش برای بارگذاری فایل‌های با طول صفر (Nick
Craig-Wood)
.IP \[bu] 2
عدم تلاش مجدد در سطح پایین برای بارگذاری‌ها (Nick Craig-Wood)
.IP \[bu] 2
حذف متد Copy سمت سرور به دلیل انجام بارگیری و بارگذاری (Nick Craig-Wood)
.RE
.IP \[bu] 2
Internetarchive
.RS 2
.IP \[bu] 2
رفع مشکل کپی سمت سرور فایل‌های حاوی \f[V]&\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Mega
.RS 2
.IP \[bu] 2
رفع شکست در دست‌تکانی TLS (necaran)
.RE
.IP \[bu] 2
Oracleobjectstorage
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از فراداده‌های فقط‌خواندنی (praveen-solanki-oracle)
.RE
.IP \[bu] 2
Pikpak
.RS 2
.IP \[bu] 2
بازنویسی بارگذاری برای دور زدن مدیریت‌کنندهٔ AWS S3 (wiserain)
.IP \[bu] 2
بهبود Move برای مدیریت بهتر خطاها و تداخل نام‌ها (wiserain)
.IP \[bu] 2
بهبود متد Copy برای مدیریت تداخل نام‌ها و ارتقای مدیریت خطا (wiserain)
.IP \[bu] 2
افزودن بررسی یکپارچگی نام فایل در حین بارگذاری (wiserain)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--s3-use-arn-region\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع نشت حافظه با شبیه‌سازی رشته‌ها (liubingrun)
.IP \[bu] 2
رفع مشکل بارگذاری چندبخشی و کپی سمت سرور هنگام استفاده از سیاست باکت
SSE-C (Albin Parou)
.IP \[bu] 2
رفع مشکل \f[V]Content-Type: aws-chunked\f[R] که با \f[V]--metadata\f[R]
باعث خطای بارگذاری می‌شد (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از هش‌های بیشتر (crc32، sha256، blake3، xxh3، xxh128)
(albertony)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
افزودن گزینهٔ \f[V]--smb-kerberos-ccache\f[R] برای تنظیم ccache مربوط به
kerberos به ازای هر بک‌اند smb (Sudipto Baral)
.IP \[bu] 2
تازه‌سازی اعتبارنامه‌های Kerberos هنگام تغییر فایل ccache (Sudipto Baral)
.IP \[bu] 2
بهبود عملکرد بارگذاری چندریسمانی با استفاده از چندین اتصال (Sudipto
Baral)
.RE.SS v1.70.3 - 2025-07-09
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.70.2...v1.70.3)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
check: رفع مشکل گزارش تفاوت‌ها (به‌اشتباه تعداد خطاها را گزارش می‌کرد) (albertony)
.IP \[bu] 2
march: رفع بن‌بست هنگام استفاده از \f[V]--no-traverse\f[R] (Nick Craig-Wood)
.IP \[bu] 2
اصلاحات مستندات (albertony, Nick Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
رفع خطای کپی سمت سرور \[dq]requires exactly one scope\[dq] (Nick
Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
رفع مشکل یافتن اشیاء هنگام استفاده از \f[V]--b2-version-at\f[R] (Davide
Bizzarri)
.RE
.IP \[bu] 2
Linkbox
.RS 2
.IP \[bu] 2
رفع خطای بارگذاری \[dq]user upload file not exist\[dq] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Pikpak
.RS 2
.IP \[bu] 2
بهبود مدیریت خطا برای پیوندهای ناموجود و خطاهای غیرقابل‌بازیابی 500
(wiserain)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
رفع اشکال تنظیم modtime به زمان شیء محلی به‌جای شیء راه دور
(WeidiDeng)
.RE
.SS v1.70.2 - 2025-06-27
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.70.1...v1.70.2)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
convmv: کاهش پیام‌های اضافی و شلوغی لاگ در --dry-run (nielash)
.IP \[bu] 2
sync: جلوگیری از کپی کردن متادیتای پوشه روی خودش (nielash)
.IP \[bu] 2
build: ارتقای github.com/go-chi/chi/v5 از 5.2.1 به 5.2.2 جهت رفع
GHSA-vrw8-fxc6-2r93 (dependabot[bot])
.IP \[bu] 2
convmv: رفع مشکل انتقال به نام معادل یونیکد (nielash)
.IP \[bu] 2
log: رفع بن‌بست هنگام استفاده از ثبت وقایع با systemd (Nick Craig-Wood)
.IP \[bu] 2
pacer: رفع خطای nil pointer deref در RetryError (Nick Craig-Wood)
.IP \[bu] 2
اصلاحات مستندات (Ali Zein Yousuf, Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع مشکل --skip-links در Windows هنگام نادیده‌گرفتن Junction pointها (Nick
Craig-Wood)
.RE
.SS v1.70.1 - 2025-06-19
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.70.0...v1.70.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
convmv: رفع خطای کاذب \[dq]error running command echo\[dq] در Windows
(Nick Craig-Wood)
.IP \[bu] 2
اصلاحات مستندات (albertony, Ed Craig-Wood, jinjingroad)
.RE.SS v1.70.0 - 2025-06-17
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.69.0...v1.70.0)
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
DOI (https://rclone.org/doi) (Flora Thiebaut)
.IP \[bu] 2
FileLu (https://rclone.org/filelu) (kingston125)
.IP \[bu] 2
ارائه‌دهندگان جدید S3:
.RS 2
.IP \[bu] 2
MEGA S4 (https://rclone.org/s3#mega) (Nick Craig-Wood)
.IP \[bu] 2
Pure Storage FlashBlade (https://rclone.org/s3#pure-storage-flashblade)
(Jeremy Daer)
.RE
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
convmv (https://rclone.org/commands/rclone_convmv): برای جابه‌جایی و
دگرگون‌سازی فایل‌ها (nielash)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
افزودن
\f[V]--max-connections\f[R] (https://rclone.org/docs#max-connections-n)
جهت کنترل حداکثر همزمانی بک‌اند (Nick Craig-Wood)
.IP \[bu] 2
افزودن
\f[V]--max-buffer-memory\f[R] (https://rclone.org/docs#max-buffer-memory)
جهت محدود کردن کل حافظه بافر مصرفی (Nick Craig-Wood)
.IP \[bu] 2
افزودن کتابخانه transform و پرچم
\f[V]--name-transform\f[R] (https://rclone.org/docs#name-transform-stringarray)
(nielash)
.IP \[bu] 2
sync: پیاده‌سازی
\f[V]--list-cutoff\f[R] (https://rclone.org/docs#list-cutoff) جهت امکان
مرتب‌سازی روی دیسک به منظور کاهش مصرف حافظه (Nick Craig-Wood)
.IP \[bu] 2
accounting: افزودن آمار فهرست‌شده برای تعداد مدخل‌های فهرست‌شده پوشه (Nick
Craig-Wood)
.IP \[bu] 2
backend: صرف‌نظر از محاسبه درهم‌سازی در صورت None بودن hashType (Oleksiy
Stashok)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
بروزرسانی به go1.24 و تعیین go1.22 به عنوان حداقل نسخه مورد نیاز (Nick
Craig-Wood)
.IP \[bu] 2
غیرفعال‌سازی ساخت‌های docker در PRها و افزودن تغییرات جاافتاده در dockerfile (Anagh
Kumar Baranwal)
.IP \[bu] 2
مدرن‌سازی شیوه‌های استفاده از Go (Nick Craig-Wood)
.IP \[bu] 2
بروزرسانی تمام وابستگی‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
cmd/authorize: نمایش آرگومان‌های لازم در متن راهنما (simwai)
.IP \[bu] 2
cmd/config: افزودن گزینه \f[V]--no-output\f[R] (Jess)
.IP \[bu] 2
cmd/gitannex
.RS 2
.IP \[bu] 2
بهبود تجزیه پیکربندی \[dq]rcloneremotename\[dq] (Dan McArdle)
.IP \[bu] 2
مجاز دانستن ریموت‌ها به همراه گزینه‌ها (Dan McArdle)
.IP \[bu] 2
رد حالت‌های طرح‌بندی ناشناخته در INITREMOTE (Dan McArdle)
.RE
.IP \[bu] 2
docker image: افزودن برچسب org.opencontainers.image.source برای یادداشت‌های
انتشار در به‌روزرسانی‌های وابستگی Renovate (Robin Schneider)
.IP \[bu] 2
اصلاحات مستندات (albertony, Andrew Kreimer, Ben Boeckel, Christoph Berger,
Danny Garside, Dimitri Papadopoulos, eccoisle, Ed Craig-Wood, Fernando
Fernández, jack, Jeff Geerling, Jugal Kishore, kingston125, luzpaz,
Markus Gerstel, Matt Ickstadt, Michael Kebe, Nick Craig-Wood,
PrathameshLakawade, Ser-Bul, simonmcnair, Tim White, Zachary Vorhies)
.IP \[bu] 2
filter:
.RS 2
.IP \[bu] 2
افزودن \f[V]--hash-filter\f[R] برای انتخاب قطعی زیرمجموعه‌ای از
فایل‌ها (Nick Craig-Wood)
.IP \[bu] 2
نمایش \f[V]--min-size\f[R] و \f[V]--max-size\f[R] در فیلترهای \f[V]--dump\f[R]
(Nick Craig-Wood)
.RE
.IP \[bu] 2
hash: افزودن پشتیبانی از SHA512 برای درهم‌سازی فایل‌ها (Enduriel)
.IP \[bu] 2
http servers: افزودن \f[V]--user-from-header\f[R] جهت استفاده برای احراز هویت
(Moises Lima)
.IP \[bu] 2
lib/batcher: منسوخ کردن گزینه استفاده‌نشده: batch_commit_timeout (Dan McArdle)
.IP \[bu] 2
log:
.RS 2
.IP \[bu] 2
حذف github.com/sirupsen/logrus و جایگزینی با log/slog (Nick
Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--windows-event-log-level\f[R] برای پشتیبانی از Windows Event Log
(Nick Craig-Wood)
.RE
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن پارامتر \f[V]short\f[R] به \f[V]core/stats\f[R] برای بازنگرداندن
transferring و checking (Nick Craig-Wood)
.IP \[bu] 2
در \f[V]options/info\f[R]، قرار دادن یک \[dq].\[dq] در صورت تودرتو
بودن FieldName (Nick Craig-Wood)
.IP \[bu] 2
افزودن کنترل rc برای دستورهای serve (Nick Craig-Wood)
.IP \[bu] 2
rcserver: بهبود بررسی content-type (Jonathan Giannuzzi)
.RE
.IP \[bu] 2
serve nfs
.RS 2
.IP \[bu] 2
بروزرسانی مستندات برای یادآوری عدم پشتیبانی از Windows (Zachary Vorhies)
.IP \[bu] 2
تغییر قالب دستگیره‌های فایل مربوط به \f[V]--nfs-cache-type symlink\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
تخصیص دستگیره‌های فایل ویژه به فایل‌های فراداده (Nick Craig-Wood)
.RE
.IP \[bu] 2
touch: واداشتن touch به پیروی از \f[V]--transfers\f[R] (Nick Craig-Wood)
.IP \[bu] 2
version: افزودن پرچم \f[V]--deps\f[R] برای نمایش وابستگی‌ها و سایر اطلاعات
ساخت (Nick Craig-Wood)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
serve s3:
.RS 2
.IP \[bu] 2
اصلاح پاسخ ListObjectsV2 (fhuber)
.IP \[bu] 2
حذف مقداردهی اولیه اضافی گرداننده (Tho Neyugn)
.RE
.IP \[bu] 2
stats: رفع نشت goroutine و بهبود فرآیند ثبت آمار
(Nathanael Demacon)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
افزودن \f[V]--vfs-metadata-extension\f[R] برای نمایش فایل‌های جانبی فراداده
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از سرآیند \f[V]x-ms-tags\f[R] (Trevor Starick)
.IP \[bu] 2
پاک‌سازی بلوک‌های تثبیت‌نشده هنگام بروز خطاهای بارگذاری (Nick Craig-Wood)
.IP \[bu] 2
افزایش سرعت کپی‌های سمت سرور برای فایل‌های کوچک (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی کپی چندبخشی سمت سرور (Nick Craig-Wood).IP \[bu] 2
حذف بلوک‌های تاییدنشده هنگام خطای InvalidBlobOrBlock (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل مدیریت اشیاء دارای // (Nick Craig-Wood)
.IP \[bu] 2
مدیریت دقیق‌تر کدهای خطای نیازمند تلاش مجدد (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل عدم تلاش مجدد برای خطاها هنگام انجام رونوشت تک‌بخشی (Nick
Craig-Wood)
.IP \[bu] 2
اصلاح رونوشت‌های چندبخشی سمت سرور برای فایل‌های با اندازه 0 (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azurefiles
.RS 2
.IP \[bu] 2
افزودن \f[V]--azurefiles-use-az\f[R] و
\f[V]--azurefiles-disable-instance-discovery\f[R] (b-wimmer)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
افزودن مدیریت SkipDestructive به دستورهای backend (Pat Patterson)
.IP \[bu] 2
استفاده از شناسه فایل از فهرست در صورت ارائه نشدن در سرآیندها (ahxxm)
.RE
.IP \[bu] 2
Cloudinary
.RS 2
.IP \[bu] 2
افزودن/حذف خودکار پسوند فایل‌های چندرسانه‌ای شناخته‌شده (yuval-cloudinary)
.IP \[bu] 2
قرارداد نام‌گذاری متغیرها (yuval-cloudinary)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن دستور \f[V]backend moveid\f[R] (Spencer McCullough)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
پشتیبانی از Dropbox Paper (Dave Vasilevsky)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
افزودن \f[V]--ftp-http-proxy\f[R] برای اتصال از طریق پراکسی HTTP CONNECT
.RE
.IP \[bu] 2
Gofile
.RS 2
.IP \[bu] 2
به‌روزرسانی برای استفاده از نقطه پایانی جدید بارگذاری مستقیم (wbulot)
.RE
.IP \[bu] 2
Googlephotos
.RS 2
.IP \[bu] 2
به‌روزرسانی محدوده‌های دسترسی فقط‌خواندنی و خواندن/نوشتن برای انطباق با الزامات
Google.
(Germán Casares)
.RE
.IP \[bu] 2
Iclouddrive
.RS 2
.IP \[bu] 2
رفع اشکال panic و احتمال دانلود دوباره فایل‌ها (Clément Wehrung)
.RE
.IP \[bu] 2
Internetarchive
.RS 2
.IP \[bu] 2
افزودن \f[V]--internetarchive-metadata=\[dq]key=value\[dq]\f[R] برای تنظیم
متاداده‌های مورد (Corentin Barreau)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
رفع خطاهای \[dq]The upload session was not found\[dq] (Nick Craig-Wood)
.IP \[bu] 2
افزودن مجدد پرچم \f[V]--onedrive-upload-cutoff\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال کرش در صورت به‌روزرسانی نشدن هیچ متاداده‌ای (Nick Craig-Wood)
.RE
.IP \[bu] 2
Opendrive
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--opendrive-access\f[R] برای مدیریت مجوزها (Joel K
Biju)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
رفع خطای \[dq]Access denied.
You do not have permissions to perform this operation\[dq] در بارگذاری‌های
حجیم (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع مشکل مدیریت اشیاء دارای // (Nick Craig-Wood)
.IP \[bu] 2
افزودن امضاکننده IBM IAM (Alexander Minbaev)
.IP \[bu] 2
تفکیک رفتارهای خاص GCS به \f[V]--s3-use-x-id\f[R] و
\f[V]--s3-sign-accept-encoding\f[R] (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی رابط فهرست‌بندی صفحه‌بندی‌شده ListP (Nick Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی از ارائه‌دهنده Pure Storage FlashBlade (Jeremy Daer)
.IP \[bu] 2
نیاز به نقطه پایانی سفارشی برای پشتیبانی از Lyve Cloud v2 (PrathameshLakawade)
.IP \[bu] 2
پشتیبانی از MEGA S4 (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن \f[V]--sftp-http-proxy\f[R] برای اتصال از طریق پراکسی HTTP CONNECT (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از احراز هویت kerberos (Jonathan Giannuzzi)
.IP \[bu] 2
بهبود کارایی تجمیع اتصالات (Jonathan Giannuzzi)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
تلاش مجدد propfind در وضعیت 425 (Jörn Friedrich Dreyer)
.IP \[bu] 2
افزودن ارائه‌دهنده ownCloud Infinite Scale برای فعال‌سازی پشتیبانی از بارگذاری تکه‌تکه‌ای
tus (Klaas Freitag)
.RE.SS v1.69.3 - 2025-05-21
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.69.2...v1.69.3)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
build: اعمال مجدد به‌روزرسانی github.com/golang-jwt/jwt/v5 از 5.2.1 به 5.2.2
جهت رفع CVE-2025-30204 (dependabot[bot])
.IP \[bu] 2
build: به‌روزرسانی github.com/ebitengine/purego برای دور زدن باگ در
go1.24.3 (Nick Craig-Wood)
.RE
.SS v1.69.2 - 2025-05-01
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.69.1...v1.69.2)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting: رفع مشکل محاسبه percentDiff -- (Anagh Kumar Baranwal)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
به‌روزرسانی github.com/golang-jwt/jwt/v4 از 4.5.1 به 4.5.2 جهت رفع
CVE-2025-30204 (dependabot[bot])
.IP \[bu] 2
به‌روزرسانی github.com/golang-jwt/jwt/v5 از 5.2.1 به 5.2.2 جهت رفع
CVE-2025-30204 (dependabot[bot])
.IP \[bu] 2
به‌روزرسانی golang.org/x/crypto به v0.35.0 جهت رفع CVE-2025-22869 (Nick
Craig-Wood)
.IP \[bu] 2
به‌روزرسانی golang.org/x/net از 0.36.0 به 0.38.0 جهت رفع CVE-2025-22870
(dependabot[bot])
.IP \[bu] 2
به‌روزرسانی golang.org/x/net به 0.36.0.
جهت رفع CVE-2025-22869 (dependabot[bot])
.IP \[bu] 2
توقف ساخت با نسخه‌های go < go1.23 به دلیل منع آن توسط به‌روزرسانی‌های امنیتی (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل ساخت پلاگین docker (Anagh Kumar Baranwal)
.RE
.IP \[bu] 2
cmd: رفع مشکل کرش در صورت فراخوانی rclone بدون هیچ آرگومانی (Janne
Hellsten)
.IP \[bu] 2
config: خواندن گذرواژه‌های پیکربندی از stdin حتی در صورت خاتمه با
EOF (Samantha Bowen)
.IP \[bu] 2
اصلاحات مستندات (Andrew Kreimer, Danny Garside, eccoisle, Ed Craig-Wood,
emyarod, jack, Jugal Kishore, Markus Gerstel, Michael Kebe, Nick
Craig-Wood, simonmcnair, simwai, Zachary Vorhies)
.IP \[bu] 2
fs: رفع خرابی SizeSuffix همراه با پسوند \[dq]B\[dq] در پیکربندی (مانند
--min-size) (Nick Craig-Wood)
.IP \[bu] 2
lib/http: رفع شرایط رقابتی (race) میان Serve() و Shutdown() (Nick Craig-Wood)
.IP \[bu] 2
object: رفع خطای Seek خارج از محدوده شیء حافظه (Nick Craig-Wood)
.IP \[bu] 2
operations: رفع فراخوانی fmt.Errorf با err نادرست (alingse)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
غیرفعال‌سازی سرور معیارها (metrics server) هنگام اجرای \f[V]rclone rc\f[R]
(hiddenmarten)
.IP \[bu] 2
رفع مشکل در دسترس نبودن دستورات debug/* از طریق سوکت‌های unix (Nick
Craig-Wood)
.RE
.IP \[bu] 2
serve nfs: رفع یک کرش نامحتمل (Nick Craig-Wood)
.IP \[bu] 2
stats: رفع مشکل به‌روزرسانی نشدن سرعت پس از مکث در پردازش
(Anagh Kumar Baranwal)
.IP \[bu] 2
sync
.RS 2
.IP \[bu] 2
رفع مشکل چرخش بی‌وقفه CPU (cpu spinning) هنگام یافتن دایرکتوری خالی با اسلش‌های ابتدایی (Nick
Craig-Wood)
.IP \[bu] 2
کپی زمان‌های تغییر (modtimes) دایرکتوری حتی زمانی که copyEmptySrcDirs برابر false باشد (ll3006)
.RE
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع مشکل ارائه داده‌های کهنه توسط حافظه نهان دایرکتوری (Lorenz Brun)
.IP \[bu] 2
رفع ناکارآمدی حافظه نهان دایرکتوری هنگامی که خواندن دایرکتوری‌ها کند است
(huanghaojun)
.IP \[bu] 2
رفع شکست‌های آزمون یکپارچه‌سازی (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
Metadata: رفع خطا هنگام تنظیم copy-requires-writer-permission روی یک
پوشه (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
تلاش مجدد برای لینک بدون انقضا (Dave Vasilevsky)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
اصلاح root در صورتی که قطعاً به یک فایل اشاره دارد (nielash)
.RE
.IP \[bu] 2
Iclouddrive
.RS 2
.IP \[bu] 2
رفع مشکل به‌گونه‌ای که فایل‌های ایجادشده قابل نوشتن باشند (Ben Alex)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
رفع ترتیب فراداده‌ها (metadata) در مجوزها (Nick Craig-Wood)
.RE.SS v1.69.1 - 2025-02-14
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.69.0...v1.69.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
lib/oauthutil: رفع خطاهای عدم تطابق URL بازنشانی (Nick Craig-Wood)
.IP \[bu] 2
bisync: رفع مشکل از قلم افتادن تغییرات هم‌زمان در فهرست‌بندی‌ها (nielash)
.IP \[bu] 2
serve s3: رفع مشکل encoding-type در فهرست شیءها (Nick Craig-Wood)
.IP \[bu] 2
fs: رفع خطای گیج‌کنندهٔ \[dq]didn\[aq]t find section in config file\[dq]
(Nick Craig-Wood)
.IP \[bu] 2
اصلاحات مستندات (Christoph Berger, Dimitri Papadopoulos, Matt Ickstadt, Nick
Craig-Wood, Tim White, Zachary Vorhies)
.IP \[bu] 2
build: افزودن ساخت موازی docker و حافظهٔ موقت برای go build در
کانتینر (Anagh Kumar Baranwal)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع مشکل شکست حافظهٔ موقت در بارگذاری پیوندهای نمادین هنگامی که \f[V]--links\f[R]
مشخص شده بود (Nick Craig-Wood)
.IP \[bu] 2
رفع وضعیت رقابتی شناسایی‌شده توسط race detector (Nick Craig-Wood)
.IP \[bu] 2
بستن کانال اعلان تغییرات هنگام Shutdown (izouxv)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
رفع \[dq]fatal error: concurrent map writes\[dq] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Iclouddrive
.RS 2
.IP \[bu] 2
افزودن یادداشت‌هایی دربارهٔ ADP و کوکی‌های مفقود PCS (Nick Craig-Wood)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
علامت‌گذاری منطقهٔ آلمان (de) به‌عنوان منسوخ‌شده (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن کلاس ذخیره‌سازی جدید به ارائه‌دهندهٔ magalu (Bruno Fernandes)
.IP \[bu] 2
افزودن مناطق DigitalOcean شامل SFO2، LON1، TOR1، BLR1 (jkpe)
.IP \[bu] 2
افزودن آخرین پایانه‌های Linode Object Storage (jbagwell-akamai)
.RE
.SS v1.69.0 - 2025-01-12
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.68.0...v1.69.0)
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
ICloud Drive (https://rclone.org/iclouddrive) (lostb1t)
.IP \[bu] 2
Cloudinary (https://rclone.org/cloudinary) (yuval-cloudinary)
.IP \[bu] 2
ارائه‌دهندگان جدید S3:
.RS 2
.IP \[bu] 2
Outscale (https://rclone.org/s3/#outscale) (Matthias Gatto)
.IP \[bu] 2
Selectel (https://rclone.org/s3/#selectel) (Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
اصلاحات امنیتی
.RS 2
.IP \[bu] 2
serve sftp: رفع CVE-2024-45337 - استفادهٔ نادرست از
ServerConfig.PublicKeyCallback ممکن است باعث دور زدن احراز هویت شود
(dependabot)
.RS 2
.IP \[bu] 2
ابزار Rclone در برابر این مورد آسیب‌پذیر \f[B]نبود\f[R].
.IP \[bu] 2
مشاهدهٔ <https://github.com/advisories/GHSA-v778-237x-gjrc>
.RE
.IP \[bu] 2
build: به‌روزرسانی golang.org/x/net به v0.33.0 برای رفع CVE-2024-45338 -
تجزیهٔ غیرخطی محتوای غیرحساس به بزرگی و کوچکی حروف (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
ابزار Rclone در برابر این مورد آسیب‌پذیر \f[B]نبود\f[R].
.IP \[bu] 2
مشاهدهٔ <https://github.com/advisories/GHSA-w32m-9786-jp63>
.RE
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
accounting: ثبت bwlimit فعلی در لاگ هنگام دریافت سیگنال SIGUSR2 (Nick
Craig-Wood)
.IP \[bu] 2
bisync: تغییر وضعیت خروج از ۲ به ۷ برای توقف بحرانی اجرا
(albertony)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
به‌روزرسانی تمامی وابستگی‌ها (Nick Craig-Wood)
.IP \[bu] 2
جایگزینی \f[V]NewLazyDLL\f[R] ویژهٔ ویندوز با
\f[V]NewLazySystemDLL\f[R] (albertony)
.RE
.IP \[bu] 2
cmd: تغییر وضعیت خروج از ۱ به ۲ برای خطاهای ساختاری و نحوهٔ استفاده
(albertony)
.IP \[bu] 2
docker serve: حصول اطمینان از تجزیهٔ تمام گزینه‌های mount و VFS (Nick
Craig-Wood)
.IP \[bu] 2
اصلاحات مستندات (albertony, Alexandre Hamez, Anthony Metzidis, buengese, Dan
McArdle, David Seifert, Francesco Frassinelli, Michael R.
Davis, Nick Craig-Wood, Pawel Palucha, Randy Bush, remygrandin, Sam
Harrison, shenpengfeng, tgfisher, Thomas ten Cate, ToM, Tony Metzidis,
vintagefuture, Yxxx)
.IP \[bu] 2
fs: سراسری کردن گزینهٔ \f[V]--links\f[R] و افزودن گزینه‌های جدید
\f[V]--local-links\f[R] و \f[V]--vfs-links\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
http servers: غیرفعال‌سازی گذر خودکار از احراز هویت برای سوکت‌های unix
در کارگزارهای http (Moises Lima)
.RS 2
.IP \[bu] 2
این مسئله استفاده از سوکت‌های unix همراه با یک پراکسی را غیرممکن می‌ساخت
.IP \[bu] 2
این تغییر ممکن است اکنون باعث شود rclone در جاهایی که پیش‌تر نیازی نداشت،
به احراز هویت نیاز پیدا کند
.RE
.IP \[bu] 2
oauthutil: افزودن پشتیبانی از جریان client credentials در OAuth (Martin Hassack,
Nick Craig-Wood)
.IP \[bu] 2
operations: یکپارچه‌سازی پیام‌های لاگ برای mkdir/rmdir در سطح INFO
(Nick Craig-Wood)
.IP \[bu] 2
rc: افزودن \f[V]relative\f[R] به
vfs/queue-set-expiry (https://rclone.org/rc/#vfs-queue-set-expiry) (Nick
Craig-Wood)
.IP \[bu] 2
serve dlna: مرتب‌سازی مدخل‌های دایرکتوری با اولویت دادن به دایرکتوری‌ها
و سپس بر پایهٔ الفبا بر اساس نام (Nick Craig-Wood)
.IP \[bu] 2
serve nfs
.RS 2
.IP \[bu] 2
معرفی پشتیبانی از پیوندهای نمادین (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی پیوند نمادین در \f[V]--nfs-cache-type\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
size: سازگار کردن خروجی با \f[V]-P\f[R] (Nick Craig-Wood)
.IP \[bu] 2
test makefiles: افزودن گزینهٔ \f[V]--flat\f[R] برای ایجاد دایرکتوری‌هایی
با مدخل‌های پرتعداد (Nick Craig-Wood)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting
.RS 2.IP \[bu] 2
رفع مشکل شمارش سراسری خطاها (Benjamin Legrand)
.IP \[bu] 2
رفع مشکل چاپ اشکال‌زدایی هنگامی که اشکال‌زدایی تنظیم نشده بود (Nick Craig-Wood)
.IP \[bu] 2
رفع وضعیت رقابتی در متوقف کردن/آغاز کردن شمارنده آمار (Nick Craig-Wood)
.RE
.IP \[bu] 2
rc/job: استفاده از mutex برای ایمنی نخ‌ها هنگام افزودن شنونده‌ها (hayden.pan)
.IP \[bu] 2
serve docker: رفع انتساب نادرست GID (TAKEI Yuya)
.IP \[bu] 2
serve nfs: رفع نبود شماره‌های inode که خروجی \f[V]ls -laR\f[R] را با اختلال مواجه می‌کرد (Nick Craig-Wood)
.IP \[bu] 2
serve s3: اصلاح برچسب زمانی \f[V]Last-Modified\f[R] (Nick Craig-Wood)
.IP \[bu] 2
serve sftp: رفع بارگذاری فایل authorized keys دارای توضیح در خط پایانی (albertony)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
معرفی پشتیبانی از پیوندهای نمادین (Filipe Azevedo, Nick Craig-Wood)
.IP \[bu] 2
بهبود پیام خطای سوار کردن snap (divinity76)
.IP \[bu] 2
mount2: رفع مدخل‌های گمشده‌ی \f[V].\f[R] و \f[V]..\f[R] (Filipe Azevedo)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
با \f[V]--vfs-used-is-size\f[R] مقدار محاسبه شده و سپس دور انداخته می‌شد (Ilias Ozgur Can Leonard)
.IP \[bu] 2
افزودن پشتیبانی از پیوندهای نمادین به VFS (Filipe Azevedo, Nick Craig-Wood)
.RS 2
.IP \[bu] 2
این قابلیت می‌تواند با پرچم اختصاصی \f[V]--vfs-links\f[R] یا پرچم سراسری \f[V]--links\f[R] فعال شود
.RE
.IP \[bu] 2
رفع ناپدید شدن فایل‌های باز از فهرست دایرکتوری (Nick Craig-Wood)
.IP \[bu] 2
افزودن نام remote به پیام‌های گزارش حافظه نهان VFS (Nick Craig-Wood)
.RE
.IP \[bu] 2
Cache
.RS 2
.IP \[bu] 2
رفع پین نشدن والد زمانی که remote یک فایل است (nielash)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
افزودن \f[V]--azureblob-disable-instance-discovery\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--azureblob-use-az\f[R] برای اجبار به استفاده از Azure CLI جهت احراز هویت (Nick Craig-Wood)
.IP \[bu] 2
توقف بارگذاری‌های چندبخشی در صورت لغو شدن context (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azurefiles
.RS 2
.IP \[bu] 2
رفع هدر گمشده‌ی x-ms-file-request-intent (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
افزودن \f[V]daysFromStartingToCancelingUnfinishedLargeFiles\f[R] به دستور \f[V]backend lifecycle\f[R] (Louis Laureys)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
رفع کپی سمت سرور یک فایل بر روی dst موجود (nielash)
.IP \[bu] 2
رفع خرابی panic هنگام رمزگشایی PEM آسیب‌دیده از فایل JWT (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از قالب markdown (Noam Ross)
.IP \[bu] 2
پیاده‌سازی \f[V]rclone backend rescue\f[R] جهت نجات فایل‌های رهاشده (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
رفع کپی سمت سرور بر روی شیء موجود (Nick Craig-Wood)
.IP \[bu] 2
اصلاح وضعیت بازگشتی هنگام پر بودن به صورت خطای مهلک (Nick Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]--ftp-no-check-upload\f[R] برای اجازه بارگذاری در دایرکتوری‌های فقط‌نوشتنی (Nick Craig-Wood)
.IP \[bu] 2
رفع بازگرداندن خروجی خالی توسط دستورهای ls در سرورهای \[dq]Microsoft FTP Service\[dq] (Francesco Frassinelli)
.RE
.IP \[bu] 2
Gofile
.RS 2
.IP \[bu] 2
رفع کپی سمت سرور بر روی شیء موجود (Nick Craig-Wood)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
افزودن احراز هویت با توکن دسترسی از طریق \f[V]--gcs-access-token\f[R] (Leandro Piccilli)
.IP \[bu] 2
به‌روزرسانی مستندات توکن‌های دسترسی حساب سرویس (Anthony Metzidis)
.RE
.IP \[bu] 2
Googlephotos
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]--gphotos-proxy\f[R] برای امکان بارگیری رسانه‌ها با وضوح کامل (Nick Craig-Wood)
.IP \[bu] 2
رفع خرابی ناشی از اشاره‌گر تهی (nil pointer crash) هنگام بارگذاری (Nick Craig-Wood)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
رفع نشانی‌های وب نادرست با اسلش ابتدایی (Oleg Kunitsyn)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از گردش اعتبارنامه کلاینت (client credential flow) در OAuth (Martin Hassack, Nick Craig-Wood)
.IP \[bu] 2
رفع دقت زمانی برای OneDrive شخصی (Nick Craig-Wood)
.IP \[bu] 2
رفع کپی سمت سرور بر روی شیء موجود (Nick Craig-Wood)
.RE
.IP \[bu] 2
Opendrive
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]rclone about\f[R] به backend (quiescens)
.RE
.IP \[bu] 2
Oracle Object Storage
.RS 2
.IP \[bu] 2
اختیاری کردن تعیین \f[V]compartmentid\f[R] (Manoj Ghosh)
.IP \[bu] 2
توقف بارگذاری‌های چندبخشی در صورت لغو شدن context (Nick Craig-Wood)
.RE
.IP \[bu] 2
Pikpak
.RS 2
.IP \[bu] 2
افزودن گزینه جهت استفاده از پیوندهای فایل اصلی (wiserain)
.RE
.IP \[bu] 2
Protondrive
.RS 2
.IP \[bu] 2
بهبود کارایی backend پروتون درایو (Lawrence Murray)
.RE.IP \[bu] 2
Putio
.RS 2
.IP \[bu] 2
رفع مشکل کپی سمت سرور روی شیء موجود (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن گزینهٔ اولیهٔ \f[V]--s3-directory-bucket\f[R] برای پشتیبانی از AWS Directory
Buckets (Nick Craig-Wood)
.IP \[bu] 2
افزودن منطقهٔ \f[V]eu-south-1\f[R] در Wasabi (Diego Monti)
.IP \[bu] 2
رفع مشکل بارگیری فایل‌های فشرده‌شده از Cloudflare R2 (Nick Craig-Wood)
.IP \[bu] 2
تغییر نام کلاس ذخیره‌سازی glacier به flexible retrieval (Henry Lee)
.IP \[bu] 2
خروج از بارگذاری‌های چندبخشی (multipart uploads) در صورت لغو context (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
امکان استفاده از گواهی عمومی ssh درون‌خطی (inline) برای sftp (Dimitar Ivanov)
.IP \[bu] 2
رفع خطای بررسی nil هنگام استفاده از پروکسی احراز هویت (Nick Craig-Wood)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
افزودن پشتیبانی اولیه از احراز هویت Kerberos (نیازمند کار بیشتر).
(Francesco Frassinelli)
.IP \[bu] 2
رفع panic در صورت شکست stat (Nick Craig-Wood)
.RE
.IP \[bu] 2
Sugarsync
.RS 2
.IP \[bu] 2
رفع مشکل کپی سمت سرور روی شیء موجود (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
Nextcloud: پیاده‌سازی عقب‌نشینی (backoff) و تلاش مجدد برای خطاهای 423 LOCKED (Nick
Craig-Wood)
.IP \[bu] 2
ایجاد \f[V]--webdav-auth-redirect\f[R] برای رفع خطای 401 unauthorized در
تغییر مسیر (Nick Craig-Wood)
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
رفع مشکل کپی سمت سرور روی شیء موجود (Nick Craig-Wood)
.RE
.IP \[bu] 2
Zoho
.RS 2
.IP \[bu] 2
استفاده از سرور بارگیری برای افزایش سرعت بارگیری‌ها (buengese)
.IP \[bu] 2
تغییر به API بارگذاری فایل‌های بزرگ برای پرونده‌های حجیم‌تر، رفع مشکل عدم کدگذاری URL
نام فایل‌ها برای API بارگذاری (buengese)
.IP \[bu] 2
چاپ پیام خطای واضح هنگام نبود حوزهٔ (scope) مربوط به oauth (buengese)
.IP \[bu] 2
تلاش برای مدیریت بهتر محدودیت‌های نرخ (rate limits) (buengese)
.IP \[bu] 2
افزودن پشتیبانی از فضاهای خصوصی (private spaces) (buengese)
.IP \[bu] 2
امکان پیکربندی آستانهٔ قطع بارگذاری (upload cutoff) (buengese)
.RE
.SS v1.68.2 - 2024-11-15
.PP
مشاهدهٔ کامیت‌ها (https://github.com/rclone/rclone/compare/v1.68.1...v1.68.2)
.IP \[bu] 2
اصلاحات امنیتی
.RS 2
.IP \[bu] 2
پشتانهٔ محلی (local backend): CVE-2024-52522: رفع مشکل مجوز و مالکیت پیوندهای نمادین
با \f[V]--links\f[R] و \f[V]--metadata\f[R] (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
تنها کاربرانی را تحت تأثیر قرار می‌دهد که از \f[V]--metadata\f[R] و \f[V]--links\f[R] استفاده
کرده و فایل‌ها را به پشتانهٔ محلی کپی می‌کنند
.IP \[bu] 2
ببینید
<https://github.com/rclone/rclone/security/advisories/GHSA-hrxh-9w67-g4cv>
.RE
.IP \[bu] 2
ساخت: ارتقای github.com/golang-jwt/jwt/v4 از 4.5.0 به 4.5.1
(dependabot)
.RS 2
.IP \[bu] 2
این یک مشکل در وابستگی مورد استفاده برای گواهی‌های JWT است
.IP \[bu] 2
ببینید
<https://github.com/golang-jwt/jwt/security/advisories/GHSA-29wx-vh33-7x7r>
.RE
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting: رفع پیام نادرست در SIGUSR2 برای فعال/غیرفعال‌سازی bwlimit (Nick
Craig-Wood)
.IP \[bu] 2
bisync: رفع بازگردانی نادرست خروجی ضبط‌شده برای logrus
(Dimitrios Slamaris)
.IP \[bu] 2
dlna: رفع نادیده گرفتن سطح گزارش (log level) توسط loggingResponseWriter (Simon Bos)
.IP \[bu] 2
serve s3: رفع قفل‌گذاری بیش از حد که موجب تک‌رشته‌ای شدن serve s3 می‌شد
(Nick Craig-Wood)
.IP \[bu] 2
اصلاحات مستندات (Nick Craig-Wood, tgfisher, Alexandre Hamez, Randy Bush)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع مشکل مجوزها و مالکیت در پیوندهای نمادین با \f[V]--links\f[R] و
\f[V]--metadata\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل \f[V]--copy-links\f[R] در macOS هنگام شبیه‌سازی (nielash)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
اصلاح رسیدگی به Retry-After برای بررسی خطاهای 503 نیز (Nick Craig-Wood)
.RE
.IP \[bu] 2
Pikpak
.RS 2
.IP \[bu] 2
رفع محاسبات cid/gcid برای fs.OverrideRemote (wiserain)
.IP \[bu] 2
رفع کرش مهلک هنگام راه‌اندازی با توکنی که قابل تازه‌سازی نیست (Nick
Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع کرش هنگام استفاده از \f[V]--s3-download-url\f[R] پس از مهاجرت به
SDKv2 (Nick Craig-Wood)
.IP \[bu] 2
ارائه‌دهندهٔ Storj: رفع مشکل کپی سمت سرور فایل‌های بزرگ‌تر از 5GB (Kaloyan
Raev)
.IP \[bu] 2
رفع بارگذاری‌های چندبخشی چندمستأجری (multitenant) با CEPH (Nick Craig-Wood)
.RE.SS v1.68.1 - 2024-09-24
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.68.0...v1.68.1)
.IP \[bu] 2
رفع اشکال‌ها
.RS 2
.IP \[bu] 2
build: رفع اشکال ساخت نسخه انتشار docker (ttionya)
.IP \[bu] 2
اصلاحات مستندات (Nick Craig-Wood, Pawel Palucha)
.IP \[bu] 2
fs
.RS 2
.IP \[bu] 2
رفع اشکال عدم نمایش همیشگی \f[V]--dump filters\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال مقداردهی مقادیر پیکربندی \f[V]stringArray\f[R] از متغیرهای محیطی (Nick Craig-Wood)
.RE
.IP \[bu] 2
rc: اصلاح مقدار پیش‌فرض \f[V]--metrics-addr\f[R] (Nick Craig-Wood)
.IP \[bu] 2
serve docker: افزودن گزینه جاافتاده \f[V]vfs-read-chunk-streams\f[R] در درایور حجم docker (Divyam)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
رفع پیام خطای کاذب اشکال‌زدایی \[dq]Couldn\[aq]t decode error response: EOF\[dq] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Pikpak
.RS 2
.IP \[bu] 2
رفع مشکل ورود به سیستم هنگام شکست در دریافت توکن (wiserain)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع مشکل نادیده گرفتن اعتبارنامه‌های ایستا توسط rclone هنگامی که \f[V]env_auth=true\f[R] باشد (Nick Craig-Wood)
.RE
.SS v1.68.0 - 2024-09-08
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.67.0...v1.68.0)
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
Files.com (Sam Harrison)
.IP \[bu] 2
Gofile (https://rclone.org/gofile) (Nick Craig-Wood)
.IP \[bu] 2
Pixeldrain (https://rclone.org/pixeldrain) (Fornax)
.RE
.IP \[bu] 2
بک‌اندهای تغییریافته
.RS 2
.IP \[bu] 2
بک‌اند S3 (https://rclone.org/s3) برای استفاده از AWS SDKv2 (https://github.com/aws/aws-sdk-go-v2) به‌روزرسانی شد، زیرا پشتیبانی از نسخه ۱ به پایان رسیده است.
.RS 2
.IP \[bu] 2
ماتریس ارائه‌دهندگان و روش‌های احراز هویت بسیار وسیع است و ممکن است در ترکیب‌های نامتعارف مشکلاتی وجود داشته باشد.
.IP \[bu] 2
لطفاً مشکلات را در قالب یک گزارش جدید (issue) در گیت‌هاب (https://github.com/rclone/rclone/issues/new/choose) مطرح کنید.
.RE
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
دستور config encryption (https://rclone.org/commands/rclone_config_encryption): زیردستورهای set، remove و check برای مدیریت رمزنگاری فایل پیکربندی (Nick Craig-Wood)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
ارتقا به go1.23 و تعیین go1.21 به عنوان حداقل نسخه مورد نیاز (Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی تمام وابستگی‌ها (Nick Craig-Wood)
.IP \[bu] 2
غیرفعال‌سازی ساخت wasm/js به دلیل باگ شماره ۶۴۸۵۶ در go (https://github.com/golang/go/issues/64856) (Nick Craig-Wood)
.IP \[bu] 2
فعال‌سازی قواعد بررسی کد (linting) سفارشی با ruleguard از طریق gocritic (albertony)
.IP \[bu] 2
به‌روزرسانی عبارت‌های لاگ‌گیری تا \f[V]--use-json-log\f[R] همیشه کار کند (albertony)
.IP \[bu] 2
افزودن آزمون‌های جدید کیفیت کد و اصلاح تبعات آن (albertony)
.RE
.IP \[bu] 2
config
.RS 2
.IP \[bu] 2
سازمان‌دهی مجدد پیکربندی داخلی جهت سازگاری بیشتر و در دسترس قرار گرفتن آن از طریق rc (Nick Craig-Wood)
.IP \[bu] 2
جلوگیری از ایجاد ریموت‌هایی با نام خالی از متغیرهای محیطی (albertony)
.IP \[bu] 2
یکپارچه‌تر کردن فهرست‌بندی ریموت‌ها (albertony)
.IP \[bu] 2
یکپارچه‌تر کردن دریافت مقادیر پیکربندی (albertony)
.IP \[bu] 2
استفاده از \f[V]--password-command\f[R] برای تنظیم گذرواژه فایل پیکربندی در صورت ارائه شدن (Nick Craig-Wood)
.RE
.IP \[bu] 2
اصلاحات مستندات (albertony, crystalstall, David Seifert, Eng Zer Jun, Ernie Hershey, Florian Klink, John Oxley, kapitainsky, Mathieu Moreau, Nick Craig-Wood, nipil, Pétr Bozsó, Russ Bubley, Sam Harrison, Thearas, URenko, Will Miles, yuval-cloudinary)
.IP \[bu] 2
fs: مجاز بودن استفاده از نقطه‌ویرگول علاوه بر فاصله در تجزیه جدول زمانی \f[V]--bwlimit\f[R] (Kyle Reynolds)
.IP \[bu] 2
help
.RS 2
.IP \[bu] 2
دستور راهنمای پرچم‌های سراسری اکنون از فیلتر الگو (glob) پشتیبانی می‌کند (albertony)
.IP \[bu] 2
کاهش آشفتگی و خلوت‌تر کردن خروجی دستور راهنما (albertony)
.RE
.IP \[bu] 2
lib/encoder: افزودن کدگذاری Raw برای استفاده در مواقعی که به هیچ کدگذاری‌ای نیاز نیست، مانند \f[V]--local-encoding Raw\f[R] (URenko)
.IP \[bu] 2
listremotes: افزودن گزینه‌هایی برای فیلتر کردن، مرتب‌سازی و خروجی json (albertony)
.IP \[bu] 2
nfsmount
.RS 2
.IP \[bu] 2
کارکرد پرچم \f[V]--sudo\f[R] برای umount به همراه mount (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینه \f[V]-o tcp\f[R] به گزینه‌های اتصال NFS برای رفع اشکال اتصال در لینوکس (Nick Craig-Wood)
.RE
.IP \[bu] 2
operations: copy: تولید پسوند پایدار برای بخش‌های ناقص (Georg Welzel)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن فراخوانی options/info (https://rclone.org/rc/#options-info) جهت شمارش گزینه‌ها (Nick Craig-Wood)
.IP \[bu] 2
افزودن پارامتر بلوک‌های گزینه به options/get (https://rclone.org/rc/#options-get) و options/info (Nick Craig-Wood)
.IP \[bu] 2
افزودن vfs/queue (https://rclone.org/rc/#vfs-queue) برای نمایش وضعیت صف بارگذاری (Nick Craig-Wood)
.IP \[bu] 2
افزودن vfs/queue-set-expiry (https://rclone.org/rc/#vfs-queue-set-expiry) جهت تنظیم انقضای موارد در صف VFS (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینه \f[V]--unix-socket\f[R] به دستور \f[V]rc\f[R] (Florian Klink)
.IP \[bu] 2
جلوگیری از ارسال پیام sd-notify حاوی \f[V]STOPPING=1\f[R] توسط دستور unmount در rc (AThePeanut4)
.RE
.IP \[bu] 2
rcserver: پیاده‌سازی معیارهای prometheus (https://rclone.org/docs/#metrics) روی یک درگاه اختصاصی (Oleg Kunitsyn).IP \[bu] 2
serve dlna
.RS 2
.IP \[bu] 2
همچنین بررسی زیرپوشهٔ \[dq]Subs\[dq] (Florian Klink)
.IP \[bu] 2
نادیده‌نگرفتن \f[V]video.{idx,sub}\f[R] (Florian Klink)
.IP \[bu] 2
تنظیم نوع mime صحیح‌تر (Florian Klink)
.RE
.IP \[bu] 2
serve nfs
.RS 2
.IP \[bu] 2
پیاده‌سازی کَش روی دیسک برای دستگیره‌های فایل انتخاب‌شده با
\f[V]--nfs-cache-type\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن ردگیری به فراخوانی‌های سامانه فایل (Nick Craig-Wood)
.IP \[bu] 2
پوشاندن خطای پیاده‌سازی‌نشده از chmod (Nick Craig-Wood)
.IP \[bu] 2
یکپارچه‌سازی بهتر ثبت وقایع کتابخانهٔ nfs با ثبت وقایع rclone (Nick
Craig-Wood)
.IP \[bu] 2
رفع شناسهٔ کاربر و شناسهٔ گروه نادرست صادرشده به NFS (Nick Craig-Wood)
.RE
.IP \[bu] 2
serve s3
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]--auth-proxy\f[R] (Sawjan Gurung)
.IP \[bu] 2
ارتقا به AWS SDKv2 با به‌روزرسانی \f[V]github.com/rclone/gofakes3\f[R]
(Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
bisync: رفع مشکلات زمان همگام‌سازی با بک‌اندهایی که زمان را گرد می‌کنند (مانند
Dropbox) (nielash)
.IP \[bu] 2
serve dlna: رفع خطای panic: invalid argument to Int63n (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
افزودن
--vfs-read-chunk-streams (https://rclone.org/commands/rclone_mount/#vfs-read-chunk-streams-0-1)
برای خواندن موازی تکه‌ها از فایل‌ها (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
این قابلیت می‌تواند کارایی mount را در پیوندهایی با پهنای باند بالا یا تأخیر
زیاد افزایش دهد
.RE
.IP \[bu] 2
رفع مشکل کدگذاری کَش با نویسه‌های خاص (URenko)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع مشکل کدگذاری مسیر ریشه (URenko)
.IP \[bu] 2
افزودن کپی سمت سرور (با استفاده از clone) همراه با xattrs در macOS (nielash)
.RS 2
.IP \[bu] 2
گزینهٔ \f[V]--local-no-clone\f[R] برای غیرفعال‌کردن کلون در رونوشت‌های
سمت سرور (nielash)
.RE
.IP \[bu] 2
پشتیبانی از تنظیم \f[V]--metadata\f[R] سفارشی در حین Copy سمت سرور
(nielash)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
امکان دسترسی ناشناس برای منابع عمومی (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
گنجاندن هدرهای سفارشی بارگذاری در اطلاعات فایل‌های بزرگ (Pat Patterson)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
رفع مشکل کپی کردن Google Docs به بک‌اندی که فقط از SHA1 پشتیبانی می‌کند (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Fichier
.RS 2
.IP \[bu] 2
رفع تشخیص خطای Flood Detected (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل جابه‌جایی سمت سرور (Nick Craig-Wood)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
بارگذاری مجدد گواهی‌های کلاینت در زمان انقضا (Saleh Dindar)
.IP \[bu] 2
پشتیبانی از شنود روی FDهای ارائه‌شده (Florian Klink)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
رفع مشکل تنظیم متادیتا در جابه‌جایی سمت سرور (albertony)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
رفع خطای اشاره‌گر nil هنگام بارگذاری فایل‌های کوچک (Nick Craig-Wood)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]SetModTime\f[R] (Georg Welzel)
.IP \[bu] 2
پیاده‌سازی قابلیت \f[V]OpenWriterAt\f[R] برای فعال‌سازی بارگذاری‌های چندبخشی
(Georg Welzel)
.IP \[bu] 2
رفع شکست بارگذاری فایل‌های بزرگ (Georg Welzel)
.RE
.IP \[bu] 2
Pikpak
.RS 2
.IP \[bu] 2
بهبود سازگاری داده‌ها با اطمینان از تکمیل وظایف ناهمگام (wiserain)
.IP \[bu] 2
پیاده‌سازی هش سفارشی برای جایگزینی sha1 نادرست (wiserain)
.IP \[bu] 2
رفع خطا در دستور \f[V]copyto\f[R] (wiserain)
.IP \[bu] 2
بهینه‌سازی جابه‌جایی فایل با حذف فراخوانی غیرضروری \f[V]readMetaData()\f[R]
(wiserain)
.IP \[bu] 2
محاسبهٔ بدون بافر هش برای فایل‌های مبدأ محلی (wiserain)
.IP \[bu] 2
بهینه‌سازی بارگذاری با واکشی اولیهٔ gcid از API (wiserain)
.IP \[bu] 2
اصلاح پیشرفت انتقال فایل برای بارگذاری‌های مبتنی بر هش (wiserain)
.IP \[bu] 2
به‌روزرسانی برای استفاده از AWS SDK v2 (wiserain)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
به‌روزرسانی برای استفاده از AWS SDK v2 (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
افزودن \f[V]--s3-sdk-log-mode\f[R] برای واپایش اشکال‌زدایی SDKv2 (Nick
Craig-Wood)
.RE
.IP \[bu] 2
رفع ناحیهٔ نادرست برای ارائه‌دهندهٔ Magalu (Filipe Herculano)
.IP \[bu] 2
امکان بازیابی از کلاس ذخیره‌سازی intelligent-tiering (Pawel Palucha)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
استفاده از \f[V]uint32\f[R] برای mtime به‌منظور صرفه‌جویی در حافظه (Tomasz Melcer)
.IP \[bu] 2
نادیده‌گرفتن خطاهای غیرضروری هنگام بستن استخر اتصالات (Nick Craig-Wood)
.IP \[bu] 2
پشتیبانی از شنود روی FDهای ارائه‌شده (Florian Klink)
.RE.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
افزودن راه‌حل‌های موقت برای فهرست‌بندی‌های نادرست در Ceph RGW (Paul Collins)
.IP \[bu] 2
افزودن اطلاعات فضای کل/آزاد در دستور \f[V]about\f[R].
(fsantagostinobietti)
.RE
.IP \[bu] 2
Ulozto
.RS 2
.IP \[bu] 2
رفع بارگذاری فایل‌های بزرگ‌تر از ۲ گیگابایت در پلتفرم‌های ۳۲ بیتی (Tobias Markus)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
افزودن \f[V]--webdav-unix-socket-path\f[R] برای اتصال به یک سوکت یونیکس
(Florian Klink)
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
پیاده‌سازی user agent سفارشی برای کمک به سرعت‌های بارگذاری (Sebastian
Bünger)
.RE
.IP \[bu] 2
Zoho
.RS 2
.IP \[bu] 2
رفع ناکارآمدی‌های بارگذاری با API جدید جهت جلوگیری از throttling (Nick
Craig-Wood)
.RE
.SS v1.67.0 - 2024-06-14
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.66.0...v1.67.0)
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
uloz.to (https://rclone.org/ulozto) (iotmaestro)
.IP \[bu] 2
ارائه‌دهندگان جدید S3
.RS 2
.IP \[bu] 2
Magalu Object Storage (https://rclone.org/s3/#magalu) (Bruno Fernandes)
.RE
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
gitannex (https://rclone.org/commands/rclone_gitannex): امکان ذخیره
و بازیابی محتوا از یک ریموت rclone را برای git-annex فراهم می‌کند (Dan
McArdle)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
accounting: افزودن مجموع حجم فایل‌های حذف‌شده به خط خلاصه وضعیت (Kyle
Reynolds)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
رفع \f[V]CVE-2023-45288\f[R] با ارتقای \f[V]golang.org/x/net\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
رفع \f[V]CVE-2024-35255\f[R] با ارتقای
\f[V]github.com/Azure/azure-sdk-for-go/sdk/azidentity\f[R] به 1.6.0
(dependabot)
.IP \[bu] 2
تبدیل پایان سطرهای فایل‌های سورس از CRLF به LF (albertony)
.IP \[bu] 2
به‌روزرسانی تمام وابستگی‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
به‌روزرسانی‌های مستندات (albertony, Alex Garel, Dave Nicolson, Dominik Joe Pantůček,
Eric Wolf, Erisa A, Evan Harris, Evan McBeth, Gachoud Philippe,
hidewrong, jakzoe, jumbi77, kapitainsky, Kyle Reynolds, Lewis Hook, Nick
Craig-Wood, overallteach, pawsey-kbuckley, Pieter van Oostrum,
psychopatt, racerole, static-moonlight, Warrentheo, yudrywet, yumeiyin )
.IP \[bu] 2
ncdu: عدم خروج با فشردن کلید Esc جهت بهبود سهولت کاربری (Katia Esposito)
.IP \[bu] 2
rcserver: تنظیم \f[V]ModTime\f[R] برای دایرکتوری‌ها و فایل‌های ارائه‌شده با
\f[V]--rc-serve\f[R] (Nikita Shoshin)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
bisync: افزودن آزمون‌های یکپارچه‌سازی در برابر تمام بک‌اندها و رفع ایرادات
بسیار متعدد (nielash)
.IP \[bu] 2
config: تصحیح مقدار پیش‌فرض برای \f[V]description\f[R] (Nick Craig-Wood)
.IP \[bu] 2
copy: رفع خطای ارجاع به اشاره‌گر \f[V]nil\f[R] هنگام بروز خرابی داده در انتقال
با مقصد (\f[V]nil\f[R] dst) تهی (nielash)
.IP \[bu] 2
fs
.RS 2
.IP \[bu] 2
بهبود پردازش JSON Unmarshalling برای انواع داده \f[V]Duration\f[R] (Kyle Reynolds)
.IP \[bu] 2
بستن پروفایل CPU در هنگام خروج (guangwu)
.IP \[bu] 2
جایگزینی \f[V]/bin/bash\f[R] با \f[V]/usr/bin/env bash\f[R] (Florian
Klink)
.RE
.IP \[bu] 2
oauthutil: پاک کردن client secret در صورت تنظیم بودن client ID (Michael Terry)
.IP \[bu] 2
operations
.RS 2
.IP \[bu] 2
بازنویسی \f[V]rcat\f[R] به‌گونه‌ای که
\f[V]--metadata-mapper\f[R] را دو بار فراخوانی نکند (Nick Craig-Wood)
.IP \[bu] 2
اطمینان از مقداردهی صحیح \f[V]SrcFsType\f[R] هنگام استفاده از
\f[V]--metadata-mapper\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای \[dq]optional feature not implemented\[dq] با یک باگ sftp
رمزگذاری‌شده (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل نام‌های بسیار طولانی فایل هنگام استفاده از copy با \f[V]--partial\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
رفع بارگیری حجم زیادی از داده در تلاش‌های مجدد در برخی بک‌اندها (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل move زمانی که dst برابر nil است و fdst غیرحساس به بزرگی و کوچکی حروف است (nielash)
.IP \[bu] 2
رفع مشکل lsjson \f[V]--encrypted\f[R] هنگام استفاده از پارامترهای
\f[V]--crypt-XXX\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل متادیتای مفقود در انتقال‌های چندبخشی (multipart) به دیسک محلی (Nick
Craig-Wood)
.IP \[bu] 2
اصلاح modtime نادرست در برخی انتقال‌های چندبخشی (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل مقدار درهم‌سازی (hashing) در آزمون‌های یکپارچه‌سازی (Nick Craig-Wood)
.RE
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
رفع نادیده گرفته شدن گروه‌های آماری در \f[V]operations/check\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
اصلاح مقدار نادرست هدر \f[V]Content-Type\f[R] در API تحت HTTP (Kyle Reynolds)
.RE
.IP \[bu] 2
serve s3
.RS 2
.IP \[bu] 2
اصلاح ساختار سرآیند \f[V]Last-Modified\f[R] (Butanediol)
.IP \[bu] 2
رفع مشکل ذخیره‌سازی modtime اشتباه در متادیتای مقیم حافظه (nielash)
.IP \[bu] 2
اصلاح ساختار XML پیام خطا (Nick Craig-Wood)
.RE
.IP \[bu] 2
serve webdav: اصلاح عملکرد webdav همراه با \f[V]--baseurl\f[R] در Windows (Nick
Craig-Wood)
.IP \[bu] 2
serve dlna: سازگارتر ساختن \f[V]BrowseMetadata\f[R] با استاندارد (albertony)
.IP \[bu] 2
serve http: افزودن سرآیند \f[V]Content-Length\f[R] هنگام ارائه فهرست دایرکتوری
به‌صورت HTML (Sunny)
.IP \[bu] 2
sync
.RS 2
.IP \[bu] 2
عدم همگام‌سازی دایرکتوری‌ها در صورتی که تغییر نیافته باشند (Nick
Craig-Wood).IP \[bu] 2
عدم آزمایش خواندن متادیتا در صورت عدم امکان نوشتن آن (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل نرمال‌سازی بزرگی و کوچکی حروف (مشکل در s3) (Nick Craig-Wood)
.IP \[bu] 2
اصلاح مدیریت دایرکتوری‌های خالی برای دقیق‌تر کردن آن (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل ایجاد دایرکتوری‌های خالی هنگام تنظیم
\f[V]--create-empty-src-dirs=false\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل تنظیم نشدن زمان‌های تغییر دایرکتوری (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای \[dq]failed to update directory timestamp or metadata: directory not
found\[dq] (Nick Craig-Wood)
.IP \[bu] 2
رفع انتظار SFTP برای داشتن متد MkdirMetadata: ویژگی اختیاری پیاده‌سازی نشده است (Nick Craig-Wood)
.RE
.IP \[bu] 2
test info: بهبود پاک‌سازی فایل‌های موقت (Kyle Reynolds)
.IP \[bu] 2
touch: رفع مشکل استفاده از \f[V]-R\f[R] روی برخی بک‌اندها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--direct-io\f[R] برای اجبار دسترسی بدون کَش (Nick
Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع حلقه بارگیری هنگام کاهش اندازه فایل (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل تغییر نام دایرکتوری (nielash)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
افزودن \f[V]--local-time-type\f[R] برای استفاده از
\f[V]mtime\f[R]/\f[V]atime\f[R]/\f[V]btime\f[R]/\f[V]ctime\f[R] به عنوان
زمان (Nick Craig-Wood)
.IP \[bu] 2
اجازه دادن به کارکرد \f[V]SeBackupPrivilege\f[R] و/یا \f[V]SeRestorePrivilege\f[R]
روی ویندوز (Charles Hamilton)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
رفع مشکل کدگذاری در مقایسه مسیر دایرکتوری (nielash)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
افزودن دستورات بک‌اند جدید cleanup (https://rclone.org/b2/#cleanup) و cleanup-hidden.
(Pat Patterson)
.IP \[bu] 2
به‌روزرسانی URLهای B2 به نشانی جدید (Nick Craig-Wood)
.RE
.IP \[bu] 2
Chunker
.RS 2
.IP \[bu] 2
رفع مشکل راه‌اندازی هنگامی که ریشه به فایل چندبخشی ترکیبی بدون متادیتا اشاره می‌کند (nielash)
.IP \[bu] 2
رفع مقایسه غیرحساس به حروف کوچک و بزرگ روی سیستم محلی بدون متادیتا (nielash)
.IP \[bu] 2
رفع خطای \[dq]finalizer already set\[dq] (nielash)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن دستور بک‌اند query (https://rclone.org/drive/#query) برای پرس‌وجوی چندمنظوره فایل‌ها (John-Paul Smith)
.IP \[bu] 2
توقف ارسال ایمیل‌های اعلان هنگام تنظیم مجوزها (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل کپی سمت سرور با متادیتا از my drive به shared drive (Nick
Craig-Wood)
.IP \[bu] 2
تنظیم تمامی مجوزهای متادیتا و بازگرداندن خلاصه خطا به جای توقف در نخستین خطا (Nick Craig-Wood)
.IP \[bu] 2
تبدیل خطاهای تنظیم مجوزها به خطاهای بدون تلاش مجدد (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل بازنویسی توضیحات در هنگام جابه‌جایی‌های سمت سرور (Nick Craig-Wood)
.IP \[bu] 2
اجازه به ناموفق بودن تنظیم متادیتا در صورت تنظیم بودن پرچم \f[V]failok\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
رفع خرابی مهلک (panic) هنگام استفاده از \f[V]--metadata-mapper\f[R] روی فایل‌های بزرگ google doc (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
افزودن \f[V]--dropbox-root-namespace\f[R] برای لغو و بازنویسی فضای نام ریشه
(Bill Fraser)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
رفع مشکل کدگذاری در مقایسه مسیر دایرکتوری (nielash)
.RE
.IP \[bu] 2
Hdfs
.RS 2
.IP \[bu] 2
رفع مشکل عدم درج زیرمسیر در f.String() (nielash)
.RE
.IP \[bu] 2
Http
.RS 2
.IP \[bu] 2
افزودن \f[V]--http-no-escape\f[R] برای گریز ندادن متانویسه‌های URL در نام‌های
مسیر (Kyle Reynolds)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
تنظیم متادیتا در کپی و جابه‌جایی سمت سرور (albertony)
.RE
.IP \[bu] 2
Linkbox
.RS 2
.IP \[bu] 2
رفع مشکل کار با نام‌های طولانی‌تر از ۸-۲۵ نویسه یونیکد.
(Vitaly)
.IP \[bu] 2
رفع صفحه‌بندی فهرست و همگام‌سازی بهینه‌شده.
(gvitali)
.RE
.IP \[bu] 2
Mailru
.RS 2
.IP \[bu] 2
تلاش برای رفع کنترل نرخ مصرف (throttling) با افزایش حداقل زمان انتظار به 100ms (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Memory
.RS 2
.IP \[bu] 2
رفع تغییر داده شدن src توسط dst پس از کپی سمت سرور (nielash)
.IP \[bu] 2
رفع بن‌بست در operations.Purge (nielash)
.IP \[bu] 2
رفع ورودی‌های نادرست فهرست هنگام قرار داشتن ریشه در یک زیردایرکتوری (nielash)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
افزودن \f[V]--onedrive-hard-delete\f[R] برای حذف دائمی فایل‌ها (Nick
Craig-Wood)
.IP \[bu] 2
عملکرد کپی سمت سرور در سناریوهای بیشتر (YukiUnHappy)
.IP \[bu] 2
رفع خطاهای \[dq]unauthenticated: Unauthenticated\[dq] هنگام بارگیری
(Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل دو بار فراخوانی شدن \f[V]--metadata-mapper\f[R] هنگام نوشتن
مجوزها (nielash)
.IP \[bu] 2
تنظیم تمامی مجوزهای متادیتا و بازگرداندن خلاصه خطا به جای توقف در نخستین خطا (nielash).IP \[bu] 2
تبدیل خطاهای تنظیم مجوزها به خطاهای بدون تلاش مجدد (Nick Craig-Wood)
.IP \[bu] 2
صرف‌نظر از نوشتن مجوزها با نقش \[aq]owner\[aq] (nielash)
.IP \[bu] 2
رفع ارجاعات به ویژگی‌های منسوخ‌شده‌ی مجوزها (nielash)
.IP \[bu] 2
افزودن پشتیبانی از مجوزهای گروهی (nielash)
.IP \[bu] 2
مجاز دانستن شکست در تنظیم مجوزها در صورت تنظیم بودن پرچم \f[V]failok\f[R] (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Pikpak
.RS 2
.IP \[bu] 2
بهینه‌تر کردن استفاده از getFile() برای جلوگیری از رسیدن به محدودیت دانلود
(wiserain)
.IP \[bu] 2
بهبود پایداری بارگذاری و رفع تداخلات احتمالی فایل
(wiserain)
.IP \[bu] 2
پیاده‌سازی اندازه قطعات قابل پیکربندی برای بارگذاری چندبخشی (multipart) (wiserain)
.RE
.IP \[bu] 2
Protondrive
.RS 2
.IP \[bu] 2
عدم احراز هویت با توکن دسترسی خالی (Michał Dzienisiewicz)
.RE
.IP \[bu] 2
Qingstor
.RS 2
.IP \[bu] 2
غیرفعال‌سازی آزمون‌های یکپارچگی به دلیل تعلیق حساب آزمایشی (Nick Craig-Wood)
.RE
.IP \[bu] 2
Quatrix
.RS 2
.IP \[bu] 2
رفع مشکل عدم گنجاندن زیرمسیر در f.String() (nielash)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن منطقه جدید AWS با شناسه \f[V]il-central-1\f[R] در Tel Aviv (yoelvini)
.IP \[bu] 2
به‌روزرسانی گزینه‌های پیکربندی Scaleway (Alexandre Lavigne)
.IP \[bu] 2
Ceph: رفع رفتارهای نامتعارف هنگام ساخت باکت‌ها جهت رفع تلاش برای ساخت
باکت از پیش موجود (Thomas Schneider)
.IP \[bu] 2
رفع مشکل انکودینگ در مقایسه مسیر دایرکتوری (nielash)
.IP \[bu] 2
رفع خطای 405 در درخواست HEAD برای نشانگر حذف (delete marker) دارای versionId (nielash)
.IP \[bu] 2
اعتبارسنجی اندازه \f[V]--s3-copy-cutoff\f[R] پیش از کپی (hoyho)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن \f[V]--sftp-connections\f[R] برای محدود کردن حداکثر تعداد
اتصال‌ها (Tomasz Melcer)
.RE
.IP \[bu] 2
Storj
.RS 2
.IP \[bu] 2
به‌روزرسانی \f[V]storj.io/uplink\f[R] به آخرین نسخه انتشاریافته (JT Olio)
.IP \[bu] 2
به‌روزرسانی bio طبق درخواست (Nick Craig-Wood)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]--swift-use-segments-container\f[R] برای پشتیبانی از فایل‌های >5G در
Blomp (Nick Craig-Wood)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
رفع مشکل حذف دایرکتوری‌ها زمانی که هیچ‌کدام از ریموت‌ها قابلیت داشتن دایرکتوری خالی را ندارند (Nick
Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
رفع مشکل پاک شدن چکسام‌ها هنگام تنظیم زمان‌های تغییر در owncloud و
nextcloud (nielash)
.IP \[bu] 2
owncloud: افزودن \f[V]--webdav-owncloud-exclude-mounts\f[R] که امکان
مستثنی کردن پوشه‌های متصل‌شده را هنگام فهرست‌کردن منابع ریموت فراهم می‌کند (Thomas Müller)
.RE
.IP \[bu] 2
Zoho
.RS 2
.IP \[bu] 2
رفع مشکل کنترل نرخ ارسال (throttling) هنگام بارگذاری فایل‌ها (Nick Craig-Wood)
.IP \[bu] 2
استفاده از فهرست‌بندی مبتنی بر مکان‌نما برای بهبود کارایی (Nick Craig-Wood)
.IP \[bu] 2
تلاش مجدد برای خواندن اطلاعات پس از بارگذاری در صورت برگردانده نشدن اندازه (Nick
Craig-Wood)
.IP \[bu] 2
حذف پیچیدگی مربوط به نام‌های ساده فایل که دیگر مورد نیاز نیست (Nick
Craig-Wood)
.IP \[bu] 2
توقف ۶۰ ثانیه‌ای در صورت دریافت خطای محدودیت نرخ (Nick Craig-Wood)
.RE.SS v1.66.0 - 2024-03-10
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.65.0...v1.66.0)
.IP \[bu] 2
ویژگی‌های اصلی
.RS 2
.IP \[bu] 2
اکنون rclone در صورت پشتیبانی بک‌اند، زمان تغییر دایرکتوری را همگام‌سازی می‌کند.
.RS 2
.IP \[bu] 2
این قابلیت را می‌توان با
--no-update-dir-modtime (https://rclone.org/docs/#no-update-dir-modtime)
غیرفعال کرد.
.IP \[bu] 2
برای مشاهده این‌که کدام بک‌اندها از آن پشتیبانی می‌کنند، بررسی اجمالی (https://rclone.org/overview/#features) را ببینید و به دنبال پرچم‌های \f[V]D\f[R] در ستون \f[V]ModTime\f[R] بگردید.
.RE
.IP \[bu] 2
اکنون rclone در صورت استفاده از \f[V]-M\f[R]/\f[V]--metadata\f[R] و پشتیبانی بک‌اند، متادیتای دایرکتوری را همگام‌سازی می‌کند.
.RS 2
.IP \[bu] 2
برای مشاهده این‌که کدام بک‌اندها از آن پشتیبانی می‌کنند، بررسی اجمالی (https://rclone.org/overview/#features) را ببینید و به دنبال پرچم‌های \f[V]D\f[R] در ستون \f[V]Metadata\f[R] بگردید.
.RE
.IP \[bu] 2
ابزار bisync به‌روزرسانی‌های متعددی دریافت کرده است؛ برای جزئیات بیشتر به بخش‌های زیر یا تغییرات نوشت bisync (https://rclone.org/bisync/#changelog) مراجعه کنید.
.RE
.IP \[bu] 2
بک‌اندهای حذف‌شده
.RS 2
.IP \[bu] 2
amazonclouddrive: حذف کد و مستندات بک‌اند Amazon Drive (توسط Nick Craig-Wood)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
backend
.RS 2
.IP \[bu] 2
افزودن فیلد توضیحات برای تمامی بک‌اندها (Paul Stern)
.RE
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
به‌روزرسانی به go1.22 و تعیین go1.20 به‌عنوان حداقل نسخه موردنیاز (Nick Craig-Wood)
.IP \[bu] 2
رفع \f[V]CVE-2024-24786\f[R] با ارتقای \f[V]google.golang.org/protobuf\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
check: رعایت \f[V]--no-unicode-normalization\f[R] و \f[V]--ignore-case-sync\f[R] برای \f[V]--checkfile\f[R] (nielash)
.IP \[bu] 2
cmd: بهبود چشمگیر تکمیل خودکار شل که حجم فایل تکمیل را کاهش داده و سریع‌تر کار می‌کند (Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی مستندات (albertony, ben-ba, Eli, emyarod, huajin tong, Jack Provance, kapitainsky, keongalvin, Nick Craig-Wood, nielash, rarspace01, rzitzer, Tera, Vincent Murphy)
.IP \[bu] 2
fs: افزودن گزارش‌گیری (لاگینگ) با جزئیات بیشتر برای include/exclude فایل‌ها (Kyle Reynolds)
.IP \[bu] 2
lsf
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--time-format\f[R] (nielash)
.IP \[bu] 2
نمایش متادیتا برای دایرکتوری‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
lsjson: نمایش متادیتا برای دایرکتوری‌ها (Nick Craig-Wood)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن \f[V]srcFs\f[R] و \f[V]dstFs\f[R] به آمارهای \f[V]core/stats\f[R] و \f[V]core/transferred\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]operations/hashsum\f[R] به rc به‌عنوان معادل \f[V]rclone hashsum\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]config/paths\f[R] به rc به‌عنوان معادل \f[V]rclone config paths\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
sync
.RS 2
.IP \[bu] 2
گزارش اختیاری فهرست مسیرهای همگام‌سازی‌شده در فایل (nielash)
.IP \[bu] 2
پیاده‌سازی همگام‌سازی دایرکتوری برای زمان‌های تغییر و متادیتا (Nick Craig-Wood)
.IP \[bu] 2
عدم تنظیم زمان تغییر دایرکتوری در صورت تنظیم بودن از قبل (nielash)
.IP \[bu] 2
عدم همگام‌سازی زمان تغییر دایرکتوری از بک‌اندهایی که فاقد دایرکتوری هستند (Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
backend
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]Shutdown\f[R] در بک‌اندهایی که از oauth استفاده می‌کنند و خاموش‌سازی درست oauth (rkonfj)
.RE
.IP \[bu] 2
bisync
.RS 2
.IP \[bu] 2
مدیریت یکپارچه نرمال‌سازی یونی‌کد و بزرگی و کوچکی حروف (nielash)
.IP \[bu] 2
مشکل شناخته‌شده بارگذاری‌های ناقص روی \f[V]local\f[R]/\f[V]ftp\f[R]/\f[V]sftp\f[R] برطرف شد (مگر در صورت استفاده از \f[V]--inplace\f[R]) (nielash)
.IP \[bu] 2
اصلاح مدیریت نرمال‌سازی یونی‌کد و عدم حساسیت به بزرگی و کوچکی حروف، پشتیبانی از \f[V]--fix-case\f[R] (https://rclone.org/docs/#fix-case)، \f[V]--ignore-case-sync\f[R]، \f[V]--no-unicode-normalization\f[R] (nielash)
.IP \[bu] 2
ابزار bisync دیگر در یافتن فایل فهرست صحیح هنگامی که پیکربندی‌ها با پرچم‌های ویژه بک‌اند بازنویسی شده‌اند، با خطا مواجه نمی‌شود. (nielash)
.RE
.IP \[bu] 2
nfsmount
.RS 2
.IP \[bu] 2
اصلاح خروج پس از unmount خارجی (nielash)
.IP \[bu] 2
رفع مشکل نادیده گرفته شدن \f[V]--volname\f[R] (nielash)
.RE
.IP \[bu] 2
operations
.RS 2
.IP \[bu] 2
رفع مشکل تغییر نام فایل در macOS (nielash)
.IP \[bu] 2
رفع جابه‌جایی‌های غیرحساس به بزرگی و کوچکی حروف در operations.Move (nielash)
.IP \[bu] 2
رفع TestCaseInsensitiveMoveFileDryRun در تست‌های یکپارچگی chunker (nielash)
.IP \[bu] 2
رفع آزمون TestMkdirModTime (Nick Craig-Wood)
.IP \[bu] 2
رفع TestSetDirModTime برای بک‌اندهایی که دارای SetDirModTime هستند ولی فاقد Metadata می‌باشند (Nick Craig-Wood)
.IP \[bu] 2
رفع غلط املایی در پیام‌های لاگ (nielash)
.RE
.IP \[bu] 2
serve nfs: رفع مشکل نوشتن فایل‌ها از طریق Finder در macOS (nielash)
.IP \[bu] 2
serve restic: اصلاح مدیریت خطا (Michael Eischer)
.IP \[bu] 2
serve webdav: اصلاح \f[V]--baseurl\f[R] بدون / ابتدایی (Nick Craig-Wood)
.IP \[bu] 2
stats: رفع شرایط رقابتی (race) بین ResetCounters و stopAverageLoop فراخوانی‌شده از time.AfterFunc (Nick Craig-Wood)
.IP \[bu] 2
sync
.RS 2
.IP \[bu] 2
پرچم \f[V]--fix-case\f[R] برای تغییر نام مقصد غیرحساس به بزرگی و کوچکی حروف (nielash)
.IP \[bu] 2
استفاده از operations.DirMove به‌جای sync.MoveDir برای \f[V]--fix-case\f[R] (nielash)
.RE
.RE.IP \[bu] 2
systemd: اصلاح شناسایی و جابه‌جایی به بسته coreos در همه‌جا به‌جای داشتن ۲ کتابخانه جداگانه (Anagh Kumar Baranwal)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
رفع مشکل عدم تشخیص خطاها در macOS هنگام استفاده از \f[V]--daemon\f[R] (Nick Craig-Wood)
.IP \[bu] 2
تشخیص بسیار سریع‌تر متوقف شدن daemon (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع مشکل نرمال‌سازی یونیکد در macOS (nielash)
.RE
.IP \[bu] 2
Bisync
.RS 2
.IP \[bu] 2
کپی‌ها و حذف‌ها اکنون به‌جای دو عملیات، در یک عملیات انجام می‌شوند (nielash)
.IP \[bu] 2
گزینه‌های \f[V]--track-renames\f[R] و \f[V]--backup-dir\f[R] اکنون پشتیبانی می‌شوند (nielash)
.IP \[bu] 2
فهرست‌های نهایی اکنون برای جلوگیری از نیاز به فهرست‌گیری مجدد، از نتایج sync ایجاد می‌شوند (nielash)
.IP \[bu] 2
ابزار Bisync اکنون در برابر تغییراتی که در حین اجرای bisync رخ می‌دهند بسیار تاب‌آورتر است و بسیار کمتر دچار خطاهای بحرانی یا تغییرات تشخیص‌داده‌نشده می‌شود (nielash)
.IP \[bu] 2
ابزار Bisync اکنون قادر است در موارد عدم قطعیت، فهرست فایل را بازگردانی کند؛ در واقع فایل را به عنوان نیازمند بررسی مجدد در دفعه بعد علامت‌گذاری می‌کند. (nielash)
.IP \[bu] 2
چندین رنگ پایه‌ای ترمینال اکنون پشتیبانی می‌شوند که با \f[V]--color\f[R] (https://rclone.org/docs/#color-autoneveralways) قابل کنترل هستند (\f[V]AUTO\f[R]|\f[V]NEVER\f[R]|\f[V]ALWAYS\f[R]) (nielash)
.IP \[bu] 2
تصاویر لحظه‌ای (snapshots) فهرست اولیه از Path1 و Path2 اکنون به‌صورت هم‌روند و با استفاده از همان زیرساخت \[dq]march\[dq] مانند \f[V]check\f[R] و \f[V]sync\f[R] ایجاد می‌شوند، جهت بهبود عملکرد و کاهش خطر خطا. (nielash)
.IP \[bu] 2
گزینه \f[V]--resync\f[R] اکنون بسیار کارآمدتر شده است (به‌ویژه برای کاربران \f[V]--create-empty-src-dirs\f[R]) (nielash)
.IP \[bu] 2
فایل‌های Google Docs (و سایر فایل‌های با اندازه نامشخص) اکنون پشتیبانی می‌شوند (با همان گزینه‌های موجود در \f[V]sync\f[R]) (nielash)
.IP \[bu] 2
بررسی‌های برابری پیش از تغییر نام ناشی از تداخل همگام‌سازی، اکنون در صورت در دسترس نبودن \f[V]check\f[R]، به‌جای \f[V]--size-only\f[R] در صورت امکان به \f[V]cryptcheck\f[R] یا \f[V]--download\f[R] واگذار می‌شوند (fallback) (nielash)
.IP \[bu] 2
ابزار Bisync اکنون به‌طور کامل از مقایسه بر اساس هر ترکیبی از size، modtime و checksum پشتیبانی می‌کند و محدودیت قبلی در backendهای بدون پشتیبانی از modtime را برمی‌دارد. (nielash)
.IP \[bu] 2
ابزار Bisync اکنون از حالت \[dq]Graceful Shutdown\[dq] برای لغو پاکیزه و زودهنگام یک اجرا بدون نیاز به \f[V]--resync\f[R] پشتیبانی می‌کند. (nielash)
.IP \[bu] 2
پرچم جدید \f[V]--recover\f[R] امکان بازیابی پایدار در صورت بروز وقفه را بدون نیاز به \f[V]--resync\f[R] فراهم می‌کند. (nielash)
.IP \[bu] 2
تنظیم جدید \f[V]--max-lock\f[R] امکان تمدید و انقضای خودکار فایل‌های قفل را برای بازیابی خودکار بهتر هنگام بروز وقفه در اجرا فراهم می‌کند. (nielash)
.IP \[bu] 2
ابزار Bisync اکنون از حل خودکار تداخل‌های sync و شخصی‌سازی رفتار تغییر نام با پرچم‌های جدید \f[V]--conflict-resolve\f[R]، \f[V]--conflict-loser\f[R] و \f[V]--conflict-suffix\f[R] پشتیبانی می‌کند. (nielash)
.IP \[bu] 2
پرچم جدید \f[V]--resync-mode\f[R] امکان کنترل بیشتر روی این‌که کدام نسخه از یک فایل در طول یک \f[V]--resync\f[R] نگه داشته شود را فراهم می‌کند. (nielash)
.IP \[bu] 2
ابزار Bisync اکنون از \f[V]--retries\f[R] (https://rclone.org/docs/#retries-int) و \f[V]--retries-sleep\f[R] (هنگامی که \f[V]--resilient\f[R] تنظیم شده باشد) پشتیبانی می‌کند. (nielash)
.IP \[bu] 2
شفاف‌سازی جهت عملیات فایل در لاگ‌های dry-run (Kyle Reynolds)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع مشکل cleanRootPath در Windows پس از به‌روزرسانی go1.21.4 stdlib (nielash)
.IP \[bu] 2
پیاده‌سازی تنظیم زمان تغییر (modification time) روی دایرکتوری‌ها (nielash)
.IP \[bu] 2
پیاده‌سازی modtime و متادیتا برای دایرکتوری‌ها (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل تنظیم btime روی دایرکتوری‌ها در Windows (Nick Craig-Wood)
.IP \[bu] 2
حذف پیاده‌سازی backend از Purge برای افزایش سرعت و ثبت آمار (Nick Craig-Wood)
.IP \[bu] 2
پشتیبانی از تنظیم و نگاشت متادیتا در Move سمت سرور (Nick Craig-Wood)
.RE
.IP \[bu] 2
Cache
.RS 2
.IP \[bu] 2
پیاده‌سازی تنظیم زمان تغییر روی دایرکتوری‌ها (در صورت پشتیبانی توسط remote تحت پوشش) (nielash)
.IP \[bu] 2
پیاده‌سازی تنظیم متادیتا روی دایرکتوری‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
پیاده‌سازی تنظیم زمان تغییر روی دایرکتوری‌ها (در صورت پشتیبانی توسط remote تحت پوشش) (nielash)
.IP \[bu] 2
پیاده‌سازی تنظیم متادیتا روی دایرکتوری‌ها (Nick Craig-Wood)
.IP \[bu] 2
بهبود مدیریت نام‌های فایل غیرقابل رمزگشایی (nielash)
.IP \[bu] 2
افزودن بررسی خطای جاافتاده که توسط linter شناسایی شد (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]--azureblob-delete-snapshots\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
شفاف‌سازی دقیق عملکرد \f[V]--b2-download-auth-duration\f[R] در مستندات (Nick Craig-Wood)
.RE
.IP \[bu] 2
Chunker
.RS 2
.IP \[bu] 2
پیاده‌سازی تنظیم زمان تغییر روی دایرکتوری‌ها (در صورت پشتیبانی توسط remote تحت پوشش) (nielash)
.IP \[bu] 2
پیاده‌سازی تنظیم متادیتا روی دایرکتوری‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Combine
.RS 2
.IP \[bu] 2
پیاده‌سازی تنظیم زمان تغییر روی دایرکتوری‌ها (در صورت پشتیبانی توسط remote تحت پوشش) (nielash)
.IP \[bu] 2
پیاده‌سازی تنظیم متادیتا روی دایرکتوری‌ها (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای متادیتای دایرکتوری در ریشه upstream (nielash)
.IP \[bu] 2
رفع مشکل انتقال دایرکتوری در میان upstreamها (nielash)
.RE
.IP \[bu] 2
Compress
.RS 2
.IP \[bu] 2
پیاده‌سازی تنظیم زمان تغییر روی دایرکتوری‌ها (در صورت پشتیبانی توسط remote تحت پوشش) (nielash)
.IP \[bu] 2
پیاده‌سازی تنظیم متادیتا روی دایرکتوری‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2.IP \[bu] 2
پیاده‌سازی تنظیم زمان تغییر (modification time) برای دایرکتوری‌ها (nielash)
.IP \[bu] 2
پیاده‌سازی تنظیم modtime و متادیتا برای دایرکتوری‌ها (Nick Craig-Wood)
.IP \[bu] 2
پشتیبانی از تنظیم و نگاشت متادیتا در Move و Copy سمت سرور (Nick
Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
رفع مشکل mkdir در rsftp که کد نادرست بازمی‌گرداند (Nick Craig-Wood)
.RE
.IP \[bu] 2
Hasher
.RS 2
.IP \[bu] 2
پیاده‌سازی تنظیم زمان تغییر برای دایرکتوری‌ها (در صورت پشتیبانی ریموت
پوشش‌یافته) (nielash)
.IP \[bu] 2
پیاده‌سازی تنظیم متادیتا برای دایرکتوری‌ها (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای ناشی از تلاش برای توقف پایگاه داده‌ای که پیش‌تر متوقف شده است (nielash)
.IP \[bu] 2
جستجو برای هش کش‌شده در صورت خالی بودن غیرمنتظرهٔ هش ارائه‌شده (nielash)
.RE
.IP \[bu] 2
Imagekit
.RS 2
.IP \[bu] 2
به‌روزرسانی مستندات و محتوای وب (Harshit Budhraja)
.IP \[bu] 2
به‌روزرسانی نمای کلی \- عملیات پشتیبانی‌شده (Harshit Budhraja)
.RE
.IP \[bu] 2
Mega
.RS 2
.IP \[bu] 2
رفع panic در go1.22 (Nick Craig-Wood)
.RE
.IP \[bu] 2
Netstorage
.RS 2
.IP \[bu] 2
اصلاح متد Root برای بازگرداندن دایرکتوری صحیح هنگام اشاره به یک فایل (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از متادیتا (nielash)
.RE
.IP \[bu] 2
Opendrive
.RS 2
.IP \[bu] 2
رفع مشکل انتقال فایل/پوشه در همان دایرکتوری والد (nielash)
.RE
.IP \[bu] 2
Oracle Object Storage
.RS 2
.IP \[bu] 2
پشتیبانی از دستور \f[V]backend restore\f[R] (Nikhil Ahuja)
.IP \[bu] 2
پشتیبانی از احراز هویت workload identity برای OKE (Anders Swanson)
.RE
.IP \[bu] 2
Protondrive
.RS 2
.IP \[bu] 2
اصلاح کدگذاری متد Root (Nick Craig-Wood)
.RE
.IP \[bu] 2
Quatrix
.RS 2
.IP \[bu] 2
اصلاح هدر \f[V]Content-Range\f[R] (Volodymyr)
.IP \[bu] 2
افزودن گزینه‌ای برای صرف‌نظر کردن از پوشه‌های پروژه (Oksana Zhykina)
.IP \[bu] 2
اصلاح متد Root برای بازگرداندن دایرکتوری صحیح هنگام اشاره به یک فایل (Nick
Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن \f[V]--s3-version-deleted\f[R] جهت نمایش نشانگرهای حذف در فهرست‌ها
هنگام استفاده از نسخه‌بندی.
(Nick Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی از IPv6 با گزینهٔ \f[V]--s3-use-dual-stack\f[R] (Anthony
Metzidis)
.IP \[bu] 2
کپی موازی بخش‌ها هنگام انجام کپی تکه‌ای (chunked) در سمت سرور (Nick
Craig-Wood)
.IP \[bu] 2
ارائه‌دهندهٔ GCS: رفع مشکل کپی سمت سرور برای فایل‌های بزرگ‌تر از 5G (Nick
Craig-Wood)
.IP \[bu] 2
پشتیبانی از تنظیم و نگاشت متادیتا در Copy سمت سرور (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Seafile
.RS 2
.IP \[bu] 2
رفع خطای دانلود/آپلود هنگامی که \f[V]FILE_SERVER_ROOT\f[R] نسبی است
(DanielEgbers)
.IP \[bu] 2
اصلاح متد Root برای بازگرداندن دایرکتوری صحیح هنگام اشاره به یک فایل (Nick
Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
پیاده‌سازی تنظیم زمان تغییر برای دایرکتوری‌ها (nielash)
.IP \[bu] 2
تنظیم پرچم به‌روزرسانی modtimeهای دایرکتوری هنگام نوشتن (Nick Craig-Wood)
.IP \[bu] 2
کاهش تأخیر انتظار برای باینری‌های خارجی ssh با توجه به استفاده از
go1.20 (Nick Craig-Wood)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
جلوگیری از بررسی غیرضروری نسخه‌بندی کانتینر (Joe Cai)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
پیاده‌سازی تنظیم زمان تغییر برای دایرکتوری‌ها (در صورت پشتیبانی ریموت
پوشش‌یافته) (nielash)
.IP \[bu] 2
پیاده‌سازی تنظیم متادیتا برای دایرکتوری‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
کاهش اولویت لاگ‌های مربوط به آپلود تکه‌ها (chunks) (Gabriel Ramos)
.IP \[bu] 2
owncloud: افزودن پیکربندی \f[V]owncloud_exclude_shares\f[R] جهت مستثنی
کردن فایل‌ها و پوشه‌های اشتراکی هنگام فهرست‌کردن منابع ریموت (Thomas
Müller)
.RE.SS v1.65.2 \- 2024-01-24
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.65.1...v1.65.2)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
build: ارتقای github.com/cloudflare/circl از 1.3.6 به 1.3.7 (dependabot)
.IP \[bu] 2
به‌روزرسانی‌های مستندات (Nick Craig-Wood, kapitainsky, nielash, Tera, Harshit
Budhraja)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع مشکل داده‌های کهنه هنگام استفاده از \f[V]--vfs-cache-mode\f[R] full (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
\f[B]مهم\f[R] رفع باگ خرابی داده‌ها \- مشاهده
#7590 (https://github.com/rclone/rclone/issues/7590) (Nick Craig-Wood)
.RE
.SS v1.65.1 \- 2024-01-08
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.65.0...v1.65.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
ارتقای golang.org/x/crypto برای رفع آسیب‌پذیری ssh terrapin CVE-2023-48795 (dependabot)
.IP \[bu] 2
به‌روزرسانی به go1.21.5 برای رفع مشکلات مسیرهای Windows (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل ساخت docker در arm/v6 (Nick Craig-Wood)
.RE
.IP \[bu] 2
install.sh: رفع پیام خطای بی‌ضرر هنگام نصب (Nick Craig-Wood)
.IP \[bu] 2
accounting: رفع آمار جهت نمایش انتقال‌های سمت سرور (Nick Craig-Wood)
.IP \[bu] 2
اصلاحات مستندات (albertony, ben-ba, Eli Orzitzer, emyarod, keongalvin,
rarspace01)
.IP \[bu] 2
nfsmount: کامپایل برای همه سیستم‌عامل‌های unix، افزودن \f[V]--sudo\f[R] و رفع
مدیریت خطا/گزینه‌ها (Nick Craig-Wood)
.IP \[bu] 2
operations: رفع مشکلی که فایل‌های جابه‌جاشده با rclone move به‌عنوان انتقال
شمرده نمی‌شدند (Nick Craig-Wood)
.IP \[bu] 2
oauthutil: جلوگیری از panic هنگامی که \f[V]*token\f[R] و \f[V]*ts.token\f[R] یکسان
هستند (rkonfj)
.IP \[bu] 2
serve s3: رفع اشکالات و رفتارهای غیرعادی در فهرست‌گیری (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
ذکر این نکته که \f[V]--vfs-refresh\f[R] در پس‌زمینه اجرا می‌شود (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Azurefiles
.RS 2
.IP \[bu] 2
رفع url پایه فضای ذخیره‌سازی (Oksana)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
رفع مشکل حذف فایل در صورت اجرای rclone move روی همان فایل (Nick Craig-Wood)
.RE
.IP \[bu] 2
Chunker
.RS 2
.IP \[bu] 2
رفع مشکل حذف فایل در صورت اجرای rclone move روی همان فایل (Nick Craig-Wood)
.RE
.IP \[bu] 2
Compress
.RS 2
.IP \[bu] 2
رفع مشکل حذف فایل در صورت اجرای rclone move روی همان فایل (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
رفع محاسبه فضای مصرفی در حساب‌های تیمی dropbox (Nick Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
رفع کپی چندنخی (WeidiDeng)
.RE
.IP \[bu] 2
Googlephotos
.RS 2
.IP \[bu] 2
رفع خطای اشاره‌گر nil هنگام شکست پردازش دسته‌ای (Nick Craig-Wood)
.RE
.IP \[bu] 2
Hasher
.RS 2
.IP \[bu] 2
رفع مشکل حذف فایل در صورت اجرای rclone move روی همان فایل (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای نشانی حافظه نامعتبر هنگامی که MaxAge == 0 است (nielash)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
رفع خطا در فهرست‌گیری: نوع شیء ناشناخته \f[V]<nil>\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع خطاهای \[dq]unauthenticated: Unauthenticated\[dq] هنگام بارگذاری
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Oracleobjectstorage
.RS 2
.IP \[bu] 2
رفع اندپوینت object storage برای اندپوینت‌های سفارشی (Manoj Ghosh)
.IP \[bu] 2
ایجاد باکت در Multipart copy در صورت عدم وجود آن.
(Manoj Ghosh)
.RE
.IP \[bu] 2
Protondrive
.RS 2
.IP \[bu] 2
رفع CVE-2023-45286 / GHSA-xwh9-gc39-5298 (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع کرش در صورت نبود UploadId در بارگذاری چندبخشی (Nick Craig-Wood)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
رفع مشکل فهرست نشدن اشتراک‌ها با به‌روزرسانی go-smb2 (halms)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
رفع مشکل حذف فایل در صورت اجرای rclone move روی همان فایل (Nick Craig-Wood)
.RE.SS v1.65.0 - 2023-11-26
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.64.0...v1.65.0)
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
Azure Files (karan, moongdal, Nick Craig-Wood)
.IP \[bu] 2
ImageKit (Abhinav Dhiman)
.IP \[bu] 2
Linkbox (viktor, Nick Craig-Wood)
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
\f[V]serve s3\f[R]: امکان عمل کردن rclone به عنوان یک سرور سازگار با S3 (Mikubill,
Artur Neumann, Saw-jan, Nick Craig-Wood)
.IP \[bu] 2
\f[V]nfsmount\f[R]: دستور mount جهت فراهم کردن سازوکار سوار کردن در macOS
بدون FUSE (Saleh Dindar)
.IP \[bu] 2
\f[V]serve nfs\f[R]: سرویس‌دهی یک ریموت جهت استفاده توسط \f[V]nfsmount\f[R]
(Saleh Dindar)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
install.sh: پاک‌سازی فایل‌های موقت در اسکریپت نصب (Jacob Hands)
.IP \[bu] 2
ساخت
.RS 2
.IP \[bu] 2
به‌روزرسانی تمام وابستگی‌ها (Nick Craig-Wood)
.IP \[bu] 2
بازسازی مدیریت اطلاعات نسخه و منابع آیکون در windows (albertony)
.RE
.IP \[bu] 2
به‌روزرسانی‌های مستندات (albertony, alfish2000, asdffdsazqqq, Dimitri Papadopoulos,
Herby Gillot, Joda Stößer, Manoj Ghosh, Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی \f[V]--metadata-mapper\f[R] برای تبدیل فراداده با استفاده از یک برنامه
ارائه‌شده توسط کاربر (Nick Craig-Wood)
.IP \[bu] 2
افزودن پرچم قابلیت \f[V]ChunkWriterDoesntSeek\f[R] و تنظیم آن برای b2 (Nick
Craig-Wood)
.IP \[bu] 2
lib/http: برون‌ریزی توابع پایه‌ای رشته در go جهت استفاده در
\f[V]--template\f[R] (Gabriel Espinoza)
.IP \[bu] 2
makefile: استفاده از آرگومان‌های نصب سازگار با POSIX (Mina Galić)
.IP \[bu] 2
عملیات‌ها
.RS 2
.IP \[bu] 2
مصرف حافظه کمتر هنگام انجام آپلودهای چندرشته‌ای (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی \f[V]--partial-suffix\f[R] برای کنترل پسوند نام فایل‌های موقت
(Volodymyr)
.RE
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن \f[V]operations/check\f[R] به API مربوط به rc (Nick Craig-Wood)
.IP \[bu] 2
گزارش همیشگی خطاها به صورت JSON (Nick Craig-Wood)
.IP \[bu] 2
تنظیم سرایند \f[V]Last-Modified\f[R] برای فایل‌های ارائه‌شده توسط
\f[V]--rc-serve\f[R] (Nikita Shoshin)
.RE
.IP \[bu] 2
size: عدم نمایش تعداد اشیای تکراری هنگامی که کمتر از 1k باشد (albertony)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
fshttp: رفع نادیده گرفته شدن \f[V]--contimeout\f[R] (你知道未来吗)
.IP \[bu] 2
march: رفع موازی‌سازی بیش‌ازحد در صورت استفاده از \f[V]--no-traverse\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
ncdu: رفع خرابی هنگام ورود مجدد به پوشه تغییریافته پس از اسکن دوباره (Nick
Craig-Wood)
.IP \[bu] 2
عملیات‌ها
.RS 2
.IP \[bu] 2
رفع رونویسی در مقصد هنگام شکست انتقال چندرشته‌ای (Nick
Craig-Wood)
.IP \[bu] 2
رفع خطای UTF-8 نامعتبر هنگام کوتاه‌سازی نام فایل‌ها در زمان عدم استفاده از
\f[V]--inplace\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
serve dnla: رفع خرابی هنگام خروج مرتب (graceful exit) (wuxingzhong)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
غیرفعال‌سازی mount برای freebsd و ایجاد نام مستعار cmount به عنوان mount در آن پلتفرم
(Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--vfs-refresh\f[R] جهت خواندن تمام پوشه‌ها در هنگام راه‌اندازی
(Beyond Meat)
.IP \[bu] 2
پیاده‌سازی متد Name() در WriteFileHandle و ReadFileHandle (Saleh
Dindar)
.IP \[bu] 2
افزودن وابستگی go-billy و اطمینان از پیاده‌سازی billy.File توسط vfs.Handle
(Saleh Dindar)
.IP \[bu] 2
خروج زودهنگام با خطا در صورت عدم امکان آپلود فایل با طول صفر (Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع مشکل کپی کردن از Windows Volume Shadows (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از لایه دسترسی سرد (cold tier) (Ivan Yanitra)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
پیاده‌سازی \[dq]rclone backend lifecycle\[dq] برای خواندن و تنظیم چرخه
حیات باکت‌ها (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی \f[V]--b2-lifecycle\f[R] برای کنترل چرخه حیات در هنگام ساخت
باکت‌ها (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل فهرست کردن همه باکت‌ها در زمانی که نیازی به آن نیست (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل آپلود چندرشته‌ای با copyto که به نام اشتباهی ارسال می‌شد (Nick
Craig-Wood)
.IP \[bu] 2
رفع کپی تکه‌تکه‌شده سمت سرور زمانی که اندازه فایل دقیقاً برابر با
\f[V]--b2-copy-cutoff\f[R] بود (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل جریان‌دهی فایل‌های تکه‌تکه‌شده‌ای که دقیقاً مضربی از اندازه تکه بودند (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
فیلتر کردن EventIDهای بیشتر هنگام نظرسنجی (David Sze)
.IP \[bu] 2
افزودن لاگ‌های بیشتر برای فرآیند نظرسنجی (David Sze)
.IP \[bu] 2
رفع مشکل کارایی هنگام خواندن فراداده برای تک‌فایل‌ها (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از خواندن/نوشتن فراداده (Nick Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی از چکسام‌های SHA-1 و SHA-256 (rinsuki)
.IP \[bu] 2
افزودن \f[V]--drive-show-all-gdocs\f[R] جهت امکان کپی سمت سرور برای
فایل‌های gdocs غیرقابل صدور (Nick Craig-Wood)
.IP \[bu] 2
افزودن یادداشتی مبنی بر اینکه \f[V]--drive-scope\f[R] فهرستی جداشده با کاما از
scopeها را می‌پذیرد (Keigo Imai)
.IP \[bu] 2
رفع خطا هنگام به‌روزرسانی فراداده زمان ایجاد روی شیء موجود (Nick
Craig-Wood)
.RE.IP \[bu] 2
رفع مشکل آزمون‌های یکپارچه‌سازی با فعال‌سازی پشتیبانی از فراداده از context
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
تفکیک batcher به درون lib/batcher (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل نبود کدگذاری برای rclone purge (Nick Craig-Wood)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
رفع خطاهای 400 Bad request هنگام استفاده از کپی چندنخی (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Googlephotos
.RS 2
.IP \[bu] 2
پیاده‌سازی batcher برای بارگذاری‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Hdfs
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از فهرستی از namenodeها در پیکربندی ریموت hdfs
(Tayo-pasedaRJ)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
پیاده‌سازی دستور set backend برای به‌روزرسانی backend در حال اجرا (Nick
Craig-Wood)
.IP \[bu] 2
فعال‌سازی متدهای مورد استفاده با WebDAV (Alen Šiljak)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از خواندن و نوشتن فراداده (albertony)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
پیاده‌سازی متد ListR که پشتیبانی از \f[V]--fast-list\f[R] را فراهم می‌کند (Nick
Craig-Wood)
.RS 2
.IP \[bu] 2
این قابلیت باید با پرچم \f[V]--onedrive-delta\f[R] فعال شود
.RE
.RE
.IP \[bu] 2
Quatrix
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از بارگذاری جزئی (Oksana Zhykina)
.IP \[bu] 2
بازنویسی فایل‌ها در صورت بروز تداخل هنگام جابه‌جایی سمت سرور (Oksana Zhykina)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن ارائه‌دهنده Linode (Nick Craig-Wood)
.IP \[bu] 2
افزودن مستندات درباره نحوه افزودن یک ارائه‌دهنده جدید (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل عدم بازگردانی خطا هنگام ایجاد باکتی که مالک آن نیستیم
(Nick Craig-Wood)
.IP \[bu] 2
ارسال پیام اشکال‌زدایی در صورت استفاده از اعتبارسنجی ناشناس (Nick
Craig-Wood)
.IP \[bu] 2
افزودن پرچم \f[V]--s3-disable-multipart-uploads\f[R] (Nick Craig-Wood)
.IP \[bu] 2
تشخیص حلقه هنگام استفاده از gcs و نسخه‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]--sftp-copy-is-hardlink\f[R] برای کپی سمت سرور به‌صورت
پیوند سخت (hardlink) (Nick Craig-Wood)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
رفع اندازه نادرست \f[V]about\f[R] با جابه‌جایی به
انشعاب \f[V]github.com/cloudsoda/go-smb2\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع زمان تغییر (modtime) بارگذاری‌های چندنخی با تنظیم PartialUploads (Nick
Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
افزودن ارائه‌دهنده rclone برای کار با \f[V]rclone serve webdav\f[R]
(Adithya Kumar)
.RE.SS v1.64.2 - 2023-10-19
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.64.1...v1.64.2)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
selfupdate: رفع خطای \[dq]invalid hashsum signature\[dq] (Nick
Craig-Wood)
.IP \[bu] 2
build: رفع مشکل کمبود فضای ذخیره‌سازی در docker build (Nick Craig-Wood)
.RE
.SS v1.64.1 - 2023-10-17
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.64.0...v1.64.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
cmd: هماهنگ‌سازی قالب لاگ‌های خروجی \f[V]--progress\f[R] با حالت بدون آن
(Nick Craig-Wood)
.IP \[bu] 2
اصلاحات مستندات (Dimitri Papadopoulos Orfanos, Herby Gillot, Manoj Ghosh,
Nick Craig-Wood)
.IP \[bu] 2
lsjson: اطمینان از تنظیم پرچم سراسری متادیتا (Nick Craig-Wood)
.IP \[bu] 2
operations
.RS 2
.IP \[bu] 2
اطمینان از اینکه همزمانی بیشتر از تعداد تکه‌ها (chunks) نباشد (Pat
Patterson)
.IP \[bu] 2
رفع نادیده گرفته شدن OpenOptions در copy در صورتی که عملیات از نوع multiThreadCopy باشد
(Vitor Gomes)
.IP \[bu] 2
اصلاح پیام خطای delete برای در بر داشتن نام فایل (Nick Craig-Wood)
.RE
.IP \[bu] 2
serve sftp: بازگرداندن خطای پشتیبانی‌نشده برای دستورهای پشتیبانی‌نشده (Nick
Craig-Wood)
.IP \[bu] 2
build: ارتقای golang.org/x/net به v0.17.0 برای رفع آسیب‌پذیری HTTP/2 rapid reset
(Nick Craig-Wood)
.IP \[bu] 2
pacer: رفع بن‌بست (deadlock) در b2 با تنظیم پیش‌فرض حداکثر اتصالات به نامحدود (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
رفع عدم تشخیص آماده بودن درایو توسط automount (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع اشکال به‌روزرسانی زمان تغییر دایرکتوری (Saleh Dindar)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
رفع خطای \[dq]fatal error: concurrent map writes\[dq] (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
رفع خطای multipart upload: corrupted on transfer: sizes differ XXX vs 0 (Nick
Craig-Wood)
.IP \[bu] 2
رفع پنجره قفل‌گذاری (locking window) هنگام دریافت URL بارگذاری چندبخشی (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال کپی‌های سمت سرور بزرگ‌تر از 4 گیگابایت (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال بارگذاری‌های جریانی تکه‌ای (chunked streaming uploads) (Nick Craig-Wood)
.IP \[bu] 2
کاهش مقدار پیش‌فرض \f[V]--b2-upload-concurrency\f[R] به 4 جهت کاهش مصرف حافظه (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
اصلاح پیکربندی‌کننده برای مجاز شمردن \f[V]/teams/ID\f[R] در پیکربندی (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Oracleobjectstorage
.RS 2
.IP \[bu] 2
رفع نادیده گرفته شدن OpenOptions در uploadMultipart همراه با chunkWriter (Nick
Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع خطای slice bounds out of range هنگام فهرست‌گیری (Nick Craig-Wood)
.IP \[bu] 2
رفع نادیده گرفته شدن OpenOptions در uploadMultipart همراه با chunkWriter (Vitor
Gomes)
.RE
.IP \[bu] 2
Storj
.RS 2
.IP \[bu] 2
به‌روزرسانی storj.io/uplink به v1.12.0 (Kaloyan Raev)
.RE.SS v1.64.0 - 2023-09-11
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.63.0...v1.64.0)
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
Proton Drive (https://rclone.org/protondrive) (Chun-Hung Tseng)
.IP \[bu] 2
Quatrix (https://rclone.org/quatrix) (Oksana, Volodymyr Kit)
.IP \[bu] 2
ارائه‌دهندگان جدید S3
.RS 2
.IP \[bu] 2
Synology C2 (https://rclone.org/s3/#synology-c2) (BakaWang)
.IP \[bu] 2
Leviia (https://rclone.org/s3/#leviia) (Benjamin)
.RE
.IP \[bu] 2
ارائه‌دهندگان جدید Jottacloud
.RS 2
.IP \[bu] 2
Onlime (https://rclone.org/jottacloud) (Fjodor42)
.IP \[bu] 2
Telia Sky (https://rclone.org/jottacloud) (NoLooseEnds)
.RE
.RE
.IP \[bu] 2
تغییرات عمده
.RS 2
.IP \[bu] 2
انتقال‌های چندرشته‌ای (Vitor Gomes, Nick Craig-Wood, Manoj Ghosh, Edwin
Mackenzie-Owen)
.RS 2
.IP \[bu] 2
انتقال‌های چندرشته‌ای اکنون هنگام انتقال به مقصدهای زیر در دسترس هستند:
.RS 2
.IP \[bu] 2
\f[V]local\f[R]، \f[V]s3\f[R]، \f[V]azureblob\f[R]، \f[V]b2\f[R]،
\f[V]oracleobjectstorage\f[R] و \f[V]smb\f[R]
.RE
.IP \[bu] 2
این قابلیت سرعت انتقال بین دو منبع شبکه‌ای را تا حد زیادی بهبود می‌بخشد.
.IP \[bu] 2
بافرسازی درون حافظه میان تمامی بک‌اندها یکپارچه شده است و حافظه را بهتر به اشتراک می‌گذارد.
.IP \[bu] 2
برای اطلاعات بیشتر مستندات \f[V]--multi-thread\f[R] را ببینید (https://rclone.org/docs/#multi-thread-cutoff)
.RE
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
سازوکار پشتیبانی از \f[V]rclone config redacted\f[R] برای نمایش پیکربندی پالایش‌شده (Nick Craig-Wood)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
نمایش آمار سمت سرور در خطوط اختصاصی و نه به صورت بایت‌های منتقل‌شده (Nick
Craig-Wood)
.RE
.IP \[bu] 2
bisync
.RS 2
.IP \[bu] 2
افزودن گزینه جدید \f[V]--ignore-listing-checksum\f[R] برای تمایز از
\f[V]--ignore-checksum\f[R] (nielash)
.IP \[bu] 2
افزودن حالت آزمایشی \f[V]--resilient\f[R] برای امکان بازیابی از
خطاهای خود‌اصلاح‌شونده (nielash)
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--create-empty-src-dirs\f[R] (nielash)
.IP \[bu] 2
اجراهای آزمایشی دیگر تغییرات فیلتر را اعمال نمی‌کنند (nielash)
.IP \[bu] 2
اعمال اجباری \f[V]--check-access\f[R] در طول \f[V]--resync\f[R] (nielash)
.IP \[bu] 2
اعمال صحیح فیلترها هنگام حذف (nielash)
.IP \[bu] 2
بررسی برابری پیش از تغییر نام (دست‌نخورده باقی گذاشتن فایل‌های یکسان) (nielash)
.IP \[bu] 2
رفع نادیده گرفته شدن پارامتر rc با نام \f[V]dryRun\f[R] (nielash)
.RE
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
به‌روزرسانی به \f[V]go1.21\f[R] و تعیین \f[V]go1.19\f[R] به عنوان حداقل
نسخه مورد نیاز (Anagh Kumar Baranwal, Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی وابستگی‌ها (Nick Craig-Wood)
.IP \[bu] 2
افزودن روش نصب با snap (hideo aoyama)
.IP \[bu] 2
تغییر وظیفه Winget Releaser به \f[V]ubuntu-latest\f[R] (sitiom)
.RE
.IP \[bu] 2
cmd: بازسازی ساختار و استفاده از sysdnotify در دستورهای بیشتر (eNV25)
.IP \[bu] 2
config: افزودن گزینه \f[V]--multi-thread-chunk-size\f[R] (Vitor Gomes)
.IP \[bu] 2
به‌روزرسانی مستندات (antoinetran, Benjamin, Bjørn Smith, Dean Attali,
gabriel-suela, James Braza, Justin Hellings, kapitainsky, Mahad,
Masamune3210, Nick Craig-Wood, Nihaal Sangha, Niklas Hambüchen, Raymond
Berger, r-ricci, Sawada Tsunayoshi, Tiago Boeing, Vladislav Vorobev)
.IP \[bu] 2
fs
.RS 2
.IP \[bu] 2
استفاده از نوع‌های اتمیک در تمامی بخش‌ها (Roberto Ricci)
.IP \[bu] 2
خروج با کد (10) هنگام رسیدن به محدودیت \f[V]--max-transfer\f[R]
(kapitainsky)
.IP \[bu] 2
افزودن rclone completion powershell \- فقط پیاده‌سازی اولیه (Nick
Craig-Wood)
.RE
.IP \[bu] 2
سرورهای http: امکان تنظیم CORS با گزینه \f[V]--allow-origin\f[R]
(yuudi)
.IP \[bu] 2
lib/rest: حذف بررسی غیرضروری \f[V]nil\f[R] (Eng Zer Jun)
.IP \[bu] 2
ncdu: افزودن کلید میانبر برای پویش مجدد سیستم فایل (eNV25)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن \f[V]executeId\f[R] به فهرست وظایف (yuudi)
.IP \[bu] 2
افزودن \f[V]core/du\f[R] برای سنجش فضای مصرفی دیسک محلی (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]operations/settier\f[R] به API (Drew Stinnett)
.RE
.IP \[bu] 2
rclone test info: افزودن گزینه \f[V]--check-base32768\f[R] جهت بررسی
امکان ذخیره تمام نویسه‌های base32768 (Nick Craig-Wood)
.IP \[bu] 2
rmdirs: حذف هم‌روند دایرکتوری‌ها تحت مدیریت
\f[V]--checkers\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting: متوقف نکردن محاسبه میانگین سرعت انتقال تا زمان
تکمیل عملیات (Jacob Hands)
.IP \[bu] 2
fs: رفع مقداردهی نشدن \f[V]transferTime\f[R] در لاگ‌های JSON (Jacob Hands)
.IP \[bu] 2
fshttp: رفع مشکل اجازه دادن IPv6 توسط \f[V]--bind 0.0.0.0\f[R] و
اجازه دادن IPv4 توسط \f[V]--bind ::0\f[R] (Nick Craig-Wood)
.IP \[bu] 2
operations: رفع بررسی همپوشانی در سیستم فایل‌های غیرحساس به بزرگی و کوچکی حروف (Nick
Craig-Wood)
.IP \[bu] 2
serve dlna: رفع نوع MIME در صورت عدم توانایی بک‌اند در تشخیص آن (Nick
Craig-Wood)
.IP \[bu] 2
serve ftp: رفع وضعیت رقابتی هنگام استفاده از auth proxy (Nick
Craig-Wood)
.IP \[bu] 2
serve sftp: رفع محاسبات هش با \f[V]--vfs-cache-mode full\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
serve webdav: رفع خطای: Expecting fs.Object or fs.Directory, got
\f[V]nil\f[R] (Nick Craig-Wood)
.IP \[bu] 2
sync: رفع قفل شدن با \f[V]--cutoff-mode=soft\f[R] و
\f[V]--max-duration\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Mount
.RS 2.IP \[bu] 2
اصلاح: تجزیه Mount برای linux (Anagh Kumar Baranwal)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
افزودن \f[V]--vfs-cache-min-free-space\f[R] جهت کنترل حداقل فضای خالی روی دیسک حاوی حافظه موقت (Nick Craig-Wood)
.IP \[bu] 2
افزودن پاک‌کننده حافظه موقت برای دایرکتوری‌ها به منظور کاهش مصرف حافظه (Anagh Kumar
Baranwal)
.IP \[bu] 2
به‌روزرسانی زمان تغییر دایرکتوری والد در عملیات‌های vfs (David Pedersen)
.IP \[bu] 2
دقیق نگه داشتن وضعیت دایرکتوری مجازی و کاهش احتمال وقوع بن‌بست (Anagh Kumar Baranwal)
.IP \[bu] 2
حصول اطمینان از هم‌ترازی فیلد struct برای دسترسی اتمیک (Roberto Ricci)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
بازگرداندن خطا توسط Rmdir در صورتی که مسیر یک دایرکتوری نباشد (zjx20)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]OpenChunkWriter\f[R] و بارگذاری‌های چندرشته‌ای (Nick
Craig-Wood)
.IP \[bu] 2
اصلاح ایجاد نشانگرهای دایرکتوری (Nick Craig-Wood)
.IP \[bu] 2
اصلاح پاک‌سازی با نشانگرهای دایرکتوری (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]OpenChunkWriter\f[R] و بارگذاری‌های چندرشته‌ای (Nick
Craig-Wood)
.IP \[bu] 2
اصلاح rclone link هنگامی که مسیر شیء شامل نویسه‌های خاص است (Alishan
Ladhani)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از polling (David Sze)
.IP \[bu] 2
افزودن \f[V]--box-impersonate\f[R] جهت جعل هویت یک شناسه کاربری (Nick
Craig-Wood)
.IP \[bu] 2
اصلاح رمزگشایی غیرمفید پیام‌های خطا به اعداد ده‌دهی (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Chunker
.RS 2
.IP \[bu] 2
به‌روزرسانی مستندات برای ذکر اشکال مربوط به فایل‌های کوچک (Ricardo D\[aq]O.
Albanus)
.RE
.IP \[bu] 2
Compress
.RS 2
.IP \[bu] 2
اصلاح ChangeNotify (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن \f[V]--drive-fast-list-bug-fix\f[R] برای کنترل راه‌حل میانبر باگ ListR
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Fichier
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]DirMove\f[R] (Nick Craig-Wood)
.IP \[bu] 2
اصلاح تجزیه کدهای خطا (alexia)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
افزودن پشتیبانی socks_proxy برای پروکسی‌های SOCKS5 (Zach)
.IP \[bu] 2
اصلاح خطاهای 425 \[dq]TLS session of data connection not resumed\[dq]
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Hdfs
.RS 2
.IP \[bu] 2
تلاش مجدد هنگام مواجهه با خطاهای \[dq]replication in progress\[dq] در حین بارگذاری (Nick
Craig-Wood)
.IP \[bu] 2
اصلاح بارگذاری در شیء نادرست هنگام Update با نام ریموت جایگزین‌شده
(Nick Craig-Wood)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
عدم ارسال CORS در صورت تنظیم نشدن (yuudi)
.IP \[bu] 2
اصلاح پاسخ OPTIONS در webdav (yuudi)
.RE
.IP \[bu] 2
Opendrive
.RS 2
.IP \[bu] 2
اصلاح List روی دایرکتوری‌ای که به تازگی حذف و مجدداً ایجاد شده است (Nick Craig-Wood)
.RE
.IP \[bu] 2
Oracleobjectstorage
.RS 2
.IP \[bu] 2
استفاده از محدودکننده نرخ انتقال rclone در انتقال‌های چندبخشی (Manoj Ghosh)
.IP \[bu] 2
پیاده‌سازی \f[V]OpenChunkWriter\f[R] و بارگذاری‌های چندرشته‌ای (Manoj
Ghosh)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
بازطراحی بارگذاری چندبخشی برای استفاده از \f[V]OpenChunkWriter\f[R] و
\f[V]ChunkWriter\f[R] (Vitor Gomes)
.IP \[bu] 2
انتقال بارگذاری چندبخشی عمومی به \f[V]lib/multipart\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
اصلاح پاک‌سازی دایرکتوری ریشه با \f[V]--s3-directory-markers\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
افزودن دستور \f[V]rclone backend set\f[R] جهت به‌روزرسانی پیکربندی در حال اجرا
(Nick Craig-Wood)
.IP \[bu] 2
افزودن دستور \f[V]rclone backend restore-status\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
توقف استفاده مجدد بارگذاری‌ها از اتصال ssh یکسان جهت بهبود عملکرد
(Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--sftp-ssh\f[R] جهت تعیین یک باینری ssh خارجی برای استفاده (Nick
Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی socks_proxy برای پروکسی‌های SOCKS5 (Zach)
.IP \[bu] 2
پشتیبانی پویا از \f[V]--sftp-path-override\f[R] (nielash)
.IP \[bu] 2
اصلاح هشدار بی‌مورد هنگام استفاده از \f[V]--sftp-ssh\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
پیاده‌سازی نوشتن چندرشته‌ای برای کپی‌ها به smb (Edwin Mackenzie-Owen)
.RE
.IP \[bu] 2
Storj
.RS 2
.IP \[bu] 2
بهبود عملکرد بارگذاری فایل‌های حجیم (Kaloyan Raev)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
اصلاح ارسال درخواست HEAD برای اشیاء با اندازه ۰ در صورت تنظیم بودن \f[V]--swift-no-large-objects\f[R]
(Julian Lepinski)
.RE.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
افزودن \f[V]:writback\f[R] برای عمل به عنوان یک کَش ساده (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
Nextcloud: رفع خطای segment violation در تلاش مجدد سطح‌پایین (low-level retry) (Paul)
.RE
.IP \[bu] 2
Zoho
.RS 2
.IP \[bu] 2
حذف راه‌حل‌های موقت درخواست‌های Range جهت رفع خطای آزمون‌های یکپارچه‌سازی (Nick
Craig-Wood)
.RE
.SS v1.63.1 - 2023-07-17
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.63.0...v1.63.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
build: رفع خطای ساخت macos برای نسخه‌های < 12 (Anagh Kumar Baranwal)
.IP \[bu] 2
dirtree: رفع مشکل کارایی در دایرکتوری‌های بزرگ تو‌در‌تو و
\f[V]--fast-list\f[R] (Nick Craig-Wood)
.IP \[bu] 2
operations
.RS 2
.IP \[bu] 2
رفع بن‌بست (deadlock) هنگام استفاده از \f[V]lsd\f[R]/\f[V]ls\f[R] به همراه
\f[V]--progress\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل بازگردانده نشدن فایل‌های \f[V].rclonelink\f[R] به پیوندهای نمادین
(Nick Craig-Wood)
.RE
.IP \[bu] 2
اصلاحات مستندات (Dean Attali, Mahad, Nick Craig-Wood, Sawada Tsunayoshi,
Vladislav Vorobev)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع خواندن ناقص دایرکتوری برای سیستم‌فایل‌های آسیب‌دیده (Nick Craig-Wood)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
رفع شکست اتصال مجدد با خطای HTTP 400 Bad Request (albertony)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
رفع خطای \[dq]Statfs failed: bucket or container name is needed\[dq] هنگام
سوار کردن (mount) (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
Nextcloud: رفع خطای must use /dav/files/USER endpoint not /webdav
(Paul)
.IP \[bu] 2
Nextcloud chunking: افزودن راهنمایی بیشتر به کاربر جهت بررسی پیکربندی
(darix)
.RE
.SS v1.63.0 - 2023-06-30
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.62.0...v1.63.0)
.IP \[bu] 2
بک‌اند‌های جدید
.RS 2
.IP \[bu] 2
Pikpak (https://rclone.org/pikpak) (wiserain)
.IP \[bu] 2
ارائه‌دهندگان جدید S3
.RS 2
.IP \[bu] 2
petabox.io (https://rclone.org/s3/#petabox) (Andrei Smirnov)
.IP \[bu] 2
Google Cloud Storage (https://rclone.org/s3/#google-cloud-storage)
(Anthony Pessy)
.RE
.IP \[bu] 2
ارائه‌دهندگان جدید WebDAV
.RS 2
.IP \[bu] 2
Fastmail (https://rclone.org/webdav/#fastmail-files) (Arnavion)
.RE
.RE
.IP \[bu] 2
تغییرات عمده
.RS 2
.IP \[bu] 2
هنگام رونوشت به \f[V]local\f[R]، \f[V]ftp\f[R] و \f[V]sftp\f[R]، فایل‌ها ابتدا به یک نام موقت با پسوند \f[V].partial\f[R] رونوشت شده و سپس در انتهای انتقال تغییر نام داده می‌شوند.
(Janne Hellsten, Nick Craig-Wood)
.RS 2
.IP \[bu] 2
این امر به حفظ یکپارچگی داده‌ها کمک می‌کند، زیرا تا زمان تکمیل فایل جدید، فایل موجود حذف نمی‌شود.
.IP \[bu] 2
این قابلیت را می‌توان با پرچم --inplace (https://rclone.org/docs/#inplace)
غیرفعال کرد.
.IP \[bu] 2
این رفتار همچنین در صورت کپسوله‌سازی بک‌اند، برای مثال \f[V]sftp\f[R] پوشش‌داده‌شده با \f[V]crypt\f[R]، اعمال خواهد شد.
.RE
.IP \[bu] 2
بک‌اند‌های s3 (https://rclone.org/s3/#s3-directory-markers)، azureblob و gcs اکنون از نشانگرهای دایرکتوری پشتیبانی می‌کنند و در نتیجه دایرکتوری‌های خالی پشتیبانی می‌شوند (Jānis Bebrītis, Nick Craig-Wood)
.IP \[bu] 2
پرچم --default-time (https://rclone.org/docs/#default-time-time) اکنون
زمان اصلاح نامشخص فایل‌ها/دایرکتوری‌ها را کنترل می‌کند (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
چنانچه فایل یا دایرکتوری دارای زمان اصلاح قابل خواندن برای rclone نباشد،
rclone این زمان ثابت را به جای آن نمایش خواهد داد.
.IP \[bu] 2
برای حفظ رفتار قبلی، از \f[V]--default-time 0s\f[R] استفاده کنید که
این زمان را روی زمان راه‌اندازی rclone تنظیم می‌کند.
.RE
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
مدرن‌سازی linterهای در حال استفاده و اصلاح تمام کدهای متأثر (albertony)
.IP \[bu] 2
ارسال نسخه بتای docker به GHCR (GitHub container registry) (Richard Tweed)
.RE
.IP \[bu] 2
cat: افزودن گزینه \f[V]--separator\f[R] به دستور cat (Loren Gordon)
.IP \[bu] 2
config
.RS 2
.IP \[bu] 2
عدم حذف یا بازنویسی سایر فایل‌ها هنگام ذخیره فایل پیکربندی (albertony)
.IP \[bu] 2
عدم رونویسی پیوند نمادین فایل پیکربندی (albertony)
.IP \[bu] 2
جلوگیری از ایجاد فایل‌های پیکربندی نامعتبر توسط \f[V]config create\f[R] (Nick
Craig-Wood)
.RE
.IP \[bu] 2
به‌روزرسانی‌های مستندات (Adam K, Aditya Basu, albertony, asdffdsazqqq, Damo,
danielkrajnik, Dimitri Papadopoulos, dlitster, Drew Parsons, jumbi77,
kapitainsky, mac-15, Mariusz Suchodolski, Nick Craig-Wood, NickIAm,
Rintze Zelle, Stanislav Gromov, Tareq Sharafy, URenko, yuudi, Zach Kipp)
.IP \[bu] 2
fs
.RS 2
.IP \[bu] 2
افزودن \f[V]size\f[R] به لاگ‌های JSON هنگام جابه‌جایی یا رونوشت یک شیء (Nick
Craig-Wood)
.IP \[bu] 2
امکان فعال‌سازی قابلیت‌های بولی با \f[V]--disable !Feature\f[R]
(Nick Craig-Wood)
.RE
.IP \[bu] 2
genautocomplete: تغییر نام به \f[V]completion\f[R] همراه با ایجاد یک نام مستعار برای نام قدیمی (Nick Craig-Wood)
.IP \[bu] 2
librclone: افزودن مثالی از نحوه استفاده از \f[V]librclone\f[R] با Go (alankrit)
.IP \[bu] 2
lsjson: بهینه‌تر کردن عملکرد \f[V]--stat\f[R] (Nick Craig-Wood)
.IP \[bu] 2
operations
.RS 2.IP \[bu] 2
پیاده‌سازی \f[V]--multi-thread-write-buffer-size\f[R] برای بهبود سرعت
بارگیری‌ها (Paulo Schreiner)
.IP \[bu] 2
بازگشایی مجدد بارگیری‌ها در زمان بروز خطا حین استفاده از \f[V]check --download\f[R] و
\f[V]cat\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
بخش rc: گنجاندن ریموت‌های تعریف‌شده با متغیرهای محیطی در \f[V]config/listremotes\f[R]
(kapitainsky)
.IP \[bu] 2
دستور selfupdate: تبعیت از پرچم \f[V]--no-check-certificate\f[R] (Nick Craig-Wood)
.IP \[bu] 2
دستور serve restic: فعال‌سازی اعلان systemd (Shyim)
.IP \[bu] 2
دستور serve webdav: پیاده‌سازی افزونه‌های owncloud برای checksum و modtime
(WeidiDeng)
.IP \[bu] 2
دستور sync: حفظ پسوندهای دو بخشی مانند \&.tar.gz با استفاده از
\f[V]--suffix-keep-extension\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
یکسان‌سازی معیارهای Prometheus با \f[V]core/stats\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
گرداننده سیگنال Bwlimit همیشه باید آغاز به کار کند (Sam Lai)
.RE
.IP \[bu] 2
بخش bisync: رفع نادیده گرفته شدن پارامتر \f[V]maxDelete\f[R] از طریق rc (Nick
Craig-Wood)
.IP \[bu] 2
بخش cmd/ncdu: رفع به‌هم‌ریختگی صفحه نمایش هنگام ثبت وقایع (eNV25)
.IP \[bu] 2
بخش filter: رفع بن‌بست (deadlock) ناشی از خطاها روی \f[V]--files-from\f[R] (douchen)
.IP \[bu] 2
fs
.RS 2
.IP \[bu] 2
رفع تداخل بین \f[V]--progress\f[R] و \f[V]--interactive\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
رفع فراخوانی بازگشتی نامحدود در ModifyCalculator مربوط به pacer (رفع مشکل
گزارش‌شده توسط لینتر staticcheck) (albertony)
.RE
.IP \[bu] 2
بخش lib/atexit: اطمینان از اینکه OnError تابع cancel را فقط یک بار فراخوانی کند (Nick
Craig-Wood)
.IP \[bu] 2
بخش lib/rest: رفع مشکلات استفاده مجدد از اتصالات HTTP (Nick Craig-Wood)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
اصلاح \f[V]operations/stat\f[R] با اسلش پایانی \f[V]/\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل پرچم‌های مفقود \f[V]--rc\f[R] (Nick Craig-Wood)
.IP \[bu] 2
اصلاح خروجی مقادیر Time در \f[V]options/get\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
دستور serve dlna: رفع رقابت داده‌ای بالقوه (Nick Craig-Wood)
.IP \[bu] 2
دستور version: اصلاح نسخه os/kernel گزارش‌شده برای windows (albertony)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
افزودن \f[V]--mount-case-insensitive\f[R] جهت اجبار نقطه اتصال به عدم حساسیت
به حروف کوچک و بزرگ (Nick Craig-Wood)
.IP \[bu] 2
حذف تخصیص بایت اسلایس غیرضروری برای خواندن‌ها (Anagh Kumar
Baranwal)
.IP \[bu] 2
شفاف‌سازی خطای mount در rclone هنگام نصب از طریق homebrew (Nick Craig-Wood)
.IP \[bu] 2
افزودن _netdev به اتصال نمونه تا به عنوان remote-fs در نظر گرفته شود
نه local-fs (Anagh Kumar Baranwal)
.RE
.IP \[bu] 2
Mount2
.RS 2
.IP \[bu] 2
به‌روزرسانی نسخه go-fuse (Anagh Kumar Baranwal)
.IP \[bu] 2
اصلاح statfs (Anagh Kumar Baranwal)
.IP \[bu] 2
غیرفعال‌سازی xattrs (Anagh Kumar Baranwal)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
افزودن تابع MkdirAll برای ساخت یک دایرکتوری و تمام زیرمجموعه‌های آن (Nick
Craig-Wood)
.IP \[bu] 2
رفع خطای reload: failed to add virtual dir entry: file does not exist (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل نوشتن در دایرکتوری فقط‌خواندنی که منجر به ایجاد مدخل‌های دایرکتوری کاذب می‌شد
(WeidiDeng)
.IP \[bu] 2
رفع رقابت داده‌ای بالقوه (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل خاموش شدن (Shutdown) زودهنگام بک‌اندها هنگامی که راه‌اندازی زمان زیادی می‌برد
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
اصلاح پالایش پیوندهای نمادین با پرچم \f[V]-l\f[R]/\f[V]--links\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
اصلاح /path/to/file.rclonelink هنگام استفاده از \f[V]-l\f[R]/\f[V]--links\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
رفع فروپاشی ناشی از \f[V]--metadata\f[R] روی Android (Nick Craig-Wood)
.RE
.IP \[bu] 2
Cache
.RS 2
.IP \[bu] 2
رفع مشکل خاموش شدن بک‌اندهای در حال استفاده هنگام به‌کارگیری از طریق rc (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
افزودن گزینه \f[V]--crypt-suffix\f[R] برای تنظیم پسوند سفارشی فایل‌های
رمزگذاری‌شده (jladbrook)
.IP \[bu] 2
افزودن \f[V]--crypt-pass-bad-blocks\f[R] برای مجاز کردن خروجی فایل‌های معیوب
(Nick Craig-Wood)
.IP \[bu] 2
اصلاح خواندن فایل‌های با طول ۰ (Nick Craig-Wood)
.IP \[bu] 2
تلاش برای عدم بازگرداندن خطای \[dq]unexpected EOF\[dq] (Nick Craig-Wood)
.IP \[bu] 2
کاهش تخصیص‌ها (albertony)
.IP \[bu] 2
توصیه Dropbox برای کدگذاری \f[V]base32768\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
نشانگرهای دایرکتوری خالی (Nick Craig-Wood)
.IP \[bu] 2
پشتیبانی از azure workload identities (Tareq Sharafy)
.IP \[bu] 2
اصلاح بارگذاری‌های azure blob با چندین جزء فراداده (Nick Craig-Wood)
.IP \[bu] 2
اصلاح سازگاری با azurite از طریق ارسال tier تهی (nil) در صورت تنظیم روی رشته خالی
(Roel Arents)
.RE
.IP \[bu] 2
Combine
.RS 2
.IP \[bu] 2
پیاده‌سازی متدهای ناموجود (Nick Craig-Wood)
.IP \[bu] 2
رفع سرریز پشته goroutine در مواجهه با شیء نامعتبر (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن \f[V]--drive-env-auth\f[R] برای دریافت اعتبارنامه‌های IAM از زمان اجرا (runtime)
(Peter Brunner)
.IP \[bu] 2
به‌روزرسانی راهنمای drive service account (Juang, Yi-Lin).IP \[bu] 2
رفع مشکل دریافت فایل‌های خارج از ریشه توسط اعلان تغییرات (change notify) (Nick Craig-Wood)
.IP \[bu] 2
رفع تشخیص نادرست پوشه به عنوان فایل به دلیل وجود اسلش پایانی (Nick
Craig-Wood)
.IP \[bu] 2
رفع ریموت نادرست پس از Update روی شیء (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
پیاده‌سازی پرچم \f[V]--dropbox-pacer-min-sleep\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل متوقف شدن batcher در dropbox (Misty)
.RE
.IP \[bu] 2
Fichier
.RS 2
.IP \[bu] 2
افزودن گزینهٔ \f[V]--ficicher-cdn\f[R] برای استفاده از CDN جهت بارگیری (Nick
Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
کاهش اولویت پیام گزارش (log) در صورت عدم پشتیبانی از \f[V]SetModTime\f[R] به سطح debug (Tobias Gion)
.IP \[bu] 2
رفع خطاهای \[dq]unsupported LIST line\[dq] هنگام راه‌اندازی (Nick Craig-Wood)
.IP \[bu] 2
رفع خطاهای \[dq]501 Not a valid pathname.\[dq] هنگام ایجاد دایرکتوری‌ها
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
نشانگرهای دایرکتوری خالی (Jānis Bebrītis, Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--gcs-user-project\f[R] مورد نیاز برای پرداخت توسط درخواست‌دهنده (Christopher Merry)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
افزودن میان‌افزار اصالت‌سنجی کاربر با گواهی کلاینت (client cert).
این قابلیت می‌تواند \f[V]serve restic\f[R] را با نام کاربری موجود در گواهی کلاینت احراز هویت کند.
(Peter Fern)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
رفع مشکل گیر کردن writeback در vfs در حلقهٔ بارگذاری ناموفق در صورت غیرفعال بودن نسخه‌بندی فایل (albertony)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--onedrive-av-override\f[R] برای بارگیری فایل‌هایی که به عنوان ویروس نشانه‌گذاری شده‌اند (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل quickxorhash در معماری‌های ۳۲ بیتی (Nick Craig-Wood)
.IP \[bu] 2
گزارش هرگونه خطای فهرست‌گیری در حین اجرای \f[V]rclone cleanup\f[R] (albertony)
.RE
.IP \[bu] 2
Putio
.RS 2
.IP \[bu] 2
رفع بارگذاری در شیء نادرست هنگام Update با نام ریموت بازنویسی‌شده
(Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل حفظ نشدن زمان‌های تغییر برای رونوشت و جابه‌جایی سمت سرور
(Nick Craig-Wood)
.IP \[bu] 2
رفع خطاهای کپی سمت سرور (خطاهای 400) (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
نشانگرهای دایرکتوری خالی (Jānis Bebrītis, Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی کلاس‌های ذخیره‌سازی Scaleway (Brian Starkey)
.IP \[bu] 2
اصلاح \f[V]--s3-versions\f[R] روی اشیاء تکی (Nick Craig-Wood)
.IP \[bu] 2
رفع قفل شدن هنگام لغو بارگذاری چندبخشی با iDrive e2 (Nick Craig-Wood)
.IP \[bu] 2
رفع متادادهٔ مفقود \[dq]tier\[dq] (Nick Craig-Wood)
.IP \[bu] 2
اصلاح V3sign: افزودن حذف زیرمنبع مفقود (cc)
.IP \[bu] 2
اعمال تغییرات دامنه و ناحیه در Arvancloud و مرتب‌سازی الفبایی ارائه‌دهنده
(Ehsan Tadayon)
.IP \[bu] 2
رفع ناسازگاری‌های Qiniu KODO زمانی که مقدار virtualHostStyle برابر با false است (zzq)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن \f[V]--sftp-host-key-algorithms\f[R] جهت امکان تعیین الگوریتم‌های کلید میزبان SSH (Joel)
.IP \[bu] 2
رفع مشکل نیاز به فایل کلید خصوصی هنگام استفادهٔ هم‌زمان از \f[V]--sftp-key-use-agent\f[R] و \f[V]--sftp-key-file\f[R] (Arnav Singh)
.IP \[bu] 2
اصلاح دستور move جهت مجاز بودن رونویسی فایل‌های موجود (Nick Craig-Wood)
.IP \[bu] 2
عدم اجرای stat روی دایرکتوری‌ها پیش از فهرست کردن آن‌ها (Nick Craig-Wood)
.IP \[bu] 2
عدم بررسی اشارهٔ ریموت به فایل در صورتی که به / ختم شود (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Sharefile
.RS 2
.IP \[bu] 2
غیرفعال‌سازی انتقال‌های جریانی (streamed) به دلیل عدم کارکرد آن‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
پاک‌سازی کد جهت جلوگیری از بازنویسی ctx قبل از نخستین استفاده (رفع اشکال گزارش‌شده توسط لینتر staticcheck) (albertony)
.RE
.IP \[bu] 2
Storj
.RS 2
.IP \[bu] 2
رفع خطاهای \[dq]uplink: too many requests\[dq] هنگام بارگذاری روی همان فایل (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل بارگذاری در شیء نادرست هنگام Update با نام ریموت بازنویسی‌شده
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
نادیده گرفتن خطای 404 هنگام حذف یک شیء (Nick Craig-Wood)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
پیاده‌سازی متدهای مفقود (Nick Craig-Wood)
.IP \[bu] 2
امکان بازگشایی (unwrap) خطاها جهت بازرسی (Nick Craig-Wood)
.RE
.IP \[bu] 2
Uptobox
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--uptobox-private\f[R] برای خصوصی کردن تمام فایل‌های بارگذاری‌شده
(Nick Craig-Wood)
.IP \[bu] 2
اصلاح عبارت باقاعده (regex) نادرست (Aaron Gokaslan)
.IP \[bu] 2
رفع بازگرداندن شیء نادرست توسط Update (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل اعلام خالی نبودن دایرکتوری‌ها توسط rmdir (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
nextcloud: افزودن پشتیبانی از بارگذاری‌های چندبخشی (chunked uploads) (Paul)
.IP \[bu] 2
تنظیم modtime با استفاده از propset برای owncloud و nextcloud (WeidiDeng)
.IP \[bu] 2
قابلیت پیکربندی minSleep برای pacer با پرچم \f[V]--webdav-pacer-min-sleep\f[R]
(ed).IP \[bu] 2
رفع مشکل بازنویسی نشدن در کپی/انتقال سمت سرور (WeidiDeng)
.IP \[bu] 2
رفع مشکل modtime در کپی سمت سرور برای owncloud و nextcloud (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
رفع خطای 400 Bad Request هنگام شکست در انتقال (Nick Craig-Wood)
.RE
.IP \[bu] 2
Zoho
.RS 2
.IP \[bu] 2
رفع مشکل دانلودها با هدر \f[V]Range:\f[R] که داده‌های نادرست بازمی‌گرداندند
(Nick Craig-Wood)
.RE
.SS v1.62.2 \- 2023-03-16
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.62.1...v1.62.2)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
docker volume plugin: افزودن وابستگی مفقود fuse3 (Nick Craig-Wood)
.IP \[bu] 2
docs: اصلاح مستندات size (asdffdsazqqq)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
رفع خطاهای 426 در دانلودها با vsftpd (Lesmiscore)
.RE
.SS v1.62.1 \- 2023-03-15
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.62.0...v1.62.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
docker: افزودن وابستگی مفقود fuse3 (cycneuramus)
.IP \[bu] 2
build: به‌روزرسانی مستندات انتشار برای دقت بیشتر در برچسب (Nick
Craig-Wood)
.IP \[bu] 2
build: تنظیم انتشار GitHub روی حالت پیش‌نویس حین بارگذاری فایل‌های باینری (Nick
Craig-Wood)
.RE
.SS v1.62.0 \- 2023-03-14
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.61.0...v1.62.0)
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
accounting: نمایش فعالیت جاری بررسی‌کننده‌ها (checkers) (Nick Craig-Wood)
.IP \[bu] 2
authorize: افزودن پشتیبانی از قالب‌های سفارشی (Hunter Wittenborn)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
ارتقا به go1.20 (Nick Craig-Wood, Anagh Kumar Baranwal)
.IP \[bu] 2
افزودن گردش‌کار انتشار winget (Ryan Caezar Itang)
.IP \[bu] 2
افزودن dependabot (Ryan Caezar Itang)
.RE
.IP \[bu] 2
به‌روزرسانی‌های مستندات (albertony, Bryan Kaplan, Gerard Bosch, IMTheNachoMan,
Justin Winokur, Manoj Ghosh, Nick Craig-Wood, Ole Frost, Peter Brunner,
piyushgarg, Ryan Caezar Itang, Simmon Li, ToBeFree)
.IP \[bu] 2
filter: صدور پیام INFO در صورت عدم امکان تعیین فیلترهای پوشه
(Nick Craig-Wood)
.IP \[bu] 2
fs
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از چندین گواهی CA.
(alankrit)
.IP \[bu] 2
افزودن \f[V]--max-delete-size\f[R] به عنوان آستانه اندازه حذف (Leandro
Sacchet)
.RE
.IP \[bu] 2
fspath: مجاز دانستن نمادهای \f[V]\[at]\f[R] و \f[V]+\f[R] در نام‌های
remote (albertony)
.IP \[bu] 2
lib/terminal: فعال‌سازی پردازش توالی‌های ترمینال مجازی کنسول ویندوز
(رنگ‌های ANSI/VT100) (albertony)
.IP \[bu] 2
move: اگر \f[V]--check-first\f[R] و \f[V]--order-by\f[R] تنظیم شده باشند،
حذف با ترتیب کامل انجام می‌شود (Nick Craig-Wood)
.IP \[bu] 2
serve http: پشتیبانی از \f[V]--auth-proxy\f[R] (Matthias Baur)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
جلوگیری از مقادیر منفی ETA برای سرعت‌های بسیار پایین (albertony)
.IP \[bu] 2
محدود کردن طول رشته ETA (albertony)
.IP \[bu] 2
نمایش زمان سپری‌شده به صورت خوانا برای انسان زمانی که بیشتر از یک روز باشد (albertony)
.RE
.IP \[bu] 2
all: اعمال اصلاحات codeql (Aaron Gokaslan)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
اصلاح شرط اجرای دستی گردش‌کار (albertony)
.IP \[bu] 2
رفع مشکل ساخت برای ARMv5 و ARMv6 (albertony)
.RS 2
.IP \[bu] 2
selfupdate: در نظر گرفتن نسخه ARM
.IP \[bu] 2
install.sh: رفع مشکل دانلود ARMv6
.IP \[bu] 2
version: گزارش نسخه ARM
.RE
.RE
.IP \[bu] 2
deletefile: بازگرداندن کد خطای 4 در صورت عدم وجود فایل (Nick Craig-Wood)
.IP \[bu] 2
docker: رفع مشکل عدم اتصال مجدد volume توسط پلاگینِ volume پس از راه‌اندازی مجدد docker
(logopk)
.IP \[bu] 2
fs: رفع شرایط رقابتی در \f[V]--max-delete\f[R] و
\f[V]--max-delete-size\f[R] (Nick Craig-Wood)
.IP \[bu] 2
lib/oauthutil: مدیریت بهتر خطاهای مهلک (Alex Chen)
.IP \[bu] 2
mount2: اصلاح \f[V]--allow-non-empty\f[R] (Nick Craig-Wood)
.IP \[bu] 2
operations: اصلاح همزمانی: استفاده از \f[V]--checkers\f[R] مگر در زمان
انتقال فایل‌ها (Nick Craig-Wood)
.IP \[bu] 2
serve ftp: اصلاح برچسب‌های زمانی قدیمی‌تر از ۱ سال در فهرست‌ها (Nick
Craig-Wood)
.IP \[bu] 2
sync: اصلاح همزمانی: استفاده از \f[V]--checkers\f[R] مگر در زمان انتقال
فایل‌ها (Nick Craig-Wood)
.IP \[bu] 2
tree
.RS 2
.IP \[bu] 2
رفع خطای اشاره‌گر تهی (nil pointer) در زمان شکست stat (Nick Craig-Wood)
.IP \[bu] 2
اصلاح خروجی رنگی در ویندوز (albertony)
.IP \[bu] 2
اصلاح نمایش فایل‌هایی با نام‌های غیرمجاز در سیستم‌فایل ویندوز (Nick
Craig-Wood)
.RE
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
رفع مشکل ایجاد و تغییر نام فایل‌ها در backendهای غیرحساس به حروف کوچک و بزرگ (Nick
Craig-Wood)
.IP \[bu] 2
در نظر نگرفتن مسیرهای دارای پیشوند \f[V]\[rs]\[rs]?\[rs]\f[R] به عنوان مسیرهای اشتراک شبکه
در ویندوز (albertony)
.IP \[bu] 2
اصلاح بررسی خالی بودن نقطه اتصال (mount point) در لینوکس (Nick Craig-Wood)
.IP \[bu] 2
اصلاح \f[V]--allow-non-empty\f[R] (Nick Craig-Wood)
.IP \[bu] 2
جلوگیری از بررسی نادرست یا زودهنگام هم‌پوشانی در ویندوز (albertony)
.IP \[bu] 2
به‌روزرسانی به fuse3 پس از ارتقای bazil.org/fuse (Nick Craig-Wood)
.RE.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
حفظ زمان تغییر (modtime) فایل‌های بارگذاری‌شده در backendهای بدون پشتیبانی از modtime (Nick
Craig-Wood)
.IP \[bu] 2
رفع مقدار نادرست modtime در سامانه‌های فایلی که از تنظیم modtime پشتیبانی نمی‌کنند
(Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل تغییر نام دایرکتوری حاوی فایل‌های در انتظار بارگذاری (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع \f[V]%!w(<nil>)\f[R] در خطای \[dq]failed to read directory\[dq]
(Marks Polakovs)
.IP \[bu] 2
رفع مشکل مستثنی‌سازی پیوندهای نمادین معلق با \-L/\-\-copy\-links (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
پیروی از \f[V]--ignore-checksum\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل برای نام‌های رمزگذاری‌نشدهٔ دایرکتوری در ریموت‌های غیرحساس به بزرگ و کوچکی حروف (Ole
Frost)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
حذف راهکارهای موقت برای باگ‌های SDK پس از به‌روزرسانی v0.6.1 (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
رفع مشکل بارگذاری فایل‌های بزرگ‌تر از 1TiB (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
ذکر این نکته که \f[V]--drive-acknowledge-abuse\f[R] نیازمند مجوز SA Manager
است (Nick Craig-Wood)
.IP \[bu] 2
پاسخ‌دهی \f[V]--drive-stop-on-upload-limit\f[R] به
storageQuotaExceeded (Ninh Pham)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
تلاش دوباره در خطاهای 426 (Nick Craig-Wood)
.IP \[bu] 2
تلاش دوباره هنگام بروز خطا در شروع بارگیری‌ها (Nick Craig-Wood)
.IP \[bu] 2
بازگشت به بالادست \f[V]github.com/jlaffaye/ftp\f[R] پس از ادغام اصلاحیه
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
افزودن \f[V]--gcs-env-auth\f[R] جهت دریافت اعتبارنامه‌های IAM از
env/instance (Peter Brunner)
.RE
.IP \[bu] 2
Mega
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--mega-use-https\f[R] (NodudeWasTaken)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
پیش‌فرض کردن QuickXorHash برای Onedrive شخصی با توجه به حذف SHA1 توسط مایکروسافت
(Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--onedrive-hash-type\f[R] جهت تغییر هش مورد استفاده (Nick
Craig-Wood)
.IP \[bu] 2
بهبود سرعت QuickXorHash (LXY)
.RE
.IP \[bu] 2
Oracle Object Storage
.RS 2
.IP \[bu] 2
افزایش سرعت عملیات‌ها با استفاده از S3 pacer و تنظیم minsleep به 10ms
(Manoj Ghosh)
.IP \[bu] 2
در دسترس قرار دادن گزینهٔ \f[V]storage_tier\f[R] در پیکربندی (Manoj Ghosh)
.IP \[bu] 2
امکان استفاده از کلیدهای رمزگذاری اختصاصی (Manoj Ghosh)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
بررسی ETag بارگذاری چندبخشی در صورت استفاده از \f[V]--s3-no-head\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--s3-sts-endpoint\f[R] برای مشخص کردن نقطه پایانی STS (Nick
Craig-Wood)
.IP \[bu] 2
رفع پشتیبانی نادرست از سطح (tier) برای StorJ و IDrive هنگام اشاره به یک فایل
(Ole Frost)
.IP \[bu] 2
رفع خرابی AWS STS در صورت تنظیم بودن \f[V]--s3-endpoint\f[R] (Nick Craig-Wood)
.IP \[bu] 2
حذف نشانگرهای دایرکتوری توسط purge (Nick Craig-Wood)
.RE
.IP \[bu] 2
Seafile
.RS 2
.IP \[bu] 2
تمدید گذرواژهٔ کتابخانه (Fred)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
رفع مشکل ۶۵٪ کندتر بودن بارگذاری‌ها در مقایسه با حالت مورد انتظار با crypt (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
امکان پیکربندی SPN (نام اصلی سرویس یا service principal name) (Nick Craig-Wood)
.IP \[bu] 2
بررسی بسته بودن اتصال smb (happyxhw)
.RE
.IP \[bu] 2
Storj
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]rclone link\f[R] (Kaloyan Raev)
.IP \[bu] 2
پیاده‌سازی \f[V]rclone purge\f[R] (Kaloyan Raev)
.IP \[bu] 2
به‌روزرسانی نشانی‌های اینترنتی و برچسب‌های ماهواره (Kaloyan Raev)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
رفع مشکل تعامل‌پذیری با سرور davrods (Nick Craig-Wood)
.RE.SS v1.61.1 - 2022-12-23
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.61.0...v1.61.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
docs:
.RS 2
.IP \[bu] 2
نمایش تنها بخش‌های مهم شماره نسخه در برچسب نسخه‌ی معرفی‌شده (albertony)
.IP \[bu] 2
رفع مشکل کدهای HTML اسکیپ‌نشده (Nick Craig-Wood)
.RE
.IP \[bu] 2
lib/http: خاموش کردن تمام سرورها هنگام خروج جهت حذف سوکت یونیکس (Nick
Craig-Wood)
.IP \[bu] 2
rc: رفع مشکل پرچم \f[V]--rc-addr\f[R] (که جایگزینی برای
\f[V]--url\f[R] است) (Anagh Kumar Baranwal)
.IP \[bu] 2
serve restic
.RS 2
.IP \[bu] 2
عدم ارائه از طریق http در صورت ارائه از طریق \f[V]--stdio\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل خروج فوری در زمان عدم استفاده از stdio (Nick Craig-Wood)
.RE
.IP \[bu] 2
serve webdav
.RS 2
.IP \[bu] 2
رفع مشکل مدیریت \f[V]--baseurl\f[R] پس از بازآرایی کد \f[V]lib/http\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل اجرای فراخوانی تکراری Serve (Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
رفع خطای \[dq]409 Public access is not permitted on this storage account\[dq]
(Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
storj: به‌روزرسانی endpointها (Kaloyan Raev)
.RE
.SS v1.61.0 - 2022-12-20
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.60.0...v1.61.0)
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
ارائه‌دهندگان جدید S3
.RS 2
.IP \[bu] 2
Liara LOS (https://rclone.org/s3/#liara-cloud) (MohammadReza)
.RE
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
build: افزودن تست آسیب‌پذیری با استفاده از govulncheck (albertony)
.IP \[bu] 2
cmd: فعال‌سازی کنترل‌کننده‌ی \f[V]SIGINFO\f[R] (Ctrl-T) در FreeBSD، NetBSD،
OpenBSD و Dragonfly BSD (x3-apptech)
.IP \[bu] 2
config: افزودن config/setpath (https://rclone.org/rc/#config-setpath) جهت
تنظیم مسیر پیکربندی از طریق rc/librclone (Nick Craig-Wood)
.IP \[bu] 2
dedupe
.RS 2
.IP \[bu] 2
شمارش بررسی‌ها (Checks) در آمار هنگام اسکن موارد تکراری (Nick
Craig-Wood)
.IP \[bu] 2
پیروی dedupe از فیلترها (Nick Craig-Wood)
.RE
.IP \[bu] 2
dlna: ارجاع و انتساب مناسب کدهای استفاده‌شده از
<https://github.com/anacrolix/dms> (Nick Craig-Wood)
.IP \[bu] 2
docs
.RS 2
.IP \[bu] 2
افزودن حداقل نسخه‌ها و نشان‌های وضعیت به مستندات backend و دستورها (Nick
Craig-Wood, albertony)
.IP \[bu] 2
نام‌های ریموت نباید با فاصله شروع یا پایان یابند (albertony)
.RE
.IP \[bu] 2
filter: افزودن فیلترهای متادیتا
--metadata-include/exclude/filter (https://rclone.org/filtering/#metadata)
و موارد مرتبط (Nick Craig-Wood)
.IP \[bu] 2
fs
.RS 2
.IP \[bu] 2
امکان استفاده از پسوندهای \f[V]y\f[R]، \f[V]M\f[R]، \f[V]w\f[R]،
\f[V]d\f[R] و غیره در تمام پرچم‌های مدت‌زمان (Nick Craig-Wood)
.IP \[bu] 2
افزودن پرچم سراسری \f[V]--color\f[R] برای کنترل رنگ‌های ترمینال (Kevin
Verstaen)
.RE
.IP \[bu] 2
fspath: مجاز دانستن اعداد و حروف یونیکد در نام‌های ریموت (albertony)
.IP \[bu] 2
lib/file: بهبود پیام خطا برای ایجاد دایرکتوری روی میزبان شبکه‌ای
ناموجود در ویندوز (albertony)
.IP \[bu] 2
lib/http: اتمام انتقال سرورهای rclone به \f[V]lib/http\f[R] (Tom
Mombourquette, Nick Craig-Wood)
.IP \[bu] 2
lib/oauthutil: بهبود کارایی روندهای پیکربندی نیازمند مرورگر وب
(Ole Frost)
.IP \[bu] 2
ncdu
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از زمان تغییر (modification time) (albertony)
.IP \[bu] 2
استفاده از مرتب‌سازی بر اساس نام به‌عنوان حالت رزرو هنگام مرتب‌سازی بر اساس اندازه میانگین (albertony)
.IP \[bu] 2
بازطراحی جهت استفاده مستقیم از tcell به‌جای لفاف termbox (eNV25)
.RE
.IP \[bu] 2
rc: افزودن دستورها برای تنظیم درصد زباله‌روب
(https://rclone.org/rc/#debug-set-gc-percent) و سقف حافظه (در go
1.19 به بالا) (Anagh Kumar Baranwal)
.IP \[bu] 2
rcat: حفظ متادیتا زمانی که Copy به Rcat تنزل می‌یابد (Nick Craig-Wood)
.IP \[bu] 2
rcd: بازآرایی سرور rc در rclone برای استفاده از \f[V]lib/http\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
rcserver: جلوگیری از ایجاد اعتبارنامه‌های پیش‌فرض با htpasswd (Kamui)
.IP \[bu] 2
restic: بازآرایی برای استفاده از \f[V]lib/http\f[R] (Nolan Woods)
.IP \[bu] 2
serve http: پشتیبانی از سوکت‌های unix و شنوندگان متعدد (Tom
Mombourquette)
.IP \[bu] 2
serve webdav: بازآرایی برای استفاده از \f[V]lib/http\f[R] (Nick Craig-Wood)
.IP \[bu] 2
test: جایگزینی پاک‌سازی با defer توسط \f[V]t.Cleanup\f[R] (Eng Zer Jun)
.IP \[bu] 2
test memory: خواندن متادیتا در صورت مشخص شدن پرچم \f[V]-M\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
wasm: سازگاری با شرایط مجوز \f[V]wasm_exec.js\f[R] (Matthew Vernon)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
build: به‌روزرسانی \f[V]golang.org/x/net/http2\f[R] جهت رفع GO-2022-1144 (Nick
Craig-Wood)
.IP \[bu] 2
restic: رفع غلط املایی در مستندات؛ \[aq]remove\[aq] باید \[aq]remote\[aq] باشد
(asdffdsazqqq)
.IP \[bu] 2
serve dlna: رفع panic: Logger uninitialized.
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
به‌روزرسانی cgofuse جهت پشتیبانی از FUSE-T برای mount کردن حجم‌ها در Mac (Nick
Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2.IP \[bu] 2
Windows: رفع کندی باز شدن فایل‌های exe با کوتاه نکردن فایل‌ها در مواقع غیرضروری (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای IO هنگام باز کردن فایل با \f[V]O_CREATE|O_RDONLY\f[R] در حالتی که \f[V]--vfs-cache-mode\f[R] روی full نیست (Nick Craig-Wood)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
رفع خطاهای آپلود هنگام قرار گرفتن compress روی crypt (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
انتقال به SDK جدید (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
نوسازی احراز هویت برای در برگرفتن تمامی روش‌ها و مستندات (Nick Craig-Wood)
.IP \[bu] 2
انتقال روش‌های احراز هویت قدیمی به SDK جدید (Nick Craig-Wood, Brad
Ackerman)
.IP \[bu] 2
با تشکر از Stonebranch (https://www.stonebranch.com) برای حمایت مالی از این
کار.
.RE
.IP \[bu] 2
افزودن \f[V]--azureblob-no-check-container\f[R] برای فرض کردن وجود کانتینر
(Nick Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--use-server-modtime\f[R] (Abdullah Saglam)
.IP \[bu] 2
افزودن پشتیبانی از هدرهای سفارشی آپلود (rkettelerij)
.IP \[bu] 2
امکان بازنویسی حساب/کلید شبیه‌ساز (Roel Arents)
.IP \[bu] 2
پشتیبانی از \[dq]اعتبارنامه‌های محیطی\[dq] ساده (Nathaniel Wesley
Filardo)
.IP \[bu] 2
نادیده گرفتن \f[V]AuthorizationFailure\f[R] هنگام تلاش برای ایجاد یک
کانتینر (Nick Craig-Wood)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
افزودن یادداشت درباره محدودیت‌های نرخ (rate limits) در Box API (Ole Frost)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
مدیریت درایوهای اشتراکی دارای فاصله در ابتدا/انتهای نام (مربوط به)
(albertony)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
به‌روزرسانی متن راهنمای گزینه‌های TLS ضمنی/صریح جهت ارجاع به FTPS
به‌جای FTP (ycdtosa)
.IP \[bu] 2
بهبود کارایی جهت افزایش سرعت \f[V]--files-from\f[R] و
\f[V]NewObject\f[R] (Anthony Pessy)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
تجزیه پاسخ‌های GET هنگامی که \f[V]no_head\f[R] تنظیم شده است (Arnie97)
.IP \[bu] 2
عدم به‌روزرسانی اندازه شیء بر اساس درخواست‌های \f[V]Range\f[R] (Arnie97)
.IP \[bu] 2
پشتیبانی از هدر پاسخ \f[V]Content-Range\f[R] (Arnie97)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
مستندسازی راهکار برای فایل‌های «به‌اشتراک‌گذاشته‌شده با من» (shared with me) (vanplus)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن Liara LOS به فهرست ارائه‌دهندگان (MohammadReza)
.IP \[bu] 2
افزودن ناحیه‌های \f[V]sfo3\f[R]، \f[V]fra1\f[R] و
\f[V]syd1\f[R] برای DigitalOcean Spaces (Jack)
.IP \[bu] 2
اجتناب از فراخوانی سطح‌بالای \f[V]GetBucketLocation\f[R] برای تشخیص ناحیه s3
(Anthony Pessy)
.IP \[bu] 2
توقف تنظیم ACL شیء و باکت روی \f[V]private\f[R] در صورتی که یک
رشته خالی باشد (Philip Harvey)
.IP \[bu] 2
عدم افزودن هدر \f[V]X-Amz-Acl:\f[R] در صورتی که ACL باکت یا شیء یک رشته خالی باشد (Nick Craig-Wood)
.IP \[bu] 2
کاهش مصرف حافظه برای اشیاء s3 (Erik Agterdenbos)
.IP \[bu] 2
رفع حلقه در فهرست‌گیری هنگام استفاده از فهرست‌گیری v2 روی سرور v1 (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای اشاره‌گر تهی (nil pointer exception) هنگام استفاده از Versions (Nick Craig-Wood)
.IP \[bu] 2
رفع مصرف بیش از حد حافظه هنگام استفاده از نسخه‌ها (versions) (Nick Craig-Wood)
.IP \[bu] 2
نادیده گرفتن versionIDها در آپلودها مگر در صورت استفاده از \f[V]--s3-versions\f[R] یا
\f[V]--s3-versions-at\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن گزینه‌های پیکربندی برای تنظیم ssh Ciphers / MACs / KeyExchange
(dgouju)
.IP \[bu] 2
تشخیص خودکار نوع پوسته برای fish (albertony)
.IP \[bu] 2
رفع مشکل \f[V]NewObject\f[R] با / در ابتدا (Nick Craig-Wood)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
رفع مشکل ایجاد دایرکتوری ناخواسته نقطه (.) (albertony)
.RE
.IP \[bu] 2
Storj
.RS 2
.IP \[bu] 2
پیاده‌سازی Copy سمت سرور (Kaloyan Raev)
.RE.SS v1.60.1 - 2022-11-17
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.60.0...v1.60.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
lib/cache: رفع مشکل خاموش شدن زودهنگام بک‌اند alias (Nick Craig-Wood)
.IP \[bu] 2
wasm: رفع خطای پیوند مربوط به walltime با افزودن wasm_exec.js به‌روز (João
Henrique Franco)
.IP \[bu] 2
مستندات
.RS 2
.IP \[bu] 2
به‌روزرسانی faq.md با bisync (Samuel Johnson)
.IP \[bu] 2
تصحیح پیوندهای بارگیری در مستندات نصب windows (coultonluke)
.IP \[bu] 2
افزودن پیوند بارگیری مستقیم برای windows arm64 (albertony)
.IP \[bu] 2
حذف پیوند به slack رکلون به دلیل عدم پشتیبانی دیگر (Nick
Craig-Wood)
.IP \[bu] 2
Faq: نحوه استفاده از سرور پروکسی نیازمند نام کاربری و گذرواژه
(asdffdsazqqq)
.IP \[bu] 2
Oracle-object-storage: اصلاح مستندات (Manoj Ghosh)
.IP \[bu] 2
رفع غلط املایی \f[V]remove\f[R] در دستور rclone_serve_restic (Joda Stößer)
.IP \[bu] 2
اصلاح نویسه‌ای که به اشتباه به عنوان markdown تفسیر می‌شد (Clément
Notin)
.RE
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع بن‌بست (deadlock) ناشی از پاک‌کننده حافظه پنهان و اتمام بارگذاری (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
پاک‌سازی مسیرهای مطلق (albertony)
.IP \[bu] 2
رفع مشکل جا افتادن دایرکتوری‌ها در -L/--copy-links هنگام استفاده از فیلترها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Mailru
.RS 2
.IP \[bu] 2
ذکر این نکته که اکنون به یک گذرواژه برنامه (app password) نیاز است (Nick Craig-Wood)
.IP \[bu] 2
امکان استفاده از برچسب‌های زمانی قبل از مبدأ زمانی epoch یعنی 1970-01-01 (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن رفتار ارائه‌دهنده \f[V]--s3-might-gzip\f[R] برای رفع خطای corrupted on
transfer: sizes differ (Nick Craig-Wood)
.IP \[bu] 2
فعال‌سازی کپی سمت سرور برای Storj با توجه به کارکرد صحیح آن در حال حاضر (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل بررسی نشدن مقدار err در s3 listv2 (Aaron Gokaslan)
.IP \[bu] 2
افزودن مکان‌های جغرافیایی بیشتر برای Wasabi (techknowlogick)
.RE
.IP \[bu] 2
Smb
.RS 2
.IP \[bu] 2
رفع خطای \f[V]Failed to sync: context canceled\f[R] در پایان همگام‌سازی‌ها (Nick
Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
رفع اشکال Move/Copy/DirMove هنگام استفاده از -server-side-across-configs (Nick
Craig-Wood)
.RE.SS v1.60.0 \- 2022-10-21
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.59.0...v1.60.0)
.IP \[bu] 2
Backendهای جدید
.RS 2
.IP \[bu] 2
Oracle object storage (https://rclone.org/oracleobjectstorage) (Manoj
Ghosh)
.IP \[bu] 2
SMB (https://rclone.org/smb) / CIFS (اشتراک‌گذاری فایل ویندوز) (Lesmiscore)
.IP \[bu] 2
ارائه‌دهندگان جدید S3
.RS 2
.IP \[bu] 2
IONOS Cloud Storage (https://rclone.org/s3/#ionos) (Dmitry Deniskin)
.IP \[bu] 2
Qiniu KODO (https://rclone.org/s3/#qiniu) (Bachue Zhou)
.RE
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
ارتقا به go1.19 و تعیین go1.17 به عنوان حداقل نسخه مورد نیاز (Nick
Craig-Wood)
.IP \[bu] 2
اسکریپت Install.sh: رفع مشکل بارگیری arm-v7 (Ole Frost)
.RE
.IP \[bu] 2
بخش fs: هشدار به کاربر هنگام استفاده از نام ریموت موجود بدون دونقطه
(Nick Craig-Wood)
.IP \[bu] 2
بخش httplib: افزودن گزینه \f[V]--xxx-min-tls-version\f[R] برای انتخاب حداقل
نسخه TLS برای سرورهای HTTP (Robert Newson)
.IP \[bu] 2
بخش librclone: افزودن بایندینگ‌های PHP و برنامه آزمایش (Jordi Gonzalez Muñoz)
.IP \[bu] 2
operations
.RS 2
.IP \[bu] 2
افزودن پرچم سراسری \f[V]--server-side-across-configs\f[R] برای هر backend
(Nick Craig-Wood)
.IP \[bu] 2
بهینه‌سازی \f[V]--copy-dest\f[R] و \f[V]--compare-dest\f[R] (Nick
Craig-Wood)
.RE
.IP \[bu] 2
بخش rc: افزودن \f[V]job/stopgroup\f[R] برای متوقف کردن گروه (Evan Spensley)
.IP \[bu] 2
serve dlna
.RS 2
.IP \[bu] 2
افزودن \f[V]--announce-interval\f[R] برای کنترل بازه زمانی اعلان SSDP
(YanceyChiew)
.IP \[bu] 2
افزودن \f[V]--interface\f[R] برای مشخص کردن خط نام‌های رابط SSDP (Simon
Bos)
.IP \[bu] 2
افزودن پشتیبانی از زیرنویس‌های خارجی بیشتر (YanceyChiew)
.IP \[bu] 2
افزودن اعتبارسنجی نشانی‌ها (YanceyChiew)
.RE
.IP \[bu] 2
بخش sync: بهینه‌سازی \f[V]--copy-dest\f[R] و \f[V]--compare-dest\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
به‌روزرسانی‌های مستندات (albertony, Alexander Knorr, anonion, João Henrique Franco,
Josh Soref, Lorenzo Milesi, Marco Molteni, Mark Trolley, Ole Frost,
partev, Ryan Morey, Tom Mombourquette, YFdyh000)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
filter
.RS 2
.IP \[bu] 2
رفع فیلترسازی نادرست با پرچم زمینه \f[V]UseFilter\f[R] و
backendهای پوشش‌دهنده (Nick Craig-Wood)
.IP \[bu] 2
اطمینان از بررسی \f[V]--files-from\f[R] هنگام جستجو برای یک فایل منفرد
(Nick Craig-Wood)
.RE
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
رفع مشکل بازنگرداندن Fs کاملی که در \f[V]mount/mount\f[R] وارد شده توسط
\f[V]mount/listmounts\f[R] (Tom Mombourquette)
.IP \[bu] 2
مدیریت پیاده‌سازی خارجی (unmount) هنگام سوار کردن (Isaac Aymerich)
.IP \[bu] 2
اعتبارسنجی تنظیم نبودن گزینه Daemon هنگام سوار کردن volume از طریق RC (Isaac
Aymerich)
.RE
.IP \[bu] 2
بخش sync: به‌روزرسانی مستندات و پیام‌های خطا جهت انعکاس اصلاحات بررسی هم‌پوشانی
(Nick Naumann)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
کاهش مصرف حافظه با تعبیه \f[V]sync.Cond\f[R] (Nick Craig-Wood)
.IP \[bu] 2
کاهش مصرف حافظه با بازآرایی ساختارهای پرکاربرد (Nick
Craig-Wood)
.IP \[bu] 2
رفع مصرف بیش از حد CPU ناشی از چرخه پاک‌کننده حافظه موقت VFS (Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
پیروی از فیلترهای فایل در فهرست‌بندی جهت رفع خطاها در فایل‌های مستثنی‌شده (Nick
Craig-Wood)
.IP \[bu] 2
رفع خطای \[dq]Failed to read metadata: function not implemented\[dq] در هسته‌های قدیمی
لینوکس (Nick Craig-Wood)
.RE
.IP \[bu] 2
Compress
.RS 2
.IP \[bu] 2
رفع خرابی ناشی از متاداده‌های nil (Nick Craig-Wood)
.IP \[bu] 2
اصلاح مدیریت خطا برای عدم استفاده یا بازگرداندن اشیاء nil (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
وادار کردن \f[V]--drive-stop-on-upload-limit\f[R] به پیروی از خطای اتمام سهمیه (quota exceeded)
(Steve Kowalik)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
افزودن گزینه \f[V]--ftp-force-list-hidden\f[R] برای نمایش موارد پنهان
(Øyvind Heddeland Instefjord)
.IP \[bu] 2
رفع قفل کردن هنگام استفاده از ExplicitTLS با سرورهای خاص.
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--gcs-endpoint\f[R] و پارامتر پیکربندی (Nick Craig-Wood)
.RE
.IP \[bu] 2
Hubic
.RS 2
.IP \[bu] 2
حذف backend به دلیل تعطیل شدن این سرویس (Nick Craig-Wood)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
تغییر نام Onedrive(cn) 21Vianet به Vnet Group (Yen Hu)
.IP \[bu] 2
غیرفعال‌سازی اعلان تغییرات در منطقه چین به دلیل عدم پشتیبانی (Nick
Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
پیاده‌سازی پرچم \f[V]--s3-versions\f[R] جهت نمایش نسخه‌های قدیمی اشیاء
در صورت فعال بودن (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی پرچم \f[V]--s3-version-at\f[R] جهت نمایش نسخه‌های اشیاء در
یک زمان مشخص (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی دستور \f[V]backend versioning\f[R] برای دریافت/تنظیم نسخه‌بندی
باکت (Nick Craig-Wood).IP \[bu] 2
پیاده‌سازی \f[V]Purge\f[R] برای پاکسازی نگارش‌ها و
\f[V]backend cleanup-hidden\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن پرچم \f[V]--s3-decompress\f[R] برای خارج کردن فایل‌های کدگذاری‌شده با gzip از حالت فشرده
(Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--s3-sse-customer-key-base64\f[R] برای ارائه کلیدها به همراه داده‌های دودویی
(Richard Bateman)
.IP \[bu] 2
تلاش برای حفظ بیشترین دقت در ModTime با
\f[V]--user-server-modtime\f[R] (Nick Craig-Wood)
.IP \[bu] 2
دور انداختن فراداده دودویی با یک پیام ERROR به‌دلیل عدم امکان ذخیره‌سازی آن
(Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--s3-no-system-metadata\f[R] برای جلوگیری از خواندن و نوشتن
فراداده سیستم (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
رفع شرایط رقابتی در ایجاد دایرکتوری (Lesmiscore)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
افزودن \f[V]--swift-no-large-objects\f[R] برای کاهش درخواست‌های HEAD (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
انتشار ویژگی SlowHash برای رفع تعامل با hasher (Lesmiscore)
.RE
.SS v1.59.2 - 2022-09-15
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.59.1...v1.59.2)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
config: جابه‌جایی قفل‌گذاری برای رفع خطای مهلک fatal error: concurrent map read and map
write (Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
غیرفعال‌سازی پشتیبانی از xattr در صورتی که سیستم‌فایل اعلام کند پشتیبانی نمی‌شود
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
رفع محاسبات chunksize که بخش‌های بسیار زیادی تولید می‌کرد (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
رفع محاسبات chunksize که بخش‌های بسیار زیادی تولید می‌کرد (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع محاسبات chunksize که بخش‌های بسیار زیادی تولید می‌کرد (Nick Craig-Wood)
.RE
.SS v1.59.1 - 2022-08-08
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.59.0...v1.59.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting: رفع panic در core/stats-reset با گروه ناشناخته (Nick
Craig-Wood)
.IP \[bu] 2
build: رفع ساخت android پس از تغییرات GitHub actions (Nick Craig-Wood)
.IP \[bu] 2
dlna: رفع تحلیل سربرگ SOAP action (Joram Schrijver)
.IP \[bu] 2
docs: رفع پیوندها به دستور mount از مستندات نصب (albertony)
.IP \[bu] 2
dropbox: رفع خطاهای was unable to decrypt در ChangeNotify (Nick Craig-Wood)
.IP \[bu] 2
fs: رفع پردازش زمان‌ها و مدت‌ها در قالب \[dq]YYYY-MM-DD
HH:MM:SS\[dq] (Nick Craig-Wood)
.IP \[bu] 2
serve sftp: رفع تشخیص checksum (Nick Craig-Wood)
.IP \[bu] 2
sync: افزودن حساسیت به فیلتر (filter-sensitivity) از قلم افتاده به گزینه --backup-dir
(Nick Naumann)
.RE
.IP \[bu] 2
Combine
.RS 2
.IP \[bu] 2
رفع مستنداتی که \f[V]remote=\f[R] را به‌جای \f[V]upstreams=\f[R] نمایش می‌دادند (Nick
Craig-Wood)
.IP \[bu] 2
نمایش خطا در صورت تعیین نام دایرکتوری تکراری (Nick Craig-Wood)
.IP \[bu] 2
رفع خطاهای خاموش شدن بک‌اندها هنگام استفاده (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
رفع توقف برنامه (hang) هنگام خروج در صورت خاموش بودن --dropbox-batch-mode (Nick Craig-Wood)
.IP \[bu] 2
رفع حلقه بی‌نهایت هنگام بارگذاری یک فایل خراب (Nick Craig-Wood)
.RE
.IP \[bu] 2
Internetarchive
.RS 2
.IP \[bu] 2
نادیده گرفتن checksum برای فایل‌هایی که از روش متفاوتی استفاده می‌کنند (Lesmiscore)
.IP \[bu] 2
مدیریت نماد هش در میان نام فایل (Lesmiscore)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
رفع کارکرد با نسخه whitelabel از Elgiganten Cloud
.IP \[bu] 2
ذخیره نکردن نام کاربری در پیکربندی هنگام استفاده از احراز هویت استاندارد (albertony)
.RE
.IP \[bu] 2
Mega
.RS 2
.IP \[bu] 2
رفع استثنای nil pointer هنگام دریافت گره نامعتبر (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع panic گزینه --s3-no-head با پیام reflect: Elem of invalid type s3.PutObjectInput
(Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
رفع مشکل با WS_FTP از طریق دور زدن RealPath ناموفق (albertony)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
رفع فایل‌های تکراری هنگام استفاده از دایرکتوری‌های دارای / در ابتدا (Nick
Craig-Wood)
.IP \[bu] 2
رفع بارگذاری چندین فایل در صورت عدم وجود ریشه‌ها (Nick
Craig-Wood)
.IP \[bu] 2
رفع panic ناشی از عدم هم‌ترازی فیلد struct در معماری‌های ۳۲ بیتی
(r-ricci)
.RE.SS v1.59.0 - 2022-07-09
.PP
مشاهدهٔ کامیت‌ها (https://github.com/rclone/rclone/compare/v1.58.0...v1.59.0)
.IP \[bu] 2
پشتوانه‌های جدید
.RS 2
.IP \[bu] 2
ترکیب چندین remote در یک درخت دایرکتوری (Nick Craig-Wood)
.IP \[bu] 2
Hidrive (https://rclone.org/hidrive) (Ovidiu Victor Tatar)
.IP \[bu] 2
Internet Archive (https://rclone.org/internetarchive) (Lesmiscore
(Naoya Ozaki))
.IP \[bu] 2
ارائه‌دهندگان جدید S3
.RS 2
.IP \[bu] 2
ArvanCloud AOS (https://rclone.org/s3#arvan-cloud) (ehsantdy)
.IP \[bu] 2
Cloudflare R2 (https://rclone.org/s3#cloudflare-r2) (Nick Craig-Wood)
.IP \[bu] 2
Huawei OBS (https://rclone.org/s3#huawei-obs) (m00594701)
.IP \[bu] 2
IDrive e2 (https://rclone.org/s3#idrive-e2) (vyloy)
.RE
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
test makefile (https://rclone.org/commands/rclone_test_makefile):
ایجاد یک تک‌فایل برای آزمایش (Nick Craig-Wood)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
چارچوب فراداده (https://rclone.org/docs#metadata) جهت خواندن و نوشتن
فراداده‌های سیستمی و کاربری روی پشتوانه‌ها (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
در ابتدا برای پشتوانه‌های \f[V]local\f[R]، \f[V]s3\f[R] و
\f[V]internetarchive\f[R] پیاده‌سازی شد
.IP \[bu] 2
گزینهٔ \f[V]--metadata\f[R]/\f[V]-M\f[R] برای کنترل کپی شدن یا نشدن فراداده
.IP \[bu] 2
گزینهٔ \f[V]--metadata-set\f[R] برای تعیین فراداده جهت بارگذاری‌ها
.IP \[bu] 2
با تشکر از Manz Solutions (https://manz-solutions.at) برای حمایت مالی
از این پروژه.
.RE
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
به‌روزرسانی به go1.18 و تعیین go1.16 به‌عنوان حداقل نسخهٔ مورد نیاز (Nick
Craig-Wood)
.IP \[bu] 2
به‌روزرسانی ساخت go برای android به 1.18.x و NDK به 23.1.7779620 (Nick
Craig-Wood)
.IP \[bu] 2
تمامی باینری‌های windows اکنون بدون CGO هستند (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]linux/arm/v6\f[R] به ایمیج‌های docker (Nick Craig-Wood)
.IP \[bu] 2
تعداد زیادی اصلاحات شناسایی‌شده با staticcheck (https://staticcheck.io)
(albertony)
.IP \[bu] 2
پسوند نسخهٔ قابل پیکربندی مستقل از شمارهٔ نسخه (albertony)
.RE
.IP \[bu] 2
check: پیاده‌سازی \f[V]--no-traverse\f[R] و
\f[V]--no-unicode-normalization\f[R] (Nick Craig-Wood)
.IP \[bu] 2
config: بهبودهای خوانایی (albertony)
.IP \[bu] 2
copyurl: افزودن \f[V]--header-filename\f[R] برای رعایت دستورالعمل
نام فایل در سرایند HTTP (J-P Treen)
.IP \[bu] 2
filter: مجاز دانستن چند گزینهٔ \f[V]--exclude-if-present\f[R] (albertony)
.IP \[bu] 2
fshttp: افزودن \f[V]--disable-http-keep-alives\f[R] جهت غیرفعال‌سازی HTTP Keep
Alives (Nick Craig-Wood)
.IP \[bu] 2
install.sh
.RS 2
.IP \[bu] 2
تنظیم حالت‌های دسترسی (modes) روی فایل‌ها و/یا دایرکتوری‌ها در macOS (Michael C
Tiernan - MIT-Research Computing Project)
.IP \[bu] 2
اعتبارسنجی پیش‌هنگام مجوز sudo با \f[V]-v\f[R] پیش از فراخوانی curl.
(Michael C Tiernan - MIT-Research Computing Project)
.RE
.IP \[bu] 2
lib/encoder: افزودن کدگذاری Semicolon (Nick Craig-Wood)
.IP \[bu] 2
lsf: افزودن پشتیبانی از فراداده با پرچم \f[V]M\f[R] (Nick Craig-Wood)
.IP \[bu] 2
lsjson: افزودن گزینهٔ \f[V]--metadata\f[R]/\f[V]-M\f[R] (Nick Craig-Wood)
.IP \[bu] 2
ncdu
.RS 2
.IP \[bu] 2
پیاده‌سازی انتخاب چندگانه (CrossR)
.IP \[bu] 2
جایگزینی termbox با پوشش‌دهندهٔ termbox از بستهٔ tcell\[aq]s (eNV25)
.IP \[bu] 2
نمایش مسیر صحیح در پنجرهٔ تأیید حذف (Roberto Ricci)
.RE
.IP \[bu] 2
operations
.RS 2
.IP \[bu] 2
افزایش سرعت بررسی هش از طریق لغو کردن هش دیگر در صورتی که اولی
چیزی برنگرداند (Nick Craig-Wood)
.IP \[bu] 2
استفاده از src/dst صحیح در برخی پیام‌های لاگ (zzr93)
.RE
.IP \[bu] 2
rcat: بررسی پیش‌فرض چِک‌سام‌ها مانند دستور copy (Nick Craig-Wood)
.IP \[bu] 2
selfupdate: جایگزینی بستهٔ منسوخ‌شدهٔ \f[V]x/crypto/openpgp\f[R] با
\f[V]ProtonMail/go-crypto\f[R] (albertony)
.IP \[bu] 2
serve ftp: بررسی صحت آرگومان‌های \f[V]--passive-port\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
size: هشدار دربارهٔ نتایج غیردقیق هنگام وجود اشیائی با اندازهٔ نامشخص
(albertony)
.IP \[bu] 2
sync: بررسی هم‌پوشانی اکنون به فیلترها حساس است، بنابراین \f[V]--backup-dir\f[R]
می‌تواند در ریشه باشد به شرط آنکه فیلتر شده باشد (Nick)
.IP \[bu] 2
test info: بررسی طول نام فایل‌ها با استفاده از نویسه‌های یونیکد ۱، ۲، ۳ و ۴ بایتی
(Nick Craig-Wood)
.IP \[bu] 2
test makefile(s): گزینه‌های \f[V]--sparse\f[R]، \f[V]--zero\f[R]،
\f[V]--pattern\f[R]، \f[V]--ascii\f[R] و \f[V]--chargen\f[R] برای
کنترل محتویات فایل (Nick Craig-Wood)
.IP \[bu] 2
اطمینان از فراخوانی متد \f[V]Shutdown\f[R] روی پشتوانه‌ها (Martin
Czygan)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting: رفع شمارش ۳ انتقال برای هر انتقال فایل با طول نامشخص
(buda)
.IP \[bu] 2
ncdu: رفع مشکلی که در آن هنگام \-1 بودن اندازهٔ فایل‌ها، اندازهٔ دایرکتوری جمع زده می‌شد
(albertony)
.IP \[bu] 2
sync/copy/move
.RS 2
.IP \[bu] 2
رفع مشکل \f[V]--fast-list\f[R]، \f[V]--create-empty-src-dirs\f[R] و
\f[V]--exclude\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل \f[V]--max-duration\f[R] و \f[V]--cutoff-mode soft\f[R] (Nick
Craig-Wood)
.RE
.IP \[bu] 2
رفع مشکل fs cache unpin (Martin Czygan)
.IP \[bu] 2
تنظیم کد وضعیت خروج مناسب برای خطاهایی که تلاش مجدد سطح پایین ندارند (مانند
تغییر اندازه/مهر زمانی) (albertony)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
پشتیبانی از \f[V]windows/arm64\f[R] (ممکن است هنوز مشکلاتی وجود داشته باشد \- گزارش
#5828 (https://github.com/rclone/rclone/issues/5828) را ببینید) (Nick Craig-Wood)
.IP \[bu] 2
ثبت خطاهای ورودی/خروجی (IO) در سطح ERROR در گزارش (Nick Craig-Wood)
.IP \[bu] 2
نادیده گرفتن آرگومان سوار کردن \f[V]_netdev\f[R] (Hugal31)
.RE.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
افزودن \f[V]--vfs-fast-fingerprint\f[R] برای اثرانگشت‌های سریع‌تر اما با دقت کمتر (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینهٔ \f[V]--vfs-disk-space-total-size\f[R] برای تنظیم دستی کل فضای دیسک (Claudio Maradonna)
.IP \[bu] 2
vfscache: رفع خطای مهلک sync: unlock of unlocked mutex (Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع مشکل تجزیهٔ پرچم \f[V]--local-nounc\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی از فراداده (Nick Craig-Wood)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
پشتیبانی از فراداده (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
محاسبهٔ Chunksize/blocksize جهت ماندن زیر حد maxUploadParts (Leroy van Logchem)
.IP \[bu] 2
استفاده از کتابخانهٔ chunksize برای تعیین پویای اندازهٔ قطعه (Derek Battams)
.IP \[bu] 2
سطح دسترسی (access tier) غیرحساس به بزرگی و کوچکی حروف (Rob Pickerill)
.IP \[bu] 2
امکان استفاده از شبیه‌ساز راه دور (azurite) (Lorenzo Maiorfi)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--b2-version-at\f[R] برای نمایش نسخه‌های فایل در زمان مشخص‌شده (SwazRGB)
.IP \[bu] 2
استفاده از کتابخانهٔ chunksize برای تعیین پویای اندازهٔ قطعه (Derek Battams)
.RE
.IP \[bu] 2
Chunker
.RS 2
.IP \[bu] 2
علامت‌گذاری به‌عنوان عدم پشتیبانی از فراداده (Nick Craig-Wood)
.RE
.IP \[bu] 2
Compress
.RS 2
.IP \[bu] 2
پشتیبانی از فراداده (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
امکان افزودن یک ریموت ترکیبی \f[V]AllDrives:\f[R] با استفاده از \f[V]backend config -o config\f[R] (Nick Craig-Wood)
.IP \[bu] 2
امکان کارکرد \f[V]--drive-shared-with-me\f[R] با درایوهای اشتراکی (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--drive-resource-key\f[R] برای دسترسی به فایل‌های به‌اشتراک‌گذاشته‌شده از طریق پیوند (Nick Craig-Wood)
.IP \[bu] 2
افزودن دستورهای بک‌اند \f[V]exportformats\f[R] و \f[V]importformats\f[R] برای اشکال‌زدایی (Nick Craig-Wood)
.IP \[bu] 2
رفع خطاهای 404 هنگام رونوشت/رونوشت سمت سرور اشیاء از پوشهٔ عمومی (Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی مستندات صفحهٔ رضایت درونی OAuth (Phil Shackleton)
.IP \[bu] 2
انتقال \f[V]root_folder_id\f[R] به بخش پیشرفته (Abhiraj)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
مهاجرت از api منسوخ‌شده (m8rge)
.IP \[bu] 2
افزودن گزارش‌ها (logs) برای نمایش فراتر رفتن از محدودیت‌های فاصلهٔ نظرسنجی (poll interval) (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای اشاره‌گر تهی (nil pointer) در صورت یافت نشدن کاربر جعل‌هویت‌شدهٔ dropbox (Nick Craig-Wood)
.RE
.IP \[bu] 2
Fichier
.RS 2
.IP \[bu] 2
تجزیهٔ کدهای خطای api و مدیریت متناسب آن‌ها (buengese)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از گزینهٔ \f[V]disable_utf8\f[R] (Jason Zheng)
.IP \[bu] 2
بازگشت به بالادست \f[V]github.com/jlaffaye/ftp\f[R] از انشعاب خودمان (Nick Craig-Wood)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
افزودن \f[V]--gcs-no-check-bucket\f[R] برای به حداقل رساندن تراکنش‌ها و مجوزها (Nick Gooding)
.IP \[bu] 2
افزودن پرچم \f[V]--gcs-decompress\f[R] برای خارج کردن فایل‌های کدگذاری‌شده با gzip از فشردگی (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
به‌طور پیش‌فرض این موارد به‌صورت فشرده بارگیری می‌شوند (که پیش‌تر با شکست مواجه می‌شد)
.RE
.RE
.IP \[bu] 2
Hasher
.RS 2
.IP \[bu] 2
پشتیبانی از فراداده (Nick Craig-Wood)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
رفع عدم دریافت پاسخ هنگام استفاده از گردانندهٔ احراز هویت سفارشی (albertony)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از بارگذاری در دستگاه و نقطهٔ اتصال (mountpoint) سفارشی (albertony)
.IP \[bu] 2
ذخیرهٔ همیشگی نام کاربری در پیکربندی و استفاده از آن جهت اجتناب از درخواست اولیهٔ API (albertony)
.IP \[bu] 2
رفع مشکل رونوشت سمت سرور هنگامی که مقصد در سطل زباله است (albertony)
.IP \[bu] 2
رفع خروجی فهرست‌گیری ریموت دارای نویسه‌های ویژه (albertony)
.RE
.IP \[bu] 2
Mailru
.RS 2
.IP \[bu] 2
رفع اتمام مهلت زمانی (timeout) با استفاده از int به‌جای time.Duration برای نگهداری تعداد ثانیه‌ها (albertony)
.RE
.IP \[bu] 2
Mega
.RS 2
.IP \[bu] 2
مستندسازی استفاده از MEGAcmd برای کمک به حل مشکلات ورود ناموفق (Art M. Gallagher)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]--poll-interval\f[R] برای onedrive (Hugo Laloge)
.IP \[bu] 2
افزودن گزینهٔ حوزه‌های دسترسی (access scopes) (Sven Gerber)
.RE
.IP \[bu] 2
Opendrive
.RS 2
.IP \[bu] 2
برطرف کردن باگ‌های تأخیر و کوتاه‌سازی (truncate) (Scott Grimes)
.RE
.IP \[bu] 2
Pcloud
.RS 2.IP \[bu] 2
رفع مشکل about در صورت نبود فضای خالی باقی‌مانده (buengese)
.IP \[bu] 2
رفع مشکل cleanup (buengese)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
استفاده از PUT Object به‌جای URLهای presigned برای بارگذاری اشیاء تک‌بخشی (Nick Craig-Wood)
.IP \[bu] 2
نادیده‌گرفتن اشیاء غیر GLACIER در دستور restore بک‌اند (Vincent Murphy)
.IP \[bu] 2
استفاده از کتابخانه chunksize برای تعیین پویای اندازه قطعه (Derek Battams)
.IP \[bu] 2
تلاش مجدد در خطاهای RequestTimeout (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی خواندن و نوشتن متادیتا (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از about و hashsum در سرورهای ویندوز (albertony)
.IP \[bu] 2
استفاده از افزونه اختصاصی آمار VFS ارائه‌دهنده برای about در صورت دردسترس‌بودن (albertony)
.IP \[bu] 2
افزودن \f[V]--sftp-chunk-size\f[R] برای کنترل اندازه بسته‌ها در پیوندهای با تأخیر بالا (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--sftp-concurrency\f[R] برای بهبود انتقال‌ها در تأخیر بالا (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینه \f[V]--sftp-set-env\f[R] جهت تنظیم متغیرهای محیطی (Nick Craig-Wood)
.IP \[bu] 2
افزودن Hetzner Storage Boxes به بک‌اندهای پشتیبانی‌شده sftp (Anthrazz)
.RE
.IP \[bu] 2
Storj
.RS 2
.IP \[bu] 2
رفع مشکل put که هنگام استفاده از mount منجر به غیرقابل‌خواندن شدن فایل می‌شد (Erik van Velzen)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
افزودن گزینه \f[V]min_free_space\f[R] برای سیاست‌های \f[V]lfs\f[R]/\f[V]eplfs\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل بارگذاری فایل‌ها در union متشکل از تمام ریموت‌های مبتنی بر باکت (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل دریافت فضای آزاد برای ریموت‌هایی که از آن پشتیبانی نمی‌کنند (Nick Craig-Wood)
.IP \[bu] 2
اصلاح سیاست \f[V]eplus\f[R] جهت انتخاب مدخل صحیح برای فایل‌های موجود (Nick Craig-Wood)
.IP \[bu] 2
پشتیبانی از متادیتا (Nick Craig-Wood)
.RE
.IP \[bu] 2
Uptobox
.RS 2
.IP \[bu] 2
رفع مشکل مدیریت مسیر ریشه (buengese)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از SharePoint در دیگر مناطق خاص (Noah Hsu)
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
مدیریت خطای api در جابه‌جایی سمت سرور (albertony)
.RE
.IP \[bu] 2
Zoho
.RS 2
.IP \[bu] 2
افزودن مناطق ژاپن و چین (buengese)
.RE.SS v1.58.1 \- 2022-04-29
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.58.0...v1.58.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
build: به‌روزرسانی github.com/billziss-gh به github.com/winfsp (Nick
Craig-Wood)
.IP \[bu] 2
filter: اصلاح منطقه زمانی \f[V]--min-age\f[R]/\f[V]-max-age\f[R] از UTC
به محلی طبق مستندات (Nick Craig-Wood)
.IP \[bu] 2
rc/js: تصحیح نام‌های متدهای RC (Sơn Trần-Nguyễn)
.IP \[bu] 2
مستندات
.RS 2
.IP \[bu] 2
اصلاح برخی از پیوندها به صفحات دستورات (albertony)
.IP \[bu] 2
افزودن یادداشت \f[V]--multi-thread-streams\f[R] به \f[V]--transfers\f[R].
(Zsolt Ero)
.RE
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
اصلاح \f[V]--devname\f[R] و fusermount: unknown option \[aq]fsname\[aq]
هنگام مانت از طریق rc (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
حذف عبارتی که القا می‌کرد VFS فقط مخصوص مانت کردن است (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
رفع مشکل تلاش مجدد برای آپلودهای چندبخشی با خطای incorrect_offset (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
استفاده از s3 pacer برای افزایش سرعت تراکنش‌ها (Nick Craig-Wood)
.IP \[bu] 2
pacer: پیش‌فرض قرار دادن burst به مقدار ۱۰۰ برای Google pacer جهت اصلاح pacing در gcs
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
اصلاح scope در درخواست توکن (albertony)
.RE
.IP \[bu] 2
Netstorage
.RS 2
.IP \[bu] 2
اصلاح کدهای HTML اسکیپ‌نشده در مستندات (Nick Craig-Wood)
.IP \[bu] 2
یکپارچه‌سازی سطوح عناوین (Nick Craig-Wood)
.IP \[bu] 2
افزودن اطلاعات تماس پشتیبانی به مستندات netstorage (Nil Alexandrov)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
ذکر این نکته که sharepoint نیز فایل‌های وب (.html، .aspx) را تغییر می‌دهد (GH)
.RE
.IP \[bu] 2
Putio
.RS 2
.IP \[bu] 2
مدیریت خطاهای محدودیت نرخ درخواست (rate limit) (Berkan Teber)
.IP \[bu] 2
رفع مشکل دانلود چندنخی و سایر درخواست‌های بازه‌ای (rafma0)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن ChinaMobile EOS به فهرست ارائه‌دهندگان (GuoXingbin)
.IP \[bu] 2
همگام‌سازی ارائه‌دهندگان در توضیحات پیکربندی با providers (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
رفع ناسازگاری کلیدهای RSA در OpenSSH 8.8+ (KARBOWSKI Piotr)
.IP \[bu] 2
ذکر این نکته که Scaleway C14 در حال منسوخ کردن SFTP به نفع S3 است (Adrien
Rey-Jarthon)
.RE
.IP \[bu] 2
Storj
.RS 2
.IP \[bu] 2
رفع مشکل ایجاد باکت هنگام Move (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
عدم بازنویسی Referer در صورت تنظیم شدن آن توسط کاربر (Nick Craig-Wood)
.RE.SS v1.58.0 \- 2022-03-18
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.57.0...v1.58.0)
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
Akamai Netstorage (Nil Alexandrov)
.IP \[bu] 2
پشتیبانی از Seagate Lyve (https://rclone.org/s3/#lyve)، SeaweedFS، Storj و RackCorp از طریق بک‌اند s3
.IP \[bu] 2
Storj (https://rclone.org/storj) (تغییر نام‌یافته از Tardigrade \- فایل‌های پیکربندی قدیمی شما همچنان کار خواهند کرد)
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
bisync (https://rclone.org/bisync) \- همگام‌سازی ابری دوطرفه و آزمایشی (Ivan Andreev, Chris Nelson)
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
افزودن ساخت \f[V]windows/arm64\f[R] (هنوز از \f[V]rclone mount\f[R] پشتیبانی نمی‌شود) (Nick Craig-Wood)
.IP \[bu] 2
افزایش حداقل نسخه go به go1.15 (Nick Craig-Wood)
.RE
.IP \[bu] 2
config: مجاز شدن نقطه در نام‌های remote و بهبود ویرایش پیکربندی (albertony)
.IP \[bu] 2
dedupe: افزودن خروج (quit) به‌عنوان یک گزینه در حالت تعاملی (albertony)
.IP \[bu] 2
dlna: به‌روزرسانی آیکون‌ها به جدیدترین موارد (Alain Nussbaumer)
.IP \[bu] 2
filter: افزودن نحو \f[V]{{ regexp }}\f[R] (https://rclone.org/filtering/#regexp) به تطبیق الگوها (Nick Craig-Wood)
.IP \[bu] 2
fshttp: افزودن معیارهای prometheus برای کدهای وضعیت HTTP (Michał Matczuk)
.IP \[bu] 2
hashsum: پشتیبانی از ایجاد هش از داده‌های دریافت‌شده از stdin (albertony)
.IP \[bu] 2
librclone
.RS 2
.IP \[bu] 2
پذیرش رشته خالی یا مقدار null در ورودی به‌جای شیء خالی json (albertony)
.IP \[bu] 2
افزودن پشتیبانی از دستورهای mount (albertony)
.RE
.IP \[bu] 2
operations: افزودن جابه‌جایی‌های سمت سرور به آمارها (Ole Frost)
.IP \[bu] 2
rc: امکان غیرفعال کردن احراز هویت برای وب‌واسط (web gui) توسط کاربر (negative0)
.IP \[bu] 2
tree: حذف گزینه منسوخ \f[V]--human\f[R] که با گزینه سراسری \f[V]--human-readable\f[R] جایگزین شده است (albertony)
.IP \[bu] 2
version: گزارش نام نمایشی (friendly-name) صحیح برای نسخه‌های جدیدتر Windows 10/11 (albertony)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
اصلاح نسخه معماری ARM در بسته‌های .deb پس از تغییرات nfpm (Nick Craig-Wood)
.IP \[bu] 2
فورک مستقیم (Hard fork) مخزن \f[V]github.com/jlaffaye/ftp\f[R] برای اصلاح \f[V]go get github.com/rclone/rclone\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
oauthutil: رفع خرابی هنگام درخواست \f[V]/robots.txt\f[R] توسط مرورگر وب (Nick Craig-Wood)
.IP \[bu] 2
operations: رفع نشت goroutine در صورت تلاش مجدد برای کپی (Ankur Gupta)
.IP \[bu] 2
rc:
.RS 2
.IP \[bu] 2
اصلاح مقدار پیش‌فرض پارامتر \f[V]expires\f[R] در \f[V]operations/publiclink\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع محاسبه نشدن \f[V]transferQueueSize\f[R] هنگام جمع‌بندی گروه آمارها (Carlo Mion)
.IP \[bu] 2
رفع فیلدهای مفقود \f[V]StatsInfo\f[R] در محاسبه مجموع گروه (Carlo Mion)
.RE
.IP \[bu] 2
sync: اصلاح \f[V]--max-duration\f[R] به‌گونه‌ای که پس از سپری شدن مدت زمان، دوباره تلاش نکند (Nick Craig-Wood)
.IP \[bu] 2
touch: رفع مشکلی که در آن به‌جای فایل، دایرکتوری ایجاد می‌شد (albertony)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
افزودن \f[V]--devname\f[R] برای تنظیم نام دستگاه ارسالی به FUSE جهت نمایش سوار کردن (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
افزودن کنترل از راه دور \f[V]vfs/stats\f[R] برای نمایش آمارها (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای \f[V]failed to _ensure cache internal error: downloaders is nil error\f[R] (Nick Craig-Wood)
.IP \[bu] 2
اصلاح مدیریت نویسه‌های خاص در نام فایل‌ها (Bumsu Hyeon)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع ابطال هش که باعث بروز خطا در سوار کردن محلی crypt می‌شد (Nick Craig-Wood)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
افزودن گزینه‌های کدگذاری نام فایل \f[V]base64\f[R] و \f[V]base32768\f[R] (Max Sum, Sinan Tan)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
پیاده‌سازی پارامتر \f[V]--azureblob-upload-concurrency\f[R] برای افزایش سرعت بارگذاری‌ها (Nick Craig-Wood)
.IP \[bu] 2
حذف سقف ۱۰۰ مگابایتی برای \f[V]chunk_size\f[R] زیرا دیگر نیازی به آن نیست (Nick Craig-Wood)
.IP \[bu] 2
افزایش \f[V]--azureblob-upload-concurrency\f[R] به ۱۶ به‌صورت پیش‌فرض (Nick Craig-Wood)
.IP \[bu] 2
رفع خرابی با نشانی SAS URL در صورت نبود کانتینر (Nick Craig-Wood)
.RE
.IP \[bu] 2
Compress
.RS 2
.IP \[bu] 2
رفع خرابی در صورت شکست بارگذاری فراداده (Nick Craig-Wood)
.IP \[bu] 2
رفع نشت حافظه (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن \f[V]--drive-copy-shortcut-content\f[R] (Abhiraj)
.IP \[bu] 2
غیرفعال کردن جریان OAuth OOB (کپی کردن توکن) به دلیل منسوخ شدن توسط Google (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
مشاهده یادداشت منسوخ شدن (https://developers.googleblog.com/2022/02/making-oauth-flows-safer.html#disallowed-oob).
.RE
.IP \[bu] 2
افزودن پرچم \f[V]--drive-skip-dangling-shortcuts\f[R] (Nick Craig-Wood)
.IP \[bu] 2
هنگام استفاده از نوع پیوند، \f[V]--drive-export-formats\f[R] همه انواع اسناد را نشان می‌دهد (Nick Craig-Wood)
.RE.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
افزایش سرعت فهرست‌کردن دایرکتوری‌ها با مشخص کردن ۱۰۰۰ مورد در هر تکه (Nick
Craig-Wood)
.IP \[bu] 2
صرفه‌جویی در یک درخواست API هنگام قرار داشتن در ریشه (Nick Craig-Wood)
.RE
.IP \[bu] 2
Fichier
.RS 2
.IP \[bu] 2
پیاده‌سازی قابلیت About (Gourav T)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
افزودن \f[V]--ftp-ask-password\f[R] برای درخواست گذرواژه در صورت نیاز
(Borna Butkovic)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
افزودن ناحیه‌های (regions) جاافتاده (Nick Craig-Wood)
.IP \[bu] 2
غیرفعال‌سازی جریان OAuth OOB (رونوشت توکن) به دلیل منسوخ شدن توسط Google (Nick
Craig-Wood)
.RS 2
.IP \[bu] 2
مشاهده یادداشت منسوخ‌سازی
(https://developers.googleblog.com/2022/02/making-oauth-flows-safer.html#disallowed-oob).
.RE
.RE
.IP \[bu] 2
Googlephotos
.RS 2
.IP \[bu] 2
غیرفعال‌سازی جریان OAuth OOB (رونوشت توکن) به دلیل منسوخ شدن توسط Google (Nick
Craig-Wood)
.RS 2
.IP \[bu] 2
مشاهده یادداشت منسوخ‌سازی
(https://developers.googleblog.com/2022/02/making-oauth-flows-safer.html#disallowed-oob).
.RE
.RE
.IP \[bu] 2
Hasher
.RS 2
.IP \[bu] 2
رفع خرابی و فروپاشی برنامه هنگام یافت نشدن شیء (Nick Craig-Wood)
.RE
.IP \[bu] 2
Hdfs
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از انتقال فایل (Move) و انتقال دایرکتوری (DirMove) (Andy Jackson)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
بهبود شناسایی URLهایی که به یک فایل تنها اشاره دارند (albertony)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
تغییر API مورد استفاده توسط فهرست‌بندی بازگشتی (ListR) (Kim)
.IP \[bu] 2
افزودن پشتیبانی از Tele2 Cloud (Fredric Arklid)
.RE
.IP \[bu] 2
Koofr
.RS 2
.IP \[bu] 2
افزودن سرویس Digistorage به عنوان ارائه‌دهنده Koofr.
(jaKa)
.RE
.IP \[bu] 2
Mailru
.RS 2
.IP \[bu] 2
رفع سرریز int32 در معماری arm32 (Ivan Andreev)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
افزودن گزینه پیکربندی برای OAuth scope با شناسه \f[V]Sites.Read.All\f[R] (Charlie
Jiang)
.IP \[bu] 2
بهینه‌سازی جزئی در quickxorhash (Isaac Levy)
.IP \[bu] 2
افزودن پرچم \f[V]--onedrive-root-folder-id\f[R] (Nick Craig-Wood)
.IP \[bu] 2
عدم تلاش مجدد در صورت مواجهه با خطای \f[V]400 pathIsTooLong\f[R] (ctrl-q)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از فهرست‌بندی بازگشتی (ListR) (Niels van de Weem)
.IP \[bu] 2
رفع مشکل برچسب‌های زمانی پیش از ۱۹۷۰ (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
استفاده از \f[V]ListObjectsV2\f[R] برای فهرست‌بندی سریع‌تر (Felix Bünemann)
.RS 2
.IP \[bu] 2
بازگشت به \f[V]ListObject\f[R] نگارش ۱ در صورت عدم پشتیبانی ارائه‌دهنده (Nick
Craig-Wood)
.RE
.IP \[bu] 2
استفاده از \f[V]ETag\f[R] در انتقال‌های چندبخشی جهت اعتبارسنجی صحت انتقال (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
افزودن گزینه ناسازگاری ارائه‌دهنده \f[V]--s3-use-multipart-etag\f[R] جهت غیرفعال‌سازی این مورد در ارائه‌دهندگان پشتیبانی‌نشده (Nick Craig-Wood)
.RE
.IP \[bu] 2
ارائه‌دهندگان جدید
.RS 2
.IP \[bu] 2
فضای ذخیره‌سازی شیء RackCorp (bbabich)
.IP \[bu] 2
فضای ذخیره‌سازی ابری Seagate Lyve (Nick Craig-Wood)
.IP \[bu] 2
سیستم فایلی SeaweedFS (Chris Lu)
.IP \[bu] 2
درگاه‌های مشترک Storj (Márton Elek, Nick Craig-Wood)
.RE
.IP \[bu] 2
افزودن اطلاعات نقطه پایانی Wasabi AP Northeast 2 (lindwurm)
.IP \[bu] 2
افزودن رده ذخیره‌سازی \f[V]GLACIER_IR\f[R] (Yunhai Luo)
.IP \[bu] 2
مستندسازی راهکار جایگزین \f[V]Content-MD5\f[R] برای باکت‌های دارای قفل شیء فعال (Paulo Martins)
.IP \[bu] 2
رفع مشکل بارگذاری چندبخشی با پرچم \f[V]--no-head\f[R] (Nick Craig-Wood)
.IP \[bu] 2
ساده‌سازی پردازش طول محتوا (content length) در s3 همراه با download url (Logeshwaran
Murugesan)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن rclone به فهرست دستورهای \f[V]md5sum\f[R]/\f[V]sha1sum\f[R] پشتیبانی‌شده برای جستجو (albertony)
.IP \[bu] 2
بازسازی ساختار به‌گونه‌ای که تنها یک روش برای اجرای دستورهای راه دور وجود داشته باشد (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل اتمام مهلت زمانی هنگام هش کردن فایل‌های بزرگ از طریق ارسال keepalive (Nick
Craig-Wood)
.IP \[bu] 2
رفع جست‌وجوی مکان (seeking) غیرضروری در فایل هنگام بارگذاری و بارگیری (Nick
Craig-Wood)
.IP \[bu] 2
به‌روزرسانی مستندات در زمینه نحوه ایجاد فایل \f[V]known_hosts\f[R] (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Storj
.RS 2
.IP \[bu] 2
تغییر نام پسانه tardigrade به پسانه storj (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی جابه‌جایی سمت سرور (Move) برای فایل‌ها (Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی مستندات برای تشریح تفاوت‌های میان s3 و این پسانه (Elek,
Márton)
.RE.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
رفع اشکال About به‌طوری‌که تنها اطلاعات مربوط به کانتینر جاری را نشان دهد (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
رفع اشکال مدیریت ریموت‌های حاوی \f[V]//\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع بن‌بست هنگامی که بخشی از یک آپلود چندبخشی با شکست مواجه می‌شود (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال برگرداندن nil توسط خط‌مشی eplus (Vitor Arruda)
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از حذف دائمی (deinferno)
.RE
.SS v1.57.0 - 2021-11-01
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.56.0...v1.57.0)
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
Sia: برای ابر نامتمرکز Sia (Ian Levesque, Matthew Sevey, Ivan
Andreev)
.IP \[bu] 2
Hasher: کش کردن هش‌ها و فعال‌سازی هش‌ها برای بک‌اندهایی که از آن‌ها
پشتیبانی نمی‌کنند (Ivan Andreev)
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
lsjson --stat: برای دریافت اطلاعات درباره یک فایل/دایرکتوری منفرد و
api مربوط به \f[V]operations/stat\f[R] (Nick Craig-Wood)
.IP \[bu] 2
config paths: نمایش مسیرهای پیکربندی‌شده (albertony)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
about: یکدست‌تر کردن خروجی خوانا برای انسان با سایر دستورها
(albertony)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
استفاده از go1.17 برای ساخت و تعیین go1.14 به عنوان حداقل نسخه پشتیبانی‌شده (Nick
Craig-Wood)
.IP \[bu] 2
به‌روزرسانی Go به 1.16 و NDK به 22b برای ساخت‌های Android (x0b)
.RE
.IP \[bu] 2
config
.RS 2
.IP \[bu] 2
پشتیبانی از خط پیوند در نام ریموت از طریق متغیر محیطی (albertony)
.IP \[bu] 2
امکان‌پذیر ساختن پیکربندی دایرکتوری موقت توسط کاربر (albertony)
.IP \[bu] 2
تبدیل مقدار \f[V]--cache-dir\f[R] به یک مسیر مطلق (albertony)
.IP \[bu] 2
عدم بازنویسی انواع MIME از مقادیر پیش‌فرض سیستم‌عامل (albertony)
.RE
.IP \[bu] 2
docs
.RS 2
.IP \[bu] 2
پاک‌سازی ظاهر فهرست مطالب و سطوح سرآیندها (albertony)
.IP \[bu] 2
گسترش مستندات درباره نام‌های معتبر ریموت (albertony)
.IP \[bu] 2
اشاره به make برای ساخت و برچسب cmount برای macos (Alex Chen)
.IP \[bu] 2
\&...و مشارکت‌های بسیار دیگر که برای ذکر شدن بیش از حد پرتعدادند!
.RE
.IP \[bu] 2
fs: دستور Move با \f[V]--ignore-existing\f[R] فایل‌های نادیده‌گرفته‌شده را حذف نخواهد کرد
(Nathan Collins)
.IP \[bu] 2
hashsum
.RS 2
.IP \[bu] 2
عدم حساسیت به بزرگی و کوچکی حروف در مقادیر هشِ فایل sum (Ivan Andreev)
.IP \[bu] 2
عدم درج \f[V]ERROR\f[R] یا \f[V]UNSUPPORTED\f[R] در خروجی (Ivan
Andreev)
.RE
.IP \[bu] 2
lib/encoder: افزودن کدگذاری قلاب‌ها (Ivan Andreev)
.IP \[bu] 2
lib/file: بهبود پیام خطا هنگام تلاش برای ساخت دایرکتوری روی درایو ناموجود در windows (albertony)
.IP \[bu] 2
lib/http: انتقال salt هش گذرواژه به گزینه‌ها به همراه مقدار پیش‌فرض (Nolan
Woods)
.IP \[bu] 2
lib/kv: افزودن api پایگاه‌داده کلید\-مقدار (Ivan Andreev)
.IP \[bu] 2
librclone
.RS 2
.IP \[bu] 2
افزودن تابع \f[V]RcloneFreeString\f[R] (albertony)
.IP \[bu] 2
آزادسازی رشته‌ها در مثال python (albertony)
.RE
.IP \[bu] 2
log: چاپ اختیاری pid در لاگ‌ها (Ivan Andreev)
.IP \[bu] 2
ls: معرفی گزینه عمومی \f[V]--human-readable\f[R] برای چاپ اندازه‌های خوانا برای انسان (albertony)
.IP \[bu] 2
ncdu: معرفی کلید \f[V]u\f[R] برای تغییر وضعیت نمایش خوانا برای انسان (albertony)
.IP \[bu] 2
operations: افزودن خروجی \f[V]rmdirs -v\f[R] (Justin Winokur)
.IP \[bu] 2
serve sftp
.RS 2
.IP \[bu] 2
تولید کلید سرور ECDSA و همچنین RSA (Nick Craig-Wood)
.IP \[bu] 2
تولید کلید سرور Ed25519 علاوه بر ECDSA و RSA (albertony)
.RE
.IP \[bu] 2
serve docker
.RS 2
.IP \[bu] 2
امکان شخصی‌سازی تنظیمات پراکسی در افزونه docker (Ivan Andreev)
.IP \[bu] 2
ساخت افزونه docker برای چندین پلتفرم (Thomas Stachl)
.RE
.IP \[bu] 2
size: گنجاندن شمارش خوانا برای انسان (albertony)
.IP \[bu] 2
touch: افزودن پشتیبانی از ثبت زمان دسترسی/تغییر فایل‌ها در دایرکتوری، با گزینه بازگشتی، فیلتر کردن و \f[V]--dry-run\f[R]/\f[V]-i\f[R] (albertony)
.IP \[bu] 2
tree: حذف گزینه چاپ اندازه‌های خوانا برای انسان به نفع گزینه عمومی (albertony)
.RE
.IP \[bu] 2
رفع اشکالات
.RS 2
.IP \[bu] 2
lib/http
.RS 2
.IP \[bu] 2
رفع اشکال بررسی نادرست نام کاربری در ارائه‌دهنده رازِ تک‌احرازهویتی (Nolan Woods)
.IP \[bu] 2
رفع اشکال در مدیریت اعتبارنامه‌های SSL (Nolan Woods)
.RE
.IP \[bu] 2
serve ftp: اطمینان از ارسال همیشگی modtime به صورت UTC جهت رفع ناهماهنگی‌های منطقه زمانی (Nick Craig-Wood)
.IP \[bu] 2
serve sftp: رفع اشکال در تولید کلیدهای سرور در windows (albertony)
.IP \[bu] 2
serve docker: رفع اشکال umask در مبنای هشت (Ivan Andreev)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
امکان اجرای مستقیم rclone به عنوان یک کمک‌برنامه نقطه اتصال (mount helper) از fstab (Ivan
Andreev)
.IP \[bu] 2
استفاده از procfs برای اعتبارسنجی نقطه اتصال در linux (Ivan Andreev)
.IP \[bu] 2
دیمن‌سازی صحیح جهت سازگاری با automount (Ivan Andreev)
.RE
.IP \[bu] 2
VFS
.RS 2.IP \[bu] 2
اطمینان از مجاز بودن نام‌های استفاده‌شده در مسیر حافظه موقت (cache) در سیستم‌عامل فعلی (albertony)
.IP \[bu] 2
صرف‌نظر کردن از \f[V]ECLOSED\f[R] هنگام کوتاه کردن دستگیره‌های فایل برای برطرف کردن خطای متناوب توصیف‌گر فایل نادرست (Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
بازطراحی و انتقال کدگذاری پیش‌فرض سیستم‌عامل از پشتیبان local به کتابخانه مشترک encoder (albertony)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
بازگرداندن شیء بسته‌بندی‌شده حتی با \f[V]--crypt-no-data-encryption\f[R] (Ivan Andreev)
.IP \[bu] 2
رفع مشکل بارگذاری‌ها با \f[V]--crypt-no-data-encryption\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
افزودن \f[V]--azureblob-no-head-object\f[R] (Tatsuya Noyori)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
افزایش قابلیت اطمینان در فهرست‌بندی دایرکتوری‌های پرکاربرد (Nick Craig-Wood)
.IP \[bu] 2
حذف حداکثری موارد در هنگام انجام پاک‌سازی (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--box-list-chunk\f[R] برای کنترل اندازه تکه‌های فهرست‌بندی (Nick Craig-Wood)
.IP \[bu] 2
حذف موازی موارد در پاک‌سازی با استفاده از ریسه‌های \f[V]--checkers\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--box-owned-by\f[R] برای نمایش تنها مواردی که متعلق به حساب ورودی پاس‌داده‌شده هستند (Nick Craig-Wood)
.IP \[bu] 2
تلاش مجدد هنگام خطاهای \f[V]operation_blocked_temporary\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Chunker
.RS 2
.IP \[bu] 2
الزام Md5all به ایجاد فراداده در صورت کُند بودن هش پایه (Ivan Andreev)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزایش سرعت فهرست‌بندی دایرکتوری با محدود کردن فهرست API با استفاده از فیلترهای فعلی (fotile96, Ivan Andreev)
.IP \[bu] 2
رفع مشکل بافر کردن بارگذاری تک‌درخواستی برای فایل‌های کوچک‌تر از \f[V]--drive-upload-cutoff\f[R] (YenForYang)
.IP \[bu] 2
افزودن گزینهٔ \f[V]-o config\f[R] به \f[V]backend drives\f[R] جهت ایجاد پیکربندی برای تمامی درایوهای اشتراکی (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
افزودن \f[V]--dropbox-batch-commit-timeout\f[R] برای کنترل مهلت زمانی تراکنش دسته‌ای (Nick Craig-Wood)
.RE
.IP \[bu] 2
Filefabric
.RS 2
.IP \[bu] 2
استفاده از عقب‌نشینی نمایی برای error_background جهت رفع خطاها (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل جابه‌جایی دایرکتوری پس از تغییر API (Nick Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
فعال‌سازی پیش‌فرض حافظه موقت نشست tls (Ivan Andreev)
.IP \[bu] 2
افزودن گزینه‌ای برای غیرفعال کردن tls13 (Ivan Andreev)
.IP \[bu] 2
رفع خطای اتمام مهلت (timeout) پس از بارگذاری‌های طولانی (Ivan Andreev)
.IP \[bu] 2
افزودن پشتیبانی از زمان دقیق (Ivan Andreev)
.IP \[bu] 2
فعال‌سازی CI برای ProFtpd، PureFtpd و VsFtpd (Ivan Andreev)
.RE
.IP \[bu] 2
Googlephotos
.RS 2
.IP \[bu] 2
استفاده از کدگذار برای نام آلبوم‌ها جهت رفع مشکل آلبوم‌های دارای نویسه‌های کنترلی (Parth Shukla)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]SetModTime\f[R] برای پشتیبانی از تغییرات منحصر به زمان ویرایش (albertony)
.IP \[bu] 2
بهبود مدیریت خطا در \f[V]SetModTime\f[R] و فایل‌های خراب به‌طور کلی (albertony)
.IP \[bu] 2
افزودن پشتیبانی از قابلیت \f[V]UserInfo\f[R] (\f[V]rclone config userinfo\f[R]) (albertony)
.IP \[bu] 2
بازگرداندن پیوند بارگیری مستقیم از دستور \f[V]rclone link\f[R] (albertony)
.RE
.IP \[bu] 2
Koofr
.RS 2
.IP \[bu] 2
ایجاد پیوند اشتراک‌گذاری مستقیم (Dmitry Bogatov)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از sha256 (Ken Enrique Morel)
.RE
.IP \[bu] 2
Premiumizeme
.RS 2
.IP \[bu] 2
رفع مشکل فهرست‌بندی دایرکتوری پس از تغییرات API (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل جابه‌جایی سمت سرور پس از تغییر API (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل جابه‌جایی دایرکتوری در سمت سرور پس از تغییرات API (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از استفاده از نشانی اینترنتی CDN برای بارگیری فایل (Logeshwaran)
.IP \[bu] 2
افزودن AWS Snowball Edge به مثال‌های ارائه‌دهندگان (r0kk3rz)
.IP \[bu] 2
استفاده از ترکیبی از تلاش‌های مجدد SDK و تلاش‌های مجدد rclone (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل کار نکردن IAM Role برای Service Account و سایر مشکلات احراز هویت (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل احراز هویت \f[V]shared_credentials_file\f[R] پس از واگردانی اصلاح نادرست (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای corrupted on transfer: sizes differ 0 vs xxxx در Ceph (Nick Craig-Wood)
.RE
.IP \[bu] 2
Seafile
.RS 2
.IP \[bu] 2
رفع خطا در زمانی که برای 2fa پیکربندی نشده است (Fred)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
رفع خطای اتمام مهلت (timeout) هنگام انجام MD5SUM برای فایل‌های بزرگ (Nick Craig-Wood)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
به‌روزرسانی نشانی اینترنتی OCI (David Liu)
.IP \[bu] 2
مستندسازی OVH Cloud Archive (HNGamingUK)
.RE.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
رفع کار نکردن تغییر نام در union متشکل از دیسک محلی و ریموت مبتنی بر باکت
(Nick Craig-Wood)
.RE
.SS v1.56.2 - 2021-10-01
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.56.1...v1.56.2)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
serve http: افزودن مجدد احراز هویت مفقود به سرویس http (Nolan Woods)
.IP \[bu] 2
build: به‌روزرسانی golang.org/x/sys برای رفع کرش در macOS هنگام کامپایل با
go1.17 (Herby Gillot)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
رفع بن‌بست (deadlock) پس از به‌روزرسانی ناموفق هنگامی که concurrency=1 است (Ivan Andreev)
.RE
.SS v1.56.1 - 2021-09-19
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.56.0...v1.56.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting: رفع مشکل بیشینه bwlimit با مقیاس‌بندی حداکثر اندازه token bucket
(Nick Craig-Wood)
.IP \[bu] 2
rc: رفع مشکل به‌روزرسانی نشدن سرعت در core/stats (negative0)
.IP \[bu] 2
selfupdate: رفع اشکال گزینه \f[V]--quiet\f[R]، کاملاً بی‌صدا نبود (yedamo)
.IP \[bu] 2
serve http: رفع خروج مستقیم \f[V]serve http\f[R] بلافاصله پس از راه‌اندازی
(Cnly)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
اعمال gofmt از golang 1.17 (Ivan Andreev)
.IP \[bu] 2
به‌روزرسانی Go به 1.16 و NDK به 22b برای android/any (x0b)
.RE
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
رفع اشکال حالت \f[V]--daemon\f[R] (Ivan Andreev)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع موارد تکراری در هنگام تغییر نام (Nick Craig-Wood)
.IP \[bu] 2
رفع کرش هنگام کوتاه کردن (truncate) شیئی که تازه بارگذاری شده است (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکلی که در آن دایرکتوری‌های خالی در cache meta dir انباشته می‌شدند (albertony)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
اصلاح دستورالعمل‌های auto config (Greg Sadetsky)
.IP \[bu] 2
اصلاح مثال lsf بدون drive-impersonate (Greg Sadetsky)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
مدیریت بهتر خطای HTTP 400 در PublicLink (Alex Chen)
.IP \[bu] 2
شفاف‌سازی فرایند ایجاد client_id سفارشی (Mariano
Absatz)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
بازگرداندن خطای زودهنگام در صورت فراخوانی Put با اندازه نامشخص (Nick
Craig-Wood)
.IP \[bu] 2
تلاش بیشتر برای حذف بارگذاری ناموفق (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن اطلاعات نقطه پایانی (endpoint) مربوط به AP-Northeast برای Wasabi\[aq] (hota)
.IP \[bu] 2
رفع غلط املایی در مستندات s3 (Greg Sadetsky)
.RE
.IP \[bu] 2
Seafile
.RS 2
.IP \[bu] 2
رفع مشکل ماشین حالت پیکربندی 2fa (Fred)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
حذف پیام خطای کاذب در
\f[V]--sftp-disable-concurrent-reads\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Sugarsync
.RS 2
.IP \[bu] 2
رفع مشکل اتصال اولیه پس از بازآرایی پیکربندی (Nick Craig-Wood)
.RE.SS v1.56.0 \- 2021-07-20
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.55.0...v1.56.0)
.IP \[bu] 2
پشتوانه‌های جدید
.RS 2
.IP \[bu] 2
Uptobox (https://rclone.org/uptobox) (buengese)
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
serve docker (https://rclone.org/commands/rclone_serve_docker) (Antoine
GIRARD) (Ivan Andreev)
.RS 2
.IP \[bu] 2
و افزونهٔ همراه docker volume (https://rclone.org/docker)
.RE
.IP \[bu] 2
checksum (https://rclone.org/commands/rclone_checksum) برای بررسی فایل‌ها
در برابر یک فایل چکسام (Ivan Andreev)
.RS 2
.IP \[bu] 2
این قابلیت به صورت \f[V]rclone md5sum -C\f[R] و غیره نیز در دسترس است
.RE
.IP \[bu] 2
config touch (https://rclone.org/commands/rclone_config_touch): اطمینان از
وجود پیکربندی در مکان پیکربندی‌شده (albertony)
.IP \[bu] 2
test
changenotify (https://rclone.org/commands/rclone_test_changenotify):
دستوری برای کمک به اشکال‌زدایی changenotify (Nick Craig-Wood)
.RE
.IP \[bu] 2
قابلیت‌های منسوخ‌شده
.RS 2
.IP \[bu] 2
\f[V]dbhashsum\f[R]: حذف دستوری که از یک سال پیش منسوخ شده بود (Ivan Andreev)
.IP \[bu] 2
\f[V]cache\f[R]: منسوخ کردن پشتوانهٔ cache (Ivan Andreev)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
بازطراحی سامانهٔ پیکربندی به گونه‌ای که بتوان از طریق cli و رابط برنامه‌نویسی
rc به صورت غیرتعاملی از آن استفاده کرد.
.RS 2
.IP \[bu] 2
مستندات را در config
create (https://rclone.org/commands/rclone_config_create) ببینید
.IP \[bu] 2
این یک تغییر بسیار بزرگ برای تمام پشتوانه‌هاست و ممکن است باعث ناسازگاری یا خرابی شود \-
لطفاً باگ‌ها را گزارش کنید!
.RE
.IP \[bu] 2
librclone \- برون‌ریزی RC برنامه rclone به عنوان یک کتابخانهٔ C (lewisxy) (Nick
Craig-Wood)
.RS 2
.IP \[bu] 2
پیوند دادن یک شیء مشترک (shared object) با C-API مربوط به rclone در پروژهٔ خود
.IP \[bu] 2
استفاده از RC به عنوان یک رابط درون‌حافظه‌ای
.IP \[bu] 2
ارائه یک مثال با زبان Python
.IP \[bu] 2
همچنین پشتیبانی از Android و gomobile
.RE
.IP \[bu] 2
fs
.RS 2
.IP \[bu] 2
افزودن \f[V]--disable-http2\f[R] برای غیرفعال‌سازی سراسری http2 (Nick Craig-Wood)
.IP \[bu] 2
اعمال خودکار \f[V]-vv\f[R] هنگام استفاده از \f[V]--dump\f[R] (Alex Chen)
.IP \[bu] 2
استفاده از پیشوندهای دودویی برای واحدهای اندازه و نرخ انتقال (albertony)
.IP \[bu] 2
استفاده از پیشوندهای ده‌دهی برای شمارش‌ها (albertony)
.IP \[bu] 2
افزودن ویجت جستجوی گوگل به rclone.org (Ivan Andreev)
.RE
.IP \[bu] 2
accounting: محاسبهٔ میانگین متحرک سرعت (Haochen Tong)
.IP \[bu] 2
atexit: خروج با وضعیت غیرصفر پس از دریافت سیگنال (Michael
Hanselmann)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
اجرای اسکریپت‌های گردش‌کار مبتنی بر رویداد تنها تحت مخزن rclone به همراه امکان لغو دستی (Mathieu Carbou)
.IP \[bu] 2
افزودن ساخت Android با gomobile (x0b)
.RE
.IP \[bu] 2
check: ثبت هشِ در حال استفاده در گزارش مانند cryptcheck (Nick Craig-Wood)
.IP \[bu] 2
version: چاپ os/version، هسته و ساختار چند بیتی (Ivan Andreev)
.IP \[bu] 2
config
.RS 2
.IP \[bu] 2
جلوگیری از به‌کارگیری نام‌های رزروشدهٔ ویندوز در نام فایل پیکربندی (albertony)
.IP \[bu] 2
ایجاد فایل پیکربندی در پوشهٔ appdata ویندوز به صورت پیش‌فرض (albertony)
.IP \[bu] 2
در نظر گرفتن مسیرهای فایل پیکربندی با نام notfound به عنوان پیکربندی فقط در حافظه (albertony)
.IP \[bu] 2
بارگذاری با‌تأخیر (Delay load) فایل پیکربندی (albertony)
.IP \[bu] 2
جایگزینی defaultConfig با یک پیاده‌سازی درون‌حافظه‌ای امن در برابر ریسه‌ها (Chris
Macklin)
.IP \[bu] 2
امکان دریافت پارامترهای \f[V]key=value\f[R] توسط \f[V]config create\f[R] و دستورات مرتبط (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکلات مربوط به پرچم‌ها/گزینه‌های تنظیم‌شده توسط متغیرهای محیطی.
(Ole Frost)
.RE
.IP \[bu] 2
fshttp: پیاده‌سازی مدیریت خطای مسالمت‌آمیز برای DSCP (Tyson Moore)
.IP \[bu] 2
lib/http \- ارائه انتزاعی برای یک سرور http مرکزی که سرویس‌ها می‌توانند مسیرها را به آن متصل کنند (Nolan Woods)
.RS 2
.IP \[bu] 2
افزودن پیکربندی و پرچم‌های \f[V]--template\f[R] به serve/data (Nolan Woods)
.IP \[bu] 2
افزودن گرداننده پیش‌فرض خطای 404 (Nolan Woods)
.RE
.IP \[bu] 2
link: استفاده از مقدار \[dq]off\[dq] برای تاریخ انقضای تعیین‌نشده (Nick Craig-Wood)
.IP \[bu] 2
oauthutil: ایجاد خطای مهلک در صورت انقضای توکن بدون وجود توکن تازه‌سازی (Alex Chen)
.IP \[bu] 2
rcat: افزودن گزینهٔ \f[V]--size\f[R] برای بارگذاری کارآمدتر فایل‌های با اندازهٔ معلوم (Nazar Mishturak)
.IP \[bu] 2
serve sftp: افزودن پرچم \f[V]--stdio\f[R] برای ارائه از طریق stdio (Tom)
.IP \[bu] 2
sync: عدم نمایش هشدار دربارهٔ \f[V]--no-traverse\f[R] هنگامی که
\f[V]--files-from\f[R] تعیین شده است (Nick Gaya)
.IP \[bu] 2
\f[V]test makefiles\f[R]
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--seed\f[R] و تکرارپذیر کردن داده‌های تولیدشده (Nick
Craig-Wood)
.IP \[bu] 2
افزودن سطوح لاگ و خلاصهٔ سرعت (Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting: رفع مقدار startTime در statsGroups.sum (Haochen Tong)
.IP \[bu] 2
cmd/ncdu: رفع خطای خارج از محدوده (panic) در حذف (buengese)
.IP \[bu] 2
config
.RS 2
.IP \[bu] 2
رفع اشکالات مربوط به مسیرهای فایل پیکربندی فقط در حافظه (albertony)
.IP \[bu] 2
رفع عدم ذخیرهٔ برخط (on the fly) پیکربندی پشتوانه در پیکربندی درون‌حافظه‌ای (Nick
Craig-Wood)
.RE
.IP \[bu] 2
fshttp: رفع اشکال تجزیه آدرس برای DSCP (Tyson Moore)
.IP \[bu] 2
ncdu: به‌روزرسانی کتابخانه termbox-go جهت رفع فروپاشی برنامه (Nick Craig-Wood)
.IP \[bu] 2
oauthutil: رفع عدم شناسایی نتیجهٔ قدیمی authorize (Cnly)
.IP \[bu] 2
operations: عدم به‌روزرسانی برچسب‌های زمانی فایل‌ها در
\f[V]--compare-dest\f[R] (Nick Gaya).IP \[bu] 2
selfupdate: رفع مشکل نام بایگانی در macos (Ivan Andreev)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
بازطراحی کد پیش از افزودن serve docker (Antoine GIRARD)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
افزودن بازنشانی حافظه پنهان برای مدیریت \f[V]--vfs-cache-max-size\f[R] در بازه بررسی حافظه پنهان (Leo Luan)
.IP \[bu] 2
رفع مشکل تغییر modtime هنگام خواندن فایل در حافظه پنهان (Nick Craig-Wood)
.IP \[bu] 2
جلوگیری از ایجاد زیرشاخه غیرضروری در مسیر حافظه پنهان (albertony)
.IP \[bu] 2
رفع مشکل عدم امکان تنظیم گزینه umask به‌عنوان متغیر محیطی (albertony)
.IP \[bu] 2
عدم چاپ اعلان در مورد عدم پشتیبانی از poll-interval هنگامی که روی 0 تنظیم شده است (albertony)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
استفاده همیشگی از readlink برای خواندن اندازه symlink جهت سازگاری بهتر (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--local-unicode-normalization\f[R] (و حذف \f[V]--local-no-unicode-normalization\f[R]) (Nick Craig-Wood)
.IP \[bu] 2
رد شدن از ورودی‌های حذف‌شده به‌طور هم‌روند با ()List (Ivan Andreev)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
پشتیبانی از نام‌فایل‌های دارای برچسب زمانی برگرفته از \f[V]--b2-versions\f[R] (Dominik Mydlil)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
عدم گنجاندن نام bucket در پیشوند پرونده‌های پیوند عمومی (Jeffrey Tolar)
.IP \[bu] 2
رفع مشکل نگارش‌ها و فایل‌های با پیشوند نقطه بدون پسوند (Nick Craig-Wood)
.IP \[bu] 2
انتقال مدیریت نگارش‌ها به lib/version (Dominik Mydlil)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
استفاده از بررسی اولیه بارگذاری جهت جلوگیری از فهرست‌گیری‌ها حین بارگذاری فایل (Nick Craig-Wood)
.IP \[bu] 2
بازگرداندن خطاها به‌جای فراخوانی ()log.Fatal همراه با آن‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
جابه‌جایی به Drives API برای جستجوی درایوهای اشتراکی (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل در نظر گرفته شدن برخی از اسناد Google Docs به‌عنوان فایل معمولی (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
افزودن گزینه \f[V]--dropbox-batch-mode\f[R] جهت سرعت بخشیدن به بارگذاری (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
برای اطلاعات بیشتر مستندات حالت دسته‌ای (https://rclone.org/dropbox/#batch-mode) را مطالعه کنید
.RE
.IP \[bu] 2
تنظیم دید (visibility) در اشتراک‌گذاری پیوند هنگام فعال بودن \f[V]--expire\f[R] (Nick Craig-Wood)
.IP \[bu] 2
ساده‌سازی بارگذاری‌های چندبخشی (Alexey Ivanov)
.IP \[bu] 2
بهبود دستورالعمل‌های \[dq]own App IP\[dq] (Ivan Andreev)
.RE
.IP \[bu] 2
Fichier
.RS 2
.IP \[bu] 2
بررسی دریافت بیش از یک پیوند بارگذاری (Nick Craig-Wood)
.IP \[bu] 2
پشتیبانی از بارگیری فایل‌ها و پوشه‌های محافظت‌شده با گذرواژه (Florian Penzkofer)
.IP \[bu] 2
نمایش مستقیم متن خطای گزارش‌شده از API در پیام‌های خطا (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل جابه‌جایی فایل‌ها درون یک دایرکتوری مشابه (Nick Craig-Wood)
.IP \[bu] 2
بررسی دریافت واقعی توکن بارگیری و تلاش مجدد در صورت دریافت نشدن آن (buengese)
.RE
.IP \[bu] 2
Filefabric
.RS 2
.IP \[bu] 2
رفع مشکل فهرست‌گیری پس از تغییر نوع فیلد from از \[dq]int\[dq] به int. (Nick Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
در نظر گرفتن خطای بارگذاری 250 به‌منزله موفقیت (Nick Craig-Wood)
.RE
.IP \[bu] 2
GCS
.RS 2
.IP \[bu] 2
سازگار کردن با فراداده mtime ابزار gsutil (database64128)
.IP \[bu] 2
پاک‌سازی ثابت‌های قالب زمانی (database64128)
.RE
.IP \[bu] 2
Google Photos
.RS 2
.IP \[bu] 2
رفع مشکل عدم استفاده صحیح از دامنه دسترسی (scope) فقط‌خواندنی (Nick Craig-Wood)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
جایگزینی httplib با lib/http (Nolan Woods)
.IP \[bu] 2
بهینه‌سازی Bind برای استفاده بهتر از میان‌افزارها (Nolan Woods)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
رفع مشکل احراز هویت قدیمی با سیستم پیکربندی مبتنی بر وضعیت (buengese)
.IP \[bu] 2
رفع نشانی url نامعتبر در خروجی دستور link (albertony)
.IP \[bu] 2
افزودن گزینه no versions (buengese)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
افزودن گزینه \f[V]list_chunk\f[R] (Nick Gaya)
.IP \[bu] 2
گزارش خطای اصلی در صورت عدم توانایی در لغو بارگذاری چندبخشی (Cnly)
.IP \[bu] 2
رفع خطای failed to configure: empty token found (Nick Craig-Wood)
.IP \[bu] 2
بازگرداندن پیوند بارگیری مستقیم توسط دستور link (Xuanchen Wu)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن \f[V]--s3-no-head-object\f[R] (Tatsuya Noyori)
.IP \[bu] 2
حذف WebIdentityRoleProvider جهت رفع مشکل فروپاشی برنامه حین احراز هویت (Nick Craig-Wood)
.IP \[bu] 2
عدم بررسی شیء بودن remote در صورت خاتمه یافتن نام آن به / (Nick Craig-Wood)
.IP \[bu] 2
افزودن SeaweedFS (Chris Lu)
.IP \[bu] 2
به‌روزرسانی نقاط پایانی Alibaba OSS (Chuan Zh)
.RE
.IP \[bu] 2
SFTP
.RS 2.IP \[bu] 2
رفع افت کارایی با فعال‌سازی مجدد نوشتن‌های هم‌روند (Nick Craig-Wood)
.IP \[bu] 2
بسط تیلدا (~) و متغیرهای محیطی در \f[V]known_hosts_file\f[R] پیکربندی‌شده (albertony)
.RE
.IP \[bu] 2
Tardigrade
.RS 2
.IP \[bu] 2
ارتقا به uplink نسخهٔ v1.4.6 (Caleb Case)
.IP \[bu] 2
استفاده از آفست منفی (Caleb Case)
.IP \[bu] 2
افزودن هشدار دربارهٔ \f[V]too many open files\f[R] (acsfer)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
رفع مشکل احراز هویت sharepoint روی http (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینهٔ headers (Antoon Prins)
.RE
.SS v1.55.1 \- 2021-04-26
.PP
مشاهدهٔ کامیت‌ها (https://github.com/rclone/rclone/compare/v1.55.0...v1.55.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
selfupdate
.RS 2
.IP \[bu] 2
عدم تشخیص FUSE در صورت ایستا (static) بودن ساخت (Ivan Andreev)
.IP \[bu] 2
افزودن تگ ساخت noselfupdate (Ivan Andreev)
.RE
.IP \[bu] 2
sync: رفع خطای نادرست گزارش‌شده توسط graceful cutoff (Nick Craig-Wood)
.IP \[bu] 2
install.sh: رفع مشکل دانلود macOS arm64 (Nick Craig-Wood)
.IP \[bu] 2
build: تصحیح شماره‌های نسخه در ساخت‌های شاخهٔ android (Nick Craig-Wood)
.IP \[bu] 2
مستندات (docs)
.RS 2
.IP \[bu] 2
Contributing.md: به‌روزرسانی دستورالعمل‌های راه‌اندازی برای go1.16 (Nick Gaya)
.IP \[bu] 2
خروج WinFsp 2021 از نسخهٔ آزمایشی (بتا) (albertony)
.IP \[bu] 2
پاک‌سازی جزئی فاصله‌های اطراف بخش کد (albertony)
.IP \[bu] 2
رفع برخی غلط‌های املایی (albertony)
.RE
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع مسیری در کد که به داده‌های تغییریافته (dirty data) اجازهٔ حذف شدن می‌داد و منجر به از دست رفتن داده‌ها می‌شد (Nick Craig-Wood)
.RE
.IP \[bu] 2
Compress
.RS 2
.IP \[bu] 2
اصلاح عبارت منظم (regexp) نام فشرده‌شده (buengese)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
رفع اشکال copyid مربوط به backend هنگام کپی google doc به دایرکتوری (Nick Craig-Wood)
.IP \[bu] 2
عدم باز کردن مرورگر در هنگام استفاده از service account...
(Ansh Mittal)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
افزودن دامنهٔ (scope) ناموجود team_data.member برای استفاده با \-\-impersonate (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل About پس از تغییر دامنه‌ها \- نیاز به اجرای مجدد rclone config reconnect (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای Unable to decrypt returned paths از changeNotify (Nick Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
اصلاح TLS ضمنی (Ivan Andreev)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
راهکار دورزدن برای خطاهای تصادفی \[dq]Unable to initialize RPS\[dq]
(OleFrost)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
بازگردانی کتابخانهٔ sftp از v1.13.0 به v1.12.0 جهت رفع افت کارایی (Nick Craig-Wood)
.IP \[bu] 2
رفع خطاهای Update ReadFrom failed: failed to send packet: EOF (Nick Craig-Wood)
.RE
.IP \[bu] 2
Zoho
.RS 2
.IP \[bu] 2
رفع خطا در زمانی که region تنظیم نشده است (buengese)
.IP \[bu] 2
عدم درخواست دوبارهٔ mountpoint هنگام استفاده از راه‌اندازی بدون سر (headless) (buengese)
.RE.SS v1.55.0 - 2021-03-31
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.54.0...v1.55.0)
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
selfupdate (https://rclone.org/commands/rclone_selfupdate) (Ivan
Andreev)
.RS 2
.IP \[bu] 2
به rclone اجازه می‌دهد تا خود را به‌صورت درجا یا از طریق بسته (با استفاده
از پرچم \f[V]--package\f[R]) به‌روزرسانی کند
.IP \[bu] 2
خواندن امضاهای دیجیتال رمزنگاری‌شده برای نسخه‌های غیر بتا
.IP \[bu] 2
روی تمام سیستم‌عامل‌ها کار می‌کند.
.RE
.IP \[bu] 2
test (https://rclone.org/commands/rclone_test) \- این‌ها دستورهای آزمایشی
هستند \- با احتیاط استفاده کنید!
.RS 2
.IP \[bu] 2
\f[V]histogram\f[R] \- تهیه هیستوگرام از نویسه‌های نام فایل.
.IP \[bu] 2
\f[V]info\f[R] \- شناسایی نام فایل یا سایر محدودیت‌ها برای مسیرها.
.IP \[bu] 2
\f[V]makefiles\f[R] \- ایجاد ساختار سلسله‌مراتبی تصادفی از فایل‌ها برای آزمایش.
.IP \[bu] 2
\f[V]memory\f[R] \- بارگذاری تمام اشیا در remote:path درون حافظه و
گزارش آمار حافظه.
.RE
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
رشته‌های اتصال (https://rclone.org/docs/#connection-strings)
.RS 2
.IP \[bu] 2
پارامترهای پیکربندی اکنون می‌توانند به‌عنوان بخشی از نام ریموت در قالب
رشته اتصال ارسال شوند.
.IP \[bu] 2
برای نمونه، جهت انجام معادل \f[V]--drive-shared-with-me\f[R]
از \f[V]drive,shared_with_me:\f[R] استفاده کنید
.IP \[bu] 2
اطمینان از اینکه پیکربندی بلادرنگ ریموت در فایل پیکربندی ذخیره نشود
(Nick Craig-Wood)
.IP \[bu] 2
اطمینان از اینکه backendهای دارای پیکربندی تکمیلی نام متفاوتی برای کش
داشته باشند (Nick Craig-Wood)
.IP \[bu] 2
این کار با حمایت مالی CERN، از طریق پروژه CS3MESH4EOSC
انجام شد (https://cs3mesh4eosc.eu).
.RS 2
.IP \[bu] 2
پروژه CS3MESH4EOSC از برنامه پژوهش و نوآوری افق ۲۰۲۰
.IP \[bu] 2
اتحادیه اروپا تحت توافق‌نامه کمک مالی شماره
۸۶۳۳۵۳ بودجه دریافت کرده است.
.RE
.RE
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
به‌روزرسانی نسخه ساخت go به go1.16 و افزایش حداقل نسخه go به go1.13
(Nick Craig-Wood)
.IP \[bu] 2
ایجاد بیلد macOS ARM64 برای پشتیبانی از Apple Silicon (Nick Craig-Wood)
.IP \[bu] 2
نصب macfuse 4.x به‌جای osxfuse 3.x (Nick Craig-Wood)
.IP \[bu] 2
استفاده از \f[V]GO386=softfloat\f[R] به‌جای \f[V]GO386=387\f[R]
منسوخ‌شده برای بیلدهای 386 (Nick Craig-Wood)
.IP \[bu] 2
غیرفعال کردن موقت بیلدهای IOS (Nick Craig-Wood)
.IP \[bu] 2
ساخته شدن بیلدهای Android با NDK به‌روز (x0b)
.IP \[bu] 2
افزودن کاربر rclone به ایمیج Docker، ولی بدون استفاده پیش‌فرض از آن
(cynthia kwok)
.RE
.IP \[bu] 2
dedupe: تبدیل بزرگ‌ترین دایرکتوری به اصلی برای به حداقل رساندن داده جابه‌جاشده (Saksham
Khanna)
.IP \[bu] 2
config
.RS 2
.IP \[bu] 2
قرار دادن کتابخانه config درون یک رابط (interface) (Fionera)
.IP \[bu] 2
پلاگین‌پذیر کردن سیستم فایل پیکربندی (Nick Craig-Wood)
.IP \[bu] 2
استفاده از \f[V]--config \[dq]\[dq]\f[R] یا \f[V]\[dq]/notfound\[dq]\f[R] فقط برای پیکربندی
درون حافظه (Nick Craig-Wood)
.IP \[bu] 2
پاکسازی ورودی‌های بی‌استفاده در کش fs هنگام تغییر پیکربندی (Nick Craig-Wood)
.RE
.IP \[bu] 2
copyurl: افزودن گزینه‌ای برای چاپ نام فایل خودکار تولیدشده (albertony)
.IP \[bu] 2
delete: وادار کردن \f[V]--rmdirs\f[R] به پیروی از فیلترها (Nick Craig-Wood)
.IP \[bu] 2
docs \- اصلاحات و بازنگری‌های متعدد از سوی edwardxml، albertony، pvalls، Ivan
Andreev، Evan Harris، buengese، Alexey Tabakman
.IP \[bu] 2
encoder/filename \- افزودن SCSU به‌صورت جدول (Klaus Post)
.IP \[bu] 2
افزودن پشتیبانی از چند مسیر به پرچم‌های \f[V]--compare-dest\f[R] و
\f[V]--copy-dest\f[R] (K265)
.IP \[bu] 2
filter: معادل ساختن \f[V]--exclude \[dq]dir/\[dq]\f[R] با
\f[V]--exclude \[dq]dir/**\[dq]\f[R] (Nick Craig-Wood)
.IP \[bu] 2
fshttp: افزودن پشتیبانی از DSCP با پرچم \f[V]--dscp\f[R] برای QoS با
خدمات تفکیک‌شده (differentiated services) (Max Sum)
.IP \[bu] 2
lib/cache: افزودن متدهای Delete و DeletePrefix (Nick Craig-Wood)
.IP \[bu] 2
lib/file
.RS 2
.IP \[bu] 2
تشخیص خطاهای پر بودن دیسک در پیش‌تخصیص (pre-allocate) و بازگرداندن آن‌ها (Nick
Craig-Wood)
.IP \[bu] 2
اجرا نشدن هم‌روند preallocate (Nick Craig-Wood)
.IP \[bu] 2
تلاش مجدد preallocate هنگام وقوع EINTR (Nick Craig-Wood)
.RE
.IP \[bu] 2
operations: پیروی عملیات‌های copy و sync از یک RetryAfterError (Ankur
Gupta)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن جایگزین‌های رشته‌ای برای تنظیم گزینه‌ها از طریق rc (Nick
Craig-Wood)
.IP \[bu] 2
افزودن \f[V]options/local\f[R] برای مشاهده گزینه‌های پیکربندی‌شده در context
(Nick Craig-Wood)
.IP \[bu] 2
افزودن پارامتر \f[V]_config\f[R] برای تنظیم پیکربندی سراسری فقط برای این فراخوانی
rc (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی ارسال پیکربندی فیلتر با پارامتر \f[V]_filter\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
افزودن \f[V]fscache/clear\f[R] و \f[V]fscache/entries\f[R] برای کنترل
کش fs (Nick Craig-Wood)
.IP \[bu] 2
اجتناب از مقدار +Inf برای سرعت در \f[V]core/stats\f[R] (albertony)
.IP \[bu] 2
افزودن مجموعه کاملی از آمارها به \f[V]core/stats\f[R] (Nick Craig-Wood)
.IP \[bu] 2
مجاز بودن پارامترهای \f[V]fs=\f[R] به‌صورت یک JSON blob (Nick Craig-Wood)
.RE
.IP \[bu] 2
rcd: افزودن اعلان systemd در هنگام اجرای دستور \f[V]rclone rcd\f[R].
(Naveen Honest Raj)
.IP \[bu] 2
rmdirs: وادار کردن \f[V]--rmdirs\f[R] به پیروی از فیلترها (Nick Craig-Wood)
.IP \[bu] 2
version: نمایش تگ‌های ساخت و نوع فایل اجرایی (Ivan Andreev)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
install.sh: خروج با خطا در هنگام بروز خطاهای بارگیری (Ivan Andreev)
.IP \[bu] 2
رفع مشکل تلاش‌های مجدد بیش از حد که مهلت زمانی \f[V]--max-duration\f[R] را از دست می‌داد (Nick
Craig-Wood)
.IP \[bu] 2
رفع خرابی (crash) هنگام استفاده از \f[V]--low-level-retries=0\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع شکست در تازه‌سازی توکن برای mountهای ایجادشده از طریق rc (Nick Craig-Wood)
.IP \[bu] 2
fshttp: رفع محدودسازی پهنای باند پس از یک ادغام نامناسب (Nick Craig-Wood)
.RE.IP \[bu] 2
lib/atexit
.RS 2
.IP \[bu] 2
لغو ثبت گرداننده وقفه پس از اجرا، تا کاربران بتوانند دوباره وقفه ایجاد کنند (Nick Craig-Wood)
.IP \[bu] 2
رفع شکست گاه‌به‌گاه در پیاده کردن (unmount) با CTRL-C (Nick Craig-Wood)
.IP \[bu] 2
رفع بن‌بست (deadlock) هنگام فراخوانی Finalise در حین اجرای Run (Nick Craig-Wood)
.RE
.IP \[bu] 2
lib/rest: رفع مشکل متوقف نشدن بارگذاری‌های چندبخشی (multipart) هنگام لغو context (Nick Craig-Wood)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
امکان سوار کردن (mount) روی دایرکتوری ریشه در windows (albertony)
.IP \[bu] 2
بهبود مدیریت مسیرهای نسبی در windows (albertony)
.IP \[bu] 2
رفع مشکلات یونیکد مربوط به نویسه‌های آکسان‌دار در macOS (Nick Craig-Wood)
.IP \[bu] 2
مستندات: مستندسازی گزینه جدید FileSecurity در WinFsp 2021 (albertony)
.IP \[bu] 2
مستندات: افزودن یادداشتی درباره ساختار مسیر حجم (volume path syntax) در windows (albertony)
.IP \[bu] 2
رفع مشکل حافظه موقت (caching) دایرکتوری‌های قدیمی پس از تغییر نام آن‌ها (Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی cgofuse به آخرین نسخه جهت اعمال رفع اشکال مربوط به macfuse 4 (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
\f[V]--vfs-used-is-size\f[R] برای گزارش فضای استفاده‌شده با استفاده از پویش بازگشتی (tYYGH)
.IP \[bu] 2
عدم تنظیم زمان تغییر (modification time) در صورت درست بودن آن از قبل (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال Create که باعث ناقص شدن فایل‌ها توسط windows explorer در حین CTRL-C CTRL-V می‌شد (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل به‌روزرسانی نشدن modtime هنگام نوشتن از طریق حافظه نهان (cache) (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل تغییر مقادیر اعشاری ثانیه در modtime پس از بارگذاری (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل تنظیم modtime هنگام استفاده از \f[V]--vfs-cache-mode writes\f[R]/\f[V]full\f[R] بدون انجام نوشتن (Nick Craig-Wood)
.IP \[bu] 2
تغییر نام فایل‌ها در حافظه نهان و لغو بارگذاری‌ها هنگام تغییر نام دایرکتوری (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل تغییر نام دایرکتوری از طریق تغییر نام دایرکتوری‌های ذخیره‌شده در حافظه (Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--local-no-preallocate\f[R] (David Sze)
.IP \[bu] 2
تبدیل \f[V]nounc\f[R] به گزینه‌ای پیشرفته به جز در Windows (albertony)
.IP \[bu] 2
عدم نادیده‌گرفتن خطاهای پر بودن دیسک هنگام پیش‌تخصیص فضا (preallocate) (Nick Craig-Wood)
.RE
.IP \[bu] 2
Cache
.RS 2
.IP \[bu] 2
افزودن \f[V]--fs-cache-expire-duration\f[R] برای کنترل حافظه نهان فایل‌سیستم (Nick Craig-Wood)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
افزودن گزینه‌ای برای عدم رمزگذاری داده‌ها (Vesnyx)
.IP \[bu] 2
ثبت وضعیت موفقیت هش در گزارش لاگ هنگام بارگذاری (albertony)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از سطح دسترسی عمومی مخزن (container). (Manish Kumar)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
رفع مشکل دانلود فایل‌های HTML از طریق cloudflare (Nick Craig-Wood)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
رفع مشکل متوقف ماندن انتقال‌ها هنگام منقضی شدن توکن پس از تغییر API (Nick Craig-Wood)
.RE
.IP \[bu] 2
Chunker
.RS 2
.IP \[bu] 2
پیاده‌سازی جزئی تراکنش‌های بدون تغییر نام (no-rename transactions) (Maxwell Calman)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
عدم توقف رونوشت سمت سرور در صورت عدم امکان خواندن توضیحات (Nick Craig-Wood)
.IP \[bu] 2
ارسال context به SDK درایو - جهت کمک به فرایند لغو عملیات (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از پایش دوره‌ای (polling) برای تغییرات (Robert Thomas)
.IP \[bu] 2
کارکرد صحیح \f[V]--timeout 0\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزایش سطح اولویت پیام محدودیت نرخ (rate limited) به INFO جهت جلب توجه بیشتر (Nick Craig-Wood)
.RE
.IP \[bu] 2
Fichier
.RS 2
.IP \[bu] 2
پیاده‌سازی copy و move (buengese)
.IP \[bu] 2
پیاده‌سازی پیوند عمومی (buengese)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
پیاده‌سازی متد Shutdown (Nick Craig-Wood)
.IP \[bu] 2
بستن اتصالات بیکار پس از \f[V]--ftp-idle-timeout\f[R] (به‌طور پیش‌فرض ۱ دقیقه) (Nick Craig-Wood)
.IP \[bu] 2
کارکرد صحیح \f[V]--timeout 0\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن پرچم \f[V]--ftp-close-timeout\f[R] جهت استفاده برای سرورهای ftp ناسازگار (Nick Craig-Wood)
.IP \[bu] 2
تلاش مجدد برای برقراری اتصال و ورود در صورت بروز خطای 421 (Nick Craig-Wood)
.RE
.IP \[bu] 2
Hdfs
.RS 2
.IP \[bu] 2
رفع مشکل مجوزها هنگام ایجاد دایرکتوری (Lucas Messenger)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
کارکرد صحیح \f[V]--timeout 0\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع اشکال \f[V]--s3-profile\f[R] که کار نمی‌کرد (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
بستن اتصالات بیکار پس از \f[V]--sftp-idle-timeout\f[R] (به‌طور پیش‌فرض ۱ دقیقه) (Nick Craig-Wood).IP \[bu] 2
رفع خطاهای \[dq]file not found\[dq] برای سرورهای با یک‌بار خواندن (Nick
Craig-Wood)
.IP \[bu] 2
رفع SetModTime stat failed: object not found با
\f[V]--sftp-set-modtime=false\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
به‌روزرسانی github.com/ncw/swift به v2.0.0 (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی کپی کردن اشیاء بزرگ (nguyenhuuluan434)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
رفع فروپاشی هنگام استفاده از سیاست epff (Nick Craig-Wood)
.IP \[bu] 2
رفع تلاش union برای به‌روزرسانی فایل‌ها روی سامانه فایل فقط‌خواندنی (Nick
Craig-Wood)
.IP \[bu] 2
بازسازی کد برای استفاده از fspath.SplitFs به‌جای fs.ParseRemote (Nick
Craig-Wood)
.IP \[bu] 2
رفع مقداردهی اولیه که در بازسازی کد شکسته شده بود (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از sharepoint با احراز هویت NTLM (Rauno Ots)
.IP \[bu] 2
سازگارتر کردن مستندات sharepoint-ntlm (Alex Chen)
.IP \[bu] 2
بهبود اصطلاحات در مستندات sharepoint-ntlm (Ivan Andreev)
.IP \[bu] 2
غیرفعال‌سازی HTTP/2 برای احراز هویت NTLM (georne)
.IP \[bu] 2
رفع خطای 401 در sharepoint-ntlm برای عملیات هم‌روند (Ivan Andreev)
.IP \[bu] 2
بررسی اینکه دایرکتوری پاک‌سازی‌شده واقعاً وجود داشته باشد (Ivan Andreev)
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
عملکرد صحیح \f[V]--timeout 0\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Zoho
.RS 2
.IP \[bu] 2
جایگزینی شناسه کلاینت \- پس از این باید \f[V]rclone config reconnect\f[R]
را اجرا کنید (buengese)
.IP \[bu] 2
افزودن setupRegion() فراموش‌شده به NewFs \- این در نهایت مناطق دیگر به‌جز
EU را اصلاح می‌کند (buengese)
.RE
.SS v1.54.1 - 2021-03-08
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.54.0...v1.54.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting: رفع مشکل --bwlimit هنگامی که up یا down خاموش است (Nick Craig-Wood)
.IP \[bu] 2
مستندات
.RS 2
.IP \[bu] 2
رفع تودرتویی قلاب‌ها و بک‌تیک‌ها در مستندات ftp (edwardxml)
.IP \[bu] 2
رفع پیوند خراب در صفحه sftp (edwardxml)
.IP \[bu] 2
رفع غلط املایی در crypt.md (Romeo Kienzler)
.IP \[bu] 2
Changelog: تصحیح پیوند به digitalis.io (Alex JOST)
.IP \[bu] 2
جایگزینی #file-caching با #vfs-file-caching (Miron Veryanskiy)
.IP \[bu] 2
تبدیل پیوند ساختگی مثال به کد (edwardxml)
.IP \[bu] 2
حذف پیوند مرده از rc.md (edwardxml)
.RE
.IP \[bu] 2
rc: Sync,copy,move: مستندسازی پارامتر createEmptySrcDirs (Nick
Craig-Wood)
.IP \[bu] 2
lsjson: رفع JSON پایان‌نیافته در صورت بروز خطا (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
رفع قطع شدن mount در macOS با تنظیم --daemon-timeout 10m (Nick
Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
مستندسازی اینکه نباید از حافظه پنهان یکسان به‌صورت هم‌زمان استفاده شود
(Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
افزایش خودکار آستانه قطع بارگذاری جهت جلوگیری از خطای کاذب (Nick
Craig-Wood)
.IP \[bu] 2
رفع خطای عدم موفقیت در ایجاد سامانه فایل با کلید برنامه محدود به یک
پیشوند (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
ارجاع به Shared Drives به‌جای Team Drives (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
افزودن دامنه‌ها به درخواست oauth و به طور اختیاری \[dq]members.read\[dq] (Nick
Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع خطای عدم موفقیت در ایجاد سامانه فایل با سیاست مجوزهای سطح پوشه
(Nick Craig-Wood)
.IP \[bu] 2
رفع بازگرداندن داده‌های کهنه در درخواست‌های Wasabi HEAD تنها با استفاده از ۱ حامل ترابرد
(Nick Craig-Wood)
.IP \[bu] 2
رفع احراز هویت shared_credentials_file (Dmitry Chepurovskiy)
.IP \[bu] 2
افزودن --s3-no-head به مستندات کاهش هزینه‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
رفع mkdir در ریشه با remote:/ (Nick Craig-Wood)
.RE
.IP \[bu] 2
Zoho
.RS 2
.IP \[bu] 2
رفع شناسه‌های کلاینت سفارشی (buengese)
.RE.SS v1.54.0 \- 2021-02-02
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.53.0...v1.54.0)
.IP \[bu] 2
پشت‌بندهای جدید
.RS 2
.IP \[bu] 2
ریموت فشرده‌سازی (آزمایشی) (buengese)
.IP \[bu] 2
Enterprise File Fabric (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
حمایت مالی این کار توسط Storage Made
Easy (https://storagemadeeasy.com) انجام شد
.RE
.IP \[bu] 2
HDFS (سامانه پرونده توزیع‌شده هادوپ) (Yury Stankevich)
.IP \[bu] 2
Zoho workdrive (buengese)
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
خارج کردن پیکربندی از حالت سراسری (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
اکنون پیکربندی سراسری از context خوانده می‌شود
.IP \[bu] 2
این امر امکان ارسال پیکربندی سراسری را از طریق rc فراهم می‌کند
.IP \[bu] 2
حمایت مالی این کار توسط Digitalis (https://digitalis.io) انجام شد
.RE
.IP \[bu] 2
افزودن \f[V]--bwlimit\f[R] برای بارگذاری و بارگیری (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
پیروی از bwlimit در http Transport برای اعمال محدودیت بهتر
.RE
.IP \[bu] 2
بهبود یکپارچه‌سازی با systemd (Hekmon)
.RS 2
.IP \[bu] 2
تشخیص سطح لاگ، فعال‌سازی دستی با پرچم، و تشخیص خودکار راه‌اندازی توسط systemd
.IP \[bu] 2
عدم کامپایل یکپارچه‌سازی لاگ systemd برای سیستم‌های غیر یونیکسی (Benjamin
Gustin)
.RE
.IP \[bu] 2
افزودن پرچم \f[V]--download\f[R] به md5sum/sha1sum/hashsum جهت اجبار rclone
به دانلود و هش کردن محلی فایل‌ها (lostheli)
.IP \[bu] 2
افزودن \f[V]--progress-terminal-title\f[R] برای چاپ زمان تقریبی پایان در عنوان ترمینال
(LaSombra)
.IP \[bu] 2
نمایش متغیرهای محیطی backend در راهنما به عنوان مقادیر پیش‌فرض گزینه‌های backend
(Nick Craig-Wood)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
ارتقای حداقل نسخه go به go1.12 (Nick Craig-Wood)
.RE
.IP \[bu] 2
dedupe
.RS 2
.IP \[bu] 2
افزودن \f[V]--by-hash\f[R] برای رفع تکرار بر اساس هش محتوا نه نام فایل (Nick
Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--dedupe-mode list\f[R] تنها برای فهرست کردن موارد تکراری بدون ایجاد تغییر
(Nick Craig-Wood)
.IP \[bu] 2
افزودن هشدار در صورت استفاده روی ریموتی که امکان داشتن نام‌های تکراری را ندارد
(Nick Craig-Wood)
.RE
.IP \[bu] 2
fs
.RS 2
.IP \[bu] 2
افزودن متد اختیاری Shutdown برای backendها (Nick Craig-Wood)
.IP \[bu] 2
بررسی هم‌روند فایل‌ها هنگام استفاده از \f[V]--files-from\f[R] (zhucan)
.IP \[bu] 2
تجمع آمار هنگام استفاده از \f[V]--dry-run\f[R] (Ingo Weiss)
.IP \[bu] 2
نمایش همیشگی آمار هنگام استفاده از \f[V]--dry-run\f[R] یا
\f[V]--interactive\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی از پرچم \f[V]--no-console\f[R] در ویندوز جهت پنهان کردن پنجره
کنسول (albertony)
.RE
.IP \[bu] 2
genautocomplete: افزودن پشتیبانی از خروجی دادن به stdout (Ingo)
.IP \[bu] 2
ncdu
.RS 2
.IP \[bu] 2
برجسته‌سازی خطاهای خواندن به جای لغو عملیات (Claudio Bantaloukas)
.IP \[bu] 2
افزودن مرتب‌سازی بر اساس میانگین اندازه در دایرکتوری (Adam Plánský)
.IP \[bu] 2
افزودن گزینه تغییر وضعیت برای میانگین اندازه در دایرکتوری \- کلید \[aq]a\[aq] (Adam
Plánský)
.IP \[bu] 2
افزودن پرچم پوشه خالی در مرورگر ncdu (Adam Plánský)
.IP \[bu] 2
افزودن پرچم‌های پرونده \f[V]!\f[R] (خطا) و \f[V].\f[R] (غیرقابل خواندن) در کنار
\f[V]e\f[R] (خالی) (Nick Craig-Wood)
.RE
.IP \[bu] 2
obscure: نادیده گرفتن نویسه خط جدید در انتهای خط توسط \f[V]rclone obscure -\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
operations
.RS 2
.IP \[bu] 2
افزودن ثبت لاگ هنگام نیاز به آپلود فایل‌ها برای تنظیم زمان تغییرات (Nick Craig-Wood)
.IP \[bu] 2
ثبت نام شیء مقصد در لاگ در حالت پرگو برای move و copy (Adam
Plánský)
.IP \[bu] 2
افزودن اندازه در صورت مشخص بودن به موارد ردشده و لاگ JSON (Nick Craig-Wood)
.RE
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
ترجیح دادن نشانی واقعی شنونده در صورت استفاده تنها از \[dq]:port\[dq] یا
\[dq]addr:0\[dq] (Nick Craig-Wood)
.IP \[bu] 2
افزودن شنونده برای کارهای پایان‌یافته (Aleksandar Jankovic)
.RE
.IP \[bu] 2
serve ftp: افزودن گزینه‌هایی برای فعال‌سازی TLS (Deepak Sah)
.IP \[bu] 2
serve http/webdav: بازمسیردهی درخواست‌ها به url پایه بدون / (Nick
Craig-Wood)
.IP \[bu] 2
serve restic: پیاده‌سازی حافظه پنهان اشیاء (object cache) (Nick Craig-Wood)
.IP \[bu] 2
stats: افزودن شمارنده برای پوشه‌های حذف‌شده (Nick Craig-Wood)
.IP \[bu] 2
sync: چاپ عبارت \[dq]There was nothing to transfer\[dq] تنها در صورت عدم وجود خطا
(Nick Craig-Wood)
.IP \[bu] 2
webui
.RS 2
.IP \[bu] 2
پیام به کاربر برای به‌روزرسانی webui در صورت در دسترس بودن به‌روزرسانی (Chaitanya
Bankanhal)
.IP \[bu] 2
رفع مشکل مقداردهی اولیه پلاگین‌ها (negative0)
.RE
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
fs
.RS 2
.IP \[bu] 2
رفع خطای اشاره‌گر تهی (nil pointer) در عملیات کپی و انتقال مستقیم به ریموت (Anagh
Kumar Baranwal)
.IP \[bu] 2
رفع خطای تجزیه ..
هنگام اتصال ریموت‌ها به یکدیگر (Nick Craig-Wood)
.RE
.IP \[bu] 2
log: رفع فعال‌سازی لاگ‌گیری systemd هنگام استفاده از \f[V]--log-file\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
check
.RS 2
.IP \[bu] 2
همگام‌سازی تعداد خطاها در پیام لاگ (Nick Craig-Wood)
.RE
.IP \[bu] 2
move: رفع مشکل از بین رفتن داده‌ها هنگامی که مبدأ و مقصد شیء یکسانی هستند
(Nick Craig-Wood).IP \[bu] 2
operations
.RS 2
.IP \[bu] 2
رفع مشکل قطع نشدن فوری در \f[V]--cutoff-mode\f[R] hard (Nick Craig-Wood)
.IP \[bu] 2
اصلاح پیام خطای \f[V]--immutable\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
sync
.RS 2
.IP \[bu] 2
اصلاح حالت‌های soft و cautious در \f[V]--cutoff-mode\f[R] برای جلوگیری از پایان زودهنگام انتقال (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل تلاش‌های مجدد مکرر در خطاهای \f[V]--immutable\f[R] (Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
مستندات (Docs)
.RS 2
.IP \[bu] 2
اصلاحات متعدد و بازنویسی مستندات فیلتر کردن (edwardxml)
.IP \[bu] 2
اصلاحات نگارشی و دستوری فراوان (Josh Soref)
.IP \[bu] 2
اصلاح مستندات دستورهای delete، purge، rmdir، rmdirs و mount (albertony)
.IP \[bu] 2
و تشکر از این افراد برای اصلاحات بسیار زیادی در مستندات که در این فهرست نمی‌گنجد
.RS 2
.IP \[bu] 2
Ameer Dawood, Antoine GIRARD, Bob Bagwill, Christopher Stewart
.IP \[bu] 2
CokeMine, David, Dov Murik, Durval Menezes, Evan Harris, gtorelly
.IP \[bu] 2
Ilyess Bachiri, Janne Johansson, Kerry Su, Marcin Zelent,
.IP \[bu] 2
Martin Michlmayr, Milly, Sơn Trần-Nguyễn
.RE
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
به‌روزرسانی وضعیت systemd با آمارهای حافظه نهان (Hekmon)
.IP \[bu] 2
غیرفعال‌سازی سوار کردن مبتنی بر bazil/fuse در macOS (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
اجرای واقعی \f[V]rclone cmount\f[R] توسط \f[V]rclone mount\f[R] در macOS (Nick Craig-Wood)
.RE
.IP \[bu] 2
پیاده‌سازی mknod جهت کارکرد ایجاد فایل در NFS (Nick Craig-Wood)
.IP \[bu] 2
اطمینان از فراخوانی نشدن umount بیش از یک بار (Nick Craig-Wood)
.IP \[bu] 2
سوار کردن کاربرپسندتر به عنوان درایو شبکه در windows (albertony)
.IP \[bu] 2
تشخیص تنظیم شدن uid یا gid در رشته گزینه یکسان: -o uid=123,gid=456 (albertony)
.IP \[bu] 2
عدم تلاش برای پیاده کردن (unmount) در صورتی که fs از قبل تخریب شده باشد (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع مشکل مدخل‌های مجازی که باعث باقی ماندن نمایش فایل‌های حذف‌شده می‌شدند (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای \[dq]file already exists\[dq] برای فایل‌های کهنه حافظه نهان (Nick Craig-Wood)
.IP \[bu] 2
رفع نشت فایل با \f[V]--vfs-cache-mode\f[R] full و \f[V]--buffer-size 0\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل مسیر نامعتبر حافظه نهان در windows هنگام استفاده از :backend: به عنوان دوردست (remote) (albertony)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
ادامه فهرست‌بندی فایل‌ها/پوشه‌ها هنگام شناسایی پیوند نمادین حلقوی (Manish Gupta)
.IP \[bu] 2
پرچم جدید \f[V]--local-zero-size-links\f[R] برای رفع مشکل همگام‌سازی در برخی سامانه‌های فایل مجازی (Riccardo Iaconelli)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از service principals (James Lim)
.IP \[bu] 2
افزودن پشتیبانی از managed identities (Brad Ackerman)
.IP \[bu] 2
افزودن مثال‌هایی برای لایه دسترسی (access tier) (Bob Pusateri)
.IP \[bu] 2
بهره‌گیری از قابلیت‌های جریان داده (streaming) موجود در SDK برای بارگذاری‌های چندبخشی (Denis Neuling)
.IP \[bu] 2
رفع مشکل تنظیم انواع MIME (Nick Craig-Wood)
.IP \[bu] 2
رفع خرابی هنگام فهرست‌بندی خارج از ریشه یک SAS URL (Nick Craig-Wood)
.IP \[bu] 2
حذف blobهای لایه archive پیش از به‌روزرسانی در صورت فعال بودن \f[V]--azureblob-archive-tier-delete\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع خرابی هنگام راه‌اندازی (Nick Craig-Wood)
.IP \[bu] 2
اصلاح مصرف حافظه با ارتقای SDK به نسخه v0.13.0 و پیاده‌سازی یک TransferManager (Nick Craig-Wood)
.IP \[bu] 2
نیاز به go1.14+ برای کامپایل به دلیل تغییرات در SDK (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
استفاده NewObject از فراخوانی‌های کم‌هزینه‌تر API (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
این امر به‌ویژه کارایی \f[V]--files-from\f[R] و \f[V]restic serve\f[R] را بهبود خواهد داد
.RE
.IP \[bu] 2
رفع مشکل خرابی در صورت وجود نام فایل خالی (lluuaapp)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
رفع مشکل NewObject برای فایل‌هایی که در بزرگی و کوچکی حروف با هم تفاوت دارند (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل یافتن دایرکتوری‌ها بدون حساسیت به بزرگی و کوچکی حروف (Nick Craig-Wood)
.RE
.IP \[bu] 2
Chunker
.RS 2
.IP \[bu] 2
صرف‌نظر از درهم‌سازی طولانی محلی و محاسبه هش در حال انتقال (اصلاحات) (Ivan Andreev)
.IP \[bu] 2
تنظیم ویژگی‌های ReadMimeType روی مقدار false به دلیل پشتیبانی نشدن Object.MimeType (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل عدم حساسیت به بزرگی و کوچکی حروف در NewObject، آزمون تشخیص فراداده (Ivan Andreev)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
پیاده‌سازی دستور \f[V]rclone backend copyid\f[R] برای رونوشت‌برداری از فایل‌ها بر اساس شناسه (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینه \f[V]--drive-stop-on-download-limit\f[R] جهت متوقف ساختن انتقال‌ها هنگام فراتر رفتن از حد مجاز بارگیری (Anagh Kumar Baranwal)
.IP \[bu] 2
پیاده‌سازی راه‌حل CleanUp برای team drives (buengese)
.IP \[bu] 2
امکان تلاش مجدد برای تفکیک و ایجاد میان‌برها (Nick Craig-Wood)
.IP \[bu] 2
ثبت این پیام در گزارش که خالی کردن سطل زباله ممکن است مدتی زمان ببرد (Nick Craig-Wood)
.IP \[bu] 2
افزودن شمایل‌های اداری xdg به فایل‌های دسکتاپ xdg (Pau Rodriguez-Estivill)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از مشاهده فایل‌ها و پوشه‌های اشتراک‌گذاری‌شده (buengese)
.IP \[bu] 2
فعال‌سازی توکن‌های دسترسی با طول عمر کوتاه (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی IDer روی شیءها (Objects) تا دستوراتی مانند \f[V]rclone lsf\f[R] بتوانند شناسه‌ها را بخوانند (buengese).IP \[bu] 2
تنظیم Features ReadMimeType روی false به‌دلیل عدم پشتیبانی از Object.MimeType
(Nick Craig-Wood)
.IP \[bu] 2
غیرقابل‌تلاش مجدد کردن خطاهای malformed_path ناشی از فایل‌های بیش از حد طولانی (Nick
Craig-Wood)
.IP \[bu] 2
بررسی طول نام فایل پیش از بارگذاری جهت رفع حلقه بارگذاری (Nick Craig-Wood)
.RE
.IP \[bu] 2
Fichier
.RS 2
.IP \[bu] 2
تنظیم Features ReadMimeType روی true به‌دلیل پشتیبانی از Object.MimeType (Nick
Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
افزودن گزینه \f[V]--ftp-disable-msld\f[R] جهت نادیده گرفتن MLSD برای
سرورهای بسیار قدیمی (Nick Craig-Wood)
.IP \[bu] 2
اعمال شدن \f[V]--tpslimit\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
پشتیبانی از سرآیند شیء کلاس ذخیره‌سازی (Laurens Janssen)
.IP \[bu] 2
اصلاح کلاینت ناشناس جهت استفاده از کلاینت HTTP مربوط به rclone (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای
\f[V]Entry doesn\[aq]t belong in directory \[dq]\[dq] (same as directory) - ignoring\f[R]
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Googlephotos
.RS 2
.IP \[bu] 2
پرچم جدید \f[V]--gphotos-include-archived\f[R] برای نمایش عکس‌های بایگانی‌شده
نیز (Nicolas Rueff)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
عدم گزارش نادرست پشتیبانی از نوشتن انواع MIME (buengese)
.IP \[bu] 2
افزودن پشتیبانی از Telia Cloud (Patrik Nordlén)
.RE
.IP \[bu] 2
Mailru
.RS 2
.IP \[bu] 2
پذیرش پوشه‌های ویژه مانند camera-upload (Ivan Andreev)
.IP \[bu] 2
جلوگیری از هش اولیه فایل‌های محلی بزرگ (Ivan Andreev)
.IP \[bu] 2
اصلاح بارگذاری‌ها پس از تغییرات اخیر در سرور (Ivan Andreev)
.IP \[bu] 2
رفع مشکل درخواست‌های بازه‌ای (range requests) پس از تغییرات ژوئن ۲۰۲۰ سرور (Ivan Andreev)
.IP \[bu] 2
اصلاح برچسب زمان نامعتبر روی فایل‌های معیوب (fixes) (Ivan Andreev)
.IP \[bu] 2
حذف رفتارهای نامتعارف و منسوخ پروتکل (Ivan Andreev)
.RE
.IP \[bu] 2
Memory
.RS 2
.IP \[bu] 2
اصلاح تنظیم انواع MIME (Nick Craig-Wood)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از منطقه چین ارائه‌شده توسط 21vianet و سایر تامین‌کنندگان
منطقه‌ای (NyaMisty)
.IP \[bu] 2
هشدار هنگام خطاهای مهلت زمانی درگاه (gateway timeout) (Nick Craig-Wood)
.IP \[bu] 2
استفاده از رونوشت معمولی در صورت در دسترس نبودن کپی سمت سرور (Alex Chen)
.IP \[bu] 2
رفع مشکل غیرفعال شدن کامل کپی سمت سرور در OneDrive for Business (Cnly)
.IP \[bu] 2
(تنها در business) راهکار موقت برای جایگزینی فایل موجود هنگام کپی سمت سرور
(Alex Chen)
.IP \[bu] 2
بهبود ایجاد پیوند همراه با انقضا، دامنه دسترسی، نوع و گذرواژه (Nick
Craig-Wood)
.IP \[bu] 2
حذف % و # از مجموعه نویسه‌های کدگذاری‌شده (Alex Chen)
.IP \[bu] 2
پشتیبانی از آدرس‌دهی سایت از طریق URL نسبی به سرور (kice)
.RE
.IP \[bu] 2
Opendrive
.RS 2
.IP \[bu] 2
اصلاح یافتن دایرکتوری‌ها بدون حساسیت به بزرگی و کوچکی حروف (Nick Craig-Wood)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
اصلاح تنظیم انواع MIME (Nick Craig-Wood)
.RE
.IP \[bu] 2
Premiumizeme
.RS 2
.IP \[bu] 2
اصلاح یافتن دایرکتوری‌ها بدون حساسیت به بزرگی و کوچکی حروف (Nick Craig-Wood)
.RE
.IP \[bu] 2
Qingstor
.RS 2
.IP \[bu] 2
رفع مشکل انتشار خطا در CleanUp (Nick Craig-Wood)
.IP \[bu] 2
اصلاح پاک‌سازی در rclone (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن \f[V]--s3-disable-http2\f[R] برای غیرفعال‌سازی http/2 (Anagh Kumar
Baranwal)
.IP \[bu] 2
تکمیل پیاده‌سازی SSE-C (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
اصلاح هش‌ها در فایل‌های کوچک با AWS:KMS و SSE-C (Nick Craig-Wood)
.IP \[bu] 2
افزودن فراینداده MD5 به اشیاء بارگذاری‌شده با SSE-AWS/SSE-C (Nick
Craig-Wood)
.RE
.IP \[bu] 2
افزودن پارامتر \f[V]--s3-no-head\f[R] جهت به حداقل رساندن تراکنش‌ها در زمان بارگذاری
(Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی مستندات با افزودن بخش کاهش هزینه‌ها (Nick Craig-Wood)
.IP \[bu] 2
افزودن مدیریت خطا برای کد خطای ۴۲۹ که بیانگر درخواست‌های بیش از حد است
(Anagh Kumar Baranwal)
.IP \[bu] 2
افزودن گزینه پرداخت توسط درخواست‌کننده (requester pays) (kelv)
.IP \[bu] 2
رفع شکست کپی چندبخشی (multipart) با اعتبارسنجی v2 و خطای
\[aq]SignatureDoesNotMatch\[aq] (Louis Koo)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
اجازه احراز هویت مبتنی بر گواهی از طریق کلید عمومی اختیاری (Stephen Harris)
.IP \[bu] 2
امکان بررسی اختیاری کلیدهای میزبان سرور توسط کاربر جهت ارتقای امنیت (Stephen
Harris)
.IP \[bu] 2
به تعویق انداختن درخواست گذرواژه کاربر تا زمان برقراری موفق اتصال SSH
(Stephen Harris)
.IP \[bu] 2
به‌خاطرسپاری گذرواژه واردشده در حالت AskPass (Stephen Harris)
.IP \[bu] 2
پیاده‌سازی متد Shutdown (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی احراز هویت تعاملی صفحه‌کلید (Nick Craig-Wood)
.IP \[bu] 2
اعمال شدن \f[V]--tpslimit\f[R] (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی \f[V]--sftp-use-fstat\f[R] برای سرورهای نامتعارف SFTP (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Sugarsync
.RS 2
.IP \[bu] 2
اصلاح NewObject برای فایل‌هایی با تفاوت در بزرگی و کوچکی حروف (Nick Craig-Wood).IP \[bu] 2
رفع مشکل یافتن دایرکتوری‌ها به صورت غیرحساس به حروف کوچک و بزرگ (Nick Craig-Wood)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
رفع مشکل حذف بخش‌های مربوط به Static Large Object (SLO) (Nguyễn Hữu Luân)
.IP \[bu] 2
اطمینان از آپلود فایل‌های بزرگی که به طور ناقص آپلود شده‌اند، مگر اینکه
\f[V]--swift-leave-parts-on-error\f[R] مشخص شده باشد (Nguyễn Hữu Luân)
.RE
.IP \[bu] 2
Tardigrade
.RS 2
.IP \[bu] 2
ارتقا به uplink v1.4.1 (Caleb Case)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
به‌روزرسانی مستندات برای نشان دادن کارکرد استریم به nextcloud (Durval Menezes)
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
تنظیم Features WriteMimeType روی false با توجه به نادیده گرفتن mime types توسط Yandex (Nick
Craig-Wood)
.RE
.SS v1.53.4 - 2021-01-20
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.53.3...v1.53.4)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting: رفع رقابت داده‌ای (data race) در Transferred() (Maciej Zimnoch)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
جلوگیری از ساخت یک نسخه آزمایشی (beta) جاری توسط انتشار‌های دارای برچسب (Nick Craig-Wood)
.IP \[bu] 2
ارتقای اکشن docker buildx (Matteo Pietro Dazzi)
.IP \[bu] 2
افزودن -buildmode به cross-compile.go (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل ساخت داکر با ارتقای ilteoood/docker_buildx (Nick Craig-Wood)
.IP \[bu] 2
بازگردانی وصله brew در GitHub actions به دلیل رفع شدن مشکل (Nick Craig-Wood)
.IP \[bu] 2
اصلاح نحو brew install --cask برای ساخت macOS (Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی نحو nfpm برای رفع ساخت بسته‌های .deb/.rpm (Nick Craig-Wood)
.IP \[bu] 2
رفع خطاهای ساخت در Windows (Ivan Andreev)
.RE
.IP \[bu] 2
fs: Parseduration: اصلاح آزمون‌ها جهت استفاده از زمان UTC (Ankur Gupta)
.IP \[bu] 2
fshttp: جلوگیری از هم‌پوشانی هدرهای HTTP در لاگ‌ها (Nathan Collins)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
رفع خطای داخلی 500 در core/command (Nick Craig-Wood)
.IP \[bu] 2
افزودن متد Copy به rc.Params (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای 500 هنگام مارشال کردن خطاهای مربوط به core/command (Nick
Craig-Wood)
.IP \[bu] 2
plugins: ایجاد فایل‌های پلاگین تنها در صورت فعال بودن webui
(negative0)
.RE
.IP \[bu] 2
serve http: رفع مشکل ارائه فایل‌های با طول نامشخص (Nick Craig-Wood)
.IP \[bu] 2
serve sftp: رفع مسدود شدن سایر اتصالات توسط احراز هویت در یک اتصال (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
افزودن برچسب اختیاری \f[V]brew\f[R] جهت صدور خطا هنگام استفاده از mount در
باینری‌های نصب‌شده از طریق Homebrew (Anagh Kumar Baranwal)
.IP \[bu] 2
افزودن \[dq].\[dq] و \[dq]..\[dq] به دایرکتوری‌ها جهت تطابق با cmount و
رفتار مورد انتظار (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
مطلق‌سازی مسیر دایرکتوری کش پیش از استفاده جهت رفع خطاهای طولانی بودن مسیر
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Chunker
.RS 2
.IP \[bu] 2
بهبود شناسایی فراداده‌های ناسازگار (Ivan Andreev)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
رفع مشکل کپی در سمت سرور برای اشیاء بزرگ (Nick Craig-Wood)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
اصلاح تجدیدکننده توکن برای رفع مشکل آپلودهای طولانی (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای token refresh failed: is not a regular file (Nick Craig-Wood)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
استفاده انحصاری از هش‌های SHA1 در منطقه EU (Nick Craig-Wood)
.RE
.IP \[bu] 2
Sharefile
.RS 2
.IP \[bu] 2
لغو تغییرات اصلاح بک‌اند به دلیل تعویض اعداد صحیح با رشته‌ها توسط API (Nick
Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
اصلاح درخواست‌های Open Range جهت رفع مشکل mount در 4shared (Nick Craig-Wood)
.IP \[bu] 2
افزودن \[dq]Depth: 0\[dq] به درخواست‌های GET جهت رفع مشکل bitrix (Nick Craig-Wood)
.RE.SS v1.53.3 - 2020-11-19
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.53.2...v1.53.3)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
random: رفع استفاده نادرست از math/rand به جای crypto/rand
CVE-2020-28924 (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
گذرواژه‌هایی که با \f[V]rclone config\f[R] ایجاد کرده‌اید ممکن است
ناامن باشند
.IP \[bu] 2
برای جزئیات بیشتر و ابزار بررسی، گزارش #4783 (https://github.com/rclone/rclone/issues/4783) را
ببینید
.RE
.IP \[bu] 2
random: مقداردهی اولیه (seed) یک‌جای math/rand با مقدار رمزنگاری‌شده قوی (Nick
Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع فراخوانی‌های vfs/refresh با پارامتر fs= (Nick Craig-Wood)
.RE
.IP \[bu] 2
Sharefile
.RS 2
.IP \[bu] 2
رفع backend به دلیل تبدیل اعداد صحیح به رشته توسط API (Nick Craig-Wood)
.RE
.SS v1.53.2 - 2020-10-26
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.53.1...v1.53.2)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
رفع مقدار نادرست سرعت و transferTime در core/stats (Nick Craig-Wood)
.IP \[bu] 2
تثبیت ترتیب نمایش انتقال‌ها در Windows (Nick Craig-Wood)
.RE
.IP \[bu] 2
operations
.RS 2
.IP \[bu] 2
رفع استفاده از --suffix بدون --backup-dir (Nick Craig-Wood)
.IP \[bu] 2
رفع پیام کاذب \[dq]--checksum is in use but the source and destination
have no hashes in common\[dq] (Nick Craig-Wood)
.RE
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
دور زدن مشکل brew در GitHub actions (Nick Craig-Wood)
.IP \[bu] 2
توقف استفاده از set-env و set-path در GitHub actions (Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
mount2: رفع جابجایی مقادیر UID / GID (Russell Cattelan)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
شناسایی و بازیابی در صورت حذف خارجی یک فایل از کش
(Nick Craig-Wood)
.IP \[bu] 2
رفع آسیب‌پذیری بن‌بست (deadlock) در downloaders.Close (Leo Luan)
.IP \[bu] 2
رفع شرایط رقابتی (race condition) در retryFailedResets (Leo Luan)
.IP \[bu] 2
رفع عدم کنترل همزمانی میان برخی عملیات آیتم‌ها و reset
(Leo Luan)
.IP \[bu] 2
افزودن عقب‌نشینی نمایی در تلاش‌های مجدد خطای ENOSPC (Leo Luan)
.IP \[bu] 2
افزودن به‌روزرسانی جاافتاده فضای کش مصرف‌شده (Leo Luan)
.IP \[bu] 2
رفع اشکال --no-modtime برای تلاش نکردن جهت تنظیم modtimeها (همان‌طور که مستند شده است) (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع اندازه‌ها و همگام‌سازی با گزینه --links در Windows (Nick Craig-Wood)
.RE
.IP \[bu] 2
Chunker
.RS 2
.IP \[bu] 2
غیرفعال‌سازی ListR برای حل مشکل فایل‌های مفقود در GDrive (راهکار موقت) (Ivan Andreev)
.IP \[bu] 2
رفع بارگذاری بر روی crypt (Ivan Andreev)
.RE
.IP \[bu] 2
Fichier
.RS 2
.IP \[bu] 2
افزایش حداکثر اندازه فایل از 100GB به 300GB (gyutw)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
حذف clientSecret از پیکربندی هنگام ارتقا به احراز هویت مبتنی بر
توکن (buengese)
.IP \[bu] 2
جلوگیری از اسکیپ دوگانه نشانی وب برای device/mountpoint (albertony)
.IP \[bu] 2
حذف راهکار موقت DirMove به دلیل عدم نیاز به آن (buengese)
.RE
.IP \[bu] 2
Mailru
.RS 2
.IP \[bu] 2
رفع بارگذاری‌ها پس از تغییرات اخیر سرور (Ivan Andreev)
.IP \[bu] 2
رفع درخواست‌های بازه‌ای (range requests) پس از تغییرات ماه ژوئن در سرور (Ivan Andreev)
.IP \[bu] 2
رفع برچسب زمانی نامعتبر روی فایل‌های خراب (Ivan Andreev)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
رفع محاسبه فضای مصرفی دیسک برای sharepoint (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن ناحیه‌های مفقود AWS (Anagh Kumar Baranwal)
.RE
.IP \[bu] 2
Seafile
.RS 2
.IP \[bu] 2
رفع دسترسی به کتابخانه‌های بزرگ‌تر از 2GB در سیستم‌های ۳۲ بیتی (Muffin King)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
تبدیل همیشگی چکسام به حروف کوچک (buengese)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
ایجاد دایرکتوری‌های ریشه در صورت عدم وجود (Nick Craig-Wood)
.RE.SS v1.53.1 - 2020-09-13
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.53.0...v1.53.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting: حذف خط جدید از انتهای نمایش --stats-one-line (Nick
Craig-Wood)
.IP \[bu] 2
check
.RS 2
.IP \[bu] 2
بازگرداندن پرچم مفقود --download (Nick Craig-Wood)
.IP \[bu] 2
اصلاح مستندات (Nick Craig-Wood)
.RE
.IP \[bu] 2
docs
.RS 2
.IP \[bu] 2
ذکر این‌که --log-file اطلاعات را ضمیمه (append) می‌کند (Nick Craig-Wood)
.IP \[bu] 2
افزودن نقطه در پایان جملات برای هماهنگی و یکدستی در rclone --help (edwardxml)
.IP \[bu] 2
افزودن Tencent COS به فهرست ارائه‌دهندگان s3 (wjielai)
.IP \[bu] 2
به‌روزرسانی مستندات دستور mount جهت اشاره به نیاز به Go 1.13 یا جدیدتر (Evan
Harris)
.IP \[bu] 2
jottacloud: ذکر اینکه بارگذاری‌ها از دیسک محلی نیازی به کش کردن فایل‌ها روی دیسک برای محاسبه md5 ندارند (albertony)
.IP \[bu] 2
اصلاح قالب‌بندی صفحه مستندات rc (Nick Craig-Wood)
.RE
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
گنجاندن tarball مربوط به vendor در نسخه انتشار و رفع مشکل startdev (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای \[dq]Illegal instruction\[dq] برای ساخت‌های ARMv6 (Nick
Craig-Wood)
.IP \[bu] 2
اصلاح نام معماری در ساخت ARMv7 (Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع خطای کاذب \[dq]vfs cache: failed to _ensure cache EOF\[dq]
(Nick Craig-Wood)
.IP \[bu] 2
ثبت یک لاگ ERROR در صورت عدم موفقیت در sparse کردن فایل (Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
ثبت یک لاگ ERROR در صورت عدم موفقیت در sparse کردن فایل (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن مجدد متن راهنمای اختصاصی oauth (Tim Gallant)
.RE
.IP \[bu] 2
Opendrive
.RS 2
.IP \[bu] 2
عدم تلاش مجدد برای خطاهای 400 (Evan Harris)
.RE
.SS v1.53.0 - 2020-09-02
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.52.0...v1.53.0)
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
لایه VFS
(https://rclone.org/commands/rclone_mount/#vfs-virtual-file-system)
در این نسخه به شکل اساسی بازنویسی شد - برای جزئیات بیشتر به بخش زیر مراجعه کنید
.IP \[bu] 2
حالت تعاملی ‎-i/--interactive‎
(https://rclone.org/docs/#interactive)
برای عملیات مخرب (fishbullet)
.IP \[bu] 2
افزودن پرچم --bwlimit-file
(https://rclone.org/docs/#bwlimit-file-bwtimetable)
جهت محدود کردن سرعت انتقال هر فایل به طور مجزا (Nick Craig-Wood)
.IP \[bu] 2
مرتب‌سازی انتقال‌ها بر اساس زمان شروع در خروجی آمار و پیشرفت (Max
Sum)
.IP \[bu] 2
اطمینان از باز شدن علامت \f[V]\[ti]\f[R] و متغیرهای محیطی در نام فایل‌های مورد استفاده توسط backendها (Nick Craig-Wood)
.IP \[bu] 2
افزودن پرچم --refresh-times
(https://rclone.org/docs/#refresh-times)
برای تنظیم modtime در backendهای بدون هش (Nick Craig-Wood)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
حذف پوشه vendor به نفع ماژول‌های Go (Nick Craig-Wood)
.IP \[bu] 2
ساخت با go1.15.x به صورت پیش‌فرض (Nick Craig-Wood)
.IP \[bu] 2
توقف ساخت macOS 386 به دلیل عدم پشتیبانی در go1.15 (Nick
Craig-Wood)
.IP \[bu] 2
افزودن ARMv7 به بیلد‌های پشتیبانی‌شده (Nick Craig-Wood)
.IP \[bu] 2
فعال‌سازی \f[V]rclone cmount\f[R] روی macOS (Nick Craig-Wood)
.IP \[bu] 2
فراهم کردن قابلیت ساخت rclone با gccgo (Nick Craig-Wood)
.IP \[bu] 2
فراهم کردن قابلیت ساخت rclone با wasm (Nick Craig-Wood)
.IP \[bu] 2
تغییر شماره‌گذاری نسخه‌های بتا جهت سازگاری با semver (Nick Craig-Wood)
.IP \[bu] 2
افزودن ویژگی‌های فایل و آیکون به فایل اجرایی ویندوز (albertony)
.IP \[bu] 2
افزودن یک رابط آزمایشی برای ادغام rclone در مرورگرها (Nick
Craig-Wood)
.RE
.IP \[bu] 2
lib: افزودن فشرده‌سازی نام فایل (Klaus Post)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
امکان نصب و استفاده از افزونه‌ها و آزمون آن‌ها با rclone-webui
(Chaitanya Bankanhal)
.IP \[bu] 2
افزودن پراکسی معکوس pluginsHandler برای ارائه افزونه‌ها (Chaitanya
Bankanhal)
.IP \[bu] 2
افزودن گزینه \f[V]mount/listmounts\f[R] جهت فهرست‌کردن مانت‌های فعلی
(Chaitanya Bankanhal)
.IP \[bu] 2
افزودن \f[V]operations/uploadfile\f[R] برای بارگذاری فایل از طریق rc با استفاده از کدگذاری multipart/form-data (Chaitanya Bankanhal)
.IP \[bu] 2
افزودن \f[V]core/command\f[R] برای اجرای دستورات ترمینال rclone.
(Chaitanya Bankanhal)
.RE
.IP \[bu] 2
\f[V]rclone check\f[R]
.RS 2
.IP \[bu] 2
افزودن گزارش نام فایل‌ها برای موارد یکسان/مفقود/تغییریافته (same/missing/changed) (Nick Craig-Wood)
.IP \[bu] 2
پیروی دستور check از گزینه‌های
\f[V]--dry-run\f[R]/\f[V]-i\f[R]/\f[V]--interactive\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
امکان پردازش هم‌زمان فایل‌ها به تعداد \f[V]--checkers\f[R] در دستور check (Nick Craig-Wood)
.IP \[bu] 2
تلاش مجدد برای دانلودها در صورت شکست هنگام استفاده از پرچم \f[V]--download\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
نمایش پیش‌فرض آمار (stats) (Nick Craig-Wood)
.RE
.IP \[bu] 2
\f[V]rclone obscure\f[R]: امکان دریافت گذرواژه از STDIN در دستور obscure (David Ibarra)
.IP \[bu] 2
\f[V]rclone config\f[R]
.RS 2
.IP \[bu] 2
تنظیم متغیر RCLONE_CONFIG_DIR برای استفاده در فایل‌های پیکربندی و زیرپردازه‌ها (Nick
Craig-Wood)
.IP \[bu] 2
رد نام‌های remote که با خط تیره شروع می‌شوند.
(jtagcat)
.RE
.IP \[bu] 2
\f[V]rclone cryptcheck\f[R]: افزودن گزارش نام فایل‌ها برای موارد یکسان/مفقود/تغییریافته (same/missing/changed) (Nick Craig-Wood)
.IP \[bu] 2
\f[V]rclone dedupe\f[R]: پیروی از پرچم \f[V]--size-only\f[R] جهت تشخیص فایل‌های تکراری (Nick Craig-Wood).IP \[bu] 2
\f[V]rclone link\f[R]: افزودن پرچم‌های \f[V]--expire\f[R] و \f[V]--unlink\f[R] (Roman Kredentser)
.IP \[bu] 2
\f[V]rclone mkdir\f[R]: هشدار هنگام استفاده از mkdir بر روی ریموت‌هایی که نمی‌توانند دایرکتوری خالی داشته باشند (Nick Craig-Wood)
.IP \[bu] 2
\f[V]rclone rc\f[R]: مجاز کردن پارامترهای JSON برای ساده‌سازی استفاده در خط فرمان (Nick Craig-Wood)
.IP \[bu] 2
\f[V]rclone serve ftp\f[R]
.RS 2
.IP \[bu] 2
عدم کامپایل بر روی < go1.13 پس از به‌روزرسانی وابستگی‌ها (Nick Craig-Wood)
.IP \[bu] 2
افزودن پیام خطا در صورت شکست پراکسی احراز هویت (Nick Craig-Wood)
.IP \[bu] 2
استفاده از کتابخانه بازطراحی‌شده goftp.io/server برای کاهش حجم فایل باینری (Nick Craig-Wood)
.RE
.IP \[bu] 2
\f[V]rclone serve restic\f[R]: ارائه رابط‌ها جهت امکان استفاده از rclone به‌عنوان یک کتابخانه از داخل restic (Jack)
.IP \[bu] 2
\f[V]rclone sync\f[R]: افزودن \f[V]--track-renames-strategy leaf\f[R] (Nick Craig-Wood)
.IP \[bu] 2
\f[V]rclone touch\f[R]: افزودن قابلیت تنظیم زمان‌ها با دقت نانوثانیه (Nick Craig-Wood)
.IP \[bu] 2
\f[V]rclone tree\f[R]: حذف مخفف \f[V]-i\f[R] برای \f[V]--noindent\f[R] به دلیل تداخل با \f[V]-i\f[R]/\f[V]--interactive\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
رفع اشکال‌ها
.RS 2
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
اصلاح مستندات \f[V]speed\f[R]/\f[V]speedAvg\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل عدم نمایش زمان واقعی سپری‌شده از ابتدا (Chaitanya Bankanhal)
.IP \[bu] 2
رفع بن‌بست (deadlock) در چاپ آمار (Nick Craig-Wood)
.RE
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
رفع نشت دستگیره فایل (file handle leak) در ابزار انتشار GitHub (Garrett Squire)
.RE
.IP \[bu] 2
\f[V]rclone check\f[R]: رفع محاسبه خطاها در تلاش‌های مجدد موفق با \f[V]--download\f[R] (Nick Craig-Wood)
.IP \[bu] 2
\f[V]rclone dedupe\f[R]: اصلاح ثبت وقایع (logging) جهت فهم آسان‌تر (Nick Craig-Wood)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
هشدار به کاربران macOS درباره تغییر پیاده‌سازی mount (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
جهت آزمایش پیاده‌سازی جدید، به‌جای \f[V]rclone mount\f[R] از \f[V]rclone cmount\f[R] استفاده کنید
.IP \[bu] 2
این امر به این دلیل است که کتابخانه مورد استفاده rclone، پشتیبانی از macOS را متوقف کرده است
.RE
.IP \[bu] 2
رابط rc
.RS 2
.IP \[bu] 2
افزودن فراخوانی برای پیاده کردن همه (unmount all) (Chaitanya Bankanhal)
.IP \[bu] 2
امکان دریافت گزینه vfsOpt در کنترل از راه دور \f[V]mount/mount\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن mountOpt به \f[V]mount/mount\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینه‌های VFS و Mount به \f[V]mount/listmounts\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
به دام انداختن panicها در راه‌اندازی اولیه cgofuse و تبدیل آن‌ها به پیام‌های خطا (Nick Craig-Wood)
.IP \[bu] 2
ارائه همیشگی اطلاعات stat در Readdir (Nick Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی از خواندن فایل‌های با طول نامشخص با استفاده از direct IO (ویندوز) (Nick Craig-Wood)
.IP \[bu] 2
عدم افزودن \f[V]-o uid/gid=-1\f[R] در ویندوز در صورت تعیین \f[V]-o uid/gid\f[R] توسط کاربر (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل از دست رفتن محتویات دایرکتوری در cmount روی macOS (Nick Craig-Wood)
.IP \[bu] 2
اصلاح نام حجم (volume name) که در بازطراحی اخیر کد شکسته شده بود (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
پیاده‌سازی خواندن‌های جزئی (partial reads) برای \f[V]--vfs-cache-mode full\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینه \f[V]--vfs-writeback\f[R] برای به تأخیر انداختن بازنویسی روی فضای ابری (Nick Craig-Wood)
.IP \[bu] 2
افزودن پارامتر \f[V]--vfs-read-ahead\f[R] برای استفاده همراه با \f[V]--vfs-cache-mode full\f[R] (Nick Craig-Wood)
.IP \[bu] 2
راه‌اندازی مجدد بارگذاری‌های معلق با راه‌اندازی دوباره حافظه موقت (Nick Craig-Wood)
.IP \[bu] 2
پشتیبانی از بازیابی همگام فضای کش هنگام رخداد ENOSPC (Leo Luan)
.IP \[bu] 2
اجازه به ReadAt و WriteAt برای اجرای هم‌زمان با خودشان (Nick Craig-Wood)
.IP \[bu] 2
تغییر زمان اصلاح (modtime) فایل پیش از بارگذاری به زمان فعلی (Rob Calistri)
.IP \[bu] 2
پیشنهاد استفاده از \f[V]--vfs-cache-modes writes\f[R] روی بک‌اندهایی که قابلیت استریم ندارند (Nick Craig-Wood)
.IP \[bu] 2
افزودن پارامتر اختیاری \f[V]fs\f[R] به متدهای vfs rc (Nick Craig-Wood)
.IP \[bu] 2
رفع خطاها هنگام استفاده از فایل‌های دارای بیش از ۲۶۰ نویسه در کش ویندوز (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل تغییر نام آیتم‌ها در حین بارگذاری آن‌ها (Nick Craig-Wood)
.IP \[bu] 2
رفع بار پردازشی بسیار بالا ناشی از فهرست‌گیری کند دایرکتوری‌ها (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل بارگذاری نشدن فایل‌های تغییرنام‌یافته با \f[V]--vfs-cache-mode minimal\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع قفل شدن دایرکتوری ناشی از فهرست‌گیری کند دایرکتوری‌ها (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل ذخیره‌سازی از chrome بدون \f[V]--vfs-cache-mode writes\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
افزودن \f[V]--local-no-updated\f[R] جهت ارائه نمایی یکپارچه از شیءهای در حال تغییر (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینه \f[V]--local-no-set-modtime\f[R] برای جلوگیری از تغییرات modtime (tyhuber1)
.IP \[bu] 2
رفع شرایط رقابتی (race conditions) در به‌روزرسانی و خواندن متادیتای Object (Nick Craig-Wood)
.RE
.IP \[bu] 2
Cache
.RS 2
.IP \[bu] 2
کش کردن هر بک‌اند ایجادشده جهت برطرف کردن مشکلات rc (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل dedupe روی کش‌هایی که درایوها را در بر می‌گیرند (Nick Craig-Wood)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--crypt-server-side-across-configs\f[R] (Nick Craig-Wood)
.IP \[bu] 2
کش کردن هر بک‌اند ایجادشده جهت برطرف کردن مشکلات rc (Nick Craig-Wood)
.RE
.IP \[bu] 2
Alias
.RS 2.IP \[bu] 2
کش‌کردن تمام backendهای ایجادشده جهت رفع مشکلات rc (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
عدم کامپایل در نسخه‌های کمتر از go1.13 پس از به‌روزرسانی وابستگی‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
پیاده‌سازی کپی سمت سرور برای فایل‌های بزرگ‌تر از ۵ گیگابایت (Nick Craig-Wood)
.IP \[bu] 2
لغو بارگذاری‌ها و کپی‌های چندبخشی در حال انجام هنگام خروج rclone (Nick
Craig-Wood)
.IP \[bu] 2
توجه به اینکه کدگذاری b2 اکنون \ را مجاز می‌داند اما در rclone تغییری نکرده است (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل انتقال‌ها هنگام استفاده از download_url (Nick Craig-Wood)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
پیاده‌سازی rclone cleanup (buengese)
.IP \[bu] 2
لغو بارگذاری‌ها و کپی‌های چندبخشی در حال انجام هنگام خروج rclone (Nick
Craig-Wood)
.IP \[bu] 2
امکان احراز هویت با access token (David)
.RE
.IP \[bu] 2
Chunker
.RS 2
.IP \[bu] 2
کش‌کردن تمام backendهای ایجادشده جهت رفع مشکلات rc (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن \f[V]rclone backend drives\f[R] برای فهرست‌کردن درایوهای اشتراکی (teamdrives)
(Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی \f[V]rclone backend untrash\f[R] (Nick Craig-Wood)
.IP \[bu] 2
دور زدن باگ drive که modtime اسناد کپی‌شده را تنظیم نمی‌کرد (Nick
Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--drive-starred-only\f[R] برای نمایش تنها فایل‌های ستاره‌دار (Jay
McEntire)
.IP \[bu] 2
منسوخ‌کردن \f[V]--drive-alternate-export\f[R] زیرا دیگر نیازی به آن نیست
(themylogin)
.IP \[bu] 2
رفع مشکل تکراری شدن Google docs در کپی سمت سرور (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای \[dq]panic: send on closed channel\[dq] هنگام بازیافت مدخل‌های دایرکتوری
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
افزودن اطلاعات آشکارساز حق نشر در بخش محدودیت‌های مستندات (Alex
Guerrero)
.IP \[bu] 2
رفع مشکل \f[V]rclone link\f[R] با حذف پارامتر expires (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Fichier
.RS 2
.IP \[bu] 2
تشخیص خطای Flood detected: IP Locked و توقف به مدت ۳۰ ثانیه (Nick
Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از TLS صریح (Heiko Bornholdt)
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--dump bodies\f[R] و \f[V]--dump auth\f[R] برای
اشکال‌زدایی (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل تعامل‌پذیری با pure-ftpd (Nick Craig-Wood)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از دسترسی ناشناس (Kai Lüke)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
بازگردانی احراز هویت قدیمی جهت استفاده با نسخه‌های whitelabel
(buengese)
.IP \[bu] 2
تغییر به api root جدید \- همچنین پیاده‌سازی یک راهکار موقت برای
خرابی‌های DirMove (buengese)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
بازنویسی لغو بارگذاری‌های چندبخشی هنگام خروج rclone (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی rclone cleanup (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینهٔ \f[V]--onedrive-no-versions\f[R] برای حذف نسخه‌های قدیمی (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]rclone link\f[R] برای ایجاد پیوند عمومی (buengese)
.RE
.IP \[bu] 2
Qingstor
.RS 2
.IP \[bu] 2
لغو بارگذاری‌های چندبخشی در حال انجام هنگام خروج rclone (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
حفظ فراداده هنگام انجام کپی چندبخشی (Nick Craig-Wood)
.IP \[bu] 2
لغو بارگذاری‌ها و کپی‌های چندبخشی در حال انجام هنگام خروج rclone (Nick
Craig-Wood)
.IP \[bu] 2
افزودن \f[V]rclone link\f[R] برای اشتراک‌گذاری پیوند عمومی (Roman Kredentser)
.IP \[bu] 2
افزودن دستور \f[V]rclone backend restore\f[R] جهت بازیابی اشیاء از
GLACIER (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]rclone cleanup\f[R] و \f[V]rclone backend cleanup\f[R] جهت
پاک‌سازی بارگذاری‌های چندبخشی ناتمام (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]rclone backend list-multipart-uploads\f[R] برای فهرست‌کردن بارگذاری‌های
چندبخشی ناتمام (Nick Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--s3-max-upload-parts\f[R] (Kamil Trzciński)
.IP \[bu] 2
افزودن \f[V]--s3-no-check-bucket\f[R] برای به حداقل رساندن تراکنش‌ها و دسترسی‌های rclone (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینه‌های \f[V]--s3-profile\f[R] و \f[V]--s3-shared-credentials-file\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
استفاده از نقطهٔ پایانی منطقه‌ای us-east-1 برای s3 (David)
.IP \[bu] 2
افزودن ارائه‌دهندهٔ Scaleway (Vincent Feltz)
.IP \[bu] 2
به‌روزرسانی نقاط پایانی IBM COS (Egor Margineanu)
.IP \[bu] 2
کاهش مقدار پیش‌فرض \f[V]--s3-copy-cutoff\f[R] به کمتر از ۵ گیگابایت برای
سازگاری با Backblaze S3 (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل در تشخیص موجود بودن bucket (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
استفاده از مسیر مطلق به‌جای مسیر نسبی در فهرست‌کردن جهت
سازگاری بهتر (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینه‌های \f[V]--sftp-subsystem\f[R] و \f[V]--sftp-server-command\f[R]
(aus)
.RE
.IP \[bu] 2
Swift
.RS 2.IP \[bu] 2
رفع مشکل از کار افتادن فهرست‌بندی به دلیل اشیاء بزرگ معلق (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل عدم حذف نشانگرهای دایرکتوری توسط purge (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل به‌روزرسانی شیء چندبخشی (multipart) که تمام بخش‌های خود را حذف می‌کرد (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل فقدان هش در شیء بازگردانده‌شده از بارگذاری (Nick Craig-Wood)
.RE
.IP \[bu] 2
Tardigrade
.RS 2
.IP \[bu] 2
ارتقا به uplink v1.2.0 (Kaloyan Raev)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
رفع مشکل نوشتن با خط‌مشی all (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
رفع مشکل ایجاد دایرکتوری در 4shared (Nick Craig-Wood)
.RE
.SS v1.52.3 - 2020-08-07
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.52.2...v1.52.3)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
docs
.RS 2
.IP \[bu] 2
غیرفعال‌سازی تایپوگرافی هوشمند (مانند
en-dash) در MANUAL.* و صفحهٔ man (Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی install.md برای انعکاس حداقل نسخهٔ Go (Evan Harris)
.IP \[bu] 2
به‌روزرسانی دستورالعمل‌های نصب از سورس (Nick Craig-Wood)
.IP \[bu] 2
make_manual: پشتیبانی از SOURCE_DATE_EPOCH (Morten Linderud)
.RE
.IP \[bu] 2
log: رفع ارسال خروجی --use-json-log به stderr به جای --log-file در Windows (Nick
Craig-Wood)
.IP \[bu] 2
serve dlna: رفع فهرست فایل در تلویزیون‌های سامسونگ سری 6+ (Matteo Pietro Dazzi)
.IP \[bu] 2
sync: رفع بن‌بست (deadlock) در صورت استفاده از --track-renames-strategy modtime (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Cache
.RS 2
.IP \[bu] 2
رفع اشکال moveto/copyto remote:file remote:file2 (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
توقف استفاده از root_folder_id به عنوان کش (Nick Craig-Wood)
.IP \[bu] 2
نمایش میانبرهای معلق در فهرست‌بندی‌ها (Nick Craig-Wood)
.IP \[bu] 2
کاهش سطح پیام‌های \[dq]Disabling ListR\[dq] به debug (Nick Craig-Wood)
.IP \[bu] 2
راهکار جایگزین و خط‌مشی برای Google Drive API (Dmitry Ustalov)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
افزودن یادداشتی به مستندات دربارهٔ انتخاب دایرکتوری home در برابر root (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
رفع مشکل بازگشت به Copy در زمانی که Move کار می‌کرد (Nick Craig-Wood)
.IP \[bu] 2
جلوگیری از رندر شدن کاما در URL در onedrive.md (Kevin)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
رفع مشکل oauth در منطقهٔ اروپایی \[dq]eapi.pcloud.com\[dq] (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع تشخیص خودکار Region برای باکت زمانی که Region در پیکربندی تنظیم نشده است (Nick
Craig-Wood)
.RE.SS v1.52.2 \- 2020-06-24
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.52.1...v1.52.2)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
اصلاح اکشن ساخت انتشار Docker (Nick Craig-Wood)
.IP \[bu] 2
اصلاح منطقه زمانی سفارشی در ایمیج Docker (NoLooseEnds)
.RE
.IP \[bu] 2
check: اصلاح پیام گمراه‌کننده‌ای که به جای تفاوت‌ها، خطاها را چاپ می‌کرد (Nick Craig-Wood)
.IP \[bu] 2
errors: افزودن WSAECONNREFUSED و موارد دیگر به فهرست خطاهای قابل تلاش مجدد در Windows (Nick Craig-Wood)
.IP \[bu] 2
rcd: اصلاح متریک‌های نادرست prometheus (Gary Kim)
.IP \[bu] 2
serve restic: اصلاح فلگ‌ها جهت استفاده از متغیرهای محیطی (Nick Craig-Wood)
.IP \[bu] 2
serve webdav: اصلاح فلگ‌ها جهت استفاده از متغیرهای محیطی (Nick Craig-Wood)
.IP \[bu] 2
sync: اصلاح \-\-track\-renames\-strategy modtime (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
اصلاح عدم امکان حذف دایرکتوری دارای میانبرِ به سطل زباله منتقل‌شده (Nick Craig-Wood)
.IP \[bu] 2
اصلاح ایجاد دایرکتوری درون یک میانبر (Nick Craig-Wood)
.IP \[bu] 2
اصلاح \-\-drive\-impersonate با root_folder_id ذخیره‌شده در حافظه موقت (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
اصلاح بارگذاری کلید SSH با ساختار PEM (Zac Rubin)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
افزایش سرعت عملیات حذف با عدم تلاش مجدد برای حذف کانتینرهای قطعه (Nick Craig-Wood)
.RE
.IP \[bu] 2
Tardigrade
.RS 2
.IP \[bu] 2
ارتقا به uplink نسخه v1.1.1 (Caleb Case)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
اصلاح نمایش فضای خالی/مصرفی برای rclone about/df در برخی backendها (Nick Craig-Wood)
.RE
.SS v1.52.1 \- 2020-06-10
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.52.0...v1.52.1)
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
lib/file: اصلاح SetSparse در Windows 7 که مشکل دانلود فایل‌های > 250MB را برطرف می‌کند (Nick Craig-Wood)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
به‌روزرسانی go.mod به go1.14 جهت فعال‌سازی ساخت با \-mod=vendor (Nick Craig-Wood)
.IP \[bu] 2
حذف quicktest از Dockerfile (Nick Craig-Wood)
.IP \[bu] 2
ساخت ایمیج‌های Docker با استفاده از GitHub actions (Matteo Pietro Dazzi)
.IP \[bu] 2
به‌روزرسانی گردش‌های کاری ساخت Docker (Nick Craig-Wood)
.IP \[bu] 2
تنظیم user_allow_other در /etc/fuse.conf درون ایمیج Docker (Nick Craig-Wood)
.IP \[bu] 2
اصلاح ساخت xgo پس از به‌روزرسانی go.mod به go1.14 (Nick Craig-Wood)
.RE
.IP \[bu] 2
docs
.RS 2
.IP \[bu] 2
افزودن پیوند به سورس و زمان ویرایش در پاورقی تمام صفحه‌ها (Nick Craig-Wood)
.IP \[bu] 2
حذف تاریخ‌های دستی و استفاده از تاریخ‌های git به‌جای آن‌ها (Nick Craig-Wood)
.IP \[bu] 2
تغییرات جزئی در زمان افعال، نشانه‌گذاری، ایجاز و لحن مثبت برای صفحه اصلی (edwardxml)
.IP \[bu] 2
حذف اسلش ابتدایی در ارجاع صفحه در پاورقی در صورت وجود (Nick Craig-Wood)
.IP \[bu] 2
مشخص کردن دستورهایی که در مستندات به ورودی مبهم‌سازی‌شده (obscured) نیاز دارند (Nick Craig-Wood)
.IP \[bu] 2
obscure: نگارش توضیحات راهنمای بیشتر به دلیل ارجاع به آن در بخش‌های دیگر (Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
اصلاح تداخل مسیرهای سیستم‌عامل در برابر یونیکس \- برطرف‌سازی ChangeNotify در Windows (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
اصلاح موارد مفقود حین فهرست‌گیری با استفاده از \-\-fast\-list / ListR (Nick Craig-Wood)
.RE
.IP \[bu] 2
Putio
.RS 2
.IP \[bu] 2
اصلاح خطای panic در Object.Open (Cenk Alti)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
اصلاح بارگذاری فایل‌های تکی در باکت‌های فاقد مجوز ساخت (Nick Craig-Wood)
.IP \[bu] 2
اصلاح \-\-header\-upload (Nick Craig-Wood)
.RE
.IP \[bu] 2
Tardigrade
.RS 2
.IP \[bu] 2
رفع باگ فهرست‌گیری با ارتقا به v1.0.7
.IP \[bu] 2
تنظیم UserAgent روی rclone (Caleb Case)
.RE.SS v1.52.0 \- 2020-05-27
.PP
تشکر ویژه از Martin Michlmayr برای بازخوانی و تصحیح تمام
مستندات و از Edward Barker برای کمک به بازنویسی صفحه اصلی.
.PP
مشاهده کامیت‌ها (https://github.com/rclone/rclone/compare/v1.51.0...v1.52.0)
.IP \[bu] 2
پشتیبان‌های جدید
.RS 2
.IP \[bu] 2
پشتیبان Tardigrade (https://rclone.org/tardigrade) برای استفاده با
storj.io (Caleb Case)
.IP \[bu] 2
بازنویسی Union (https://rclone.org/union) برای داشتن چندین
ریموت قابل نوشتن (Max Sum)
.IP \[bu] 2
پشتیبان Seafile برای سرور Seafile (Fred \[at]creativeprojects)
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
backend: دستور برای دستورات خاص پشتیبان (بخش backends را ببینید) (Nick
Craig-Wood)
.IP \[bu] 2
cachestats: منسوخ شدن به نفع \f[V]rclone backend stats cache:\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
dbhashsum: منسوخ شدن به نفع \f[V]rclone hashsum DropboxHash\f[R]
(Nick Craig-Wood)
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
افزودن پرچم‌های \f[V]--header-download\f[R] و \f[V]--header-upload\f[R] برای
تنظیم سرآیندهای HTTP هنگام بارگذاری/بارگیری (Tim Gallant)
.IP \[bu] 2
افزودن پرچم \f[V]--header\f[R] برای افزودن سرآیندهای HTTP به هر
تراکنش HTTP (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--check-first\f[R] برای انجام تمام بررسی‌ها پیش از شروع انتقال‌ها
(Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--track-renames-strategy\f[R] برای معیارهای تطابق
قابل‌پیکربندی در \f[V]--track-renames\f[R] (Bernd Schoolmann)
.IP \[bu] 2
افزودن \f[V]--cutoff-mode\f[R] با مقادیر hard، soft و cautious (Shing Kit Chan و
Franklyn Tackitt)
.IP \[bu] 2
پرچم‌های پالایه (مانند
\f[V]--files-from -\f[R]) می‌توانند از stdin بخوانند (fishbullet)
.IP \[bu] 2
افزودن گزینه \f[V]--error-on-no-transfer\f[R] (Jon Fautley)
.IP \[bu] 2
پیاده‌سازی \f[V]--order-by xxx,mixed\f[R] برای کپی کردن تعدادی فایل کوچک و تعدادی
فایل بزرگ (Nick Craig-Wood)
.IP \[bu] 2
امکان منفی بودن مقدار \f[V]--max-backlog\f[R] به معنای تا جای ممکن
بزرگ (Nick Craig-Wood)
.IP \[bu] 2
افزودن پرچم \f[V]--no-unicode-normalization\f[R] برای حفظ یکتایی
نام‌های یونیکد فایل‌ها (Ben Zenker)
.IP \[bu] 2
امکان دریافت تاریخ علاوه بر مدت‌زمان برای \f[V]--min-age\f[R]/\f[V]--max-age\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
افزودن آمار تغییر نام برای نام‌های تغییر‌یافته فایل‌ها و دایرکتوری‌ها (Nick Craig-Wood)
.IP \[bu] 2
افزودن خروجی آمار به لاگ JSON (reddi)
.IP \[bu] 2
چاپ آمارها در صورت خروج با وضعیت غیر صفر (Nick Craig-Wood)
.IP \[bu] 2
امکان استفاده از stdin هنگام اجرای \f[V]--password-command\f[R] (Sébastien
Gross)
.IP \[bu] 2
جلوگیری از معتبر شناخته شدن رشته‌های خالی به عنوان مسیر ریموت (Nick Craig-Wood)
.IP \[bu] 2
accounting: پشتیبانی از WriterTo برای کپی حافظه کمتر (Nick Craig-Wood)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
به‌روزرسانی برای استفاده از go1.14 در ساخت (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]-trimpath\f[R] به ساخت نسخه نهایی جهت ایجاد ساخت‌های بازتولیدپذیر (Nick
Craig-Wood)
.IP \[bu] 2
حذف GOOS و GOARCH از Dockerfile (Brandon Philips)
.RE
.IP \[bu] 2
config
.RS 2
.IP \[bu] 2
فراخوانی fsync روی فایل پیکربندی پس از نوشتن جهت ذخیره‌سازی مطمئن‌تر (Nick
Craig-Wood)
.IP \[bu] 2
افزودن پرچم‌های \f[V]--obscure\f[R] و \f[V]--no-obscure\f[R] به
\f[V]config create\f[R]/\f[V]update\f[R] (Nick Craig-Wood)
.IP \[bu] 2
امکان پذیرش \f[V]remote:\f[R] علاوه بر
\f[V]remote\f[R] در \f[V]config show\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
copyurl: افزودن پرچم \f[V]--no-clobber\f[R] (Denis)
.IP \[bu] 2
delete: افزودن پرچم \f[V]--rmdirs\f[R] برای حذف دایرکتوری‌ها نیز
(Kush)
.IP \[bu] 2
filter: افزودن پرچم \f[V]--files-from-raw\f[R] (Ankur Gupta)
.IP \[bu] 2
genautocomplete: افزودن پشتیبانی از پوسته fish (Matan Rosenberg)
.IP \[bu] 2
log: افزودن پشتیبانی از امکانات LOCAL در syslog (Patryk Jakuszew)
.IP \[bu] 2
lsjson: افزودن پارامتر \f[V]--hash-type\f[R] و استفاده از آن در lsf برای افزایش
سرعت درهم‌سازی (Nick Craig-Wood)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن \f[V]-o\f[R]/\f[V]--opt\f[R] و \f[V]-a\f[R]/\f[V]--arg\f[R] برای
ورودی ساختاریافته‌تر (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی \f[V]backend/command\f[R] برای اجرای راه دور
دستورات مختص پشتیبان (Nick Craig-Wood)
.IP \[bu] 2
افزودن دستور \f[V]mount/mount\f[R] برای راه‌اندازی \f[V]rclone mount\f[R]
از طریق API (Chaitanya)
.RE
.IP \[bu] 2
rcd: افزودن پشتیبانی از معیارهای Prometheus (Gary Kim)
.IP \[bu] 2
serve http
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--template\f[R] برای نشانه‌گذاری تعریف‌شده توسط کاربر (calistri)
.IP \[bu] 2
افزودن سرآیندهای Last-Modified به فایل‌ها و دایرکتوری‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
serve sftp: افزودن پشتیبانی از چندین کلید میزبان با تکرار
پرچم \f[V]--key\f[R] (Maxime Suret)
.IP \[bu] 2
touch: افزودن پرچم \f[V]--localtime\f[R] برای محلی کردن زمان \f[V]--timestamp\f[R]
به جای UTC (Nick Craig-Wood)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
بازگردانی خط لاگ \[dq]Max number of stats groups reached\[dq] (Michał
Matczuk)
.IP \[bu] 2
تصحیح وضعیت خروج در پرچم Transfer Limit Exceeded.
(Anuar Serdaliyev)
.IP \[bu] 2
بازنشانی بایت‌های خوانده‌شده هنگام تلاش مجدد برای کپی (Ankur Gupta)
.IP \[bu] 2
رفع وضعیت رقابتی در پاک‌سازی آمارها (Nick Craig-Wood)
.RE
.IP \[bu] 2
copy: ایجاد دایرکتوری‌های خالی تنها در صورتی که روی
ریموت وجود نداشته باشند (Ishuah Kariuki)
.IP \[bu] 2
dedupe: توقف حذف فایل‌های دارای شناسه‌های یکسان توسط dedupe (Nick Craig-Wood)
.IP \[bu] 2
oauth
.RS 2
.IP \[bu] 2
استفاده از کلاینت سفارشی http تا \f[V]--no-check-certificate\f[R]
هنگام واکشی توکن oauth رعایت شود (Mark Spieth)
.IP \[bu] 2
جایگزینی oauth2.NoContext منسوخ‌شده (Lars Lehtonen)
.RE
.IP \[bu] 2
operations
.RS 2.IP \[bu] 2
اصلاح تنظیم برچسب زمانی در Windows برای رونوشت چندنخی (Nick
Craig-Wood)
.IP \[bu] 2
ملزم کردن rcat به پیروی از \f[V]--ignore-checksum\f[R] (Nick Craig-Wood)
.IP \[bu] 2
دقیق‌تر کردن عملکرد \f[V]--max-transfer\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
رفع خطای نادیده‌گرفته‌شده (Lars Lehtonen)
.IP \[bu] 2
اصلاح پیکربندی نابجای کارساز http (Xiaoxing Ye)
.IP \[bu] 2
غیرفعال‌سازی لاگ تکراری (ElonH)
.RE
.IP \[bu] 2
serve dlna
.RS 2
.IP \[bu] 2
Cds: عدم تعیین childCount در صورت نامشخص بودن آن (Dan Walters)
.IP \[bu] 2
Cds: استفاده از زمان تغییر به‌عنوان تاریخ در فراداده dlna (Dan Walters)
.RE
.IP \[bu] 2
serve restic: اصلاح آزمون‌ها پس از حذف وابستگی‌های داخلی (vendoring) در پروژه restic (Nick
Craig-Wood)
.IP \[bu] 2
sync
.RS 2
.IP \[bu] 2
اصلاح پیام نادرست \[dq]nothing to transfer\[dq] هنگام استفاده از
\f[V]--delete-before\f[R] (Nick Craig-Wood)
.IP \[bu] 2
ایجاد دایرکتوری‌های خالی تنها در صورتی که در remote وجود نداشته باشند
(Ishuah Kariuki)
.RE
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
افزودن گزینه \f[V]--async-read\f[R] جهت غیرفعال‌سازی خواندن ناهمگام (Nick
Craig-Wood)
.IP \[bu] 2
نادیده‌گرفتن گزینه \f[V]--allow-root\f[R] همراه با یک هشدار به دلیل حذف آن در
بالادست (Nick Craig-Wood)
.IP \[bu] 2
هشدار در صورت استفاده از \f[V]--allow-non-empty\f[R] در Windows و شفاف‌سازی مستندات
(Nick Craig-Wood)
.IP \[bu] 2
محدود کردن به go1.13 یا بالاتر، در غیر این صورت کامپایل bazil.org/fuse با خطا مواجه می‌شود
(Nick Craig-Wood)
.IP \[bu] 2
رفع خطا به دلیل طولانی بودن بیش از حد نام حجم (evileye)
.IP \[bu] 2
گزارش ۱ پتابایت فضای آزاد برای دیسک‌هایی با اندازه نامشخص (Nick Craig-Wood)
.IP \[bu] 2
نگاشت خطاهای بیشتر rclone به خطاهای سیستم فایل (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل ناپدید شدن شاخه کاری جاری (cwd) (Nick Craig-Wood)
.IP \[bu] 2
استفاده از ReaddirPlus در Windows برای بهبود کارایی فهرست‌کردن دایرکتوری‌ها
(Nick Craig-Wood)
.IP \[bu] 2
ارسال یک راهنما (hint) مبنی بر این‌که آیا سیستم فایل به بزرگ و کوچکی حروف حساس است یا خیر
(Nick Craig-Wood)
.IP \[bu] 2
افزودن دستور rc با عنوان \f[V]mount/types\f[R] (Nick Craig-Wood)
.IP \[bu] 2
تغییر حداکثر طول نام برگ (leaf name) به ۱۰۲۴ بایت (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
افزودن گزینه‌های \f[V]--vfs-read-wait\f[R] و \f[V]--vfs-write-wait\f[R] جهت
کنترل زمان انتظار برای خواندن/نوشتن ترتیبی (Nick Craig-Wood)
.IP \[bu] 2
تغییر مقدار پیش‌فرض \f[V]--vfs-read-wait\f[R] به 20ms (پیش از این 5ms بود و امکان
پیکربندی نداشت) (Nick Craig-Wood)
.IP \[bu] 2
سازگارتر کردن خروجی \f[V]df\f[R] در اتصال سوارشده rclone.
(Yves G)
.IP \[bu] 2
گزارش ۱ پتابایت فضای آزاد برای دیسک‌هایی با اندازه نامشخص (Nick Craig-Wood)
.IP \[bu] 2
رفع شرایط رقابتی ناشی از خواندن محافظت‌نشده (بدون قفل) Dir.path (Nick
Craig-Wood)
.IP \[bu] 2
جلوگیری از همپوشانی قفل File و قفل Dir جهت اجتناب از بن‌بست (Nick
Craig-Wood)
.IP \[bu] 2
پیاده‌سازی ترتیب‌بندی قفل‌ها بین File و Dir به منظور حذف کامل بن‌بست‌ها
(Nick Craig-Wood)
.IP \[bu] 2
انتقال حافظه موقت (cache) مربوط به vfs به بسته اختصاصی خود (Nick Craig-Wood)
.IP \[bu] 2
ثابت نگه‌داشتن (Pin) نمونه Fs در حال استفاده در حافظه موقت Fs (Nick Craig-Wood)
.IP \[bu] 2
افزودن متدهای SetSys() به Node به منظور امکان ذخیره موارد در حافظه موقت روی یک گره (Nick
Craig-Wood)
.IP \[bu] 2
نادیده‌گرفتن خطاهای عدم یافتن فایل از طرف Hash در Read.Release (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل توقف و عدم پاسخگویی (hang) در کد انتظار خواندن (Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
افزایش سرعت بارگیری‌های چندنخی با استفاده از فایل‌های پراکنده (sparse files) در Windows (Nick
Craig-Wood)
.IP \[bu] 2
پیاده‌سازی گزینه \f[V]--local-no-sparse\f[R] جهت غیرفعال‌سازی فایل‌های پراکنده
(Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی \f[V]rclone backend noop\f[R] برای اهداف آزمایشی (Nick
Craig-Wood)
.IP \[bu] 2
رفع خطاهای \[dq]file not found\[dq] در محاسبه Hash پس از انتقال
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Cache
.RS 2
.IP \[bu] 2
پیاده‌سازی دستور \f[V]rclone backend stats\f[R] (Nick Craig-Wood)
.IP \[bu] 2
اصلاح رونوشت سمت سرور (Server Side Copy) همراه با بارگذاری موقت (Brandon McNama)
.IP \[bu] 2
حذف توابع بلااستفاده (Lars Lehtonen)
.IP \[bu] 2
غیرفعال‌سازی آزمون‌های شرایط رقابتی تا زمان برطرف شدن مشکل bbolt (Nick Craig-Wood)
.IP \[bu] 2
انتقال متدهای استفاده‌شده برای آزمایش به فایل آزمون (greatroar)
.IP \[bu] 2
افزودن Pin و Unpin و جستجوی استانداردسازی‌شده (Nick Craig-Wood)
.IP \[bu] 2
استفاده از مسیر واردسازی مناسب go.etcd.io/bbolt (Robert-André Mauchin)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
محاسبه هش‌ها برای بارگذاری‌ها از دیسک محلی (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
این قابلیت امکان بارگذاری رمزگذاری‌شده در Jottacloud را بدون استفاده از دیسک محلی فراهم می‌کند
.IP \[bu] 2
این یعنی بارگذاری‌های رمزگذاری‌شده s3/b2 از این پس دارای هش خواهند بود
.RE
.IP \[bu] 2
افزودن دستورهای \f[V]rclone backend decode\f[R]/\f[V]encode\f[R] جهت بازتولید
کارایی \f[V]cryptdecode\f[R] (Anagh Kumar Baranwal)
.IP \[bu] 2
حذف رابط بلااستفاده Cipher به دلیل مبهم کردن ساختار کد (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
پیاده‌سازی جاری‌سازی فایل‌های با اندازه نامشخص، به طوری که \f[V]rcat\f[R] اکنون
پشتیبانی می‌شود (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی ادغام حافظه (memory pooling) برای کنترل مصرف حافظه (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینه \f[V]--azureblob-disable-checksum\f[R] (Nick Craig-Wood)
.IP \[bu] 2
تلاش مجدد در صورت مواجهه با خطای \f[V]InvalidBlobOrBlock\f[R] زیرا ممکن است نمایانگر مشکلات همزمانی بلوک‌ها باشد (Nick Craig-Wood)
.IP \[bu] 2
حذف متد بلااستفاده \f[V]Object.parseTimeString()\f[R] (Lars Lehtonen)
.IP \[bu] 2
رفع خطای دسترسی در SAS URL محدود شده به مخزن (container) (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Tim Gallant)
.IP \[bu] 2
نادیده گرفتن نشانگرهای دایرکتوری در ریشه نیز (Nick Craig-Wood)
.IP \[bu] 2
اجبار حروف کوچک برای SHA1 (Nick Craig-Wood)
.IP \[bu] 2
حذف \f[V]largeUpload.clearUploadURL()\f[R] استفاده‌نشده (Lars Lehtonen)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Tim Gallant)
.IP \[bu] 2
پیاده‌سازی About جهت خواندن اندازه مصرف‌شده (Nick Craig-Wood)
.IP \[bu] 2
افزودن تابع تمدید توکن برای احراز هویت jwt (David Bramwell)
.IP \[bu] 2
افزودن پشتیبانی از پوشه ریشه قابل تعویض برای بک‌اند Box (Sunil
Patra)
.IP \[bu] 2
حذف iat غیرضروری از ادعاهای jws (David)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
دنبال کردن میانبرها به‌طور پیش‌فرض، رد کردن با \f[V]--drive-skip-shortcuts\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی دستور \f[V]rclone backend shortcut\f[R] برای ایجاد
میانبرها (Nick Craig-Wood)
.IP \[bu] 2
افزودن دستور \f[V]rclone backend\f[R] برای تغییر
\f[V]service_account_file\f[R] و \f[V]chunk_size\f[R] (Anagh Kumar
Baranwal)
.IP \[bu] 2
رفع مشکل فایل‌های مفقود هنگام استفاده از \f[V]--fast-list\f[R] و
\f[V]--drive-shared-with-me\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع موارد تکراری هنگام استفاده از \f[V]--drive-shared-with-me\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
گسترش \f[V]--drive-stop-on-upload-limit\f[R] جهت پاسخ‌گویی به
\f[V]teamDriveFileLimitExceeded\f[R].
(harry)
.IP \[bu] 2
عدم حذف فایل‌های دارای والد چندگانه برای جلوگیری از دست رفتن داده‌ها (Nick
Craig-Wood)
.IP \[bu] 2
استفاده از توضیحات پیش‌فرض در کپی سمت سرور اسناد در صورت خالی بودن (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
مهلک ساختن خطای کمبود فضا (insufficient space) (harry)
.IP \[bu] 2
افزودن اطلاعات درباره redirect url مورد نیاز (Elan Ruusamäe)
.RE
.IP \[bu] 2
Fichier
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Tim Gallant)
.IP \[bu] 2
پیاده‌سازی pacer سفارشی برای مواجهه با نرخ محدودسازی جدید (buengese)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
رفع قفل شدن هنگام استفاده از حد همزمانی در اتصالات ناموفق (Nick
Craig-Wood)
.IP \[bu] 2
رفع قفل شدن در بارگذاری ناموفق هنگام استفاده از حد همزمانی (Nick
Craig-Wood)
.IP \[bu] 2
رفع قفل شدن در شکست‌های Close هنگام استفاده از حد همزمانی (Nick
Craig-Wood)
.IP \[bu] 2
دور زدن مشکل ارسال پیام‌های کاذب 150 توسط pureftp (Nick Craig-Wood)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن کلاس ذخیره‌سازی \f[V]ARCHIVE\f[R] به راهنما (Adam Stroud)
.IP \[bu] 2
نادیده گرفتن نشانگرهای دایرکتوری در ریشه (Nick Craig-Wood)
.RE
.IP \[bu] 2
Googlephotos
.RS 2
.IP \[bu] 2
امکان‌پذیر کردن پیکربندی سال شروع (Daven)
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Tim Gallant)
.IP \[bu] 2
ایجاد دایرکتوری feature/favorites (Brandon Philips)
.IP \[bu] 2
رفع خطای \[dq]concurrent map write\[dq] (Nick Craig-Wood)
.IP \[bu] 2
عدم قرار دادن تصویر در پیام خطا (Nick Craig-Wood)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
بهبود فهرست‌کردن دایرکتوری با قالب جدید برگرفته از پروژه Caddy
(calisro)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]--jottacloud-trashed-only\f[R] (buengese)
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Tim Gallant)
.IP \[bu] 2
استفاده از \f[V]RawURLEncoding\f[R] هنگام رمزگشایی توکن ورودِ کدگذاری‌شده با base64
(buengese)
.IP \[bu] 2
پیاده‌سازی پاک‌سازی (cleanup) (buengese)
.IP \[bu] 2
به‌روزرسانی مستندات درباره پاک‌سازی، حذف موارد باقی‌مانده از احراز هویت قدیمی و افزودن
هشدار درباره نقاط اتصال خاص.
(albertony)
.RE
.IP \[bu] 2
Mailru
.RS 2
.IP \[bu] 2
شرح الزامات احراز هویت دومرحله‌ای (2FA) (valery1707)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]--onedrive-server-side-across-configs\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Tim Gallant)
.IP \[bu] 2
رفع خطاهای گهگاهی 416 در بارگذاری‌های چندبخشی (Nick Craig-Wood)
.IP \[bu] 2
افزودن هشدار محدودیت حداکثر اندازه قطعه در مستندات (Harry)
.IP \[bu] 2
رفع مشکل مفقود شدن درایو در پیکربندی (Nick Craig-Wood)
.IP \[bu] 2
مهلک ساختن خطای \f[V]quotaLimitReached\f[R] (harry)
.RE
.IP \[bu] 2
Opendrive
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Tim Gallant)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از پوشه ریشه قابل تعویض برای بک‌اند pCloud (Sunil
Patra)
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Tim Gallant)
.IP \[bu] 2
رفع پیام \[dq]Auth state doesn\[aq]t match\[dq] در پیکربندی اولیه (Nick
Craig-Wood)
.RE.IP \[bu] 2
Premiumizeme
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Tim Gallant)
.IP \[bu] 2
پاک‌سازی توابع بلااستفاده (Lars Lehtonen)
.RE
.IP \[bu] 2
Putio
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Nick Craig-Wood)
.IP \[bu] 2
استفاده از rclone http Client برای بارگیری فایل‌ها (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل تجزیه ریموت‌های دارای / در ابتدا و انتها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Qingstor
.RS 2
.IP \[bu] 2
تنظیم \f[V]rclone cleanup\f[R] برای حذف بارگذاری‌های چندبخشی معلق قدیمی‌تر از ۲۴ ساعت (Nick Craig-Wood)
.IP \[bu] 2
تلاش بیشتر برای لغو بارگذاری‌های چندبخشی ناموفق (Nick Craig-Wood)
.IP \[bu] 2
پاک‌سازی \f[V]multiUploader.list()\f[R] (Lars Lehtonen)
.IP \[bu] 2
رفع خطاهای lint (Lars Lehtonen)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Tim Gallant)
.IP \[bu] 2
استفاده از استخر حافظه (memory pool) برای تخصیص بافرها (Maciej Zimnoch)
.IP \[bu] 2
افزودن پشتیبانی از SSE-C برای AWS، Ceph و MinIO (Jack Anderson)
.IP \[bu] 2
شکست سریع (fail fast) بارگذاری چندبخشی (Michał Matczuk)
.IP \[bu] 2
گزارش صحیح خطاها هنگام ایجاد باکت (mkdir) (Nick Craig-Wood)
.IP \[bu] 2
مشخص کردن اینکه Minio از کدگذاری URL در فهرست‌بندی‌ها پشتیبانی می‌کند (Nick Craig-Wood)
.IP \[bu] 2
افزودن 500 به‌عنوان retryErrorCode (Michał Matczuk)
.IP \[bu] 2
استفاده از \f[V]--low-level-retries\f[R] به‌عنوان تعداد تلاش‌های مجدد SDK
(Aleksandar Janković)
.IP \[bu] 2
رفع مشکل abort context در بارگذاری چندبخشی (Aleksandar Jankovic)
.IP \[bu] 2
جایگزینی متد منسوخ‌شده \f[V]session.New()\f[R] با
\f[V]session.NewSession()\f[R] (Lars Lehtonen)
.IP \[bu] 2
استفاده از پارامتر اندازه ارائه‌شده هنگام تخصیص یک استخر حافظه جدید
(Joachim Brandon LeBlanc)
.IP \[bu] 2
استفاده از تلاش‌های مجدد سطح پایین rclone به‌جای AWS SDK برای رفع مشکل تلاش‌های مجدد در فهرست‌بندی (Nick Craig-Wood)
.IP \[bu] 2
نادیده گرفتن نشانگرهای دایرکتوری در ریشه نیز (Nick Craig-Wood)
.IP \[bu] 2
استفاده از یک استخر حافظه واحد (Michał Matczuk)
.IP \[bu] 2
عدم تغییر اندازه buf هنگام قرار دادن در memBuf (Michał Matczuk)
.IP \[bu] 2
بهبود مستندات مربوط به \f[V]--s3-disable-checksum\f[R] (Nick Craig-Wood)
.IP \[bu] 2
جلوگیری از نشت حافظه یا توکن‌ها در شرایط مرزی هنگام بارگذاری چندبخشی (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Seafile
.RS 2
.IP \[bu] 2
پیاده‌سازی احراز هویت دومرحله‌ای (2FA) (Fred)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن \f[V]--sftp-pem-key\f[R] جهت پشتیبانی از فایل‌های کلید درون‌خطی (calisro)
.IP \[bu] 2
رفع مشکل شکست کپی‌های پس از انتقال با اندازه صفر هنگام استفاده از
\f[V]set_modtime=false\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Sharefile
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Tim Gallant)
.RE
.IP \[bu] 2
Sugarsync
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Tim Gallant)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال ظاهری در پیام خطا (Martin Michlmayr)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
پیاده‌سازی چندین ریموت قابل‌نوشتن (Max Sum)
.IP \[bu] 2
رفع مشکل کپی سمت سرور (server-side copy) (Max Sum)
.IP \[bu] 2
پیاده‌سازی ListR (Max Sum)
.IP \[bu] 2
فعال‌سازی ListR در حالتی که بالادست‌ها شامل محلی (local) باشند (Max Sum)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Tim Gallant)
.IP \[bu] 2
اصلاح هدر \f[V]X-OC-Mtime\f[R] جهت سازگاری با Transip (Nick
Craig-Wood)
.IP \[bu] 2
گزارش کامل و یکپارچه میزان مصرف با \f[V]about\f[R] (Yves G)
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--header-upload\f[R] و
\f[V]--header-download\f[R] (Tim Gallant)
.RE.SS v1.51.0 \- 2020-02-01
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
Memory (https://rclone.org/memory) (Nick Craig-Wood)
.IP \[bu] 2
Sugarsync (https://rclone.org/sugarsync) (Nick Craig-Wood)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
تنظیم همهٔ بک‌اندها برای داشتن پارامتر \f[V]--backend-encoding\f[R] (Nick
Craig-Wood)
.RS 2
.IP \[bu] 2
این قابلیت امکان تنظیم یا غیرفعال‌سازی کدگذاری برای نویسه‌های خاص را فراهم می‌کند
.RE
.IP \[bu] 2
افزودن پرچم \f[V]--max-duration\f[R] برای کنترل حداکثر مدت‌زمان یک نشست انتقال (boosh)
.IP \[bu] 2
افزودن پرچم \f[V]--expect-continue-timeout\f[R]، پیش‌فرض 1s (Nick
Craig-Wood)
.IP \[bu] 2
افزودن پرچم \f[V]--no-check-dest\f[R] برای رونوشت بدون بررسی مقصد (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی پرچم \f[V]--order-by\f[R] برای مرتب‌سازی انتقال‌ها (Nick Craig-Wood)
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
عدم نمایش موارد به‌طور هم‌زمان در transferring و checking (Nick
Craig-Wood)
.IP \[bu] 2
افزودن گزینه‌ای برای پاک کردن آمارها (Aleksandar Jankovic)
.RE
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
فشرده‌سازی ساخت‌های آزمایشی با gzip (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی چارچوبی برای راه‌اندازی سرورهای آزمایشی در حین آزمون‌ها (Nick
Craig-Wood)
.RE
.IP \[bu] 2
cmd: چاپ همیشگی زمان سپری‌شده با دقت دهم ثانیه در نوار پیشرفت (Gary
Kim)
.IP \[bu] 2
config
.RS 2
.IP \[bu] 2
افزودن \f[V]--password-command\f[R] برای مجاز کردن گذرواژهٔ پویای پیکربندی (Damon
Permezel)
.IP \[bu] 2
تعیین مقادیر پیش‌فرض برای پرسش‌های پیکربندی (Nick Craig-Wood)
.IP \[bu] 2
بررسی وجود یک ریموت هنگام ساخت ریموت جدید (Nick Craig-Wood)
.RE
.IP \[bu] 2
copyurl: افزودن پرچم \f[V]--stdout\f[R] برای نوشتن در stdout (Nick
Craig-Wood)
.IP \[bu] 2
dedupe: پیاده‌سازی نگه‌داری کوچک‌ترین (keep smallest) نیز (Nick Craig-Wood)
.IP \[bu] 2
hashsum: افزودن پرچم \f[V]--base64\f[R] (landall)
.IP \[bu] 2
lsf: افزایش سرعت روی s3/swift/غیره با عدم خواندن mimetype به‌صورت پیش‌فرض (Nick
Craig-Wood)
.IP \[bu] 2
lsjson: افزودن پرچم \f[V]--no-mimetype\f[R] (Nick Craig-Wood)
.IP \[bu] 2
rc: افزودن متدهایی برای فعال‌سازی پروفایلینگ مسدودسازی و mutex (Nick
Craig-Wood)
.IP \[bu] 2
rcd
.RS 2
.IP \[bu] 2
افزودن پارامتر group به stats (Chaitanya)
.IP \[bu] 2
جداسازی webgui؛ گزینه برای غیرفعال کردن مرورگر (Xiaoxing Ye)
.RE
.IP \[bu] 2
serve sftp: افزودن پشتیبانی از کلید عمومی همراه با پروکسی احراز هویت (Paul Tinsley)
.IP \[bu] 2
stats: نمایش موارد حذفی در آمار و پنهان‌سازی آمارهای صفر (anuar45)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
رفع شمارش چندباره توسط شمارندهٔ خطاها (Ankur Gupta)
.IP \[bu] 2
رفع نمایش تعداد خطاها به عنوان بررسی‌ها (Cnly)
.IP \[bu] 2
پاک‌سازی انتقال‌های پایان‌یافته در stats-reset (Maciej Zimnoch)
.IP \[bu] 2
افزودن قفل‌گذاری StatsInfo در تابع مجموع statsGroups (Michał Matczuk)
.RE
.IP \[bu] 2
asyncreader: رفع خطای EOF (buengese)
.IP \[bu] 2
check: رفع پیمایش بازگشتی بیش از نیاز دایرکتوری‌ها توسط \f[V]--one-way\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
chunkedreader: غیرفعال‌سازی محاسبهٔ هش برای بخش نخست (Nick
Craig-Wood)
.IP \[bu] 2
config
.RS 2
.IP \[bu] 2
عدم باز کردن مرورگر در حالت بدون سر (headless) برای drive/gcs/google photos (Xiaoxing Ye)
.IP \[bu] 2
نادیده گرفتن خطا در SetValueAndSave در صورتی که بخش پیکربندی هنوز وجود ندارد
(buengese)
.RE
.IP \[bu] 2
cmd: رفع مشکل کامل‌سازی با یک پیکربندی رمزنگاری‌شده (Danil Semelenov)
.IP \[bu] 2
dbhashsum: جلوگیری از بازگرداندن UNSUPPORTED در dropbox (Nick Craig-Wood)
.IP \[bu] 2
dedupe: افزودن حالت‌های ناموجود به رشتهٔ راهنما (Nick Craig-Wood)
.IP \[bu] 2
operations
.RS 2
.IP \[bu] 2
رفع ادامه کار dedupe هنگام بروز خطاهایی مانند insufficientFilePersimmon
(SezalAgrawal)
.IP \[bu] 2
پاک‌سازی accounting پیش از تلاش مجدد سطح پایین (Maciej Zimnoch)
.IP \[bu] 2
نوشتن پیام اشکال‌زدایی هنگامی که هش‌ها بررسی‌پذیر نبودند (Ole Schütt)
.IP \[bu] 2
انتقال بررسی نوع رابط (interface assertion) به آزمون‌ها برای حذف وابستگی به pflag (Nick
Craig-Wood)
.IP \[bu] 2
عمومی کردن NewOverrideObjectInfo و بازآرایی کاربردهای آن (Nick Craig-Wood)
.RE
.IP \[bu] 2
proxy: جایگزینی استفاده از bcrypt با sha256 (Nick Craig-Wood)
.IP \[bu] 2
vendor
.RS 2
.IP \[bu] 2
به‌روزرسانی bazil.org/fuse برای رفع مشکل FreeBSD 12.1 (Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی github.com/t3rm1n4l/go-mega برای رفع mega \[dq]illegal base64 data
at input byte 22\[dq] (Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی termbox-go برای رفع دستور ncdu در FreeBSD (Kuang-che Wu)
.IP \[bu] 2
به‌روزرسانی t3rm1n4l/go-mega \- رفع mega: couldn\[aq]t login: crypto/aes:
invalid key size 0 (Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
فعال‌سازی خواندن ناهمگام برای ۲۰٪ افزایش سرعت (Nick Craig-Wood)
.IP \[bu] 2
جایگزینی استفاده از WriteAt با Write برای cache mode >= writes و O_APPEND
(Brett Dutro)
.IP \[bu] 2
اطمینان از فراخوانی unmount در هنگام خروج (Nick Craig-Wood)
.IP \[bu] 2
عدم ساخت روی go1.10 به دلیل توقف پشتیبانی bazil/fuse از آن (Nick
Craig-Wood)
.IP \[bu] 2
نادیده گرفتن تاریخ‌های خارج از محدوده هنگام تنظیم تاریخ‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2.IP \[bu] 2
افزودن مستقیم فایل تازه ایجادشده به دایرکتوری (Nick Craig-Wood)
.IP \[bu] 2
محاسبه تنها یک هش برای خواندن‌ها جهت افزایش سرعت (Nick Craig-Wood)
.IP \[bu] 2
بهبود کارکرد ReadAt برای فایل‌های کَش‌نشده در خواندن‌های غیرمتوالی (Nick Craig-Wood)
.IP \[bu] 2
رفع حالت‌های خاص هنگام خواندن ModTime از فایل (Nick Craig-Wood)
.IP \[bu] 2
اطمینان از نمایش اندازه صحیح فایل‌های موجودِ بازشده برای نوشتن (Nick Craig-Wood)
.IP \[bu] 2
کَش نکردن مسیر در اشیاء فایلی RW جهت اصلاح تغییر نام (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل تغییر نام فایل‌های باز هنگام استفاده از کَش VFS (Nick Craig-Wood)
.IP \[bu] 2
تغییر نام مورد مربوطه در حافظه هنگام تغییر نام فایل‌ها در کَش (Nick Craig-Wood)
.IP \[bu] 2
اصلاح تغییر نام فایل‌های باز در drive هنگام استفاده از \f[V]--vfs-cache-mode writes\f[R] (Nick Craig-Wood)
.IP \[bu] 2
اصلاح modtime نادرست برای انتقال (mv) به داخل mount با \f[V]--vfs-cache-modes writes\f[R] (Nick Craig-Wood)
.IP \[bu] 2
هنگام تغییر نام، در صورت وجود فایل، نام آن در کَش نیز تغییر یابد (Anagh Kumar Baranwal)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
تبدیل خطاهای در حال به‌روزرسانی بودن فایل مبدأ به خطاهای NoLowLevelRetry (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل به‌روزرسانی فایل‌های پنهان در Windows (Nick Craig-Wood)
.RE
.IP \[bu] 2
Cache
.RS 2
.IP \[bu] 2
همگام‌سازی با جابه‌جایی کتابخانه بالادستی از github.com/coreos/bbolt به github.com/etcd-io/bbolt (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای \f[V]fatal error: concurrent map writes\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
مرتب‌سازی دوباره گزینه‌های رمزنگاری نام فایل (Thomas Eales)
.IP \[bu] 2
مدیریت صحیح نقطه در پایان نام (buengese)
.RE
.IP \[bu] 2
Chunker
.RS 2
.IP \[bu] 2
کاهش طول پسوند موقت (Ivan Andreev)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--drive-stop-on-upload-limit\f[R] برای متوقف کردن همگام‌سازی پس از رسیدن به حد بارگذاری (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--drive-use-shared-date\f[R] جهت استفاده از تاریخ هم‌رسانی فایل به‌جای تاریخ ویرایش (Garry McNulty)
.IP \[bu] 2
اطمینان از گزارش همیشگی خطا در احراز هویت نامعتبر برای teamdrives (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل \f[V]--fast-list\f[R] هنگام استفاده از appDataFolder (Nick Craig-Wood)
.IP \[bu] 2
استفاده از بارگذاری‌های چندبخشی با قابلیت ادامه (resumable) برای استریم و بارگذاری‌ها در mount (Nick Craig-Wood)
.IP \[bu] 2
ثبت گزارش خطای ERROR در صورت بازگشت جست‌وجوی ناقص (Nick Craig-Wood)
.IP \[bu] 2
پنهان کردن پیکربندی‌های خطرناک از بخش پیکربندی (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
در نظر گرفتن خطاهای \f[V]insufficient_space\f[R] به عنوان خطاهای غیرقابل تلاش مجدد (Nick Craig-Wood)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
استفاده از روش احراز هویت جدید مورد استفاده در کلاینت رسمی (buengese)
.IP \[bu] 2
افزودن URL برای ایجاد Login Token به دستیار پیکربندی (Nick Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی از نسخه‌های whitelabel (buengese)
.RE
.IP \[bu] 2
Koofr
.RS 2
.IP \[bu] 2
استفاده از کلاینت HTTP اختصاصی rclone (jaKa)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
افزودن مجوز Sites.Read.All (Benjamin Richter)
.IP \[bu] 2
افزودن پشتیبانی از سرآیند \[dq]Retry-After\[dq] (Motonori IWAMURO)
.RE
.IP \[bu] 2
Opendrive
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]--opendrive-chunk-size\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
پیاده‌سازی مجدد بارگذاری چندبخشی جهت رفع مشکلات حافظه (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--s3-copy-cutoff\f[R] برای تعیین اندازه سوئیچ به کپی چندبخشی (Nick Craig-Wood)
.IP \[bu] 2
افزودن منطقه جدید Asia Pacific (Hong Kong) (Outvi V)
.IP \[bu] 2
کاهش مصرف حافظه هنگام استریم فایل‌ها با کاهش حداکثر اندازه بارگذاری استریم (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینه \f[V]--s3-list-chunk\f[R] برای فهرست‌بندی bucket (Thomas Kriechbaumer)
.IP \[bu] 2
غیرفعال‌سازی اجباری دسترسی bucket به روش path style به دلیل منسوخ‌شدن در AWS (Nick Craig-Wood)
.IP \[bu] 2
استفاده از AWS web identity role provider در صورت در دسترس بودن (Tennix)
.IP \[bu] 2
افزودن پشتیبانی از StackPath Object Storage (Dave Koston)
.IP \[bu] 2
اصلاح مقدار ExpiryWindow (Aleksandar Jankovic)
.IP \[bu] 2
اصلاح شرط DisableChecksum (Aleksandar Janković)
.IP \[bu] 2
اصلاح رمزگشایی URL برای NextMarker (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن \f[V]--sftp-skip-links\f[R] جهت صرف‌نظر از پیوندهای نمادین و فایل‌های غیرعادی (Nick Craig-Wood)
.IP \[bu] 2
تلاش مجدد برای برقراری اتصال (Sebastian Brandt)
.IP \[bu] 2
رفع خطای \[dq]failed to parse private key file: ssh: not an encrypted key\[dq] (Nick Craig-Wood)
.IP \[bu] 2
باز کردن فایل‌ها برای به‌روزرسانی به صورت فقط‌نوشتنی جهت سازگاری با AWS SFTP (Nick Craig-Wood)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
نگه‌داری بخش‌های شیء بزرگ پویا هنگام حذف اشیاء در container با نسخه‌بندی فعال (Nguyễn Hữu Luân)
.IP \[bu] 2
اصلاح تجزیه X-Object-Manifest (Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی endpoint مربوط به OVH API (unbelauscht)
.RE
.IP \[bu] 2
WebDAV
.RS 2.IP \[bu] 2
تنظیم nextcloud به بارگذاری صرفاً چک‌سام‌های SHA1 (Nick Craig-Wood)
.IP \[bu] 2
اصلاح بزرگی و کوچکی حروف \[dq]Bearer\[dq] در سرآیند :Authorization برای مطابقت با RFC
(Nick Craig-Wood)
.IP \[bu] 2
افزودن سرآیند Referer جهت رفع مشکلات مربوط به WAFها (Nick Craig-Wood)
.RE
.SS v1.50.2 - 2019-11-19
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting: رفع نشت حافظه در عملیات تلاش مجدد (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
رفع مشکل فهرست کردن دایرکتوری ریشه با محدوده کاری drive.files (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل --drive-root-folder-id با درایوهای اشتراکی/تیمی (Nick Craig-Wood)
.RE
.SS v1.50.1 - 2019-11-02
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
hash: رفع تغییر تصادفی نام هش‌ها برای \f[V]DropboxHash\f[R] و
\f[V]CRC-32\f[R] (Nick Craig-Wood)
.IP \[bu] 2
fshttp: رفع گزارش خطا برای خطاهای سطل توکن در tpslimit (Nick
Craig-Wood)
.IP \[bu] 2
fshttp: عدم چاپ خطاهای سطل توکن هنگام لغو شدن context (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع مشکل فهرست کردن .
در Windows (Nick Craig-Wood)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
رفع مشکل DirMove/Move پس از تغییر Onedrive (Xiaoxing Ye)
.RE
.SS v1.50.0 - 2019-10-26
.IP \[bu] 2
پس‌اندهای جدید
.RS 2
.IP \[bu] 2
Citrix Sharefile (https://rclone.org/sharefile) (Nick Craig-Wood)
.IP \[bu] 2
Chunker (https://rclone.org/chunker) \- یک پس‌اند لایه‌ای برای تقسیم
فایل‌ها به بخش‌های کوچک‌تر (Ivan Andreev)
.IP \[bu] 2
Mail.ru Cloud (https://rclone.org/mailru) (Ivan Andreev)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
encodings (Fabian Möller & Nick Craig-Wood)
.RS 2
.IP \[bu] 2
همه پس‌اندها اکنون از کدگذاری نام فایل استفاده می‌کنند تا تضمین شود هر نام فایلی می‌تواند
روی هر پس‌اندی نوشته شود.
.IP \[bu] 2
برای اطلاعات بیشتر، مستندات نام‌های فایل
محدودشده (https://rclone.org/overview/#restricted-filenames)
و مستندات پس‌اند local را ببینید.
.IP \[bu] 2
اگر در نام‌ها از نویسه‌های کنترلی یا نمادهای تمام‌عرض یونیکد
(FULLWIDTH) (https://en.wikipedia.org/wiki/Halfwidth_and_Fullwidth_Forms_(Unicode_block))
استفاده می‌کنید، ممکن است برخی نام‌های فایل در rclone متفاوت به نظر برسند.
.RE
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
به‌روزرسانی برای استفاده از go1.13 جهت ساخت (Nick Craig-Wood)
.IP \[bu] 2
حذف پشتیبانی از go1.9 (Nick Craig-Wood)
.IP \[bu] 2
ساخت rclone با GitHub actions (Nick Craig-Wood)
.IP \[bu] 2
تبدیل اسکریپت‌های python به python3 (Nick Craig-Wood)
.IP \[bu] 2
جایگزینی Azure/go-ansiterm با mattn/go-colorable (Nick Craig-Wood)
.IP \[bu] 2
اصلاحات Dockerfile (Matei David)
.IP \[bu] 2
افزودن پشتیبانی از پلاگین
(https://github.com/rclone/rclone/blob/master/CONTRIBUTING.md#writing-a-plugin)
برای پس‌اندها و دستورها (Richard Patel)
.RE
.IP \[bu] 2
config
.RS 2
.IP \[bu] 2
استفاده متناوب از قرمز/سبز در config جهت وضوح بیشتر (Nick
Craig-Wood)
.RE
.IP \[bu] 2
contrib
.RS 2
.IP \[bu] 2
افزودن مانیفست نمونه Docker Compose برای سرور DLNA.
(pataquets)
.IP \[bu] 2
افزودن مانیفست نمونه Docker Compose برای سرور WebDAV.
(pataquets)
.RE
.IP \[bu] 2
copyurl
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--auto-filename\f[R] برای استفاده از نام فایل برگرفته از URL در
مسیر مقصد (Denis)
.RE
.IP \[bu] 2
serve dlna:
.RS 2
.IP \[bu] 2
بهبودهای فراوان در سازگاری (Dan Walters)
.IP \[bu] 2
پشتیبانی از زیرنویس‌های خارجی srt (Dan Walters)
.RE
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن دستور core/quit (Saksham Khanna)
.RE
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
sync
.RS 2
.IP \[bu] 2
جلوگیری از انتقال فایل‌هایی که تغییر نکرده‌اند توسط \f[V]--update\f[R]/\f[V]-u\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
آزادسازی اشیاء پس از خروج از لوله انتقال جهت صرفه‌جویی در حافظه
(Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل پویش بازگشتی در \f[V]--files-from without --no-traverse\f[R]
(Nick Craig-Wood)
.RE
.IP \[bu] 2
operations
.RS 2
.IP \[bu] 2
رفع محاسبه آمار برای کپی‌های سمت سرور (Nick Craig-Wood)
.IP \[bu] 2
نمایش \[aq]All duplicates removed\[aq] تنها در صورت موفقیت‌آمیز بودن dedupe
(Sezal Agrawal)
.IP \[bu] 2
نمایش \[aq]Deleted X extra copies\[aq] تنها در صورت موفقیت‌آمیز بودن dedupe
(Sezal Agrawal)
.RE
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
محدود کردن فهرست accounting به حداکثر ۱۰۰ انتقال تکمیل‌شده جهت صرفه‌جویی در
حافظه (Nick Craig-Wood)
.IP \[bu] 2
حذف بازه‌های زمانی قدیمی در صورت امکان جهت صرفه‌جویی در حافظه (Nick Craig-Wood)
.IP \[bu] 2
رفع panic ناشی از fallback کپی سمت سرور (Ivan Andreev)
.IP \[bu] 2
رفع نشت حافظه مشهود هنگام انتقال تعداد زیادی شیء
(Nick Craig-Wood).IP \[bu] 2
رفع اشکال در محاسبهٔ کل مدت زمان (Nick Craig-Wood)
.RE
.IP \[bu] 2
cmd
.RS 2
.IP \[bu] 2
رفع مشکل مقداردهی نشدن پرچم‌های خط فرمان از طریق متغیرهای محیطی (Nick
Craig-Wood)
.IP \[bu] 2
سازگار کردن تکمیل خودکار با حالت posix در bash برای macOS (Danil
Semelenov)
.IP \[bu] 2
فعال‌سازی کارکرد \f[V]--progress\f[R] در git bash روی Windows (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای \[aq]compopt: command not found\[aq] هنگام تکمیل خودکار در macOS (Danil
Semelenov)
.RE
.IP \[bu] 2
config
.RS 2
.IP \[bu] 2
رفع اشکال در تنظیم پرچم‌های غیرسطح‌بالا از متغیرهای محیطی (Nick
Craig-Wood)
.IP \[bu] 2
بررسی دقیق‌تر نام‌های پیکربندی و گزارش خطاها (Nick Craig-Wood)
.IP \[bu] 2
حذف خطای: can\[aq]t use \f[V]--size-only\f[R] and
\f[V]--ignore-size\f[R] together.
(Nick Craig-Wood)
.RE
.IP \[bu] 2
filter: جلوگیری از ترکیب گزینه‌ها هنگام استفاده از \f[V]--files-from\f[R]
(Michele Caci)
.IP \[bu] 2
serve sftp: رفع فروپاشی (crash) در عملیات‌های پشتیبانی‌نشده (مانند
Readlink) (Nick Craig-Wood)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
امکان خواندن صحیح فایل‌های با اندازهٔ نامشخص (Nick Craig-Wood)
.IP \[bu] 2
نادیده گرفتن آزمون‌ها روی <= 2 پردازنده برای جلوگیری از قفل شدن (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای بحرانی (panic) در File.Open (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال \[dq]mount_fusefs: -o timeout=: option not supported\[dq] در FreeBSD
(Nick Craig-Wood)
.IP \[bu] 2
عدم ارسال نام‌فایل‌های بسیار بزرگ (>4k) به FUSE به دلیل عدم توانایی در رسیدگی به آن‌ها (Nick
Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--vfs-case-insensitive\f[R] برای سوار کردن‌های Windows/macOS (Ivan
Andreev)
.IP \[bu] 2
امکان‌پذیر کردن خواندن اشیاء با اندازهٔ نامشخص از طریق VFS (Nick Craig-Wood)
.IP \[bu] 2
انتقال بازنویسی (writeback) داده‌های تغییریافته از تابع close() به متد اختصاصی خودش
(FlushWrites) و حذف فراخوانی close() از Flush() (Brett Dutro)
.IP \[bu] 2
جلوگیری از ناپدید شدن دایرکتوری‌های خالی هنگام تغییر نام در ریموت‌های مبتنی بر باکت (Nick
Craig-Wood)
.IP \[bu] 2
جلوگیری از پاک‌سازی بیش از حد حافظهٔ موقت دایرکتوری توسط نظرسنجی اعلان تغییرات (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
غیرفعال‌سازی ثبت گزارش در وقایع‌نگار ویندوز (Windows event log) (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
حذف پیشوند \f[V]unverified:\f[R] در sha1 جهت بهبود سازگاری (مثلاً
با CyberDuck) (Nick Craig-Wood)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
افزودن گزینه‌هایی برای دریافت توکن دسترسی از طریق احراز هویت JWT (David)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
غیرفعال‌سازی پیش‌فرض HTTP/2 جهت دور زدن مشکلات INTERNAL_ERROR (Nick
Craig-Wood)
.IP \[bu] 2
اطمینان از استاندارد (canonical) بودن همیشگی شناسهٔ ریشهٔ drive (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال \f[V]--drive-shared-with-me\f[R] از ریشه همراه با ls و
\f[V]--fast-list\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال نظرسنجی ChangeNotify برای درایوهای اشتراکی (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال نظرسنجی اعلان تغییرات هنگام استفاده از appDataFolder (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
عدم تلاش مجدد برای خطاهای نام‌فایل‌های غیرمجاز (Nick Craig-Wood)
.IP \[bu] 2
رفع استثنای اشاره‌گر تهی (nil pointer) در فایل‌های محدودشده (Nick Craig-Wood)
.RE
.IP \[bu] 2
Fichier
.RS 2
.IP \[bu] 2
رفع اشکال دسترسی به فایل‌های بزرگ‌تر از ۲ گیگابایت در سامانه‌های ۳۲ بیتی (Nick Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
امکان غیرفعال‌سازی حالت EPSV (Jon Fautley)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
ارسال موازی درخواست‌های HEAD برای مدخل‌های دایرکتوری به منظور افزایش سرعت (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--http-no-head\f[R] جهت جلوگیری از ارسال درخواست‌های HEAD توسط rclone در فهرست‌بندی‌ها (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Putio
.RS 2
.IP \[bu] 2
افزودن امکان ازسرگیری بارگذاری‌ها (Cenk Alti)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع اشکال سرآیندهای v2_auth در امضا (Anthony Rusdi)
.IP \[bu] 2
رفع اشکال کدگذاری نویسه‌های کنترلی (Nick Craig-Wood)
.IP \[bu] 2
درخواست فهرست دایرکتوری به‌صورت URL-encoded تنها در صورت نیاز در Ceph
(Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینه‌ای برای رفتار در زمان شکست multipart (Aleksandar Jankovic)
.IP \[bu] 2
پشتیبانی از کپی چندبخشی (multipart copy) (庄天翼)
.IP \[bu] 2
رفع اشکال ارجاع اشاره‌گر تهی در صورت بازنگشتن فراداده برای شیء (Nick
Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
رفع مشکل تلاش \f[V]--sftp-ask-password\f[R] برای ارتباط با ssh-agent (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل هش فایل‌های حاوی بک‌اسلش (Nick Craig-Wood)
.IP \[bu] 2
گنجاندن رمزهای بیشتر با \f[V]--sftp-use-insecure-cipher\f[R] (Carlos
Ferreyra)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
تجزیه و بازگرداندن پاسخ خطای Sharepoint (Henning Surmeier)
.RE.SS v1.49.5 \- 2019-10-05
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
بازگشت به go1.12.x برای بیلد‌های v1.49.x به دلیل بروز مشکل در go1.13.x (Nick Craig-Wood)
.IP \[bu] 2
اصلاح بسته‌های rpm با استفاده از بیلد‌های master ابزار nfpm (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل ساخت macOS پس از تغییرات brew (Nick Craig-Wood)
.RE
.SS v1.49.4 \- 2019-09-29
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
cmd/rcd: برطرف کردن آسیب‌پذیری ZipSlip (Richard Patel)
.IP \[bu] 2
accounting: رفع نشت دستگیره فایل هنگام بروز خطا (Nick Craig-Wood)
.IP \[bu] 2
oauthutil: رفع مشکل امنیتی هنگام اجرا با دو کاربر روی یک ماشین یکسان (Nick Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
رفع مشکل فهرست کردن ریشه خالی که خطای error dir not found برمی‌گرداند (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
اصلاح SetModTime روی اشیاء GLACIER/ARCHIVE و پیاده‌سازی set/get tier (Nick Craig-Wood)
.RE
.SS v1.49.3 \- 2019-09-15
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
اصلاح محاسبه مدت زمان کل (Aleksandar Jankovic)
.IP \[bu] 2
رفع خطای \[dq]file already closed\[dq] هنگام تلاش مجدد برای انتقال (Nick Craig-Wood)
.RE
.RE
.SS v1.49.2 \- 2019-09-08
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
build: افزودن پشتیبانی از گردش‌کار Docker (Alfonso Montero)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting: اصلاح قفل‌گذاری در Transfer جهت جلوگیری از بن‌بست با \f[V]--progress\f[R] (Nick Craig-Wood)
.IP \[bu] 2
docs: اصلاح آرگومان الگو برای mktemp در install.sh (Cnly)
.IP \[bu] 2
operations: رفع مشکل \f[V]-u\f[R]/\f[V]--update\f[R] با google photos / فایل‌های با اندازه نامشخص (Nick Craig-Wood)
.IP \[bu] 2
rc: اصلاح مستندات برای config/create /update /password (Nick Craig-Wood)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
رفع نیاز به دسترسی‌های سطح بالا در SetModTime (Nick Craig-Wood)
.RE
.SS v1.49.1 \- 2019-08-28
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
config: رفع مشکل ذخیره گذرواژه‌های تولیدشده به صورت گذرواژه خالی (Nick Craig-Wood)
.IP \[bu] 2
rcd: افزودن پارامتر جاافتاده برای گزارش‌های اطلاعاتی web-gui. (Chaitanya)
.RE
.IP \[bu] 2
Googlephotos
.RS 2
.IP \[bu] 2
رفع کرش در پاسخ خطا (Nick Craig-Wood)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
رفع کرش در پاسخ خطا (Nick Craig-Wood)
.RE.SS v1.49.0 - 2019-08-26
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
1fichier (https://rclone.org/fichier) (Laura Hausmann)
.IP \[bu] 2
Google Photos (https://rclone.org/googlephotos) (Nick Craig-Wood)
.IP \[bu] 2
Putio (https://rclone.org/putio) (Cenk Alti)
.IP \[bu] 2
premiumize.me (https://rclone.org/premiumizeme) (Nick Craig-Wood)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
رابط کاربری وب آزمایشی (https://rclone.org/gui) (Chaitanya Bankanhal)
.IP \[bu] 2
پیاده‌سازی \f[V]--compare-dest\f[R] و \f[V]--copy-dest\f[R] (yparitcher)
.IP \[bu] 2
پیاده‌سازی \f[V]--suffix\f[R] بدون \f[V]--backup-dir\f[R] برای پشتیبان‌گیری
در دایرکتوری جاری (yparitcher)
.IP \[bu] 2
دستور \f[V]config reconnect\f[R] برای ورود مجدد (اجرای دوباره ورود با oauth)
به بک‌اند.
(Nick Craig-Wood)
.IP \[bu] 2
دستور \f[V]config userinfo\f[R] برای مشخص کردن کاربری که در حال حاضر با آن
وارد شده‌اید.
(Nick Craig-Wood)
.IP \[bu] 2
دستور \f[V]config disconnect\f[R] برای قطع اتصال (خروج) از
بک‌اند.
(Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--use-json-log\f[R] برای ثبت وقایع در قالب JSON (justinalin)
.IP \[bu] 2
افزودن انتشار زمینه (context propagation) به rclone (Aleksandar Jankovic)
.IP \[bu] 2
بازطراحی رابط‌های آماری داخلی برای همخوانی با کارهای rc
(Aleksandar Jankovic)
.IP \[bu] 2
افزودن واحدهای بزرگ‌تر برای زمان تقریبی اتمام (ETA) (AbelThar)
.IP \[bu] 2
به‌روزرسانی لوگوهای rclone با طراحی جدید (Andreas Chlupka)
.IP \[bu] 2
در hash: افزودن پشتیبانی از CRC-32 (Cenk Alti)
.IP \[bu] 2
در help showbackend: رفع مشکل دسته‌بندی گزینه‌های پیشرفته در زمانی
که گزینه‌های استاندارد وجود ندارند (buengese)
.IP \[bu] 2
در ncdu: نمایش/کپی مسیر جاری در حافظه کلیپ‌بورد (Gary Kim)
.IP \[bu] 2
عملیات‌ها (operations):
.RS 2
.IP \[bu] 2
اجرای موازی عملیات‌های محاسبه هش (Nick Craig-Wood)
.IP \[bu] 2
عدم محاسبه چکسام‌ها هنگام استفاده از \f[V]--ignore-checksum\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
بررسی هش‌های انتقال هنگام استفاده از حالت \f[V]--size-only\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
غیرفعال‌سازی کپی چندنخی برای کپی‌های محلی به محلی (Nick Craig-Wood)
.IP \[bu] 2
ثبت گزارش اشکال‌زدایی هش‌های موفق علاوه بر ناموفق‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن امکان توقف کارهای ناهمگام (async) (Aleksandar Jankovic)
.IP \[bu] 2
بازگرداندن تنظیمات جاری در صورت فراخوانی core/bwlimit بدون آرگومان (Nick
Craig-Wood)
.IP \[bu] 2
یکپارچه‌سازی Rclone-WebUI با rclone (Chaitanya Bankanhal)
.IP \[bu] 2
افزودن پارامتر خط فرمان برای کنترل اشتراک منابع میان‌مبدأیی
(CORS) در rcd.
(بهبود امنیتی) (Chaitanya Bankanhal)
.IP \[bu] 2
افزودن برچسب‌های لنگر به مستندات جهت سازگاری پیوندها (Nick Craig-Wood)
.IP \[bu] 2
حذف کلید _async از پارامترهای ورودی پس از تجزیه برای جلوگیری از
تداخل در عملیات‌های بعدی (buengese)
.IP \[bu] 2
افزودن فراخوانی برای پاک‌کردن آمارها (Aleksandar Jankovic)
.RE
.IP \[bu] 2
rcd
.RS 2
.IP \[bu] 2
ورود خودکار برای رابط کاربری وب (Chaitanya Bankanhal)
.IP \[bu] 2
پیاده‌سازی \f[V]--baseurl\f[R] برای rcd و رابط کاربری وب (Chaitanya Bankanhal)
.RE
.IP \[bu] 2
serve dlna
.RS 2
.IP \[bu] 2
انتخاب انحصاری رابط‌هایی با قابلیت مالتی‌کست برای SSDP (Nick Craig-Wood)
.IP \[bu] 2
افزودن انواع mime داخلی بیشتر برای پوشش استانداردهای صوتی/تصویری (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل انواع mime مفقود در Android که باعث ناپدید شدن ویدیوها می‌شد (Nick
Craig-Wood)
.RE
.IP \[bu] 2
serve ftp
.RS 2
.IP \[bu] 2
بازطراحی کد برای یکپارچگی با سایر دستورات serve (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی \f[V]--auth-proxy\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
در serve http: پیاده‌سازی \f[V]--baseurl\f[R] (Nick Craig-Wood)
.IP \[bu] 2
در serve restic: پیاده‌سازی \f[V]--baseurl\f[R] (Nick Craig-Wood)
.IP \[bu] 2
serve sftp
.RS 2
.IP \[bu] 2
پیاده‌سازی پراکسی احراز هویت (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال در تشخیص مجاز بودن سرور (Nick Craig-Wood)
.RE
.IP \[bu] 2
serve webdav
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]--baseurl\f[R] (Nick Craig-Wood)
.IP \[bu] 2
پشتیبانی از \f[V]--auth-proxy\f[R] (Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
تبدیل خطای \[dq]bad record MAC\[dq] به خطای قابل تلاش مجدد (Nick Craig-Wood)
.IP \[bu] 2
در copyurl: رفع مشکل کپی فایل‌هایی که خطای HTTP برمی‌گردانند (Nick Craig-Wood)
.IP \[bu] 2
در march: رفع مشکل بررسی زیردایرکتوری‌ها هنگام استفاده از \f[V]--no-traverse\f[R]
(buengese)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
رفع مشکل غیرقابل unmarshal بودن http.AuthFn در گزینه‌ها و اضافه کردن آزمون
بررسی صحت marshal (Nick Craig-Wood)
.IP \[bu] 2
انتقال پرچم‌های انقضای کار به rc جهت رفع مشکل مقداردهی اولیه (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل \f[V]--loopback\f[R] هنگام استفاده با rc/list و موارد دیگر (Nick Craig-Wood)
.RE
.IP \[bu] 2
در rcat: رفع مشکل افت سرعت در سیستم‌های دارای هش‌های چندگانه (Nick Craig-Wood)
.IP \[bu] 2
در rcd: رفع مشکلات دسترسی روی دایرکتوری حافظه موقت (cache) هنگام بارگیری
رابط وب (Nick Craig-Wood)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
تنظیم مقدار پیش‌فرض \f[V]--daemon-timeout\f[R] روی ۱۵ دقیقه در macOS و FreeBSD
(Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی مستندات جهت اعلام مجاز بودن سوار کردن از ریشه در سیستم‌های
مبتنی بر باکت (Nick Craig-Wood)
.IP \[bu] 2
حذف پرچم nonseekable از فایل‌های نوشتاری (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2.IP \[bu] 2
کارآمدتر کردن نوشتن بدون کَش (Nick Craig-Wood)
.IP \[bu] 2
رفع نادیده گرفتن فایل‌های کَش‌شده در \f[V]--vfs-cache-mode minimal\f[R] و \f[V]writes\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
افزودن \f[V]--local-case-sensitive\f[R] و
\f[V]--local-case-insensitive\f[R] (Nick Craig-Wood)
.IP \[bu] 2
جلوگیری از آلوده کردن page cache هنگام بارگذاری فایل‌های محلی به backendهای دوردست
(Michał Matczuk)
.IP \[bu] 2
عدم محاسبهٔ هیچ هشی به‌طور پیش‌فرض (Nick Craig-Wood)
.IP \[bu] 2
اجرای فراخوان سیستمی Fadvise روی یک go routine اختصاصی (Michał Matczuk)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
پشتیبانی از Azure Storage Emulator (Sandeep)
.IP \[bu] 2
به‌روزرسانی جزئیات راهنمای پیکربندی جهت حذف ارجاعات connection string
(Sandeep)
.IP \[bu] 2
امکان کارکرد تمام عملیات‌ها از ریشه (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
پیاده‌سازی اشتراک‌گذاری پیوند (yparitcher)
.IP \[bu] 2
فعال‌سازی server-side copy جهت کپی میان باکت‌ها (Nick Craig-Wood)
.IP \[bu] 2
امکان کارکرد تمام عملیات‌ها از ریشه (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
رفع مشکل server-side copy برای فایل‌های بزرگ (Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی API جهت استفاده در teamdrive (Nick Craig-Wood)
.IP \[bu] 2
افزودن خطا برای purge همراه با \f[V]--drive-trashed-only\f[R] (ginvine)
.RE
.IP \[bu] 2
Fichier
.RS 2
.IP \[bu] 2
تبدیل نوع FolderID به int و تطبیق کدهای مربوطه (buengese)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
کاهش دامنهٔ درخواستی oauth بر اساس پیشنهاد Google (Nick Craig-Wood)
.IP \[bu] 2
امکان کارکرد تمام عملیات‌ها از ریشه (Nick Craig-Wood)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--http-headers\f[R] برای تنظیم سرایندهای دلخواه (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
استفاده از api جدید جهت دریافت نام کاربری داخلی (buengese)
.IP \[bu] 2
بازسازی ساختار پیکربندی و پاکسازی‌های جزئی (buengese)
.RE
.IP \[bu] 2
Koofr
.RS 2
.IP \[bu] 2
پشتیبانی از تنظیم زمان‌های تغییر فایل در Koofr backend.
(jaKa)
.RE
.IP \[bu] 2
Opendrive
.RS 2
.IP \[bu] 2
بازسازی جهت استفاده از امکانات موجود در lib/rest برای بارگذاری‌ها (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Qingstor
.RS 2
.IP \[bu] 2
ارتقا به v3 SDK و رفع حلقهٔ تکرار در فهرست‌گیری (Nick Craig-Wood)
.IP \[bu] 2
امکان کارکرد تمام عملیات‌ها از ریشه (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن کلاس ذخیره‌سازی INTELLIGENT_TIERING (Matti Niemenmaa)
.IP \[bu] 2
امکان کارکرد تمام عملیات‌ها از ریشه (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن بررسی رابط مفقود و اصلاح About (Nick Craig-Wood)
.IP \[bu] 2
نادیده گرفتن کامل تمام بررسی‌های modtime در صورت SetModTime=false (Jon Fautley)
.IP \[bu] 2
پشتیبانی از md5/sha1 در rsync.net (Nick Craig-Wood)
.IP \[bu] 2
ذخیرهٔ دستور md5/sha1 در حال استفاده در فایل پیکربندی جهت بهبود کارایی (Nick
Craig-Wood)
.IP \[bu] 2
پشتیبانی اختیاری (opt-in) از diffie-hellman-group-exchange-sha256 و
diffie-hellman-group-exchange-sha1 (Yi FU)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
استفاده از FixRangeOption جهت اصلاح فایل‌های با طول ۰ از طریق VFS (Nick Craig-Wood)
.IP \[bu] 2
اصلاح بارگذاری هنگام استفاده از no_chunk جهت بازگرداندن اندازهٔ صحیح (Nick
Craig-Wood)
.IP \[bu] 2
امکان کارکرد تمام عملیات‌ها از ریشه (Nick Craig-Wood)
.IP \[bu] 2
رفع نشت بخش‌ها (segments) در زمان شکست بارگذاری فایل‌های بزرگ.
(nguyenhuuluan434)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
افزودن \f[V]--webdav-bearer-token-command\f[R] (Nick Craig-Wood)
.IP \[bu] 2
نوسازی توکن هنگام انقضای آن با
\f[V]--webdav-bearer-token-command\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن مستندات استفاده از bearer_token_command همراه با oidc-agent (Paul Millar)
.RE.SS v1.48.0 - 2019-06-15
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
serve sftp: ارائه‌ی یک ریموت rclone از طریق SFTP (Nick Craig-Wood)
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
دانلودهای چندرشته‌ای به فضای ذخیره‌سازی محلی (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
کنترل‌شده با \f[V]--multi-thread-cutoff\f[R] و
\f[V]--multi-thread-streams\f[R]
.RE
.IP \[bu] 2
استفاده از rclone.conf از دایرکتوری اجرایی rclone جهت فعال‌سازی استفاده قابل‌حمل
(albertony)
.IP \[bu] 2
اجازه همگام‌سازی یک فایل و یک دایرکتوری با نام یکسان (forgems)
.RS 2
.IP \[bu] 2
این مورد در ریموت‌های مبتنی بر باکت (bucket)، مانند
s3، gcs رایج است
.RE
.IP \[bu] 2
افزودن \f[V]--ignore-case-sync\f[R] برای اجبار عدم حساسیت به بزرگی و کوچکی حروف
(garry415)
.IP \[bu] 2
پیاده‌سازی \f[V]--stats-one-line-date\f[R] و
\f[V]--stats-one-line-date-format\f[R] (Peter Berbec)
.IP \[bu] 2
ثبت گزارش ERROR برای تمام دستورهایی که با وضعیتی غیر از صفر خارج می‌شوند (Nick
Craig-Wood)
.IP \[bu] 2
استفاده از go-homedir جهت خواندن مطمئن‌تر دایرکتوری خانه (Nick
Craig-Wood)
.IP \[bu] 2
فعال‌سازی ایجاد پیکربندی رمزشده از طریق فراخوانی اسکریپت خارجی
(Wojciech Smigielski)
.IP \[bu] 2
build: توقف پشتیبانی از go1.8 (Nick Craig-Wood)
.IP \[bu] 2
config: رمزگذاری گذرواژه‌ها توسط create/update در پیکربندی در صورت لزوم
(Nick Craig-Wood)
.IP \[bu] 2
copyurl: رعایت \f[V]--no-check-certificate\f[R] (Stefan Breunig)
.IP \[bu] 2
install: نادیده‌گرفتن صفحات راهنما در لینوکس در صورت عدم وجود mandb (didil)
.IP \[bu] 2
lsf: پشتیبانی از نمایش لایه (Tier) شیء (Nick Craig-Wood)
.IP \[bu] 2
lsjson
.RS 2
.IP \[bu] 2
افزودن EncryptedPath به خروجی (calisro)
.IP \[bu] 2
پشتیبانی از نمایش لایه (Tier) شیء (Nick Craig-Wood)
.IP \[bu] 2
افزودن فیلد IsBucket برای فهرست کردن ریشه در ریموت‌های مبتنی بر باکت (Nick
Craig-Wood)
.RE
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--loopback\f[R] جهت اجرای مستقیم دستورها بدون نیاز به سرور
(Nick Craig-Wood)
.IP \[bu] 2
افزودن operations/fsinfo: بازگرداندن اطلاعات مربوط به ریموت (Nick
Craig-Wood)
.IP \[bu] 2
رد کردن احراز هویت برای درخواست OPTIONS (Nick Craig-Wood)
.IP \[bu] 2
cmd/providers: افزودن فیلدهای DefaultStr، ValueStr و Type (Nick
Craig-Wood)
.IP \[bu] 2
jobs: امکان پیکربندی مهلت‌های زمانی انقضای وظایف (Aleksandar Jankovic)
.RE
.IP \[bu] 2
بازنویسی و بهبود serve dlna (Dan Walters)
.IP \[bu] 2
serve ftp: افزودن پرچم \f[V]--ftp-public-ip\f[R] برای تعیین IP عمومی
(calistri)
.IP \[bu] 2
serve restic: افزودن پشتیبانی از \f[V]--private-repos\f[R] در
\f[V]serve restic\f[R] (Florian Apolloner)
.IP \[bu] 2
serve webdav: ادغام serve webdav و serve http (Gary Kim)
.IP \[bu] 2
size: نادیده‌گرفتن اندازه‌های منفی هنگام محاسبه مجموع (Garry McNulty)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
تبعیت انتقال و رونوشت فایل‌های مجزا از \f[V]--backup-dir\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
در صورت برقراری \f[V]--ignore-checksum\f[R]، چک‌سام محاسبه نشود
(Nick Craig-Wood)
.IP \[bu] 2
moveto: رفع مشکل انتقال درون همان ریموت بدون حساسیت به بزرگی و کوچکی حروف (Gary Kim)
.IP \[bu] 2
rc: رفع مشکل ارائه‌ی اشیاء مبتنی بر باکت با \f[V]--rc-serve\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
serve webdav: رفع مشکل به‌روزرسانی نشدن serveDir با تغییرات ناشی از webdav
(Gary Kim)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
اصلاح مستندات مربوط به فاصله زمانی نظرسنجی (Animosity022)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
عملکرد درست WriteAt برای فایل‌های ذخیره‌نشده در حافظه موقت با نوشتن‌های غیرمتوالی (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
محاسبه تنها هش‌های مورد نیاز برای افزایش چشمگیر سرعت (Nick Craig-Wood)
.IP \[bu] 2
ثبت خطاها در لاگ هنگام فهرست‌گیری به جای برگرداندن یک خطا (Nick Craig-Wood)
.IP \[bu] 2
رفع هشدار preallocate در لینوکس به همراه ZFS (Nick Craig-Wood)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
امکان کارکرد rclone dedupe از طریق crypt (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل بسته‌بندی ChangeNotify برای رمزگشایی صحیح دایرکتوری‌ها (Nick
Craig-Wood)
.IP \[bu] 2
پشتیبانی از PublicLink (دستور rclone link) در backend زیربنایی (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی متدهای اختیاری SetTier و GetTier (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
پیاده‌سازی رونوشت در سمت سرور (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی SetModTime (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
رفع مشکل انتقال و رونوشت از TeamDrive به GDrive (Fionera)
.IP \[bu] 2
افزودن یادداشت‌هایی مبنی بر اینکه پاک‌سازی در drive در پس‌زمینه کار می‌کند (Nick
Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--drive-server-side-across-configs\f[R] برای بازگشت به معناشناسی قدیمی رونوشت سمت سرور به صورت پیش‌فرض (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--drive-size-as-quota\f[R] برای نمایش استفاده از سهمیه فضای ذخیره‌سازی به عنوان اندازه فایل
(Garry McNulty)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
افزودن مهلت زمانی (timeout) برای فهرست‌گیری FTP (Jeff Quinn)
.IP \[bu] 2
افزودن پشتیبانی از FTP بر بستر TLS (Gary Kim)
.IP \[bu] 2
افزودن گزینه \f[V]--ftp-no-check-certificate\f[R] برای FTPS (Gary Kim)
.RE.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
رفع خطاهای بارگذاری هنگام بارگذاری فایل‌های پیش از ۱۹۷۰ (Nick Craig-Wood)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از انتخاب دستگاه و نقطهٔ اتصال (mountpoint).
(buengese)
.RE
.IP \[bu] 2
Mega
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از پاک‌سازی (Gary Kim)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
بررسی دقیق‌تر یافت شدن ریشه (Cnly)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
پشتیبانی از نقاط پایانی شتاب‌یافته (Accelerated) در S3 با
\f[V]--s3-use-accelerate-endpoint\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن اطلاعات پیکربندی برای نقطهٔ پایانی اروپای مرکزی Wasabi (Robert Marko)
.IP \[bu] 2
فعال‌سازی عملکرد صحیح SetModTime برای GLACIER در حین همگام‌سازی (Philip Harvey)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از About (Gary Kim)
.IP \[bu] 2
اصلاح تحلیل خروجی‌های \f[V]df\f[R] در about جهت پشتیبانی از مقادیر
منفی (Nick Craig-Wood)
.IP \[bu] 2
ارسال نگارش سفارشی کلاینت و نگارش اشکال‌زدایی سرور (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
تلاش مجدد در مواجهه با خطاهای 423 Locked (Nick Craig-Wood)
.RE
.SS v1.47.0 - 2019-04-13
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
بک‌اند برای سرویس ذخیره‌سازی ابری Koofr.
(jaKa)
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
ازسرگیری بارگیری‌ها در صورت بروز خطا در خواننده در حین رونوشت (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
این بدان معناست که در صورت بروز خطا در مبدأ، rclone فرایند انتقال را از نو آغاز می‌کند
.IP \[bu] 2
این قابلیت برای بارگیری‌ها یا رونوشت‌های ابر به ابر بیشترین کاربرد را دارد
.RE
.IP \[bu] 2
استفاده از \f[V]--fast-list\f[R] برای عملیات فهرست‌گیری در مواردی که حافظهٔ
بیشتری مصرف نخواهد کرد (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
این امر باید سرعت عملیات زیر را در ریموت‌هایی که از
\f[V]ListR\f[R] پشتیبانی می‌کنند افزایش دهد
.IP \[bu] 2
\f[V]dedupe\f[R]، \f[V]serve restic\f[R]، \f[V]lsf\f[R]، \f[V]ls\f[R]،
\f[V]lsl\f[R]، \f[V]lsjson\f[R]، \f[V]lsd\f[R]، \f[V]md5sum\f[R]،
\f[V]sha1sum\f[R]، \f[V]hashsum\f[R]، \f[V]size\f[R]، \f[V]delete\f[R]،
\f[V]cat\f[R]، \f[V]settier\f[R]
.IP \[bu] 2
برای استفاده از رفتار پیشین در صورت نیاز، از \f[V]--disable ListR\f[R] استفاده کنید
.RE
.IP \[bu] 2
پیمایش مقصد توسط \f[V]--files-from\f[R]، مگر اینکه
\f[V]--no-traverse\f[R] تنظیم شده باشد (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
این تغییر مشکل \f[V]--files-from\f[R] با Google drive و استفادهٔ بیش از حد از API را
به‌طور کلی برطرف می‌کند.
.RE
.IP \[bu] 2
محاسبه بایت‌ها در رونوشت سمت سرور و رعایت \f[V]--max-transfer\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینهٔ \f[V]--create-empty-src-dirs\f[R] و پیش‌فرض قرار دادن عدم ایجاد
پوشه‌های خالی (ishuah)
.IP \[bu] 2
افزودن گزینه‌های سمت کلاینت TLS/SSL با عناوین
\f[V]--ca-cert\f[R]/\f[V]--client-cert\f[R]/\f[V]--client-key\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
پیاده‌سازی \f[V]--suffix-keep-extension\f[R] جهت استفاده همراه با
\f[V]--suffix\f[R] (Nick Craig-Wood)
.IP \[bu] 2
build:
.RS 2
.IP \[bu] 2
تغییر به برچسب‌های نسخهٔ منطبق بر semver جهت سازگاری با ماژول‌های go (Nick
Craig-Wood)
.IP \[bu] 2
به‌روزرسانی برای استفاده از go1.12.x در فرایند ساخت (Nick Craig-Wood)
.RE
.IP \[bu] 2
serve dlna: افزودن شرح سرویس مدیر اتصال برای بهبود
سازگاری (Dan Walters)
.IP \[bu] 2
lsf: افزودن قالب \[aq]e\[aq] برای نمایش نام‌های رمزگذاری‌شده و \[aq]o\[aq] برای
شناسه‌های اصلی (Nick Craig-Wood)
.IP \[bu] 2
lsjson: افزودن گزینه‌های \f[V]--files-only\f[R] و \f[V]--dirs-only\f[R]
(calistri)
.IP \[bu] 2
rc: پیاده‌سازی operations/publiclink معادل
\f[V]rclone link\f[R] (Nick Craig-Wood)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting: اصلاح ETA کل هنگامی که \f[V]--stats-unit bits\f[R] فعال است
(Nick Craig-Wood)
.IP \[bu] 2
تکمیل کلید TAB در Bash
.RS 2
.IP \[bu] 2
استفاده از تابع سفارشی اختصاصی جهت رفع تداخل میان rclone و kubectl (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل برای ریموت‌هایی با زیرخط در نام آن‌ها (Six)
.IP \[bu] 2
اصلاح تکمیل خودکار ریموت‌ها (Florian Gamböck)
.IP \[bu] 2
اصلاح تکمیل خودکار مسیرهای ریموت حاوی فاصله (Danil Semelenov)
.RE
.IP \[bu] 2
serve dlna: اصلاح توصیف‌کنندهٔ سرویس ریشه XML (Dan Walters)
.IP \[bu] 2
ncdu: اصلاح به‌هم‌ریختگی نمایش نویسه‌های چینی (Nick Craig-Wood)
.IP \[bu] 2
افزودن SIGTERM به سیگنال‌هایی که گرداننده‌های خروج را در unix اجرا می‌کنند (Nick
Craig-Wood)
.IP \[bu] 2
rc: بارگذاری مجدد فیلتر هنگام تنظیم گزینه‌ها از طریق rc (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS / Mount
.RS 2
.IP \[bu] 2
اصلاح FreeBSD: نادیده گرفتن Truncate در صورتی که بدون خواننده فراخوانی شده و از قبل
اندازهٔ صحیحی داشته باشد (Nick Craig-Wood)
.IP \[bu] 2
خواندن پوشه و بررسی وجود فایل پیش از اجرای mkdir (Nick Craig-Wood)
.IP \[bu] 2
کوتاه‌تر کردن بازهٔ زمانی قفل‌گذاری برای vfs/refresh (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
فعال‌سازی چکسام‌های MD5 هنگام بارگذاری فایل‌های بزرگ‌تر از
\[dq]Cutoff\[dq] (Dr.Rx)
.IP \[bu] 2
اصلاح پشتیبانی از SAS URL (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2.IP \[bu] 2
امکان پیکربندی دستی downloadUrl مربوط به backblaze (توسط Vince)
.IP \[bu] 2
نادیده‌گرفتن خطای already_hidden هنگام حذف (Nick Craig-Wood)
.IP \[bu] 2
نادیده‌گرفتن \f[V]src_last_modified_millis\f[R] نامعتبر (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن \f[V]--skip-checksum-gphotos\f[R] برای نادیده‌گرفتن چکسام‌های نادرست در
Google Photos (Nick Craig-Wood)
.IP \[bu] 2
امکان جابه‌جایی/کپی سمت سرور بین remoteهای مختلف.
(Fionera)
.IP \[bu] 2
افزودن مستندات درباره team driveها و سازگاری نهایی در \f[V]--fast-list\f[R]
(Nestar47)
.IP \[bu] 2
رفع مشکل وارد کردن فایل‌های متنی (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل درخواست‌های بازه‌ای (range requests) روی فایل‌های با طول صفر (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل ایجاد موارد تکراری در کپی سمت سرور (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
تلاش مجدد در خطاهای خالی برای رفع مشکل فهرست‌گیری‌های طولانی (Nick Craig-Wood)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
افزودن \f[V]--ftp-concurrency\f[R] برای محدود کردن حداکثر تعداد اتصالات
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
استفاده از گواهی‌های پیش‌فرض برنامه (application credentials) به عنوان جایگزین (marcintustin)
.IP \[bu] 2
پشتیبانی از باکت‌های مبتنی بر bucket policy only (Nick Craig-Wood)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
افزودن \f[V]--http-no-slash\f[R] برای وب‌سایت‌هایی با دایرکتوری‌های فاقد
اسلش (Nick Craig-Wood)
.IP \[bu] 2
حذف موارد تکراری از فهرست‌ها (Nick Craig-Wood)
.IP \[bu] 2
رفع نشت سوکت در خطاهای 404 (Nick Craig-Wood)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
رفع مشکل نوسازی توکن (Sebastian Bünger)
.IP \[bu] 2
افزودن ثبت دستگاه (Oliver Heyme)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
پیاده‌سازی لغو بی‌نقص بارگذاری‌های چندبخشی در صورت متوقف شدن rclone
(Cnly)
.IP \[bu] 2
افزودن همیشگی دونقطه پایانی به مسیر هنگام آدرس‌دهی آیتم‌ها، (Cnly)
.IP \[bu] 2
بازگرداندن خطا به‌جای رخ دادن panic برای بارگذاری‌های نامعتبر (Fabian Möller)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از کلاس ذخیره‌سازی \[dq]Glacier Deep Archive\[dq] (Manu)
.IP \[bu] 2
به‌روزرسانی endpoint مربوط به Dreamhost (Nick Craig-Wood)
.IP \[bu] 2
ذکر ناسازگاری با CEPH Jewel (Nick Craig-Wood)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
امکان استفاده از پیکربندی سفارشی کلاینت ssh (Alexandru Bumbacea)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
تبعیت از Retry-After برای فعال‌سازی بازیابی OVH از ذخیره‌سازی سرد (Nick
Craig-Wood)
.IP \[bu] 2
دور زدن مشکل انقضای توکن در CEPH (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
امکان تعیین ویژگی IsCollection به‌صورت عدد صحیح یا مقدار بولی (Nick Craig-Wood)
.IP \[bu] 2
رفع تداخل (race condition) هنگام ایجاد دایرکتوری‌ها (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل About/df هنگامی که خواندن available/total مقدار 0 برمی‌گرداند (Nick
Craig-Wood)
.RE.SS v1.46 \- 2019-02-09
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
پشتیبانی از Alibaba Cloud (Aliyun) OSS از طریق بک‌اند s3 (Nick Craig-Wood)
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
serve dlna: ارائه یک ریموت از طریق DLNA برای شبکه محلی (nicolov)
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
copy، move: بازیابی پرچم منسوخ‌شده‌ی \f[V]--no-traverse\f[R] (Nick
Craig-Wood)
.RS 2
.IP \[bu] 2
این مورد برای زمان انتقال تعداد کمی فایل به یک مقصد بزرگ مفید است
.RE
.IP \[bu] 2
genautocomplete: افزودن تکمیل خودکار مسیر ریموت برای تکمیل خودکار bash
(Christopher Peterson و Danil Semelenov)
.IP \[bu] 2
بازنویسی مدیریت حافظه میانگیر برای آزادسازی بهتر حافظه به سیستم‌عامل (Nick
Craig-Wood)
.RS 2
.IP \[bu] 2
کتابخانه بازیافت میانگیر برای جایگزینی با sync.Pool
.IP \[bu] 2
امکان استفاده اختیاری از حافظه نگاشت‌شده (mmap) جهت کاهش بهتر مصرف حافظه
.IP \[bu] 2
در صورت بروز مشکلات حافظه با \f[V]--use-mmap\f[R] فعال شود \- هنوز پیش‌فرض
نیست
.RE
.IP \[bu] 2
موازی‌سازی خواندن فایل‌های مشخص‌شده توسط \f[V]--files-from\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
check: افزودن آمارهایی که مجموع فایل‌های منطبق را نشان می‌دهد.
(Dario Guzik)
.IP \[bu] 2
امکان تغییر نام/حذف فایل‌های باز در Windows (Nick Craig-Wood)
.IP \[bu] 2
lsjson: استفاده از تعداد کاملاً دقیق ارقام اعشار در ثانیه‌ها
(Nick Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی از کوکی با کلید خط فرمان \f[V]--use-cookies\f[R] برای تمام
ریموت‌های مبتنی بر HTTP (qip)
.IP \[bu] 2
هشدار در صورت تنظیم بودن \f[V]--checksum\f[R] در حالی که هیچ هشی در دسترس نیست
(Nick Craig-Wood)
.IP \[bu] 2
بازنویسی محدودکننده نرخ (pacer) برای دقت بیشتر و مجاز کردن ارسال ناگهانی (bursting)
(Nick Craig-Wood)
.IP \[bu] 2
بهبود گزارش خطا برای آرگومان‌های بسیار زیاد/کم در دستورها (Nick
Craig-Wood)
.IP \[bu] 2
listremotes: حذف پرچم کوتاه \f[V]-l\f[R] به دلیل تداخل با پرچم جدید سراسری
(weetmuts)
.IP \[bu] 2
تولید پیام‌های INFO در صورت شکست احراز هویت در سرویس‌دهی http با احراز هویت (Nick
Craig-Wood)
.RE
.IP \[bu] 2
رفع اشکال‌ها
.RS 2
.IP \[bu] 2
اصلاح قالب‌بندی آمارها (Nick Craig-Wood)
.IP \[bu] 2
رفع کرش \f[V]--progress\f[R] در Windows Jenkins (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل انتقال اسناد google/onedrive با فراخوانی Rcat در Copy هنگام \-1
بودن اندازه (Cnly)
.IP \[bu] 2
copyurl: رفع بررسی \f[V]--dry-run\f[R] (Denis Skovpen)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
بررسی عدم تداخل نقطه اتصال (mountpoint) و دایرکتوری محلی جهت سوار کردن
(Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل اندازه سوار کردن در ویندوز ۳۲ بیتی (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
پیاده‌سازی تغییر نام دایرکتوری‌ها برای بک‌اندهای بدون DirMove (Nick
Craig-Wood)
.RS 2
.IP \[bu] 2
اکنون تمام بک‌اندها به‌جز b2 از تغییر نام دایرکتوری‌ها پشتیبانی می‌کنند
.RE
.IP \[bu] 2
پیاده‌سازی \f[V]--vfs-cache-max-size\f[R] برای محدود کردن اندازه کل حافظه
نهان (Nick Craig-Wood)
.IP \[bu] 2
افزودن پرچم‌های \f[V]--dir-perms\f[R] و \f[V]--file-perms\f[R] برای تنظیم
مجوزهای پیش‌فرض (Nick Craig-Wood)
.IP \[bu] 2
رفع بن‌بست (deadlock) در عملیات‌های هم‌زمان روی یک دایرکتوری (Nick Craig-Wood)
.IP \[bu] 2
رفع بن‌بست بین RWFileHandle.close و File.Remove (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل تغییر نام/حذف فایل‌های باز با حالت حافظه نهان \[dq]writes\[dq] در
Windows (Nick Craig-Wood)
.IP \[bu] 2
رفع خطای غیرمنتظره (panic) هنگام تغییر نام در صورت تنظیم بودن \f[V]--dry-run\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال نیاز vfs/refresh با recurse=true به پرچم \f[V]--fast-list\f[R]
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از \f[V]-l\f[R]/\f[V]--links\f[R] (ترجمه پیوند
نمادین) (yair\[at]unicorn)
.RS 2
.IP \[bu] 2
این سازوکار با نمایش پیوندها به‌صورت \f[V]link.rclonelink\f[R] کار می‌کند \- برای اطلاعات
بیشتر مستندات بک‌اند local را ببینید
.IP \[bu] 2
در صورت استفاده به همراه \f[V]-L\f[R]/\f[V]--copy-links\f[R] خطا می‌دهد
.RE
.IP \[bu] 2
رفع مشکل تغییر نام/حذف فایل‌های باز در Windows (Nick Craig-Wood)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
بررسی حداکثر طول پیش از رمزگشایی نام فایل برای رفع مشکل خطای panic (Garry
McNulty)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
امکان کامپایل و ساخت بک‌اند azureblob روی *BSD (themylogin)
.IP \[bu] 2
استفاده از کلاینت HTTP برنامه rclone جهت پشتیبانی از \f[V]--dump headers\f[R]،
\f[V]--tpslimit\f[R] و غیره
(Nick Craig-Wood)
.IP \[bu] 2
استفاده از pacer مربوط به s3 برای تأخیر صفر در شرایط بدون خطا (Nick Craig-Wood)
.IP \[bu] 2
نادیده گرفتن نشانگرهای دایرکتوری (Nick Craig-Wood)
.IP \[bu] 2
توقف تلاش Mkdir برای ایجاد کانتینرهای (containers) موجود (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
cleanup: حذف فایل‌های بزرگ ناتمام با قدمت بیش از ۲۴ ساعت (Garry McNulty)
.IP \[bu] 2
بررسی نام باکت برای کلید کاربری (application key) محدودشده به باکت (Nick
Craig-Wood)
.RS 2
.IP \[bu] 2
پیش از این، rclone بدون توجه به آنچه در خط فرمان وارد می‌کردید، از باکت مجاز
استفاده می‌کرد
.RE
.IP \[bu] 2
افزودن پرچم \f[V]--b2-disable-checksum\f[R] (Wojciech Smigielski)
.RS 2
.IP \[bu] 2
این قابلیت به دلایل افزایش سرعت، امکان بارگذاری فایل‌های بزرگ را بدون محاسبه هش SHA-1
فراهم می‌کند
.RE
.RE.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
تنظیم گام‌زن (pacer) پیش‌فرض روی 100ms برای 10 tps (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
این مقدار با پیش‌فرض‌های Google بسیار سازگارتر است و خطاهای 403 را به شدت کاهش می‌دهد
.IP \[bu] 2
افزودن \f[V]--drive-pacer-min-sleep\f[R] و \f[V]--drive-pacer-burst\f[R] برای کنترل گام‌زن (pacer)
.RE
.IP \[bu] 2
بهبود پشتیبانی از ChangeNotify برای مواردی با چند والد (Fabian Möller)
.IP \[bu] 2
رفع اشکال ListR برای مواردی با چند والد \- این تغییر رفتارهای غیرعادی با \f[V]vfs/refresh\f[R] را برطرف می‌کند (Fabian Möller)
.IP \[bu] 2
رفع اشکال استفاده از \f[V]--drive-impersonate\f[R] و appfolders (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال اسناد گوگل (google docs) در rclone mount برای برخی (نه همه) برنامه‌ها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
پشتیبانی از Retry-After برای backend دراپ‌باکس (Dropbox) (Mathieu Carbou)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
انتظار به مدت ۶۰ ثانیه برای بسته‌شدن اتصال و سپس اعلام قطع بودن آن (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
به رفع قفل‌شدن‌های بی‌پایان در برخی کارگزارهای FTP کمک می‌کند
.RE
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
به‌روزرسانی پایانه‌های (endpoints) فضای ذخیره‌سازی ابری گوگل (Google Cloud Storage) (weetmuts)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
افزودن یک مثال با نام‌کاربری و گذرواژه که پشتیبانی می‌شد اما مستند نشده بود (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال backend با \f[V]--files-from\f[R] و فایل‌های ناموجود (Nick Craig-Wood)
.RE
.IP \[bu] 2
Hubic
.RS 2
.IP \[bu] 2
اطلاعات‌بخش‌تر کردن پیام خطا در صورت شکست احراز هویت (Nick Craig-Wood)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
پشتیبانی از ازسرگیری (Resume) و یکپارچه‌سازی دادگان تکراری (deduplication) (Oliver Heyme)
.IP \[bu] 2
استفاده از احراز هویت مبتنی بر نشان (token auth) برای همه درخواست‌های API و عدم ذخیره بیشتر گذرواژه (Sebastian Bünger)
.IP \[bu] 2
افزودن پشتیبانی از احراز هویت دومرحله‌ای (Sebastian Bünger)
.RE
.IP \[bu] 2
Mega
.RS 2
.IP \[bu] 2
پیاده‌سازی ورود به حساب نسخه ۲ که ورود به حساب‌های جدیدتر Mega را اصلاح می‌کند (Nick Craig-Wood)
.IP \[bu] 2
بازگرداندن خطا در صورت تلاش برای بارگذاری فایلی با طول نامشخص (Nick Craig-Wood)
.IP \[bu] 2
افزودن کدهای خطای جدید برای گزارش‌دهی بهتر خطاها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
رفع اشکال خرابی پشتیبانی از پوشه‌های \[dq]shared with me\[dq] (Alex Chen)
.IP \[bu] 2
رفع اشکال نرمال‌نشدن شناسه ریشه (root ID) (Cnly)
.IP \[bu] 2
بازگرداندن خطا به‌جای panic هنگام بارگذاری‌های با اندازه نامشخص (Cnly)
.RE
.IP \[bu] 2
Qingstor
.RS 2
.IP \[bu] 2
رفع نشت goroutine در خطاهای بارگذاری چندبخشی (multipart upload) (Nick Craig-Wood)
.IP \[bu] 2
افزودن کنترل اندازه تکه، همزمانی و آستانه بارگذاری (Nick Craig-Wood)
.IP \[bu] 2
تنظیم پیش‌فرض \f[V]--qingstor-upload-concurrency\f[R] روی ۱ برای دور زدن اشکال (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]--s3-upload-cutoff\f[R] برای بارگذاری‌های تک‌بخشی کمتر از این مقدار (Nick Craig-Wood)
.IP \[bu] 2
تغییر مقدار پیش‌فرض \f[V]--s3-upload-concurrency\f[R] به ۴ برای افزایش کارایی (Nick Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--s3-bucket-acl\f[R] برای کنترل ACL باکت (Nick Craig-Wood)
.IP \[bu] 2
تشخیص خودکار منطقه (region) برای باکت‌ها هنگام شکست عملیات (Nick Craig-Wood)
.IP \[bu] 2
افزودن کلاس ذخیره‌سازی GLACIER (William Cocker)
.IP \[bu] 2
افزودن Scaleway به مستندات s3 (Rémy Léone)
.IP \[bu] 2
افزودن پایانه AWS به نام eu-north-1 (weetmuts)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از کلیدهای خصوصی رمزنگاری‌شده با PEM (Fabian Möller)
.IP \[bu] 2
افزودن گزینه‌ای برای اجبار به استفاده از ssh-agent (Fabian Möller)
.IP \[bu] 2
انجام بسط متغیرهای محیطی روی key-file (Fabian Möller)
.IP \[bu] 2
رفع اشکال rmdir در کارگزارهای مبتنی بر ویندوز (مانند CrushFTP) (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال حذف محتویات دایرکتوری توسط rmdir در برخی کارگزارهای SFTP (Nick Craig-Wood)
.IP \[bu] 2
رفع خطا در پیوندهای نمادین معلق (dangling symlinks) (Nick Craig-Wood)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
افزودن \f[V]--swift-no-chunk\f[R] برای غیرفعال‌سازی بارگذاری‌های قطعه‌بندی‌شده در rcat/mount (Nick Craig-Wood)
.IP \[bu] 2
ارائه پشتیبانی از احراز هویت با اعتبارنامه برنامه (application credential) (kayrus)
.IP \[bu] 2
اصلاح مصرف حافظه با کم‌حجم کردن شیء (Object) (Nick Craig-Wood)
.IP \[bu] 2
رفع درخواست‌های اضافی هنگام بارگذاری (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال احراز هویت مجدد روی فایل‌های بزرگ (Nick Craig-Wood)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
رفع کار نکردن poll-interval (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
پشتیبانی از About به این معنی که rclone mount اندازه درست دیسک را نمایش خواهد داد (Nick Craig-Wood)
.IP \[bu] 2
پشتیبانی از درهم‌سازهای MD5 و SHA1 با Owncloud و Nextcloud (Nick Craig-Wood)
.IP \[bu] 2
مدیریت نرم خطا (Fail soft) در خطاهای تجزیه زمان (Nick Craig-Wood)
.IP \[bu] 2
رفع اشکال حلقه بی‌نهایت هنگام شکست در ایجاد دایرکتوری (Nick Craig-Wood).IP \[bu] 2
رفع مشکل شناسایی دایرکتوری‌ها برای Bitrix Site Manager (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل بارگذاری فایل‌های با اندازه ۰ روی برخی کارسازها (Nick Craig-Wood)
.IP \[bu] 2
فرض بر وجود داشتن دایرکتوری در صورت شکست MKCOL با خطای 423 Locked (Nick
Craig-Wood)
.RE
.SS v1.45 \- 2018-11-24
.IP \[bu] 2
پشتینه‌های جدید
.RS 2
.IP \[bu] 2
پشتینه Yandex بازنویسی شد \- برای جزئیات به زیر مراجعه کنید (Sebastian
Bünger)
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
rcd: دستور جدید تنها برای میزبانی API کنترل از راه دور (Nick Craig-Wood)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
واسط برنامه‌نویسی کنترل از راه دور (rc) برای امکان کنترل کامل
بر rclone تا حد زیادی گسترش یافت (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
عملیات حساس نیازمند احراز هویت یا پرچم \f[V]--rc-no-auth\f[R]
هستند
.IP \[bu] 2
عملیات config/* برای پیکربندی rclone
.IP \[bu] 2
عملیات options/* برای خواندن/تنظیم پرچم‌های خط فرمان
.IP \[bu] 2
عملیات operations/* برای همه عملیات سطح پایین، مانند
کپی فایل، فهرست کردن دایرکتوری
.IP \[bu] 2
عملیات sync/* برای sync، copy و move
.IP \[bu] 2
پرچم \f[V]--rc-files\f[R] برای ارائه فایل‌ها روی کارساز وب rc
.RS 2
.IP \[bu] 2
این قابلیت برای ساخت رابط‌های کاربری گرافیکی وب‌محور برای rclone است
.RE
.IP \[bu] 2
ارائه اختیاری اشیاء روی کارساز وب rc
.IP \[bu] 2
اطمینان از عدم راه‌اندازی rclone اگر درگاه \f[V]--rc\f[R] از قبل
در حال استفاده باشد
.IP \[bu] 2
برای اطلاعات بیشتر مستندات rc را ببینید (https://rclone.org/rc)
.RE
.IP \[bu] 2
sync/copy/move
.RS 2
.IP \[bu] 2
تنظیم \f[V]--files-from\f[R] برای خواندن تنها اشیاء مشخص‌شده و
عدم پیمایش دایرکتوری‌ها (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
این تغییر یک بهبود سرعت چشمگیر برای مقصدهایی با فایل‌های بسیار زیاد است
.RE
.RE
.IP \[bu] 2
filter: افزودن پرچم \f[V]--ignore-case\f[R] (Nick Craig-Wood)
.IP \[bu] 2
ncdu: افزودن تابع حذف (کلید \[aq]d\[aq]) (Henning Surmeier)
.IP \[bu] 2
دستور rc
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--json\f[R] برای ورودی ساختاریافته JSON (Nick Craig-Wood)
.IP \[bu] 2
افزودن پرچم‌های \f[V]--user\f[R] و \f[V]--pass\f[R] و تفسیر
\f[V]--rc-user\f[R]، \f[V]--rc-pass\f[R]، \f[V]--rc-addr\f[R] (Nick
Craig-Wood)
.RE
.IP \[bu] 2
ساخت (build)
.RS 2
.IP \[bu] 2
نیاز به go1.8 یا بالاتر برای کامپایل (Nick Craig-Wood)
.IP \[bu] 2
فعال‌سازی softfloat روی معماری MIPS (Scott Edlund)
.IP \[bu] 2
نوسازی چارچوب آزمون‌های یکپارچگی با گزارش بهتر و
تلاش‌های مجدد بهبودیافته (Nick Craig-Wood)
.RE
.RE
.IP \[bu] 2
رفع اشکالات
.RS 2
.IP \[bu] 2
cmd: به‌روزرسانی درست آمار در پایان توسط \f[V]--progress\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
config: ایجاد دایرکتوری پیکربندی در زمان ذخیره در صورت ناموجود بودن (Nick
Craig-Wood)
.IP \[bu] 2
dedupe: بررسی نام فایل موجود پیش از تغییر نام فایل تکراری (ssaqua)
.IP \[bu] 2
move: عدم ایجاد دایرکتوری‌ها همراه با \f[V]--dry-run\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
operations: رفع اشکال Purge و Rmdirs هنگامی که دایرکتوری ریشه نیست (Nick
Craig-Wood)
.IP \[bu] 2
serve http/webdav/restic: اطمینان از خروج rclone در صورت در حال استفاده بودن درگاه
(Nick Craig-Wood)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
کارکرد درست \f[V]--volname\f[R] برای Windows و macOS (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
جلوگیری از خطای context deadline exceeded با تنظیم مقدار بزرگ‌تر برای TryTimeout
(brused27)
.IP \[bu] 2
رفع خطای نادرست Rmdir با پیام \[dq]directory not empty\[dq] (Nick
Craig-Wood)
.IP \[bu] 2
صبر تا ۶۰ ثانیه برای ایجاد یک container که تازه حذف شده است (Nick Craig-Wood)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از impersonate در dropbox (Jake Coggiano)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
رفع اشکال در مدیریت پوشه‌های خالی توسط \f[V]--fast-list\f[R] (albertony)
.RE
.IP \[bu] 2
Opendrive
.RS 2
.IP \[bu] 2
رفع مشکل انتقال فایل‌های دارای \f[V]+\f[R] و \f[V]&\f[R] در نام (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل تلاش‌های مجدد در قطعات بارگذاری (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
تنظیم ACL کپی‌های سمت کارساز بر اساس مقدار ارائه‌شده توسط کاربر (Nick
Craig-Wood)
.IP \[bu] 2
رفع مشکل role_arn، credential_source و...
(Erik Swanson)
.IP \[bu] 2
افزودن اطلاعات پیکربندی برای نقطه پایانی Wasabi در US-West (Henry Ptasinski)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
اطمینان از غیرفعال بودن واقعی بررسی هش فایل (Jon Fautley)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
افزودن pacer برای تلاش‌های مجدد جهت پایدارتر ساختن swift (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2.IP \[bu] 2
افزودن Content-Type به درخواست‌های PUT (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل تجزیه پیکربندی به طوری که پرچم‌های \f[V]--webdav-user\f[R] و
\f[V]--webdav-pass\f[R] کار کنند (Nick Craig-Wood)
.IP \[bu] 2
افزودن قالب تاریخ RFC3339 (Ralf Hemberger)
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
بک‌اند yandex بازنویسی شد (Sebastian Bünger)
.RS 2
.IP \[bu] 2
پیاده‌سازی تلاش‌های مجدد در سطح پایین (low level retries) (Sebastian Bünger)
.IP \[bu] 2
رابط‌های اختیاری Copy، Move، DirMove، PublicLink و About (Sebastian
Bünger)
.IP \[bu] 2
بهبود مدیریت عمومی خطاها (Sebastian Bünger)
.IP \[bu] 2
حذف موقت ListR به دلیل رفتار ناسازگار (Sebastian Bünger)
.RE
.RE
.SS v1.44 - 2018-10-15
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
serve ftp: افزودن سرور ftp (Antoine GIRARD)
.IP \[bu] 2
settier: انجام تغییرات رده ذخیره‌سازی در ریموت‌های پشتیبانی‌شده (sandeepkru)
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
بازنگری در راهنمای خط فرمان
.RS 2
.IP \[bu] 2
کاهش پرحرفی (verbose) راهنمای پیش‌فرض (Nick Craig-Wood)
.IP \[bu] 2
تقسیم پرچم‌ها به پرچم‌های سراسری و بک‌اند (Nick Craig-Wood)
.IP \[bu] 2
پیاده‌سازی راهنمای تخصصی برای پرچم‌ها و بک‌اندها (Nick Craig-Wood)
.IP \[bu] 2
نمایش نشانی وب صفحه راهنمای بک‌اند هنگام شروع پیکربندی (Nick Craig-Wood)
.RE
.IP \[bu] 2
stats: نام‌های طولانی اکنون از وسط تقسیم می‌شوند (Joanna Marek)
.IP \[bu] 2
افزودن پرچم \f[V]--log-format\f[R] برای کنترل بیشتر بر خروجی لاگ (dcpu)
.IP \[bu] 2
rc: افزودن پشتیبانی از OPTIONS و CORS پایه (frenos)
.IP \[bu] 2
stats: نمایش FatalErrors و NoRetryErrors در stats (Cédric Connes)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
رفع مشکل پایان نیافتن خروجی \-P با خط جدید (Nick Craig-Wood)
.IP \[bu] 2
config: در صورت تعیین \f[V]--config\f[R] توسط کاربر، دایرکتوری پیش‌فرض پیکربندی ساخته نشود (albertony)
.IP \[bu] 2
عدم چاپ نویسه‌های غیر ASCII با \f[V]--progress\f[R] در ویندوز (Nick Craig-Wood)
.IP \[bu] 2
تصحیح لاگ‌ها برای موارد استثناشده (ssaqua)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
حذف برچسب‌های EXPERIMENTAL (Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
رفع وضعیت رقابتی شناسایی‌شده توسط آزمون‌های serve ftp (Nick Craig-Wood)
.IP \[bu] 2
افزودن دستور rc با عنوان vfs/poll-interval (Fabian Möller)
.IP \[bu] 2
فعال‌سازی تغییر نام برای تقریباً تمام ریموت‌ها با استفاده از Move یا Copy سمت سرور
(Nick Craig-Wood)
.IP \[bu] 2
کاهش پاکسازی حافظه پنهان دایرکتوری توسط poll-interval (Fabian Möller)
.IP \[bu] 2
حذف برچسب‌های EXPERIMENTAL (Nick Craig-Wood)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رد کردن پیوندهای نمادین خراب در فهرست دایرکتوری با فعال بودن \-L (Cédric Connes)
.IP \[bu] 2
پیش‌تخصیص فایل‌ها در ویندوز برای کاهش تکه‌تکه‌شدگی (Nick Craig-Wood)
.IP \[bu] 2
پیش‌تخصیص فایل‌ها در لینوکس با fallocate(2) (Nick Craig-Wood)
.RE
.IP \[bu] 2
Cache
.RS 2
.IP \[bu] 2
افزودن تابع rc با عنوان cache/fetch (Fabian Möller)
.IP \[bu] 2
رفع مشکل کاهش مقیاس ورکرها (Fabian Möller)
.IP \[bu] 2
بهبود کارایی با عدم ارسال درخواست‌های اطلاعات برای تکه‌های کَش‌شده
(dcpu)
.IP \[bu] 2
اصلاح مقدار خطای بازگشتی متد rc با نام cache/fetch (Fabian Möller)
.IP \[bu] 2
اصلاح مستندات برای cache-chunk-total-size (Anagh Kumar Baranwal)
.IP \[bu] 2
حفظ / آغازین در مسیر ریموت بسته‌بندی‌شده (wrapped) (Fabian Möller)
.IP \[bu] 2
افزودن گزینه plex_insecure برای نادیده‌گرفتن اعتبارسنجی گواهی (Fabian Möller)
.IP \[bu] 2
حذف مواردی که دیگر در مبدأ وجود ندارند (dcpu)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
حفظ / آغازین در مسیر ریموت بسته‌بندی‌شده (wrapped) (Fabian Möller)
.RE
.IP \[bu] 2
Alias
.RS 2
.IP \[bu] 2
رفع مشکل مدیریت مسیرهای شبکه ویندوز (Nick Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
افزودن پارامتر \f[V]--azureblob-list-chunk\f[R] (Santiago Rodríguez)
.IP \[bu] 2
پیاده‌سازی پشتیبانی از دستور settier در ریموت azureblob.
(sandeepkru)
.IP \[bu] 2
دور زدن باگ SDK که موجب ایجاد خطا برای فایل‌های هم‌اندازه با تکه (chunk) می‌شد (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
پیاده‌سازی اشتراک‌گذاری پیوند.
(Sebastian Bünger)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن \f[V]--drive-import-formats\f[R] \- امکان وارد کردن اسناد google docs فراهم شد
(Fabian Möller)
.RS 2
.IP \[bu] 2
بازنویسی نحوه مدیریت نوع mime و پسوند فایل‌ها (Fabian Möller)
.IP \[bu] 2
افزودن پیوندهای اسناد (Fabian Möller)
.IP \[bu] 2
افزودن پشتیبانی از پسوندهای چندبخشی اسناد (Fabian Möller)
.IP \[bu] 2
افزودن پشتیبانی از خروجی گرفتن apps-script به json (Fabian Möller)
.IP \[bu] 2
رفع مشکل نویسه‌های گریزخورده در اسناد هنگام فهرست‌گیری (Fabian Möller)
.RE
.IP \[bu] 2
افزودن \f[V]--drive-v2-download-min-size\f[R] به عنوان راهکاری برای دانلودهای
کُند (Fabian Möller)
.IP \[bu] 2
بهبود اعلان‌های دایرکتوری در ChangeNotify (Fabian Möller)
.IP \[bu] 2
هنگام فهرست‌گیری درایوهای تیمی در config، ادامه کار در صورت بروز خطا (Nick
Craig-Wood)
.RE.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
افزودن یک مکث کوتاه پس از بارگذاری ناموفق پیش از حذف فایل (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
رفع مشکل نادیده گرفته شدن service_account_file (Fabian Möller)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
بهبود جزئی در اطلاعات سهمیه فضا (حذف در صورت نامحدود بودن) (albertony)
.IP \[bu] 2
افزودن پشتیبانی از \f[V]--fast-list\f[R] (albertony)
.IP \[bu] 2
افزودن پشتیبانی از حذف دائم: \f[V]--jottacloud-hard-delete\f[R]
(albertony)
.IP \[bu] 2
افزودن پشتیبانی از اشتراک‌گذاری پیوند (albertony)
.IP \[bu] 2
رفع مشکل مدیریت نویسه‌های رزروشده.
(Sebastian Bünger)
.IP \[bu] 2
رفع نشت سوکت در Object.Remove (Nick Craig-Wood)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
بازطراحی جهت پشتیبانی از Microsoft Graph (Cnly)
.RS 2
.IP \[bu] 2
\f[B]توجه:\f[R] این مورد نیازمند احراز هویت مجدد ریموت خواهد بود
.RE
.IP \[bu] 2
حذف آستانه بارگذاری و استفاده همیشگی از بارگذاری‌های مبتنی بر نشست (Oliver Heyme)
.IP \[bu] 2
استفاده از بارگذاری تک‌پارت برای فایل‌های خالی (Cnly)
.IP \[bu] 2
رفع مشکل ذخیره نشدن فیلدهای جدید هنگام ویرایش پیکربندی قدیمی (Alex Chen)
.IP \[bu] 2
رفع مشکل جایگزین نشدن نویسه‌های خاص در نام فایل‌ها در برخی موارد (Alex Chen)
.IP \[bu] 2
نادیده گرفتن فایل‌های OneNote به‌صورت پیش‌فرض (Alex Chen)
.IP \[bu] 2
افزودن پشتیبانی از اشتراک‌گذاری پیوند (jackyzy823)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
استفاده از تنظیم‌کننده سرعت (pacer) سفارشی جهت تلاش مجدد برای عملیات‌ها در صورت منطقی بودن (Craig Miskell)
.IP \[bu] 2
استفاده از گزینه‌های server-side-encryption و کلاس ذخیره‌سازی پیکربندی‌شده هنگام
فراخوانی ()CopyObject (Paul Kohout)
.IP \[bu] 2
ایجاد پرچم \f[V]--s3-v2-auth\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع مشکل احراز هویت v2 برای فایل‌های دارای فاصله (Nick Craig-Wood)
.RE
.IP \[bu] 2
Union
.RS 2
.IP \[bu] 2
پیاده‌سازی بک‌اند union که از چندین بک‌اند می‌خواند (Felix
Brucker)
.IP \[bu] 2
پیاده‌سازی رابط‌های اختیاری (Move، DirMove، Copy و غیره)
(Nick Craig-Wood)
.IP \[bu] 2
اصلاح ChangeNotify جهت پشتیبانی از چندین ریموت (Fabian Möller)
.IP \[bu] 2
اصلاح \f[V]--backup-dir\f[R] روی بک‌اند union (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
افزودن یک قالب زمانی دیگر (Nick Craig-Wood)
.IP \[bu] 2
افزودن یک مکث کوتاه پس از بارگذاری ناموفق پیش از حذف فایل (Nick
Craig-Wood)
.IP \[bu] 2
افزودن راه‌حل جایگزین برای mtime ناموجود (buergi)
.IP \[bu] 2
Sharepoint: تمدید کوکی‌ها پس از ۱۲ ساعت (Henning Surmeier)
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
حذف بررسی‌های زائد nil (teresy)
.RE.SS v1.43.1 - 2018-09-07
.PP
انتشار نقطه‌ای برای رفع اشکالات بک‌اندهای hubic و azureblob.
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
ncdu: بازگرداندن خطا به‌جای log.Fatal در Show (Fabian Möller)
.IP \[bu] 2
cmd: رفع فروپاشی با \f[V]--progress\f[R] و \f[V]--stats 0\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
docs: مرتب‌سازی نمایش وب‌سایت (Anagh Kumar Baranwal)
.RE
.IP \[bu] 2
Azure Blob:
.RS 2
.IP \[bu] 2
رفع بارگذاری‌های چندبخشی (multi-part).
(sandeepkru)
.RE
.IP \[bu] 2
Hubic
.RS 2
.IP \[bu] 2
رفع بارگذاری‌ها (Nick Craig-Wood)
.IP \[bu] 2
تلاش مجدد برای دریافت احراز هویت در صورت شکست جهت پایدارتر ساختن hubic (Nick
Craig-Wood)
.RE
.SS v1.43 - 2018-09-01
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
Jottacloud (Sebastian Bünger)
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
copyurl: رونوشت از یک URL به یک ریموت (Denis)
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
بازطراحی پیکربندی بک‌اندها (Nick Craig-Wood)
.RS 2
.IP \[bu] 2
امکان تأمین تمامی پیکربندی‌های بک‌اند از طریق خط فرمان، متغیر محیطی یا فایل پیکربندی
.IP \[bu] 2
بخش پیشرفته در راهنمای گام‌به‌گام پیکربندی برای موارد اختیاری
.IP \[bu] 2
گامی بزرگ در جهت قابل استفاده شدن بک‌اندهای rclone در سایر نرم‌افزارهای go
.IP \[bu] 2
امکان استفاده بلادرنگ از ریموت‌ها با نحو :backend:
.RE
.IP \[bu] 2
بازنگری آمارها (Stats)
.RS 2
.IP \[bu] 2
افزودن گزینه \f[V]--progress\f[R]/\f[V]-P\f[R] برای نمایش تعاملی پیشرفت
(Nick Craig-Wood)
.IP \[bu] 2
نمایش پیشرفت کلی همگام‌سازی در آمارها (Nick Craig-Wood)
.IP \[bu] 2
افزودن گزینه \f[V]--stats-one-line\f[R] برای آمارهای تک‌خطی (Nick
Craig-Wood)
.RE
.IP \[bu] 2
افزودن زمان‌بندی روزهای هفته به \f[V]--bwlimit\f[R] (Mateusz)
.IP \[bu] 2
lsjson: افزودن گزینه برای نمایش شناسه‌های اصلی شیء (Fabian Möller)
.IP \[bu] 2
serve webdav: ایجاد Content-Type بدون خواندن فایل و افزودن
\f[V]--etag-hash\f[R] (Nick Craig-Wood)
.IP \[bu] 2
build
.RS 2
.IP \[bu] 2
ساخت macOS با کامپایلر بومی (Nick Craig-Wood)
.IP \[bu] 2
به‌روزرسانی برای استفاده از go1.11 جهت ساخت (Nick Craig-Wood)
.RE
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن core/stats برای بازگرداندن آمارها (reddi1)
.RE
.IP \[bu] 2
\f[V]version --check\f[R]: چاپ نسخه‌های فعلی انتشار و بتا
(Nick Craig-Wood)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
accounting
.RS 2
.IP \[bu] 2
رفع برآوردهای زمان اتمام (Nick Craig-Wood)
.IP \[bu] 2
رفع سرعت میانگین متحرک برای آمارهای فایل (Nick Craig-Wood)
.RE
.IP \[bu] 2
config: رفع خطای خواندن گذرواژه از ورودی پایپ‌شده (Nick Craig-Wood)
.IP \[bu] 2
move: رفع گزینه \f[V]--delete-empty-src-dirs\f[R] برای حذف تمام دایرکتوری‌های
خالی در هنگام جابه‌جایی (ishuah)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
پیاده‌سازی گزینه \f[V]--daemon-timeout\f[R] برای OSXFUSE (Nick Craig-Wood)
.IP \[bu] 2
رفع کار نکردن mount \f[V]--daemon\f[R] با پیکربندی رمزشده (Alex
Chen)
.IP \[bu] 2
محدود کردن تعداد بلوک‌ها به 2\[ha]32-1 در macOS \- رفع مشکل borg backup
(Nick Craig-Wood)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
فعال‌سازی vfs-read-chunk-size به‌صورت پیش‌فرض (Fabian Möller)
.IP \[bu] 2
افزودن دستور rc با نام vfs/refresh (Fabian Möller)
.IP \[bu] 2
افزودن حالت غیربازگشتی به دستور rc با نام vfs/refresh (Fabian Möller)
.IP \[bu] 2
تلاش برای seek بافر روی فایل‌های فقط‌خواندنی (Fabian Möller)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع فروپاشی هنگام مشخص شدن گزینه منسوخ‌شده‌ی \f[V]--local-no-unicode-normalization\f[R]
(Nick Craig-Wood)
.IP \[bu] 2
رفع خطای mkdir هنگام تلاش برای رونوشت فایل‌ها به ریشه درایو در
windows (Nick Craig-Wood)
.RE
.IP \[bu] 2
Cache
.RS 2
.IP \[bu] 2
رفع nil pointer deref هنگام استفاده از lsjson روی دایرکتوری کش‌شده (Nick
Craig-Wood)
.IP \[bu] 2
رفع nil pointer deref برای فروپاشی گاه‌به‌گاه هنگام بازپخش (Nick Craig-Wood)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
رفع محاسبات (accounting) هنگام بررسی هش‌ها در بارگذاری (Nick Craig-Wood)
.RE
.IP \[bu] 2
Amazon Cloud Drive
.RS 2
.IP \[bu] 2
شفاف‌سازی صریح در مستندات مبنی بر این‌که rclone فاقد کلیدهای ACD است (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Azure Blob
.RS 2
.IP \[bu] 2
افزودن رشته اتصال و احراز هویت SAS URL (Nick Craig-Wood)
.IP \[bu] 2
فهرست کردن کانتینر جهت بررسی موجود بودن آن (Nick Craig-Wood)
.IP \[bu] 2
تطبیق با SDK جدید Azure Blob Storage (sandeepkru)
.IP \[bu] 2
افزودن سطح (tier) بلاب، تغییر سطح میان Hot، Cool و Archive.
(sandeepkru).IP \[bu] 2
حذف / ابتدایی از مسیرها (Nick Craig-Wood)
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
پشتیبانی از Application Keys (Nick Craig-Wood)
.IP \[bu] 2
حذف / ابتدایی از مسیرها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
رفع مشکل بارگذاری فایل‌های بزرگ‌تر از ۲ گیگابایت در بسترهای ۳۲ بیتی (Nick Craig-Wood)
.IP \[bu] 2
تنظیم پیش‌فرض پرچم \f[V]--box-commit-retries\f[R] به ۱۰۰ برای رفع مشکل بارگذاری‌های بزرگ (Nick Craig-Wood)
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--drive-keep-revision-forever\f[R] (lewapm)
.IP \[bu] 2
مدیریت gdocs هنگام پالایش نام فایل‌ها در فهرست (Fabian Möller)
.IP \[bu] 2
پشتیبانی از استفاده از \f[V]--fast-list\f[R] برای افزایش چشمگیر سرعت (Fabian Möller)
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
رفع خطای Put mkParentDir failed: 521 برای BunnyCDN (Nick Craig-Wood)
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
رفع خطای خروج اندیس از محدوده با \f[V]--fast-list\f[R] (Nick
Craig-Wood)
.RE
.IP \[bu] 2
Jottacloud
.RS 2
.IP \[bu] 2
رفع بررسی خطای MD5 (Oliver Heyme)
.IP \[bu] 2
مدیریت مقادیر خالی زمان (Martin Polden)
.IP \[bu] 2
محاسبه MD5های ناموجود (Oliver Heyme)
.IP \[bu] 2
مستندات، رفع اشکال‌ها و آزمون‌ها برای محاسبه MD5 (Nick Craig-Wood)
.IP \[bu] 2
افزودن رابط اختیاری MimeTyper.
(Sebastian Bünger)
.IP \[bu] 2
پیاده‌سازی رابط اختیاری About (برای پشتیبانی از \f[V]df\f[R]).
(Sebastian Bünger)
.RE
.IP \[bu] 2
Mega
.RS 2
.IP \[bu] 2
انتظار برای رخدادها به جای خواب ساختگی (Nick Craig-Wood)
.IP \[bu] 2
افزودن پرچم \f[V]--mega-hard-delete\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع ورود ناموفق با حروف بزرگ در ایمیل (Nick Craig-Wood)
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
پشتیبانی از پوشه‌های اشتراکی (Yoni Jah)
.IP \[bu] 2
پیاده‌سازی DirMove (Cnly)
.IP \[bu] 2
رفع مشکل rmdir در حذف گاه‌به‌گاه پوشه‌های حاوی محتوا (Nick Craig-Wood)
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
حذف فایل‌های نیمه‌بارگذاری‌شده هنگام بروز خطای بارگذاری (Nick Craig-Wood)
.RE
.IP \[bu] 2
Qingstor
.RS 2
.IP \[bu] 2
حذف / ابتدایی از مسیرها (Nick Craig-Wood)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع خطای خروج اندیس از محدوده با \f[V]--fast-list\f[R] (Nick
Craig-Wood)
.IP \[bu] 2
افزودن \f[V]--s3-force-path-style\f[R] (Nick Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی از KMS Key ID (bsteiss)
.IP \[bu] 2
حذف / ابتدایی از مسیرها (Nick Craig-Wood)
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
افزودن \f[V]storage_policy\f[R] (Ruben Vandamme)
.IP \[bu] 2
فراهم‌سازی امکان بازنویسی مجزای \f[V]storage_url\f[R] یا \f[V]auth_token\f[R] (Nick Craig-Wood)
.IP \[bu] 2
رفع باگ کپی سمت سرور برای نام‌های نامتعارف فایل (Nick Craig-Wood)
.IP \[bu] 2
حذف / ابتدایی از مسیرها (Nick Craig-Wood)
.RE
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
اطمینان از فراخوانی MKCOL با نشانی دارای / انتهایی برای هم‌کنش‌پذیری با QNAP (Nick
Craig-Wood)
.IP \[bu] 2
اگر مسیر ریشه با / خاتمه یابد، فایل بودن آن بررسی نشود (Nick
Craig-Wood)
.IP \[bu] 2
عدم پذیرش تغییر مسیرها هنگام خواندن فراداده (Nick Craig-Wood)
.IP \[bu] 2
افزودن پشتیبانی از توکن حامل (Macaroon) برای dCache (Nick Craig-Wood)
.IP \[bu] 2
مستندسازی dCache و Macaroons (Onno Zweers)
.IP \[bu] 2
بازگشت در Sharepoint با عمق متفاوت (Henning)
.IP \[bu] 2
تلاش برای حذف بارگذاری‌های ناموفق (Nick Craig-Wood)
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
رفع فهرست‌گیری/حذف فایل‌ها در ریشه (Nick Craig-Wood)
.RE.SS v1.42 \- 2018-06-16
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
OpenDrive (Oliver Heyme, Jakub Karlicek, ncw)
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
دستور deletefile (Filip Bartodziej)
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
copy، move: رونوشت مستقیم فایل‌های تکی، بدون استفاده از راهکار جایگزین
\f[V]--files-from\f[R]
.RS 2
.IP \[bu] 2
این امر کارایی آن‌ها را بسیار بالاتر می‌برد
.RE
.IP \[bu] 2
پیاده‌سازی پرچم \f[V]--max-transfer\f[R] برای توقف انتقال در یک حد مشخص
.RS 2
.IP \[bu] 2
تنظیم کد خروج ۸ برای زمان فراتر رفتن از سقف \f[V]--max-transfer\f[R]
.RE
.IP \[bu] 2
copy: رونوشت دایرکتوری‌های خالی مبدأ به مقصد (Ishuah Kariuki)
.IP \[bu] 2
check: افزودن پرچم \f[V]--one-way\f[R] (Kasper Byrdal Nielsen)
.IP \[bu] 2
افزودن کنترل‌کننده siginfo برای macOS جهت آمار ctrl-T (kubatasiemski)
.IP \[bu] 2
rc
.RS 2
.IP \[bu] 2
افزودن core/gc برای اجرای جمع‌آوری زباله (garbage collection) بنا به درخواست
.IP \[bu] 2
فعال‌سازی پیش‌فرض پروفایل‌سازی go روی پورت \f[V]--rc\f[R]
.IP \[bu] 2
بازگرداندن خطا از ریموت در صورت بروز شکست
.RE
.IP \[bu] 2
lsf
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--absolute\f[R] برای درج یک / در ابتدای نام مسیرها
.IP \[bu] 2
افزودن پرچم \f[V]--csv\f[R] برای خروجی استاندارد CSV
.IP \[bu] 2
افزودن مشخص‌کننده قالب \[aq]m\[aq] برای نمایش MimeType
.IP \[bu] 2
پیاده‌سازی قالب \[aq]i\[aq] برای نمایش شناسه شیء (object ID)
.RE
.IP \[bu] 2
lsjson
.RS 2
.IP \[bu] 2
افزودن MimeType به خروجی
.IP \[bu] 2
افزودن فیلد ID به خروجی برای نمایش شناسه شیء
.RE
.IP \[bu] 2
افزودن پرچم \f[V]--retries-sleep\f[R] (Benjamin Joseph Dag)
.IP \[bu] 2
سامان‌دهی صفحه وب Oauth و رسیدگی به خطاها (Henning Surmeier)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
اصلاح خروجی اعلان گذرواژه با \f[V]--log-file\f[R] در یونیکس (Filip
Bartodziej)
.IP \[bu] 2
محاسبه در لحظه ModifyWindow در هر مرتبه برای حل مشکلات مختلف
(Stefan Breunig)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
چاپ \[dq]File.rename error\[dq] تنها در صورتی که واقعاً خطایی وجود داشته باشد
(Stefan Breunig)
.IP \[bu] 2
به تعویق انداختن تغییر نام در صورت باز بودن فایل توسط نویسنده‌ها به جای شکست فوری
(Stefan Breunig)
.IP \[bu] 2
اطمینان از اجرای atexit هنگام دریافت وقفه (interrupt)
.IP \[bu] 2
بهبودهای macOS
.RS 2
.IP \[bu] 2
تبدیل \f[V]--noappledouble\f[R] به \f[V]--noapplexattr\f[R]
.IP \[bu] 2
افزودن پرچم \f[V]--volname\f[R] و حذف نویسه‌های خاص از آن
.IP \[bu] 2
تنظیم Get/List/Set/Remove xattr بر بازگرداندن ENOSYS برای افزایش کارایی
.IP \[bu] 2
به‌کاراندازی \f[V]--daemon\f[R] در macOS بدون نیاز به CGO
.RE
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
افزودن \f[V]--vfs-read-chunk-size\f[R] و
\f[V]--vfs-read-chunk-size-limit\f[R] (Fabian Möller)
.IP \[bu] 2
اصلاح ChangeNotify برای پوشه‌های جدید یا تغییریافته (Fabian Möller)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
اصلاح مدیریت دایرکتوری‌های symlink/junction point در Windows
.RS 2
.IP \[bu] 2
\f[B]توجه:\f[R] برای رونوشت فایل‌ها با نقاط تجزیه مجدد (reparse points) باید
\f[V]-L\f[R] را به خط فرمان خود بیفزایید
.RE
.RE
.IP \[bu] 2
Cache
.RS 2
.IP \[bu] 2
افزودن دایرکتوری‌های کش‌نشده در اعلان‌ها (Remus Bunduc)
.IP \[bu] 2
امکان منقضی کردن root از طریق rc (Remus Bunduc)
.IP \[bu] 2
پاک‌سازی پوشه‌های خالی باقی‌مانده از مسیر بارگذاری موقت (Remus Bunduc)
.IP \[bu] 2
کش کردن فهرست‌ها با استفاده از نوشتن دسته‌ای (Remus Bunduc)
.IP \[bu] 2
استفاده از وب‌سوکت‌های امن برای نشانی‌های HTTPS در Plex (John Clayton)
.IP \[bu] 2
اتصال مجدد وب‌سوکت Plex در صورت بروز خطا (Remus Bunduc)
.IP \[bu] 2
رفع خطای panic هنگام اجرا بدون پیکربندی‌های Plex (Remus Bunduc)
.IP \[bu] 2
اصلاح کش کردن پوشه ریشه (Remus Bunduc)
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
بررسی هش رمزگذاری‌شده فایل‌ها هنگام بارگذاری برای امنیت مضاعف داده‌ها
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
دسترسی‌پذیر ساختن پوشه‌های تجاری Dropbox با استفاده از یک
\f[V]/\f[R] ابتدایی در مسیر
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
تلاش مجدد سطح پایین (low-level retry) برای تمام عملیات‌ها در صورت لزوم
.RE
.IP \[bu] 2
Google Drive
.RS 2
.IP \[bu] 2
افزودن \f[V]--drive-acknowledge-abuse\f[R] برای بارگیری فایل‌های پرچمدار شده
.IP \[bu] 2
افزودن \f[V]--drive-alternate-export\f[R] برای اصلاح خروجی گرفتن از اسناد حجیم
.IP \[bu] 2
عدم اقدام به انتخاب Team Drives هنگام استفاده از rclone config create
.IP \[bu] 2
اصلاح بررسی دوره‌ای (polling) فهرست تغییرات در Team Drives
.IP \[bu] 2
اصلاح ChangeNotify برای پوشه‌ها (Fabian Möller)
.IP \[bu] 2
اصلاح دستور about (و df روی یک نقطه اتصال mount) برای Team Drives
.RE
.IP \[bu] 2
Onedrive
.RS 2.IP \[bu] 2
مدیریت‌کننده خطا برای درخواست‌های onedrive for business (Henning Surmeier)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
تنظیم هم‌زمانی بارگذاری با \f[V]--s3-upload-concurrency\f[R]
(themylogin)
.IP \[bu] 2
رفع اشکال \f[V]--s3-chunk-size\f[R] که همیشه از کمینه استفاده می‌کرد
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--ssh-path-override\f[R] (Piotr Oleszczyk)
.IP \[bu] 2
رفع کندی بارگیری در اتصالات با تاخیر زیاد
.RE
.IP \[bu] 2
Webdav
.RS 2
.IP \[bu] 2
افزودن راهکار موقت برای biz.mail.ru
.IP \[bu] 2
نادیده گرفتن Reason-Phrase در خط وضعیت برای رفع اشکال 4shared (Rodrigo)
.IP \[bu] 2
بهبود در تولید پیام‌های خطا
.RE
.SS v1.41 - 2018-04-28
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
پشتیبانی از Mega افزوده شد
.IP \[bu] 2
پشتیبانی Webdav از احراز هویت کوکی SharePoint (hensur)
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
link: ایجاد پیوند عمومی به فایل‌ها و پوشه‌ها (Stefan Breunig)
.IP \[bu] 2
about: دریافت اطلاعات سهمیه مصرفی (quota) از ریموت (a-roussos, ncw)
.IP \[bu] 2
hashsum: ابزاری عمومی برای هر نوع هش جهت تولید خروجی مشابه md5sum
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
lsd: افزودن پرچم -R و رفع اشکال و به‌روزرسانی مستندات تمام دستورهای ls
.IP \[bu] 2
ncdu: افزودن کلید \[dq]تازه‌سازی\[dq] \- ترکیب CTRL-L (Keith Goldfarb)
.IP \[bu] 2
serve restic: افزودن حالت فقط-الحاقی (append-only) (Steve Kriss)
.IP \[bu] 2
serve restic: عدم اجازه بازنویسی فایل‌ها در حالت فقط-الحاقی (Alexander
Neumann)
.IP \[bu] 2
serve restic: چاپ نشانی واقعی شنودکننده (Matt Holt)
.IP \[bu] 2
size: افزودن پرچم --json (Matthew Holt)
.IP \[bu] 2
sync: پیاده‌سازی --ignore-errors (Mateusz Pabian)
.IP \[bu] 2
dedupe: افزودن قابلیت حذف تکرار با حفظ بزرگ‌ترین مورد (Richard Yang)
.IP \[bu] 2
fs: گسترش SizeSuffix برای پشتیبانی از TB و PB در rclone about
.IP \[bu] 2
fs: افزودن --dump goroutines و --dump openfiles برای اشکال‌زدایی
.IP \[bu] 2
rc: پیاده‌سازی core/memstats جهت چاپ اطلاعات استفاده از حافظه داخلی
.IP \[bu] 2
rc: فراخوانی جدید rc/pid (Michael P.
Dubner)
.RE
.IP \[bu] 2
کامپایل
.RS 2
.IP \[bu] 2
حذف پشتیبانی از go1.6
.RE
.IP \[bu] 2
انتشار
.RS 2
.IP \[bu] 2
رفع اشکال \f[V]make tarball\f[R] (Chih-Hsuan Yen)
.RE
.IP \[bu] 2
رفع اشکال‌ها
.RS 2
.IP \[bu] 2
filter: رفع بررسی هم‌زمان --min-age و --max-age
.IP \[bu] 2
fs: محدود کردن MaxIdleConns و MaxIdleConnsPerHost در transport
.IP \[bu] 2
lsd,lsf: اطمینان از اینکه تمامی زمان‌های خروجی به وقت محلی باشند
.IP \[bu] 2
rc: رفع مشکل تنظیم bwlimit به حالت نامحدود
.IP \[bu] 2
rc: لحاظ کردن پرچم --rc-addr طبق مستندات
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
استفاده از About برای بازگرداندن مقادیر صحیح کل/مصرفی/آزاد دیسک (مثلاً
در \f[V]df\f[R])
.IP \[bu] 2
تنظیم مقدار پیش‌فرض \f[V]--attr-timeout default\f[R] روی \f[V]1s\f[R] \- رفع موارد زیر:
.RS 2
.IP \[bu] 2
مصرف بیش از حد حافظه توسط rclone
.IP \[bu] 2
عدم ارائه فایل‌ها به samba توسط rclone
.IP \[bu] 2
زمان بیش از اندازه برای فهرست کردن دایرکتوری‌ها
.RE
.IP \[bu] 2
رفع اشکال \f[V]df -i\f[R] (اصلاح بالادستی)
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
فیلتر کردن فایل‌های \f[V].\f[R] و \f[V]..\f[R] از فهرست دایرکتوری
.IP \[bu] 2
ایجاد کَش VFS تنها در صورتی که --vfs-cache-mode > Off باشد
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
افزودن --local-no-check-updated جهت غیرفعال کردن بررسی فایل‌های به‌روز شده
.IP \[bu] 2
تلاش دوباره برای حذف در صورت بروز خطای تداخل اشتراک‌گذاری ویندوز
.RE
.IP \[bu] 2
Cache
.RS 2
.IP \[bu] 2
تخلیه کَش حافظه پس از بسته شدن
.IP \[bu] 2
پاک‌سازی داده‌های فایل با دریافت اعلان
.IP \[bu] 2
همیشه دایرکتوری والد برای اعلان‌ها نادیده گرفته شود
.IP \[bu] 2
یکپارچه‌سازی با وب‌سوکت Plex
.IP \[bu] 2
افزودن rc cache/stats (seuffert)
.IP \[bu] 2
افزودن لاگ info در هنگام دریافت اعلان
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
رفع خطا در خواندن دایرکتوری‌های بزرگ \- تجزیه اندازه فایل/دایرکتوری به عنوان
ممیز شناور (float)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
رفع اشکال crypt+obfuscate در dropbox
.IP \[bu] 2
رفع مشکل بارگذاری مکرر فایل‌های یکسان
.RE
.IP \[bu] 2
FTP
.RS 2
.IP \[bu] 2
راهکار موقت برای پاسخ غیرعادی از سرور FTP مربوط به box
.IP \[bu] 2
راهکارهای موقت بیشتر برای سرورهای FTP جهت رفع خطای mkParentDir
.IP \[bu] 2
رفع عدم نمایش خطا هنگام فهرست کردن دایرکتوری ناموجود
.RE.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
افزودن service_account_credentials (Matt Holt)
.IP \[bu] 2
تشخیص وجود باکت (bucket) از طریق فهرست کردن آن \- به حداقل رساندن مجوزهای مورد نیاز
.IP \[bu] 2
نادیده گرفتن نشانگرهای پوشه با طول صفر
.RE
.IP \[bu] 2
Google Drive
.RS 2
.IP \[bu] 2
افزودن service_account_credentials (Matt Holt)
.IP \[bu] 2
رفع اشکال انتقال پوشه که موجب برجا ماندن یک پوشه با پیوند سخت (hardlink) می‌شد
.IP \[bu] 2
بازگرداندن خطاهای مناسب Google هنگام باز کردن فایل‌ها
.IP \[bu] 2
هنگام مقداردهی اولیه با یک مسیر فایل، ویژگی‌های اختیاری از مسیر ریشهٔ نادرست استفاده می‌کردند (Stefan Breunig)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
رفع اشکال همگام‌سازی برای سرورهایی که Content-Length را در پاسخ HEAD بازنمی‌گردانند
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از QuickXorHash برای OneDrive for business
.IP \[bu] 2
رفع نشت سوکت در بارگذاری نشست‌های چندبخشی (multipart session upload)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
جستجو در فایل‌های نمایهٔ نام‌گذاری‌شدهٔ (named profile) مربوط به S3 برای اطلاعات احراز هویت
.IP \[bu] 2
افزودن \f[V]--s3-disable-checksum\f[R] برای غیرفعال کردن بارگذاری جمع‌آزمایی (checksum) (Chris
Redekop)
.IP \[bu] 2
پشتیبانی از پیکربندی سلسله‌مراتبی (Giri Badanahatti)
.IP \[bu] 2
افزودن تنظیمات پیکربندی برای تمامی ارائه‌دهندگان پشتیبانی‌شدهٔ S3
.IP \[bu] 2
افزودن کلاس ذخیره‌سازی One Zone Infrequent Access (Craig Rachel)
.IP \[bu] 2
افزودن پشتیبانی از --use-server-modtime (Peter Baumgartner)
.IP \[bu] 2
افزودن گزینهٔ --s3-chunk-size برای واپایش بارگذاری‌های چندبخشی
.IP \[bu] 2
نادیده گرفتن نشانگرهای پوشه با طول صفر
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
به‌روزرسانی مستندات جهت تطابق با کد، رفع غلط‌های املایی و شفاف‌سازی اعلان disable_hashcheck
(Michael G.
Noll)
.IP \[bu] 2
به‌روزرسانی مستندات درباره رفتارهای خاص Synology
.IP \[bu] 2
شکست ملایم (fail soft) با ثبت پیام اشکال‌زدایی (debug) در صورت بروز خطای هش
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از --use-server-modtime (Peter Baumgartner)
.RE
.IP \[bu] 2
Webdav
.RS 2
.IP \[bu] 2
پشتیبانی از احراز هویت مبتنی بر کوکی برای SharePoint (hensur)
.IP \[bu] 2
حذف نویسهٔ / از ابتدا و انتهای root
.RE.SS v1.40 - 2018-03-19
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
بک‌اند Alias برای ایجاد نام‌های مستعار برای نام‌های ریموت موجود (Fabian
Möller)
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
\f[V]lsf\f[R]: فهرست‌گیری برای اهداف پردازش و تجزیه (Jakub Tasiemski)
.RS 2
.IP \[bu] 2
به‌طور پیش‌فرض این یک فهرست‌گیری ساده و غیربازگشتی از فایل‌ها و دایرکتوری‌ها است
.IP \[bu] 2
می‌توان آن را به گونه‌ای پیکربندی کرد که اطلاعات بیشتری را در قالبی با تجزیه آسان اضافه کند
.RE
.IP \[bu] 2
\f[V]serve restic\f[R]: برای ارائه یک ریموت به عنوان نقطه انتهایی REST برای Restic
.RS 2
.IP \[bu] 2
این قابلیت به restic امکان می‌دهد تا از هر بک‌اندی که rclone به آن دسترسی دارد استفاده کند
.IP \[bu] 2
با تشکر از Alexander Neumann برای کمک‌ها، وصله‌ها و بازبینی
.RE
.IP \[bu] 2
\f[V]rc\f[R]: فعال‌سازی کنترل از راه دور یک نمونه در حال اجرای rclone
.RS 2
.IP \[bu] 2
نمونه rclone در حال اجرا باید با پرچم \f[V]--rc\f[R] و پرچم‌های مرتبط راه‌اندازی شده باشد.
.IP \[bu] 2
در حال حاضر پشتیبانی از bwlimit و تخلیه حافظه پنهان (flushing) برای mount و
cache وجود دارد.
.RE
.RE
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
پرچم \f[V]--max-delete\f[R] برای افزودن آستانه حذف (Bjørn Erik
Pedersen)
.IP \[bu] 2
تمامی بک‌اندها اکنون از RangeOption برای Open بازه‌ای پشتیبانی می‌کنند
.RS 2
.IP \[bu] 2
\f[V]cat\f[R]: استفاده از RangeOption برای دریافت‌های محدود به منظور کارایی بیشتر
.IP \[bu] 2
\f[V]cryptcheck\f[R]: کارآمدتر کردن خواندن nonce با RangeOption
.RE
.IP \[bu] 2
دستورات serve http/webdav/restic
.RS 2
.IP \[bu] 2
پشتیبانی از SSL/TLS
.IP \[bu] 2
افزودن \f[V]--user\f[R]، \f[V]--pass\f[R] و \f[V]--htpasswd\f[R] برای
احراز هویت
.RE
.IP \[bu] 2
\f[V]copy\f[R]/\f[V]move\f[R]: تشخیص تغییر اندازه فایل در حین رونوشت/انتقال
و لغو فرایند انتقال (ishuah)
.IP \[bu] 2
\f[V]cryptdecode\f[R]: افزودن گزینه‌ای برای بازگرداندن نام‌های فایل رمزگذاری‌شده.
(ishuah)
.IP \[bu] 2
\f[V]lsjson\f[R]: افزودن \f[V]--encrypted\f[R] برای نمایش نام رمزگذاری‌شده
(Jakub Tasiemski)
.IP \[bu] 2
افزودن \f[V]--stats-file-name-length\f[R] جهت مشخص کردن طول نام فایل چاپ‌شده
برای آمار (Will Gunn)
.RE
.IP \[bu] 2
کامپایل
.RS 2
.IP \[bu] 2
کد پایه بازآرایی و ساختاربندی مجدد شد
.RS 2
.IP \[bu] 2
بک‌اندها به یک دایرکتوری backend منتقل شدند
.IP \[bu] 2
بسته‌های بزرگ تجزیه و تقسیم شدند
.IP \[bu] 2
برای کسب اطلاعات درباره ساختار جدید فایل‌ها، سند CONTRIBUTING.md را ببینید
.RE
.IP \[bu] 2
به‌روزرسانی به استفاده از go1.10 به عنوان نسخه پیش‌فرض go
.IP \[bu] 2
پیاده‌سازی آزمون‌های یکپارچه‌سازی کامل
روزانه (https://pub.rclone.org/integration-tests)
.RE
.IP \[bu] 2
انتشار
.RS 2
.IP \[bu] 2
شامل کردن بایگانی tarball سورس‌کد و امضای دیجیتال آن و باینری‌ها
.IP \[bu] 2
امضای برچسب‌های git به عنوان بخشی از فرایند انتشار
.IP \[bu] 2
افزودن بسته‌های .deb و .rpm به عنوان بخشی از فرایند ساخت
.IP \[bu] 2
ایجاد انتشار بتا برای تمام شاخه‌ها در مخزن اصلی (به‌جز pull
requestها)
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
config: رفع خطاهای مربوط به پیکربندی ناموجود از طریق بارگذاری فایل پیکربندی تنها
در اولین دسترسی
.IP \[bu] 2
config: تلاش مجدد برای ذخیره پیکربندی پس از شکست (Mateusz)
.IP \[bu] 2
sync: هنگام استفاده از \f[V]--backup-dir\f[R]، اگر modtime فایل‌ها قابل تنظیم
نباشد، آن‌ها را حذف نکنید
.RS 2
.IP \[bu] 2
این تغییر رفتار غیرعادی در تعامل Dropbox و \f[V]--backup-dir\f[R] را برطرف می‌کند
.RE
.IP \[bu] 2
fshttp: رفع مهلت‌های زمانی بیکاری (idle timeouts) برای اتصال‌های HTTP
.IP \[bu] 2
\f[V]serve http\f[R]: رفع مشکل ارائه فایل‌هایی که در نام آن‌ها علامت : وجود دارد
.IP \[bu] 2
اصلاح \f[V]--exclude-if-present\f[R] جهت نادیده گرفتن دایرکتوری‌هایی که برای آن‌ها
مجوز دسترسی وجود ندارد (Iakov Davydov)
.IP \[bu] 2
عملکرد صحیح بخش حسابداری ترافیک (accounting) در crypt و b2
.IP \[bu] 2
حذف پرچم \f[V]--no-traverse\f[R] به دلیل منسوخ شدن
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]--attr-timeout\f[R] برای کنترل کش مشخصات (attribute caching) در هسته
.RS 2
.IP \[bu] 2
مقدار پیش‌فرض آن اکنون 0 است که درست بوده اما کارایی کمتری دارد
.IP \[bu] 2
برای اطلاعات بیشتر، مستندات
mount (https://rclone.org/commands/rclone_mount/#attribute-caching) را
ببینید
.RE
.IP \[bu] 2
افزودن پرچم \f[V]--daemon\f[R] برای اجازه دادن به اجرای mount در پس‌زمینه
(ishuah)
.IP \[bu] 2
اصلاح: بازگرداندن ENOSYS به جای EIO هنگام تلاش برای پیوند (link)
.RS 2
.IP \[bu] 2
این مورد دسترسی FileZilla به mount ارائه‌شده rclone روی sftp را برطرف می‌کند.
.RE
.IP \[bu] 2
رفع مشکل دو بار تنظیم شدن modtime
.IP \[bu] 2
آزمون‌های Mount اکنون روی CI برای Linux (نسخه‌های mount و cmount)، Mac و Windows اجرا می‌شوند
.IP \[bu] 2
رفع باگ‌های متعدد در لایه VFS \- موارد زیر را ببینید
.RE
.IP \[bu] 2
VFS
.RS 2
.IP \[bu] 2
اصلاحات متعدد برای \f[V]--vfs-cache-mode\f[R] در حالت writes و بالاتر
.RS 2
.IP \[bu] 2
به‌روزرسانی نسخه کش‌شده در صورت آگاهی از تغییر آن (رفع داده‌های بیات)
.IP \[bu] 2
پاک‌سازی نام مسیرها پیش از استفاده از آن‌ها در حافظه پنهان
.IP \[bu] 2
غیرفعال کردن پاک‌کننده حافظه پنهان اگر \f[V]--vfs-cache-poll-interval=0\f[R] باشد
.IP \[bu] 2
پر کردن و پاک‌سازی اولیه حافظه پنهان بلافاصله در هنگام راه‌اندازی
.RE
.IP \[bu] 2
رفع مشکل باز کردن تمام فایل‌ها توسط Windows هنگام بررسی وضعیت (stat) آن‌ها.IP \[bu] 2
اصلاح اعمال modtime برای یک Write Handle باز
.IP \[bu] 2
اصلاح ایجاد فایل‌ها هنگام کوتاه‌سازی (truncating)
.IP \[bu] 2
نوشتن ۰ بایت هنگام تخلیه (flushing) دستگیره‌های نوشته‌نشده برای جلوگیری از شرایط مسابقه
در FUSE
.IP \[bu] 2
تنزل پیام \[dq]poll-interval is not supported\[dq] به Info
.IP \[bu] 2
تنظیم OpenFile و توابع مرتبط برای بازگرداندن EINVAL در صورت وجود هم‌زمان O_RDONLY و O_TRUNC
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
تنزل پیام \[dq]invalid cross-device link: trying copy\[dq] به debug
.IP \[bu] 2
تنظیم DirMove جهت بازگرداندن fs.ErrorCantDirMove برای امکان استفاده جایگزین از Copy در
حالت بین‌دستگاهی (cross device)
.IP \[bu] 2
رفع شرایط مسابقه هنگام به‌روزرسانی هش‌ها
.RE
.IP \[bu] 2
Cache
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از polling \- به‌روزرسانی حافظه موقت (cache) با اعمال تغییرات در ریموت
در backendهای پشتیبانی‌شده
.IP \[bu] 2
کاهش سطح لاگ برای Plex api
.IP \[bu] 2
رفع مشکل حافظه موقت دایرکتوری (dir cache)
.IP \[bu] 2
پیاده‌سازی پرچم \f[V]--cache-db-wait-time\f[R]
.IP \[bu] 2
بهبود کارایی با RangeOption و RangeSeek
.IP \[bu] 2
رفع مشکل dirmove در صورت فعال بودن temp fs
.IP \[bu] 2
اطلاع‌رسانی به vfs هنگام استفاده از temp fs
.IP \[bu] 2
بارگذاری برون‌خط (Offline uploading)
.IP \[bu] 2
پشتیبانی کنترل از راه دور برای تخلیه مسیر (path flushing)
.RE
.IP \[bu] 2
Amazon cloud drive
.RS 2
.IP \[bu] 2
‏rclone دیگر کلید فعالی ندارد \- غیرفعال‌سازی آزمون‌های یکپارچه‌سازی
.IP \[bu] 2
پیاده‌سازی DirChangeNotify برای اطلاع‌رسانی تغییرات به cache/vfs/mount
.RE
.IP \[bu] 2
Azureblob
.RS 2
.IP \[bu] 2
عدم بررسی وجود باکت/کانتینر در صورت موفقیت فهرست‌گیری (listing)
.RS 2
.IP \[bu] 2
این امر باعث می‌شود rclone در هر فراخوانی یک درخواست کمتر ارسال کند
.RE
.IP \[bu] 2
بهبود ثبت و محاسبه اطلاعات بارگذاری‌های تکه‌ای (chunked uploads)
.RE
.IP \[bu] 2
Backblaze B2
.RS 2
.IP \[bu] 2
عدم بررسی وجود باکت/کانتینر در صورت موفقیت فهرست‌گیری (listing)
.RS 2
.IP \[bu] 2
این امر باعث می‌شود rclone در هر فراخوانی یک درخواست کمتر ارسال کند
.RE
.RE
.IP \[bu] 2
Box
.RS 2
.IP \[bu] 2
بهبود ثبت و محاسبه اطلاعات بارگذاری‌های تکه‌ای (chunked uploads)
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
اصلاح پارامترهای سفارشی کلاینت oauth
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
عدم بررسی وجود باکت/کانتینر در صورت موفقیت فهرست‌گیری (listing)
.RS 2
.IP \[bu] 2
این امر باعث می‌شود rclone در هر فراخوانی یک درخواست کمتر ارسال کند
.RE
.RE
.IP \[bu] 2
Google Drive
.RS 2
.IP \[bu] 2
مهاجرت به api v3 (توسط Fabian Möller)
.IP \[bu] 2
افزودن پیکربندی دامنه دسترسی (scope) و امکان انتخاب پوشه ریشه
.IP \[bu] 2
افزودن \f[V]--drive-impersonate\f[R] برای حساب‌های سرویس (service accounts)
.RS 2
.IP \[bu] 2
با تشکر از همه کسانی که آزمایش کردند، کاوش نمودند و در مستندات مشارکت داشتند
.RE
.IP \[bu] 2
افزودن \f[V]--drive-use-created-date\f[R] جهت استفاده از تاریخ ایجاد به‌جای تاریخ
ویرایش (توسط nbuchanan)
.IP \[bu] 2
درخواست فرمت‌های برون‌بری (export formats) تنها در صورت نیاز
.RS 2
.IP \[bu] 2
این امر باعث افزایش سرعت rclone در صورت عدم وجود اسناد google docs می‌شود
.RE
.IP \[bu] 2
رفع مشکل پیدا کردن مسیرهای حاوی نویسه‌های latin1 (یک راهکار موقت برای باگ drive)
.IP \[bu] 2
اصلاح کپی‌کردن یک فایل تکی Google doc
.IP \[bu] 2
اصلاح \f[V]--drive-auth-owner-only\f[R] جهت جست‌وجو در همه دایرکتوری‌ها
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
اصلاح مدیریت دایرکتوری‌های حاوی &
.RE
.IP \[bu] 2
Onedrive
.RS 2
.IP \[bu] 2
حذف حد آستانه بارگذاری و استفاده همیشگی از بارگذاری‌های مبتنی بر نشست (session uploads)
.RS 2
.IP \[bu] 2
این امر مانع از ایجاد نسخه‌های متعدد در business onedrive می‌شود
.RE
.IP \[bu] 2
رونویسی مقدار اندازه شیء با اندازه واقعی هنگام خواندن فایل.
(توسط Victor)
.RS 2
.IP \[bu] 2
این اصلاح رفتارهای نامتعارف ناشی از گزارش نادرست اندازه تصاویر در onedrive را برطرف می‌کند
.RE
.RE
.IP \[bu] 2
Pcloud
.RS 2
.IP \[bu] 2
حذف کدها و پرچم بلااستفاده بارگذاری تکه‌ای (chunked upload)
.RE
.IP \[bu] 2
Qingstor
.RS 2
.IP \[bu] 2
عدم بررسی وجود باکت/کانتینر در صورت موفقیت فهرست‌گیری (listing)
.RS 2
.IP \[bu] 2
این امر باعث می‌شود rclone در هر فراخوانی یک درخواست کمتر ارسال کند
.RE
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
پشتیبانی از هش‌ها برای فایل‌های چندبخشی (multipart) (توسط Chris Redekop)
.IP \[bu] 2
پشتیبانی اولیه از IBM COS (S3) (توسط Giri Badanahatti)
.IP \[bu] 2
به‌روزرسانی مستندات جهت نهی از استفاده از احراز هویت v2 در CEPH و موارد دیگر
.IP \[bu] 2
عدم بررسی وجود باکت/کانتینر در صورت موفقیت فهرست‌گیری (listing)
.RS 2
.IP \[bu] 2
این امر باعث می‌شود rclone در هر فراخوانی یک درخواست کمتر ارسال کند
.RE.IP \[bu] 2
رفع مشکل کپی در سمت سرور و تنظیم modtime روی فایل‌های حاوی +
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن گزینه‌ای برای غیرفعال کردن اجرای دستور بررسی هش راه‌دور (Jon Fautley)
.IP \[bu] 2
افزودن پرچم \f[V]--sftp-ask-password\f[R] جهت درخواست گذرواژه در هنگام
نیاز (Leo R.
Lundgren)
.IP \[bu] 2
افزودن گزینهٔ پیکربندی \f[V]set_modtime\f[R]
.IP \[bu] 2
رفع مشکل دنبال کردن پیوندهای نمادین
.IP \[bu] 2
رفع مشکل خواندن فایل پیکربندی خارج از راه‌اندازی Fs
.IP \[bu] 2
رفع مشکل خواندن $USER در حالت بازگشتی نام کاربری به‌جای $HOME
.IP \[bu] 2
رفع مشکل اجرا تحت crontab \- استفاده از روش صحیح سیستم‌عامل برای خواندن نام کاربری
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
رفع مشکل تازه‌سازی توکن احراز هویت
.RS 2
.IP \[bu] 2
در v1.39 باگی ایجاد شده بود که توکن‌های جدید را نادیده می‌گرفت \- این مورد آن را برطرف می‌کند
.RE
.IP \[bu] 2
رفع تراکنش اضافی HEAD هنگام بارگذاری یک فایل جدید
.IP \[bu] 2
عدم بررسی وجود bucket/container در صورت موفق بودن فهرست‌گیری
.RS 2
.IP \[bu] 2
این کار باعث می‌شود rclone در هر بار اجرا یک درخواست کمتر ارسال کند
.RE
.RE
.IP \[bu] 2
Webdav
.RS 2
.IP \[bu] 2
افزودن قالب‌های زمانی جدید برای پشتیبانی از mydrive.ch و سایر موارد
.RE
.SS v1.39 - 2017-12-23
.IP \[bu] 2
پس‌انه‌های جدید
.RS 2
.IP \[bu] 2
WebDAV
.RS 2
.IP \[bu] 2
آزمایش‌شده با nextcloud، owncloud، put.io و غیره!
.RE
.IP \[bu] 2
Pcloud
.IP \[bu] 2
cache \- قرار دادن یک لایهٔ کش دور سایر پس‌انه‌ها (Remus Bunduc)
.RS 2
.IP \[bu] 2
کاربردی در ترکیب با mount
.IP \[bu] 2
توجه: این قابلیت آزمایشی (بتا) است، بنابراین با احتیاط استفاده شود
.RE
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
دستور serve همراه با زیردستورهای:
.RS 2
.IP \[bu] 2
serve webdav: پیاده‌سازی یک کارساز webdav برای هر ریموت rclone.
.IP \[bu] 2
serve http: دستوری برای ارائهٔ یک ریموت از طریق HTTP
.RE
.IP \[bu] 2
config: افزودن زیردستورهایی برای مدیریت کامل فایل پیکربندی
.RS 2
.IP \[bu] 2
create/delete/dump/edit/file/password/providers/show/update
.RE
.IP \[bu] 2
touch: برای ایجاد یا به‌روزرسانی برچسب زمان یک فایل (Jakub Tasiemski)
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
امکان نصب rclone با curl (Filip Bartodziej)
.IP \[bu] 2
گزینهٔ --stats اکنون درصد، اندازه، سرعت و زمان تقریبی باقی‌مانده (ETA) را به صورت فشرده نمایش می‌دهد
(Ishuah Kariuki)
.IP \[bu] 2
گزینهٔ --exclude-if-present برای مستثنی کردن یک دایرکتوری در صورت وجود یک فایل (Iakov
Davydov)
.IP \[bu] 2
rmdirs: افزودن پرچم --leave-root (lewapm)
.IP \[bu] 2
move: افزودن پرچم --delete-empty-src-dirs برای حذف دایرکتوری‌ها پس از انتقال (Ishuah
Kariuki)
.IP \[bu] 2
افزودن پرچم --dump، معرفی requests و responses برای --dump و حذف
--dump-auth و --dump-filters
.RS 2
.IP \[bu] 2
مبهم‌سازی :X-Auth-Token در سرایندها هنگام خروجی گرفتن نیز
.RE
.IP \[bu] 2
مستندسازی و پیاده‌سازی کدهای خروج برای حالت‌های مختلف خطا (Ishuah
Kariuki)
.RE
.IP \[bu] 2
Compile
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
تلاش مجدد در انواع بسیار بیشتری از خطاها برای قابل‌اطمینان‌تر کردن انتقال‌های چندبخشی
.IP \[bu] 2
ذخیرهٔ پیکربندی پیش از درخواست توکن، که ناپدید شدن پیکربندی oauth را برطرف می‌کند
.IP \[bu] 2
هشدار به کاربر در صورت استفادهٔ هم‌زمان از --include و --exclude (Ernest
Borowski)
.IP \[bu] 2
رفع مشکل فایل‌های تکراری (مثلاً
در Google drive) که باعث رونوشت‌های ناخواسته می‌شد
.IP \[bu] 2
مجاز بودن فاصله‌های خالی ابتدا و انتهای گذرواژه‌ها (Jason Rose)
.IP \[bu] 2
ncdu: رفع خرابی روی دایرکتوری‌های خالی
.IP \[bu] 2
rcat: رفع نشت goroutine
.IP \[bu] 2
moveto/copyto: رفع مشکل برای امکان کپی با همان نام
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
حالت --vfs-cache برای مطمئن‌تر ساختن نوشتن در مانت‌ها.
.RS 2
.IP \[bu] 2
این امر نیازمند کش کردن فایل‌ها روی دیسک است (مشاهده کنید: --cache-dir)
.IP \[bu] 2
از آنجا که این قابلیتی جدید است، با احتیاط استفاده شود
.RE
.IP \[bu] 2
استفاده از sdnotify برای اعلام آماده بودن مانت به systemd (Fabian Möller)
.IP \[bu] 2
بررسی خالی نبودن دایرکتوری پیش از مانت کردن (Ernest Borowski)
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
افزودن پیام خطا برای جابه‌جایی‌های بین دو فایل‌سیستم مختلف
.IP \[bu] 2
رفع مشکل بررسی برابری زمان‌ها
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
بازطراحی بارگذاری چندبخشی
.RS 2
.IP \[bu] 2
بافر کردن قطعه‌ها هنگام بارگذاری فایل‌های بزرگ تا امکان تلاش مجدد وجود داشته باشد
.IP \[bu] 2
تغییر اندازه پیش‌فرض قطعه به 48MB با توجه به بافر شدن آن‌ها در حافظه
.IP \[bu] 2
تلاش مجدد برای هر خطا پس از تکمیل موفقیت‌آمیز قطعهٔ اول
.RE
.IP \[bu] 2
رفع خطا هنگام تغییر نام دایرکتوری‌ها
.RE.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
رفع کرش هنگام احراز هویت نادرست
.RE
.IP \[bu] 2
Google Drive
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از service account (با تشکر از Tim Cooijmans)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
کارکرد صحیح با Digital Ocean Spaces (با تشکر از Andrew
Starr-Bochicchio)
.IP \[bu] 2
رفع کرش در صورت دریافت فهرست‌بندی نامعتبر
.IP \[bu] 2
افزودن پشتیبانی از نقش‌های IAM در تسک‌های ECS (با تشکر از David Minor)
.RE
.IP \[bu] 2
Backblaze B2
.RS 2
.IP \[bu] 2
رفع اشکال تلاش مجدد در بارگذاری‌های چندبخشی (multipart upload)
.IP \[bu] 2
رفع اشکال \f[V]\-\-hard-delete\f[R] برای کارکرد در ۱۰۰٪ مواقع
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
امکان احراز هویت با storage URL و auth key (با تشکر از Giovanni Pizzi)
.IP \[bu] 2
افزودن فیلدهای جدید به پیکربندی swift برای پشتیبانی از IBM Bluemix Swift
(با تشکر از Pierre Carlson)
.IP \[bu] 2
افزودن OS_TENANT_ID و OS_USER_ID به پیکربندی
.IP \[bu] 2
امکان پیکربندی با شناسه کاربری (user id) به جای نام کاربری
.IP \[bu] 2
بررسی وجود کانتینر قطعات در swift پیش از ایجاد آن (با تشکر از John Leach)
.IP \[bu] 2
رفع نشت حافظه در انتقال‌های swift (اصلاح از بالادست)
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن گزینه‌ای برای فعال‌سازی استفاده از الگوریتم رمزنگاری aes128-cbc (با تشکر از Jon Fautley)
.RE
.IP \[bu] 2
Amazon cloud drive
.RS 2
.IP \[bu] 2
رفع خطای بارگیری فایل‌های حجیم با پیام \[dq]Only one auth mechanism
allowed\[dq]
.RE
.IP \[bu] 2
crypt
.RS 2
.IP \[bu] 2
گزینه‌ای برای رمزنگاری نام دایرکتوری‌ها یا دست‌نخورده باقی گذاشتن آن‌ها
.IP \[bu] 2
پیاده‌سازی DirChangeNotify (با تشکر از Fabian Möller)
.RE
.IP \[bu] 2
onedrive
.RS 2
.IP \[bu] 2
افزودن گزینه‌ای برای انتخاب resourceURL هنگام راه‌اندازی حساب OneDrive Business
در صورتی که بیش از یکی برای کاربر در دسترس باشد
.RE
.SS v1.38 \- 2017-09-30
.IP \[bu] 2
بک‌اندهای جدید
.RS 2
.IP \[bu] 2
فضای ذخیره‌سازی Azure Blob (با تشکر از Andrei Dragomir)
.IP \[bu] 2
Box
.IP \[bu] 2
سرویس OneDrive for Business (با تشکر از Oliver Heyme)
.IP \[bu] 2
سرویس QingStor از QingCloud (با تشکر از wuyu)
.RE
.IP \[bu] 2
دستورات جدید
.RS 2
.IP \[bu] 2
\f[V]rcat\f[R] \- خواندن از ورودی استاندارد و بارگذاری جریانی
.IP \[bu] 2
\f[V]tree\f[R] \- نمایش فهرستی بازگشتی با قالب‌بندی مناسب
.IP \[bu] 2
\f[V]cryptdecode\f[R] \- رمزگشایی نام‌های فایل رمزنگاری‌شده (با تشکر از ishuah)
.IP \[bu] 2
\f[V]config show\f[R] \- چاپ محتوای فایل پیکربندی
.IP \[bu] 2
\f[V]config file\f[R] \- چاپ مسیر قرارگیری فایل پیکربندی
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
حذف دایرکتوری‌های خالی در \f[V]sync\f[R]
.IP \[bu] 2
\f[V]dedupe\f[R] \- پیاده‌سازی ادغام دایرکتوری‌های تکراری
.IP \[bu] 2
سازگارتر شدن \f[V]check\f[R] و \f[V]cryptcheck\f[R] و مصرف حافظه کمتر
.IP \[bu] 2
دستور \f[V]cleanup\f[R] برای سایر ریموت‌ها (با تشکر از ishuah)
.IP \[bu] 2
گزینه \f[V]\-\-immutable\f[R] برای اطمینان از تغییر نکردن فایل‌ها (با تشکر
از Jacob McNamee)
.IP \[bu] 2
گزینه \f[V]\-\-user-agent\f[R] (با تشکر از Alex McGrath Kraak)
.IP \[bu] 2
پرچم \f[V]\-\-disable\f[R] برای غیرفعال کردن قابلیت‌های اختیاری
.IP \[bu] 2
پرچم \f[V]\-\-bind\f[R] برای تعیین آدرس محلی در اتصال‌های خروجی
.IP \[bu] 2
پشتیبانی از تکمیل خودکار zsh (با تشکر از bpicode)
.IP \[bu] 2
توقف نرمال‌سازی نام فایل‌ها و انجام مقایسه نرمال‌شده در
\f[V]sync\f[R]
.RE
.IP \[bu] 2
کامپایل
.RS 2
.IP \[bu] 2
به‌روزرسانی به go1.9 به عنوان نسخه پیش‌فرض go
.IP \[bu] 2
حذف بیلد snapd به دلیل مشکلات نگهداری
.RE
.IP \[bu] 2
رفع اشکالات
.RS 2
.IP \[bu] 2
بهبود تشخیص خطاهای قابل تلاش مجدد که بارگذاری‌های چندبخشی را ارتقا می‌دهد
.IP \[bu] 2
اعمال پرچم \f[V]\-\-ignore-size\f[R] در دستور \f[V]check\f[R]
.IP \[bu] 2
رفع مشکل تغییر وضعیت bwlimit در ترکیب با زمان‌بندی‌ها (با تشکر از cbruegg)
.IP \[bu] 2
دستور \f[V]config\f[R] اطمینان حاصل می‌کند که پیکربندی تازه نوشته‌شده روی همان نقطه اتصال باشد
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
بازگشت به کپی هنگام انتقال فایل بین مرزهای فایل‌سیستم
.IP \[bu] 2
گزینه \f[V]\-\-skip-links\f[R] برای نادیده گرفتن هشدارهای پیوند نمادین (با تشکر از Zhiming
Wang)
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
استفاده مجدد از بخش‌های داخلی \f[V]rcat\f[R] برای پشتیبانی از بارگذاری از تمام ریموت‌ها
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
رفع خطای \[dq]entry doesn\[aq]t belong in directory\[dq]
.IP \[bu] 2
توقف استفاده از متدهای منسوخ‌شده API
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
رفع مشکل کپی سمت سرور به یک کانتینر خالی با \f[V]\-\-fast-list\f[R]
.RE.IP \[bu] 2
Google Drive
.RS 2
.IP \[bu] 2
تغییر مقدار پیش‌فرض \f[V]--drive-use-trash\f[R] به \f[V]true\f[R]
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
تنظیم نشانهٔ نشست (session token) هنگام استفاده از STS (با تشکر از Girish Ramakrishnan)
.IP \[bu] 2
مستندات و پیام‌های خطای Glacier (با تشکر از Jan Varho)
.IP \[bu] 2
خواندن ۱۰۰۰ مورد (نه ۱۰۲۴) در فهرست‌گیری پوشه‌ها برای اصلاح Wasabi
.RE
.IP \[bu] 2
Backblaze B2
.RS 2
.IP \[bu] 2
رفع عدم تطابق SHA1 هنگام بارگیری فایل‌های فاقد SHA1
.IP \[bu] 2
محاسبهٔ درلحظهٔ درهم‌سازهای ناموجود به‌جای ذخیره در صف (spooling)
.IP \[bu] 2
گزینهٔ \f[V]--b2-hard-delete\f[R] برای حذف دائمی فایل‌ها (نه پنهان‌سازی)
(با تشکر از John Papandriopoulos)
.RE
.IP \[bu] 2
Hubic
.RS 2
.IP \[bu] 2
رفع مشکل ساخت کانتینرها \- دیگر نیازی به استفاده از کانتینر \f[V]default\f[R]
نیست
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
امکان پیکربندی اختیاری از طریق مجموعه‌ای استاندارد از متغیرهای محیطی OpenStack
.IP \[bu] 2
افزودن پیکربندی \f[V]endpoint_type\f[R]
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
اصلاح ساخت باکت (bucket) برای کارکرد با کاربران دارای دسترسی محدود
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
پیاده‌سازی تجمیع اتصالات (connection pooling) برای چندین اتصال ssh
.IP \[bu] 2
محدود کردن اتصالات جدید در هر ثانیه
.IP \[bu] 2
افزودن پشتیبانی از درهم‌سازهای MD5 و SHA1 در صورت موجود بودن (با تشکر از Christian
Brüggemann)
.RE
.IP \[bu] 2
HTTP
.RS 2
.IP \[bu] 2
رفع مشکلات کدگذاری نشانی وب (URL encoding)
.IP \[bu] 2
رفع مشکل پوشه‌های حاوی \f[V]:\f[R]
.IP \[bu] 2
رفع خطای وحشت (panic) ناشی از محتوای کدگذاری‌شدهٔ URL
.RE
.SS v1.37 \- 2017-07-22
.IP \[bu] 2
پس‌انه‌های جدید
.RS 2
.IP \[bu] 2
FTP \- با تشکر از Antonio Messina
.IP \[bu] 2
HTTP \- با تشکر از Vasiliy Tolstov
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
rclone ncdu \- برای کاوش یک ریموت با واسط کاربری متنی.
.IP \[bu] 2
rclone lsjson \- برای فهرست‌گیری با خروجی ماشین‌خوان
.IP \[bu] 2
rclone dbhashsum \- برای نمایش درهم‌سازهای سبک Dropbox فایل‌ها (محلی یا
Dropbox)
.RE
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
پیاده‌سازی پرچم --fast-list
.RS 2
.IP \[bu] 2
این گزینه به ریموت‌ها اجازه می‌دهد در صورت توانایی، فهرست‌گیری را به‌صورت بازگشتی انجام دهند
.IP \[bu] 2
این کار از تراکنش‌های کمتری استفاده می‌کند (مهم در صورتی که بابت آن‌ها هزینه می‌پردازید)
.IP \[bu] 2
ممکن است سریع‌تر باشد یا نباشد
.IP \[bu] 2
حافظهٔ بیشتری مصرف خواهد کرد زیرا باید کل فهرست را در حافظه نگه دارد
.IP \[bu] 2
منسوخ شدن --old-sync-method \- سایر کاربردها با
--fast-list پوشش داده می‌شوند
.IP \[bu] 2
این تغییر شامل بازنویسی اساسی تمام کدهای فهرست‌گیری بود
.RE
.IP \[bu] 2
افزودن --tpslimit و --tpslimit-burst برای محدود کردن تعداد تراکنش‌ها در ثانیه
.RS 2
.IP \[bu] 2
این قابلیت در ترکیب با \f[V]rclone mount\f[R] برای محدود کردن
برنامه‌های خارجی کاربرد دارد
.RE
.IP \[bu] 2
افزودن --stats-log-level جهت امکان مشاهدهٔ --stats بدون نیاز به -v
.IP \[bu] 2
چاپ پیام‌های دریافت گذرواژه در stderr \- با تشکر از Hraban Luyat
.IP \[bu] 2
هشدار دربارهٔ فایل‌های تکراری هنگام همگام‌سازی
.IP \[bu] 2
بهبودهای OAuth
.RS 2
.IP \[bu] 2
امکان تنظیم auth_url و token_url در فایل پیکربندی
.IP \[bu] 2
چاپ URI بازهدایت در صورت استفاده از اطلاعات اعتباری اختصاصی.
.RE
.IP \[bu] 2
عدم اجرای Mkdir در آغاز همگام‌سازی برای صرفه‌جویی در تراکنش‌ها
.RE
.IP \[bu] 2
کامپایل
.RS 2
.IP \[bu] 2
به‌روزرسانی ساخت به go1.8.3
.IP \[bu] 2
الزام استفاده از go1.6 برای ساخت rclone
.IP \[bu] 2
کامپایل بیلدهای 386 با \[dq]GO386=387\[dq] برای حداکثر سازگاری
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
اصلاح انتخاب منو در صورت عدم وجود ریموت‌ها
.IP \[bu] 2
بازطراحی روند ذخیرهٔ پیکربندی تا در صورت پر شدن دیسک، فایل آسیب نبیند
.IP \[bu] 2
عدم حذف ریموت در صورتی که نام هنگام تغییر نام بدون تغییر بماند
.IP \[bu] 2
دستورهای moveto و copyto: گزارش انتقال‌ها و بررسی‌ها مطابق با move و copy
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
افزودن پرچم --local-no-unicode-normalization \- با تشکر از Bob Potter
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
پشتیبانی در Windows با استفاده از cgofuse و WinFsp \- با تشکر فراوان از Bill
Zissimopoulos برای کمک‌های بسیارش
.IP \[bu] 2
مقایسهٔ چکسام‌ها هنگام بارگذاری/بارگیری از طریق FUSE
.IP \[bu] 2
پیاده کردن (Unmount) هنگام خاتمهٔ برنامه با SIGINT (کلیدهای Ctrl+C) یا SIGTERM \- با تشکر از Jérôme
Vizcaino
.IP \[bu] 2
در بازگشایی فقط‌خواندنی فایل، معلق ماندن باز شدن تا زمان نخستین خواندن
.IP \[bu] 2
رد عملیات‌های ویرایشی توسط --read-only
.IP \[bu] 2
پیاده‌سازی ModTime از طریق FUSE برای ریموت‌هایی که از آن پشتیبانی می‌کنند
.IP \[bu] 2
امکان تغییر modTime حتی پیش از بسته شدن تمام نویسنده‌ها (writers).IP \[bu] 2
رفع خطای panic هنگام تغییر نام‌ها
.IP \[bu] 2
رفع قفل کردن هنگام بارگذاری‌های دچار خطا
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
گزارش name:root همان‌طور که توسط کاربر مشخص شده است
.IP \[bu] 2
افزودن گزینه \[dq]obfuscate\[dq] برای رمزنگاری نام فایل \- Stephen Harris
.RE
.IP \[bu] 2
Amazon Drive
.RS 2
.IP \[bu] 2
اصلاح ترتیب مقداردهی اولیه برای تمدیدکننده توکن
.IP \[bu] 2
حذف اعتبارنامه‌های ابطال‌شده، امکان‌پذیر ساختن پیکربندی پروکسی oauth و به‌روزرسانی مستندات
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
کاهش حداقل اندازه تکه‌ها به 5MB
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از درایو تیمی (team drive)
.IP \[bu] 2
کاهش پهنای باند مصرفی با افزودن فیلدهایی برای پاسخ‌های جزئی \- Martin Kristensen
.IP \[bu] 2
پیاده‌سازی پرچم \-\-drive\-shared\-with\-me برای مشاهده فایل‌های هم‌رسانی‌شده با من \- Danny Tsai
.IP \[bu] 2
افزودن \-\-drive\-trashed\-only جهت خواندن تنها فایل‌های موجود در سطل زباله
.IP \[bu] 2
حذف گزینه منسوخ‌شده \-\-drive\-full\-list
.IP \[bu] 2
افزودن seek به ابتدا در تلاش‌های مجدد بارگذاری‌های تکه‌ای
.IP \[bu] 2
اصلاح محاسبه آمار برای بارگذاری
.IP \[bu] 2
تبدیل / در نام‌ها به معادل یونیکد آن (／)
.IP \[bu] 2
بررسی دوره‌ای (poll) تغییرات Google Drive هنگام سوار شدن (mount)
.RE
.IP \[bu] 2
OneDrive
.RS 2
.IP \[bu] 2
اصلاح بارگذاری فایل‌های حاوی فاصله
.IP \[bu] 2
اصلاح ترتیب مقداردهی اولیه برای تمدیدکننده توکن
.IP \[bu] 2
نمایش دقیق سرعت هنگام بارگذاری \- Yoni Jah
.IP \[bu] 2
تغییر به استفاده از \f[V]http://localhost:53682\f[R] به‌عنوان نشانی تغییر مسیر \- Michael Ledin
.IP \[bu] 2
تلاش مجدد هنگام خطای انقضای توکن و بازنشانی بدنه بارگذاری در تلاش مجدد \- Yoni Jah
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
افزودن امکان تعیین مکان و رده ذخیره‌سازی از طریق پیکربندی و خط فرمان \- با تشکر از gdm85
.IP \[bu] 2
ایجاد کانتینر در صورت نیاز هنگام رونوشت سمت سرور
.IP \[bu] 2
افزایش اندازه تکه فهرست‌گیری دایرکتوری به ۱۰۰۰ جهت بهبود کارایی
.IP \[bu] 2
دریافت یک refresh token برای GCS \- Steven Lu
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
اصلاح نام گزارش‌شده در پیام‌های گزارش (خالی بود)
.IP \[bu] 2
تصحیح خطای بازگشتی برای فهرست کردن دایرکتوری خالی
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
بازنویسی‌شده جهت استفاده از API نسخه ۲
.RS 2
.IP \[bu] 2
اکنون از ModTime پشتیبانی می‌کند
.RS 2
.IP \[bu] 2
فقط با بارگذاری دوباره فایل قابل تنظیم است
.IP \[bu] 2
اگر با نسخه قدیمی rclone بارگذاری کرده‌اید، rclone ممکن است همه‌چیز را دوباره بارگذاری کند
.IP \[bu] 2
برای جلوگیری از این مسئله از \f[V]\-\-size\-only\f[R] یا \f[V]\-\-checksum\f[R] استفاده کنید
.RE
.IP \[bu] 2
اکنون از طرح درهم‌سازی محتوای Dropbox پشتیبانی می‌کند
.IP \[bu] 2
اکنون از تلاش‌های مجدد در سطح پایین پشتیبانی می‌کند
.RE
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
دور زدن مشکل سازگاری نهایی (eventual consistency) در ایجاد باکت
.IP \[bu] 2
ایجاد کانتینر در صورت نیاز هنگام رونوشت سمت سرور
.IP \[bu] 2
افزودن ناحیه‌های S3 مربوط به us-east-2 (اوهایو) و eu-west-2 (لندن) \- Zahiar Ahmed
.RE
.IP \[bu] 2
Swift, Hubic
.RS 2
.IP \[bu] 2
رفع نمایش نشانگرهای دایرکتوری با طول صفر در فهرست زیردایرکتوری‌ها
.RS 2
.IP \[bu] 2
این مورد باعث انتقال‌های تکراری زیادی می‌شد
.RE
.IP \[bu] 2
اصلاح فهرست‌گیری صفحه‌بندی‌شده دایرکتوری
.RS 2
.IP \[bu] 2
این مورد باعث خطاهای دایرکتوری تکراری می‌شد
.RE
.IP \[bu] 2
ایجاد کانتینر در صورت نیاز هنگام رونوشت سمت سرور
.IP \[bu] 2
افزایش اندازه تکه فهرست‌گیری دایرکتوری به ۱۰۰۰ جهت بهبود کارایی
.IP \[bu] 2
ارائه خطای منطقی در صورتی که کاربر کانتینر را فراموش کند
.RE
.IP \[bu] 2
SFTP
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از استفاده از فایل‌های کلید ssh
.IP \[bu] 2
رفع اشکالات تحت Windows
.IP \[bu] 2
اصلاح ssh agent در Windows
.IP \[bu] 2
سازگاری با آخرین نسخه کتابخانه \- Igor Kharin
.RE.SS v1.36 \- 2017-03-18
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
ریموت SFTP (Jack Schmidt)
.IP \[bu] 2
پیاده‌سازی مجدد روال sync برای پردازش یک دایرکتوری در هر نوبت جهت کاهش مصرف حافظه
.IP \[bu] 2
بازنگری در ثبت وقایع برای هماهنگی بیشتر با rsync \- اکنون با خروجی بسیار خلوت‌تر
.RS 2
.IP \[bu] 2
گزینه -v تنها انتقال‌ها را نشان می‌دهد
.IP \[bu] 2
گزینه -vv برای اشکال‌زدایی کامل (debug) است
.IP \[bu] 2
گزینه --syslog برای ثبت وقایع در syslog در سیستم‌های سازگار
.RE
.IP \[bu] 2
پیاده‌سازی --backup-dir و --suffix
.IP \[bu] 2
پیاده‌سازی --track-renames (پیاده‌سازی اولیه توسط Bjørn Erik Pedersen)
.IP \[bu] 2
افزودن محدودیت‌های پهنای باند بر اساس زمان (Lukas Loesche)
.IP \[bu] 2
دستور rclone cryptcheck: بررسی یکپارچگی ریموت‌های crypt
.IP \[bu] 2
امکان تعیین تمامی متغیرها و گزینه‌های فایل پیکربندی از طریق متغیرهای محیطی
.IP \[bu] 2
افزودن پارامتر --buffer-size جهت کنترل اندازه بافر برای کپی
.IP \[bu] 2
پیش‌فرض قرار دادن گزینه --delete-after
.IP \[bu] 2
افزودن پرچم --ignore-checksum (رفع اشکال توسط Hisham Zarka)
.IP \[bu] 2
دستور rclone check: افزودن پرچم --download برای بررسی تمام داده‌ها، نه فقط هش‌ها
.IP \[bu] 2
دستور rclone cat: افزودن --head، --tail، --offset، --count و --discard
.IP \[bu] 2
دستور rclone config: امکان وارد کردن دستی مقدار هنگام انتخاب از فهرست
.IP \[bu] 2
دستور rclone config: امکان تغییر نام و کپی کردن ریموت‌ها
.IP \[bu] 2
دستور rclone obscure: برای تولید گذرواژه‌های رمزنگاری‌شده جهت پیکربندی rclone (توسط T.C. Ferguson)
.IP \[bu] 2
سازگاری با مشخصات XDG Base Directory (توسط Dario Giovannetti)
.RS 2
.IP \[bu] 2
این تغییر، محل پیش‌فرض فایل پیکربندی را به شکلی سازگار با نسخه‌های پیشین منتقل می‌کند
.RE
.IP \[bu] 2
تغییرات انتشار
.RS 2
.IP \[bu] 2
پشتیبانی از snap در Ubuntu (توسط Dedsec1)
.IP \[bu] 2
کامپایل با go 1.8
.IP \[bu] 2
پشتیبانی از حالت‌های big و little endian در MIPS/Linux
.RE
.RE
.IP \[bu] 2
رفع اشکالات
.RS 2
.IP \[bu] 2
رفع اشکال کپی شدن اشیا به مکان اشتباه توسط copyto در صورت وجود نداشتن دایرکتوری مقصد
.IP \[bu] 2
رفع اشکال در تجزیه ریموت‌ها در moveto و copyto
.IP \[bu] 2
رفع اشکال حذف فایل‌ها حین کپی هنگام استفاده از --delete-before
.IP \[bu] 2
رفع اشکال کپی شدن همه‌چیز توسط --files-from با یک فایل خالی
.IP \[bu] 2
رفع اشکال sync: عدم به‌روزرسانی زمان‌های ویرایش در صورت تنظیم --dry-run
.IP \[bu] 2
رفع اشکال در انتشار MimeType
.IP \[bu] 2
اصلاح فیلترها برای افزودن قوانین ** به قوانین دایرکتوری
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
پیاده‌سازی پرچم -L, --copy-links برای مجاز کردن rclone به دنبال کردن پیوندهای نمادین
.IP \[bu] 2
باز کردن فایل‌ها در حالت فقط‌نوشتنی تا rclone بتواند در mount متعلق به rclone بنویسد
.IP \[bu] 2
رفع اشکال ناشی از یونیکد نرمال‌سازی‌نشده که در خواندن دایرکتوری‌ها مشکل ایجاد می‌کرد
.IP \[bu] 2
رفع اشکال تداخل میان پرچم -x و --max-depth
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
پیاده‌سازی مدیریت مناسب دایرکتوری‌ها (mkdir، rmdir، تغییر نام)
.IP \[bu] 2
اعمال فیلترهای include و exclude بر روی mount
.IP \[bu] 2
پیاده‌سازی بافرهای ناهمگام خواندن و نوشتن \- قابل کنترل با --buffer-size
.IP \[bu] 2
رفع اشکال عملکرد fsync برای دایرکتوری‌ها
.IP \[bu] 2
رفع اشکال در تلاش مجدد هنگام خطای شبکه حین خواندن از crypt
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
افزودن --crypt-show-mapping جهت نمایش نگاشت فایل رمزنگاری‌شده
.IP \[bu] 2
رفع اشکال گیر افتادن نویسنده crypt در یک حلقه
.RS 2
.IP \[bu] 2
\f[B]مهم:\f[R] این باگ می‌توانست در موارد زیر موجب تخریب داده‌ها شود:
.RS 2
.IP \[bu] 2
خواندن داده‌ها از یک ریموت مبتنی بر شبکه، و
.IP \[bu] 2
نوشتن روی یک ریموت crypt در Google Drive
.RE
.IP \[bu] 2
در صورت نگرانی، از دستور cryptcheck برای اعتبارسنجی داده‌های خود استفاده کنید
.IP \[bu] 2
در صورت همگام‌سازی دو ریموت crypt، ریموت رمزنگاری‌نشده را همگام‌سازی کنید
.RE
.RE
.IP \[bu] 2
Amazon Drive
.RS 2
.IP \[bu] 2
رفع panic حین اجرای Move (تغییر نام)
.IP \[bu] 2
رفع panic هنگام انقضای توکن
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
رفع ناهماهنگی در فهرست کردن و دستور rclone check
.IP \[bu] 2
رفع اشکال بارگذاری فایل‌های خالی با go1.8
.IP \[bu] 2
محدودسازی مصرف حافظه هنگام انجام بارگذاری‌های چندبخشی
.IP \[bu] 2
رفع اشکال در تازه‌سازی نشدن صحیح URL بارگذاری
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
رفع اشکال Rmdir روی دایرکتوری‌های دارای فایل‌های منتقل‌شده به سطل زباله
.IP \[bu] 2
رفع اشکال پیام \[dq]Ignoring unknown object\[dq] هنگام بارگیری
.IP \[bu] 2
افزودن --drive-list-chunk
.IP \[bu] 2
افزودن --drive-skip-gdocs (Károly Oláh)
.RE
.IP \[bu] 2
OneDrive
.RS 2
.IP \[bu] 2
پیاده‌سازی Move
.IP \[bu] 2
رفع اشکال Copy
.RS 2
.IP \[bu] 2
رفع اشکال تشخیص بازنویسی در Copy
.IP \[bu] 2
رفع اشکال waitForJob برای تجزیه صحیح خطاها
.RE.IP \[bu] 2
استفاده از تجدیدکنندهٔ توکن برای متوقف کردن خطاهای احراز هویت در بارگذاری‌های طولانی
.IP \[bu] 2
رفع مشکل بارگذاری فایل‌های خالی با go1.8
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
رفع مشکل فهرست‌بندی دایرکتوری‌ها با عمق ۱
.RE
.IP \[bu] 2
Yandex
.RS 2
.IP \[bu] 2
رفع مشکل فهرست‌بندی دایرکتوری در یک سطح
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
یکسان‌سازی بزرگی و کوچکی حروف در فهرست‌بندی دایرکتوری‌های تک‌سطحی
.IP \[bu] 2
رفع مشکل فهرست‌بندی با عمق ۱
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزوده شدن منطقهٔ ca-central-1 (با تشکر از Jon Yergatian)
.RE
.SS v1.35 - 2017-01-02
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
دستورهای moveto و copyto برای انتخاب نام مقصد در رونوشت/انتقال
.IP \[bu] 2
دستور rmdirs برای حذف بازگشتی دایرکتوری‌های خالی
.IP \[bu] 2
امکان تکرار گزینه‌های --include/--exclude/--filter
.IP \[bu] 2
نمایش آمار انتقال تنها در دستورهایی که داده انتقال می‌دهند
.RS 2
.IP \[bu] 2
نمایش آمار در هر دستوری با استفاده از پرچم \f[V]--stats\f[R]
.RE
.IP \[bu] 2
مجاز بودن دایرکتوری‌های هم‌پوشان در move هنگامی که جابه‌جایی دایرکتوری در سمت سرور پشتیبانی می‌شود
.IP \[bu] 2
افزودن گزینهٔ --stats-unit - با تشکر از Scott McGillivray
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
رفع مشکل رونویسی فایل پیکربندی هنگام اجرای هم‌زمان دو نمونه از rclone
.IP \[bu] 2
پیروی صحیح rclone lsd از فیلترها
.IP \[bu] 2
رفع مشکل کامپایل روی mips
.IP \[bu] 2
رفع مشکل عدم انتقال فایل‌هایی که تفاوت اندازه‌ای ندارند
.IP \[bu] 2
رفع خطای panic در مواجهه با خطای nil مربوط به retry/fatal
.RE
.IP \[bu] 2
Mount
.RS 2
.IP \[bu] 2
تلاش مجدد برای خواندن در صورت بروز خطا - کمک بسیار به پایداری و قابلیت اطمینان
.IP \[bu] 2
گزارش زمان تغییرات دایرکتوری‌ها از سمت ریموت
.IP \[bu] 2
افزودن محاسبه و محدودسازی پهنای باند (رفع اشکال --bwlimit)
.IP \[bu] 2
در صورت ارائهٔ --stats، آمار و این‌که چه فایل‌هایی در حال انتقال هستند نمایش داده می‌شود
.IP \[bu] 2
پشتیبانی از فایل‌های R/W در صورت مشخص بودن truncate.
.IP \[bu] 2
پیاده‌سازی رابط statfs برای کارکرد درست df
.IP \[bu] 2
توجه: عملیات نوشتن اکنون روی Amazon Drive پشتیبانی می‌شود
.IP \[bu] 2
گزارش تعداد بلوک‌ها در یک فایل - با تشکر از Stefan Breunig
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
جلوگیری از اشارهٔ کاربر crypt به خودش
.IP \[bu] 2
رفع خطاهای مربوط به عدم موفقیت در احراز هویت بلوک‌های رمزگشایی‌شده
.RS 2
.IP \[bu] 2
این خطاها اکنون در عوض، EOF غیرمنتظرهٔ زیرین را بازمی‌گردانند
.RE
.RE
.IP \[bu] 2
Amazon Drive
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از move سمت سرور و انتقال دایرکتوری - با تشکر از Stefan
Breunig
.IP \[bu] 2
رفع ارجاع به اشاره‌گر nil برای ویژگی size
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
استفاده از پارامترهای جدید prefix و delimiter در فهرست‌بندی دایرکتوری‌ها
.RS 2
.IP \[bu] 2
این تغییر فهرست‌بندی دایرکتوری با --max-depth 1 را همان‌طور که در mount استفاده می‌شود بسیار سریع‌تر می‌کند
.RE
.IP \[bu] 2
احراز هویت مجدد حساب در حین انجام بارگذاری‌ها نیز انجام می‌شود - به مشکل انقضای توکن کمک خواهد کرد
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
بهینه‌تر کردن DirMove و اعلام خطا هنگام انتقال دایرکتوری ریشه (root)
.IP \[bu] 2
ایجاد دایرکتوری مقصد در Move()
.RE.SS v1.34 - 2016-11-06
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
توقف پیمایش باکت مبدا در عملیات‌های تک‌فایل و \f[V]--files-from\f[R].
.IP \[bu] 2
توقف حذف بارگذاری‌های ناموفق در ریموت‌های ذخیره‌سازی ابری
.IP \[bu] 2
حفظ ContentType برای رونوشت‌های ابر به ابر
.IP \[bu] 2
افزودن پشتیبانی از تغییر وضعیت محدودیت پهنای باند از طریق SIGUSR2 \- با تشکر از Marco Paganini
.IP \[bu] 2
دستور \f[V]rclone check\f[R] تعداد هش‌هایی که بررسی آن‌ها مقدور نبوده را نمایش می‌دهد
.IP \[bu] 2
دستور \f[V]rclone listremotes\f[R]
.IP \[bu] 2
پشتیبانی از ساخت برای linux/arm64 \- با تشکر از Fredrik Fornwall
.IP \[bu] 2
حذف خطوط \f[V]Authorization:\f[R] از خروجی \f[V]--dump-headers\f[R]
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
نادیده گرفتن فایل‌هایی با نویسه‌های کنترلی در نام آن‌ها
.IP \[bu] 2
رفع اشکال دستور \f[V]rclone move\f[R]
.RS 2
.IP \[bu] 2
حذف فایل‌های src که از پیش در dst وجود داشتند
.IP \[bu] 2
رفع اشکال حذف فایل src هنگامی که فایل dst قدیمی‌تر است
.RE
.IP \[bu] 2
رفع اشکال \f[V]rclone check\f[R] بر روی سیستم‌فایل‌های رمزگذاری‌شده
.IP \[bu] 2
عدم محاسبه بارگذاری‌های ناموفق به‌عنوان \[dq]Transferred\[dq]
.IP \[bu] 2
اطمینان از نمایش تلاش‌های مجدد سطح بالا با \f[V]-q\f[R]
.IP \[bu] 2
استفاده از دایرکتوری vendor با godep برای ساخت‌های تکرارپذیر
.RE
.IP \[bu] 2
\f[V]rclone mount\f[R] \- FUSE
.RS 2
.IP \[bu] 2
پیاده‌سازی گزینه‌های سوار کردن FUSE
.RS 2
.IP \[bu] 2
\f[V]--no-modtime\f[R]، \f[V]--debug-fuse\f[R]، \f[V]--read-only\f[R]،
\f[V]--allow-non-empty\f[R]، \f[V]--allow-root\f[R]،
\f[V]--allow-other\f[R]
.IP \[bu] 2
\f[V]--default-permissions\f[R]، \f[V]--write-back-cache\f[R]،
\f[V]--max-read-ahead\f[R]، \f[V]--umask\f[R]، \f[V]--uid\f[R]،
\f[V]--gid\f[R]
.RE
.IP \[bu] 2
افزودن \f[V]--dir-cache-time\f[R] برای کنترل کش کردن ورودی‌های دایرکتوری
.IP \[bu] 2
پیاده‌سازی seek برای فایل‌های بازشده جهت خواندن (کاربردی برای پخش‌کننده‌های ویدیو)
.RS 2
.IP \[bu] 2
همراه با پرچم \f[V]-no-seek\f[R] برای غیرفعال‌سازی
.RE
.IP \[bu] 2
رفع اشکال فروپاشی در ARM ۳۲ بیتی (هم‌ترازی شمارنده ۶۴ بیتی)
.IP \[bu] 2
\&...و بسیاری اصلاحات و بهبودهای داخلی دیگر!
.RE
.IP \[bu] 2
Crypt
.RS 2
.IP \[bu] 2
عدم نمایش گذرواژه رمزگذاری‌شده در پیکربندی‌کننده جهت جلوگیری از سردرگمی
.RE
.IP \[bu] 2
Amazon Drive
.RS 2
.IP \[bu] 2
گزینه جدید انتظار برای بارگذاری \f[V]--acd-upload-wait-per-gb\f[R]
.RS 2
.IP \[bu] 2
مقیاس‌پذیری مهلت‌های زمانی بارگذاری بر اساس اندازه فایل و امکان غیرفعال‌سازی آن
.RE
.IP \[bu] 2
افزودن 502 Bad Gateway به فهرست خطاهایی که مجدداً تلاش می‌شوند
.IP \[bu] 2
رفع اشکال بازنویسی یک فایل با فایلی با طول صفر
.IP \[bu] 2
رفع اشکال حد هشدار اندازه فایل در ACD \- با تشکر از Felix Bünemann
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
یونیکس: پیاده‌سازی \f[V]-x\f[R]/\f[V]--one-file-system\f[R] برای ماندن در یک سیستم‌فایل واحد
.RS 2
.IP \[bu] 2
با تشکر از Durval Menezes و Luiz Carlos Rumbelsperger Viana
.RE
.IP \[bu] 2
ویندوز: نادیده گرفتن بیت symlink در فایل‌ها
.IP \[bu] 2
ویندوز: نادیده گرفتن نقاط اتصال (junction points) مبتنی بر دایرکتوری
.RE
.IP \[bu] 2
B2
.RS 2
.IP \[bu] 2
اطمینان از اینکه هر بارگذاری دست‌کم یک شیار بارگذاری دارد \- رفع آمار بارگذاری غیرعادی
.IP \[bu] 2
رفع اشکال بارگذاری‌ها هنگام استفاده از crypt
.IP \[bu] 2
رفع اشکال بارگیری فایل‌های حجیم (عدم تطابق sha1)
.IP \[bu] 2
بازگرداندن خطا هنگام تلاش برای ایجاد باکتی که مالک آن شخص دیگری است
.IP \[bu] 2
به‌روزرسانی مستندات B2 با بخش‌های مصرف داده (Data usage) و Crypt \- با تشکر از Tomasz Mazur
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
پشتیبانی از خط فرمان و فایل پیکربندی برای
.RS 2
.IP \[bu] 2
تنظیم/بازنویسی ACL \- با تشکر از Radek Šenfeld
.IP \[bu] 2
تنظیم رده ذخیره‌سازی (storage class) \- با تشکر از Asko Tamm
.RE
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
کارکرد دقیق عقب‌نشینی نمایی (exponential backoff) طبق مشخصات Google
.IP \[bu] 2
افزودن \f[V].epub\f[R]، \f[V].odp\f[R] و \f[V].tsv\f[R] به عنوان قالب‌های برون‌بری.
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
عدم خواندن متاداده برای اشیاء نشانگر دایرکتوری
.RE.SS v1.33 - 2016-08-24
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
پیاده‌سازی رمزنگاری
.RS 2
.IP \[bu] 2
داده‌های رمزنگاری‌شده در قالب NACL secretbox
.IP \[bu] 2
به همراه رمزنگاری اختیاری نام فایل
.RE
.IP \[bu] 2
دستورهای جدید
.RS 2
.IP \[bu] 2
rclone mount \- پیاده‌سازی اتصال FUSE برای ریموت‌ها (آزمایشی)
.RS 2
.IP \[bu] 2
روی Linux، FreeBSD و OS X کار می‌کند (برای دو مورد آخر نیاز به آزمایش‌کننده است!)
.RE
.IP \[bu] 2
rclone cat \- ارسال فایل یا فایل‌های ریموت به خروجی ترمینال
.IP \[bu] 2
rclone genautocomplete \- دستور ساخت اسکریپت تکمیل خودکار bash برای
rclone
.RE
.IP \[bu] 2
ویرایش یک ریموت با استفاده از \f[V]rclone config\f[R] اکنون از طریق
ویزارد انجام می‌شود
.IP \[bu] 2
کامپایل با go 1.7 \- این مورد rclone را روی macOS Sierra و پردازنده‌های
386 اصلاح می‌کند
.IP \[bu] 2
استفاده از cobra برای زیردستورها و ساخت مستندات
.RE
.IP \[bu] 2
drive
.RS 2
.IP \[bu] 2
مستندسازی نحوه ساخت client_id اختصاصی
.RE
.IP \[bu] 2
s3
.RS 2
.IP \[bu] 2
امکان پیکربندی Amazon S3 ACL توسط کاربر (با تشکر از Radek Šenfeld)
.RE
.IP \[bu] 2
b2
.RS 2
.IP \[bu] 2
رفع مشکل محاسبه آمار بارگذاری \- عدم جهش به ۱۰۰٪ انجام‌شده
.IP \[bu] 2
در پاک‌سازی، در صورتی که فایل جاری باشد نشانگر پنهان‌سازی (hide marker) حذف شود
.IP \[bu] 2
نقطه پایانی جدید B2 API (با تشکر از Per Cederberg)
.IP \[bu] 2
تنظیم حداکثر زمان انتظار پس‌روی (backoff) به ۵ دقیقه
.RE
.IP \[bu] 2
onedrive
.RS 2
.IP \[bu] 2
رفع مشکل گریز نشانی وب (URL escaping) در نام فایل‌ها \- مانند
بارگذاری فایل‌های حاوی \f[V]+\f[R].
.RE
.IP \[bu] 2
amazon cloud drive
.RS 2
.IP \[bu] 2
رفع مشکل انقضای توکن در حین بارگذاری‌های حجیم
.IP \[bu] 2
دور زدن خطاهای 408 REQUEST_TIMEOUT و 504 GATEWAY_TIMEOUT
.RE
.IP \[bu] 2
local
.RS 2
.IP \[bu] 2
رفع مشکل بارگذاری نشدن نام فایل‌های حاوی UTF-8 نامعتبر
.IP \[bu] 2
رفع مشکل برخی نویسه‌های UTF-8 در OS X
.RE.SS v1.32 - 2016-07-13
.IP \[bu] 2
Backblaze B2
.RS 2
.IP \[bu] 2
رفع اشکال بارگذاری فایل‌های بزرگی که در ریشه نیستند
.RE
.SS v1.31 - 2016-07-13
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
کاهش مصرف حافظه هنگام sync تا حدود ۵۰٪
.IP \[bu] 2
پیاده‌سازی پرچم --no-traverse برای جلوگیری از پیمایش ریموت مقصد توسط copy.
.RS 2
.IP \[bu] 2
این گزینه می‌تواند برای کاهش مصرف حافظه به کمترین میزان ممکن استفاده شود.
.IP \[bu] 2
برای کپی تعداد کمی فایل به درون یک پوشه مقصد بزرگ مفید است.
.RE
.IP \[bu] 2
پیاده‌سازی دستور cleanup برای خالی کردن سطل زباله / حذف نسخه‌های قدیمی فایل‌ها
.RS 2
.IP \[bu] 2
در حال حاضر فقط برای B2
.RE
.IP \[bu] 2
بهبود کار با فایل‌های تکی
.RS 2
.IP \[bu] 2
اکنون با --files-from کپی می‌شود
.IP \[bu] 2
تنظیم خودکار --no-traverse هنگام کپی یک فایل تکی
.RE
.IP \[bu] 2
اطلاعات در مورد نصب با استفاده از ansible \- با تشکر از Stefan Weichinger
.IP \[bu] 2
پیاده‌سازی پرچم --no-update-modtime برای متوقف کردن اصلاح زمان‌های تغییر ریموت توسط rclone.
.RE
.IP \[bu] 2
رفع اشکالات
.RS 2
.IP \[bu] 2
رفع اشکال دستور move \- متوقف کردن اجرای آن برای سامانه‌های فایل (Fs) دارای هم‌پوشانی؛ این مسئله پیش‌تر باعث از دست رفتن داده‌ها می‌شد.
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
رفع اشکال درهم‌سازهای (هش‌های) ناقص \- این مورد برای B2 مشکل‌ساز شده بود.
.RE
.IP \[bu] 2
Amazon Drive
.RS 2
.IP \[bu] 2
تغییر نام Amazon Cloud Drive به Amazon Drive \- نیازی به تغییر در فایل پیکربندی نیست.
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از دامنه پروژه غیرپیش‌فرض \- با تشکر از Antonio Messina.
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن راهنما در مورد نحوه استفاده از rclone با minio.
.IP \[bu] 2
افزودن ناحیه‌های ap-northeast-2 (سئول) و ap-south-1 (بمبئی).
.IP \[bu] 2
صرف‌نظر کردن از تنظیم زمان تغییر برای اشیاء بزرگ‌تر از 5GB به دلیل غیرممکن بودن آن.
.RE
.IP \[bu] 2
Backblaze B2
.RS 2
.IP \[bu] 2
افزودن پرچم --b2-versions تا نسخه‌های قدیمی قابل فهرست‌بندی و بازیابی باشند.
.IP \[bu] 2
مهلک (fatal) در نظر گرفتن خطاهای 403 (مانند عبور از سقف مجاز).
.IP \[bu] 2
پیاده‌سازی دستور cleanup برای حذف نسخه‌های قدیمی فایل.
.IP \[bu] 2
سازگار کردن مدیریت خطا با یادداشت‌های یکپارچه‌سازی B2.
.IP \[bu] 2
رفع مشکل مدیریت انقضای توکن.
.IP \[bu] 2
پیاده‌سازی --b2-test-mode جهت تنظیم سرآیند \f[V]X-Bz-Test-Mode\f[R].
.IP \[bu] 2
تنظیم حد آستانه برای بارگذاری چندبخشی روی 200MB طبق راهنماهای B2.
.IP \[bu] 2
چندنخی کردن بارگذاری.
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
عدم تلاش مجدد برای خطاهای 461.
.RE.SS v1.30 - 2016-06-18
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
بازنویسی کد فهرست‌بندی دایرکتوری برای قابلیت‌های بیشتر و گزارش‌دهی بهتر خطاها (با تشکر از Klaus Post برای کمک).
این مورد قابلیت‌های زیر را فعال می‌کند:
.RS 2
.IP \[bu] 2
فیلتر کردن شمول (include) دایرکتوری برای بهره‌وری بیشتر
.IP \[bu] 2
پارامتر \-\-max\-depth
.IP \[bu] 2
گزارش‌دهی بهتر خطاها
.IP \[bu] 2
موارد بیشتر به‌زودی
.RE
.IP \[bu] 2
تلاش مجدد برای خطاهای بیشتر
.IP \[bu] 2
افزودن پرچم \-\-ignore\-size \- برای بارگذاری تصاویر در onedrive
.IP \[bu] 2
ثبت لاگ خروجی \-v در stdout به‌صورت پیش‌فرض
.IP \[bu] 2
نمایش آمار انتقال در قالبی خواناتر برای انسان
.IP \[bu] 2
امکان تعیین فایل‌های با اندازه صفر با \f[V]\-\-max\-size 0b\f[R]
.IP \[bu] 2
افزودن پسوند \f[V]b\f[R] جهت امکان تعیین بایت در \-\-bwlimit ،\-\-min\-size و غیره
.IP \[bu] 2
استفاده از اعلان \[dq]password:\[dq] به‌جای \[dq]password>\[dq] \- با تشکر از Klaus Post و Leigh Klotz
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
رفع مشکل انجام یک تلاش مجدد اضافی در تکرارها (retry)
.RE
.IP \[bu] 2
محلی (Local)
.RS 2
.IP \[bu] 2
رفع مشکلات مربوط به OS X و نویسه‌های UTF-8
.RE
.IP \[bu] 2
Amazon Drive
.RS 2
.IP \[bu] 2
بررسی وجود فایل پیش از بارگذاری جهت جلوگیری از خطاهای 408 Conflict
.IP \[bu] 2
احراز هویت مجدد هنگام بروز خطاهای 401 \- این مورد مشکلات زیادی ایجاد کرده بود
.IP \[bu] 2
دور زدن خطاهای کاذب 403
.IP \[bu] 2
راه‌اندازی مجدد فهرست‌بندی دایرکتوری در صورت بروز خطا
.RE
.IP \[bu] 2
Google Drive
.RS 2
.IP \[bu] 2
بررسی وجود فایل پیش از بارگذاری جهت جلوگیری از موارد تکراری
.IP \[bu] 2
رفع مشکل تلاش مجدد برای بارگذاری‌های چندبخشی (multipart uploads)
.RE
.IP \[bu] 2
Backblaze B2
.RS 2
.IP \[bu] 2
پیاده‌سازی بارگذاری فایل‌های حجیم
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
افزودن رمزگذاری سمت سرور AES256 \- با تشکر از Justin R.
Wilson
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
اطمینان از عدم استفاده از content typeهای متناقض هنگام بارگذاری
.IP \[bu] 2
افزودن پشتیبانی از حساب کاربری سرویس (service account) \- با تشکر از Michal Witkowski
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
افزودن پارامتر نگارش احراز هویت (auth version)
.IP \[bu] 2
افزودن گزینه domain برای openstack (احراز هویت v3) \- با تشکر از Fabian Ruff
.RE.SS v1.29 - 2016-04-18
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]-I, --ignore-times\f[R] برای بارگذاری بدون قید و شرط
.IP \[bu] 2
بهبود دستور \f[V]dedupe\f[R]
.RS 2
.IP \[bu] 2
اکنون نسخه‌های یکسان را بدون پرسش حذف می‌کند
.IP \[bu] 2
اکنون از \f[V]--dry-run\f[R] پیروی می‌کند
.IP \[bu] 2
پیاده‌سازی \f[V]--dedupe-mode\f[R] برای اجرای غیرتعاملی
.RS 2
.IP \[bu] 2
\f[V]--dedupe-mode interactive\f[R] \- حالت تعاملی، پیش‌فرض است.
.IP \[bu] 2
\f[V]--dedupe-mode skip\f[R] \- فایل‌های یکسان را حذف کرده و سپس از موارد
باقی‌مانده صرف‌نظر می‌کند.
.IP \[bu] 2
\f[V]--dedupe-mode first\f[R] \- فایل‌های یکسان را حذف کرده و سپس اولین
مورد را نگه می‌دارد.
.IP \[bu] 2
\f[V]--dedupe-mode newest\f[R] \- فایل‌های یکسان را حذف کرده و سپس جدیدترین
مورد را نگه می‌دارد.
.IP \[bu] 2
\f[V]--dedupe-mode oldest\f[R] \- فایل‌های یکسان را حذف کرده و سپس قدیمی‌ترین
مورد را نگه می‌دارد.
.IP \[bu] 2
\f[V]--dedupe-mode rename\f[R] \- فایل‌های یکسان را حذف کرده و سپس نام
بقیه را تغییر می‌دهد تا متمایز شوند.
.RE
.RE
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
ملزم کردن rclone check به پیروی از پرچم \f[V]--size-only\f[R].
.IP \[bu] 2
استفاده از \[dq]application/octet-stream\[dq] در صورتی که mime type شناسایی‌شده
نامعتبر باشد.
.IP \[bu] 2
رفع مشکل نبود گزینه \[dq]quit\[dq] هنگامی که هیچ ریموتی وجود ندارد.
.RE
.IP \[bu] 2
Google Drive
.RS 2
.IP \[bu] 2
افزایش اندازه تکه (chunk size) پیش‌فرض به ۸ مگابایت \- افزایش سرعت بارگذاری
فایل‌های بزرگ
.IP \[bu] 2
افزایش سرعت فهرست‌کردن دایرکتوری‌ها و افزایش قابلیت اطمینان آن
.IP \[bu] 2
افزودن تلاش‌های مجدد ناموجود برای Move و DirMove \- افزایش قابلیت اطمینان
.IP \[bu] 2
حفظ mime type هنگام به‌روزرسانی فایل
.RE
.IP \[bu] 2
Backblaze B2
.RS 2
.IP \[bu] 2
فعال‌سازی همگام‌سازی زمان ویرایش (mod time)
.RS 2
.IP \[bu] 2
این بدان معناست که B2 اکنون زمان‌های ویرایش را بررسی خواهد کرد
.IP \[bu] 2
برای به‌روزرسانی زمان‌های ویرایش، فایل‌های جدید را بارگذاری خواهد کرد
.IP \[bu] 2
(هیچ API برای صرفاً تنظیم زمان ویرایش وجود ندارد.)
.IP \[bu] 2
اگر رفتار پیشین را می‌خواهید از \f[V]--size-only\f[R] استفاده کنید.
.RE
.IP \[bu] 2
به‌روزرسانی API به نسخه جدید
.IP \[bu] 2
رفع اشکال تجزیه زمان ویرایش هنگامی که در فراداده (metadata) موجود نیست
.RE
.IP \[bu] 2
Swift/Hubic
.RS 2
.IP \[bu] 2
عدم بازگرداندن MD5SUM برای اشیاء بزرگ ایستا (static large objects)
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع مشکل بارگذاری فایل‌های بزرگ‌تر از 50GB
.RE.SS v1.28 - 2016-03-01
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
رمزگذاری فایل پیکربندی \- با تشکر از Klaus Post
.IP \[bu] 2
بهبود \f[V]rclone config\f[R] با افزودن راهنمای بیشتر و ساده‌تر کردن درک آن
.IP \[bu] 2
پیاده‌سازی \f[V]-u\f[R]/\f[V]--update\f[R] تا امکان استفاده از زمان‌های ایجاد روی تمام ریموت‌ها فراهم شود
.IP \[bu] 2
پیاده‌سازی پرچم \f[V]--low-level-retries\f[R]
.IP \[bu] 2
امکان غیرفعال‌سازی اختیاری فشرده‌سازی gzip در بارگیری‌ها با \f[V]--no-gzip-encoding\f[R]
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
عدم ساخت دایرکتوری‌ها در صورت تنظیم \f[V]--dry-run\f[R]
.IP \[bu] 2
رفع اشکال و مستندسازی دستور \f[V]move\f[R]
.IP \[bu] 2
رفع تغییر مسیر stderr در سیستم‌عامل‌های شبه یونیکس هنگام استفاده از \f[V]--log-file\f[R]
.IP \[bu] 2
اصلاح دستور \f[V]delete\f[R] جهت انتظار تا پایان همه موارد \- رفع حذف‌های انجام‌نشده.
.RE
.IP \[bu] 2
Backblaze B2
.RS 2
.IP \[bu] 2
استفاده از یک URL بارگذاری به‌ازای هر goroutine که خطای \f[V]more than one upload using auth token\f[R] را برطرف می‌کند
.IP \[bu] 2
افزودن کنترل آهنگ (pacing)، تلاش‌های مجدد و احراز هویت دوباره \- رفع مشکلات انقضای توکن
.IP \[bu] 2
بارگذاری بدون استفاده از فایل موقت از سیستم محلی (و ریموت‌هایی که از SHA1 پشتیبانی می‌کنند)
.IP \[bu] 2
رفع مشکل خواندن متاداده برای تمام فایل‌ها در حالی که نباید انجام می‌شد
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
رفع مشکل فهرست کردن اسناد Drive در ریشه (root)
.IP \[bu] 2
غیرفعال‌سازی کپی و انتقال برای اسناد Google docs
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
رفع بارگذاری فایل‌های تکه‌تکه‌شده (chunked) حاوی نویسه‌های غیر ASCII
.IP \[bu] 2
امکان تنظیم \f[V]storage_url\f[R] در پیکربندی \- با تشکر از Xavier Lucas
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
امکان استفاده از نقش IAM و اطلاعات کاربری از متغیرهای محیطی \- با تشکر از Brian Stengaard
.IP \[bu] 2
امکان استفاده کاربران کم‌دسترسی از S3 (بررسی وجود دایرکتوری حین Mkdir) \- با تشکر از Jakub Gedeon
.RE
.IP \[bu] 2
Amazon Drive
.RS 2
.IP \[bu] 2
تلاش مجدد در موارد بیشتر جهت افزایش اطمینان فهرست‌بندی‌های دایرکتوری
.RE
.SS v1.27 - 2016-01-31
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
پیکربندی آسان‌تر در حالت بدون سر (headless) با \f[V]rclone authorize\f[R]
.IP \[bu] 2
افزودن پشتیبانی از انواع مختلف هش \- اکنون علاوه بر هش‌های MD5 هش‌های SHA1 نیز بررسی می‌شوند.
.IP \[bu] 2
دستور \f[V]delete\f[R] که فیلترها را رعایت می‌کند (برخلاف \f[V]purge\f[R])
.IP \[bu] 2
دستور \f[V]dedupe\f[R] برای حذف داده‌های تکراری یک ریموت.
کاربردی برای Google Drive.
.IP \[bu] 2
افزودن پرچم \f[V]--ignore-existing\f[R] جهت صرف‌نظر از تمام فایل‌های موجود در مقصد.
.IP \[bu] 2
افزودن پرچم‌های \f[V]--delete-before\f[R]، \f[V]--delete-during\f[R] و \f[V]--delete-after\f[R].
.IP \[bu] 2
افزودن پرچم \f[V]--memprofile\f[R] جهت اشکال‌زدایی مصرف حافظه.
.IP \[bu] 2
هشدار به کاربر درباره فایل‌هایی با نام یکسان اما با بزرگی و کوچکی متفاوت حروف
.IP \[bu] 2
تنظیم قواعد \f[V]--include\f[R] به‌گونه‌ای که استثنای ضمنی \f[V]*\f[R] را به انتهای فهرست فیلتر اضافه کنند
.IP \[bu] 2
منسوخ شدن کامپایل با go1.3
.RE
.IP \[bu] 2
Amazon Drive
.RS 2
.IP \[bu] 2
رفع مشکل بارگیری فایل‌های بزرگ‌تر از 10 گیگابایت (> 10 GB)
.IP \[bu] 2
رفع پیمایش دایرکتوری (\[dq]Next token is expired\[dq]) برای فهرست‌بندی‌های بزرگ دایرکتوری
.IP \[bu] 2
حذف خطای تعارض 409 از کدهای خطایی که دوباره تلاش می‌شوند \- جلوگیری از وقفه‌های بسیار طولانی
.RE
.IP \[bu] 2
Backblaze B2
.RS 2
.IP \[bu] 2
بررسی هش‌های SHA1 اکنون توسط هسته rclone انجام می‌شود
.RE
.IP \[bu] 2
Drive
.RS 2
.IP \[bu] 2
افزودن \f[V]--drive-auth-owner-only\f[R] برای در نظر گرفتن صرفاً فایل‌های متعلق به کاربر \- با تشکر از Björn Harrtell
.IP \[bu] 2
برون‌ریزی اسناد Google
.RE
.IP \[bu] 2
Dropbox
.RS 2
.IP \[bu] 2
امکان مهار خطای استثنای فایل با \f[V]-q\f[R]
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
رفع مشکل بارگذاری توسط کاربر فاقد مجوز.
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع به‌روزرسانی زمان‌های ویرایش فایل‌های حاوی \f[V]+\f[R].
.RE
.IP \[bu] 2
Local
.RS 2
.IP \[bu] 2
افزودن گزینه سیستم فایل محلی برای غیرفعال کردن UNC در Windows.
.RE.SS v1.26 - 2016-01-02
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
بک‌اند ذخیره‌سازی Yandex \- با تشکر از Dmitry Burdeev (\[dq]dibu\[dq])
.IP \[bu] 2
پیاده‌سازی بک‌اند ذخیره‌سازی Backblaze B2
.IP \[bu] 2
افزودن پرچم‌های --min-age و --max-age \- با تشکر از Adriano Aurélio Meirelles
.IP \[bu] 2
تبعیت دستورات ls/lsl/md5sum/size/check از includes و excludes
.RE
.IP \[bu] 2
رفع اشکالات
.RS 2
.IP \[bu] 2
رفع خرابی (crash) در ثبت وقایع http
.IP \[bu] 2
بارگذاری نسخه‌های منتشرشده در github نیز انجام می‌شود
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
رفع همگام‌سازی برای فایل‌های تکه‌تکه‌شده (chunked)
.RE
.IP \[bu] 2
OneDrive
.RS 2
.IP \[bu] 2
فعال‌سازی مجدد server-side copy
.IP \[bu] 2
عدم پنهان‌سازی کدهای خطای HTTP با خطای دیکود JSON
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
رفع خراب شدن Content-Type هنگام به‌روزرسانی زمان تغییر (با تشکر از Joseph Spurrier)
.RE
.SS v1.25 - 2015-11-14
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
پیاده‌سازی سیستم ذخیره‌سازی Hubic
.RE
.IP \[bu] 2
رفع اشکالات
.RS 2
.IP \[bu] 2
رفع حذف برخی از فایل‌های مستثنا شده بدون --delete-excluded
.RS 2
.IP \[bu] 2
این مشکل می‌توانست باعث حذف غیرمنتظره فایل‌ها هنگام همگام‌سازی شود
.IP \[bu] 2
همیشه ابتدا با \f[V]--dry-run\f[R] بررسی کنید!
.RE
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
جلوگیری از دست رفتن فراداده‌ها در SetModTime (مانند
X-Object-Manifest)
.RS 2
.IP \[bu] 2
این مورد می‌توانست موجب از دست رفتن داده‌ها در فایل‌های بزرگتر از 5GB شود
.RE
.IP \[bu] 2
استفاده از ContentType مربوط به Object جهت جلوگیری از جستجوهای مکرر در فهرست‌گیری‌ها
.RE
.IP \[bu] 2
OneDrive
.RS 2
.IP \[bu] 2
غیرفعال‌سازی server-side copy به دلیل وجود اشکال در سمت Microsoft
.RE
.SS v1.24 - 2015-11-07
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
افزودن پشتیبانی از Microsoft OneDrive
.IP \[bu] 2
افزودن گزینه \f[V]--no-check-certificate\f[R] برای غیرفعال‌سازی اعتبارسنجی
گواهی سرور
.IP \[bu] 2
افزودن بافر ناهمگام خواندن پیشاپیش (async readahead buffer) برای انتقال سریع‌تر فایل‌های بزرگ
.RE
.IP \[bu] 2
رفع اشکالات
.RS 2
.IP \[bu] 2
مجاز بودن فاصله در نام‌های remote و بررسی اعتبار نام remote در زمان
ایجاد
.IP \[bu] 2
مجاز بودن \[aq]&\[aq] و غیرمجاز بودن \[aq]:\[aq] در نام‌گذاری فایل‌های Windows.
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
نادیده گرفتن اشیاء نشانگر دایرکتوری در صورت لزوم \- امکان کارکردن با
Hubic
.IP \[bu] 2
عدم حذف container در صورتی که fs در ریشه (root) نباشد
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
عدم حذف bucket در صورتی که fs در ریشه (root) نباشد
.RE
.IP \[bu] 2
Google Cloud Storage
.RS 2
.IP \[bu] 2
عدم حذف bucket در صورتی که fs در ریشه (root) نباشد
.RE.SS v1.23 - 2015-10-03
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
پیاده‌سازی \f[V]rclone size\f[R] برای اندازه‌گیری ریموت‌ها
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
رفع مشکل پیکربندی بدون واسط کاربری (headless) برای drive و gcs
.IP \[bu] 2
اطلاع به کاربر برای تلاش دوباره در صورت شکست روش سرور وب
.IP \[bu] 2
بهبود خروجی \f[V]--dump-headers\f[R]
.RE
.IP \[bu] 2
S3
.RS 2
.IP \[bu] 2
امکان دسترسی ناشناس به باکت‌های عمومی
.RE
.IP \[bu] 2
Swift
.RS 2
.IP \[bu] 2
توقف ثبت گزارش \[dq]Failed to read info: Object Not Found\[dq] در عملیات‌های چندبخشی (chunked)
.IP \[bu] 2
استفاده از Content-Length در بارگذاری‌ها برای اطمینان‌پذیری بیشتر
.RE
.SS v1.22 - 2015-09-28
.IP \[bu] 2
پیاده‌سازی گزینه‌های include و exclude مشابه rsync
.IP \[bu] 2
swift
.RS 2
.IP \[bu] 2
پشتیبانی از فایل‌های بزرگتر از ۵ گیگابایت \- با تشکر از Sergey Tolmachev
.RE
.SS v1.21 - 2015-09-22
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
نمایش پیشرفت انتقال فایل‌ها به‌صورت تفکیک‌شده
.IP \[bu] 2
نمایش زمان‌ها در خروجی lsl بر اساس زمان محلی
.RE
.IP \[bu] 2
رفع باگ‌ها
.RS 2
.IP \[bu] 2
امکان بازنویسی مجدد اطلاعات اعتبارنامه توسط کاربر در Drive، GCS و ACD
.RE
.IP \[bu] 2
Amazon Drive
.RS 2
.IP \[bu] 2
پیاده‌سازی سازوکار تنظیم آهنگ ارسال (pacing) سازگار
.RE
.IP \[bu] 2
Google Drive
.RS 2
.IP \[bu] 2
هم‌روندسازی خواندن دایرکتوری‌ها جهت افزایش سرعت.
.RE
.SS v1.20 - 2015-09-15
.IP \[bu] 2
قابلیت‌های جدید
.RS 2
.IP \[bu] 2
پشتیبانی از Amazon Drive
.IP \[bu] 2
بازنویسی پشتیبانی از Oauth \- رفع باگ‌های متعدد و بهبود سهولت استفاده
.RS 2
.IP \[bu] 2
استفاده از \[dq]golang.org/x/oauth2\[dq] به‌عنوان کتابخانه منتخب oauth
.IP \[bu] 2
بهبود کارایی oauth برای ثبت‌نام اولیه روان‌تر
.IP \[bu] 2
drive، googlecloudstorage: استفاده اختیاری از پیکربندی خودکار برای توکن oauth
.RE
.IP \[bu] 2
پیاده‌سازی پرچم‌های اشکال‌زدایی --dump-headers و --dump-bodies
.IP \[bu] 2
نمایش چندین دستور منطبق در صورت بسیار کوتاه بودن مخفف
.IP \[bu] 2
پیاده‌سازی انتقال سمت سرور (server-side move) در صورت امکان
.RE
.IP \[bu] 2
local
.RS 2
.IP \[bu] 2
استفاده همیشگی از مسیرهای UNC به‌صورت داخلی در ویندوز \- رفع بسیاری از باگ‌ها
.RE
.IP \[bu] 2
dropbox
.RS 2
.IP \[bu] 2
اجبار به استفاده از ترانسپورت اختصاصی ما که باعث کارکرد درست مهلت‌های زمانی (timeouts) می‌شود
.RE
.IP \[bu] 2
با تشکر از Klaus Post برای کمک‌های فراوان در این انتشار.SS v1.19 \- 2015-08-28
.IP \[bu] 2
ویژگی‌های جدید
.RS 2
.IP \[bu] 2
کپی‌های سمت سرور برای s3/swift/drive/dropbox/gcs
.IP \[bu] 2
دستور Move \- در صورت امکان از کپی‌های سمت سرور استفاده می‌کند
.IP \[bu] 2
پیاده‌سازی پرچم \-\-retries \- به‌طور پیش‌فرض ۳ بار تلاش مجدد می‌کند
.IP \[bu] 2
کامپایل برای plan9/amd64 و solaris/amd64 نیز اضافه شد
.RE
.IP \[bu] 2
اصلاحات
.RS 2
.IP \[bu] 2
ایجاد قابلیت بارگیری نسخهٔ فعلی با نشانی وب (URL) ثابت برای اسکریپت‌نویسی
.IP \[bu] 2
نادیده گرفتن rmdir در سیستم‌های فایل محدود به‌جای ارسال خطا
.RE
.IP \[bu] 2
dropbox
.RS 2
.IP \[bu] 2
افزایش اندازهٔ تکه‌ها (chunk size) برای ارتقای چشمگیر سرعت بارگذاری
.IP \[bu] 2
نمایش پیام خطا هنگام تلاش برای بارگذاری نام فایل نامعتبر
.RE
.SS v1.18 \- 2015-08-17
.IP \[bu] 2
drive
.RS 2
.IP \[bu] 2
افزودن پرچم \f[V]\-\-drive-use-trash\f[R] تا rclone به‌جای حذف کامل، فایل‌ها را به سطل زباله منتقل کند
.IP \[bu] 2
افزودن پیام \[dq]Forbidden to download\[dq] برای فایل‌های فاقد downloadURL
.RE
.IP \[bu] 2
dropbox
.RS 2
.IP \[bu] 2
حذف datastore
.RS 2
.IP \[bu] 2
این قابلیت منسوخ شده بود و مشکلات زیادی ایجاد می‌کرد
.IP \[bu] 2
زمان‌های تغییر و مقادیر MD5SUM دیگر ذخیره نمی‌شوند
.RE
.IP \[bu] 2
رفع مشکل بارگذاری فایل‌های بزرگ‌تر از 2GB
.RE
.IP \[bu] 2
s3
.RS 2
.IP \[bu] 2
استفاده از SDK رسمی AWS از github.com/aws/aws-sdk-go
.IP \[bu] 2
\f[B]توجه:\f[R] به احتمال زیاد نیازمند حذف و ساخت مجدد remote خواهد بود
.IP \[bu] 2
فعال‌سازی multipart upload که امکان ارسال فایل‌های بزرگ‌تر از 5GB را فراهم می‌کند
.IP \[bu] 2
آزمایش‌شده با شبیه‌سازی Ceph / RadosGW / S3
.IP \[bu] 2
تشکر فراوان از Sam Liston و Brian Haymore در مرکز محاسبات با کارایی بالای یوتا (https://www.chpc.utah.edu) برای حساب آزمایشی Ceph
.RE
.IP \[bu] 2
متفرقه
.RS 2
.IP \[bu] 2
نمایش خطاها هنگام خواندن فایل پیکربندی (config)
.IP \[bu] 2
عدم چاپ آمار در حالت بی‌صدا (quiet mode) \- با تشکر از Leonid Shalupov
.IP \[bu] 2
افزودن پرسش‌های متداول (FAQ)
.IP \[bu] 2
رفع مشکل عدم پیروی دایرکتوری‌های ایجادشده از umask
.IP \[bu] 2
راهنمای نصب لینوکس \- با تشکر از Shimon Doodkin
.RE.SS v1.17 - 2015-06-14
.IP \[bu] 2
dropbox: رفع اشکالات عدم حساسیت به حروف کوچک و بزرگ \- با تشکر از Leonid Shalupov
.SS v1.16 - 2015-06-09
.IP \[bu] 2
رفع مشکل بارگذاری فایل‌های بزرگ که باعث ایجاد timeout یا panic می‌شد
.IP \[bu] 2
عدم بررسی md5sum پس از بارگیری هنگام استفاده از \-\-size\-only
.SS v1.15 - 2015-06-06
.IP \[bu] 2
افزودن پرچم \-\-checksum برای نادیده گرفتن انتقال‌ها صرفاً بر اساس MD5SUM \- با تشکر از Alex Couper
.IP \[bu] 2
پیاده‌سازی پرچم \-\-size\-only برای همگام‌سازی تنها بر اساس اندازه و نه checksum و modtime
.IP \[bu] 2
گسترش مستندات و حذف اطلاعات تکراری
.IP \[bu] 2
مستندسازی محدودیت‌های rclone در کار با دایرکتوری‌ها
.IP \[bu] 2
dropbox: به‌روزرسانی مستندات درباره عدم حساسیت به حروف کوچک و بزرگ
.SS v1.14 - 2015-05-21
.IP \[bu] 2
local: رفع مشکل کدگذاری نام‌های فایل غیر utf-8 \- حل مشکل فایل‌های تکراری
.IP \[bu] 2
drive: مستندات مربوط به محدودیت نرخ درخواست (rate limiting)
.IP \[bu] 2
google cloud storage: رفع مشکل کامپایل پس از تغییر API در
\[dq]google.golang.org/api/storage/v1\[dq]
.SS v1.13 - 2015-05-10
.IP \[bu] 2
بازنگری مستندات (به‌ویژه sync)
.IP \[bu] 2
پیاده‌سازی \-\-timeout و \-\-conntimeout
.IP \[bu] 2
s3: نادیده گرفتن etagهای حاصل از بارگذاری‌های چندبخشی (multipart) که md5sum نیستند
.SS v1.12 - 2015-03-15
.IP \[bu] 2
drive: استفاده از بارگذاری تکه‌تکه (chunked upload) برای فایل‌های بزرگ‌تر از یک اندازه معین
.IP \[bu] 2
drive: افزودن پارامترهای \-\-drive\-chunk\-size و \-\-drive\-upload\-cutoff
.IP \[bu] 2
drive: تغییر حالت از update به insert زمانی که رونوشت ناموفق باعث حذف بارگذاری می‌شود
.IP \[bu] 2
core: ثبت فایل‌های تکراری در گزارش در صورت شناسایی آن‌ها
.SS v1.11 - 2015-03-04
.IP \[bu] 2
swift: افزودن پارامتر region
.IP \[bu] 2
drive: رفع خرابی (crash) ناشی از ناموفق بودن به‌روزرسانی mtime ریموت
.IP \[bu] 2
تغییر جداکننده‌های محلی دایرکتوری به / در مسیرهای ریموت
.IP \[bu] 2
افزودن همگام‌سازی به خروجی ls/lsl/lsd برای جلوگیری از خرابی داده‌ها
.IP \[bu] 2
اطمینان از هدایت تمام پیام‌های وضعیت/گزارش به stderr
.IP \[bu] 2
افزودن پرچم \-\-log\-file برای ثبت همه‌چیز (از جمله هشدارهای panic) در فایل
.IP \[bu] 2
امکان غیرفعال‌سازی چاپ وضعیت با \-\-stats=0
.IP \[bu] 2
پیاده‌سازی \-\-bwlimit برای محدود کردن پهنای باند انتقال داده
.SS v1.10 - 2015-02-12
.IP \[bu] 2
s3: فهرست کردن تعداد نامحدودی از موارد
.IP \[bu] 2
رفع مشکل گیر کردن در پیکربندی‌کننده (configurator)
.SS v1.09 - 2015-02-07
.IP \[bu] 2
windows: جلوگیری از تداخل حروف درایو (مانند
:C) با ریموت‌ها (مانند
:drive)
.IP \[bu] 2
local: اصلاح جداکننده‌های دایرکتوری در Windows
.IP \[bu] 2
drive: رفع خطاهای فراتر رفتن از محدودیت نرخ (rate limit exceeded)
.SS v1.08 - 2015-02-04
.IP \[bu] 2
drive: اصلاح فهرست کردن زیردایرکتوری‌ها جهت جلوگیری از فهرست شدن کل درایو
.IP \[bu] 2
drive: رفع اشکال SetModTime
.IP \[bu] 2
dropbox: تطبیق کد با تغییرات اخیر کتابخانه.SS v1.07 - 2014-12-23
.IP \[bu] 2
google cloud storage: رفع نشت حافظه
.SS v1.06 - 2014-12-12
.IP \[bu] 2
رفع خطای \[dq]Couldn\[aq]t find home directory\[dq] در OSX
.IP \[bu] 2
swift: افزودن پارامتر tenant
.IP \[bu] 2
استفاده از مکان جدید بسته‌های Google API
.SS v1.05 - 2014-08-09
.IP \[bu] 2
بهبود آزمون‌ها و در نتیجه انجام اصلاحات جزئی فراوان
.IP \[bu] 2
core: رفع وضعیت رقابتی شناسایی‌شده توسط آشکارساز رقابت go
.IP \[bu] 2
core: اصلاحات پس از اجرای errcheck
.IP \[bu] 2
drive: بازنشانی دایرکتوری ریشه هنگام Rmdir و Purge
.IP \[bu] 2
fs: مستندسازی اینکه Purger روی دایرکتوری خالی خطا برمی‌گرداند، همراه با آزمون و رفع اشکال
.IP \[bu] 2
google cloud storage: رفع اشکال ListDir روی زیرپوشه
.IP \[bu] 2
google cloud storage: بازخوانی متادیتا در SetModTime
.IP \[bu] 2
s3: قابل‌اطمینان‌تر کردن خواندن متادیتا برای دور زدن مشکلات
سازگاری نهایی (eventual consistency)
.IP \[bu] 2
s3: حذف / انتهایی از ListDir()
.IP \[bu] 2
swift: برگرداندن دایرکتوری‌ها بدون / در ListDir
.SS v1.04 - 2014-07-21
.IP \[bu] 2
google cloud storage: رفع کرش هنگام Update
.SS v1.03 - 2014-07-20
.IP \[bu] 2
swift، s3، dropbox: رفع اشکال علامت‌گذاری فایل‌های به‌روزشده به‌عنوان خراب
.IP \[bu] 2
امکان کامپایل مجدد با go 1.1
.SS v1.02 - 2014-07-19
.IP \[bu] 2
پیاده‌سازی ریموت Dropbox
.IP \[bu] 2
پیاده‌سازی ریموت Google Cloud Storage
.IP \[bu] 2
اعتبارسنجی Md5sum و اندازه‌ها پس از کپی
.IP \[bu] 2
حذف زمان‌ها از دستور \[dq]ls\[dq] \- فقط اندازه‌ها را فهرست می‌کند
.IP \[bu] 2
افزودن دستور \[dq]lsl\[dq] \- فهرست کردن زمان‌ها و اندازه‌ها
.IP \[bu] 2
افزودن دستور \[dq]md5sum\[dq]
.SS v1.01 - 2014-07-04
.IP \[bu] 2
drive: رفع اشکال مصرف بیش‌ازحد حافظه هنگام انتقال فایل‌های حجیم
.SS v1.00 - 2014-07-03
.IP \[bu] 2
drive: رفع اشکال تاریخ‌ها با ثانیهٔ کامل
.SS v0.99 - 2014-06-26
.IP \[bu] 2
رفع اشکال کار نکردن \-\-dry\-run
.IP \[bu] 2
ایجاد سازگاری با go 1.1
.SS v0.98 - 2014-05-30
.IP \[bu] 2
s3: در نظر گرفتن Content-Length مفقود به‌صورت 0 برای برخی نصب‌های ceph
.IP \[bu] 2
rclonetest: افزودن فایلی حاوی فاصله در نام آن
.SS v0.97 - 2014-05-05
.IP \[bu] 2
پیاده‌سازی کپی کردن فایل‌های تکی
.IP \[bu] 2
s3 و swift: پشتیبانی از مسیرهای درون containers/buckets
.SS v0.96 - 2014-04-24
.IP \[bu] 2
drive: رفع اشکال ایجاد چندین فایل با نام یکسان
.IP \[bu] 2
drive: استفاده از o.Update و fs.Put برای بهینه‌سازی انتقال‌ها
.IP \[bu] 2
افزودن شمارهٔ نسخه، \-V و \-\-version.SS v0.95 - 2014-03-28
.IP \[bu] 2
rclone.org: وب‌سایت، مستندات و گرافیک‌ها
.IP \[bu] 2
drive: رفع مشکل تجزیه مسیر
.SS v0.94 - 2014-03-27
.IP \[bu] 2
تغییر قالب ریموت برای آخرین بار
.IP \[bu] 2
پرچم‌های به سبک GNU
.SS v0.93 - 2014-03-16
.IP \[bu] 2
drive: ذخیره توکن در فایل پیکربندی
.IP \[bu] 2
کامپایل چندسکویی سایر نسخه‌ها
.IP \[bu] 2
تنظیم مجوزهای سخت‌گیرانه برای فایل پیکربندی
.SS v0.92 - 2014-03-15
.IP \[bu] 2
اصلاحات پیکربندی و گزینهٔ \-\-config
.SS v0.91 - 2014-03-15
.IP \[bu] 2
ایجاد فایل پیکربندی
.SS v0.90 - 2013-06-27
.IP \[bu] 2
نام‌گذاری پروژه به rclone
.SS v0.00 - 2012-11-18
.IP \[bu] 2
آغاز پروژه
.SH "باگ‌ها و محدودیت‌ها (BUGS AND LIMITATIONS)"
.SS محدودیت‌ها
.SS برچسب‌های زمانی دایرکتوری در برخی بک‌اندها حفظ نمی‌شوند
.PP
از نسخهٔ \f[V]v1.66\f[R]، در صورتی که بک‌اند پشتیبانی کند، rclone از همگام‌سازی زمان‌های تغییر (modtimes) دایرکتوری پشتیبانی می‌کند.
برخی بک‌اندها از آن پشتیبانی نمی‌کنند \-\- برای مشاهده فهرست کامل،
مرور کلی (https://rclone.org/overview) را ببینید.
علاوه بر این، توجه داشته باشید که دایرکتوری‌های خالی به‌طور پیش‌فرض همگام‌سازی نمی‌شوند
(این امکان با \f[V]--create-empty-src-dirs\f[R] قابل فعال‌سازی است.)
.SS مشکل rclone با میلیون‌ها فایل در یک دایرکتوری/باکت
.PP
در حال حاضر rclone پیش از استفاده از هر دایرکتوری/باکت، آن را به‌طور کامل در حافظه بارگذاری می‌کند.
از آنجا که هر شیء rclone حدود 0.5k\-1k از حافظه را اشغال می‌کند، این کار می‌تواند زمان بسیار زیادی برده و مقدار زیادی حافظه مصرف کند.
.PP
وجود میلیون‌ها فایل در یک دایرکتوری معمولاً در ریموت‌های مبتنی بر باکت
(مانند باکت‌های S3) رخ می‌دهد، زیرا این ریموت‌ها زیردایرکتوری‌ها را در داخل باکت تفکیک نمی‌کنند.
.SS ریموت‌های مبتنی بر باکت و پوشه‌ها
.PP
ریموت‌های مبتنی بر باکت (مانند
S3/GCS/Swift/B2) مفهومی به نام دایرکتوری ندارند.
بنابراین rclone نمی‌تواند در آن‌ها دایرکتوری ایجاد کند، به این معنی که دایرکتوری‌های خالی در یک ریموت مبتنی بر باکت ناپدید خواهند شد.
.PP
برخی نرم‌افزارها کلیدهای خالی که به \f[V]/\f[R] ختم می‌شوند را به عنوان نشانگر دایرکتوری ایجاد می‌کنند.
rclone این کار را انجام نمی‌دهد چرا که این عمل می‌تواند اشیاء بیشتری ایجاد کرده و هزینهٔ بیشتری به همراه داشته باشد.
این قابلیت ممکن است در آینده اضافه شود (احتمالاً از طریق یک پرچم/گزینه).
.SS باگ‌ها
.PP
باگ‌ها در پروژهٔ گیت‌هاب rclone ثبت و نگهداری می‌شوند:
.IP \[bu] 2
باگ‌های گزارش‌شده (https://github.com/rclone/rclone/issues?q=is%3Aopen+is%3Aissue+label%3Abug)
.IP \[bu] 2
مشکلات شناخته‌شده (https://github.com/rclone/rclone/issues?q=is%3Aopen+is%3Aissue+milestone%3A%22Known+Problem%22)
.SH "پرسش‌های متداول (FREQUENTLY ASKED QUESTIONS)"
.SS آیا تمام سیستم‌های ذخیره‌سازی ابری از همهٔ دستورات rclone پشتیبانی می‌کنند؟
.PP
بله، پشتیبانی می‌کنند.
تمامی دستورات rclone (مانند
\f[V]sync\f[R]، \f[V]copy\f[R] و غیره)
روی تمام سیستم‌های ذخیره‌سازی دوردست کار خواهند کرد.
.SS آیا می‌توانم پیکربندی را از یک ماشین به ماشین دیگری کپی کنم؟
.PP
حتماً!
rclone تمام پیکربندی خود را در یک فایل واحد ذخیره می‌کند.
اگر می‌خواهید این فایل را پیدا کنید، دستور \f[V]rclone config file\f[R] را اجرا کنید تا مسیر آن به شما نشان داده شود.
.PP
برای اطلاعات بیشتر، مستندات راه‌اندازی ریموت (https://rclone.org/remote_setup) را ببینید..SS چگونه rclone را روی یک ماشین دوردست / headless بدون مرورگر پیکربندی کنم؟
.PP
این مورد اکنون در صفحه اختصاصی راه‌اندازی ریموت
(https://rclone.org/remote_setup) مستندسازی شده است.
.SS چگونه می‌توانم از شر اعلان \[dq]Config file not found\[dq] خلاص شوم؟
.PP
اگر اعلانی مانند \[aq]NOTICE: Config file \[dq]rclone.conf\[dq]
not found\[aq] مشاهده کردید، بدین معنی است که هیچ ریموتی را پیکربندی نکرده‌اید.
.PP
اگر نیاز به پیکربندی یک ریموت دارید، مستندات راهنمای پیکربندی
(https://rclone.org/docs/#configure) را ببینید.
.PP
اگر به طور کامل از rclone به همراه ریموت‌های آنی
(https://rclone.org/docs/#backend-path-to-dir) استفاده می‌کنید، می‌توانید برای خلاص شدن
از این اعلان یک فایل پیکربندی خالی بسازید؛ برای مثال:
.IP
.nf
\f[C]
rclone config touch
\f[R]
.fi
.SS آیا rclone می‌تواند مستقیماً از drive به s3 همگام‌سازی کند؟
.PP
نرم‌افزار rclone می‌تواند به خوبی بین دو سیستم ذخیره‌سازی ابری ریموت همگام‌سازی انجام دهد.
.PP
توجه داشته باشید که در عمل، فایل دانلود شده و مجدداً آپلود می‌شود؛ بنابراین
گره‌ای که rclone را اجرا می‌کند نیاز به پهنای باند زیادی خواهد داشت.
.PP
همگام‌سازی‌ها به صورت افزایشی (فایل به فایل) خواهند بود.
.PP
برای مثال:
.IP
.nf
\f[C]
rclone sync --interactive drive:Folder s3:bucket
\f[R]
.fi
.SS استفاده از rclone از چند مکان مختلف به طور همزمان
.PP
در صورتی که زیردایرکتوری‌های متفاوتی را برای خروجی انتخاب کنید، می‌توانید
به طور همزمان از rclone در چندین مکان استفاده کنید؛ برای مثال:
.IP
.nf
\f[C]
Server A> rclone sync --interactive /tmp/whatever remote:ServerA
Server B> rclone sync --interactive /tmp/whatever remote:ServerB
\f[R]
.fi
.PP
اگر با یک دایرکتوری یکسان همگام‌سازی می‌کنید، باید از rclone copy استفاده نمایید؛
در غیر این صورت دو نمونه rclone ممکن است فایل‌های یکدیگر را حذف کنند؛ برای مثال:
.IP
.nf
\f[C]
Server A> rclone copy /tmp/whatever remote:Backup
Server B> rclone copy /tmp/whatever remote:Backup
\f[R]
.fi
.PP
نام فایل‌هایی که از Server A و Server B آپلود می‌کنید در این حالت باید متفاوت باشند،
در غیر این صورت برخی سیستم‌های فایل (مانند Drive) ممکن است نسخه‌های تکراری بسازند.
.SS چرا rclone از انتقال‌های جزئی / تفاوت‌های باینری مانند rsync پشتیبانی نمی‌کند؟
.PP
نرم‌افزار rclone هر فایلی را که منتقل می‌کنید به عنوان یک شیء بومی (native object) بر روی
سیستم ذخیره‌سازی ابری ریموت ذخیره می‌کند.
بدین معنا که می‌توانید فایل‌هایی را که آپلود می‌کنید با استفاده از روش‌های دسترسی متفرقه
(مانند رابط وب Google Drive) همان‌طور که انتظار می‌رود مشاهده کنید.
یک نگاشت 1:1 میان فایل‌های روی دیسک سخت شما و اشیاء ایجادشده در سیستم ذخیره‌سازی
ابری وجود دارد.
.PP
سیستم‌های ذخیره‌سازی ابری (حداقل مواردی که تاکنون با آن‌ها مواجه شده‌ام)
از آپلود جزئی یک شیء پشتیبانی نمی‌کنند.
شما نمی‌توانید یک شیء موجود را انتخاب کرده و چند بایت را در میانه آن تغییر دهید.
.PP
امکان‌پذیر است که یک سیستم همگام‌سازی ساخته شود که به جای اشیاء کامل،
مانند rsync تفاوت‌های باینری را ذخیره کند، اما این کار نگاشت 1:1 فایل‌های روی
دیسک سخت به اشیاء سیستم ذخیره‌سازی ابری ریموت را از بین می‌برد.
.PP
تمامی سیستم‌های ذخیره‌سازی ابری از دانلود جزئی محتوا پشتیبانی می‌کنند، بنابراین
امکان پیاده‌سازی دانلودهای جزئی وجود دارد.
با این حال، برای اینکه این سازوکار کارآمد باشد، نیاز به ذخیره حجم قابل‌توجهی متادیتا است
که نگاشت مطلوب 1:1 فایل‌ها به اشیاء را برهم می‌زند..SS آیا rclone می‌تواند همگام‌سازی دوطرفه انجام دهد؟
.PP
بله، از نسخهٔ v1.58.0 برنامهٔ rclone، قابلیت همگام‌سازی ابری دوطرفه (https://rclone.org/bisync) در دسترس است.
.SS آیا می‌توانم از rclone با یک پروکسی HTTP استفاده کنم؟
.PP
بله.
rclone مشابه cURL و سایر برنامه‌ها، از متغیرهای محیطی استاندارد برای پروکسی‌ها پیروی می‌کند.
.PP
به‌طور کلی نام این متغیرها \f[V]http_proxy\f[R] (برای سرویس‌های تحت بستر \f[V]http\f[R]) و \f[V]https_proxy\f[R] (برای سرویس‌های تحت بستر \f[V]https\f[R]) است.
اکثر سرویس‌های عمومی از \f[V]https\f[R] استفاده می‌کنند، اما ممکن است بخواهید هر دو را تنظیم کنید.
.PP
محتوای متغیر به‌صورت \f[V]protocol://server:port\f[R] است.
مقدار protocol پروتکلی است که برای برقراری ارتباط با خود کارساز پروکسی استفاده می‌شود و معمولاً \f[V]http\f[R] یا \f[V]socks5\f[R] است.
.PP
تا حدودی آزاردهنده است که هیچ \f[I]استانداردی\f[R] برای نام آن وجود ندارد؛ برخی برنامه‌ها ممکن است از \f[V]http_proxy\f[R] استفاده کنند اما برنامهٔ دیگری از \f[V]HTTP_PROXY\f[R] بهره ببرد.
کتابخانه‌های \f[V]Go\f[R] که توسط \f[V]rclone\f[R] استفاده می‌شوند هر دو حالت را بررسی خواهند کرد، اما ممکن است بخواهید تمام حالت‌های ممکن را مقداردهی کنید.
بنابراین، در Linux ممکن است با کدی شبیه به این کار کنید:
.IP
.nf
\f[C]
export http_proxy=http://proxyserver:12345
export https_proxy=$http_proxy
export HTTP_PROXY=$http_proxy
export HTTPS_PROXY=$http_proxy
\f[R]
.fi
.PP
نکته: اگر کارساز پروکسی نیازمند نام کاربری و گذرواژه است، از دستورات زیر استفاده کنید:
.IP
.nf
\f[C]
export http_proxy=http://username:password\[at]proxyserver:12345
export https_proxy=$http_proxy
export HTTP_PROXY=$http_proxy
export HTTPS_PROXY=$http_proxy
\f[R]
.fi
.PP
متغیر \f[V]NO_PROXY\f[R] به شما امکان می‌دهد پروکسی را برای میزبان‌های خاصی غیرفعال کنید.
میزبان‌ها باید با کاما جدا شوند و می‌توانند شامل دامنه‌ها یا بخش‌هایی از آن‌ها باشند.
برای نمونه \[dq]foo.com\[dq] با \[dq]bar.foo.com\[dq] نیز مطابقت دارد.
.PP
برای مثال:
.IP
.nf
\f[C]
export no_proxy=localhost,127.0.0.0/8,my.host.name
export NO_PROXY=$no_proxy
\f[R]
.fi
.PP
توجه داشته باشید که پشتیبان FTP هنوز از \f[V]ftp_proxy\f[R] پشتیبانی نمی‌کند.
.PP
می‌توانید از آرگومان خط فرمان \f[V]--http-proxy\f[R] برای تنظیم پروکسی استفاده کنید، و در صورت تمایل به تنظیم آن برای یک پشتیبان منفرد، از بازنویسی (override) در فایل پیکربندی استفاده کنید؛ مانند \f[V]override.http_proxy = http://...\f[R] در فایل پیکربندی.
.PP
پشتیبان‌های FTP و SFTP تنظیمات \f[V]http_proxy\f[R] مخصوص به خود را برای پشتیبانی از پروکسی HTTP CONNECT دارند (
--ftp-http-proxy (https://rclone.org/ftp/#ftp-http-proxy) و
--sftp-http-proxy (https://rclone.org/ftp/#sftp-http-proxy) )
.SS خطای گواهی‌های ریشه SSL مربوط به x509 در Rclone
.PP
پیام \f[V]x509: failed to load system roots and no roots provided\f[R] به این معنی است که \f[V]rclone\f[R] نمی‌تواند گواهی‌های ریشه SSL را بیابد.
احتمالاً در حال اجرای \f[V]rclone\f[R] روی یک NAS با یک سیستم‌عامل Linux سبک‌شده، یا احتمالاً روی Solaris هستید.
.PP
خطای \f[V]x509: certificate signed by unknown authority\f[R] ممکن است در سیستم‌های قدیمی رخ دهد، جایی که \f[V]rclone\f[R] نمی‌تواند کارساز را با گواهی‌های ریشه SSL تأیید اعتبار کند.
.PP
برنامهٔ Rclone (از طریق زمان اجرای Go) تلاش می‌کند گواهی‌های ریشه را در Linux از این مکان‌ها بارگیری کند:
.IP
.nf
\f[C]
\[dq]/etc/ssl/certs/ca-certificates.crt\[dq], // Debian/Ubuntu/Gentoo etc.
\[dq]/etc/pki/tls/certs/ca-bundle.crt\[dq],   // Fedora/RHEL
\[dq]/etc/ssl/ca-bundle.pem\[dq],             // OpenSUSE
\[dq]/etc/pki/tls/cacert.pem\[dq],            // OpenELEC
\f[R]
.fi
.PP
بنابراین انجام عملی شبیه به این باید مشکل را برطرف کند.
همچنین این دستور زمان را تنظیم می‌کند که برای کارکرد صحیح SSL حائز اهمیت است.
.IP
.nf
\f[C]
mkdir -p /etc/ssl/certs/
curl -o /etc/ssl/certs/ca-certificates.crt https://raw.githubusercontent.com/bagder/ca-bundle/master/ca-bundle.crt
ntpclient -s -h pool.ntp.org
\f[R]
.fi
.PP
دو متغیر محیطی \f[V]SSL_CERT_FILE\f[R] و \f[V]SSL_CERT_DIR\f[R] که در بستهٔ x509 (https://godoc.org/crypto/x509) به آن‌ها اشاره شده است، روشی دیگر برای ارائهٔ گواهی‌های ریشه SSL در سیستم‌های Unix به‌جز macOS فراهم می‌کنند.
.PP
توجه داشته باشید که اگر بدون آن کار نکرد، ممکن است لازم باشد گزینهٔ \f[V]--insecure\f[R] را به خط فرمان \f[V]curl\f[R] اضافه کنید.
.IP
.nf
\f[C]
curl --insecure -o /etc/ssl/certs/ca-certificates.crt https://raw.githubusercontent.com/bagder/ca-bundle/master/ca-bundle.crt
\f[R]
.fi
.PP
در macOS، می‌توانید ca-certificates (https://formulae.brew.sh/formula/ca-certificates) را با Homebrew نصب کنید و با پرچم --ca-cert (https://rclone.org/docs/#ca-cert-stringarray) گواهی‌های ریشه SSL را مشخص کنید.
.IP
.nf
\f[C]
brew install ca-certificates
find $(brew --prefix)/etc/ca-certificates -type f
\f[R]
.fi.SS خطای Failed to load config file: function not implemented در Rclone
.PP
این خطا احتمالاً به این معنی است که شما rclone را روی نسخه‌ای از لینوکس اجرا می‌کنید که توسط زمان اجرای Go پشتیبانی نمی‌شود، یعنی نسخه‌های پیش از 2.6.23.
.PP
برای جزئیات کامل، بخش پیش‌نیازهای سیستم را در مستندات نصب Go (<https://golang.org/doc/install>) مشاهده کنید.
.SS تمام فایل‌های docx/xlsx/pptx بارگذاری‌شده به‌صورت archive/zip نمایش داده می‌شوند
.PP
این مشکل به دلیل بارگذاری این فایل‌ها از یک رایانه ویندوزی رخ می‌دهد که مجموعه Microsoft Office روی آن نصب نشده است.
ساده‌ترین راه برای رفع آن، نصب Word viewer و بسته Microsoft Office Compatibility Pack برای قالب‌های فایل Word، Excel و PowerPoint نسخه ۲۰۰۷ و نسخه‌های بالاتر است.
.SS خطای tcp lookup some.domain.com no such host
.PP
این حالت زمانی رخ می‌دهد که rclone قادر به تحلیل و تفکیک نام (resolve) یک دامنه نباشد.
لطفاً بررسی کنید که پیکربندی DNS شما به‌طور کلی کار می‌کند، به عنوان مثال:
.IP
.nf
\f[C]
# both should print a long list of possible IP addresses
dig www.googleapis.com          # resolve using your default DNS
dig www.googleapis.com \[at]8.8.8.8 # resolve with Google\[aq]s DNS server
\f[R]
.fi
.PP
اگر از \f[V]systemd-resolved\f[R] استفاده می‌کنید (پیش‌فرض در Arch Linux)، اطمینان حاصل کنید که نسخه آن ۲۳۳ یا بالاتر باشد.
نسخه‌های پیشین دارای باگی هستند که مانع تفکیک صحیح تمام دامنه‌ها می‌شود.
.PP
تصمیم‌گیری تفکیک‌کننده Go را می‌توان با متغیر محیطی \f[V]GODEBUG=netdns=...\f[R] تغییر داد.
این کار همچنین امکان برطرف کردن برخی مشکلات تفکیک DNS را فراهم می‌سازد.
در سیستم‌های Windows یا MacOS، با تنظیم \f[V]GODEBUG=netdns=go\f[R] در زمان اجرا، استفاده از تفکیک‌کننده داخلی Go را اجبار کنید.
در سایر سیستم‌ها (Linux، *BSD و غیره) با تنظیم \f[V]GODEBUG=netdns=cgo\f[R] استفاده از تفکیک‌کننده نام سیستم را اجبار کنید (و در صورت لزوم rclone را با فعال بودن CGO مجدداً از مبدأ کامپایل کنید).
بخش تحلیل نام را در مستندات Go (<https://golang.org/pkg/net/#hdr-Name_Resolution>) مشاهده کنید.
.SS خطای Failed to start auth webserver در Windows
.IP
.nf
\f[C]
Error: config failed to refresh token: failed to start auth webserver: listen tcp 127.0.0.1:53682: bind: An attempt was made to access a socket in a way forbidden by its access permissions.
\&...
yyyy/mm/dd hh:mm:ss Fatal error: config failed to refresh token: failed to start auth webserver: listen tcp 127.0.0.1:53682: bind: An attempt was made to access a socket in a way forbidden by its access permissions.
\f[R]
.fi
.PP
این مسئله گاهی به این دلیل رخ می‌دهد که سرویس Host Network Service در باز کردن درگاه روی میزبان دچار مشکل می‌شود.
.PP
یک راه‌حل ساده می‌تواند راه‌اندازی مجدد Host Network Service باشد، مثلاً با Powershell:
.IP
.nf
\f[C]
Restart-Service hns
\f[R]
.fi
.SS اندازه کل گزارش‌شده در آمار برای یک همگام‌سازی نادرست است و مدام تغییر می‌کند
.PP
احتمالاً بیش از ۱۰٬۰۰۰ فایل دارید که باید همگام‌سازی شوند.
به‌طور پیش‌فرض، rclone در یک همگام‌سازی (sync) تنها تا ۱۰٬۰۰۰ فایل جلوتر را بررسی می‌کند تا حافظه بیش از حد مصرف نشود.
می‌توانید این مقدار پیش‌فرض را با پرچم \-\-max\-backlog (<https://rclone.org/docs/#max-backlog-int>) تغییر دهید.
.SS مصرف بیش از حد حافظه توسط Rclone یا احتمال وجود نشت حافظه
.PP
برنامه Rclone به زبان Go نوشته شده است که از بازیافت حافظه (garbage collector) استفاده می‌کند.
تنظیمات پیش‌فرض بازیافت حافظه به این صورت است که وقتی اندازه heap دو برابر شود، اجرا می‌گردد.
.PP
با این حال می‌توان با تنظیم GOGC (<https://dave.cheney.net/tag/gogc>) روی مقداری کمتر، برای مثال \f[V]export GOGC=20\f[R]، بازیافت حافظه را برای مصرف حافظه کمتر بهینه‌سازی کرد.
این کار باعث می‌شود بازیافت حافظه بیشتر کار کند و در ازای مصرف بیشتر CPU، حجم حافظه مصرفی را کاهش دهد.
.PP
رایج‌ترین دلیل مصرف بالای حافظه توسط rclone، وجود یک دایرکتوری منفرد حاوی میلیون‌ها فایل است.
.PP
پیش از نسخه v1.70، برنامه rclone مجبور بود تمام این موارد را به‌صورت اشیای rclone در حافظه بارگذاری کند.
هر شیء rclone بین ۰٫۵ تا ۱ کیلوبایت حافظه مصرف می‌کند.
یک راهکار جانبی برای این مسئله (<https://github.com/rclone/rclone/wiki/Big-syncs-with-millions-of-files>) وجود دارد که شامل کمی اسکریپت‌نویسی است.
.PP
با این حال، از نسخه v1.70 به بعد، rclone هنگام شناسایی دایرکتوری‌ای با بیش از ورودی‌های تعیین‌شده توسط \f[V]\-\-list\-cutoff\f[R] (<https://rclone.org/docs/#list-cutoff>) (به‌طور پیش‌فرض ۱٬۰۰۰٬۰۰۰)، به‌صورت خودکار ورودی‌های دایرکتوری را روی دیسک ذخیره می‌کند.
.PP
همچنین از نسخه v1.70 پرچم \-\-max\-buffer\-memory (<https://rclone.org/docs/#max-buffer-memory>) در rclone ارائه شده است که به‌ویژه در مواقعی که انتقال‌های چندنخی (multi-thread) حافظه زیادی مصرف می‌کنند، مفید است..SS rclone علائم نگارشی تمام‌عرض یونیکد را در نام فایل‌ها تغییر می‌دهد
.PP
برای مثال: در یک سیستم Windows، فایلی با نام
\f[V]Test：1.jpg\f[R] دارید که در آن \f[V]：\f[R] نماد دونقطه تمام‌عرض (fullwidth) یونیکد
است.
هنگامی که از rclone برای رونوشت آن به Google Drive خود استفاده می‌کنید، متوجه
خواهید شد که نام فایل به \f[V]Test:1.jpg\f[R] تغییر می‌یابد، که در آن \f[V]:\f[R]
دونقطه معمولی (نیم‌عرض یا halfwidth) است.
.PP
دلیل چنین تغییر نام‌هایی، نحوه مدیریت نام‌های فایل محدودشده
(https://rclone.org/overview/#restricted-filenames)
توسط rclone در سیستم‌های ذخیره‌سازی ابری مختلف است.
این ابزار تلاش می‌کند تا جای ممکن از نام‌های مبهم فایل‌ها جلوگیری کرده و امکان جابه‌جایی
شفاف فایل‌ها را میان سیستم‌های متعدد ذخیره‌سازی ابری فراهم آورد؛ این کار از طریق جایگزین کردن
نویسه‌های نامعتبر با نویسه‌های یونیکد دارای ظاهر مشابه هنگام انتقال به یک سیستم ذخیره‌سازی،
و بازگردانی مجدد آن‌ها هنگام انتقال به یک سیستم ذخیره‌سازی دیگر که از نویسه‌های اصلی
پشتیبانی می‌کند، انجام می‌شود.
هنگامی که از همان نویسه‌های یونیکد به‌صورت عمدی در نام فایل‌ها استفاده شده باشد،
این راهبرد جایگزینی منجر به تغییر نام‌های ناخواسته خواهد شد.
برای اطلاعات بیشتر، بخش هشدارها را در
(https://rclone.org/overview/#restricted-filenames-caveats) مطالعه کنید.
.SS چرا اتصال rclone از طریق TLS ناموفق است اما کلاینت دیگری کار می‌کند؟
.PP
اگر با خطاهای دست‌تکانی TLS (یا TLS handshake failures) مواجه می‌شوید (یا تحلیل بسته‌ها نشان
می‌دهد که سرور تمامی مجموعه‌رمزهای ارائه‌شده را رد می‌کند)، ممکن است سرور/پروکسی فقط از
مجموعه‌رمزهای قدیمی TLS پشتیبانی کند (برای نمونه رمزهای تبادل کلید RSA مانند
\f[V]RSA_WITH_AES_256_CBC_SHA256\f[R]، یا رمزهای قدیمی 3DES).
نسخه‌های اخیر Go (که rclone با آن کامپایل شده است) \f[B]رمزهای ناامن را از فهرست
پیش‌فرض حذف کرده‌اند\f[R]؛ بنابراین rclone ممکن است از مذاکره بر سر آن‌ها امتناع ورزد،
حتی اگر ابزارهای دیگر همچنان از آن‌ها استفاده کنند.
.PP
اگر نمی‌توانید سرور/پروکسی را برای پشتیبانی از TLS مدرن (TLS 1.2/1.3) و مجموعه‌رمزهای
مبتنی بر ECDHE به‌روزرسانی یا پیکربندی مجدد کنید، می‌توانید رمزهای قدیمی را از طریق
\f[V]GODEBUG\f[R] دوباره فعال کنید:
.IP \[bu] 2
در Windows (cmd.exe):
.RS 2
.IP
.nf
\f[C]
set GODEBUG=tlsrsakex=1
rclone copy ...
\f[R]
.fi
.RE
.IP \[bu] 2
در Windows (PowerShell):
.RS 2
.IP
.nf
\f[C]
$env:GODEBUG=\[dq]tlsrsakex=1\[dq]
rclone copy ...
\f[R]
.fi
.RE
.IP \[bu] 2
در Linux/macOS:
.RS 2
.IP
.nf
\f[C]
GODEBUG=tlsrsakex=1 rclone copy ...
\f[R]
.fi
.RE
.PP
اگر سرور تنها از 3DES پشتیبانی می‌کند، این مورد را امتحان کنید:
.IP
.nf
\f[C]
GODEBUG=tls3des=1 rclone ...
\f[R]
.fi
.PP
این موضوع برای \f[B]هر قابلیتی از rclone که از TLS استفاده می‌کند\f[R] صدق می‌کند
(مانند HTTPS، FTPS، WebDAV بر بستر TLS، پروکسی‌های با رهگیری TLS و غیره).
از این راهکارهای موقت تنها تا زمانی استفاده کنید که سرور/پروکسی به‌روزرسانی شود.
.SH "مجوز (LICENSE)"
.PP
این یک نرم‌افزار آزاد تحت شرایط مجوز MIT است (فایل COPYING ارائه‌شده همراه با کد منبع
را بررسی کنید).
.IP
.nf
\f[C]
Copyright (C) 2019 by Nick Craig-Wood https://www.craig-wood.com/nick

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the \[dq]Software\[dq]), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED \[dq]AS IS\[dq], WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
\f[R]
.fi.SH "نویسندگان و مشارکت‌کنندگان (AUTHORS AND CONTRIBUTORS)"
.SS "نویسندگان (Authors)"
.IP \[bu] 2
Nick Craig-Wood <nick@craig-wood.com>
.SS "مشارکت‌کنندگان (Contributors)"
.IP \[bu] 2
Alex Couper <amcouper@gmail.com>
.IP \[bu] 2
Leonid Shalupov <leonid@shalupov.com> <shalupov@diverse.org.ru>
.IP \[bu] 2
Shimon Doodkin <helpmepro1@gmail.com>
.IP \[bu] 2
Colin Nicholson <colin@colinn.com>
.IP \[bu] 2
Klaus Post <klauspost@gmail.com>
.IP \[bu] 2
Sergey Tolmachev <tolsi.ru@gmail.com>
.IP \[bu] 2
Adriano Aurélio Meirelles <adriano@atinge.com>
.IP \[bu] 2
C.
Bess <cbess@users.noreply.github.com>
.IP \[bu] 2
Dmitry Burdeev <dibu28@gmail.com>
.IP \[bu] 2
Joseph Spurrier <github@josephspurrier.com>
.IP \[bu] 2
Björn Harrtell <bjorn@wololo.org>
.IP \[bu] 2
Xavier Lucas <xavier.lucas@corp.ovh.com>
.IP \[bu] 2
Werner Beroux <werner@beroux.com>
.IP \[bu] 2
Brian Stengaard <brian@stengaard.eu>
.IP \[bu] 2
Jakub Gedeon <jgedeon@sofi.com>
.IP \[bu] 2
Jim Tittsler <jwt@onjapan.net>
.IP \[bu] 2
Michal Witkowski <michal@improbable.io>
.IP \[bu] 2
Fabian Ruff <fabian.ruff@sap.com>
.IP \[bu] 2
Leigh Klotz <klotz@quixey.com>
.IP \[bu] 2
Romain Lapray <lapray.romain@gmail.com>
.IP \[bu] 2
Justin R.
Wilson <jrw972@gmail.com>
.IP \[bu] 2
Antonio Messina <antonio.s.messina@gmail.com>
.IP \[bu] 2
Stefan G.
Weichinger <office@oops.co.at>
.IP \[bu] 2
Per Cederberg <cederberg@gmail.com>
.IP \[bu] 2
Radek Šenfeld <rush@logic.cz>
.IP \[bu] 2
Fredrik Fornwall <fredrik@fornwall.net>
.IP \[bu] 2
Asko Tamm <asko@deekit.net>
.IP \[bu] 2
xor-zz <xor@gstocco.com>
.IP \[bu] 2
Tomasz Mazur <tmazur90@gmail.com>
.IP \[bu] 2
Marco Paganini <paganini@paganini.net>
.IP \[bu] 2
Felix Bünemann <buenemann@louis.info>
.IP \[bu] 2
Durval Menezes <jmrclone@durval.com>
.IP \[bu] 2
Luiz Carlos Rumbelsperger Viana <maxd13_luiz_carlos@hotmail.com>
.IP \[bu] 2
Stefan Breunig <stefan-github@yrden.de>
.IP \[bu] 2
Alishan Ladhani <ali-l@users.noreply.github.com>
.IP \[bu] 2
0xJAKE <0xJAKE@users.noreply.github.com>
.IP \[bu] 2
Thibault Molleman <thibaultmol@users.noreply.github.com>
.IP \[bu] 2
Scott McGillivray <scott.mcgillivray@gmail.com>
.IP \[bu] 2
Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com>
.IP \[bu] 2
Lukas Loesche <lukas@mesosphere.io>
.IP \[bu] 2
emyarod <emyarod@users.noreply.github.com>
.IP \[bu] 2
T.C.
Ferguson <tcf909@gmail.com>
.IP \[bu] 2
Brandur <brandur@mutelight.org>
.IP \[bu] 2
Dario Giovannetti <dev@dariogiovannetti.net>
.IP \[bu] 2
Károly Oláh <okaresz@aol.com>
.IP \[bu] 2
Jon Yergatian <jon@macfanatic.ca>
.IP \[bu] 2
Jack Schmidt <github@mowsey.org>
.IP \[bu] 2
Dedsec1 <Dedsec1@users.noreply.github.com>
.IP \[bu] 2
Hisham Zarka <hzarka@gmail.com>
.IP \[bu] 2
Jérôme Vizcaino <jerome.vizcaino@gmail.com>
.IP \[bu] 2
Mike Tesch <mjt6129@rit.edu>
.IP \[bu] 2
Marvin Watson <marvwatson@users.noreply.github.com>
.IP \[bu] 2
Danny Tsai <danny8376@gmail.com>
.IP \[bu] 2
Yoni Jah <yonjah+git@gmail.com> <yonjah+github@gmail.com>
.IP \[bu] 2
Stephen Harris <github@spuddy.org> <sweharris@users.noreply.github.com>
.IP \[bu] 2
Ihor Dvoretskyi <ihor.dvoretskyi@gmail.com>
.IP \[bu] 2
Jon Craton <jncraton@gmail.com>
.IP \[bu] 2
Hraban Luyat <hraban@0brg.net>
.IP \[bu] 2
Michael Ledin <mledin89@gmail.com>
.IP \[bu] 2
Martin Kristensen <me@azgul.com>
.IP \[bu] 2
Too Much IO <toomuchio@users.noreply.github.com>
.IP \[bu] 2
Anisse Astier <anisse@astier.eu>
.IP \[bu] 2
Zahiar Ahmed <zahiar@live.com>
.IP \[bu] 2
Igor Kharin <igorkharin@gmail.com>
.IP \[bu] 2
Bill Zissimopoulos <billziss@navimatics.com>
.IP \[bu] 2
Bob Potter <bobby.potter@gmail.com>
.IP \[bu] 2
Steven Lu <tacticalazn@gmail.com>
.IP \[bu] 2
Sjur Fredriksen <sjurtf@ifi.uio.no>
.IP \[bu] 2
Ruwbin <hubus12345@gmail.com>
.IP \[bu] 2
Fabian Möller <fabianm88@gmail.com> <f.moeller@nynex.de>
.IP \[bu] 2
Edward Q.
Bridges <github@eqbridges.com>
.IP \[bu] 2
Vasiliy Tolstov <v.tolstov@selfip.ru>
.IP \[bu] 2
Harshavardhana <harsha@minio.io>
.IP \[bu] 2
sainaen <sainaen@gmail.com>
.IP \[bu] 2
gdm85 <gdm85@users.noreply.github.com>
.IP \[bu] 2
Yaroslav Halchenko <debian@onerussian.com>
.IP \[bu] 2
John Papandriopoulos <jpap@users.noreply.github.com>
.IP \[bu] 2
Zhiming Wang <zmwangx@gmail.com>
.IP \[bu] 2
Andy Pilate <cubox@cubox.me>
.IP \[bu] 2
Oliver Heyme <olihey@googlemail.com> <olihey@users.noreply.github.com>
<de8olihe@lego.com>
.IP \[bu] 2
wuyu <wuyu@yunify.com>
.IP \[bu] 2
Andrei Dragomir <adragomi@adobe.com>
.IP \[bu] 2
Christian Brüggemann <mail@cbruegg.com>
.IP \[bu] 2
Alex McGrath Kraak <amkdude@gmail.com>
.IP \[bu] 2
bpicode <bjoern.pirnay@googlemail.com>.IP \[bu] 2
Daniel Jagszent <daniel@jagszent.de>
.IP \[bu] 2
Josiah White <thegenius2009@gmail.com>
.IP \[bu] 2
Ishuah Kariuki <kariuki@ishuah.com> <ishuah91@gmail.com>
.IP \[bu] 2
Jan Varho <jan@varho.org>
.IP \[bu] 2
Girish Ramakrishnan <girish@cloudron.io>
.IP \[bu] 2
LingMan <LingMan@users.noreply.github.com>
.IP \[bu] 2
Jacob McNamee <jacobmcnamee@gmail.com>
.IP \[bu] 2
jersou <jertux@gmail.com>
.IP \[bu] 2
thierry <thierry@substantiel.fr>
.IP \[bu] 2
Simon Leinen <simon.leinen@gmail.com> <ubuntu@s3-test.novalocal>
.IP \[bu] 2
Dan Dascalescu <ddascalescu+github@gmail.com>
.IP \[bu] 2
Jason Rose <jason@jro.io>
.IP \[bu] 2
Andrew Starr-Bochicchio <a.starr.b@gmail.com>
.IP \[bu] 2
John Leach <john@johnleach.co.uk>
.IP \[bu] 2
Corban Raun <craun@instructure.com>
.IP \[bu] 2
Pierre Carlson <mpcarl@us.ibm.com>
.IP \[bu] 2
Ernest Borowski <er.borowski@gmail.com>
.IP \[bu] 2
Remus Bunduc <remus.bunduc@gmail.com>
.IP \[bu] 2
Iakov Davydov <iakov.davydov@unil.ch> <dav05.gith@myths.ru>
.IP \[bu] 2
Jakub Tasiemski <tasiemski@gmail.com>
.IP \[bu] 2
David Minor <dminor@saymedia.com>
.IP \[bu] 2
Tim Cooijmans <cooijmans.tim@gmail.com>
.IP \[bu] 2
Laurence <liuxy6@gmail.com>
.IP \[bu] 2
Giovanni Pizzi <gio.piz@gmail.com>
.IP \[bu] 2
Filip Bartodziej <filipbartodziej@gmail.com>
.IP \[bu] 2
Jon Fautley <jon@dead.li>
.IP \[bu] 2
lewapm <32110057+lewapm@users.noreply.github.com>
.IP \[bu] 2
Yassine Imounachen <yassine256@gmail.com>
.IP \[bu] 2
Chris Redekop <chris-redekop@users.noreply.github.com>
<chris.redekop@gmail.com>
.IP \[bu] 2
Jon Fautley <jon@adenoid.appstal.co.uk>
.IP \[bu] 2
Will Gunn <WillGunn@users.noreply.github.com>
.IP \[bu] 2
Lucas Bremgartner <lucas@bremis.ch>
.IP \[bu] 2
Jody Frankowski <jody.frankowski@gmail.com>
.IP \[bu] 2
Andreas Roussos <arouss1980@gmail.com>
.IP \[bu] 2
nbuchanan <nbuchanan@utah.gov>
.IP \[bu] 2
Durval Menezes <rclone@durval.com>
.IP \[bu] 2
Victor <vb-github@viblo.se>
.IP \[bu] 2
Mateusz <pabian.mateusz@gmail.com>
.IP \[bu] 2
Daniel Loader <spicypixel@gmail.com>
.IP \[bu] 2
David0rk <davidork@gmail.com>
.IP \[bu] 2
Alexander Neumann <alexander@bumpern.de>
.IP \[bu] 2
Giri Badanahatti <gbadanahatti@us.ibm.com@Giris-MacBook-Pro.local>
.IP \[bu] 2
Leo R.
Lundgren <leo@finalresort.org>
.IP \[bu] 2
wolfv <wolfv6@users.noreply.github.com>
.IP \[bu] 2
Dave Pedu <dave@davepedu.com>
.IP \[bu] 2
Stefan Lindblom <lindblom@spotify.com>
.IP \[bu] 2
seuffert <oliver@seuffert.biz>
.IP \[bu] 2
gbadanahatti <37121690+gbadanahatti@users.noreply.github.com>
.IP \[bu] 2
Keith Goldfarb <barkofdelight@gmail.com>
.IP \[bu] 2
Steve Kriss <steve@heptio.com>
.IP \[bu] 2
Chih-Hsuan Yen <yan12125@gmail.com>
.IP \[bu] 2
Alexander Neumann <fd0@users.noreply.github.com>
.IP \[bu] 2
Matt Holt <mholt@users.noreply.github.com>
.IP \[bu] 2
Eri Bastos <bastos.eri@gmail.com>
.IP \[bu] 2
Michael P.
Dubner <pywebmail@list.ru>
.IP \[bu] 2
Antoine GIRARD <sapk@users.noreply.github.com>
.IP \[bu] 2
Mateusz Piotrowski <mpp302@gmail.com>
.IP \[bu] 2
Animosity022 <animosity22@users.noreply.github.com>
<earl.texter@gmail.com>
.IP \[bu] 2
Peter Baumgartner <pete@lincolnloop.com>
.IP \[bu] 2
Craig Rachel <craig@craigrachel.com>
.IP \[bu] 2
Michael G.
Noll <miguno@users.noreply.github.com>
.IP \[bu] 2
hensur <me@hensur.de>
.IP \[bu] 2
Oliver Heyme <de8olihe@lego.com>
.IP \[bu] 2
Richard Yang <richard@yenforyang.com>
.IP \[bu] 2
Piotr Oleszczyk <piotr.oleszczyk@gmail.com>
.IP \[bu] 2
Rodrigo <rodarima@gmail.com>
.IP \[bu] 2
NoLooseEnds <NoLooseEnds@users.noreply.github.com>
.IP \[bu] 2
Jakub Karlicek <jakub@karlicek.me>
.IP \[bu] 2
John Clayton <john@codemonkeylabs.com>
.IP \[bu] 2
Kasper Byrdal Nielsen <byrdal76@gmail.com>
.IP \[bu] 2
Benjamin Joseph Dag <bjdag1234@users.noreply.github.com>
.IP \[bu] 2
themylogin <themylogin@gmail.com>
.IP \[bu] 2
Onno Zweers <onno.zweers@surfsara.nl>
.IP \[bu] 2
Jasper Lievisse Adriaanse <jasper@humppa.nl>
.IP \[bu] 2
sandeepkru <sandeep.ummadi@gmail.com>
<sandeepkru@users.noreply.github.com>
.IP \[bu] 2
HerrH <atomtigerzoo@users.noreply.github.com>
.IP \[bu] 2
Andrew <4030760+sparkyman215@users.noreply.github.com>
.IP \[bu] 2
dan smith <XX1011@gmail.com>
.IP \[bu] 2
Oleg Kovalov <iamolegkovalov@gmail.com>
.IP \[bu] 2
Ruben Vandamme <github-com-00ff86@vandamme.email>
.IP \[bu] 2
Cnly <minecnly@gmail.com>
.IP \[bu] 2
Andres Alvarez <1671935+kir4h@users.noreply.github.com>
.IP \[bu] 2
reddi1 <xreddi@gmail.com>
.IP \[bu] 2
Matt Tucker <matthewtckr@gmail.com>
.IP \[bu] 2
Sebastian Bünger <buengese@gmail.com> <buengese@protonmail.com>
.IP \[bu] 2
Martin Polden <mpolden@mpolden.no>
.IP \[bu] 2
Alex Chen <Cnly@users.noreply.github.com>.IP \[bu] 2
Denis <deniskovpen@gmail.com>
.IP \[bu] 2
bsteiss <35940619+bsteiss@users.noreply.github.com>
.IP \[bu] 2
Cédric Connes <cedric.connes@gmail.com>
.IP \[bu] 2
Dr.
Tobias Quathamer <toddy15@users.noreply.github.com>
.IP \[bu] 2
dcpu <42736967+dcpu@users.noreply.github.com>
.IP \[bu] 2
Sheldon Rupp <me@shel.io>
.IP \[bu] 2
albertony <12441419+albertony@users.noreply.github.com>
.IP \[bu] 2
cron410 <cron410@gmail.com>
.IP \[bu] 2
Anagh Kumar Baranwal <6824881+darthShadow@users.noreply.github.com>
.IP \[bu] 2
Felix Brucker <felix@felixbrucker.com>
.IP \[bu] 2
Santiago Rodríguez <scollazo@users.noreply.github.com>
.IP \[bu] 2
Craig Miskell <craig.miskell@fluxfederation.com>
.IP \[bu] 2
Antoine GIRARD <sapk@sapk.fr>
.IP \[bu] 2
Joanna Marek <joanna.marek@u2i.com>
.IP \[bu] 2
frenos <frenos@users.noreply.github.com>
.IP \[bu] 2
ssaqua <ssaqua@users.noreply.github.com>
.IP \[bu] 2
xnaas <me@xnaas.info>
.IP \[bu] 2
Frantisek Fuka <fuka@fuxoft.cz>
.IP \[bu] 2
Paul Kohout <pauljkohout@yahoo.com>
.IP \[bu] 2
dcpu <43330287+dcpu@users.noreply.github.com>
.IP \[bu] 2
jackyzy823 <jackyzy823@gmail.com>
.IP \[bu] 2
David Haguenauer <ml@kurokatta.org>
.IP \[bu] 2
teresy <hi.teresy@gmail.com>
.IP \[bu] 2
buergi <patbuergi@gmx.de>
.IP \[bu] 2
Florian Gamboeck <mail@floga.de>
.IP \[bu] 2
Ralf Hemberger <10364191+rhemberger@users.noreply.github.com>
.IP \[bu] 2
Scott Edlund <sedlund@users.noreply.github.com>
.IP \[bu] 2
Erik Swanson <erik@retailnext.net>
.IP \[bu] 2
Jake Coggiano <jake@stripe.com>
.IP \[bu] 2
brused27 <brused27@noemailaddress>
.IP \[bu] 2
Peter Kaminski <kaminski@istori.com>
.IP \[bu] 2
Henry Ptasinski <henry@logout.com>
.IP \[bu] 2
Alexander <kharkovalexander@gmail.com>
.IP \[bu] 2
Garry McNulty <garrmcnu@gmail.com>
.IP \[bu] 2
Mathieu Carbou <mathieu.carbou@gmail.com>
.IP \[bu] 2
Mark Otway <mark@otway.com>
.IP \[bu] 2
William Cocker <37018962+WilliamCocker@users.noreply.github.com>
.IP \[bu] 2
François Leurent <131.js@cloudyks.org>
.IP \[bu] 2
Arkadius Stefanski <arkste@gmail.com>
.IP \[bu] 2
Jay <dev@jaygoel.com>
.IP \[bu] 2
andrea rota <a@xelera.eu>
.IP \[bu] 2
nicolov <nicolov@users.noreply.github.com>
.IP \[bu] 2
Matt Joiner <anacrolix@gmail.com>
.IP \[bu] 2
Dario Guzik <dario@guzik.com.ar>
.IP \[bu] 2
qip <qip@users.noreply.github.com>
.IP \[bu] 2
yair\[at]unicorn <yair@unicorn>
.IP \[bu] 2
Matt Robinson <brimstone@the.narro.ws>
.IP \[bu] 2
kayrus <kay.diam@gmail.com>
.IP \[bu] 2
Rémy Léone <remy.leone@gmail.com>
.IP \[bu] 2
Wojciech Smigielski <wojciech.hieronim.smigielski@gmail.com>
.IP \[bu] 2
weetmuts <oehrstroem@gmail.com>
.IP \[bu] 2
Jonathan <vanillajonathan@users.noreply.github.com>
.IP \[bu] 2
James Carpenter <orbsmiv@users.noreply.github.com>
.IP \[bu] 2
Vince <vince0villamora@gmail.com>
.IP \[bu] 2
Nestar47 <47841759+Nestar47@users.noreply.github.com>
.IP \[bu] 2
Six <brbsix@gmail.com>
.IP \[bu] 2
Alexandru Bumbacea <alexandru.bumbacea@booking.com>
.IP \[bu] 2
calisro <robert.calistri@gmail.com>
.IP \[bu] 2
Dr.Rx <david.rey@nventive.com>
.IP \[bu] 2
marcintustin <marcintustin@users.noreply.github.com>
.IP \[bu] 2
jaKa Močnik <jaka@koofr.net>
.IP \[bu] 2
Fionera <fionera@fionera.de>
.IP \[bu] 2
Dan Walters <dan@walters.io>
.IP \[bu] 2
Danil Semelenov <sgtpep@users.noreply.github.com>
.IP \[bu] 2
xopez <28950736+xopez@users.noreply.github.com>
.IP \[bu] 2
Ben Boeckel <mathstuf@gmail.com>
.IP \[bu] 2
Manu <manu@snapdragon.cc>
.IP \[bu] 2
Kyle E.
Mitchell <kyle@kemitchell.com>
.IP \[bu] 2
Gary Kim <gary@garykim.dev>
.IP \[bu] 2
Jon <jonathn@github.com>
.IP \[bu] 2
Jeff Quinn <jeffrey.quinn@bluevoyant.com>
.IP \[bu] 2
Peter Berbec <peter@berbec.com>
.IP \[bu] 2
didil <1284255+didil@users.noreply.github.com>
.IP \[bu] 2
id01 <gaviniboom@gmail.com>
.IP \[bu] 2
Robert Marko <robimarko@gmail.com>
.IP \[bu] 2
Philip Harvey <32467456+pharveybattelle@users.noreply.github.com>
.IP \[bu] 2
JorisE <JorisE@users.noreply.github.com>
.IP \[bu] 2
garry415 <garry.415@gmail.com>
.IP \[bu] 2
forgems <forgems@gmail.com>
.IP \[bu] 2
Florian Apolloner <florian@apolloner.eu>
.IP \[bu] 2
Aleksandar Janković <office@ajankovic.com>
<ajankovic@users.noreply.github.com>
.IP \[bu] 2
Maran <maran@protonmail.com>
.IP \[bu] 2
nguyenhuuluan434 <nguyenhuuluan434@gmail.com>
.IP \[bu] 2
Laura Hausmann <zotan@zotan.pw> <laura@hausmann.dev>
.IP \[bu] 2
yparitcher <y@paritcher.com>
.IP \[bu] 2
AbelThar <abela.tharen@gmail.com>
.IP \[bu] 2
Matti Niemenmaa <matti.niemenmaa+git@iki.fi>
.IP \[bu] 2
Russell Davis <russelldavis@users.noreply.github.com>
.IP \[bu] 2
Yi FU <yi.fu@tink.se>.IP \[bu] 2
Paul Millar <paul.millar@desy.de>
.IP \[bu] 2
justinalin <justinalin@qnap.com>
.IP \[bu] 2
EliEron <subanimehd@gmail.com>
.IP \[bu] 2
justina777 <chiahuei.lin@gmail.com>
.IP \[bu] 2
Chaitanya Bankanhal <bchaitanya15@gmail.com>
.IP \[bu] 2
Michał Matczuk <michal@scylladb.com>
.IP \[bu] 2
Macavirus <macavirus@zoho.com>
.IP \[bu] 2
Abhinav Sharma <abhi18av@outlook.com>
.IP \[bu] 2
ginvine <34869051+ginvine@users.noreply.github.com>
.IP \[bu] 2
Patrick Wang <mail6543210@yahoo.com.tw>
.IP \[bu] 2
Cenk Alti <cenkalti@gmail.com>
.IP \[bu] 2
Andreas Chlupka <andy@chlupka.com>
.IP \[bu] 2
Alfonso Montero <amontero@tinet.org>
.IP \[bu] 2
Ivan Andreev <ivandeex@gmail.com>
.IP \[bu] 2
David Baumgold <david@davidbaumgold.com>
.IP \[bu] 2
Lars Lehtonen <lars.lehtonen@gmail.com>
.IP \[bu] 2
Matei David <matei.david@gmail.com>
.IP \[bu] 2
David <david.bramwell@endemolshine.com>
.IP \[bu] 2
Anthony Rusdi <33247310+antrusd@users.noreply.github.com>
.IP \[bu] 2
Richard Patel <me@terorie.dev>
.IP \[bu] 2
庄天翼 <zty0826@gmail.com>
.IP \[bu] 2
SwitchJS <dev@switchjs.com>
.IP \[bu] 2
Raphael <PowershellNinja@users.noreply.github.com>
.IP \[bu] 2
Sezal Agrawal <sezalagrawal@gmail.com>
.IP \[bu] 2
Tyler <TylerNakamura@users.noreply.github.com>
.IP \[bu] 2
Brett Dutro <brett.dutro@gmail.com>
.IP \[bu] 2
Vighnesh SK <booterror99@gmail.com>
.IP \[bu] 2
Arijit Biswas <dibbyo456@gmail.com>
.IP \[bu] 2
Michele Caci <michele.caci@gmail.com>
.IP \[bu] 2
AlexandrBoltris <ua2fgb@gmail.com>
.IP \[bu] 2
Bryce Larson <blarson@saltstack.com>
.IP \[bu] 2
Carlos Ferreyra <crypticmind@gmail.com>
.IP \[bu] 2
Saksham Khanna <sakshamkhanna@outlook.com>
.IP \[bu] 2
dausruddin <5763466+dausruddin@users.noreply.github.com>
.IP \[bu] 2
zero-24 <zero-24@users.noreply.github.com>
.IP \[bu] 2
Xiaoxing Ye <ye@xiaoxing.us>
.IP \[bu] 2
Barry Muldrey <barry@muldrey.net>
.IP \[bu] 2
Sebastian Brandt <sebastian.brandt@friday.de>
.IP \[bu] 2
Marco Molteni <marco.molteni@mailbox.org>
.IP \[bu] 2
Ankur Gupta <7876747+ankur0493@users.noreply.github.com>
.IP \[bu] 2
Maciej Zimnoch <maciej@scylladb.com>
.IP \[bu] 2
anuar45 <serdaliyev.anuar@gmail.com>
.IP \[bu] 2
Fernando <ferferga@users.noreply.github.com>
.IP \[bu] 2
David Cole <david.cole@sohonet.com>
.IP \[bu] 2
Wei He <git@weispot.com>
.IP \[bu] 2
Outvi V <19144373+outloudvi@users.noreply.github.com>
.IP \[bu] 2
Thomas Kriechbaumer <thomas@kriechbaumer.name>
.IP \[bu] 2
Tennix <tennix@users.noreply.github.com>
.IP \[bu] 2
Ole Schütt <ole@schuett.name>
.IP \[bu] 2
Kuang-che Wu <kcwu@csie.org>
.IP \[bu] 2
Thomas Eales <wingsuit@users.noreply.github.com>
.IP \[bu] 2
Paul Tinsley <paul.tinsley@vitalsource.com>
.IP \[bu] 2
Felix Hungenberg <git@shiftgeist.com>
.IP \[bu] 2
Benjamin Richter <github@dev.telepath.de>
.IP \[bu] 2
landall <cst_zf@qq.com>
.IP \[bu] 2
thestigma <thestigma@gmail.com>
.IP \[bu] 2
jtagcat <38327267+jtagcat@users.noreply.github.com>
.IP \[bu] 2
Damon Permezel <permezel@me.com>
.IP \[bu] 2
boosh <boosh@users.noreply.github.com>
.IP \[bu] 2
unbelauscht <58393353+unbelauscht@users.noreply.github.com>
.IP \[bu] 2
Motonori IWAMURO <vmi@nifty.com>
.IP \[bu] 2
Benjapol Worakan <benwrk@live.com>
.IP \[bu] 2
Dave Koston <dave.koston@stackpath.com>
.IP \[bu] 2
Durval Menezes <DurvalMenezes@users.noreply.github.com>
.IP \[bu] 2
Tim Gallant <me@timgallant.us>
.IP \[bu] 2
Frederick Zhang <frederick888@tsundere.moe>
.IP \[bu] 2
valery1707 <valery1707@gmail.com>
.IP \[bu] 2
Yves G <theYinYeti@yalis.fr>
.IP \[bu] 2
Shing Kit Chan <chanshingkit@gmail.com>
.IP \[bu] 2
Franklyn Tackitt <franklyn@tackitt.net>
.IP \[bu] 2
Robert-André Mauchin <zebob.m@gmail.com>
.IP \[bu] 2
evileye <48332831+ibiruai@users.noreply.github.com>
.IP \[bu] 2
Joachim Brandon LeBlanc <brandon@leblanc.codes>
.IP \[bu] 2
Patryk Jakuszew <patryk.jakuszew@gmail.com>
.IP \[bu] 2
fishbullet <shindu666@gmail.com>
.IP \[bu] 2
greatroar <\[at]>
.IP \[bu] 2
Bernd Schoolmann <mail@quexten.com>
.IP \[bu] 2
Elan Ruusamäe <glen@pld-linux.org>
.IP \[bu] 2
Max Sum <max@lolyculture.com>
.IP \[bu] 2
Mark Spieth <mspieth@users.noreply.github.com>
.IP \[bu] 2
harry <me@harry.plus>
.IP \[bu] 2
Samantha McVey <samantham@posteo.net>
.IP \[bu] 2
Jack Anderson <jack.anderson@metaswitch.com>
.IP \[bu] 2
Michael G <draget@speciesm.net>
.IP \[bu] 2
Brandon Philips <brandon@ifup.org>
.IP \[bu] 2
Daven <dooven@users.noreply.github.com>
.IP \[bu] 2
Martin Stone <martin@d7415.co.uk>
.IP \[bu] 2
David Bramwell <13053834+dbramwell@users.noreply.github.com>
.IP \[bu] 2
Sunil Patra <snl_su@live.com>
.IP \[bu] 2
Adam Stroud <adam.stroud@gmail.com>.IP \[bu] 2
Kush <kushsharma@users.noreply.github.com>
.IP \[bu] 2
Matan Rosenberg <matan129@gmail.com>
.IP \[bu] 2
gitch1 <63495046+gitch1@users.noreply.github.com>
.IP \[bu] 2
ElonH <elonhhuang@gmail.com>
.IP \[bu] 2
Fred <fred@creativeprojects.tech>
.IP \[bu] 2
Sébastien Gross <renard@users.noreply.github.com>
.IP \[bu] 2
Maxime Suret <11944422+msuret@users.noreply.github.com>
.IP \[bu] 2
Caleb Case <caleb@storj.io> <calebcase@gmail.com>
.IP \[bu] 2
Ben Zenker <imbenzenker@gmail.com>
.IP \[bu] 2
Martin Michlmayr <tbm@cyrius.com>
.IP \[bu] 2
Brandon McNama <bmcnama@pagerduty.com>
.IP \[bu] 2
Daniel Slyman <github@skylayer.eu>
.IP \[bu] 2
Alex Guerrero <guerrero@users.noreply.github.com>
.IP \[bu] 2
Matteo Pietro Dazzi <matteopietro.dazzi@gft.com>
.IP \[bu] 2
edwardxml <56691903+edwardxml@users.noreply.github.com>
.IP \[bu] 2
Roman Kredentser <shareed2k@gmail.com>
.IP \[bu] 2
Kamil Trzciński <ayufan@ayufan.eu>
.IP \[bu] 2
Zac Rubin <z-0@users.noreply.github.com>
.IP \[bu] 2
Vincent Feltz
.IP \[bu] 2
Heiko Bornholdt <bornholdt@informatik.uni-hamburg.de>
.IP \[bu] 2
Matteo Pietro Dazzi <matteopietro.dazzi@gmail.com>
.IP \[bu] 2
jtagcat <gitlab@c7.ee>
.IP \[bu] 2
Petri Salminen <petri@salminen.dev>
.IP \[bu] 2
Tim Burke <tim.burke@gmail.com>
.IP \[bu] 2
Kai Lüke <kai@kinvolk.io>
.IP \[bu] 2
Garrett Squire <github@garrettsquire.com>
.IP \[bu] 2
Evan Harris <eharris@puremagic.com>
.IP \[bu] 2
Kevin <keyam@microsoft.com>
.IP \[bu] 2
Morten Linderud <morten@linderud.pw>
.IP \[bu] 2
Dmitry Ustalov <dmitry.ustalov@gmail.com>
.IP \[bu] 2
Jack <196648+jdeng@users.noreply.github.com>
.IP \[bu] 2
kcris <cristian.tarsoaga@gmail.com>
.IP \[bu] 2
tyhuber1 <68970760+tyhuber1@users.noreply.github.com>
.IP \[bu] 2
David Ibarra <david.ibarra@realty.com>
.IP \[bu] 2
Tim Gallant <tim@lilt.com>
.IP \[bu] 2
Kaloyan Raev <kaloyan@storj.io>
.IP \[bu] 2
Jay McEntire <jay.mcentire@gmail.com>
.IP \[bu] 2
Leo Luan <leoluan@us.ibm.com>
.IP \[bu] 2
aus <549081+aus@users.noreply.github.com>
.IP \[bu] 2
Aaron Gokaslan <agokaslan@fb.com>
.IP \[bu] 2
Egor Margineanu <egmar@users.noreply.github.com>
.IP \[bu] 2
Lucas Kanashiro <lucas.kanashiro@canonical.com>
.IP \[bu] 2
WarpedPixel <WarpedPixel@users.noreply.github.com>
.IP \[bu] 2
Sam Edwards <sam@samedwards.ca>
.IP \[bu] 2
wjielai <gouki0123@gmail.com>
.IP \[bu] 2
Muffin King <jinxz_k@live.com>
.IP \[bu] 2
Christopher Stewart <6573710+1f47a@users.noreply.github.com>
.IP \[bu] 2
Russell Cattelan <cattelan@digitalelves.com>
.IP \[bu] 2
gyutw <30371241+gyutw@users.noreply.github.com>
.IP \[bu] 2
Hekmon <edouardhur@gmail.com>
.IP \[bu] 2
LaSombra <lasombra@users.noreply.github.com>
.IP \[bu] 2
Dov Murik <dov.murik@gmail.com>
.IP \[bu] 2
Ameer Dawood <ameer1234567890@gmail.com>
.IP \[bu] 2
Dan Hipschman <dan.hipschman@opendoor.com>
.IP \[bu] 2
Josh Soref <jsoref@users.noreply.github.com>
<2119212+jsoref@users.noreply.github.com>
.IP \[bu] 2
David <david@staron.nl>
.IP \[bu] 2
Ingo <ingo@hoffmann.cx>
.IP \[bu] 2
Adam Plánský <adamplansky@users.noreply.github.com>
<adamplansky@gmail.com>
.IP \[bu] 2
Manish Gupta <manishgupta.ait@gmail.com>
.IP \[bu] 2
Deepak Sah <sah.sslpu@gmail.com>
.IP \[bu] 2
Marcin Zelent <marcin@zelent.net>
.IP \[bu] 2
zhucan <zhucan.k8s@gmail.com>
.IP \[bu] 2
James Lim <james.lim@samsara.com>
.IP \[bu] 2
Laurens Janssen <BD69BM@insim.biz>
.IP \[bu] 2
Bob Bagwill <bobbagwill@gmail.com>
.IP \[bu] 2
Nathan Collins <colli372@msu.edu>
.IP \[bu] 2
lostheli
.IP \[bu] 2
kelv <kelvin@acks.org>
.IP \[bu] 2
Milly <milly.ca@gmail.com>
.IP \[bu] 2
gtorelly <gtorelly@gmail.com>
.IP \[bu] 2
Brad Ackerman <brad@facefault.org>
.IP \[bu] 2
Mitsuo Heijo <mitsuo.heijo@gmail.com>
.IP \[bu] 2
Claudio Bantaloukas <rockdreamer@gmail.com>
.IP \[bu] 2
Benjamin Gustin <gustin.ben@gmail.com>
.IP \[bu] 2
Ingo Weiss <ingo@redhat.com>
.IP \[bu] 2
Kerry Su <me@sshockwave.net>
.IP \[bu] 2
Ilyess Bachiri <ilyess.bachiri@sonder.com>
.IP \[bu] 2
Yury Stankevich <urykhy@gmail.com>
.IP \[bu] 2
kice <wslikerqs@gmail.com>
.IP \[bu] 2
Denis Neuling <denisneuling@gmail.com>
.IP \[bu] 2
Janne Johansson <icepic.dz@gmail.com>
.IP \[bu] 2
Patrik Nordlén <patriki@gmail.com>
.IP \[bu] 2
CokeMine <aptx4561@gmail.com>
.IP \[bu] 2
Sơn Trần-Nguyễn <github@sntran.com>
.IP \[bu] 2
lluuaapp <266615+lluuaapp@users.noreply.github.com>
.IP \[bu] 2
Zach Kipp <kipp.zach@gmail.com>
.IP \[bu] 2
Riccardo Iaconelli <riccardo@kde.org>
.IP \[bu] 2
Sakuragawa Misty <gyc990326@gmail.com>
.IP \[bu] 2
Nicolas Rueff <nicolas@rueff.fr>.IP \[bu] 2
Pau Rodriguez-Estivill <prodrigestivill@gmail.com>
.IP \[bu] 2
Bob Pusateri <BobPusateri@users.noreply.github.com>
.IP \[bu] 2
Alex JOST <25005220+dimejo@users.noreply.github.com>
.IP \[bu] 2
Alexey Tabakman <samosad.ru@gmail.com>
.IP \[bu] 2
David Sze <sze.david@gmail.com>
.IP \[bu] 2
cynthia kwok <cynthia.m.kwok@gmail.com>
.IP \[bu] 2
Miron Veryanskiy <MironVeryanskiy@gmail.com>
.IP \[bu] 2
K265 <k.265@qq.com>
.IP \[bu] 2
Vesnyx <Vesnyx@users.noreply.github.com>
.IP \[bu] 2
Dmitry Chepurovskiy <me@dm3ch.net>
.IP \[bu] 2
Rauno Ots <rauno.ots@cgi.com>
.IP \[bu] 2
Georg Neugschwandtner <georg.neugschwandtner@gmx.net>
.IP \[bu] 2
pvalls <polvallsrue@gmail.com>
.IP \[bu] 2
Robert Thomas <31854736+wolveix@users.noreply.github.com>
.IP \[bu] 2
Romeo Kienzler <romeo.kienzler@gmail.com>
.IP \[bu] 2
tYYGH <tYYGH@users.noreply.github.com>
.IP \[bu] 2
georne <77802995+georne@users.noreply.github.com>
.IP \[bu] 2
Maxwell Calman <mcalman@MacBook-Pro.local>
.IP \[bu] 2
Naveen Honest Raj <naveendurai19@gmail.com>
.IP \[bu] 2
Lucas Messenger <lmesseng@cisco.com>
.IP \[bu] 2
Manish Kumar <krmanish260@gmail.com>
.IP \[bu] 2
x0b <x0bdev@gmail.com>
.IP \[bu] 2
CERN از طریق پروژه CS3MESH4EOSC
.IP \[bu] 2
Nick Gaya <nicholasgaya+github@gmail.com>
.IP \[bu] 2
Ashok Gelal <401055+ashokgelal@users.noreply.github.com>
.IP \[bu] 2
Dominik Mydlil <dominik.mydlil@outlook.com>
.IP \[bu] 2
Nazar Mishturak <nazarmx@gmail.com>
.IP \[bu] 2
Ansh Mittal <iamAnshMittal@gmail.com>
.IP \[bu] 2
noabody <noabody@yahoo.com>
.IP \[bu] 2
OleFrost <82263101+olefrost@users.noreply.github.com>
.IP \[bu] 2
Kenny Parsons <kennyparsons93@gmail.com>
.IP \[bu] 2
Jeffrey Tolar <tolar.jeffrey@gmail.com>
.IP \[bu] 2
jtagcat <git-514635f7@jtag.cat>
.IP \[bu] 2
Tatsuya Noyori <63089076+public-tatsuya-noyori@users.noreply.github.com>
.IP \[bu] 2
lewisxy <lewisxy@users.noreply.github.com>
.IP \[bu] 2
Nolan Woods <nolan_w@sfu.ca>
.IP \[bu] 2
Gautam Kumar <25435568+gautamajay52@users.noreply.github.com>
.IP \[bu] 2
Chris Macklin <chris.macklin@10xgenomics.com>
.IP \[bu] 2
Antoon Prins <antoon.prins@surfsara.nl>
.IP \[bu] 2
Alexey Ivanov <rbtz@dropbox.com>
.IP \[bu] 2
Serge Pouliquen <sp31415@free.fr>
.IP \[bu] 2
acsfer <carlos@reendex.com>
.IP \[bu] 2
Tom <tom@tom-fitzhenry.me.uk>
.IP \[bu] 2
Tyson Moore <tyson@tyson.me>
.IP \[bu] 2
database64128 <free122448@hotmail.com>
.IP \[bu] 2
Chris Lu <chrislusf@users.noreply.github.com>
.IP \[bu] 2
Reid Buzby <reid@rethink.software>
.IP \[bu] 2
darrenrhs <darrenrhs@gmail.com>
.IP \[bu] 2
Florian Penzkofer <fp@nullptr.de>
.IP \[bu] 2
Xuanchen Wu <117010292@link.cuhk.edu.cn>
.IP \[bu] 2
partev <petrosyan@gmail.com>
.IP \[bu] 2
Dmitry Sitnikov <fo2@inbox.ru>
.IP \[bu] 2
Haochen Tong <i@hexchain.org>
.IP \[bu] 2
Michael Hanselmann <public@hansmi.ch>
.IP \[bu] 2
Chuan Zh <zhchuan7@gmail.com>
.IP \[bu] 2
Antoine GIRARD <antoine.girard@sapk.fr>
.IP \[bu] 2
Justin Winokur (Jwink3101) <Jwink3101@users.noreply.github.com>
.IP \[bu] 2
Mariano Absatz (git) <scm@baby.com.ar>
.IP \[bu] 2
Greg Sadetsky <lepetitg@gmail.com>
.IP \[bu] 2
yedamo <logindaveye@gmail.com>
.IP \[bu] 2
hota <lindwurm.q@gmail.com>
.IP \[bu] 2
vinibali <vinibali1@gmail.com>
.IP \[bu] 2
Ken Enrique Morel <ken.morel.santana@gmail.com>
.IP \[bu] 2
Justin Hellings <justin.hellings@gmail.com>
.IP \[bu] 2
Parth Shukla <pparth@pparth.net>
.IP \[bu] 2
wzl <wangzl31@outlook.com>
.IP \[bu] 2
HNGamingUK <connor@earnshawhome.co.uk>
.IP \[bu] 2
Jonta <359397+Jonta@users.noreply.github.com>
.IP \[bu] 2
YenForYang <YenForYang@users.noreply.github.com>
.IP \[bu] 2
SimJoSt / Joda Stößer <git@simjo.st>
.IP \[bu] 2
Logeshwaran <waranlogesh@gmail.com>
.IP \[bu] 2
Rajat Goel <rajat@dropbox.com>
.IP \[bu] 2
r0kk3rz <r0kk3rz@gmail.com>
.IP \[bu] 2
Matthew Sevey <mjsevey@gmail.com>
.IP \[bu] 2
Filip Rysavy <fil@siasky.net>
.IP \[bu] 2
Ian Levesque <ian@ianlevesque.org>
.IP \[bu] 2
Thomas Stachl <thomas@stachl.me>
.IP \[bu] 2
Dmitry Bogatov <git#v1@kaction.cc>
.IP \[bu] 2
thomae <4493560+thomae@users.noreply.github.com>
.IP \[bu] 2
trevyn <trevyn-git@protonmail.com>
.IP \[bu] 2
David Liu <david.yx.liu@oracle.com>
.IP \[bu] 2
Chris Nelson <stuff@cjnaz.com>
.IP \[bu] 2
Felix Bünemann <felix.buenemann@gmail.com>
.IP \[bu] 2
Atílio Antônio <atiliodadalto@hotmail.com>
.IP \[bu] 2
Carlo Mion <mion00@gmail.com>
.IP \[bu] 2
Chris Lu <chris.lu@gmail.com>
.IP \[bu] 2
Vitor Arruda <vitor.pimenta.arruda@gmail.com>
.IP \[bu] 2
bbabich <bbabich@datamossa.com>
.IP \[bu] 2
David <dp.davide.palma@gmail.com>
.IP \[bu] 2
Borna Butkovic <borna@favicode.net>.IP \[bu] 2
Fredric Arklid <fredric.arklid@consid.se>
.IP \[bu] 2
Andy Jackson <Andrew.Jackson@bl.uk>
.IP \[bu] 2
Sinan Tan <i@tinytangent.com>
.IP \[bu] 2
deinferno <14363193+deinferno@users.noreply.github.com>
.IP \[bu] 2
rsapkf <rsapkfff@pm.me>
.IP \[bu] 2
Will Holtz <wholtz@gmail.com>
.IP \[bu] 2
GGG KILLER <gggkiller2@gmail.com>
.IP \[bu] 2
Logeshwaran Murugesan <logeshwaran@testpress.in>
.IP \[bu] 2
Lu Wang <coolwanglu@gmail.com>
.IP \[bu] 2
Bumsu Hyeon <ksitht@gmail.com>
.IP \[bu] 2
Shmz Ozggrn <98463324+ShmzOzggrn@users.noreply.github.com>
.IP \[bu] 2
Kim <kim@jotta.no>
.IP \[bu] 2
Niels van de Weem <n.van.de.weem@smile.nl>
.IP \[bu] 2
Koopa <codingkoopa@gmail.com>
.IP \[bu] 2
Yunhai Luo <yunhai-luo@hotmail.com>
.IP \[bu] 2
Charlie Jiang <w@chariri.moe>
.IP \[bu] 2
Alain Nussbaumer <alain.nussbaumer@alleluia.ch>
.IP \[bu] 2
Vanessasaurus <814322+vsoch@users.noreply.github.com>
.IP \[bu] 2
Isaac Levy <isaac.r.levy@gmail.com>
.IP \[bu] 2
Gourav T <workflowautomation@protonmail.com>
.IP \[bu] 2
Paulo Martins <paulo.pontes.m@gmail.com>
.IP \[bu] 2
viveknathani <viveknathani2402@gmail.com>
.IP \[bu] 2
Eng Zer Jun <engzerjun@gmail.com>
.IP \[bu] 2
Abhiraj <abhiraj.official15@gmail.com>
.IP \[bu] 2
Márton Elek <elek@apache.org> <elek@users.noreply.github.com>
.IP \[bu] 2
Vincent Murphy <vdm@vdm.ie>
.IP \[bu] 2
ctrl-q <34975747+ctrl-q@users.noreply.github.com>
.IP \[bu] 2
Nil Alexandrov <nalexand@akamai.com>
.IP \[bu] 2
GuoXingbin <101376330+guoxingbin@users.noreply.github.com>
.IP \[bu] 2
Berkan Teber <berkan@berkanteber.com>
.IP \[bu] 2
Tobias Klauser <tklauser@distanz.ch>
.IP \[bu] 2
KARBOWSKI Piotr <piotr.karbowski@gmail.com>
.IP \[bu] 2
GH <geeklihui@foxmail.com>
.IP \[bu] 2
rafma0 <int.main@gmail.com>
.IP \[bu] 2
Adrien Rey-Jarthon <jobs@adrienjarthon.com>
.IP \[bu] 2
Nick Gooding <73336146+nickgooding@users.noreply.github.com>
.IP \[bu] 2
Leroy van Logchem <lr.vanlogchem@gmail.com>
.IP \[bu] 2
Zsolt Ero <zsolt.ero@gmail.com>
.IP \[bu] 2
Lesmiscore <nao20010128@gmail.com>
.IP \[bu] 2
ehsantdy <ehsan.tadayon@arvancloud.com> <ehsantadayon85@gmail.com>
.IP \[bu] 2
SwazRGB <65694696+swazrgb@users.noreply.github.com>
.IP \[bu] 2
Mateusz Puczyński <mati6095@gmail.com>
.IP \[bu] 2
Michael C Tiernan - MIT-Research Computing Project <mtiernan@mit.edu>
.IP \[bu] 2
Kaspian <34658474+KaspianDev@users.noreply.github.com>
.IP \[bu] 2
Werner <EvilOlaf@users.noreply.github.com>
.IP \[bu] 2
Hugal31 <hugo.laloge@gmail.com>
.IP \[bu] 2
Christian Galo <36752715+cgalo5758@users.noreply.github.com>
.IP \[bu] 2
Erik van Velzen <erik@evanv.nl>
.IP \[bu] 2
Derek Battams <derek@battams.ca>
.IP \[bu] 2
Paul <devnoname120@gmail.com>
.IP \[bu] 2
SimonLiu <simonliu009@users.noreply.github.com>
.IP \[bu] 2
Hugo Laloge <hla@lescompanions.com>
.IP \[bu] 2
Mr-Kanister <68117355+Mr-Kanister@users.noreply.github.com>
.IP \[bu] 2
Rob Pickerill <r.pickerill@gmail.com>
.IP \[bu] 2
Andrey <to.merge@gmail.com>
.IP \[bu] 2
Eric Wolf <19wolf@gmail.com>
.IP \[bu] 2
Nick <nick.naumann@mailbox.tu-dresden.de>
.IP \[bu] 2
Jason Zheng <jszheng17@gmail.com>
.IP \[bu] 2
Matthew Vernon <mvernon@wikimedia.org>
.IP \[bu] 2
Noah Hsu <i@nn.ci>
.IP \[bu] 2
m00594701 <mengpengbo@huawei.com>
.IP \[bu] 2
Art M.
Gallagher <artmg50@gmail.com>
.IP \[bu] 2
Sven Gerber <49589423+svengerber@users.noreply.github.com>
.IP \[bu] 2
CrossR <r.cross@lancaster.ac.uk>
.IP \[bu] 2
Maciej Radzikowski <maciej@radzikowski.com.pl>
.IP \[bu] 2
Scott Grimes <scott.grimes@spaciq.com>
.IP \[bu] 2
Phil Shackleton <71221528+philshacks@users.noreply.github.com>
.IP \[bu] 2
eNV25 <env252525@gmail.com>
.IP \[bu] 2
Caleb <inventor96@users.noreply.github.com>
.IP \[bu] 2
J-P Treen <jp@wraptious.com>
.IP \[bu] 2
Martin Czygan <53705+miku@users.noreply.github.com>
.IP \[bu] 2
buda <sandrojijavadze@protonmail.com>
.IP \[bu] 2
mirekphd <36706320+mirekphd@users.noreply.github.com>
.IP \[bu] 2
vyloy <vyloy@qq.com>
.IP \[bu] 2
Anthrazz <25553648+Anthrazz@users.noreply.github.com>
.IP \[bu] 2
zzr93 <34027824+zzr93@users.noreply.github.com>
.IP \[bu] 2
Paul Norman <penorman@mac.com>
.IP \[bu] 2
Lorenzo Maiorfi <maiorfi@gmail.com>
.IP \[bu] 2
Claudio Maradonna <penguyman@stronzi.org>
.IP \[bu] 2
Ovidiu Victor Tatar <ovi.tatar@googlemail.com>
.IP \[bu] 2
Evan Spensley <epspensley@gmail.com>
.IP \[bu] 2
Yen Hu <61753151+0x59656e@users.noreply.github.com>
.IP \[bu] 2
Steve Kowalik <steven@wedontsleep.org>
.IP \[bu] 2
Jordi Gonzalez Muñoz <jordigonzm@gmail.com>
.IP \[bu] 2
Joram Schrijver <i@joram.io>
.IP \[bu] 2
Mark Trolley <marktrolley@gmail.com>
.IP \[bu] 2
João Henrique Franco <joaohenrique.franco@gmail.com>
.IP \[bu] 2
anonion <aman207@users.noreply.github.com>
.IP \[bu] 2
Ryan Morey <4590343+rmorey@users.noreply.github.com>
.IP \[bu] 2
Simon Bos <simonbos9@gmail.com>.IP \[bu] 2
YFdyh000 <yfdyh000@gmail.com>
.IP \[bu] 2
Øyvind Heddeland Instefjord <instefjord@outlook.com>
.IP \[bu] 2
Dmitry Deniskin <110819396+ddeniskin@users.noreply.github.com>
.IP \[bu] 2
Alexander Knorr <106825+opexxx@users.noreply.github.com>
.IP \[bu] 2
Richard Bateman <richard@batemansr.us>
.IP \[bu] 2
Dimitri Papadopoulos Orfanos
<3234522+DimitriPapadopoulos@users.noreply.github.com>
.IP \[bu] 2
Lorenzo Milesi <lorenzo.milesi@yetopen.com>
.IP \[bu] 2
Isaac Aymerich <isaac.aymerich@gmail.com>
.IP \[bu] 2
YanceyChiew <35898533+YanceyChiew@users.noreply.github.com>
.IP \[bu] 2
Manoj Ghosh <msays2000@gmail.com>
.IP \[bu] 2
Bachue Zhou <bachue.shu@gmail.com>
.IP \[bu] 2
Manoj Ghosh <manoj.ghosh@oracle.com>
.IP \[bu] 2
Tom Mombourquette <tom@devnode.com>
.IP \[bu] 2
Robert Newson <rnewson@apache.org>
.IP \[bu] 2
Samuel Johnson <esamueljohnson@gmail.com>
.IP \[bu] 2
coultonluke <luke@luke.org.uk>
.IP \[bu] 2
Anthony Pessy <anthony@cogniteev.com>
.IP \[bu] 2
Philip Harvey <pharvey@battelleecology.org>
.IP \[bu] 2
dgouju <dgouju@users.noreply.github.com>
.IP \[bu] 2
Clément Notin <clement.notin@gmail.com>
.IP \[bu] 2
x3-apptech <66947598+x3-apptech@users.noreply.github.com>
.IP \[bu] 2
Arnie97 <arnie97@gmail.com>
.IP \[bu] 2
Roel Arents <2691308+roelarents@users.noreply.github.com>
.IP \[bu] 2
Aaron Gokaslan <aaronGokaslan@gmail.com>
.IP \[bu] 2
techknowlogick <matti@mdranta.net>
.IP \[bu] 2
rkettelerij <richard@mindloops.nl>
.IP \[bu] 2
Kamui <fin-kamui@pm.me>
.IP \[bu] 2
asdffdsazqqq <90116442+asdffdsazqqq@users.noreply.github.com>
.IP \[bu] 2
Nathaniel Wesley Filardo <nfilardo@microsoft.com>
.IP \[bu] 2
ycdtosa <ycdtosa@users.noreply.github.com>
.IP \[bu] 2
Erik Agterdenbos <agterdenbos@users.noreply.github.com>
.IP \[bu] 2
Kevin Verstaen <48050031+kverstae@users.noreply.github.com>
.IP \[bu] 2
MohammadReza <mrvashian@gmail.com>
.IP \[bu] 2
vanplus <60313789+vanplus@users.noreply.github.com>
.IP \[bu] 2
Jack <16779171+jkpe@users.noreply.github.com>
.IP \[bu] 2
Abdullah Saglam <abdullah.saglam@stonebranch.com>
.IP \[bu] 2
Marks Polakovs <github@markspolakovs.me>
.IP \[bu] 2
piyushgarg <piyushgarg80@gmail.com>
.IP \[bu] 2
Kaloyan Raev <kaloyan-raev@users.noreply.github.com>
.IP \[bu] 2
IMTheNachoMan <imthenachoman@gmail.com>
.IP \[bu] 2
alankrit <alankrit@google.com>
.IP \[bu] 2
Bryan Kaplan <#\[at]bryankaplan.com>
.IP \[bu] 2
LXY <767763591@qq.com>
.IP \[bu] 2
Simmon Li (he/him) <li.simmon@gmail.com>
.IP \[bu] 2
happyxhw <44490504+happyxhw@users.noreply.github.com>
.IP \[bu] 2
Simmon Li (he/him) <hello@crespire.dev>
.IP \[bu] 2
Matthias Baur <baurmatt@users.noreply.github.com>
.IP \[bu] 2
Hunter Wittenborn <hunter@hunterwittenborn.com>
.IP \[bu] 2
logopk <peter@kreuser.name>
.IP \[bu] 2
Gerard Bosch <30733556+gerardbosch@users.noreply.github.com>
.IP \[bu] 2
ToBeFree <github@tfrei.de>
.IP \[bu] 2
NodudeWasTaken <75137537+NodudeWasTaken@users.noreply.github.com>
.IP \[bu] 2
Peter Brunner <peter@lugoues.net>
.IP \[bu] 2
Ninh Pham <dongian.rapclubkhtn@gmail.com>
.IP \[bu] 2
Ryan Caezar Itang <sitiom@proton.me>
.IP \[bu] 2
Peter Brunner <peter@psykhe.com>
.IP \[bu] 2
Leandro Sacchet <leandro.sacchet@animati.com.br>
.IP \[bu] 2
dependabot[bot] <49699333+dependabot[bot]\[at]users.noreply.github.com>
.IP \[bu] 2
cycneuramus <56681631+cycneuramus@users.noreply.github.com>
.IP \[bu] 2
Arnavion <me@arnavion.dev>
.IP \[bu] 2
Christopher Merry <christopher.merry@mlb.com>
.IP \[bu] 2
Thibault Coupin <thibault.coupin@gmail.com>
.IP \[bu] 2
Richard Tweed <RichardoC@users.noreply.github.com>
.IP \[bu] 2
Zach Kipp <Zacho2@users.noreply.github.com>
.IP \[bu] 2
yuudi <26199752+yuudi@users.noreply.github.com>
.IP \[bu] 2
NickIAm <NickIAm@users.noreply.github.com>
.IP \[bu] 2
Juang, Yi-Lin <frankyjuang@gmail.com>
.IP \[bu] 2
jumbi77 <jumbi77@users.noreply.github.com>
.IP \[bu] 2
Aditya Basu <ab.aditya.basu@gmail.com>
.IP \[bu] 2
ed <s@ocv.me>
.IP \[bu] 2
Drew Parsons <dparsons@emerall.com>
.IP \[bu] 2
Joel <joelnb@users.noreply.github.com>
.IP \[bu] 2
wiserain <mail275@gmail.com>
.IP \[bu] 2
Roel Arents <roel.arents@kadaster.nl>
.IP \[bu] 2
Shyim <github@shyim.de>
.IP \[bu] 2
Rintze Zelle <78232505+rzelle-lallemand@users.noreply.github.com>
.IP \[bu] 2
Damo <damoclark@users.noreply.github.com>
.IP \[bu] 2
WeidiDeng <weidi_deng@icloud.com>
.IP \[bu] 2
Brian Starkey <stark3y@gmail.com>
.IP \[bu] 2
jladbrook <jhladbrook@gmail.com>
.IP \[bu] 2
Loren Gordon <lorengordon@users.noreply.github.com>
.IP \[bu] 2
dlitster <davidlitster@gmail.com>
.IP \[bu] 2
Tobias Gion <tobias@gion.io>
.IP \[bu] 2
Jānis Bebrītis <janis.bebritis@wunder.io>
.IP \[bu] 2
Adam K <github.com@ak.tidy.email>
.IP \[bu] 2
Andrei Smirnov <smirnov.captain@gmail.com>
.IP \[bu] 2
Janne Hellsten <jjhellst@gmail.com>
.IP \[bu] 2
cc <12904584+shvc@users.noreply.github.com>
.IP \[bu] 2
Tareq Sharafy <tareq.sha@gmail.com>
.IP \[bu] 2
kapitainsky <dariuszb@me.com>.IP \[bu] 2
douchen <playgoobug@gmail.com>
.IP \[bu] 2
Sam Lai <70988+slai@users.noreply.github.com>
.IP \[bu] 2
URenko <18209292+URenko@users.noreply.github.com>
.IP \[bu] 2
Stanislav Gromov <kullfar@gmail.com>
.IP \[bu] 2
Paulo Schreiner <paulo.schreiner@delivion.de>
.IP \[bu] 2
Mariusz Suchodolski <mariusz@suchodol.ski>
.IP \[bu] 2
danielkrajnik <dan94kra@gmail.com>
.IP \[bu] 2
Peter Fern <github@0xc0dedbad.com>
.IP \[bu] 2
zzq <i@zhangzqs.cn>
.IP \[bu] 2
mac-15 <usman.ilamdin@phpstudios.com>
.IP \[bu] 2
Sawada Tsunayoshi <34431649+TsunayoshiSawada@users.noreply.github.com>
.IP \[bu] 2
Dean Attali <daattali@gmail.com>
.IP \[bu] 2
Fjodor42 <molgaard@gmail.com>
.IP \[bu] 2
BakaWang <wa11579@hotmail.com>
.IP \[bu] 2
Mahad <56235065+Mahad-lab@users.noreply.github.com>
.IP \[bu] 2
Vladislav Vorobev <x.miere@gmail.com>
.IP \[bu] 2
darix <darix@users.noreply.github.com>
.IP \[bu] 2
Benjamin <36415086+bbenjamin-sys@users.noreply.github.com>
.IP \[bu] 2
Chun-Hung Tseng <henrybear327@users.noreply.github.com>
.IP \[bu] 2
Ricardo D\[aq]O.
Albanus <rdalbanus@users.noreply.github.com>
.IP \[bu] 2
gabriel-suela <gscsuela@gmail.com>
.IP \[bu] 2
Tiago Boeing <contato@tiagoboeing.com>
.IP \[bu] 2
Edwin Mackenzie-Owen <edwin.mowen@gmail.com>
.IP \[bu] 2
Niklas Hambüchen <mail@nh2.me>
.IP \[bu] 2
yuudi <yuudi@users.noreply.github.com>
.IP \[bu] 2
Zach <github@prozach.org>
.IP \[bu] 2
nielash <31582349+nielash@users.noreply.github.com>
.IP \[bu] 2
Julian Lepinski <lepinsk@users.noreply.github.com>
.IP \[bu] 2
Raymond Berger <RayBB@users.noreply.github.com>
.IP \[bu] 2
Nihaal Sangha <nihaal.git@gmail.com>
.IP \[bu] 2
Masamune3210 <1053504+Masamune3210@users.noreply.github.com>
.IP \[bu] 2
James Braza <jamesbraza@gmail.com>
.IP \[bu] 2
antoinetran <antoinetran@users.noreply.github.com>
.IP \[bu] 2
alexia <me@alexia.lol>
.IP \[bu] 2
nielash <nielronash@gmail.com>
.IP \[bu] 2
Vitor Gomes <vitor.gomes@delivion.de> <mail@vitorgomes.com>
.IP \[bu] 2
Jacob Hands <jacob@gogit.io>
.IP \[bu] 2
hideo aoyama <100831251+boukendesho@users.noreply.github.com>
.IP \[bu] 2
Roberto Ricci <io@r-ricci.it>
.IP \[bu] 2
Bjørn Smith <bjornsmith@gmail.com>
.IP \[bu] 2
Alishan Ladhani <8869764+aladh@users.noreply.github.com>
.IP \[bu] 2
zjx20 <zhoujianxiong2@gmail.com>
.IP \[bu] 2
Oksana <142890647+oks-maytech@users.noreply.github.com>
.IP \[bu] 2
Volodymyr Kit <v.kit@maytech.net>
.IP \[bu] 2
David Pedersen <limero@me.com>
.IP \[bu] 2
Drew Stinnett <drew@drewlink.com>
.IP \[bu] 2
Pat Patterson <pat@backblaze.com>
.IP \[bu] 2
Herby Gillot <herby.gillot@gmail.com>
.IP \[bu] 2
Nikita Shoshin <shoshin_nikita@fastmail.com>
.IP \[bu] 2
rinsuki <428rinsuki+git@gmail.com>
.IP \[bu] 2
Beyond Meat <51850644+beyondmeat@users.noreply.github.com>
.IP \[bu] 2
Saleh Dindar <salh@fb.com>
.IP \[bu] 2
Volodymyr <142890760+vkit-maytech@users.noreply.github.com>
.IP \[bu] 2
Gabriel Espinoza <31670639+gspinoza@users.noreply.github.com>
.IP \[bu] 2
Keigo Imai <keigo.imai@gmail.com>
.IP \[bu] 2
Ivan Yanitra <iyanitra@tesla-consulting.com>
.IP \[bu] 2
alfish2000 <alfish2000@gmail.com>
.IP \[bu] 2
wuxingzhong <qq330332812@gmail.com>
.IP \[bu] 2
Adithya Kumar <akumar42@protonmail.com>
.IP \[bu] 2
Tayo-pasedaRJ <138471223+Tayo-pasedaRJ@users.noreply.github.com>
.IP \[bu] 2
Peter Kreuser <logo@kreuser.name>
.IP \[bu] 2
fotile96 <fotile96@users.noreply.github.com>
.IP \[bu] 2
Luc Ritchie <luc.ritchie@gmail.com>
.IP \[bu] 2
cynful <cynful@users.noreply.github.com>
.IP \[bu] 2
wjielai <wjielai@tencent.com>
.IP \[bu] 2
Jack Deng <jackdeng@gmail.com>
.IP \[bu] 2
Mikubill <31246794+Mikubill@users.noreply.github.com>
.IP \[bu] 2
Artur Neumann <artur@jankaritech.com>
.IP \[bu] 2
Saw-jan <saw.jan.grg3e@gmail.com>
.IP \[bu] 2
Oksana Zhykina <o.zhykina@maytech.net>
.IP \[bu] 2
karan <karan.gupta92@gmail.com>
.IP \[bu] 2
viktor <viktor@yakovchuk.net>
.IP \[bu] 2
moongdal <moongdal@tutanota.com>
.IP \[bu] 2
Mina Galić <freebsd@igalic.co>
.IP \[bu] 2
Alen Šiljak <dev@alensiljak.eu.org>
.IP \[bu] 2
你知道未来吗 <rkonfj@gmail.com>
.IP \[bu] 2
Abhinav Dhiman <8640877+ahnv@users.noreply.github.com>
.IP \[bu] 2
halms <7513146+halms@users.noreply.github.com>
.IP \[bu] 2
ben-ba <benjamin.brauner@gmx.de>
.IP \[bu] 2
Eli Orzitzer <e_orz@yahoo.com>
.IP \[bu] 2
Anthony Metzidis <anthony.metzidis@gmail.com>
.IP \[bu] 2
keongalvin <keongalvin@gmail.com>
.IP \[bu] 2
rarspace01 <rarspace01@users.noreply.github.com>
.IP \[bu] 2
Paul Stern <paulstern45@gmail.com>
.IP \[bu] 2
Nikhil Ahuja <nikhilahuja@live.com>
.IP \[bu] 2
Harshit Budhraja <52413945+harshit-budhraja@users.noreply.github.com>
.IP \[bu] 2
Tera <24725862+teraa@users.noreply.github.com>
.IP \[bu] 2
Kyle Reynolds <kylereynoldsdev@gmail.com>
.IP \[bu] 2
Michael Eischer <michael.eischer@gmx.de>
.IP \[bu] 2
Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com>.IP \[bu] 2
DanielEgbers <27849724+DanielEgbers@users.noreply.github.com>
.IP \[bu] 2
Jack Provance <49460795+njprov@users.noreply.github.com>
.IP \[bu] 2
Gabriel Ramos <109390599+gabrielramos02@users.noreply.github.com>
.IP \[bu] 2
Dan McArdle <d@nmcardle.com>
.IP \[bu] 2
Joe Cai <joe.cai@bigcommerce.com>
.IP \[bu] 2
Anders Swanson <anders.swanson@oracle.com>
.IP \[bu] 2
huajin tong <137764712+thirdkeyword@users.noreply.github.com>
.IP \[bu] 2
John-Paul Smith <john-paulsmith@users.noreply.github.com>
.IP \[bu] 2
racerole <148756161+racerole@users.noreply.github.com>
.IP \[bu] 2
Gachoud Philippe <ph.gachoud@gmail.com>
.IP \[bu] 2
YukiUnHappy <saberhana@yandex.com>
.IP \[bu] 2
Kyle Reynolds <kyle.reynolds@bridgerphotonics.com>
.IP \[bu] 2
Lewis Hook <lewis@hook.im>
.IP \[bu] 2
hoyho <luohaihao@gmail.com>
.IP \[bu] 2
Vitaly <9034218+gvitali@users.noreply.github.com>
.IP \[bu] 2
iotmaestro <iotmaestro@proton.me>
.IP \[bu] 2
psychopatt <66741203+psychopatt@users.noreply.github.com>
.IP \[bu] 2
Alex Garel <alex@garel.org>
.IP \[bu] 2
Warrentheo <warrentheo@hotmail.com>
.IP \[bu] 2
Alexandre Lavigne <lavigne958@gmail.com>
.IP \[bu] 2
yoelvini <134453420+yoelvini@users.noreply.github.com>
.IP \[bu] 2
Erisa A <erisa@cloudflare.com>
.IP \[bu] 2
Pieter van Oostrum <pieter@vanoostrum.org>
.IP \[bu] 2
jakzoe <155812065+jakzoe@users.noreply.github.com>
.IP \[bu] 2
guangwu <guoguangwu@magic-shield.com>
.IP \[bu] 2
static-moonlight <107991124+static-moonlight@users.noreply.github.com>
.IP \[bu] 2
yudrywet <yudeyao@yeah.net>
.IP \[bu] 2
Butanediol <git@xnh.app>
.IP \[bu] 2
Dave Nicolson <david.nicolson@gmail.com>
.IP \[bu] 2
Katia Esposito <katia@linux.com>
.IP \[bu] 2
pawsey-kbuckley <36438302+pawsey-kbuckley@users.noreply.github.com>
.IP \[bu] 2
hidewrong <167099254+hidewrong@users.noreply.github.com>
.IP \[bu] 2
Michael Terry <mike@mterry.name>
.IP \[bu] 2
Sunny <25066078+LoSunny@users.noreply.github.com>
.IP \[bu] 2
overallteach <cricis@foxmail.com>
.IP \[bu] 2
JT Olio <jt@olio.lol>
.IP \[bu] 2
Evan McBeth <64177332+AtomicRobotMan0101@users.noreply.github.com>
.IP \[bu] 2
Dominik Joe Pantůček <dominik.pantucek@trustica.cz>
.IP \[bu] 2
yumeiyin <155420652+yumeiyin@users.noreply.github.com>
.IP \[bu] 2
Bruno Fernandes <54373093+folkzb@users.noreply.github.com>
.IP \[bu] 2
Thomas Schneider <tspam.github@brainfuck.space>
.IP \[bu] 2
Charles Hamilton <52973156+chamilton-ccn@users.noreply.github.com>
.IP \[bu] 2
Tomasz Melcer <tomasz@melcer.pl>
.IP \[bu] 2
Michał Dzienisiewicz <michal.piotr.dz@gmail.com>
.IP \[bu] 2
Florian Klink <flokli@flokli.de>
.IP \[bu] 2
Bill Fraser <bill@wfraser.dev>
.IP \[bu] 2
Thearas <thearas850@gmail.com>
.IP \[bu] 2
Filipe Herculano <fifo_@live.com>
.IP \[bu] 2
Russ Bubley <russ.bubley@googlemail.com>
.IP \[bu] 2
Paul Collins <paul.collins@canonical.com>
.IP \[bu] 2
Tomasz Melcer <liori@exroot.org>
.IP \[bu] 2
itsHenry <2671230065@qq.com>
.IP \[bu] 2
Ke Wang <me@ke.wang>
.IP \[bu] 2
AThePeanut4 <49614525+AThePeanut4@users.noreply.github.com>
.IP \[bu] 2
Tobias Markus <tobbi.bugs@googlemail.com>
.IP \[bu] 2
Ernie Hershey <github@ernie.org>
.IP \[bu] 2
Will Miles <wmiles@sgl.com>
.IP \[bu] 2
David Seifert <16636962+SoapGentoo@users.noreply.github.com>
.IP \[bu] 2
Fornax <wimbrand96@gmail.com>
.IP \[bu] 2
Sam Harrison <sam.harrison@files.com>
.IP \[bu] 2
Péter Bozsó <3806723+peterbozso@users.noreply.github.com>
.IP \[bu] 2
Georg Welzel <gwelzel@mailbox.org>
.IP \[bu] 2
John Oxley <john.oxley@gmail.com> <joxley@meta.com>
.IP \[bu] 2
Pawel Palucha <pawel.palucha@aetion.com>
.IP \[bu] 2
crystalstall <crystalruby@qq.com>
.IP \[bu] 2
nipil <nipil@users.noreply.github.com>
.IP \[bu] 2
yuval-cloudinary <46710068+yuval-cloudinary@users.noreply.github.com>
.IP \[bu] 2
Mathieu Moreau <mrx23dot@users.noreply.github.com>
.IP \[bu] 2
fsantagostinobietti
<6057026+fsantagostinobietti@users.noreply.github.com>
.IP \[bu] 2
Oleg Kunitsyn <114359669+hiddenmarten@users.noreply.github.com>
.IP \[bu] 2
Divyam <47589864+divyam234@users.noreply.github.com>
.IP \[bu] 2
ttionya <ttionya@users.noreply.github.com>
.IP \[bu] 2
quiescens <quiescens@gmail.com>
.IP \[bu] 2
rishi.sridhar <rishi.sridhar@zohocorp.com>
.IP \[bu] 2
Lawrence Murray <lawrence@indii.org>
.IP \[bu] 2
Leandro Piccilli <leandro.piccilli@thalesgroup.com>
.IP \[bu] 2
Benjamin Legrand <benjamin.legrand@seagate.com>
.IP \[bu] 2
Noam Ross <noam.ross@gmail.com>
.IP \[bu] 2
lostb1t <coding-mosses0z@icloud.com>
.IP \[bu] 2
Matthias Gatto <matthias.gatto@outscale.com>
.IP \[bu] 2
André Tran <andre.tran@outscale.com>
.IP \[bu] 2
Simon Bos <simon@simonbos.be>
.IP \[bu] 2
Alexandre Hamez <199517+ahamez@users.noreply.github.com>
.IP \[bu] 2
Randy Bush <randy@psg.com>
.IP \[bu] 2
Diego Monti <diegmonti@users.noreply.github.com>
.IP \[bu] 2
tgfisher <tgfisher@stanford.edu>
.IP \[bu] 2
Moises Lima <mozlima@gmail.com>
.IP \[bu] 2
Dimitar Ivanov <mimiteto@gmail.com>
.IP \[bu] 2
shenpengfeng <xinhangzhou@icloud.com>
.IP \[bu] 2
Dimitrios Slamaris <dim0x69@users.noreply.github.com>.IP \[bu] 2
vintagefuture <39503528+vintagefuture@users.noreply.github.com>
.IP \[bu] 2
David Seifert <soap@gentoo.org>
.IP \[bu] 2
Michael R.
Davis <mrdvt92@users.noreply.github.com>
.IP \[bu] 2
remygrandin <remy.gr@ndin.fr>
.IP \[bu] 2
Ilias Ozgur Can Leonard <iscilyas@gmail.com>
.IP \[bu] 2
divinity76 <divinity76@gmail.com>
.IP \[bu] 2
Martin Hassack <martin@redmaple.tech>
.IP \[bu] 2
Filipe Azevedo <pasnox@gmail.com>
.IP \[bu] 2
hayden.pan <hayden.pan@outlook.com>
.IP \[bu] 2
Yxxx <45665172+marsjane@users.noreply.github.com>
.IP \[bu] 2
Thomas ten Cate <ttencate@gmail.com>
.IP \[bu] 2
Louis Laureys <louis@laureys.me>
.IP \[bu] 2
Henry Lee <contact@nynxz.com>
.IP \[bu] 2
ToM <thomas.faucher@bibliosansfrontieres.org>
.IP \[bu] 2
TAKEI Yuya <853320+takei-yuya@users.noreply.github.com>
.IP \[bu] 2
Francesco Frassinelli <fraph24@gmail.com>
<francesco.frassinelli@nina.no>
.IP \[bu] 2
Matt Ickstadt <mattico8@gmail.com> <matt@beckenterprises.com>
.IP \[bu] 2
Spencer McCullough <mccullough.spencer@gmail.com>
.IP \[bu] 2
Jonathan Giannuzzi <jonathan@giannuzzi.me>
.IP \[bu] 2
Christoph Berger <github@christophberger.com>
.IP \[bu] 2
Tim White <tim.white@su.org.au>
.IP \[bu] 2
Robin Schneider <robin.schneider@stackit.cloud>
.IP \[bu] 2
izouxv <izouxv@users.noreply.github.com>
.IP \[bu] 2
Moises Lima <mozlima@users.noreply.github.com>
.IP \[bu] 2
Bruno Fernandes <bruno.fernandes1996@hotmail.com>
.IP \[bu] 2
Corentin Barreau <corentin@archive.org>
.IP \[bu] 2
hiddenmarten <hiddenmarten@gmail.com>
.IP \[bu] 2
Trevor Starick <trevor.starick@gmail.com>
.IP \[bu] 2
b-wimmer <132347192+b-wimmer@users.noreply.github.com>
.IP \[bu] 2
Jess <jess@jessie.cafe>
.IP \[bu] 2
Zachary Vorhies <zachvorhies@protonmail.com>
.IP \[bu] 2
Alexander Minbaev <minbaev@gmail.com>
.IP \[bu] 2
Joel K Biju <joelkbiju18@gmail.com>
.IP \[bu] 2
ll3006 <doublel3006@gmail.com>
.IP \[bu] 2
jbagwell-akamai <113531113+jbagwell-akamai@users.noreply.github.com>
.IP \[bu] 2
Michael Kebe <michael.kebe@gmail.com>
.IP \[bu] 2
Lorenz Brun <lorenz@brun.one>
.IP \[bu] 2
Dave Vasilevsky <djvasi@gmail.com> <dave@vasilevsky.ca>
.IP \[bu] 2
luzpaz <luzpaz@users.noreply.github.com>
.IP \[bu] 2
jack <9480542+jackusm@users.noreply.github.com>
.IP \[bu] 2
Jörn Friedrich Dreyer <jfd@butonic.de>
.IP \[bu] 2
alingse <alingse@foxmail.com>
.IP \[bu] 2
Fernando Fernández <ferferga@hotmail.com>
.IP \[bu] 2
eccoisle <167755281+eccoisle@users.noreply.github.com>
.IP \[bu] 2
Klaas Freitag <kraft@freisturz.de>
.IP \[bu] 2
Danny Garside <dannygarside@outlook.com>
.IP \[bu] 2
Samantha Bowen <sam@bbowen.net>
.IP \[bu] 2
simonmcnair <101189766+simonmcnair@users.noreply.github.com>
.IP \[bu] 2
huanghaojun <jasen.huang@ugreen.com>
.IP \[bu] 2
Enduriel <endur1el@protonmail.com>
.IP \[bu] 2
Markus Gerstel <markus.gerstel@osirium.com>
.IP \[bu] 2
simwai <16225108+simwai@users.noreply.github.com>
.IP \[bu] 2
Ben Alex <ben.alex@acegi.com.au>
.IP \[bu] 2
Klaas Freitag <opensource@freisturz.de> <klaas.freitag@kiteworks.com>
.IP \[bu] 2
Andrew Kreimer <algonell@gmail.com>
.IP \[bu] 2
Ed Craig-Wood <138211970+edc-w@users.noreply.github.com>
.IP \[bu] 2
Christian Richter <crichter@owncloud.com>
<1058116+dragonchaser@users.noreply.github.com>
.IP \[bu] 2
Ralf Haferkamp <r.haferkamp@opencloud.eu>
.IP \[bu] 2
Jugal Kishore <me@devjugal.com>
.IP \[bu] 2
Tho Neyugn <nguyentruongtho@users.noreply.github.com>
.IP \[bu] 2
Ben Boeckel <mathstuf@users.noreply.github.com>
.IP \[bu] 2
Clément Wehrung <cwehrung@nurves.com>
.IP \[bu] 2
Jeff Geerling <geerlingguy@mac.com>
.IP \[bu] 2
Germán Casares <german.casares.march+github@gmail.com>
.IP \[bu] 2
fhuber <florian.huber@noris.de>
.IP \[bu] 2
wbulot <wbulot@hotmail.com>
.IP \[bu] 2
Jeremy Daer <jeremydaer@gmail.com>
.IP \[bu] 2
Oleksiy Stashok <ostashok@tesla.com>
.IP \[bu] 2
PrathameshLakawade <prathameshlakawade@gmail.com>
.IP \[bu] 2
Nathanael Demacon <7271496+quantumsheep@users.noreply.github.com>
.IP \[bu] 2
ahxxm <ahxxm@users.noreply.github.com>
.IP \[bu] 2
Flora Thiebaut <johann.thiebaut@gmail.com>
.IP \[bu] 2
kingston125 <support@filelu.com> <kingston125@github.com>
.IP \[bu] 2
Ser-Bul <30335009+Ser-Bul@users.noreply.github.com>
.IP \[bu] 2
jinjingroad <jinjingroad@sina.com>
.IP \[bu] 2
necaran <55765083+necaran@users.noreply.github.com>
.IP \[bu] 2
Marvin Rösch <marvinroesch99@gmail.com>
.IP \[bu] 2
curlwget <curlwget@icloud.com>
.IP \[bu] 2
$\[at]M\[at]RTH_ <165886349+Samarth1015@users.noreply.github.com>
.IP \[bu] 2
Ali Zein Yousuf <azy5030@gmail.com>
.IP \[bu] 2
Davide Bizzarri <davide.bizzarri@willhaben.at>
.IP \[bu] 2
Ross Smith II <ross@smithii.com>
.IP \[bu] 2
Vikas Bhansali <64532198+vibhansa-msft@users.noreply.github.com>
.IP \[bu] 2
Sudipto Baral <sudiptobaral.me@gmail.com>
.IP \[bu] 2
Sam Pegg <samrpegg@gmail.com>
<70067376+S-Pegg1@users.noreply.github.com>
.IP \[bu] 2
liubingrun <liubr1@chinatelecom.cn>
.IP \[bu] 2
Albin Parou <fumesover@gmail.com>
.IP \[bu] 2
n4n5 <56606507+Its-Just-Nans@users.noreply.github.com>.IP \[bu] 2
Florent Vennetier <florent.vennetier@ovhcloud.com>
.IP \[bu] 2
houance <45840516+houance@users.noreply.github.com>
.IP \[bu] 2
Yu Xin <3188+is@users.noreply.github.com>
.IP \[bu] 2
Antonin Goude <antonin.goude@ovhcloud.com>
.IP \[bu] 2
Timothy Jacobs <timothy@ironbounddesigns.com>
.IP \[bu] 2
praveen-solanki-oracle <praveen.solanki@oracle.com>
.IP \[bu] 2
huangnauh <huanglibo2010@gmail.com>
.IP \[bu] 2
Lucas Bremgartner <breml@users.noreply.github.com>
.IP \[bu] 2
Binbin Qian <qianbinbin@hotmail.com>
.IP \[bu] 2
cui <523516579@qq.com>
.IP \[bu] 2
Tilman Vogel <tilman.vogel@web.de>
.IP \[bu] 2
skbeh <60107333+skbeh@users.noreply.github.com>
.IP \[bu] 2
Claudius Ellsel <claudius.ellsel@live.de>
.IP \[bu] 2
Motte <37443982+dmotte@users.noreply.github.com>
.IP \[bu] 2
dougal <dougal.craigwood@gmail.com>
<147946567+roucc@users.noreply.github.com>
.IP \[bu] 2
anon-pradip <pradipsubedi360@gmail.com>
.IP \[bu] 2
Robin Rolf <imer@imer.cc>
.IP \[bu] 2
Jean-Christophe Cura <jcaspes@gmail.com>
.IP \[bu] 2
russcoss <russcoss@outlook.com>
.IP \[bu] 2
Matt LaPaglia <mlapaglia@gmail.com>
.IP \[bu] 2
Youfu Zhang <1315097+zhangyoufu@users.noreply.github.com>
.IP \[bu] 2
juejinyuxitu <juejinyuxitu@outlook.com>
.IP \[bu] 2
iTrooz <hey@itrooz.fr>
.IP \[bu] 2
Microscotch <github.com@microscotch.net>
.IP \[bu] 2
Andrew Ruthven <andrew@etc.gen.nz>
.IP \[bu] 2
spiffytech <git@spiffy.tech>
.IP \[bu] 2
Dulani Woods <Dulani@gmail.com>
.IP \[bu] 2
Marco Ferretti <mferretti93@gmail.com>
.IP \[bu] 2
hunshcn <hunsh.cn@gmail.com>
.IP \[bu] 2
vastonus <vastonus@outlook.com>
.IP \[bu] 2
Oleksandr Redko <oleksandr.red+github@gmail.com>
.IP \[bu] 2
reddaisyy <reddaisy@outlook.jp>
.IP \[bu] 2
viocha <viocha@qq.com>
.IP \[bu] 2
Aneesh Agrawal <aneesh@anthropic.com>
.IP \[bu] 2
divinity76 <hans@loltek.net>
.IP \[bu] 2
Andrew Gunnerson <accounts+github@chiller3.com>
.IP \[bu] 2
Lakshmi-Surekha <Lakshmi.Kovvuri@ibm.com>
.IP \[bu] 2
dulanting <dulanting@outlook.jp>
.IP \[bu] 2
Adam Dinwoodie <me-and@users.noreply.github.com>
.IP \[bu] 2
Lukas Krejci <metlos@users.noreply.github.com>
.IP \[bu] 2
Riaz Arbi <riazarbi@users.noreply.github.com>
.IP \[bu] 2
Fawzib Rojas <fawzib.rojas@gmail.com>
.IP \[bu] 2
fries1234 <fries1234@protonmail.com>
.IP \[bu] 2
Joseph Brownlee <39440458+JellyJoe198@users.noreply.github.com>
.IP \[bu] 2
Ted Robertson <10043369+tredondo@users.noreply.github.com>
.IP \[bu] 2
SublimePeace <184005903+SublimePeace@users.noreply.github.com>
.IP \[bu] 2
Copilot <198982749+Copilot@users.noreply.github.com>
.IP \[bu] 2
Alex <64072843+A1ex3@users.noreply.github.com>
.IP \[bu] 2
n4n5 <its.just.n4n5@gmail.com>
.IP \[bu] 2
aliaj1 <ali19961@gmail.com>
.IP \[bu] 2
Sean Turner <30396892+seanturner026@users.noreply.github.com>
.IP \[bu] 2
jijamik <30904953+jijamik@users.noreply.github.com>
.IP \[bu] 2
Dominik Sander <git@dsander.de>
.IP \[bu] 2
Nikolay Kiryanov <nikolay@kiryanov.ru>
.IP \[bu] 2
Diana <5275194+DianaNites@users.noreply.github.com>
.IP \[bu] 2
Duncan Smart <duncan.smart@gmail.com>
.IP \[bu] 2
vicerace <vicerace@sohu.com>
.IP \[bu] 2
Cliff Frey <cliff@openai.com>
.IP \[bu] 2
Vladislav Tropnikov <vtr.name@gmail.com>
.IP \[bu] 2
Leo <i@hardrain980.com>
.IP \[bu] 2
Johannes Rothe <mail@johannes-rothe.de>
.IP \[bu] 2
Tingsong Xu <tingsong.xu@rightcapital.com>
.IP \[bu] 2
Jonas Tingeborn <134889+jojje@users.noreply.github.com>
.IP \[bu] 2
jhasse-shade <jacob@shade.inc>
.IP \[bu] 2
vyv03354 <VYV03354@nifty.ne.jp>
.IP \[bu] 2
masrlinu <masrlinu@users.noreply.github.com>
<5259918+masrlinu@users.noreply.github.com>
.IP \[bu] 2
vupn0712 <126212736+vupn0712@users.noreply.github.com>
.IP \[bu] 2
darkdragon-001 <darkdragon-001@users.noreply.github.com>
.IP \[bu] 2
sys6101 <csvmen@gmail.com>
.IP \[bu] 2
Nicolas Dessart <nds@outsight.tech>
.IP \[bu] 2
Qingwei Li <332664203@qq.com>
.IP \[bu] 2
yy <yhymmt37@gmail.com>
.IP \[bu] 2
Marc-Philip <marc-philip.werner@sap.com>
.IP \[bu] 2
Mikel Olasagasti Uranga <mikel@olasagasti.info>
.IP \[bu] 2
Nick Owens <mischief@offblast.org>
.IP \[bu] 2
hyusap <paulayush@gmail.com>
.IP \[bu] 2
jzunigax2 <125698953+jzunigax2@users.noreply.github.com>
.IP \[bu] 2
lullius <lullius@users.noreply.github.com>
.IP \[bu] 2
StarHack <StarHack@users.noreply.github.com>
.IP \[bu] 2
Leon Brocard <acme@astray.com>
.IP \[bu] 2
Cohinem <143964778+Cohinem@users.noreply.github.com>
.IP \[bu] 2
Jack Kelly <jack@OpenClimateFix.org>
.IP \[bu] 2
Prakhar Chhalotre <chhalotreprakhar00@gmail.com>
.IP \[bu] 2
Varun Chawla <34209028+veeceey@users.noreply.github.com>
.IP \[bu] 2
Jan-Philipp Reßler <75355263+TabError@users.noreply.github.com>
.IP \[bu] 2
Shlomi Avihou <shlomi@zadarastorage.com>
.IP \[bu] 2
Chris <238498929+chris081519-crypto@users.noreply.github.com>
.IP \[bu] 2
Jan-Philipp Reßler <xodarap@xodarap.de>
.IP \[bu] 2
Dark Dragon <darkdragon-001@web.de>.IP \[bu] 2
Leon Brocard <lbrocard@fastly.com>
.IP \[bu] 2
a1pcm <a1pcm@users.noreply.github.com>
.IP \[bu] 2
FTCHD <144691102+FTCHD@users.noreply.github.com>
.IP \[bu] 2
Bjoern Franke <bjo+git@schafweide.org>
.IP \[bu] 2
hxnd <callmehxnd@outlook.de>
.IP \[bu] 2
Adam Kasztenny <adamkasztenny@gmail.com>
.IP \[bu] 2
Romāns Potašovs <justgook@gmail.com>
.IP \[bu] 2
Brian Bockelman <bbockelman@morgridge.org>
.IP \[bu] 2
Bjoern Franke <bjo@schafweide.org>
.IP \[bu] 2
razorloves <razorloves@gmail.com>
.IP \[bu] 2
Duncan F <131309315+duncanaf@users.noreply.github.com>
.IP \[bu] 2
Billy Hughes <w.g.h.hughes@gmail.com>
.IP \[bu] 2
Bhagyashreek8 <57988406+Bhagyashreek8@users.noreply.github.com>
.IP \[bu] 2
Andriy Senyshyn <135705861+sam-mt@users.noreply.github.com>
.IP \[bu] 2
Andrew Furman <7343697+furmandev@users.noreply.github.com>
.IP \[bu] 2
ZRHan <56144550+ZRHann@users.noreply.github.com>
.IP \[bu] 2
Jason <jasonbabo@gmail.com>
.IP \[bu] 2
Patrick Farrell <pfarrell@whamcloud.com>
.IP \[bu] 2
BizaNator <17164422+BizaNator@users.noreply.github.com>
.IP \[bu] 2
lif <1835304752@qq.com>
.IP \[bu] 2
jinkeyuu <44105232+jinkeyuu@users.noreply.github.com>
.IP \[bu] 2
jinyu.han <jinyu.han@ucloud.cn>
.IP \[bu] 2
Claude Opus 4.6 <noreply@anthropic.com>
.IP \[bu] 2
Andriy Senyshyn <andriy.senyshyn@kiteworks.com>
.IP \[bu] 2
Mike GIllan <mike.gillan@gmail.com>
.IP \[bu] 2
Xiangzhe <xiangzhedev@gmail.com>
.IP \[bu] 2
Suyun <suyun@aosc.io>
.IP \[bu] 2
TheBabu <ariq.haqq@gmail.com>
.IP \[bu] 2
Brais Couce <braiscouce@gmail.com>
.IP \[bu] 2
Mozi <29089388+pzhlkj6612@users.noreply.github.com>
.IP \[bu] 2
SyoBoN <syobon@syobon.net>
.IP \[bu] 2
Jan Heylen <heyleke@gmail.com>
.IP \[bu] 2
tdawe <90407556+tdawe1@users.noreply.github.com>
.IP \[bu] 2
Anton Bordwine <54022438+antonchuvashow@users.noreply.github.com>
.IP \[bu] 2
mathieulongtin <617359+mathieulongtin@users.noreply.github.com>
.IP \[bu] 2
Luke Cyca <me@lukecyca.com>
.IP \[bu] 2
dlaumen <262192488+dlaumen@users.noreply.github.com>
.IP \[bu] 2
Yakov Till <37628546+Lyapsus@users.noreply.github.com>
.IP \[bu] 2
Chris Coughlan <chris@coughlan.io>
.IP \[bu] 2
John Volk <volkjohn@users.noreply.github.com>
.IP \[bu] 2
王一赫 <wyihe5220@gmail.com>
.IP \[bu] 2
Gustavo V.
F.
<31892323+Gustavo-V-F@users.noreply.github.com>
.IP \[bu] 2
Sven Rebhan <36194019+srebhan@users.noreply.github.com>
.IP \[bu] 2
Copilot <223556219+Copilot@users.noreply.github.com>
.IP \[bu] 2
KTibow <KTibow@users.noreply.github.com>
.IP \[bu] 2
kkocdko <31189892+kkocdko@users.noreply.github.com>
.IP \[bu] 2
Tim Schumacher <tim@tschumacher.net>
.IP \[bu] 2
ferrumclaudepilgrim <ferrumclaudepilgrim@users.noreply.github.com>
.IP \[bu] 2
Alvinwylim <31592545+Alvinwylim@users.noreply.github.com>
.IP \[bu] 2
Tore Anderson <tore@fud.no>
.IP \[bu] 2
Sai Asish Y <say.apm35@gmail.com>
.IP \[bu] 2
Lucky945H <1355363613@qq.com>
.IP \[bu] 2
William Tange <github@tan.ge>
.IP \[bu] 2
TaterLi <admin@lijingquan.net>
.IP \[bu] 2
KyokoMiki <161209740+kyokomiki@users.noreply.github.com>
.IP \[bu] 2
Iizuki <36295229+Iizuki@users.noreply.github.com>
.IP \[bu] 2
tomholford <16504501+tomholford@users.noreply.github.com>
<tomholford@users.noreply.github.com>
.IP \[bu] 2
caltechustc <caltechustc@outlook.com>
.IP \[bu] 2
Valerij Fredriksen <freva@users.noreply.github.com>
.IP \[bu] 2
Hakan İSMAİL <93117749+Hakanbaban53@users.noreply.github.com>
.IP \[bu] 2
Brian King <BrianDKing@gmail.com>
.IP \[bu] 2
Puneet Dixit <puneetdixit4321@gmail.com>
.IP \[bu] 2
Yakov Till <yakov.till@gmail.com>
.IP \[bu] 2
Janne Beate Bakeng <436265+jbbakeng@users.noreply.github.com>
.IP \[bu] 2
IceLocke <lockeice@gmail.com>
.IP \[bu] 2
nako-ruru <nako_ruru@163.com>
.IP \[bu] 2
bright <nako_ruru@sina.com>
.IP \[bu] 2
Filippo <57143294+FilippoMuschera@users.noreply.github.com>
.IP \[bu] 2
Gaurav <amvermagaurav007@gmail.com>
.IP \[bu] 2
Yuhang Cao <caoyuhang@fwerkor.com>
.IP \[bu] 2
Yash Anil <yashanil98@gmail.com>
.IP \[bu] 2
yashanil98 <79158725+yashanil98@users.noreply.github.com>
.IP \[bu] 2
lewoberst <github@jan-o-sch.net>
.IP \[bu] 2
max <max@example.com>
.IP \[bu] 2
Bryan Stenson <bryan.stenson@gmail.com>
.IP \[bu] 2
happysnaker <73147033+happysnaker@users.noreply.github.com>
.IP \[bu] 2
Jan Schlien <rclone-github@jan-o-sch.net>
.IP \[bu] 2
user77 <abubakarm@gmail.com>
.IP \[bu] 2
maximilize <3752128+maximilize@users.noreply.github.com>
.IP \[bu] 2
dithwick <46924962+dithwick@users.noreply.github.com>
.IP \[bu] 2
Sandy Luppino <s.luppino@opendrives.com>
.IP \[bu] 2
Sanjays2402 <51058514+Sanjays2402@users.noreply.github.com>
.IP \[bu] 2
blackflytech <blackflytech@outlook.com>
.IP \[bu] 2
Amit Mishra <amit.mishra.eee21@itbhu.ac.in>
.IP \[bu] 2
Erol Ozcan <erol.ozcan@gmail.com>
.IP \[bu] 2
TowyTowy <towy@airreps.link>
.IP \[bu] 2
0rangeSeaW0lf <0sw-8m4k2v@waku.li>
.IP \[bu] 2
sijie-Z <sijie-zhou@users.noreply.github.com>
.IP \[bu] 2
Søren Lindberg <deeferentleeg@gmail.com>.IP \[bu] 2
Kyue <Gooh456@users.noreply.github.com>
.IP \[bu] 2
Giridhar <80974392+giri256@users.noreply.github.com>
.IP \[bu] 2
p1 <giridharpavan593@gmail.com>
.IP \[bu] 2
Zero Services GmbH <info@zeroservices.eu>
.IP \[bu] 2
Noah Zalev <github@nzalev.ca>
.IP \[bu] 2
Acts1631 <69813585+acts-1631@users.noreply.github.com>
.IP \[bu] 2
ifloppy <68799904+ifloppy@users.noreply.github.com>
.IP \[bu] 2
Dzmitry Nianakhau <dzmitry.nianakhau@scality.com>
.IP \[bu] 2
Anupam Mediratta <mediratta@gmail.com>
.IP \[bu] 2
Socialpranker <273312799+Socialpranker@users.noreply.github.com>
.IP \[bu] 2
phatlc <phatle.hsd@gmail.com>
.IP \[bu] 2
Punya Jain <4511945+punya10@users.noreply.github.com>
.SH "ارتباط با پروژه rclone (CONTACT THE RCLONE PROJECT)"
.SS "انجمن گفتگو (Forum)"
.PP
انجمن گفتگو برای پرسش‌ها و بحث‌های عمومی:
.IP \[bu] 2
<https://forum.rclone.org>
.SS "پشتیبانی تجاری (Business support)"
.PP
برای پشتیبانی تجاری یا پرسش‌های مربوط به حمایت مالی، لطفاً مراجعه کنید به:
.IP \[bu] 2
<https://rclone.com>
.IP \[bu] 2
<sponsorship@rclone.com>
.SS "مخزن GitHub (GitHub repository)"
.PP
مخزن این پروژه در نشانی زیر قرار دارد:
.IP \[bu] 2
<https://github.com/rclone/rclone>
.PP
در آنجا می‌توانید گزارش‌های باگ را ثبت کرده یا با pull requestها در توسعه مشارکت کنید.
.SS "توییتر (Twitter)"
.PP
همچنین می‌توانید برای اطلاع از اطلاعیه‌های rclone، حساب Nick را در توییتر دنبال کنید:
.IP \[bu] 2
\[at]njcw (https://twitter.com/njcw)
.SS "ایمیل (Email)"
.PP
یا در صورتی که راه‌های دیگر میسر نشد، یا تمایل دارید موردی خصوصی یا محرمانه مطرح کنید:
.IP \[bu] 2
<info@rclone.com>
.PP
لطفاً درخواست‌های راهنمایی را به این نشانی ایمیل نکنید \- بهتر است این موارد در انجمن گفتگو مطرح شوند، مگر اینکه قصد داشته باشید برای پشتیبانی تجاری ثبت‌نام کنید.
.SH "نویسندگان (AUTHORS)"
Nick Craig-Wood.