پرش به مطلب اصلی

رابط خط فرمان آریانت (CLI)

ابزار Arianet CLI (دستور arianet) کلاینت رسمی خط فرمان پلتفرم آریانت است و با یک توکن API این‌ها را مدیریت می‌کند:

  • VPSهای شما (arianet vps ...) از طریق وب سرویس VPS
  • سرورها، دیسک‌ها، شبکه‌های خصوصی، فایروال‌ها، IPهای شناور، لود بالانسرها و ایمیج‌های ابر آریانت (arianet cloud ...) از طریق وب سرویس ابر
  • کلیدهای SSH، فایروال‌ها، موجودی و فاکتورها

این ابزار یک فایل اجرایی مستقل برای macOS، لینوکس و ویندوز است. سورس و نسخه‌ها: github.com/ariaservice/arianet-cli. صفحه معرفی: ariaservice.net/developers/cli. برای تعریف زیرساخت به صورت کد، پرووایدر Terraform را ببینید.

نصب و شروع در سه قدم​

۱. نصب​

دستور مناسب سیستم‌عامل خود را در ترمینال اجرا کنید:

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

سپس یک ترمینال جدید باز کنید و arianet version را اجرا کنید تا مطمئن شوید نصب شده است.

۲. اتصال به حساب​

در پنل، صفحه توکن‌های API یک توکن بسازید و آن را به CLI بدهید:

arianet configure

توکن را paste کنید (روی صفحه نمایش داده نمی‌شود). دسترسی‌های لازم هر دستور در بخش دسترسی‌های توکن آمده است.

۳. اولین دستور​

arianet vps list

فهرست سرورهای مجازی شما نمایش داده می‌شود. برای سرورهای ابر آریانت: arianet cloud servers list. برای سفارش سرور، بخش‌های VPS و ابر آریانت را ببینید.

روش‌های دیگر نصب (Homebrew، apt، rpm، دانلود دستی، بررسی امضا)

macOS و لینوکس (Homebrew)

brew trust ariaservice/arianet   # recent Homebrew versions require trusting third-party taps
brew install ariaservice/arianet/arianet

فرمول (ariaservice/homebrew-arianet) فقط آرشیو انتشار را از مخزن CLI دانلود و SHA-256 آن را بررسی می‌کند.

