什么是 Guovin/TV ?

Guovin/TV 支持自定义频道菜单，并根据模板频道，自动获取并更新最新的直播源接口，测速校验后生成可用的接口文件。

软件特点：

✅ 自定义模板，生成您想要的频道

✅ 支持多种获取源方式：组播源、酒店源、订阅源、关键字搜索

✅ 接口测速验效，响应时间、分辨率优先级，过滤无效接口

✅ 偏好设置：IPv6、接口来源排序优先级与数量配置、接口白名单

✅ 定时执行，北京时间每日 6:00 与 18:00 执行更新

✅ 支持多种运行方式：工作流、命令行、GUI 软件、Docker(amd64/arm64)

✨ 更多功能请见 配置参数 部分

软件支持多种部署方式，包括支持 exe 文件、Github Actions 和 docker 方式，如果你选择非 docker 方式，建议参考官方代码库中的说明

安装在群晖上以 Docker 方式安装。

镜像有两个版本：

requests：轻量级，性能要求低，更新速度快，稳定性不确定（推荐订阅源使用此版本）

driver：性能要求较高，更新速度较慢，稳定性、成功率高；修改配置 open_driver = False 可切换到 request 版本（推荐酒店源、组播源、关键字搜索使用此版本）

在注册表中搜索 guovern ，根据需要选择版本，老苏选的是 tv-driver，版本选择 latest。

本文写作时， latest 版本对应为 v1.3.4；

容器名称如果你不打算手动执行，名称可以随意，否则建议叫 tvlist

这样你执行手动运行命令时，可以不用做任何修改

卷在 docker 文件夹中，创建一个新文件夹 tvlist，并在其中建一个子文件夹 config 和 output

文件夹

装载路径

说明

docker/tvlist/config

/tv-driver/config

设置文件

docker/tvlist/output

/tv-driver/output

检测后的输出文件

注意：选择不同的容器，装载路径 是不一样的

端口本地端口不冲突就行，不确定的话可以用命令查一下

12# 查看端口占用netstat -tunlp | grep 端口号

本地端口

容器端口

3078

8000

命令行安装如果你熟悉命令行，可能用 docker cli 更快捷

1234567891011121314# 新建文件夹 tvlist 和 子目录mkdir -p /volume1/docker/tvlist/{config,output}# 进入 tvlist 目录cd /volume1/docker/tvlist# 运行容器docker run -d \ --restart unless-stopped \ --name tvlist \ -p 3078:8000 \ -v $(pwd)/config:/tv-driver/config \ -v $(pwd)/output:/tv-driver/output \ guovern/tv-driver

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

123456789101112version: '3'services: tvlist: image: guovern/tv-driver container_name: tvlist restart: unless-stopped ports: - "3078:8000" volumes: - ./config:/tv-driver/config - ./output:/tv-driver/output

然后执行下面的命令

12345678910# 新建文件夹 tvlist 和 子目录mkdir -p /volume1/docker/tvlist/{config,output}# 进入 tvlist 目录cd /volume1/docker/tvlist# 将 docker-compose.yml 放入当前目录# 一键启动docker-compose up -d

运行在浏览器中输入 http://群晖IP:3078 有可能啥也没有

别慌，先看看日志，可能还在下载中，也可能还在处理数据

运行期间，可能 CPU 会比较高

时间不好估计，总之，需要等日志中显示处理完成才行

这个镜像没有界面，上面的日志提示了使用方法，在浏览器中输入不同的 URL 会有不同的结果：

http://群晖IP:3078，会下载 result.m3u 文件，可以直接用来进一步处理或者导入直播软件

http://群晖IP:3078/result，可以直接查看内容，适用于可订阅的播放器

http://群晖IP:3078/log，可以看到详细的日志

上面的文件，都可以在 output 目录中找到

进阶配置参数找到 config 目录中的 config.ini 文件

其中 subscribe_urls 为订阅源，你可以在字段后面输入自己收集的订阅链接（支持 txt 与 m3u 链接），多个链接以逗号分隔，保存即可

其他参数可以根据需要进行修改，具体每个参数的说明，请参考官方的文档：https://github.com/Guovin/TV/blob/master/docs/config.md

手动运行默认情况下，容器是定时运行的

但我们也可以在更新了 subscribe_urls 后，手动运行

12# 手动运行docker exec -it --user root tvlist pipenv run python main.py scheduled_task

运行结束

参考文档

Guovin/TV: 📺IPTV电视直播源更新工具🚀：包含💰央视(付费)、📡卫视、🏠广东、🌊港·澳·台、🎬电影、🎥咪咕、🏀体育、🪁动画、🎮游戏、🎵音乐、🏛经典剧场；支持自定义增加频道；支持组播源、酒店源、订阅源、关键字搜索；每天自动更新两次，结果可用于TVBox等播放软件；支持工作流、Docker(amd64/arm64)、命令行、GUI运行方式 | IPTV live TV source update tool地址：https://github.com/Guovin/TV