乐于分享
好东西不私藏

IPTV管理神器:一站式搞定节目单、直播源和台标

本文最后更新于2026-03-13,某些文章具有时效性,若有错误或已失效,请在下方留言或联系老夜

IPTV管理神器:一站式搞定节目单、直播源和台标

对于广大IPTV爱好者而言,管理海量的直播源、匹配精准的节目单(EPG)以及设置美观的台标,往往是一项繁琐而耗时的工作。现在,一款名为“IPTV 工具箱”的开源项目应运而生,它通过强大的功能集成和便捷的 Docker 部署方式,旨在成为您一站式的 IPTV 管理解决方案。

该项目托管在 GitHub 上,地址为:

https://github.com/taksssss/iptv-tool

“IPTV 工具箱”集 EPG 管理直播源管理台标管理于一体,能够完美兼容 DIYP/百川超级直播 以及标准的 xmltv 格式,无论您使用哪种播放软件或设备,都能轻松适配。

核心功能亮点

这款工具箱功能丰富,几乎涵盖了IPTV管理的方方面面,以下是其主要亮点:

  • 📡 强大的格式兼容性:支持生成和返回 DIYP/百川、超级直播以及 xmltv 等多种主流格式的文件,满足不同应用的需求。
  • 🐳 广泛的平台支持:提供 amd64、arm64 和 armv7 架构的 Docker 镜像,无论您使用的是标准服务器、NAS 还是树莓派等设备,都能轻松运行。
  • 📦 轻量化设计:基于 Alpine Linux 构建的 Docker 镜像,压缩后体积仅有约 20MB,对系统资源占用极小。
  • 🗃️ 灵活的数据管理:支持 SQLite 和 MySQL 两种数据库,并内置了 phpLiteAdmin 管理工具,方便用户直接对数据进行查看和操作。
  • 🖼️ 智能台标管理:支持台标模糊匹配,能够自动为您的频道找到合适的 Logo。同时还支持 tvbox 接口,进一步提升兼容性。
  • 一站式直播源聚合与管理:支持聚合 TXT 和 M3U 格式的直播源,并内置了测速校验功能,自动筛选有效源。此外,还支持直播源代理,解决访问性问题。
  • 🔒 全面的访问权限控制:为了保障您的服务安全,工具支持设置 TOKEN、User-Agent 以及 IP 黑白名单来进行访问控制。
  • ⏱️ 高效的缓存支持:集成了 Memcached,并支持外接 Redis,大幅提升数据响应速度,减轻服务器压力。
  • 🔄 精准的频道匹配:支持繁体中文频道匹配、模糊匹配,并可以通过设置频道别名和正则表达式,精准地将您的直播源频道与 EPG 数据对应起来。
  • 自动化的定时任务:内置定时任务功能,可设定时间自动更新 EPG 数据和直播源,确保信息始终保持最新。
  • 🛠️ 便捷的文件管理:集成了 tinyfilemanager 文件管理器,让您可以在网页端轻松管理相关配置文件。
  • 🌐 简洁易用的管理界面:提供了一个直观的网页设置页面,所有配置和操作都可以在浏览器中轻松完成。

如何部署 IPTV 工具箱

部署该工具箱非常简单,官方推荐使用 Docker 进行安装。

方式一:一键部署脚本 (推荐)

对于大多数用户,推荐使用官方提供的一键安装脚本,它能自动完成所有部署工作。只需在您的服务器或设备终端中执行以下任一命令即可:

bash <(curl -Ls https://raw.githubusercontent.com/taksssss/iptv-tool/master/install.sh)

或者(Gitee 源,国内访问更快)

bash <(curl -Ls https://gitee.com/taksssss/iptv-tool/raw/main/install.sh)

或者(jsDelivr CDN 源)

bash <(curl -Ls https://gcore.jsdelivr.net/gh/taksssss/iptv-tool@master/install.sh)

方式二:手动 Docker 部署

如果您更喜欢手动控制,也可以使用标准的 docker run 命令进行部署。

docker run -d --name php-epg \
 -p 5678:80 \
 -v $HOME/epg:/htdocs/data \
 -e PHP_MEMORY_LIMIT=512M \
 -e ENABLE_FFMPEG=false \
 --restart unless-stopped \
 taksss/php-epg:latest

参数说明:

  • -p 5678:80:将容器的80端口映射到主机的5678端口。您可以将 5678 修改为任何您想要的未被占用的端口。
  • -v $HOME/epg:/htdocs/data:将主机的 $HOME/epg 目录挂载到容器内作为数据存储目录。请根据实际情况修改 $HOME/epg 为您希望的路径。
  • -e PHP_MEMORY_LIMIT=512M:设置 PHP 的内存限制,默认为 512M,可根据需要调整。
  • -e ENABLE_FFMPEG=true:如需使用直播源测速等功能,可将此项设置为 true 来启用 ffmpeg 组件。
  • taksss/php-epg:latest:Docker 镜像名称。如果从 Docker Hub 拉取困难,可以替换为腾讯云镜像地址:ccr.ccs.tencentyun.com/taksss/php-epg:latest

快速上手使用指南

部署完成后,按照以下步骤即可轻松配置和使用:

  1. 访问管理页面:在浏览器中打开 http://{您的服务器IP地址}:5678/manage.php

  2. 登录系统:默认密码为空,直接进入即可。建议您在设置中第一时间设置一个管理密码。

  3. 添加EPG源:在管理页面的“EPG 地址”输入框中,添加您需要使用的 EPG 源地址(例如 epg.51zmt.top 等),然后点击“保存配置”。

  4. 获取数据:点击“更新数据”按钮,工具箱会开始从您配置的地址拉取节目单数据。您可以点击“更新日志”查看详细的抓取过程和结果。

  5. 设置定时任务:为了保持数据最新,建议设置一个定时更新任务。通常建议在凌晨1点后开始抓取,每6-12小时更新一次即可。

  6. 测试接口:配置完成后,工具箱会生成多个接口地址供不同软件使用。您可以在浏览器中测试它们是否正常工作:

    • xmltv 接口 (用于 TiviMate, Perfect Player 等): http://{您的服务器IP地址}:5678/index.php
    • DIYP/百川 接口: http://{您的服务器IP地址}:5678/index.php?ch=CCTV1
    • 超级直播 接口: http://{您的服务器IP地址}:5678/index.php?channel=CCTV1
    • tvbox 接口:
      • EPG 地址: "epg":"http://{您的服务器IP地址}:5678/index.php?ch={name}&date={date}"
      • 台标地址: "logo":"http://{您的服务器IP地址}:5678/index.php?ch={name}&type=icon"
  7. 应用到播放器:将 http://{您的服务器IP地址}:5678/index.php 这个地址填入您的 IPTV 播放软件(如 DIYP、TiviMate 等)的 EPG 地址栏中,即可享受自动匹配的节目单了。

重要提示

  • 部分软件可能不支持地址跳转,您可以直接使用静态文件地址:http://{您的服务器IP地址}:5678/t.xml 或压缩格式 http://{您的服务器IP地址}:5678/t.xml.gz

总而言之,“IPTV 工具箱”是一个功能全面、部署简单且高度可定制的强大工具,无论您是 IPTV 的新手还是资深玩家,它都能极大地简化您的管理工作,提升观看体验。

本站文章均为手工撰写未经允许谢绝转载:夜雨聆风 » IPTV管理神器:一站式搞定节目单、直播源和台标

猜你喜欢

  • 暂无文章