v2rayN 使用教程：Windows 下载、订阅导入与配置

v2rayN 的完整使用流程只有 5 步：到 GitHub 官方仓库 2dust/v2rayN 的 Releases 页面下载 Windows 压缩包并解压到非系统盘的英文路径；运行 v2rayN.exe；在「订阅分组」里粘贴机场给你的订阅链接并「更新订阅」；对节点做「真连接延迟」测试，选一个延迟正常的节点设为活动服务器；把系统代理设为「自动配置系统代理」、路由设为「绕过大陆」，打开浏览器访问境外站点验证。下面按这个顺序逐步展开，并在后半部分集中解决「v2rayN 无法上网」这一最常见问题。

学习目标：v2rayN 是什么，学完能做到什么

v2rayN 是由 2dust 维护的开源图形客户端（GPL-3.0），官方描述为支持 Windows、Linux、macOS，兼容 Xray、sing-box 等核心的 GUI 客户端。理解它的关键是一句话：v2rayN 是「壳」，不是「核心」。它负责界面、订阅管理、节点列表、系统代理和路由设置；真正处理加密流量的是 Xray-core、sing-box、mihomo 这些独立程序，v2rayN 只是把你的选择翻译成核心能读的配置并启动它。这解释了后面很多现象：为什么会出现「核心启动失败」、为什么同一个节点换核心后表现不同、为什么更新 v2rayN 和更新核心是两件事。

典型使用者有三类：需要在 Windows 上稳定访问 GitHub、NPM、Docker Hub 的开发者；要查 Google Scholar 与期刊库的学生；工作依赖 ChatGPT、Claude 等 AI 工具的职场用户。他们选 v2rayN 的共同理由是轻量、便携（解压即用）、协议支持随核心更新而更新、对机场提供的通用订阅链接兼容性好。

学完本文你应该能独立完成：

1. 从官方渠道下载、识别发布包类型并解压运行；
2. 添加并更新订阅，理解「订阅分组」与「节点列表」的关系；
3. 用真连接延迟与速度测试筛选可用节点；
4. 正确设置系统代理与路由模式，知道什么时候才需要 TUN；
5. 看懂日志，按症状定位「无法上网」的原因。

注意：本站是独立知识平台，不提供任何节点、订阅链接或账号；文中的「订阅链接」一律指你从自己购买的机场服务或自建服务器获得的链接。使用代理工具请遵守所在地法律法规。

建议：如果你主要在手机上用，v2rayN 不是第一选择，iOS 用户请看 Shadowrocket 使用教程；如果你想要「导入就能用、策略组自动切换」，请看 Clash 使用教程。在 Windows 上只想简单、稳定地用好一条订阅，v2rayN 足够。各客户端的总览见 客户端栏目。

准备工作：订阅链接、Windows 版本与 .NET 运行时

开始前要准备三样东西。第一是订阅链接，一个以 https 开头的长网址，由机场在用户中心提供，本质上是一份会自动更新的节点清单；如果你还分不清订阅、节点、客户端三者的关系，先读 机场是什么。第二是操作系统版本：截至 2026 年 8 月，官方 Wiki「发布文件介绍」注明 Windows 最低要求为 Windows 10 及以上，Windows 7 已不被常规版本支持。第三是运行时：v2rayN 基于 .NET 开发，官方 FAQ 提到「v2rayN 依赖 .NET 8」；具体需要哪个大版本、发布包是否已自带运行时，以 Releases 页面与 Wiki 当时的说明为准，不要照搬旧教程里的版本号。

很多「双击没反应」「一闪就退」的求助，源头不是软件坏了，而是在不满足系统要求的旧电脑上运行，或者缺运行时。开工前花一分钟核对，比事后排查省得多。

1. 登录机场用户中心，找到「订阅链接」或「通用订阅 / V2Ray 订阅」并复制（不要复制 Clash 专用的 YAML 订阅，格式不同，v2rayN 解析不了）；
2. 在 Windows「设置 → 系统 → 关于」里确认是 Windows 10 或 11，并记下是 64 位还是 ARM64（绝大多数是 64 位）；
3. 如果启动时弹出缺少 .NET 运行时的提示，按提示或到 Microsoft 官网下载对应版本的「.NET 桌面运行时」，安装后重新打开。

注意：订阅链接等同于账号凭证，谁拿到就能用你的流量。不要发到群里、不要截图分享，也不要粘贴到来历不明的「订阅转换」网站。

建议：如果机场同时提供「通用订阅」和「Clash 订阅」，v2rayN 用前者。订阅链接从用户中心即时复制，而不是翻半年前的聊天记录，机场更换域名后旧链接会失效，这是「订阅更新失败」最常见的原因之一。

