全平台安裝與設定

準備工作與設定範圍

先確認裝置的作業系統、處理器架構和現有訂閱，再下載客戶端。桌面系統可在系統資訊中查看架構；手機則先確認系統版本與裝置型號。客戶端負責介面、設定管理和網路接管；mihomo 等核心負責解析設定並轉送連線，兩者不可混為一談。安裝介面正常，不代表訂閱可用；訂閱匯入成功，也不代表系統流量已進入核心。後續檢查時，需分別確認這三個環節。

選擇客戶端與訂閱格式

Windows、macOS、Android 和 iOS 可優先參考 Clash Plus；Linux 可選擇 Clash Verge Rev 或 FlClash。不同客戶端的功能入口和設定儲存方式各異。本指南以「設定」、「策略組」、「系統代理」等功能名稱說明操作，不把特定介面的按鈕位置當成通用標準。下載前也應確認維護狀態；Clash for Windows 和 ClashX Meta 已停止維護，僅供封存參考，不建議作為新裝置的預設選擇。

準備一組有權使用的訂閱連結或本機設定檔。訂閱網址可能包含可識別帳戶的資訊，請勿貼到公開討論區、截圖或線上轉換網站。完整的 Clash YAML 通常包含節點、策略組與規則；只有節點清單的內容，可能需要客戶端範本或由訂閱服務提供方輸出相容格式。遇到格式錯誤時，先確認下載內容是設定文字，而不是登入頁面、拒絕存取訊息或到期通知；不能只憑副檔名判斷內容。

釐清設定、模式與網路接管

將設定匯入清單後，還需選取並啟用該項目。接著進入策略組選擇出口，代理模式通常可先使用 Rule。Rule 依規則決定直連或代理；Global 會將進入核心的連線交由全域策略處理；Direct 則使用直連出口。這些模式決定的是流量進入核心後如何處理，不會將所有應用程式的流量送進核心。因此，切換到 Global 無法修復未啟用的系統代理，也不能取代 TUN 所需的系統權限。

保留可還原的基準設定

初次設定時只啟用一種接管方式，確認可用後再新增功能。記下原有的系統代理、其他 VPN 狀態和客戶端連接埠；不要同時修改 DNS、TUN、規則和訂閱，否則發生問題時很難判斷原因。複製一份設定檔用於測試，日常使用的訂閱則保留原始項目。訂閱自動更新可能覆蓋直接編輯的內容；需要保留的修改應放在客戶端支援的覆寫、合併或指令碼設定中，並確認這些設定確實套用到執行中的設定。

完成後，分別造訪一個明確應走代理的網站和一個應直連的網站，並在連線頁面確認目標網域、符合的規則和最終出口。延遲測試只是單次探測結果，不能證明所有應用流量都能正常通過。需要逐步操作時，請參閱訂閱匯入步驟；不清楚術語時，可查閱策略組說明，再繼續閱讀對應平台的章節。

Windows 安裝與網路接管

前往Windows 客戶端下載區，優先參考 Clash Plus，並依裝置架構選擇安裝套件。在 Windows「設定 → 系統 → 系統資訊」中可查看處理器和系統類型。x64 和 ARM64 不能任意互換；即使某些應用程式能透過相容層啟動，其網路服務元件也未必相容。安裝前請先結束舊客戶端，尤其是仍在系統匣執行的程式，避免兩套程式爭用本機監聽連接埠，或反覆改寫系統代理設定。

完成安裝並確認核心正常執行

依照安裝精靈完成部署，再從開始功能表啟動程式。若使用免安裝版本，請先解壓縮至固定位置，不要直接從壓縮檔預覽中執行，也不要長期放在可能遭清除的暫存資料夾。首次啟動後，查看狀態頁或日誌，確認核心沒有持續結束執行。若程式視窗能開啟但核心啟動失敗，應先查看錯誤訊息中的路徑、連接埠或設定欄位；重複按下連線通常無法解決這類問題。

