如何把上百个种子站的搜索聚合成一个Jackett面板:新手上手指南
2026/9/11 23:36:33 网站建设 项目流程

如何把上百个种子站的搜索聚合成一个Jackett面板:新手上手指南

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

Jackett 是一个专门给种子跟踪站(tracker)做"翻译"的开源代理服务,它把 Sonarr、Radarr 等应用的搜索请求转成各站点专属的查询,再把返回的 HTML 或 JSON 统一解析成标准格式(Torznab/TorrentPotato)。适合想自建影视音乐管理、又不想逐个研究站点接口的用户。

为什么需要Jackett:一个面板代替N套站点适配

问题出在"站点太散、格式太杂"上:公共站、半私站、私站的页面结构各不相同,每个应用都自己去适配,成本高而且站点一改页面就坏。Jackett 的思路是把适配逻辑集中到一处维护,你只需要跑一个实例,客户端全部对接它的标准接口。

它的职责可以概括为四件事:充当应用与跟踪站之间的桥梁、提供类似 RSS 的最新上传、跨多个跟踪站搜索、以标准化格式返回结果。仓库里的 索引器定义文件 就是这套适配逻辑的主体,每个站点一个 yml。如果你只偶尔搜一次资源,装它是多余的;但如果你打算让程序自动盯新片,Jackett 通常值得装。

装好之后第一件事就是往面板里加站点,下面先讲怎么把它跑起来。

在Windows、macOS、Linux上安装并打开Jackett面板

三个平台都从 Releases 页面拿对应安装包,默认访问地址统一是http://127.0.0.1:9117

Windows

  1. 从 Releases 下载Jackett.Installer.Windows.exe并运行
  2. 勾选"Install as Windows Service"让系统开机自启,以及"Launch Jackett"
  3. 安装完成后双击托盘图标,或直接在浏览器访问http://127.0.0.1:9117

macOS

  1. 按芯片选包:Intel 用Jackett.Binaries.macOS.tar.gz,Apple silicon 用Jackett.Binaries.macOSARM64.tar.gz
  2. 解压后进入目录,双击install_service_macos安装为登录自启服务
  3. 浏览器访问http://127.0.0.1:9117

Linux

AMD x64 可以整段粘贴下面的命令,它会下载、装为 systemd 服务并显示状态:

cd /opt && wget -O - -o /dev/stderr \ https://github.com/Jackett/Jackett/releases/latest/download/Jackett.Binaries.LinuxAMDx64.tar.gz \ | sudo tar -xz && cd Jackett* && sudo chown $(whoami):$(id -g) -R "/opt/Jackett" \ && sudo ./install_service_systemd.sh && systemctl status jackett.service

不想用长命令就分步执行:下载解压、cd /opt/Jackettsudo ./install_service_systemd.sh,然后用systemctl status jackett.service确认服务正常。Docker 用户可以直接用社区维护的 linuxserver/jackett 镜像,省去 Mono/.NET 环境配置。

面板打开后你会看到一张索引器列表页:

Jackett 索引器面板:每个站点都带 Copy Torznab Feed、编辑、Test 等操作

接下来不用急着配全家桶,先把几个最常用的开关调对。

改这几个Jackett关键配置:API key、监听与缓存

API key(右上角复制)

改什么:面板顶部的 API Key 用于鉴权,客户端连 Jackett 时要填它。为什么:所有 Torznab 请求都带apikey参数,没有它接口直接拒绝。

监听模式与端口

改什么:默认只允许本机访问;需要让局域网里的其他机器(比如跑在 NAS 上的 Sonarr)连过来时,加参数--ListenPublic启动,或用命令行开关--Port 9118换端口。为什么:默认端口是 9117,和别的工具撞了就换;对公网暴露前请确认网络边界,不要把面板直接挂到公网。

搜索缓存 TTL

改什么:Cache TTL 默认 2100 秒(35 分钟),另有"每个索引器最多缓存 1000 条"。为什么:缓存帮你省重复请求、降低被站点封 IP 的概率;嫌结果不够新就调小 TTL,机器吃紧就调小条数,问题多时甚至可以关掉缓存。

