Motrix WebExtension 浏览器扩展配置指南
浏览器原生下载往往缺乏管理功能，而 Motrix 配合 WebExtension 能显著提升下载效率。本文将介绍如何将浏览器的下载请求自动接管到 Motrix 管理器中，实现断点续传和多线程加速。
环境准备
在开始之前，请确认以下基础条件：
- 已安装 Motrix 桌面端（建议版本 1.6.0 及以上）
- 使用 Chrome、Firefox、Edge 或 Opera 等主流浏览器
- 具备基本的扩展管理操作经验
建立连接的核心步骤
1. 生成 RPC 密钥
Motrix 需要通过 RPC 接口与扩展通信，首先需要生成安全凭证：
- 启动 Motrix 应用程序。
- 进入 Preferences > Advanced > Security 设置页面。
- 点击 Generate 按钮生成随机 RPC Secret 密钥。
- 复制生成的密钥内容，后续需要用到。
2. 配置扩展参数
拿到密钥后，即可在浏览器端完成绑定：
- 打开浏览器扩展管理页面（Chrome 为
chrome://extensions/，Firefox 为about:addons）。 - 找到 Motrix WebExtension 卡片，点击 Details。
- 选择 Extension options 打开设置界面。
- 将刚才复制的 RPC Secret 粘贴到对应输入框。
- 点击 SET KEY 保存配置。
高级设置与优化
默认配置下扩展即可工作，但根据实际需求可以进一步调整：
- 端口自定义：若默认 RPC 端口被占用，可在 Motrix 设置中修改端口号，并在扩展设置中同步更新。
- 文件过滤：建议设置最小文件大小阈值，避免小文件占用 Motrix 资源；同时可配置网站黑名单，排除特定站点不走代理。
- 回退机制：当 Motrix 不可用时，可配置为使用浏览器原生下载，确保任务不中断。
常见问题排查
如果扩展无法正常工作，请按顺序检查以下几点：
- 服务状态：确认 Motrix 正在后台运行，且 RPC 服务已启用。
- 密钥匹配：检查扩展中填写的密钥是否与 Motrix 生成的一致，注意不要有多余空格。
- 网络连通：验证本地网络连接正常，检查防火墙是否阻止了本地端口通信。
- 重启尝试：有时重启浏览器或 Motrix 应用能解决临时连接问题。
架构与性能说明
该扩展基于 Service Worker 架构设计，主要优势在于：
- 高效的任务处理能力，稳定保持连接。
- 智能识别下载请求，支持多线程加速。
- 内存占用低，对系统资源影响较小。
定期更新 Motrix 和扩展版本有助于获得最新的兼容性修复和功能改进。
