📺 iPTV

把分散的直播源，变成一套真正属于你的频道系统

自托管 · 模块化 · 可视化 · NAS 友好

🐳 Docker 部署教程 · 前往 Docker Hub →

推荐通过 Docker 在 NAS / 服务器上部署，镜像：akiralereal/iptv:latest

当前版本：v4.15.0 · 产品预览 · 频道覆盖 · 内容来源 · 功能说明 · 更新日志

iPTV 是一个面向家庭影音与 NAS 用户的模块化 IPTV 直播源管理与分发系统。它内置央视频、咪咕、B站、虎牙、斗鱼及多地区广电等抓取模块，也能接入需要网页解析的内置源、维护者筛选的公开独立源、自定义直连地址和 M3U/TXT 订阅；所有来源统一完成聚合、去重、编排，再输出干净的播放列表与 EPG 节目单。

[!IMPORTANT] 本项目是自托管的软件工具。除项目自制的使用公告短片外，不托管第三方音视频节目；仓库及运行时可能整理互联网上公开可访问的播放地址与频道元数据，但“公开可访问”不代表内容属于公有领域，也不代表已获得复制、转播或商业使用授权。请仅在获得合法授权的范围内使用；如你是权利人并认为相关条目侵权，请按版权与侵权处理提交下架通知。

🖼️ 产品预览

我的频道 · 所有频道一处编排

源管理 · 每个内容来源独立、透明、可控

播放器实况 · 输出标准订阅，接入常用客户端

✨ 为什么选择 iPTV

[!TIP] 默认配置即可使用免费频道；需要更高画质时，再到「源管理」为对应平台配置你本人合法持有的账号。凭据只保存在自己的部署中。

📡 频道覆盖

默认部署目前可聚合 800+ 频道，并会随着平台模块、赛事内容和精选频道持续扩展。实际数量会因平台接口状态、地区网络和启用的模块而动态变化。

播放列表首位默认提供项目自有的「公告」分组，内含三条自制短片：“欢迎使用 iPTV for iFansClub.com”展示使用方式、版权提醒和侵权联系说明；“央视频会员频道登录教程”演示 Docker / NAS 用户如何从浏览器复制 Cookie 把央视频登录态导入 iPTV；“「来源于网络」频道添加教程”演示如何把仓库 from-the-web/from-the-web.m3u 里的网络第三方源作为订阅自行添加。三者都不引用任何第三方节目素材。不想在电视上显示可以在后台「我的频道」逐条隐藏（随时可在「已隐藏」里恢复）；只要显示，该分组就固定在第一位，不支持删除、移动、排序或重命名。

🧩 内容来源与抓取能力

iPTV 的重点不只是一份静态频道表，而是一套可独立开关、可观察状态、可持续刷新的内容接入体系。不同来源采用不同刷新、鉴权与代理策略，平台临时不可达时可在源管理中查看状态或关闭对应模块。

[!NOTE] 所有内置抓取模块、内置网页抓取源和精选频道都能在「🌐 源管理」中独立关闭；需要完全空白的频道管理器时可使用 mblank=true。平台名称及商标仅用于说明兼容性，本项目不隶属于、也不代表上述平台或内容权利人。

📑 目录

• 🖼️ 产品预览
• ✨ 为什么选择 iPTV
• 📡 频道覆盖
• 🧩 内容来源与抓取能力
• 🚀 快速开始
• 🧭 功能全景
• 📺 播放器适配
• ❓ 常见问题
• 🔧 配置与进阶
• 更新日志
• 💖 支持项目
• ⚖️ 免责声明

🚀 快速开始

推荐使用 Docker Compose。只需要一个配置文件和一条启动命令，几分钟即可拥有自己的 IPTV 服务。

Docker 镜像：akiralereal/iptv · 查看版本标签。下面使用 latest 标签；使用 NAS 图形化容器管理器时，也可直接搜索 akiralereal/iptv，按下方配置设置端口和数据目录。

1. 创建配置文件

创建 docker-compose.yml：

services:
  iptv:
    image: akiralereal/iptv:latest
    container_name: iptv
    init: true                    # 回收 Chromium 僵尸进程
    ports:
      - "1905:1905"
    environment:
      - mport=1905                # 容器监听端口，与 ports 对应
      # - mhost=                  # 可选：外部访问地址（如 http://192.168.1.100:1905）
      # - mpass=                  # 可选：访问密码，设置后访问 http://ip:port/密码/...
    volumes:
      - ./data:/iptv/data         # 数据持久化，不挂载则重建容器 / 升级镜像会丢配置
    restart: always

2. 启动服务

docker compose up -d

升级时执行：

docker compose pull && docker compose up -d

3. 打开管理后台

部署完即可访问：

🧩 平台账号、画质等内容配置不用写进 compose：部署后进后台「🌐 源管理」在对应模块卡片里设置（支持扫码登录 / 书签工具），保存即时生效。备份 / 换机迁移用后台「设置 → 系统配置 → 🧳 配置备份 / 迁移」一键导出导入（logos/ 自定义台标需单独拷贝），或直接备份 ./data 目录。更多环境变量与玩法见配置与进阶。

🧭 功能全景

四个页面，完成从内容接入到播放分发的整个流程：

修改源后 1-2 秒内自动重新生成播放列表；外部源配置存于数据目录 external-sources.json。

数据流一览

B站 / 虎牙 / 斗鱼 / 咪咕 ─┐
广电与景观抓取模块 ───────┤
iPanda 直播模块 ──────────┤
亚洲与国际直播模块 ───────┤
内置网页抓取源 ───────────┼─→ iPTV 聚合 / 去重 / 编排 ─→ M3U / TXT / EPG ─→ 电视 · 手机 · 电脑
精选公开独立源 ───────────┤
自定义直链与外部订阅 ─────┘

📺 播放器适配

[!NOTE] 能使用标准版就无需切换；标准版链路最直接。播放器不跟随跳转时使用兼容版，只有兼容版仍失败时才使用全代理版。

部分内置模块会按平台要求自动为单个频道启用全代理，与所选订阅版本无关。例如央视景观的 CDN 会校验源站请求头，因此即使使用标准订阅，该分组的清单和视频分片也会自动经过 iPTV 服务端；其他可直连频道不受影响。

❓ 常见问题

播放器订阅类型的快速选择请看上方播放器适配；遇到新的兼容性问题，欢迎提交 issue 补充。

🔧 配置与进阶

🎮 零配置即可使用央视频 63 个公开频道；央视频会员台及其他账号能力可在后台「🌐 源管理」按模块关联本人账号（自动登录 / 扫码 / 书签工具）。管理路径、更新间隔等在「设置」页配置——都不必记环境变量。账号只保存在你自己的部署里，令牌与浏览器 profile 都等同登录态、请勿外传。

环境变量参考

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

📺 多套配置档（给不同电视各一套）

后台「📺 我的频道」标题行右侧可新建 / 切换配置档，每档独立维护隐藏 / 分组 / 排序 / 重命名，互不影响；每台电视填各自的地址（每档底部可复制），如 http://你的IP:1905/interface.m3u?profile=woshi。各档共享同一份底层频道与 EPG，新增电视不增加抓取成本；默认档地址不变、老用户零感知。

🧹 空白部署 / 纯频道管理

只想用自己的源时，用内容开关关掉自带内容（也避免同名分组撞车）：

也可在后台「🌐 源管理」直接开关各卡片，保存即时生效。关闭 menableMigu 后体育赛事、回看与对应 EPG 不可用，属预期表现。

📡 公网地址 (mhost)

反向代理 / 域名访问 / 对外分享时填写（如 http://yourdomain.com:1905），仅内网使用留空即可。系统自动按访问来源选择播放列表里的地址：内网访问用内网地址，反代访问（带 X-Forwarded-For）用配置的公网地址；填 http(s):// 完整地址时不会强制补端口。

🔐 访问密码 (mpass)

设置后所有服务都要在 URL 带密码路径：http://ip:port/密码/interface.m3u、http://ip:port/密码/admin 等，播放列表内的频道链接自动注入密码路径，未授权访问返回 403。

🔧 本地运行（不用 Docker）

需要 Node.js 20+（推荐 22 LTS）；部分平台的频道需要中国大陆网络环境。

git clone https://github.com/akiralereal/iptv.git && cd iptv
node app.js

环境变量与 Docker 同名同义，例如：mport=1905 mhost="http://localhost:1905" node app.js（Windows PowerShell：$Env:mport=1905; node app.js）。

更新日志

v4.15.0 (2026-09-13)

本次为「新增香港、台湾与黑龙江、云南共 19 路直播」版本：黑龙江 7 路、云南 7 路各自成组，香港卫视并入「香港」与凤凰三台并列，大爱一台 / 二台与 GOODTV / GOODTV2 并入「台湾」；五家全部免登录、零配置、默认开启，可在源管理逐家关闭。取流方式正好各不相同——黑龙江地址固定且既不校验来源头也不挑播放器标识，频道直接写直链、本机一个字节的媒体都不转发；云南省级要按「当前这档节目」逐次换取带路径签名的 DVR 窗口，既不能预取也不能写死；香港卫视先问源站当前在播的是哪一路再换入口，并把两跳清单拍平成媒体清单；大爱按来源头防盗链、GOOD TV 卡的是播放器标识，两家的清单与分片统一由本机全代理并补齐所需请求头。升级镜像后重启即生效，现有配置与订阅无需改动。

