# نیازمندی‌های سیستم

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

Source: https://joinnasnet.com/fa/guides/nasnet-linux/system-requirements/
Last updated: 2026-08-17

---

## مرور کلی

نس‌نت لینوکس روی یک سرور لینوکسی ۶۴ بیتی اجرا می‌شود و همه چیز را همان‌جا نگه
می‌دارد، یعنی پنل، پایگاه‌داده و پروسهٔ `Xray-core` که خودش سرپرستی‌اش می‌کند. نه
مجموعه‌ای از سرورها در کار است و نه سرور دومی که باید آماده کنید. آنچه واقعاً پیش
از نصب باید تصمیم بگیرید این است: کدام پایگاه‌داده، آیا دامنه دارید، و کدام
پورت‌ها را می‌توانید باز کنید.

## سرور

| نیازمندی | مقدار |
| -------- | ----- |
| سیستم‌عامل | لینوکس ۶۴ بیتی |
| معماری | `amd64` یا `arm64` |
| دسترسی | root یا `sudo` |
| پورت پنل | یک پورت ورودی آزاد، به‌طور پیش‌فرض **`9761`** |
| پورت‌های ورودی | هر پورتی که inboundهای پروکسی شما روی آن گوش می‌دهند، جداگانه باز شود |
| دسترسی خروجی | برای گواهی ACME و دریافت ایمیج لازم است؛ بستهٔ آفلاین این نیاز را برمی‌دارد |

باینری‌های منتشرشده ایستا هستند و بدون CGO ساخته می‌شوند، پس محیط اجرای وابسته به
یک توزیع خاص لازم ندارند. داشتن دامنه‌ای که به سرور اشاره کند به‌شدت توصیه می‌شود،
هرچند دقیقاً اجباری نیست، و دلیلش پایین‌تر آمده است.

## دستگاه‌های پشتیبانی‌شده

اینجا دو دستهٔ متفاوت از دستگاه‌ها اهمیت دارند. **سرور** ماشینی است که پنل را اجرا
می‌کند. **کلاینت‌ها** چیزهایی هستند که مشترکان شما برای استفاده از دسترسی پروکسی
به کار می‌برند.

### سرورها

| بستر | پشتیبانی | توضیح |
| ---- | -------- | ----- |
| لینوکس `amd64` | بله | حالت رایج. هم باینری‌های منتشرشده و هم ایمیج‌های Docker پوششش می‌دهند. |
| لینوکس `arm64` | بله | کاملاً پشتیبانی می‌شود، از جمله روی سرورهای مجازی ARM. |
| لینوکس ۳۲ بیتی | خیر | هیچ نسخهٔ ۳۲ بیتی منتشر نمی‌شود. |
| macOS یا ویندوز | خیر | پنل یک پروسهٔ محلی Xray را سرپرستی می‌کند و لینوکس می‌خواهد. |

هر توزیعی کار می‌کند، چون باینری‌های منتشرشده ایستا و بدون CGO ساخته می‌شوند.
چیزی وابسته به توزیع خاص نیست که کنارشان نصب شود.

### برنامه‌های کلاینت

مشترکان چیزی از شما نصب نمی‌کنند. یک لینک `/sub/{key}` را در یک برنامهٔ پروکسی
معمولی می‌چسبانند و سرور با نگاه به `User-Agent` پاسخ را متناسب با همان برنامه‌ای
که درخواست فرستاده برمی‌گرداند.

| کلاینت | بستر معمول |
| ------ | ---------- |
| v2rayNG | اندروید |
| v2rayN | ویندوز |
| Clash و کلاینت‌های خانوادهٔ آن | اندروید، ویندوز، macOS، لینوکس |
| `sing-box` | اندروید، iOS، دسکتاپ |
| Shadowrocket | iOS |

یک لینک برای همهٔ این‌ها کار می‌کند، پس مشترک هیچ‌وقت لازم نیست قالب را دستی
انتخاب کند. کلاینت‌های بیرون این فهرست هم اگر قالب استاندارد اشتراک base64 را
بفهمند کار می‌کنند، ولی پاسخ عمومی می‌گیرند نه پاسخ متناسب‌شده. مشترکی که لینک را
در مرورگر باز کند، به جای آن [پنل مشترک](/fa/guides/nasnet-linux/subscriber-panel/)
را می‌بیند.

## پایگاه‌داده

پیش از نصب یکی را انتخاب کنید. عوض کردنش بعداً یعنی مهاجرت داده.

| گزینه | کجا مناسب است | تنظیم |
| ----- | ------------- | ----- |
| `PostgreSQL 16` | محیط واقعی. پیش‌فرض، و همان چیزی که Docker Compose بالا می‌آورد. | `DB_DRIVER=postgres` |
| SQLite | آزمایش و استقرارهای کوچک تک‌سروری. کانتینر پایگاه‌داده ندارد. | `DB_DRIVER=sqlite` و `DB_PATH=/app/data/nasnet_panel.db` |

مهاجرت‌های ساختار پایگاه‌داده در هر بار بالا آمدن به‌طور خودکار اجرا می‌شوند، پس
ارتقا معمولاً یعنی یک باینری تازه و یک راه‌اندازی دوباره. در هر حال اول یک نسخهٔ
پشتیبان بگیرید.

## TLS و کوکی‌ها

می‌توانید برای آزمایش روی یک IP خالی و HTTP ساده کار کنید، ولی کوکی‌های نشست پنل
از نوع `Secure` هستند: بدون HTTPS ورود شما نمی‌ماند. برای هر چیزی که واقعاً قرار
است استفاده کنید، یا دامنه‌ای به سرور اشاره دهید و بگذارید کلاینت ACME داخلی گواهی
بگیرد، یا TLS را در یک پروکسی جلوی پنل خاتمه دهید.

صدور خودکار به `ACME_EMAIL` نیاز دارد، چون بدون آن صدور غیرفعال است.

## برای نصب با Docker

| نیازمندی | مقدار |
| -------- | ----- |
| Docker Engine | نسخهٔ فعلی |
| افزونهٔ Compose | لازم است، چون مخزن یک `docker-compose.yml` دارد |
| سرویس‌هایی که بالا می‌آیند | برنامه، `PostgreSQL 16` و Prometheus |
| والیوم‌ها | `postgres_data`، `acme_data`، `prometheus_data` و یک bind mount برای نسخه‌های پشتیبان |

## رمزهایی که باید بسازید

هر مسیر نصبی به این‌ها نیاز دارد، هر طور که استقرار دهید. نصب‌کنندهٔ راهنما خودش
می‌سازدشان. در غیر این صورت:

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

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

قرار گرفتن رمز به شکل متن ساده در `ADMIN_PASSWORD_HASH` رایج‌ترین دلیلی است که یک
نصب تازه اجازهٔ ورود نمی‌دهد.

## ساخت از روی کد منبع

فقط برای توسعه لازم است. پنل وب با `go:embed` داخل باینری جاسازی می‌شود، پس باید
**پیش از** `go build` ساخته شود. به جای صدا کردن مستقیم `go build` از هدف‌های
`make` استفاده کنید.

| نیازمندی | مقدار |
| -------- | ----- |
| Go | `1.26` یا بالاتر |
| Node.js | `22` یا بالاتر |
| مدیر بسته | pnpm |

## مرتبط

- [نصب](/fa/guides/nasnet-linux/install/)
- [TLS و دامنه‌ها](/fa/guides/nasnet-linux/tls-and-domains/)
- [معماری](/fa/guides/nasnet-linux/architecture/)