本文是一張速查表:在 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 error | TUN 啟動失敗,見 TUN 排查。 |
訂閱與 provider 類
| 日誌關鍵詞 | 含義與處理 |
provider ... initial failed / update failed | 規則集或節點 provider 下載失敗。多為需要代理才能造訪其 URL:先連上任一節點,再過載設定。 |
404 / 403 / 429(更新訂閱時) | 訂閱連結失效、被封或請求過頻,見訂閱失敗排查。 |
閱讀日誌的三個習慣
- 先看時間戳:只看你復現問題那幾秒的日誌,歷史報錯會誤導判斷。
- 關注重複模式:同一條錯誤對同一目標高頻重複,比零星一條有診斷價值。
- 配合 Connections 頁面交叉驗證:日誌說超時,連線頁看它命中的規則和節點,兩邊一對上,原因就清楚了。
提示:找不到對應條目時,把日誌裡的英文關鍵詞(去掉 IP 和連接埠)直接搜尋,Clash 系用戶端共享同一套核心報錯,社群討論量很大。