نصب روی Linux

نردبون روی Linux به‌صورت یک سرویس systemd به نام nardeboond اجرا می‌شود و آن را با CLI به نام nardeboon کنترل می‌کنید. این نسخه از معماری‌های amd64 و arm64 پشتیبانی می‌کند و به شکل بسته‌های .deb و .rpm عرضه می‌شود. Windows نصب‌کننده‌ی خودش را دارد؛ نسخه‌های macOS، Android و iOS بعداً می‌آیند.

نصب

سریع‌ترین راه، اسکریپت نصب است:

curl -fsSL https://nardeboon.io/install.sh | sh

اگر می‌خواهید مخزن بسته‌ها را خودتان اضافه کنید، دستورهای مخصوص توزیع خودتان را اجرا کنید.

Debian و Ubuntu

curl -fsSL https://pkgs.nardeboon.io/nardeboon.gpg | sudo tee /usr/share/keyrings/nardeboon.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/nardeboon.gpg] https://pkgs.nardeboon.io/deb stable main" | sudo tee /etc/apt/sources.list.d/nardeboon.list
sudo apt update && sudo apt install nardeboon

Fedora و RHEL

sudo dnf config-manager addrepo --from-repofile=https://pkgs.nardeboon.io/rpm/nardeboon.repo
sudo dnf install nardeboon

اگر سیستم شما dnf نسخه‌ی ۴ دارد، مخزن را به‌جای دستور اول با sudo dnf config-manager --add-repo https://pkgs.nardeboon.io/rpm/nardeboon.repo اضافه کنید.

پیوستن به شبکه

برای پیوستن با لینک ورود، این دستور را اجرا کنید:

sudo nardeboon up

دستور up یک لینک ورود چاپ می‌کند. لینک را در مرورگر باز کنید و وارد حسابتان شوید تا دستگاه به شبکه بپیوندد.

روی سرورها و در اسکریپت‌ها، به‌جای لینک ورود از کلید احراز هویت (auth key) استفاده کنید. یک کلید در داشبورد بسازید و آن را به up بدهید:

sudo nardeboon up --auth-key "$NB_AUTH_KEY"

در شبکه‌ها و دستگاه‌ها آمده است که کدام نوع کلید برای چه کاری مناسب است.

اتصال را با nardeboon status بررسی کنید. اجرای دوباره‌ی up فقط گزینه‌هایی را تغییر می‌دهد که به آن می‌دهید. مثلاً این دستور نام دستگاه را تعیین می‌کند و به بقیه‌ی تنظیمات دست نمی‌زند:

sudo nardeboon up --hostname web-1

دستور sudo nardeboon down اتصال را قطع می‌کند، ولی daemon همچنان اجرا می‌ماند. دستور sudo nardeboon logout دستگاه را از حساب خارج و کلیدش را حذف می‌کند.

جایی که سرورهای نردبون مسدودند

بعضی شبکه‌ها همه‌ی اتصال‌ها به سرورهای نردبون را قطع می‌کنند؛ مثل بعضی دیتاسنترهای ایران. دستگاهی که از قبل در شبکه‌ی شماست آنجا هم کار می‌کند و از طریق همتاهایش به نردبون می‌رسد. دستگاه تازه می‌تواند از طریق یکی از رله‌های خود شبکه‌تان وارد شود:

1. روی دستگاهی که اتصالش باز است، مثلاً سروری در یک دیتاسنتر دیگر، در داشبورد گزینه‌ی Also use this node as a relay را روشن کنید.
2. وقتی آنلاین شد، کلید احراز هویت را بسازید. آن‌وقت کلید آدرس آن رله را هم با خودش دارد.
3. دستگاه تازه را مثل بالا با همین کلید وصل کنید. اگر به سرورهای نردبون نرسد، از طریق رله وارد می‌شود؛ رله اتصال را فقط رد می‌کند و نمی‌تواند محتوایش را بخواند.

اگر دستگاه نتواند خود نردبون را هم دانلود کند، آن را از روی یک کپی نصب کنید: در داشبورد، Add device و بعد The device can't reach the internet? بسته‌های آخرین نسخه را نشان می‌دهد. بسته‌ی مناسب دستگاه را دانلود کنید، روی دستگاه کپی کنید و نصبش کنید:

sudo dpkg -i nardeboon_*.deb   # Debian, Ubuntu
sudo rpm -i nardeboon-*.rpm    # Fedora, RHEL

به‌روزرسانی‌هایش بعد از آن از همتاهایش می‌رسد، اول از رله‌های خود شبکه‌تان؛ بخش «به‌روزرسانی» در پایین همین صفحه را ببینید.

