explaingit

yanue/v2rayu

Analysis updated 2026-06-21

19,979Audience · generalComplexity · 2/5LicenseSetup · moderate

TLDR

A macOS menu-bar app that makes it easy to route your internet traffic through proxy servers using v2ray, primarily used to access sites blocked by internet censorship.

Mindmap

mindmap
  root((v2rayu))
    What it does
      macOS proxy client
      Censorship bypass
      Traffic routing
    Tech Stack
      Swift
      v2ray-core engine
    Protocols
      vmess and vless
      shadowsocks
      trojan and socks5
    Setup
      Homebrew install
      QR code import
      Subscription URL
    Routing modes
      PAC mode
      Global proxy
      Manual mode
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

Bypass internet censorship on macOS using proxy protocols like vmess, shadowsocks, or trojan without touching the command line.

USE CASE 2

Route only traffic to blocked sites through the proxy while letting everything else go direct using PAC mode.

USE CASE 3

Automatically sync and refresh a list of proxy servers from a subscription URL.

USE CASE 4

Use global proxy mode to route all Mac traffic through a remote server for maximum privacy.

What is it built with?

Swift

How does it compare?

yanue/v2rayumicrosoft/fluentuiprogramthink/books
Stars19,97919,97819,980
LanguageTypeScript
Setup difficultymoderateeasyeasy
Complexity2/52/51/5
Audiencegeneraldevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a v2ray-compatible proxy server, V2rayU is only the macOS client side and does not provide servers.

Free to use and modify, but distributed versions must also be released as open source under GPLv3.

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
I have a vmess server config URL. Show me how to add it to V2rayU on macOS and switch between PAC mode and global proxy mode from the menu bar.
Prompt 2
Set up V2rayU to use PAC mode with a custom PAC file that routes only specific domains through the proxy while leaving all other traffic direct.
Prompt 3
Configure a subscription URL in V2rayU to automatically import and update a list of proxy servers on a daily schedule.

Frequently asked questions

What is v2rayu?

A macOS menu-bar app that makes it easy to route your internet traffic through proxy servers using v2ray, primarily used to access sites blocked by internet censorship.

What license does v2rayu use?

Free to use and modify, but distributed versions must also be released as open source under GPLv3.

How hard is v2rayu to set up?

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

Who is v2rayu for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub yanue on gitmyhub

Verify against the repo before relying on details.