Sonarr自动化追剧全攻略：从Docker部署到硬链接与媒体栈联动

1. 一开始我是怎么入坑 Sonarr 的

先说个真实场景。我大概在五六年以前折腾 NAS 的时候，第一次接触到“自动化追剧”这个概念。当时我还在用 qt 或者 Transmission，每周手动去站点看有没有新的一集，把种子下载链接复制进去，等下载完再去文件夹里手动改名、整理到媒体库目录。碰上剧集多的日子，一天要重复十几次这种机械操作，烦到怀疑人生。

后来朋友甩给我一个名字：Sonarr。说是只要把剧集“订阅”进去，它就会自动帮你盯着各大索引器，一发现对应剧集出了新的分集，就自动推给下载器开下，下完自己整理、重命名、归位，还能顺手刮削海报和简介。我一开始是不信的，下载工具的周边件见多了，什么自动删种、自动分类、自动硬链接，都是各家有各家的说法，但能把“追新剧”这件事从源头包圆的，还真没见过几个。

实际用了半个月之后，我承认这玩意儿确实改变了我管理媒体库的习惯。Sonarr 的表面身份是一个“TV Show 自动化下载管理工具”，但用它的人都知道，它实际上是整个自动化媒体栈里最核心的调度大脑。它不直接做下载，也不直接做播放，它干的事情是把“找到资源、交给下载器、收回来整理好、通知其他程序做后续处理”这一整条链路串起来。

而且 Sonarr 不是那种装完就完事的工具。它在配置不当的时候会给你挖很多坑，比如权限不对导致文件无法硬链接、索引器分组不对导致永远搜不到资源、路径映射错误导致下载完没法自动归位……这些坑我在后面几年里基本都踩了一遍。今天这篇就打算把我折腾 Sonarr 的完整经验写出来，从部署到配置，从追剧到整理，再到跟 Radarr、Prowlarr、Bazarr 这一整套自动化媒体栈怎么联动，全部说清楚。

这篇东西适合两类人看：一是刚接触 NAS、Docker、家庭媒体库，想把自己手动追剧那一套流程自动化的小白；二是已经装了 Sonarr 但用起来总觉得“差点意思”，比如明明配置没问题但就是不自动下载、或者文件整理逻辑不对的人。不管你是哪种，跟着下面的思路走，基本能把 Sonarr 这块硬骨头啃下来。

2. 先搞清楚 Sonarr 到底在解决什么问题

2.1 手动追剧的痛点和 Sonarr 的核心流程

咱们先回忆一下没有 Sonarr 的时候，追一部美剧或者英剧的完整流程是什么样：

1. 每周固定时间去资源站或者论坛刷有没有更新；
2. 找到对应剧集 SxxExx 的资源；
3. 选择合适的画质档位，比如 1080p WEB-DL 还是 720p HDTV；
4. 复制下载链接丢进下载器；
5. 等下载完成；
6. 去下载目录找到文件，手动改名成规范的剧集命名格式；
7. 移动到对应的剧集文件夹里；
8. 如果文件里有额外的 .nfo、字幕之类的小文件，还得一起处理。

这套流程每周重复一次，如果追的剧有十来部，每次操作加起来就是一两个小时。而且人脑记不住每部剧“上次看到哪一集”“下一集什么时候出”，一旦错过更新，等你想起来的时候资源热度已经过了，保种可能也撤了。

Sonarr 把这条链路压缩成了几乎是全自动的循环。它核心的工作流是这样的：

• 你添加一个剧集，设置好你想要的画质和语言偏好；
• Sonarr 会定期通过各类索引器源去搜索匹配的资源；
• 命中之后自动发送下载任务给下载客户端；
• 下载完成后，Sonarr 检测到任务完成，把文件从下载目录移动到媒体库目录；
• 移动的同时根据你设定的命名格式重命名，把 SxxExx 这些信息全部标准化；
• 如果开了“硬链接”模式，它不会复制文件，而是给文件做一个引用，既能满足做种需求又不占双倍空间；
• 最后它可以触发一个自定义脚本或者通知——比如往你的 Telegram、微信、邮件里推一条“下载完成”的消息。

这一套跑顺了之后，你的介入点只剩一个：决定要不要收藏这部剧、想看多高清的版本。剩下的全部由 Sonarr 托管。

