入门指南 / 首次配置

v2rayN 配置教程

导入订阅 → 选择代理模式 → 启动连接 → 验证生效。已准备好客户端和有效订阅时,可按约十分钟的操作顺序完成首次设置;网络与权限问题需要另行排查。

开始前:客户端与订阅地址

先确认客户端已经安装并能打开。还没有安装包时,前往客户端下载页按系统与处理器架构选择。本文从主界面开始,不要求编辑配置文件,也不要求先启用 TUN。首次使用只走一条最短路径,等网页访问正常后,再考虑应用分流或更复杂的接管方式。

接下来准备服务商提供的订阅地址。订阅可以理解为“配置清单的获取地址”:客户端读取这串网址,才能生成可选择的服务器配置。安装软件本身不会自动提供可用服务。若手里只有单条配置分享链接,应使用客户端的剪贴板导入入口,而不是把它当作订阅地址填入分组。

复制时保留完整内容,尤其注意问号后面的参数。订阅地址可能包含个人访问凭据,不要发到聊天群、公开截图或在线检测页面。下面的示例只用于辨认地址结构,不能用于实际连接。开始前也请退出其他代理或 VPN 工具,避免两个程序同时修改系统设置,让排查结果变得不明确。

不同版本的菜单位置和名称可能略有变化。寻找“订阅分组设置”“更新订阅”“系统代理”等同类功能即可,不必强求每个字都完全相同。如果系统弹出网络或安装权限提示,先核对提示中的应用名称,再决定是否授权。

01 导入订阅:先让配置出现在列表中

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

打开 v2rayN 主窗口,在顶部“订阅分组”菜单中寻找“订阅分组设置”,进入后选择添加。为分组填写一个便于识别的别名,例如“日常订阅”;将完整订阅网址粘贴到“地址”字段。别名只影响本地显示,不会改变服务商提供的配置内容。检查地址前后没有空格或换行后,保存设置并返回主窗口。

保存分组不等于已经拉取配置。回到“订阅分组”菜单,选择更新该分组,或使用“更新订阅”中的对应入口。首次配置通常先尝试不经代理的更新方式,因为当前还未建立可用连接。等待更新结束,主界面的服务器列表应出现来自该分组的配置。若列表里原本已有其他分组,切换到刚添加的分组,避免把旧配置当作新导入结果。

部分版本提供“启用更新”和自动更新间隔。可以先启用更新,并保留默认间隔;它的作用是允许客户端定期重新获取订阅内容,并不是持续检测连接,也不代表客户端会自动选择服务器。完成第一次手动更新后,再根据服务商的更新频率调整即可。

订阅分组设置 · 字段示意
别名:日常订阅
地址:https://example.com/sub?token=xxxx
启用更新:开启
自动更新间隔:保留默认值
白话说明

地址负责“去哪里取配置”,分组负责“把这些配置放在哪一组”。保存只是记住地址,更新才会真正请求内容。即使服务器列表已经出现配置,应用流量也还没有必然进入代理;下一步仍要设置接管方式。示例网址不能连接,请替换为实际收到的完整订阅地址。

v2rayNG:在订阅分组中添加地址

打开 v2rayNG,从主界面菜单进入“订阅分组设置”,点击添加入口。填写备注与订阅地址,保存后返回配置列表,再从菜单执行“更新订阅”。看到列表中出现配置条目,才算完成本步。若只有单条分享链接,使用主界面添加菜单中的“从剪贴板导入”,导入后同样检查配置是否出现在列表。

如果更新失败,先不要反复重装。重新复制一次地址,确认订阅仍有效,再看更新提示属于无法连接、超时,还是内容无法解析。能在浏览器打开某个网页,不代表订阅接口一定能访问;反过来,订阅成功也不保证每条配置都可连接。需要通过已有代理才能更新时,应先有一条可用配置,再选择经代理更新。更详细的判断顺序见帮助中心。

02 选择模式:接管方式与路由分开设置

列表有了配置,接下来要解决两个不同问题:应用是否把连接交给客户端,以及客户端收到连接后如何处理。前者是系统代理或 VPN 接管,后者是路由分流。初次设置先用常见预设,不要同时改 DNS、传输参数和高级路由,否则访问失败时很难知道是哪一项引起的。

v2rayN:自动配置系统代理,配合路由预设

在主窗口底部或托盘图标菜单中找到“系统代理”,选择“自动配置系统代理”。这会让遵循系统代理设置的应用把请求交给客户端。它不是让所有软件都必然经过代理:某些程序有自己的网络设置,或者不使用系统代理,因此需要在后面的验证步骤中按应用分别检查。

再找到“路由”选择入口。日常分流可先选择“绕过大陆”;若当前版本的预设名称不同,阅读对应规则说明后选择用途相近的预设。这个预设通常让匹配中国大陆域名或地址的连接直连,其余连接按规则交给代理,但具体结果仍取决于预设内容、规则顺序以及路由数据文件。不要只凭名称判断某个网站一定走哪条路径。

v2rayNG:使用 VPN 模式,先保留默认设置

在 v2rayNG 设置中确认使用 VPN 模式。它通过安卓提供的 VPN 接口接管符合条件的应用流量,首次启动连接时系统会弹出连接请求。允许后客户端才能建立本地接管接口。这是接管流量所需的系统授权,不是订阅更新的权限。

