基于Docker部署M3U8流媒体-平芜编程栈

本方案基于Docker + Nginx-RTMP + Nginx，实现将本地 MP4 文件转换为 24/7 循环播放的 HLS (M3U8) 直播流。

一、环境准备

1、操作系统：

已安装宝塔面板的 Linux 服务器（推荐 CentOS 7+ 或 Ubuntu 20.04+）。

2、基础软件：

宝塔面板内已安装Nginx。
系统已安装Docker（可在宝塔“软件商店”一键安装）。
系统已安装FFmpeg（支持libx264的版本）

下载支持 libx264 的 FFmpeg：

https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-amd64-static.tar.xz

解压后，将 ffmpeg 和 ffprobe 复制到 /usr/bin 目录下。

二、启动 Docker 容器

在终端执行以下命令，启动 RTMP 转流服务器。需要将 Docker 内部的流文件目录映射到宝塔的站点目录下，方便直接访问。

注意：先创建/hls文件夹。

docker run -d --name nginx-rtmp \ -p 1935:1935 \ -p 8088:8080 \ -v /projects/nginx.conf:/etc/nginx/nginx.conf \ -v /projects/hls:/opt/data/hls \ alfg/nginx-rtmp

启动后会生成 /projects/nginx.conf

里面包含推流的链接示例：

rtmp://localhost:1935/stream/$name

查看 docker 输出：

docker logs --tail 200 nginx-rtmp

三、设置 hls 目录权限

用 ACL 的“默认权限（default ACL）”，让将来新生成的所有文件/目录自动拥有权限，后面nginx访问不会再报错403/Permission denied

# 安装 ACL yum -y install acl # 永久读写执行权限 setfacl -R -m u:www:rwx /projects/hls # 保证新文件也有权限 setfacl -R -d -m u:www:rwx /projects/hls # 验证 getfacl /projects/hls | sed -n '1,20p'

四、启动 FFmpeg 循环推流

使用 FFmpeg 对视频裁剪+转码：

ffmpeg -i video.mp4 -t 00:15:00 -c:v libx264 -c:a aac output.mp4

启动循环推流：

nohup ffmpeg -re -stream_loop -1 -i /projects/input.mp4 -c:v libx264 -preset veryfast -tune zerolatency -profile:v baseline -level 3.1 -g 60 -keyint_min 60 -sc_threshold 0 -c:a aac -b:a 128k -ar 44100 -f flv "rtmp://127.0.0.1:1935/stream/test" > /tmp/log1.txt 2>&1 &

性能优化建议：
如果服务器 CPU 较弱，且 MP4 已经是 H.264 编码，可以将 -c:v libx264 改为 -c:v copy，这样可以极大降低 CPU 占用。

查看 /projects/hls 目录，看是否有生成 M3U8 文件和 ts 文件。

五、宝塔 Nginx 配置（HTTP / HTTPS 播放）

在宝塔 → 网站 → 你的站点 → 配置文件中加入：

location ^~ /hls/ { alias /projects/hls/; types { application/vnd.apple.mpegurl m3u8; video/mp2t ts; } add_header Cache-Control no-cache; add_header Access-Control-Allow-Origin * always; if ($request_method = OPTIONS) { return 204; } disable_symlinks off; }

查看 nginx 错误输出：

tail -n 30 /www/wwwlogs/my.domain.com.error.log

六、播放与验证

直播流生成的地址如下，您可以使用 VLC 播放器或网页 HLS 播放器测试：

视频流：http://你的域名/hls/test_****/index.m3u8

在服务器上使用CURL指令测试视频流链接是否返回200

curl -I http://my.domain.com/hls/test_240p264kbs/index.m3u8

前端HTML嵌入视频流：

<video controls autoplay muted loop playsinline> <source src="http://my.domain.com/hls/test_720p2628kbs/index.m3u8" type="application/x-mpegURL"> 您的浏览器不支持 HLS 原生播放。 </video>