Motrix WebExtension 浏览器扩展配置指南
Motrix WebExtension 能够将浏览器的下载任务无缝转移至功能更强大的 Motrix 下载管理器，告别原生下载的低效体验。以下介绍具体的配置流程与注意事项。
环境准备
在开始之前，请确认本地已安装 Motrix 应用程序（建议版本不低于 1.6.0），且使用的浏览器支持 Chrome、Firefox、Edge 或 Opera 等主流内核。
核心配置步骤
1. 生成 RPC 密钥
首先需要建立扩展与主程序的安全连接：
- 启动 Motrix 应用程序。
- 进入设置页面，依次选择 Preferences > Advanced > Security。
- 点击 "Generate" 按钮生成随机 RPC Secret 密钥。
- 复制生成的密钥内容并妥善保存，后续配置需要用到。
2. 绑定扩展参数
接下来在浏览器端完成对接：
- 打开浏览器扩展管理页面（Chrome 为
chrome://extensions/，Firefox 为about:addons）。 - 找到 Motrix WebExtension 卡片，点击 "Details" 进入详情。
- 选择 "Extension options" 打开设置界面。
- 将刚才复制的 RPC Secret 密钥粘贴到对应字段。
- 点击 "SET KEY" 保存配置。
注意：如果扩展无法正常工作，通常是因为 Motrix 未保持后台运行或端口被占用。
高级选项与优化
端口与兼容性
默认情况下，RPC 监听端口为 16800。如需更改，请在 Motrix 中修改后同步更新扩展设置。本扩展对主流浏览器生态支持良好，包括 Chromium 系列、Firefox 及 Edge。
性能调优
- 文件阈值：设置最小文件大小，避免小文件占用 Motrix 资源。
- 黑名单：排除特定网站，防止不必要的重定向。
- 回退机制：当 Motrix 不可用时，启用浏览器原生下载作为备选。
常见问题排查
若遇到连接失败或任务无法传递的情况，可按以下思路检查：
- 服务状态：确认 Motrix 正在运行且 RPC 服务已启用。
- 密钥匹配：检查扩展中的密钥是否与 Motrix 生成的一致，注意不要有多余空格。
- 网络环境：验证本地网络连接，确认防火墙未阻止本地通信。
- 重启尝试：有时重启浏览器或 Motrix 应用即可恢复连接。
架构与特性
该扩展采用 Service Worker 架构，确保任务处理的稳定性与状态跟踪的准确性。主要特性包括自动捕获下载请求、智能文件识别、多线程加速以及断点续传支持。用户可在设置中查看实时进度、传输速度及错误报告。
建议定期更新扩展和 Motrix 主程序，以保持最佳兼容性和获得最新的功能改进。
