# افزونه‌ها

> رجیستری افزونه‌ها را ببینید و کانتینرهای اضافه را روی روتر نصب کنید، با پیشرفت نصب زنده.

Source: https://joinnasnet.com/fa/guides/nasnet-panel/plugins/
Last updated: 2026-08-14

---

## مرور کلی

تب **Plugins** کاتالوگی از نرم‌افزارهای اضافه است که می‌توانید روی خود روتر اجرا
کنید. هر افزونه یک کارت است با نام و نویسنده و نسخه و شعار و دسته‌اش، به اضافهٔ یک
نشان وضعیت و یک دکمهٔ کنش. نصب هر کدام یک کانتینر روی روتر می‌سازد، و کارت یک نوار
پیشرفت نشان می‌دهد که نام مرحلهٔ فعلی را می‌گوید.

افزونه‌هایی که فهرست شده‌اند ولی هنوز نصب‌شدنی نیستند، جای دکمهٔ نصب
**Coming soon** را نشان می‌دهند.

## پیش از شروع

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

## گام‌ها

1. تب **Plugins** را باز کنید.
2. افزونهٔ مورد نظرتان را پیدا کنید. نام نویسنده به صفحهٔ پروژه‌اش لینک است.
3. **Install** را بزنید. کارت با یک نوار پیشرفت به **Installing…** عوض می‌شود.
4. صبر کنید تا نشان به **running** برسد.
5. برای برداشتن یکی، روی افزونهٔ نصب‌شده **Uninstall** را بزنید و در پنجره تأیید
   کنید.

## مرجع

### نشان‌های وضعیت

| نشان | معنی |
| ---- | ---- |
| **installing** | نصبی در جریان است. |
| **running** | نصب شده و کانتینر بالا است. |
| **installed** | نصب شده ولی همین حالا در حال اجرا نیست. |
| **failed** | نصب کامل نشده است. کارت یادداشتی دارد که دلیلش را می‌گوید. |

### مرحله‌های پیشرفت نصب

| مرحله | برچسبی که نشان داده می‌شود |
| ----- | -------------------------- |
| ۱ | `Preparing` |
| ۲ | `Creating interface` |
| ۳ | `Creating mounts` |
| ۴ | `Running pre-install script` |
| ۵ | `Creating container` |
| ۶ | `Pulling image` |
| ۷ | `Starting container` |
| ۸ | `Running post-install script` |

## رفع مشکلات

| نشانه | چه کنید |
| ----- | ------- |
| `Failed to load plugins` | رجیستری افزونه‌ها در دسترس نبوده است. **Retry** را بزنید. |
| `No plugins available — the plugin registry did not return any plugins.` | رجیستری با یک فهرست خالی پاسخ داده است. |
| کارتی نشان failed با یک یادداشت نشان می‌دهد. | یادداشت دلیل توقف نصب را دارد. روی روتر درستش کنید و دوباره نصب کنید. |

## مرتبط

- [نمای کلی](/fa/guides/nasnet-panel/overview/)
- [عیب‌یابی و گزارش](/fa/guides/nasnet-panel/diagnostics/)