explaingit

yanue/v2rayu

📈 Trending19,987Audience · vibe coderComplexity · 2/5ActiveLicenseSetup · moderate

TLDR

A macOS menu-bar app that lets you route internet traffic through remote servers using v2ray, with support for multiple protocols and easy server configuration.

Mindmap

mindmap
  root((V2rayU))
    What it does
      Route traffic securely
      Bypass censorship
      Multiple protocols
    How to use
      Add servers easily
      Menu bar interface
      PAC or global mode
    Supported protocols
      VMess and VLESS
      Shadowsocks
      Trojan and SOCKS5
    Installation
      Homebrew command
      GitHub releases
    Configuration
      QR code scanning
      Clipboard import
      Manual entry

Things people build with this

USE CASE 1

Route your Mac's internet traffic through a remote server to access blocked websites.

USE CASE 2

Switch between direct and proxied connections from the menu bar without restarting apps.

USE CASE 3

Import and manage multiple server configurations from QR codes or subscription URLs.

USE CASE 4

Use PAC mode to automatically proxy only censored sites while keeping other traffic direct.

Tech stack

Swiftv2ray-coremacOS

Getting it running

Difficulty · moderate Time to first run · 30min

Requires macOS, Xcode, and v2ray-core binary; may need to configure server endpoints before first use.

Use and modify freely for any purpose, but you must share any changes you make under the same GPLv3 license.

In plain English

V2rayU is a macOS desktop client for v2ray, a proxy and network tunneling tool used to route internet traffic through remote servers. The practical use case is bypassing internet censorship, the description explicitly states it is for "accessing the internet scientifically," a common Chinese-language phrase for circumventing the Great Firewall. The app is written in Swift and provides a graphical menu-bar interface on Mac, making it easier to use v2ray without touching the command line. The client supports several connection protocols: vmess, vless, shadowsocks (ss/ssr), trojan, socks5, and xTLS. You can add servers by scanning a QR code, pasting a configuration link from the clipboard, importing from a local file or URL, or entering settings manually. Once a server is configured, V2rayU can route traffic in different modes: a PAC mode that only proxies traffic to blocked sites while letting everything else go direct, a global proxy mode that routes all traffic through the server, and a manual mode for use alongside browser extensions like Proxy SwitchyOmega. It also supports subscriptions, a way to automatically import and update a list of servers from a URL. Installation is via Homebrew with a single command or by downloading a release from GitHub. The app sits in the macOS menu bar and wraps the underlying v2ray-core engine, which handles the actual tunneling. The source is licensed under GPLv3.

Copy-paste prompts

Prompt 1
How do I set up V2rayU on my Mac to route traffic through a v2ray server using a QR code?
Prompt 2
What's the difference between PAC mode and global proxy mode in V2rayU, and when should I use each?
Prompt 3
Show me how to add a server subscription to V2rayU so it automatically updates my server list.
Prompt 4
How do I configure V2rayU to work with browser extensions like Proxy SwitchyOmega?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.