ProxyOverrideRules

Proxy 覆寫規則

支援版本

  • Windows:≥ 145
  • macOS:≥ 145
  • Android:不支援
  • iOS:不支援

描述

此原則會啟用以規則為基礎的 Proxy 選取,以根據目的地 URL 和您定義的其他條件來決定 Microsoft Edge 使用的 Proxy。

設定此原則時,它會優先於 ProxySettings 原則、chrome.proxy 擴充功能 API 和任何手動使用者設定所設定的 Proxy 設定。

如果停用或不設定此原則,則會繼續套用現有的 Proxy 原則和使用者定義的設定。

選取 Proxy 時,Microsoft Edge 會依序評估 ProxyOverrideRules 原則中的項目。 當下列所有條件為真時,規則就會相符:

  • DestinationMatchers 中至少有一個 URL 模式相符。
  • ExcludeDestinationMatchers 中沒有相符的 URL 模式。
  • 如果指定 [條件] 且非空,則符合所有條件。

針對第一個相符規則,Microsoft Edge 會使用 ProxyList 中指定的 Proxy。 如果沒有相符的規則,Proxy 選取會回復至 ProxySettings 原則所定義的設定。

DestinationMatchers 和 ExcludeDestinationMatchers 支援的 URL 模式記錄在 https://learn.microsoft.com/deployedge/configure-microsoft-edge-proxy-support#proxy-config-url-patterns。

ProxyList 中的項目使用 PAC 樣式的 Proxy 字串,例如:

  • 直接
  • PROXY 主機:連接埠
  • HTTPS host:port
  • SOCKS4 host:port
  • SOCKS5 host:port

您也可以使用 URL 表單 Proxy 規範,例如:

  • http://host:port
  • https://host:port
  • socks4://host:port
  • socks5://host:port

Microsoft Edge 使用清單中第一個可連線的 Proxy。 無效的項目將被忽略。

[條件] 欄位會定義在套用覆寫規則之前必須符合的其他需求。 如果未指定此欄位,則每當目的地符合 DestinationMatchers 時,便會套用規則。

DnsProbe 條件會檢查指定的 DNS 主機是否可以解析為 IP 位址。 主機必須包括主機名稱 (例如 example.com) ,並且可以選擇性地包括配置或埠 (,例如 https://example.com、example.com:123 或 https://example.com:123) 。 例如,如果指定了安全配置 (,例如 https) ,DNS 查找可能也會要求 HTTPS 記錄 (請參閱 RFC 9460) 。

如果 [結果] 設為 [已解決],則當名稱解析成功時,即符合條件。 如果設為 not_found,則只有在名稱解析失敗時,才會滿足條件。

在受管理的裝置上,此原則的應用程式是由電腦層級 EnableProxyOverrideRulesForAllUsers 原則所控制。 根據預設,不會套用由非關聯使用者設定的覆寫規則。

支援的功能

  • 可強制執行:是
  • 可以建議:否
  • 動態原則重新整理:是
  • 每個設定檔:是
  • 適用於使用 Microsoft 帳戶登入的設定檔:是
  • 只能透過 Edge 管理服務中的雲端原則進行設定:是

資料類型

  • Dictionary

Windows 資訊和設定

群組原則 (ADMX) 資訊

  • GP 唯一名稱:ProxyOverrideRules
  • GP 名稱:Proxy 覆寫規則
  • GP 路徑 (強制):系統管理範本/Microsoft Edge/Proxy 伺服器
  • GP 路徑 (建議):不適用
  • GP ADMX 檔案名稱:MSEdge.admx

範例值

[{"Conditions": [{"DnsProbe": {"Host": "corp.ads", "Result": "resolved"}}], "DestinationMatchers": ["https://some.app.com", "https://Contoso.com"], "ExcludeDestinationMatchers": ["https://mail.Contoso.com"], "ProxyList": ["HTTPS proxy.app:443", "DIRECT"]}]

登錄設定

  • 路徑 (強制):SOFTWARE\Policies\Microsoft\Edge
  • 路徑 (建議):不適用
  • 值名稱..ProxyOverrideRules
  • 數值類型:REG_SZ

登錄值範例

[{"Conditions": [{"DnsProbe": {"Host": "corp.ads", "Result": "resolved"}}], "DestinationMatchers": ["https://some.app.com", "https://Contoso.com"], "ExcludeDestinationMatchers": ["https://mail.Contoso.com"], "ProxyList": ["HTTPS proxy.app:443", "DIRECT"]}]

擴充的範例登錄值

[
  {
    "Conditions": [
      {
        "DnsProbe": {
          "Host": "corp.ads",
          "Result": "resolved"
        }
      }
    ],
    "DestinationMatchers": [
      "https://some.app.com",
      "https://Contoso.com"
    ],
    "ExcludeDestinationMatchers": [
      "https://mail.Contoso.com"
    ],
    "ProxyList": [
      "HTTPS proxy.app:443",
      "DIRECT"
    ]
  }
]

Mac 資訊和設定

  • 喜好設定機碼名稱:ProxyOverrideRules
  • 範例值:
<key>ProxyOverrideRules</key>
<array>
  <dict>
    <key>Conditions</key>
    <array>
      <dict>
        <key>DnsProbe</key>
        <dict>
          <key>Host</key>
          <string>corp.ads</string>
          <key>Result</key>
          <string>resolved</string>
        </dict>
      </dict>
    </array>
    <key>DestinationMatchers</key>
    <array>
      <string>https://some.app.com</string>
      <string>https://Contoso.com</string>
    </array>
    <key>ExcludeDestinationMatchers</key>
    <array>
      <string>https://mail.Contoso.com</string>
    </array>
    <key>ProxyList</key>
    <array>
      <string>HTTPS proxy.app:443</string>
      <string>DIRECT</string>
    </array>
  </dict>
</array>

請參閱