See why your balancer chose a server, and test failures like a real outage.
⬇️ Download xray-studioxray-studio is a simple desktop program for Windows that helps you understand and test your Xray-core proxy setup. If you use VLESS, Reality, or any load-balanced proxy configuration, this tool is for you.
It does two big things:
Think of it as a magnifying glass and a test dummy for your proxy configuration.
This tool is perfect for:
You do not need to be a programmer to use this. If you can download a file and click "Next" a few times, you're good.
See a clear, real-time log of which outbound server was selected for each connection, along with the reason (e.g., "lowest latency", "least connections", "health check passed").
Simulate network problems like packet loss, high latency, or complete server disconnection. The failures are designed to be indistinguishable from real-world issues, so you can trust your testing.
A simple dashboard that shows your current connections, balancer status, and any active fault injections – all in one place.
Load your standard Xray-core JSON configuration file. No need to rewrite anything. xray-studio reads it and shows you what's happening.
Getting started is easy. Follow these steps:
No technical knowledge required. Just download and run.
Here's how to use xray-studio in 3 simple steps:
Step 1: Open xray-studio. You'll see a welcome screen.
Step 2: Click "Load Config" and select your Xray-core JSON configuration file. The tool will read it immediately.
Step 3: Click "Start" to begin observing. You'll see your balancer decisions in real-time. To test failures, click "Fault Injection" and choose what to simulate.
That's all there is to it. You can now watch your proxy's behavior and test how it handles problems.
No special hardware or admin rights are needed. If you can run a web browser, you can run xray-studio.
No. xray-studio is designed for everyone. You just load a config file and click buttons.
No. Fault injections only affect the test environment within xray-studio. Your actual Xray-core setup outside the tool is untouched.
Yes. xray-studio supports all standard Xray-core protocols, including VLESS and Reality, as long as they are in a JSON config file.
Visit the GitHub page linked above and open an issue. The community and developers are happy to help.