2.2 Sonarr 和常规下载工具的本质区别

很多人第一次看到 Sonarr 的界面会有点懵——因为它的主界面没有任何下载速度、种子数、做种比例这种东西。它甚至不能自己下载。这会劝退一部分习惯用下载器的人，但其实是设计上的有意为之。

Sonarr 走的是一种“数据中台”的思路。它本身不碰传输层，只做决策和调度。下载这种体力活交给 Transmission、qBittorrent、Deluge、Nzbget 这些专门的客户端，Sonarr 通过 API 跟它们对话，发出“下载这个链接”“这个任务现在什么进度”“下完了没”之类的指令。

这个设计最大的好处是调度逻辑和传输逻辑解耦。今天你觉得 Transmission 不好用想换 qBittorrent，Sonarr 里的剧集订阅、历史记录、命名规则一样都不用动，只需要去设置里改一下下载器的连接参数。同样的逻辑也适用于索引器——Sonarr 统一管理所有资源站，站挂了或者你想加新站，改配置即可，不影响剧集库的完整性。

所以你要是把它理解成一个“升级版 RSS 下载器”，那其实低估它了。RSS 是全量订阅、来了就下，Sonarr 是智能匹配、按需获取，它知道每个剧集的季、集信息，知道同一集有不同版本时该怎么选，知道优先级的判断逻辑。对于管理一个超过几十部剧集的媒体库来说，这种“按需匹配”的能力比 RSS 灵活太多了。

2.3 适合用 Sonarr 的人群和场景

Sonarr 不是所有人都需要。如果你的需求只是“偶尔下载一两部电影看看”，那用不上它，甚至用不上任何自动化工具。Sonarr 真正发挥价值的场景有这么几个特征：

• 追的剧比较多，每周有固定更新的那种；
• 对画质有明显的偏好标准，比如非 HDTV 不看、必须是 WEB-DL 或者蓝光原盘；
• 本地媒体库已经成形，文件名和目录结构有自己的一套规范；
• 有 NAS 或者一台长期开机的设备当服务器，不是只看完就删的临时下载；
• 愿意花一小时配置，换以后每周省下两小时。

当然这里要插一句：Sonarr 本身是个工具，它自动化的是“你浏览器里看到的资源、你合法拥有或授权访问的内容整理流程”。工具没有立场，但使用者要遵守相关版权法规和站点规则，别拿它来做侵权传播的事。国内很多 PT 站的规则里也明确要求禁止自动化工具违反站点条例，所以跑 Sonarr 的时候，务必确认你对接的索引器是否允许 API 访问，别热火朝天配完了账号被封。

3. 从零部署：Docker 装 Sonarr 的正确姿势

3.1 为什么首选 Docker 部署

Sonarr 的安装方式有几种：Windows 下直接装 exe、Linux 下用包管理器、群晖套件中心装套件、或者 Docker 容器。我的建议是无脑选 Docker，原因很实际：

• 隔离干净，卸载重装不残留；
• 版本升级方便，拉一个新镜像重建容器就行；
• 目录映射和权限管理直观，出问题容易排查；
• 不污染宿主机环境，不跟系统里其他 Python/Node 版本打架。

而且 Sonarr 的官方镜像维护得很勤快，你直接用lscr.io/linuxserver/sonarr或者linuxserver/sonarr都行。LinuxServer 这个团队维护的系列镜像在 NAS 玩家圈子里认可度很高，稳定性有目共睹。

3.2 Docker Compose 配置文件示范

我的建议是用 Docker Compose 来管，因为不光是 Sonarr 一个服务，后面通常还会带 Radarr、Prowlarr、Bazarr、qBittorrent 这些容器，用 Compose 统一管理比一个个docker run省事太多了。贴一份我实际在用的配置：

services: sonarr: image: lscr.io/linuxserver/sonarr:latest container_name: sonarr environment: - PUID=1000 - PGID=1000 - TZ=Asia/Shanghai volumes: - /path/to/sonarr/config:/config - /path/to/downloads:/data/downloads - /path/to/media/tv:/data/media/tv ports: - 8989:8989 restart: unless-stopped

这份配置看着简单，但几个关键点值得展开说一下：

