QUICK START · 10 MINUTES

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

这份入门流程只处理第一次配置所需的四件事:加入订阅、确定代理模式、连接节点、验证链路。按顺序操作即可,不需要先理解全部协议参数。

适用客户端 v2rayN · v2rayNG 操作步骤 4 预计用时 约 10 分钟

按步骤跳转

BEFORE START

操作前准备

开始前需要准备客户端和一条仍在有效期内的订阅地址。桌面设备使用 v2rayN,Android 设备使用 v2rayNG;如果尚未安装,可先前往安装包页面选择对应平台。完成安装后先正常启动客户端,不要同时开启其他会修改系统代理、虚拟网卡或 DNS 的网络工具,以免后面无法判断是哪一个程序接管了流量。

订阅地址由节点服务提供方生成,通常是一段以 https:// 开头的链接。它不是客户端自动创建的账号,也不是随安装包附带的公共服务器。复制时应完整保留链接中的路径和参数,不要遗漏末尾字符,不要把网页控制台的登录地址误当作订阅地址。如果服务方同时提供多种订阅格式,应选择标明适用于 V2Ray、v2rayN 或 v2rayNG 的格式。

还需要确认设备的日期、时间和时区正确。TLS 连接依赖证书有效期判断,系统时间偏差可能直接导致握手失败。桌面端建议先允许系统自动校时;Android 端同样应开启自动日期与自动时区。若设备处在单位网络、公共网络或需要网页认证的网络环境中,先关闭客户端并确认普通网页可以打开,再进入后续配置。基础网络本身不可用时,客户端无法建立出口连接。

第一次操作不必手动编辑服务器端口、传输方式、TLS、SNI 或用户标识。订阅更新成功后,这些字段会随节点配置写入客户端。手工改动其中任意一项都可能造成配置与服务端不一致。需要了解协议、传输与路由参数时,可在完成本教程后阅读全平台指南;当前流程只保留建立可用连接所需的最短路径。

CLIENT 客户端可以正常启动

窗口或主界面能够打开,未出现内核缺失与启动报错。

SUBSCRIPTION 订阅地址已完整复制

地址来自当前服务方,并且没有被聊天工具截断或添加空格。

NETWORK 基础网络处于可用状态

关闭代理后,设备能够完成当前网络要求的认证与普通访问。

SUBSCRIPTION

第一步:导入订阅并生成服务器列表

先在客户端中建立订阅分组,再执行更新。分组用于保存订阅地址和归类服务器,添加地址本身并不等于已经把节点加载到主列表;必须完成一次“更新订阅”操作,客户端才会请求远端内容并解析节点。首次配置时建议只添加一条订阅,确认整个流程可用后再处理多个分组,这样出现错误时更容易定位具体地址。

v2rayN 桌面端操作

打开 v2rayN 主窗口,在顶部菜单中找到“订阅分组”或名称相近的入口,然后进入订阅分组设置。选择添加新分组,在备注位置填写一个便于识别的名称,例如服务方名称或用途;在地址栏粘贴完整订阅链接。检查地址开头、末尾和中间参数没有空格后保存。备注只用于本地识别,不会改变服务器配置。

保存分组后返回主窗口,再打开订阅菜单,执行“更新全部订阅”或对刚建立的分组单独更新。更新期间不要连续重复点击。正常情况下,状态区域会显示下载与解析过程,几秒后主窗口服务器列表出现多条记录,常见列包括别名、地址、端口、传输类型和分组。只要列表已经生成,就可以进入下一步;此时还没有必要逐项修改节点字段。

v2rayNG Android 端操作

打开 v2rayNG 主界面,进入右上角菜单,找到“订阅分组设置”。点击添加按钮,新建一个分组,填写易于辨认的名称,并将订阅链接粘贴到地址栏。保存后回到主界面,再从菜单执行更新订阅。部分版本会让用户先选择当前分组,此时应确认选中的正是刚添加的分组,然后再执行更新。

更新完成后,主界面会显示服务器条目。点击任意条目只能完成选中,不代表连接已经启动;当前阶段只需确认列表不是空白,并且条目名称与服务方展示的大致一致。如果出现二维码扫描入口,也应优先使用服务方明确提供的订阅二维码,普通网页二维码或付款二维码不能作为服务器配置导入。

服务器列表出现后,订阅导入就算完成。后续不要急着点击每一个节点测试,也不要同时打开系统代理和 TUN。下一步先决定由哪一种方式接管应用流量,再连接活动节点;这个顺序可以避免客户端显示运行中,但实际流量仍由另一套设置处理。

下一步选择代理模式 →

ROUTING MODE

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

节点决定流量从哪个出口转发,代理模式决定哪些应用与请求会交给客户端。两者是不同层级:即使节点配置完全正确,如果系统或应用没有把流量送入客户端,网页仍会沿原网络直连;反过来,如果接管方式已经开启但节点不可用,浏览器会表现为连接超时。因此第一次配置应先采用影响范围清晰、容易撤销的模式。

