本文速览
本文适合首次在 Windows 安装 v2rayN，或已经启动程序但遇到节点不可用、系统代理不生效、托盘图标消失等问题的用户。按照顺序操作后，可以完成版本选择、运行环境准备、订阅导入、代理启用和基础排错。
安装前先选桌面版还是 WPF 版
v2rayN 的 Windows 构建可能同时提供 Desktop 与 WPF 两类界面。两者负责的都是配置管理、订阅更新、路由分流和内核控制，能使用的 VMess、VLESS、Trojan、Shadowsocks、REALITY 等协议主要取决于所选内核及其版本，而不是界面名称。
WPF 版使用 Windows Presentation Foundation，界面行为更贴近传统 Windows 桌面程序，适合只在 Windows 使用、希望托盘菜单和窗口操作保持经典形式的用户。Desktop 版采用新的桌面界面实现，设置结构与其他桌面环境更接近，适合希望使用新界面或需要统一操作习惯的用户。
| 比较项 | Desktop 版 | WPF 版 |
|---|---|---|
| 主要定位 | 新桌面界面，布局更统一 | Windows 原生桌面界面 |
| 适用系统 | 优先用于受支持的 64 位 Windows | 仅用于 Windows 桌面环境 |
| 协议能力 | 由 Xray、v2fly 等内核决定 | 由 Xray、v2fly 等内核决定 |
| 配置迁移 | 升级前备份 GUI 配置与订阅信息 | 升级前备份 GUI 配置与订阅信息 |
| 优先选择场景 | 新安装、希望使用新界面 | 习惯传统窗口与托盘操作 |
安装包名称中如果带有
SelfContained，通常表示已经包含对应的 .NET 运行组件，体积较大，但能减少运行时缺失造成的启动失败。不带该标记的包体积较小，需要系统预先安装与当前版本匹配的 .NET Runtime 或 .NET Desktop Runtime。具体依赖应以下载页和程序启动提示为准。7.x
本文对应的主版本界面
.NET 8
常见运行时基础版本
x64
多数电脑选择的架构
2 类
Desktop 与 WPF 界面
结论:不确定时先选自包含桌面包
64 位 Windows 新安装可先选择 x64 的 SelfContained Desktop 包；若更习惯传统 Windows 界面，再改用对应的 WPF 包。切换界面版本前保留原目录备份，不要直接覆盖正在运行的程序。
下载、解压与首次启动
v2rayN 通常以压缩包形式分发。下载完成后应先完整解压，再运行目录中的主程序。不要在压缩软件预览窗口里直接双击执行，因为内核、语言文件和配置目录没有被完整释放时，程序可能只出现短暂进程，随后直接退出。
建议将程序放在当前账户有完整读写权限的固定路径，例如
D:\Apps\v2rayN。路径应尽量简短，并避免放进需要管理员权限写入的系统目录。后续的内核更新、日志写入和配置保存都会访问这个目录。选择安装包
前往本站安装包页面，根据系统架构选择 Windows x64 的 Desktop 或 WPF 版本；运行时不确定时优先选择带 SelfContained 标记的包。完整解压
右键压缩包选择「全部解压缩」，目标路径可设为D:\Apps\v2rayN。确认主程序、内核目录和资源文件位于同一解压目录。解除文件锁定
若系统在压缩包属性页显示「解除锁定」，勾选后再解压。已经解压的文件仍被阻止时，可重新处理原压缩包并再次解压。启动主程序
双击v2rayN.exe，首次运行后查看任务栏通知区域。窗口关闭后程序通常仍在托盘运行，不等于已经退出。检查内核
打开「设置」→「参数设置」，确认 Core 类型与节点协议匹配。VLESS、REALITY 等配置通常使用支持相应字段的 Xray 内核。
程序首次打开后，可以在「设置」→「参数设置」中确认界面语言、开机启动、日志级别、本地监听端口和 Core 类型。修改 Core 类型或关键端口后，应停止当前内核再重新启动节点，确保生成的新配置被完整载入。
导入订阅并完成第一次连接
订阅链接与单条分享链接不是同一种入口。订阅地址通常返回一组可以更新的服务器配置，应放入订阅分组；以
vmess://、vless://、trojan:// 或 ss:// 开头的内容通常代表单条分享链接，可以从剪贴板批量导入。添加订阅时，进入「订阅分组」→「订阅分组设置」，新建分组后填写别名和订阅地址。保存后使用「订阅分组」→「更新全部订阅（不通过代理）」执行首次拉取。如果订阅服务只能经现有代理访问，应先连接一个可用节点，再改用通过代理更新的选项。
新增分组
进入「订阅分组」→「订阅分组设置」，点击添加，填写容易识别的备注并粘贴完整订阅地址。更新列表
保存后选择「订阅分组」→「更新全部订阅（不通过代理）」。更新成功时，主列表会出现服务器地址、端口、协议和传输方式。选择节点
在主列表选中一个节点并设为活动服务器。先执行真实延迟或连通性测试，超时节点不要继续用于后续系统代理验证。启动系统代理
在托盘菜单或主界面的系统代理选项中选择「自动配置系统代理」，确认托盘状态发生变化后再打开浏览器测试。
单条分享链接可以先复制到剪贴板，再使用「服务器」菜单中的剪贴板导入功能。导入后应检查地址、端口、用户 ID、传输方式、TLS、SNI、指纹和 Flow。VLESS 与 REALITY 组合还要确认公钥、Short ID、Server Name 与服务端配置一致。
| 检查项 | 常见值 | 不一致时的表现 |
|---|---|---|
| 协议 | VMess、VLESS、Trojan、Shadowsocks | 内核启动后握手失败 |
| 传输方式 | TCP、WebSocket、gRPC | 连接建立后立即断开 |
| TLS / REALITY | 按服务端参数启用 | 证书名称或握手参数错误 |
| Flow | xtls-rprx-vision 或留空 |
VLESS 节点认证后无法转发 |
| 服务器端口 | 1 至 65535 范围内的指定端口 | 超时或连接被拒绝 |
系统代理、端口与 TUN 模式怎么配置
系统代理模式和 TUN 模式解决的问题不同。系统代理把 Windows 的代理设置指向 v2rayN 的本地监听端口，遵循系统代理的浏览器和应用会经过节点；不读取系统代理的程序仍可能直接连接。TUN 模式则通过虚拟网络接口接管更广范围的流量，适合需要代理非浏览器应用的场景。
在常见配置中，本地 SOCKS 端口可能使用
10808，HTTP 端口可能使用 10809；部分新配置会使用单个 mixed 端口同时处理两类请求。不要只照搬端口号，应进入「设置」→「参数设置」查看当前实际监听值，并与 Windows 系统代理里的地址和端口逐项核对。127.0.0.1
默认本机监听地址
10808
常见 SOCKS 或 mixed 端口
10809
常见独立 HTTP 端口
若浏览器能打开网页，但某个桌面程序不能连接，先确认该程序是否支持读取 Windows 系统代理。如果应用只接受 SOCKS 地址，应在它自己的网络设置中填写
127.0.0.1 和 v2rayN 当前 SOCKS 端口，而不是填写远端服务器地址。开启 TUN 模式前，应先用系统代理验证节点本身可用。随后从 v2rayN 的 TUN 入口启用虚拟网卡，并按程序提示完成权限操作。TUN 启动失败时，应检查是否存在其他虚拟网卡、占用相同路由的网络工具，以及 Windows 安全策略是否阻止驱动或网络配置变更。
结论:先验证节点，再扩大接管范围
第一次配置先使用系统代理确认订阅、协议与内核工作正常；只有不读取系统代理的程序确实需要接管时，再启用 TUN。这样可以把节点故障和虚拟网卡故障分开定位。
启动失败与内核报错怎么处理
排错时先打开日志，不要只看主列表中的延迟结果。进入日志窗口后重新启动活动服务器，重点观察错误出现在哪个阶段：GUI 尚未加载、内核进程无法启动、本地端口绑定失败、域名解析失败，还是远端握手被拒绝。不同阶段对应的处理方式完全不同。
报错:You must install or update .NET to run this application
原因与解法:当前安装包没有包含所需运行时，或系统中的 .NET 主版本不匹配。安装程序提示的 x64 .NET Runtime 或 .NET Desktop Runtime，也可以改用同版本的 SelfContained 安装包。
报错:Failed to start Core
原因与解法:内核文件缺失、被系统阻止，或配置选择了不存在的 Core。重新完整解压安装包，在「设置」→「参数设置」中核对 Core 类型，并查看内核文件是否仍在程序目录。
报错:Only one usage of each socket address is normally permitted
原因与解法:本地监听端口已被另一个进程占用。退出重复运行的 v2rayN 实例，或把参数设置中的 SOCKS、HTTP、mixed 端口改为未占用端口后重启内核。
报错:failed to find an available destination
原因与解法:远端地址无法解析，或者目标域名、SNI 与 REALITY 参数不正确。检查节点地址拼写，切换可用 DNS，并重新核对 Server Name 后启动内核。
报错:Access to the path is denied
原因与解法:程序目录不允许当前账户写入，导致配置或日志保存失败。将完整目录移动到
D:\Apps\v2rayN 等用户可写路径，不要只移动主程序文件。如果错误只在更新订阅时出现，应区分 HTTP 状态错误与连接超时。返回
401 或 403 通常表示订阅凭据失效、访问策略限制或地址被截断；返回 404 通常表示路径已变化；连接超时则需要检查 DNS、当前网络和是否必须通过代理更新。如果内核能够启动但全部节点都超时，可先切换两个不同服务器地址进行对比，再检查系统时间。TLS 与 REALITY 握手依赖合理的本地时间，Windows 时间偏差过大会造成握手异常。完成时间同步后，应彻底停止旧内核进程再重试。
系统代理不生效、托盘图标缺失与升级问题
系统代理不生效时，首先确认 v2rayN 内核正在运行，其次确认活动服务器已经选中，最后检查 Windows 的代理地址是否指向
127.0.0.1 和当前 HTTP 或 mixed 端口。若代理开关保留了旧端口，先在托盘菜单选择清除系统代理，再重新启用自动配置。托盘图标缺失不一定表示程序退出。Windows 可能把图标收入通知区域的折叠菜单，也可能关闭了该应用的托盘显示。先展开任务栏右侧隐藏图标，再进入 Windows 的任务栏设置，将 v2rayN 的通知区域图标设为可见。任务管理器中存在 v2rayN 进程时，不要反复双击启动多个实例。
窗口关掉后怎么重新打开?
展开任务栏通知区域，双击 v2rayN 图标，或右键图标选择显示主界面。关闭窗口通常只是最小化到托盘；需要结束程序时应使用托盘菜单中的退出。
节点显示可用但网页打不开?
在「设置」→「参数设置」确认本地端口，再检查 Windows 系统代理是否仍指向相同端口。随后清除系统代理并重新选择自动配置，避免旧端口残留。
订阅更新后节点列表为空?
检查订阅分组是否启用，确认地址没有空格或换行，再查看更新日志中的 HTTP 状态。若返回内容是网页而不是订阅数据，需要向订阅提供方确认正确地址。
升级后原来的配置不见了?
确认是否启动了新解压目录中的程序。配置通常跟随程序数据目录或所选存储位置，新旧目录不会自动合并；退出程序后再从备份迁移需要的配置数据。
开机启动后代理没有自动启用?
分别检查「设置」→「参数设置」中的开机启动选项和系统代理启动策略。程序自启动只代表界面进程运行，不等于一定选择了活动服务器并写入系统代理。
升级时不要在 v2rayN 运行中覆盖文件。先退出托盘程序，复制旧目录作为备份，再把新版本解压到单独目录。启动新版本后检查订阅分组、路由规则、自定义 DNS、Core 类型和本地端口，确认无误后再处理旧目录。
- 订阅可以更新但节点不能连接：检查节点字段、系统时间、内核版本和远端网络状态。
- 节点能连接但浏览器不能访问：检查系统代理开关、本地监听地址、端口和浏览器代理策略。
- 浏览器正常但其他程序直连：确认该程序是否读取系统代理，必要时单独填写 SOCKS 参数或测试 TUN。
- 重启后设置丢失：检查程序目录写入权限，以及是否启动了另一个解压目录中的副本。
- 同一端口持续被占用：退出重复实例，在任务管理器确认旧内核结束后再启动。
完成安装后的基础检查
安装完成不应只以窗口能够打开作为判断标准。一个可复现的检查顺序是：确认版本与 Core 类型、更新订阅、选中活动服务器、观察内核日志、启用系统代理、测试浏览器访问，最后再验证路由分流与 TUN。任一步失败，都先停在当前层处理，不要同时更换协议、DNS、端口和内核。
| 检查顺序 | 通过标准 | 失败时查看 |
|---|---|---|
| 程序启动 | 主界面和托盘图标可打开 | .NET 运行时、目录权限 |
| 内核启动 | 日志显示本地端口开始监听 | Core 类型、端口占用 |
| 节点连接 | 日志没有持续握手错误 | 协议字段、时间、DNS |
| 系统代理 | Windows 指向当前本地端口 | 旧代理残留、端口变更 |
| 路由分流 | 规则命中符合预期出站 | 规则顺序、域名与 IP 条件 |
路由分流应在基本连接稳定后配置。规则通常按域名、IP、进程或端口决定流量使用代理、直连或阻断出站。新建规则后要注意匹配顺序：更具体的规则放在通用规则之前，避免前面的宽泛条件提前接管流量。