v2rayN 教程

v2rayN 是一款开源代理客户端，提供 Windows、Linux 和 macOS 版本，可调用 Xray、sing-box 等内核，兼容 VMess、VLESS、Trojan、Shadowsocks、Hysteria2 等协议。它最适合机场给的是通用（Base64）订阅的用户：下载官方便携包、添加订阅、测速选节点、开启系统代理，四步即可上网。

安装包怎么选

Releases 页面文件很多，下面按官方 Wiki 的“Release files introduction”整理：

系统	推荐文件	说明
Windows x64	v2rayN-windows-64.zip	传统 WPF 界面，便携版，解压即用
Windows x64（另一种界面）	v2rayN-windows-64-desktop.zip	Avalonia 界面，与 Linux/macOS 版外观一致
Windows ARM64	v2rayN-windows-arm64.zip 或 -desktop 版	适用于骁龙等 ARM 处理器的 Windows 设备
Debian / Ubuntu	.deb（区分 64 与 arm64）	官方要求 Debian 12+ / Ubuntu 22.04+
Fedora / RHEL	文件名含 rhel 的 .rpm	官方要求 Fedora 36+ / RHEL 9+
macOS	.dmg（区分 64 与 arm64）	官方要求 macOS 13.6+，Apple 芯片选 arm64

文件名带 other-bins 的是额外内核补充包，放进程序的 bin 目录使用，新手一般不需要。便携版 zip 的设置保存在程序自己的文件夹里，可以放多份互不干扰。

本文参考版本为 v7.25.6（2026 年 10 月），Windows 最低要求 Windows 10，Windows 7 无法使用新版本。

移动端不是同一个软件：Android 请看 v2rayNG 使用教程，iPhone 可以看 Shadowrocket（小火箭）使用教程。各平台还有哪些选择，见 机场客户端大全。

官方下载入口

• GitHub 仓库：github.com/2dust/v2rayN
• 下载：仓库 Releases 页面；每个文件的用途见仓库 Wiki 的“Release files introduction”

只从官方仓库下载。网上流传的“v2rayN 中文版”“整合包”可能夹带被改过的内核或订阅。

安装与首次启动

1. Windows：把 zip 解压到一个固定且路径简单的文件夹（如 D:\Apps\v2rayN），不要在压缩包里直接运行，也不要放在桌面或下载目录。双击 v2rayN.exe 启动，程序会最小化到右下角托盘。
2. Linux：用 apt 或 dnf 安装对应安装包；使用 zip 便携版时，先 chmod +x v2rayN，再以普通用户运行。
3. macOS：安装包未签名，打开时可能提示“已损坏”。确认是官方下载后，在终端执行：

xattr -cr /Applications/v2rayN.app

启动后提示缺少运行库或内核文件时，回到 Releases 确认下载的是上表中的完整包，而不是源代码压缩包。

导入订阅

1. 在机场用户中心复制 V2Ray / 通用订阅链接。Clash 专用的 YAML 订阅通常不适合 v2rayN，格式区别见 订阅链接导入教程。
2. 打开订阅分组设置，添加订阅：填写备注和订阅地址，保存。
3. 回到主界面执行“更新订阅”，可选择是否通过代理更新。
4. 节点出现在服务器列表中。

更新后列表为空或提示解析失败，多半是订阅格式不对，参见 订阅格式错误 / 导入后没有节点怎么解决。也可以复制单个节点的分享链接（vless://、trojan:// 等），从剪贴板批量导入。

内核选择：Xray 还是 sing-box

v2rayN 本身只是图形界面，真正负责连接的是内核，这是它和其他客户端最大的不同：

内核	擅长	说明
Xray	VLESS、VMess、Trojan、REALITY	默认内核，兼容面广
sing-box	Hysteria2、TUIC 等 UDP/QUIC 协议	v2rayN 的 TUN 模式也依赖它

每个节点可以单独指定内核。某个协议在一种内核下连不上，可以在节点编辑界面切换内核再试。

Xray 新版本在逐步收紧“跳过证书校验”（allowInsecure）这类不安全选项。如果节点使用自签证书，升级后在 Xray 内核下突然连不上，可以向机场索取证书指纹等替代参数，或先换 sing-box 内核测试。

协议差异可参考 什么是 VLESS 协议（含 Reality 简介） 和 什么是 Hysteria2 协议。

测速与选择节点

1. 在服务器列表中全选节点，执行延迟测试。真连接延迟比 TCPing 更能反映节点是否真的可用。
2. 按延迟排序，忽略超时节点。
3. 选中节点后设为活动服务器（双击或回车），状态栏会显示当前节点。
4. 挑两三个候选节点实际打开网页、播放视频比较，延迟最低的未必最快。

全部超时请看 机场节点超时怎么解决。

系统代理、路由与 TUN

托盘菜单或主界面底部有两组关键设置。

系统代理：

• 自动配置系统代理：浏览器等软件立即走代理，新手选这个。
• 清除系统代理：关闭代理。
• 不改变系统代理：只开本地端口，由软件自行配置。

路由：

• 绕过大陆（规则分流）：国内直连、国外代理，日常推荐。
• 全局：所有流量走代理，只用于临时排查。
• 自定义规则集：在路由设置中按需调整，思路见 分流规则与代理模式设置。

游戏、命令行等不读系统代理的程序，需要开启 TUN 模式，Windows 上要以管理员身份运行，原理见 TUN 模式详解。

连接验证

1. 浏览器访问海外网站，确认可以打开。
2. 查看 v2rayN 下方日志窗口，大量 failed、timeout 说明节点或内核有问题。
3. 访问国内网站，确认没有变慢；变慢时检查路由是否误选了“全局”。

常见问题

v2rayN 打开后没反应

可能已经在托盘里运行，或内核文件被杀毒软件误删。把程序目录加入杀毒软件信任列表后重新解压，参见 代理客户端无法启动 / 闪退怎么解决。

提示端口被占用

默认本地端口与其他代理软件冲突。退出冲突程序，或在参数设置中修改本地端口，参见 端口被占用（7890 等）怎么解决。

退出 v2rayN 后无法上网

异常退出导致系统代理没有清除，手动关闭系统代理即可，参见 系统代理错误怎么解决。

v2rayN 能用 Clash 订阅吗

新版本对多种格式有一定兼容，但最稳妥的是使用机场的通用订阅；机场主推 Clash 订阅时，换用 Clash Verge Rev 更省事。

怎么升级 v2rayN

可以使用程序内的检查更新功能，也可以到 Releases 下载新版便携包，解压覆盖到原目录（先备份配置文件夹）。内核也可以单独更新，升级后如某类节点连不上，先切换内核对比。

能测出延迟但打不开网页

参见 节点延迟正常但打不开网页怎么办。

配置备份

便携版的配置都在程序目录下的配置文件夹中（如 guiConfigs）。重装或换电脑前，复制整个程序文件夹即可完整迁移；也可以只记下订阅链接，到新电脑重新导入。更多方法见 配置备份与迁移教程。