本文是一張速查表:在 Logs 頁面看到報錯時按圖索驥。日誌格式隨核心版本略有差異,抓關鍵詞即可。

連線類

日誌關鍵詞含義與處理
dial tcp ... i/o timeout連目標(或節點)超時。偶發可忽略;集中出現看是哪個節點,換節點或按全超時排查
connect: connection refused目標拒絕連線。節點變了(更新訂閱)或目標服務本身沒開。
EOF / connection reset by peer連線被對端掐斷。單個網站如此=該站封了節點 IP,換節點;所有網站如此=節點或線路被幹擾。
no such host域名解析失敗。查 DNS 設定;也可能就是域名寫錯/已失效。
use of closed network connection連線切換期間的正常噪音(切節點、斷開全部連線時成片出現),無需處理。
合作推薦 訂閱連結從哪來? 本站合作機場註冊即送 1GB 香港高速體驗流量,可直接一鍵匯入。 取得高速節點

啟動與設定類

日誌關鍵詞含義與處理
bind: address already in use連接埠被佔,見衝突
yaml: line N: mapping values are not allowed設定第 N 行 YAML 語法錯誤(縮排/冒號後沒空格是重災區)。
proxy N: unsupport proxy type / unknown field設定裡有核心不認識的協定或欄位(訂閱含新協定節點)。該節點被跳過,其餘不受影響;節點大量缺失時見核心版本說明
rule ... error: proxy [X] not found規則指向了不存在的代理組名(改設定時改了組名沒改規則),整份設定會載入失敗。
start tun interface errorTUN 啟動失敗,見 TUN 排查

訂閱與 provider 類

日誌關鍵詞含義與處理
provider ... initial failed / update failed規則集或節點 provider 下載失敗。多為需要代理才能造訪其 URL:先連上任一節點,再過載設定。
404 / 403 / 429(更新訂閱時)訂閱連結失效、被封或請求過頻,見訂閱失敗排查

閱讀日誌的三個習慣

  1. 先看時間戳:只看你復現問題那幾秒的日誌,歷史報錯會誤導判斷。
  2. 關注重複模式:同一條錯誤對同一目標高頻重複,比零星一條有診斷價值。
  3. 配合 Connections 頁面交叉驗證:日誌說超時,連線頁看它命中的規則和節點,兩邊一對上,原因就清楚了。
提示:找不到對應條目時,把日誌裡的英文關鍵詞(去掉 IP 和連接埠)直接搜尋,Clash 系用戶端共享同一套核心報錯,社群討論量很大。