Cloudflare One Client DNS 失敗怎麼辦？2026.7.1376.0 熱修復與更新檢查

先確認是否落在這次熱修復範圍#

Cloudflare 官方 stable releases 頁面目前列出的版本與 release note 如下：

「一小部分」不等於每一台裝置都會遇到，也不表示更新後的所有解析失敗都由同一個 bug 造成。排查時要同時記錄 OS、client version、連線模式、發生時間和使用中的網路，才能分辨熱修復效果與其他變因。

Cloudflare One Client 為什麼會影響 DNS#

Cloudflare One Client（原名 WARP）可以建立通往 Cloudflare 網路的加密連線，也可以把 DNS 查詢透過加密的 DNS-over-HTTPS 路徑送出。在預設的 Traffic and DNS mode 中，DNS filtering、network filtering 和 HTTP filtering 的路徑會一起受到 client 設定影響。

因此，瀏覽器顯示 DNS_PROBE_FINISHED_NXDOMAIN、內部網域解析不到或 Gateway log 沒有預期查詢時，可能同時涉及：

• client 版本與 daemon 狀態。
• MDM 套用的 device profile、service mode 或 split tunnel。
• 第三方防毒、endpoint security 或本機防火牆攔截虛擬介面。
• captive portal、IPv4／IPv6 或目前網路的 DNS 路徑。
• Gateway policy、DNS location 或組織註冊狀態。

這也是為什麼「先換公共 DNS」通常不是企業裝置的完整修法：它可能繞過原本要由 Gateway 套用的政策，卻沒有修好 client 或註冊狀態。

如果最後確認問題其實在 Access application 或 Worker 入口，而不是裝置的 DNS 路徑，可以再看 Cloudflare Workers 怎麼套 Access；兩者的保護邊界不同，不要用 client 更新取代 Access policy 檢查。

第一步：收集版本、連線狀態與模式#

先在一台出問題的裝置上收集可重現的狀態。Cloudflare 官方文件提供 warp-cli 管理 client，也提供 warp-diag 收集診斷檔：

1
warp-cli -l status
2
warp-cli settings
3
warp-diag

warp-cli -l status 可以在重新連線前顯示連線階段；warp-cli settings 用來確認實際套用的設定；warp-diag 會產生 warp-debugging-info-<date>-<time>.zip。Windows 可在 Command Prompt 或 PowerShell 執行同一個 warp-diag，Linux 和 macOS 則在 Terminal 執行。

診斷時不要只複製 GUI 上的「Connected」。至少把以下欄位和問題發生時間放在同一份紀錄：

第二步：依裝置管理方式更新#

更新方式取決於裝置是誰管理，不能把「讓使用者按 GUI 更新」當成所有環境的標準流程。

第三步：更新後用固定順序回歸#

更新完成後，請在同一台裝置和至少一個代表性網路重跑問題，不要只看版本號已變更：

1. 重新確認 client version、registration 與 service mode。
2. 用同一個內部網域、公開網域和不存在的網域做 DNS 測試。
3. 在 Gateway logs 對照查詢是否抵達預期的 DNS location 和 policy。
4. 若使用 split tunnel，確認該網域或 IP 沒有被錯誤排除或導向其他 resolver。
5. 重新測試瀏覽器、CLI、內部 API 和需要 private network 的應用程式。
6. 若問題只在特定 endpoint security 或特定 Wi-Fi 發生，把差異記錄下來再收集診斷包。

Cloudflare 的更新指南特別提醒，更新後常見問題可能來自第三方安全軟體相容性。請在受控的測試裝置做 allowlist 或相容性驗證，不要為了快速排錯就在整個組織停用 endpoint protection。

什麼情況不能只靠升級 client#

如果升級後仍然失敗，依症狀切分，不要重複安裝同一個版本：

若是剛變更 profile 或全域 client settings，也要考慮設定傳播時間；Cloudflare 文件指出新的 device settings 可能需要一段時間才會到達裝置。把變更時間與 registration refresh 時間記在同一條 incident timeline，比反覆重裝更容易定位。

warp-diag 要收集哪些資料給支援#

重現問題後立即執行 warp-diag，並在 ticket 中附上最小但完整的背景：

• OS、client version、組織名稱與 device ID（依公司資料分享政策處理）。
• 問題開始與重現的時間，最好使用 UTC 和本地時間各一份。
• client mode、目前網路、是否透過 proxy、是否有 captive portal。
• 測試過的網域、預期解析結果、實際結果與 Gateway log query ID。
• 更新前後版本、MDM policy、endpoint security 變更。
• warp-debugging-info-<date>-<time>.zip，以及是否曾執行 warp-cli debug extra。

診斷包可能包含網路、裝置設定、網域和帳號識別資訊。上傳前依組織的支援流程和資料分類規則處理，不要把完整 log 貼到公開 issue 或聊天頻道。

結論：先 hotfix，再用診斷資料找剩餘差異#

這次 Cloudflare One Client 修正的直接檢查點是 Windows／macOS 2026.7.1376.0 和 Linux 2026.7.1377.0。遇到 DNS 查詢失敗時，先確認版本是否已更新，再依 MDM、Dashboard 或 unmanaged 路徑推送；如果問題仍在，使用 warp-cli、warp-diag、Gateway logs 和固定的 DNS 測試把 client、profile、第三方安全軟體與網路差異拆開。這樣才不會用一次重裝掩蓋真正的設定或相容性問題。

常見問題#