8989 是什么
8989 是媒体自动化工具 Sonarr 的默认端口。Sonarr 属于 *arr 生态，负责剧集的订阅、下载编排、重命名与整理：它对接下载客户端与索引器，把「想要什么」变成「已整理入库」。同生态常用端口还有 Radarr 7878、Prowlarr 9696、Bazarr 6767、下载器 qBittorrent 8080。
基本信息
| 服务 | Sonarr（剧集管理） |
|---|---|
| 端口/协议 | 8989，HTTP |
| 鉴权 | 登录口令 + API Key |
| 同生态端口 | 7878 Radarr / 9696 Prowlarr / 6767 Bazarr |
| 安全等级 | 家庭或内网，反代对外需鉴权 |
典型使用场景
- 家庭媒体中心：自动获取并整理剧集到媒体库目录
- 容器部署：docker-compose 中固定 8989 做反向代理入口
- 接口对接：自研脚本用 API Key 查询队列与历史记录
- 排障：确认索引器、下载客户端与文件系统权限是否都正常
- 安全核查：确认反代对外时有登录保护、API Key 未泄露
接口与状态核查
接口与状态核查
curl -s -H 'X-Api-Key: <key>' http://localhost:8989/api/v3/system/status | head -c 200 # 版本与运行状态
ss -lntp | grep 8989 # 监听地址核查
curl -sI http://localhost:8989/login | head -3 # 是否要求登录
docker logs sonarr --tail 50 2>/dev/null | tail -20 # 容器部署时看启动与报错常见故障与定位点
| 现象 | 可能原因 | 定位方式 |
|---|---|---|
| 页面静态资源 404 | 反代子路径未设 base url | 浏览器控制台看资源请求路径 |
| 任务卡在队列 | 下载客户端不可达或凭据失效 | 设置页测试连接 |
| 整理后文件未出现 | 目录权限或硬链接跨文件系统 | 查看活动日志与挂载点 |
| 外部访问无鉴权 | 反代未加认证 | 用未登录会话直接访问首页验证 |
多个 *arr 应用共用同一个反向代理子路径时，必须为每个应用设置对应的 base url，否则页面能打开、静态资源全部 404，这类问题在刚搭好环境时最常见。
API Key 等同管理员权限，可以直接读改配置。排查脚本里不要硬编码 key，改用环境变量或凭据文件，并避免把带 key 的 URL 写进日志。
多应用协同排障时，先理清链路方向：索引器提供候选、下载客户端负责传输、Sonarr 负责判定与整理。任何一段配置错误都表现为「搜不到」或「不动」，按这条链路逐段测试连接，比反复重启服务有效。