QUICKSTART / 首次配置

v2rayN 订阅导入与连接设置

按顺序完成导入订阅、选择代理模式、连接与验证。先建立一条可复查的连接路径,再调整分流和 TUN 设置。

开始前,需要已安装的客户端,以及有权使用的订阅地址或单条分享链接。客户端本身不会提供服务器。尚未安装时,先到客户端下载页选择对应安装方式;只有服务器参数、没有订阅地址时,也可以从分享链接导入,不必先创建订阅分组。

首次操作建议关闭其他正在接管流量的代理连接,保持网络能够正常访问普通网页。本文只完成基础连接,不要求修改原生配置文件。订阅地址可能包含访问授权信息,复制时不要把地址贴到公开页面,截图时也应避开完整链接和账户字段。

STEP 01 / 配置来源

导入订阅。先确认列表内容。

先区分拿到的是哪一种内容。订阅地址通常是供客户端获取一组服务器配置的链接;单条分享链接一般以 vmess://、vless://、trojan:// 或 ss:// 开头。两者使用不同的导入入口。不要因为链接很长就认定它是订阅,也不要把账户管理页面的地址当作订阅地址。

在 v2rayN 主窗口打开“订阅分组”,进入“订阅分组设置”,选择新增分组。为分组填写一个容易识别的备注,把订阅地址完整粘贴到地址输入框,再保存。备注只是本地标识,不会改变服务器参数。粘贴后检查地址前后是否多了空格或换行,尤其不要把说明文字一起复制进去。

保存分组并不等于已经取得服务器配置。回到主窗口,在“订阅分组”菜单中执行更新订阅;初次没有可用代理时,优先使用菜单里不经代理更新的入口。等待操作结束,观察日志或提示,再查看列表是否出现协议、地址等服务器条目。如果界面有分组筛选,切换到刚创建的分组,避免因为仍停留在其他分组而误以为导入失败。

如果拿到的是单条分享链接,复制完整链接后,在“服务器”菜单选择“从剪贴板导入分享链接”。导入完成后检查新增条目的协议类型和地址是否符合预期。不要自行改动链接内的编码内容;遇到无法识别的格式,先向配置提供方确认客户端兼容性,而不是反复更换链接开头。

在 v2rayNG 中,打开菜单里的“订阅分组设置”,使用新增入口填写备注与订阅地址并保存,再回到服务器列表,通过菜单执行更新订阅。单条链接则从主界面的添加菜单选择剪贴板导入。安卓系统可能提示应用读取剪贴板,这是导入动作的一部分;导入完成后仍要确认列表确实新增了条目。

列表为空时,先查看更新结果,而不是立即调整路由。地址不可访问、订阅内容为空、返回了网页而非配置,都会使导入无法完成。若当前网络无法直接取得订阅,需要先使用已有的有效配置建立连接,再尝试经代理更新;没有已有配置时,应向提供方确认可用的获取方式。

看到服务器条目只说明配置已进入客户端,并不代表服务器可连接。此时不必逐项编辑高级字段,先保留原始参数,进入下一步选择接管流量的方式。订阅更新与分享链接的更多区别,可查阅常见问题中的安装配置说明。

订阅分组设置 更新订阅 从剪贴板导入分享链接

STEP 02 / 流量入口

选择代理模式。区分接管与分流。

配置已经导入,接下来要决定应用如何把流量交给客户端。这里有两个不同层次:系统代理或 TUN 决定流量怎样进入内核,路由规则决定进入内核以后走哪个出站。开启系统代理不意味着所有应用都会使用它,选择某个路由预设也不等于已经启动连接。

桌面首次测试可以从系统代理开始,先保持“启用 Tun 模式”关闭。在主窗口底部或托盘图标的“系统代理”菜单中,找到“自动配置系统代理”。这个选项用于让客户端把本机代理监听地址写入系统代理设置,供遵循这些设置的应用使用。如果内核尚未启动,部分应用可能暂时无法访问网络,因此选好模式后应继续完成下一步,而不是停在这里判断连接结果。

随后检查“路由”入口。若客户端提供“绕过大陆”预设,可以将它作为常规浏览场景的起点;它会根据当前规则数据决定哪些请求直连、哪些请求代理。预设名称相同,也不保证不同版本的规则内容完全一致。验证时要选择按当前规则应走代理的目标,不能仅凭一个直连网站能够打开就认定代理已生效。

系统代理适合先验证浏览器访问链路。某些应用拥有独立的代理设置,或者不读取系统设置,它们的行为可能与浏览器不同。遇到这种情况,先查看该应用自身的网络选项,不要为了让单个应用工作就同时开启多个接管方式。基础连接确认后,再按实际需求考虑 TUN 和分应用设置。

在 v2rayNG 中,不需要寻找桌面端的“自动配置系统代理”按钮。它通常借助安卓的 VPN 接口接管流量,启动时由系统请求授权。连接前进入设置检查路由选项;如果已经启用了分应用代理,要确认用于测试的浏览器在接管范围内,并分清列表表示“仅代理所选应用”还是“绕过所选应用”。两种列表语义相反,不能只看是否勾选。

如果此前使用过自定义规则,首次排查可以先记录原设置,再恢复到能够理解的预设。不要一次修改 DNS、路由、传输参数和接管方式,否则失败时无法判断是哪一项造成变化。有关 TUN 权限、系统代理作用范围以及规则匹配顺序的深入解释,留到基础验证后阅读协议与内核参考即可。

