Clash 使用與設定完整手冊

第一章 · 核心概念與連線流程

用戶端、核心與設定檔各自負責什麼

Clash 生態系中的用戶端通常由圖形介面與代理核心組成。介面負責匯入設定、顯示代理群組、管理系統代理與記錄；核心則負責監聽本機連接埠、比對規則並建立連線。mihomo 是這個生態系中常見的核心。介面名稱相似，不代表搭載的核心、支援欄位及權限機制完全相同，因此移轉設定前，請先確認目標用戶端的說明。

設定檔是核心的運作指示，通常以 YAML 格式儲存，內容描述本機監聽連接埠、可用代理、代理群組、路由規則與 DNS 行為。訂閱通常是取得遠端設定的網址，不是用戶端本身，也不是開啟開關就能使用的服務。用戶端必須取得有效設定並啟用，而且應用程式的流量確實進入核心，後續規則與代理選擇才可能生效。

節點、代理群組與規則的關係

節點代表一個具體出口及其連線參數；代理群組則用來整理節點或其他代理群組，例如手動選擇，或定期測試後自動選擇。規則決定每條連線要交由哪個出口處理。網站連線異常時，先查看連線記錄命中哪條規則、送往哪個群組，再確認群組中實際選取的節點，會比反覆切換整份設定更容易找出原因。

瀏覽器連線可視為一連串處理流程：應用程式讀取系統代理或使用自身設定，將要求送至本機監聽連接埠；核心依據可取得的網域、位址與規則決定出口；選定的節點再與目標建立連線。流程中的每個環節都可能失敗。瀏覽器顯示逾時，只能表示連線未完成，不能單憑這個訊息判定訂閱失效、DNS 異常或伺服器無法使用。

系統代理與 TUN 位於不同層級

系統代理是供應用程式讀取的作業系統設定，不會強制所有程式遵循。TUN 則透過虛擬網路介面與路由接收流量，涉及額外權限、DNS 與路由設定。初次使用時，先用系統代理確認瀏覽器連線正常；只有確認確有應用程式繞過系統代理時，再評估是否使用 TUN，避免基本設定尚未可用，就同時排查多層網路行為。

本機連接埠也要分清楚。混合連接埠可接收 HTTP 與 SOCKS 代理要求；控制介面則供用戶端管理核心，兩者不能互換。若把瀏覽器代理位址設成控制介面位址，通常只會收到連線錯誤。日常使用時，優先讓用戶端自動設定系統代理，不要照抄其他裝置的連接埠；需要手動填寫時，請從目前的執行設定確認實際值。

最後要區分兩種「更新」：用戶端更新會替換程式及其核心；訂閱更新則會重新取得遠端設定內容。前者不一定能修復過期訂閱，後者也不會升級程式。記錄問題時，請分別註明這兩種變動，並保留故障發生前最後一次成功連線的條件，作為後續排查的重要基準。

第二章 · 依作業系統選擇用戶端

先確認裝置，再比較介面

選擇用戶端時，先考量作業系統、處理器架構及需要接管的應用程式，再比較介面偏好。初次安裝建議從下載頁的 Clash Plus開始；若要比較設定管理方式、桌面整合及核心設定入口，再參閱用戶端比較。不要只為了找出截圖中的某個開關，就同時安裝並執行多套網路接管工具。

在 Windows 的「設定 → 系統 → 系統資訊」查看系統類型，確認裝置使用的處理器架構；在 macOS 的「關於這台 Mac」查看晶片或處理器名稱。Apple Silicon 與 Intel 的安裝檔不能只靠檔案大小區分。請以下載頁提供的架構為準；若裝置不符，先確認是否支援，不要把其他平台的安裝包改名後嘗試執行。

設定相容性比外觀重要

即使使用相同平台，不同用戶端處理設定的方式也可能不同。有些會在訂閱之外再加一層覆寫，有些直接編輯本機檔案，有些則只接受特定格式。尤其 Surfboard，不能因為它出現在同一個下載頁，就認定它能直接讀取任意 Clash YAML。請先確認用戶端支援的設定類型，再向設定提供者取得相應內容，避免把格式錯誤誤判成網路故障。

