新版bili-sync部署教程

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

官网：https://bili-sync.amto.cc/introduction
github: https://github.com/amtoaer/bili-sync

注意：自 2.6.0 版本开始是数据库形式，本文教程版本为2.9.4

compose部署

1. services:
   
2.   bili-sync-rs:
   
3.     image: amtoaer/bili-sync-rs:latest
   
4.     hostname: bili-sync-rs
   
5.     container_name: bili-sync-rs
   
6.     restart: unless-stopped
   
7.     network_mode: bridge
   
8.     tty: true # 该选项请仅在日志终端支持彩色输出时启用，否则日志中可能会出现乱码
   
9.     # user: 1000:1000 # 不设置默认为 Root
   
10.     ports:
    
11.       - 12345:12345
    
12.     volumes:
    
13.       - ./config:/app/.config/bili-sync # 配置目录
    
14.       - /volume5/Media_other/BiliSync:/media # 视频保存目录
    
15.       # - ${Emby 或 Jellyfin 配置下的 metadata/people 目录}:/app/.config/bili-sync/upper_face # metadata/people 正确挂载才能在 Emby 或 Jellyfin 中显示 UP 主头像。右边的目标目录不固定，只需要确保目标目录与 bili-sync 中填写的“UP 主头像保存路径”保持一致即可

复制代码

如果设置了user，但是容器一直在重启，查看日志显示：`数据库初始化失败: Failed to migrate database`的话，说明权限不够，建议注释或者删除user一行，用默认的root。

容器启动成功后获取日志里的auth_token：


如果是第一次部署时没记录下来，后面又重新部署容器把日志刷掉了，可以停掉 bili-sync 后用 DB Browser for SQLite 或类似的工具打开 data.sqlite，config 表里存储了 json 格式的配置信息。如果config表里面没有信息的话可以试试删除这个表重新启动容器。


认证配置

1、浏览器输入IP:12345，打开 WebUI。

2、此时有个提示弹窗说未认证不用管他，我们点击左下角的设置，把刚刚在日志里的token填入输入框然后点击认证。点击完成后状态会变成已认证。


3、B 站认证

注意：V2.10.0版本后B站支持扫码认证了

认证后设置页面会出现更多设置栏目，我们来到B站认证菜单，填写所需的五个值然后点击保存设置。


其中ac_time_value用于刷新 Cookies，需要按 F12 打开开发者工具，然后进入控制台，输入`window.localStorage.ac_time_value`即可获取值。如果输入后结果是undefined，可以尝试：
- 退出重新登录
- 使用无痕模式
- 更换浏览器
- 多退出登录几次

我个人是edge和谷歌的正常和无痕都不行，也都试了一次重新登录也不行，后来在无痕模式下再退出重新登了一次才行的。

如果不会控制台输入命令，可以来到应用程序  选择本地存储，再选择bilibili，第10行左右就是ac_time_value的值。如果找不到这个参数的话，就是和上面的undefined一样，可以参考其解决方法。

剩下的sessdata、bili_jct、buvid3 和 dedeuserid 这四个参数的值均在浏览器的 Cookies 里头，获取方法：
- 按 F12 打开开发者工具
- 在工具窗口上方找到`应用程序`选项卡
- 在左侧找到`存储/Cookies`，并选中b站域名，在右侧找到对应四项即可。



下载视频

点击我创建的收藏夹菜单，可以看到所有的收藏夹，点击订阅按钮可以订阅此收藏夹，注意本地保存路径得设置对，比如我的compose里挂载的下载目录为media，则我这里是/media/运动。


这里因为有很多人不理解导致下了视频后找不到，我再多说明一下。

首先看我们compose里挂载的视频保存目录 - /volume5/Media_other/BiliSync:/media # 视频保存目录 ：

• 冒号左边：/volume5/Media_other/BiliSync 是你的绿联 NAS 本地实际路径，这个路径可以右键对应文件夹→属性查看复制，是视频文件最终实际保存的位置；
• 冒号右边：/media 是容器内部的挂载映射路径，可自定义为 /download 或者 /save 等任意名称，只要使用的时候保持一致即可。
  

保存路径设置规则：
容器会通过冒号右侧的容器挂载路径，映射到 NAS 本地的实际路径，所以在容器的视频保存设置中，保存路径必须以容器挂载路径为前缀（或直接填容器挂载路径）：

• 直接保存到 NAS 实际路径根目录：保存路径填 /media（根据你冒号右边的挂载路径来填写）；
• 保存到 NAS 实际路径的二级目录：在容器挂载路径后加后缀即可，比如我要保存到运动分类，就填 /media/运动，文件最终会出现在 NAS 的/volume5/Media_other/BiliSync/运动 文件夹下。
  

简单说：NAS 实际路径负责 【文件存在哪】，容器挂载路径负责【容器认哪】，保存路径得跟着容器挂载路径填。

不小心设置错了保存路径：


订阅完成后可以在视频源菜单看到运动这个名称，也可以点击手动添加的按钮来添加收藏夹，只是需要填写收藏夹id。其他类型的视频源类似。
注意：使用快捷订阅添加视频源后默认不启用，需要手动点击编辑后进去开启，开启的与否就是看启用状态列的滑动按钮是否在右边。如果源都没有开启，会遇到如下错误：本轮视频下载任务执行遇到错误：没有可用的视频源。



点击编辑按钮进入编辑页面，可以选择开启还是关闭这个源，或者设置过滤规则。



启用的视频源里的视频下载任务会在后台每隔特定时间自动运行一次，由配置中的“任务触发条件”决定。


也可以点击首页的立即执行下载任务手动下载启用的视频源里的任务。


在视频菜单下也可以看到所有下载的视频。


可以点击日志菜单查看情况。如果下载的时候报错`message: 账号未登录`，而且B站认证里的内容确认填写正确的话，建议重启一下容器试试。

总结一下评论区主要遇到的问题：
1、下载成功后找不到视频

检查一下本地保存路径是否是以compose挂载的容器路径开头，比如我compose里是/media，保存路径也得/media开头，比如/media/收藏夹

2、视频源没有启动

使用快捷订阅添加视频源后默认不启用，需要点击编辑进去后手动开启视频源。可以在视频源页面查看滑块状态是否开启了。

A9TKEh 发表于 2026-5-18 00:04
楼主你好，感谢教程，终于配置成功了。
下载视频的时候有两种情况：
1、某位UP主发的视频，收藏后，我是可 ...

这个程序仅会处理用户投稿视频，忽略影视、番剧等内容。因为作者仅在 pt 下载番剧，没有在 b 站看番的习惯，因此当前没有这方面的开发计划。

要是下番剧可以尝试下github issue 置顶里那个“AI 增强版”，是其他人 fork 的第三方版本，提供了番剧下载的支持。项目地址: https://github.com/NeeYoonc/bili-sync-up

66666666

大佬牛批

用了很久了  用来看小姐姐

大佬牛批

看起来好复杂

夏佬牛逼，夏佬威武。

大佬牛娃！

如果是b站会员，能同步保存4K画质的视频吗？

安装了几次，也下载了一堆，然后第二天又要重新token，太难用了