49,649
stars
+64
12,703
forks
297
watchers
2,006
prs
4,652
issues
131
releases
0
discussions
README
English | فارسی | العربية | 中文 | Español | Русский | Türkçe
3X-UI 是一个先进的开源 Web 控制面板,用于管理 Xray-core 服务器。它提供简洁、多语言的界面,用于部署、配置和监控各种代理与 VPN 协议——从单台 VPS 到多节点部署。
3X-UI 作为原始 X-UI 项目的增强分支(fork),增加了更广泛的协议支持、更好的稳定性、按客户端的流量统计以及许多提升使用体验的功能。
[!IMPORTANT]
本项目仅供个人使用。请勿将其用于非法目的,也请勿在生产环境中使用。
功能特性
- 多协议入站 — 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 加密。
- 内置 AmneziaWG — 抗 DPI 的 WireGuard 直接在面板内的用户态网络栈上运行,无需内核模块、DKMS 或额外软件包。
- 内置 TUIC v5 — 基于 QUIC 的高性能代理,支持原生 UDP 中继流量统计、0-RTT 握手和 BBR 拥塞控制。
- MTProto 代理 — 按客户端配置 FakeTLS 密钥、广告标签和配额,实时生效且不会断开已有连接。
- 回落 (Fallback) — 通过 Xray 的 fallback 功能在单个端口上提供多种协议(例如在 443 端口上同时使用 VLESS 和 Trojan)。
- 按客户端管理 — 流量配额、到期日期、可豁免受信任地址的 IP 限制、HWID 设备数限制、定时续期周期、实时在线状态,以及一键分享链接、二维码和订阅。
- 流量统计 — 按入站、按客户端、按出站统计,并支持重置控制。
- 多节点支持 — 从单一面板管理并扩展到多台服务器,并可将入站克隆到其他节点。
- 出站与路由 — WARP、NordVPN、PIA、自定义路由规则、支持均衡器间回退的负载均衡器,以及出站代理链。内置的 geosite 与 geoip 分类可直接在规则编辑器中浏览。
- 内置订阅服务器 — 提供 raw、JSON 和 Clash 输出,可依据客户端 User-Agent 自动选择,并支持自定义页面模板。
- Telegram 和 Discord 机器人,用于远程监控和管理。
- RESTful API,支持带作用域、可设置有效期的令牌,并提供面板内置的 API 参考文档。
- 可安装面板 (PWA) — 将 3X-UI 固定到桌面或手机主屏幕。
- 灵活的存储 — SQLite(默认)或 PostgreSQL。
- 14 种界面语言,支持深色和浅色主题。
- Fail2ban 集成,用于强制执行按客户端的 IP 限制。
截图
点击展开
快速开始
bash
bash
星标历史Top issues
#6973[Bug]: AWG outbound intermittently gets no handshake reply after panel or OS restart (DNS "no answer after 3 attempts")21 comments · 2026-10-27#6943[Bug]: Telegram Bot fails to display interactive menu after /start in v3.11.012 comments · 2026-10-26#6541[Question]: How to reduce master-node sync bandwidth and CPU with ~100 nodes11 comments · 2026-09-15#5889[Feature]: Custom Clash/Mihomo subscription profiles with proxy-groups, rule-providers and rules10 comments · 2026-07-10#7078[Question]: using 3x-ui to connect to office resources (smb)9 comments · 2026-11-05#6727[Bug]: Reality inbound fails on Ubuntu 24 but works on Debian 12 (3x-ui 3.9.0, Min Client Ver 1.0.0)9 comments · 2026-10-04#6658Feature Request: Native MCP Server for AI-driven 3x-ui Management9 comments · 2026-09-26#6014[Feature]: Automatic rotation of Reality short IDs9 comments · 2026-07-17
Latest release
v3.11.0 v3.11.0 2026-10-25🚀 Xray-core v26.10.21, Kernel AmneziaWG, Per-Client Hosts & a Rebuilt Telegram Bot - 🔐 Security hardening — Fresh databases get a random first user, generated WireGuard/AmneziaWG configs are checked line by line, and client IPs behind a proxy can no longer be spoofed. - ⚙️ Xray-core v26.10.21 — The panel follows the new core's XDRIVE and Lua-script rules and adds the finalmask source-IP filter, Lua noise scripts and XDNS over DoH. - 🚄 Kernel AmneziaWG — An opt-in Linux kernel datapath per inbound, plus much faster uploads on the embedded datapath. - 🎯 Smarter hosts — Bind host rules to i