rsync-ssl(1) User Commands rsync-ssl(1)

rsync-ssl - اسکریپت کمکی برای اتصال به دیمن rsync مبتنی بر ssl

rsync-ssl [--type=SSL_TYPE] RSYNC_ARGS

نسخهٔ برخط این صفحهٔ راهنما (که شامل پیوند متقابل مباحث است) در https://download.samba.org/pub/rsync/rsync-ssl.1. در دسترس است.

اسکریپت rsync-ssl به شما کمک می‌کند تا عملیات کپی rsync را به/از یک دیمن rsync که نیازمند اتصالات ssl است اجرا کنید.

این اسکریپت ملزم می‌کند که آرگومان دیمن rsync را در قالب یکی از حالت‌های hostname:: (با ۲ دو‌نقطه) یا rsync://hostname/ مشخص کنید. درگاه پیش‌فرضی که برای اتصال استفاده می‌شود 874 است (یک شماره بالاتر از درگاه معمولی 873)، مگر اینکه در متغیرهای محیطی بازنویسی شده باشد. می‌توانید با استفاده از --port یا با قرار دادن آن در جایگاه معمول در قالب URL، درگاه جایگزین را مشخص کنید، هرچند هر دوی این موارد نیازمند آن هستند که نسخهٔ rsync شما حداقل 3.2.0 باشد.

اگر آرگومان نخست یک گزینهٔ --type=SSL_TYPE باشد، اسکریپت تنها از همان برنامهٔ مشخص‌شده برای برقراری اتصال ssl استفاده خواهد کرد، به جای اینکه تلاش کند با یک روش مکاشفه‌ای ساده یک فایل اجرایی openssl یا stunnel را بیابد (با این فرض که متغیر محیطی RSYNC_SSL_TYPE نیز تنظیم نشده باشد -- بخش زیر را ببینید). این گزینه باید یکی از مقادیر openssl یا stunnel را مشخص کند. علامت مساوی برای این گزینهٔ خاص الزامی است.

سایر گزینه‌ها همگی بدون تغییر به دستور rsync منتقل می‌شوند، بنابراین برای اطلاعات بیشتر دربارهٔ نحوهٔ کارکرد آن، به صفحهٔ راهنمای rsync(1) مراجعه کنید.

اسکریپت‌های کمکی ssl تحت تأثیر متغیرهای محیطی زیر قرار می‌گیرند:

نوع برنامه‌ای را مشخص می‌کند که باید برای برقراری اتصال ssl استفاده شود. این مقدار باید یکی از openssl یا stunnel باشد. گزینهٔ --type=SSL_TYPE در صورت مشخص شدن، این مقدار را لغو و بازنویسی می‌کند.
در صورت تعیین، این مقدار شماره درگاهی است که وقتی کاربر درگاهی را در دستور rsync خود مشخص نکرده باشد، به عنوان پیش‌فرض استفاده می‌شود. در صورت عدم تعیین، شماره درگاه پیش‌فرض 874 است. (توجه داشته باشید که نسخه‌های قدیمی‌تر rsync (پیش از 3.2.0) مقدار درگاه بازنویسی‌شده را به اسکریپت کمکی منتقل نمی‌کردند.)
در صورت تعیین، این مقدار نام فایلی است که حاوی گواهینامه‌ای برای استفاده در اتصال است.
در صورت تعیین، این مقدار نام فایلی است که حاوی کلید مربوط به گواهینامهٔ ارائه‌شده برای استفاده در اتصال است.
در صورت تعیین، این مقدار نام فایلی حاوی گواهینامهٔ مرجع صدور گواهی (CA) است که برای اعتبارسنجی اتصال استفاده می‌شود. هنگامی که تنظیم شود، گواهینامهٔ سرور در برابر این CA اعتبارسنجی می‌شود و نام آن نیز با میزبانی که به آن متصل می‌شوید (زنجیره و هویت) برای همهٔ موتورهای openssl، gnutls و stunnel تطبیق داده می‌شود. برای غیرفعال کردن کامل اعتبارسنجی گواهینامه (یک اتصال صرفاً رمزنگاری‌شده)، آن را روی یک رشتهٔ خالی تنظیم کنید.
برای مجاز کردن موتور stunnel به اجرا بدون گواهینامهٔ CA (و در نتیجه بدون هیچ‌گونه اعتبارسنجی گواهینامهٔ سرور)، مقدار آن را به 1 تنظیم کنید. بدون این مقدار، حالت stunnel از شروع به کار خودداری می‌کند مگر اینکه RSYNC_SSL_CA_CERT تنظیم شده باشد، چرا که یک اتصال TLS اعتبارسنجی‌نشده می‌تواند بدون سر و صدا مورد حملهٔ مرد میانی (man-in-the-middle) قرار گیرد.
برای بررسی زنجیرهٔ گواهینامه اما صرف‌نظر کردن از بررسی نام میزبان (هویت) در موتورهای openssl و stunnel، مقدار آن را به 1 تنظیم کنید. تنها زمانی از این متغیر استفاده کنید که گواهینامهٔ سرور به‌صورت موجه نتواند با میزبانی که به آن متصل می‌شوید مطابقت داشته باشد -- برای مثال اتصال مستقیم از طریق نشانی IP، یا به سروری که گواهینامهٔ CA داخلی آن نام متفاوتی دارد. زنجیرهٔ CA همچنان اعتبارسنجی می‌شود، بنابراین این حالت بسیار محدودتر از غیرفعال‌سازی کامل اعتبارسنجی با یک RSYNC_SSL_CA_CERT خالی است.
فایل اجرایی openssl را برای اجرا در زمانی که نوع اتصال روی openssl تنظیم شده است مشخص می‌کند. در صورت عدم تعیین، در مسیر $PATH به دنبال «openssl» جستجو می‌شود.
فایل اجرایی gnutls-cli را برای اجرا در زمانی که نوع اتصال روی gnutls تنظیم شده است مشخص می‌کند. در صورت عدم تعیین، در مسیر $PATH به دنبال «gnutls-cli» جستجو می‌شود.
فایل اجرایی stunnel را برای اجرا در زمانی که نوع اتصال روی stunnel تنظیم شده است مشخص می‌کند. در صورت عدم تعیین، در مسیر $PATH ابتدا به دنبال «stunnel4» و سپس «stunnel» جستجو می‌شود.

