تماس با ما|وبلاگ|درباره آریانت
Arianet
ورود / عضویت
ابزار خط فرمانمتن‌باز · MIT

Arianet CLI: سرورهایتان را از ترمینال مدیریت کنید

ابزار خط فرمان رسمی آریانت برای ساخت، مدیریت و حذف سرور مجازی و منابع آریانت کلاد از ترمینال یا اسکریپت. یک فایل اجرایی تنها برای لینوکس، macOS و ویندوز، با خروجی JSON برای اتوماسیون؛ هر کاری که با CLI انجام دهید همان لحظه در پنل هم دیده می‌شود.

نصب Arianet CLI سورس در گیت‌هاب

چرا Arianet CLI؟

سریع‌تر از پنل

ساخت سرور، ری‌استارت، نصب دوباره سیستم‌عامل یا حذف، با یک دستور و بدون کلیک‌کردن بین صفحه‌ها.

آماده اسکریپت و CI

خروجی JSON، گزینه --wait برای صبر تا پایان عملیات و کد خروج قابل اتکا برای اسکریپت‌های Bash و پایپ‌لاین‌ها.

همگام با پنل

CLI همان API پنل را صدا می‌زند؛ هر تغییری که با آن بدهید بدون رفرش در پنل دیده می‌شود.

شفاف و امن

متن‌باز، بدون تله‌متری؛ توکن با دسترسی محدود ذخیره می‌شود و هرگز روی HTTP ساده ارسال نمی‌شود.

نصب

macOS و لینوکس با Homebrew

brew trust ariaservice/arianet
brew install ariaservice/arianet/arianet

اوبونتو و دبیان با apt

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://ariaservice.github.io/arianet-cli/arianet-archive-keyring.gpg \
  | sudo tee /etc/apt/keyrings/arianet.gpg >/dev/null
echo "deb [signed-by=/etc/apt/keyrings/arianet.gpg] https://ariaservice.github.io/arianet-cli stable main" \
  | sudo tee /etc/apt/sources.list.d/arianet.list
sudo apt update && sudo apt install arianet

اسکریپت نصب

curl -fsSL https://raw.githubusercontent.com/ariaservice/arianet-cli/main/scripts/install.sh | sh

اسکریپت فایل نسخه را دانلود می‌کند، checksum آن را بررسی می‌کند و فقط یک فایل در ~/.local/bin یا /usr/local/bin کپی می‌کند. برای ویندوز و نصب دستی، فایل مناسب سیستم‌عاملتان را از صفحه Releases در گیت‌هاب دانلود کنید.

شروع سریع

  1. در پنل ابری آریانت، از بخش API Tokens یک توکن با دسترسی‌های لازم بسازید.
  2. توکن را به CLI بدهید؛ بدون نمایش روی صفحه تایپ و با دسترسی محدود ذخیره می‌شود. در اسکریپت‌ها می‌توانید به‌جای آن از متغیر محیطی ARIANET_TOKEN استفاده کنید.
  3. اتصال را بررسی کنید و اولین دستورها را اجرا کنید.
arianet configure
arianet auth whoami
arianet vps list
arianet balance

مدیریت سرور مجازی

لوکیشن، پلن و سیستم‌عامل را از فهرست‌ها پیدا کنید و سرور را بسازید. بدون --plan، --region یا --os یک ویزارد تعاملی آن‌ها را می‌پرسد. دستور server هم به‌عنوان نام دیگر vps کار می‌کند.

arianet region list                       # Locations (the --region ID)
arianet plan list --region <id>           # Plans in a region
arianet os list --region <id>             # OS templates in a region

arianet vps create --plan 5 --region 1 --os 3 --hostname web-01 --ssh-key 2
arianet vps status <id>
arianet vps restart <id> --wait
arianet vps power-off <id> --wait
arianet vps reinstall <id> --os <id> --wait
arianet vps rename <id> --name web-02
arianet vps delete <id> --wait

