10 分钟快速配置

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

按固定顺序完成四件事:导入订阅、选择代理模式、连接服务器、验证流量路径。首次配置不需要同时修改全部高级选项,先让基础连接稳定工作,再处理路由、DNS 与 TUN 细节。

适用客户端 v2rayN、v2rayNG 操作顺序 导入 → 模式 → 连接 → 验证 深入配置 路由、DNS、TUN
开始前检查

准备客户端与有效订阅地址

先确认客户端可以正常打开,并准备由服务提供方给出的完整订阅地址。订阅地址负责提供服务器配置,客户端负责读取配置、选择路由并建立连接。

平台切换提示:v2rayN 桌面端的订阅入口通常位于顶部菜单或左侧订阅分组,系统代理与 TUN 开关集中在主界面设置区;v2rayNG 安卓端通过右上角菜单进入订阅分组,连接开关位于主界面底部。名称可能随版本略有调整,但操作顺序一致。

如果还没有安装客户端,先进入下载页按当前设备选择版本。桌面环境使用 v2rayN,安卓设备使用 v2rayNG。安装完成后先启动一次客户端,确认主界面可以显示,不要在此时同时开启多个同类客户端。多个客户端同时修改系统代理或虚拟网卡状态,会让后续验证难以判断流量究竟由哪个程序处理。

订阅地址一般是一段以 https:// 开头的链接。复制时应从第一个字符选到最后一个字符,避免把聊天软件产生的省略号、换行或末尾标点一起带入。不要直接把订阅地址粘贴到浏览器地址栏测试,因为地址可能包含用于读取配置的识别信息。正确做法是把它交给客户端的订阅管理功能。

开始操作前,还要确认设备时间和时区正确。许多传输方式依赖 TLS,系统时间偏差过大会导致握手失败。若设备刚从休眠恢复、时区刚调整或长时间没有自动校时,先打开系统的自动时间设置,再继续下面的步骤。网络也应处于可用状态:订阅更新需要先访问订阅来源,更新成功之后客户端才会得到可选服务器列表。

需要准备 已安装的客户端

v2rayN 桌面端或 v2rayNG 安卓端。

需要复制 完整订阅地址

使用服务提供方给出的当前地址。

需要确认 系统时间正确

启用自动日期、时间与时区。

01
第一步

导入订阅并更新服务器列表

在 v2rayN 桌面端添加订阅

打开 v2rayN 后,找到“订阅分组”或订阅管理入口,选择新增订阅。名称可以写成便于识别的服务名称,地址栏粘贴刚才复制的完整订阅地址。这里的名称只用于客户端内部分类,不会改变服务器配置。保存之后返回主界面,再执行“更新全部订阅”或选中当前分组后执行更新。新增和更新是两个动作:只保存订阅地址而没有执行更新时,服务器列表通常仍然为空。

更新过程中留意界面底部的状态信息。正常情况下,更新结束后会出现新的订阅分组,分组内可以看到若干服务器配置。服务器名称、协议和分组标签由订阅内容决定,不需要逐项手工填写。若列表已经出现,先不要急着调整路由或 DNS;保持默认配置,进入下一步选择代理模式即可。

在 v2rayNG 安卓端添加订阅

打开 v2rayNG,点击右上角菜单,进入“订阅分组设置”或名称相近的订阅管理页面。点击新增按钮,填写分组名称,并把完整地址粘贴到订阅地址栏。保存后回到主界面,再从菜单中执行“更新订阅”。更新完成时,主列表会出现可选择的配置项。点击列表中的任意配置,只是在选择当前服务器,还没有开始连接。

如果更新后仍然没有配置项,先回到订阅设置检查地址是否完整。常见问题包括地址开头缺少字符、末尾混入空格、复制了网页展示文字而不是实际链接,或者订阅本身已经被服务方更换。可以删除错误条目后重新添加,也可以编辑原条目并再次更新。反复点击连接按钮无法修复空列表,因为此时客户端还没有获得可连接的服务器配置。

订阅分组 已更新
常用订阅 当前分组
自建配置 手动管理

注意:订阅地址属于配置入口,不要发布到公开页面,也不要交给不受信任的第三方转换工具。需要更换地址时,应从原服务提供方重新获取。

完成标志很明确:客户端里已经存在订阅分组,分组下能看到至少一个可选择的服务器配置。到这一步只代表配置导入成功,并不代表设备流量已经开始经过代理。下一步要决定客户端接管哪些应用流量。

02
第二步

选择系统代理或 TUN 模式

代理模式决定客户端建立连接以后,哪些应用会把流量交给它处理。首次使用建议从系统代理开始。系统代理改动范围清晰,浏览器和大多数遵循系统网络设置的桌面应用可以直接使用,出现问题时也容易判断。需要接管不读取系统代理的程序、命令行工具或更多应用流量时,再考虑 TUN 模式。

