akiralereal/iptv

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

[!IMPORTANT]

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

🖼️ 产品预览

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

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

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

✨ 为什么选择 iPTV

| 📺 开箱即用 | 🧩 模块化源管理 | 🪄 可视化编排 | | --- | --- | --- | | 默认聚合 800+ 频道，其中央视频模块提供 63 个公开高清频道及 10 个本人账号可访问的会员频道，另有 B站、虎牙、斗鱼热门直播抓取和经筛选的公开独立源 | 央视频、咪咕、B站、虎牙、斗鱼及各广电抓取模块都有独立开关、配置和健康状态，按需启用，互不干扰 | 分组、排序、重命名、隐藏与批量管理，都在浏览器中完成 | | 🔗 自由接入 | 📡 稳定分发 | 👨‍👩‍👧‍👦 多端共享 | | 支持 M3U8 直链、网页自动提取，以及 M3U/M3U8/TXT 订阅批量导入 | 自动生成 M3U、TXT 与 EPG；提供兼容版、全代理版应对特殊播放器 | 多配置档与用户令牌，让每台电视、每位用户拥有自己的频道组合 |

[!TIP]

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

📡 频道覆盖

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

| 范围 | 当前覆盖内容 | | --- | --- | | 央视频直播 | 63 个免登录公开频道 + 10 个本人账号可访问的会员频道；公开台覆盖央视全套、CGTN 多语种和全国主要省级卫视，统一归入「央视频」分组 | | iPanda 直播 | 22 路免登录公开直播：成都与都江堰 2 个 24 小时总频道、18 个熊猫固定机位，以及江苏大丰麋鹿、云南白马雪山 2 路珍稀动物直播，统一归入「iPanda」分组 | | 央视与卫视 | CCTV 系列、CGTN、全国主要卫视频道 | | 地方频道 | 北京、重庆、四川、贵州、安徽、广东（含广州、深圳）、广西、福建、江西、甘肃、新疆、云南、吉林、黑龙江、内蒙古、宁夏、海南、河北、湖北、辽宁（含沈阳、大连）、南京、青岛、浙江、江苏、山东、河南、上海、湖南等省市卫视与地面频道，并持续接入更多地区 | | 景观直播 | 央视网「直播中国」当前在线信号，以及吉林风景、美丽河北、Live 南京、青岛城市直播、上海慢直播等景观频道；数量随平台在线状态动态变化 | | 体育赛事 | 体育频道、赛事直播，以及昨天 / 今天 / 明天的动态赛事频道 | | 亚太与国际 | 精选列表提供 50 个经实验台验证的固定直连频道；独立模块另提供 YTN、NHK World 两个需要动态解析的公开频道 | | 综合内容 | 影视、文旅、教育、少儿、娱乐时尚等分类频道 |

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

🧩 内容来源与抓取能力

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

