1. 首次啟動前：確認安裝檔、權限與既有代理

FlClash 是用來管理設定檔、代理節點與連線狀態的用戶端，實際流量轉送則由整合的 mihomo 核心負責。安裝成功只代表程式可以啟動，不表示訂閱已載入，也不代表系統流量已經進入核心。首次設定時，應分別檢查這三個環節，避免同時修改連接埠、DNS 與路由，導致問題難以判斷。

開始前，請先結束其他代理用戶端與 VPN。只關閉視窗可能只是縮到系統匣，請從系統匣選單結束程式，並確認系統代理沒有繼續指向舊程式。本文以 7890 作為混合連接埠範例，並非宣稱所有 FlClash 版本都使用此預設值。實際連接埠、選項名稱與權限流程，請以安裝版本顯示的內容為準。

依作業系統完成安裝檢查

  • Windows：前往「設定」→「系統」→「系統資訊」查看系統類型，並依裝置架構選擇 x64 或 ARM64 安裝檔。先以一般權限啟動；只有在啟用 TUN、安裝服務或建立虛擬網卡時，才依用戶端提示授予權限。
  • macOS：從蘋果選單→「關於這台 Mac」確認使用的是 Apple 晶片還是 Intel 處理器。將 App 移至「應用程式」後再執行。若系統阻擋啟動，請先確認來源，再到「系統設定」→「隱私權與安全性」查看具體提示；不要把關閉整體系統安全機制當成安裝步驟。
  • Android：安裝 APK 時，只授予實際使用的瀏覽器或檔案管理員「安裝未知應用程式」權限，安裝完成後即可收回。各品牌的設定位置不同，可在系統設定中搜尋該項目。首次啟動 VPN 時還會出現系統授權提示，這與安裝權限是兩回事。

請先備份目前仍可使用的設定。訂閱網址可能含有身分驗證權杖，請勿將完整連結、QR Code 或含權杖的記錄截圖貼到公開討論區。

2. 先匯入訂閱，再確認目前設定與節點

首次啟動後，先前往用戶端的設定管理頁面，新增訂閱連結或匯入本機設定檔。貼上訂閱網址時，請檢查前後空白與換行，並保留原有查詢參數；不要把服務商的登入頁網址誤當成訂閱網址。訂閱需由使用者自行準備，安裝用戶端並不等於已取得可用的代理服務。

  1. 在設定管理頁新增遠端訂閱，填入容易辨識的名稱，貼上完整網址後儲存。
  2. 手動更新一次，等候下載與解析完成。若出現錯誤，先處理錯誤原因，不要接著反覆切換 TUN、DNS 或全域模式。
  3. 將匯入的設定選為目前使用的設定。清單中有訂閱，不代表該訂閱已載入。
  4. 開啟代理或策略組頁面，確認看得到節點與分組。若分組採手動選擇，請選取一個可用節點；若使用自動選擇組，請確認組內有可用成員。

分清「匯入成功」與「連線成功」

匯入成功只代表取得的內容可以解析。節點過期、驗證錯誤或伺服器無法連線，都可能要等到建立連線時才會顯現。反過來說，訂閱更新失敗也不一定代表節點失效：訂閱更新網址與代理節點網址是兩條不同的網路路徑。

如果回傳內容是網頁、登入提示或存取限制頁面，即使 HTTP 狀態碼是 200，也不是有效設定。請查看更新錯誤中的格式與解析資訊，再向訂閱提供者確認用戶端支援情況。不要將私人訂閱交給陌生的線上轉換網站處理。

首次更新訂閱時，可能還沒有可用代理；若訂閱網址必須透過代理才能存取，就會形成啟動依賴。請使用提供者給的可連線更新入口，或透過既有且可信任的連線取得設定。反覆開啟尚無可用節點的代理功能，無法解決這種依賴。

3. 系統代理與 TUN：首次驗證只選一種流量接管方式

系統代理會讓遵循作業系統代理設定的應用程式，將請求送到本機連接埠。TUN 則透過虛擬網卡與路由接管流量，適合不遵循系統代理設定的應用程式。特定設定下兩者可以同時使用，但初次排查時建議只啟用一種方式，以減少路由、DNS 與代理設定互相影響的變因。

使用情境首次選擇確認事項
Windows、macOS 瀏覽器測試系統代理核心正在執行，代理位址與監聽連接埠一致
不遵循系統代理設定的桌面應用程式TUN虛擬網卡權限、路由與 DNS 接管狀態
Android 一般使用情境由用戶端透過 VPN 接管系統 VPN 授權、應用程式分流與背景執行限制
只測試命令列代理連接埠明確指定代理命令中的連接埠與用戶端實際連接埠一致

