QUICK SETUP / 10 MINUTES

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

按固定顺序完成四件事:导入订阅选择代理模式建立连接验证结果。本页聚焦首次配置,不展开复杂路由与底层字段。

BEFORE START

开始前检查:客户端、订阅与系统时间

开始操作前,先确认客户端已经能够正常启动。桌面端打开 v2rayN 后,应当能看到主窗口、菜单栏或系统托盘图标;Android 端打开 v2rayNG 后,应当能进入配置列表页面。若程序启动后立即退出、界面无法打开或反复提示运行环境缺失,应先处理安装问题,而不是继续导入订阅。安装文件与平台选择说明集中在获取客户端页面

第二项准备是可用的订阅地址。订阅地址通常是一段以 https:// 开头的完整链接,它指向一份可以更新的节点清单。复制时要从第一个字符一直复制到最后一个字符,不要带上聊天软件中的说明文字,也不要手动删除链接尾部参数。单条以 vmess://vless:// 开头的内容属于分享链接,导入入口与订阅地址不同;本教程先按订阅地址讲解,单条分享链接可以在客户端的“从剪贴板导入”或类似入口中添加。

第三项准备是系统时间。部分协议的握手与认证依赖准确时间,如果电脑或手机时间偏差较大,节点参数完全正确也可能连接失败。建议开启系统自动设置日期、时间和时区,然后重新启动客户端。还要确认当前网络本身可以正常访问常用网页;若基础网络已经断开,客户端日志里出现的连接失败并不能直接说明订阅或节点有问题。

不要在首次配置时同时调整大量高级设置。保留默认本地端口、默认 DNS 与默认路由规则,只完成一条最短验证链路。等到基本连接已经成立,再到配置大全了解入站、出站、路由与 DNS 字段。这样可以避免多个改动互相叠加,出现问题时也更容易定位具体环节。

客户端可正常打开

主窗口、托盘菜单或配置列表可以操作。

订阅地址复制完整

保留链接参数,不混入空格与说明文字。

基础网络与时间正常

先排除断网、错误时区和明显时间偏差。

SUBSCRIPTION

导入订阅并生成节点列表

订阅导入的目标不是仅把地址保存进客户端,而是让客户端访问该地址、读取配置并在主界面生成节点列表。因此,“添加订阅”和“更新订阅”是两个连续动作。只完成添加而没有更新时,订阅分组可能已经存在,但节点区域仍然为空,这是首次使用中最常见的误判之一。

v2rayN 桌面端操作

打开 v2rayN 主窗口,在顶部菜单中找到“订阅分组”“订阅设置”或名称相近的入口。进入订阅管理窗口后,选择新增分组,为它填写一个便于识别的备注,例如“常用订阅”。随后把完整订阅地址粘贴到 URL 输入框。备注只用于本地辨认,不影响连接;真正决定能否获取节点的是 URL 内容。

保存后回到主窗口,再次打开订阅相关菜单,执行“更新全部订阅”或对刚才的分组单独更新。客户端会请求订阅内容并解析配置。更新完成后,主列表通常会出现多条记录,并显示别名、地址、端口、协议或订阅分组等字段。不同版本的列名和排列方式可能不同,不需要逐列修改;只要列表中出现节点,就说明订阅获取与解析阶段已经完成。

如果更新时弹出错误提示,先不要连续点击。查看主窗口底部状态信息或日志区域,区分“无法访问订阅地址”和“订阅内容无法解析”两类问题。前者通常与地址不完整、当前网络无法访问或订阅服务暂时不可用有关;后者则可能是复制了网页地址、登录页地址,或者内容格式并非客户端支持的订阅格式。重新从提供方复制完整链接后,再替换原地址并执行一次更新。

v2rayNG Android 端操作

打开 v2rayNG,在主界面进入左上角菜单或右上角操作菜单,找到“订阅分组设置”。新增订阅分组后,填写可辨认的名称并粘贴完整地址,然后保存。返回配置列表,打开订阅操作菜单,执行更新当前分组或更新全部订阅。更新过程结束后,配置列表中会出现节点条目,当前选中的条目通常带有高亮或勾选状态。

