.\" $Id: socks.conf.5,v 1.80.10.1 2021/02/17 09:09:26 michaels Exp $
.\"
.\" Copyright (c) 1997, 1998, 1999, 2000, 2001, 2003, 2005, 2008, 2009, 2010,
.\"               2011, 2012, 2013
.\"      Inferno Nettverk A/S, Norway.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. The above copyright notice, this list of conditions and the following
.\"    disclaimer must appear in all copies of the software, derivative works
.\"    or modified versions, and any portions thereof, aswell as in all
.\"    supporting documentation.
.\" 2. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"      This product includes software developed by
.\"      Inferno Nettverk A/S, Norway.
.\" 3. The name of the author may not be used to endorse or promote products
.\"    derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\" Inferno Nettverk A/S requests users of this software to return to
.\"
.\"  Software Distribution Coordinator  or  sdc@inet.no
.\"  Inferno Nettverk A/S
.\"  Oslo Research Park
.\"  Gaustadalleen 21
.\"  NO-0349 Oslo
.\"  Norway
.\"
.\" any improvements or extensions that they make and grant Inferno Nettverk A/S
.\" the rights to redistribute these changes.
.\"
.TH SOCKS.CONF 5 "2013-07-29"
.SH "نام (NAME)"
socks.conf \- نحو و ساختار فایل پیکربندی کلاینت SOCKS
.SH "توضیحات (DESCRIPTION)"
فایل پیکربندی برای کتابخانه کلاینت ساکس (socks)، امکان کنترل و نظارت بر ثبت گزارش‌ها (logging) و انتخاب کارساز را فراهم می‌کند. این فایل به دو بخش تقسیم می‌شود:
تنظیمات سراسری و مسیرها. یک خط را می‌توان با استفاده از نویسه استاندارد یادداشت
\fB#\fP
به یادداشت (کامنت) تبدیل کرد.
.SH "قالب (FORMAT)"
تنظیمات سراسری به شکل یک کلیدواژه و به دنبال آن یک دونقطه (:) و سپس مقدار مربوطه هستند.
.TP
\fBdebug\fP
تنظیم این فیلد روی 1، قابلیت اشکال‌زدایی را فعال می‌کند.
.TP
\fBlogoutput\fP
این مقدار تعیین می‌کند که کتابخانه کلاینت خروجی گزارش‌ها را به کجا ارسال کند. این مقدار می‌تواند
\fBsyslog\fP،
\fBstdout\fP،
\fBstderr\fP،
یک نام فایل یا ترکیبی از آن‌ها باشد. حالت پیش‌فرض، عدم ثبت گزارش است. توجه داشته باشید که اگر برنامه ساکس‌شده خود نیز از syslog استفاده کند، ممکن است مقدار
\fBsyslog\fP
با آن تداخل پیدا کند.
.IP \fBresolveprotocol\fP
پروتکل مورد استفاده برای تفکیک نام‌های میزبان (resolve hostnames).
مقادیر معتبر عبارتند از \fBudp\fP، \fBtcp\fP و \fBfake\fP. مقدار پیش‌فرض
\fBudp\fP
است.
.IP \fBroute.badexpire\fP
مدت زمانی که نشانه‌گذاری "خراب" (bad) برای یک مسیر پیش از حذف شدن باید معتبر بماند. مقدار پیش‌فرض ۳۰۰ ثانیه است.
.IP \fBroute.maxfail\fP
تعداد دفعاتی که یک مسیر می‌تواند پیش از علامت‌گذاری به عنوان خراب با شکست مواجه شود. مقدار پیش‌فرض ۱ است.
.IP \fBtimeout.connect\fP
تعداد ثانیه‌هایی که کلاینت منتظر تکمیل اتصال به کارساز پراکسی می‌ماند. مقدار پیش‌فرض 0 است، که مشخص می‌کند کلاینت باید از مقدار پیش‌فرض سیستم استفاده کند.
.SH "مسیرها (ROUTES)"
مسیرها با کلیدواژه
\fBroute\fP
مشخص می‌شوند. در داخل یک جفت آکولاد ({})، مجموعه‌ای از کلیدواژه‌ها رفتار مسیر را کنترل می‌کنند.
هر
\fBroute\fP
می‌تواند شامل سه مشخصه آدرس باشد:
\fBfrom\fP،
\fBto\fP
و
\fBvia\fP.
یک مسیر برای اتصال بر اساس مقادیر داخل بلوک
\fBroute\fP
انتخاب می‌شود.
.PP
هنگام جستجو برای مسیری که با درخواست کلاینت تطابق داشته باشد، کتابخانه ابتدا به دنبال یک مسیر مستقیم
(\fBdirect\fP)
می‌گردد. سپس به دنبال یک مسیر
\fBsocks_v4\fP،
یک مسیر
\fBsocks_v5\fP،
یک مسیر
\fBhttp\fP
و در نهایت به دنبال یک مسیر
\fBupnp\fP
خواهد گشت.
.PP
بسته به نحوه پیکربندی کتابخانه و متغیرهای محیطی تنظیم‌شده (راهنمای
.BR socksify (1)
را ببینید)، در صورتی که هیچ مسیر دیگری یافت نشود، ممکن است یک بازگشت خودکار به یک مسیر مستقیم خودکار تولیدشده
(\fBdirect\fP)
وجود داشته باشد یا خیر.
.PP
بلوک
\fBroute\fP
می‌تواند شامل موارد زیر باشد:

