使用文档 · 四步配置

v2rayNG 订阅导入
与代理模式配置

从保存订阅地址开始,依次完成模式选择、连接和验证。已安装客户端且订阅有效时,可按约十分钟的上手流程操作;网络或配置异常需另行排查。

开始前,先确认客户端能够正常打开,设备本身可以联网,并准备好服务提供方给出的有效订阅地址。尚未安装时,先到客户端下载页选择对应系统的安装格式,再回到这里继续。客户端负责读取配置和建立连接,不会因安装完成而自动生成可用订阅。

订阅地址通常带有账号专属参数,应像密码一样保管。不要把完整地址发到公开讨论区,也不要把包含地址的设置截图直接分享。本文不要求修改服务端字段;只要按菜单保存已有订阅、采用默认设置并逐步验证即可。若手中只有单条分享链接,可在下文按剪贴板导入处理。

步骤一

导入订阅并更新列表

完成标志:主界面出现订阅分组中的配置条目,而不只是保存了一条地址。

打开订阅分组设置

在 v2rayNG 主界面打开侧边菜单,找到“订阅分组设置”,点击新增按钮。先在“备注”中填入便于识别的名称,例如“日常配置”;再把订阅地址完整粘贴到“可选地址 (url)”或对应的地址输入框。不同版本可能调整字段名称,但需要填写的仍是分组备注与订阅地址,不是单个服务器的域名。

粘贴后先看一遍地址的开头和结尾。聊天工具可能把末尾标点一并复制,换行或空格也可能混入地址。保留服务提供方给出的完整参数,不要自行删去问号后的内容。若分组里有“启用更新”选项,保持开启,再点击保存。此时只完成了地址登记,服务器列表尚未必发生变化。

返回主界面执行更新订阅

返回主界面,打开右上角更多菜单,选择“更新订阅”或相近名称的更新入口。部分版本会区分常规更新与通过代理更新:首次尚未建立连接时,先用不依赖当前代理的更新方式。等待操作完成后,切换到刚才创建的分组,确认列表中出现配置条目。看到更新成功提示但列表为空时,也要确认没有停留在另一个分组或筛选结果中。

如果更新失败,先用普通网络确认设备可以联网,再回到分组设置检查地址是否完整、是否仍在有效期内。若订阅地址本身只有通过已有代理才能访问,需要先有一条可用配置,才能使用通过代理更新的方式;反复点击更新不会解决这个依赖关系。不要把订阅返回的错误页面当成配置手动粘贴。

区分订阅地址与单条分享链接

以 vmess://、vless://、trojan:// 或 ss:// 开头的内容通常是单条分享链接。复制完整链接后,在主界面新增菜单中选择从剪贴板导入,而不是把它填进订阅分组的地址栏。单条导入不会自动获得订阅更新能力;后续字段变更时,需要重新导入或按提供方说明调整。

v2rayN 桌面操作:打开顶部“订阅分组”相关菜单,进入分组设置并新增记录,填入备注和订阅地址后保存。随后在订阅菜单执行更新,回到服务器列表查看结果。桌面端同样需要区分保存地址与拉取配置这两个动作。若列表已出现条目,先不要逐项编辑端口、传输方式或安全选项,下一步只处理本机代理模式。

订阅、节点与分享链接的区别可在名词解释中查看。遇到地址失效或返回格式不兼容,转到常见问题继续排查;本教程以列表已经成功载入为后续操作起点。

步骤二

选择代理接管方式与路由

先让待测试应用的请求进入客户端,再决定哪些请求需要代理。

安卓先使用 VPN 模式

打开 v2rayNG 设置,找到运行模式或 VPN 相关设置。常规上手选择“VPN”模式,而不是“仅代理”。VPN 模式通过 Android 提供的系统接口接收流量,适合直接测试浏览器和常用应用;仅代理模式通常只提供本地代理监听入口,需要应用另行指定代理地址,不能把它理解成自动接管所有应用。

首次验证时,先关闭“分应用代理”,避免浏览器刚好被排除在接管范围外。这里关闭的是分应用筛选功能,不是关闭代理本身。如果以前使用过绕行模式,也先恢复到不按应用筛选的状态,等连接确认正常后再添加应用规则。已有其他 VPN 服务运行时,应先停止,再启动 v2rayNG,以免系统切换 VPN 服务造成判断混乱。

路由先选常规预设

接着打开路由设置,选择客户端提供的常规预设,例如绕过局域网地址。这样访问路由器、打印设备等本地资源时,通常可以保留直接连接路径。路由规则决定请求去向,VPN 模式决定流量如何进入客户端,两者不是二选一。不要因为选择了 VPN 就推断每个地址都会经远端出口。

域名策略可先保留默认值,不必为了完成连接而改动 AsIs、IPIfNonMatch 或 IPOnDemand。也不要同时导入多套路由规则、添加自定义 DNS 并开启额外过滤功能。保留较少变量,后面出现问题时才能知道是订阅、接管方式还是路由造成的差异。

桌面先使用系统代理

v2rayN 桌面操作:先保留常规路由预设,完成下一步内核启动后,再从主界面底部或托盘菜单选择自动配置系统代理的选项。系统代理是向遵循该设置的应用提供代理入口,并不保证所有程序都会使用它。首次配置暂不启用 TUN,先用浏览器建立一个能够验证的基础状态。

