QUICK START / 客户端操作

v2rayN 使用教程
订阅导入与连接验证

按四步完成首次连接:导入订阅,选择代理模式,启动连接,再验证实际请求。先使用客户端已有设置建立可工作的基线,再调整分流、DNS 或其他进阶选项。

尚未安装?查看客户端入口 →

开始前,准备已安装的客户端,以及有权使用的订阅地址或节点分享链接。客户端负责读取配置、调用内核和接管本机请求,本身不提供可连接的远端服务器。若手头只有客户端安装文件,尚未取得连接参数,应先补齐这部分信息。订阅地址可能包含访问凭据,不要放进公开截图、聊天记录或故障反馈附件。

首次操作建议暂时关闭其他代理客户端,保留正常联网环境。订阅更新需要访问订阅服务器,而节点连接需要访问节点服务器,这两条路径未必相同。先确认普通网页能够打开,再开始导入,可以减少把本机断网误判为配置问题的情况。

第一步:导入订阅并确认节点

先判断拿到的内容是什么。订阅地址用于获取一组服务器配置,通常需要添加到订阅分组后执行更新;单节点分享链接则直接描述一个服务器,通常从剪贴板导入。不要仅凭地址开头判断二者用途,以配置提供方的说明为准。如果对“订阅”和“节点”的关系不熟悉,可先查看术语手册,再回到本步骤继续。

v2rayN:添加分组,再更新订阅

打开 v2rayN 主窗口,在顶部菜单寻找“订阅分组”或同类入口,进入订阅分组设置。新增一条记录,在备注中填写便于识别的来源名称,把完整订阅地址粘贴到 URL 地址栏。检查首尾是否混入空格、换行或聊天软件附带的标点,然后保存。分组名称只影响本地整理,不会改变远端连接参数。

回到主界面,在订阅菜单中对新建分组执行更新。首次尚未建立可用代理时,若界面区分“通过代理更新”和“不通过代理更新”,应根据当前订阅地址实际可达的路径选择;本机尚未启动的代理不能承担更新请求。执行后查看底部日志,等待出现更新结果,再切换到对应分组查看服务器列表。

看到分组名称并不等于导入成功。应确认列表内出现了具体服务器条目,并检查名称、协议和端口等信息是否已经填入。如果更新显示失败,先核对地址是否过期、是否复制完整,再判断是否为访问路径问题。不要连续新增多个相同分组;保留一条记录修改即可,避免后续更新产生重复列表。

v2rayNG:在订阅设置中保存地址

安卓端打开 v2rayNG,从菜单进入订阅分组设置,使用新增入口填写备注和订阅地址,保存后返回节点列表。接着从主界面菜单执行更新订阅,等待服务器条目载入。如果拿到的是单节点链接,复制完整链接后使用“从剪贴板导入”一类入口;二维码导入也应确认图片来自可信的配置来源。

导入完成后,点击准备使用的节点,使其成为当前选中项。桌面端可先选中条目,下一步再设为活动服务器;安卓端通常会通过边线或选中标记体现选择结果。此时先不要批量编辑协议参数,也不要把多个来源的字段拼在一起。保留原始导入配置,能够在后续失败时区分问题来自订阅本身还是手动改动。

本步结束的判断标准是:列表中存在可识别的服务器,而且已经明确准备测试哪一条。订阅是否能更新、节点是否能连接是两个独立结果;列表出现后,继续设置流量进入客户端的方式。

第二步:选择代理模式与路由

界面中的“模式”可能指不同层次。系统代理、VPN 通道或 TUN 决定应用流量怎样进入客户端;规则、全局代理或直连决定进入内核的请求怎样出站。先把这两层分开,再设置开关,就不会把“选择全局路由”误认为“所有应用已经接入代理”。本教程先使用较少改动的接管方式,复杂规则留到连接验证之后。

桌面:先使用系统代理

在 v2rayN 主窗口或托盘菜单寻找“系统代理”,准备选择“自动配置系统代理”或含义相同的选项。它会让遵循系统代理设置的应用把请求交给本机监听端口。部分应用有自己的网络设置,另一些程序直接建立连接,因此系统代理生效不代表所有进程都会经过客户端。首次验证应选择遵循系统代理的浏览器,而不是先测试具有独立代理设置的软件。

路由先选择客户端已有的规则配置,保留私有地址等必要直连规则。不同版本的预设名称可能不同,应阅读其说明后再选。需要临时排除分流影响时,可以对已经接管的请求使用全局代理进行对照,但完成测试后应恢复预期规则。全局路由也不能接管原本没有进入客户端的流量。

首次配置不必同时开启 TUN。TUN 通常涉及虚拟网络接口、路由和额外权限,实际支持情况取决于客户端、所选内核及系统环境。如果系统代理已经满足使用需求,先保持这一条路径。确实需要接管更多应用时,再参考配置大全检查相关能力,避免同时修改多个开关后难以判断是哪项设置造成变化。

安卓:检查 VPN 服务和应用范围

v2rayNG 通常使用系统 VPN 服务把流量送入本机代理处理链。进入设置检查当前服务模式,首次按客户端默认 VPN 方式操作即可。如果曾经配置过分应用代理,还要查看是否使用了“仅代理所选应用”或绕过列表;测试用的浏览器若被排除,即使连接图标出现,也可能不会走预期路径。