.IP \fBآدرس‌ها (ADDRESSES)\fP
هر فیلد آدرس می‌تواند شامل یک آدرس IP (و در صورت کاربرد، یک ماسک شبکه که با علامت '\fB/\fP' از آدرس IP جدا می‌شود)، یک نام میزبان، یک نام دامنه (که با نقطه ابتدایی '\fB.\fP' مشخص می‌شود) یا یک نام رابط شبکه (در صورت نیاز) باشد.
به دنبال هر آدرس می‌تواند یک مشخص‌کننده اختیاری
\fBport\fP
قرار گیرد.

.IP \fBfrom\fP
مسیر تنها برای درخواست‌هایی استفاده می‌شود که از آدرس داده‌شده به عنوان مقدار مبدا می‌آیند.
.IP \fBto\fP
مسیر تنها برای درخواست‌هایی استفاده می‌شود که به مقصد آدرس داده‌شده به عنوان مقدار ارسال می‌شوند.
.IP \fBvia\fP
آدرس کارساز پراکسی که باید به عنوان درگاه (gateway) برای اتصال استفاده شود، یا مقدار ویژه
\fBdirect\fP
برای نشان دادن اینکه اتصال باید به جای عبور از هرگونه کارساز پراکسی، به طور مستقیم برقرار شود.
.PP
در مورد
\fBupnp\fP،
اگر نشانی اینترنتی (URL) کامل مربوط به IGD هنوز مشخص نشده باشد، این آدرس همچنین می‌تواند نام رابط شبکه‌ای باشد که برای شناسایی نقطه کنترل upnp به کار می‌رود، یا مقدار ویژه
\fBbroadcast\fP
برای نشان دادن اینکه کلاینت باید برای یافتن یک مسیریاب upnp روی تمام رابط‌های شبکه موجود فراخوانی همگانی انجام دهد.

.IP \fBport\fP
پارامتری برای
\fBfrom\fP،
\fBto\fP
و
\fBvia\fP.
کلیدواژه‌های
\fBeq/=, ne/!=, ge/>=, le/<=, gt/>, lt/<\fP
را به همراه یک عدد می‌پذیرد. همچنین می‌توان یک محدوده درگاه را به صورت "port <start #> \- <end #>" تعیین کرد که با تمام شماره درگاه‌های درون محدوده <start #> و <end #> مطابقت خواهد داشت.

.SH "گزینه‌ها (OPTIONS)"
.IP \fBclientcompatibility\fP
گزینه‌های مشخصی را برای سازگاری با کارسازهای دارای نقص فعال می‌کند. مقادیر معتبر عبارتند از:
\fBnecgssapi\fP،
برای سازگاری با کارسازهایی که gssapi را به روش NEC socks پیاده‌سازی کرده‌اند.
.IP \fBcommand\fP
دستوراتی که کارساز از آن‌ها پشتیبانی می‌کند. دستورات معتبر عبارتند از
\fBbind\fP،
\fBbindreply\fP،
\fBconnect\fP،
\fBudpassociate\fP
و
\fBudpreply\fP.
مقدار پیش‌فرض، تمامی دستوراتی است که پروتکل‌های تعیین‌شده برای مسیر از آن‌ها پشتیبانی می‌کنند.
.PP
می‌تواند به جای
\fBprotocol\fP
یا به عنوان مکمل آن استفاده شود.
.IP \fBgssapi.enctype\fP
نوع رمزگذاری که باید برای ارتباطات احراز هویت‌شده با GSSAPI اعمال شود. مقادیر ممکن عبارتند از
\fBclear\fP،
\fBintegrity\fP
یا
\fBconfidentiality\fP.
حالت پیش‌فرض این است که برای محرمانگی (confidentiality) تلاش شود، اما هر آنچه را که کارساز به جز
\fBclear\fP
ارائه دهد می‌پذیرد، زیرا
\fBclear\fP
بخشی از استاندارد SOCKS GSSAPI نیست.
.IP \fBgssapi.servicename\fP
نام سرویسی که هنگام استفاده از GSSAPI به کار می‌رود. مقدار پیش‌فرض "rcmd" است.

