IPTV 运营系统 · 帮助文档

1登录后台与首次配置#

频道、点播、客房桌面、电话分机与设备都在这一个后台里管理。服务器由工程师上门装好并交付，你只需要一个浏览器：登录之后，配置、日常管理、备份都在后台完成，不需要登录服务器。

三种典型部署

打开后台

1. 交付时你会拿到三样东西：后台地址（形如 http://<服务器IP>:1090/admin/）、管理员账号、初始密码。
2. 用 Chrome / Edge 等新版浏览器打开即可，手机、平板同样能用。地址末尾要带 /admin/，只输 IP 看到的是设备欢迎页。
3. 地址忘了不要紧：同一网络内的任意一台电脑都能打开，让服务商把地址再发一次即可。

默认账号

首次配置清单

• 改管理员密码；需要的话在「基础设置」设机顶盒设置密码（默认 1234）。
• 「信源 / VLAN」登记实际使用的网卡，配好 VLAN 子接口。
• 「频道 / 节目」建频道或导入节目源，确认「测试收流」有数据后再启动。
• 「套餐管理」勾选频道组合，「用户管理」建客房账号并分配套餐。
• 「桌面首页」上传品牌 Logo、填欢迎语与天气城市；「APP 升级」上传三个 APK。
• 「备份与恢复」配好邮箱定时备份，至少手动备份一次。
• 「授权管理」确认机器码、模块与期限（试用期为首次登录后台起 30 天）。

2后台功能地图#

左侧菜单按业务分组，默认收起，点开一组自动收起其它组。下面是每组能做什么，遇到「这个功能在哪」先查这张表。

3频道与直播信源#

一个频道对应一个播放地址（/live/<频道ID>/index.m3u8），可以配最多 6 路信源和一组切片参数；电视端、盒子、浏览器都播这个地址。

信源地址怎么写

收不到流先看这里

在「测试收流」里点一下，几十秒内包计数在涨，说明这一路已经到服务器了；一直是 0，说明包没到，先查网络侧。

1. 0 包：交换机没放行该 VLAN、源没在推流、组播组或端口抄错，这几种占九成。
2. 0 包：服务器与源跨网段时，需要网络管理员在三层交换机上把组播路由指向服务器。公网 / 云主机一般不给组播，必须部署在本地网络。
3. 0 包：交换机开了 IGMP Snooping 却没有 Querier，也会让组播出不来。
4. 有包但起不来：核对信源地址有没有多余空格、协议头是否完整、频道的「信源接口」选对没有。

多 VLAN 接入多路信源

上联口配成 Trunk 后，在「信源 / VLAN」里给每条 VLAN 建一个子接口（例如 eth0.100 → 10.0.100.5/24），再在频道里把「信源接口」分别选成对应子接口。每个频道都要绑定自己的信源接口，否则两条 VLAN 上的同一个组播地址会出现「两个频道画面一模一样」或者干脆收不到。

多信源与自动切换

• 每个频道最多 6 路：主用 + 备用 1～5，启动时优先选有信号的那一路（不一定从主用开始）。
• 主用断流或卡住时自动切到下一路；几路都没信号会自动停台，信源恢复后自动重新开播。
• 电视端只显示已启动的频道，停台 / 未启动的频道不出现，避免客人点到黑屏。

批量导入节目源

「频道 / 节目 → 导入节目源」支持粘贴「名称,地址」文本或 M3U，可用 #genre# 分组。导入时会逐路试播：有信号的收为主用 / 备用，同名频道只追加备用源，全部无信号的频道建号后停台等恢复。

重新编号

右上角「重新编号」按广电 / 酒店习惯从 1 连续排：央视频道 → 央视付费 → 卫视 → 地方台 → 港澳台 → 电影 / 体育 / 音乐 / 戏曲 → 点播频道。只改编号与分类，不影响正在转发的频道，可重复执行。

启停、监控与播放地址

