Chrome 155 中 chrome.debugger 的企業政策執行更嚴格

發布日期:2026 年 9 月 8 日,上次更新日期:2026 年 11 月 4 日

自 Chrome 155 起,Chrome 會更新企業政策限制對使用 chrome.debugger API 的擴充功能套用的方式。

這項異動只會影響在受管理瀏覽器上執行的擴充功能,且管理員必須明確設定 runtime_blocked_hosts、DisableScreenshots 或資料遺失防護 (DLP) 規則。

如果擴充功能在非受管瀏覽器上執行,或在沒有這些特定政策限制的企業環境中執行,chrome.debugger 會繼續正常運作,不會有任何異動。

時間表和推出

  • Chrome 155 Beta:2026 年 9 月 16 日
  • Chrome 155 穩定版推出日期:2026 年 10 月 6 日
  • 復原:2026 年 11 月 3 日

Chrome 155 的主要異動

下列異動只會影響企業管理的瀏覽器:

  • 主機限制:如果企業政策 (ExtensionSettings) 為擴充功能設定了非空白的封鎖主機清單 (runtime_blocked_hosts),則 chrome.debugger.attach() 會在所有目標上遭到拒絕,並顯示以下訊息:

    "Host access is restricted by policy."

    即使 runtime_allowed_hosts 包含特定來源,也是如此。

  • 螢幕截圖和資料遺失防護 (DLP) 限制:如果企業政策 (DisableScreenshots 或資料遺失防護 (DLP) 規則) 停用螢幕截圖功能,chrome.debugger.attach() 會失敗並顯示以下訊息:

    "Screenshot capture is restricted by policy."

個人資料夾和非受管環境則與以往一樣,可不受限制地存取 chrome.debugger。

chrome.debugger API 可直接存取 Chrome 開發人員工具通訊協定 (CDP),提供強大功能,包括任意指令碼評估和網路攔截。CDP 的運作層級低於網路平台的來源模型,因此無法透過來源篩選機制安全地限制 CDP。Chrome 155 採用全有或全無模型解決這個問題,在每次 chrome.debugger.attach() 呼叫時預先驗證企業政策。

妥善處理附加拒絕

請務必在擴充功能程式碼中處理附加拒絕,向企業版使用者提供明確的回饋:

// Promise-based (Manifest V3)
try {
  await chrome.debugger.attach({ tabId }, "1.3");
} catch (error) {
  if (error.message.includes("Host access is restricted by policy")) {
    console.warn("Debugger attach blocked: Extension has host restrictions configured by enterprise policy.");
  } else if (error.message.includes("Screenshot capture is restricted by policy")) {
    console.warn("Debugger attach blocked: Screenshots or DLP restrictions are enforced by enterprise policy.");
  } else {
    console.warn("Debugger attach failed:", error.message);
  }
}

// Callback-based
chrome.debugger.attach({ tabId }, "1.3", () => {
  if (chrome.runtime.lastError) {
    console.warn("Debugger attach failed:", chrome.runtime.lastError.message);
  }
});

考慮替代的高階 API

如果擴充功能不一定需要直接存取 CDP,請考慮改用支援精細主機權限,且可與企業主機許可清單和封鎖清單搭配運作的高階擴充功能 API:

企業管理員指南

更新 (2026 年 11 月 4 日):Chrome 155 政策強制執行措施已透過伺服器端設定更新復原,Chrome 會自動下載並在重新啟動後套用。如要停用強制執行,不必等待這項更新,請使用 --disable-features=ExtensionDebuggerStrictPolicyRestrictions 指令列旗標啟動 Chrome。

在復原生效前,下列指南仍適用。

企業管理員管理擴充功能政策時,請注意需要偵錯工具權限的擴充功能無法在部分主機限制 (runtime_blocked_hosts) 下運作。如果擴充功能需要 chrome.debugger,則不得在 ExtensionSettings 中設定封鎖的主機。

如果使用 DisableScreenshots 或資料遺失防護 (DLP) 規則停用螢幕截圖擷取功能,chrome.debugger.attach() 將會失敗。

如果貴機構需要主機封鎖清單或螢幕截圖限制,請確認內部或核准的擴充功能是否能遷移至較高層級的 API,例如 chrome.scripting 或 chrome.declarativeNetRequest。

提供意見

詳情請參閱 chrome.debugger API 說明文件。如有問題或意見回饋,請前往 Chromium 擴充功能 Google 群組。