首次安装 v2rayN，先选对 Windows 架构与界面包，再确认完整解压、订阅更新和本地监听端口。本文按“主程序能启动 → 节点能导入 → 内核能连接 → 应用走代理”的顺序操作；已经装好但网页打不开的用户，也可以据此判断故障发生在哪一层。
一、WPF 版与 Desktop 版怎么选
v2rayN 是管理节点、订阅和代理设置的桌面界面，实际连接由内核处理。WPF 与 Desktop 首先是界面技术和运行环境的区别，并不是两种代理协议；选择其中一个，不代表连接天然更快。Desktop 使用跨平台界面，WPF 保留经典 Windows 界面，具体协议能力还取决于包内内核及其版本。
Desktop 版
推荐首次安装可从 Desktop 开始，按下载页说明确认 Windows 架构及运行环境要求。跨平台界面与 WPF 的菜单布局可能不同，遇到旧教程时应按设置项含义定位，不必逐个对齐截图。
适合：新安装、愿意使用跨平台界面的 Windows 用户。
WPF 版
熟悉经典 Windows 界面时可选择 WPF。若启动提示缺少运行框架，应核对该发行包要求的 .NET Desktop Runtime 和处理器架构，不能只安装名称相似的普通运行时。
适合：沿用经典界面操作习惯、希望按既有流程迁移的用户。
下载前打开 Windows「设置」→「系统」→「系统信息」，查看“系统类型”。x64 与 ARM64 应按页面和包说明匹配；不要只凭设备品牌判断。下载入口集中在客户端下载页，本文不固定版本号，也不把某个运行库版本当作所有发行包的共同要求。
二、完整解压与首次启动
解压版必须先提取全部文件，再运行其中的 v2rayN.exe。只从压缩软件里双击主程序，或者只复制这一个文件，会丢失依赖、内核或资源文件。建议使用当前账户可写的固定目录，例如 D:\Tools\v2rayN；没有 D 盘时可选用户目录下的独立文件夹。
-
核对包类型
在下载页选择 Windows 的 Desktop 或 WPF，核对架构与运行环境说明，完成下载后再解压。
-
提取全部文件
在文件管理器中右键压缩包，选择「全部解压缩」。避免直接在压缩窗口运行，也不要把不同界面包覆盖到同一目录。
-
启动主程序
打开解压目录中的
v2rayN.exe。普通系统代理流程先使用常规权限，出现错误时保留完整提示和日志。 -
核对监听项
打开「设置」→「参数设置」，找到本地监听地址和端口相关设置，记录当前值。不同界面包可能将这些项目放在不同页签。
-
确认可保存
保存设置后正常退出，再次启动确认设置仍在。若每次启动都恢复初始状态，先查目录写入权限和是否运行了另一份程序。
中文路径不必一律判定为故障原因。它可能影响个别外部组件的路径处理，但应先查看日志是否指向路径或文件读取错误。需要验证时，退出程序，把完整目录复制到短英文路径后再试；保留原目录，便于恢复订阅与配置。网络共享、同步盘和系统保护目录则更容易引入写入权限或文件锁问题。
三、订阅导入与节点选择
订阅地址用于获取节点列表，不等同于单条节点分享链接。先确认拿到的是完整订阅 URL，再进入「订阅分组」→「订阅分组设置」，添加分组、填写别名和地址并保存。如果当前界面把新增操作显示为“+”，它仍是在添加一个订阅分组，而不是创建服务器配置。
- 填写地址：去掉复制时混入的空格和换行，保留地址本身的路径及查询参数。别名可使用“主订阅”等本地名称，不必包含账户信息。
- 更新分组：在「订阅分组」菜单选择对应的更新订阅命令。尚无可用节点时，先尝试“不通过代理”更新；直连失败且已有可用连接时，再尝试“通过代理”更新。
- 核对结果：查看日志确认请求是否成功，再核对节点是否归入刚才的分组。空列表可能来自订阅过期、服务器返回空内容或格式不被当前版本识别。
- 设为活动节点：在服务器列表中右键目标节点，选择「设为活动服务器」。列表中有节点，不代表该节点已经成为当前出站。
V2Ray 协议选择应以提供方的节点参数和当前内核能力为依据。看到 VLESS 协议、VMess、TLS、传输类型等字段时，不要为了“优化”随意改动服务器地址、端口、用户标识或服务器名称；这些参数需要与服务端一致。订阅重新更新后，手动改过的节点也可能被替换。
- VLESS：协议本身不提供载荷加密，安全属性取决于 TLS 等配套机制；不能仅凭协议名称判断连接是否配置正确。
- VMess：应保持系统时间准确，时间明显偏差可能影响认证。不要把认证失败直接归结为本地代理端口。
- 内核适配：v2rayN 的界面与内核是不同层，内核不支持某种配置时，切换界面包本身通常不能解决问题。
四、系统代理与本地端口核对
确认活动节点后，在 v2rayN 的「系统代理」菜单选择「自动配置系统代理」，然后使用遵循系统代理设置的浏览器测试。这里修改的是 Windows 代理设置，并不保证所有程序都会使用它；终端工具、游戏或自行维护代理配置的应用，可能需要单独设置。
本地监听端口与远端服务器端口是两回事。下文用 127.0.0.1:10808 举例，但不同发行版和历史配置可能使用不同端口，也可能区分 HTTP、SOCKS 或混合监听。必须先确认该端口接受 HTTP 代理请求，才能照用下面的命令；不要把 SOCKS 专用端口填成 HTTP 代理。
curl.exe --proxy http://127.0.0.1:10808 --head --max-time 15 https://example.com/- 连接被拒绝：优先检查本地端口填错、内核未启动或监听失败，此时请求通常尚未到达远端节点。
- 超时或握手错误：结合内核日志检查远端连通性、认证、传输参数和系统时间，不能仅凭浏览器错误页定位。
- 收到 HTTP 响应：说明这次请求已获得响应，但不能据此认定全部域名或全部应用均已走代理。
这条命令显式指定代理，不依赖终端是否读取 Windows 系统代理。浏览器失败而命令成功时，应检查浏览器代理扩展、自定义代理与绕过规则；浏览器成功而终端失败时，应检查工具自身的代理选项或环境变量。日常不用代理时，先在客户端选择「清除系统代理」，再退出程序，避免 Windows 留着一个已停止监听的地址。
五、V2Ray 节点测速与访问验证
V2Ray 节点测速不能只看一个延迟数字。TCP 连接测试、实际请求测试和下载速度测试测量的对象不同：TCP 成功不一定代表认证成功，延迟低也不代表持续传输速度高。首次配置时，先在服务器列表右键菜单中选择名称含“真连接”或“延迟”的测试项，再用浏览器访问已知可达页面。
| 测试现象 | 可判断的范围 | 下一步 |
|---|---|---|
| TCP 测试成功，实际请求失败 | 服务器端口可能可达，认证和传输尚未证实 | 查用户参数、TLS 服务器名称及内核日志 |
| 实际请求成功，浏览器失败 | 节点可用，但应用代理链路可能不一致 | 查系统代理、浏览器扩展和绕过列表 |
| 部分域名可用，部分不可用 | 可能涉及路由、DNS 或目标站点限制 | 核对规则命中及目标域名解析结果 |
| 所有节点均提示本地监听失败 | 共同的本地环境比远端节点更值得检查 | 查端口占用、进程状态及文件权限 |
比较节点时，保持相同测试目标、路由模式和网络环境；先选少量候选测试，避免大量并发请求触发限流。下载测速可能产生明显流量消耗，存在订阅额度时应先查看提供方的计费说明。遇到偶发波动可重复测试，但不要把某一次结果写成节点的固定性能。
六、系统代理与 v2rayN TUN 模式
v2rayN TUN 模式通过虚拟网络接口接管符合规则的流量，覆盖面与系统代理不同。首次安装先把系统代理流程跑通，只有应用不遵循系统代理或需要更广的流量接管时，再考虑 TUN。这样能把节点问题与虚拟接口、路由和 DNS 问题分开。
按应用是否遵循系统代理选择
系统代理
- 从「系统代理」→「自动配置系统代理」开始。
- 适用于遵循系统代理的浏览器及应用。
- 通常不需要管理员权限启动主程序。
- 终端可用显式代理参数单独验证。
TUN 模式
- 先确认当前发行包的 TUN 支持及所需组件。
- 可能需要管理员权限、服务或虚拟接口。
- 启用后检查 DNS、路由与局域网访问。
- 故障时先关闭 TUN，对照系统代理测试。
选择依据是流量接管需求，不是哪个模式“更快”；切换时保留原配置，并一次只修改一个条件。
已有其他 VPN 或虚拟网卡时，TUN 可能受到默认路由、DNS 或接口优先级影响。不要同时启用多个接管工具后再修改所有路由设置。远程桌面环境尤其需要谨慎：更改路由可能中断当前连接，应先准备本地恢复方式，并明确如何关闭 TUN。
七、闪退、权限与端口占用排查
排错应从日志中的第一条有效错误开始。界面打不开、内核启动失败、订阅请求失败和网页失败是四类不同问题；“重新下载”并不能同时解释它们。先记录出错步骤、所选界面包、系统架构和错误文字，再执行下面的针对性操作。
双击后没窗口，是运行库缺失吗？
先看任务管理器中是否已有进程，检查托盘是否只是隐藏了窗口。若明确提示缺少框架，再按发行包要求安装匹配架构的运行环境；WPF 包提示 Desktop Runtime 时，普通 .NET Runtime 不能直接替代。没有提示时，可在 Windows「事件查看器」→「Windows 日志」→「应用程序」查对应时间的错误。
日志说端口被占用，怎么查？
在 PowerShell 执行下面的监听查询，用实际端口替换示例中的 10808。根据 PID 在任务管理器「详细信息」中定位进程；如果是重复启动的 v2rayN，正常关闭多余实例。不要直接结束不认识的系统进程。
放到英文目录就好了，原来目录不能用吗？
这只说明两次运行环境不同，不能单独证明中文字符有问题。继续比较目录权限、文件是否完整、是否位于同步盘，以及安全软件的处理记录；把日志里的具体路径错误作为判断依据。
是不是一直以管理员运行才稳？
普通系统代理通常不需要这样做。若日志提示无法写配置，先更换可写目录；若启用 TUN 需要提升权限，再按当前发行说明处理。提升权限不能修复订阅失效、远端超时或错误的认证参数。
主程序正常，内核文件却找不到？
确认完整解压，并检查 Windows「安全中心」→「病毒和威胁防护」→「保护历史记录」。发现拦截记录时，先核对文件来源与风险说明，不要直接关闭整套防护；同时确认所选包是否要求另行准备内核组件。
Get-NetTCPConnection -State Listen -LocalPort 10808 |
Select-Object LocalAddress, LocalPort, OwningProcess没有查询结果通常表示当时不存在该 TCP 监听；出现结果也要核对监听地址和进程，不能只看端口数字。更改本地端口后，保存设置并让内核重新加载，再重新配置系统代理；浏览器或终端里手写的代理地址也要同步修改。
八、升级前备份与完成检查
升级前正常退出 v2rayN，并确认相关内核进程已停止，然后备份原工作目录。Desktop 与 WPF 的配置迁移能力应以对应发行说明为准，不要默认任意两份目录可以相互覆盖。备份中可能包含订阅地址和节点凭据，应保存在私有位置，不上传公共网盘。
- 主程序：能启动、能正常退出，重新打开后设置仍可保存。
- 订阅：分组更新成功，活动节点明确，日志没有持续解析错误。
- 内核：本地监听成功，没有端口占用或缺失文件提示。
- 代理：浏览器和显式代理命令的结果可以相互对照，路由规则符合预期。
- 退出：停止使用时清除系统代理；启用过 TUN 时确认接口和路由恢复正常。
Windows 上的 V2Ray 客户端配置到这里，重点已经从“安装了哪个界面”转为“节点、内核、路由和应用是否一致”。如果还要在安卓设备使用同一服务，可从下载页查看 v2rayNG 下载入口或 v2flyNG；v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核，协议支持需分别确认。v2rayNG 订阅导入也需要独立更新，桌面端修改节点不会自动同步到另一台设备。