使用文档 / 首次连接

v2rayN 订阅导入与代理设置

导入订阅 → 选择模式 → 启动连接 → 验证生效。

选择客户端下载

本页从客户端已经安装、手边已有有效订阅地址开始,适合按顺序完成一次约十分钟的基础配置;实际耗时取决于订阅服务和网络情况。客户端负责读取节点参数并建立连接,订阅地址与可用节点需要另行准备。只有安装软件,没有订阅或节点参数,无法直接完成连接。

开始前,先退出其他正在接管网络的代理工具,保留当前可用的网络连接。暂时不要同时修改 DNS、内核和自定义路由,这样出现问题时容易定位。尚未安装客户端,可先去下载页选择对应系统;涉及安装权限、系统要求或多设备配置的完整说明,放在全平台安装配置文档中。

一、导入订阅并更新节点

先从订阅提供方复制完整订阅地址。它通常是一条以 https:// 开头的链接,可能包含用于识别账户的路径或查询参数。复制时不要多带空格、换行或聊天软件附加的标点,也不要只复制链接的显示文字。订阅地址可能具有访问账户节点的能力,不要发到公开讨论区,也不要在排查截图中保留完整地址。

打开 v2rayN,在订阅相关菜单中进入“订阅分组设置”,选择新增分组。先在备注里填一个便于识别的名称,再把地址粘贴到订阅地址字段。备注只用于区分分组,不影响连接;地址才决定从哪里获取节点。确认分组处于启用状态后保存,再返回主窗口。不同版本的菜单位置可能略有变化,操作目标都是先建立分组,再获取该分组内容。

保存后,分组已经存在,但列表不一定立即出现节点。继续打开订阅菜单,执行更新当前订阅分组;如果界面只有更新全部订阅的入口,也可以使用它。观察底部状态或日志,等待这次更新结束。首次配置时,若菜单区分通过代理更新与不通过代理更新,应先使用当前网络能完成的方式;没有可用连接时,不要把更新依赖设置成尚未启动的代理。

更新完成后,切换到刚建立的分组,检查主列表是否出现服务器名称、地址或协议类型等字段。看到分组名称并不等于订阅已更新成功,看到节点列表才说明客户端至少获得并识别了内容。此时先不要逐个改节点参数,也不要马上开启 TUN。后续只需要从列表选一个节点,建立一条可以验证的基础连接。

如果使用 v2rayNG,打开主界面右上角菜单,进入“订阅分组设置”,点击新增入口,填写备注和订阅地址后保存。然后返回主界面,在菜单中执行更新订阅,等待节点列表刷新。只在分组设置中保存地址而不更新,主界面可能仍然是空列表。若已有多个订阅,先切换到本次新增的分组,避免把旧节点误认为新地址返回的结果。

若拿到的是 vless:// 或 vmess:// 开头的单条分享链接,应使用从剪贴板导入配置的入口,而不是把它填成远程订阅地址。分享链接一般只描述一个节点,远程订阅则用于后续批量更新。网页中的说明文字、登录页面地址和原生 JSON 配置也不一定能当作订阅导入,不能只凭链接能够打开就判断格式正确。

列表仍为空时,先核对地址是否完整、订阅是否有效,再查看更新日志中的网络请求或解析提示。不要反复删除整个客户端配置来重试。更新失败与节点连接失败是两个阶段的问题:前者尚未拿到配置,后者已经拿到配置但无法建立连接。格式识别和空列表的进一步排查可查看常见问题。确认至少有一个节点后,进入下一步选择流量模式。

二、选择系统代理与路由模式

在 v2rayN 中,先把两个设置分开理解:系统代理决定哪些应用会把请求交给客户端,路由模式决定客户端收到请求后选择直连还是代理。它们不是同一个开关。“自动配置系统代理”不会自动表示所有目标都走代理,“全局”路由也不会自动接管不读取系统代理的应用。先确认入口,再确认去向,后续验证才有明确依据。

Mac 初次配置建议先保持 TUN 关闭,使用系统代理完成浏览器测试。在客户端的系统代理菜单中找到“自动配置系统代理”,等下一步确认内核运行后再启用。这个选项会将本地代理信息写入系统网络设置,供遵循这些设置的应用使用。首次操作若弹出系统权限提示,应核对提示来源与请求内容,再按系统界面完成授权。

同一菜单中的“不改变系统代理”表示客户端不主动修改现有设置,不等于清除已经留下的代理地址。如果之前已经开启过系统代理,切换到这一项后,系统里可能仍保留原来的地址。“清除系统代理”才是撤销相应系统代理设置的入口。结束使用时也应记住这一区别,避免内核已经停止、浏览器却仍向本地端口发送请求。

接下来找到路由设置或主界面的路由预设。日常测试可以先选择“绕过大陆”,让命中相关直连规则的目标直接连接,其余流量按照预设处理。具体结果受规则数据库和规则顺序影响,并不是按网页显示语言判断。若选择全局代理,则进入客户端的流量通常按该预设统一交给代理出站;它适合做针对性对照,但不保证一定更快。

第一次操作不要自行新增一长串分流规则。保留客户端提供的预设,记下当前选择,稍后用不同目标验证。否则某个目标无法访问时,很难分辨是节点、DNS 还是自定义规则导致。规则优先级、GeoIP 与 GeoSite 的写法属于进一步配置,基础连接通过后再去完整文档展开调整。

安卓端在 v2rayNG 的设置或路由相关入口中确认当前模式。首次测试先不启用复杂的分应用排除规则,避免待测试的浏览器恰好被排除。v2rayNG 启动连接时,通过系统 VPN 接口接管符合设置的流量;这里的系统 VPN 授权不是订阅提供方的账户登录,也不需要把订阅地址填进系统自带的 VPN 配置页面。

