v2rayA 使用教程

软件介绍

v2rayA

Web 面板式代理客户端，支持 V2Ray/Xray/sing-box 内核。

v2rayA 在代理客户端里比较特别——它没有独立的 GUI 窗口，而是提供一个 Web 管理面板，你在浏览器里操作就行。用 Go 语言写的，GitHub 上 15.4K Stars，2026 年 7 月 22 日刚发了 v2.4.9，作者还在活跃维护，没有被归档。

后端正反都支持——可以选 xray、v2ray 核心，也支持 sing-box 核心，启动时自己指定就行。支持的协议就看后端的能力：VMess、VLESS、Trojan、Shadowsocks、Socks5 这些常用的都行，Hysteria 2 需要 xray 核心的对应版本。

它跟 v2rayN 最大的区别是：v2rayN 是 Windows 桌面上的点按式客户端，需要一直开着窗口。v2rayA 装好之后跑在后台，Web 面板是通过浏览器访问 http://localhost:2017 来管理的，关掉浏览器它还在跑。你远程服务器上装一个，SSH 转发端口到本地，就能在本地浏览器管理服务器上的代理。

优点

• Web 远程管理：浏览器就能操作，Linux 服务器上不需要桌面环境
• 多后端切换：xray、v2ray、sing-box 核心都能用
• 平台覆盖广：Linux（deb/rpm/Arch）、Windows、macOS、FreeBSD、OpenBSD
• 透明代理：Linux 上支持 iptables/nftables 透明代理

缺点

• 不适合小白：需要命令行基础才能装，Linux 上操作居多
• 没有策略组：v2rayA 不走 Clash 的策略组分流，而是用 v2ray 路由
• 首次配置需要命令行：不像桌面客户端下载就能用

下载安装

GitHub 搜 v2rayA/v2rayA，Releases 页面下载。最新版 v2.4.9（2026-07-22）。

下载地址

安装步骤

Linux (Debian/Ubuntu)：

sudo dpkg -i installer_debian_x64_2.4.9.deb
sudo systemctl start v2raya

Windows： 双击 exe 安装，装完后在开始菜单打开 v2rayA。

macOS： 下载二进制文件，给执行权限后直接运行：

chmod +x v2raya_darwin_x64_2.4.9
./v2raya_darwin_x64_2.4.9

使用教程

启动和访问

默认监听 0.0.0.0:2017。装好后浏览器打开 http://localhost:2017，第一次访问会要求创建一个管理员账号。

如果你装在了远程服务器上，用 SSH 端口转发：

ssh -L 2017:localhost:2017 user@your-server

然后本地浏览器开 http://localhost:2017。

导入订阅

登录 Web 面板后，点左侧 订阅 → 添加订阅 → 输入订阅链接和备注 → 保存。然后在订阅列表点「更新」，节点就会出现在节点列表里。

配置节点

更新完订阅后切到 节点 页面，能看到所有节点。选一个节点点「设为所选」。如果需要添加自定义节点，点「创建节点」手动填参数。

设置和连接

点 设置 页面，确认代理端口（默认 20170 SOCKS5、20171 HTTP）。选完节点后点左上角的开关，v2rayA 就开始代理了。

深入配置（进阶篇）

透明代理

Linux 上 v2rayA 支持透明代理（iptables/nftables 模式），让局域网内所有设备都走代理。在设置页面开启「透明代理」并选择出站接口就行。

多核心切换

v2rayA 默认用 xray 核心，但可以在设置里切换到 sing-box 核心。不同核心的协议支持不一样：

• xray: VMess、VLESS、Trojan、Shadowsocks、Socks5、Hysteria 2
• sing-box: 同上 + 更多新协议

路由规则

v2rayA 不走 Clash 的策略组，而是用 v2ray 的路由规则。你可以在 Web 面板的「规则」页面配置：哪些域名/IP 走代理、哪些直连、哪些走特定出站。

常见问题

1. 适合什么样的用户？

Linux 用户、有 VPS 的用户、需要通过 Web 远程管理代理的用户。如果你只用 Windows 桌面点鼠标，v2rayN 可能更适合。

2. 和 v2rayN 的区别？

v2rayN 是 Windows 桌面客户端，v2rayA 是 Web 管理面板。v2rayA 的优势在服务器端使用。

3. 需要装 xray 核心吗？

v2rayA 安装包不包含核心，需要另外装。根据官方文档，建议装 xray 核心。

4. 支持自动更新订阅吗？

支持。在订阅设置里可以配置自动更新间隔。

总结

v2rayA 在代理客户端里定位很特别——Web 管理、远程控制、多后端切换。它不是给桌面用户做的替代品，而是给需要远程管理代理的用户准备的。