第一步：从官方 GitHub 下载并解压 v2rayN

v2rayN 只有一个官方发布渠道：GitHub 仓库 2dust/v2rayN 的 Releases 页面。Windows 用户通常会看到两类压缩包：文件名为 v2rayN-windows-64.zip 的 WPF 传统界面版，以及带 -desktop 后缀的 Avalonia UI 界面版；另有 86（32 位）与 arm64 构建，每个文件都附带 .sig 签名与公钥供核验。历史版本曾把「带核心（With-Core）」与不带核心、「自带 .NET 运行时（SelfContained）」与需自行安装运行时的包分开发布；截至 2026 年 8 月，Wiki 说明「发布包中含部分 Core 文件（Xray、sing-box、mihomo）」，其他核心需自行下载，zip 为便携版、解压即可运行。具体以你打开 Releases 时的文件列表与说明为准。

搜索「v2rayN 下载」会看到大量第三方下载站、网盘、群文件「整合包」。开发者最容易被「已配置好节点、解压即用」吸引，但这正是恶意配置、植入订阅与捆绑程序最常见的投放方式。

1. 在浏览器地址栏确认域名是 github.com、仓库路径是 2dust/v2rayN（数字 2 加 dust，警惕相似拼写的仿冒仓库）；
2. 进入 Releases，下载 Latest 版本中对应你系统的 zip；
3. 右键压缩包「全部解压」到非系统盘的纯英文路径，例如 D:\Tools\v2rayN，不要放在 C:\Program Files、桌面或含中文、空格的目录；
4. 双击 v2rayN.exe 启动；首次运行若弹出 Windows 防火墙提示，允许即可。

注意：杀毒软件或 Windows Defender 可能把核心文件（xray.exe、sing-box.exe 等）误报并隔离，表现为「解压后少文件」「核心启动失败」。正确处理是在杀毒软件中把 v2rayN 文件夹加入信任或排除项，而不是关闭杀毒软件，且只有在确认文件来自官方仓库时才这样做，风险自担。

建议：压缩包留一份备份，升级时新版本解压覆盖即可，配置存于程序目录的 guiConfigs 文件夹。不要从网盘、QQ 群、Telegram 群文件下载任何「v2rayN 整合包」，它们带来的问题在 免费节点安全吗 里有完整分析。

第二步：添加订阅分组并更新节点列表

v2rayN 用「订阅分组」管理订阅来源，用「配置文件列表」展示解析出的每个服务器。一个订阅分组对应一条订阅链接，更新后生成一组节点；多个分组互不干扰，可以为主用机场、备用机场分别建组。官方 Wiki 说明订阅支持 VMess、Shadowsocks、SOCKS、VLESS、Trojan、Hysteria2、TUIC、WireGuard、AnyTLS 等协议的标准分享格式或 v2rayN 内部格式，一个分组还可填写多个地址，下载后顺序合并。

职场 AI 用户常见的做法是同时保留两家机场订阅，一主一备。在 v2rayN 里这就是两个订阅分组，主分组更新失败或节点全超时时切到备用分组，不必重新输入任何东西。

1. 顶部菜单「订阅分组 → 订阅分组设置」，点「添加」；
2. 「备注」填一个你认得的名字，「地址（URL）」粘贴订阅链接；按需勾选「通过代理更新」「自动更新」，其余保持默认，确定；
3. 回到主界面，菜单「订阅分组 → 更新订阅（不通过代理）」；若机场的订阅域名本身被干扰，先用任意可用节点，再改「更新订阅（通过代理）」；
4. 选中该分组，配置文件列表出现多条服务器即成功；列表可按列标题排序，也支持模糊过滤。

注意：更新后列表是空的，优先怀疑三件事：复制进去的是 Clash 专用订阅；链接已过期或被机场更换；链接末尾少了字符。三者都与 v2rayN 本身无关。

建议：在订阅设置里开启「自动更新」，间隔以小时计即可，机场会不定期调整节点，手动更新容易忘记。同时记住：订阅更新只刷新节点清单，不会帮你切换节点，当前活动节点如果被机场下线，你仍需手动换一个。

第三步：测试节点延迟与速度，选一个可用节点

v2rayN 提供几类测试。「真连接延迟」是让核心真的通过该节点访问一个测试网址并计时，反映「能不能用、响应快不快」；「Tcping / Ping」只测到服务器的连通性，不能说明代理可用；「速度测试」通过节点下载测试文件估算带宽，结果与时段、出口带宽、测试文件所在地都有关，深夜与晚高峰可能相差数倍。批量测试会分批进行，官方 UI 说明允许调整每批数量以提高成功率。

