<
前言:TVBox 是一款非常流行的开源安卓视频播放器。它的核心功能非常简单:本身不提供任何视频内容,但可以通过加载外部配置源(“源”或“仓库”),来聚合和播放来自互联网的海量视频资源和电视直播。
我们可以把它理解为一个 “空壳”或“容器” ,它的播放内容完全取决于您给它提供的“源”。这正是它灵活和强大的地方,同时也带来了一定的使用门槛。
而自从小雅alist随着各大网盘的限速,TVbox貌似也慢慢不再被人提及,今天我来借教程教大家用一种新的方法让TVbox“复活”起来。
此次教程总共两个docker项目,一个KatelyaTV用来搜索网上的电影资源,一个iptv-api接口用来观看电视直播资源。
一、KatelyaTV 部署(docker)
1、新建一个文件夹,避免后期文件混乱
2、打开docker,然后转到compose,点击“新增项目”
3、填入项目名称,然后选择我们之前创建的文件作为路径
4、再选择创建docker-compose.yml
services: # 服务定义开始
katelyatv: #定义katelyatv媒体服务
image: ghcr.io/katelya77/katelyatv:latest # 指定镜像来源
container_name: katelyatv # 容器命名(便于管理)
restart: always # 重启策略(异常退出时自动重启)
ports: # 端口映射
- "6113:3000" # 宿主机6113端口→容器3000端口
environment: # 环境变量配置
- USERNAME=admin # 填入你需要设置的管理员用户名
- AUTH_PASSWORD=your_password # 填入你需要设置的管理员密码
- NEXT_PUBLIC_STORAGE_TYPE=kvrocks # 指定存储引擎为Kvrocks
- KVROCKS_URL=redis://kvrocks:6666 # 数据库连接地址(服务名+端口)
- TZ=Asia/Shanghai #时区设置(中国上海时区)
depends_on: # 服务依赖声明
- kvrocks # 依赖kvrocks服务(确保数据库先启动)
kvrocks: # 定义kvrocks数据库服务
image: apache/kvrocks:latest # 官方镜像(Apache维护)
container_name: kvrocks # 容器命名
restart: always # 重启策略
ports: # 端口映射(直接暴露默认端口)
- "6666:6666" # 宿主机6666端口→容器6666端口
volumes: # 数据卷配置
- ./kvrocks_data:/data # 宿主机目录→容器数据目录(持久化存储)
资源链接:点击下载
关键功能说明:
1、双服务架构设计(应用+数据库)
2、端口映射实现外部访问
3、环境变量驱动配置
4、据持久化方案
5、服务启动顺序控制
项目名来源:https://github.com/katelya77/KatelyaTV
有网络条件的别忘了给作者“Star”点亮一颗星星。
二、iptv-api部署 (docker)
1、新建一个文件夹,避免后期文件混乱
2、打开docker,然后转到compose,点击“新增项目”
3、填入项目名称,然后选择我们之前创建的文件作为路径
4、再选择创建docker-compose.yml
5、粘贴下面的docker compose代码进去
services: # 定义服务集合
iptv-api: # 定义名为iptv-api的服务
image: guovern/iptv-api:latest # 使用Docker镜像(guovern维护的最新版)
container_name: iptv-api # 容器实例名称
restart: unless-stopped # 重启策略(手动停止除外)
ports: # 端口映射配置
- "6114:8000" # 宿主机6114端口映射到容器8000端口
volumes: # 数据卷挂载配置
- ./config:/iptv-api/config # 挂载本地config目录到容器配置目录
- ./output:/iptv-api/output # 挂载本地output目录到容器输出目录
environment: # 环境变量配置
- APP_HOST=http://0.0.0.0 # 应用监听地址(允许所有网络接口)
- APP_PORT=8000 # 应用监听端口(需与内部端口一致)
- TZ=Asia/Shanghai #时区设置(中国上海时区)
- UPDATE_CRON=0 0 */4 * * # 定时任务配置(每4小时执行更新,可根据自己情况修改)6、部署完成可访问http://IP:端口.txt 地址进行查看直播源更新情况(时间较长),请耐心等待更新完成,出现直播源地址后再进行下一步操作。
7、TVbox直播源地址格式:http://IP:端口/m3u 进行直播
项目名来源:https://github.com/Guovin/iptv-api
有网络条件的别忘了给作者“Star”点亮一颗星星。



好评,第一个没问题好用,就是配置iptv时构建到最后显示 Get “https://registry-1.docker.io/v2/”: context deadline exceeded 是什么问题呢?请问。
国内网络访问限制
原因:Docker 官方仓库在国内访问速度较慢,容易超时。
解决办法:配置国内 Docker 镜像加速器(如阿里云、网易云等):
编辑 Docker 配置文件(不同系统路径不同):
Linux:/etc/docker/daemon.json
Windows/Mac:通过 Docker Desktop 图形界面进入 Settings → Docker Engine
阿强,你好,按照你的方法设置了TVBOX,出现直播地址解析失败,不知道是什么原因?