BBDown完整使用手册:让哔哩哔哩视频下载变成一行命令的事

发布时间:2026/10/6 9:42:00

BBDown完整使用手册:让哔哩哔哩视频下载变成一行命令的事 BBDown完整使用手册让哔哩哔哩视频下载变成一行命令的事【免费下载链接】BBDownBilibili Downloader. 一个命令行式哔哩哔哩下载器.项目地址: https://gitcode.com/gh_mirrors/bb/BBDown周末想躺在沙发上把追了一个月的纪录片一口气看完结果发现高铁上信号一言难尽做课程设计想引用UP主的演示片段却找不到官方下载入口收藏夹里躺着几百个稍后再看真正用上的没几个……这些场景你大概率都经历过。问题的根源其实很简单哔哩哔哩的视频没有官方下载通道而网页端能拿到的画质又处处受限。今天要聊的主角——BBDown就是一个专门解决这类痛点的命令行式哔哩哔哩下载器。它是开源免费的基于 .NET 开发Windows、macOS、Linux 都能跑。你给它一个链接它负责解析、选画质、拉流、合并、输出成品 MP4全程不用打开浏览器。这篇文章不打算给你堆参数列表而是跟着一位小北同学的真实使用轨迹从装好工具到搞定一套复杂需求一步一步把 BBDown 用明白。第一步装好工具先让第一条视频跑起来两条命令完成安装新手也能五秒搞定小北的电脑上装过 .NET所以他的安装方式最省事dotnet --version # 确认环境版本号大于 6.0.100 即可 dotnet tool install --global BBDown以后想升级也只需要一条命令dotnet tool update --global BBDown如果你没有 .NET 环境或者想直接用免安装的版本去项目的 Release 页面下载对应系统的压缩包解压即可。另外项目里还附带了一份 Dockerfile内置了 ffmpeg 和 serve 模式喜欢容器化部署的同学可以照着用。装完先验证一下BBDown --version第一次下载把链接丢进去就行小北随手挑了一个 BV 号视频试水BBDown https://www.bilibili.com/video/BV1qt4y1X7TW几秒钟后程序自动完成了解析、选流、多线程下载、音视频合并当前目录下多了一个 MP4 文件。他甚至没看懂中间刷过的日志但成品就是出来了。小贴士BBDown 也支持直接传BV、av、ep、ss这类编号不一定要完整网址。关于混流的补充说明BBDown 本身不负责合并音视频这件事它依赖外部程序来干活——普通视频用 ffmpeg 或 mp4box杜比视界片源则要求 ffmpeg 5.0 以上或新版 mp4box。如果你下载完发现只有画面没有声音八成是这台机器上没装 ffmpeg去官网装一个并加入系统 PATH 就能解决。第二步遇到需要登录的拦路虎怎么破小北很快就撞上了第一堵墙想下载一部大会员专属的番剧提示需要登录。扫码登录最省心的方式BBDown 内置了二维码登录在终端里执行BBDown login终端会直接渲染出一个二维码用哔哩哔哩手机 APP 扫码确认登录态就保存到了本地文件里之后下载会优先使用会员权限。如果是云视听小电视TV 端的账号体系则用BBDown logintv。手动给 Cookie 和 Token给进阶用户的两条捷径不想扫码也行网页端会员内容可以直接塞 CookieBBDown -c SESSDATA****** https://www.bilibili.com/video/BV1qt4y1X7TWTV / APP 接口的会员内容则用 access_tokenBBDown -tv -token ****** https://www.bilibili.com/video/BV1qt4y1X7TW小北后来发现了一个冷知识TV 登录产生的 access_token 也能给 APP 接口用把BBDownTV.data复制成BBDownApp.data程序就会自动读取。至于 APP 接口更精细的鉴权比如带identify_v1前缀的 authorization 头里的那串数字README 里给了抓包获取的方法属于想折腾的人再去研究的部分。第三步从下一个视频到批量搬空只差几个参数分P下载全集、选集、跳着选都行小北开始下载一部 30 集的课程他先了解了几种选集语法# 全集 BBDown -p ALL https://www.bilibili.com/bangumi/play/ss33073 # 指定几集 BBDown -p 1,3,5 https://www.bilibili.com/bangumi/play/ss33073 # 一个范围 BBDown -p 1-10 https://www.bilibili.com/bangumi/play/ss33073 # 只看最后一集 BBDown -p LAST https://www.bilibili.com/bangumi/play/ss33073还能用-p 3,LATEST这种指定集最新集的组合。下载多 P 时如果分P很多程序默认只展示一部分想看全貌加--show-all即可。画质与编码把能看升级成极致BBDown 对画质的支持相当激进最高到 8K还包括 HDR、杜比视界、杜比全景声。控制画质和编码有两个核心参数# 指定编码优先级 BBDown -e hevc,av1,avc https://www.bilibili.com/video/BV1qt4y1X7TW # 指定画质优先级 BBDown -q 8K 超高清,1080P 高码率,HDR 真彩,杜比视界 https://www.bilibili.com/video/BV1qt4y1X7TW不想提前决定的话-ia交互模式会在下载前弹出一个清晰度菜单让你现挑-info则只解析不下载先把画质、编码、大小全看清楚再动手。这里有个默认行为值得注意多线程下载是默认开启的在限速的网络环境里可以用--multi-thread false关掉。番剧、课程、收藏夹、个人空间全类型解析小北接下来测试了各种链接惊讶地发现 BBDown 几乎什么都能吃内容类型支持情况说明普通视频Web/TV/AppUP 主投稿番剧Web/TV/App含ss/ep编号课程课堂Web付费课程下载收藏夹✅需要favId前缀个人空间✅mid前缀合集/列表✅seriesBizId、listBizId这套分类逻辑藏在源码BBDown.Core/FetcherFactory.cs里程序会根据输入前缀自动挑选对应的信息解析器——NormalInfoFetcher、BangumiInfoFetcher、CheeseInfoFetcher、FavListFetcher等各司其职。想深入了解的读者可以翻一翻BBDown.Core/Fetcher/目录模块划分得非常清晰。多接口三选一TV、APP、国际版怎么选BBDown 支持三种解析模式BBDown -tv https://www.bilibili.com/video/BV1qt4y1X7TW # TV 接口 BBDown -app https://www.bilibili.com/video/BV1qt4y1X7TW # APP 接口 BBDown -intl https://www.bilibili.com/video/BV1qt4y1X7TW # 国际版东南亚内容小北的经验是TV 接口对粉丝量大的 UP 主基本能拿到无水印片源日常优先试-tv-intl则适用于 api.biliintl.com 那套国际内容体系。第四步弹幕、字幕、封面一个都不能少视频本身下载好了小北发现配套内容才是灵魂弹幕从 XML 到 ASS加一个参数就能把弹幕一起带走BBDown -dd https://www.bilibili.com/video/BV1qt4y1X7TW弹幕会以 XML 原始格式保存也可以转成 ASS 字幕文件——BBDown.Core/DanmakuUtil.cs里甚至有基于 1920×1080 渲染区域做弹幕排版的逻辑顶部、底部、滚动弹幕的时长和防遮挡都考虑到了。想单独下载弹幕而不下载视频用--danmaku-only。字幕自动转 SRT外挂字幕默认随视频下载并自动转换为通用的 SRT 格式。混流时还能指定音频语言比如BBDown --language chi https://www.bilibili.com/video/BV1qt4y1X7TW只下载某一类素材创作者要的就是拆开用的自由BBDown --video-only https://www.bilibili.com/video/BV1qt4y1X7TW # 只要画面 BBDown --audio-only https://www.bilibili.com/video/BV1qt4y1X7TW # 只要声音 BBDown --sub-only https://www.bilibili.com/video/BV1qt4y1X7TW # 只要字幕 BBDown --cover-only https://www.bilibili.com/video/BV1qt4y1X7TW # 只要封面第五步文件名规整与配置文件告别每次敲一堆参数用内置变量定制文件名小北是个有整理强迫症的人他的文件名需求是标题清晰度BBDown -F videoTitle[dfn] https://www.bilibili.com/video/BV1qt4y1X7TW可用的内置变量很丰富常用的一批有变量含义videoTitle视频主标题pageNumber/pageNumberWithZero分P序号后者补零pageTitle分P标题dfn/res/fps清晰度 / 分辨率 / 帧率videoCodecs/audioCodecs音视频编码ownerName/ownerMid上传者信息bvid/aid/cid视频标识apiTypeAPI 类型TV/APP/INTL/WEB多 P 视频默认的文件结构是视频主标题/[P01]分P标题同样可以用-M参数定制成标题/分P标题[清晰度]这种风格。配置一次终身受用小北把这些固定选项写进了BBDown.config文件之后每次下载自动读取再也不用重复敲# BBDown 配置文件以 # 开头的行会被忽略 --file-pattern videoTitle[dfn] --multi-file-pattern videoTitle/[PpageNumberWithZero]pageTitle[dfn] # 下载弹幕 --download-danmaku # 分P之间间隔 2 秒避免请求过快 --delay-per-page 2如果配置文件不叫默认名用--config-file指定路径即可。这个解析逻辑由BBDown/BBDownConfigParser.cs实现每个选项的参数写在下一行格式很直白。第六步当下载变成服务BBDown 还能这样用小北折腾到后期已经不满足于手动一条条敲命令了。他发现 BBDown 还带一个 serve 模式能以 HTTP 服务的形式运行BBDown serve -l http://0.0.0.0:58682启动后就能用 JSON API 管理下载任务接口设计都在 json-api-doc.md 里。几个核心端点# 查看所有任务 curl http://localhost:58682/get-tasks/ # 只查正在运行的 curl http://localhost:58682/get-tasks/running # 添加一个下载任务只需 URL 字段 curl -X POST -H Content-Type: application/json \ -d { Url: BV1qt4y1X7TW } http://localhost:58682/add-task # 添加任务并指定保存目录 curl -X POST -H Content-Type: application/json \ -d { Url: BV1qt4y1X7TW, FilePattern: /Downloads/videoTitle[dfn] } http://localhost:58682/add-task每个任务带进度、下载速度、总字节数等实时信息天然适合接进自己的自动化脚本。Dockerfile 里默认入口就是serve -l http://0.0.0.0:23333部署一个常驻下载服务也就一行命令的事。三个使用 API 前要记住的坑任务一旦提交就不好取消只能等它完成或失败服务端对并发任务数量没有限制短时间内狂塞任务会耗尽机器资源自己控制节奏返回的TotalDownloadedBytes会比实际文件略小约等于 1 秒的下载量这是回报频率造成的正常现象。避坑清单新手最容易踩的 5 个坑小北这一路也踩了不少雷整理成清单送给你下载完没声音——99% 是没装 ffmpeg。装好并加入 PATH或者用--ffmpeg-path指定位置实在不行就--skip-mux跳过自动合并拿到音视频流后手动处理。画质上不去——有些高画质需要大会员确保已经用BBDown login登录了有权限的账号并且登录态文件没有被删。多 P 下载太激进被限速——用--delay-per-page 2在分P之间加间隔文明一点。文件名乱成一锅粥——尽早用-F/-M把videoTitle、pageNumber这些变量定好别等到下完一百集再整理。速度不尽人意——先试试--use-aria2c调起 aria2c 多线程下载附带参数如-x 16 -s 16可自行控制并发也能用--work-dir把下载目录挪到更快磁盘上。两个值得留意的进阶姿势归档跳过重复下载加--save-archives-to-file会把下载过的视频记录到本地文件下次遇到同一个视频直接跳过适合跑定时任务增量更新收藏夹。换编码优先顺序有些播放器对 HEVC 支持好有些则对 AV1 更友好。用-e调整编码优先级如-e av1,hevc,avc相当于给下载结果按需定制而--video-ascending、--audio-ascending则能优先挑体积更小的流省流量。写在最后下载能力越强越要谨慎使用回到小北的故事他现在已经养成了一个固定流程——收藏夹定期用 BBDown 增量同步到 NAS追的番剧更新后自动拉最新一集做剪辑时用--video-only单独抽素材。一个开源命令行工具把他从找下载方法的泥潭里彻底捞了出来。但能力越大责任越大。BBDown 的作者在项目里明确写了免责声明工具仅供个人学习、研究和非商业性用途下载行为需自行确保符合版权相关法律法规。翻译成大白话就是——自己收藏、离线观看、学习研究没问题但别拿去传播、倒卖或商用。尊重创作者才能让这个生态长久地好下去。如果你也想把哔哩哔哩视频下载这件事彻底简化按这篇文章的顺序走一遍装上 → 登录 → 下第一个视频 → 学会选集选画质 → 用配置固化习惯 → 最后再考虑要不要上 serve 模式。到那时候BBDown 就不再是一个下载器而是你手里一个趁手的视频管理基础设施。【免费下载链接】BBDownBilibili Downloader. 一个命令行式哔哩哔哩下载器.项目地址: https://gitcode.com/gh_mirrors/bb/BBDown创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/10/3 3:40:47

