很多兄弟想要打开直接看的 iptv 播放器

飞牛IPTV v1.2.0 — 功能介绍与使用教程

一、产品概述

飞牛IPTV 是一款运行在飞牛OS（FNOS）上的第三方 IPTV 直播播放器应用，集成了央视频官方直播源，支持自定义频道、M3U 播放列表导入、台标显示和 EPG 节目单等功能。应用采用 CGI 模式运行，无需占用额外端口，开箱即用。

二、核心功能

1. 央视频直播源（内置 77 个频道）

应用基于央视频官方 API 解析直播流，提供稳定高清的电视直播信号：

• 央视频道（26 个）：**-1 至 **-17 全系列、CGTN 多语种、**-4K/8K 超高清
• 卫视频道（35 个）：北京、东方、湖南、浙江、江苏、广东等全国省级卫视
• 港澳频道（12 个）：凤凰卫视系列、**卫视、澳门卫视、TVBS、**四大台等
• 央视付费（4 个）：风云剧场、风云音乐、风云足球、高尔夫网球

所有频道默认 1080P 全高清（FHD） 画质，无需会员即可观看。

2. HLS 流媒体播放器

• 基于 hls.js 实现 HLS 流媒体解码播放
• 优先使用 hls.js 引擎（桌面端/安卓），iOS 自动回退原生 HLS
• 内置 直播流自动刷新机制，解决播放十几秒后卡住的问题
• 网络错误自动重试，短时间中断无需手动操作
• CDN 双源加载：jsDelivr 主源 + Gcore 备用镜像，确保 hls.js 库加载成功

3. EPG 电子节目单

• 内置默认 EPG 源（epg.136605.xyz/3days.xml），支持自定义替换
• 右侧节目单面板实时显示当前及未来节目
• 频道列表中展示"正在播出"的节目名称
• 精确频道名称匹配，避免 **-11/12/13 误匹配为 **-1 的问题
• 支持手动刷新 EPG 数据

4. 自定义频道管理

• 手动添加：填写频道名称、M3U8 地址、台标 URL、分组名称
• M3U 导入：支持从 URL 或本地文件（.m3u/.m3u8/.txt）批量导入
• 分组管理：自定义频道可按分组归类，与内置频道统一展示
• 删除管理：设置页面对自定义频道进行增删操作

5. 台标系统

• 台标图片通过 jsDelivr CDN 镜像 加速加载
• 加载失败自动回退到 CGI 代理 + 本地缓存 机制
• 二次失败显示频道名称首字母占位符，保证界面完整
• 台标尺寸 40×40px，清晰醒目

6. 响应式界面

• 桌面端：三栏布局（频道列表 + 播放区 + 节目单）
• 平板端（≤1024px）：节目单面板改为右侧抽屉式
• 移动端（≤768px）：频道列表改为左侧抽屉，点击频道自动收起
• 支持全屏播放、上下频道切换、播放/暂停控制

7. 一键安装 PHP（v1.2.0 新增）

飞牛OS 不自带系统级 PHP CLI，v1.2.0 版本新增：

• 自动检测 PHP 运行环境
• 设置页面提供 一键安装 PHP 按钮
• 通过 apt-get install php-cli 自动安装
• 支持识别 Docker 容器、WebOps、宝塔等多种常见 PHP 安装路径

三、安装方法

方式一：通过飞牛应用市场安装

1. 打开飞牛OS 桌面 → 进入 应用市场
2. 搜索 "飞牛IPTV"
3. 点击 安装，等待安装完成
4. 安装完成后在桌面找到"飞牛IPTV"图标，点击打开

方式二：手动安装 FPK 包

1. 下载 .fpk 安装包到本地
2. 打开飞牛OS → 文件管理，将安装包上传到任意目录
3. 在文件管理器中双击 .fpk 文件，或右键 → 安装应用
4. 确认安装提示，等待安装完成
5. 安装成功后桌面出现"飞牛IPTV"图标

首次启动检查

首次打开应用后，查看右上角 状态徽章：

四、界面详解

顶栏（顶部导航）

**─────────────────────────────────────────────────────────────**
** ☰  飞牛IPTV v1.0  [节目单] [设置]              PHP OK 77频道 **
**─────────────────────────────────────────────────────────────**

左侧频道列表

• 搜索框：输入关键词实时过滤频道（支持拼音/中文/英文）
• 分组标签：全部、央视、卫视、港澳、央视付费、自定义... 点击切换分组
• 频道项：台标 + 频道名称 + 当前正在播放的节目名（EPG 可用时）
• 点击任意频道立即开始播放，当前播放频道高亮显示（蓝色左边框）

