Clash 全平台
安裝設定指南

安裝前的準備工作

確認系統、架構與設定來源

安裝前先確認作業系統與處理器架構。macOS 可在「關於這台 Mac」查看晶片；Windows 可在「設定 → 系統 → 系統資訊」查看系統類型；Linux 可執行 uname -m。架構會影響程式能否啟動，檔案格式則決定安裝方式，兩者不可混為一談。除了確認檔名是否適用於自己的系統，也要核對下載項目的架構說明與專案列出的最低系統需求。

用戶端本身不等於代理服務。安裝程式只提供設定管理、代理連線與流量接管功能；實際使用仍需要有效的訂閱網址，或包含可用出站的本機設定。請確認訂閱來自可信來源、目前仍有效，且註明支援的用戶端或核心。訂閱連結通常含有帳戶識別資訊，不應貼到公開留言、截圖或故障回報中。

轉移設定前，先備份原有設定，並記下目前使用的代理群組、混合連接埠與流量入口。訂閱內容可能會被遠端更新覆寫；需要長期保留的修改，建議使用用戶端提供的覆寫、擴充或合併功能。若用戶端沒有這些功能，可先複製一份作為本機設定測試，但這份副本不會自動套用後續訂閱更新。

釐清設定、出站與流量入口

完整連線包含三個獨立環節：載入設定、決定要求要交給哪個出站，以及讓應用程式流量進入用戶端。匯入成功只代表內容已儲存，不表示設定已啟用；代理群組顯示正常，也不代表系統代理已開啟。每次初次設定都應依序檢查，避免設定尚未生效就反覆切換網路選項。

規則模式會依規則順序比對，並非所有要求都會經過代理。全域模式通常會將已進入用戶端的要求交給所選的全域出站，不會自動接管原本未經用戶端的應用程式。直連模式也不代表已退出用戶端，流量仍可能經過本機監聽與 DNS 處理。詳細原理請參閱虛擬網卡與系統代理的運作方式比較。

首次連線先使用單一入口

桌面版建議先只開啟系統代理，並用瀏覽器測試設定；若程式不遵循系統代理，再考慮使用 TUN 模式。行動裝置通常透過系統核准的 VPN 介面接管流量，不必照搬桌面版的手動代理步驟。首次測試時，先退出其他 VPN、舊代理用戶端與流量接管工具，保留一般防火牆，再觀察結果，避免同時變更多項設定。

建立可復原的測試基準

選一個原本可直接連線的網站檢查基本網路，再選一個依目前規則應走代理的網站檢查分流。開啟連線頁，確認網域、命中規則、代理群組與最終出站。不要只憑網頁能開啟就認定設定正確：快取、既有長連線與直連規則都可能影響結果。測試時請建立新要求，必要時關閉應用程式後重新開啟。

退出用戶端前，請關閉系統代理或中斷 VPN，並確認網路已復原。若系統仍保留指向本機連接埠的代理設定，而用戶端已停止監聽，應用程式可能無法連線。事先了解復原方式，比反覆重新安裝更有效。後續排除故障時一次只變更一項設定並記錄變更，才能判斷問題是由設定、權限還是流量入口造成。

macOS 安裝與設定

選擇處理器架構並完成安裝

前往macOS 用戶端專區，優先查看 Clash Plus；也可依設定相容性選擇 Clash Verge Rev 或 FlClash。Apple Silicon 裝置請選擇對應架構的安裝套件，Intel 裝置則選擇 Intel 套件。ClashX Meta 已停止維護，僅適合作為既有環境的封存選項，不應將封存版用戶端視為相容新系統的保證。

開啟磁碟映像檔後，將應用程式拖曳至「應用程式」資料夾，再從該處啟動。不要長期直接從映像檔執行，否則後續更新、輔助服務定位或權限登錄可能不穩定。若下載的是其他格式，請依下載頁與安裝程式提示操作。首次啟動時先確認應用程式來源與名稱，不要為了略過提示而一併關閉系統安全功能。

若無法開啟或出現安全性提示，先判斷是架構不符、未達系統需求，還是首次執行遭到阻擋。若已確認應用程式來源可信，可前往「系統設定 → 隱私權與安全性」查看是否有相應的開啟選項；不同系統版本的提示可能不同。若介面明確指出程式已損毀，請勿直接照抄移除安全屬性的指令，應先重新下載並確認安裝來源。

