保姆级教程：用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 | 获取宿主机权限 | 必须为true |
| restart | 自动重启策略 | 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-6000kbps（1080p） - 关键帧间隔：2秒 - 预设：quality - 配置：high音频编码建议：
- 采样率：44.1kHz
- 比特率：160kbps
- 格式：AAC
注意：首次推流前建议进行带宽测试，确保上行带宽足够
4. 流媒体访问与监控
成功推流后，可通过多种协议访问流媒体：
拉流地址格式：
- RTMP:
rtmp://服务器IP:1935/live/流密钥 - HTTP-FLV:
http://服务器IP:8080/live/流密钥.flv - HLS:
http://服务器IP:8080/live/流密钥/hls.m3u8 - RTSP:
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] enableVhost=1 ; 启用虚拟主机 flowThreshold=10240 ; 流量阈值(KB) [protocol] enable_rtmp=1 enable_rtsp=1 enable_hls=1 enable_http=1 [hook] enable=1 ; 启用事件通知 on_publish=http://callback.example.com/publish on_play=http://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? \ secret=your_secret&app=live&stream=test&type=mp4"
6. 安全加固措施
为确保服务安全，建议实施以下措施：
防火墙配置：
# 仅开放必要端口 sudo ufw allow 1935/tcp # RTMP sudo ufw allow 8080/tcp # HTTP sudo ufw enableAPI访问控制：
[http] allow_ip_range=127.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_max=26214400' >> /etc/sysctl.conf echo 'net.core.wmem_max=26214400' >> /etc/sysctl.conf sysctl -p