• 新增黑龙江、云南两省官方直播：黑龙江 7 路归入「黑龙江」，云南 7 路归入「云南」，均免登录、零配置、默认开启，可在源管理单独关闭。两者取流方式正好是两个极端。黑龙江是本项目里少见的「什么都不需要」的源：极光新闻 App 在用的官方入口地址固定、不带签名，清单和分片既不校验来源头也不挑播放器标识（ffmpeg、okhttp 都是 200），所以频道直接写直链、由播放器直连官方 CDN，本机一个字节的媒体都不转发；要留意的只有端口，官方业务域名走的是 4430 而不是 443。云南则要同时接两条链路：省级四路走云视网，官网接口返回的不是一条固定直播地址，而是「当前这档节目」的 DVR 窗口加一对按路径签发的签名——拿本轮签名去请求下一档节目的路径直接 403，既不能预取也不能写死，只能每次播放请求前重新换取；节目换档后下一次解析自然拿到新窗口，实测跨档时分片序号从 141184+604 接到 141794、单调递增不回退，播放器按普通直播清单推进即可（官网播放器自己反倒不换台，它的换档代码是注释掉的，一档放完就停）。地方三路走七彩云端目录，按房间名取当前在线机位；目录里另外 14 个地方台名字当前全部复用同一条 HLS，因此不作为独立频道收录。两家回源要求也不同：省级 CDN 缺了官网来源头不是回 403 而是把连接晾着（实测五次全部连接超时），地方那条裸请求就能取，所以请求头按目标主机分别下发，不把一家的凭据漏给另一家。实测黑龙江 7 路与云南省级 4 路均为 1280×720、H.264 / AAC-LC（黑龙江 25 帧、云南省级 25 帧），云南地方三路分别是 720p25、1080p50 和 720×416。台标方面公共台标库已收黑龙江 7 路与云南省级 4 路，按台名自动匹配；地方三路库里没有，改用七彩云端下发的官方频道卡
• 新增大爱电视与 GOOD TV 官网直播，归入「台湾」分组：大爱一台、大爱二台与 GOODTV、GOODTV2 共四路台湾公开电视直播纳入「台湾」分组，与精选列表里的公视 / 民视 / 华视 / 台视等并列，免登录、零配置、默认开启，各自可在源管理单独关闭。四条地址都是官网写死的固定 HLS、不带签名，所以模块不做任何额外请求，播放时直接给地址；真正的门在回源那一侧，两家各不相同：大爱按 Referer 防盗链，清单和 .ts 分片缺了请求头都是 403；GOOD TV 不看 Referer，卡的是 CloudFront 的播放器标识白名单，浏览器 / VLC / ExoPlayer 能过，ffmpeg 的 Lavf 和 okhttp 一律 403。播放器发什么请求头不由本项目决定，因此两家的清单与媒体分片都由本机全代理回源并补齐所需请求头，回源地址另有白名单，只允许落在各自官方的直播目录内。实测四路均为 1280×720、H.264 / AAC-LC 立体声（大爱 30 帧、约 3 Mbps，GOOD TV 29.97 帧）。台标由公共台标库按台名自动匹配。节目单本轮没有：默认 EPG 源里一条台湾频道都没有，精选列表里原有的公视 / 民视等同样如此；大爱官网自己有逐日节目表接口，但抓取模块的 EPG 槽位目前还没有接进节目单流水线，故未一并接入
• 新增香港卫视官网直播，归入「香港」分组：香港卫视一路电视直播纳入「香港」分组，与凤凰三台并列，免登录、零配置、默认开启。官网入口不是固定地址——先问官网当前在播的是哪一路，再向播放器接口换这一路的 HLS；入口在本机短期缓存，官网换台导致旧地址失效时立即重取，接口短时故障则沿用最近一次成功入口并退避重试。官网给的入口是一层 master，真正的分片列表在它下面带 hls_ctx 的子清单里，服务端取回时就拍平成媒体清单再下发，播放器少一跳、也不必理解跨主机的绝对地址；服务端只中继这份小清单，媒体分片由播放器直连上游 CDN，需要时也可用 ?relay=2 全代理。实测为 1280×720、H.264 High / AAC、约 3 Mbps，节目单由默认 EPG 源直接覆盖、无需额外配置。上游 CDN 会按 IP 拒绝一部分来源（实测机房 IP 与个别移动线路回 403，电信家宽与境外正常），服务端中继取不到清单时按既有逻辑回退 302，由播放器自己直连
• 文档：README 正文（频道覆盖、内容来源、数据流向图、常见问题、配置与进阶）收敛了「官方直播 / 官方 CDN / 官网接口」一类措辞——回源那一侧统一称「源站 / 上游 CDN」，用户实际访问或登录的一侧称「站点 / 网页端」。仅措辞调整，功能、配置与订阅地址均未变动

v4.14.0 (2026-09-09)

本次为「隐藏不再失效、按名字屏蔽与台标 / 节目单修复」版本：隐藏、重命名、归类、排序四项个性化设置不再因为源换签名地址而静默作废；新增按名字长期屏蔽的规则和一次隐藏整批同前缀分组的入口（issue #123）；台标改为按库索引取图、0 裂图，默认台标库与默认 EPG 源双双换新，地方台多补 129 个频道的节目单（issue #124）；修复自定义分组撞名后所有分组操作被锁死。升级镜像后重启即生效，现有配置与订阅无需改动，老配置里的默认 EPG 源会自动换成新地址。

• 修复隐藏 / 重命名 / 归类 / 排序在源刷新后静默失效（issue #123）：这四项设置都按「原始分组::频道 ID」存，而频道 ID 是按播放地址算的。纬来体育这类每次抓取都换一条带 ?expire=&sign= 签名地址的源，每个刷新周期 ID 都变一次，隐藏掉的频道自己冒回分组、改过的名字复原、挪过的位置弹回，且界面上看不到任何线索——「已隐藏」列表是按当前频道反查的，失配的那条直接就不显示。现在算 ID 前先剥掉时效 / 签名类参数（只剥确定与频道身份无关的那几个，qn 等可能区分清晰度的一律保留，避免两条频道撞成一条），源换签名不再影响频道身份。全量 1078 条频道里只有 16 条的 ID 会因此变一次，且均无历史配置受影响
• 新增「屏蔽规则」：按名字长期屏蔽频道，源换址、频道每天重建都照样生效（issue #123）：频道旁多了一个「屏蔽」按钮，一键把这个频道名永久屏蔽——同名的跨源实例（CCTV5+ 在体育 / 央视 / 央视频三处各一条）一次全盖住；右上角「🚫 屏蔽规则」可手动添加「整名相同」或「名字包含」规则。规则只影响当前配置档，删掉即恢复；面板里每条规则直接列出当前命中的频道，输入框边打字边报命中数，避免「名字包含」一刀切多了。空规则一律丢弃，手改配置文件把它写成字符串也不会拆成单字规则屏蔽一大片。不做白名单模式：与配置档「共享全集、各档只做减法」的定位相反，且会让新装的源一条频道都不出现
• 隐藏分组时主动提议把同前缀的一整批一起隐藏（issue #123 / #2）：「体育-昨天 / 今天 / 明天」这类分组每天重建，逐条隐藏明天照样冒出来。分组隐藏通配（体育-*）早已支持，但一直只有手改配置文件才用得上。现在对其中一个分组点「隐藏分组」时，界面会认出同前缀的兄弟分组并三选一：只隐藏这一个、或连同一起隐藏并存成规则，以后新出现的同前缀分组自动挡掉。前缀取到分隔符为止，体育-* 永远不会误伤「体育」或「体育频道」。被规则隐藏的分组在「已隐藏」里标出来源；恢复时可选解除整条规则或只恢复这一个。顺带修了三处与通配相关的既有问题：「已隐藏」列表在六处各算一遍且算法不一，配置里有通配符时「恢复整组」「全选」会操作到别的分组；对通配隐藏的分组点「恢复」无效却仍提示已恢复；「已隐藏」区的「全选」实际选不中任何频道
• 修复台标裂图：改为按台标库索引取图，默认库换为 taksssss（issue #124）：此前没有自带台标的频道按名字盲拼一个公共库地址写进订阅，库里没有这张图时播放器拿到 404、屏幕上就是裂图——实测 253 条兜底里 138 条 404。现在程序下载库自带的「频道名 → 图片」索引（7 天刷新一次、失败沿用缓存），只写库里真实存在的文件名，没有的留空交给播放器画占位图；命名对不上的也按保守规则救回（CCTV怀旧剧场 → 怀旧剧场、内蒙古组的「新闻综合」→ 内蒙古新闻综合等），会撞成同一个的宁可留空不贴错。默认库从 fanmingming（929 张）换成 taksssss（3266 张），对本项目实际输出的频道是前者的严格超集，仍走 jsDelivr gcore 镜像、大陆直连可达。结果 174 个频道有真台标、0 裂图。新增「🖼 缺台标」清单列出当前档没图的频道，点进去直接上传；也可把 .png 放进数据目录 logos/
• 默认 EPG 源换为 e.erw.cc，地方台多补 129 个频道的节目单（issue #124）：原默认源 epg.51zmt.top 已退化到对三个文件返回同一份内容，只剩 101 个央视卫视频道（咪咕本来就有）、2 天节目，地方台一个都补不到。新源 521 个频道、9 天节目、大陆多地探针直连可达；河南、广东、湖南、吉林、江苏、广西、江西、上海和各省少儿频道是主要收益。老配置里一字未改的默认源会自动换成新地址；自己改过名字或地址的那条不会被动，但「设置 → EPG 节目单源」里会明确提示它已失效并给出新地址。EPG 缓存改为 gzip 落盘（17MB → 1.3MB），老的明文缓存照常可读
• 修复自定义分组撞名后，之后新增 / 改名 / 删除任何分组都被拒绝：在某个源分组暂时不可见时（源抓取失败、或整组被隐藏）建了同名自定义分组，源分组回来后两者撞名；保存端点每次都重校验整份配置，从此所有分组操作一律报「分组已存在」，且指着那个用户根本没碰的旧分组。现在只拦「本次改动新引入」的冲突，旧冲突放行、由播放列表生成时合并同名分组，界面上用 ⚠ 标出合并了几条源频道以及怎么拆开
• 「重置」增加「屏蔽规则」一项：原「隐藏的分组和频道」一项承诺「显示所有被隐藏的频道」却不清屏蔽规则；现在屏蔽规则单独一项，原项文案改为它实际做的「逐条隐藏的」
• 许可说明更正：README 此前写「仅供个人学习、不得商用」，与 GPL-3.0 第 10 条「不得附加限制」相抵触。现明确：代码按 GPL-3.0 授权、许可证之外不附加任何使用限制；「不得售卖订阅 / 公开转播」等限制针对的是未获授权的第三方内容，来自权利人与所在地法律，不来自本软件许可。补充第三方组件许可清单

v4.13.0 (2026-09-07)

本次为「B 站直播改为播放时解析、北京电视台修复与网络第三方源自助订阅」版本：B 站直播不再把 60 分钟就过期的签名直链写进播放列表，改为与虎牙、斗鱼相同的播放时解析，播放器多久重拉列表都不再每小时全部失效（issue #120）；北京广播电视台 9 个电视频道导入 Cookie 后仍播不了的问题查明是电视台 CDN 只认完整频道页 Referer，已补齐；清单直出 / 全代理取回失败时日志写明上游到底回了什么，不再只有一行「回退 302」；v4.7.0 清出精选列表的 77 条网络第三方转发源整理成仓库 from-the-web/from-the-web.m3u 供自助订阅，不进内置默认，「公告」分组新增对应的添加教程短片（issue #121）。升级镜像后重启即生效，已导入的北京 Cookie 无需重做，现有订阅无需重新添加。

