hannes813/tvbutler-rescue

# TVButler 救援指南 在 DVBLogic 关停及其激活服务器下线后，使用 Docker 中的 **TV Mosaic** 让被遗弃的 **DVBLogic TVButler** DVB-C USB 调谐器重获新生。 本仓库**仅包含文档和工具**。它不包含任何 DVBLogic 软件、二进制文件、固件或数据。您需要提供合法获取的 TV Mosaic 副本（从官方 Docker 镜像中拉取）；这里的所有内容只是为了帮助您识别硬件、运行容器、扫描频道，并在其前端部署一个干净的反向代理。 ## 简短说明 TVButler 是一款性能完好的 DVB-C 调谐器，只是其供应商已经消失了。以下三个事实让它处境尴尬： 1. **Linux 内核不会为其绑定任何驱动。** 它需要 DVBLogic 专有的用户空间驱动程序 (`onetv`)，该程序仅在 DVBLink / TV Mosaic 中提供。主流内核 / TVheadend 路线是行不通的。 2. **TV Mosaic Community Edition 无法使用它。** CE 8.x 移除了 DVB 子系统，并且仅支持 IPTV。 3. **在线激活已失效。** 自从 DVBLogic 倒闭（约 2020 年）以来，`secure.dvblogic.com` 一直处于下线状态，因此 TV Mosaic 中的激活步骤永远无法完成。 本仓库在法律允许的范围内为您提供最大的帮助：**运行 TV Mosaic 来扫描您的 TVButler、构建 EPG，并在本地播放/录制。** 请参阅 [docs/ACTIVATION.md](docs/ACTIVATION.md)，了解关于最后一道障碍的客观讨论，以及为什么这里**不**提供开箱即用的解决方案。 ## 包含内容 - [docs/HARDWARE.md](docs/HARDWARE.md) — TVButler 内部的实际构造以及如何识别您的设备 - [docs/SETUP.md](docs/SETUP.md) — 分步指南：检测 → 运行 → 扫描 → 代理 - [docs/FINDINGS.md](docs/FINDINGS.md) — 逆向工程笔记（为什么内核无法绑定，为什么 CE 无法运行） - [docs/ACTIVATION.md](docs/ACTIVATION.md) — 服务器失效问题记录 - [docs/TUNER-SHARING.md](docs/TUNER-SHARING.md) — 针对同一个或多个设备同时运行多个应用程序 - [docker/docker-compose.yml](docker/docker-compose.yml) — 运行官方 TV Mosaic 镜像 - [scripts/detect-tvbutler.sh](scripts/detect-tvbutler.sh) — 在 USB 总线上查找您的设备 - [reverse-proxy/nginx.conf](reverse-proxy/nginx.conf) — 在干净的根路径提供 UI 访问（无 `/web`） ## 刻意排除的内容 - **不包含 TV Mosaic / DVBLink 的二进制文件、库、固件或数据。** 无论是否已经倒闭，这些内容的版权仍归 DVBLogic 所有。您需要自行拉取官方镜像。 - **不包含任何许可证/激活绕过方法。** 出于互操作性目的进行逆向工程是一回事；发布随时可运行的绕过工具则是另一回事——请参阅 [docs/ACTIVATION.md](docs/ACTIVATION.md)。 ## 快速开始 ``` # 在 USB 总线上查找你的 TVButler(s) ./scripts/detect-tvbutler.sh # 启动官方 TV Mosaic container（Docker 会自动拉取 image） docker compose -f docker/docker-compose.yml up -d # 打开 web UI 并扫描你的 cable network # http://:9270/web ``` 完整操作流程请见 [docs/SETUP.md](docs/SETUP.md)。 ## 免责声明 本内容为社区文档，不构成法律建议，且不附属于 DVBLogic 或获得其认可。请仅在您拥有的硬件和软件上使用。关于软件使用及规避技术措施的法律法规因国家/地区而异；您需对自身的合规性负责。 ## 许可证 本仓库中的原创材料（文档、脚本、配置）基于 [MIT License](LICENSE) 发布。它不包含任何受版权保护的第三方软件。

标签：Cutter, Docker, DVB, TV Mosaic, 反向代理, 安全防御评估, 文档, 版权保护, 电视调谐器, 硬件复活, 请求拦截