Clash 全平台
安裝設定指南

01 · 通用準備事項

認識用戶端、核心與訂閱

Clash 用戶端提供設定管理、模式選擇、連線記錄及系統整合；核心負責解析規則並建立連線；訂閱則由設定提供者提供，通常包含節點、策略群組與規則。安裝用戶端不會自動取得可用節點，匯入訂閱也不代表系統流量已交由用戶端接管。排查問題時，請將這三者分開確認：先確認設定能否載入，再確認所選出站是否可連線，最後檢查應用程式是否將流量交給用戶端。

本站優先推薦適用平台上的 Clash Plus，其他用戶端可依作業系統與使用習慣選擇。mihomo 是 Clash 生態系中持續發展的核心之一，但不代表所有用戶端都支援相同欄位。行動版的設定解析器、桌面版的核心版本及介面功能可能有所不同。將設定移轉至其他裝置前，請先確認訂閱提供者提供的格式，再檢查目標用戶端是否支援相關通訊協定、規則類型與 DNS 選項。

確認系統架構與安裝來源

開啟系統的裝置資訊或關於頁面，記下作業系統、處理器架構及剩餘儲存空間。桌上型裝置常見 x64、ARM64；Mac 還需區分 Intel 與 Apple Silicon；Linux 則有不同的套件格式。請勿只憑電腦品牌選擇安裝套件。前往用戶端下載頁面查看對應平台的下載選項；最低系統需求請以所選用戶端的實際發行說明為準，不要直接套用其他用戶端的需求。

正式安裝前，請先結束舊代理程式，並記下目前的系統代理、DNS 與其他 VPN 狀態。企業裝置可能透過管理政策鎖定這些設定，請先確認權限範圍。建議將現有設定匯出至本機私人資料夾，保留可供復原的副本；請勿將包含訂閱網址的截圖、設定檔或 QR code 上傳至公開討論區。訂閱網址中的存取參數通常等同憑證，若外洩，請至提供者處重新產生。

確認設定來源與流量接管方式

遠端訂閱方便日後更新，本機 YAML 適合保留固定設定；Base64 編碼的節點清單不一定是完整的 Clash 設定檔。匯入時若提示缺少欄位，請先確認格式，不要任意刪除錯誤行。只有在確認來源可信且了解資料處理方式後，才使用轉換工具。若要比較這三種來源，請參閱訂閱 URL、YAML 與 Base64 格式說明。

系統代理只是將代理位址提供給應用程式，無法強制所有處理程序遵循。TUN 透過虛擬介面與路由處理流量，通常需要額外權限，也較容易與其他 VPN 衝突。初次設定請先使用用戶端建議的預設方式，確認可正常連線後再擴充功能。切換方式時一次只修改一項，並記下記錄中的時間點，否則難以判斷變動來自節點、DNS 解析還是路由。

建立可重複驗證的基準

準備一個穩定的直連網站，以及一個明確需要指定出站的網站，分別記錄是否能解析、是否能開啟，以及記錄中的規則命中結果。首次使用時採用規則模式，並在策略群組中手動選定可用出站，避免自動選擇掩蓋問題。瀏覽器快取、既有長連線與應用程式的獨立代理設定都可能影響驗證；修改設定後請建立新連線再觀察，不要只憑重新整理一次頁面就認定網路已全面恢復。

用戶端不會改變目標服務的存取政策。使用前請遵守所在地法律、機構網路規範及服務條款。若已完成準備，只想快速連線，可前往快速入門教學；若要處理特定平台的權限、背景執行或路由問題，請直接前往下方對應章節，完成後再依最後一章的順序驗證。

02 · Windows 安裝與代理

選擇安裝套件並完成首次啟動

先在設定的系統資訊中確認系統類型，再前往Windows 下載頁面。優先選擇 Clash Plus；若需要其他介面或工作流程，可依序了解 Clash Verge Rev、FlClash、Clash Nyanpasu。Clash for Windows 已停止維護，僅供封存版本參考；不建議為解決新系統相容性問題而反覆改用舊版用戶端。安裝套件是否支援目前的架構，請以下載卡片上的說明為準。

