保姆级教程：用Docker Compose一键部署ZLMediaKit流媒体服务器（含OBS推流配置）

从零搭建私有流媒体平台Docker Compose ZLMediaKit OBS全流程指南流媒体技术正在重塑内容传播的方式。无论是企业内部培训、游戏直播还是产品演示一个稳定高效的私有流媒体平台都能显著提升沟通效率。本文将手把手教你如何用Docker Compose快速部署ZLMediaKit流媒体服务器并配置OBS Studio实现专业级推流。1. 环境准备与基础概念在开始部署前我们需要明确几个核心组件的作用。ZLMediaKit作为流媒体服务器负责接收、处理和分发视频流OBS Studio则是功能强大的推流客户端Docker Compose帮助我们以声明式的方式管理整个服务栈。硬件建议配置CPU至少4核推荐8核以上用于高清流处理内存4GB以上8GB更佳带宽上行带宽至少是推流码率的1.5倍存储SSD硬盘预留至少20GB空间用于录制文件提示测试环境可使用本地机器生产环境建议选择云服务器并确保有公网IP先确保系统已安装必要工具# 检查Docker版本需18.06 docker --version # 检查Docker Compose版本需1.25 docker-compose --version如果尚未安装可通过以下命令快速安装# Ubuntu/Debian系统 sudo apt-get update sudo apt-get install -y docker.io docker-compose2. Docker Compose部署ZLMediaKit创建项目目录并编写docker-compose.yml文件version: 3.8 services: zlmediakit: image: zlmediakit/zlmediakit:master container_name: zlmediakit restart: unless-stopped ports: - 1935:1935 # RTMP协议端口 - 8080:80 # HTTP-FLV/HLS访问端口 - 554:554 # RTSP协议端口 - 10000:10000 # RTP代理端口 - 30000-30500:30000-30500 # RTP端口范围 volumes: - ./conf:/opt/media/conf - ./www:/opt/media/www - ./logs:/opt/media/logs environment: TZ: Asia/Shanghai privileged: true networks: - media_network networks: media_network: driver: bridge关键参数解析参数作用推荐值ports端口映射保持默认即可volumes配置/日志持久化建议挂载到宿主机privileged获取宿主机权限必须为truerestart自动重启策略unless-stopped启动服务# 创建所需目录 mkdir -p {conf,www,logs} # 启动服务前台运行观察日志 docker-compose up # 或后台运行 docker-compose up -d验证服务是否正常运行curl http://localhost:80803. 配置OBS推流OBS Studio的安装相对简单官网提供各平台安装包。安装完成后需要进行关键配置场景与源设置创建新场景如直播主场景添加视频捕获源显示器/摄像头添加音频输入源麦克风/系统声音推流参数配置进入设置 → 推流服务类型选择自定义服务器地址填写rtmp://你的服务器IP:1935/live流密钥可自定义如test视频编码建议- 分辨率1920x1080 或 1280x720 - 帧率30fps - 码率控制CBR - 比特率4000-6000kbps1080p - 关键帧间隔2秒 - 预设quality - 配置high音频编码建议采样率44.1kHz比特率160kbps格式AAC注意首次推流前建议进行带宽测试确保上行带宽足够4. 流媒体访问与监控成功推流后可通过多种协议访问流媒体拉流地址格式RTMP:rtmp://服务器IP:1935/live/流密钥HTTP-FLV:http://服务器IP:8080/live/流密钥.flvHLS:http://服务器IP:8080/live/流密钥/hls.m3u8RTSP:rtsp://服务器IP:554/live/流密钥常用监控接口# 获取服务器状态 curl http://localhost:8080/api/stat # 获取活跃流列表 curl http://localhost:8080/api/stream/list典型问题排查流程OBS显示推流成功但无法播放检查防火墙是否开放相关端口验证ZLMediaKit容器日志是否有错误docker logs zlmediakit播放卡顿或延迟高降低推流码率调整OBS编码预设为faster检查服务器CPU/内存使用情况音频视频不同步在OBS中检查音视频时间戳设置确保帧率与关键帧间隔配置合理5. 高级配置与优化对于生产环境建议进行以下优化config.ini关键配置[general] enableVhost1 ; 启用虚拟主机 flowThreshold10240 ; 流量阈值(KB) [protocol] enable_rtmp1 enable_rtsp1 enable_hls1 enable_http1 [hook] enable1 ; 启用事件通知 on_publishhttp://callback.example.com/publish on_playhttp://callback.example.com/play性能调优参数# 在docker-compose.yml中添加资源限制 deploy: resources: limits: cpus: 4 memory: 8G reservations: cpus: 1 memory: 2G录制功能配置创建录制目录并设置权限mkdir -p recordings chmod 777 recordings在docker-compose.yml中添加卷映射volumes: - ./recordings:/opt/media/record通过API触发录制curl http://localhost:8080/index/api/startRecord? \ secretyour_secretapplivestreamtesttypemp46. 安全加固措施为确保服务安全建议实施以下措施防火墙配置# 仅开放必要端口 sudo ufw allow 1935/tcp # RTMP sudo ufw allow 8080/tcp # HTTP sudo ufw enableAPI访问控制[http] allow_ip_range127.0.0.1,192.168.1.0/24 secret复杂密码应包含大小写数字和特殊字符定期维护任务# 日志轮转配置在宿主机上 sudo tee /etc/logrotate.d/zlmediakit EOF /opt/zlmediakit/logs/*.log { daily missingok rotate 7 compress delaycompress notifempty create 644 root root } EOF实际部署中发现合理配置TCP缓冲区大小能显著提升大并发下的稳定性# 调整内核参数 echo net.core.rmem_max26214400 /etc/sysctl.conf echo net.core.wmem_max26214400 /etc/sysctl.conf sysctl -p