Android 系统可能对后台网络活动、电池使用和数据流量设置限制。首次更新订阅时,保持 v2rayNG 位于前台并等待结果,不要刚点击更新就切换到其他应用。如果列表仍为空,确认 v2rayNG 拥有正常联网权限,并检查当前 Wi-Fi 或移动网络是否能访问订阅地址。订阅成功一次以后,后续更新仍建议在客户端前台完成,以便立即看到错误提示。

看到节点列表后再继续

完成本步骤的判断标准很明确:主界面中至少出现一条可选择的节点记录。此时先不要批量修改节点参数,也不要把多个来源的订阅同时导入。选择一个订阅分组完成后续连接,可以减少重复名称、失效节点和不同规则互相混杂的问题。列表已经出现后,下一步才是确定客户端如何接管流量。

PROXY MODE

选择代理模式与系统接管方式

节点已经进入列表,但这并不代表浏览器流量会自动经过客户端。代理模式决定流量如何分流,系统代理或系统连接授权则决定应用流量能否进入客户端。可以把这一步理解为两层开关:第一层选择“哪些请求需要处理”,第二层让操作系统把这些请求交给客户端。

首次使用优先选择规则模式

常见模式包括规则模式、全局模式和直连模式。规则模式会根据客户端已有规则区分直连与代理流量,适合日常使用,也是首次配置更稳妥的起点。全局模式会让更多流量经过当前节点,适合临时判断某个访问问题是否由分流规则造成,但不建议在还没有确认节点可用时长期使用。直连模式通常用于暂停代理处理或对照测试,选中后即使内核仍在运行,目标网站也可能继续通过本地网络访问。

不同版本可能把这些选项称为“路由模式”“预定义规则”或“代理模式”。名称虽然有差异,判断方法一致:看到“规则”“绕过局域网”或客户端预置规则时,先选择默认规则方案,不要立刻编辑自定义 JSON。复杂的域名匹配、IP 匹配、入站标签和 DNS 分流属于进阶配置,可以在基本连接验证完成后查看配置大全中的路由章节

v2rayN:模式之外还要开启系统代理

在 v2rayN 中选定规则模式后,查看系统托盘中的客户端菜单。找到“系统代理”,选择自动配置系统代理或名称相近的启用项。启用后,托盘图标或菜单状态通常会发生变化,表示 Windows、macOS 或 Linux 桌面环境中的兼容应用可以读取系统代理设置。若只选中了节点、内核也已经启动,但系统代理保持关闭,浏览器可能仍沿用原来的直连路径。

部分浏览器或应用使用独立网络设置,不一定跟随系统代理。首次验证时应先用遵循系统设置的常用浏览器,不要同时安装多个代理管理扩展,也不要手动改浏览器代理端口。等客户端连接确认有效后,再单独处理不跟随系统设置的应用。这样可以清楚区分“客户端没有连接”和“某个应用没有读取系统代理”这两个不同问题。

v2rayNG:确认连接模式与应用范围

v2rayNG 通过 Android 的系统连接接口接管流量。首次使用保持默认路由设置即可,不需要先开启复杂的分应用代理。如果此前调整过“绕过局域网”“分应用代理”或自定义规则,建议暂时恢复到简单配置,确保用于测试的浏览器确实包含在处理范围内。分应用代理选错时,客户端界面会显示已连接,但被排除的应用仍然走原网络,这种现象容易被误认为节点失效。

在这一阶段不必反复切换全局与规则模式。先固定规则模式完成一次连接和网页验证;如果目标页面无法打开,而日志显示连接已经建立,再用全局模式做一次短时对照。若全局模式可以访问、规则模式不行,问题更可能位于路由规则;若两种模式都不行,则应回到节点、订阅、网络和系统时间继续检查。

RULE 规则模式

根据预置规则分流,首次配置与日常使用优先选择。

GLOBAL 全局模式

用于短时对照测试,帮助判断问题是否来自分流规则。

DIRECT 直连模式

流量不经过当前代理链路,适合暂停处理与结果对照。

CONNECT

选择节点并建立连接

