3步搭建自动化直播录制系统：Stream-rec终极Docker部署指南

3步搭建自动化直播录制系统：Stream-rec终极Docker部署指南

【免费下载链接】stream-recAutomatic streaming record tool. Live stream and bullet comments recorder. 虎牙/抖音/斗鱼/Twitch/PandaTV/微博直播，弹幕自动录制项目地址: https://gitcode.com/gh_mirrors/st/stream-rec

你是否曾经因为错过喜欢的直播而遗憾？或者想要自动录制多个平台的直播内容？Stream-rec正是为你量身打造的自动化直播录制工具！🎬

Stream-rec是一款基于Kotlin和FFmpeg的自动化直播录制工具，支持虎牙、抖音、斗鱼、Twitch、PandaTV、微博等多个主流直播平台，能够自动检测直播状态并录制视频和弹幕。通过Docker容器化部署，你可以快速搭建一个稳定可靠的直播录制系统。

🚀 为什么选择Stream-rec自动化直播录制工具？

在当今直播内容爆炸的时代，传统的手动录制方式已经无法满足需求。Stream-rec通过自动化技术解决了三大核心痛点：

🎯 智能监控：24小时不间断监控直播状态，自动开始和结束录制📊 多平台支持：覆盖主流直播平台，一个工具满足所有需求
💾 完整保存：不仅录制视频，还能保存弹幕互动内容

📦 Stream-rec核心架构揭秘

Stream-rec采用模块化设计，每个组件都有明确的职责分工：

插件化平台支持

核心功能源码位于platforms/src/main/kotlin/目录，每个直播平台都有独立的插件实现。比如虎牙录制模块在platforms/src/main/kotlin/github/hua0512/plugins/huya/download/Huya.kt中实现，这种设计让扩展新平台变得异常简单。

智能数据处理

• FLV修复模块：位于flv-processing/目录，专门处理FLV格式的视频修复
• HLS处理模块：位于hls-processing/目录，支持HLS流媒体的分段处理
• 弹幕系统：各平台的弹幕录制逻辑独立封装，确保兼容性

数据持久化管理

数据管理模块位于base/src/main/kotlin/github/hua0512/dao/，使用SQLite轻量级数据库存储录制历史、配置信息和用户数据，确保数据安全可靠。

🛠️ 3步快速部署Stream-rec直播录制服务

第一步：环境准备与项目获取

首先确保你的系统已安装Docker，然后获取项目代码：

git clone https://gitcode.com/gh_mirrors/st/stream-rec.git cd stream-rec

Stream-rec的Dockerfile已经为你准备好了所有依赖，包括FFmpeg、Rclone、Streamlink等核心组件。多阶段构建确保最终镜像体积最小化，同时包含所有必要的运行时环境。

第二步：一键构建Docker镜像

在项目根目录执行构建命令：

docker build -t stream-rec:latest .

这个构建过程会自动：

1. 下载JDK 21和Gradle构建工具
2. 编译Kotlin应用程序
3. 安装Python虚拟环境及Streamlink
4. 集成平台特定的Twitch插件
5. 根据CPU架构下载对应的strev工具

第三步：启动你的直播录制服务

使用Docker Compose进行优雅部署，创建docker-compose.yml文件：

version: '3.8' services: stream-rec: image: stream-rec:latest container_name: stream-rec restart: unless-stopped ports: - "12555:12555" volumes: - ./recordings:/app/data - ./config:/app/config environment: - TZ=Asia/Shanghai - JAVA_OPTS=-Xmx2g

然后启动服务：

docker-compose up -d

🎯 实战配置：打造个性化录制系统

场景一：多平台主播监控

假设你关注的主播同时在抖音和斗鱼开播，Stream-rec可以同时监控这两个平台。在Web管理界面（http://localhost:12555）添加主播链接后，系统会自动：

1. 智能检测：每5分钟检查一次直播状态
2. 质量选择：根据网络状况自动选择最佳画质
3. 文件命名：按"主播名_直播标题_时间戳"格式自动命名
4. 弹幕保存：同步保存弹幕为JSON格式

场景二：定时录制与云端备份

对于固定时间的直播节目，可以配置定时任务：

# 在config目录下的配置文件 recording: schedules: - platform: "douyu" room_id: "12345" start_time: "20:00" duration: "2h" quality: "原画" upload: enabled: true provider: "rclone" remote: "onedrive:/直播录制" cron: "0 2 * * *" # 每天凌晨2点上传

