biliup 工作原理与快速引导

biliup 把直播和本地视频推送到 B 站等平台，同时提供一个 WebUI 管理界面。下面先说明一次完整的处理流程，再带你跑通第一个录制任务。

一次处理经历哪些环节

biliup
工作流程

素材获取

直播链路本地链路

媒体预处理

FFmpeg 转码压缩封面、字幕处理文件完整性校验

B站鉴权

读取本地登录凭证凭证失效终止任务

分片上传调度

任务队列限流排队文件分片上传断点续传分片合并请求

稿件提交

填充投稿参数调用稿件审核接口

运行容错机制

录制断线重连接口报错自动重试全流程日志记录

任务收尾

记录上传状态可选自动归档本地视频

链路随来源切换：直播走「直播链路」，本地文件走「本地链路」；输出目标通常是 B站投稿，也可配置为只录制不上传。

下面以 Docker 部署为例，串起从安装到看到录制文件的完整路径。其他安装方式见安装部署。

启动服务并开启认证 运行 biliup server --auth。--auth 是开关，不接收密码；首次访问 WebUI 时注册管理员账号并设置密码。参考：Docker 安装指引
登录 B站账号 在 WebUI 中扫码或填入 Cookie 完成登录，登录状态保存在本地。参考：B站账号登录
添加主播 在 WebUI「录播管理」中填入直播间链接，保存后即开始监控。参考：WebUI 使用指南
等待录制与上传 开播后 biliup 自动录制，是否上传、转码或仅本地保存由全局设置决定。参考：全局配置
查看结果 在 WebUI「录播管理」查看进度与历史，文件默认存于 recordings/。