v2rayN 使用教程

本教程假设客户端已经完成安装，并且手上有来源明确、仍在有效期内的订阅地址。订阅地址由对应服务提供方生成，不是客户端自动创建的内容。v2rayN 或 v2rayNG 负责读取地址中的配置，再把配置交给相应内核建立连接。如果只有单个分享链接，也可以使用客户端的“从剪贴板导入”功能，但不要把单个链接误当成可更新的订阅分组。

配置前先关闭其他正在修改系统代理或建立 VPN 接管的程序。多个工具同时工作时，浏览器可能读取到旧代理，系统路由也可能被后启动的程序覆盖。暂时退出这些程序并不代表以后不能共存，只是为了让首次验证只有一个变量。还应确认设备日期、时间和时区准确；连接所用的 TLS 或 REALITY 参数可能受系统时间偏差影响。

建议先保存当前网络状态：记住系统代理原本是否开启、浏览器是否使用独立代理、DNS 是否手动指定。不要在第一轮操作中同时修改路由规则、DNS、TUN 和内核参数。基础连接验证通过后，再按实际需求逐项调整。需要了解不同平台安装位置、权限和架构选择时，可阅读全平台指南的通用准备章节。

在 v2rayN 桌面端添加订阅

先复制完整订阅地址，注意不要带上聊天软件自动添加的空格或换行。打开 v2rayN 主窗口，在顶部菜单中找到“订阅分组”或名称相近的订阅管理入口，然后进入订阅分组设置。新增一条记录，为它填写便于辨认的备注，再把地址粘贴到 URL 一栏。备注只用于本地识别，不会改变连接参数。

保存后回到主窗口，再次打开订阅相关菜单，执行“更新全部订阅”或针对刚才分组的更新操作。正常情况下，更新完成后主列表会出现该分组包含的节点。此时先看列表是否确实发生变化，并确认节点名称、类型等基本字段可以显示。只看到“保存成功”并不等于订阅内容已经下载，必须完成更新这一步。

在 v2rayNG 安卓端添加订阅

打开 v2rayNG 后进入订阅设置，通过右上角新增入口创建订阅。填写备注并粘贴地址，保存后返回订阅列表，执行更新。不同版本的菜单文字可能略有变化，但需要完成的动作仍是“保存地址”和“主动更新”两段。更新成功后返回配置列表，应该能看到新导入的配置项。

如果剪贴板里是单个 vmess、vless 或其他分享链接，可以从右上角菜单选择“从剪贴板导入”。单链接导入通常只生成一条本地配置，之后不会像订阅那样批量更新。需要长期维护多个节点时，应优先使用订阅管理；临时测试一条参数时，再使用剪贴板导入。

更新后没有出现节点时怎么检查

先重新打开订阅设置，确认 URL 没有被截断，也没有把备注文字一起粘贴进去。随后再次执行更新并查看提示或日志。如果显示请求失败，问题通常发生在订阅地址访问阶段；如果提示解析失败，则可能是返回内容格式不被当前客户端识别。此时不要连续新建多个相同分组，否则之后会出现重复节点，增加排查难度。

还应区分“订阅更新成功”和“节点可以连接”。更新成功只表示客户端读取并解析了配置，尚未验证远端地址、端口、协议参数和网络路径。看到节点列表后，先不要急着改 DNS 或路由，直接进入下一步选择代理模式。订阅分组维护、重复节点处理和更新失败的系统说明可转到配置常见问题。

桌面端先从系统代理开始

对大多数首次使用 v2rayN 的桌面用户，先选择系统代理更容易观察结果。系统代理会把代理地址写入操作系统设置，浏览器和其他遵循系统设置的应用通常会读取它。打开 v2rayN 的“系统代理”菜单，选择“自动配置系统代理”或当前版本中作用相同的选项。菜单里还可能看到“清除系统代理”和“不改变系统代理”，它们分别用于移除当前设置或让客户端保持系统状态不变。

系统代理并不保证接管每一个应用。部分程序使用自己的网络栈，部分游戏或命令行工具会忽略系统设置，还有些浏览器可能配置了独立代理。遇到某个应用没有流量时，不能只根据其他网页可以打开就认定该应用也已接管。先完成浏览器验证，再根据应用范围决定是否需要 TUN。

需要更广接管范围时再考虑 TUN

TUN 通过虚拟网络接口处理流量，接管范围通常比系统代理更广，但也会增加权限、路由和 DNS 方面的前置条件。启用前先确认 v2rayN 能以所需权限运行，并保留原来的系统代理状态。第一次切换到 TUN 时，建议先清除系统代理，再启用 TUN，避免两个入口同时存在而难以判断流量实际经过哪条路径。

如果 TUN 开启后立刻出现本地网络访问异常，不要继续叠加修改 DNS 或路由规则。先关闭 TUN，确认网络恢复，再查看日志中是否有虚拟接口创建、权限或路由写入失败的提示。关于虚拟接口权限、局域网访问和路由边界的完整说明属于系统配置内容，可阅读Windows 安装配置章节或Linux 安装配置章节。

安卓端确认系统授权

v2rayNG 在开始连接时会请求系统 VPN 授权。首次出现授权窗口时，需要确认后才能建立接管；如果拒绝，客户端即使保留了节点配置，也无法把应用流量送入连接。设备上如果已有其他 VPN 连接，应先停止原连接，再启动 v2rayNG，因为系统通常只允许一个此类接管处于活动状态。

应用分流、绕过局域网和路由规则可以在基础连接成功后再设置。第一轮建议保持简单规则，避免某个域名被直连规则放行后，误以为节点没有生效。选择模式的判断标准不是“哪个功能更多”，而是当前应用是否遵循系统代理、是否需要接管更多协议，以及设备能否提供所需权限。

