X-UI installation and usage tutorial, Xray panel supports multi-protocol and multi-user Xray visualization panel

Xray panel visualization panel X-UI, real-time monitoring of server status

Xray面板 X-UI 面板非常方便，支持Reality协议，不仅能可视化搭建SS、V2ray、Xray、TrojanAnd other popular protocols, and you can also see the performance status of VPS and traffic usage in real time. X-UI developed with GO language has better performance and very low memory usage. Supported protocols: reality,vless, trojan,shadowsocks, dokodemo-door, socks, http

Xray面板可视化面板X-UI：实时监控服务器状态的强大工具

在数字化时代，网络代理服务已成为保障数据安全与访问自由的核心需求。作为一款高效的Xray核心可视化管理面板，X-UI以其简洁直观的界面和强大功能，迅速成为服务器管理员的首选工具。它支持多协议、多用户的代理搭建，包括Shadowsocks、VMess、Trojan、VLESS等热门协议，让用户轻松实现跨平台网络加速与隐私保护。不同于传统的命令行操作，X-UI提供图形化面板，允许用户通过浏览器一键配置节点、生成订阅链接，并Real-time monitoring服务器运行状态。

想象一下，您拥有一台VPS服务器，却苦于手动追踪流量消耗、连接数波动或CPU负载峰值。X-UI的实时监控模块完美解决这一痛点。它内置流量统计仪表盘，展示用户上传/下载数据、在线时长和峰值带宽使用情况，支持图表可视化，让异常瞬间显露无遗。同时，面板集成系统资源监测，实时显示CPU、内存、磁盘占用率和网络I/O，帮助您及时发现瓶颈，避免服务中断。此外，X-UI支持Telegram机器人通知功能，一旦流量超阈或面板登录异常，即推送警报，确保服务器24/7稳定运行。

安装X-UI同样简单便捷。只需在Debian/Ubuntu/CentOS系统上执行一键脚本，几分钟内即可部署完成。面板默认端口54321，支持HTTPS加密访问，并兼容CDN acceleration，提升全球访问速度。对于高级用户，它还提供REALITY协议配置、无需域名证书的快速搭建，以及多用户分级管理，避免资源滥用。

X-UI不仅仅是面板，更是智能守护者。它助力开发者构建私有代理网络，企业和团队实现安全远程办公，甚至个人用户轻松绕过地域限制，畅享全球内容。选择X-UI，您将获得高效、可靠的服务器管理体验，让网络代理从复杂转为乐趣。

existGitHubThere are several X-UI branch projects on the website, which are currently being updated and maintained.

• MHSanaei's 3x-ui project:https://github.com/MHSanaei/3x-ui  (The x-ui project is being continuously updated)
• qist's xray-ui project:https://github.com/qist/xray-ui (The x-ui project is being continuously updated)
• vaxilu's x-ui project:https://github.com/vaxilu/x-ui  (The original version of the x-ui project was discontinued on August 25, 2021)
• FranzKafkaYu's X-UI project:https://github.com/FranzKafkaYu/x-ui  (Archived by the owner on December 11, 2023.)
• X-ui project of sing-web:https://github.com/sing-web/x-ui (x-ui project updates are until July 15, 2023)
• x-ui project by alireza0:https://github.com/alireza0/x-ui(The x-ui project is being continuously updated)
• Diditra's x-ui project:https://github.com/diditra/x-ui (Project updated as of May 15, 2023)
• X-ui English version:https://github.com/NidukaAkalanka/x-ui-english

X-UI project supports the latestSupport Reality Protocol, which is also a relatively safe protocol at present!

X-UI installation configuration requirements

Memory

• 128MB minimal/256MB+ recommend

operating system

• CentOS 7+
• Ubuntu 16+
• Debian 8+

MHSanaei's 3x-ui project

Xray Panel supports Multi-protocol Multi-user Expiry & Traffic & IP Restrictions (Vmess & Vless & Trojan & ShadowSocks & Wireguard) Advanced Web Panel • Built on Xray Core.

3X-UI——先进的开源网页控制面板，专为管理 Xray-core 服务器而设计。它提供了用户友好的界面，用于配置和监控各种 VPN 和代理协议。

最后更新：2025年10月16日

更多内容：https://github.com/MHSanaei/3x-ui/wiki

Project contact information:t.me/panel3xui

MHSanaei's 3x-ui function introduction

• System status monitoring
• Search in all inbound and customer
• Dark/Light Theme
• Supports multiple users and multiple protocols
• Support protocols, including VMess, VLESS, Trojan, Shadowsocks, Dokodemo-door, Socks, HTTP, wireguard
• Supports XTLS native protocols, including RPRX-Direct, Vision, REALITY
• Traffic statistics, traffic limits, expiration time limit
• Customizable X-ray configuration templates
• Support HTTPS access panel (self-provided domain name + SSL certificate)
• Support one-click SSL certificate application and automatic renewal
• For more advanced configuration items, please refer to the panel
• Fix API routing (user settings will be created using API)
• Supports changing configuration through different items available in the panel.
• Support export/import database from panel