網路服務元件的安裝與一般介面的啟動是兩回事。客戶端提示安裝服務時，先確認提示確實來自目前使用的程式，再依系統要求授權。沒有管理員權限的工作裝置可先嘗試使用系統代理，但不應為了安裝驅動程式或服務而規避組織政策。若遭安全軟體攔截，請查看事件詳細資料並確認遭攔截的檔案及其來源，不要把關閉整套防護當成固定安裝步驟。升級前記下設定目錄和覆寫內容，避免將解除安裝時的清理誤認為一般更新。

匯入訂閱並啟用系統代理

在設定或訂閱頁面選擇透過 URL 匯入，貼上完整網址並儲存，再執行更新。下載成功後選取該設定，再進入策略組選擇可用出口。若匯入的是本機 YAML，請使用檔案匯入功能，不要把檔案路徑填入訂閱 URL。QR Code 只是另一種輸入網址的方式，仍需確認來源。三種匯入方式的差異，請參閱URL、QR Code 與本機 YAML 匯入說明。

先維持 Rule 模式，開啟客戶端的系統代理，再到 Windows 代理設定中確認代理位址指向本機，且連接埠與執行中的設定一致。常見的本機位址是 127.0.0.1，但連接埠應以客戶端實際顯示為準。瀏覽器擴充功能可能另有代理規則；排查時先停用重複接管的擴充功能，關閉舊頁面連線後再重新造訪。只觀察網頁能否開啟還不夠，也應在客戶端的連線清單中找到對應請求。

TUN 權限與常見衝突

遇到不遵循系統代理的應用程式，再考慮啟用 TUN。依照客戶端提示安裝或啟用服務，並確認虛擬網路介面和路由已成功建立。首次測試時可先關閉系統代理，只保留 TUN 這一種接管方式；確認可用後，再依客戶端建議搭配使用。啟用後若所有網站都無法連線，請立即停用 TUN，並檢查是否同時執行其他 VPN、虛擬機器網路工具或全域流量過濾程式。裝置能否恢復直連，是判斷問題出在網路接管還是上游節點的重要線索。

netstat -ano | findstr ":7890"
netsh winhttp show proxy

第一個指令用來查看範例連接埠是否被占用；若有輸出，還需搭配監聽狀態和處理程序編號確認所屬程式。第二個指令會查看 WinHTTP 代理設定；它和目前使用者的系統代理不是同一套設定，因此顯示直接存取，不能單獨證明客戶端的系統代理開關失效。不要為了讓兩處顯示一致而盲目修改 WinHTTP；只有明確依賴它的程式才需要另行設定，並應記下還原方式。

結束客戶端後，若瀏覽器仍顯示代理連線失敗，請回到 Windows 代理設定確認是否殘留本機代理。若只在睡眠喚醒或切換網路後出錯，先重新建立連線、檢查客戶端服務狀態，再重新啟用網路接管。不要直接刪除所有設定；保留原始日誌和一次失敗請求的時間點，能更快判斷問題出在本機連接埠、DNS、規則還是節點出口。

macOS 安裝與權限

前往macOS 下載區選擇 Clash Plus，並依「關於這台 Mac」顯示的晶片類型，區分 Apple Silicon 與 Intel 安裝套件。Clash Verge Rev 和 FlClash 也可作為其他介面選擇；ClashX Meta 則是封存客戶端。不要只憑應用程式圖示或檔名中的 Mac 字樣判斷架構。換用其他客戶端前，先關閉原程式的系統代理和背景服務；否則新程式即使正常啟動，網路設定仍可能由舊程式控制。

安裝至固定位置並完成授權

開啟下載的磁碟映像檔後，將應用程式拖曳至「應用程式」資料夾，再從該資料夾啟動。不要長期從已掛載的映像檔執行；系統重新啟動或退出映像檔後，登入項目和輔助程式可能會找不到原本的路徑。系統顯示下載來源提示時，先確認下載位置和應用程式身分，再到「隱私權與安全性」查看可採取的操作。不要把移除安全屬性或關閉系統安全機制當成通用安裝方法；明確的授權提示和來源不明的檔案應分別處理。

