gitwtfhub

wtf is xray-examples?

xtls/xray-examples — explained in plain English

Analysis updated 2026-05-18

3,673ShellAudience · ops devopsComplexity · 3/5Setup · hard

TL;DR

A collection of ready-to-use configuration examples for Xray-core, covering VLESS and XTLS protocol setups for network proxying and traffic routing.

Mindmap

mindmap
  root((Xray-examples))
    What it does
      Config file library
      Protocol examples
      Shell deploy scripts
    Protocols covered
      VLESS
      XTLS
      Xray-core
    Use cases
      Server config reference
      Quick deployment start
      Protocol comparison
    Audience
      Server admins
      Self-hosters
      Network operators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Copy a working VLESS or XTLS configuration as a starting point for your own Xray-core server deployment.

REASON 2

Compare different protocol configurations to understand the tradeoffs between Xray-core setup options.

REASON 3

Adapt an existing example script to match your server environment without writing the config from scratch.

What's in the stack?

ShellJSON

How it stacks up

xtls/xray-exampleszolrath/wemuxandrew-d/static-binaries
Stars3,6733,6723,687
LanguageShellShellShell
Setup difficultyhardeasyeasy
Complexity3/52/52/5
Audienceops devopsops devopsops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires a Linux server and prior familiarity with Xray-core, no step-by-step guide is included.

License terms are not specified in the available information.

Wtf does this do

This repository is a collection of configuration examples for Xray-core, a network proxy and tunneling tool used to route internet traffic through alternative paths. Xray-core supports multiple protocols, and setting it up correctly requires writing JSON configuration files with specific syntax for each use case. These examples give users a concrete starting point rather than having to build configurations from scratch. The examples focus on VLESS and XTLS, two protocols closely associated with the Xray project. VLESS is a lightweight proxy protocol designed to be efficient and low-overhead. XTLS is an approach to tunneling that aims to reduce patterns in encrypted traffic that could be identified by network filtering systems. The repository contains shell scripts and configuration samples organized around common deployment scenarios. This is not a beginner tutorial on networking or how proxies work. It is a reference collection for people who are already familiar with running server software and who want working configuration files for specific Xray-core setups. Each example corresponds to a particular protocol combination, routing rule, or deployment pattern. If you are new to Xray-core, the typical approach is to read the main Xray-core documentation first and then use these examples as reference material when setting up your own server. The repository's README contains only a brief description, so the value is in the configuration files themselves rather than in written explanations. This is a community resource maintained alongside the broader Xray ecosystem on GitHub. It is most useful to developers and system administrators who are actively deploying Xray-core and want proven configuration templates to start from rather than writing everything by hand.

Yoink these prompts

Prompt 1
Show me how to set up an Xray-core server using the VLESS+XTLS configuration from the Xray-examples repo. What do the key config fields mean?
Prompt 2
Explain the difference between VLESS and VMESS in the context of Xray-core, using the example configurations as reference.
Prompt 3
Walk me through the Xray-core JSON config structure so I can adapt one of these examples for my own VPS.
Prompt 4
What does the flow field in an XTLS Xray configuration control, and how do I set it correctly?

Frequently asked questions

wtf is xray-examples?

A collection of ready-to-use configuration examples for Xray-core, covering VLESS and XTLS protocol setups for network proxying and traffic routing.

What language is xray-examples written in?

Mainly Shell. The stack also includes Shell, JSON.

What license does xray-examples use?

License terms are not specified in the available information.

How hard is xray-examples to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is xray-examples for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.