# alireza0/x-ui

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/alireza0-x-ui).**

4,032 stars · 636 forks · JavaScript · gpl-3.0 · fork

## Links

- GitHub: https://github.com/alireza0/x-ui
- Homepage: https://t.me/XrayUI
- awesome-repositories: https://awesome-repositories.com/repository/alireza0-x-ui.md

## Topics

`reality` `shadowsocks` `trojan` `v2ray` `vless` `vmess` `x-ui` `xray` `xray-core`

## Description

x-ui is a web-based management interface for configuring and administering Xray-core proxy servers and routing rules. It provides a centralized suite of tools including an HTTP API proxy controller, a proxy subscription server, and an automated SSL certificate tool.

The project distinguishes itself through a subscription-based distribution system that allows administrators to deliver connection configurations and update links to multiple clients via unique URLs. It further automates security with ACME-based certificate renewal and provides a decoupled architecture that allows the proxy engine to restart without interrupting the administrative web panel.

The system covers comprehensive traffic management, including rule-based routing and client resource limiting via traffic caps and concurrency restrictions. Observability is handled through a visual dashboard for real-time server performance and individual client data usage, while remote administration is supported via automated bot notifications and webhook-driven alerts.

The platform utilizes a database-backed configuration system to support the export and import of system states for backup and recovery.

## Tags

### Networking & Communication

- [Proxy Managers](https://awesome-repositories.com/f/networking-communication/proxy-managers.md) — Offers a centralized web interface for configuring and managing Xray-core proxy servers and complex routing rules.
- [Network Traffic Management](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-routing-traffic-management/network-traffic-management.md) — Provides a programmable interface to manage and automate network traffic flow and routing. ([source](https://github.com/alireza0/x-ui/blob/main/README.md))
- [Network Traffic Routing](https://awesome-repositories.com/f/networking-communication/network-traffic-routing.md) — Provides a routing engine to define rules using proxy protocols to control data flow through the network. ([source](https://github.com/alireza0/x-ui#readme))
- [Proxy Server Management](https://awesome-repositories.com/f/networking-communication/proxy-server-management.md) — Provides a centralized web interface for the configuration and maintenance of network proxy server endpoints.
- [Subscription Hosting Services](https://awesome-repositories.com/f/networking-communication/proxy-servers/proxy-configurations/subscription-hosting-services.md) — Hosts a centralized service that serves dynamic configuration updates to network clients via unique URLs. ([source](https://github.com/alireza0/x-ui/blob/main/README.md))
- [Traffic Routing Rules](https://awesome-repositories.com/f/networking-communication/traffic-routing-rules.md) — Allows for the automated management of routing rules that dictate how network traffic flows through the proxy. ([source](https://github.com/alireza0/x-ui#readme))
- [Process Decoupling](https://awesome-repositories.com/f/networking-communication/proxy-core-guis/process-decoupling.md) — Decouples the web management panel from the proxy engine to allow core restarts without interrupting administration.
- [Proxy Engine Management Panels](https://awesome-repositories.com/f/networking-communication/proxy-engine-management-panels.md) — Includes a management panel that can restart the proxy engine to apply configurations without interrupting the web UI. ([source](https://github.com/alireza0/x-ui/blob/main/main.go))

### Software Engineering & Architecture

- [Proxy Configuration Interfaces](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/configuration-management/configuration-interfaces-and-editors/graphical-configuration-interfaces/graphical-configuration-interfaces/proxy-configuration-interfaces.md) — Provides a graphical web interface for configuring proxy settings, ports, and base paths. ([source](https://github.com/alireza0/x-ui#readme))

### Business & Productivity Software

- [Proxy Subscription Links](https://awesome-repositories.com/f/business-productivity-software/share-link-generation/proxy-subscription-links.md) — Generates subscription URLs compatible with common proxy clients for automated configuration updates. ([source](https://github.com/alireza0/x-ui#readme))

### Development Tools & Productivity

- [Configuration Update Subscriptions](https://awesome-repositories.com/f/development-tools-productivity/configuration-updates/configuration-update-subscriptions.md) — Implements a subscription-based push model for distributing configuration updates to remote clients.

### DevOps & Infrastructure

- [Resource Caps](https://awesome-repositories.com/f/devops-infrastructure/rate-limiters/tenant/resource-caps.md) — Implements resource caps and traffic limits to restrict the amount of data used by individual clients. ([source](https://github.com/alireza0/x-ui/blob/main/README.md))

### Mobile Development

- [Proxy Configuration REST Endpoints](https://awesome-repositories.com/f/mobile-development/rest-api-integration-frameworks/proxy-configuration-rest-endpoints.md) — Exposes REST API endpoints specifically for managing proxy configurations and routing rules.

### Security & Cryptography

- [Client Usage Restrictions](https://awesome-repositories.com/f/security-cryptography/access-restrictions/client-usage-restrictions.md) — Enforces client access restrictions through traffic caps, expiration dates, and concurrent IP limits. ([source](https://github.com/alireza0/x-ui#readme))
- [Administrative Access Controls](https://awesome-repositories.com/f/security-cryptography/api-access-security/administrative-access-controls.md) — Secures the administrative panel and API endpoints using credential-based access restrictions.
- [ACME Certificate Provisioners](https://awesome-repositories.com/f/security-cryptography/acme-certificate-provisioners.md) — Automates SSL/TLS certificate requests and renewals using the ACME protocol.
- [SSL Certificate Automation](https://awesome-repositories.com/f/security-cryptography/ssl-certificate-automation.md) — Automates the application and renewal of SSL certificates to ensure encrypted proxy connections.

### System Administration & Monitoring

- [Proxy Control APIs](https://awesome-repositories.com/f/system-administration-monitoring/proxy-control-apis.md) — Provides a programmable HTTP API for remote management of proxy server services and network traffic.
- [Server Management APIs](https://awesome-repositories.com/f/system-administration-monitoring/server-management-apis.md) — Implements standardized HTTP endpoints for the programmatic control of server operations and network routes. ([source](https://github.com/alireza0/x-ui/blob/main/README.md))
- [Metric and Performance Monitors](https://awesome-repositories.com/f/system-administration-monitoring/monitoring-and-observability/observability-platforms/metric-performance-monitors.md) — Provides a monitoring system with visual metrics to track real-time server performance and network activity. ([source](https://github.com/alireza0/x-ui#readme))
- [Network Traffic Dashboards](https://awesome-repositories.com/f/system-administration-monitoring/real-time-metric-visualization/network-traffic-dashboards.md) — Provides a visual dashboard for real-time monitoring of network traffic flows and individual client data usage.
- [Server Monitoring and Auditing](https://awesome-repositories.com/f/system-administration-monitoring/server-monitoring-and-auditing.md) — Tracks bandwidth usage, server performance, and individual client data usage through a visual dashboard.
- [Client Traffic Metrics](https://awesome-repositories.com/f/system-administration-monitoring/status-monitors/client-traffic-metrics.md) — Tracks real-time individual client traffic statistics and connection health through a dedicated dashboard. ([source](https://github.com/alireza0/x-ui/blob/main/README.md))

### Data & Databases

- [Database-Backed Configurations](https://awesome-repositories.com/f/data-databases/database-backed-configurations.md) — Stores proxy settings, credentials, and traffic rules in a persistent database for reliable recovery.
