QUICK START / 首次配置

订阅导入与连接验证

v2rayN · v2rayNG 使用教程。按四步完成首次连接,约十分钟走完操作流程;实际用时取决于订阅可用性与设备环境。

  • 01 订阅导入
  • 02 代理模式
  • 03 启动连接
  • 04 请求验证

开始前准备已安装的客户端、正常联网的设备,以及服务提供方给出的订阅地址。客户端负责读取和执行配置,本身不提供可连接的服务器。没有订阅或服务器参数时,先取得这些资料,再继续本教程。

第一步:导入订阅与更新分组

订阅地址是客户端获取服务器配置的入口,不是普通网页地址,也不等于某一条服务器分享链接。先在服务提供方的管理页面找到「订阅地址」或「复制订阅」,完整复制到剪贴板。本文使用 https://example.com/sub?token=xxxx 作为教学示例,这个地址不能用于实际连接。真实地址中的参数通常具有访问权限,不要贴到公开聊天、截图或在线转换页面。

v2rayN:新增分组,再执行更新

打开主窗口,进入「订阅分组」中的「订阅分组设置」,选择新增。备注填写便于辨认的名称,例如「日常订阅」;地址栏粘贴完整订阅链接。检查开头和结尾是否混入空格、换行或中文标点,确认后保存。如果界面同时提供自动更新间隔、过滤条件等选项,首次配置先保留默认值,避免导入时把有效条目过滤掉。

回到主窗口后,在「订阅分组」菜单中执行更新。若存在「不通过代理」和「通过代理」两种更新方式,首次尚未建立可用连接时,先尝试不通过代理更新。等待操作完成,查看底部输出或提示信息,再切换到刚创建的分组。列表中应出现服务器备注、地址、端口或协议等字段。只看到分组名称而没有服务器条目,表示保存地址完成了,但配置还没有成功获取,不能直接进入连接步骤。

v2rayNG:保存订阅,再回主界面刷新

在主界面菜单中打开「订阅分组设置」,点击新增按钮,填写备注和订阅地址后保存。返回主界面,通过菜单执行「更新订阅」;若界面允许按分组更新,选中刚添加的分组再更新。完成后检查配置列表是否新增了条目。此处不要把整个订阅地址粘贴到「从剪贴板导入」的单条配置入口:该入口常用于服务器分享链接,和订阅分组管理不是同一项功能。

如果更新提示失败,先确认设备自身能够联网,再重新从来源页面复制地址。出现认证失败、地址过期或返回内容无法识别时,应核对订阅权限与格式,而不是反复切换服务器。更新成功后,在列表中选一条来源明确的配置,不修改其服务器地址、传输方式和认证参数。首次使用先只处理一个分组、一条配置,后续排查更容易对应。

订阅导入只解决「配置从哪里来」。下一步需要决定应用怎样把请求送进客户端,以及进入客户端的请求怎样分流;这两层设置需要分开看。

第二步:选择代理模式与路由

「系统代理」决定遵循系统设置的应用是否连接本地代理入口;「路由」决定客户端收到连接后使用代理、直连还是阻断。开启系统代理,不代表所有应用都会被接管;选择绕过大陆,也不代表客户端自动修改了系统代理。首次配置保持入口与路由清晰,比同时开启多个功能更容易验证。

v2rayN:自动配置系统代理,保留基础分流

在主窗口底部或托盘右键菜单找到「系统代理」,选择「自动配置系统代理」。这项操作会把系统代理指向客户端的本地监听入口。正常情况下,不需要手动在系统设置中填写远程服务器的地址;远程服务器参数已经由订阅配置提供。操作后检查菜单的当前选中状态,确认不是「清除系统代理」或仅保留既有设置的状态。

接着找到「路由」菜单,初次使用可选择「绕过大陆」。这类规则通常让中国大陆相关目标和局域网目标直连,其余匹配到代理策略的请求交给所选服务器;具体范围以当前客户端的规则内容为准。不要把「全局」理解为提高速度的开关:全局代理是路由选择,会改变请求走向,也可能让原本直连正常的服务绕远。先用默认分流验证成功,需要临时对照时再切换,并在测试后恢复。

本教程暂不启用 TUN。TUN 通过虚拟网络接口处理流量,涉及权限、路由和 DNS,适合在基础连接验证完成后单独配置。如果此前已经启用了 TUN 或其他代理软件,先停止这些功能,避免系统代理和虚拟网卡同时改变请求路径。更多覆盖范围说明见完整手册。

v2rayNG:确认 VPN 模式与路由策略

打开设置,确认当前使用的是 VPN 模式,而不是仅提供本地 SOCKS 入口的代理模式。VPN 模式启动后会通过安卓的 VPN 接口处理流量;仅代理模式则需要其他应用另外指定本地入口,点击连接并不等于其他应用已经配置完成。回到路由相关选项,首次可选择「绕过局域网及大陆地址」一类预设,名称以当前界面显示为准。

如果设置过「分应用代理」,还要检查测试浏览器是否处于处理范围内。包含模式与排除模式方向相反:前者通常只处理选中的应用,后者通常放过选中的应用。首次验证可先关闭自定义分应用限制,让测试路径简单一些;不要在不清楚含义时随意勾选系统组件。私人 DNS、客户端 DNS 和广告过滤等设置先保留原状,每次只改一个变量,后面才能判断是哪项设置影响了结果。

本步结束时,桌面应已选好系统代理与路由,安卓应已确认 VPN 模式与应用范围。此时还不能仅凭设置名称判断连接成功,接下来需要启动所选配置,并检查内核是否真正运行。

