3X-UI

项目简介

3X-UI 是一个基于 Go 语言开发的开源网页控制面板，用于管理 Xray-core 服务。它是原 X-UI 项目的增强分支，在协议支持、稳定性和客户端流量统计等方面做了大量改进，既可用于单台 VPS，也支持多节点部署。

官方声明：本项目仅供个人使用，请勿用于非法用途或生产环境。

核心功能

多协议入站

面板支持在同一套界面中管理多种协议：

• VLESS、VMess、Trojan、Shadowsocks
• WireGuard、AmneziaWG、TUIC v5、Hysteria2
• MTProto、HTTP、SOCKS（Mixed）、Dokodemo-door / Tunnel、TUN

传输层支持 TCP（Raw）、mKCP、WebSocket、gRPC、HTTPUpgrade、XHTTP，并可配合 TLS、XTLS 与 REALITY 使用。

客户端与流量管理

• 按客户端设置流量配额、到期时间、IP 限制与 HWID 设备数
• 实时在线状态、一键分享链接、二维码与订阅
• 按入站、客户端、出站分别统计流量，并支持重置

多节点与路由

• 在单一面板中管理多台服务器，支持把入站配置克隆到其他节点
• 出站支持 WARP、NordVPN、PIA，以及自定义路由规则与负载均衡
• 内置 geosite / geoip 分类，可直接在规则编辑器中浏览

其他能力

• 内置订阅服务器，支持 raw、JSON、Clash 输出，按 User-Agent 自动选择
• Telegram 与 Discord 机器人远程监控管理
• 带作用域与过期时间的 RESTful API，面板内附 API 参考
• 支持 PWA 安装到桌面或手机主屏
• 存储可选 SQLite（默认）或 PostgreSQL
• 14 种界面语言，含深色/浅色主题
• 集成 Fail2ban，用于执行客户端 IP 限制

快速开始

官方提供一键安装脚本：

bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)

安装过程中会生成随机的用户名、密码与访问路径。安装完成后运行 x-ui 可打开管理菜单，进行服务启停、查看或重置登录凭据、管理 SSL 证书等操作。

如需指定版本，可在脚本后追加版本标签；也支持通过 XUI_NONINTERACTIVE=1 进行无人值守安装，便于 cloud-init 场景使用。

数据库选择

• SQLite：默认方案，单文件存储于 /etc/x-ui/x-ui.db，零配置，适合中小规模部署
• PostgreSQL：适合客户端数量较多或多节点场景，安装器可本地安装 PostgreSQL，也可连接已有实例

运行时通过环境变量选择后端：

XUI_DB_TYPE=postgres
XUI_DB_DSN=postgres://xui:password@127.0.0.1:5432/xui?sslmode=disable

已有 SQLite 数据可通过 x-ui migrate-db 命令迁移到 PostgreSQL，原文件会保留，确认无误后可手动删除。

支持平台

• 操作系统：Ubuntu、Debian、Armbian、Fedora、CentOS、RHEL、AlmaLinux、Rocky Linux、Oracle Linux、Amazon Linux、Arch、openSUSE、Alpine、Windows 等
• 架构：amd64、386、arm64、armv7、armv6、armv5、s390x

适用建议

3X-UI 功能覆盖面广，适合已有一定服务器运维基础、希望统一管理多协议代理与多节点部署的用户。初次使用建议先阅读官方文档 docs.sanaei.dev，从单协议单节点开始逐步熟悉面板配置。