中间播放区

• 视频播放器占据主要区域，黑色背景
• 加载中显示旋转动画和提示文字
• 底部悬浮控制栏：播放/暂停、频道信息、上一台/下一台、全屏

右侧节目单面板

• 顶部显示当前频道名称 + 关闭按钮
• 按时间顺序列出当日节目
• 正在播放的节目有绿色左边框高亮
• 每条节目显示：时间段 + 节目名称 + 简介（如有）

五、使用教程

5.1 观看直播

步骤：

1. 打开飞牛IPTV 应用
2. 在左侧频道列表中，通过 分组标签 筛选想看的频道类别（如"央视"、"卫视"）
3. 也可以直接在 搜索框 中输入频道名快速定位（如输入"**5"）
4. 点击频道名称，视频区自动加载并播放
5. 观看时可使用底部控制栏：
   • ▶ / ⏸：播放/暂停
   • ⏮ / ⏭：切换上一个/下一个频道
   • ⛶：进入全屏模式

快捷键提示：

• 键盘方向键 ↑/↓：上/下频道
• 空格键：播放/暂停
• F 键：全屏切换

5.2 查看节目单

方式一：右侧面板查看

1. 点击顶栏的 节目单 按钮
2. 右侧滑出节目单面板，显示当前频道的当日节目列表
3. 当前播放的节目以绿色左边框标记
4. 再次点击"节目单"按钮或点击 × 关闭面板

方式二：频道列表快速预览

• 频道列表中每个频道名称下方会显示"正在播出"的节目名
• 切换频道时自动加载对应节目的 EPG 数据

5.3 添加自定义频道

1. 点击顶栏 设置 按钮，打开设置弹窗
2. 找到 "添加自定义频道" 区域
3. 依次填写：
   • 频道名称（必填）：如"我的电视台"
   • M3U8/M3U 播放地址（必填）：直播流地址，支持 m3u8 / m3u 格式
   • 台标 URL（可选）：频道 logo 图片的网络地址
   • 分组（可选）：自定义分组名称，默认"自定义"
4. 点击 添加 按钮
5. 添加成功后，在左侧频道列表的对应分组中即可看到新频道

5.4 导入 M3U 播放列表

从 URL 导入

1. 打开 设置 → "导入M3U播放列表"
2. 在输入框中粘贴 M3U 播放列表的 URL（必须以 http/https 开头）
3. 点击 从URL导入
4. 等待导入完成，频道自动出现在列表中

从本地文件导入

1. 打开 设置 → "导入M3U播放列表"
2. 点击 从文件导入 按钮
3. 在弹出的文件选择窗口中，选择本地 .m3u / .m3u8 / .txt 文件
4. 确认后自动解析并导入所有频道

提示：M3U 文件中的 tvg-logo、group-title 等属性会被自动识别为台标和分组。

5.5 管理自定义频道

1. 打开 设置 → "自定义频道管理"
2. 列表中显示所有已添加的自定义频道
3. 点击频道右侧的 删除 按钮可移除该频道
4. 删除后频道列表即时更新

注意：内置央视频道无法删除，只能隐藏自定义频道。

5.6 自定义 EPG 源

1. 打开 设置 → "EPG节目单源"
2. 在输入框中填入你的 EPG XML URL（必须返回 XMLTV 格式）
3. 点击 保存 按钮
4. 点击 刷新EPG 立即重新拉取节目单数据

推荐的 EPG 源：

• https://epg.136605.xyz/3days.xml（默认，3天节目单）
• https://epg.112114.xyz/pp.xml（另一个常用源）

5.7 安装 PHP（如缺失）

如果右上角状态显示"PHP未安装"：

1. 点击顶栏 设置 按钮
2. 在 "PHP状态" 区域点击 一键安装PHP 按钮
3. 等待系统自动通过 apt-get 安装 php-cli
4. 安装完成后状态变为绿色的 "PHP OK"
5. 回到主界面即可正常观看央视频直播

说明：央视频直播流的解析依赖 PHP 脚本（ysp.php），因此必须安装 PHP 环境才能使用内置频道。自定义频道（M3U8 直链）无需 PHP。

六、内置频道完整清单

央视频道（26 个）

央视付费频道（4 个）

卫视频道（35 个）

七、常见问题（FAQ）

Q1：打开应用后频道加载失败，显示红色错误？

原因：PHP 未安装或 ysp.php 缺失。
解决：

1. 查看右上角状态徽章
2. 若显示"PHP未安装"，进入设置 → 点击"一键安装PHP"
3. 若显示"ysp.php缺失"，尝试重新安装应用包

