5分钟快速上手：BBDown哔哩哔哩视频下载器完整指南

5分钟快速上手：BBDown哔哩哔哩视频下载器完整指南

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

BBDown是一款功能强大的命令行式哔哩哔哩视频下载器，专为需要高效下载B站视频资源的用户设计。这个开源工具支持多种视频类型下载，包括普通视频、番剧、课程等，能够满足不同用户的个性化需求。无论是想要离线观看学习资料，还是收藏喜欢的番剧，BBDown都能提供便捷的解决方案。

🚀 极速入门指南

环境准备与安装

BBDown基于.NET框架开发，使用前需要确保系统已安装.NET环境。以下是快速安装步骤：

1. 检查.NET环境：打开命令行终端，输入以下命令检查.NET是否已安装

dotnet --version

如果显示版本号，说明环境已就绪；否则需要先安装.NET。

2. 一键安装BBDown：通过NuGet包管理器全局安装

dotnet tool install --global BBDown

3. 验证安装：检查安装是否成功

BBDown --version

注意：BBDown在混流时需要外部程序支持，普通视频需要ffmpeg或mp4box，杜比视界内容需要ffmpeg 5.0以上版本。

基础下载命令

功能场景	命令示例	说明
下载普通视频	BBDown https://www.bilibili.com/video/BV1xx4y1v7Sj	直接输入视频链接即可
TV接口无水印下载	BBDown https://www.bilibili.com/video/BV1xx4y1v7Sj -tv	使用TV接口，部分UP主视频无水印
仅获取视频信息	BBDown https://www.bilibili.com/video/BV1xx4y1v7Sj -info	仅解析不下载，查看视频详情
下载番剧全集	BBDown https://www.bilibili.com/bangumi/play/ep123456	自动下载番剧所有剧集

🔧 核心功能详解

多接口支持

BBDown支持多种解析接口，确保视频资源的最大化获取：

• Web接口：标准网页版接口
• TV接口：云视听小电视接口，部分视频无水印
• APP接口：移动端接口，支持更多内容
• 国际版接口：东南亚地区视频专用

高质量下载选项

BBDown支持多种视频编码和画质选择：

编码格式	支持情况	特点
AVC/H.264	✅ 完全支持	兼容性最好的编码
HEVC/H.265	✅ 完全支持	更高压缩效率
AV1	✅ 完全支持	最新编码标准
8K超高清	✅ 完全支持	最高画质体验
HDR真彩	✅ 完全支持	高动态范围
杜比视界	✅ 完全支持	顶级视觉体验

智能文件管理

BBDown支持自定义文件名格式，让下载的文件更有条理：

# 自定义单P文件名 BBDown "视频链接" -F "<videoTitle>[<dfn>]_<ownerName>" # 自定义多P文件名 BBDown "视频链接" -M "<videoTitle>/[P<pageNumberWithZero>]<pageTitle>[<dfn>]"

可用变量说明：

• <videoTitle>：视频主标题
• <pageNumber>：分P序号
• <dfn>：视频清晰度
• <ownerName>：UP主名称
• <res>：视频分辨率
• <fps>：视频帧率

📱 场景化应用指南

学生党学习资料下载

对于需要下载课程视频进行离线学习的学生，BBDown提供了便捷的解决方案：

# 下载整个课程系列 BBDown "课程链接" -p ALL # 仅下载特定章节 BBDown "课程链接" -p 1,3,5 # 下载指定清晰度 BBDown "课程链接" -q "1080P 高码率"

番剧爱好者收藏

动漫爱好者可以使用BBDown批量下载喜欢的番剧：

# 下载番剧全集 BBDown "番剧链接" -p ALL --download-danmaku # 下载外挂字幕 BBDown "番剧链接" --sub-only # 仅下载弹幕 BBDown "番剧链接" --danmaku-only

UP主视频备份

内容创作者可以使用BBDown备份自己的作品：

# 备份个人空间所有视频 BBDown "UP主空间链接" # 选择高质量编码优先 BBDown "视频链接" -e "hevc,av1,avc" # 多线程加速下载 BBDown "视频链接" -mt

