BBDown 快速入门：命令行离线下载 B 站视频教程

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

BBDown 是一个命令行式哔哩哔哩下载器：给它一条视频链接，它能完成片源解析、拉流下载与合并成 MP4 的完整流程。照下面的步骤走完，你会装好这个工具，并得到第一条真正存到本地的视频。

开工前自检：环境前提清单

动手前先确认三件事，任何一项不满足就先补齐，后面所有步骤才不会卡住。

dotnet --version输出以 8 或更大数字开头的版本号，就可以继续。提示找不到命令，说明还没装 .NET SDK，从微软官方渠道装好再回来。ffmpeg 同理，装完后敲一下版本号，能打印出来即可。

dotnet tool 安装方式

BBDown 以 .NET 工具形式发布在 NuGet 上，一条命令装完：

dotnet tool install --global BBDown

装完立刻验证：

BBDown --version

终端打印出形如 x.y.z 的版本号，说明安装成功。日后要升级，执行dotnet tool update --global BBDown即可。

首次下载验证：最小示例

直接粘一条普通视频链接，不带任何额外参数：

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

终端先列出解析出的标题和可用的音视频流，随后多线程开拉。结束后程序自动调用 ffmpeg 把音视频合并。回当前目录看，出现一个以视频标题命名的完整 .mp4 文件，首次下载就算跑通了。

三个高频场景命令

如果你只想留声音：存档播客或纯音频素材时，画面流纯属浪费，加一个参数直接跳过：

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

产物只有音频文件，体积大幅缩小。--danmaku-only、--sub-only、--cover-only同理，只分别取弹幕、字幕或封面。

当你要把整季番剧或整门课程搬下来：-p负责选集，-p ALL全量，-p 1,2,10挑单集，-p 1-10取区间：

BBDown -p ALL "https://www.bilibili.com/bangumi/play/ss33073" --download-danmaku --delay-per-page 2

每集之间停 2 秒，既减轻服务器压力也降低触发风控的概率，弹幕同步存成 xml。习惯固定下来更好：在程序目录新建BBDown.config，把想默认生效的参数写进去，以后每次只贴链接：

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

文件名可用<ownerName>、<publishDate>、<res>等占位符自由组合。

如果你想把它挂成服务跑：BBDown 可以以服务器模式启动，对外暴露 HTTP 接口，从/add-task提交下载任务、从/get-tasks查询进度，再接个 Web 面板就能自建管理台：

BBDown serve -l http://0.0.0.0:12450

接口字段的具体说明见仓库内的 json-api-doc.md。

故障速查表

收尾：带走一条通用命令

一条命令装、一条命令下，整套离线缓存流程到此就位。下次要存视频，直接复制这行、换上自己的链接就能跑：

BBDown "你正在看的视频链接"

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