桌面版若需要頻繁切換設定，可比較代理群組的顯示方式、覆寫入口、記錄匯出，以及退出時是否恢復代理等行為。手機版則應優先考量前景連線狀態、背景執行限制及依應用程式接管的方式。功能多不代表就適合目前的裝置；能穩定完成匯入、連線、驗證與退出後恢復的用戶端，才適合作為後續設定實驗的固定環境。

iPhone 可從下載頁前往 Clash Plus 的 App Store 頁面，也可透過官方網站 clashplus.io查看產品說明。下載後先熟悉設定清單與連線入口，再授權系統新增 VPN 設定。iOS 的背景執行與網路權限由系統管理，桌面版的服務安裝、系統匣與本機連接埠操作不能直接套用到手機。

已封存的用戶端與獨立核心

本網站將 Clash for Windows 與 ClashX Meta 列為已停止維護的封存用戶端，適合查閱既有環境的相容性，不建議作為新裝置的首選。舊教學中出現這些介面，不代表現在仍應沿用相同安裝流程。新裝置請先選擇仍在維護的用戶端，再將教學中的概念對應至現有選單，通常較能避免權限與設定相容問題。

獨立 mihomo 核心適合需要自行管理程序、設定目錄與網路規則的使用者。它不是完整桌面介面的替代安裝包，執行後也不會自動具備所有系統整合功能。伺服器、路由器等環境還需要設定服務啟動與存取控制；一般桌面使用者先採用圖形介面用戶端，就能專注處理設定本身，不必先應付程序守護與系統路由細節。

更換用戶端時，先關閉舊用戶端的系統代理與 TUN，再結束程式，之後啟動新用戶端。只移轉自己理解的設定、規則與覆寫，不要複製含義不明的執行目錄。移轉完成後重新檢查連接埠、代理群組選擇與 DNS 行為，因為相同訂閱在不同用戶端可能會套用不同預設值，連線結果未必完全一致。

第三章 · 安裝、權限與首次啟動

安裝前整理現有網路設定

開始安裝前，先結束現有的代理用戶端，並確認瀏覽器在原本網路下的連線狀況。若裝置先前使用手動代理，先記下位址與連接埠，再判斷是否需要關閉。如此一來，安裝後發生異常時，才能分辨是原有網路問題，還是新增設定造成的變化。工作或學校管理的裝置應遵循管理規定，不要繞過組織設定安裝系統服務。

從用戶端下載頁選擇符合作業系統與架構的檔案。Windows 依照安裝精靈完成安裝後，從開始功能表啟動；macOS 若下載的是磁碟映像檔，開啟後依提示將 App 移至「應用程式」資料夾，再從該資料夾執行。不要長期從暫存解壓縮資料夾或磁碟映像檔啟動，否則升級、輔助服務路徑及開機啟動項目可能不一致。

確認每項權限申請對應的功能

首次啟動時，先查看主介面、設定清單與記錄入口，不必急著允許所有權限。匯入一般設定與接管系統網路所需的權限不同：TUN 或服務模式可能需要管理員確認；通知權限則主要影響狀態提示。每次授權前，請確認系統視窗中的應用程式名稱及操作目的；若申請來自不熟悉的程式，先取消並核對安裝來源與目前操作。

macOS 出現無法開啟或系統延伸功能相關提示時，先確認檔案來源，再到系統設定中與「隱私權與安全性」相關的頁面查看原因，依照系統提供的方式處理。不要把停用整台裝置的安全機制當成一般安裝步驟。鑰匙圈或網路延伸功能授權與匯入一般訂閱是兩回事；若反覆跳出提示，請檢查 App 是否仍位於原安裝位置，以及輔助元件是否安裝完整。

Android 安裝後，先在用戶端匯入設定，再點選連線，並閱讀系統跳出的 VPN 連線確認視窗。若長時間執行時常被系統停止，可在電池與背景管理設定中檢查該 App 的限制，但不必一開始就更改所有省電選項。部分系統只允許一個一般 VPN 服務執行，啟動另一個 VPN App 可能會中斷目前連線，這不一定是用戶端本身故障。

