# Xray-core | Project X Community, Not Porn-jet X Hub | Knowledge Base | Instagit

Xray, Penetrates Everything. Also the best v2ray-core. Where the magic happens. An open platform for various uses.

GitHub Stars: 37.6k

Repository: https://github.com/XTLS/Xray-core

---

## Articles

### [How the Xray-core Logging System Works: Configuring Structured Logging](/XTLS/Xray-core/xray-core-logging-system-structured-logging)

Learn how Xray-core's logging system works with its Message Handler pipeline. Configure structured logging easily using JSON, TOML, or YAML for efficient debugging.

- Tags: internals
- Published: 2026-04-21

### [How to Configure Transparent Proxy (TUN Mode) in Xray-core on Linux, Windows, macOS, FreeBSD, Android, and iOS](/XTLS/Xray-core/xray-core-transparent-proxy-tun-mode-platforms)

Learn to configure Xray-core transparent proxy TUN mode across Linux, Windows, macOS, FreeBSD, Android, and iOS. Set up virtual network interfaces and avoid routing loops with this guide.

- Tags: how-to-guide
- Published: 2026-04-21

### [Shadowsocks 2022 vs Legacy Shadowsocks in Xray-core: Implementation Differences Explained](/XTLS/Xray-core/xray-core-shadowsocks-2022-vs-legacy)

Explore Shadowsocks 2022 vs legacy Shadowsocks in Xray-core. Understand cipher differences, pre-shared keys, and MD5 derivation for enhanced security and compatibility.

- Tags: deep-dive
- Published: 2026-04-21

### [How Xray-core Stats Channels Enable Real-Time Traffic Monitoring](/XTLS/Xray-core/xray-core-stats-channel-real-time-monitoring)

Discover how Xray-core stats channels enable real-time traffic monitoring. Gain insights into bytes, connections, and latency without impacting proxy performance.

- Tags: deep-dive
- Published: 2026-04-21

### [How to Implement Multi-Port Inbound with Different Protocols on Xray-Core](/XTLS/Xray-core/xray-core-multi-port-inbound-different-protocols)

Learn to implement multi-port inbound with different protocols on Xray-core. Configure separate inbound entries for diverse protocol handling and unique port ranges in your Xray-core setup.

- Tags: how-to-guide
- Published: 2026-04-21

### [Security Implications of Different Proxy Protocols in Xray-core: VMess, VLESS, Trojan, and Shadowsocks Explained](/XTLS/Xray-core/xray-core-proxy-protocol-security-implications)

Explore security implications of Xray-core proxy protocols VMess, VLESS, Trojan, and Shadowsocks. Understand encryption, forward secrecy, and authentication for secure connections.

- Tags: deep-dive
- Published: 2026-04-21

### [How Xray‑core Handles Connection Multiplexing and Performance Tuning](/XTLS/Xray-core/xray-core-connection-multiplexing-performance-tuning)

Discover how Xray-core leverages dual connection multiplexing for exceptional performance. Learn to tune concurrency, connection pools, and keep-alive settings for optimal throughput.

- Tags: deep-dive
- Published: 2026-04-21

### [How Xray-core's Balancer Override Feature Enables Dynamic Load Balancing Changes](/XTLS/Xray-core/xray-core-balancer-override-dynamic-load-balancing)

Learn how Xray-core's balancer override feature allows dynamic load balancing changes via API calls without proxy restarts or config edits.

- Tags: deep-dive
- Published: 2026-04-21

### [Xray-core Configuration Format: How to Convert Between JSON, Protobuf, and TOML](/XTLS/Xray-core/xray-core-configuration-format-conversion)

Master Xray-core configuration. Learn to effortlessly convert between JSON, Protobuf, and TOML formats using built-in commands for seamless file management.

- Tags: how-to-guide
- Published: 2026-04-21

### [How to Configure gRPC Transport in Xray-core with Custom Service Names](/XTLS/Xray-core/xray-core-grpc-transport-custom-service-names)

Learn to configure gRPC transport in Xray-core with custom service names. Set serviceName in grpcSettings for plain strings or hierarchical paths. Optimize your Xray-core setup.

- Tags: how-to-guide
- Published: 2026-04-21

### [How Xray-core Router Condition System Works for Routing Decisions](/XTLS/Xray-core/xray-core-router-condition-system-routing)

Understand how the Xray-core router condition system makes routing decisions. Learn how sequential rule evaluation determines outbound destinations based on request matching.

- Tags: internals
- Published: 2026-04-21

### [DNS Nameserver Types in Xray-core: DoH, DoT, QUIC, TCP, and UDP Explained](/XTLS/Xray-core/xray-core-dns-nameserver-types-use-cases)

