v2rayN / v2rayNG
订阅导入与连接

开始操作前，需要确认客户端已经能够正常打开，并准备好一条完整的订阅地址。订阅地址通常是一段以网络协议开头的链接，用来让客户端读取一组服务器配置。它与单条节点链接不是同一个概念：订阅可以在更新时批量替换或增加配置，单条节点则只代表一个连接配置。两者的具体区别可参考术语表中的“订阅”与“节点”。

首次打开 v2rayN 时，主窗口通常包含菜单区、服务器列表和状态栏。此时列表为空是正常现象，因为客户端还没有读取任何配置。v2rayNG 首次打开时也可能只显示空的配置列表。不要先反复切换连接按钮；没有活动配置时，即使界面出现启动动作，也无法建立完整的转发路径。

接着检查订阅地址是否完整。复制时不要遗漏开头、末尾字符，也不要把聊天窗口自动附加的标点一起带入。若地址前后存在空格，粘贴后应删除。订阅名称可以自行填写，例如按用途写成“日常订阅”，名称只用于本地识别，不会改变订阅内容。若尚未安装客户端，先进入下载页选择当前系统对应的安装包，完成安装后再回到本页。

准备完成的判断很简单：客户端可以打开，订阅地址已经复制到剪贴板，并且当前网络可以正常访问订阅来源。下面先完成导入。导入成功后再处理代理模式，这样每一步都有明确结果，遇到问题也更容易判断发生在哪个环节。

v2rayN 桌面端的操作顺序

打开 v2rayN，在窗口顶部找到“订阅分组”或名称相近的订阅管理入口，进入订阅设置后选择新增。界面会要求填写备注名称和订阅地址：备注用于区分多条订阅，地址栏粘贴刚才准备的完整链接。填写完成后保存，返回主窗口。此时只完成了地址登记，服务器列表可能仍然为空，因为客户端还没有主动读取远端内容。

继续打开订阅相关菜单，执行“更新全部订阅”或当前分组的更新操作。更新期间注意主窗口底部状态栏或日志提示。正常完成后，主列表会出现若干配置行，表头通常包含别名、地址、端口、传输方式等字段。教程不要求逐项修改这些字段；订阅生成的配置应作为一个整体使用。只要列表已经出现内容，就可以进入下一阶段。

v2rayNG Android 端的操作顺序

打开 v2rayNG，进入右上角菜单，在订阅分组设置中新增一条订阅。填写便于识别的名称，粘贴完整地址并保存。返回配置列表后，再从菜单中执行更新订阅。更新结束时，列表中应出现可以点选的配置项。部分界面会直接选中第一项，部分界面仍需要手动点选；后面的连接步骤会再次确认当前活动配置。

如果更新后依然没有任何配置，不要立刻删除并重装客户端。先重新进入订阅设置，检查地址是否被截断，再确认更新动作针对的是刚刚新增的分组。若界面提示请求失败、解析失败或返回内容为空，应记录提示原文。请求失败通常指向网络访问或地址状态，解析失败则更接近订阅内容格式问题，两类问题的处理方向不同。

服务器列表出现后，先不要同时修改端口、传输参数和路由设置。快速上手的目标是用订阅提供的原始配置完成第一次连接。一次只改变一个条件，才能在连接失败时快速回到上一个可确认的状态。下一步只处理代理模式，不调整订阅内部字段。

客户端能够运行，不等于应用流量已经交给客户端处理。代理模式决定哪些流量会进入本地代理端口，以及客户端是否修改系统层面的网络设置。快速上手阶段建议先使用系统代理，因为它的影响范围清晰，关闭后也容易恢复。浏览器和遵循系统代理设置的桌面应用通常会直接使用这一设置。

在 v2rayN 中，查看窗口底部状态栏或系统托盘菜单，找到“系统代理”相关选项，选择自动配置系统代理或启用系统代理。不同版本的菜单文字可能略有差异，但应能看到系统代理从未启用切换到已启用状态。此时先保持路由模式的默认选择，不要同时开启多套互相重叠的代理工具，以免系统设置被不同程序反复覆盖。

在 v2rayNG 中，通常不需要寻找桌面端同名的系统代理菜单。选中配置并按下连接按钮后，Android 会显示网络连接授权确认。确认授权后，应用才能建立本地转发接口。这个授权属于连接流程的一部分，不代表订阅本身已经可用，因此仍需在下一步观察连接状态并完成访问验证。

什么时候考虑 TUN 模式

有些应用不会读取系统代理设置，终端程序也可能需要单独设置环境变量。若基础连接已经验证成功，但特定应用仍然直连，可以再研究 TUN 模式。TUN 会从更底层接管符合条件的流量，覆盖范围通常更广，同时也更依赖权限、路由规则和本机网络环境。首次配置直接从 TUN 开始，会把订阅、权限、路由和应用兼容问题混在一起，不利于定位。

路由分流与代理模式也不是同一个开关。代理模式决定流量能否进入客户端，路由规则决定进入客户端后的流量走哪个出口。常见的规则模式会根据域名、IP 或规则集进行匹配；全局模式则让更多流量使用同一出口。快速上手阶段保留默认路由设置即可。需要理解规则优先级、直连与代理出口时，可阅读术语表，具体配置方法放在完整手册的路由分流章节中。