iOS 同樣需要系統確認新增 VPN 設定；授權後返回用戶端，確認已選取設定，再開始連線。Linux 則應先確認發行版適用的套件格式，再透過桌面軟體安裝程式或發行版套件管理工具安裝，並留意缺少相依套件的具體提示。桌面程式啟動失敗與核心設定失敗應分開處理：前者先查看 App 啟動錯誤，後者再檢查設定與記錄。

建立首次啟動的檢查順序

尚未加入訂閱時，主介面顯示未連線或代理群組為空，通常屬於正常狀態。此時先找到設定、代理、連線與記錄四個頁面，確認程式能正常儲存設定。接著查看本機監聽連接埠，記下是否啟用系統代理及 TUN。首次測試只開啟系統代理，先關閉其他網路接管功能，讓下一章驗證訂閱時能清楚判斷原因。

在 Windows 中，可透過 PowerShell 查看範例連接埠是否正在監聽。以下數字僅作為查詢範例，請依用戶端實際設定調整；找到程序後，先用工作管理員確認是哪個程式，再正常結束，不要直接終止不熟悉的系統程序。沒有偵測到連接埠監聽，不代表網路一定無法使用，只表示目前查詢範圍內沒有找到相符的監聽項目。

Get-NetTCPConnection -LocalPort 7890 -State Listen

最後測試一次退出後的網路恢復：關閉系統代理與 TUN，結束用戶端，確認一般直接連線符合預期。若退出後瀏覽器持續顯示代理伺服器無法使用，請檢查系統是否仍保留指向本機的代理設定。先恢復網路入口，再重新啟動用戶端；安裝階段先確認能順利還原，比連線出問題後才臨時找開關可靠。

第四章 · 匯入訂閱與啟用設定

辨識訂閱連結與實際設定檔

訂閱連結通常由設定服務提供者產生，可能包含個人存取識別資訊，請妥善保管。不要將完整連結貼到公開截圖、線上轉換網站或問題回報中。本網站說明設定使用流程，不提供可長期依賴的公開訂閱。搜尋 Clash 免費節點時，也應先評估來源、有效期限與資料風險，不要把臨時取得的設定當成穩定的日常方案。

取得連結後，開啟用戶端的「設定」、「訂閱」或 Profile 頁面，選擇新增遠端設定，將網址貼到 URL 欄位，設定容易辨識的名稱，再點選匯入或下載。名稱可描述用途，例如「日常設定」，但不要包含存取識別資訊。完成後應看到設定項目、更新時間或可用的代理群組，而不只是尚未下載的空白項目。

下載成功後，還要啟用設定

匯入成功不代表執行中的設定已切換。在設定清單中選取剛匯入的項目，點選啟用、使用或相應的選取標記，再到代理頁面確認群組名稱與選項是否更新。有些用戶端會自動重新載入核心，有些則需要額外確認。若介面仍顯示舊代理群組，先回到設定頁確認啟用狀態，不要急著重新安裝用戶端或重複加入同一個訂閱。

匯入本機 YAML 適合已有檔案或需要離線編輯的情況。選擇「從檔案匯入」後，確認匯入的是設定檔本身，而不是壓縮檔、儲存的網頁或截圖。遠端設定通常可以取得更新，本機檔案則主要由使用者自行維護；修改磁碟上的原始檔案是否會同步到用戶端，取決於用戶端採用參照或複製方式，建議透過小幅修改並重新載入來確認。

若匯入時顯示格式錯誤，先查看錯誤位置與回應內容類型。訂閱網址可能回傳登入頁、存取限制說明或服務到期頁面；這些內容都不是 YAML，即使能在瀏覽器開啟，也無法供核心使用。也請確認貼上時沒有混入空格、換行或中文標點；不要把訂閱管理網站的網址當成實際設定網址，兩者通常不同。

了解 YAML 的結構要求

