proxy.settings

一个 BrowserSetting 对象，用于更改浏览器的代理设置。

注意： 更改代理设置需要私密浏览窗口访问权限，因为代理设置会影响私密和非私密窗口。扩展是否可以访问私密浏览窗口由用户控制。有关详细信息，请参阅私密浏览中的扩展。您的扩展可以使用 extension.isAllowedIncognitoAccess 检查是否允许访问私密浏览窗口。如果您的扩展没有私密窗口权限，对 proxy.settings.set() 的调用将抛出异常。

底层值是一个对象。设置此对象时，所有属性都是可选的。任何省略的属性都将重置为其默认值。

autoConfigUrl 可选

string。用于配置代理的 URL。

autoLogin 可选

boolean。如果已保存密码，则不提示进行身份验证。默认为 false。

ftp 可选已弃用

string。FTP 代理的地址。可以包含端口。

http 可选

string。HTTP 代理的地址。可以包含端口。

httpProxyAll 可选

boolean。对所有协议使用 HTTP 代理服务器。默认为 false。

passthrough 可选

string。一组不应被代理的主机列表，用逗号分隔。可以定义为

HOST_NAME[:PORT]，例如：example.com 或 example.com:1234
IP_LITERAL[:PORT]
IP_LITERAL/PREFIX_LENGTH_IN_BITS，使用 CIDR 表示法
<local>，用于绕过所有不包含句点的域名的代理。

可以使用 IPv6 地址。例如，[::123]。

localhost、127.0.0.1 和 [::1] 永远不会被代理。

proxyDNS 可选

boolean。在使用 SOCKS 代理时是否代理 DNS。在使用 SOCKS5 时默认为 true，在使用 SOCKS4 时默认为 false。在 Firefox 128 之前，对 SOCKS4 和 SOCKS5 的默认值为 false。

proxyType 可选

string。要使用的代理类型。可能的值为："none"、"autoDetect"、"system"、"manual"、"autoConfig"。默认为 "system"。

socks 可选

string。SOCKS 代理的地址。可以包含端口。

socksVersion 可选

integer。SOCKS 代理的版本。可以是 4 或 5。默认为 5。

ssl 可选

string。TLS/SSL 代理的地址。可以包含端口。

示例

let proxySettings = {
  proxyType: "manual",
  http: "http://proxy.org:8080",
  socksVersion: 4,
  passthrough: ".example.org",
};

browser.proxy.settings.set({ value: proxySettings });

浏览器兼容性

帮助改进 MDN

了解如何贡献

此页面最后修改于 2025年7月17日，由 MDN 贡献者修改。

在 GitHub 上查看此页面 • 报告此内容的潜在问题