.TH "rrsync" "1" "13 Aug 2026" "rrsync from rsync 3.5.0" "User Commands"
.\" prefix=/usr
.P
.SH "نام (NAME)"
.P
rrsync \- اسکریپتی برای راه‌اندازی کاربران محدودشدهٔ rsync از طریق ورودهای ssh
.P
.SH "خلاصه دستور (SYNOPSIS)"
.P
.nf
rrsync [-ro|-wo] [-munge] [-absolute] [-no-del] [-no-lock] [-no-overwrite] DIR
.fi
.P
تنها آرگومان غیرگزینه‌ای، \fIDIR\fP (دایرکتوری) محدودشده را برای استفاده مشخص می‌کند. این مسیر می‌تواند نسبت به دایرکتوری خانگی کاربر نسبی یا یک مسیر مطلق باشد.
.P
نسخهٔ برخط این صفحهٔ راهنما (که شامل پیوندهای متقابل مباحث است) در نشانی زیر در دسترس است:
.UR https://download.samba.org/pub/rsync/rrsync.1
.UE \&.
.P
.SH "توضیحات (DESCRIPTION)"
.P
ورود ssh یک کاربر را می‌توان به یکی از دو روش آسان، تنها به اجرای انتقال rsync محدود کرد:
.P
.IP o
اجبار به اجرای اسکریپت rrsync
.IP o
اجبار به اجرای دستور rsync daemon-over-ssh.
.P
هر دوی این پیکربندی‌ها از قابلیتی در ssh استفاده می‌کنند که اجازه می‌دهد به جای اجرای یک شل تعاملی، اجرای یک دستور مشخص تحمیل شود. با این حال، اگر شل خانگی کاربر bash است، لطفاً برای بررسی یک اشکال بالقوه، بخش «مسئله امنیتی BASH» را ببینید.
.P
برای استفاده از اسکریپت rrsync، فایل \fB~/.ssh/authorized_keys\fP کاربر را ویرایش کرده و پیشوندی شبیه به یکی از موارد زیر (به همراه یک فاصله پس از آن) در ابتدای هر خط کلید ssh که باید محدود شود قرار دهید:
.RS 4
.P
.nf
command="rrsync DIR"
command="rrsync -ro DIR"
command="rrsync -munge -no-del DIR"
.fi
.RE
.P
سپس اطمینان حاصل کنید که اسکریپت rrsync محدودیت‌های گزینه‌ای دلخواه شما را داشته باشد. اگر می‌خواهید چندین پیکربندی مختلف داشته باشید، ممکن است بخواهید اسکریپت را با نامی یکتا در یک دایرکتوری bin محلی کپی کنید. اگر می‌خواهید انتقال را بیشتر محدود کنید، می‌توان یک یا چند گزینهٔ rrsync را پیش از \fIDIR\fP تعیین کرد.
.P
برای استفاده از راه‌اندازی دیمن rsync، فایل \fB~/.ssh/authorized_keys\fP کاربر را ویرایش کرده و پیشوندی شبیه به یکی از موارد زیر (به همراه یک فاصله پس از آن) را در ابتدای هر خط کلید ssh که باید محدود شود بیفزایید:
.RS 4
.P
.nf
command="rsync --server --daemon ."
command="rsync --server --daemon --config=/PATH/TO/rsyncd.conf ."
.fi
.RE
.P
سپس، مطمئن شوید که فایل rsyncd.conf با یک یا چند نام ماژول همراه با مسیر و محدودیت‌های گزینه‌ایِ مناسب ایجاد شده باشد. اگر گزینهٔ \fB\-\-config\fP مربوط به rsync حذف شود، مقدار پیش‌فرض آن \fB~/rsyncd.conf\fP خواهد بود. برای جزئیات نحوهٔ پیکربندی دیمن rsync به صفحهٔ راهنمای \fBrsyncd.conf\fP(5) مراجعه کنید.
.P
هنگام استفاده از rrsync، تنها یک دایرکتوری محدودشده برای هر کلید مجاز (authorized key) می‌تواند وجود داشته باشد. در مقابل، پیکربندی دیمن اجازهٔ تعریف چندین نام ماژول را در فایل پیکربندی می‌دهد که هر کدام تنظیم مسیر ویژهٔ خود را دارند.
.P
ادامهٔ این صفحهٔ راهنما به استفاده از اسکریپت rrsync اختصاص دارد.
.P
.SH "گزینه‌ها (OPTIONS)"
.P
.IP "\fB\-ro\fP"
تنها اجازهٔ خواندن از DIR را می‌دهد. مستلزم گزینه‌های \fB\-no-del\fP و \fB\-no-lock\fP است.
.IP "\fB\-wo\fP"
تنها اجازهٔ نوشتن در DIR را می‌دهد.
.IP "\fB\-munge\fP"
گزینهٔ \fB\-\-munge\-links\fP مربوط به rsync را در سمت سرور فعال می‌کند.
.IP "\fB\-absolute\fP"
اجازه می‌دهد آرگومان‌های انتقال فایل، دایرکتوری محدودشده را با استفاده از مسیر مطلق آن در سرور نام‌گذاری کنند. برای نمونه، با \fBrrsync\ \-absolute\ /path/to/root\fP، آرگومان انتقال \fB/path/to/root/dir1\fP به عنوان نام مستعاری برای \fBdir1\fP پذیرفته می‌شود.
.IP "\fB\-no-del\fP"
گزینه‌های \fB\-\-delete*\fP و \fB\-\-remove*\fP مربوط به rsync را غیرفعال می‌کند.
.IP "\fB\-no-lock\fP"
از بررسی قفل تک‌اجرایی (به‌ازای هر کاربر) صرف‌نظر می‌کند. در ترکیب با \fB\-munge\fP سودمند است.
.IP "\fB\-no-overwrite\fP"
گزینهٔ \fB\-\-ignore\-existing\fP را در سمت سرور اعمال می‌کند. زمانی که سرور دریافت‌کننده است، از بازنویسی فایل‌های موجود جلوگیری می‌کند.
.IP
از آنجا که \fB\-\-ignore\-existing\fP تنها از فایلی که در حال انتقال است محافظت می‌کند، این گزینه همچنین گزینه‌هایی را که می‌توانند به یک فایل موجود \fIدیگر\fP در دایرکتوری محدودشده دسترسی پیدا کنند رد می‌کند: \fB\-\-log\-file\fP، \fB\-\-partial\-dir\fP، \fB\-\-delay\-updates\fP، و حالت پشتیبان‌گیری (\fB\-b\fP، \fB\-\-backup\-dir\fP، که پشتیبان منتشرشدهٔ آن جایگزین هر فایلی می‌شود که از قبل نام پشتیبان را اشغال کرده است). بنابراین، بارگذاری‌های با قابلیت ازسرگیری همراه با یک \fB\-\-partial\-dir\fP صریح، \fB\-\-delay\-updates\fP، و ثبت گزارش در سمت سرور تحت این گزینه در دسترس نیستند.
.IP "\fB\-help\fP, \fB\-h\fP"
این پیام راهنما را نمایش می‌دهد و خارج می‌شود.
.P
.SH "محدودیت‌های امنیتی (SECURITY RESTRICTIONS)"
.P
اسکریپت rrsync آرگومان‌های ارسالی مسیر را اعتبارسنجی می‌کند تا آن‌ها را به ماندن در محدودهٔ DIR مشخص‌شده محدود سازد.
.P
اسکریپت rrsync گزینهٔ \fB\-\-copy\-links\fP در rsync را (به‌طور پیش‌فرض) رد می‌کند تا یک عملیات کپی نتواند با دنبال کردن یک پیوند نمادین (symlink) درون DIR، به فایلی در خارج از DIR دسترسی یابد.
.P
اسکریپت rrsync گزینهٔ \fB\-\-protect\-args\fP (\fB\-s\fP) در rsync را رد می‌کند، زیرا این گزینه امکان ارسال گزینه‌هایی را به سمت سرور فراهم می‌کند که اسکریپت قادر به بررسی آن‌ها نیست. اگر می‌خواهید از \fB\-\-protect\-args\fP پشتیبانی کنید، از پیکربندی daemon-over-ssh استفاده کنید.
.P
اسکریپت rrsync تنها زیرمجموعه‌ای از گزینه‌های rsync را می‌پذیرد که rsync واقعی هنگام اجرای دستور سرور از آن‌ها استفاده می‌کند. چند گزینهٔ کمکی اضافی نیز برای تعامل با BackupPC و پذیرش برخی بازنویسی‌های کاربریِ مفید گنجانده شده است.
.P
در صورت تمایل به سفارشی‌سازی نحوهٔ پردازش گزینه‌ها، می‌توانید این اسکریپت (یا رونوشتی از آن) را به‌صورت دستی ویرایش کنید.
.P
.SH "مسئله امنیتی BASH (BASH SECURITY ISSUE)"
.P
اگر شل خانگی کاربران شما بر روی bash تنظیم شده باشد، bash ممکن است سعی کند بیش از حد مفید واقع شود و مطمئن شود که فایل‌های bashrc ورودِ کاربر پیش از اجرای دستور اجباری اجرا می‌شوند. این امر می‌تواند در صورتی که کاربر بتواند به‌نوعی فایل‌های bashrc خانگی خود را (شاید از طریق کپی محدودشده، یک دایرکتوری خانگی مشترک یا موارد مشابه) به‌روزرسانی کند، یک مشکل امنیتی ایجاد کند.
.P
یک راه ساده برای جلوگیری از این مسئله، تغییر شل کاربر به یک شل ساده‌تر مانند dash است. هنگام انتخاب شل خانگی جدید، مطمئن شوید که یک bash تغییرچهره‌داده‌شده را انتخاب نمی‌کنید، زیرا مشخص نیست که آیا از این مسئلهٔ امنیتی جلوگیری می‌کند یا خیر.
.P
راه‌حل بالقوهٔ دیگر این است که مطمئن شوید دایرکتوری خانگی کاربر یک سوارشدگی (mount) مشترک نیست و کاربر هیچ راهی برای کپی فایل‌ها به خارج از دایرکتوری‌های محدودشده‌اش ندارد. این ممکن است نیازمند فعال‌سازی اجباری تبدیل پیوندهای نمادین (symlink munging) در سمت سرور باشد.
.P
نسخه‌های آیندهٔ openssh ممکن است تغییری در مدیریت دستورهای اجباری داشته باشند که امکان اجتناب از استفاده از شل خانگی کاربر را فراهم کند.
.P
.SH "مثال‌ها (EXAMPLES)"
.P
فایل \fB~/.ssh/authorized_keys\fP ممکن است خطوطی مانند زیر داشته باشد:
.RS 4
.P
.nf
command="rrsync client/logs" ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAzG...
command="rrsync -ro results" ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAmk...
.fi
.RE
.P
.SH "فایل‌ها (FILES)"
.P
~/.ssh/authorized_keys
.P
.SH "همچنین ببینید (SEE ALSO)"
.P
\fBrsync\fP(1), \fBrsyncd.conf\fP(5)
.P
.SH "نسخه (VERSION)"
.P
این صفحهٔ راهنما مربوط به نسخهٔ 3.5.0 از rsync است.
.P
.SH "قدردانی و اعتبار (CREDITS)"
.P
ابزار rsync تحت «پروانه عمومی همگانی گنو» (GNU General Public License) توزیع می‌شود. برای جزئیات بیشتر به فایل COPYING مراجعه کنید.
.P
تارنمای rsync در نشانی
.UR https://rsync.samba.org
.UE
و پروژهٔ گیت‌هاب آن در
.UR https://github.com/RsyncProject/rsync
.UE \&
در دسترس است.
.P
.SH "نویسندگان (AUTHORS)"
.P
اسکریپت اولیهٔ rrsync با زبان perl توسط Joe Smith نوشته شده است. پس از آن افراد بسیاری در توسعهٔ آن مشارکت داشته‌اند. نسخهٔ python توسط Wayne Davison ایجاد شده است.