YAML 透過縮排表示層級，通常使用空格而非定位字元。同一層級的欄位必須對齊，清單項目的連字號位置也要一致。以下範例只展示基本設定片段，不含可用代理，不能單獨作為完整訂閱使用。這段內容用來協助辨識頂層欄位：模式、記錄層級與監聽設定彼此並列，不應縮排到某個代理節點內。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
ipv6: false

更新訂閱前，應先了解用戶端如何儲存設定。直接修改遠端設定中的規則，下一次更新可能會覆蓋變更；需要長期保留的本機調整，應使用用戶端支援的覆寫或合併機制。初期先不要加入複雜覆寫，確認原始訂閱能正常載入及連線後，再逐項加入自訂內容。每次新增後檢查最終生效設定，不要只看編輯欄位就以為已完成修改。

自動更新間隔不宜設得太短，一般使用可依提供者的建議設定。頻繁更新無法讓失效的服務恢復，還可能觸發存取限制。更新失敗時，不要立刻刪除最後一份可用設定；先保留目前內容，再單獨測試下載。若要進一步區分逾時、內容空白與格式錯誤，可依照訂閱解析錯誤自我檢查清單逐步排查。

若相同訂閱在舊用戶端可用、新用戶端卻出錯，優先比較核心支援的欄位與設定格式，不要公開分享完整設定求助。先匯出設定並遮蔽節點位址、驗證資訊與訂閱識別資訊，只保留錯誤附近的結構與錯誤文字，通常就足以判斷縮排、未知欄位或格式不相容問題。

第五章 · 代理模式與連線驗證

先分開檢查入口與出口

用戶端中的「規則、全域、直連」主要決定流量進入核心後如何選擇出口；系統代理與 TUN 則決定應用程式流量能否進入核心。切換至全域模式，不代表所有應用程式都會自動受到接管。驗證時先開啟用戶端的連線頁面，再用瀏覽器造訪明確的測試目標，觀察是否出現新連線；確認有記錄後，再檢查模式與節點選擇。

日常使用通常從規則模式開始。前往代理頁面找到主要選擇群組，手動選取已知可用的節點，再開啟系統代理。測試期間固定使用同一個瀏覽器與網址，先確認能否建立連線，再查看連線詳細資訊中的命中規則與實際出口。節點測試成功只代表某項測試要求已完成，不保證所有網站、通訊協定或長連線都能正常使用。

以全域模式進行有限度比較

特定目標在規則模式下連線失敗時，可暫時切換全域模式，並確認全域群組實際選取的節點。若入口與節點相同，全域模式可用而規則模式不可用，應優先檢查命中規則及目標策略群組。若兩種模式都失敗，則繼續檢查節點、名稱解析與上游網路。比較完成後請恢復規則模式，避免後續測試仍停留在暫時設定。

直連模式也不代表系統已完全恢復原狀。應用程式仍可能透過本機代理連接埠進入核心，DNS 與流量的處理方式也可能繼續受到用戶端影響。若要判斷完全退出後的網路狀況，應先關閉系統代理與 TUN，再結束用戶端進行獨立測試。把「核心直連」與「完全退出用戶端」視為兩種不同測試條件，才不會誤判故障範圍。

逐層排查沒有連線記錄的情況

瀏覽器連線時沒有新增記錄，先確認系統代理確實已啟用，且代理位址指向目前的監聽連接埠。瀏覽器擴充功能、自訂代理設定或應用程式內的網路設定可能會覆寫系統選擇；其他用戶端也可能剛修改過系統代理。暫時停用不必要的代理擴充功能，只保留一個用戶端執行，再重新送出要求，查看連線頁面是否有變化。

若有記錄但連線失敗，展開詳細資訊查看目標網域、目標連接埠、策略鏈與錯誤訊息。逾時、拒絕連線及解析失敗分別指向不同層次，不應一律用「換節點」處理。先用相同目標比較兩個已設定的出口，再以相同出口比較兩個目標。每次只改變一個條件，才能更清楚區分目標服務限制、單一節點問題與本機設定問題。

