Windows
適合讓瀏覽器與桌面工具共用代理。下載頁依序列出 Clash Plus、Clash Verge Rev 等選項;首次啟動時,請先確認設定已啟用,再開啟系統代理。
若程式提示連接埠已被占用,請先退出其他代理工具。不要一開始就同時啟用多個用戶端和 TUN,否則很難判斷是哪個工具接管了請求。
前往下載功能與設定
瀏覽器、開發工具與本機服務不一定需要使用相同出口。規則模式會讀取設定中的 rules,由第一條開始往下比對,符合條件後便套用對應策略。在用戶端的「代理」頁面選擇規則模式,再到「規則」頁面確認比對順序。相較於全域模式,規則模式可讓區域網路與指定網站維持直連,但實際結果取決於規則內容。下方的 Proxy 必須對應既有策略組,兜底規則 MATCH 則應放在最後,避免前面的細項條件失效。
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,Proxy
- GEOIP,CN,DIRECT
- MATCH,Proxy訂閱會將遠端設定載入本機,省去逐項輸入代理參數。在「設定」頁面選擇「從 URL 匯入」,貼上服務提供者給的設定網址;匯入成功後,還要選取並啟用該設定。相較於直接編輯單一 YAML 檔案,訂閱更適合持續更新,但遠端內容可能覆蓋本機修改。若要保留自訂規則,建議優先使用用戶端的覆寫或合併功能。下方僅示範遠端代理集合的設定結構,範例網址無法用於實際連線,也不是完整的訂閱檔案。
proxy-providers:
remote:
type: http
url: "https://example.com/proxies.yaml"
path: ./providers/remote.yaml
interval: 3600「規則」、「全域」與「直連」決定已進入核心的請求如何處理,並不會決定哪些應用程式會進入核心。日常使用通常選擇規則模式;若要暫時確認規則是否誤判,可切換至全域模式,再檢查全域策略組的選項;需要直接連線時則切換至直連。全域模式不等於接管所有應用程式,未遵循系統代理設定的程式仍可能繞過用戶端。相較於反覆修改規則檔案,切換模式更方便對照測試;測試完成後請恢復原設定,避免影響本機網路資源。
# rule / global / direct
mode: rule部分遊戲、命令列工具或背景服務不會讀取系統代理,TUN 可透過虛擬網路介面接管更多連線。在桌面用戶端的「設定」中安裝所需服務,再啟用「TUN 模式」,所需權限請依用戶端提示操作。相較於系統代理,TUN 更接近在網路層接管連線,也更容易與其他 VPN、虛擬網卡或企業路由設定衝突。首次啟用前,請先確認一般代理可正常使用,再檢查路由與 DNS。下方是 mihomo 設定片段,不適用於所有行動裝置介面,也不應整段覆蓋現有設定。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53網頁無法開啟時,先在「連線」頁面確認是否出現目標請求,再到「日誌」頁面查看同一時間的錯誤訊息。連線詳細資訊通常會顯示命中的規則與策略鏈;日誌則有助於分辨網域解析、建立連線或載入設定時發生的問題。相較於只看測速結果,失敗請求的完整脈絡更有參考價值。日常使用時維持 info,需要重現問題時再短暫切換至 debug,完成後記得恢復。分享日誌前,請刪除訂閱網址、驗證資訊與個人瀏覽紀錄;不能只遮住代理名稱,就直接公開整段輸出。
# 暫時排查問題時可改為 debug
log-level: info桌面、手機與路由器可採用相近的規則結構,但用戶端按鈕、核心功能與系統權限各有不同。先到下載頁依裝置選擇用戶端,再確認設定檔支援範圍;不要因為檔案可以匯入,就認定所有欄位都會生效。相較於直接執行核心,圖形化用戶端可集中管理設定與開關,更適合日常使用。跨裝置移轉時,請檢查本機檔案路徑、監聽連接埠與 TUN 參數。下方將控制介面限制為僅供本機存取,並預設關閉區域網路存取,避免將桌面環境的設定原封不動帶到其他網路。
mixed-port: 7890
allow-lan: false
external-controller: 127.0.0.1:9090Clash 是一系列規則代理工具的生態名稱,並非在所有系統上都有完全相同介面的單一軟體。下載前請先確認裝置的作業系統,再分清圖形化用戶端與核心:前者提供設定頁、代理頁與系統開關;後者主要負責讀取設定並處理連線。第一次使用選擇圖形化用戶端即可,不必先學習服務管理或命令列啟動參數。
安裝檔名稱中的處理器架構標示也必須符合裝置。作業系統相同,不代表安裝檔就能通用,桌面裝置的不同架構尤其如此。更新前請先退出正在執行的用戶端,並保留原有設定與必要選項;若要改用其他用戶端,建議重新匯入訂閱,不要直接複製整個程式資料目錄。
適合讓瀏覽器與桌面工具共用代理。下載頁依序列出 Clash Plus、Clash Verge Rev 等選項;首次啟動時,請先確認設定已啟用,再開啟系統代理。
若程式提示連接埠已被占用,請先退出其他代理工具。不要一開始就同時啟用多個用戶端和 TUN,否則很難判斷是哪個工具接管了請求。
前往下載先在「關於這台 Mac」確認使用的是 Apple Silicon 或 Intel,再選擇相符的安裝檔。Clash Plus、Clash Verge Rev 與 FlClash 等用戶端的下載入口都集中在下載頁。
安裝後請依系統提示授予必要權限。若出現網路延伸功能或鑰匙圈提示,請先確認應用程式來源與操作情境,不要為了略過提示而一次關閉多項系統防護。
前往下載Clash Plus、Clash Meta for Android、FlClash 與 Surfboard 各有不同介面與設定檔支援範圍。請先確認訂閱格式,再選擇用戶端;不要假設同一個連結在各處都能使用。
首次連線時需要允許系統的 VPN 連線要求。若螢幕鎖定後連線中斷,請檢查背景執行權限與電池用量限制;分應用程式代理設定也會影響哪些程式會進入代理通道。
前往下載下載頁提供 Clash Plus 的 App Store 下載入口,官方網站為 clashplus.io。安裝後匯入設定,再依提示允許新增 VPN 設定。
連線開關亮起只代表通道已建立,還需要開啟目標網站確認實際連線結果。切換 Wi-Fi 或行動網路後若出現異常,請先重新連線並查看日誌。
前往下載桌面使用者可從 Clash Verge Rev、FlClash 開始;伺服器與路由器使用者則可考慮直接執行 mihomo。軟體套件格式須符合發行版所使用的套件管理方式。
圖形介面的系統代理通常只會影響遵循桌面代理設定的應用程式。終端機工具可能還需要另外設定代理環境變數,不能只靠瀏覽器能否開啟網頁來判斷。
前往下載第一次設定只需完成必要操作:匯入訂閱、選取目前使用的設定、選擇規則模式,並啟用適合目前系統的連線方式。接著開啟一個明確的目標網站,並在連線頁面確認命中的策略。先驗證這條連線路徑,再嘗試 TUN、開機自動啟動與區域網路分享,可減少多個變數同時改變造成的誤判。
Clash 節點測速只能反映特定測試目標當下的連線狀況,不代表所有網站的實際使用體驗。若測速正常但實際請求失敗,請繼續檢查目標網域、命中的規則與完整日誌;若只有特定應用程式失敗,請先確認該程式是否會讀取系統代理。連線問題可從問題診斷開始排查,不必反覆解除安裝來試錯。
系統代理會將代理位址提供給願意遵循設定的應用程式;全域模式決定核心收到請求後要選擇哪個出口;TUN 則會改變更多請求進入核心的路徑。三者處理的是不同環節,不能互相取代。想了解模式差異,請先參閱模式選擇;需要為單一工具填入代理位址時,再查看連接埠設定。
Clash 生態系歷經原始專案、後續核心與不同圖形化用戶端並行發展。現在搜尋到的教學可能對應不同時期的介面,也可能使用相同的按鈕名稱,卻依賴不同核心。本網站將下載入口、入門步驟與故障排查分開整理:下載頁協助選擇裝置與用戶端,教學頁說明初次設定,問題診斷頁則協助排查既有設定未如預期運作的原因。
舊版截圖有助於理解概念,但不應作為確認目前按鈕位置或欄位支援範圍的唯一依據。遇到設定錯誤時,請先確認正在執行的核心與用戶端,再檢查該欄位是否受到支援。尤其不要為了照著舊教學操作,就改回已停止維護的程式;若確實需要使用封存的用戶端,請先了解其相容性與維護狀態。
mihomo 是 Clash 生態系中持續發展的核心專案之一,負責規則比對、代理連線與相關網路處理;圖形化用戶端則在其上提供訂閱管理、策略組選擇、日誌檢視與系統整合功能。用戶端更新與核心更新並非同一件事:介面變更不一定會改變規則語法,核心功能更新也不一定會立即出現在介面中。實際支援情況請查閱對應專案的發布說明與文件。
因此,設定範例需要註明適用環境。在桌面版 mihomo 上可用的片段,不代表能直接匯入所有手機應用程式。更換用戶端前,請先保留訂閱來源、覆寫規則與必要的本機參數,再逐項移轉。只複製自己看得懂的設定區段,比直接用整份舊檔案覆蓋新環境更容易排查問題。
公開原始碼可用來了解設定欄位、查閱問題討論或參與開發。下方命令會從 mihomo 專案儲存庫取得原始碼,裝置必須已安裝 Git,且能連線至該儲存庫。這不是安裝用戶端的命令,也不會自動產生可直接使用的圖形化程式。一般使用者只要前往下載頁選擇安裝檔即可;只有準備閱讀原始碼或依專案文件進行建置時,才需要執行複製儲存庫的操作。
git clone https://github.com/MetaCubeX/mihomo.git
用戶端、核心與訂閱各自有不同的更新來源。更新用戶端主要會改變程式與整合功能;更新訂閱則可能變更代理集合、策略組或規則內容。遇到「昨天還能用,今天卻失敗」時,請先回想最近更新了哪一項,再查看相關日誌。保留一份可還原的設定副本,並記錄本機覆寫內容,才能在恢復連線時避免一併遺失自訂規則。
更新後至少要重新檢查目前使用的設定是否仍已選取、規則模式是否符合預期、策略組是否仍有可用選項,以及本機連接埠是否改變。設定頁顯示更新成功,只能代表取得與解析流程正常,不能取代實際目標請求的驗證。若涉及規則資料庫,可繼續閱讀GeoIP 相關問題;若遇到連線逾時,請前往逾時排查依序檢查。
策略組不是代理協定。策略組會將多個候選出口組合成選擇、測速或故障轉移機制;組內的實際代理才各自具有協定參數。手動切換組內選項,可能會改變後續連線的出口,但已建立的長連線不一定會立即重新連線。若看不懂群組名稱與巢狀關係,請先查閱Clash 策略組,不要任意刪除規則引用中的群組。
更新訂閱不代表規則一定會更新。有些訂閱只提供代理集合,有些提供完整設定,另一些規則則來自獨立的規則集合。更新按鈕會更新哪些內容,取決於用戶端與設定檔結構。若更換代理後特定網站仍走直連,請檢查命中的規則,不要連續重新整理訂閱。設定層級說明可在名詞解釋中依分類查閱。
開機啟動不等於自動連線。啟動程式、還原上次使用的設定與啟用系統代理可能是不同選項,系統權限也會影響還原結果。若希望開機後即可使用,請先手動確認完整連線流程正常,再設定自動啟動並重新開機測試。若只看到介面,但網路流量沒有經過用戶端,可前往開機自動啟動問題確認設定,不要誤以為是訂閱失效。
近期使用指南
先完成基本連線,再依目前遇到的問題閱讀相關文章。設定結構、訂閱格式與系統權限會影響不同環節,不必一次修改所有設定。
依照設定檔的書寫順序,逐段說明各欄位的用途與常見寫法,協助看懂並安全修改自己的 config.yaml。
閱讀文章從複製訂閱網址到更新生效的完整步驟,並比較幾種常見訂閱格式,說明匯入失敗時應先檢查哪些項目。
閱讀文章整理 macOS 首次執行時的「已損壞」提示、允許網路延伸功能的步驟,以及鑰匙圈提示反覆出現的原因與處理方式。
閱讀文章