3x-ui/docs/content/docs/fa/guide/index.mdx

---
title: آشنایی با 3x-ui
description: یک پنل تحت وب برای Xray-core — ورودی‌ها، پروتکل‌ها، کلاینت‌ها و اشتراک‌ها را به‌جای ویرایش دستی JSON، از مرورگر خود مدیریت کنید.
icon: Info
---

**3x-ui** یک پنل کنترل تحت وب است که روی
[Xray-core](https://github.com/XTLS/Xray-core)، همان موتور پروکسی که در واقع
ترافیک شما را جابه‌جا می‌کند، قرار می‌گیرد. به‌جای نوشتن و بارگذاری مجدد پیکربندی
JSON ‏Xray به‌صورت دستی، همه‌چیز — ورودی‌ها، پروتکل‌ها، کلاینت‌ها، گواهی‌ها،
اشتراک‌ها — را از یک داشبورد مرورگری مدیریت می‌کنید.

## اجزا چگونه کنار هم کار می‌کنند

<Mermaid
  chart={`
flowchart LR
  Admin["Admin browser"] -->|HTTPS panel| Panel["3x-ui panel"]
  Panel -->|writes config, reloads| Xray["Xray-core"]
  Panel --- DB[("SQLite or PostgreSQL")]
  Clients["Client apps"] -->|VLESS / VMess / Trojan / ...| Xray
  Xray -->|proxied traffic| Internet["Internet"]
`}
/>

- **پنل** لایهٔ مدیریت است: پیکربندی شما را در یک پایگاه‌داده ذخیره می‌کند،
  داشبورد را رندر می‌کند، یک REST API ارائه می‌دهد و پیکربندی زندهٔ Xray را
  می‌نویسد.
- **Xray-core** لایهٔ داده است: اتصالات کلاینت را روی **ورودی‌های** شما
  پایان می‌دهد و ترافیک را به مقصدش هدایت می‌کند.
- **اپلیکیشن‌های کلاینت** (مانند v2rayNG، Clash/Mihomo، Hiddify و دیگران) با
  استفاده از یک لینک اشتراک‌گذاری یا اشتراکی که پنل برای هر کلاینت تولید می‌کند
  متصل می‌شوند.

## چه چیزی در اختیار شما می‌گذارد

- داشبوردی برای **ورودی‌ها** در تمام پروتکل‌های اصلی — VLESS، VMess،
  Trojan، Shadowsocks، WireGuard، AmneziaWG، TUIC v5، Hysteria2، SOCKS، HTTP و Dokodemo-door.
- پشتیبانی درجه‌یک از **REALITY** و **XTLS-Vision** برای ترانسپورت‌های مخفی
  و سریع.
- سهمیه‌های ترافیک **به‌ازای هر کلاینت**، تاریخ‌های انقضا، محدودیت‌های IP،
  وضعیت آنلاین و لینک‌های اشتراک‌گذاری / کدهای QR با یک کلیک.
- **اشتراک‌ها** در قالب‌های VLESS، Clash/Mihomo و JSON.
- ابزارهای عملیاتی: مدیریت **چندنودی**، **ربات‌های Telegram و Discord**، پشتیبان‌گیری،
  محدودسازی IP مبتنی بر Fail2ban و یک REST API مستندشده.

## پشت صحنه

| لایه          | فناوری                                       |
| ------------ | -------------------------------------------- |
| بک‌اند        | Go با فریم‌ورک وب Gin                          |
| فرانت‌اند      | TypeScript / React                           |
| پایگاه‌داده    | SQLite (پیش‌فرض) یا PostgreSQL                 |
| موتور پروکسی | Xray-core (همراه و مدیریت‌شده توسط پنل)        |

پایگاه‌دادهٔ پیش‌فرض SQLite در مسیر `/etc/x-ui/x-ui.db` قرار دارد و پنل به‌صورت
پیش‌فرض روی پورت **2053** گوش می‌دهد. هر دو قابل پیکربندی هستند — به
[نخستین ورود](/docs/guide/first-login) و مرجع متغیرهای محیطی مراجعه کنید.

## برای چه کسانی است

3x-ui برای هر کسی که سرور Xray خودش را اجرا می‌کند طراحی شده است: از یک
VPS شخصی منفرد تا اپراتورهایی که نودها و کلاینت‌های فراوانی را مدیریت می‌کنند. اگر
قدرت Xray-core را می‌خواهید بدون اینکه در فایل‌های پیکربندی JSON زندگی کنید، این
برای شماست.

<Callout type="info">
  3x-ui یک فورک ارتقایافته از پروژهٔ اصلی X-UI است که پشتیبانی گسترده‌تری از
  پروتکل‌ها، پایداری بهبودیافته، حسابداری ترافیک به‌ازای هر کلاینت، مدیریت
  چندنودی و بسیاری از قابلیت‌های راحتی‌بخش را اضافه می‌کند.
</Callout>

آماده‌اید نصب کنید؟ به [نصب](/docs/guide/installation) ادامه دهید.