biliup

Appearance

CLI 命令行参考 ​

获取命令帮助：biliup --help

Upload video to bilibili.

Usage: biliup [OPTIONS] <COMMAND>

Commands:
  login      登录B站并保存登录信息
  renew      手动验证并刷新登录信息
  upload     上传视频
  append     对某稿件追加视频
  show       打印视频详情
  dump-flv   输出flv元数据
  download   下载视频
  server     启动web服务，默认端口19159
  list       列出所有已上传的视频
  comments   批量下载视频评论
  reply      回复视频评论
  help       Print this message or the help of the given subcommand(s)

Options:
  -p, --proxy <PROXY>              配置代理
  -u, --user-cookie <USER_COOKIE>  登录信息文件 [default: cookies.json]
      --rust-log <RUST_LOG>        日志级别（RUST_LOG 格式）[default: tower_http=debug,info]
  -h, --help                       Print help
  -V, --version                    Print version

INFO

-p、-u、--rust-log 是全局选项，必须放在子命令之前使用。例如：biliup -p http://proxy:8080 login

server — 启动录制服务 ​

这是最常用的命令，用于启动 WebUI 和录制/上传服务。

shell
biliup server [OPTIONS]
参数说明默认值
-b, --bind绑定地址。127.0.0.1 仅本机可访问，0.0.0.0 允许局域网 / 公网访问127.0.0.1
-p, --port端口号19159
--auth开启 WebUI 登录认证（布尔开关，不接收参数）关闭
--secure-session-cookie为会话 Cookie 附加 Secure 属性。仅当通过 HTTPS 反向代理访问时开启，直接 HTTP 远程访问时开启会导致浏览器丢弃登录态关闭
-c, --config使用 biliup 1.0.7 风格配置文件启动录制—
-h, --help打印帮助—

示例：

bash
# 基础启动（仅本机可访问 http://127.0.0.1:19159）
biliup server

# 开启认证（首次启动需在 WebUI 注册账号）
biliup server --auth

# 指定端口
biliup server --port 8080 --auth

# 允许其他设备访问（必须同时加 --auth，否则拒绝启动）
biliup server --bind 0.0.0.0 --auth

# HTTPS 反向代理后
biliup server --bind 0.0.0.0 --auth --secure-session-cookie

# 使用旧版 YAML 配置文件启动
biliup server --config /path/to/config.yaml

默认只监听本机

自 v1.2.3（#1660）起，--bind 的默认值由 0.0.0.0 改为 127.0.0.1。直接 biliup server 启动后，局域网或公网设备无法访问，这是有意为之的安全默认。

如果需要从其他设备访问，必须显式指定 --bind 0.0.0.0 并同时开启 --auth：

bash
biliup server --bind 0.0.0.0 --auth

若绑定了非本机地址却没有 --auth，服务会直接拒绝启动并提示 refusing to expose the unauthenticated Web API。

🐳 Docker 用户注意：镜像默认 CMD 已带 --bind 0.0.0.0 --auth，不写参数时正常。但一旦你显式写了 command: 或镜像名后的参数（覆盖默认 CMD），必须自己补上 --bind 0.0.0.0，否则容器内只监听回环地址，端口映射转不进去，WebUI 打不开。详见 Docker 部署。

TIP

--auth 是布尔开关，不接收 user:pass 参数。开启后首次访问 WebUI 会进入注册页面，需创建管理账号（用户名固定为 biliup）。详见 WebUI 认证。

login — 登录B站 ​

bash
biliup login

执行后通过交互式菜单选择登录方式（扫码 / 短信 / 账号密码），登录成功后自动保存 Cookie。

-p 和 -u 是全局选项，需放在子命令之前：biliup -p http://proxy:8080 login

renew — 刷新登录信息 ​

bash
biliup renew

手动验证并刷新 B站登录状态，延长 Cookie 有效期。

upload — 上传视频 ​

bash
biliup upload [OPTIONS] [VIDEO_PATH]...
参数类型说明默认值
<VIDEO_PATH>Vec<PathBuf>视频文件路径（可指定多个）必填（指定 --config 时可省略）
-c, --configPathBuf配置文件路径（指定后可从配置中读取投稿参数，省略视频路径）—
--submitapp/web/bcutandroid提交接口自动选择
-l, --lineUploadLine上传线路（见下方可选值）自动选择
--limitusize单视频文件最大并发上传数3
--copyrightu8版权：1=自制 2=转载1
--sourceString转载来源（copyright=2 时需填写）—
--tidu16投稿分区 ID（如 171=电子竞技）171
--coverString视频封面 URL—
--titleString视频标题—
--descString视频简介—
--dynamicString空间动态内容—
--tagString视频标签（逗号分隔）—
--dtimeu32延时发布时间戳（距提交需 >4h）—
--tid-v2u32新版分区 ID（不设置时不提交该字段）—
--interactiveu8互动视频：0=关闭 1=开启0
--mission-idu32活动 ID—
--dolbyu8杜比音效：0=关闭 1=开启0
--hiresu8Hi-Res 无损音质：0=关闭 1=开启0
--no-reprintu8转载权限：0=允许转载 1=禁止转载0
--charging-payu8开启充电：0=关闭 1=开启0
--is-only-selfu8仅自己可见—
--up-selection-reply开关开启精选评论（仅 --submit app 可用）关闭
--up-close-reply开关关闭评论（仅 --submit app 可用）关闭
--up-close-danmu开关关闭弹幕（仅 --submit app 可用）关闭
--extra-fieldsJSON 字符串自定义提交参数，按 JSON 追加到提交请求—

