用录播姬录制 mikufans 直播安装、首次录制与文件修复指南【免费下载链接】BililiveRecorder录播姬 | mikufans 生放送录制项目地址: https://gitcode.com/gh_mirrors/bi/BililiveRecorder录播姬BililiveRecorder是一个开源的 mikufans 直播录制工具把房间号交给它它负责监控开播、自动录制、保存文件还能修复录坏的录像。本文按 装好 → 第一次录制 → 故障处理 → 多房间 → 配置 的顺序写所有操作都针对录播姬本身照着做就能跑起来。它到底是什么录播姬是一个开源的 mikufans 直播录制工具面向需要长期保存直播内容的个人用户。核心能力监控房间开播自动开始录制同时录制多个直播间修复直播流造成的文件损坏录制弹幕事后可合并进视频桌面、命令行、Docker 三种方式部署装好它桌面版去官网 rec.danmuji.org 下载 Windows 安装包双击安装即可带自动更新。适合平时在自己电脑前用的场景。命令行从仓库 releases 页下载对应平台的压缩包解压就是可执行文件下面统一写成 brec它就是录播姬的命令行版。适合服务器挂机和写脚本。Dockerdocker run -d --name brec -p 2356:2356 -v /你的路径:/rec bililive/recorder镜像叫 bililive/recorder/rec 是工作目录2356 是 Web 界面端口。环境适用场景安装命令桌面版自己电脑随时看官网下载安装包命令行服务器、脚本化releases 下载可执行文件Docker长期挂机docker run -p 2356:2356 -v 目录:/rec bililive/recorder装好验证命令行版执行 brec --help 能看到 run、tool 等子命令Docker 版在浏览器打开 http://localhost:2356 能看到网页界面说明装对了。第一次录制按这个顺序走一遍第一次就能录出文件以桌面版为例加房间点加号输入房间号贴直播间链接也行录播姬会解析出房间号。设参数把该房间的 AutoRecord 设为 true开播才会自动录。等开播录播姬每 180 秒查一次房间状态开播后开始写文件。停播主播下播后录播姬自动收尾保存手动停就在房间卡片上操作。找文件文件在工作目录下默认命名是房间号-主播名/录制-房间号-时间戳-标题.flv。第一次要动的参数就这几个参数类别填什么为什么工作目录必改空间够的目录文件都存这里AutoRecord必改true开播自动录画质建议默认 avc10000,hevc100001080P 优先HEVC 兜底弹幕建议要就 true默认不录弹幕切割建议默认 0 禁用一场直播一个文件 文件坏了、录制断了怎么处理先说原理。mikufans 直播服务器偶尔会重发数据包、插填充数据或让时间戳乱跳直接落盘的录像可能打不开。录播姬收流时过一套处理规则边收边修重复的块去掉、填充数据删掉、时间戳对齐再写盘。这套规则也以 tool fix 命令开放出来可以修以前录的坏文件。具体场景场景录到一半断流。现象日志出现断开、界面显示重连中。动作不用动录播姬每 6 秒重连一次续写同一个文件。场景录像打不开或播一半卡住。现象播放器报错、花屏。动作跑修复命令输出一个新文件brec tool fix input.flv output.flv场景不确定文件坏没坏。现象没报错但心里没底。动作跑 brec tool analyze input.flv看结构检查和缺失数据报告。场景弹幕跟视频对不上。现象多段弹幕时间不连续。动作先 brec tool danmaku-start-time 查各段起点时间再用 brec tool danmaku-merge 合成一份。场景开播了但一直没文件。现象日志只有周期检查记录。动作核对房间号、确认 AutoRecord 是 true等满一个 180 秒检查周期。同时录多个房间房间数没有写死的上限录播姬把每个房间当独立任务跑独立的重连、独立的缓冲、独立的文件一个房间断流不影响别人。实际上限由带宽、磁盘和 CPU 决定。标准模式不做转码只把 FLV 流原样写盘CPU 开销主要来自流处理规则和文件写入。按 1080P约 2.5~4 Mbps 下行、1~1.5 GB/小时写入估经验值如下房间数CPU 参考磁盘/小时建议设什么3单核 10% 左右3~5 GB用默认配置10单核 30%~40%10~15 GB开按大小切割CuttingNumber 102430双核 50% 以上30~45 GB下行带宽留 120 Mbps 余量画质降到 720P资源分配没有动态调度几路房间就是几份带宽同时跑。想加房间前先算下行带宽房间数 × 单路码率 ≤ 带宽的 70%。不重要的房间在房间级配置里单独降画质比全局降档划算。配置参考CLI 和桌面版共用一套 config.json字段是 PascalCase完整定义见仓库根目录的 configV3.schema.json。必须配的WorkDirectory填一个绝对路径。录制文件全部存这里不填就用程序当前目录。rooms至少一项每项一个 RoomId。不填房间录播姬没活干。AutoRecordtrue。不打开的话开播不会自动录得手动点。建议配的FileNameRecordTemplate改文件命名支持 {{ roomId }}、{{ name }}、{{ title }} 等变量。RecordingQuality画质候选列表逗号分隔按顺序尝试低档位兜底。CuttingMode 与 CuttingNumber1 按分钟切、2 按 MB 切数值就是分段大小默认 100。RecordDanmakutrue 录弹幕SuperChat、上船等子项各自独立开关。TimingCheckInterval开播检查间隔单位秒默认 180调小更准时但请求更密。进阶项更多字段在 BililiveRecorder.Core/Config/V3/ 里录播姬的 UserScript 还支持用 JS 脚本按房间改行为具体字段看官方文档。配置示例{ version: 3, global: { WorkDirectory: D:/rec, RecordDanmaku: true }, rooms: [ { RoomId: 123456, AutoRecord: true } ] }进阶与扩展命令行内置的工具箱直接对文件操作brec tool analyze 文件 —— 检查结构报告缺失数据brec tool fix 输入 输出 —— 修复损坏的原始 FLVbrec tool export 输入 输出 —— 导出流元信息为 xml 或 zipbrec tool danmaku-merge 输出 输入… —— 合并多段弹幕brec tool danmaku-start-time 输入… —— 查各段弹幕起点时间Web 界面和脚本brec run 加 --bind 参数会同时起一个 Web 服务端口默认 2356可以在网页里加房间、看日志、下载文件。配置里的 UserScript 字段能写 JS 脚本读取房间信息、调用 .NET 方法用来做录制前后的自定义动作。brec run --bind http://127.0.0.1:2356 D:/rec遇到问题先看官网教程rec.danmuji.org和仓库 Issue 区同类问题大多有人踩过。避坑清单误区拿 FFmpeg 录的坏文件去 tool fix 修。→正确做法修复只认直播服务器的原始 FLVFFmpeg 录过或转码过的文件修不了要修就先用录播姬录。误区以为弹幕默认就录。→正确做法RecordDanmaku 默认 false要弹幕先打开。误区画质只写最高的 avc20000。→正确做法画质是候选列表写成 avc20000,avc10000,avc4000主播没开 60P 时自动降档录。误区开播后马上找不到文件就认定录播姬坏了。→正确做法状态检查周期默认 180 秒开播到开录之间最多差一个周期。误区Docker 直接跑不挂 /rec。→正确做法-v 把 /rec 映射到宿主机目录否则容器一删录像全丢。误区一断流就去调重连、看门狗超时参数。→正确做法默认 6 秒重连、10 秒看门狗基本够用先查官方 Wiki 和 Issue 区别盲调参数。录播姬仓库地址是 gitcode.com 上的 gh_mirrors/bi/BililiveRecorder。从默认配置跑起来遇到具体问题回本文对应章节查。【免费下载链接】BililiveRecorder录播姬 | mikufans 生放送录制项目地址: https://gitcode.com/gh_mirrors/bi/BililiveRecorder创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 用录播姬录制 mikufans 直播：安装、首次录制与文件修复指南
用录播姬录制 mikufans 直播安装、首次录制与文件修复指南【免费下载链接】BililiveRecorder录播姬 | mikufans 生放送录制项目地址: https://gitcode.com/gh_mirrors/bi/BililiveRecorder录播姬BililiveRecorder是一个开源的 mikufans 直播录制工具把房间号交给它它负责监控开播、自动录制、保存文件还能修复录坏的录像。本文按 装好 → 第一次录制 → 故障处理 → 多房间 → 配置 的顺序写所有操作都针对录播姬本身照着做就能跑起来。它到底是什么录播姬是一个开源的 mikufans 直播录制工具面向需要长期保存直播内容的个人用户。核心能力监控房间开播自动开始录制同时录制多个直播间修复直播流造成的文件损坏录制弹幕事后可合并进视频桌面、命令行、Docker 三种方式部署装好它桌面版去官网 rec.danmuji.org 下载 Windows 安装包双击安装即可带自动更新。适合平时在自己电脑前用的场景。命令行从仓库 releases 页下载对应平台的压缩包解压就是可执行文件下面统一写成 brec它就是录播姬的命令行版。适合服务器挂机和写脚本。Dockerdocker run -d --name brec -p 2356:2356 -v /你的路径:/rec bililive/recorder镜像叫 bililive/recorder/rec 是工作目录2356 是 Web 界面端口。环境适用场景安装命令桌面版自己电脑随时看官网下载安装包命令行服务器、脚本化releases 下载可执行文件Docker长期挂机docker run -p 2356:2356 -v 目录:/rec bililive/recorder装好验证命令行版执行 brec --help 能看到 run、tool 等子命令Docker 版在浏览器打开 http://localhost:2356 能看到网页界面说明装对了。第一次录制按这个顺序走一遍第一次就能录出文件以桌面版为例加房间点加号输入房间号贴直播间链接也行录播姬会解析出房间号。设参数把该房间的 AutoRecord 设为 true开播才会自动录。等开播录播姬每 180 秒查一次房间状态开播后开始写文件。停播主播下播后录播姬自动收尾保存手动停就在房间卡片上操作。找文件文件在工作目录下默认命名是房间号-主播名/录制-房间号-时间戳-标题.flv。第一次要动的参数就这几个参数类别填什么为什么工作目录必改空间够的目录文件都存这里AutoRecord必改true开播自动录画质建议默认 avc10000,hevc100001080P 优先HEVC 兜底弹幕建议要就 true默认不录弹幕切割建议默认 0 禁用一场直播一个文件 文件坏了、录制断了怎么处理先说原理。mikufans 直播服务器偶尔会重发数据包、插填充数据或让时间戳乱跳直接落盘的录像可能打不开。录播姬收流时过一套处理规则边收边修重复的块去掉、填充数据删掉、时间戳对齐再写盘。这套规则也以 tool fix 命令开放出来可以修以前录的坏文件。具体场景场景录到一半断流。现象日志出现断开、界面显示重连中。动作不用动录播姬每 6 秒重连一次续写同一个文件。场景录像打不开或播一半卡住。现象播放器报错、花屏。动作跑修复命令输出一个新文件brec tool fix input.flv output.flv场景不确定文件坏没坏。现象没报错但心里没底。动作跑 brec tool analyze input.flv看结构检查和缺失数据报告。场景弹幕跟视频对不上。现象多段弹幕时间不连续。动作先 brec tool danmaku-start-time 查各段起点时间再用 brec tool danmaku-merge 合成一份。场景开播了但一直没文件。现象日志只有周期检查记录。动作核对房间号、确认 AutoRecord 是 true等满一个 180 秒检查周期。同时录多个房间房间数没有写死的上限录播姬把每个房间当独立任务跑独立的重连、独立的缓冲、独立的文件一个房间断流不影响别人。实际上限由带宽、磁盘和 CPU 决定。标准模式不做转码只把 FLV 流原样写盘CPU 开销主要来自流处理规则和文件写入。按 1080P约 2.5~4 Mbps 下行、1~1.5 GB/小时写入估经验值如下房间数CPU 参考磁盘/小时建议设什么3单核 10% 左右3~5 GB用默认配置10单核 30%~40%10~15 GB开按大小切割CuttingNumber 102430双核 50% 以上30~45 GB下行带宽留 120 Mbps 余量画质降到 720P资源分配没有动态调度几路房间就是几份带宽同时跑。想加房间前先算下行带宽房间数 × 单路码率 ≤ 带宽的 70%。不重要的房间在房间级配置里单独降画质比全局降档划算。配置参考CLI 和桌面版共用一套 config.json字段是 PascalCase完整定义见仓库根目录的 configV3.schema.json。必须配的WorkDirectory填一个绝对路径。录制文件全部存这里不填就用程序当前目录。rooms至少一项每项一个 RoomId。不填房间录播姬没活干。AutoRecordtrue。不打开的话开播不会自动录得手动点。建议配的FileNameRecordTemplate改文件命名支持 {{ roomId }}、{{ name }}、{{ title }} 等变量。RecordingQuality画质候选列表逗号分隔按顺序尝试低档位兜底。CuttingMode 与 CuttingNumber1 按分钟切、2 按 MB 切数值就是分段大小默认 100。RecordDanmakutrue 录弹幕SuperChat、上船等子项各自独立开关。TimingCheckInterval开播检查间隔单位秒默认 180调小更准时但请求更密。进阶项更多字段在 BililiveRecorder.Core/Config/V3/ 里录播姬的 UserScript 还支持用 JS 脚本按房间改行为具体字段看官方文档。配置示例{ version: 3, global: { WorkDirectory: D:/rec, RecordDanmaku: true }, rooms: [ { RoomId: 123456, AutoRecord: true } ] }进阶与扩展命令行内置的工具箱直接对文件操作brec tool analyze 文件 —— 检查结构报告缺失数据brec tool fix 输入 输出 —— 修复损坏的原始 FLVbrec tool export 输入 输出 —— 导出流元信息为 xml 或 zipbrec tool danmaku-merge 输出 输入… —— 合并多段弹幕brec tool danmaku-start-time 输入… —— 查各段弹幕起点时间Web 界面和脚本brec run 加 --bind 参数会同时起一个 Web 服务端口默认 2356可以在网页里加房间、看日志、下载文件。配置里的 UserScript 字段能写 JS 脚本读取房间信息、调用 .NET 方法用来做录制前后的自定义动作。brec run --bind http://127.0.0.1:2356 D:/rec遇到问题先看官网教程rec.danmuji.org和仓库 Issue 区同类问题大多有人踩过。避坑清单误区拿 FFmpeg 录的坏文件去 tool fix 修。→正确做法修复只认直播服务器的原始 FLVFFmpeg 录过或转码过的文件修不了要修就先用录播姬录。误区以为弹幕默认就录。→正确做法RecordDanmaku 默认 false要弹幕先打开。误区画质只写最高的 avc20000。→正确做法画质是候选列表写成 avc20000,avc10000,avc4000主播没开 60P 时自动降档录。误区开播后马上找不到文件就认定录播姬坏了。→正确做法状态检查周期默认 180 秒开播到开录之间最多差一个周期。误区Docker 直接跑不挂 /rec。→正确做法-v 把 /rec 映射到宿主机目录否则容器一删录像全丢。误区一断流就去调重连、看门狗超时参数。→正确做法默认 6 秒重连、10 秒看门狗基本够用先查官方 Wiki 和 Issue 区别盲调参数。录播姬仓库地址是 gitcode.com 上的 gh_mirrors/bi/BililiveRecorder。从默认配置跑起来遇到具体问题回本文对应章节查。【免费下载链接】BililiveRecorder录播姬 | mikufans 生放送录制项目地址: https://gitcode.com/gh_mirrors/bi/BililiveRecorder创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考