biliup

自动直播录制、投稿、twitch、ytb频道搬运工具。命令行投稿(B站)和视频下载工具，提供多种登录方式，支持多P。

️ 功能

提供 skill，让你的 Agent 成为 up 主: npx skills add biliup/biliup
开箱即用，多种安装方式，提供可视化 WebUi 界面
多主播录制/上传，24X7 无人值守运行，高自定义元信息
录制同时抓取弹幕，输出 XML 弹幕文件
作为自动化流程中的命令行工具封装使用

论坛：BBS

支持平台

内置 19 个直播平台解析，未匹配的地址会交给通用适配器（依赖本机的 yt-dlp / Streamlink）尝试处理。

平台	站点	弹幕
哔哩哔哩	`live.bilibili.com`、`b23.tv`	✅
抖音	`douyin.com`	✅
斗鱼	`douyu.com`	✅
虎牙	`huya.com`	✅
快手	`kuaishou.com`、`chenzhongtech.com`
AcFun	`acfun.cn`
网易 CC	`cc.163.com`
映客	`inke.cn`
猫耳 FM	`missevan.com`
KilaKila / 红豆 FM	`live.kilakila.cn`、`hongdoufm.com`
YY	`yy.com`
TTingLive	`ttinglive.com`
Twitch	`twitch.tv`（直播与录像）	✅
YouTube	`youtube.com`、`youtu.be`	✅
TwitCasting	`twitcasting.tv`	✅
niconico	`nicovideo.jp`
AfreecaTV	`afreecatv.com`
Bigo Live	`bigo.tv`
Picarto	`picarto.tv`
通用适配器	其他 `http(s)` 地址

更新日志

[!IMPORTANT]
Disclaimer / 免责声明

本项目仅供个人学习研究，不保证稳定性，不提供技术支持

使用本项目产生的一切后果由用户自行承担

禁止商业用途，请遵守版权及平台规定

This project is for personal learning and research purposes only

No stability guarantee or technical support provided

Users are solely responsible for any consequences of using this project

Commercial use is strictly prohibited

Please respect copyright and platform ToS

更新日志 »

使用文档

B 站命令行投稿工具，支持短信登录、账号密码登录、扫码登录、浏览器登录以及网页Cookie登录，并将登录后返回的 cookie 和 token 保存在 cookies.json 中，可用于其他项目。

下载 Release: biliupR
获取命令帮助 biliup --help
登录信息文件可用 -u/--user-cookie 指定，便于多账号切换

文档地址：https://biliup.github.io/biliup-rs

…

启动录制服务

启动web服务，默认端口19159

Usage: biliup server [OPTIONS]

Options:
  -b, --bind <BIND>            Specify bind address [default: 127.0.0.1]
  -p, --port <PORT>            Port to use [default: 19159]
      --auth                   开启登录密码认证
      --secure-session-cookie  为会话 Cookie 附加 Secure 属性。仅当通过 HTTPS 反向代理访问 Web UI 时开启； 直接通过 HTTP 远程访问时开启会导致浏览器丢弃登录态
  -c, --config <FILE>          使用 biliup 1.0.7 风格配置文件启动录制
  -h, --help                   Print help

[!IMPORTANT] 自 #1660 起，--bind 的默认值由 0.0.0.0 改为 127.0.0.1，即默认只监听本机，局域网/公网无法直接访问。如需从其他设备访问，请加上 --bind 0.0.0.0 --auth，详见下方「远程访问」一节。Docker 镜像已内置该参数，不受影响。

单独下载一场直播/视频，无需启动服务：

biliup download <URL> -o "./video/%Y-%m-%dT%H_%M_%S{title}" --split-time 1h

--split-size 与 --split-time 可按体积或时长自动分段，-o 支持 {title} 占位符与 strftime 时间格式。

使用文档 »

快速开始

Windows

下载 Release: bbup-app

Linux 或 macOS

安装 uv
安装：uv tool install biliup
启动：biliup server --auth
访问 WebUI：http://127.0.0.1:19159（默认只监听本机，远程访问见下方说明）

后台运行
1. nohup biliup server --auth &
2. 请查看参考

Termux

详见Wiki

[!NOTE] 默认下载器 stream-gears 由 Rust 实现，无需外部依赖。若配置 ffmpeg 下载器或使用后处理，需要本机安装 ffmpeg；YouTube、niconico 等平台与通用适配器则依赖 yt-dlp 或 streamlink。Docker 镜像已内置 ffmpeg。

远程访问（监听 0.0.0.0）

默认的 127.0.0.1 只允许本机访问。需要从其他设备访问时，显式指定 --bind 0.0.0.0 并开启 --auth：

biliup server --bind 0.0.0.0 --auth

首次打开 http://your-ip:19159 会引导设置管理员密码（用户名固定为 biliup），之后即可正常登录使用。

[!NOTE] 绑定非回环地址时必须同时开启 --auth，否则会拒绝启动，避免无认证的 Web API 被暴露：
refusing to expose the unauthenticated Web API on 0.0.0.0:19159; use a loopback bind address or enable --auth

