客户端教程 使用教程 深度指南

v2rayN 完整使用教程:安装内核、订阅分组、路由设置与 TUN 模式

v2rayN 完整使用教程:从官方 GitHub Releases 下载安装、选择 Xray 或 sing-box 内核、添加订阅分组、节点测速、系统代理与路由设置、TUN 模式及常见报错处理。

首次发布
最后更新
内容类型
使用教程
资料核对
阅读时间
约 5 分钟

信息可能随服务调整而变化,请以最新官方信息为准。

客户端档案

v2rayN

Windows 上历史悠久的开源客户端,支持 Xray、sing-box 等多内核。

平台
Windows、macOS、Linux
内核
Xray / sing-box / Mihomo
价格
免费
开源
是
上手难度
进阶
适合
习惯手动管理节点的 Windows 用户
支持协议
Shadowsocks、VMess、VLESS、Trojan、Hysteria2、TUIC

直接答案

v2rayN 是开源免费的多内核代理客户端,以 Windows 用户为主,也提供 macOS 与 Linux 版本。基本用法是:从官方 GitHub Releases 下载并解压,在「订阅分组」中添加机场订阅并更新,选中节点设为活动服务器,把系统代理设为自动配置,路由选择绕过大陆即可。终端和游戏需要走代理时再开启 TUN 模式。

Key Takeaways · 要点速览

  • v2rayN 是外壳,可以调用 Xray、sing-box、Mihomo 等内核,不同内核支持的协议有差异。
  • 下载时优先选择自带运行库的版本,避免因缺少 .NET 运行库而无法启动。
  • 订阅通过「订阅分组」管理,添加后需要手动执行一次更新。
  • 测速请使用真连接延迟测试,它比 TCP 延迟更接近真实可用性。
  • 按钮名称和默认端口以最新版本和设置中显示的为准。

操作步骤

  1. 下载并解压

    从 v2rayN 官方 GitHub Releases 下载与系统匹配的压缩包,优先选择自带运行库的版本,解压到非系统目录后运行主程序。

  2. 添加订阅分组

    打开「订阅分组」→「订阅分组设置」,点击添加,填写备注并粘贴机场订阅链接,确定保存。

  3. 更新订阅

    在「订阅分组」菜单中执行更新全部订阅;订阅域名无法直连时,选择通过代理更新。

  4. 测速并选择节点

    全选节点后执行真连接延迟测试,选择结果稳定的节点,按回车或右键将其设为活动服务器。

  5. 设置系统代理与路由

    在主界面底部将系统代理设为自动配置系统代理,路由选择绕过大陆或类似的分流规则。

  6. 按需开启 TUN

    需要终端或游戏走代理时,以管理员身份运行 v2rayN 并打开 TUN 模式开关,同时检查内核与 DNS 设置。

v2rayN 是什么、适合谁

v2rayN 是一款开源免费的代理客户端,最初只支持 Windows,目前也提供 macOS 与 Linux 版本。它本身是一个图形外壳,实际的代理转发交给 Xray、sing-box 或 Mihomo 等内核完成。与按规则自动分流的 Clash Verge Rev 相比,v2rayN 的思路是「逐个管理节点 + 选择路由规则」,适合喜欢手动控制、需要频繁切换单个节点的用户。本文按 Windows 版操作顺序编写,其它平台逻辑相同,界面文字以最新版本为准。

项目 说明
支持平台 Windows、macOS、Linux
内核 Xray / sing-box / Mihomo(按协议与设置选择)
价格 免费、开源
常见协议 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、TUIC
上手难度 进阶

准备工作

  • 订阅链接:v2rayN 使用通用的分享链接格式订阅(Base64 编码的节点列表),机场一般标注为「V2Ray 订阅」「通用订阅」或「v2rayN 订阅」;
  • 系统时间准确:时间偏差会导致 VMess 等协议握手失败;
  • 关闭其它代理客户端:避免系统代理被多个程序同时修改。

注意只从 v2rayN 官方 GitHub Releases 下载。网盘、群文件中流传的「整合版」「汉化增强版」可能被修改过,存在窃取订阅或植入恶意程序的风险。

第一步:下载与安装

打开官方 GitHub 仓库的 Releases 页面,下载最新正式版本。Windows 版本通常提供两类压缩包:

类型 特点 建议
自带运行库版本 体积较大,解压即用 新手首选
不含运行库版本 体积小,需要系统已安装 .NET 桌面运行库 已安装运行库的用户

具体文件名以 Releases 页面说明为准。下载后解压到一个非系统目录(例如 D 盘的独立文件夹,避免放在 Program Files 中导致写入权限问题),运行主程序即可。v2rayN 不需要安装,配置文件保存在程序目录下,迁移时整个文件夹复制即可。

第二步:添加并更新订阅

  1. 点击菜单「订阅分组」→「订阅分组设置」;
  2. 点击「添加」,填写备注(例如机场名称),在「URL」中粘贴订阅链接;
  3. 确定并关闭窗口;
  4. 回到主界面,点击「订阅分组」→「更新全部订阅」。

