B站视频下载工具BiliDownload保姆级上手指南：无水印、多线程、5分钟跑通你的第一个下载任务

B站视频下载工具BiliDownload保姆级上手指南：无水印、多线程、5分钟跑通你的第一个下载任务

【免费下载链接】BiliDownloadB站视频下载工具项目地址: https://gitcode.com/gh_mirrors/bil/BiliDownload

深夜十一点，周老师盯着屏幕上那行灰色的"已下架"三个字，心里咯噔一下——他花了三个晚上整理的Python教程合集，就这样一夜之间没了。这不是个例。今天要讲的B站视频下载工具BiliDownload，正是为这类"怕错过、怕失去"的场景而生的开源Java工具，它能把B站视频稳稳当当存进你的硬盘，还能一键拿掉水印。

故事要从那个"失去"的夜晚说起。

一个深夜，我眼睁睁看着收藏夹里的视频消失

你有没有过这样的经历？

刷到一个特别棒的教程、一场精彩的演讲、一段值得反复回看的纪录片，于是点下收藏，想着"以后再看"。结果呢——一个月后打开收藏夹，它安静地躺着一行字：视频已失效。

更难受的还不止这一件：

• 想给视频做二次创作，画面右上角却永远挂着UP主的ID水印；
• 想离线保存，平台官方偏偏没有提供下载入口；
• 好不容易找到下载工具，要么失效，要么只能下360P的"马赛克画质"；
• 几十集的系列课程，一集一集手动操作，手指都点麻了。

这些痛点，每一个都真实到让人抓狂。尤其是创作者和教育工作者——素材就是生产力，而生产力不该被"已下架"三个字绑架。

转机：一个叫BiliDownload的开源Java工具

我也是在被坑了N次之后，偶然遇到它的。

BiliDownload是一个开源项目，用Java写成，通过调用B站WEB端与TV端的API实现视频下载。它打动我的地方，主要有三点：

1. 无水印。它同时访问TV端和WEB端两套API，通过TV端返回的accept_watermark参数精准判断哪些清晰度是无水印源，并在清晰度列表里标上醒目的"无水印"标记。你选的每一个画质，心里都有数。
2. 多线程下载。当文件超过8MB，自动启用多线程分块下载，官方测试中最高速度达到过23MB/s。
3. 双端登录+全画质。支持WEB端、TV端二维码登录，也支持直接输入SESSDATA；从流畅360P到超清4K，从普通画质到大会员专属的1080P+，全都能选。

对于任何用过那些"限速版""会员制"下载工具的人来说，这简直像捡到了宝。

三分钟看懂它背后的原理：白话说清B站API那点事

你可能会想：原理复杂吗？不复杂，用大白话讲就是三件事。

第一件：报门牌号。你把AV号或BV号丢给它，它就去B站的WEB端接口查这个稿件的"户口本"——标题、UP主、时长、播放数、弹幕数、获赞、投币、收藏，甚至连每个分P的CID都给你列得明明白白。相当于下载前先给你一份"视频简历"。

第二件：货比三家。它同时访问WEB端和TV端两套播放接口。TV端接口会告诉你哪些清晰度没有水印——就像同一个商品，它在两家店里都问了一遍价，然后挑出"无印良品"放在列表最前面。

第三件：切块搬运。拿到真实下载地址后，如果文件够大（≥8MB），它就把整个文件切成N块，开N个线程同时下载，最后再拼回完整文件。这就是它快的秘密。

核心下载逻辑在 Downloader.java，程序的完整入口在 Main.java。如果你只想看看它怎么管理配置，ConfigManager.java 足够你读半天。

第一步：5分钟跑通你的第一个下载任务

光说不练假把式。我们现在就来下载人生中第一个B站视频。

1. 检查环境。你需要JDK 8或更高版本，以及一个FFmpeg（音视频合并要用，下载单个文件可跳过）。Linux下装FFmpeg一行命令：

# Ubuntu / Debian 安装 FFmpeg，用于音视频合并 sudo apt-get install ffmpeg

