V2Ray 全平台
安裝與設定手冊

準備工作與設定範圍

先分清用戶端、核心與服務設定

v2rayN 是桌面圖形化用戶端，負責管理訂閱、產生設定並啟動核心；v2rayNG 與 v2flyNG 則適用於 Android。核心負責實際連線、協定處理及路由執行。Project V 是相關開源生態的起點，V2Fly 與 Xray 則是不同的核心發展路線。安裝好用戶端，不代表已有可連線的服務設定；還需要準備經授權的訂閱網址或單一分享連結。

桌面端建議優先選用 v2rayN。Android 通常可先從 v2rayNG 開始；需要相容 V2Fly 設定時，再考慮 v2flyNG。選擇用戶端時，別只看名稱或功能多寡，應確認目前的核心是否支援設定所需的協定、傳輸方式與安全選項。例如，REALITY 設定需要相應支援，不能只更換核心名稱就認定相容。詳細差異請參閱Xray 與 V2Fly 核心選擇比較。

下載前確認系統與網路環境

前往下載用戶端，先選擇作業系統，再確認處理器架構與套件類型。系統架構與應用程式架構要分開確認：能透過相容層執行某個程式，不代表它就是目前裝置最適合的安裝套件。桌面裝置可在系統資訊中查看處理器；Android 裝置可查閱規格，不確定時請選擇下載頁提供的通用套件。不要只憑裝置外觀或購買年份猜測架構。

開始前，記下目前代理、VPN、虛擬網卡與安全軟體的狀態。若同時啟用多個會接管網路的工具，之後便難以判斷流量走向。先關閉其他代理用戶端，保留原始網路環境，確認一般網路連線正常，並讓系統自動同步時間。加密連線需要正確時間；時鐘偏差可能導致憑證驗證失敗，不應以關閉驗證來掩蓋這類錯誤。

整理訂閱並備份

訂閱網址是取得設定的入口；分享連結則代表單一設定，兩者不可混用。訂閱通常是 HTTPS 網址，回傳內容可能是編碼後的設定集合；分享連結則帶有協定前綴。用戶端通常會提供不同的匯入入口。複製網址時請保留查詢參數，並檢查首尾是否有空格或換行；不要把瀏覽器登入頁面的網址誤當成訂閱網址。格式詳情請參閱訂閱連結與分享格式說明。

大幅調整路由、DNS 或核心之前，請使用用戶端提供的匯出或備份功能保存目前設定。設定可能包含訂閱參數、使用者識別資料與服務網址，備份應存放在自己能妥善管理的位置。尋求協助時，只提供錯誤類型、發生時間與必要的設定結構，並遮蔽身分欄位。切勿在公開討論區貼出完整訂閱網址，也不要把含有憑證的設定複製到線上轉換網站。

建立可復原的驗證流程

首次設定請依序進行：安裝、匯入、選取設定、啟動核心、啟用流量入口、驗證連線。一次只調整一類設定，確認結果後再處理下一項。先用系統代理驗證基本連線，再評估是否需要 TUN；先用預設路由確認通訊正常，再新增自訂分流。如此一來，每次變更都有明確的起點，發生異常時也能退回上一個可用狀態，不必同時猜測多個參數。

下文提到的本機連接埠數字只用於說明設定關係，不代表用戶端固定的預設值。請在目前的設定頁面確認實際監聽連接埠，再填入應用程式。訂閱內容也不會自動決定所有本機設定：系統代理開關、權限、路由與 DNS 仍須個別確認。使用前請了解所在地網路與裝置的管理規範，並在獲准使用的環境中完成設定。

Windows：安裝 v2rayN 與匯入訂閱

選擇桌面版或傳統 WPF 版

在Windows 下載專區選擇 v2rayN。桌面版採用跨平台介面；傳統 WPF 版則延續 Windows 的介面設計。兩者差別在介面與應用程式的組織方式，而非服務設定所使用的協定。初次安裝選一種即可；若要遷移，請先備份原有設定，再確認新介面的匯入入口、監聽連接埠與代理模式。不建議同時讓兩套程式接管系統代理。

