已集成懒猫OIDC登录。 ## 功能特性 - 多来源 IPTV 聚合：可添加内置直播源、上传 M3U/M3U8、填写远程 M3U URL、接入 HDHomeRun 和 Local Now。 - EPG / XMLTV 管理：支持 Gracenote、EPG-PW、Jesmann、远程 XMLTV URL 和本地 XML/XML.GZ 文件导入。 - 频道映射与保留编辑：频道、分组、台标、EPG 关联和用户编辑保存在 MongoDB，重新同步后不会只依赖浏览器本地状态。 - 用户和访问控制：支持管理员、普通用户、每用户播放列表访问范围和独立 stream token。 - 外部播放器交付：可生成 per-user `.m3u` 与 XMLTV 地址，供 TiviMate、VLC、Jellyfin、Plex、Emby 等客户端使用。 - 代理与转码：通过 HLS proxy、ffmpeg/VLC 和可选硬件加速为外部客户端提供播放链路。 - 实时观测：Dashboard、Active Streams、History / Metrics、日志流和系统状态均来自后端状态或 WebSocket。 - 备份与恢复：支持完整系统 gzip 备份、上传恢复和计划备份，备份目录持久化在 `/lzcapp/var/backups`。 ### 首次使用流程 1. 打开应用，使用懒猫账号登录后，先打开 `Settings`，确认 `Domain` 已经是当前懒猫访问地址，即“https://masqueradarr.你的微服名.heiyu.space”；这个地址会被写进用户导出的 `.m3u` 和 `EPG / GUIDE` 链接里。 2. 打开 `Playlists`，点击 `Add playlist`，按实际来源选择 `Built-In`、`Upload m3u`、`Remote URL`、`HDHomeRun` 或 `Local Now`。如果是常见家庭直播源，通常从 `Upload m3u` 开始最直接。测试源网址：https://iptvindex.com/。 3. 再打开 `EPG Sources`，添加一个节目单来源。上传本地 XML/XML.GZ 时，真正执行导入的按钮是 `Add & import`；导入完成后，列表会显示 `channels / programs / last sync`。测试源网址：https://iptvindex.com/。 4. 进入 `Channel Mapping`，先把顶部 `EPG Source` 从默认的 `None` 切到刚导入的来源，再点击 `Auto-match`。只有这一步完成后，外部播放器拿到的 `EPG / GUIDE` 才会带出实际节目数据。 5. 最后打开 `Users` 创建普通用户，再回到 `Playlists` 里通过 `Assign access` 授权。授权完成后，从用户编辑弹窗的 `Published URLs` 复制该用户的 `.m3u` 和 `EPG / Guide` 地址，交给 TiviMate、VLC、Jellyfin、Plex 等客户端（局域网内）使用。 ### 播放列表设为全局后，普通用户如何使用 1. 管理员打开 `Playlists`，进入要共享的播放列表详情，点击右上角 `Edit`。 2. 在 `Playlist status` 抽屉找到 `Endpoint`，选择 `global`，确认下面显示的是 `Settings` 中配置的域名，然后点击 `Done` 保存。不要把 `Compose Global` 当成权限设置；它只负责重新生成全局 M3U。 3. 返回列表或详情页，确认该播放列表的状态标签显示 `global`。如果仍显示 `custom`，说明只是同步或生成了播放列表，还没有切换共享范围。 4. 打开 `Playlists → Assign access` 检查普通用户。Global 单元格显示锁定或不可点击是正常的，表示所有已登录用户自动拥有 Global；这里不需要、也不能单独勾选 Global。 5. 普通用户重新登录后，在自己的 `Dashboard` 可以看到 Global 频道，并可在个人的 `Published URLs` 中复制 Global `.m3u` 和 `EPG / GUIDE` 地址。将这些地址添加到 TiviMate、VLC、Jellyfin、Plex 或 Emby 即可使用。 6. 如果只希望某个用户使用某个播放列表，不要使用 `global`。把它改为 `custom`，再在 `Playlists → Assign access` 中勾选该用户对应的 Custom 播放列表。 ### 操作示例 1. 在 `Playlists → Add playlist → Remote URL` 填入： - 名称：`中国频道` - URL：`https://iptv-org.github.io/iptv/countries/cn.m3u` 2. 保存后进入该播放列表详情，点击 `Sync`，确认已经出现 `channels / groups / synced` 数值。 3. 在 `EPG Sources → Add EPG Source → Custom → Remote URL` 填入： - 名称：`中国频道` - URL：`https://epg.pw/xmltv/epg_CN.xml` 4. 导入成功后，确认已经出现 `channels / programs / synced` 数值。 5. 打开 `Channel Mapping`，把顶部 `Playlist` 切到 `中国频道`，把顶部 `EPG Source` 也切到 `中国频道`。 6. 先看右侧 `EPG Channels` 是否已经大于 0；如果还是 0，优先检查是不是还停在默认的 `None`。 7. 点击 `Auto-match` 自动匹配；剩余 `unmatched` 再手工逐个绑定。 8. 完成后再回到 `EPG Sources → 中国频道`，原先空白的 `Playlists linked to this EPG` 和 `Playlist channels linked to this EPG` 就会开始出现数据。 ### M3U 和 EPG 如何配合 1. `M3U` 是频道和播放地址。它决定播放器里“有哪些台”和“点开后播什么流”。 2. `EPG / XMLTV` 是节目单。它决定播放器里“现在正在播什么”和“接下来播什么”。 3. `Channel Mapping` 是中间桥。只有把 `M3U Channels` 和 `EPG Channels` 对上，用户的 `EPG / GUIDE` 地址里才会出现真正的节目数据。