V2Ray 使用指南

核心概念與連線路徑

用戶端、核心與伺服器各自負責什麼

V2Ray 是代理技術生態中常見的名稱，不等同於某一個安裝套件。v2rayN、v2rayNG 和 v2flyNG 是圖形化用戶端，主要用來儲存節點、管理訂閱、選擇執行模式及產生設定。實際處理連線的是核心。伺服器則位於遠端，接收符合協定規範的請求。安裝用戶端只是準備好本機工具，不會自動取得可連線的伺服器，也不會自動產生可用訂閱。

Project V 提供相關技術的基礎背景，V2Fly 延續 V2Ray 核心生態，Xray 則是另一條相關的核心實作路線。不同核心支援的協定、傳輸方式與參數不盡相同，因此不能只看節點名稱判斷相容性。節點標示某種協定時，還需要確認傳輸方式、安全層及其他參數。圖形介面能儲存某個欄位，也不代表目前選用的核心一定支援該組合。

將一次連線拆成四個環節

理解連線時，可以依序檢查「應用程式、本機入口、路由判斷、遠端輸出」四個環節。瀏覽器先決定是否將請求交給代理；用戶端透過本機監聽連接埠或虛擬網路介面接收流量；接著由路由規則決定採用直連、代理或封鎖；最後由代理輸出連線至遠端服務。任何一個環節未接通，都可能造成網頁無法開啟，但處理方式各不相同。

例如，瀏覽器可以正常連線，另一個應用程式卻連不上時，應先確認該應用程式是否遵循系統代理，不要立刻更換節點。用戶端日誌完全沒有出現相關請求，通常代表流量尚未進入本機入口。日誌已記錄請求，但顯示遠端交握失敗，則應檢查伺服器位址、連接埠與安全參數。若連線已建立，卻出現網域名稱解析錯誤，就要另外排查 DNS，不能將所有問題都歸咎於網路品質。

區分協定、傳輸方式與安全層

VMess、VLESS 等名稱代表代理協定；TCP、WebSocket 等涉及承載方式；TLS、REALITY 則是安全傳輸相關機制。它們並非同一層級的替代選項。匯入時必須讓整組參數保持一致：即使協定選對了，只要路徑、伺服器名稱或公鑰填錯，仍然無法連線。REALITY 的公鑰與短識別碼也不是訂閱密碼，不應套用其他節點的值，更不能只憑用戶端提示自行猜測。

節點位址可能是網域名稱，也可能是數字位址；連線使用的位址與安全交握使用的伺服器名稱可能不同。遠端連接埠代表伺服器的監聽位置，本機連接埠則是用戶端在裝置上的入口，兩者不可混用。教學中出現的本機迴路位址只指目前裝置，在另一台裝置上輸入時不會指向原本的用戶端。若要在區域網路分享，還需要另外設定監聽範圍、防火牆與存取控制。

本指南後續每個階段都設有驗證點：安裝階段確認核心能否啟動，訂閱階段確認節點資料是否完整，代理階段確認請求是否出現在日誌，路由階段確認輸出是否符合預期。依這個順序記錄結果，比一次切換多個開關更容易找出問題。遇到不熟悉的術語，可先查閱術語表，再回到相應步驟繼續設定。

依平台與核心選擇用戶端

桌面環境優先選用 v2rayN

Windows、macOS 與 Linux 桌面環境，建議先從 v2rayN 開始。先確認作業系統，再確認處理器架構，最後選擇安裝套件類型。架構決定程式能否在裝置上執行，套件格式則決定安裝方式，兩者是不同條件。下載頁依平台列出下載入口，選擇時應以系統資訊為準，不要根據裝置外觀或購買年份猜測，也不要把壓縮檔名稱中的平台字樣當成通用標記。

