bili-sync：把 B 站收藏夹搬回自己硬盘

收藏夹里躺了几百个视频，一直没看，某天打开发现「视频已失效」。这种事在 B 站上不算罕见。

bili-sync 做的事很简单：按你设定的来源，把视频下载到本地，定时检查更新，新的一集自动补上。

它能同步什么

• 收藏夹：整个收藏夹定时检查，有新内容就下载；
• 稍后再看：临时存的东西，攒着慢慢下；
• UP 主投稿：追更用，新视频自动入库；
• 合集/番剧：按合集号抓取，整季下来。

下载完成后按文件夹结构存到指定目录，飞牛影视、Jellyfin 这类可以直接扫描成媒体库。

部署与配置

应用中心装好后，打开 Web 界面：

1. 登录 B 站账号：扫码或者填 cookie，账号登录后才能看收藏和会员内容；
2. 添加同步源：粘贴收藏夹链接或者 UP 主主页链接；
3. 设置保存路径：指向存储空间上的影视目录；
4. 设置同步周期：比如每天检查一次。

有的版本还需要配置下载并发和画质上限。

画质和体积

• 大会员内容：登录了会员账号才能下到高画质，没登录就是普通画质；
• 4K/HDR：不是所有内容都有，也没有必要全存最高画质；
• 体积预估：一集 1080p 番剧大约几百 MB，4K 原片可能是几 GB。

先按 1080p 跑一段时间，看看实际占用，再决定要不要调高。

命名与媒体库

同步下来的文件一般会带上标题和分P信息。如果直接丢进影视库，命名可能不符合刮削规则。

两种处理：

• 让 bili-sync 按模板命名（如果有这个选项）；
• 或者下载到「待整理」目录，手动改名后再移进库。

配合影视库使用时，注意不要把下载目录设成媒体库目录，否则文件还在下就被扫描，会出现半截文件。

定时任务与增量

bili-sync 的典型节奏是「定时检查 + 增量下载」：

• 已下载的记录在数据库里，不会重复下；
• 判断依据一般是视频 ID，所以重命名文件不影响；
• 数据库丢了会重新下一遍，备份时记得一起备份。

常见问题

下载失败：账号掉登录（cookie 过期）、视频需要大会员、或者触发了风控。重新登录、放慢频率。

速度很慢：B 站对非会员下载有限速，多线程也不一定有用。

文件名乱码：标题里的特殊字符导致，可以在设置里限制文件名长度。

重复下载：数据库被清了，或者改了同步源的 ID。

版权与合规：自己收藏、自己看没问题，别公开传播、别做二次分发。

值不值得

• 有长期收藏习惯、怕视频失效：值得；
• 只偶尔看几个视频：直接在线看更省事；
• 空间紧张：先想清楚要存多少，一季番剧就是几十 GB。

小结

bili-sync 的价值是把「收藏」变成「拥有」。

代价是空间和带宽，以及要自己维护账号登录状态——把它当成一个需要偶尔看一眼的自动任务，而不是装完就不管的东西。