Stream-rec构建全平台直播录制系统的现代化部署指南【免费下载链接】stream-recAutomatic streaming record tool. Live stream and bullet comments recorder. 虎牙/抖音/斗鱼/Twitch/PandaTV/微博直播弹幕自动录制项目地址: https://gitcode.com/gh_mirrors/st/stream-recStream-rec是一款基于Kotlin和Ktor框架构建的自动直播录制工具支持虎牙、抖音、斗鱼、Twitch、PandaTV、微博等主流直播平台。它采用模块化架构设计集成了FFmpeg流处理引擎、SQLite数据存储和Rclone云同步功能能够自动检测直播状态、录制高清视频并保存弹幕互动为内容创作者和直播爱好者提供了一套完整的自动化录制解决方案。 为什么你需要一个智能的直播录制系统在直播内容日益丰富的今天错过精彩直播已成为许多用户的痛点。传统的手动录制方式不仅效率低下还难以应对突发直播和长时间连续录制需求。Stream-rec通过智能监控和自动化流程解决了以下核心痛点跨平台兼容性统一管理多个直播平台的录制任务智能调度自动检测直播状态按需启动/停止录制数据完整性完整保存视频流和弹幕数据云端同步支持Rclone自动上传到各类云存储服务️ 系统架构深度解析Stream-rec采用分层架构设计各模块职责清晰便于扩展和维护┌─────────────────────────────────────────────┐ │ Web管理界面 (Ktor Server) │ ├─────────────────────────────────────────────┤ │ 业务逻辑层 (Services) │ 数据访问层 (Repositories) │ ├─────────────────────────────────────────────┤ │ 插件系统 (Plugins) │ 核心引擎 (Core) │ ├─────────────────────────────────────────────┤ │ 平台适配层 (Platforms) │ 流处理层 (Processing) │ ├─────────────────────────────────────────────┤ │ FFmpeg引擎 │ SQLite存储 │ Rclone同步 │ └─────────────────────────────────────────────┘核心组件说明插件系统位于platforms/src/main/kotlin/github/hua0512/plugins/目录为每个直播平台提供独立的下载器和弹幕处理器数据处理模块flv-processing/和hls-processing/目录负责视频流格式转换和修复数据持久化基于SQLite的Room数据库位于base/src/main/kotlin/github/hua0512/dao/Web服务Ktor框架构建的RESTful API和前端界面 一键部署Docker容器化实践环境准备与快速启动确保你的系统已安装Docker和Docker Compose然后执行以下命令# 克隆项目代码 git clone https://gitcode.com/gh_mirrors/st/stream-rec.git cd stream-rec # 构建Docker镜像 docker build -t stream-rec:latest . # 创建必要的目录 mkdir -p data config # 运行容器 docker run -d \ --name stream-rec \ -p 12555:12555 \ -v $(pwd)/data:/app/data \ -v $(pwd)/config:/app/config \ -e TZAsia/Shanghai \ stream-rec:latestDocker 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: - ./data:/app/data - ./config:/app/config - ./logs:/app/logs environment: - TZAsia/Shanghai - JAVA_OPTS-Xmx2g -Xms512m healthcheck: test: [CMD, curl, -f, http://localhost:12555/health] interval: 30s timeout: 10s retries: 3 networks: - stream-rec-network networks: stream-rec-network: driver: bridge启动服务docker-compose up -d⚙️ 核心配置详解应用配置文件结构Stream-rec的配置系统采用分层设计支持多种配置方式// 主要配置类位于 base/src/main/kotlin/github/hua0512/data/config/ data class AppConfig( val server: ServerConfig, val download: DownloadConfig, val upload: UploadConfig?, val global: GlobalConfig ) data class DownloadConfig( val outputDir: String ./recordings, val quality: String best, val format: String mp4, val danmuEnabled: Boolean true, val autoStart: Boolean true )关键配置参数录制质量设置quality: 支持best、1080p、720p等画质选项format: 输出格式支持mp4、flv、mkv等存储路径配置output_dir: /data/recordings max_storage_gb: 100 retention_days: 30弹幕录制选项danmu: enabled: true format: json save_path: /data/danmu 实战操作从零开始配置直播录制第一步访问Web管理界面容器启动后通过浏览器访问http://localhost:12555进入管理界面。首次使用需要设置管理员账户和密码。第二步添加直播源在直播源管理页面点击添加直播源按钮输入直播URL抖音直播https://live.douyin.com/{房间号}虎牙直播https://www.huya.com/{房间号}斗鱼直播https://www.douyu.com/{房间号}Twitch直播https://www.twitch.tv/{频道名}第三步配置录制参数为每个直播源设置个性化的录制参数streamer_config: name: 主播名称 url: https://live.douyin.com/123456 quality: 1080p format: mp4 danmu_enabled: true auto_start: true schedule: - days: [周一, 周三, 周五] start_time: 20:00 end_time: 22:00第四步设置云存储同步配置Rclone实现录制文件自动上传# 宿主机上配置Rclone rclone config # 在Stream-rec Web界面配置Rclone参数 rclone_config: type: s3 # 支持s3、google drive、onedrive等 bucket: your-bucket region: us-east-1 access_key: your-access-key secret_key: your-secret-key 高级功能与定制化多实例负载均衡部署对于大规模录制需求可以部署多个Stream-rec实例实现负载均衡version: 3.8 services: stream-rec-1: image: stream-rec:latest ports: [12555:12555] volumes: - ./data/instance1:/app/data - ./config/instance1:/app/config environment: - INSTANCE_ID1 - REDIS_HOSTredis stream-rec-2: image: stream-rec:latest ports: [12556:12555] volumes: - ./data/instance2:/app/data - ./config/instance2:/app/config environment: - INSTANCE_ID2 - REDIS_HOSTredis redis: image: redis:alpine ports: [6379:6379] nginx: image: nginx:alpine ports: [80:80] volumes: - ./nginx.conf:/etc/nginx/nginx.conf自定义插件开发Stream-rec支持插件扩展你可以为新的直播平台开发适配器// 在 platforms/src/main/kotlin/ 目录下创建新平台插件 class CustomPlatformDownloader : PlatformDownloader { override suspend fun extractStreamInfo(url: String): StreamInfo { // 实现流信息提取逻辑 } override suspend fun downloadStream( streamInfo: StreamInfo, callback: DownloadCallback ) { // 实现下载逻辑 } } 监控与运维最佳实践健康检查与监控Stream-rec提供了完整的监控接口# 健康检查 curl http://localhost:12555/health # 获取系统状态 curl http://localhost:12555/api/stats # 获取活动录制任务 curl http://localhost:12555/api/streamers/active # 获取磁盘使用情况 curl http://localhost:12555/api/system/disk日志管理与分析配置日志轮转和集中管理logging: level: INFO file: /app/logs/stream-rec.log max_size: 100MB max_files: 10 format: %d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n性能优化建议硬件资源配置CPU推荐4核以上支持多路并发录制内存建议8GB以上确保流畅处理视频流存储使用SSD提升IO性能预留足够空间网络优化确保稳定的网络连接避免录制中断配置合理的带宽限制避免影响其他服务容器优化deploy: resources: limits: cpus: 4 memory: 8G reservations: cpus: 2 memory: 4G 故障排除与常见问题录制失败诊断网络连接问题# 检查网络连通性 docker exec stream-rec ping -c 3 live.douyin.com # 检查DNS解析 docker exec stream-rec nslookup live.douyin.com权限问题修复# 确保挂载目录有正确权限 chown -R 1000:1000 ./data ./config chmod -R 755 ./data ./config资源不足处理# 清理旧文件 docker exec stream-rec find /app/data -type f -mtime 30 -delete # 检查磁盘空间 docker exec stream-rec df -h性能调优技巧并发录制优化download: max_concurrent: 3 # 根据CPU核心数调整 buffer_size: 64M # 增加缓冲区大小 timeout_seconds: 30内存管理# 调整JVM参数 -e JAVA_OPTS-Xmx4g -Xms2g -XX:UseG1GC 未来扩展与生态集成与监控系统集成Stream-rec可以轻松集成到现有的监控体系中# Prometheus监控配置 metrics: enabled: true port: 9091 path: /metrics # Grafana仪表板配置 grafana: datasource: prometheus dashboard: - name: Stream-rec Monitoring panels: - title: Active Recordings query: stream_rec_active_recordings - title: Storage Usage query: stream_rec_storage_bytes自动化工作流结合CI/CD工具实现自动化部署和配置管理# GitHub Actions自动化部署 name: Deploy Stream-rec on: push: branches: [main] jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkoutv3 - name: Build and push Docker image run: | docker build -t stream-rec:${{ github.sha }} . docker push stream-rec:${{ github.sha }} - name: Deploy to server run: | ssh userserver cd /opt/stream-rec docker-compose pull docker-compose up -d 最佳实践总结生产环境部署清单✅ 使用Docker Compose管理服务生命周期✅ 配置持久化存储卷避免数据丢失✅ 设置合理的资源限制和健康检查✅ 启用日志轮转和监控告警✅ 定期备份配置和数据库✅ 实施安全策略如HTTPS和访问控制持续维护建议定期更新关注项目更新及时获取新功能和修复性能监控建立监控体系及时发现并解决问题数据备份制定备份策略确保录制数据安全社区参与关注项目社区分享使用经验和改进建议 开始你的直播录制之旅Stream-rec作为一个现代化的直播录制解决方案不仅提供了强大的核心功能还通过模块化设计和容器化部署为开发者提供了极大的灵活性。无论你是个人用户需要录制喜欢的直播内容还是企业用户需要构建大规模的录制系统Stream-rec都能满足你的需求。现在就开始部署你的Stream-rec实例体验智能化的直播录制管理吧通过Web界面轻松配置让系统自动为你捕捉每一个精彩瞬间。记住成功的部署只是开始持续优化和监控才能确保系统长期稳定运行。如果在使用过程中遇到任何问题可以参考项目文档或参与社区讨论与其他用户一起探索更多高级用法和最佳实践。立即行动克隆项目构建镜像启动服务开始你的自动化直播录制之旅【免费下载链接】stream-recAutomatic streaming record tool. Live stream and bullet comments recorder. 虎牙/抖音/斗鱼/Twitch/PandaTV/微博直播弹幕自动录制项目地址: https://gitcode.com/gh_mirrors/st/stream-rec创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考