首次配置先启用系统代理

在 v2rayN 主界面找到“系统代理”,将状态改为“自动配置系统代理”或当前版本中含义相同的启用选项。启用后,客户端会把本地代理地址写入系统网络设置。此时不要再手工修改系统代理端口,因为客户端会根据自身配置维护这些值。v2rayNG 的连接方式由底部开关触发,系统会在首次连接时显示网络连接授权窗口,确认授权后才能建立本地虚拟网络连接。

系统代理只影响主动读取系统设置的应用。浏览器通常会跟随该设置,但部分终端程序、独立下载工具或自行管理网络连接的软件可能忽略它。因此,后面验证时要把浏览器和其他应用分开检查。浏览器成功而终端不成功,不表示服务器连接一定有问题,更可能是后者没有读取系统代理。

按目标选择路由模式

客户端通常还会提供全局、规则或直连等路由选择。首次连接建议使用规则模式,例如“绕过局域网与大陆”或订阅提供的规则分组。规则模式会根据域名、IP 与预设规则决定直连或代理,适合日常使用。全局代理会把更多可接管流量交给代理出站,适合短时排查:如果规则模式下某个页面打不开,而切换全局后恢复,问题通常在路由规则而不是订阅导入。

直连模式不会让目标流量经过代理,主要用于临时停用或对照测试。不要把“客户端显示已连接”和“当前路由选择代理出站”混为一件事。连接状态说明核心已经启动,路由模式才决定具体请求走哪条路径。首次配置只需要选定一个清晰的模式,不要同时导入多套路由文件或修改大量规则。

SYSTEM PROXY

系统代理

适合首次配置与浏览器使用。接管遵循系统网络设置的应用,关闭客户端时也便于恢复。

本教程建议先选
TUN

TUN 模式

通过虚拟网卡处理更多流量。启用时可能需要系统权限,并应同步检查路由与 DNS。

阅读 TUN 配置 →

什么时候再启用 TUN

当目标应用明确不支持系统代理,或者需要统一处理更多程序流量时,再启用 TUN 模式。v2rayN 首次开启 TUN 可能要求提升权限或安装相应的虚拟网络组件,完成后需要重新连接。不要同时让其他虚拟网络工具占用相同的网络路径,否则可能出现默认路由互相覆盖、DNS 查询方向不一致等问题。

TUN、FakeDNS、自定义 DNS 与复杂路由之间存在联动关系,不适合在基础连接尚未验证时一次性全部打开。基础连接完成后,如需进一步配置,可阅读进阶配置手册。本步骤的完成标志是:已经选定系统代理或 TUN,并明确当前使用规则模式还是全局模式。接下来才是选择具体服务器并发起连接。

03
第三步

选择服务器并启动连接

回到服务器列表,在刚更新的订阅分组中选中一个配置。v2rayN 桌面端通常可以通过双击服务器、右键设为活动服务器,或使用界面中的设为当前选项完成选择。选中后,主界面或状态栏会显示当前服务器名称。v2rayNG 安卓端点击列表中的配置项后,该项会出现选中标记,随后点击底部连接开关。

首次测试不要连续切换多个服务器。先固定一个配置完成整个验证流程,才能区分是服务器问题、代理模式问题还是应用设置问题。若客户端提供测速或连接测试功能,可以把它作为初步参考,但测试结果不等同于实际网页访问。最终仍应以目标应用能否建立连接、页面资源能否完整加载为准。

确认客户端进入工作状态

连接启动后,查看客户端状态区域。v2rayN 应显示核心已经运行,系统代理开关保持在刚才选择的状态;v2rayNG 应显示连接已建立,底部按钮或状态图标发生变化。系统首次弹出网络连接授权时,需要明确确认。若关闭授权窗口,主界面即使保留了服务器选择,也不会真正建立连接。

连接期间保持客户端运行。关闭主窗口和退出程序不是同一动作:桌面端关闭窗口后可能仍驻留在系统托盘,退出菜单才会停止核心并恢复相关设置。如果不确定当前是否仍在运行,可以查看托盘图标或重新打开客户端。安卓端切换到其他应用后,连接状态应继续保留;如果系统很快终止后台任务,需要检查设备的后台运行权限与电量管理设置。

当前服务器已选择

核心运行后,再检查系统代理与路由模式。

系统代理 已启用
路由模式 规则
连接状态 已连接

连接失败时只改一个变量

如果启动后立即报错,先记录错误发生在更新订阅之后还是启动核心之后。订阅可以更新但核心无法启动,通常应检查客户端组件、配置格式或本地端口占用;核心可以启动但目标页面无法访问,则继续检查服务器、路由和 DNS。不要同时重装客户端、替换订阅、切换 TUN、修改 DNS,这会让原本单一的问题变得无法定位。

