v2rayN 使用教程（2026）：安装、导入订阅、切换内核与常见问题

先说结论

v2rayN 是一个桌面端的多内核代理客户端：同一个界面里可以用 Xray、sing-box 或 mihomo 运行节点。它最适合的场景，是机场给的订阅内容是 vmess://、vless://、trojan:// 这类分享链接（常被叫作“通用订阅”或“V2Ray 订阅”）。2026-10-15 核对时，最新正式版是 7.25.6（2026-10-11 发布），更新说明对应的 Xray-core 版本是 v26.10.10，支持的 sing-box 版本锁定在 1.14。

按文首的六个步骤就能用起来，下面逐步说明每一步的细节和容易出错的地方。文中的菜单名称取自 v2rayN 7.25.6 的简体中文界面资源文件；Windows 经典界面和 macOS、Linux 的布局不同，但菜单文字一致。还不清楚 v2rayN 和 Clash 系客户端分别适合哪种订阅的话，可以先看 机场客户端是什么。

2026 年的 v2rayN 和旧教程有什么不同

v2rayN 更新很快，往往一两周就有新版本。网上不少教程停留在 6.x 或早期 7.x，照着做最容易在“下载哪个文件”这一步出错。几个关键变化：

所以，旧教程里关于选哪个压缩包、装不装运行库、去哪下内核的内容，基本都可以跳过。

下载与系统匹配的发布包

只从 v2rayN 的 GitHub Releases 页面 下载。7.25.6 的发布页一共列出 43 个文件（含源码包），其中将近一半是 .sig 签名文件，按系统挑一个即可：

关于系统要求，有几点要注意：

• Windows：官方发布文件说明写的是 Windows 10 及以上。ARM64 包虽然提供，但官方 FAQ 说 Windows 对 arm64 的支持一直不好，“并不能保证一定能用”。另有 windows-86 开头的 32 位包，官方 FAQ 说明从开发到测试都没有在 32 位系统上验证过，一般用不到。
• macOS：发布文件说明在 2026 年 9 月改为 macOS 13.6 及以上，7.23.3 的更新说明写的是 13.7 及以上，两处略有出入，系统停在 macOS 13 早期版本的建议先升级。
• Linux：发布文件说明仍写着 Debian 12+、Ubuntu 22.04+、Fedora 36+、RHEL 9+，但 7.23.3 的更新说明已把最低要求提到 Debian 13、Ubuntu 26.04、Fedora 43、RHEL 10，官方构建也是在 Debian 13 和 RHEL 10 环境里打包的。较旧的发行版以最新 Release 说明为准。

WPF 还是 Avalonia？ 两个版本共用同一套业务代码，区别在界面实现：WPF 版是 v2rayN 一直沿用的 Windows 界面；带 desktop 的 Avalonia 版和 macOS、Linux 版是同一套跨平台界面。只在 Windows 上用，选 WPF 版即可；电脑和 Mac 都在用、想要一致的操作习惯，可以选 desktop 版。

下载后先校验

GitHub 会在 Release 页每个文件旁显示 sha256: 开头的校验值，下载后在本机计算一遍、逐位比对即可，Windows 上的具体做法可以参考 Windows 客户端教程里的校验步骤。v2rayN 还给每个文件提供了 GPG 签名和公钥文件 v2rayN-public-key.asc，README 公布了公钥指纹，熟悉 GPG 的用户可以多做一步：

gpg --import v2rayN-public-key.asc
gpg --verify v2rayN-windows-64.zip.sig v2rayN-windows-64.zip

解压并运行

Windows：把 zip 解压到一个独立文件夹（例如 D:\Apps\v2rayN），双击 v2rayN.exe。官方 FAQ 建议路径只用英文、不带空格，也不要放进 C 盘这类有权限限制的目录。zip 包是便携版，配置保存在程序目录下的 guiConfigs 文件夹里，内置的“备份和还原”功能备份的也是这个文件夹；需要两套互不干扰的配置时，复制一份整个文件夹即可；两份要同时运行的话，记得修改其中一份的本地监听端口。

如果首次运行时出现 SmartScreen 提示，先确认文件来自官方 Release、校验值一致，再选择“仍要运行”。

macOS：打开 dmg，把 v2rayN 拖进“应用程序”。官方说明这个安装包没有签名，首次打开会提示“应用已损坏”，需要在终端执行下面的命令去掉隔离标记。这一步只应对官方下载、校验过的文件做：

xattr -cr /Applications/v2rayN.app

Linux：deb 和 rpm 是安装版，zip 是便携版：

sudo apt install -y ./v2rayN-linux-64.deb        # Debian / Ubuntu
sudo dnf install -y ./v2rayN-linux-rhel-64.rpm   # Fedora / RHEL
chmod +x v2rayN && ./v2rayN                      # zip 便携版，普通用户运行

添加订阅分组并更新

v2rayN 把订阅叫作“订阅分组”。在“订阅分组设置”窗口里点“添加”后，需要关心的字段只有几个：

保存后回到主界面，点“订阅分组 → 更新全部订阅 (不通过代理)”。信息栏出现“更新订阅结束”、主界面多出以别名命名的分组标签，就说明导入成功了。

什么时候选“通过代理”更新？ 第一次更新时还没有可用节点，只能选“不通过代理”。以后如果机场的订阅域名在你的网络下打不开，可以先连上一个节点，再用“更新全部订阅 (通过代理)”。另外，v2rayN 会提醒不要使用 http:// 开头的订阅地址，遇到这种链接，先问机场有没有 https:// 的版本。

除了订阅，单个节点也可以直接导入：复制分享链接后在主界面按 Ctrl+V（菜单名“从剪贴板导入分享链接”），或者用“扫描屏幕上的二维码”“扫描图片中的二维码”。剪贴板里如果是 https 开头的地址，v2rayN 会把它当成新订阅处理。