第三步:选中服务器并启动连接

回到服务器列表,确认当前分组和配置备注与刚才导入的内容一致。导入订阅不会自动保证某条配置可用,列表高亮也不一定等于已经设为活动服务器。如果客户端同时显示「选中项」与「当前使用项」,以当前使用的标识为准。首次不要一次切换多条配置,先对一条配置完成启动与验证。

v2rayN:确认活动服务器与启动输出

在目标条目上打开右键菜单,选择设为活动服务器的操作;部分界面也可以通过双击条目完成。客户端通常会在切换活动配置后加载内核;若当前界面提供启动或重启服务按钮,按其状态启动一次。观察主窗口底部日志、运行输出或状态区域,确认没有立即退出、配置解析错误或监听失败的提示。将窗口最小化到托盘通常不会停止服务,但直接退出客户端会终止本地代理入口。

如果输出出现端口占用,先检查是否重复启动了客户端,或另一款代理工具正在监听相同端口。优先正常退出重复进程,再重试,不要直接结束无法识别的系统进程。若确实需要更换本地监听端口,应通过客户端设置修改,并重新应用系统代理,使应用端口与实际监听端口保持一致。仅修改一个端口数字而保留旧系统代理,会产生「内核运行但浏览器无法连接」的现象。

v2rayNG:连接按钮与系统授权

点击目标配置,使其成为当前项,再点击主界面的连接按钮。首次使用 VPN 模式时,系统会弹出连接请求,核对发起应用确实是 v2rayNG 后确认授权。没有完成这一步,客户端即使保留了配置,也无法按 VPN 模式接管流量。启动后观察连接按钮的状态变化、前台服务通知,以及系统显示的 VPN 状态;不同设备的提示图标位置可能不同。

如果设备已经由另一款应用建立 VPN,先明确哪一个应用需要保持运行,再停止冲突的连接后重试。系统的始终开启 VPN 或阻止未使用 VPN 的连接等策略,也可能影响切换;首次使用先理解当前策略,不要反复授权却忽略原有连接。运行中若很快断开,打开客户端日志,查看是服务未能启动、配置加载失败,还是连接远端时发生错误。

「内核启动成功」只说明本地配置可以运行,不说明远程服务器一定能访问。相反,单次超时也不能直接证明配置错误,可能涉及当前网络、远端状态或域名解析。记录错误发生的时间与当前配置,再进行下一步实际请求验证;不要把带有订阅地址和认证信息的整段日志公开发送。具体报错含义可到FAQ 与故障排查继续定位。

第四步:验证请求路径与退出恢复

连接图标、系统 VPN 标识和列表中的延迟测试都只能提供部分信息。完整验证需要确认三件事:应用能够发出新请求、请求确实进入预期的客户端入口、路由把请求交给了预期出站。选择允许用于测试且平时可以判断内容是否更新的 HTTPS 网站,新开页面访问;不要只刷新一个已经缓存的静态页面,也不要只看浏览器原有标签页是否仍能显示。

用浏览器请求对照客户端记录

桌面先使用遵循系统代理设置的浏览器测试,临时停用会独立设置代理的扩展,避免扩展覆盖系统设置。安卓则使用处于 VPN 处理范围内的浏览器。打开一个新页面后,切回客户端查看相同时间段的日志或连接信息。如果可以看到目标域名和出站标识,核对该请求按当前规则走的是代理还是直连。绕过大陆模式下,某个网站命中直连是可能的正常结果,不能因为网页打开就推断远程代理已经工作。

如果当前日志级别没有记录访问明细,日志里没有目标域名也不能单独证明请求未进入客户端。可通过客户端提供的连接信息观察;确需临时提高日志详细程度时,完成测试后恢复原设置。访问记录可能含有浏览目标,截取排查信息前应先隐藏个人内容。第三方出口查询页面只能作为辅助对照:某一次查询命中直连规则时,其结果不代表其他应用或其他域名的路径。

按现象缩小范围,不连续改参数

若浏览器完全无法访问,先确认停止代理后原始网络是否正常,再检查系统代理入口和客户端运行状态。若客户端记录了请求却持续超时,优先比较同一订阅中的另一条已知可用配置;若只有域名访问失败而其他连接正常,再考虑 DNS 环节。若浏览器正常而某个独立应用失败,检查该应用是否遵循系统代理、是否自行设置代理,以及安卓分应用规则是否排除了它,不要立即重新安装客户端。

终端工具不一定读取桌面的系统代理,因此浏览器测试成功,并不能说明命令行环境已经生效。本教程不额外修改终端环境变量,也不在首次连接时引入自定义路由。需要覆盖更多应用、设置 TUN 或调整 DNS 时,在基础验证完成后转到从零到精通完整手册,每完成一个改动就重复一次相同请求,保持对照条件一致。

停止连接,检查网络恢复

桌面结束使用时,先在 v2rayN 中选择「清除系统代理」,再正常退出客户端;如果原来有手动设置的企业或局域网代理,应恢复原设置,而不是一律留空。安卓点击连接按钮停止服务,确认前台连接状态已结束。随后新开页面,检查原始网络是否可以正常使用。停止后无法联网时,先检查残留代理设置或系统 VPN 限制,不要急于删除全部订阅。

到这里,订阅来源、流量入口、运行状态和请求路径已分别检查过。需要理解 VMess、VLESS、出站标签等名词时,使用术语手册查询;需要编写规则或建立长期维护流程时,再进入完整手册。本页的配置保持简单,便于下次故障时从同一条路径重新验证。