约十分钟的基础配置路径

v2rayN 快速上手:订阅导入、连接与验证

先把客户端、内核和代理设置分开理解,再按固定顺序操作:导入可用配置,决定应用怎样接入,启动连接,最后逐个验证实际应用。已经安装客户端并取得有效订阅地址时,可以直接从第一步开始。

订阅导入 系统代理 路由模式 连接验证

开始前检查

准备客户端、订阅地址与操作边界

开始配置前,先确认设备上安装的是图形客户端,而不是单独下载的代理内核。v2rayN 是桌面客户端,负责保存订阅、生成运行配置、选择路由方式并调用 Xray 或 V2Fly 等内核;内核负责解析配置和处理连接,本身不等于可以直接操作的完整桌面界面。代理设置则位于另一层,它决定浏览器、终端或其他应用是否把流量交给本地客户端。

还需要准备一条有效的订阅地址,或者一份服务提供方给出的单项配置。订阅地址一般是一段以 https:// 开头的链接,用于让客户端获取和更新配置列表。不要把网页账号登录地址、套餐页面地址或普通文本说明误当成订阅地址。如果得到的是单个分享链接,可以使用客户端对应的“从剪贴板导入”功能,但后续更新方式会与订阅分组不同。

本教程默认客户端已经能够正常打开。尚未安装时,先进入客户端下载页,按 Windows、macOS、Android 或 Linux 选择相应入口。桌面设备优先查看 v2rayN,Android 设备查看 v2rayNG。下载与安装完成后再返回本页,避免把安装问题、订阅问题和代理模式问题混在一次排查中。

客户端

能够正常打开主窗口或设置页面,并且没有重复启动多个实例。

配置来源

已经取得订阅地址或单项分享链接,且知道它对应哪个订阅分组。

操作目标

先确定要让浏览器接入,还是还要覆盖终端及其他不读取系统代理的应用。

步骤一

导入订阅并确认配置列表

在 v2rayN 主窗口中找到“订阅分组”“订阅设置”或含义相近的入口。不同界面版本可能把它放在顶部菜单、侧边栏或订阅管理页面,但操作目标相同:新建一个订阅分组,填写便于自己识别的名称,再把完整订阅地址粘贴到地址栏。名称只用于本地分类,例如按用途区分不同来源,不会改变订阅内容。确认地址前后没有多余空格后保存设置。

保存订阅分组并不等于已经取回配置。返回主窗口后,继续执行“更新订阅”“更新全部订阅”或当前分组的更新操作。客户端会读取订阅内容,并把可识别的配置写入列表。此时应当看到配置名称或配置条目出现在主列表中;如果列表仍为空,不要直接转到系统代理设置,因为本地还没有可以交给内核运行的有效配置。

v2rayNG 的处理顺序相似:进入订阅设置,新建订阅,填写名称和地址,保存后返回并执行更新。部分版本也提供从剪贴板导入单项配置的入口。使用剪贴板导入前,应先复制完整分享链接;导入完成后检查列表是否新增条目。单项导入通常不会自动归入可更新的远程订阅,因此日后配置发生变化时,需要重新导入或按提供方说明处理。

列表出现后,先选中准备使用的一项配置。这里的“选中”只是确定客户端接下来调用哪份配置,并不表示系统中的其他应用已经开始使用代理。订阅解决的是“客户端获得什么配置”,系统代理或 VPN 接入解决的是“哪些应用把请求交给客户端”,而路由规则解决的是“进入客户端后的请求如何选择出口”。这三个阶段按顺序检查,遇到问题时更容易定位。

下一步判断

主列表已经出现配置,并且目标配置处于选中状态后,再决定浏览器和其他应用采用哪种接入方式。

步骤二

选择系统代理、路由规则或 TUN