Windows 提供 Desktop 與 WPF 兩種發行版本。Desktop 採用新一代跨平台介面，WPF 則保留傳統 Windows 介面。兩者在設定位置、執行環境與功能呈現上可能有所差異，但節點參數仍須與伺服器一致。初次安裝可依下載頁說明選擇一種並完成連線，避免同時執行兩套用戶端；多個用戶端同時執行可能占用相同連接埠，或反覆覆寫系統代理設定。

Android 先確認所需協定，再確認套件架構

Android 首選 v2rayNG，採用 Xray 核心；若需要 V2Fly 路線，可考慮 v2flyNG。不能只因兩款用戶端名稱相近，就認定功能完全相同。若節點包含特定安全傳輸參數，應先確認目標用戶端及其核心是否支援。有可用訂閱時，依照服務提供者的協定說明操作，比根據節點名稱中的縮寫判斷可靠。缺少必要欄位時應向來源確認，不要自行拼湊參數。

下載頁提供 arm64 與通用套件。較新的主流裝置通常採用 arm64，但舊裝置、特殊裝置與模擬環境仍須確認實際架構。若不確定裝置架構，或需要支援不同裝置，可選擇通用套件，但檔案通常較大。如果系統提示無法安裝，不要反覆點選安裝；應檢查系統相容性、套件是否適用於裝置，以及是否與已安裝應用程式的簽章或安裝來源衝突。

確認參數相容後，再考慮切換核心

切換核心並不是通用的加速方式。節點無法連線可能是參數缺漏、訂閱解析不完整或網路無法連通，改用其他核心未必能解決。需要切換時，先記錄節點協定、傳輸方式、安全層與錯誤訊息，再確認新核心的支援範圍。有些用戶端允許為不同節點指定核心類型，有些則使用固定核心；請以目前設定為準，不要照搬其他平台的選單路徑。

macOS 可在「關於這台 Mac」確認晶片類型，再選擇 Apple Silicon 或 Intel 下載入口；Linux 則須同時確認發行版的套件系統與架構，不能把 deb 和 rpm 當成同一檔案的不同名稱。桌面環境、權限管理與系統代理的實作方式也會影響使用。下載完成只代表選對套件，不代表目前的桌面應用程式一定會遵循代理，還需要在後續的模式驗證階段繼續確認。

選定後，建議固定使用一款主要用戶端，並記錄其資料儲存位置、目前執行方式與退出行為。確實需要移轉時，先備份原有設定，再逐項確認訂閱、路由與 DNS，不要只複製節點就認定所有設定都已轉移。詳細差異請參閱用戶端比較；實際安裝檔統一由下載頁提供，本頁不直接提供安裝套件。

安裝與首次啟動檢查

桌面版安裝先確認目錄與權限

在 Windows 上，使用安裝程式時依照提示完成安裝；使用免安裝發行套件時，應先完整解壓縮至固定目錄，再啟動主程式。不要直接從壓縮檔預覽視窗執行，也不要只解出執行檔，核心與相關資源可能仍留在壓縮檔中。選擇方便管理且目前使用者可寫入的目錄，避免將需要頻繁寫入的設定放在權限限制嚴格的位置。遇到權限提示時，先判斷程式正在執行哪個步驟。

首次啟動若提示缺少執行環境，應先分辨是圖形介面相依項目缺漏，還是核心啟動失敗。WPF 與 Desktop 的相依條件可能不同，請以目前發行說明和系統提示為準。不要從不明視窗下載所謂的修復工具，也不要把所有啟動失敗都歸因於缺少執行階段程式庫。若介面能開啟但核心隨即結束，應查看日誌確認原因；常見狀況包括檔案缺漏、設定無法解析、連接埠遭占用或受到系統限制。

macOS 與 Linux 的安裝注意事項

macOS 選擇適用於晶片的磁碟映像檔後，依照視窗提示將應用程式移至「應用程式」資料夾，再從正式位置開啟。系統安全性確認應透過系統設定中的明確選項處理，不建議為了啟動用戶端而全面關閉安全防護。如果系統提示無法開啟應用程式，先確認檔案是否適用於裝置、安裝過程是否完整，以及系統顯示的具體原因，再決定下一步；不要直接套用終端機指令略過所有檢查。

