10 分钟快速上手

V2Ray 客户端快速设置:订阅导入到连接验证

按顺序完成四件事:导入订阅、选择代理模式、连接服务器、验证是否生效。教程聚焦第一次配置需要点击的位置和判断依据,不展开复杂路由与 DNS 参数。

准备阶段

开始前准备:客户端、订阅地址与当前网络

开始操作前,先确认设备上已经安装对应客户端。Windows、macOS 与 Linux 桌面设备使用 v2rayN,Android 设备使用 v2rayNG。尚未安装时,可以先到客户端下载页按平台选择版本。安装完成后先正常启动客户端,不必急着修改内核、端口、DNS 或 TUN 等参数;第一次设置只需要处理订阅、活动服务器和连接开关。

还需要准备一个可用的订阅地址。订阅地址通常是一段以 https:// 开头的链接,由订阅服务提供方给出。它与单个 vmess://vless://trojan:// 配置不同:订阅链接可以集中提供多个服务器,并允许客户端之后执行更新。复制地址时应从开头复制到结尾,不要额外带入空格、换行或聊天软件自动添加的说明文字。

如果拿到的是二维码、单个协议链接或一段完整配置,而不是订阅地址,导入入口会略有不同。本教程优先讲最常见的订阅方式;单节点导入、二维码识别和配置迁移可以查看帮助中心中的安装配置分类。无论使用哪种形式,后续“选择代理模式—连接—验证”的操作思路基本一致。

客户端已启动 能够看到主窗口、服务器列表或配置列表。
订阅地址已复制 地址完整,开头和结尾没有多余字符。
网络可以正常使用 先确认普通网页能够打开,便于区分本地网络问题。
第一步

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

订阅导入的目标不是只把链接保存到客户端,而是让客户端读取链接内容并生成服务器列表。因此,这一步包含两个连续动作:先新增订阅分组,再执行一次订阅更新。只完成保存却没有更新时,主界面可能仍然是空的,这是第一次操作中最常见的遗漏。

v2rayN 桌面端:新增订阅分组

打开 v2rayN 主窗口,在顶部菜单中找到“订阅分组”或名称相近的订阅管理入口,然后进入“订阅分组设置”。部分版本会把入口收在订阅菜单的二级列表中;如果主窗口较窄,可以先展开窗口再查看完整菜单。进入设置页后,点击“添加”或带加号的按钮,新建一个订阅分组。

在“别名”或“备注”一栏填写容易识别的名称,例如按来源写成“日常订阅”。这个名称仅用于本地分组,不影响服务器配置。接着把已经复制的订阅地址粘贴到 URL 一栏。确认地址前后没有空格后保存设置,返回 v2rayN 主窗口。此时分组已经建立,但服务器内容未必立即出现。

再次打开“订阅分组”菜单,选择“更新全部订阅”或对刚才的分组执行更新。客户端会请求订阅内容并解析其中的服务器配置。等待片刻后,主界面的服务器列表应出现协议类型、服务器别名、传输方式等项目。列表数量由订阅内容决定,不应以某个固定数量作为成功标准;只要出现可选择的服务器行,并且日志没有持续显示解析错误,就可以进入下一步。

v2rayNG 安卓端:添加订阅并更新

打开 v2rayNG 后,进入侧边菜单中的“订阅分组设置”。点击页面右上角的加号,新建订阅分组。在备注栏填写便于区分的名称,在地址栏粘贴完整订阅链接,然后保存。返回主页面后,从右上角菜单中选择“更新订阅”,或在订阅分组页面对当前分组执行更新。

更新完成后,主页面会出现一组配置条目。每一条通常显示别名,部分版本还会显示协议或地址摘要。轻点某个条目只是选中它,不代表连接已经启动;被选中的配置一般会出现颜色标记、勾选状态或高亮背景。现在只需要确认列表已经生成,暂时不要连续点击多个开关。

