mirror of
https://github.com/MHSanaei/3x-ui.git
synced 2026-10-02 12:12:08 +03: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>
57 lines
3.0 KiB
Plaintext
57 lines
3.0 KiB
Plaintext
---
|
|
title: 认识 3x-ui
|
|
description: 面向 Xray-core 的 Web 面板——在浏览器中管理入站、协议、客户端与订阅，无需手动编辑 JSON。
|
|
icon: Info
|
|
---
|
|
|
|
**3x-ui** 是一个 Web 控制面板，运行在
|
|
[Xray-core](https://github.com/XTLS/Xray-core)（真正负责转发流量的代理引擎）之上。
|
|
你无需手动编写并重载 Xray 的 JSON 配置，而是通过浏览器仪表盘管理一切——入站、协议、客户端、证书、订阅。
|
|
|
|
## 各组件如何协同工作
|
|
|
|
<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 限制、在线状态，以及一键生成分享链接 / 二维码。
|
|
- 支持 VLESS、Clash/Mihomo 和 JSON 格式的**订阅**。
|
|
- 运维工具：**多节点**管理、**Telegram 和 Discord 机器人**、备份、基于 Fail2ban 的 IP 限制，以及一套有文档说明的 REST API。
|
|
|
|
## 底层原理
|
|
|
|
| 层级 | 技术 |
|
|
| ------------ | -------------------------------------------- |
|
|
| 后端 | Go，搭配 Gin Web 框架 |
|
|
| 前端 | 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)。
|