学生在宿舍晚高峰查文献时抱怨「全部超时」，第二天上午再测又全部正常，这是线路拥塞，不是配置错了。先测延迟再下判断，能避免大量无意义的重装。

1. 在配置文件列表全选（Ctrl+A），右键选择「真连接延迟」测试（全部）；
2. 等待「延迟」列出现数值，按该列排序，选延迟低且数值稳定的节点，右键「设为活动服务器」或直接回车；
3. 对候选的两三个节点做「速度测试」，结合用途选择：看视频优先速度，开发与 AI 对话优先延迟稳定；
4. 用列表上方的过滤框按地区关键词（如 HK、JP、US）缩小范围。

注意：结果显示 -1 或超时，既可能是节点不可用，也可能是你本机没走通，例如防火墙拦截了核心、或测试 URL 本身不可达。先确认至少有一个节点通过测试，再排查其他问题。

建议：不要把「最低延迟」当唯一标准。同一机场里，专线节点的延迟可能略高于某个中转节点，但稳定性更好；对需要长时间保持会话的 AI 工具与 SSH，稳定比峰值更重要。线路类型的含义见 机场是什么。

第四步：设置系统代理、路由模式与 TUN

选好节点后，流量怎么进入 v2rayN 由三个开关决定。第一是「系统代理」，官方 Wiki 列出四种模式：「清除系统代理」强制清掉操作系统代理；「自动配置系统代理」强制把系统代理指向核心监听的本地端口；「不改变系统代理」什么都不做，保留其他软件的设定；「PAC 模式」按脚本决定哪些流量走代理。第二是「路由」：「绕过大陆」把国内域名与 IP 直连、其余走代理，是官方建议的常规用法；「全局」所有流量走代理；「黑名单」只有规则列表内的目标走代理。预设名称在不同版本略有差异，以软件显示为准。第三是「TUN」：创建虚拟网卡接管所有应用的流量，包括不认系统代理的程序，需要管理员权限，依赖 sing-box 等核心的 TUN 实现。

开发者最常遇到的是「浏览器能开 GitHub，但 git clone 与 npm install 还是超时」。原因是命令行工具不读 Windows 系统代理。两个解法：在终端设置 HTTP_PROXY 与 HTTPS_PROXY 环境变量，或用 git config 把 http.proxy 指向 127.0.0.1 加本地端口；或直接开 TUN，让所有进程走虚拟网卡。

1. 主界面底部状态栏点击「系统代理」，选「自动配置系统代理」；
2. 「路由」选「绕过大陆」；
3. 只在上表所列场景下才勾选「启用 Tun」，软件会要求以管理员身份重新运行；
4. 需要时在「设置 → 参数设置」查看本地监听端口：历史默认是 10808（SOCKS）与 10809（HTTP），新版本的默认端口与数量以界面显示为准。

注意：官方 FAQ 指出，Windows 系统代理只支持 HTTP 代理，不支持 SOCKS5。因此「自动配置系统代理」实际写入的是 HTTP 端口；在别的软件里手动填代理时，SOCKS5 与 HTTP 端口不要填反。

建议：新手一律「自动配置系统代理 + 绕过大陆」，不开 TUN。TUN 很强，但它让网银控件、部分网游等所有流量都经过路由判断，规则库陈旧时会出现「国内网站变慢」，排查难度明显更高。

如何验证 v2rayN 已经成功连接

验证分两层。软件内部：主界面底部的信息面板显示核心已启动、监听端口正常、没有红色报错；在设置里勾选「启用日志存到文件」后，核心输出会写入程序目录的 guiLogs 文件夹，方便事后排查。软件外部：打开浏览器访问一个境外站点，并到任意 IP 查询网站查看当前出口 IP 与归属地，显示的是节点所在地而非你的本地运营商，代理链路就通了。

职场用户配置完立即打开 ChatGPT，看到「Something went wrong」就回头重装 v2rayN，其实此时代理往往已经通了，问题出在 AI 平台对该节点 IP 的策略或账号状态。先用通用站点验证代理本身，再按 ChatGPT 打不开怎么办 的原因树判断平台层问题，这是两件事。

1. 看状态栏：系统代理为「自动配置系统代理」、路由为「绕过大陆」、活动节点名称正确；
2. 看日志：出现核心版本与监听端口，没有 failed to start、address already in use 一类字样；
3. 浏览器无痕窗口打开一个平时打不开的境外站点；
4. 访问 IP 查询网站，确认出口 IP 归属地与节点一致；同时打开一个国内站点确认仍是直连、速度正常。

注意：主界面的上下行流量有数字只说明有流量经过核心，不等于目标网站可用；目标能否打开还受 DNS、路由规则与平台策略影响。

