Clash 全平台
安裝設定指南

一、安裝 Clash 前的通用準備

先分清用戶端、核心與訂閱

用戶端負責提供介面、儲存設定、啟動核心及要求系統權限；核心負責解析規則、建立代理連線及處理 DNS。訂閱則是提供設定的方式，通常包含節點、策略組與規則，也可能只有代理清單。三者並不相同。安裝用戶端不會自動取得可用代理，匯入連結也不代表目前使用的核心支援其中所有欄位。

新安裝建議先到安裝檔下載頁選擇 Clash Plus，再依需求比較其他用戶端。Clash for Windows 已停止維護，適合查閱既有環境的舊資料；不要因為熟悉舊教學而忽略維護狀態。各用戶端的按鈕名稱可能不同，本手冊以「設定管理、策略選擇、流量接管」說明操作；若介面出現 Profiles、Proxies 等英文名稱，請依功能對照查找。

確認裝置架構與設定來源

下載前先確認作業系統、處理器架構及軟體需求。桌上型裝置不能只看品牌判斷架構，手機也不能只依 Android 版本判斷安裝檔類型。請選擇與裝置資訊相符的下載平台及架構。升級既有用戶端前，記下目前的用戶端名稱、設定來源與接管方式，並匯出需要保留的設定，避免把移轉問題誤認為網路問題。

訂閱連結通常含有存取憑證，應從自己的服務帳戶取得。請勿將完整連結貼到公開留言、截圖或記錄分享頁面。匯入前確認服務說明提供的是 Clash 或目標用戶端支援的格式，而非一般網頁網址、登入頁面或其他軟體專用連結。服務到期、方案流量用盡或連結遭重設，也可能導致匯入或連線失敗；重新安裝用戶端無法解決這些問題。

了解三種流量入口的適用範圍

首次設定建議先使用較簡單的入口。桌面版可先確認本機代理連接埠與系統代理；若確有應用程式不遵循代理設定，再考慮使用 TUN。行動裝置通常透過系統 VPN 介面接管流量。VPN 圖示表示本機網路流量已由介面接管，不代表用戶端自動提供遠端服務。TUN 也不是代理模式；啟用後仍須由 Rule、Global 或 Direct 決定流量策略。

依固定順序完成首次驗證

建議依序安裝並啟動用戶端、匯入設定、選取設定、檢查策略組、啟用一種接管方式，最後使用實際應用程式驗證。每個步驟都應有可觀察的結果：設定已顯示名稱、策略組可供選擇、核心正常執行，且能在連線記錄中找到請求。只看系統匣圖示或 VPN 標誌，無法確認遠端連線已成功；也不要同時啟動多個用戶端來「提高成功率」。

驗證時先開啟平常可直接連線的網站，確認基本網路正常，再測試需要代理的目標。接著查看請求符合哪條規則、使用哪個策略。策略選擇成功不代表網域解析正常，瀏覽器可用也不代表命令列已使用代理。分別檢查這些環節，才能將問題限縮在單一層次，避免每次失敗就同時修改 DNS、連接埠與節點。

結束用戶端前，先關閉由它設定的系統代理或網路接管，尤其是準備改用其他用戶端時。記錄正常狀態下的連接埠、策略與接管方式，比保存整張節點截圖更有助於排查問題。後續章節沿用這套驗證流程，並補充各平台的安裝、權限與背景執行差異。

二、Windows 安裝、系統代理與 TUN

選擇安裝檔並完成首次啟動

在Windows 安裝檔中，建議優先選擇 Clash Plus；其他選項包括 Clash Verge Rev、FlClash 與 Clash Nyanpasu。Clash for Windows 則保留為已停止維護的封存用戶端。先到系統「設定 → 系統 → 系統資訊」確認系統類型，再依下載頁列出的架構選擇安裝檔。x64 與 ARM64 並非可任意互換的標示。

安裝程式請依照精靈完成安裝；若下載的是壓縮檔，先解壓縮至固定資料夾，再啟動主程式，不要直接從壓縮軟體的暫存目錄執行。首次啟動若出現安全警告，先確認檔案來源與發行者資訊，不應以關閉所有系統防護作為處理方式。一般操作不需全程以系統管理員身分執行；安裝服務、虛擬網卡與修改路由則可能需要額外授權。

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

