Bilirec

一个专为低配设备优化的高性能 Bilibili 直播录制后端。

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

交流与反馈： QQ 群 834229325，用于交流和问题反映。

• 功能特性
• 效能指标
• 快速开始
• 生态
• 文档
• 贡献与许可

• ✅ 开箱即用 — 零配置起步，运行后直接访问 Web 界面即可管理任务
• ✅ 多模式录制 — 手动开始录制，或订阅直播间自动开播录制
• ✅ 多格式支持 — HTTP-FLV / HLS-TS / HLS-fMP4
• ✅ 灵活录制时长 — 指定时长上限、定时停止或无限时长
• ✅ 开播即时通知 — Web Push / SSE 推送开播动态
• ✅ 自动分段轮转 — PK 或分辨率变更时自动切文件，减少花屏与损坏
• ✅ 多路并发录制 — 低配硬件上也能稳定多路同时录
• ✅ 故障自动恢复 — FLV 时间戳修复与断流重连，连接波动时尽量不中断
• ✅ 自动 MP4 转换 — 本地 FFmpeg 或 CloudConvert 云端转码
• ✅ 多端运行与接入 — RESTful API、bilirec-web（PWA）、bilirec-mobile（Android 内嵌后端）
• ✅ FRP 内网穿透 — 无公网 IP 也可外网访问管理界面与文件
• ✅ 文件管理与播放 — 列表浏览、批量删除、浏览器内 MP4 预览
• ✅ 账号登录与刷新 — 匿名 / 扫码 / Controller 模式，Cookie 自动刷新
• ✅ 低配与 microSD 优化 — 大块缓冲、序列化写入、跳过极短直播写盘；默认开启录製中定期清理旧文件缓存，压低容器监控内存

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

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

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

内存规划速查（默认 1080p）：

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

从 Releases 下载对应平台文件：

chmod +x bilirec-linux-amd64 && ./bilirec-linux-amd64
# Windows：双击 bilirec-windows.exe

# 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）。详细步骤见 快速开始。

• 官方客户端：bilirec-mobile
• 库接口与构建：make android → dist/android/<abi>/libbilirec.so
• 说明见 Android 指南 · Android 库接口

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