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

نصب CLI ابرکلیک

ابزار خط فرمان (CLI) ابرکلیک به شما امکان می‌دهد مستقیماً از ترمینال، اپلیکیشن‌ها را دپلوی کنید، پایگاه‌های داده را مدیریت کنید و با تمام امکانات پلتفرم کار کنید.

پیش‌نیازها​

▶
ویدیو: نصب و راه‌اندازی CLIplaceholder — ویدیو را اینجا جایگزین کنید

قبل از نصب، مطمئن شوید Node.js نسخه ۱۸ یا بالاتر روی سیستم شما نصب است:

node --version
# خروجی باید v18.0.0 یا بالاتر باشد

اگر Node.js ندارید، آن را از nodejs.org دانلود و نصب کنید.

نصب​

CLI ابرکلیک را به صورت سراسری (global) با npm نصب کنید:

npm install -g @abrclick/cli
نصب با pnpm یا yarn

اگر از pnpm یا yarn استفاده می‌کنید، می‌توانید با دستورهای زیر نصب کنید:

# با pnpm
pnpm add -g @abrclick/cli

# با yarn
yarn global add @abrclick/cli

تایید نصب​

پس از نصب، با دستور زیر نسخه CLI را بررسی کنید:

abrclick --version

خروجی مشابه زیر نمایش داده می‌شود:

@abrclick/cli/1.0.0 linux-x64 node-v20.0.0

ورود به حساب کاربری​

برای استفاده از CLI، باید با حساب ابرکلیک خود وارد شوید:

abrclick login

این دستور یک کد یکبار مصرف به شما نشان می‌دهد و مرورگر را باز می‌کند:

کد تایید شما: ABCD-1234

در مرورگر باز شده، این کد را وارد کنید.
در حال انتظار برای تایید...
جریان احراز هویت دستگاه

CLI از پروتکل استاندارد Device Authorization Flow (RFC 8628) استفاده می‌کند. نیازی نیست رمز عبور را در ترمینال وارد کنید — تنها کافی است کد نمایش‌داده‌شده را در مرورگر تایید کنید.

اگر مرورگر به صورت خودکار باز نشد، لینک نمایش‌داده‌شده در ترمینال را کپی کرده و در مرورگر باز کنید.

پس از تایید در مرورگر، پیام موفقیت در ترمینال نمایش داده می‌شود:

ورود موفقیت‌آمیز بود. خوش آمدید!

تایید ورود​

برای اطمینان از اینکه با حساب درست وارد شده‌اید، دستور زیر را اجرا کنید:

abrclick whoami

اطلاعات حساب کاربری شما نمایش داده می‌شود:

ایمیل:    ali@example.com
نام:      علی رضایی
پلن:      باران (rain)

خروج از حساب کاربری​

برای خروج از حساب در دستگاه فعلی:

abrclick logout

عیب‌یابی​

خطای command not found: abrclick​

اگر پس از نصب، دستور abrclick شناخته نشد، احتمالاً مسیر فایل‌های اجرایی سراسری npm در PATH شما تعریف نشده است.

مرحله ۱: مسیر npm global bin را پیدا کنید:

npm config get prefix

مرحله ۲: مسیر نمایش‌داده‌شده را به PATH اضافه کنید.

روی macOS / Linux (فایل ~/.bashrc یا ~/.zshrc):

export PATH="$(npm config get prefix)/bin:$PATH"

پس از ویرایش فایل، تغییرات را اعمال کنید:

source ~/.zshrc   # یا ~/.bashrc

روی Windows (PowerShell)، مسیر را به متغیر محیطی PATH اضافه کنید:

$npmPrefix = npm config get prefix
[Environment]::SetEnvironmentVariable("Path", "$npmPrefix;" + $env:Path, "User")

سپس یک پنجره PowerShell جدید باز کنید و دوباره امتحان کنید.

مشکل دسترسی (EACCES) روی Linux/macOS

اگر هنگام نصب خطای EACCES permission denied دریافت کردید، از sudo npm install -g استفاده نکنید. به جای آن، مسیر npm global را به یک پوشه‌ای که مالک آن هستید تغییر دهید:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

این دستورات را به ~/.bashrc یا ~/.zshrc اضافه کنید تا دائمی شود.

قدم بعدی​

حالا که CLI نصب شده و وارد شده‌اید، می‌توانید اولین اپلیکیشن خود را دپلوی کنید: