入门指南 / 首次配置

v2rayN 配置教程
订阅导入与连接验证

按“导入订阅 → 选择代理模式 → 连接 → 验证”完成一次基本配置。预留约 10 分钟;先让浏览器访问正常,再考虑 TUN 与自定义规则。

开始前,先从下载中心选择适合设备的客户端并打开主界面。还需要一份有权使用、尚未失效的订阅地址或单条分享链接。客户端负责读取配置和建立连接,安装完成后不会自动生成可用服务器;本站也不提供订阅地址。

本页只覆盖第一次连接。遇到持续报错,保留报错原文后转到问题诊断,不必在第一次配置时同时调整 DNS、内核和传输参数。

步骤 01 / 先让服务器列表出现记录

导入订阅

先分清拿到的内容是什么。订阅地址通常是一个可以更新多条配置的链接;单条分享链接则常以协议名称开头,只对应一条服务器配置。两者的导入入口不同。复制时尽量使用来源页面的复制按钮,不要把说明文字、换行或末尾标点一起选中。如果内容来自二维码,确认它属于订阅还是单条配置,再选择对应的扫描入口。

在 v2rayN 主界面打开“订阅分组”,进入“订阅分组设置”,新建一条记录。在备注中填写方便辨认的名称,例如“日常订阅”,把完整订阅地址粘贴到地址栏。第一次配置通常不必指定额外的订阅转换或更新代理,保持默认即可。检查地址是否被截断,然后保存并关闭设置窗口。此时只完成了地址登记,服务器列表尚未出现内容是正常的。

v2rayN · 订阅操作路径

订阅分组 → 订阅分组设置 → 新建 → 保存

返回主界面,选择刚保存的分组,再执行“更新当前订阅”。首次尚未建立连接时,优先尝试菜单中的“不通过代理”更新方式。

更新后留意底部信息区或日志提示,再检查主界面的分组筛选。如果提示更新完成但列表为空,先切换到刚才创建的分组,清除搜索条件,避免只是被筛选隐藏。正常情况下会出现服务器记录,通常能看到备注、协议、地址等字段。记录是否出现和连接是否可用是两件事,本步骤只确认订阅内容已被客户端识别。

在 v2rayNG 中,打开侧边菜单里的“订阅分组设置”,点击添加按钮,填写备注与订阅地址并保存。回到主界面,通过更多菜单执行“更新订阅”,再查看对应分组。若得到的是单条分享链接,复制完整内容后使用主界面菜单中的“从剪贴板导入”,不要把单条链接硬填进订阅地址栏。桌面端也有从剪贴板导入的服务器菜单入口。

如果更新失败,先看提示属于“请求地址失败”还是“内容无法解析”。前者需要检查地址有效期、当前网络能否访问订阅地址;后者则要确认复制的不是普通说明网页或登录页面。没有现成可用连接时,选择“通过代理更新”未必能解决问题,因为更新本身也在依赖尚未建立的连接。需要切换网络时只做一次对照,不要反复新建同一个分组。

订阅地址可能包含个人访问凭据,不要把完整地址发到公开评论或截图里。请先保留本地记录,分享问题时遮住地址中的识别信息。关于订阅与单条配置的区别,可查看名词解释;关于空列表和更新失败,可查看FAQ 的安装配置问题。确认列表已有记录后,再进入代理模式设置,不必先把所有服务器都测速一遍。

步骤 02 / 区分应用接入与路由出站

选择代理模式

服务器列表准备好以后,先决定应用怎样把请求交给客户端。对桌面浏览器的首次测试,最容易观察的起点是“自动配置系统代理”。在 v2rayN 主界面的系统代理菜单或托盘菜单中选择该项,保持客户端运行。它会写入当前系统的代理设置,让遵循系统代理的应用使用客户端的本地监听入口,并不意味着每个应用的所有连接都会被接管。

