/releases/latest API endpoint skips prereleases and drafts. Fall back to /releases (all releases) to find the first available tag, which includes prereleases created by our workflow. https://claude.ai/code/session_01RQBndg4ZPmYAToK4KKcBzp |
||
|---|---|---|
| .github | ||
| .vscode | ||
| config | ||
| database | ||
| logger | ||
| media | ||
| sub | ||
| trusttunnel | ||
| util | ||
| web | ||
| windows_files | ||
| xray | ||
| .env.example | ||
| .gitignore | ||
| CONTRIBUTING.md | ||
| docker-compose.yml | ||
| DockerEntrypoint.sh | ||
| Dockerfile | ||
| DockerInit.sh | ||
| go.mod | ||
| go.sum | ||
| install.sh | ||
| LICENSE | ||
| main.go | ||
| README.ar_EG.md | ||
| README.es_ES.md | ||
| README.fa_IR.md | ||
| README.md | ||
| README.ru_RU.md | ||
| README.zh_CN.md | ||
| update.sh | ||
| x-ui.rc | ||
| x-ui.service.arch | ||
| x-ui.service.debian | ||
| x-ui.service.rhel | ||
| x-ui.sh | ||
English | فارسی | العربية | 中文 | Español | Русский
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.
TrustTunnel Support
This fork adds support for TrustTunnel — a fast VPN protocol by AdGuard, written in Rust. TrustTunnel runs as a separate process alongside Xray and can be managed through the same panel UI.
How it works
- TrustTunnel appears as a protocol option (
trusttunnel) when creating a new inbound - Each TrustTunnel inbound runs its own process independently of Xray
- Supports multiple clients with username/password authentication
- Supports HTTP/1.1, HTTP/2, and QUIC (HTTP/3) transports
- Uses its own TLS certificates (configured per inbound)
Installation
- Install the TrustTunnel binary:
curl -fsSL https://raw.githubusercontent.com/TrustTunnel/TrustTunnel/refs/heads/master/scripts/install.sh | sh -s --
- Install/update 3x-ui from this fork:
bash <(curl -Ls https://raw.githubusercontent.com/yelloduxx/3x-ui/master/install.sh)
- In the panel, create a new inbound and select
trusttunnelas the protocol
Configuration
When creating a TrustTunnel inbound, you need to specify:
| Field | Description |
|---|---|
| Port | Listen port (e.g., 443) |
| Hostname | Domain name for TLS SNI matching |
| Certificate Path | Path to TLS certificate chain (PEM) |
| Private Key Path | Path to TLS private key (PEM) |
| Transport Protocols | Enable/disable HTTP/1.1, HTTP/2, QUIC |
| Clients | Username/password pairs for authentication |
Upgrading 3x-ui
TrustTunnel integration is designed for minimal merge conflicts:
- 3 new files are fully isolated (
trusttunnel/process.go,web/service/trusttunnel.go,web/html/form/protocol/trusttunnel.html) - Changes to existing files are small and clearly marked
- No database schema changes — settings are stored as JSON in the existing
Settingsfield
Quick Start
bash <(curl -Ls https://raw.githubusercontent.com/yelloduxx/3x-ui/master/install.sh)
For full documentation, please visit the project Wiki.
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🌟