快速上手 / 首次连接

v2rayN 配置教程:
从订阅导入到连接验证

按四步完成一次可验证的连接。先使用默认路由与基础接管方式,确认能够访问后,再调整 TUN、分应用代理与自定义规则。

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

尚未安装客户端时,先到安装包页面选择适合设备系统与处理器架构的安装包。桌面端完成安装或解压后,从正式保存的位置启动 v2rayN,不要直接在压缩包预览中运行。安卓端安装 v2rayNG 后打开主界面即可,首次连接前不需要手动填写本地代理端口。

接下来准备一条有效的订阅地址,或服务提供方给出的服务器分享链接。客户端用于读取配置和转发流量,安装完成并不代表已经具备可用服务器。订阅地址通常能返回一组服务器配置;单条分享链接只包含一个条目的连接参数,两种内容的导入入口可能不同。先确认拿到的是哪一种,再继续下一步。

订阅地址可能包含访问凭据。复制时保留完整内容,不要附带聊天消息中的引号、说明文字或换行,也不要将地址发送到公开讨论区。操作前暂时退出其他正在接管网络的代理或 VPN 工具,避免多个程序同时修改系统设置。以下流程以已获得订阅地址为主线;没有订阅时,不要随意填写陌生网站提供的地址。

一、导入订阅并更新列表

v2rayN:先保存分组,再获取配置

在 v2rayN 主窗口中打开“订阅分组”相关菜单,进入“订阅分组设置”,新增一个分组。在备注或名称栏填写便于识别的名称,例如“日常连接”;在订阅地址栏粘贴完整地址。其余选项先保留默认值,确认地址开头、结尾没有多余空格后保存。此时只是保存了订阅来源,服务器列表还没有内容属于正常现象。

回到主窗口,打开订阅菜单,执行更新当前订阅或更新全部订阅。首次尚未建立可用代理时,优先使用菜单中的不通过代理更新选项,具体名称以当前版本为准。等待操作结束,查看主界面底部的信息或日志区域。成功后应能在对应分组中看到服务器条目及协议等信息。切换到刚保存的分组,避免因仍停留在其他筛选范围而误以为导入失败。

v2rayNG:保存后返回主界面更新

在 v2rayNG 右上角菜单中打开“订阅分组设置”,点击添加入口,填写备注与地址后保存,再返回服务器列表。随后在菜单中执行更新订阅。如果保存后没有立即出现条目,先检查是否真正执行了更新,而不是反复新建同一分组。更新完成后,列表应显示可供选择的服务器;点选条目时会出现选中标记或高亮状态。

如果拿到的是单条分享链接,可先完整复制,再在客户端中选择从剪贴板导入的入口。不要把服务器分享链接误填到需要拉取远程内容的订阅地址栏。两类内容都可能是一长串文字,但导入逻辑不同;导入后的条目是否与提供方说明一致,比链接外观更有参考价值。

看到服务器列表后,订阅导入这一步才算完成。暂时不要批量修改协议参数或进行内核切换,下一步先决定设备上的应用通过什么方式把请求交给客户端。

二、选择代理模式与默认路由

桌面端先用系统代理

在 v2rayN 托盘图标的菜单或主界面的系统代理入口中,选择“自动配置系统代理”。它会把操作系统的相关代理设置指向客户端的本地监听地址,适合先用遵循系统代理设置的浏览器验证。设置完成后客户端仍需保持运行;系统代理不是独立连接服务,关闭客户端后留下的本地代理设置可能使浏览器无法联网。

菜单中的“清除系统代理”用于移除系统代理设置;“不改变系统代理”表示客户端不主动改动现有设置,并不等于已经恢复直连。如果此前设置过代理,准备重新验证时可以先清除,再选择自动配置。不同桌面系统对设置变更可能显示权限提示,应确认提示来自当前客户端及系统设置流程。

首次配置先不要开启 TUN。系统代理只影响愿意读取该设置的应用,TUN 则通过虚拟网络接口接管更广的流量,可能涉及额外权限、路由与 DNS 行为。二者不是连接质量的高低档位。只有在浏览器验证已经成功、且确实有应用不读取系统代理时,再参考系统代理与 TUN 的常见问题判断是否需要切换。

安卓端确认 VPN 模式与路由范围

v2rayNG 通常通过安卓系统的 VPN 接口接管应用流量。在设置中确认使用的是 VPN 模式;首次连接时,系统会弹出连接请求,阅读提示后确认授权。这里的 VPN 是本机流量接管方式,不代表订阅中的协议发生变化。如果设备已有另一项 VPN 连接,先停止原连接,再启动 v2rayNG,避免相互替换后误判为客户端自行断开。

首次测试建议先保留默认的应用接管范围,不急于配置分应用代理。若此前已经修改过,请检查待测试的浏览器是否被排除。分应用设置可能采用“仅代理所选应用”或“绕过所选应用”等不同语义,选中列表并不总表示这些应用会走代理,必须一起阅读模式说明。

接管方式确定后,再查看路由设置。系统代理或 VPN 决定流量如何进入客户端,路由决定进入后的请求使用直连、代理还是阻断出站。首次使用保留默认路由即可,不必为了验证而把所有流量改成全局代理。默认路由内容会随版本与已有设置变化,需要精细调整时再阅读配置大全中的路由规则。接下来选择一个服务器,确认内核能够实际启动。