匯入訂閱並確認目前使用的設定

在設定頁選擇透過連結匯入，貼上完整訂閱網址並儲存，等待下載完成。部分用戶端會將入口放在新增設定或建立設定選單中。匯入後請主動選取該設定，查看執行狀態與記錄，確認核心已成功載入。若只看到一個項目，但代理頁仍是空白，請確認設定是否尚未啟用，或設定本身是否缺少有效代理群組。

本機 YAML 檔案可透過檔案匯入；檔案中的相對參照、規則集與外部資源仍可能需要網路連線。編輯前請保留副本，尤其不要直接修改訂閱產生的檔案後又按下更新，否則變更可能遺失。若要為公司網域新增直連規則，請使用用戶端提供的持續性擴充功能，並在更新訂閱後再次確認實際生效內容。

先開啟系統代理，再視需要設定 TUN

在代理頁選擇規則模式，為需要手動選擇的代理群組指定可用出站，再開啟系統代理。首次變更系統網路設定時，用戶端可能會要求授權；僅在確認授權內容符合目前操作時才核准。前往「系統設定 → 網路」選取目前使用的網路服務，查看代理設定是否指向本機，並確認連接埠與用戶端的混合連接埠一致。系統介面的路徑可能因 macOS 版本而略有不同。

瀏覽器通常會讀取系統代理，但命令列工具不一定會。若要確認應用程式行為，可讓單次要求明確經由本機連接埠傳送。以下僅適用於混合連接埠已設為 7890 的情況；若實際數值不同，請先依用戶端顯示的數值調整。此指令使用一般測試網址，只能驗證明確指定的代理路徑是否建立，不能單獨證明所有規則都正確。

curl --proxy http://127.0.0.1:7890 --head https://example.com

若需要接管遊戲、命令列或其他不遵循系統代理的流量，再嘗試 TUN 模式。用戶端可能會要求安裝輔助服務或授予網路延伸功能權限；請依提示完成，再檢查記錄。一般桌面使用不必開啟允許區域網路連線。TUN 的 DNS、路由與介面自動偵測應依目前用戶端說明設定，不可原樣套用其他平台的虛擬網卡參數。

處理睡眠、網路切換與退出後的殘留設定

從 Wi-Fi 切換至有線網路，或從睡眠狀態恢復後，若只有代理要求失敗，請先重新連線，再檢查實際使用的網路介面。系統代理會依網路服務儲存，舊介面的設定不一定適用於新介面。若已啟用 TUN，請確認路由是否隨網路變更重新建立；可先停用再啟用 TUN 進行比對，不要同時重設整套網路。

退出後無法連線時，請檢查目前網路服務中的網頁代理與安全網頁代理是否仍指向本機。先清除殘留的流量入口，再考慮移除應用程式。若安裝過輔助服務，請依用戶端提供的方式移除，不要任意刪除系統目錄。連線頁與記錄頁的用途可參考用戶端介面導覽，釐清錯誤發生在哪個環節。

Windows 安裝與設定

安裝套件、帳戶權限與首次啟動

前往Windows 用戶端專區，優先選擇 Clash Plus。其他選項依序包括 Clash Verge Rev、FlClash、Clash Nyanpasu；Clash for Windows 則是已停止維護的封存版用戶端。選擇時請核對系統類型與下載項目說明，不能因為系統是 ARM64 就認定任意安裝套件都原生相容，也不要混淆安裝程式與免安裝壓縮包的使用方式。

執行安裝程式後，依提示選擇安裝位置。若使用免安裝版本，請先完整解壓縮至目前帳戶可寫入的固定資料夾，再啟動主程式，不要直接從壓縮軟體的預覽視窗執行。設定、記錄與更新檔案可能儲存在使用者資料夾，程式所在位置不一定就是設定所在位置。更換電腦時，應透過用戶端匯出，或依其說明備份，不要只複製桌面捷徑。

一般系統代理通常不需要一直以系統管理員身分執行主介面。安裝服務、建立虛擬網卡或修改特定網路設定時，用戶端才可能要求提高權限。若出現安全性提示，請先確認發行者、來源與路徑；受組織管理的裝置也可能受到政策限制。不要把「以系統管理員身分執行」當成所有錯誤的通用解法，這無法修復無效訂閱或錯誤的出站設定。

匯入設定並檢查系統代理

