本文记录 AList 与容器化 qBittorrent 的连接方式,重点是排查 AList 临时目录的读写权限问题。
配置要点
- AList 在宿主机运行,qBittorrent 使用 Docker 部署。
- 挂载时应直接映射 AList 的
temp目录,而不是一个尚未创建的子目录。 - qBittorrent 的配置目录、下载目录和临时目录应分别明确映射,避免容器重建后丢失配置。
- 在 AList 的下载设置中填写 qBittorrent WebUI 地址,并立即修改默认管理密码。
排障记录
如果 WebUI 提示下载错误,先比较宿主机目录的所有者、组与权限,以及容器进程的 UID/GID。AList 重启后可能重新设置 temp 的权限,因此仅手动修改一次权限通常不能根治问题。优先采用专用的低权限服务账号,并让宿主机目录所有权和容器运行身份一致;不要为图省事以 root 或特权容器长期运行下载服务。