Motrix WebExtension 浏览器扩展配置与使用指南
Motrix WebExtension 允许将浏览器的下载任务无缝转发到 Motrix 下载管理器，从而利用其多线程和断点续传能力，提升下载效率。
准备工作与系统要求
在开始之前，请确认环境满足以下条件：
- 已安装最新版 Motrix 应用程序（建议版本不低于 1.6.0）
- 使用 Chrome、Firefox、Edge 或 Opera 等主流浏览器
- 熟悉基本的浏览器扩展管理操作
详细配置流程
生成 RPC 安全密钥
首先需要建立 Motrix 与扩展之间的通信凭证。
- 启动 Motrix 应用程序。
- 进入设置页面，路径通常为 Preferences > Advanced > Security。
- 点击 "Generate" 按钮生成随机 RPC Secret 密钥。
- 复制生成的密钥内容并妥善保存，后续配置需要用到。
配置浏览器扩展参数
接下来在浏览器端完成连接设置。
- 访问浏览器扩展管理页面（Chrome 为
chrome://extensions/，Firefox 为about:addons）。 - 找到 Motrix WebExtension 扩展卡片。
- 点击 "Details" 进入详情，选择 "Extension options" 打开设置界面。
- 粘贴刚才复制的 RPC Secret 密钥。
- 点击 "SET KEY" 按钮保存配置。
高级配置选项详解
端口设置与自定义配置
默认情况下，Motrix 监听本地端口。如需更改，可在 Motrix 设置中修改后，同步更新扩展中的端口号。
多浏览器兼容性
本扩展设计兼容主流浏览器生态：
- Chrome/Chromium：完美支持最新版本
- Firefox：完全兼容所有功能
- Microsoft Edge：无缝集成体验
- Opera：完整功能支持
实用技巧与最佳实践
确保稳定运行的要点
- Motrix 应用程序必须始终保持后台运行状态，否则无法接收任务。
- 扩展会自动接管符合规则的浏览器下载请求。
- 定期检查 RPC 密钥配置是否正确，避免密钥过期或变更导致连接失败。
性能优化建议
- 设置合理的文件大小阈值，避免小文件占用 Motrix 资源。
- 配置黑名单排除特定网站下载，防止误拦截。
- 启用下载失败回退机制，当 Motrix 不可用时自动使用浏览器原生下载。
常见问题故障排除
连接问题诊断
如果扩展无法正常工作，请按以下步骤排查：
- 检查 Motrix 运行状态
- 确认 Motrix 应用程序正在运行。
- 验证 RPC 服务已在 Motrix 内部启用。
- 密钥配置验证
- 检查 RPC 密钥是否完全匹配。
- 确认密钥没有多余空格或特殊字符。
- 网络连接测试
- 验证本地网络连接正常。
- 检查防火墙是否阻止了本地回环连接。
