// QUICK CLIENT SETUP

v2rayN 与 v2rayNG 订阅导入和连接教程

按照“导入订阅 → 选择代理模式 → 连接 → 验证”的顺序操作。界面版本可能略有差异,但入口名称、状态判断和排查逻辑基本一致。

预计用时:约 10 分钟 准备内容:有效订阅地址 适用客户端:v2rayN、v2rayNG
01 IMPORT 保存订阅并更新配置
02 ROUTING 确定系统代理与路由模式
03 CONNECT 选中配置并启动客户端
04 VERIFY 通过访问结果和日志复核

// BEFORE STARTING

00开始前检查:客户端、订阅地址与系统时间

开始操作前,先确认客户端已经完成安装并能正常打开。桌面设备使用 v2rayN,安卓设备使用 v2rayNG;如果还没有安装,可先到获取客户端页面按平台选择对应版本。首次启动时,系统可能显示网络访问、防火墙或本地 VPN 接口相关提示,应根据当前设备的安全策略允许客户端建立本地网络连接,否则后续即使导入了配置,也可能无法让应用流量进入客户端。

本教程以“订阅地址”为输入。订阅地址通常是一段以 https:// 开头的完整链接,由订阅服务提供方生成。它和普通网页地址不同:客户端读取该地址后,会得到一个或多个可用配置,并将它们放入订阅分组。复制时要从开头到结尾完整选中,不要保留前后空格,也不要把聊天软件自动添加的句号一起复制进去。

订阅地址应当按敏感凭据处理。它可能包含用于识别订阅账户的参数,不适合发布在截图、公开文档或问题反馈中。如果需要向他人展示客户端界面,应先遮住订阅地址和配置名称中的个人信息。教程中的操作只要求把地址粘贴到本机客户端,不要求把地址提交给本站。

最后检查系统日期、时间和时区是否正确。部分协议需要在握手阶段使用时间信息,系统时间偏差过大时,配置看起来能够导入,连接却会在启动后立即失败。建议先开启系统自动设置时间,再继续导入。若客户端已经存在旧配置,不必立即删除;新建一个名称清楚的订阅分组,能够在测试失败时快速切回原配置。

进入第一步前应看到的状态

  • 客户端可以正常打开,主界面没有持续出现启动错误。
  • 已经取得完整订阅地址,并确认地址仍在有效期内。
  • 系统日期、时间和时区正确。
  • 能够区分“订阅分组”和“单个配置”:前者负责更新,后者用于实际连接。

// STEP 01 · IMPORT

01导入订阅:先建立分组,再更新配置列表

第一步的目标不是直接连接,而是让客户端记住订阅地址,并把订阅内容转换成可选择的配置。完成后,主界面应当出现一个订阅分组,分组下至少显示一条配置。只保存地址但没有执行更新时,配置列表通常仍然为空,因此“保存”和“更新”是两个连续动作,不能只做前一个。

v2rayN 桌面端操作

打开 v2rayN 后,在顶部菜单找到“订阅分组”或名称相近的订阅管理入口,再进入“订阅分组设置”。新建分组,在备注或别名栏填写一个便于识别的名称,例如“日常订阅”;把完整订阅地址粘贴到地址栏。其他高级选项暂时保持默认,保存并关闭设置窗口。

返回主界面后,再次打开订阅菜单,执行“更新全部订阅”或选择刚才建立的分组单独更新。更新过程中,底部状态区域会显示处理信息。成功后,主列表会出现若干配置行,通常能够看到配置类型、别名等字段。此时不要只根据名称判断是否可用,先确认这些配置确实归属于刚建立的订阅分组,避免误选旧列表中的项目。

如果 v2rayN 提示读取失败,先回到订阅分组设置,检查地址开头、结尾和协议头是否完整。还可以把地址重新复制一次,覆盖原内容后保存。不要把订阅地址粘贴到“从剪贴板导入单个配置”的入口:那个入口适合处理一条 vmess://vless:// 或其他单配置链接,不能代替订阅分组的持续更新功能。

v2rayNG 安卓端操作

打开 v2rayNG,进入左上角菜单或订阅分组管理入口,选择新增订阅。填写分组名称,把完整订阅地址粘贴到地址栏后保存。返回主界面,打开右上角菜单并执行“更新订阅”。部分版本会要求先选中订阅分组,再允许更新;如果主界面仍然为空,先确认当前显示的分组正是刚刚新建的分组。

更新成功后,配置会以列表形式出现在主界面。点按一条配置通常会将它设为当前配置,选中状态会通过颜色、勾选标记或列表高亮显示。此时先完成选中即可,不要急着按连接按钮;下一步还要确认代理模式和路由方式,否则连接虽然启动,部分应用仍可能不经过客户端。

订阅更新失败的原因不只一种:地址可能复制不完整、订阅状态可能发生变化,也可能是当前网络无法读取该地址。先检查地址和系统时间,再查看客户端日志中的首条错误,不要连续反复点击更新。关于“订阅为空”“格式不支持”和更新后配置消失等情况,可转到常见问题按错误表现继续排查。

