安装与升级

DownloadIt 是使用 Firefox 内部 API 的 bootstrapped 扩展。它不是 AMO WebExtension，Firefox 必须先安装兼容的 Loader 才能加载。

开始前确认

• Firefox 136 或更高版本。
• Windows，或使用发行版原生包/Mozilla tarball 的 Linux。
• 可以安装兼容 Loader 的 Firefox profile。
• 当前不支持 Snap Firefox、Flatpak Firefox 和 macOS。

1. 安装依赖环境

所有受支持的 Firefox 版本都可以使用定制的 userChrome.js-Loader。Firefox Developer Edition 和 Nightly 也可以改用 Bootstrap Loader。

userChrome.js-Loader

从 userChrome.js-Loader 项目下载兼容版本。Firefox 135 及以上建议使用 20250219 之后发布的版本。

将 Loader 的 program 文件解压到 firefox.exe 所在目录，将 profile 文件解压到准备使用的 Firefox profile。重启 Firefox，并确认 Loader 已生效。

Caution

userChrome.js-Loader 会修改 Firefox 的程序和 profile 文件。安装前请使用专用 profile，或备份受影响的文件。

Bootstrap Loader

该替代方案仅适用于 Firefox Developer Edition 和 Nightly。Firefox Release、Beta 和 ESR 不支持 WebExtension Experiments。

1. 打开 about:config，接受警告，然后设置：

   xpinstall.signatures.required = false
   extensions.experiments.enabled = true

2. 从最新 Release 资产下载 BootstrapLoader.xpi。

3. 打开 about:addons，从齿轮菜单选择“从文件安装附加组件…”，再选择该 XPI。

4. 重启 Firefox，并确认 Bootstrap Loader 已生效。

Caution

这些偏好会降低 Firefox 对附加组件签名和 WebExtension Experiment 的限制。请只在专用的 Developer Edition 或 Nightly profile 中使用 Bootstrap Loader。

2. 下载 DownloadIt

下载 Nightly v2.14.0Pre-release

当前安装包是 Nightly 预发布版本，由 master 分支持续构建，变化频率会高于稳定扩展。

3. 安装 XPI

1. 在 Firefox 打开 about:addons。
2. 打开齿轮菜单，选择从文件安装附加组件…。
3. 选择下载得到的 addon.xpi。
4. DownloadIt 询问是否重启时，选择确定立即应用安装。

重启后，DownloadIt 按钮会加入导航工具栏。可以通过 Firefox 的定制工具栏界面移动或移除它。

升级

下载最新 Nightly XPI，并使用同一个 about:addons 命令覆盖安装。升级后 DownloadIt 会提示重启 Firefox。

扩展虽然发布了 legacy 更新清单，但支持的 Loader 都不会检查或自动安装更新，因此仍需手动升级。

Linux 注意事项

请使用发行版原生包或 Mozilla tarball。为自定义命令、aria2、uGet 或 JDownloader 配置的本地启动器必须具有可执行权限。包内 Aria2Next 支持 Linux x86_64；其他 Linux 架构仍可连接外部管理的 aria2 服务。

安装后继续阅读快速开始。