这问题我之前帮人排查过，Firefox的browserSettings.proxyConfig API确实有个让人头疼的点——它要求代理地址必须带http://前缀才能保存，但浏览器UI会把整个字符串（包括前缀）原封不动显示出来，看起来像是把前缀当成了代理地址的一部分，很容易造成误解。

问题根源 #

Firefox的browserSettings.proxyConfig底层依赖系统级代理配置的校验逻辑，它强制要求代理地址是完整的URL格式（包含协议前缀），否则会直接拒绝保存配置。而浏览器设置界面只是原样展示你传入的字符串，导致视觉上看起来http://被当成了IP或域名的一部分，但实际上Firefox内部会正确解析出proxy_address和proxy_port，只是显示层面的小问题。

两种解决方案 #

方案1：确认实际功能是否正常（无需修改代码）

如果你的核心需求是让代理正常工作，而非纠结UI显示内容，那原代码的配置其实是有效的——Firefox会自动忽略http://前缀，提取正确的代理地址和端口。你可以先测试代理是否能正常连接，要是功能没问题，那只是UI显示的小瑕疵，不需要改动代码。

方案2：使用PAC脚本规避前缀问题

如果你确实不想在配置中出现http://前缀，可以改用browser.proxy.settings API配合PAC脚本，这种方式更灵活，而且PAC脚本里的代理地址不需要带协议前缀：

// 使用PAC脚本配置代理
browser.proxy.settings.set({
  value: {
    mode: "pac_script",
    pacScript: {
      // PAC脚本逻辑：所有请求优先走指定代理，失败则直接连接
      data: `function FindProxyForURL(url, host) {
        return "PROXY proxy_address:proxy_port; DIRECT";
      }`
    }
  },
  // 配置作用范围：regular对普通网页生效，private对隐私窗口生效
  scope: "regular"
}).catch(error => {
  console.error("设置代理失败:", error);
});

这种方式的优势：

• PAC脚本内的代理地址无需带http://前缀
• 可以根据URL或域名灵活设置代理规则（比如指定部分网站不走代理）
• 完全符合Firefox扩展API要求，不会出现保存失败的问题

必要权限声明 #

不管用哪种方式，都需要在扩展的manifest.json中声明对应权限：

{
  "permissions": ["proxy", "browserSettings"]
}

• 使用browser.proxy.settings只需声明proxy权限
• 使用browserSettings.proxyConfig则需要声明browserSettings权限

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