 首页 > 攻略 > qBittorrent如何安装和使用搜索插件_qBittorrent内置搜索引擎设置方法【进阶】

qBittorrent如何安装和使用搜索插件_qBittorrent内置搜索引擎设置方法【进阶】

时间：2026-08-28 229

qBittorrent搜索插件配置失败可按五步解决：一、用内置管理器自动安装；二、手动复制.py文件至插件目录；三、在qBittorrent.conf中启用AllowUntrustedPlugins；四、清除SearchEngine缓存并更新引擎；五、通过Web API验证插件状态与响应。

如果您在 qBittorrent 中无法调出搜索界面、点击“搜索引擎”无响应，或已安装插件但搜索时提示“无可用引擎”，则可能是由于搜索功能未启用、插件目录路径异常、插件文件损坏或配置项缺失所致。以下是完成 qBittorrent 搜索插件安装与使用的多种可行方法：

一、通过内置插件管理器启用并安装官方引擎

qBittorrent 自带图形化搜索插件管理界面，可联网拉取官方维护的引擎列表，并一键安装启用，无需手动干预文件系统，兼容性与稳定性最高。

1、启动 qBittorrent 客户端，点击顶部菜单栏的工具 → 选项 → 搜索。

2、勾选启用搜索引擎复选框。

3、点击获取搜索引擎列表按钮，等待状态栏显示“已成功获取插件列表”（需确保网络通畅）。

4、在插件列表中找到目标引擎（如The Pirate Bay、1337x、RARBG），勾选其左侧复选框。

5、点击安装选中的引擎，安装完成后关闭选项窗口并重启 qBittorrent。

二、手动复制 .py 插件文件至指定目录

部分非官方维护的社区插件（如 Jackett、EZTV 或特定小众站点插件）未被收录进默认仓库，需下载原始 Python 脚本并置于 qBittorrent 可识别的插件加载路径下，由客户端启动时自动扫描注册。

1、访问可信源（如 GitHub 上的 qbittorrent-plugins 仓库），下载对应搜索引擎的 .py 文件（例如 jackett.py 或 eztv.py）。

2、定位插件目录：
Windows：%LOCALAPPDATA%\qBittorrent\plugins\search-plugins\；
Linux：~/.local/share/qBittorrent/search-plugins/；
macOS：~/Library/Application Support/qBittorrent/search-plugins/。

3、将下载的 .py 文件复制到该目录，确保文件权限为可读（Linux/macOS 执行 chmod +r jackett.py）。

4、关闭并重新启动 qBittorrent，在视图 → 搜索引擎中确认新插件是否出现在已启用列表中。

三、修改 qBittorrent.conf 启用未签名插件支持

qBittorrent v4.4 及以上版本默认禁用未经数字签名的插件以增强安全性，若手动安装的 .py 插件未被识别，需显式开启 AllowUntrustedPlugins 选项，否则插件将被静默忽略。

1、完全退出 qBittorrent 进程（包括系统托盘残留）。

2、打开配置文件：
Windows：%APPDATA%\qBittorrent\qBittorrent.conf；
Linux/macOS：~/.config/qBittorrent/qBittorrent.conf。

3、在文件末尾查找 [Search] 区段；若不存在，则新建该区段；在其下方添加一行：AllowUntrustedPlugins=true。

4、保存文件，重新启动 qBittorrent，进入视图 → 搜索引擎检查插件状态是否变为“已启用”。

四、清除 SearchEngine 缓存并强制更新引擎索引

qBittorrent 会缓存插件元数据及搜索引擎响应结构，当插件更新或服务器返回格式变更时，旧缓存可能导致解析失败、搜索无结果或界面报错，需主动清空缓存并重建索引。

1、关闭 qBittorrent。

2、进入插件缓存目录：
Windows：%LOCALAPPDATA%\qBittorrent\nova3\cache\；
Linux：~/.local/share/qBittorrent/nova3/cache/；
macOS：~/Library/Caches/qBittorrent/nova3/cache/。

3、删除该目录下所有文件与子文件夹（保留空目录）。

4、重新启动 qBittorrent，立即前往工具 → 选项 → 搜索 → 获取搜索引擎列表执行刷新操作。