首次配置 / QUICKSTART

v2rayN 与 v2rayNG 使用教程

从订阅地址到连接验证。客户端已安装、订阅可用时,先用约 10 分钟走完一轮,不必提前调整 DNS 或路由规则。

STEP 01 / SUBSCRIPTION

导入订阅

先准备订阅提供方给出的完整地址。订阅地址用于拉取一组配置,不是登录服务后台的页面地址。复制时保留地址末尾的查询参数,不要只复制域名。订阅地址可能包含访问凭据,截图或发日志求助前要遮住整条地址,也不要把它粘贴到不熟悉的转换网站。

v2rayN:添加并更新订阅分组

在主窗口打开「订阅分组 → 订阅分组设置」,新增一个分组。在备注栏填一个能认出的名称,把订阅地址粘贴到地址栏,然后保存。返回主窗口,切到刚添加的分组,从「订阅分组」菜单选择更新当前订阅的命令。首次配置还没有可用代理时,若菜单同时提供「通过代理」和「不通过代理」两个更新入口,且当前网络能直接访问订阅服务,先选「不通过代理」。更新结束后回到该分组查看列表。

v2rayNG:在侧栏保存订阅地址

打开左上角菜单,进入「订阅分组设置」,点加号。填写备注和订阅地址,按右上角的保存图标。返回配置列表,选中对应分组,从右上角更多菜单选择「更新订阅」。如果保存后列表仍为空,先确认已经执行更新;保存分组只记录地址,不代表配置已经拉取。菜单名称可能随客户端版本略有差异,认准分组设置与更新订阅这两个动作。

继续前检查:列表应该显示一条或多条带名称的配置。若提示网络错误,先确认当前网络可用,并在客户端内复核地址和订阅有效期。若显示更新完成却没有配置,确认当前查看的是刚更新的分组,并向提供方核对订阅格式。不要因一次失败反复添加相同地址。列表出现后,挑一条提供方标注可用的配置,下一步决定哪些应用的请求要交给客户端。

STEP 02 / PROXY MODE

选择代理模式

首次测试只选一种接管方式。代理模式决定应用的请求怎样进入客户端,路由规则决定请求进入后走代理还是直连。这两项不等同。即使系统代理或 VPN 已开启,匹配直连规则的请求仍可能从本地网络直接发出。先保持原有路由和 DNS 设置,避免同时改动多个变量。

v2rayN:先用系统代理测试浏览器

在托盘菜单找到「系统代理」。本次选用「自动配置系统代理」作为测试方式,但先等下一步确认活动配置和内核状态,再启用这一项。选一款跟随系统代理的浏览器作为测试应用。如果浏览器已通过扩展或独立设置指定了代理,先记下原设置,换用一个明确跟随系统代理的浏览器测试。否则,即使网页能打开,也难以判断实际使用了哪套代理。

测试阶段先保持 TUN 关闭。系统代理适合验证支持系统代理的应用,但并非所有应用都会读取系统设置。若浏览器已验证通过,只有某个应用不走代理,先查该应用的网络设置,不必立即重装客户端。确实需要了解 TUN 如何接管流量时,再读配置进阶。

v2rayNG:首次测试先关闭分应用代理

在侧栏打开「设置」,检查「分应用代理」。首次验证时先保持它关闭,避免测试浏览器因应用名单而被排除。若手机已有必须保留的代理范围,不要改变现有规则,改用一款确认已纳入 VPN 的应用测试。后续再调整名单时,先看「绕过模式」的状态:启用绕过时,勾选的是要排除的应用;未启用绕过时,勾选的是要纳入的应用。

继续前检查:桌面端已确定使用系统代理测试,安卓端已确认测试应用在接管范围内。如果设备正在使用另一项 VPN 服务,先确认能否暂停它;受工作资料或设备策略管理的连接,按管理员指引处理,不要自行解除限制。接下来启动刚选定的配置,不必修改服务器字段。

STEP 03 / CONNECT

启动连接

在连接前,用选好的浏览器访问一个日常可用的页面作为基线。如果准备对照公网出口,也在此时记下可信出口查询页面返回的地址。保持网络不变:不要在记录基线后立刻从无线网络切到移动数据,否则出站地址变化可能来自网络切换,而不是客户端。

v2rayN:确认活动配置,再启用系统代理

回到配置列表,右键点选刚选好的配置,使用「设为活动服务器」或界面提供的同义命令。只把列表行点成选中状态,不等于它已被设为活动配置。确认活动标记已移到目标项,再看主窗口下方的日志区,确认没有持续出现内核启动失败或本地监听端口占用。然后在托盘菜单打开「系统代理 → 自动配置系统代理」。如果托盘图标折叠在系统的隐藏图标区域,先展开该区域再找客户端图标。

如果内核报端口占用,先停止本机其他不再使用的代理程序,再确认活动配置是否能正常启动,不要随意结束不认识的进程。若系统原先已有手工设置的代理,记下它的状态。测试结束时可在同一托盘菜单选择「清除系统代理」,再按需要恢复原设置;不要假定退出客户端一定会恢复之前的代理配置。

v2rayNG:接受 Android 的 VPN 连接请求

在主界面的配置列表点选目标项,确认活动标记落在正确配置上,再点圆形启动按钮。首次启动时,Android 会弹出 VPN 连接请求。确认弹窗所指的应用是 v2rayNG,再点「确定」。授权后,主界面的按钮状态应切换,系统也可能在状态栏或通知区域显示 VPN 标记;显示位置取决于手机系统。

如果按下按钮后状态没有保持,先回到应用检查是否取消过授权、是否有另一项 VPN 占用,或是否出现配置启动失败。不要把 VPN 标记当成远端已连通的证据:它只说明系统侧的 VPN 会话已建立。看到客户端进入运行状态后,留在同一网络,继续做真实请求验证。

STEP 04 / VERIFY

验证是否生效

回到刚才用于记录基线的浏览器,打开一个新标签,再访问同一测试服务。不要只看先前已经加载的页面:浏览器可能直接使用缓存。若对照公网地址,尽量使用同一个查询服务、同一种地址类型,并刷新结果。出口出现符合预期的变化,可以帮助确认这次请求走了代理,但不能证明设备上的每个应用都使用了相同路径。

如果地址没有变化,先检查浏览器是否在接管范围内,再看测试目标是否命中了直连规则。打开客户端的「日志」,记下发起请求的时间,观察是否有对应的目标和出站记录。不同日志级别显示的信息不同;看到出站记录时,可以用它区分代理与直连,没看到时也不能仅凭日志为空判定连接失败。若结果仍不清楚,先不要同时修改 DNS、路由和活动配置,否则下一轮对照无法定位是哪一项产生了影响。

请求失败时,按现象缩小范围

如果连接前后都打不开测试页面,先换一个日常可用的页面判断基础网络是否正常。如果只有开启后才失败,先看客户端是否收到测试请求;没有请求时,优先回查系统代理、浏览器的独立代理选项或安卓分应用名单。若日志中有请求但持续超时,保持模式不变,换同一订阅内另一条已知可用的配置复测。若看到名称解析错误,先记录出错域名,再查 DNS 设置,不要根据一次超时直接判断是 DNS 故障。

客户端内的延迟测试可用于初筛配置,但探测成功不代表实际应用一定能连通。最终以目标应用中的新请求为准。若问题只在某一个应用中出现,而浏览器的对照测试已通过,优先排查应用自身的代理行为或分应用范围。需要理解 VpnService、路由或域名策略时,可查概念速查;若遇到订阅更新失败、授权后断开等具体症状,可继续看疑难解答。