mirror of
https://github.com/MHSanaei/3x-ui.git
synced 2026-09-16 23:27:14 +00:00
Egor
a09e136001
* docs: add Discord bot to READMEs, architecture, operations guides, and locales * docs: address review feedback on Discord bot formatting, backup commands, and architecture * docs(discord): fix Persian typo and literal arrows on fa/zh bot pages Senior review of #6513, two LOW findings in the two new pages: - fa/operations/discord-bot.mdx:30 spelled "developers" with Cyrillic "де" in place of Persian "ده", rendering a mixed-script word. - Both pages copied `$\rightarrow$` from the en page. The docs site has no math plugin (nothing in source.config.ts, no remark-math installed), so the built HTML shows the literal string "$\rightarrow$" in every menu path. Replaced with a Unicode arrow on fa and zh; en and ru have carried the same since #6486 and are left for a separate change. --------- Co-authored-by: Sanaei <ho3ein.sanaei@gmail.com>
74 lines
4.7 KiB
Plaintext
74 lines
4.7 KiB
Plaintext
---
|
|
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) ادامه دهید.
|