questions / answers
V2Ray 常见问题,配置与排查
从订阅导入到流量出口,按发生问题的环节查找。先确认应用是否接入客户端,再检查节点、路由与 DNS;每次只调整一项设置。
以下设置名称可能随客户端版本变化。记录错误时保留日志中的错误类型,隐藏订阅地址、身份信息与服务器访问凭据。
basics
基础认知
先分清客户端、内核与节点,再判断设置作用在哪一层。
V2Ray、Xray 与 v2rayN 分别负责什么?
V2Ray 是 Project V 代理生态中的核心项目;V2Fly 延续相关内核开发,Xray 是另一条内核分支。内核负责连接、协议处理、DNS 与路由,v2rayN 则是用于管理配置的图形客户端。桌面端可用 v2rayN,Android 可用采用 Xray 内核的 v2rayNG,或采用 V2Fly 内核的 v2flyNG。界面中添加节点成功,只代表配置被接收,不代表服务器能够连接。排查时先看客户端是否启动内核,再看连接日志;切换内核前要确认节点协议与传输设置受到支持,不能把内核名称当作连接质量指标。
安装客户端后,为什么还需要节点或订阅?
客户端是本地配置与流量转发工具,安装包本身不包含可用的远程服务。节点描述服务器地址、端口、协议、身份信息和传输参数;订阅则是供客户端定期获取一组节点的链接。应从有权使用的服务或自建服务器取得配置,再导入客户端。订阅能被读取与其中节点能否连接是两件事,还需检查服务有效期、服务器状态及当前网络。不要把本地 SOCKS 地址 127.0.0.1 当作远程节点,也不要将订阅链接发到公开截图或讨论区;链接可能携带账户访问标识,应按敏感信息保存。
VMess、VLESS、Trojan 与 Shadowsocks 怎么选?
协议首先由服务器配置决定,而不是在客户端里任选。导入分享链接时,应保留提供方给出的协议、端口、传输方式以及安全层参数。VLESS 节点还可能要求特定的 flow、REALITY 公钥或服务器名称;Trojan 常与 TLS 配合;VMess 与 Shadowsocks 也各有身份和加密参数。仅修改协议下拉框通常会使连接失败,协议名称本身也不能保证速度更快。首次配置优先使用完整链接或二维码,连通后再了解各字段。确需迁移协议时,必须同步调整服务器与客户端,并核对当前内核对所选组合的支持情况。
系统代理、全局模式和 TUN 是同一层设置吗?
这三项分属不同环节。系统代理向应用提供本地代理地址,只有遵循系统代理的程序才会使用它;TUN 通过虚拟网络接口接入流量,通常能覆盖更多不读取系统代理的应用。全局模式则描述进入内核后的路由策略,通常把匹配流量交给代理出口,并不自动接管所有程序。分流模式依据域名或 IP 等规则选择直连、代理或阻断。判断某个应用是否走代理,要先检查流量有没有进入客户端,再检查命中了哪条规则。排查初期先选一种接入方式验证,避免同时调整系统代理、TUN 和路由,导致无法确定变化来自哪里。
installation
安装配置
安装包架构、订阅格式与系统权限,分别检查。
Android 安装包的 arm64 与 universal 怎么选?
arm64 包面向采用 64 位 ARM 架构且系统支持相应应用的设备,通常体积更小;universal 包包含多种受支持架构,适合不确定设备架构时使用。近年主流手机通常可以选择 arm64,但仅凭购买年份或处理器宣传不能完全判断,部分设备仍运行 32 位系统。如果提示应用无法安装,先检查系统版本、剩余空间、现有应用签名与安装权限,再考虑架构问题。升级前保留订阅分组和自定义规则,避免为解决安装冲突直接卸载造成配置丢失。v2rayNG 与 v2flyNG 的安装包要分别选择,不要当作同一应用的两个版本覆盖。
订阅导入失败,应该先检查哪些内容?
先区分订阅地址与单个节点分享链接:订阅地址应放进订阅分组的地址栏,单节点链接应使用剪贴板或分享链接导入入口。在 v2rayN 中保存分组后,还要执行更新订阅;v2rayNG 也需要添加订阅后更新,不能只保存名称。检查复制内容是否完整,去掉首尾空格和换行,确认没有把网页登录地址或说明文字一起粘贴。若日志显示解析失败,返回内容可能是登录页面、错误页面或客户端不支持的配置格式,应向提供方确认。不要通过改名或反复重装来修复格式问题;先用一个已知兼容的节点链接验证导入功能。
已有节点仍能连接,为什么订阅更新失败?
订阅更新访问的是订阅服务地址,与节点连接访问的服务器不一定相同,因此两者可以出现不同结果。先检查链接是否过期、账户状态是否正常,以及日志中的 HTTP 状态或超时信息。若订阅地址只能经代理访问,应先启用一个已知可用的节点,再选择客户端提供的通过代理更新方式;若必须直连访问,则使用直连更新。名称与入口会随客户端版本变化。还要排除系统时间错误、DNS 解析异常和网络登录页干扰。更新失败时保留原有分组,不要先清空全部节点;若返回内容长期为空或格式改变,再向提供方确认订阅格式。
启用 TUN 提示权限不足,怎样处理?
TUN 需要创建虚拟网络接口并调整路由,权限要求比普通本地代理更高。Windows 通常需要按客户端提示以管理员权限启动或配置所需服务;Linux 要检查当前版本的权限方案、虚拟网络设备访问权限及服务状态;macOS 应按系统提示完成相应授权。Android 需要确认系统 VPN 授权,且同时通常只能运行一个 VPN 服务。先关闭其他占用同类接口的工具,再查看客户端日志中的具体错误。不要把所有权限问题都归结为节点不可用,也不要随意改系统文件权限。若暂时无法完成授权,可先用系统代理验证节点,待普通连接稳定后再配置 TUN。
操作步骤:订阅导入教程 · Android 上手说明 · 平台与安装包选择
daily use
使用技巧
代理模式、应用接入与多设备同步,不要只看节点名称。
日常浏览应该用全局模式还是绕过大陆?
日常浏览可从分流模式开始,让需要代理的目标使用代理出口,其余目标按规则直连;绕过大陆通常是按中国大陆域名与 IP 分类安排直连的一种预设,但具体行为取决于客户端的规则集。全局模式适合临时验证代理出口,或需要统一出口的测试场景,不代表所有应用都会自动进入客户端。切换后用同一个目标重新连接,必要时关闭原页面或应用,避免已有长连接保留旧路径。若全局可用而分流不可用,重点检查规则顺序、分类数据和 DNS,而不是立刻更换节点。完成测试后恢复常用策略,减少不必要的流量绕行。
浏览器能上网,终端或开发工具为什么没有走代理?
不少命令行工具不会自动读取桌面系统代理,需要在工具内设置代理地址,或为当前进程配置对应环境变量。先在客户端确认实际监听地址、端口和协议;如果 SOCKS 端口为 10808,可用 curl -x socks5h://127.0.0.1:10808 -I https://www.example.com 验证该入口,端口不同时应同步修改。socks5h 表示将目标域名交给代理端解析,不能与本地解析的行为混为一谈。应用运行于容器或虚拟机时,127.0.0.1 指向它自身,不一定是宿主机。先在宿主机验证连接,再检查隔离环境的网络访问;不要为了省事直接把代理监听开放给所有网络。
允许局域网连接后,其他设备该怎样填写代理?
其他设备应填写运行客户端那台机器的局域网 IP 与对应代理端口,不能填写 127.0.0.1,因为该地址始终指向当前设备自身。v2rayN 中开启允许来自局域网的连接后,还需确认内核监听范围、系统防火墙以及设备之间的网络可达性。路由器访客网络或无线隔离可能阻止访问;HTTP 与 SOCKS 端口也不能任意互换。只在可信网络启用共享,并将防火墙访问范围限制到需要使用的设备或网段,避免向公网暴露入口。连接失败时先验证同一局域网内端口能否访问,再检查节点状态;不用共享时关闭该选项并恢复原监听设置。
v2rayN 与 v2rayNG 如何保持多设备配置一致?
节点列表可以通过同一个订阅地址在各设备分别更新,也可以用单节点分享链接或二维码传递。订阅通常只分发节点,不会同步系统代理、TUN 权限、本地端口和全部路由规则,因此相同节点列表不等于相同流量路径。先统一订阅来源和更新时机,再逐台核对活动节点、分流模式、DNS 与自定义规则。桌面与 Android 的界面和功能支持存在差异,不宜直接互换完整配置文件;导入前应确认格式兼容。分享二维码或备份文件时注意其中的身份信息,避免保存到公开相册或群聊。切换设备后应重新测试,不要仅凭节点名称判断配置已经一致。
troubleshooting
故障排查
按网络、监听入口、节点连接、路由与 DNS 的顺序缩小范围。
节点测试超时,是否说明节点一定不可用?
不一定。TCP 连接测试、实际请求测试和应用访问检查的内容不同,测试目标本身不可达也可能导致超时。先查看内核是否正常启动,再核对节点地址、端口、系统时间与传输参数;TLS 服务器名称、REALITY 公钥或 flow 错误都可能使握手失败。使用一个已知可用的节点和同一测试目标作对照,并尝试另一种正常网络连接,以区分服务端问题与当前网络问题。不要把某次测试结果当作持续可用性的保证,也不要只通过增大超时时间掩盖配置错误。若多个节点同时失败,优先检查本地网络与客户端日志;只有单个节点失败时再向提供方确认。
显示已连接,但网页打不开,按什么顺序排查?
已连接可能只表示内核或 VPN 接口已启动,不代表每个目标请求都成功。先确认本机能正常访问网络并完成网络登录,再检查系统时间、活动节点和客户端日志。随后核对本地监听端口与应用代理设置,使用显式指定代理的请求测试流量能否经过该入口;若该测试成功而浏览器失败,检查浏览器代理扩展和系统设置。若请求进入内核后仍失败,再临时对照全局与分流模式,定位路由或 DNS 问题。TUN 场景还要检查虚拟接口与路由。每次只改一项并保留结果,不要同时切节点、改 DNS 和重置全部规则,否则很难确认有效的修复步骤。
v2rayN 已设置系统代理,为什么应用仍然直连?
先检查客户端设置的代理地址与系统网络设置是否一致,确认对应端口确实在监听。Linux 的不同桌面环境对系统代理支持不同,部分应用只读取自己的设置或环境变量;浏览器扩展也可能覆盖系统代理。用支持显式代理的工具测试入口,若能够连接,说明应继续检查应用接入方式,而不是直接重装内核。还要区分流量没有进入客户端与进入后被路由设为直连,可以结合请求日志判断。确需覆盖不读取系统代理的应用时,再评估 TUN。退出客户端后若网络异常,应恢复系统代理设置;监听已停止而系统仍指向该端口,也会导致应用连接失败。
只有部分域名打不开,DNS 与分流规则怎样检查?
先记录失败的域名与日志错误,区分域名解析失败、连接超时和证书错误。对比全局与分流模式:若仅分流失败,检查是否有靠前的自定义规则把目标送到错误出口,以及 geosite、geoip 分类数据是否与规则兼容。DNS 设置要与流量出口配合,分别关注节点服务器地址的解析和访问目标的解析;浏览器的安全 DNS 也可能采用另一条解析路径。修改后重建连接,必要时清理应用缓存,再测试同一域名。不要长期用 IP 地址代替带 TLS 的域名访问,这可能影响服务器名称与证书验证。若日志涉及 IPv6,还应核对相应网络连通性,避免无依据地同时更改多项 DNS 参数。
排查补充:DNS 设置说明 · 已连接却无法上网的逐项清单