iptv

v4.62.0 更新内容

本次为「新增网络代理设置、修复央视景观与黑龙江、广东台不再依赖浏览器」版本：后台新增「网络代理」，填一个代理地址就能让 YouTube、澳门、海外频道和 Telegram 推送走代理，不用改容器环境变量或开 TUN；修复 11 月 6 日起央视景观全部播不了、黑龙江省台在部分代理网络下播不了；广东台改用官网接口取地址，不再启动浏览器；YouTube 改为按频道关注，可以限制画质、在后台直接更新解析组件。拉取新镜像、重建容器后即生效（只重启容器不会换成新版本），现有配置无需改动；黑龙江省台和海外频道的地址换成了本机入口，升级后在播放器里刷新一次订阅才会用上；黑龙江七路默认改由服务器转发，会占用服务器带宽。

• 新增「网络代理」设置：在「设置 → 系统配置 → 网络代理」填代理软件的地址（http://、https:// 或 socks5:// 开头，只写「IP:端口」按 http:// 处理），点「测试」可以看到能不能连上 YouTube、Telegram、澳门和海外频道，保存即生效，不用再改容器环境变量、网关或开 TUN。这个代理只给 YouTube 直播、澳门（澳广视）、海外频道和 Telegram 推送用，其他模块和推送渠道不走它，代理开了全局模式也不会把省台带到境外。留空时这几处沿用原来的 HTTPS_PROXY 环境变量（源码在 macOS 上运行时还会读系统代理）；HTTPS_PROXY 现在也支持 socks5:// 地址。后台回显时密码打码。

• 澳门（澳广视）和海外频道可以走代理：有生效的代理（上面这项设置，或 HTTPS_PROXY 环境变量）时，澳门六台的取址、节目单、清单和视频，以及海外频道 42 台的清单和视频，都改由服务器经代理转发，播放设备不用另设代理，但会占用服务器带宽和代理流量；海外频道经代理取不到时直接报错，不会退回播放器直连。没有代理时和以前一样由播放器直连。已经设了 HTTPS_PROXY 又打开了这两个模块的，升级后会自动改成服务器转发。海外频道的地址换成了本机入口，隐藏、改名、排序照旧生效，播放器里刷新一次订阅后才能走代理。代理只改网络路径，频道本身的地区和版权限制不变。

• 修复央视景观全部播不了：11 月 6 日起央视给「直播中国」景观频道换了新的 CDN 域名，旧版本把新地址当成非官方地址丢掉，所有景观频道都报「VDN 没有返回可播放的官方 HLS」。现在放行新域名，实测恢复 1080p 播放。

• 修复黑龙江省台在部分代理网络下播不了：七路默认改由服务器转发，播放器不再直接访问官方的 4430 端口，会占用服务器带宽。服务器的 DNS 返回 fake-IP、内网地址或解析失败时，自动改查公共 DNS 拿真实地址，证书照常校验。想沿用以前的方式，可以在源管理的黑龙江模块里把「播放方式」改成「播放器直连」。频道的隐藏、改名、分组和排序照旧生效；升级后在播放器里刷新一次订阅，才会换成新地址。卫视目前是 1080p，其余六路 720p。

• 广东台改用官网接口取地址，不再启动浏览器：广东台 17 个频道以前要在后台常驻一个 Chromium 打开官网换播放地址，每个浏览器占 200~400MB 内存。现在直接调用官网接口取地址，不再启动浏览器，也不再和央视景观、湖北台争抢浏览器名额；地址照旧在到期前自动续签，频道和节目单不变。

• YouTube 改为按频道关注：可以粘贴用户名、频道 ID、频道主页、直播、视频、Shorts、短链接或嵌入链接，手机版和旧版频道地址也认，都会识别成发布它的频道来关注，同一频道只加一次；播放时找这个频道当前在播的直播，没开播也能先关注。「查看场次」照旧列出正在直播和已预约的场次，但不再单独订阅某一场。以前单独订阅的场次继续保留，模块里会标出「直播中 / 已预约 / 已结束 / 已失效」，已结束或失效的可以一键移除。

• YouTube 可以限制最高画质：模块里的「最高画质」可选 4K、1440p、1080p、720p、480p，只在不超过上限的档里取最高的一档，省服务器带宽和代理流量；默认仍是不限。保存后重新打开频道生效。

