Jackett 跨平台部署 3 步跑通 BT Tracker 聚合Jackett 把多个 BT Tracker 的搜索结果统一成 Torznab API让 Sonarr、Radarr 等客户端免适配直接调用。想在 Windows、macOS、Linux 上部署这篇教程按场景给最短安装路径并覆盖启动验证、后台服务与故障排查。先确认你的使用场景BT Tracker 指提供种子资源列表的站点API 则是客户端向 Jackett 查询结果的标准接口。先回答一个问题这台机器要不要一直开着只在桌面上用每天用几次、关机也正常。Windows 直接装macOS/Linux 跑一下启动脚本即可不做服务。代价是登录会话结束它就没了。服务器或 NAS 上常开需要开机自启、崩溃自恢复、局域网内其他设备可访问。走系统服务路线Linux 用 systemdmacOS 用 launchdWindows 用服务。本文主线按这条路径写。只临时测试跳过服务下载解压后直接运行可执行文件测完删掉目录即可。别装进系统目录清理更干净。部署前只需要准备的 3 件事按系统和架构选对安装包Windows 10 1607 及以上Jackett.Installer.Windows.exe图形安装包或 zip 免安装版Linux x64Jackett.Binaries.LinuxAMDx64.tar.gz树莓派等 ARM 设备选 ARM32/ARM64 包macOS 13 及以上Intel 选Jackett.Binaries.macOS.tar.gzApple 芯片选Jackett.Binaries.macOSARM64.tar.gzNAS 用户可直接用 Docker 镜像不用碰裸机步骤确认 9117 端口空闲默认监听 9117。Linux 上执行ss -lntp | grep 9117Windows 上执行netstat -ano | findstr 9117。被占用就用--Port参数给 Jackett 换个端口而不是去动占用方。决定访问范围默认只允许本机 127.0.0.1 访问。客户端和 Jackett 同机就保持默认客户端在局域网其他机器加--ListenPublic参数并在防火墙放行端口。按系统选择最短安装路径Jackett Windows 最短安装方式运行Jackett.Installer.Windows.exe安装向导里勾上 Install as Windows Service随系统自启和 Launch Jackett装完打开页面两个选项即可不想装服务就只勾后者。免安装路线是解压 zip 到C:\ProgramData\Jackett运行JackettConsole.exe。仓库里的 jackett_launcher.bat 会等自动更新器退出后再拉起托盘进程帮你避开更新重启的时序问题。Jackett Linux 部署两步交给脚本把对应架构的 tar 包解压到/opt把目录属主改成当前用户再以管理员身份运行sudo ./install_service_systemd.sh。install_service_systemd.sh 会检查两项必须以 root 运行root 是 Linux 的最高权限账号装服务需要且 Jackett 目录属主不能是 root属主是 root 会直接报错并提示你 chown。通过后生成 systemd 单元文件、使能并启动服务。只想试试的话进目录执行./jackett就行。Jackett macOS 启动双击安装脚本解压后双击目录里的 install_service_macos。它把 LaunchAgent 配置写到~/Library/LaunchAgents/org.user.Jackett.plist顺手移除可执行文件和 dylib/dll 上的隔离标记macOS 会拦截带隔离属性的外来程序再把服务加载进当前用户会话全程不需要 sudo。SIP系统完整性保护只限制系统目录用户 Library 目录不受影响可放心写入。启动、访问与首次配置验证页面与 API Key浏览器打开http://127.0.0.1:9117。页面顶部显示API Key客户端靠它鉴权先复制存好。打不开页面就先跳到排查一节。添加第一个 Tracker 并测试搜索点 Add indexer 挑一个免登录的公开站点如 1337x。添加后在索引器列表页用 Manual Search 输入关键词搜一次有结果就说明链路通了Test All 可批量体检所有已配置的 Tracker。把 Jackett 变成后台服务Linux systemd 服务配置systemd 是主流 Linux 发行版自带的服务管理器。安装脚本生成的单元文件在/etc/systemd/system/jackett.service关键项User指向目录属主、WorkingDirectory指向安装目录、ExecStart执行 启动脚本它会等更新器退出再启动避免更新时抢文件。Restartalways保证崩溃后 5 秒内自动拉起。日常命令systemctl status jackett.service systemctl restart jackett.service journalctl -u jackett.service -n 50限制单元文件里写死了安装路径迁移目录后要重跑安装脚本卸载执行uninstall_service_systemd.sh。Windows 服务装不装是两回事勾选了服务选项后Jackett 开机自启托盘图标负责打开页面、启停服务也可在services.msc里管理。没勾选时Web 服务跟着托盘进程走——关掉托盘 Jackett 就停了只适合桌面。命令行方式JackettConsole.exe -i安装服务、-s启动、-k停止、-u卸载。macOS launchd 常驻及其边界launchd 是 macOS 内置的任务调度器LaunchAgents 是普通用户登录即运行的位置。脚本写入的配置带RunAtLoad登录自启和KeepAlive退出自动拉起。管理命令launchctl bootout gui/$(id -u)/org.user.Jackett launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/org.user.Jackett.plist launchctl print gui/$(id -u)/org.user.Jackett边界要说清这是用户级服务只存在于你登录的图形会话里无人值守的服务器场景不适合。移除用uninstall_jackett_macos。出问题时按这个顺序排查权限先查目录属主Linux 下权限报错最常见的原因就是目录属主不对执行sudo chown -R $USER:$USER /opt/Jackett和sudo chown -R $USER:$USER ~/.config/Jackett。macOS 的隔离拦截由安装脚本处理手动运行时用xattr移除可执行文件与 dylib/dll 上的隔离属性。Jackett 端口被占用怎么办三种情况分开处理被占用ss -lntp | grep 9117找到占用进程停掉它或用--Port 9118换端口其他设备访问不了大概率还在默认的本机监听加--ListenPublic防火墙放行Linuxsudo ufw allow 9117/tcpWindows 检查 Defender 规则⚠️ 换端口后记得同步更新客户端里的地址本机也连不上把 127.0.0.1 换成 localhost 再试排除代理拦截本地请求。服务状态与日志去哪看Linuxsystemctl status jackett.service看状态journalctl -u jackett.service -n 50看最近 50 行改过单元文件先sudo systemctl daemon-reload再重启。macOSlaunchctl print gui/$(id -u)/org.user.Jackett能看状态、进程号和目录。日志文件Linux/macOS 在~/.config/Jackett/log.txtWindows 在%ProgramData%\Jackett\log.txt报问题时附上它末尾的内容。长期运行的注意事项更新机制怎么关Jackett 检测到新版本会自动更新并重启——启动脚本等更新器退出就是为了这个。生产环境可加--NoUpdates关掉自动更新改为手动升级停服务→覆盖新包→起服务。配置和索引器数据存在配置目录而非安装目录覆盖程序文件不会丢配置。日志与资源定期看一眼排障时加--Logging启动可记录全部请求。日常关注两件事内存和 CPU 随索引器数量、缓存时长增长属正常现象异常偏高就调低搜索缓存的 TTL 和单索引器最大结果数索引器健康状态出现大面积失败时先确认是站点问题还是 Cloudflare 拦截——后者需搭配 FlareSolverr 并在设置里填 API 地址 别让 API Key 和端口裸奔顶部 API Key 等同凭据别贴到公开处泄露就删除重新生成。不对外网暴露就保持本机监听仅局域网使用时--ListenPublic加防火墙限定来源真要公网访问套反向代理加认证并在设置里同步 Base path override。创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
