# نصب

> یکی از مسیرهای نصب را انتخاب کنید: Docker Compose، نصب‌کنندهٔ راهنما، systemd، باینری‌های منتشرشده یا بستهٔ آفلاین.

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

---

## مرور کلی

نس‌نت لینوکس یک باینری Go است که پنل مدیریت، پنل مشترک و ربات تلگرام را داخل خودش
دارد، پس «نصب» آن یعنی به راه انداختن یک پروسه، با یک فایل `.env` کنارش و یک
پایگاه‌داده که بتواند به آن برسد. پنج مسیر پشتیبانی‌شده هست و همه به یک جا
می‌رسند: پنل روی پورت **`9761`** گوش می‌دهد و یک پروسهٔ `Xray-core` زیر سرپرستی آن
اجرا می‌شود. از همین‌جا شروع کنید تا انتخاب کنید، بعد صفحهٔ فرزند مسیری که انتخاب
کرده‌اید را دنبال کنید.

## پیش از شروع

- یک سرور لینوکسی ۶۴ بیتی (`amd64` یا `arm64`) با دسترسی root یا `sudo`.
- یک پورت ورودی آزاد برای پنل، به‌طور پیش‌فرض **`9761`**، به اضافهٔ هر پورتی که
  inboundهای پروکسی شما روی آن گوش می‌دهند.
- دامنه‌ای که به سرور اشاره کند، اگر HTTPS خودکار می‌خواهید. یک IP خالی روی HTTP
  ساده هم کار می‌کند، ولی کوکی‌های Secure به HTTPS نیاز دارند.
- دو رمز ساخته‌شده و یک هش رمز مدیر. هر مسیر نصبی به این‌ها نیاز دارد، و
  نصب‌کنندهٔ راهنما خودش می‌سازدشان.

```bash
# رمز JWT که باید دست‌کم ۳۲ نویسه باشد
openssl rand -hex 32

# هش رمز پنل مدیریت (bcrypt)
htpasswd -nbBC 10 "" "your-password" | tr -d ':\n' | sed 's/$2y/$2a/'
```

## گام‌ها

1. تصمیم بگیرید چطور می‌خواهید اجرایش کنید. اگر مطمئن نیستید، از
   [نصب‌کنندهٔ راهنما](/fa/guides/nasnet-linux/install/installer-script/) استفاده
   کنید، که اگر Docker نبود نصبش می‌کند، همهٔ رمزها را می‌سازد، `.env` را
   می‌نویسد و سرویس را راه می‌اندازد.
2. صفحهٔ همان مسیر را تا آخر دنبال کنید.
3. آدرس پنل را باز کنید و وارد شوید، همان‌طور که در
   [اولین اجرا و ورود مدیر](/fa/guides/nasnet-linux/first-run/) آمده است.

## مرجع

| مسیر | کجا انتخابش کنید | صفحه |
| ---- | --------------- | ---- |
| Docker Compose | از قبل Docker را اجرا می‌کنید و می‌خواهید خودتان پیکربندی را ویرایش کنید. برنامه، `PostgreSQL 16` و Prometheus را با هم بالا می‌آورد. | [Docker Compose](/fa/guides/nasnet-linux/install/docker-compose/) |
| نصب‌کنندهٔ راهنما | نصب اول، یا می‌خواهید بعدش یک منو برای به‌روزرسانی، پشتیبان‌گیری و حذف داشته باشید. هم Docker را پوشش می‌دهد و هم systemd. | [نصب‌کنندهٔ راهنما](/fa/guides/nasnet-linux/install/installer-script/) |
| systemd | روی میزبان Docker ندارید و می‌خواهید باینری به شکل یک سرویس بومی مدیریت شود. | [سرویس systemd](/fa/guides/nasnet-linux/install/systemd/) |
| باینری‌های منتشرشده | راه‌اندازی دستی، یا دارید پنل را به ابزارهای خودتان وصل می‌کنید. | [باینری‌های منتشرشده](/fa/guides/nasnet-linux/install/binaries/) |
| بستهٔ آفلاین | سرور دسترسی اینترنت خروجی ندارد. PostgreSQL و `Xray-core` را داخل خودش دارد. | [بستهٔ آفلاین](/fa/guides/nasnet-linux/install/offline-bundle/) |

## رفع مشکلات

| نشانه | چه کنید |
| ----- | ------- |
| آدرس پنل پاسخ نمی‌دهد. | وارسی کنید پورت هم در فایروال میزبان و هم در قواعد شبکهٔ سرویس‌دهنده باز باشد، و `APP_PORT` در `.env` با پورتی که منتشر کرده‌اید بخواند. برنامه یک وارسی آمادگی روی `/health/ready` دارد، که پاسخ `200` آن یعنی پروسه بالا است و مشکل جلوتر از آن است. |

## مرتبط

- [اولین اجرا و ورود مدیر](/fa/guides/nasnet-linux/first-run/)
- [TLS و دامنه‌ها](/fa/guides/nasnet-linux/tls-and-domains/)
- [تنظیمات](/fa/guides/nasnet-linux/settings/)