نصب ایجنت

نصب ایجنت یک دستور است که از داشبورد کپی می‌کنید و روی سرور اجرا می‌کنید. بعد از چند ثانیه سرور در داشبورد ظاهر می‌شود و اولین نمودارها یکی دو دقیقه بعد پر می‌شوند.

نصب با یک دستور#

1. ۱

   «افزودن سرور» را بزنید

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

2. ۲

   دستور را روی سرور اجرا کنید

   با SSH وارد سرور شوید و دستور را با دسترسی root اجرا کنید:

   خط فرمانکپی

   curl -fsSL https://api.wardex.ir/api/agent/install.sh | sudo sh -s -- --token wdx_…
   

3. ۳

   منتظر اتصال بمانید

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

اسکریپت نصب فقط این کارها را می‌کند و هر مرحله را روی صفحه می‌نویسد:

1. نسخه‌ی مناسب پردازنده‌ی سرور را دانلود می‌کند و اثر انگشت (SHA-256) آن را بررسی می‌کند. اگر فایل دستکاری شده باشد، چیزی نصب نمی‌شود.
2. ایجنت را در /usr/local/bin/wardex-agent نصب می‌کند.
3. کاربر سیستمی wardex را می‌سازد. ایجنت با همین کاربر اجرا می‌شود، نه با root.
4. سرور را با توکن به wardex وصل می‌کند. ایجنت در همین لحظه کلید اختصاصی خودش را روی سرور می‌سازد و توکن باطل می‌شود.
5. سرویس wardex-agent را در systemd راه می‌اندازد.

نصب دستی#

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

curl -fsSL https://api.wardex.ir/api/agent/download/linux-amd64 -o wardex-agent
curl -fsSL https://api.wardex.ir/api/agent/download/linux-amd64.sha256   # با sha256sum wardex-agent مقایسه کنید
sudo install -m 0755 wardex-agent /usr/local/bin/wardex-agent
sudo wardex-agent enroll --server https://api.wardex.ir --token wdx_…
sudo wardex-agent run

برای سرور ARM به‌جای linux-amd64 از linux-arm64 استفاده کنید. برای اجرای دائمی، فایل سرویس systemd را از https://api.wardex.ir/api/agent/download/wardex-agent.service بگیرید. اگر می‌خواهید امضای نسخه را هم بررسی کنید، امنیت ایجنت را ببینید.

پیش از نصب ببینید چه چیزی ارسال می‌شود#

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

sudo wardex-agent preview

جزئیات در حریم خصوصی و داده‌ها آمده است.

بررسی اتصال#

sudo wardex-agent status            # اتصال، آخرین ارسال و بخش‌های روشن
sudo systemctl status wardex-agent
sudo journalctl -u wardex-agent -n 50

اگر مشکلی بود، رفع مشکل را ببینید.

سرور بدون systemd#

ایجنت روی سرورهای بدون systemd، مثل بعضی کانتینرها و سیستم‌های قدیمی، هم کار می‌کند. اسکریپت نصب در این حالت سرویسی نمی‌سازد و دستور اجرا را نشان می‌دهد؛ آن را با ابزار init سرورتان و با کاربر wardex اجرا کنید:

/usr/local/bin/wardex-agent run

در این حالت ایجنت فرق «سرویسی که از کار افتاد» و «سرویسی که خودتان متوقف کردید» را تشخیص نمی‌دهد و به‌روزرسانی خودکار هم در دسترس نیست.

به‌روزرسانی#

sudo wardex-agent update --check    # نسخه‌ی تازه هست؟
sudo wardex-agent update            # نصب، با بررسی امضای نسخه
sudo wardex-agent auto-update on    # بررسی و نصب خودکار روزانه (پیش‌فرض خاموش)

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

حذف#

در صفحه‌ی تنظیمات سرور، آخرین بخش، حذف سرور را بزنید. همه‌ی تاریخچه‌ی سرور در wardex پاک می‌شود و ایجنت در اولین گزارش بعدی خودش متوقف می‌شود. برای پاک کردن کامل ایجنت از خود سرور:

sudo wardex-agent deny all
sudo systemctl disable --now wardex-agent wardex-agent-update.timer
sudo rm -rf /usr/local/bin/wardex-agent /etc/wardex /var/lib/wardex /var/lib/wardex-actuator \
  /etc/systemd/system/wardex-agent.service /etc/systemd/system/wardex-agent.service.d \
  /etc/systemd/system/wardex-actuator.service /etc/systemd/system/wardex-agent-update.service /etc/systemd/system/wardex-agent-update.timer
sudo userdel wardex

دستور اول هر اقدامی را که روشن کرده باشید خاموش می‌کند و همه‌ی IPهای بسته‌شده را باز می‌کند. فایل‌های قرنطینه در /var/lib/wardex-actuator/quarantine هستند؛ اگر هنوز لازمشان دارید، پیش از پاک کردن آن پوشه برشان گردانید.