约 10 分钟 · 四步完成

SETUP GUIDE

v2rayN 订阅导入与连接教程

从一条可用的订阅地址开始,依次完成分组更新、代理模式选择、节点连接和生效验证。本文只处理首次使用所需的操作路径,协议、内核与复杂路由原理可继续查阅术语手册和完整文档。

订阅分组 代理模式 活动节点 生效验证
准备工作

开始前检查客户端与订阅地址

开始操作前,需要准备已经安装完成的客户端和一条有效的订阅地址。桌面设备使用 v2rayN,安卓设备使用 v2rayNG。订阅地址通常是一段以 https:// 开头的完整链接,它不是单个 VMess、VLESS 或 Trojan 配置,也不是网页账户的登录地址。复制时应从第一个字符一直保留到最后一个字符,避免遗漏查询参数、误带空格或换行。

如果客户端尚未安装,先前往下载中心选择对应平台。安装完成后打开客户端,不要急着调整 DNS、TUN、端口或自定义路由。首次配置的目标是先建立一条可以验证的基础连接;一次改动太多设置,会让后续无法判断问题来自订阅、节点、代理模式还是本机网络。

还应检查设备时间与时区是否正确。部分协议会使用时间信息参与连接过程,系统时间偏差过大时,配置看似完整却可能无法完成握手。建议开启系统自动设置时间,然后确认当前网络本身能够正常访问常用网页。如果基础网络已经断开,客户端也无法代替本地网络连接。

步骤 1

导入订阅并生成服务器列表

在 v2rayN 桌面端中,先打开“订阅分组”相关菜单,选择添加或管理订阅分组。新建分组时填写一个便于识别的备注,例如“日常订阅”,再把完整订阅地址粘贴到地址栏。保存后返回主窗口,再执行“更新全部订阅”或更新当前分组。客户端会读取订阅内容,并把其中的服务器配置整理到主列表中。

更新完成后,主窗口应出现若干可选择的服务器条目,常见列包括别名、地址、端口、协议和订阅分组。这里出现列表只代表订阅已经被解析,不代表每个节点都能够连接。此时先确认条目属于刚才建立的分组,协议与地址列不是空白,再继续下一步。如果保存了分组却没有看到任何条目,可以重新打开分组设置,检查链接开头、结尾以及中间是否混入空格,然后手动更新一次。

在 v2rayNG 安卓端中,打开右上角菜单,进入订阅分组设置或订阅设置页面,点击添加按钮。填写备注和订阅地址后保存,回到主界面,再从菜单中执行更新订阅。更新期间保持当前网络连接,完成后主界面会出现服务器配置列表。点击页面顶部的分组名称,可以确认当前显示的是哪个订阅分组,避免误以为更新失败,实际只是停留在另一个分组中。

如果订阅更新提示失败,不要连续修改协议参数。先把订阅地址重新复制到浏览器地址栏,确认它仍然是一条完整链接,但不要把打开后的内容另存为普通文本再导入。随后检查系统时间、当前网络以及订阅服务状态。运行日志中若出现解析失败、请求超时或返回内容为空,应先处理订阅读取问题;服务器参数只有在订阅成功生成列表后才值得检查。

订阅分组 更新完成后的检查顺序
分组名称 已显示
服务器列表 存在可选条目
运行日志 没有订阅解析错误

确认列表出现后,先不要同时导入多条订阅。保留一个分组更容易理解当前活动节点来自哪里,也方便在连接失败时排除重复配置和同名条目的干扰。订阅更新、节点测速与正式连接是三个不同动作:更新负责取得配置,测速负责尝试建立测试连接,正式连接则由活动节点和代理模式共同决定。

步骤 2

选择系统代理、路由规则或 TUN 模式

订阅列表准备好以后,需要决定哪些应用流量交给客户端。首次使用建议从系统代理开始。系统代理会修改操作系统提供的代理设置,浏览器和遵循系统设置的桌面应用通常会直接使用它。这个模式改动范围明确,关闭后也容易恢复,适合先验证订阅与节点本身是否能够工作。

