V2Ray 完整指南
從安裝到路由分流

第一階段：認識用戶端、核心與連線路徑

將一次代理連線拆解為幾個環節：應用程式送出請求，用戶端提供本機入口，核心讀取設定並執行路由，選定的伺服器負責後續轉送。圖形介面用來管理這些設定，並不等於連線本身。視窗能開啟，只代表介面啟動成功；訂閱能更新，只代表取得了設定；目標網頁能正常存取，才表示這次請求經過的連線路徑可正常運作。釐清各環節的界線，排錯時才能找到該檢查的位置。

分辨 Project V、V2Fly 與 Xray

V2Ray 屬於 Project V 代理工具生態系。V2Fly 延續相關核心的社群維護，Xray 則是另一個持續發展的核心分支。核心負責協定處理、傳輸、加密連線、路由與 DNS 等實際工作；v2rayN、v2rayNG、v2flyNG 則是用來管理設定及啟動核心的圖形用戶端。用戶端名稱相近，不代表核心、功能與設定欄位完全相同。查閱功能說明時，請一併確認使用的用戶端、實際核心及伺服器需求。

分辨協定、傳輸方式與連線參數

VMess、VLESS、Trojan 等名稱代表協定層，WebSocket、gRPC 等名稱代表傳輸方式，TLS 則涉及加密交握與憑證驗證。這些選項並非可以互換的按鈕，而是需要相互搭配的不同層級。伺服器要求哪種組合，用戶端就必須相應設定。即使位址與連接埠正確，路徑錯誤或伺服器名稱不符，仍會連線失敗。建議使用完整分享連結或訂閱，避免只憑名稱手動拼湊設定。

節點是用戶端儲存的一組連線參數，通常包括伺服器位址、連接埠、使用者識別碼、傳輸方式及相關安全選項。節點名稱主要用於辨識，名稱中的地區或線路說明，無法直接證明實際出口或效能。訂閱則是批次取得節點設定的方式。匯入訂閱不會替使用者建立服務，也不保證其中每個節點目前都能使用。用戶端、訂閱來源與遠端服務，是需要分開理解的三種對象。

沿著流量路徑判斷設定作用

應用程式是否將請求交給用戶端，取決於系統代理、應用程式本身的代理設定，或由 TUN 接管。請求進入核心後，才由路由規則決定直連、代理或阻擋。因此，系統代理中的「自動設定」與路由中的「全域」並非同一個層面：前者決定流量如何進入，後者決定進入後如何送出。若某個應用程式完全不讀取系統代理，單純更換路由規則通常不會改變它的網路路徑。

學習時先用一台裝置、一個用戶端和一個已知可用的節點，建立最精簡的連線路徑，不要同時執行多套代理工具。測試內容也要固定：先確認一般網路可用，再測試一個需要代理的目標，最後查看記錄與出口。只有清楚掌握每一步的預期結果，之後調整 DNS、路由與虛擬網卡時，才能判斷新設定是在解決問題，還是又引入了其他故障。

第二階段：依平台與設定需求選擇用戶端

桌面平台建議優先選用 v2rayN。挑選安裝套件時，先確認作業系統，再確認處理器架構，最後核對介面分支與套件格式。不要把「用戶端支援某個平台」理解成「任何安裝套件都能在該平台執行」。同一產品的不同版本可能有不同的相依項目、權限需求與介面配置。前往用戶端下載頁後，依平台查看下載項目，不要只憑其他教學截圖中的檔名猜測該下載哪個套件。

選擇桌面版或經典 WPF 版

Windows 提供 v2rayN 桌面版與經典 WPF 版。桌面版採用新一代跨平台介面，WPF 版則保留經典介面。初次設定可從桌面版開始；若已熟悉 WPF 版的操作流程，也可以繼續使用該介面的選單設定。兩種介面可能使用不同的設定入口或本機資料配置，請勿一邊執行舊版，一邊用新版修改同一份資料。切換前先結束用戶端，並保留原有設定。

