火狐浏览器离线安装.xpi插件有五种方法：一、拖放式安装（推荐，无需设置）；二、通过“从文件安装”入口（需禁用签名验证）；三、about:debugging临时加载（会话级，不持久）；四、命令行脚本安装（Linux/macOS批量部署）；五、文件关联双击安装（Windows/macOS图形界面捷径）。
如果您已下载火狐浏览器插件的 .xpi 离线安装包，但无法通过在线商店安装，则需采用本地文件加载方式。以下是多种可行的手动安装方法：
一、拖放式安装（推荐：无需设置、即时生效）
该方式利用火狐对 .xpi 文件的原生支持机制，在不修改任何配置、不启用调试模式的前提下，通过界面交互完成安装，操作最简且立即启用。
1、确保火狐浏览器已打开，并处于 附加组件和主题 页面（可通过右上角三点菜单 → “附加组件” 进入，或按快捷键 Ctrl+Shift+A）。
2、将已下载的 .xpi 文件从文件管理器中直接 拖拽至浏览器窗口任意空白区域（非地址栏、非网页内容区，建议拖至工具栏下方或标签页空白处）。
3、松开鼠标后，页面将自动弹出确认对话框，显示插件名称、版本及请求的权限声明。
4、点击 “添加” 按钮，插件即刻完成签名验证与安装，工具栏右侧同步出现对应图标。
二、通过“从文件安装附加组件”入口安装（需启用隐藏选项）
该方式将本地 .xpi 文件纳入常规扩展管理流程，安装后持久有效，适用于需长期使用自定义插件的用户；但需预先修改一项高级配置以绕过强制签名检查。
1、在火狐地址栏输入 about:config 并回车，确认风险提示进入高级配置页。
2、在搜索框中输入 xpinstall.signatures.required。
3、双击该项，将其值由 true 修改为 false。
4、重新打开菜单 → 选择“附加组件和主题” → 切换到“扩展”标签页。
5、点击右上角齿轮图标 → 选择 “从文件安装附加组件” → 浏览并选中目标 .xpi 文件 → 点击“打开”完成安装。
三、通过 about:debugging 临时加载（仅当前会话有效）
此方法专为测试未经 Mozilla 官方签名的 .xpi 文件设计，不修改浏览器安全策略，所有加载插件在关闭浏览器后自动卸载，无残留，适合快速验证功能。
1、在火狐地址栏中输入 about:debugging 并按回车键访问调试页面。
2、在左侧边栏中点击 “此Firefox” 选项。
3、滚动至页面底部，点击 “临时加载附加组件” 按钮。
4、在弹出的文件选择窗口中，定位并选中您已保存的 .xpi 文件（扩展名必须严格为 .xpi）。
5、点击“打开”，插件立即加载，并在页面顶部显示绿色成功提示及唯一扩展 ID 标识。
四、命令行脚本自动安装（适用于 Linux/macOS 批量部署）
该方式通过 Shell 脚本解析 profiles.ini 获取当前用户配置路径，解压 .xpi 内容，提取扩展 ID，并将文件结构复制至 extensions 目录，实现静默安装，适合系统管理员或自动化场景。
1、将脚本与目标 .xpi 文件置于同一目录，例如 /tmp/firefox-ext/。
2、将脚本中 xxxx.xpi 替换为实际文件名（如 adblock-plus.xpi）。
3、赋予脚本执行权限：chmod +x install-xpi.sh。
4、运行脚本：./install-xpi.sh。
5、脚本输出 “Installed extension.” 即表示已写入配置文件夹 ~/.mozilla/firefox/[Profile ID]/extensions/。
五、文件关联双击安装（Windows/macOS 图形界面捷径）
通过设置操作系统级文件关联，使 .xpi 文件默认由火狐浏览器打开，后续双击即可触发安装流程，无需手动拖拽或进入附加组件页面。
1、在文件管理器中右键单击任意 .xpi 文件。
2、选择“打开方式” → “选择其他应用”（Windows）或“显示简介”→“打开方式”（macOS）。
3、在应用列表中找到并选中 Firefox，勾选“始终使用此应用打开 .xpi 文件”。
4、点击“确定”或“更改全部”，完成关联设置。
5、此后双击任一 .xpi 文件，火狐将自动启动（如未运行）并弹出安装确认窗口，点击 “添加” 即可完成安装。
