3步实战部署Stream-rec：多平台直播录制完全指南

3步实战部署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正是解决这些痛点的开源工具，它能自动录制虎牙、抖音、斗鱼、Twitch、PandaTV、微博等主流平台的直播内容，并支持弹幕录制和云端同步功能。🎬

从零开始：快速启动你的直播录制服务

获取项目源码

首先克隆项目到本地，这是所有部署步骤的起点：

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

Stream-rec基于Kotlin和Ktor框架构建，集成了FFmpeg进行视频处理，使用SQLite存储录制数据，并通过Rclone支持云存储上传。

Docker一键部署

Stream-rec提供了完整的Docker支持，这是最快捷的部署方式：

docker build -t stream-rec:latest . docker run -d \ --name stream-rec \ -p 12555:12555 \ -v $(pwd)/data:/app/data \ -v $(pwd)/config:/app/config \ -e TZ=Asia/Shanghai \ stream-rec:latest

关键参数说明：

• -p 12555:12555：Web管理界面端口
• -v $(pwd)/data:/app/data：录制文件存储目录
• -v $(pwd)/config:/app/config：配置文件目录
• -e TZ=Asia/Shanghai：设置时区，确保录制时间准确

访问管理界面

容器启动后，打开浏览器访问http://localhost:12555即可进入Stream-rec的Web管理界面。从这里你可以添加直播源、配置录制参数、查看录制状态。

核心功能模块深度解析

多平台录制引擎

Stream-rec的核心优势在于其强大的多平台支持能力。每个平台都有独立的下载引擎实现：

• 抖音录制：位于platforms/src/main/kotlin/github/hua0512/plugins/douyin/download/
• 虎牙录制：位于platforms/src/main/kotlin/github/hua0512/plugins/huya/download/
• 斗鱼录制：位于platforms/src/main/kotlin/github/hua0512/plugins/douyu/download/
• Twitch录制：位于platforms/src/main/kotlin/github/hua0512/plugins/twitch/download/

每个平台插件都实现了统一的PlatformDownloader接口，确保录制逻辑的一致性。平台适配的核心代码位于base/src/main/kotlin/github/hua0512/plugins/base/Extractor.kt，定义了直播源提取的通用接口。

弹幕录制系统

弹幕是直播体验的重要组成部分，Stream-rec的弹幕录制系统设计得相当完善：

// 弹幕数据模型定义 data class DanmuData( val content: String, val timestamp: Long, val userId: String, val userName: String )

弹幕录制功能位于各平台的danmu目录下，如虎牙的弹幕处理在platforms/src/main/kotlin/github/hua0512/plugins/huya/danmu/中实现。系统支持实时弹幕捕获和存储，确保录制内容的完整性。

文件处理流水线

录制文件的处理是Stream-rec的另一大亮点，包含两个核心处理模块：

FLV格式修复：位于flv-processing/src/main/kotlin/github/hua0512/flv/目录，提供了完整的FLV文件处理能力：

• FlvFix.kt- FLV文件修复
• FlvAnalyzer.kt- FLV文件分析
• FlvParser.kt- FLV解析器

HLS流处理：位于hls-processing/src/main/kotlin/github/hua0512/hls/目录，专门处理HLS直播流：

• HlsProcess.kt- HLS流处理
• PlaylistResolver.kt- 播放列表解析

数据持久化管理

所有录制数据都通过SQLite数据库进行管理，数据层设计非常清晰：

// 数据实体定义示例 @Entity(tableName = "stream_data") data class StreamDataEntity( @PrimaryKey val id: String, val streamerId: String, val title: String, val startTime: Long, val endTime: Long?, val filePath: String )

数据库相关代码位于base/src/main/kotlin/github/hua0512/dao/，包含流数据、用户、配置等完整的数据访问层实现。迁移管理在RoomMigrations.kt中处理，确保数据库结构的平滑升级。

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

直播源管理配置

在Web界面添加直播源时，需要了解不同平台的URL格式：

每个直播源的配置都存储在StreamerEntity中，包含录制质量、格式、保存路径等参数。

录制质量与格式设置

Stream-rec支持多种录制配置，通过DownloadConfig类进行管理：

data class DownloadConfig( val quality: String = "best", val format: String = "best", val outputTemplate: String = "{streamer}/{date}/{time}_{title}.{ext}", val retryCount: Int = 3, val timeout: Long = 30000 )

质量选项：支持 "best"、"1080p"、"720p"、"480p" 等常见分辨率，具体支持情况取决于直播平台。

输出模板变量：

• {streamer}- 主播名称
• {date}- 录制日期 (yyyy-MM-dd)
• {time}- 开始时间 (HH-mm-ss)
• {title}- 直播标题
• {ext}- 文件扩展名

云端存储集成

