IPTV-PBX 智能电视系统使用说明书 · 酒店IPTV系统搭建与运维指南

一、系统简介

IPTV-PBX 是一套面向酒店 / 宾馆的一体化系统，集「组播直播转码切片 + 酒店电视交互界面（TVUI）+ 电话交换（PBX）+ 网络管理」于一体。运营人员通过浏览器即可完成全部配置。

二、登录管理端

在浏览器中打开 http://10.8.11.200:8082，进入登录页。输入用户名与密码后点击「登录」。登录成功后默认进入「节目管理」页面。左侧为功能导航，分为「直播 / 网络 / 系统 / 终端 / 通信 / 管理」六个分组。

三、直播

3.1 节目管理

直播节目的核心管理页面。支持 RTSP / RTP / UDP 组播 / 本地文件等多种信源，可一键开始 / 停止推流、编辑参数、预览 HLS 画面、删除文件或删除节目。

列表字段说明：

3.2 直播桥接

面向「多 ONU 接入 + 负载均衡」的高级直播分发配置。同一份节目单，终端 / 播放连接按上限自动分配到下一台 ONU。包含「逻辑频道」「运营商池（推荐）」「TVUI 默认播放方式」「负载均衡」四个部分。

TVUI 默认播放方式可选 直播桥接（udpxy） 或 HLS（m3u8）；切换后新同步的节目采用此模式，已同步节目可在 TVUI → 直播节目管理中逐条修改。

3.3 定时任务

按计划自动执行的任务（如定时插播、定时重启等）。可添加任务、查看下次 / 上次执行时间、启用状态与执行结果，并支持「立即终止插播」。

四、网络

4.1 网络管理

管理服务器全部网络接口、连接方式与 IP 配置。顶部显示平台访问出口 / 聚合口管理 / 桥接管理 / 系统默认出口等入口。

本机当前共 12 个网络接口，支持启用 / 禁用 / 重启、配置（DHCP 或静态 IP）、设为主接口、添加 / 删除 VLAN。节目接收用的组播网卡（enp3s0 等）即在此查看和配置。

4.2 网络诊断

选择网络接口、填写目标地址、设置 Ping 次数与超时时间，即可进行连通性诊断，用于排查组播 / 信源网络问题。

4.3 抓包工具

选择网卡后开始抓包，用于分析组播流、协议交互等疑难问题。抓包文件默认存储在 /tmp/iptv-pcap，可在文件列表中下载分析。

五、系统

5.1 系统状态

实时展示服务器硬件与运行状态：CPU 使用率 / 核心数 / 型号、内存、磁盘、运行时间与负载，以及全部网络接口的流量统计。并提供「重启推流 / 重启 PBX / 重启系统」快捷操作，以及 24 小时监控图表。

5.2 系统维护

包含三块能力：定时重启后台服务（清理内存 / CPU 占用）、FFmpeg 定期重启与内存阈值、以及系统配置备份 / 恢复。备份范围可选节目数据、直播桥接、PBX、TVUI、系统设置、网卡备注与优先级、定时任务等；可导出 tar.gz，恢复前可选择覆盖所选模块现有数据。

5.3 系统日志

记录系统运行指标与各服务状态，包括 CPU / 内存 / 磁盘使用率、负载、进程数、TS 文件数、错误数，以及后端、MySQL、Nginx、Asterisk、FRP、FFmpeg 进程、Asterisk 通话等服务的健康状态，便于故障排查。

六、终端 · TVUI 管理

TVUI 管理用于配置酒店电视（机顶盒 APK）的显示界面与内容。页面顶部可选择「当前 TVUI 组」（默认组 100），实现不同区域 / 楼层显示不同界面。包含五个子标签：

6.1 基础配置

配置电视端界面。可设置项目名称与 Logo、WiFi 名称 / 密码（支持 %room% 变量，自动替换为终端房间号）、前台电话、菜单栏高度、ExoPlayer 硬解 / 软解、小度 TV、APK 开机进入（主页 / 数字电视）、语言控制方式、UI 主题、天气地点与百度天气 API Key。设置后可「批量应用到本组终端」。

「配置范围」提供四个分页：通用、经典版首页、时尚版首页、简约版首页，用于分别配置不同主题的专属素材（如背景图、标题等）。

6.2 展示与素材

配置电视端展示用的图片 / 视频素材，包括轮播图、开机画面、滚动字幕等。

6.3 菜单与节目

「菜单管理」维护电视首页的功能菜单（菜单名称、动作类型、动作值、顺序、状态）；「直播节目管理」维护直播节目分组与播放方式。

6.4 终端与升级

查看已注册的电视终端，并对 APK 进行升级管理。

6.5 TVUI 组管理

新增与管理多个 TVUI 组，实现不同区域显示不同界面。

七、通信 · PBX 管理

PBX 管理提供酒店电话交换能力，包含七个标签页：分机管理、通话记录、电话录音、呼叫转移、呼叫中心、SIP 网关、系统状态。

7.1 分机管理

管理酒店客房 / 前台分机。可添加分机、批量添加、批量删除，查看分机号、显示名称、配置状态、注册状态（在线 / 离线）、通话状态（空闲等）、语音信箱与录音开关，并支持编辑、状态历史、删除。

7.2 通话记录

查询与导出通话详单（CDR）。上方统计总通话数、已接听、未接听、总通话时长；下方列表展示主叫、被叫、外线号码、类型、开始时间、通话时长、状态、录音，并可查看详情、下载录音。

7.3 电话录音

管理分机通话录音文件，可在线试听 / 下载。

7.4 呼叫转移

配置呼叫转移规则，实现来电自动转接。

7.5 呼叫中心

呼叫中心相关配置（队列、坐席等）。

7.6 SIP 网关

配置 SIP 中继 / 网关，对接运营商或上级软交换。

7.7 系统状态

查看 PBX 运行状态与注册情况。

八、管理

8.1 授权管理

查看与激活系统授权。展示设备 ID、自定义注册令牌、授权状态与到期时间、IPTV 功能与转码功能启用情况。激活方式：复制设备 ID 发给授权管理员 → 生成授权码 → 粘贴并点击「激活授权」。PBX 功能需在「PBX 授权」标签页单独激活。

8.2 系统升级

支持三种升级方式：在线升级（腾讯云 COS）、Ubuntu Agent 升级、本地上传。升级前系统会自动备份后端与前端，失败自动回滚。当前版本：后端 2.1.29（Build 20260918-180902）、前端 2.1.29。

九、酒店电视 APK（TVUI 客户端）

电视端使用「酒店智能电视」APK（包名 com.hotel.tvapp，版本 v17.86）。安装后需将服务器地址设置为 10.8.11.200，APK 会自动向 http://10.8.11.200:8080 注册并拉取 TVUI 配置。

9.1 服务器地址设置

首次运行时，APK 会自动弹出注册框，在「服务器地址」输入框中填写 10.8.11.200（端口默认 8080），点击保存 / 注册即可。若需重新设置，可在界面使用遥控器快捷键 上 下 上 下 左 右 左 右 唤出注册页面。设置成功后，电视端将自动注册并同步管理端下发的界面与内容。

9.2 三种主题界面

TVUI 提供三种首页主题，可在管理端「TVUI 管理 → 基础配置 → UI 主题」中切换。以下为三种主题在电视端的实际显示效果。

9.3 数字电视（直播）

点击底部「数字电视」菜单即可进入直播播放页，播放管理端「节目管理」中已配置的频道。下图为直播页在无可用节目时的提示界面。

十、常见问题