初次啟動清單mihomo / Clash

Clash用戶端下載初始設定指南

下載Clash 查看快速入門

依裝置選擇安裝檔，再完成訂閱匯入、規則分流與系統代理設定。需要調整核心參數時，可接著參閱進階設定手冊。

永久免費開放原始碼中文設定說明

依目前使用的裝置選擇平台

Windows Android iOS macOS Linux
設定前後對照

手動調整，常卡在哪個環節

設定檔、監聽連接埠和分流規則各自影響不同流量。先確認問題出在哪一層，再調整對應設定，比反覆切換節點更容易找出原因。

手動撰寫 YAML 容易漏掉欄位

從頭組合節點、策略組和規則時，縮排與欄位名稱都必須符合核心語法。設定載入失敗不一定是訂閱連結失效；先查看用戶端的設定錯誤提示，再檢查檔案結構。

連接埠設定與系統代理不一致

設定中填入 mixed-port，但系統代理仍指向其他連接埠時，瀏覽器可能直接連線或出現錯誤。變更監聽連接埠後，也要同步檢查作業系統的代理位址。

規則存在，流量卻沒有依預期分流

規則模式會依序比對規則，排在前面的寬泛規則可能提早攔截請求。也要確認規則指向的策略組名稱，以及用戶端目前是否使用規則模式。

用戶端初始化後，逐項確認

介面設定用來控制日常功能，設定檔則保存可重複使用的規則。兩者搭配使用：先透過用戶端建立連線，再視需要修改 YAML，不必一開始就同時調整所有選項。

從「設定」匯入訂閱

貼上服務提供者提供的訂閱網址，確認設定載入成功後，再到「代理」選擇策略組。匯入完成只代表用戶端讀取了設定，不表示系統流量已交由代理處理。

確認監聽連接埠與系統代理一致

先保留設定中的混合連接埠，再啟用用戶端的系統代理。若連接埠遭其他程式占用，變更連接埠後也要同步更新代理位址，避免用戶端和系統使用不同數值。

透過規則模式檢查流量去向

切換至規則模式，在連線記錄中查看目標網域符合哪條規則、使用哪個策略組。只有特定應用程式沒有流量時，再評估是否需要 TUN 模式。

config.yaml結構示意
mixed-port: 7890
mode: rule
proxy-groups:
  - name: 手動選擇
    type: select
    proxies:
      - DIRECT
設定項目速查

從訂閱到分流，依用途查找設定

選取左側主題查看操作方式。下方片段用於說明欄位之間的關係，實際節點與訂閱內容請以自己的設定為準。

設定 / profiles

先確認匯入的是完整設定檔

在用戶端的「設定」頁面貼上訂閱網址並匯入，等設定出現在清單中後，再將它設為目前使用的設定。完整 YAML 通常同時包含節點、策略組和規則；只有節點清單的連結，可能需要服務提供者提供適用於 Clash 的格式。更新訂閱前記下目前選用的設定，更新後確認策略組仍能正常顯示。訂閱網址屬於私人資訊，請勿貼在公開的記錄截圖或求助文章中。匯入成功後再啟用系統代理，方便分開排查設定問題與網路流量接管問題。

操作位置初次啟動
設定 → 匯入訂閱連結 → 設為目前使用的設定
代理 → 選擇策略組

需要比對參數時，請參閱進階設定手冊 →。內容分別說明規則集、策略組、DNS、TUN 與本機覆寫，不必在初次啟動時一次設定完成。

安裝入口

依裝置選擇用戶端

先選擇作業系統，再到下載頁比較同平台的用戶端。安裝檔類型、處理器架構與授權方式應以目標裝置為準；只需要核心的伺服器或路由器使用者，可在下載頁查看 mihomo 區域。

查看所有用戶端 →

Windows

先確認裝置架構與系統需求，再從用戶端卡片選擇安裝檔。安裝後到「設定」匯入訂閱，並確認系統代理已啟用；部分應用程式仍直接連線時，可先確認它是否遵循系統代理設定。

前往下載 Windows 版 →

macOS

Apple Silicon 與 Intel 裝置請選擇對應的安裝檔。首次開啟用戶端時，依系統提示完成授權；若選單列顯示已連線，但瀏覽器沒有透過代理連線，請返回用戶端確認目前使用的設定與系統代理狀態。

前往下載 macOS 版 →

Android

匯入設定後，依系統提示授予 VpnService 權限，用戶端才能建立本機 VPN 介面。若鎖定螢幕後經常斷線，請檢查電池最佳化、自動啟動與背景執行權限，而非反覆刪除訂閱。

