TINCD(8) System Manager's Manual TINCD(8)

tincd — دیمن شبکه خصوصی مجازی (VPN) تینک

tincd [-cdDkKnoLRU] [--config=DIR] [--no-detach] [--debug[=LEVEL]] [--kill[=SIGNAL]] [--net=NETNAME] [--generate-keys[=BITS]] [--option=[HOST.]KEY=VALUE] [--mlock] [--logfile[=FILE]] [--pidfile=FILE] [--bypass-security] [--chroot] [--user=USER] [--help] [--version]

این دیمنِ tinc، یک پروژه شبکه خصوصی مجازی امن (VPN) است. هنگام راه‌اندازی، tincd فایل پیکربندی خود را می‌خواند تا مشخص کند به کدام زیرشبکه‌های مجازی باید سرویس‌دهی کند و به کدام دیمن‌های tinc دیگر باید متصل شود. این دیمن به دستگاه ethertap یا tun/tap متصل می‌شود و یک سوکت برای اتصالات ورودی برپا می‌کند. به‌صورت اختیاری، یک اسکریپت برای پیکربندی بیشتر دستگاه مجازی اجرا خواهد شد. اگر این کار با موفقیت انجام شود، از ترمینال کنترلی جدا شده و در پس‌زمینه به کار خود ادامه می‌دهد، و اتصال‌ها به دیمن‌های tinc دیگر را که بخشی از شبکه خصوصی مجازی هستند پذیرفته و برقرار می‌سازد. در ویندوز (غیر از Cygwin)، tinc خود را به‌صورت یک سرویس نصب می‌کند که پس از راه‌اندازی مجدد سیستم به‌طور خودکار اجرا خواهد شد.

--config=DIR
خواندن فایل‌های پیکربندی از DIR به‌جای /etc/tinc/.
--no-detach
انشعاب نیافتن (عدم fork) و جدا نشدن از ترمینال. این گزینه همچنین سازوکار راه‌اندازی مجدد خودکار را برای خطاهای مهلک غیرفعال می‌کند. در صورت عدم تعیین خلاف آن، پیام‌های لاگ روی خروجی خطای استاندارد نمایش داده می‌شوند.
--debug[=LEVEL]
افزایش سطح اشکال‌زدایی یا تنظیم آن روی LEVEL (بخش زیر را ببینید).
--kill[=SIGNAL]
تلاش برای خاتمه دادن به یک پردازش در حال اجرای tincd (به‌صورت اختیاری با SIGNAL مشخص‌شده به‌جای SIGTERM) و سپس خروج. در ویندوز (غیر از Cygwin) آرگومان اختیاری نادیده گرفته شده و سرویس همیشه متوقف و حذف می‌شود.
--net=NETNAME
اتصال به شبکه NETNAME. این گزینه باعث می‌شود tinc تمام فایل‌های پیکربندی را از /etc/tinc/ NETNAME بخواند. مشخص کردن . برای NETNAME همانند مشخص نکردن هیچ NETNAME است.
--generate-keys[=BITS]
تولید جفت‌کلید عمومی/خصوصی RSA و خروج. اگر BITS مشخص نشود، طول پیش‌فرض ۲۰۴۸ بیت خواهد بود. هنگام ذخیره کلیدها در فایل‌های موجود، tinc کلیدهای قدیمی را حذف نخواهد کرد و باید آن‌ها را به‌صورت دستی پاک کنید.
--option=[HOST.]KEY=VALUE
بدون مشخص کردن HOST ، این گزینه متغیر پیکربندی سرور KEY را روی VALUE تنظیم می‌کند. اگر به‌صورت HOST.KEY=VALUE مشخص شود، متغیر پیکربندی میزبان KEY از میزبانی با نام HOST را روی VALUE تنظیم می‌نماید. این گزینه می‌تواند بیش از یک بار برای تعیین چندین متغیر پیکربندی استفاده شود.
--mlock
قفل کردن tinc در حافظه اصلی (RAM). این کار از نوشتن داده‌های حساس مانند کلیدهای خصوصی مشترک در فایل‌ها یا پارتیشن‌های مبادله (swap) سیستم جلوگیری می‌کند.
[=FILE]
نوشتن لاگ‌ها در یک فایل به‌جای ارسال به سرویس لاگ‌گیری سیستم (syslog). اگر FILE مشخص نشود، مقدار پیش‌فرض /var/log/tinc.NETNAME.log خواهد بود.
=FILE
نوشتن شناسه پردازش (PID) در FILE به‌جای /var/run/tinc.NETNAME.pid. در ویندوز این گزینه نادیده گرفته می‌شود.
غیرفعال‌سازی رمزنگاری و احراز هویت پروتکل متا (meta protocol). فقط برای اشکال‌زدایی کاربرد دارد.
--chroot
با این گزینه، tinc پس از مقداردهی اولیه به دایرکتوری محل قرارگیری پیکربندی شبکه (/etc/tinc/NETNAME در صورت استفاده از گزینه -n، یا دایرکتوری مشخص‌شده با گزینه -c) تغییر ریشه (chroot) می‌دهد.
--user=USER
تغییر شناسه کاربری (setuid) به USER مشخص‌شده پس از مقداردهی اولیه.
نمایش فهرست کوتاهی از گزینه‌ها.
نمایش اطلاعات نسخه و خروج.