اوبونتو / دبیان (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

مخزن امضا شده است و کلید آن فقط برای همین مخزن معتبر است (signed-by). اثر انگشت کلید: 305A 2F52 0920 153A FC89 8F4A C420 B09C 99E5 515B. بسته هیچ اسکریپت نصب یا حذفی ندارد.

درباره اسکریپت نصب macOS و لینوکس

اسکریپت آرشیو انتشار را دانلود می‌کند، SHA-256 آن را با checksums.txt تطبیق می‌دهد (اگر cosign نصب باشد امضا را هم بررسی می‌کند) و فایل اجرایی را در ~/.local/bin (یا اگر قابل نوشتن باشد /usr/local/bin) کپی می‌کند.

ویندوز (دستی)

به جای اسکریپت PowerShell بالا می‌توانید فایل arianet_<version>_windows_amd64.zip را از صفحه انتشارها دانلود کنید، arianet.exe را از آن بیرون بیاورید و پوشه آن را به PATH اضافه کنید. سپس یک ترمینال جدید باز کنید:

arianet version

دانلود دستی (همه سیستم‌ها)

آرشیو سیستم خود و فایل checksums.txt را از صفحه انتشارها دانلود کنید. نام آرشیوها arianet_<version>_<os>_<arch>.tar.gz است (darwin یا linux، amd64 یا arm64) و بسته‌های .deb و .rpm هم منتشر می‌شوند.

sha256sum --check --ignore-missing checksums.txt   # macOS: shasum -a 256 -c --ignore-missing checksums.txt
tar -xzf arianet_<version>_<os>_<arch>.tar.gz
sudo install -m 0755 arianet /usr/local/bin/arianet
arianet version

فایل checksums.txt امضای Sigstore بدون کلید (checksums.txt.sigstore.json) دارد که با cosign verify-blob قابل بررسی است و هر آرشیو یک SBOM هم دارد.

ساخت از سورس: git clone https://github.com/ariaservice/arianet-cli.git && cd arianet-cli && go build -trimpath -o arianet ./cmd/arianet

CLI فقط با آدرس API تنظیم‌شده (پیش‌فرض https://api.ariaservice.net) و حداکثر روزی یک بار با GitHub برای یافتن نسخه جدید (بخش اعلان نسخه جدید) ارتباط می‌گیرد و هیچ داده تله‌متری ارسال نمی‌کند.

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

از نسخه v0.5.0 به بعد، CLI خودش را به‌روز می‌کند:

arianet upgrade                    # upgrade to the latest release (asks first)
arianet upgrade --check # only report whether a newer release exists
arianet upgrade -y # no confirmation prompt
arianet upgrade --version v0.5.0 # install a specific release
arianet update # same as: arianet upgrade

arianet upgrade تشخیص می‌دهد CLI چطور نصب شده و به همان روش به‌روزش می‌کند؛ در macOS، لینوکس و ویندوز:

روش نصبکاری که arianet upgrade انجام می‌دهد
Homebrewدستور brew upgrade ariaservice/arianet/arianet را اجرا و خروجی آن را نمایش می‌دهد.
apt / dpkgدستور sudo apt-get update && sudo apt-get install --only-upgrade arianet را اجرا می‌کند (اگر امکان پرسیدن نباشد، فقط دستور را چاپ می‌کند).
اسکریپت نصب، دانلود دستی یا zip ویندوزآرشیو انتشار مناسب سیستم‌عامل و معماری را دانلود، با checksumهای انتشار تطبیق و فایل اجرایی را در جای خودش جایگزین می‌کند. اگر مرحله‌ای خطا بدهد، نسخه قبلی حفظ می‌شود.

اگر آخرین نسخه را داشته باشید همین را اعلام می‌کند و چیزی تغییر نمی‌دهد. در نسخه‌های v0.4.x و قدیمی‌تر، به همان روش نصب به‌روز کنید (brew upgrade ariaservice/arianet/arianet، sudo apt update && sudo apt install --only-upgrade arianet یا اجرای دوباره اسکریپت نصب).

اعلان نسخه جدید​

وقتی نسخه جدیدی منتشر شود، arianet پس از اجرای یک دستور، پیام کوتاهی همراه با دستور به‌روزرسانی مناسب روش نصب شما روی stderr چاپ می‌کند:

A new release of arianet is available: 0.4.0 → 0.5.0
To upgrade, run: brew upgrade ariaservice/arianet/arianet

CLI حداکثر روزی یک بار و در پس‌زمینه آخرین نسخه را از GitHub می‌پرسد و این کار هرگز دستوری را کند یا ناموفق نمی‌کند. این اعلان با -o json، وقتی stderr ترمینال نیست، وقتی متغیر CI تنظیم شده یا وقتی ARIANET_NO_UPDATE_NOTIFIER هر مقداری داشته باشد نمایش داده نمی‌شود:

export ARIANET_NO_UPDATE_NOTIFIER=1

تنظیمات​

تنظیمات در فایل config.yaml داخل پوشه تنظیمات کاربر (در لینوکس ~/.config/arianet/ و در macOS ~/Library/Application Support/arianet/) با دسترسی 0600 ذخیره می‌شود. arianet configure show مسیر دقیق و مقادیر فعال را نشان می‌دهد.

arianet configure                       # interactive setup (token typed without echo)
printf '%s' "$TOKEN" | arianet configure --token-stdin
arianet configure --token <token> # avoid on shared machines: visible in the process list and shell history
arianet configure --output json # default output format
arianet configure --api-url <url> # API base URL
arianet configure show # show the current configuration

اولویت از بالا به پایین: فلگ خط فرمان، متغیر محیطی، فایل تنظیمات. اگر آدرس API چیزی غیر از پیش‌فرض باشد، هر دستور روی stderr هشدار می‌دهد که توکن به چه میزبانی ارسال می‌شود.

متغیر محیطیتوضیح
ARIANET_TOKENتوکن API
ARIANET_API_URLآدرس پایه API (پیش‌فرض https://api.ariaservice.net)
ARIANET_NO_UPDATE_NOTIFIERبا هر مقداری، اعلان نسخه جدید را خاموش می‌کند

فلگ‌های سراسری​

فلگتوضیح
-o, --outputtable (پیش‌فرض) یا json
--tokenتوکن API فقط برای همین دستور
--api-urlآدرس پایه API فقط برای همین دستور

هر دستور فلگ --help دارد که فلگ‌ها را همراه با مثال نشان می‌دهد. اسکریپت تکمیل خودکار: arianet completion bash|zsh|fish|powershell.

دسترسی‌های توکن​

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

دستورهادسترسی (scope)
region listregions:read
os listos:read
plan list، plan getplans:read
vps list/get/status/actionsservers:read
vps create/delete/restart/power-*/reinstall/rename/toggle-protectionservers:write
balance، balance transactionsbalance:read
balance invoicesinvoices:read
auth tokens list، auth tokens revoketokens:read، tokens:write (auth whoami و auth logout دسترسی لازم ندارند)
ssh list/get، ssh add/update/deletessh-keys:read، ssh-keys:write
firewall list/get، بقیه دستورهای firewallfirewalls:read، firewalls:write
دستورهای cloud (خواندن / تغییر)cloud:servers:read / cloud:servers:write
cloud pricingنیاز ندارد (عمومی)
دستورهای hosting (خواندن / تغییر)hosting:accounts:read / hosting:accounts:write
دستورهای vps regional (خواندن / تغییر)vps:servers:read / vps:servers:write
دستورهای baremetal (خواندن / تغییر)baremetal:servers:read / baremetal:servers:write
sms send، scheduled cancel، blocked add/delete، webhook / sms messages، batches، scheduled list، inbound، prices، reportsms:messages:write / sms:messages:read
sms lines list (sms lines request: توکن بدون دسترسی)sms:lines:read
sms templates list / بقیه دستورهای sms templatessms:templates:read / sms:templates:write

توکن را می‌توان به فهرستی از IPهای مبدأ هم محدود کرد؛ درخواست از جای دیگر با IP_NOT_ALLOWED رد می‌شود.

VPS​

arianet vps سرورهای مجازی (VPS) را مدیریت می‌کند. server، servers و srv نام‌های مستعار آن هستند، پس اسکریپت‌های قدیمی که arianet server ... را صدا می‌زنند همچنان کار می‌کنند.

شناسه‌های --region، --plan، --os و --ssh-key از دستورهای list متناظر به دست می‌آیند.

کاتالوگ​

arianet region list                     # orderable locations; the ID column is the --region value
arianet plan list --region <id> # plans in a region: vCPU, RAM and disk in GB, price
arianet plan get <id> # plan details and pricing
arianet os list --region <id> # OS templates available in a region

فهرست و جزئیات​

arianet vps list
arianet vps list --status terminated
arianet vps list --page 2 --limit 20
arianet vps get <id>
arianet vps status <id>
arianet vps actions <id> --limit 50

بدون --status، فهرست VPSهای فعال و معلق را نشان می‌دهد. وضعیت‌های دیگر: creating، pending، failed، terminated، powering_on، powering_off، restarting و reinstalling_os. vps actions عملیات انجام‌شده روی VPS (ساخت، ری‌استارت، نصب مجدد و ...) را از جدید به قدیم با نتیجه آن‌ها نشان می‌دهد.

ساخت​

arianet vps create                                   # interactive wizard
arianet vps create --plan 5 --region 1 --os 3 --hostname web-01
arianet vps create --plan 5 --region 1 --os 3 --ssh-key 2
arianet vps create --plan 5 --region 1 --os 3 --password '<root-password>'
arianet vps create --plan 5 --region 1 --os 3 --no-wait --yes --output json
فلگتوضیح
--planشناسه پلن
--regionشناسه منطقه (دیتاسنتر)
--osشناسه سیستم‌عامل
--hostnameنام میزبان
--ssh-keyورود با این کلید SSH ذخیره‌شده به جای رمز عبور
--passwordرمز root دلخواه
--currencyشناسه ارز پرداخت (پیش‌فرض: کیف پول پیش‌فرض)
--idempotency-keyاستفاده دوباره از یک کلید برای تکرار امن سفارش
--no-waitبازگشت بلافاصله پس از پذیرش سفارش
--timeoutحداکثر زمان انتظار برای فعال شدن VPS (پیش‌فرض 15m)
-y, --yesرد شدن از پرسش تأیید
  • اگر نه --ssh-key و نه --password بدهید، یک رمز root قوی و تصادفی ساخته و فقط یک بار چاپ می‌شود. آن را ذخیره کنید.
  • بدون --plan، --region یا --os راهنمای تعاملی آن‌ها را می‌پرسد. این راهنما با --output json اجرا نمی‌شود؛ در اسکریپت هر سه شناسه را بدهید.
  • به طور پیش‌فرض دستور تا فعال شدن VPS صبر می‌کند.

تکرار امن. هر سفارش یک کلید idempotency دارد. اگر پس از ارسال سفارش شبکه قطع شود، اجرای همان دستور با همان --idempotency-key نتیجه اصلی را برمی‌گرداند و VPS دوم خریده نمی‌شود.

محدودیت نرخ. ساخت VPS برای هر توکن و هر حساب محدودیت نرخ دارد و CLI مدت انتظار را اعلام می‌کند.

عملیات​

arianet vps restart <id>   [--wait] [--timeout 15m] [--yes]
arianet vps power-on <id> [--wait]
arianet vps power-off <id> [--wait] [--yes]
arianet vps reinstall <id> --os <id> [--wait] [--yes]
arianet vps delete <id> [--wait] [--yes]
arianet vps rename <id> --name <new-name> # 1-30 characters
arianet vps toggle-protection <id> [--enable | --disable]

ری‌استارت، روشن/خاموش کردن، نصب مجدد و حذف به محض پذیرش عملیات بازمی‌گردند. با --wait تا پایان عملیات صبر می‌شود: پیشرفت روی stderr نوشته می‌شود و اگر عملیات شکست بخورد یا زمان تمام شود، کد خروج غیرصفر است. این دستورها هرگز خودکار تکرار نمی‌شوند.

toggle-protection با --enable یا --disable وضعیت را صریحاً تنظیم می‌کند (تکرار آن در اسکریپت امن است)؛ بدون این دو، وضعیت برعکس می‌شود. VPS محافظت‌شده نه حذف می‌شود و نه نصب مجدد.

کلیدهای SSH​

arianet ssh list [--page 2 --limit 20]
arianet ssh get <id>
arianet ssh add --name laptop --key-file ~/.ssh/id_ed25519.pub --region <id>
arianet ssh add --name laptop --key "ssh-ed25519 AAAA..." --region <id>
arianet ssh update <id> --name <new-name>
arianet ssh delete <id> [--yes]

هر کلید SSH متعلق به یک منطقه است، پس هنگام افزودن --region لازم است. هنگام سفارش با --ssh-key <id> از آن استفاده کنید. arianet cloud ssh-keys همین گروه دستورها است.

فایروال‌ها​

arianet firewall list
arianet firewall get <id>
arianet firewall create --name web-fw --region <id> [--description "..."]
arianet firewall update <id> [--name <name>] [--description "..."]
arianet firewall delete <id> [--yes]

arianet firewall rule add <id> --direction ingress --proto tcp --port 443 --remote-ip 0.0.0.0/0
arianet firewall rule add <id> --direction ingress --proto tcp --port 22 --remote-ip 203.0.113.7/32 --description office
arianet firewall rule add <id> --direction ingress --proto icmp --remote-ip 0.0.0.0/0
arianet firewall rule remove <id> <rule-id> [--yes]

arianet firewall attach <id> --server 42,43
arianet firewall detach <id> --server 42
  • فایروال جدید هیچ قانونی ندارد. قانون اضافه کنید و سپس با attach آن را به VPSها وصل کنید.
  • فلگ‌های rule add: --direction ingress|egress (پیش‌فرض ingress)، --proto tcp|udp|icmp|esp|gre (پیش‌فرض tcp)، --port (پورت یا بازه مثل 8000-9000، برای tcp و udp لازم)، --remote-ip (لازم؛ 0.0.0.0/0 یعنی همه)، --description.
  • شناسه قانون در rule remove همان رشته ستون Rule ID در خروجی firewall get است.
  • attach و detach در هر بار تا ۵۰ سرور می‌پذیرند.

این دستورها فایروال‌های VPS را مدیریت می‌کنند. فایروال‌های ابر آریانت با arianet cloud firewalls مدیریت می‌شوند.

ابر آریانت​

arianet cloud منابع ابر آریانت را از طریق وب سرویس ابر روی <api-url>/cloud/v1 (پیش‌فرض https://api.ariaservice.net/cloud/v1) و با همان توکن مدیریت می‌کند. توکن برای خواندن به cloud:servers:read و برای تغییر به cloud:servers:write نیاز دارد.

رفتار مشترک:

  • فهرست‌ها --label-selector (عبارت‌های جداشده با کاما که همه باید برقرار باشند: key=value، key!=value، key، !key؛ مثلاً "env=prod,tier!=db")، --project-id و --page / --per-page (حداکثر ۱۰۰) می‌پذیرند. بدون --page همه صفحه‌ها دریافت می‌شوند.
  • ساخت‌ها --labels key=value (قابل تکرار یا جداشده با کاما) و --project-id می‌پذیرند.
  • دستورهای update نام، برچسب‌ها (--labels، --clear-labels)، محافظت در برابر حذف (--protection-delete=true|false) و پروژه (--project-id) را تغییر می‌دهند.
  • عملیات به صورت ناهمگام اجرا می‌شوند و یک action برمی‌گردانند که CLI شناسه آن را چاپ می‌کند. --wait تا پایان آن صبر می‌کند (پیشرفت روی stderr، --timeout با پیش‌فرض 15m) و در صورت شکست یا اتمام زمان، کد خروج غیرصفر است.
  • get با describe و show، list با ls و delete با rm هم کار می‌کند (حذف بدون -y تأیید می‌گیرد).
  • خواندن‌هایی که به محدودیت نرخ بخورند پس از Retry-After (اگر حداکثر ۳۰ ثانیه باشد) تکرار می‌شوند. تغییرات هرگز خودکار تکرار نمی‌شوند.

کاتالوگ و حساب​

arianet cloud datacenters                         # locations (the --datacenter codes); alias: locations
arianet cloud plans [--datacenter <code>] # server types (the --plan IDs)
arianet cloud images list [--type system|app|snapshot|backup] [--datacenter <code>]
arianet cloud images get <id|image> # e.g. ubuntu-24.04
arianet cloud pricing [--datacenter <code>] # public price list, no token needed
arianet cloud pricing --account # your account's own price rows (needs a token)
arianet cloud limits [--datacenter <code>] # quotas and usage per datacenter

cloud pricing لیست قیمت عمومی (/cloud/v1/public/pricing) را بدون مالیات بر ارزش افزوده می‌خواند و توکن نمی‌فرستد، پس قبل از arianet configure هم کار می‌کند.

سرورهای ابری​

arianet cloud servers list [--label-selector env=prod] [--page 1 --per-page 50]
arianet cloud servers get <id>

arianet cloud servers create --name web-1 --datacenter ovh --plan 3 --image ubuntu-24.04 --ssh-key-id 5 --wait
arianet cloud servers create --name web --count 3 --datacenter ovh --plan 3 --image ubuntu-24.04 \
--labels env=prod --firewall 2 --network 4 --no-ipv6
arianet cloud servers create --name db-1 --datacenter ovh --plan 5 --image debian-12 \
--user-data-file cloud-init.yaml --backups --project-id 2 -o json
فلگ createتوضیح
--nameنام سرور (با --count: name، name-2، ...)
--datacenterکد دیتاسنتر (arianet cloud datacenters)
--planشناسه پلن (arianet cloud plans)
--imageایمیج (arianet cloud images list)
--ssh-key-idشناسه کلید SSH ذخیره‌شده (قابل تکرار)
--ssh-keyکلید عمومی برای نصب (قابل تکرار)
--countساخت همزمان چند سرور
--firewallشناسه فایروال (قابل تکرار)
--networkشناسه شبکه خصوصی (قابل تکرار)
--volumeشناسه دیسک برای اتصال (قابل تکرار)
--no-ipv4، --no-ipv6بدون آدرس عمومی IPv4 / IPv6
--backupsفعال کردن پشتیبان‌گیری روزانه
--user-data-fileفایل user data برای cloud-init
--no-startسرور پس از ساخت روشن نشود
--labels، --project-id، --wait، --timeoutمانند بالا
arianet cloud servers update <id> [--name n] [--labels k=v | --clear-labels] [--protection-delete=true] [--protection-rebuild=true]
arianet cloud servers delete <id> [--reason price] [--note "..."] [--keep-backups] [--delete-snapshots] [--yes] [--wait]

arianet cloud servers power-on|power-off|shutdown|reboot|reset <id> [--wait]
arianet cloud servers rebuild <id> --image ubuntu-24.04 [--wait] # erases the disk
arianet cloud servers change-type <id> --plan <id> [--wait] # aliases: resize, change-plan
arianet cloud servers enable-rescue <id> # prints the rescue password once
arianet cloud servers disable-rescue <id>
arianet cloud servers reset-password <id> # prints the new root password once
arianet cloud servers change-ipv4 <id> [--confirm-paid] # new public IPv4
arianet cloud servers attach-network <id> --network <id> [--subnet <id>] [--ip 10.0.1.5]
arianet cloud servers detach-network <id> --network <id>
arianet cloud servers enable-backup <id> [--window-hour 3] # hour in UTC, 0-23
arianet cloud servers change-backup-window <id> --window-hour 4
arianet cloud servers disable-backup <id>
arianet cloud servers create-backup <id> [--wait]
arianet cloud servers restore-backup <id> --backup <id> [--wait] # erases the disk
arianet cloud servers create-image <id> --name before-upgrade [--description "..."] [--wait]
arianet cloud servers actions <id>
arianet cloud servers costs <id>
  • power-off برق را قطع می‌کند (توقف سخت)؛ shutdown از سیستم‌عامل می‌خواهد خاموش شود (ACPI). reboot راه‌اندازی مجدد عادی و reset ری‌ست سخت است.
  • مقدار delete --reason یکی از price، performance، ip_filtered، no_longer_needed، migrating، support و other است (other به --note نیاز دارد). --keep-backups پشتیبان‌های کامل‌شده را به صورت اسنپ‌شات نگه می‌دارد که تا زمان حذف، بر اساس GB هزینه دارند. --delete-snapshots اسنپ‌شات‌های محافظت‌نشده سرور را هم حذف می‌کند؛ به طور پیش‌فرض اسنپ‌شات‌ها پس از حذف سرور باقی می‌مانند.
  • costs نرخ ساعتی و ماهانه فعلی سرور را به تفکیک هر بخش (پلن، IPv4 اصلی، IPهای شناور و elastic، دیسک‌های متصل، افزونه پشتیبان)، جمع کل و هزینه اسنپ‌شات‌ها و پشتیبان‌های نگه‌داشته‌شده پس از حذف نشان می‌دهد.
  • اگر تغییر IP هزینه داشته باشد، change-ipv4 به --confirm-paid نیاز دارد.
  • رمز root یا rescue که create، rebuild، enable-rescue، reset-password یا restore-backup برمی‌گردانند فقط یک بار چاپ می‌شود. آن را ذخیره کنید.

دیسک‌ها (Volume)​

arianet cloud volumes list|get|update|delete ...
arianet cloud volumes create --name data --size 50 --datacenter ovh
arianet cloud volumes create --name data --size 50 --server 12 --filesystem ext4 --wait
arianet cloud volumes attach <id> --server <id> [--wait]
arianet cloud volumes detach <id>
arianet cloud volumes resize <id> --size 100 [--wait] # grow only, size in GB

شبکه‌های خصوصی​

arianet cloud networks list|get|update|delete ...
arianet cloud networks create --name backend --datacenter ovh --ip-range 10.0.0.0/16 [--subnet-ip-range 10.0.1.0/24] [--wait]
arianet cloud networks subnets add <network-id> --ip-range 10.0.2.0/24
arianet cloud networks subnets delete <network-id> <subnet-id>
arianet cloud networks routes set <network-id> --route 10.100.0.0/16=10.0.1.5 # destination=gateway, repeatable
arianet cloud networks routes set <network-id> --clear

فایروال‌های ابر​

arianet cloud firewalls list|get|update|delete ...
arianet cloud firewalls create --name web \
--rule direction=in,protocol=tcp,port=443,source=0.0.0.0/0,source=::/0 \
--rule direction=in,protocol=tcp,port=22,source=203.0.113.4/32 --server 12
arianet cloud firewalls create --name web --rules-file rules.json
arianet cloud firewalls rules set <id> --rule direction=in,protocol=tcp,port=80,source=0.0.0.0/0
arianet cloud firewalls rules set <id> --rules-file rules.json | --clear
arianet cloud firewalls apply-to <id> --server 12 --server 13
arianet cloud firewalls apply-to <id> --label-selector "env=prod,tier!=db" --wait
arianet cloud firewalls remove-from <id> --label-selector env=prod
arianet cloud firewalls set-servers <id> --server 12,13 | --none

هر قانون به شکل direction=in|out,protocol=tcp|udp|icmp|esp|gre,port=<پورت یا بازه>,source=<CIDR> است (source= قابل تکرار است، برای قوانین خروجی destination= و به صورت اختیاری description=). rules set همه قوانین را یکجا جایگزین می‌کند. هدف label selector از برچسب‌ها پیروی می‌کند: سرورهایی که بعداً برچسب منطبق بگیرند فایروال را می‌گیرند و سرورهایی که آن را از دست بدهند، فایروال را هم از دست می‌دهند.

IPهای شناور​

arianet cloud floating-ips list|get|update|delete ...
arianet cloud floating-ips create --type ipv4 --datacenter ovh --name vip
arianet cloud floating-ips create --type ipv4 --server 12 --wait
arianet cloud floating-ips assign <id> --server <id> [--wait]
arianet cloud floating-ips unassign <id>
arianet cloud floating-ips dns-ptr <id> --ptr web.example.com | --reset

لود بالانسرها​

arianet cloud load-balancers types
arianet cloud load-balancers list|get|update|delete ...
arianet cloud load-balancers create --name web --datacenter ovh --type lb11 \
--service tcp:80 --service tcp:443 --target label_selector:role=web --wait
arianet cloud load-balancers add-service <id> --protocol http --listen-port 80 --health-protocol http --health-path /healthz
arianet cloud load-balancers update-service <id> --port 80 --protocol tcp --listen-port 80 --destination-port 8081
arianet cloud load-balancers delete-service <id> --listen-port 443
arianet cloud load-balancers set-services <id> --services-file services.json [--algorithm least_connections]
arianet cloud load-balancers add-target <id> --server 12 | --ip <address> | --label-selector role=web [--use-private-ip]
arianet cloud load-balancers remove-target <id> --target-id 17
arianet cloud load-balancers change-algorithm <id> --algorithm round_robin|least_connections
arianet cloud load-balancers change-type <id> --type lb21
arianet cloud load-balancers attach-network <id> --network 4
arianet cloud load-balancers detach-network <id>
arianet cloud load-balancers health <id>

سرویس‌ها روی tcp، http یا https (عبور مستقیم TLS) گوش می‌دهند. فلگ‌های سرویس شامل --destination-port، --proxyprotocol، --sticky-sessions، --cookie-name و بررسی سلامت (--health-protocol tcp|http، --health-port، --health-path، --health-domain، --health-status-code، --health-interval، --health-timeout، --health-retries) است. --no-public-interface در create یک لود بالانسر فقط خصوصی می‌سازد.

Actionها​

arianet cloud actions list [--resource-type server --resource-id 12] [--status running|success|error] [--since <RFC 3339>]
arianet cloud actions get <id>
arianet cloud actions wait <id> [<id>...] [--timeout 30m]

هاستینگ، VPS منطقه‌ای، سرور اختصاصی و پیامک​

از نسخه v0.6.0

این گروه‌های دستور از CLI نسخه v0.6.0 در دسترس‌اند. نسخه قدیمی‌تر را با arianet upgrade به‌روز کنید.

این گروه‌ها وب سرویس‌های هاستینگ، VPS منطقه‌ای، سرور اختصاصی و پیامک را با همان توکن صدا می‌زنند. همه دستورهایشان --region <code> را برای انتخاب ریجن می‌پذیرند (بدون آن ریجن پیش‌فرض محصول) و با -o json پاسخ وب سرویس را همان‌طور که هست چاپ می‌کنند. برای هر endpoint که دستوری ندارد، api <METHOD> <path> [--data JSON] در هر گروه هست. دستورهای ساخت، --data یا --file را هم برای کل بدنه JSON می‌پذیرند.

هاستینگ​

arianet hosting datacenters | plans [--datacenter <code>] [--kind shared|reseller]
arianet hosting accounts list|get|usage|nameservers|traffic|actions <id>
arianet hosting accounts create --datacenter <code> --plan-id <id> --term monthly --domain example.com --password '...'
arianet hosting accounts change-plan <id> --plan-id <id> | renew <id> | password <id> --password '...' | login <id> | delete <id>
arianet hosting dns list|add|update|delete <account-id> ...
arianet hosting email list|add|update|delete <account-id> ...
arianet hosting databases list|create|delete|grant|users|user-create|user-password|user-delete <account-id> ...
arianet hosting ssh-keys list|add|delete <account-id> ...
arianet hosting actions list|get|wait

VPS منطقه‌ای​

arianet vps (بدون regional) همچنان VPSهای /api/v1/servers را مدیریت می‌کند. VPSهای منطقه‌ای (مثل iran-1) زیر arianet vps regional هستند:

arianet vps regional datacenters | plans | images
arianet vps regional servers list|get|delete|start|stop|restart|kill|console|traffic|actions <id>
arianet vps regional servers create --datacenter <code> --plan-id <id> --image ubuntu-24.04 --hostname web-1 --billing-mode hourly [--wait]
arianet vps regional servers reinstall <id> --image <image> | resize <id> --plan-id <id> | reset-password <id>
arianet vps regional actions list|get|wait

رمز root ساخته‌شده فقط یک بار چاپ می‌شود.

سرور اختصاصی​

arianet baremetal suppliers | ranges | plans | rules | options <catalog> <plan-code>
arianet baremetal quote --catalog eco --plan-code <code> --datacenter <dc> --memory <m> --storage <s> --bandwidth <b>
arianet baremetal orders create ... --rules-version <v> --accept-rules
arianet baremetal orders list|get|cancel <id>
arianet baremetal servers list|get|credentials|renewals|renew|os-templates|reinstall-status <id>
arianet baremetal servers reinstall <id> --template <os>

پیامک​

arianet sms lines list | request [--number <n>] [--note "..."]
arianet sms send --from <line-id> --to 09121234567 --to 09351234567 --body "Your code is 1234" [--reference order-981]
arianet sms send --from <line-id> --to 09121234567 --template <id> --at 2026-12-01T09:00:00+03:30
arianet sms messages list [--status failed] [--batch <id>] [--to <n>] [--page 2 --per-page 100] | get <id>
arianet sms batches list|get <id>
arianet sms scheduled list | cancel <id>
arianet sms inbound | prices | report [--from 2026-11-01] [--to 2026-11-30]
arianet sms templates list|get|create|update|delete
arianet sms blocked list [--phone <n>] | add | delete
arianet sms webhook get | set --url <url> | rotate-secret

موجودی و فاکتورها​

arianet balance                                  # wallet balance
arianet balance transactions [--page 2]
arianet balance invoices [--status paid] [--page 2 --limit 20]
arianet balance invoices get <number> # one invoice with its line items

قالب‌های خروجی​

خروجی پیش‌فرض table برای انسان است. -o json (--output json) داده API را به صورت JSON برای اسکریپت چاپ می‌کند:

arianet vps list -o json | jq -r '.[] | select(.status == "active") | .id'
arianet cloud servers list --label-selector env=prod -o json | jq -r '.[].id'

با -o json:

  • stdout فقط نتیجه JSON را دارد. پیشرفت، خروجی --wait و راهنماها روی stderr می‌روند و اعلان نسخه جدید نمایش داده نمی‌شود.

  • پرسش‌های تأیید روی stderr نوشته می‌شوند. در اسکریپت --yes بدهید تا منتظر ورودی نماند.

  • برای دستورهای ابر، پاسخ همان‌طور که API برگردانده چاپ می‌شود و پس از --wait، actions نهایی هم اضافه می‌شود.

  • خطاها روی stderr به این شکل نوشته می‌شوند:

    {"success":false,"error":{"code":"INSUFFICIENT_BALANCE","message":"...","status":402}}

کدهای خروج​

کدمعنی
0موفق
1هر خطایی، از جمله --wait ناموفق، با اتمام زمان یا متوقف‌شده

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

سفارش VPS و گرفتن شناسه آن:

out=$(arianet vps create --plan 5 --region 1 --os 3 --hostname web-01 \
--ssh-key 2 --yes --output json) || exit 1
id=$(echo "$out" | jq -r '.id')

تکرار امن با کلیدی که خودتان تعیین می‌کنید:

key="order-$(date +%Y%m%d)-web-01"
until arianet vps create --plan 5 --region 1 --os 3 --hostname web-01 \
--ssh-key 2 --yes --idempotency-key "$key" --output json; do
sleep 30
done

ساخت سه سرور ابری پشت یک لود بالانسر:

arianet cloud servers create --name web --count 3 --datacenter ovh --plan 3 \
--image ubuntu-24.04 --ssh-key-id 5 --labels role=web --wait
arianet cloud load-balancers create --name web --datacenter ovh --type lb11 \
--service tcp:80 --target label_selector:role=web --wait

رفع مشکل​

پیام / کدعلت و راه‌حل
No API token configuredarianet configure را اجرا کنید یا ARIANET_TOKEN را تنظیم کنید.
UNAUTHORIZEDتوکن اشتباه، باطل یا منقضی است. arianet configure show را بررسی و توکن جدید بسازید.
INSUFFICIENT_SCOPEتوکن دسترسی این دستور را ندارد (دسترسی‌های توکن).
IP_NOT_ALLOWEDتوکن به IPهای دیگری محدود شده است.
INSUFFICIENT_BALANCEکیف پول را شارژ و دوباره تلاش کنید. arianet balance موجودی را نشان می‌دهد.
NO_DEFAULT_WALLETکیف پول پیش‌فرض ندارید. --currency <id> بدهید.
FEATURE_NOT_SUPPORTEDاین منطقه کلید SSH یا فایروال ندارد. arianet region list پشتیبانی هر منطقه را نشان می‌دهد.
RATE_LIMIT_EXCEEDED / rate_limit_exceededدرخواست‌ها زیاد است. پیام مدت انتظار را می‌گوید.
UPSTREAM_ERROR / UPSTREAM_UNAVAILABLE / WRITES_UNAVAILABLEموقتاً در دسترس نیست. صبر و دوباره تلاش کنید؛ سفارش VPS را با همان --idempotency-key تکرار کنید.
VALIDATION_ERROR / invalid_inputیک ورودی رد شد. پیام نام فیلد را می‌گوید.

اگر vps create پس از ارسال سفارش قطع شد، پیش از سفارش دوباره arianet vps list را بررسی کنید یا همان دستور را با --idempotency-key چاپ‌شده دوباره اجرا کنید.

پشتیبانی​