PUID和PGID是 LinuxServer 镜像特有的参数，用来指定容器内进程以宿主机什么用户的身份运行。这个直接决定了后面文件创建时的属主是谁。如果你不设置，容器默认以 root 跑，创建出来的文件宿主用户可能没权限删改，而媒体库目录的所有者通常是你自己的登录用户。拿根目录权限去跑服务，短期没事，后期想清理文件的时候各种 Permission denied，烦不胜烦。所以在你执行docker compose up -d之前，先id看一下你的用户名对应的 UID 和 GID，一般是 1000，但每个人系统不一样，填你自己的。

/config目录是 Sonarr 的数据库、配置文件、日志存放的地方，映射出来是为了以后备份和升级不丢数据。/data/downloads和/data/media/tv这种对应关系也很关键。我见过太多人把宿主机路径直接映射成/downloads和/tv，不是不行，但后面如果要用硬链接，这种根目录分散的映射方式会让你在配置远程路径映射时头大。建议统一挂在一个/data下面，后续加 Radarr 之类的也方便共用目录结构。

3.3 首次启动后的基础设置

容器起来之后，浏览器访问http://你的IP:8989，看到欢迎页就算启动成功了。首次进入会让你做几项基础配置，我一个个说：

• 媒体库路径：这个对应容器内的/data/media/tv，但这里有个细节——在 Sonarr 界面里填路径时，填的是容器视角的路径，不是宿主机视角的。也就是说填/data/media/tv，不是/path/to/media/tv。
• 下载客户端：这个先空着也行，后面单独配置。不过我建议直接在这个阶段就配好，省得回头还要回头。
• 语言和时区：按自己喜好选，注意语言设置只影响界面语言，不影响后续的命名和元数据语言。

几个设置项里最容易被忽略的是“高级设置”开关。Sonarr 的很多关键配置（比如文件命名格式、硬链接开关、索引器选项）都藏在高级设置里，默认是关着的。界面右上角“显示高级”那个开关，务必打开，不然后面你连“硬链接”这个选项都看不到。

4. 索引器和下载器的配置：Sonarr 的任督二脉

4.1 索引器的分组和配置要点

用 Sonarr 的人都知道一句话：“索引器是 Sonarr 的引擎。”没有索引器，Sonarr 就是睁眼瞎，搜不到任何一个资源。所谓索引器，往简单说就是 Sonarr 的资源搜索引擎，它可以是公网 BT 站的 API、PT 站的 API，也可以是 Newznab 协议的资讯站。

配置入口在“设置 → 索引器”，点“新增”，会让你选类型。比较常见的有：

• Torznab：通用于绝大多数 PT 站和部分 BT 站的自定义 API 格式；
• Newznab：用于 Usenet 索引站；
• 内置的 Prowlarr：如果你装了 Prowlarr，可以一键把 Prowlarr 里配好的全部索引器同步过来。

如果你用的是 PT 站，去站点的“设定/API”页面找到 API Key，填进去就行。这里有个容易踩的坑：PT 站的 RSS 链接和 API 链接不一样，很多人光填 RSS 地址，结果 Sonarr 提示无法连接。你要找的是 Torznab API 地址，一般长这样：https://站点域名/api?apikey=xxx&t=search。

在“索引器”列表里有一个叫“通用设置”的选项，里面有两项值得注意：种子优先级和允许的种子大小上限。种子优先级是给 PT 站提交请求时用的，有的站支持给种子分配“高/中/低”优先级，设置太高可能违反站点规则，一般保持默认就行。种子大小上限建议按自己的带宽和磁盘空间设一个值，比如 50GB，超过这个值的自动跳过，避免硬盘被大包塞满。

配置完索引器，记得点“测试”。如果显示“测试成功”，说明连接没问题。如果测试失败，90% 的原因就三类：API 地址填错了、API Key 复制少了字符、或者你所在的网络访问不了那个站点。逐个排查就行，这种问题不需要高级技巧，耐心点。

4.2 下载客户端的接入和优先级管理

同理，在“设置 → 下载客户端”里添加你正在用的下载器。我这边用的是 qBittorrent，就以此为例。填的时候注意几项：

• 主机名：如果 qBittorrent 是 Docker 容器，填容器名或者网关 IP。容器间互联时填容器名最省事，比如qbittorrent；
• 端口：默认 8080；
• 用户名密码：跟你网页端登录的一致；
• 分类：建议填tv-sonarr，这个参数可以让 Sonarr 在给 qBittorrent 发任务时自动打上分类标签，后期清理和排查方便。