更新后列表为空时怎么判断

先回到订阅设置,重新打开刚保存的分组,检查地址是否完整。若地址末尾被截断、粘贴了两次,或前后包含换行,应删除后重新粘贴。然后确认分组处于启用状态,再执行更新。如果日志提示无法获取内容,可以先用设备当前网络打开普通网页,确认基础网络正常;如果只有该订阅无法更新,则需要核对订阅地址本身是否仍然有效。

如果更新提示成功,但列表中看不到新配置,还要留意客户端是否启用了服务器过滤条件,或者当前界面是否只显示另一个分组。先切换到“全部服务器”或刚添加的订阅分组,再观察列表。更细的订阅格式、Base64 内容和过滤规则排查方法可查看帮助中心,本页继续处理能够看到服务器列表后的基础连接流程。

这一步完成时应看到

客户端内已经存在一个命名清楚的订阅分组,主界面出现至少一条可选择的服务器配置,更新过程没有持续报错。接下来需要决定客户端如何接管设备流量。

第二步

选择代理模式与基础路由方式

服务器列表准备好后,先不要立即调整大量规则。这里需要区分两个容易混淆的概念:一是客户端通过什么方式接管流量,二是接管后哪些请求走代理、哪些请求保持直连。前者通常表现为“系统代理”“连接开关”或“TUN 模式”,后者通常称为“路由模式”或“分流规则”。

v2rayN 桌面端:先使用系统代理

第一次配置 v2rayN 时,建议先使用系统代理完成基础验证。系统代理会为遵循操作系统代理设置的浏览器和应用提供连接,操作路径较短,也便于出现问题时快速关闭。找到主窗口底部状态栏、托盘菜单或“系统代理”菜单,将状态从“清除系统代理”切换为“自动配置系统代理”或版本中含义相近的启用选项。

随后查看“路由”或“路由模式”设置。若客户端已经带有默认规则,可以先保留默认选择。常见模式包括全局、规则分流以及直连模式:全局模式会让更多符合接管条件的请求交给当前服务器;规则分流会按域名、地址和预设规则决定出口;直连模式主要用于临时停用代理路径。日常首次设置更适合使用默认的规则分流,而不是先建立复杂的自定义规则。

TUN 模式能够覆盖更多不读取系统代理设置的应用,但它涉及虚拟网络接口、DNS 接管和路由表,因此不适合作为第一次连通测试的必选项。先用系统代理确认订阅与服务器可以正常工作,之后确有全局接管需求,再按照高级用法手册的 TUN 模式章节逐项设置。这样可以把订阅问题、服务器问题和接管范围问题分开判断。

v2rayNG 安卓端:确认当前配置与路由设置

v2rayNG 的主页面通常会显示当前选中的配置,底部或右下区域提供连接按钮。进入设置页后,可以看到“路由设置”“预定义规则”或含义相近的选项。第一次使用时保留默认路由即可;如果页面已经选中一套预定义规则,不需要为了追求更多选项而立即修改。默认配置更适合先确认服务器能否建立连接。

安卓端启动连接时,系统可能弹出网络连接授权提示。阅读提示后确认允许,客户端才能建立本地网络接口。这个授权只需要在系统要求时处理;如果取消,主页面可能很快恢复到未连接状态。此时重新点击连接按钮并完成系统提示即可,不需要重复导入订阅。

什么时候才需要改变模式

如果浏览器能够正常使用,但某个不读取系统代理的桌面应用没有经过客户端,可以在基础连接验证完成后考虑 TUN 模式。如果只希望部分地址走代理,则应使用规则分流,而不是频繁切换服务器。如果某个本地设备、局域网服务或常用直连地址受到影响,则应检查绕过局域网与直连规则。以上都属于连接已经可用之后的优化,不应与第一次启动同时进行。

这一步完成时应看到