Q2：播放十几秒后画面卡住不动？

原因：这是旧版本的已知问题。v1.2.0 已通过 M3U8 代理刷新机制修复。
解决：

• 确保使用的是最新版本（v1.1.2 及以上已修复）
• 如果仍出现卡顿，刷新页面或切换频道后再切回

Q3：台标图标不显示？

原因：网络问题导致 CDN 上的台标图片加载失败。
解决：

• 应用有自动降级机制：CDN → 代理缓存 → 首字母占位
• 如果所有台标都不显示，检查 NAS 的网络连通性
• 自定义频道可自行更换台标 URL

Q4：节目单不显示或显示错误？

原因：EPG 源不可用或频道名称不匹配。
解决：

1. 进入设置 → 点击"刷新EPG"重新拉取
2. 如仍不行，更换 EPG 源地址（参考 5.6 节）
3. 自定义频道需要 EPG 中存在对应频道名称才能匹配

Q5：电脑端播放 15 秒后报错 networkError？

原因：桌面端 Webview 原生 video 不会刷新直播 M3U8 列表。
解决：v1.1.3 及以上版本已修复（优先使用 hls.js）。升级到最新版即可。

Q6：移动端如何切换频道？

操作：

1. 点击左上角 ☰ 按钮展开频道列表
2. 选择频道后列表自动收起
3. 也可以通过底部控制栏的 ⏮/⏭ 按钮快速切换

Q7：支持回看或时移吗？

目前版本仅支持 直播，不支持时移回看功能。部分央视频道的直播源可能自带短时长的延迟缓冲，但不是真正的回看。

Q8：所有频道都播放 **-1？

原因：这是 v1.1.0 及更早版本的 Bug。
解决：升级到 v1.1.1 及以上版本即可修复。

八、技术参数

九、更新日志

v1.2.0

• 增加一键安装PHP功能。飞牛OS不自带系统级PHP CLI，在设置页面增加一键安装按钮，自动通过apt-get安装php-cli
• 改进PHP查找逻辑，支持Docker容器、WebOps、宝塔等常见安装路径

v1.1.6

• 修复**11/12/13误匹配**1节目单（去掉前缀匹配改用精确匹配）
• 修复频道列表不显示当前节目（EPG时间含时区后缀导致比较失败，解析时去掉+0800后缀）

v1.1.5

• 更换默认EPG源为epg.136605.xyz/3days.xml
• 修复所有频道都显示**1节目单（EPG频道ID为数字，改为用频道名称替换后匹配）
• 节目单时间格式改为开始时间-结束时间

v1.1.4

• 增大台标(32->40px)和频道名称字体(12->14px)
• 修复EPG节目单无法加载（设置默认EPG源）
• 改进EPG频道匹配逻辑
• 修复电脑端节目单无法关闭（桌面端用hidden类控制显示/隐藏）

v1.1.3

• 修复电脑端播放15秒后卡住报networkError（canPlayType在部分桌面webview返回非空导致走原生video分支）
• 改为优先使用hls.js，仅iOS回退原生
• 增加网络错误自动重试

v1.1.2

• 修复播放十几秒后卡住的问题（blob URL是静态的，hls.js无法刷新直播列表）
• 改为/api/m3u8代理URL，hls.js可定期刷新获取最新分片列表
• M3U8缓存5秒平衡新鲜度和性能

v1.1.1

• 修复所有频道都播放**1的问题（CLI模式下$_GET为空导致默认使用**1）
• 改为通过命令行参数传递频道ID
• 添加CGI频道ID到PHP频道ID的完整映射表

v1.1.0

• 修复v1.0.5起视频无法播放的根因
• 回退hls.js为CDN加载（本地文件在FNOS CGI模式下无法被正确请求）
• 回退HLS配置为简单参数
• 增加CDN加载失败自动回退到备用镜像
• 增加播放错误诊断提示

v1.0.5

• 修复台标不显示（修正logo路径及文件名，改用jsdelivr镜像）
• 优化直播加载速度（PHP路径缓存、HLS低延迟配置、hls.js本地化）

v1.0.4

• 修复api()函数对GET请求携带body导致fetch报错(TypeError)的问题
• GET参数改由URL查询字符串传递

v1.0.0

• 首版飞牛IPTV播放器发布
• 集成央视频直播源（73个频道）
• 自定义频道管理
• M3U播放列表导入
• 台标显示
• EPG节目单
• HLS播放器
• 手机适配

下载地址：https://wwbse.lanzoue.com/ikoBS3wj91hc
密码:ab1b