Explore Xray-core DNS nameserver types like DoH DoT QUIC UDP and more. Understand their use cases for enhanced privacy performance and network compatibility.

- Tags: deep-dive
- Published: 2026-04-21

### [How to Configure Xray-core Policy Settings for Timeouts, Stats, and Buffer Sizes](/XTLS/Xray-core/xray-core-policy-settings-timeout-stats-buffer)

Learn to configure Xray-core policy settings for timeouts, stats, and buffer sizes within your config file. Optimize performance by overriding default values for enhanced control.

- Tags: how-to-guide
- Published: 2026-04-21

### [How WireGuard Inbound Works in Xray-core: Complete Implementation Guide](/XTLS/Xray-core/xray-core-wireguard-inbound-configuration)

Learn how WireGuard inbound works in Xray-core. This guide explains creating TUN interfaces, decrypting UDP, and routing traffic for a complete implementation.

- Tags: how-to-guide
- Published: 2026-04-21

### [XTLS-Vision vs XTLS-Reality in Xray-core: Architecture, Configuration, and Use Cases](/XTLS/Xray-core/xray-core-xtls-vision-vs-xtls-reality)

Compare XTLS-Vision vs XTLS-Reality in Xray-core. Understand their architecture, configuration, and use cases to enhance your traffic obfuscation and security.

- Tags: deep-dive
- Published: 2026-04-21

### [How to Use Xray-core Built-in API for Runtime Traffic Statistics and User Management](/XTLS/Xray-core/xray-core-api-runtime-statistics-user-management)

Unlock Xray-core built-in API for real-time traffic stats & user management without server restarts. Monitor and control your proxy efficiently. Learn how now.

- Tags: how-to-guide
- Published: 2026-04-21

### [How Xray-core Implements QUIC and HTTP/3 Support for the Hysteria Protocol](/XTLS/Xray-core/xray-core-quic-http3-hysteria-protocol)

Discover how Xray-core implements QUIC and HTTP/3 for Hysteria protocol. Learn about its unique approach to TCP and UDP traffic management for enhanced performance.

- Tags: deep-dive
- Published: 2026-04-21

### [Xray-core Observatory Module: Health Checking and Outbound Monitoring Explained](/XTLS/Xray-core/xray-core-observatory-health-checking)

Learn how the Xray-core Observatory module checks outbound proxy health using HTTP probing and ping analysis. Get real-time status data for intelligent traffic routing.

- Tags: deep-dive
- Published: 2026-04-21

### [How FakeDNS Works in Xray-core: Complete Configuration Guide](/XTLS/Xray-core/xray-core-fakedns-configuration)

Learn how FakeDNS in Xray-core works to enable domain-based routing, even with DNS issues. Get a complete guide to configuring FakeDNS for seamless connectivity.

- Tags: how-to-guide
- Published: 2026-04-21

### [How the Xray-core Router Webhook Works and When to Use It](/XTLS/Xray-core/xray-core-router-webhook-usage)

Learn how the Xray-core router webhook feature works. Send real-time JSON POST requests on rule matches for external monitoring and automated responses without blocking traffic.

- Tags: deep-dive
- Published: 2026-04-21

### [Xray-core Routing Strategies for Load Balancing: Random, LeastPing, LeastLoad, and RoundRobin Explained](/XTLS/Xray-core/xray-core-routing-strategies-load-balancing)

Explore Xray-core routing strategies for load balancing: random, leastping, leastload, and roundrobin. Optimize traffic distribution across outbounds for better performance.

- Tags: deep-dive
- Published: 2026-04-21

### [How to Configure TLS with ECH (Encrypted Client Hello) in Xray-core](/XTLS/Xray-core/xray-core-configure-tls-ech)

Learn how to configure TLS with ECH Encrypted Client Hello in Xray-core using echServerKeys echConfigList and echForceQuery. Generate keys easily with the xray tls ech command.

- Tags: how-to-guide
- Published: 2026-04-21

### [How the Xray REALITY Protocol Works: TLS Fingerprint Stealing Explained](/XTLS/Xray-core/reality-protocol-tls-fingerprint-stealing)

Discover how Xray REALITY protocol achieves TLS fingerprint stealing to make traffic indistinguishable from HTTPS. Learn about its obfuscation and peer authentication.

- Tags: deep-dive
- Published: 2026-04-21

### [VLESS UUID Authentication: How It Works and How It Differs From VMess](/XTLS/Xray-core/vless-uuid-authentication-vs-vmess)

Discover how VLESS UUID authentication works, its differences from VMess, and its simpler approach to client verification.

- Tags: deep-dive
- Published: 2026-04-21