10 分钟快速上手

v2rayN 与 v2rayNG:从订阅导入到连接验证

先准备订阅链接,再依次完成导入、模式选择、连接和验证。每一步只调整当前需要的设置,完成后再进入下一步。

准备

开始前准备:客户端与订阅链接

先安装与当前设备对应的客户端。桌面设备打开 v2rayN,Android 设备打开 v2rayNG。首次启动时,系统可能要求确认网络访问权限;需要允许客户端建立网络连接,否则后续即使导入了配置,也无法正常发起连接。桌面端启动后如果主窗口没有出现,可查看系统托盘区域,v2rayN 通常会继续在后台运行。

接着准备一条可用的订阅链接。订阅链接由配置提供方给出,通常是一段以 https:// 开头的地址。复制时要包含完整内容,不要把链接前后的说明文字一并选中。链接属于配置入口,不适合粘贴到公开页面、聊天群或截图中;本教程只要求将它填写到客户端的订阅地址输入框。

如果手里只有单个分享链接,也可以在客户端中使用“从剪贴板导入”一类入口,但单个链接不会自动同步后续变更。快速上手更建议使用订阅分组:配置提供方更新节点后,只需在客户端执行一次“更新订阅”,不必重复逐条导入。

桌面端

打开 v2rayN 主窗口

确认顶部菜单、服务器列表和底部状态区域可以正常显示。窗口关闭后仍可能停留在系统托盘。

Android

打开 v2rayNG 主界面

确认侧边菜单可以展开,并准备在系统提示出现时授予建立网络连接所需的权限。

完成这些准备后,先不要修改 DNS、TUN、端口或内核参数。默认设置足够完成首次连接。需要理解不同内核、协议与高级路由规则时,再进入新手到进阶完整手册逐章设置。

步骤 1

导入订阅:添加分组并更新配置

v2rayN 桌面端

在 v2rayN 主窗口中打开“订阅分组”,进入订阅分组设置。选择“添加”,在备注栏填写一个便于识别的名称,例如“日常配置”,再把完整订阅链接粘贴到地址栏。备注只用于本地识别,不影响连接;当以后添加多条订阅时,清楚的分组名称能帮助判断服务器来自哪里。

保存分组后返回主窗口,打开订阅菜单并执行“更新全部订阅”。客户端会读取刚才保存的地址并解析配置。更新完成后,服务器列表应出现一条或多条可选择的记录。此时先看列表是否确实产生了新内容,不必根据名称猜测协议,也不需要手动改动地址、端口、传输方式或安全设置;这些字段已经包含在订阅结果中。

如果保存后列表仍为空,先再次进入订阅分组设置,检查地址开头、结尾和中间是否多出空格。随后单独更新这个分组,并查看窗口底部提示或日志。出现“无法连接”“超时”一类结果时,不要连续快速点击更新,先确认设备当前可以正常访问网络,再等待片刻重试。

v2rayNG Android 端

打开 v2rayNG 的侧边菜单,进入“订阅分组设置”,点击添加按钮。填写分组名称与订阅地址后保存,然后回到主界面,从菜单中执行“更新订阅”。部分版本会要求先选中刚创建的分组,再开始刷新;如果主界面没有出现配置,回到分组列表确认该分组处于启用状态。

更新完成后,主界面会列出订阅解析出的配置。点击其中一条记录,使它成为当前选中项。当前项通常会有选中标记或不同的背景状态。这里只是在指定下一步要连接的配置,尚未真正启动网络连接。

如果订阅中包含大量记录,首次操作只需选一条名称清晰的配置继续。延迟测试可以作为后续筛选工具,但测试结果受到当前网络、测试目标和时间影响,不需要为了追求某个数值反复刷新。先完成一次稳定连接,再处理节点整理与订阅分组。多订阅过滤、备注和更新策略可查看订阅与节点管理章节

步骤 2

选择代理模式:先用系统代理与规则分流

订阅导入完成后,需要决定哪些程序和请求交给客户端处理。首次使用时,桌面端建议先选择“自动配置系统代理”,路由模式选择“绕过大陆”;Android 端建议先选择规则模式。这个组合容易观察,也便于出现问题时分清是节点、程序代理还是路由规则造成的。

v2rayN:自动配置系统代理

