客户端教程

v2rayN 上手:内核怎么选、订阅分组、系统代理与 TUN 的区别

v2rayN 使用教程:从官方 GitHub 下载、处理 SmartScreen 提示、添加并更新订阅、测试节点、设置系统代理与路由,以及开启 TUN 让 Claude Code、Codex 走代理。

简短回答

v2rayN 是开源的多内核代理客户端,Windows 用户最常用。从官方 GitHub 下载解压后,在订阅分组中添加订阅链接并更新,选好节点,再把系统代理设为自动配置即可使用。

最后更新:作者:梯子Z编辑部5 分钟阅读首发 2026年9月7日
v2rayN又称 v2rayN
支持平台Windows / macOS / Linux
价格免费
开源是
内核Xray / sing-box / Mihomo
支持协议Shadowsocks、VMess、VLESS、Trojan、Hysteria2、TUIC
上手难度进阶
适合习惯 V2Ray 生态的 Windows 用户
官方下载github.com

只从官方渠道下载,第三方打包版本可能被篡改。信息核对:2026-10-01

快速步骤 · 7 步

  1. 01
    从官方 GitHub 下载

    打开 2dust/v2rayN 的 Releases 页面,按系统下载对应发布包。

  2. 02
    解压并运行

    将压缩包解压到有写入权限的普通目录,运行 v2rayN 主程序,遇到 SmartScreen 提示时确认来源后放行。

  3. 03
    添加订阅分组

    在订阅分组设置中添加订阅,填写备注和订阅链接后保存。

  4. 04
    更新订阅

    执行更新订阅,节点列表加载后检查数量是否正常。

  5. 05
    测试并选择节点

    对节点做真连接延迟测试,选择一个稳定节点设为活动服务器。

  6. 06
    设置系统代理与路由

    将系统代理设为自动配置,路由选择绕过大陆类规则,然后用浏览器验证。

  7. 07
    按需开启 TUN

    需要终端工具走代理时,以管理员身份运行并开启 TUN 模式。

v2rayN 适合谁,整体流程

