V2Ray 完整手冊v2rayN 設定與維護

核心概念：客戶端、核心與連線流程

圖形介面與代理核心的分工

V2Ray 通常泛指 Project V 相關的代理技術與工具生態，並非特定的桌面程式。v2rayN 是圖形介面客戶端，負責保存伺服器資料、管理訂閱、產生執行設定並呼叫核心。核心則負責監聽本機連接埠、處理協定、比對路由並建立對外連線。介面能正常開啟，不代表核心已成功執行；伺服器清單中有資料，也不代表目前選取的伺服器可用。

V2Fly 延續 V2Ray 相關開發，Xray 則是同一生態系中的另一條核心發展路線。兩者的協定能力與設定細節有所不同，不能只因名稱相近，就認定所有參數都能互換。v2rayNG 主要使用 Xray 核心，v2flyNG 則使用 V2Fly 核心。若節點無法匯入，先確認客戶端與核心是否支援該節點使用的協定和傳輸方式，不要一再修改連線位址。

從應用程式到伺服器的實際流程

在一般系統代理情境中，應用程式會先讀取系統代理設定，再將要求傳送至本機監聽連接埠；核心收到要求後比對路由，決定直接連線至目標，或透過遠端伺服器連線。遠端伺服器接著存取目標服務並回傳資料。整個流程至少涵蓋應用程式、本機監聽、規則判斷與遠端連線四個環節。逐一排查，才能分辨是應用程式未使用代理、核心未啟動、路由錯誤，還是伺服器無法連線。

節點是一組連線參數，常見欄位包括伺服器位址、連接埠、使用者識別碼、協定、傳輸方式與安全設定。訂閱則是用來批次取得這些參數的位址，也可能包含群組資訊或服務說明。訂閱位址不是本機代理位址，不能填入瀏覽器的代理連接埠欄位。客戶端提供連線工具；實際連線仍須使用已獲授權且有效的伺服器設定。

協定、傳輸方式與安全層

VMess、VLESS、Trojan 等名稱主要指代理協定；WebSocket、gRPC 等指傳輸方式；TLS、REALITY 等則與連線安全機制有關。同一個節點可能包含多個層次，任何一層設定錯誤都可能導致連線失敗。伺服器位址不一定與 TLS 使用的伺服器名稱相同，路徑和服務名稱通常也必須完全符合。請依照設定提供者給的欄位匯入，不要把不同範例的參數拼成同一個節點。

DNS 是將網域名稱解析為位址的過程，可能由系統、應用程式、客戶端或遠端端點執行。解析位置會影響連線結果，尤其是依位址比對的規則。網域名稱能解析，只表示已取得位址；連接埠能連線，也只表示傳輸連線建立到某個階段。瀏覽器最後能否取得內容，還要看交握參數、憑證、目標服務與應用程式本身的設定，不能用單一測試取代完整存取驗證。

開始設定前，先整理自己的連線流程：哪個應用程式發出要求、使用哪個入口、符合哪條規則，以及選用哪台伺服器。先記下這四項即可，不必一開始就研究所有核心選項。後續各章會逐步說明流程中的各個環節。遇到不熟悉的術語時，先判斷它屬於入口、規則還是出口，再決定要修改哪裡，避免同時變更多個位置而造成混亂。

選擇客戶端：平台、架構與介面版本

桌面裝置優先選用 v2rayN

桌面裝置建議優先選用 v2rayN，再依作業系統、處理器架構與發行形式選擇安裝方式。跨平台桌面版支援 Windows、macOS 與 Linux；WPF 版則適用於 Windows。兩種介面都以伺服器、訂閱與路由管理為主，但選項位置、視窗配置與執行相依項目可能不同。不要為了完全符合舊截圖而更換整套安裝方案，先找出功能名稱與設定用途。

Windows 使用者若要在桌面版與傳統 WPF 版之間選擇，可先考量現有的使用習慣。希望在不同裝置上維持相近的操作方式，可以優先試用桌面版；若現有 WPF 工作目錄與設定運作穩定，請先備份再評估是否遷移。兩種版本不要共用同一個可寫入的設定目錄，也不要同時接管系統代理。若想了解介面差異，請參閱桌面版與 WPF 版的差異。

處理器架構與安裝格式

架構表示程式適用於哪一類處理器，與網路模式無關。macOS 可在「關於這台 Mac」查看晶片資訊，再選擇相符的安裝方式；Linux 可執行下方命令查看機器架構，常見的 x86_64 對應 x64，aarch64 對應 arm64。套件格式也必須符合發行版，不能把某一種發行版的套件直接當成另一種格式使用。安裝失敗時，先確認這些基本條件，再查看執行記錄。

uname -m
cat /etc/os-release

Android 通常建議優先選用 v2rayNG。較新的主流裝置多採用 arm64，但仍應以裝置實際支援的應用程式架構為準；若無法確認或遇到架構不符的提示，可查看通用版本。若需要 V2Fly 核心或想確認相容性，則可考慮 v2flyNG。切換客戶端不應是第一個排錯步驟，請先確認訂閱有效、協定受到支援，並確認裝置時間與網路正常。

遷移前確認設定的界線

不同客戶端的設定備份不一定能直接互相匯入。相較於複製整個資料夾，標準節點分享連結通常更方便遷移，但仍須視兩端支援的協定欄位而定。訂閱群組、路由規則、快速鍵與介面偏好可能是客戶端專屬設定，建議分別記錄。準備切換時，先保留原客戶端並關閉其代理接管功能，再到新客戶端測試一個節點；確認基本連線正常後，再遷移複雜規則。

各平台的安裝方式請參閱客戶端下載頁面。選擇順序建議依作業系統、架構、介面形式，最後才考量個人偏好。如果裝置由公司或機關管理、沒有管理員權限，或無法安裝虛擬網卡，也應預先評估是否只使用應用程式代理。一般代理能運作，不代表一定有權限啟用 TUN。將權限限制納入安裝規劃，比反覆更換安裝套件更容易找到合適方案。

安裝設定：工作目錄與首次啟動

選擇方便維護的安裝位置

先從下載頁面選擇正確的安裝方式。安裝程式依提示選擇位置；使用壓縮檔則先完整解壓縮，再從解壓縮後的資料夾執行程式。不要直接在壓縮軟體的預覽視窗中啟動，因為暫存解壓縮目錄可能缺少核心、資源或寫入權限。工作目錄應易於辨識和備份，避免混放不同版本的檔案。採用可攜式執行方式時，也要確認設定實際儲存的位置，不要假設所有資料都在執行檔旁邊。

Windows 首次啟動 v2rayN 時，若提示缺少執行元件，請依提示安裝相符架構的執行環境，再重新啟動客戶端。不要任意複製系統程式庫檔案來解決相依問題。如果程式一啟動就關閉，先查看客戶端資料夾中的記錄或系統事件資訊，分辨是缺少相依項目、權限不足，還是遭安全軟體封鎖。安裝步驟請參閱Windows 安裝與首次啟動故障排除。

確認核心與監聽狀態

介面啟動後，先查看記錄區是否出現啟動失敗、找不到檔案或連接埠繫結失敗等訊息。新增節點並啟動服務後，才能確認核心是否確實在監聽。常見的本機入口會搭配回環位址與監聽連接埠，實際連接埠值請以目前的參數設定為準。舊教學中的連接埠僅供理解，不要直接套用到目前設定；不同版本也可能採用合併入口，不一定各自使用兩種獨立連接埠。

在 設定 → 參數設定 → Core 基礎設定 附近確認本機監聽相關選項。SOCKS 與 HTTP 入口適用的應用程式類型不同；設定應用程式代理時，協定、位址與連接埠必須一致。初次設定請使用回環監聽，只有確實需要提供其他裝置使用時，才考慮改為區域網路監聽。開放區域網路會擴大可存取範圍，須一併設定存取限制、防火牆與裝置信任範圍。

netstat -ano | findstr :10808

上方是用來查看 Windows 連接埠占用情況的命令，實際檢查時請將連接埠號碼換成參數設定中的值。輸出結果最後一欄可用來識別處理程序，確認其用途後再決定是否關閉或調整。不要看到連接埠被占用就直接終止不熟悉的系統處理程序。若是另一個代理程式占用，先關閉重複執行的程式；若連接埠正由正常應用程式使用，可更改監聽連接埠，再同步更新手動設定代理的應用程式。詳細作法請參閱本機連接埠衝突處理。

其他桌面與行動裝置

macOS 安裝後，依系統提示允許開啟，並先確認安裝來源與應用程式身分。不要為了授權單一應用程式而全面關閉系統防護。Linux 請使用發行版對應的套件管理工具安裝；若出現相依項目提示，先確認缺少哪些元件。桌面環境、圖形顯示後端與系統匣支援可能影響介面運作；關閉視窗不一定會結束處理程序，請同時查看系統匣與處理程序清單，確認程式是否仍在背景執行。

Android 安裝客戶端後，首次啟動連線時通常會出現系統 VPN 授權提示，這是建立流量入口所需的系統許可。先匯入有效設定，再確認提示是由目前使用的應用程式提出。首次驗證時先關閉其他會接管網路的工具，避免多個入口互相衝突。完成標準不是「程式已開啟」，而是能找到設定位置、看懂啟動記錄，並確認目前服務是否正在執行，為下一章匯入訂閱做好準備。

訂閱管理：匯入、更新與分組

先建立群組，再更新伺服器

訂閱位址通常包含個人存取識別資訊，應視同帳號憑證管理。僅向獲授權的設定提供者取得訂閱位址，不要將完整連結貼到公開留言、截圖或線上轉換網站。訂閱位址能在瀏覽器中開啟，不代表回傳內容適用於目前的客戶端；內容可能是帳戶頁面、錯誤訊息或其他格式。匯入前請確認位址完整，沒有混入說明文字、換行或通訊軟體自動附加的標點符號。

在 v2rayN 中先前往 訂閱分組 → 訂閱分組設定，新增群組並填寫方便辨識的備註，再貼上訂閱位址。儲存後，更新該群組，或選擇更新所有訂閱。不同版本可能將群組功能放在選單或清單工具列，重點是先儲存位址，再執行更新。只貼上位址而未更新，伺服器清單通常不會立即出現內容；只新增備註也不會產生節點。

更新完成後先查看記錄，再確認清單中的群組。若顯示成功但清單為空，可能是內容格式不受支援、位址回傳錯誤頁面，或目前的篩選條件隱藏了所有伺服器。先清除搜尋與篩選條件，再切換到對應群組確認，不要立刻刪除原有設定。若相同位址在另一台裝置上正常，請比較兩端的客戶端功能與更新時間，有助於判斷是相容性差異，還是網路取得失敗。

更新節點與手動修改的關係

訂閱提供者可能調整伺服器位址、備註與參數；下次更新時，客戶端可能依自身規則重建或取代部分項目。直接修改訂閱節點不一定能長期保留。需要測試時，可先複製成獨立的手動節點並註明用途，再修改單一參數；批次更新後，不要只憑舊備註就認定它仍是相同設定。測試結束後請刪除暫存副本，避免日後誤選已過期的參數。

多個訂閱應依來源或用途分別建立群組，不要全部放在同一組，再只靠備註辨識。關鍵字篩選只會縮小顯示範圍，不代表刪除節點，也不會修改路由。篩選後設定使用中的伺服器時，請確認它屬於預期群組；更新後若目前選取的項目有所變動，也要重新確認。更多整理方式請參閱訂閱分組與伺服器篩選。

逐步判斷訂閱更新失敗的原因

更新失敗時，先確認取得訂閱的階段是否出錯。連線逾時表示取得位址的網路路徑有問題；回傳內容無法解析，則應確認收到的內容是否真的是訂閱資料。如果客戶端提供直連更新與透過代理更新兩種方式，請依目前的連線狀況選擇。尚未建立可用代理時，若強制透過代理更新，容易陷入「要先更新才能連線，卻要先連線才能更新」的循環；可先用仍有效的設定驗證取得訂閱的路徑。

不要反覆點選更新，並把它當成修復方法。先確認訂閱帳戶與位址狀態，再檢查網路、系統時間和錯誤記錄；服務端暫時無法使用時，保留目前有效的項目通常比刪除後重建更穩妥。對外分享記錄前，請遮蔽完整位址、使用者識別碼與伺服器資訊。可參考訂閱更新失敗與解析結果為空的檢查清單逐項確認；處理後重試一次，並記錄錯誤是否有變化。

本階段的完成標準是：至少有一個群組可以更新、能找到其中一項設定，並知道如何將它設為目前使用的伺服器。訂閱更新成功與節點連線成功是兩回事。前者表示設定已取得，後者還取決於伺服器、協定與入口設定。先釐清這兩種結果，後續檢查系統代理時，才不會混淆取得設定的問題與實際存取問題。

