一、項目簡介

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）