在 v2rayN 的托盘菜单或主窗口底部找到“系统代理”,选择“自动配置系统代理”。设置生效后,遵循系统代理的浏览器与桌面程序会把符合条件的请求交给 v2rayN。若状态仍显示“清除系统代理”或“未启用”,说明客户端虽然可以运行内核,但其他程序还没有获得代理入口。

随后打开“路由设置”,选择“绕过大陆”预置规则。它的用途是让常见本地地址和内网地址保持直连,同时把其他匹配项交给代理出站。首次连接不要立即叠加自定义域名、进程规则和复杂 DNS 条目,否则验证失败时很难确定是哪一条规则产生了影响。

v2rayNG:规则模式

在 v2rayNG 的设置或主界面配置项中找到路由模式,选择规则模式。不同版本对预置规则的名称可能略有差异,操作重点是使用客户端提供的规则分流,而不是一开始就让所有请求采用同一种出站。选择后返回主界面,确认刚才选中的服务器记录仍处于活动状态。

系统代理主要覆盖会读取系统代理设置的程序。部分游戏、命令行工具和独立网络程序可能绕过该设置,因此“浏览器可以连接、某个应用不能连接”并不直接说明节点故障。TUN 模式可以接管更多类型的网络请求,但会涉及虚拟网卡、权限、DNS 和路由冲突。快速上手阶段先不用开启;需要处理不遵循系统代理的程序时,再阅读TUN 模式章节

桌面推荐起点 自动配置系统代理 + 绕过大陆
Android 推荐起点 规则模式 + 当前选中配置
步骤 3

连接节点:设为活动配置并启动

模式设置完成后,回到服务器列表选择一个配置。v2rayN 中可以双击目标记录,或通过右键菜单将其设为活动服务器。确认活动项后启动服务;如果客户端已经在运行,切换活动服务器通常会重新加载核心配置。底部状态区域应显示当前服务器信息和系统代理状态,日志区域也会出现核心启动与配置加载记录。

v2rayNG 中先点击一条配置,再点击主界面的圆形启动按钮。首次启动时,系统会显示网络连接确认窗口,确认后才能建立连接。启动按钮状态改变,并且系统状态区域出现连接标识时,说明客户端已经开始处理网络请求。此时不要立即退出客户端,也不要在系统最近任务界面中强制结束它。

正常启动日志通常会包含监听端口、配置加载和核心运行等信息。日志中偶尔出现单次连接关闭并不一定代表整体失败;真正需要处理的是持续重复的配置解析错误、地址不可达、握手失败或权限错误。如果日志一启动就停止,先保留当前画面,记下最早出现的错误行,因为后续重复信息往往只是前一个错误带来的结果。

连接过程中只切换一个变量。比如当前配置无法建立连接,可以先换到同一订阅中的另一条记录,保持代理模式和其他设置不变;如果所有记录都失败,再更新订阅并检查本地网络。一次同时更换节点、模式、DNS 与内核参数,会让排查失去明确顺序。

步骤 4

验证是否生效:浏览器、路由与日志逐层检查

先新建一个浏览器窗口或标签页,打开平时可以直连访问的页面,确认它仍能正常加载。随后再打开需要通过当前配置访问的目标页面。两类页面都能加载,说明客户端连接、系统代理和基础路由已经形成完整链路。验证时应使用熟悉且稳定的站点,不要用临时关闭或本身响应缓慢的页面作为唯一判断依据。

如果目标页面可以访问,但本地页面明显变慢,回到路由设置确认当前仍是规则分流,而不是全局模式。如果所有页面都无法访问,先查看客户端是否仍在运行、活动配置是否存在,以及系统代理是否指向当前客户端。桌面端还可以临时执行“清除系统代理”,确认本地网络恢复后,再重新选择“自动配置系统代理”。这一动作可以区分基础网络问题与代理链路问题。

接着查看日志。验证期间新产生的日志最有参考价值:域名解析错误通常指向 DNS 设置或本地网络;连接超时可能与当前节点、网络路径或目标地址有关;配置解析错误则需要重新更新订阅,避免继续使用字段不完整的旧记录。不要只截取日志最后一行,应从本次启动位置开始向下查看,找到最先出现的明确错误。

