Xray panel supporting multi-protocol multi-user expire day & traffic & ip limit (Vmess & Vless & Trojan & ShadowSocks & Wireguard)
Find a file
root 5bf2b5ef88 fix: replace v-else with v-if on node info table
v-else on <table> element was not recognized by Vue template compiler,
causing the worker node info table to never render. Use v-if="nodes.length > 0"
instead to ensure the table renders when data is available.
2026-04-25 09:49:32 +08:00
.github fix: add error handling for Xray, geo, and toolchain downloads in CI 2026-04-24 15:09:24 +08:00
.vscode DevTools 2025-10-02 01:47:12 +02:00
cmd/genassets feat: add asset generation command 2026-04-07 12:08:10 +08:00
config chore: bump version to v1.6.6 2026-04-25 09:38:49 +08:00
database fix: query shared MariaDB for node states instead of local DB 2026-04-24 18:01:59 +08:00
docs fix: replace a-descriptions with HTML table and fix ensureDefaultNodeSettings 2026-04-25 09:36:21 +08:00
logger fix migrate panic and include release workflow updates 2026-04-05 03:12:29 +08:00
media donate: nowpayments 2025-09-18 20:14:10 +02:00
sub style: apply gofmt formatting 2026-04-24 14:43:44 +08:00
tests feat: add local mariadb port and remote ip access controls 2026-04-22 11:20:55 +08:00
util test: add unit tests for critical modules and fix flaky redirect middleware 2026-04-03 08:44:51 +08:00
web fix: replace v-else with v-if on node info table 2026-04-25 09:49:32 +08:00
windows_files Update OpenSSL installer to version 3.6.0 2026-01-05 18:49:30 +01:00
xray feat: add durable traffic deltas and shared flush loop 2026-04-10 15:25:16 +08:00
.codex feat: improve mariadb flow, db settings init, and traffic flush 2026-04-15 16:58:49 +08:00
.env.example fix: display of outbound traffic (#3604) 2025-12-23 15:43:25 +01:00
.gitignore feat: add CodeMirror YAML editor for Clash template and fix settings save button bug 2026-04-24 16:15:22 +08:00
AGENTS.md feat: improve mariadb flow, db settings init, and traffic flush 2026-04-15 16:58:49 +08:00
CONTRIBUTING.md fix: display of outbound traffic (#3604) 2025-12-23 15:43:25 +01:00
docker-compose.yml chore: build image in docker compose 2025-06-13 15:25:13 +07:00
DockerEntrypoint.sh chore: X_UI_ENABLE_FAIL2BAN -> XUI_ENABLE_FAIL2BAN (#3030) 2025-05-22 08:21:23 +02:00
Dockerfile build: generate fingerprinted assets before compile 2026-04-07 16:43:18 +08:00
DockerInit.sh Xray Core v26.2.6 and dependency updates 2026-02-09 12:49:32 +01:00
go.mod deps: add gorm.io/driver/mysql for MariaDB support 2026-04-03 09:32:55 +08:00
go.sum deps: add gorm.io/driver/mysql for MariaDB support 2026-04-03 09:32:55 +08:00
install.sh fix: install cron before acme.sh for all distros 2026-04-23 17:23:44 +08:00
LICENSE 3x-ui 2023-02-09 22:48:06 +03:30
main.go feat: improve mariadb flow, db settings init, and traffic flush 2026-04-15 16:58:49 +08:00
main_test.go feat: improve mariadb flow, db settings init, and traffic flush 2026-04-15 16:58:49 +08:00
README.ar_EG.md chore: update GitHub links to fork repository Sora39831/3x-ui 2026-04-02 09:49:12 +08:00
README.es_ES.md chore: update GitHub links to fork repository Sora39831/3x-ui 2026-04-02 09:49:12 +08:00
README.fa_IR.md chore: update GitHub links to fork repository Sora39831/3x-ui 2026-04-02 09:49:12 +08:00
README.md docs: add multi-node shared control guidance 2026-04-10 15:33:04 +08:00
README.ru_RU.md chore: update GitHub links to fork repository Sora39831/3x-ui 2026-04-02 09:49:12 +08:00
README.zh_CN.md docs: add multi-node shared control guidance 2026-04-10 15:33:04 +08:00
update.sh feat: improve mariadb flow, db settings init, and traffic flush 2026-04-15 16:58:49 +08:00
x-ui.rc [feat] restart xray-core from cli #3825 2026-02-20 00:03:16 +01:00
x-ui.service.arch [feat] restart xray-core from cli #3825 2026-02-20 00:03:16 +01:00
x-ui.service.debian [feat] restart xray-core from cli #3825 2026-02-20 00:03:16 +01:00
x-ui.service.rhel [feat] restart xray-core from cli #3825 2026-02-20 00:03:16 +01:00
x-ui.sh fix: resolve client traffic InboundId from DB in shared mode, set online clients 2026-04-24 02:29:02 +08:00

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

3x-ui

Release Build GO Version Downloads License Go Reference Go Report Card

3X-UI — advanced, open-source web-based control panel designed for managing Xray-core server. It offers a user-friendly interface for configuring and monitoring various VPN and proxy protocols.

Important

This project is only for personal usage, please do not use it for illegal purposes, and please do not use it in a production environment.

As an enhanced fork of the original X-UI project, 3X-UI provides improved stability, broader protocol support, and additional features.

Quick Start

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

For full documentation, please visit the project Wiki.

Building from source

Generate fingerprinted frontend assets before compiling:

go run ./cmd/genassets
go build -ldflags "-w -s" -o build/x-ui main.go

Production builds embed files from web/public/assets and web/public/assets-manifest.json.

Multi-Node Shared Control

  • use MariaDB as the shared control database
  • keep one master node for shared-account writes
  • configure other nodes as worker
  • workers rebuild local Xray config from synchronized snapshots
  • traffic is flushed back as deltas, not absolute totals

A Special Thanks to

Acknowledgment

  • Iran v2ray rules (License: GPL-3.0): Enhanced v2ray/xray and v2ray/xray-clients routing rules with built-in Iranian domains and a focus on security and adblocking.
  • Russia v2ray rules (License: GPL-3.0): This repository contains automatically updated V2Ray routing rules based on data on blocked domains and addresses in Russia.

Support project

If this project is helpful to you, you may wish to give it a🌟

Buy Me A Coffee
Crypto donation button by NOWPayments

Stargazers over Time

Stargazers over time