安裝版請依照精靈選擇安裝資料夾；可攜版則解壓縮至目前帳戶可寫入的固定資料夾，避免直接從壓縮檔啟動。首次啟動時先使用一般使用者權限，確認程式能開啟且設定資料夾可寫入。若系統提示應用程式來源或安全性風險，請確認下載來源並閱讀提示內容，不要為了完成安裝而關閉整體系統防護。受組織管理的電腦，請交由管理員判斷是否允許安裝。

匯入訂閱並選擇出站

在設定、訂閱或 Profiles 頁面中找到遠端匯入選項，貼上完整訂閱網址並送出。成功後應看到一份可選用的設定，而不只是輸入框中保留了網址。選取該設定，確認策略群組是否出現；若清單空白，請先查看設定載入記錄。有些用戶端會將下載設定與啟用設定分成兩個步驟；更新成功後仍須確認目前啟用的項目，避免持續使用舊檔案。

將出站模式設為規則，並在需要代理的策略群組中選定節點。延遲測試只反映特定探測目標的回應，不代表所有通訊協定和網站都可使用。首次驗證時，請同時觀察實際瀏覽結果與連線記錄。若訂閱下載失敗，先透過可直連的網路重試，並確認服務是否到期、網址是否跳轉至登入頁面；不要將網頁內容另存為 YAML 後繼續匯入。

確認混合連接埠與系統代理

在設定中查看實際監聽連接埠；混合連接埠的常見範例為 7890，但本機也可能使用其他數值。混合連接埠通常同時接受 HTTP 與 SOCKS 要求，系統代理仍須依照用戶端提供的方式設定。開啟系統代理後，前往 Windows 的「網路和網際網路」設定，確認手動代理位址是否指向本機。請勿將遠端節點伺服器位址填入系統代理設定，兩者所屬層級不同。

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

以上 PowerShell 指令用於查看連接埠監聽狀態；若沒有結果，可能是核心尚未啟動，或實際使用的連接埠不同。若顯示由其他程序占用，請先確認該程式的用途，再選擇結束舊用戶端或更換連接埠；不要直接終止不明的系統程序。修改連接埠後，應用程式內的手動代理設定也須同步調整。只修改設定檔但未讓用戶端重新載入，執行中的監聽連接埠可能仍是舊值。

TUN、UWP 與防火牆限制

瀏覽器正常，但部分應用程式未經代理時，請先確認這些應用程式是否遵循系統設定。若需要使用 TUN，請依用戶端提示安裝服務或授予管理員權限，再啟用虛擬介面。安裝服務與日常以管理員身分執行是兩回事；已安裝服務的用戶端不一定每次都需要提升權限。啟用後請檢查路由與記錄；若網路中斷，應先關閉 TUN 以恢復基準狀態，不要繼續疊加其他加速或 VPN 軟體。

部分 UWP 應用程式受到迴圈存取限制，即使本機代理正常，也可能無法連線。請優先使用用戶端提供的迴圈管理功能，只為確實需要的應用程式設定例外。不要批次解除所有應用程式的限制，也不要將迴圈存取問題誤判為規則錯誤。相關操作受系統政策限制；企業裝置上的權限問題不宜靠反覆提升權限繞過，可先用一般瀏覽器確認相同目標是否可存取。

防火牆詢問網路存取權限時，請依實際用途選擇網路範圍。僅供本機使用時，不必對所有公用網路開放連入；若要在區域網路分享，則須另外確認監聽位址、驗證方式與可信任網段。從睡眠喚醒或程式異常結束後，若用戶端已關閉但系統代理仍指向本機連接埠，請至系統設定關閉殘留代理，再重新啟動用戶端。完成後以規則記錄再次確認；更多初次檢查項目請參閱混合連接埠、模式與系統代理檢查清單。

03 · macOS 安裝與授權

辨別處理器並將應用程式移至「應用程式」資料夾

在 Apple 選單的「關於這台 Mac」查看晶片資訊。Apple Silicon 與 Intel 使用不同版本時，請選擇相符的安裝套件，再前往macOS 下載頁面下載。優先選擇 Clash Plus，也可依需求了解 Clash Verge Rev 和 FlClash。ClashX Meta 已停止維護；封存版本的系統相容性與功能支援，不能等同於仍持續更新的用戶端。請勿只因名稱相近而忽略維護狀態。

