SUPPORT / 常见问题

v2rayN 常见问题

订阅导入、代理接管与连接排查。按现象定位设置,再用日志缩小范围。

以下说明同时涉及 v2rayNG 与 v2flyNG。菜单位置可能随客户端版本变化,实际监听端口与协议能力以当前配置为准。点击问题可展开答案。

SECTION 01 / 基础认知

客户端与协议。先区分配置层级。

v2rayN、v2rayNG 与 v2flyNG 应该怎么选?

Windows、macOS 与 Linux 桌面环境选择 v2rayN;Android 通常先选择使用 Xray 内核的 v2rayNG。已有配置明确依赖 V2Fly 行为时,可考虑 v2flyNG。客户端负责界面、订阅管理与代理开关,实际协议能力还取决于随附内核及版本。选择前先确认平台、处理器架构和服务端要求,不要仅凭应用名称判断兼容性。三款客户端都需要可用的服务端配置,安装完成不代表已经具备连接条件。

VMess、VLESS 与 REALITY 是同一类设置吗?

VMess 与 VLESS 是代理协议,REALITY 是安全层相关技术,不能把三者当作同一组选项直接互换。实际连接还涉及传输方式、端口和安全参数,必须与服务端配置一致。例如 VLESS 配置使用 REALITY 时,需要正确填写公钥、serverName、shortId 等对应字段,flow 也应按服务端要求设置。导入后若出现不支持的字段,应检查客户端及内核能力,而不是随意把协议切换成 VMess。

订阅链接、分享链接与原生 JSON 有什么区别?

订阅链接通常是一个供客户端获取配置列表的地址,更新时会重新请求内容;分享链接通常描述单个服务器配置,常见前缀包括 vmess://、vless://、trojan:// 和 ss://。原生 JSON 则可包含入站、出站、路由与 DNS 等完整内核设置,不能默认作为普通订阅导入。应根据内容类型选择订阅分组、剪贴板导入或自定义配置入口。订阅地址可能包含访问凭据,截图或求助时需要遮住完整地址及相关参数。

系统代理与 TUN 模式的接管范围有何区别?

系统代理把代理地址写入操作系统设置,主要影响主动读取这些设置的应用;自行直连或单独配置代理的应用可能不受影响。TUN 模式通过虚拟网络接口接管符合路由条件的流量,并涉及权限、DNS 与网络路由。它不意味着所有流量一定走代理,最终仍受分流规则影响。首次配置建议先用系统代理验证服务器可用,再按应用需求启用 TUN,避免同时改变多项设置后难以定位故障。

需要比较三款客户端的适用范围,可继续阅读选型指南。

SECTION 02 / 安装配置

安装与导入。核对架构和接管入口。

Android 安装包应该选 arm64 还是 universal?

2015 年后主流手机通常优先考虑 arm64 包,但最终应以设备系统支持的 ABI 为准,处理器支持 64 位不代表系统一定支持对应应用。universal 包包含多种架构内容,适合暂时无法确认架构的情况,文件通常更大。若安装时提示与设备不兼容,先核对系统版本和架构,再选择匹配的包;若提示签名冲突,不应通过反复更换架构解决。覆盖安装前保留配置,避免卸载后丢失订阅与自定义规则。

订阅导入失败或导入后列表为空,应该检查什么?

先确认复制的是完整订阅地址,而不是订阅管理网页、说明文字或单条分享链接,并去掉首尾空白及换行。把地址添加到订阅分组后,仍需执行更新订阅操作。若列表为空,查看日志中的请求结果和解析错误:返回登录页通常说明地址或授权不对,格式无法识别则应核对提供方给出的客户端类型。不要为排错公开完整订阅地址;只记录错误类型、响应状态与已遮蔽敏感信息的内容特征。

v2rayN 已开启系统代理,浏览器为什么仍然直连?

先确认当前服务器已选中、内核正在运行,再到操作系统代理设置核对地址与端口是否指向客户端实际监听。不要把示例端口当作固定值,更新或自定义配置后监听可能不同。随后检查浏览器是否选择使用系统代理,以及代理扩展是否覆盖了该设置。某些应用有独立网络设置,需要单独指定代理。关闭其他代理工具后重新测试同一目标;若只有个别网站直连,还应检查路由规则是否把它们分配给 direct。

启用 TUN 模式时提示权限不足,如何处理?

桌面系统创建虚拟接口和修改路由通常需要提权,先按客户端当前版本提示授予权限,再确认相关服务或虚拟接口组件已正常建立。Android 使用系统 VPN 授权流程,需要在系统对话框中确认。不要同时开启另一个占用相同网络接管能力的工具。若授权后仍失败,查看日志中失败的具体步骤,并检查安全软件拦截或残留接口;不应长期关闭系统防护作为解决方案。停用 TUN 后先确认普通网络恢复,再继续排查。

