可离线下载Firefox扩展的五种方法:一、网页右键另存为xpi;二、GitHub Releases获取预编译xpi;三、about:debugging提取GUID构造下载链接;四、curl/wget命令行批量抓取;五、Android上Chrome辅助下载xpi。

如果您尝试访问 Firefox 扩展商店(addons.mozilla.org),但页面无法加载或显示连接错误,则可能是由于网络策略限制、DNS 解析失败或地区性访问障碍导致。以下是解决此问题并实现扩展离线下载的多种方法:
一、通过网页端右键另存为下载 xpi 文件
该方式绕过浏览器内置安装流程,直接获取扩展原始安装包,适用于所有桌面版 Firefox,无需修改配置。
1、使用 Chrome 或 Edge 等其他浏览器访问 https://addons.mozilla.org/firefox/。
2、在搜索框中输入目标扩展名称,例如 “uBlock Origin” 或 “Dark Reader”。
3、在搜索结果中点击进入该扩展的详情页,向下滚动至“版本历史”区域并展开。
4、找到最新稳定版条目,将鼠标悬停在右侧的“更多”按钮上,点击弹出菜单中的“查看文件”选项。
5、在跳转后的文件详情页中,右键点击绿色的“下载”链接,选择“将链接另存为”,保存为后缀为 .xpi 的文件。
二、使用第三方镜像站点直接获取 xpi 链接
部分扩展开发者会在 GitHub Releases 页面提供预编译的 .xpi 文件,可规避官方商店不可用问题,且支持版本回溯与校验。
1、打开扩展的 GitHub 官方仓库主页,例如 AdGuard 浏览器扩展:https://github.com/AdguardTeam/AdguardBrowserExtension。
2、点击页面右侧的 “Releases” 标签,进入版本发布列表。
3、在任一版本条目下找到 “Assets” 区域,查找以 firefox.xpi 或 firefox-beta.xpi 命名的文件。
4、若未显示直接下载链接,可右键点击对应文件名,选择“链接另存为”,手动保存至本地。
5、如下载文件为 .zip 格式,解压后确认内部是否包含单一 .xpi 文件;若无,需检查其 manifest.json 是否符合 Firefox 扩展规范。
三、利用火狐浏览器地址栏快捷命令提取 xpi 下载地址
Firefox 内置的 about:addons 页面虽无法联网加载商店,但仍可解析已缓存的扩展元数据,并导出原始安装链接。
1、在 Firefox 地址栏输入 about:addons 并回车,进入附加组件管理界面。
2、点击左上角齿轮图标,选择 “调试附加组件” 以打开 about:debugging 页面。
3、在左侧边栏点击 “此 Firefox”,等待页面加载完成。
4、滚动至底部,点击 “临时加载附加组件” 按钮旁的 “查看源代码” 链接(如有);若不可见,则切换至另一台已成功访问商店的设备,复制其扩展详情页 URL 中的 GUID 字符串(形如 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
5、构造手动下载地址:https://addons.mozilla.org/firefox/downloads/latest/{GUID}/platform:all/addon:{GUID}/,将 {GUID} 替换为实际值后粘贴至新标签页访问,浏览器将自动触发 .xpi 文件下载。
四、通过 curl 或 wget 命令行工具批量抓取 xpi(Linux/macOS/Windows WSL)
适用于需要离线部署多个扩展的系统管理员,不依赖图形界面,可集成进自动化脚本。
1、在终端中执行以下命令安装必要工具(如未预装):sudo apt install curl wget jq -y(Ubuntu/Debian)或 brew install curl wget jq(macOS)。
2、获取目标扩展的 API 接口地址,例如 uBlock Origin 的最新版本信息:curl -s "https://addons.mozilla.org/api/v5/addons/addon/ublock-origin/" | jq -r '.current_version.files[].url'。
3、从输出中提取含 .xpi 结尾的真实下载链接,例如 https://addons.mozilla.org/user-media/addons/…/ublock_origin-latest.xpi。
4、运行 wget --no-check-certificate -O ublock-origin.xpi "https://..." 下载文件至当前目录。
5、验证文件完整性:执行 sha256sum ublock-origin.xpi,并与官方发布的 checksum 值比对。
五、Android 设备上使用 Chrome 手机版辅助下载 xpi
Firefox for Android 不支持直接拖放或文件选择安装,但可通过其他浏览器下载后借助文件管理器与 Firefox 协同完成离线安装。
1、在安卓手机上打开 Chrome 浏览器,访问 https://addons.mozilla.org/android/。
2、搜索所需扩展,点击进入详情页,确保页面显示 “为 Firefox for Android 设计” 标识。
3、点击绿色 “添加到 Firefox” 按钮,Chrome 将拦截该操作并显示下载提示。
4、点击下载通知栏中的下载项,在 Chrome 的下载管理器中长按该文件,选择“在文件管理器中显示”。
5、确认文件后缀为 .xpi,且大小明显大于 1KB;若为 .apk 或其他格式,则说明未正确触发扩展下载,需返回重试或改用 GitHub 方式。










