v2rayN · v2rayNG 配置步骤

V2Ray 使用教程
订阅导入与连接验证

安装完成后,按“导入订阅 → 选择代理模式 → 连接 → 验证”操作。已备好有效订阅地址时,可将这四步作为约十分钟的初次配置流程;遇到报错先停在当前步骤检查,不必同时调整所有设置。

操作前:确认客户端与订阅地址

先安装适合设备的客户端,再进行下文操作。桌面设备使用 v2rayN,安卓设备使用 v2rayNG;安装入口见客户端页面。打开软件后,应能看到服务器列表或空白主界面。若软件尚未正常启动,应先处理运行环境、目录权限或安装问题,而不是反复修改订阅地址。

订阅地址需要从可信的服务提供方取得。客户端负责读取配置并建立连接,安装客户端本身不会自动生成可用服务器。订阅链接通常是完整的网址,分享链接则可能以 vless:// 或 vmess:// 开头。两者入口不同:前者适合填入订阅分组,后者通常通过剪贴板导入单个服务器。先辨认内容,再选择导入方式。

复制地址时保留完整路径和查询参数,不要带入前后的空格、换行或说明文字。订阅地址可能包含账户凭据,不应发到公开讨论区,也不要在截图中保留完整地址。接下来先导入一个分组和一个服务器,完成验证后再添加其他分组,便于定位问题。

第一步:导入订阅

v2rayN:添加订阅分组并更新

在 v2rayN 顶部找到“订阅分组”菜单,进入“订阅分组设置”,新增一条分组。为分组填写便于识别的名称,再把完整订阅地址粘贴到地址字段。名称只用于本地整理,不会改变服务器连接参数。初次配置先保留其他选项默认值,保存后回到主界面。

从订阅菜单执行更新操作,选择刚添加的分组,或使用更新全部订阅的入口。软件会请求订阅地址并解析其中的服务器条目;等待操作结束后,切换到对应分组查看列表。正常结果是出现服务器名称、协议和地址等信息,而不是只看到一个分组名称。添加分组只是保存地址,执行更新才会取得服务器配置。

第一次更新通常先尝试“不通过代理”一类的更新入口。只有已有可用代理连接,且订阅地址确实需要通过该连接访问时,再尝试经代理更新。尚未取得任何可用服务器时反复切换“通过代理更新”,容易形成依赖循环。出现超时应先确认基础网络与地址可访问性,出现解析错误则检查复制内容是否确实为客户端支持的订阅。

v2rayNG:从侧栏添加订阅

打开 v2rayNG 侧栏,进入“订阅分组设置”,点击添加入口。填写备注与订阅地址后保存,再返回主界面,从右上角菜单执行“更新订阅”一类操作。若当前版本区分当前分组和全部分组,先更新新建的分组。更新完成后,应能在主界面看到导入的服务器卡片;若列表启用了分组筛选,还需切到正确分组。

如果取得的是单条分享链接,而不是订阅网址,可先复制链接,再使用主界面的添加入口选择“从剪贴板导入”。这种方式保存的是当前这一条配置,不等同于建立可自动刷新的订阅分组。服务端参数后续变化时,可能需要重新导入;不要把分享链接直接当作订阅网址填写。

本步完成标志是目标分组中已有可选服务器。此时不要立即修改传输、安全或身份字段。订阅已经包含这些参数,随意改动可能造成不匹配。订阅与分享格式的区别见订阅术语说明;若更新失败,可继续阅读订阅更新失败排查。列表正常后,再进入流量接入设置。

第二步:选择代理模式

先区分两个问题:应用流量怎样进入客户端,以及进入后由哪条路由处理。“系统代理”与“TUN 模式”主要涉及流量入口;“全局”“绕过局域网”等路由选项决定匹配后的去向。路由选择为全局,不代表所有应用都会自动遵循系统代理。初次使用先建立简单、可验证的路径,不同时启用多个接管方式。

v2rayN:先使用系统代理

在桌面端找到“系统代理”菜单,部分版本也可从托盘图标的右键菜单进入。准备启动连接时选择“自动配置系统代理”或当前版本对应的开启选项。这个操作会把系统代理指向本机客户端监听端口。随后先用遵循系统代理设置的普通浏览器测试,不要把游戏、命令行程序或有独立代理设置的应用作为第一次验证对象。

接着查看“路由”或“路由设置”,从现有预置方案开始。日常使用可选择符合需求的绕过局域网等方案;为判断某个访问问题是否来自分流,也可临时切换全局代理路由进行对照,测试结束后恢复。预置方案名称与具体规则会随版本变化,不要只凭名称判断所有域名的实际去向。

此阶段保持 TUN 关闭。TUN 适合进一步处理不遵循系统代理的流量,但涉及虚拟网卡、权限与对应内核配置,不是首次连接必须开启的项目。若后续确实需要,先读TUN 模式配置范围;关于规则匹配顺序,另见路由配置参考。

v2rayNG:检查 VPN 与分应用范围

安卓端通常由客户端建立本地 VPN 服务承接流量。进入设置查看路由选项,先采用默认或已有的常用预置方案。如果此前配置过“分应用代理”,检查测试用浏览器是否被排除。初次验证可先关闭分应用限制,确认基本连接正常后,再逐项设定哪些应用参与代理。

安卓系统 VPN 服务与桌面系统代理不是同一个入口,不需要照搬桌面端的端口设置到手机无线网络代理中。如果设备上还有其他使用 VPN 服务的应用,先停止它们,避免同时争用系统连接。完成这些检查后,流量路径已明确:下一步只需选定服务器并启动客户端连接。