初次使用先保持应用分流等高级设置的默认值。如果以前配置过仅代理部分应用或绕过部分应用,先检查浏览器是否被排除。路由预设可先采用与桌面端目的相同的分流方案。“绕过局域网”只涉及本地网络地址,不等于绕过所有中国大陆网站;两者匹配的范围不同。暂时不要为了排查而随意开启 Mux 等选项,协议参数保持与导入配置一致。

完成本步后,客户端已经知道怎样接收应用连接、怎样分配连接,但仍需要选择一条实际使用的服务器配置。关于系统代理、VPN、TUN 和路由这些词的区别,可以在术语表中对照阅读;当前先继续启动连接。

03 启动连接:选择配置并检查内核

v2rayN:设为活动服务器

在服务器列表中选择准备使用的一条配置,通过右键菜单中的“设为活动服务器”或同类入口启用。不同版本可能用选中标记或样式变化表示活动项,以实际界面为准。不要只根据鼠标高亮判断:普通选中可能只是准备对这一行执行操作,并不一定已经切换了当前服务器。

v2rayN 通常在活动配置变更后重新加载内核,不一定有单独的“连接”按钮。这里的内核就是实际处理网络请求的后台程序。查看底部日志面板,确认没有持续出现配置解析失败、内核退出或本地监听端口被占用等错误。如果程序未正常运行,应先处理本地错误,再尝试访问网页;反复切换服务器无法解决本机端口冲突。

接着再确认系统代理仍为“自动配置系统代理”。某些设置更改或其他软件启动后,系统代理可能被覆盖。此时不需要重新导入订阅,只要检查活动服务器、内核运行和接管方式这三个环节即可。测试期间一次只更改一项,并记住修改前的状态,便于撤回。

v2rayNG:选中配置,再点击连接

在主界面点选一条配置,使其成为当前使用项,然后点击连接按钮。首次弹出的系统 VPN 请求需要确认;若系统提示已有其他 VPN 正在使用,应先断开原来的连接,再启动 v2rayNG。按钮或系统状态栏变化只能说明本地连接流程已启动,不能单独证明远端服务器已经可用。

如果应用切到后台后连接很快中断,再检查安卓的电池优化和后台运行限制,按需要允许 v2rayNG 后台运行。先在前台完成一次网页验证,再处理后台保活,避免将系统限制与服务器不可达混在一起。遇到握手失败、连接拒绝或超时,可对照日志报错含义与定位方法理解错误指向的环节;具体菜单仍以当前客户端为准。

04 验证生效:网页结果与日志一起看

连接后先打开一个平时能正常访问的网站,并刷新页面,确认基础网络没有因为设置变化而中断。再访问一个按当前路由应由代理处理的网站。最好新开页面测试,不要只看之前已加载的标签页,因为缓存内容和已有连接可能让结果产生误导。

测试时同时观察客户端日志。浏览器开始访问后,如果日志记录了对应目标,说明请求至少已进入客户端;若还能看到出站标签或路由结果,再检查它是直连还是代理。不同版本的日志详细程度不同,看不到目标记录时先检查日志级别,不能直接据此判定客户端失效。分享日志前,遮盖订阅地址、服务器地址和个人凭据信息。

如果正常网页可以打开,预期走代理的网站却失败,先确认当前活动配置,再检查该网站请求是否进入客户端。已进入但连接超时,排查方向偏向服务器可达性或网络路径;出现握手错误,则进一步核对配置是否过期、协议和相关参数是否匹配。未进入客户端时,先查浏览器是否遵循系统代理,或是否被安卓应用分流排除。

看到的现象 下一步检查
订阅更新成功,网页打不开 确认活动配置、内核运行和系统代理;订阅更新只验证了配置获取。
浏览器可用,其他应用不可用 查看该应用是否使用系统代理,或是否被应用分流排除。
请求进入客户端,但连接超时 核对当前服务器是否可用,再检查日志中实际连接的目标。
部分网站显示本地出口 先确认路由是否将其设为直连,不能仅凭出口不同判断失败。

需要确认出口时,可以使用信任的网络信息页面,比较启用前后的出口地址。但出口查询本身也会被分流规则处理,所以查询页显示本地出口,不一定意味着所有代理连接都失败。应先明确这次请求预期走直连还是代理,再把网页结果与日志对应起来。不要将“全部网站都显示同一出口”作为分流模式必须达到的目标。

最后做一次重复验证:关闭测试页面,重新打开并访问同一个目标,确认结果稳定。如果只是单个网站失败,先换另一个同类目标再判断,不要立即重置全部设置。浏览器正常、其他应用仍不正常时,已经可以说明基础连接链路至少部分成立;后续应用接管、TUN 权限和自定义分流属于下一阶段,见全平台安装配置指南。

断开与收尾:恢复原有网络设置

桌面端结束使用时,先在 v2rayN 中选择“清除系统代理”,再退出客户端。如果程序意外关闭后网页突然无法访问,检查系统代理设置是否仍指向已经停止的本地端口。恢复系统代理后再测试普通网页,比立刻删除订阅更有针对性。若启用前使用过单位或其他业务代理,应按原有配置恢复,而不是一律清空。

安卓端点击连接按钮断开,确认系统 VPN 提示相应消失。正常断开不会删除订阅,下次打开仍可选择原有配置。以后出现连接问题时,优先按“订阅能否更新 → 配置是否选中 → 接管是否开启 → 日志是否报错”的顺序检查,不要一开始就改动所有设置。

至此,首次配置只需要保留已经验证有效的分组、活动配置和路由预设。日常使用先沿用这套设置;涉及协议差异看术语表,遇到具体故障看帮助中心,需要逐平台安装、权限与高级配置说明时再阅读全平台指南。