TUN 用于接管更多不遵循系统代理的流量,但还会涉及虚拟网络接口、路由和 DNS。不要把它当成“连接失败时再开一个开关”的补救办法。先按系统代理方案完成一次验证,只有明确发现某个应用不走系统代理、并且确实需要覆盖它时,再单独配置 TUN。现在保留所选路由模式,继续选择节点并启动连接。

三、选择节点并启动连接

回到 v2rayN 主列表,找到订阅更新得到的一个节点。选中该行后,通过右键菜单或界面提供的入口将它设为活动服务器;部分版本也支持双击完成选择。不要仅凭鼠标选中行的底色判断已经切换成功,应再查看活动标记或当前服务器提示。列表里有多个节点,也不代表客户端会同时使用它们。

首次连接优先选择订阅提供方说明可用、参数完整的节点,不必先进行全列表测速。客户端显示的延迟测试与真实网页请求不是同一种测试,能够得到延迟结果也不能证明全部网站都可访问。先用一个节点完成完整流程,可以减少批量测试带来的额外请求,也便于对照后续日志。

确认活动服务器后,查看内核状态或日志。v2rayN 在启用配置时会启动或重载内核,不同版本的启动入口与状态展示可能不同。若日志出现配置解析错误、内核退出或本地监听端口被占用,先处理这些错误,不要继续反复切换路由。只有内核正常运行,本地代理入口才有服务可以响应。

接着在系统代理菜单中选择“自动配置系统代理”。Mac 上可在系统设置的网络服务中找到代理相关项目,核对所用网络服务是否已写入本地代理地址;不必为了核对而手动改端口。以客户端实际监听设置为准,不要从其他教程照抄端口号。如果刚换过 Wi-Fi、使用有线网络或接入了其他网络服务,也应留意当前生效的是哪项网络设置。

v2rayNG 的操作是先点击节点,将它设为当前配置,再点击主界面的连接按钮。首次启动会出现系统 VPN 连接请求,确认后返回客户端,观察连接状态与系统状态栏提示。若系统中已有其他 VPN 连接,新的连接可能替换原连接;在继续之前应确认是否需要保留原有工作网络。没有完成系统授权,单纯选中节点不会开始接管流量。

启动后保持客户端运行。桌面端关闭主窗口可能只是收起到托盘,也可能受退出设置影响;安卓端切到后台后,系统的电池与后台限制也可能影响持续运行。首次验证先不要清理后台或强制结束应用。若连接刚启动就中断,先检查是否被系统停止,再判断节点问题,避免把后台限制误当作服务器故障。

如果日志显示握手、认证或超时错误,先检查设备日期与时间是否准确,再尝试同一订阅里的另一个节点。不要随意改 UUID、传输类型、REALITY 参数或服务器名称,这些字段需要与服务端一致。错误持续出现时,保留错误类型和发生步骤,到故障排查说明查找对应处理方法;分享日志前应去除订阅地址和账户相关参数。

四、验证浏览器与应用是否生效

客户端显示运行中,只说明本地服务或流量接管已经启动,并不直接证明目标应用使用了它。先打开平时使用的浏览器,新建标签页,访问一个原本就能正常访问的页面,确认基础网络没有被破坏。然后打开本次希望通过代理访问的目标页面,并重新加载。不要只看连接前已经打开的页面,缓存可能让失败的连接看起来仍然可用。

浏览器操作与客户端日志应结合观察。若客户端提供访问日志,可以在发起请求时检查是否出现目标域名或对应连接,以及所用出站。日志详细程度因配置而异,没有显示域名不能单独证明请求未经过客户端。节点延迟、内核运行标记和网站出口地址也都只是不同层面的线索,应以实际目标请求能否完成为主要结果。

选择“绕过大陆”时,应分别测试预期直连的目标与预期代理的目标。直连页面正常,并不能证明代理出站可用;某个代理页面正常,也不能证明其他规则全部正确。必要时暂时切换到全局代理,对同一目标重复测试,再恢复原来的路由预设。如果只有某种路由下失败,下一步应查匹配规则,而不是立即重装客户端。

如果要查看出口地址,应在待测试的同一个浏览器里使用可信的出口查询页面,并结合路由判断。分流模式下,查询页面自身可能走直连,所以显示本地出口并不必然意味着代理失效。不要为了得到某个地址结果而不断更换节点。真正需要验证的是目标应用的请求是否按预期进入客户端,再从正确的出站发送。

当浏览器已经可用、其他应用仍然失败时,先检查该应用是否读取系统代理,是否设置了独立代理,以及是否有旧地址或旧端口残留。部分命令行程序和开发工具不会自动采用桌面系统代理。此时不要直接判定节点不可用,也不要无目的地切换内核。可以先在应用内配置兼容的代理入口;确实需要更广的流量接管时,再按完整文档中的 TUN 配置说明处理。

如果所有目标都打不开,先清除系统代理或停止安卓端连接,确认基础网络是否恢复。基础网络正常后,再依次检查订阅是否更新、节点是否活动、内核是否运行、系统代理是否写入。每次只改变一个条件,再重复相同的页面测试。这样能区分入口问题、节点问题与路由问题,比同时开启 TUN、改 DNS、换协议更容易找到原因。

确认连接成功后,保留当前可用的节点和路由设置,再考虑自动更新订阅或其他偏好。结束使用时,桌面端先执行清除系统代理,再按需要停止内核或退出客户端;若启用了 TUN,也要先关闭其流量接管。安卓端点击停止连接,确认系统 VPN 状态已经结束。最后重新加载普通网页,确认退出后的网络仍正常,这才算完成一次完整配置与恢复流程。