Windows
請在系統的裝置規格中確認處理器架構。常見的 Intel 與 AMD 電腦使用 x64 套件;搭載 ARM 處理器的裝置,則須確認用戶端是否提供相應版本。安裝後先匯入設定,再啟用系統代理。測試正常但只有部分應用程式未走代理時,請檢查該應用程式是否沿用系統設定,先別急著更換訂閱。
前往下載01 Downloads
先確認作業系統,再選擇安裝套件架構。桌面版還要區分圖形介面用戶端與獨立核心;初次使用從圖形介面用戶端開始即可。
請在系統的裝置規格中確認處理器架構。常見的 Intel 與 AMD 電腦使用 x64 套件;搭載 ARM 處理器的裝置,則須確認用戶端是否提供相應版本。安裝後先匯入設定,再啟用系統代理。測試正常但只有部分應用程式未走代理時,請檢查該應用程式是否沿用系統設定,先別急著更換訂閱。
前往下載在「關於這台 Mac」查看晶片或處理器,再選擇對應的 Apple Silicon 或 Intel 套件。選單列狀態只能表示用戶端是否正在執行,無法確認每個應用程式的連線都已接管。切換設定後,請從連線記錄確認目前的請求;完成測試準備離開時,也要確認系統代理設定已還原。
前往下載依裝置支援的應用程式架構選擇安裝套件,不要只憑處理器是否為 64 位元判斷。初次啟動通常需要確認系統的 VPN 連線要求。切到背景後若連線中斷,先查看用戶端執行狀態與系統電池管理;若裝置已設定工作資料或其他 VPN,也要確認目前由哪個應用程式管理連線。
前往下載從下載頁前往 App Store 查看相容用戶端與系統需求。匯入設定後,依系統提示允許新增 VPN 設定,再回到用戶端確認目前選取的設定。桌面版儲存的 YAML 可作為移轉起點,但本機檔案路徑、代理模式名稱與進階欄位不一定能直接沿用。
前往下載桌面用戶端請依發行版支援的套件格式與處理器架構選擇。安裝前先確認系統套件管理工具使用的格式,不要把相同架構的不同格式當成可互換。終端機命令與桌面應用程式的代理設定可能各自獨立;若請求只從終端機送出,請優先檢查該程式實際讀取的代理設定。
前往下載02 Config Reference
先分清輸入、輸出與比對條件。點選欄位查看對照範例;這些片段用來說明單一層級的設定,不是包含訂閱與節點的完整檔案。
混合連接埠可同時接收本機應用程式傳來的 HTTP 與 SOCKS 代理連線。這是應用程式連接核心的連接埠,不是遠端節點使用的連接埠。若只在目前裝置使用,可先關閉區域網路存取,再確認應用程式填寫的位址與連接埠。遇到連接埠已被占用時,先找出占用的程序,再同步修改核心與應用程式的設定。若只改其中一處,請求可能根本沒有進入核心,連線記錄也就看不到規則命中。
先確認請求是否進入核心的 DNS 模組,再判斷解析模式是否合適。fake-ip 可先回傳映射位址,讓核心在後續連線中識別網域;這不代表系統的所有 DNS 查詢都會自動交由核心處理。排查時請區分瀏覽器的安全 DNS、系統解析與核心解析。只有特定網域與映射位址不相容時,再檢查該網域的過濾項目,避免為單一服務更動整套解析設定。
mixed-port: 7890
allow-lan: false
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
規則模式會由上而下比對,請求命中第一條有效規則後,便依該規則指定的輸出方式處理。網域後綴規則適用於相同後綴的一組網域;地區規則則需要相應的地理資料。請將特定例外放在涵蓋範圍較廣的規則之前,並將無條件的 MATCH 放在最後。流量走錯時,先從連線記錄查看實際命中的規則,再確認規則目標與目前策略;即使規則正確,群組中選錯輸出方式也會造成不同結果。
url-test 會依測試網址的連線狀況與延遲選擇候選輸出方式,也可設定容差以減少頻繁切換。測試結果只反映該測試路徑,不代表所有服務都經過相同的網路路徑。fallback 適合依既定優先順序選擇可用項目;load-balance 則著重連線分配。範例中的兩個節點名稱必須已在同一份設定中定義,測試網址也應換成經過驗證且適合該網路的網址。
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- GEOIP,LAN,DIRECT,no-resolve
- MATCH,DIRECT
proxy-groups:
- name: 自動測速
type: url-test
proxies: [節點甲, 節點乙]
url: https://example.com/
interval: 300
tolerance: 50
proxies 用來描述核心如何連線到遠端節點;節點的 type 則決定其他欄位的解讀方式。以下以 SOCKS5 為例,位址取自文件保留網段,無法作為可用節點。請勿將遠端 port 填入系統的本機代理連接埠,也不要把某種協定的傳輸選項直接套用到另一種協定。匯入時若出現未知欄位,請確認正在執行的核心與節點協定,不要只看用戶端名稱。
先透過一般記錄查看啟動、載入設定與連線處理狀況,再視需要短暫啟用除錯記錄。編輯並儲存不代表核心已重新載入,用戶端也可能透過覆寫層變更記錄層級。重現問題前先記下目前的設定名稱,接著用同一個應用程式送出一次請求,對照連線記錄與實際時間。提供他人協助排查前,請移除訂閱網址、節點憑證與不宜公開的網域;確認問題後,記得還原原有層級。
proxies:
- name: 文件範例
type: socks5
server: 192.0.2.10
port: 1080
log-level: info
閱讀設定的順序:先找 mixed-port、mode 等頂層欄位,再查看 proxies 定義了哪些輸出方式,最後檢查 proxy-groups 與 rules 如何引用這些名稱。策略群組名稱也是引用關係的一部分。更改名稱時,群組內的巢狀引用與規則末尾的目標都要一併修改,否則即使 YAML 能解析,核心仍可能拒絕載入。
修改的位置:訂閱來源、本機覆寫與用戶端產生的最終設定並非同一個檔案。更新後修改內容消失,應先確認編輯的是哪一層。需要長期保留的局部修改,請放在用戶端支援的覆寫層,並確認清單採用追加還是取代。特別是 rules:取代整個區段可能刪除原有例外,追加在 MATCH 之後則可能永遠不會命中。完整語法請見設定欄位參考。
03 Quick Start
初次使用只需完成三件事:匯入並選取設定、開啟流量入口、送出一次請求驗證。先確認基本流程正常,再調整 DNS 或規則。
開啟用戶端的設定頁,依現有資料選擇訂閱連結或本機 YAML。更新成功後選取這份設定,再前往代理頁確認策略群組可以展開。只看到檔名,代表設定項目已儲存;能看到群組與成員,才更能確認設定已載入。若匯入失敗,先查看錯誤所在行、欄位名稱或下載提示,不必反覆新增相同訂閱。
config.yaml · 匯入設定
若要依網域或位址分流,先選擇規則模式,再於策略群組確認目前的輸出方式。桌面版依用戶端說明啟用系統代理;行動裝置則依提示建立 VPN 連線。不要同時更改接入方式與策略群組,否則結果改變時難以判斷是哪一層造成。若已有其他代理正在執行,請先確認這次要使用哪個入口。
mode: rule · 系統代理
用常用應用程式重新開啟一個頁面,並在連線記錄中尋找相應網域、命中規則與輸出方式。沒有記錄時,檢查應用程式是否使用目前的入口;有記錄但請求失敗,則查看 DNS、策略與節點狀態。頁面快取與既有連線可能影響判斷,可以重新送出請求。確認測試成功後,再逐一還原自訂設定。
請求目標 → 命中規則 → 實際輸出
更多安裝與連線問題,請見 Clash 常見問題。
04 Project Sources
原始碼、用戶端與訂閱分別由不同專案或服務提供。遇到問題時先確認所屬項目,再查看相應的文件、發布說明或問題紀錄。
Clash 生態系的設定檔沿用一些共同概念,例如宣告節點、組成策略群組,以及依規則選擇輸出方式。mihomo 延續 Clash.Meta 的開發脈絡,並在此架構上加入新功能。舊教學中的通用寫法仍可作為閱讀起點,但遇到特定協定、DNS 欄位或規則類型時,應以目前執行的核心為準。即使介面名稱相同,也不能因此認定不同用戶端對同一欄位的解讀一致。移轉舊檔案時,可先測試最精簡的設定,再逐段恢復進階選項。
mihomo 的原始碼儲存庫公開,採用 GPL-3.0 授權。討論欄位意義與實作行為時,可先查閱該儲存庫的相關程式碼、變更紀錄與已知問題。若問題涉及系統匣入口、訂閱更新按鈕或裝置權限,通常應查詢對應用戶端,而非前往核心儲存庫尋找介面實作。授權與原始碼紀錄說明的是各專案自身的發布與授權,不代表訂閱服務的說明,也不能據此推定其他用戶端或規則資料的授權。
用戶端負責下載並整理設定,核心讀取最終設定後處理實際連線。訂閱下載失敗發生在取得階段,欄位不受支援發生在載入階段,而規則命中卻無法連線則屬於執行階段。排查時先判斷問題停在哪個階段,再決定查看訂閱回應、載入錯誤或連線記錄。分享重現步驟時,可保留欄位結構與錯誤類型,並以文件位址取代真實節點位址;如此既能說明問題,也不必公開可用來存取訂閱的連結。
升級用戶端可能改變介面與隨附核心;重新整理訂閱通常只會重新取得設定;更新地理資料庫或規則集則是另一種流程。排查變更時,記下最近執行的是哪一種更新,並保留更新前可用的本機設定。若問題只在更新訂閱後出現,請比較最終規則順序或節點欄位;若地區比對結果改變,則確認目前的資料來源、更新時間與載入狀態。盡量一次只變更一種類型,再用同一個應用程式重試相同目標。
05 Field Notes
設定參考可依欄位查閱,使用指南則依任務查找。以下文章分別介紹跨裝置同步、行動裝置匯入與用戶端介面。
比較電腦與手機同步 Clash 設定的幾種方式,包括直接使用訂閱連結、覆寫檔案、WebDAV 備份與私人 Git 儲存庫,並整理各方式的維護成本與注意事項。
說明如何在 iOS 上從 App Store 取得支援 Clash 設定的用戶端、匯入訂閱連結或 YAML 檔案,並啟用 VPN 描述檔完成首次連線。
依介面順序說明代理頁的群組與測速、設定頁的訂閱與切換,以及記錄頁的層級篩選,協助新手快速了解各按鈕與狀態標示的用途。