下載磁碟映像檔後開啟，將應用程式拖曳至「應用程式」資料夾，再從該資料夾啟動，不要一直從磁碟映像檔內執行。這樣可減少路徑變更造成的更新與權限問題。首次啟動若遭系統阻擋，請先確認來源，再查看「隱私權與安全性」中的具體說明。不要使用批次移除安全屬性的指令處理所有應用程式，也不要為了略過單一軟體的啟動提示而關閉整體系統防護。

了解擴充功能、輔助服務與鑰匙圈

macOS 用戶端可能透過系統代理、特權輔助服務或網路擴充功能整合網路，不同實作方式不會顯示完全相同的授權視窗。請只依照目前用戶端實際提出的要求操作：若要求新增 VPN 設定或網路擴充功能，請確認發起應用程式的名稱；若要求輸入輔助服務密碼，請確認對話框來源。沒有出現某種彈出視窗，不代表安裝有缺漏；不要為了湊齊步驟而尋找不存在的開關。

部分授權必須在系統設定中明確允許，再返回用戶端重試；系統也可能要求重新啟動。請先儲存工作，完成提示中的操作後再檢查擴充功能狀態。鑰匙圈提示通常與儲存或讀取憑證有關，輸入的應是系統指定鑰匙圈的密碼，而不是訂閱服務密碼。若拒絕授權後功能異常，請查看應用程式提示和鑰匙圈存取權限，不要直接刪除所有鑰匙圈項目。

匯入訂閱並使用選單列

進入用戶端的設定管理頁面，新增遠端訂閱並啟用下載完成的設定。若提供的是本機 YAML，可透過匯入檔案或開啟設定資料夾的選項新增，並留意檔案副檔名是否變成雙重副檔名。設定載入成功後，請確認策略群組，再從選單列選擇規則模式與目標出站。選單列圖示出現只代表前端正在執行，仍須確認核心狀態、目前設定與系統代理是否生效。

首次驗證請先使用系統代理，開啟新的瀏覽器視窗前往測試目標，同時查看連線命中的規則。部分命令列工具不會讀取圖形介面的系統代理設定，因此終端機連線失敗不代表用戶端失效。可在單次指令中明確指定代理，確認本機入口是否可連線；以下使用的連接埠必須替換成用戶端實際使用的連接埠，這些指令不會永久修改終端機環境。

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

TUN 與網路位置變更

應用程式不遵循系統代理時，再考慮使用用戶端支援的 TUN 或網路擴充功能接管方式。啟用前請先結束其他 VPN，並確認所需授權已通過。建立虛擬介面後，仍須檢查 DNS 與出站路由；只看到連線狀態指示，不代表所有流量都經過預期策略。公司內網、印表機與本機開發服務應分別測試；必要時依實際網段設定直連，不要直接複製來源不明的大段路由排除清單。

從 Wi-Fi 切換至有線網路、連接個人熱點或從睡眠喚醒後，系統代理所屬的網路服務可能會改變。若瀏覽器突然無法連線，請先確認目前網路能否直連，再檢查用戶端監聽狀態與代理開關。長期同時使用多種代理工具時，後啟動的程式可能覆蓋前一個程式寫入的設定。請只保留一個負責接管系統網路的用戶端，其他工具先關閉接管功能，再逐一驗證。

結束用戶端前，請先關閉系統代理或中斷隧道，避免異常結束後留下指向本機的代理位址。準備解除安裝時，優先透過應用程式內的選項移除其安裝的輔助服務，並在系統設定中檢查相關 VPN 或擴充功能。不要依照其他用戶端的路徑手動刪除檔案；同類軟體可能使用不同識別資訊。若要處理拒絕授權後的復原流程，可繼續參閱macOS 擴充功能與鑰匙圈授權說明，依實際彈出視窗逐項處理。

04 · Android 安裝與背景執行

選擇架構並授予安裝權限

前往Android 下載頁面，優先選擇 Clash Plus，接著可了解 Clash Meta for Android、FlClash 和 Surfboard。多數較新的裝置使用 ARM64，但舊裝置或特殊系統仍須確認處理器與應用程式支援情況；是否提供通用套件請以下載頁面為準。Surfboard 使用自己的設定格式，不能假設任何 Clash YAML 都能直接匯入；請向設定提供者索取目標用戶端支援的格式。