在 v2rayN 桌面端中,找到系统代理菜单,将状态设为自动配置系统代理或开启系统代理。不同版本的文字可能略有差异,但启用后,状态栏或托盘菜单会明确显示系统代理已经打开。随后检查路由模式,首次操作可选择绕过局域网与常见直连地址的规则模式,不建议一开始就手写大量域名规则。规则从上到下匹配,某条请求命中直连规则后,就不会继续使用代理出站。

如果某些程序不读取系统代理设置,或者需要接管更多类型的网络请求,可以在基础连接验证成功后再考虑 TUN 模式。TUN 会建立虚拟网络接口,把更广范围的流量送入客户端处理,因此通常需要系统权限。开启时如果系统出现权限确认,应核对请求来自当前客户端再继续。TUN 与系统代理并不是越多越好;初次排查时只启用一种主要接管方式,能够减少端口冲突、重复转发和路由叠加。

在 v2rayNG 安卓端中,点击主界面的连接按钮后,系统会出现建立网络连接的授权提示。确认后,客户端才能接收需要处理的应用流量。分应用代理、绕过局域网和路由规则都属于进一步控制范围的选项,第一次连接可先保持默认规则。等网页访问和日志都正常后,再根据实际需求决定是否只让指定应用使用连接。

系统代理

适合浏览器和遵循操作系统代理设置的应用。首次连接优先使用,设置路径清楚,便于判断节点和订阅是否正常。

TUN 模式

适合不读取系统代理的应用或需要统一接管的场景。应在基础连接已经验证后启用,并留意系统权限、DNS 与路由设置。

代理模式决定流量是否进入客户端,路由规则决定进入后的流量走直连、代理还是阻断。两者不能混为一谈。看到客户端处于运行状态,但浏览器请求没有出现在日志里,通常应先检查系统代理或连接授权;日志已经出现请求,却无法访问目标地址,才继续检查节点、DNS和路由出站。更完整的规则优先级、域名匹配与 TUN 配置说明放在完整文档中,本教程只保留首次连接需要的设置。

步骤 3

选择活动节点并建立连接

代理模式确定后,回到服务器列表选择一个节点。在 v2rayN 桌面端中,可以双击目标条目,或通过右键菜单把它设为活动服务器。成功选中后,当前服务器名称通常会出现在状态栏、托盘提示或列表标记中。仅仅单击高亮一行不一定代表已经切换活动服务器,因此需要观察状态区域是否同步变化。

节点较多时,可以先使用真连接延迟测试缩小范围。真连接测试会按照节点配置尝试建立实际连接,比只看网络层响应更接近真实使用情况。测试完成后,优先选择能够返回结果且状态稳定的条目,不需要反复追逐最低数字。测试失败的节点可以稍后再查,不要一次选择多个节点或频繁快速切换,因为旧连接尚未结束时,日志会混入不同节点的记录。

在 v2rayNG 安卓端中,点击列表中的某个配置,使它成为当前选中项,然后点击底部连接按钮。首次连接会请求系统授权,确认后状态栏会显示连接图标,客户端页面也会把按钮切换为已连接状态。如果按钮很快恢复为未连接,应立即打开日志查看原因,而不是连续点击。常见方向包括服务器不可达、参数不匹配、域名解析失败和系统时间不正确。

连接建立时,客户端会读取当前节点参数并启动本地监听。v2rayN 桌面端还需要确保系统代理指向客户端实际使用的本地端口。通常客户端会自动完成这项配置,不必手工修改浏览器端口。若此前安装过其他网络工具,应暂时关闭它们的系统代理和虚拟网络功能,避免多个程序同时占用设置或轮流覆盖系统代理。

如果列表里的所有节点都无法完成真连接测试,先切回一个普通网络环境重新尝试,并手动更新订阅。单个节点失败通常更换节点即可;同一订阅内全部节点同时失败,则应检查订阅是否过期、设备时间、DNS 和客户端版本。关于 timeoutrejected、握手失败等日志词的含义,可在术语手册中查看基础解释。

