全局设置
INFO
全局配置修改后必须重启 biliup 才能生效。无特殊需求不建议修改默认值。
下载器
stream-gears（默认）
- 默认下载器，无需安装 FFmpeg。
- 自动处理主播 PK 等导致的分辨率变化，防止视频花屏。
- 不支持 HLS 流（如 B站 APEX 分区），此类流需改用
streamlink。
streamlink
- HLS 多线程下载。
- 自动识别是否需要 HLS 模式，不支持的流将回退到 FFmpeg。
- 需要安装 FFmpeg。
ffmpeg
- 最通用的音视频下载工具，兼容性强。
- 需要安装 FFmpeg。
sync-downloader（边录边传）
- 流式视频上传技术，录制过程中实时上传。
- 直播结束后自动投稿送审。
- 极低资源占用：在官方基准条件下（具体直播平台、分辨率 / 码率、上传带宽、CPU 架构、测试版本与失败率以发布基准报告为准），可同时录制多个直播间。
sync-downloader为边录边传，录制过程中即开始上传，并非「零落盘」（仍需本地写入临时分段）。
WARNING
上述容量数字为特定基准下的参考值，不构成任何版本的性能承诺。实际并发数取决于你的码率、上传带宽与硬件；生产规划请以自己环境的压测为准，不要直接套用数字。
WARNING
强依赖稳定上传带宽，确保上传速率 ≥ 下载速率，否则可能内存溢出（OOM）。 并非所有平台都支持此功能，具体请自行测试。
mesio（Rust 原生管线）
- 进程内实现的 FLV / HLS 下载与修复管线，不依赖外部进程。
- 无需安装 FFmpeg 或 streamlink，部署更轻。
- 适合希望减少外部依赖、或外部下载器在本机表现不稳定的场景。
ytarchive（仅 YouTube Live）
- 专为 YouTube 直播设计的下载器。
- 支持从直播开始自动录制，无需等待开播。
- 需单独安装 ytarchive。
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（默认） | 自动选择最优线路 |
bldsa / cnbldsa | BLDSA 线路（常规 / 国内） |
andsa / atdsa | ANDSA 线路（海外） |
bda2 / cnbd / anbd / atbd | 百度线路（常规 / 国内 / 海外） |
tx / cntx / antx / attx | 腾讯云线路（常规 / 国内 / 海外） |
txa | 腾讯云备用线路 |
alia | 阿里云线路 |
estx / akbd | 其他线路 |
上表与 CLI
--line的可选值一致（命令行参考），区别只是全局配置额外接受AUTO。原文档中列出的bda、qn（七牛云）在当前版本的线路枚举中已不存在，请勿再使用。
上传线程池大小（pool2_size）
同时上传的最大任务数，默认 3。
单文件并发数（threads）
单个视频文件的分片并发上传数，默认 3。上传失败时建议从 1 开始逐渐增加。
上传重试限制（max_upload_limit）
上传失败后的最大重试次数，默认 8。
WARNING
截至本文撰写版本，该字段在后端上传逻辑中尚未被实际消费（在 WebUI / 配置接口中保存后不会生效）。请勿将其作为防重复上传或重试保护的依据；相关能力以当前版本源码与发布说明为准。
使用直播封面（use_live_cover）
开启后将自动下载直播间封面并用作投稿封面，默认关闭。
碎片过滤（filtering_threshold）
过滤因网络波动/主播断流导致的视频碎片，默认 20（单位 MB）。
下播延迟检测（delay）
检测到主播下播后延迟指定时间再次确认，避免提前结束导致分稿件。源码默认值为 300 秒（5 分钟）；请以当前版本 WebUI「空间配置 → 全局设置」中实际显示的值为准。
适用于一天多次开播的主播，根据其下播和再次开播的间隔设置。
直播事件检测间隔
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
截至本文撰写版本，该字段无法通过当前 WebUI「空间配置 → 全局设置」持久化（保存请求会被当前配置类型忽略，填写不会生效）。如需使用，请通过旧版 Python 路线或配置文件方式设置，并确认当前版本支持；不要假设在 WebUI 中填写后即生效。
WARNING
强依赖稳定上传带宽，确保上传速率 ≥ 下载速率，否则可能内存溢出（OOM）。