// STEP 02 · ROUTING

02选择代理模式:区分流量入口与路由规则

配置已经导入后,需要决定哪些流量交给客户端处理。这里容易混淆两个概念:系统代理或本地 VPN 接口负责把应用流量送入客户端,路由模式负责决定进入客户端后的请求走直连、代理还是拦截。前者没有开启时,浏览器可能完全绕过客户端;后者选择不当时,则可能出现部分网站正常、部分网站结果与预期不同的情况。

先选规则模式,再按需要调整

初次设置建议使用规则路由,而不是一开始就修改大量自定义规则。规则模式会根据域名、IP 和规则集进行分流,局域网地址通常保持直连,其他请求再按配置处理。v2rayN 中常见的名称包括“规则”“绕过局域网与大陆”或订阅提供的路由方案;v2rayNG 中可在路由设置里选择预定义规则。不同版本的文字可能略有差异,判断重点是模式说明,而不是菜单所在位置。

“全局”模式通常表示进入客户端的流量统一按当前配置处理,适合短时间排除规则匹配问题,但不建议把它当成默认答案。“直连”模式则会让进入客户端的请求直接访问目标,主要用于对照测试。若规则模式下某个站点打不开,而全局模式可以打开,问题更可能出在路由匹配;若两种模式都失败,则应回头检查配置、连接状态和本地网络。

v2rayN:开启系统代理

在 v2rayN 主界面或系统托盘菜单中找到“系统代理”,选择自动配置系统代理或名称相近的启用项。启用后,托盘状态、菜单勾选或主界面状态栏应发生变化。随后进入路由设置,选择规则模式。此时浏览器以及遵循系统代理设置的桌面应用会把请求送入 v2rayN。

有些应用拥有独立代理设置,不一定读取系统代理。如果浏览器验证成功,而某个单独应用仍保持原来的连接方式,应检查该应用自己的网络设置。不要为了处理一个应用的问题频繁修改 v2rayN 的本地监听端口,因为端口变化还会影响已经保存的系统代理配置。端口冲突的识别和修改步骤可参考本地监听端口冲突处理

v2rayNG:确认路由后再启动

v2rayNG 的流量入口会在点击连接按钮时建立。首次启动连接,系统会弹出本地 VPN 接口授权提示;确认后,客户端才能接收其他应用的流量。进入设置中的路由选项,先选择规则模式。按应用分流、自定义 DNS 和自定义规则属于进阶内容,第一次连接时保留默认值更容易判断问题来自哪一层。

如果以前为 v2rayNG 设置过仅允许部分应用进入客户端,应先确认当前要测试的浏览器包含在允许范围内。否则客户端状态可能显示已连接,但浏览器并未进入该接口。首次验证以简单、可复现为原则:选中一个配置、使用规则模式、让常用浏览器参与连接,确认基础链路正常后再添加细分规则。

流量入口 v2rayN 系统代理 / v2rayNG 本地 VPN 接口
路由判断 规则模式根据域名与 IP 决定处理方式
当前配置 承载通过代理路径处理的连接参数

// STEP 03 · CONNECT

03建立连接:选中配置并读取运行状态

连接前再看一次配置列表,确认高亮项属于刚更新的订阅分组。客户端通常只会使用当前选中的一条配置;列表里存在很多项目并不代表它会自动逐个尝试。如果当前项名称不清楚,可以先切换到同一分组中的另一条配置,再观察选中标记是否随之移动,以确认点击已经生效。

v2rayN 桌面端连接过程

在主列表中双击配置,或通过右键菜单将其设为活动配置。确认系统代理已经开启后,查看底部状态栏:活动配置名称、本地监听状态和运行提示应当对应当前选择。部分版本会在选择配置后自动启动内核,部分版本需要通过菜单执行启动或重启。操作后等待状态区域完成刷新,不要在短时间内连续切换多个配置,否则日志会混合多次启动信息,不利于判断失败发生在哪一步。

正常启动时,日志应当显示配置已载入、本地监听已建立,随后进入等待连接的状态。若出现端口已经被占用、配置字段错误或内核启动失败,应先处理日志中的第一条明确错误。后续大量重复信息往往是同一问题的连锁结果。修改设置后使用一次“重启服务”或重新选择配置,让新设置完整加载。

v2rayNG 安卓端连接过程

点按配置行将其设为当前配置,然后点击主界面底部的连接按钮。首次连接时确认系统弹出的本地 VPN 接口请求。连接建立后,按钮形态和顶部状态会发生变化,系统状态栏也会显示相应标记。若按钮很快恢复到未连接状态,进入日志查看启动失败原因,而不是反复点击按钮。