对多数桌面浏览器的首次测试,先使用“自动配置系统代理”更容易观察结果。v2rayN 启动本地监听后,这个选项会把相应代理地址写入系统设置;会读取系统代理的浏览器和桌面软件随后可以把请求发送到本地客户端。选择“清除系统代理”则是撤销这项系统设置,而不是删除订阅或配置。手动配置系统代理适合已经明确知道本地监听地址和端口的情况,初次上手不必先走这条路径。

系统代理并不会自动覆盖所有程序。部分终端工具、开发环境、游戏平台或带有独立网络选项的软件会忽略系统设置,需要在应用内部填写代理地址,或使用该工具支持的代理参数。判断一个应用是否接入时,应查看它自己的网络设置说明,不能因为浏览器已经可用,就推断所有程序都采用相同路径。

路由模式处理的是已经进入客户端的流量。常见界面会提供规则、全局或直连等选项,具体名称可能随路由配置而变化。首次设置可先使用客户端已有的规则模式,完成连接与验证后再根据需求调整。全局模式会让更多已接入的请求统一走代理出口,适合短时间排除规则匹配问题,但不宜把它与“覆盖所有应用”混为一谈:某个应用如果根本没有接入本地代理,切换路由模式仍不会改变它的连接方式。

TUN 用于处理不读取系统代理的流量,覆盖范围通常比普通系统代理更广,同时也会引入系统权限、虚拟网络接口、DNS 处理和其他网络软件冲突等额外变量。基础浏览器测试不需要一开始就启用 TUN。建议先完成普通系统代理路径,确认订阅和配置能够工作;确实存在应用无法通过自身设置接入时,再阅读TUN 配置章节,逐项确认权限、路由范围和 DNS 行为。

在 v2rayNG 中,系统会把客户端作为 VPN 类型的网络连接处理。首次启动时需要确认系统授权;若启用了分应用代理,还要明确哪些应用被包含或排除。分应用范围与服务端配置无关,它只决定设备上的哪些应用把请求交给客户端。初次验证时应保持范围清晰,避免一边更换配置、一边调整分应用列表,导致无法判断问题来自哪一层。

配置层 订阅与当前配置

决定客户端交给内核执行的协议、地址和连接参数。

接入层 系统代理、应用设置或 TUN

决定浏览器、终端和其他应用是否把请求送入客户端。

路由层 规则、全局与直连

决定已经进入客户端的请求如何匹配规则并选择出口。

建议的首次选择

桌面端选中一项配置,使用现有规则模式,并准备启用自动配置系统代理;Android 端确认系统授权和分应用范围,然后进入启动步骤。

步骤三

启动内核并让目标应用接入

返回 v2rayN 主列表,再次确认当前选中的配置与刚才导入的订阅一致,然后执行启动或设为活动配置的操作。客户端会根据当前配置生成内核运行参数,并尝试建立本地监听。接着从托盘菜单或系统代理区域选择“自动配置系统代理”。正确顺序是先确保客户端能够启动本地服务,再让应用把请求交给这个本地入口;如果本地监听没有建立,仅修改系统代理可能使浏览器暂时无法正常访问网络。

启动后查看客户端提供的状态提示或错误提示。重点不是某个图标是否变色,而是有没有出现配置解析失败、本地端口无法监听、核心启动失败等明确错误。如果提示端口被占用,常见原因是重复打开了另一个客户端实例,或者其他程序正在使用相同端口。先退出重复实例,再重新启动;需要修改监听端口时,还要同步修改曾经在浏览器、终端或其他软件中手动填写的代理地址。

在 v2rayNG 中,选中配置后点击连接操作。首次连接会显示系统 VPN 授权窗口,确认后客户端才可以建立对应接口。如果系统中已有其他同类连接,通常需要先结束原有连接,再启动 v2rayNG。启用分应用代理时,确认准备测试的浏览器或应用位于预期范围内,否则客户端即使已经运行,该应用也可能继续使用原来的网络路径。

