适合第一次在 Windows 上配置 v2rayN，或遇到程序打不开、订阅为空、浏览器仍不走代理的用户。先选对界面与架构，再完成安装或完整解压；按“程序启动 → 订阅更新 → 选择服务器 → 系统代理 → 按需启用 TUN”的顺序验证。每次只改一个环节，避免把运行库、订阅网络和路由问题混在一起。
一、安装包：先分清桌面版与 WPF
v2rayN 是客户端界面，负责管理服务器配置、调用核心并调整代理入口。安装成功不等于已经具备可用服务器；后续仍需导入有效配置或订阅。Windows 用户可以按界面习惯选择桌面版或 WPF 版，不要把两者当成不同的订阅服务。
桌面版（Avalonia）
推荐采用跨平台界面。首次使用、没有旧界面操作习惯时，可先从这一版开始；安装包的架构和系统要求仍需单独确认。
适合：首次配置，或希望保持跨桌面系统操作习惯的用户。
WPF 版
采用 Windows 桌面界面。熟悉经典菜单布局时可选这一版；它不是为了让同一个节点自动获得更低延迟。
适合：主要使用 Windows，且已经熟悉经典界面的用户。
先打开 Windows「设置」→「系统」→「系统信息」，查看“系统类型”。常见 Intel、AMD 的 64 位电脑选 x64 包；若显示基于 ARM 的处理器，先核对下载页是否提供合适构建及相应运行条件，不要仅凭“64 位”三个字判断兼容性。旧版 Windows 也应先核对当前包的最低系统要求。
- 可执行安装包：按安装向导操作，不要把安装程序本身当成需要解压的便携压缩包。
- 压缩包：先“全部解压”，再从解压后的目录启动，不能在压缩软件预览窗口里直接双击运行。
- 切换界面：先备份现有配置，再使用独立目录验证；不要直接把两种发行包叠加覆盖。
二、目录与运行库：先让程序稳定启动
使用压缩包时，可选择当前账户有写入权限的独立目录，例如 D:\Tools\v2rayN；没有 D 盘也可以放在用户目录下。关键不是盘符，而是程序能保存配置、日志和更新文件。系统目录、临时目录以及会自动同步或清理的目录，都不适合用作长期运行位置。
-
完整解压
在资源管理器中对压缩包选择「全部解压」，保留包内目录结构。不要只拖出
v2rayN.exe；核心、依赖及资源文件也可能是运行必需项。 -
核对依赖
首次启动若提示缺少 .NET，记录对话框里的运行时名称、主版本和架构。WPF 构建通常需要对应的 .NET Desktop Runtime；只装 SDK 或 ASP.NET Core Runtime 不一定能满足要求。
-
检查拦截
打开「Windows 安全中心」→「病毒和威胁防护」→「保护历史记录」，检查是否有相关文件被隔离。先确认来源与具体告警，不要用关闭整体防护代替排查。
-
首次启动
运行主程序，确认窗口可以打开、配置可以保存，并检查日志是否提示核心文件缺失。普通系统代理模式先以普通权限使用，暂时不要开启 TUN。
-
保存入口
确认运行正常后，为实际程序创建快捷方式。后续移动整个目录时同步更新快捷方式，避免桌面图标仍指向旧版本。
三、导入订阅：保存地址后还要更新
订阅地址是客户端获取配置列表的入口，不是普通网站首页，也不等同于一条 vmess:// 或 vless:// 分享链接。拿到地址后先确认复制完整，没有换行、空格或聊天软件附加的标点。订阅通常带有访问凭据，截图和求助时要遮住完整地址。
以下使用常见中文菜单名称说明；不同界面版本可能在按钮位置或“通过代理”的括号标注上略有区别，应按同名功能操作，不要为了找相同图标而切换到来历不明的旧包。
- 打开主界面「订阅分组」→「订阅分组设置」，新增一组，填写备注和「地址（URL）」，确认启用后保存。
- 返回「订阅分组」，选择「更新全部订阅（不通过代理）」完成首次尝试。此时尚未建立可用代理，先测试直连更新更容易判断问题。
- 更新后选中对应分组，检查服务器列表是否出现条目。若日志显示成功但列表为空，先排除分组筛选，再检查订阅返回内容是否为客户端支持的格式。
- 在列表中选中一个条目，通过右键菜单「设为活动服务器」将其设为当前使用项，再查看核心是否正常启动。
如果订阅站点只能经代理访问，且已有可用服务器，可以改用「更新全部订阅（通过代理）」。这不是所有订阅更新失败的通用修复：没有可用服务器时强行走代理，反而会形成“需要更新才能连接、需要连接才能更新”的循环。单条分享链接则使用「服务器」→「从剪贴板导入批量 URL」，不要填进订阅地址栏。
四、系统代理：先验证浏览器这一条链路
选中服务器以后，在主界面或托盘菜单的「系统代理」中选择「自动配置系统代理」。这里的“自动配置”是 v2rayN 的菜单动作，不代表浏览器一定在使用 PAC。随后检查 Windows「设置」→「网络和 Internet」→「代理」，确认代理地址与本地监听端口相符。
打开「设置」→「参数设置」，查看本地监听或入站设置，记下实际端口。部分版本使用混合监听入口，旧配置也可能分开设置 HTTP 与 SOCKS；不能照搬别人的端口截图。系统代理指向的入口必须接受 HTTP 代理请求，不能误填一个仅支持 SOCKS 的端口。
| 看到的现象 | 优先检查 | 下一步操作 |
|---|---|---|
| 所有浏览器都报代理连接失败 | 本地核心是否启动，端口是否匹配 | 先读核心日志，确认监听成功后再测试网页 |
| 浏览器可用，某个应用不可用 | 该应用是否读取系统代理 | 检查应用自身代理设置，再评估 TUN |
| 部分网站直连，部分走代理 | 当前路由规则和匹配出站 | 查看访问日志，不要仅凭出口变化判断代理失效 |
| 关闭客户端后网页也打不开 | Windows 是否保留了本地代理地址 | 重新打开客户端清除系统代理，或关闭残留的手动代理 |
系统代理只影响愿意读取它的应用，也不等于“所有流量都走代理”。即使应用进入核心，路由规则仍可把部分目标交给直连出站。初次验证应选一个自己有权访问、响应稳定的 HTTPS 页面，并结合日志判断请求是否真正到达核心。
五、TUN：按应用需求升级接管范围
TUN 通过虚拟网络接口接收流量，适合不读取系统代理的应用，但也会增加路由、DNS 和权限方面的变量。先证明订阅和服务器能正常使用，再开启 TUN，才能区分“服务器本来就不可用”和“本机接管设置有冲突”。
选择方案：先系统代理，再按需启用 TUN
系统代理优先
- 主要需求是浏览器及支持代理的桌面应用。
- 普通权限即可先验证，排查路径较短。
- 应用是否接入，取决于它是否读取系统代理。
TUN 按需启用
- 目标应用不读取系统代理，且没有合适的手动入口。
- 按客户端提示处理管理员权限或服务权限。
- 启用后检查 DNS、路由及其他虚拟网卡的冲突。
TUN 扩大的是流量接入范围，不会自动把所有路由改成代理，也不能修复错误的服务器参数。
第一次开启主界面「启用 TUN」时，先保存工作，按提示处理提权。为了减少变量，可先在「系统代理」中选择「清除系统代理」，单独验证 TUN；两者不一定互斥，但入门排查时没必要同时改变两套入口。若公司网络或其他连接工具依赖特定虚拟网卡，应先确认使用限制，不要随意删除网卡或重置整机网络。
- 开启后域名打不开：检查核心日志里的 DNS 错误，以及当前 DNS 配置是否形成循环，不要把服务器域名随意改成不明 IP。
- 局域网设备无法访问：检查私有网段的路由策略，按实际需要配置直连，不要直接关闭所有分流规则。
- 关闭后仍异常：先退出客户端，再检查残留系统代理和其他网络软件。必要时正常重启，让网络状态重新建立。
六、常见卡点：按现象定位，不反复重装
重装界面通常解决不了订阅过期、端口占用或传输参数不匹配。求助前记录界面版本、Windows 版本、使用的模式和一小段相关日志；删去订阅凭据、服务器认证信息和个人目录。下面几类问题可以先自行缩小范围。
双击后没窗口，是程序坏了吗？
先看任务栏托盘，确认是否已启动并缩到后台；再检查任务管理器是否存在旧进程。确实没有进程时，检查运行库提示和保护历史记录。不要连续双击启动多个实例，否则还可能引出端口冲突。
订阅更新成功，怎么还是不能上网？
更新成功只说明取回并解析了配置。先设定活动服务器，再开启系统代理，随后检查核心日志。还要打开「设置」→「时间和语言」→「日期和时间」，确认系统时间正确；TLS 证书验证等过程依赖准确时间。
日志说地址已被占用，要换端口吗？
先查占用进程，优先退出重复启动的旧实例。确需更改端口时，在「设置」→「参数设置」修改实际入站端口，重启核心，再重新应用系统代理；手动配置了代理的应用也要同步修改。
切换核心能修复所有超时吗？
不能。先核对配置要求的协议、传输、TLS 服务器名称及相关字段，确认所选核心支持该组合。VLESS 与 VMess 不是可随意互换的标签；不要为消除错误而关闭证书验证，也不要擅自改写服务端指定的传输路径。
端口占用的最小检查
如果本机实际监听端口就是 10808，可在命令提示符执行下列命令。若使用其他端口，先替换数字。关注状态为 LISTENING 的行及末尾 PID，再到「任务管理器」→「详细信息」核对进程；不要看到一个 PID 就直接终止未知系统进程。
netstat -ano | findstr ":10808"若本地监听正常，而日志显示远端连接超时，再检查服务器地址、端口、网络可达性及提供方状态。延迟测试结果也不能单独证明浏览器请求已经经过代理，完整验证仍需要应用访问与核心日志相互印证。
七、退出与更新：保留能回退的配置
安装完成后，建议保持一份已验证可用的配置备份。配置文件可能包含订阅地址和认证参数，应存放在可信位置；不要把整个程序目录直接上传到公开空间。更新时先退出客户端并确认相关进程结束，避免文件正在占用导致只更新了一半。
- 正常退出：先关闭 TUN，再清除系统代理，最后从托盘退出。仅关闭窗口可能只是最小化，不能据此判断核心已停止。
- 版本更新：使用对应发行方式完成更新。压缩包先解压到新目录核对完整性，再按版本说明迁移必要配置，不要混用旧核心与新界面文件。
- 回退验证：保留原配置备份，但不要同时启动新旧两套程序。若更新后异常，先比较核心启动日志和监听端口，再决定是否恢复。
最短的稳定路径是：程序能启动，订阅能更新，活动服务器能连接，系统代理能被目标应用使用。只有最后一项不满足时，再考虑 TUN。按这个顺序配置，遇到问题时就能知道该查哪一层，而不是从头重装。