基础操作 · 约 10 分钟

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

准备一条可用的订阅地址,按四个步骤完成首次配置。本文只处理日常启动所需的设置,协议、内核和跨平台细节集中放在全平台指南中。

订阅管理 系统代理 路由模式 连接验证
SETUP FLOW 4 步
  1. 01
    导入订阅 保存地址并更新服务器列表
  2. 02
    选择模式 设置系统代理与路由规则
  3. 03
    建立连接 选中配置并确认运行状态
  4. 04
    验证结果 检查网页访问与客户端日志
完成条件 状态与访问结果一致
操作前准备

先确认客户端、订阅地址与系统时间

开始前需要准备已经安装好的客户端,以及由服务提供方给出的订阅地址。订阅地址通常是一段以 https:// 开头的链接,用于让客户端读取服务器配置。它不是普通网页地址,也不需要先放进浏览器打开。复制时应从第一个字符选到最后一个字符,避免带入消息软件自动添加的空格、换行或句号。

如果客户端尚未安装,先前往下载页面选择当前系统对应的版本。桌面设备使用 v2rayN,安卓设备可使用 v2rayNG。安装或解压完成后先启动一次,确认主窗口能够正常打开。桌面端关闭窗口后可能继续停留在系统托盘,后续找不到窗口时可从托盘图标重新展开,不必重复启动多个进程。

还要检查设备日期、时间和时区是否正确。VLESS、Trojan、REALITY 或使用 TLS 的配置会参与证书与握手时间判断,系统时间偏差过大时,客户端可能已经显示运行,但连接仍会在握手阶段失败。建议启用系统自动校时,再继续导入。本文不要求提前修改内核、端口、Mux 或 DNS;首次设置保持默认值,更容易判断问题出在哪一步。

客户端已启动

能够看到 v2rayN 主窗口,或 v2rayNG 的配置列表页面。

订阅地址完整

链接来自实际服务方,复制结果没有空格、换行和额外标点。

系统时间正确

日期、时区与当前所在地一致,自动校时已经完成。

01
第一步

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

v2rayN 桌面端操作

打开 v2rayN 主窗口,在顶部菜单中找到“订阅分组”或名称接近的订阅管理入口,再进入“订阅分组设置”。新建一条分组记录,在备注栏填写便于识别的名称,例如“日常订阅”;在地址栏粘贴完整订阅链接。其余选项先保留默认值,然后点击添加、确认或保存。这里的保存只代表地址已经写入客户端,服务器配置通常还没有下载到本地。

返回主窗口后,再打开订阅菜单,执行“更新全部订阅”或对刚才的分组单独更新。更新过程中注意窗口底部状态栏或日志区域。成功后,主列表会出现多行服务器配置,常见协议列可能显示 VMess、VLESS 或 Trojan。列表中的别名、协议和传输方式来自订阅内容,不需要在首次设置时逐项修改。

如果更新完成后列表仍为空,先回到订阅分组设置检查地址是否保存到了正确分组。然后重新复制原始链接,删除地址前后的空格再保存。若日志提示超时,先确认当前网络能够连接到订阅服务;若提示格式或解析错误,应向订阅提供方确认地址是否仍然有效。不要把网页控制台地址、付款页面地址或单个二维码识别结果当作订阅链接。

v2rayNG 安卓端操作

打开 v2rayNG,在右上角菜单中进入“订阅分组设置”或“订阅设置”。点击新增按钮,填写备注并粘贴订阅地址,随后保存。回到主页面,再从菜单中选择“更新订阅”。更新成功后,配置会按订阅内容出现在主列表中。某些版本会先显示分组名称,需要进入对应分组才能看到具体配置。

安卓系统可能会限制后台网络或在省流量模式下阻止应用读取订阅。若同一地址在桌面端可以更新,而安卓端持续超时,可暂时允许 v2rayNG 使用 WLAN 与移动数据,并关闭针对该应用的省流量限制,然后重新执行更新。完成后只要列表中已经出现配置,就可以进入下一步,不必连续多次刷新。

本步完成标志 主列表中出现可选择的服务器配置
SUBSCRIPTION READY
02
第二步

选择系统代理与路由模式

服务器配置导入后,下一步不是立即修改每个协议参数,而是决定哪些应用流量交给客户端。桌面端通常要同时区分“系统代理”和“路由模式”:系统代理负责告诉浏览器等应用把请求交给 v2rayN;路由模式负责决定交进来的请求如何匹配直连或代理规则。两项设置作用不同,只打开其中一项不一定得到预期结果。

桌面端先用自动配置系统代理