--line 可选值：

值说明
bldsa / cnbldsaBLDSA 线路（常规 / 国内）
andsa / atdsaANDSA 线路（海外）
bda2 / cnbd / anbd / atbd百度线路（常规 / 国内 / 海外）
tx / cntx / antx / attx腾讯云线路（常规 / 国内 / 海外）
txa腾讯云备用线路
alia阿里云线路
estx / akbd其他线路

--line 只接受上表中的具体线路名，不接受 AUTO；AUTO（自动选择）是全局配置 lines 的取值，详见全局设置。若某条线路上传失败，换一条重试即可。

示例：

bash
# 基础上传
biliup upload video.mp4

# 指定标题和标签
biliup upload --title "直播录像" --tag "直播,游戏" video.mp4

# 转载视频上传
biliup upload --copyright 2 --source "https://example.com" video.mp4

# 使用配置文件上传（可省略视频路径）
biliup upload -c config.yaml

append — 追加视频到已有稿件 ​

bash
biliup append [OPTIONS] --vid <VID> <VIDEO_PATH>...
参数类型说明默认值
--vidString目标稿件 AV 或 BV 号（必填）—
<VIDEO_PATH>Vec<PathBuf>视频文件路径（可指定多个）必填
--submitapp/web/bcutandroid提交接口自动选择
-l, --lineUploadLine上传线路（同 upload）自动选择
--limitusize单视频文件最大并发上传数3
Studio 字段—同 upload 命令的 --title/--tag/--desc 等—

示例：

bash
# 追加视频到 BV 稿件
biliup append --vid BV1xx411x7xx new_video.mp4

# 追加多个视频
biliup append --vid BV1xx411x7xx part1.mp4 part2.mp4

show — 查看视频详情 ​

bash
biliup show <VID>

打印指定稿件的在线详情（标题、播放量、状态等）。VID 为 AV 或 BV 号。

示例：

bash
biliup show BV1xx411x7xx
biliup show av12345678

download — 下载视频/直播 ​

bash
biliup download [OPTIONS] <URL>
参数说明默认值
<URL>直播间或视频 URL必填
-o, --output输出文件名模板（支持 {title} 变量和 strftime 格式）{title}
--split-size按大小分割视频（支持 K/M/G 后缀，如 4G）—
--split-time按时间分割视频（如 1h30m）—

示例：

bash
# 下载直播
biliup download https://live.bilibili.com/123456

# 指定输出文件名
biliup download -o "{title}_%Y%m%d" https://live.bilibili.com/123456

# 按大小分割
biliup download --split-size 4G https://live.bilibili.com/123456

list — 列出已上传视频 ​

bash
biliup list [OPTIONS]
参数说明默认值
--is-pubing只包含进行中的视频关闭
--pubed只包含已通过的视频关闭
--not-pubed只包含未通过的视频关闭
-f, --from-page从第几页开始获取1
-m, --max-pages最大获取页数全部

示例：

bash
# 列出所有视频
biliup list

# 只看已通过的视频，前 5 页
biliup list --pubed --max-pages 5

comments — 查看视频评论 ​

bash
biliup comments [OPTIONS] <VID>
参数说明默认值
<VID>稿件 AV 或 BV 号必填
--sort排序方式：0=按时间 2=按热度0
--pn页码1
--ps每页条数20

示例：

bash
# 下载视频评论
biliup comments BV1xx411x7xx

# 按热度排序，获取前 50 条
biliup comments --sort 2 --ps 50 BV1xx411x7xx

reply — 回复视频评论 ​

bash
biliup reply [OPTIONS] <VID> <RPID> <MESSAGE>

回复指定视频的评论。默认仅打印将要回复的内容，加 --execute 才实际发送。

参数说明
<VID>稿件 AV 或 BV 号
<RPID>评论 ID（rpid）
<MESSAGE>回复内容
--execute实际发送回复（不加则仅预览）

示例：

bash
# 预览回复内容
biliup reply BV1xx411x7xx 123456789 "感谢评论"

# 实际发送回复
biliup reply --execute BV1xx411x7xx 123456789 "感谢评论"

dump-flv — 输出 FLV 元数据 ​

bash
biliup dump-flv <FILE_NAME>

输出指定 FLV 文件的元数据信息（用于调试录制问题）。

示例：

bash
biliup dump-flv recording_20260101.flv

基于 Rust + Python + Next.js 构建

Copyright © biliup