說明中心 · 20 則常見問答

Clash 常見問題

訂閱匯入、代理連線與網路故障排除。先確認請求是否進入核心,再檢查規則、節點及 DNS;每次只修改一項設定。

點選問題即可展開解答。不同用戶端的設定名稱可能略有差異,解答也列出可供比對的設定欄位。初次設定可先閱讀入門教學,完整參數及覆寫方式請參閱進階手冊。

基礎認識

釐清用戶端、核心與代理模式的差異,避免把安裝完成或測試成功誤認為所有連線都已納入代理。

Clash、mihomo 與圖形化用戶端有什麼關係?

Clash 是這類規則代理工具的專案名稱,mihomo 則是沿用並擴充相關設定架構的核心;Clash Verge Rev、FlClash 等圖形化用戶端負責匯入訂閱、選擇策略組及調整系統設定。介面能啟動,不代表核心已正常載入設定。遇到不支援的設定欄位時,先在用戶端的「關於」或核心設定中確認目前使用的核心,再查看記錄中的解析錯誤。教學中的 mihomo 欄位不一定適用於所有舊版 Clash 核心。

安裝用戶端後,為什麼還需要訂閱或設定檔?

用戶端負責讀取設定並轉送連線,安裝完成後不會自動取得可用的代理伺服器。訂閱通常包含伺服器資訊、策略組及分流規則,也可能只有節點,需要用戶端另外產生規則。先向實際的服務提供者取得支援目前核心的設定,再到設定頁匯入並啟用。請勿把登入頁面網址當成訂閱網址,也不要在公開留言區張貼訂閱連結;連結中的存取識別資訊可能讓他人讀取同一份設定。

規則、全域、直連三種模式該怎麼選?

日常使用建議選擇規則模式,對應 mode: rule,連線會依 rules 的順序決定出口。全域模式會將已進入核心的連線交由全域策略組處理,適合短時間交叉測試,但不代表所有系統應用程式都已納入代理。直連模式會讓已進入核心的連線直接連線至目標,也不代表系統代理已關閉。切換模式後,請重新建立測試連線,並在連線頁確認實際出口;既有連線可能仍沿用建立時的策略。

系統代理和 TUN 模式有什麼差別?

系統代理主要是修改作業系統的 HTTP 代理設定,是否生效取決於應用程式是否讀取這項設定;部分命令列程式、遊戲及使用獨立網路堆疊的應用程式可能會略過系統代理。TUN 透過虛擬網卡和路由接管更多 IP 流量,對應 tun.enable,並需要系統授權或服務權限。建議先用系統代理完成基本驗證,再視需要啟用 TUN。TUN 的接管範圍也會受路由、排除規則及其他 VPN 影響,不能只看開關顯示已啟用,就認定所有連線都已進入核心。

節點延遲測試成功,為什麼實際網站還是打不開?

延遲測試通常只會測量透過節點連線至指定測試網址所需的時間,不代表目標網站、所有通訊協定及目前的分流規則都能正常使用。先到代理頁確認目標策略組已選取測試過的節點,再開啟目標網站,並查看連線頁中的命中規則及出口。若連線沒有進入用戶端,請檢查系統代理或應用程式代理;若已進入但連線失敗,則查看 DNS、TLS 或連線逾時記錄。別只憑延遲數字反覆更換設定,目標服務本身也可能限制該出口。

名詞解釋:核心、策略組與網路堆疊術語。

安裝與設定

從設定格式、帳戶狀態及本機權限著手。先載入訂閱,再啟用需要額外授權的功能。

訂閱連結匯入失敗或顯示格式錯誤,該怎麼處理?

在設定頁新增遠端設定,貼上完整的訂閱網址,並確認網址前後沒有空格,也沒有被通訊軟體截斷。若記錄顯示 YAML 解析錯誤或缺少代理資訊,可能下載到的是登入頁、錯誤提示頁或不相容的訂閱格式,而非有效設定。請向服務提供者確認應選用 Clash 或 mihomo 格式,再重新匯入;如果只有 Base64 節點連結,不能直接當作完整 YAML 使用。排查時請保留錯誤行號,但分享截圖前務必遮住訂閱網址和伺服器憑證。

訂閱失效,或更新後節點變少了,該先檢查什麼?

先到服務提供者的帳戶頁面確認方案狀態、訂閱網址是否已重設,以及節點是否有調整,再到用戶端設定頁手動更新一次。HTTP 401 或 403 通常與授權或存取限制有關,404 可能代表網址已變更,光是反覆點選更新無法解決問題。更新成功後,請確認目前啟用的設定就是這一份,並查看用戶端是否設定了節點篩選。請勿使用來源不明的轉換服務處理包含存取識別資訊的訂閱;若本機有可用備份,覆寫前先留存一份。

