# 不花一分钱，让 TVBox 重新显示直播预告

用 TVBox 看直播的朋友应该都有过这样的体验：明明配置了 EPG 链接，节目预告却死活不显示。换了好几个链接，结果全是挂掉的。去网上搜解决方案，翻来覆去都是让你"自建 EPG 服务"——光看教程就劝退了。

今天分享一个我折腾出来的方案，不用服务器，不用数据库，不用写后端，白嫖 Cloudflare Pages 就能搞定。

## 先说说为什么 EPG 都挂了

EPG 全称 Electronic Program Guide（电子节目指南），就是你在 TVBox 里看到的"现在播什么、接下来播什么"那个功能。

早些年网上有不少好心人维护的公共 EPG 服务，直接填个链接就能用。但这些服务本质上都跑在别人的服务器上——服务器到期了、维护者不想干了、流量扛不住了……各种原因，现在基本都凉了。

## 网上的方案为什么不好用

搜一圈"TVBox EPG"，你会发现清一色都是教你自建：

- 租一台云服务器或者用 NAS
- 装个 MySQL 或 SQLite 存数据
- 跑个后端程序定时去抓节目信息
- 开个 API 接口给 TVBox 调用

说实话，如果你本身就是搞开发的，这些操作确实不难。但对大多数人来说，光是"租服务器"这一步就够头疼了，更别提每个月还得交钱续费。而且万一哪天忘了续费，或者服务器出了问题，EPG 又回到了"啥也不显示"的状态。

有没有一种方案，既不需要服务器，又能一直稳定运行？

## 一个被忽略的 TVBox 特性

答案藏在 TVBox 自己的设计里。

TVBox 的 EPG 链接支持**动态参数替换**。你可以在 URL 里写占位符，TVBox 会在实际请求的时候自动替换成真实的值：

- `{date}` → 当天的日期，比如 `2026-03-18`
- `{name}` → 当前频道名，比如 `CCTV1`

这意味着什么？假设你把 EPG 链接填成：

```
https://xxx.pages.dev/epg/51zmt/{date}/{name}.json
```

当你在看 CCTV1 的时候，TVBox 实际去请求的是：

```
https://xxx.pages.dev/epg/51zmt/2026-03-18/CCTV1.json
```

看到了吗？每次请求的都是一个**固定路径的静态文件**。那我只要提前把每个频道、每天的节目数据存成一个个 JSON 文件，放到能被访问到的地方就行了——根本不需要什么后端服务。

## 具体怎么做的

思路其实很简单，分三步：

**第一步：拿到原始数据。** 上游还是有一些 EPG 数据源在维护的，比如 [51zmt.top](http://epg.51zmt.top:8000/)，它们提供标准的 XMLTV 格式 XML 文件，里面包含了数百个频道的节目预告。

**第二步：拆分成小文件。** 用脚本把一个大 XML 解析开，按"日期 + 频道"的维度拆成独立的 JSON 文件。比如 CCTV1 在 3 月 18 日的节目单，就变成 `epg/51zmt/2026-03-18/CCTV1.json` 这样一个文件：

```json
{
  "channel": "CCTV1",
  "epg_data": [
    { "start": "06:00", "end": "06:30", "title": "朝闻天下" },
    { "start": "19:00", "end": "19:30", "title": "新闻联播" },
    { "start": "19:31", "end": "19:38", "title": "天气预报" },
    { "start": "20:00", "end": "21:00", "title": "焦点访谈" }
  ]
}
```

这恰好就是 TVBox 所需要的 EPG JSON 格式。

**第三步：扔到 Cloudflare Pages 上。** 把这些静态文件部署上去，用户就能通过 URL 直接访问了。配合 GitHub Actions 每 2 小时自动跑一次，数据就能持续保持最新。

整条链路画出来大概是这样的：

```
上游数据源 (XMLTV XML)
       ↓
GitHub Actions 每 2 小时自动触发
       ↓
解析 XML，拆分为 JSON 文件
       ↓
部署到 Cloudflare Pages
       ↓
TVBox 按需请求静态 JSON
```

全程没有数据库，没有后端服务，就是纯粹的静态文件托管。

## 为什么选 Cloudflare Pages

选它的理由很直接——**免费，而且靠谱**。

Cloudflare Pages 的免费套餐没有带宽和请求次数的限制，背后是 Cloudflare 的全球 CDN 网络，国内外访问速度都不错。更重要的是，它不需要你操心任何运维的事：不用续费服务器、不用盯着进程有没有挂、不用半夜爬起来重启服务。

只要 Cloudflare 还在，你的 EPG 服务就在。

## 怎么用

### 直接用

在 TVBox 的配置里，把 EPG 地址改成（按你使用的数据源二选一或自行切换）：

```
https://your-domain.pages.dev/epg/51zmt/{date}/{name}.json
```

若使用本站从 [epg.pw](https://epg.pw/) 聚合的中国地区 EPG，可改为：

```
https://your-domain.pages.dev/epg/epg_pw/{date}/{name}.json
```

把 `your-domain.pages.dev` 替换成实际可用的域名就行。频道名需与 JSON 文件名一致，否则 TVBox 无法匹配到对应文件。

如果你用的是 TVBox 的 JSON 配置格式，加一个 `epg` 字段：

```json
{
  "lives": [
    {
      "group": "Channels",
      "channels": [
        {
          "name": "CCTV1",
          "urls": ["http://your-iptv-source-url"]
        }
      ]
    }
  ],
  "epg": "https://your-domain.pages.dev/epg/51zmt/{date}/{name}.json"
}
```

保存，重启 TVBox，进入直播频道后就能看到节目预告了。

### 自己部署一套

如果你想完全掌控自己的 EPG 服务，也很简单：

1. Fork 笔者自己做的开源项目 [whyun-pages/iptv-sources](https://github.com/whyun-pages/iptv-sources) 到你的 GitHub 账号
2. 去 Cloudflare Pages 关联这个仓库
3. 剩下的交给自动化——GitHub Actions 每 2 小时抓一次数据，Cloudflare Pages 自动部署

全过程不花一分钱，部署完就不用再管了。




用 TVBox 看直播的朋友应该都有过这样的体验：明明配置了 EPG 链接，节目预告却死活不显示。换了好几个链接，结果全是挂掉的。去网上搜解决方案，翻来覆去都是让你"自建 EPG 服务"——光看教程就劝退了。

不花一分钱，让 TVBox 重新显示直播预告

利用 TVBox 的动态参数替换特性 + Cloudflare Pages 静态托管 + GitHub Actions 自动化，实现无需服务器、完全免费的 EPG 服务。

前端

音视频

客户端

免费解决TVBox直播预告不显示问题！无需服务器，利用Cloudflare Pages托管静态EPG数据，通过GitHub Actions自动更新节目单。只需修改TVBox配置中的EPG链接，即可稳定显示各频道节目预告，完全零成本运维。

云服务器

数据库

服务器

SQLite

GitHub

MySQL

JSON

4核4G3M云服务器 新用户低至38元/年！

2026新春采购季

tencentdb-catalog

腾讯云数据库特惠，新用户首单0.5折起


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

不花一分钱，让 TVBox 重新显示直播预告-腾讯云开发者社区-腾讯云

不花一分钱，让 TVBox 重新显示直播预告

不花一分钱，让 TVBox 重新显示直播预告

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