輔助服務、網路延伸功能或 VPN 設定的授權都屬於系統層級變更，提示方式取決於客戶端實作。依照目前應用程式的指引完成授權後，回到客戶端確認服務已就緒，不要只看系統提示視窗是否消失。受裝置管理限制的電腦可能不允許使用者核准網路元件，此時應遵循管理政策。安裝失敗時，記下系統提示原文、應用程式所在路徑和晶片類型；單純重裝相同檔案通常無法解決權限範圍問題。

匯入設定並檢查目前使用的網路服務

在設定管理中加入訂閱 URL，更新後啟用該項目，再選擇策略組出口。初次使用時，先透過系統代理測試瀏覽器連線，並保持其他 VPN 關閉。macOS 的代理設定會與特定網路服務關聯；Wi-Fi、乙太網路和擴充基座上的網卡，可能各自對應不同服務。換網後若代理失效，應檢查目前使用中的網路服務，而不是只查看曾設定過的 Wi-Fi 項目。即使客戶端提供自動設定系統代理的功能，也要確認它操作的是目前使用的服務。

scutil --proxy
networksetup -listallnetworkservices

scutil --proxy 可用來查看系統代理資訊，另一個指令則會列出網路服務名稱。檢查時應確認啟用狀態、代理伺服器和連接埠是否與客戶端一致。終端機中的命令列程式未必會讀取這些系統設定；某個瀏覽器可用但指令無法連線，不能直接歸因於節點異常。先確認程式支援的代理方式，再使用對應的環境變數或指令參數，避免將 HTTP 代理位址填入不支援該通訊協定的欄位。

TUN、睡眠喚醒與設定保留

需要接管更多應用程式時，再啟用 TUN 並依客戶端要求核准相關服務。若啟動日誌顯示權限不足、建立裝置失敗或設定路由失敗，應先處理對應的系統操作，不要反覆更換訂閱。TUN 建立後還要確認 DNS 是否走預期路徑；虛擬介面存在，不代表網域解析已經正確。企業 VPN、虛擬化軟體和其他網路延伸功能可能同時修改路由，測試時一次只保留必要元件，才能找出衝突來源。

修改設定時，要區分訂閱原始檔和執行時產生的檔案。前者可能在訂閱更新時被取代；後者則可能在每次啟動時重新產生。直接修改其中任何一個，都不一定能保留長期設定。優先使用客戶端提供的持久化覆寫功能，套用後檢查最終設定。升級前備份訂閱來源、覆寫內容和必要的本機規則。訂閱網址應視為敏感資訊妥善保存，不要將整個設定目錄同步至公開儲存庫。

解除安裝或更換客戶端前，先關閉系統代理和 TUN，再結束應用程式。如果只將應用程式移至垃圾桶，已核准的網路設定或背景輔助元件不一定會一併移除；應使用客戶端提供的服務解除安裝功能，並在系統網路設定中檢查殘留項目。恢復直連後再啟動替代客戶端，可避免兩個程式互相覆蓋代理狀態，也能清楚判斷新問題從哪個步驟開始。

Android 安裝與背景執行

前往Android 下載區優先選擇 Clash Plus，也可依設定相容性選擇 Clash Meta for Android、FlClash 或 Surfboard。新型裝置通常採用 ARM64，但仍應以裝置架構和安裝套件說明為準。較舊的裝置可能需要其他架構或通用套件，不能靠反覆安裝不同檔案來取代確認。若系統提示與已安裝的應用程式衝突，先查看應用程式名稱、套件來源和簽章相關訊息，備份設定後再決定是否更換安裝來源。

安裝授權與本機 VPN 機制

透過瀏覽器或檔案管理員開啟安裝套件時，系統可能會要求允許此來源安裝應用程式。只授權目前實際使用的來源，安裝完成後即可恢復原有的限制。若安裝失敗，先檢查儲存空間、系統相容性要求，以及是否正在覆蓋不同簽章的安裝版本。解除安裝會影響應用程式的私有資料；未備份訂閱和覆寫內容前，不要把解除安裝當成第一個處理步驟。本機 YAML 也應另存至容易辨識的資料夾，避免清理下載檔案時一併刪除。

