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。
快速上手使用指南
部署完成后,按照以下步骤即可轻松配置和使用:
-
访问管理页面:在浏览器中打开
http://{您的服务器IP地址}:5678/manage.php。 -
登录系统:默认密码为空,直接进入即可。建议您在设置中第一时间设置一个管理密码。
-
添加EPG源:在管理页面的“EPG 地址”输入框中,添加您需要使用的 EPG 源地址(例如 epg.51zmt.top 等),然后点击“保存配置”。
-
获取数据:点击“更新数据”按钮,工具箱会开始从您配置的地址拉取节目单数据。您可以点击“更新日志”查看详细的抓取过程和结果。
-
设置定时任务:为了保持数据最新,建议设置一个定时更新任务。通常建议在凌晨1点后开始抓取,每6-12小时更新一次即可。
-
测试接口:配置完成后,工具箱会生成多个接口地址供不同软件使用。您可以在浏览器中测试它们是否正常工作:
- 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"
- EPG 地址:
- xmltv 接口 (用于 TiviMate, Perfect Player 等):
-
应用到播放器:将
http://{您的服务器IP地址}:5678/index.php这个地址填入您的 IPTV 播放软件(如 DIYP、TiviMate 等)的 EPG 地址栏中,即可享受自动匹配的节目单了。
重要提示:
- 部分软件可能不支持地址跳转,您可以直接使用静态文件地址:
http://{您的服务器IP地址}:5678/t.xml或压缩格式http://{您的服务器IP地址}:5678/t.xml.gz。
总而言之,“IPTV 工具箱”是一个功能全面、部署简单且高度可定制的强大工具,无论您是 IPTV 的新手还是资深玩家,它都能极大地简化您的管理工作,提升观看体验。
夜雨聆风