Jackett 跨平台部署指南3 步在 Windows、macOS、Linux 上跑通 BT Tracker API 聚合工具【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/Jackett你有没有在新机器上装 Jackett刚打开浏览器就撞上无法访问此网站、端口被占用或者服务起不来Jackett 是一个免费的 BT Tracker API 聚合工具它把 Sonarr、Radarr 这类应用的搜索请求翻译成各个 tracker 网站能懂的查询再把结果按 Torznab 标准格式还回去。读完这篇你能在 Windows、macOS 或 Linux 上把它跑起来并且清楚每个系统最容易翻车的那一步在哪。动手前Jackett 部署前置条件先把这 3 样备齐别急着解压先花 2 分钟确认这三件事能帮你避开后面 80% 的坑运行环境与下载物Jackett 基于 .NET官方安装包/发布包已经自带运行环境普通用户下载对应系统的发布包解压或安装即可不用自己装 .NET。如果你要从源码构建仓库地址是https://gitcode.com/GitHub_Trending/ja/Jackettclone 后再用dotnet构建。权限Windows 安装时勾选服务选项需要管理员权限Linux 的 systemd 安装脚本必须 root 执行但Jackett 目录本身必须归普通用户所有这条是 Linux 第一大坑下面细讲macOS 无 root 需求但要注意 Gatekeeper 隔离属性。端口 9117Jackett 默认监听9117。动手前确认它没被占# Linux / macOS lsof -i :9117:: Windows netstat -ano | findstr :9117一份配置三平台通用Jackett 跨平台配置的底层逻辑三个系统装的是同一套程序配置也是同一份先搞懂它在哪、改哪里比记住每个系统的按钮更重要主配置文件serverconfig.json存放在用户数据目录Windows 是%APPDATA%\JackettLinux/macOS 是~/.config/Jackett或系统对应的 AppData 目录。里面记录端口、监听地址、是否允许外网访问等。API Key 自动生成首次启动时Jackett 会自动生成一个 32 位 API Key 并写进配置Sonarr/Radarr 里填的 Torznab 地址就是http://127.0.0.1:9117/api/?tcapsapikey你的Key。这个逻辑在 src/Jackett.Common/Services/ConfigurationService.cs 里你不用改代码只需把 Key 记下来。改端口/开外网装好后进 Web 界面的 Server 设置页改别手改 json改错格式服务会起不来。想让局域网其他设备访问记得勾选允许外部访问。系统识别程序内部用 src/Jackett.Common/Utils/EnvironmentUtil.cs 里的IsWindows等属性判断平台所以服务注册脚本systemd / launchd / Windows Service各自独立但 Web 界面和配置完全一致——你在哪个系统学会的操作换系统都通用。三台机器三种脾气各自最容易翻车的地方安装主流程都是下载 → 解压到固定目录 → 运行启动脚本/注册服务下面只讲差异。Windows最省心坑在更新器没跑完推荐用官方 Windows 安装包装的时候勾选 Install as Windows ServiceJackett 会随系统自启托盘图标可启停服务逻辑见 src/Jackett.Service/。手动解压版双击 jackett_launcher.bat 即可。注意这个脚本会先等待自动更新器 JackettUpdater 退出再启动托盘程序——所以刚更新完时它卡住不动是正常的别杀进程。想看实时日志用数据目录里的JackettConsole.exe从命令行启动别同时开托盘版否则端口冲突。macOS坑在 Gatekeeper 隔离属性和路径写死官方提供 install_service_macos 脚本它替你做了三件事生成~/Library/LaunchAgents/org.user.Jackett.plist、移除jackett二进制和相关.dll/.dylib的隔离属性quarantine、用launchctl bootstrap加载服务。坑 1从网上下载后直接手动跑./jackettGatekeeper 会拦。老老实实跑安装脚本它处理了xattr隔离。坑 2plist 里写死了 Jackett 的绝对路径。以后挪目录服务会指向旧位置——要么不挪要么挪完重跑一遍脚本。Linux坑在 root 归属安装脚本会直接拒你跑 install_service_systemd.sh它会检查服务是否在跑、停旧服务、生成/etc/systemd/system/jackett.serviceRestartalways崩了 5 秒后自动拉起然后enable start。它有个硬校验如果jackett文件属主是 root脚本直接报错退出。所以下载解压后先执行sudo chown -R $USER:$USER /你的/Jackett/目录 sudo bash install_service_systemd.shsystemd 管理三件套systemctl status jackett/systemctl restart jackett/journalctl -u jackett -f。Jackett 跑起来之后验证部署是否健康的 4 个信号按顺序过一遍全绿才算装完打开管理界面浏览器访问http://127.0.0.1:9117本机。能进界面核心就算通了。看 About 页确认版本号、API Key 已生成。加一个 Indexer 试搜随便加个公开 tracker比如 The Pirate Bay输入关键词能出结果说明整条链路正常。服务状态后台运行时Linux 用systemctl status jackett看 active (running)Windows 看托盘或服务列表macOS 用launchctl print gui/$(id -u)/org.user.Jackett看 state 是否为 running。日常巡检不用盯太久Jackett 是轻量服务内存占用一般在百兆以内CPU 只在搜索时短暂升高。异常先看日志页界面自带 Log 标签页比翻系统日志快。Jackett 翻车急救高频报错 → 原因 → 动作现象原因修复动作进程在跑但浏览器无法访问9117 被占用或绑定了 127.0.0.1 而你从别的机器访问先lsof -i :9117查占用并释放从外网访问需在 Server 设置里改 BindAddress 并允许外部Linux 安装脚本报 owner is root 退出目录属主是 root脚本拒绝继续chown -R $USER:$USER后重跑脚本macOS 服务加载了但 state 不是 running或报动态库错误Gatekeeper 隔离属性未清干净在 Jackett 目录重跑 install_service_macos它会自动xattr去隔离或手动xattr -dr com.apple.quarantine .Windows 刚更新后启动器卡死不动启动脚本在等 JackettUpdater 退出正常行为等更新完成即可别强杀更新长期不结束就重启托盘程序某个 Indexer 突然全部 403 / 登录失败Cookie 过期不是 Jackett 挂了重新从浏览器导出站点 Cookie 并更新。以 Chrome 为例| | 搜索时偶尔 429请求过多 | 触发 tracker 限流 | Jackett 会记录 TooManyRequests见 src/Jackett.Common/Exceptions/TooManyRequestsException.cs降低搜索频率或启用搜索缓存即可不用动服务 |抄作业按你的场景选部署方式场景推荐方案理由生产/长期挂机家庭服务器、NAS 旁挂Linux systemd资源占用最低Restartalways自愈journalctl查日志方便桌面日常用Windows 安装包勾选服务图形化 托盘开机自启零维护临时试用/体验一下任意系统手动解压直接跑启动脚本不装服务用完删目录即可无残留想深入看配置就去翻serverconfig.json给桌面用户的额外一句macOS 上系统大版本升级后顺手launchctl print看一眼服务状态是成本最低的保险。小结Jackett 的跨平台部署没有魔法配置三平台共用翻车点各在各的系统层——Windows 等更新器、macOS 去隔离、Linux 别给 root。按备齐三样 → 装服务 → 验证四信号走一遍基本一次成型。装好之后下一步就是去加你的第一个 Indexer遇到问题优先翻仓库里的 README.md 的 Troubleshooting 章节它覆盖了反向代理、搜索缓存、FlareSolverr 等更细的场景。【免费下载链接】JackettAPI Support for your favorite torrent trackers项目地址: https://gitcode.com/GitHub_Trending/ja/Jackett创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考