安裝 APK 時，系統可能要求允許目前使用的瀏覽器或檔案管理員安裝未知應用程式。此權限僅適用於特定來源應用程式，安裝完成後可視需要關閉。若出現解析失敗提示，請優先檢查下載是否完整、是否符合系統需求，以及架構是否相符。更新時若發生簽章衝突，通常表示安裝來源或版本不同，不要立刻解除安裝；請先匯出設定，確認帳戶資料與本機設定能否復原，再決定如何移轉。

匯入設定並核准 VPN 要求

開啟訂閱管理，新增遠端網址並等待下載完成，接著選取該設定。若使用本機檔案，須透過系統檔案選擇器授予讀取權限；檔案若位於其他應用程式的私人資料夾，可能無法直接存取，可先儲存到自己能管理的資料夾。訂閱清單中出現名稱不代表內容有效，請繼續確認節點或策略群組是否已載入；發生錯誤時，先查看下載回應與設定解析記錄。

點選啟動後，Android 通常會顯示 VPN 連線要求。確認發起程式是剛安裝的用戶端後，再核准接管。此處的 VPN 是系統提供的本機流量接管介面，不代表裝置會自動連上某個遠端 VPN 伺服器；最終出站仍由設定中的節點與規則決定。連線成功後，通常可在系統狀態列或 VPN 設定中查看執行狀態，但圖示本身無法證明目標網站已連線。

應用程式分流、規則模式與 DNS

行動版通常提供應用程式存取控制，可指定哪些應用程式進入隧道。請先確認清單採用的是包含模式還是排除模式，兩者的意義相反：前者只接管勾選的應用程式，後者則讓勾選的應用程式略過接管。設定後應重新建立連線；部分應用程式還需要完全結束後再啟動。若某個應用程式未出現在連線記錄中，請先檢查應用程式篩選設定，不要直接更換節點或關閉所有分流規則。

應用程式進入隧道後，通常仍會依網域、位址或規則集決定出站。應用程式篩選與規則分流屬於不同層級，允許某個應用程式通行，不代表其所有連線都一定直連。若涉及本機裝置探索、投放或家庭服務，還須確認區域網路略過設定與 DNS。Android 的私人 DNS 及應用程式內建的安全 DNS 可能改變解析路徑；排查時請記下原始設定，暫時進行對照測試後再決定是否調整。

電池管理與網路切換

螢幕關閉後斷線時，請優先檢查電池最佳化、背景活動、自動啟動與通知權限。不同廠牌的設定名稱不一，請在系統的應用程式詳細資訊中尋找對應設定，不要批次放寬所有應用程式的限制。允許背景執行可能增加耗電，建議先確認問題確實與系統回收程序有關。若只有行動數據中斷，請再檢查該應用程式是否受背景流量限制，以及目前資費或網路是否另有連線限制。

Wi-Fi 與行動數據切換會重新建立底層連線，原有長連線可能因此失效。網路恢復後，先觀察用戶端是否自動重新連線，再嘗試中斷並重新啟動 VPN。不要連續快速切換多種模式，以免記錄混入手動中斷與實際故障。若啟用了系統的「永遠開啟 VPN」或「封鎖未使用 VPN 的連線」，用戶端停止後，裝置可能會依設定拒絕連線；請在系統 VPN 頁面了解並管理此功能。

在同一使用者環境中，通常只能有一個使用系統 VPN 介面的應用程式生效。本機防火牆、廣告封鎖工具或其他 VPN 可能占用介面，啟動前請先確認衝突來源。校園或工作裝置也可能禁止使用者新增 VPN，請遵循管理政策。若要分享區域網路連線，不能只確認手機本身已連線；熱點流量是否進入隧道取決於系統與用戶端功能，不要假設一定支援。

完成設定後，分別驗證前景瀏覽、鎖定螢幕一段時間後的連線，以及切換一次網路後的連線，並確認記錄中的出站。停止使用時，請從用戶端中斷連線，再確認系統 VPN 標記已消失。若訂閱更新成功但策略群組沒有變化，請檢查目前啟用的設定與本機覆寫選項；常見原因是更新了另一份訂閱，而非核心未收到新節點。

