快速上手 · 四步配置

v2rayN 配置教程
与 v2rayNG 订阅导入

按“导入订阅 → 选择代理模式 → 连接 → 验证是否生效”的顺序操作。已安装客户端、持有可用订阅时,可按约十分钟的基础配置流程开始;网络异常需要单独排查。

开始前,先从安装包页面选择适合设备的客户端并完成安装,再准备订阅提供方给出的完整地址。订阅地址可能包含访问凭据,应保存在受控位置,不要贴入公开截图、在线转换页面或求助内容。本站提供客户端说明,不提供订阅或服务器;安装完成本身并不会生成可连接的配置。

01 导入订阅与活动服务器

订阅是一组服务器配置的更新入口,不是某一台服务器的连接按钮。第一次配置需要完成两件事:先把订阅内容写进客户端,再从更新得到的服务器列表中选择一个活动条目。只有分组名称出现在界面中、但列表仍为空,通常表示只保存了订阅地址,还没有执行更新。

v2rayN:保存分组,再更新订阅

打开 v2rayN 主窗口,进入“订阅分组”相关菜单,找到“订阅分组设置”,添加一个分组。备注填容易辨认的名称,地址栏粘贴完整订阅链接。检查开头和结尾是否带入空格、换行或聊天消息的标点,再保存。不要把订阅链接粘到服务器的地址、端口等单节点字段中;这些字段并不负责解析订阅内容。

返回主窗口,从订阅分组菜单执行更新。初次配置尚未建立可用代理时,如果菜单同时提供普通更新和通过代理更新,先使用不依赖现有代理的更新方式。更新完成后切换到刚创建的分组,查看服务器列表是否出现条目。选中准备使用的一项,通过右键菜单中的“设为活动服务器”或当前版本对应操作激活它,以活动标记或状态栏显示为准;不要仅凭鼠标高亮判断已经切换成功。

v2rayNG:添加订阅分组并刷新列表

打开 v2rayNG,点右上角菜单进入“订阅分组设置”,使用添加入口填写备注和订阅地址,保存后返回主界面。再打开菜单执行更新订阅;若界面区分是否通过代理更新,首次使用也先选择不依赖现有代理的方式。等待更新结束,确认配置列表已出现条目,再点选其中一个作为当前配置。订阅刷新与连接是两个独立动作,这一步暂时不必启动 VPN。

如果提供方交付的是单个分享链接而非订阅地址,应使用“从剪贴板导入”一类入口;二维码则使用客户端的扫描入口。导入后出现一条配置属于正常情况,但它不一定具备后续订阅更新能力。先确认交付内容是哪一种,再决定使用分组更新还是单条导入,避免把相同配置重复添加多次。

此时应能看到服务器条目,并明确当前激活的是哪一项。先保持同一个条目进入下一步;在接入方式尚未确定前反复切换服务器,会把订阅、路由和网络问题混在一起。需要理解订阅生成配置与内核字段的关系时,可继续阅读配置字段参考。

02 选择代理模式与路由规则

代理模式先决定应用怎样把流量交给客户端,路由规则再决定已进入内核的流量走哪个出口。这两层不能互相替代:系统代理开启后,不读取系统代理设置的应用仍可能直连;路由选择“全局”也不代表设备上的每一个程序都会自动接入。第一次配置先使用较少的接管选项,得到可复现结果后再增加复杂功能。

v2rayN:先用系统代理接入浏览器

在主窗口或托盘菜单找到“系统代理”入口,准备连接时选择“自动配置系统代理”或当前版本中含义相同的选项。它会将系统代理指向客户端的本地监听地址。若浏览器装有独立代理扩展,先暂停该扩展或设置为跟随系统;若浏览器自身手工填写了其他代理地址,也应先恢复到系统设置,避免请求被送往另一个端口。

随后检查路由选择。日常使用可先选与实际需求一致的分流规则,并记住当前规则名称;需要定位某个目标为何直连时,再临时使用让已接入流量统一走代理的规则进行对照。不同版本的规则名称与默认规则集可能不同,不能只根据名称猜测内容。“全局代理”用于缩小排查范围,不应被当成所有应用已被接管的证明。

首次验证不必同时开启 TUN。系统代理足以用于检查通常遵循系统设置的浏览器,TUN 则涉及虚拟网卡、权限、DNS 与系统路由。把两种方式一起改动,会增加判断成本。确实有应用不遵循系统代理时,先完成本教程的连接验证,再去配置字段参考了解相关接入与路由设置。

v2rayNG:使用 VPN 模式,暂不筛选应用

在 v2rayNG 设置中检查运行模式,基础上手使用 VPN 模式。它通过安卓系统提供的 VPN 接口接收流量,并不表示另行购买了某种服务。若选择“仅代理”,客户端主要提供本地代理入口,其他应用不会因此自动使用它;除非已明确知道如何为目标应用设置代理,否则首次使用先保留 VPN 模式。

接着打开路由设置,选择符合需求的规则,并暂时保持分应用代理关闭。若之前已经设置过应用名单,确认是“仅代理所选应用”还是“绕过所选应用”,两者作用相反。测试用的浏览器若被排除,即使连接图标正常也不会得到预期结果。此阶段保持一个活动配置、一套明确的路由规则,下一步才能据此判断连接状态。

03 启动连接与检查日志