混合連接埠在哪裡設定?應用程式要填哪個位址?

通常可在用戶端設定頁的連接埠或代理設定中查看混合連接埠,對應 mixed-port;7890 是常見範例,並非所有用戶端的固定值。修改後請儲存設定,必要時重新載入核心。支援手動設定 HTTP 或 SOCKS5 代理的本機應用程式,可填入 127.0.0.1 和實際混合連接埠,並選擇應用程式要求的通訊協定。若顯示連接埠已被占用,請先關閉重複執行的用戶端,或改用閒置連接埠,並同步更新應用程式內的代理設定,避免兩端使用不同連接埠。

啟用 TUN 時顯示權限不足或建立虛擬網卡失敗,該怎麼辦?

先關閉 TUN,再到用戶端設定中確認服務模式是否已安裝並正在執行。Windows 桌面用戶端通常需要安裝輔助服務並取得管理員授權;macOS 則需依照用戶端提示核准網路相關權限;Linux 使用者應確認服務具備建立 TUN 裝置及管理路由所需的權限。別把長期以管理員身分執行整個介面當成唯一的修復方式。查看記錄中的權限或裝置錯誤後,依照該用戶端的說明修復服務;同時暫時停用其他 VPN,排除虛擬網卡及路由衝突。

macOS 顯示無法開啟應用程式時,該如何判斷?

先確認安裝套件的架構是否相符:Apple Silicon 通常選擇 ARM64,Intel 則選擇 x64,並確認下載及解壓縮過程完整。若系統提示無法驗證開發者,確認來源可信後,前往系統設定的「隱私權與安全性」,查看是否有允許開啟該應用程式的選項,再依照提示授權。應用程式已損壞和權限提示是不同類型的錯誤,不能一律用同一個命令處理。請勿為了啟動單一用戶端而關閉整體系統安全機制;若仍無法開啟,請記下系統版本和完整提示內容,再參考專案的安裝說明。

相關資料:用戶端與平台安裝說明、連接埠設定。

使用技巧

啟動、切換及覆寫設定都需要分別驗證。請以實際生效的設定及新建立的連線為準。

開機自動啟動和自動連線是同一項設定嗎?

不是。開機自動啟動只會啟動用戶端程序,是否自動啟用系統代理、TUN 及上次使用的設定,則要看用戶端各自的啟動選項。先在設定頁啟用開機啟動,再分別確認系統代理、服務模式及還原設定的選項。Windows 可在工作管理員的「啟動應用程式」中確認,macOS 則可在系統設定的「登入項目」中確認。重新啟動後,先確認核心正常運作,再檢查代理狀態;若用戶端尚未啟動,但系統仍留有代理位址,瀏覽器可能會暫時無法連線。

切換節點後,如何確認目前連線已使用新節點?

在代理頁切換目標策略組後,重新開啟測試頁面,或在連線頁中關閉該應用程式的舊連線,讓它重新建立連線。既有 TCP 連線及部分多工工作階段可能繼續使用原本的出口,因此只重新整理一次頁面不一定能完成比對。查看連線詳細資料中的規則、策略鏈及目標網域,確認流量經過預期的策略組。若設定使用 url-test 或 fallback 自動選擇群組,手動選擇可能受到群組類型限制;請先確認實際控制網站連線的群組,而不是隨意切換無關的群組。

如何讓特定網站直連,又不影響其他網站?

保留規則模式,並在用戶端的規則覆寫或本機覆寫功能中,加入針對目標網域的規則,例如 DOMAIN-SUFFIX,example.com,DIRECT,並將其放在可能提前命中的廣泛規則及 MATCH 之前。此處的 example.com 僅為語法範例,請替換成實際目標網域。網頁也可能連線至登入、圖片及 API 等其他網域,請搭配連線頁逐一判斷。建議使用可保留的覆寫設定,不要只修改訂閱產生的檔案,否則下次更新訂閱時可能會覆蓋變更。

手機或其他電腦要如何使用這台電腦的代理?

在可信任的區域網路中啟用允許區域網路連線,對應 allow-lan: true,再確認監聽位址及系統防火牆允許同一網段的裝置存取。其他裝置應填入這台電腦的區域網路 IP 和實際混合連接埠,不能填 127.0.0.1,因為每台裝置上的這個位址都指向裝置本身。建議設定 authentication 並限制可存取的來源位址,使用完後視需要關閉分享。請勿在路由器上將代理連接埠轉發至公開網際網路;手機應用程式是否使用 Wi-Fi 代理,仍取決於應用程式本身的實作。

