Prowlarr + qBittorrent：自建「磁力搜索即下载」一条龙（保姆级教程）

本文是一篇折腾实录 + 完整安装教程。全程使用 Docker 部署，群晖 / 飞牛 / 威联通 / Unraid / 任意 Linux 通用。文中所有地址、密码均为示例，请替换为你自己的。

这套组合能干嘛？

• Prowlarr：一个搜索框，聚合几十个磁力索引站（动漫、电影、剧集、软件、游戏、俄语资源……）
• qBittorrent：轻量好用的 BT 下载器，Web 界面管理
• 两者打通后：搜到资源 → 一键推送到下载器 → 自动开始下载，全程网页操作，手机也能用

效果：不用再开十几个磁力网站来回翻，也不用复制粘贴磁力链了。

一、环境准备

1. 一台装了 Docker 的 NAS / 服务器（群晖套件中心、飞牛应用中心、威联通 Container Station 或纯 Linux 都行）
2. 给每个容器规划好配置目录和数据目录，例如：

/path/to/docker/
├── qbittorrent/config    # qB 配置
├── qbittorrent/downloads # 下载目录
├── prowlarr/config       # Prowlarr 配置
└── flaresolverr/         # （可选）FlareSolverr 配置

提示：qBittorrent 容器内的下载路径是 /downloads，对应宿主机的下载目录，映射关系要记清楚。

二、安装 qBittorrent

2.1 部署容器

docker run -d \
  --name qbittorrent \
  --restart unless-stopped \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -e WEBUI_PORT=8080 \
  -p 8080:8080 \        # Web 管理界面
  -p 6881:6881 \        # BT 监听端口（TCP）
  -p 6881:6881/udp \    # BT 监听端口（UDP）
  -v /path/to/docker/qbittorrent/config:/config \
  -v /path/to/docker/qbittorrent/downloads:/downloads \
  linuxserver/qbittorrent:latest

参数说明：

• PUID/PGID：容器内文件的属主，填你 NAS 上的用户 ID（一般 1000）
• 6881：BT 下载监听端口，需要在自己路由器上做端口转发（下面 2.4 会说）
• WEBUI_PORT：Web 界面端口，默认 8080

2.2 首次登录：去日志里找临时密码！

新版 qBittorrent（5.x）首次启动会生成一个随机临时密码，不再默认 admin/adminadmin。用下面命令看日志：

docker logs qbittorrent | grep -i password

会看到类似：

The WebUI administrator password was not set. A temporary password is provided for this session: xXxXxXxX

浏览器打开 http://<你的NAS地址>:8080，用户名 admin，密码用这个临时密码登录。

2.3 修改密码（重点坑）

qB 5.x 删除了 WebUI 里改密码的旧接口，直接改不好使。正确姿势：登录后进入 设置 → WebUI → 认证，在「当前密码 / 新密码 / 确认新密码」里改；或者用 API：

# 先登录拿 cookie
curl -c cookie.txt -X POST 'http://127.0.0.1:8080/api/v2/auth/login' \
  -d 'username=admin&password=临时密码'

# 通过 setPreferences 设置新密码（5.x 有效，webapiLogin 接口已移除）
curl -b cookie.txt -X POST 'http://127.0.0.1:8080/api/v2/app/setPreferences' \
  --data-urlencode 'json={"web_ui_password":"你的新密码"}'

2.4 必做调优

进 设置 → 连接：

然后去路由器后台（或开启 UPnP），把 6881（TCP+UDP）转发到 NAS 的内网 IP。端口映射做好后，qB 界面底部状态栏端口会显示为绿色「已连接」，下载速度会有质的提升。

三、安装 Prowlarr

3.1 部署容器

docker run -d \
  --name prowlarr \
  --restart unless-stopped \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -p 9696:9696 \
  -v /path/to/docker/prowlarr/config:/config \
  linuxserver/prowlarr:latest

访问 http://<你的NAS地址>:9696。

3.2 设置登录认证（重要）

Prowlarr 默认无认证，局域网内谁都能进。进 设置 → 常规 → 安全：

• 认证方式：Forms（表单登录）
• 认证要求：已启用
• 用户名 / 密码：自己设置

保存后会自动重启，之后访问就要登录了。

四、Prowlarr 关联 qBittorrent（核心一步）

进 Prowlarr 设置 → 应用（Apps）→ 添加应用 → qBittorrent，填写：

点「测试」，显示连接成功就保存。

坑：如果你给 Prowlarr 配了全局代理（国内访问 BT 站需要，见第六节），记得把内网地址加进代理绕过列表，否则 Prowlarr 连 qB 会走代理导致失败。

五、添加索引器

5.1 公开索引器推荐

在 Prowlarr 设置 → 索引器 → 添加索引器，搜索添加以下公开站（无需注册）：

