先按 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 的网络设置里添加订阅地址。
完整解压
如果下载的是 ZIP 包,在资源管理器中右击并选择「全部解压缩」。解压到当前账户可写的独立目录,例如个人目录下的
Tools\v2rayN。不要在压缩包预览里运行,也不要只拖出主程序;内核和其他随包文件需要保持原有目录结构。启动主程序
从解压后的目录运行
v2rayN.exe。没有看到主窗口时,先检查通知区域的隐藏图标。首次导入和验证普通系统代理时,不需要先启用 TUN,也不要把管理员权限当成启动失败的通用修复。添加订阅
在主界面进入「订阅分组」→「订阅分组设置」,点击「添加」。填入便于识别的备注和完整订阅地址,再保存。订阅地址通常带有访问凭据,复制时要保留查询参数;发截图求助前,遮住整条地址。
拉取节点
在「订阅分组」菜单执行「更新全部订阅(不通过代理)」,再切到刚创建的分组查看节点。保存地址只建立分组,不会替代更新操作。如果直连超时,且手头已有经验证可用的代理,再试对应的「通过代理」更新选项。
选用节点
在节点列表右击一个节点,选择「设为活动服务器」。确认主界面显示的是刚选中的节点,并查看日志中是否出现内核启动失败或监听失败。节点仅仅出现在列表里,不代表它已被启用,也不代表它可用。
核对本地端口与系统代理
先确认内核在本机监听,再让浏览器使用系统代理。下面的端口是排查时常见的参考值,不是所有 7.x 版本都采用的固定值。以「设置」→「参数设置」里的本地监听配置及启动日志为准。
本地监听核对
- 本机地址
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/
- 连不上本地端口:先查监听地址、端口号和内核日志。若日志提示地址已被占用,用
Get-NetTCPConnection -LocalPort 10808 -State Listen查看OwningProcess,再到任务管理器的「详细信息」页按 PID 核对进程。不要直接结束不认识的进程。 - 命令能返回响应,浏览器却失败:检查浏览器是否使用独立代理设置,以及 Windows 中记录的代理地址和端口是否一致。修改监听端口后,重新应用系统代理,并同步改掉应用里手填的旧端口。
- 页面打开了,但不确定走了哪个出站:响应只说明请求经过本地代理后得到了结果,不代表一定经过远端节点。测试域名可能命中直连规则。需要确认时,对照所用路由规则的顺序和可用的内核访问日志。
启动失败、订阅失败与浏览器断网排查
双击就提示安装 .NET,该装哪个?
按弹窗中的框架名、版本和架构选择运行时。例如弹窗列出 Microsoft.WindowsDesktop.App、8.0 系列和 x64,就选对应的 .NET 8 Desktop Runtime x64,不要只装普通 .NET Runtime。可以用 dotnet --list-runtimes 辅助检查;如果系统同时安装了不同架构的运行时,先确认该命令列出的是主程序所需的架构。
主程序在,为什么日志说找不到内核?
先确认发布包是否包含所需内核、是否完整解压。然后打开「Windows 安全中心」→「病毒和威胁防护」→「保护历史记录」,查看是否有与启动时间和文件路径对应的记录。不要为了启动关闭防护或排除整个目录。若来源或告警原因不明,停止运行并重新获取可信发布包;单位设备交由管理员处理。
目录带中文,启动报找不到文件怎么办?
先退出托盘中的客户端,再用同一个包全量解压到当前用户可写、路径短且不含中文的独立目录。确认完整路径,而不只是最后一级文件夹名。先用新目录启动做对照,不要把两份目录覆盖混合。中文路径本身不等于故障;只有换目录后同一操作恢复,才值得继续查路径解析、目录长度或访问权限。
更新订阅一直超时,应该换内核吗?
先看订阅更新日志。订阅拉取失败和节点连接失败是两件事。超时先查当前网络能否访问订阅服务,及所选更新方式是否依赖尚未可用的代理;返回 401 或 403 时先检查订阅是否失效、访问权限是否变化。若日志提示证书异常,核对 Windows 日期、时间和时区,不要通过关闭证书验证解决。
关掉客户端后,为什么浏览器也断网了?
如果 Windows 仍指向已停止监听的本地代理,浏览器会继续连接一个不存在的入口。重新启动客户端,在托盘「系统代理」菜单中选择「清除系统代理」,再正常退出,并在 Windows「代理」页面确认结果。若原来使用单位代理,应恢复原有设置,而不是把所有代理选项都关掉。