لینک ورود به داشبورد نیاز دارد؛ پس جایی که داشبورد مسدود است، با کلید احراز هویت وصل شوید.

مدیریت سرویس

برای دادن گزینه‌های اضافه به daemon، آن‌ها را در FLAGS در فایل /etc/default/nardeboond بنویسید و سرویس را دوباره راه‌اندازی کنید. تنظیمات خود دستگاه، مثل نامش یا routeهایی که استفاده می‌کند، با nardeboon set <setting> <value> تغییر می‌کند؛ مرجع CLI را ببینید.

محل فایل‌ها و رابط شبکه

مثلاً آدرس دستگاه در شبکه را با این دستور ببینید:

ip addr show nardeboon0

استفاده از CLI بدون sudo

CLI از طریق سوکت کنترل با daemon ارتباط برقرار می‌کند و فقط root و اعضای گروه nardeboon اجازه‌ی استفاده از آن را دارند. برای اینکه دیگر به sudo نیازی نداشته باشید، خودتان را به این گروه اضافه کنید و بعد یک بار از سیستم خارج و دوباره وارد شوید:

sudo usermod -aG nardeboon "$USER"

دستوری که بدون دسترسی لازم اجرا شود، با کد خروج ۷ (permission) تمام می‌شود.

به‌روزرسانی

نودها خودکار به‌روز می‌شوند و همه‌ی به‌روزرسانی‌ها امضاشده‌اند. نود فقط نسخه‌ای را نصب می‌کند که امضای معتبر داشته باشد، و هیچ‌وقت نسخه‌ای قدیمی‌تر از نسخه‌ی فعلی‌اش را نصب نمی‌کند. اگر بررسی امضا یا یکپارچگی ناموفق باشد، nardeboon update با کد خروج ۹ (verify) تمام می‌شود.

نود هر نسخه‌ی جدید را در زمانی تصادفی در چند ساعت بعد از انتشارش نصب می‌کند تا دستگاه‌های یک شبکه همه با هم ری‌استارت نشوند، و از همان راهی که نصب شده است: بسته‌ی امضاشده‌ی همان نسخه، یا برای فایل اجرایی تنها، با جایگزین کردن فایل‌های خودش. بعد از اجرای نسخه‌ی جدید، اتصال‌هایش خودشان برمی‌گردند.

جایی که سرورهای نردبون مسدودند، نود نسخه‌ی جدید را از همتاهایش می‌گیرد؛ اول از رله‌های خود شبکه‌تان، که هر نسخه‌ی تازه را برای دستگاه‌هایی که خودشان نمی‌توانند دریافتش کنند نگه می‌دارند. نود هر چیزی را که می‌گیرد با همان امضا بررسی می‌کند؛ پس همتا نمی‌تواند چیز دیگری به آن بدهد.

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

برای خاموش کردن به‌روزرسانی خودکار روی یک دستگاه، sudo nardeboon set auto-update off را اجرا کنید؛ برای کل یک شبکه، به‌روزرسانی خودکار را در تنظیمات آن خاموش کنید. در هر دو حالت، sudo nardeboon update apply هر وقت بخواهید نسخه‌ی جدید را نصب می‌کند. دستگاه‌ها کانال stable را دنبال می‌کنند؛ sudo nardeboon update channel beta نسخه‌های جدید را زودتر می‌گیرد.

حذف نردبون

1. از حساب خارج شوید

   این دستور دستگاه را از حساب خارج و کلیدش را حذف می‌کند:

   sudo nardeboon logout

2. بسته را حذف کنید

   در Debian و Ubuntu:

   sudo apt remove nardeboon

   در Fedora و RHEL:

   sudo dnf remove nardeboon

3. داده‌ها و مخزن را پاک کنید (اختیاری)

   حذف بسته داده‌های وضعیت نود را نگه می‌دارد؛ پس نصب دوباره همان دستگاه را برمی‌گرداند. برای پاک کردن داده‌ها هم، در Debian و Ubuntu بسته را purge کنید (sudo apt purge nardeboon) یا خودتان پاکشان کنید:

   sudo rm -rf /var/lib/nardeboon

   در Debian و Ubuntu، مخزن و کلید آن را هم حذف کنید:

   sudo rm /etc/apt/sources.list.d/nardeboon.list /usr/share/keyrings/nardeboon.gpg

   در Fedora و RHEL، فایل .repo نردبون را از /etc/yum.repos.d/ حذف کنید.