5分钟搭建专属直播录制系统：Stream-rec零基础完全指南 [特殊字符]

5分钟搭建专属直播录制系统：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正是你需要的开源直播流自动录制工具！这款基于Kotlin和Ktor框架开发的多平台直播录制解决方案，支持主流直播平台的自动录制、弹幕同步采集和云端上传功能，让你轻松打造专属的直播内容库。

为什么选择Stream-rec？ 🤔

在众多直播录制工具中，Stream-rec凭借其独特优势脱颖而出：

💡小贴士：Stream-rec采用模块化设计，核心源码位于src/main/目录，每个平台都有独立的解析器实现，扩展性极强！

三步快速上手指南 🚀

第一步：环境准备与安装

Stream-rec基于JVM运行，支持Windows、Linux和macOS系统。推荐使用Linux系统以获得最佳性能。

基础依赖要求：

• Java 11或更高版本（推荐Java 21）
• FFmpeg 5.1+（用于视频处理）
• Docker（可选，推荐使用）

一键安装命令（Ubuntu/Debian）：

# 安装Java和FFmpeg sudo apt update && sudo apt install -y openjdk-21-jdk ffmpeg # 安装Python和Streamlink（用于部分平台） sudo apt install -y python3 python3-pip pip3 install streamlink # 安装Rclone（用于云存储上传） curl https://rclone.org/install.sh | sudo bash

第二步：部署方式选择

Stream-rec提供三种部署方式，满足不同用户需求：

方式一：Docker部署（推荐新手）

docker run -d -p 12555:12555 \ -v ./data:/app/data \ -e LOG_LEVEL=INFO \ -e LOGIN_SECRET=your_password \ --name stream-rec-container \ hua0512/stream-rec:latest

方式二：源码编译运行

# 克隆仓库 git clone https://gitcode.com/gh_mirrors/st/stream-rec cd stream-rec # 编译项目 ./gradlew stream-rec:build -x test # 运行程序 java -jar stream-rec/build/libs/stream-rec.jar

方式三：预编译JAR包从项目Release页面下载最新JAR包后直接运行：

java -DDB_PATH=./data/db -jar stream-rec.jar

第三步：基础配置与使用

启动后访问http://localhost:12555，使用设置的密码登录Web管理界面：

1. 添加录制任务：点击"添加主播"，输入直播间URL
2. 配置录制参数：选择画质、保存路径等选项
3. 开启自动录制：系统会自动检测直播状态并开始录制

⚠️重要提醒：首次使用时务必修改默认密码！生产环境中请设置强密码保证安全。

核心功能深度解析 🔍

智能录制引擎

Stream-rec的录制引擎位于platforms/src/main/目录，针对不同平台采用专用解析器：

• 抖音平台：支持房间ID解析和Cookie验证
• 虎牙平台：完整的弹幕协议支持
• 斗鱼平台：稳定流畅的录制体验
• Twitch：国际平台适配优化

弹幕采集系统

弹幕采集模块独立设计，支持实时弹幕保存为JSON格式。每个平台的弹幕解析器位于对应平台的danmu/目录下，如虎牙的弹幕解析在platforms/src/main/kotlin/github/hua0512/plugins/huya/danmu/。

文件处理流程

录制完成的视频文件会经过以下处理：

1. 格式修复：FLV文件修复工具位于flv-processing/
2. 元数据注入：添加录制时间、平台信息等元数据
3. 自动上传：通过Rclone上传到配置的云存储

高级配置与优化技巧 ⚙️

性能调优配置

在config.properties或环境变量中调整以下参数：

# 网络设置 download.max_retries=5 download.buffer_size=100 stream.reconnect_delay=10 # 存储设置 storage.max_concurrent_uploads=3 storage.upload_retry_delay=30 # 系统资源限制 system.max_memory_mb=2048 system.max_cpu_cores=2

平台特定配置

不同直播平台可能需要特殊配置：

存储策略建议

1. 本地存储：使用SSD硬盘减少写入延迟
2. 网络存储：通过Rclone挂载NAS或云存储
3. 文件命名：使用模板{platform}_{roomId}_{date}_{time}.flv
4. 自动清理：设置保留天数或最大存储空间

常见问题解决方案 🛠️

Q1: 录制时提示"ffmpeg not found"

解决方案：确保FFmpeg正确安装并在系统PATH中

which ffmpeg # 确认ffmpeg路径 sudo apt install ffmpeg # 重新安装

Q2: 抖音直播无法录制

解决方案：在Web界面的"平台配置"中填入有效的抖音Cookie

{ "platform": "douyin", "cookies": "your_cookie_here" }

Q3: 录制文件过大

解决方案：启用录制后处理压缩

post_process.enabled=true post_process.compression_level=medium

Q4: Web界面无法访问

解决方案：检查端口占用或防火墙设置

# 检查端口占用 netstat -tlnp | grep 12555 # 修改端口启动 java -Dserver.port=8080 -jar stream-rec.jar

架构设计与扩展性 🏗️

Stream-rec采用模块化架构，便于功能扩展：

stream-rec/ ├── base/ # 基础数据模型和DAO ├── common/ # 通用工具和异常处理 ├── flv-processing/ # FLV文件处理模块 ├── hls-processing/ # HLS流处理模块 ├── platforms/ # 各平台解析器 ├── server/ # Web服务模块 └── stream-rec/ # 主程序入口

扩展新平台步骤：

1. 在platforms/src/main/kotlin/github/hua0512/plugins/创建新平台目录
2. 实现Extractor接口解析直播流地址
3. 实现Danmu接口处理弹幕协议
4. 注册到平台工厂中

最佳实践与使用建议 📝

生产环境部署

1. 使用Docker Compose：管理多个服务依赖
2. 配置监控告警：监控录制任务状态
3. 定期备份数据库：防止数据丢失
4. 日志轮转配置：避免日志文件过大

资源管理

• 内存限制：java -Xmx2g -jar stream-rec.jar
• CPU限制：docker run --cpus=2 --memory=4g ...
• 磁盘空间：设置自动清理策略

安全建议

1. 修改默认密码：这是最重要的安全措施
2. 使用HTTPS：如果暴露在公网，配置SSL证书
3. 限制访问IP：仅允许信任的网络访问
4. 定期更新：关注项目更新，及时修复安全漏洞

总结与展望 🌟

Stream-rec作为一款功能全面的开源直播录制工具，为内容创作者、直播爱好者提供了强大的自动化解决方案。无论是想要保存喜欢的直播内容，还是进行直播数据分析，Stream-rec都能满足你的需求。

未来发展方向：

• 更多直播平台支持
• 更智能的录制策略
• 移动端管理应用
• 社区插件系统

🎯核心优势：开源免费、多平台支持、弹幕同步、自动上传、Web管理界面，这些特性让Stream-rec成为直播录制领域的优秀选择。

开始你的直播录制之旅吧！无论是保存珍贵时刻还是分析直播数据，Stream-rec都将是你得力的助手。记得参考官方文档：docs/README_zh.md获取最新信息和详细配置说明。

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