10 MIN QUICKSTART

V2Ray 客户端 10 分钟快速配置

按固定顺序完成导入订阅、选择代理模式、建立连接、验证生效。本页聚焦首次配置,不展开内核参数与复杂路由规则。

BEFORE START

开始前确认三项内容

准备工作只包含客户端、有效订阅地址和正常的系统时间。先把基础条件确认清楚,可以避免在后续步骤中反复回退。

平台界面提示

v2rayN 桌面端通常通过顶部菜单、服务器列表和托盘菜单完成操作;v2rayNG 安卓端主要使用侧边菜单、右上角操作按钮和底部连接按钮。两者的菜单位置不同,但配置顺序一致:先保存订阅,再更新配置,随后选择模式并连接。

开始前先确认已经安装对应客户端。Windows、macOS 与 Linux 桌面环境使用 v2rayN,安卓设备使用 v2rayNG。本教程不要求手写完整内核配置,也不要求先理解所有协议字段。订阅服务会把服务器地址、端口、传输方式和认证信息整理成客户端能够读取的配置,首次使用只需保证订阅地址完整且仍在有效期内。

第二项是检查设备时间。连接认证和 TLS 握手依赖正确的日期、时间与时区。如果系统时间偏差明显,客户端可能表现为服务器列表能够更新,但连接时持续超时或握手失败。建议开启系统自动设置日期与时区,再完全退出客户端并重新打开。网络本身也要能够访问订阅地址;如果浏览器直接打开订阅地址就显示过期、拒绝访问或服务端错误,应先在订阅提供方处处理,而不是反复修改客户端。

第三项是保留一条清晰的回退路径。首次配置时先不要同时修改自定义 DNS、复杂路由规则、TUN 参数和系统防火墙。变量越少,越容易定位问题。先按默认配置完成一次连接验证,确认基础链路工作后,再根据用途调整分流和 DNS。协议、传输层、TLS、订阅分组等名词可以在概念速查中查阅;系统化故障分析则放在疑难手册中。

SUBSCRIPTION

导入订阅并更新服务器列表

这一阶段的完成标志不是地址已经保存,而是客户端主列表中已经出现可选择的服务器配置。

v2rayN 桌面端操作

打开 v2rayN 后,先找到“订阅分组”菜单,再进入“订阅分组设置”。不同版本的菜单排列可能略有变化,但设置窗口中都会提供添加分组、填写别名和填写订阅地址的区域。新建一个分组,名称可以按用途填写,例如“日常配置”或“备用配置”;名称只用于本地辨认,不参与连接。随后把订阅地址完整粘贴到地址栏,注意不要把聊天软件或文档中的前后空格一起复制进去。

保存分组后,设置窗口关闭并不代表服务器已经导入。回到主界面,再次打开“订阅分组”菜单,执行“更新全部订阅”或对刚建立的分组执行更新。更新过程中客户端会请求订阅内容并解析配置。正常情况下,操作完成后主列表会出现若干服务器条目,列表通常能够看到别名、地址、端口或协议类型等字段。此时先不要急着逐条测试延迟,只要确认列表不是空白,就可以继续下一步。

如果保存后完全看不到新增分组,先重新进入订阅分组设置,确认刚才的记录确实存在。如果分组存在但更新后列表仍为空,重点查看客户端底部状态信息或日志窗口。常见原因包括订阅地址复制不完整、订阅已经失效、当前网络无法访问订阅接口,或者服务端返回的内容不是客户端可识别的格式。不要连续快速点击更新;先读清楚一次更新产生的提示,再针对提示处理。

v2rayNG 安卓端操作

打开 v2rayNG,进入侧边菜单中的“订阅分组设置”。点击新增按钮后填写分组名称与订阅地址,然后保存。返回主界面后,从右上角菜单执行“更新订阅”。部分界面会要求先选中订阅分组,再开始更新;如果已经建立多个分组,应确认当前操作对应刚添加的那一项。更新结束后,主界面应出现服务器配置列表,而不是只保留一个空白页面。

安卓系统可能限制应用在后台持续联网。首次更新时建议让 v2rayNG 保持在前台,等提示结束后再切换应用。如果更新过程被系统中断,可以重新打开客户端执行一次更新。只要服务器列表已经正常出现,就不需要重复导入同一个地址;重复建立多个内容相同的分组会让后续选取配置和排查变得混乱。

看到什么才算完成

完成本步骤后,客户端主列表应至少出现一条可选择配置,并且更新操作没有持续显示解析错误。服务器名称是否容易理解并不影响后续操作;关键是配置已经进入客户端。下一步要解决的是“哪些流量交给客户端处理”,因此先保持列表不动,不要同时修改每条配置的底层参数。

subscription-group
分组名称
日常配置
订阅地址
https://example.invalid/sub
保存后操作
更新全部订阅
完成状态
主列表出现服务器配置
下一步:选择代理模式 →

PROXY MODE

选择代理模式与流量范围

服务器配置决定连接到哪里,代理模式决定哪些流量进入客户端。这是两个独立设置,不能只选服务器而忽略系统代理或连接模式。

先区分路由模式与系统代理

