v2rayN Windows 版安装教程:WPF 版与 Desktop 版怎么选

WPF 与 Desktop：先区分界面，再看发行包

WPF 是 Windows 专用的界面技术；v2rayN 的 Desktop 发行形态采用跨平台桌面界面技术。两者的主要区别在界面实现、交互细节和运行环境，不是两种节点协议。服务器是否可用，还取决于订阅参数、实际使用的代理内核及网络条件，不能仅凭窗口外观判断。

发行方式还要单独看。便携压缩包需要完整解压后运行，安装程序则应按向导处理安装位置。是否包含内核、是否自带运行环境，要看下载页说明和包内内容，不能用 WPF 或 Desktop 两个名称直接推断。两种界面可以分别测试，但不要同时启动并争用同一个本地监听端口。

下载前确认架构与运行库

在 Windows「设置」→「系统」→「系统信息」中查看“系统类型”。常见 Intel、AMD 电脑通常使用 x64 包；Windows on Arm 设备优先选择发行方提供的 ARM64 包。处理器品牌不能代替架构检查，文件名中的架构也必须与运行库架构对应。

遇到“必须安装或更新 .NET 才能运行此应用”时，先记录提示里的框架名称、主版本和架构。WPF 所需的 Windows Desktop 运行环境与基础 .NET Runtime 不是同一项。不要连续安装多个不相关运行库，也不要从不明来源下载单个 DLL 塞进目录；这类操作会掩盖真正的依赖问题。

• 提示缺少框架：核对框架名称及主版本，安装后重新启动客户端。
• 提示无法在此电脑运行：先核对系统支持范围、架构和下载文件是否完整解压。
• 主窗口正常、启动节点失败：转查内核文件和运行日志，而不是继续重装界面运行库。

解压运行与订阅导入：按顺序完成

下面以 Windows 便携压缩包为例。不同发行版本的菜单文字可能略有调整，应以实际界面为准；操作顺序不变：固定目录、启动客户端、保存订阅、更新列表、选中服务器。不要在压缩软件的预览窗口里直接运行主程序，否则配置和内核文件可能无法正确定位。

1. 选择发行包

   前往客户端下载页，按 Windows、处理器架构和界面类型选择入口。先读清发行包说明，再决定使用便携包还是安装程序。

2. 完整解压

   将全部文件解压到当前账户可写的固定目录，例如 D:\Tools\v2rayN。不要只复制 v2rayN.exe，也不要把长期配置留在临时解压目录。

3. 启动主程序

   运行 v2rayN.exe。普通系统代理通常不要求管理员权限；若出现运行库提示，先按上一节处理，再继续配置。

4. 保存订阅

   在主界面「订阅分组」→「订阅分组设置」中添加分组，填写备注和订阅地址并保存。订阅地址属于访问凭据，不要放进公开截图。

5. 更新列表

   从「订阅分组」执行「更新全部订阅（不通过代理）」。首次没有可用代理时，先走当前网络获取订阅；若来源需要其他访问条件，应按订阅提供方的说明处理。

6. 设为活动服务器

   选中导入的服务器，通过右键菜单「设为活动服务器」启用。再检查日志是否成功启动对应内核，最后设置系统代理，避免把导入成功误认为连接已经成功。

保存订阅地址与下载订阅内容是两步。列表为空时，先检查是否执行了更新、日志是否提示请求失败，以及当前是否选中了其他分组。订阅返回登录页面、过期提示或错误文本时，重复点击更新不会得到有效节点，应先处理订阅来源的问题。

系统代理、路由与 TUN：首次只启用一种入口

v2rayN 启动内核后，会在本机提供代理监听入口。Windows 系统代理只是把入口地址写入系统设置，愿意读取系统代理的程序才会使用它。路由则发生在流量进入内核之后，决定该连接直连、代理或阻断。这两个层次不要混为一谈。

检查本地端口时，在「设置」→「参数设置」中查找监听端口相关项；旧版与新版的字段和默认值可能不同。以下以本地 HTTP 兼容入口 127.0.0.1:10808 为例，数字仅用于说明。若实际监听端口不同，命令也必须一起修改；若该端口只接受 SOCKS，则不能直接套用 HTTP 代理命令。

curl.exe --proxy http://127.0.0.1:10808 --head --connect-timeout 10 https://example.com/

这条命令适用于系统已提供 curl.exe，且示例端口支持 HTTP 代理的情况。收到 HTTP 响应说明该次请求已获得响应，但不能代表全部网站都可访问，也不是性能测试。若提示无法连接本地端口，先查客户端监听；若连接到本地代理后才超时，再检查活动服务器、路由、DNS 和远端连接。

开机自启：确认的是登录启动与代理恢复

桌面客户端所说的“开机自启”，通常是用户登录 Windows 后启动界面程序，并不等于系统尚未登录时就建立代理。先手动运行成功，再配置自动启动；否则每次登录只会重复触发相同错误。

• 打开「设置」→「参数设置」，查找“开机自动启动”相关选项并保存。具体所在分页以当前版本界面为准。
• 在 Windows「设置」→「应用」→「启动」中检查相关启动项是否被关闭；不同注册方式可能还需要在任务计划程序中查看。
• 保持程序目录不变。移动文件夹后，旧启动项可能仍指向原来的可执行文件，需要重新设置。
• 注销后重新登录，确认托盘图标、活动服务器和监听端口，而不是只检查任务管理器里有没有进程。
• 需要 TUN 时，再核对权限请求和启动方式。普通登录启动不保证自动获得管理员权限。

客户端启动与系统代理恢复也要分别验证。如果浏览器仍能直连，可能只是系统代理没有开启；如果所有读取系统代理的程序都无法联网，则可能是 Windows 保留了代理地址，但客户端内核尚未监听。打开 Windows「设置」→「网络和 Internet」→「代理」，核对“手动设置代理”中的地址和端口，不要只依据托盘图标判断。

常见故障与更换界面的处理顺序

WPF 与 Desktop 切换适合用来排查界面兼容问题，不应作为所有连接故障的通用修复。窗口能打开但节点超时，优先查看日志；窗口根本无法启动，才先处理架构、运行库和文件权限。按故障出现的位置分层检查，比反复覆盖文件更有效。

升级与切换前保留可恢复副本

升级前先退出客户端，备份实际数据目录和当前可用配置。便携包的数据常随程序目录保存，但不能据此认定所有发行形态都使用相同位置；应以当前客户端的数据目录功能、设置或发行说明为准。备份中可能含订阅地址和服务器凭据，需要妥善保管。

1. 把新发行包解压到独立目录，避免直接覆盖正在运行的程序和内核。
2. 优先用客户端提供的导出、导入功能迁移；若手动迁移，先确认两端的数据格式兼容。
3. 只启动新副本，验证订阅、活动服务器、路由和系统代理，再重新登记启动项。
4. 新版本写入的数据不保证能被旧版本读取。回退时恢复升级前备份，而不是让旧程序直接读取已迁移的数据。

最终选择不需要复杂：只在 Windows 使用，可先试 WPF；需要跨平台界面习惯，可试 Desktop。无论选哪一种，都先完成架构匹配、完整解压、运行环境检查和一次普通系统代理验证，再增加登录启动、规则调整或 TUN。更多基础设置可参考入门指南，连接异常可按使用手册继续分层排查。