确认客户端与系统匹配
桌面设备使用 v2rayN,安卓设备优先使用 v2rayNG。尚未安装时先进入下载页,按 Windows、macOS、Android 或 Linux 选择对应安装包。安装完成后启动客户端,暂时不要修改内核、端口和路由高级项。
按平台选择客户端 →STEP INDEX
按顺序完成配置。后一步出现异常时,先回到前一步确认界面状态,不要同时修改服务器、路由和 DNS。
BEFORE START
先把输入条件确认清楚,可以避免在后续步骤里反复切换设置。
桌面设备使用 v2rayN,安卓设备优先使用 v2rayNG。尚未安装时先进入下载页,按 Windows、macOS、Android 或 Linux 选择对应安装包。安装完成后启动客户端,暂时不要修改内核、端口和路由高级项。
按平台选择客户端 →订阅地址通常是一条以 https:// 开头的完整链接,其中可能包含用于识别订阅的参数。复制时不要遗漏末尾字符,也不要把网页控制台地址、单个节点名称或二维码说明文字当成订阅链接。
格式示意
https://example.com/subscription?token=xxxx
部分传输配置对设备时间偏差较敏感。开始前打开系统的自动日期与时间功能,并确认时区正确。如果设备时间明显错误,可能出现服务器已经导入、网络也正常,但连接握手仍然失败的情况。
查看进阶排查路径 →IMPORT / UPDATE
这一阶段的完成标志不是“地址已经保存”,而是主界面里已经出现可以选中的服务器条目。
打开 v2rayN 主窗口后,在顶部菜单找到“订阅分组”或订阅管理入口。不同版本的菜单文字可能略有差异,但都包含新增订阅、管理订阅和更新订阅三类操作。进入管理窗口,选择新增,给这条订阅填写一个便于识别的备注,例如“日常线路”。备注只用于本地分组,不会改变服务器配置。
把完整订阅地址粘贴到地址栏并保存。返回主窗口后,再次打开订阅菜单,执行“更新全部订阅”或选中刚创建的分组单独更新。更新过程结束后,主窗口的服务器列表应出现名称、地址类型或传输方式等条目。此时先不要急着连接,点击列表中的一行,确认它能被选中并成为当前活动服务器。
如果保存后列表仍为空,先查看底部状态区域或日志窗口。出现地址格式错误时,重新复制原始链接;出现请求超时,可确认本机普通网络是否可用,再尝试客户端提供的经代理更新选项。首次使用且当前没有可工作的代理连接时,不应盲目开启经代理更新,否则更新请求可能找不到可用出站。
打开 v2rayNG,展开左上角侧边菜单,进入“订阅设置”。点击右上角新增按钮,填写备注并粘贴订阅地址,保存后返回订阅设置列表。确认新增项目处于启用状态,然后从右上角菜单执行更新订阅。更新完成后回到主界面,页面中应出现一个或多个配置条目。
点击其中一条配置,使它显示为当前选中项。不要只停留在订阅设置页面:订阅地址是配置来源,主界面的服务器条目才是实际连接对象。如果更新提示成功但主界面没有变化,可在主界面菜单中执行一次刷新,或者检查订阅项目是否被停用。
SERVER / ROUTING
服务器决定流量从哪条线路发送,代理模式决定哪些请求进入该线路。首次配置先减少变量,再逐步细化规则。
在服务器列表中选择一条配置。v2rayN 通常可通过双击列表行、右键设为活动服务器,或使用回车完成选择;v2rayNG 则直接点击主界面的配置条目。选中后观察高亮状态或顶部显示的当前配置名称,确认客户端后续启动的是这一条服务器,而不是上次使用的旧配置。
订阅包含多条线路时,首次连接不必连续切换。先固定一条完成整个流程,验证失败后再换另一条对照测试。这样可以判断问题来自单条服务器,还是来自系统代理、权限或路由设置。测速结果只能作为选线参考,不能代替真实连接验证。
规则分流按照域名、IP、端口或规则集决定出站,适合日常使用,也是首次配置建议选择的模式。常见本地服务可以保持直连,需要代理的目标进入代理出站。此模式依赖路由规则质量,因此后续若只有个别网站路径异常,应优先检查规则命中情况。
全局代理把客户端接管到的流量统一交给当前代理出站,适合用来做短时间对照测试。如果规则模式下某个目标打不开,而全局模式可以访问,通常说明连接本身可用,问题更可能位于分流规则或 DNS 解析路径。全局模式不是排查结束的标志,确认原因后应根据实际需求恢复规则分流。
直连让流量绕过代理出站,主要用于暂停代理或验证本地网络。选择直连后即使客户端核心正在运行,也不会产生预期的代理访问结果。排查“已连接但没有变化”时,应先确认当前不是直连模式。
v2rayN 需要把系统代理切换到可用状态,常见选项包括自动配置系统代理、清除系统代理以及不改变系统代理。首次使用可选择自动配置,让遵循系统代理设置的浏览器和应用把请求发送给 v2rayN。只启动内核但不设置系统代理时,日志可能显示核心运行正常,浏览器流量却没有进入客户端。
v2rayNG 通过系统连接授权接管流量,通常不需要另外填写桌面系统代理地址。连接时系统会弹出授权确认,允许后状态栏会显示连接标记。若之前拒绝过权限,应重新点击连接并按系统提示完成授权。
| 模式 | 主要用途 | 首次配置建议 |
|---|---|---|
| 规则分流 | 按路由规则分别走代理或直连 | 作为日常起点 |
| 全局代理 | 统一使用当前代理出站 | 用于短时间对照排查 |
| 直连 | 流量不进入代理出站 | 用于暂停或核对本地网络 |
START / OBSERVE
连接按钮只是启动动作。真正需要确认的是核心已运行、流量入口已接管,并且日志没有持续重复错误。
确认服务器列表中已有活动项后,通过主窗口底部状态区、任务栏菜单或顶部菜单启动服务。随后把系统代理切换为自动配置或与当前模式对应的状态。不同版本可能把“启动服务”和“设置系统代理”组合在一个操作中,也可能分成两个入口;操作后应同时查看任务栏图标状态和主窗口底部文字。
打开日志面板,正常启动时通常会看到配置载入、入站监听和核心启动相关记录。日志中的本地端口用于客户端与系统之间传递流量,不代表服务器端口。不要为了匹配订阅内容而随意修改本地监听端口。若日志提示端口被占用,先完全退出重复运行的客户端进程,再重新启动;仍然冲突时,再到设置中更换未被其他程序使用的本地端口。
回到 v2rayNG 主界面,确认顶部或配置卡片显示的是刚才选中的服务器,然后点击圆形连接按钮。首次连接时系统会显示连接授权窗口,确认后按钮状态会变化,系统状态区域也会出现连接标记。此时保持客户端在后台运行即可,不需要一直停留在主界面。
如果点击后立即恢复未连接状态,打开侧边菜单中的日志,查看最后几行错误。常见方向包括服务器不可达、配置字段不兼容、设备时间偏差和网络切换中断。先把移动网络与无线网络固定为其中一种再重试,避免连接建立过程中发生网络出口切换。
核心启动只说明客户端成功读取配置并开始监听本地流量;它不等于远端线路一定可用。某些协议会在真实请求到来时才建立远端连接,因此刚点击按钮时没有大量日志是正常现象。接下来需要主动打开一个网页或刷新已有页面,让浏览器产生请求,再观察日志是否出现对应的入站、路由和出站记录。
如果状态显示运行中,但浏览器刷新后日志完全没有新增内容,问题通常位于流量入口:桌面端检查系统代理是否已经打开,安卓端检查系统连接授权是否仍有效。如果日志出现请求但持续报连接失败,再考虑更换订阅中的另一台服务器进行对照。
状态栏显示运行,日志出现配置载入与监听记录。
刷新页面后日志出现新的入站与路由记录。
继续检查目标访问与规则分流,不只看连接图标。
RESULT / ROUTE
验证要覆盖三个层次:客户端是否收到请求、请求是否进入预期出站、规则模式下的直连目标是否仍按原路径访问。
连接前已经打开的网页可能保留旧连接或缓存。关闭相关标签页后重新打开,或使用新的浏览器窗口产生请求。桌面端若只有某一个浏览器没有变化,检查该浏览器是否使用独立代理设置;独立设置会覆盖系统代理。安卓端若只有个别应用没有进入连接,检查 v2rayNG 的分应用代理设置是否排除了该应用。
请求发出后立即查看客户端日志。能看到目标域名、对应规则标签或出站类型,说明流量已经进入客户端。如果浏览器报错而日志没有任何记录,应回到上一步检查流量入口;如果日志有记录且显示连接超时,则更可能是当前服务器或网络路径问题。
规则分流不能只验证一个需要代理的目标,还要检查一个应当保持直连的常用本地服务。前者用于确认代理出站可用,后者用于确认规则没有把全部流量错误送入同一出口。打开两个目标后,对照日志中的路由结果:需要代理的请求应进入代理出站,直连目标应命中直连规则。
如果全局代理可以访问,而规则模式不行,不要反复重装客户端。先记录失败目标的域名,在日志中查找它命中的规则,再检查 GeoSite、GeoIP 数据和自定义路由顺序。路由规则通常从上到下匹配,过于宽泛的规则放在前面,会让后面的精确规则没有机会生效。
出现“部分域名打不开,但直接使用地址可以连接”时,问题可能位于 DNS。首次教程阶段先恢复客户端默认 DNS 设置并重启连接,避免系统 DNS、自定义远程 DNS 和 FakeDNS 同时参与。恢复后清理浏览器当前页面并重新访问,观察日志中是否出现域名解析错误。
默认设置能够工作后,再根据网络环境决定是否配置远程 DNS、DNS 出站或 FakeDNS。DNS 规则与路由规则互相影响,适合在连接基础已经验证后单独调整。完整配置路径、泄漏检测方法和 TUN 配合方式放在进阶手册中说明。
QUICK FIXES
按现象一次只改一个变量。每次修改后重新连接并复测,才能确认是哪一项设置产生了影响。
先确认订阅项目处于启用状态,再回到主界面执行刷新。若仍为空,检查订阅返回内容是否属于当前客户端支持的格式。不要把订阅管理页里的地址记录误认为已经导入完成,最终应以主界面出现可选择的服务器条目为准。
桌面端先检查系统代理是否已经切换到客户端管理状态,再确认浏览器没有设置独立代理;安卓端检查系统连接授权和分应用代理范围。刷新页面时同步观察日志,日志没有新增请求通常说明流量尚未进入客户端。
这通常说明连接链路基本可用,应把排查重点转向路由规则和 DNS。查看失败域名命中的规则,确认宽泛规则没有覆盖精确规则,并检查 GeoSite、GeoIP 数据是否适配当前规则写法。调整前可先导出当前配置。
确认设备网络本身可访问普通网页,并校准系统时间。随后固定当前网络类型、重启客户端,再选择另一条服务器测试。若多条服务器表现一致,继续检查订阅是否过期、客户端内核是否兼容以及 DNS 是否返回异常结果。