企业官网建设流程全解析

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

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

Jackett 是一个种子站点 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 请求里追加&cache=false即可跳过缓存。你实际得到的是：重复搜索秒回，站点压力可控。

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 常驻中间，配置一次后基本不需要再碰。

性能与配置调优：五个可执行动作

1. 缓存参数：内存充裕且查询频繁时，调大 "Cache max results per indexer"（默认 1000）；遇到结果陈旧或内存吃紧时，调小 TTL（默认 2100 秒）或干脆关闭缓存。
2. 索引器列表做减法：只保留实际会用的 tracker，其余全部 disable。启用的索引器越多，每次全量搜索越慢，对站点的请求量也越大。
3. 设置 Blackhole 目录：在设置里指定一个黑洞目录，测试下载统一落在这里，验证 magnet 有效性时不会污染真实下载库。
4. 外部访问与代理：默认只绑定 127.0.0.1；仅当其他机器要调用 API 时才勾选 "External access"。需要走代理访问的站点，在同一页面配置代理类型、地址和端口。
5. 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