explaingit

v2fly/v2ray-core

Analysis updated 2026-05-18

33,878GoAudience · developerComplexity · 4/5LicenseSetup · moderate

TLDR

Open-source proxy framework for bypassing censorship and building privacy-focused network tools with modular routing and multiple protocol support.

Mindmap

mindmap
  root((repo))
    What it does
      Proxy framework
      Bypass censorship
      Route traffic
    Protocols
      VMess
      Shadowsocks
      SOCKS5
      Trojan
    Configuration
      Inbounds
      Outbounds
      Routing rules
    Tech stack
      Go
      JSON config
      Cross-platform
    Use cases
      Privacy networks
      Split tunneling
      Custom proxies
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

What do people build with it?

USE CASE 1

Build a custom proxy server that routes domestic traffic directly while tunneling foreign traffic through encrypted tunnels.

USE CASE 2

Set up split tunneling to bypass censorship by routing traffic based on domain or IP rules.

USE CASE 3

Create a privacy-preserving network infrastructure that disguises connections as ordinary web traffic.

USE CASE 4

Deploy a multi-protocol proxy system supporting VMess, Shadowsocks, Trojan, and SOCKS5 simultaneously.

What is it built with?

GoJSONWebSocketHTTP/2gRPCQUIC

How does it compare?

v2fly/v2ray-coreadguardteam/adguardhomehalfrost/leetcode-go
Stars33,87833,89033,790
LanguageGoGoGo
Setup difficultymoderateeasyeasy
Complexity4/52/52/5
Audiencedeveloperops devopsdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Go installation and understanding of proxy/network configuration, basic example runnable quickly but full feature exploration needs protocol knowledge.

Use freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

V2Ray (v2ray-core) is an open-source platform for building privacy-focused network proxy tools that help users bypass internet censorship and access blocked content. It is the core engine behind what is broadly called "Project V," a collection of network tools designed to secure internet connections, particularly in environments where internet traffic is monitored or restricted. At its core, V2Ray acts as a flexible proxy framework. It accepts incoming traffic from a device, routes it through one or more configurable processing layers, and forwards it to its destination via encrypted tunnels that are difficult for censorship systems to detect or block. It supports numerous proxy protocols including VMess (its own encrypted protocol), Shadowsocks, SOCKS5, Trojan, and others. It can route traffic over WebSocket, HTTP/2, gRPC, QUIC, and other transports, allowing the connection to be disguised as ordinary web traffic that is harder to identify and block. V2Ray's design is modular: you configure inbounds (how traffic enters V2Ray), outbounds (where it goes), and routing rules (how to decide which outbound handles which traffic). This makes it possible to build sophisticated setups, for example, routing domestic traffic directly while tunneling foreign traffic through a proxy, or implementing split tunneling based on domain or IP rules. The README does not describe the full feature set in detail, based on the description, topics, and project structure, it is clear this is a technical tool aimed at developers and experienced users who want fine-grained control over proxy and routing behavior. You would use V2Ray if you need to circumvent internet censorship, build privacy-preserving network infrastructure, or create custom proxy setups. It is written in Go, runs on Linux, Windows, macOS, and various router firmware systems, and is configured via JSON.

Copy-paste prompts

Prompt 1
Show me how to configure V2Ray inbounds and outbounds to route traffic based on domain rules.
Prompt 2
How do I set up V2Ray with split tunneling so domestic traffic goes direct and foreign traffic uses a proxy?
Prompt 3
What are the differences between VMess, Shadowsocks, and Trojan protocols in V2Ray, and when should I use each?
Prompt 4
Help me write a V2Ray JSON config that disguises traffic as HTTP/2 to evade detection.
Prompt 5
How do I deploy V2Ray on Linux and configure it to support multiple proxy protocols at once?

Frequently asked questions

What is v2ray-core?

Open-source proxy framework for bypassing censorship and building privacy-focused network tools with modular routing and multiple protocol support.

What language is v2ray-core written in?

Mainly Go. The stack also includes Go, JSON, WebSocket.

What license does v2ray-core use?

Use freely for any purpose including commercial, as long as you keep the copyright notice.

How hard is v2ray-core to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is v2ray-core for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub v2fly on gitmyhub

Verify against the repo before relying on details.