v2rayN 使用教程（2026）：安装、Xray 内核、订阅导入、系统代理与常见问题

v2rayN 是 Windows 上资格最老的一类代理客户端：它本身只是一个图形外壳，真正干活的是内置的 Xray 内核。它的价值在于协议覆盖广、能直接粘贴 vmess://、vless://、ss:// 节点链接、每个节点的底层参数都能手动改。如果你的机场只给通用订阅或裸节点链接、不给 Clash 订阅，或者你需要手动调传输方式和 TLS 参数，v2rayN 比 Clash 系更顺手。

反过来，如果机场给的是标准 Clash 订阅、你只想「装上能用」，直接看 Clash Verge Rev 教程 会更快。两者可以共存，但不要同时开系统代理。

安装前需要准备什么？

v2rayN 的安装失败几乎全部集中在这三件事上，先做好再下载：

• .NET 桌面运行库：新版 v2rayN 基于 .NET 构建。如果你下载的是不含运行库的普通压缩包，而系统没有装对应版本的 .NET Desktop Runtime，双击后会毫无反应、也不弹错误。要么装一次微软官方运行库，要么直接下文件名里带 SelfContained / desktop 的自包含版本（体积大但开箱即用）。
• 解压路径：解压到 D:\v2rayN 这类纯英文、无空格的目录。不要放在桌面、不要放进 C:\Program Files（权限问题会导致配置写不进去）。
• 杀毒软件白名单：Windows Defender 和国内安全软件经常把内核文件 xray.exe 判为风险程序并静默删除，导致「启动内核失败」。先把解压目录加入排除项，前提是你确实从 GitHub 官方仓库下载。

怎么下载安装？

1. 打开 GitHub Releases 页面，找到最新版本的资源列表。
2. 选择 Windows 64 位的压缩包。常见的几种命名含义如下：

3. 解压到准备好的目录，双击 v2rayN.exe 启动。首次启动会在目录下生成 guiConfigs、bin 等文件夹。
4. 启动后右下角托盘会出现 V 字图标。如果提示「未找到内核」，进入「设置 → 检查更新 → 更新 Xray 内核」下载一次。

三个内核到底选哪个？

v2rayN 支持在 Xray、sing-box、mihomo 之间切换内核。理解它们的分工能省掉很多无效折腾：

• Xray（默认）：对 VMess、VLESS、Reality、XTLS、Trojan 支持最完整，绝大多数情况用它。
• sing-box：对 Hysteria2、TUIC 这类基于 QUIC 的协议支持更成熟。机场节点是这两种协议且 Xray 连不上时，切它试试。想深入用 sing-box 本身，看 sing-box 教程。
• mihomo：用来直接运行 Clash 格式的配置文件，相当于在 v2rayN 里套一层 Clash。

各协议的差别和适用场景，在 代理协议科普 里有系统说明。日常不需要来回切内核，只在日志明确提示某协议不支持时再换。

怎么导入机场订阅？

v2rayN 的订阅入口在主界面顶部菜单「订阅」里。

1. 登录机场用户中心，复制标注为 V2Ray / 通用 / base64 的订阅链接（不是 Clash 订阅）。
2. 主界面点击「订阅 → 订阅分组设置」。
3. 点「添加」，填写：
   • 备注：机场名字，方便区分。
   • 地址（url）：粘贴订阅链接。
   • 自动更新间隔（分钟）：填 1440 表示每天更新一次。
   • 其余选项保持默认。
4. 保存后回到主界面，点击「订阅 → 更新订阅（不经过代理）」。
5. 几秒后服务器列表会被填满，每条记录显示备注、地址、端口和协议类型。

订阅这个概念本身以及不同格式的差异，见 机场订阅导入通用教程。

单条节点链接怎么导入？

机场群公告或朋友分享的往往是单条链接，v2rayN 支持三种快捷方式：

• 从剪贴板导入：复制 vmess:// 开头的链接后，按 Ctrl+V（或菜单「服务器 → 从剪贴板导入批量 URL」），支持一次粘贴多条。
• 扫描屏幕二维码：按 Ctrl+S，把二维码显示在屏幕上即可识别。
• 手动添加：菜单「服务器 → 添加 VMess/VLESS/Trojan 服务器」，逐项填写地址、端口、UUID、传输方式等。这是排查节点参数问题时最有用的入口。