macOS 請依晶片選擇 Apple Silicon 或 Intel 版本，可在系統的「關於這台 Mac」確認處理器資訊。Linux 則先確認發行版使用的套件格式，再核對是 x64 還是 arm64。deb 與 rpm 是套件管理格式，不代表效能等級；也不能只憑裝置外觀判斷架構。能透過相容層啟動，不代表已選用最適合這台裝置的版本。若安裝失敗，先排除套件格式或架構不符，再檢查相依項目。

Android 依核心與架構選擇

Android 建議優先使用採用 Xray 核心的 v2rayNG；若需要 V2Fly 核心的設定方式，再考慮 v2flyNG。兩款用戶端並非依節點數量或介面顏色區分，而是依核心相容性與使用習慣選擇。較新的主流手機通常選擇 arm64；若無法確認架構，或遇到對應套件安裝相容問題，再查看通用版說明。通用版涵蓋範圍較廣，但不代表能略過作業系統本身的最低需求。

選擇核心時，優先符合伺服器設定所需的功能。不要以為切換到另一個核心後，所有協定參數都能原封不動保留。某些安全選項、傳輸欄位與新功能只適用於特定核心或版本。若匯入時出現不支援的欄位、節點遭略過或設定檢查失敗，請回頭查閱訂閱提供者的相容性說明，不要連續改試各種隨機選項。更新用戶端也無法補足伺服器未設定的功能。

在多台裝置間使用時，盡量統一節點來源與命名方式，但不要直接複製整個應用程式資料夾。桌面系統代理與 Android 的 VPN 介面接管方式不同，路由和 DNS 可用的選項也可能不同。較穩妥的移轉方式是重新匯入訂閱、重新選擇使用中的節點，再依裝置重新設定代理入口。保留一份選擇依據，記下平台、架構與核心需求，日後更新就不必重新猜測。

第三階段：完成安裝與啟動前檢查

安裝前先確認裝置能正常連上一般網路、系統日期時間與時區正確，並預留設定和記錄所需的空間。憑證驗證會參照系統時間；若時間明顯不準，即使節點參數完全正確，也可能在 TLS 交握階段失敗。下載與啟動屬於本機準備工作，此時不必急著啟用 TUN，也先不要調整 DNS。將安裝、核心啟動與網路接管分開處理，能讓初次設定的故障範圍更清楚。

Windows：確認程式目錄與執行相依項目

依下載頁的說明執行安裝程式，或將壓縮檔完整解壓縮至有寫入權限的固定資料夾。不要直接從壓縮檔預覽視窗啟動主程式，也不要只抽出單一執行檔；缺少相關檔案可能導致介面或核心無法啟動。首次啟動若提示需要執行元件，請依該版本的說明安裝對應架構的相依項目。不要把缺少相依項目誤判為節點無法使用，兩者發生在完全不同的階段。

啟動後先檢查主介面與系統匣，確認沒有重複執行的執行個體。若記錄顯示本機連接埠已被占用，先結束其他代理用戶端，再重新啟動。若確實需要同時執行多個執行個體，必須為各執行個體設定不同的監聽連接埠，並明確指定哪個負責系統代理。初學者不建議這樣疊加使用。遇到防火牆提示時，也應依程式路徑與用途判斷，不要為了排錯一次關閉整個系統的防護功能。

macOS 與 Linux：區分安裝權限和接管權限

macOS 安裝後，先將應用程式移至固定位置再啟動。若遇到系統限制，先確認下載來源、套件類型及系統顯示的具體提示，再依系統允許的方式處理。不要照抄與目前系統無關的繞過指令。一般代理與 TUN 所需的權限不同，能開啟介面不代表可以建立虛擬網路介面。先完成一般代理驗證，只有確實需要接管更多應用程式時，再依用戶端提示授予相應權限。

Linux 請使用符合發行版的套件安裝方式，並留意套件管理工具回報的相依性錯誤。桌面用戶端應在一般使用者工作階段中執行；不要因為 TUN 需要權限，就預設長期以高權限執行整個桌面程式。啟動失敗時，檢查程式記錄、目錄寫入權限及桌面環境條件。系統代理設定通常依賴桌面環境，命令列程式是否使用代理則有自己的規則，不能用其中一項結果判斷另一項。