.IP \fBmethod\fP
فهرست روش‌های احراز هویت که
\fBکلاینت\fP
از آن‌ها پشتیبانی می‌کند و به کارساز پیشنهاد می‌دهد. مقادیر پشتیبانی‌شده در حال حاضر عبارتند از
\fBnone\fP،
\fBgssapi\fP
و
\fBusername\fP.
مقدار پیش‌فرض، تمامی روش‌های پشتیبانی‌شده است.
.IP \fBprotocol\fP
پروتکل‌هایی که کارساز پشتیبانی می‌کند. مقادیر پشتیبانی‌شده
\fBtcp\fP
و
\fBudp\fP
هستند. مقدار پیش‌فرض، تمامی پروتکل‌های پشتیبانی‌شده است.
.IP \fBproxyprotocol\fP
پروتکل‌های پراکسی که کارساز از آن‌ها پشتیبانی می‌کند. مقادیر پشتیبانی‌شده در حال حاضر عبارتند از
\fBsocks_v4\fP،
\fBsocks_v5\fP،
\fBhttp\fP
و
\fBupnp\fP.
مقدار پیش‌فرض
\fBsocks_v4\fP
و
\fBsocks_v5\fP
است.
توجه داشته باشید که اگر کارساز ساکس به هر شکلی از احراز هویت نیاز داشته باشد، باید صریحاً این گزینه را روی
\fBsocks_v5\fP
تنظیم کنید، زیرا نگارش ۴ از احراز هویت پشتیبانی نمی‌کند.
.SH "مثال‌ها (EXAMPLES)"
دایرکتوری مثال‌ها (example) را در بسته توزیع‌شده مشاهده کنید.
.SH "محیط (ENVIRONMENT)"
.TP
\fBSOCKS_USERNAME\fP
هنگام انجام احراز هویت با نام کاربری، از مقدار
\fBSOCKS_USERNAME\fP
به عنوان نام کاربری استفاده می‌کند.
.TP
\fBSOCKS_PASSWORD\fP
هنگام انجام احراز هویت با نام کاربری، از مقدار
\fBSOCKS_PASSWORD\fP
به عنوان گذرواژه استفاده می‌کند. این کار توصیه نمی‌شود، زیرا سایر کاربران روی سیستم ممکن است بتوانند گذرواژه شما را مشاهده کنند.
.TP
\fBSOCKS_AUTOADD_LANROUTES\fP
اگر این متغیر روی "no" تنظیم شده باشد، کلاینت برای افزودن خودکار مسیرهای مستقیم برای تمام آدرس‌های روی شبکه محلی (LAN) تلاش نخواهد کرد. پیش‌فرض این است که آن‌ها را اضافه کند.
.TP
\fBSOCKS_DISABLE_THREADLOCK\fP
اگر این متغیر تنظیم شده باشد، کلاینت قفل‌گذاری ریسه‌ها (threadlocking) را انجام نمی‌دهد. پیش‌فرض این است که کلاینت خود تلاش کند تشخیص دهد آیا برنامه‌ای که باید ساکس‌سازی شود نیاز به قفل‌گذاری ریسه دارد یا خیر.
.PP
برخی از متغیرهای محیطی تکمیلی در
.BR socksify (1)
مستند شده‌اند.
.SH "فایل‌ها (FILES)"
.I /etc/socks.conf
.SH "نویسندگان (AUTHORS)"
برای Inferno Nettverk A/S:
.PP
.nf
   Michael Shuldman
   Karl\-Andre' Skevik
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR socksify (1)،
.BR sockd (8)،
.BR sockd.conf (5)

.PP
اطلاعات مربوط به نگارش‌های جدید و سایر موضوعات مرتبط را می‌توان در صفحه خانگی وب
\fBDante\fP
یافت: http://www.inet.no/dante

.SH "اشکالات (BUGS)"
فایل همراه BUGS را ببینید. موارد جدید باید به
dante\-bugs@inet.no
گزارش شوند.