• 启动 / 停止可以单个操作，也可以「全部启动 / 全部停止」；重启服务器后是否自动起播由「基础设置 → 重启后自动起播」控制。
• 概览页的信源健康度会把有问题的频道直接列出来（评分 / 健康 / 波动 / 故障）。
• 输出地址 /live/<频道ID>/index.m3u8；后台可生成带令牌的完整可播地址，令牌默认 3600 秒有效，可在「基础设置」修改。
• 把带令牌的地址转给别人、或超过有效期，播放会提示 403，重新生成一个即可。

4EPG 节目单#

给直播频道配「每天循环」的时段表，电视端频道卡片与播放页会自动显示「正在播出」和「下一档」。

三种录入方式

• 逐条新增：开始 / 结束时间 HH:mm、节目名（≤60 字）、可选简介、生效星期（全选=每天，只选周一至周五=工作日）。
• 批量导入：一行一条，08:00-09:30 新闻早班车，用 | 追加简介；09:30~10:00、10:00 至 11:30 都认。可一键「填入示例模板」再改。
• 互联网采集：从 XMLTV 源自动拉节目单，适合央视频道、卫视。

互联网 EPG 采集

1. 添加采集源：「EPG 节目单 → 采集源管理 → 添加」，填名称与 XMLTV 地址，支持 .xml.gz。
2. 频道映射：按频道名自动匹配，匹配不上的在「频道映射」里手工指定，改完立即生效。
3. 定时同步：默认每 6 小时拉一次（可调 1～72 小时），也可「立即同步全部」；只保留近期节目单。

采集到的节目优先展示，手工节目单作为兜底：采集源失效或频道没映射时自动显示手工表，两者互不覆盖。

5影视点播与转码#

上传影片后系统按文件名自动识别类型、季集与年份，采海报与简介，再发布成点播频道或 24 小时轮播频道。

从上传到能看

1. 上传：「影视库 / 点播 → 上传影片」，支持 mp4 / mkv / mov 等，单文件最大 8GB。
2. 自动识别：按文件名判断电影 / 电视剧 / 短剧 / 动漫 / 纪录片 / 综艺与季集年份，剧集自动聚合为「详情 + 选集」。
3. 补元数据：配置 TMDB 后自动采海报、简介、评分、题材；旧片可「重新识别全部影视」补齐。
4. 转码：上传后自动转码，进度实时显示；关掉浏览器也会继续。
5. 发布：一键发布为点播频道，或按「轮播模式」发布成 24 小时频道。

转码参数怎么选

不想让某部片出现在点播 APP 里，可以「在点播中隐藏」，它仍可被桌面首页宣传位第 4 块指定推荐。

6用户、套餐与机顶盒绑定#

套餐决定「能看哪些频道」，用户决定「谁在看、几台设备」，绑定决定「这个房间的盒子开机能不能直接进桌面」。

套餐与用户

• 套餐：勾选频道组合、填价格、有效期天数，可上下架。
• 用户：新建账号时初始密码可以留空——留空即「只输账号就能进」，填了密码才能设成「必须密码」。
• 续费 / 禁用 / 删除：禁用后该账号立即不能登录，已登录的盒子也会被踢出。
• 设备数上限：单账号可同时登录几台盒子，超出会提示「请联系前台解绑」。
• 开机直播：勾上后这个账号的盒子启动直接进直播，不显示桌面。

免密登录（账号 + 设备绑定）

盒子第一次登录客房账号（默认不需要密码）时会自动记住这台设备；之后升级、重装、重启都不用再输，开机直接进桌面。

绑定与解绑

• 「用户管理 → 机顶盒」能看到每台设备的名称、硬件编码、绑定时间、最后在线时间 / IP、APP 版本。
• 换盒子：先解绑旧的（单台或全部），新盒子登录一次即绑定；解绑后旧设备立即失效。
• 账号被禁用或删除时，绑定的设备同时失效，绕不过账号状态。

7电视端与三个 APP#

同一套设计打出三个包：桌面（launcher）、直播（live）、点播（vod），同一签名、一处登录三处通用。也可以先用浏览器 TV 端做验收。

浏览器 TV 端

