全局设置
INFO
全局配置修改后必须重启 biliup 才能生效。无特殊需求不建议修改默认值。
下载器
stream-gears（默认）
- 默认下载器，无需安装 FFmpeg。
- 自动处理主播 PK 等导致的分辨率变化，防止视频花屏。
- 不支持 HLS 流（如 B站 APEX 分区），此类流需改用
streamlink。
streamlink
- HLS 多线程下载。
- 自动识别是否需要 HLS 模式，不支持的流将回退到 FFmpeg。
- 需要安装 FFmpeg。
ffmpeg
- 最通用的音视频下载工具，兼容性强。
- 需要安装 FFmpeg。
sync-downloader（边录边传）
- 流式视频上传技术，录制过程中实时上传。
- 直播结束后自动投稿送审。
- 极低资源占用：1核 0.5G 内存即可同时录制 10 个直播间，数据零落盘。
WARNING
强依赖稳定上传带宽，确保上传速率 ≥ 下载速率，否则可能内存溢出（OOM）。 并非所有平台都支持此功能，具体请自行测试。
ytarchive（仅 YouTube Live）
- 专为 YouTube 直播设计的下载器。
- 支持从直播开始自动录制，无需等待开播。
- 需单独安装 ytarchive。
ffmpeg（外部分段） / ffmpeg（内部分段）
- 使用 FFmpeg 进行分段录制，分为外部和内部分段两种模式。
- 适用于需要 FFmpeg 特定参数的场景。
yt-dlp
- 使用 yt-dlp 作为下载后端。
- 支持 yt-dlp 兼容的所有平台。
视频分段设置
分段大小（file_size）
按文件大小分段，单位 Byte。例：4294967296 ≈ 4GB。
分段时长（segment_time）
按录制时长分段，格式 00:00:00（时:分:秒）。
TIP
分段大小和分段时长可同时设置，先触发哪个就按哪个分段。
文件名模板（filename_prefix）
默认：{streamer}%Y-%m-%dT%H_%M_%S
示例输出：主播名2025-03-25T12_46_42
TIP
如果修改模板，必须包含 {streamer} 变量（放在第一位）和 %Y-%m-%d %H_%M_%S 时间戳。 额外支持 {title} 变量（直播标题），注意控制字符数不超过 B站限制。
分段后处理（segment_processor）
| 处理器 | 说明 |
|---|---|
remux:mp4 | 将录制文件重新封装为 MP4 格式（不重编码，速度快） |
| 自定义脚本 | 可指定 Python 脚本进行自定义处理（如弹幕压制） |
此功能需要额外配置，一般用户无需使用。详见开发者选项。
segment_processor_parallel
分段后处理是否并行执行，默认关闭。开启后多个分段文件的后处理将同时进行，可提高处理速度但会增加资源占用。
下载线程池大小（pool1_size）
同时录制的最大直播间数，默认 5。
TIP
如果添加了 6 个主播但只设置 5 个线程，会有一个主播不进行录制。
上传设置
上传插件（uploader）
| 值 | 说明 |
|---|---|
Noop（默认） | 不自动上传，仅录制 |
biliup-rs | 使用 Rust 引擎上传（推荐） |
bili_web | 使用 Python 引擎上传（兼容旧版） |
提交接口（submit_api）
| 值 | 说明 |
|---|---|
| 自动选择（默认） | 根据环境自动判断 |
web | Web 接口提交 |
app | App 接口提交 |
bcutandroid | BCut Android 接口提交 |
上传线路（lines）
| 值 | 说明 |
|---|---|
AUTO（默认） | 自动选择最优线路 |
alia | 阿里云线路 |
bda2 / bda | 百度线路 |
bldsa | BLDSA 线路 |
qn | 七牛云线路 |
tx / txa | 腾讯云线路 |
上传线程池大小（pool2_size）
同时上传的最大任务数，默认 3。
单文件并发数（threads）
单个视频文件的分片并发上传数，默认 3。上传失败时建议从 1 开始逐渐增加。
上传重试限制（max_upload_limit）
上传失败后的最大重试次数，默认 8。
使用直播封面（use_live_cover）
开启后将自动下载直播间封面并用作投稿封面，默认关闭。
碎片过滤（filtering_threshold）
过滤因网络波动/主播断流导致的视频碎片，默认 20（单位 MB）。
下播延迟检测（delay）
检测到主播下播后延迟指定时间再次确认，避免提前结束导致分稿件。默认 0 秒。
适用于一天多次开播的主播，根据其下播和再次开播的间隔设置。
直播事件检测间隔
event_loop_interval
整体事件循环的检测间隔，单位秒。例如设置为 10 表示每 10 秒检测一次所有主播。
checker_sleep
单个主播的检测间隔，单位秒，默认 10。与 event_loop_interval 不同，此值控制对单个主播的轮询频率。
日志级别
| 配置项 | 说明 | 可选值 |
|---|---|---|
LOGGING.root.level | ds_update.log 控制台日志级别 | DEBUG/INFO/WARNING/ERROR/CRITICAL |
loggers_level | download.log 文件日志级别 | 同上 |
边录边传额外保存目录（sync_save_dir）
仅 sync-downloader 模式生效。设置后，边录边传模式下会在指定目录额外保存一份录制文件，默认不保存。
WARNING
强依赖稳定上传带宽，确保上传速率 ≥ 下载速率，否则可能内存溢出（OOM）。