如果订阅域名在当前网络下无法直连,可以选择「通过代理更新」(需要先有一个可用节点)。更新成功后,节点会按订阅分组显示在列表中。

提示订阅分组可以设置自动更新间隔。机场更换节点后,及时更新订阅可以避免「节点突然全部失效」。更新失败时参考 机场订阅更新失败怎么办。

第三步:测速与选择节点

v2rayN 提供多种测速方式,建议理解它们的区别:

测试方式 测试内容 参考价值
TCP 延迟(Ping) 本机到节点服务器的连通性 只说明服务器可达,不代表代理可用
真连接延迟 通过节点完整发起一次请求 最接近真实可用性,推荐使用
测速(下载) 通过节点下载测试文件 消耗流量,按需使用

全选节点(Ctrl + A)后执行真连接延迟测试,选择结果稳定且数值合理的节点,按回车或右键「设为活动服务器」。显示 -1 的节点表示测试失败。

第四步:系统代理与路由

主界面底部有两个关键设置:

系统代理

  • 自动配置系统代理:v2rayN 自动把系统代理指向本地端口(以设置中显示的为准,例如 10808),日常使用选这个;
  • 清除系统代理:关闭系统代理;
  • 不改变系统代理:v2rayN 不修改系统设置,适合手动为特定程序配置代理。

路由

路由决定哪些流量走代理、哪些直连:

路由选项 行为 适用场景
绕过大陆 国内域名与 IP 直连,其余走代理 日常使用,推荐
黑名单 只有被列出的域名走代理 只想代理少数服务
全局 所有流量走代理 临时排查

可以在「路由设置」中添加自定义规则,例如把 AI 服务域名固定到某个出口,或把公司内网设为直连。

第五步:TUN 模式

系统代理只对遵守代理设置的程序生效,Claude Code、Codex CLI、git 等命令行工具和大部分游戏通常需要 TUN 模式:

  1. 以管理员身份运行 v2rayN(Windows);
  2. 打开主界面底部的「启用 Tun」开关;
  3. 在设置中确认 TUN 使用的内核与 DNS 配置;
  4. 新开一个终端窗口验证是否已经走代理。

TUN 模式下 DNS 设置更重要,域名解析异常时可参考 DNS 错误怎么办。

内核选择说明

v2rayN 会根据节点协议调用不同内核,不同内核的协议支持范围不同(以各内核官方说明为准):

  • Xray:VMess、VLESS、Trojan、Shadowsocks 等传统协议的默认选择;
  • sing-box:对 Hysteria2、TUIC 等新协议和 TUN 模式支持较好,也可以参考 sing-box 使用入门;
  • Mihomo:可直接使用 Clash 格式配置。

协议本身的差异可以参考 代理协议对比。

常见错误与解决方法

现象 可能原因 处理方法
打开即闪退或提示缺少运行库 未安装 .NET 桌面运行库 改用自带运行库的版本
提示找不到内核文件 下载了不含内核的压缩包;文件被安全软件隔离 重新从官方 Releases 下载完整包
订阅更新后没有节点 订阅格式不匹配;链接不完整;套餐到期 向机场确认通用订阅地址;重新复制;检查套餐
真连接延迟全部 -1 套餐过期;时间不准;节点维护 检查用户中心与系统时间,查看机场公告
浏览器无法上网 系统代理未设置;活动服务器不可用 设为自动配置系统代理;更换活动服务器
终端不走代理 命令行工具不读取系统代理 开启 TUN 或为终端设置代理环境变量
关闭后无法上网 程序异常退出未清除系统代理 重新打开后选择清除系统代理再退出

客户端开启后完全没有网络的系统化排查,可参考 客户端开启后没有网络怎么办。

请在遵守所在地法律法规与相关服务条款的前提下使用网络服务。

常见问题

v2rayN 打开就闪退或提示缺少运行库怎么办?

通常是系统缺少对应版本的 .NET 桌面运行库。重新下载 Releases 中自带运行库的版本即可,或按提示从微软官方安装所需运行库。

v2rayN 应该选 Xray 还是 sing-box 内核?

VMess、VLESS、Trojan 等常见协议用默认的 Xray 内核即可;Hysteria2、TUIC 等协议或 TUN 模式通常由 sing-box 内核处理效果更好。v2rayN 会根据节点类型自动或按设置选择内核,以实际版本为准。

真连接延迟显示 -1 是什么意思?

表示测试请求没有成功返回,节点在当前时刻不可用。可能是节点故障、套餐过期、本地时间不准或内核不支持该协议。多个节点都为 -1 时,优先检查订阅与套餐状态。

v2rayN 和 Clash Verge Rev 哪个好?

两者都免费开源。Clash Verge Rev 按订阅规则自动分流,更适合新手;v2rayN 习惯逐个管理节点,路由规则需要自己选择,更适合喜欢手动控制的用户。机场提供哪种订阅格式也会影响选择。

安全软件提示 v2rayN 有风险怎么办?

先确认文件来自官方 GitHub Releases,并核对发布页信息。不要从网盘或第三方站点下载。对来源不明的版本,任何提示都应视为真实风险。

参考资料