2. 获取程序。两种方式，二选一：

# 方式A：直接克隆并编译（产物在 target/ 目录） git clone https://gitcode.com/gh_mirrors/bil/BiliDownload cd BiliDownload mvn clean package

或者直接使用现成的bili-download-1.3.6-jar-with-dependencies.jar，免编译。

3. 启动交互模式。初学者建议从这里开始：

# 启动交互模式，程序会一步步引导你完成下载 java -jar bili-download-1.3.6-jar-with-dependencies.jar

4. 照着提示一路选。输入BV号 → 登录（可以扫码，也可以直接跳过）→ 看清晰度列表 → 选画质 → 选"视频+音频"→ 填保存路径和FFmpeg路径 → 回车。剩下的交给它。

从上面的截图里你能看到它真实的操作过程：输入BV1PK4y1N7gw后，程序返回了标题、UP主、播放数，列出6档清晰度，然后开始以1.09MB/s的均速下载一个203MB的文件，并实时刷新进度、速度和剩余时间。全程傻瓜式引导，不需要碰任何代码。

如果你只想从某个URL直接拉文件，还有更狠的模式：

# 直接下载模式：指定URL和保存路径，下载完自动退出 java -jar bili-download-1.3.6-jar-with-dependencies.jar direct "视频直链" "/home/you/Videos/我的视频.mp4"

我第一次用，从输完命令到拿到一个1080P视频，前后不到五分钟。那种"原来这么简单"的感觉，确实上头。

三个真实用户的故事：他们是这么用它的

工具好不好用，看别人怎么用它最直观。

故事一：教育工作者批量备素材。张老师要为线下编程课准备20个教学视频，每个45分钟。她没有一条条手动操作，而是把所有步骤提前写进了工作目录下的Input.txt，程序检测到该文件后会自动读取每一行作为输入，实现"无人值守"批量下载。原来要耗费一整天的活儿，现在一个晚上全部搞定，效率提升接近一个数量级。

故事二：内容创作者囤无水印素材。视频UP主小李做混剪，最烦的就是画面里的水印。他登录TV端后，在清晰度列表里专挑带"无水印"标记的1080P来下，素材干净到可以直接上剪辑轨道。他说以前找素材要反复裁剪遮挡，现在省下的时间都用来打磨内容本身。

故事三：网络不稳地区的资源分发。乡村学校的网课老师需要提前把优质课程缓存到本地。他把线程数调小、依赖程序内置的自动重试机制——下载中断后程序会在10秒内检测到速度归零、自动从断点继续。就这样，一批几百MB的教学视频在并不顺畅的网络下也全部顺利落地。

进阶：把下载调教成你想要的样子

用顺手之后，你会发现它非常"听话"。所有常用配置都存在工作目录下的config.yml里，第一次输入后自动记忆，下次直接复用：

# BiliDownload 配置文件，位于程序工作目录下，保存后自动生效 sess-data: "你的SESSDATA" # WEB端登录凭据，登录成功后自动保存 access-token: "你的TV端TOKEN" # TV端登录凭据，同样自动保存 save-path: "~/Videos/Bilibili" # 默认保存路径，支持以 ~ 开头代表用户主目录 ffmpeg-path: "/usr/local/bin" # ffmpeg 可执行文件所在目录（Linux/macOS 同样适用） thread-amount: 16 # 下载线程数，8MB以上文件生效

几个值得记住的调优技巧：

• 线程数怎么设？网络好、文件大，往高了调（16~32）；网络不稳，降到4~8；实在不行就单线程。线程数过大容易触发HTTP 416错误，所以别贪心。
• 画质怎么选？平时看720P足够；剪辑用1080P；4K留给显示器。1080P以上需要大会员，这是B站规则，工具只是如实呈现。
• 批量怎么玩？所有输入都可以写进Input.txt，程序检测到就会自动切换输入源。配合脚本，一套课程的分P可以排队下载。
• 想调试？启动时加个debug参数，程序会输出每次访问的URL、使用的UA和线程明细，排错利器。

