NAS佬还是对B站下手了！用bili-sync将B站视频同步到本地保存-武穆逸仙 In September 2025

NAS 佬还是对 B 站下手了！用 bili-sync 将 B 站视频同步到本地保存

某天刷 B 站突然想起一个看过并收藏的视频，当我点开收藏夹想再看一遍的时候，发现有不少视频变这样了。

NAS 佬还是对 B 站下手了！用 bili-sync 将 B 站视频同步到本地保存

小电视哭丧着脸，我也是一脸懵。这好好的视频说下架就下了吗？

看来数字内容还是攥在自己手里才方便，平台里网盘里的东西说没就没了。

正好最近关注到一个开源哔哩哔哩工具项目 【bili-sync】，可以定时自动化把 B 站收藏的合集和收藏夹内容同步到本地。

这不巧了嘛咱有 NAS 呀，要空间有空间要挂机有挂机，只需要 Docker 部署一下，就再也不用看小电视两眼汪汪了。

说干就干，查阅项目文档，5 分钟搞定部署成功，体验了一下还真是方便。

先来介绍一下这款神器。

bili-sync 是什么？

bili-sync 是一款专为 NAS 用户编写的哔哩哔哩同步工具。

NAS 佬还是对 B 站下手了！用 bili-sync 将 B 站视频同步到本地保存

它的基本的工作原理是使用用户填写的凭据定期扫描视频合集、收藏夹等，获取到本地未下载过的内容并保存到本地，维持本地视频库与哔哩哔哩网站的同步。

下载的内容包括视频、封面、弹幕、标签与简介信息等，这些文件整体保持与 Emby、Jellyfin 等媒体服务器软件兼容的文件布局，使得目的文件夹可以直接被作为媒体库添加到这些软件中，无需干预自动识别。

如何安装 bili-sync？

作者为各个平台提供了预构建的二进制文件，并且打包了 Linux/amd64 与 Linux/arm64 两个平台的 Docker 镜像。用户可以自行选择使用哪种方式运行。

也就是说你不仅可以在支持 Docker 的 NAS 服务器上运行。同样也可以在 PC 上通过双击打开可执行文件直接运行。最终都是通过启动一个 WebUI 可视化界面，进行配置和所有操作。

区别就是 NAS 服务器一般是 24 小时不关机的，更适合定时同步更新，而 PC 一旦关机，就没法离线执行查询下载任务了。如果你没有 NAS 又想尝尝鲜，那也可以用 PC 试试，二进制文件支持 Linux 系统、Mac 和 Windows 系统。

安装前准备

bili-sync 是通过浏览器登录 B 站，获取用户 cookies 信息，根据填入的用户凭据，用 bilibili 的 API 接口连接 B 站，获取信息。

所以需要先用浏览器登录并找到以下五个参数信息保存备用：

SESSDATA：
bili_jct：
buvid3：
DedeUserID：
ac_time_value：

前面四个参数为 Cookies 参数，以 Edge 浏览器为例，登录 B 站后，按 Ctrl+Shift+I 或者 F12 打开开发者工具，在上方点击【应用程序】选项卡，左侧点【Cookie】展开，点击 https://www.bilibili.com 标签，复制对应的参数值保存。

NAS 佬还是对 B 站下手了！用 bili-sync 将 B 站视频同步到本地保存

最后一个 ac_time_value 相对特殊，仅用于刷新 Cookies，打开开发者工具，进入控制台，输入 window.localStorage.ac_time_value 即可获取值。

NAS 佬还是对 B 站下手了！用 bili-sync 将 B 站视频同步到本地保存

以上参数详细说明及不同浏览器获取教程，详见 bilibili-api 获取 Credential 类所需信息（https://nemo2011.github.io/bilibili-api/#/get-credential）

Docker 安装

推荐使用 Compose 安装，文档给出的 Docker Compose 文件注释详尽，大家可以根据自己机器情况修改：



services:
  bili-sync-rs:
    # 不推荐使用 latest 这种模糊的 tag，最好直接指明版本号
    image:amtoaer/bili-sync-rs:latest
    restart:unless-stopped
    network_mode:bridge
    # 该选项请仅在日志终端支持彩色输出时启用，否则日志中可能会出现乱码
    tty:true
    # 非必需设置项，推荐设置为宿主机用户的 uid 及 gid (`$uid:$gid`)
    # 可以执行 `id ${user}` 获取 `user` 用户的 uid 及 gid
    # 程序下载的所有文件权限将与此处的用户保持一致，不设置默认为 Root
    user:1000:1000
    hostname:bili-sync-rs
    container_name:bili-sync-rs
    # 程序默认绑定 0.0.0.0:12345 运行 http 服务
    # 可同时修改 compose 文件与 config.toml 变更服务运行的端口
    ports:
      -12345:12345
    volumes:
      -${你希望存储程序配置的目录}:/app/.config/bili-sync
      # metadata/people 正确挂载才能在 Emby 或 Jellyfin 中显示 UP 主头像
      # 右边的目标目录不固定，只需要确保目标目录与 bili-sync 中填写的“UP 主头像保存路径”保持一致即可
      -${Emby 或 Jellyfin 配置下的 metadata/people 目录}:/app/.config/bili-sync/upper_face
      # 接下来可以挂载一系列用于保存视频的目录，接着在 bili-sync 中配置将视频下载到这些目录即可
      # 例如：
      # - /home/amtoaer/HDDs/Videos/Bilibilis/:/home/amtoaer/HDDs/Videos/Bilibilis/
    # 如果你使用的是群晖系统，请移除最后的 logging 配置，否则会导致日志不显示
    logging:
      driver: "local"

我是使用飞牛 Docker Compose 安装，如果你 NAS 也是飞牛系统，可以照抄。

在文件管理里，飞牛存储空间创建以下文件夹路径：Docker/compose/bili-sync；/Media/bili-sync；右键->【详细信息】->【复制原始路径】。

NAS 佬还是对 B 站下手了！用 bili-sync 将 B 站视频同步到本地保存

打开飞牛 Docker，点【Compose】->【新增项目】，项目名称随意，路径粘贴刚才复制的 compose 完整路径，来源勾选【创建 docker-compose.yml】，在下方输入框填入 compose 配置。

NAS 佬还是对 B 站下手了！用 bili-sync 将 B 站视频同步到本地保存

我的飞牛 Compose 文件如下，注意 volumes 下面的挂载目录，即: 前面的文件夹路径，填入上一步创建的/Media/bili-sync 文件夹完整路径，根据自己的设备存储空间不同，需要自行修改：



services:
  bili-sync:
    image:amtoaer/bili-sync-rs:latest
    container_name:bili-sync
    user:0:0
    ports:
      -12345:12345
    volumes:
      -/vol1/1000/Docker/bili-sync/config:/app/.config/bili-sync
      -/vol1/1000/Media/bili-sync:/bilibili
      -/vol1/1000/Media/bili-sync/upper_face:/app/.config/bili-sync/upper_face
    restart: unless-stopped