FlareSolverr 地址(可选)

改什么:Settings 里填 FlareSolverr API URL。为什么:少数站点有 Cloudflare 一类的人机验证,Jackett 自己过不了,需要这个外部代理帮忙取 cookie;大多数索引器不需要它,先不用管。

配置项理解到位后,就可以试两个最常用的场景了。

三个典型玩法:手动搜索、自动接管与Torznab查询

场景一:手动搜索多个站点

  • 操作:面板点 Manual Search,输入关键词,用下拉框限定 Tracker、Type(如 public)、Category
  • 预期:一屏内并排看到各站结果,列里带发布时长、大小、种子数,每行可以直接下载

Manual Search 界面:同一查询词在多个 Tracker 下返回的种子列表

场景二:把 Sonarr/Radarr 的找片交给它

  • 操作:在索引器行点"Copy Torznab Feed",把链接连同 API key 粘进 Sonarr 或 Radarr 的索引器配置
  • 预期:客户端定时用 Torznab 接口拉新结果,匹配到你追的剧就自动入库下载,你不再手动翻站

场景三:直接用 Torznab API 查询

  • 操作:浏览器访问形如http://127.0.0.1:9117/api/v2.0/indexers/1337x/results/torznab/api?apikey=你的key&t=search&q=关键词的链接
  • 预期:返回标准 XML;把路径里的站点名换成all会聚合所有已配置站点,还能加&cache=false强制绕开缓存拿新结果

单个场景跑通后,通常还会遇到两件事:搭配哪些工具、出了问题怎么查。

搭配Sonarr、Radarr和qBittorrent:各司其职

  • Sonarr / Radarr:为什么需要——它们负责"追更",但自己不会说各站点方言;怎么对接——在各自的 Indexer 设置里添加 Jackett 的 Torznab 链接,之后搜片就全部经由 Jackett 转发
  • Lidarr:为什么需要——管音乐的同类角色,对接方式与 Sonarr 相同,走 Torznab
  • qBittorrent:为什么需要——Sonarr/Radarr 找到资源后需要一个下载器落地;怎么对接——在客户端里填本机地址和账号,下载的文件自动归位
  • FlareSolverr:为什么需要——少数索引器带 Cloudflare 保护时充当验证代理;怎么对接——单独部署后把它的 API URL 填进 Jackett 设置

工具链搭好之后,真正会卡住新手的往往是下面这几个现象。

遇到问题怎么办:连不上、搜不到、权限报错

浏览器打不开 9117 端口→ 原因通常是服务没在跑、用了错的地址或防火墙拦了 → 处理:先试http://localhost:9117,再查服务状态(systemctl status jackett.service或 Windows 服务列表里找 Jackett),确认防火墙放行了 9117。

搜索没有结果或超时→ 原因可能是索引器配置过期、站点挂了、你的 IP 被站点封了 → 处理:在面板上对该索引器点 Test 和 Manual Search 单独验证,再确认浏览器能正常打开该站点;私站先检查账号 cookie 是否还有效。

报 Cloudflare 验证错误→ 原因是站点有人机防护,Jackett 过不了验证 → 处理:部署 FlareSolverr 并在设置里填好 API URL,多数站点其实用不到这一步。

Linux 上 Permission denied 或服务起不来→ 原因多为文件属主不对或服务配置没加载 → 处理:sudo chown -R $USER:$USER /opt/Jackett ~/.config/Jackett,然后sudo systemctl daemon-reload && sudo systemctl restart jackett.service,用journalctl -u jackett.service -n 50看最近报错。更多细节可查 README 的 Troubleshooting 部分。

回到开头那句话:Jackett 本身不产生资源,它做的是"翻译"——把各站点的查询和结果统一成 Torznab 格式,让手动搜索、自动追更、API 调用共用一个入口。你现在就可以做一件最小的事:按上面的步骤装好,在面板里添加一个公共站点并点一次 Test,绿勾亮起来,这条链路就通了。

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

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

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

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

立即咨询