避坑急救站：最常见的4个报错与破解办法

再好的工具也有翻车的时候，我们把高频问题提前摆平。

问题一：下载进度卡住，速度一直显示0。先别急着退出。程序内置了"10秒均速为零就自动重试"的机制，多数情况它会自己缓过来。如果反复卡住：检查网络、调低线程数、确认磁盘空间充足。网络不好的环境建议thread-amount降到3~5。

问题二：提示"合并失败"或合并出的文件是空的。九成是FFmpeg没配好。确认执行ffmpeg -version有输出，然后在config.yml里核对ffmpeg-path。另外有个已知边界：合并超过4GB左右的文件时FFmpeg可能不再写入，这种超大文件建议用"仅视频/仅音频"分别下载。

问题三：API解析失败、获取不到视频信息。先登录再试——很多高画质源需要账号权限。其次检查SESSDATA是否过期，登录状态失效时重新扫码即可。最后，如果B站调整了接口，记得更新到最新版本。

问题四：启动时抛出ArithmeticException（除以零）。这类"除以零"异常在早期版本里真实出现过——线程数计算为0导致的。如果遇到类似堆栈，优先排查线程数相关设置，把它显式写进配置，例如thread-amount: 8。

另外提醒一句：在某些控制台里，实时刷新的进度信息可能显示错位，比如速度被用时盖住——这是工具已知的小毛病，不影响下载结果，换Windows Terminal或macOS终端体验更佳。

实测数据：不同网络环境下，它的表现如何？

空口无凭，上数据。参考官方日志，一段576.549MB的4K视频用48线程下载，平均速度跑到19.307MB/s；而在普通网络下，1080P视频也能稳定跑出每帧进度的实时刷新。以下是不同场景的参考表现与建议：

同一文件在通畅网络下，多线程比单线程快数倍；而在弱网下，线程太多反而容易互相拖累。所以那句老话依然成立：配置没有最好，只有最合适。

从用户到贡献者：你也可以让这个项目更好

BiliDownload最打动我的地方，是它身上的"活人气息"。

你会在README里看到作者毫不避讳地列出一长串已知BUG——瞬时速度显示为0、重试时进度到100%还多等一会儿、获取无水印源偶尔失败……正是这种坦诚，让这个开源项目变得可爱又可信。

作者在ChangeLog里详细记录了每个版本的来龙去脉：1.3.0用32线程把速度拉到23MB/s，1.3.2修复了除零异常，1.3.5加入了自动重试，1.3.6支持了~路径和Linux/macOS下的FFmpeg文件名适配。每一次更新背后都站着真实用户提的issue。

如果你也想参与，门槛低得惊人：用出问题就去提issue，顺手把复现步骤写清楚；懂Java的可以Fork下来改一改提交PR；甚至只是帮忙翻译文档、写写教程，都是宝贵贡献。一个工具能走多远，往往取决于有多少人愿意为它搭把手。

写在最后：下载不是终点，尊重才是

回过头看，BiliDownload解决的不是"怎么下载视频"这一个问题，而是"我不想再眼睁睁看着喜欢的内容消失"的焦虑。它是开源世界送给每个普通人的一份礼物——跨平台、无水印、多线程、能批量、可持续更新，几乎满足了我对一款B站下载工具的全部想象。

现在就去试试吧：

# 从克隆到跑通第一个视频，总共不过十几分钟 git clone https://gitcode.com/gh_mirrors/bil/BiliDownload cd BiliDownload mvn clean package java -jar target/bili-download-1.3.6-jar-with-dependencies.jar

最后说句心里话：工具负责让知识触手可及，而我们负责善待它的出处。下载的视频请用于个人学习与研究，尊重每一位内容创作者的劳动，共同守护我们热爱的社区。愿你的收藏夹，从此再无"已下架"。

【免费下载链接】BiliDownloadB站视频下载工具项目地址: https://gitcode.com/gh_mirrors/bil/BiliDownload