README

v2rayA

基于自带 Xray 内核的 Web 客户端，在 Linux、Windows 与 macOS 上提供透明代理。

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

运行环境 • 安装 • 首次运行 • 透明代理 • 数据与升级 • 支持



v2rayA 以服务形式运行，通过浏览器操作，可部署在本机、路由器或 NAS 上。它导入 VMess、VLESS、Shadowsocks、Trojan、Hysteria2、TUIC、Juicity、AnyTLS、WireGuard、SOCKS5 与 HTTP(S) 的订阅和分享链接。节点编成组后，由实测延迟最低的成员或固定的成员出站，分流由 RoutingA 规则决定。不支持 ShadowsocksR。

 运行环境

| 组件 | 要求 |
| --- | --- |
| 内核 | 与 v2raya 版本相同的 v2raya_core，放在同一目录或 PATH 中。下列软件包和安装程序都同时安装两者；手动安装时两者版本必须一致 |
| 规则数据 | /usr/share/v2raya 或 /usr/local/share/v2raya 中的 geoip.dat 与 geosite.dat。软件包自带；手动安装时首次启动从 GitHub 下载，下载失败则退出 |
| Linux 透明代理 | root 权限；redirect 与 tproxy 需要 iptables 或 nftables；tun 需要 /dev/net/tun 与 iproute2 的 ip 命令 |
| Windows | Windows 10 build 14393 及以上；tun 需要管理员权限；未提权启动时运行在 lite 模式，仍可设置当前用户的系统代理 |
| macOS | tun 需要 root 权限；以普通用户启动时运行在 lite 模式，改为提供系统代理 |
| 浏览器 | 当前版本的 Chrome、Edge、Firefox 或 Safari |

 安装

下列软件包同时安装 v2raya、v2raya_core 与服务定义。安装后按各平台给出的命令启用服务。


Debian、Ubuntu 与其他 APT 发行版

软件包由 Dae Universe 软件源提供。

sh
sudo apt update
sudo apt install curl


APT 3.0 及以上：

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


APT 3.0 以下：

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


然后导入密钥并安装：

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


修改服务单元请用 sudo systemctl edit --full v2raya.service；直接修改已安装的文件会在下次升级时被覆盖。




Fedora、RHEL、openSUSE 与其他 RPM 发行版

Fedora、RHEL 及其衍生版：

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


然后启用服务：

sh
sudo systemctl enable --now v2raya





Arch Linux

AUR 中的 v2raya 从源码构建，v2raya-bin 使用发布的二进制文件。发布页也提供 installer_archlinux__.pkg.tar.zst，可用 pacman -U 安装。

sh
paru -S v2raya-bin
sudo systemctl enable --now v2raya





Gentoo、Alpine 与其他 OpenRC 系统

在 Gentoo 上，从 gentoo-zh overlay 安装，再启用服务：

sh
sudo emerge net-proxy/v2rayA
sudo rc-update add v2raya default
sudo rc-service v2raya start


在 Alpine 上，从发布页取 installer_alpine_linux_x64_${VERSION}.apk，文件名中的架构部分按机器改成对应值。包内包含 OpenRC 脚本与 /etc/conf.d/v2raya；该包未用 Alpine 信任库中的密钥签名，因此需要 --allow-untrusted：

sh
sudo apk add --allow-untrusted ./installer_alpine_linux_x64_${VERSION}.apk
sudo rc-update add v2raya default
sudo rc-service v2raya start


其他系统从发布页下载对应架构的两个二进制文件，并使用 install/universal/ 中的 OpenRC 文件。以下命令在仓库检出目录中执行，VERSION 为不带前缀 v 的版本号，示例为 x64：

sh
sudo install -m755 "v2raya_linux_x64_${VERSION}" /usr/bin/v2raya
sudo install -m755 "v2raya_core_linux_x64_${VERSION}" /usr/bin/v2raya_core
sudo install -m755 install/universal/v2raya.initd /etc/init.d/v2raya
sudo install -m644 install/universal/v2raya.confd /etc/conf.d/v2raya
sudo rc-update add