05 · iOS 安裝與連線設定

透過 App Store 安裝 Clash Plus

iPhone 與 iPad 優先使用 Clash Plus。前往iOS 下載頁面，或開啟其 App Store 頁面安裝；官方網站為 clashplus.io。安裝前請查看商店目前列出的系統相容需求與應用程式資訊；能否從商店安裝取決於帳戶及裝置狀態，請勿將其他平台的安裝套件或系統需求套用於 iOS。

安裝完成後首次開啟，先了解訂閱、策略與連線頁面的位置，再匯入設定。不要同時匯入多份同名設定，以免之後無法確認目前使用的是哪一份。若已安裝其他代理應用程式，請先記下其設定與系統 VPN 狀態，再停止舊連線。iOS 對應用程式沙箱與背景網路擴充功能有獨立的管理方式，不要依照桌面系統的習慣尋找常駐程序、監聽服務或驅動程式安裝選項。

新增訂閱與本機設定

從設定或訂閱選項新增遠端網址，貼上完整連結後儲存並更新。使用 QR code 匯入時，請留意相機權限及畫面內容的來源；掃描只是輸入方式，不代表網址可信。匯入本機檔案時，請透過系統檔案選擇器選取實際的 YAML 檔案；若檔案仍存放在雲端且尚未下載，請先等候檔案可供使用，再重試匯入，避免將讀取失敗誤認為語法錯誤。

匯入後請確認設定狀態正常，策略群組與出站項目已出現，再將其設為目前使用的設定。有些來源只提供節點訂閱，用戶端可能需要套用自己的規則範本；完整設定則可能已包含規則與 DNS。兩者不可混為一談，請以用戶端的匯入提示為準。若遇到不支援的欄位，應索取相容設定，不建議反覆刪除未知欄位試誤，以免改變提供者原有的分流邏輯。

核准 VPN 設定並驗證策略

首次連線時，系統可能會要求新增 VPN 設定，並透過裝置密碼或生物辨識確認。請先確認發起應用程式，再授予權限；授權成功只代表應用程式可以建立網路隧道，不保證訂閱或節點有效。接著返回用戶端啟動連線，選擇規則模式，並在策略群組中指定目標出站。透過一次新的連線搭配連線記錄確認規則命中，不要只看狀態列的 VPN 標記判斷結果。

iOS 通常透過系統網路擴充功能接管流量，使用者不必像桌面版那樣為所有應用程式填寫本機系統代理位址。用戶端是否提供獨立代理入口、區域網路設定或其他接管選項，請以實際功能為準。首次使用時維持預設設定較容易建立基準；只有在確實遇到應用程式相容性或區域網路存取問題時，才檢查略過設定與 DNS，避免一次修改多項網路選項。

處理背景執行、按需連線與網路變更

返回主畫面後，前景應用程式介面與網路擴充功能並非同一個執行狀態。介面暫時沒有顯示連線記錄，不一定代表隧道已停止；請搭配系統 VPN 狀態與實際連線結果判斷。反過來說，強制結束應用程式可能影響復原流程，不適合作為日常中斷連線的方式。需要停止代理時，請優先使用應用程式內的連線開關，再到系統設定確認相關連線狀態已更新。

若啟用按需連線，系統可能在符合條件時再次啟動 VPN，造成手動中斷後又自動連線的情況。請先查看用戶端的按需策略與系統 VPN 設定，不要反覆刪除應用程式。公司管理的裝置可能限制個人 VPN，組織設定也可能覆寫網路行為。不要刪除不明的裝置管理描述檔；請先確認用途，再依管理單位的要求處理，以免影響工作帳戶與憑證。

從家用 Wi-Fi 切換至行動網路後，現有連線可能需要重新建立。請先確認該應用程式可使用行動數據，再檢查目前出站是否可連線。若只有特定區域網路服務無法存取，請測試同一網路中的裝置位址，並確認流量是否被規則送往代理。系統的其他隱私網路功能或應用程式內建的安全 DNS 也可能影響測試結果；排查時請逐項記錄設定，只做暫時對照，不要直接認定必須永久關閉某項功能。

