ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

Jackett 种子站点统一搜索指南:一次接入,跨站检索不再逐个对接

2026/9/11 23:21:15 拓冰建站 浏览量
Jackett 种子站点统一搜索指南:一次接入,跨站检索不再逐个对接 Jackett 种子站点统一搜索指南一次接入跨站检索不再逐个对接【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/JackettJackett 是一个跨平台的种子站点代理服务器把 Sonarr、Radarr 等应用的搜索请求翻译成各 tracker 站点的专属查询再将 HTML/JSON 结果解析为统一的 Torznab 格式返回支持上百个公共、半私有与私有站点。从一个对不上接口的困境说起假设你想用 Sonarr 自动下载新剧集。Sonarr 只说一种语言——Torznab它发出一条标准查询搜一下这部番剧给我带磁力链接的结果。但真实的 tracker 站点各说各话有的只开放网页版搜索结果藏在 HTML 表格里有的要登录、要 cookie有的还套了 Cloudflare 验证。你要么为每个站点单独写一套解析代码要么干脆放弃自动化手动一个个站点开。Jackett 就是为解决这个矛盾而生的中间层应用只对接它它负责把标准查询翻译成每个站点的专属 HTTP 请求再把返回的 HTML 或 JSON 拆回标准结果。图1Jackett 仪表盘每个索引器标注了 Public / Semi-Private / Private 类型右侧提供 Test 测试与 Feed 链接复制入口它到底站在技术栈的哪个位置一句话定义Jackett 是应用与种子站点之间的代理服务器proxy server。打个比方它像一座大型商场的总服务台。游客Sonarr、Radarr 这类客户端不用记住每个专柜在几楼、说哪种语言只要把需求告诉总服务台服务台派人去各专柜取货再把货品统一包装后递给你。取货的规则哪个站点的页面结构长什么样全部封装在服务台内部。这个设计的直接好处是tracker 集成逻辑从你的应用里被抽走了。站点改版时只需要 Jackett 侧更新对应索引器定义你的客户端一行代码都不用动。从零到跑通最短 5 步Jackett 基于 .NET当前为 .NET 9跨 Windows、Linux、macOS。下面以源码方式跑通也可以直接下载发行版压缩包或 Docker 镜像这里不展开。克隆仓库git clone https://gitcode.com/GitHub_Trending/ja/Jackett cd Jackett/src发布可执行文件以 Linux x64 为例macOS 把-r换成osx-x64或osx-arm64dotnet publish Jackett.Server -f net9.0 --self-contained -r linux-x64运行产物./Jackett.Server/bin/Debug/net9.0/linux-x64/jackett浏览器访问http://127.0.0.1:9117首次进入会提示设置管理员密码。在 Add indexer 页面挑一个站点填好配置后点 Test看到绿色对勾即接入成功。 常用启动参数--Port 9118改端口、--ListenPublic允许局域网访问、--Logging开启详细日志完整列表见 README 命令行章节。功能拆解跟着三条操作动线走动线一把站点收编进统一面板添加索引器不是一次性的事而是一条接入 → 验证 → 取用的链路。在仪表盘图1里每个站点行上有一组固定动作Test验证连接是否可用、Copy Torznab Feed把该站点的标准 Feed 地址复制到剪贴板粘贴给客户端、搜索和编辑图标。站点按 Public、Semi-Private、Private 三色标签区分方便你一眼看清哪些需要账号。实测下来有个容易忽略的点加完站点后先点 Test。Jackett 的日志和状态会记录最近一次请求是否成功客户端连上之后如果搜不到东西第一步就该回来查这里的测试结果。动线二在配置面板里调缓存这根弦图2Jackett 配置页涵盖管理员密码、代理、监听地址、缓存 TTL、FlareSolverr 与 OMDb 设置配置页图2字段很多但新手只需要关注三块Cache TTL默认 2100 秒同一查询多久之内不重复请求站点。默认值对大多数场景够用。调小能拿到更新的结果但请求变多README 也明确提示请求过频可能导致被站点封禁 IP。代理Proxy设置需要走特殊网络环境才能访问的站点在这里填代理地址即可不用改代码。FlareSolverr API URL部分站点有 Cloudflare 反爬验证Jackett 自己过不了可接入 FlareSolverr 服务代为通过。大多数站点用不到这项。另外API Key显示在页面右上角。之后给 Sonarr 之类的客户端配 URL 时apikey参数就填它。动线三手动搜索——最快的体检工具图3手动搜索 Big Buck Bunny 720p 的聚合结果顶部显示各站点参与搜索的耗时表格含大小、G/S/L、分类等列点击工具栏的Manual Search你得到一个跨站检索的即时界面图3。它的价值不在搜资源而在诊断顶部一行写着Your search was done using: Internet Archive (11) [323ms], The Pirate Bay (4) [622ms]...——每个站点返回了几条、花了多久一目了然。哪个站没出现或耗时异常问题基本就定位到了。结果表格里同一部片的不同版本尺寸、格式、来源站并排呈现右侧 DL 列可直接拿到下载链接。勾上 Show dead torrents 可以连种子数为 0 的结果一起看不勾则默认过滤。这是我在排查某站点为什么一直无结果时用得最多的入口先用浏览器确认站点本身能打开再回来看手动搜索的耗时统计两条信息一对照是站点宕机、IP 被限、还是配置错了基本可以判断。端到端走一遍一次搜索的完整旅程把上面三条动线串起来看一次真实的数据流。输入Sonarr 发出一 Torznab 查询——ttvsearchq某剧集season1ep2打向 Jackett 的http://127.0.0.1:9117/api/v2.0/indexers/站点/results/torznab/api?apikey...。系统做了什么Jackett 用 API Key 校验请求确认是合法客户端查内部缓存若 35 分钟内有相同查询直接返回缓存结果未命中缓存则按该站点的索引器定义构造真实请求——该站是网页型就用 cookie 登录并抓取 HTML 搜索页是 API 型就调 JSON 接口解析响应从表格行或 JSON 字段里抠出名称、大小、发布时间、G/S 数、下载链接打包成标准 Torznab XML 返回。你得到什么一份客户端直接可消费的标准结果其中下载链接指向/bh/indexer路由见 BlackholeController 源码——客户端点它时Jackett 会代你把真实下载地址转包出来站点的原始 URL 规则对客户端依然不可见。第二条典型链路是RSS 场景给客户端配一个 Copy RSS Feed 拿到的地址它按节奏来拉取Jackett 把站点最新上传转成 RSS 条目推过去——新片上架自动下载就建立在这条链路上。技术原理速览两个概念就够理解它Torznab统一查询语言。前面说它是总服务台的话术展开一点Torznab 规定了查询怎么提tsearch文本搜索、ttvsearch剧集搜索、tmovie电影搜索、结果怎么回XML 里的item含标题、大小、磁力/下载 URL。Jackett 同时实现了 Torznab 和 TorrentPotato 两套 API见 API 使用说明所以两边生态的客户端都能直接挂上来。Cardigann YAML用声明替代代码。这是 Jackett 扩展能力的关键。看 YTS 站点定义一个站点就是十几个字段id: yts type: public search: paths: - path: https://{{ .Config.apiurl }}/api/v2/list_movies.json response: type: json定义里声明请求打到哪、返回是 JSON 还是 HTML、字段在什么位置通用的 CardigannIndexer 引擎 负责照单执行。类比一下这相当于把爬虫从一门手艺变成了一张填好的表格。Definitions 目录 里目前有 500 个站点的 YAML而 C# 代码只覆盖 AlphaRatio、Gazelle 这类需要特殊逻辑的大家族。想给 Jackett 加新站点多数情况下写 YAML 就够了。新手避坑区❌ 加了站点不点 Test直接配给客户端 → ✅ 先 Test 出绿色对勾再分发 Feed 链接。连接没验证过的索引器客户端侧只会看到空结果而你会以为是客户端的问题。❌ 图省事一律用 all 聚合索引器 → ✅ README 明确建议如果客户端支持多个 Feed就逐站添加。all一次查所有站点慢站点会拖慢整体响应且无法按站点设置分类和搜索模式结果上限 1000 条。它适合初期快速试水不适合长期生产配置。❌ 站点报 Cloudflare 错误就反复重试 → ✅ Jackett 过不了 Cloudflare 人机验证重试只会更糟。按 FlareSolverr 配置章节 接入该服务在配置页填上 API URL 再测试。❌ 缓存开不出问题时第一反应是Jackett 有 bug → ✅ 先确认是缓存导致的旧结果还是真无结果Torznab 查询后追加cachefalse参数可强制跳过缓存取新数据。确实是缓存过旧再调小 Cache TTL。❌ 端口 9117 访问不了直接重装 → ✅ 按顺序排查systemctl status jackett.serviceLinux看服务是否在跑把127.0.0.1换成localhost再试确认防火墙没挡 9117。日志在~/.config/Jackett/log.txtLinux或%ProgramData%\Jackett\log.txtWindows。生态与集成它不是一个人在战斗Sonarr电视剧自动化监控剧集更新并触发 Jackett 搜索下载Radarr电影版的 Sonarr同样通过 Torznab 接入Lidarr音乐库管理Mylar3漫画获取qBittorrent可作为下载端消费 Jackett 转包出来的下载链接FlareSolverr可选的反爬验证代理处理 Cloudflare 类站点Plex / Emby下游播放承接下载整理好的媒体库下一步怎么做Jackett 的本质价值一句话把站点适配这件持续消耗精力的事收敛到一个免费、开源、可自托管的代理上。你只需维护它其余工具都能受益。建议你今天就做三件事按上面的 5 步把服务跑起来添加一个公共站点并 Test 通过用手动搜索随便查一个词看看结果页顶部那条各站点耗时统计。做到这三步它能不能帮我干活这个问题就有了确定答案。【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/Jackett创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考