.TH "ZEROTIER\-CLI" "1" "December 2016" "" ""
.SH "نام (NAME)"
\fBzerotier\-cli\fR \- کنترل سرویس شبکه مجازی محلی ZeroTier
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBzerotier\-cli\fP [\-switches] <command> [arguments]
.SH "توضیحات (DESCRIPTION)"
.P
دستور \fBzerotier\-cli\fR یک رابط خط فرمان ساده برای JSON API محلی سرویس نقطه انتهایی شبکه مجازی ZeroTier یعنی \fBzerotier\-one\fR(8) فراهم می‌کند\.
.P
به‌طور پیش‌فرض، \fBzerotier\-cli\fR باید به‌عنوان کاربر ریشه (root) یا با \fBsudo\fP\|\ اجرا شود\. اگر می‌خواهید به یک کاربر غیرممتاز اجازه دهید تا از \fBzerotier\-cli\fR برای کنترل سرویس ZeroTier سیستم استفاده کند، می‌توانید یک رونوشت محلی از توکن احراز هویت سرویس ZeroTier در دایرکتوری خانگی کاربر ایجاد کنید:
.P
.RS 2
.nf
sudo cp /var/lib/zerotier\-one/authtoken\.secret /home/user/\.zeroTierOneAuthToken
chown user /home/user/\.zeroTierOneAuthToken
chmod 0600 /home/user/\.zeroTierOneAuthToken
.fi
.RE
.P
(محل دایرکتوری خانگی سرویس ZeroTier ممکن است در سیستم‌های‌عامل مختلف متفاوت باشد\. به \fBzerotier\-one\fR(8) مراجعه کنید\.)
.P
توجه داشته باشید که این کار به کاربر امکان اتصال سیستم به هر شبکه مجازی یا قطع اتصال از آن را می‌دهد، که مجوز بسیار مهم و قابل‌توجهی است\.
.P
دستور \fBzerotier\-cli\fR دارای چندین آرگومان خط فرمان است که در خروجی \fBhelp\fP قابل مشاهده هستند\. دو مورد از پرکاربردترین آن‌ها عبارت‌اند از \fB\-j\fP برای خروجی خام JSON و \fB\-D<path>\fP برای تعیین یک دایرکتوری کاری جایگزین برای سرویس ZeroTier\. پردازش خروجی خام JSON در اسکریپت‌ها آسان‌تر است و همچنین شامل جزئیات دقیقی است که در خروجی جدولی وجود ندارد\. گزینهٔ \fB\-D<path>\fP مشخص می‌کند که اگر سرویس در مکان پیش‌فرض سیستم شما اجرا نمی‌شود، فایل‌های zerotier\-one\.port و authtoken\.secret سرویس در کجا قرار دارند\.
.SH "دستورات (COMMANDS)"
.RS 0
.IP \(bu 2
\fBhelp\fP:
راهنمای \fBzerotier\-cli\fR را نمایش می‌دهد\.
.IP \(bu 2
\fBinfo\fP:
اطلاعات مربوط به این دستگاه شامل نشانی ۱۰ رقمی ZeroTier و وضعیت ظاهری اتصال آن را نمایش می‌دهد\. برای خروجی با جزئیات بیشتر از \fB\-j\fP استفاده کنید\.
.IP \(bu 2
\fBlistpeers\fP:
این دستور همتایان VL1 (لایه ۱ مجازی، شبکه نظیربه‌نظیر) ZeroTier را که این سرویس می‌شناسد و اخیراً (در حدود ۳۰ دقیقه گذشته) با آن‌ها ارتباط داشته است، فهرست می‌کند\. این‌ها لزوماً تمام دستگاه‌های موجود در شبکه(های) مجازی شما نیستند و ممکن است شامل دستگاه‌هایی که در هیچ شبکه مجازی عضویت ندارید نیز باشند\. این دستگاه‌ها معمولاً سرورهای ریشه (root servers) یا کنترل‌کننده‌های شبکه هستند\.
.IP \(bu 2
\fBlistnetworks\fP:
شبکه‌هایی را که سیستم شما به آن‌ها تعلق دارد و اطلاعاتی درباره آن‌ها مانند آدرس‌های IP مدیریت‌شده توسط ZeroTier را که به شما اختصاص داده شده‌اند، فهرست می‌کند\. (آدرس‌های IP که به‌صورت دستی به رابط‌های ZeroTier اختصاص یافته‌اند در اینجا فهرست نمی‌شوند\. برای مشاهده آن‌ها از دستورات استاندارد رابط شبکه استفاده کنید\.)
.IP \(bu 2
\fBjoin\fP:
برای پیوستن به یک شبکه کافی است از \fBjoin\fP و شناسه ۱۶ رقمی هگزادسیمال شبکه استفاده کنید\. همین\. سپس از \fBlistnetworks\fP برای مشاهده وضعیت استفاده کنید\. در پاسخ، یا از کنترل‌کننده شبکه گواهی و اطلاعات دیگری مانند تخصیص‌های IP دریافت خواهید کرد، یا پیام «access denied» نمایش داده می‌شود\. در این حالت، مدیر این شبکه باید دستگاه شما را با شناسه ۱۰ رقمی دستگاه (که با \fBinfo\fP قابل مشاهده است) در کنترل‌کننده شبکه مجاز کند\.
.IP \(bu 2
\fBleave\fP:
خروج از یک شبکه به همان سادگی پیوستن به آن است\. این کار اتصال را از شبکه قطع کرده و رابط آن را از سیستم حذف می‌کند\. توجه داشته باشید که ممکن است همتایان موجود در شبکه تا ۳۰ دقیقه تا زمانی که به دلیل نبود ترافیک منقضی شوند در \fBlistpeers\fP باقی بمانند\. اما اگر دیگر شبکه مشترکی با شما نداشته باشند، عملاً نمی‌توانند هیچ ارتباط مؤثری با شما برقرار کنند\.

.RE
.SH "مثال‌ها (EXAMPLES)"
.P
پیوستن به «Earth»، شبکه عمومی و بزرگ سراسری ZeroTier:
.P
.RS 2
.nf
$ sudo zerotier\-cli join 8056c2e21c000001
$ sudo zerotier\-cli listnetworks
( منتظر بمانید تا یک IP مربوط به Earth دریافت کنید )
$ ping earth\.zerotier\.net
( اکنون باید بتوانید IP آزمایشی Earth را پینگ کنید )
.fi
.RE
.P
ترک «Earth»:
.P
.RS 2
.nf
$ sudo zerotier\-cli leave 8056c2e21c000001
.fi
.RE
.P
فهرست کردن همتایان VL1:
.P
.RS 2
.nf
$ sudo zerotier\-cli listpeers
.fi
.RE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.P
(c)2011\-2016 ZeroTier, Inc\. \-\- https://www\.zerotier\.com \-\- https://github\.com/zerotier
.SH "همچنین ببینید (SEE ALSO)"
.P
zerotier\-one(8), zerotier\-idtool(1)