ZEROTIER-CLI(1) ZEROTIER-CLI(1)

zerotier-cli - کنترل سرویس شبکه مجازی محلی ZeroTier

zerotier-cli [-switches] <command> [arguments]

دستور zerotier-cli یک رابط خط فرمان ساده برای JSON API محلی سرویس نقطه انتهایی شبکه مجازی ZeroTier یعنی zerotier-one(8) فراهم می‌کند.

به‌طور پیش‌فرض، zerotier-cli باید به‌عنوان کاربر ریشه (root) یا با sudo اجرا شود. اگر می‌خواهید به یک کاربر غیرممتاز اجازه دهید تا از zerotier-cli برای کنترل سرویس ZeroTier سیستم استفاده کند، می‌توانید یک رونوشت محلی از توکن احراز هویت سرویس ZeroTier در دایرکتوری خانگی کاربر ایجاد کنید:

sudo cp /var/lib/zerotier-one/authtoken.secret /home/user/.zeroTierOneAuthToken
chown user /home/user/.zeroTierOneAuthToken
chmod 0600 /home/user/.zeroTierOneAuthToken

(محل دایرکتوری خانگی سرویس ZeroTier ممکن است در سیستم‌های‌عامل مختلف متفاوت باشد. به zerotier-one(8) مراجعه کنید.)

توجه داشته باشید که این کار به کاربر امکان اتصال سیستم به هر شبکه مجازی یا قطع اتصال از آن را می‌دهد، که مجوز بسیار مهم و قابل‌توجهی است.

دستور zerotier-cli دارای چندین آرگومان خط فرمان است که در خروجی help قابل مشاهده هستند. دو مورد از پرکاربردترین آن‌ها عبارت‌اند از -j برای خروجی خام JSON و -D<path> برای تعیین یک دایرکتوری کاری جایگزین برای سرویس ZeroTier. پردازش خروجی خام JSON در اسکریپت‌ها آسان‌تر است و همچنین شامل جزئیات دقیقی است که در خروجی جدولی وجود ندارد. گزینهٔ -D<path> مشخص می‌کند که اگر سرویس در مکان پیش‌فرض سیستم شما اجرا نمی‌شود، فایل‌های zerotier-one.port و authtoken.secret سرویس در کجا قرار دارند.

  • help: راهنمای zerotier-cli را نمایش می‌دهد.
  • info: اطلاعات مربوط به این دستگاه شامل نشانی ۱۰ رقمی ZeroTier و وضعیت ظاهری اتصال آن را نمایش می‌دهد. برای خروجی با جزئیات بیشتر از -j استفاده کنید.
  • listpeers: این دستور همتایان VL1 (لایه ۱ مجازی، شبکه نظیربه‌نظیر) ZeroTier را که این سرویس می‌شناسد و اخیراً (در حدود ۳۰ دقیقه گذشته) با آن‌ها ارتباط داشته است، فهرست می‌کند. این‌ها لزوماً تمام دستگاه‌های موجود در شبکه(های) مجازی شما نیستند و ممکن است شامل دستگاه‌هایی که در هیچ شبکه مجازی عضویت ندارید نیز باشند. این دستگاه‌ها معمولاً سرورهای ریشه (root servers) یا کنترل‌کننده‌های شبکه هستند.
  • listnetworks: شبکه‌هایی را که سیستم شما به آن‌ها تعلق دارد و اطلاعاتی درباره آن‌ها مانند آدرس‌های IP مدیریت‌شده توسط ZeroTier را که به شما اختصاص داده شده‌اند، فهرست می‌کند. (آدرس‌های IP که به‌صورت دستی به رابط‌های ZeroTier اختصاص یافته‌اند در اینجا فهرست نمی‌شوند. برای مشاهده آن‌ها از دستورات استاندارد رابط شبکه استفاده کنید.)
  • join: برای پیوستن به یک شبکه کافی است از join و شناسه ۱۶ رقمی هگزادسیمال شبکه استفاده کنید. همین. سپس از listnetworks برای مشاهده وضعیت استفاده کنید. در پاسخ، یا از کنترل‌کننده شبکه گواهی و اطلاعات دیگری مانند تخصیص‌های IP دریافت خواهید کرد، یا پیام «access denied» نمایش داده می‌شود. در این حالت، مدیر این شبکه باید دستگاه شما را با شناسه ۱۰ رقمی دستگاه (که با info قابل مشاهده است) در کنترل‌کننده شبکه مجاز کند.
  • leave: خروج از یک شبکه به همان سادگی پیوستن به آن است. این کار اتصال را از شبکه قطع کرده و رابط آن را از سیستم حذف می‌کند. توجه داشته باشید که ممکن است همتایان موجود در شبکه تا ۳۰ دقیقه تا زمانی که به دلیل نبود ترافیک منقضی شوند در listpeers باقی بمانند. اما اگر دیگر شبکه مشترکی با شما نداشته باشند، عملاً نمی‌توانند هیچ ارتباط مؤثری با شما برقرار کنند.

پیوستن به «Earth»، شبکه عمومی و بزرگ سراسری ZeroTier:

$ sudo zerotier-cli join 8056c2e21c000001
$ sudo zerotier-cli listnetworks
( منتظر بمانید تا یک IP مربوط به Earth دریافت کنید )
$ ping earth.zerotier.net
( اکنون باید بتوانید IP آزمایشی Earth را پینگ کنید )

ترک «Earth»:

$ sudo zerotier-cli leave 8056c2e21c000001

فهرست کردن همتایان VL1:

$ sudo zerotier-cli listpeers

(c)2011-2016 ZeroTier, Inc. -- https://www.zerotier.com -- https://github.com/zerotier

zerotier-one(8), zerotier-idtool(1)

December 2016