Jackett 快速指南:如何搭建跨站点统一种子搜索服务

发布时间:2026/9/17 4:03:30
Jackett 快速指南:如何搭建跨站点统一种子搜索服务
Jackett 快速指南如何搭建跨站点统一种子搜索服务【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/JackettJackett 是一个种子站点 API 聚合服务它把上百个公开、半私人和私有 tracker 的搜索接口封装成统一的 API 输出。你不需要逐个站点访问、也不必关心每家的登录方式和反爬差异一次查询就能拿到多个 tracker 的聚合结果并交给媒体管理工具作为标准数据源。项目定位Jackett 是什么适合谁用Jackett 的定位是夹在你和 tracker 站点之间的中间层一端用内置的索引器indexer与每个站点说各自的原生语言——处理登录、抓取、Cookie 和反爬另一端输出标准化的 Torznab 与 TorrentPotato 两种协议结果。协议转换、字段映射这些脏活都被它吸收在内部。对普通用户最直接的价值是 Web 控制台一个关键词搜出多个站点的资源横向对比大小、做种人数和分类后挑一个下载。对运行自动化媒体栈的人它的价值是适配器Sonarr、Radarr 这类工具只需要填一个 Torznab 地址和一个 API Key就能搜索 Jackett 已接入的全部 tracker不用为每个站点单独配置。先跑起来如何构建启动 Jackett 并验证服务Jackett 是 .NET 项目支持 Windows、Linux 和 macOS。最省事的路线是使用 release 中的预编译二进制包README.md 里有各平台的详细步骤如果你想从源码跑起来流程很短git clone https://gitcode.com/GitHub_Trending/ja/Jackett cd Jackett dotnet build dotnet run --project src/Jackett.Server验证是否跑通浏览器打开http://127.0.0.1:9117能看到 Configured Indexers 管理页面、右上角显示 API Key下方是索引器列表初始为空说明服务已启动。此时点 Add indexer 能打开站点列表、并在 Configuration 里设置管理员密码说明控制台可用。走一个真实场景添加两个 tracker搜一部片拿到聚合结果任务目标用关键词从两个公开 tracker 同时搜资源对比结果后取走链接。第 1 步添加索引器。打开管理页点 Add indexer选两个无需登录的公开站点例如 The Pirate Bay、1337x直接保存。公开站点没有参数可填保存后每行右侧 Test 出现绿色勾表示连接正常。第 2 步手动搜索。点顶部的 Manual Search在 Query 框输入片名加清晰度如 Big Buck Bunny 720p可用上方的 Tracker 和 Category 下拉框进一步收窄范围然后执行搜索。第 3 步读结果。结果表把所有 tracker 的资源聚合在一张表里列出发布时间、来源 tracker、文件名、大小、分类、做种/下载人数表格上方还会标注每个 tracker 各返回了多少条结果、耗时多少毫秒方便判断哪个站点这次响应更快。预期结果一份列表覆盖多个站点的结果看中哪条就复制它的 magnet 或 torrent 链接交给下载客户端即可。核心功能与原理Jackett 实际在做的四件事索引器插件体系每个 tracker 对应一个独立的索引器定义仓库把 YAML 形式的定义放在 src/Jackett.Common/Definitions/ 目录下部分站点还有对应的 C# 实现src/Jackett.Common/Indexers/Definitions/。设计思路是新增站点 新增一个定义且单个索引器出错、被禁或被墙时不影响其余索引器。你实际得到的是索引器可以逐个启用、逐个测试管理成本不随站点数量线性上升。Torznab / TorrentPotato 双协议输出Jackett 把各站点的响应翻译成标准协议字段分类、大小、magnet、做种数等并为每个索引器以及全部各生成一个 API 地址。设计意图是让下游工具完全不感知站点细节只面对一套字段。你实际得到的是媒体管理工具配置一次就能检索所有已接入站点换站点只改 Jackett 里的索引器不用动下游配置。搜索结果缓存默认每个查询结果缓存 2100 秒35 分钟每个索引器最多保留 1000 条以控制内存占用。设计意图是减少对 tracker 站点的重复请求、压低响应延迟同时降低被站点限频的风险某次查询想要最新结果时在 Torznab 请求里追加cachefalse即可跳过缓存。你实际得到的是重复搜索秒回站点压力可控。FlareSolverr 反爬集成部分站点有 Cloudflare 之类的挑战页Jackett 自己无法通过。单独部署 FlareSolverr 服务后在 Jackett 配置里填入它的 API URL默认端口 8191对受保护站点的请求会先经它完成挑战、换回 Cookie。你实际得到的是这类够不着的站点也能纳入聚合流程而不必每次手动过验证。与生态工具的协作Jackett 如何和 Sonarr、下载客户端搭配Jackett 负责搜到并交付结果链路其余环节由其他工具分工承担Sonarr电视剧自动化按更新计划触发搜索并整理剧集文件Radarr电影自动化同一套思路用于影片Lidarr音乐资源管理qBittorrent / Transmission / Deluge下载客户端负责把 Jackett 找到的资源真正下下来以 Sonarr 为例的组合演示在 Jackett 管理页点 Copy Torznab Feed 复制全局地址连同右上角的 API Key 一起填入 Sonarr 的 Torznab 索引器配置之后在 Sonarr 里添加要追的剧它会定期经 Jackett 检索所有已启用 tracker拿到匹配结果后交给下载客户端完成下载和入库。整条链路中 Jackett 常驻中间配置一次后基本不需要再碰。性能与配置调优五个可执行动作缓存参数内存充裕且查询频繁时调大 Cache max results per indexer默认 1000遇到结果陈旧或内存吃紧时调小 TTL默认 2100 秒或干脆关闭缓存。索引器列表做减法只保留实际会用的 tracker其余全部 disable。启用的索引器越多每次全量搜索越慢对站点的请求量也越大。设置 Blackhole 目录在设置里指定一个黑洞目录测试下载统一落在这里验证 magnet 有效性时不会污染真实下载库。外部访问与代理默认只绑定 127.0.0.1仅当其他机器要调用 API 时才勾选 External access。需要走代理访问的站点在同一页面配置代理类型、地址和端口。FlareSolverr 超时保持默认 55000ms挑战页特别慢时再上调设置过低会让受保护站点误报无结果。常见故障排查按频率排序的四个问题现象索引器 Test 打叉、搜索无结果。可能原因站点临时不可用、索引器参数配错、本地网络到不了该站点。处理步骤先点 Test All 看是个别失败还是全部失败排除 Jackett 自身问题再用浏览器直接访问该站点确认是否可达确实够不到的站点配置代理后重试。现象某类 tracker 的结果始终为空或返回 403。可能原因Cloudflare 挑战未通过。处理步骤部署 FlareSolverr 服务在 Jackett 里填好它的 API URL确认服务在运行后重新测试对应索引器。现象下游工具报 API 调用失败。可能原因API Key 复制不全、Feed 地址漏了 base path、端口未放行。处理步骤重新复制页面顶部的 API Key在浏览器里直接访问 Torznab Feed 地址确认能返回 XML核对设置页的端口9117与 Base path override 是否一致。现象搜索明显变慢或收到站点限频。可能原因缓存 TTL 过长叠加索引器数量过多请求密集。处理步骤调小 TTL禁用低频使用的索引器并避免多个工具同时对 Jackett 发起高频查询。收尾清单http://127.0.0.1:9117能打开管理页右上角可见 API Key管理员密码已设置至少添加 1 个公开索引器Test 显示通过手动搜索过一次能看到多个 tracker 的聚合结果缓存 TTL 与每索引器最大结果数已确认不用的索引器已禁用需要访问受 Cloudflare 保护的站点时FlareSolverr 已部署并配置 URL更多安装细节、受支持系统清单与 tracker 列表见 README.md索引器的具体定义可以看 src/Jackett.Common/Definitions/。【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/Jackett创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考