رابط خط فرمان آریانت (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, --output | table (پیشفرض) یا json |
--token | توکن API فقط برای همین دستور |
--api-url | آدرس پایه API فقط برای همین دستور |
هر دستور فلگ --help دارد که فلگها را همراه با مثال نشان میدهد. اسکریپت تکمیل خودکار: arianet completion bash|zsh|fish|powershell.
دسترسیهای توکن
توکن را میتوان به دسترسیهای لازم محدود کرد. اگر توکن دسترسی لازم را نداشته باشد، دستور با INSUFFICIENT_SCOPE خطا میدهد.
| دستورها | دسترسی (scope) |
|---|---|
region list | regions:read |
os list | os:read |
plan list، plan get | plans:read |
vps list/get/status/actions | servers:read |
vps create/delete/restart/power-*/reinstall/rename/toggle-protection | servers:write |
balance، balance transactions | balance:read |
balance invoices | invoices:read |
auth tokens list، auth tokens revoke | tokens:read، tokens:write (auth whoami و auth logout دسترسی لازم ندارند) |
ssh list/get، ssh add/update/delete | ssh-keys:read، ssh-keys:write |
firewall list/get، بقیه دستورهای firewall | firewalls: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، report | sms:messages:write / sms:messages:read |
sms lines list (sms lines request: توکن بدون دسترسی) | sms:lines:read |
sms templates list / بقیه دستورهای sms templates | sms: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 منطقهای، سرور اختصاصی و پیامک
این گروههای دستور از 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 configured | arianet 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 چاپشده دوباره اجرا کنید.
پشتیبانی
- وب سرویس VPS · وب سرویس ابر · پرووایدر Terraform
- صفحه معرفی: ariaservice.net/developers/cli
- پنل: cloud.ariaservice.net
- گزارش مشکل: github.com/ariaservice/arianet-cli/issues