Linux 請依發行版選擇 deb 或 rpm，並使用系統的套件安裝工具處理相依項目。如果安裝程式回報相依性衝突，應先修復套件狀態，而不是從其他發行版複製程式庫檔案。一般代理模式通常不需要長期以高權限執行整個圖形用戶端；只有調整虛擬介面或路由時，才可能需要額外授權。授權範圍與方式取決於發行套件的實作，請優先依照目前用戶端的提示操作。

Android 安裝與首次授權

Android 安裝前先確認套件架構。若系統要求允許目前來源安裝應用程式，只授權實際使用的安裝來源。已安裝同名應用程式無法覆蓋安裝，可能是簽章不同或受到降級限制；解除安裝會刪除應用程式資料，因此應先確認設定是否可以匯出。首次啟用連線時，系統會要求建立 VPN 連線，這是用戶端接管流量所需的系統授權，不代表已完成遠端交握，也不代表節點一定可用。

如果裝置上已有其他使用 VPN 介面的應用程式，通常需要先停止原有連線，再啟動目前的用戶端。電池管理可能影響背景持續執行，但首次安裝時不需要一次放寬所有權限。先完成前景連線測試，再依實際斷線情況調整背景執行與電池限制。系統通知、VPN 圖示與用戶端狀態可協助判斷程序是否仍在執行，最後仍應搭配請求測試與日誌確認。

安裝後依序檢查：確認介面能正常開啟、核心是否已啟動、記錄本機監聽位址與連接埠，再確認是否有其他用戶端占用相同入口。即使目前沒有節點，也可以先檢查本機狀態。若需要變更連接埠，也要同步修改應用程式中的手動代理設定，否則應用程式仍會連到舊連接埠。連接埠數值請以目前用戶端介面顯示為準，不要把其他教學提供的數字當成固定標準。

最後確認退出方式。有些桌面用戶端關閉視窗後仍會留在系統匣，必須透過系統匣選單完全退出；有些設定則會在退出時清除系統代理。初次設定時，請實際退出並重新開啟一次，觀察代理是否恢復正常。Windows 安裝版本的詳細說明請參閱WPF 與 Desktop 安裝教學；安裝尚未穩定前，不要繼續加入分流與 TUN 設定。

匯入訂閱、更新與參數檢查

先分清訂閱網址與單一節點連結

訂閱網址用來取得一組節點，通常需要先儲存至訂閱群組，再執行更新；單一節點連結則描述一個特定連線，可從剪貼簿或 QR Code 匯入。兩種內容的匯入入口不同。將訂閱網址貼到單一節點參數欄，或把節點連結當作訂閱來源，都可能造成清單空白或解析失敗。匯入前先閱讀來源提供的說明，確認內容格式及是否支援目前的用戶端。

在 v2rayN 中，可進入訂閱群組管理，新增群組、填寫方便辨識的備註與訂閱網址，儲存後再執行更新。v2rayNG 與 v2flyNG 可從側邊欄的訂閱群組設定進入管理頁面。介面名稱可能略有不同，但步驟相同：建立群組、儲存網址、取得內容、檢查節點。若只儲存網址而尚未更新，清單空白不代表訂閱失效，也不必立刻解除安裝用戶端。

更新失敗時，區分取得內容與解析問題

更新失敗主要分為「無法存取網址」和「無法解析回傳內容」兩種。前者應檢查裝置網路、訂閱有效期限、網址是否完整，以及請求是否需要透過現有代理；後者則確認回傳內容是否為登入頁、網頁提示或不支援的格式。如果用戶端提供透過代理更新的選項，只有在現有代理已可正常使用時才適合啟用。首次尚無可用節點時使用此選項，可能形成「更新需要代理、代理又需要更新」的循環。