• 被清出精选列表的网络第三方源改放仓库 from-the-web/ 供自助订阅，并新增「来源于网络」频道添加教程短片（issue #121）：v4.7.0 从 IPTV.m3u 移出的台湾 4gtv 系、港澳、新加坡 / 马来西亚和影视共 77 条第三方转发源，现整理成与精选列表同级的 from-the-web/from-the-web.m3u（按台湾 / 香港 / 澳门 / 新加坡 / 马来西亚 / 影视分组，海外逐条复核可拉取清单与媒体分片，MOMO 亲子台已失效未收录），不进内置默认，需要的用户在「源管理 → ＋ 添加自定义源 → 订阅模式 → 在线 URL」粘贴直链即可全部加回；以后从网络收集到的其它链接也会备份到这个文件里，订阅定时刷新后自动出现。转发站域名在大陆电信 / 联通 / 移动家宽与腾讯 / 阿里机房共 9 个探针上均被 DNS 污染，只有海外或全局代理环境才能播，这份清单不维护、失效不作为 bug 受理。「公告」分组新增第三条 25 秒短片，五页演示这份列表是什么、复制直链、后台添加、之后自动跟随更新，和其它系统短片一样可逐条隐藏、不可删除 / 移动 / 排序 / 重命名；短片由 assets/from-the-web-guide-source.html 经 npm run generate:from-the-web-guide 生成
• 修复北京广播电视台 9 个电视频道导入 Cookie 后仍全部播不了：取流接口其实已经成功签出电视台的短效地址，是本机代理去拉清单时被电视台专用 CDN 回 403。用真实登录态实测，这台 CDN 校验的是 Referer 的完整频道页路径（https://www.btime.com/btv/btvsy_index），只带根路径 https://www.btime.com/ 一律拒绝且空正文，与地区、IP、登录 Cookie、User-Agent 都无关；独立验证台当时能播正是因为服务端代理写的是完整页面路径，移植进来时收成了根路径。现已按频道页路径补齐，公开活动 / 慢直播按 /live 页给，Cookie 仍只发给官方取流接口、不发给媒体 CDN。升级后重启即生效，已导入的 Cookie 无需重做
• 清单直出 / 全代理取回失败时，日志写明上游到底回了什么：此前服务端替播放器拉清单被拒时只有一行「清单直出取回失败，回退 302」，CDN 回的是 403、404 还是一页 HTML 完全看不出，北京电视台这次就是对着日志猜不出原因。现在这一行末尾会带上上游主机与路径、HTTP 状态、内容类型和正文头部（查询串里的签名 / 令牌不落日志，正文里回显的令牌也会抹掉），超时与网络异常也各有一句
• 修复 B 站直播每隔一小时全部失效、必须手动刷新才恢复（issue #120）：此前模块把 B 站的签名直链直接写进播放列表，按「约 2 小时过期」设计了 45～90 分钟的刷新周期；用真实直播间实测，签名只有 60 分钟有效——刷新间隔一旦调到 60 分钟以上就每轮必灭，就算准时刷新，播放器不重拉播放列表也永远拿不到新地址（多数电视端播放器几小时甚至一天才重拉一次），正在播的流还会在签名到期那一刻被 403 掐断。现改为与虎牙、斗鱼相同的播放时解析：播放列表里写的是本机稳定地址，播放请求到达时才向 B 站换取签名地址（60 秒内复用；失败短暂记忆，免得播放器的连环重试触发风控），本机只中继清单并补齐防盗链请求头，视频分片仍由播放器直连官方 CDN。播放器多久重拉列表都不再影响，不认 #EXTVLCOPT 的播放器（LunaTV 等）和 TXT / TVBox 订阅也能直接播 B 站。刷新间隔现在只决定多久重挑一次直播间，允许范围放宽为 15～120 分钟（默认仍 45）；「优先 HLS」「播放缓冲」两个直链时代的选项随之下线（统一 HLS）。升级后重启即生效，旧缓存里的直链会在启动抓取时被替换，订阅地址无需更换

v4.12.0 (2026-09-06)

本次为「央视频会员频道在 Docker / NAS 上真正可用」版本：登录态导入改为复制浏览器请求头里的整段 Cookie——用真实账号实测，央视频的会话 cookie 是 HttpOnly，v4.11.0 的书签工具拿不到、官网必拒；会员桥接不再因为镜像里 Chromium 被压到 96KB 的 JS 栈而在「启动官网解扰兼容桥」后立刻溢出，登录态有效就能播；导入失败时日志和报错会写明官网拒绝的具体原因；「公告」分组里的登录教程短片同步改版为开发者工具复制 Cookie 的六步演示。升级镜像即可生效，已导入的登录态保存在数据卷里无需重做，现有订阅无需重新添加。

• 修复央视频会员频道在 Docker / NAS 上一播就报「Maximum call stack size exceeded」：会员桥接把官网播放器解扰后的 fMP4 块转成 base64 时，用 String.fromCharCode(...bytes.subarray(i, i + 32768)) 一次把 32768 个字节当参数压栈；Mac 上默认 1MB 栈没事，官方镜像里 Alpine Chromium 为了兜住纬来体育那类混淆站崩渲染进程，JS 栈被压到 96KB，这一句直接溢出，登录态明明有效也播不了。改为 FileReader 原生编码，不占调用栈；本机用同样的 --stack-size=96 参数复现并验证通过，解码字节一致
• 修复央视频登录态导入在 NAS 上必定失败：书签工具改为复制请求头 Cookie：v4.11.0 的「获取央视频登录态」书签只读 document.cookie，而用真实账号实测央视频的会话 cookie（vusession、accesstoken、refreshtoken 等）全是 HttpOnly，网页脚本根本拿不到；只种入书签能看到的那半套，官网用户信息接口不认、续期接口回「inner token失效」并让 SDK 清空令牌，所以导入一定报「官网没有认出这份登录态」。现改为和北京模块同样的做法：在自己电脑浏览器的开发者工具 Network 里点开任一 yangshipin.cn 请求，复制 Request Headers 中 Cookie 的完整值粘贴导入（请求头包含 HttpOnly 那层）；种入完整 Cookie 后官网当场认出账号与 VIP，已实测。书签工具已从卡片移除；粘错来源（只有 ysp_* 令牌）时解析阶段就会说明缺的是 HttpOnly 会话 cookie，不再白起一次浏览器。导入失败时服务端日志会记下种入了哪些 cookie、官网账号接口的每次回包（路径、状态、返回码）和校验后剩余的 cookie，报错文案按原因区分（续期被拒 / 用户信息接口不认 / 缺会话 cookie）。「央视频会员频道登录教程」短片同步改版为开发者工具复制 Cookie 的六步演示

v4.11.0 (2026-09-06)

本次为「央视频登录态导入与安徽广电」版本：央视频会员频道新增「获取央视频登录态」书签工具，在自己电脑的浏览器登录官网后点一下、把内容粘贴到后台导入即可，Docker / NAS 等没有桌面的部署也能登录了；关联账号后服务端每 6 小时静默续期一次，家里几天没人看会员频道也不会掉线；「公告」分组新增一条 30 秒的登录教程短片，电视上就能照着操作，不需要可以隐藏；新增安徽广电 7 路官网直播，免登录、零配置、默认开启。升级镜像即可生效，现有订阅无需重新添加。

• 央视频会员频道支持从自己电脑的浏览器导入登录态，Docker / NAS 也能登录了：此前会员频道只能在运行服务的电脑上弹出官方登录窗，没有桌面的 Docker / NAS 部署无路可走。现在「源管理 → 央视频」提供「获取央视频登录态」书签工具：在自己电脑的浏览器登录官网后点一下，把复制出的内容粘到卡片里导入即可。服务端把这组 cookie 种进央视频专用的浏览器 profile，当场让官网 SDK 校验并显示昵称与 VIP 状态；cookie 不进配置文件与备份。远程后台也能操作，本机弹窗登录照旧可用
• 央视频登录态自动保活，几天不看也不掉线：官网 SDK 的刷新令牌 48 小时有效，且只在浏览器页面开着时才续期；而后台 Chromium 会员频道停播 45 秒后就会关掉，家里两天没人看会员频道，登录就没了（弹窗登录和导入登录都受影响）。现在只要关联过账号，服务端每 6 小时静默拉起一次后台会话让 SDK 续期再关掉，启动后约 90 秒也会先续一次；没关联过账号的部署不会为此启动浏览器
• 新增「央视频会员频道登录教程」系统短片：书签导入那套操作光看文字不容易懂，现在「公告」分组里多了一条 30 秒的教程短片，六页演示拖书签、登录官网、点书签、粘贴导入的全过程，电视上就能看。和公告一样可以在「我的频道」逐条隐藏，不支持删除、移动、排序或重命名；短片由 assets/ysp-login-guide-source.html 经 npm run generate:ysp-guide 生成，生成脚本已支持多目标
• 新增安徽广电 7 路官网直播：安徽卫视、经济生活、影视、公共、农业科教、综艺体育、国际频道全部纳入独立「安徽」分组，免登录、零配置、默认开启。服务端按「安徽视讯」App 的公开算法解出直播鉴权密钥、逐路生成两小时有效的腾讯云签名，并让播放器每次轮询都重新拉取滚动清单（官方清单只含 3 个 2 秒分片，复用旧清单几秒就会卡住）。该 CDN 按播放器标识放行：App 自己的 ijkplayer 能过，VLC / Apple / ExoPlayer 等常见播放器标识一律 403，因此清单与分片统一由本机以 App 标识全代理，播放器不直连 CDN；为此代理层允许模块用函数形态请求头指定 User-Agent，其余模块行为不变。官网旧接口的 8 路地址实为「网站直播已下线」占位画面，未收录；9 路安徽广播不进电视列表
• 文档：README「产品预览」三张截图换成当前版本的后台主面板、源管理与实况播放效果

v4.10.0 (2026-09-06)

本次为「央视频会员频道、后台改版与地方台大扩充」版本：央视频在 63 个公开频道之外接入 10 个本人账号可看的会员频道，在本机登录一次官网即可长期复用，会员流自动解扰成普通播放器能播的 H.264；管理后台整体换成浅色、扁平、更舒展的新视觉，功能与操作路径不变；新增北京、重庆、四川、江西、贵州、甘肃、新疆、吉林、内蒙古九地官方广电与 iPanda 共 110 余路直播，福建省级线路改为播放时自动续签，精选列表补入宁夏三台；默认分组顺序改为央视频置顶、地方台沉底，咪咕去掉不可播与重复的分组；系统公告短片重制为 1080p，并可在后台按需隐藏；另修复换台标不生效、央视频误显回看入口、全代理长播断流和凤凰台标裂图。升级镜像即可生效，现有订阅无需重新添加。

