前言群晖 NAS 已经装了 Docker想再增加一个 IPTV Web 服务最关键的不是先寻找所谓“永久免费、绝不卡顿”的频道而是把部署环境、数据目录、直播源和外网访问分别配置清楚。否则容器虽然启动了频道列表可能还是空的即使局域网能打开页面出门后也未必能正常播放等到开始录制节目才发现录制文件没有持久化保存也容易造成损失。ViniPlay 提供了一条相对清晰的自托管路线用容器运行服务浏览器里管理 M3U 与 EPG按需选择 FFmpeg 播放处理并通过 Multi-View 同时查看多个频道。这里 M3U 是频道与播放地址列表EPG 是节目时间表ViniPlay 不负责生成合法频道资源也不能保证第三方流始终稳定。NAS 的 CPU、网络上行、流格式和源站响应都会影响最终体验。这篇教程以群晖为宿主机完整演示 SSH 操作、Docker 单命令部署、8998 端口访问、初始化管理员、导入播放源和设置播放模式。后半部分使用 cpolar 为服务创建公网入口并介绍固定二级子域名。与只展示一张成功登录截图不同本文还会交代SESSION_SECRET不能沿用示例字符串、/data与 DVR 录制目录需要分别考虑以及公网地址与实际直播能力的区别方便读者按自己的设备条件复现。1. ViniPlay 是什么我想要的是把已有的合法直播源整理到同一处而不是每次观看都先去找播放地址。ViniPlay 正是这样的自托管 IPTV 播放平台群晖负责运行服务用户通过浏览器登录导入自己的频道列表和节目单然后在一个页面里选择频道、查看节目安排或切换多画面。它提供的主要能力包括M3U 与 EPG 管理M3U 提供频道及播放地址EPG 提供节目名称、播出时间等导视信息。两者职责不同只有频道列表不等于一定有完整节目单。多画面Multi-View把多个频道放进同一个视图适合同时关注几场赛事或不同资讯频道实际并发数量取决于网络、源站和设备性能。DVR 录制可通过 FFmpeg 保存节目流也支持在节目导视中安排录制需要预留存储空间并确认录制目录已妥善持久化。投屏与流处理支持 Chromecast、流代理和 FFmpeg 处理投屏连接是否稳定以及能否硬件转码都取决于设备、源流和相关配置。账户管理初次安装创建管理员后续可以在后台管理普通用户。这些是播放器提供的功能并不意味着软件内置或授权了电视直播内容。这里用到的直播源仅供讲解导入方式使用前应自行确认可用性和授权情况。项目说明可参考ViniPlay 官方仓库。2. 在群晖 NAS 上部署 ViniPlay这部分沿用原文的 Docker 单容器方案。开始之前确认群晖已安装并启动 DockerContainer ManagerNAS 有足够的可用空间电脑可以通过 SSH 连接群晖。不同 DSM 版本的界面名称可能略有差异。2.1 检查 Docker 与 SSH先在群晖中查看 Docker 应用是否已经安装后面要通过它运行 ViniPlay 容器。然后开启 SSH用终端连接 NAS。SSH 账号和地址以你自己的群晖设置为准不必照搬其他设备的用户名和 IP。2.2 创建持久化目录连接成功后建立 ViniPlay 的项目文件夹和数据目录mkdir-p/volume1/docker/viniplay/data再切换到项目目录方便后续用当前目录作为宿主机挂载路径cd/volume1/docker/viniplay这里的/volume1/docker/viniplay/data是群晖上的目录容器内的对应位置是/data。今后备份或迁移配置应关注这份宿主机数据而不只是容器本身。2.3 创建并启动容器原文使用以下 Docker 命令保留原始参数供大家对照dockerrun-d--restartunless-stopped--nameviniplay-p8998:8998-v$(pwd)/data:/data-eSESSION_SECRETreplace_this_with_a_very_long_random_and_secret_string ardovini/viniplay:latest执行前请先替换SESSION_SECRET的示例值。它用于保护登录会话不应把replace_this_with_a_very_long_random_and_secret_string原封不动用于实际环境。可以用密码生成器或openssl rand -hex 32生成随机值不要把真实值贴进文章或截图。这条命令将群晖的 8998 端口映射到容器的 8998 端口并把当前目录的data挂载至容器/data。如果宿主机 8998 已被占用需要调整映射左侧的端口后续访问地址和 cpolar 本地地址也随之修改。浏览器输入http://你的群晖IP:8998出现初始化页面后创建管理员账号再使用该账号登录。关于录制文件原文命令只挂载/data。ViniPlay 官方 Compose 示例还将宿主机录制目录映射至容器/dvr。如果准备长期使用 DVR应单独确认录制文件保存位置与持久化设置避免重建容器时丢失未妥善保存的录制内容。3. 配置频道源与日常播放3.1 导入 M3U 和 EPG打开右上角Settings找到数据源相关设置。首先需要准备有权使用的 M3U 频道列表如果希望看到节目导视再添加与频道匹配的 EPG 数据。原文列出了以下公开链接示例。它们属于第三方资源内容、频道数量、可用状态可能变化不能把列表收录数量理解为实际可播放频道数量也不要默认所有资源都具有相同的使用权限。# 央视频道 https://live.fanmingming.com/tv/m3u/vip.m3u # 地方台合集 https://live.fanmingming.com/tv/m3u/index.m3u # GitHub 热门源 https://raw.githubusercontent.com/Frankbii/Chinese-TV-List/master/tv.m3u # IPTV 全球 https://iptv-org.github.io/iptv/index.m3u添加时点击Add M3U Source为数据源命名粘贴相应链接按需要设置刷新间隔然后保存。EPG 需要另行提供对应数据源原文这四条示例链接不能直接代替节目单配置。首次导入后可按当前版本界面提示进行源数据处理或刷新再检查频道列表和节目单是否正常显示。如果频道空白先看地址是否有效、源站是否可达以及相关频道是否有可访问的流而不是反复重装容器。3.2 选择播放方式进入Settings查看Active User Agent和Active Stream Profile。本例中Active User Agent保持ViniPlay Default然后按原文将Active Stream Profile调整为ffmpeg (Built in)。FFmpeg 在服务端代理或处理直播流可帮助应对部分浏览器直接播放时遇到的格式兼容与跨域问题但它不是通用的“防卡顿开关”。如果启用了转码CPUGPU 负载及 NAS 散热都要纳入考虑某些源站问题也无法靠切换播放配置修复。实际使用时可以按源流状况比较不同配置。3.3 多画面与录制回到 TV 页面选择一个频道。这里可以先验证单频道能否正常播放再考虑同时打开多个频道避免一次加入过多来源而难以定位问题。切换到Multi-View后可以在同一界面观察多个频道并调整布局。赛事多路观看、新闻信息对照等场景会比较实用。如需录制先确认节目源允许录制再在对应频道或节目安排中使用 DVR 功能。录制质量取决于原始信号、流处理配置以及 NAS 的磁盘与计算资源。能进入播放界面不等于每一路直播都能稳定播放或录制。4. 给群晖安装 cpolar本地播放确认无误后再考虑远程访问。因为 ViniPlay 当前运行在群晖局域网内外出时不能直接使用私网 IP。cpolar 可以把指定的本地 Web 端口映射成公网入口但它负责的是网络连接不负责提供 IPTV 内容也不会自动改善直播源质量。原文采用的是群晖套件安装方式下面沿用这一流程。4.1 下载并安装群晖套件先到 cpolar 的群晖套件下载页面选择与你的 DSM 版本和 CPU 架构相匹配的安装包。不要仅因型号名称相近就安装不兼容的套件。打开群晖套件中心在右上角选择“手动安装”。选中下载好的套件文件点击下一步。阅读安装提示并确认后继续。最后点击完成结束套件安装。安装完成后在局域网内通过http://群晖IP:9200访问 cpolar Web 管理界面使用自己的 cpolar 账号登录。确认管理页面可用再进行隧道配置。9200 是 cpolar 的管理端口8998 是本篇 ViniPlay 的服务端口二者不能混填。5. 为 ViniPlay 配置公网访问5.1 创建用于访问 ViniPlay 的隧道登录 cpolar Web UI进入“隧道管理 → 创建隧道”。本篇配置项如下隧道名称自定义一个不与现有隧道重复的名称例如viniplay。协议选择http。本地地址填写8998对应此前 Docker 暴露的宿主机端口。域名类型临时体验可以选择随机域名需要长期保存访问入口时再根据账户套餐选择二级子域名。地区按原文示例选择China Top。本地地址填写的是 ViniPlay 监听端口而不是 cpolar 的 9200 管理端口。创建前应先在局域网打开 ViniPlay确认服务正常。5.2 保留并绑定固定二级子域名如果希望将网址保存为浏览器书签避免随机域名变化后重新寻找入口可以先登录 cpolar 官网控制台在“预留 → 保留二级子域名”中选择地区并填写自定义名称。固定域名功能以实际套餐和控制台规则为准。保留成功后复制自己申请到的子域名再回到隧道配置中把域名类型改为二级子域名并填入对应的Sub Domain。保存后打开“状态 → 在线隧道列表”确认新地址已经出现。优先复制 HTTPS 公网地址进行测试换用手机蜂窝网络或另一处网络打开检查登录页和频道列表能否访问。页面能打开之后再测试具体频道外网播放对上行带宽、源站响应和可能发生的流转码更加敏感。固定域名解决的是访问地址的可记忆性并不保证 NAS 关机、容器停止或网络中断后服务仍然在线。6. 长期使用前再检查这些细节账号与会话使用足够强的管理员密码妥善设置SESSION_SECRET。不准备开放给其他人时可按需要为公网入口增加访问认证避免只依赖一个公开网址。存储与备份/data用于应用持久化信息如启用 DVR应同时检查/dvr的实际映射和录制文件备份方案。镜像使用latest时更新前先做好数据备份避免版本变化带来意外。频道与节目单M3U 决定频道入口EPG 决定导视内容播放是否成功还与上游流有关。若某一频道突然失效应先核对原始源地址和网络条件。性能与外网播放多画面会增加同时播放的数据量。FFmpeg 处理、录制和并发播放都可能给 NAS 增加负载cpolar 提供公网连接不等于替直播流扩充带宽。使用范围只导入有权使用的直播源并遵守内容及录制授权要求。ViniPlay 仓库采用 CC BY-NC-SA 4.0 许可涉及商业使用、修改或再分发时需单独阅读项目许可证。总结本篇完成了群晖 NAS 上 ViniPlay 的 Docker 部署以及从 M3U/EPG 导入、FFmpeg 播放配置、多画面使用到 cpolar 公网隧道与固定二级子域名的配置链路。实际复现时建议按“容器运行 → 局域网登录 → 数据源导入 → 单频道播放 → 多画面测试 → 外网验证”的顺序逐步检查遇到问题更容易确定是哪一层出了故障。还有三个长期使用的关键点替换SESSION_SECRET示例值分别考虑/data与 DVR 录制文件的持久化为公网访问设置适当的认证与权限。播放器、频道源和穿透服务各自解决不同问题不能互相替代。
前言群晖 NAS 已经装了 Docker想再增加一个 IPTV Web 服务最关键的不是先寻找所谓“永久免费、绝不卡顿”的频道而是把部署环境、数据目录、直播源和外网访问分别配置清楚。否则容器虽然启动了频道列表可能还是空的即使局域网能打开页面出门后也未必能正常播放等到开始录制节目才发现录制文件没有持久化保存也容易造成损失。ViniPlay 提供了一条相对清晰的自托管路线用容器运行服务浏览器里管理 M3U 与 EPG按需选择 FFmpeg 播放处理并通过 Multi-View 同时查看多个频道。这里 M3U 是频道与播放地址列表EPG 是节目时间表ViniPlay 不负责生成合法频道资源也不能保证第三方流始终稳定。NAS 的 CPU、网络上行、流格式和源站响应都会影响最终体验。这篇教程以群晖为宿主机完整演示 SSH 操作、Docker 单命令部署、8998 端口访问、初始化管理员、导入播放源和设置播放模式。后半部分使用 cpolar 为服务创建公网入口并介绍固定二级子域名。与只展示一张成功登录截图不同本文还会交代SESSION_SECRET不能沿用示例字符串、/data与 DVR 录制目录需要分别考虑以及公网地址与实际直播能力的区别方便读者按自己的设备条件复现。1. ViniPlay 是什么我想要的是把已有的合法直播源整理到同一处而不是每次观看都先去找播放地址。ViniPlay 正是这样的自托管 IPTV 播放平台群晖负责运行服务用户通过浏览器登录导入自己的频道列表和节目单然后在一个页面里选择频道、查看节目安排或切换多画面。它提供的主要能力包括M3U 与 EPG 管理M3U 提供频道及播放地址EPG 提供节目名称、播出时间等导视信息。两者职责不同只有频道列表不等于一定有完整节目单。多画面Multi-View把多个频道放进同一个视图适合同时关注几场赛事或不同资讯频道实际并发数量取决于网络、源站和设备性能。DVR 录制可通过 FFmpeg 保存节目流也支持在节目导视中安排录制需要预留存储空间并确认录制目录已妥善持久化。投屏与流处理支持 Chromecast、流代理和 FFmpeg 处理投屏连接是否稳定以及能否硬件转码都取决于设备、源流和相关配置。账户管理初次安装创建管理员后续可以在后台管理普通用户。这些是播放器提供的功能并不意味着软件内置或授权了电视直播内容。这里用到的直播源仅供讲解导入方式使用前应自行确认可用性和授权情况。项目说明可参考ViniPlay 官方仓库。2. 在群晖 NAS 上部署 ViniPlay这部分沿用原文的 Docker 单容器方案。开始之前确认群晖已安装并启动 DockerContainer ManagerNAS 有足够的可用空间电脑可以通过 SSH 连接群晖。不同 DSM 版本的界面名称可能略有差异。2.1 检查 Docker 与 SSH先在群晖中查看 Docker 应用是否已经安装后面要通过它运行 ViniPlay 容器。然后开启 SSH用终端连接 NAS。SSH 账号和地址以你自己的群晖设置为准不必照搬其他设备的用户名和 IP。2.2 创建持久化目录连接成功后建立 ViniPlay 的项目文件夹和数据目录mkdir-p/volume1/docker/viniplay/data再切换到项目目录方便后续用当前目录作为宿主机挂载路径cd/volume1/docker/viniplay这里的/volume1/docker/viniplay/data是群晖上的目录容器内的对应位置是/data。今后备份或迁移配置应关注这份宿主机数据而不只是容器本身。2.3 创建并启动容器原文使用以下 Docker 命令保留原始参数供大家对照dockerrun-d--restartunless-stopped--nameviniplay-p8998:8998-v$(pwd)/data:/data-eSESSION_SECRETreplace_this_with_a_very_long_random_and_secret_string ardovini/viniplay:latest执行前请先替换SESSION_SECRET的示例值。它用于保护登录会话不应把replace_this_with_a_very_long_random_and_secret_string原封不动用于实际环境。可以用密码生成器或openssl rand -hex 32生成随机值不要把真实值贴进文章或截图。这条命令将群晖的 8998 端口映射到容器的 8998 端口并把当前目录的data挂载至容器/data。如果宿主机 8998 已被占用需要调整映射左侧的端口后续访问地址和 cpolar 本地地址也随之修改。浏览器输入http://你的群晖IP:8998出现初始化页面后创建管理员账号再使用该账号登录。关于录制文件原文命令只挂载/data。ViniPlay 官方 Compose 示例还将宿主机录制目录映射至容器/dvr。如果准备长期使用 DVR应单独确认录制文件保存位置与持久化设置避免重建容器时丢失未妥善保存的录制内容。3. 配置频道源与日常播放3.1 导入 M3U 和 EPG打开右上角Settings找到数据源相关设置。首先需要准备有权使用的 M3U 频道列表如果希望看到节目导视再添加与频道匹配的 EPG 数据。原文列出了以下公开链接示例。它们属于第三方资源内容、频道数量、可用状态可能变化不能把列表收录数量理解为实际可播放频道数量也不要默认所有资源都具有相同的使用权限。# 央视频道 https://live.fanmingming.com/tv/m3u/vip.m3u # 地方台合集 https://live.fanmingming.com/tv/m3u/index.m3u # GitHub 热门源 https://raw.githubusercontent.com/Frankbii/Chinese-TV-List/master/tv.m3u # IPTV 全球 https://iptv-org.github.io/iptv/index.m3u添加时点击Add M3U Source为数据源命名粘贴相应链接按需要设置刷新间隔然后保存。EPG 需要另行提供对应数据源原文这四条示例链接不能直接代替节目单配置。首次导入后可按当前版本界面提示进行源数据处理或刷新再检查频道列表和节目单是否正常显示。如果频道空白先看地址是否有效、源站是否可达以及相关频道是否有可访问的流而不是反复重装容器。3.2 选择播放方式进入Settings查看Active User Agent和Active Stream Profile。本例中Active User Agent保持ViniPlay Default然后按原文将Active Stream Profile调整为ffmpeg (Built in)。FFmpeg 在服务端代理或处理直播流可帮助应对部分浏览器直接播放时遇到的格式兼容与跨域问题但它不是通用的“防卡顿开关”。如果启用了转码CPUGPU 负载及 NAS 散热都要纳入考虑某些源站问题也无法靠切换播放配置修复。实际使用时可以按源流状况比较不同配置。3.3 多画面与录制回到 TV 页面选择一个频道。这里可以先验证单频道能否正常播放再考虑同时打开多个频道避免一次加入过多来源而难以定位问题。切换到Multi-View后可以在同一界面观察多个频道并调整布局。赛事多路观看、新闻信息对照等场景会比较实用。如需录制先确认节目源允许录制再在对应频道或节目安排中使用 DVR 功能。录制质量取决于原始信号、流处理配置以及 NAS 的磁盘与计算资源。能进入播放界面不等于每一路直播都能稳定播放或录制。4. 给群晖安装 cpolar本地播放确认无误后再考虑远程访问。因为 ViniPlay 当前运行在群晖局域网内外出时不能直接使用私网 IP。cpolar 可以把指定的本地 Web 端口映射成公网入口但它负责的是网络连接不负责提供 IPTV 内容也不会自动改善直播源质量。原文采用的是群晖套件安装方式下面沿用这一流程。4.1 下载并安装群晖套件先到 cpolar 的群晖套件下载页面选择与你的 DSM 版本和 CPU 架构相匹配的安装包。不要仅因型号名称相近就安装不兼容的套件。打开群晖套件中心在右上角选择“手动安装”。选中下载好的套件文件点击下一步。阅读安装提示并确认后继续。最后点击完成结束套件安装。安装完成后在局域网内通过http://群晖IP:9200访问 cpolar Web 管理界面使用自己的 cpolar 账号登录。确认管理页面可用再进行隧道配置。9200 是 cpolar 的管理端口8998 是本篇 ViniPlay 的服务端口二者不能混填。5. 为 ViniPlay 配置公网访问5.1 创建用于访问 ViniPlay 的隧道登录 cpolar Web UI进入“隧道管理 → 创建隧道”。本篇配置项如下隧道名称自定义一个不与现有隧道重复的名称例如viniplay。协议选择http。本地地址填写8998对应此前 Docker 暴露的宿主机端口。域名类型临时体验可以选择随机域名需要长期保存访问入口时再根据账户套餐选择二级子域名。地区按原文示例选择China Top。本地地址填写的是 ViniPlay 监听端口而不是 cpolar 的 9200 管理端口。创建前应先在局域网打开 ViniPlay确认服务正常。5.2 保留并绑定固定二级子域名如果希望将网址保存为浏览器书签避免随机域名变化后重新寻找入口可以先登录 cpolar 官网控制台在“预留 → 保留二级子域名”中选择地区并填写自定义名称。固定域名功能以实际套餐和控制台规则为准。保留成功后复制自己申请到的子域名再回到隧道配置中把域名类型改为二级子域名并填入对应的Sub Domain。保存后打开“状态 → 在线隧道列表”确认新地址已经出现。优先复制 HTTPS 公网地址进行测试换用手机蜂窝网络或另一处网络打开检查登录页和频道列表能否访问。页面能打开之后再测试具体频道外网播放对上行带宽、源站响应和可能发生的流转码更加敏感。固定域名解决的是访问地址的可记忆性并不保证 NAS 关机、容器停止或网络中断后服务仍然在线。6. 长期使用前再检查这些细节账号与会话使用足够强的管理员密码妥善设置SESSION_SECRET。不准备开放给其他人时可按需要为公网入口增加访问认证避免只依赖一个公开网址。存储与备份/data用于应用持久化信息如启用 DVR应同时检查/dvr的实际映射和录制文件备份方案。镜像使用latest时更新前先做好数据备份避免版本变化带来意外。频道与节目单M3U 决定频道入口EPG 决定导视内容播放是否成功还与上游流有关。若某一频道突然失效应先核对原始源地址和网络条件。性能与外网播放多画面会增加同时播放的数据量。FFmpeg 处理、录制和并发播放都可能给 NAS 增加负载cpolar 提供公网连接不等于替直播流扩充带宽。使用范围只导入有权使用的直播源并遵守内容及录制授权要求。ViniPlay 仓库采用 CC BY-NC-SA 4.0 许可涉及商业使用、修改或再分发时需单独阅读项目许可证。总结本篇完成了群晖 NAS 上 ViniPlay 的 Docker 部署以及从 M3U/EPG 导入、FFmpeg 播放配置、多画面使用到 cpolar 公网隧道与固定二级子域名的配置链路。实际复现时建议按“容器运行 → 局域网登录 → 数据源导入 → 单频道播放 → 多画面测试 → 外网验证”的顺序逐步检查遇到问题更容易确定是哪一层出了故障。还有三个长期使用的关键点替换SESSION_SECRET示例值分别考虑/data与 DVR 录制文件的持久化为公网访问设置适当的认证与权限。播放器、频道源和穿透服务各自解决不同问题不能互相替代。