连接前先回到服务器列表，明确选中一条配置。v2rayN 中可以在目标行上打开操作菜单，将其设为活动服务器；部分版本支持双击或使用快捷操作切换。完成后，状态栏应显示当前活动配置的名称或相关信息。不要仅凭列表中存在配置就判断已经选中，订阅更新只负责填充列表，不一定自动改变当前活动项。

活动配置确认后，启动客户端内核，并确保上一阶段选择的系统代理处于启用状态。v2rayN 通常会在启动后更新底部状态信息，日志窗口也会出现配置加载、核心启动和本地监听相关记录。此时不需要逐行阅读全部日志，只要确认没有持续重复的错误，并且客户端没有立即停止即可。

v2rayNG 中，先点选配置列表中的目标项，使其出现选中标记，再按右下角连接按钮。首次连接出现系统授权对话框时，确认允许。按钮状态随后会发生变化，顶部或通知区域通常也会显示正在运行的信息。若按下按钮后立即恢复到未连接状态，应打开日志查看原因，而不是连续快速点击连接按钮。

配置较多时如何选择

快速上手不需要逐条追求最低延迟。先选择一条名称完整、字段正常的配置完成连接闭环。客户端提供的测试功能可用于排除明显不可用的条目，但测试结果受本机网络、目标地址和测试时间影响，只适合作为当前环境下的参考。连接成功后再比较其他配置，会比在未完成基础设置时反复测试更有效。

如果内核无法启动，先看错误发生在启动前还是启动后。启动前立即报错，常见方向包括配置字段不完整、核心组件未能加载或本地监听端口冲突；启动后连接失败，则需要继续检查当前配置、网络请求和路由。日志中的第一条明确错误通常比后续重复信息更有价值。完整的日志阅读方法见完整手册的故障排查章节。

到这里，配置已经从订阅内容变成了正在运行的本地代理服务。最后一步不是继续修改设置，而是从客户端状态、浏览器访问和应用差异三个层面验证结果。只有验证完成，才说明整个基础路径真正闭合。

验证应从客户端自身开始。确认活动配置没有被切回空状态，内核仍在运行，系统代理或 Android 连接状态仍然开启。若状态刚启动就停止，浏览器测试不会提供更多有效信息，应先返回日志处理启动错误。若客户端状态稳定，再进入浏览器层面的检查。

关闭先前打开的测试页面，新建一个浏览器标签页进行访问。新标签页可以减少旧连接、缓存页面和已建立会话对判断的影响。选择一个平时能够明确判断是否正常加载的页面，观察是否可以完成域名解析、建立连接并显示完整内容。不要只看页面框架是否出现，图片、脚本或后续请求持续失败也说明连接链路可能不完整。

如果浏览器可以访问，但终端或某个独立应用没有变化，通常不应先怀疑订阅失效。不同应用对系统代理的支持方式不同：浏览器往往遵循系统设置，部分终端程序需要单独声明 HTTP 或 SOCKS 代理，另一些应用只在重启后读取新的系统代理状态。先完全退出目标应用并重新打开，再检查它自身是否存在代理设置。仍未生效时，再考虑为该场景配置 TUN。

如果所有应用都无法访问，按顺序检查四项：第一，客户端是否仍在运行；第二，当前活动配置是否为刚才选中的条目；第三，系统代理或连接开关是否确实启用；第四，切换同一订阅中的另一条配置后是否有变化。每次切换后等待状态稳定，再重新打开测试页面。不要同时更新订阅、切换路由和修改端口，否则无法确定是哪项操作改变了结果。

如何判断问题属于哪一层

验证结束后，可以保留当前可用配置作为基准。后续尝试路由分流、TUN 或其他设置时，如果结果异常，先回到这套已验证的基础配置，再逐项增加设置。一个明确可回退的基准状态，比同时保存多套未经验证的组合更容易维护。

日常使用不需要重复新增同一条订阅。配置提供方有变更时，直接执行更新订阅，客户端会重新读取对应分组。更新完成后检查当前活动配置是否仍然存在；如果原配置已经被替换，从新列表中选择一条配置并重新连接即可。频繁删除订阅再重新添加，会丢失本地分组习惯，也不利于判断更新失败的原因。

需要暂停使用时，应先关闭系统代理或断开连接，再退出客户端。只关闭窗口不一定代表程序已经结束，桌面端可能继续停留在系统托盘。若系统代理仍然开启而客户端已经停止，本机应用可能继续尝试访问失效的本地代理端口，表现为浏览器突然无法联网。遇到这种情况，重新打开客户端关闭系统代理，或在系统网络设置中恢复代理状态。

订阅更新频率取决于配置变化，没有必要在每次启动时连续手动更新。出现配置名称变化、旧配置不可用或收到明确更新提示时，再执行更新更容易观察结果。若自动更新订阅功能已经启用，也应偶尔确认更新提示是否正常，而不是只根据列表数量判断。

快速上手到这里结束。想继续配置按域名分流、理解 VMess、VLESS、Xray 与 V2Fly 等概念，可先查阅术语表；需要按章节学习安装、订阅维护、代理模式、路由分流、TUN 和日志排查，可进入从零到精通完整手册。遇到系统代理已经开启但应用没有生效时，也可阅读浏览器与终端分别排查的方法。