開啟設定管理頁面，貼上服務提供的訂閱網址並匯入；在 Clash for Windows 中，對應的是 Profiles 頁面的下載入口。匯入後選取該設定，等待核心載入。若只看到設定名稱卻沒有策略組，先查看解析記錄，確認回傳內容不是登入頁面，也不是只有代理清單、卻被當成完整設定使用的檔案。不要反覆按匯入來代替錯誤檢查。

進入代理或策略組頁面，日常使用通常選擇規則模式，再於手動選擇組指定可用策略。自動策略組的結果取決於設定中的測試網址與參數，不代表每個實際網站都能連線。開啟目標應用程式後，回到連線記錄查看符合的規則與出口；若沒有任何新記錄，先確認應用程式是否連上本機代理，不要立刻更換節點。

先用系統代理確認本機連接埠

確認用戶端顯示的 HTTP 或 mixed 監聽連接埠，再啟用 System Proxy。範例中的 7890 並非所有用戶端的固定值，請以目前設定為準。Windows 系統代理、瀏覽器獨立代理擴充功能與應用程式內建代理可能同時存在，測試時盡量只保留一個明確入口。啟用區域網路存取並非本機上網的必要條件；不需分享時請保持關閉。

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

上方指令僅適用於本機監聽連接埠確為 7890，且支援 HTTP 代理的情況。明確指定代理可避開應用程式是否讀取系統設定的差異。若顯示無法連線至本機連接埠，請檢查核心是否執行、監聽位址是否正確，以及連接埠是否遭占用；若已連上本機代理但遠端連線失敗，再檢查策略、服務狀態與 DNS。終端機是否會自動使用系統代理，視個別工具而定。

需要使用 TUN 時，再檢查服務與權限

若目標應用程式不遵循系統代理，或需要接管特定 UDP 流量，再依用戶端說明安裝服務並啟用 TUN。舊版 Clash for Windows 的 Service Mode 與 TUN Mode 需分別檢查，其他用戶端也可能使用自己的服務機制。授權後確認虛擬介面、路由與 DNS 設定已生效。開關顯示為開啟，只代表介面狀態，不能取代實際連線測試。

企業 VPN、虛擬機器網路、容器網路與其他代理都可能變更路由。啟用 TUN 後若無法連線區域網路裝置，先關閉 TUN 進行對照測試，再檢查私有網段的略過設定與現有路由。不要直接刪除不熟悉的虛擬網卡。電腦從休眠喚醒後失去連線，可先重新啟動核心並再次啟用接管；若問題一再發生，再對照記錄檢查介面變化。

處理退出後殘留設定與舊用戶端移轉

用戶端異常結束後，若瀏覽器提示無法連線至代理伺服器，請開啟 Windows 的「網路和網際網路」代理設定，確認是否仍指向已停止監聽的本機連接埠。先還原系統網路，再重新啟動用戶端。不要任意切換「自動偵測設定」、「使用設定指令碼」與「手動設定代理」；先記下原始設定，尤其是組織管理的裝置，以免覆蓋管理者下發的設定。

從 Clash for Windows 移轉時，建議重新匯入原始訂閱，再逐項移轉規則與覆寫設定；不建議直接覆蓋新用戶端的資料目錄。核心差異可能使舊欄位失效，TUN 參數也可能不同。先讓新用戶端以預設接管方式正常運作，再還原開機啟動等便利設定。若長期保留兩個用戶端，請確保同一時間只有一個負責系統代理或 TUN。

三、macOS 安裝、授權與網路擴充功能

依處理器類型選擇用戶端

開啟 Apple 選單中的「關於這台 Mac」，確認裝置使用 Apple 晶片或 Intel 處理器，再前往macOS 安裝檔選擇對應版本。優先推薦 Clash Plus，也可選擇 Clash Verge Rev 或 FlClash；ClashX Meta 則是已停止維護的封存用戶端。不要因為舊文章使用某個介面，就將其中的安裝步驟照搬到所有用戶端。