三、选中服务器并启动连接

选中条目不等于连接已经成功

在 v2rayN 服务器列表中选择一个条目,通过右键菜单将其设为活动服务器;部分版本也支持双击完成选择。以当前服务器标记、状态栏或日志提示为准,不要仅凭鼠标停留位置判断。切换活动服务器通常会触发内核重载,等待相关操作完成,再开始网页测试,避免在切换过程中连续更换多个条目。

检查主窗口的信息或日志区域,确认没有持续出现内核启动失败、监听端口被占用或配置解析失败。v2rayN 部分版本在选定服务器后便会启动或重载内核,不一定提供单独的“连接”按钮。看到本地监听或内核运行相关信息,说明本机服务已启动,但仍不能据此断定远端服务器可达,最后还需要真实访问验证。

在 v2rayNG 中,先点选准备使用的服务器,再点击主界面的连接按钮。首次使用按系统提示授予 VPN 连接权限,随后查看按钮状态及系统 VPN 标识。若按下按钮后立即恢复为停止状态,打开客户端日志查看启动错误;如果 VPN 标识存在但网页无法打开,则继续检查服务器可达性、路由与 DNS,而不是重复申请授权。

失败时每次只改一个条件

本地端口被占用时,先退出可能使用同一端口的其他客户端,再重试。不要一边更换端口,一边切换内核和服务器,否则恢复连接后也难以确认原因。某些订阅依赖特定协议或传输能力,随意修改内核可能使原本有效的配置不兼容;先保留导入结果与默认内核选择,必要时向提供方确认要求。

如果本地服务已启动,但请求一直超时,先开启系统自动日期与时间,确认设备时间正确,再换一个订阅内的服务器进行对照。延迟测试可以辅助筛选,但测试成功不等于浏览器、DNS 与所有应用都已配置正确;测试失败也可能与测试目标或测试方式有关。不要只凭一个数字下结论,保留错误类型,按故障排查说明继续定位。

当客户端保持运行、所选服务器明确且没有反复启动错误时,进入下一步。此时先固定这些条件,不再改动配置,用实际请求检查整条路径。

四、验证网页访问与流量接管

用新请求验证,不只看连接图标

打开一个新的浏览器页面,访问平时熟悉的 HTTPS 网站,并刷新一次。优先选择内容能够正常加载、响应结果容易辨认的页面,不要只观察此前已经打开的网页;旧页面可能来自缓存。若浏览器安装了单独控制代理的扩展,先确认它使用系统设置,避免扩展覆盖系统代理,让本次测试绕过客户端。

随后打开客户端日志,再发起一次页面请求。如果当前日志级别会记录访问事件,可以根据目标域名、连接结果和出站信息判断请求是否进入客户端。不同版本的日志详细程度不同,没有逐条访问记录不必然代表未接管;应结合日志级别、系统代理状态和页面结果判断,不要为寻找一条记录就盲目修改路由。

如果页面能打开但仍不确定是否经过代理,可以临时清除桌面系统代理或停止安卓连接,再用新请求进行对照,完成后恢复连接。注意直连本来就能访问的页面,在停止代理后仍可打开,这是正常结果。对照应选择按当前规则预期走代理的目标,并结合日志观察,不能仅凭“能否打开网站”推断所有流量路径。

分流环境分别检查直连与代理目标

使用默认分流时,一部分请求直连,另一部分才通过服务器。若用出口地址查询页面辅助判断,显示的地址只说明该次请求采用的出口,并不证明其他域名或全部应用也使用同一路径。想确认某个应用的行为,应在该应用中发起请求,并检查它是否读取系统代理、是否处于安卓接管范围,以及对应路由如何匹配。

出现“部分网站正常、部分网站失败”时,先记录失败域名、错误信息及发生时的路由模式。连接超时、域名解析失败与证书警告不是同一类问题。遇到证书警告不要关闭验证或忽略提示来强行完成测试;检查系统时间、访问地址与网络环境后,再到疑难解答按症状处理。规则字段、DNS 配置与出站标签的细节留到配置大全继续阅读。

退出与后续设置

桌面端结束使用时,先在 v2rayN 中选择“清除系统代理”,再退出客户端。如果已经启用 TUN,也应先停止相应模式。关闭主窗口有时只是将程序收进托盘,不代表已经退出;需要结束运行时使用客户端菜单中的退出入口。安卓端则先点击停止连接,确认系统 VPN 标识消失,再关闭应用界面。

如果退出后浏览器突然无法访问网络,先检查系统中是否仍保留指向本机的代理设置,而不是立即重装客户端。重新打开 v2rayN 清除系统代理,或到系统网络设置中核对相关选项。若设备处于单位或受管理网络,不要删除原有的组织代理配置,应先确认其用途。

完成一次连接后,记录本次可用的服务器、接管方式与路由模式即可,不要保存或公开包含凭据的截图。之后需要更新订阅时,直接更新已有分组;需要解决具体错误时前往疑难解答;需要理解配置字段与自定义路由时前往配置大全。保持一次只调整一项设置,验证结果会更容易复现。

下载v2rayN