設定支援 / 問題索引
Clash 常見問題
先確認問題發生在設定匯入、流量接管還是目標連線,再依相關分類檢查。展開問題即可查看操作步驟。
入門指南
先區分用戶端、核心、設定與流量接管方式,避免將不同環節的問題混為一談。
Clash 用戶端、mihomo 核心和訂閱有什麼不同?
用戶端負責匯入設定、切換系統代理及查看連線記錄等操作;mihomo 核心負責協定連線、DNS 解析與規則執行;訂閱則是服務提供者提供的設定或節點資料。安裝用戶端不會自動取得可用節點,也不會建立服務帳戶。排查時先區分介面、核心執行或服務問題:核心無法啟動時查看記錄,設定無法匯入時檢查格式,帳戶到期或節點停用則向訂閱提供者確認。
Clash for Windows 停止維護後該如何遷移?
Clash for Windows 已停止維護,遷移時請選擇仍持續維護且支援目前作業系統的用戶端。先記下訂閱網址、連接埠、規則模式與本機覆寫內容,關閉舊用戶端的系統代理並結束程式,再啟動新用戶端匯入訂閱。請勿同時執行兩個用戶端接管網路,也不要直接複製舊程式資料夾覆蓋新程式。遷移後先測試單一節點與常用應用程式,再逐項還原自訂規則;舊設定中的實驗性欄位,請依新核心文件重新確認。
規則、全域與直連模式分別適用於哪些情況?
日常使用通常選擇規則模式,讓已進入核心的連線依規則順序套用對應策略。全域模式會將這些連線交由全域策略處理,適合短時間比對與排查;直連模式則讓連線直接存取目標。模式不等於流量接管方式,切換至全域也不會自動接管所有應用程式。請先確認系統代理或 TUN 已涵蓋目標應用程式,再比較模式差異。若全域模式可用、規則模式卻失敗,應檢查命中的規則與策略群組,而不是直接重新安裝用戶端。
啟用系統代理就代表所有應用程式都會經過 Clash 嗎?
系統代理只會影響遵循系統代理設定的應用程式,無法保證涵蓋遊戲、部分命令列工具或自行建立連線的軟體。有些瀏覽器擴充功能也會覆寫系統代理。先在用戶端的連線記錄中尋找目標應用程式的新請求;若沒有記錄,優先檢查應用程式內的代理設定、擴充功能設定與流量接管方式,而非更換節點。若需要涵蓋更多流量,可評估使用 TUN,但仍須檢查路由、排除項目與平台限制。連線進入核心後,也可能因規則設定而採用直連。
安裝設定
確認設定格式與啟用狀態,再處理系統授權和應用程式相容性。
匯入訂閱連結後,如何確認設定已生效?
在用戶端的設定或訂閱頁面使用 URL 匯入功能,貼上服務提供者給的完整網址,儲存後等待下載與解析完成。成功匯入不代表已切換使用,還要將該設定設為目前設定,確認策略群組已載入並選擇可用策略。接著啟用一種流量接管方式,瀏覽目標網站並查看連線記錄。訂閱網址可能包含帳戶憑證,請勿放入截圖、公開記錄或群組聊天;若網址已外洩,請至服務提供者的管理頁面重設後重新匯入。
為什麼 YAML 檔案可以匯入,Base64 節點清單卻出錯?
完整的 Clash YAML、節點集合與 Base64 編碼的分享連結清單是不同格式。完整設定通常包含代理、策略群組與規則;單獨的節點清單可能需要作為代理集合引用,不能直接當成主要設定載入。Base64 只是一種編碼方式,不代表內容必然與目前的用戶端相容。建議向訂閱提供者索取支援 Clash 或 mihomo 的設定網址,並確認協定是否相容。請勿將含帳戶資訊的訂閱交給不明轉換網站;格式錯誤也不應靠反覆更換連接埠處理。
TUN 模式顯示權限不足或無法建立虛擬網卡,該怎麼辦?
先確認核心運作正常,再依用戶端提示安裝或啟動服務模式,並完成系統授權。Windows 通常需要系統管理員權限,或正確安裝背景服務;macOS 需依提示授權相關網路元件;Linux 通常需要存取 TUN 裝置及網路管理權限。檢查安全軟體是否攔截,以及是否有其他 VPN 正在接管路由。請勿提升來源不明程式的權限,也不要長期關閉系統防護。完成授權後重新啟動相關服務;若仍失敗,請記錄建立網卡階段的記錄再進一步排查。
Windows 的 UWP 應用程式無法使用本機代理,該怎麼辦?
部分位於 AppContainer 沙箱中的應用程式受到本機迴圈存取限制,無法直接連線至用戶端監聽的本機代理連接埠。先確認瀏覽器能否透過相同代理連線,再判斷是否只有特定應用程式失敗。若用戶端提供迴圈存取豁免工具,了解用途後可只針對目標應用程式啟用豁免,並依提示授予系統管理員權限;若沒有此工具,可參閱 Windows 的 CheckNetIsolation 用法。並非所有商店應用程式都受相同限制;若已啟用 TUN,請先查看連線記錄與路由,不要重複新增無關豁免。
使用技巧
根據連線記錄,檢查流量接管入口、規則命中情況及設定的實際生效值。
系統代理已啟用,瀏覽器卻沒有走代理,該怎麼辦?
先確認目前設定已成功載入、核心正在執行,再檢查系統代理是否指向正確的本機位址與監聽連接埠。連接埠應與用戶端實際生效的 mixed-port 或 HTTP 連接埠一致;HTTP 代理不可填入 SOCKS 專用連接埠。檢查瀏覽器擴充功能、應用程式內的獨立代理設定與系統略過清單,然後重新送出請求並查看連線記錄。若記錄顯示 DIRECT,表示請求可能已進入核心,但依規則採用直連;請檢查命中的規則。若完全沒有記錄,再檢查流量接管設定。
自訂規則應該放在哪裡?為什麼新增後沒有作用?
規則會由上而下比對,具體規則應放在兜底 MATCH 之前,並指向目前設定中確實存在的策略群組或內建策略。優先使用用戶端提供的覆寫、合併或持續保存規則功能;直接修改訂閱產生的檔案,可能在更新後遺失。儲存後重新載入設定,再透過連線記錄確認實際命中的規則。既有連線可能仍沿用舊策略,必要時只中斷目標連線後重試。若使用網域規則,也要確認核心能識別該連線的目標網域。
Clash 節點測速結果該如何判讀?
用戶端常見的延遲測試,主要反映連線至指定測試位址的一次結果,不等同下載速度,也不保證所有網站都能使用。先確認測試位址本身可連線,再以相同條件測試同一批節點,避免同時大量測速影響結果。日常選擇應綜合考量目標網站的連線狀況、連線穩定性與服務提供者的流量限制。若延遲低但服務無法使用,請檢查目標網站的限制與協定相容性;若測試逾時但實際瀏覽正常,則先檢查測試位址與逾時設定。
修改 DNS 或更新 GeoIP 後,還需要做什麼?
修改 DNS 欄位後應重新載入設定,並確認用戶端沒有透過介面設定或覆寫內容蓋掉這些欄位。檢查記錄是否有上游解析失敗,再依用戶端支援的方式清除 DNS 快取並重新建立目標連線。更新 GeoIP 或其他地理資料時,應使用目前核心支援的資料格式與設定路徑,完成後確認資料已成功載入。GeoIP 會影響相關 IP 規則,不會自動修復網域解析。若問題只發生在特定網域,應一併檢查 DNS 結果、比對規則與策略選擇。
故障排除
保留目前可用的設定,並區分訂閱回應、節點連線與本機網路殘留設定。
訂閱更新顯示 401、403、404 或回傳 HTML,該怎麼辦?
先保留目前仍可用的設定,避免反覆刪除而失去排查依據。401 或 403 通常與授權、網址憑證或存取限制有關;404 可能表示網址已變更,但仍應以服務提供者的說明為準。若回傳 HTML,常見原因是複製到登入頁面網址,或請求遇到網頁驗證。請至服務提供者的管理頁面重新複製專用訂閱網址,確認帳戶期限與流量後再手動更新。請勿公開完整回應內容或訂閱網址;若只是網路逾時,應先檢查更新請求使用的網路路徑。
所有節點都逾時,應依什麼順序檢查?
先確認停止流量接管後基本網路仍可使用,再檢查裝置時間、帳戶狀態與訂閱更新結果。接著只選一個節點,送出一次目標請求並查看同一時段的記錄,判斷是網域解析失敗、連線遭拒、交握失敗,還是測試位址逾時。若所有節點都來自同一服務,可向服務提供者確認服務狀態;若只有一種協定失敗,應檢查核心是否支援該協定及參數是否完整。不要同時修改 DNS、連接埠與規則,否則不易找出原因。分享記錄前,請刪除訂閱憑證、節點密碼及其他帳戶資訊。
7890 連接埠已被占用,該如何修改 mixed-port?
先從記錄確認是否為監聽失敗,再使用 Windows 的 netstat 或 macOS、Linux 的 lsof 查看占用 7890 的程序,避免直接結束不明系統程序。若是舊用戶端仍在執行,請先正常結束;若必須保留該連接埠,可在目前用戶端的連接埠設定或有效設定中修改 mixed-port,選擇未被占用的連接埠後重新載入。訂閱檔案可能受到覆寫設定影響,請以實際執行值為準。修改後也要同步調整系統代理、瀏覽器與命令列工具中的連接埠,並確認記錄不再出現監聽錯誤。
結束用戶端後無法連上網路,如何還原網路設定?
常見原因是系統仍指向已停止監聽的本機代理。建議先重新開啟用戶端,關閉系統代理與 TUN 後正常結束,再檢查系統網路設定是否仍有手動代理。如果應用程式設有獨立代理,或命令列設定了代理環境變數,也要分別還原。若曾使用 TUN、手動 DNS 或其他 VPN,請確認路由與 DNS 是否已還原,必要時重新連線網路。不要一開始就重設網路或刪除所有網卡;先保留目前設定記錄,再依代理、DNS、路由的順序逐項排查。