安裝檔與平台選擇
FlClash 支援桌面平台與 Android。下載頁也列出其他 Clash 生態系客戶端，可依處理器架構與使用習慣挑選；iOS 則提供 Clash Plus 的 App Store 連結。
選擇安裝檔時，平台、架構與套件格式都必須相符。電腦能執行某個作業系統，不代表所有同名安裝檔都適用；Android 也應依裝置實際支援的架構選擇。下載頁依平台整理客戶端清單，並列出維護狀態與安裝注意事項，方便比較 FlClash、Clash Plus、Clash Verge Rev 等選項。
查看所有客戶端 →設定與網路選項
先確認設定來源，再決定流量如何進入客戶端，以及由哪條規則選擇出口。下方分頁用來說明各項設定的關係，實際選單請以目前客戶端介面為準。點選任一分類後會停止自動切換，方便依自己的步調閱讀。
訂閱網址是取得設定的入口，匯入成功後仍須選取目前使用的設定。先確認取得的內容是 Clash 設定檔，再檢查代理群組與規則是否完整。遠端訂閱適合持續更新；本機檔案則適合保留自訂內容，兩者的修改方式不同。直接修改由訂閱產生的檔案，可能會在下次更新時被覆蓋。建議分別記錄訂閱來源與本機調整，更新後確認策略群組引用仍然有效。桌面與手機可以匯入相同來源，但各裝置的客戶端設定與權限仍須分別確認。
查看訂閱匯入步驟 →規則模式會依設定檔中的規則順序決定流量出口，適合分別處理需要直連與代理的服務。全域模式主要依全域策略選擇出口；直連模式則讓流量直接連線，三種模式不會同時生效。排查特定網站時，先確認目前模式，再查看連線符合哪條規則與策略群組。規則會由上而下比對，過於寬泛的規則若排在前面，可能會先於後方的精確規則生效。範例中的 Proxy 必須對應設定檔裡實際存在的策略群組，最後的 MATCH 則處理其餘流量；不能只複製名稱而忽略群組定義。
閱讀規則分流筆記 →系統代理會將代理位址寫入作業系統設定，通常適用於遵循這項設定的瀏覽器與應用程式。有些程式會自行建立網路連線，不讀取系統代理，這時可再考慮使用 TUN。TUN 透過虛擬網路介面接管符合路由條件的流量，桌面端可能需要額外權限或服務支援。建議先用系統代理確認設定可正常運作，再逐步啟用 TUN，避免把設定錯誤誤認為權限問題。Android 透過系統 VPN 授權建立連線，與桌面端的開關方式不完全相同；其他 VPN 或網路工具也可能造成衝突。
查看代理無法使用時的排除方法 →混合連接埠可透過同一入口接收 HTTP 與 SOCKS5 連線，示意值 7890 是常見設定，實際請以客戶端目前的設定為準。只在本機使用時，不必啟用允許區域網路連線。若要讓手機或電視使用電腦的代理，先確認裝置連上同一個可信任網路，再開啟相應的監聽設定並檢查防火牆。其他裝置應填入電腦的區域網路位址與連接埠，而非自己的迴圈位址。共享連線是否可用，也取決於監聽位址、網路隔離及應用程式是否支援代理；離開可信任網路後，請關閉不再需要的共享入口。
查看區域網路共享步驟 →FlClash 使用 Flutter 建構圖形介面，桌面與手機的操作都圍繞設定、代理、連線與偏好選項。熟悉一端的設定流程，有助於理解另一端，但介面相似不代表各作業系統的功能完全相同。桌面端須檢查系統代理、服務權限與關閉視窗後的行為；手機則須確認 VPN 授權和背景執行限制。主題與版面屬於客戶端外觀設定，不會取代訂閱規則。更換裝置時，建議先匯入設定並確認連線，再調整顯示與啟動偏好；只複製設定檔，不代表系統權限與所有本機設定也一併轉移。
比較客戶端與平台支援 →首次連線
安裝客戶端只是第一步。準備可用的訂閱或本機設定，依序檢查設定、模式與系統權限，比一次改動多項網路設定更容易找出問題。客戶端不包含可直接使用的代理服務。
開啟設定頁面，使用介面提供的入口新增訂閱網址或本機檔案。遠端網址應由可信任的設定提供者提供，不要把登入網頁的網址誤當成訂閱網址。匯入後確認該項目已設為目前使用的設定，再前往代理頁面查看是否有可用的策略群組。只看得到設定名稱，不代表內容已完整載入。
若匯入失敗，先閱讀錯誤訊息，分辨是網址無法存取、回傳登入頁面，還是設定格式不相容。不要反覆切換流量模式來解決訂閱下載問題；這些設定屬於不同環節。訂閱網址可能包含存取憑證，截圖或求助時請遮蔽完整網址。
日常使用可先選擇規則模式，再到設定提供的策略群組中挑選合適的出口。規則群組與節點名稱由設定檔決定，介面名稱不一定與教學範例相同。全域模式可用於比對測試，但無法修復失效的訂閱、錯誤的憑證或不可用的服務。
桌面端先啟用系統代理；Android 則依提示授權 VPN 連線。若有其他代理軟體正在執行，先停止其中一個再測試，避免同時變更本機連接埠與路由。需要使用 TUN 時，等基本連線正常後再啟用，並記錄調整前的設定。
分別造訪一個預期直連的網站，以及一個預期透過代理連線的服務，並在連線或記錄頁面確認請求是否進入客戶端、符合哪條規則，以及最後選用了哪個策略群組。連線按鈕顯示已啟動，只能表示相關服務已啟動，不能據此判定所有應用程式都已使用代理。
若瀏覽器能連線但其他應用程式無法使用，優先檢查該應用程式是否遵循系統代理。若所有請求都失敗，請依序確認目前設定、策略群組與服務是否可用。每次只修改一項設定，測試後記錄結果，再決定是否進一步檢查 DNS、權限或防火牆。
完整教學會進一步說明匯入失敗、權限提示與連線確認的具體處理方式。複雜網路環境的診斷流程則整理在問題診斷頁，避免打亂初次設定的操作順序。
查看完整教學 →專案與開源生態
了解客戶端、核心與代理服務各自負責的工作，有助於減少選擇與排查時的混淆。開源儲存庫可供查閱程式碼、版本說明與已知問題；連線品質仍取決於設定、服務與本機網路。
已安裝 Git 的開發者可複製指令，在終端機取得儲存庫。一般使用者直接選擇安裝檔即可，不需要編譯原始碼。
git clone https://github.com/chen08209/FlClash.gitmihomo 負責協定處理、規則比對與連線轉送等工作；FlClash 則提供設定管理、開關、策略選擇與記錄檢視介面。舊資料中常見的 Clash Meta 與 mihomo 名稱有專案沿革上的關聯，但舊教學中的選單位置與參數支援範圍，不應直接視為目前客戶端的介面說明。遇到功能差異時，須同時確認客戶端的實作方式與所用核心的功能。
Flutter 是建構圖形介面的技術，不是代理協定。更換介面主題不會改變伺服器支援的協定，切換客戶端也不會自動修復過期的伺服器或錯誤憑證。先判斷問題發生在介面設定、核心設定還是服務連線層，再查閱對應文件，可避免只因軟體名稱不同就反覆重新安裝。
FlClash 專案採用 GPL-3.0 授權，可在儲存庫中查閱原始碼與授權條款。若要修改、散布或將程式碼用於其他專案，應先了解授權要求，不要把「程式碼可檢視」視為可以任意移除原有授權聲明。一般使用者則可透過儲存庫中的版本記錄、問題討論與文件，掌握功能變更與已知限制。
閱讀社群問題時，優先尋找作業系統、安裝方式與故障現象相近的紀錄。同樣是「無法上網」，背後原因可能完全不同。回報問題前，請準備重現步驟、已遮蔽敏感資訊的錯誤記錄，以及嘗試過的操作；這比只提供連線按鈕的截圖更有助於找出原因。請勿公開訂閱網址、帳戶資訊或完整設定中的敏感欄位。
客戶端更新主要涉及介面、核心整合與相容性修正；訂閱更新則是重新取得代理、策略群組與規則內容。GeoIP、GeoSite 等資料也可能各有更新入口。若網域分流結果不如預期，應分別檢查規則內容、資料是否可用與比對順序，不能只因安裝檔版本較新，就認定設定一定正確。
更新前保留必要的本機設定紀錄，並閱讀版本說明中涉及權限、設定移轉或系統需求的變更。更新後先確認目前設定仍已選取，再測試常用應用程式。若出現異常，記錄更新前後的差異並依症狀排查；尚未確認原因前，不要同時更換訂閱、修改 DNS 並重設所有設定。
同一份訂閱可分別匯入相容的客戶端，但設定提供者可能會限制同時連線的裝置數量或服務使用方式。手機與電腦連線的網路不同，即使匯入同一份設定，DNS、路由與防火牆環境也可能不同。因此，一台裝置可用只是排查線索，不代表另一台也一定能用。
若要進一步挑選客戶端，可查看客戶端比較；已完成安裝但遇到連線問題，可依問題診斷中的症狀進入相應流程。基礎概念與常見安裝疑問收錄於 FAQ，適合先確認術語與設定含義，再決定是否調整網路參數。
技術筆記
補充說明特定設定的運作方式與操作細節。完成首次連線後，可依實際需求閱讀資料更新、客戶端關係與代理共享步驟。文章中的參數範例須配合目前設定使用，尤其要留意策略群組名稱、監聽位址與權限差異。
說明 GeoIP、GeoSite 資料檔的來源與用途，以及手動和自動更新方式、geox-url 下載網址；並整理分類缺漏導致規則失效時的檢查順序。
閱讀筆記 →釐清原版 Clash、Clash Meta 與 mihomo 之間的專案關係，了解核心和圖形介面的職責，再依平台支援與操作習慣挑選客戶端。
閱讀筆記 →從 HTTP 與 SOCKS5 共用入口談起，說明如何查詢電腦的區域網路位址、設定裝置代理，並確認防火牆允許範圍與可信任網路條件。
閱讀筆記 →技術筆記補充單項功能的原理與操作細節；若尚未成功匯入設定，建議先完成入門指南，再回來逐項調整這些專題設定。
查看所有文章 →