IPTV播放器与转码解决方案neTV-平芜编程栈

简介

什么是 neTV ？

neTV是一个极简的、自托管的IPTV流媒体网络界面。它被设计为功能齐全的媒体中心（如Jellyfin或Emby）的轻量级替代品，让你可以在浏览器中轻松观看IPTV直播、电影和剧集，并在服务器上进行转码，以优化观看体验。

主要特点

直播电视：支持EPG网格指南。
电影和剧集：自动获取元数据。
Chromecast 支持：轻松投射到大屏幕。
字幕支持：支持常见的字幕格式。
搜索功能：快速找到你想看的内容。
收藏夹与继续播放：方便地管理你的喜爱内容并从上次停止的地方继续观看。
响应式设计：在桌面和移动设备上都有良好的体验，并支持键盘导航。
优化的转码：根据需要对视频流进行转码，以获得最佳的播放效果。

应用场景

个人 IPTV 播放器：在任何支持现代浏览器的设备上观看你的IPTV订阅。
家庭媒体中心：为你的家庭成员提供一个简单易用的界面来访问直播电视和媒体库。
轻量级 Jellyfin/Emby 替代品：如果你只需要基本的媒体浏览和播放功能，neTV是一个不错的选择。

neTV是一个专为IPTV设计的高效播放器，适合希望从多个源获取简单IPTV美好体验的用户。其轻量级的设计和强大的功能，使其成为自托管IPTV服务的理想选择。

安装

在群晖上以 Docker 方式安装。

官方提供了2个版本的镜像

区别在于netv-ffmpeg:latest中提供了一些额外的编解码器支持，适用于高效转码和低延迟流媒体

而netv:latest则使用Ubuntu官方仓库中的包，功能较为基础

选择哪一个版本取决于你的需求：如果只需要基本的IPTV播放，可以选择netv:latest；如果需要视频转码等高级功能，则应选择netv-ffmpeg:latest

如果你熟悉命令行，可能用docker cli或docker-compose更快捷

docker cli

使用docker cli命令安装：

# 新建文件夹 netv 和 子目录mkdir-p /volume1/docker/netv/cache# 进入 netv 目录cd/volume1/docker/netv# 运行容器（如果群晖主机没有 GPU 支持）dockerrun -d\--restart unless-stopped\--name netv\-p8724:8000\-v$(pwd)/cache:/app/cache\-v /etc/localtime:/etc/localtime:ro\ghcr.io/jvdillon/netv:latest# 运行容器（如果群晖主机有 GPU 支持）dockerrun -d\--restart unless-stopped\--name netv\--device /dev/dri:/dev/dri\-p8724:8000\-v$(pwd)/cache:/app/cache\-v /etc/localtime:/etc/localtime:ro\ghcr.io/jvdillon/netv:latest

docker-compose 安装

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

services:netv:image:ghcr.io/jvdillon/netv:latestcontainer_name:netvrestart:unless-stoppedports:-"8724:8000"volumes:-./cache:/app/cache-/etc/localtime:/etc/localtime:rodevices:-/dev/dri:/dev/dri# for hardware transcoding (remove if no GPU)

如果你的主机不支持GPU，切记删除devices部分，否则会报错；

然后通过SSH登录到您的群晖，执行下面的命令：

# 新建文件夹 netv 和 子目录mkdir-p /volume1/docker/netv/cache# 进入 netv 目录cd/volume1/docker/netv# 将 docker-compose.yml 放入当前目录# 一键启动docker-composeup -d

运行

在浏览器中输入http://群晖IP:8724，第一次需要注册管理员账号

还需要登录

登录成功后，就能看到neTV的界面

M3U

进入设置，拉到最底部

Add Source增加m3u

可以看看 iptv-org/iptv——这是一个由社区维护的全球公开IPTV频道合集，但是能播的不多，而且都是些地方台

Name：播放列表的名称
Type：播放列表的类型，这里是M3U Playlist
URL：播放列表的地址

EPG

只是演示，未必能用

Add Source增加epg

Name：列表的名称
Type：列表的类型，这里是EPG Only
URL：列表的地址

播放

回到顶部的Live TV Filter，点Allow All

回到首界面可以看到播放列表

进入频道就可以观看了

打不开的会显示错误

其他

至于视频（movies）和剧集（series），neTV本身不支持直接添加本地视频文件、文件夹或本地剧集库（如挂载硬盘目录、扫描本地MKV/MP4文件）。所有视频和剧集内容都必须来自外部IPTV源

所以如果你想要播放本地视频文件或自建剧集库，neTV并不支持。你可以考虑其他自托管方案，如Jellyfin、Plex、Emby等，这些专门支持本地媒体扫描和剧集管理

参考文档

jvdillon/netv: IPTV in your Browser & Transcoding on your Server
地址：https://github.com/jvdillon/netv

iptv-org/iptv：全球公开可用的 IPTV 频道合集 — iptv-org/iptv: Collection of publicly available IPTV channels from all over the world
地址：https://github.com/iptv-org/iptv