從設定頁匯入訂閱，更新成功後選取該項目，讓核心重新載入。開啟代理頁檢查代理群組，選擇明確可用的出站，再使用規則模式。開啟系統代理後，前往「設定 → 網路和網際網路 → Proxy」查看手動 Proxy 是否生效。用戶端通常會寫入本機位址與監聽連接埠，但仍應以目前的系統設定為準。

若瀏覽器正常，但某個桌面應用程式無法連線，先查看該程式是否有獨立的代理設定。有些程式會遵循系統設定，有些只使用自己的代理選項，另有一些使用不同的 Windows 網路元件。系統代理不會強制套用至所有處理程序；不要為了解決單一應用程式問題而反覆切換全域模式，因為全域模式改變的是出站選擇，不是應用程式進入用戶端的路徑。

可在 PowerShell 中呼叫 curl.exe 明確測試代理，避免不同環境下 curl 名稱的行為差異。請先確認混合連接埠與範例中的數值相同，再執行指令。若明確指定代理的要求正常，但目標應用程式沒有連線記錄，請優先檢查應用程式的流量入口，而非先修改 DNS。測試結果仍須搭配連線頁上的規則與出站資訊判斷。

curl.exe --proxy http://127.0.0.1:7890 --head https://example.com

TUN 服務、防火牆與 UWP 回送

若需要讓更多程式的流量進入用戶端，可依軟體提示安裝服務並啟用 TUN。啟用後，查看記錄是否出現權限、網卡建立或路由錯誤，再測試目標程式。防火牆提示需配合網路設定檔判斷，只授予實際需要的範圍；僅供本機使用時，不要順手開啟區域網路共用。防火牆負責控制輸入連線，TUN 接管與代理規則則處理其他層面，三者不能互相取代。

部分商店應用程式會在 AppContainer 隔離環境中執行，可能無法存取本機代理監聽。即使一般瀏覽器可連線，這些應用程式仍可能失敗。若用戶端提供 UWP 回送工具，請先確認應用程式身分，再只為確有需要的程式設定豁免。命令列操作與復原方式請參閱UWP 回送豁免與 CheckNetIsolation 設定方式，不要直接為所有應用程式批次開放。

連接埠衝突、代理殘留與網路復原

記錄出現位址被占用或監聽失敗時，請檢查是否同時啟動另一個用戶端，或舊的處理程序尚未結束。混合連接埠必須由目前的核心成功監聽，系統設定中的連接埠也必須與之相符。可以更換監聽連接埠後同步更新手動設定，但不要只修改系統代理連接埠而保留用戶端原值，否則要求會送往沒有服務監聽的位置。

停止使用前先關閉系統代理與 TUN，再退出程式。若異常退出後無法連線，請回到系統代理頁面清除殘留設定；若問題只出現在命令列，也要檢查目前終端機的代理環境變數。VPN、虛擬機器網路與公司安全軟體可能同時改變路由，排除故障時請逐一停用可控制的接管工具並留下記錄，不建議直接重設整套網路。

Android 安裝與設定

選擇安裝套件並處理安裝權限

前往Android 用戶端專區，優先查看 Clash Plus；也可依需求選擇 Clash Meta for Android、FlClash 或 Surfboard。不同用戶端支援的設定格式並不完全相同，不能只因訂閱名稱相近就認為可以互換。請先確認服務提供者支援的格式，再選擇用戶端，通常比匯入失敗後反覆嘗試轉換更省時。

安裝前請核對系統版本與處理器架構。多數較新的裝置使用 ARM64，但不應只憑手機外觀或上市時間判斷；可透過裝置設定或可信的系統資訊頁面確認。通用套件主要用來簡化架構選擇，無法自動解決系統版本限制。若安裝程式明確提示不相容，請回到下載頁核對需求，不要不斷更換檔名相似的套件。

透過瀏覽器或檔案管理員開啟安裝套件時，Android 可能會要求允許該來源安裝應用程式。僅為目前可信的來源暫時授權，安裝完成後可還原原本設定。若舊應用程式與新套件的簽章不符，系統可能拒絕覆蓋；請先備份設定與訂閱，再決定是否解除安裝舊應用程式，不要在未備份時清除資料。

匯入訂閱並核准 VPN 連線