http://<服务器IP>:1090/tv/：方向键移动焦点、OK 确认、返回键回桌面、数字键 1-9 切台。适合上线验收和前台电脑演示。

三个安装包

桌面登录一次，直播 / 点播启动直接进，不用再登；在任意一个 APP 里改服务器地址或重新登录，三个包一起生效。

遥控器操作

设置密码与服务器地址

• 设置密码 4～8 位数字，默认 1234，后台「基础设置 → 机顶盒设置密码」修改，下次进入立即生效。
• 连续输错 8 次锁定 10 分钟；管理员可在后台看到当前密码。
• 登录页与设置页只填 IP，http:// 与端口自动沿用，客人不会把格式改坏。

升级与开屏

• 后台上传新版 APK 会自动识别包名与版本号，盒子启动或回到桌面时检查更新；可设强制升级、保留 6 个历史版本回滚。
• 直播 / 点播打开时先显示启动画面（背景图 + 0～10 秒读秒），读秒结束再进首屏。
• 支持 Android 4.4 及以上；个别老盒子第一次需要手动装一次较新的版本，之后才能自动升级。

8桌面首页与消息通知#

客房电视第一屏决定观感：品牌、欢迎语、宣传位、天气、热门推荐都在这里配。

桌面首页

• 品牌：上传 Logo、填品牌名称与欢迎语；电视端桌面不显示账号名与套餐，保持干净。
• 宣传位：图片或视频，一屏 4 块轮播，视频静音循环；第 4 块可以指定某部点播影片，按 OK 直接进详情。
• 天气：填城市名，首页显示实时天气与日期时钟。
• 热门推荐：正在热播 / 热门点播，取点播播放热度。
• 直播默认播放：固定频道或上次观看；客房首页进入直播可直接起播。

消息通知（跑马灯）

信息发布

四级栏目 + 图文页，用来放酒店介绍、周边、消防须知、活动通知等；内容独立于点播，不占影视库。

9SIP 电话分机#

后台内置话务能力：客房话机 / 软电话注册上来后互相拨分机号，不依赖外部话务商。开通、改号、看注册状态都在「SIP 电话」页完成。

默认已经开通

电话功能随系统一起交付，首次启动会自动预置 8001–8008 共 8 个分机，密码在「SIP 电话」页可直接查看——话机填上就能注册，不用另外申请或配置。

开号与配置

• 「SIP 电话 → 批量开号」：填号段与数量，密码随机或固定，可加备注前缀。
• 指定监听网卡（下拉里选客房能访问的那张网卡）与端口，多网卡服务器一定要选对。
• 话机上填：服务器地址（服务器 IP）、分机号、密码，传输选 UDP，注册成功即亮绿灯。
• 「注册状态」看每个分机当前是否在线；「通话记录」可看主叫 / 被叫 / 时长 / 接通状态，支持筛选、同步、清空与导出 CSV。

注册不上怎么查

1. 话机和服务器在不在同一网段，用手机的网络测试 / ping 一下服务器 IP。
2. 「SIP 电话」页里的监听网卡选的是不是客房那张；换过网卡或改过 IP 后要重新选一次。
3. 分机号与密码是否与后台一致；传输协议统一选 UDP。
4. 以上都对还是离线，把分机号与话机型号发给服务商，由服务商在服务器侧查注册情况。

10网络、VLAN 与组播#

网络配置都在后台完成：改 IP、加 VLAN、配路由、发地址、对时，网页上点几下即可，不需要登服务器改配置文件。

常用入口

组播不通的排查顺序

1. 先看「测试收流」的包计数：一直在涨，说明包已经到服务器，问题多半在信源地址、绑定接口或切片参数。
2. 一直是 0：包没到服务器。让网络管理员确认交换机放行该 VLAN、源在推流、组播组与端口没抄错。
3. 两条 VLAN 同组同端口画面一样：给每个频道分别绑定各自的子接口。
4. 开了 IGMP Snooping 却收不到：交换机上要有 Querier，或把上联口设成组播路由口。

IPv6 访问

