連線疑難排解

Stash Mac DoH 失敗:5.0.0 修復

Stash Mac 自訂 DoH 解析失敗?先分清僅支援 HTTP/1.1 的上游、快取與 DNS 政策,備份後更新至 5.0.0(607),再驗證實際查詢與復原方式。

  • Stash
  • macOS
  • DoH
  • DNS
  • 5.0.0
本文目錄

節點看似可用,自訂 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 上游

使用同一份副本比較更新前後

  1. 記錄應用程式版本與原始失敗

    查看實際執行的原生 Stash Mac 版本與 build,保存目標 DoH 位址、相關 DNS 設定與已遮蔽敏感資訊的錯誤。不要只憑商店頁面、訂閱名稱或另一部裝置的版本判斷。

  2. 正常結束並更新原生應用程式

    先確認目前系統與授權適用於目標版本。在可以中斷目前網路連線時,正常停止並結束應用程式,透過原生 Mac 官方更新管道取得 5.0.0(607)的這項修復;若無法更新,先依下方方法恢復可用狀態。保留原資料與設定檔,不安裝來源不明的舊安裝包,也不要用替換核心檔案代替完整應用程式更新。

  3. 重新選取原本的測試設定檔

    重新開啟後核對實際版本與 build,選取保存的測試副本,再依原方式啟動。目標 DoH、節點與規則維持一致;若設定檔驗證或應用程式啟動失敗,先處理該階段的錯誤。

  4. 無法更新時,先恢復可用狀態

    先切回原設定檔,使用自己先前驗證可用的加密 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、訂閱位址與私有網域;完整原始紀錄請自行保留,以便復原。

參考資料