首次配置 · 约 10 分钟

V2Ray 客户端订阅导入与首次连接

按照“导入订阅、选择代理模式、连接节点、验证结果”的顺序完成基础配置。每一步都以前一步的可见结果为检查点,出现异常时不必反复重装客户端。

桌面客户端 v2rayN
Android 客户端 v2rayNG
完成标志 连接与 IP 结果一致
第一步

导入订阅并确认节点列表

这一阶段只判断两件事:订阅地址能否被客户端保存,以及更新后能否得到节点。暂时不要修改路由、DNS 或 TUN 设置。

先复制完整的订阅地址

从订阅服务提供方的管理页面复制客户端订阅地址。复制时应包含从协议开头到最后一个参数的完整内容,例如地址中的 token=xxxx 也是订阅识别信息的一部分。不要只复制浏览器地址栏里被截断的一段,也不要把订阅地址粘贴到搜索框中测试。订阅地址属于个人配置资料,不适合发布到截图、论坛或聊天群。

如果服务提供方同时给出多个入口,选择标注为通用订阅、V2Ray 订阅或兼容 v2rayN、v2rayNG 的入口。二维码更适合移动端扫描,文本地址则适合桌面端粘贴。两种形式最终传递的是同一类配置数据,不需要同时导入。

在 v2rayN 中新建订阅分组

打开 v2rayN 后,在顶部菜单进入 订阅分组,选择 订阅分组设置。在弹出的窗口中新建一条记录,把完整地址粘贴到订阅地址栏,再填写一个容易识别的备注,例如服务名称或用途。分组名用于在节点较多时筛选,不影响连接本身;首次使用可以保留默认分组,也可以填写与备注一致的名称。

保存设置后回到主窗口,再次打开订阅菜单,执行一次“更新全部订阅”或对刚才的分组单独更新。更新过程完成后,主窗口应出现若干服务器记录,常见列包括别名、地址、端口、传输方式和安全类型。这里不要求每一列都能理解,只需确认列表不再为空,并且没有持续弹出订阅解析错误。

在 v2rayNG 中新增订阅

打开 v2rayNG 的侧边菜单,进入订阅设置,点击新增按钮。填写备注并粘贴订阅地址,保存后返回订阅列表,选中刚添加的条目并执行更新。更新成功后回到主界面,节点会以列表形式出现。若列表仍显示之前的内容,可从主菜单执行刷新配置,或者退出当前页面后重新进入节点列表。

移动端通过二维码导入时,应确认扫描结果被识别为订阅地址,而不是单个 VMess 或 VLESS 节点。单节点配置只能增加一条服务器记录,订阅地址则允许后续统一更新。如果只看到一个节点但服务页面明确提供了多条线路,返回订阅设置检查导入类型。

本步完成标志

客户端中已经保存订阅分组,手动更新没有持续报错,主节点列表至少出现一条可选择的服务器记录。

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

先重新打开订阅设置,确认地址首尾没有空格,参数没有在复制时缺失,并核对当前启用的是刚添加的分组。接着再手动更新一次,观察客户端提示的是网络请求失败、内容为空还是格式无法识别。这三类提示对应不同方向:请求失败通常与当前网络或订阅地址可达性有关;内容为空需要检查订阅状态;格式无法识别则应确认拿到的是客户端订阅地址,而不是管理页面地址。

不要在这一步频繁切换代理模式。客户端还没有可用节点时,修改系统代理不会让订阅内容自动出现。订阅状态、更新频率和节点字段的进一步解释可查看常见问题术语表;多订阅分组、服务器过滤和自动更新策略放在进阶手册中单独说明。

第二步

选择系统代理与路由模式

订阅已经产生节点后,再决定哪些流量交给客户端。首次连接以系统代理和规则模式为主,先建立可解释、容易排查的基础状态。

先区分两个独立设置

v2rayN 中常被混在一起讨论的设置有两类。第一类是系统代理状态,它决定遵循操作系统代理设置的应用是否把请求发送给 v2rayN;第二类是路由模式,它决定请求进入客户端后使用代理出站、直连出站还是阻止出站。前者负责“流量是否进入客户端”,后者负责“进入后走哪条路径”。只改其中一项,实际结果可能与预期不同。

