跳转到内容

下载使用命令行版

录播姬命令行版是跨平台的,可以在 Windows、Linux、MacOS 上运行。命令行版提供了 HTTP API 和网页管理界面,可以在浏览器里启停录制、修改设置。录播姬命令行版比桌面版使用的 CPU、内存更少。

你可以在录播姬的 GitHub Release 页面下载到录播姬命令行版。

带有 any 字样的压缩包内不含 .NET 运行时,需要自行安装运行时,压缩包文件更小。其他压缩包内已经自带了 .NET 运行时。

操作系统架构下载链接备注
N/AN/Aany.zip需要自行安装 .NET 运行时
Linuxx64linux-x64.zip在服务器上运行一般选这个
Linuxarm32linux-arm.zip
Linuxarm64linux-arm64.zip
Windowsx64win-x64.zip
macOSx64osx-x64.zip
macOSarm64osx-arm64.zip

使用录播姬命令行版

Windows 上可执行文件名为 BililiveRecorder.Cli.exe,Linux 和 macOS 上可执行文件名为 BililiveRecorder.Cli,不自带运行时的 any 版的入口点是 dotnet BililiveRecorder.Cli.dll

首先检查录播姬是否能正常运行:

Terminal window
./BililiveRecorder.Cli --version

如果没有问题的话,会输出录播姬的版本号。

如果提示没有执行权限,可以使用 chmod 命令添加执行权限:

Terminal window
chmod +x ./BililiveRecorder.Cli

为了后续文档的简洁,从这里开始把 BililiveRecorder.Cli 称为 brec

以下设置 alias 的命令仅为示意,你可以不操作、直接把所有文档中的 brec 替换为 ./BililiveRecorder.Cli 即可。

Terminal window
alias brec="./BililiveRecorder.Cli"

启动录播姬

在运行录播姬之前需要先选择一个保存配置文件和录制的文件的工作目录。建好目录后,启动录播姬:

Terminal window
brec run --bind "http://localhost:2356" "工作目录"

这里的 --bind 参数指定了录播姬的 HTTP API 监听地址,可以在浏览器里管理录播姬。如果不指定 --bind 参数就不会启动 HTTP 服务,无法在浏览器里管理录播姬。

如果需要允许从其他机器访问录播姬,可以使用下面的命令:

Terminal window
export BREC_HTTP_BASIC_USER="用户名"
export BREC_HTTP_BASIC_PASS="密码"
brec run --bind "http://*:2356" "工作目录"

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

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

停止录播姬

Ctrl + C (即发送 SIGINT) 退出录播姬,录播姬退出时会先停止当前正在进行的录播并保存配置。

在 Windows 上直接点击命令行窗口右上角的关闭按钮或者在所有系统上通过任何方式强制结束录播姬进程可能会导致配置文件不被保存、正在录制的弹幕文件不完整等问题。

更新录播姬命令行版

手动下载新版本的压缩包解压到一个新位置,然后使用相同的工作目录启动录播姬即可。

反馈、建议和问题

如有问题可以通过 GitHub IssuesQQ 群 (689636812)Discord Server发送邮件到 [email protected] 联系开发者。