# نصب‌کنندهٔ راهنما

> بگذارید ابزار nasnet-tool.sh چند سؤال بپرسد و Docker یا systemd را برایتان راه بیندازد.

Source: https://joinnasnet.com/fa/guides/nasnet-linux/install/installer-script/
Last updated: 2026-08-14

---

## مرور کلی

`nasnet-tool.sh` یک رابط متنی تعاملی در ترمینال است که کل چرخهٔ عمر پنل را
می‌پوشاند. روی یک ماشین تازه پیش‌نیازها را وارسی می‌کند، اگر Docker نبود نصبش
می‌کند، رمزها و هش رمز مدیر شما را می‌سازد، `.env` را می‌نویسد و سرویس را در حالت
**Docker** یا **systemd** بالا می‌آورد. بعد از آن همان اسکریپت منوی عملیات شماست:
به‌روزرسانی، پشتیبان‌گیری، بازیابی، پیکربندی دوباره و حذف همه در آن هستند.

## پیش از شروع

- دسترسی root یا `sudo` روی سرور.
- بدانید سرور از کدام راه در دسترس است، با **آدرس IP** یا با **نام دامنه**.
  حالت دامنه است که HTTPS خودکار را ممکن می‌کند.
- تصمیم بگیرید که آیا چیز دیگری از قبل TLS را جلوی پنل خاتمه می‌دهد (nginx،
  Caddy)، و ویزارد می‌پرسد کدام را می‌خواهید.

## گام‌ها

1. مخزن را clone کنید و ابزار را با `sudo` اجرا کنید، چون ممکن است Docker را نصب
کند و سرویس‌های سیستمی بسازد.

```bash
git clone https://github.com/nasnet-community/nasnet-panel-linux.git
cd nasnet-panel-linux
sudo ./nasnet-tool.sh
```

2. روی ماشینی که هنوز `.env` ندارد، ابزار اولین اجرا را تشخیص می‌دهد و پیشنهاد
می‌کند ویزارد نصب را شروع کند. بپذیرید، یا از منوی اصلی **`Setup Wizard`** را
انتخاب کنید.
3. به ویزارد جواب بدهید: سرور از کدام راه در دسترس است (IP یا دامنه)، نام کاربری
و رمز مدیر (رمز را خودش هش می‌کند)، آیا از قبل یک پروکسی معکوس جلوی پنل هست،
حالت استقرار و موتور پایگاه‌داده.
4. بگذارید تا آخر برود. آدرس پنل را چاپ می‌کند، پس بازش کنید و وارد شوید.
5. هر وقت منوی عملیات را لازم داشتید، دوباره `sudo ./nasnet-tool.sh` را اجرا کنید.

## مرجع

| گزینهٔ منو | چه می‌کند |
| --------- | -------- |
| `Setup Wizard` | ویزارد نصب یا پیکربندی دوباره را اجرا می‌کند یا از نو می‌برد. |
| `Update` | نصب را به‌روز می‌کند و نشان می‌دهد چند کامیت عقب هستید. |
| `Auto-Update (Release)` | یک نسخهٔ تازه‌تر را از releaseهای گیت‌هاب پروژه می‌گیرد. |
| `Docker Services` / `Systemd Services` | راه انداختن، متوقف کردن، راه‌اندازی دوباره و بازرسی سرویس. اینکه کدام گزینه دیده می‌شود به `DEPLOY_MODE` بستگی دارد. |
| `Database` | پشتیبان‌گیری، بازیابی و کارهای نگه‌داری پایگاه‌داده. |
| `Monitoring` | کارهای پایش و سنجه. |
| `Security` | کارهای مربوط به امنیت. |
| `Maintenance` | کارهای نگه‌داری. |
| `Uninstall` | نصب را برمی‌دارد. |

حالت استقراری که انتخاب می‌کنید به شکل `DEPLOY_MODE` در `.env` ثبت می‌شود (`docker`
یا `systemd`) تا هر کار بعدی درست رفتار کند. ابزار می‌تواند به‌طور خودکار از
releaseهای `nasnet-community/nasnet-panel-linux` به‌روز شود. اگر به محدودیت نرخ
API گیت‌هاب خوردید، `GITHUB_TOKEN` را در محیط بگذارید.

## رفع مشکلات

| نشانه | چه کنید |
| ----- | ------- |
| ویزارد `systemctl` را پیدا نمی‌کند. | حالت systemd به آن نیاز دارد. یا در پرسش حالت استقرار به حالت Docker سوئیچ کنید، یا روی توزیعی اجرا کنید که بر پایهٔ systemd است. |

## مرتبط

- [Docker Compose](/fa/guides/nasnet-linux/install/docker-compose/)
- [سرویس systemd](/fa/guides/nasnet-linux/install/systemd/)
- [پشتیبان‌گیری](/fa/guides/nasnet-linux/backup/)