最简单的对照方式是先换同一订阅分组中的另一个服务器,再重新连接。如果只有某一个配置失败,而其他配置可以使用,优先联系订阅服务方确认该服务器状态。如果全部配置都失败,再回到客户端层检查代理模式与权限。更多错误提示及处理顺序集中在帮助中心,本教程继续完成最后一步:验证实际流量是否已经按预期经过代理。

04
第四步

验证浏览器与应用是否生效

连接按钮变为启用状态只是第一层确认。完整验证要分三层进行:先看客户端核心是否运行,再看目标应用是否把请求交给客户端,最后看路由规则是否选择了正确出站。按这个顺序检查,可以避免把浏览器扩展冲突误判成服务器故障,也能避免把某条路由规则的问题误判成整个订阅不可用。

先用浏览器完成基础验证

保持客户端连接,彻底关闭并重新打开浏览器,再访问一个平时需要代理的目标页面。重新启动浏览器可以让它重新读取系统代理设置。如果页面可以打开并且资源加载完整,说明订阅、服务器、客户端核心和浏览器代理路径基本连通。接着再访问常用的直连页面,确认规则模式下两类访问都正常。

如果浏览器仍然使用旧路径,检查浏览器是否安装了独立管理代理的扩展。这类扩展可能覆盖系统设置,使浏览器不再跟随 v2rayN。排查时暂时停用扩展,保留客户端的系统代理,再重新打开浏览器测试。也可以查看浏览器的网络设置来源,确认当前采用系统代理,而不是固定写入了另一组地址和端口。

再分别检查终端与独立应用

终端程序经常不读取系统代理,因此浏览器成功、命令行失败是常见现象。此时先确认该程序是否支持系统代理、环境变量或应用内代理。不要因为终端没有生效就立刻更换服务器。若希望统一接管这类流量,可以评估 TUN 模式;如果只需让单个程序使用代理,优先按照该程序自身的代理设置方式配置。

独立应用也是同样的判断逻辑。应用内如果已经写入固定代理,它可能绕过或覆盖系统代理;应用如果完全不支持代理,则系统代理模式可能无法接管。先查应用的网络设置,再决定是否切换 TUN。关于浏览器与终端分开排查的完整逻辑,可阅读系统代理不生效的分层排查

通过客户端日志判断请求路径

客户端日志可以确认请求是否到达本地代理,以及路由规则选择了直连、代理还是阻断出站。验证时保持日志窗口打开,然后只刷新一次目标页面,观察是否出现对应域名或连接记录。如果完全没有新记录,问题通常发生在应用到客户端之间;如果有记录但连接失败,继续查看服务器连接、DNS 解析或路由选择。

日志用于判断方向,不需要逐行修改配置。看到域名被分到直连,而预期应走代理时,先用全局模式做一次短时对照。全局模式可以访问、规则模式不能访问,说明需要调整路由规则。若两种模式都失败,再测试其他服务器,并确认设备时间、网络权限和 DNS 状态。路由规则与 DNS 的系统化调整方法放在进阶配置手册中。

A
客户端状态

核心运行,当前服务器明确,连接没有立即退出。

B
浏览器路径

重新启动后读取系统代理,目标页面可以完整加载。

C
日志与路由

请求进入客户端,并由规则选择预期的出站方向。

完成标志:客户端保持连接,浏览器能够按预期访问目标页面,常用直连页面也能正常打开,日志中可以看到请求进入并被路由处理。基础配置至此完成。

快速排查

没有生效时按层检查

不要从重装开始。先判断问题处于订阅、核心、应用接管还是路由层,再做对应修改。

1

列表是否存在

服务器列表为空,回到订阅设置检查地址并重新更新。此时无需调整代理模式。

2

核心是否运行

连接后立即退出,查看启动错误、权限与本地端口占用,再尝试其他服务器。

3

应用是否接管

浏览器与终端分开测试,确认应用读取系统代理,或根据需要评估 TUN 模式。

4

规则是否匹配

用全局模式短时对照。只有规则模式失败时,再检查域名、IP 与 DNS 分流。

订阅更新失败时,重点检查地址与当前网络;核心启动失败时,重点检查权限、组件与端口;只有某个应用失败时,重点检查该应用的代理来源;只有某类域名失败时,重点检查路由与 DNS。按照层次处理,通常比连续切换多个开关更快。

如果问题需要更细的错误分类,可以进入帮助中心查看安装配置、使用技巧与故障排查问答。需要管理多订阅、编写自定义路由、设置分流 DNS、启用 FakeDNS 或自定义出站时,继续阅读进阶配置手册。基础教程到这里结束,后续配置应围绕实际需求逐项增加。