选中一条配置

在 v2rayN 主列表中单击准备使用的节点，并通过右键菜单或双击操作将它设为活动服务器。不同版本可能用颜色、加粗或状态栏文字表示当前选择，操作后应检查主窗口底部或托盘菜单，确认活动服务器名称与刚才选择一致。如果只是高亮了一行但没有设为活动服务器，后续连接仍可能使用原来的配置。

在 v2rayNG 中，返回配置列表并点选一条配置。被选中的项目通常会出现选择标记。然后点击主界面的启动按钮，等待系统状态栏出现 VPN 标识，同时观察应用内状态是否从停止变为已启动。启动按钮只负责使用当前选中的配置，因此在点击前仍要核对节点名称。

测试连接与真实访问是两件事

客户端可能提供连接测试、真连接测试或下载测试。普通的延迟测试有时只检查目标是否可达，不能完整代表协议握手和后续访问；真连接测试更接近实际建立连接，但仍不能证明所有应用都已经使用了正确的代理入口。测试的作用是缩小范围，而不是替代下一步的浏览器和日志验证。

首次操作可以先对少量节点执行真连接测试，再选择有正常结果的一条。不要同时对大量节点反复测速，也不要只按延迟数字判断配置质量。节点能否使用还取决于协议参数、TLS 或 REALITY 设置、远端状态和当前网络路径。选定后保持该节点不变，继续验证实际访问。

连接失败时先读第一条关键错误

如果启动后很快停止，或日志持续出现错误，先记录最早出现的关键提示。域名解析失败、连接超时、连接被拒绝、TLS 握手失败和参数不匹配代表不同阶段的问题。不要从日志末尾随意挑一条重复错误判断原因，因为后续重试可能只是同一问题的结果。

处理顺序应保持简单：先确认当前节点确实被选中，再更新一次订阅，然后换同一订阅分组中的另一条配置复测。如果多个配置都在相同阶段失败，再检查本机时间、网络和客户端权限。每次只改变一个条件，并在改变后重新连接；这样才能判断是哪项调整产生了影响。

先用浏览器完成最小验证

保持刚才选中的节点和代理模式不变，完全关闭测试用浏览器后重新打开，再访问一个平时能够明确判断加载结果的页面。重新启动浏览器可以减少旧连接、缓存和独立代理设置带来的干扰。如果页面正常加载，继续打开客户端日志，观察访问发生的同一时间是否出现新的连接记录。

日志中通常可以看到目标域名或目标地址、路由结果以及连接建立过程。只要浏览器访问与日志时间能够对应，就能较可靠地确认浏览器流量进入了客户端。如果页面可以打开但日志完全没有新增记录，浏览器可能走了直连、使用了自身代理，或者当前路由规则将该目标放行。此时应先检查浏览器网络设置和客户端路由，而不是直接更换节点。

再验证实际需要使用的应用

浏览器验证通过后，再打开真正需要使用的应用，并重复观察日志。系统代理模式下，如果浏览器有记录而目标应用没有记录，通常说明该应用不遵循系统代理。此时可以查看应用自身是否提供代理设置，或者在确认权限和路由条件后改用 TUN。切换之前先关闭原有接管方式，避免同时开启后无法区分结果。

安卓端可以先访问一个页面，再返回 v2rayNG 查看实时日志或连接统计是否发生与操作对应的变化。应用分流开启时，还要确认测试应用没有被设置为绕过。若只有某一个应用异常，而其他应用都能产生连接记录，应优先检查该应用的分流、后台限制和网络设置，不必立刻重导订阅。

排除 DNS 与缓存干扰

有时连接已经建立，但页面仍因域名解析或旧缓存失败。先换一个域名测试，再尝试关闭并重新打开应用。不要在未确认原因前同时修改系统 DNS、客户端 DNS 和浏览器安全 DNS，否则即使问题暂时消失，也很难知道是哪一层产生作用。需要系统理解 DNS 查询路径和规则匹配时，可转到全平台指南的配置常见问题。

最终判断应包含三个条件：客户端保持启动、目标应用产生对应日志、页面或服务完成实际访问。三者同时成立后，基础配置才算完成。如果只有节点测试成功，说明配置具备连接可能；如果只有客户端显示运行，说明进程已启动；如果页面能开但没有日志，则需要确认是否本来就是直连结果。

先保留已经验证成功的节点和代理模式，并给订阅分组使用容易识别的名称。若导入过程中产生了重复分组，可以在确认内容一致后删除多余记录。不要删除唯一可用配置后再尝试恢复，也不要把多个来源的订阅混进同一个无法辨认的分组。

结束使用时，应按当前模式正确退出。使用系统代理时，先在 v2rayN 中选择“清除系统代理”，再退出客户端，避免系统继续保留已经不可用的本地代理地址。使用 TUN 时先关闭 TUN，确认网络恢复后再退出。v2rayNG 安卓端则先点击停止按钮，等待系统 VPN 标识消失。

后续需要设置绕过局域网、按域名分流、自定义 DNS、开机启动或更新规则数据库时，建议一次只完成一个主题，并在每次调整后重复“实际访问加日志对应”的验证方法。各平台的安装权限、TUN 条件、平台特有问题和配置恢复步骤已整理在全平台安装配置指南中。

如果当前尚未安装客户端，可先进入客户端下载页按设备平台选择安装入口。桌面设备优先查看 v2rayN，安卓设备可按内核与使用需求选择对应客户端。完成安装后回到本页，从订阅导入开始操作即可。