کلیدهای SSH با arianet ssh و فایروال‌ها، قوانین و اتصالشان به سرورها با arianet firewall مدیریت می‌شوند. فاکتورها و تراکنش‌ها هم با arianet balance در دسترس‌اند.

آریانت کلاد

دستور arianet cloud همه منابع آریانت کلاد را پوشش می‌دهد: سرور، والیوم، شبکه خصوصی، فایروال، آی‌پی شناور، لودبالانسر، کلید SSH، ایمیج و بکاپ. هر فهرست با --label-selector فیلتر می‌شود و قیمت‌های عمومی را بدون توکن هم می‌توانید ببینید.

arianet cloud datacenters
arianet cloud plans --datacenter <code>
arianet cloud pricing --datacenter <code>      # Public price list, no token needed

arianet cloud servers create --name web-1 --datacenter <code> --plan <id> \
    --image ubuntu-24.04 --ssh-key-id 5 --labels env=prod --wait
arianet cloud servers list --label-selector env=prod
arianet cloud servers costs <id>

arianet cloud volumes list
arianet cloud networks list
arianet cloud firewalls apply-to <id> --label-selector "env=prod"
arianet cloud floating-ips assign <id> --server <id>
arianet cloud load-balancers list

توکن برای خواندن به دسترسی cloud:servers:read و برای تغییرات به cloud:servers:write نیاز دارد. سرورها و بقیه منابع را با برچسب (label) گروه‌بندی کنید تا فرمان‌ها و فایروال‌ها روی یک گروه کامل اعمال شوند.

اسکریپت‌نویسی و اتوماسیون

  • با -o json خروجی استاندارد فقط JSON است و پیام‌های پیشرفت و سؤال‌ها به stderr می‌روند.
  • با --yes هیچ دستوری منتظر تأیید نمی‌ماند و با --wait تا پایان عملیات صبر می‌کند.
  • کد خروج 0 یعنی موفق و 1 یعنی خطا، حتی وقتی عملیات در حالت --wait شکست بخورد.
  • هر سفارش ساخت سرور کلید idempotency دارد؛ تکرار دستور بعد از قطعی شبکه سرور دوم نمی‌خرد.
arianet vps list -o json | jq '.[].id'

سؤالات رایج درباره Arianet CLI

Arianet CLI چیست؟

ابزار خط فرمان رسمی آریانت است: یک فایل اجرایی تنها، متن‌باز با مجوز MIT، که با API عمومی آریانت کار می‌کند. با آن سرور مجازی، منابع آریانت کلاد، کلید SSH، فایروال، فاکتورها و موجودی حساب را از ترمینال یا اسکریپت مدیریت می‌کنید.

توکن API را از کجا بگیرم؟

از بخش API Tokens در پنل ابری آریانت توکن بسازید و فقط دسترسی‌هایی را که لازم دارید به آن بدهید. بعد دستور arianet configure را اجرا کنید تا توکن بدون نمایش روی صفحه ذخیره شود، یا آن را در متغیر محیطی ARIANET_TOKEN قرار دهید.

کارهایی که با CLI انجام می‌دهم در پنل هم دیده می‌شود؟

بله. CLI همان API پنل را صدا می‌زند؛ سروری که با CLI می‌سازید، روشن یا خاموش می‌کنید یا حذف می‌کنید، همان لحظه و بدون رفرش در پنل دیده می‌شود.

روی ویندوز هم کار می‌کند؟

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

برای اسکریپت و CI مناسب است؟

بله. با گزینه ‎-o json خروجی فقط JSON است و پیام‌های پیشرفت به stderr می‌روند. گزینه ‎--yes سؤال تأیید را رد می‌کند، ‎--wait تا پایان عملیات صبر می‌کند و کد خروج غیرصفر یعنی عملیات ناموفق بوده است.

CLI اطلاعاتی برای جایی ارسال می‌کند؟

نه. فقط به آدرس API که تنظیم کرده‌اید درخواست می‌فرستد؛ تله‌متری، آنالیتیکس یا بررسی خودکار به‌روزرسانی ندارد و تنها فایلی که می‌نویسد فایل تنظیمات خودش است.