更新訂閱會覆蓋規則修改嗎?如何保留本機設定?

直接修改遠端訂閱對應的 YAML 檔案,通常會在下次更新時被取代。需要長期保留的 rules、dns 或 tun 設定,應放入用戶端提供的覆寫、合併或指令碼功能,並確認該功能的合併順序。規則清單是追加還是取代、是否置於 MATCH 之前,各用戶端的實作可能不同。更新後請查看實際生效的設定及連線記錄,而不只是編輯器中的內容。修改前請先儲存可還原的本機副本;排查問題時可暫時停用覆寫,分辨是訂閱問題還是本機修改造成的問題。

操作說明:開機自動啟動、策略組與節點選擇。

故障排除

依序檢查基礎網路、應用程式連線方式、命中規則及代理出口。逾時、驗證失敗與 DNS 錯誤應分開處理。

Clash 無法上網,如何依序排查?

先關閉系統代理與 TUN,確認基礎網路能連線至原本可直連的網站;若仍無法連線,請先檢查 Wi-Fi、閘道器或系統殘留的代理設定。基礎網路正常後,只啟用一款用戶端,確認設定載入成功、核心正在執行,且策略組中有可用節點。接著檢查連線頁是否出現請求:沒有記錄時,排查應用程式代理及路由;有記錄時,查看命中規則以及 DNS、連線錯誤。每次只修改一項設定並重新測試,避免同時切換模式、節點及 DNS,導致無法判斷是哪項變更生效。

節點一直逾時,如何分辨是訂閱、網路還是節點問題?

先確認訂閱更新成功且帳戶可正常使用,再分別測試同一份訂閱中的不同節點。如果只有部分節點逾時,優先確認節點是否維護中或受到出口限制;如果全部失敗,請檢查系統時間、伺服器網域解析,以及目前的網路是否封鎖連線。可換用另一個可信任的網路進行比對,但別直接把逾時歸因於連接埠錯誤。記錄中的驗證失敗、憑證錯誤及連線逾時成因不同,請保留原始錯誤關鍵字。若只有延遲測試失敗、實際瀏覽卻正常,也要確認測試網址能否透過該出口連線。

已啟用系統代理,為什麼瀏覽器或命令列仍然直接連線?

先確認系統代理位址指向目前用戶端的監聽連接埠,再檢查瀏覽器設定是否被擴充功能、企業政策或獨立代理設定覆寫。命令列工具不一定會讀取系統代理,可使用 curl -I --proxy http://127.0.0.1:7890 https://example.com 進行明確的代理連線測試,並將連接埠改成實際使用的值。若明確指定代理時,連線頁看得到記錄,但一般請求沒有記錄,問題多半出在應用程式的連線方式。請依照應用程式說明設定代理環境變數,或評估使用 TUN;不要反覆切換節點,試圖修復尚未進入核心的請求。

Windows UWP 應用程式無法使用本機代理,該怎麼處理?

部分採用 AppContainer 沙箱的 Windows 應用程式會受到本機回環存取限制。如果瀏覽器能使用代理,但這些應用程式無法使用,可檢查此項設定。先確認應用程式確實有嘗試連線至本機代理,再使用用戶端提供的 UWP 回環工具,只為有需要的應用程式啟用回環豁免;若沒有這項工具,可查詢套件系列名稱,再依照 Windows 的 CheckNetIsolation 用法進行設定。操作時可能需要管理員授權。並非所有 Microsoft Store 應用程式都有相同限制,回環豁免也無法修復節點或 DNS 問題,不建議一律對所有應用程式開放。

啟用 TUN 後 DNS 異常或完全無法上網,該檢查哪些欄位?

先關閉 TUN 以恢復連線,再檢查服務權限及記錄,並確認沒有其他 VPN 同時修改路由。檢查 tun.enable、tun.auto-route、tun.auto-detect-interface 及 dns.enable,確認出口網卡辨識與 DNS 接管方式符合目前平台。使用 dns.enhanced-mode: fake-ip 時,核心必須正確關聯網域對應與後續連線;若特定應用程式有相容性問題,可依實際情況調整 fake-ip-filter。修改後重新載入設定,並清除相關應用程式的 DNS 快取。不要任意複製多組 DNS 設定混用;恢復正常後,再逐項啟用 TUN 功能。

需要比對完整設定時,請參閱進階設定手冊,不要直接用陌生設定覆蓋目前可正常使用的設定。