现在订阅列表已经存在,代理模式也已经确定,可以选择一个节点作为当前出站。首次连接不需要追求列表中看起来最复杂的协议或名称,也不要一次测试大量节点。先选一条来源明确、参数由订阅自动生成的节点,把整条链路跑通,再根据实际访问情况更换。

在 v2rayN 中设为活动服务器

回到 v2rayN 主列表,单击目标节点,然后通过右键菜单、回车操作或顶部菜单将它设为活动服务器。选中状态通常会以颜色、图标或状态栏文字标识。接着确认系统代理已经按上一步启用。客户端会启动对应内核,并根据当前节点生成运行配置。

连接启动后,先观察日志窗口。正常情况下会看到配置加载、本地监听端口启动以及内核运行等信息。日志持续停留不一定代表故障;很多客户端在没有新请求时不会不断输出内容。真正需要关注的是反复出现的连接被拒绝、名称解析失败、认证失败、端口占用或配置解析错误。出现明确错误时,记录第一条核心错误即可,不要只截取后续大量重复行。

如果提示本地端口被占用,说明同一端口可能正被另一个客户端、旧进程或浏览器代理工具使用。先完全退出其他同类程序,再从任务栏托盘确认 v2rayN 旧实例已经关闭,然后重新启动。首次配置不建议随意修改多个端口;只有确认占用无法解除时,才在设置中调整本地监听端口,并同步检查依赖该端口的应用设置。

在 v2rayNG 中点击连接

在 v2rayNG 配置列表中点击一条节点,使它成为当前配置,然后点击主界面的圆形连接按钮。第一次连接时,Android 会显示系统连接授权对话框。确认授权后,状态区域应由未连接变为已连接,系统状态栏也会出现对应的连接标识。若拒绝授权,客户端无法接管应用流量,需要再次点击连接并完成授权。

连接按钮显示已启动后,不要立即退出客户端。先停留几秒,打开日志或实时日志页面,确认没有快速重复的错误。然后切换到浏览器进行下一步验证。部分系统会对长时间位于后台的应用执行电池限制,如果出现刚连接正常、锁屏或切换应用后很快断开的情况,应检查 v2rayNG 的后台运行与电池使用权限,而不是不断重新导入订阅。

延迟测试只能作为筛选参考

客户端通常提供延迟测试、连接测试或批量测试功能。测试结果可以帮助排除完全无法响应的节点,但不能单独证明所有网站都能正常访问。延迟测试使用的目标、协议与实际浏览器请求可能不同;某条记录显示数值,只说明测试路径在当时获得响应。最终仍要以真实网页访问和客户端日志作为判断依据。

若第一个节点无法连接,可以在同一订阅分组中再换一条节点进行对照。每次切换后等待旧连接结束、新配置加载完成,再打开新的浏览器页面。连续快速切换会让日志混合多个节点的结果,反而难以定位问题。建议每次只改一个变量:先换节点,再测试;节点都失败时再检查模式、时间和网络。

VERIFY

验证连接是否真正生效

验证需要同时观察三处:浏览器访问结果、客户端当前状态、运行日志。只看其中一项容易得到错误结论。例如客户端显示已连接,只代表本地服务已经启动,不代表远端节点一定可达;浏览器能打开某个本来就可直连的网站,也不能证明请求经过了当前节点。

先做两组网页访问测试

保留客户端连接,打开一个新的浏览器窗口。先访问平时能够正常打开的常用网站,确认启用代理后基础浏览没有受到影响;再访问需要通过当前代理规则处理的目标页面。页面应当能够在合理时间内完成加载,刷新后仍保持稳定。若只有文字出现而图片、脚本或登录接口失败,说明连接可能并未完全正常,需要回到日志查看具体域名或连接错误。

测试时尽量关闭浏览器中其他代理扩展和独立网络工具,避免流量被二次改写。也不要只依赖已经打开很久的标签页,因为浏览器缓存可能让旧页面看起来仍可用。新建窗口、输入完整地址并执行刷新,可以更准确地触发新的网络请求。

核对客户端状态

在 v2rayN 中,检查活动服务器是否仍是刚才选中的节点,系统代理是否保持启用,托盘菜单中有没有意外切回直连。若浏览器完全没有触发任何日志记录,优先怀疑系统代理未开启、浏览器不跟随系统设置,或者浏览器扩展覆盖了代理配置。