執行安裝程式時，依照提示選擇可寫入的位置。若採用解壓縮版，請保留完整目錄，不要只把主程式移到桌面。用戶端需要存取相關檔案與設定目錄；若缺少核心，或檔案遭安全軟體隔離，可能會出現介面能開啟、連線卻無法啟動的情況。若看到執行環境提示，先確認錯誤訊息要求的元件，再依系統與架構處理，避免反覆安裝不相容的元件。

建立訂閱群組並更新

開啟 v2rayN 的訂閱群組設定，新增群組並填入方便辨識的備註，將完整訂閱連結貼到網址欄，確認已啟用群組後儲存，再執行更新訂閱。首次使用且尚無可用代理時，先嘗試「不透過代理」更新；已有可用設定，但目前網路無法直接連線至訂閱來源時，再嘗試「透過代理」更新。更新成功後，請確認群組中確實出現設定，避免只建立了空群組。

自動更新間隔只控制重新取得訂閱的頻率，不會維持連線，也不會改變服務有效期限。更新過於頻繁，可能觸發來源的請求限制。篩選條件會影響顯示結果，初次匯入時建議留白；確認所有內容都能正常顯示後再設定。若畫面顯示更新成功但清單為空，請先確認目前選取的群組及篩選條件，再檢查來源回傳的是否為訂閱內容，而非需要登入的網頁。

選取設定並啟用系統代理

在清單中選取要使用的設定，設為作用中項目，並確認核心已正常啟動。接著在系統代理選單中選擇設定系統代理。代理連接埠必須與用戶端的本機監聽連接埠一致；若先前有其他工具修改系統代理，請先清除舊設定，再由 v2rayN 重新設定。瀏覽器通常會使用系統代理，但遊戲、命令列工具及部分桌面軟體不一定會，因此瀏覽器能連線不代表所有程式都已接管。

路由模式與系統代理分屬不同層面。系統代理決定應用程式是否將請求送至用戶端；路由則決定用戶端收到請求後要直連還是走代理。初次使用可選擇略過區域網路的路由，避免本機裝置的流量被送往遠端，再依需求調整。若只想測試特定應用，可在支援手動代理的應用程式中填入本機位址與實際連接埠，不必立即啟用全域接管。

權限、休眠與結束後的復原

一般系統代理通常不需要以管理員身分執行；TUN 涉及虛擬網卡與路由變更，請依目前用戶端的提示提供必要權限。啟用後若無法正常存取區域網路，應先檢查略過區域網路的規則與路由表，而非關閉防火牆。若安全軟體阻止核心啟動，請檢查封鎖記錄與檔案位置，確認原因後再處理相關允許設定，不要將整個磁碟設為信任。

從休眠恢復，或從有線網路切換到無線網路後，原有的網路介面、閘道與解析環境可能已改變。先停用 TUN，再重新啟用；若問題仍在，請結束用戶端後重新開啟。若程式異常結束導致瀏覽器無法連線，請在 Windows 的代理設定中確認是否殘留手動代理，移除無法連線的本機位址後，再測試原始網路。網路恢復後才重新啟動用戶端，避免把殘留代理誤認為服務故障。

最後進行兩類驗證：存取一個需要代理的目標，確認代理出口可用；再存取區域網路裝置或預期直連的目標，確認分流未影響本機通訊。查看同一時段的記錄，分辨核心啟動、網域解析與連線錯誤。速度測試只能作為參考，不能取代實際應用程式的連線測試。若瀏覽器正常、特定程式卻有問題，先確認該程式是否支援代理，再參閱本頁的 TUN 章節。

macOS：確認晶片與網路權限

確認晶片類型與安裝位置

在系統的「關於這台 Mac」中確認晶片類型，再前往macOS 下載專區選擇 v2rayN。Apple Silicon 請使用對應架構的套件，Intel 則使用對應的 x64 套件。即使相容機制允許執行另一種架構的程式，仍建議優先使用原生相符的套件，減少核心啟動與權限處理時的額外變數。不要把架構不符造成的啟動問題誤認為訂閱或網路故障。

