# XTLS/Xray-core

**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/xtls-xray-core).**

35,193 stars · 4,969 forks · Go · mpl-2.0

## Links

- GitHub: https://github.com/XTLS/Xray-core
- Homepage: https://t.me/projectXray
- awesome-repositories: https://awesome-repositories.com/repository/xtls-xray-core.md

## Topics

`anticensorship` `dns` `network` `proxy` `reality` `shadowsocks` `socks5` `tls` `trojan` `tunnel` `utls` `vision` `vless` `vmess` `vpn` `wireguard` `xhttp` `xray` `xtls` `xudp`

## Description

Xray-core is a high-performance, cross-platform networking engine designed to manage secure data transmission and traffic routing. At its core, the project utilizes an asynchronous, event-driven runtime model capable of handling thousands of concurrent connections through non-blocking input and output. It functions as a central traffic controller, employing a sophisticated routing engine that dynamically matches incoming network requests to specific outbound proxies based on user-defined criteria.

The project distinguishes itself through a modular architecture that decouples proxy and transport layers, allowing for the flexible stacking of security and obfuscation protocols. This design supports stateful connection multiplexing to improve efficiency and includes a pluggable transport layer that encapsulates network streams to mask traffic patterns. By providing a framework for custom protocol development, it enables the implementation of specialized communication standards to maintain stable connections across diverse and restrictive network environments.

The software encompasses a broad range of infrastructure capabilities, including compile-time feature flagging to minimize binary size and a comprehensive suite of tools for managing proxy connections. It supports consistent deployment across various operating systems, with automated build processes that facilitate the generation of executable binaries. Detailed documentation and installation guides are provided to assist in setting up the environment and configuring the underlying network services.

## Tags

### Networking & Communication

- [Event-Driven Networking](https://awesome-repositories.com/f/networking-communication/event-driven-networking.md) — Provides a high-performance event-driven runtime for handling massive concurrent network connections.
- [Proxy Servers](https://awesome-repositories.com/f/networking-communication/proxy-servers.md) — Implements core proxy logic to manage traffic flow, load balancing, and security filtering. ([source](https://github.com/XTLS/Xray-core/tree/main/proxy))
- [Traffic Routing Engines](https://awesome-repositories.com/f/networking-communication/traffic-routing-engines.md) — Implements a dynamic routing engine that matches incoming requests to specific outbound proxies.
- [Tunneling Runtimes](https://awesome-repositories.com/f/networking-communication/tunneling-runtimes.md) — A portable execution environment that manages secure data transmission across diverse operating systems using standardized proxy and transport configurations.
- [Custom Network Protocols](https://awesome-repositories.com/f/networking-communication/custom-network-protocols.md) — Create specialized communication rules to manage network traffic, handle data multiplexing, and apply security layers that maintain stable and efficient transmission paths. ([source](https://xtls.github.io/))
- [Network Protocols](https://awesome-repositories.com/f/networking-communication/network-protocols.md) — Provides native support for modern network protocols including VLESS, XTLS, and REALITY for secure traffic routing. ([source](https://github.com/XTLS/Xray-core#readme))
- [Protocol Abstraction Layers](https://awesome-repositories.com/f/networking-communication/protocol-abstraction-layers.md) — Uses a modular architecture to decouple transport and proxy layers for flexible security stacking.
- [Proxy Engines](https://awesome-repositories.com/f/networking-communication/proxy-engines.md) — A high-performance networking core that routes traffic through encrypted tunnels to enhance privacy and bypass restrictive network environments.
- [Transport Layers](https://awesome-repositories.com/f/networking-communication/transport-layers.md) — Configures transport layer mechanisms to ensure reliable packet delivery and connection stability. ([source](https://github.com/XTLS/Xray-core/tree/main/transport))
- [Connection Multiplexing](https://awesome-repositories.com/f/networking-communication/connection-multiplexing.md) — Bundles multiple logical data streams into a single physical connection to reduce overhead.
- [Communication Protocol Frameworks](https://awesome-repositories.com/f/networking-communication/communication-protocol-frameworks.md) — A modular framework for developing and deploying specialized communication protocols that handle multiplexing and advanced traffic obfuscation techniques.
- [Cross-Platform Routing](https://awesome-repositories.com/f/networking-communication/cross-platform-routing.md) — Provides unified network routing and tunneling solutions that function consistently across desktop and mobile platforms.
- [Network Protocol Configurations](https://awesome-repositories.com/f/networking-communication/network-protocol-configurations.md) — Applies traffic settings and security rules to improve connection performance and data privacy. ([source](https://github.com/XTLS/Xray-core#readme))
- [Protocol Development Toolkits](https://awesome-repositories.com/f/networking-communication/protocol-development-toolkits.md) — Building specialized networking layers to handle multiplexing and traffic routing while maintaining stable connections through complex or restricted network paths.

### Programming Languages & Runtimes

- [Asynchronous Runtimes](https://awesome-repositories.com/f/programming-languages-runtimes/asynchronous-runtimes.md) — Utilizes a high-performance asynchronous runtime to handle thousands of concurrent connections with low latency.

### DevOps & Infrastructure

- [Secure Proxy Infrastructure](https://awesome-repositories.com/f/devops-infrastructure/secure-proxy-infrastructure.md) — Deploying high-performance networking engines to establish encrypted tunnels and manage secure data transmission across diverse computing platforms and operating systems.

### Security & Cryptography

- [Pluggable Transports](https://awesome-repositories.com/f/security-cryptography/pluggable-transports.md) — Encapsulates network streams within obfuscation wrappers to hide traffic patterns from inspection.
- [Traffic Obfuscation Tools](https://awesome-repositories.com/f/security-cryptography/traffic-obfuscation-tools.md) — Applying advanced security protocols to mask data patterns and protect user privacy when routing traffic through restrictive network environments.

### Development Tools & Productivity

- [Build Systems](https://awesome-repositories.com/f/development-tools-productivity/build-systems.md) — Compiles source code into ready-to-run files to ensure consistent deployment results. ([source](https://github.com/XTLS/Xray-core#readme))

### Software Engineering & Architecture

- [Build-Time Configuration](https://awesome-repositories.com/f/software-engineering-architecture/build-time-configuration.md) — Allows selective inclusion of protocols at compile-time to minimize binary size and attack surface.

### Testing & Quality Assurance

- [Automated Testing Suites](https://awesome-repositories.com/f/testing-quality-assurance/automated-testing-suites.md) — Verifies software reliability through automated checks that identify errors and prevent regressions. ([source](https://github.com/XTLS/Xray-core/tree/main/testing))

### User Interface & Experience

- [Connection Management Interfaces](https://awesome-repositories.com/f/user-interface-experience/connection-management-interfaces.md) — Controls network traffic and server settings through an interface that simplifies monitoring. ([source](https://github.com/XTLS/Xray-core#readme))
