問題診斷流程
當 ClashX 無法連接時,系統性的診斷流程能幫助你快速定位問題。遵循正確的排查順序可以避免浪費時間在錯誤的方向上。
快速診斷清單
首先執行這些基礎檢查：
檢視錯誤資訊
ClashX 的錯誤資訊能提供重要線索：
檢視日誌步驟
1. 點選選單欄 ClashX 圖標
2. 選擇"幫助" > "顯示日誌"
3. 查找包含 "error"、"failed"、"timeout" 的行
4. 記錄錯誤程式碼和時間戳
使用排除法：先測試是否所有節點都無法連線，還是僅特定節點。這能幫助判斷是節點問題還是本地配置問題。
連線失敗排查
常見連線錯誤型別
根據不同的錯誤資訊採取對應措施：
| 錯誤型別 | 症狀 | 可能原因 | 解決方法 |
|---|---|---|---|
| Connection timeout | 長時間無響應 | 節點失效或網路阻斷 | 切換節點 |
| Connection refused | 立即被拒絕 | 埠錯誤或服務未執行 | 檢查端口配置 |
| Authentication failed | 認證失敗提示 | 密碼或金鑰錯誤 | 更新訂閱或修改配置 |
| Network unreachable | 網絡不可達 | 本地網絡問題 | 檢查網絡連接 |
節點連線測試
系統性測試節點可用性：
- 點選"代理" > "延遲測試"
- 等待所有節點測試完成
- 選擇延遲最低的可用節點
- 如果所有節點都失敗，更新訂閱
訂閱更新問題
如果是訂閱導致的連接問題：
1. 檢查訂閱鏈接是否有效2. 手動更新訂閱配置3. 如更新失敗,聯絡服務商4. 備用方案:使用備份的設定檔
ClashX 需要搭配代理服務使用。NordVPN 提供快速穩定的連線，覆蓋 60+ 國家節點，是最受歡迎的選擇之一。
了解 NordVPN 優惠 →含聯盟推廣連結 · 廣告披露
DNS 問題解決
DNS 故障的表現
DNS 問題通常有以下症狀：
- 網頁顯示"無法解析域名"
- 可以 ping 通 IP 但無法訪問域名
- 某些網站可以訪問,某些不能
- 連線速度異常緩慢
修改 DNS 配置
優化 ClashX 的 DNS 設置：
推薦 DNS 配置
dns:
enable: true
ipv6: false
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
# 國內 DNS
nameserver:
- 119.29.29.29
- 223.5.5.5
- 114.114.114.114
# 國外 DNS (加密)
fallback:
- tls://1.1.1.1:853
- tls://8.8.8.8:853
- https://dns.google/dns-query
# 分流規則
fallback-filter:
geoip: true
geoip-code: CN
ipcidr:
- 240.0.0.0/4
- 0.0.0.0/32
清除 DNS 快取
刷新系統和 ClashX 的 DNS 快取：
清除快取命令
# macOS 清除系統 DNS 快取
sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder
# 重啟 ClashX 以清除應用快取
DNS 泄漏測試
驗證 DNS 是否正常工作：
訪問 dnsleaktest.com 檢查 DNS 查詢是否被正確代理。如果顯示的 DNS 伺服器與你的配置不符,說明存在 DNS 泄漏。
證書錯誤處理
證書錯誤型別
HTTPS 網站訪問時可能遇到的證書問題：
• 證書過期• 證書不受信任• 證書域名不匹配• 中間人攻擊警告
安裝 ClashX 證書
解決證書信任問題的步驟：
- 點選 ClashX 菜單 > "證書" > "安裝CA證書到系統"
- 輸入管理員密碼確認安裝
- 打開"鑰匙串訪問"應用
- 找到 ClashX CA 證書
- 雙擊證書,展開"信任"選項
- 將"使用此證書時"設為"始終信任"
證書問題排查
如果安裝證書後仍有問題：
- 檢查系統時間是否正確(證書有時效性)
- 重新生成並安裝證書
- 檢查是否有其他安全軟體干擾
- 嘗試禁用 HTTPS 解密功能
特殊網站證書問題
某些銀行或支付網站可能不相容 HTTPS 解密。可以在規則中新增 DOMAIN 規則,讓這些網站走 DIRECT,繞過代理。
網絡配置問題
系統代理設置檢查
驗證 macOS 系統代理配置：
防火牆配置
確保防火牆不阻止 ClashX：
防火牆設定步驟
1. 打開"系統偏好設置" > "安全性與隱私"
2. 點選"防火牆"標簽
3. 點選"防火牆選項"
4. 確保 ClashX 被允許接收傳入連線
端口衝突檢查
檢查 ClashX 使用的埠是否被佔用：
檢查端口命令
# 檢查埠占用
sudo lsof -i :7890
sudo lsof -i :7891
sudo lsof -i :9090
# 如果埠被佔用,可以在 ClashX 配置中修改端口
VPN 衝突問題
同時執行多個代理工具可能導致衝突：
使用 ClashX 時,建議關閉其他 VPN 或代理工具（如 ShadowsocksX、V2RayU、Surge 等）。如果必須同時使用,請確保它們使用不同的端口。
高級故障修復
完全重置 ClashX
當其他方法都無效時,嘗試完全重置：
重置步驟
# 1. 完全退出 ClashX
# 2. 刪除配置檔案
rm -rf ~/.config/clash
# 3. 刪除日誌檔案
rm -rf ~/Library/Logs/ClashX
# 4. 重新啟動 ClashX
# 5. 重新新增訂閱或配置
重置前務必備份你的設定檔和訂閱鏈接！可以將 ~/.config/clash 目錄復制到安全位置。
重新安裝 ClashX
如果應用本身出現問題：
- 完全退出 ClashX
- 將 ClashX.app 移到廢紙簍
- 清空廢紙簍
- 從官方 GitHub 下載最新版本
- 安裝並重新配置
使用增強模式
如果系統代理模式不工作,嘗試增強模式：
增強模式可以捕獲不遵循系統代理設置的應用流量。在 ClashX 菜單中勾選"增強模式"即可啟用。
尋求幫助
如果以上方法都無法解決問題：
- 在 GitHub Issues 搜尋類似問題
- 加入 Telegram 社羣尋求幫助
- 聯絡你的代理服務商技術支援
- 提供詳細的日誌資訊以便診斷
| 資源 | 用途 | 鏈接 |
|---|---|---|
| GitHub Issues | 報告 bug 和問題 | github.com/ClashX-Pro/ClashX |
| 官方文件 | 檢視詳細說明 | clash.wiki |
| 社羣論壇 | 交流經驗 | 各大技術論壇 |
