🏠 Watch TV in Your Home

IPTV，一个在家看电视的现代解决方案

📺 几个必要知道的概念

• IPTV 是什么？

  • IPTV（Internet Protocol Television）是一种通过互联网协议传输电视信号的技术。与传统的有线电视不同，IPTV 不依赖射频或卫星信号，而是通过网络直接传输视频流。
  • 你只需要一个播放器（如 VLC、Kodi、TiviMate 或电视盒子应用），就能观看直播频道、点播电影或回看节目。

• IPTV 的优势包括：

  • ✅ 全球频道：可观看来自不同国家的直播源
  • 🔁 随时点播：支持节目回看和点播内容
  • 📱 多设备支持：手机、平板、电脑、电视都能看
  • 🧠 智能化推荐：部分服务支持自定义频道和EPG（电子节目指南）

• M3U 是什么？

  • M3U 是 IPTV 常用的播放列表格式，全称是 Moving Picture Experts Group Audio Layer 3 URL。

  • 它本质上是一个纯文本文件，列出了媒体流（视频或音频）的链接地址。

  • 一个简单的 M3U 文件示例：

  #EXTM3U
  #EXTINF:-1 tvg-id="cctv1" tvg-name="CCTV-1 综合" group-title="央视",CCTV-1 综合
  http://example.com/live/cctv1/index.m3u8
  #EXTINF:-1 tvg-id="bbc" tvg-name="BBC World" group-title="News",BBC World
  http://example.com/live/bbc/index.m3u8

• 常见 M3U 文件中会包含：

  • 频道名称
  • 频道分组
  • 频道Logo
  • EPG 节目指南信息
  • 视频流地址
  • 播放器读取这些信息后，就能自动生成可浏览的频道列表。

🌐 M3U 从哪里得到？

公开 IPTV 源（免费） 网络上存在许多免费共享的 IPTV 源，它们通常更新频繁但稳定性不高。例如：

• iptv-org

• freeiptv

• Github 搜索关键词 “m3u playlist”

• 付费服务

  • 一些专业 IPTV 提供商提供更稳定的服务、完整的 EPG 数据和高清流。通常需要月费或年费。

自建流媒体源 如果你有 NAS、媒体服务器（如 Jellyfin、Plex、Emby），可以通过插件或转码功能将视频内容转换为 M3U 格式，实现自家频道定制。

🐳 用 Docker 部署 IPTV 播放环境 (获取M3U资源)

• 可以使用这个项目的Docker，进行部署。

  • 这是一个可高度自定义的IPTV接口更新项目📺，自定义频道菜单，自动获取直播源，测速验效后生成可用的结果，可实现『✨秒播级体验🚀』

  • 1. 拉取镜像

    docker pull guovern/iptv-api:latest

  • 2. 运行容器

    docker run -d -p 8000:8000 guovern/iptv-api

  • 3. 挂载（推荐）：

    -v /etc/docker/config:/iptv-api/config
    -v /etc/docker/output:/iptv-api/output

  • 4. 更新之后的API接口

    接口	描述
    /	默认接口
    /m3u	m3u 格式接口
    /txt	txt 格式接口
    /ipv4	ipv4 默认接口
    /ipv6	ipv6 默认接口
    /ipv4/txt	ipv4 txt接口
    /ipv6/txt	ipv6 txt接口
    /ipv4/m3u	ipv4 m3u接口
    /ipv6/m3u	ipv6 m3u接口
    /content	接口文本内容
    /log/result	有效结果的日志
    /log/speed-test	所有参与测速接口的日志

  • 实际情况

    • 容器正常运行之后，大概需要扫描2到3个小时，把所有的频道找到
    • 找到容器映射到局域网内的端口
    • 使用Postman进行尝试连接，访问正常
    • 使用APTV或其他的播放器添加M3U链接，一切正常
    • 播放正常

🗃️ 推荐使用的一些客户端播放器

• Apple生态（涵盖iOS/iPadOS/macOS/tvOS）

  • APTV

• Android生态（涵盖Android手机、平板、电视）

  • Tivimate
  • Kodi