Android：完成授權後再檢查背景執行

Android 請依系統流程完成安裝，再開啟用戶端匯入設定。首次建立連線時，系統會要求授權建立 VPN 連線；這是用戶端接管流量的系統介面，不代表遠端節點已連線成功。若裝置上另有使用相同介面的應用程式，請先停止該應用程式，再啟動目前的用戶端。若啟動後立刻中斷，先檢查系統授權與應用程式記錄，不要直接刪除訂閱或修改所有節點參數。

完成一次前景連線後，再觀察鎖定螢幕或切換應用程式時是否中斷。部分系統會限制背景執行，可依裝置設定調整用戶端的電池使用與背景權限，但不必對所有應用程式取消限制。安裝階段的驗收目標是：介面正常、設定可儲存、核心能啟動，且記錄中沒有持續出現本機啟動錯誤。符合這些條件後，再匯入訂閱並選擇伺服器；授權的具體操作步驟可參考快速入門教學。

第四階段：匯入訂閱並管理使用中的伺服器

訂閱網址是取得設定的入口，通常包含與帳戶關聯的存取參數。只應在用戶端的訂閱設定中使用，不要貼到公開討論區、截圖或線上轉換工具。先確認取得的是訂閱網址還是單一節點分享連結：前者用於建立訂閱分組，後者通常從剪貼簿匯入。將網站帳戶網址貼進訂閱欄位，或把原生設定文字當成訂閱連結，都會造成解析失敗。

四個步驟建立訂閱分組

1. 開啟 v2rayN 的訂閱分組設定，新增分組，填入容易辨識的備註與完整訂閱網址。
2. 儲存分組後更新訂閱；第一次嘗試時，使用目前可正常運作的網路路徑取得設定。
3. 返回伺服器清單，確認節點確實歸入該分組，並查看更新記錄是否有解析錯誤。
4. 選擇一個節點並設為使用中的伺服器，接著再設定系統代理或啟動行動裝置上的連線。

範例網址可寫成 https://example.com/sub?token=xxxx，其中的網域與參數僅用來說明格式，並非可用的節點。貼上實際網址時，請檢查前後空格、換行與字元是否完整，尤其別漏掉問號後的參數。分組備註只影響本機辨識，不會改變連線參數。「啟用」通常決定該分組是否參與相關操作，實際行為以目前介面的說明為準。

了解更新間隔與請求方式

自動更新間隔用於定期取得最新設定，不必為了追求連線速度而設得太短。更新過於頻繁可能觸發訂閱服務的請求限制，也會增加排錯時的干擾。User-Agent 可能影響伺服器回傳的設定格式，通常保留用戶端預設值即可；只有訂閱提供者明確要求時才修改。若更新結果是網頁、登入頁面或不支援的格式，先檢查網址與回應內容類型，不要反覆覆蓋原本可用的分組。

訂閱更新要直連還是走代理，應依當下可用的網路決定。沒有任何可用節點時，強制透過不可用的代理下載訂閱，會形成無法自行排除的循環；已有正常代理，但訂閱網址直連失敗時，才考慮切換取得路徑。先記錄失敗發生在連線、驗證還是解析階段。更新失敗不一定會刪除現有節點，也不代表必須立即停用原有節點。

分清更新設定、測速與實際連線

更新訂閱用來取得參數，設為使用中的伺服器則是選擇目前使用的出口，兩者必須分別完成。節點測速也只代表某種測試在當下的結果。TCP 延遲主要反映建立 TCP 連線的狀況，無法涵蓋協定驗證、TLS、傳輸方式與目標存取。實際連線測試更接近真實請求，但仍會受測試目標、逾時設定與網路時段影響。不要只憑清單中最低的數字決定長期使用哪個節點。

Android 在分組或訂閱管理中新增網址並更新後，也要返回清單選擇節點，再啟動連線。不同用戶端的選單名稱可能略有不同，操作順序仍是取得設定、選定設定、啟動並驗證。第一次連線可參閱v2rayNG 節點選擇與代理生效驗證。處理分享連結和原生設定時，請參考訂閱格式與設定轉換說明，避免混用不同輸入格式。

