acgnhiki/blrec

Bilibili Live Streaming Recorder (blrec) Docker镜像文档

概述

Bilibili Live Streaming Recorder (blrec) Docker镜像是基于开源项目 https://github.com/acgnhiki/blrec 构建的容器化解决方案，专门用于录制B站（bilibili）直播流。该镜像提供了便捷的部署方式，支持自动监控指定直播间状态、实时捕获直播流、生成标准化视频文件，并可通过配置实现自定义录制参数，满足用户对B站直播内容备份、存档的需求。

核心功能与特性

• 自动直播检测：实时监控指定B站直播间状态，开播时自动启动录制
• 多画质支持：可配置选择不同清晰度（如原画、高清、标清等）进行录制
• 视频格式标准化：默认输出MP4格式视频文件，包含完整元数据
• 直播信息捕获：自动记录直播标题、主播信息、开播时间等元数据
• 轻量级部署：基于Docker容器化，简化依赖管理，支持跨平台运行
• 灵活配置：通过环境变量或配置文件自定义录制参数

使用场景与适用范围

• B站UP主备份个人直播内容
• 粉丝存档喜爱主播的直播录像
• 内容创作者收集直播素材
• 需要长期监控并记录特定直播间内容的场景

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 已安装Docker Compose（可选，用于多容器管理）
• 网络环境可访问B站直播服务器

基本使用（docker run）

bash
docker run -d \
  --name blrec \
  -v /path/to/save/videos:/app/records \
  -e BLREC_ROOM_ID=123456 \
  -e BLREC_QUALITY=原画 \
  --restart unless-stopped \
  acgnhiki/blrec:latest

参数说明：

• -v /path/to/save/videos:/app/records：挂载宿主机目录用于保存录制的视频文件
• -e BLREC_ROOM_ID=123456：设置需要监控的B站直播间ID（必填）
• -e BLREC_QUALITY=原画：设置录制画质，可选值：原画、高清、标清等（默认：原画）
• --restart unless-stopped：容器退出时自动重启（推荐配置）

Docker Compose配置

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  blrec:
    image: acgnhiki/blrec:latest
    container_name: blrec
    volumes:
      - ./records:/app/records  # 当前目录下的records文件夹用于存储视频
    environment:
      - BLREC_ROOM_ID=123456    # 替换为目标直播间ID
      - BLREC_QUALITY=高清      # 录制画质
      - BLREC_OUTPUT_FORMAT=mp4 # 输出视频格式（默认mp4）
      - BLREC_AUTO_DELETE=false # 是否自动删除过期录像（默认false）
    restart: unless-stopped

启动容器：

bash
docker-compose up -d

配置参数详解

查看录制状态与日志

查看容器日志：

bash
docker logs -f blrec

查看已录制文件：

bash
# 进入容器内查看
docker exec -it blrec ls /app/records

# 或直接访问宿主机挂载目录
ls /path/to/save/videos

注意事项

1. 确保宿主机挂载目录有足够存储空间，直播录制文件体积较大
2. 网络稳定性会影响录制质量，建议在网络条件良好的环境下使用
3. 录制内容需遵守B站用户协议及相关******，不得用于商业用途或侵犯他人权益
4. 如需更复杂的配置（如多房间监控、自定义转码参数等），可通过挂载配置文件实现，详情参考 https://github.com/acgnhiki/blrec

参考链接

• 项目GitHub主页：https://github.com/acgnhiki/blrec
• Docker镜像仓库：https://hub.docker.com/r/acgnhiki/blrec