Windows 與 macOS：先用瀏覽器建立基準

先啟動核心並保持 TUN 關閉，再啟用系統代理。Windows 可前往「設定」→「網路和網際網路」→「Proxy」確認手動代理；macOS 可到「系統設定」→「網路」→目前使用的網路服務→「詳細資訊」→「代理」查看設定。選單名稱會隨系統版本變動，但確認重點始終是代理主機與連接埠。

瀏覽器擴充功能、內建代理設定與企業原則都可能覆寫系統設定。首次測試時，請暫時停用代理擴充功能，使用一般瀏覽器視窗分別開啟已知可直接連線的頁面，以及預期會透過代理連線的頁面。若只有特定瀏覽器失敗，請先檢查該瀏覽器本身的設定，不要立刻重新安裝用戶端。

Android：VPN 圖示不代表所有應用程式都已接管

啟動連線時，請接受系統的 VPN 連線要求，並確認沒有其他 VPN 正在執行。同一個 Android 使用者通常只能維持一個啟用中的 VPN 服務，其他 VPN 或部分使用本機 VPN 的過濾工具可能會與 FlClash 衝突。若已啟用應用程式分流，也請確認測試用的瀏覽器位於接管範圍內。

Android 的系統 VPN 接管方式與桌面系統代理不同。請勿直接將桌面端的 127.0.0.1:7890 填入手機的 Wi-Fi 代理設定，並期待它連到電腦；手機上的 127.0.0.1 指的是手機本身。

4. 檢查混合連接埠：7890、占用程序與監聽位址

mixed-port 會在同一個連接埠接收 HTTP 代理與 SOCKS 代理連線。應用程式使用的連接埠必須與核心實際監聽的值一致。以下僅說明欄位用途，並非可直接取代訂閱的完整設定，也不代表需要手動修改這些值。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
  • mixed-port: 7890：手動設定代理的應用程式應使用相同連接埠。若改為 7891，也要同步更新瀏覽器、終端機及其他手動填寫連接埠的工具。
  • allow-lan: false：首次只在本機使用時，維持關閉區域網路存取。開放區域網路連線還涉及監聽位址、防火牆與驗證，不應為了解決本機連線問題而直接開放。
  • mode: rule：依規則選擇對外連線方式。此設定控制分流策略，不會啟用系統代理或建立 TUN 網卡。
  • log-level: info：適合一般啟動與連線檢查。若為排查問題暫時改為 debug，完成後應切回原設定，避免累積過多記錄。

Windows：找出占用連接埠的程序

若啟動記錄出現 address already in use，請在 PowerShell 執行下列命令。第一個命令會列出監聽中的連接埠與所屬程序編號，第二個則會將編號轉換為程序名稱。沒有輸出代表檢查當下未發現對應的 TCP 監聽，不代表核心一定已正常啟動。

Get-NetTCPConnection -LocalPort 7890 -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess

Get-NetTCPConnection -LocalPort 7890 -State Listen |
  ForEach-Object { Get-Process -Id $_.OwningProcess }

macOS：檢查本機監聽狀態

lsof -nP -iTCP:7890 -sTCP:LISTEN

確認程序所屬的應用程式後，再決定要結束舊用戶端或更改連接埠；不要直接終止不明程序。連接埠衝突可能來自其他代理程式，也可能是核心重複啟動。若透過用戶端設定調整連接埠，請重新啟動核心並確認執行中的值；訂閱更新可能覆寫直接編輯的檔案，若要保留變更，應使用用戶端支援的設定或覆寫機制。

5. 規則模式、DNS 與連線測試的正確順序

初始設定建議使用規則模式。規則通常依序比對，由第一條符合的規則決定目標策略；策略組再決定使用哪個節點。全域模式仍取決於所選策略與節點是否可用，無法修正節點密碼、連接埠或傳輸參數錯誤。直連模式則不能用來判斷代理節點是否正常。