前往下載 Android 版 →

iOS

從下載頁前往 Clash Plus 的 App Store 頁面。安裝後依應用程式指引匯入設定，首次連線時確認已授予系統 VPN 權限；需要切換規則或策略組時，請回到用戶端介面操作。

前往下載 iOS 版 →

Linux

桌面使用者可比較圖形用戶端的發行套件格式；伺服器與路由器使用者則可查看獨立核心。安裝前確認發行版、處理器架構與執行方式，並為設定檔預留可讀寫的路徑。

前往下載 Linux 版 →

同一份訂閱不一定適用於所有用戶端：先確認服務提供者提供的設定格式，再查看目標用戶端是否支援其中的協定與規則語法。切換裝置時，也要重新檢查該裝置的網路授權與系統代理設定。

開源生態系與設定依據

了解用戶端、核心與設定之間的關係

Clash 是一種以規則為基礎的代理工具生態系名稱。圖形用戶端提供匯入、切換與查看連線的操作介面；核心則負責解析設定、建立連線及執行規則。選擇安裝檔時，先確認作業系統，再核對核心支援的設定語法。

專案演進

原版 Clash、Clash Meta 與後續的 mihomo 處於不同的維護階段。介面名稱相似，不代表使用相同核心；部分新協定、新規則類型與 DNS 參數僅適用於特定核心。遇到設定載入錯誤時，應先查看用戶端標示的核心，再核對訂閱使用的語法，不要只根據應用程式名稱判斷相容性。

程式碼與授權

mihomo 是開放原始碼核心，提供公開的原始碼與授權資訊。GPL-3.0 說明軟體的使用、修改與再散布條件，不代表節點服務的承諾。選擇 GUI 用戶端時，也應另外查看用戶端專案本身的說明；核心採用開放原始碼，與特定圖形用戶端的維護狀態是兩回事。

設定的責任範圍

用戶端負責讀取設定並顯示狀態，訂閱內容通常由使用者所選的服務提供者維護。訂閱可以匯入但節點無法使用時，可先查看設定更新時間、策略組選項與連線記錄；若用戶端安裝失敗，則應檢查套件格式與系統需求。將這兩類問題分開，排查方向會更清楚。

更新時如何檢查

更新用戶端前，記下目前使用的設定與重要的本機覆寫。更新完成後，先確認核心已啟動，再檢查訂閱、策略組、規則模式與系統代理。若更換核心或距離上次維護已久，請特別檢查舊設定中的規則提供者、DNS 與 TUN 欄位，不要假設現有設定永遠相容。

查看 mihomo 原始碼git clone https://github.com/MetaCubeX/mihomo.git

複製指令僅供在本機查看公開原始碼，並非安裝圖形用戶端的必要步驟。一般使用者可直接前往安裝檔頁面，選擇適合裝置的用戶端；需要調整規則或 DNS 時，再依進階設定手冊逐項處理。

初次啟動常見問題

連線前先檢查這幾項

依序檢查設定載入、流量接管與規則比對。每次只調整一項設定，方便確認是哪項變更影響了連線。

查看完整教學 →
訂閱匯入成功，為什麼瀏覽器還是直接連線？

匯入只代表設定已載入。先確認該設定已設為目前使用的設定，再選擇規則模式與策略組，並啟用系統代理。接著查看連線記錄中是否出現瀏覽器請求；若沒有，優先檢查系統代理開關與連接埠。依照教學逐步檢查 →

規則模式和全域模式，應該先選哪一種？

日常使用建議先選規則模式，讓設定中的規則決定請求去向。全域模式可用於暫時比對並排查問題：若全域模式可用，但規則模式不如預期，再檢查規則順序與策略組名稱。測試後記得切回需要的模式。查看模式切換步驟 →

修改 mixed-port 後，為什麼程式無法連線？

確認新連接埠未被其他程式占用，並檢查作業系統或應用程式中的代理位址是否仍指向舊連接埠。修改設定檔後，也要讓用戶端重新載入；若只修改 YAML 而未更新系統代理，兩處設定就會不一致。返回連線檢查步驟 →

什麼時候需要啟用 TUN 模式？

先使用系統代理建立基本連線。只有目標應用程式不遵循系統代理，且確實需要接管更多流量時，再依用戶端提示申請 TUN 所需的系統授權。啟用後若影響區域網路存取，請分別檢查路由與 DNS 設定。閱讀 TUN 設定說明 →

使用心得

繼續閱讀相關問題

以下文章依發布日期排列，分別介紹訂閱格式、Android 背景連線與核心選擇，協助處理初次設定後常見的後續問題。

查看所有文章 →