開啟磁碟映像檔後，將應用程式移至「應用程式」資料夾，再從固定位置啟動。不要長期直接從掛載中的安裝映像執行，也不要單獨拖出套件內的檔案。固定路徑有助於一致管理權限記錄與更新。若出現系統安全提示，先確認下載來源與目前檔案，再依系統提供的安全設定流程處理；不要關閉整台裝置的安全防護來跳過所有檢查。

匯入訂閱並建立基本連線

開啟 v2rayN，進入訂閱群組設定，填入備註與完整網址，啟用群組並儲存。更新後，選取一項設定作為作用中項目。各桌面平台的設定概念相同，但選單位置與快捷操作可能不同，請依功能名稱尋找，不要照抄其他系統的滑鼠操作路徑。更新失敗時，先確認能否直接連線至來源，再決定是否使用已可用的代理更新，避免依賴尚未建立的連線。

首次啟動時，先確認核心是否成功執行，再啟用系統代理。若記錄顯示程式無法執行、權限不足或缺少檔案，請先處理本機啟動問題。核心已在本機連接埠監聽後，系統代理才有實際接收請求的對象。若代理設定指向尚未啟動的連接埠，應用程式會持續等待或直接連線失敗，容易被誤判為遠端連線問題。

了解依網路服務儲存的代理設定

macOS 的代理設定與網路服務相關。無線、有線及其他網路服務可能各自儲存設定，因此切換網路後需要重新確認代理狀態。請在系統網路設定中查看目前使用的服務，核對 HTTP、HTTPS 或 SOCKS 代理所用的本機位址與連接埠。若用戶端顯示設定成功，但瀏覽器沒有使用代理，先確認你檢查的是目前作用中的網路服務，而非未連線的服務。

部分應用程式使用自己的網路堆疊或獨立代理設定，不會完全遵循系統代理。這類程式應先確認是否支援手動代理，並依用戶端目前監聽的協定填寫；不能把 SOCKS 連接埠填入只支援 HTTP 代理的欄位。系統代理只會影響主動遵循設定的應用程式；若確實需要接管其他流量，再考慮 TUN，而不是不斷切換系統代理模式，試圖涵蓋所有程式。

TUN 權限與其他網路工具

啟用 TUN 可能需要提高權限，或安裝用戶端要求的輔助元件；實際流程依目前版本而定。閱讀提示後完成授權，再確認是否已建立虛擬介面。不要套用其他作業系統的驅動程式安裝方式，也不要為了解決權限提示而任意修改應用程式套件內部的權限。已授權但仍無法啟動時，請查看第一則錯誤訊息，分辨是輔助元件、連接埠占用，還是虛擬介面建立失敗。

工作裝置可能已有網路過濾工具、企業 VPN 或裝置管理政策，與 TUN 同時運作時，路由與 DNS 的管理關係會更複雜。若裝置受管理，請先遵循管理員規範；在個人裝置上排查時，可暫時停用其他會接管網路的工具，一次保留一套設定進行驗證。不要同時調整多個 VPN 的優先順序，即使問題消失，也無法確認是哪項變更生效。

從睡眠狀態恢復後，先確認目前網路服務已取得有效位址，再檢查代理狀態。若只在切換網路後失敗，請先停用網路接管功能，在原始網路上測試連線，再重新啟用。若程式結束後仍無法連網，請檢查作用中的服務是否保留本機代理設定。遷移至新電腦時可以匯入訂閱與路由，但須重新確認本機連接埠、系統授權與晶片架構是否相符，不能直接沿用另一台電腦的網路服務狀態。

Linux：套件類型、桌面代理與權限

依發行版與架構安裝 v2rayN