保存并测试通过之后，别忘了在“下载客户端 → 完成下载处理”里确认“启用”是打开的，同时把“下载完成后处理”开关设成“启用导入”。这项如果关闭，Sonarr 虽然会发任务给下载器，但下完之后不会自动下一步，那就失去了自动化的意义。

如果同时挂了多个下载客户端，注意 Sonarr 一次只会用一个客户端干活。它的分配逻辑是：按你在客户端列表里的顺序，第一个可用就交给第一个。所以假设你同时挂了 Transmission 和 qBittorrent，想优先走 qBittorrent，就把 qBittorrent 放在列表最上面。

4.3 状态图标和常见报错：一张表看懂

很多人在 Sonarr 的系统“活动”页面看到各种图标和状态码就慌，其实大部分都是可以归类的。我把自己实操中遇到过的几种典型状态整理一下：

状态/图标	含义	处理方式
紫色感叹号	索引器测试失败或未通过验证	去索引器设置里重新测试，检查 API 地址和 Key
红色感叹号	健康检查出现错误	点进去看具体提示，基本都能定位
蓝色旋转图标	任务等待下载器响应	不用管，通常几秒内变化
下载中但进度不涨	下载器没动，可能种子挂了	去下载器看具体错误，必要时删任务重搜
导入失败	文件路径映射或格式解析出错	检查远程路径映射，看日志

远程路径映射这个坑值得单独说。它的本质是：Sonarr 在容器内看到的文件路径，和下载器在它自己的容器内看到的文件路径，可能不是同一个。比如 Sonarr 映射的下载目录是/data/downloads，而 qBittorrent 容器里映射的是/downloads。下载器告诉 Sonarr“文件在/downloads/aa/bb.mkv”，Sonarr 拿这个路径在自己容器里找，发现/downloads不存在，自然就导入失败了。

解决办法就是在“设置 → 远程路径映射”里加一条：主机名填 qBittorrent 的容器名，远程路径填/downloads，本地路径填/data/downloads。这样就做了个路径翻译，两边就对上了。

5. 剧集管理：从添加到整理的核心功能详解

5.1 添加剧集和路径规划

配置好了索引器和下载器，就可以正式开始添加剧集了。入口在左上角“添加新剧集”，输入剧名搜索即可。Sonarr 默认用 TVDB 做剧集元数据来源，能搜到绝大多数主流剧集，连一些比较冷门的纪录片和综艺也有收录。

添加时有几个选项要说清楚：

• 根文件夹：就是这部剧最终要放进哪个文件夹。建议一级目录按剧名分类，二级目录自动生成“第几季”的子目录；
• 监视选项：选择“监视旧集数”“仅监视新集数”“不监视”等。第一次追一个老剧，选“监视旧集数”，让 Sonarr 把整个剧集的历史空缺全部补齐；追连载中的新剧，选“仅监视新集数”就行；
• 质量配置文件：这里选你想要的画质偏好。默认有一个“HD-1080p”“Ultra-HD”“任何”之类的选项，选择逻辑后面单独讲。

添加完保存，Sonarr 会把剧集信息刷新出来，包含每一季每一集的概览。如果你之前手动整理过这个剧的文件，可能在添加时它还会提示“找到已存在的文件”，并自动帮你做导入。

5.2 质量配置文件的选型逻辑和陷阱

质量配置文件是 Sonarr 里最容易被忽略又最影响使用体验的设置。为什么？因为 Sonarr 的默认配置文件是“任何”，意思是只要有这个剧的任意资源它都收。乍一看很省心，但实际效果是：晚上八点某剧首播，索引器第一时间抓到的是 720p WEB-DL，Sonarr 直接下了。到了第二天蓝光 1080p 出来了，虽然是更好的画质，但 Sonarr 默认不会因为你有了低清就自动换高清，除非你设置了“升级”。

所以我的建议是给剧集单独建几个质量配置，按类型区分：

• “追新剧追赶用”：允许 480p、720p、1080p，不限制具体来源，重点是快；
• “收藏级”：要求 1080p WEB-DL 起，蓝光原盘更佳，不急着下载，等高质量源；
• “纪录片/老剧补档”：随意，能下到就行。