首次啟動代理服務時，Android 會要求建立 VPN 連線。這是透過系統介面建立本機虛擬網路通道的授權，並不代表訂閱服務提供方已完成設定。手機上的其他 VPN、部分防火牆和網路過濾應用程式也可能使用相同系統功能，通常無法同時各自獨立占用。若發現另一個應用程式中斷連線，先檢查目前的 VPN 狀態，不要誤以為是 Clash 強制關閉或節點不穩。

啟用訂閱與指定應用程式範圍

在設定清單中新增遠端訂閱，填入名稱和完整網址；更新成功後，將其設為目前使用的設定，再前往策略組選擇出口。使用 QR Code 匯入時，請確認掃描結果是預期的訂閱網址；截圖若包含完整網址，請勿直接上傳求助。匯入成功但清單中沒有可用策略組，可能是訂閱只有節點資料，或需要客戶端範本才能相容。Surfboard 的設定格式不等同於 Clash YAML；更換客戶端前，請先確認訂閱服務提供方是否支援相應格式。

啟動連線後，先測試瀏覽器請求，再查看連線日誌。行動裝置通常透過 VPN 接管流量，不必照搬桌面版的系統 HTTP 代理步驟。若客戶端提供指定應用程式代理功能，請確認目前選的是「僅代理所選應用程式」還是「排除所選應用程式」；兩者意思相反，選錯後可能出現瀏覽器可用、目標應用程式卻沒有連線紀錄的情況。變更範圍後，請完全結束目標應用程式再重新啟動，既有連線不一定會立即切換。

電池限制、網路切換與自動啟動

若鎖定螢幕後斷線、亮起螢幕後又恢復，優先檢查系統對背景執行、電池用量和自動啟動的限制。各品牌裝置的設定位置不同，請從應用程式資訊頁面查看相關選項，依實際需要允許客戶端持續執行。背景工作清單中的鎖定、通知顯示和電池最佳化是不同機制；只開啟其中一項，不能假設其他限制也已解除。也不要對所有應用程式一律放寬限制；先確認問題是否確實由背景程式遭系統回收造成，再只調整代理客戶端。

從 Wi-Fi 切換到行動網路後，原有連線可能中斷，應用程式需要重新建立工作階段。若只在行動網路下失敗，請檢查該應用程式是否被禁止使用行動數據、訂閱更新是否需要目前的網路，以及節點使用的通訊協定能否在該網路運作。Android 私人 DNS 和客戶端 DNS 設定可能同時參與解析；遇到網域異常時，記錄兩邊的狀態，逐項進行可還原的對照測試，不要一次關閉所有解析功能。

排查應用程式異常時，先確認該應用程式是否在代理範圍內，再查看是否出現對應的網域連線紀錄；有紀錄但出口錯誤，接著檢查規則；出口正確但仍失敗，才進一步測試節點、DNS 和應用程式本身的網路需求。延遲數值正常也不能排除特定連線受限。訂閱更新失敗也應與代理連線失敗分開處理，原因可參考訂閱更新失敗與自動重新整理設定，避免反覆刪除並重建仍有效的設定。

iOS 安裝與 VPN 設定

iOS 建議使用 Clash Plus，透過App Store 的 Clash Plus 頁面安裝，產品資訊可至官方網站 clashplus.io查詢。安裝前請查看 App Store 顯示的裝置相容性要求，並確認裝置有足夠的可用儲存空間。安裝應用程式和啟用網路代理是兩個獨立步驟；首次開啟時，先熟悉設定管理和連線入口。沒有有效訂閱時，不要反覆核准或刪除系統 VPN 設定。

匯入訂閱並啟用設定