同一系统用户环境下,其他 VPN 类应用可能与 v2rayNG 争用通道。测试前先断开其他此类连接,不要反复切换多个服务。路由仍优先使用已有预设,不在这一步修改 DNS、自定义域名列表或协议传输字段。确定接管方式和路由后,下一步才启动选定节点,并检查内核是否正常运行。

第三步:启动连接并检查日志

现在回到节点列表,核对当前选择与第一步准备测试的条目一致。节点名称只是备注,不能单独证明协议、传输或凭据正确;首次连接应尽量保留订阅生成的完整参数。如果配置要求某项特定内核能力,应使用支持该能力的内核,不要仅因名称相近就直接切换。内核及协议概念可在术语手册中查阅。

v2rayN:设为活动服务器

在目标节点的右键菜单或对应操作菜单中,选择“设为活动服务器”一类命令。等待客户端加载配置并启动内核,观察日志区域是否出现启动错误;随后按第二步设置系统代理。部分版本会在切换活动服务器时自动重启内核,另一些操作需要手动重启,按当前界面提示完成,不要在日志尚未输出结果时连续重复点击。

日志首先看是否有配置加载失败、监听端口占用、无法识别的协议字段等错误。这类信息通常说明本机处理链尚未建立,应先修复启动问题,而不是更换浏览器。如果提示端口被占用,检查是否仍有另一份客户端或其他代理程序运行;若修改本地监听端口,所有手动填写该端口的应用也需要一起更新。

v2rayNG:连接并确认系统授权

在安卓端选中节点后,点击主界面的连接按钮。首次启动时,系统可能弹出 VPN 连接请求;确认发起应用是刚安装的客户端,再按系统提示授权。授权后查看客户端连接状态和系统状态栏的 VPN 标记。若授权被取消,返回主界面重新启动即可,不需要为了同一个提示反复删除订阅或重装客户端。

连接标记出现只说明本地服务已启动,不能证明远端服务器一定可达。若日志持续出现超时或握手失败,记录当前错误类型,再检查设备时间、节点参数和网络连接。设备日期明显偏差可能影响加密连接验证,应先恢复正常时间。不要把日志中的访问地址和订阅凭据一起公开提交;需要分享时,先移除可识别账户的信息。

若客户端提供连接测试,可对当前节点执行一次作为辅助观察。测试失败不一定代表所有目标均不可访问,测试成功也不代表目标应用已经接入。确认内核能够保持运行、没有反复启动退出后,继续下一步实际访问验证。详细错误分类放在常见问题中,本教程先沿着单节点、单应用的路径完成闭环。

第四步:验证实际访问与退出恢复

使用一个设置明确的浏览器,打开计划经代理访问的 HTTPS 页面。测试时尽量新开页面或刷新请求,不只观察已经缓存的标签页。如果浏览器配置了独立代理扩展或手动代理,先明确它是否覆盖系统设置;安卓端则再次确认浏览器没有被分应用规则排除。只有应用确实进入客户端,后面的路由判断才有意义。

一边发起访问,一边查看客户端日志。部分日志级别会显示目标域名、连接结果或出站标签;若能看到对应请求,可继续判断它是走代理还是按规则直连。没有相关记录时,先检查接管方式,而不是立刻修改节点。日志级别较低也可能省略普通连接记录,必要时临时提高到适合排查的级别,测试结束后恢复,避免积累过多访问记录。

区分三种验证结果

第一种是页面正常打开,并且日志或应用路径能够对应到预期代理,这时才算完成本次目标验证。第二种是普通页面能开,但计划代理的页面失败,应检查该请求的路由结果、节点连接以及目标服务本身。第三种是开启后所有页面都失败,先停止连接恢复普通网络,再检查本地监听、系统代理和 DNS;不要在失去基线的情况下继续叠加新设置。

若要通过出口信息辅助判断,应使用自己信任的检测方式,并确认被测请求确实匹配代理规则。规则模式下不同目标可能使用不同出口,一个页面显示的地址不能代表所有应用。节点测试数值也只是特定测试路径的结果,不应据此推断完整使用体验。实际验证以需要使用的页面或应用能否按预期访问为准。

出现问题时,每次只改变一项设置,然后重复同一个请求。例如先保持路由不变,仅换一条已导入节点;或者保持节点不变,临时用全局路由对照。不要同时换节点、切内核、启用 TUN 和修改 DNS,否则即使访问恢复,也无法知道真正起作用的是哪一步。需要深入检查字段时,转到路由配置参考,不要直接编辑不理解的生成配置。

停止连接并恢复普通网络

验证结束后,也应做一次退出测试。桌面端先在 v2rayN 中清除系统代理,再退出客户端,确认浏览器仍可使用普通网络。如果直接关闭内核却保留了指向本机端口的系统代理,应用可能继续向一个已经停止的服务发送请求,从而表现为断网。遇到这种情况,应检查系统代理残留,而不是立即重置整套系统网络。

安卓端点击停止连接,确认 VPN 标记消失,再测试普通访问。重新打开客户端时,检查活动节点和路由是否仍符合预期。后续订阅更新可能调整节点条目,旧的选中记录也可能不再适用;更新后若连接异常,先回到列表重新选择节点,并按本页最后两步检查启动和访问结果。