Stream-rec直播流录制：从零开始构建你的自动化录播系统

Stream-rec直播流录制从零开始构建你的自动化录播系统【免费下载链接】stream-recAutomatic streaming record tool. Live stream and bullet comments recorder. 虎牙/抖音/斗鱼/Twitch/PandaTV/微博直播弹幕自动录制项目地址: https://gitcode.com/gh_mirrors/st/stream-rec在直播内容日益丰富的今天如何高效、稳定地录制心仪的直播内容成为许多内容创作者和直播爱好者的痛点。手动录制不仅耗时耗力还容易错过精彩瞬间。Stream-rec作为一款开源的多平台自动直播录制工具能够帮你解决这些烦恼实现7×24小时无人值守的智能录播系统。Stream-rec是一个基于Kotlin开发的自动直播流录制工具支持虎牙、抖音、斗鱼、Twitch、PandaTV、微博等主流直播平台提供完整的录播解决方案。本文将带你从零开始掌握Stream-rec的核心功能、部署方法和高级配置技巧。为什么选择Stream-rec在众多录播工具中Stream-rec凭借以下独特优势脱颖而出特性Stream-rec传统录播工具多平台支持✅ 抖音、斗鱼、虎牙、Twitch等❌ 通常单一平台自动弹幕录制✅ 同步保存为XML格式❌ 需要额外工具智能文件命名✅ 基于直播标题和开始时间❌ 固定命名云存储集成✅ Rclone自动上传❌ 手动操作Web管理界面✅ 可视化配置和监控❌ 命令行操作Docker支持✅ 一键部署❌ 环境配置复杂核心优势Stream-rec不仅解决了录什么的问题更通过自动化流程解决了怎么录、怎么存、怎么管的全链路需求。快速部署指南三种方式任你选方案一Docker容器化部署推荐对于大多数用户Docker是最简单快捷的部署方式避免了环境依赖的复杂性# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/st/stream-rec cd stream-rec # 构建Docker镜像 docker build -t stream-rec:latest . # 启动容器映射端口12555用于Web管理 docker run -d \ --name stream-rec \ -p 12555:12555 \ -v /path/to/data:/app/data \ -e LOG_LEVELINFO \ -e LOGIN_SECRETyour_secure_password \ -e TZAsia/Shanghai \ stream-rec:latest关键参数说明-p 12555:12555将容器内Web服务端口映射到主机-v /path/to/data:/app/data持久化存储录播数据和配置-e LOGIN_SECRETWeb界面登录密码必须修改方案二手动编译运行适合开发者或需要自定义修改的场景# 安装必要依赖 sudo apt update sudo apt install -y openjdk-21-jdk ffmpeg # 编译项目 ./gradlew stream-rec:build -x test # 运行程序 java -jar stream-rec/build/libs/stream-rec.jar \ -DDB_PATH./data/db \ -DLOG_LEVELDEBUG方案三预编译JAR包运行从项目Release页面下载最新的stream-rec.jar# 创建数据目录 mkdir -p ./data/{db,recordings,logs} # 启动程序 java -Dserver.port12555 \ -DDB_PATH./data/db \ -DLOGIN_SECRETyour_password \ -jar stream-rec.jar⚠️安全提醒生产环境务必修改默认的LOGIN_SECRET参数避免未授权访问。核心功能深度解析1. 多平台直播录制Stream-rec通过模块化设计支持多种直播平台每个平台都有专门的解析器抖音平台platforms/src/main/kotlin/github/hua0512/plugins/douyin/download/Douyin.kt斗鱼平台platforms/src/main/kotlin/github/hua0512/plugins/douyu/download/Douyu.kt虎牙平台platforms/src/main/kotlin/github/hua0512/plugins/huya/download/Huya.ktTwitch平台platforms/src/main/kotlin/github/hua0512/plugins/twitch/download/Twitch.kt平台支持对比表平台直播录制弹幕支持房间ID格式示例URL抖音✅✅数字IDhttps://live.douyin.com/123456789斗鱼✅✅房间号https://www.douyu.com/12345虎牙✅✅房间号https://www.huya.com/12345Twitch✅✅频道名https://www.twitch.tv/channel_namePandaTV✅✅房间号https://www.pandalive.co.kr/play/12345微博✅❌UID或房间号https://weibo.com/u/123452. 智能弹幕录制系统Stream-rec的弹幕录制功能是其一大亮点能够将直播弹幕同步保存为XML格式// 弹幕处理核心逻辑示例 class DanmuRecorder { fun recordDanmu(streamUrl: String, outputPath: String) { // 解析弹幕流 // 转换为XML格式 // 保存到文件 } }弹幕文件可以与视频文件同步使用DanmakuFactory等工具进行后续处理或配合AList实现弹幕自动挂载。3. 文件处理与修复项目包含专业的视频处理模块FLV处理flv-processing/src/main/kotlin/github/hua0512/flv/ - 提供FLV文件修复、合并和元数据注入功能HLS处理hls-processing/src/main/kotlin/github/hua0512/hls/ - 支持HLS分段下载和合并这些模块确保了录制的视频文件完整性和可播放性。Web管理界面配置Stream-rec内置基于Ktor的Web管理界面提供直观的操作体验主要功能页面仪表盘实时监控录制状态和系统资源主播管理添加、编辑、删除监控的主播文件管理查看和管理已录制的视频文件配置中心系统参数和平台配置上传管理云存储上传任务监控配置示例Web界面添加主播{ platform: douyin, roomId: 70234567890, quality: 原画, savePath: /data/recordings/douyin, autoUpload: true, uploadConfig: { provider: rclone, remote: onedrive:live-recordings, pathTemplate: {platform}/{date}/{streamer}_{time}.flv } }高级配置与优化技巧1. 性能调优配置在config.properties或环境变量中调整以下参数# 网络设置 download.max_retries5 download.buffer_size100 download.timeout30000 # 录制设置 stream.max_concurrent3 stream.reconnect_delay10 stream.max_segment_size2048 # 存储设置 storage.cleanup_days30 storage.max_disk_usage802. 定时任务配置Stream-rec支持定时录制功能适合固定时间段的直播// 定时任务配置示例 val timerTask TimerTask( startTime 19:00, endTime 21:00, daysOfWeek listOf(MON, WED, FRI), enabled true )3. 云存储集成通过Rclone支持多种云存储服务# 配置Rclone以OneDrive为例 rclone config # 选择n) New remote # 输入名称onedrive # 选择存储类型onedrive # 按照提示完成OAuth认证 # Stream-rec中配置 upload.providerrclone upload.remoteonedrive:live-recordings upload.concurrent2故障排查与常见问题问题1录制失败或视频不完整可能原因网络不稳定导致连接中断平台API变更磁盘空间不足解决方案增加重试次数download.max_retries10检查平台插件是否需要更新设置磁盘监控storage.max_disk_usage75问题2弹幕录制失败可能原因平台弹幕协议变更WebSocket连接问题防火墙限制解决方案查看日志定位具体错误调整网络代理设置检查防火墙规则问题3Web界面无法访问可能原因端口被占用服务未启动防火墙限制解决方案# 检查服务状态 docker ps | grep stream-rec # 查看日志 docker logs stream-rec # 修改端口启动 java -Dserver.port8080 -jar stream-rec.jar架构设计与扩展性Stream-rec采用模块化架构设计便于二次开发和功能扩展核心模块结构stream-rec/ ├── base/ # 基础模块 │ ├── schemas/ # 数据库Schema │ └── src/main/kotlin/github/hua0512/ │ ├── dao/ # 数据访问层 │ ├── data/ # 数据模型 │ └── plugins/ # 插件系统 ├── platforms/ # 平台插件 │ └── src/main/kotlin/github/hua0512/plugins/ │ ├── douyin/ # 抖音插件 │ ├── douyu/ # 斗鱼插件 │ └── huya/ # 虎牙插件 ├── server/ # Web服务 │ └── src/main/kotlin/github/hua0512/backend/ └── stream-rec/ # 主程序 └── src/main/kotlin/github/hua0512/ ├── services/ # 业务服务 └── utils/ # 工具类自定义插件开发如果需要支持新的直播平台可以参照现有插件模板开发创建平台插件目录mkdir -p platforms/src/main/kotlin/github/hua0512/plugins/newplatform/实现核心接口class NewPlatformExtractor : Extractor { override fun extract(roomId: String): StreamInfo { // 实现直播流提取逻辑 } }注册插件 在plugins/base/IExtractorFactory.kt中添加插件注册。最佳实践与生产部署1. 高可用部署方案对于需要7×24小时稳定运行的生产环境# docker-compose.yml version: 3.8 services: stream-rec: image: stream-rec:latest container_name: stream-rec restart: unless-stopped ports: - 12555:12555 volumes: - ./data:/app/data - ./logs:/app/logs environment: - LOG_LEVELINFO - LOGIN_SECRET${STREAM_REC_PASSWORD} - TZAsia/Shanghai healthcheck: test: [CMD, curl, -f, http://localhost:12555/health] interval: 30s timeout: 10s retries: 32. 监控与告警结合Prometheus和Grafana实现监控# prometheus.yml scrape_configs: - job_name: stream-rec static_configs: - targets: [stream-rec:12555] metrics_path: /metrics3. 备份策略定期备份配置和数据库#!/bin/bash # 备份脚本 BACKUP_DIR/backup/stream-rec DATE$(date %Y%m%d) # 备份数据库 cp /data/db/stream-rec.db $BACKUP_DIR/db_$DATE.db # 备份配置文件 tar -czf $BACKUP_DIR/config_$DATE.tar.gz /data/config/ # 保留最近30天的备份 find $BACKUP_DIR -name *.db -mtime 30 -delete find $BACKUP_DIR -name *.tar.gz -mtime 30 -delete未来发展与社区贡献Stream-rec作为开源项目持续欢迎社区贡献近期开发路线图更多平台支持Bilibili、YouTube等平台AI功能集成智能剪辑和精彩片段提取移动端应用iOS/Android管理客户端分布式部署多节点协同录制如何参与贡献报告问题在GitHub Issues提交Bug报告功能建议提出新功能需求代码贡献提交Pull Request文档改进完善使用文档和教程总结Stream-rec作为一款功能全面的直播录制工具不仅解决了多平台直播录制的基本需求更通过弹幕录制、云存储集成、Web管理界面等高级功能为内容创作者提供了完整的解决方案。无论是个人用户还是小型团队都能通过Stream-rec轻松构建稳定可靠的自动化录播系统。通过本文的详细指南你已经掌握了Stream-rec的核心功能、部署方法、配置技巧和故障排查。现在就开始使用Stream-rec构建属于你自己的智能录播系统吧最后提示在使用过程中遇到任何问题可以查看项目的官方文档或加入社区讨论。开源项目的生命力在于社区的参与和贡献期待你的加入【免费下载链接】stream-recAutomatic streaming record tool. Live stream and bullet comments recorder. 虎牙/抖音/斗鱼/Twitch/PandaTV/微博直播弹幕自动录制项目地址: https://gitcode.com/gh_mirrors/st/stream-rec创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考