最新更新

• feat: 添加 ldap 组件 @konstpic
• 功能：添加更新脚本 @cherts
• 功能：添加文件记录器支持 @slavafyi
• 添加对 OpenSUSE Leap 的支持 @xujiegb
• 片段：MaxSplit
• Developer Tools

更新与改进

• Xray-core v25.10.15
• 在安装中为 wget 添加 IPv4
• 首先尝试原生 CPU 实现
• [安全] 用随机生成器替换基于时间戳的密码生成 @xujiegb
• 登录：自动完成密码
• 微小的变化
• 更新 translate.ru_RU.toml @thefsfc
• 更新依赖项

Bug Fixes

• 修复（导入）：通过验证临时数据库然后交换来防止 SQLite 磁盘 I/O 错误
• 修复：修复删除方法 @konstpic
• 修复 tgbot 中的俄语翻译 @dimasmir03
• 修复：登录动画 @TaraRostami
• 使固定

MHSanaei's 3x-ui installation and upgrade

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

Install a custom version. To install the version you want, add the version to the end of the installation command. For example, for version v2.2.1:

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

Screenshots of 3x-ui by MHSanaei

vaxilu's x-ui project

Supports multi-protocol and multi-user xray panel

Vaxilu's x-ui function introduction

• System status monitoring
• Supports multi-user and multi-protocol, web page visualization operation
• Supported protocols: reality, vmess, vless, trojan, shadowsocks, dokodemo-door, socks, http
• Support configuring more transmission configurations
• Traffic statistics, traffic limit, time limit
• Customizable xray configuration templates
• Support https access panel (with own domain name + ssl certificate)
• Support one-click SSL certificate application and automatic renewal
• For more advanced configuration items, see the panel

Installation of vaxilu's x-ui

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

FranzKafkaYu's X-UI project

Lightweight Xray Panel with multi-protocol and multi-user on the same port, support for English and Telegram bots. Easy to use and easy to manage.

Support single-port multi-user, multi-protocol xray panel,
Monitor and manage your proxy services quickly and easily with a free Telegram bot
⚡xtls-rprx-visionandrealityFor a quick start, please seehere

FranzKafkaYu x-ui Function Introduction

• System status monitoring
• Supports single-port multi-user, multi-protocol, web page visualization operation
• Supported protocols: reality, vmess, vless, trojan, shadowsocks, shadowsocks 2022, dokodemo-door, socks, http
• Support more transport configurations: http, tcp, ws, grpc, kcp, quic
• Traffic statistics, traffic limit, time limit, one-click reset and device monitoring
• Customizable xray configuration templates
• Support https access panel (self-provided domain name + ssl certificate)
• Support one-click SSL certificate application and automatic renewal
• Telegram bot notification and control functions
• For more advanced configuration items, see Panel

FranzKafkaYu x-ui update history

• 2023.07.18: Randomly generate Reality dest and serverNames, remove Microsoft domain names; refine sniffing configuration
• 2023.06.10: OpenTLSAutomatically reuse panel certificates and domain names; add certificate hot reload settings; optimize device restriction function
• 2023.04.09: Support Reality; support new telegram bot control commands
• 2023.03.05: Support user expiration time limit; random username, password and port generation
• 2023.02.09: Support user traffic restriction and statistics within a single port; support VLESS utls configuration and sharing link export
• 2022.12.07: Added device concurrency limit; refined tls configuration, supporting minVersion, maxVersion and cipherSuites selection
• 2022.11.14: Add xtls-rprx-vision flow control option; automatically update geo and clear logs at regular intervals
• 2022.10.23：实现全英文支持;增加批量导出分享链接功能；优化页面细节与Telegram通知
• 2022.08.11: Implement Vmess/Vless/Trojan single port multi-user; add CPU usage limit reminder
• 2022.07.28: Added acme standalone mode to apply for certificates; added x-ui automatic keep-alive mechanism; optimized compilation options to adapt to more systems
• 2022.07.24: Added automatic generation of panel root path, node traffic automatic reset function, and device IP access change notification function
• 2022.07.21: Added node IP access change reminder, added stop/restart xray function on the Web panel, optimized some translations
• 2022.07.11: Add node expiration reminder, traffic warning strategy, add Telegram bot node replication, obtain sharing link, etc.
• 2022.07.03: Refactored Telegram bot function, command control no longer requires keyboard input; added Trojan underlying transmission configuration
• 2022.06.19: Added new Cipher of Shadowsocs2022, added node search and one-click traffic clearing functions
• 2022.05.14: Added Telegram bot Command control function, supporting closing/opening/deleting nodes, etc.
• 2022.04.25: AddedSSHLogin reminder, panel login reminder
• 2022.04.23: Add more Telegram bot reminder functions
• 2022.04.16: Added the function of setting up Telegram bot in the panel
• 2022.04.12: Optimize Telegram Bot notification reminder
• 2022.04.06: Optimize the installation/update process, add certificate issuance function, add Telegram bot push function

FranzKafkaYu x-ui Installation

Before installing, make sure your system supportsbashenvironment, and the system network is normal

⚡You can also use this command to upgrade from the original version, and the data will not be lost⚡

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

bash <(curl -Ls https://raw.githubusercontent.com/FranzKafkaYu/x-ui/master/install_en.sh)

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

qist's xray-ui project

System status monitoring supports multiple protocols and web page visualization operations. Supported protocols: vmess, vless, trojan, shadowsocks, dokodemo-door, socks, http. Support configuration of more transmission configurations. Traffic statistics, limit traffic limits, shorten time. Customizable xray configuration templates. Support https access panel (self-provided domain name + ssl certificate). For more advanced configuration items, see the panel.

qist's xray-ui changelog

2023.8.8 Updated to the latest dependencies and added fragments to control the published TCP segments, which can deceive the review system in some cases, such as bypassing the SNI blacklist.Client Configuration Module Reference Official configuration documentation

2023.5.29 Add and modify the xray-ui crontab command to add geoip update to the scheduled task. The default execution time is 1:30 am. You can use the /etc/crontab file

2023.5.15 Add xray-ui geoip Update IP library Add database import and export

2023.5.6 Fix the cipherSuites configuration multi-select and change the separator from to : I added it as usual without reading the documentation. It's a pity. If you configured cipherSuites at the beginning, please change it to auto and then upgrade and add the topology interface.

2023.5.4 Sniff multiple choices, tls cipherSuites configuration multiple choices!

2023.4.28 Added REALITY sharing to randomly select SNI for easy use of any_SNI_No_SNI configuration solution

2023.4.26Add Nginx front-end SNI diversion

2023.4.24 Add one-click update of geoip, geosite Add geoip, geosite Update version number

qist's xray-ui installation

bash <(curl -Ls  https://raw.githubusercontent.com/qist/xray-ui/main/install.sh)

X-ui project of sing-web

Xray panel supporting multiple protocols and multiple users

Introduction to X-ui of sing-web

• System status monitoring
• Supports multi-user multi-protocol, multi-user on the same port, and Web visualization operation
• Supported protocols: vmess, vless, trojan, shadowsocks, dokodemo-door, socks, http
• Support vless/trojan reality
• Support configuring more transmission configurations
• Traffic statistics, traffic limit, limit expiration time
• Customizable X-ray configuration templates
• Support https access panel (self-provided domain name + ssl certificate)
• Support one-click SSL certificate application and automatic renewal
• For more advanced configuration items, see the panel

X-ui installation of sing-web

bash <(wget -qO- https://raw.githubusercontent.com/sing-web/x-ui/main/install.sh)

Disclaimer: This project is only for personal learning and communication. Please abide by local laws and regulations and do not use it for illegal purposes; do not use it in a production environment

x-ui project by alireza0

Supports xray panel with multi-protocol, multi-user expiration date and traffic (Vmess & Vless & Trojan & Shadowsocks)

Introduction to x-ui by alireza0

• Supported protocols include VLESS, VMess, Trojan, Shadowsocks, Dokodemo-door, SOCKS, HTTP, Wireguard
• Supports XTLS protocols, including Vision and REALITY
• Advanced interface for routing traffic, including proxy protocol, reverse, external and transparent proxy, as well as multiple domains, SSL certificates and ports
• Support for automatic outbound generation using Wireguard Cloudflare WARP
• Interactive JSON interface for Xray template configuration
• High-level interface for inbound and outbound configuration
• Based on the customer traffic limit and validity period for first-time use
• Display online clients, traffic statistics, and system status monitoring
• Deep database search
• Shows exhausted clients that have expired or exceeded their data limits
• Subscription service with (multiple) links
• Importing and exporting databases
• One-click SSL certificate application and automatic renewal
• HTTPS for secure access to the web panel and subscription services (self-provided domain name + SSL certificate)
• Dark/Light Theme

x-ui installation by alireza0

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

Installing a custom version: Step 1: To install the version you want, add the version to the end of the installation command. For example, version 1.7.1

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

alireza0's x-ui interface preview

diditra's x-ui project

Xray panel supports multi-protocol multi-user expiration and traffic (Vmess and Vless) and IP restrictions

Introduction to x-ui by diditra

• System status monitoring
• Supports multi-user, multi-protocol, and web page visualization operations
• Supported protocols: vmess, vless, trojan, shadowsocks, dokodemo-door, socks, http
• Supports feature-rich Telegram bots with built-in account management (VPN Store)
• Traffic statistics, traffic limit, limit expiration time
• Customizable X-ray configuration templates
• Support https access panel (self-provided domain name + ssl certificate)
• Support one-click SSL certificate application and automatic renewal
• For more advanced configuration items, please refer to the panel

Diditra's x-ui installation

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

Install a custom version. To install the version you want, you can add the version to the end of the installation command. Example version v1.1.0:

bash <(curl -Ls https://raw.githubusercontent.com/diditra/x-ui/master/install.sh) v1.1.0

Diditra's x-ui screenshots

x-ui manual installation & upgrade example

1. First fromhttps://github.com/vaxilu/x-ui/releasesDownload the latest compressed package, generally chooseamd64frame
2. Then upload this compressed package to the server/root/directory, and userootUser login server

If your server CPU architecture is notamd64, change theamd64Replace with another architecture

cd /root/ rm x-ui/ /usr/local/x-ui/ /usr/bin/x-ui -rf tar zxvf x-ui-linux-amd64.tar.gz chmod +x x-ui/x-ui x-ui/bin/xray-linux-* x-ui/x-ui.sh cp x-ui/x-ui.sh /usr/bin/x-ui cp -f x-ui/x-ui.service /etc/systemd/system/ mv x-ui/ /usr/local/ systemctl daemon-reload systemctl enable x-ui systemctl restart x-ui

Install using docker

this docker Tutorials and docker images byChasing66supply

Install Docker

curl -fsSL https://get.docker.com | sh

Install x-ui

mkdir x-ui && cd x-ui docker run -itd --network=host \ -v $PWD/db/:/etc/x-ui/ \ -v $PWD/cert/:/root/cert/ \ --name x-ui --restart=unless-stopped \ enwaiax/x-ui:latest

Build your own image

docker build -t x-ui .

SSL Certificate Application

This feature and tutorial are provided byFranzKafkaYusupply

The SSL certificate application function is set in the script. To apply for a certificate using this script, the following conditions must be met:

• Know Cloudflare registration email
• Know the Cloudflare Global API Key
• The domain name has been resolved to the server in question through cloudflare

How to obtain Cloudflare Global API Key: 

To use it, just enterdomain name, Mail,API KEYThen, the display intent is as follows:

Note:

• This script uses the DNS API to request a certificate.
• By default, Let's Encrypt is used as the CA.
• The certificate installation directory is /root/cert
• The certificates applied for by this script are all wildcard domain certificates

Apply for a domain name certificate using Acme script

Note: Before installing the Acme script, install socat first

dnf install -y curl socat wget

After the installation is complete, continue to install the Acme script below.

Installing the Acme Script

curl https://get.acme.sh | sh

If socat is not installed, an error will be reported when installing the script!

How to apply for a certificate when port 80 is idle

Replace the domain name and email address of xxx in the code with the domain name and email address resolved for you.

~/.acme.sh/acme.sh --register-account -m [email protected] ~/.acme.sh/acme.sh --issue -d xxx.com --standalone

If the above picture is displayed, it means that the domain name certificate has been successfully applied for. Next, install the certificate to the specified folder.

Install the certificate to the specified folder

Replace the domain name in the code with the domain name you resolved, and store the domain name certificate in the /root/ directory.

~/.acme.sh/acme.sh --installcert -d xxx.com --key-file /root/private.key --fullchain-file /root/cert.crt

X-UI Installation Tutorial Example

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

Wait for the installation. When the following prompt appears on the command line, it indicates that the installation is successful!

# 1. Turn off the default ufw # Stop the ufw servicesudo systemctl stop ufw # Turn off the boot-upsudo systemctl disable ufw # Delete ufw rulessudo ufw --force reset # 2 Install firewall apt update apt install -y firewalld # Reload (reload is required after adding or removing rules) firewall-cmd --reload # Start systemctl start firewalld # Restart systemctl restart firewalld # Set the boot-upsystemctl enable firewalld # Turn off the boot-upsystemctl disable firewalld

yum install -y firewalld #Reload (reload is required after adding or removing rules) firewall-cmd --reload #Start systemctl start firewalld #Restart systemctl restart firewalld #Set startup systemctl enable firewalld #Disable startup systemctl disable firewalld

# Add a specified IP to access the ssh service firewall-cmd --permanent --add-rich-rule='rule family=ipv4 source address=10.0.0.1/32 service name=ssh accept' firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="103.119.132.41/32" service name="ssh" accept' # Close ssh access to all IP services firewall-cmd --remove-service=ssh --permanent # Add http https services firewall-cmd --add-service=http --permanent firewall-cmd --add-service=https --permanent # Take effect configuration firewall-cmd --reload # View rules firewall-cmd --list-all