适合首次在 Windows 上使用 v2rayN，或更换电脑后需要重新配置的用户。按“确认系统架构 → 选择界面版本 → 完整解压 → 补齐运行依赖 → 导入订阅 → 设置系统代理”的顺序操作；启动失败时先查程序与运行库，界面正常但无法访问时再查内核、监听端口与节点，不必一开始就开启 TUN。
一、Windows 版本、处理器架构与安装包选择
先打开 Windows 的设置 → 系统 → 关于 → 系统类型。在常见的 Windows 10、Windows 11 电脑上，Intel 或 AMD 的 64 位处理器通常选择 x64 包；ARM 处理器电脑应优先查看下载页是否提供对应的 ARM64 包。不要仅凭电脑品牌判断架构，也不要把操作系统位数与客户端界面版本混为一谈。
v2rayN 是图形客户端，负责管理服务器、订阅、路由并调用代理内核运行。桌面版使用 Avalonia 界面框架，WPF 版采用 Windows 专属界面框架。两者不是节点协议的名称，选择 WPF 也不代表只能使用某一种协议。具体可用功能还受客户端版本、随包内核与节点参数影响。
| 选择项目 | 判断依据 | 操作建议 |
|---|---|---|
| 桌面版 | Avalonia 跨平台界面 | 选择 Windows 对应包，架构与系统类型匹配。 |
| WPF 版 | Windows 专属界面 | 习惯经典 Windows 界面时可选；按发布说明确认运行依赖。 |
| x64 / ARM64 | 系统类型中的处理器架构 | 优先使用原生架构包，并确认配套内核也能运行。 |
| 自包含 / 依赖运行库 | 安装包说明是否包含运行环境 | 自包含包通常体积更大；依赖运行库的包需另装指定环境。 |
选择结论：先匹配架构，再确认运行依赖
到下载页选择 Windows 包，记录所选版本与架构。只有出现明确的框架缺失提示时，再按提示补装对应运行库，不要用反复切换界面版本代替排查。
二、完整解压到可写目录
压缩包内的主程序、依赖文件和内核目录需要保持原有相对位置。直接在压缩软件里双击 v2rayN.exe，可能只临时释放部分文件，造成界面能打开但服务启动失败。建议使用当前账户可写、位置稳定的目录，例如 C:\Users\Public\Tools\v2rayN；若该目录受组织策略限制，就改用个人用户目录下的工具文件夹。
- 从客户端下载页获取所选 Windows 包，先完成下载，再执行“全部解压缩”。
- 打开解压后的目录，确认看到
v2rayN.exe及包内其他文件；不要只把主程序拖到桌面。 - 首次运行前，避免把目录放进压缩包、临时文件夹或需要额外写入权限的位置。
- 双击实际目录中的
v2rayN.exe。需要桌面入口时，为这个文件创建快捷方式，而不是复制文件本身。
遇到 Windows 安全提示时，先核对下载来源及文件来源信息。企业电脑上的拦截可能来自组织策略，应联系管理员确认。不要把关闭系统防护或给整个下载目录添加排除项当成通用安装步骤。
三、首次运行与 .NET 运行库依赖
第一次启动先看“界面是否打开”，再看“代理内核是否启动”。这两个阶段需要分开检查：主界面打不开，通常先查架构、依赖和文件完整解压情况；主界面正常但日志提示内核文件不存在，则应检查安装包内容、内核路径和安全软件记录。
- 提示安装 .NET：展开错误详情，记录要求的框架名称、主版本与架构。不同 v2rayN 发布版本的要求可能变化，不要沿用旧教程里固定的运行库版本号。
- WPF 版提示 Windows Desktop 框架缺失：安装匹配的 .NET Desktop Runtime。仅安装普通 .NET Runtime 不一定满足桌面框架依赖。
- 已装运行库仍提示缺失：核对 x64 与 ARM64 是否一致，以及主版本是否满足要求。装有较新的主版本不代表一定能替代程序要求的旧主版本。
- 使用自包含包：通常不需要单独补装其包含的 .NET 环境，但仍需符合该包的系统要求，并保留配套文件。
普通系统代理模式一般不需要始终以管理员身份运行。首次排查先使用普通账户启动；只有明确启用需要额外权限的功能时，再按客户端提示授权。把“管理员运行”作为所有问题的默认解法，容易掩盖目录权限或文件缺失的真实原因。
四、订阅导入、节点选择与系统代理
客户端打开后不会自动获得可用服务器。订阅是提供服务器配置的地址，VMess、VLESS 等是节点使用的协议；两者不是同一层概念。应使用服务提供方给出的客户端兼容订阅地址，而不是账户后台页面地址。
- 打开
订阅分组 → 订阅分组设置，新增分组，填写容易辨认的备注和完整订阅地址后保存。 - 在
订阅分组菜单执行更新全部订阅。若当前界面区分直连与通过代理更新，先按订阅地址的实际可达情况选择；首次尚无可用节点时，不要依赖一个无法工作的代理更新订阅。 - 确认服务器列表出现节点，再选择一个节点并设为活动服务器。不同版本可通过右键菜单或对应的设为活动服务器操作完成。
- 查看底部日志，确认服务启动，没有监听失败或配置加载错误。
- 在主界面底栏或托盘的
系统代理菜单选择自动配置系统代理，再打开浏览器测试。入口位置随界面版本略有差异。 - 按需要在
路由设置选择绕过大陆（Whitelist）等规则。系统代理决定应用是否把请求送入客户端，路由规则决定进入客户端后的请求走向。
五、本地端口与 Windows 代理状态核对
以下数字用于说明本地连接关系，不代表所有 v2rayN 版本都采用相同默认值。实际端口请到设置 → 参数设置中查看本地监听相关选项；部分版本把相关项目放在Core 基础设置中。较新的配置可能使用一个混合端口，旧配置则可能分别提供 SOCKS 与 HTTP 监听。
如果某个应用要求单独填写 HTTP 代理，应使用客户端实际提供的 HTTP 或混合监听端口，不能把只支持 SOCKS 的端口当成 HTTP 端口。也不要把远端节点的服务器端口填到 Windows 的本地代理设置里。
出现端口占用时，在命令提示符执行下面的只读查询。重点看本地地址列是否为该端口、状态是否为 LISTENING，以及行尾 PID；匹配到远端地址中的同一数字，不等于本地端口被占用。
netstat -ano | findstr ":10808"然后在任务管理器的“详细信息”页按 PID 找到进程。若是另一个 v2rayN 实例，先从其托盘菜单退出；若是需要保留的程序，可把本地监听改为未使用的端口，例如确认空闲后的 10818，保存并重启服务。重新应用系统代理，同时修改浏览器扩展或其他应用里手工填写的旧端口，不要盲目结束不认识的系统进程。
六、首次启动常见报错与处理顺序
下列原文可能出现在弹窗、客户端日志或内核日志中，周围文字会随版本变化。先记录完整错误与发生时间，再按对应层级处理；不要仅凭“打不开网页”判断安装包有问题。
报错：You must install or update .NET to run this application.
原因与解法：程序要求的 .NET 框架或架构未满足。查看弹窗中的 Framework 与 Architecture，安装对应运行环境后重新启动；若要求 Windows Desktop 框架，选择对应 Desktop Runtime。
报错：This app can't run on your PC
原因与解法：可能存在系统架构不匹配、系统版本不满足要求或程序文件损坏。回到“设置 → 系统 → 关于”核对系统类型，重新选择支持当前系统的安装包并完整解压。
报错：Only one usage of each socket address (protocol/network address/port) is normally permitted.
原因与解法：通常是监听地址与端口已被其他进程占用。根据错误里的端口查询 PID，退出重复实例，或修改本地监听端口并同步应用代理设置。
报错：An attempt was made to access a socket in a way forbidden by its access permissions.
原因与解法：端口绑定受到权限、端口保留范围或安全策略限制。先确认没有重复监听，再用 netsh interface ipv4 show excludedportrange protocol=tcp 查看 TCP 排除范围，选择允许且空闲的端口，不要直接删除系统保留项。
报错：connectex: No connection could be made because the target machine actively refused it.
原因与解法：目标连接被拒绝。先看错误里的目标地址：若是 127.0.0.1，检查本地内核是否监听及代理端口是否一致；若是远端服务器，则核对节点地址、服务端口和服务状态。
若客户端提示找不到内核文件，先退出程序，检查是否误把单独的主程序当成完整安装目录，或下载了需要另外准备内核的包。再查看 Windows 安全中心的保护历史记录，确认是否发生文件隔离。只有核实来源和具体文件后再处理，不要直接恢复所有被拦截项目。
七、安装后的常见问题
安装完没有桌面图标，是不是没装成功？
压缩包分发的版本不一定创建系统安装记录或桌面入口。先在完整解压目录运行 v2rayN.exe，确认能打开后再创建快捷方式；不要因为没有图标就重复解压多份并同时启动。
界面能打开，订阅更新后还是没有节点怎么办？
进入“订阅分组 → 订阅分组设置”核对地址是否完整，再看更新日志是超时、认证失败还是解析失败。订阅返回登录页面时，需要换成提供方给出的订阅地址；超时则先确认更新使用的网络路径是否可达。
节点测试有结果，浏览器为什么仍打不开？
先确认该节点已设为活动服务器，再选择“系统代理 → 自动配置系统代理”。打开 Windows“设置 → 网络和 Internet → 代理”，核对代理是否指向当前本地监听；同时检查浏览器是否使用了独立代理配置。单次延迟测试不代表所有目标网站都能访问。
退出 v2rayN 后，电脑反而无法联网了？
可能是 Windows 仍指向已经停止的本地代理。重新启动客户端，执行“系统代理 → 清除系统代理”后再退出；也可在 Windows 代理设置中检查手动代理。若原先使用组织提供的代理，先记录并恢复组织配置，不要直接清空。
应该一开始就开启开机启动和 TUN 吗？
先完成一次普通启动、订阅更新、节点连接与退出后的联网恢复。基础链路确认正常后，再逐项启用开机启动或 TUN，每次只改一个设置，便于在出现异常时回到已验证的状态。
需要进一步排查时，保留 Windows 系统类型、v2rayN 版本、所选界面版本、错误原文和本地监听端口即可。分享日志前遮盖订阅地址、用户标识与认证参数。按“程序启动 → 内核运行 → 本地监听 → 应用代理 → 远端节点”的顺序检查，比同时更换安装包、端口和路由更容易定位问题。