还可以关闭客户端连接后再次访问同一目标页面,再重新连接进行对照。对照结果应当与预期一致:关闭后恢复直连状态,启动后由当前规则处理。若关闭客户端后浏览器仍尝试访问旧代理端口,说明系统代理没有被正确清理。此时在 v2rayN 托盘菜单中选择“清除系统代理”,退出并重新打开浏览器,然后再启动客户端。

部分程序不会读取系统代理,因此浏览器验证成功后,其他程序仍可能保持原来的连接方式。先检查该程序自身是否提供代理设置;如果提供,可填写 v2rayN 本地监听地址与端口。需要让更多程序统一经过客户端时,再按完整手册中的 TUN 步骤检查权限、虚拟网卡和 DNS,不要直接照搬来源不明的整段配置。

订阅列表中存在可选择的配置
当前服务器已经设为活动项
系统代理或规则模式处于预期状态
新打开的页面可以按规则访问
日志中没有持续重复的启动错误
完成后

日常使用:更新订阅、切换节点与退出

首次验证完成后,日常操作可以保持简单。配置提供方提示内容已更新时,在客户端中执行“更新订阅”,等待列表刷新,再选择需要使用的活动服务器。更新过程中不要删除原订阅分组后重新创建,除非订阅地址本身已经变化;保留分组可以继续使用原来的备注与分组关系。

需要切换服务器时,先在列表中选择另一条记录并设为活动项,再重新打开目标页面验证。客户端通常会自动重载配置,但已有程序可能维持先前建立的连接。遇到“切换后结果没有变化”时,先关闭对应程序的旧页面或连接,再重新发起请求,而不是立即修改路由规则。

暂时不用时,桌面端先在托盘菜单中清除系统代理,再退出 v2rayN。只关闭主窗口可能只是把程序缩到托盘,系统代理仍然保持启用。Android 端先点击停止按钮,确认连接状态结束后再退出。按照这个顺序操作,可以避免下次启动浏览器时仍然指向已经停止的本地代理端口。

完成快速上手后,建议只按实际需求继续增加设置。需要让境内外域名分别解析时再配置 DNS,需要处理不遵循系统代理的程序时再配置 TUN,需要固定直连或代理目标时再添加自定义路由。协议区别、内核选择、路由优先级、DNS 分流与维护方式集中在从零到进阶完整手册,快速使用阶段不必一次设置全部功能。

出现问题时

快速排查:按导入、启动、代理、解析的顺序检查

服务器列表为空时,问题通常发生在订阅导入阶段。检查订阅分组是否启用、地址是否完整,再执行一次单独更新。更新提示格式错误时,应重新复制原始链接;更新提示网络超时时,先用普通网页确认当前基础网络正常。不要在列表为空时继续调整系统代理,因为此时客户端还没有可以启动的有效配置。

列表存在但核心无法启动时,先换用订阅中的另一条记录。如果所有记录都在相同位置报配置错误,更新订阅并重启客户端;如果只有一条记录失败,可以暂时使用其他记录。客户端版本过旧也可能无法识别较新的配置字段,可前往客户端下载页选择当前平台版本。

客户端显示已连接但浏览器没有变化时,检查 v2rayN 的系统代理是否为“自动配置系统代理”,或确认 v2rayNG 的连接状态仍处于启用。桌面端还要留意浏览器是否使用了独立代理扩展或手动代理地址;多个代理入口同时生效时,浏览器可能不会采用系统设置。先暂时停用额外代理配置,只保留客户端的系统代理进行验证。

只有域名打不开、直接访问已知地址却有响应时,排查重点转向 DNS。先恢复客户端默认 DNS 设置,重新启动连接并测试。如果问题只在开启 TUN 后出现,应先关闭 TUN,回到本教程的基础模式确认连接正常,再根据完整手册逐项配置 DNS 出站、查询规则和虚拟网卡。关于解析请求走向与泄漏排查,可阅读v2rayN DNS 检测与修复步骤

完成以上检查仍无法判断时,保留客户端名称、操作系统、代理模式、发生时间和最早一条明确错误信息。问题描述应说明“订阅能否更新、核心能否启动、浏览器是否遵循系统代理、哪些页面受到影响”,比只写“连接失败”更容易定位到具体环节。

下载客户端