--- title: "用户指南 — M3U Editor" description: "完整指南：M3U Editor 所有工具的使用——编辑器、Xtream、TMDB、EPG、同步等。" url: https://m3utify.com/zh/guide language: zh last_modified: 2026-10-20 --- # 用户指南 掉用M3U Editor及其高级工具所需的一切。 ## 快速入门 2 分钟内快速上手 欢迎使用 **M3U Editor**！本平台让您以专业方式管理 IPTV 播放列表。以下是快速入门步骤概览。 1 ### 导入 上传您的 M3U 文件或输入播放列表 URL 2 ### 编辑 筛选、整理和自定义您的频道 3 ### 导出 以 M3U、JSON、CSV 格式下载或通过 Xtream 使用 您已登录——所有高级功能已解锁：已保存的播放列表、Xtream Codes、TMDB、EPG 和自动同步。 ### 工具概览 M3U编辑器 — 上传、筛选、链接验证及播放列表导出。 仪表盘 — 集中查看您的所有活动和统计数据。 Xtream Codes — 通过 Xtream API 为 IPTV 播放器提供您的播放列表。 TMDB — 为 VOD 添加海报、简介和 IMDB 评分。 EPG — 为直播频道添加电视节目指南。 Auto-Sync — 定时自动同步您的 M3U 来源。 ## M3U编辑器 导入、筛选、验证和导出您的播放列表 ### 1\. 导入播放列表 1 #### 打开编辑器 点击导航中的 编辑器 或前往 /editor。 2 #### 选择导入方式 两种方式可选：将 .m3u 或 .m3u8 文件拖放至放置区，或直接粘贴远程播放列表 URL。 3 #### 等待处理 文件实时解析，进度条显示处理进度。大型播放列表（10 万+频道）通过专用 Worker 处理。 已登录用户最大文件大小：200 MB。远程文件在服务器端下载，不受浏览器大小限制。 * * * ### 2\. 筛选与整理 1 #### 选择分组 在左侧面板中勾选要保留的分组（类别）。使用 全选 / 取消全选 加快操作。 2 #### 搜索频道 使用搜索栏按名称实时筛选频道，搜索不区分大小写。 3 #### 编辑频道 点击频道上的编辑图标（铅笔），可修改其名称、标志或分组。导出时保留修改。 4 #### 检查链接 点击 检查链接 测试流媒体 URL。失效频道标为红色，活跃频道标为绿色。 链接检查向每个 URL 发送轻量 HEAD 请求。1000 个频道大约需要 30–60 秒，取决于您的网络。 * * * ### 3\. 导出播放列表 M3U 标准格式，兼容所有 IPTV 播放器 JSON 用于集成至您自己的脚本或应用 CSV 用于在 Excel、Google Sheets 等中分析 XSPF XML 播放列表格式（VLC 等） Enigma2 适用于 Linux 卫星接收器（DreamBox、VU+ 等） 您还可以通过「保存」按钮将筛选后的播放列表 保存 至账户，以便从任何设备访问。 * * * ### 4\. 合并多个播放列表 1 #### 打开合并工具 在编辑器中点击 合并 选项卡，最多可同时合并 5 个 M3U 文件。 2 #### 自动去重 通过流媒体 URL 检测重复项。配置策略：保留第一个、最后一个或询问。 ## 仪表盘 您的账户控制中心 [仪表盘](https://m3utify.com/zh/dashboard) 全局统计 频道、分组、已保存播放列表和收藏夹的总数。 近期活动 最新操作历史：上传、同步、导出。 同步状态 下次计划同步、上次运行、成功率。 快速访问 直接跳转所有主要功能的按钮。 每次自动同步后检查仪表盘，确认一切顺利完成。 ## Xtream Codes 面板 通过标准 Xtream API 提供您的播放列表 Xtream Codes API 允许您在任何兼容 IPTV 播放器（TiviMate、Smarters Pro、IPTV Smarters、Perfect Player 等）中使用 M3U 播放列表，无需手动重新导入文件。 ### 配置您的凭据 1 #### 前往 Xtream 面板 在会员区访问 Xtream 面板。 2 #### 生成凭据 点击 创建我的凭据，系统自动生成唯一的用户名和密码。 3 #### 记录服务器 URL 服务器 URL 显示在面板中，这是您要在 IPTV 播放器中输入的地址。 ### 配置您的 IPTV 播放器 在播放器中输入以下信息： 服务器 : `https://m3utify.com` 用户名 : `votre_username` 密码 : `votre_password` ### 直接 M3U URL 如果播放器支持 M3U URL，使用以下格式： https://m3utify.com/get.php?username=USER&password=PASS&type=m3u\_plus&output=ts 可用参数： 参数 值 描述 `type` `m3u_plus` / `m3u` M3U 格式（含或不含 tvg 元数据） `output` `ts` / `m3u8` 流媒体 URL 扩展名 请勿分享您的 Xtream 凭据。若认为凭据已泄露，请在 Xtream 面板重新生成密码。 ### 兼容播放器 TiviMate Smarters Pro IPTV Smarters Perfect Player GSE Smart IPTV Kodi (IPTV Simple PVR) VLC (via get.php) OTT Navigator ## TMDB属性增强 为 VOD 添加海报、简介和评分 TMDB 增强自动从 The Movie Database 获取 VOD 频道（电影、剧集）的元数据：海报、简介、评分、演员表、预告片等。 需要 TMDB API 令牌，可在 themoviedb.org 免费获取（免费账户，设置 → API 部分）。 ### 配置 TMDB 1 #### 获取 TMDB API 密钥 在 themoviedb.org 创建账户，进入设置 → API → 创建 → 应用程序，复制 API Key (v3 auth)。 2 #### 在个人资料中输入密钥 在您的 个人资料 中输入 TMDB 密钥并启用增强。 3 #### 开始增强 前往 TMDB Manager，点击 增强我的 VOD。处理在后台进行（每批 20 个频道，延迟 10 秒以遵守 TMDB 配额）。 TMDB 结果在本地缓存 24 小时。您可随时重新启动增强——只有没有元数据的频道才会被重新处理。 ### 获取的数据 高分辨率海报（500px） 背景图片（backdrop） 简介 / 描述 IMDB 评分和投票数 演员表（5位主要演员） 导演 类型 上映日期 时长（电影） YouTube 预告片链接 ## 电视指南 — EPG 为直播频道添加节目指南 EPG（电子节目指南）在兼容 IPTV 播放器中显示频道的电视时间表，系统支持标准 XMLTV 格式。 ### 添加 EPG 来源 1 #### 前往 EPG Manager 访问 EPG Manager。 2 #### 添加 XMLTV 来源 点击 + 添加来源，输入名称和 EPG 文件的 URL，格式为 .xml 或 .xml.gz。 3 #### 开始同步 点击 同步。gzip 文件自动解压。大型 EPG 文件（500 MB+）通过内存优化 SAX 解析器处理。 4 #### 映射频道 使用 自动匹配（按频道名称模糊匹配）或创建手动映射，将 M3U 频道与 EPG 频道关联。 自动匹配使用 Levenshtein 距离查找匹配项，可调整相似度阈值（默认 0.7）。 ### 通过 Xtream 访问 EPG EPG 通过 XMLTV 端点自动向播放器提供： https://m3utify.com/xmltv.php?username=USER&password=PASS 如果频道尚无 EPG，使用 生成虚拟 EPG 创建 7 天内的 4 小时节目块——非常适合测试播放器。 ## 自动同步 自动保持播放列表最新 自动同步定期下载 M3U 来源并智能更新播放列表，同时保留您的自定义内容（名称、标志、自定义分组）。 ### 创建同步配置 1 #### 前往 Sync Manager 访问 Auto-Sync。 2 #### 配置来源 输入 M3U 来源播放列表 URL，并通过 cron 表达式设置频率。 3 #### 设置合并选项 选择同步更新时应保留的内容：自定义名称、标志、分组，以及是否删除已删除的频道。 4 #### 启用 webhook（可选） 输入 webhook URL，以便每次同步后收到通知（成功和/或错误）。 ### Cron 表达式 表达式 含义 `0 * * * *` 每小时 `0 */6 * * *` 每6小时 `0 0 * * *` 每天午夜 `0 0 * * 1` 每周一午夜 `0 8,20 * * *` 每天早上8点和晚上8点 发生网络错误时，系统以指数退避（2秒后4秒）重试3次，然后将同步标记为失败。 ### 智能合并 保留自定义名称 您手动编辑的名称不会被覆盖。 保留标志 即使提供商更改标志，您的自定义标志也会保留。 保留分组 您的自定义分组在更新后依然保留。 自动分配 新频道添加到可配置的分组中。 ## 我的播放列表 保存和分享您的播放列表 1 #### 保存播放列表 在编辑器中筛选频道后，点击 保存播放列表，为其命名、添加描述并选择公开或私有。 2 #### 访问您的播放列表 前往 我的播放列表 查看、下载或分享播放列表。 3 #### 分享播放列表 每个公开播放列表都有永久分享链接（/list/\[id\]），无需登录即可访问。 4 #### 下载 每个播放列表都可从播放列表面板以 M3U、JSON、CSV 或 XSPF 格式下载。 限制：每账户最多 10 个已保存播放列表。播放列表与 Auto-Sync 账户关联，以自动更新内容。 ## 收藏夹 标记并找到您喜爱的频道 1 #### 添加收藏 在编辑器中点击频道旁的 ♥ 图标，将其添加至收藏夹。操作即时生效并与账户同步。 2 #### 管理收藏夹 前往 收藏夹 查看所有收藏频道。 3 #### 导出收藏夹 将收藏夹列表导出为 M3U 或 JSON，以便在其他工具中使用。 限制：每账户最多 100 个收藏。使用收藏夹快速创建您最喜欢频道的个性化播放列表。 ## 家长控制 使用 PIN 保护特定频道分组 家长控制允许您用 4 位 PIN 锁定频道分组。锁定的分组将被隐藏，或在没有 PIN 的情况下无法访问。 1 #### 创建家长控制 PIN 前往 家长控制，点击 设置 PIN，输入 4 位数字代码两次确认。 2 #### 锁定分组 设置 PIN 后，从列表中选择要锁定的分组，点击分组旁的锁定图标。 3 #### 临时解锁 要访问锁定的分组，点击它并输入 PIN。该分组在会话期间保持可访问。 若忘记 PIN，可在此页面点击 删除 PIN 重置，届时所有分组将被解锁。 ## 安全共享 通过过期时间和密码分享播放列表 安全共享允许您为播放列表创建分享链接，支持高级选项：自动过期、查看次数限制和密码保护。 1 #### 创建分享链接 前往 安全共享，点击 + 新建链接，选择要分享的播放列表。 2 #### 配置选项 可设置：过期日期、最大查看次数、保护密码和用于标识链接的标签。 3 #### 分享 QR code 每个链接自动生成可打印或发送的 QR code，收件人可扫码直接访问播放列表。 已过期或已达查看次数限制的链接返回 403 错误，可从共享面板删除或创建新链接。 过期时间 链接在所选日期自毁 查看次数限制 N次下载后停用 密码 用密钥保护访问 ## 频道健康 实时检查频道可用性 频道健康面板通过发送 HEAD 请求测试每个流的可用性，结果按状态分类：活跃、失效、超时或未知。 1 #### 执行检查 前往 频道健康，点击 检查所有频道。测试在后台运行（同时处理 5 个频道）。 2 #### 查看结果 按状态（活跃 / 失效 / 超时）筛选，按响应时间排序，快速识别有问题的流。 测试发送超时为 8 秒的 HEAD 请求。HTTP 2xx 或 3xx 代码表示直播流。8 秒内未响应的流标记为「超时」。 🟢 活跃 HTTP 2xx/3xx，活跃流 🔴 失效 HTTP 4xx/5xx 或连接被拒 🟡 超时 8秒内无响应 ⚪ 未知 尚未测试 ## 多用户档案 一个账户，为每位家庭成员创建多个档案 档案允许您为每位家庭成员创建独立空间，包含不同的允许/屏蔽频道和可选儿童模式。 1 #### 创建档案 前往 多用户档案，点击 + 新建档案，选择表情符号、颜色和名称。 2 #### 配置儿童模式 启用 儿童模式 限制仅访问明确允许的分组。可选添加档案 PIN 以防止修改。 3 #### 设置允许/屏蔽分组 为每个档案定义可访问的分组。留空表示允许所有，或列出特定分组。 未选择任何档案时使用默认档案，默认档案无法删除。 ## VOD媒体库 以Netflix风格浏览您的电影和剧集 VOD 媒体库展示所有点播内容（电影和剧集），并附有 TMDB 元数据：海报、描述、评分和类型。 1 #### 访问媒体库 前往 VOD媒体库，自动加载您最后导入的播放列表。 2 #### 筛选与搜索 使用电影/剧集选项卡、类型标签和搜索栏快速找到标题，按评分、年份或字母顺序排序。 3 #### 播放内容 将鼠标悬停在卡片上，点击 播放 打开内置播放器，支持 HLS（.m3u8）和直接 MP4 流。 要显示海报和简介，请先通过 TMDB Manager 增强您的 VOD。 ## 高级导出 QR code、Kodi、TiviMate 等 除编辑器的标准 M3U 导出外，高级导出中心还提供针对特定应用优化的格式。 QR Code 将播放列表 URL 编码为 QR code——无需输入即可分享到电视或平板电脑。 Kodi M3U 内置 #EXTVLCOPT 选项的 M3U 格式，优化 Kodi 与 IPTV Simple PVR 插件的缓冲性能。 TiviMate 带有 x-tvg-url 标头的 M3U 格式，优化直接导入 TiviMate Companion。 标准 M3U 兼容所有 IPTV 播放器（VLC、MX Player、IPTV Smarters 等）的经典 M3U 导出。 导出时，先从下拉菜单选择播放列表，再选择所需格式。Kodi/TiviMate 导出在服务器端生成。 ## 键盘快捷键 使用键盘快速导航 ### 导航 显示快捷键帮助 ? 前往仪表盘 GD 前往编辑器 GE 我的播放列表 GP 我的收藏夹 GF ### 编辑器 全选 CtrlA 取消全选 CtrlD 搜索频道 CtrlF 保存播放列表 CtrlS 导出 CtrlE 随时按 ? 在弹窗中显示所有可用快捷键的完整列表。 ? ## 准备好了吗？ 所有工具均可用。先导入您的第一个M3U播放列表开始。 [打开编辑器](https://m3utify.com/zh/editor)[我的仪表盘](https://m3utify.com/zh/dashboard)