桌面端先从系统代理开始

在 v2rayN 任务栏菜单或主窗口的系统代理区域,将系统代理切换为启用状态。菜单名称通常包含“设置系统代理”,启用后任务栏图标或状态文字会发生变化。系统代理主要接管遵循操作系统代理设置的浏览器和桌面应用,适合用来完成第一次连接验证。此模式不要求创建虚拟网卡,关闭时也容易恢复原状态。

随后检查路由模式。入门阶段可以选择客户端提供的规则模式,让常见本地请求直连、符合规则的目标经过代理。若临时排查某个目标是否被规则放行,可短时间切换到全局代理进行对照,但不建议把“全局”理解为所有进程必然都会被接管:是否进入代理仍取决于应用是否遵循系统设置。完成测试后,应根据实际用途恢复规则模式。

TUN 模式通过虚拟网卡接管更广范围的网络流量,适用于不读取系统代理设置的程序,但它会涉及路由表、DNS 和系统权限。第一次使用时不需要同时开启 TUN 与系统代理来增加“成功率”,这种叠加只会让故障路径更难判断。先用系统代理完成本教程;确认普通连接稳定后,再按照全平台指南中的 TUN 章节单独配置。

Android 端确认路由设置

在 v2rayNG 中打开设置或路由设置,选择适合日常使用的预定义规则。规则模式会按照域名和地址分类决定直连或代理,不需要在第一次配置时自行编写复杂规则。若只想快速确认节点能否工作,可以在测试期间选择覆盖范围更广的模式;验证完成后再切回常用规则,并重新测试关键应用。

Android 端建立连接时会使用系统提供的网络连接接口,因此无需另外寻找桌面端那种“设置系统代理”菜单。真正的接管动作发生在下一步点击连接按钮时。本步骤只负责确认路由选择,没有必要提前打开分应用代理、绕过设置或自定义 DNS。每增加一层条件,都会增加一次规则不匹配的可能。

SYSTEM PROXY

系统代理

适合桌面端首次配置,主要覆盖遵循系统代理设置的浏览器和应用,启停状态清楚。

TUN

TUN 模式

接管范围更广,需要处理虚拟网卡、路由和 DNS,建议在基础连接验证后再配置。

ROUTING

规则分流

决定目标走直连还是代理,不改变节点本身;规则选择应与当前使用目标一致。

模式选择完成后,先保持设置不变。下一步只做两件事:指定一个活动节点并启动连接。若连接失败,固定的代理模式能够作为排查基线,避免在节点、路由和接管方式之间反复切换。

下一步选择节点并连接 →

CONNECT

第三步:选择活动节点并建立连接

进入服务器列表后,先选择一条来自刚更新订阅的节点。节点名称一般包含地区、线路或服务方自定义备注,但名称不代表当前一定可用。第一次连接不需要追求最低延迟,也不要一次选中多条记录;客户端在同一时刻只会使用当前活动服务器,明确这一条记录更方便查看日志与更换测试。

v2rayN 桌面端连接

在主列表中单击目标节点,然后通过右键菜单或顶部服务器菜单执行“设为活动服务器”。设置成功后,该行通常会出现颜色、标记或选中状态变化。接着确认客户端核心已经启动,窗口底部状态区不应持续显示停止或启动失败。如果系统代理还未按上一步启用,现在将其切换到启用状态。

将 v2rayN 主窗口最小化并不等于退出,任务栏区域仍可保留运行状态;直接从菜单执行退出则会停止核心,并可能恢复系统代理设置。测试期间不要结束后台进程。若操作系统弹出网络访问或防火墙提示,应根据当前可信网络环境允许客户端进行必要通信,否则本机监听端口可能无法被浏览器使用。

v2rayNG Android 端连接

在主界面点选目标服务器,使其成为当前配置,然后点击底部连接按钮。首次连接时系统会显示网络连接确认窗口,阅读提示后允许本次连接。成功启动后,连接按钮状态会改变,系统状态区域也会显示连接标识。此时应保持 v2rayNG 在后台运行,不要立即执行强制停止或限制其后台活动。

如果连接按钮点击后立刻恢复到未连接状态,打开日志查看最靠近失败时间的几行信息。常见方向包括服务器地址无法解析、端口不可达、TLS 握手失败、配置字段缺失或本地端口冲突。日志中的第一条错误通常比后续重复重试更有定位价值。不要在没有记录错误信息的情况下连续更换所有设置,否则很难判断究竟是哪一次改动产生了影响。

若第一个节点无法启动,可在不改变代理模式的前提下换用同一订阅中的另一条节点。替换时先断开当前连接,重新设为活动服务器,再启动一次。两条节点表现不同,问题更可能集中在单个节点;多条节点都出现相同本地端口或权限错误,则应优先检查客户端环境。详细日志分类可转到疑难解答的故障排查部分

