10 MINUTE SETUP

V2Ray 订阅导入与连接步骤

按“导入订阅 → 选择代理模式 → 连接 → 验证”的顺序操作。第一次配置只处理必要设置,复杂路由、DNS 和 TUN 留到基础连接稳定之后。

SCOPE

这篇教程解决什么

本页只处理最常见的首次配置场景:手上已有一条可用的订阅链接,需要把它放进客户端并确认网络流量已经经过所选节点。完成后,客户端应当能正常更新订阅、显示节点列表、启动本地代理,并让浏览器通过该代理访问网络。

订阅链接不是节点名称,也不是一段单独的 VMess 或 VLESS 配置。它通常由服务提供方生成,客户端访问这个地址后,会取得一组节点和分组信息。链接可能很长,其中还可能包含访问凭据,因此只应粘贴到可信客户端中,不要发到公开页面、聊天群或截图里。

如果还没有安装客户端,先前往客户端页面按当前系统选择版本。已经安装但启动报错、系统组件缺失,或需要配置 TUN、DNS、复杂路由时,直接查阅全平台安装配置大全。这里不展开这些进阶项目,避免第一次操作被过多选项打断。

00 / PREPARE

开始前检查:链接、时间与旧代理

先排除三个最容易干扰结果的因素。准备工作不到一分钟,却能避免后面反复修改配置。

确认订阅链接完整

复制订阅链接时,要从协议开头一直复制到最后一个字符。链接常以 https:// 开头,后面可能带有较长路径或参数。不要手动删除问号后的内容,也不要把网页中显示的省略号一起复制。最稳妥的做法是使用提供页面上的复制按钮,然后先粘贴到客户端的订阅地址输入框,不经过会自动改写链接的文档软件。

如果提供方给的是二维码,可以在 v2rayNG 中使用扫码入口;桌面端更适合直接粘贴订阅地址。二维码只是承载配置的方式,并不意味着必须打开相机。无论通过哪种入口导入,最终判断标准都是主界面能否出现节点列表。

校准系统时间

系统日期、时区或时间偏差过大时,TLS 连接可能在建立阶段失败。打开系统的日期与时间设置,启用自动设置,并确认时区正确。完成后不必调整客户端中的传输参数,先重新更新订阅。若错误来自系统时钟,校准后通常可以直接恢复。

暂时关闭其他代理程序

同一台设备上同时运行多个代理客户端,可能争用本地端口,也可能轮流改写系统代理。首次配置时,先退出其他同类程序,只保留当前客户端。浏览器若安装了独立代理扩展,也建议暂时切回“跟随系统”或关闭扩展接管。这样验证阶段看到的结果才能对应当前配置,而不是另一个后台程序。

01 / SUBSCRIPTION

导入订阅:保存分组并更新节点

这一阶段的完成标志不是“链接已经粘贴”,而是客户端主界面真正出现了可选择的节点。

v2rayN 桌面端的操作

打开 v2rayN 后,先在顶部菜单或订阅相关菜单中找到“订阅分组”或“订阅设置”。不同版本的菜单措辞可能略有变化,但入口都会同时包含新增、编辑和更新订阅的功能。进入设置窗口后选择新增,给这组订阅填写一个容易辨认的备注,例如按用途或提供方名称命名。备注只在本机显示,不影响连接。

把完整链接粘贴到地址输入框,确认该分组处于启用状态,然后保存并关闭设置窗口。仅保存还不会自动产生节点,下一步需要回到订阅菜单,执行“更新全部订阅”或对刚才的分组单独更新。更新过程中留意底部状态区或日志窗口:成功时通常会提示订阅更新完成,随后主列表出现若干行节点配置。

如果主列表仍为空,不要反复点击连接。重新打开订阅设置,检查地址两端是否多了空格、分组是否停用,以及链接是否完整。也可以把光标放到地址末尾,确认没有换行符。订阅能在浏览器打开并不等于返回内容一定兼容客户端;若更新明确提示格式错误,需要回到链接提供页面重新取得适配 V2Ray 客户端的订阅地址。

v2rayNG Android 端的操作

打开 v2rayNG,展开侧边菜单,进入订阅分组设置。点击新增按钮后填写备注与订阅地址,保存时确认启用开关已经打开。回到主界面后,再次打开菜单并执行更新订阅。部分版本会在屏幕底部显示短提示,更新完成后节点会进入主列表。

如果拿到的是单个配置二维码,可使用右上角菜单中的扫码导入;如果是订阅二维码,则应通过订阅分组的扫码入口保存为订阅。两者区别在于:单个配置只加入一条节点,订阅分组以后可以统一刷新一批节点。准备长期使用时,优先保存订阅分组,后续更新会更省事。

