.TH "rsync-ssl" "1" "13 Aug 2026" "rsync-ssl from rsync 3.5.0" "User Commands"
.\" prefix=/usr
.P
.SH "نام (NAME)"
.P
rsync-ssl \- اسکریپت کمکی برای اتصال به دیمن rsync مبتنی بر ssl
.P
.SH "خلاصه دستور (SYNOPSIS)"
.P
.nf
rsync-ssl [--type=SSL_TYPE] RSYNC_ARGS
.fi
.P
نسخهٔ برخط این صفحهٔ راهنما (که شامل پیوند متقابل مباحث است) در
.UR https://download.samba.org/pub/rsync/rsync-ssl.1
.UE .
در دسترس است.
.P
.SH "توضیحات (DESCRIPTION)"
.P
اسکریپت rsync-ssl به شما کمک می‌کند تا عملیات کپی rsync را به/از یک دیمن rsync که نیازمند اتصالات ssl است اجرا کنید.
.P
این اسکریپت ملزم می‌کند که آرگومان دیمن rsync را در قالب یکی از حالت‌های
\fBhostname::\fP (با ۲ دو‌نقطه) یا \fBrsync://hostname/\fP مشخص کنید. درگاه پیش‌فرضی که برای اتصال استفاده می‌شود 874 است (یک شماره بالاتر از درگاه معمولی 873)، مگر اینکه در متغیرهای محیطی بازنویسی شده باشد. می‌توانید با استفاده از \fB\-\-port\fP یا با قرار دادن آن در جایگاه معمول در قالب URL، درگاه جایگزین را مشخص کنید، هرچند هر دوی این موارد نیازمند آن هستند که نسخهٔ rsync شما حداقل 3.2.0 باشد.
.P
.SH "گزینه‌ها (OPTIONS)"
.P
اگر آرگومان \fBنخست\fP یک گزینهٔ \fB\-\-type=SSL_TYPE\fP باشد، اسکریپت تنها از همان برنامهٔ مشخص‌شده برای برقراری اتصال ssl استفاده خواهد کرد، به جای اینکه تلاش کند با یک روش مکاشفه‌ای ساده یک فایل اجرایی openssl یا stunnel را بیابد (با این فرض که متغیر محیطی \fBRSYNC_SSL_TYPE\fP نیز تنظیم نشده باشد\ \-\- بخش زیر را ببینید). این گزینه باید یکی از مقادیر \fBopenssl\fP یا \fBstunnel\fP را مشخص کند. علامت مساوی برای این گزینهٔ خاص الزامی است.
.P
سایر گزینه‌ها همگی بدون تغییر به دستور rsync منتقل می‌شوند، بنابراین برای اطلاعات بیشتر دربارهٔ نحوهٔ کارکرد آن، به صفحهٔ راهنمای \fBrsync\fP(1) مراجعه کنید.
.P
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.P
اسکریپت‌های کمکی ssl تحت تأثیر متغیرهای محیطی زیر قرار می‌گیرند:
.P
.IP "\fBRSYNC_SSL_TYPE\fP"
نوع برنامه‌ای را مشخص می‌کند که باید برای برقراری اتصال ssl استفاده شود. این مقدار باید یکی از \fBopenssl\fP یا \fBstunnel\fP باشد. گزینهٔ \fB\-\-type=SSL_TYPE\fP در صورت مشخص شدن، این مقدار را لغو و بازنویسی می‌کند.
.IP "\fBRSYNC_SSL_PORT\fP"
در صورت تعیین، این مقدار شماره درگاهی است که وقتی کاربر درگاهی را در دستور rsync خود مشخص نکرده باشد، به عنوان پیش‌فرض استفاده می‌شود. در صورت عدم تعیین، شماره درگاه پیش‌فرض 874 است. (توجه داشته باشید که نسخه‌های قدیمی‌تر rsync (پیش از 3.2.0) مقدار درگاه بازنویسی‌شده را به اسکریپت کمکی منتقل نمی‌کردند.)
.IP "\fBRSYNC_SSL_CERT\fP"
در صورت تعیین، این مقدار نام فایلی است که حاوی گواهینامه‌ای برای استفاده در اتصال است.
.IP "\fBRSYNC_SSL_KEY\fP"
در صورت تعیین، این مقدار نام فایلی است که حاوی کلید مربوط به گواهینامهٔ ارائه‌شده برای استفاده در اتصال است.
.IP "\fBRSYNC_SSL_CA_CERT\fP"
در صورت تعیین، این مقدار نام فایلی حاوی گواهینامهٔ مرجع صدور گواهی (CA) است که برای اعتبارسنجی اتصال استفاده می‌شود. هنگامی که تنظیم شود، گواهینامهٔ سرور در برابر این CA اعتبارسنجی می‌شود \fBو\fP نام آن نیز با میزبانی که به آن متصل می‌شوید (زنجیره و هویت) برای همهٔ موتورهای openssl، gnutls و stunnel تطبیق داده می‌شود. برای غیرفعال کردن کامل اعتبارسنجی گواهینامه (یک اتصال صرفاً رمزنگاری‌شده)، آن را روی یک رشتهٔ خالی تنظیم کنید.
.IP "\fBRSYNC_SSL_ALLOW_INSECURE_STUNNEL\fP"
برای مجاز کردن موتور stunnel به اجرا بدون گواهینامهٔ CA (و در نتیجه بدون هیچ‌گونه اعتبارسنجی گواهینامهٔ سرور)، مقدار آن را به \fB1\fP تنظیم کنید. بدون این مقدار، حالت stunnel از شروع به کار خودداری می‌کند مگر اینکه \fBRSYNC_SSL_CA_CERT\fP تنظیم شده باشد، چرا که یک اتصال TLS اعتبارسنجی‌نشده می‌تواند بدون سر و صدا مورد حملهٔ مرد میانی (man-in-the-middle) قرار گیرد.
.IP "\fBRSYNC_SSL_SKIP_HOSTNAME_CHECK\fP"
برای بررسی \fBزنجیرهٔ\fP گواهینامه اما صرف‌نظر کردن از بررسی \fBنام میزبان\fP (هویت) در موتورهای openssl و stunnel، مقدار آن را به \fB1\fP تنظیم کنید. تنها زمانی از این متغیر استفاده کنید که گواهینامهٔ سرور به‌صورت موجه نتواند با میزبانی که به آن متصل می‌شوید مطابقت داشته باشد\ \-\- برای مثال اتصال مستقیم از طریق نشانی IP، یا به سروری که گواهینامهٔ CA داخلی آن نام متفاوتی دارد. زنجیرهٔ CA همچنان اعتبارسنجی می‌شود، بنابراین این حالت بسیار محدودتر از غیرفعال‌سازی کامل اعتبارسنجی با یک \fBRSYNC_SSL_CA_CERT\fP خالی است.
.IP "\fBRSYNC_SSL_OPENSSL\fP"
فایل اجرایی openssl را برای اجرا در زمانی که نوع اتصال روی openssl تنظیم شده است مشخص می‌کند. در صورت عدم تعیین، در مسیر $PATH به دنبال «openssl» جستجو می‌شود.
.IP "\fBRSYNC_SSL_GNUTLS\fP"
فایل اجرایی gnutls-cli را برای اجرا در زمانی که نوع اتصال روی gnutls تنظیم شده است مشخص می‌کند. در صورت عدم تعیین، در مسیر $PATH به دنبال «gnutls-cli» جستجو می‌شود.
.IP "\fBRSYNC_SSL_STUNNEL\fP"
فایل اجرایی stunnel را برای اجرا در زمانی که نوع اتصال روی stunnel تنظیم شده است مشخص می‌کند. در صورت عدم تعیین، در مسیر $PATH ابتدا به دنبال «stunnel4» و سپس «stunnel» جستجو می‌شود.
.P
.SH "مثال‌ها (EXAMPLES)"
.RS 4
.P
.nf
rsync-ssl -aiv example.com::mod/ dest
.fi
.RE
.RS 4
.P
.nf
rsync-ssl --type=openssl -aiv example.com::mod/ dest
.fi
.RE
.RS 4
.P
.nf
rsync-ssl -aiv --port 9874 example.com::mod/ dest
.fi
.RE
.RS 4
.P
.nf
rsync-ssl -aiv rsync://example.com:9874/mod/ dest
.fi
.RE
.P
.SH "سمت سرور (THE SERVER SIDE)"
.P
برای دریافت راهنمایی دربارهٔ راه‌اندازی rsync با پشتیبانی از SSL/TLS، دستورالعمل‌های موجود در rsyncd.conf را ببینید.
.P
.SH "همچنین ببینید (SEE ALSO)"
.P
\fBrsync\fP(1), \fBrsyncd.conf\fP(5)
.P
.SH "هشدارها (CAVEATS)"
.P
توجه داشته باشید که استفاده از اتصال stunnel نیازمند حداقل نسخهٔ 4 از stunnel است، که در سیستم‌های امروزی باید چنین باشد. همچنین، اتصال را در برابر مجموعهٔ گواهینامه‌های CA بررسی نمی‌کند، بنابراین بدون هیچ‌گونه اعتبارسنجی گواهینامه تنها اتصال را رمزنگاری می‌کند، مگر اینکه گزینه‌های محیطی مربوط به گواهینامه را تعیین کرده باشید.
.P
این اسکریپت همچنین از گزینهٔ \fB\-\-type=gnutls\fP پشتیبانی می‌کند، اما در زمان انتشار این نسخه، دستور gnutls-cli خروجی را از دست می‌داد که آن را غیرقابل استفاده می‌کرد. اگر آن اشکال در نسخهٔ شما برطرف شده است، می‌توانید با خیال آسوده gnutls را در متغیر محیطیِ برون‌ریزی‌شدهٔ RSYNC_SSL_TYPE قرار دهید تا استفاده از آن به حالت پیش‌فرض تبدیل شود.
.P
.SH "گزارش باگ‌ها (BUGS)"
.P
لطفاً باگ‌ها را گزارش دهید! وب‌سایت زیر را ببینید:
.UR https://rsync.samba.org
.UE .
.P
.SH "نسخه (VERSION)"
.P
این صفحهٔ راهنما برای نسخهٔ 3.5.0 از rsync به‌روز است.
.P
.SH "قدردانی‌ها (CREDITS)"
.P
نرم‌افزار Rsync تحت پروانه عمومی همگانی گنو (GNU General Public License) توزیع می‌شود. برای جزئیات بیشتر فایل COPYING را ببینید.
.P
وب‌سایت پروژه در نشانی زیر در دسترس است:
.UR https://rsync.samba.org
.UE .
این سایت شامل یک FAQ-O-Matic است که ممکن است به پرسش‌های بی‌پاسخ‌مانده در این صفحهٔ راهنما پاسخ دهد.
.P
.SH "نویسندگان (AUTHORS)"
.P
این صفحهٔ راهنما توسط Wayne Davison نوشته شده است.
.P
فهرست‌های پستی برای پشتیبانی و توسعه در نشانی زیر در دسترس هستند:
.UR https://lists.samba.org
.UE .