[!WARNING] 将 Web UI 暴露到公网存在风险，建议仅在可信局域网内使用，或置于反向代理之后。首次访问即可设置管理员密码，请在启动后立即完成初始化，避免被他人抢先占用。若通过 HTTPS 反向代理访问，请加上 --secure-session-cookie；直接以 HTTP 远程访问时不要加，否则浏览器会丢弃登录态（见 #1669）。

Docker

镜像已内置 --bind 0.0.0.0 --auth，开箱即用，无需额外配置：

docker compose up -d

打开 http://your-ip:19159 设置管理员密码即可。录播与配置默认持久化在容器的 /opt 卷中。

[!IMPORTANT] 若要自定义 command，必须带上 --bind 0.0.0.0。容器内若监听 127.0.0.1，宿主机的端口映射无法转发进容器，Web UI 将完全无法访问。

边录边传（sync-downloader）

把 downloader 设为 sync-downloader 后，ffmpeg 会把直播流 remux 成 Matroska 写到 stdout，按 UPOS 分片一边录一边上传，每录满 file_size（默认 2.5 GB，向上对齐到 10 MiB）就作为一 P 追加到同一稿件。前提：

本机 PATH 中有 ffmpeg；HLS 流（B 站 bili_protocol = "hls_fmp4"）若装有 streamlink 会用它拉流再交给 ffmpeg，没有则由 ffmpeg 直拉。
主播必须绑定上传模板，且模板对应的 cookies 文件可用；uploader = "Noop" 或没有模板时不会录制，日志会给出 边录边传需要先为主播设定上传模板。
上传并发固定 3 线程，不受 threads、segment_time 控制。

downloader = "sync-downloader"
uploader = "bili_web"
file_size = 2621440000          # 每 P 大小，可按上传带宽调小
# sync_save_dir = "/data/sync"  # 可选：额外保留每 P 的本地副本

[streamers."某主播"]
url = ["https://live.bilibili.com/1234"]
title = "{streamer}%Y-%m-%d 直播录像"
tid = 171
user_cookie = "cookies.json"

行为说明：

录制期间每 P 会同时写入系统临时目录（$TMPDIR/biliup-sync/worker-<id>/）作为兜底；预传完整且校验一致时直接 complete，否则（直播提前结束、上传落后）按实际长度从临时文件重传。投稿确认后临时文件删除，设置了 sync_save_dir 的副本保留并交给 postprocessor。
停止/暂停/编辑主播只会结束当前分段，已录内容仍会上传并投稿；上传或投稿失败时保留有内容的分段文件并在日志中打印路径，可手动补传。
B 站直链约 1 小时过期。分段结束后拉不到数据时会立刻交回监控循环重新解析直链，并在同一稿件上继续追加分 P。
排查问题时留意 ERROR ... 下载流程出错 日志：会带上具体原因（cookies 文件路径、preupload 拒绝等），而不是静默退回落盘录制。

‍开发

架构概览

Rust后端 + 精简 Python 包 + Next.js前端的混合架构。

…

目录结构

路径	说明
`crates/biliup`	核心库：直播解析、下载器、B 站投稿与凭据管理
`crates/biliup-cli`	命令行与 Web 服务：REST API、WebUI 托管、录制调度
`crates/danmaku`	弹幕客户端：多平台协议解析与 XML 输出
`crates/stream-gears`	PyO3 绑定，暴露给 `python -m biliup`
`app`、`public`	Next.js WebUI 源码；`npm run build` 产物输出到 `out/` 并由后端内嵌
`biliup`	精简 Python 包：最小入口与可供外部调用的投稿库
`tauri-app`	桌面端外壳（实验性）

frontend

确保 Node.js 版本 ≥ 18.17（Next.js 14 要求）
安装依赖：npm i
启动开发服务器：npm run dev
访问：http://localhost:3000

Python

安装依赖 maturin dev
npm run build
启动 Biliup：python3 -m biliup

Rust-cli

npm run build
构建 cargo build --release --bin biliup
开发启动 BiliupR：cargo run

[!NOTE] biliup-cli 通过 rust-embed 内嵌前端产物目录 out/，因此在 cargo build / cargo test 之前必须先执行 npm run build，否则编译会因 out/ 不存在而失败。

测试

cargo test -p biliup -p biliup-cli -p danmaku

biliup

工具介绍

️ 功能

支持平台

更新日志

使用文档

快速开始

Windows

Linux 或 macOS

Termux

远程访问（监听 0.0.0.0）

Docker

边录边传（sync-downloader）

‍开发

架构概览

目录结构

frontend

Python

Rust-cli

测试

Credits

捐赠

⭐Stars

Issues· 0 开放

> 标签

> 工具信息

> 相关工具

biliup

工具介绍

️ 功能

支持平台

更新日志

使用文档

快速开始

Windows

Linux 或 macOS

Termux

远程访问（监听 0.0.0.0）

Docker

边录边传（sync-downloader）

‍开发

架构概览

目录结构

frontend

Python

Rust-cli

测试

Credits

捐赠

⭐Stars

Issues· 0 开放

> 标签

> 讨论区

> 工具信息

> 相关工具