1 分鐘定位故障來源
按順序做下面 4 步,能區分是訂閱本身有問題、網路問題、還是客戶端解析問題。
-
1瀏覽器貼上訂閱連結,看返回什麼
把訂閱連結(完整 URL)貼上到瀏覽器位址列訪問,觀察返回內容:
- 看到一大段 YAML 文字(含 proxies:、proxy-groups: 等欄位):訂閱本身正常,問題在客戶端解析或 UA 校驗,跳到第 3 步。
- 看到一串看似亂碼的 Base64 字元:訂閱是 V2Ray 格式,Clash 客戶端無法直接使用。看下面"原因 #4"。
- 頁面打不開 / 超時 / DNS 錯誤:訂閱伺服器不可達,看下面"原因 #2"。
- 返回歡迎頁 / 客服資訊 / "套餐已過期" 等文字:訂閱過期或被限速,看下面"原因 #1"。
-
2嘗試用 curl 模擬 Clash 的 User-Agent
如果瀏覽器看到的不是 YAML,但你確認是 Clash 訂閱,可能是機場強制要求 UA。終端執行:
curl -A "clash-verge" "你的訂閱連結" | head -50如果這次返回了 YAML,說明是 UA 校驗,看下面"原因 #6"。
-
3看客戶端日誌
開啟客戶端的"日誌"頁(部分客戶端在"設定 → 日誌"),關鍵字搜:
error/failed— 直接顯示原因yaml/parse— 解析錯誤timeout— 網路超時
-
4用 工具頁 校驗訂閱內容
如果是 Base64 內容,可在工具頁解碼看看裡面是 vmess / ss / trojan 等 V2Ray 類協議連結,確認是 V2Ray 格式而非 Clash 格式。
6 大常見原因 + 解決方案
按出現機率從高到低排列。前 3 個能覆蓋絕大多數情況。
最常見的原因。機場通常會在訂閱過期或流量用完時,把訂閱響應替換為歡迎頁或純文字提示。客戶端解析後自然得到 0 個節點。
訂閱伺服器域名或 IP 被你當前的網路運營商遮蔽。表現為瀏覽器開啟訂閱連結超時、DNS_PROBE_FINISHED_NXDOMAIN、ERR_CONNECTION_RESET 等。
- 切換 DNS 到 Cloudflare (1.1.1.1) 或 Google (8.8.8.8)
- 使用機場提供的備用訂閱連結(多數機場提供 2~3 個域名)
- 切換網路環境(家庭寬頻 ↔ 手機熱點)驗證
- 在客戶端訂閱設定裡啟用"透過當前代理更新訂閱"(需要先有可用節點)
機場通常在使用者面板提供多個訂閱連結:Clash、Clash Meta、V2Ray、Shadowrocket、Quantumult 等。如果複製了 V2Ray 連結到 Clash Verge Rev,匯入後無法識別。
瀏覽器開啟訂閱是一大段 dm1lc3M6Ly8... 這種沒法讀懂的字元。這是 V2Ray 通用訂閱,本質是 Base64 編碼的多行 vmess:// / ss:// / trojan:// 連結。
機場模板被維護錯(縮排錯、欄位拼錯),或本地手工編輯過的配置。Clash 核心遇到 YAML 解析錯誤會跳過整段,但客戶端可能不報錯只顯示"匯入成功"。
- 客戶端的"日誌"頁看是否有
yaml parse error類資訊 - 把訂閱內容貼上到任意 YAML Linter 工具(如 yamllint.com)驗證語法
- 聯絡機場客服反饋模板問題
部分機場用 UA 區分客戶端:瀏覽器訪問返回歡迎頁,User-Agent: clash 才返回 YAML,User-Agent: v2ray 返回 Base64。如果客戶端傳送的 UA 不匹配機場期望,會拿到錯誤格式。
clash-verge/v2.5.2ClashMetaForAndroidclash/Clash
按平臺的額外排查要點
- • Defender 可能臨時攔截訂閱請求
- • 檢查
hosts檔案是否遮蔽機場域名 - • 配置目錄:
%APPDATA%\io.github.clash-verge-rev.clash-verge\
- • 檢查"系統設定 → 網路 → DNS"是否被改
- • Wi-Fi 切換後強制重新整理訂閱
- • 配置目錄:
~/Library/Application Support/io.github.clash-verge-rev.clash-verge/
- • 終端
curl -v "訂閱連結"看完整 HTTP 互動 - • 檢查
/etc/resolv.conf與 systemd-resolved - • 配置目錄:
~/.config/clash-verge/
- • 4G/5G 與 Wi-Fi 切換後重試
- • 部分機場對移動端 UA 有限制,需手動指定
- • 不同瀏覽器(Chrome / 系統瀏覽器)訪問訂閱返回內容可能不同
向機場客服 / 社群求助前
按下面這份模板整理資訊,能極大提高解決效率,避免來回拉扯。
**客戶端**:Clash Verge Rev v2.5.2
**系統**:Windows 11 23H2 / macOS 14.5 / ...
**訂閱型別**:機場 / 自建 (註明協議如 Clash Meta)
**症狀**:
- 瀏覽器開啟訂閱連結,看到的內容是 ___
- curl -A "clash-verge" 測試,返回的是 ___
- 客戶端"日誌"頁看到的關鍵報錯:___
- 已嘗試過的方法:___
- 訂閱連結裡通常含 token,不要原樣貼出來,用
https://xxx.com/api/v1/client/subscribe?token=*****取代 - 日誌截圖前模糊掉節點名(可能含使用者名稱 / 套餐名)
- 不要把整段 YAML 貼公開論壇,裡面含節點 IP 與密碼
- 只貼關鍵報錯行 + 上下文 1~2 行