适合第一次在 Windows 使用 v2rayN，或准备从 WPF 版切换到桌面版的用户。先确认系统架构和软件包类型，再完成解压、运行环境检查、订阅导入与系统代理设置。排查时把“界面能否启动”“内核能否运行”“应用是否经过代理”分开验证，不把网页打不开一概归因于安装失败。
桌面版与 WPF 版怎么选
v2rayN 是管理服务器配置、订阅和路由规则的客户端界面，实际连接由它调用的代理内核处理。桌面版与 WPF 版首先是界面技术和使用方式的区别，不是两套服务器协议，也不是两种订阅服务。相同服务器能否连接，仍取决于所用内核、节点参数与网络条件。
桌面版
推荐采用跨平台界面。初次安装可从下载页的 Windows 桌面版入口开始，按当前软件包说明检查架构和运行环境。推荐依据是新用户的选择路径清晰，不代表连接速度必然高于 WPF 版。
适合:首次配置、希望熟悉跨平台界面的用户
WPF 版
采用经典 Windows 界面，适合已经熟悉原有菜单布局的用户。依赖要求以该包的发布说明与启动提示为准，不能因为界面看起来相近，就把旧目录里的程序和新包文件混用。
适合:习惯经典 Windows 界面、已有固定操作流程的用户
切换界面版本时，先在独立目录试运行。不要同时启动两份客户端，否则系统代理可能被反复改写，本地监听端口也可能冲突。确认新版本能导入配置并完成连接后，再处理旧目录；个人订阅地址和配置备份应保存在仅自己可访问的位置。
下载前检查系统架构与软件包
打开 Windows「设置」→「系统」→「系统信息」，查看“系统类型”。x64 与 ARM64 不是界面风格，而是处理器架构；选择时以下载页实际列出的软件包为准。没有对应架构选项时，不要凭文件名猜测兼容性。较旧系统也应先核对当前版本的系统要求，而不是反复重装同一个包。
| 检查项目 | 具体操作 | 避免的问题 |
|---|---|---|
| 处理器架构 | 在“系统类型”中确认 x64 或 ARM64，再对照下载页。 | 程序无法运行或依赖架构不匹配。 |
| 包的形式 | 压缩包使用“全部解压缩”；安装程序按向导完成安装。 | 把安装程序和免安装目录当成同一种处理。 |
| 运行环境 | 记录启动提示要求的 .NET 运行时类型、主版本和架构。 | 只安装 SDK 或装错运行时类型后仍无法启动。 |
| 内核文件 | 保留软件包目录结构，查看日志是否报告内核文件缺失。 | 只复制主程序导致界面可开、连接不可用。 |
如果启动窗口明确要求 .NET Desktop Runtime，就安装对应主版本和架构的桌面运行时；如果要求其他运行时，则按提示处理。WPF 使用桌面运行时，但不同发布包是否已包含依赖并不相同，不能给所有版本套用同一个固定版本号。没有缺失提示时，也不必为了“预防问题”额外安装一套开发工具。
解压与首次启动按顺序完成
-
获取软件包
进入客户端安装包页面，选择 Windows 下的 v2rayN 桌面版或 WPF 版。保存文件后先确认它是压缩包还是安装程序，再决定下一步。
-
完整解压
压缩包右键选择“全部解压缩”，可使用自己有写入权限的独立目录，例如
D:\Apps\v2rayN。不要在压缩文件预览窗口中直接双击运行，也不要只拖出一个可执行文件。 -
启动主程序
进入解压后的实际程序目录运行主程序。若提示缺少运行时，先处理依赖；若没有主窗口，检查任务栏通知区域，确认程序是否已经最小化到托盘。
-
检查本地设置
打开「设置」→「参数设置」，查看本地监听端口及相关开关。首次验证先保留 TUN 关闭，不同时引入虚拟网卡与系统代理两套接管方式。
-
创建快捷方式
确认程序能正常启动并保存设置后，再为主程序创建快捷方式。后续通过快捷方式启动，不移动主程序本体，也不把解压目录当作临时文件夹清理。
首次导入订阅区分地址与节点
订阅地址用于获取一组服务器配置，单条分享链接则描述一个节点。客户端安装完成后不会自动获得服务器；应使用自己有权访问的订阅或节点信息。订阅链接往往带有访问令牌，截图、日志和公开求助内容中都不应包含完整地址。
- 打开「订阅分组」→「订阅分组设置」，选择“添加”。填写便于识别的备注，在地址栏粘贴完整订阅链接，再保存。不同界面版本的添加入口可能显示为加号，操作含义相同。
- 回到主窗口，打开「订阅分组」菜单，首次可选择「更新全部订阅（不通过代理）」。没有可用节点时，不要先依赖“通过代理更新”来建立第一条连接。
- 更新后查看服务器列表。如果当前选中了其他分组或填写了搜索词，先切换至目标分组并清空筛选，避免把“没有显示”误判为“没有导入”。
- 选中需要使用的服务器，右键选择「设为活动服务器」。确认当前活动项已变化，再观察内核启动信息；仅把某一行选中，不一定等同于已切换活动服务器。
如果已有的是 vmess:// 或 vless:// 开头的单条分享链接，可复制后使用「服务器」→「从剪贴板导入分享链接」。不要把这类链接填进需要 HTTP 地址的订阅更新栏。菜单措辞会随版本调整，识别时重点区分“导入分享链接”和“更新订阅”。
系统代理与端口先验证浏览器
设置活动服务器后，还需要让应用把请求交给本地代理。通过托盘菜单或主窗口的「系统代理」入口，选择「自动配置系统代理」。路由先使用内置的“绕过大陆”类预设；具体名称以当前规则列表为准。系统代理负责应用入口，路由负责流量进入内核后走哪个出站，两者不能相互替代。
这些端口是本机应用连接客户端的入口，不是远端服务器端口。较新配置可能使用一个混合入口同时接受 HTTP 与 SOCKS 请求，旧配置也可能分开监听。不要照着教程额外启用一个并不存在的端口；以「设置」→「参数设置」和运行日志实际显示的监听信息为准。
首次连接检查
- 活动服务器
- 已通过右键菜单设为活动项
- 系统代理
- 自动配置系统代理
- TUN 模式
- 首次验证保持关闭
- 路由设置
- 先用内置预设，不叠加自定义规则
先让遵循系统代理的浏览器正常访问，再扩展到其他应用。
手动填写代理
- 服务器地址
127.0.0.1- 端口示例
10808，须与实际监听一致- 代理类型
- 按应用要求选择 HTTP 或 SOCKS5
- 监听范围
- 仅本机使用时保留回环监听
只有应用不读取系统代理、且提供独立代理设置时，才需要在应用内填写。
先用浏览器打开自己有权访问的网站，同时观察日志是否出现新的连接记录。浏览器能访问不代表所有程序都会走代理：有些程序忽略系统代理，或已有独立代理设置。遇到这种情况，优先检查该程序的网络设置，不要把“自动配置系统代理”理解成接管整台电脑的所有流量。
启动与连接故障分层排查
双击程序没反应，要重装吗？
先看托盘是否已有实例，再检查是否完整解压及是否出现运行时提示。若提示需要桌面运行时，核对主版本与 x64、ARM64 架构。不要在原目录反复覆盖不同界面版本，改用独立目录复现更容易定位问题。
有服务器列表，为什么内核起不来？
打开主窗口底部的日志或信息区域，查看是否报告文件不存在、配置不支持或端口占用。文件缺失时重新完整解压；若是协议或参数不支持，核对当前节点要求与所选内核，不要仅凭列表导入成功就认定配置有效。
提示端口被占用，应该改哪个？
先退出另一份客户端及其他代理程序。必要时运行 netstat -ano | findstr :10808 查看占用记录，再在任务管理器中按 PID 确认进程身份。只有确认需要更改时才调整本地监听端口，并同步更新手动填写代理的应用。
退出以后浏览器也打不开了？
重新启动客户端，先在「系统代理」中选择「清除系统代理」，再正常退出。如果程序无法启动，可在 Windows「设置」→「网络和 Internet」→「代理」检查“使用代理服务器”，移除本次遗留的本机代理；单位管理的设置应先向管理员确认。
证书错误也不宜用重装解决。先检查 Windows「设置」→「时间和语言」→「日期和时间」是否正确，再核对节点的服务器名称与 TLS 设置。保留证书验证，按日志定位具体字段；把“跳过证书验证”当成长期修复会失去必要的身份验证。
更新与日常使用保留可回退配置
首次运行成功后，记录所用界面类型、本地端口、路由预设和订阅分组名称即可，不需要公开完整服务器参数。后续升级仍从安装包页面确认软件包类型，先退出正在运行的客户端，再按对应包的更新方式处理。对于压缩包，新目录试运行比直接混合覆盖更容易排除旧文件残留。
- 备份前退出：完整退出客户端后再备份个人配置，减少写入过程中文件不一致的风险；备份含有订阅凭据，应限制访问。
- 升级后复核：检查活动服务器、监听端口、系统代理和路由是否符合预期，再测试浏览器访问，不仅看主窗口能否打开。
- 一次只改一项：切换界面、调整内核、启用 TUN 和修改 DNS 不要同时进行。每次改动后做一次连接验证，失败时才能明确回退哪一项。
- 退出先清代理：不再使用时先清除系统代理，再退出程序；开机启动则等手动连接稳定后再启用。
完成这些步骤后，基础链路应当清晰：应用连接本地监听入口，客户端按路由把请求交给对应出站，再由内核连接远端服务器。需要让不遵循系统代理的应用接入时，再阅读进阶配置中的 TUN 与路由说明；基础设置仍有疑问，可先查看疑难解答，不要用更多开关掩盖尚未定位的问题。