现在已经有活动服务器,也确定了应用接入方式。启动前先退出其他正在接管系统代理或占用 VPN 接口的工具,保留必要的系统安全设置。多个客户端同时改写代理,可能出现一个程序显示运行、实际请求却进入另一个程序的情况。不要在此时同时修改端口、协议参数和 DNS,先让现有配置完整启动一次。

v2rayN:确认内核运行,再开启系统代理

v2rayN 通常会在启动或切换活动服务器后加载内核,并不一定存在独立的“连接”按钮。回到主窗口确认活动条目,查看底部日志是否报告配置解析失败或内核退出;如果版本提供重启内核入口,可以在选定条目后执行一次。随后按上一步开启系统代理,检查托盘菜单中的当前状态。只看到窗口打开,不足以判断内核已经正常监听。

若日志提示本地监听端口被占用,先检查是否启动了第二份客户端或其他代理工具。优先关闭重复实例,再重新启动内核;不要一边保留冲突程序,一边随意换端口。确需修改本地端口时,系统代理与手动设置了代理的应用都要指向新的监听端口。内核能启动但应用仍访问旧端口,表现会与远端连接失败很相似。

v2rayNG:点连接并确认系统授权

回到 v2rayNG 主界面,确认当前选中的配置,点击连接按钮。首次运行 VPN 模式时,安卓会显示 VPN 连接请求;确认请求来自刚打开的客户端后允许建立连接。授权被取消时,列表中的服务器配置仍然存在,但系统没有开始把应用流量交给它,需要再次点连接并处理授权,而不是重新导入订阅。

连接后查看客户端运行状态和系统的 VPN 指示。系统通常只允许一个活动的 VPN 服务;若另一个应用抢占了该接口,先停止冲突服务,再回到 v2rayNG 重新连接。设备上的工作资料或管理策略也可能限制授权,这类限制应从系统设置确认,不宜通过反复修改服务器字段处理。

如果前台连接正常,切到后台后才容易中断,再检查安卓对客户端的电池优化与后台运行限制。先按需允许后台运行,并观察问题能否复现,不必一开始修改全部电量设置。运行图标只说明本地接入已建立,仍不能证明远端服务器可达;下一步需要用实际请求和日志共同确认。

04 验证是否生效与定位异常

验证的目标是确认“指定应用的指定请求,按预期进入客户端并使用相应出口”,而不是只看连接按钮变色。先确认设备原有网络正常,再测试需要经过代理的目标。选一个已知可访问、由本人信任的目标页面,打开新标签发起新请求;已经加载好的页面可能来自缓存,不能作为刚建立连接的证据。

先看请求,再对照路由

桌面端用跟随系统代理的浏览器打开目标,同时观察 v2rayN 日志。若使用安卓端,确保测试浏览器没有被分应用规则排除,再观察 v2rayNG 的连接或日志信息。默认日志等级未必记录每条成功请求,因此“没有新增日志”不能单独判定客户端未接管;必要时临时增加日志详细程度,完成测试后恢复原设置,避免长期记录过多访问内容。

在分流模式下,普通网站被规则判定为直连是正常结果。需要验证代理出口时,应测试预期匹配代理规则的目标,或短时间切换到让已接入请求走代理的规则再对照。若对照规则可以访问、原规则不行,优先检查规则命中与 DNS 配合;若两者都失败,再检查活动服务器及远端可达性。不要把直连成功误认为代理成功,也不要把正常分流误认为连接失效。

用断开与重连做一次对照

记录当前模式后,暂时停止连接或关闭系统代理,再重新请求相同目标;恢复连接后重复测试。对照结果需要结合目标本身的网络条件判断:某些目标在直连和代理下都能访问,因此两次都成功并不说明客户端没有工作。出口地址查询也只能作为辅助信息,分流、浏览器缓存和目标选取都会影响结果,应优先看应用设置与路由是否一致。

连接后完全打不开网页时,按“本地接入 → 活动配置 → 远端连接”的顺序回查。桌面端先确认内核仍运行、系统代理端口与监听端口一致;安卓端先确认 VPN 服务仍在、测试应用属于接管范围。然后检查是否确实激活了订阅中的条目,最后依据日志区分超时、名称解析或安全握手错误。证书相关错误应先核对系统时间和配置来源,不应通过关闭验证绕过。

一次只改一个设置

若只有某个应用失败,先检查该应用是否有独立代理设置或被排除在接管范围外;若同一服务器在不同应用都失败,再换一个确认有效的条目测试。记录每次只改了什么,例如切换服务器或调整路由,不要同时重装客户端、改 DNS 和开关 TUN。单一变量的结果才便于判断是哪一层出了问题。

完成后,应能说明当前活动服务器、接入模式、路由规则以及测试结果。保存这组可用设置,再考虑订阅自动更新、分应用代理或更细的路由。系统代理方式退出 v2rayN 前,先清除客户端设置的系统代理;安卓端不用时可在客户端停止 VPN 连接。这样下次启动时,也能从明确状态继续排查,而不是继承上次残留的代理设置。

基础配置完成后的阅读顺序

需要理解 inbounds、outbounds、routing 与 DNS 如何衔接,阅读配置字段参考。不确定桌面端与安卓端客户端的适用范围,可看客户端对比。更换设备时,从安装包页面重新确认系统和处理器架构,不要直接沿用其他设备的安装文件。