第五階段：設定代理入口並驗證流量

桌面端先使用一般系統代理完成基本連線。選好使用中的伺服器後，開啟用戶端的系統代理選單，依需求選擇「自動設定系統代理」。這個步驟會將本機代理入口寫入系統設定，遵循該設定的應用程式才會把請求交給用戶端。用戶端必須保持執行；若程式已關閉，但系統代理仍指向本機連接埠，瀏覽器可能無法存取網路，但一般網路連線本身並未因此消失。

分辨三種系統代理操作

「自動設定系統代理」用於設定代理入口；「清除系統代理」用於移除相應的系統設定；「不變更系統代理」表示用戶端不主動修改目前的系統設定。最後一項不代表強制直連，也不表示系統中沒有其他程式留下的代理設定。切換用戶端或排查結束後無法上網時，請開啟系統網路設定確認實際狀態。不要只看系統匣選單文字，而忽略作業系統中仍生效的位址與連接埠。

為不讀取系統代理的應用程式個別設定

有些應用程式提供個別的 HTTP 或 SOCKS 代理選項，請依用戶端顯示的監聽類型與連接埠填寫。本機位址通常使用 127.0.0.1，連接埠則以目前設定為準，不要照抄其他裝置的數值。若入口需要帳號密碼，也必須填入相應資料。應用程式要求填寫代理 URL 時，還要確認通訊協定前綴；只填連接埠，不會讓兩種代理協定自動互通。

不要混淆本機監聽位址與遠端節點位址。應用程式代理應指向本機入口，遠端伺服器參數則由用戶端核心使用。只供本機使用時，維持迴路位址監聽；啟用允許區域網路連線會擴大可存取範圍，必須一併考量驗證與防火牆。區域網路中的其他裝置應填入用戶端所在裝置的區域網路位址，而非各自的迴路位址。一般個人使用不必為了測試而擴大監聽範圍。

用三種證據確認連線

先開啟一般可正常存取的目標，確認基本網路沒有中斷；再開啟需要代理的測試目標，確認網頁確實載入；最後搭配出口資訊與用戶端記錄判斷流量路徑。出口位址只能反映發出該請求的應用程式及當時的路由，不能代表其他應用程式的情況。若已啟用分流，直連目標顯示本地網路出口可能是預期結果，不代表代理一定失效。測試前應先寫明目標預期使用哪條路徑。

若瀏覽器可用，但某個應用程式失敗，優先檢查該應用程式支援的代理方式、個別設定與連線重用，不要立刻更換節點。切換代理後，已建立的長連線可能繼續沿用原路徑，可關閉相關連線或重新啟動測試應用程式再試。若所有應用程式都失敗，再檢查使用中的節點、核心記錄與本機監聽。完整的首次驗收步驟請參閱連線與代理生效驗證。結束用戶端後，也要確認系統代理是否已還原，完成整個使用流程的檢查。

第六階段：設定路由分流與 DNS 規則

完成一般代理連線後，再調整路由。路由規則決定進入核心的請求要走代理、直連或阻擋，通常依規則順序比對，實際行為則取決於目前的核心與規則類型。先使用用戶端提供的一般分流方案，再補上少數明確需求，比一開始就匯入龐大的規則集更容易維護。修改前記錄目前的路由方案、預設出口與規則順序，方便發生問題時還原。

由個別規則開始設定預設出口

優先處理明確的本機與內部資源，例如區域網路位址和內部網域，再處理特定服務網域，最後交由預設出口處理。需要精確控制的規則通常應排在範圍較廣的規則之前。網域規則與 IP 規則比對的資訊不同：請求保留目標網域時，才能進行網域比對；若只有目標 IP，可能需要解析結果或其他辨識方式。不要假設每個請求都同時帶有完整網域與位址資訊。