v2rayN 已准备使用系统代理,或 v2rayNG 已保留一套明确的默认路由设置。当前还没有必要编辑规则文件;下一步只需选中服务器并启动连接。

第三步

选择服务器并启动连接

连接步骤由“选择活动服务器”和“启动接管”两个动作组成。只高亮服务器但没有打开系统代理或连接开关,应用流量不会自动交给客户端;反过来,如果连接开关已经打开,但没有正确的活动服务器,客户端也无法建立预期连接。因此要按固定顺序操作,先选服务器,再启动。

v2rayN 桌面端:设为活动服务器

在主窗口服务器列表中单击准备使用的条目,确认整行处于选中状态。随后按 Enter,或打开右键菜单选择“设为活动服务器”。不同版本可能使用粗体、颜色标记、左侧竖条或状态栏文字表示当前服务器。判断重点不是某一种固定外观,而是窗口底部或服务器列表中能够明确看到当前活动项。

确认活动服务器后,检查系统代理状态是否已经按上一步启用。如果状态栏仍显示“未设置系统代理”或“清除系统代理”,打开系统代理菜单并切换到自动配置状态。此时 v2rayN 会启动本地核心并生成相应配置。主窗口底部通常会显示本地端口、系统代理状态或当前服务器名称,日志区域也会开始出现启动信息。

不要把服务器列表中的延迟测试结果当作唯一判断依据。延迟测试只能反映某种探测方式是否得到响应,不等于浏览器流量已经正确经过客户端。第一次设置可以先选择订阅提供方标记为常用的服务器;如果没有明确说明,就任选一条进行实际连接验证。出现问题时再换另一条,以排除单个服务器配置异常。

v2rayNG 安卓端:选中配置并点击连接

在 v2rayNG 主页面轻点一个配置条目,使它成为当前配置。通常页面顶部或条目旁会出现选中标记。接着点击页面底部的圆形连接按钮。首次启动时如果系统显示网络连接请求,确认后等待数秒。连接成功后,按钮外观会改变,页面状态会从未连接切换为已连接,系统状态区域通常也会显示持续连接提示。

如果点击后立即停止,先打开 v2rayNG 的日志页面,查看最后几行信息。常见原因包括服务器配置无法解析、订阅内容已经失效、设备时间偏差较大,或者当前网络暂时无法连接目标地址。不要在短时间内反复点击连接按钮;先停止一次,确认当前选中的配置,再重新启动。连续快速切换会让日志混入多次启动记录,不利于判断。

通过日志识别启动阶段

正常启动时,日志通常会先显示加载配置、启动核心和监听本地连接等信息,之后进入等待请求的状态。日志没有新内容不一定表示失败,因为尚未打开网页时可能没有应用请求。真正需要留意的是反复出现的错误行,例如配置字段无法识别、地址解析失败、连接超时或端口被占用。

如果桌面端提示本地端口被占用,先退出其他正在使用相同代理端口的客户端,再重新启动 v2rayN。若 v2rayNG 显示当前配置不可用,可以停止连接,选择同一订阅分组中的另一条配置后再试。更完整的日志关键词解释与故障分类收录在帮助中心的故障排查部分

这一步完成时应看到

客户端已经明确选中一个活动服务器,连接开关处于启动状态,日志完成初始化并等待应用请求。接下来通过实际访问和状态观察确认流量是否生效。

第四步

验证代理是否生效并完成基础排错

验证连接时不要只看按钮颜色,也不要只看服务器是否被高亮。更可靠的方法是同时观察三个位置:客户端的连接状态、日志中的请求记录,以及浏览器或应用的实际访问结果。三者相互对应,能够帮助判断问题发生在订阅、服务器、接管方式还是具体应用。

先做一次普通网页访问

保持客户端运行,打开平时使用的浏览器,新建一个页面并访问常用网站。建议先关闭浏览器中单独配置的代理扩展,避免它覆盖操作系统代理设置。页面能够正常加载后,再打开另一个页面重复测试。如果 v2rayN 的日志随访问出现新的连接记录,说明浏览器请求已经到达客户端;v2rayNG 也可以在日志或连接状态中看到活动变化。

