Docs/ 安全/ 遥测与错误报告

遥测与错误报告

使用统计与错误报告:sh0 服务器会向 sh0.dev 发送哪些关于自身的信息,以及何时发送。

概述

使用统计为可选功能,默认关闭,包括从旧版本升级的服务器。在管理员于设置中开启之前,服务器不会发送任何统计数据。

遥测数据包

开启后,服务器会在开启时发送此数据包,之后每天最多发送一次。这是完整的数据包,而非摘录:

POST https://sh0.dev/api/telemetry
{
  "schema": 1,
  "version": "1.10.3",
  "os": "linux",
  "arch": "x86_64",
  "app_count": 4
}
  • schema -- 数据包格式版本,目前始终为 1。
  • version -- 服务器上运行的 sh0 版本。
  • os -- 操作系统(linux 或 macos)。
  • arch -- 处理器架构(x86_64 或 aarch64)。
  • app_count -- 服务器运行的应用数量。

sh0.dev 端点会拒绝任何包含其他字段、缺少字段或格式版本不同的数据包,因此该列表不可能在本页不变的情况下增加。

绝不发送的内容

数据包不包含任何应用名称、域名、IP 地址、环境变量、日志行、电子邮件地址或账户标识。端点仅在内存中使用发送地址进行限流,并且不会保存它。

开启与关闭

在面板中打开“设置”,找到“匿名使用统计”。“查看确切数据包”会显示您的服务器将发送的数据包,它由实际发送的同一段代码生成;在您查看之前,开启按钮保持禁用。关闭后立即停止所有发送。

Note
统计默认关闭:在管理员开启之前,无论是全新安装还是升级后的服务器,都不会发送统计数据包。

与服务器无关,安装脚本会在安装时向 sh0.dev 报告一次操作系统、架构和已安装版本。运行时设置 SH0_NO_TELEMETRY=1 即可跳过该报告。

错误报告

面板侧边栏中的“报告错误”会向 sh0 团队发送报告。您填写标题和描述,并可选择相关应用。只有勾选复选框时才会附上该应用最近 200 行日志。发送之前,面板会显示确切的报告,包括 sh0 版本、操作系统和架构;随后服务器会原样发送该报告。

保留期限

统计数据包存储在专用表中,不含任何实例标识。发送到 sh0.dev 的报告(sh0 服务器的错误报告和 AI 助手的报告)存储在各自的表中。两者均保留 12 个月,之后每天自动删除。