rsync-ssl -aiv example.com::mod/ dest
rsync-ssl --type=openssl -aiv example.com::mod/ dest
rsync-ssl -aiv --port 9874 example.com::mod/ dest
rsync-ssl -aiv rsync://example.com:9874/mod/ dest

برای دریافت راهنمایی دربارهٔ راه‌اندازی rsync با پشتیبانی از SSL/TLS، دستورالعمل‌های موجود در rsyncd.conf را ببینید.

rsync(1), rsyncd.conf(5)

توجه داشته باشید که استفاده از اتصال stunnel نیازمند حداقل نسخهٔ 4 از stunnel است، که در سیستم‌های امروزی باید چنین باشد. همچنین، اتصال را در برابر مجموعهٔ گواهینامه‌های CA بررسی نمی‌کند، بنابراین بدون هیچ‌گونه اعتبارسنجی گواهینامه تنها اتصال را رمزنگاری می‌کند، مگر اینکه گزینه‌های محیطی مربوط به گواهینامه را تعیین کرده باشید.

این اسکریپت همچنین از گزینهٔ --type=gnutls پشتیبانی می‌کند، اما در زمان انتشار این نسخه، دستور gnutls-cli خروجی را از دست می‌داد که آن را غیرقابل استفاده می‌کرد. اگر آن اشکال در نسخهٔ شما برطرف شده است، می‌توانید با خیال آسوده gnutls را در متغیر محیطیِ برون‌ریزی‌شدهٔ RSYNC_SSL_TYPE قرار دهید تا استفاده از آن به حالت پیش‌فرض تبدیل شود.

لطفاً باگ‌ها را گزارش دهید! وب‌سایت زیر را ببینید: https://rsync.samba.org.

این صفحهٔ راهنما برای نسخهٔ 3.5.0 از rsync به‌روز است.

نرم‌افزار Rsync تحت پروانه عمومی همگانی گنو (GNU General Public License) توزیع می‌شود. برای جزئیات بیشتر فایل COPYING را ببینید.

وب‌سایت پروژه در نشانی زیر در دسترس است: https://rsync.samba.org. این سایت شامل یک FAQ-O-Matic است که ممکن است به پرسش‌های بی‌پاسخ‌مانده در این صفحهٔ راهنما پاسخ دهد.

این صفحهٔ راهنما توسط Wayne Davison نوشته شده است.

فهرست‌های پستی برای پشتیبانی و توسعه در نشانی زیر در دسترس هستند: https://lists.samba.org.

13 Aug 2026 rsync-ssl from rsync 3.5.0