نام (NAME)

dhtnode - یک اجراکننده خط فرمانی ساده برای گره OpenDHT.

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

dhtnode [-h] [-V] [-v [-l logfile] [-L]] [-i [-I file]] [-c file] [-k file] [-m password] [-d] [-s] [-D] [-U] [-P] [-n network_id] [-p local_port] [-b bootstrap_host[:port]] [-f path] [-S port] [-e port] [-a address] [-w file] [-K file] [-M password] [-C server] [-y endpoint] [-z key] [-u bundleid]

توضیحات (DESCRIPTION)

یک گره OpenDHT را با یک واسط خط فرمان تعاملی (CLI، پیش‌فرض) یا به عنوان یک دیمن (با '-d' یا '-s') اجرا می‌کند. دستورهای در دسترس در پوسته تعاملی عبارتند از:

h, help    چاپ این پیام راهنما.
x, quit    خروج از برنامه.
log        شروع/توقف چاپ گزارش‌های DHT.
اطلاعات گره:
ll         چاپ اطلاعات پایه‌ای و آمار گره فعلی.
ls [key]   چاپ اطلاعات پایه‌ای درباره جستجو(های) جاری.
ld [key]   چاپ اطلاعات پایه‌ای درباره مقادیر ذخیره‌شده فعلی روی این
           گره (یا برای یک کلید مشخص).
lr         چاپ جدول کامل و فعلی مسیریابی این گره.
عملیات روی DHT:
b <ip:port>            ارسال پینگ به گره بالقوه در آدرس IP/پورت مشخص‌شده.
g <key>                دریافت مقادیر در <key>.
l <key>                شنود برای تغییرات مقدار در <key>.
cl <key> <token>       لغو شنود برای <token> و <key>.
p <key> <str>          قرار دادن مقدار رشته‌ای در <key>.
pp <key> <str>         قرار دادن مقدار رشته‌ای در <key> (نسخه پایدار).
cpp <key> <id>         لغو عملیات قرار دادن پایدار برای <key> و
                       مقدار <id>.
s <key> <str>          قرار دادن مقدار رشته‌ای در <key>، امضاشده با کلید
                       خصوصی تولیدشده ما.
e <key> <dest> <str>   قرار دادن مقدار رشته‌ای در <key>، رمزگذاری‌شده برای
                       <dest> با کلید عمومی آن (در صورت یافت شدن).
cc                     ارسال سیگنال تغییر اتصال‌پذیری.
عملیات با پروکسی (در صورت کامپایل با پشتیبانی از سرور پروکسی):
pst [port] <pushServer>  راه‌اندازی واسط پروکسی روی پورت.
psx [port]               راه‌اندازی واسط SSL پروکسی روی پورت.
psp [port]               توقف واسط پروکسی روی پورت.
عملیات با پروکسی (در صورت کامپایل با پشتیبانی از کلاینت پروکسی):
stt [server_address] <device_key>  راه‌اندازی کلاینت پروکسی.
stp                                توقف کلاینت پروکسی.
rs  [token]                        اشتراک مجدد در opendht.
rp  [token]                        تزریق یک اعلان push.

گزینه‌ها (OPTIONS)