進入設定管理，新增遠端訂閱或匯入本機檔案，等待內容下載完成，再選取為目前使用的設定。若透過其他應用程式開啟連結，請確認接收端確實是所選的用戶端；從剪貼簿或 QR Code 匯入的連結也要確認完整。匯入失敗時，先確認連結回傳的是設定內容，而非登入頁面、網頁說明或錯誤訊息。

啟動連線時，系統會顯示 VPN 連線要求。核准後，用戶端才能透過 Android 的 VPN 介面接收應用程式流量。這項系統授權不代表遠端出站已成功連線；仍需在代理群組中選擇可用出站並檢查記錄。VPN 圖示只能表示介面正在運作，不能單獨用來判斷訂閱、規則與 DNS 是否正確。

Android 用戶端可能將流量接管選項放在網路、路由或 VPN 設定中，不一定有桌面版同名的「系統代理」選項。通常不需要在 Wi-Fi 設定中再填寫本機 HTTP 代理。若之前手動設定過 Wi-Fi 代理，請先記錄並清除，避免多一層轉送；離開該 Wi-Fi 後，行動網路也不會沿用其手動代理設定。

應用程式分流、背景執行與電池限制

若需要讓部分應用程式直連，請先區分應用程式分流名單與網域規則。應用程式分流設定決定哪些程式進入或略過 VPN 介面；規則則決定已進入核心的要求交給哪個出站。白名單與黑名單的意義可能因用戶端而異，儲存前請確認選項是「僅代理選取的應用程式」還是「略過選取的應用程式」，再透過連線頁驗證。

變更設定後，有些程式仍會沿用既有連線。請關閉目標應用程式再重新開啟，觀察是否出現新的連線記錄，才能判斷應用程式分流是否生效。若涉及工作設定檔、應用程式雙開或多個使用者空間，系統隔離可能限制用戶端可見的應用程式範圍；不要假設某個空間中的 VPN 會自動涵蓋其他空間。

螢幕鎖定後斷線或過一段時間停止更新，通常與系統電池管理或背景限制有關。先確認用戶端是否獲准在背景執行，以及是否需要保留前景服務通知，再依裝置系統提供的路徑調整電池策略。不同品牌的選單路徑各異，不宜照搬其他手機的設定。只為確有需要的應用程式調整權限，之後再測試鎖定螢幕與恢復連線。

行動網路切換與 DNS 故障排除

在 Wi-Fi 與行動網路之間切換後，原有長連線可能失效，需要重新建立。先發出新的要求，查看核心是否仍收到流量；若完全沒有記錄，請檢查 VPN 是否被其他應用程式取代。同一個 Android 使用者環境通常只能有一個作用中的 VPN，廣告攔截、企業連線或其他代理工具也可能占用這個位置。

若只有網域無法連線，請留意系統私人 DNS、用戶端 DNS 與規則模式之間的關係。先記錄現有設定，再以系統自動模式進行比對，接著才決定是否調整用戶端的解析流程，不要一次關閉所有網路防護功能。Surfboard 等用戶端的設定語法與 mihomo YAML 不同，不可將本文的 YAML 範例直接貼入不相容的設定欄位。

iOS 安裝與設定

從 App Store 安裝 Clash Plus

iPhone 與 iPad 可前往iOS 用戶端專區查看 Clash Plus，並透過 Clash Plus 的 App Store 頁面安裝，官方網站為 clashplus.io。安裝前請閱讀 App Store 列出的系統相容需求；實際功能、選單名稱與權限說明請以目前的應用程式為準，不要將桌面版的服務安裝流程套用在行動裝置上。

首次啟動後，先確認能開啟設定管理與連線介面，再準備訂閱。安裝應用程式與新增系統 VPN 設定是兩個不同步驟；應用程式出現在主畫面，不代表系統已允許接管流量。若裝置由學校或組織管理，VPN 設定可能受到裝置管理政策限制，請循管理方的正常流程處理，不要反覆解除安裝應用程式。

從舊用戶端移轉時，先記下訂閱來源、代理群組選擇與自訂規則。不同應用程式的內部資料庫與備份格式未必通用，建議優先移轉原始訂閱或相容設定，而非直接複製應用程式的私有檔案。訂閱能否使用取決於用戶端支援的格式與通訊協定，不取決於連結能否在瀏覽器中開啟。

匯入設定並授予 VPN 權限

