FAQ / 客户端配置
v2rayN 常见问题
从安装包选型和订阅导入,到系统代理、路由与连接故障。按当前要做的操作或遇到的症状查找答案。
01 / BASICS
基础认知
区分客户端、内核、节点和流量入口。
客户端、内核和节点分别负责什么?
v2rayN 是桌面图形客户端,负责管理订阅、保存设置并启动内核。Xray、sing-box 等内核负责监听本地端口、执行路由规则和处理出站连接。节点则是一组远端连接参数,不是客户端附带的服务。排查时先分清故障发生在哪一层:客户端打不开,先查安装环境;内核启动失败,先看启动日志;只有某一节点连不上,再查该节点的参数和服务状态。
订阅链接和单节点链接有什么区别?
订阅链接指向一份可重新获取的配置列表,应保存到订阅分组,再执行更新。单节点链接只描述一次连接所需的参数,应从剪贴板导入服务器;远端参数改动后,通常需要重新导入这条链接。不要根据链接长短判断类型,以提供方标明的用途为准。订阅地址可能包含访问凭据,截图、录屏或提交日志前应遮住完整地址和查询参数。
系统代理、路由模式和 TUN 是同一个开关吗?
不是。系统代理向遵循系统设置的应用提供本地代理入口;TUN 利用虚拟网络接口接收符合配置的流量;路由模式则决定流量进入内核后是直连、走代理还是被拒绝。只需验证浏览器时,先开启系统代理并保留当前路由,便于确认入口是否工作。若应用明确不读取系统代理,再判断是否需要应用内代理或 TUN,不要同时切换入口和路由。
v2rayN、v2rayNG 和 v2flyNG 怎么选?
Windows、macOS 和 Linux 使用 v2rayN,安装前要核对系统与处理器架构。Android 优先考虑以 Xray 为内核的 v2rayNG;已有按 V2Fly 特性维护的配置时,再考虑 v2flyNG。选择时以节点所需协议、传输方式和安全参数为准,不只看链接能否导入。换客户端后重新检查路由、DNS 和本地入口设置,不要把旧客户端的界面选项逐项照搬。
02 / INSTALLATION
安装配置
核对安装包架构、订阅格式与 TUN 权限。
桌面端导入订阅后,服务器列表为什么是空的?
在订阅分组中新增记录,填写备注和完整订阅地址,保存后针对该分组执行一次手动更新。回到服务器列表,切到对应分组并清除筛选词。新增分组只保存地址,不等于已经拉取节点。如果菜单提示导入失败,先确认复制的是订阅地址,而不是分享页面或单节点链接;更新显示完成却仍为空时,再查日志中是否有解析错误,并确认提供方返回的是客户端能识别的格式。
Android 安装包的 arm64 与 universal 怎么选?
设备的 Android 系统支持 arm64-v8a 时,优先选 arm64,包体通常较小。仅凭处理器为 64 位不能断定系统支持该架构,有些设备仍运行 32 位系统。不确定时先看设备厂商的系统规格,或选包含多种架构的 universal 包。若覆盖安装时报签名不一致,先备份配置并核对旧版来源;若提示系统版本不满足要求,更换架构包也不能解决。
Windows 桌面版和经典 WPF 版有什么区别?
桌面版使用跨平台界面,界面和菜单组织与其他桌面平台更接近;经典 WPF 版面向 Windows,保留熟悉的界面布局。两者的选择主要取决于使用习惯和系统要求,界面不同并不意味着节点速度不同。迁移前备份订阅和自定义路由,完全退出旧客户端,再启动另一版并检查本地监听端口。不要让两版同时占用同一个端口或交替修改系统代理。
启用 TUN 需要哪些权限?
TUN 需要创建虚拟网络接口并调整系统路由,具体权限由操作系统和安装方式决定。启动失败时先读内核日志,区分权限不足、接口创建失败与路由冲突。Windows 如明确提示权限不足,可按客户端提示以管理员权限重新启动受信任的安装版本;Linux 则按发行版和安装包说明配置所需权限。若设备受组织管理,应先确认策略,不要通过关闭系统防护换取权限。
03 / USAGE
使用技巧
验证出站、保留配置,每次只改一项。
如何确认一个网站实际走了代理?
先选定一个节点,保持路由模式不变,再用采用系统代理的浏览器访问需要验证的站点。对照请求时间查看客户端访问日志,确认目标域名或地址,以及对应的出站标记。如果页面可以打开但出站为直连,说明连通性正常,但这次请求没有走代理。验证规则时重新建立浏览器连接;已打开的页面可能沿用缓存或旧连接,不适合作为唯一判断依据。
更新订阅前,怎样保留手动维护的节点和路由?
把手动维护的节点放进单独分组,不要直接编辑由订阅更新覆盖的条目。更新前使用当前版本支持的导出或备份功能保存配置,另外记录自定义路由的名称和启用顺序。更新后先在原分组确认节点列表,再核对当前选中节点是否仍存在。如果旧节点被移除,重新选择并测试,不要误把旧别名当作仍可使用的连接。备份文件应按敏感配置保管。
切换路由模式后,已有连接会立刻改变吗?
不要用切换前已经打开的网页判断结果。路由通常在建立连接时匹配;旧连接可能继续沿用原出站,也可能因内核重启而断开。保存路由设置后,让测试应用建立新连接,再从日志核对命中的规则和实际出站。若结果与预期不符,先检查规则顺序和兜底出站,有时更靠前的宽泛规则已经匹配请求,后面的细化规则就没有执行机会。
切换 Xray 与 sing-box 前要核对什么?
先记下当前节点的协议、传输和安全选项,再确认目标内核能处理这些组合,以及现有路由与 DNS 设置能否按预期应用。每次只切换内核,不同时更换节点和路由,这样出现问题时能定位变动来源。重启后先确认内核已启动、本地端口正在监听,再发起实际请求。如果日志出现不识别的字段或不支持的传输方式,先恢复原内核,再对照客户端和内核文档调整。
04 / DIAGNOSTICS
故障排查
用日志区分订阅请求、节点连接和应用代理故障。
订阅以前能更新,现在提示失败,先查什么?
对受影响的分组手动更新一次,记下更新时采用的网络路径并查看日志。若出现连接超时或域名解析失败,先检查当前网络能否访问订阅服务;若返回未授权、禁止访问或地址不存在,向提供方确认地址是否变更、凭据是否过期。若请求成功但解析失败,检查返回内容是否变成登录页或错误页。保留现有分组,定位原因前不必删除节点或反复重建配置。
节点测试超时,怎么判断是单节点问题还是本地问题?
在同一网络下用同一种测试方式检查两个不同服务器,再试一次实际请求。只有一个节点超时,优先核对服务器地址、端口、传输方式和必要的连接参数;多个节点同时失败,则先看内核是否启动、测试地址是否可达,以及设备时间是否正确。握手超时和测试站点访问失败并非一回事;如果实际请求成功而只有测速失败,应先核对测速方式和目标。
v2rayN 显示已连接,网页为什么还是打不开?
先用遵循系统代理设置的浏览器发起一个新请求,确认系统代理指向客户端当前监听的地址和端口。若日志没有这次请求,先排查应用的代理入口;若已收到请求,查看失败发生在解析、路由匹配还是远端握手。可在同一网络下对照一个应直连的网站和一个应走代理的网站,逐项缩小范围。界面显示内核已启动,不代表远端已应答,也不能代替实际访问测试。
开启系统代理后,为什么只有某个应用不生效?
如果浏览器已正常使用代理,先检查出问题的应用是否读取系统代理,以及它是否配置了独立代理、例外规则或始终直连。部分应用只在启动时读取系统设置,保存后应彻底退出再打开。应用支持手动配置时,按它接受的代理类型填写对应的本地地址和端口,不要混用 HTTP 与 SOCKS 端口。没有手动入口时,再评估 TUN 或咨询设备管理员。