準備與客戶端相容的訂閱 URL，透過設定管理中的連結入口新增。貼上後確認網址前後沒有空格、換行或聊天軟體附加的標點；含有帳戶參數的網址應完整保留。更新成功後選取該設定，確認策略組是否如預期顯示，再選擇可用出口。若要從檔案匯入 YAML，請透過客戶端提供的檔案選擇或分享功能開啟；匯入後仍須啟用，檔案儲存在手機上不代表客戶端已開始使用。

訂閱連結和節點分享連結的結構可能不同。單一節點不一定包含完整規則和策略組，因此不能將所有匯入入口視為可互換的文字欄位。若服務提供方提供專用客戶端連結，應先確認連結最後對應的設定格式。下載失敗時，先確認是網址無法存取、內容不相容，還是訂閱已失效；反覆切換 Rule 和 Global 不會改變訂閱伺服器傳回的檔案內容，也無法解決誤把登入頁面當成設定檔的問題。

核准 VPN 並確認實際出口

首次啟動連線時，依系統提示允許新增 VPN 設定，並完成裝置要求的身分驗證。這項授權可讓客戶端建立系統網路通道，但不代表所有網域都會走代理。進入應用程式後維持 Rule 模式，造訪測試網站，再回到連線紀錄查看符合的規則和出口。狀態列或系統設定顯示 VPN 已連線，只能證明通道處於連線狀態；設定中的規則仍可能選擇直連，選取的節點也可能無法完成特定請求。

若同時使用企業 VPN、其他代理應用程式或網路過濾工具，先確認目前是哪一項設定正在建立連線。切換前先關閉原有連線，再啟動 Clash Plus，避免誤判系統目前狀態。按需連線等系統行為也可能在網路變更後重新啟用原設定，應搭配系統 VPN 設定一併確認。受管理裝置的網路政策可能限制修改；遇到限制時應遵循裝置管理規定，不要試圖刪除管理設定來恢復個人代理。

背景執行、DNS 與區域網路存取

iOS 的網路延伸功能和應用程式介面並非處於相同的執行狀態；離開介面不一定代表代理已停止，反之，應用程式仍顯示在多工畫面中，也不能證明連線有效。判斷時應以目前 VPN 狀態和新產生的連線紀錄為準。不要靠一直停留在介面中來避免斷線；先查看是否發生訂閱更新錯誤、網路延伸功能結束或網路切換。若系統限制應用程式使用行動數據，也應依客戶端的實際狀況檢查，不要只在 Wi-Fi 下反覆測試。

區域網路裝置、印表機和本機服務無法存取時，先確認目標位址是否符合代理規則，以及客戶端是否提供略過區域網路或相關路由選項。新增直連規則前先確認網段來源，不要將整段陌生位址範圍設為直連。網域可以解析但裝置仍無法開啟，也可能涉及本機網路存取權限、目標連接埠或區域網路隔離；不能只靠能否開啟網頁來判斷。每次變更後重新建立連線，再核對實際符合的規則。

自動更新間隔應依訂閱服務提供方的要求及客戶端支援情況設定。行動作業系統會排程背景工作，因此設定更新間隔不代表每次都能在指定時間完成重新整理。外出前可手動更新一次，確認設定仍可啟用；切換設定前，先保留可用項目。若連線後某個應用程式仍然失敗，請依序確認「是否出現新請求、規則是否正確、出口是否可用」，不要直接重新安裝。更完整的連線測試步驟請參閱首次連線與代理生效檢查。

Linux 桌面與核心部署

Linux 桌面使用者可先查看Clash Verge Rev 與 FlClash；伺服器或路由器使用者則可查看mihomo 核心。圖形客戶端通常整合設定、系統匣和服務管理；獨立執行核心則需自行規劃設定目錄、程序管理、日誌和網路接管。不要在同一目錄混用圖形客戶端管理的檔案和手動部署檔案，也不要讓兩個核心同時監聽相同的位址和連接埠。

確認架構與安裝相依套件

