docs: 文档跟进最新代码变化 (#275)

This commit is contained in:
ᴀᴍᴛᴏᴀᴇʀ
2025-02-19 22:12:47 +08:00
committed by GitHub
parent 4765d6f50a
commit 2bfd69c15e
7 changed files with 71 additions and 0 deletions

25
docs/question.md Normal file
View File

@@ -0,0 +1,25 @@
# 常见问题
## 各种文件找不到问题,如运行后找不到初始 `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 版本引入了一个简陋的[管理页](/frontend)来支持这个功能,你可以查询特定视频并点击重置,这样在下次下载任务触发时就会重试这个任务了。