代理模式：系統入口與連線驗證

系統代理不會接管所有裝置流量

選好目前使用的伺服器並確認核心已啟動後，再設定系統代理。v2rayN 可從主畫面或系統匣的系統代理選單，選擇自動設定系統代理；實際選項名稱請以目前介面為準。這項操作會將本機代理位址寫入系統設定，只有遵循系統設定的應用程式才會使用它。部分程式使用自有網路堆疊，或在程式設定中固定代理方式，即使已啟用系統代理，也可能仍然直接連線。

清除系統代理通常只會還原系統入口，不一定會停止核心監聽。此時，手動指定本機連接埠的應用程式仍可能透過客戶端連線。反過來說，直接關閉客戶端也不代表所有環境都會自動清除先前寫入的系統設定。因此，應分別檢查系統代理、核心執行狀態與應用程式設定，不能只看系統匣圖示。準備離開時，先清除系統代理再正常結束程式，可減少應用程式繼續連線到失效本機連接埠的情況。

手動設定應用程式代理與連接埠

如果應用程式支援手動設定代理，主機通常填寫 127.0.0.1，連接埠則填入客戶端目前的監聽值，並選擇相符的 HTTP 或 SOCKS 類型。這個回環位址指向本機，不是遠端節點伺服器。直接將遠端節點的連接埠填入一般應用程式的代理欄位，通常無法連線，因為應用程式不會代替客戶端處理節點協定與驗證。若要讓其他裝置共用，也不能直接沿用回環位址。

首次驗證時，選擇一個能明確重現問題的存取目標，先記錄關閉代理時的結果，再啟用系統代理重試。應用程式可能保留連線池和舊頁面快取，必要時請完全結束程式再重新啟動。查看客戶端是否出現對應的連線記錄，並確認流量的出口方向。如果客戶端沒有收到要求，應先檢查應用程式入口，而不是更換遠端伺服器；若已收到要求但連線失敗，再沿著路由與出口逐步排查。

區分測試結果與實際使用狀況

清單中的延遲測試、連線測試與實際網頁存取，可能使用不同的目標、協定與計時方式。單次測試數值不能代表所有網站的速度，也不能保證影片、下載或即時應用程式都能正常運作。測試失敗時也要查看實際原因：測試服務無法連線，與節點無法連線是兩種不同問題。固定裝置、目標與模式後再進行比較，結果才有參考價值。

瀏覽器正常但其他應用程式失敗時，先確認該程式是否支援系統代理、是否啟用了獨立代理，以及是否保留舊的環境變數。開發工具、終端機與桌面程式的設定通常互不相通。排查時不要一次替所有應用程式設定代理，否則難以判斷實際生效的是哪種入口。先讓一個應用程式透過明確設定正常運作，再逐步還原其他程式原本的設定，比較容易找出設定互相覆蓋的原因。

若啟用系統代理後，所有遵循系統設定的應用程式都無法存取網路，先檢查本機連接埠是否仍在監聽、目前使用的伺服器是否已刪除，以及核心記錄是否出現錯誤。暫時清除系統代理，確認一般網路能否恢復，是區分本機入口問題與基本網路問題的重要步驟。更多常見問題請參閱常見問題；完成本章後，應能判斷某個要求是否已進入客戶端。

路由分流：比對順序與 DNS 條件

先使用預設規則，再新增例外

路由會將已進入核心的要求分類，再決定直接連線、透過代理或阻擋等處理方式。v2rayN 可在路由設定中選擇預設規則，例如 繞過中國大陸（Whitelist）。這類模式通常依網域名稱和位址規則安排直連或代理，但實際涵蓋範圍仍取決於規則內容與資料檔。模式名稱僅供參考，不能據此推斷特定網域一定符合哪條規則。

初次使用時，先保留一組符合需求的預設規則，確認常用應用程式正常後，再新增少數明確的例外。若暫時切換成全部走代理後，目標便能存取，可懷疑原本的規則選了不同出口，但仍須查看記錄確認。不要因此認定「全部走代理永遠比較適合」，因為本機服務、區域網路位址與部分帳戶服務可能仍需要直接連線。

規則順序、涵蓋範圍與預設處理方式

