نام (NAME)

supernode - دیمون سوپرنود در شبکه n2n

خلاصه دستور (SYNOPSIS)

supernode <config file>
supernode [OPTION]...

توضیحات (DESCRIPTION)

سامانه N2N یک سیستم VPN همتا به همتا (peer-to-peer) است. سوپرنود به عنوان رجیستری معرفی گره‌ها، مجرای پخش همگانی (broadcast) و گره بازپخش بسته‌ها برای سامانه n2n عمل می‌کند. در هنگام راه‌اندازی، سوپرنود شروع به گوش دادن روی درگاه UDP مشخص‌شده برای ثبت‌نام گره‌ها و هدایت بسته‌ها می‌نماید. سوپرنود می‌تواند به هر تعداد جامعه (community) خدمت‌رسانی کند و بسته‌ها را تنها میان اعضای یک جامعه یکسان هدایت می‌نماید. سوپرنود کلید رمزنگاری جامعه را نگه نمی‌دارد و بنابراین نمی‌تواند بسته‌ها را استراق‌سمع کرده یا به درون جامعه تزریق نماید.

سوپرنود می‌تواند هم‌زمان به چندین جامعه n2n خدمت‌رسانی کند. ترافیک میان جوامع مختلف ردوبدل نمی‌شود.

تمامی گزارش‌ها به خروجی استاندارد (stdout) فرستاده می‌شوند.

پرونده پیکربندی مشابه خط فرمان است و در هر خط یک گزینه قرار می‌گیرد. خطوطی که با «#» آغاز می‌شوند نادیده گرفته می‌شوند. میان کلید و مقدار باید از علامت مساوی ('=') استفاده شود؛ مانند: -p=7777

گزینه‌های اتصال شبکه زیرین (OPTIONS FOR THE UNDERLYING NETWORK CONNECTION)

-p <local_port>, --local-port=<local_port>: گوش دادن روی این درگاه محلی و ثابت UDP، مقدار پیش‌فرض 7654 است
-F <fed_name>: نام فدراسیون سوپرنود، مقدار پیش‌فرض '*Federation' است (همچنین N2N_FEDERATION را در بخش محیط ببینید)
-l <host:port>: نشانی IP یا نام، و درگاه سوپرنود شناخته‌شده
-m <mac_address>: نشانی MAC ثابت برای سوپرنود، برای نمونه:
'-m 10:20:30:40:50:60'، در غیر این صورت به‌صورت تصادفی تولید می‌شود
-M: غیرفعال‌سازی حفاظت در برابر جعل نشانی‌های IP و MAC برای تمام جوامعی که با نام کاربری و گذرواژه احراز هویت نمی‌شوند
-V <version_string>: تغییر رشته نسخه سوپرنود که به گره‌های لبه توزیع شده و در خروجی درگاه مدیریت آن‌ها نمایش داده می‌شود، حداکثر تا ۱۹ نویسه

پیکربندی دستگاه TAP و شبکه همپوشان (TAP DEVICE AND OVERLAY NETWORK CONFIGURATION)

-c <path>, --communities=<path>: فایل حاوی جوامع مجاز و جزئیات احراز هویت مبتنی بر نام کاربری / گذرواژه (بخش پرونده جوامع مجاز را ببینید)
-a <net-net/n>, --autoip=<net-net/n>: محدوده زیرشبکه برای سرویس اختصاص خودکار نشانی IP،
برای نمونه: '-a 192.168.0.0-192.168.255.0/24'،
مقدار پیش‌فرض '10.128.255.0-10.255.255.0/24' است

گزینه‌های محلی (LOCAL OPTIONS)

-f, --foreground: غیرفعال‌سازی حالت دیمون (یونیکس) و اجرا در پیش‌زمینه.
-t <port>, --mgmt-port=<port>: درگاه UDP مدیریتی، برای اجرای چندین سوپرنود روی یک دستگاه، مقدار پیش‌فرض 5645 است
--management-password <password>: گذرواژه دسترسی به رابط برنامه‌نویسی JSON (JSON API) در درگاه مدیریتی را تعیین می‌کند، مقدار پیش‌فرض 'n2n' است. برای دسترسی مربوطه به JSON API در درگاه مدیریت، این گذرواژه باید ارائه شود.
-v, --verbose: استفاده از ثبت گزارش‌های پرجزئیات
-u <UID>: شناسه کاربری عددی برای استفاده در زمان کاهش سطح دسترسی‌ها
-g <GID>: شناسه گروهی عددی برای استفاده در زمان کاهش سطح دسترسی‌ها
-h: نمایش یک راهنمای مرجع سریع شامل تمامی گزینه‌های موجود
--help: نمایش توضیحات تفصیلی پارامترها

پرونده جوامع مجاز (ALLOWED COMMUNITIES FILE)

این پرونده یک فایل متنی ساده است. توضیحات (کامنت‌ها) با یک علامت هش (#) در ابتدای خط مشخص می‌شوند. خطی که با علامت ستاره (*) آغاز می‌شود، تعریف احراز هویت کاربر است و یک کاربر مجاز را به آخرین جامعه تعریف‌شده اضافه می‌کند. جوامع مجاز را می‌توان با یک عبارت باقاعده (regular expression) مشخص کرد.

نمونه‌ای از پرونده جوامع:

# List of allowed communities
mynetwork
netleo
* logan nHWum+r42k1qDXdIeH-WFKeylK5UyLStRzxofRNAgpG
* sister HwHpPrdMft+38tFDDiunUds6927t0+zhCMMkQdJafcC

جزئیات بیشتر درباره ایجاد پرونده جوامع مجاز در مستندات Communities.md و Authentication.md موجود در این بسته آمده است.

محیط (ENVIRONMENT)

N2N_FEDERATION: تنظیم نام فدراسیون به طوری که در خط فرمان قابل مشاهده نباشد

مثال‌ها (EXAMPLES)

supernode -p 7654 -v: راه‌اندازی سوپرنود و گوش دادن روی درگاه UDP با شماره 7654 همراه با خروجی پرجزئیات.
echo | nc -w1 -u 127.0.0.1 5645: نمایش وضعیت مدیریتی یک سوپرنود در حال اجرا.

راه‌اندازی مجدد (RESTART)

هنگامی که سوپرنود مجدداً راه‌اندازی می‌شود، تمامی اطلاعات ثبت‌نام مربوط به گره‌های لبه متصل را از دست می‌دهد. ممکن است تا پنج دقیقه طول بکشد تا گره‌های لبه مجدداً ثبت‌نام کرده و جریان عادی ترافیک از سر گرفته شود.

وضعیت خروج (EXIT STATUS)

دستور supernode یک دیمون است و هرگونه خروج به منزله یک خطا تلقی می‌شود

نویسنده (AUTHOR)

Luca Deri ( deri (at) ntop.org ), Richard Andrews ( andrews (at) ntop.org ), Don Bindner

همچنین ببینید (SEE ALSO)

ifconfig(8) edge(8)
مستندات موجود در کد منبع
مستندات جامع موجود در پوشه doc/ برنامه n2n