测试延迟，挑出能用的节点

订阅更新后，节点列表可能有几十上百个，先测一遍再选。v2rayN 的几种测试含义不同：

推荐做法：在节点列表里右键“全选”，再右键“测试真连接延迟 (多选)”；测完点击“延迟 (ms)”列标题排序，选一个结果稳定的节点，右键“设为活动”（也可以在设置里打开“主界面双击设为活动”）。

Tcping 正常、真连接却失败，通常说明服务器在线但协议或配置有问题。延迟低也不代表速度快，原因见 延迟低为什么速度还是慢。

设置系统代理与路由规则

主界面底部有“系统代理”和“路由”两个选择框，它们决定哪些程序的流量会交给 v2rayN，以及交过来的流量是直连还是走节点。

系统代理有四个选项：

路由默认内置三套规则集：

三套规则都包含一条“阻断 udp443”，作用是让浏览器放弃 QUIC、改用 TCP 连接，通常更稳定，不需要删掉。

想让某个网站或某个程序单独直连，可以在“设置 → 路由设置”里编辑当前规则集，新增一条规则，填写 Domain、IP 或进程名（每条规则只填一项），出站选 direct。规则从上到下匹配，命中即停止，所以新规则要移到靠前的位置。

什么时候开启 Tun

系统代理只对遵循系统代理设置的程序有效，例如浏览器。终端工具、部分游戏和桌面应用不读系统代理，这时需要打开主界面的“启用 Tun”：内核会创建一块虚拟网卡，接管所有程序的流量。Windows 上需要管理员权限（可以用“以管理员身份重启”）；Linux 和 macOS 需要在设置里填写系统的 sudo 密码，v2rayN 说明这个密码不会被保存，每次重启后都要重新输入。两种方式的取舍见 TUN 模式和系统代理有什么区别。

切换内核：Xray、sing-box、mihomo 各管什么

v2rayN 自己不处理代理流量，真正干活的是内核。7.25.6 源码中，各内核负责的节点类型如下：

切换方式有三种：

1. 按协议整体切换：“设置 → 参数设置 → Core 类型设置”，为 VMess、VLESS、Shadowsocks 等每种协议选择 Xray 或 sing_box，保存后点“重启服务”。
2. 给单个节点指定：编辑节点时把“Core 类型”改成想用的内核。启动时 v2rayN 先看节点自己的 Core 类型，留空才使用上面的全局设置。
3. mihomo 自动接管 Clash 配置：订阅或“添加自定义配置”导入的是 Clash YAML 时，v2rayN 会把整份配置保存为一个自定义配置，Core 类型固定为 mihomo，配置里的代理组和分流规则由 mihomo 自己执行。

怎么选？没有问题就保持默认的 Xray；订阅里有 TUIC、AnyTLS 节点时，这类节点只能由 sing-box 运行；某个节点在 Xray 下反复失败，可以单独改成 sing-box 对比一次。机场只提供 Clash 订阅的话，与其在 v2rayN 里绕一圈，不如直接用 Clash 系客户端，两者的取舍见 Clash 和 v2rayN 有什么区别。各协议本身的差别，可以看 代理协议有哪些。

常见报错与处理

运行 Core 失败，请查看提示信息

官方 FAQ 的说法是：多数是配置错误、当前内核不支持这个节点，或者本地监听端口被其他程序（例如虚拟机）占用。先把“日志等级”调成 Debug，再看信息栏的具体报错；端口冲突时，在“参数设置”里修改“本地混合监听端口”（默认 10808）。

无效的订阅内容 / 导入订阅内容失败

说明 v2rayN 拿到了数据，但认不出格式。常见原因：订阅已过期或被重置，返回的是网页而不是节点列表；机场默认返回的格式 v2rayN 不认识。先把订阅链接放进浏览器看看返回了什么，再到机场面板找“通用订阅”或“v2rayN”对应的入口。只是网络打不开订阅地址的，换用“通过代理”更新。

在文件夹下未找到 Core 文件

内核文件不在 bin 文件夹里，常见于解压不完整或被安全软件删除。重新从官方 Release 下载并完整解压；需要包外的其他内核时，按提示从对应项目的官方 GitHub Releases 下载后放进 bin 文件夹。

提示 allowInsecure 已被移除

报错类似 The feature "allowInsecure" has been removed and migrated to "pinnedPeerCertSha256"。Xray-core 从 v26.2.6（2026 年 2 月）开始移除“跳过证书验证”，2026 年 6 月 1 日起，开启它又没有固定证书的配置无法加载，8 月 1 日起彻底禁用。

• 节点证书本身有效：编辑节点，关掉“跳过证书验证 (allowInsecure)”即可；
• 订阅里的节点：链接里带着 insecure=1 或 allowInsecure=true，需要机场在服务端修复，用户侧改了也会在下次更新订阅时被覆盖；
• 跳过证书验证意味着连接可能被中间人查看，不要为了“先能用”去找绕过办法。

退出 v2rayN 后电脑上不了网

v2rayN 正常退出时会清理系统代理，但程序崩溃或直接关机时不一定来得及，系统代理仍指向本机的 10808 端口。重新打开 v2rayN 选“清除系统代理”，或在 Windows“设置 → 网络和 Internet → 代理”里关闭手动代理即可。

总结

2026 年用 v2rayN，先按系统下对发布包（Windows 普通电脑选 windows-64.zip），运行库和三个内核都已经在包里。导入订阅后先测真连接延迟再选节点，日常用“自动配置系统代理 + 绕过大陆”就够了。遇到连接失败，先分清是订阅、内核还是节点证书的问题，再对症处理；iPhone 上的对应工具见 Shadowrocket 使用教程。