IPTV EPG服务器搭建教程

西风

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

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


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-欧洲）
  

📝更新日志
CHANGELOG.md

🚀 部署步骤

安装、更新、卸载脚本：

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

复制代码

或者

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

复制代码

或者

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

复制代码

手动部署见：

https://gitee.com/taksssss/iptv-tool#手动部署

php网页部署：

下载项目epg目录里的源码到网页目录里即可。

🛠️ 使用步骤

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 地址设置（取消）注释
  

TIPS：

推荐使用.xml.gz，减少网络造成的异常。

不推荐添加太多EPG源，不然重复率太高，一般2~3个相互补充即可。

每6~12小时拉一次即可。

源代码：

https://github.com/taksssss/iptv-tool/archive/refs/heads/main.zip