配置的关键是“允许的升级路径”和“升级延迟时间”。升级延迟指的是：当某个剧集已经下载完成后，Sonarr 要等多长时间再去搜有没有更好的版本。设成 24 小时比较稳妥，既给高质量源留了出现的时间，又不会无限等下去。

另外说一个容易踩的坑：如果你只想要 1080p，把高清版本勾为允许，但同时又把“蓝光原盘 REMUX”也勾了，Sonarr 在搜索的时候可能会优先匹配到体积巨大的 REMUX 版本。也就是说它认定“REMUX 比 WEB-DL 高一级”，所以只要搜到就直接下，哪怕你只是想看个 1080p WEB-DL。解决方法是：在质量配置界面的“大小限制”那一栏，把最大体积限制设到 20GB 左右，超标的自动忽略。

5.3 命名格式：媒体库的体面程度全靠它

文件名整理是 Sonarr 最直观的价值之一。一个规范的文件名长这样：

绝命律师.Better.Call.Saul.S01E01.1080p.WEB-DL.DD5.1.H.264-CM

这个命名格式不是 Sonarr 拍脑袋定的，而是可以完全自定义的。在“设置 → 媒体管理 → 重命名剧集”里，可以填一堆占位符来控制输出格式。我自己的配置大概是：

{Series Title} S{season:00}E{episode:00} {Quality Full} {MediaInfo Audio} {Scene Name}

实际效果类似：

Breaking.Bad.S01E01.1080p.WEB-DL.AAC5.1-GROUP

这个命名方式是参照 Sceneline 的标准来的，播放器、媒体服务器（比如 Plex、Jellyfin）识别起来没有障碍。

在小节“季目录格式”里，我建议用Season {season:00}，比如Season 01。很多播放器认这种目录结构。如果你的文件是放到 Jellyfin 或者 Plex 里扫的话，目录结构对不对直接决定能不能正常刮削到海报和简介。

5.4 硬链接：不愿意占双倍时间就得学这个

硬链接是 Sonarr 老玩家口中的“省空间神器”。它的原理听着有点绕，但其实用生活场景来类比就很直观：你电脑桌面上一个快捷方式和原始文件的关系，就相当于软链接。而硬链接更像是同一个文件起了两个名字，你删掉其中一个名字，另一个名字仍然能打开内容，文件的真实数据只有一份。

具体到 Sonarr 的使用场景：PT 做种要求文件不能移动，因为移动会改变文件的 inode，校验不到原始文件；而你的媒体库目录又希望文件按照自己的规范命名整理。这两件事原本是冲突的——你要么不动下载目录里的文件，做种保着不整理了，媒体库文件名乱七八糟；要么移动进媒体库，但种子失效被站点警告。

硬链接完美解决了这个矛盾。Sonarr 会在媒体库目录里生成一个指向下载目录原始文件的新“名字”，原始文件还在下载目录里，种子还在正常做种，但媒体库这边已经有了规范命名的文件，可以正常被媒体服务器识别和播放。两边数据空间只占一份。

要启用硬链接，前提是：下载目录和媒体库目录必须在同一个文件系统上。也就是说你下载到了/data/downloads，媒体库在/data/media/tv，这两个目录得挂在同一个硬盘或同一块阵列上，跨盘是不行的。因为硬链接不能跨文件系统工作。

在 Sonarr 里这个设置藏在“设置 → 媒体管理 → 导入处理”，把导入后复制到根文件夹改成硬链接即可。看起来是参数，但实际上是整个自动化媒体栈效率的分水岭。不用硬链接，你下载一部 60GB 的蓝光原盘，就要占 120GB 空间；盘大的时候无所谓，盘小了你就会懂得硬链接的珍贵。

6. 自动化进阶：跟 Prowlarr、Radarr、Bazarr 打配合

6.1 为什么一个 Sonarr 不够用，还要组“全家桶”

如果说影视自动化是一条流水线，那么每一部作品在不同环节需要不同的工具。Sonarr 只负责剧集，对于电影它有个孪生兄弟叫 Radarr，逻辑基本一致，只是把“季/集”维度换成了“电影”维度。索引器管理有一个集中对策叫 Prowlarr，字幕管理有 Bazarr，下载端再配一个 qBittorrent。这一套组合下来，就是大家常说的“自动化媒体栈”。