分四個層次檢查，不要只看延遲數字

  1. 核心層：啟動後沒有設定解析失敗、監聽失敗或權限錯誤。畫面上有視窗，不代表核心運作正常。
  2. 節點層：測試目前策略組中的節點延遲。結果只反映測試網址與測試當下的狀況，不代表實際下載速度，也無法涵蓋所有目標網站。
  3. 應用程式層：瀏覽器送出請求後，在用戶端連線清單或記錄中查看目標網域、符合的規則與對外連線策略。若看不到請求，優先檢查流量接管方式。
  4. 目標層：請求已進入核心但仍無法存取時，再檢查 DNS 解析結果、節點連線錯誤與目標服務回應。頁面出現 403、429 或連線逾時，代表不同類型的問題。

在 Windows 中，也可以明確指定 HTTP 代理進行比對測試。以下命令適用於混合連接埠確實為 7890 的情況；macOS 可將 curl.exe 改為 curl。若範例網域依規則採用直連，測試成功只代表請求經過本機代理入口，不代表代理節點可用。

curl.exe --proxy http://127.0.0.1:7890 --connect-timeout 10 --max-time 20 -I https://example.com/

DNS 部分請先沿用訂閱與用戶端原有的設定方式。mihomo 的 Fake-IP 模式可能會回傳對應位址，例如 198.18.0.0/16 範圍內的位址，這不代表 DNS 解析遭到污染。啟用 TUN 後若發生解析失敗，請檢查 DNS 接管、上游解析器是否可連線，以及其他加密 DNS 設定；不要同時更換多個公共 DNS。

瀏覽器內建的安全 DNS 可能改變解析路徑，但不一定會造成連線失敗。只有在比對測試確認它與目前的接管方式衝突時，才暫時關閉並重新測試。每次只變更一項設定，並記下變更前的值。

6. 三種平台首次執行時常見的問題

Windows：已啟用系統代理，命令列仍直接連線

有些命令列工具不會讀取 Windows 系統代理，可能改用自己的代理參數或環境變數。請先用上一節的明確指定代理命令驗證，再查閱該工具的說明文件。不要因為終端機沒有被接管，就判定系統代理開關失效。若改用 TUN，請先確認瀏覽器基準測試正常，再授予所需權限並測試路由。

macOS：切換網路後代理失效，結束用戶端後無法上網

macOS 代理設定會依網路服務而異；從 Wi-Fi 切換到乙太網路後，請確認目前網路服務的代理設定。結束用戶端前，先關閉系統代理並確認直連已恢復。若程式異常結束，系統仍保留指向本機連接埠的代理設定，但核心已停止，瀏覽器就會提示無法連線至代理伺服器。此時應清除殘留設定，而不是反覆重新匯入訂閱。

Android：螢幕鎖定後斷線，或只有部分應用程式無法使用

如果螢幕開啟時正常，鎖定一段時間後才失效，請先檢查電池最佳化與背景執行限制。可前往「設定」→「應用程式」→ FlClash 的電池相關頁面，視需求允許背景執行；部分品牌的系統還需要另外允許自動啟動。請勿混淆省電限制與節點逾時，並比對斷線時間與用戶端記錄。

若只有區域網路裝置、投影畫面或工作資料夾中的應用程式出問題，請檢查應用程式分流、略過區域網路與工作資料夾隔離。連線至區域網路目標需要正確的本機路由；若強制將所有流量送往遠端節點，印表機、NAS 或公司內網可能會無法連線。請先記下目標位址與符合的規則，再新增必要的直連規則。

7. 完成初始設定後的檢查清單

首次設定應以可重複驗證作為完成標準，而不是把所有開關都打開。先保留足以說明原因的最精簡設定，再逐步新增開機啟動、應用程式分流或自訂規則。

  • 訂閱已更新、目前設定已選取，代理組內有明確可用的節點。
  • 核心運作正常，已記錄實際監聽連接埠，且沒有連接埠占用錯誤。
  • 桌面系統先完成系統代理測試；確實需要 TUN 時，再分別驗證權限、路由與 DNS。
  • Android 已授予 VPN 權限，測試用應用程式位於接管範圍內，背景執行狀態符合需求。
  • 分別測試一個直連目標與一個代理目標，並能從連線記錄說明使用的策略。
  • 中斷連線後，一般網路可恢復；重新啟動用戶端後，設定與節點選擇仍符合預期。
  • 基礎連線穩定後，再啟用訂閱自動更新與開機啟動；不要一次疊加多個自動化選項。

需要逐項確認 mixed-port、mode 與規則語法時，請參閱設定欄位參考。完整安裝與操作流程請見入門指南。日後遇到問題時，請保留發生時間、系統版本、用戶端顯示的版本資訊、完整錯誤訊息與最近一次設定變更；這些資訊比反覆重新安裝更有助於找出原因。