一、项目简介

LibreTV 是一个开源的 IPTV/影视聚合前端项目，支持 M3U 播放列表、EPG 电子节目单等。它本身是纯前端项目，非常适合用 GitHub Pages + Cloudflare 免费托管。

---

二、准备工作

1. GitHub 账号

注册并登录 GitHub

1. Cloudflare 账号

注册并登录 Cloudflare

1. 一个自己的域名

   （可选，但推荐，后续可接入 Cloudflare）

---

三、Fork 或下载 LibreTV 项目

1. 打开 LibreTV 仓库

1. 点击右上角 Fork，将项目复制到你的 GitHub 账号下

1. 或者点击 Code → Download ZIP 下载到本地

---

四、部署到 GitHub Pages

1. 新建仓库（如果是 Fork 可跳过）

• 登录 GitHub，点击右上角 + → New repository

• 填写仓库名（如 libretv），选择 Public，点击 Create repository

2. 上传项目代码

• 如果是 Fork，代码已在你仓库，无需上传

• 如果是本地下载，上传到你的仓库

3. 启用 GitHub Pages

• 进入你的仓库 → Settings → Pages

• Source 选择 main 分支（或 master，以实际为准），目录选择 / (root)

• 保存后，GitHub 会分配一个访问地址，如：

https://你的用户名.github.io/仓库名/

4. 访问测试

• 打开上面的地址，应该可以直接访问 LibreTV 页面

五、绑定自定义域名（Cloudflare 配合）

1. 域名接入 Cloudflare

• 登录 Cloudflare，添加你的域名，按提示更换 DNS 到 Cloudflare 提供的服务器

2. 添加 CNAME 解析

• 进入 Cloudflare → DNS → 添加记录

• 类型选 CNAME

• 名称填你想用的前缀（如 tv），目标填 你的用户名.github.io

• 例如：tv.yourdomain.com → 你的用户名.github.io

3. GitHub Pages 绑定自定义域名

• 仓库 → Settings → Pages → Custom domain，填写你的域名（如 tv.yourdomain.com），保存

• GitHub 会自动生成 CNAME 文件

4. Cloudflare 开启 HTTPS

• Cloudflare → SSL/TLS → 选择“完全”或“灵活”模式，确保 HTTPS 可用

---

六、LibreTV 配置与使用

1. 配置 M3U 播放列表

• LibreTV 支持自定义 M3U 播放列表（可用开源 IPTV 源或自建）

• 你可以在页面设置里添加自己的 M3U 链接

2. 配置 EPG 电子节目单（可选）

• 支持自定义 EPG 链接，提升节目体验

3. 个性化定制

• 你可以修改 index.html、config.js 等文件，定制界面和功能

• 修改后推送到 GitHub，几分钟后自动生效

七、常见问题

1. 页面打不开/404？

• 检查 GitHub Pages 设置是否正确，分支和目录是否选对

• 检查 CNAME 解析和 Cloudflare 配置

1. HTTPS 不生效？

• Cloudflare SSL/TLS 设置为“完全”或“灵活”

• 等待 DNS 生效

1. M3U/EPG 无法加载？

• 检查链接是否可用，是否支持跨域（CORS）