对于第一次配置,先在 v2rayN 底部状态区或托盘菜单中把系统代理设为自动配置系统代理,再把路由选择设为规则模式。不同版本对规则模式的名称可能略有区别,界面中常见的是绕过本地网络与常用直连目标,其他请求按当前活动服务器处理。选择后留意底部状态栏,系统代理和路由两处文字应同步反映当前设置。

什么时候使用全局模式

全局模式表示进入客户端的请求优先交给当前代理出站处理。它适合做短时间的对照测试:如果规则模式下某个网页没有按预期打开,可以临时切到全局模式,再刷新同一页面。若全局模式正常而规则模式异常,问题更可能位于路由匹配;若两种模式都失败,应回到节点状态、订阅内容或网络连通性继续检查。

全局模式不等于系统内所有程序都会自动进入客户端。某些程序不读取系统代理设置,某些程序使用独立网络栈,还有一些程序自带代理配置。遇到这种情况,应先检查程序自己的代理选项;确实需要接管更多流量时,再评估 TUN 模式,而不是仅在规则与全局之间反复切换。

v2rayNG 的模式选择

在 v2rayNG 中,先从设置或路由设置里选择规则模式。回到主界面后,连接按钮会建立系统级 VPN 通道,Android 会显示权限确认窗口。第一次连接需要允许该请求,否则节点即使被选中,流量也不会进入客户端。这里的系统授权只负责建立通道,具体流量仍按 v2rayNG 当前路由规则处理。

如果只是验证订阅和节点是否可用,保持默认规则配置即可。自定义域名规则、应用分流、DNS 查询路径以及 FakeDNS 会同时改变多个判断条件,不适合在首次连接前集中调整。先完成本页四步,确认基础连接稳定,再到进阶手册按单一变量逐项修改。

本步完成标志

v2rayN 已显示系统代理开启和规则模式,或 v2rayNG 已选定规则配置并具备建立系统通道的权限。

完成模式选择后,客户端已经知道如何接收和处理流量,但还没有确定实际使用哪一台服务器。下一步应先测试节点,再把一条确认可连接的记录设为活动服务器。这样可以避免把“模式配置错误”和“节点本身不可用”混成同一个问题。

第三步

测试节点并建立连接

节点名称只能提供地区、倍率或协议线索,不能证明当前可用。连接前执行一次真连接测试,再从成功结果中选择活动服务器。

使用真连接延迟排除失效节点

在 v2rayN 主列表中选中几条候选节点,打开右键菜单或测试菜单,执行“测试服务器真连接延迟”。该测试会按照节点配置完成实际代理握手,比普通网络 Ping 更接近浏览器建立连接时的状态。测试结束后,成功记录会显示连接耗时,失败记录通常显示超时、错误或空结果。

不要只挑数值最小的一条。首次选择时更重要的是结果能否稳定返回,以及节点协议、地区和订阅标注是否符合用途。可以对两到三条候选记录重复测试一次,排除偶发网络抖动。如果第一次有结果、第二次持续超时,暂时换另一条节点更便于继续完成配置。

普通 Ping、真连接延迟与下载测速衡量的对象不同。Ping 更接近基础网络往返,真连接延迟包含代理握手,下载测速则会使用实际流量并受到服务端带宽、线路拥塞和本地网络共同影响。首次连接只需要真连接延迟成功,不必先跑完整下载测速。三种数值的详细区别可在延迟测试说明中查看。

把测试成功的记录设为活动服务器

在 v2rayN 中双击测试成功的节点,或通过右键菜单选择“设为活动服务器”。设定后,节点行通常会出现颜色、图标或状态标记,底部状态区也会显示当前服务器信息。仅仅单击一行通常只是选中记录,不一定改变活动服务器,因此应以状态标记是否变化为准。

确认活动服务器后检查 v2rayN 核心是否处于运行状态。正常情况下,启动客户端或切换节点时会在日志区域看到配置加载、核心启动和本地监听建立等信息。如果日志持续重复启动与退出,应先停止切换节点,查看最靠近错误位置的提示。端口被占用、配置字段不兼容和本地安全软件阻止进程属于不同问题,不宜用重复更新订阅代替定位。

在 v2rayNG 中选中并连接节点

回到 v2rayNG 主列表,点击一条节点记录,使其成为当前配置。节点旁的选中状态应随之变化。随后点击主界面的连接按钮;首次建立通道时,系统会要求确认连接权限,允许后等待状态图标变为已连接。若客户端提供测试入口,可先对当前节点执行连接测试,再开启通道。