命令列程式不一定會讀取桌面系統代理。若要單獨驗證本機 HTTP 代理，可使用下方的要求指令；位址與連接埠須符合目前執行設定。範例網域僅用於說明測試方式，不保證目前網路一定能連線；命令收到回應，只能證明這次要求透過指定入口完成，不能取代檢查瀏覽器或其他應用程式的實際連線記錄。

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

切換模式或節點後，既有連線可能仍沿用原本的出口。若要確認新設定，請重新送出要求；必要時只關閉相關連線或重新開啟測試應用程式，不必直接清除所有系統網路設定。瀏覽器快取、連線重用與頁面離線內容也可能造成誤判；測試時應查看新建立的連線及其時間，而非只看已開啟的頁面是否仍能顯示。

本章結束時，應整理一份簡短基準：使用哪個用戶端、啟用哪份設定、選擇哪個群組與節點、透過哪種入口連線，以及哪個目標測試成功。保存這些條件，下一章修改規則後再重複測試。若只有特定情境出現速度問題，可接著閱讀連線速度分層排查，不要同時更換 DNS、模式與整份訂閱。

第六章 · 規則分流與設定順序

由上往下比對，優先命中

規則模式會依照由上而下的順序比對連線，通常在第一條符合的規則決定策略。範圍較明確的例外應放在較寬泛的規則之前，兜底規則則放在最後。新增規則後沒有作用，先檢查前面是否已有更早命中的項目，再確認目標名稱與策略群組是否正確。把同一條規則重複貼到清單末尾，無法改變已被前面規則攔截的連線。

網域規則適合依服務名稱分流，位址範圍規則則適合處理明確的 IP 網路範圍。網域後綴規則用來比對指定網域及其子網域，不應隨意改成關鍵字規則，否則可能擴大比對範圍。應用程式是否提供網域資訊給核心，也會影響網域規則能否使用；若連線頁面只顯示 IP，還需搭配 DNS 運作方式判斷，不能直接認定規則語法錯誤。

mode: rule
rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - MATCH,PROXY

這段規則是合併用範例，不包含完整代理定義。其中 DIRECT 是內建的直連策略；PROXY 必須與實際設定中的代理或代理群組名稱完全相同，若沒有這個名稱，請改用現有群組名稱。最後的 MATCH 會接收前面未命中的連線，不能放在其他規則之前。複製前先確認自己的群組名稱，不要只因範例格式完整，就用它覆蓋整份設定。

位址規則與名稱解析的界線

位址範圍規則中的前綴長度描述網路範圍，不是連接埠號碼。範例中的私有位址範圍用來說明區域網路直連概念，但實際住家或辦公室網路不一定使用相同網段，應依閘道器與裝置位址確認。不要隨意將範圍過大的公用 IP 網段加入直連清單；比對範圍過廣，可能讓原本需要代理的目標提早命中，造成部分網站間歇性無法使用。

no-resolve 表示這條位址規則不會為了比對而主動觸發網域解析，並非關閉整套 DNS。連線已有目標 IP 時，仍可依位址範圍判斷是否符合。是否加入這個設定，取決於規則目的與解析策略：若需要依解析後的位址分流，應先了解額外解析的影響；若只處理原本就是 IP 的連線，則可減少不必要的解析步驟。

遠端規則集與本機覆寫

規則變多後，可使用核心支援的規則提供器管理遠端或本機規則集。規則集內容格式必須符合宣告的類型，例如網域清單與完整規則清單不能混用；檔案能下載，不代表一定能解析。也要檢查引用名稱、快取路徑與更新時間，避免遠端下載失敗後誤以為已載入新規則，實際上仍使用舊快取。

圖形介面用戶端可能會將訂閱規則、本機覆寫與合併指令碼組合成最終設定。編輯器中的順序不一定等於核心實際讀取的順序。修改後應開啟最終設定或執行設定預覽，搜尋目標項目，確認位置與策略名稱；再到連線頁查看實際命中結果。建立「編輯、預覽、重新載入、驗證」的完整流程，比只看見儲存成功提示更可靠。

