下载文件未出现在预期位置，主因是保存路径配置错误或权限不足：一、Web界面设绝对路径并应用；二、Docker需-v挂载且PUID/PGID匹配；三、群晖须在File Station授qBittorrent用户读写权并填/volumeX路径；四、威联通须用/share/CACHEDEV1_DATA/格式路径；五、第三方NAS需多卷映射支持分类存储。

如果您已成功部署 qBittorrent（无论通过群晖套件、Docker 容器或原生安装），但下载完成的文件未出现在预期位置，很可能是下载保存路径未正确配置或权限缺失。以下是设置 qBittorrent 下载文件保存路径的多种配置方法：

一、通过 Web 界面修改默认保存路径

该方法适用于所有 Web UI 可访问的 qBittorrent 部署方式（如群晖套件、Docker 容器、Linux/Windows 原生安装）。其核心是直接在图形化设置中指定绝对路径，确保 qBittorrent 有权限写入该路径。

1、使用浏览器访问 qBittorrent Web 界面（例如 http://nas-ip:8080 或 http://localhost:8999）。

2、输入用户名与密码登录（默认常为 admin/adminadmin，群晖套件初始密码见系统日志）。

3、点击右上角齿轮图标进入“设置”页面，切换至“下载”选项卡。

4、在“默认保存路径”输入框中填写目标文件夹的绝对路径（例如群晖为 /volume1/downloads，威联通为 /share/CACHEDEV1_DATA/电影，CentOS Docker 为 /home/docker/qbittorrent/downloads）。

5、向下滚动至页面底部，点击“应用”按钮保存更改。

二、通过 Docker 容器挂载参数预设下载路径

该方法在容器启动阶段即绑定宿主机目录与容器内路径，避免 Web 界面误配导致文件写入失败。适用于手动执行 docker run 或通过 Portainer/Docker Compose 部署的用户。

1、确认宿主机上已创建目标下载目录（如 /volume1/downloads），并确保该目录归属用户 UID/GID 与容器环境变量一致（常见为 PUID=1026、PGID=100，群晖默认 admin 用户 UID 为 1026）。

2、在运行容器命令中添加卷映射参数：-v /volume1/downloads:/downloads（冒号前为宿主机路径，冒号后为容器内路径）。

3、确保容器内路径 /downloads 与 qBittorrent Web 设置中的“默认保存路径”完全一致。

4、启动容器后，无需再进 Web 界面修改路径，所有下载将自动落至该挂载点。

三、在群晖 NAS 中同步完成权限与路径配置

群晖套件因权限沙箱机制，仅设置 Web 界面路径不足以生效；必须同时授予 qBittorrent 应用对目标共享文件夹的读写权限，否则文件会静默失败或写入临时内存区域。

1、打开 File Station，右键目标共享文件夹（如“影视库”），选择“属性”→“权限”。

2、点击“新增”→“选择用户或群组”，找到并勾选 qBittorrent 用户（若未显示，请先启用“显示系统用户”）。

3、为该用户分配“读取/写入”权限，并勾选“应用至该文件夹内的所有文件和子文件夹”。

4、返回 File Station，右键同一文件夹→“属性”→“常规”，复制“位置”栏中的完整路径（如 /volume1/影视库）。

5、进入 qBittorrent Web 设置 → “下载” → “默认保存路径”，粘贴该路径并点击“应用”。

四、在威联通 NAS 中获取并验证共享文件夹绝对路径

威联通的共享文件夹在系统底层不直接映射到 /volumeX，而是挂载于 /share/ 下，错误使用 /volume 路径会导致下载失败或文件不可见。必须通过 SSH 获取真实绝对路径。

1、启用 NAS 的 SSH 服务（控制台 → 系统管理 → 终端机与 SNMP → 启用 SSH）。

2、使用 PuTTY 或终端连接 NAS（用户名 admin，密码同 Web 登录）。

3、执行命令 df -h 查看已挂载卷（如 CACHEDEV1_DATA）。

4、执行命令 ls /share/ 确认目标共享文件夹名（如“电影”）。

5、组合得出绝对路径：/share/CACHEDEV1_DATA/电影。

6、将该路径填入 qBittorrent Web 设置的“默认保存路径”，并点击“应用”。

五、在极空间或绿联云等第三方 NAS 中启用多路径下载支持

部分 NAS 平台限制 Docker 容器仅能挂载单个数据卷，导致 qBittorrent 在手动选择不同保存路径时失败。需通过容器配置显式声明多个挂载点，使路径可被自由选择。

1、停止当前 qBittorrent 容器。

2、编辑容器配置，在“卷”设置中添加多个映射项，例如：
宿主机路径 /mnt/sda1/downloads → 容器路径 /downloads1
宿主机路径 /mnt/sda1/tvshows → 容器路径 /downloads2。

3、启动容器后，进入 Web 界面 → “下载” → “保存管理”，在“默认保存路径”下拉菜单中即可看到 /downloads1 与 /downloads2 两个选项。

4、新建任务时，可在弹窗中手动选择对应路径，实现资源分类存储。