v2rayN 是一款老牌开源客户端,最早面向 Windows,现在也提供 macOS 和 Linux 版本。它最大的特点是可以在 Xray、sing-box、Mihomo 等内核之间切换,对单节点链接(如 vless://、trojan://)和订阅的管理也很细致。使用流程是:从官方 GitHub 下载 → 解压运行 → 添加并更新订阅 → 测速选节点 → 设置系统代理和路由。如果要让 Claude Code、Codex CLI 等终端工具联网,再开启 TUN 模式或给终端设置代理变量。

第一步:从官方 GitHub 下载

v2rayN 的官方发布地址是 2dust/v2rayN 仓库的 Releases 页面。下载时注意:

  • 按系统(Windows / macOS / Linux)和架构(x64 / arm64)选择对应发布包;
  • Windows 发布包有的需要系统安装 .NET 桌面运行时,有的已自带运行时,以 Releases 说明为准;
  • 不确定选哪个时,先看 Releases 页面的说明文字,不要随手下载第一个文件。

第二步:解压与首次运行

Windows 版通常是压缩包,不需要安装:

  1. 把压缩包解压到一个普通目录,例如 D:\Apps\v2rayN。避免放在 C:\Program Files 等需要管理员权限才能写入的目录,否则配置可能无法保存。
  2. 运行目录中的 v2rayN 主程序。
  3. 如果出现 SmartScreen 蓝色提示,确认文件来自官方 Releases 后,点击「更多信息」→「仍要运行」。
  4. 杀毒软件误报时,可以把 v2rayN 目录加入白名单,但前提是确定安装包来自官方。

macOS 版首次打开如遇 Gatekeeper 拦截,在「系统设置 → 隐私与安全性」中选择仍要打开。

第三步:添加并更新订阅

v2rayN 读取的是通用格式(Base64 编码的节点链接列表)订阅,机场通常标注为 V2Ray 或通用订阅。如果你不清楚自己拿到的是哪种链接,可以先看 订阅链接是什么。

  1. 打开顶部菜单中的「订阅分组」,进入订阅分组设置。
  2. 点击添加,填写备注(如机场名称)和订阅地址 URL,保存。
  3. 回到「订阅分组」菜单,执行更新订阅。如果订阅地址需要代理才能访问,选择通过代理更新的选项。
  4. 节点列表加载后,确认数量与机场后台大致一致。

菜单名称可能随版本略有不同,以实际界面为准。

第四步:测试并选择节点

在节点列表中全选节点,执行延迟测试。v2rayN 通常提供 Ping 类测试和“真连接延迟”测试,后者会真正通过节点发起请求,更能反映可用性。选中一个结果正常的节点,设为活动服务器(双击或回车)。

  • 测试结果为超时或 -1 的节点不要选;
  • 全部超时时,优先检查本地网络、系统时间和订阅是否过期;
  • 用于 Claude、ChatGPT 的节点,选择它们支持的地区并固定使用。

第五步:系统代理与路由

窗口底部状态栏有两个关键设置:

设置常见选项建议
系统代理清除系统代理 / 自动配置系统代理 / 不改变系统代理日常选「自动配置系统代理」
路由绕过大陆 / 全局等预设日常选绕过大陆类规则,国内直连

“自动配置系统代理”会把 Windows 的代理设置指向 v2rayN 的本地 HTTP 端口;退出 v2rayN 时一般会自动清除。如果异常退出导致没网,进入系统的代理设置手动关闭即可。

第六步:TUN 模式与终端工具

系统代理只对浏览器和遵循系统设置的应用生效,Claude Code、Codex CLI、git、npm 等命令行工具通常会忽略它。两种解决方式:

  1. 开启 TUN 模式:以管理员身份运行 v2rayN,在主界面开启 TUN,所有程序的流量都会被接管。
  2. 设置环境变量:在 v2rayN 设置中查看本地 HTTP 端口,然后在终端中执行,例如在 PowerShell 中:
$env:HTTPS_PROXY = "http://127.0.0.1:你的HTTP端口"
$env:HTTP_PROXY = "http://127.0.0.1:你的HTTP端口"

更完整的命令可以参考 终端代理设置。

第七步:更新与维护

  • 更新 v2rayN 本身:可以在程序的检查更新功能中更新,也可以到官方 Releases 下载新版本。手动更新前先备份程序目录中的配置文件夹,避免订阅和设置丢失。
  • 更新内核:v2rayN 的检查更新功能一般也能单独更新 Xray、sing-box 等内核;新协议无法连接时,先确认内核是否为较新版本。
  • 定期更新订阅:在订阅分组设置中可以为每个订阅设置自动更新间隔,机场换节点后无需手动操作。
  • 清理无效节点:测试后长期超时的节点可以移除,减少误选。

退出后没有网络怎么办

v2rayN 选择“自动配置系统代理”时,会把 Windows 的代理指向本地端口。如果程序异常退出、被杀毒软件拦截或电脑意外关机,系统代理可能残留,表现为所有网页都打不开。处理方法:

  1. 重新打开 v2rayN,把系统代理切到「清除系统代理」后再退出;
  2. 或者在 Windows「设置 → 网络和 Internet → 代理」中关闭手动代理设置;
  3. 如果开过 TUN,确认虚拟网卡已随程序退出移除,必要时重启电脑。

AI 工具使用建议

  • 固定节点:不要让 AI 会话期间的出口 IP 频繁变化,长对话和 Claude Code 任务中途切换节点容易断流或触发重新验证。
  • 路由保持分流:国内网站直连、海外与 AI 服务走代理,避免全局模式带来的国内服务异常。
  • 确认端口:v2rayN 的本地端口与 Clash 系客户端不同,设置环境变量时以 v2rayN 设置中显示的端口为准,不要照抄 7890。

常见问题速查

现象可能原因处理方向
开启后完全没网系统代理残留、节点不可用、TUN 冲突见 开启客户端后没有网络
所有节点测速都超时本地网络、系统时间、订阅失效见 节点全部超时怎么办
程序打不开缺少 .NET 运行时或目录无写入权限安装运行时或换到普通目录
订阅更新后为空链接格式不对或订阅过期使用通用格式订阅并检查有效期
浏览器可用、终端不可用命令行不读系统代理开启 TUN 或设置环境变量

常见问题

Qv2rayN 解压后打不开,提示缺少运行库怎么办?

部分发布包依赖 .NET 桌面运行时。可以按提示安装微软官方的 .NET 桌面运行时,或在 Releases 中选择自带运行时的发布包。

Qv2rayN 和 Clash Verge Rev 选哪个?

两者都能满足日常使用。Clash Verge Rev 界面更直观,适合新手;v2rayN 可切换多种内核,适合已经熟悉 V2Ray 生态或需要单节点链接管理的用户。

Q为什么浏览器能用,命令行工具却连不上?

命令行工具通常不读取系统代理。可以开启 v2rayN 的 TUN 模式,或在终端中把 HTTPS_PROXY 指向 v2rayN 的本地 HTTP 端口。

Q订阅更新后节点列表是空的?

先确认订阅没有过期、链接完整;如果机场只提供 Clash 格式链接,需要改用机场提供的通用(V2Ray)格式订阅。

参考来源

  1. v2rayN 官方 GitHub 仓库
  2. v2rayN Releases 下载页
  3. Xray-core 官方仓库
Esc

热门搜索

    ↑↓ 选择 · Enter 打开 · Esc 关闭打开搜索页