客户端配置 / 常见问题

V2Ray 常见问题

按问题定位订阅、代理模式与连接故障。先保留当前配置,每次只调整一个设置,再复测同一个请求。

首次使用可先阅读配置教程;需要逐平台操作说明时,查看全平台指南。点击问题展开答案。

基础认知

区分客户端、订阅与流量接管方式,再开始配置。

v2rayN、v2rayNG 和 v2flyNG 应该怎么选?

先按设备选择,再核对配置要求。Windows、macOS 与 Linux 使用 v2rayN;Android 通常先选采用 Xray 内核的 v2rayNG,需要 v2fly 内核时再考虑 v2flyNG。客户端负责图形界面、订阅管理与模式切换,内核负责处理具体协议。名称相近不代表配置完全通用,特别是传输方式和安全参数仍需与服务端一致。已有订阅时,先查看提供方注明的客户端与内核要求,不要仅凭协议名称判断兼容性;切换客户端前保留原有设置,便于对照。

安装客户端之后,还需要准备什么?

客户端本身不提供可直接连接的服务器。开始配置前,需要准备有权使用的订阅地址、单节点分享链接或完整的服务器参数,并确认当前设备能正常访问本地网络。手动填写时,地址、端口、用户标识、传输方式与 TLS 等字段应逐项对应,不要自行猜测缺失内容。先将设备日期和时区设为正确值,再导入一条已知可用的配置进行测试。订阅地址和分享链接可能包含访问凭据,不要发布到公开页面,也不要把完整内容交给陌生人排查。

单节点分享链接和订阅地址有什么区别?

单节点分享链接通常以 vmess://、vless:// 等协议前缀开头,用来描述一个连接配置;订阅地址通常是可访问的 HTTPS 地址,客户端需要请求该地址,再读取其中的节点集合。复制单节点链接时,使用从剪贴板导入的入口;添加订阅时,进入订阅管理,保存地址后执行更新。把订阅地址直接当作服务器地址填写,通常不会生成正确配置。单节点导入后不会自动跟随原链接变化,订阅则可以在后续更新时同步节点,但更新能否成功仍取决于订阅服务和网络状态。

系统代理、TUN 和全局路由是一回事吗?

不是同一层设置。系统代理让遵循系统代理设置的应用把请求发送给本地代理端口;TUN 通过虚拟网卡接收流量,适合处理部分不读取系统代理的应用。全局路由则决定进入内核的流量如何选择出口,并不保证所有应用的流量都已经进入内核。因此,只切换全局路由而未启用合适的接管方式,某些应用仍可能直连。首次配置建议先用系统代理验证浏览器连接,再按实际需求启用 TUN;切换时留意局域网、DNS 和排除规则,避免同时改动过多设置。

安装配置

核对安装包、导入入口与系统授权,减少首次连接时的变量。

Android 安装包的 arm64 与 universal 怎么选?

先查看设备的处理器架构,而不是只看系统版本。多数较新的 Android 手机使用 arm64,可以优先选择对应安装包;universal 包通常包含多种架构,文件更大,适合无法确认架构且该包确实覆盖设备架构的情况。若提示安装包不兼容,先在系统设备信息或可信的设备规格中核对架构,再回到下载页选择。覆盖安装失败还可能与签名不同、版本回退或存储空间不足有关。不要立即卸载现有应用,先备份配置;卸载可能清除订阅、节点和自定义规则。

复制了订阅地址,为什么导入后没有节点?

先确认执行的是添加订阅,而不是导入单节点。进入订阅管理,检查地址是否完整,去掉复制时带入的空格、换行和说明文字,保存后手动更新一次,再切回对应订阅分组查看。若仍为空,查看更新提示是否为访问失败、解析失败或返回内容为空。返回网页、登录页面或不兼容的订阅格式,都可能导致无法识别节点。向提供方确认该地址是否适用于当前客户端,以及账户是否有效。不要将地址粘贴到陌生的在线转换服务;排查截图也应遮盖路径中的凭据。

Windows、macOS 和 Linux 安装前需要核对哪些信息?

先核对处理器架构与安装包格式。Windows 按下载页说明区分桌面版和经典 WPF 版,并确认系统满足所选版本要求;macOS 在关于本机中查看芯片,分别选择 Apple Silicon 或 Intel 入口;Linux 按发行版的软件包体系选择 deb 或 rpm,再区分 x64 与 arm64。安装包能够下载,不代表与当前系统兼容。遇到系统安全提示时先确认文件来源与提示原因,不要批量关闭安全功能。首次启动后先完成普通代理连接,虚拟网卡和额外权限可在确有需要时再配置。

开启 TUN 时提示权限不足,应该怎么处理?

先保存配置并停止连接,查看日志里是创建虚拟网卡、修改路由还是访问设备时被拒绝。Windows 通常需要按客户端说明以管理员权限运行,或完成相关服务的安装;macOS 与 Linux 的授权方式随版本和打包方式变化,应遵循当前客户端提示,不要照抄其他平台的提权命令。Android 首次连接时需要同意系统 VPN 授权,并检查是否已有其他 VPN 应用占用连接。授权后重新启动相关功能,再确认日志中的权限错误是否消失;不要通过长期关闭系统安全机制来绕过问题。