步骤 4

从状态、访问结果和日志验证是否生效

客户端显示“已连接”只说明本地服务已经启动或系统连接已经建立,不能单独证明目标流量确实经过了所选节点。验证应按三个层次进行:先看客户端状态,再用浏览器发起新请求,最后观察运行日志是否出现对应记录。三项结果互相印证,才能确认代理模式、路由规则和节点连接都在工作。

第一层是状态检查。v2rayN 桌面端应保持活动服务器名称可见,系统代理状态与刚才选择的模式一致;v2rayNG 安卓端应保持连接状态,系统状态栏中的连接标记没有立即消失。若状态不断在连接与断开之间切换,应先查看日志,不要继续测试网页,因为此时基础连接尚未稳定。

第二层是浏览器访问。先完全关闭原有的测试标签页,再打开一个新的浏览器窗口访问平时可以正常打开的网站,确认本地网络仍然可用;随后访问需要通过当前代理规则处理的目标页面。使用新窗口可以减少旧连接、缓存和扩展设置造成的干扰。如果一个浏览器可以访问而另一个不行,问题通常在浏览器自己的代理、扩展或安全设置,不应立刻更换订阅。

第三层是运行日志。发起网页请求时,切回客户端日志页面,观察是否出现新的连接记录。能看到目标域名、路由匹配或出站连接记录,说明请求已经进入客户端;完全没有新记录,则优先检查系统代理、浏览器独立代理设置或安卓端连接授权。日志中出现请求但随后超时,需要检查当前节点、DNS 或目标路由;日志显示请求被分配到直连出站,则需要确认现有规则是否符合预期。

01
客户端状态保持稳定

活动节点、系统代理或连接状态没有自动恢复为关闭。

02
新建页面能够完成访问

使用新窗口或新标签发起请求,避免只观察旧页面缓存。

03
日志出现对应请求

根据出站结果确认流量进入客户端,并按路由规则处理。

还可以通过关闭系统代理或断开 v2rayNG 后重新访问同一页面进行对照。状态变化应与访问结果相符,重新连接后日志也应再次出现新记录。对照测试比只看页面是否打开更可靠,因为部分网页可能来自缓存,部分域名也可能被规则设为直连。

命令行终端是另一种情况。许多终端工具不会自动读取桌面系统代理,因此浏览器已经生效,终端请求仍可能直连。这不代表 v2rayN 连接失败。需要在终端中使用代理时,应根据工具自身的代理参数配置,不要为了让单个命令生效就立即开启全部流量接管。完整的终端、DNS 与路由排查流程可继续查看完整文档

完成配置

日常更新、切换与退出的正确顺序

首次验证完成后,日常使用通常只涉及更新订阅、切换活动节点和开关连接。订阅不需要在每次启动时重复添加,保留现有分组并执行更新即可。更新后如果当前节点已从列表中移除,应重新选择一个活动节点;如果仍然存在,可以先保持当前选择,确认连接正常后再决定是否切换。

切换节点时,先在列表中选择新的活动节点,再观察状态栏和日志是否已经使用新配置。不要通过删除整个订阅分组来完成切换,也不要频繁重新导入相同链接。分组负责管理配置来源,活动节点负责当前连接,两者各自承担不同作用。理解这一点可以避免列表重复、备注混乱以及更新后找不到当前节点。

暂时不用客户端时,v2rayN 桌面端应先关闭系统代理或退出连接模式,再退出程序,避免操作系统仍保留已经失效的本地代理地址。v2rayNG 安卓端可以直接点击断开按钮,确认连接状态结束后再关闭应用。下次使用时先启动客户端、确认活动节点,再开启系统代理或连接,不必重新完成全部四步。

当连接突然失效时,按本文顺序逆向检查最省时间:先看日志与连接状态,再确认活动节点,然后检查代理模式,最后更新订阅。这样可以快速区分是单个节点变化、流量没有进入客户端,还是订阅本身无法读取。需要配置自定义路由、DNS、TUN 细节或多平台差异时,再进入完整文档继续处理。