Jackett 快速上手指南:把多个种子站点的搜索接进一个 API
2026/9/11 14:16:07 网站建设 项目流程

Jackett 快速上手指南:把多个种子站点的搜索接进一个 API

【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/Jackett

Jackett 是一个用 C# 写的种子站搜索代理服务器,也是本教程的主角。它替你访问各个 tracker(种子站),把每家不同格式的搜索结果整理成统一的 Torznab 接口(一种给下载软件用的搜索 RSS 标准),供 Sonarr、Radarr、qBittorrent 等工具直接调用。仓库内置了 550 多个站点配置,Windows、macOS、Linux 都能跑。适合想自动追更影视资源、又不想手动在十几个站点之间来回切换的人。

没有它时你在重复做什么

你收藏了十几个种子站,想找一个资源,得逐个打开、逐个搜索、逐个比种子数。每个站的搜索框位置不一样,分类编码不一样,连登录方式都不一样。更要命的是站点改版、换域名之后,你的搜索脚本或下载器就跟着失效,维护成本全压在你身上。

Jackett 把这件事拆开了:访问站点、处理登录、解析结果、适配改版,这些脏活全由它干。你只管在网页界面上把站点添加进来,下游工具只需要对接 Jackett 的这一个地址。

它能帮你做什么

一次关键词,搜遍所有已配置的站点

把站点加进 Jackett 后,你在它的 Manual Search 页面输入一次关键词,它会并发访问所有站点,然后把结果合并成一张表。

  • 每个站点的耗时和命中数单独统计,哪个慢、哪个空一目了然
  • 支持按 Tracker、资源类型、分类二次筛选
  • 结果里保留种/下人数、体积、发布时间,方便横向比较

把"新资源推送"变成一条标准 Feed

Jackett 会为每个站点生成 RSS 链接。下游工具订阅这条 Feed,站点一有新上传,推送就来了,不用轮询。

  • 公共站、半私有站、私有站都能出 Feed
  • 可按站点单独开关,控制频率
  • 私有站登录失效时,Feed 会停,这本身就是个健康信号

私有站的登录态由它来管

Cookie 登录类站点,你需要在浏览器里登录一次,把 cookie 整串复制过来,Jackett 负责保管和续用。

  • 登录参数、cookie 加密保存在本地配置里
  • 支持 2FA(两因素认证)站点
  • Test 按钮可以当场验证凭证是否有效

输出格式统一,下游工具只配一次

不管背后是哪个站点,Jackett 吐出来的都是同一套 Torznab XML 或 JSON。

  • 标题、大小、时间、磁力链接字段全部对齐
  • 下载链接可以改走 Jackett 代理,隐藏真实站点地址
  • 换站点不用动下游工具的任何配置

从零跑起来:一条命令装好

以下是最常用的 Linux(AMD64)路径,下载官方发布包并注册成 systemd 服务:

cd /opt wget -O - https://github.com/Jackett/Jackett/releases/latest/download/Jackett.Binaries.LinuxAMDx64.tar.gz | sudo tar -xz cd Jackett sudo ./install_service_systemd.sh systemctl status jackett.service

装完后打开http://127.0.0.1:9117就是管理界面。不想装成服务的,直接./jackett前台运行也行。

其他平台各一句话:Windows 下载Jackett.Installer.Windows.exe安装包,勾选"Install as Windows Service"即可随系统启动;macOS 解压对应芯片的发布包(Intel 或 ARM),双击运行install_service_macos。如果系统环境比较老,用 Docker 跑第三方镜像是最省事的兜底方案。

把搜索接到下载器里:以 Torznab 为例

Jackett 在架构里的位置是"中间人":

Sonarr / Radarr / qBittorrent → Jackett(本教程主角) → 各个种子站

对接方式只涉及三个输入,以 Sonarr/Radarr 为例:

  1. 在索引器设置里新建,类型选Torznab
  2. 地址栏填 Jackett 界面上每个站点对应的Copy Torznab Feed链接(格式形如http://127.0.0.1:9117/api/v2.0/indexers/{站点ID}/torznab
  3. 把 Jackett 右上角的API Key原样粘进 Key 输入框

之后你在 Jackett 里新增、删除站点,下游工具不需要任何改动——它们认的始终是这同一个 API 地址。qBittorrent 一类客户端则通常直接填 Feed 地址加 API Key,走 RSS 订阅的方式。

原理速览:配置驱动的适配器

Jackett 的核心思路是"用配置描述站点,而不是写代码"。每个站点对应一份 YAML 定义文件,里面写清楚三件事:往哪个 URL 发搜索请求、返回的 HTML/JSON 里哪些选择器对应标题、大小、种子数,以及下载链接怎么取。Jackett 加载这些定义后,按模板发请求、按选择器抽字段,再把字段映射成统一的 Torznab 结构返回。

打个比方:它像一家翻译公司的排班表——每个站点一个岗位说明书,来了什么格式的"外语",照着说明书翻译成统一术语,翻译规则变了(站点改版)只需改说明书,不用重训员工。

所有站点定义都在 src/Jackett.Common/Definitions/ 目录,想看懂某个站怎么适配的,直接翻对应的.yml文件。接口和返回逻辑的实现在 src/Jackett.Server/Controllers/ResultsController.cs。

踩坑自查:四个高频故障

  • 现象:某站点 Test 失败、搜索超时。原因:站点换了域名,或访问太频繁被限流(429)。动作:看日志~/.config/Jackett/log.txt里的具体报错;确认站点是否还能在浏览器打开;必要时配置代理后重试。

  • 现象:cookie 登录类站点突然搜不到东西或 Test 不通过。原因:cookie 过期,私有站登录态普遍有效期不长。动作:浏览器重新登录,刷新页面后从开发者工具 Network 面板复制最新 cookie 整串,覆盖粘贴到 Jackett 配置里。

  • 现象:接口返回 401 Unauthorized。原因:API Key 复制错或中途改过。动作:以 9117 页面右上角显示的 Key 为准,到下游工具里重新粘贴。

  • 现象:手动搜索某站返回 0 条,但浏览器里能搜到。原因:关键词格式该站不支持(部分站要纯数字 ID、或带年份的写法),或站点在高峰时段禁用了排序。动作:换关键词格式重试;在站点配置里勾选"Disable sorting"再试。

写在最后

Jackett 的价值在于把"维护几十个站点适配"这件事从你身上挪走:你只负责挑选站点和登录,搜索、解析、格式统一交给它。装好、加几个站点、把 Torznab 地址填进 Sonarr 或 Radarr,整套自动化搜索链路就通了。

想继续往下读,建议从这三处入手:

  • 项目说明与完整安装方式:README.md
  • 全部站点适配定义:src/Jackett.Common/Definitions/
  • 服务端 API 实现:src/Jackett.Server/

【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/Jackett

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询