iptv

KO | EN

gitlite — search

#javascript #ai #rust #deep-learning #linux #docker #awesome #cli #kubernetes #vue #mcp #ios #openai #open-source

(★ 413)

基于 Docker 的 IPTV 直播源管理与分发系统：可视化后台、咪咕源抓取（含体育赛事/EPG），支持外部源管理与 m3u txt 订阅；内置纬来体育、Red Bull、4K 卫视及港澳台等，开箱即用。

iptv 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# iPTV-Docker

[![GitHub](https://img.shields.io/badge/GitHub-akiralereal/iptv-181717?logo=github&logoColor=white&style=for-the-badge&logoSize=auto)](https://github.com/akiralereal/iptv)
[![Docker Hub](https://img.shields.io/badge/Docker%20Hub-akiralereal/iptv-2496ED?logo=docker&logoColor=white&style=for-the-badge&logoSize=auto)](https://hub.docker.com/r/akiralereal/iptv)
[![GitHub Sponsors](https://img.shields.io/badge/Sponsor-%E2%9D%A4-EA4AAA?logo=githubsponsors&logoColor=white&style=for-the-badge)](https://github.com/sponsors/akiralereal)

### ☕ 打赏支持 / Buy Me a Coffee

> 如果这个项目对你有帮助，欢迎支持一下 :)

<table>
 <tr>
 <td align="center">❤️ GitHub Sponsors</td>
 <td align="center">☕ Ko-fi</td>
 <td align="center">💰 USDT (TRC20)</td>
 </tr>
 <tr>
 <td align="center">
 <a href="https://github.com/sponsors/akiralereal" target="_blank"><img src="https://img.shields.io/badge/Sponsor-%E2%9D%A4-EA4AAA?logo=githubsponsors&logoColor=white&style=for-the-badge" alt="GitHub Sponsors"/></a>
 </td>
 <td align="center">
 <a href="https://ko-fi.com/akirale" target="_blank"><img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="Ko-fi"/></a>
 </td>
 <td align="center">
 <img src="https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=TArpwDgewYSFCYX6XoJ6drwpEU6UGBw5yq" width="200" alt="USDT TRC20 QR Code"/> 
 <code>TArpwDgewYSFCYX6XoJ6drwpEU6UGBw5yq</code> 
 ⚠️ 仅支持 TRON (TRC20) 网络，请勿使用其他网络 Only via TRON (TRC20) network
 </td>
 </tr>
</table>

**当前版本：v3.15.0**

> 一个基于 Docker 部署的 IPTV 直播源管理与分发系统：提供可视化管理后台，核心抓取咪咕视频源（含体育赛事 / EPG 节目单），并支持外部直播源管理与 m3u/m3u8 订阅导入。
>
> - 📺 免费频道支持标清/高清（480p/720p），**1080P 蓝光画质需要咪咕 VIP 会员**
> - 🏆 咪咕体育直播（昨天/今天/明天赛事）**需开通对应咪咕体育会员**方可播放
> - 🎁 已内置多个稳定可靠的免费频道，如**纬来体育、Red Bull、4K 卫视、港澳台及 HBO / CNN / BBC 等海外频道**，无需额外配置即可使用
> - 📡 内置**精选频道**订阅源（央视 / 港澳台 / 地方 / 国际），开箱即用
> - 🔗 支持**订阅模式**，可导入 m3u/m3u8 播放列表批量添加频道

#### 🆕 v3.15.0 更新内容

- 🆕 **咪咕「客户端就近取流」开关：解决跨运营商观看卡顿**：服务器和观看设备不在同一运营商网络时（如服务器接移动宽带、电视用联通网络），咪咕频道常见加载慢 / 播不了——因为播放地址由服务器解析，拿到的是服务器侧运营商的 CDN 节点。在「系统配置」勾选本开关（或环境变量 `menableClientDispatch=true`）后，播放地址改由**播放器所在网络**就近选择节点，跨网观看即可流畅。默认关闭，同网部署无需开启；保存即时生效、无需重启（issue #82）
- 🆕 **外部源失效检测**：「源管理」的订阅 / 直连源新增「🩺 检测失效」：并发探测该源全部频道的连通性（带超时与重试，只取响应状态、不下载流量），实时进度，完成后列出失效清单（超时 / HTTP 状态码分类）与存活频道首字节延迟参考，失效频道可**一键隐藏到当前配置档**（只隐藏不删除，可随时在「已隐藏」恢复）。rtmp/rtp/udp 组播无法 HTTP 探测会跳过保留；带防盗链的源可能误报，请以实际播放为准（issue #88）
- 🆕 **外部源支持排序（决定播放器里源1/源2 的顺序）**：源列表每个源新增 ▲/▼ 上移下移，列表顺序 = 播放列表输出顺序 = 播放器同名频道「源1/源2」顺序，把偏好的源排前面即成为默认源；调整后自动保存并重新生成播放列表。排序作用于自定义源之间（合并顺序仍为 咪咕 > 内置 > 自定义）（issue #94）
- 🆕 **频道显示所属订阅源**：「我的频道」每个频道名后新增所属源徽标（单源显示源名、多源显示数量、悬停看完整列表），频道详情弹窗也改为显示具体源名——多源管理一目了然。刻意不改输出给播放器的频道名，避免破坏同名聚合与 EPG / 台标匹配（issue #94）
- 🐛 **修复凤凰卫视频道匹配不上外部 EPG**：内置频道用长名（凤凰卫视中文台 / 资讯台），肥羊等外部 EPG 源用短名（凤凰中文 / 凤凰资讯），命名规则没打通导致节目单一直 0 命中；现繁简长短各种写法自动归一（实测凤凰中文 / 资讯分别命中 386 / 508 条节目），升级后无需改任何配置，等一次 EPG 刷新即可（issue #97）
- 🐛 **修复公网地址被强制补端口**：「系统配置 → 公网地址」填 `http(s)://` 完整地址时不再强行拼上服务端口——内网穿透 / 反向代理走 80/443 标准端口的场景此前会被改成 `域名:1905` 导致播放不了；只填裸 ip / 域名仍自动补全协议与端口，老配置不受影响
- 🐛 **修复抓取模式被站点反爬拦截**：部分站点（如 vtvgo.vn）检测到自动化浏览器后整页白屏，导致「未能提取到m3u8链接」；抓取内核现已隐藏自动化特征、使用完整版 Chrome UA，并对需要点一次播放才开始拉流的页面自动尝试起播
- 🛡️ **修复外部源并发操作竞态**：订阅导入 / 网页抓取进行中调整源顺序，可能把抓取结果写进相邻的另一个源并持久化；现已加操作守卫，且服务端回写改为按源稳定 id 定位（源被删则放弃写入），多标签页、自动刷新并发等场景一并免疫

完整更新历史见下方 <a href="#-更新日志">更新日志</a>

## 📖 项目简介

本项目提供完整的 IPTV 直播源解决方案，核心能力：

- **📺 咪咕视频源抓取** — 自动获取 CCTV、卫视等频道（720P 高清；配置咪咕 VIP 账号可解锁体育直播及 1080P / 蓝光更高画质）
- **🔗 外部源管理** — 外部 m3u8 直链、网页播放页自动抓取、m3u/m3u8 订阅批量导入
- **🖥️ Web 管理后台** — 访问 `http://你的IP:1905/admin`，可视化管理直播源、分组、台标、EPG 等

📋 详细功能与配置见下方文档。

## 📑 目录

- [🚀 快速开始（Docker 部署）](#-快速开始---docker-部署推荐)
- [❓ 常见问题（FAQ）](#-常见问题faq)
- [📚 详细功能说明](#-详细功能说明)
- [🔧 本地部署（进阶用户）](#-本地部署进阶用户)
- [🖥️ Web 管理后台](#web-管理后台)
- [📋 更新日志](#-更新日志)

---

## 🚀 快速开始 - Docker 部署（推荐）

### 使用 Docker Compose（最简单）

创建 `docker-compose.yml` 文件：

```yaml
services:
  iptv:
    image: akiralereal/iptv:latest              # 使用最新版本镜像
    container_name: iptv                        # 自定义容器名称
    init: true                                  # 回收 Chromium 退出后的僵尸进程
    ports:
      - "1905:1905"                             # 宿主机:容器端口映射
    environment:
      - muserId=                                # 可选：咪咕账号ID（留空为游客模式）
      - mtoken=                                 # 可选：咪咕登录令牌（用于高画质/VIP）
      - mport=1905                              # 必须：容器监听端口，与 ports 对应
      - mrateType=4                             # 画质：2=标清，3=高清，4=蓝光(需VIP)
      - mdataDir=/migu/data                     # 配置/数据持久化目录（对应下方挂载的卷）
      # - mhost=                                  # 可选：外部访问地址（如 http://test.com:1905）
      # - mpass=                                  # 可选：访问密码（设置后访问: http://ip:port/密码/...）
    volumes:
      - ./data:/migu/data                       # 持久化配置与生成文件，容器重建/升级镜像后不丢失
    restart: always                             # 容器异常退出后自动重启
```

> 💾 **数据持久化（强烈建议）**：上面的 `volumes` + `mdataDir` 会把系统配置、咪咕账号、外部订阅源、我的频道（分组顺序/隐藏/归类/排序）等都存到宿主机的 `./data` 目录。**不挂载的话，`docker compose down`、重建容器或 `docker compose pull` 升级镜像时这些配置会全部丢失、恢复默认。**
>
> 若你之前已部署且容器里已有配置，升级前先备份出来再挂卷。**建议直接备份整个数据目录**（包含系统配置、外部订阅源、我的频道、多配置档 `my-playlist-config.*.json`、账号、EPG 源、台标缓存等全部文件，单拷个别 json 容易漏）：
>
> ```bash
> mkdir -p ./data
> # 较新版本镜像（数据在 /migu/data）：整目录拷出，一步到位
> docker cp iptv:/migu/data/. ./data/ 2>/dev/null || true
> # 旧版本镜像（数据在 /migu 根目录）：逐个拷贝配置文件
> for f in system-config.json my-playlist-config.json my-playlist-profiles.json external-sources.json epg-sources.json users.json; do \
>   docker cp "iptv:/migu/$f" ./data/ 2>/dev/null || true; done
> # 然后再用带 volumes 的 compose 重新 up -d
> ```

启动服务：

```bash
docker-compose up -d
```

常用命令：

```bash
# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down

# 重启服务
docker-compose restart

# 更新镜像
docker-compose pull && docker-compose up -d
```

### 使用 Docker 命令直接运行

#### 拉取镜像

```bash
docker pull akiralereal/iptv:latest
# 或指定版本
docker pull akiralereal/iptv:1.3.1
```

#### 快速运行（游客模式）

```bash
docker run -d -p 1905:1905 -v "$(pwd)/data:/migu/data" --name iptv akiralereal/iptv:latest
```

> `-v` 把配置持久化到宿主机 `./data`，删除/重建容器、升级镜像都不丢配置；省略它则配置只存在容器的匿名卷里，换容器即丢。

#### 自定义配置运行

```bash
docker run -d -p 1905:1905 \
  --init \
  -e muserId=你的ID \
  -e mtoken=你的token \
  -e mport=1905 \
  -e mhost="http://192.168.1.100:1905" \
  -e mrateType=4 \
  -e mpass=mypassword \
  -e mdataDir=/migu/data \
  -v "$(pwd)/data:/migu/data" \
  --name iptv \
  akiralereal/iptv:latest
```

> `--init` 回收 Chromium 僵尸进程；`-v ... -e mdataDir=/migu/data` 持久化配置，升级镜像后不丢失（详见上方「数据持久化」说明）。

### 🎯 访问服务

部署成功后，可以通过以下地址访问：

#### 📺 播放列表
- **M3U 格式**: `http://your-ip:1905/interface.m3u`（推荐：带 `.m3u` 后缀，部分 App 按后缀校验订阅地址才认；裸 `http://your-ip:1905/m3u` 内容相同、同样有效）
- **TXT 格式**: `http://your-ip:1905/txt`
- **节目单（EPG）**: `http://your-ip:1905/playback.xml`

#### 🖥️ Web 管理后台（重要）

> [!TIP]
> **快速访问管理后台：**
> 
> - **无密码访问**: `http://your-ip:1905/admin`
> - **有密码访问**: `http://your-ip:1905/密码/admin`
> 
> 💡 *将 `your-ip` 替换为你的服务器IP地址，例如: `http://192.168.1.100:1905/admin`*

通过管理后台可以：
- ✅ 查看所有频道列表
- ✅ 添加/编辑/删除外部直播源
- ✅ 配置系统参数（画质、公网地址、访问密码等）
- ✅ 一键更新播放列表

---

## ❓ 常见问题（FAQ）

**Q：飞牛影视 / 某些播放器点开频道「只有声音、没有画面」（提示「仅支持音频直播」）？**

A：这是 **H.265（HEVC）编码兼容性**问题——咪咕视频流默认是 H.265，而部分播放器（如飞牛影视内置播放器）不支持 H.265 解码，只能解出音频、没有画面。解决办法：

1. 进后台「**系统配置**」，取消勾选「**启用 H.265 原画**」，点保存——保存即清掉旧的流地址缓存、**即时生效**，无需重启；
2. 在播放端（飞牛影视等）重新打开频道（必要时重新订阅一次）即可。

若仍未生效，重启一次容器即可；用环境变量 `menableH265=false` 部署的，则**必须重启容器**才生效。关闭后回落到兼容性最好的 H.264，清晰度基本无感。若个别频道仍只有声音，再加 `menableHDR=false`（少数频道为 HDR/Vivid 导致）。

---

## 📚 详细功能说明

### 核心功能

- ✅ **多种直播源支持**
  - 咪咕视频源（300+ 频道，含 CCTV、卫视、地方台）
  - 外部自定义直播源（m3u8 格式）
  - 订阅模式（m3u/m3u8 播放列表批量导入）
  - 内置精选频道订阅源（央视 / 港澳台 / 地方 / 国际）
  
- ✅ **灵活的画质选择**
  - 标清 (480p) - 游客可用
  - 高清 (720p) - 游客可用
  - 蓝光 (1080p) - 需要 VIP
  - 原画 (1080p+) - 需要 VIP
  - 4K (2160p) - 需要 VIP
  
- ✅ **回看功能** - 支持当天节目回看
  
- ✅ **Web 管理后台**
  - 📺 自动抓取网页中的 m3u8 播放地址
  - 🔧 手动添加已知的播放地址
  - 🔄 支持独立自动刷新功能
  - ⚡ 快速模式：删除/修改源 1-2 秒内生效
  
- ✅ **自动更新节目单（EPG）** - 定时同步最新节目信息

---

## 🔧 本地部署（进阶用户）

### 前置要求

- Node.js 18+ 环境
- 中国大陆网络环境（访问咪咕频道）

### 注意事项

1. 登录后使用请注意账号安全
2. 咪咕频道需要中国大陆网络环境才可正常访问

### 使用模式

#### 🎯 游客模式（推荐，无需配置）

- ✅ 无需配置账号，开箱即用
- ✅ 支持所有普通频道（央视、卫视、地方台等）
- ✅ 支持回看功能
- ⚠️ 画质限制为 **720p**

#### 🎫 VIP 会员模式

- ✅ 支持高清及以上画质（1080p、蓝光、4K）
- ✅ 支持体育赛事等会员内容
- ⚠️ 需要配置 `muserId` 和 `mtoken`
- ⚠️ 需要咪咕视频 VIP 会员

> **提示**：登录普通账号（无VIP）与游客模式效果相同，都是 720p 画质。只有 VIP 会员才能观看高清及以上画质。

#### 📝 如何获取 userId 和 token

如需使用 VIP 会员功能，需要获取咪咕账号的 `userId` 和 `token`。

> [!IMPORTANT]
> **获取步骤：**
> 1. 使用浏览器访问 [咪咕视频官网](https://www.miguvideo.com/)
> 2. 登录你的咪咕 VIP 账号
> 3. 打开浏览器开发者工具（F12）
> 4. 切换到"网络"(Network) 标签
> 5. 刷新页面，在请求中找到包含认证信息的 API 请求
> 6. 从请求头或响应中提取 `userId` 和 `token` 参数

<div align="center">
 <img src="https://raw.githubusercontent.com/akiralereal/iptv/main/Resources/000.png" alt="获取userId和token示例" width="800"/>
 浏览器开发者工具获取 userId 和 token 示例
</div>

### 配置说明

> 🎮 **游客模式开箱即用，下面这些全部留空也能跑。** 大多数人最多动账号 / 画质 / 持久化几项即可，其余进阶项建议在管理后台直接设置，不必记环境变量。

#### 🔹 常用配置（够大多数人用）

| 变量名 | 默认值 | 说明 |
| --- | --- | --- |
| muserId | | 咪咕账号 ID（**仅 VIP 高画质需要**，游客留空） |
| mtoken | | 咪咕登录 token（同上，网页端登录后获取） |
| mhost | | 公网 / NAS 访问地址，如 `http://192.168.1.100:1905` |
| mrateType | 3 | 画质：2 标清 / 3 高清 / 4 蓝光(需 VIP) |
| mpass | | 访问密码（可选），设置后访问 `http://ip:port/密码/...` |
| mdataDir | /migu/data | 数据持久化目录（**镜像已默认此值并声明数据卷**）；建议再用 `-v ./data:/migu/data` 绑定到宿主机便于备份 |

> 💡 进阶项（管理页路径、HDR / H.265、更新间隔、token 刷新等）可在 **管理后台 →「系统配置」** 页里改，保存即时生效；完整环境变量见下方折叠表。

<details>
<summary>📋 完整配置表（全部环境变量）</summary>

| 变量名 | 默认值 | 类型 | 介绍 |
| --- | --- | --- | --- |
| muserId | | string | 用户id（仅VIP用户需要配置） 可在网页端登录获取 |
| mtoken | | string | 用户token（仅VIP用户需要配置） 可在网页端登录获取 |
| mport | 1905 | number | 本地运行端口号 |
| mhost | | string | 公网/自定义访问地址 格式<http://ip:port> |
| mrateType | 3 | number | 画质 2: 标清 (480p) 3: 高清 (720p) 4: 蓝光 (1080p，需VIP) 7: 原画 (1080p+，需VIP) 9: 4K (2160p，需VIP) |
| mpass | | string | 访问密码 大小写字母和数字 添加后访问格式 <http://ip:port/mpass/>... |
| madminPath | admin | string | 管理页面自定义路径，如填 `console` 则用 `/console` 访问后台（`/admin` 失效） 保留字 api/player/favicon.ico 与非法值会回退 admin |
| menableHDR | true | boolean | 是否开启 HDR（vivid/4kvivid） 设 `false` 关闭 |
| menableH265 | true | boolean | 是否开启 H.265 原画 有兼容性问题（如浏览器无画面）时设 `false` 关闭 |
| menableClientDispatch | false | boolean | 咪咕客户端就近取流：**服务器与观看设备不同运营商**（如服务器移动宽带、电视联通网络）导致咪咕频道跨网卡顿 / 播不了时设 `true` 开启后播放地址由播放器所在网络就近选择 CDN 节点；同网部署无需开启 |
| mupdateInterval | 8 | number | 节目单 / 源更新间隔（小时），不建议过短 |
| mrefreshToken | true | boolean | 是否每月刷新咪咕 token **可能导致封号**，可设 `false` 关闭 |
| mblank | false | boolean | 空白模式总开关，设 `true` 后下面三项内容开关**默认翻转为关**（一行得到空白部署） 细粒度开关显式设值时优先于本项，如 `mblank=true` + `menableMigu=true` 可单独保留咪咕 |
| menableMigu | true | boolean | 是否启用咪咕源（CCTV/卫视抓取 + 体育赛事 + EPG + token 刷新） 设 `false` 后仅分发内置 / 外部源；**体育赛事、回放、咪咕 EPG 随之不可用** |
| menableBuiltInSources | true | boolean | 是否启用内置单频道源（纬来体育 / Red Bull / 4K 卫视 等） 设 `false` 不加载也不抓取 |
| menableBuiltInSubscriptions | true | boolean | 是否启用内置订阅源（精选频道） 设 `false` 不加入；已添加的可在「源管理」删除，删后不再复活 |
| mdataDir | 镜像内 `/migu/data`；node 直跑为当前目录 | string | 配置 / 数据持久化目录（**仅环境变量可设**） 镜像已默认 `/migu/data` 并声明数据卷；建议 `-v ./data:/migu/data` 绑定宿主机便于备份 |

> 说明：除 `mdataDir`/`mport` 外，以上多数项也可在 `system-config.json` 或管理后台「系统配置」页修改；后台保存即时生效（端口与更新间隔需重启）。

</details>

### 高级功能详解

#### 📺 多套配置档（大分组，给不同电视各一套）

家里多台电视各有偏好（大厅给老人、卧室给年轻人、茶室……），可以用「配置档」给每台电视维护一套独立的频道编排，互不影响。

**怎么用：** 管理后台 →「📺 我的频道」标题行右侧：

- **配置档下拉**：切换当前编辑 / 查看的档（默认档 = 原来的「我的频道」，地址不变）
- **➕ 新建**：复制当前档为新的一档（弹窗填显示名如「卧室」，可选填英文地址短名如 `woshi`，留空自动生成）
- **✏️ 改名 / 🗑️ 删除**：管理非默认档（默认档不可删 / 改名）

**每台电视填各自的地址即可**（每档底部会显示，可直接复制）：

| 配置档 | M3U 地址 |
| --- | --- |
| 默认 | `http://你的IP:1905/interface.m3u` |
| 卧室(woshi) | `http://你的IP:1905/interface.m3u?profile=woshi` |
| 茶室(chashi) | `http://你的IP:1905/interface.m3u?profile=chashi` |

> 💡 各档共享同一份底层频道与 EPG，只是「同一全集的不同视图」——隐藏 / 分组 / 排序 / 重命名各管各的，新增电视不增加抓取成本。
>
> 🔗 带 `.m3u` 后缀的 `/interface.m3u` 与裸 `/m3u` 内容完全相同、可互换；推荐用带后缀的（部分 App 按后缀校验才认），已用裸 `/m3u` 配好的地址无需更换。
>
> 🔐 设了访问密码时地址带上 `/<密码>` 前缀即可：`http://你的IP:1905/<密码>/interface.m3u?profile=woshi`。各档配置随 `mdataDir` 数据卷持久化，升级不丢。

#### 🧹 空白部署 / 纯频道管理（内容开关）

默认会自带咪咕源、内置单频道源（纬来体育 / Red Bull / 4K 卫视等）和内置订阅源（精选频道）。如果你只想用自己的源、要一个干净的环境（也避免自建源与自带源**同名分组撞车**），可以用内容开关把它们关掉。

**一个总开关 + 三个细粒度开关**（细粒度显式设值时优先于总开关；全部默认开，老用户无需理会）：

| 需求 | 配置 |
| --- | --- |
| 彻底空白，自己加源 | `mblank=true` |
| 空白但保留咪咕核心 | `mblank=true` + `menableMigu=true` |
| 只去掉自带的额外源 / 订阅 | `menableBuiltInSources=false` + `menableBuiltInSubscriptions=false` |
| 关掉其中某一项 | 对应 `menableMigu` / `menableBuiltInSources` / `menableBuiltInSubscriptions` 设 `false` |

compose 示例（彻底空白）：

```yaml
environment:
  - mblank=true
```

也可在 **管理后台 →「系统配置」** 勾选这三个开关，保存后自动重新生成播放列表、即时生效（无需重启）。

> ⚠️ 关闭咪咕（`menableMigu=false`）后，**体育赛事、回放、咪咕 EPG（节目单）将不可用**，历史播放列表里的咪咕频道直链也会失效——这是纯频道管理模式的预期表现。
>
> 💡 关掉内置订阅源后，「源管理」里已存在的精选频道订阅可手动删除，**删除后重启不会再自动加回来**。

#### 📡 公网地址配置 (mhost)

公网地址用于生成可分享的播放列表链接，支持内网和公网同时访问。

**使用场景：**
- ✅ 使用反向代理（如 nginx）访问服务
- ✅ 通过域名访问服务
- ✅ 需要分享播放列表给他人使用
- ❌ 仅本地/局域网使用（留空即可）

**配置方式：**

通过 Web 管理后台配置时：
- 只需输入域名/IP（如 `http://example.com`），端口会自动使用服务端口
- 也可手动指定端口（如 `http://example.com:8080`）

通过环境变量配置：
```bash
mhost="http://yourdomain.com:1905"
```

**智能路径选择：**
- **内网直接访问** → 播放列表使用内网地址（如 `http://192.168.1.100:1905`）
- **公网直接访问** → 播放列表使用访问时的地址
- **反向代理访问** → 自动使用配置的公网地址（检测到 `X-Forwarded-For` 或 `X-Real-IP` 请求头）

**示例：**
```bash
# 场景1: 内网访问
访问: http://192.168.1.100:1905/m3u
结果: 播放列表中的链接为 http://192.168.1.100:1905/...

# 场景2: 通过 nginx 反向代理访问（已配置 mhost）
访问: http://yourdomain.com/m3u
结果: 播放列表中的链接为 http://yourdomain.com:1905/...
```

#### 🔐 访问密码功能 (mpass)

设置访问密码后，所有服务（播放列表、管理后台、频道直播）都需要在 URL 中包含密码路径。

**配置方式：**

通过 Web 管理后台：
- 在"系统配置"中设置访问密码（只支持字母和数字）
- 保存并重启服务生效

通过环境变量：
```bash
mpass="yourpassword"
```

**访问格式：**

| 服务 | 无密码访问 | 有密码访问 |
|------|-----------|-----------|
| 播放列表 (m3u) | `http://ip:port/interface.m3u` | `http://ip:port/密码/interface.m3u` |
| 播放列表 (txt) | `http://ip:port/txt` | `http://ip:port/密码/txt` |
| 回放文件 | `http://ip:port/playback.xml` | `http://ip:port/密码/playback.xml` |
| 频道直播 | `http://ip:port/608807420` | `http://ip:port/密码/608807420` |
| 管理后台 | `http://ip:port/admin` | `http://ip:port/密码/admin` |

**自动路径注入：**

设置密码后，系统会自动处理：
- ✅ 播放列表中的所有频道链接自动包含密码路径
- ✅ 回放文件路径自动包含密码
- ✅ 管理后台 API 自动鉴权
- ✅ 未授权访问会返回友好提示信息

**测试示例：**
```bash
# 设置密码为 test123 后

# 场景1: 不带密码访问（失败）
curl http://localhost:1905/m3u
# 返回：身份认证失败

# 场景2: 带密码访问（成功）
curl http://localhost:1905/test123/m3u
# 返回：正常的播放列表
# 列表中的链接: http://localhost:1905/test123/608807420

# 场景3: 管理后台（无密码访问被拒绝）
访问: http://localhost:1905/admin
# 返回 403：访问需要密码，请使用正确的密码路径访问管理后台
```

**安全建议：**
- 🔒 使用复杂密码（字母+数字组合）
- 🔒 定期更换密码
- 🔒 不要在公开场合分享带密码的链接
- 🔒 如果只是内网使用，可以不设置密码

## Web 管理后台

本项目提供可视化的 Web 管理界面,方便您管理外部直播源。

### 访问地址

- **无密码**: `http://ip:port/admin`
- **有密码**: `http://ip:port/mpass/admin`

### 功能说明

#### 1. 查看所有频道
- 左侧面板显示从直播源获取的所有频道，按分组展示（央视、体育、卫视、地方等）
- 实时加载最新的频道列表

#### 2. 搜索频道
- 支持实时搜索，快速查找您想要的频道
- 支持模糊匹配频道名称

#### 3. 管理外部源

**添加外部源有三种方式：**

##### 方式一：自动抓取
1. 点击"添加源"按钮
2. 填写频道信息：
   - **频道名称**：自定义频道名称（如"纬来体育"）
   - **分组**：选择或输入分组名称（如"体育"）
   - **网页地址**：填写包含播放器的网页URL
   - **等待时间**：页面加载等待时间（毫秒，默认3000）
   - **独立自动刷新**：是否定期自动刷新该频道的播放地址
3. 点击"保存并抓取"
4. 系统会自动访问网页，抓取 m3u8 播放地址
5. 抓取成功后，频道会自动添加到播放列表

**优点**：
- ✅ 自动获取播放地址，无需手动查找
- ✅ 支持自动刷新，保持链接有效性
- ✅ 智能选择最优播放链接（优先长链接）

**适用场景**：
- 网页中有在线播放器的直播源
- 需要定期更新播放地址的源

##### 方式二：手动输入
1. 点击"添加源"按钮
2. 填写频道信息（同上）
3. **直接填写 m3u8 地址**：在"M3U8 地址"栏输入已知的播放地址
4. 点击"保存"
5. 频道立即添加到播放列表

**优点**：
- ✅ 无需等待抓取，立即生效
- ✅ 适用于已知播放地址的场景
- ✅ 不依赖网页结构

**适用场景**：
- 已知确切的 m3u8 播放地址
- 播放地址长期稳定不变的源

##### 方式三：订阅 m3u 播放列表（批量导入）
1. 点击"添加源"按钮
2. 切换到"订阅模式"
3. 填写订阅信息：
   - **订阅名称**：自定义名称（如"港澳地方频道"）
   - **M3U 地址**：填写 m3u/m3u8 播放列表的 URL
   - **刷新间隔**：自动刷新周期（分钟，默认1440即每天一次）
4. 点击"📥 导入并保存"
5. 系统会自动解析播放列表，批量导入所有频道

**优点**：
- ✅ 一次导入多个频道，无需逐个添加
- ✅ 自动解析频道名称、分组、Logo 等信息
- ✅ 支持定时自动刷新，保持频道列表最新
- ✅ 项目已内置精选频道订阅，开箱即用

**适用场景**：
- 拥有 m3u/m3u8 格式的频道列表 URL
- 需要批量添加大量频道
- 使用第三方维护的频道列表

##### 管理现有外部源
- **修改**：点击频道旁的"编辑"按钮，修改后保存
- **删除**：点击"删除"按钮，确认后自动更新播放列表
- **启用/禁用**：通过开关快速控制频道的显示

**智能更新机制：**
- 添加/修改/删除外部源后，系统会自动重新生成播放列表
- 使用缓存机制加速更新（1-2秒内完成，无需重新抓取咪咕数据）
- 新添加的源显示在列表顶部，方便查看

**注意事项：**
- ⚠️ 自动抓取需要服务器能访问目标网页
- ⚠️ 部分网页可能有反爬虫机制，导致抓取失败
- ⚠️ 抓取失败时，系统会自动选择最长的候选链接作为备用
- ✅ 外部源配置保存在 `external-sources.json` 文件中

###配置文件说明

项目提供了示例配置文件，首次使用时需要复制并修改：

### 使用示例

```bash
# 杀掉进程
pkill -f "node app.js"
# 启动服务
node app.js

# 访问管理后台
http://localhost:1905/admin

# 如果设置了密码 (mpass=mypass)
http://localhost:1905/mypass/admin
```

## Node.js 本地运行

> 适合开发者和需要自定义修改的用户

### 环境要求

需要 NodeJS 18+ 环境

### 安装

```shell
git clone <your-repository-url>
cd iPTV
```

### 运行

```shell
node app.js
#lsof -ti:1905 | xargs kill -9 && node app.js
#node scripts/probe-m3u.mjs              # 只看报告、不改文件
#DRY_RUN=0 node scripts/probe-m3u.mjs    # 探活 + 直接删死链
# 然后 git add IPTV.m3u && git commit && git push

```

若需要修改配置，可以使用以下命令
Mac/Linux:

```shell
mport=1905 mhost="http://localhost:1905" node app.js
```

Windows下使用git-bash等终端:

```shell
set mport=1905 && set mhost="http://localhost:1905" && node app.js
```

Windows下使用PowerShell等终端:

```shell
$Env:mport=1905; $Env:mhost="http://localhost:1905"; node app.js
```

---

## 📋 更新日志

### v3.15.0 (2026-08-16)
- 🆕 **咪咕「客户端就近取流」开关：解决跨运营商观看卡顿**：服务器和观看设备不在同一运营商网络时（如服务器接移动宽带、电视用联通网络），咪咕频道常见加载慢 / 播不了——因为播放地址由服务器解析，拿到的是服务器侧运营商的 CDN 节点。在「系统配置」勾选本开关（或环境变量 `menableClientDispatch=true`）后，播放地址改由**播放器所在网络**就近选择节点，跨网观看即可流畅。默认关闭，同网部署无需开启；保存即时生效、无需重启（issue #82）
- 🆕 **外部源失效检测**：「源管理」的订阅 / 直连源新增「🩺 检测失效」：并发探测该源全部频道的连通性（带超时与重试，只取响应状态、不下载流量），实时进度，完成后列出失效清单（超时 / HTTP 状态码分类）与存活频道首字节延迟参考，失效频道可**一键隐藏到当前配置档**（只隐藏不删除，可随时在「已隐藏」恢复）。rtmp/rtp/udp 组播无法 HTTP 探测会跳过保留；带防盗链的源可能误报，请以实际播放为准（issue #88）
- 🆕 **外部源支持排序（决定播放器里源1/源2 的顺序）**：源列表每个源新增 ▲/▼ 上移下移，列表顺序 = 播放列表输出顺序 = 播放器同名频道「源1/源2」顺序，把偏好的源排前面即成为默认源；调整后自动保存并重新生成播放列表。排序作用于自定义源之间（合并顺序仍为 咪咕 > 内置 > 自定义）（issue #94）
- 🆕 **频道显示所属订阅源**：「我的频道」每个频道名后新增所属源徽标（单源显示源名、多源显示数量、悬停看完整列表），频道详情弹窗也改为显示具体源名——多源管理一目了然。刻意不改输出给播放器的频道名，避免破坏同名聚合与 EPG / 台标匹配（issue #94）
- 🐛 **修复凤凰卫视频道匹配不上外部 EPG**：内置频道用长名（凤凰卫视中文台 / 资讯台），肥羊等外部 EPG 源用短名（凤凰中文 / 凤凰资讯），命名规则没打通导致节目单一直 0 命中；现繁简长短各种写法自动归一（实测凤凰中文 / 资讯分别命中 386 / 508 条节目），升级后无需改任何配置，等一次 EPG 刷新即可（issue #97）
- 🐛 **修复公网地址被强制补端口**：「系统配置 → 公网地址」填 `http(s)://` 完整地址时不再强行拼上服务端口——内网穿透 / 反向代理走 80/443 标准端口的场景此前会被改成 `域名:1905` 导致播放不了；只填裸 ip / 域名仍自动补全协议与端口，老配置不受影响
- 🐛 **修复抓取模式被站点反爬拦截**：部分站点（如 vtvgo.vn）检测到自动化浏览器后整页白屏，导致「未能提取到m3u8链接」；抓取内核现已隐藏自动化特征、使用完整版 Chrome UA，并对需要点一次播放才开始拉流的页面自动尝试起播
- 🛡️ **修复外部源并发操作竞态**：订阅导入 / 网页抓取进行中调整源顺序，可能把抓取结果写进相邻的另一个源并持久化；现已加操作守卫，且服务端回写改为按源稳定 id 定位（源被删则放弃写入），多标签页、自动刷新并发等场景一并免疫

### v3.14.0 (2026-07-11)
- 🆕 **批量把频道整块移到分组最前/最后**：进入「批量管理」勾选频道后，工具栏新增「移到最前 / 移到最后」，把选中的一批频道作为整块挪到当前分组的组首或组尾（其余频道保持原顺序）——整源频道一次排到分组前面/后面，不用再逐个拖拽调整。若该分组当前为「名称自动排序」，需先切回「手动」排序（issue #83）
- 🐛 **修复订阅源频道名/播放异常**：部分订阅把 `group-title` 写在 `#EXTINF` 逗号之后（如 `tvg-logo="…",group-title="央视",CCTV1综合`），旧解析按「第一个逗号之后」取名，会把 `group-title="央视"` 一并当成频道名；脏名字回填进 `tvg-id="…"` 后破坏整行 EXTINF 语法，导致该频道显示错乱、播放异常。改为取「最后一个属性引号之后的逗号」后的部分，名字不再吞属性。已加入的源刷新一次即修正（issue #84）
- 🐛 **修复网页提取源播放地址被写坏**：「网页提取」模式的源，若页面文本里的地址含 `&timestamp=`、`&notin=` 这类参数，浏览器解析网页时会把 `&times`、`&not` 等不带分号的旧式 HTML 实体误解成 `×`、`¬` 等字符，坏地址随后被保存导致一直播不了；现已自动还原。已坏的地址无需手动处理，下次刷新该源即修正。仅影响网页提取（填「网页地址」抓取）的源，订阅源不受影响（issue #84）
- 🛠️ **后台「播放地址」显示修正**：频道详情弹窗里带 `&timestamp=` 的地址此前会被浏览器渲染成 `×tamp=`（仅显示层，复制按钮与对外播放列表始终是正确地址）；现已转义，显示与实际一致（issue #84）

### 待发布（下个版本随镜像发布；发版时并入 ### vX.Y.Z 条目）

### v3.13.0 (2026-07-05)
- 🆕 **按配置档选择源**：每套配置档可勾选「启用哪些源」（咪咕 / 各内置源 / 各自定义源）——档管理弹窗每档新增「📡 源」按钮批量勾选；添加/编辑自定义源时也可直接选「在哪些配置档显示」。多源同频道只要有一个来源启用就保留；先按源粗筛、再细化隐藏，多源上千频道不用再逐个隐藏（issue #29 / #68）
- 🆕 **设置页拆二级标签**：原「系统配置」页更名「设置」，内部拆为 系统配置 / 频道别名 / 自动分组 / EPG 聚合 / 用户管理 五个二级标签，不再一页到底；系统配置新增「保存并重启」按钮，需重启的配置一步生效（issue #72）
- 🆕 **关键字分组规则支持上移/下移**：多条规则「首条命中胜」，现可直接调序改优先级，不用删了重加（issue #69）
- 🐛 **自动刷新间隔更准时**：外部源「自动刷新间隔」此前每小时才检查一次，导致设定的间隔不精确（如设 60 分钟最坏要近 2 小时才刷）；改为每 5 分钟检查、到点即刷（间隔最小仍为 60 分钟）（issue #73）
- 🛠️ **画质提示更清楚**：后台「咪咕账号 / 画质」提示改为明确说明——游客（不填账号）最高 540p、填免费咪咕账号可到 720p、蓝光 1080p 及以上需 VIP，避免「游客上不去 720p」的误解（issue #76）

### v3.12.0 (2026-06-29)
- 🆕 **关键字自动分组**：后台新增「关键字自动分组」规则——按频道名关键字（如 `央视 ← CCTV`）把「未分组」频道自动归到对应分组。自定义订阅源里没写分组、每次刷新又回到未分组的频道，配一次以后自动归位，不用再天天手动整理；只对「未分组」生效、不动源已分好的组，手动移动优先（issue #69）
- 🆕 **添加订阅源可设「默认分组」**：订阅源表单新增「默认分组」，订阅里没自带分组的频道整体归到这个分组（频道自带分组的保持不变），适合整源单主题的情况；与上面的关键字规则互补、按需选用（issue #69）
- 🛠️ **设置布局优化**：把「频道别名」「关键字自动分组」两张规则卡片从系统配置最底上移、与「统一频道显示名」聚在一起，更好找

### v3.11.0 (2026-06-28)
- 🆕 **频道列表显示「配对状态」+ 详情可直接设别名**：「我的频道」列表每个频道用两个小圆点显示节目单 / 台标是否匹配（绿=已匹配 / 红=未匹配，上方有常驻图例说明）；没匹配上的点开「频道详情」可直接填规范名给它设别名（追加、不覆盖已有），保存即时重算、不用去配置页；详情台标预览也放大了（issue #62）
- 🆕 **订阅地址栏支持复制公网地址**：在「系统配置 → 公网地址」填好公网域名:端口后，订阅栏新增「复制公网订阅 / 公网 EPG」按钮——分享给外网用户时，m3u 里的节目单地址（`x-tvg-url`）也会是公网地址，不用再手动替换内网 IP（issue #62）
- 🆕 **频道别名支持「编辑」+ 归一支持繁体转简体**：别名规则可直接编辑（不必先删再重输）、规则多了列表可滚动不撑长页面；EPG / 台标归一时会把常见繁体频道名（鳳凰衛視 / 緯來體育 等）转成简体再匹配，繁体源也能对上（issue #56 / #62）
- 🐛 **修复 CCTV 4K / 8K 被错并进 CCTV4 / CCTV8**：CCTV-4K / CCTV-8K 是独立的超高清频道，之前归一时丢掉了数字后的「K」、导致和 CCTV-4 / CCTV-8 撞成同一台互相合并，现已正确区分（issue #56）
- 🛠️ **内置「精选频道」增加本地兜底**：远程（GitHub raw + 各镜像）全部拉不到时，回退读镜像里自带的频道列表，保证「无外网、镜像也挂」的环境下精选频道仍能加载（能联网的照常拿最新）

### v3.10.0 (2026-06-27)
- 🆕 **内置「精选频道」新增一批频道**：体育（beIN SPORTS XTRA / ESPN / FIFA+ / NBC Sports NOW / NHL Network / Tennis Channel 等）、新闻（Reuters / Sky News / NHK World / France24）、纪实（National Geographic / Love Nature 4K）、影视（HBO / Cinemax / LMN 系列）、卫视（苏州4K）及央视付费频道等，开箱即用（「精选频道」为远程下发，已有部署无需重建镜像即可获得）
- 🛠️ **「我的频道」列表显示优化**：频道名加宽页面与卡片后完整显示（不再被截断成两三个字）；台标去掉背景框、非方形图自然显示、无台标则留空对齐；移除列表里不易懂的「节目单」配对图标，配对状态改到「频道详情」里以文字展示（issue #62）
- 🐛 **修复关闭 H.265 / HDR 后不生效**：咪咕流地址按频道缓存、且缓存键不含 H.265 / HDR，改了开关旧缓存仍发旧编码的流。现在后台「系统配置」保存后会即时清掉该缓存、无需等缓存过期或重启容器（issue #60）
- 🛠️ **内置「纬来体育」切换播放源**：原 `jrkan.com` 走 Cloudflare、国内不翻墙打不开，切到国内可达的 `jrs03.com`（远程下发，已有部署自动切换、无需重建镜像）

### v3.9.0 (2026-06-27)
- 🆕 **统一频道显示名（按规则批量合并不同源同台命名）**：不同订阅源里同一个台的不同写法（`CCTV1` / `CCTV-1` / `CCTV1综合`）可按规则批量统一成同一个显示名，同名后播放器能自动并为多线路。开关 `enableDisplayNameUnify`（**默认关、opt-in**；环境变量 `menableDisplayNameUnify=true` 开启），后台「系统配置」可勾选、保存即时生效；**手动重命名优先、不会被覆盖**。另配套「🔤 频道别名」卡片，可视化维护 `channel-aliases.json`（规范名 ← 别名），补内置规则兜不住的写法（issue #56）
- 🆕 **后台直观看到每个频道的配对状态 + 内联订阅地址**：「我的频道」每个频道卡片现在显示台标缩略图（没台标的显示占位）和节目单徽章（绿=已匹配 / 灰=未匹配），不用再逐个点开详情核对；「频道详情」新增「配对状态」一行，已匹配会显示归一后的规范名（如「央视1套高清 → CCTV1综合」），消除「显示名特殊、看着像没匹配」的误解；顶部新增订阅地址栏，当前档的 m3u 与 EPG 地址一键复制，免点「编辑」（issue #38）
- 🐛 **修复特殊命名的常见频道匹配不到台标**：名字带信源 / 清晰度后缀的常见频道（如 `CCTV1高清（电信）`、`湖南卫视（电信）`）此前能匹配上节目单、却匹配不到台标——台标按「显示名」取图、EPG 按「归一名」匹配，两边口径不一致。现台标改为按归一名匹配（`CCTV1高清（电信）` → `CCTV1`、`湖南卫视（电信）` → `湖南卫视`），**频道显示名保持不变**（`（电信）` 等信源标识仍可见）；同时频道名归一增加运营商 / 信源后缀剔除（电信 / 联通 / IPTV…），非 CCTV 频道的 EPG 匹配也一并受益（issue #40）
- 🛠️ **放出「节目单更新间隔」配置项**：之前此项在「系统配置」里被隐藏，现在显示出来可调整，并加红色提示——不建议设太短（频繁请求咪咕可能触发风控），**填了咪咕 Token 时建议 ≥8 小时**，修改后需重启生效
- 🐛 **修正 token 刷新请求的 Content-Type 拼写**：请求头误写成 `appsication/json`，改回标准 `application/json`，提升咪咕 token 刷新的可靠性

### v3.8.0 (2026-06-25)
- 🧪 **用户访问令牌 / 一人一源（测试阶段）**：可在后台「系统配置 → 👤 用户管理」给每个家人 / 朋友生成独立的源地址 `/u/<令牌>/m3u`，支持单独停用、重置令牌、绑定不同频道档（一人一内容），且**令牌只能拉源、进不了管理后台**——分享源地址不再连带暴露后台。泄露可追溯到具体某人、可单独吊销，其他人不受影响。**本功能仍在测试中**，建议先小范围试用、欢迎反馈；不新增用户则对现有部署与现有链接零影响。可用 `enableUserTokens=false`（或环境变量 `menableUserTokens=false`）关闭
- 🐛 **修复外部 EPG「加了源一个都匹配不上」**：很多 EPG 源的频道 id 是数字 / 拼音代号、真实台名写在 `<display-name>` 里，旧逻辑只按 id 比对导致 0 命中；现改为优先按 display-name 归一配对（并保留 id 兜底）。另注意：外部 EPG 只给咪咕没覆盖的频道补节目单，咪咕已有 EPG 的频道显示匹配 0 属正常（issue #53）
- 🛠️ **自定义分组「隐藏分组」按钮加说明**：自定义分组本就只支持「删除分组」（不提供隐藏，因为它不随源刷新复活），现在鼠标悬停会提示「请用删除分组、或用批量管理隐藏其中频道」，避免误以为能整组隐藏（issue #42 追问）

### v3.7.0 (2026-06-24)
- 🆕 **EPG 聚合：多个第三方节目单源自动合并成一份**：后台「系统配置 → 📅 EPG 节目单源（聚合）」可添加多个 XMLTV/EPG 源（支持 `.xml` 与 `.xml.gz`），程序定时拉取、把各源频道名归一到本项目规范名后合并进 `/playback.xml`——某频道只要任一源里有就能补上节目单，咪咕已覆盖的频道始终优先、不被外部覆盖。默认开启、内置默认源、开箱即用，无需手动配；每个源可看抓取时间 / 频道数 / 已匹配数，可调刷新间隔与优先级，并支持「立即刷新」。即使关闭咪咕（`enableMigu=false`），外部 EPG 也能独立产出节目单。可用 `enableEpgAggregation`（或环境变量 `menableEpgAggregation=false`）关闭（issue #38）
- 🛠️ **网页抓取源启动浏览器更稳**：抓取类源（如纬来体育）现在会优先使用系统已安装的 Google Chrome / Chromium / Edge，裸跑（非 Docker）只要装了 Chrome 就开箱即用，不必再手动 `npx puppeteer browsers install chrome` 或下载特定版本（该版本可能被部分系统的安全软件删除导致启动失败）；也可用环境变量 `PUPPETEER_EXECUTABLE_PATH` 显式指定。Docker 部署不受影响（仍使用镜像内置 Chromium）
- 🛠️ **频道详情布局优化**：把「播放地址」与拉起播放器（IINA / VLC / PotPlayer）的按钮移到靠上位置（紧跟频道 ID、在移动 / 重命名 / 复制 / 台标等管理操作之前），并放大详情弹窗，常用的复制地址 / 拉起播放器不再被挤到底部
- 🐛 **修复纬来体育源抓取失败**：内置源「纬来体育」旧域名 `jrkan66.com` 已失效，切换到 `jrkan.com` 的同名页面（该配置为远程下发，部署端会自动更新、无需重建镜像）

<details>
<summary>📜 查看历史版本更新日志（v3.6.0 → v1.2.4）</summary>

### v3.6.0 (2026-06-23)
- 🆕 **频道可一键复制到多个分组**：「频道详情」新增「复制到分组」，可把自己的频道（外部 / 直连 / 订阅）同时放进多个分组（如把 TVB 复制到「亚太」和「香港」），每个分组里是独立的一份、隐藏 / 排序 / 删除互不影响；复制的是固定地址的独立频道、可在「外部源管理」删除（咪咕频道地址为服务端跳转、暂不支持）（issue #37）
- 🆕 **支持导入本地 .m3u/.txt 文件批量加源**：「添加源 → 订阅模式」新增「本地文件 / 粘贴」，可选本地 m3u/m3u8/txt 文件、或直接粘贴内容批量导入，自动识别格式与 GBK/UTF-8 编码，全程不发起网络请求（issue #43）
- 🆕 **后台上传 / 预览频道台标**：「频道详情」可预览当前台标，并给没台标的频道直接上传图片（png/jpg/webp），存到 `data/logos/`、优先级最高、保存即生效，旁边可移除（issue #40）
- 🐛 **修复频道移动到其它分组后无法隐藏**：从原分组移动到新分组的频道，之前在新分组里点隐藏会「提示已隐藏但实际仍显示」，再次批量移动 / 移回原组也会失效（隐藏 / 移动用错了分组标识）；现统一按频道真实原始分组处理，已修正（issue #42）

### v3.5.0 (2026-06-19)
- 🆕 **频道名称 / TVG 规整（EPG 别名归一）**：异构外部源里五花八门的频道名（`CCTV-1` / `CCTV1HD` / `CCTV-1综合` …）会自动把 `tvg-id`/`tvg-name` 归一到规范名（= 本项目 EPG `playback.xml` 里的频道名，即咪咕频道名），让外部源频道也能匹配上节目单（issue #39）。CCTV 系列规范名内置可用；卫视/港台等由运行时的 EPG 全集自动覆盖；可在数据目录放 `channel-aliases.json`（格式 `{"规范名": ["别名1","别名2"]}`）自定义补充。只改 tvg、不动频道显示名。可用 `enableTvgNormalize`（或环境变量 `menableTvgNormalize=false`）关闭
- 🐛 **修复分组重命名/新建时误报「分组已存在」**：当某分组的频道被全部移动到别处、或该分组被隐藏/删除而在「我的频道」列表里已不可见时，它的名字之前仍被占用，导致把别的分组改名成它、或新建同名分组时报「分组已存在」却在列表里找不到它（issue #35）；现改为只按「当前可见分组」判重——看不到的分组不再占名，但同名分组若当前可见仍会被拦截（防止误合并）

### v3.4.0 (2026-06-17)
- 🆕 **订阅源支持带账号密码的地址**：添加订阅源时可直接填 `http://用户名:密码@域名/x.m3u` 形式的地址，系统会自动转成 HTTP Basic 认证去拉取，不再因地址里带 `用户名:密码@` 而获取失败（注：仅认证「拉取播放列表」这一步；列表内各频道的流地址若也需认证，由播放器侧处理）
- 🛠️ **后台默认给带 `.m3u` 后缀的订阅地址**：「我的频道」配置档里复制的订阅地址改为 `/interface.m3u`（内容与 `/m3u` 完全相同），更适配「按后缀校验订阅链接」的 App（飞牛影视等），不用再手动改地址；裸 `/m3u` 仍然有效，已配好的地址无需更换
- 🐛 **修复飞牛影视等无法订阅播放列表**：`/m3u`、`/interface.m3u` 之前以媒体类型 `audio/x-mpegurl` 返回，会被飞牛订阅 / 浏览器当成「一个视频」去播放、而非当订阅文本解析，导致订阅失败；现改为 `text/plain` 返回（与 GitHub raw 一致），普通播放器不受影响
- 🐛 **修复「分组内按名称排序」单独设置时不生效**：当某配置档只设了某分组「📑 排序：名称」、且没有其它任何自定义（隐藏 / 分组 / 重命名等）时，该排序之前不会生效，现已修复

### v3.3.0 (2026-06-14)

本次为「多套配置档（大分组）」大版本：一套服务可维护多套个性化播放列表，给家里不同电视（大厅老人 / 卧室年轻人 / 茶室）各用各的；同时补齐外部频道台标、修复多个 issue、优化若干体验。

- 🆕 **多套配置档（大分组）**：「我的频道」可新建多套配置档，每套独立保存隐藏 / 分组 / 排序 / 重命名，通过 `/m3u?profile=<短名>`（如 `/m3u?profile=woshi`）访问、互不影响——不同电视填各自地址即可各看各的。底层频道 / EPG / 回看多档共享，新增电视不增加抓取成本。**完全向后兼容**：默认档就是原来的「我的频道」、地址仍是裸 `/m3u`，老用户与已配好的电视零感知、无需改地址、无数据迁移
- 🆕 **配置档后台集中管理**：「我的频道」首屏只留「当前档：xx + ✏️ 编辑」一个入口；点开弹窗统一切换 / 新建 / 改名 / 删除，每档显示各自访问地址可一键复制。新建即**复制当前档**（填中文显示名 + 选填英文地址短名），适合从一台派生另一台再微调。（⚠️「🔄 重置」按钮已从标题行移入此弹窗，且只重置当前档）
- 🆕 **分组内按名称自动排序**：「我的频道」每个分组可切「📑 排序：手动 / 名称」；按名称时组内频道自动排序、新增台自动归位（中文按拼音、CCTV1/2/10 按数字），方便在电视上快速定位、找失效台
- 🆕 **隐藏分组里单独/批量移动频道**：隐藏的整组可直接进「批量移动频道」，把个别或多个频道移到可见分组，不用再先恢复整组、移完再重新隐藏
- 🆕 **外部/精选频道台标**：精选频道原本没图标，现按频道名自动补台标（默认用公共台标库 fanmingming，命中约 1/3）；想补全的把 `<频道名>.png` 放进数据目录的 `logos/` 文件夹即可，优先级高于公共库。可用环境变量 `mexternalLogoBase` 改地址或留空关闭
- 🆕 **新增 `/interface.m3u` 订阅地址**：内容与 `/m3u` 完全相同、仅多 `.m3u` 后缀——解决飞牛影视等按后缀校验订阅地址、填 `/m3u` 报「链接不正确」的问题
- 🛠️ **后台可调 H.265 +「只有声音」引导**：「系统配置」露出 H.265 开关并加说明——部分频道「只有声音、没画面」多因播放器/设备不支持 H.265(HEVC)，关闭即回落到兼容性最好的 H.264（个别频道仍只有声音可再用 `menableHDR=false` 关 HDR/Vivid）
- 🐛 **修复自建分组名中文乱码**：保存「我的频道」配置时，中文名在网络分包边界可能被解码错（如「央视咪咕」→「央视??咕」），已改为按完整字节解码修复。⚠️ 已经乱掉的分组名不会自动复原，升级后重新改名一次即可
- 🐛 **修复「恢复所有频道」误报**：之前点该按钮会弹「恢复失败: channelIds is not defined」（其实已恢复成功），现正确提示「已恢复 N 个频道」

### v3.2.0 (2026-06-07)
- 🛠️ **「我的频道」显示总频道数**：管理后台「我的频道」标题后实时显示当前总频道数（共 X 个频道），随频道增删 / 移动自动更新

### v3.1.0 (2026-06-07)
- 🆕 **内置源配置支持远程拉取**：`built-in-sources.json` 改为运行时优先从仓库 raw 链接拉取（GitHub 镜像 + 数据卷缓存 + 镜像内置 三重兜底，国内拉不到也和纯本地一样稳）。纬来体育等需网页抓取的源，其抓取网址 webUrl 现在 **push 即更新、无需重建镜像**（webUrl 变更会自动重抓）；可用环境变量 `mbuiltInSourcesUrl` 改源地址或置空关闭
- 🔄 **内置单频道源并入「精选频道」统一管理**：把 WildEarth / Red Bull / 4K 卫视等直链频道从 `built-in-sources.json` 移入 `IPTV.m3u`，`built-in-sources.json` 仅保留需网页抓取的纬来体育；以后这些频道改 `IPTV.m3u` push 即可。合并时按「同分组 名称+地址」去重，与未升级镜像并存也不会重复

### v3.0.0 (2026-06-06)
本次将内置订阅源从依赖第三方链接切换为项目自维护，运行时不再依赖外部仓库的内容与可用性。

- 🔄 **内置订阅源改为自维护**：移除第三方 YueChan 的「港澳地方频道 / 全球频道」两个内置订阅，替换为项目自带、可自行维护更新的「精选频道」（央视 / 港澳台 / 地方 / 国际，约 115 频道；源文件 `IPTV.m3u` 随仓库分发，走本仓库的 raw 链接定时刷新），不再依赖第三方仓库的内容与可用性
- 🧹 **老用户自动清理「僵尸源」**：升级后启动时一次性移除已退役的旧 YueChan 订阅（含其缓存频道），避免「换源后旧源残留、且因不在内置列表里而连开关都关不掉」；只跑一次，尊重用户后续的手动增删

### v2.2.1 (2026-06-05)
- 🛠️ **核心内容开关独立成组**：管理后台「系统配置」中的「启用咪咕源 / 内置单频道源 / 内置订阅源」三项从常规配置里独立出来，做成醒目的「🔑 核心内容开关」卡片（红色描边、标注默认开启并提示谨慎关闭），与端口 / 密码等普通配置项形成 UI 区分，降低误关导致频道大幅减少甚至空白的概率
- 🗑️ **移除后台「🧹 一键空白」按钮**：该按钮仅是一次性勾掉上述三个开关、易误触，且与单独勾选重复，本版移除；需要空白部署仍可用环境变量 `mblank` 或手动关闭三个开关实现

### v2.2.0 (2026-06-05)
- 🆕 **订阅源支持 txt 格式**：订阅模式现自动识别播放列表格式，除 m3u/m3u8 外也支持 txt（diyp/TVBox：`分组,#genre#` / `频道名,地址`，一个频道用 `#` 连多个备用源时取首个），无需额外设置；兼容 GBK/GB2312 编码
- 🆕 **内容开关 / 空白部署**：新增 `mblank` 空白模式总开关 + `menableMigu` / `menableBuiltInSources` / `menableBuiltInSubscriptions` 三个细粒度开关（环境变量或管理后台「系统配置」勾选；细粒度优先于 `mblank`；**默认全开，老用户无感**）。一行 `mblank=true` 即得到纯频道管理的空白部署，或单独关掉自带的内置源 / 内置订阅源，避免与自建源同名分组撞车
- 🆕 **后台「🧹 一键空白」**：系统配置页新增上述三个开关与一键空白按钮，保存后自动重新生成播放列表、无需重启即时生效
- 🛠️ **内置订阅源可彻底删除**：自带的「港澳地方频道 / 全球频道」订阅改为「只播种一次」，删除后重启不再自动复活（尊重用户删除）；关闭内置订阅时抓取层与输出层一并跳过，不再无谓联网下载
- 🐛 **修复 Docker 主版本标签**：发布镜像的主版本滚动标签此前一直错打成 `:1`（实际是 v2.x），现修正为 `:2`，并修 `bump-version.js` 使其今后自动更新该标签

### v2.1.0 (2026-06-02)
- 🆕 **单频道重命名**：频道详情弹窗可给任意频道自定义显示名（清空或改回原名即恢复）；只改显示名、不动 `tvg-name`，不影响 EPG 匹配。适合统一不同订阅源对同一频道的不同命名
- 🆕 **批量移动到分组**：「我的频道」批量管理模式新增「移动选中到〈分组〉」，可一次把多个选中频道移到指定分组
- 🛡️ **空数据不覆盖播放列表**：某次刷新获取到 0 个频道时（通常是咪咕/网络不可达）保留上一次的好播放列表，不再用空文件覆盖，避免「我的频道」被清空且不自愈
- 🔧 **管理页显示实际生效配置**：系统配置接口改为返回「环境变量 + 配置文件 + 默认值」合并后的实际生效值——修复用环境变量（`muserId`/`mtoken` 等）配置时，换电脑/无浏览器自动填充的情况下表单显示为空的问题
- 💡 **环境变量覆盖提示**：当某些配置由 docker-compose 环境变量设置时，系统配置页顶部醒目提示并列出受影响项（说明清空保存会回退到环境变量值、需改 compose）
- 🔧 **检查更新日志优化**：镜像逐个回退时的失败改为黄色警告，仅全部镜像失败才标红，避免成功的检查更新看起来像报错

### v2.0.1 (2026-05-31)
- 🐛 **分组上移/下移后选中跟随**：之前移动分组后，左侧选中仍停在原位置（变成了被换上来的另一个分组），要重新点选才能继续移动；现在选中会**跟随被移动的分组**，可连续点上移/下移（例如把某分组一路移到最后）
- 💾 **配置持久化（升级不再丢配置）**：运行时数据（咪咕账号、外部订阅源、我的频道分组顺序/隐藏/归类/排序等）改为集中存放，并支持 `mdataDir` 自定义目录。**镜像现默认写入 `/migu/data` 并声明为数据卷**，因此即使不改 compose，常规 `docker compose pull && up -d` 升级也会自动复用卷、不再丢配置；仍推荐用 `-v ./data:/migu/data` 绑定到宿主机便于备份。⚠️ 从旧版（数据原在 `/migu`）**首次升级会迁移丢一次**，升级前请先用 `docker cp` 备份 `system-config.json` / `my-playlist-config.json` / `external-sources.json`（详见部署说明）
- 📝 **README 配置说明优化**：拆分为「常用配置」（新手够用）+ 折叠的「完整配置表」；补全此前未文档化的环境变量（`madminPath` / `mrefreshToken` / `mdataDir` / `menableHDR` / `menableH265` / `mupdateInterval`）；部署示例补上持久化卷与 `init`

### v2.0.0 (2026-05-30)
本次为**安全与稳定性大版本**，并新增多项管理功能（自 v1.8.2 起的全部改动）。

- 🆕 **单频道单独归类**：频道详情弹窗新增「移动到分组」，可把任意单个频道移动到其它分组（选回原分组即取消归类）；移出后即使原分组被删除，该频道仍保留在新分组
- 🆕 **频道拖拽排序**：「我的频道」频道行支持鼠标拖拽排序（原生实现、不引第三方库），替代反复点「上移/下移」，且不再丢失焦点
- 🆕 **管理页面路径可自定义**：可将后台地址 `/admin` 改成任意名字（如 `/console`）以增强隐蔽性，默认仍为 `admin`；改名后裸 `/admin` 失效，`api`/`player`/`favicon.ico` 为保留字，保存后自动跳转新地址
- 🔒 **重构访问密码鉴权**：`/api/*` 由校验可伪造的 `Referer` 头改为与页面一致的**路径密码**校验（密码模式下经 `/<密码>/api/...` 访问）；未授权统一返回 403、未知接口 404、非 GET/POST 405
- ⚡ **移除全局请求串行锁**：旧实现用一个全局 `loading` 标志把所有 HTTP 请求逐个串行处理，一次慢抓取/拉取会阻塞包括频道跳转在内的全部请求；现各请求独立处理。POST 请求体读取加 try/catch，客户端中途断开连接返回 400 而非拖垮进程，并新增进程级异常兜底
- 🛡️ **更新流程加单飞锁**：定时刷新、启动初始化与后台保存外部源可能并发调用 `update()`，并发改写同一批临时文件会损坏 `interface.txt` / `playback.xml`；现串行化执行
- 🧟 **修复 Chromium 僵尸进程**：网页抓取（`fetch` 模式）启动的 Chromium 在容器内不再堆积 `<defunct>` 僵尸进程——镜像引入 `tini` 作为 init 进程回收孤儿子进程（`docker-compose.yml` 增加 `init: true`），`browser.close()` 增加超时与强杀进程组兜底（⚠️ 需**重建镜像/容器**后生效）
- 🐛 **修复订阅分组乱码**：订阅内容改为按原始字节解码，自动识别 GBK/GB2312（中文 IPTV 列表常见）、UTF-8 及 BOM，分组名与频道名不再乱码
- 🐛 **修复 HDR / H265 无法关闭**：环境变量 `menableHDR=false` / `menableH265=false` 之前因布尔与字符串比较问题始终无效，现可正常关闭
- 🔧 **系统配置热更新**：在管理后台保存系统配置后大部分项即时生效，无需重启（监听端口与节目更新间隔仍需重启）
- ♻️ **可关闭 token 刷新**：每月一次的咪咕 token 刷新（可能导致封号）现可通过 `refreshToken` 配置 / `mrefreshToken` 环境变量关闭
- 💬 **订阅导入报错优化**：所有镜像均失败时聚合显示每条线路的真实失败原因（不再是空白 `reason`）并给出排查提示；新增 `cdn.jsdelivr.net` 备用镜像
- 🧰 **健壮性与清理**：配置文件改为**原子写入**（临时文件 + rename），避免并发/写入中断损坏 JSON；修复 `fileUtil` 同步函数误传回调的问题；分组内频道按「名称 + 地址」去重；修复 `androidURL.js` 中 `delay` 未引入导致 302 重试逻辑失效的隐藏问题；移除 `ddCalcuURL` 中无用的 WASM 死代码

### v1.8.2 (2026-04-05)
- 🆕 频道详情弹窗新增**一键调起本地播放器**按钮（VLC / IINA / PotPlayer），并按**当前浏览器所在平台**自动筛选可用按钮（Mac 显示 VLC+IINA，Windows 显示 VLC+PotPlayer，Linux 显示 VLC）
- 🔧 **播放器启动改为纯客户端实现**：v1.8.0 的后端 `open -a` 方案仅在 Node 与客户端同机时有效，Docker/NAS 等远程部署场景完全失效；改为浏览器直接调用 URL scheme（IINA / PotPlayer）或下载 `.m3u` 文件（VLC，通过系统文件关联启动），与服务端所在平台彻底解耦
- ⚠️ 频道详情弹窗补充 VLC 行为说明：VLC 桌面版未注册 URL scheme，点击后会先下载一个 `.m3u` 文件，需在浏览器下载栏手动点击打开，VLC 才会启动并播放
- 🎨 播放按钮改为品牌配色 + 内联 SVG 图标（VLC 橙 / IINA 紫 / PotPlayer 金），替换渲染不一致的 emoji
- 📺 新增内置订阅源「**全球频道**」（`Global.m3u`），与已有的「港澳地方频道」采用同一套处理方式；`BUILT_IN_SUBSCRIPTIONS` 常量化，新装默认写入，已有安装启动时自动补齐缺失内置源
- 🐛 修复内置订阅源展开出的频道在详情弹窗被错误标记为"外部源"：内置订阅的 `subscriptionUrl` 通过 `/api/built-in-sources` 暴露给前端，按 URL 命中判定归属，确保「全球频道」「港澳地方频道」下所有频道统一显示为"内置源"
- 💡 管理后台"我的频道"新增点击可查看详情的提示：标题下方加入操作说明，频道名前增加 ⓘ 提示图标（hover 高亮），降低用户发现成本
- 🗑️ 移除失效的内置频道 `新加坡亚洲新闻（CNA）` 与 `Bloomberg TV`
- 📝 README 重构：更名为 **iPTV-Docker**，将部署方式前置，新增 GitHub / Docker Hub 徽章与 Ko-fi / USDT 赞助入口

### v1.7.2 (2026-03-25)
- 🐛 修复频道数据缓存污染导致内置源/外部源频道重复累积的问题：`getAllChannels` 合并时使用浅拷贝，导致内置源和外部源频道被写入咪咕缓存，每次自动刷新触发 `regenerateOnly` 重新生成播放列表时重复叠加（如纬来体育出现多条）

### v1.7.1 (2026-03-23)
- 🐛 修复 Docker 环境下内置抓取源（如纬来体育）无法抓取的问题：Alpine Linux 的 Chromium 路径为 `/usr/bin/chromium`，而非 `/usr/bin/chromium-browser`，导致 Puppeteer 找不到浏览器，抓取静默失败
- 🔒 修复安全问题：未授权访问 `/admin` 或 `/player` 时，响应中会明文暴露访问密码；现改为返回 403 并仅提示密码路径格式
- 🐛 修复设置访问密码后，使用 `/密码/admin` 路径无法访问管理后台的问题（路由匹配未覆盖带密码前缀的路径）

### v1.7.0 (2026-03-18)
- 🆕 新增**手动分组**功能：可在「我的频道」中创建空分组，并在自定义源中直接使用这些分组
- 🗑️ 新增**手动分组删除**功能：删除后，该分组下的自定义直连/抓取频道会自动并入 `未分组`
- 🔒 调整分组操作边界：内置咪咕分组、订阅源分组仅支持隐藏，`未分组` 不允许重命名、删除或隐藏
- 🐛 修复自定义频道与分组管理问题：避免直连频道 ID 冲突导致“我的频道”丢失频道，并阻止重命名到已存在分组名

### v1.6.0 (2026-03-16)
- 🐛 修复频道去重逻辑：将全局按频道名去重改为**分类内去重**，允许同一频道出现在不同分组中，与咪咕 App 行为一致
- 🐛 修复隐藏频道逻辑：`hiddenChannels` 改为**按分组独立隐藏**，避免跨分组误隐藏同名频道
- 🔧 频道详情弹窗优化：清理冗余播放按钮，保留复制地址功能

### v1.5.0 (2026-03-11)
- 🔄 检查更新支持 **GitHub 镜像回退**：依次尝试原始地址、ghfast.top、gh-proxy.com、gcore.jsdelivr.net，解决国内 Docker 环境无法访问 GitHub 的问题
- 🐛 修复 jsDelivr 镜像 URL 转换错误导致该镜像始终 404 的问题
- 🔧 GitHub 镜像列表统一维护（`GITHUB_RAW_MIRRORS`），检查更新与订阅抓取共用，避免重复代码
- 🐛 修复管理页面版本号显示与实际版本不一致的问题
- 📦 新增 `bump-version.js` 版本号统一更新脚本，一条命令同步更新所有文件

### v1.4.3 (2026-03-11)
- 🌐 新增**外网访问协议自动检测**：通过 NAS 转发（绿联、群晖、威联通等）或自定义域名访问时，自动使用 HTTPS 协议生成频道地址，解决外网无法播放的问题
- 🔀 内网/外网/自定义域名三条路径互不影响，内网访问不走外网，避免上行带宽浪费
- 📺 根路径 `/` 默认返回 M3U 格式（`audio/x-mpegurl`），APTV 等客户端可直接用根地址导入

### v1.4.1 (2026-03-11)
- 🆕 新增**分组重命名**功能：可自定义分组名称，重命名后同名分组自动合并，支持重置恢复原名
- 🆕 新增**分组隐藏通配符**支持：在配置中使用 `体育-*` 可一次性隐藏所有体育赛事分组
- 🆕 新增**检查更新**功能：在「关于我们」页面可一键检查是否有新版本
- 🔧 重置功能改为弹窗选项式，支持分项重置（重命名 / 隐藏 / 排序），避免误操作
- 🐛 修复频道详情来源识别错误：正确区分咪咕源、内置源、外部源
- 🐛 修复编辑按钮在非外部源频道上错误显示的问题
- 🐛 修复订阅类型外部源编辑时无法定位到正确源的问题
- 🐛 修复 `/txt` 端点未应用用户配置过滤的问题
- 🗑️ 移除冗余的「保存配置」按钮（各操作已自动保存）

### v1.3.3 (2026-03-10)
- 🐛 修复 Docker 环境下播放列表文件写入不完整的问题：生成 `interface.txt` 时使用了异步文件写入（fire-and-forget），导致文件重命名时部分分组尚未写入完成，造成港澳台地方频道（浙江、河南、广东、宁夏、广西、云南等）分组缺失；现已改为同步写入，确保文件完整性
- 🔧 优化日志输出：精简定时检查源更新、频道请求等高频日志，大幅减少 Docker 容器日志量
- 🐛 修复订阅源（如港澳台频道）首次获取失败后无重试机制，导致频道缺失的问题；现在启动 60 秒后自动重试
- 🐛 修复订阅源获取失败时不保留已有缓存数据的问题；失败时保留旧频道数据，引入指数退避重试机制
- 🐛 修复外部源每小时定时检查时无条件写入配置文件的问题；现在仅在有源被实际更新时才保存
- 🆕 启动时新增游客模式提示：未配置咪咕账号时提示最高画质为 720p
- 📸 README 新增管理后台截图展示

### v1.3.0 (2026-03-10)
- 🆕 新增**订阅模式**（外部源第三种模式）：支持导入 m3u/m3u8 播放列表 URL，一次性批量添加多个频道，支持自动定时刷新
- 📺 新增内置**港澳台及地方频道**订阅源（港澳地方频道），默认启用，开箱即用
- 🖥️ 管理后台新增订阅模式 UI：支持填写订阅名称、m3u 地址、刷新间隔，一键导入并保存
- 📝 更新 `external-sources.json.example` 示例文件，新增订阅模式配置示例

### v1.2.8 (2026-03-05)
- 🔖 版本号升级到 `1.2.8`，同步更新 `package.json`、`package-lock.json`、README 展示版本及 Docker workflow 镜像版本标签
- ⚖️ 新增 GPL-3.0 开源许可（`LICENSE`），并在文档中补充 License 说明
- 🧹 清理运行时缓存文件 `pe-cache.json` 出仓库，并加入 `.gitignore` 防止误提交

### v1.2.7 (2026-02-28)
- 🐛 修复内置抓取源 URL 刷新后重建播放列表（regenerateOnly 模式）会丢失体育-昨天/今天/明天频道的问题；现在 `updatePE` 运行时同步保存赛事缓存，快速模式下直接从缓存恢复，无需重新调用 API

### v1.2.6 (2026-02-27)
- 🐛 修复内置抓取源（如纬来体育）URL 刷新后未重新生成播放列表，导致 APTV 等客户端拿到的仍是过期链接的问题；现在每次抓取到新 URL 后会立即以快速模式重建 `interface.txt`
- 📺 新增内置频道 Bloomberg TV（国际分组）
- 📺 新增内置频道 Eurosport 4K（体育分组）
- 📺 新增内置频道 Red Bull TV（体育分组）

### v1.2.5 (2026-02-27)
- 🐛 修复内置抓取源（如纬来体育）因 m3u8 链接过期导致无法播放的问题，将自动刷新间隔从 240 分钟缩短为 60 分钟
- 🐛 修复内置抓取源抓取失败时不清除旧缓存的问题，抓取失败时现在会自动清除过期缓存，避免继续使用无效链接

### v1.2.4
- 内置源管理功能
- Web 管理后台优化

</details>

---

# 免责声明

>
> 本仓库仅供学习使用，请尊重版权，请勿利用此仓库从事商业行为及非法用途!

---

## License

本项目采用 GNU General Public License v3.0（GPL-3.0）开源许可。
详情请查看仓库根目录下的 `LICENSE` 文件。

<!--
## 🔖 版本发布（维护者流程）

使用 `bump-version.js` 脚本统一管理版本号，一条命令同步更新 5 个文件：`package.json`、`package-lock.json`、`web/admin.html`（页脚版本号）、`README.md`（标题版本 + 在更新日志顶部插入占位条目）、`.github/workflows/push_docker.yaml`（三个 Docker 镜像标签）。

```bash
# 0. 发布前自检：本地起服务、点一遍核心功能，确认无报错再发
node app.js

# 1. 更新版本号（自动修改上述 5 个文件，并在更新日志顶部插入 ### vX.Y.Z 占位条目）
node bump-version.js patch          # 2.2.1 → 2.2.2（bug 修复 / 小调整）
node bump-version.js minor          # 2.2.1 → 2.3.0（向后兼容的新功能）
node bump-version.js major          # 2.2.1 → 3.0.0（不兼容变更）
node bump-version.js 2.2.1          # 直接指定版本号

# 2. 编辑 README.md 填写更新日志：把脚本插入的空 `- ` 占位补成面向用户的条目
# 2.5 把更新日志最新条目同步到 README 顶部「当前版本更新内容」
node bump-version.js sync-notes

# 3. 提交并打 tag（tag 名须与版本号一致，带 v 前缀）
git add -A && git commit -m "release: vX.Y.Z"
git tag vX.Y.Z

# 4. 推送代码与 tag（tag 仅作发布标记，本仓库不靠它触发构建）
git push && git push --tags

# 5. 到 GitHub Actions 手动运行 push_docker 工作流（workflow_dispatch）：
#    默认从 main 构建并推送多架构镜像；镜像标签（:latest / :X.Y.Z / :X.Y / :X）
#    写死在 push_docker.yaml 内，已随 bump-version.js 更新
```

**注意事项**

- **版本号语义**：bug 修复 / 小调整用 `patch`，向后兼容的新功能用 `minor`，不兼容变更用 `major`。
- **更新日志面向用户写**：写「改了什么、对用户有什么影响」，而非内部实现；沿用现有 emoji 前缀（🆕 新功能 / 🛠️ 改进 / 🐛 修复 / 🔧 配置 / 🔒 安全 / ⚡ 性能 / 🗑️ 移除），标题加粗。
- **核对日期**：脚本用运行时系统日期生成 `### vX.Y.Z (YYYY-MM-DD)` 标题，跨天发布或时区异常时手动改正。
- **Docker 三个标签**：每版镜像会打 `:X.Y.Z`（精确）、`:X.Y`（次版本滚动）、`:X`（主版本滚动）。主版本标签曾长期漏更新、错打成 `:1`，已在 v2.2.0 修复——升 major 后务必确认 `:X` 已正确更新。
- **镜像构建是手动的**：`push_docker` 工作流为 `workflow_dispatch`，推代码 / tag 都**不会**自动触发；需到 GitHub Actions 页面手动 Run workflow（默认从 `main` 构建，镜像标签写死在 yaml 里、已随 `bump-version.js` 更新）。`git tag` 仅作发布标记。也可以不进网页、用命令行一键触发，见本节末尾「命令行触发镜像构建」。
- **重启生效项**：监听端口、节目单更新间隔等改动需用户重启容器后才生效；本次若涉及，请在更新日志里提醒用户。
- **随仓库分发的文件要先 push**：若发版包含被「自家 raw GitHub 链接」引用的随仓库文件（如内置源 `IPTV.m3u`），必须先 `git push` 到 `main`，否则链接 404、源拉不到内容；本地自测同理（未 push 时该源显示 0 频道）。
- **移除内置源 / 改数据结构要带迁移**：删除或更换内置源、变更 `external-sources.json` 等用户数据结构时，加一段一次性迁移清理老用户残留（如 v3.0.0 用 `retiredBuiltInsV1` 清掉退役订阅），否则老用户会留下「连开关都关不掉的僵尸源」。建议用临时 `mdataDir` 指向一份含老数据的配置，跑一遍 `node app.js` 验证迁移「清旧、补新、且不误删用户自建源」。

### 命令行触发镜像构建（替代 step 5 手动点 Actions）

上面 step 5 不一定要进 GitHub 网页，也可以直接用 `gh` CLI 一键触发（需先 `gh auth login`，账号有本仓库 repo 权限）：

```bash
# 从 main 构建并推送多架构镜像到 Docker Hub（等价于网页里 Run push_docker 工作流）
gh workflow run push_docker --ref main

# 查看刚触发的运行（拿到状态与运行链接）
gh run list --workflow=push_docker --limit 1

# 可选：盯着它跑到结束（多架构 + QEMU 模拟 arm，约 15~40 分钟）
gh run watch
```

> - 工作流是 `workflow_dispatch`、无输入参数，固定从默认分支 `main` 构建；务必确认 `main` 已包含本次 release 提交（即 step 4 已 `git push`）。
> - 镜像标签 `:latest / :X.Y.Z / :X.Y / :X` 写死在 `push_docker.yaml`、已随 `bump-version.js` 更新，无需在命令里指定。
> - 构建失败多为 QEMU / 网络偶发，`gh workflow run push_docker --ref main` 重新触发一次即可。
-->

iptv

iptv 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

iptv

iptv 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README