v2rayA：Xray 网页图形客户端

项目简介

v2rayA 是一个基于 Xray 内核的图形化客户端：它以服务形式运行，用户通过浏览器访问界面进行管理，既可以装在本机，也可以部署在路由器或 NAS 上。它支持导入 VMess、VLESS、Shadowsocks、Trojan、Hysteria2、TUIC、Juicity、AnyTLS、WireGuard、SOCKS5 和 HTTP(S) 的订阅与分享链接，可以对节点分组，并按实测最低延迟自动选择成员或固定使用某个成员，还可以用 RoutingA 规则进行流量分流。项目不支持 ShadowsocksR。

主要功能

• 订阅与节点管理：导入订阅或分享链接，分组管理，按实测延迟自动选优，或固定某个成员走该组。
• RoutingA 规则分流：同时提供列表模式（每条规则一个表单）和文本模式（行号、着色、逐行检查），可在编辑器旁查阅语法参考，规则可导入导出为文本文件。
• 透明代理：

平台	模式
Linux	redirect、tproxy、tun；加 --lite 时使用 GNOME、KDE 的系统代理
macOS	tun；加 --lite 时使用系统代理
Windows	tun、系统代理

• 本地入站端口：把应用指向 SOCKS5 127.0.0.1:20170 或 HTTP 127.0.0.1:20171（20172 会对 HTTP 应用分流规则），也可以在仪表盘开启透明代理。

安装与使用

运行前提：v2raya_core 需与 v2raya 版本一致，并放在同一目录或 PATH 中；geoip.dat、geosite.dat 放在 /usr/share/v2raya 或 /usr/local/share/v2raya。Linux 透明代理需要 root 权限以及 iptables/nftables（redirect、tproxy）或 /dev/net/tun 和 iproute2 的 ip（tun）；Windows 需 10 build 14393 及以上，tun 需要管理员权限；macOS 的 tun 需要 root 权限。

常见安装方式：

# Debian / Ubuntu（来自 Dae Universe 仓库）
sudo apt install v2raya
sudo systemctl enable --now v2raya

# Arch Linux
paru -S v2raya-bin

# Windows
winget install --id v2rayA.v2rayA

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

Docker 方式（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

首次运行：服务监听 0.0.0.0:2017，在路由器或 NAS 上通过 http://<设备地址>:2017 访问；打开界面注册管理员账号后，按引导导入订阅或分享链接、把节点加入分组并设置路由规则，然后在仪表盘或页面顶部点击启动内核。

注意事项

• 第一个注册的账号会成为管理员，且注册无需登录，所以在共享网络中应先限制访问，或用 --address 127.0.0.1:2017 仅限本机使用。
• 升级前请停止服务并备份配置目录。配置目录在 Linux/macOS 为 /etc/v2raya，Windows 服务为 %ProgramData%\SYSTEM\v2rayA，--lite 或 --config 时为对应路径；数据库文件为 v2raya.db。
• 从 2.4 之前的版本升级会在首次启动时迁移 BoltDB 数据库，原文件保留为 bolt.db.bak，账号需要重新注册。
• v2raya 与 v2raya_core 必须一起升级，版本不匹配会在界面顶部提示。
• 使用 tun 时，核心自身的连接、direct 出站和 DNS 模块的上游查询不会进入 TUN；到达 TUN 的 53 端口明文 DNS 由核心 DNS 模块应答，加密 DNS 不会被拦截。
• 已知限制：在 Windows 和 macOS 上，直接向局域网 DNS 查询的应用仍会绕过 TUN。
• 请勿将本项目用于任何非法用途。

---

本作品整理自 GitHub 开源项目 v2rayA/v2rayA，原作者 @v2rayA，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。