• 央视频新增 10 个本人账号可访问的会员频道，并把本机登录与“有声无画”兼容桥接完整接入主项目：原有 63 个公开频道保持匿名动态取流；会员频道从「源管理 → 央视频」在服务所在电脑的 localhost 后台打开央视频官方登录窗，登录态只保存在本地 Chromium profile，服务会自动复用会话、刷新短效签名，并把官网播放器解扰后的音视频重组为普通 IPTV 客户端可播的 H.264/AAC HLS。旧版 63 台磁盘缓存会在首次启动时按频道表版本自动重建，无需等 24 小时或手工刷新。Docker/NAS 无法远程弹出首次登录窗，远端管理页会明确禁用相关按钮；会员到期、官网退出或要求重新验证时仍需重新登录/续费
• 管理后台整体改版：换成浅色、冷调、扁平、更舒展的新视觉——顶栏把品牌、主导航和运维操作各自分组；按钮只有主操作用实心、其余白底描边，不再有立体渐变；「我的频道」保留高频操作的效率但拉开了栏间与行间；内容源卡片本身保持中性，颜色只用来表示类型和状态；设置页每个字段各自成卡，层级更清楚、更好扫读；弹窗和页内播放器是全站唯一保留明显阴影的层级；关于页改成与其它页一致的信息卡。功能与操作路径都没变，老用户不用重新适应
• 新增北京广播电视台：北京卫视、BRTV 文艺 / 纪实科教 / 影视 / 财经 / 体育休闲 / i生活 / 新闻、卡酷少儿 9 个电视频道，以及北京时间当前公开的活动或慢直播。公开直播免登录并自动排除失效项目；9 个电视频道需在「源管理 → 北京广播电视台」导入本人北京时间 Cookie（也可用 mBtimeCookie 环境变量），模块先验证再启用，失效时只隐藏电视台并给出提示、免登录直播照常。凭据只发给官方取流接口，不写进订阅、不发送到媒体 CDN；清单和分片由本机补齐防盗链请求头并代理，macOS 本地会自动沿用系统 HTTPS 代理，Docker / Linux 可按需设置标准 HTTPS_PROXY
• 新增重庆广电：官网当前公开的 CQTV新闻，免登录、零配置、默认开启；频道表自动同步，播放时匿名换取短效 HLS，清单、AES 密钥和媒体分片由本机全代理
• 新增四川广电：四川卫视、新闻、经济、文化旅游、影视文艺、妇女儿童、四川乡村、康巴卫视、四川卫视 4K 超高清 SDR 共 9 个电视台，以及官网当前公开的活动直播（有则显示、无则隐藏、免登录）。9 个电视台需要部署者本人的四川官网登录态，后台提供书签工具一键读取官网 Token；播放时动态换取短效地址，清单、密钥和媒体分片补齐官网防盗链请求头并全代理
• 新增江西广电 8 路官网直播：江西卫视、都市、经济生活、公共农业、少儿、新闻、移动电视、陶瓷全部纳入独立「江西」分组，免登录、零配置、默认开启。服务端按官网公开算法自动换取匿名短效 token，并让播放器每次轮询都重新拉取滚动清单，避免复用仅含三个 3 秒分片的旧清单而在约 9 秒后卡住；清单、密钥和媒体分片统一补齐防盗链请求头并全代理。官网当前八路均为单档 720p，无登录解锁更高清的 Web 机制
• 新增贵州广电 8 路官网直播：贵州卫视、公共、影视文艺、大众生活、生态乡村、科教健康、经济、移动电视全部纳入独立「贵州」分组，免登录、零配置、默认开启；家有购物明确排除。播放时从官网公开 API 刷新短效签名地址，播放器每次轮询重新拉取只有三个 3 秒分片的实时清单，避免缓存快照导致约 9 秒后卡住；清单、密钥和媒体分片均经官方域名与频道路径校验后由本机全代理
• 新增甘肃广电 6 路官网直播：甘肃卫视、文化影视、移动电视、少儿、科教、公共应急全部纳入独立「甘肃」分组，免登录、零配置、默认开启。六路共用官网频道表缓存，但播放器每次轮询都会重新获取滚动 HLS 清单；入口失效会立即重读频道表，接口短时故障则使用最近一次成功地址并退避重试。服务端只中继小型清单，媒体分片由播放器直连官方 CDN，避免长期播放占满服务器带宽。官网当前少儿频道为 540p，其余五路为 720p，均为 H.264/AAC、25 帧
• 新增新疆广电 5 路官网直播：新疆卫视、维吾尔语新闻综合、哈萨克语新闻综合、体育健康、少儿全部纳入独立「新疆」分组，免登录、零配置、默认开启。播放时发现丝路视听网当前 Nuxt 构建并静态解析当天公开签名材料，不执行下载脚本；结合官网时间接口生成 MD5/RSA 请求签名，再从公开频道接口换取约一小时有效的 HLS。入口缓存会在失效时自动重签，滚动清单每次播放请求重新获取并校验官方域名、频道目录和鉴权参数；默认仅中继清单以节省服务器带宽，也支持 ?relay=2 全代理。官网当前将 XJTV-4、XJTV-5 标记为禁播且对应 CDN 实测 404，因此不纳入频道表
• 新增吉林广电 28 路官网直播：6 路省级频道和 9 路地方台归入「吉林」，13 路慢直播归入「吉林风景」，免登录、零配置、默认开启。省级频道与 9 路季节性景观在播放时从官网加密接口解析约四小时有效的 HLS，9 路地方台与 4 路固定景观使用已验证的官方 HTTPS 入口；所有清单、密钥和媒体分片都经过官方域名白名单校验并由本机全代理
• 新增内蒙古广电 20 路官网直播：内蒙古卫视、内蒙古蒙古语卫视等 8 路自治区频道及呼和浩特、包头等 12 路盟市频道，全部纳入唯一的「内蒙古」分组，免登录、零配置、默认开启。播放时复现奔腾融媒官网公开的 XXTEA 加密频道协议获取当前 HLS；频道 ID、官方主机和媒体路径均严格校验，清单、密钥和媒体分片补齐 Referer 后由本机全代理。官网接口短时不可用时，仅内蒙古卫视和内蒙古蒙古语文化频道使用已验证的官方备用入口
• 接入 iPanda 22 路官网公开直播：成都、都江堰 2 个 24 小时总频道与 18 个固定熊猫机位，加上江苏大丰麋鹿、云南白马雪山 2 路珍稀动物直播，统一归入独立「iPanda」分组并在源管理中提供一个零配置开关。固定机位走支持 CORS 的官方 CDN 直连，4 路动态频道播放时读取央视公开接口、实测最高档子清单并在官方 CDN 间自动回退，清单、密钥和媒体统一由本机安全代理。22 路最高均为真实 1280×720；官网把该档称为“超清”，1080p 对应的“蓝光”并未下发，匿名接口已给出全部画质，登录不会解锁更高档
• 福建省级线路改为播放时自动续签：东南卫视等省级六路改用官网直播页的短效签名接口，播放时生成约 2 小时 47 分有效的地址并自动续签，只中转清单、分片由播放器直连官方 CDN；海博继续提供重点地市频道，福州综合 / 生活 / 少儿与厦视一套 / 二套 / 三套不依赖海博，各平台独立工作、任一异常不影响其它线路
• 精选列表补入宁夏三台：宁夏卫视、宁夏公共、宁夏文旅加入内置精选列表的「宁夏」分组，随远程列表更新，无需升级镜像即可看到
• 默认分组顺序：央视频置顶、地方台沉底、咪咕精简：央视频紧跟公告排在最前——它匿名就能提供 41 个与咪咕重叠的央视 / 卫视频道的 1080p，而咪咕游客档止于 540p、1080p 要会员；地方台分组统一沉到底部，景观 / 慢直播分组（景观、吉林风景）贴在地方台上方。旧配置档还没记录央视频时会自动把它放到最前，用户显式拖拽过的顺序仍然优先。咪咕去掉无法播放的上视东方影视（「上海」分组随之消失）和已由 iPanda 模块提供的整个「熊猫」分组，输出从 96 路减到 84 路
• 公告短片重制为 1080p：「欢迎使用 iPTV for iFansClub.com」公告视频按新版后台的视觉重新制作，1920×1080，体积反而比原来小；视频由仓库内的 HTML 源稿经 scripts/generate-announcement-video.mjs 生成，以后改文案不必手工剪辑
• 系统公告频道可以隐藏了，详情卡只留有用的：公告频道此前和普通频道一样不能隐藏，详情弹窗还堆着节目单配对、别名、TVG、台标上传等对公告毫无意义的内容。现在「我的频道」里可以像普通频道一样隐藏它（不想在电视上放这条短片就藏起来，随时可在「已隐藏」里恢复），详情卡精简为名称、播放预览和隐藏 / 恢复；删除、移动、排序、重命名仍不支持，显示时固定在第一位（issue #119）
• 修复后台点公告频道「在页面里播放」报 manifestParsingError：网页播放器把所有同源地址都当 HLS 交给 hls.js（延迟解析频道的旧地址没有 .m3u8 后缀，本机按 HLS 直出），公告短片 /assets/announcement.mp4 恰好同源，被当成清单解析后直接报错。现在 mp4 / webm / mp3 等直连媒体后缀一律走浏览器原生播放，独立播放页同时放开进度条；其它频道行为不变（issue #119）
• 修复后台换了台标、电视上还是旧图：本地上传的台标写进订阅的地址固定是 /logos/.png，移除后重传同名图片地址一字不变，播放器按地址缓存台标（多数永不过期），后台看文件已是新图、电视上显示的仍是第一张。现在台标地址尾部带上文件修改时间作为版本号（?v=…），换图即换地址、播放器重新拉取；台标路由同时补齐 ETag / Last-Modified 并支持 304 条件请求，不认 query 的客户端也能校验新旧。手动放进 logos/ 目录的图同样适用；升级后清单重生成即生效，已缓存旧图的电视重新加载播放列表即可（issue #119）
• 央视频频道不再显示无效的回看入口：订阅头的全局回看声明此前会套到央视频 73 个频道上，播放器据此在节目单里给出回放按钮，点了却只能拿到直播（模块从未实现回看）。现在央视频频道逐条标为 catchup="none"，播放器不再显示回看入口；要回看同一个台请切到播放器里同名频道的咪咕线路。频道表版本递增，升级后启动时自动重建缓存，无需手动刷新（issue #119）
• 修复全代理多码率直播连续播放约 10 分钟后断流：播放器持续轮询嵌套子清单或请求分片时会刷新代理地址的空闲期限与最近使用顺序；只有停播超过 10 分钟的地址才会回收，避免活跃子清单被固定 TTL 清掉后返回 404
• 修复凤凰卫视三台台标全部裂图：模块里写死的台标地址挂在 c1.fengshows-cdn.com，该域名的 HTTPS 已经握不上手（大陆、香港、美国探针全部 TLS 握手失败，走 http 才能拿到图），播放器和后台里凤凰资讯 / 凤凰中文 / 凤凰香港三台一律显示无台标。凤凰秀官网现在把同一批文件挂在 q1.fengshows.com 下、路径一字不差、文件内容一致，且大陆直连可达，现改用该地址。升级后清单重生成即自动生效；已自行上传本地 logos/ 台标的用户不受影响（issue #118）

v4.8.1 (2026-09-05)

本次为「咪咕取流日志整理」版本：成功取流只打一行「咪咕取流：档位」，账号没订购某条内容的产品但流已正常下发时不再报红字，只给试看时改黄字并写明秒数，红字只留给真正拿不到地址的情况。升级镜像即可生效，现有订阅无需重新添加。

• 咪咕取流日志改为一行摘要，不再把正常播放报成红字：此前每次取流打「登录认证成功」，账号没订购该内容的产品时再补一行红字「认证失败 视频内容不完整 可能缺少相关VIP」——可那时流已经正常下发（内容本身允许播放，或咪咕只给了几分钟试看），看着像出错其实什么都没坏；真正要紧的「拿到哪一档、试看多少秒」反而不打，issue #117 排查时全靠播放器截图。现在成功取流只打一行「咪咕取流：臻享 超高清」，游客标「游客」，命中缓存标「缓存」；只给试看时改黄字并写明秒数，如「咪咕取流：臻享 超高清 · 仅试看 360 秒」；红字只留给拿不到地址的情况

