'\" t
.\"     Title: proxytunnel
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-05-31
.\"    Manual: \ \&
.\"    Source: \ \& 1.13.0
.\"  Language: Persian
.\"
.TH "PROXYTUNNEL" "1" "2026\-05\-31" "\ \& 1\&.13\&.0" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
proxytunnel \- برنامه‌ای برای ایجاد تونل اتصال از طریق یک پراکسی استاندارد HTTPS
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBproxytunnel\fR [\fIOPTION\&...\fR]
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fBproxytunnel\fR ابزاری برای ایجاد تونل اتصال از طریق یک پراکسی استاندارد HTTPS و دور زدن سازوکارهای فیلترینگ استاندارد HTTP است\&. این ابزار بیشتر به‌عنوان پس‌بند برای ProxyCommand در OpenSSH و همچنین به‌عنوان پس‌بند پراکسی برای Putty استفاده می‌شود\&. همچنین می‌تواند برای سایر مقاصد گذر از پراکسی مانند proxy bouncing مورد استفاده قرار گیرد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-i\fR, \fB\-\-inetd\fR
.RS 4
اجرا از طریق inetd (پیش‌فرض: غیرفعال)\&.
.RE
.PP
\fB\-a\fR, \fB\-\-standalone\fR=[\fIaddress\fR:]\fIport\fR
.RS 4
اجرا به‌صورت دیمن مستقل روی
\fIaddress\fR
و
\fIport\fR
مشخص‌شده\&.
\fIaddress\fR
می‌تواند یک آدرس IPv4، یک آدرس IPv6 داخل کروشه، یا ترکیبی درون کروشه از آدرس IPv6، \*(Aq%\*(Aq و نام رابط شبکه (interface) باشد\&. قالب اخیر تنها برای آدرس‌های IPv6 از نوع link\-local الزامی است\&. در صورتی که
\fIaddress\fR
تعیین نشود، دیمن روی تمام آدرس‌ها شنود خواهد کرد\&.
.PP
\fBمثال‌ها\fR
.RS 4
22, 123\&.45\&.67\&.89:22, [2001:db8::123:4567:89ab:cdef]:22, [2001:db8::123:4567:89ab:cdef%eth0]:22
.RE
.RE
.PP
\fB\-p\fR, \fB\-\-proxy\fR=\fIhost\fR:\fIport\fR
.RS 4
استفاده از
\fIhost\fR
و
\fIport\fR
به‌عنوان پراکسی محلی (اصلی) برای اتصال؛ در صورت عدم تعیین، از مقدار متغیر محیطی
\fBHTTP_PROXY\fR
(در صورت تنظیم بودن) استفاده خواهد شد\&. تعیین این گزینه یا متغیر محیطی الزامی است\&.
.RE
.PP
\fB\-r\fR, \fB\-\-remproxy\fR=\fIhost\fR:\fIport\fR
.RS 4
استفاده از
\fIhost\fR
و
\fIport\fR
به‌عنوان پراکسی دوردست (ثانویه) برای برقراری اتصال\&.
.RE
.PP
\fB\-d\fR, \fB\-\-dest\fR=\fIhost\fR:\fIport\fR
.RS 4
استفاده از
\fIhost\fR
و
\fIport\fR
به‌عنوان مقصد تونل\&. استفاده از این گزینه الزامی است\&.
.RE
.PP
\fB\-e\fR, \fB\-\-encrypt\fR
.RS 4
رمزنگاری داده‌ها با SSL میان پراکسی محلی و مقصد\&.
.RE
.PP
\fB\-E\fR, \fB\-\-encrypt\-proxy\fR
.RS 4
رمزنگاری داده‌ها با SSL میان کلاینت و پراکسی محلی\&.
.RE
.PP
\fB\-X\fR, \fB\-\-encrypt\-remproxy\fR
.RS 4
رمزنگاری داده‌ها با SSL میان پراکسی محلی و پراکسی دوردست (ثانویه)\&.
.RE.SH "گزینه‌های اضافی (ADDITIONAL OPTIONS)"
.PP
\fB\-z\fR, \fB\-\-no\-check\-certificate\fR
.RS 4
هنگام برقراری یک اتصال SSL، گواهی SSL کارساز را اعتبارسنجی نکنید\&. به‌طور پیش‌فرض، گواهی SSL کارساز اعتبارسنجی می‌شود و نام میزبان هدف در برابر subject alternative names (نام‌های جایگزین موضوع) گواهی کارساز در صورت وجود، یا در صورت نبود آن‌ها در برابر common name (نام متداول) بررسی می‌شود\&.
.RE
.PP
\fB\-C\fR, \fB\-\-cacert\fR=\fIfilename/directory\fR
.RS 4
یک فایل گواهی CA (یا دایرکتوری حاوی گواهی‌های CA) را برای اعتماد هنگام اعتبارسنجی گواهی SSL کارساز مشخص کنید\&. اگر یک دایرکتوری ارائه شود، باید با ابزار c_rehash متعلق به OpenSSL آماده شده باشد (پیش‌فرض: /etc/ssl/certs، مگر اینکه در زمان کامپایل با استفاده از گزینه‌های DEFAULT_CA_FILE یا DEFAULT_CA_DIR تغییر یافته باشد)\&.
.RE
.PP
\fB\-4\fR, \fB\-\-ipv4\fR
.RS 4
اجبار به استفاده از IPv4 هنگام اتصال به پروکسی محلی\&.
.RE
.PP
\fB\-6\fR, \fB\-\-ipv6\fR
.RS 4
اجبار به استفاده از IPv6 هنگام اتصال به پروکسی محلی\&.
.RE
.PP
\fB\-F\fR, \fB\-\-passfile\fR=\fIfilename\fR
.RS 4
استفاده از
\fIfilename\fR
برای خواندن نام کاربری و گذرواژه جهت احراز هویت در پروکسی HTTPS؛ این فایل از همان قالب \&.wgetrc استفاده می‌کند و می‌تواند با wget به اشتراک گذاشته شود\&. برای پنهان کردن گذرواژه از دید سایر کاربران، از این گزینه یا متغیرهای محیطی استفاده کنید\&.
.RE
.PP
\fB\-P\fR, \fB\-\-proxyauth\fR=\fIusername\fR:\fIpassword\fR
.RS 4
استفاده از
\fIusername\fR
و
\fIpassword\fR
به‌عنوان اطلاعات کاربری جهت احراز هویت در یک پروکسی HTTPS محلی؛ نام کاربری و گذرواژه را می‌توان در متغیرهای محیطی
\fBPROXYUSER\fR
و
\fBPROXYPASS\fR
نیز مشخص کرد تا از سایر کاربران پنهان بمانند\&. اگر
\fIpassword\fR
حذف شود و هیچ متغیر محیطی
\fBPROXYPASS\fR
تنظیم نشده باشد، proxytunnel گذرواژه را درخواست خواهد کرد\&.
.RE
.PP
\fB\-R\fR, \fB\-\-remproxyauth\fR=\fIusername\fR:\fIpassword\fR
.RS 4
استفاده از
\fIusername\fR
و
\fIpassword\fR
به‌عنوان اطلاعات کاربری جهت احراز هویت در یک پروکسی HTTPS دوردست (ثانویه)؛ نام کاربری و گذرواژه را می‌توان در متغیرهای محیطی
\fBREMPROXYUSER\fR
و
\fBREMPROXYPASS\fR
نیز تعیین کرد تا از سایر کاربران پنهان بمانند\&. اگر
\fIpassword\fR
حذف شود و هیچ متغیر محیطی
\fBREMPROXYPASS\fR
تنظیم نشده باشد، proxytunnel گذرواژه را درخواست خواهد کرد\&.
.RE
.PP
\fB\-c\fR, \fB\-\-cert\fR=\fIfilename\fR
.RS 4
تعیین نام فایل حاوی گواهی کلاینت SSL برای احراز هویت با گواهی کلاینت در برابر پروکسی محلی، پروکسی دوردست یا مقصد\&. این فایل باید در قالب PEM باشد\&. علاوه بر این، ممکن است شامل یک یا چند گواهی میانی باشد که در سمت کارساز موجود نیستند، و عملاً یک زنجیره گواهی تشکیل می‌دهند\&. علاوه‌بر این، نیازمند تعیین
\fB\-k\fR,
\fB\-\-key\fR
است\&. اگر هیچ‌یک از گزینه‌های
\fB\-e\fR,
\fB\-\-encrypt\fR
یا
\fB\-E\fR,
\fB\-\-encrypt\-proxy\fR
یا
\fB\-X\fR,
\fB\-\-encrypt\-remproxy\fR
داده نشده باشند، نادیده گرفته می‌شود\&.
.RE
.PP
\fB\-k\fR, \fB\-\-key\fR=\fIfilename\fR
.RS 4
تعیین نام فایل حاوی کلید کلاینت SSL برای احراز هویت با گواهی کلاینت در برابر پروکسی محلی، پروکسی دوردست یا مقصد\&. فایل باید در قالب PEM باشد\&. علاوه‌بر این، نیازمند تعیین
\fB\-c\fR,
\fB\-\-cert\fR
است\&. اگر هیچ‌یک از گزینه‌های
\fB\-e\fR,
\fB\-\-encrypt\fR
یا
\fB\-E\fR,
\fB\-\-encrypt\-proxy\fR
یا
\fB\-X\fR,
\fB\-\-encrypt\-remproxy\fR
داده نشده باشند، نادیده گرفته می‌شود\&.
.RE
.PP
\fB\-N\fR, \fB\-\-ntlm\fR
.RS 4
استفاده از احراز هویت مبتنی بر NTLM\&.
.RE
.PP
\fB\-t\fR, \fB\-\-domain\fR=\fISTRING\fR
.RS 4
مشخص کردن دامنه NTLM (پیش‌فرض: تشخیص خودکار)\&.
.RE
.PP
\fB\-H\fR, \fB\-\-header\fR=\fISTRING\fR
.RS 4
افزودن سرآیندهای HTTP اضافی برای ارسال به پروکسی\&.
.RE
.PP
\fB\-o\fR, \fB\-\-host\fR=\fIhost\fR[:\fIport\fR]
.RS 4
ارسال یک سرآیند Host سفارشی\&. در اتصالات SSL مقدار
\fIhost\fR
به‌عنوان SNI نیز ارسال می‌شود\&.
.RE
.PP
\fB\-x\fR, \fB\-\-proctitle\fR=\fISTRING\fR
.RS 4
استفاده از یک عنوان فرآیند (process title) متفاوت\&.
.RE
.PP
\fB\-I\fR, \fB\-\-no\-sni\fR
.RS 4
غیرفعال‌سازی SNI\&.
.RE.SH "گزینه‌های متفرقه (MISCELLANEOUS OPTIONS)"
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
فعال‌سازی حالت پرگو (نمایش با جزئیات بیشتر)\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
پنهان‌سازی پیام‌ها (حالت بی‌صدا)\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش راهنما و خروج\&.
.RE
.PP
\fB\-V\fR, \fB\-\-version\fR
.RS 4
نمایش نسخه و خروج\&.
.RE
.SH "نحوه استفاده (USAGE)"
.sp
بسته به شرایط خود ممکن است بخواهید هر یک از کارهای زیر را انجام دهید:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBاتصال از طریق یک پروکسی محلی به سیستم خانگی روی درگاه ۲۲\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ proxytunnel \-v \-p proxy\&.company\&.com:8080 \-d system\&.home\&.nl:22
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBاتصال از طریق یک پروکسی محلی (همراه با احراز هویت) به سیستم خانگی\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ proxytunnel \-v \-p proxy\&.company\&.com:8080 \-P username:password \-d system\&.home\&.nl:22
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBاتصال از طریق یک پروکسی محلی (همراه با احراز هویت) با پنهان کردن گذرواژه\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ export PROXYPASS=password
$ proxytunnel \-v \-p proxy\&.company\&.com:8080 \-P username \-d system\&.home\&.nl:22
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBاتصال از طریق یک پروکسی محلی به یک پروکسی دوردست و جهش به هر سیستمی\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ proxytunnel \-v \-p proxy\&.company\&.com:8080 \-r proxy\&.athome\&.nl:443 \-d system\&.friend\&.nl:22
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBاتصال با استفاده از SSL از طریق یک پروکسی محلی به سیستم خانگی\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ proxytunnel \-v \-E \-p proxy\&.company\&.com:8080 \-d system\&.home\&.nl:22
.fi
.if n \{\
.RE
.\}
.RE.SH "پیکربندی OPENSSH (OPENSSH CONFIGURATION)"
.sp
برای استفاده از این برنامه به همراه OpenSSH جهت اتصال به یک میزبان، یک فایل \fI~/\&.ssh/config\fR با محتوای زیر ایجاد کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
Host system\&.athome\&.nl
    ProxyCommand proxytunnel \-p proxy\&.company\&.com:8080 \-d %h:%p
    ServerAliveInterval 30
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
.sp
دستورالعمل ServerAliveInterval تضمین می‌کند که اتصالات غیرفعال توسط دیواره‌های آتش میانی که نشست‌های فعال را به شکل تهاجمی قطع می‌کنند، بسته نشوند\&. اگر متوجه قطع شدن اتصال خود شدید، مقدار آن را باز هم کاهش دهید\&.
.sp .5v
.RE
.sp
برای استفاده از قابلیت فوروارد پورت پویا (SOCKS) در کلاینت SSH، می‌توانید دستورالعمل DynamicForward را در فایل ssh_config خود مانند زیر مشخص کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
Host system\&.athome\&.nl
    DynamicForward 1080
    ProxyCommand proxytunnel \-p proxy\&.company\&.com:8080 \-d %h:%p
    ServerAliveInterval 30
.fi
.if n \{\
.RE
.\}
.SH "نکات (NOTES)"
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBمهم\fR
.ps -1
.br
.sp
بیشتر پروکسی‌های HTTPS اجازه دسترسی به پورت‌هایی غیر از HTTPS (tcp/443) و SNEWS (tcp/563) را نمی‌دهند\&. در این حالت، برای عبور باید اطمینان حاصل کنید که دیمن SSH یا پروکسی دوردست روی سیستم مقصد به یکی از پورت‌های tcp/443 یا tcp/563 گوش می‌دهد\&.
.sp .5v
.RE
.SH "محیط (ENVIRONMENT)"
.sp
می‌توان با تنظیم متغیرهای محیطی زیر بر رفتار proxytunnel تأثیر گذاشت:
.PP
\fBHTTP_PROXY\fR
.RS 4
در صورت تنظیم این متغیر محیطی، اگر گزینه‌های
\fB\-p\fR
یا
\fB\-\-proxy\fR
ارائه نشده باشند، proxytunnel از آن به عنوان
\fIپروکسی محلی\fR
استفاده خواهد کرد\&.
.RE
.PP
\fBPROXYUSER\fR
.RS 4
در صورت تنظیم این متغیر محیطی، proxytunnel از آن به عنوان
\fIنام کاربری\fR
جهت احراز هویت در پروکسی استفاده خواهد کرد، مگر اینکه با گزینه
\fB\-P\fR
یا
\fB\-\-proxyauth\fR
مشخص شده باشد\&.
.RE
.PP
\fBPROXYPASS\fR
.RS 4
در صورت تنظیم این متغیر محیطی، proxytunnel از آن به عنوان
\fIگذرواژه\fR
جهت احراز هویت در پروکسی استفاده خواهد کرد، مگر اینکه با گزینه
\fB\-P\fR
یا
\fB\-\-proxyauth\fR
مشخص شده باشد\&.
.RE
.PP
\fBREMPROXYUSER\fR
.RS 4
در صورت تنظیم این متغیر محیطی، proxytunnel از آن به عنوان
\fIنام کاربری\fR
جهت احراز هویت در پروکسی دوردست (ثانویه) استفاده خواهد کرد، مگر اینکه با گزینه
\fB\-R\fR
یا
\fB\-\-remproxyauth\fR
مشخص شده باشد\&.
.RE
.PP
\fBREMPROXYPASS\fR
.RS 4
در صورت تنظیم این متغیر محیطی، proxytunnel از آن به عنوان
\fIگذرواژه\fR
جهت احراز هویت در پروکسی دوردست (ثانویه) استفاده خواهد کرد، مگر اینکه با گزینه
\fB\-R\fR
یا
\fB\-\-remproxyauth\fR
مشخص شده باشد\&.
.RE.SH "همچنین ببینید (SEE ALSO)"
.sp
.if n \{\
.RS 4
.\}
.nf
ssh(1), ssh_config(8)
.fi
.if n \{\
.RE
.\}
.SH "گزارش باگ‌ها (BUGS)"
.sp
این نرم‌افزار بدون باگ است، حداقل ما دوست داریم این‌طور فکر کنیم\&. اگر با ما هم‌نظر نیستید، لطفاً مدرک آن را با گزارش دوستانه خود در \m[blue]\fBhttps://github\&.com/proxytunnel/proxytunnel/issues\fR\m[] ارسال کنید :)
.SH "نویسندگان (AUTHORS)"
.sp
این صفحه راهنما در ابتدا توسط Lo\(:ic Le Guyader <\m[blue]\fBloic\&.leguyader@laposte\&.net\fR\m[]\&\s-2\u[1]\d\s+2> برای سیستم Debian GNU/Linux نوشته شد، در asciidoc توسط Dag Wie\(:ers <\m[blue]\fBdag@wieers\&.com\fR\m[]\&\s-2\u[2]\d\s+2> بازنویسی شد و اکنون توسط توسعه‌دهندگان Proxytunnel نگهداری می‌شود\&.
.sp
صفحه‌های وب در \m[blue]\fBhttps://proxytunnel\&.sourceforge\&.io\fR\m[] و \m[blue]\fBhttps://github\&.com/proxytunnel/proxytunnel\fR\m[]
.SH "نکات (NOTES)"
.IP " 1." 4
loic.leguyader@laposte.net
.RS 4
\%mailto:loic.leguyader@laposte.net
.RE
.IP " 2." 4
dag@wieers.com
.RS 4
\%mailto:dag@wieers.com
.RE