本步完成时,应能明确说出两件事:待测试的应用通过哪个入口交给客户端,以及测试目标按哪套路由处理。保持这两个条件不变,下一步只选择服务器并观察内核启动结果。

STEP 03 / 内核启动

连接服务器。查看活动项与日志。

回到 v2rayN 服务器列表,选择一条配置完整的条目。右键打开菜单,使用“设为活动服务器”将其设为当前连接配置。部分版本也提供快捷键或双击操作,但首次使用以菜单为准,避免把普通选中误认为已经切换。操作后查看列表里的活动标记及底部状态,确认当前使用的是预期条目。

v2rayN 通常在设定活动服务器后加载相应配置并启动或重启内核,不一定存在单独的“连接”大按钮。打开主窗口的日志显示区域,观察本次操作之后的新消息。重点看是否出现配置加载失败、端口占用或内核无法启动等错误;如果有,应先处理启动错误,而不是在浏览器中持续刷新。

若提示本地端口被占用,可能是客户端重复运行,也可能是其他程序正在监听相同端口。先检查托盘和任务栏,退出重复实例,再重新启动当前客户端。确需更改监听端口时,应同时确认系统代理指向新的端口。本文不要求固定填写某个端口值,应以当前客户端设置和状态栏显示为准。

确认内核启动后,回看“系统代理”是否仍为“自动配置系统代理”,以及路由是否保持上一步的选择。切换活动服务器通常不需要重新导入订阅。若必须重启客户端才能继续,重启后也要复查这两个状态,不要假设上一次选择一定已恢复。

在 v2rayNG 中,先点选服务器条目,确认活动项标记移动到目标,再点击主界面的启动按钮。首次启动会弹出安卓系统的 VPN 连接请求,核对应用名称后允许。系统一般只保留一个活动的 VPN 连接;若另一应用仍在运行,需要先停止它,再启动当前连接。

启动后,v2rayNG 的按钮状态和系统连接标识应发生变化。它们表示本地服务和接管接口处于运行状态,不足以单独证明远端服务器能正常转发请求。若按钮很快恢复为停止状态,查看客户端日志,区分授权被拒绝、配置无法加载与服务启动失败,再决定下一项操作。

客户端提供的 Tcping 或类似测试主要反映目标端口的可达情况,并不覆盖完整的代理握手与目标访问。“真连接延迟测试”更接近一次实际代理请求,但结果仍受测试地址和路由影响。首次可以用它辅助筛查,不必围绕一个延迟数字反复切换;真正的完成条件是下一步能够通过预期应用访问目标。

设为活动服务器 内核日志 系统代理状态 真连接延迟测试

STEP 04 / 访问验证

验证是否生效。从应用回查连接路径。

保持客户端运行,打开浏览器的新标签页,访问一个已知可用、且按当前路由应由代理出站处理的 HTTPS 页面。尽量使用平时能确认内容正常更新的页面,不要仅观察已打开标签页的缓存。等待页面实际加载文字或其他资源,再回到客户端查看这段时间的日志。

一次有效验证需要同时考虑三个条件:内核已启动、浏览器确实把请求交给客户端、目标命中了预期出站。只看到客户端运行图标,或只看到某个普通网站能够访问,都不能覆盖全部条件。若日志级别和界面支持连接记录,可以结合目标域名与出站标记判断;没有显示详细记录时,也不要将“日志没有变化”直接等同于未产生流量。

桌面端先检查系统网络设置中的代理地址和端口,确认与客户端当前的本地监听一致。浏览器若安装了单独控制代理的扩展,应检查其模式是否覆盖系统设置。先让浏览器使用系统代理再重试同一目标,不要在扩展、系统和客户端三处同时填写互不一致的代理地址。

安卓端先确认 v2rayNG 仍在运行,系统 VPN 连接没有被另一应用替换,再检查测试浏览器是否处于分应用代理的接管范围内。如果切到后台后连接才中断,可以检查系统针对该应用的电池与后台运行限制。是否需要放宽限制取决于设备实际行为,不必在首次启动前批量关闭系统管理选项。

页面无法打开时,按“本地启动、应用接管、服务器连接、目标访问”的顺序回查。先看有无启动错误,再确认系统代理或 VPN 状态,然后对当前活动服务器执行真连接测试。若只有一个目标失败,尝试另一个同样应走代理的已知可用目标;若所有目标都失败,再检查服务器参数和网络连通性。不要把单个站点的响应问题直接判断为整个客户端故障。

如果日志明确出现名称解析或证书相关错误,应先保留错误原文并确认发生时间。证书错误需要检查设备时间与配置中的服务器名称,不应通过关闭验证来绕过。解析问题也不要立即靠改成某个固定 IP 处理,因为这可能同时改变 TLS 和路由行为。具体错误的后续处理可转到常见问题与故障排查,本页保持基础设置不变。

需要换服务器对照时,只更改活动服务器,保留浏览器、接管模式、路由与测试目标。完成一次测试后再比较结果。这样才能判断差异来自服务器还是本地设置。若同时更换多个条件,即使访问恢复,也难以复现原因,后续遇到相同问题仍需从头检查。

确认访问符合预期后,可以关闭测试标签页,保留当前分组和模式。日后订阅内容更新,通过原分组执行更新即可,不必每次删除重建。桌面端准备退出客户端时,先选择“清除系统代理”,确认普通网络访问恢复,再退出程序;安卓端使用停止按钮结束连接,并确认系统连接标识消失。