
BBDown 完整使用指南免费开源的哔哩哔哩命令行下载器三步上手到批量自动化【免费下载链接】BBDownBilibili Downloader. 一个命令行式哔哩哔哩下载器.项目地址: https://gitcode.com/gh_mirrors/bb/BBDown你是不是也遇到过这样的时刻刷到一个很棒的课程或纪录片想缓存下来慢慢看却发现 B 站 App 没有离线缓存出差路上网络信号差视频转圈转到怀疑人生辛苦整理的收藏夹想一次性归档到本地却无从下手。今天要介绍的 BBDown就是为解决这些痛点而生的免费开源命令行哔哩哔哩下载器。它没有花哨的图形界面靠几条命令就能把视频、弹幕、字幕一并带回家而且完全免费、跨平台。接下来我会用一个完整的实战视角带你从零开始装好它、跑通第一次下载再逐步解锁批量自动化等进阶玩法。先搞清一件事BBDown 到底帮你解决了什么很多下载工具只能抓普通视频遇到番剧、课程、合集就无能为力。BBDown 不一样它的核心能力是解析和下载 B 站几乎全部内容类型内容类型支持情况说明普通视频✅UP 主投稿网页 / TV / APP 三种接口番剧 / 影视✅支持ss/ep选集批量下载课程✅B 站课堂内容合集 / 收藏夹 / 个人空间✅一整个列表批量拉取弹幕 / 字幕 / 封面✅可单独下载或随视频附带更关键的是它支持8K、HDR、杜比视界等高清规格还默认启用多线程下载。简单说凡是你能在网页上看到的它大多都能帮你离线保存。三步完成安装环境、工具、验证第 1 步确认 .NET 环境BBDown 基于 .NET 开发当前版本构建在 .NET 9 之上建议安装较新的 .NET SDK6.0 及以上均可。在终端里敲dotnet --version如果提示找不到命令先去官网装好 .NET SDK 再回来这一步是地基。第 2 步安装 BBDown 本体BBDown 已发布为 .NET 全局工具一条命令装完dotnet tool install --global BBDown以后想升级也很简单dotnet tool update --global BBDown第 3 步备好混流工具关键BBDown 下载视频和音频是分离的两条流最后需要外部工具把它们合并成一个 MP4。因此必须准备其一FFmpeg推荐最常用MP4Box备选安装后确认ffmpeg -version能正常输出。如果你后面下载杜比视界内容请使用 FFmpeg 5.0 以上或新版 MP4Box。 提示如果 FFmpeg 不在系统 PATH 中也可以用--ffmpeg-path参数手动指定它的完整路径。首次成功体验用一条命令下载第一个视频从链接里认出视频身份B 站视频常见的链接形式有https://www.bilibili.com/video/BV1xx411c7mDBV 号链接纯BV1xx411c7mD或av123456BBDown 也直接认执行下载BBDown https://www.bilibili.com/video/BV1xx411c7mD回车之后BBDown 会依次完成四件事解析视频信息读取标题、分 P、清晰度等元数据选择最佳画质按默认优先级自动挑选可用的最高画质流分轨下载多线程并行拉取视频流与音频流自动混流调用 FFmpeg 合并并输出 MP4完成后视频就在当前目录下看到终端里出现进度条并最终生成.mp4文件你的第一次下载就成功了。 小技巧如果只想看看这个视频有哪些清晰度、而不想真的下载加一个-info参数即可比如BBDown -info 链接纯解析不下载非常适合先探路。进阶玩法一挑画质、选编码把每一帧都榨干自定义画质优先级想优先拿到8K 超高清或杜比视界用-q指定优先级逗号分隔BBDown -q 8K 超高清, 1080P 高码率, HDR 真彩 BV号或链接BBDown 会按从左到右的顺序尝试第一个可用的画质胜出。自定义视频编码优先级有的播放器对编码格式挑剔用-e指定编码顺序BBDown -e hevc,av1,avc BV号或链接换接口下载效果可能出乎意料同一个视频不同接口拿到的片源不一样参数接口特点-tvTV 端粉丝量大的 UP 主基本是无水印片源-appAPP 端接近手机端画质-intl国际版面向东南亚地区的内容例如BBDown -tv 链接。日常下载普通视频时-tv往往是惊喜最多的一招。 提示下载时如果你不想看到满屏的音视频流列表加-hshide-streams即可安静执行。进阶玩法二对付多 P 视频准确点菜遇到几十集的内容没必要全下。-p参数支持三种写法# 只下第 8 集 BBDown -p 8 链接 # 下第 1、2、10 集 BBDown -p 1,2,10 链接 # 下第 3 到 5 集 BBDown -p 3-5 链接还支持ALL全集、LAST最后一集、LATEST追更到最新# 番剧全集一次拉完 BBDown -p ALL https://www.bilibili.com/bangumi/play/ss33073如果分 P 太多被折叠展示加--show-all就能看到全部列表。批量下载时想给服务器留点情面用--delay-per-page 2让每集之间间隔 2 秒。进阶玩法三登录后解锁大会员专属内容某些视频需要登录甚至大会员权限才能看BBDown 提供了三种鉴权方式方式一扫码登录最省事BBDown login终端会弹出二维码用 B 站 App 扫码即可登录 WEB 账号。TV 端账号则用BBDown logintv登录信息会保存在本地之后下载自动带上身份。方式二手动传入 Cookie从浏览器开发者工具里复制 Cookie 字符串BBDown -c SESSDATA你的Cookie值 链接方式三传入 access_token适合 TV / APP 接口BBDown -tv -token 你的Token 链接⚠️ 注意登录凭证等同于你的账号钥匙千万别把 Cookie 和 Token 分享给别人。进阶玩法四只下想要的零件有些场景你并不需要完整视频需求命令效果只要画面--video-only跳过音频仅下视频流只要声音--audio-only适合转成 MP3 收藏只要弹幕--danmaku-only保留原汁原味的弹幕只要字幕--sub-only自动转换 SRT 格式只要封面--cover-only快速抓取封面图下载弹幕记得加-dddownload-danmaku开关。如果不需要 AI 字幕保持默认即可BBDown 默认会跳过 AI 字幕。进阶玩法五自定义文件名让文件库井井有条默认文件名叫视频主标题多 P 内容会按标题/分P序号分P标题组织。想更个性化--file-pattern支持丰富的内置变量变量含义videoTitle视频主标题pageNumber/pageNumberWithZero分 P 序号 / 前缀补零pageTitle分 P 标题dfn清晰度如 1080PownerNameUP 主名称videoCodecs视频编码示例生成视频标题[清晰度].mp4这样干净的文件名BBDown -F videoTitle[dfn] 链接多 P 内容想要标题/集数[清晰度]的结构BBDown -M videoTitle/[PpageNumberWithZero]pageTitle[dfn] 链接 注意在 Linux / macOS 的 bash 里变量外的尖括号一般安全但为避免 shell 误解整体用双引号包住即可。效率翻倍用配置文件固化你的偏好每次敲一长串参数太累了。BBDown 支持读取本地配置文件BBDown.config放在程序目录下或用--config-file指定路径把常用参数写进去一次搞定# 这是 BBDown 配置文件以 # 开头的行会被忽略 # 参数独占一行它的值写在下一行 --file-pattern videoTitle[dfn] --multi-file-pattern videoTitle/[PpageNumberWithZero]pageTitle[dfn] --delay-per-page 2 --download-danmaku配置之后直接BBDown 链接就会自动带上这些设置。命令行里显式传入的参数优先级高于配置文件灵活切换不冲突。再进一步aria2c 加速与服务器模式自动化用 aria2c 把速度拉满网络不佳时可以借助 aria2c 多线程下载需自行准备好 aria2c 可执行文件BBDown --use-aria2c --aria2c-args -x 16 -s 16 -k 5M 链接默认就带-x16 -s16 -j16 -k 5M你可以按需调整线程数。变身 HTTP 服务器接入自动化BBDown 还支持以服务器模式运行暴露 JSON API方便接入自己的脚本或面板BBDown serve -l http://0.0.0.0:23333然后就能用 HTTP 请求管理下载任务。比如添加一个任务curl -X POST -H Content-Type: application/json \ -d { Url: BV1qt4y1X7TW } \ http://localhost:23333/add-task其他常用接口接口用途/get-tasks/获取全部任务运行中 已完成/get-tasks/running只看运行中的任务/get-tasks/finished只看已完成的任务/remove-finished清空已完成任务 温馨提示服务器模式目前不限制并发任务数短时间别疯狂提交大量任务以免资源被耗尽。常见坑与避坑指南坑 1下载完没有声音大概率是混流失败。检查两点FFmpeg 是否安装并加入 PATH实在不行用--skip-mux跳过自动混流再用 FFmpeg 手动合并。坑 2提示需要登录 / 无法下载高清大会员内容需要先BBDown login扫码登录某些高清流还要求 TV/APP 鉴权配合-tv -token使用。坑 3下载报 403 或失败试试--force-http强制走 HTTP或加--debug查看详细日志定位问题。坑 4下载了不该下的内容很多解析服务器支持-info先预览确认无误再真正下载避免浪费流量。写在最后合规使用快乐离线BBDown 是一个优秀的开源工具但请务必牢记仅供个人学习、研究和非商业用途。下载内容前请确认你拥有相应的观看与使用授权尊重创作者版权不要用于任何商业传播。现在轮到你了。如果这个工具解决了你的痛点不妨从这条命令开始dotnet tool install --global BBDown跑通第一个下载后再按今天学到的顺序逐步解锁画质选择、分 P 批量、配置文件与 API 自动化。相信用不了十分钟你就能把 B 站内容管理得明明白白。动手试试吧祝你离线观影愉快【免费下载链接】BBDownBilibili Downloader. 一个命令行式哔哩哔哩下载器.项目地址: https://gitcode.com/gh_mirrors/bb/BBDown创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考