3x-ui快速开始
认识 3x-ui
面向 Xray-core 的 Web 面板——在浏览器中管理入站、协议、客户端与订阅，无需手动编辑 JSON。
3x-ui 是一个 Web 控制面板，运行在 Xray-core（真正负责转发流量的代理引擎）之上。 你无需手动编写并重载 Xray 的 JSON 配置，而是通过浏览器仪表盘管理一切——入站、协议、客户端、证书、订阅。
各组件如何协同工作
- 面板是管理层：它将你的配置存储在数据库中，渲染仪表盘，暴露 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 端口。两者均可配置——参见
首次登录和环境变量参考。
它适合谁
3x-ui 面向任何运行自己 Xray 服务器的人：从一台个人 VPS，到管理众多节点和客户端的运营者。如果你想拥有 Xray-core 的强大能力，又不想终日埋首于 JSON 配置文件，那么它正适合你。
3x-ui 是原始 X-UI 项目的增强分支，增加了更广泛的协议支持、更高的稳定性、按客户端的流量统计、多节点管理，以及许多提升使用体验的特性。
准备好安装了吗？继续阅读安装。