常見規則會依順序檢查，由第一條符合的有效規則決定處理方式；實際細節應以核心和客戶端產生的設定為準。特定網域的例外應放在涵蓋範圍較大的分類規則之前，否則可能永遠不會套用。新增規則時，至少記錄比對條件、目標出口、插入位置與預期結果。只儲存網域卻沒有選對出口，或將例外放在已涵蓋該網域的規則後面，都容易誤以為「規則沒有生效」。

完整網域名稱與網域後綴涵蓋的範圍不同。若只想處理單一主機，請避免使用會涵蓋整個網域的寫法。網站也可能依賴登入、圖片和 API 等其他網域；主頁正常不代表所有相依要求都正常。請依失敗的要求補上必要條件，不要把大量無關網域加入例外。如果不確定客戶端輸入欄位採用哪種語法，先查閱欄位說明，不要將核心原始欄位直接貼入任意介面。

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

上方是 Xray 路由規則物件範例，並非完整的執行設定。範例展示精確網域、網域後綴與出口標籤之間的關係；只有將它放進完整設定的規則陣列，且存在名為 direct 的出口時，才會產生相應作用。範例網域僅用於說明格式。使用圖形客戶端管理設定時，請優先使用路由編輯功能，不要直接修改自動產生的檔案，否則下次啟動或切換節點時，手動變更可能會被覆蓋。

DNS 與位址規則的關係

依網域比對的規則需要核心取得網域資訊；依位址比對的規則則取決於實際解析出的位址。如果應用程式先自行解析，只提交位址，網域規則可能會缺少比對條件；核心也可能依設定執行額外解析。流量嗅探可在部分協定中協助取得網域線索，但不一定適用於所有流量，也須考量相容性。不要把啟用嗅探當成解決所有分流問題的通用開關。

排查分流時，固定一個目標與一台目前使用的伺服器，記錄原本的模式，再暫時新增一條涵蓋範圍最小的例外。比較連線記錄中的目標與出口方向，必要時清除應用程式快取並重新建立連線。規則儲存後，既有的長連線不一定會立即重新建立。測試完成後，移除無效例外，避免規則越積越多。穩定的規則清單應能說明每條規則的用途，而不是不斷追加規則來維持偶然可用的狀態。

TUN 模式：接管範圍與還原順序

一般代理可用後，再啟用 TUN

TUN 透過虛擬網路介面與相關路由設定，將符合條件的流量導入客戶端處理。適合無法使用一般系統代理的應用程式，但不代表所有協定、網路介面和網路環境都一定相容。請先確認一般代理正常，再試用 TUN，這樣發生問題時才能判斷是否出在流量接管階段。若節點本身無法連線，啟用 TUN 通常只會增加排查環節，不會修正錯誤的出口參數。

在 v2rayN 中找到 TUN 模式開關與相關設定，確認目前版本所需的權限和元件。啟用時可能需要提高權限，才能建立介面或調整系統路由。僅對來源明確的客戶端授予必要權限。公司或機關管理的裝置、受限帳戶或特殊桌面環境可能禁止這些操作，請遵守裝置管理政策，不要透過修改全域安全設定強行繞過限制。

入口疊加與路由衝突

首次啟用時，保持其他條件不變，只新增 TUN 這一項。是否保留系統代理，應依目前客戶端的實作與說明判斷；兩種入口同時啟用可能改變要求的連線路徑，不要隨意開關兩者並同時判斷結果。也請暫時關閉其他 VPN、虛擬網卡工具或會接管路由的軟體。多個工具同時修改預設路由時，流量由誰處理以及如何還原都會變得難以判斷。

啟用後應立即檢查區域網路存取，包括路由器管理頁面、印表機、檔案共享與本機開發服務。若這些目標無法使用，請確認私有位址、回環位址與本機網段的繞過設定，不要將所有本機位址都送往遠端。多張網路介面卡、網路分享熱點與虛擬機器網路也須分別測試，因為它們可能使用不同網段。接管範圍應依實際網路架構設定，不要直接照抄他人的網路排除清單。

DNS、UDP 與應用程式行為

在 TUN 情境中，DNS 要求可能經由不同路徑傳送。應用程式使用自己的加密解析、系統保留快取，或特定查詢繞過預期入口，都可能造成結果與一般代理不同。請先確認網域能否解析，以及解析要求實際經過哪裡，再判斷連線是否經規則送往預期出口。不要同時修改 DNS 上游、路由模式與 TUN 協定堆疊；每次只變更一項條件，才能回復到已知正常的狀態。