以下是 Xray 路由欄位的結構範例，只示範讓區域網路私有位址直連的寫法。這不是完整的用戶端設定，且必須已有標籤為 direct 的出口。若透過圖形介面設定，請使用用戶端提供的相應規則入口；不要將片段貼進訂閱網址或用來覆蓋整份執行設定。用戶端可能會重新產生設定，長期修改請儲存於用戶端支援的位置。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "ip": [
          "geoip:private"
        ],
        "outboundTag": "direct"
      }
    ]
  }
}

讓 DNS 路徑與目標出口相互配合

DNS 會將網域名稱轉換為位址，但由哪一方發起解析、解析請求走哪條路徑，以及解析結果如何參與路由，是三個不同問題。應用程式自行解析後將 IP 交給代理，與應用程式把網域交給代理再解析，行為並不相同。只修改作業系統 DNS，不一定會改變核心內部的解析方式；只修改核心 DNS，也不一定能限制應用程式內建的解析功能。先確認實際使用哪一層，再決定修改位置。

內部網域通常需要交由能辨識該網域的本機或組織 DNS 解析；代理目標則需要可用且符合存取路徑的解析方式。使用加密 DNS 時，也要考量解析服務本身的連線路徑，以及其網域第一次如何解析，以免形成相依循環。不要把「更換 DNS 位址」當成所有存取問題的通用解法。修改後應清除相關應用程式快取或重新建立連線，否則舊結果可能讓測試看起來毫無變化。

逐條驗證規則，不要只看模式名稱

每新增一條規則，都要分別測試一個應該命中的目標，以及一個不應命中的目標，並查看記錄中的目標與出口。若網站主要內容可以存取，但圖片或登入失敗，請檢查它依賴的其他網域是否被分配到不同路徑。需要 IP 區域資料庫或網域分類資料的規則，也仰賴相關資源正常使用；資源缺失、名稱不符或更新時間不同，都可能造成預期與實際結果不一致。

日常使用應以容易理解、方便還原為目標。為每條自訂規則記錄用途與測試目標，失效時先暫時停用新增規則。若只有少數應用程式需要特殊路徑，優先選擇適用範圍明確的方案，避免將整個網路改成複雜策略。

第七階段：依需求啟用 TUN 與虛擬網路接管

TUN 透過虛擬網路介面接入流量，適合無法直接設定代理、也不遵循系統代理的應用程式。它改變的是流量進入用戶端的方式，不會自動改善遠端節點品質，也無法消除線路壅塞。啟用前，必須先確認同一個節點在一般代理模式下能正常存取。否則一旦斷網，就無法確認節點狀態，也難以分辨虛擬介面、系統路由與 DNS 的問題。

先檢查權限、衝突與預設設定

桌面端建立虛擬介面或調整系統路由通常需要額外權限，請依用戶端提示處理，不要只因開關已啟用就認定流量接管成功。請查看記錄是否出現權限不足、介面建立失敗或路由寫入失敗。若裝置同時執行組織的網路工具、其他虛擬網卡或另一套流量接管程式，請先確認各自的使用需求；若不確定，先停止這次 TUN 測試，避免影響正在使用的工作連線。

首次啟用時，保留用戶端建議的堆疊、介面與路由參數，不要同時修改 MTU、DNS 劫持及嗅探選項。不同版本的 TUN 實作與設定入口可能不同，不要照抄另一個核心的欄位。系統代理與 TUN 是否同時啟用，也應依用戶端目前的實作方式判斷。測試時要明確指定哪個入口負責流量，不要靠重複啟用多個入口來掩蓋其中一個入口無法運作的事實。

分層驗證接管範圍

1. 保留已知可用的節點，啟用 TUN，確認核心持續執行且沒有重複錯誤。
2. 分別測試瀏覽器與一個原本不讀取系統代理的應用程式，觀察實際請求。
3. 存取本機路由器、印表機或內部服務，確認區域網路資源仍可依預期連線。
4. 檢查睡眠喚醒、切換網路及關閉 TUN 後，網路是否能正常恢復。

