内网自托管Firefox插件自动更新问题求助

一、先搞定JSON解析错误（核心问题） #

控制台报的SyntaxError是因为Firefox拿到的不是纯JSON内容，大概率是这几个原因：

• Confluence返回了HTML页面而非纯JSON：Confluence默认会把上传的文件套上页面模板（比如导航栏、页面框架），直接访问update_url的链接看看，要是返回内容带<html>标签，就是这个问题。得确保用Confluence的直接下载链接（而非页面预览链接），让服务器返回纯JSON文件。
• JSON语法错误：实际文件里要保证所有引号都是英文双引号，键名和字符串值都正确包裹，逗号没有多写或漏写。正确的update.json格式参考：

{
  "addons": {
    "你的插件ID@域名": {
      "updates": [
        {
          "version": "1.0.0",
          "update_link": "https://内网Confluence地址/插件安装包.xpi"
        }
      ]
    }
  }
}

• 响应头不符合要求：Firefox要求JSON文件的响应头是Content-Type: application/json，如果Confluence返回text/html，也会导致解析失败。可以用浏览器网络面板查看请求的响应头。

二、未签名插件的更新权限配置 #

Firefox默认禁止未签名插件更新，必须修改配置：

1. 打开Firefox的about:config页面
2. 搜索并修改以下配置：
   • xpinstall.signatures.required：设为false，允许未签名插件安装/更新
   • extensions.update.enabled：确保值为true，开启扩展更新功能
3. 建议用Firefox企业部署工具（比如组策略）统一推送这些配置，避免用户手动修改的麻烦。

三、消除内网Telemetry错误 #

因无外网导致的Telemetry连接错误，直接禁用相关功能即可：
在about:config里修改：

• toolkit.telemetry.enabled：设为false
• toolkit.telemetry.server：清空或设为内网无效地址，避免无用的连接尝试

四、额外排查要点 #

• 确认update_url和update_link的地址在内网能正常访问，Confluence的页面/附件权限要对所有内网用户开放
• 检查XPI安装包的响应头，需为application/x-xpinstall，否则Firefox可能无法识别
• 用about:debugging加载插件，在网络面板查看更新请求的详细内容，直接确认返回的是否为正确JSON

内容的提问来源于stack exchange，提问作者Michael Rudd