先分清用戶端、核心與設定檔。用戶端提供操作介面，mihomo 核心負責處理網路連線，設定檔則決定節點、策略群組與規則如何搭配。查看左側項目了解設定用途，再回到用戶端逐一確認，避免同時切換多個選項，難以判斷變化原因。
mihomo 是負責解析設定、比對規則與建立代理連線的核心。圖形化用戶端則在此基礎上提供訂閱清單、模式切換與記錄介面，因此介面名稱不同，不代表底層設定完全不同。挑選用戶端時，先確認支援的核心與設定欄位，再匯入現有訂閱。遇到設定解析錯誤時，先查看記錄中的欄位名稱，不要只因用戶端能啟動，就認定訂閱相容。以下為基礎欄位示意，並非可直接連線的完整設定。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info訂閱是用來取得設定內容的網址，YAML 則是常見的設定檔格式。開啟用戶端的設定或訂閱頁面，選擇從連結匯入，貼上服務提供者給的完整網址，等更新完成後選取該設定。本機檔案請使用檔案匯入功能。節點分享連結不一定能直接當作完整設定使用，請先確認格式，再決定是否需要轉換。訂閱網址可能包含存取憑證，回報問題時只提供錯誤資訊，切勿公開完整連結。
https://example.com/sub?token=xxxx以上僅為格式示例，不提供可用的訂閱服務。
查看匯入訂閱步驟 →規則分流會依網域、位址等條件，決定連線直連或使用代理。核心通常由上而下比對規則，第一條符合的項目會決定連線去向，因此規則的順序與內容都很重要。匯入訂閱後，先使用規則模式，再確認策略群組已選取可用節點。全域模式會將更多連線交由全域策略處理，但無法修復失效節點。範例中的 DIRECT 表示直連，只適用於符合的網域後綴，不代表所有 Apple 服務都會直連。
rules:
- DOMAIN-SUFFIX,apple.com,DIRECT系統代理會將本機代理位址寫入作業系統設定，遵循這項設定的應用程式便會把連線交給用戶端。初次使用建議先啟用此方式，開啟瀏覽器測試，再確認連線記錄是否出現相應請求。終端機工具或部分應用程式可能不會讀取系統代理，需另行設定代理位址或改用 TUN。結束用戶端前，請先關閉系統代理；若程式異常結束後網頁無法開啟，也要檢查系統設定是否仍指向已停止監聽的本機連接埠。
# 連接埠以用戶端實際設定為準
HTTP / SOCKS: 127.0.0.1:7890
mixed-port: 7890TUN 透過虛擬網卡接收網路流量，適合不遵循系統代理設定的程式。通常需要用戶端安裝輔助服務，並取得系統授權。請先確認一般代理連線可正常使用，再開啟 TUN，並觀察記錄與 DNS 解析是否正常。虛擬私人網路、其他代理程式或容器網路可能造成路由衝突，排查時一次只保留一種流量接管方式。TUN 擴大的是接管範圍，流量最後直連或走代理，仍由模式與規則決定。
tun:
enable: true
auto-route: true
auto-detect-interface: true開啟蘋果選單中的「關於這台 Mac」，若看到「晶片」及 Apple 晶片名稱，請選擇 Apple Silicon 或 ARM64 安裝檔；若看到 Intel 處理器，則選擇 Intel 或 x64 安裝檔。使用原生架構可減少對轉譯環境的依賴，但仍須符合用戶端標示的系統需求。安裝前先結束舊用戶端，將應用程式拖移至 Applications 後再啟動。更換用戶端時，請先備份設定與自訂規則，避免兩個程式同時修改系統代理。
uname -m
# arm64：Apple 晶片原生環境
# x86_64：Intel 環境或使用轉譯的終端機功能說明每 8 秒切換一次；點擊、鍵盤操作或取得焦點後即停止。欄位示例用於說明設定用途，實際設定請以所選用戶端與訂閱內容為準。
先選作業系統，再選架構。桌面裝置建議優先使用圖形化用戶端；伺服器與路由器則可考慮直接執行核心。下方入口會前往下載頁中對應的平台，不會直接開始下載；可先閱讀系統需求、維護狀態與安裝說明，再決定使用哪款用戶端。
依 Apple Silicon 或 Intel 選擇安裝檔，建議優先查看 Clash Plus，也可比較 Clash Verge Rev 與 FlClash。開啟 DMG 磁碟映像檔後，將應用程式拖移至 Applications，再從「應用程式」資料夾啟動；安裝視窗不是日常的啟動入口。
首次啟動時，依系統提示確認來源。需要使用 TUN 時，再依用戶端指示安裝輔助服務。若系統阻止開啟，請先確認下載來源、系統需求與具體提示，不要把關閉系統安全功能當成通用安裝步驟。封存的舊版用戶端適合查閱舊設定，日常使用建議優先選擇仍持續維護的版本。
查看 Clash Plus、Clash Verge Rev、FlClash 等桌面用戶端，再依本機系統與處理器選擇。安裝完成後，先匯入設定並選取策略群組中的節點，再啟用系統代理。若需要透過虛擬網卡接管流量，請依用戶端要求安裝服務或授予權限。
Clash for Windows 已停止維護，下載頁保留封存說明，不應將它與持續維護的用戶端視為相同選擇。部分商店應用程式涉及 UWP 迴圈存取限制，需依應用程式類型個別排查。若瀏覽器能開啟網頁、其他程式卻無法連線，請先確認該程式是否會讀取系統代理，不必立刻重複安裝。
查看 Clash Plus、Clash Meta for Android、FlClash 與 Surfboard 的安裝選項。較新的手機多半使用 ARM64，但仍應依裝置資訊選擇。安裝後匯入用戶端支援的設定格式；首次建立連線時，系統會要求確認 VPN 連線權限。
Android 的 VPN 授權用於建立本機流量接管通道，不代表已有可用的代理節點。若連線後常在背景中斷，請檢查電池最佳化、背景活動，以及是否有其他 VPN 應用程式佔用。各用戶端支援的訂閱格式可能不同，不能只因連結能在瀏覽器中開啟，就認定一定可以直接匯入。
從下載頁前往 Clash Plus 的 App Store 頁面，先查看商店中的裝置相容性與應用程式說明。用戶端官網為 clashplus.io。安裝完成後新增設定，依系統提示允許建立 VPN 設定檔，再回到應用程式啟用連線。
手機與 Mac 可使用同一服務提供的訂閱，但仍須確認格式與裝置數量限制。切換 Wi-Fi 與行動網路後若連線異常，請先查看應用程式狀態與訂閱有效期限，再重新連線。授權視窗只會授予系統流量接管權限，不會檢查節點是否可用；節點、規則與 DNS 仍須在用戶端中確認。
桌面環境可選擇 Clash Verge Rev 或 FlClash，依 Linux 發行版選擇合適的套件格式，並確認套件架構。安裝後先在圖形介面匯入訂閱，再檢查桌面環境的代理設定。不同桌面的設定入口可能不同；即使圖形化用戶端已啟用代理，終端機程式也不一定會自動沿用。
伺服器或無圖形介面的裝置可直接執行 mihomo，並使用 systemd 管理程序。此時需自行維護設定路徑、執行使用者、監聽位址與記錄權限。請勿將控制介面直接暴露於公網，也不要為了方便連線而任意開放區域網路監聽。命令列部署與桌面安裝的操作差異，可在安裝總覽中逐項查閱。
Clash for Mac 是為 Mac 使用者整理的下載與設定資料站，彙整不同用戶端的安裝入口與使用方式。本網站與各用戶端、核心專案的維護者並非同一主體。判斷功能支援與維護狀態時，應參考個別專案的發布說明，而非只看名稱中是否包含 Clash。
核心程式碼儲存庫可供查閱設定實作、問題紀錄與發布說明。複製指令只會取得原始碼，不會安裝圖形化用戶端，也不會自動建立代理連線。
git clone https://github.com/MetaCubeX/mihomo.gitClash 生態系歷經原始專案、不同分支與社群用戶端的發展。mihomo 延續並擴展 Clash Meta 路線，許多圖形化用戶端使用它處理代理連線。舊教學中的名稱與介面可能仍然存在，但不能因此推斷目前的選單位置、欄位支援或維護狀態完全相同。
查閱資料時，先確認文章討論的是核心還是圖形介面，再核對使用的用戶端。Clash for Windows 與 ClashX Meta 的封存版本可用來了解舊環境；遇到系統相容性問題時，應優先評估是否遷移至仍持續維護的用戶端，而非反覆照著舊版操作截圖設定。
開源儲存庫提供查閱設定解析、規則行為與問題修正的依據。但這不代表每款用戶端都支援相同功能，也不代表訂閱服務由核心專案提供。圖形化用戶端、代理節點與訂閱提供者各有分工，排除問題時需要分別檢查。
若記錄顯示設定欄位不受支援，請先對照核心文件與用戶端發布說明；若設定可以載入，但所有節點都連線失敗，則繼續檢查訂閱有效期限、網路連線狀況與節點資訊。公開提問時，請隱藏訂閱憑證、帳戶資訊與管理介面金鑰，只保留重現步驟及必要的錯誤片段。
用戶端更新可能會調整介面、輔助服務或核心的打包方式；核心更新則可能影響協定支援、規則處理與網路行為。兩者不一定會同步發布。升級前請閱讀變更說明，備份自訂規則與目前的設定；升級後先確認訂閱能否載入，再測試系統代理與 TUN。
不要只因網頁無法開啟，就直接歸因於軟體版本過舊。先確認是否只有特定網站失敗，再判斷問題出在網域解析、規則比對或節點連線。按照明確的順序檢查，比連續更換多款用戶端更容易找出原因。下載頁集中列出可選安裝檔，首頁不顯示容易過時的具體版本資訊。
更新訂閱是重新取得遠端設定，不是升級用戶端。更新間隔應依服務提供者的要求與節點變動頻率設定；過於頻繁的請求可能觸發服務限制。需要保留的自訂規則，應使用用戶端支援的覆寫或合併機制管理，避免下次更新時被遠端內容覆蓋。
結束用戶端前先中斷代理連線，可減少系統仍指向本機代理的情況。長時間不使用 TUN 時，請檢查輔助服務與路由狀態。發生故障時，先記下發生時間、網路環境、使用模式與錯誤提示，再依安裝總覽中的檢查流程處理；不要一次更改多項設定，之後才回想原本狀態。
匯入只表示設定已儲存。接著確認已選取該設定、策略群組已選擇可用節點，而且系統代理或 TUN 已啟用。開啟連線記錄，查看請求是否進入核心；若沒有請求，先檢查流量接管；若有請求但連線失敗，再檢查節點與 DNS。前往常見問題查看排查說明 →
系統代理決定應用程式是否將請求交給用戶端；規則模式與全域模式則決定請求進入核心後如何選擇出口。兩者位於不同環節，不能互相取代。初次使用先選擇規則模式，確認瀏覽器可正常使用後，再依個別應用程式調整流量接管方式。查看模式選擇步驟 →
是否同時啟用，取決於用戶端的實作方式與使用情境。TUN 通常已能接管更多連線，但仍須檢查路由、DNS 與繞過設定。初次排查時，先分別測試兩種方式，確認各自有效後，再依用戶端說明搭配使用，避免多個代理或 VPN 程式同時修改網路路徑。查看連線方式相關問答 →
安裝完成後，可再依問題查閱相關原理。需要更換用戶端時，比較平台支援與操作習慣；遇到終端機、遊戲或區域網路裝置無法連線時，先釐清系統代理、虛擬網卡與路由器接管各自負責哪一段流量。以下三篇筆記從不同面向切入，避免直接把桌面端的選項套用到其他裝置。
從平台支援、核心相容性、介面風格與上手難度比較主流用戶端，並提供 Mac、Windows 與手機使用者的選擇建議。先確認裝置與維護狀態，再決定是否需要移轉現有設定。
閱讀設定筆記 →比較系統代理與 TUN 虛擬網卡的流量接管範圍，說明終端機指令、遊戲與 DNS 的處理方式。先確認請求是否進入核心，再判斷應調整流量接管方式，或繼續檢查規則與節點。
閱讀設定筆記 →整理主路由與旁路由的分工、閘道與 DNS 指向，說明架構選擇、資源用量評估及常見斷網原因。適合已了解桌面代理流程，並準備將流量接管範圍擴大至區域網路裝置的使用者。
閱讀設定筆記 →