若下載的是磁碟映像檔，開啟後依照提示將應用程式拖入「應用程式」資料夾，再從該資料夾啟動。直接從映像檔或暫存下載資料夾執行，可能影響更新、輔助元件路徑與權限記錄。首次啟動遭系統阻擋時，先確認下載來源與應用程式身分，再查看「系統設定 → 隱私權與安全性」中的相關提示；不要先執行遞迴修改權限或停用系統安全機制的指令。

分清代理授權、輔助服務與網路擴充功能

macOS 用戶端可能會要求變更網路代理、安裝輔助服務或加入網路擴充功能；這些是不同的功能，並非每款用戶端都會全部使用。只啟用系統代理所需的權限，可能與執行 TUN 不同。授權提示應在剛執行相關操作後出現，且應與應用程式名稱相符；若提示來源不明，先取消，再回到用戶端操作一次，確認提示由何者觸發。

網路擴充功能的核准位置可能因系統版本與用戶端實作而異，請依應用程式提示前往系統設定查看。核准後，有些服務需要重新連線，有些則需要重新啟動應用程式。不要將「已允許擴充功能」與「代理已連線」混為一談。受管理的電腦可能透過描述檔限制網路擴充功能，此時應遵循裝置管理政策，不要反覆安裝或嘗試繞過權限限制。

匯入設定並確認策略選擇

在設定頁面新增訂閱網址，匯入後明確選取要使用的設定。若用戶端同時支援遠端訂閱與本機檔案，先確認目前正在編輯哪一份，避免修改了本機檔案，實際執行的卻是另一份遠端設定。匯入後查看策略組是否出現、是否已選取規則模式，再選擇可用策略。訂閱更新失敗時保留現有設定，有助於分辨原有連線問題與更新請求問題。

驗證時先用瀏覽器開啟目標，再檢查連線記錄。部分應用程式有獨立網路設定，瀏覽器擴充功能也可能覆蓋系統代理。若瀏覽器可連線但終端機不行，先為指令明確指定代理進行測試；若只有特定應用程式失敗，檢查其代理、憑證或網路權限。不要因一款應用程式失敗，就立刻修改整個系統的 DNS 或所有網路服務順序。

分開測試系統代理與 TUN

啟用系統代理後，可在目前網路服務的代理設定中確認目標位址與連接埠。切換 Wi-Fi、有線網卡或擴充基座網路後，使用中的網路服務可能改變，原本生效的代理設定未必會套用至新服務。請重新確認目前使用的網路，而不只是查看用戶端開關。系統代理只適用於遵循該設定的應用程式，無法保證接管每個處理程序與所有通訊協定。

啟用 TUN 前，先關閉其他負責路由接管的工具，並確認用戶端的輔助服務或擴充功能正常運作。TUN 失效時，先比對關閉後的網路狀態，再查看 DNS 與路由記錄。若遠端桌面、區域網路印表機或網路儲存裝置受到影響，請檢查區域網路略過設定與私有位址規則；不要為了開啟單一網站，就將所有本機網路強制轉送至遠端代理。

處理應用程式異常與網路切換

「應用程式已損毀」是系統提示，不代表檔案一定真的損毀或一定安全。先確認是否選錯處理器架構、下載是否完成、應用程式是否來自已確認的來源，再查看開發者發布說明。涉及隔離屬性或系統擴充功能的操作前，應先了解影響範圍。權限處理方式請參閱macOS 網路擴充功能與鑰匙圈設定；不要把網路上的單行指令當成所有提示的通用解法。

升級或移轉前，先匯出設定與自訂覆寫。更換用戶端後，先在舊用戶端關閉系統代理並停止接管，再啟用新用戶端。掀開筆電、從睡眠喚醒、切換熱點或連上公司網路後，先確認基本網路與入口網站驗證是否完成；必要時暫時中斷代理以完成驗證，再重新連線。這樣可避免將網路入口尚未放行誤判為訂閱節點故障。

四、Android 安裝、VPN 授權與背景執行

選擇安裝檔與用戶端

前往Android 安裝檔，建議優先選擇 Clash Plus；其他選項包括 Clash Meta for Android、FlClash 與 Surfboard。裝置架構會影響可安裝的應用程式 ABI，不能只憑手機外觀或處理器行銷名稱判斷。若安裝檔不相容，先查看裝置資訊與下載頁提供的版本類型；不要反覆下載同一檔案，也不要直接將安裝失敗解讀為網路遭封鎖。