• YouTube 解析组件可以在后台更新：模块里点「检查更新」会查 yt-dlp 有没有新版本，可以一键就地升级，YouTube 改版导致解析失败时不用等新镜像；更新中断或配套依赖不完整时会显示「修复依赖」，点一下重试，验证通过才提示成功。只升级本项目自己装的那份，用 YTDLP_BIN 指定的不动；重建容器后以镜像自带的版本为准。镜像自带的 yt-dlp 升到 2026.10.21。

• YouTube 报错更好懂、续签更稳、重开更快：连不上 YouTube 时提示去「系统配置 → 网络代理」（已经配了就提示点「测试」）；遇到人机验证或请求过多（429）时提示换代理节点。清单或分片返回 401、403、410 时自动重新解析，几个请求同时失效只重取一次，续上的仍是原来那场、原来的音轨和语言。关注的频道会记住当前在播的场次 10 分钟，重开同一个频道少等约 3 秒。

• 源管理按「已启用」筛选时不再把地区面板全部展开：筛选条件会记在浏览器里，停在「已启用」时一进源管理，三十多个地区面板全部摊开，点标题也收不起来。现在筛选后只剩 3 个以内的面板才自动展开，自动展开的也能点标题收起。

• 说明更新：README 的播放器适配表补充 Emby / Jellyfin（「电视直播」里添加 M3U 调谐器填 /interface.m3u，节目单添加 XMLTV 填 /playback.xml）；宁夏模块说明注明部分地区或网络可能播不了，播不了可以自行关闭。

_{完整更新历史见 CHANGELOG.md}

模块的默认开关不看网络：大部分模块默认开着，「海外频道」「澳门」默认关着，需要的在后台「🌐 源管理 → 内置抓取模块」最下面的「海外」小节里打开；部署在海外时，用不了的模块也在这里关掉。

能不能播，要看取流时是谁去连官方：

1. 服务端取流（换签、全代理、中继清单）：看部署服务的机器（NAS / VPS）的网络。咪咕、安徽、重庆、贵州、泉州、山东、深圳、青海省台、新疆只对大陆开放；吉林、江苏、无锡对大陆和香港开放，部署在其他海外地区时用不了。其中服务端只换签或只中继清单的，视频还要播放设备能连上。
2. 播放器直连（服务端只给地址）：看播放设备（电视、盒子、手机）的网络。「海外频道」33 台都是这种，在大陆连得上但常卡顿，播放设备挂了代理就流畅；宁夏（只对大陆开放）也是这种。黑龙江默认由服务器转发，看服务器网络（此前大陆及香港可达）；选择「播放器直连」时才看播放设备的网络。
3. 两头都要：「澳门」播放前服务端要向官网查 CDN，视频再由播放器直连，部署的机器和播放设备都要能连到大陆以外。
4. 央视和卫视在海外靠「央视频」：63 个公开频道里 58 个能播，CCTV5、5+、16 按体育版权不对海外开放。

各模块在海外的实测结果见 OVERSEAS.md。

iPanda 网页播放器的清晰度名称与实际分辨率依次是：流畅 640×360、标清 854×480、高清 1024×576、超清 1280×720。播放器把 1080p 另称为“蓝光”，但当前 22 路 HLS 均未提供该档；逐路检查最高档视频编码也都是实际 1280×720，不是清单虚标。

这些频道的匿名接口已经返回公开可播状态，页面没有启用 VIP 清晰度限制。登录不会为当前 iPanda 直播解锁 1080p；主项目检测到的最高档 720p 正好就是播放器菜单中的“超清”。两个 24 小时总频道提供上述四档，其余 20 路为单档 720p。

百视通默认关闭，需要时先在「源管理 → 百视通」手动开启，再到「播放网络」选择「IPv6 直连并转发视频」。需要 Docker 容器本身具备可用的 IPv6 出网；NAS 有 IPv6 地址不代表容器已能出网。视频由 NAS／服务器转发，因此播放器只有 IPv4 也能使用，服务器会承担视频带宽。此模式绕过应用中配置的代理，系统 VPN/TUN 仍可能接管流量。保存后点击模块「立即刷新」，再刷新播放器订阅。

选项旁提供使用提示，可用性仍取决于实际出口和上游响应，不能保证所有地区都可用。需要手动检查时，可在容器内运行 node scripts/probe-bestv-network.mjs ipv6；只具备 IPv4 的部署暂未找到通用的 403 修复。详见 百视通模块说明。