使用技巧

管理订阅和节点,确认分流规则,退出时恢复网络设置。

订阅更新失败时,应该选直连更新还是通过代理更新?

根据订阅地址的实际可达性选择。当前网络可以直接访问该地址时,先尝试直连更新;只有地址需要经代理访问,且已有可用节点时,再使用通过代理更新。若所有节点已失效,依赖这些节点更新订阅会形成无法恢复的循环,应改用可访问的网络或向提供方取得新的有效地址。更新前记录当前分组和错误提示,更新后核对节点是否确实变化。不要反复快速请求,服务可能有频率限制;也不要把本地无法解析、证书错误和账户到期都当成同一种更新故障。

切换节点时,需要重新导入订阅吗?

通常不需要。先在已有分组中选择目标节点并设为当前连接,再按客户端提示重新连接或重载配置。若只是测试单个节点,不要同时修改路由、DNS 和代理模式,否则难以判断差异来自哪里。订阅更新可能替换节点标识,更新后应确认当前选中项仍然有效,而不是继续引用已移除的条目。对重要的自定义参数,先记录再更新,避免把订阅生成的配置误当成永久保存位置。只有订阅地址更换、原分组损坏或配置格式需要调整时,才考虑重新添加订阅。

怎样让局域网和指定网站直连,其他请求走代理?

先启用适合需求的路由规则集,再核对具体规则的匹配顺序。多数规则按顺序匹配,应将需要优先处理的局域网地址、特定域名等规则放在合适位置,避免被范围更大的规则提前覆盖。域名规则、IP 规则与 DNS 解析策略会相互影响,不能只改一个直连标签就假定所有请求都符合预期。修改后分别测试局域网服务、指定直连网站和代理网站,并在日志允许时查看实际出口。全局代理模式可能改变规则的生效方式,验证分流前应确认当前选择的是对应的规则模式。

退出客户端后,为什么浏览器反而无法联网?

常见原因是系统仍指向已经停止监听的本地代理端口。正常退出前,先在客户端中关闭或清除系统代理,再停止连接。若客户端异常退出,可重新打开客户端清除代理,或进入系统网络设置检查代理开关及地址,移除由此次配置留下的本地代理项。使用 TUN 时还要确认虚拟网卡和路由已恢复,必要时按正常流程重新连接后再关闭。不要删除单位或校园网络要求的固定设置;修改前先记录原值。最后关闭并重新打开浏览器,检查基础网络是否已经恢复。

故障排查

依次检查本地网络、流量入口、远端连接与 DNS,不把启动成功等同于请求成功。

节点测试一直超时,应该先检查哪一步?

先确认普通网络可用,再检查节点地址、端口以及订阅是否过期。区分测试类型:TCP 连接测试失败,可能是目标不可达、端口受限或服务器未监听;真连接测试还会涉及协议握手、TLS、DNS 和测试目标网站。某一种测试超时,不足以单独证明所有应用都无法使用。保留一条配置不变,对照其他已知可用节点,并查看对应时刻的日志。若只有一个节点失败,优先核对该节点与服务端状态;若全部失败,再检查本机防火墙、网络环境、设备时间与内核启动情况。

显示已连接,但网页打不开,怎么逐层排查?

已连接通常只说明本地服务或 VPN 通道已启动,不代表远端请求成功。先查看内核是否正常运行,再确认浏览器请求是否进入客户端;没有请求日志时,优先检查系统代理、浏览器独立代理和本地监听端口。已有请求但连接失败时,核对节点参数、服务器状态及 TLS 错误;域名无法解析时,再检查 DNS 配置和解析服务是否可达。每次只调整一项并重复同一个测试。不要先关闭所有防护或随意替换证书设置,尤其不要把跳过证书验证当作通用修复办法。

系统代理已经开启,为什么有些应用仍然直连?

先确认该应用是否读取系统代理。部分应用使用自带网络设置、独立代理扩展或其他网络接口,开启系统代理并不会自动改变它们的连接方式。可先用遵循系统代理的浏览器做对照,再检查目标应用是否支持单独设置 HTTP 或 SOCKS 代理,并填写客户端实际监听的地址与端口。若应用无法单独配置,再评估 TUN 是否适用,同时核对排除规则和权限。不要为了让本机应用连接而随意开启允许局域网访问;那会扩大监听范围,与本机系统代理是否生效不是同一个问题。

提交日志排查前,应该保留和隐藏哪些内容?

保留故障发生时间、系统与客户端版本、所用内核、代理模式、测试动作,以及出错前后的相关日志行。先停止连接,按同一操作复现一次,再截取较短的日志,通常比整份历史记录更容易定位。分享前隐藏订阅地址、用户标识、密码、访问令牌和可识别个人的信息;截图中的二维码与分享链接也应遮盖。可以描述地址类型和错误类别,而不提供完整凭据。若日志只有启动成功信息,补充实际发起请求后的记录,并说明是全部应用失败,还是仅某个网站或应用异常。