兔洞博客
兔洞博客
个人博客

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 x64 (Debian/Ubuntu)installer_debian_x64_2.4.9.deb31 MB
Linux x64 (RedHat/Fedora)installer_redhat_x64_2.4.9.rpm31 MB
Linux Archinstaller_archlinux_x64_2.4.9.pkg.tar.zst30 MB
Windows x64installer_windows_inno_x64_2.4.9.exe27 MB
Windows arm64installer_windows_inno_arm64_2.4.9.exe25 MB
macOS Intelv2raya_darwin_x64_2.4.928 MB
macOS Apple Siliconv2raya_darwin_arm64_2.4.927 MB

安装步骤

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 就开始代理了。

💡 Web 面板不用一直开着
配置好之后关掉浏览器 v2rayA 也在后台跑。再次管理时重新打开 http://localhost:2017 登录就行。

深入配置(进阶篇)

透明代理

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 管理、远程控制、多后端切换。它不是给桌面用户做的替代品,而是给需要远程管理代理的用户准备的。

v2rayA Linux Windows macOS Web
使用指南