Windows 配置顺序：先按系统架构选择桌面版或 WPF 版，再完成解压、订阅更新与活动服务器选择，最后验证本地代理、系统代理和路由。本文适合首次安装与迁移配置的用户；端口均按明确示例说明，不把示例值当作所有版本的默认值，也不以开启 TUN 代替基础连通性检查。
版本选择：桌面版与 WPF 版的区别
界面选择：v2rayN 的桌面版采用跨平台界面，WPF 版面向 Windows 并保留经典桌面交互。两者首先是界面与运行环境的区别，不代表某个界面能自动改善节点速度。实际连接取决于节点配置、所选内核、网络与服务端状态。
桌面版
推荐首次安装：优先按下载页的 Windows 架构说明选择桌面版，沿当前界面的订阅、系统代理与路由入口完成配置。推荐理由是便于从当前桌面交互开始学习，而不是协议或速度优势。
适合：首次配置、希望采用跨平台桌面交互的用户。
WPF 版
习惯延续：已经熟悉经典 Windows 界面、希望沿用原有操作方式时选择。安装前仍需核对包内是否包含所需运行环境，不能仅凭 WPF 名称判断是否需要另装依赖。
适合：熟悉经典界面、按 Windows 既有工作流程维护配置的用户。
架构核对：在 Windows「设置」→「系统」→「系统信息」查看“系统类型”。常规 Intel 或 AMD 的 64 位设备选 x64，ARM 设备优先选下载页列出的 ARM64 包。不要把“64 位”直接等同于 x64，也不要因界面能启动就忽略内核可执行文件的架构要求。
下载运行：先建立可写的程序目录
文件准备：从本站安装包页面选择 Windows 对应包。压缩包需要完整解压，安装型程序则按安装向导完成；不要在压缩软件的预览窗口中直接双击主程序，否则内核、数据文件和相对路径可能无法正常读取。
-
确认架构
系统信息：打开「设置」→「系统」→「系统信息」，记录系统类型，再选择相符的桌面版或 WPF 版安装包。
-
完整解压
目录权限：压缩包可解压到用户可写的独立目录，例如
D:\Tools\v2rayN；不要只复制主程序，也不要混入旧版本的内核文件。 -
首次启动
程序入口：在解压目录运行
v2rayN.exe。若报缺少运行环境或无法加载文件，先处理启动错误，再进行订阅配置。 -
保留日志
排查依据：确认主界面能显示并查看日志。首次验证先不启用 TUN，也不同时运行另一份 v2rayN，避免端口冲突与代理设置互相覆盖。
权限边界：普通系统代理使用通常不要求始终以管理员身份运行。TUN 涉及虚拟网卡或相关服务时，按当前版本提示处理权限；不要为了绕过一次报错就长期关闭系统防护。遇到组织设备的权限限制，应先确认管理策略。
订阅导入：分清更新链接与连接节点
订阅入口：主界面「订阅分组」→「订阅分组设置」，新增分组并填写便于识别的备注，在订阅地址字段粘贴完整链接，保存后返回主界面。订阅地址通常包含访问令牌，不应放进截图、公开工单或聊天群。
更新顺序：在「订阅分组」菜单先执行“不通过代理”的订阅更新。若订阅源只能通过代理访问，必须先有一个已验证可用的节点，再选择“通过代理”的更新方式；只有订阅地址、尚无可用节点时，勾选代理更新并不能自动建立连接。
- 列表为空：查看更新日志，区分请求失败与格式解析失败。返回登录页面、订阅已失效、复制时多带空格，都可能导致无法生成节点列表。
- 单条链接：若取得的是
vmess://或vless://节点分享链接，应使用「服务器」→「从剪贴板导入批量 URL」等对应导入入口，而不是当作订阅更新地址。 - 活动服务器：导入后选择一个节点，右键设为活动服务器，并确认主界面的活动项已改变。列表中出现节点不等于已经切换到该节点。
- 自动更新：在「订阅分组设置」中检查当前版本提供的自动更新字段及其单位。频繁更新不会提升连接速度，更新失败时优先查链接与更新所用网络路径。
配置留存：手动添加的节点与订阅节点尽量分开管理。更新订阅可能重建该分组内的条目，直接修改订阅生成的节点参数后，下次更新可能被覆盖；需要临时试验时，先复制到独立分组并记录原值。
内核与节点：先核对字段，再启动连接
内核匹配：v2rayN 是管理界面，具体协议由内核执行。检查「设置」→「参数设置」中的 Core 类型相关配置，并以启动日志显示的实际内核为准。VLESS 与 REALITY 配置应使用支持相应功能的 Xray 内核；不要将客户端名称、协议名称和内核名称混为一谈。
VLESS + REALITY 核对项
- 内核
- 支持对应配置的 Xray
- 服务器端口
- 按服务端提供值填写
- serverName
- 按服务端提供的名称填写
- 公钥与 shortId
- 与服务端要求对应
- flow
- 仅在服务端要求时使用 xtls-rprx-vision
字段一致：不要随意改动订阅带入的传输、安全层与指纹配置；同一协议名称不代表所有节点的参数相同。
VMess + WebSocket + TLS 核对项
- 用户 ID
- 与服务端配置一致
- 传输
- WebSocket
- 路径
- 按服务端路径填写，区分大小写
- Host
- 按反向代理或服务端要求填写
- TLS 名称
- 与证书及服务端要求匹配
名称区别：连接地址、WebSocket Host 与 TLS serverName 可以不同，但必须分别满足服务端设计，不能机械地全部填成同一个值。
时间同步：在 Windows「设置」→「时间和语言」→「日期和时间」确认系统时间准确，并执行同步。时钟偏差可能影响证书有效期判断及部分协议认证；遇到 TLS 报错应先查时间、名称和证书链，而不是直接开启跳过证书验证。
系统代理：用明确端口验证本地入口
本地入口：进入「设置」→「参数设置」，检查基础设置中的本地监听端口以及允许局域网连接等选项。下面用 127.0.0.1:10808 作为已配置的本地混合入站示例，只有确认该入站支持 HTTP 与 SOCKS 后，才能分别用于相应测试；实际值以当前配置与启动日志为准。
代理启用：确认内核成功启动后，在主界面底部或托盘菜单的「系统代理」中选择「自动配置系统代理」。这一步修改 Windows 的代理设置，主要作用于遵循该设置的应用；命令行工具、游戏或独立网络组件可能需要单独配置，并非所有流量都会自动进入代理。
# PowerShell：检查示例本地端口是否已有监听
Test-NetConnection -ComputerName 127.0.0.1 -Port 10808
# 在系统提供 curl.exe、且该端口支持 HTTP 代理时测试
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 --head https://v2raymark.com/结果解读：TcpTestSucceeded 为 True 只说明该端口能建立 TCP 连接，不能证明节点可用，甚至可能是其他进程占用了端口。上述请求返回 HTTP 状态说明请求得到了响应，但仍需结合路由和日志确认是否经过远程节点；按规则直连时也可能成功。
- 端口拒绝：先查看内核是否退出、配置是否生成失败，或监听端口是否与示例不同。
- 显式代理成功：若命令成功但浏览器失败，检查浏览器自身代理设置、扩展与 Windows 系统代理是否冲突。
- 网络暴露：仅供本机使用时，不要为排错随意开启“允许来自局域网的连接”，更不要直接将代理监听暴露到公网。
路由与 TUN：基础连接成功后再扩展范围
路由选择：在主界面「路由」入口选择符合用途的规则，再到「设置」→「路由设置」检查具体内容。规则通常按顺序匹配，前面的命中可能使后面的规则不再生效；“绕过局域网”“直连”和“代理”描述的是流量去向，不是节点质量等级。
| 配置层 | 决定什么 | 首轮检查 |
|---|---|---|
| 系统代理 | 遵循系统设置的应用是否将请求交给本地代理 | 浏览器与 Windows 代理设置是否一致 |
| 路由规则 | 已进入内核的流量走直连、代理或阻断 | 匹配顺序、目标域名与最终出站 |
| DNS | 域名如何解析，以及规则能获得哪些域名信息 | 解析路径是否与预期出站配合 |
| TUN | 通过虚拟网卡接管符合配置的网络流量 | 权限、网卡、路由及 DNS 接管状态 |
TUN 时机：确实需要接管不遵循系统代理的应用时再启用。建议先关闭 TUN，确认一个活动节点经显式代理能正常访问，再启用 TUN 并测试目标应用；这样能把节点问题与虚拟网卡、DNS、系统路由问题分开。
分流验证：访问普通网页正常，不代表所有域名都走同一出站。遇到“部分能开、部分不能开”，先确认目标域名命中了哪条规则，再检查 DNS 与远程连接日志。不要同时更改 DNS、路由、内核和节点，否则难以判断是哪项修改产生作用。
- 局域网访问：需要访问打印机、共享目录或本地服务时，核对私有网段是否按预期绕过代理。
- 域名分流：IP 规则与域名规则依赖的信息不同，不能只看规则名称就认定匹配结果。
- 配置深入：需要调整 DNS 或规则顺序时，可继续阅读高级用法，先理解规则字段再修改。
常见故障：按现象定位，保留恢复路径
排错顺序：先确认程序与内核正常运行，再检查本地端口、订阅内容、活动服务器、系统代理及路由。日志中的“连接被拒绝”“超时”“TLS 握手失败”属于不同阶段，不能统一用“重装客户端”处理。
双击主程序没有窗口，是否应该重复启动？
订阅更新成功，但所有网页仍然打不开怎么办？
关闭 v2rayN 后，浏览器反而无法访问网络怎么办？
升级时能否直接覆盖正在运行的目录？
完成标准：客户端能启动、订阅能解析、活动服务器明确、本地入站可达、目标请求按预期出站，才算完成安装配置。后续记录界面类型、系统架构、所用内核与改动过的字段即可；求助时对订阅地址、用户 ID 和其他敏感配置做遮盖。