目录
你可以把 bili-sync 看作一个尽职的私人搬运工。它部署在你的 NAS 或服务器上,会按你设置的间隔,默默检查 B 站上你关注的视频源。一旦发现有新东西,就立刻开始下载,并且会智能选择的视频和音频流,用 FFmpeg 合成为高质量的 MP4 文件。它最贴心的地方在于,下载后的文件结构是专门为 Emby、Jellyfin 这类媒体服务器优化的。你只需要在媒体服务器里把下载目录添加为资料库,就能自动刮削出带海报、简介、演职员表的精美影视墙,体验和在线视频平台一样,但数据掌握在自己手里。项目在 GitHub 上已有超过 2.4k 星标,2026 年 4 月仍在更新,非常活跃。
官网入口地址
bili-sync 项目文档/官网:https://bili-sync.amto.cc/
项目开源地址:https://github.com/amtoaer/bili-sync
下载地址
官方发布页下载:https://github.com/amtoaer/bili-sync/releases
在发布页可以找到各平台的二进制文件(Windows、Linux、macOS)和 Docker 镜像。对于 NAS 用户,推荐使用 Docker 方式部署,命令和配置在项目文档里有详细说明。
功能介绍
多源自动跟踪与同步:支持跟踪和下载多种 B 站内容源,包括:
-
用户的个人收藏夹
-
“稍后再看”列表
-
UP 主的所有投稿视频
-
视频合集和列表
-
番剧和影视剧
智能下载与合成:自动选择画质的视频流和音频流,并使用 FFmpeg 合并为完整的视频文件。支持断点续传和失败重试,保证下载成功率。
完整资产下载:除了视频,还会一并下载视频封面、弹幕(XML格式)、标签和视频简介等元数据,丰富离线观看体验。
媒体服务器友好:下载的文件会按照媒体服务器(如 Emby、Jellyfin、Plex)识别的规范命名和整理,如 视频名称 (年份)/Season 1/视频名称 - S01E01 - 分集标题.mp4。将下载根目录直接添加到媒体库,即可自动刮削生成海报墙,无需手动整理。
Web 管理界面:提供一个现代化的 Web 界面,你可以远程查看所有跟踪的视频源、管理下载任务、查看下载进度和失败记录,操作直观方便。
高性能与低占用:使用 Rust 语言的 Tokio 异步框架,天生支持高并发,快,同时内存和 CPU 占用极低,特别适合在性能有限的 NAS 或树莓派上 7x24 小时运行。
灵活的通知机制:支持通过 Telegram 等渠道发送任务通知,当下载完成或出现错误时,可以第一时间告知你。
应用场景
搭建私人 B 站影视库:在 NAS 上部署 bili-sync,跟踪你喜欢的 UP 主和番剧。所有视频自动下载并整理好,通过 Emby 或 Jellyfin 在任何设备上流畅播放,画质清晰且无广告。
收藏夹与稍后再看备份:B 站收藏夹里的视频因为各种原因失效或下架。bili-sync 可以自动把你收藏的内容备份到本地,保存你珍视的视频资料。
离线环境观看:为没有网络或网络不佳的环境(如旅途、学校、偏远地区)提前下载好想看的系列视频,随时可以打开观看。
UP 主视频归档:如果你是某个 UP 主的粉丝,可以用它自动归档所有历史投稿,作为个人收藏。
定价与授权
bili-sync 是一个基于 MIT 协议发布的开源项目,免费,个人或商业用途均可免费,无任何功能限制。
应用示例:用 Docker 在 NAS 上部署 bili-sync
-
在你的 NAS 上准备好 Docker 环境(如群晖的 Container Manager 或威联通的 Container Station)。
-
通过 SSH 登录 NAS,创建一个用于存放配置和视频的目录,
/volume1/docker/bili-sync。 -
在该目录下创建一个
config.toml配置文件,填入你的 B 站 Cookie(用于认证)和想要同步的视频源(如 UP 主的 mid)。 -
运行 Docker 命令,将配置目录和下载目录挂载进去:
docker run -d --name bili-sync -v /volume1/docker/bili-sync:/config -v /volume1/video/bilibili:/download ghcr.io/amtoaer/bili-sync:latest -
之后,bili-sync 就会在后台运行,你指定的视频会逐渐出现在下载目录中。
系统支持
bili-sync 支持以下平台和方式:
-
Docker:推荐方式,支持 x86_64 和 ARM(如树莓派)架构的 NAS。
-
二进制文件:提供 Windows、Linux、macOS 的可执行文件。
-
源码编译:Rust 开发者可以自行编译。
| 源码反馈/咨询 (共有 条反馈) |
bili-sync常见问题
bili-sync不是公司项目,而是由GitHub用户amtoaer个人开发并维护的开源工具。
bili-sync是一款可以部署在NAS或服务器上的B站视频自动下载和整理工具,它能帮你把关注的UP主视频、收藏夹等内容自动同步到本地,并整理成媒体库格式。
bili-sync是免费的,它是一个基于MIT协议的开源项目。
软件本身是安全的,代码在GitHub开源透明。使用时需要你提供自己的B站账号Cookie进行认证,请妥善保管自己的Cookie,不要泄露给他人。
登录B站网页版后,按F12打开开发者工具,在“应用程序”(Application)或“存储”(Storage)标签页中找到Cookies,查找https://www.bilibili.com下的SESSDATA字段,复制它的值即可。
可以。bili-sync会自动选择你设置的画质范围内的视频流进行下载,如果该视频提供4K或8K选项,且你的账号有权限,它就会下载画质。
这正是它的核心优势。bili-sync下载和整理的文件结构符合Emby、Jellyfin、Plex的命名规范,直接导入就能自动刮削出海报、简介等信息,形成精美的影视墙。
支持。它会将弹幕下载为XML格式文件,支持弹幕的播放器(如Emby的弹幕插件或Infuse)可以直接加载。
推荐使用Docker方式。在群晖的ContainerManager中,通过注册表搜索ghcr.io/amtoaer/bili-sync下载镜像,然后创建容器,将你的配置文件夹和下载文件夹映射进去即可运行。
在配置文件config.toml中,找到视频源配置部分,添加上UP主的mid(用户ID)即可。UP主的mid可以在个人空间页面的网址中找到。
bili-sync使用Rust开发,性能很高,在NAS上运行时,内存占用只有几十MB,CPU占用也很低,几乎不影响他服务。
支持。发布页提供了macOS的可执行文件,也可以使用Docker或从源码编译的方式在Mac上运行。
有。程序启动后,会提供一个本地的Web管理页面,你可以通过浏览器访问http://你的NASIP:端口来查看任务状态、管理视频源和下载队列。
bili-sync有自动重试机制。如果是网络波动等临时问题,下一轮同步时会自动重试。如果多次失败,可以在Web界面或日志中查看具体错误原因,常见问题包括Cookie失效或视频本身被删除。