SwiftServer
故障排查

反馈问题

SwiftServer 的诊断信息都在哪里,以及反馈时该带上什么,好让我们一次回复就能解决问题。

几乎所有问题都能靠 SwiftServer 已经收集到的信息定位。这一页说明这些信息放在哪里, 以及该把什么发到 [email protected], 或者发到 Telegram 群组里。 带齐这些内容,大多数反馈一次回复就能解决。

诊断信息在哪里

任何失败的连接,包括仪表板状态、终端、SFTP、端口转发和 Docker:打开失败提示对话框, 里面有事件日志(逐步记录发生了什么)和 SSH 诊断(协议层面的细节)。 两者都是可复制的文本。

终端行为异常(渲染、输入、断开):打开设置 → 终端 → 终端调试日志,复现问题, 再用复制取走日志。它只记录运行时事件,不会记录你的终端内容、选中的文本或剪贴板。

Mosh:断开提示对话框里有专门的 Mosh 诊断一节,包含完整的启动过程和连接日志。

监控数据有问题(卡片不见了、数值为空或不对):最快的诊断方式是自己跑一遍 SwiftServer 用的那条命令,把输出发过来。各平台的命令列在监控问题里。

Docker 面板:面板会明确说出是哪一种失败。处理办法和该发什么, 见 Docker 问题。

其他情况:设置 → 支持 → 查看最近日志是全 App 的日志查看器, 可以按类别(仪表板、终端、SFTP、Docker、小组件等)、级别和机器筛选, 并用复制按钮把筛选出来的那些行原样取走。

最快的路径

设置 → 支持 → 反馈会打开一封已经填好收件人的邮件,里面已经带上了你的 App 版本、 构建号和系统版本,把诊断信息粘进去发出即可。同一节里的加入 Telegram 群组直接通向社区。

一份好的反馈包含

  1. 你做了什么、期望看到什么:一两句话即可。
  2. App 版本和平台:例如「iPhone 上的 2.0.5」,在设置里能查到。
  3. 服务器操作系统:Linux 发行版、macOS 还是 Windows。
  4. 上面各节里的诊断文本,粘贴或截图都行。

每一份反馈我们都会看。如果问题出在这份文档上,也请告诉我们,文档和 App 一样会被修好。

本页内容