前往Linux 下載專區取得 v2rayN，依發行版選擇 deb 或 rpm，並確認架構為 x64 或 arm64。套件類型取決於系統使用的套件管理機制，處理器架構則由裝置決定，兩者都必須相符。桌面介面能否正常顯示，也與目前的圖形環境及系統相依套件有關；副檔名正確不代表所有執行條件都已滿足。

建議使用圖形化軟體安裝程式開啟下載的檔案，確認相依套件與安裝結果後，再從應用程式選單啟動。安裝失敗時，先查看提示是缺少相依套件、架構不符，還是檔案無法讀取，不要強制略過相依套件。若系統軟體來源尚未設定妥當，應先讓套件管理工具恢復正常。解除安裝舊套件或安裝新套件前，請備份用戶端設定；一般軟體安裝錯誤不應靠手動清除系統網路設定來處理。

匯入訂閱並確認目錄可寫入

以一般使用者身分啟動用戶端，進入訂閱群組設定、加入網址並更新，再選取作用中設定。用戶端設定目錄應由目前使用者讀取及寫入；若先前曾以較高權限啟動圖形程式，可能會留下擁有者不符的檔案，導致設定無法儲存，或每次啟動都還原成舊內容。遇到這種情況，應檢查特定目錄及其擁有者，不要遞迴修改整個個人目錄或系統目錄的權限。

核心無法啟動時，記錄檔通常比介面提示提供更多資訊。先確認配套核心檔案存在且可執行，再檢查是否受安全政策限制，最後查看監聽連接埠是否已被占用。軟體安裝成功與核心正常執行是不同階段。不要一看到連線失敗就修改服務端位址；若本機核心根本沒有執行，變更遠端設定也無法解決本機執行權限問題。

桌面設定與應用程式設定屬於不同層面

Linux 沒有一套能在所有桌面環境中一致生效的系統代理介面。桌面網路設定可能會被瀏覽器讀取，卻不一定適用於終端機、容器或背景服務。啟用 v2rayN 的系統代理後，請在實際使用的應用程式中驗證。支援手動設定的程式可填入回送位址與用戶端實際連接埠，並明確選擇 HTTP 或 SOCKS，不要假設所有程式都會自動共用桌面設定。

終端機中的代理環境變數通常只適用於目前的程序及其子程序，不會取代桌面設定，也不會自動影響已在執行的程式。以下僅示範暫時設定的方式：先將連接埠改為用戶端實際使用的 HTTP 代理連接埠，再於同一個終端機執行需要代理且支援這些變數的工具。測試結束後請移除變數。使用 SOCKS 時，也要確認工具是否支援將網域解析交由代理端處理。

export http_proxy="http://127.0.0.1:10809"
export https_proxy="http://127.0.0.1:10809"
export no_proxy="localhost,127.0.0.1,::1"

# 測試結束後，移除目前終端機的臨時設定
unset http_proxy https_proxy no_proxy

TUN、解析服務與容器的界線

TUN 需要建立虛擬網路介面並調整路由，因此可能需要相應的網路管理權限。請依目前用戶端的授權流程操作，不要預設長期以最高權限執行圖形化用戶端。啟用後先檢查基本網路，再測試預期使用代理的目標。若程序正在執行，但虛擬介面尚未建立，應先排查權限；若介面已存在但所有連線都失敗，再檢查路由與 DNS，而非反覆重裝應用程式。

不同 Linux 發行版可能使用不同元件管理 DNS，直接改寫解析檔案可能立即被網路服務覆寫。請透過用戶端或目前使用的網路管理工具設定，並記下原本狀態。容器、虛擬機器與獨立網路命名空間不一定會沿用主機的代理與路由；主機瀏覽器能用，不代表容器也已透過代理連線。設定這些環境時，請先確認其閘道、解析器，以及能否連到主機的監聽位址。

升級前請保留可用設定並結束用戶端；升級後重新確認核心路徑、監聽連接埠與權限提示。若桌面登入後無法自動啟動，但手動啟動正常，請檢查程式是否早於網路就緒而啟動，或啟動環境是否不同於互動式工作階段。依序驗證安裝、設定儲存、核心啟動、應用程式接入與目標連線，便能將 Linux 的環境差異拆解為明確問題，避免漫無目的地修改系統設定。