v4.8.0 (2026-09-05)

本次为「咪咕 4K 权益与容器抓取修复」版本：咪咕 4K 被大屏策略拒绝后改按手机策略再要一次，足球通等不含电视端的三屏会员不再卡在 1080P，拒绝日志改为带咪咕原话与实际降到的档位；纬来体育在 NAS 官方镜像里抓不到的根因是 Alpine 版 Chromium 一遇深递归就崩掉渲染进程，改为先在沙箱里解析播放器页、不起浏览器即可拿到地址，并给该 Chromium 压小 JS 栈预算兜底；大陆用户外部 / 抓取模块频道的台标改用 jsDelivr 镜像，不再全部裂图；凤凰三台只保留在「香港」，不再复制出一个空的「亚太」分组。升级镜像即可生效，现有订阅无需重新添加。

• 咪咕 4K：足球通等不含电视端的「三屏」会员此前只能拿到 1080P，现在被大屏策略拒绝后会改按手机策略再要一次 4K：4K（rateType 9）请求一直带着 ott=true，这是咪咕的「大屏 / 电视终端」取流策略，按大屏（四屏）权益判定；三屏会员在这条路上被判「需会员」，代码随即降到蓝光，日志还打「该账号没有会员」，用户明明有会员却被带着去纠结账号。用「4K赛场原声」实测：游客带 ott 直接 409 连降级流都不给，不带 ott 则正常降到 540P、且可选档位里就列着 rateType 9「臻享 超高清」，手机策略本身就有 4K。现在被大屏策略拒绝后先原样按手机策略再要一次 4K，仍被拒才按咪咕愿意给的档位降级（它给到蓝光就要蓝光，此前给蓝光也会再降一级到高清）；含大屏权益的账号第一次就成功、路径不变；拒绝日志改为带咪咕原话与实际降到的档位。回归测试 scripts/test-migu-4k-fallback.mjs（issue #117）
• 纬来体育在 NAS 容器里抓不到：根因是镜像里 Alpine 版 Chromium 一遇「深递归且每层有分配」就崩掉渲染进程，改为先「沙箱解析」、并给该 Chromium 压小 JS 栈预算：用户容器日志显示入口页与播放器 iframe 都能打开，卡在跨域播放器 iframe「10 秒不响应脚本执行」、页面上 xgplayer 两个脚本「无响应」，三个入口轮完全部失败，同一网络的电脑浏览器却能正常播。在官方镜像（Alpine 3.24 / Chromium 152）里用本地副本复现并二分定位：播放器页的 jsjiami 混淆脚本带 obfuscator.io 的 debugProtection——每 2 秒一轮「递归到栈溢出再 catch RangeError」，而这个 Chromium 上每层带分配（对象 / 数组 / 字符串）的递归到一千多层时渲染进程直接崩、不抛 RangeError（普通递归到一万七千层都正常），iframe 一进来就死，puppeteer 只能等到超时；「脚本无响应」是渲染进程崩了之后网络事件发不出来的表象，不是网络不通。两处修：① 内置抓取源每个入口先「沙箱解析」——把入口页与其播放器 iframe 的脚本放进独立 worker 线程的 node:vm 里按顺序跑一遍（跨域的播放器库、统计脚本一律不下载），收集交给播放器（new Player({url}) / hls.loadSource() 等）或写进 DOM 的 m3u8，带 Referer 校验通过即用，本机实测 6 秒、几 MB 内存、不起 Chromium；沙箱拿不到或校验不过才起浏览器嗅探。沙箱只传字符串、不暴露任何宿主对象，同步死循环 3 秒截断，吃内存的脚本由 worker 内存上限兜住，不会拖死主进程；源可用 extractOptions.sandbox=false 关掉。② Alpine 环境（即官方镜像）起 Chromium 时加 --js-flags=--stack-size=96，V8 在撞穿原生栈之前先抛 RangeError 让页面自己 catch（64 / 96 / 128 验证可用、160 仍崩），官方镜像里原样的浏览器抓取从「全部失败」变为 2.8 秒拿到地址，其它网页抓取源与外部「网页提取」源一并受益；桌面 Chrome 没这个问题、不加，代价是页面 JS 递归上限约八百层。回归测试 scripts/test-player-page-sandbox.mjs 用真实播放器页快照做 fixture；排查脚本 scripts/probe-builtin-fetch.mjs 新增沙箱阶段
• 修复大陆用户外部 / 抓取模块频道台标全部加载不出来：央视频、B 站、虎牙、精选频道等没有自带台标的频道，此前按名兜底取图的默认地址是 live.fanmingming.com，该域名及其 .cn 镜像在大陆均被 DNS 污染、根本连不上（大陆探针 30/30 失败），表现为 LunaTV 等播放器里咪咕频道有台标、其它源全是裂图。默认地址改为同一台标库的 jsDelivr 镜像（gcore.jsdelivr.net/gh/fanmingming/live@main/tv/），文件一一对应、大陆直连可达，升级后清单重生成即自动生效、无需任何操作；已自行设置 mexternalLogoBase 或放了本地 logos/ 的用户不受影响。环境变量 mexternalLogoBase 补进配置表与 compose 示例（issue #25 / #114）
• 凤凰三台不再置顶复制到「亚太」：v4.7.0 起内置精选列表的港澳台频道已全部按「香港」「台湾」归组，「亚太」分组不再有任何内置条目，凤凰秀官方三台再复制一份进去只剩一个孤零零的空壳分组。现在三台只保留在「香港」，与内置的三条第三方凤凰线路并列，仍是置顶不顶替；外部订阅自带的「亚太」分组及其中的凤凰条目原样不动，播放器按名聚合时官方源照旧排在前面

v4.7.0 (2026-09-05)

本次为「启动提速与直播源整理」版本：纬来体育等网页抓取源改为在首份播放列表生成之后在后台抓取，启动不再被它拖住十几分钟，单个入口抓不到最多约 35 秒即放弃，抓不到也不再清掉仍可用的旧地址；亚洲与国际直播模块只保留 YTN、NHK World 两个需要动态解析的频道，50 个固定直连源改由内置精选列表 IPTV.m3u 提供，并同步复核清理了精选列表的旧条目；升级后自动清理旧模块残留的缓存频道。升级镜像即可生效，现有订阅无需重新添加。

• 纬来体育等网页抓取源不再拖慢启动，单次抓不到也不再耗时数分钟：v4.6.1 的容器日志显示启动后 13 分 44 秒全在等纬来体育，外部源、抓取模块、播放列表生成都排在它后面干等；每个入口固定耗时 6 分 3 秒——兜底「触发播放」与页内找链接各执行一次页面脚本，渲染进程被阻塞时 puppeteer 要等满默认 180 秒的协议超时才放弃，错误还被静默吞掉。现在：① 启动先用缓存生成播放列表，需要网页抓取的内置源放到列表生成之后在后台抓，抓到再补一次「仅重新生成」；抓取加防重入，5 分钟定时刷新撞上正在抓的那一轮直接跳过（此前启动那轮与第一个 tick 会同时各起一个 Chromium 抓同一个源，退避计数也被记两次）；② 页面脚本执行加 10 秒上限、超时的 frame 后续不再碰，alert / confirm 弹窗自动关闭，主文档 10 秒内零响应即放弃（国内访问被 DNS 污染的 jrkan.com 此前每轮白等 30 秒），页面导航上限从 puppeteer 默认的 30 秒改为 15 秒（健康页面 4~5 秒就拿到清单，嗅到即走，上限只在页面卡死时才会等满；可按源用 extractOptions.timeout 覆盖），单个入口最坏约 35 秒、一轮三个入口约 1.5 分钟；③ 抓取失败先带 Referer 校验缓存里的旧地址，仍可用就沿用（该 m3u8 多日不变），校验不过才清，频道不再因一次抓不到就整个消失；④ 导航超时时把仍挂着的请求按域名列进日志（挂了多久、有没有响应），不响应脚本的 frame 也会报出，内网抓不到时从容器日志即可看出卡在哪一跳，不必再进容器跑探测脚本。真实 Chromium 验证脚本 scripts/verify-web-extract-timeout.mjs 补了主线程死循环、页面 alert、零响应三个场景
• 亚洲与国际直播整理：模块只保留 YTN、NHK World 两个动态解析频道，固定直连源改由内置精选列表 IPTV.m3u 提供：v4.6.0 起模块里的 43 个频道每次播放都要经本机解析、校验并代理清单与媒体，但其中绝大多数只是固定 HLS 地址，走这条链路只是多一跳转发。现在 IPTV.m3u 新增独立标记区块「亚洲直播实验台已处理直连源」，收录 50 个按直连方式复核过的固定地址（原模块迁来 27 个，新增 Wipeout Xtra、Graham Norton、Rai Italia、History Hit、Court TV、Documentary+、CGTN Documentary、Sky Racing、FUEL TV、FloRacing、World Poker Tour 等 23 个），每条附实验台备注；模块只留必须先访问官方接口才能拿到当前地址的 YTN 与 NHK World。需要防盗链 Cookie 或 Referer 才能播的 TVB 新闻、Bloomberg 三台，以及未列入实验台直连清单的 DW 两台、Al Jazeera、ABC News Australia、Al Arabiya、National Geographic、NASA+、France 24 Arabic、NBC Sports NOW、Stadium 共 14 个频道不再提供。精选列表原有条目同步绕过 VPN 逐条复核根地址与实际媒体数据：「影视」组的龙华 / 靖天 / TVB 星河等转流条目、香港 TVB / ViuTV / HOY / NOW / 澳门 / 新加坡各台、台湾 4gtv 系列，以及 v4.6.0 补充的纬来日本、纬来育乐 RTMP 源整体清理；翡翠台、公视 / 民视 / 华视 / 台视高清、TVBS 亚洲复核通过保留并按「香港」「台湾」归组，三条第三方凤凰线路归入「香港」。精选列表由运行中的实例直接从仓库拉取，这部分不用升级镜像即已生效
• 升级后自动清理抓取模块里新版不再认领的缓存频道：模块升级后磁盘缓存 extractor-cache.json 里可能还留着旧版频道的延迟解析引用，本版亚洲与国际直播模块从 43 个缩到 2 个，若原样输出，已迁入 IPTV.m3u 的频道会和旧缓存同时出现，旧缓存那份还会生成永远解析不了的本地代理地址。现在每次加载缓存都按模块当前认领范围收口、落盘并打印清理数量；不带延迟解析引用的普通缓存频道不受影响

v4.6.1 (2026-09-05)

本次为「亚洲直播代理修复」版本：亚洲与国际直播模块改回清单、密钥与媒体全部由本机代理，修复 TVB 新闻等依赖防盗链 Cookie 的频道以及 Bloomberg 美国 / 欧洲台在 v4.6.0 播放失败的问题，Cookie 按域名与路径限定发送、回源重定向逐跳复验白名单；纬来体育把海外可达的入口提前，海外或走代理的部署不再整轮落空。升级镜像即可生效，现有订阅无需重新添加。