在應用程式中使用新增設定、訂閱或匯入檔案的入口，輸入完整網址並取得內容。匯入完成後選取該設定，確認代理群組可見，再嘗試連線。透過分享選單或剪貼簿匯入時，請確認內容未遭截斷，尤其是含有查詢參數的連結。訂閱屬於個人設定資料，故障回報截圖應隱藏網址中的識別資訊。

首次建立連線時，iOS 可能會要求允許新增 VPN 設定，並透過裝置密碼或系統驗證確認。核准後，請返回應用程式完成連線；若先前取消授權，請重新從應用程式觸發，而非手動建立不相關的 VPN 類型。可在系統設定的 VPN 清單中確認目前設定，但訂閱更新與代理群組選擇仍須在應用程式內操作。

行動裝置會透過系統提供的網路延伸功能接管流量，通常不需要設定 Wi-Fi 的 HTTP 代理。Wi-Fi 代理只適用於該網路，也不會涵蓋行動數據；同時設定它與用戶端 VPN 可能增加排錯難度。即使應用程式介面提供類似 TUN 的選項，也應依 iOS 版說明操作，不可照抄桌面版的虛擬網卡名稱、服務指令或路由參數。

規則模式、連線驗證與 DNS

先使用規則模式，確認需要手動選擇的代理群組已有可用出站。開啟一個依規則應使用代理的頁面，再查看應用程式提供的連線記錄或日誌。規則命中直連不代表 VPN 未啟用，這可能正是設定預期的結果。若頁面可正常開啟，但出站不如預期，請優先檢查規則順序，不要只憑連線圖示判斷分流是否正確。

啟用全域模式可暫時判斷規則是否造成差異，但不適合作為長期排錯方式。若切換全域模式後恢復正常，請比對原規則中的網域、規則集與兜底策略；若仍然失敗，再檢查出站、網路與 DNS。測試後請還原原本模式，避免原應直連的區域網路服務或工作應用程式改變連線路徑。

某些瀏覽器、網路隱私功能與自訂 DNS 設定可能使要求路徑偏離預期。先記錄裝置目前的設定，再逐項對照用戶端記錄。不要因為單一網站無法開啟，就同時修改系統 DNS、應用程式 DNS 與所有代理群組；即使問題消失，也無法得知原因。若出現憑證提示，更不應透過信任未知憑證來繞過一般連線故障。

背景執行、隨選連線與網路切換

VPN 網路延伸功能與主應用程式介面並非同一個生命週期，介面進入背景不一定代表連線中斷，強制關閉主應用程式也不能取代明確中斷連線。停止使用時，請透過應用程式或系統 VPN 開關確認連線已關閉。若應用程式提供隨選連線，啟用前請了解觸發條件，並觀察中斷後是否會再次依規則啟動，避免誤以為開關失效。

在 Wi-Fi、行動網路與個人熱點之間切換後，現有連線可能需要重新建立。先確認目前網路本身可否直接連線，再重新連接 VPN，接著發出新的要求。若只有特定 Wi-Fi 無法使用，請比對該網路的登入入口、DNS 或出站限制；先完成網路登入再測試代理，避免把尚未取得正常網路連線誤判為用戶端故障。

訂閱更新是否能在背景執行、是否必須讓應用程式保持在前景，取決於應用程式實作與系統排程。重要更新後請主動開啟應用程式，確認設定已載入，不要只憑排程設定就認定更新已完成。若某個出站在其他裝置可用、但在本機失敗，請比對通訊協定支援、設定格式與目前網路，而非直接刪除所有系統網路設定。

Linux 安裝與設定

分別選擇桌面用戶端與核心

前往Linux 用戶端專區，桌面環境可選擇 Clash Verge Rev 或 FlClash。伺服器、路由器與需要自行管理服務的使用者，可查看Mihomo 核心專區。圖形介面用戶端負責設定管理與狀態顯示，獨立核心則只負責執行設定；兩者的安裝與權限管理方式不同。初次使用不建議同時部署兩套並監聽相同連接埠。

先使用 uname -m 確認架構，再核對發行版採用的套件格式。常見的 x86_64 對應 AMD64，aarch64 通常對應 ARM64，但套件是否適用仍須依實際建置需求判斷。不要在缺少相應套件管理環境的系統上直接套用其他發行版的安裝指令，也不要假設所有 Linux 安裝套件都適用於無桌面伺服器。

