（2025.07.04）【IPTV工具箱】EPG节目单管理、直播源管理、台标管理

TakSSS

项目仅限个人使用，用于牟利的请出门左转。

开源地址：https://github.com/taksssss/iptv-tool、https://gitee.com/taksssss/iptv-tool

☕捐赠入口 🌹捐赠鸣谢列表

反馈交流群：712189556

IPTV 工具箱， Docker🐳 部署，支持 EPG 管理、直播源管理、台标管理，兼容 DIYP/百川、 超级直播以及 xmltv 格式。

⚠️ xmltv用户使用方法见：【一键生成】匹配 M3U 文件的 XML 节目表
⚠️ 直播源管理使用方法见：【IPTV工具箱】直播源管理使用说明
⚠️ 自定数据源使用方法见：【IPTV工具箱】自定义数据源（timetv、51livetv、diyp）

⚠️ 台标匹配 需搭配 酷9APP 使用：【台标大整合】酷9方案，2700+频道，带频道别名
⚠️ 推荐EPG源：【EPG节目单】国内镜像（含112114、51zmt、erw、epg.pw、livednow……）
⚠️ TVMAO 接口说明：【IPTV工具箱】 BDTVMAO 接口说明
⚠️ CNTV 接口说明：【IPTV工具箱】 CNTV 接口说明

💻 主要功能

📡 多格式：支持返回 DIYP/百川、超级直播以及 xmltv 格式文件。

🐳 多架构：提供 amd64、arm64 和 armv7 架构的 Docker 镜像。

📦 小体积镜像：基于 Alpine 构建，压缩后仅 20 MB。

🗃️ 数据库管理：支持 SQLite 和 MySQL 数据库，内置 phpLiteAdmin 管理工具。

🖼️ 台标管理：支持台标模糊匹配，支持 tvbox 接口。

➰ 直播源管理：支持聚合 TXT/M3U 直播源、测速校验。

🔒 访问权限控制：支持设置 TOKEN 、User-Agent、IP 黑白名单。

⏱️ 缓存支持：集成 Memcached，支持 Redis。

🔄 频道匹配：支持繁体中文频道匹配、模糊匹配；支持频道别名、正则表达式。

⏳ 定时任务：支持定时更新数据。

📝 节目单生成：支持生成指定频道节目单并匹配 M3U 的 xmltv 格式文件。

🗂️ 兼容多种格式：支持不同标准格式的 XMLTV 文件，支持自定义数据源。

🛠️ 文件管理：集成 tinyfilemanager 文件管理器。

🌐 界面设置：包含简单易用的网页设置页面，便于操作和管理。

内置正则表达式说明：

包含 regex:

示例：

• CCTV$1  =>  regex:/^CCTV[-\s]*(\d{1,2}(\s*P(LUS)?|[K\+])?)(?![\s-]*(美洲|欧洲)).*/i ：将 CCTV 1综合、CCTV-4K频道、CCTV - 5+频道、CCTV - 5PLUS频道 等替换成 CCTV1、CCTV4K、CCTV5+、CCTV5PLUS（排除 CCTV4 美洲 和 CCTV4-欧洲）
  

📝 近期更新日志
2025-07-04：
1. ✨新增：直播源跟随 EPG 同步更新支持所有配置
2. ✨新增：更新 EPG 时统计跳过节目数量
3. ⚡优化：直播源 default 配置名称及访问地址
4. ⚡优化：直播源台标匹配逻辑
5. ⚡优化：清除直播源缓存数据后重新解析
6. ⚡优化：README.md
7. ⚡优化：捐赠鸣谢列表
8. 🐛修复：数据丢失时直播源配置显示异常

2025-06-28：
1. ✨新增：支持管理多套直播源（新建、另存、删除）
2. ✨新增：云南地方频道台标
3. ⚡优化：直播源数据从 csv 文件迁移至数据库
4. ⚡优化：访问日志从 log 文件迁移至数据库
5. ⚡优化：更新 EPG 时尝试显示 xml 文件修改时间
6. ⚡优化：EPG 下载失败判断逻辑
7. ⚡优化：EPG 下载失败时提示错误信息
8. ⚡优化：直播源测速逻辑，避免进行多次测速
9. ⚡优化：超长直播地址显示效果
10. ⚡优化：捐赠鸣谢列表
11. 🐛修复：「频道匹配结果」繁简匹配显示异常（#93）