系统若询问相机权限,而当前使用的是剪贴板链接,可以直接返回并选择手动输入,不影响其他连接功能。粘贴后务必执行一次更新,因为“已保存订阅地址”和“已下载节点内容”是两个动作。看到列表后,点一下准备使用的节点,使其成为当前选中项。

读懂更新结果

节点名称通常由订阅提供方定义,名称中的地区、倍率或线路标记只是识别信息。客户端并不会因为名称靠前就自动判断它更合适。第一次测试先任选一条配置,不必在这里花时间比较。若列表中所有节点都无法连接,再判断订阅状态、网络环境或配置兼容性;若只有个别节点失败,则更可能是单个节点状态问题。

订阅更新成功后,先停留在主界面确认两件事:列表至少有一条配置,且其中一条已经被选中。完成这两项再进入代理模式设置。更完整的订阅格式区别、剪贴板导入与分组管理说明,可查看订阅链接导入详解

02 / ROUTING

选择代理模式:先规则,后全局

代理模式决定哪些请求进入代理,不会改变节点本身。初次配置优先使用规则模式,便于兼顾常规访问与代理流量。

规则模式适合日常使用

规则模式会根据域名、IP 或预置规则决定流量走向。常见的本地服务和局域网地址可以保持直连,需要代理的请求交给当前节点。v2rayN 中,这类设置通常位于系统代理或路由菜单;v2rayNG 中,可以在设置或路由配置内选择预置规则。不同版本可能把它称为“绕过局域网”“规则”或“按路由处理”,核心含义相同。

第一次使用不要导入大量自定义规则,也不要同时调整域名策略。先采用客户端随附的基础规则,连接成功后再根据实际需求细化。规则越多,排查时需要考虑的匹配顺序越复杂。遇到某个网站直连、另一个网站代理的情况,不一定是故障,可能正是规则模式的预期结果。

全局模式用于短时对照测试

全局模式会让更多符合代理接管范围的请求交给当前节点。它适合做对照:如果规则模式下某个网页打不开,而切到全局后立刻恢复,通常说明节点和基础连接正常,问题位于路由规则,而不是订阅导入或内核启动。

全局并不代表设备上的所有程序必然被接管。桌面端只开启系统代理时,通常只有遵循系统代理设置的应用会使用它;某些程序可能自带网络栈或独立代理选项。Android 端建立系统连接后,接管范围由客户端设置和系统机制共同决定。需要处理更广泛的桌面应用流量时,再研究 TUN 模式,不要在基础测试阶段同时引入这个变量。

直连模式不是连接测试

直连模式会让请求绕过代理。它用于临时恢复普通网络访问或比较代理前后的行为,不适合判断节点是否可用。如果客户端显示已启动,但模式仍是直连,浏览器出口地址不会按预期变化。连接前再次确认当前模式是规则或全局,而不是直连。

规则模式 按域名与路由规则决定直连或代理,适合作为日常默认选择。
全局模式 让更多请求经过当前节点,适合判断问题是否来自分流规则。
直连模式 绕过代理访问网络,用于暂停代理或进行前后对照。

选好模式后不要立即关闭客户端。下一步需要选择具体节点并启动连接。模式和节点是两个独立条件:只有模式正确但没有选中节点,或者选中节点却没有开启系统代理,都不能形成完整链路。

03 / CONNECT

建立连接:选中节点并启动代理

先确认当前节点,再启动客户端。看到“运行中”只代表本地服务已启动,还要确认系统流量已经交给它。

在 v2rayN 中启动系统代理

回到节点列表,单击准备使用的节点。部分版本需要双击,或通过右键菜单选择“设为活动服务器”。选中状态通常会通过行高亮、状态图标或托盘提示表现出来。随后打开系统代理菜单,选择自动配置系统代理或与规则模式对应的启用项。

完成后观察桌面通知区域中的 v2rayN 图标。图标状态变化表示客户端已经切换运行状态,但真正有用的信息仍在日志里。打开日志窗口,正常启动时应当看到配置载入、本地监听建立和核心启动完成等信息。日志中的本地地址通常类似 127.0.0.1 加一个端口,它只表示客户端在本机等待应用流量,不是远端节点地址。

如果日志提示端口被占用,先退出其他代理程序,再完全关闭并重启 v2rayN。不要随意把多个设置中的端口全部改成不同数字,因为系统代理、HTTP 入站和 SOCKS 入站之间存在对应关系。基础连接阶段,清理冲突程序比重写端口更稳妥。

在 v2rayNG 中启动连接

在主列表点选节点后,点击界面右下方的连接按钮。首次启动时,系统会显示连接授权窗口,确认后客户端才能创建系统连接。授权只需按系统提示完成;返回 v2rayNG 后,按钮和顶部状态应当变为已连接状态,同时系统状态区域会出现连接标记。