• 修复亚洲与国际直播模块的播放链路：v4.6.0 里该模块默认只中继清单、媒体分片由播放器直连 CDN，但 TVB 新闻这类平台的 CDN 要求分片请求也带上清单响应下发的会话 Cookie，播放器直连时拿不到 Cookie 会被拒；Bloomberg 美国 / 欧洲台的清单会指向不在白名单里的备用 CDN 域名，被模块按「不允许访问媒体地址」拦下；不能跨站取流的播放器也放不出来。现在清单、密钥与媒体分片统一由本机代理，Cookie 严格按响应主机的 Domain / Path 限定，只发给对应 CDN 的对应路径，不会泄漏给其它主机；代理层回源改为逐跳手动跟随重定向（最多 3 跳），每一跳都重新过模块白名单、跳出即拒绝，固定请求头跨站跳转时自动剥掉 Cookie / Authorization；Bloomberg 三台补齐 fastly 与 akamaized 两套 CDN 域名。代价是 Love Nature 4K 等高码率频道现在会占用本机转发带宽，不再是 v4.6.0 说明里的「媒体直连 CDN」
• 纬来体育入口顺序调整：jrkan.com 从候选末位提到主地址之后的第一顺位。四个国内镜像只放行国内 IP，jrkan.com 是海外可达的入口，此前排在第六位，而每轮最多只试 3 个入口，海外或走代理的部署一旦主站抓不到就整轮落空、永远轮不到它；国内部署不受影响（jrkan.com 在国内 DNS 被污染、连接失败会立即跳过换下一个），已缓存的地址也不会因调整顺序而重抓。该清单由运行中的实例直接从仓库拉取，不用升级镜像即已生效
• 文档：去掉首页过时的「v4.3.0 已接入央视频」提示

v4.6.0 (2026-09-05)

本次为「亚洲与国际直播接入」版本：新增零配置的亚洲与国际直播模块，一次带来 43 个经验证的公开频道（TVB 新闻、YTN、NHK World、DW、Bloomberg、France 24、Reuters，以及体育、文旅、宠物、台湾、娱乐时尚等），内置精选列表同步去重整理；管理后台视觉刷新并支持在页面内直接播放；修复纬来体育等网页抓取源在内网「早已嗅到地址却因导航超时被整次丢弃」的问题；凤凰三台改为置顶不顶替，第三方同名条目保留作备用线路。升级镜像即可生效，现有订阅无需重新添加。

• 接入亚洲与国际直播模块：把独立实验项目验证过的 43 个有效频道收编为主项目零配置模块，覆盖 TVB 新闻、YTN、NHK World、DW、Bloomberg、France 24、Reuters，以及体育、文旅、宠物、台湾和娱乐时尚内容；已断流的 NASA Legacy 不进入生产频道表。固定 HLS 与 TVB / YTN / NHK / NASA 动态接口统一在播放时解析，重定向、根清单及其子资源均受精确协议、端口和主机白名单限制；模块默认只中继实时清单、媒体由播放器直连 CDN，避免 Love Nature 4K 等高码率频道占满 NAS 带宽，需要时仍可用全代理订阅
• 管理后台视觉刷新 + 页面内播放：保持浅色与原有配色，面板、卡片、频道行统一为更大的圆角与细边框，悬停只变边框色不再位移；普通按钮改为白底细边框、圆角统一，主色 / 成功 / 危险 / VLC / IINA 按钮保留各自填充色；各类小标签统一为胶囊形。新增页面内播放器：「我的频道」每行常显「▶ 播放」，频道详情弹窗也有「▶ 在页面里播放」，弹窗直接起播不再跳新窗口（HLS 用 hls.js 按需加载、FLV 用自带 mpegts.js、Safari 原生 HLS 兜底），可一键改为「新窗口打开」回到独立播放页；关闭 / Esc / 点遮罩都会释放播放器
• 修复纬来体育等网页抓取源「科学上网能抓、内网经常抓不到」：抓取器此前要等页面完全空闲（networkidle2）才算加载成功，内网访问这类页面时常有某个跨境资源一直挂着，页面 30 秒都到不了空闲，导航超时后整次抓取按失败处理，把早在几秒内就已嗅探到的 m3u8 一并丢掉，换下一个入口再重蹈覆辙。现在导航与嗅探赛跑：嗅到清单立刻收工，不再陪页面把所有资源加载完；导航超时也不算失败，继续在已加载的内容里嗅探；站点根本不通（连接失败 / 零响应）则立即放弃，把时间留给下一个入口。兜底「触发播放」与页内找链接也改为遍历所有 frame，播放器在跨域 iframe 里（jrs 系页面即如此）时不再只查主页面。附带独立排查脚本 scripts/probe-builtin-fetch.mjs：不启动整个项目、只对一个源跑一遍完整链路，逐步给出 DNS / 入口页 / 播放器依赖 / 浏览器嗅探 / m3u8 校验的诊断，方便在内网与代理两种网络下对比。另实测纬来体育六个入口的地域可达性正好互补——四个备用入口只放行国内 IP（海外 403）、jrkan.com 在国内被 DNS 污染，入口顺序保持不变
• 凤凰三台改为「置顶不顶替」：凤凰秀官方三台仍置顶复制到「亚太」，但亚太里其它来源（外部订阅、内置列表）的同名凤凰条目不再被顶掉，原样排在官方三台之后作备用线路，不合并；「香港」分组照旧。播放器按名聚合时官方源在前即为默认源
• 内置精选列表同步整理：已并入亚洲与国际直播模块的国际新闻、体育、纪实、娱乐时尚等条目从内置 IPTV.m3u 移除，不再与模块重复；同时移除 Sky News、FashionTV、央视付费频道、美国影视等一批第三方转流条目；「体育」补充纬来体育，「台湾」补充纬来日本、纬来育乐。该列表由运行中的实例直接从仓库拉取，不用升级镜像即已生效

v4.5.0 (2026-09-03)

本次为「凤凰卫视接入」版本：新增凤凰卫视三台（登录本人凤凰秀账号即可 720p，无需付费会员）与大连三个正式电视频道；内置网页抓取源支持配置多个入口地址、主站打不开时自动换备用地址重试；并修复辽宁省台、上海频道、央视频三处播放问题与 LunaTV 漏导入频道的兼容问题。升级镜像即可生效，现有订阅无需重新添加。

• 新增凤凰卫视直播模块：接入凤凰资讯、凤凰中文、凤凰香港三路电视直播，归入「香港」分组，同时置顶复制到「亚太」分组（找凤凰不必先想它算不算「香港」），两处都在。游客为 854×480；在「🌐 源管理 → 凤凰卫视」导入本人凤凰秀账号的 Token（支持粘贴 Token 值或包含它的整段 Cookie，也可用 mFengshowsToken 环境变量）后，三台均为 1280×720 / 25 fps，普通账号即可，无需付费会员；凭证随主项目配置持久保存，重启无需重填。只提供直播，不接入回看、点播与栏目目录；播放时实时向官方取新签名，Token 不发送到媒体 CDN、也不写入订阅。直播为 HTTP-FLV，本机只转发不转码——网页播放器已内置支持，外部播放器需自身支持 HTTP-FLV
• 凤凰三台以官方源为准：其它来源（内置精选列表、外部订阅）提供的同台条目自动让位，命名变体（如「凤凰卫视中文台」）一并覆盖，播放器的「源1 / 源2」里不会再混进画质不明、随时失效的第三方转流
• 新增大连云直播模块：接入大连新闻综合、大连生活、大连文体三个正式电视频道，源管理里独立成「大连」卡片可单独开关，播放列表统一归入「辽宁」分组
• 内置抓取源支持多个入口地址：网页抓取型内置源改为可配一份候选清单，主站打不开或抓不到时自动换下一个地址重试（每轮最多试 3 个），上一轮抓成功的地址下轮优先。纬来体育所在的 jrs 系站点常换域名或被墙，此前单一地址一失效整个源就失联，现已补上四个备用入口。入口清单走远程配置，站点变动时改仓库文件即生效，不用等升级镜像
• 修复辽宁省台无法播放：北斗融媒的 CDN Referer 与拉流密钥会由平台轮换，模块此前把某次取得的值固定在代码里，过期后省台清单被 CDN 以 403 denied by Referer ACL 拒绝（沈阳台的 CDN 恰好不校验，因此表现为「沈阳能播、省台不能」）。现在按官方客户端的公开鉴权协议动态取得并定时刷新，失效自动换新（issue #112）
• 修复上海频道取不到直播地址：看看新闻已改为按当前正在播出的节目发放播放地址，频道详情接口不再直接下发；现在先查官网当前节目再取地址，并随节目结束时间自动换新。遇到节目因版权限制暂停网络直播时给出明确说明，不再沿用必然被 CDN 拒绝的旧地址
• 修复央视频偶发播放失败：选线探测成功后立刻二次取清单，会被官方 CDN 按「短间隔重复请求」拒绝（403）。现在把探测时已取回的清单正文直接下发，缓存里只留官方主备入口、不再混入 CDN 重定向后的临时地址，主备全失败时提前换票
• 修复 LunaTV / MoonTV 漏导入央视频、虎牙、斗鱼频道：部分版本只把 #EXTINF 紧接的下一行当播放地址，中间的 #EXTVLCOPT:network-caching 缓冲提示会让整个频道被丢弃。对外订阅已省略仅含缓冲提示的选项块（防盗链所需的 Referer / User-Agent 仍保留），升级后在 LunaTV 后台刷新直播源即可，订阅地址无需更换（issue #114）
• 文档：README 新增「凤凰卫视怎样开启 720p」「LunaTV 导入不到频道」两条 FAQ，首屏突出 Docker 部署入口；维护者发版流程加入创建 GitHub Release 的步骤，发布说明由 bump-version.js release-notes 从更新日志生成，与 README 同源

v4.4.0 (2026-09-02)

本次为「低配机稳定」版本：修复多个无头 Chromium 同时运行，把内存 ≤2G 的 NAS / 小主机拖进交换分区、表现为服务卡死与硬盘狂读写的问题——全进程共用浏览器启动器限制并发、抓取失败指数退避、网页抓取只嗅探不播放；新增 mbrowserConcurrency 环境变量。升级镜像即可生效，现有订阅无需重新添加。

