入门指南 · 四步完成首次连接

v2rayN 配置教程:
订阅导入与连接验证

本页按“导入订阅 → 选择代理模式 → 连接 → 验证是否生效”展开,适合已经安装客户端、准备完成首次配置的使用者。先用默认设置建立一条可验证的连接,再考虑细调路由和 DNS,能减少同时修改多个选项带来的排查困难。可预留约十分钟跟随操作,实际用时取决于订阅更新与网络状态。

开始前准备好可用的订阅地址,确认设备本身能够正常联网。客户端负责读取连接配置和处理流量,并不附带可用的服务器账户;订阅地址应由你已有的服务提供方给出。尚未安装时,先到客户端下载安装页选择对应系统和架构,安装并打开客户端后再继续。

1. 导入订阅

先从服务提供方的账户页面复制订阅地址,再打开 v2rayN 的“订阅分组”或“订阅分组设置”。选择新增分组,给分组填写一个容易识别的名称,例如“日常使用”,把完整地址粘贴到订阅地址输入框,保存设置。分组名称只用于本地整理,不会改变远端服务器配置;刚开始只添加一个分组,便于确认后面的更新结果属于哪条订阅。

粘贴前看一眼地址的开头与结尾,确认没有混入说明文字、换行或前后空格。订阅地址可能带有账户识别参数,应当像登录信息一样保管,不要发到公开讨论区,也不要把包含完整地址的界面截图直接分享出去。如果曾经公开过地址,应到服务提供方的账户页面了解重置方式,而不是仅修改本地分组名称。

保存分组后,回到订阅菜单执行“更新订阅”。如果菜单区分普通更新与通过代理更新,首次尚未建立连接时,通常先尝试普通更新;只有已经存在可用代理、且订阅地址确实需要经过它访问时,才选择通过代理更新。等待更新结束,再查看服务器列表。看到新条目以及对应的分组名称,才说明订阅内容已经读入;仅出现“已保存”提示并不等于服务器列表已经更新。

在 v2rayNG 中,打开右上角菜单,找到订阅分组设置,使用新增入口填写分组备注与订阅地址。保存返回主界面后,在菜单中执行更新订阅,再查看列表是否出现服务器。如果界面有分组筛选,切换到刚创建的分组或全部分组,避免把“当前分组没有条目”误判为导入失败。更新期间保持网络连接,先等到结果提示出现,再进行下一步操作。

区分订阅地址与单条分享链接

若复制的内容以 vmess://、vless:// 或 trojan:// 开头,通常是单条服务器分享链接,不应填进订阅地址栏。此时使用客户端的“从剪贴板导入”功能,导入后检查服务器列表即可。订阅地址一般用于定期获取一组配置,单条分享链接则描述某个具体连接,两种入口承担不同任务。格式含义可在名词解释中继续阅读,本页不需要手动解码或改写链接。

如果更新后仍为空,先重新检查订阅是否有效、分组是否启用,以及更新日志显示的是请求超时、账户失效还是内容无法解析。不要连续新增多个相同分组,也不要把返回的错误页面当作配置导入。确认订阅确实产生服务器条目后,再进入代理模式选择;否则即使打开系统代理,客户端也没有可用的目标配置。

2. 选择代理模式

导入成功后,先分清两个问题:应用流量怎样进入客户端,以及进入之后走哪条出站。系统代理、安卓 VPN 和 TUN 主要影响前一个问题,路由规则负责后一个问题。界面中的“全局”或“规则”名称可能与具体版本有关,因此应结合选项说明判断,不要把“打开系统代理”理解为设备上所有应用都会经过代理。

首次使用 v2rayN,建议保留默认路由规则,再从主界面或托盘菜单的“系统代理”中选择“自动配置系统代理”或功能相同的选项。这会把系统支持的代理设置指向客户端本地监听地址。之后,用遵循系统代理的浏览器进行测试即可。不要自行把订阅服务器地址填进操作系统的代理地址栏:系统代理在这里连接的是本机客户端,不是直接连接远端服务器。

路由方面优先使用客户端提供的默认分流方案。命中直连规则的请求由本机直接发起,命中代理规则的请求交给选中的代理出站,命中阻断规则的请求不会正常建立连接。因而开启客户端以后,部分网站的出口地址仍与原来相同,可能只是正常直连,并不一定表示设置失效。后面的验证步骤会按预期路径分别检查。

在 v2rayNG 中,首次保留默认 VPN 连接方式与默认路由设置即可;界面若提供其他运行方式,暂时不要切换。安卓 VPN 方式通常能够接入更广泛的应用流量,但按应用代理、排除应用等设置仍会影响实际范围。如果之前改过应用名单,先确认用于测试的浏览器没有被排除,再启动连接。不要同时启用另一款占用系统 VPN 通道的工具。

第一次连接先不启用 TUN

桌面端先用系统代理完成浏览器测试,可以把问题范围缩小到订阅、活动服务器和系统代理这几项。TUN 涉及虚拟网络接口、路由与权限,某些应用确实需要它,但首次配置并不必然要启用。如果系统代理测试成功,而目标应用仍不遵循代理,再到配置进阶手册按 TUN 章节处理,不要为了让开关看起来齐全而同时开启所有模式。

本步骤结束时,应当能够明确说出当前采用的是哪种流量接入方式,以及是否保留默认分流。暂时不要修改 DNS、监听地址和自定义规则;先得到一个可复现的基础状态,下一步只选择服务器并启动连接。这样出现问题时,也能判断是配置本身不可用,还是后来增加的功能影响了结果。

