确认客户端已经安装并能正常打开
桌面设备使用 v2rayN，安卓设备使用 v2rayNG。第一次打开时，系统可能询问网络访问权限；按照系统提示完成授权即可。若客户端还未安装，先前往安装包页面选择当前平台对应版本。安装完成后重新回到本页，从订阅导入开始操作。
// QUICK START
v2rayN 使用教程：从订阅导入到连接验证
按界面顺序完成四个动作：导入订阅、选择代理模式、连接节点、验证访问。首次配置通常可在十分钟内完成。
适用客户端 v2rayN / v2rayNG
操作阶段 4 步
建议用时 约 10 分钟
开始前检查：客户端、订阅地址与本机网络
先确认三个基础条件，后续操作会更容易定位问题。
准备完整的订阅地址
订阅地址通常由服务提供方给出，是一段以 https:// 开头的链接。复制时需要保留整段内容，不要遗漏末尾参数，也不要把浏览器地址栏中的登录页面地址当作订阅地址。订阅链接可能包含账户识别信息，适合只保存在自己的设备和密码管理工具中。
确认当前网络可以正常访问普通网页
客户端建立连接之前，本机仍需要一条可用的基础网络。先关闭旧的代理工具，再用浏览器打开一个平时可以直接访问的网站。如果普通网页也无法打开，应先恢复 Wi-Fi、网线或移动网络连接。这样可以把基础网络故障与客户端配置问题分开处理。
三个条件都满足后，保持订阅地址处于可复制状态，进入第一步。
导入订阅并生成服务器列表
订阅导入的目标不是只保存一条链接，而是让客户端读取链接内容，并在服务器列表中生成可选择的节点。
v2rayN 桌面端操作
打开 v2rayN 主窗口，在顶部菜单中找到“订阅分组”或同类订阅管理入口。选择新增订阅分组后，会出现名称和地址输入区域。名称只用于本机识别，可以写成服务名称、用途或地区分组；地址栏粘贴刚才准备好的完整订阅链接。检查链接开头与末尾没有多余空格，然后保存。
保存分组只是记录订阅来源，下一步还要执行更新。回到“订阅分组”菜单，选择更新当前订阅，或在分组列表中对刚创建的项目执行更新。客户端会请求订阅内容并解析服务器配置。更新完成后，主窗口的服务器列表应出现一行或多行记录，常见列包括别名、地址、端口、协议、传输方式和订阅分组。
如果列表原本已有其他服务器，先观察“订阅分组”列，确认新出现的记录属于刚添加的分组。不要仅凭节点名称判断导入结果，因为不同订阅可能使用相似名称。只要新分组下已经出现服务器记录，这一步就完成了，暂时不需要修改每个节点的协议字段。
v2rayNG 安卓端操作
打开 v2rayNG，进入侧边菜单中的订阅设置。点击新增按钮，填写便于识别的备注名称，再把完整订阅地址粘贴到地址栏并保存。返回订阅列表后，确认刚添加的项目处于启用状态。随后执行“更新订阅”操作，等待顶部提示更新结束。
更新成功后返回客户端首页，节点列表会显示订阅解析出的服务器。列表中通常会标注节点名称，当前选中的项目会呈现选中状态。此时不要立刻反复点击连接按钮，先确认列表确实有内容，并且订阅更新没有显示解析失败、地址不可用或返回内容为空等提示。
识别正常导入结果
正常结果应同时满足两点：订阅分组已经保存在客户端中，服务器列表也出现了属于该分组的节点。如果只有分组名称而没有服务器记录，说明客户端尚未成功取得或解析订阅内容；如果服务器已经出现，就不必再次重复添加相同地址，否则容易产生重复分组和重复节点。
订阅并不是一次性导入文件。服务端调整节点后，需要在原有分组上执行更新，而不是重新创建一个同名分组。后续遇到节点全部不可用时，也可以先更新现有订阅，再判断是否属于连接问题。现在服务器列表已经准备好，下一步是决定哪些流量交给客户端处理。
选择代理模式与路由范围
代理模式决定客户端如何接管应用流量；路由规则决定接管后的请求走代理还是保持直连。
首次配置先使用容易观察的组合
第一次操作建议先选择“系统代理 + 规则分流”这一组合。系统代理会把遵循操作系统代理设置的应用交给 v2rayN，规则分流则按照域名、地址或预设规则决定请求出口。这个组合影响范围清晰，浏览器通常可以直接用于验证，也便于在出现问题时检查系统代理是否已经打开。
“全局”通常表示绝大多数已接管流量都通过当前节点，“规则”表示按路由规则区分直连与代理，“直连”则让请求绕过代理。不同版本的界面可能使用“全局”“绕过局域网和大陆地址”“清除系统代理”等近似名称。此处不需要逐项研究所有规则，只要先选择客户端提供的常用规则模式，并确保系统代理不是关闭状态。
v2rayN 桌面端设置
在 v2rayN 主窗口底部状态栏或系统托盘菜单中找到“系统代理”选项，选择自动配置系统代理或设置系统代理。完成后，状态栏对应文字应从未启用状态切换为已设置状态。接着打开“路由”或“路由设置”，选择一个现成的规则分流方案。保存后回到主窗口，观察底部是否同时显示当前系统代理状态和路由模式。
如果只打算让单个支持代理设置的应用使用客户端，也可以保持系统代理关闭，再由应用手动填写本地代理端口。但这种方式需要额外确认协议类型和监听端口，不适合作为首次上手路径。本教程先使用系统代理完成整条连接链路，确认正常后再考虑按应用单独配置。
v2rayNG 安卓端设置
v2rayNG 建立连接时会通过系统网络连接配置接管流量，因此没有与桌面端完全相同的“设置系统代理”按钮。进入设置或路由设置，选择客户端提供的规则模式即可。首次使用可保持其他高级参数为默认值，不要同时修改本地 DNS、分应用代理、流量探测和底层传输选项，否则一旦失败，很难判断是哪一项变化造成影响。
点击连接时，系统可能弹出网络连接授权窗口。确认应用名称无误后允许连接，授权通常只在首次或系统配置变化后出现。授权完成不代表节点一定可用，它只是允许客户端建立本地接管通道；实际连接状态还要在下一步通过按钮状态和运行日志确认。
什么时候再考虑 TUN 模式
部分桌面应用不读取系统代理，游戏启动器、命令行工具或采用独立网络栈的软件也可能绕过系统代理。此时可以进一步了解 TUN 模式，让客户端从更底层接管流量。不过 TUN 涉及虚拟网络接口、DNS 处理、管理员权限和路由优先级，不适合在基础连接尚未验证时直接启用。
正确顺序是先用系统代理确认订阅与节点可以工作，再根据具体应用是否仍无法接管决定是否切换 TUN。关于 TUN、DNS 和平台特有设置的系统说明，可阅读完整文档。本页继续沿用基础模式，进入节点选择与连接。
选择节点并启动连接
完成订阅与模式设置后，需要指定一个活动服务器，再观察内核是否成功加载该节点配置。
先选定一个节点
节点名称通常包含地区、线路或用途说明，但名称本身不能证明当前连接质量。首次验证时从订阅列表中任选一个普通节点即可，不必连续测试整个列表。若服务提供方给出了推荐线路，可以优先选择推荐项；如果没有说明，选择地理距离相对较近的节点通常更便于完成基础测试。
不要在连接过程中快速切换多个节点。每次更换活动服务器后，客户端需要重新加载配置并建立新连接，浏览器中的旧连接也可能暂时保留。频繁切换会让日志混合多次启动记录，反而难以判断某个节点是否真正失败。
v2rayN 桌面端连接方式
在服务器列表中单击目标节点，再通过右键菜单选择“设为活动服务器”，部分版本也支持双击直接设为活动项。活动节点通常会出现颜色、图标或行状态变化。确认选择后，在系统托盘菜单或主界面中启动服务，并保持前一步设置的系统代理状态。
随后查看主窗口底部状态栏与日志区域。正常启动时，日志会显示配置载入、内核启动和本地监听相关记录，状态栏会保留当前活动服务器名称。若日志立即出现端口被占用、配置字段错误或进程启动失败，说明连接还没有进入可验证阶段，应先处理对应错误，而不是继续刷新浏览器。
如果窗口中看不到日志区域，可从菜单打开日志窗口或展开底部窗格。日志用于确认程序执行到了哪一步，不需要逐行理解。先关注最新几行中是否持续出现错误，以及错误是否在每次启动时重复。偶尔出现一次连接重试不一定代表整体失败，连续重复的同类错误才更值得检查。
v2rayNG 安卓端连接方式
在首页节点列表中点击目标节点，使其成为当前选中项。随后点击右下角连接按钮。首次连接出现系统授权提示时完成授权，按钮状态会随连接过程改变，系统状态区域也会出现正在运行的网络连接标识。返回节点列表后，当前节点应保持选中，运行时间或流量区域开始更新时，说明客户端已经进入工作状态。
如果点击后马上恢复为未连接状态，打开侧边菜单中的日志，查看最新启动记录。常见原因包括节点参数已经变化、订阅没有更新、本机时间偏差较大、基础网络切换或当前节点暂时不可达。先更新一次原有订阅，再重新选择节点连接；仍然失败时，再换同一订阅中的另一个节点做对照。
连接状态与可访问状态不是同一件事
客户端显示“已连接”通常表示本地接管通道和内核进程已经启动，并不等于每个目标网站都能成功打开。节点远端是否可达、域名解析是否正常、应用是否读取系统代理，都需要通过下一步验证。现在先保持客户端运行，不要退出托盘进程，也不要切换代理模式。
验证代理是否生效
验证重点是区分“客户端已启动”“应用已被接管”和“目标请求成功”这三个层次。
使用新建浏览器窗口测试
保持客户端连接状态，关闭用于前期检查的旧页面，再新建一个浏览器窗口。先打开一个平时可以直接访问的网站，确认基础网络没有因为代理设置而中断；随后访问需要当前节点处理的目标网站。使用新窗口可以减少旧连接、缓存和已打开页面后台请求对判断结果的影响。
如果两类网站都能正常打开，并且客户端日志在访问时出现新的连接记录，说明订阅、活动节点、代理模式和应用接管已经形成完整链路。此时无需继续调整协议参数，可以把当前节点保留为常用服务器，并在以后需要时更新订阅。
通过日志确认请求是否进入客户端
当网页无法打开时，先观察点击刷新后日志是否出现新记录。如果日志完全没有变化，问题更可能位于应用接管阶段：桌面端检查系统代理是否仍为启用状态，安卓端检查客户端连接是否仍在运行。也可以完全退出浏览器后重新打开，避免浏览器继续沿用连接前建立的会话。
如果日志出现了目标域名或连接请求，但随后持续报告超时、远端拒绝或握手失败，说明流量已经进入客户端，检查重点应转向节点状态、订阅新旧和协议参数。先更新现有订阅，再切换到同一分组中的另一个节点。一次只改变一个条件，测试结果才有对照价值。
如果部分网站正常、部分网站失败，通常说明基础连接已经成立，差异可能来自路由规则、DNS 解析或目标服务自身。此时不建议退回重新安装客户端，也不需要删除全部订阅。记录失败网站、当前路由模式和日志中的相关行，再到疑难解答按故障类型继续排查。
按固定顺序处理失败
- 确认基础网络：暂时断开客户端后，检查普通网页能否访问。基础网络异常时先恢复本机联网。
- 更新现有订阅：不要重复新建分组，直接对当前分组执行更新，确认服务器列表仍有节点。
- 更换一个节点：保持代理模式不变，只替换活动服务器，用相同网站再次测试。
- 检查接管状态：桌面端查看系统代理，安卓端查看运行连接，确认应用流量确实进入客户端。
- 阅读最新日志：只看本次连接后的记录，依据超时、解析、端口或配置提示选择下一项检查。
这套顺序从外到内逐层排除问题，能够避免同时修改多个设置。若某一步恢复正常，就停止继续改动并重新验证。需要处理本机时间、端口冲突、DNS、TUN 或复杂路由时，再进入完整文档查阅对应章节。
基础连接完成后的日常操作
保持配置简单，订阅更新、节点切换和日志检查就足以覆盖多数日常使用场景。
更新订阅
节点名称、地址或参数发生变化时，在原有订阅分组上执行更新。更新后确认活动服务器仍然存在；若原节点被移除，从新列表中选择一个节点即可。重复添加同一地址会增加列表整理成本。
切换节点
先将新节点设为活动服务器，再等待客户端完成重载，然后用新建浏览器窗口测试。切换期间出现短暂断开属于连接重建过程，不要连续点击多个节点。
退出连接
桌面端退出前先关闭系统代理或从托盘菜单停止服务，再结束客户端进程。安卓端使用连接按钮断开当前连接。这样可以让系统网络状态明确恢复到直连路径。
保留排查信息
出现异常时记录客户端名称、当前模式、节点分组、发生时间和最新日志提示。清晰的上下文比反复重装更有助于定位问题，也便于在疑难解答中找到对应分支。