常见问题

各种文件找不到问题，如运行后找不到初始 config.toml、提示成功下载但看不到视频文件等。

请检查挂载位置与配置文件填写是否正确，需要理解的是：

1. 容器挂载是把宿主机的 /A 挂载到容器内的 /B；
2. 程序运行在容器中，能够读取、写入的目录只能是 /B，因此配置文件内填写的路径只能与 /B 有关。

下载视频出现 Permission denied、Operation not permitted 等错误。

有两种可能的原因：

1. 容器运行时指定了 user（非 root），但配置文件并未正确填写挂载后的路径。此时目标路径只是一个普通的容器内路径，非 root 用户无法修改，导致执行出错；
2. 配置文件正确填写了挂载后的路径，此时出现权限错误说明你为容器指定的 user 无权写入宿主机上的原始路径。需检查宿主机原始路径的文件权限。

下载某个视频连续多次出现 error decoding response body 错误

这个问题我也出现过几次，目前还不清楚原因，但怀疑是 b 站服务器使用某种检测机制拒绝了响应。

bili-sync 在 2.4.0 版本引入了一个改动，不将此错误计入错误次数，允许其无限重试，我过去下载失败的某个视频使用这个策略在多次尝试后成功了。

尽管如此，该解决方案仍然比较玄学，需要将来能够查明具体原因再加以修复。

有些视频已经达到了最大重试次数还没有成功，我可以手动重试吗？

2.4.0 版本引入了一个简陋的管理页来支持这个功能，你可以查询特定视频并点击重置，这样在下次下载任务触发时就会重试这个任务了。