Home

BBDown Wiki 知识库

欢迎查阅 BBDown（命令行式哔哩哔哩下载器）官方完整 Wiki 知识库！

BBDown 是一款基于 .NET 的跨平台命令行哔哩哔哩音视频综合下载与录制工具。一条命令即可完成视频链接解析、多线程分片下载与音视频自动混流，最高支持 8K / HDR / 杜比视界 / 杜比全景声，并内置原生 C# 实现的 Widevine DRM 解密支持。

---

📚 文档目录总览

模块	页面链接	核心内容概述
入门指引	🚀 快速上手 (Getting Started)	预编译下载、外部依赖配置（FFmpeg/MP4Box/aria2c）、基础下载指令
命令参考	⚙️ 全命令行参数详解 (CLI Reference)	所有选项参数表格、画质/编码优先级、分 P 范围选择器、网络重试调优、退出码规范
身份认证	🔑 账号登录与鉴权 (Authentication)	网页/TV 端扫码登录、APP Token 抓包提取、Cookie 传递、充电专属试看片段拦截机制
定制配置	📝 配置文件与命名规则 (Configuration)	BBDown.config 语法说明、18 种内置文件名变量模板、按作者/剧集归档实战
扩展命令	🛠️ 子命令使用指南 (Subcommands)	直播录制 (live)、专栏文章保存 (article)、稍后再看批量下载 (watchlater)、UP主订阅管理 (sub)
弹幕互动	💬 弹幕与评论区抓取 (Danmaku & Comments)	弹幕 XML / Protobuf 抓取、ASS 字幕转换渲染规则、关键词/用户过滤、评论区 JSON 导出
自动化实战	📦 批量下载与自动化 (Batch & Automation)	空间全部投稿、合集与播单、--save-archives-to-file 历史防重、Webhook 回调与定时任务
DRM 专区	🔓 Widevine DRM 原生解密 (DRM Decryption)	原生 C# CDM 运行机制、device.wvd 放置规则、B 站付费课程/番剧自动与手动解密
服务部署	🌐 API 服务器与 Docker 部署 (API & Docker)	BBDown serve RESTful API 规范、并发控制、Token 认证、Native AOT Docker 容器化
核心原理	🏗️ 内部架构与设计原理 (Architecture)	模块分层、Fetcher 责任链工厂、读停滞看门狗、PCDN 自动替换、抗风控重试模型
源码编译	💻 开发者指南与编译构建 (Developer Guide)	本地开发环境准备、单元测试运行、Native AOT 跨平台独立发布构建指南
排障手册	❓ 常见问题与故障排查 (FAQ)	混流失败排查、403/412 限制应对、Linux GDI+ 异常修复、网络优化与 --debug 抓包

---

✨ 核心特性矩阵

mindmap
  root((BBDown))
    全类型资源解析
      普通视频 / 多分P
      番剧 / 电影 / 国创 / 纪录片
      付费课程 Cheese (DRM)
      UP 主空间全部投稿
      合集 / 播单 / 收藏夹 / 稍后再看
    高规格音画体验
      8K 超高清 / 4K / 1080P60
      HDR 真彩 / 杜比视界 (Dolby Vision)
      杜比全景声 (Dolby Atmos) / Hi-Res
      无损 FLAC / 高码率 AAC
    原生 C# DRM 解密
      内置纯 C# Widevine CDM
      无需 Python / pywidevine 依赖
      自动握手 B 站许可证服务器
    强大子命令生态
      直播录制 (live) 断流重连分段合成
      专栏下载 (article) 导出 Markdown
      订阅管理 (sub) 增量检查新投稿
      稍后再看 (watchlater) 批量同步
    服务化与集成
      REST API 服务器 (serve)
      并发限制与 Token 访问控制
      下载完成 Webhook 通知回调
      Native AOT 容器镜像

Loading

---

🔗 项目与社区链接

• 项目主仓库：GitHub - aliveranme/BBDown
• 上游原始仓库：GitHub - nilaoda/BBDown
• 最新 Release 下载：Releases 发布页面
• Bug 反馈与建议：GitHub Issues