• 无头浏览器并发上限：新增全进程共用的浏览器启动器，同时存活的 Chromium 不超过 mbrowserConcurrency（默认 2，超出的排队；广东台 / 湖北台 / 央视景观的常驻会话空闲时主动让位，5 分钟无人取票整个关掉）。位子以浏览器进程真正退出为准归还，进程在登记前就崩溃也会立即释放，不会出现上限一路缩水到 0 的情况；统一启动参数（关 GPU / 磁盘缓存、静音、--disable-dev-shm-usage），候选二进制去重，启动超时直接失败、不再逐级换浏览器往过载的机器上加负载。内存 ≤2G 建议设 1；经常同时观看广东 / 湖北 / 央视景观多路频道且内存 ≥4G 可设 3
• 抓取失败指数退避：网页抓取型内置源 / 外部源（如纬来体育）抓取失败后按 10 → 20 → 40 分钟退避（上限为该源自己的刷新间隔），成功即清零。此前每个 5 分钟检查都会重新起 Chromium 重抓，一个抓不到的源就足以把机器拖垮
• 网页抓取只嗅探地址：拦掉视频分片、图片、字体请求，不再把直播真的播上几十秒；广东台 / 湖北台 / 央视景观的取票会话同样拦掉图片、字体（后两者连媒体请求一并拦掉）。取票后不把页面导航走——广东台官网会在页面卸载时作废刚发的票据，导致清单 403
• 修复漏进程与噪音日志：广东台会话初始化半途失败时关闭浏览器，不再漏进程；央视景观取票 Promise 提前挂上 catch，消除「未处理的 Promise rejection」
• 本地验证工具：新增 scripts/verify-browser-launcher.mjs，用真实 Chromium 跑并发上限 / 空闲让位 / 分片拦截 / 失败退避四项（需本机有 Chromium，不进 npm test）；msourceTickSeconds / mbackoffBaseMinutes 两个测试用环境变量可压缩 5 分钟检查周期与退避基数（仅供测试）；npm test 新增浏览器位子与退避两组单测
• 文档：README 新增「服务卡死、硬盘不停读写」FAQ；央视频说明补全到频道覆盖、内容来源与 FAQ

v4.3.0 (2026-09-01)

本次为「央视频接入」版本：新增央视频官方直播模块，免登录、零配置、默认开启，一次带来 63 个官方高清频道；配套修正代理层四处会拖垮播放的通用问题（所有走清单代理/中转的模块都受益），并新增「忽略源自带分组」等频道管理能力。升级镜像即可使用，现有订阅无需重新添加。

• 新增央视频直播模块：接入央视频官方匿名接口，提供 63 个公开频道——央视全套、CGTN 多语种及各省级卫视，统一归入「央视频」分组（默认紧跟「央视」之后，旧配置档无需重新拖拽）。清晰度档逐频道校准（多数频道为 fhd 高码率档），播放时才实时生成官方短效地址并自动续签票据，主 CDN 异常自动切换备用；清单由本机中转（不跟随 302 跳转的播放器也能播），视频分片由播放器直连官方 CDN——实测平台按「谁来拉分片」判定异常流量，服务端代拉会被 403，播放器直连则与官方 App 行为一致。10 个需登录解锁的付费剧场频道不在收录范围
• 代理层四处修正（排查央视频播放问题时发现，与央视频无关、所有清单代理/中转模块通用）：直播清单不再缓存正文——缓存会让播放器在整个缓存期内反复拿到同一批分片、播十几秒即无片可放而卡死，改为每次实时取回、只缓存已验证可用的入口地址；选 CDN 时不再试拉分片——官方 CDN 对短间隔重复请求回 403，这一枪会把完全正常的主备线路全误判为不可用；播放器批量探活的清单 HEAD/OPTIONS 改为本地收口，不再逐频道触发上游解析链（实测打开订阅 2 秒内 HEAD 29 个频道，此前会瞬间打出上百个上游请求）；清单取回失败后熔断 2 秒，播放器连环重试（实测 1 秒 9 次）不再逐次转发上游，避免把正在正常播放的频道一起拖垮
• 订阅源新增「忽略源自带分组」：有些订阅自带的分组杂乱，以前会原样进入分组列表，而关键字自动分组规则又管不到它们（规则只对「未分组」生效）。现在在订阅源编辑里勾选「忽略源自带分组」，该源全部频道即按频道名走「设置 → 🗂️ 自动分组」的关键字规则归组，规则没命中的进该源「默认分组」；开关按源独立、不影响其它源，手动移动过的频道仍以手动设置优先（issue #110）
• 全局规则对全新配置档也生效：修复关键字自动分组、统一显示名在零个性化配置的配置档上不生效的问题——它们是全局配置，此前只有档内存在任意自定义时才会被应用（issue #69 / #56 的遗留缺口）
• 播放列表新增系统公告频道：首位固定提供项目自有的「欢迎使用 iPTV for iFansClub.com」公告频道，展示使用方式、版权提醒和侵权联系说明，不引用任何第三方节目素材；为确保每份对外分发的订阅都保留必要提示，该系统频道不支持隐藏、删除、移动、排序或重命名

v4.2.1 (2026-08-31)

本次为「全代理诊断与加固」版本（issue #98 排查配套）：订阅地址格式不变，升级后无需重新添加订阅。

• 全代理链路全程可观测：订阅拉取（含 ?relay= 参数）、清单下发、分片请求与转发结果（状态码、字节数、耗时）、302 跳转下发全部在默认日志留痕，每行带来源 IP 与 UA——curl 自查与播放器请求一眼可分；分片 404、CDN 拒绝代取、网络失败从完全静默改为可见提示。播放异常时只需试播一次、截取一段日志，即可定位卡在哪一环
• 分片 HEAD 探测真实回源：对播放器的 HEAD 探测向 CDN 发真实 HEAD 并带回 Content-Length / Accept-Ranges（与播放器直连 CDN 拿到的一致）；上游不支持 HEAD、长度不可信或分片需平台变换时自动回退合成应答，GET 行为不变。relay/proxy 清单的 HEAD 也改为返回与 GET 一致的响应头（含准确 Content-Length）
• 兼容性加固：清单行尾与 BOM 归一化（CRLF 上游不再产出混合行尾清单）；HTTP keep-alive 超时从 5 秒提高到 65 秒，避开直播清单 6 秒轮询节拍
• 修复：畸形 relay/proxy 路径不再被误当账号段返回整份订阅（改为 404 并记日志）；分片路由与清单路由的大小写匹配对齐；嵌套子清单取回失败改回 502，不再把未改写清单透传给播放器；代理地址表超上限时不再优先淘汰最活跃频道的地址

v4.2.0 (2026-08-30)

本次为「省市台与景观直播扩容」版本：新增 8 个省市广电模块与虎牙、斗鱼直播模块，接入央视网「直播中国」和上海松江慢直播，并为河北、福建补充景观与地市线路。新增内容全部免登录、默认开启，本版新增约 140 个官方频道与城市景观直播；连同 v4.1.0 的省级模块，官方广电与景观直播在各平台正常返回时合计可提供约 240+ 个频道，实际数量会随平台接口和直播状态动态变化。

• 新增 8 个省市广电直播模块：海南网台（7 个，海南卫视 / 三沙卫视及五个地面频道）、深圳广电第一现场（7 个，含深圳卫视4K / 深圳卫视及五个地面频道）、河北冀时（6 个非购物频道 + 13 路「美丽河北」城市景观）、辽宁北斗融媒（辽宁省台与沈阳台，最多收录 13 个白名单频道，并按当前 live 状态动态筛选）、湖北长江云新闻（6 个，湖北卫视 / 经视 / 综合 / 影视 / 教育 / 垄上）、广州花城+（3 个：广州综合 / 新闻 / 南国都市4K）、南京牛咔视频（4 个电视频道 + 13 路 Live 南京城市景观，自动剔除重复电视流）、青岛蓝睛（五四广场 / 奥帆中心及三路主干道城市直播）
• 新增官方景观直播：央视网「直播中国」按官网目录动态收录当前在线信号（现有约 57 路、覆盖 20 个地区），播放时从官网播放器获取 HLS；无需登录，日志中的浏览器会话仅用于执行官网播放器鉴权。央视清单与分片自动全代理以补齐 CDN 防盗链请求头，只有实际观看时才占用服务端带宽；上海松江客户端加入「松江融媒慢直播」，按公开场景清单更新主画面并排除内部测试流
• 福建官方线路扩充：省级六路改用官网直播页的短效签名接口，播放时自动续签；海博继续提供重点地市频道，另有不依赖海博的福州综合 / 生活 / 少儿，以及厦视一套 / 二套 / 三套官方直播。各平台独立工作，任一平台异常时仍保留其它线路
• 新增虎牙、斗鱼直播模块：与 B 站直播同款玩法——按所选分类自动收录热门直播间（虎牙默认「赛事」、斗鱼默认「网游竞技」，各按人气取前 8 并带最低人气门槛），也可手填房间号 / 直播间地址；分类、每类数量、人气门槛与优先画质（默认超清，可选原画）均可在源管理调整。两个平台免登录、默认开启，频道分别归入「虎牙」「斗鱼」分组；播放时才实时生成官方短效地址，本机只中转清单并补齐防盗链请求头，视频分片由播放器直连官方 CDN
• B 站内容与配置改进：热门榜最低人气改为可配置，默认从 10000 调低到 3000，填 0 可关闭过滤；默认分区改为「赛事 + 知识」，后台支持赛事、知识、生活、游戏等 12 个分区可视化多选；所有自动与手动频道统一归入「B站」分组
• 新增娱乐时尚与体育精选频道：「娱乐时尚」新增 FashionTV Paris L'Original、Global Fashion Channel、Qello Concerts、Totalmusic Concerts；「体育」新增 Stadium、MTRSPT 1
• 短效签名与代理按平台自动处理：广州按分钟刷新签名；深圳为每条 HLS 路径独立续签；河北按官网规则生成约两小时签名；福建省级六路播放时生成约 2 小时 47 分的地址；辽宁生成短效签名并携带租户防盗链；湖北复用匿名 Chromium 会话补齐 client-id 与防盗链；央视景观按需读取官网播放器鉴权结果；松江按公开场景清单更新长效地址。辽宁 / 湖北 / 深圳 / 厦门 / 央视景观清单与分片全代理，河北 / 福建省级 / 松江只中转清单，其余福建地市、广州 / 南京 / 青岛基本直连
• 容器数据目录迁移：默认数据目录从 /migu/data 调整为 /iptv/data；旧匿名卷与旧版 ./data:/migu/data 挂载会自动识别并继续沿用，无需手动迁移
• 省市频道归类：普通省市电视分组与源管理卡片统一只显示地区名，去掉「频道」「电视台」「地市台」等后缀；景观直播作为特殊类型仍保留「景观」后缀；广州、深圳频道与广东省台统一归入「广东」
• 省市模块命名：源管理中的省市广电卡片统一只显示地区名（如「辽宁」「广东」），不再把北斗融媒、荔枝网等平台品牌写入标题
• 默认分组顺序：新建配置档默认按「体育 → 昨天 / 今天 / 明天赛事 → 央视 → 卫视 → 亚太 → 国际 → 影视 → 少儿 → 教育 → 娱乐时尚 → 文旅 → B站 → 虎牙 → 斗鱼」置顶，之后连续排列地方台，景观分组统一置底；用户手动拖拽保存的顺序仍优先
• 咪咕地方频道精简：不再输出与免登录地方官方模块重复、且高画质受账号 / VIP 限制的咪咕「地方」分组；仅保留上视东方影视并入上海、陕西四个频道并入陕西、财富天下并入江苏；咪咕「新闻」中的地方重复源、公共新闻频道和中国天气全部移除，空分组不再显示
• 国际频道归类：项目自带的 Reuters、Sky News、NHK World、France24 从「新闻」调整到「国际」，默认紧跟在「亚太」之后
• 地方少儿频道归类：各地官方模块的少儿、卡通及动漫频道在地方分组保持完整，同时归入「少儿」分组；遇到咪咕等来源的同名或平台长名重复项时，内容分组优先保留画质更高的地方官方线路
• 地方教育频道归类：各地官方模块的教育、科教及教科频道在地方分组保持完整，同时归入「教育」分组；同台多源时内容分组优先地方官方线路，「少儿科教」类频道仍归「少儿」
• 地方体育频道归类：各地官方模块的体育、体育休闲及文旅体育频道在地方分组保持完整，同时归入「体育」分组；同台多源时体育分组优先地方官方线路
• 咪咕综艺分组移除：不再输出仅含「最强综艺趴」和重复江苏频道的咪咕「综艺」分组；地方综艺频道仍保留在各自省份分组
• 纪实分组精简：「纪实」统一更名为「文旅」，删除咪咕专题轮播「新动力量创一流」，以及已有河南 / 海南官方模块替代的梨园、社会与法、海南文旅咪咕副本
• CCTV5 双分组保留：CCTV5 体育和 CCTV5+ 体育赛事在「体育」与「央视」中各保留一份；其余咪咕跨分组重复项仍照常去重