若外部目標可用，但區域網路資源失效，優先檢查私有位址排除、內部網域解析與路由優先順序，不要立刻更換節點。若網域存取失敗，但已知目標的連線狀況不同，應檢查 DNS 路徑；不能只憑某個 IP 可連線，就斷定所有解析都正常。若只有特定應用程式失敗，還要確認它使用的傳輸協定、連線方式與自身網路限制；TUN 不代表遠端具備所有轉送能力。

謹慎處理 UDP、IPv6 與 MTU

使用 UDP 的應用程式，需要入口、核心、所選節點與遠端服務共同支援相關流量。檢查 IPv6 時，也要一併確認系統位址、預設路由、DNS 結果及用戶端接管範圍。不能因 IPv4 測試成功，就推斷另一條位址路徑也正常。應分別查看實際連線目標與記錄，確認未被接管的路徑是否符合預期，不要一遇到問題就永久停用整類系統網路功能。

MTU 表示介面允許傳送的封包大小。某些線路上，較大的封包或額外封裝可能造成載入停頓，但類似現象也可能來自封包遺失、DNS 或伺服器。只有具備對照證據時才調整，並先記下原值。每次只變更一個參數，再以相同目標重測；若沒有改善就還原。隨意套用所謂的通用數值，會讓後續維護失去可靠基準。

Android 透過系統 VPN 介面接管流量，與桌面介面的 TUN 開關不必逐項對應。重點仍是系統授權、路由範圍、DNS 與背景持續執行。沒有明確需求時，維持已驗證的簡單設定即可。

第八階段：建立更新、備份與日常維護流程

能夠連線後，維護重點應從「不斷調整參數」轉為「維持可用基準」。記錄目前的用戶端分支、使用中的節點、路由方案、DNS 方案及是否啟用 TUN。不必記錄完整憑證，也無須保存每次測速結果；記錄的用途是讓下次發生故障時，能回答最近修改了什麼，以及上次正常時使用了哪些設定。日常更新也應以這個基準為依據，不要同時替換所有元件。

分開管理四種更新

用戶端更新會影響介面與設定管理；核心更新會影響協定與連線行為；訂閱更新會替換遠端節點參數；規則資源更新則可能改變分流結果。這些並不是同一種操作。有些版本提供整合更新入口，也應先閱讀提示，確認實際更新範圍。若沒有相容性需求，不必在同一時間更新用戶端、切換核心並刷新所有規則，再用一次存取結果判斷所有變更是否成功。

更新前先結束多餘的執行個體並儲存設定；更新後先用原節點與原路由完成一輪測試，再啟用新功能。若出現設定移轉提示，請確認舊資料是否仍能還原。不要讓新舊程式同時寫入同一個設定資料夾。需要回到舊環境時，請使用相容的備份；不同版本的資料結構可能變動，直接將新設定複製回舊程式，不一定能還原原本的行為。

以設定為單位備份，不公開敏感資料

優先使用用戶端支援的匯出或備份功能，保存分組、路由與必要的偏好設定。備份檔可能包含訂閱網址、使用者識別碼或服務參數，請存放在受控位置，不要上傳至公開附件區。移轉至其他裝置時，先還原訂閱與規則，再依目標裝置重新設定監聽連接埠、系統代理與 TUN 權限。不要把本機網路介面名稱或區域網路位址當成所有裝置通用的設定。

求助資料應與完整備份分開。求助時提供問題現象、平台、使用模式、重現步驟及去識別化的記錄即可。遮蔽位址中的存取參數、節點驗證欄位與帳戶資料，也要檢查截圖中的備註、QR Code 與剪貼簿區域。清除記錄時不必連同所有設定一起刪除；保留最近一次失敗前後的關鍵片段，比提交大量重複重試資訊更有用。

將日常異常拆解為可重複的檢查項目

訂閱突然無法更新，先檢查網址是否有效及取得路徑；只有一個節點失敗，先換同組已知可用的節點比對；所有節點都變慢，先檢查本機網路與裝置負載；只有特定目標異常，先確認目標本身及分流結果。速度問題應依節點、線路與本機設定分層處理，詳見v2rayN 速度慢的分層排查方法。不要用反覆重新安裝取代問題定位。