若后续确实需要接管不读取系统代理的应用,再按新手到进阶手册中的相关章节了解 TUN、权限和路由安排。不要在同一次尝试里同时开启系统代理、TUN 与手动应用代理;这些入口叠加会让请求路径更难判断。保存好本步设置后,回到服务器列表选择一条配置。

步骤三

选择配置并启动连接

完成标志:客户端服务启动,安卓系统确认 VPN 已建立;随后仍需验证实际访问。

选中条目,再确认系统授权

在 v2rayNG 主界面点选准备使用的配置,确认该条目呈现当前选中状态。长按往往用于多选或管理,不一定等于设为活动配置,因此要以界面中的选中标记为准。接着点击主界面的启动按钮。首次使用 VPN 模式时,Android 会弹出连接请求,提示该应用将建立 VPN 连接;确认应用名称后允许即可。

授权完成后,观察启动按钮和客户端状态提示是否改变,并查看系统通知或 VPN 标识。不同系统版本的显示位置不同,也可能将运行通知收进通知面板。系统 VPN 标识只说明本机接管接口已经建立,不代表远端配置一定可用,更不能替代下一步的网页访问测试。

启动失败先看日志

如果点击后立即停止,或出现内核启动失败提示,打开客户端菜单中的日志入口,优先看本次启动时间附近的第一条相关错误。配置解析错误、监听地址冲突和连接被拒绝属于不同问题,处理方式也不同。先记录错误类别,再决定是否换配置;不要看到失败就重新安装客户端,否则原本有用的现场信息可能丢失。

若日志提到 TLS 证书或握手异常,先检查手机日期、时间与时区是否正确,再核对订阅是否已经更新。不要直接关闭证书验证来掩盖问题。分享日志求助前,删去完整订阅地址、账号标识和认证字段,只保留错误类型及必要上下文。更完整的日志处理路线可查看故障排查相关问答。

保持前台完成首次测试

连接启动后,先保持客户端运行,切到浏览器完成下一步验证,不要马上清理后台。若仅在锁屏一段时间后断开,再到 Android 应用信息中检查电池限制和后台运行权限,按系统实际选项调整。先确认前台状态能够稳定使用,再处理后台保活,避免把远端连接问题误判成电池设置问题。

v2rayN 桌面操作:在服务器列表中把目标条目设为活动服务器,观察状态区或日志,确认内核没有立即退出,然后设置系统代理。部分版本在选择配置后会自动重启内核,无需反复操作。测试期间保留托盘进程;关闭窗口可能只是最小化到托盘,退出程序则会停止服务,两者要分清。

步骤四

验证访问与退出后的网络

依次检查普通网页、目标地址与实际应用,避免只凭状态图标判断成功。

先测网页,再测使用中的应用

打开浏览器,先访问一个已知正常的 HTTPS 页面,确认设备仍具备基础联网能力;再访问需要通过代理连接的目标地址。测试时尽量打开新页面或刷新内容,避免缓存让旧页面看起来仍然可用。一个网页能够打开,只能说明这一次请求成功,不等于所有域名和应用都走了相同路径。

随后打开真正准备使用的应用,执行一次需要联网的操作。如果浏览器正常而某个应用失败,先回查分应用代理是否仍有筛选,再看该应用是否使用独立的代理、DNS 或特殊网络连接。桌面端尤其要注意:有些程序不读取系统代理。浏览器成功但此类程序失败时,应先确认接管范围,而不是立即认定订阅失效。

把出口与日志作为辅助证据

如需确认某个网页是否经远端出口,可用可信的公网地址查询方式,比较连接前后的结果,并结合路由设置判断。启用了分流时,查询页面可能本来就走直连,因此出口没有变化不一定表示客户端未工作。相反,出口变化也只证明当前查询请求的路径,不能据此推断其他应用的请求全部已被接管。

回到客户端查看测试时间附近的日志。若当前日志级别能显示访问记录,可用目标域名和路由结果辅助判断;若只有错误日志,没有访问记录本身并不等于没有流量。不必长期提高日志详细程度,完成定位后恢复常规设置,减少敏感连接信息的留存。

按现象一次只改一个选项

如果所有页面都打不开,先停止客户端,看普通网络是否恢复。停止后仍无法联网,应先处理设备网络;停止后恢复,则回到刚才的配置和模式检查。如果只有一条配置无法使用,可以在同一订阅分组中切换另一条,再按相同步骤重测。切换前记住原选项,每次只改变一项,才便于比较结果。

如果只有个别域名失败,再检查路由规则和 DNS 相关设置,不要同时修改域名策略、远端地址及证书参数。客户端内的连接测试可用于辅助筛选,但其测试目标和真实应用不同,显示成功并不保证目标服务可用。关于 DNS、路由匹配与传输协议的细节,继续阅读名词解释,无需在首次上手时逐个调整。

停止服务并确认恢复

测试结束后,安卓端回到 v2rayNG 点击停止,确认系统 VPN 状态随之解除。桌面端先清除由 v2rayN 设置的系统代理,再退出客户端;如果原来已有自定义代理,恢复原值。退出后再打开一个普通网页,确认没有因为残留代理指向已停止的本地服务而断网。

至此,订阅已载入、模式已选定、连接已启动,并且实际访问经过验证。日常使用通常只需按需启动、在提供方变更配置后更新订阅,以及在异常时查看日志。需要分应用管理、更细的路由或 TUN 配置时,再进入新手到进阶手册逐章设置;遇到单个故障则直接查阅常见问题,不必从头重复全部步骤。

返回订阅导入步骤