服务器有 IPv6 地址时，管理后台、TV 端、播放地址都能用 http://[IPv6地址]:1090 访问，IPv4 同时可用。

11存储与磁盘扩容#

片子多了先扩存储，不要先删片；直播切片只占临时空间，重启就会清空。

三类存储

扩容点播存储

• 本地磁盘：「存储管理 → 本地磁盘」格式化 / 挂载 / 卸载，挂载后把点播目录指过去。
• 网络磁盘：「存储管理 → 网络磁盘」挂 NFS 或 SMB，适合 80T 级影视库；挂载后同样改点播目录。
• 迁移：改点播目录后已有文件会自动迁移，迁移期间别关机、别断电。

12备份、升级与日常巡检#

运维只需要盯三件事：能备份、能升级、出问题能看出在哪。这三件事后台都有对应页面，不用登服务器。

备份

• 「系统设置 → 备份与恢复」配 SMTP（支持 SSL），可定时把数据打包发到邮箱，也可立即备份一次。
• 备份内容是整套业务数据：频道、套餐、用户、桌面、授权信息与上传的图片 / APK。换机时在新机上「恢复」导入即可。
• 恢复期间系统会短暂停止转发，安排在夜间或停播时段做；恢复完成后频道会自动重新起播。
• 升级前系统会自动备份一次，升级出问题可在「系统升级」里回滚到上一版本。

升级

升级服务期由签发时的「升级年限」决定，0 表示永久。服务期结束后当前版本照常使用，但不能在线升级到新版本。升级过程中后台会短暂断开，几分钟后刷新页面即可。

日常巡检清单

13授权与注册#

授权跟机器绑定，不是跟安装包绑定。机器码由系统根据硬件信息自动生成，在「授权管理」页就能看到与复制。

机器码与模块

• 机器码：16 位十六进制，后台「授权管理」可查看与复制；换硬件、改系统名都会让它变化。
• 授权模块：桌面 APP、直播、点播、拉流、推流（组播再输出）、投屏，各自独立校验；只签发用到的模块。
• 用户档位：签发时选 210 户 / 510 户 / 无限制，新建用户时校验当前激活账号数，超了返回「已达到授权用户数量上限」。

注册流程

1. 客户把后台显示的机器码发给服务商。
2. 服务商按机器码签发：勾选模块、填使用年限与升级年限（0 = 永久）、选用户档位。
3. 后台会自动校验授权（也可点「获取授权」立即校验），全程不需要导入文件。
4. 需要离线部署时，服务商发来注册文件，客户在「授权管理 → 离线导入」导入即可。

试用与到期

• 未注册机器自首次登录后台起 30 天试用，全模块可用。
• 已注册机器会自动校验授权。长期连不上授权服务器、授权被吊销或使用期限到期，后台会提示「授权非法 / 已过期」并中断业务，恢复合法授权后自动恢复正常。
• 换新服务器：先用备份包在新机「恢复」数据，再按新机显示的机器码签发（以新机显示的为准）。

14远程协助与安全边界#

服务商可以在不打电话问地址的情况下远程看后台；但不管从哪里进来，都要验证这台机器的后台账号密码。

进入方式

这里要的是这台 IPTV 后台自己的账号密码，与门户账号无关。要让服务商远程进来，在「系统设置 → 远程云端管理」复制管理密钥交给对方；重置密钥后旧入口立即失效。

建议的安全基线

• 管理员密码、机顶盒设置密码全部改掉，不要用默认值。
• 远程入口只给运维人员，客人只走客房账号。
• 后台对公网开放时，让服务商只放行必要端口，其它一律拒绝。
• 每个客房账号设备数设为 1，贵重场景改成「必须密码」。
• 定期改远程管理密钥，尤其是人员变动后。

15常见问题速查#

按「现象 → 处理」查，90% 的现场问题都在这张表里。表里只写后台能做的动作，需要服务商处理的会明确标出来。

16术语表#

和集成商、广电、运营商对接时最常出现的词，只解释「是什么、和你有什么关系」。