v2rayN Windows 安装全流程:WPF 版与 Desktop 版怎么选及常见坑

先选发行包：WPF 与 Desktop 的区别

WPF 是 Windows 界面技术，v2rayN 的 WPF 版保留经典桌面操作方式；Desktop 版使用跨平台界面。两者首先是界面与发行形态的区别，不是两种代理协议，也不能据此断定其中一种网速更快。同一服务器的实际表现还受内核、路由、传输参数与网络环境影响。

打开 Windows「设置」→「系统」→「系统信息」，查看“系统类型”。x64 系统通常选择 x64 包，ARM64 设备优先选择对应原生包。系统显示为 64 位，不等于处理器一定是 x64；也不要把运行时架构与客户端架构混装。

下载与解压：先建立可写的程序目录

从客户端下载页选择 Windows 对应入口。发行包可能采用安装程序或压缩包形式，处理方式要跟随实际文件类型：安装程序按向导完成安装；压缩包则先完整解压，再启动目录内的主程序。不要在压缩软件的预览窗口里直接双击运行。

1. 确认架构

   在 Windows「设置」→「系统」→「系统信息」确认 x64 或 ARM64，再核对下载页中的界面类型和架构，不凭图标或包体大小判断。

2. 完整解压

   压缩包右键选择「全部解压缩」，例如保存到当前用户可写的 D:\Tools\v2rayN。保留包内全部子目录，不只复制 v2rayN.exe。

3. 首次启动

   打开主程序。若提示需要运行时，先记录提示中的框架名称、主版本与架构，退出程序后补齐相符依赖，再重新启动。

4. 检查内核

   进入「设置」→「参数设置」，检查当前版本提供的内核相关设置；启动连接后查看日志。若提示找不到核心程序，核对包内目录是否完整以及安全软件的隔离记录。

5. 保留工作目录

   确认可以正常保存设置后再创建快捷方式。升级前退出旧进程并备份配置，优先在新目录验证新版，不把多个版本的程序与内核文件混放。

尽量避免把需要写入配置的便携目录放在受保护的系统目录。普通系统代理通常不需要管理员权限；一遇到问题就长期以管理员运行，既不能修复缺失文件，也会掩盖目录权限问题。涉及 TUN 等功能时，再按程序提示处理所需权限。

运行时依赖：根据错误提示补齐，不盲装版本

“已安装 .NET”并不足以说明依赖齐全。框架依赖型发行包会检查特定运行时系列；自包含发行包通常随包携带所需运行时，但仍有操作系统与原生组件要求。是否自包含应看发行说明，不能按文件扩展名判断。

不同 .NET 主版本可以并存，但安装更新的主版本不保证自动满足旧主版本要求。WPF 依赖桌面运行时的场景尤其要区分 Windows Desktop Runtime 与普通 .NET Runtime。不要依照过时教程固定安装某一代运行时，而应照启动提示逐项匹配。

首次导入订阅：先更新列表，再设置活动服务器

主程序能打开后，再处理订阅。订阅地址用于获取并更新一组服务器配置；vmess://、vless:// 等分享链接通常描述单个节点。把单节点链接粘进订阅地址字段，并不等同于从剪贴板导入。

1. 建立分组：打开「订阅分组」→「订阅分组设置」，新增分组并填写可辨认的名称，在地址字段粘贴完整订阅地址后保存。
2. 获取节点：返回主界面，打开「订阅分组」菜单，执行对应的更新订阅操作。不同版本可能分别提供更新当前分组、全部分组，以及通过代理更新的选项，以实际菜单文字为准。
3. 确认结果：检查分组中是否出现节点，再查看日志是否存在网络错误、认证失败或格式不支持提示。分组名称出现，不代表订阅内容已经成功下载。
4. 选中服务器：在列表中右键目标节点，执行「设为活动服务器」；确认当前状态与所选节点一致，再进行真实连接测试。

首次安装时若尚无可用代理，不要机械选择“通过代理更新”。直连无法访问订阅地址时，应先确认地址有效、网络允许访问，再使用已有可用连接更新。反过来，已有工作正常的代理时，也不必为了遵循某种固定教程强制改为直连。

订阅成功但连接失败，应核对服务是否到期、设备时间是否准确，以及节点参数是否完整。VMess、VLESS 是协议名称，订阅是配置分发方式；导入订阅不会自动修正服务端与客户端之间不匹配的参数。

系统代理与本地端口：把流量交给正在运行的内核

先确认核心已经启动，再在 v2rayN 的「系统代理」菜单选择「自动配置系统代理」。Windows「设置」→「网络和 Internet」→「代理」可用来复核系统代理状态。系统代理只对遵循该设置的应用有效，不等于所有进程都已接管。

下面两张卡是排查用配置样例，不是所有版本的默认值。进入「设置」→「参数设置」查看实际监听端口与入站类型；只有确认该端口支持 HTTP 或混合代理时，才能直接套用后面的 HTTP 测试命令。不要照抄旧教程，把另一版本的端口当成本机事实。

如果本地端口被占用，核心可能无法启动，而 Windows 仍保留原代理地址。此时浏览器会把请求发送到没有正确监听的端口，看起来像整个网络都断开。更改端口后要同步更新系统代理，并检查应用内手动配置的代理是否仍指向旧端口。

连接验证：按监听、代理、路由逐层排查

先检查本地端口，再检查经代理的请求，最后测试实际业务应用。下面命令在 PowerShell 中运行，假设已经确认 HTTP 代理监听于 127.0.0.1:10808；若实际设置不同，先替换端口。请求目标只用于演示，单个网站的结果不能代表所有网站的可达性。

Get-NetTCPConnection -LocalPort 10808 -State Listen
Test-NetConnection 127.0.0.1 -Port 10808
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://www.microsoft.com/

• 没有监听记录：回到核心日志，检查端口冲突、配置错误与文件缺失。不要继续反复切换浏览器设置。
• 本地端口可达，但请求失败：继续检查节点、DNS、TLS 与路由。TCP 端口可达只说明本机入口存在，不证明远端连接成功。
• 显式代理请求成功，浏览器失败：检查浏览器自己的代理配置、扩展、策略及系统代理是否被其他程序改写。
• 只有部分应用失败：确认这些应用是否遵循系统代理。必要时再评估 TUN，不要把关闭防火墙当成常规解决方案。

curl.exe 返回 HTTP 状态码，说明请求至少到达了某个 HTTP 响应端；返回拒绝访问等状态不等于本地代理未启动。另外，路由若把测试域名设为直连，即使显式使用本地代理，请求仍可能由内核直连发出。要判断节点是否真的承载流量，应同时核对路由命中与连接日志。

升级与退出：避免残留代理、混用文件和丢失配置

升级前记录界面类型、实际监听端口、路由选择与配置保存位置，并在退出程序后备份配置。便携包与安装形式的配置位置可能不同，不要假定配置一定在主程序旁边。订阅地址往往包含访问凭据，备份文件应放在受控目录，不随故障截图公开。

正常退出前，可先在「系统代理」中选择「清除系统代理」，再退出客户端。若程序异常终止，打开 Windows「设置」→「网络和 Internet」→「代理」，检查手动代理或脚本是否仍指向已停止的本地服务；单位网络存在既定代理策略时，先记录原设置，不要一概清除。