v2rayN 配置教程：导入订阅没节点、开代理仍无法联网怎么办
简答：装好 v2rayN 后没有节点属于正常情况，先选择匹配系统的安装包，再导入订阅或单节点，更新配置、选中活动配置并启动核心，最后开启系统代理验证；若仍不通，按订阅、核心、路由和日志顺序排查。
定义：v2rayN 是用于读取节点配置、调用网络核心并提供本地代理入口的桌面客户端，本身不提供节点或订阅。
先试这一步：按顺序完成 v2rayN 基础配置
如果你遇到“程序装好了但列表为空”或“系统代理已打开却打不开网页”，先不要修改 DNS、MTU 或高级路由。按照“下载—导入—选节点—启动核心—开启代理—验证”的顺序操作，通常更容易判断问题出在哪一步。
| 步骤 | 操作 | 完成标准 |
|---|---|---|
| 1 | 下载匹配系统和 CPU 架构的安装包 | 程序能够启动，Windows 任务栏通知区域出现图标 |
| 2 | 导入订阅 URL、单节点链接或二维码 | 配置文件列表中出现节点 |
| 3 | 更新订阅并选中活动配置文件 | 节点名称、地址、端口和协议能够显示 |
| 4 | 启动核心 | 主界面信息栏没有核心启动错误 |
| 5 | 开启自动配置系统代理 | 浏览器等支持系统代理的软件开始使用本地入口 |
| 6 | 查看日志并进行实际连接验证 | 日志出现请求和策略命中，或出口 IP 与开启前不同 |
| 症状 | 优先检查 | 下一步 |
|---|---|---|
| 导入后没有节点 | 订阅地址、更新结果、返回内容 | 重新检查订阅 URL，查看界面日志 |
| 更新订阅失败 | 是否需要通过代理、请求头或订阅响应 | 使用“通过代理更新订阅”，再对比剪贴板导入 |
| 提示内核缺失 | 核心文件和系统架构 | 检查 bin 文件夹，按官方核心列表补齐文件 |
| 系统代理已开但网页不通 | 活动配置、核心状态、路由模式 | 临时切换到全局模式并查看连接日志 |
| TUN 开启后断网 | 权限、虚拟网卡和其他 VPN 冲突 | 关闭 TUN 恢复网络，再逐项检查 |
截至 2026-10-24，Releases 标记为 Latest 的是 7.25.6。下载前应打开官方 7.25.6 标签页确认资产；本文的安装包名称使用 <版本号> 占位，避免照抄旧文件名。
v2rayN、订阅链接和单节点链接有什么区别
v2rayN 负责读取配置、启动网络核心和提供本地代理入口，但不会自动生成节点。你需要准备合法可用的订阅 URL、单节点分享链接或二维码。
- 订阅链接：通常是一个 URL，客户端访问后返回多个节点，适合批量导入和后续更新。
- 单节点链接：只描述一个节点，常见形式包括
vmess://、vless://、trojan://和ss://。 - 二维码：把单节点信息编码成图片，适合扫描导入，不等同于订阅。
- 内部分享链接：可携带部分客户端配置字段，主要用于配置分享或迁移。
官方订阅说明列出 VMess、Shadowsocks、SOCKS、VLESS、Trojan、Hy2、TUIC、WireGuard 和 Anytls 等格式。实际能否运行，还取决于当前核心、协议字段和订阅内容。可参考v2rayN 官方订阅功能说明。
本站是第三方使用指南站，只介绍客户端配置和网络排查方法，不代表任何节点或订阅服务的官方入口。
下载安装：Windows、Linux 和 macOS 怎么选包
建议从v2rayN 官方项目主页进入 Releases，不要从搜索结果中的不明镜像下载。官方发布文件说明显示，zip 是便携版，解压后可直接运行，配置通常保存在程序目录；Windows 支持 Windows 10 及以上，Linux 和 macOS 还需要匹配发行版或系统版本。
| 系统 | 常见安装包选择 | 操作要点 |
|---|---|---|
| Windows x64 | v2rayN-windows-64.zip 或 v2rayN-windows-64-desktop.zip | 普通 Intel 或 AMD 64 位电脑使用；两个包的界面实现不同 |
| Windows ARM64 | v2rayN-windows-arm64.zip 或 v2rayN-windows-arm64-desktop.zip | 确认系统确实是 ARM64；兼容性以官方说明为准 |
| Linux x64/ARM64 | <版本号> 的 zip、deb 或 rpm | Debian/Ubuntu 使用 deb，Fedora/Red Hat 使用 rpm，zip 需要手动赋予执行权限 |
| macOS Intel/Apple Silicon | <版本号> 的 macOS 64 位或 arm64 包 | 按处理器架构选择；dmg 包若被系统拦截，按官方方式解除隔离 |
| Android | 不使用桌面版安装包 | 应选择对应移动端项目或应用，并以其官方发布渠道为准 |
| iOS | 不使用 v2rayN 桌面版 | 客户端选择应以对应项目和系统商店信息为准 |
- Windows 解压后双击程序启动；窗口关闭后程序可能仍在通知区域运行，右键托盘图标可重新打开主界面。
- Linux zip 包执行
chmod +x v2rayN，再用普通用户执行./v2rayN；deb 或 rpm 按发行版安装。 - macOS zip 包执行
chmod +x v2rayN后运行；dmg 包若出现“应用已损坏”，先到“隐私与安全性”中查看放行选项，官方说明还提供了xattr -cr /Applications/v2rayN.app的解除隔离方法。 - 下载后若要校验文件，校验对象应是实际下载的原始 zip、deb、rpm 或 dmg。Windows 可执行
Get-FileHash .\<版本号>.zip -Algorithm SHA256，macOS/Linux 可执行shasum -a 256 <版本号>.zip；只有当官方资产页面同时列出对应哈希时，才进行数值比对。
完整的系统、架构和文件名说明见官方发布文件介绍。
订阅导入：当前界面可照着这样操作
不同界面布局可能略有差异，但官方界面说明确认了订阅分组、从剪贴板导入和通过代理更新等功能。优先使用下面两种方式。
方式一：添加订阅分组
- 打开主界面的配置文件或订阅相关菜单，进入“订阅分组设置”或“新增订阅分组”。
- 填写分组名称和订阅 URL，保存后回到主界面。
- 在订阅分组或配置文件列表上执行“更新订阅”。如果订阅地址在当前网络中无法直接访问，选择“通过代理更新订阅”；如果可以直接访问，则选择不通过代理更新。
- 更新结束后展开分组，确认出现节点名称、协议、地址和端口。
官方界面说明显示，订阅更新支持“不通过代理或通过代理更新订阅”，并会在获取内容后进入解析流程。不要只看弹窗提示，更新后应查看主界面信息栏或 GUI 日志。
方式二：从剪贴板导入单节点或订阅
- 复制完整的订阅 URL、单节点分享链接或多节点文本。
- 回到 v2rayN 主界面，确保光标不在输入框内，按
Ctrl+V。 - 客户端会依次尝试识别 https 订阅、协议标准分享链接、WireGuard 配置以及其他支持格式。
- 导入成功后，在配置文件列表中选择节点，再执行“设为活动配置文件”或相近名称的操作。
官方说明明确写出，从剪贴板导入支持明文和 Base64 内容；如果无法解析，会提示检查分享链接。相关路径见官方界面功能说明。
选择节点、启动核心并验证连接
- 在配置文件列表中选中一个节点，使用右键菜单或顶部操作将它设为活动配置文件。
- 启动核心，观察主界面信息栏；如果提示核心启动失败，先不要开启 TUN。
- 先进行延迟测试，再进行真连接或速度测试。延迟低不等于业务访问一定快，最终应结合成功率、日志和实际业务使用判断。
- 打开系统代理的自动配置选项，再访问浏览器或其他明确支持系统代理的软件。
- 查看连接日志，确认出现请求、目标地址和命中的策略；也可以对比开启代理前后的出口 IP，但出口 IP 变化不能证明所有软件都经过代理。
v2rayN 支持多种核心。官方核心列表列出 Xray、v2fly、sing-box、mihomo 等项目，具体节点应优先按配置提供方对核心的要求选择。如果提示“内核缺失”，先检查程序目录中的 bin 文件夹，再按官方支持的核心列表获取对应核心。
系统代理、路由和 TUN：先用哪一个
| 功能 | 解决什么问题 | 适用场景 | 注意事项 |
|---|---|---|---|
| 系统代理 | 把读取系统代理的软件流量交给核心 | 浏览器和部分桌面软件 | 不支持系统代理的软件不会自动生效 |
| 路由模式 | 决定目标流量走直连还是代理 | 需要分流或全局验证 | 规则命中情况要看日志，不要只看模式名称 |
| TUN | 通过虚拟网络接口接管更多流量 | 命令行、游戏或不读取系统代理的软件 | 需要额外权限，可能与 VPN、虚拟机和过滤软件冲突 |
官方系统代理说明将“自动配置系统代理”和路由分开定义，并给出常规组合：系统代理选择“自动配置系统代理”，路由选择“绕过大陆”。实际使用时，应以当前配置和日志中的策略命中为准。不要在没有确认核心正常运行前启用 TUN。
Windows 的系统代理通常只配置 HTTP 代理；本地监听端口不要套用其他客户端教程中的固定数字，应到“设置→参数设置”查看当前 SOCKS、HTTP 或混合入口。macOS 自动配置系统代理依赖脚本，失败时查看 GUI 日志；Linux 则要检查虚拟网卡、专用用户和配置文件权限。官方说明可见系统代理和路由说明及官方常见问题。
订阅没有节点、更新失败和核心缺失怎么排查
导入订阅后列表为空
- 确认复制的是订阅 URL，而不是登录页面、分享页面或单节点链接。
- 进入订阅分组设置，重新检查地址是否完整，保存后执行更新订阅。
- 分别尝试“通过代理更新”和“不通过代理更新”，观察哪一种能获取内容。
- 如果更新提示成功但仍为空，检查返回内容是否为空、是否需要 User-Agent 或自定义请求头。
- 删除旧分组后新建测试分组，避免旧缓存或错误设置干扰。
更新失败，但剪贴板导入可以成功
这说明下载路径和解析路径可能不同。官方 Issue #10138 记录过一种可复现情况：订阅服务器返回 gzip 压缩内容时，更新出现“Failed to import subscription content”，同一内容通过 Ctrl+V 导入正常；该 Issue 已关闭，但页面没有给出明确修复版本，因此不要据此断言某个版本一定解决。处理顺序是先更新到官方 Releases 的当前版本，再检查订阅服务是否返回异常压缩内容、是否需要请求头或代理访问。来源见官方 Issue #10138。
提示内核缺失或核心启动失败
- 确认所选核心文件存在于程序目录的
bin文件夹。 - 确认核心架构与系统架构匹配，Windows ARM64 不要直接使用 x64 核心。
- 检查核心日志中的配置字段、权限、端口占用和文件执行错误。
- 如果节点使用较新的协议字段，先更新客户端或对应核心，再重新选择活动配置文件。
系统代理已打开但某个软件仍不能联网
先看 v2rayN 日志中是否出现该软件的请求。如果浏览器正常而某个软件没有日志，说明该软件可能不读取系统代理，或自身设置了直连；确认基础连接正常后，再考虑该软件的独立代理设置或 TUN。
TUN 开启后断网
立即关闭 TUN，恢复系统代理并确认基础节点仍可用。随后关闭其他 VPN、虚拟机网卡和网络过滤程序，检查管理员权限、虚拟网卡和核心日志，再单独重新启用 TUN。不要同时修改 DNS、MTU、路由和核心，否则难以判断故障来源。
备份、迁移和重装恢复
v2rayN 官方界面说明提供“备份和还原”功能，备份对象是整个 guiConfigs 文件夹；非 Windows 系统进行备份时，需要使用 zip 文件扩展名，还原成功后客户端会重启。
- 在客户端设置或界面功能菜单中找到“备份和还原”，先退出正在运行的核心，再创建备份。
- 把备份文件保存到受控位置，不要公开上传包含订阅 URL、UUID、密码或私钥的配置。
- 重装或迁移后，打开同一功能选择还原文件，等待程序重启。
- 若还原后节点为空，先检查客户端架构、核心文件和订阅分组，再查看 GUI 日志与主界面信息栏。
- 若使用 zip 便携版，也可以在退出程序后复制整个程序目录；安装版则优先使用客户端自带备份，避免遗漏用户配置目录。
配置文件和订阅地址可能包含敏感信息，备份前应确认保存位置和访问权限。
继续排查设备与连接问题
完成基础导入后，如果问题集中在系统权限、代理入口或连接失败，可以继续查看本站的设备配置指南；如果节点无法连接、速度变慢或频繁断开，可参考连接问题排查。更多客户端和网络设置可进入使用指南，常见疑问可查看常见问题。
常见问题
v2rayN 安装后没有节点，正常吗？
正常。v2rayN 本身不提供节点，安装后需要添加订阅 URL、单节点链接或二维码。若已经导入但列表为空，应检查订阅地址、更新方式、返回内容和界面日志。
v2rayN 订阅更新需要通过代理，在哪里设置？
进入订阅分组设置或订阅更新菜单，执行更新时选择“通过代理更新订阅”。如果仍失败，再尝试不通过代理更新，并查看主界面信息栏或 GUI 日志判断是下载失败还是解析失败。
v2rayN 应该先开系统代理还是 TUN？
先使用自动配置系统代理。它适合浏览器等会读取系统代理的软件，便于验证基础连接。只有目标软件不读取系统代理时，再考虑 TUN，并先处理管理员权限、虚拟网卡和其他 VPN 冲突。
为什么系统代理打开了，某个软件仍然不能联网？
系统代理不会自动影响所有软件。先查看 v2rayN 日志中是否出现该软件的请求；如果没有，检查软件自身的代理设置，或在基础节点正常后再评估 TUN。
订阅更新失败，但复制内容后 Ctrl+V 可以导入，怎么办？
先更新到官方 Releases 的当前版本，再检查订阅服务是否返回 gzip 等压缩内容、是否需要自定义 User-Agent 或通过代理访问。Ctrl+V 能导入通常说明解析路径仍可工作，问题可能位于订阅下载路径。
提示内核缺失，应该选择 Xray 还是 sing-box？
优先按照节点或订阅提供方的说明选择。v2rayN 官方支持多种核心，但不同核心对协议字段和配置格式的支持不同；先确认核心文件存在、架构匹配，再查看核心日志。