v2rayA /v2rayA

A web client for its own Xray-based core with global transparent proxy on Linux, Windows and macOS.

★ 15,860⑂ 1,618👁 104⑃ 457● 1,174▤ 187
GoAGPL-3.0Created 2019-10-18
Download: v2.5.15v2.5.15 ↓2.5.152026-11-13
+4
Daily
+68
Weekly
+179
Monthly
15,860
stars
1,618
forks
104
watchers
457
prs
1,174
issues
187
releases

README

v2rayA

A web client for its own Xray-based core, with transparent proxy on Linux, Windows and macOS.

English · 简体中文 · Русский

Requirements • Install • First run • Transparent proxy • Data and upgrades • Support



v2rayA runs as a service and is used from a browser, on the machine itself or on a router or NAS. It imports subscriptions and share links for VMess, VLESS, Shadowsocks, Trojan, Hysteria2, TUIC, Juicity, AnyTLS, WireGuard, SOCKS5 and HTTP(S), groups nodes and selects the member with the lowest measured latency or a pinned one, and splits traffic with rules written in RoutingA. ShadowsocksR is not supported.

 Requirements

| Component | Requirement |
| --- | --- |
| Core | v2raya_core of the same version as v2raya, next to it or in PATH. The packages and installers below ship both; a hand-installed pair must match. |
| Rule data | geoip.dat and geosite.dat in /usr/share/v2raya or /usr/local/share/v2raya. The packages ship them; a hand install downloads them from GitHub on the first start and exits if that fails. |
| Linux transparent proxy | root; iptables or nftables for redirect and tproxy; /dev/net/tun and ip from iproute2 for tun |
| Windows | Windows 10 build 14393 or later; administrator for tun; started without elevation it runs in lite mode and can still set the current user's system proxy |
| macOS | root for tun; started as a user it runs in lite mode with the system proxy instead |
| Browser | a current Chrome, Edge, Firefox or Safari |

 Install

The packages below install v2raya and v2raya_core together with a service definition. Enable the service with the command shown for the platform.


Debian, Ubuntu and other APT distributions

The packages come from the Dae Universe repository.

sh
sudo apt update
sudo apt install curl


APT 3.0 or later:

sh
sudo curl -fsSL -o /etc/apt/sources.list.d/daeuniverse.sources https://daeuniverse.pages.dev/daeuniverse.sources


APT older than 3.0:

sh
sudo curl -fsSL -o /etc/apt/sources.list.d/daeuniverse.list https://daeuniverse.pages.dev/daeuniverse.list


Then the key and the package:

sh
sudo curl -fsSL -o /usr/share/keyrings/daeuniverse-archive-goose.gpg https://daeuniverse.pages.dev/daeuniverse-archive-goose.gpg
sudo apt update
sudo apt install v2raya
sudo systemctl enable --now v2raya


Change the unit with sudo systemctl edit --full v2raya.service; an edit of the installed file is overwritten by the next upgrade.




Fedora, RHEL, openSUSE and other RPM distributions

Fedora, RHEL and derivatives:

sh
sudo curl -fsSL -o /etc/yum.repos.d/daeuniverse.repo https://daeuniverse.pages.dev/daeuniverse.repo
sudo dnf install v2raya


openSUSE:

sh
sudo curl -fsSL -o /etc/zypp/repos.d/daeuniverse.repo https://daeuniverse.pages.dev/daeuniverse.repo
sudo zypper install v2raya


Then:

sh
sudo systemctl enable --now v2raya





Arch Linux

v2raya builds from source, v2raya-bin uses the release binaries; both are in the AUR. The release page also carries installer_archlinux__.pkg.tar.zst for 

Top issues

Discussions

Latest release

v2.5.15 v2.5.15 2026-11-13
What's Changed
 fix(gui): drop the parked v2raya.org and link daeuniverse.org by @Zakkaus in https://github.com/v2rayA/v2rayA/pull/2114
 fix(asset): do not create a missing XDG runtime directory by @Zakkaus in https://github.com/v2rayA/v2rayA/pull/2115
 fix(docker): install iproute2 for TUN mode by @Zakkaus in https://github.com/v2rayA/v2rayA/pull/2116
 docs: tighten the contribution rules for assisted pull requests by @Zakkaus in https://github.com/v2rayA/v2rayA/pull/2117
 fix(vless): keep the ECH parameter in share links and the core config by @Zakkaus in https://github.com/v2rayA/v2rayA/pul

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON