Motrix WebExtension 浏览器扩展配置与使用指南
扩展核心价值
Motrix WebExtension 的核心价值在于将浏览器的下载任务无缝转移到本地 Motrix 管理器。相比浏览器自带的下载器，它能提供更稳定的连接、断点续传以及更直观的任务管理界面，特别适合处理大文件或批量下载场景。
前置条件
在开始配置之前，请确保环境满足以下要求：
- Motrix 版本：建议安装最新版，最低不低于 1.6.0。
- 浏览器支持：Chrome、Firefox、Edge 或 Opera 等主流内核浏览器均可。
- 基础操作：熟悉浏览器扩展的管理页面入口。
建立连接配置
生成 RPC 安全密钥
首先需要在 Motrix 客户端内部生成用于通信的凭证：
- 启动 Motrix 应用程序。
- 进入设置菜单，依次点击
Preferences>Advanced>Security。 - 找到
RPC Secret选项，点击 "Generate" 按钮生成随机密钥。 - 复制生成的字符串并妥善保存，后续步骤需要用到它。
配置扩展端参数
拿到密钥后，即可在浏览器侧完成绑定：
- 打开浏览器扩展管理页面（Chrome 为
chrome://extensions/，Firefox 为about:addons）。 - 找到 Motrix WebExtension 卡片，点击进入详情。
- 选择 "Extension options" 或类似入口打开设置面板。
- 将刚才复制的 RPC Secret 粘贴到对应输入框中。
- 点击 "SET KEY" 保存配置。
此时，扩展与本地服务应已建立信任关系。
进阶设置与优化
端口自定义
默认情况下，Motrix 监听端口为 16800。如果该端口被占用，可在 Motrix 设置中修改端口号，并同步更新扩展中的端口配置，确保两端一致。
性能调优
为了获得最佳体验，建议关注以下细节：
- 后台运行：保持 Motrix 程序在后台常驻，避免任务中断。
- 文件阈值：设置最小文件大小限制，避免小文件频繁调用扩展造成资源浪费。
- 黑名单机制：排除特定网站（如视频流媒体），防止误拦截导致无法播放。
- 回退策略：启用下载失败回退功能，当 Motrix 不可用时自动切换回浏览器原生下载。
常见问题排查
连接失败
如果扩展提示无法连接，请按顺序检查：
- 服务状态：确认 Motrix 正在运行且未处于休眠状态。
- 密钥匹配：检查扩展中填写的密钥是否与 Motrix 生成的一致，注意不要有多余空格。
- 网络防火墙：部分安全软件可能阻止本地回环地址的连接，尝试暂时关闭防火墙测试。
- 重启刷新：重启浏览器和 Motrix 应用通常能解决临时性通信故障。
功能异常
若下载任务未能成功传递：
- 检查扩展图标是否显示正常，确认未被禁用。
- 验证浏览器权限设置，确保扩展拥有读取下载数据的权限。
- 核对版本号兼容性，过旧的扩展可能不支持新版 Motrix 的 API。