使用發行版的套件管理工具安裝，有助於保留相依套件解析與解除安裝記錄。若提示缺少桌面元件、執行階段函式庫或系統匣支援，請先閱讀錯誤內容，再檢查目前的工作階段環境。Wayland、X11 與不同桌面的系統匣實作各異；視窗能執行但沒有系統匣圖示，不一定代表代理核心啟動失敗，請分別查看介面與核心記錄。

透過圖形介面匯入並設定桌面代理

在用戶端設定頁匯入訂閱並選取，確認核心成功載入後再開啟系統代理。Linux 沒有適用於所有桌面環境與程式的統一代理入口。GNOME、KDE 與命令列應用程式可能分別讀取桌面設定、環境變數或自身的代理設定，因此即使用戶端顯示系統代理已啟用，仍應針對目標應用程式進行驗證。

若瀏覽器使用獨立代理設定，請確認它是讀取系統設定還是手動指定位址。終端機程式可先透過明確指定代理的指令測試本機監聽是否可用，再決定是否設定環境變數。不要把同一組變數寫入所有啟動指令碼：桌面工作階段、互動式終端機與系統服務的環境繼承方式不同，設定位置錯誤會讓部分程式一直沿用舊代理。

以下範例假設混合連接埠已設為 7890，只會影響目前的 shell 與其後續啟動的子處理程序。NO_PROXY 用來提示支援此變數的程式略過本機位址，不代表核心中的完整直連規則。不同工具對變數大小寫與萬用字元寫法的支援各不相同，正式使用前仍應查閱工具文件。

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export NO_PROXY=localhost,127.0.0.1,::1

curl --proxy http://127.0.0.1:7890 --head https://example.com

unset HTTP_PROXY HTTPS_PROXY NO_PROXY

獨立核心設定檢查與 TUN 權限

使用 Mihomo 核心時，先準備完整設定與獨立資料目錄，再以一般使用者身分檢查設定。以下指令假設核心已安裝為 mihomo，且設定已儲存至指定路徑；它不會產生訂閱，也不會自動補齊代理群組。檢查通過只代表設定可供解析，遠端規則資源與實際出站仍須在執行後驗證。

mkdir -p "$HOME/.config/mihomo"
mihomo -t -d "$HOME/.config/mihomo" \
  -f "$HOME/.config/mihomo/config.yaml"

TUN 需要存取虛擬網卡裝置並修改路由，通常須具備網路管理權限，或使用受控的特權服務。若桌面用戶端提供服務安裝入口，請優先依其說明操作；自行部署服務時，應明確設定執行使用者、檔案權限與權限範圍。不要為了方便將整個設定目錄設為所有使用者均可寫入，也不要讓未知指令碼長期以最高權限執行。

容器、虛擬機器與主機屬於不同的網路環境。容器內的回送位址只指向容器本身，主機的本機代理不會自動提供給容器使用。若要共用監聽服務，請先規劃位址可達性、監聽範圍與防火牆規則，再考慮允許區域網路連線；直接將監聽擴大至所有介面，會讓原本僅限本機使用的服務暴露給其他裝置。

服務狀態、記錄與停止後的復原

背景服務啟動失敗時，先查看服務管理員回報與核心記錄，分辨是設定路徑錯誤、目錄無法讀取、連接埠占用還是權限不足。若圖形介面用戶端已啟動核心，又手動執行另一個處理程序，常會造成監聽衝突。修改設定後，請依實際部署方式重新載入或重新啟動；不要認為編輯檔案就會立即更新正在執行的核心。

啟用 TUN 後若區域網路、容器或虛擬機器網路異常，請檢查新增路由是否覆蓋原有私有網段，並確認 DNS 要求最後進入哪條解析流程。先停用 TUN 進行比對，同時保留一般代理測試；不要直接清除所有路由或防火牆規則，以免中斷遠端管理連線。操作伺服器前，請確保另有獨立的復原管道。

停用時要分別處理桌面代理設定、shell 環境變數與背景服務，三者不一定會自動同步。若只有某個終端機仍無法連線，可開啟新終端機並檢查環境繼承；若所有桌面應用程式都失敗，再檢查桌面網路設定。核心欄位相容性可繼續參閱mihomo 與原版 Clash 的設定差異，不要把舊欄位失效簡單歸咎於 Linux 發行版。

設定常見問題與排錯順序