北京时间的公开活动和慢直播不需要登录，会自动出现；北京卫视、BRTV 各地面频道与卡酷少儿需要本人站点登录态。进入「🌐 源管理 → 北京广播电视台」，按卡片里的入口打开站点并登录；在浏览器开发者工具的 Network（网络）里刷新页面，点开 getUserInfo 请求，在 Request Headers 中单击 Cookie 的值后按 ⌘C（Windows/Linux 按 Ctrl+C），粘贴回后台保存即可，不需要鼠标右键。也可以用 mBtimeCookie 环境变量配置。

模块会先验证 Cookie：有效时加入 9 个电视台，失效时只隐藏电视台并给出提示，免登录直播继续可用。凭据只发给北京时间账号 / 取流接口，不会写进订阅或发送给媒体 CDN。北京时间媒体要求源站防盗链请求头，因此该模块固定由服务端代理 HLS；本地 macOS 会自动沿用系统 HTTPS 代理，Docker / Linux 可按需设置标准 HTTPS_PROXY 环境变量。

进入「🌐 源管理 → 凤凰卫视」，导入本人凤凰秀账号的 App.user.token 后保存即可。支持粘贴 Token 值或包含它的完整 Cookie；模块内提供书签工具和获取步骤，也可用 mFengshowsToken 环境变量配置。保存后的凭证随主项目配置持久保留，重启无需重填；失效时重新获取。

2026-09-03 实测：游客三台均为 854×480；普通账号登录后三台均为 1280×720、25 fps、H.264，无需付费会员。接口档位叫 fhd，实际是 720p。

本模块只提供凤凰资讯、凤凰中文、凤凰香港三路直播，不接入回看、点播、活动直播或栏目目录。三台归入香港分组；其它来源（自己添加的外部订阅）提供的同名凤凰条目不会被顶掉，原样保留作备用线路；播放器按名聚合「源1 / 源2」时本模块源排在前面，即默认源。播放地址实时向上游获取，沿用地区调度，Token 不发送到媒体 CDN 或写入订阅。直播使用 HTTP-FLV，本机仅转发不转码；网页播放器已支持，外部播放器也需支持 HTTP-FLV。

部分 LunaTV / MoonTV 版本只把 #EXTINF 紧接的下一行当播放地址，遇到中间的 #EXTVLCOPT:network-caching 缓冲提示会漏掉整个频道（issue #114）。本项目的 M3U 输出已省略仅含缓冲提示的选项块，也兼容升级前的频道缓存。运行包含此修复的版本后，在 LunaTV 管理后台刷新直播源即可，订阅地址无需更换；缓冲时长由播放器自行设置。

B 站直播已与虎牙、斗鱼一样改为播放时解析、由本机中继清单，不再依赖 #EXTVLCOPT 请求头。其它来自订阅的直连源若带 Referer / User-Agent，那是播放所需的请求头，仍会保留；若使用的 LunaTV 版本不能解析并传递这些选项，这类频道需要在客户端侧适配，不能靠删除请求头或切换 relay=1/2 修复。

这通常是 H.265（HEVC）兼容性问题：部分平台的直播流默认使用 H.265，而播放器无法解码。进入「🌐 源管理」，打开对应模块的配置并取消「启用 H.265 原画」，保存后重新播放。通过环境变量部署时可设 menableH265=false；个别频道仍有问题时再设置 menableHDR=false。

播放器可能不跟随 302 跳转。进入「我的频道」，点击订阅地址旁的「🩹 兼容版」，将新地址重新添加到播放器即可。兼容版由服务器直出播放清单，视频仍由播放器直连 CDN，不占用服务器的视频转发带宽。

「隐藏」绑的是频道 ID，而 ID 是按播放地址算的——源换了地址，那条隐藏就失效了。带签名 / 有效期参数的地址（?expire=…&sign=…）已经不再影响 ID；换了路径或域名的仍会。想让某个台以后都别出现，用「我的频道」里频道旁的「屏蔽」按钮，或右上角「🚫 屏蔽规则」按名字配一条：规则只看名字，源换址、频道每天重建都照样生效，删掉规则即恢复。像「体育-昨天 / 今天 / 明天」这类每天重建的分组，逐条隐藏没有意义，对其中一个分组点「隐藏分组」时会提议把同前缀的一起隐藏，以后新出现的也自动挡掉。