找不到日誌,先檢查擷取開關

訂閱更新失敗或連線異常時,日誌能協助記錄錯誤發生的時間與應用程式回報的資訊。不過,FlClash的日誌等級與日誌擷取是兩項不同設定;看得到或調整了等級,不代表日誌入口已經顯示。

本文適用於仍持續維護的 FlClash v0.8.99 正式版、Windows 11、amd64 / arm64、英文介面。此版本沒有繁體中文介面,以下保留實際英文標籤,中文僅作解說。步驟已依固定版本原始碼、介面字典與上游測試核對,未在Windows用戶端實機點選驗證;不套用Clash Verge Rev、Clash for Windows或Android的日誌路徑。

前提是FlClash已能正常開啟並進入設定。若程式尚未完成啟動就當機,本文的介面流程不適用,也不能據此推定磁碟上的當機日誌位置。這次不需要重新安裝、下載修補程式或修改YAML;請保留目前設定檔、代理模式與日誌等級,先只檢查擷取開關。

啟用Logcat,再回到日誌頁面

  1. 在主視窗開啟 Tools,找到 Settings 區塊,再點選 General。此處Settings是區塊標題,不是另一個必須先開啟的頁面。
  2. 在General頁面找到 Logs and diagnostics,先記下 Logcat 原本的開關狀態。若已啟用就保持原樣;若關閉則將它開啟。此版本初始預設為關閉,但既有設定檔可能已改變此狀態。
  3. 開關立即生效,沒有額外的儲存按鈕,也不會自動跳到日誌頁。返回主介面,在主導覽開啟 Logs;不要繼續在General設定裡尋找日誌內容。
  4. 記下目前時間,重新執行一次原本失敗的操作,再回日誌頁查看相近時間的紀錄。例如要排查一次訂閱更新失敗,就只重試一次更新;不必為了產生日誌,同時更換訂閱、切換節點或開啟TUN。

若沒有新紀錄,先確認擷取仍啟用、相關操作確實發生、核心正常執行,並檢查是否有搜尋條件遮住內容。紀錄較少也可能與目前日誌等級有關;不要假定預設是 info,本版初始設定的等級是 error,既有設定檔則可能不同。本文不要求先切換到 debug;若需要更詳細的紀錄,請依維護者針對該問題提出的要求另行調整。

擷取、日誌等級與篩選各影響什麼?

設定或操作作用不能據此認定
Logcat(日誌擷取)顯示日誌入口,並控制核心日誌訂閱的開始與停止關閉不等於刪除既有紀錄,也不保證所有應用程式內部日誌停止
Log level(日誌等級)影響核心輸出哪些等級的日誌改變等級或紀錄減少,不代表問題已解決
日誌頁的搜尋與等級標籤篩選協助從目前清單找出相關紀錄;點選等級標籤可加入篩選條件篩選後看到的清單不是匯出檔案的範圍

日誌頁可能同時出現核心事件,以及帶有 [APP] 標記的應用程式日誌。先看時間、等級與具體錯誤,再描述當時執行的操作;不要僅憑一條 error 就認定節點失效。本文不逐一解釋所有錯誤,也不把日誌頁當成完整的歷史瀏覽紀錄。

頁面顯示的是長度有限的記憶體緩衝區,舊紀錄可能被新紀錄擠出;重新啟動程式或重新載入設定,也可能讓這批紀錄不再保留。重現問題後請及時儲存,不要先重新啟動,再尋找剛才那一次錯誤。向上翻閱時暫停自動跟隨,只是改變清單的捲動與顯示,不等於停止收集日誌。

儲存日誌,分享前檢查實際檔案

需要留存紀錄時,在日誌頁使用提示文字為 Export logs 的匯出按鈕。在Windows儲存對話框中,選擇有寫入權限的本機資料夾,確認檔名後儲存。預設名稱格式是 FlClash_YYYY-MM-DD.log;這只是格式示意,實際日期依匯出時的系統時間產生。同一天再次儲存時,請優先使用不同檔名,避免覆蓋仍需保留的紀錄。

匯出成功後,應用程式會顯示 Export successful。接著用文字編輯器開啟實際儲存的檔案,確認包含這次重現問題前後的時間與錯誤。不要只憑檔名判定內容正確;取消儲存對話框不算成功儲存,出現錯誤時也不能假定目標檔案完整。

篩選不等於遮蔽敏感資訊:匯出讀取的是目前日誌緩衝區,不是只儲存篩選後看到的幾行。檔案可能含有存取的網域、IP、節點名稱、訂閱網址、Token或本機路徑。未檢查前,不要將整份檔案、截圖或完整訂閱連結貼到公開Issue、群組聊天或線上分析服務。

先在本機副本中保留錯誤附近、足以說明問題的片段,遮蔽帳號憑證與不願公開的位址,同時保留時間、錯誤類型及必要的前後文。再從文字編輯器複製這段已處理的內容,附上FlClash版本、Windows版本與重現步驟。這裡指一般文字編輯器的複製功能,不是FlClash另有一個「複製全部」按鈕。

排查結束後恢復原本的擷取狀態

回到 Tools → Settings → General → Logs and diagnostics,將 Logcat 恢復成操作前的狀態。原本關閉就關閉;原本啟用且仍需觀察,可以維持開啟。關閉後日誌入口會隱藏,核心日誌訂閱會停止。這不是清除按鈕,也不會替你刪除已儲存到磁碟的 .log 檔案。

帶有 [APP] 的應用程式內部日誌仍可能寫入緩衝區,因此不能把這個開關理解為「完全禁止任何日誌」。這次不需要刪除設定檔、清除應用程式資料或重設所有設定。已公開的憑證無法靠關閉擷取或刪除本機檔案收回;若誤貼了訂閱Token,請到對應服務商撤銷或重設。

最後應留下的是能對應具體操作、已檢查並遮蔽敏感資訊的紀錄,而不是越多越好的日誌包。若檔案找不到這次問題,重新確認擷取、時間與實際日誌等級,再做一次範圍明確的重現;不要自行補寫日誌或猜測錯誤原因。

官方來源與版本邊界

版本號、檔案名稱與介面文字可能隨專案更新而變動,操作前請以連結中的專案文件為準。