訂閱更新成功後，先確認協定、伺服器位址、遠端連接埠與安全傳輸欄位，不要只看節點名稱。同一地區的多個項目可能採用不同傳輸組合，名稱相似也不代表可以互換。匯入後若發現欄位明顯缺漏，應優先檢查訂閱格式與用戶端相容性，不要複製其他節點的伺服器名稱、路徑或公鑰來碰運氣。所有參數都必須成套對應。

分開管理手動節點與訂閱節點

訂閱節點通常會在下次更新時重新產生，直接修改其中的參數可能會被覆蓋。需要驗證某個欄位時，先複製到獨立的手動群組，並在備註中註明是測試副本。測試完成後保留原始訂閱作為基準，避免多個副本混在一起而難以辨別。刪除群組前，也要確認是否會一併刪除節點，以及其他設定是否仍引用該群組或選取的項目。

選擇節點時，可先使用用戶端提供的連線測試進行初步判斷，再透過實際目標應用程式驗證。不同測試可能只檢查連接埠是否可達、交握是否完成或是否成功送出一次請求，不能直接代表所有服務的使用體驗。測試結果空白、測試逾時與節點完全無法使用，並不是同一種結論。流量額度、使用狀態與地區選擇應依訂閱來源的說明判斷；用戶端本身不會替伺服器補足權限，也無法恢復已停用的服務。

如果清單突然變空，先確認目前選取的群組與篩選條件，再查看更新紀錄。可能只是切換到其他群組，也可能是來源暫時回傳空內容。保留最近可用的備份，不要連續刪除並重建所有群組。若只有部分節點正常、其他節點失敗，可先依協定與傳輸方式分類比較，通常比重複更新整份訂閱更有參考價值。只有所有節點都失敗時，才進一步檢查本機環境與訂閱狀態。

每次更新後都要重新確認目前選取的節點，避免原節點遭刪除後，用戶端沒有自動切換至預期項目。節點選擇可參考延遲、倍率、地區與協定選擇說明。完成本章的標準不是清單中出現項目，而是已有一個參數完整、可供後續驗證的連線，並清楚知道它來自哪個訂閱群組。

系統代理與應用程式接管範圍

系統代理是應用程式遵循的設定，不代表接管整台裝置

桌面系統代理會告知遵循該設定的應用程式，將請求交給本機代理入口。它不會自動接管所有程式，也不會改變每個應用程式的網路連線方式。瀏覽器通常較容易驗證，但某些遊戲、命令列工具或內建網路元件可能不理會系統代理。因此，「瀏覽器可連線，其他軟體卻不行」首先應檢查接管範圍，不要直接判定用戶端故障。後續可改用應用程式本身的代理設定，或視需要考慮 TUN。

v2rayN 常見的系統代理選項包括清除系統代理、自動設定系統代理、不變更系統代理與 PAC 模式。清除通常會移除目前指向的系統代理，但不代表停止核心；自動設定會將系統代理指向用戶端提供的本機入口；不變更則表示保留現有系統設定，不代表主動建立連線。選擇前先確認系統是否已有手動代理，或由其他軟體管理設定，以免彼此覆寫。

PAC 與核心路由並非同一層級的判斷

PAC 透過自動代理指令碼，讓遵循指令碼的應用程式決定直連或交由代理處理。若應用程式在這個步驟選擇直連，請求就不會進入用戶端核心，核心中的路由規則也無法再處理。核心路由則負責處理已進入本機入口的請求。兩者可以搭配使用，但排查時會增加變數。初次驗證建議固定使用一種明確的入口方式，確認連線正常後再決定是否需要 PAC。

應用程式手動代理需要確認入口協定。HTTP 代理連接埠與 SOCKS 連接埠可能不同，也可能由同一個混合入口處理，請以目前的監聽設定為準。位址若填入本機迴路位址，只能連線到同一裝置上的用戶端。如果瀏覽器儲存了舊連接埠，即使系統代理已更新，瀏覽器自己的手動設定仍可能優先生效。瀏覽器擴充功能也可能控制代理，測試時應暫時固定由單一位置管理。