从0到1产品设计全流程:MVP验证与PRD撰写实战指南

1. 从0到1:产品设计的核心挑战与价值 做产品,尤其是从零开始做一个新产品,听起来很酷,但真正干过的人都知道,这活儿既烧脑又烧心。它不像在现有产品上做个功能迭代,修修补补,有迹可循。从0到1&a…

2026/10/2 3:56:33

智能查询计划灰度发布,先验证什么

智能查询计划灰度发布,先验证什么 把模型接到优化器前,先不要急着看它能不能跑出更快的计划。灰度阶段真正要回答的是:它在什么查询上可靠,失效时是否能退回已有优化器,以及观测本身会不会干扰主业务。 先做影子评估&a…

2026/9/27 17:53:23

基于MATRIX Voice的自行车汽车喇叭检测系统:边缘AI与嵌入式实践

1. 项目缘起:为什么要在自行车上装个“汽车喇叭”探测器?这事儿听起来有点无厘头,但如果你像我一样,是个每天通勤都要和机动车共享城市道路的自行车骑行者,你肯定能瞬间理解这个项目的痛点。城市骑行,尤其是…

2026/10/6 9:38:49

OpenShell:GPU加速的现代终端模拟器,轻量高效替代iTerm2

上个月我把主力终端从系统自带的 Terminal 换成了 OpenShell,一句话来概括这段体验——这是我今年换过的所有开发者工具里,性价比最高的一次迁移。先交代一下背景:我日常工作几乎泡在命令行里,跑测试、改配置、连远程服务器、盯日…