切换配置时,先停止当前连接,再选中新配置并重新启动。这样可以确保路由、DNS 和连接参数一起重新加载。直接在运行中快速切换多个配置,可能让旧连接暂时保留,导致浏览器测试结果与当前高亮项不一致。完成切换后,可以关闭浏览器中的旧页面,再打开新标签进行验证。

如何理解“已启动”与“可用”

客户端显示已启动,只说明本地服务或接口已经建立,不等于远端连接一定成功。真正的可用状态还需要下一步通过网页访问和日志共同判断。反过来,如果浏览器能够打开普通网页,也不能单独证明流量经过了客户端,因为该网页可能按路由规则直连。因此不要只看一个绿色状态点,也不要只看一个网页结果。

配置失败时,优先尝试同一订阅分组中的另一条配置。如果多个配置都在相同阶段失败,再检查订阅是否刚刚成功更新、系统时间是否准确,以及本地网络是否允许客户端建立连接。一次只改变一个条件:先换配置,再重启客户端,最后才修改路由或 DNS。按顺序操作可以避免多个变量同时变化。

// STEP 04 · VERIFY

04验证是否生效:网页结果、日志与路由记录一起看

验证阶段要回答三个问题:应用流量是否进入客户端、当前配置是否成功建立连接、路由规则是否按预期处理请求。最简单的做法是保持客户端窗口或日志页可见,然后用常用浏览器打开一个需要测试的站点。页面加载的同时观察日志是否出现新的连接记录。如果网页有响应且日志同步增加,说明浏览器流量已经进入客户端。

接着打开一个通常应当直连的常用站点,再观察路由记录。规则模式下,不同请求可能显示不同处理结果,这是正常的分流表现。若所有请求都没有出现在日志中,先检查 v2rayN 的系统代理是否仍然开启,或 v2rayNG 的本地 VPN 接口是否保持连接;若日志有请求但全部失败,则重点检查当前配置和订阅状态。

浏览器可能复用旧连接和缓存。切换配置或路由模式后,建议关闭原测试标签,再打开新的标签页;必要时完全退出并重新打开浏览器。这样可以减少旧连接继续使用上一条路径的干扰。不要把单个页面中的图片加载失败直接判断为客户端故障,应至少测试两个不同站点,并结合日志确认失败请求是否具有相同特征。

验证失败时按固定顺序回查

  1. 确认当前配置。 检查列表高亮项是否属于刚更新的订阅分组,并尝试同组中的另一条配置。
  2. 确认流量入口。 桌面端查看系统代理状态,安卓端查看本地 VPN 接口状态;日志完全没有新请求时优先检查这一层。
  3. 确认启动日志。 从第一条明确错误开始处理,端口冲突、配置字段错误和时间异常应分别解决。
  4. 临时对照路由模式。 规则模式下单个站点失败时,可短暂切换全局模式做对照;测试结束后恢复规则模式。
  5. 重启完整链路。 停止客户端,关闭浏览器,重新启动客户端并等待状态稳定,再打开浏览器复测。

如果网页能够打开,但域名解析结果与预期不一致,问题可能位于 DNS 设置,而不是订阅或配置本身。此时不要同时修改多项 DNS 参数,可先阅读DNS 检测与客户端配置说明,了解系统解析、客户端解析和路由规则之间的关系。更复杂的协议差异、内核兼容性与资源占用比较,可在协议与内核参考中继续查看。

验证完成后,记住当前可用配置名称、订阅分组和路由模式。以后出现连接变化时,可以先恢复到这组已确认设置,再判断是订阅更新、单个配置还是本地环境发生变化。与其一次性重置全部选项,保留一个已知可用的基准状态更容易定位问题。

// AFTER SETUP

完成后维护:更新订阅、切换配置与保留基准设置

日常使用不需要重复新建订阅。订阅内容发生变化时,直接执行“更新订阅”,再从更新后的列表中选择配置即可。只有订阅地址本身更换时,才需要编辑原分组或新建分组。更新后如果当前配置被移除,客户端可能保留旧选择但无法继续使用,应重新选中列表中仍然存在的配置。

切换配置时采用固定动作:停止连接、选择新配置、重新连接、打开新标签验证。切换路由模式时也应重新测试常用站点,避免旧连接造成误判。若为了排查临时使用全局模式,测试结束后记得恢复规则模式;如果添加了自定义规则,应记录修改目的和匹配对象,便于后续订阅更新后复核。

遇到问题时先描述现象,而不是直接重装客户端。有效的排查信息包括:使用的客户端类型、问题发生在订阅更新还是连接阶段、日志第一条错误、系统代理或本地 VPN 接口状态,以及更换配置后的结果。不要在截图中公开订阅地址。常见错误可在常见问题页面按“安装配置”和“故障排查”分类查询。

// NEXT REFERENCE

需要继续了解哪一层?

下载页用于选择客户端版本;常见问题页按现象给出处理顺序;协议详解页用于比较 VLESS、VMess、Trojan、REALITY 以及 V2Fly、Xray 内核关系。