Files
v2rayA/README_zh.md
Zakk a68a26c52a docs: name the Alpine package as the release does
The README named it installer_alpine_linux_x64_<version>.apk; the release
files are installer_alpine_<arch>_<version>.apk.
2026-11-14 22:17:03 +11:00

12 KiB
Raw Permalink Blame History

v2rayA

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 软件源提供。

sudo apt update
sudo apt install curl

APT 3.0 及以上:

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

APT 3.0 以下:

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

然后导入密钥并安装:

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 及其衍生版:

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

openSUSE:

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

然后启用服务:

sudo systemctl enable --now v2raya
Arch Linux

AUR 中的 v2raya 从源码构建,v2raya-bin 使用发布的二进制文件。发布页也提供 installer_archlinux_<arch>_<version>.pkg.tar.zst,可用 pacman -U 安装。

paru -S v2raya-bin
sudo systemctl enable --now v2raya
Gentoo、Alpine 与其他 OpenRC 系统

在 Gentoo 上,从 gentoo-zh overlay 安装,再启用服务:

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

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

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

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

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 v2raya default
sudo rc-service v2raya start
Docker

镜像为 ghcr.io/v2raya/v2raya,Docker Hub 上是 mzz2017/v2raya。以下示例针对 Linux 宿主机,赋予容器宿主机网络与特权,透明代理需要这两项:

docker run -d --restart=always --privileged --network=host --name v2raya \
  -e V2RAYA_LOG_FILE=/tmp/v2raya.log \
  -v /lib/modules:/lib/modules:ro \
  -v /etc/resolv.conf:/etc/resolv.conf \
  -v /etc/v2raya:/etc/v2raya \
  ghcr.io/v2raya/v2raya

改用桥接网络时,需要映射 2017 端口和使用的入站端口,并在设置中开启端口共享,否则入站只监听容器的回环地址。这种方式不提供透明代理。

Windows