这一整套架构的好处是分而治之。每个工具只做一件事，但互相之间通过 API 会话。我只在一处（Prowlarr）维护所有索引器，然后推给 Sonarr 和 Radarr 各自使用，不用在每个工具里重复配置几百个站点信息。

6.2 Prowlarr 的引入：索引器统一管理

Prowlarr 解决的痛点很直白：你装了 Sonarr，想追剧，得去配置索引器。后来又装了 Radarr，配电影，又要重新加一遍索引器。再后来想让 Bazarr 搜索字幕，还要再配一遍。每加一个新索引器，就要去三个工具里同步一次。

Prowlarr 把这个过程压缩成了一次配置。你只需要在 Prowlarr 里把所有索引器全部加好，然后在它的“设置 → 应用”里把 Sonarr 的 API 地址和密钥填进去，点一下“同步”。之后你在 Prowlarr 里加了一个新索引器，它就会自动推给 Sonarr 和 Radarr。以后新增 PT 站，只需要动一个地方。

这个同步功能我已经用了很长时间，实测是非常靠谱的。注意事项只有一条：Prowlarr 的版本要和 Sonarr/Radarr 保持大致同步，旧版 Prowlarr 对新版 Sonarr 的 API 兼容性可能会打折扣，所以建议升级时全家桶一起升。

6.3 Bazarr：给媒体库配齐字幕的最后一步

剧集下好了，文件命名规范了，播放器能识别了，但可能还有最后一个问题：字幕。尤其是外语剧集，资源本身可能只带英文字幕，想要中文还得自己去字幕站找、下载、跟视频文件重名放到同一个文件夹。

Bazarr 解决的就是这个环节。它跟 Sonarr/Radarr 对接，会自动扫描媒体库中缺少字幕的文件，去各类字幕站搜索、下载，下载完自动改成跟视频同名的.srt文件放到同目录。整个过程也基本是零干预。

Bazarr 的配置要点在于字幕语言优先级：在“设置 → 语言”里把中文设为第一优先，英文排第二，这样它能优先找到中文字幕。搜索方式建议勾选“仅搜索高清字幕”，减少低质量 OCR 字幕混入的概率。

整个流程走完，从索引器搜索到字幕归位，都是全自动的。我自己搭完这套之后，唯一的日常动作就是打开 Plex 或者 Jellyfin，看看海报墙有没有新剧更新。偶尔有剧集没有匹配到合适的文件，Sonarr 也会在界面上显示红色警告，点进去看是缺了什么条件，直接改完就好。

7. 问题排查：Sonarr 日常翻车合集

7.1 后台任务一直显示“已排队”不下载

这个问题很多人遇到过。会在“活动”页看到任务处于“排队”状态，但下载器那边一个种子都没有。

排查思路按顺序走：

1. 去“系统 → 任务”里看有没有“索引器搜索”之类的任务在挂起。有些情况下，Sonarr 会在做周期性 RSS 同步，之间会有几秒延迟；
2. 查一下下载客户端设置里的分类。某些新版本 qBittorrent 对分类有限制，如果分类名设为空，种子可能被归到“未分类”，默认是不过滤的；
3. 看“系统 → 日志 → 文件”里有没有搜索报错。经常是 API 返回了 403，说明索引器端把 API Key 判定为无效了。

排队问题大多数都不是 Sonarr 故障，而是它在下发任务的前置条件没有满足。比如下载客户端没有空闲容量、或者下载客户端里设置的最大活跃下载数满了。检查一下这两个配置，问题基本能解决。

7.2 下载完成但“导入失败”

这个错误提示可以说是 Sonarr 新手最常见的拦路虎。常见的表现是：下载器显示种子状态是“完成”，但 Sonarr 活动栏里出现一个感叹号，提示“导入失败”。

常见原因有以下几类：

• 路径映射不对，就说过的远程路径映射没配；
• 文件权限不对，Sonarr 容器内的用户没有对下载目录文件的读取权限。这时先docker exec -it sonarr ls -la /data/downloads看看能不能列出文件，不能的话就是权限问题；
• 文件被下载器锁住，Windows 上的下载器常见，Linux 上出现较少。进程没释放文件句柄时，Sonarr 复制/硬链接会失败，重启下载器一般能解决；
• 分类不匹配。如果下载客户端里设置了自动分类规则，把种子分类到了 Sonarr 不认的类别，它就不会识别为“自己发起的任务”，当然也不会去导入。