長期使用後，可清理失效分組、重複的手動節點及已無用途的規則，但要先確認使用中的設定不依賴它們。開機自動啟動與自動設定系統代理也需要一併檢查：用戶端未能啟動時，系統是否仍保留代理入口；網路尚未就緒時，自動更新失敗後是否會重試。睡眠喚醒、無線與有線網路切換，以及行動熱點切換，都值得做一次簡單驗收。

維護的目標不是讓記錄完全沒有提示，而是讓連線行為可以解釋。持續出現的錯誤需要找出原因；正常關閉或短暫切換網路所產生的記錄，則應配合前後文判斷。保留簡單且可重現的流程，比蒐集大量未經驗證的最佳化參數更有用。

第九階段：分層排錯並規劃進階學習

進階排錯要先弄清楚失敗發生在哪個環節，而不是先蒐集更多開關選項。建立固定檢查順序：本機網路、用戶端啟動、設定解析、本機入口、遠端連線、目標存取、路由與 DNS。每次只往已有證據支持的下一層檢查。瀏覽器顯示逾時，本身無法判斷問題出在憑證、解析還是路由；應搭配同一時間的用戶端記錄，確認請求是否進入、連到哪裡，以及在哪個階段中止。

依錯誤階段縮小問題範圍

啟動時立即出現解析錯誤，優先檢查欄位、格式與核心相容性；本機連接埠繫結失敗，檢查重複執行的執行個體與連接埠占用；連線至遠端逾時，檢查位址、連接埠、網路路徑與服務狀態；交握或驗證失敗，核對協定、使用者識別碼、傳輸方式與安全參數。若目標回傳明確的應用程式層錯誤，也要考慮目標服務本身的限制，不要把所有非成功回應都歸咎於代理用戶端。

遇到 TLS 問題，先核對裝置時間，再檢查伺服器名稱、憑證涵蓋範圍與憑證鏈。伺服器位址與 TLS 使用的名稱可以各自負責不同用途，但設定必須符合伺服器端需求。不要只為了讓錯誤訊息消失，就長期關閉憑證驗證；這會改變連線的驗證條件，並未修正名稱或憑證設定。具體檢查順序請參閱TLS 交握與憑證錯誤排查，修改前後都使用相同目標進行比對。

每次測試都固定輸入條件與判斷標準

測試效能時，固定裝置、網路、節點與目標，並區分建立連線所需時間與持續傳輸速度。小檔案載入慢可能與 DNS 或交握有關；持續下載速度慢則還要考量線路頻寬、壅塞與遠端負載。Mux 多工複用也不一定總是更快，它會改變連線的組織方式，效果取決於協定與網路環境。啟用前先記下原值，若測試結果沒有穩定改善就還原，不要只憑一次偶然結果保留複雜設定。

從圖形設定進一步學習閱讀設定

下一步可學習入站、出站、路由與 DNS 的設定結構，先將圖形介面中的選項對應到實際用途，再閱讀核心支援的欄位。用戶端產生的執行設定不一定是可長期編輯的位置，手動修改可能在重新啟動時遭到覆蓋。使用自訂設定功能時，先準備獨立的測試設定，不要覆蓋日常可用方案；範例中的出口標籤、資源名稱與相依項目也都要逐一確認。

需要在路由器或旁路由部署時，再進一步學習系統轉送、策略路由、透明代理與 DNS 迴圈。這是網路設備層級的新主題，不是把桌面用戶端的 TUN 參數原封不動搬過去。請先閱讀Xray 路由器與旁路由部署概覽，了解主路由器與旁路由的職責；準備好本機還原方式後再進行測試，以免修改預設閘道後無法開啟管理介面。

最終應能完成三件事：用最精簡的設定建立連線、根據證據說明每條流量的去向，以及發生異常時還原至已知可用狀態。遇到新問題時，先回到本頁對應的階段，不必從頭重新安裝。初次設定可沿著快速教學的訂閱匯入步驟再次核對；更換裝置或用戶端時，請回到下載頁重新確認平台與架構。維持清楚的層級界線，進階設定才有可靠的基礎。