FAQ 客户端使用与排查
v2rayN 常见问题
从安装包与订阅格式查起。已连接但无法访问时,按流量入口、路由、出站的顺序定位。
基础认知
辨认客户端、订阅格式与配置字段。
v2rayN、v2rayNG 和 v2flyNG 有什么区别?
v2rayN 用于 Windows、macOS 和 Linux;v2rayNG 与 v2flyNG 用于 Android,分别使用 Xray 与 V2Fly 内核。选型时先确定设备平台,再核对节点的协议、传输方式和安全选项是否受当前客户端及内核支持。两个客户端即使都能导入同一个地址,也未必都能识别其中的全部参数。安装格式与架构可在客户端页面按平台查看。
订阅地址和单节点链接有什么区别?
订阅地址用于获取一组节点,应添加到订阅分组,再执行该分组的更新。单节点链接只描述一个连接,应通过剪贴板导入或扫码添加。把订阅地址当成单节点导入时,客户端可能提示格式不支持;把单节点链接保存为订阅时,更新也不会生成可用列表。区分不清时,向配置提供方确认交付格式,不要把完整地址贴到公开求助帖。
系统代理、TUN 和全局模式是同一回事吗?
系统代理与 TUN 决定流量如何进入客户端:前者依赖应用读取系统代理设置,后者通过虚拟网卡按系统路由接收流量。全局模式描述的是进入客户端后的出站选择,具体行为取决于客户端所选的路由配置。开启全局模式不等于接管所有应用,打开 TUN 也不等于关闭直连规则。排查时分别确认流量入口和出站去向。
inbounds、routing 和 outbounds 应按什么顺序理解?
从一条请求的路径看,inbounds 定义接收方式,例如本地监听地址、端口和协议;routing 按规则判断流量应交给哪个出站;outbounds 定义实际执行连接的方式。检查配置时,先确认应用把请求发到了正确入站,再核对路由条件,最后检查 outboundTag 是否对应一个已定义的出站 tag。字段结构与引用关系可对照配置参考。
安装配置
按系统、架构和界面版本选包,再导入订阅。
Android 安装包应该选 arm64 还是 universal?
设备的 Android 系统支持 arm64-v8a 时,优先选 arm64 包。架构不确定时,先查厂商规格或设备信息中的系统支持架构;不要只根据芯片支持六十四位就判断系统也能安装六十四位应用。仍无法确认时,可试用同一客户端的 universal 包。通用包通常较大,也不能绕过最低系统版本要求;如果是在覆盖安装,还需留意系统是否提示签名冲突。
macOS 安装包应选 Apple Silicon 还是 Intel?
打开苹果菜单中的“关于本机”。如果显示 M 系列芯片,选择 Apple Silicon 对应的 arm64 安装包;如果显示 Intel 处理器,选择 Intel 对应的 x64 安装包。选择依据是本机芯片,不是此前使用的客户端版本。首次打开时若出现系统提示,先看提示是系统版本不符、应用受管控,还是文件无法打开;工作设备上的限制应由设备管理员处理。
Windows 的 Desktop 和 WPF 版本怎么选?
Desktop 使用跨平台界面,WPF 是面向 Windows 的经典界面。现有操作流程依赖经典菜单布局时,可继续使用 WPF;希望与其他桌面平台使用相近的界面时,可选 Desktop。切换前先备份节点、订阅和自定义路由。首次启动新版本时,先退出旧版本及托盘进程,再确认本地监听端口和系统代理状态,避免两个实例同时改动设置。
订阅地址已经复制,为什么导入后没有节点?
先确认剪贴板中是完整的订阅地址,而不是面板首页或一条单节点链接。在订阅分组中新建条目并保存,然后手动更新该分组;保存地址本身不会取回节点。若日志显示请求成功但没有可导入项,检查返回内容是否为登录提示、空列表或当前客户端不支持的配置格式。需要重新复制地址时,保留查询参数,不要自行删减或替换。
使用技巧
用新请求验证代理设置,区分测速结果与实际连通性。
怎样判断应用是否使用了系统代理?
先确认客户端内核已启动,再到系统网络设置核对代理地址和端口是否对应客户端的本地监听。用会遵循系统代理设置的浏览器发起一次请求,同时查看客户端日志是否出现相应记录。浏览器有记录而另一个应用没有时,再检查后者是否有独立代理设置、是否受浏览器扩展或管理策略影响,以及改动设置后是否需要重启应用。
节点测速应看哪个结果?
先看测试方式,再比较结果。TCP 延迟反映到节点地址和端口建立连接所需的时间,不能说明代理握手或目标网页访问一定成功;通过代理发起的测试请求还受测试地址和 DNS 解析影响。对比时保持同一网络、同一测试方式和同一测试地址,必要时复测。若日常使用的是特定站点或应用,最终用实际请求验证,不只看延迟排名。
启用 TUN 时提示权限不足,应该先检查什么?
先看启动日志,对照失败的是虚拟网卡创建、系统路由写入,还是系统授权。Windows 上可按客户端提示授权后再启动;macOS 和 Linux 上可查阅对应版本的权限要求。Android 上则检查系统的 VPN 连接授权是否已确认,以及是否有别的 VPN 正在运行。一次只保留一个接管流量的工具;受管理设备上的权限限制应交给管理员处理。
切换节点后,为什么已有连接看起来没有变化?
切换节点后,应先用新建请求验证;已经建立的长连接可能继续复用原有通道,也可能在内核重载时断开并重连。可以关闭正在测试的应用后重新打开,再检查新请求对应的出站标签。若新请求仍走直连,核对所用路由配置是否命中了直连规则。切换当前节点只会影响应走代理出站的请求,不会改写已有的分流条件。
故障排查
以发生故障时的日志区分更新请求、代理连接与本地监听问题。
订阅以前可以更新,现在更新失败怎么查?
只更新出错的分组,并记录该次请求的错误。域名解析失败时先检查当前网络和系统 DNS;连接或读取超时时,检查更新请求所走的网络路径是否可用;返回未授权或禁止访问时,向提供方确认地址是否失效或需要重发。若报错出现在解析阶段,核对订阅格式与客户端兼容性。先保留现有节点,不要为了重试而删除整个分组。
节点测试一直超时,怎样判断故障范围?
在同一网络中,用相同的测试方式分别测出错节点和一个已知可用节点;如果只有代理请求测试失败,再换一个可正常访问的测试地址。只有单个节点出错时,核对服务器域名和端口,并查看日志是连接超时还是握手失败。多个节点同时出错时,优先排查本机网络、内核启动与 DNS。每次只改一个设置,保留修改前后的结果。
客户端显示已连接,为什么网页还是打不开?
已连接通常只说明本地服务或接管模式已经启动,不代表具体请求成功。打开一个网页并检查同期日志:没有对应记录,先查浏览器是否进入了系统代理或 TUN;有记录但域名解析失败,先查 DNS;已找到对应出站但握手失败,则核对节点的传输与安全参数。若只有单个站点失败,先用同一浏览器访问另一个站点,不要直接重装客户端。
打开系统代理后还是不生效,应该检查哪些冲突?
先核对系统代理填写的端口是否是当前内核实际监听的端口,并确认它对应的协议;只提供 SOCKS 的端口不能直接当作 HTTP 代理端口使用。然后查看浏览器是否启用了独立代理扩展,系统是否还配置了自动代理脚本,或其他客户端是否覆盖了代理设置。关闭其他代理工具后重新应用设置,再用一条新请求验证。退出客户端前记得清除相应的系统代理设置。
日志提示本地监听端口已被占用,怎么处理?
从启动失败的日志中记下监听地址和端口,先检查托盘里是否还有一个客户端实例,再用系统的连接查看工具确认监听进程。确认是旧实例后正常退出;若端口属于仍需运行的程序,则在客户端中换一个未用端口。重启内核后同步更新系统代理及手动配置过的应用端口,并验证新请求。不要结束归属不明的系统进程。