v4.1.0 (2026-08-29)

本次为「省级台大扩容」版本：一次性新增 9 个省级广电官方直播抓取模块（模块数 2 → 11），全部零配置、免登录、默认开启——升级后无需任何操作，约 106 个官方频道自动按省分组进入播放列表；另有「全代理版」订阅与源管理页改版。

• 新增 9 个省级广电直播模块：广东荔枝网（17 个频道，含广东卫视 / 大湾区卫视 / 广东4K）、福建（官网短效接口提供 6 个省级台，海博提供 9 个地市台）、大象新闻河南（13 个，河南卫视 + 梨园 / 武术等特色频道）、看看新闻上海（13 个：东方卫视 / 五星体育等 8 个 SMG 频道 + 陆家嘴 / 外滩 / 北外滩等 5 路景观慢直播）、芒果TV（12 个，金鹰卡通 / 湖南经视等官网固定频道）、江苏网络台（10 个，含江苏卫视4K）、浙江新蓝网（9 个）、山东齐鲁网（9 个）、广西网络台（7 个）。短效地址续签、防盗链请求头、最高画质回落、购物频道剔除全部由服务端自动处理——模块卡片没有、也不需要任何配置项
• 模块默认开启，装好即出频道：新装与从未动过模块开关的部署，升级后新模块（含哔哩哔哩直播）自动启用；明确关闭过的模块保持关闭，设过 menableExtractors=false 的空白部署也不会被突然打开。不想要哪个省，去「源管理」把对应卡片关掉即可
• 流的取回方式按平台特性各就各位：广西官方流带平台自研加密，本机代理边下边解密，普通播放器直接可播；广东官网地址约 2 分钟过期，用项目既有的无头浏览器无感续签（Docker 镜像自带 Chromium 无需操心；裸机部署需装 Chrome 或用 PUPPETEER_EXECUTABLE_PATH / mchromePath 指定路径，没装只影响这一个模块）；广西 / 江苏 / 芒果TV / 看看新闻清单与分片全代理（占用服务器带宽），浙江 / 广东 / 福建省级只中转清单、分片由播放器直连官方 CDN，河南 / 山东及福建地市基本直连
• 源管理页改版：改为「自定义源 / 内置抓取模块 / 内置源」三个标签页切换，标签直接显示启用数 / 总数并记住上次停留位置；模块配置与运行详情改在居中弹窗打开（Esc / 点遮罩关闭，有未保存改动先确认），免配置模块入口显示「详情」；模块抓取失败但仍有上一轮数据时，卡片标注「沿用缓存 N 频道」，不再让人误以为一切正常
• 全代理版订阅（?relay=2）：清单与视频分片全部由服务器同源下发，专治用了兼容版（?relay=1）仍然转圈的播放器（极空间「极影视」等取不动清单内跨主机地址的设备）；后台三处订阅地址栏均新增「全代理版」一键复制。注意视频流会经服务器中转，能用兼容版就不要用它（issue #98）
• 内置「精选频道」源大扫除：133 → 121 个频道——探活脚本升级为深度探活（真实下载分片、rtmp 实测握手播放），识破一批「HTTP 200 但实为失效页」与死 rtmp 的伪活源并剔除，现存 121 个频道全部实测可播；湖南 / 东方 / 浙江卫视 4K 移至清单开头
• 依赖安全更新：升级 basic-ftp（critical）与 ws / ip-address / js-yaml 等依赖修复已知漏洞，仅更新 lockfile、功能与配置无变化（issue #105）
• 杂项：B 站直播刷新间隔收紧为 45~90 分钟，越界旧值自动回落默认 45；网页播放器支持无 .m3u8 后缀的同源动态清单（新模块所需）；本地裸跑建议 Node.js 20+（推荐 22 LTS）；Dockerfile 跳过浏览器下载的变量改用 puppeteer 实际识别的 PUPPETEER_SKIP_DOWNLOAD，行为不变（issue #106）

v4.0.1 (2026-08-23)

本次为「源模块化」大版本：咪咕从写死的内核收编为第一个「抓取模块」，新增哔哩哔哩直播模块，全部内容来源统一进顶层「源管理」。升级完全向后兼容——存量配置自动迁移、老环境变量继续生效，唯一可感知的变化是抓取频道的分组归一（见下）。

• 全新「源管理」与抓取模块架构：抓取模块、内置源、精选频道、自定义源聚合为一页卡片网格，每张模块卡片自带独立开关 + 配置 + 健康状态；原「系统配置」里的平台账号 / 画质 / H.265 / HDR / 就近取流归位到模块卡片（存量配置自动迁移，muserId / mrateType / menableH265 等环境变量继续生效），「获取账号」书签工具随之搬家，后台顶部有搬家指路条
• 哔哩哔哩直播模块（一键开启即得正在打的比赛）：在「源管理」打开开关即自动抓取所选分区（默认「赛事」）人气前 8 的直播间（带人气下限，挡掉同场比赛的多机位小号），也可手填房间号 / 直播间地址 / b23.tv 短链；SESSDATA 支持扫码登录（也有手动指引），不填「超清」、填了解锁「原画」；可选优先 HLS / 优先 H.264 与播放缓冲，环境变量 mbiliSessdata
• 频道级播放选项（#EXTVLCOPT）全链路贯通：按频道携带 Referer / UA / 缓冲参数——B 站这类需要请求头的直链源开箱能播，订阅导入的第三方源带的 #EXTVLCOPT 也不再丢失
• 抓取频道分组归一：同一频道只出现在一个分组（「先出现者胜」），分组顺序沿用上游返回。注意：分组分布与旧版略有不同，做过个性化编排的用户升级后可进「我的频道」核对一遍
• 抓取核心稳定性大扫除：token 自动续期改用墙钟时间戳（修「更新间隔不整除 720 小时时永不续期」）、不再被容器重启 / 后台保存反复触发；平台接口暂时不可达时改用上一轮缓存，已抓到的频道不再被静默清空；设了「启动时不更新」的用户重启后频道整批消失 / 体育赛事重复追加均已修复；播放请求异常返回明确错误，不再让播放器挂死转圈
• 后台修复一批：改访问密码后不再卡 403；「保存并重启」正确执行重启并探活后跳转；已删除的内置订阅源不再复活；表单新增「未保存改动」标记与保存提示；凭据（token / SESSDATA）支持一键清除；模块表单只提交改过的字段——环境变量部署的用户点保存，不会再把 env 值固化成文件值
• 咪咕 token 不再被 /api/system-config 明文回显：凭据只回「有没有值」（后台显示掩码），未设访问密码的部署不再能被同网段一个 GET 读走登录态
• 兼容版订阅再进一步：多码率 master 清单拍平为媒体清单直出，去掉播放器侧嵌套跳转，老电视盒兼容性更好（issue #98）
• 撤掉「启用抓取模块」总开关：每张卡片的开关是唯一真相，原总开关状态升级时自动折进各模块，无感迁移；内置订阅源也不再混在「自定义源」列表里

_{v4.0.1 为 v4.0.0 发布当日的重打版本：并入 B 站扫码登录与后台登录态显示的收尾修复，其余内容同 v4.0.0。}

v3.17.0 (2026-08-19)

• 配置导出 / 导入（备份 · 换机迁移）：后台「设置 → 系统配置 → 配置备份 / 迁移」一键把全部配置（系统配置、外部订阅源、我的频道与各配置档、EPG 源、频道别名 / 分组规则、用户令牌）导出为单个备份文件，换机 / 重装后导入即可恢复，多数配置即时生效（端口修改需重启）。导入前自动把当前配置快照到数据目录 config-pre-import-backup.json，导错可恢复；摸不到 Docker 数据卷目录的 NAS 用户（极空间 / 群晖等）从此不用再找卷路径。注意：导出文件包含咪咕账号与访问密码，请妥善保管；自定义台标 logos/ 需单独拷贝（issue #99）
• 兼容版订阅在极影视仍无法播放的修复：兼容版（清单直出）频道地址现带 .m3u8 后缀（/relay/.m3u8）——极空间「极影视」等播放器按 URL 后缀识别流格式，无后缀会被判定不可播放；HEAD 探测也改为按 HLS 类型应答。v3.16.0 已添加的旧格式兼容版订阅继续可用，重新复制一次兼容版地址即可获得新格式（issue #98）
• 咪咕接口不可达时干净失败：服务器连不上 play.miguvideo.com（挂代理 / 海外部署 / DNS 异常最常见）时，此前日志会刷两大段错误堆栈；现在只打一行错误摘要，播放器会收到「咪咕接口请求失败：网络超时或不可达」的明确提示并自动短周期重试，排查方向一目了然
• 内置列表：移除失效的 苏州4K

v3.16.0 (2026-08-18)

• 「兼容版订阅」清单直出：修复极空间极影视等播放器播放一直转圈：少数播放器（极空间「极影视」、部分老电视盒）不跟随 302 跳转，表现为频道列表 / 台标正常、点开播放一直转圈然后失败。现提供兼容版订阅（原订阅地址加 ?relay=1，后台「我的频道」订阅地址栏 / 配置档 / 用户令牌处均有「兼容版」一键复制）：频道地址改为清单直出——服务器替播放器完成跳转、直接返回播放清单，播放器无需跟随任何跳转；视频流仍由播放器直连 CDN，不占服务器带宽，回看同样可用。能正常播放的播放器无需换用。README 新增「播放器适配一览表」与对应 FAQ 条目（issue #98）
• 内置列表港台频道大更新：港澳台（亚太）频道大幅更新补充，体育分组调整；凤凰系频道更名为通用短名（凤凰中文 / 凤凰资讯 / 凤凰香港），配合 v3.15.0 的凤凰系 EPG 归一，长短名均可正常匹配节目单与台标