连接和路由故障排除

在更改超时、服务器信任或系统设置之前查找路径的哪一部分发生故障。

从失败层开始

正确读取连接状态

正在连接表示连接仍在建立；已连接描述 SSH/配置的状态，并不代表所有远程目标都接受连接。某个目标失败时，应结合它的错误信息和耗时排查。

蓝色/红色连接路径箭头说明方向和状态，而不是测量的吞吐量。流量总计包括 SSH 协议开销。暂时阻止的连接可以在其转发流量被阻止时保持建立。

检查日志

打开 日志，搜索连接配置或相关对象，然后过滤类别/级别。选择一行以检查详细信息。 自动滚动和自动换行影响可读性；它们不会改变连接行为。

对于透明代理，还请检查代理页面的日志和活动连接。关联源、应用程序、目的地、规则/代理、协议和时间。空的过滤结果意味着没有匹配的日志条目，不能证明连接成功。

尽可能仅导出相关时间范围。在将导出的日志发送给支持人员之前，检查导出的日志中的私有地址、用户名、路径、令牌和其他敏感内容。

常见转发问题

• 地址已在使用中： 另一个监听器拥有该端口。选择一个未使用的高位端口；不要盲目杀死不明进程。
• 远程绑定仍然环回： 向服务器管理员询问 GatewayPorts clientspecified 和其他转发限制。
• 错误的目的地： 请记住，本地转发的远程地址是从 SSH 服务器解析的，而远程转发的本地目标是从您的 Mac 到达的。
• 只有一个映射失败： 检查该行的监听器/目标和错误的行号。
• 保存的更改无效： 保存后重新连接；现有流可以保留其原始路由决策。

局域网和移动应用程序

正常工作的手机浏览器并不意味着所有手机应用程序都使用其手动 HTTP 代理。应用商店、下载、后台服务和QUIC可以使用不同的路径。首先确定请求是否到达 Mac 以及它匹配哪条规则。

对于 SOCKS5 UDP，保持客户端的 TCP 控制连接打开。 Python 进程不必从 SSH 启动时永久可见； UDP 转发时使用该中继。仅短连接和正常关闭并不能证明存在故障。

安全地报告问题

在信息页面选择反馈问题。提供应用和 macOS 版本、连接类型、预期与实际行为、大致失败时间，并附上已脱敏的相关日志及应用窗口截图。

切勿包含密码、私钥、身份验证代码、颁发的许可证、真实备份或可用的二维码/密码对。提交前请参阅问题模板的安全提醒。