akiralereal / iptv
← 返回首页
开箱即有 800+ 可稳定流畅播放频道的自托管 IPTV 直播源管理与分发系统，聚合了央视频、咪咕、央视、卫视、凤凰卫视、亚太、国际、地方台、体育赛事、抖音直播、B 站直播、斗鱼直播、虎牙直播等，以及自定义抓取源和订阅，并提供 EPG 节目单与聚合功能；另外还自带 GUI 可视化管理后台，支持 Docker Compose 或 Node.js 运行，适合 NAS 与家庭服务器。
📄 仓库 README
在 GitHub 查看 ↗来自 GitHub 仓库自述文件 · 版权归原作者所有
# 📺 iPTV
### 把分散的直播源，变成一套真正属于你的频道系统
自托管 · 模块化 · 可视化 · NAS 友好
[](https://github.com/akiralereal/iptv/stargazers)
[](https://hub.docker.com/r/akiralereal/iptv)
[](LICENSE)
[](https://github.com/sponsors/akiralereal)
[](https://t.me/iFansClub)
[](https://t.me/iFansClubChat)
### [🐳 Docker 部署教程](#-快速开始) · [前往 Docker Hub →](https://hub.docker.com/r/akiralereal/iptv)
推荐通过 Docker 在 NAS / 服务器上部署，镜像：`akiralereal/iptv:latest`
**当前版本：v4.52.0** · [产品预览](#-产品预览) · [频道覆盖](#-频道覆盖) · [内容来源](#-内容来源与抓取能力) · [功能说明](#-功能全景) · [更新日志](https://github.com/akiralereal/iptv/blob/HEAD/CHANGELOG.md)
iPTV 是一个面向家庭影音与 NAS 用户的模块化 IPTV 直播源管理与分发系统。它内置央视频、咪咕、B站、抖音、虎牙、斗鱼及多地区广电等抓取模块，也能接入需要网页解析的内置源、维护者筛选的公开独立源、自定义直连地址和 M3U/TXT 订阅；所有来源统一完成聚合、去重、编排，再输出干净的播放列表与 EPG 节目单。
项目更新和社区公告请订阅 Telegram 公告频道（@iFansClub）；使用问题、反馈和心得交流，欢迎加入 Telegram 用户交流群（@iFansClubChat）。Bug 反馈和功能建议也可以提交 GitHub Issue。
[!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、全国主要卫视频道 |
| 地方频道 | 北京、天津、重庆、四川（含成都及区县、绵阳、泸州、遂宁、内江、达州、巴中、甘孜、阿坝、广元、宜宾、凉山、雅安、乐山、眉山、资阳）、贵州、安徽、广东（含广州、深圳、梅州）、广西、福建（含泉州、晋江、石狮、德化、莆田、宁德）、江西、甘肃、青海（含西宁、格尔木、海东）、新疆、西藏、云南、吉林、黑龙江、内蒙古、宁夏、海南、河北、山西、陕西、湖北、辽宁（大连）、浙江（含杭州、宁波、嘉兴、台州天台、绍兴、东阳、衢江、江山）、江苏（含南京、苏州、无锡、扬州、南通、盐城）、山东（含青岛；16 个地市的区县台按地市分组，默认关闭）、河南、上海、湖南等省市卫视与地面频道，以及广电云平台上 20 个省区市的市县台（只显示正在推流的），并持续接入更多地区 |
| 景观直播 | 央视网「直播中国」当前在线信号，以及吉林风景、美丽河北、Live 南京、青岛城市直播、上海慢直播等景观频道，以及市县台模块里许昌、桐庐、乌镇、宣恩等地的 97 路慢直播；数量随平台在线状态动态变化 |
| 体育赛事 | 体育频道、赛事直播，以及昨天 / 今天 / 明天的动态赛事频道；广东体育官方公开赛事按“广东体育 · 赛事名称”显示在「广东」分组并同时出现在「体育」分组，数量随开播与结束变化 |
| 亚太与国际 | 精选列表提供 15 个经实验台验证的固定直连频道；独立模块另提供 YTN、NHK World 两个需要动态解析的公开频道，以及香港卫视、澳门莲花卫视两路官网直播；另有「海外频道」模块的 33 个海外免费频道、「澳门」模块的澳广视自办 6 套电视，默认关闭，需要时在后台打开 |
| 高校与场馆 | 25 个机构与平台官网公开的活动直播与录像：大学讲座与校园活动、博物馆讲堂、文化馆演出与村晚、音乐会与剧院导赏、论坛演讲、白玉兰与金爵颁奖典礼、拍卖预展、智慧高教课堂、1905／微博／芒果活动；节目名带 [直播] 或 [回放]，按机构分组，默认关闭，需要时在后台按机构打开，详见下文 高校与场馆 |
| 综合内容 | 影视、文旅、教育、少儿、娱乐时尚等分类频道 |
播放列表首位默认提供项目自有的「公告」分组，内含三条自制短片：“欢迎使用 iPTV for iFansClub.com”展示使用方式、版权提醒和侵权联系说明；“央视频会员频道登录教程”演示 Docker / NAS 用户如何从浏览器复制 Cookie 把央视频登录态导入 iPTV；“「来源于网络」频道添加教程”演示如何在后台「🌐 源管理 → 👤 自定义源」用「🌏 添加「来源于网络」列表」卡片一键订阅仓库 from-the-web/from-the-web.m3u 里的网络第三方源。三者都不引用任何第三方节目素材。不想在电视上显示可以在后台「我的频道」逐条隐藏（随时可在「已隐藏」里恢复）；只要显示，该分组就固定在第一位，不支持删除、移动、排序或重命名。
🎓 高校与场馆
想在电视上看大学讲座、博物馆讲堂、文化馆演出或颁奖典礼，可以打开「高校与场馆」：iPTV 从 25 个机构与平台的官网收录它们公开的活动直播和录像。这类内容不是电视频道，默认关闭，需要的到后台「🌐 源管理 → 内置抓取模块 → 高校与场馆」按机构打开，播放器重新拉一次订阅，就会多出以机构命名的分组。
新增「国家智慧教育·高教课堂」「1905电影活动」「微博官方活动」「芒果活动」四个独立开关。首批验证 19 条回放：高教三门课程六讲、1905 六场、微博四场、芒果三场，包含《绽放》《金吾不禁》片场探班及长时颁奖活动。播放前重新检查官方公开权限；智慧高教只收录已验收六讲，中小学登录课程暂未接入。
| 类别 | 机构 | 内容 |
|---|---|---|
| 高校 | 西安交通大学、吉林大学、复旦大学、北京师范大学、华中科技大学 | 公开讲座、校园活动、会议典礼与晚会录像，校园影像与毕业短片 |
| 博物馆与图书馆 | 国家博物馆、上海图书馆、中国数字科技馆 | 国博讲堂、公开讲座与美育课、科普活动 |
| 文化馆 | 国家公共文化云，上海市群众艺术馆，浙江、广东、湖南省文化馆 | 群众文艺演出、村晚、音乐会与比赛，部分有直播 |
| 音乐与剧院 | 中央音乐学院、广州大剧院、易北爱乐音乐厅（德国汉堡） | 国乐演奏会、云剧院歌谣夜与艺术导赏、NDR／ARD 长篇音乐会 |
| 论坛 | 中关村论坛、上海论坛 | 会场录像、嘉宾演讲 |
| 颁奖典礼 | 上海电视节白玉兰奖、上海国际电影节金爵奖 | 历届颁奖典礼全程回顾 |
| 拍卖 | 富艺斯 | 预展和拍后回顾短片，没有整场拍卖 |
| 高教课堂 | 国家智慧教育·高教课堂 | 教创赛第五届三个学科六讲课堂实录 |
| 影视与明星活动 | 1905电影活动、微博官方活动、芒果活动 | 首批十三场完整回放，含两场片场探班、颁奖活动、歌唱节目见面会和剧组互动 |
- 节目名前标
[直播]或[回放]：官方正在直播的活动才标[直播]，开播前的预告不出现；[回放]是官方录像，可以拖动进度，不是电视频道那种按时间回看。 - 每家只取官方目录里当前的几条（多数 3 条），每小时随官网更新，不是机构的全部视频。
- 只收官网公开、免登录的内容；要登录、付费、试看、DRM 加密和宗教内容不收。活动和录像没有台标和节目单。
- 画面经部署的机器转发，会占用服务器带宽，能不能看取决于部署机器访问这些官网的网络；富艺斯、易北爱乐还要能访问境外网站。
- 湖南省文化馆部分回放和上海论坛的演讲录像是 HEVC 编码，播放器要支持 HEVC。
各家的官方入口和收录范围见 机构模块说明。佳士得模块因部署端回放可用性不足已移除，升级后自动清理其旧模块配置与抓取缓存。
🧩 内容来源与抓取能力
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站支持扫码登录以使用本人账号可访问的画质，抖音、虎牙、斗鱼支持匿名公开直播。抖音默认从「聊天」「生活」两个分类轮选 20 个、FLV 播放，分类和数量可在源管理里改，也可切换为公开网页「全部」页原始顺序（首批约 15 个）或 HLS；频道归入「抖音」，排在「B站」之后 |
| 电视与赛事平台 | 咪咕、体育赛事 | 自动整理频道与节目单，并按账号权限、设备兼容性和平台接口状态选择可用画质；需要登录的能力仅使用部署者本人提供的凭据 |
| 广东体育官方赛事 | 官方「广东体育频道plus」「广东体育频道」当前公开在播的赛事，归入 广东，同时出现在 体育（赛事名带少儿、卡通、动漫的改放「少儿」，带教育、科教的改放「教育」） | 无需登录、无需配置；从广东体育官方 H5 动态发现赛事，播放时复核官方状态并读取 HLS；本机只中继清单，视频分片由播放器直连官方 CDN（不看来源头、不带签名），也可用 ?relay=2 全代理。每场赛事独立标识，开播加入、结束移除；源管理有独立开关。广东体育电视频道仍由荔枝网模块提供 |
| 凤凰卫视 | 凤凰资讯、凤凰中文、凤凰香港，归入 香港 | 仅三个电视直播频道；游客 480p，登录普通凤凰秀账号可获取 720p / 25 帧，无需付费会员。后台支持导入 Token / Cookie 并持久保存，播放时取新签名，原始 HTTP-FLV 由本机转发。原先在内置精选列表里的三条第三方凤凰线路已移到「来源于网络」列表，订阅后与本模块三台并列作备用线路，不合并、不顶替；播放器按名聚合时本模块源排在前面 |
| 香港卫视 | 香港卫视一路电视直播，归入 香港 | 无需登录、无需配置；播放时先问源站当前在播的是哪一路，再换这一路的 HLS 入口。服务端把入口清单拍平成媒体清单后只中继清单，媒体分片由播放器直连上游 CDN。实测为 1280×720、H.264/AAC；节目单取自官网节目单接口（今明两天） |
| 澳门（澳广视） | 澳广视自办的 6 套电视：澳视澳门、澳视葡文、澳门体育、澳门资讯、澳门综艺、澳门-Macau，归入 澳门 | 无需登录、无需配置；播放时向官网的路由接口取当前网络可用的 CDN（缓存五分钟），播放器直连官方 CDN；官网与视频只对大陆以外开放，部署服务的机器（查 CDN）和播放设备（取视频）都要能连到大陆以外；默认关闭，需要时在后台打开；台标与节目单取自官网 |
| 澳门莲花卫视 | 澳门莲花卫视一路电视直播，归入 澳门 | 无需登录、无需配置；播放时从官网直播页的播放器配置读出当前带签名的 HLS 入口，入口在本机缓存五分钟、签名失效立即重读官网，每次播放都检查实时清单。服务端只中继清单，带独立签名的媒体分片由播放器直连上游 CDN，需要时也可用 ?relay=2 全代理；台标与节目单取自官网 |
| 北京广播电视台 | 北京卫视、BRTV 文艺 / 纪实科教 / 影视 / 财经 / 体育休闲 / i生活 / 新闻、卡酷少儿，以及北京时间当前公开活动或慢直播 | 公开直播免登录并自动排除失效项目；9 个电视频道需在后台导入本人北京时间 Cookie。凭据仅用于取流接口，不写入订阅、不发送到媒体 CDN；清单和分片由本机补齐防盗链请求头并代理 |
| 重庆广电 | 源站当前公开的 CQTV新闻 | 无需登录、无需配置；频道表自动同步，播放时匿名换取短效 HLS，清单、AES 密钥和媒体分片由本机全代理 |
| 四川广电 | 四川卫视、新闻、经济、文化旅游、影视文艺、妇女儿童、四川乡村、康巴卫视、四川卫视 4K 超高清 SDR，以及源站当前公开活动直播 | 活动直播有则显示、无则隐藏且无需登录；9 个固定电视台需使用部署者本人的四川源站登录态。后台提供书签工具读取源站 Token，服务端播放时动态换取短效地址，清单、密钥和媒体分片均补齐源站防盗链请求头并全代理 |
| 成都广电 | 成都新闻综合、经济资讯、都市生活、影视文艺、公共、少儿、蓉城先锋及 20 路区县电视，共 27 路，归入 四川 | 无需登录、无需配置；播放时从看度官方 App 接口获取签名地址，主频道优先高清，默认 302 跳转、播放器直连，不转码、不常驻浏览器。龙泉旧源不可用，暂不收录。新闻综合、公共带今明两天的央视网官方节目单，其余暂无；24 路使用官网新版图床的频道台标，3 路由内置台标包补齐（含资料库出处），不提供回看 |
| 四川市州 | 成都以外 18 个市州、25 路官方电视频道，归入 四川 | 无需登录、无需配置；播放时解析各台官网及官方 App 公开入口，动态续签并复用合法 CDN 会话。遂宁、达州、凉山、资阳七路全代理，其余十八路中继清单、分片直连；台标均有内置备份，凉山两套及攀枝花新闻综合带今明官方节目单，其余暂无 EPG，均不提供回看。详见 四川市州模块 |
| 江西广电 | 江西卫视、都市、经济生活、公共农业、少儿、新闻、移动电视、陶瓷共 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 |
| 山西广电 | 山西卫视、黄河电视台、经济与科技、影视、社会与法治、文体生活 6 路省级频道，以及太原、朔州、忻州、阳泉、吕梁、晋中、长治、晋城、临汾、运城 10 路地市频道，共 16 路，统一归入 山西 | 无需登录、无需配置；省级频道的播放路径按官网播放器算法由「频道码 + 当天日期」算出，只认当天、零点即换，播放时按上海时区重算；地市频道播放前向官网签名接口换取短效地址。两家 CDN 都不校验来源与播放器标识，本机只中继清单，媒体分片由播放器直连官方 CDN，也可用全代理订阅。实测 16 路均为 1280×720、H.264 / AAC-LC，25 帧；节目单取自官网逐台节目单接口（今明两天），省级 6 路与太原、晋中、临汾有，另外 7 个地市台官方为空 |
| 陕西广电 | 陕西卫视、新闻资讯、都市青春、银龄、秦腔、体育休闲、农林卫视、移动电视共 8 路，统一归入 陕西 | 无需登录、无需配置；播放时现解官网看电视页下发的加密频道目录取当前地址——地址不带签名，但官网会整批换名、旧名立即失效，所以不写进播放列表；CDN 不校验来源与播放器标识，本机只中继清单，媒体分片由播放器直连官方 CDN（仅 HTTP），也可用全代理订阅。实测 8 路均为 720×404、H.264 / AAC-LC，25 帧（官网只有这一档）；8 路都有官网当天节目单 |
| 西藏广电 | 西藏卫视、藏语卫视、影视文化共 3 路，统一归入 西藏 | 无需登录、无需配置；播放时从「珠峰云」App 的频道接口取当前带签名的 HLS 地址（签名只验清单，签发一小时后仍有效），频道表五分钟复用一次，清单被拒时立即重取。CDN 不校验来源与播放器标识、分片不带签名，本机只中继清单，媒体分片由播放器直连官方 CDN，也可用全代理订阅。实测 3 路均为 1920×1080、H.264 / AAC-LC，25 帧；官方没有节目单，西藏卫视与央视频同名，开着央视频时共用其节目单 |
| 天津广电 | 天津卫视、天津新闻、天津文艺、天津影视、天津都市、天津体育、天津教育 7 路，统一归入 天津 | 无需登录、无需配置；按津云 App 的 WiseTV 协议在播放时签发短效地址（App 内置应用参数，可用环境变量覆盖），签发接口每次在腾讯、网宿、百度三家 CDN 间轮换。网宿的播放会话绑定取清单那一方的播放器标识，播放器直连分片会被拒，所以清单与分片都经本机全代理；播放中直接轮 |
📈 近 7 天 Star 趋势
每日新增 Star（柱）与累计 Star（线）· 数据来自 GitHub
🏆 排名变化趋势
在各榜单中的排名历史（数字越小越靠前）
📋 历史上榜记录
每次快照的详细数据
| 日期 | 榜单 | 排名 | 周期新增 | 总 STAR |
|---|