.TH "TORSOCKS" "8" "August 24th, 2013" "" ""

.SH "نام (NAME)"

torsocks \- کتابخانه رهگیری اتصالات خروجی شبکه و هدایت آن‌ها از طریق پروکسی SOCKS تور (Tor)

.SH "توضیحات (DESCRIPTION)"

کتابخانه Torsocks نمادهای libc مورد استفاده برای ارتباطات اینترنتی مانند فراخوانی سیستمی \fBconnect(2)\fP را سربارگذاری (overload) می‌کند. با استفاده از این روش، کتابخانه همه‌چیز از جمله وضوح نام DNS انجام‌شده توسط برنامه را از طریق شبکه تور (Tor) ارسال می‌کند.

برای DNS، توابع خانواده \fBgethostbyname(3)\fP از طریق تور بازمسیردهی می‌شوند. لطفاً توجه داشته باشید که رابط‌های برنامه‌نویسی res_* در ISC در حال حاضر پشتیبانی نمی‌شوند.

در اینجا مثالی از نحوه استفاده از کتابخانه torsocks با \fBssh(1)\fP آمده است:
.br

$ LD_PRELOAD=/path/to/libtorsocks.so ssh -l kalexander -p 1234 prism.nsa.gov
[...]

.SH "نحوه استفاده در پوسته (SHELL USAGE)"

متغیر LD_PRELOAD را برای بارگذاری کتابخانه تنظیم کرده و سپس برنامه‌ها را به صورت عادی اجرا کنید. ساختار دستوری برای پیش‌بارگذاری اجباری کتابخانه در پوسته‌های مختلف در زیر مشخص شده است:

پوسته‌های Bash، Ksh و Bourne:

$ export LD_PRELOAD=/path/to/libtorsocks.so

پوسته C Shell:

$ setenv LD_PRELOAD=/path/to/libtorsocks.so

این فرآیند را می‌توان (برای کاربران پوسته‌های Bash، Bourne و Korn) با استفاده از اسکریپت \fBtorsocks(1)\fP برای یک دستور منفرد یا برای تمامی دستورات در یک نشست پوسته خودکارسازی کرد.

همچنین می‌توانید \fBtorsocks(1)\fP را به گونه‌ای تنظیم کنید که تمام فرآیندها به‌طور خودکار از آن استفاده کنند که یک پیکربندی بسیار مفید است. لطفاً برای اطلاعات بیشتر به مستندات اسکریپت torsocks مراجعه فرمایید.

.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"

.PP
.IP TORSOCKS_CONF_FILE
این متغیر محیطی مسیر پیش‌فرض پرونده پیکربندی torsocks را لغو می‌کند. اگر برنامه‌ای که torsocks در آن تعبیه شده است دارای پرچم setuid باشد، این متغیر نادیده گرفته می‌شود.

.PP
.IP TORSOCKS_LOG_LEVEL
سطح ثبت وقایع کتابخانه torsocks را فعال می‌کند. به‌طور پیش‌فرض، هشدارها و خطاها چاپ می‌شوند (سطح ۳). توجه داشته باشید که هر سطح شامل سطوح پایین‌تر نیز می‌شود، به جز سطح ۱ که هرگونه ثبت وقایع را غیرفعال می‌کند. (پیش‌فرض: ۳)

.TS
tab (@);
l lx.
1@T{
هیچ لاگی ثبت نمی‌شود.
T}
2@T{
پیام‌های خطا.
T}
3@T{
پیام‌های هشدار.
T}
4@T{
پیام‌های اعلان (Notice).
T}
5@T{
پیام‌های اشکال‌زدایی (Debug).
T}
.TE

.PP
.IP TORSOCKS_LOG_TIME
تعیین می‌کند که آیا زمان به هر خط لاگ اضافه شود یا خیر. (پیش‌فرض: ۱)