如果点击后马上停止,进入日志查看第一条明确错误。常见方向包括订阅配置失效、网络无法到达服务器、系统时间不正确或当前网络限制了某种传输。不要只根据“连接失败”四个字修改配置,应当找到错误出现在哪个阶段:解析地址失败、建立 TCP 连接失败、TLS 握手失败,还是认证被拒绝。阶段不同,处理方式完全不同。

连接后先等几秒再测试

客户端刚启动时需要载入配置、初始化路由和建立必要连接。点击启动后等待几秒,再打开一个新的浏览器页面。已经打开的网页可能复用旧连接,因此只刷新旧标签页有时看不到变化。更稳妥的做法是新建标签页,或关闭浏览器后重新打开。

桌面端还要注意浏览器是否跟随系统代理。主流浏览器通常默认读取系统设置;如果浏览器曾配置独立代理、命令行启动参数或扩展规则,它可能绕开 v2rayN。Android 端则应确认 v2rayNG 仍处于连接状态,没有被省电策略立即停止。基础连接成功前,不要同时开启多个分应用代理规则。

04 / VERIFY

验证是否生效:日志、网页、出口三层检查

不要只看客户端按钮颜色。验证要从本地运行状态开始,再确认网页访问与出口地址变化。

第一层:日志没有持续报错

打开客户端日志,先确认核心已经成功启动,并且没有同一条错误不断重复。偶尔出现一次连接重试不一定代表整体失败,网络请求本来就可能重连;如果每次打开网页都出现相同的超时、拒绝或解析错误,才说明链路仍有问题。

日志阅读不需要逐行理解。先找时间最新、重复次数最多的错误,再看其中是否出现域名解析、连接超时、证书、认证或路由关键词。把错误归类后再处理,比直接替换所有设置更有效。常见错误含义与对应检查项可转到FAQ 故障排查分类

第二层:新网页可以正常打开

新建浏览器标签页,分别打开一个平时可以直连的网站和一个预期经过代理的网站。规则模式下,两类网站都能访问,说明基础分流与代理链路已经工作。如果直连网站正常、代理网站超时,重点检查节点和订阅状态;如果全局模式正常而规则模式异常,重点检查路由规则。

若浏览器全部打不开,先把系统代理切回关闭状态,确认普通网络本身可用,然后重新启用客户端。关闭代理后仍无法访问,问题通常不在 V2Ray 配置,应先恢复本地网络。关闭代理后恢复、重新启用又全部失败,则检查本地监听、端口冲突和系统代理地址是否匹配。

第三层:出口地址符合预期

连接前可以在浏览器中搜索“当前 IP”,记下显示的网络出口;连接后新建标签页再次查询。如果出口地址发生变化,并且地区与所选节点大致对应,说明浏览器流量已经经过代理。规则模式下,查询服务可能被规则判定为直连,因此地址不变时,可以短暂切换全局模式做一次对照,然后切回规则模式。

出口变化只证明当前浏览器请求经过了代理,不代表设备内每个应用都使用相同路径。某个独立程序仍无法连接时,应检查该程序是否支持系统代理,或是否设置了自己的 HTTP、SOCKS 地址。需要接管更多不遵循系统代理的桌面应用时,再阅读完整文档中的 TUN 配置

完成后保存当前可用状态

确认连接正常后,先不要继续修改 DNS、端口和路由。记住当前使用的订阅分组、节点、代理模式和系统代理状态。以后新增规则或切换运行方式时,一旦出现问题,就可以回到这组已验证的基础状态进行对照。

订阅内容会随提供方更新。节点整体变化时使用“更新订阅”,不需要删除分组重新导入。更新后若当前节点消失,从新列表中选择另一条配置即可。只有订阅地址本身变更或失效时,才需要编辑分组中的链接。

QUICK FIXES

连接不通时的最短排查顺序

先判断问题在哪一层,再决定是否进入完整文档。下面六项按顺序检查,一次只改一个变量。

01

重新更新订阅

确认更新有成功提示,节点列表不是空白。若全部节点突然失效,先排除订阅过期或地址变更。

02

换一条节点

同一订阅内任选另一条配置。只有单个节点失败时,不必修改客户端全局设置。

03

确认代理模式

检查当前不是直连模式。规则模式结果不明确时,短暂使用全局模式做对照测试。

04

清理端口冲突

退出其他代理程序并重启当前客户端,观察日志中是否仍然提示本地监听失败。

05

检查系统时间

启用自动日期与时间,确认时区准确,再重新连接并观察 TLS 相关错误是否消失。

06

对照完整文档

基础步骤无误仍失败时,按平台查看安装、系统代理、DNS、TUN 与日志诊断章节。