連線疑難排解

Mihomo 加密訂閱出現 no identities found

Mihomo 加密 proxy-provider 更新時出現 no identities found?核對核心私密金鑰、provider 個別設鍵、v1.19.34 修正及暫時處理方式,再驗證更新與還原。

  • Mihomo
  • age
  • proxy-providers
  • 訂閱解密
  • v1.19.34
本文目錄

同一把私密金鑰可以解開完整設定,放進全域啟動參數後,加密節點的 provider 卻仍更新失敗。先保留第一則錯誤和原本可用的設定,不要急著重新產生金鑰或刪除訂閱快取。

先確認出問題的是加密 provider

本文處理使用 age ASCII armor 的 Mihomo proxy-provider:實際核心已有配對的全域私密金鑰,項目的 age-secret-key 未設定或為空,卻出現 decrypt config error: no identities found。不能只憑這則錯誤就認定遇到本文缺陷。

官方 #3449 提供了全域私密金鑰與 provider 私密金鑰的對照,回報者使用 Alpha 478af2a。v1.19.33 的固定版本原始碼也能看到先解析空金鑰的流程;這不代表所有舊版或所有訂閱匯入失敗都受影響。

依失敗階段分別檢查

目前情況優先檢查項目
加密 provider 出現 no identities found核對實際核心、全域私密金鑰,以及 provider 是否另外設鍵
回傳登入頁、驗證失敗或下載逾時先解決取得內容的問題,解密修正無法單獨處理這些狀況
連完整主設定都無法讀取檢查主設定的載入方式與私密金鑰來源,不直接套用 provider 的排查方法

已有全域私密金鑰,為何仍找不到解密身分?

provider 解析器會把該項目的 age-secret-key 傳給解密函式。舊實作即使收到空字串,也會先嘗試將它解析為私密金鑰;這一步出錯時,尚未進入後續嘗試全域私密金鑰的流程。因此,未另外填鍵,反而可能擋住原本可用的全域金鑰。

#3450 的修正會跳過真正的空字串,讓後續全域私密金鑰的流程繼續執行,v1.19.34 正式版已收錄。它不會將空白、損壞或無效的非空私密金鑰自動變成有效金鑰,也不會替尚未載入全域私密金鑰的程序補上金鑰。

獨立核心的 -age-secret-key 參數預設可從 CLASH_AGE_SECRET_KEY 讀取。但在自己的終端機設定變數,不代表已執行的圖形客戶端或背景服務繼承了它。必須核對真正啟動該核心的方式,不能只看另一個終端機裡的值。

更新實際核心;暫時無法更新時,另外指定原私密金鑰

先備份可還原的設定、原有金鑰處理方式和加密 provider 快取,記錄原本可用的核心與啟動方式。保留密文與配對私密金鑰的關係,不要為這則錯誤產生一把無關的新私密金鑰。

透過專案支援的方式取得包含 #3450 修正的核心。本文已核對的正式版為 v1.19.34;使用客戶端時,要確認該客戶端支援的核心更新方式,不能只憑圖形介面的應用版本判斷,也不要任意覆蓋服務目錄中的程式。

針對同一個 provider 操作

  1. 確認原私密金鑰確實與這份密文配對

    保留現有合法私密金鑰與原 provider 內容,對照原本可用時的紀錄。加密時指定的收件者公鑰必須對得上解密用的私密金鑰;不要將訂閱權杖、公鑰或另一份設定的私密金鑰當作解密身分。

  2. 核對實際啟動檔案與新核心

    獨立核心可對真正使用的執行檔查看版本;圖形客戶端或服務則查看核心資訊和新的啟動記錄。接著依專案要求正常重新啟動,保留原本合法的全域私密金鑰載入方式,讓新程序實際使用修正。

  3. 暫時無法更新時,使用 provider 自己的欄位

    在原 proxy-providers 項目內,將同一把現有、配對且合法的私密金鑰填入 age-secret-key,再按原方式儲存並重新載入。#3449 回報者觀察到這樣可以正常解密;這是暫時處理建議,不是本站的實機測試結果。

  4. 保留其他設定,只更新這一項

    保持原 provider 名稱、位址、路徑與節點選擇不變,重新更新同一個 provider,查看第一則錯誤。不要同時換訂閱、換金鑰或清除快取,以免失去可比較、可還原的狀態。

查看獨立核心版本:須對應實際啟動檔案
mihomo -v

上方指令只會顯示呼叫到的程式版本;PATH 裡的同名程式未必是客戶端正在執行的核心。下方欄位示意只加在原 provider 項目內,不是完整設定;佔位符必須換成你已有的配對私密金鑰,不能直接照抄執行。

暫時欄位示意:放在原 provider 項目內
age-secret-key: "<YOUR_EXISTING_MATCHING_PRIVATE_KEY>"

將私密金鑰保存在自己控制的設定位置,不要貼進求助截圖、指令歷史或公開記錄。不要直接編輯會重新產生的執行期 YAML 來永久保存欄位;應使用原本支援的設定或持久覆寫入口。

確認 provider 載入成功,再發出實際請求

先確認新啟動的實際核心包含 v1.19.34 修正,再更新原本失敗的 provider。檢查這次更新是否完成、原解密錯誤是否不再出現,以及預期節點是否確實載入;舊清單仍在或語法檢查通過,都不能單獨證明遠端密文已解開。

接著選擇其中一個預期節點,對原本要存取的目標發出新的實際請求,搭配連線紀錄驗證。provider 解密成功只代表取得節點設定,不保證節點、DNS 或目標服務都能連線。

本題驗證清單

  • 已確認實際執行的核心、啟動方式與私密金鑰來源,不只核對圖形介面版本。
  • 測試使用同一份 provider 密文與配對私密金鑰,沒有靠更換訂閱掩蓋結果。
  • 這次 provider 更新成功、預期節點已載入,原解密錯誤未再次出現。
  • 新的實際代理請求正常;失敗時保留目前第一則錯誤,繼續區分網路問題。
  • 備份仍可還原,新增的 provider 私密金鑰副本也已納入自己的設定保護。

仍失敗時,依第一則錯誤還原與排查

全域私密金鑰實際上未傳入服務或客戶端核心

回到專案支援的啟動設定核對,正常重新啟動後再確認。不要憑另一個終端機的臨時變數,推斷原有程序已取得私密金鑰。

provider 填了空白、錯誤或損壞的非空私密金鑰

核對原本合法的私密金鑰及其對應密文。修正只跳過空字串,不能默默忽略非法金鑰,也不保證自動改用其他金鑰就能成功。

內容不是預期的 age ASCII armor,或在下載階段已失敗

核對實際回傳內容與下載錯誤,再向提供方確認格式和金鑰。不要用同一項修正解釋登入頁、驗證失敗或無關的 YAML 錯誤。

儲存或重新載入後,連原設定也無法使用

停止追加修改,還原已驗證可用的設定、啟動方式及受保護的快取副本;必要時依專案支援的方式回到原本可用的核心。還原不代表舊缺陷已修復。

回報時提供完整核心版本、provider 類型、使用全域還是項目私密金鑰,以及去識別化後的第一則錯誤。完整設定、密文原件與私密金鑰留在自己控制的位置,求助副本先移除訂閱權杖、私密金鑰和節點密碼。

本文依官方發布、固定版本原始碼與問題討論復核,沒有下載核心、處理你的憑證或在實際客戶端重現解密。#3449 目前仍開放,不將已合併修正寫成問題已關閉或使用者驗收完成。

參考資料