透過瀏覽器或檔案管理員安裝時，系統可能要求允許目前來源安裝應用程式。只對實際使用的來源授權，安裝完成後可視需要關閉。安裝程式若提示應用程式衝突，請確認裝置上是否已有相同套件名稱、但簽章不同的應用程式。解除安裝舊應用程式可能一併刪除設定與本機資料，請先備份；不了解原因時，不要直接清除資料來處理所有安裝提示。

確認訂閱格式後再匯入

開啟設定管理入口，選擇從連結匯入，貼上自己的訂閱並儲存。設定下載完成後，還要選取並啟用，不能只停留在下載清單。Clash Meta for Android、FlClash 與 Surfboard 的設定格式並不完全相同，尤其不能預設 Surfboard 可匯入 Clash YAML；使用 Surfboard 時，請向服務提供者取得相容格式，再依該用戶端的流程操作。

若匯入時發生錯誤，先確認連結是否完整、有沒有多複製空格，以及回傳內容是否為預期的設定。行動網路與 Wi-Fi 下的結果不同，可能與目前網路的 DNS、入口網站驗證或連線限制有關。先保留錯誤提示，再換一個可信任的網路進行比對。不要將訂閱連結貼到公開的線上轉換網站排查；若連結外洩，請至服務帳戶重設。

了解 VpnService 授權與系統狀態

首次啟用流量接管時，Android 會顯示 VPN 連線要求。Clash 類用戶端通常透過 VpnService 建立本機虛擬介面，再將流量交由核心處理。核准後，狀態列出現 VPN 圖示，表示介面已建立，不代表遠端代理可用。還要確認設定是否載入、策略是否選妥，以及目標請求能否得到回應，才能判斷連線是否成功。

一般個人設定通常只能有一個作用中的 VPN 服務。公司 VPN、其他代理用戶端或使用 VPN 介面的過濾工具，可能會互相取代。若啟動後立即停止，先檢查系統中是否有其他 VPN 正在連線。不要同時開啟多個應用程式反覆搶用介面；若需存取企業網路，先了解公司的 VPN 使用規範，再決定採用哪種接管方式。

設定背景執行，同時保留必要限制

若螢幕關閉一段時間後連線中斷，請前往系統應用程式設定，檢查電池最佳化、背景執行與自動啟動權限。各廠牌的選單名稱不同，應從應用程式的電池管理頁面查找，不要照搬其他手機的選單路徑。可放寬目前使用的用戶端之背景限制；同時確認系統的省流量模式未禁止它在背景使用網路，避免只有螢幕亮起時才恢復連線。

前景服務通知有助於維持流量接管狀態，不建議只為隱藏狀態提示而停用相關服務。鎖定最近使用的應用程式只是部分系統提供的輔助措施，不能取代背景權限。若仍會斷線，記錄問題發生在螢幕關閉、切換網路或系統清理之後，再查看記錄。更多設定建議請參閱Android VpnService 與電池最佳化排除指南；請針對問題調整，不要一次關閉所有系統限制。

個別應用程式代理與網路切換

若用戶端支援依應用程式接管，先確認「僅限所選應用程式」與「略過所選應用程式」的差異，兩者方向相反。修改後可能需要重新連線，才能更新介面設定。若個別應用程式無法連線，先確認它是否遭排除，再檢查規則與 DNS。系統下載元件、瀏覽器與應用程式內網頁可能使用不同處理程序，不能只憑應用程式圖示判斷所有請求都走同一路徑。

從 Wi-Fi 切換至行動數據後，既有連線可能需要重新建立。先等網路穩定，再重新連線用戶端，確認新請求是否恢復。連上飯店、機場等需要網頁驗證的網路時，請先完成入口網站登入。若啟用系統的「永遠開啟 VPN」以及封鎖未經 VPN 的連線，中斷用戶端期間可能連驗證頁也無法開啟；調整前先了解這些設定對整台裝置的影響。

行動裝置不要照搬桌面版 System Proxy 開關的教學。Android 的主要流量接管方式、權限提示與背景生命週期都與桌面版不同。完成設定後，分別測試前景瀏覽、螢幕關閉後恢復，以及網路切換，確認都能正常運作，再逐項加入依應用程式設定的規則等自訂項目，方便找出行為改變的原因。

