MHSanaei /3x-ui

Supporting multi-protocol multi-user(Vmess, Vless, Trojan, ShadowSocks, Wireguard, Hysteria, Tunnel, Mixed, HTTP, Tun, MTProto، AmneziaWG)

★ 49,965⑂ 12,784👁 299⑃ 2,025● 4,666▤ 131
GoGPL-3.0Created 2023-02-09docs.sanaei.dev/
Download: v3.11.0v3.11.0 ↓3.11.02026-10-25
+56
Daily
+380
Weekly
49,965
stars
12,784
forks
299
watchers
2,025
prs
4,666
issues
131
releases

README

English | فارسی | العربية | 中文 | Español | Русский | Türkçe


  
    
    
  



  
  
  
  
  
  
  


3X-UI is an advanced, open-source web control panel for managing Xray-core servers. It provides a clean, multi-language interface for deploying, configuring, and monitoring a wide range of proxy and VPN protocols — from a single VPS to multi-node deployments.

Built as an enhanced fork of the original X-UI project, 3X-UI adds broader protocol support, improved stability, per-client traffic accounting, and many quality-of-life features.

 [!IMPORTANT]
 This project is intended for personal use only. Please do not use it for illegal purposes or in a production environment.

 Features

- Multi-protocol inbounds — VLESS, VMess, Trojan, Shadowsocks, WireGuard, AmneziaWG, TUIC v5, Hysteria2, MTProto, HTTP, SOCKS (Mixed), Dokodemo-door / Tunnel, and TUN.
- Modern transports & security — TCP (Raw), mKCP, WebSocket, gRPC, HTTPUpgrade, and XHTTP, secured with TLS, XTLS, and REALITY.
- AmneziaWG built in — DPI-resistant WireGuard runs inside the panel on a userspace network stack, with no kernel module, DKMS, or extra packages to install.
- Native TUIC v5 server — In-process Go QUIC server with Xray routing and per-client traffic accounting; BBR and New Reno are available server-side. CUBIC is preserved in the client profile but currently falls back to New Reno on the server.
- MTProto proxies — per-client FakeTLS secrets, ad-tags, and quotas, applied live without dropping existing connections.
- Fallbacks — serve multiple protocols on a single port (e.g. VLESS and Trojan on 443) using Xray's fallback support.
- Per-client management — traffic quotas, expiry dates, IP limits with trusted-address exemptions, HWID device limits, scheduled renewal cycles, live online status, and one-click share links, QR codes, and subscriptions.
- Traffic statistics — per inbound, per client, and per outbound, with reset controls.
- Multi-node support — manage and scale across multiple servers from a single panel, including cloning inbounds onto other nodes.
- Outbound & routing — WARP, NordVPN, PIA, custom routing rules, load balancers with balancer-to-balancer fallback, and outbound proxy chaining. Bundled geosite and geoip categories are browsable straight from the rule editor.
- Built-in subscription server — raw, JSON, and Clash output, auto-selected from the client's User-Agent, plus custom page templates.
- Telegram and Discord bots for remote monitoring and management.
- RESTful API with scoped, optionally expiring tokens and an in-panel API reference.
- Installable panel (PWA) — pin 3X-UI to a desktop or phone home screen.
- Flexible storage — SQLite (default) or PostgreSQL.
- 14 UI languages with dark and light themes.
- Fail2ban integration for enforcing per-client IP limits.

 Screenshots


Click to expand


  
  



  
  



  
  



  
  




 Quick Start

bash
bash 





   


 Star History

Top issues

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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON