Olares 1.12.6 下载客户端路径迁移实战:qBittorrent、NZBGet、Transmission 与 Deluge 统一挂载结构适配指南

原创2026-10-15 17:24:481,836 阅读
文章标签:云原生后端运维

Olares 1.12.6 下载客户端路径迁移实战:qBittorrent、NZBGet、Transmission 与 Deluge 统一挂载结构适配指南

本文将围绕 Olares V1.12.6 的“统一目录挂载结构”变化,讲解 qBittorrent、NZBGet、Transmission、Deluge 四类下载客户端默认下载路径的完整迁移方法。读完本文,你将掌握旧/新路径的映射关系、每个客户端的具体修改步骤,以及更新后 qBittorrent WebUI 出现登录要求时的配置级排查与免密访问恢复方案。

一、为什么要改路径:统一目录挂载结构

Olares V1.12.6 引入了新的统一目录挂载结构:*Arr 应用(Sonarr、Radarr 等)与下载客户端现在能看到相同的路径,不再需要各自维护一套路径映射。

从源码结构看,用户数据目录 /olares/userdata 是平台层挂载用户空间的基准 hostPath:

这意味着更新后,客户端内原本指向 /downloads/... 的路径已不再对应同一块物理位置,而 /olares/userdata/... 才是 *Arr 应用与下载客户端共同可见的新路径。如果继续保留旧路径,下载任务可能写入错误位置,或导致 *Arr 应用找不到已完成的任务。

如果你的 *Arr 应用与下载客户端联动,请同时阅读 *Arr 应用更新说明,了解应用连接改为内部入口 URL、根文件夹路径变更,以及可以移除“远程路径映射”的原因。本文的英文原文见 docs/use-cases/download-clients-upgrade.md。

旧路径与新路径映射总览

客户端 旧路径(更新前) 新路径(V1.12.6 起)
qBittorrent /downloads/home/Downloads/qBittorrent /olares/userdata/home/Downloads/qBittorrent
NZBGet(DestDir) /downloads/completed /olares/userdata/home/Downloads/nzbget/completed
NZBGet(InterDir) /downloads/intermediate /olares/userdata/home/Downloads/nzbget/intermediate
Transmission(下载到) /downloads/complete /olares/userdata/home/Downloads/transmission/complete
Transmission(临时文件夹) /downloads/incomplete /olares/userdata/home/Downloads/transmission/incomplete
Deluge /downloads /olares/userdata/home/Downloads/deluge

二、更新 qBittorrent 的默认保存路径

  1. 打开 qBittorrent。

  2. 在工具栏中选择工具 > 选项。

  3. 在选项窗口中,进入下载选项卡。

  4. 将默认保存路径从 /downloads/home/Downloads/qBittorrent 更新为 /olares/userdata/home/Downloads/qBittorrent。

    qBittorrent 默认保存路径

  5. 向下滚动并点击保存。

更新后 qBittorrent 要求登录怎么办

如果 qBittorrent 之前允许你无需登录即可访问 WebUI,但更新后提示输入凭据,可能是迁移脚本没有保留认证设置。处理流程如下:

  1. 打开 Control Hub,查看 qBittorrent 容器日志,找到临时用户名(通常为 admin)和密码。

  2. 登录 qBittorrent 并确认其正常工作。

  3. 根据需要设置新的用户名和密码。

  4. 要恢复免密码访问:

    a. 打开 Olares 文件,编辑 /Data/qbittorrent/qBittorrent.conf。

    b. 在 [Preferences] 部分,添加或更新以下值:

    WebUI\Address=*
    WebUI\ServerDomains=*
    WebUI\Port=8080
    WebUI\CSRFProtection=false
    WebUI\HostHeaderValidation=false
    WebUI\LocalHostAuth=false
    WebUI\AuthSubnetWhitelistEnabled=true
    WebUI\AuthSubnetWhitelist=0.0.0.0/0, ::/0
    

    c. 保存文件并重启 qBittorrent。

如果问题仍然存在,请备份现有配置,删除 qBittorrent.conf,然后重启 qBittorrent。初始化过程将重新创建一个默认配置,并启用免密码访问。之后,你可以逐行重新应用之前的设置,以找出冲突的选项。

这段配置的每一行都有明确的 WebUI 安全语义:WebUI\Address=* 与 WebUI\ServerDomains=* 放开监听与域名限制;WebUI\CSRFProtection=false、WebUI\HostHeaderValidation=false、WebUI\LocalHostAuth=false 关闭 CSRF 防护、Host 头校验与本地主机认证;最后两行通过 WebUI\AuthSubnetWhitelistEnabled=true 与白名单 0.0.0.0/0, ::/0(即 IPv4 与 IPv6 全地址段)实现内网免密。需要强调,这是一组“为局域网免密访问而放宽”的配置,如果你通过公网或反代暴露 qBittorrent WebUI,应当保留登录认证并谨慎评估这些放宽项的风险。

三、更新 NZBGet 的下载路径

  1. 打开 NZBGet,进入设置 > PATHS。
  2. 更新以下路径:
    • DestDir:将 /downloads/completed 改为 /olares/userdata/home/Downloads/nzbget/completed
    • InterDir:将 /downloads/intermediate 改为 /olares/userdata/home/Downloads/nzbget/intermediate
  3. 保存设置并重启 NZBGet。

NZBGet 是典型的“两段式”目录设计:InterDir 存放下载与解压过程中的中间数据,DestDir 存放最终成品,Prowlarr/Sonarr 等应用通常只关注 DestDir。两处路径都要同步更新,且建议按官方目录名 nzbget/completed 与 nzbget/intermediate 落在统一挂载结构下,保证 *Arr 应用能按新根目录直接看到成品。

四、更新 Transmission 的下载路径

  1. 打开 Transmission,点击右上角的菜单图标,然后选择编辑首选项。
  2. 更新以下路径:
    • 下载到:将 /downloads/complete 改为 /olares/userdata/home/Downloads/transmission/complete
    • 使用临时文件夹:将 /downloads/incomplete 改为 /olares/userdata/home/Downloads/transmission/incomplete

Transmission 的“使用临时文件夹”对应 incomplete 阶段:启用临时文件夹时,任务会先在 incomplete 目录落盘,完成后移动到“下载到”目录。两个路径应成对更新,避免完成后移动阶段跨挂载点导致行为异常。

五、更新 Deluge 的下载路径

  1. 打开 Deluge,进入首选项 > 下载。
  2. 将下载路径从 /downloads 更新为 /olares/userdata/home/Downloads/deluge。
  3. 点击应用,然后点击确定。

六、迁移完成后的验证与配套事项

  • 验证落盘位置:在客户端发起一个测试任务,确认文件确实出现在 /olares/userdata/home/Downloads/<client>/... 下;在 Olares 文件管理器中应能看到与客户端内部一致的路径字符串,这正是统一挂载结构“*Arr 与下载客户端共用同一路径”的体现。
  • *配合 Arr 应用更新:如果 Sonarr/Radarr 的根文件夹仍指向旧路径,请参照 *Arr 应用更新说明 将根文件夹更新为 /olares/userdata/... 形式(例如将 /home/Movies 改为 /olares/userdata/home/Movies/),并移除不再需要的远程路径映射。
  • 应用间连接:V1.12.6 起 *Arr 应用之间通过内部入口 URL 通信,旧连接可能失效,同样以 docs/zh/use-cases/arrs-upgrade.md 中的步骤更新。
  • 配置可备份:qBittorrent 的配置位于 /Data/qbittorrent/qBittorrent.conf,改动前建议先备份;其余客户端通过 WebUI 保存的设置变更也可通过重启前保存来保证生效。

适用前提:本节所有路径与操作基于 Olares V1.12.6 的更新说明(docs/zh/use-cases/download-clients-upgrade.md,app_version: 1.0.x)。不同版本的挂载结构可能不同,操作前请确认当前版本。

登录后查看全文
Terminus