在 v2rayNG 中,确认主界面仍显示连接中,系统状态栏的连接标识没有消失,并检查测试浏览器是否被包含在分应用处理范围内。若切到浏览器后连接立即停止,查看系统是否限制了 v2rayNG 的后台活动。若连接保持但没有请求记录,重点检查路由模式与分应用设置。

从日志判断问题所在层级

日志中能够看到目标请求被路由到哪个出站、连接在哪一步失败。出现域名解析相关错误时,先切回默认 DNS 设置并重新测试;出现超时或连接被拒绝时,换同一订阅中的其他节点对照;出现认证或握手错误时,先更新订阅,避免继续使用已经变更的旧参数;出现配置解析错误时,撤销最近手动修改的路由或核心设置。

不要根据单条偶发超时就立即重装客户端。网页通常会同时发起多条请求,某个统计资源或图片域名失败不一定影响主要页面。应当关注是否有同类错误连续出现,以及主页面是否可以稳定打开。定位时把“订阅能否更新”“节点能否启动”“应用流量能否进入客户端”“远端请求能否返回”四个阶段分开判断,排查会更直接。

连接成功后的收尾

确认浏览器访问和日志都正常后,可以保留当前节点与规则模式。桌面端如需开机后使用,可在 v2rayN 设置中查看启动选项,但建议先确认系统代理的启停行为符合预期;Android 端则应确认后台运行策略不会频繁中断连接。订阅并不需要每次启动都重新添加,后续只需在原分组上执行更新。

订阅更新后,如果节点名称或数量发生变化,属于清单刷新后的正常结果。当前节点失效时,可以先更新订阅,再从同一分组中选择新的节点。需要进一步配置国内外域名分流、DNS 解析、入站端口或自定义路由时,再进入配置大全逐段调整。每次修改后保留一份当前可用配置,并一次只变更一个部分。

列表正常

订阅更新后存在可选择的节点。

状态正常

活动节点、系统代理或系统连接保持启用。

访问正常

新建浏览器窗口可以稳定加载目标页面。

日志正常

没有持续重复的解析、认证或连接错误。

QUICK TROUBLESHOOTING

连接失败时按固定顺序排查

首次配置失败时,最有效的方法不是同时更改所有设置,而是沿着请求路径逐层确认。下面的顺序从订阅源开始,一直检查到应用流量。每完成一项都重新测试一次;某一步恢复后,就不必继续修改后面的高级配置。

订阅已经保存,为什么列表仍然为空?

保存地址后还需要执行订阅更新。先确认 URL 是完整订阅链接,而不是管理网页或登录页面;随后查看更新提示与日志。若提示无法访问,检查基础网络和地址完整性;若提示解析失败,重新复制订阅地址并替换原记录。

客户端显示已连接,浏览器却没有变化?

桌面端先检查 v2rayN 的系统代理是否启用,并确认浏览器没有使用独立代理设置;Android 端检查 v2rayNG 的系统连接是否保持、测试浏览器是否被分应用设置排除。可以临时关闭浏览器代理扩展后重新打开窗口测试。

更新订阅成功,但所有节点都连接超时?

先开启系统自动时间和时区,再更新一次订阅。随后选择同一分组中的另一条节点进行对照,并观察第一条核心错误。若多条节点在不同网络下都失败,应向订阅提供方确认服务状态,不要反复修改客户端底层参数。

连接后部分网站可以打开,部分网站失败?

先短时切换到全局模式做对照。如果全局模式正常而规则模式失败,重点检查路由规则与 DNS;如果两种模式结果相同,则查看日志中的目标域名、解析结果和远端连接错误。详细字段关系可继续阅读配置大全。

建议保留的排查信息

需要进一步分析时,记录客户端名称与版本、操作系统、问题发生时间、所选代理模式、订阅是否能更新,以及日志中的第一条核心错误。分享日志前应删除订阅 URL、节点地址、用户标识和认证参数。只提供“不能用”很难判断故障位于订阅、内核、系统代理还是目标网络,按层级整理信息能显著缩短排查过程。