AwesomeREA.org

案例

TeddyCloud：可自托管的 Toniebox 云端替代服务器

以可自托管的 C 服务器重新实现 Toniebox 所连接的 Boxine 云服务，使盒子能在本地获取音频、设置和无线下发内容，同时由用户控制哪些数据发往厂商。它可提供并缓存 tonie 音频，把其他音频转换为盒子使用的 TAF 格式，可将请求透传到原云端，并提供网页界面、MQTT 及 Home Assistant 集成。仓库中的 protobuf 定义描述了盒子的 freshness-check、RTNL 日志和 TAF 头部报文。

使用条件与局限

  • 审阅对象为 2026-08-25 的稳定版 master 最新提交，即 v0.7.0 合并提交；tc_v0.7.0 发布于同日打标签，日常开发在 develop 分支进行。项目的安装指南覆盖使用 CC3200、CC3235 或 ESP32 芯片的 Toniebox 1，README 将 Toniebox 2 支持列为计划中。
  • 安装过程具有侵入性，且每台盒子各不相同：项目指南要求用户导出自己盒子的客户端证书、向盒子刷入替代 CA 并重定向其 DNS；服务器还可以在 ESP32 固件转储中提取或注入证书。仓库不提供任何盒子证书、固件或 tonie 音频（相应目录只是空占位），本条目也不提供提取或刷写步骤。dev-sandbox 中预先生成的证书为自签名证书，仅用于本地测试。
  • 构建使用手写的 Makefile、protoc-c 和 C 工具链，并需要 CycloneTCP/SSL/Crypto、cJSON、Opus、Ogg、teddycloud_web 前端及 emsdk 等子模块；Linux 调试构建默认启用 AddressSanitizer 和 UBSan，在 macOS 上推荐使用 Docker 构建。tc_v0.7.0 版附带由 Windows/Linux 发布工作流生成的 amd64 压缩包，并为多个平台发布 Debian、Ubuntu 和 Alpine Docker 镜像。音频流转换使用 ffmpeg。
  • 自定义 tonie JSON 接口的 Python API 测试和 WASM TAF 编码器测试通过 Makefile 目标运行；所审阅的工作流只构建并发布，不运行这些测试。dev-sandbox 提供模拟的 tonie、盒子和 TAF 数据。与真实盒子及 Boxine 云端配合的表现仍属项目报告，本次来源核查未运行任何内容。
  • 采用 GPL-2.0（LICENSE）；内置的 Cyclone 协议栈、Opus、Ogg、cJSON 和 FatFs 保留各自条款。tonie 音频、盒子固件和 Boxine 的服务保留各自权利。所审阅来源未确立任何 AI 或 REA 的使用。

关于此条目

类型
案例
类别
独立重建案例
关联
独立重建项目
目标
固件 · 协议

来源复核于

说明已依据一手来源复核；这不代表已运行验证、经过安全审计或确认兼容。

报告条目过时 建议修正翻译

一手来源

  1. README.md GitHub · toniebox-reverse-engineering/teddycloud · 修订 78c3b38
  2. CONTRIBUTING.md GitHub · toniebox-reverse-engineering/teddycloud · 修订 78c3b38
  3. .gitmodules GitHub · toniebox-reverse-engineering/teddycloud · 修订 78c3b38
  4. Makefile GitHub · toniebox-reverse-engineering/teddycloud · 修订 78c3b38
  5. proto GitHub · toniebox-reverse-engineering/teddycloud · 修订 78c3b38
  6. contrib/certs GitHub · toniebox-reverse-engineering/teddycloud · 修订 78c3b38
  7. dev-sandbox/README.md GitHub · toniebox-reverse-engineering/teddycloud · 修订 78c3b38
  8. tests/test_tonies_custom_json_api.py GitHub · toniebox-reverse-engineering/teddycloud · 修订 78c3b38
  9. .github/workflows/build_release.yml GitHub · toniebox-reverse-engineering/teddycloud · 修订 78c3b38
  10. .github/workflows/publish_docker_matrix_base.yml GitHub · toniebox-reverse-engineering/teddycloud · 修订 78c3b38
  11. LICENSE GitHub · toniebox-reverse-engineering/teddycloud · 修订 78c3b38
  12. https://github.com/toniebox-reverse-engineering/teddycloud/releases/tag/tc_v0.7.0
  13. https://tonies-wiki.revvox.de/docs/tools/teddycloud/setup/

同分区更多条目：固件与硬件

固件与硬件分区全部 29 项资源固件与硬件案例（7）