连接按钮显示开启只代表本地通道已经建立,不单独证明远端节点可用。因此不要在这里结束检查。保留当前活动节点和模式不变,直接进入下一步,通过浏览器结果与客户端日志交叉确认。若连接后所有网页都无法访问,先断开通道,再换一条真连接测试成功的节点重新尝试,避免连续叠加配置改动。

本步完成标志

至少一条节点通过真连接测试,已经被设为活动服务器,客户端核心或系统通道处于连接状态,日志没有持续重复同一错误。

测试全部失败时的最短排查顺序

先更新一次订阅,确认节点记录确实来自当前启用的分组;再检查设备时间和时区是否准确,因为部分协议握手会受到明显时间偏差影响;随后完全退出客户端并重新打开,只测试一条节点。如果仍然全部失败,记录错误出现的阶段和关键提示,到FAQ 的故障排查分类对照处理。此时不建议删除所有配置,保留订阅和日志更容易判断问题发生在哪一层。

第四步

验证浏览器流量是否经过代理

最终判断不依赖按钮颜色,而是同时查看客户端状态、访问结果和出口信息。验证期间保持节点与模式不变,避免结果失去可比性。

使用新的浏览器窗口测试

连接建立后,打开一个新的浏览器窗口或隐私窗口,再访问常用的 IP 检测页面。新窗口可以减少已有连接、缓存和扩展设置对结果的影响。记录页面显示的出口地址与地区,然后断开客户端并刷新同一页面进行对照。连接前后结果发生合理变化,且开启连接时网页能够稳定加载,说明浏览器流量已经进入当前代理链路。

不要只用一个已经长期打开的网页标签判断。浏览器可能复用旧连接,页面本身也可能缓存此前结果。若检测页面显示没有变化,先关闭该标签并新建窗口,再确认浏览器没有启用独立代理扩展。独立扩展可能覆盖系统代理,使 v2rayN 的模式切换看起来没有作用。

结合日志判断请求是否进入客户端

保持检测页面打开,在 v2rayN 中观察日志区域。刷新网页时,如果日志出现新的连接记录,说明请求已经到达客户端;此时页面打不开,应继续检查节点握手、DNS 或路由结果。如果刷新页面时日志完全没有变化,更应检查系统代理状态、浏览器代理设置和目标程序是否遵循系统代理,而不是立刻更换协议。

v2rayNG 的判断方式相近:连接状态应保持开启,系统状态区显示通道正在工作,刷新页面时客户端日志或流量状态会产生变化。若断开后恢复正常、连接后所有请求都失败,通常说明流量已经进入客户端,但当前节点或配置未能完成出站连接。若连接前后毫无差异,则优先核对当前选中的节点、通道权限和路由模式。

再做一次实际访问检查

IP 结果确认后,再打开两到三个平时会使用的网页,分别检查首页加载、图片资源和后续页面跳转。只打开检测页并不能覆盖所有 DNS 与连接场景。实际网页能够连续打开,客户端日志没有持续报错,连接断开后出口结果恢复原状态,才算完成首次配置。

如果部分网页正常、部分网页异常,不要把它归结为整个客户端失效。先临时切换全局模式做一次对照:全局模式正常时,检查规则匹配和 DNS 配置;全局模式仍异常时,换一条已经通过真连接测试的节点。测试完成后恢复规则模式,确保日常状态与排查状态区分清楚。

本步完成标志

新浏览器窗口的出口结果与未连接时不同,实际网页访问正常,客户端日志能观察到对应请求,断开连接后结果可恢复。

完成后只调整一个变量

基础连接验证通过后,可以按实际需要设置订阅自动更新、节点分组、路由规则或 TUN 模式。每次只改一个主要设置,修改后重复“连接—查看日志—检查出口”的验证流程。这样即使出现异常,也能快速确定是哪一次修改引起,而不必重建全部配置。

订阅分组、服务器过滤、DNS 路径、FakeDNS、TUN 模式和自定义出站之间存在关联,集中修改容易使排查范围扩大。这些主题已在进阶配置手册中按章节拆开。协议名称、内核关系和路由术语可先查阅术语表,遇到明确错误提示则前往FAQ按故障类型定位。

v2rayN下载