BBDown 快速上手指南：命令行一键下载 B 站视频，最高支持 8K 与杜比视界

BBDown 快速上手指南：命令行一键下载 B 站视频，最高支持 8K 与杜比视界

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

收藏了半年的 B 站视频，某天点开却只剩一行"该视频已失效"——这个场景，经历过的人应该都懂。BBDown 就是为这类时刻而生的：一款完全免费、开源的命令行式哔哩哔哩下载器，能把视频原封不动地存进你自己的硬盘，最高支持 8K、HDR、杜比视界和杜比全景声。没错，命令行，不靠网页、不靠在线工具，一条命令就能把视频"搬"回家。

BBDown 到底是什么？为什么命令行反而更省事

你可能会问：浏览器右键不就能存视频吗？能存的只是几十 MB 的"预览版"，真正的高码率源藏得很深，网页端根本碰不到。

再看看市面上那些"在线解析"网站：把视频链接粘贴进去，服务器帮你解析、再传回来。听起来方便，但你的观看记录、登录状态都要经过别人的服务器，画质还常常被压在 1080P 以下。BBDown 的思路完全反过来——所有解析都在本地完成，下载直接在命令行里跑，不经过任何第三方中转。

它的能力边界也足够宽：

• 番剧、课程、普通视频全覆盖，还支持合集、收藏夹和 UP 主个人空间
• 支持 8K / HDR / 杜比视界 / 杜比全景声，编码可选手动 AVC、HEVC、AV1
• 多分 P 自动下载，也能精准指定第几集
• 弹幕、字幕、封面、纯音频都可以单独提取

一句话总结：它把"B 站视频下载"这件事，从"找工具、碰运气"变成了"一条命令、稳定复现"。

人物视角：学生小林的第一单

先别急着背参数，我们跟着一位叫小林的用户走一遍完整流程，你会发现整个过程比想象中顺畅得多。

小林是个考研党，收藏了某位老师六十多集的数学课。他最大的痛点是：晚上图书馆没网，想离线复习却只能干瞪眼。他决定试试 BBDown。

第一步，安装

如果电脑里有 .NET 环境，安装只需要一条命令：

dotnet tool install --global BBDown

没有 .NET 环境也没关系，可以用项目提供的预编译版本，或者把仓库 clone 下来自行编译，仓库地址是 https://gitcode.com/gh_mirrors/bb/BBDown ，照着 README 操作即可。

第二步，跑通第一个下载

安装完成后，小林把视频链接丢进去：

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

工具会自动解析视频信息、列出可用的音视频流，然后开始多线程下载，下载完成后自动用 ffmpeg 把画面和声音合并成一个完整的 MP4。小林的第一个视频就这样安静地出现在当前目录里。

这就是 BBDown 的核心体验：你只负责给链接，剩下的事它包圆。整个过程不需要打开浏览器、不需要手动复制密钥、不需要任何二次操作。

第三步，批量拿下整个课程

单个视频当然不过瘾。小林发现这个课有六十多集，他用一个参数把全集拉了下来：

BBDown "课程链接" -p ALL

-p ALL表示下载全部分 P。如果只想下某几集，比如第 1、2、10 集，就写-p 1,2,10；想要一个连续区间，写-p 1-10。分 P 太多时终端会默认折叠列表，想看全貌加个--show-all就行。

小林还顺手开了弹幕下载和分集间隔：

BBDown "课程链接" -p ALL --download-danmaku --delay-per-page 2

--delay-per-page 2让每集之间停顿 2 秒，既不会给服务器太大压力，也避免触发风控。六十多集下完，小林把整个文件夹拷进平板，图书馆没网的日子从此不再是问题。

想要更多？试试这些进阶玩法

如果你也像小林一样用顺了手，下面几个能力值得探索。

只想留音频，拿来当播客或剪素材：

BBDown "视频链接" --audio-only

BBDown 会单独提取音频流，不想保留弹幕就再加一个--skip-subtitle，干净利落。

把 UP 主的全部作品备份下来：

BBDown "https://space.bilibili.com/UP主ID/video" --batch

个人空间、收藏夹、系列合集都在解析范围内，配合-p ALL可以一次性搬空整个主页，适合做素材库和个人媒体库的人。

用配置文件沉淀你的固定习惯：

在程序目录建一个BBDown.config，把常用参数写进去，之后每次运行都会自动读取。比如小林把文件名格式、下载间隔和弹幕开关都写进了配置：

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

以后他下载任何视频，只需要敲一个链接，其他偏好全部自动生效。文件名里想带什么信息，用<ownerName>、<publishDate>、<res>这类占位符自由组合即可。

给开发者：把下载变成 API 服务

如果你恰好会写点代码，BBDown 还能以服务器模式运行，对外提供 HTTP 接口：

BBDown serve -l http://0.0.0.0:12450

启动后你可以通过接口查询任务、提交新下载任务，甚至自己做一个小网页来管理下载队列。项目文档里有一份完整的 JSON API 说明，照着就能对接。

新手容易踩的三个坑

坑一：忘了装 ffmpeg。混流是 BBDown 的核心步骤，它需要依赖外部的 ffmpeg（或 MP4Box）来把音视频合并。如果你下载完发现只有零散的音视频文件、没有成品 MP4，八成是没装 ffmpeg。装上后也可以直接用--ffmpeg-path告诉它程序在哪。

坑二：大会员内容不登录就下载。高画质和付费内容需要账号权限。直接在命令行里扫码登录即可：

BBDown login

终端会弹出二维码，用 B 站 App 扫一下，后续下载会员内容就顺畅了。网页 cookie 也可以用-c "SESSDATA=..."手动指定。

坑三：把工具用在版权之外的地方。BBDown 官方反复强调，它仅供个人学习、研究和非商业用途。下载别人的课程、影视内容前，请确认自己拥有合法的使用权。工具是无辜的，用它的人要对自己负责。

现在，下载你的第一个视频

回到开头那个画面：那个让你心动的视频，与其赌它"永远不会被删"，不如现在花两分钟把它留在本地。

如果你已经装好 .NET，现在就可以打开终端输入：

dotnet tool install --global BBDown

然后把任意一个 B 站视频链接丢给它。等到 MP4 出现在当前目录的那一刻，你就拥有了一个随时能带走、不会失效的私人片库。8K 的清晰度、完整的弹幕、整齐的命名，都在这条命令后面等着你。

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