iiPTV
打开播放器
全部指南

指南

读懂 M3U 播放列表

了解 M3U 文件与链接的区别、实际格式示例和导入步骤，区分播放列表与视频内容本身。

最近更新

内容撰写： iiPTV editorial

M3U 播放列表是包含媒体位置的文本文件，可以附带频道名称、分组和标识，但通常不包含视频本身。远程 M3U URL 指向文本，里面的条目又指向独立媒体。本篇介绍如何阅读结构、导入列表，并区分文件问题与直播流不能播放的问题。

带有频道名称的概念播放列表，分别连接独立媒体来源
M3U 列表概念示意图，并非实际应用截图。

M3U 列表包含什么

M3U 为播放器提供有序的媒体位置。根据制作者的目标工作流，这些位置可能是完整 URL、相对路径或本地路径。浏览器工具不能把每一种地址都当成远程可播放流。文件格式与播放器的访问能力是两个问题。

保存清单不等于下载视频

保存 M3U 只会保存文本，不会自动下载引用的节目。文件可能只有几千字节，而所选视频持续传输数据。保存副本时应同时保留原来源地址，之后可能需要它解析路径或获取更新。

阅读一个 M3U 格式示例

下例仅说明结构。example.com 地址不是实际可播放频道。

#EXTM3U
#EXTINF:-1 tvg-id="education-example" group-title="Learning",Education example
https://example.com/live/education.m3u8
#EXTINF:-1 group-title="Archive",Archive example
https://example.com/video/archive.mp4

文件头、条目与地址

#EXTM3U 引入扩展列表。#EXTINF 描述紧接着的媒体条目，下一行记录位置。逗号后的名称用于显示。示例中的两条记录引用不同媒体类型，说明同一清单里的频道可以有不同播放要求。

不同制作者的约定可能不同

tvg-id 和 group-title 等 IPTV 属性帮助组织信息，但不保证每个播放器行为相同。社区项目会说明自己的约定，例如 iptv-org 贡献指南。缺少可选属性，与缺少媒体地址不同。不要仅因元数据较少，就判断一个本可读取的条目无效。

文件、URL 与相对路径

本地文件导入

浏览器读取设备上选中的文本，不上传到永久清单库。这省去了最初的远程下载，但播放频道仍需要访问媒体主机。制作者更新原列表时，本地副本也不会自动同步。

远程链接导入

直接 URL 可获取当前文本。仓库预览、下载介绍页和登录页面都不是清单响应，来源也需要允许浏览器请求。MDN 的 CORS 指南 说明了为什么能在标签页打开的链接，不一定能被另一网站读取。

相对地址需要基准

远程清单中的 live/channel.m3u8 可以相对于清单 URL 解析。本地文本没有同样的远程基准。导入本地副本前，应将相对条目改成允许使用的完整 HTTPS 地址。本地磁盘路径不能代替网页可访问媒体。

导入并检查列表

  1. 修改前保留原清单。
  2. 打开 M3U 播放器，选择相应输入方式。
  3. 导入文件或直接 URL，检查可见名称和分组。
  4. 搜索一个熟悉条目，不要立即尝试所有频道。
  5. 选择条目并点击播放，分别记录导入和播放结果。

列表可读只证明条目被解析。有正确频道却不能播放时，应转向媒体层。重复导入相同文本，不会改变来源编码、访问要求或可用状态。

名称、分组与元数据

标签方便查找

#EXTINF 后的名称让你不用展示完整媒体地址，也能识别条目。分组可以把清单划成有意义的子集。不同来源命名方式不同，缺少分组不代表流失效。搜索和分组操作针对已经导入的条目，不会查询提供方的完整目录。

稳定标识有助于区分同名条目。编辑个人副本时，可以修改显示名称，但不要误合并不同媒体地址。每个条目保留一个媒体位置，分组命名保持一致，才便于筛选。这些整理工作改善可用性，不等于核验直播源。

元数据不能授权播放

频道标识不会自动登录订阅，图标不能证明权利归属，精美标签也不能核验当前可用性。本站不会自动获取清单中的第三方图标。制作要分享的列表时，不要把私有 query token 或账号细节放进频道名称。

排查一份异常清单

假设允许使用的清单有两个条目：第一条是完整 HTTPS 地址，第二条是 clips/example.mp4。从原网页导入时，两者都可解析；下载文本再作为本地副本导入后，相对条目被拒绝。这是假设案例，线索指向丢失的基准地址，不是 MP4 编码突然不兼容。

另一个情况是把 HTML 页面保存为 channels.m3u。改名并没有创建有效播放列表。请用文本方式查看，对照格式示例，再返回来源公布的下载地址。获取和解析问题见列表加载帮助。

有真实媒体地址却不能播放时，查看播放帮助。M3U 与 M3U8 对照 还解释了单个 HLS 清单为何不同于多频道目录。

维护与分享列表

记录来源、获取日期和允许用途。优先从原发布者更新地址，而不是复制来历不明的替代清单。近期文件日期是背景信息，不证明每个条目都有效。

保护个人清单凭据。解析后的条目（含媒体地址）会在刷新后保留于此浏览器缓存，使用 Clear 或清除网站存储可删除。请自行保留原文件。反馈问题时说明失败阶段，提供最小脱敏示例，而不是分享完整私有集合。