适合第一次在 Windows 上配置 v2rayN，或准备从经典 WPF 界面迁移到桌面版的用户。先选对系统架构和界面版本，再检查运行环境、导入订阅、启用系统代理，最后处理 TUN 与启动故障。首次配置先只开系统代理，确认一条节点能访问目标网站后再增加功能，避免把订阅、路由和虚拟网卡问题混在一起。
一、桌面版与 WPF 版怎么选
v2rayN 是管理节点、订阅、路由与本地代理入口的客户端，实际连接由内核运行。桌面版采用跨平台界面，WPF 版保留 Windows 经典界面；两者不能简单理解为“一个支持 VLESS、另一个不支持”。协议能力还取决于所选内核及其版本，以及服务端参数是否匹配。
选择依据：界面习惯与系统环境
桌面版
- 首次使用、希望熟悉跨平台界面的用户可优先选择。
- 按 Windows 和处理器架构选择对应包，不要拿其他系统的包运行。
- 安装形式与依赖以当前下载项说明为准。
WPF 版
- 适合已熟悉经典列表、菜单与托盘操作的 Windows 用户。
- WPF 是界面技术，不是代理协议，也不代表内核版本。
- 依赖框架的包通常需要对应的 .NET Desktop Runtime。
不要仅为连接超时切换界面版本；先确认当前内核能够启动、节点参数正确，再考虑迁移。
在 Windows 11 中打开「设置」→「系统」→「系统信息」，查看“系统类型”。常见 Intel、AMD 电脑通常选择 x64；ARM 设备不要把 x64 与 ARM64 当成同一种原生架构。下载页没有适配项时，应先核对该发行版的系统支持说明，而不是反复运行不匹配的程序。
二、安装目录与运行环境
到下载页选择 Windows 安装包。不同发行包可能提供安装程序或压缩包：安装程序按向导完成；压缩包则先完整解压，再运行目录内的 v2rayN.exe。不要在压缩软件的预览窗口里直接双击主程序，这样可能只有主程序被临时释放，依赖文件和内核目录没有一起就位。
-
确定目录
便携包可放在
D:\Tools\v2rayN这类当前用户有写入权限的目录。避免临时目录和受控系统目录；应用后续还需要保存设置、日志和订阅数据。 -
完整解压
保留包内原有文件夹层级。若是安装程序则完成安装，不要把安装程序所在文件夹当成应用数据目录。
-
核对依赖
启动时若提示安装 .NET，记录提示中的框架名称、主版本和架构。WPF 包应按提示补齐 Desktop Runtime，仅安装 SDK 或其他主版本的运行时不一定能解决。
-
首次启动
先以普通用户权限启动。打开「设置」→「参数设置」检查基础配置，并查看主界面日志，确认不是主程序已打开、代理内核却启动失败。
三、订阅导入与节点选择
订阅地址通常包含访问凭据，应按密码对待。不要把完整地址贴进公开截图，也不要把“打开后显示一长串文本”误认为地址错误：客户端需要解析订阅返回的内容，而不是展示一个普通网页。只有登录页、错误页或过期提示时，才应先检查订阅本身。
-
新建分组
打开主界面「订阅分组」→「订阅分组设置」，使用新增入口，填写容易辨认的别名与订阅地址后保存。不同界面版本可能将新增入口显示为“添加”或加号。
-
执行更新
回到「订阅分组」菜单，首次先选择「更新全部订阅（不通过代理）」。如果界面使用独立的“通过代理更新”选项，保持关闭，先验证直接访问订阅是否可行。
-
查看结果
检查日志中的更新结果，再切换到对应分组。更新成功但列表为空时，清除搜索框与服务器过滤条件，并确认没有选到其他分组。
-
设为活动
在服务器列表中选中节点，右键使用「设为活动服务器」。等待内核加载配置，再进行连接测试；只在列表里单击一行，不一定已经切换当前活动节点。
若订阅必须经代理访问，需先有一条能连接的节点，再使用「更新全部订阅（通过代理）」。这个选项不能凭空建立第一条连接。导入 VLESS、VMess 等节点后，优先保留订阅带来的传输、TLS、SNI 和其他参数，不要为了“试一下”同时改动多个字段。
四、系统代理与本地端口
节点设为活动后，通过托盘菜单的「系统代理」→「自动配置系统代理」启用入口。若当前版本将这些选项直接平铺在托盘菜单中，选择同名操作即可。系统代理只是告诉遵循 Windows 代理设置的应用，把请求交给本地代理端口；它不等于所有程序都会自动经过代理。
上面的端口是本文排查示例，不是所有版本的固定默认值。打开「设置」→「参数设置」，查看当前本地监听端口与监听类型。较新的配置可能提供同时接收 HTTP 与 SOCKS 请求的混合端口；一些旧配置则区分两种端口，不能照搬旧教程，把相邻端口号当成必然存在的 HTTP 入口。
系统代理检查项
- 应用入口
- 系统代理 → 自动配置系统代理
- 代理地址
- 127.0.0.1
- 示例端口
- 10808，以当前配置为准
- 检查位置
- Windows 设置 → 网络和 Internet → 代理
Windows 中的代理端口必须对应正在运行的 HTTP 或混合监听入口。
命令行单次测试
- 测试工具
- Windows 自带的 curl.exe
- 代理类型
- HTTP 代理
- 代理入口
- http://127.0.0.1:10808
- 等待上限
- 15 秒
显式指定代理可以避开应用是否读取系统代理这一变量。
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 15 -I https://www.microsoft.com/仅在该端口确实接受 HTTP 代理时使用此命令。收到 HTTP 响应头，说明这一次请求已通过指定入口完成通信，不代表所有网站或所有路由均正常。测试报“无法连接代理”先看本地监听；出现远端握手错误再查节点。路由先选自己能理解的现有规则集，不要在首次测试时同时编辑 DNS 与自定义路由。
五、何时再开启 TUN 模式
浏览器经系统代理可用，而某个不读取系统代理的程序仍无法连接时，再考虑 TUN 模式。TUN 通过虚拟网络接口接管符合配置的流量，并涉及路由与 DNS；系统代理能够工作，不代表 TUN 的权限、驱动或网卡环境也已准备完毕。
- 先保存基线：记录可用节点、系统代理状态和路由规则，让后续有明确的回退点。
- 再处理权限：使用主界面的「TUN 模式」开关；若版本提示需要提升权限，按提示重启或授权，不必把普通代理使用也一律改成管理员运行。
- 观察启动日志：确认 TUN 所用内核启动成功，留意权限不足、接口创建失败和路由添加失败，不能只看开关颜色。
- 隔离网络冲突：其他隧道或虚拟网卡软件可能影响路由，排查时一次只保留一套接管方案；企业设备应先遵守网络管理要求。
- 异常立即回退：关闭 TUN 后重新测试系统代理。能够恢复时，优先检查 TUN 的 DNS、路由和网卡配置，不要先删除全部订阅。
是否同时保留系统代理应服从当前配置和使用场景，不应把“两项都开”当成固定要求。初次排障时分别测试两种入口更容易定位：显式代理请求成功、TUN 下访问失败，通常需要继续看流量接管路径，而不是反复更换同一条节点。
六、启动、端口与网页故障排查
建议按“主程序 → 内核 → 本地端口 → 节点连接 → 应用设置”的顺序排查。程序窗口能显示，只证明界面启动；延迟测试有结果，也不等于浏览器已经使用代理。先保留一段失败时刻的日志，再针对报错处理，比同时重装客户端、修改端口和切换路由更容易得到结论。
双击后没有窗口，是不是没装好？
先看任务栏托盘与任务管理器，确认是否已有实例在运行。没有进程时，从解压目录重新启动，检查运行时提示及安全软件记录。若缺少框架，按提示补齐对应架构和主版本，不要只重复解压主程序。
日志说端口被占用，应该关哪个程序？
先用下面的命令找到监听进程 PID，再去任务管理器「详细信息」核对。常见情况是旧实例尚未退出。确认归属后正常退出对应软件，或把本地端口改为未使用的 10818，并重新设置系统代理；不要强行结束不认识的系统进程。
节点测试有延迟，网页还是打不开？
先确认该节点已设为活动服务器，再检查系统代理端口是否与实际监听一致。浏览器扩展或应用自己的代理选项可能覆盖 Windows 设置。用显式代理命令做对照：命令成功而浏览器失败时，优先检查浏览器入口。
退出后普通网页也打不开了怎么办？
先在托盘「系统代理」中执行「清除系统代理」再退出。若程序已经异常关闭，进入 Windows「设置」→「网络和 Internet」→「代理」，检查手动代理是否残留指向本机的端口；仅撤销由此次操作设置的代理，企业设备不要擅自删除组织配置。
netstat -ano -p tcp | findstr LISTENING | findstr ":10808 "命令末列是 PID；没有输出时，还要确认端口是否填对，以及内核是否确实启动。若日志是证书过期、名称不匹配或 TLS 握手失败，应校准 Windows 时间并核对订阅中的 SNI、服务器地址与传输配置，不要把“跳过证书验证”当成通用修复。HTTP 代理协议与访问目标的 HTTPS 加密是两层概念，也不要因为网页使用 HTTPS 就随意修改本地入口类型。
七、更新与迁移前保留什么
确认可用后，再考虑开机启动、自动更新订阅等便利设置。更新前先退出 v2rayN 与其内核，备份实际数据目录；该位置可能随安装方式变化，不能仅凭主程序路径推断。桌面版与 WPF 版之间迁移时，优先重新导入订阅，再核对路由和端口，不要在不确认配置兼容性的情况下直接覆盖整个目录。
- 订阅资料：保留分组名称与可信订阅地址，备份文件不要公开分享。
- 本地设置：记录监听端口、系统代理模式、路由规则及是否使用 TUN。
- 手动配置：单独备份自建节点和自定义规则，订阅重新导入不会自动恢复这些内容。
- 更新后复测：依次验证内核启动、订阅更新、单次代理请求，最后再检查 TUN 与自动启动。
完成这些检查后，日常使用主要就是更新订阅、选择活动节点和确认入口状态。遇到问题仍沿同一顺序回查，既能区分安装问题与网络问题，也方便回退到上一次可用配置。