遇到“导入失败”，我的第一反应永远是先登录下载器界面看一眼种子状态。如果是“做种中”且文件完整，那问题在路径或权限；如果下载器显示“错误”，问题就在下载端。按这个思路排除，一般十分钟内能定位。

7.3 为什么 Sonarr 一直搜不到资源

这个问题的排查逻辑也很好玩。Sonarr 搜不到资源，和搜索引擎搜不到关键词，原因是两码事。Sonarr 的索引器来源是几千个独立站点，每个站点的搜索结果返回格式都不一样，Sonarr 把它们统一解析之后做匹配。搜不到通常是下面几种情况：

• 这部剧真的不在索引器覆盖的范围内。冷门剧、老番、小语种剧经常在热门站里没有完整资源；
• 索引器限定了分类。某些 PT 站的 Torznab API 默认只返回 TV 分类的种子，如果你的剧被分到了“动画”“综艺”分类，可能搜不到；
• 搜索关键词被过滤了。检查一下“索引器 → 选项”里有没有开启“仅搜索经过验证的资源”。新资源在早期常常是未验证的，开启这个选项会把它们过滤掉。

我给一个通用解法：遇到搜不到的剧，先把“仅搜索已验证”关掉再看。如果在 PT 站网页端能看到这个资源，但 Sonarr 搜不到，大概率就是这个问题。

7.4 健康状态检查：别忽略那个红色感叹号

Sonarr 顶部状态栏上偶尔会出现红色感叹号，点击进去会展开它自己的健康检查报告。Sonarr 的自我诊断能力很强，很多配置问题，它自己都会明明白白告诉你。比如“检测到路径映射——传入的下载文件路径不存在”“检测到磁盘空间不足”之类的。

养成习惯：每周看一眼那个红色感叹号里的内容。Sonarr 的健康检查报告把问题分成了警告和错误两级，错误优先处理，警告可以视自己的情况拖一拖。只要能保持这个小节检查的节奏，Sonarr 基本不会突然给你撂挑子。

8. 结尾前再给我的个人心得

Sonarr 这个工具，我前前后后用了好几年，踩过的坑不算少，但到今天它依然是我媒体库自动化流程里的绝对主力。如果非要说一个最值得留意的经验，那就是：部署之前，先把目录结构想清楚再动手。大多数后面遇到的“路径不匹配”“无法硬链接”“导入失败”等代码块，根源都在最初映射目录时没有统一规划。下载目录、媒体库目录、临时目录，它们之间是父子关系、并列关系还是跨盘关系，从一开始就要设计好。

另一个经验是，Sonarr 默认功能已经够强，但千万别急于第一时间装一堆插件和扩展。先用最原始的三件套——Sonarr 加一个下载器加一个 PT 站——把流程跑通，确认每一环都没有问题，再逐步引入 Prowlarr 统一索引器、引入 Bazarr 管字幕。这样一旦遇到问题，你定位范围会小很多，不会一上来就面对全栈报错四处乱查。

我见过太多人问“为什么我的 Sonarr 配置完不自动下载”，追到底发现是硬链接没开、Prowlarr 同步没点、或者说 Bazarr 的下载目录映射错误影响了下游处理。这些本可以避免的毛病，往往是“一步到位”的心理在作祟。自动化系统的核心不是“把所有工具装齐”，而是“让每个工具在链路里的职责清楚、路径明确”。理清楚这一步，Sonarr 的日常体验就是安静的、无感的。

最后再分享一个小技巧：Sonarr 的配置文件在/config/config.xml里，里面存了端口、API 密钥这类信息。如果你需要批量迁移或者远程管理，直接改这个文件比在界面里点半天快得多。但提醒一句，改之前先停容器，改完再启动，不然配置可能被回写覆盖。

从手动追剧到全自动媒体栈，Sonarr 带给我的最大改变不是时间上的节省，而是一种“把自己从重复劳动中解放出来”的踏实感。你按照自己的规则把系统设置好，之后每一部新剧更新、每一集新资源出现，都有个不知疲倦的管家帮你盯着。对折腾党来说，这种“隐于幕后”的状态，可能就是终极的成就感吧。