第三步:选择服务器并连接

v2rayN:设置活动服务器

回到 v2rayN 主列表,选中准备使用的服务器,通过右键菜单的“设为活动服务器”或当前版本对应操作启用它。有些版本也支持双击设置活动项。关键不是鼠标是否停在这一行,而是界面是否显示该条目已经成为活动服务器。随后确认系统代理处于开启状态;选择服务器和接入系统流量是两个独立操作。

查看底部日志区域或日志入口。内核应正常启动,不应持续出现端口占用、配置解析失败等错误。若提示监听端口被占用,先检查是否同时运行了另一份客户端;关闭重复进程后再试。不要在应用、客户端和系统三处随意填写不同端口,否则即使内核启动成功,应用请求也可能无法进入。

若日志显示连接失败,先确认活动服务器属于刚更新的分组,再尝试同一订阅中的另一条配置。切换后重新发起一次访问,观察新日志。服务器列表中的延迟测试可以辅助选择,但测试成功只说明对应测试路径有响应,不等于浏览器已经使用该服务器;测试失败也可能受到测试地址或测试方式影响。

v2rayNG:启动并确认系统授权

在 v2rayNG 主界面点击目标服务器条目,确认选中标记已移动到该条目,再点击连接按钮。首次启动时,安卓系统会弹出 VPN 连接请求,核对发起应用后确认。若拒绝了这次授权,客户端不能通过系统 VPN 服务承接流量;重新点击连接即可再次按系统提示处理。

连接后检查按钮是否变为运行状态,以及系统是否出现 VPN 连接标识。标识说明本地服务已建立,并不能单独证明远端服务器可用。可查看应用日志或使用界面提供的连接测试,再继续实际访问验证。部分系统会限制后台活动;若仅在熄屏后断连,先确认问题与后台限制相关,再调整该应用的电池策略,不必预先修改所有系统权限。

若启动后立即停止,优先查看当前报错,而不是直接重装。配置错误、授权未完成与远端连接超时需要不同处理。记录错误类别、发生步骤与选中条目即可,分享日志前遮蔽订阅地址和身份信息。协议与传输术语不熟悉时,可到协议术语手册查阅,不需要在本次上手中手写配置。

第四步:验证是否生效

连接验证按三个层次进行:客户端正在运行、测试应用确实把请求交给客户端、远端请求获得预期响应。只看绿色按钮、VPN 标识或某次延迟数字,都会遗漏中间环节。先保持当前服务器与模式不变,在浏览器打开一个能够稳定访问、且适合当前网络环境的测试页面,再观察页面是否完整加载。

用实际请求与日志交叉确认

在 v2rayN 中确认系统代理已开启后,新建浏览器标签页发起请求,同时查看日志。若当前日志级别会记录访问,应能看到对应目标或连接记录;如果版本提供连接视图,也可查看该请求的出站去向。日志中有连接尝试但页面打不开,问题更可能位于远端连接或解析环节;完全没有相关请求时,先检查浏览器是否遵循系统代理。

在 v2rayNG 中,保持应用连接运行,再切换到未被分应用规则排除的浏览器访问同一页面。返回客户端查看连接测试结果和日志。若浏览器有独立代理设置,应先恢复到正常系统网络方式,避免额外叠加一层手工代理。日志级别过低时可能没有逐条访问记录,不能仅以“没有日志”断定请求未进入。

需要进一步确认时,可使用可信的公网出口查询页面,对照连接前后的结果。注意:只有被路由送往代理的这次请求才预期体现代理出口;若查询域名被分流到直连,出口不变并不能证明客户端失效。可暂时使用全局代理路由进行对照,再恢复原方案。浏览器缓存和已建立连接也可能影响观察,必要时关闭测试标签页后重新打开。

失败时按路径逐层回查

如果所有页面都无法访问,先停止代理连接,确认基础网络能否正常使用;基础网络正常后,再回到客户端检查活动服务器、运行状态和流量入口。若只是个别网站异常,先观察对应路由和错误记录,不要立刻替换全部订阅。遇到域名解析报错,再阅读DNS 配置参考,避免同时更换 DNS、服务器与代理模式后失去判断依据。

如果桌面浏览器正常,而某个应用仍走原网络,这往往说明该应用不遵循系统代理。先查该应用自身的代理设置,确认是否支持本地代理及实际监听端口;需要更广的流量接管范围时再评估 TUN。安卓端出现单个应用异常,则先复查分应用名单与应用自身网络行为。每次只改变一项,重复同一个测试请求,才能知道调整是否有效。

结束使用与后续配置

桌面端结束使用时,先从系统代理菜单执行“清除系统代理”,再退出客户端。否则部分应用可能继续向已经停止监听的本机端口发出请求,表现为客户端关闭后反而无法联网。安卓端点击停止按钮,确认系统 VPN 连接结束;若仍显示连接,回到客户端或系统 VPN 设置检查状态。

四步验证通过后,可在订阅分组中按需启用自动更新,并根据实际需求整理服务器与路由。客户端可能在下次订阅更新时覆盖手工改动,因此长期自定义前应先了解配置归属。订阅管理、系统代理与内核字段的关系见订阅配置说明及系统代理配置说明。本教程到此完成初次连接,完整 JSON 结构与字段含义留在配置参考中按需阅读。