部分即時應用程式和協定會使用 UDP，能否正常運作仍取決於本機接管方式、核心能力、節點設定與遠端服務。瀏覽器能開啟網頁，不代表這條連線中的 UDP 也能正常使用。請用發生問題的應用程式進行針對性測試，並查看是否有對應的連線與錯誤記錄。如果只有特定類型的應用程式異常，先比較其傳輸與 DNS 特性，不要直接認定整個 TUN 功能失效。

若關閉開關後仍有異常，請正常結束客戶端，再檢查系統是否仍保留虛擬介面、舊代理或其他工具的連線設定。優先使用客戶端提供的還原功能，必要時重新啟動系統，不要任意刪除不熟悉的網卡與路由。基本網路恢復後，先確認一般代理正常，再單獨啟用 TUN。記錄問題最早出現在建立介面、DNS 查詢或連線至目標的哪個階段，有助於大幅縮小後續排查範圍。

完成本章須同時符合三個條件：需要接管的應用程式能正常使用、本機網路服務仍可存取，以及關閉模式後網路能夠恢復。若只有前兩項正常，退出後卻無法恢復網路，就不適合作為日常預設設定。將 TUN 視為有明確用途的入口方案，而不是所有裝置都必須啟用的功能，更容易維持清楚且可還原的網路環境。

日常維護：備份、更新與故障記錄

分開處理設定備份與更新

確認運作穩定後，先找出客戶端設定的儲存位置，再安排備份。備份內容應包含需要保留的訂閱群組、手動節點、路由與個人化設定；能否直接複製資料夾，須視目前的安裝方式而定。複製前請先結束客戶端，避免資料庫或設定檔仍在寫入。訂閱位址與使用者識別碼屬於敏感資料，備份檔也應限制存取，不要預設同步到所有共用裝置或公開空間。

更新客戶端、更新核心、更新訂閱與更新規則資料是不同操作。客戶端更新可能變更介面與設定格式；核心更新可能改變協定行為；訂閱更新會修改伺服器參數；規則資料更新則會影響分類判斷。出現異常時，應確認最近執行的是哪一種更新。不要在同一次維護中同時更換客戶端、核心、節點與規則，否則很難找出造成結果變化的因素。

更新前後的比較流程

更新前先記錄目前的安裝方式、使用中的伺服器、代理入口與路由模式，並保留可還原的設定備份。正常結束客戶端後再進行更新，避免背景核心占用檔案。更新完成後，先用原本的簡單設定測試，不要立刻匯入新的複雜規則。若客戶端提示要轉換設定，請先閱讀提示內容；較新的設定格式未必能由舊版本讀取，因此回退程式版本時，也須一併還原先前的設定備份。

待基本連線流程穩定後，再設定自動啟動與自動連線。開機時網路可能尚未就緒，訂閱更新或連線失敗不一定表示節點已失效。先確認網路就緒後手動重試的結果，再評估啟動順序。若 Android 裝置的背景連線經常中斷，可檢查系統對客戶端的電池最佳化與背景執行限制，只調整必要項目，不要為了單一應用程式而關閉所有裝置管理功能。

依階段閱讀記錄

查看記錄時，先找出最早出現的相關錯誤，不要只盯著最後一行。啟動階段的連接埠繫結失敗，會讓後續所有應用程式要求都無法成功；訂閱取得錯誤則未必會影響既有節點。連線逾時、名稱解析失敗、驗證或交握失敗，應分別從網路、DNS 與參數層面排查。相同錯誤文字也可能出現在不同目標，閱讀時須一併確認時間、目標位址與操作步驟。

操作：更新指定訂閱群組
入口：一般系統代理，已關閉 TUN
現象：更新失敗，既有節點仍可連線
比較：清除系統代理後再次更新
記錄：保留相關時段的錯誤，移除敏感位址

上方的記錄格式不包含真實憑證，適合整理自己的排查過程。分享時應隱藏完整訂閱位址、伺服器網域或位址、使用者識別碼與個人目錄名稱；若記錄中包含要求目標，也應依實際需要去識別化。不要只貼一張裁掉前後文的錯誤截圖。提供客戶端類型、作業系統、操作順序與最後一次正常狀態，比反覆貼上大量截圖更有助於重現問題。

例行檢查：退出與還原