建议：把这 4 步固化成你的「连接检查清单」，每次出问题先按顺序过一遍，多数情况下两分钟内能分清是「节点问题」「本机设置问题」还是「目标平台问题」。

v2rayN 无法上网：常见错误与解决方法

「v2rayN 无法上网」不是一个错误，而是至少七种原因的总称。先按下表对症，再看逐项解释；更系统的排查（TLS/证书错误、路由规则与系统代理混淆、内核选择）见 v2rayN 无法上网怎么办。

表中「能 ping 通但打不开网页」在学生群体里最常见：校园网往往有自己的 DNS 与出口策略，v2rayN 的路由与 DNS 按默认走时，可能出现国内解析正常、境外域名解析被污染的情况。

1. 核心问题：打开「检查更新」，让 v2rayN 下载或更新 Xray-core、sing-box；如果更新本身需要代理，先借用能用的节点，或重新从官方 Releases 解压一份。同时到杀毒软件隔离区检查有没有核心文件被误删；
2. 端口冲突：在参数设置里把本地端口改成一个不常用的值，保存后重启；官方 FAQ 提到 Hyper-V 等组件会保留端口段，换端口比找占用者更快；
3. 订阅失败：回用户中心重新复制链接并比对；确认是通用订阅；User-Agent 留空或按机场要求填写；
4. 全部超时：换一个分组、换一个时段再测；在 Windows 安全中心确认 v2rayN 与核心进程被允许通过防火墙；
5. 路由与 DNS：把路由临时改为「全局」，若立即能打开，说明问题在分流规则，在「检查更新」里更新 geo 规则文件或改回「绕过大陆」预设；若仍打不开，在参数设置里把核心的远程 DNS 改为可信的境外 DoH 地址；
6. 浏览器：在「Windows 设置 → 网络和 Internet → 代理」里看「使用代理服务器」是否被正确写入；关闭 SwitchyOmega 一类扩展或把它设为「系统代理」模式；Firefox 需选「使用系统代理设置」；
7. 开机自启：参数设置勾选「开机自动启动」；使用 TUN 的用户还需按软件提示以管理员权限自启，否则每次开机后 TUN 不会生效。

注意：官方 FAQ 特别指出「运行 core 失败，一般是在延迟测试和测速中出现」，常见原因是配置错误、核心版本不支持以及端口被占用。批量测速会创建大量临时端口，冲突概率最高，换端口通常就能解决。

建议：排查顺序永远是「先本机、再节点、再目标平台」。同一条订阅在 v2rayN 打不开而在别的客户端能开，多半是路由或 DNS 差异，而不是 v2rayN「不行」，不要一上来就重装或换软件。

高级技巧：多核心切换、自定义路由与配置备份

v2rayN 的可扩展性来自壳核分离。在「设置 → 参数设置」的核心类型设置里可以为不同协议指定核心（例如 VLESS 走 Xray-core、Hysteria2 走 sing-box），在「检查更新」里单独升级某个核心；Wiki「支持的核心列表」还包括 v2fly、mihomo、hysteria2、naiveproxy、tuic、juicity、brook、overtls、shadowquic 等，多数需要自行下载放入 bin 目录。路由方面可以在「路由设置」里新建规则集，按域名、IP、端口、进程写规则，Wiki 有「自定义路由规则说明」。新版本的设置中提供「备份与还原」，可把配置导出到本地或 WebDAV。

开发者团队常见组合是台式机用 v2rayN（便携、协议跟着 Xray 走），笔记本用 Clash Verge Rev（策略组自动切换），两者可以用同一家机场的不同订阅格式。详细对比见 Clash 使用教程。

1. 多核心：在核心类型设置里按协议指定核心，改完在日志里确认启动的核心名与版本；
2. 自定义路由：复制一份「绕过大陆」预设再修改，不要直接改动预设本身；规则自上而下匹配，更具体的域名规则放前面；
3. 备份：升级前在「备份与还原」导出一次，或直接复制 guiConfigs 文件夹；迁移到新电脑只需解压新版并覆盖该文件夹。

注意：自定义路由写错会让国内站点整体变慢或境外站点部分打不开，症状很像「节点问题」。任何改动前先备份，出问题时先切回预设对比。

建议：绝大多数用户不需要碰核心类型与自定义规则，只有当机场使用较新的协议、或你有「某域名必须直连 / 必须走特定节点」的明确需求时再动。如果你还没有一条可用的订阅，按 机场指南 的选择标准挑一家再回来配置会更顺；本站与部分机场存在推广合作，关系见 披露页，这不影响本文的操作建议。