Windows
適用於桌面瀏覽器與日常應用。先在系統資訊中確認處理器類型,安裝後匯入設定,再開啟系統代理。若要接管不使用系統代理的應用,再依教學設定 TUN;首次連線前,避免同時變更多項網路設定。
前往下載先確認作業系統,再確認處理器架構。下載頁整理了客戶端選擇、安裝方式與系統需求;點選這裡的入口即可前往對應平台,不必再尋找分類。
適用於桌面瀏覽器與日常應用。先在系統資訊中確認處理器類型,安裝後匯入設定,再開啟系統代理。若要接管不使用系統代理的應用,再依教學設定 TUN;首次連線前,避免同時變更多項網路設定。
前往下載依 Apple Silicon 或 Intel 挑選安裝檔。在系統的「關於這台 Mac」查看晶片資訊,安裝後依提示授權網路功能。更換客戶端前,先關閉舊客戶端的系統代理,避免背景程序繼續占用連接埠或變更網路設定。
前往下載適用於手機與平板。依裝置架構挑選安裝檔,匯入訂閱後允許建立 VPN 連線。系統通常只允許一個應用程式使用 VPN 通道;若連線無法啟動,先檢查其他 VPN 應用程式。若背景連線容易中斷,再檢查電池最佳化與背景執行權限。
前往下載適用於 iPhone 與 iPad。下載頁提供 Clash Plus 的 App Store 連結,官方網站為 clashplus.io。安裝後匯入設定並完成 VPN 授權,再返回客戶端啟動連線。使用前請確認訂閱格式符合客戶端支援範圍。
前往下載桌面使用者可選擇圖形介面客戶端,並依發行版的套件管理方式安裝。伺服器與路由器使用者可在下載頁查看核心版本,但須自行管理設定、服務權限與路由。圖形介面成功啟動不代表網路流量已交由其處理,仍須確認代理入口與規則命中情況。
前往下載從規則分流到網路接管,五項設定各自解決不同問題。先了解每一層的用途,再決定是否啟用。以下為 mihomo 設定範例;客戶端中的入口名稱與可用選項可能不同,片段不能直接當成完整設定匯入。
規則模式會依設定中的順序檢查連線,符合規則後交由對應策略處理。具體網域規則應排在範圍較廣的規則之前,最後以 MATCH 處理其餘連線。策略群組決定可使用的出口,規則則決定哪些連線進入該群組,兩者不能互相取代。相較於所有流量共用單一出口的全域模式,規則模式能保留直連路徑,並依用途安排代理流量。修改後先查看連線記錄中的命中規則,再判斷是否需要調整順序。
mode: rule
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,DIRECT
規則由上而下比對,MATCH 放在最後。
設定管理可儲存不同來源的訂閱與本機 YAML 檔案。匯入後先為設定取個容易辨識的名稱,再確認目前啟用的項目;下載成功不代表核心已切換。更新遠端訂閱會重新載入其內容,本機檔案則適合保留可自行控制的測試設定。相較於直接修改訂閱原文,使用客戶端支援的覆寫機制更容易保留個人設定。切換多份設定通常是整份替換,不會自動合併策略群組與規則。
更新前保留本機覆寫,切換後確認目前項目。
TUN 會透過虛擬網卡與路由設定,將連線送入核心,適合不使用系統代理的應用程式。它不同於瀏覽器的代理設定,也不代表啟用後所有連線都會經過代理;進入核心的連線仍會依模式與規則選擇出口。首次啟用通常需要服務元件或系統權限。建議先確認一般代理可正常使用,再啟用 TUN,並檢查區域網路存取與 DNS 解析。若與其他 VPN 衝突,先停用其中一個,不要反覆疊加路由設定。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
自動路由須有平台支援及相應權限。
DNS 決定網域名稱的解析方式;Fake-IP 則以映射位址連結網域與後續連線,讓核心能依網域規則處理流量。它不是公共 DNS 位址,也無法單獨修復失效的訂閱。與直接回傳實際位址的方式相比,Fake-IP 仰賴核心維護映射,部分區域網路服務須視情況加入過濾清單。修改前先確認 DNS 查詢是否進入核心,以及上游 DNS 是否可連線。排查時逐項調整,避免同時更換模式、上游 DNS 與接管方式。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
nameserver:
- 1.1.1.1
映射位址由核心處理;上游 DNS 須依網路環境選擇。
外部控制介面可讓相容的面板讀取核心狀態、查看連線並切換策略。它與提供代理服務的監聽連接埠用途不同,填錯連接埠會導致面板無法連線。圖形介面客戶端通常已整合相關管理功能,伺服器使用者才較常需要另外部署面板。相較於直接編輯執行中的設定,控制面板適合用來觀察與暫時操作;設定是否會永久保存則視實作方式而定。預設建議僅綁定本機位址,並設定存取密鑰,切勿將控制介面直接公開至網際網路。
external-controller: 127.0.0.1:9090
secret: "your-password"
僅綁定本機;請在本機更換範例密碼。
先使用客戶端預設選項建立穩定基準,再逐項擴充功能。若需要完整參數、策略群組類型與規則集管理,請閱讀進階設定;遇到不熟悉的欄位,可先到術語表查閱用途。
首次使用先完成最精簡的測試流程:設定能載入、連線能進入客戶端,目標請求也能依預期處理。以下三個步驟只保留主要流程,不必先熟悉所有參數。不同客戶端的按鈕位置可能不同,但設定、模式與網路入口之間的關係相同。
開啟設定管理頁,將訂閱網址貼到連結輸入欄,再點選匯入。設定項目出現後,選取該項目作為目前設定。若使用本機檔案,請選擇從檔案匯入,並確認內容是客戶端支援的 YAML,而非網頁文字或錯誤訊息。
接著確認是否出現解析錯誤。只看到設定項目名稱還不夠,也要確認核心已載入該設定。匯入失敗時,先檢查連結是否完整、訂閱是否有效,以及系統時間是否正確;暫時不要修改 DNS 或 TUN,以免混淆問題來源。
日常使用通常從規則模式開始,再到代理頁面選擇設定中的策略群組與出口。桌面版先開啟系統代理;行動裝置則依提示完成 VPN 授權。若需要 TUN,請等基本連線測試成功後再啟用,並依客戶端要求安裝服務或授予權限。
全域模式可暫時用來區分規則問題與連線問題;直連模式則不會依代理策略轉送請求。切換模式不能取代設定檢查。若應用程式自行設定了代理,或已有其他 VPN 正在執行,先確認請求實際經過哪個網路入口。
開啟要瀏覽的頁面,再回到客戶端查看連線記錄。確認請求有出現、命中規則符合預期,且選用的策略與出口正確。也請檢查一個需要直連的頁面或區域網路服務,避免只測試單一網站而忽略一般網路連線。
頁面無法開啟時,先分辨「沒有連線記錄」與「有記錄但連線失敗」。前者通常要檢查系統代理、VPN 授權或應用程式設定;後者再檢查出口、訂閱與 DNS 解析。記下錯誤訊息並逐項重新測試,比一次變更多個開關更容易找出原因。
Clash 生態涵蓋核心、圖形介面客戶端、設定工具與控制面板,名稱相近不代表它們屬於同一個專案。原始 Clash 專案與後續社群實作應分開看待;mihomo 延續 Clash Meta 相關技術路線,是目前許多客戶端採用的開源核心。舊教學中的截圖、選單或欄位可能來自已停止維護的客戶端,實際操作時應以目前使用專案的文件為準。
下載頁會個別標示封存的客戶端,方便需要相容舊環境的使用者辨識。選擇時優先考量仍持續維護且支援目前系統的實作,不應只憑名稱是否熟悉來決定。首頁不列出具體發行版本號;客戶端的發行資訊集中於下載頁,避免將核心版本與圖形介面版本混為一談。
核心負責解析設定、建立連線、比對規則,並執行 DNS 與網路接管邏輯;圖形介面客戶端則提供訂閱管理、模式切換、系統代理與記錄查看等操作入口。因此,同一項核心功能在不同客戶端中可能使用不同的開關名稱,甚至由服務元件代為管理。使用某個欄位前,除了確認核心支援,也要確認客戶端是否允許直接編輯或覆寫。
客戶端更新與核心更新並不是同一件事。更新介面後,網路行為不一定會改變;更換核心後,設定的相容性也可能不同。排查時記下客戶端名稱、系統環境、啟用模式與錯誤訊息,比只說「已經更新」更有幫助。若要重現問題,盡量使用最精簡的設定,並先移除無關的規則與覆寫。
mihomo 的公開程式碼儲存庫提供原始碼、授權條款、問題討論與發行說明,採用 GPL-3.0 授權。開源代表實作內容可以查閱,維護狀態也能從公開紀錄判斷,而非依下載頁上的宣傳資訊決定。協定支援、欄位行為與已知問題應參考核心文件及發行說明;客戶端介面功能則應查閱該客戶端自己的文件。
向社群回報問題前,先搜尋是否已有相同狀況,並整理重現步驟。記錄中的訂閱網址、存取密鑰、出口位址與個人瀏覽紀錄可能包含敏感資訊,不應直接公開完整內容。分享整理過的錯誤片段、相關設定欄位與實際觀察結果,更有助於討論。本網站提供中文導覽與操作說明;各專案的維護責任與授權條款,請以各自的程式碼儲存庫為準。
軟體更新會變更客戶端或核心的實作;訂閱更新則會刷新連線資訊、策略與規則,兩者應分開處理。更新訂閱前,確認個人修改是否已儲存為本機覆寫;更新軟體前,備份目前設定與必要選項,並閱讀與網路行為相關的變更。不要把遠端訂閱原文當成永久保存個人設定的地方,因為下次更新可能會覆蓋修改。
升級後若出現異常,先確認核心是否成功載入、覆寫是否仍有效,以及系統代理或 TUN 是否重新啟用。網路正常時,不必為了追逐特定版本號而頻繁變更設定;需要新增功能或修正已知問題時,再依發行說明安排更新。每次修改都應保留可還原的基準,方便判斷變化來自軟體、設定或目前的網路環境。
基本連線正常後,再依具體症狀深入排查。以下文章分別從憑證驗證、啟動記錄與連線路徑著手,先說明問題發生在哪一層,再提供檢查順序;閱讀時可保留目前設定,逐項調整單一變數並重新測試。
說明憑證錯誤的常見原因,釐清哪些與代理有關、哪些來自系統時間或網路遭到攔截,並提供相應的處理方式。
閱讀文章 →從設定語法錯誤、核心檔案遺失、權限不足與殘留程序四個方向排查啟動閃退,並介紹各平台的記錄位置與重設設定步驟。
閱讀文章 →依序檢查訂閱有效性、系統時間、連接埠占用、DNS 解析與規則命中,排查節點逾時;每個步驟都提供判斷依據與處理方式。
閱讀文章 →