浏览器扩展

Motrix 浏览器扩展把”下载这个”变成一次点击:文件不走浏览器自带的下载管理器,而是交给 Motrix——你的登录会话也会一并带过去,所以需要登录才能下的文件照样能下。它还能干浏览器干不了的事,比如把流媒体视频拼成一个完整文件。

配置步骤

  1. 在浏览器里安装扩展(Chrome、Edge 或 Firefox)。
  2. 在 Motrix 里放行连接。 设置 → 集成 → 浏览器扩展 里的 「用浏览器扩展发送下载到 Motrix」 默认就是开的;浏览器侧的连接组件由 Motrix 自动注册,三大浏览器都支持。
  3. 批准配对。 扩展第一次连接时,Motrix 会弹出提示——「[名称] 想连接 Motrix — 来自 [浏览器]」,按钮是 「允许」 / 「拒绝」。不理它的话,请求 60 秒后自动过期。

Note

扩展正随 Motrix 2 逐步上线——商店链接上线后会发布在 motrix.app

批准过的浏览器会出现在 「已连接的扩展」 列表里,带 「上次活跃」 时间和 「断开」 按钮——想强制重新配对,断开即可。

能发送什么

  • 普通文件——扩展会重放浏览器的请求头和 Cookie,需要登录的下载不用再手动复制任何东西。
  • 流媒体视频(HLS/DASH)——Motrix 先下载分片,再用 FFmpeg 把音视频合成一个文件。FFmpeg 在 设置 → 集成 → 媒体工具 里管理(用内置副本、自定义路径还是系统安装,卡片上写得明明白白)。
  • 磁力链接——直接进入种子流程。

手抖点了两次发送也没关系——同一个下载的重复请求会被自动忽略。

移交失败了怎么办

扩展会把 Motrix 的真实原因用大白话告诉你:

提示含义
「直播流暂不支持下载」这是正在进行的直播,不是已完成的文件
「受 DRM 保护的内容无法下载」内容被 DRM 加密——Motrix 不会绕过它
「会话已过期 — 请在浏览器中刷新页面后重试」你在网站上的登录在移交途中失效了
「ffmpeg 合成阶段失败」最后的合并一步失败——去 「媒体工具」 查看 FFmpeg 状态
「续传失败;请重新开始下载」服务器拒绝续传残留的半个文件

受信任的扩展(进阶)

「受信任的扩展」 里可以授权第三方扩展与 Motrix 通信:点 「添加扩展」,粘贴扩展 ID,选好浏览器(Chrome/Edge 或 Firefox)。设置界面自己也说了:通常不需要使用——官方扩展开箱即受信任。

Important

浏览器扩展配对仅支持桌面版Docker 服务器版接受 CLI 和 agent 客户端,但不接受浏览器扩展。