應用程式登入與網頁瀏覽使用不同出口時，應先確認實際連線目標。一項操作可能涉及驗證、資源與 API 等多個網域，不能只替網址列中的主網域加入規則。透過連線記錄逐一確認必要目標，優先採用範圍明確的規則；不要為了修復單次失敗就把所有流量切換到全域模式，這只會掩蓋規則缺漏，無法說明或解決問題。

維護規則的目標是容易理解，而非項目愈多愈好。為自訂例外註明用途與撤銷條件，過期後及時清理；訂閱本身若已包含相應規則，也要評估是否仍需要重複覆寫。本章結束後，應能根據連線目標、命中規則與策略鏈說明出口，而不是只憑頁面是否開啟來猜測分流結果。

第七章 · TUN、DNS 與路由接管

明確判斷啟用 TUN 的理由

TUN 透過虛擬網路介面接收流量，常用於不遵循系統代理的應用程式。它不是加速功能，也無法修復失效節點或錯誤訂閱。先確認第五章建立的系統代理基準可正常使用，再判斷目標應用程式是否確實沒有進入核心；若只是瀏覽器代理擴充功能設定錯誤，應先修正入口，不必直接引入虛擬網卡、系統路由與 DNS 接管。

啟用前記下目前的網路介面、其他 VPN 狀態，以及用戶端的關閉方式。桌面版可能需要安裝輔助服務或提高權限；行動裝置則由系統 VPN 介面管理。優先使用用戶端提供的 TUN 開關與預設參數，不要一邊開啟圖形介面的網路接管，一邊照著伺服器教學手動新增系統路由，以免產生重複規則或難以還原的狀態。

理解各欄位如何配合運作

tun:
  enable: true
  stack: mixed
  auto-route: true
  auto-detect-interface: true
  dns-hijack:
    - any:53

這是 mihomo TUN 設定片段，需合併至既有設定中，不能取代完整的 DNS 與代理定義。auto-route 控制自動路由，auto-detect-interface 用於自動偵測出站介面；通訊協定堆疊選項則應以目前核心支援的內容為準。有些用戶端會自動產生這些欄位，建議優先在介面中修改，避免檔案設定與介面設定互相覆蓋。

dns-hijack 中的範例用於攔截符合條件的一般 DNS 要求，不代表能接管所有加密解析方式或應用程式內建的解析機制。瀏覽器的安全 DNS、應用程式內的加密解析及企業內部網域，都可能改變最終觀察到的結果。先維持一套明確的解析方案，再確認網域是否進入預期的 DNS 流程；不要看到 DNS 字樣，就同時更換所有解析服務。

了解 fake-ip 與本機解析

fake-ip 模式會為網域回傳對應位址，由核心維護網域與連線之間的對應關係，方便後續分流。這類位址並非目標伺服器的真實公用位址，不能用來判斷網站位置或節點路線。少數依賴真實位址、本機探索或特定驗證方式的應用程式可能需要例外，應依用戶端與核心支援的過濾機制處理，而非全面關閉所有分流功能。

區域網路印表機、檔案分享與公司內部網域需要特別測試。它們可能依賴本機 DNS、特定網段路由或廣播探索，不能只靠一條公用網域規則解決。啟用 TUN 後，先測試閘道器、區域網路裝置與常用內部服務，再測試外部目標。若只有內部資源異常，應檢查直連路由與解析路徑，不要立刻將所有代理節點視為故障原因。

辨識衝突並安全還原

其他 VPN、虛擬機器網路、容器網橋或安全軟體也可能修改路由。若所有應用程式同時斷線，先關閉 TUN，確認原本網路能否恢復，再逐一排除衝突。在多網卡環境中，自動偵測出站介面不一定符合預期，尤其是有線與無線網路同時啟用時；需要手動指定介面，應使用裝置目前的實際名稱，不要照抄其他電腦的範例。

