易硕科技YISHUO TECH
首页/下载与部署

一条命令
把 IPTV 装到你的服务器上

联网环境复制一行命令即可装完:系统会自动装 ffmpeg、Node.js、DHCP/DNS、控制台欢迎屏,以及 SIP 电话服务器 Asterisk。没有外网的机房用全量离线包,U 盘拷进去一样装。

Online · 推荐

联网安装:复制一行命令

在全新安装的 Ubuntu Server 上,用 root(或 sudo)执行下面这条命令,脚本会下载对应版本的程序包、校验 sha256、再装好全部依赖与服务。

bash curl -fsSL https://xcitv.com/install.sh | sudo bash

装完打开 http://<服务器IP>:1090/admin/,用 admin / admin123 登录(首次登录请立刻改密码)。整个过程约 3–10 分钟,取决于带宽与机器性能。

安装前准备

  • 系统:Ubuntu Server 22.04 / 24.04 / 26.04(x86_64 或 arm64),最小化安装即可。
  • 网络:能访问外网(xcitv.com 与 Ubuntu 软件源)。纯内网请用离线包。
  • 硬件:4 核 / 8G 起步;直播路数按「核数 × 30」自动给推荐值,单机上限 200 路。
  • 权限:root 或 sudo 用户;装机会创建 iptv 服务账号。

脚本会做什么

  • 装依赖:ffmpeg、Node.js 20、dnsmasq、chrony、nfs/cifs 工具、Asterisk。
  • 程序放 /opt/iptv,数据放 /var/lib/iptv,注册 systemd 服务 iptv。
  • 直播切片挂 tmpfs 内存盘(不磨损硬盘),点播落本地或网络磁盘。
  • 首次安装设主机名与网卡默认值,并启用显示器 / 串口欢迎屏。
  • 授权后台管理 SIP:首次启动自动预置分机 8001–8008。
不想直接管道执行?先存盘再跑,效果一样: curl -fsSLO https://xcitv.com/install.sh && sudo bash install.sh
只想先看看会装什么:在后面加 --dry-run(只下载校验,不动系统);已有环境想保留主机名/网卡:加 --skip-hostname --skip-nics。
Offline · 内网 / 机房

离线全量包:拷进去就能装

离线包里带齐程序与全部依赖 .deb(含 ffmpeg、Node.js、Asterisk、dnsmasq 等),目标机完全不需要外网。依赖与系统版本绑定,请按目标机的 Ubuntu 版本选包。

适用系统架构安装包大小校验值下载
正在读取版本信息… 如长时间无内容,请直接访问 版本清单 或 SHA256SUMS。

当前版本 — · 发布时间 — · 全部文件校验值见 SHA256SUMS

离线安装三步

  1. 下载对应系统的离线包,拷到目标机(U 盘 / scp / 内网文件服务器均可)。
  2. 解包并安装:
    tar xzf iptv-offline-*.tar.gz && cd iptv-offline-*/app && sudo bash deploy/install.sh --offline
  3. 打开后台:http://<服务器IP>:1090/admin/,admin / admin123。

校验与注意

  • 下载后先校验,避免传输损坏:
    sha256sum -c SHA256SUMS
  • 离线包只装依赖与程序,不联网也能用;后续升级用后台「系统升级」上传升级包。
  • 目标机 Ubuntu 版本与包不一致时,请用对应版本的机器重新生成:bash deploy/make-offline-bundle.sh。
  • arm64 服务器如需离线包,可在同架构机器上执行上面的生成脚本。
After install

装完之后

安装脚本结束会打印一份装机报告,同时写入 /etc/iptv/install-report.txt;换机器、排障先看它。

入口地址默认账号
Web 管理后台http://<服务器IP>:1090/admin/admin / admin123
浏览器 TV 端http://<服务器IP>:1090/tv/demo / demo123
SIP 电话分机话机里填「SIP 服务器 = 本机 IP,端口 5060」后台「SIP 电话」里的分机号与密码(默认 8001–8008)
系统登录SSH / 显示器 / 串口(控制台键入 88)装机时创建的系统账号,见装机报告

默认就带 SIP 电话

  • 安装包默认装 Asterisk 22,并授权后台管理,不用另外买 IPPBX。
  • 首次启动自动预置 8 个分机(8001–8008),密码在后台直接看。
  • 话机注册后内部分机互拨直呼号码,*500 是回声测试,验收话机最快。
  • 监听网卡 / 端口、批量开号、改密、通话记录都在后台「SIP 电话」。
  • 不需要电话功能:安装时加 --skip-sip,或后台关掉 SIP 服务。

接下来的三件事

  • 改密码:后台超管、系统账号、机顶盒设置密码(默认 1234)。
  • 登记信源:后台「信源 / VLAN」选网卡,频道里填组播地址并「测试收流」。
  • 做授权:新装机器自动进入 30 天试用;转正用机器码生成注册文件,在「授权管理」导入。
  • 详细步骤:帮助文档 · 登录后台与首次配置。
FAQ

安装常见问题

在线安装卡在「正在读取版本信息」或下载失败?

脚本会依次尝试 xcitv.com 与 www.xcitv.com。都失败一般是 DNS 或出网被限制:先 curl -I https://xcitv.com 看通不通,或用 --mirror 指定内网镜像;纯内网请直接用离线包。

重装会不会丢数据?

不会。程序在 /opt/iptv,数据在 /var/lib/iptv(db.json、切片、密钥、备份)。安装脚本是幂等的,检测到已有数据会自动跳过主机名与网卡设置,只补组件。

装完 SIP 显示「Asterisk 未运行」?

先看 systemctl status asterisk。常见原因是 5060 被别的进程占用,或系统里已有其它 SIP 服务;停掉冲突进程后执行 sudo bash /opt/iptv/deploy/setup-sipctl.sh 重启并重新下发配置。

能不能装在虚拟机 / 云主机上?

可以装、后台也能用,但组播接收需要与组播源同网段:云主机通常收不到组播,直播要用 HTTP / RTSP 单播源。生产环境建议放在本地机房或弱电间。

支持哪些系统版本?

Ubuntu 20.04 / 22.04 / 24.04 / 26.04 均可(x86_64、arm64)。离线包按系统版本分别发布,装之前确认版本对得上。

装完想让人陪着调一遍?

把房型、点位数和现有信源发给我们,可以远程陪跑一次上线:频道、套餐、机顶盒、SIP 话机一起过。也可以先读 完整帮助文档。

预约陪跑