适合第一次在 Windows 上配置 v2rayN，或遇到启动闪退、订阅导入后不能上网的用户。先确认系统架构和界面版本，再完整解压、补齐运行环境、导入订阅，最后依次验证节点、本地端口和系统代理。每次只改一项，便于区分安装问题与连接问题。
一、Desktop 版与 WPF 版：先选界面，再选架构
先打开 Windows「设置」→「系统」→「系统信息」，查看「系统类型」。x64 处理器通常选 Windows x64 包；ARM64 设备优先选对应的 ARM64 包，前提是该界面版本确实提供这一架构。不要只看文件名里有 Windows 就下载，也不要把系统架构和节点协议混为一谈。
Desktop 版
推荐采用跨平台桌面界面。首次配置可从这一版开始，按当前下载页说明选择 Windows 架构。界面版本影响菜单布局，不会自动提高节点带宽或降低网络延迟。
适合：首次安装、希望沿用跨平台界面操作习惯的用户。
WPF 版
沿用经典 Windows 桌面界面。已经熟悉这一布局的用户可以继续选择。运行环境要求以所下载发行包为准，不要把旧版教程里的依赖版本直接套到新版。
适合：习惯经典界面、已有明确 Windows 操作流程的用户。
Desktop、WPF 是界面实现的区别；Xray、V2Ray 是代理核心的区别；VMess、VLESS 则是节点使用的协议。三者不在同一层。切换界面不能修复错误的服务器地址，切换核心也不能代替安装主程序需要的运行环境。
二、完整解压与首次启动：不要在压缩包内运行
-
确认安装包
进入下载中心，选择 Windows 对应界面和架构。先读包型说明，确认是压缩包、安装包，还是包含运行环境的发行包。
-
完整解压
压缩包可解压到
C:\Tools\v2rayN这类有写入权限的固定目录。不要只拖出v2rayN.exe，也不要从压缩软件的预览窗口直接启动。 -
补齐依赖
如果启动提示缺少 .NET，记下弹窗要求的运行时名称、主版本和架构，再安装匹配组件。若 WPF 包要求 Windows Desktop Runtime，仅装普通 .NET Runtime 不一定够用。
-
检查启动
运行主程序，确认主窗口与日志区域能正常打开。首次验证先保持普通用户权限；只有后续启用 TUN 等需要权限的功能时，再按界面提示操作。
如果使用安装包，则按安装向导完成，不必再执行压缩包解压步骤。遇到闪退时，先记录错误文字和包型；把程序反复换到不同目录、同时安装多个不匹配的运行库，会让后续排查更困难。
三、导入订阅：先得到节点列表，再启动连接
订阅链接是获取节点配置的入口，不是浏览器的代理地址。它通常含有访问凭据，应当按密码保护，不要把完整链接放进公开截图或日志求助内容。订阅到期、额度用尽或返回登录页面，都可能导致更新失败。
-
新建分组
在主界面进入「订阅分组」→「订阅分组设置」，添加分组；若当前界面提供「+」入口，也可从该入口新增。填写便于识别的别名，并把完整订阅链接粘贴到地址栏。
-
更新订阅
保存后，在「订阅分组」菜单执行「更新全部订阅（不通过代理）」。首次尚无可用代理时先尝试直连更新；不同发行版的括号文字可能略有变化，应以实际菜单为准。
-
核对列表
检查是否出现节点名称、地址、端口和协议。列表为空时先查看更新日志，不要急着开启系统代理。若返回的是网页而非订阅内容，需要向服务提供方确认链接用途。
-
设为活动
选中一个节点，在右键菜单中设为活动服务器。执行「测试服务器真连接延迟」一类测试项，确认有结果后，再进入浏览器代理配置。
只有在现有节点已经可用、且订阅地址确实需要经代理访问时，才尝试通过代理更新订阅。真连接延迟包含测试目标和当前线路的影响；例如显示 180 ms，只说明该次请求成功及其耗时，不代表持续下载速度，也不能保证所有网站都可访问。
四、本地端口与系统代理：确认流量入口
打开「设置」→「参数设置」，查看基础设置或本地监听相关页面中的端口值。不同版本可能使用「本地混合监听端口」等名称。下面以混合端口 10808 为例；若实际配置不同，命令和系统设置必须一起替换。
- 先激活节点，确认日志没有核心启动失败，再在主界面底部或托盘菜单的「系统代理」中选择「自动配置系统代理」。
- 打开 Windows「设置」→「网络和 Internet」→「代理」，检查客户端写入的地址与端口是否对应当前监听配置。
- 初次测试不要同时手工修改 Windows 代理、浏览器扩展和客户端端口。先让浏览器使用系统代理，再逐项验证。
- 只在本机使用时，保留回环监听和默认访问限制。不要为了测试方便随意开启允许局域网连接。
旧教程有时分别填写 SOCKS 端口 10808 和 HTTP 端口 10809。当前安装是否分开监听，要看实际参数，不能直接照抄。HTTP 代理请求必须指向支持 HTTP 的端口；混合监听则可以在同一端口接收相应类型的代理请求。
五、系统代理与 TUN：先用一种模式完成验证
首次安装方案：先系统代理，后按需启用 TUN
系统代理
- 先用于浏览器等遵循系统代理设置的应用。
- 在主界面「系统代理」中启用，退出前清除。
- 未遵循系统代理的程序可能仍然直连。
TUN 模式
- 用于需要在网络层接管流量的场景。
- 可能需要提权、虚拟网卡与相应核心支持。
- 另行检查 DNS、路由以及其他虚拟网卡冲突。
先关闭 TUN，用系统代理验证节点和端口；确有应用接管需求时，再单独测试 TUN，避免同时改变多个变量。
路由分流和系统代理也不是同一件事。系统代理决定应用是否把请求交给客户端；路由规则决定客户端收到请求后走代理、直连还是阻断。初次可选择界面提供的常规分流模式，遇到某个域名异常时，再查看该请求实际命中了哪条规则。
不要把“全局”理解为能自动覆盖所有 Windows 程序。在系统代理模式下，应用如果根本不读取系统代理，改变客户端路由模式也不能让它自动接入。先用明确支持代理的工具测试，再判断是否需要 TUN。
六、用命令行验收：区分本地失败与远端失败
在 PowerShell 中依次执行下面的命令。第一条检查本机是否有进程监听示例端口；第二条显式指定 HTTP 代理，避免把浏览器缓存、扩展或系统代理读取差异混进结果。测试目标可替换为你确认可访问的 HTTPS 站点。
Get-NetTCPConnection -State Listen -LocalPort 10808
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/| 结果 | 说明 | 下一步 |
|---|---|---|
| 查询不到监听 | 核心未监听该端口，或示例值与实际配置不同。 | 核对参数设置及核心日志，不要先换节点。 |
| 连接本机被拒绝 | 请求尚未成功进入本地代理。 | 检查端口、监听地址和核心进程。 |
| 本地接入后超时 | 可能涉及远端连接、DNS 或目标站点。 | 换一个测试目标，再比对节点测试和错误日志。 |
| 返回 HTTP 响应头 | 该次显式代理请求获得响应。 | 继续用浏览器验证系统代理与路由选择。 |
若只看到 200 Connection established，它表示代理隧道建立阶段成功，还要继续看目标站点的响应或后续错误。即使最终返回 403，也应区分“站点拒绝访问”和“本地代理没有启动”，两者的修复方向不同。
七、常见安装坑：按现象修复，不反复重装
双击没有窗口，应该先重装吗？
先看任务栏托盘和任务管理器，排除程序已经在后台运行。若进程立即退出，记录启动提示，核对架构、运行库和解压完整性。不要直接覆盖旧目录试运气；需要比较时，将新包解压到独立目录，退出旧进程后再启动。
出现端口被占用，怎样定位？
执行 Get-NetTCPConnection -State Listen -LocalPort 10808，读取 OwningProcess，再用 Get-Process -Id 进程编号 查询名称。先确认是否是重复启动的旧核心。若改用其他空闲端口，记得重新应用系统代理，并同步修改手工配置的应用代理。
节点显示延迟，浏览器仍无法访问怎么办？
先运行显式指定代理的命令。命令成功、浏览器失败时，重点检查浏览器代理扩展、系统代理地址和路由规则；命令也失败时，再检查活动节点与核心日志。普通延迟或 TCP 测试不等于完整的代理请求验证。
更新后节点或配置不见了怎么办？
先确认是不是从新目录启动了另一份程序。更新前完整退出，并备份原目录中的配置数据；具体数据位置以该版本说明为准。不要在两个运行中的界面版本之间直接覆盖配置文件。订阅可以重新导入，但自定义路由和本地参数需要另行保存。
退出后网页都打不开，如何恢复？
先重新打开客户端，在「系统代理」中选择「清除系统代理」后退出。若客户端无法启动，到 Windows 的代理设置中移除已经失效的本地手动代理；企业设备上的受管设置应先联系管理员。随后再检查是否遗留其他网络接管程序。
八、完成安装后的验收清单
- 启动：主程序和核心均正常运行，日志没有持续重复的启动错误。
- 订阅：节点列表非空，已选择活动服务器，订阅地址没有暴露在公开内容中。
- 端口：实际监听值与系统代理一致，显式代理命令能取得目标响应。
- 浏览器：能使用系统代理访问测试站点，路由结果符合预期。
- 退出：清除系统代理后，普通直连访问恢复；再启动客户端也能重复完成验证。
走完这些检查，安装流程才算闭环。之后出现单个节点超时或单个网站异常，应从节点、目标站点和路由规则着手，而不是先更换 Desktop 与 WPF 界面。保留安装包类型、系统架构和脱敏错误日志，能显著减少重复排查。