同一菜单中的“清除系统代理”用于移除系统代理设置;“不改变系统代理”则是不主动修改现有设置,并不等同于关闭代理。如果之前使用过别的代理程序,先退出其他程序,避免它们反复覆盖系统设置。浏览器内若启用了独立代理扩展,也先暂停扩展,测试时只保留一条明确的接入路径。

路由设置:先选绕过大陆

接着检查 v2rayN 的路由选择,第一次可使用内置“绕过大陆”规则。系统代理回答“应用是否把请求交过来”,路由回答“收到请求后选择哪个出站”。绕过大陆通常让匹配中国大陆域名或 IP 规则的连接直连,其余连接按规则交给代理;具体结果仍以当前客户端规则集和匹配顺序为准。不要把系统代理模式与路由模式当成同一个开关。

初次使用保留内置规则即可,不需要同时编辑 geosite、geoip 或自定义 DNS。切到全局代理也不能修复失效服务器,它只改变路由选择。只有当基本连接已经正常、某个网站的去向不符合预期时,再对照日志研究规则。如果不确定 direct、proxy 等名词,先看路由与分流术语,详细匹配问题留到问题诊断中处理。

TUN 模式:首次验证先关闭

TUN 通过虚拟网络接口接管流量,适用于不遵循系统代理的应用,但它也引入权限、虚拟接口和网络路由等额外条件。第一次只验证浏览器时,先保持 v2rayN 的 TUN 开关关闭。这样出现问题时,能先把范围限定在订阅、活动服务器和系统代理上,不会混入虚拟接口是否创建成功的问题。

等后面的浏览器验证通过,再按需求启用 TUN,并根据系统提示授予必要权限。启用后需要重新验证,而不是仅凭开关亮起就判断成功。已有其他 VPN 或虚拟网络工具运行时,先确认它们是否会争用网络路由;不确定就暂时断开其他工具,再单独测试。权限报错应按原文处理,不要靠连续切换开关碰运气。

v2rayNG 的基本接入方式是安卓系统提供的 VPN 服务,不需要寻找桌面端的“自动配置系统代理”。首次保留默认的应用接管范围与路由设置,先不要排除正在测试的浏览器。应用级绕过列表会使部分应用不进入客户端,容易被误认为连接没有生效。至此只完成了接入方式的选择,下一步还要明确哪条服务器负责实际连接。

步骤 03 / 设为活动服务器后观察启动

选择服务器并启动连接

回到 v2rayN 主界面,在刚更新的分组里选一条确定仍有效的服务器。通过右键菜单的“设为活动服务器”或对应的激活操作,让这条记录成为当前使用项。单击一行有时只是在列表中选中它,不一定已经切换活动服务器;需要观察活动标记或状态区是否随之改变。不要仅凭行的高亮背景判断。

v2rayN 通常会在应用活动配置后启动或重载内核,并不像安卓界面那样始终提供一个显眼的连接按钮。因此,完成激活以后,应打开主界面日志或信息区,确认没有紧接着出现启动失败。上一部选择的“自动配置系统代理”仍需保持生效,客户端窗口可以最小化,但不要退出进程。

看到内核启动信息只说明本地程序开始工作,还不能证明远端服务器可用。有些连接在浏览器真正发出请求时才建立,主界面暂时没有流量也不一定是故障。如果日志明确出现端口占用、权限不足或配置解析失败,应先停在这里处理本地启动问题;反复更换服务器无法解决一个已经被其他程序占用的监听端口。

如果订阅里有多条配置,可以先选择一条服务方标明有效的记录,再进行一次真连接测试。测试超时只说明本次探测没有完成,可能涉及探测目标、当前网络或服务器本身,不宜只看一个数值就下结论。第一次连接的目标是确认实际网页访问,而不是挑选一条看起来延迟最低的记录。

在 v2rayNG 主界面点击要使用的服务器,再点击连接按钮。首次启动会弹出安卓系统的 VPN 连接请求,核对发起应用后确认。返回客户端,观察连接按钮或状态提示是否进入运行状态。如果之前已有其他 VPN 连接,系统可能要求替换当前连接;确认后再测试,避免以为两个应用可以同时接管同一条系统 VPN 通道。