在 v2rayN 主窗口底部状态栏或系统托盘菜单中找到“系统代理”,首次操作可选择“自动配置系统代理”。选中后,状态栏通常会显示当前系统代理状态,托盘图标的外观也可能随版本变化。这个模式会把系统支持的代理设置指向 v2rayN 的本地监听端口,适合浏览器和遵循系统代理的桌面应用。

如果只想让手动填写代理地址的应用使用客户端,可以暂时保持“清除系统代理”,再在目标应用内填写 v2rayN 显示的本地 HTTP 或 SOCKS 端口。不过这属于按应用配置,不适合作为首次验证路径。为了减少变量,本教程按“自动配置系统代理”继续。结束使用时可以从同一位置选择“清除系统代理”,让系统恢复普通连接状态。

路由模式从常规分流开始

打开“路由设置”或底部的路由模式菜单,选择“绕过局域网及大陆”或当前版本中含义相同的预置规则。该模式会让局域网地址和常见直连目标保持原连接,其余匹配项交给当前服务器处理。它适合日常起步,也便于观察某个网站到底走了哪条路径。若选择“全局”,交给客户端的流量会更集中,但本地站点和局域网设备也可能受到影响。

这里的“全局”是路由处理范围,不代表所有程序一定经过客户端。某些应用不读取系统代理,或者自行实现网络栈,即使 v2rayN 已处于全局路由模式,也可能继续直连。需要覆盖更多网络类型时会涉及 TUN、DNS 和管理员权限,这些内容在全平台指南中单独说明。本页先用系统代理完成可重复验证。

安卓端确认连接范围

v2rayNG 通常在点击连接后由系统建立本地网络接口,因此没有桌面端完全相同的“系统代理”开关。首次使用可保持“分应用代理”关闭,让连接范围由系统统一处理。如果以前开启过分应用代理,应进入设置检查目标浏览器是否包含在允许列表内;列表方向设置相反时,可能出现客户端显示已连接,但指定应用没有经过当前配置的情况。

路由设置同样可从预置规则开始,不需要在首次连接前编写自定义域名或 IP 规则。先确认基础连接成功,再按实际需求增加规则,能避免把订阅问题、节点问题和路由规则问题混在一起。完成这一项后,代理范围已经明确,下一步只需选定一条配置并建立连接。

起步设置

系统代理:自动配置

适用于读取系统代理的浏览器与桌面应用,便于首次验证。

系统代理
常规分流

路由:绕过局域网及大陆

先使用内置规则,确认基础连接后再调整自定义路由。

路由模式 预置规则
03
第三步

选中配置并建立连接

现在回到服务器列表。列表中可能有多条名称相近的配置,首次连接任选一条订阅正常下发的配置即可,不必先根据名称猜测速度。测速结果、真实连接延迟和下载吞吐代表不同阶段,不能只凭一个数字判断。为了让排查过程清楚,先固定一条配置完成连接;确认失败后再换另一条做对照。

在 v2rayN 中设为活动服务器

单击一行配置使其高亮,再按 Enter,或通过右键菜单选择“设为活动服务器”。成功后,该行通常会显示活动标记,窗口底部也会出现当前服务器名称。接着确认系统代理仍是“自动配置”,路由模式仍是上一步选择的预置规则。v2rayN 一般会自动启动所需内核,不需要另外打开命令窗口。

观察日志区域几秒。如果日志显示内核启动、配置载入和本地端口监听完成,说明客户端已进入等待应用请求的状态。此时没有网页访问行为,日志保持安静属于正常现象。若日志立即出现端口被占用,可先完全退出重复运行的客户端,再重新启动;若显示配置无法解析,先更新订阅或换同一分组内的另一条配置。

桌面端窗口最小化后通常会保留在托盘。不要一边保留旧进程,一边反复双击启动新窗口,否则多个进程可能竞争同一个本地端口。需要重新加载时,优先使用菜单中的“重启服务”或先从托盘执行退出,再启动一次。当前服务器、系统代理和路由模式三项状态都明确后,即可打开浏览器验证。

在 v2rayNG 中点击连接

在 v2rayNG 主列表点击要使用的配置,使其成为当前项,然后点击页面底部的圆形连接按钮。首次建立连接时,安卓系统会弹出网络连接授权窗口,确认后客户端才能创建本地接口。授权由系统负责,若取消,v2rayNG 会回到未连接状态,需要再次点击连接并完成确认。

连接成功后,按钮状态会发生变化,页面顶部或系统状态区域也会显示正在运行。此时先保留 v2rayNG 在前台几秒,查看是否马上出现错误提示。若状态刚变为已连接又自动断开,打开日志查看第一条明确错误,而不是连续点击连接按钮。常见方向包括配置过期、服务器不可达、系统时间错误或当前网络切换。