若瀏覽器可正常使用，但某個應用程式仍連線失敗，請檢查該應用程式使用的通訊協定、目標連接埠，以及節點是否支援相應傳輸方式。UDP 服務能否運作，也取決於節點能力、核心設定與上游網路；TUN 不會自動補足缺少的能力。查看連線詳細資訊，確認要求是否進入、使用哪種通訊協定，以及在哪個步驟發生錯誤，再決定要調整接管範圍還是更換測試出口。

測試結束後進行一次還原演練：關閉 TUN，確認虛擬介面與自動路由狀態符合用戶端預期，再恢復系統代理基準。裝置從睡眠喚醒、切換無線網路或重新插拔網路線後，也要重新檢查出站介面與解析是否正常。只有日常情境都穩定，才將 TUN 作為長期使用方式；否則，採用較簡單的網路入口會更容易維護。

第八章 · 更新、備份與故障維護

保存可供還原的設定基準

穩定運作後，記錄目前的用戶端、啟用的設定、主要代理群組選擇，以及系統代理與 TUN 狀態，並保存必要的本機覆寫。備份不只是複製訂閱網址，也應包含自行撰寫的規則及其合併方式。遠端訂閱可以重新取得，本機調整卻不一定有其他副本；若需要重新安裝用戶端，請先匯出這些內容，再處理程式檔案。

備份可能包含節點驗證資訊、訂閱識別資訊或控制介面設定，應存放於受控位置，不要上傳至公開程式碼儲存庫或公開雲端硬碟。截圖與記錄也可能洩露存取目標與裝置路徑，分享前請遮蔽相關欄位。排查問題需要的是結構、錯誤與發生順序，不需要公開完整帳戶資料；保留最少必要內容，通常也能讓問題描述更清楚。

將更新拆分成三個獨立步驟

用戶端升級、核心更新與訂閱刷新應分開執行並各自驗證。先記錄目前可用狀態，再完成其中一項，確認設定能否載入及常用目標能否連線，最後再進行下一項。如果一次更換程式、核心、訂閱與 DNS，即使問題有所改善，也很難找出真正原因，下次遇到類似問題時更難快速還原。

升級前先閱讀版本變更說明，尤其留意設定欄位、服務模式與預設行為的變化。不要只憑版本號判斷是否適合目前環境，也不必為了追求最新而任意替換用戶端核心檔案。部分圖形介面用戶端要求核心與介面搭配使用，手動替換後可能造成控制介面或設定產生方式不相容；優先使用用戶端正式提供的更新方式，並保留可供還原的本機設定。

依影響範圍縮小故障原因

發生故障時，先判斷影響範圍：是所有應用程式還是單一應用程式、是所有目標還是某個網域，以及切換網路後是否仍然發生。接著回到第五章的基準，固定設定與出口進行比較。若只有一個目標失敗，優先檢查規則、目標服務與出口限制；若所有要求都沒有記錄，優先檢查入口與程序；若記錄中集中出現解析錯誤，再排查 DNS。

需要詳細記錄時，可暫時提高記錄層級並重現一次最小操作，記下確切時間後，再恢復日常層級。長時間保留除錯記錄會增加儲存與檢索負擔，也可能留下更多連線細節。不要把數小時的記錄直接交給維護人員，應篩選故障前後相關片段，說明預期行為、實際狀況與已完成的比較測試。

速度變慢與完全無法連線應分開排查。下載工作、無線訊號、裝置負載、電信業者網路路徑與遠端壅塞都可能影響使用體驗，單次節點測試無法代表持續傳輸速度。固定相同測試目標、相近測試條件與出口，比較更換節點或網路後的變化；不要只看一次自動測速排名就頻繁切換，以免中斷長時間連線。

還原順序與定期整理

發生嚴重異常時，先關閉 TUN 與系統代理，恢復基本網路，再載入最後一份可用設定。若問題來自訂閱更新，可用保留的本機副本進行比較；若來自自訂覆寫，先停用該層，不要直接刪除整個用戶端。只有確認程式檔案或使用者目錄確實損壞時，才考慮重新安裝，並在清理前保存必要設定。

