# iptv-tool

**Repository Path**: taksssss/iptv-tool

## Basic Information

- **Project Name**: iptv-tool
- **Description**: IPTV工具箱， Docker🐳部署，支持EPG管理、直播源管理、台标管理，包含DIYP/百川、超级直播及xmltv格式。
- **Primary Language**: PHP
- **License**: GPL-2.0
- **Default Branch**: main
- **Homepage**: https://hub.docker.com/r/taksss/php-epg/
- **GVP Project**: No

## Statistics

- **Stars**: 46
- **Forks**: 27
- **Created**: 2024-07-14
- **Last Updated**: 2025-09-07

## Categories & Tags

**Categories**: multimedia

**Tags**: PHP, Docker, Epg, IPTV, DIYP

## README

# 📺 IPTV工具箱
<div align="center">

<a href="https://trendshift.io/repositories/12969" target="_blank">
  <img src="https://trendshift.io/api/badge/repositories/12969" alt="IPTV Tool | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/>
</a>

[![GitHub Stars](https://img.shields.io/github/stars/taksssss/iptv-tool?style=social)](https://github.com/taksssss/iptv-tool/stargazers)
[![GitHub Forks](https://img.shields.io/github/forks/taksssss/iptv-tool?style=social)](https://github.com/taksssss/iptv-tool/network/members)
[![GitHub Issues](https://img.shields.io/github/issues/taksssss/iptv-tool)](https://github.com/taksssss/iptv-tool/issues)
[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/taksssss/iptv-tool)](https://github.com/taksssss/iptv-tool/pulls)
[![License](https://img.shields.io/github/license/taksssss/iptv-tool)](https://github.com/taksssss/iptv-tool/blob/main/LICENSE)
![Docker Pulls](https://img.shields.io/docker/pulls/taksss/php-epg)
![Image Size](https://img.shields.io/docker/image-size/taksss/php-epg/latest)
</div>

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

> [!TIP]
> ⚠️ 使用前请仔细阅读「管理页面」底部的[「使用说明」](/epg/assets/html/readme.md)
> 
> 原贴：[【IPTV工具箱】EPG节目单管理、直播源管理、台标管理](https://www.right.com.cn/forum/thread-8386320-1-1.html)
> 
> `xmltv` 用户使用方法：[【一键生成】匹配 M3U 文件的 XML 节目单](https://www.right.com.cn/forum/thread-8392662-1-1.html) 
>
> `直播源管理` 使用方法：[【IPTV工具箱】直播源管理使用说明](https://www.right.com.cn/forum/thread-8417162-1-1.html) 
>
> `自定数据源` 使用方法：[【IPTV工具箱】自定义数据源（timetv、51livetv、diyp）](https://www.right.com.cn/forum/thread-8432214-1-1.html)


## 💻 主要功能

📡 **多格式**：支持返回 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 文件管理器。

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

<picture>
  <source
    media="(prefers-color-scheme: dark)"
    srcset="/pic/management-dark.png"
  />
  <source
    media="(prefers-color-scheme: light)"
    srcset="/pic/management.png"
  />
  <img
    alt="设置页面"
    src="/pic/management.png"
  />
</picture>

> **内置正则表达式说明：**
> - 包含 `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](./CHANGELOG.md)

## TODO：

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

## 🚀 部署步骤

1. 配置 `Docker` 环境

2. 拉取镜像并运行：

   ```bash
   docker run -d \
     --name php-epg \
     -v $HOME/epg:/htdocs/data \
     -p 5678:80 \
     --restart unless-stopped \
     taksss/php-epg:latest
   ```

    > 默认数据目录为 `$HOME/epg` ，根据需要自行修改
    > 
    > 默认端口为 `5678` ，根据需要自行修改（注意端口占用）
    > 
    > 可选参数：`-e PHP_MEMORY_LIMIT=512M` ，设置 PHP 内存限制，默认 `512M`
    > 
    > 可选参数：`-e ENABLE_FFMPEG=true` ，启用 ffmpeg 组件
    > 
    > 无法正常拉取镜像的，可使用同步更新的 `腾讯云容器镜像`（`ccr.ccs.tencentyun.com/taksss/php-epg:latest`）

<details>

<summary>Host 模式部署（IPv6，动态端口）</summary>

为了支持 **IPv6** 或网络直通，推荐使用 `--network host` 方式运行容器。

```bash
docker run -d \
  --name php-epg \
  -v $HOME/epg:/htdocs/data \
  -e HTTP_PORT=5678 \
  -e HTTPS_PORT=5679 \
  --network host \
  --restart unless-stopped \
  taksss/php-epg:latest
```

> 容器会读取环境变量设置端口：`HTTP_PORT` → HTTP，`HTTPS_PORT` → HTTPS。
>
> Host 模式下无需 `-p`，端口直接暴露在宿主机上。
> 
> 确保宿主机对应端口未被占用。

</details>

<details>

<summary>（可选）同时部署 MySQL 、 phpMyAdmin 及 php-epg</summary>

- **方法1：** 新建 [`docker-compose.yml`](./docker-compose.yml) 文件后，在同目录执行 `docker-compose up -d`
- **方法2：** 依次执行以下指令：
    ```bash
    docker run -d \
      --name mysql \
      -p 3306:3306 \
      -e MYSQL_ROOT_PASSWORD=root_password \
      -e MYSQL_DATABASE=phpepg \
      -e MYSQL_USER=phpepg \
      -e MYSQL_PASSWORD=phpepg \
      --restart unless-stopped \
      mysql:8.0
    ```
    ```bash
    docker run -d \
      --name phpmyadmin \
      -p 8080:80 \
      -e PMA_HOST=mysql \
      -e PMA_PORT=3306 \
      --link mysql:mysql \
      --restart unless-stopped \
      phpmyadmin/phpmyadmin:latest
    ```
    ```bash
    docker run -d \
      --name php-epg \
      -v $HOME/epg:/htdocs/data \
      -p 5678:80 \
      --restart unless-stopped \
      --link mysql:mysql \
      --link phpmyadmin:phpmyadmin \
      taksss/php-epg:latest
    ```
 
</details>

## 🆙 版本升级

一键升级
```bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower php-epg --cleanup --run-once
```

自动检测
```bash
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. 点击 `更多设置`，选择是否 `生成xml文件`、`xml内容`，设置`匹配频道列表`
7. 测试各个接口的返回结果是否正确：

- `xmltv` 接口：`http://{服务器IP地址}:5678/index.php`
- `DIYP/百川` 接口：`http://{服务器IP地址}:5678/index.php?ch=CCTV1`
- `超级直播` 接口：`http://{服务器IP地址}:5678/index.php?channel=CCTV1`
- `tvbox` 接口：
  - `"epg":"http://{服务器IP地址}:5678/index.php?ch={name}&date={date}"`
  - `"logo":"http://{服务器IP地址}:5678/index.php?ch={name}&type=icon"`

8. 将 **`http://{服务器IP地址}:5678/index.php`** 填入 `DIYP`、`TiviMate` 等软件的 `EPG 地址栏`

- ⚠️ 直接使用 `docker run` 运行的话，可以将 `:5678/index.php` 替换为 **`:5678/`**。
- ⚠️ 部分软件不支持跳转解析 `xmltv` 文件，可直接使用 **`:5678/t.xml.gz`** 或 **`:5678/t.xml`** 访问。

> **快捷键：**
>
> - `Ctrl + S`：保存设置
> - `Ctrl + /`：对选中 EPG 地址设置（取消）注释

## ☕ Buy Me a Coffee

<picture>
  <source
    media="(prefers-color-scheme: dark)"
    srcset="/pic/buymeacofee-dark.png"
  />
  <source
    media="(prefers-color-scheme: light)"
    srcset="/pic/buymeacofee.png"
  />
  <img
    alt="Buy Me a Coffee"
    src="/pic/buymeacofee.png"
  />
</picture>

[查看捐赠者名单](/DONATIONS.md)

## ⭐ Star History

<picture>
  <source
    media="(prefers-color-scheme: dark)"
    srcset="https://api.star-history.com/svg?repos=taksssss/iptv-tool&type=Date&theme=dark"
  />
  <source
    media="(prefers-color-scheme: light)"
    srcset="https://api.star-history.com/svg?repos=taksssss/iptv-tool&type=Date"
  />
  <img
    alt="Star History Chart"
    src="https://api.star-history.com/svg?repos=taksssss/iptv-tool&type=Date"
  />
</picture>

## 👍 特别鸣谢
- [ChatGPT](https://chatgpt.com/)
- [celetor/epg](https://github.com/celetor/epg)
- [sparkssssssssss/epg](https://github.com/sparkssssssssss/epg)
- [Black_crow/xmlgz](https://gitee.com/Black_crow/xmlgz)
- [112114](https://diyp.112114.xyz/)
- [EPG 51zmt](http://epg.51zmt.top:8000/)
- [fanmingming/live](https://github.com/fanmingming/live)
- [wanglindl/TVlogo](https://github.com/wanglindl/TVlogo)
- [Guovin/iptv-api](https://github.com/Guovin/iptv-api)