規則分流
在 mode: rule 模式下,核心會依序檢查 rules,符合條件後便採用該規則指定的目標。網域後綴規則適合設定特定網站的例外;地理位置規則則依目標 IP 位址與本機資料庫判斷,並非按照網域後綴分類。請將具體條件放在寬泛條件之前,並將 MATCH 放在最後。相較於只能切換全域出口的介面,規則清單能說明不同連線為何採用不同路徑。範例中的拒絕兜底僅用來展示語法,不適合直接用於日常設定。
先選擇作業系統,再確認處理器架構與安裝格式。下載頁依平台整理客戶端和系統需求;名稱相同的應用程式在不同系統上,使用的核心可能不同,支援的覆寫方式也不一定相同。
在系統設定的「關於」頁面確認系統類型。使用桌面客戶端連線前,先檢查是否有其他代理工具仍占用系統代理或本機監聽連接埠。
前往下載 →根據「關於這台 Mac」顯示的晶片或處理器,確認是 Apple Silicon 還是 Intel;若要接管網路,請依所選客戶端的提示授予權限。
前往下載 →依裝置支援的應用程式架構選擇安裝檔。首次連線時留意系統的 VPN 授權提示,並確認沒有其他工具正在使用相同的連線入口。
前往下載 →透過下載頁前往 App Store。安裝後先確認客戶端支援的匯入方式,再新增設定並依提示授權建立連線。
前往下載 →依發行版、套件管理工具與處理器架構篩選。桌面環境可優先選擇圖形介面客戶端;需要自行管理處理程序時,再查看核心套件。
前往下載 →從規則入口到核心記錄,依欄位查看連線如何接入、比對與連出。
在 mode: rule 模式下,核心會依序檢查 rules,符合條件後便採用該規則指定的目標。網域後綴規則適合設定特定網站的例外;地理位置規則則依目標 IP 位址與本機資料庫判斷,並非按照網域後綴分類。請將具體條件放在寬泛條件之前,並將 MATCH 放在最後。相較於只能切換全域出口的介面,規則清單能說明不同連線為何採用不同路徑。範例中的拒絕兜底僅用來展示語法,不適合直接用於日常設定。
select 由使用者選擇群組內的出口,適合需要清楚掌握目前連線路徑的情境。url-test 依測試結果選擇出口;測試結果只反映特定網址和時間的狀況,不代表下載速度。fallback 著重候選路徑是否可用,通常會依序採用第一個可用項目。如果客戶端只顯示群組名稱,可回頭查看原始設定中的 type。替換設定前也請確認群組名稱,指向舊群組名稱的規則不會自動更新。
dns.enable 用來控制內建解析模組;enhanced-mode: fake-ip 則允許核心為符合條件的網域回傳對應位址,並在連線時關聯原始網域。依賴真實位址的服務可能需要透過 fake-ip-filter 排除。相較於只顯示上游伺服器位址的介面,這些欄位也會決定核心回傳的內容。系統解析器、瀏覽器的安全 DNS 與核心不一定使用相同路徑;檢查 DNS 洩漏時,請先確認查詢實際由哪一層送出。
tun.enable 控制核心是否啟用 TUN。一般系統代理仰賴應用程式讀取代理設定;TUN 則透過虛擬網卡和路由接管連線,可涵蓋部分不讀取系統代理設定的應用程式,但仍受平台權限與路由設定限制。建議先確認基本連線正常,再單獨啟用 TUN 比較狀況,避免同時變更 DNS 與網路堆疊。若啟用後無法使用區域網路服務,請優先檢查既有 VPN、路由排除項目和介面狀態;切回原本的連線方式,有助判斷問題出在接管還是出口。
訂閱原始內容會隨更新而變動,局部修改較適合放在客戶端支援的覆寫層。直接編輯訂閱與使用獨立覆寫的差異,在下次更新時最明顯:前者可能被取代,後者仍須依合併邏輯執行。新增規則時,請確認要插入前方、附加在後,還是整段取代。prepend-rules 是部分客戶端使用的覆寫寫法,並非通用核心欄位。儲存後請開啟最終設定,確認規則順序、引用的群組名稱,以及原本可用的項目是否仍存在。
log-level: info 可作為排查起點,介面可能會將此等級顯示為 INFO。遇到 WARNING 時,先查看同一時間的前後記錄,再單獨重現一次請求。無法監聽連接埠與請求逾時發生在不同階段,不能用同一個原因解釋。相較於只有狀態圖示的畫面,記錄更容易協助定位錯誤是在載入設定、接入、解析或連出時發生。暫時提高記錄詳細程度後,請恢復原設定;分享記錄片段前,先移除訂閱網址與私人網路資訊。
遇到名稱相似的應用程式時,先釐清專案沿革、核心來源與客戶端維護狀況,再決定是否遷移設定。
git clone https://github.com/MetaCubeX/mihomo.git
Clash 最初指的是使用規則設定的代理核心,後來也成為一系列桌面與行動工具的通稱。Mihomo 延續 Clash Meta 的開發路線,因此舊教學中的 Meta 可能指的是現在的 Mihomo 專案。查閱較早期的資料時,先確認內容談的是原始核心、後續分支,還是特定介面的操作方式。按鈕名稱或設定畫面改變,不代表 YAML 語法也同步變更;反過來說,介面相似也不代表舊設定中的擴充欄位仍然適用。
Mihomo 以 GPL-3.0 授權發布原始碼。儲存庫可用來查看程式碼、問題討論與發布說明;桌面或行動客戶端則由各自的專案維護,使用相同核心不代表採用相同的授權或發行方式。查閱社群問題時,優先比對作業系統、連線方式與實際錯誤訊息;症狀相同,處理方式也未必適用。上方的複製指令用於取得核心原始碼,以供閱讀或開發,不能取代圖形介面客戶端的安裝步驟,也不會匯入訂閱。
圖形介面客戶端通常負責下載訂閱、切換設定、開關系統代理與顯示記錄。核心則負責解析有效設定,執行監聽、DNS、規則比對與連出等邏輯。設定能否生效,取決於客戶端是否將內容寫入最終檔案、核心是否讀取該欄位,以及作業系統是否允許相關網路操作。遷移時,可先在新客戶端匯入原始設定並確認連線正常,再逐項還原本機覆寫。客戶端選型可參考橫向評測,不必只看介面外觀。
應用程式更新可能變更設定儲存位置或介面入口;核心更新可能改變支援欄位與網路行為;訂閱更新則會替換服務提供者下發的代理、策略群組或規則。這三種更新應分開進行。更新前,先儲存可重新匯入的設定與本機覆寫,並記下目前的連線方式。更新後先確認選取的作用中設定是否正確,再檢查本機連接埠是否正在監聽,以及常用網站符合哪條規則。若狀況有變,只回復剛才變更的那一層,避免覆蓋仍可用來定位問題的設定。
不一定。mixed-port 只會指定核心接收代理請求的連接埠;系統或應用程式仍須指向實際的監聽位址與連接埠。有些應用程式有獨立的網路設定,即使系統代理已啟用,也可能依照自己的設定連線。可先查看連接埠欄位,再確認客戶端的連線畫面是否顯示剛送出的請求。
訂閱更新可能會變更群組名稱、項目名稱或成員順序。若介面記錄的選擇指向已刪除的成員,客戶端可能會改用目前群組中可用的項目。請先確認正在使用的設定,再比對更新前後的策略群組與覆寫引用;遇到群組類型等不熟悉的名詞,可先查閱術語表。
基礎欄位通常較容易移轉,但虛擬網卡、網路介面名稱、本機檔案位置與客戶端覆寫指令碼,往往與裝置環境有關。先確認目標客戶端支援的匯入格式,再移轉與裝置無關的規則和策略。確認設定無誤後,才在目標裝置重新設定系統代理與連線權限,避免直接沿用舊裝置的路徑。
依問題查找客戶端選型、連線故障與行動裝置首次匯入指南。
從支援平台、核心版本、介面操作、TUN 與覆寫功能等面向比較常見的 Clash 客戶端,並依新手、多裝置與進階使用者提供選擇建議。
依序檢查訂閱更新、系統時間、連接埠占用、系統代理、DNS 與防火牆,排查節點逾時;每個步驟都說明如何判斷狀況及採取相應的修復方式。
確認 App Store 的下載條件與客戶端支援的匯入方式,透過連結、檔案或掃描 QR Code 新增設定,再檢查授權提示與首次連線狀態。