explaingit

jrohy/multi-v2ray

6,993PythonAudience · ops devopsComplexity · 3/5Setup · moderate

TLDR

A guided management script for setting up and controlling V2Ray and Xray proxy servers on Linux, letting you add users, change protocols, and check traffic without editing config files by hand.

Mindmap

mindmap
  root((multi-v2ray))
    What it does
      Manage V2Ray
      Manage Xray
      Add remove users
      Check live traffic
    Transport Protocols
      WebSocket
      HTTP2
      mKCP
      QUIC
      REALITY
    Install Options
      Single command
      Docker
    Extra Features
      Cloudflare CDN
      TCP Fast Open
      Block BitTorrent
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Set up a personal proxy server on a Linux VPS to bypass network restrictions with a single install command.

USE CASE 2

Add or remove proxy users and switch transport protocols through an interactive menu without editing config files.

USE CASE 3

Deploy V2Ray or Xray in a Docker container and manage it with the same management script.

Tech stack

PythonV2RayXrayDockerShell

Getting it running

Difficulty · moderate Time to first run · 30min

Requires a Linux server, CentOS users must disable the built-in firewall before running the install script.

No license information was provided in the explanation.

In plain English

multi-v2ray is a management script for V2Ray and Xray, two tools used to route internet traffic through a proxy server, commonly to bypass network restrictions. The script is primarily documented in Chinese and is aimed at users who already know why they need a proxy server and want a quicker way to configure and manage one on a Linux server. The script handles setup and day-to-day management through a guided interactive menu or direct command-line arguments. You can start, stop, and restart the proxy service, add or remove users and ports, change which transport protocol is in use, and check live traffic statistics without editing configuration files by hand. It supports both Docker-based deployments and direct installation with a single command. A notable feature is support for many different transport protocols beyond basic TCP, including WebSocket, HTTP/2, mKCP with various traffic disguise headers (such as making traffic look like a FaceTime call or a BitTorrent download), QUIC, Shadowsocks, VLESS, Trojan, and REALITY. These disguise options make the proxy traffic harder to identify and block at the network level. The script can also route through Cloudflare CDN, enable TCP Fast Open for better connection speed, block BitTorrent traffic, and use dynamic ports. On first installation, the script picks a random port and sets up an mKCP configuration with a random traffic disguise header automatically. It then displays the connection details, including a share link in the format expected by common client apps. Docker images for both V2Ray and Xray are available on Docker Hub, and the Python library behind the script is published on PyPI. The README notes that CentOS users need to disable the built-in firewall before running the script.

Copy-paste prompts

Prompt 1
I have a Linux VPS and want to set up a V2Ray proxy with WebSocket transport and Cloudflare CDN routing. Walk me through configuring multi-v2ray to enable this.
Prompt 2
Using multi-v2ray, how do I add a new user with a VLESS protocol port and get the share link to use in a client app?
Prompt 3
My multi-v2ray setup uses mKCP with a FaceTime disguise header. How do I check live traffic statistics and switch to QUIC transport instead?
Open on GitHub → Explain another repo

← jrohy on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.