零成本部署自己的IPTV直播源,自动更新告别失效!
面对常规IPTV软件源失效频繁、更换复杂且对老年用户不友好的问题,基于GitHub Actions与Cloudflare Pages的自动化部署方案提供了一种零成本的解决思路。该方案通过iptv-sources项目,利用GitHub仓库自动抓取并更新直播源,经由Cloudflare Pages进行全球分发,实现了免维护、高可用的个人直播服务。
01方案核心优势
- 自动化更新机制
每2小时自动从上游抓取最新数据,确保直播源有效性,告别手动换源。 - 多格式输出支持
提供M3U、TXT、TVBox JSON等多种主流格式,兼容各类播放软件。 - 零成本EPG方案
将节目预告拆分为静态JSON文件并部署,无需自建后端即可在TVBox中查看节目单。 - 完全免费运行
依托GitHub Actions执行抓取任务,Cloudflare Pages提供托管服务,全过程无额外费用。
02Cloudflare Pages部署流程
- 准备项目代码
访问GitHub仓库 iptv-sources 并执行 Fork 操作,将项目复制至个人账号下。 - 创建Pages项目
登录Cloudflare控制台,进入 Workers & Pages 页面,选择“导入现有Git存储库”,授权GitHub并选择Fork的项目。 - 配置构建设置
在构建配置中填写:生产分支设为 main,构建命令填写 pnpm build:static,输出目录填写 m3u,点击保存并部署。
03配置自动更新工作流
为使GitHub Actions能自动将更新发布至Cloudflare Pages,需进行密钥配置与授权。具体步骤如下:
- 获取账户信息
在Cloudflare应用页面右侧复制 Account ID。 - 创建API令牌
点击右上角头像进入配置文件,选择API令牌,使用“编辑Cloudflare Workers”模板,并添加Cloudflare Pages的编辑权限,生成后妥善保存。 - 添加仓库Secrets
回到GitHub项目Settings,在Secrets and variables → Actions中依次新建三个Repository secret:
CLOUDFLARE_API_TOKEN(填入API令牌)
CLOUDFLARE_ACCOUNT_ID(填入账户ID)
PROJECT_NAME(填入Pages项目名) - 触发更新
在GitHub Actions标签页找到 update schedule 工作流,点击 Run Workflow 手动触发首次运行,后续将按计划自动执行。
04直播源与EPG获取
| 资源类型 | 访问地址格式 | 说明 |
|---|---|---|
| 国内源 | https://项目名.pages.dev/youhun.m3u | 主要包含国内央视及各卫视频道 |
| 酒店源 | https://项目名.pages.dev/hotel_tvn.m3u | 酒店专用直播源,内容可能更广泛 |
| 汇总源 | https://项目名.pages.dev/all.m3u | 包含所有类别的直播频道集合 |
| EPG节目单 | 与M3U链接配置方式相同 | TVBox等软件可直接加载查看节目预告 |
部署完成后的资源获取路径
该方案通过自动化部署有效解决了直播源维护难题,适合具备基础Git操作能力的用户。虽然DIY方案在频道数量和稳定性上已有不错表现,但对于电视观看需求极高且追求极致稳定的用户,直接安装运营商提供的官方IPTV服务依然是性价比最高的选择。
当前文章无评论,是时候发表评论了