| 来源类型 | 已支持的典型内容 | 工作方式 | | --- | --- | --- | | 央视频直播 | 63 个公开频道 + 10 个需登录/VIP 的频道 | 公开频道继续匿名动态取票、自动切换备用 CDN；会员频道复用部署者本人在央视频站点的持久登录态，由网页播放器签发并解扰成本机 H.264/AAC fMP4 HLS，解决普通播放器直接拿会员流时“有声无画”。桌面本机可从源管理自动打开登录窗口；Docker / NAS 等没有桌面的部署从自己电脑浏览器的开发者工具里复制整段 Cookie 导入（会话 cookie 是 HttpOnly，书签工具拿不到），服务端之后自动续期 | | iPanda 直播 | 成都、都江堰共 20 路熊猫直播，以及江苏大丰麋鹿、云南白马雪山 2 路珍稀动物直播 | 无需登录、无需配置；18 路固定机位使用支持网页直连的上游 CDN，2 个总频道和 2 路珍稀动物直播在播放时检查公开状态并自动切换上游 CDN，清单与媒体由本机安全代理。最高均为真实 720p，即平台所称“超清” | | 平台直播抓取 | B站、虎牙、斗鱼 | 可按分类自动收录当前热门直播间，也可手动指定房间；播放时处理短效地址、画质选择和平台要求的请求头。B站支持扫码登录以使用本人账号可访问的画质，虎牙、斗鱼支持匿名公开直播 | | 电视与赛事平台 | 咪咕、体育赛事 | 自动整理频道与节目单，并按账号权限、设备兼容性和平台接口状态选择可用画质；需要登录的能力仅使用部署者本人提供的凭据 | | 凤凰卫视 | 凤凰资讯、凤凰中文、凤凰香港，归入 香港 | 仅三个电视直播频道；游客 480p，登录普通凤凰秀账号可获取 720p / 25 帧，无需付费会员。后台支持导入 Token / Cookie 并持久保存，播放时取新签名，原始 HTTP-FLV 由本机转发。内置精选列表里的三条第三方凤凰线路同在「香港」，与本模块三台并列保留作备用线路，不合并、不顶替；播放器按名聚合时本模块源排在前面 | | 香港卫视 | 香港卫视一路电视直播，归入 香港 | 无需登录、无需配置；播放时先问源站当前在播的是哪一路，再换这一路的 HLS 入口。服务端把入口清单拍平成媒体清单后只中继清单，媒体分片由播放器直连上游 CDN。实测为 1280×720、H.264/AAC；节目单由默认 EPG 源直接覆盖 | | 大爱电视 | 大爱一台、大爱二台，归入 台湾 | 无需登录、无需配置；官网移动版直播页写死的两条官方 HLS，长期不变也不带签名，但上游按 Referer 防盗链——清单和分片裸请求一律 403，故一律由本机补齐官网请求头后全代理。实测均为 1280×720、H.264 High / AAC-LC，30 帧、约 3 Mbps | | GOOD TV | GOODTV（综合台）、GOODTV2（真理台），归入 台湾 | 无需登录、无需配置；官网播放页写死的固定 HLS，没有签名也没有 Referer 门。官网播放器备了 CloudFront、Akamai 两条线路（同一源站、分片序号一致），播放时两线竞速择优，当前线路取不到清单会在同一次轮询里当场换线。其中 CloudFront 的 WAF 按播放器标识放行（浏览器 / VLC / ExoPlayer 通过，ffmpeg、okhttp 一律 403），播放器用什么标识不由本项目决定，因此清单与分片统一走本机全代理回源。取 1920×1080 档（约 4 Mbps，H.264 Main / AAC-LC，29.97 帧），该档取不到时自动退回 1280×720 | | 北京广播电视台 | 北京卫视、BRTV 文艺 / 纪实科教 / 影视 / 财经 / 体育休闲 / i生活 / 新闻、卡酷少儿，以及北京时间当前公开活动或慢直播 | 公开直播免登录并自动排除失效项目；9 个电视频道需在后台导入本人北京时间 Cookie。凭据仅用于取流接口，不写入订阅、不发送到媒体 CDN；清单和分片由本机补齐防盗链请求头并代理 | | 重庆广电 | 源站当前公开的 CQTV新闻 | 无需登录、无需配置；频道表自动同步，播放时匿名换取短效 HLS，清单、AES 密钥和媒体分片由本机全代理 | | 四川广电 | 四川卫视、新闻、经济、文化旅游、影视文艺、妇女儿童、四川乡村、康巴卫视、四川卫视 4K 超高清 SDR，以及源站当前公开活动直播 | 活动直播有则显示、无则隐藏且无需登录；9 个固定电视台需使用部署者本人的四川源站登录态。后台提供书签工具读取源站 Token，服务端播放时动态换取短效地址，清单、密钥和媒体分片均补齐源站防盗链请求头并全代理 | | 江西广电 | 江西卫视、都市、经济生活、公共农业、少儿、新闻、移动电视、陶瓷共 8 路 | 无需登录、无需配置；源站当前公开的是单档 720p，服务端按源站公开算法获取匿名短效 token，并在播放器每次轮询时重新拉取滚动清单；清单、密钥和媒体分片均补齐防盗链请求头并全代理 | | 贵州广电 | 贵州卫视、公共、影视文艺、大众生活、生态乡村、科教健康、经济、移动电视共 8 路 | 无需登录、无需配置；播放时从源站公开 API 获取当前短效签名地址，播放器每次轮询重新拉取只有三个 3 秒分片的滚动清单，清单和媒体全代理；家有购物明确不纳入频道表 | | 甘肃广电 | 甘肃卫视、文化影视、移动电视、少儿、科教、公共应急共 6 路 | 无需登录、无需配置；播放时从源站公开接口动态获取当前入口，每次轮询重新拉取滚动清单并中继给播放器，视频分片由播放器直连上游 CDN；入口轮换或接口短时抖动会自动重试和兜底 | | 黑龙江广电 | 黑龙江卫视、都市、新闻法治、文体、少儿、影视、农业科教共 7 路 | 无需登录、无需配置；极光新闻 App 在用的官方入口，地址固定、不带签名，上游既不校验来源也不挑播放器标识，因此频道直接给直链，由播放器直连官方 CDN，本机不转发媒体。官方业务域名走 4430 端口而非 443。实测 7 路均为 1280×720、H.264 / AAC-LC，25 帧 | | 云南广电 | 云视网云南卫视、都市、康旅、澜湄国际，以及七彩云端临沧、怒江、昭通共 7 路，统一归入 云南 | 无需登录、无需配置；省级四路由官网接口按「当前这档节目」签发 DVR 窗口地址，签名按路径签、无法预取，播放时重新换取，节目换档后下一次解析自然接上（分片序号连续，实测跨档不断流）；地方三路按七彩云端目录取当前在线机位。两家回源要求不同，省级必须带官网来源头、地方不需要，清单与分片均由本机全代理。省级实测 1280×720 / 25 帧，地方分别为 720p25、1080p50 与 720×416 | | 安徽广电 | 安徽卫视、经济生活、影视、公共、农业科教、综艺体育、国际频道共 7 路 | 无需登录、无需配置；按「安徽视讯」App 的公开算法解出鉴权密钥并逐路生成两小时签名，播放器每次轮询都重新拉取滚动清单；上游 CDN 只放行 App 播放器标识，清单与分片均以 App 标识经本机全代理 | | 新疆广电 | 新疆卫视、维吾尔语新闻综合、哈萨克语新闻综合、体育健康、少儿共 5 路 | 无需登录、无需配置；播放时从丝路视听网当前 Nuxt 包静态解析当天公开签名配置，再调用源站接口签发约一小时有效的 HLS。服务端中继实时清单，媒体分片默认由播放器直连上游 CDN，也可用全代理订阅；源站标记禁播且实测返回 404 的 XJTV-4、XJTV-5 不纳入频道表 | | 吉林广电 | 6 路省级频道、9 路地方台和 13 路慢直播，共 28 路 | 无需登录、无需配置；常规电视归入「吉林」，慢直播归入「吉林风景」。省级频道和季节性景观在播放时从源站加密接口获取短效 HLS，固定地方台和固定景观使用已验证的 HTTPS 入口；清单、密钥和媒体分片均由本机全代理 | | 内蒙古广电 | 内蒙古卫视、蒙古语卫视等 8 路自治区频道，以及 12 路盟市频道，共 20 路 | 无需登录、无需配置；20 路全部归入唯一的「内蒙古」分组。播放时按奔腾融媒源站公开协议调用加密频道接口获取动态地址，并为清单、密钥和媒体分片补齐防盗链请求头后由本机全代理 | | 亚洲与国际直播 | 2 个动态公开频道：YTN、NHK World；另有 50 个固定直连频道位于精选列表的独立标记区块 | 动态频道由独立零配置模块在播放时从平台接口获取当前 HLS，并由本机代理清单、密钥与媒体；固定频道使用实验台验证过的原始 HLS 地址，不经过该解析模块，避免重复和额外转发开销 | | 广电抓取 | 北京、重庆、四川、贵州、安徽、大连、广东、广西、福建、江西、甘肃、新疆、云南、吉林、黑龙江、内蒙古、海南、河北、湖北、河南、湖南、江苏、辽宁、南京、青岛、山东、上海、深圳、浙江等 | 从各广电源站、公开接口或客户端公开直播能力获取当前地址；短效签名、防盗链、加密清单和 CDN 代理按模块分别处理 | | 景观直播 | 央视网「直播中国」、吉林风景、美丽河北、Live 南京、上海与青岛城市景观等 | 按源站当前在线状态动态收录；离线、下架或源站调整时会自动减少，不以固定频道数承诺可用性 | | 内置网页抓取源 | 如纬来体育等需要从公开页面解析当前地址的单频道源 | 内置抓取规则与定时刷新；每个源可配多个入口地址，主站打不开或抓不到时自动换备用地址重试，清单本身通过远程配置更新（改仓库文件即生效，无需升级镜像）。每个源均可单独关闭 | | 精选公开独立源 | 体育、国际、亚太、影视、纪实、音乐、娱乐时尚等 | 项目维护的「精选频道」列表，收集公开可访问且经可用性检查的独立播放地址，并提供远程更新与本地快照兜底；可访问性检查不等同于版权授权审查 | | 用户自有来源 | M3U8 直链、网页提取、M3U/M3U8/TXT 订阅 | 完全由部署者自行添加、排序、分组和控制在哪些配置档中显示，适合接入自有设备、合法订阅或已获授权的直播源 |

