Chinachu/Mirakurun

这是什么？

核心功能

• 01提供基于 Swagger / OpenAPI 2.0 文档的 HTTP RESTful API。
• 02管理调谐器进程，单次调谐可输出多路流。
• 03支持客户端之间的流优先级设置。
• 04解析 MPEG-2 TS 流与实时 EPG 数据。
• 05支持自动频道扫描。
• 06提供输出 M3U8 播放列表与 XMLTV 的 IPTV 服务。

适用场景

• 在 Linux 服务器上搭建日本数字广播的家庭录像或电视录制后端。
• 为本地网络中的 IPTV 客户端提供直播与节目表数据。
• 让多个客户端应用共享同一块调谐器卡。
• 在 Docker 容器中部署调谐器服务器。

快速上手

1. 1

   从 Docker Hub 拉取 chinachu/mirakurun 镜像

2. 2

   按照安装指南（doc/Platforms.md）配置你的调谐器设备

使用前须知

• !专为日本数字电视调谐器设计，没有兼容的调谐器硬件则用处有限。
• !安装面向 Linux 和 Docker，README 中没有 Windows 或 macOS 的安装方式。
• !需要配置调谐器设备，详细指南位于单独的文档中。

收录于专题

标签

常见问题

Mirakurun 是什么？

面向日本数字电视调谐器的 TypeScript API 服务器，运行于 Linux 与 Docker，提供流媒体、EPG 与 IPTV 输出。 Mirakurun 是一个控制日本数字电视调谐器硬件的服务器，通过 HTTP API 对外提供访问能力。它作为调谐器设备与客户端应用之间的中间层运行，负责调谐器进程管理，使多个消费者可以共享同一次调谐。

Mirakurun 可以免费使用吗？用的什么许可证？

Mirakurun 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

Mirakurun 还在维护吗？

活跃维护中。Mirakurun 最近一次提交是在 2026年11月6日。

Mirakurun 适合用来做什么？

在 Linux 服务器上搭建日本数字广播的家庭录像或电视录制后端。 为本地网络中的 IPTV 客户端提供直播与节目表数据。 让多个客户端应用共享同一块调谐器卡。 在 Docker 容器中部署调谐器服务器。

Mirakurun 怎么安装和运行？

从 Docker Hub 拉取 chinachu/mirakurun 镜像 按照安装指南（doc/Platforms.md）配置你的调谐器设备

在哪里获取 Mirakurun？

源代码和安装说明在 GitHub 上：https://github.com/Chinachu/Mirakurun