定期刪除不再使用的訂閱項目、失效規則與重複啟動項目，並確認是否仍有舊用戶端常駐。若不確定多份設定的用途、切換方式與更新策略，可閱讀Profile 與多設定檔管理筆記。維護不是每天調整參數，而是讓每次變更都有記錄、異常有證據、還原有明確流程。

第九章 · 從穩定設定到進階管理

先學會使用代理群組，不要複製整份設定

進階設定應從一份已驗證可用的設定開始。先了解代理群組之間如何引用，再學習自動選擇與故障切換；不要直接複製包含大量未知規則、指令碼與遠端資源的整份檔案。每新增一項功能，都應能說明它解決什麼問題、依賴哪些條件、如何驗證及如何撤銷，否則只會增加設定複雜度與後續排查成本。

手動選擇群組適合明確控制出口；自動測試群組可依指定的測試目標比較候選節點；故障切換群組則依自身邏輯尋找可用項目。測試目標應能代表想確認的連線狀況，但沒有任何單一位址能代表所有服務。若節點測試正常，但影片、遊戲或工作服務仍異常，應查看實際服務的連線狀況，不要把測試結果當成整體健康保證。

proxy-groups:
  - name: PROXY
    type: select
    proxies:
      - AUTO
      - DIRECT
  - name: AUTO
    type: url-test
    use:
      - daily
    url: https://example.com/
    interval: 600

此範例使用名為 daily 的代理提供器，必須先在完整設定中定義，不能只複製代理群組片段就期待節點出現。範例測試位址也應依實際連線狀況與用途調整。PROXY 引用 AUTO，只有選取 AUTO 時，流量才會交由該群組的選擇結果處理；介面中有自動群組，不代表所有連線都會自動使用它。

了解提供器與覆寫的維護界線

代理提供器適合將節點來源與本機策略分開管理；規則提供器則能將規則內容與主設定分離。兩者都會引入遠端取得、快取與格式相容性問題，應分別命名並明確標示用途。資源下載失敗時，先檢查本機是否有可用快取，再判斷是否影響啟動；不要讓所有資源都依賴同一條尚未建立的代理路徑，以免形成啟動相依循環。

覆寫適合保存個人策略，但合併方式由用戶端決定。清單可能被取代，也可能附加；指令碼還可能在合併後繼續修改內容，因此不能假設所有用戶端都使用相同順序。調整複雜設定前，先進行小型測試：加入容易辨識的群組或規則，查看最終設定中的位置與內容，再決定正式的整理方式，避免一開始就寫出大段難以驗證的邏輯。

控制介面與區域網路存取

外部控制介面用於管理核心，權限與一般代理入口不同。若不需要遠端管理，請維持僅限本機存取，不要隨意監聽所有網路介面。確實需要在區域網路管理時，應同時設定驗證、系統防火牆與來源限制，並確認管理頁面與介面的安全界線；不要只因介面無法開啟，就直接取消所有存取控制或將介面暴露於公用網路。

同樣地，啟用區域網路代理時，也要一併考量監聽位址、連接埠、存取裝置與防火牆。只修改 allow-lan 不保證其他裝置一定能連線，也不代表應讓所有網路都能存取。先在可信任的網路中用一台裝置測試，分清代理入口與控制介面的差異；離開該網路或改用公共 Wi-Fi 前，請關閉不再需要的分享功能。

建立可重複執行的測試方法

每次進階測試都要保留原始設定、副本與變更說明，並準備一組固定測試項目：一般網頁、需要分流的目標、區域網路服務與退出後還原。每修改 DNS、規則或 TUN 的任一層，都重新執行這組測試，記錄連線命中與錯誤變化。只有結果符合預期才保留修改，不要把「頁面偶爾能開啟」當成設定正確的唯一判準。

接下來不必繼續堆疊參數。若要在新裝置上重現基本流程，請回到快速入門指南；若要更換用戶端，請查看下載頁與用戶端比較；遇到特定情況，再參閱技術筆記。以穩定運作為基礎，只進行目的明確的變更，設定才能長期維持易懂、易管理。