[!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. 打开管理后台

部署完即可访问：

| 用途 | 地址 | | --- | --- | | M3U 播放列表 | http://your-ip:1905/interface.m3u（推荐带 .m3u 后缀；裸 /m3u 内容相同） | | TXT 播放列表 | http://your-ip:1905/txt | | EPG 节目单 | http://your-ip:1905/playback.xml | | 管理后台 | http://your-ip:1905/admin（设了密码则 http://your-ip:1905/密码/admin） |

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

---

🧭 功能全景

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

| 页面 | 能做什么 | | --- | --- | | 📺 我的频道 | 分组、隐藏、排序、重命名与批量管理；按名字长期屏蔽频道、一次隐藏整批同前缀分组；查缺台标；建立多套配置档；复制标准版、兼容版或全代理版订阅地址 | | 🌐 源管理 | 管理抓取模块、内置源与精选频道；添加网页提取、手动直链或订阅源；检测失效频道并调整多源优先级 | | ⚙️ 设置 | 调整系统参数、频道别名、自动分组规则、EPG 聚合和用户令牌；导出或导入完整配置 | | ℹ️ 关于我们 | 查看当前版本并检查更新 |

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

数据流一览

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

---

📺 播放器适配

| 播放器 | 推荐订阅 | | --- | --- | | DIYP / 百川影音 | TXT 订阅：/txt | | TiviMate / APTV / Kodi / OK 影视 | 标准 M3U：/interface.m3u | | 飞牛影视 | 标准 M3U：/interface.m3u，必须保留 .m3u 后缀 | | 极空间极影视、部分老电视盒 | 兼容版：/interface.m3u?relay=1 | | 使用兼容版仍无法播放的设备 | 全代理版：/interface.m3u?relay=2，兼容的频道会由服务器转发视频分片 |

[!NOTE]

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

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

---

❓ 常见问题

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

---

🔧 配置与进阶

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

环境变量参考

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

| 变量名 | 默认值 | 说明 | | --- | --- | --- | | mport | 1905 | 容器监听端口 | | mhost | | 公网 / NAS 访问地址，如 http://192.168.1.100:1905 | | mpass | | 访问密码（可选），设置后访问 http://ip:port/密码/... | | mdataDir | /iptv/data | 数据持久化目录（镜像已默认此值并声明数据卷）；建议 -v ./data:/iptv/data 绑定宿主机便于备份。老部署挂的 /migu/data 继续兼容，无需改动 |

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

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

🧹 空白部署 / 纯频道管理

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

| 需求 | 配置 | | --- | --- | | 彻底空白，自己加源 | mblank=true | | 空白但保留抓取核心 | mblank=true + menableMigu=true | | 只去掉自带的额外源 / 订阅 | menableBuiltInSources=false + menableBuiltInSubscriptions=false |

也可在后台「🌐 源管理」直接开关各卡片，保存即时生效。关闭 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 并入「台湾」；五家全部免登录、零配置、默认开启，可在源管理逐家关闭。取流方式正好各不相同——黑龙江地址固定且既不校验来源头也不挑播放器标识，频道直接写直链、本机一个字节的媒体都不转发；云南省级要按「当前这档节目」逐次换取带