五、iOS 安裝、訂閱與隧道連線

從 App Store 安裝 Clash Plus

iPhone 與 iPad 建議優先選擇 Clash Plus。可先查看iOS 用戶端下載入口，再前往 App Store 的 Clash Plus 頁面；開發者官方網站為 clashplus.io。安裝前請先閱讀商店頁面的系統需求與應用程式說明；不要只憑搜尋結果中的相似名稱判斷應用程式身分。

iOS 會管理應用程式的網路擴充功能與 VPN 設定，桌面系統的安裝服務、接管連接埠步驟不能直接套用到手機。使用本手冊時，可將流程理解為「匯入相容設定、選擇策略、核准系統隧道、驗證實際請求」。用戶端介面可能隨更新調整，請依目前頁面的功能名稱操作，不必尋找與舊截圖完全相同的位置或圖示。

匯入訂閱並保護帳戶資訊

從服務帳戶複製相容的訂閱，返回應用程式的設定或訂閱管理入口貼上並儲存。部分網頁會嘗試開啟應用程式匯入；跳轉後仍須確認來源、設定名稱與內容，不要因為應用程式已開啟，就認為匯入已完成。若應用程式需要讀取剪貼簿，系統可能會顯示提示；確認複製的是自己的連結後再允許，避免將其他文字誤存為設定。

訂閱網址通常不同於網頁登入網址；若複製的是必須先登入才能檢視的網頁，通常只會下載到頁面內容。匯入失敗時，先確認格式與帳戶狀態，再嘗試重新整理。完整連結可能含有存取憑證，不應放在公開備忘錄或分享截圖中。向他人求助時可描述錯誤類型與操作步驟，但請遮蔽網址中的個人識別資訊與憑證。

核准 VPN 設定並開始連線

首次啟動連線時，系統可能詢問是否允許新增 VPN 設定，並要求驗證裝置身分。這是在系統中登錄網路接管設定，不是要求使用者將裝置密碼交給訂閱服務。核准後返回應用程式，確認目前設定與策略組，再啟動連線。若裝置由組織管理、安裝了受限制的描述檔，或已有其他 VPN 正在執行，連線可能受系統政策影響。

狀態列或控制中心的 VPN 圖示表示系統隧道已啟用，但不能單獨證明規則、DNS 與遠端服務都正常。驗證時應實際開啟目標、查看連線記錄並確認策略。若連線一直轉圈，先查看應用程式顯示的錯誤，再到系統 VPN 設定確認是否有衝突。不要連續新增多個用途相同的項目，以免增加後續判斷難度。

了解規則模式與行動裝置流量接管

日常使用可先選擇規則模式，讓設定中的規則決定哪些請求直連、哪些使用代理。全域模式通常會將進入核心的請求交由全域策略處理，但不代表能接管系統所有行為，也無法修復失效節點。直連模式則適合用來比對。三種模式的差異請參閱規則、全域與直連模式說明；切換後請觀察新連線，不要只重新整理仍在重用舊連線的頁面。

iOS 網路擴充功能受系統生命週期與權限限制，不應期待它與桌面版背景程序完全相同。離開應用程式介面不代表隧道停止，應以系統與用戶端狀態為準，確認連線是否持續。遇到低電量、網路變更或擴充功能異常時，先在應用程式內查看連線狀態並重新建立隧道，避免一再強制關閉應用程式來嘗試恢復。

處理個人熱點、入口網站與單一應用程式異常

從 Wi-Fi 切換至行動網路時，既有連線可能中斷並重新建立。先確認行動數據可用，而且用戶端具備所需的網路權限，再重新連線。個人熱點其他裝置的流量是否經過手機隧道，取決於系統與應用程式功能；手機本身可用，不代表熱點裝置也已使用代理。請在熱點裝置上分別測試，必要時直接在該裝置安裝並設定用戶端。

遇到需要網頁登入的公共網路，先完成入口驗證，再恢復隧道。若只有某個應用程式無法開啟，請檢查網路權限、帳戶狀態與符合的規則，不要只靠切換模式判斷問題。系統隱私網路功能、既有的加密 DNS 設定與組織管理設定，也可能改變請求路徑。請一次只調整一項並記下原始設定，以保留可還原的基準。

