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 上檢視此頁面 • 報告此內容的潛在問題