已匯入設定，為什麼仍無法連線？

依序檢查設定載入、監聽入口、規則命中與遠端連線四個環節。先確認目前啟用的設定就是剛匯入的項目，再查看記錄是否有解析失敗或資源下載失敗。接著確認系統代理、VPN 或 TUN 已將目標應用程式的流量送入核心。連線頁完全沒有記錄時，先修正流量入口；有記錄後再檢查命中規則與最終出站，避免在錯誤的層級反覆切換選項。

若所有出站都失敗，先確認基本網路與訂閱狀態；若只有一個出站失敗，優先檢查該出站或其通訊協定支援。設定更新失敗與代理連線失敗也可能是兩條不同路徑：更新訂閱需要先取得遠端內容，但目前使用的舊設定可能仍可連線。不要因更新按鈕出現錯誤就立刻刪除唯一可用的設定，請先備份並保留錯誤資訊。

記錄用於定位問題環節，不宜長時間開啟過細的記錄等級。回報錯誤時只保留必要資訊，並隱藏訂閱網址、出站帳戶、個人網域與裝置資訊。針對同一個問題，記下測試時間、使用的網路、模式與是否啟用 TUN，比只說「無法連線」更有幫助。提交前請確認記錄對應本次新要求，而非上次啟動留下的舊錯誤。

規則、混合連接埠與 YAML 如何對應？

混合連接埠通常讓同一個本機監聽同時接受 HTTP 代理與 SOCKS 要求，不等於遠端伺服器的連接埠。規則由上而下比對，較具體的例外通常應放在前面，最後以兜底規則結尾。以下是一份僅用來驗證本機監聽的最小直連設定，不含遠端代理；它可獨立執行，但不會將要求轉送至遠端出站，也不應直接取代現有訂閱。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
  - DOMAIN-SUFFIX,localhost,DIRECT
  - IP-CIDR,127.0.0.0/8,DIRECT,no-resolve
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - MATCH,DIRECT

需要遠端代理時，應在完整設定中定義實際出站或代理群組，再讓規則參照正確名稱。範例中的私有位址規則只涵蓋列出的網段，不是適用所有區域網路的通用解法。YAML 使用空格縮排，清單前的連字號與欄位層級都很重要；不要混用定位字元。修改後先檢查設定，再重新載入；若檢查失敗，請還原上一份可用副本。

如何區分系統代理、TUN、DNS 與速度測試？

系統代理適用於遵循系統設定的應用程式；TUN 可擴大流量接管範圍，但也會帶來路由、權限與 DNS 配合問題。所有平台都不需要同時啟用兩者。Fake-IP 是 DNS 對應與連線還原機制，不是代理模式或加速選項。遇到區域網路網域、硬編碼 IP 或特殊應用程式相容性問題時，應依解析與連線記錄調整，不要只因看到相關術語就一律關閉。

瀏覽器的加密 DNS、作業系統解析器與用戶端 DNS 可能分別參與要求處理。只修改系統 DNS，不一定會改變瀏覽器的解析路徑；依網域比對的規則，也不保證用戶端總能取得網域名稱。請先確認要求攜帶的是網域名稱還是 IP，再檢查使用的解析與嗅探機制。沒有依據時，不要盲目疊加 DNS 劫持、嗅探與多組備用解析器。

節點延遲測試只反映特定時間發出的特定要求，不等於下載頻寬或所有網站的使用體驗。測試逾時也可能與測速網址、憑證、DNS 或連線重用有關。選擇出站時應綜合考量常用網站、穩定性與實際服務要求，原理請參閱節點延遲與實際網速的差異。更換出站後請重新建立連線，既有連線不一定會立即切換。

訂閱更新、區域網路共用與復原檢查

自動更新會重新取得訂閱內容，可能重設直接寫入產生檔案的規則。長期修改應放在用戶端支援的持續性擴充功能中，並確認合併後的順序。訂閱轉換會讓轉換服務取得設定內容，使用前請先了解其處理範圍；若能直接使用相容的訂閱，就不必增加轉換步驟。所謂免費節點也要確認來源、有效性與使用條件，用戶端無法替來源提供保證。

需要重新走一次最精簡的設定流程，可返回快速入門教學；需要更換用戶端，則可前往下載頁依平台選擇。保留一份已驗證的設定及相關操作記錄，比同時嘗試多組參數更能維持可復原的網路環境。