訂閱更新失敗時，請先查看服務狀態與回應內容，再透過可直連的網路手動更新一次。連線期間可以瀏覽網頁，不代表訂閱下載一定採用相同路徑；背景更新也受用戶端實作與系統排程影響，不要假設一定會在固定時間執行。移轉裝置前，請妥善保留訂閱來源與必要設定；新裝置完成手動匯入與驗證後，再決定是否清除舊裝置上的設定。

06 · Linux 用戶端與核心執行

先區分桌面用戶端與命令列核心

Linux 桌面使用者請優先查看Linux 下載頁面中的 Clash Verge Rev 與 FlClash，建議先選擇前者。選擇套件時須同時確認發行版、處理器架構與套件管理工具；Debian 系統常用 deb，部分發行版使用 rpm，但不能只憑副檔名判斷所有相依套件都相容。伺服器與路由器使用者則可考慮 mihomo 核心；命令列核心不內建桌面版的訂閱管理與系統代理介面。

下載套件後，使用發行版的軟體安裝程式或套件管理工具安裝，並閱讀相依套件提示。不要為了滿足相依需求而混用不同發行版的軟體來源，也不要將不明指令碼直接交給高權限 shell 執行。桌面用戶端啟動後，先確認設定資料夾可寫入且核心能正常啟動；系統匣圖示未顯示可能是桌面環境整合差異，不代表應用程式已結束，可從視窗狀態與記錄繼續判斷。

匯入訂閱並設定桌面代理

圖形介面的操作流程仍是新增訂閱、下載設定、啟用設定，再選擇規則模式與出站。部分桌面環境會分別設定 HTTP、HTTPS 與 SOCKS 代理，請依用戶端提供的連接埠與通訊協定填寫。混合連接埠可接受多種連線方式，但不代表各通訊協定欄位可以任意互換。瀏覽器可能使用自己的代理設定，命令列程式也可能只讀取環境變數，兩者須分別驗證。

curl -I --proxy http://127.0.0.1:7890 https://example.com
ss -lntp 'sport = :7890'

第一個指令用來測試明確指定的 HTTP 代理入口，第二個指令用來查看本機 TCP 監聽狀態。連接埠必須與實際設定相符，程序資訊可能受目前權限限制。若代理測試成功但桌面應用程式失敗，請檢查桌面代理或應用程式本身的設定；若本機連線遭拒，請先處理核心啟動與連接埠問題。尚未有服務監聽時，反覆調整遠端節點並無幫助，因為要求尚未進入出站階段。

檢查並啟動命令列核心

使用 mihomo 時，請將執行檔與私人設定放在明確的資料夾中，並依實際檔名操作。執行帳戶須有權讀取設定並寫入資料目錄；設定中若含訂閱與節點資訊，請勿讓其他帳戶取得不必要的讀取權限。先執行語法檢查，再以前景模式啟動並查看錯誤輸出。以下指令假設目前資料夾中已有可執行的 mihomo 與完整的 config.yaml。

./mihomo -t -d . -f ./config.yaml
./mihomo -d . -f ./config.yaml

語法檢查通過只代表設定可解析，不代表節點可連線、規則資源齊全或連接埠沒有衝突。前景執行確認成功後，再考慮設為系統服務，避免同時將啟動參數、工作目錄與權限問題藏在背景執行流程中。使用 systemd 時，請將服務中的執行檔路徑、設定路徑與資料目錄設為實際的絕對路徑，並確認服務帳戶可讀寫所需檔案；修改服務單元後，還須重新載入管理器設定。

TUN 權限、DNS 與遠端復原

TUN 涉及虛擬介面、路由與網路管理權限，不能只將設定中的開關改為啟用。請先確認系統提供 TUN 裝置，並採用所選用戶端建議的服務或權限方案。在容器中執行還涉及裝置映射與網路命名空間；主機可用不代表容器內也可用。不要為了方便而長期授予所有程式網路管理權限，也不要在不了解用途時以最高權限執行整個桌面工作階段。

DNS 可能同時受 NetworkManager、systemd-resolved、桌面設定與用戶端影響。請先確認由哪個元件管理解析，再決定接管位置，避免手動修改的檔案立即被系統覆寫。啟用 Fake-IP 後，也應確認 DNS 要求是否確實經過核心；只更改增強模式卻保留旁路解析，可能使規則觀察結果與實際流量不一致。若涉及內網網域，請優先保留相應的本機解析路徑。