將設定移轉至另一台裝置時，先確認新裝置的服務授權與系統需求。重新匯入訂閱比複製來源不明的整套應用程式資料更容易確認。匯入後再檢查策略選擇與隨選連線設定，不要假設這些本機偏好會隨訂閱一併移轉；訂閱負責提供設定，系統權限仍須在每台裝置上分別核准。

六、Linux 安裝、桌面代理與服務執行

先區分桌面使用與伺服器部署

桌面使用者可在Linux 安裝檔中選擇 Clash Verge Rev 或 FlClash，並依發行版與下載頁提供的格式安裝。伺服器、路由器及需要自行管理程序的使用者，可查看Mihomo 核心區。圖形介面用戶端已處理設定路徑、程序啟動與部分授權；直接部署核心則需自行處理這些項目，兩者的排查方式不同。

先使用 uname -m 查看機器架構，再確認發行版、套件格式與相依需求。副檔名相同不代表適用於所有發行版，不能將 RPM 套件當成 Debian 套件安裝。圖形桌面應用程式應盡量以一般使用者身分執行；需要網路管理權限時，請使用用戶端明確提供的授權機制，不建議為了省事而長期以 root 身分執行整個桌面介面。

透過套件管理工具安裝並查看輸出

安裝前先切換至存放安裝檔的資料夾，確認檔名與架構，再使用目前發行版支援的套件管理工具。遇到相依性提示時，先閱讀輸出，不要隨意下載來源不明的函式庫來覆蓋系統目錄。安裝成功卻無法開啟視窗，也可能與顯示工作階段、圖形相依套件或執行環境有關，不能據此判斷訂閱失效。先從終端機啟動應用程式，保留實際錯誤訊息再處理。

uname -m
cat /etc/os-release
ss -lntp

這些指令可協助確認架構、發行版資訊與 TCP 監聽狀態，不會自動設定代理。一般使用者權限執行 ss 時，可能只會顯示部分程序資訊，但仍可確認本機連接埠是否正在監聽。分享輸出前，請遮蔽個人路徑、主機名稱與敏感位址。若連接埠衝突，先找出占用它的服務，再決定是否修改目前用戶端的連接埠；不要直接終止不熟悉的系統程序。

匯入設定並設定桌面代理

在圖形介面用戶端中先加入相容訂閱、選取設定並檢查策略組，再啟用需要的接管方式。Linux 各桌面環境的系統代理機制不盡相同：有些應用程式會讀取桌面設定，有些只讀取環境變數，還有些提供獨立的代理設定。因此，開啟桌面代理不代表所有終端機指令、套件管理工具與背景服務都會自動使用相同設定。

curl --proxy http://127.0.0.1:7890 https://example.com/
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

僅在本機連接埠為 7890 且支援 HTTP 代理時，使用這組範例。環境變數只會影響目前 shell 後續啟動、且支援這些變數的程序，不會修改已在執行的應用程式。https_proxy 中的代理位址仍可使用 HTTP 通訊協定，因為它描述的是連往代理的連線方式。測試結束後，可使用 unset http_proxy https_proxy 清除目前工作階段的設定。

TUN 須留意權限、路由與 DNS 管理工具

Linux 的 TUN 通常涉及虛擬介面、路由表與相應的網路權限。圖形介面用戶端可能提供服務模式；直接執行核心則需依部署環境設定權限，不要原封不動套用其他系統的參數。啟用後先確認介面與路由是否建立，再檢查 DNS 請求的流向。容器、網路命名空間與主機的範圍各不相同，在容器內啟動不代表主機流量也已接管。

NetworkManager、systemd-resolved 或發行版內建工具可能共同管理 DNS。直接覆寫 /etc/resolv.conf 常會在網路切換時被重新建立，也可能破壞原有的連結關係。請先確認該檔案由哪個工具管理，再透過相應機制調整。透過 SSH 遠端操作時尤其要小心：修改預設路由或防火牆前，應保留現有工作階段並準備獨立的復原管道，避免管理連線也一併中斷。

直接執行核心時明確指定設定目錄