怎么选节点、怎么测速？

服务器列表就是节点列表，操作都在右键菜单和快捷键里：

推荐做法：全选（Ctrl+A）后按 Ctrl+T 测真连接延迟，等表格填满后点「真连接延迟」列排序，从最低的几个里挑一个双击设为活动服务器。

选哪个地区取决于用途：日常浏览优先香港、日本、新加坡；AI 工具和美区流媒体优先美国；游戏和会议优先专线节点。详细判断方法见 机场节点怎么选。

系统代理怎么设置？

主界面底部（或托盘右键菜单）有系统代理的四个选项：

• 清除系统代理：不改动 Windows 代理设置，适合你用 SwitchyOmega 之类的浏览器插件自己管。
• 自动配置系统代理：日常用这个。它会把 Windows 的代理设置指向 v2rayN 的本地 HTTP 端口，浏览器和大部分软件会自动走代理。
• 不改变系统代理：v2rayN 只在本地监听端口，谁连谁走，不碰系统设置。
• PAC 模式：按 PAC 脚本里的域名列表决定是否走代理，现在已经不推荐，规则更新滞后。

默认本地端口是 SOCKS 10808、HTTP 10809。如果你要让其他软件（比如 Git、Docker、爬虫脚本）手动填代理，填 127.0.0.1:10809 即可。

路由分流规则怎么配？

v2rayN 的分流叫「路由设置」，在主界面顶部菜单「设置 → 路由设置」里，预置了几套模式：

选「绕过大陆地址」后，v2rayN 会依赖 geosite.dat 和 geoip.dat 两个规则数据文件判断域名归属。这两个文件需要定期更新，在「设置 → 检查更新 → 更新 geo 文件」里点一次即可；长期不更新会导致部分新域名分流错误。

自定义规则怎么写？

在「路由设置 → 添加规则集」里可以新增条目，常用写法：

• geosite:cn / geoip:cn：国内域名与 IP 集合，一般指向 direct。
• domain:openai.com：匹配该域名及其子域，指向 proxy。
• ext:geosite.dat:gfw：引用数据文件里的特定分类。
• 192.168.0.0/16：内网网段，指向 direct，避免访问不了路由器和 NAS。

规则按从上到下匹配，先命中先生效，所以更具体的规则要放在更靠前的位置。

Tun 模式什么时候需要？

系统代理只能覆盖「愿意读系统代理设置」的软件。游戏客户端、很多命令行工具、部分桌面应用会直接走网卡，这时就需要 Tun 模式。

开启方法：托盘右键或主界面勾选「Tun 模式」。注意几点：

1. 需要管理员权限运行 v2rayN，首次开启会安装虚拟网卡驱动，可能弹 UAC 授权。
2. 开启 Tun 后建议关闭系统代理，两者同时开容易造成流量绕圈。
3. 与其他 VPN 软件、虚拟机网卡（VMware、VirtualBox、WSL）可能冲突，出现全网断开时先关掉它们试。
4. 关闭 v2rayN 前记得先关 Tun，异常退出可能残留虚拟网卡导致断网。

原理层面 Tun 模式和 Clash 的 TUN 是同一类东西，排查思路也通用，可以参考 代理开了却上不了网。

常见报错与排查

日志在哪里看？

主界面下方有实时日志区，出问题时把「设置 → 参数设置 → 日志等级」调成 debug，重现一次问题再看输出。几条常见日志的含义：

• failed to parse — 节点参数有误或订阅内容损坏，重新更新订阅。
• context deadline exceeded — 连接超时，节点不可用或本地网络阻断。
• address already in use — 端口冲突，改端口。
• tls: handshake failure — TLS 参数（SNI、指纹、allowInsecure）配置不匹配，手动编辑节点校对。

v2rayN 适合谁？

• 机场只给通用订阅或裸节点链接 → v2rayN。
• 想要策略组、分应用分流、图形化规则 → Clash Verge Rev。
• 要在多个系统上保持同一套配置 → sing-box。
• 手机端搭配 → iPhone 用 Shadowrocket，安卓用 Clash Meta for Android。

完整的横向选择建议见 机场客户端怎么选。