2026/10/6 9:38:49

Python虚拟环境实战:从venv到conda迁移与避坑指南

在Linux上折腾Python的人,迟早会在一个深夜被依赖冲突逼疯:新项目要Python 3.11,老服务还锁在3.8,系统自带的包管理工具又认死理,你一升级,cron里跑了几年的脚本第二天全挂。我就是在一次手贱升级requests之…

2026/10/6 9:38:49

RabbitMQ高并发实战:从异步解耦到削峰填谷的完整指南

接手过一个电商中台项目,第一次让我失眠的就是大促期间下单接口的耗时。用户点一下支付,后端要依次同步调用库存、优惠券、积分、短信四个服务,接口动不动飙到800毫秒,数据库连接池直接被打满,再往下就是雪崩。架构师甩…

2026/10/6 9:38:49

程序员深夜思考:从代码世界到人生世界的五个映射框架

凌晨一点三十七分,我在IDE前面坐了二十分钟,一行代码没写。光标在闪烁,脑海里想的却是"代码职业生涯的版本号到底是谁定的"这种不着边际的问题。白天完全不会想这些——白天有需求deadline压着,有测试用例等着&#xff…

2026/10/6 9:38:49

Context-Mode实战:把项目上下文喂给AI,告别答非所问

第一次意识到 context-mode 这个问题的价值,是在某个周三下午改一个用了三年的老项目。AI 辅助工具已经装好了,提示词写得很清楚,“帮我看看这个函数为什么偶发异常”,结果模型答非所问,给了我一篇关于异常处理的最佳实…

