Windows
在系統的「關於」頁面確認作業系統類型,再核對用戶端標示的處理器架構。初次安裝可先透過系統代理測試瀏覽器連線,不必一開始就啟用虛擬網卡。若安裝程式或系統顯示權限提示,先確認提示涉及安裝、服務還是網路存取;不必只為了處理單一提示就關閉整個防火牆。更換舊用戶端前,先結束舊程序並保留原有設定。
前往下載127.0.0.1 / 用戶端入口
先確認作業系統與處理器架構,再選擇安裝檔。圖形介面用戶端通常可在同一個介面匯入設定、切換策略組及查看記錄,適合初次安裝者。若已在使用命令列核心,可前往下載頁查看獨立的核心下載入口,避免把核心套件當成桌面安裝程式。
在系統的「關於」頁面確認作業系統類型,再核對用戶端標示的處理器架構。初次安裝可先透過系統代理測試瀏覽器連線,不必一開始就啟用虛擬網卡。若安裝程式或系統顯示權限提示,先確認提示涉及安裝、服務還是網路存取;不必只為了處理單一提示就關閉整個防火牆。更換舊用戶端前,先結束舊程序並保留原有設定。
前往下載在「關於這台 Mac」中確認是 Intel 處理器還是 Apple 晶片,再選擇相符的安裝檔。若啟動時出現系統安全性提示,請參閱專案的發行說明,確認安裝需求;若能啟動但無法接管流量,則檢查系統代理狀態及用戶端的網路權限。要移轉到另一台電腦時,建議先移轉設定,不要直接複製舊應用程式的資料夾。
前往下載選擇安裝套件時,請確認裝置所用作業系統支援的架構,不要只看手機晶片的規格。首次連線通常會出現系統的 VPN 授權提示,確認允許後,再查看用戶端是否顯示已連線。若問題只在鎖定螢幕後發生,先檢查系統是否暫停應用程式的背景執行;若一連線就中斷,則確認是否有其他應用程式正在使用 VPN。
前往下載從下載頁前往 App Store 的產品頁面,先確認系統需求,再決定是否安裝。首次連線時,依照系統提示允許新增 VPN 設定;成功匯入與成功連線是兩種不同狀態,不能只因設定清單出現名稱就判定已連線。若裝置已有正在使用的 VPN 設定,請先確認能否切換,尤其是由公司或機構管理的裝置。
前往下載桌面系統使用者應先確認 Linux 發行版、套件格式與處理器架構,再選擇圖形介面用戶端。不同桌面環境處理系統代理的方式不盡相同:瀏覽器能使用代理,不代表終端機指令也會讀取相同設定。若只在伺服器上執行核心,還要確認設定檔路徑與服務權限,並依實際用途設定監聽範圍。
前往下載若兩款用戶端都支援目前的裝置,可優先比較設定匯入方式、維護狀態與記錄入口。若需要區域網路存取、虛擬網卡或設定覆寫,也要確認介面是否提供相應選項,以及核心是否支援這些欄位。若只是為了開啟舊設定檔而考慮使用已封存的用戶端,可先用仍在維護的用戶端測試副本,避免反覆修改原始檔案。
DIRECT / 設定指引
本機監聽、流量接管與規則分流是三件不同的事:連接埠決定應用程式將要求送到哪裡,接管方式決定哪些要求能進入核心,規則則決定進入核心的要求要如何處理。記住這三個環節,排查時就能分辨是要求沒有送進來,還是進來後走錯路徑。
規則模式會由上往下檢查每條規則,符合條件後便採用該規則指定的目標,不會繼續尋找更精確的規則。範例分別處理私人網路位址、示範網域名稱與其他流量:第一條讓指定的位址範圍直接連線,第二條用來觀察網域比對與拒絕結果,最後一條則作為預設規則。這份設定不需要遠端節點,適合先在測試設定中查看記錄,再將相同的順序套用到自己的設定。實際編輯時,請避免將拒絕規則寫成範圍過廣的網域後綴。
MATCH 放在最後。no-resolve 可避免這條位址規則主動將網域名稱解析為 IP。mode: rule
rules:
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- DOMAIN,example.org,REJECT
- MATCH,DIRECT
策略組能將規則引用的名稱與實際處理連線的出口分開。若要替同一組流量更換出口,只需在組內切換,不必逐條修改網域規則。範例中的手動選擇組只有直連與拒絕,適合在獨立的測試設定中觀察切換結果;套用到日常設定前,請改用檔案中實際存在的節點或組名。自動測速類策略組還有探測目標與間隔等設定;用於行動裝置時,也要考量額外探測可能喚醒裝置。
name 完全相同。mode: rule
proxy-groups:
- name: 手動選擇
type: select
proxies:
- DIRECT
- REJECT
rules:
- DOMAIN,example.org,手動選擇
- MATCH,DIRECT
內建 DNS 會處理送達核心的網域查詢,nameserver 則列出可用的上游 DNS 位址。啟用內建解析不代表所有應用程式都會使用它:瀏覽器可能啟用了自己的安全 DNS,系統也可能仍依網路連線設定進行查詢。排查時,先確認是由哪一端送出要求,再檢查上游是否可連線。若公司內部網域仰賴專用解析服務,就不適合直接以公共 DNS 取代原有設定。
dns:
enable: true
nameserver:
- 223.5.5.5
只啟用系統代理時,有些應用程式不會主動使用這個入口。支援 TUN 的用戶端可透過虛擬網卡與路由,將更多流量交給核心處理;但這會涉及作業系統權限,也可能改變印表機、共享資料夾與公司網路的存取路徑。範例適用於支援這些欄位的 Mihomo 桌面環境,啟用前請先記下目前的網路狀態。若切換後連本機服務都無法使用,先停用虛擬網卡並重新測試,不要同時修改規則與 DNS 設定。
auto-route 啟用自動設定路由。auto-detect-interface 用於自動偵測出口網卡。tun:
enable: true
stack: system
auto-route: true
auto-detect-interface: true
介面中的設定檔通常是本機檔案與遠端訂閱的清單;Mihomo 設定中的 profile 則控制部分執行狀態是否儲存,兩者功能不同。範例會儲存手動選擇的策略組選項,方便重新啟動後還原。若訂閱更新時移除了某個節點或變更組名,先前的選擇仍可能失效。若要長期保留自訂規則,先確認用戶端是否提供獨立的覆寫功能,不要只把本機修改留在下次更新時會被取代的檔案中。
profile。profile:
store-selected: true
store-fake-ip: false
便條上的 mixed-port: 7890 僅為範例,不是所有用戶端都使用的固定連接埠。127.0.0.1 指向目前裝置;手機上的相同位址不會指向電腦。若只供本機使用,請維持 allow-lan: false,並以用戶端實際顯示的監聽連接埠為準。遇到連接埠衝突時,確認目前連接埠確實被占用後再更換,並一併修改曾手動填入舊連接埠的應用程式設定。
mixed-port / 初次連線
初次使用時,盡量保留原本可正常上網的狀態,每次只修改一項設定。先確認設定能否載入,再檢查要求是否進入核心,最後才確認規則將流量分到哪裡。這樣即使第二步出了問題,也不必回頭重新匯入訂閱。
01 / config.yaml
在設定或訂閱頁面新增現有的本機檔案或訂閱網址。匯入後,先確認策略組與規則是否出現,再選取該設定檔並確認它是目前生效的設定。若介面只顯示下載成功,卻沒有載入內容,請先查看匯入記錄是否有格式或網路錯誤。訂閱網址可能包含存取憑證,分享錯誤畫面時請勿截取完整網址。
02 / mode: rule
日常使用時先選擇規則模式;確認需要轉送的規則指向正確的策略組,再到組內檢查目前選用的出口。桌面電腦可先透過系統代理測試會遵循此設定的應用程式;手機則需依用戶端的連線操作完成系統授權。規則模式與系統代理並非二選一:前者決定如何分流,後者決定要求如何進入核心。
03 / 127.0.0.1
重新開啟網頁送出要求,再到用戶端的連線記錄中比對網域名稱、命中的規則與出口。若完全沒有新記錄,先確認應用程式是否使用代理入口;若有記錄但連線失敗,再檢查策略組、DNS 與連線錯誤。測試命令列程式時,請另外確認終端機讀取到的代理設定,不要用瀏覽器的結果代替判斷。
需要恢復網路時,先關閉剛才啟用的流量接管方式,再確認系統代理是否已還原。直接結束用戶端程序,可能會讓系統代理設定仍指向本機連接埠。恢復後記下是哪個開關改變了故障狀況,下次就從該步驟繼續排查,不必重新安裝。
config.yaml / 專案來源
Clash開源網是獨立的資訊站,整理用戶端下載入口、設定範例與排查方法。用戶端的發行說明、維護狀態與功能範圍,請以各專案資訊為準。閱讀原始碼時,先分辨看到的是負責網路處理的核心,還是用來控制核心的用戶端介面。
早期的 Clash 專案將代理節點、策略組與分流規則整合在同一份設定中。原專案後來停止維護,但這套設定結構與相關使用習慣,仍由社群中的其他專案延續。舊教學中的介面、選單路徑與欄位,不一定適用於目前的用戶端;舊截圖可用來理解概念,實際操作仍應參考現行專案的說明。
移轉舊設定檔時,先保留原始檔案並另存副本,再逐一比對通用欄位、節點類型與規則目標。舊設定檔即使能成功載入,也不代表每項設定都會以原本的方式處理。先確認基本連線,再逐步還原相依性較高的功能,比移轉時整份重寫更容易找出問題。
圖形介面用戶端通常負責管理設定檔、系統整合與記錄顯示。即使兩款用戶端使用相近的核心,系統匣操作、開機啟動、背景服務與覆寫功能的入口仍可能不同。系統授權或安裝介面相關問題,可先查閱用戶端專案說明;規則判斷與通訊協定支援則較適合參考核心文件。
查閱公開的問題回報時,先確認其中提到的作業系統與重現條件。相同的錯誤訊息,可能源自檔案權限、系統網路服務或設定語法。回報問題時,可提供精簡後的欄位片段、錯誤發生步驟與相關記錄;請先移除節點資訊、訂閱網址及記錄中的個人資料。
Mihomo 是 Clash.Meta 延續發展後採用的專案名稱,公開程式碼儲存庫由 MetaCubeX 維護,採用 GPL-3.0 授權。支援相關功能的用戶端可將使用者選定的設定交給核心,由核心負責監聽、規則比對與連線轉送。用戶端也可能將介面設定合併至最終設定,因此匯入的檔案與核心實際載入的內容不一定完全相同。
確認某個欄位是否生效時,先比對儲存的設定與用戶端提供的生效設定,再查看核心記錄。不要只憑按鈕名稱推斷底層狀態。例如,系統代理已開啟,不代表虛擬網卡也已啟用;兩者改變的是不同的流量入口。
程式升級會更新用戶端本身;核心是否隨安裝套件更新,則由各專案決定。重新整理訂閱會更新設定內容,規則集也可能有自己的更新週期。這些動作在介面上可能都標示為「更新」,但實際修改的項目不同。發生異常時,先記下最近更新的是哪一項,再查看對應專案的變更記錄。
修改前先保留一份過去可正常使用的設定副本;修改後優先重新測試原本正常的要求。若訂閱一更新就出問題,先確認策略組與規則引用是否有變動;若升級應用程式後才發生問題,先檢查系統權限與啟動記錄。不要為了恢復一次連線,同時更新訂閱、覆寫設定並替換核心。
可在 MetaCubeX/mihomo 儲存庫查看原始碼、授權條款與發行記錄。以下指令需先安裝 Git,只會將原始碼下載到目前目錄下的 mihomo 子目錄,不會安裝用戶端或修改系統代理。若要取得可執行的程式,請依作業系統從下載頁選擇適合的版本。
git clone https://github.com/MetaCubeX/mihomo.git
127.0.0.1 / 排查記錄
排查文章依問題現象分類。程式無法開啟,先查看啟動記錄;程式能開啟但沒有流量,先檢查應用程式與本機連接埠的連線;只有特定應用程式無法連線,就從該應用程式的代理設定查起。先選一篇最符合目前狀況的文章。
啟動時立即崩潰,常見原因包括 YAML 語法錯誤、連接埠遭占用或缺少核心檔案;可依據記錄線索逐步排除,恢復正常啟動。
適用於程式尚未顯示主畫面就退出的情況。先確認程式是在讀取設定前還是之後退出,再判斷要還原設定副本、釋出連接埠,或修復安裝。
從安裝套件選擇、系統管理員權限、防火牆放行到啟用 TUN 虛擬網卡,帶你掌握 Windows 的完整設定流程與常見錯誤。
適合卡在系統權限提示或服務安裝步驟的使用者。先確認哪個步驟需要權限,再決定要依正常流程授權,或改回只使用系統代理。
瀏覽器擴充功能攔截代理、終端機不讀取系統代理,或缺少環境變數,都是常見原因;可分別從瀏覽器與終端機兩方面逐一排查。
適用於網頁與命令列的連線結果不一致時。比對兩個應用程式是否使用相同的本機連接埠,再判斷問題出在應用程式的代理入口,還是流量分流規則。