在遠端伺服器上啟用自動路由前，務必保留管理連線與帶外復原方式，並明確設定 SSH、內網與上游節點的略過範圍。錯誤路由可能將管理連線或代理本身的連線送回隧道。完成後，請同時測試本機代理、目標出站與遠端管理連線，再考慮設定開機啟動。服務停止後若仍無法連線，請檢查殘留路由、桌面代理與環境變數，確認已恢復至安裝前的狀態，不要只刪除執行檔。

07 · 設定參數與常見問題

先從最精簡的設定了解欄位

排除問題時，請依序檢查設定載入、本機監聽、系統接管、DNS、規則與目標出站。每次只變更一個變數，並記錄時間與結果；否則即使連線成功，也無法判斷是哪項修改生效。以下 YAML 用於說明欄位與縮排，只有直連規則，不含代理節點，也不具備訂閱提供者提供的完整策略。適合在獨立測試設定中了解結構，不能直接覆寫目前使用的訂閱設定。

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

dns:
  enable: true
  enhanced-mode: fake-ip
  nameserver:
    - https://dns.alidns.com/dns-query

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,DIRECT

YAML 層級使用空格，不要混用定位字元；同層級的鍵須對齊，清單項目前的連字號屬於語法。完整代理設定還需要可供引用的出站或策略群組，規則中的目標名稱也必須存在且一致。訂閱更新可能重新產生整份檔案，直接修改下載的檔案容易被覆寫。若要保留修改，請優先使用用戶端明確支援的覆寫、合併或擴充設定機制，並確認合併後的實際結果。

分別處理訂閱失敗與資源更新失敗

訂閱更新失敗時，先檢查 URL 是否完整、是否過期，以及伺服器回應是否為有效設定。驗證失敗請向提供者處理；逾時則檢查下載路徑與網路；若回傳網頁，常見原因是登入、重新導向或伺服器錯誤。GeoIP、GeoSite 與規則集更新屬於另一類資源要求；訂閱成功不代表這些資源也已下載。請在記錄中找出實際失敗的資源，再檢查路徑、權限或網路，不要一律歸咎於節點。

DNS、Fake-IP 與規則順序

網域解析失敗時，請先區分系統、應用程式與核心各自使用的解析路徑。Fake-IP 會為網域指派用於映射的虛擬位址，看到這類位址不代表真實伺服器位址有誤；關鍵在於後續連線是否仍經過能還原網域資訊的核心。若應用程式略過隧道卻使用虛擬位址，可能會連線失敗；請檢查接管範圍與篩選規則，原理詳見Fake-IP 與 Redir-Host 比較。

規則通常依序比對，採用第一條符合的結果；範圍過廣的規則若排在前面，會遮蔽後續的精細規則。最後的 MATCH 是兜底規則，不了解前面的規則時不宜直接修改。網站可能同時連線至多個網域；若主頁成功但資源載入失敗，請逐一查看對應連線。GeoIP 依賴位址資訊，某些規則選項也會影響是否觸發解析，不能只看規則文字就認定所有流量都能依所在地正確分流。

延遲、逾時與復原順序

節點延遲測試成功，不代表實際目標一定可用；測試失敗也可能只是探測位址無法連線。發生逾時時，請分辨是連線本機連接埠失敗、連線遠端節點失敗，還是遠端存取目標失敗。查看同一時間的記錄，再以另一個已知可用的出站對照。暫時提高記錄詳細程度可補充線索；定位後請恢復一般層級。分享記錄前，請刪除位址、帳戶與存取紀錄等敏感資訊；更多範例請參閱執行記錄錯誤說明。

若所有應用程式都無法連線，先處理監聽與流量接管；只有單一應用程式失敗時，檢查獨立代理、迴圈存取、應用程式篩選與快取；只有特定網站失敗時，再檢查規則與目標出站。復原後請保留一份可用設定紀錄，包含實際連接埠、目前設定名稱與必要授權，但不要記錄真實訂閱憑證。其他常見問題可至常見問題查閱；術語定義可在術語表中對照，避免將不同平台上名稱相同的開關視為完全相同。