آشنایی با 3x-ui
یک پنل تحت وب برای Xray-core — ورودیها، پروتکلها، کلاینتها و اشتراکها را بهجای ویرایش دستی JSON، از مرورگر خود مدیریت کنید.
3x-ui یک پنل کنترل تحت وب است که روی Xray-core، همان موتور پروکسی که در واقع ترافیک شما را جابهجا میکند، قرار میگیرد. بهجای نوشتن و بارگذاری مجدد پیکربندی JSON Xray بهصورت دستی، همهچیز — ورودیها، پروتکلها، کلاینتها، گواهیها، اشتراکها — را از یک داشبورد مرورگری مدیریت میکنید.
اجزا چگونه کنار هم کار میکنند
- پنل لایهٔ مدیریت است: پیکربندی شما را در یک پایگاهداده ذخیره میکند، داشبورد را رندر میکند، یک REST API ارائه میدهد و پیکربندی زندهٔ Xray را مینویسد.
- Xray-core لایهٔ داده است: اتصالات کلاینت را روی ورودیهای شما پایان میدهد و ترافیک را به مقصدش هدایت میکند.
- اپلیکیشنهای کلاینت (مانند v2rayNG، Clash/Mihomo، Hiddify و دیگران) با استفاده از یک لینک اشتراکگذاری یا اشتراکی که پنل برای هر کلاینت تولید میکند متصل میشوند.
چه چیزی در اختیار شما میگذارد
- داشبوردی برای ورودیها در تمام پروتکلهای اصلی — VLESS، VMess، Trojan، Shadowsocks، WireGuard، Hysteria2، SOCKS، HTTP و Dokodemo-door.
- پشتیبانی درجهیک از REALITY و XTLS-Vision برای ترانسپورتهای مخفی و سریع.
- سهمیههای ترافیک بهازای هر کلاینت، تاریخهای انقضا، محدودیتهای IP، وضعیت آنلاین و لینکهای اشتراکگذاری / کدهای QR با یک کلیک.
- اشتراکها در قالبهای VLESS، Clash/Mihomo و JSON.
- ابزارهای عملیاتی: مدیریت چندنودی، یک ربات Telegram، پشتیبانگیری، محدودسازی IP مبتنی بر Fail2ban و یک REST API مستندشده.
پشت صحنه
| لایه | فناوری |
|---|---|
| بکاند | Go با فریمورک وب Gin |
| فرانتاند | TypeScript / React |
| پایگاهداده | SQLite (پیشفرض) یا PostgreSQL |
| موتور پروکسی | Xray-core (همراه و مدیریتشده توسط پنل) |
پایگاهدادهٔ پیشفرض SQLite در مسیر /etc/x-ui/x-ui.db قرار دارد و پنل بهصورت
پیشفرض روی پورت 2053 گوش میدهد. هر دو قابل پیکربندی هستند — به
نخستین ورود و مرجع متغیرهای محیطی مراجعه کنید.
برای چه کسانی است
3x-ui برای هر کسی که سرور Xray خودش را اجرا میکند طراحی شده است: از یک VPS شخصی منفرد تا اپراتورهایی که نودها و کلاینتهای فراوانی را مدیریت میکنند. اگر قدرت Xray-core را میخواهید بدون اینکه در فایلهای پیکربندی JSON زندگی کنید، این برای شماست.
3x-ui یک فورک ارتقایافته از پروژهٔ اصلی X-UI است که پشتیبانی گستردهتری از پروتکلها، پایداری بهبودیافته، حسابداری ترافیک بهازای هر کلاینت، مدیریت چندنودی و بسیاری از قابلیتهای راحتیبخش را اضافه میکند.
آمادهاید نصب کنید؟ به نصب ادامه دهید.

3x-ui