Android：設定 v2rayNG 與 v2flyNG

選擇核心與安裝套件

開啟Android 下載專區，優先選用 v2rayNG（使用 Xray 核心）；v2flyNG 則是採用 V2Fly 核心的替代方案。確認服務設定需求後再做選擇。主流 arm64 裝置可使用對應套件；不確定架構時，請選擇通用套件。不要只依 Android 版本判斷處理器架構，也不要輪流安裝兩個用戶端來測試協定相容性；先核對設定欄位更有效。

使用系統安裝程式安裝。若系統要求允許安裝來源，只為目前使用的檔案管理器或瀏覽器開啟必要權限，安裝後可視需要撤銷。若安裝程式提示套件不相容，請確認架構、系統需求與已安裝的應用程式；若出現簽章衝突，先備份原有應用程式設定，再判斷是否需要更換安裝來源。直接解除安裝可能會刪除訂閱與規則，不應成為每次更新失敗時的首選做法。

管理訂閱並匯入單一連結

在 v2rayNG 中開啟訂閱群組相關選項，新增群組、填入備註與完整訂閱網址，儲存後執行更新。若取得的是單一分享連結，請使用從剪貼簿匯入或掃描相關資訊的功能，不要將分享字串填入訂閱網址欄。v2flyNG 的介面操作路徑可能不同，但同樣要區分取得設定集合與匯入單一設定。選單文字有所變更時，請依功能判斷入口。

更新後選取要使用的設定，再點選連線按鈕。若清單沒有內容，請確認群組已啟用、網址完整且沒有篩選條件。Android 瀏覽器有時會複製分享頁面的標題，或漏掉部分網址，建議檢查完整文字。訂閱可能包含個人相關參數，請只保存在個人裝置中；換機時使用安全可控的備份方式，不要透過公開訊息或截圖傳送完整網址。

系統 VPN 授權與應用程式範圍

首次連線時通常會出現系統 VPN 授權提示，這是用戶端透過系統介面接管流量所需的許可。核准後再確認連線狀態與記錄。Android 的接管方式不同於桌面系統的「設定系統代理」；它可將選定應用程式的流量送入用戶端，再由路由決定直連或走代理。狀態列出現連線圖示只代表介面已建立，不能證明所有遠端設定都可連線。

依應用程式代理與路由分流是不同概念。應用程式清單決定哪些程式納入接管範圍；路由規則則決定納入範圍的請求使用哪個出口。若採用只代理選定應用程式的模式，未選取的目標程式就不會進入代理；若採用略過選定應用程式的模式，被勾選項目的意義則相反。調整前請先確認目前模式，再用一個目標應用程式測試，避免在清單很長時誤判選取結果。

背景執行限制、網路切換與衝突

部分系統會限制背景執行，鎖定螢幕後斷線可能與省電策略有關。先確認系統是否已結束用戶端，再於電池設定中依裝置政策允許其在背景執行。允許背景活動不代表所有連線都能永久維持；從無線網路切換至行動網路時，舊連線仍可能需要重新建立。若問題只在鎖定螢幕或切換網路後發生，應優先檢查程序狀態與網路切換，而非先更改協定。

系統 VPN 介面可能已被其他網路工具占用；開啟另一個應用程式後原有連線中斷，就需要排查衝突。排查時只保留一個會接管網路的工具，再觀察結果。私人 DNS、網路過濾與應用程式範圍設定也可能影響解析或連線範圍，請先記下原始設定，再逐項測試。不要為了排查而永久關閉所有系統網路防護；確認相關性後，選擇範圍明確且可復原的調整方式。

驗證時，先用目標應用程式實際連線，再查看記錄中的解析與連線結果。若用戶端測試成功但某個應用程式失敗，請檢查應用程式接管範圍、自身代理設定與協定需求；若所有應用程式都失敗，則回頭檢查服務設定與 DNS。換新手機後，請重新確認 VPN 授權、省電限制與應用程式清單，這些系統狀態不會完整隨訂閱移轉。快速操作流程可參閱訂閱匯入指南。