使用 uname -m 查看處理器架構，再依 Linux 發行版選擇套件格式。Debian、Ubuntu 等系統通常使用 deb 套件；採用 RPM 套件管理系統的發行版則應選擇對應套件。套件格式相同，不代表執行相依套件也完全相同。下載頁未提供的架構，不應透過修改檔名偽裝成相容版本。透過發行版的套件管理工具安裝本機套件，可清楚顯示相依性錯誤；缺少元件時，應使用目前系統的軟體來源解決，不要任意複製其他發行版的動態函式庫。

圖形程式無法啟動時，可從終端機執行對應程式查看錯誤輸出，先釐清問題出在顯示環境、桌面整合還是核心設定。遠端 SSH 工作階段沒有完整桌面環境，不適合直接照搬桌面客戶端的操作方式。伺服器通常只需要核心和明確設定的應用程式代理；是否需要 TUN，取決於要接管的流量範圍，並非部署成功的必要條件。安裝系統服務前，先確認執行使用者和設定路徑，避免依賴暫存下載目錄。

圖形客戶端匯入設定與桌面代理

在圖形客戶端中匯入訂閱、更新並啟用，再選擇策略組出口。開啟系統代理後，GNOME、KDE 和個別應用程式讀取代理設定的方式可能不同；桌面環境中的某個開關不會自動套用到每個終端機程式。先確認瀏覽器連線是否出現在連線清單中，再為需要代理的命令列工具個別設定。支援標準環境變數的程式，可先在目前的 shell 工作階段暫時設定代理；確認可用後，再決定是否寫入永久設定。

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

# 結束目前 shell 工作階段的暫時代理設定
unset http_proxy https_proxy no_proxy

上述範例的前提是本機 HTTP 或混合代理確實在範例連接埠上監聽。https_proxy 中的 HTTP 位址表示連線至代理所使用的通訊協定，並不是將目標 HTTPS 降級為一般 HTTP。不同程式對環境變數名稱、大小寫和 SOCKS 的支援各異，應以程式說明為準。新開啟的終端機和已啟動的服務不會自動取得之後才設定的變數；因此瀏覽器、終端機和系統服務都需要分別驗證，不能只測試其中一處就認定所有程式都已生效。

獨立核心、權限與服務範圍

獨立使用 mihomo 時，先解壓縮符合架構的核心，準備專用設定目錄，並將實際設定檔儲存為該目錄中的 config.yaml。下方指令假設可執行檔位於目前目錄，設定檔已放入使用者目錄下的 mihomo-config。先檢查語法，再於前景啟動並觀察日誌；確認監聽正常後，才考慮交由服務管理器執行。語法檢查通過只代表設定可解析，不能證明節點、規則引用或遠端資源都能存取。

chmod +x ./mihomo
./mihomo -t -d "$HOME/mihomo-config"
./mihomo -d "$HOME/mihomo-config"

若要建立 systemd 服務，應使用固定的絕對路徑，並明確指定工作目錄、執行使用者和重新啟動策略。一般本機代理未必需要管理員權限；建立 TUN 介面、修改路由和接管 DNS，則可能需要相應權限或能力。不要為了省事而以 root 身分執行所有圖形介面。服務在背景啟動失敗時，應查看服務日誌，重點檢查設定目錄權限和資源檔案路徑；前景執行成功，不代表改由服務使用者執行時也能讀取相同檔案。

啟用 TUN 後，檢查預設路由、DNS 管理方式和其他 VPN 狀態。NetworkManager、systemd-resolved 和客戶端可能各自管理網路的一部分；直接覆寫解析設定檔，可能在重新連線後失效。先確認由哪個元件管理 DNS，再使用相應的整合方式。伺服器也應檢查防火牆：本機代理和控制介面預設僅供本機使用，不應為了方便遠端操作就直接向公網開放。停止服務後，確認路由和解析已還原，再進行下一次接管測試。

檢查設定並排查問題