连接按钮刚开启就立即恢复停止状态时,先打开 v2rayNG 的日志,记录最靠近启动时刻的错误。若只在切到后台后断开,再查看系统对该应用的后台运行和电池限制。先完成前台访问测试,再调整后台保活,能区分“连接从未成功”与“后台被系统中止”这两种不同情况。

现在保持当前服务器不变,转到浏览器做下一步验证。若需要向他人描述问题,可以记录“订阅已导入、活动服务器已切换、内核是否启动、系统代理或 VPN 是否开启”四项状态。不要分享原始配置全文,尤其是其中的地址、用户标识和密码字段;日志也应先遮住个人信息。

步骤 04 / 用实际访问建立判断

验证是否生效

先打开浏览器,确认没有独立代理扩展覆盖系统设置。选择一个已知可用、确实需要通过当前代理访问的页面,使用新标签页重新加载,不要只看已经缓存的旧页面。随后再打开一个平常直接访问正常的页面,观察两者是否都能完成加载。前者检查代理路径,后者检查日常访问是否受到意外影响。

如果使用“绕过大陆”路由,普通直连页面能够打开,并不能单独证明代理已经工作,因为这部分连接本来就可能绕过代理。反过来,浏览器显示某个页面失败,也不能直接认定整个客户端失效,还可能是该目标站点临时不可用。用两个不同的已知可用目标做对照,比反复刷新同一个地址更有判断价值。

验证时同时查看客户端日志。请求时间与日志时间相近、出现对应目标或出站记录,可以帮助判断请求是否进入客户端;不同内核和日志级别显示的细节不同,没有逐条访问日志也不必马上提高到最详细级别。优先观察是否出现明确错误,并把它与刚才的页面访问对应起来,不要把很早以前的一条错误当成当前故障。

按现象选择下一次检查
观察到的现象 先检查哪里 下一次操作
浏览器访问失败,客户端没有相关请求迹象 系统代理、浏览器扩展、安卓应用绕过列表 先确认浏览器是否进入客户端
有请求记录,但连接反复超时 当前服务器有效性与网络可达性 只更换一条已知有效的服务器再试
浏览器正常,某个应用仍失败 应用是否遵循系统代理或被排除 确认应用接入方式后再考虑 TUN
启动时立即报错,尚未发起网页访问 本地端口、权限与配置字段 先处理启动错误,再重复访问测试

如果需要做一次关闭对照,桌面端先选择“清除系统代理”,再在浏览器新标签页访问同一目标;安卓端则在 v2rayNG 中断开连接后再试。完成对照后恢复原来的设置。浏览器可能保留已有连接,页面也可能命中缓存,因此一次关闭后仍可打开页面并不一定代表代理从未参与,必要时关闭浏览器再重新打开测试。

浏览器已经正常、只有某个桌面应用无法访问时,不要重新导入订阅。先检查该应用是否有自己的代理设置,是否遵循系统代理,再判断是否需要 TUN。安卓端则先确认该应用没有被放进绕过列表。只有基础接入路径确定以后,才值得继续研究 DNS 或规则匹配,否则容易在错误层面修改参数。

若两类页面都能正常加载,且客户端没有持续启动或连接错误,就可以保留当前配置作为基线。记下订阅分组、活动服务器和路由名称即可,不需要把整份配置复制到其他地方。日后调整一项功能时,先验证同样的两个页面;出现异常就恢复上一项设置,能更快缩小变化范围。

结束使用时,桌面端先清除系统代理,再退出客户端,避免系统继续指向已经停止的本地端口。使用过 TUN 时也先关闭 TUN,并确认系统网络恢复正常;安卓端在 v2rayNG 中点击断开即可。如果退出后网页仍全部失败,先检查系统是否残留代理设置,而不是立即删除订阅或重装软件。

返回订阅导入步骤 ↑