.PP
.IP TORSOCKS_LOG_FILE_PATH
در صورت تنظیم، torsocks در پرونده تعیین‌شده توسط این متغیر لاگ خواهد انداخت. (پیش‌فرض: stderr)

.PP
.IP TORSOCKS_USERNAME
تنظیم نام کاربری برای روش احراز هویت SOCKS5. گذرواژه نیز باید با متغیر زیر تنظیم شود.

.PP
.IP TORSOCKS_PASSWORD
تنظیم گذرواژه برای روش احراز هویت SOCKS5. نام کاربری نیز باید با متغیر بالا تنظیم شود.

.PP
.IP TORSOCKS_TOR_ADDRESS
تنظیم نشانی IP شبکه تور. نام‌های میزبان در اینجا پشتیبانی نمی‌شوند. (پیش‌فرض: 127.0.0.1)

.PP
.IP TORSOCKS_TOR_PORT
تنظیم درگاه تور. (پیش‌فرض: 9050)

.PP
.IP TORSOCKS_ALLOW_INBOUND
اجازه دادن به اتصالات ورودی به‌طوری‌که برنامه بتواند اتصالات را بپذیرد و به آن‌ها گوش دهد.

.PP
.IP TORSOCKS_ISOLATE_PID
تنظیم خودکار نام کاربری و گذرواژه برای احراز هویت SOCKS5 بر اساس مقداری مبتنی بر PID/زمان جاری. نام کاربری و گذرواژه نباید تنظیم شده باشند.

.SH "مشکلات شناخته‌شده (KNOWN ISSUES)"

.SS DNS
برنامه Torsocks قادر به ارسال پرس‌وجوهای DNS از طریق تور نیست زیرا UDP پشتیبانی نمی‌شود؛ بنابراین هر سوکت UDP رد می‌شود. با این حال، پرس‌وجوهای DNS که قابل رهگیری باشند به تور ارسال شده و به فراخواننده بازگردانده می‌شوند.
.SS "خطاها (ERRORS)"
برنامه Torsocks ممکن است در صورت بروز مشکل در پرونده پیکربندی یا مذاکره SOCKS با دیمن تور، پیام‌های خطا تولید کرده و آن‌ها را در stderr چاپ کند. متغیر محیطی TORSOCKS_LOG_LEVEL و همچنین گزینه پرونده لاگ این رفتار را کنترل می‌کنند. به یاد داشته باشید که این کتابخانه می‌تواند در خروجی خطای استاندارد (stderr) برنامه خروجی تولید کند.

.SH "محدودیت‌ها (LIMITATIONS)"

تنها اتصالات خروجی TCP می‌توانند از طریق شبکه تور پروکسی شوند.
.PP
برنامه Torsocks تفکیک‌کننده نام libc را وادار می‌کند تا برای پرس‌وجوهای نام از TCP استفاده کند؛ این کار بدون توجه به اینکه DNS مورد پرس‌وجو محلی است یا خیر انجام می‌شود. این امر بار اضافی ایجاد می‌کند و فقط در صورت لزوم باید استفاده شود.
.PP
برنامه Torsocks از قابلیت‌های بارگذار پویای ELF برای رهگیری فراخوانی‌های پویای توابع از برنامه‌هایی که در آن‌ها تعبیه شده است استفاده می‌کند. در نتیجه، فایل‌های اجرایی غیر ELF یا فایل‌های اجرایی که مستقیماً با تله فراخوانی سیستمی (int 0x80) فراخوانی‌های سیستمی انجام می‌دهند پشتیبانی نمی‌شوند.

.SH "فایل‌ها (FILES)"
/etc/tor/torsocks.conf \- پرونده پیکربندی پیش‌فرض torsocks

.SH "همچنین ببینید (SEE ALSO)"
.BR torsocks.conf(5),
.BR torsocks(1)

.SH "نویسنده (AUTHOR)"
David Goulet <dgoulet@ev0ke.net>