---
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、Hysteria2、SOCKS、HTTP 以及 Dokodemo-door。
- 一流的 **REALITY** 与 **XTLS-Vision** 支持，带来隐蔽、快速的传输方式。
- **按客户端**设置的流量配额、到期日期、IP 限制、在线状态，以及一键生成分享链接 / 二维码。
- 支持 VLESS、Clash/Mihomo 和 JSON 格式的**订阅**。
- 运维工具：**多节点**管理、**Telegram 机器人**、备份、基于 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)。