Android 的 VPN 模式與路由選擇

Android 用戶端透過系統 VPN 介面接收流量，是否涵蓋所有應用程式，還取決於個別應用程式規則與路由設定。系統顯示 VPN 已連線，只能證明介面已建立，不能證明每個請求都經過遠端代理。遭排除的應用程式可能仍使用原本的網路路徑，設定為直連的目標也仍可透過本機網路存取。排查某個應用程式時，應同時查看應用程式涵蓋範圍與核心輸出，不要只看連線開關。

驗證時先選擇一個穩定且可存取的測試目標，啟用連線後送出新請求，並觀察用戶端日誌是否出現相關連線。瀏覽器快取可能讓頁面在網路沒有實際送出請求時仍然顯示，既有長連線也可能沿用舊路徑；可重新載入頁面並建立新連線。日誌沒有請求，就檢查入口；有請求但失敗，再檢查輸出；連線成功但內容異常，則進一步分析目標服務與 DNS。

退出前應確認目前由哪個程式管理系統代理。用戶端已停止，但系統仍指向其本機連接埠時，遵循代理設定的應用程式可能都無法連線。可清除殘留的系統代理，或重新啟動對應用戶端，不必立刻重設所有網路設定。切換用戶端時，也應先停止原有連線並確認系統狀態，避免某個程式清除另一個程式剛寫入的代理位址。

本階段以「目標應用程式的請求確實進入用戶端」為完成條件，暫時不必追求複雜分流。若想採用簡單的操作流程，可回到入門指南的連線與驗證步驟；若模式名稱與實際接管範圍不符，可查閱說明中心。下一階段再討論進入核心後如何選擇流量輸出，避免混淆接管與分流。

路由規則、DNS 與比對順序

先了解入口、規則與輸出的關聯

進入核心的請求需要透過路由選擇去向。規則通常依設定順序逐一檢查，符合條件後便交由指定輸出處理；後續規則不會再接手同一次比對。因此，範圍寬泛的規則若排在前面，可能會遮蔽後面的精確規則。修改前應先確認用戶端產生了哪些輸出標籤，以及未符合任何規則的流量預設如何處理。介面上的「代理」或「直連」名稱，不一定等同設定檔中的實際標籤。

直連代表目前裝置直接連線至目標；代理代表使用已設定的遠端輸出；封鎖則代表拒絕對應流量。三者不是網路品質的高低分級。區域網路服務若使用代理，可能造成印表機、路由器管理頁面或本機開發服務無法存取；需要遠端輸出的目標若改用直連，則可能得到不同的存取結果。規則應根據明確需求設定，不要把所有項目都統一改成同一種方向。

從一段最簡規則認識欄位