• 动漫：Nyaa.si、Mikan、Bangumi Moe、ACG.RIP、SubsPlease、Tokyo Toshokan
• 综合：The Pirate Bay、LimeTorrents、TorrentProject2、TorrentKitty
• 电影：YTS
• 俄语资源库：RuTor、DaMagNet、Byrutor
• 软件/游戏：FileMood、GamesTorrents

一次性添加几十个也行，每个索引器独立开关，不用了随时禁用。

5.2 添加报错？可能是缺同步配置

Prowlarr 2.x 添加索引器如果报 App Profile Id must be greater than 0，说明没选同步配置文件。在索引器设置里把 应用同步配置文件（App Sync Profile） 选成默认的「Standard」即可。

5.3 验证

索引器添加成功后，回到 Prowlarr 首页搜索任意关键词（比如 ubuntu），能看到各索引器的结果。点结果旁边的发送按钮，任务就进 qBittorrent 了。

六、进阶：FlareSolverr 破解 Cloudflare 保护的站

6.1 什么时候需要？

1337x、EZTV、DaMagNet 等热门站挂了 Cloudflare 人机验证（打开会先弹「Just a moment...」）。Prowlarr 直接抓会被挡，添加索引器时报 blocked by CloudFlare Protection。这时候就需要 FlareSolverr。

6.2 部署 FlareSolverr

docker run -d \
  --name flaresolverr \
  --restart unless-stopped \
  -p 8191:8191 \
  -e LOG_LEVEL=info \
  ghcr.io/flaresolverr/flaresolverr:latest

验证：

curl http://127.0.0.1:8191/
# 返回 {"msg":"FlareSolverr is ready!",...} 就对了

国内服务器拉 ghcr.io 镜像可能很慢，可以用加速源（如 ghcr.nju.edu.cn/flaresolverr/flaresolverr:latest）。
如果 NAS 本身访问不了被墙站点，还要给 FlareSolverr 配代理：加环境变量 HTTP_PROXY、HTTPS_PROXY 指向你的代理，务必同时设置 NO_PROXY=127.0.0.1,localhost，否则它会把自己内部通信也走代理导致启动崩溃。

6.3 Prowlarr 挂上 FlareSolverr（两个隐藏机制）

① 代理必须打标签才会启用

Prowlarr 的「索引器代理」没有启用开关，它的启用逻辑是：代理打了标签才生效。

• 设置 → 标签，新建一个标签，比如 flare
• 设置 → 索引器代理 → 添加 FlareSolverr：主机填 http://<你的NAS地址>:8191
• 保存后编辑该代理，给它打上 flare 标签

② 索引器也要打同一个标签

需要走 FlareSolverr 的索引器（比如 1337x），在它的设置里也打上 flare 标签。Prowlarr 按标签匹配：索引器和代理有相同标签，请求才会经过 FlareSolverr。

6.4 新版 Cloudflare 兼容（关键细节）

新版 CF 对「无浏览器特征」的请求会返回 HTTP 200 + JS 挑战页（不是传统的 403 + Just a moment），Prowlarr 的检测逻辑认不出这种，导致 FlareSolverr 不触发。

解决办法：给索引器的 Cardigann 定义文件加上浏览器 User-Agent，骗 CF 返回标准挑战。找到 Prowlarr 容器的定义目录（/config/Definitions/1337x.yml），在 search.paths 的每个 path 下加：

search:
  paths:
    - path: "search/{{ .Keywords }}/1/"
      headers:
        User-Agent: ["Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/149.0.0.0 Safari/537.36"]
        Accept-Language: ["en-US,en;q=0.9"]

改完重启 Prowlarr 容器，重新添加/测试该索引器，就能正常通过了。

注意：Prowlarr 升级或定义更新后这些修改可能被覆盖，需要重新加。

七、国内网络访问 BT 站（代理配置）

大部分 BT 索引站在国内直连不通，Prowlarr 需要走代理。Prowlarr 自带代理设置：

设置 → 常规 → 代理：

• 启用代理：开
• 类型：SOCKS5（或 HTTP，看你代理）
• 主机 / 端口：填你的代理（比如旁路由上的 Clash、OpenWrt 透明代理等）
• 绕过过滤器：填 192.168. 之类的内网段正则，确保访问内网服务（qB）时不走代理

如果你的代理是 Clash 且规则里没有内网直连，记得加：

rules:
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
  - IP-CIDR,172.16.0.0/12,DIRECT,no-resolve

否则代理连内网设备会全部失败。

八、使用演示

1. 打开 Prowlarr http://<NAS地址>:9696，登录
2. 搜索框输入关键词，回车
3. 结果按索引器分组展示，带大小、做种数
4. 点中意结果右边的发送按钮
5. 打开 qBittorrent http://<NAS地址>:8080，任务已经在下载了 🎉

日常使用：手机浏览器也能直接操作两个 Web 界面，出门在外配合内网穿透/组网工具（如 ZeroTier、ddnsto）随时管理。

九、常见问题速查

折腾完毕。这套组合的乐趣在于：索引器随便加、随便换，全网页操作，下载任务集中管理。祝折腾愉快！