路由、DNS 與網域比對

設定分流前，先釐清流量入口與出口

請求進入用戶端後，路由會依規則決定使用直連、代理或封鎖出口。規則可能依網域、目標位址、連接埠或協定比對，優先順序與排列方式都會影響結果。一般可先設定必須保護的區域網路規則，再加入特定目標規則，最後保留預設處理方式。若兩條規則可能同時符合，應依目前核心的比對機制判斷，不要假設網域越長就一定會自動優先。

網域規則能否生效，取決於核心是否知道目標網域。若應用程式先自行解析，接著只提交位址，用戶端可能只取得 IP 資訊。流量嗅探可從部分流量擷取目標名稱，但不適用於所有協定，也不能取代 DNS 規劃。設定前請先確認請求以何種形式進入，再決定使用網域或位址規則。否則即使規則內容正確，也可能始終無法取得比對所需的資訊。

區分服務位址解析與目標解析

至少有兩種解析需求：建立代理連線前，需要解析代理服務的位址；存取目標時，可能還需要解析目標網域。第一種解析不可依賴尚未建立的代理，否則會形成啟動循環。第二種則要依預期的直連或代理路徑安排。系統解析器、應用程式內建解析與核心 DNS 也可能同時存在，因此只修改用戶端的一項 DNS 設定，不一定能改變所有應用程式的查詢路徑。

遠端 DNS 指的是使用哪個解析服務，不代表查詢一定會經過代理。還要確認通往該解析器的流量如何路由，以及用戶端是否接管應用程式送出的查詢。加密解析改善的是查詢的傳輸方式，不等於出口策略。若路由設定為直連解析器位址，查詢仍可能從本地網路出口送出；設定時應分別驗證解析器選擇與連線路徑。

設定片段僅供理解規則結構

以下是 Xray/V2Fly 格式的局部路由結構，用來說明規則欄位與出口的關聯。這不是完整的執行設定；請將其合併至使用該結構的自訂設定中，並確認直連出口的標籤確實為 direct。圖形介面可能產生不同標籤，不能直接假設名稱相同。使用其他設定格式的核心，應透過對應的設定入口操作，不要將此結構直接塞入不相容的檔案。

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

AsIs 表示路由階段不會因該策略主動將網域轉換為位址，不代表後續連線永遠不需要解析。使用 geoip:private 也需要有相應的規則資料可供使用。若記錄指出資料檔案遺失，應處理資源載入問題，而非刪除所有分流規則。範例網域僅用於展示結構，實際使用時請依需求填入目標，避免過於寬泛的規則意外將大量流量設為直連。

FakeDNS 與外洩檢測的適用範圍

FakeDNS 會以虛擬位址維持網域對應，因此查詢與後續連線都必須經過相符的處理路徑。若應用程式繞過用戶端解析，卻將真實位址交給虛擬位址規則；或取得虛擬位址後，連線未被接管，都可能造成存取失敗。啟用前請確認 TUN 的 DNS 接管方式與核心支援狀況，不要把它當成適用所有應用程式的一鍵功能。

檢查解析路徑時，請同時觀察用戶端記錄、系統解析設定與測試應用程式。測試頁面顯示的解析出口只能作為線索，不能證明整台裝置的所有查詢都走相同路徑。請分別測試系統解析、瀏覽器獨立解析與 TUN，並驗證直連目標與代理目標。詳細方法請參閱DNS 外洩檢測與設定實作。發生異常時，先恢復可用的解析方案，再逐項新增功能，避免通訊中斷後失去排查依據。

如何選擇系統代理與 TUN

分開看接管入口與對外路由