ALRM
اجبار tincd به تلاش فوری برای اتصال به تمام آپ‌لینک‌ها (uplinks). معمولاً tincd خودش سعی در انجام این کار دارد، اما با هر بار شکست، زمان انتظار بین تلاش‌ها را افزایش می‌دهد، و اگر tincd در اولین بار پس از راه‌اندازی موفق به اتصال به یک آپ‌لینک نشود، به‌طور پیش‌فرض حداکثر زمان ۱۵ دقیقه را در نظر می‌گیرد.
HUP
بازخوانی جزئی فایل‌های پیکربندی. اتصال‌ها به میزبان‌هایی که فایل پیکربندی میزبان آن‌ها حذف شده است، بسته می‌شوند. اتصالات خروجی جدید مشخص‌شده در tinc.conf برقرار خواهند شد. در صورت استفاده از گزینه --logfile -، این سیگنال همچنین فایل لاگ را بسته و دوباره باز می‌کند که هنگام چرخش لاگ‌ها (log rotation) کاربردی است.
INT
افزایش موقت سطح اشکال‌زدایی به ۵. ارسال مجدد این سیگنال، سطح اشکال‌زدایی را به مقدار اولیه بازمی‌گرداند.
USR1
تخلیه فهرست اتصالات در syslog.
USR2
تخلیه آمار دستگاه شبکه مجازی و تمام گره‌ها، یال‌ها و زیرشبکه‌های شناخته‌شده در syslog.
WINCH
پاکسازی تمام اطلاعات ثبت‌شده درباره گره‌های غیرقابل دسترس.

دیمن tinc می‌تواند پیام‌های زیادی به syslog ارسال کند. هرچه سطح اشکال‌زدایی بالاتر باشد، پیام‌های بیشتری ثبت خواهند شد. هر سطح شامل تمام پیام‌های سطوح قبل از خود نیز می‌شود:

0
پیامی مبنی بر شروع به کار tincd همراه با شماره نسخه ثبت می‌شود. همچنین هرگونه خطای جدی ثبت خواهد شد.
1
ثبت تمام اتصالاتی که با سایر دیمن‌های tinc برقرار می‌شود.
2
ثبت پیام‌های وضعیت و خطای اسکریپت‌ها و سایر دیمن‌های tinc.
3
ثبت تمام درخواست‌های مبادله‌شده با سایر دیمن‌های tinc. این موارد شامل احراز هویت، تبادل کلید و به‌روزرسانی فهرست اتصالات است.
4
ثبت یک رونوشت از تمام داده‌های دریافت شده روی سوکت متا (meta socket).
5
ثبت تمام ترافیک شبکه روی شبکه خصوصی مجازی.

/etc/tinc/
دایرکتوری حاوی فایل‌های پیکربندی مورد استفاده tinc. برای اطلاعات بیشتر، ببینید: tinc.conf(5).
/var/run/tinc.NETNAME.pid
شناسه پردازش (PID) پردازش در حال اجرای tincd در این فایل ذخیره می‌شود.

گزینه BindToInterface ممکن است به‌درستی کار نکند.

رمزنگاری در tinc هنوز به‌خوبی آزمایش نشده است. با مسئولیت خود از آن استفاده کنید!

در صورت یافتن هرگونه باگ، آن‌ها را به tinc@tinc-vpn.org گزارش دهید.

موارد بسیار، به‌ویژه ممیزی امنیتی.

tinc.conf(5), https://www.tinc-vpn.org, http://www.cabal.org.

مستندات کامل tinc به‌صورت یک کتابچه راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های info و tinc به‌درستی در سیستم شما نصب شده باشند، دستور info tinc دسترسی به راهنمای کامل را برای شما فراهم خواهد کرد.

نرم‌افزار tinc کاملاً بدون هیچ‌گونه ضمانتی ارائه می‌شود. این یک نرم‌افزار آزاد است و شما مجاز هستید تحت شرایط خاصی آن را مجدداً توزیع کنید؛ برای جزئیات بیشتر به فایل COPYING مراجعه نمایید.

Ivo Timmermans Guus Sliepen ⟨guus@tinc-vpn.org⟩

و با تشکر از بسیاری افراد دیگر برای مشارکت‌هایشان در tinc!

2014-05-11