v2rayN 桌面端常见的两个设置是“路由模式”和“系统代理”。路由模式负责判断进入内核后的流量应该代理、直连还是阻断;系统代理负责让浏览器和其他遵循系统设置的应用把请求发送给 v2rayN。只改路由模式但没有开启系统代理,浏览器流量可能根本没有进入客户端。只开启系统代理却选错活动服务器,也可能看到本地代理已启动,但外部连接始终失败。

首次配置建议使用客户端提供的按规则分流模式。该模式会依据内置规则判断流量方向,适合先验证常规浏览是否工作。全局代理会让更多请求统一通过当前配置,便于判断某些分流规则是否造成误判,但不建议在尚未确认基础连接时长期使用。直连模式主要用于临时停用代理路径;如果误选直连,即使客户端进程正在运行,目标请求也不会经由所选服务器。

在 v2rayN 中,先从路由设置或托盘菜单中选择按规则分流,再把系统代理切换为“自动配置系统代理”或当前版本中含义相同的启用项。切换成功后,托盘图标或状态栏通常会显示系统代理已经开启。此时还没有完成连接,因为活动服务器尚未确定;但流量入口已经准备好,可以进入下一步选中具体配置。

v2rayNG 的模式选择

v2rayNG 通过安卓系统提供的连接接口接管设备流量,因此操作重点是应用内的路由设置和连接开关。首次使用可以保留默认路由设置,先完成基础验证。点击连接按钮时,系统可能弹出连接授权提示,确认后客户端才能建立本地接口。这个授权只表示允许 v2rayNG 处理设备流量,不代表远端服务器已经连通,最终仍要结合连接状态和实际访问结果判断。

如果应用中提供“绕过局域网”“按域名规则”或预定义路由选项,第一次配置不要同时勾选多组相互重叠的规则。默认规则能够减少变量。等连接验证成功后,再按照实际需求调整直连范围。关于 domain、ip、geosite、geoip 等规则对象的含义,可以先查看路由与分流术语;复杂规则冲突和 DNS 分流不属于本页的快速流程,统一转到疑难手册处理。

本步骤的结束状态

桌面端应处于按规则分流且系统代理已启用的状态;安卓端应保留明确的路由模式,并准备在下一步确认连接授权。此时不要同时开启其他代理客户端,因为多个程序可能争用同一个系统代理设置或本地端口。关闭不参与本次测试的同类程序后,再继续选择活动服务器。

routing-mode
按规则分流 首次配置建议
全局代理 用于对照排查规则
直连 流量不经过活动配置
下一步:选择配置并连接 →

CONNECT

选择活动配置并建立连接

这一阶段只做两件事:从订阅列表中确定一条活动配置,然后启动客户端的连接入口。

桌面端选择活动服务器

回到 v2rayN 的服务器列表,单击准备使用的配置,再通过右键菜单选择“设为活动服务器”,也可以使用当前版本提供的快捷操作。活动配置通常会以颜色、图标、字体变化或状态栏文字进行标记。不要仅凭列表中某一行被鼠标选中就判断已经生效;鼠标选中是界面焦点,活动服务器才是内核真正读取的目标。

首次选择时不必反复运行全部服务器测试。测试结果受当前网络、服务器响应方式和测试目标影响,只能作为辅助信息。可以先选一条订阅提供方标注为常规用途的配置,设为活动服务器后观察客户端底部状态。随后确认系统代理仍处于启用状态。如果刚才切换模式时客户端重新载入配置,等待状态稳定后再打开浏览器。

正常情况下,v2rayN 会在后台启动所选内核,并监听本地代理端口。日志中通常能够看到配置载入、入站监听和运行启动相关信息。这里不需要手动修改端口,只要日志没有提示端口被占用或配置解析失败即可。如果出现端口占用,先完全退出其他同类客户端,再重启 v2rayN;不要在不了解用途时连续修改多个本地端口。

安卓端启动连接

在 v2rayNG 主列表中点击准备使用的服务器配置,使其成为当前配置。界面通常会用选中标记指出活动项。然后点击底部连接按钮。首次启动时,安卓系统可能显示连接请求,确认后状态栏会出现系统连接标记,v2rayNG 的底部按钮也会变为已连接状态。若拒绝授权,应用无法接管设备流量,需要再次点击连接并完成确认。

连接按钮变为启动状态只说明本地连接接口已经建立,不能单独证明远端服务器可用。保持 v2rayNG 在前台数秒,查看是否立即出现配置错误、握手失败或持续超时。如果没有明显错误,再进入下一步用实际访问进行验证。测试期间避免频繁在多个服务器之间快速切换,每次切换后给客户端留出重新加载配置和建立连接的时间。

连接时出现错误怎么办

如果日志明确显示配置解析失败,通常说明订阅中的某条配置字段与当前客户端或内核不兼容。先更新一次客户端订阅,再换用同一订阅中的另一条配置测试。如果每条配置都显示相同错误,记录错误发生的阶段与关键词,随后查阅疑难手册中的客户端与配置章节。如果表现为连接超时,则先切换网络或选择另一条配置进行交叉验证,不要立即改动 DNS 和路由。