场景三：企业级多实例部署

对于直播机构或MCN公司，可以部署多个实例分担负载：

version: '3.8' services: stream-rec-1: image: stream-rec:latest ports: ["12555:12555"] volumes: - ./data/platform1:/app/data environment: - INSTANCE_NAME=platform1 - MAX_CONCURRENT_RECORDINGS=5 stream-rec-2: image: stream-rec:latest ports: ["12556:12555"] volumes: - ./data/platform2:/app/data environment: - INSTANCE_NAME=platform2 - MAX_CONCURRENT_RECORDINGS=5 nginx: image: nginx:alpine ports: ["80:80"] volumes: - ./nginx.conf:/etc/nginx/nginx.conf

🔧 高级功能深度解析

弹幕录制技术实现

Stream-rec的弹幕系统采用WebSocket长连接技术，实时接收平台推送的弹幕消息。每个平台的弹幕解析逻辑都封装在独立的模块中，如虎牙弹幕在platforms/src/main/kotlin/github/hua0512/plugins/huya/danmu/HuyaDanmu.kt中实现。

智能错误恢复机制

当网络波动或平台API变化时，Stream-rec具备自动恢复能力：

1. 断线重连：自动检测连接状态，3秒内重连
2. 格式兼容：自动适配平台视频格式变化
3. 质量降级：当原画质不可用时自动切换到高清

资源优化策略

• 内存管理：采用Kotlin协程，避免线程阻塞
• 磁盘优化：智能清理临时文件，防止磁盘写满
• 网络优化：自适应码率调整，节省带宽

📈 性能监控与运维指南

健康检查配置

在Docker Compose中添加健康检查：

healthcheck: test: ["CMD", "curl", "-f", "http://localhost:12555/health"] interval: 30s timeout: 10s retries: 3 start_period: 40s

监控指标收集

Stream-rec提供丰富的监控端点：

# 获取系统状态 curl http://localhost:12555/api/stats # 查看活动录制 curl http://localhost:12555/api/streamers/active # 磁盘使用情况 curl http://localhost:12555/api/system/disk

日志分析与故障排查

查看详细运行日志：

docker logs -f stream-rec --tail 100

常见问题快速诊断：

1. 录制失败：检查网络连接和平台API状态
2. 磁盘空间不足：配置自动清理策略
3. 弹幕丢失：验证平台WebSocket连接

🎨 最佳实践与优化建议

存储策略优化

storage: retention_days: 30 # 保留30天 auto_cleanup: true max_size_per_streamer: "50GB" compression: true # 启用压缩存储

网络配置优化

network: download_threads: 3 # 并发下载线程数 timeout_seconds: 30 # 超时时间 retry_times: 3 # 重试次数 proxy: # 代理配置（可选） enabled: false host: "proxy.example.com" port: 8080

录制质量调优

根据你的网络环境和存储空间，调整录制参数：

• 家庭网络：建议720p，平衡画质和带宽
• 企业专线：可支持1080p或更高画质
• 移动网络：建议使用480p，确保流畅性

🌟 未来扩展与社区贡献

Stream-rec采用开源架构，方便社区贡献：

1. 新平台支持：参考现有平台插件模板开发
2. 功能扩展：基于插件系统添加新功能
3. Bug修复：提交PR帮助项目完善

项目核心模块路径：

• 官方文档：docs/README_zh.md
• 核心功能源码：platforms/src/main/kotlin/
• 数据管理模块：base/src/main/kotlin/github/hua0512/dao/

🎉 开始你的自动化直播录制之旅

通过本文的Docker部署指南，你已经掌握了Stream-rec的核心部署技巧。无论你是个人用户想要录制喜欢的直播内容，还是企业需要搭建专业的直播录制系统，Stream-rec都能提供稳定可靠的解决方案。

记住，成功的直播录制系统需要： ✅定期维护：更新Docker镜像，获取最新功能 ✅监控告警：设置磁盘空间和网络状态监控 ✅备份策略：重要录制内容定期备份到云存储 ✅社区参与：关注项目更新，参与功能讨论

现在就开始使用Stream-rec，打造属于你的自动化直播录制系统吧！如果有任何问题或建议，欢迎在项目社区中交流讨论。🎥

【免费下载链接】stream-recAutomatic streaming record tool. Live stream and bullet comments recorder. 虎牙/抖音/斗鱼/Twitch/PandaTV/微博直播，弹幕自动录制项目地址: https://gitcode.com/gh_mirrors/st/stream-rec