安装包入口与架构说明见获取客户端;首次导入流程见快速上手。

SECTION 03 / 使用技巧

测试与分流。保持对照条件一致。

Tcping 与真连接延迟测试分别说明什么?

Tcping 主要反映目标地址与端口能否建立 TCP 连接,不会完整验证代理协议握手、认证和目标网站访问。真连接延迟测试则会经由代理访问指定测试地址,更接近实际使用路径,但结果也受测试目标、DNS 与当时网络状态影响。端口可达而真连接失败时,应进一步检查协议参数和日志。不要仅凭一次测试挑选服务器;先固定测试目标重复观察,再用浏览器访问结果确认需要使用的应用是否真正经过代理。

路由分流和全局代理应该如何切换验证?

日常可按用途选择绕过大陆等分流方案,具体命中结果取决于规则内容及其顺序。排查某个目标访问异常时,可临时让目标走代理,或切换到客户端提供的全局代理路由方案作对照,同时保持服务器和测试地址不变。若对照后恢复,重点检查规则优先级、规则数据与域名解析行为。系统代理开关只决定应用如何把请求送到客户端,不等同于内核的全局路由;测试结束后应恢复所需分流设置。

订阅更新时怎样避免影响自定义服务器配置?

订阅更新可能覆盖该分组中由订阅生成的服务器条目,因此不宜把长期修改直接保存在自动更新的条目上。需要调整参数时,先在客户端允许的情况下复制到独立手动分组,并保留原始订阅用于对照。更新前备份订阅分组、路由规则与必要的自定义配置,备份文件同样需要妥善保管。若更新后当前服务器失效,重新检查活动服务器及其分组归属,不要假定同名条目仍对应原来的地址和参数。

怎样确认代理已对指定应用生效?

先确认内核运行正常,再确认指定应用采用系统代理、手动代理或 TUN 接管中的哪条路径。用同一应用访问一个明确应走代理的目标,同时查看客户端连接记录或访问日志中的入站与出站标记。只有页面能打开并不能证明走了代理,因为目标可能直接可达,也可能命中 direct 规则。测试时可暂时提高日志级别,完成后恢复常用级别;向他人提供记录前遮蔽服务器地址、订阅参数和可能关联个人活动的信息。

SECTION 04 / 故障排查

连接异常。按失败阶段检查。

服务器连接超时,应该按什么顺序排查?

先确认本机普通网络可用,并检查服务器地址与端口是否完整。随后区分域名解析失败、TCP 连接超时和协议握手失败:解析失败重点检查 DNS,连接超时重点检查服务端监听与链路,握手失败再核对协议、安全层和认证字段。系统时间明显偏差也可能影响认证或证书验证。固定一个服务器做对照测试,每次只改一项;若同一配置在其他网络可用,应优先比较本地网络环境,而不是反复重装客户端。

客户端显示连接正常,但网页无法打开怎么办?

客户端运行或本地监听成功,只说明接管入口已启动,不代表远端请求全部成功。先查看真连接测试与访问日志,确认请求有没有进入客户端;没有记录时检查应用代理设置,有记录但出站失败时检查服务器与协议参数。若日志集中出现域名解析错误,再检查 DNS 及其路由,避免解析请求依赖尚未建立的代理。只有部分目标失败时,比较规则命中和目标连通性;不要把关闭证书验证当作通用修复方法。

原来可用的订阅突然更新失败,如何区分原因?

先看错误属于请求超时、授权拒绝还是内容解析失败。授权拒绝通常需要确认订阅有效期或地址是否被重置;解析失败则检查返回内容是否变成网页或不兼容格式。若客户端支持分别通过直连与代理更新,可在已有可用连接时对照测试,避免更新请求依赖已经失效的服务器。还应检查系统时间、DNS 与本地安全软件记录。旧条目仍可用时先保留,不要立即清空全部分组,以免失去对照配置。

日志提示端口被占用,或退出后网络异常怎么办?

端口被占用通常表示另一个进程或重复启动的内核正在监听同一地址。先退出重复客户端,在系统中确认占用来源,再停止对应进程或在设置中更换本地监听端口;应用手动代理也要同步修改。若异常退出后无法上网,先检查系统代理是否仍指向已经停止的本地监听,再检查 TUN 接口和路由是否恢复。尽量使用客户端正常停用与退出流程。仍未恢复时保存错误记录,再按操作系统网络设置逐项检查。

需要理解入站、路由与出站的关系,可阅读协议参考,再对照当前配置定位失败环节。