2025-06-14：
1. ✨新增：自定义数据源：【IPTV工具箱】自定义数据源（timetv、51livetv、diyp）
2. ✨新增：台标模糊匹配接口（可用于 tvbox 壳："logo":"http://{服务器IP地址}:5678/index.php?ch={name}&type=icon"）
3. ⚡优化：关闭繁體转简体时进行提醒
4. ⚡优化：README.md
5. ⚡优化：捐赠鸣谢列表

2025-06-11.fix：
1. ⚡优化：关闭繁體转简体后的频道匹配逻辑
2. 🐛修复：繁简转换「仅频道名」实际效果为「所有信息」

2025-06-11：
1. ⚡优化：禁止直接访问 update.php，防止流量异常
2. 🐛修复：无节目表频道台标匹配异常

2025-06-09：
1. ✨新增：直播源黑白名单支持分组（URL #FT=频道名1, 分组2, 直播地址3）
2. ✨新增：EPG 源支持修正时区（#TZ=+0000` 或 `#timezone=+0000）
3. ✨新增：IP 列表支持通配符（192.168.1.*）及 CIDR 格式（192.168.1.0/24）
4. ✨新增：Redis 缓存设置（更多设置 - 数据缓存，感谢[mxdabc](https://github.com/mxdabc)）
5. ✨新增：直播源解析失败错误信息
6. ⚡优化：访问统计表新增拒绝次数
7. ⚡优化：MySQL 数据库设置
8. ⚡优化：节目表数据来源支持点击跳转
9. ⚡优化：index.php 默认返回 t.xml.gz 文件
10. ⚡优化：“限定频道列表”改为“匹配频道列表”（生成 xml 时使用该信息进行模糊匹配，可用于繁体频道匹配，更多设置 - 匹配频道列表）
11. ⚡优化：使用说明
12. ⚡优化：捐赠鸣谢列表
13. 🐛修复：Token、User-Agent 空行导致限制失效
14. 🐛修复：缓存服务异常

2025-06-01：
1. ✨新增：访问统计表
2. ✨新增：拦截记录、xmltv 下载记录
3. ✨新增：IP 黑名单、白名单（更多设置 - IP 列表）
4. ✨新增：频道忽略字符（频道管理 - 频道忽略字符，  为空格）
5. ✨新增：Token、User-Agent 支持正则表达式（前缀 regex:）
6. ✨新增：Token、User-Agent 管理 EPG 时，对 xmltv 也生效（:5678/t.xml?token=xxx）
7. ⚡优化：Token、User-Agent 设置方式，改为一行一个
8. ⚡优化：直播源访问地址（:5678/tv.m3u?token=xxx）
9.  ⚡优化：xmltv 多 display-name 兼容性（如 APTV）
10. ⚡优化：访问日志加载逻辑，避免重复下载
11. ⚡优化：大文件下载成功率
12. ⚡优化：频道别名匹配逻辑
13. ⚡优化：关闭繁體转简体后的频道匹配逻辑
14. ⚡优化：更新 EPG 时清理过期访问日志
15. ⚡优化：移除DIYP、超级直播的 sub-title 字段
16. ⚡优化：使用说明
17. ⚡优化：捐赠鸣谢列表
18. 🐛修复：繁体频道别名匹配异常
19. 🐛修复：以 [] 开头/结尾的频道别名识别错误
20. 🐛修复：EPG、直播源黑白名单大小写匹配异常
21. 🐛修复：Memcache 缓存导致内外网台标地址异常

2025-05-20：
1. ✨新增：直播源管理页面支持频道搜索
2. ✨新增：直播源管理页面单页显示条数
3. ✨新增：直播源管理页面高度调节
4. ✨新增：关闭频道名繁简转换（更多设置 - 繁體转简体）
5. ✨新增：清除、下载访问日志
6. ✨新增：更新数据时显示 .xml.gz 文件修改时间
7. ⚡优化：文件下载失败重试机制及提示
8. ⚡优化：DIYP、超级直播接口数据格式化
9. ⚡优化：移除 DIYP、超级直播接口的 `source` 字段
10. ⚡优化：部分页面样式、页面标题
11. ⚡优化：使用说明
12. ⚡优化：捐赠入口
13. ⚡优化：捐赠鸣谢列表

2025-05-13：
1. ✨新增：调试模式（更多设置 - 调试模式）
2. ✨新增：直播源黑白名单支持直播地址（URL #FT=频道名1, 直播地址2）
3. ✨新增：页面底部鸣谢列表
4. ⚡优化：更新日志节目数量从天数改为条数
5. ⚡优化：部分页面样式
6. ⚡优化：使用说明
7. ⚡优化：捐赠鸣谢列表
8. 🐛修复：开关同步测速校验后，需重启定时任务才生效
9. 🐛修复：设置多个 Token 时访问地址显示异常

2025-05-10：
1. ✨新增：测速校验间隔周期倍率
2. ✨新增：直播源新增频道黑白名单（URL #FT=白名单 / #FT=!黑名单 / #filter=）
3. ✨新增：直播源频道黑白名单支持模糊匹配、简繁匹配
4. ⚡优化：直播源选项设置方法（PF/prefix、UA/useragent、RP/replace、FT/filter）
5. ⚡优化：EPG 频道黑白名单设置方法（URL #FT=白名单 / #FT=!黑名单 / #filter=）
6. ⚡优化：EPG 频道黑白名单支持简繁匹配
7. ⚡优化：手动更新 EPG 数据时，不进行测速
8. ⚡优化：移除 xmltv 文件中的 icon 字段
9. ⚡优化：定时任务日志
10. ⚡优化：使用说明
11. ⚡优化：捐赠鸣谢列表
12. 🐛修复：生成 xmltv 文件时部分字段多次转义

2025-04-29：
1. ✨新增：输入框高度调节
2. ✨新增：直播源模板使用正则表达式时支持匹配繁体频道
3. ✨新增：EPG 支持 sub-title 字段
4. ⚡优化：直播源检测逻辑
5. ⚡优化：TXT 源解析逻辑，避免 URL 后的逗号被去掉
6. ⚡优化：直播源备注生成逻辑
7. ⚡优化：清除直播源修改记录逻辑
8. ⚡优化：EPG 编码兼容性
9. ⚡优化：使用说明
10.⚡优化：捐赠鸣谢列表

2025-04-14：
1. ✨新增：直播源内容替换（URL #RP=a1->b1,a2->b2）
2. ✨优化：直播源参数设置方法（URL #PF=前缀#UA=自定义UA#RP=a->b）
3. ✨优化：EPG 源自定义 UA 设置方法（URL #UA=自定义UA）
4. ✨优化：台标匹配逻辑，避免 4K 频道匹配到普通频道
5. ✨优化：模糊匹配时，中英文字符串长度比较逻辑
6. ✨优化：M3U 文件判断逻辑
7. 🐛修复：打开管理页面时，直播源更新时间误刷新
8. 🐛修复：线路备注选单个时，另一个也会带备注

2025-04-10：
1. ✨新增：直播源模板在模糊匹配时支持正则表达式（前缀regex:）
2. ✨新增：生成直播源更新时间
3. ✨新增：优先读取 M3U 台标
4. ⚡优化：部分界面
5. ⚡优化：使用说明

完整更新日志：
CHANGELOG.md

安装指令：

1. docker run -d --name php-epg -v /etc/epg:/htdocs/data -p 5678:80 --restart unless-stopped taksss/php-epg:latest

复制代码

⚠️小雅Alist用户：自行将 5678 改成其他可用端口
⚠️如果网络异常，请使用腾讯云容器镜像地址：

游客，如果您要查看本帖隐藏内容请回复

升级指令：

1. docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower php-epg --cleanup --run-once

复制代码

TODO：

• [已完成] 支持返回超级直播格式
• [已完成] 整合更轻量的 alpine-apache-php 容器
• [已完成] 整合生成 xml 文件
• [已完成] 支持多对一频道映射
• [已完成] 支持繁体频道匹配
• [已完成] 仅保存指定频道列表节目单
• [已完成] 导入/导出配置
• [已完成] 频道指定EPG源
  

• [已完成] 生成台标信息
• [已完成] 直播源管理
  

🚀 部署步骤

1. 配置 Docker 环境

2. 拉取镜像并运行：

1. docker run -d --name php-epg -v /etc/epg:/htdocs/data -p 5678:80 --restart unless-stopped taksss/php-epg:latest

复制代码

默认数据目录为 /etc/epg ，根据需要自行修改

默认端口为 5678 ，根据需要自行修改

可选参数：-e PHP_MEMORY_LIMIT=512M ，设置 PHP 内存限制，默认 512M

可选参数：-e ENABLE_FFMPEG=true ，启用 ffmpeg 组件

（可选，不熟悉的直接忽略即可） 同时部署MySQL、phpMyAdmin及php-epg：https://gitee.com/taksssss/iptv-tool#-部署步骤

🆙 版本升级
一键升级：

1. docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower php-epg --cleanup --run-once

复制代码

自动升级（每小时检测一次）：

1. docker run -d --name php-epg-update -v /var/run/docker.sock:/var/run/docker.sock --restart unless-stopped containrrr/watchtower php-epg --cleanup --interval 3600

复制代码

🛠️ 使用步骤

1. 在浏览器中打开 http://{服务器IP地址}:5678/manage.php
2. 默认密码为空，根据需要自行设置
3. 添加 `EPG 源地址`， GitHub 源确保能够访问，点击 `更新配置` 保存
4. 点击 `更新数据库` 拉取数据，点击 `数据库更新日志` 查看日志，点击 `查看数据库` 查看具体条目
5. 设置 `定时任务` ，点击 `更新配置` 保存，点击 `定时任务日志` 查看定时任务时间表
    >
    > 建议从 `凌晨1点` 左右开始抓，很多源 `00:00 ~ 00:30` 都是无数据。
    > 隔 `6 ~ 12` 小时抓一次即可。
    >
6. 用浏览器测试各个接口的返回结果是否正确：
    - `xmltv` 接口： `http://{服务器IP地址}:5678/index.php`
    - `DIYP&百川` 接口： `http://{服务器IP地址}:5678/index.php?ch=CCTV1`
    - `超级直播` 接口： `http://{服务器IP地址}:5678/index.php?channel=CCTV1`
7. 将 http://{服务器IP地址}:5678 填入 DIYP、TiviMate 等软件的 EPG 地址栏
    - ⚠️ 直接使用 `docker run` 拉取镜像的话，可以将 `:5678/index.php` 替换为 `:5678/`。
    - ⚠️ 部分软件不支持跳转解析 `xmltv` 文件，可直接使用  `:5678/t.xml.gz` 或 `:5678/t.xml`访问。

快捷键：

• Ctrl + S：保存设置
• Ctrl + /：对选中 EPG 地址设置（取消）注释
  

隐藏内容包含源代码、推荐EPG源地址、推荐直播源，回复可见。

游客，如果您要查看本帖隐藏内容请回复

发帖注意事项

请勿胡乱发帖：https://www.right.com.cn/forum/thread-8307840-1-1.html 账户手机验证：https://www.right.com.cn/forum/home.php?mod=spacecp&ac=plugin&id=jzsjiale_sms:home

son0228

谢谢楼主的分享,

0po98i

谢谢楼主的分享,

wo389958895

多谢提醒了      

非常雪亮

带配置页面，已开源】

glysdddsb

基金迷哦名叫欧美咯目录

幽幽一客

研究研究研究研究研究

yxxy

谢谢楼主分享     

yangjie138

正需要，谢谢楼主无私的分享

kkkpep

研究研究一下

master云

有docker版吗？

winrjfx

什么样子的

gf101xt

谢谢分享啊！

towu

支持支持支持