系統代理會提供代理位址，應用程式需主動遵循設定並轉交請求；TUN 則會建立虛擬網路介面，透過路由將符合範圍的流量送入用戶端。兩者處理的是不同的流量入口，不能只用「哪種模式比較快」概括。日常主要使用瀏覽器時，先用系統代理較容易觀察；若程式不讀取系統代理，或需要處理更多類型的流量，再評估 TUN。

TUN 擴大接管範圍，不代表所有流量都必須走遠端代理。流量進入虛擬介面後，仍由路由決定出口；區域網路通訊、指定目標與部分系統流量都可以直連。反過來說，選擇全域代理路由，也無法讓完全未接入用戶端的應用程式自動使用代理。排查時先確認請求是否進入用戶端，再確認進入後選擇哪個出口，切勿混為一談。

桌面啟用前的檢查順序

先在系統代理模式下完成基本連線，確認作用中設定、核心與訂閱都可用，再準備啟用 TUN。記下目前的網路介面、預設閘道與其他 VPN 狀態，並結束可能造成衝突的工具。依用戶端提示取得建立虛擬介面的權限，啟用 TUN 後檢查記錄中的介面建立與路由結果。若介面開關已開啟但記錄顯示錯誤，應以啟動結果為準，不要只看開關外觀就認定接管成功。

自動路由、嚴格路由與 DNS 接管等設定都會影響接管範圍及相容性，應依目前使用的核心說明確認實際作用。嚴格路由或許能減少流量繞行，但也可能影響區域網路、虛擬機器或部分系統服務。初次使用時不要一次啟用所有進階選項；先採用用戶端建議的基本組合，再依實際需求補充。每次變更後都要檢查代理目標、直連目標與區域網路存取，並保留可復原的設定。

避免服務連線被送回自身

連線至代理服務本身也會產生網路流量。TUN 必須妥善處理這類流量，避免核心的連線再次被送回同一個入口，形成迴圈。用戶端與核心通常提供排除介面、綁定出口或路由處理機制，應優先使用現有的整合設定。若記錄顯示連線反覆重試、資源使用量增加，但目標仍無法存取，請檢查路由迴圈與其他接管工具之間的影響，而非只更換遠端設定。

服務位址若使用網域，也涉及啟動時的解析。若解析要求被強制交給尚未建立的代理，就可能連服務位址都無法取得。請為服務位址保留可連線的啟動解析路徑，再依預期策略解析目標網域。若同時連接多個網路介面，請確認實際使用的預設出口；部分程式會綁定舊介面，切換網路後可能需要重新啟動接管功能，才能選用有效路徑。

UDP、區域網路與應用程式相容性

系統代理、用戶端本機入口與遠端協定對 UDP 的支援程度不盡相同，遠端服務也可能有所限制。啟用 TUN 只是將流量送入核心，並不會自動補足整條鏈路的 UDP 支援。若網頁正常，但語音、遊戲或其他應用程式失敗，請確認應用程式使用的流量類型，再檢查入口、核心、遠端協定與伺服器端政策；不能只因 TCP 連線正常，就排除傳輸問題。

存取區域網路裝置需要正確的位址路由；裝置探索還可能使用廣播或多點傳送，因此不要假設一條略過區域網路規則就能處理所有探索功能。先測試直接連線至已知的區域網路位址，再判斷是位址通訊問題還是探索機制問題。虛擬機器與容器的虛擬網段也應納入規劃，避免與 TUN 位址池重疊。若網段衝突，應調整相關設定，而非將規則擴大為全部直連。

結束或切換時保留復原方式

測試完成後，先停用 TUN，再清除不再需要的系統代理，最後結束用戶端。特定方案中可以同時使用兩種入口，但初次排查時建議只保留一種，降低路徑不確定性。切換網路、從休眠恢復或升級後，請重新確認虛擬介面與預設路由；停用後若仍有異常，檢查系統是否殘留代理與解析設定。原理及操作方式請接著閱讀v2rayN TUN 模式詳解。

常見設定問題與分層排查

先確認故障發生在哪個層級