当客户端状态稳定保持运行、日志没有持续刷出错误后,链路已经具备验证条件。此时仍不能只凭图标颜色判断完成,因为系统代理、路由和 DNS 可能让不同应用得到不同结果。保持当前节点与模式不变,继续进行浏览器和日志的双重验证。

下一步验证代理是否生效 →

VERIFY

第四步:验证代理、路由与应用接管

验证应从简单请求开始,并且一次只改变一个条件。先关闭浏览器中可能独立控制代理的扩展,重新打开一个普通窗口。访问此前在不使用客户端时就能正常打开的网页,用它确认基础网络没有因为代理设置而完全中断;随后再打开需要经过代理的目标页面。两个结果结合起来,才能区分基础网络、代理节点和分流规则的问题。

检查客户端是否收到请求

保持浏览器发起访问,同时观察 v2rayN 或 v2rayNG 的连接日志。如果日志出现与当前访问时间一致的新记录,说明应用流量已经进入客户端;若页面失败但日志完全没有变化,问题通常位于流量接管之前,应检查桌面端系统代理是否开启、Android 端连接是否仍处于活动状态,以及浏览器是否设置了独立代理。

日志已经出现请求但随后报连接超时、连接被拒绝或握手错误时,说明流量进入了客户端,但未能顺利通过当前节点到达目标。此时不要改动系统代理,先换同一订阅中的另一条节点重新测试。若替换后恢复,保留可用节点并等待服务方处理原线路;若所有节点报相同错误,再检查设备时间、订阅是否过期以及网络是否限制了相关连接。

确认路由结果符合预期

如果部分网页可以打开、部分网页始终直连或失败,应检查当前路由模式。将模式临时切换到覆盖范围更广的选项,然后重新加载同一页面;若结果发生变化,说明节点连接基本可用,差异来自规则匹配。接下来应恢复日常规则,并在全平台指南中核对域名规则、地址规则和 DNS 处理,而不是长期依赖测试模式掩盖规则问题。

桌面端还可以更换一个明确遵循系统代理设置的浏览器进行对照。如果一个浏览器正常、另一个浏览器没有任何日志,通常是后者设置了独立代理、扩展规则或绕过列表。Android 端若只有某个应用失败,应先确认是否启用了分应用代理,以及该应用是否被包含在接管范围内。不要因为单个应用的表现直接判定所有节点不可用。

执行一次断开对照

连接验证完成后,主动断开客户端,再刷新刚才用于测试的目标页面。页面行为应与连接状态产生可解释的变化,同时日志不再新增代理请求。随后重新连接,确认访问恢复。这个对照可以排除浏览器缓存、已建立连接或页面离线内容造成的误判,也能帮助理解系统代理开关与客户端核心运行状态之间的关系。

01 基础网页

确认当前网络没有因配置变更而整体中断。

02 目标网页

检查需要经过代理的请求能否完成加载。

03 客户端日志

确认请求进入客户端,并辨别失败发生在哪一段。

04 断开对照

排除缓存和旧连接,确认结果确实随连接状态变化。

当普通网页、目标网页与客户端日志均符合预期,并且断开与重连能够产生一致结果,基础配置就完成了。此时可以记录当前订阅分组、活动节点和路由模式,后续出现问题时先恢复到这套已验证状态,再逐项增加 TUN、自定义 DNS或分应用规则。

继续完成后的日常检查 →

AFTER SETUP

完成后的日常检查

订阅不会因为首次导入成功而永久保持不变。服务方调整节点或参数后,需要在原分组上执行更新订阅,客户端才会取得新列表。更新前可记住当前活动节点,更新后检查它是否仍存在;如果条目被替换,应重新选择一条节点并完成一次连接验证。不要反复新建相同分组,否则列表中会出现重复服务器,后续难以确认实际使用的是哪一份配置。

桌面端退出客户端前,应留意系统代理状态。正常退出通常会执行恢复,但设备异常关机或进程被强制结束时,系统可能保留旧代理地址,表现为重新开机后浏览器无法访问。遇到这种情况,重新启动 v2rayN 后关闭系统代理,或在操作系统网络设置中将代理恢复为关闭状态。Android 端不再使用时,直接在 v2rayNG 中断开连接,确认状态区域的连接标识消失。

节点突然不可用时,排查顺序应保持固定:先确认普通网络,再更新订阅,然后更换节点,最后查看日志。不要一开始就重装客户端或删除全部配置,因为这样会同时丢失可对照的信息。若问题只发生在某个应用,优先检查应用代理与路由;若所有请求都不进入日志,检查流量接管;若请求进入后统一失败,再检查节点、DNS、系统时间和服务状态。

BASELINE SAVED

保留一套已经验证的基础配置

订阅分组、活动节点、路由模式和接管方式构成排查基线。后续每次只修改一项,并重复连接与断开对照,可以快速判断变化发生在哪个环节。

下载客户端