從一筆可重現的失敗請求開始排查：記錄目標網域、發生時間、目前使用的設定和接管方式，再確認連線是否進入核心。沒有連線紀錄時，優先檢查系統代理、應用程式代理和 TUN 範圍；有紀錄但出口錯誤時，檢查規則順序和策略組；出口正確但請求失敗時，再檢查節點、DNS 和目標服務。若只有訂閱更新失敗，而舊設定仍可使用，應先檢查訂閱取得流程，不要把兩類問題混為「無法連線」。

連接埠設定與控制介面

mixed-port 是同時接收 HTTP 和 SOCKS 代理請求的監聽連接埠；external-controller 是控制介面，不是代理流量使用的連接埠。讓瀏覽器連到控制介面會造成錯誤，切換策略模式也無法修復。以下是方便檢查的基本設定片段，套用前須合併至完整設定；此片段只有直連出口，沒有提供代理節點。連接埠號碼僅供示範；若已被占用，應在執行設定、系統代理和應用程式代理中一致調整。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
external-controller: 127.0.0.1:9090

proxy-groups:
  - name: LOCAL
    type: select
    proxies:
      - DIRECT

rules:
  - DOMAIN-SUFFIX,example.com,LOCAL
  - GEOIP,CN,DIRECT
  - MATCH,DIRECT

監聽位址和允許區域網路存取與安全性有關，不是加速選項。只在本機使用時，保留迴路位址存取即可；若確實需要向信任的裝置提供代理，還要檢查繫結位址、身分驗證、防火牆和目前所在的網路。尤其不要因為控制介面無法連線，就直接開放至所有網路介面。確認監聽衝突時，先找出占用連接埠的程序並判斷是否為舊核心，再決定停止舊程式或更換連接埠；不要任意結束無法辨識的系統程序。

規則順序、DNS 與 Fake-IP

規則通常依序比對；較具體的規則應放在相關的預設規則之前，MATCH 通常放在最後。規則引用的策略組名稱必須存在，拼字和大小寫也必須一致。訂閱中包含某個節點，不代表規則會自動使用它；流量最後走哪個出口，還取決於符合的策略組及該組目前選取的出口。修改後請重新建立目標連線；舊的長連線可能仍使用原本的出口。操作步驟可參閱規則分流設定。

Fake-IP 使用保留位址與網域建立對應，規則判斷仍仰賴核心掌握的網域資訊。看到回傳位址不是常見的公網位址，不能據此判斷解析失敗。若確有相容性問題，請將需要特殊處理的網域加入適當的過濾設定，並確認目前核心使用的過濾模式；不要直接複製大段來源不明的清單。系統快取、瀏覽器內建解析和客戶端 DNS 可能形成多條解析路徑，排查時一次只修改一項。詳細原理請參閱Fake-IP DNS 對應說明。

GeoIP 更新與設定覆寫

先確認設定使用的是傳統 GeoIP 資料檔，還是啟用了 geodata 模式；兩種模式需要的資源和路徑不同。介面上的更新操作是否會覆蓋目前使用的資料，應搭配日誌和執行設定確認。更新 GeoIP 無法解決所有規則問題：網域規則可能較早符合，規則集也可能有自己的更新週期，部分比對寫法還會影響是否執行解析。資料庫讀取失敗時，應檢查下載是否完成、目錄權限和設定路徑，而不是只反覆重新啟動。

資源更新和訂閱更新也應分開記錄。遠端規則集更新失敗時，先確認存取路徑和快取是否可用；直接更換訂閱不一定會改變規則集狀態。需要長期保留的自訂規則應寫入覆寫設定，並在訂閱更新後檢查最終執行內容。YAML 使用空格縮排，清單、鍵名和巢狀層級都必須正確。即使語法檢查通過，仍應查看啟動日誌，確認遠端引用和規則組確實載入成功。

如果修改後完全無法連線，先關閉目前的網路接管，恢復可用的直連狀態，再還原最後一項變更。完整排查順序請參閱已連線但網頁無法開啟的逐步排查清單；一般問題可查閱常見問題。恢復後重新測試直連和代理目標，確認問題確實排除，而不是剛好命中瀏覽器快取或仍在使用舊連線。