⚙️ 高级配置技巧

配置文件使用

从1.4.9版本开始，BBDown支持本地配置文件，简化常用参数设置：

# BBDown配置文件示例 --file-pattern <videoTitle>[<dfn>] --multi-file-pattern <videoTitle>/[P<pageNumberWithZero>]<pageTitle>[<dfn>] --delay-per-page 2 --download-danmaku

将上述配置保存为BBDown.config文件，BBDown会自动读取应用。

账号登录与鉴权

为了下载会员专享内容，BBDown支持多种登录方式：

# 网页账号扫码登录 BBDown login # TV账号扫码登录 BBDown logintv # 手动设置cookie BBDown -c "SESSDATA=******" "视频链接" # 手动设置token BBDown -tv -token "******" "视频链接"

API服务器模式

BBDown支持以服务器模式运行，提供RESTful API接口：

# 启动API服务器 BBDown serve -l http://0.0.0.0:12450

主要API端点：

• GET /get-tasks/- 获取所有任务列表
• GET /get-tasks/running- 获取正在运行的任务
• POST /add-task- 添加新下载任务
• GET /get-tasks/{id}- 获取特定任务详情

详细API文档可参考项目中的json-api-doc.md文件。

🔍 常见问题排查

下载失败问题

错误现象	可能原因	解决方案
网络连接失败	网络问题或代理设置	检查网络连接，尝试关闭代理
视频无法解析	链接失效或权限不足	确认视频存在且有权访问
混流失败	ffmpeg/mp4box未安装	安装并配置ffmpeg或mp4box
内存不足	大文件处理需要更多内存	增加系统内存或使用轻量模式

性能优化建议

1. 多线程下载：默认开启多线程，如需关闭使用--no-multi-thread
2. 下载间隔设置：批量下载时设置分P间隔避免被封

BBDown "合集链接" --delay-per-page 3

3. 使用aria2c加速：调用aria2c进行下载

BBDown "视频链接" -aria2

⚖️ 合规使用指南

合法使用原则

BBDown工具仅供个人学习、研究和非商业性用途。用户在使用本工具时，需自行确保遵守相关法律法规，特别是与版权相关的法律条款。

使用建议

1. 尊重版权：仅下载您拥有合法观看权限的内容
2. 合理使用：下载内容仅限个人使用，不得用于商业目的
3. 遵守平台规则：遵守哔哩哔哩平台的使用条款
4. 保护账号安全：妥善保管登录信息，避免账号风险

免责声明

开发者不对因使用本工具而产生的任何版权纠纷或法律责任承担责任。请用户在使用时谨慎，确保其行为合法合规，并仅在有合法授权的情况下使用相关内容。

📁 项目结构与源码

BBDown采用模块化设计，核心功能分布在以下目录中：

• 核心解析模块：BBDown.Core/Fetcher/ - 包含各种视频类型的解析器
• 实体定义：BBDown.Core/Entity/ - 视频信息的数据结构
• 工具类：BBDown.Core/Util/ - HTTP请求、字幕处理等工具
• 主程序：BBDown/ - 命令行接口和主要逻辑

项目采用C#开发，代码结构清晰，便于二次开发和功能扩展。如果您是开发者，可以查看Model/ServeRequestOptions.cs了解API服务器配置，或查看Program.cs了解命令行参数处理逻辑。

🎯 总结

BBDown作为一款专业的哔哩哔哩视频下载工具，凭借其强大的功能和灵活的配置选项，已经成为许多用户的首选工具。无论是简单的视频下载需求，还是复杂的批量处理任务，BBDown都能提供可靠的解决方案。

通过本文的指南，您应该已经掌握了BBDown的基本使用方法和高级技巧。记住，技术工具的价值在于合理使用，希望BBDown能够帮助您在合法合规的前提下，更好地管理和使用视频资源。

温馨提示：技术不断进步，BBDown也在持续更新中。建议定期使用dotnet tool update --global BBDown命令更新到最新版本，以获得更好的使用体验和功能支持。

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