BBDown使用指南：B站视频下载的6个场景化实践

【免费下载链接】BBDownBilibili Downloader. 一个命令行式哔哩哔哩下载器.项目地址: https://gitcode.com/gh_mirrors/bb/BBDown

BBDown 是一个运行在 .NET 平台上的命令行式哔哩哔哩（B站）下载器，通过解析 B 站接口把视频、音频、弹幕、字幕保存为本地文件，适合需要用脚本批量完成 B 站视频下载的个人用户与自建工具使用者。

📦 一、项目定位与适用边界

BBDown 基于 .NET 开发，以 dotnet tool 形式发布，源码分为主程序与 BBDown.Core/ 解析核心两部分。它只对接 B 站接口，不提供图形界面，也不支持自动刷新 cookie。下表列出适用边界。

| 场景 | 是否适用 | 说明 | | 单视频与多分P | 适用 | 用 -p 选择分P | | 番剧/课程/合集/收藏夹批量 | 适用 | 支持 ep、cheese、mid、favId 前缀 | | 非 B 站平台视频 | 不适用 | 仅解析 B 站接口 | | 图形界面操作 | 不适用 | 纯命令行交互 |

🚀 二、从 0 到首次成功运行（命令行安装步骤）

先确认本机装有 .NET SDK，再用 dotnet tool 全局安装 BBDown，并用 --version 核对安装版本。

dotnet tool install --global BBDown BBDown --version

验证能正常解析而不实际下载，对已知视频执行 -info，输出可用的清晰度与编码信息：

BBDown -info "https://www.bilibili.com/video/BV1qt4y1X7TW"

🎬 三、典型场景实战

TV 接口无水印下载

网页接口的高清源对部分 UP 主带水印，可改用 TV 端解析：

BBDown -tv "https://www.bilibili.com/video/BV1qt4y1X7TW"

-tv 切换为 TV 端解析模式，粉丝量较大的 UP 主通常能拿到无水印片源；涉及 TV 端会员内容需先执行 logintv 登录或传 -token。

批量下载指定分P的方法

一个视频有多分 P、只想要其中几集时，用 -p 指定分P：

BBDown -p 1,2,10 "https://www.bilibili.com/video/BV1At41167aj"

-p 支持单个、逗号分隔的多个（1,2,10）与范围（3-5），也可写 ALL 或 LAST 表示全部或最后一集。

用配置文件固化批量任务参数

每次手输 -F、-p 等参数繁琐，可把常用参数写入程序同目录的 BBDown.config（未指定时默认读取该文件）：

--file-pattern <videoTitle>[<dfn>] --delay-per-page 2 --download-danmaku

配置项的参数写在下一行；命令行参数优先级高于配置文件，二者可叠加使用。

服务器模式接收远程任务

希望在常驻机器上集中管理下载时，以服务器模式启动：

BBDown serve -l http://0.0.0.0:12450

以 HTTP 服务器模式运行，POST /add-task 提交任务、GET /get-tasks/ 查询进度，默认监听 0.0.0.0:23333。

⚙️ 四、进阶配置

| 参数 | 作用 | 推荐值 | | -e, --encoding-priority | 视频编码选择优先级 | "hevc,av1,avc" | | -q, --dfn-priority | 画质选择优先级 | "1080P 高码率, HDR 真彩" | | --save-archives-to-file | 记录已下载视频用于跳过 | 开启 | | -mt, --multi-thread | 多线程下载 | 默认开启 | | -aria2, --use-aria2c | 调用 aria2c 下载 | 需要时开启 | | -F, --file-pattern | 自定义单P存储文件名 | " []" |

❓ 五、常见问题排查

现象一：混流步骤失败。原因：混流依赖外部程序 ffmpeg 或 mp4box，未安装。解法：安装 ffmpeg 或用 --use-mp4box 指定 mp4box；杜比视界需 ffmpeg 5.0 以上版本。

现象二：会员视频解析不到高清晰度。原因：未登录账号。解法：执行 BBDown login 扫码登录 WEB 账号，或用 -c "SESSDATA=..." 传入 cookie。

现象三：Linux 下登录报 Gdip 异常。原因：运行环境缺少图形相关依赖库。解法：安装对应系统图形库后重试。

现象四：下载速度慢。原因：默认替换为 PCDN 域名、单连接下载。解法：保持 -mt 多线程，或用 -aria2 调用 aria2c，并以 --upos-host 指定下载服务器。

六、使用边界与合规

BBDown 仅供个人学习、研究与非商业用途。用户需自行确认所下载内容已获得合法授权，并遵守相关法律法规，特别是与版权相关的条款；开发者不对因使用本工具产生的任何版权纠纷或法律责任承担责任。

BBDown 的核心能力集中在接口解析（BBDown.Core/Fetcher/）与下载混流逻辑（BBDown/）中，服务器模式接口详见 json-api-doc.md。建议先按场景一、二跑通单视频，再用配置文件固化批量流程。

【免费下载链接】BBDownBilibili Downloader. 一个命令行式哔哩哔哩下载器.项目地址: https://gitcode.com/gh_mirrors/bb/BBDown