v2rayN使用教程：桌面安装、订阅管理与内核选择
v2rayN是桌面图形客户端，不是节点套餐。它可以围绕不同代理内核管理连接；使用时最容易混淆的是订阅分组、当前服务器、内核选择和系统代理这四件事。
内容与来源核对： · 机场巡查博客编辑整理
先确认这是桌面客户端，而不是v2rayNG
2dust项目说明列出Windows、Linux和macOS；Android的v2rayNG是另一个项目，不应从一个同名下载站获取所有系统安装包。维护和下载来源应同时核对项目主页、Releases与Wiki，普通用户先看稳定发布，而不是只按最大版本号选预发布。
项目支持Xray、sing-box等内核。VLESS、VMess、Trojan、Shadowsocks等协议是否能用，仍取决于所选内核、版本与配置参数。界面能显示一种协议名称，不代表任意扩展组合都支持。
安装之前，先选对发行包
在官方Releases核对系统、CPU架构、包说明以及是否需要另装运行环境。保留当前可用配置的备份，升级时不要让安装路径、数据目录和旧快捷方式混在一起。Linux还要核对发行版依赖，macOS要匹配芯片与当前系统要求。
- 从2dust/v2rayN仓库进入发布页，阅读该版本说明，下载匹配平台的包。
- 按发布文件介绍安装或解压，启动后记录界面版本与内核版本；缺依赖时只按项目文档处理。
- 暂不启用网络接管，先准备服务方提供且明确兼容的配置。
订阅分组、更新和活动服务器的顺序
订阅通常用于批量更新服务器记录；一条分享链接则可能只描述一个服务器。两者都不同于机场网页登录密码，且未必与Clash完整YAML互通。不要把服务官网首页填进订阅地址，也不要为适配格式把私人URL交给未知转换网站。
- 在订阅分组设置中新增一个可辨认的名称，填入服务方确认的URL并保存。
- 使用该版本的订阅更新功能，查看返回的服务器与错误；需要代理才能更新时，先确认有可用的既有连接，避免循环依赖。
- 在服务器列表中选定当前要使用的记录，核对适配内核；保留其他记录作对照。
- 选择适合的路由规则，再启用系统代理；在浏览器实际请求并看连接与日志。
系统代理与路由，分别解决不同问题
系统代理影响愿意读取系统设置的应用；路由决定已进入内核的请求交给哪个出口。终端、容器和自行设置代理的应用可能绕过系统设置，所以“图标已连接”不能作为所有应用已接管的证据。
| 现象 | 要看的位置 | 下一步 |
|---|---|---|
| 更新成功但节点全失败 | 账号、活动服务器与内核日志 | 分清配置下载和实际节点连接 |
| 浏览器正常，终端不通 | 终端是否使用当前代理 | 按该工具自己的配置说明核对 |
| 退出软件后网页打不开 | 系统代理是否指向停止的本地端口 | 正常退出并检查残留设置 |
示例：浏览器能用，开发工具却不走同一路径
假设浏览器打开目标正常，而某个开发工具超时，先确认二者是否读取相同的系统代理。部分工具有自己的环境变量、配置文件或内置网络实现；浏览器成功只提供一条对照，不证明客户端接管失败。
接着检查工具日志有没有出现目标请求。没有记录时处理应用接入；出现记录但命中不同规则时处理路由；到远端才失败时再查节点与目标。这样可避免在节点本来正常的情况下反复更新订阅。
- 记录浏览器、工具与客户端的版本及测试目标，确认软件来源。
- 保留工具原配置，按该工具自己的文档检查代理设置，不套用别的程序端口。
- 只调整一项后重试；成功时记下命中策略与配置，失败时保留准确错误再回退。
适合什么人，何时选择其他客户端
需要在桌面管理多组服务器、区分内核与路由的人，可以从v2rayN开始；已使用成熟Clash规则的人，应先比较规则迁移成本，而不是只追求换软件。跨设备相同配置的便利可了解Hiddify；需要底层JSON控制时再学习sing-box。
客户端不提供免费的可用节点。准备选择服务前，确认对方支持该客户端、内核和设备；仅有专用客户端的品牌不能默认导入v2rayN。
首次使用的验收表：每一步都留下一个可见结果
不要在同一次操作中既换内核又换路由。先确认发行包适配本机，再从一组授权配置建立最小可用连接；操作入口以当前Wiki为准，下面表格描述应看到的结果，而不是假定所有版本按钮完全相同。
| 阶段 | 应该确认的结果 | 失败时先检查 |
|---|---|---|
| 程序启动 | 界面与内核版本可辨认，没有缺组件错误 | 发布文件说明、架构与依赖 |
| 导入与更新 | 正确分组出现预期服务器，无解析错误 | 地址来源、格式、权限 |
| 活动服务器 | 当前选中记录与适配内核明确 | 没有只更新未选中，扩展参数受支持 |
| 路由与接入 | 目标应用请求出现在日志中 | 系统代理或应用自己的接入设置 |
| 真实任务 | 实际网站及所需功能正常 | 命中规则、远端响应和账号条件 |
升级或启动失败：保留版本与数据位置
发布页的包可能针对平台、架构、运行环境或便携需求分别提供。不要只按压缩包大小选择，也不要把新旧程序解压进同一目录后无法判断运行的是哪个版本。系统最低要求与内核构成可能变化，应以本次所选发布文件的说明为准。
恢复时先核对启动路径和数据目录，保留旧可用配置；涉及内核变化再查参数支持。不把降级旧软件作为长期安全方案，回退只是为确认变更来源，应再计划迁移到受支持版本。
常见问题
v2rayN能直接使用Clash YAML吗？
不要按后缀判断。先看所选内核、导入入口和项目明确支持的格式；需要转换时优先向服务方索取适配配置。
切换内核能解决全部超时吗？
只能解决部分兼容问题。服务器故障、过期凭证和当前网络路径异常仍需分别处理。
换电脑可以直接拷贝所有数据吗？
先核对新平台版本与数据位置，并保护配置凭证。系统代理、服务权限和本地路径不应盲目沿用。
技术资料与验证边界
依据公开项目文档、规范或原始研究整理。操作与排查建议是编辑分析，不是节点实测或服务器封锁鉴定；版本、平台分发和实际服务状态仍需复核。未采集订阅或账号，不提供未知安装包。