通过Rclone集成，Stream-rec可以将录制文件自动上传到多种云存储服务：

1. 配置Rclone：首先在宿主机上配置Rclone连接
2. 设置上传策略：在Web界面配置上传触发条件
3. 监控上传状态：通过UploadResultWithData实体跟踪上传进度

上传相关代码位于base/src/main/kotlin/github/hua0512/plugins/upload/，支持同步和异步上传模式。

高级应用场景与性能优化

多实例负载均衡

对于需要录制大量直播源的用户，可以部署多个Stream-rec实例：

# docker-compose-cluster.yml version: '3.8' services: stream-rec-1: image: stream-rec:latest ports: ["12555:12555"] volumes: ["./data-1:/app/data"] stream-rec-2: image: stream-rec:latest ports: ["12556:12555"] volumes: ["./data-2:/app/data"] nginx: image: nginx:alpine ports: ["80:80"] volumes: ["./nginx.conf:/etc/nginx/nginx.conf"]

通过Nginx进行负载均衡，将不同的直播源分配到不同的实例，提高整体录制能力。

存储空间管理

长期录制会产生大量视频文件，需要合理的存储管理策略：

自动清理配置：

# 设置录制文件保留策略 # 在config目录创建cleanup-policy.json { "maxAgeDays": 30, "maxTotalSizeGB": 500, "keepFavorites": true }

分级存储方案：将新录制文件保存在SSD，定期迁移到HDD，历史文件上传到云存储。

监控与告警集成

Stream-rec提供了完整的事件系统，可以集成到现有的监控体系中：

// 事件监听示例 eventBus.subscribe<DownloadEvent> { event -> when (event) { is DownloadEvent.Started -> { logger.info("录制开始: ${event.streamerId}") // 发送到监控系统 } is DownloadEvent.Completed -> { logger.info("录制完成: ${event.filePath}") // 触发后续处理 } is DownloadEvent.Error -> { logger.error("录制错误: ${event.error}") // 发送告警 } } }

事件系统代码位于base/src/main/kotlin/github/hua0512/plugins/event/，支持自定义事件处理器。

从基础到精通：掌握Stream-rec的最佳实践

录制质量优化技巧

1. 网络连接优化：确保录制服务器有稳定的网络连接，避免因网络波动导致录制中断
2. 并发控制：根据服务器性能合理设置同时录制的直播源数量
3. 磁盘IO优化：使用SSD硬盘或RAID阵列提高写入性能

弹幕录制的最佳实践

• 存储格式选择：弹幕可以存储为JSON或CSV格式，便于后续分析
• 时间同步：确保弹幕时间戳与视频时间轴精确同步
• 去重处理：对于重复弹幕进行适当过滤，减少存储开销

故障恢复机制

Stream-rec内置了完善的错误恢复机制：

// 错误处理示例 try { downloadStream(streamUrl, outputPath) } catch (e: DownloadErrorException) { when (e) { is NetworkError -> retryWithBackoff() is PlatformError -> switchToAlternativeSource() is FormatError -> adjustDownloadParameters() } }

错误处理逻辑分布在各个平台的下载器实现中，确保单次失败不会影响其他录制任务。

扩展开发指南

如果你需要支持新的直播平台，可以参照现有实现进行扩展：

1. 创建平台插件目录：在platforms/src/main/kotlin/github/hua0512/plugins/下新建平台目录
2. 实现下载器：继承PlatformDownloader基类
3. 实现弹幕处理器：如果需要弹幕支持
4. 注册插件：在ExtractorFactory.kt中注册新的平台提取器

你的直播录制工作流从此不同

通过Stream-rec，你可以建立完整的直播内容管理系统。从直播发现、自动录制、弹幕保存到云端归档，形成完整的工作流。系统会持续监控你关注的主播，在他们开播时自动开始录制，并在直播结束后进行文件处理和上传。

典型应用场景：

• 内容创作者：自动录制竞争对手的直播内容进行分析
• 教育机构：录制在线课程和讲座
• 媒体公司：采集多个平台的新闻直播
• 个人用户：不错过喜欢主播的任何一场直播

Stream-rec的模块化设计让你可以根据需要灵活配置，无论是简单的个人使用还是复杂的企业级部署，都能找到合适的方案。现在就开始构建你的自动化直播录制系统，让精彩直播不再错过！🚀

下一步行动建议：

1. 从单个直播源开始测试，熟悉配置流程
2. 逐步添加更多平台和直播源
3. 配置云端存储实现自动备份
4. 集成到现有的监控告警系统
5. 根据实际需求调整录制参数和质量设置

通过这个完整的指南，你应该已经掌握了Stream-rec的核心功能和部署方法。记住，最好的学习方式就是动手实践——立即开始你的第一个直播录制任务吧！

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