如果网页仍沿用启动客户端之前的连接状态,可以完全关闭浏览器后重新打开。部分桌面应用只在启动时读取系统代理配置,客户端运行中途切换代理后,旧进程未必立即刷新设置。重新启动应用比反复修改客户端端口更直接。对于不读取系统代理的桌面程序,先记录这一现象,基础验证完成后再考虑 TUN 模式。

状态正常但网页打不开

先回到服务器列表,确认活动服务器仍是刚才选中的条目。然后停止连接,选择同一订阅中的另一条服务器,再重新启动。如果更换后可以访问,问题通常集中在原服务器配置,而不是客户端安装。若多条服务器表现一致,再检查订阅是否刚刚成功更新、设备日期和时间是否准确,以及当前网络是否能够正常解析域名。

接下来检查代理模式。v2rayN 用户应确认系统代理不是“清除”状态,浏览器也没有被单独设置为永不使用代理。v2rayNG 用户应确认连接按钮仍处于启动状态,系统没有因为省电策略立即停止客户端。先处理这些基础状态,再考虑 DNS 或路由规则;过早改动 DNS 往往会把简单的开关问题变成多项配置叠加的问题。

网页可用但部分应用无效

这通常说明服务器连接本身已经工作,差异来自应用是否遵循当前接管方式。v2rayN 的系统代理主要影响读取操作系统代理设置的程序,某些独立网络程序可能直接建立连接。此时不要重新导入订阅,也不必删除已经可用的服务器。可以先查找该应用自身的代理设置;若确实需要扩大接管范围,再阅读TUN 模式配置

如果只有某些域名表现异常,则更可能与路由或 DNS 相关。先暂时切回客户端默认路由,确认问题是否消失。默认路由可用后,再逐条恢复自定义规则,每次修改后重新应用配置并测试。订阅过滤、DNS 优先级、FakeDNS 与自定义出站属于进阶主题,适合在基础连接稳定后单独处理。

怎样判断四步已经完成

完成状态应满足以下条件:客户端可以稳定保持连接;主界面能够指出当前活动服务器;浏览器访问时日志出现对应请求;停止客户端连接后,状态和访问路径会随之变化;重新启动客户端时不需要再次导入订阅。达到这些条件,说明订阅保存、服务器选择、接管方式和连接流程都已经建立。

订阅可以更新 服务器列表能够正常生成,分组名称清楚。
活动服务器明确 客户端主界面能够识别当前使用的配置。
连接保持运行 启动后不会立即停止,日志没有持续重复错误。
实际访问有响应 浏览器请求与客户端日志能够相互对应。
设置完成

完成后的日常使用与下一步

基础设置完成后,日常使用通常只需要三个动作:启动客户端、确认活动服务器、打开连接。订阅内容有变化时再执行订阅更新,不需要每次启动都重新添加链接。若更新后出现新的服务器,可以先保持当前可用配置,等需要切换时再选择;频繁更换不会改善已经稳定的连接。

停止使用时,v2rayN 用户应先清除系统代理或从客户端菜单停止接管,再退出程序。如果直接结束进程后发现浏览器无法访问网络,可以重新打开 v2rayN,执行一次“清除系统代理”后再关闭。v2rayNG 用户可以先点击连接按钮停止服务,确认页面回到未连接状态后退出。按这个顺序操作,可以让系统网络设置恢复得更明确。

需要进一步配置订阅分组、服务器过滤、自定义路由、DNS、TUN、FakeDNS、多订阅管理或自定义出站时,可进入高级用法手册按章节阅读。遇到订阅更新失败、日志报错、系统代理未恢复或特定应用无法连接等问题,可先查阅帮助中心,按照现象分类比从头重装客户端更容易定位原因。