连接操作只表示客户端开始调用内核并建立接入入口,不等于远端配置一定可用。订阅中的某项配置可能因为参数变化、系统时间异常或网络条件而无法完成连接。此时不要同时修改订阅地址、路由模式、TUN 和 DNS。先保留当前接入方式,换用同一订阅中的另一项配置做一次对照;如果所有配置都在相同阶段失败,再根据错误信息进入新手到进阶手册查找对应章节。

下一步不要只看界面

客户端没有给出启动错误后,立即使用实际浏览器和目标应用进行验证。只有应用请求按预期经过代理,配置流程才算闭环。

步骤四

分别验证浏览器、终端和目标应用

先关闭浏览器中正在加载的旧页面,再新建一个窗口访问平时能够识别网络路径差异的 HTTPS 页面,或直接测试这次需要使用的目标站点。这样可以减少浏览器缓存、已有连接和后台标签页对判断的干扰。如果页面能够按预期打开,再换一个新页面复测,而不是只依据单次加载结果下结论。

浏览器仍未接入时,先检查它是否使用系统代理。多数采用系统网络设置的浏览器会跟随 v2rayN 写入的代理地址,但配置过独立代理、扩展代理或企业策略的浏览器可能采用自己的设置。此时应进入浏览器网络设置,确认它是跟随系统设置,还是指向另一个本地端口。不要同时保留多套互相覆盖的代理设置。

随后验证实际要使用的软件。终端命令和开发工具经常不读取桌面系统代理,有些程序需要单独设置 HTTP、HTTPS 或 SOCKS 代理。应先在 v2rayN 设置中查看当前本地监听类型、地址与端口,再按目标程序支持的格式填写。不要照抄其他设备或旧教程中的端口,因为本地端口可以被用户修改,不同安装和配置也可能采用不同值。

如果浏览器可用而终端不可用,通常说明订阅和内核连接已经具备基础可用性,排查重点应转向终端自身的代理参数,而不是反复更新订阅。如果所有应用都无法使用,则回到客户端查看启动错误、本地监听和当前配置。如果只有某些域名表现不同,再检查路由规则和 DNS;这些情况分别属于应用接入、内核运行和规则匹配三个方向。

01 确认本地服务

客户端已启动,当前配置明确,本地监听没有报错。

02 测试浏览器

新建窗口,并确认浏览器跟随系统代理或使用了正确的独立设置。

03 测试目标应用

检查应用自身代理参数、分应用范围以及是否需要更广的接入方式。

04 再判断路由

只有请求已经进入客户端后,路由规则与 DNS 排查才有实际意义。

完成后的日常操作

更新订阅、切换配置与正确停止

完成首次验证后,日常使用通常只需要三个动作:更新订阅、选择配置、启动或停止客户端。订阅提供方调整配置后,在原有订阅分组执行更新即可,不必重复新建同名分组。更新完成后检查当前选中的配置是否仍然存在;如果旧配置已经被替换,应重新选择列表中的有效配置再启动。

切换配置时,先选中目标条目并让客户端应用变更,再用浏览器做一次简短验证。若只是更换同一订阅中的配置,通常不需要反复修改系统代理,因为应用仍然连接到相同的本地监听入口。只有本地监听地址或端口发生变化时,手动填写代理参数的软件才需要同步调整。

结束使用时,桌面端建议先执行“清除系统代理”,然后再退出 v2rayN。这样可以避免系统继续保留已经没有程序监听的本地代理地址。Android 端直接断开当前连接,并确认系统状态中的 VPN 标识已经结束。下次启动前,如果发现浏览器完全无法连接而客户端又没有运行,首先检查是否遗留了旧的系统代理设置。

到这里,基础配置已经完成。需要继续设置复杂路由、TUN、DNS、端口调整或长期维护时,进入从零到进阶完整手册;不确定 VLESS、Xray、订阅、系统代理等术语时,使用概念速查。继续学习前保留当前可用配置作为基准,每次只改变一个设置,更容易判断变化来自哪里。

基础流程检查结果

订阅列表可更新、当前配置可启动、目标应用明确接入,并且浏览器与实际软件都经过分别验证,即可转入日常使用。

下载客户端