gitmyhub

v2ray-core

Go ★ 47k updated 3d ago

A platform for building proxies to bypass network restrictions.

A modular network proxy platform that routes traffic through intermediary servers using multiple protocols to bypass censorship and network restrictions.

GoJSONTCPWebSocketgRPCsetup: moderatecomplexity 4/5

V2Ray is a platform for building network proxies — tools that route your internet traffic through intermediary servers in order to bypass regional restrictions, censorship, or surveillance. The core problem it addresses is that in some network environments, access to certain websites or services is blocked at the network level, and standard VPN protocols may themselves be blocked or detectable. V2Ray provides a modular framework that supports multiple proxy protocols including VMess (its own protocol), SOCKS, HTTP, and Shadowsocks, which can be combined and configured in various ways to make traffic harder to detect and block.

The README for this particular repository is sparse — it notes that active development has moved to a fork at github.com/v2fly/v2ray-core. Based on the description and topics, the project is a Go-language library and runtime that handles the inbound and outbound traffic routing, protocol negotiation, and transport layer configuration that proxy clients and servers need. Operators configure it with a JSON configuration file that defines inbound listeners (where traffic enters), outbound connections (where traffic exits), and routing rules that direct traffic between them. It supports transport over WebSocket and gRPC in addition to raw TCP, allowing proxy traffic to be disguised as ordinary HTTPS web traffic.

You would use V2Ray (or its maintained fork V2Fly) when you need to traverse network restrictions that block simpler VPN solutions, when you need fine-grained control over how different categories of traffic are routed, or when you are building a network tool that needs a flexible proxy substrate. It is written in Go and runs on Linux, macOS, and Windows.

Where it fits