將問題分為六個階段：應用程式安裝、核心啟動、取得訂閱、連線至服務、接入流量、路由與解析。記下發生時間、目前網路與最近一次變更，再查看同一時段的記錄。先找出最早出現的關鍵錯誤，不要被後續重複失敗訊息掩蓋。介面顯示已連線、系統出現虛擬介面或某項測試通過，都只能證明相應階段正常，不能取代整條連線路徑的驗證。

若關閉用戶端後原始網路也無法使用，先還原系統代理、DNS 與正常介面，確認網路本身的狀態。若原始網路正常，但核心無法啟動，請檢查本機檔案、權限與連接埠；若核心正常但所有設定都連不上，檢查系統時間、網路限制與共用參數；若只有一項設定失敗，則優先核對該項設定。逐步縮小問題範圍，比不斷更換用戶端更容易找出原因。

訂閱更新失敗或更新後沒有內容

先確認網址完整、查詢參數未遺失、沒有多餘空格，也沒有被複製成頁面標題。接著分辨是網路連線失敗，還是內容格式有問題：無法連線至來源時，檢查目前網路與更新方式；連線成功但解析失敗時，確認回傳內容是否為用戶端支援的訂閱格式。登入頁面、錯誤頁面與請求限制提示都可能以一般文字回傳，因此「取得成功」不代表設定內容有效。

若不透過代理更新失敗，而手邊已有可用連線，可改用透過代理更新；首次使用且沒有可用連線時，則不應依賴這個選項。更新後清單為空，請檢查群組啟用狀態、篩選條件與來源內容。在驗證新內容之前，請保留舊的可用設定，不要刪除所有項目。其他情況請參閱疑難排解常見問題，分別處理更新失敗與連線失敗。

設定匯入成功，卻無法連線

比對服務提供的完整參數，檢查位址、連接埠、使用者識別資料、傳輸方式、安全設定與服務名稱等欄位。分享連結可能省略部分顯示資訊，請在編輯頁面查看實際值。有些欄位名稱相似但意義不同，不能直接把伺服器位址填入所有安全欄位。遇到憑證錯誤時，先檢查系統時間及設定中的目標名稱，不要關閉驗證來暫時掩蓋問題。

也要另外確認核心相容性。用戶端接受分享連結，不代表目前選用的核心支援其中所有選項；匯入時遺漏欄位，或遷移時沿用舊設定，都可能導致不相容。先使用訂閱中的原始設定建立基準，再考慮手動調整。若切換核心後連線失敗，請還原先前可用的核心並比較支援差異，不要把隨機組合參數當成正常的除錯方式。

瀏覽器可用，其他程式卻失敗

先確認發生問題的程式是否會讀取系統代理。若支援手動設定，請核對代理協定、回送位址與實際連接埠；若不支援，再考慮 TUN，或在 Android 上設定依應用程式接管。若程式已接入用戶端，請檢查路由比對與 DNS。應用程式自帶加密解析、快取舊位址或使用不同流量類型，都可能造成行為差異。每次驗證都應重新建立連線，避免舊的連線工作階段掩蓋設定變更。

不要為了解決一般應用程式的連線問題，就將本機監聽位址改為所有網路介面。程式在同一部裝置上執行時，回送位址通常已足夠；其他裝置要連入本機代理則是另一種需求，需要規劃存取控制與防火牆。若連接埠遭占用，先找出目前使用該連接埠的程式，再結束衝突程序或改用可用連接埠，並同步更新應用程式設定。只修改其中一端的連接埠會導致新的連線錯誤。

恢復可用狀態後再回報問題

發生間歇性故障時，記錄問題是否與鎖定螢幕、休眠、切換網路、訂閱更新或啟用其他網路工具同時發生。使用相同目標重複測試，每次只變更一個變數。復原時優先停用網路接管功能並恢復原始網路，再匯入最近一次可用的備份。回報問題時請提供系統與架構、用戶端名稱、核心類型、已嘗試的步驟及移除敏感資訊後的錯誤片段，不要公開完整憑證。若不熟悉相關概念，可先查閱名詞解釋，再回到對應章節操作。