v2rayN Windows 版安装配置全流程:WPF 版与 Desktop 版怎么选

从选包、解压、首次运行到导入订阅一步步走完,对比 WPF 版与 Desktop 版的差异,并汇总缺少运行库、杀软拦截、路径含中文等常见问题。

本文速览

先按 Windows 系统架构选包,再决定用 WPF 还是 Desktop。首次配置时,分开验证三件事:订阅能否拉取节点、内核能否启动、浏览器是否使用了系统代理。遇到故障就停在失败的那一步,不要同时换界面、换节点和改路由。

WPF 版与 Desktop 版:先看架构,再选界面

打开 Windows「设置」→「系统」→「关于」,在「设备规格」下查看「系统类型」。基于 x64 的系统选 Windows x64 包;基于 ARM 的系统优先选对应的 Windows ARM64 包(如该版本有提供)。两者都可能显示为 64 位,不能只看位数。WPF 与 Desktop 是界面版本,不是代理协议;同一条订阅能否使用,取决于节点配置和实际运行的内核。

Windows 下的两种界面版本

WPF 版
  • 使用 Windows 的 WPF 界面框架,适合沿用熟悉的 Windows 版界面。
  • 若所选包依赖外部运行时,启动提示中的 Microsoft.WindowsDesktop.App 对应 .NET Desktop Runtime。
Desktop 版
  • 使用 Avalonia 界面框架。即使见过其他平台上的同款界面,这里仍要选 Windows 包。
  • 菜单布局可能与 WPF 不同;是否自带运行时和内核,要看该发布包的说明,不能从 Desktop 字样判断。

已有能正常使用的版本,不必为了导入订阅换界面;首次安装优先选架构匹配、依赖说明清楚的包。

解压、首次运行与订阅导入

以下以 v2rayN 7.x 的常见 Windows 界面为例。不同小版本的入口布局可能调整:找不到工具栏按钮时,先找同名菜单,不要到 Windows 的网络设置里添加订阅地址。

  1. 完整解压

    如果下载的是 ZIP 包,在资源管理器中右击并选择「全部解压缩」。解压到当前账户可写的独立目录,例如个人目录下的 Tools\v2rayN。不要在压缩包预览里运行,也不要只拖出主程序;内核和其他随包文件需要保持原有目录结构。

  2. 启动主程序

    从解压后的目录运行 v2rayN.exe。没有看到主窗口时,先检查通知区域的隐藏图标。首次导入和验证普通系统代理时,不需要先启用 TUN,也不要把管理员权限当成启动失败的通用修复。

  3. 添加订阅

    在主界面进入「订阅分组」→「订阅分组设置」,点击「添加」。填入便于识别的备注和完整订阅地址,再保存。订阅地址通常带有访问凭据,复制时要保留查询参数;发截图求助前,遮住整条地址。

  4. 拉取节点

    在「订阅分组」菜单执行「更新全部订阅(不通过代理)」,再切到刚创建的分组查看节点。保存地址只建立分组,不会替代更新操作。如果直连超时,且手头已有经验证可用的代理,再试对应的「通过代理」更新选项。

  5. 选用节点

    在节点列表右击一个节点,选择「设为活动服务器」。确认主界面显示的是刚选中的节点,并查看日志中是否出现内核启动失败或监听失败。节点仅仅出现在列表里,不代表它已被启用,也不代表它可用。

核对本地端口与系统代理

先确认内核在本机监听,再让浏览器使用系统代理。下面的端口是排查时常见的参考值,不是所有 7.x 版本都采用的固定值。以「设置」→「参数设置」里的本地监听配置及启动日志为准。

10808
常见本地代理端口,可能是混合监听
10809
部分分离监听配置使用的 HTTP 端口

本地监听核对

本机地址
127.0.0.1
监听端口
以客户端配置和启动日志为准
测试前提
内核已启动,确认该端口接受 HTTP 代理请求

混合端口可接受 HTTP 和 SOCKS 请求;单独的 SOCKS 端口不能当作 HTTP 代理填写。

系统代理核对

客户端入口
通知区域图标 →「系统代理」→「自动配置系统代理」
Windows 核对位置
「设置」→「网络和 Internet」→「代理」
验证应用
使用系统代理设置的浏览器

系统代理决定哪些遵循它的应用把请求交给客户端;路由规则决定内核收到请求后走哪个出站。

想把浏览器设置和本地代理分开排查,可以在 PowerShell 中显式指定代理。下例仅用于已确认 10808 接受 HTTP 代理请求的情况;监听端口不同就替换数字。

curl.exe --noproxy "" --proxy http://127.0.0.1:10808 --connect-timeout 5 --max-time 15 -I https://example.com/

启动失败、订阅失败与浏览器断网排查

双击就提示安装 .NET,该装哪个?

按弹窗中的框架名、版本和架构选择运行时。例如弹窗列出 Microsoft.WindowsDesktop.App、8.0 系列和 x64,就选对应的 .NET 8 Desktop Runtime x64,不要只装普通 .NET Runtime。可以用 dotnet --list-runtimes 辅助检查;如果系统同时安装了不同架构的运行时,先确认该命令列出的是主程序所需的架构。

主程序在,为什么日志说找不到内核?

先确认发布包是否包含所需内核、是否完整解压。然后打开「Windows 安全中心」→「病毒和威胁防护」→「保护历史记录」,查看是否有与启动时间和文件路径对应的记录。不要为了启动关闭防护或排除整个目录。若来源或告警原因不明,停止运行并重新获取可信发布包;单位设备交由管理员处理。

目录带中文,启动报找不到文件怎么办?

先退出托盘中的客户端,再用同一个包全量解压到当前用户可写、路径短且不含中文的独立目录。确认完整路径,而不只是最后一级文件夹名。先用新目录启动做对照,不要把两份目录覆盖混合。中文路径本身不等于故障;只有换目录后同一操作恢复,才值得继续查路径解析、目录长度或访问权限。

更新订阅一直超时,应该换内核吗?

先看订阅更新日志。订阅拉取失败和节点连接失败是两件事。超时先查当前网络能否访问订阅服务,及所选更新方式是否依赖尚未可用的代理;返回 401 或 403 时先检查订阅是否失效、访问权限是否变化。若日志提示证书异常,核对 Windows 日期、时间和时区,不要通过关闭证书验证解决。

关掉客户端后,为什么浏览器也断网了?

如果 Windows 仍指向已停止监听的本地代理,浏览器会继续连接一个不存在的入口。重新启动客户端,在托盘「系统代理」菜单中选择「清除系统代理」,再正常退出,并在 Windows「代理」页面确认结果。若原来使用单位代理,应恢复原有设置,而不是把所有代理选项都关掉。

下载客户端