如何使用BBDown：哔哩哔哩视频下载器完整使用指南

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

BBDown 是一个基于 .NET 的命令行式哔哩哔哩视频下载器，覆盖普通视频、课程与番剧，支持多平台终端。它适合需要把课程录像保存在本地的学习者、需要 TV 端片源做二次剪辑的创作者，以及想批量建立本地视频库的用户。整体流程很短：安装工具、完成账号鉴权，再把视频链接交给命令行即可。

适用场景

• 把课程与讲座视频保存到本地，课程类内容常受平台源变更影响，下载后不再依赖原链接。
• 为二次创作获取片源，使用 TV 端解析接口可拿到更适合剪辑的高质量视频，再配合自定义命名整理成规范素材目录。
• 批量收集 UP 主空间、收藏夹与番剧合集，多 P 内容可按分 P 选择或整集合一次性下载。

BBDown 的安装步骤

本地需要先有 .NET 环境，然后用 dotnet tool 命令全局安装：

dotnet tool install --global BBDown

需要升级时，执行dotnet tool update --global BBDown即可。

WEB 与 TV 账号鉴权

下载会员专属内容要先完成账号鉴权。用哔哩哔哩 APP 扫码保存 WEB 端 cookie：

BBDown login

TV 端（云视听小电视）鉴权使用BBDown logintv。如果不想扫码，也可以直接用-c参数传入 cookie（形如-c "SESSDATA=..."），使用 TV 或 APP 接口时用-token参数传入 access_token。

完成第一个下载任务

鉴权完成后，把视频链接作为参数传入即可，文件默认保存在当前工作目录：

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

注意 BBDown 混流依赖外部程序：普通视频需要ffmpeg或mp4box，杜比视界要求 ffmpeg 5.0 以上版本。如果程序没有自动找到它们，用--ffmpeg-path或--mp4box-path指定可执行文件路径。

场景化进阶用法

BBDown 文件命名参数设置

单 P 视频默认以主标题<videoTitle>命名。想让文件名包含上传者、清晰度等信息，用-F参数组合内置变量：

BBDown -F "<ownerName>_<videoTitle>_<dfn>" "https://www.bilibili.com/video/BV1qt4y1X7TW"

多 P 视频用-M参数控制，默认结构是<videoTitle>/[P<pageNumberWithZero>]<pageTitle>的目录形式。可用变量有<bvid>、<res>、<videoCodecs>、<publishDate>等，完整列表可以直接看BBDown --help的输出。

BBDown 批量下载参数设置

多 P 视频用-p参数选择分 P，支持单个数字、逗号列表或区间，例如-p 10、-p 1,2,10、-p 1-10。下载整部番剧：

BBDown -p ALL "https://www.bilibili.com/bangumi/play/ss33073"

合集很长时，建议加--delay-per-page设置分 P 之间的间隔秒数，降低触发风控的概率；配合--save-archives-to-file可以把已下载记录写入本地文件，再次执行时跳过重复视频。

BBDown 服务器模式

把 BBDown 作为本地 HTTP 服务运行，可以从其他设备添加和查询下载任务：

BBDown serve -l http://0.0.0.0:12450

服务提供/add-task（POST，请求体只需要Url字段）和/get-tasks/（GET，返回运行中与已完成任务）等接口，字段细节见仓库内的 json-api-doc.md。该服务不支持 HTTPS，需要的话自行在前面挂反向代理。

常用参数写入配置文件

重复使用的参数可以写进配置文件，命令行就不用每次都输入。程序默认读取同目录下的BBDown.config，也可用--config-file指定其他文件。格式是参数占一行、参数值写在下一行，#开头为注释，例如把--file-pattern与它的值分两行写入即可固定输出命名格式。

常见问题

下载速度慢或经常中断？多线程下载默认开启，带宽仍打不满时可以用-aria2c参数调用 aria2c 下载，需要自备 aria2c 可执行文件并用--aria2c-path指定路径。

高清晰度或会员内容下不了？通常是鉴权缺失。网页端会员内容用-c传 cookie，TV/APP 端会员内容用-token传 access_token，或者先执行login、logintv扫码把凭证保存下来。

下载出来的文件名混乱、不好管理？用-F和-M重新定义单 P 与多 P 的文件名变量组合，再用--work-dir统一指定下载目录，两者配合就能形成固定的目录结构。

混流失败或合并后的文件无法播放？先确认已安装 ffmpeg 且版本够新，杜比视界必须 ffmpeg 5.0 以上；也可以改用--use-mp4box让程序调用 mp4box 混流。

注意事项

BBDown 由开发者声明仅供个人学习、研究和非商业性用途，相关声明见仓库 README.md。下载受版权保护的内容前请确认已获合法授权，下载物建议仅用于个人观看，不要二次传播或再分发。

写在最后

BBDown 更适合习惯命令行、下载目标明确的使用者。建议先按“安装、登录、单视频下载”三步跑通一次，再按需叠加命名变量、批量参数与服务器模式。

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