一、项目简介
LibreTV 是一个开源的 IPTV/影视聚合前端项目,支持 M3U 播放列表、EPG 电子节目单等。它本身是纯前端项目,非常适合用 GitHub Pages + Cloudflare 免费托管。
二、准备工作
- GitHub 账号
注册并登录 GitHub
- Cloudflare 账号
注册并登录 Cloudflare
- 一个自己的域名 (可选,但推荐,后续可接入 Cloudflare)
三、Fork 或下载 LibreTV 项目
- 打开 LibreTV 仓库
- 点击右上角 Fork,将项目复制到你的 GitHub 账号下
- 或者点击 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 会分配一个访问地址,如:
4. 访问测试
- 打开上面的地址,应该可以直接访问 LibreTV 页面
五、绑定自定义域名(Cloudflare 配合)
1. 域名接入 Cloudflare
- 登录 Cloudflare,添加你的域名,按提示更换 DNS 到 Cloudflare 提供的服务器
2. 添加 CNAME 解析
- 进入 Cloudflare → DNS → 添加记录
- 类型选 CNAME
- 名称填你想用的前缀(如 tv),目标填 你的用户名.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,几分钟后自动生效
七、常见问题
- 页面打不开/404?
- 检查 GitHub Pages 设置是否正确,分支和目录是否选对
- 检查 CNAME 解析和 Cloudflare 配置
- HTTPS 不生效?
- Cloudflare SSL/TLS 设置为"完全"或"灵活"
- 等待 DNS 生效
- M3U/EPG 无法加载?
- 检查链接是否可用,是否支持跨域(CORS)