CLI Reference

命令行参数详解 (CLI Reference)

本文档列出 BBDown 主下载命令的所有参数选项、语法规范及详细使用说明。

BBDown [选项] <URL或标识符>

<URL或标识符> 支持：

短选项	长选项	类型/默认值	说明
`-t`	`--use-tv-api`	Flag	使用 TV 端解析接口
`-a`	`--use-app-api`	Flag	使用 APP 端解析接口
	`--use-intl-api`	Flag	使用国际版 (东南亚/泰国等) 解析接口
`-I`	`--only-show-info`	Flag	仅解析并输出音视频流信息，不进行实际下载
`-i`	`--interactive`	Flag	交互式选择画质与编码流
`--show-all`	`--show-all`	Flag	展示所有分 P 标题与信息
`-p`	`--select-page`	String	分 P 选择表达式（如 `1,3,5-8,ALL,LAST`）
`-q`	`--dfn-priority`	String	画质优先级列表（逗号分隔）
`-e`	`--encoding-priority`	String	音视频编码优先级列表（逗号分隔）
`-d`	`--download-danmaku`	Flag (false)	开启弹幕下载
`-c`	`--cookie`	String	设置网页端 Cookie 字符串（含 SESSDATA 等）
	`--access-token`	String	设置 TV / APP 端 Access Token 鉴权凭据
`-F`	`--file-pattern`	String	自定义单 P 文件名模板
`-M`	`--multi-file-pattern`	String	自定义多 P 文件名模板
	`--config-file`	String	指定读取的本地配置文件路径（默认 `BBDown.config`）
	`--work-dir`	String	指定下载文件输出的工作目录
	`--debug`	Flag	开启详细调试日志输出

-t, --use-tv-api 使用云视听小电视（TV 端）接口解析。大 UP 主的 1080P/4K 源通常不带平台水印。需配置 TV 端 Token 或通过 BBDown logintv 登录才能获取高画质。
-a, --use-app-api 使用移动端 APP 接口解析。需配合 --access-token 或 BBDownApp.data 鉴权。
--use-intl-api 使用东南亚国际版接口，常用于解析海外专享或区域限制番剧（可配合 --area th/hk/tw 与 --host）。
-I, --only-show-info 仅展示可用流及分 P 列表，常用于脚本检测或手动挑选编码。
-i, --interactive 下载前在控制台输出可选的画质与音轨编号列表，由用户手动输入序号确定下载组合。
--hide-streams 控制台输出中隐藏详细的音视频流码率/编码表格，保持界面清爽。

-q, --dfn-priority <priority> 指定画质优先顺序，从左到右匹配，命中即止。示例：-q "8K 超高清, 1080P 高码率, HDR 真彩, 杜比视界, 1080P 高清"
-e, --encoding-priority <priority> 指定视频与音频编码优先顺序。
- 常用视频编码：hevc (H.265), av1 (AV1), avc (H.264)
- 常用音频编码：flac (无损), eac3 (杜比), m4a / aac
- 示例：-e "hevc,av1,avc,flac,eac3,m4a"
--video-ascending / --audio-ascending 视频/音频升序排序（优先选择体积较小/码率较低的流，适合移动流量或小存储环境）。

-p, --select-page <expression> 支持灵活的分 P 语法：
- -p 5：仅下载第 5 P
- -p 1,3,5：下载指定的多个分 P
- -p 1-10：下载第 1 至第 10 P
- -p 1-3,7,9-11：混合范围
- -p ALL：下载全部剧集/分 P
- -p LAST / -p LATEST：仅下载最新一 P
--video-only / --audio-only 仅下载视频轨或仅下载音频轨（下载后不进行混流合并）。
--danmaku-only / --cover-only / --sub-only 分别仅下载弹幕文件、封面图片或字幕文件。
--skip-mux 跳过混流步骤，保留原始下载的单独视频文件和音频文件。
--skip-subtitle / --skip-cover / --skip-ai 跳过外挂字幕、封面或 AI 生成字幕的下载。
--allow-preview 当下载未充电的充电专属视频时，默认会告警并终止（防止错误保存残缺片段）；加此参数则允许下载几分钟的试看片段，产出文件名将添加 [试看] 标识。

-d, --download-danmaku 开启弹幕下载，默认保存为 XML 格式。
--download-danmaku-formats <formats> 指定需下载的弹幕格式，支持 xml,protobuf 等（逗号分隔）。
--danmaku-filter <keywords> 过滤弹幕：若弹幕文本包含指定关键词（逗号分隔），则予以丢弃。
--danmaku-filter-user <midHashes> 过滤指定发送者 midHash 的弹幕。
--comments 同时抓取并导出视频的主楼和回复评论，保存为 JSON 文件。

--multi-thread 多线程并发分片下载（默认开启）。若需关闭请传 --multi-thread false。
--thread-segment-size <size> 多线程下载时的单个分片大小（MB，默认 20MB）。
--retry-count <count> 网络请求失败后的最大重试次数（默认 3 次）。
--retry-delay <milliseconds> 重试基础退避间隔（毫秒，默认 3000ms）。
--delay-per-page <seconds> 批量下载合集/多 P 时各分 P 之间的等待秒数，防止高频触发风控。
--muxer-timeout <minutes> 调用混流工具的最大等待时长（分钟，默认 30 分钟）。
--force-http 强制使用 HTTP 代替 HTTPS 进行流媒体下载（部分运营商网络在 HTTP 下速度更快）。
--insecure 跳过 SSL/TLS 证书有效性校验（仅建议在中间人抓包或自签代理测试时开启）。
--upos-host <host> 手动指定 CDN / UPOS 流媒体调度域名（如 upos-sz-mirrorcos.bilivideo.com）。
--save-archives-to-file 在工作目录记录已下载的视频 aid，重复运行同批次命令时自动跳过已存在的历史记录。
--notify-webhook <url> 下载完成后向指定 Webhook 发送 HTTP POST 结果通知。

_{BBDown Wiki · 由 aliveranme/BBDown 维护 · 基于 MIT 协议开源}