-h, --help: راهنما را چاپ کرده و خارج می‌شود.
-V, --version: اطلاعات نسخه را چاپ کرده و خارج می‌شود.
-v, --verbose: فعال‌سازی حالت پرگو (ثبت گزارش‌ها در stdout/stderr به صورت پیش‌فرض).
-l logfile, --logfile logfile: نوشتن گزارش در فایل به جای stdout/stderr.
-L, --syslog: نوشتن گزارش در syslog به جای stdout/stderr (حالت پرگو را فعال می‌کند).
-i, --identity: تولید یک هویت رمزنگاری (جفت‌کلید RSA و گواهی خودامضا) برای گره. در صورتی که هیچ فایل کلید خصوصی ارائه نشده باشد، برای انجام عملیات‌های رمزنگاری (رمزگذاری/امضای مقادیر) لازم است.
-I file, --save-identity file: ذخیره هویت تولیدشده (گواهی و کلید خصوصی) در پیشوند فایل داده‌شده. فایل‌ها به صورت file و file_ca ذخیره می‌شوند.
-c file, --certificate file: بارگذاری گواهی هویت از فایل داده‌شده. در صورت مشخص شدن، گواهی روی DHT منتشر می‌شود.
-k file, --privkey file: بارگذاری کلید خصوصی هویت از فایل داده‌شده. در صورتی که هویتی تولید نشده باشد، برای انجام عملیات‌های رمزنگاری لازم است.
-m password, --privkey-password password: گذرواژه مورد استفاده برای رمزگذاری یا رمزگشایی کلید خصوصی (اختیاری).
-d, --daemonize: اجرای برنامه در حالت دیمن (در پس‌زمینه fork خواهد شد). هنگامی که حالت پرگو فعال باشد، به صورت پیش‌فرض گزارش‌ها را در syslog می‌نویسد.
-s, --service: اجرای برنامه در حالت سرویس (دیمن بدون انشعاب یا non-forking).
-D, --peer-discovery: کشف خودکار و محلی همتاها به صورت چندپخشی (multicast) را فعال می‌کند.
-U, --no-rate-limit: غیرفعال‌سازی محدودیت نرخ (امکان ارسال درخواست‌ها و ذخیره‌سازی نامحدود را فراهم می‌کند).
-P, --public-stable: فعال‌سازی حالت پایدار عمومی (public stable).
-f path, --persist path: مشخص کردن مسیر فایل برای ذخیره پایدار/بارگذاری وضعیت گره (جدول مسیریابی و مقادیر).
-n network_id, --net network_id: مشخص کردن شناسه شبکه. این گزینه امکان اتصال به شبکه‌های مجزا را به شما داده و از ادغام دو شبکه مختلف جلوگیری می‌کند. مقدار پیش‌فرض 0 است (شبکه عمومی اصلی).
-p local_port, --port local_port: استفاده از پورت UDP با شماره local_port برای مقید شدن برنامه به آن. اگر تنظیم نشود، از هر پورت در دسترسی استفاده خواهد کرد. پورت پیش‌فرض OpenDHT برای گره‌های عمومی 4222 است.
-b bootstrap_host[:port], --bootstrap bootstrap_host[:port]: مشخص کردن آدرس یک گره راه‌انداز (bootstrap) برای اتصال به شبکه.
-S local_port, --proxyserver local_port: اجرای سرور پروکسی REST API مقیدشده به این گره DHT روی پورت HTTP به شماره local_port.
-e local_port, --proxyserverssl local_port: اجرای سرور پروکسی REST API به همراه SSL مقیدشده به این گره DHT روی پورت HTTPS به شماره local_port.
-a address, --proxy-addr address: آدرس مقیدسازی سرور پروکسی.
-w file, --proxy-certificate file: بارگذاری گواهی SSL پروکسی از فایل داده‌شده.
-K file, --proxy-privkey file: بارگذاری کلید خصوصی SSL پروکسی از فایل داده‌شده.
-M password, --proxy-privkey-password password: گذرواژه برای رمزگذاری یا رمزگشایی کلید خصوصی پروکسی (اختیاری).
-C server, --proxyclient server: اجرای این گره DHT در حالت کلاینت پروکسی، و اتصال به server.
-y endpoint, --pushserver endpoint: نقطه پایانی سرور اعلان push.
-z key, --devicekey key: کلید دستگاه برای اعلان‌های push.
-u bundleid, --bundleid bundleid: شناسه بسته (Bundle ID) برای اعلان‌های push.

مثال‌ها (EXAMPLES)

اجرای یک گره با استفاده از bootstrap.jami.net به عنوان گره راه‌انداز (bootstrap):

dhtnode -b bootstrap.jami.net:4222

اجرای یک گره به عنوان دیمن بدون انشعاب (non-forking) روی پورت 4222:

dhtnode -b bootstrap.jami.net -p 4222 -s

اجرای یک سرور پروکسی روی پورت 8000:

dhtnode -b bootstrap.jami.net:4222 --proxyserver 8000

استفاده از یک کلاینت پروکسی برای اتصال به یک سرور پروکسی:

dhtnode --proxyclient dhtproxy.jami.net:80

نویسندگان (AUTHORS)

برنامه نوشته‌شده توسط

•: Adrien Béraud <adrien.beraud@savoirfairelinux.com>

صفحه راهنما نوشته‌شده توسط

•: Simon Désaulniers <sim.desaulniers@gmail.com>