从 WLAN 切换到移动网络,或从移动网络切回 WLAN 后,原有连接可能短暂中断。等待系统网络稳定,再断开并重新连接一次即可。若系统启用了严格的后台省电策略,可允许 v2rayNG 在后台运行,避免锁屏后被立即停止。更细的后台策略和平台差异可在安卓配置章节继续查看。

连接状态检查

活动配置、内核运行、代理范围三项一致

“已连接”只表示客户端服务已经启动。最终是否可用,还要用下一步的实际访问和日志结果共同确认。

客户端运行中 READY FOR REQUEST
04
第四步

用实际访问与日志验证结果

验证时不要只看客户端按钮颜色。客户端显示运行,代表本地服务已经启动;浏览器能否按预期访问,才说明应用流量、系统代理、路由规则和当前配置已经连成完整路径。最简单的方式是新开一个浏览器窗口,访问平时确实需要使用的页面,同时让客户端日志保持可见。

如果目标页面正常打开,再访问一个常用直连页面,确认预置路由下两类访问都符合预期。随后刷新几次,观察连接是否稳定。桌面端日志中应出现新的连接记录;安卓端可在日志页面看到请求与当前配置有关的处理信息。无需追求日志每一行都能读懂,首次验证只关注是否持续出现明确错误,以及请求发生时日志是否有对应变化。

区分浏览器缓存与真实连接

已经打开过的页面可能从缓存中读取内容,无法完整反映当前连接。可以使用新的隐私窗口,或选择一个此前没有打开的具体页面进行测试。也可以先断开客户端刷新一次,再重新连接后刷新作对照。两次结果有明确差异时,通常能说明系统代理和路由已经参与请求处理。

若只有一个浏览器失败,其他遵循系统代理的应用正常,优先检查该浏览器是否设置了独立代理、扩展代理或安全 DNS。独立设置可能覆盖系统代理,使浏览器没有使用 v2rayN 当前端口。恢复为“使用系统代理”后重新启动浏览器,再进行验证。若所有应用都失败,则回到客户端状态、节点配置和本地网络层排查。

完成后的日常使用顺序

以后启动时不需要重复添加订阅。常规顺序是:启动客户端,按需要更新订阅,选中一条配置,确认系统代理或安卓连接状态,再打开目标应用。订阅更新会替换或补充服务器列表,但不会自动判断哪条配置适合当前网络。遇到单条配置失败时,可先切换同一订阅中的另一条进行对照。

桌面端结束使用前,可从托盘菜单选择“清除系统代理”,再退出 v2rayN。这样可以避免客户端已经退出,而系统仍保留指向本地端口的代理设置。安卓端点击连接按钮断开即可。若桌面端异常结束后浏览器突然无法访问普通页面,重新启动 v2rayN 并清除系统代理,或进入系统网络设置关闭遗留代理。

状态一致

当前配置已选中,客户端保持运行,系统代理或安卓连接处于启用状态。

访问符合预期

目标页面能够打开,常用直连页面在当前路由规则下也能正常访问。

日志没有持续错误

发起请求时能看到对应记录,没有重复出现握手、解析或端口错误。

快速排查

首次连接失败时按顺序缩小范围

一次只改一项,并在每次修改后重新验证。这样可以区分订阅、配置、系统代理和本地网络问题。

更新订阅后没有出现任何配置

先检查订阅是否保存到了当前分组,再重新复制原始地址并删除首尾空格。执行更新时查看日志:超时通常指向订阅服务或当前网络,解析错误通常指向地址内容。确认使用的是订阅链接,而不是服务管理页面地址。

客户端显示运行,但浏览器仍按原网络访问

桌面端确认系统代理为“自动配置”,并检查浏览器是否启用了独立代理设置。安卓端检查 v2rayNG 是否处于已连接状态;如果开启了分应用代理,还要确认目标浏览器位于正确列表中。修改后完全关闭浏览器再重新打开。

选中配置后立即断开或持续报错

先确认系统日期、时间和时区,再更新一次订阅并切换同一分组中的另一条配置。若所有配置都出现相同错误,问题更可能位于订阅、当前网络或客户端环境;若只有一条失败,可暂时停用该条配置并向提供方确认状态。

退出 v2rayN 后普通网页也无法打开

这通常是系统仍保留原代理地址,而本地客户端已经停止。重新启动 v2rayN,从托盘或状态栏选择“清除系统代理”,再正常退出。以后结束使用时先清除系统代理,可避免本地监听端口停止后留下不可用设置。

需要继续深入

平台权限、TUN、DNS 与自定义路由

基础连接完成后,再处理平台特有设置。全平台指南按 Windows、macOS、Android 与 Linux 分章说明安装、订阅、系统代理和常见问题。

打开全平台指南