Skip to content
bilirecPublic

About

专为低配设备优化的 B 站直播录制与回放一体化工具,可在手机上运行。

Topics

Resources

Contributing

Stars

151 stars

Watchers

2 watching

Forks

Repository files navigation

Bilirec

专为低配设备优化的 B 站直播录制与回放一体化工具,可在手机上运行。

完整文档: www.bilirec.org/zh-cn/ · 常见问题

交流与反馈: BUG / 問題回報与功能建议请用 GitHub Issue 模板 提交;使用疑问先看 常见问题 或 QQ 群 834229325。

目录

功能特性

  • ✅ 开箱即用 — 零配置起步,运行后直接访问 Web 界面即可管理任务
  • ✅ 多模式录制 — 手动开始录制,或订阅直播间自动开播录制
  • ✅ 多格式支持 — HTTP-FLV / HLS-TS / HLS-fMP4
  • ✅ 灵活录制时长 — 指定时长上限、定时停止或无限时长
  • ✅ 开播即时通知 — Web Push / SSE 推送开播动态
  • ✅ 弹幕与互动记录 — 可在手动录制或房间自动录制时同时保存弹幕与礼物等互动记录
  • ✅ AI 字幕录制 — 从视频码流提取 B 站直播 AI 字幕,按分段保存同名 .vtt,回放时可开关字幕
  • ✅ 自动分段轮转 — PK 或分辨率变更时自动切文件,减少花屏与损坏
  • ✅ 多路并发录制 — 低配硬件上也能稳定多路同时录
  • ✅ 故障自动恢复 — FLV 时间戳修复与断流重连,连接波动时尽量不中断
  • ✅ 自动 MP4 转换 — 本地 FFmpeg 或 CloudConvert 云端转码
  • ✅ Webhook 事件 — 兼容录播姬 v2 格式,可对接 biliLive-tools 等做转封装、压制与上传
  • ✅ 监控与日志 — 可选独立 Prometheus 指标端口、VictoriaLogs/本地日志与 Grafana 仪表盘
  • ✅ 多端运行与接入 — RESTful API、bilirec-web(PWA)、bilirec-mobile(Android 内嵌后端)
  • ✅ FRP 内网穿透 — 无公网 IP 也可外网访问管理界面与文件
  • ✅ 文件管理与播放 — 列表浏览(支持排序与筛选)、下载、限时分享链接、内置播放器支持礼物特效与弹幕滚动回放;空间不足时可选自动删旧文件再录
  • ✅ 录制中实时预览 — 管理员可在录制进行时观看实时画面与弹幕,支持回看缓冲与回到直播
  • ✅ 账号登录与刷新 — 匿名 / 扫码 / Controller 模式,Cookie 自动刷新
  • ✅ 低配与 microSD 优化 — 大块缓冲、序列化写入、跳过极短直播写盘;默认开启录制中定期清理旧文件缓存,压低容器监控内存

配置详解、API、调优方案见 官方文档站。

效能指标

测试环境:树莓派 5B 16GB · Docker 容器(1 GB 内存限制)· 默认配置(含 DROP_FILE_PAGE_CACHE + 冷缓存释放)· 每路 1080p。

下表「内存峰值」为 Docker 等容器监控里显示的内存用量,改配置或版本后会有偏差。规划容器 limit 请仍用 内存占用估算(偏保守)。

并发路数 CPU 峰值占用 内存峰值占用
初始闲置 ~0.0% ~12 MB
1 路并发 ~2.5% ~85 MB
2 路并发 ~3.0% ~106 MB
3 路并发 ~4.0% ~135 MB
4 路并发 ~4.5% ~164 MB
5 路并发 ~5.3% ~193 MB
恢复闲置 ~0.0% ~54 MB

内存规划速查(默认 1080p):

路数 N 计算 预计总峰值
1 (43~50) + 1×49 约 92~99 MB
3 (43~50) + 3×49 约 190~197 MB
5 (43~50) + 5×49 约 288~295 MB

默认 4K 单路约 (43~50) + 1×122 → 165~172 MB。公式与变量说明见 内存占用估算。

快速开始

二进制

从 Releases 下载对应平台文件:

chmod +x bilirec-linux-amd64 && ./bilirec-linux-amd64
# Linux ARM64(树莓派等):chmod +x bilirec-linux-arm64 && ./bilirec-linux-arm64
# macOS Apple Silicon:chmod +x bilirec-darwin-arm64 && ./bilirec-darwin-arm64
# macOS Intel:chmod +x bilirec-darwin-amd64 && ./bilirec-darwin-amd64
# Windows:双击 bilirec-windows.exe

Docker

# Docker Hub
docker pull eric1008818/bilirec:latest

# GHCR(国内若 Docker Hub 拉取困难,可改用 GitHub Container Registry)
docker pull ghcr.io/bilirec/bilirec:latest

docker run -d --name bilirec -p 8080:8080 \
  -v /path/to/records:/app/records \
  -v /path/to/secrets:/app/secrets \
  -v /path/to/database:/app/database \
  eric1008818/bilirec:latest

docker run 时把镜像名换成 ghcr.io/bilirec/bilirec:latest 即可使用 GHCR。

启动后打开 app.bilirec.org,在登录页填写后端地址(默认 http://localhost:8080)。详细步骤见 快速开始。

Android(嵌入 App)

Important

请关闭电池优化并允许通知。华为 / 鸿蒙、OPPO / ColorOS、小米 / HyperOS、vivo / OriginOS 等大陆国产系统还可能在锁屏、切换应用或清理多任务时终止 Bilirec,造成录制中断;这类设备请按 国产手机后台设置 额外放行后台活动并锁定多任务卡片。

生态

项目 说明
bilirec-web Web 管理界面(PWA)
bilirec-mobile Android 客户端,可在手机内运行后端
bilirec-docs 官方文档站

文档

主题 链接
安装 guides/installation
快速开始 guides/quick-start
Docker guides/docker
录制直播间 guides/recording
文件管理 guides/file-management
配置与调优 configuration/overview
AI 字幕录制 configuration/subtitle
通知配置 configuration/notifications
树莓派 / microSD 默认 configuration/pi5-defaults
内存占用估算 configuration/memory-estimation
REST API api/overview(运行时根路径 / 另有 Swagger UI)
录制中预览 API api/preview
Webhook 对接 guides/webhook-integration
监控指标 configuration/metrics
Grafana 仪表盘 configuration/grafana-dashboards
常见问题 guides/faq
性能实测 guides/performance-benchmark

贡献与许可

请参阅 CONTRIBUTING.md 与项目许可证文件。

About

专为低配设备优化的 B 站直播录制与回放一体化工具,可在手机上运行。

Topics

Resources

Contributing

Stars

151 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages