本文目錄
節點看似可用,自訂 DoH 卻解析失敗;換一個 DNS 又恢復正常。先保留目前設定檔與第一筆錯誤,不要同時換節點、改規則或關閉憑證驗證。
先確認原生 Mac 中哪個 DoH 查詢失敗
本文適用於已在原生 Stash Mac 使用自有 YAML、知道目前啟用哪份設定檔,且能保留可復原副本的使用者,處理僅支援 HTTP/1.1 的 DoH 上游相容問題。
官方 Mac 更新來源在 5.0.0(build 607)說明:服務不支援 HTTP/2 時會改用 HTTP/1.1。這不是所有 DNS 失敗的通用修復,也不能拿其他平台的版本號代替實際執行的 Mac 應用程式版本。
先從上游提供方的協定說明或伺服器連線紀錄,確認是否僅支援 HTTP/1.1。瀏覽器能開啟 DoH 位址,只能說明這次瀏覽器存取的結果,不能證明 Stash 已成功送出 DNS 查詢,也無法據此確定上游只支援哪個 HTTP 版本。
先依失敗階段判斷
| 觀察到的現象 | 應先核對的項目 |
|---|---|
| 同一個自訂 DoH 失敗,其他已知可用的上游正常 | 繼續檢查目標上游的協定支援與實際查詢路徑 |
| 節點本身的網域名稱無法解析 | 另行檢查 proxy-server-nameserver 與啟動時的解析鏈路 |
| 連線逾時或憑證驗證失敗 | 核對該上游的網路、位址與憑證,先別認定是 HTTP/1.1 相容問題 |
| 網頁仍能開啟,卻看不到新的 DNS 查詢 | 快取可能掩蓋結果,不能據此宣告目標上游正常 |
保留原設定檔,在副本核對實際 DNS 路徑
先另存目前使用的完整 YAML、自訂覆寫與原節點選擇,保留可重新啟用的原設定檔。不要直接修改唯一的託管設定檔,也不要依賴尚未確認能復原的雲端狀態;測試請使用自己維護的副本。
Stash 的 nameserver 設有多個上游時,會並行查詢並採用回應最快的結果。另一個上游成功,可能掩蓋目標 DoH 仍然失敗的情況;nameserver-policy 與 fallback 也會改變實際使用的解析伺服器。
已啟用的覆寫可能重新合入其他上游:陣列預設會插到前方,應先核對最終實際的 nameserver,不能只看原 YAML 文字。
若要進行對照,請在副本原有的 dns 區塊內,讓 nameserver 暫時只保留原先的目標 DoH;選擇不會被 nameserver-policy 或 fallback 改道的測試網域,並確認啟用的是這份副本。無法確認實際路徑時先停止修改,不要把混合結果當成單一上游驗證。
記錄原本的 follow-rule。預設 DNS 請求不會跟隨代理規則;啟用後,還要核對 DNS 上游的連線規則與啟動解析,避免遞迴。proxy-server-nameserver 用於代理伺服器的網域名稱,具有獨立查詢鏈路,不能把它成功當成一般目標網域已由 nameserver 解析。
這次對照只變更必要的上游清單,不同時切換 follow-rule、節點或流量接管方式,也不要把強制改用其他 HTTP 傳輸方式當成這項修復。不要關閉 TLS 憑證驗證來換取表面上的成功。
更新原生 Mac 應用程式,保留同一個 DoH 上游
使用同一份副本比較更新前後
記錄應用程式版本與原始失敗
查看實際執行的原生 Stash Mac 版本與 build,保存目標 DoH 位址、相關 DNS 設定與已遮蔽敏感資訊的錯誤。不要只憑商店頁面、訂閱名稱或另一部裝置的版本判斷。
正常結束並更新原生應用程式
先確認目前系統與授權適用於目標版本。在可以中斷目前網路連線時,正常停止並結束應用程式,透過原生 Mac 官方更新管道取得 5.0.0(607)的這項修復;若無法更新,先依下方方法恢復可用狀態。保留原資料與設定檔,不安裝來源不明的舊安裝包,也不要用替換核心檔案代替完整應用程式更新。
重新選取原本的測試設定檔
重新開啟後核對實際版本與 build,選取保存的測試副本,再依原方式啟動。目標 DoH、節點與規則維持一致;若設定檔驗證或應用程式啟動失敗,先處理該階段的錯誤。
無法更新時,先恢復可用狀態
先切回原設定檔,使用自己先前驗證可用的加密 DNS 上游。保留失敗紀錄與測試副本,等到可以更新時再做同一組對照;暫時更換上游不代表相容問題已修復。
本文核對的是 5.0.0(607)的官方修復。日後若使用其他版本,應核對其發行管道與是否包含同一項修復的證據;不必為了版本號相同而降級,也不保證官方管道能安裝任意歷史版本。
確認確實產生新查詢,再驗證實際存取
Stash 會快取 DNS 結果;快取過期後,也可能先沿用舊結果並在背景更新。舊網頁仍能開啟、一次延遲測試成功,或只是等了一段時間,都不能單獨證明目標 DoH 已恢復。
在自己的測試網域與可存取的日誌範圍內,確認確實產生新的 DNS 查詢,且使用的是目標 DoH;若有伺服器管理權限,也可配合該上游的請求紀錄。無法確認新查詢或實際上游時,將這一項記為尚未驗證,不要編造成功結果。接著重新建立需要該網域的新連線,確認實際網頁或業務能存取。
完成本題的驗證清單
- 實際執行的是包含修復的原生 Stash Mac,且已核對版本與 build。
- 目前測試設定檔、目標 DoH 與原節點明確,測試網域未被其他 DNS 路徑改道。
- 確認發生了新的目標上游查詢,而非只重用既有快取。
- 原本相關的解析錯誤不再出現,依賴該網域的新業務連線正常。
- 恢復所需的正常設定後再次核對,且仍可切回原設定檔與可用上游。
本站依據官方 Mac 更新來源與 DNS 文件提供判斷和操作建議,未在你的網路或真實 Stash 用戶端重現故障。網站的五語、原始碼與瀏覽器檢查,不等於裝置上的 DoH 或業務連線測試。
仍然失敗時,恢復原設定檔並依首筆錯誤繼續檢查
更新後,目標 DoH 仍逾時或回報憑證錯誤
恢復原設定檔與已知可用的加密 DNS;核對目標位址、可達性、憑證及提供方狀態。不要繼續把所有網路錯誤歸因於協定相容,也不要關閉憑證驗證。
切換設定檔後,節點網域也無法解析
先切回原設定檔,核對 proxy-server-nameserver、DNS 上游網域的啟動解析,以及原本的 follow-rule。恢復原先可用的鏈路,不要同時加入更多 DNS 或路由修改。
測試成功,恢復正常設定後卻再次失敗
逐項核對 nameserver-policy、fallback 與套用覆寫後的實際設定;保留單一上游測試及原設定檔供對照。另一個上游成功或命中快取,不能證明目標 DoH 一直正常。
應用程式無法啟動,或設定檔驗證失敗
先恢復原本可用的設定檔並停止疊加修改;保存應用程式版本、驗證錯誤與操作紀錄,依對應階段求助。不要刪除唯一的資料目錄,也不要依賴尚未確認能使用的舊版本來復原。
求助時提供 macOS、Stash Mac 版本與 build、上游協定依據、已遮蔽敏感資訊的 DNS 片段、第一筆錯誤與新查詢驗證結果。隱藏含權杖的 DoH URL、訂閱位址與私有網域;完整原始紀錄請自行保留,以便復原。
