客户端教程
v2rayN 上手:内核怎么选、订阅分组、系统代理与 TUN 的区别
v2rayN 使用教程:从官方 GitHub 下载、处理 SmartScreen 提示、添加并更新订阅、测试节点、设置系统代理与路由,以及开启 TUN 让 Claude Code、Codex 走代理。
简短回答
v2rayN 是开源的多内核代理客户端,Windows 用户最常用。从官方 GitHub 下载解压后,在订阅分组中添加订阅链接并更新,选好节点,再把系统代理设为自动配置即可使用。
| 支持平台 | Windows / macOS / Linux |
|---|---|
| 价格 | 免费 |
| 开源 | 是 |
| 内核 | Xray / sing-box / Mihomo |
| 支持协议 | Shadowsocks、VMess、VLESS、Trojan、Hysteria2、TUIC |
| 上手难度 | 进阶 |
| 适合 | 习惯 V2Ray 生态的 Windows 用户 |
| 官方下载 | github.com |
只从官方渠道下载,第三方打包版本可能被篡改。信息核对:2026-10-01
快速步骤 · 7 步
- 01从官方 GitHub 下载
打开 2dust/v2rayN 的 Releases 页面,按系统下载对应发布包。
- 02解压并运行
将压缩包解压到有写入权限的普通目录,运行 v2rayN 主程序,遇到 SmartScreen 提示时确认来源后放行。
- 03添加订阅分组
在订阅分组设置中添加订阅,填写备注和订阅链接后保存。
- 04更新订阅
执行更新订阅,节点列表加载后检查数量是否正常。
- 05测试并选择节点
对节点做真连接延迟测试,选择一个稳定节点设为活动服务器。
- 06设置系统代理与路由
将系统代理设为自动配置,路由选择绕过大陆类规则,然后用浏览器验证。
- 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 页面的说明文字,不要随手下载第一个文件。
注意
搜索引擎里有大量仿冒“v2rayN 官网”和“中文破解版”,它们与官方项目无关。代理客户端掌握你的全部网络流量,只从官方 GitHub 下载,并留意仓库地址是否为 github.com/2dust/v2rayN。
第二步:解压与首次运行
Windows 版通常是压缩包,不需要安装:
- 把压缩包解压到一个普通目录,例如
D:\Apps\v2rayN。避免放在C:\Program Files等需要管理员权限才能写入的目录,否则配置可能无法保存。 - 运行目录中的 v2rayN 主程序。
- 如果出现 SmartScreen 蓝色提示,确认文件来自官方 Releases 后,点击「更多信息」→「仍要运行」。
- 杀毒软件误报时,可以把 v2rayN 目录加入白名单,但前提是确定安装包来自官方。
macOS 版首次打开如遇 Gatekeeper 拦截,在「系统设置 → 隐私与安全性」中选择仍要打开。
第三步:添加并更新订阅
v2rayN 读取的是通用格式(Base64 编码的节点链接列表)订阅,机场通常标注为 V2Ray 或通用订阅。如果你不清楚自己拿到的是哪种链接,可以先看 订阅链接是什么。
- 打开顶部菜单中的「订阅分组」,进入订阅分组设置。
- 点击添加,填写备注(如机场名称)和订阅地址 URL,保存。
- 回到「订阅分组」菜单,执行更新订阅。如果订阅地址需要代理才能访问,选择通过代理更新的选项。
- 节点列表加载后,确认数量与机场后台大致一致。
菜单名称可能随版本略有不同,以实际界面为准。
第四步:测试并选择节点
在节点列表中全选节点,执行延迟测试。v2rayN 通常提供 Ping 类测试和“真连接延迟”测试,后者会真正通过节点发起请求,更能反映可用性。选中一个结果正常的节点,设为活动服务器(双击或回车)。
- 测试结果为超时或 -1 的节点不要选;
- 全部超时时,优先检查本地网络、系统时间和订阅是否过期;
- 用于 Claude、ChatGPT 的节点,选择它们支持的地区并固定使用。
第五步:系统代理与路由
窗口底部状态栏有两个关键设置:
| 设置 | 常见选项 | 建议 |
|---|---|---|
| 系统代理 | 清除系统代理 / 自动配置系统代理 / 不改变系统代理 | 日常选「自动配置系统代理」 |
| 路由 | 绕过大陆 / 全局等预设 | 日常选绕过大陆类规则,国内直连 |
“自动配置系统代理”会把 Windows 的代理设置指向 v2rayN 的本地 HTTP 端口;退出 v2rayN 时一般会自动清除。如果异常退出导致没网,进入系统的代理设置手动关闭即可。
第六步:TUN 模式与终端工具
系统代理只对浏览器和遵循系统设置的应用生效,Claude Code、Codex CLI、git、npm 等命令行工具通常会忽略它。两种解决方式:
- 开启 TUN 模式:以管理员身份运行 v2rayN,在主界面开启 TUN,所有程序的流量都会被接管。
- 设置环境变量:在 v2rayN 设置中查看本地 HTTP 端口,然后在终端中执行,例如在 PowerShell 中:
$env:HTTPS_PROXY = "http://127.0.0.1:你的HTTP端口"
$env:HTTP_PROXY = "http://127.0.0.1:你的HTTP端口"
更完整的命令可以参考 终端代理设置。
说明
部分协议(如 Hysteria2、TUIC)需要特定内核支持。如果某类节点无法连接,可以在节点编辑界面或设置中切换到支持该协议的内核再试。
第七步:更新与维护
- 更新 v2rayN 本身:可以在程序的检查更新功能中更新,也可以到官方 Releases 下载新版本。手动更新前先备份程序目录中的配置文件夹,避免订阅和设置丢失。
- 更新内核:v2rayN 的检查更新功能一般也能单独更新 Xray、sing-box 等内核;新协议无法连接时,先确认内核是否为较新版本。
- 定期更新订阅:在订阅分组设置中可以为每个订阅设置自动更新间隔,机场换节点后无需手动操作。
- 清理无效节点:测试后长期超时的节点可以移除,减少误选。
退出后没有网络怎么办
v2rayN 选择“自动配置系统代理”时,会把 Windows 的代理指向本地端口。如果程序异常退出、被杀毒软件拦截或电脑意外关机,系统代理可能残留,表现为所有网页都打不开。处理方法:
- 重新打开 v2rayN,把系统代理切到「清除系统代理」后再退出;
- 或者在 Windows「设置 → 网络和 Internet → 代理」中关闭手动代理设置;
- 如果开过 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)格式订阅。