日常結束使用時，先關閉不再需要的 TUN，再清除系統代理，最後正常結束客戶端。如果應用程式手動設定了本機代理，也須一併還原，否則即使系統代理已清除，應用程式仍會繼續連線至本機連接埠。切換網路後若出現異常，先確認基本網路與認證頁面是否可用；公共網路尚未完成登入時，代理軟體無法取代網路本身的登入程序。

維護的目標是保留一組已知可用的基準：一台可用伺服器、一種明確的入口、一套能說明用途的路由，以及一份可還原的備份。遇到問題時先回到這組基準，再逐項恢復其他功能。定期清理暫存節點、過期例外與重複群組，可減少誤選與規則衝突。如果問題能歸納為固定類型，可至常見問題依現象檢查，不必每次都從重新安裝開始。

進階路線：理解設定與單一變因驗證

先釐清要解決的問題

進階使用不代表開啟所有高階選項，而是能說明一項要求如何經過設定處理。先寫下具體需求，例如某個開發工具需要獨立代理、某個網域必須直連，或某個應用程式需要由 TUN 接管。確認目標後，再選擇涵蓋範圍最小的設定。如果一般系統代理已符合需求，就不必只因選單中有相關選項，便啟用虛擬網卡、自訂 DNS 與複雜的多出口規則。

建議依序學習：檢視目前設定、理解產生的設定內容、驗證單一規則，最後才研究自訂設定。客戶端通常會依節點、路由與全域參數產生核心設定，因此原始設定檔並非所有設定的唯一來源。先找出圖形介面選項對應的欄位，觀察儲存前後的變化，再確認其影響範圍。直接整份取代執行檔案，可能導致介面狀態與實際設定不一致，也會增加後續維護難度。

認識入站、出站與標籤參照

原始設定中的入站負責接收流量，出站負責建立後續連線，路由則負責將符合條件的要求分配給出站。標籤用來在這些部分之間參照物件，標籤名稱本身沒有固定的特殊含義。若參照了不存在的出站標籤，或重複使用容易混淆的標籤，設定就無法依預期運作。閱讀範例時應同時找出定義與參照，不要只複製看起來相關的單一區段。

以下是可獨立閱讀的 Xray 最小設定範例：在本機建立 SOCKS 入口，再將收到的要求直接連線至目標。範例不包含遠端代理節點，也不能取代訂閱。連接埠必須未被使用，也不應與執行中的客戶端入口衝突。範例用於了解欄位之間的關係，日常設定仍建議透過圖形客戶端管理；測試結束後請停止測試執行個體，避免背景留下重複的監聽程序。

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10818,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ],
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    }
  ]
}

建立單一變因測試方法

測試時固定應用程式、目標與網路條件，每次只變更一項設定，並記錄原始值。若要驗證網域規則，就不要同時更換伺服器與 DNS；若要判斷 TUN 是否影響本機服務，先維持路由不變，只切換入口。結果不如預期時，先還原原值，再安排下一次比較。這種方法看似較慢，卻能避免多項變更互相抵銷，最後無法判斷真正生效的是哪一項。

複雜需求應拆成可獨立驗收的小任務。先讓應用程式明確使用本機代理，再加入目標網域例外，最後觀察切換網路後的行為。每個步驟都應訂定成功條件與還原方式。若連線池、DNS 快取與長連線造成結果延遲，請重新啟動應用程式或重新建立連線進行比較，不要一再重複儲存設定。保留一份簡單的測試設定，比維護大量用途不明的規則更有價值。

停止擴充，回到基準設定

若問題涉及伺服器端協定參數、帳戶狀態或遠端服務限制，客戶端能做的主要是提供明確的現象與記錄。不要為了掩蓋遠端錯誤而無止境地新增本機規則。向設定提供者回報時，說明協定類型、失敗階段與已完成的比較測試，並移除個人憑證。對於尚未確認支援的功能，請先核對客戶端與核心能力，不要只憑名稱相近就推斷相容。

完成這條路線後，應能從入口、規則與出站三個方向說明問題，並知道哪些設定屬於客戶端、哪些屬於核心，以及哪些需要伺服器配合。需要重新操作連線流程時，請返回快速入門教學；需要更換安裝形式時，請參閱客戶端選擇指南與下載頁面。保留簡單且可用的基準設定，再依實際需求逐項擴充，就是這份手冊的最佳使用方式。