2026/10/6 9:33:48

OpenShell实战:AI智能体如何重塑命令行运维与自动化工作流

OpenShell这名字乍一听像某个终端模拟器,或者某个操作系统的新玩具,但如果你关注AI工具圈,可能会知道它其实是一套面向命令行场景的AI智能体框架——准确说,是在OpenAI Codex CLI停更之后,由原团队核心成员开源出来的那…

2026/10/5 6:32:56

Jev+Agent接管浏览器:browser-use实战与jev-ultrafast性能优化

1. 从“Jev”说起:为什么我要把Agent接进浏览器“Jev”这个词最近在圈子里出现的频率越来越高,很多人第一次听到会以为是某个新模型的名字,其实它更像是一种思路——把Jev模型的能力当作底座,通过Agent的方式去接管浏览器&#xf…

2026/10/6 4:01:51

多智能体集群实战:DeepAgents编排、MCP与A2A协议及Skills体系

1. 从"单兵作战"到"集群协同":多智能体编排到底在解决什么问题如果你最近在折腾 Agent 相关的东西,大概率会有一种感觉:单个 Agent 能做的事情,其实很快就摸到天花板了。你给它一个提示词,挂几个工…

2026/10/5 17:38:27

无源低通滤波器设计实战:从RC到LC,手把手教你避开那些坑

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/6 0:03:23

MR25H40CDF+STM32F031C6工业级高可靠数据存储方案

1. 项目概述:为什么在工业现场非得用 MR25H40CDF 配 STM32F031C6 做数据存储?在工厂产线的 PLC 控制柜里、在风电变流器的散热片背面、在矿井监测终端的金属外壳下,你经常能看到一块指甲盖大小的黑色芯片——它既不是 Flash,也不是…

2026/10/6 0:03:23

MRAM+STM32工业断电数据保全实战指南

1. 项目概述:为什么在工业现场非得用 MR25H40CDF 配 STM32F031C6 做数据存储?在工厂产线的PLC柜里、在野外无人值守的环境监测终端里、在高速运转的包装机控制板上,你经常能看到一块指甲盖大小的黑色芯片,旁边贴着“MR25H40CDF”丝…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