下载使用录播姬容器镜像

录播姬提供了命令行版的容器镜像，可以在任何支持 Docker 的平台上运行录播姬。录播姬的镜像支持 linux/amd64、linux/arm64 和 linux/arm/v7 三种架构。

镜像在 Docker Hub 和 GitHub Container Registry 上提供，两个镜像源的镜像版本是同步的，可以任选其一。GitHub Container Registry 上除了正式版以外还提供了开发版的镜像，一般情况下不建议使用开发版。

docker pull bililive/recorder:latest
docker pull ghcr.io/bililiverecorder/bililiverecorder:latest

录播姬的镜像 tag 遵循容器镜像版本管理惯例，每个版本可能对应多个 tag。latest 目前的最新正式版本。2 是 2.x.x 中的最新一个版本。2.0 是 2.0.x 中的最新一个版本。2.0.0 是固定的版本 2.0.0，不会变。

使用录播姬容器镜像

本文以 docker compose 和 docker 为例介绍如何使用录播姬容器镜像。

docker compose
docker cli

新建一个 docker-compose.yml 文件，内容参考如下：

version: "3.8"
services:
  recorder:
    image: bililive/recorder:latest
    restart: unless-stopped
    volumes:
      - type: bind
        source: # 在这里写宿主机保存录播的路径
        target: /rec
    ports:
      - "2356:2356"
      # 第一个 2356 是宿主机的端口，可以根据自己需求改动。
      # 第二个 2356 是容器内的端口，不要修改。
    environment:
      - BREC_HTTP_BASIC_USER=用户名
      - BREC_HTTP_BASIC_PASS=密码
      - UMASK=022
      # (高级参数，非必填)这个值用于控制镜像写出的文件权限，002为当前用户&当前用户组可读写，默认值022为当前用户可读写，其他用户只读
      - PUID=1000
      # (高级参数，非必填)这个值用于控制文件所有者，建议设置为宿主机的用户的UID或者和宿主机用户相同用户组的用户的UID
      - PGID=1000
      # (高级参数，非必填)这个值用于控制文件所有者所属的用户组，建议设置为宿主机的用户相同的用户组的GID

替换上面示例中的 source 为宿主机保存录播的路径，设置好管理用户名和密码，然后运行 docker compose up -d 即可启动。配置文件和录制的数据都会保存在容器内的 /rec 中。

更多 docker-compose.yml 的语法请参考 docker compose 官方文档。

docker run -d \
  --name bililive-recorder \
  -p 2356:2356 \
  -v /path/to/recordings:/rec \
  -e BREC_HTTP_BASIC_USER=用户名 \
  -e BREC_HTTP_BASIC_PASS=密码 \
  -e UMASK=022 \
  -e PUID=1000 \
  -e PGID=1000 \
  bililive/recorder:latest

替换上面示例中的 /path/to/recordings 为宿主机保存录播的路径，并修改传入的管理用户名密码。配置文件和录制的数据都会保存在容器内的 /rec 中。

更多 docker 命令行的用法请参考 docker 官方文档。

启动了容器之后在浏览器内访问对应的地址（如果是用默认端口运行在本机的话就是 http://localhost:2356）即可打开录播姬的管理页面。如果设置了密码的话会弹出 HTTP Basic 登录框，输入启动容器时设置的用户名和密码即可登录。

从 2.11.0 开始，如果没有设置用户名密码，录播姬检查请求的 IP、Header 等参数并拒绝疑似来源不是局域网的请求。如果你使用了带身份验证功能的反向代理、或使用域名访问内网服务等，可以通过设置参数 --http-open-access 或设置环境变量 BREC_HTTP_OPEN_ACCESS 为任意非空值来禁用这个限制。

根据需要修改 docker-compose.yml 文件中的 image 字段，拉取最新的镜像，再重新运行启动即可。

docker compose pull
docker compose up -d

更新 docker 容器需要先拉取新的镜像，然后停止并删除旧的容器，再启动新的容器。

# 拉取最新的镜像
docker pull bililive/recorder:latest

# 停止并删除旧的容器
docker stop bililive-recorder
docker rm bililive-recorder

docker run ... # 参考上面的 docker cli 新建容器的命令

反馈、建议和问题

如有问题可以通过 GitHub Issues、QQ 群 (689636812)、Discord Server 或发送邮件到 rec@danmuji.org 联系开发者。