以下是 Xray 格式的路由片段，表示特定網域集合與私有位址使用名為 direct 的輸出。這不是可以直接取代整份用戶端設定的完整檔案；執行時必須存在同名輸出，核心環境也必須備妥相關規則資料。若用戶端已管理路由，應優先在路由介面新增相同規則，避免手動設定與介面產生的結果互相覆寫。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "domain": ["geosite:cn"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

domainStrategy 說明路由比對時如何處理網域名稱與位址的關係。IPIfNonMatch 允許在網域階段沒有符合項目後解析位址，並繼續進行位址規則判斷。這不代表所有 DNS 請求都會自動經過代理，也不表示每個應用程式的解析都由同一設定控制。不同核心與用戶端還有各自的 DNS 設定；修改路由策略後，應分別驗證解析路徑與實際連線路徑。

網域規則與位址規則各有適用範圍

網域規則需要核心取得目標網域名稱。如果應用程式直接連線至數字位址，或請求進入時沒有可用的網域資訊，原先設定的網域規則可能無法命中。在適用情況下，嗅探功能可協助辨識部分協定中的目標資訊，但無法保證辨識所有流量，也不能取代正確的 DNS 與入口設定。啟用嗅探後仍應查看日誌，不要只憑規則名稱判斷功能已生效。

DNS 故障常見的狀況是網域名稱無法存取，但數字位址可以連通；不過這只能作為線索。安全連線也可能依賴伺服器名稱，直接使用數字位址不一定具備相同條件。排查時先確認是否成功解析，再確認解析結果對應的連線是否成功，最後檢查安全交握。不要同時更換 DNS 伺服器、啟用嗅探並調整路由，否則即使問題排除，也無法判斷真正有效的是哪項設定。

維護規則時遵循「例外優先、範圍明確、修改可復原」的原則。先新增一條局部規則，使用目標應用程式送出新請求，再從日誌確認比對結果；確認正常後才擴大至一組網域。規則資料庫也會影響集合比對結果，因此更新用戶端後若行為不同，應同時檢查規則資料與設定，而非只比較介面選項。設定結構的詳細解析請參閱inbounds、outbounds 與 routing 逐段說明。

TUN 模式與系統路由範圍

何時需要虛擬網路介面

TUN 透過虛擬網路介面接收系統流量，再交由用戶端或相應核心元件處理，適合用在不遵循系統代理、又沒有應用程式代理選項的情況。它解決的是流量如何進入用戶端，不會修復錯誤的節點參數，也不能讓已停用的訂閱恢復。若系統代理已符合需求，就不必為了「更完整」而啟用 TUN；接管層次越多，權限、DNS 與路由排查就越複雜。

啟用前先確認一般代理模式已有可用節點，並記錄目前的系統代理、路由模式與 DNS 設定。如果原本連線就失敗，直接啟用 TUN 會混淆基礎連線故障與系統接管問題。部分發行版本可能需要額外服務、虛擬介面元件或授權，實際支援情況取決於目前的用戶端、作業系統與所選核心組合。介面上有開關，不代表所有系統條件都已符合。

依序一次啟用一項設定

先停止其他可能修改路由或占用 VPN 介面的程式，再依用戶端提示啟用 TUN。需要授權時，先確認來源與操作內容，不要把一般啟動失敗都交由高權限執行處理。啟動後查看核心與介面日誌，確認沒有權限不足、裝置建立失敗或路由寫入失敗，再測試目標應用程式。如果介面未能成功建立，反覆切換節點通常沒有幫助，應先解決本機接管條件。

初次測試時，不要在原因不明的情況下同時疊加系統代理與 TUN。有些用戶端能協調兩者，但手動組合可能造成重複路徑，讓日誌更難判讀。可先固定使用一種明確的接管方式，再逐項恢復其他設定。存取測試不只要確認遠端目標，也要測試區域網路服務與一般網路連線，確保接管範圍沒有破壞原本可用的路徑。

了解輸出迴路與私有網路例外

用戶端需要透過實際網路連線至遠端服務。如果這條自身輸出再次被虛擬介面攔截，就可能形成迴路。成熟的實作通常會處理介面繫結、路由排除或相關保護機制，但手動修改系統路由或搭配其他網路工具後，仍可能破壞這些條件。可能出現大量重複連線、連線建立後立即逾時，或啟用 TUN 後所有連線都失敗。此時應先關閉 TUN、恢復基本狀態，再檢查路由衝突。

區域網路存取也需要明確界定範圍。路由器管理位址、列印服務、遠端桌面與本機開發環境，可能需要透過私有位址直連。啟用 TUN 後若這些服務無法使用，先檢查私有位址規則、略過區域網路選項與虛擬介面路由，不要直接把所有流量都改走代理。不同網路環境的位址範圍可能不同，企業網路也有自己的政策，應遵循網路管理員的要求，不要任意覆寫既有路由。

DNS 與 UDP 也是驗證重點。TUN 成功啟動不代表所有網域查詢都會遵循預期路徑，應用程式自己的加密 DNS 設定仍可能改變行為。即時通訊或遊戲使用的 UDP 是否正常，也取決於核心、節點與伺服器能力；不能因為網頁能開啟，就認定這些服務也正常。驗證時分別記錄網頁、名稱解析與目標應用程式的結果，不要用單一測試代表所有情境。

若關閉 TUN 後網路仍未恢復，先正常停止用戶端，查看系統代理與目前的 VPN 連線，再確認虛擬介面是否仍在運作。優先使用用戶端提供的停止或復原方式，不要直接大量刪除系統網路介面。保留啟用前的設定紀錄，必要時重新啟動系統以確認是否仍有殘留狀態。完成本章代表能說明接管範圍、驗證目標應用程式，並能安全恢復一般代理模式，而不只是讓開關維持在啟用狀態。

日常維護與分層故障排除

更新前先保留可復原狀態

日常維護應區分用戶端更新、核心更新、訂閱更新與規則資料更新。它們變更的內容不同，發生故障時不宜一次全部更新。用戶端更新可能調整介面與設定產生方式；核心更新會影響協定支援；訂閱更新會改變節點來源；規則資料更新則會影響分流比對。先記錄目前可用的設定，再按需求更新其中一項，確認正常後再處理下一項，才能找出問題出現在哪個環節。

備份至少應包含訂閱群組、手動節點、路由與 DNS 設定，以及應用程式接管範圍。若用戶端提供匯出功能，請優先使用；複製資料目錄前先停止程式，避免將尚未寫入完成的檔案納入備份。備份檔可能包含存取憑證，應存放於受控位置。還原至其他用戶端或不同發行版本時，不要假設所有內部設定格式都相容；必要時可依標準節點資訊重新匯入。

先確認錯誤發生在哪一層

連線失敗時，第一步檢查本機網路是否仍能正常存取一般服務；第二步確認用戶端核心是否正在執行；第三步確認請求是否進入日誌。核心尚未啟動，就不必測試遠端節點；請求沒有進入日誌，應先檢查代理或 VPN 接管。請求已進入核心後，再檢查遠端連線、名稱解析與交握結果。依序排查能區分「本機沒有收到請求」和「收到請求後處理失敗」，減少無效切換。

日誌中的逾時只表示某個等待過程未能在期限內完成，無法直接指出原因。連線位址逾時可能與網路路徑或服務狀態有關；交握錯誤可能涉及伺服器名稱、金鑰、系統時間或協定組合；解析錯誤則應檢查 DNS。查看前後相鄰的日誌行，確認目標與處理階段，不要只搜尋某個錯誤字詞。複製日誌求助時，保留錯誤類型與時間順序，並遮蔽節點憑證與個人網路資訊。

使用最小對照測試縮小範圍

每次對照測試只改變一個條件。保持用戶端與模式不變，改用另一個已知可用的節點，可確認問題是否集中在特定節點；保持節點不變，切換至另一種可用網路，可檢查是否與目前的網路環境有關；保持網路與節點不變，只恢復預設路由，可檢查自訂分流。若同時更換網路、用戶端並重建訂閱後恢復正常，不能據此認定其中某一項設定有效。

系統時間應透過可信任的系統時間同步機制維護，尤其是涉及憑證有效期限或時間驗證時。時間明顯錯誤，即使參數正確仍可能導致連線失敗。另一個常見問題是殘留的系統代理：用戶端退出後，本機連接埠已不再監聽，但應用程式仍將請求傳送至舊入口。遇到這種情況，先恢復系統代理設定，不要為了解決問題而直接刪除所有節點或重灌作業系統。

只在排查需要時提高日誌層級，完成後恢復一般層級，避免長期保存過多存取細節。若只能提供截圖，至少包含錯誤發生前後的相關行與目前模式說明；單獨截取一句「連線失敗」幫助有限。節點逾時的詳細檢查流程請參閱七項檢查要點，一般使用問題可前往說明中心。維護的目標是保留穩定的基準狀態，讓每次調整都有紀錄與復原方式。

設定檔閱讀與進階學習路線

先閱讀產生結果，再編寫自訂設定

完成前面各階段後，進階的第一步不是加入更多規則，而是讀懂用戶端產生的設定。先找出本機入口、遠端輸出、直連輸出、路由與 DNS 各自的位置，再沿著標籤引用檢查彼此關係。介面呈現的是方便操作的抽象，設定檔則反映核心實際收到的指令。兩者不一致時，應確認檔案是否由目前執行中的實例產生，避免讀取舊設定而誤判目前行為。

入口決定接收流量的方式與監聽範圍；輸出定義如何連線至目標或遠端服務；路由則透過標籤串連兩者。標籤只是設定中的引用名稱，不會自動建立關聯。若將範例中的輸出標籤改名，所有引用該標籤的規則也都必須同步修改。設定語法正確不代表邏輯無誤，例如規則雖可解析，卻可能永遠被前面的寬泛規則遮蔽，仍須透過請求測試驗證。

透過局部規則練習參數限制

以下規則適合用來學習網域比對：full: 指定完整網域名稱，domain: 則比對指定網域及其子網域。範例使用文件專用網域；新增時須放入現有的路由規則陣列，並確認 direct 輸出已存在。這段內容不是完整設定，也不包含遠端連線資訊。練習重點在於確認規則順序、比對條件與引用標籤，而非直接覆寫原始檔案。

{
  "type": "field",
  "domain": [
    "full:example.com",
    "domain:example.org"
  ],
  "outboundTag": "direct"
}

嘗試自訂設定前，先確認用戶端是否會在啟動時重新產生檔案。如果會，直接編輯產生的檔案可能只在短時間內有效，下次儲存設定時就會被覆寫。應使用用戶端提供的自訂設定、路由管理或範本入口，並確認它與介面設定之間是合併還是取代關係。同一欄位由多個位置同時管理時，最終值通常不易判斷；應減少重複來源，明確指定每項設定的管理位置。

依實際需求逐步學習協定

進階協定可先從 VMess 與 VLESS 的基本差異開始，再了解安全層與傳輸方式的組合。不要只憑協定名稱推斷速度或穩定性，實際表現也會受到伺服器、網路路徑與應用程式行為影響。REALITY、TLS 或 WebSocket 都有各自必要的參數與適用條件；學習時應搭配來源明確的節點逐項閱讀，不要把隨機範例中的欄位拼湊成新的連線設定。基本比較請參閱VMess 與 VLESS 說明。

接著再深入了解 DNS 策略、規則集合、嗅探與個別應用程式範圍。每個主題先設定一個可驗證目標，例如讓區域網路服務維持直連，或讓特定應用程式的請求進入指定輸出。先寫下預期結果，再進行設定；測試時記錄是否命中相應規則，以及錯誤發生在哪一層。如果無法說明某個選項預期會改變什麼，就先維持預設值，不要把複雜選項當成必開清單。

長期使用時，建立簡短的變更紀錄：修改了什麼、解決什麼問題、透過哪些條件驗證，以及如何復原。更新後若行為不同，先比對變更紀錄與執行中的設定，不要立刻重建整個環境。移轉至其他裝置時也應重新驗證系統代理、權限與介面範圍，因為節點參數可以相同，作業系統的流量接管方式卻可能不同。設定片段去除敏感資訊後，才適合用於交流。

完整學習流程至此形成一個循環：能說明連線路徑、選對安裝套件、匯入並管理訂閱、區分流量接管與分流、驗證 TUN 並恢復原狀，最後透過日誌檢查自訂規則。後續查閱不必每次從頭開始，可使用頁面上方目錄返回相應階段；若要重新建立最基本的可用連線，請回到快速入門流程，再逐步恢復必要設定，避免舊設定成為新的故障來源。