进入验证前的检查点

v2rayN 应已经标记活动服务器,系统代理处于启用状态,日志没有持续刷出启动失败;v2rayNG 应已经选中配置,并显示连接已启动。满足这些条件后,客户端侧的准备工作完成。接下来不要继续盯着按钮状态,而是通过新的浏览器连接和日志变化确认请求是否真正经过客户端。

connection-state
  1. 活动配置 已选中
  2. 本地代理 已启动
  3. 路由模式 按规则
  4. 下一项 实际访问验证
下一步:验证连接是否生效 →

VERIFY

验证代理是否真正生效

验证要同时观察实际访问与客户端日志。单看连接图标、测试延迟或本地端口都不足以确认完整链路。

用新的浏览器会话测试

先关闭此前一直打开的测试页面,再新建浏览器标签页访问一个需要经过代理规则的常规站点。重新打开页面可以减少浏览器缓存、既有连接和 DNS 缓存对判断的影响。如果页面能够正常加载,继续点击站内的另一个链接,确认不是只读取了本地缓存。桌面端还应测试一个普通直连站点,确认按规则分流下两类访问都能工作。

如果浏览器仍显示旧的网络状态,完全退出浏览器后重新打开。部分浏览器会保留已经建立的长连接,系统代理在连接创建之后发生变化时,旧连接未必立即切换。桌面应用是否遵循系统代理取决于应用自身实现,所以首次验证优先使用浏览器,不要用某个不确定代理机制的软件作为唯一判断依据。

同时观察客户端日志

发起访问时查看 v2rayN 或 v2rayNG 的日志区域。如果日志随页面请求新增记录,说明流量已经进入客户端。此时页面仍无法打开,问题范围通常在远端配置、路由匹配、DNS 解析或当前网络链路。如果日志完全没有变化,则更可能是系统代理没有生效、安卓连接没有启动,或者测试应用没有使用当前代理入口。

日志中的“连接建立”和“请求进入”应结合页面结果理解。出现请求记录但持续超时,先换用订阅中的另一条配置;换配置后立即恢复,说明原活动配置暂时不可用。所有配置都超时时,再切换设备当前网络进行对照。如果仅某一类域名失败,而其他访问正常,则应把注意力转向 DNS 或路由规则,而不是重新安装客户端。

检查桌面端系统代理状态

v2rayN 显示运行中但浏览器没有任何日志时,回到托盘菜单检查系统代理是否仍为启用状态。某些系统网络切换、客户端异常退出或其他网络工具启动后,系统代理设置可能被覆盖。重新启用系统代理,然后完全关闭并重开浏览器再次测试。若系统代理启用后很快又被改变,应检查是否有另一个程序正在管理同一项系统设置。

检查安卓端连接状态

v2rayNG 中先确认底部按钮处于连接状态,再查看系统状态栏是否存在对应的连接标记。如果切到后台后连接很快停止,检查安卓系统对 v2rayNG 的电池与后台运行限制。快速测试时先让应用保持前台,完成网页访问后再处理后台保活问题。若只有移动网络或只有无线网络失败,可以在两种网络之间切换一次,通过对照结果判断问题是否与当前网络有关。

完成后再做个性化调整

基础连接确认正常后,可以按需要开启订阅定时更新、调整路由规则或设置特定 DNS。每次只修改一个类别,并在修改后重复本节的访问与日志验证。这样一旦出现问题,可以明确知道是哪项变化造成,而不是面对一组同时变化的参数。需要长期维护多订阅、复杂分流、TUN 模式或 DNS 策略时,继续阅读疑难手册,不要在首次配置阶段一次性开启全部高级选项。

verification-path
  • 1 新建浏览器访问 排除旧连接与页面缓存
  • 2 观察客户端日志 确认请求进入本地代理
  • 3 更换配置对照 区分单条配置与全局问题
  • 4 检查分流结果 确认代理与直连均符合预期

BASIC CHECK

首次配置的基础排查顺序

不要随机切换所有开关。按现象缩小范围,通常比重新安装或反复导入更快。

A

订阅更新失败

重新进入订阅设置,检查地址是否完整、是否多出空格,并确认系统时间正确。随后用当前网络直接访问订阅地址。如果服务端返回过期或拒绝信息,应先处理订阅状态;如果只有客户端请求失败,再查看日志中的网络与证书提示。

B

显示连接但网页打不开

先观察访问网页时日志是否产生新记录。没有记录就检查桌面系统代理或安卓连接状态;有记录但超时就更换活动配置。更换配置仍相同,再切换当前网络进行对照,最后才检查 DNS 与路由。

C

只有部分站点异常

这通常说明基础链路已经工作,问题更可能来自路由匹配、域名解析或站点自身状态。先把路由恢复为客户端默认规则进行对照,再查看日志中该域名命中的出站方向。不要因为单个站点异常就删除全部订阅。

D

切换服务器后没有变化

确认所选条目已经设为活动配置,而不只是获得界面焦点。切换后等待内核重新载入,并重新打开浏览器连接。安卓端应先停止旧连接、选中目标配置,再重新启动;桌面端查看状态栏中的活动服务器名称。