Jackett：一站式种子聚合搜索，3步完成媒体库接入
刚给电视装好Plex，又在Sonarr里配好了追剧规则，结果添加索引源时发现：这些工具只认Torznab格式（一种标准化的种子搜索API协议）的接口，而你收藏的那几个种子站压根没有标准API。
Jackett就是干这件事的。它是一个种子聚合代理服务器（proxy server，充当中间人，把不同网站的响应翻译成统一格式），内置了对数百个公共、半私人和私人Tracker（种子分享站点）的适配逻辑。你在Sonarr或Radarr里填入Jackett的地址，一次搜索即可覆盖所有已配置站点。
快速上手：从零到跑通
最简启动路径
Windows用户：从Releases页下载.exe安装程序，安装时勾选"Install as Windows Service"和"Launch Jackett"，完成后托盘图标即代表服务已运行。
Linux / macOS 用户，从源码构建只需4步：
git clone https://gitcode.com/GitHub_Trending/ja/Jackett cd Jackett/src dotnet publish Jackett.Server -f net9.0 --self-contained -c Release ./Jackett.Server/bin/Release/net9.0/linux-x64/jackett首次启动验证
浏览器打开http://127.0.0.1:9117，你会看到索引器管理面板。做两件事确认一切正常：
- 点击Add indexer，搜索并添加一个公共索引器（如 1337x），无需注册账号
- 点击该索引器右侧的Test按钮，出现绿色勾即表示连接成功
图：Jackett主面板，每个索引器独立提供Torznab Feed复制、测试和删除操作
核心能力速览
索引器集中管理
在同一个面板中完成所有种子站点的添加、配置、测试和启停。
解决什么：不用在十几个网站之间来回切换填账号密码。
怎么用：Add indexer 选择站点，填入凭据，点 Test 验证。每个索引器可独立禁用或删除，互不影响。
Torznab / TorrentPotato 标准API
将各站点的搜索结果统一翻译为Torznab XML或TorrentPotato JSON格式输出。
解决什么：Sonarr、Radarr等工具只认标准协议，而大部分种子站没有API。
怎么用：索引器列表页点Copy Torznab Feed，把生成的URL和API Key粘贴到Sonarr的索引器设置里即可。
跨站手动搜索
一个搜索框同时查询所有已配置索引器，结果合并展示。
解决什么：手动找资源时不用逐站输入关键词再逐页对比。
怎么用：面板顶部点Manual Search，输入关键词，按需选择Tracker和Category过滤，结果按发布时间排序。
图：手动搜索"Big Buck Bunny 720p"，同时查询Internet Archive和The Pirate Bay，结果合并排序
智能搜索缓存
在本地缓存相同查询的结果，减少对种子站的重复请求。
解决什么：避免频繁请求触发站点反爬封禁，同时加快响应速度。
怎么用：默认开启，缓存TTL 2100秒，每索引器最多缓存1000条。设置页可调整或关闭。
深度实操：分角色体验指南
个人用户：家庭媒体中心
推荐配置：添加3-5个公共索引器（1337x、The Pirate Bay、YTS等），缓存保持默认。
操作流程：
- Jackett面板添加索引器 → Test通过
- 复制该索引器的Torznab Feed地址
- Sonarr → Settings → Indexers → 新建Jackett → 粘贴Feed URL和API Key
💡实践提示：API Key在Jackett面板顶部展示，同一个Key可同时用于Sonarr、Radarr、Lidarr多个工具，无需重复生成。
进阶用户：私有站点管理
推荐配置：按资源类型（电影、剧集、动漫、音乐）用标签分组；为高频站点提高缓存TTL；启用FlareSolverr处理有Cloudflare保护的站点。
⚙️配置建议：私有站请求频率要克制，建议缓存TTL提到3600秒以上。频繁请求是私有站账号被封的首要原因。
开发者：API集成
推荐配置：启动时加--Logging --Tracing参数记录完整请求/响应；用Filter Indexer按状态筛选查询目标。
操作流程：
- 用
t=indexers参数获取所有索引器及其能力清单 - 用Filter表达式（如
tag:movie+type:private）只查目标站点 - 用
t=tvsearch&imdbid=tt1234567做精确查询，比关键词搜索命中更准
技术亮点透视
插件式索引器定义
每个站点适配器本质是一份YAML定义加少量解析代码。Jackett把"解析某个网站"这个最易变的部分抽成独立模块，网站改版时只需更新对应定义文件，不碰核心逻辑。
对你的好处：站点改版后修复速度快，你不用重新配置；一个站点出故障不会拖垮其他站点的搜索。
查询翻译层
Jackett把Torznab参数（如t=movie&imdbid=xxx）翻译成每个站点自己的搜索表单格式。同一部电影，对站点A是关键词搜索，对站点B是IMDB ID搜索。
对你的好处：你在客户端里只写一种参数格式，Jackett自动适配每个站点的最优查询方式，省掉了逐站研究搜索语法的功夫。
效率进阶
🔧用Filter Indexer替代all：all索引器查所有站点，慢且结果上限1000条。改用tag:hd+type:private这类表达式只查目标组，响应更快、噪音更少。
📈缓存参数调优：用Sonarr/Radarr驱动自动搜索时请求量大，把Cache TTL从2100秒提到4200秒可显著减压；内存充足时把max results提到2000，缓存命中率更高。
🔧FlareSolverr解Cloudflare：部分站点启用了人机验证，在设置页填入FlareSolverr的API地址（如http://127.0.0.1:8191），Jackett遇到挑战时自动调用它获取Cookie，无需手动过验证。
📈反向代理加HTTPS：部署在NAS上时，用Nginx做反向代理并配HTTPS，避免API Key明文传输。记得同步修改Jackett设置里的Base path override。
排障速查表
| 常见问题 | 可能原因 | 处理方式 |
|---|---|---|
| 打不开9117端口 | 服务未启动或防火墙拦截 | systemctl status jackett检查服务；sudo ufw allow 9117放行端口 |
| 搜索无结果 | 索引器未正确配置或站点不可达 | 面板对该索引器点Test；浏览器直接访问该站点确认可达 |
| 提示Cloudflare protected | 站点启用了反爬验证 | 安装FlareSolverr并在Jackett设置中填入API地址 |
| 私有站搜索失败 | Cookie过期或凭据变更 | 重新编辑该索引器配置，更新登录信息 |
| Sonarr连不上Jackett | API Key或Feed URL复制错误 | 重新复制Torznab Feed；确认URL中索引器名称拼写一致 |
通用排查思路：先看日志（Linux:~/.config/Jackett/log.txt，Windows:%ProgramData%\Jackett\log.txt），再对照面板上索引器的状态标识判断是配置问题还是网络问题。
生态与扩展
- Sonarr：电视剧自动搜索、下载、命名、整理，通过Torznab Feed对接
- Radarr：电影自动管理，支持IMDB ID精确搜索
- Lidarr：音乐资源管理，使用
t=music搜索模式 - Plex / Emby：媒体服务器，与上述工具组合完成"搜索→下载→整理→播放"全链路
- qBittorrent / Transmission：下载客户端，接收Jackett返回的magnet链接
- FlareSolverr：Cloudflare挑战代理服务，Jackett原生集成配置项
- OMDb：免费电影元数据接口，仅IMDB ID时用它补全片名
图：Jackett设置页，可配置端口、代理、缓存TTL、FlareSolverr地址和OMDb Key
安全与注意事项
- 设置管理员密码：首次启动后立即在设置页设置密码，防止局域网内其他设备直接访问
- 不要裸露9117端口：Jackett默认绑定127.0.0.1，远程访问走反向代理+HTTPS，别直接对外
- 控制请求频率：私有站尤其敏感，合理设置缓存TTL，避免账号被限制
- API Key即访问凭证：拿到Key等同于能操作你所有已配置索引器，不要粘贴到公开页面
收尾
Jackett把"逐站搜索、逐站适配"这件重复且易错的事收敛成一个标准接口，让你把精力放在选内容上而不是对技术上。
下一步建议：先加2-3个公共索引器跑通流程，再逐步加入私有站点。如果工具链里已有Sonarr或Radarr，今天花10分钟配好，明天就能体验到"新资源上线→自动搜索→自动下载→自动整理入库"的完整链路。
打开Jackett面板，添加你的第一个索引器，从一次成功的跨站搜索开始。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