使用 Mihomo 時，設定檔、規則資料與執行目錄應各有明確用途。可先將核心放入可執行路徑，把自己的設定存至固定目錄，再以前景方式檢查。以下範例使用使用者設定目錄，前提是該目錄已建立，且其中已有有效的 config.yaml。確認測試成功後再考慮改為服務執行，避免背景重新啟動掩蓋真正的解析錯誤。

mihomo -t -d "$HOME/.config/mihomo"
mihomo -d "$HOME/.config/mihomo"

若要長時間執行，可使用系統服務管理程序，但必須明確指定執行使用者、工作目錄、設定路徑與所需權限。服務啟動成功只代表程序已執行，還須查看核心記錄是否已完成設定載入。修改設定後先檢查語法，再依實際部署方式重新載入。停止服務後，也要還原由服務設定的路由或代理；不能只刪除執行檔，就認為網路狀態已恢復。

七、設定檔、DNS 與連線問題排查

從最小設定了解欄位用途

設定出錯時，先分辨語法錯誤與語意不相容。YAML 仰賴縮排，通常使用空格而非定位字元；同層級欄位的縮排應一致，清單項目前則有連字號。即使成功解析，也不代表目前使用的核心支援所有功能。以下片段用來說明本機入口、模式與最終規則，只會直連且不含遠端代理，不能當成可用的節點設定。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
  - MATCH,DIRECT

mixed-port 提供相容 HTTP 與 SOCKS 的本機混合入口；allow-lan 控制是否允許區域網路存取相關監聽服務，實際能否連線仍受綁定位址與防火牆影響；mode 決定策略處理方式。規則依序比對，MATCH,DIRECT 是最後的直連兜底規則。新增自訂規則時，應放在兜底規則之前，否則後續規則就無法處理已符合的請求。

分開管理訂閱更新與 Mixin 覆寫

遠端訂閱最好保留為上游來源，自訂欄位則透過用戶端支援的 Mixin、合併或覆寫功能管理。各用戶端對陣列的處理方式可能是附加、取代或特殊合併，行為並不一致，不能只憑功能名稱推測。尤其是規則清單與策略組，合併錯誤可能導致組名不存在、兜底規則位置改變，或整組定義遭覆蓋。修改後應檢查最終生效的設定，而不只是編輯欄位中的內容。

若更新後才開始發生故障，先比對更新前後使用的設定與覆寫，不要立刻清除所有資料。訂閱可能變更策略組名稱，自訂規則仍引用舊名稱就會出錯。自動策略組的參數也應依用途設定，請參閱url-test、fallback 與 load-balance 比較。要還原時，先停用最近新增的覆寫，再逐項確認，方便找出最小的故障範圍。

DNS 排查先看解析路徑，再更換伺服器

DNS 錯誤可能發生在系統、應用程式、核心或遠端等不同環節。網域無法開啟但已知 IP 可連線，只能作為線索，不能直接證明某台 DNS 伺服器失效。先查看記錄，確認是解析失敗、本機入口失敗還是遠端逾時，再確認 DNS 請求是否進入核心。應用程式內建的加密 DNS 可能走獨立路徑；TUN 的 DNS 劫持設定也不代表所有加密解析都會自動被接管。

fake-ip 使用合成位址讓核心保留網域關聯，並非遠端網站的真實位址；redir-host 則採用不同的對應方式，相容性表現也不同。遇到區域網路網域或特定應用程式異常時，應依症狀檢查過濾與解析設定，不要只是不斷更換公共 DNS。nameserver、fallback 與過濾規則的搭配方式，請參閱Clash DNS 設定詳解；修改前先確認目前核心支援相關欄位。

依請求流向安排排查順序

先確認基本網路，再檢查本機入口、設定載入、規則、遠端連線與 DNS。每次只變更一個項目，並以相同目標重複測試。瀏覽器可能快取解析結果並重用連線，切換模式後應建立新連線，否則看到的可能仍是舊路徑。暫時提高記錄層級後應及時還原；分享記錄時請刪除訂閱、憑證及可識別個人瀏覽活動的資訊。

常見設定問題的處理方式

若要重新建立清楚的驗證流程，請返回快速入門教學依序操作；需要更換用戶端時，先在安裝檔下載頁確認平台與維護狀態。設定可以逐步調整，但復原方式應始終明確：保留原始訂閱、記錄本機變更、停止舊接管，再啟用新設定。