XRay Connect
返回文章列表
使用指南

XRay Connect
Log 日志与连接问题排查

这篇文章只讲已经能核实的事情:下载、安装、导入配置、设置传输与安全选项、检查连接,以及连不上时先看哪些地方。

2

这款 iOS 应用可读取 v2ray、vmess、vless、xtls、trojan、shadowsocks 配置。连接出现异常时,Log 是排查问题的主要入口。本文围绕 XRay Connect Log 日志查看与连接问题排查展开,说明日志的位置、常见现象以及与其他功能模块的配合方式。

Log 在应用中的位置与作用

应用界面列出 DNS、Route、Inbound、Outbound、Log、Assets 与 TLS allowInsecure 等入口。Log 记录连接过程中的运行信息,包括配置加载、出站连接、域名解析等阶段的事件。与 Assets 管理资源、Route 决定流量走向不同,Log 的作用是呈现过程,帮助用户判断问题发生在哪一环节。

查看日志的基本步骤

  1. 打开 XRay Connect,确认已导入配置。配置可以由网络地址或 Files 文件选择器提供。
  2. 发起连接,复现需要排查的现象。
  3. 进入 Log 模块,查看连接期间产生的记录。
  4. 根据记录判断问题属于配置加载、DNS 解析、出站连接还是 TLS 阶段。
  5. 针对对应模块调整设置,然后再次连接并对比日志变化。

查看日志时应注意时间顺序,先出现的事件往往更接近问题源头。若日志中出现与证书相关的提示,可结合 TLS allowInsecure 选项与应用内指南中 TLS/REALITY 部分进行判断。

常见连接问题的排查思路

连接失败的原因较多,可以按模块逐一排除。先确认配置本身是否完整:从 URL 或 Files 导入的配置若结构不完整,可能在加载阶段就报错。其次检查 Outbound 设置,确认协议类型与参数与配置一致。再次检查 DNS,域名解析失败会直接导致后续连接无法建立。若使用域名连接,还需关注 TLS 相关设置。

对于使用 Route 的用户,规则顺序会影响流量匹配结果。日志中若显示流量进入了非预期的出站,应回到 Route 检查规则。Inbound 负责本地接收,若本地端口被其他应用占用,也可能表现为连接异常。

失败配置的处理与延迟测试配合

XRay Connect 提供 VPN 延迟测试与按延迟排序功能,可用于判断某条配置是否可用。对延迟测试失败的配置,可以先查看 Log,再决定是否删除失败配置。删除后可通过 URL 或 Files 重新导入,保持配置列表整洁,减少排查时的干扰。

需要说明的是,延迟测试结果只反映测试时的连接情况,不能替代对 Log 的详细阅读。延迟低但日志中仍有错误时,应以日志为准继续排查。

日志与 TLS allowInsecure、Assets 的关联

日志中出现证书相关问题,不一定意味着服务器不可用。可先检查所用配置的 TLS 设置,确认是否误开了 TLS allowInsecure。该选项仅用于少数特殊环境,正常连接时建议保持关闭。若 Assets 中缺少必要的资源文件,日志常会给出相应提示。此时需检查 Assets 资源管理,确保所需文件已经就位,或重新导入配置。

应用内指南还涉及故障排查内容,用户翻阅指南时,可对照日志中的错误类型找到对应建议。例如与 REALITY 相关的错误,通常需要检查证书、密钥或目标域名配置,而不是仅调整 Outbound。此类问题如果只凭延迟测试结果,难以定位具体环节。

日志查看的注意事项

在 XRay Connect 中,日志内容会随着连接生命周期更新。若一次连接持续时间较长,日志条目较多,建议从连接发起点开始,找到第一条报错位置。对配置做过修改后,应重新发起连接,才能让日志反映最新设置。若日志出现重复错误,说明问题在同一位置反复发生,应优先处理该部分。

对于需要长期观察的问题,可以在每次连接后保留日志并进行对比。若同一配置在不同时间点表现不一致,可能与网络环境变化有关,而不是应用本身设置错误。此时可以结合 VPN 延迟测试按不同时间点观察,再通过日志确认失败阶段。

通过以上方法,XRay Connect Log 日志查看与连接问题排查就有了清晰路径:先看日志,再逐模块定位,必要时利用延迟测试和删除失败配置来辅助判断。日志是连接问题排查的基础,其他模块的调整都应建立在日志信息之上。

为了让 Log 更有参考价值,建议在每次改动前先记录当前配置来自 URL 还是 Files,以及是否调整过 TLS allowInsecure。这样再次打开 Log 时,可以把新的活动记录与具体改动对应起来。若日志提示与 DNS 有关,就查看 DNS;若提示流量方向异常,就回到 Route、Inbound 或 Outbound;若提示资源问题,再查看 Assets。应用内指南包含 TLS/REALITY 与故障排查说明,阅读时应结合当前版本的字段,而不是把不同配置的名称混在一起。VPN 延迟测试和按延迟排序可以辅助了解配置表现,但不能替代 Log 对错误位置的描述。对反复失败的配置,可使用删除失败配置功能,再从原来的入口重新导入。单次只改变一项设置,能够减少记录混杂,也更容易判断哪一步真正改变了连接结果。

查看 Log 时,先从最早出现的异常开始读,不要只盯着最后一行。配置刚从 URL 或 Files 导入时,如果加载阶段已经出现提示,后面的连接失败可能只是结果。若记录涉及 DNS,就先查看 DNS 设置;若记录涉及路由方向,就查看 Route、Inbound 与 Outbound;若出现资源名称,再转到 Assets。TLS allowInsecure 的调整也要配合 Log 观察,不能只凭主观判断。应用内指南把 TLS/REALITY 与故障排查放在配置说明中,遇到不熟悉的字段时可先按指南的顺序阅读。测试和排序只能辅助比较,真正需要定位时仍应以 Log 记录的过程为依据。

多个配置资源卡片叠放的图形
图示:多个配置资源卡片叠放的图形
手机与导入文件卡片组合的图形
图示:手机与导入文件卡片组合的图形

把 Log 读成时间线

排查时不要只截取最后一条记录。可以从配置载入开始,依次查看 DNS、Route、Inbound、Outbound 与 TLS 相关事件,标出第一次出现异常的位置。这样的顺序有助于区分配置本身的问题和连接过程中的问题,也能避免在没有证据时反复修改多个模块。

如果重新导入配置后现象改变,应保留前后两次记录再比较。Assets、TLS allowInsecure 和应用内指南都可能影响判断,但每一步仍应以 Log 中显示的实际结果为依据。

先把问题分成四段:配置载入、域名解析、规则匹配、出站握手。每段只观察与它对应的记录,能减少把不同原因混到一起。

记录一次可复现的排查

每次检查可以保留四项信息:使用的配置名称、出现异常的时间、Log 中第一条可疑记录,以及随后采取的动作。第二次检查时沿用同一顺序,就能比较问题是否从载入阶段移动到解析或出站阶段。若同时修改多个位置,结果难以归因;因此应先恢复到已知配置,再只调整一个相关选项。对于证书提示,可阅读应用内 TLS/REALITY 指南,并结合 allowInsecure 当前状态判断。Log 的作用是提供过程线索,最终仍要以连接是否按预期工作来判断。