发布页的 installer_windows_inno_x64_<version>.exe(或 arm64)安装两个二进制文件并注册服务。winget install --id v2rayA.v2rayA 与 scoop bucket(scoop bucket add v2raya https://github.com/v2rayA/v2raya-scoop && scoop install v2raya-np)使用同一个安装程序。

macOS

tap 安装两个二进制文件。以 root 启动的服务提供 tun 透明代理,以当前用户启动的服务运行在 lite 模式,只提供系统代理:

brew tap v2raya/v2raya
brew install v2raya/v2raya/v2raya
sudo brew services start v2raya   # root:tun
brew services start v2raya        # 当前用户:系统代理

用 sudo 启动的服务要用 sudo brew services stop v2raya 停止;Homebrew 会提示,以 root 启动过的 formula 在升级或卸载时需要 sudo rm 它列出的路径。

OpenWrt

v2raya-openwrt 软件源与官方 packages 源目前打包的是 2.2.7.x,搭配独立的 xray-core,不是本文描述的版本。在它们更新之前,按下一节的方式手动安装 mips32、mips32le、arm64 或 x64 的发布二进制文件,并自行编写 init 脚本。

其他 Linux,不使用软件包

从发布页下载 v2raya_linux_<arch>_<version> 与 v2raya_core_linux_<arch>_<version>(x86、x64、arm64、armv7、riscv64、loongarch64、mips32、mips32le、mips64、mips64le),用同名的 .sha256.txt 校验,两者都安装到 /usr/bin。使用 systemd 时:

sudo install -m644 install/universal/v2raya.service /etc/systemd/system/v2raya.service
sudo systemctl daemon-reload
sudo systemctl enable --now v2raya

使用 OpenRC 时,参照上一节的文件。另有单独维护的 snap。

首次运行

服务监听 0.0.0.0:2017,部署在路由器或 NAS 上时,界面地址为 http://<设备地址>:2017。第一个注册的账户就是管理员,注册无需登录,因此在共享网络中先限制访问再注册,或者只在本机使用时以 --address 127.0.0.1:2017 启动。

打开界面并创建管理员。随后的引导流程依次导入订阅或分享链接、把节点加入组、选择路由规则;内核由仪表板的启动按钮或页面顶部的状态按钮启动。

内核运行后,把应用指向 SOCKS5 127.0.0.1:20170 或 HTTP 127.0.0.1:20171(20172 对 HTTP 应用路由规则),或者在仪表板开启透明代理并从下表选择模式。组内有多个已连接成员时,使用实测延迟最低的成员;固定某个成员后,该组只经它出站。订阅可在订阅页手动更新,也可按设置中的间隔自动更新。

仪表板,明暗两种主题

透明代理

平台 模式
Linux redirect、tproxy、tun;--lite 下为 GNOME 与 KDE 的系统代理
macOS tun;--lite 下为系统代理
Windows tun、系统代理

系统代理模式修改桌面的代理设置,只覆盖遵守该设置的应用;其他模式拦截流量。

tun 模式下,内核打开 TUN 设备并配置地址;自动路由(默认开启)时由 v2rayA 安装路由和 DNS 设置,否则由用户自己的脚本完成。内核自己的连接、direct 出站与 DNS 模块的上游查询不会进入 TUN(Linux 通过套接字标记,Windows 与 macOS 通过绑定物理网卡)。到达 TUN 的 53 端口明文 DNS 由内核的 DNS 模块回答,加密 DNS 不被拦截。v2rayA 与内核始终被排除,其他进程可在设置里按可执行文件名排除。更精确的直连路由与静态路由不经过 TUN。

已知限制:Windows 与 macOS 上直接向局域网 DNS 查询的应用仍会绕过 TUN。系统解析器不受影响:Windows 指向 TUN 网关,macOS 指向内核在 127.0.0.1 上的监听,后者要求 53 端口空闲。

路由规则

RoutingA 编辑器,明暗两种主题

RoutingA 支持列表和文本两种编辑模式。列表模式为每条规则提供表单;文本模式提供行号、着色和逐行检查。编辑器旁有语法参考,规则可导入导出为文本文件。

数据与升级

SQLite 数据库 v2raya.db 与生成的内核配置位于配置目录:Linux 与 macOS 为 /etc/v2raya,Windows 服务为 %ProgramData%\SYSTEM\v2rayA,--lite 为用户配置目录,也可用 --config 指定。systemd 与 OpenRC 单元把日志写到 /var/log/v2raya/v2raya.log,也可用 --log-file 或 V2RAYA_LOG_FILE 指定。程序在更新订阅、下载规则数据、测量延迟、解析 DNS、启动时和每周一次向 GitHub 检查新版本,以及 VMess 节点失败时向 ntp.aliyun.com 查询时间(用于区分时钟错误与节点故障)时发起网络请求。

升级前先停止服务并备份配置目录。从 2.4 以下版本升级时,首次启动会迁移 BoltDB 数据库,旧文件保留为 bolt.db.bak(该名称已存在时为 bolt.db.bak.1 及后续编号),账户需要重新注册。v2raya 与 v2raya_core 必须一起升级:仪表板显示内核版本,版本不一致时显示横幅提示。

支持

问题请到 Discussions 提问,缺陷请到 Issues 报告。

不要将本项目用于不合法用途。

致谢

由 @mzz2017 创立。Material Design 3 界面、内核内建的 TUN 与 2.5 的服务端重构由 @Zakkaus 完成。OpenRC 文件来自 Gentoo 中文社区。路由数据来自 v2fly/domain-list-community 与 v2fly/geoip,GFWList 模式使用 Loyalsoldier/v2ray-rules-dat。透明代理规则参考了 zfl9/ss-tproxy 与 hq450/fancyss。

许可证

AGPL-3.0-only。内核是 Xray-core 的分支,采用 MPL-2.0。