疑难排解

自上而下排查：先看引擎，再看具体任务，最后查网络。大多数问题在前两步就能解决。

第一步——检查引擎#

Motrix 背后是一个内置下载引擎（aria2）。引擎不高兴，什么都下不动。状态栏随时显示它的状态：「引擎就绪」「引擎启动中」 或 「引擎离线」。

如果显示离线——或者下载莫名其妙不肯开始——打开仪表板的 「引擎」 卡片，点 「诊断」。诊断对话框会跑五项检查：「内置 aria2」「引擎特性」「Motrix RPC 端口」「进程归属」「引擎通信」，然后给出建议的恢复方式：

• 「重启引擎」——引擎卡死时的万金油。
• 「强制终止并恢复」——上次运行遗留的 aria2 进程占着 Motrix 的端口时用。Motrix 会先验证那个进程确实是自己的，才会提议终止它。
• 「恢复 Motrix 默认端口」——端口冲突解除后，从备用端口回到默认端口。

第二步——读懂任务的错误#

失败的任务会用文字告诉你原因——选中它，看原因和提示：

原因	怎么办
「磁盘空间不足」	清理磁盘空间或更改保存目录后重试
「无法写入文件」	检查文件夹权限和磁盘空间
「需要授权」	检查凭据——浏览器里才能下的文件，重新粘贴一条新鲜的 cURL 命令(新建任务)
「网络连接失败」 / 「下载超时」	检查网络后重试
「重定向次数过多」	链接大概率失效了，换一条新链接
「文件校验失败」	文件可能已损坏——重新下载校验
「文件不存在」 / 「服务器返回错误」	问题出在服务器那边
「无法获取种子元数据」	检查磁力链接或添加更多 Tracker 后重试
「无法连接 Tracker」	走下面的种子慢速排查清单

「重试」 把任务重跑一遍；Alt+Click 点重试可以先改选项再重跑。

种子慢速排查清单#

按顺序走，每一步对应一种不同的瓶颈：

1. 打开「节点」标签页。 一个节点都没有？问题在连通性或种子本身，不在带宽。
2. 看做种者数量。 只有一个做种者的种子永远快不起来——这是资源的问题，不是 Motrix 的问题。
3. 同步 tracker。 在任务的 「Trackers」 标签页点 「同步」；再去 Trackers 页确认列表里有健康条目。
4. 解决可达性。 启用端口映射，在 NAT 卡片上跑一次诊断。「对称型」 NAT 或外网 IP 对不上，就是 CGNAT——入站节点注定偏少。
5. 看一眼「限速」卡片。 如果显示某条规则正在生效（定时规则、低速模式、带宽预留），那就是你要找的”慢”。
6. 确认 DHT 已开启（设置 → BitTorrent）——磁力链接尤其依赖它。

Motrix 的文件都在哪#

<userData> 在 macOS 是 ~/Library/Application Support/Motrix，Windows 是 %APPDATA%\Motrix，Linux 是 ~/.config/Motrix。

数据	位置
设置	<userData>/settings.json
日志	<userData>/logs/motrix.log(满 5 MB 轮转为 motrix.log.1)
任务历史 / 会话（SQLite）	引擎配置目录下的 aria2.db（路径可在 设置 → 高级 修改）
种子元数据	<userData>/torrents/
插件	<userData>/plugins/
GeoIP 数据库	<userData>/geoip/GeoLite2-Country.mmdb
媒体临时文件	系统临时目录下的 motrix-media（可在 设置 → 集成 → 媒体工具 清理）

报告问题#

帮助 → 报告问题 会打开 issue 跟踪器。附上 Motrix 版本（设置 → 关于）、操作系统，以及上表里的日志文件——这三样能一次性回答大部分追问。