3. 选择服务器并启用连接

回到 v2rayN 的服务器列表,选择刚导入分组中的一个条目,使用右键菜单中的“设为活动服务器”或同义入口。有些版本支持双击切换,但不能仅凭行被选中就认定已经切换成功;应查看活动标记、状态栏或当前服务器提示,确认正在使用的确实是刚选择的配置。第一次测试先固定一个条目,避免频繁切换导致日志与浏览器结果难以对应。

v2rayN 在设置活动服务器后通常会启动或重载内核,具体行为随版本和当前状态而异。检查主界面的运行状态和日志,确认没有立即出现配置读取失败、启动失败或端口占用错误,并再次确认系统代理仍处于自动配置状态。如果界面提供启动或重启服务入口,可在需要时执行一次,等待状态稳定后再打开浏览器。客户端窗口正在显示,不代表内核已经成功运行。

在 v2rayNG 中,点击准备使用的服务器条目,确认选中标记,再点击主界面的连接按钮。首次连接通常会弹出系统 VPN 连接授权,确认发起请求的是正在使用的客户端后再同意。授权完成后,观察连接按钮、状态文字或系统 VPN 状态标识是否变化。若拒绝授权,客户端即使已经导入配置,也无法按默认 VPN 方式接入应用流量。

连接期间先保持客户端运行,不要立即强制结束进程。桌面端关闭窗口可能只是收进托盘,也可能因设置不同而退出;需要根据托盘图标和运行状态确认。安卓端则可先在前台完成验证,确认可用后再观察切到后台是否保持连接。如果只有熄屏后断开,再检查系统对后台运行的限制,而不是在初次连接阶段一次性修改所有电池选项。

启动失败先看错误发生在哪一层

若日志提示本地端口已被占用,先退出重复运行的客户端或正在使用相同端口的工具,再重试;不要随意结束不认识的系统进程。若提示配置字段或协议不受支持,先确认客户端是否适配该配置,并从下载页检查可用安装入口。若内核运行正常但连接远端超时,可以换同一订阅中的另一个条目做一次对照,仍失败时再确认账户与服务端状态。

客户端提供的连接测试可以帮助筛选条目,但测试结果只代表某一种探测是否成功,不能代替浏览器实际访问。看到测试返回耗时后,也不要跳过下一步。到这里,预期状态是:活动服务器已确定,内核或 VPN 已启动,流量接入方式已启用;接下来用真实应用请求检查这条路径,而不是继续叠加设置。

4. 验证代理是否生效

先使用遵循系统代理的浏览器,打开一个你预期应经代理出站、且平时能够确认可用的网站。测试时先暂停会接管代理设置的浏览器扩展,避免浏览器自己的规则覆盖系统设置。重新打开页面或使用新标签页发起请求,不要仅凭已经缓存的页面内容判断成功。页面能够加载是第一项结果,还需要结合路由与客户端记录判断是否走了预期路径。

随后查看客户端的连接记录或日志;若当前版本支持路由命中与出站展示,可确认刚才请求使用的是代理出站还是直连出站。并非所有日志级别都会记录每个域名,看不到逐条访问记录不等于连接失败。需要临时增加日志详细程度时,只保留测试所需时间,完成后恢复常用级别,避免长期积累包含访问目标的信息。

若需要用出口地址辅助判断,可以在同一浏览器中,对同一个出口信息页面比较连接前后的结果。不过默认分流可能让该页面走直连,浏览器也可能复用旧连接,因此“地址没有变化”不能单独证明代理无效。先确认该请求应当走代理;必要时短暂选择明确的全局代理路由进行对照,测试结束再恢复原来的默认分流。不要为了让所有检测页结果一致而长期保留临时设置。

接着打开一个预期走直连的网站,确认正常访问,再切回需要代理的页面重复请求。两类请求都符合预期,才说明基础分流与代理连接能够共同工作。验证过程中保持同一个活动服务器和同一组设置;如果确实要切换,记下切换前后的差别,一次只改一项。这样遇到某个页面异常时,能保留可用状态作为参照。

浏览器能用,其他应用不能用

这时优先检查应用是否遵循系统代理。有些桌面应用使用自己的代理选项,终端命令也可能需要单独设置代理环境变量,它们不会因为浏览器成功就自动采用同一路径。先查看目标应用的网络设置;确有全局接入需求时,再阅读配置进阶手册中的 TUN 与 DNS 内容。不要反复更新订阅来处理一个只发生在特定应用里的接入问题。

如果 v2rayNG 前台访问正常、切到后台后异常,先看 VPN 状态是否仍保持,再检查应用是否被系统限制后台运行。如果只有个别应用不生效,查看按应用代理名单以及包含、排除模式的含义。名单里出现一个应用并不总意味着它会经过代理,关键是当前使用了哪种名单模式。调整后重新连接,并用同一个应用再次测试。

保存可用状态与结束使用

验证通过后,记住可用的订阅分组、活动服务器和代理模式即可,不需要继续改动高级设置。以后服务器列表发生变化,先更新原分组,再重新选择活动条目;更新订阅可能覆盖远端管理的配置,不宜把临时修改只保存在订阅条目里。需要整理多个订阅或建立长期规则时,再进入手册逐项配置。

结束使用时,v2rayN 先清除系统代理,再按需要退出客户端,避免系统仍把请求发往已经停止的本地端口。v2rayNG 使用连接按钮断开,确认系统 VPN 状态结束。若退出后网页打不开,先检查系统代理是否残留,不要立即删除全部配置。保留已经验证可用的分组,下一次就可以从选择服务器与连接开始。