全平台安裝設定指南

準備工作與設定範圍

先分清用戶端、核心與連線資料

圖形化用戶端負責儲存伺服器資料、管理訂閱、產生設定檔及控制執行狀態；核心則依設定處理連線。v2rayN 是桌面端的管理介面，實際支援哪些協定，仍取決於選用的核心。v2rayNG 使用 Xray 核心，v2flyNG 則採用 V2Fly 核心。即使介面欄位相同，也不代表兩種核心分支完全支援相同的擴充參數；選用前請先確認連線資料的需求。

安裝用戶端不會自動取得可用伺服器。請準備可信來源提供的訂閱網址，或包含伺服器位址、連接埠、使用者識別碼、傳輸方式及安全參數的設定資料。訂閱網址通常具有存取權限，請妥善保管，如同保管密碼。向他人求助時，請勿公開完整訂閱連結、QR Code 或使用者識別碼；截圖即使只露出查詢參數，也可能足以讓他人讀取設定。

手動設定時，也要分清三種容易混淆的網域名稱：伺服器連線位址決定連線目標；TLS 伺服器名稱用於憑證與握手；HTTP 或 WebSocket 的 Host 則供相應的傳輸層使用。這些欄位有時相同，有時由伺服器端分別指定。不要因位址看起來不像常見網站，就自行把所有欄位改成同一個網域。

確認系統架構與儲存位置

安裝檔必須同時符合作業系統、處理器架構與封裝格式。x64 主要適用於常見的 Intel、AMD 桌上型處理器；arm64 則是另一種指令集，不能只依裝置新舊來判斷。Windows 可在系統的「關於」頁面查看系統類型，macOS 可在「關於這台 Mac」查看晶片資訊，Linux 則可查詢機器架構。Android 裝置若不確定處理器支援情況，可先查閱裝置規格，再考慮通用版本。

請為用戶端選擇長期可寫入的儲存位置。需要解壓縮的安裝檔請先完整解壓縮，再從資料夾內啟動；不要直接從壓縮軟體的暫存檢視畫面執行。設定與記錄檔可能儲存在程式資料夾或使用者資料目錄，位置會依發行方式而異。升級前請先從用戶端匯出必要設定，並記下原本的資料位置，避免只複製程式檔案，卻漏掉訂閱與路由設定。

建立可重現的測試基準

初次設定前，先退出其他代理、VPN 及會接管網路的工具，並保留目前系統代理設定的截圖。確認一般網路可連上已知可用的網站，且系統日期、時間與時區正確，再開始匯入。如此一來，後續發生問題時，才能分辨是原本的網路異常，還是新設定造成的變化，避免多個網路元件同時執行時只能反覆猜測。

第一輪測試只啟用一台伺服器及一種接管方式：桌面端通常先測試系統代理，Android 端則先完成 VPN 授權。暫時不要同時加入自訂 DNS、複雜路由或區域網路分享。連線正常後再逐項新增功能，每次修改後都用相同的應用程式與網址重新測試。記下修改項目、錯誤原文及發生時間，比只寫「開了還是不能用」更容易找出問題。

Windows 安裝與系統代理

選擇桌面版或傳統 WPF 版

前往Windows 下載專區選擇 v2rayN。桌面版採用跨平台介面；傳統 WPF 版則保留 Windows 桌面應用程式的操作習慣。兩者都應依目前版本的說明確認執行條件。介面不同不代表伺服器需要重新購買，也不代表協定必然不同；連線相容性仍取決於使用的核心與伺服器參數。

下載後，依安裝檔格式完成安裝或解壓縮。解壓縮版應放在固定資料夾，路徑盡量簡短，並確保目前使用者有寫入權限；程式、核心及隨附檔案都要一併保留。首次啟動若提示缺少執行環境，請先記下提示中明確要求的元件與架構，再依正常的系統軟體安裝流程補齊。不要從不明來源逐一下載同名動態連結程式庫，再放進程式資料夾。

無法啟動時，先判斷是「視窗無法開啟」，還是「視窗已開啟但核心啟動失敗」。前者請檢查執行環境、檔案是否完整解壓縮，以及系統安全性記錄；後者則從用戶端記錄檔查找核心遺失、設定檔產生失敗或連接埠遭占用等訊息。若系統安全軟體隔離了檔案，請先核對下載來源與具體偵測資訊，不要為了省事就關閉整套安全防護。

匯入訂閱並確認本機監聽

開啟訂閱分組設定，新增分組並輸入容易辨識的名稱，再貼上完整訂閱網址。儲存只會記下訂閱來源，還要執行更新訂閱。更新成功後回到伺服器清單，選取一筆資料並設為目前使用的伺服器。若清單是空的，先查看更新記錄、分組篩選及網址是否複製不完整；沒有伺服器資料時，不要反覆按下連線。

接著到參數設定查看本機監聽連接埠及監聽類型。HTTP、SOCKS 與混合監聽的入口可能因核心設定而異；手動填寫代理時，請使用相符的協定。連接埠號以介面顯示的實際數值為準，不要照抄他人的截圖。若只供本機使用，監聽範圍請維持在迴路位址；初次連線不需要開放區域網路分享。

在底部狀態列或系統匣選單找到系統代理，選擇「自動設定系統代理」。這會讓遵循 Windows 系統代理設定的應用程式使用本機入口，但不會強制所有程式都走代理。先用瀏覽器連線至已知可用的目標，再確認用戶端是否出現對應的連線記錄。若瀏覽器連線成功，只有某個應用程式失敗，請先確認該應用程式是否遵循系統代理設定。

TUN、權限與退出後的還原

只有在需要接管不使用系統代理的應用程式時，才考慮啟用 TUN。TUN 涉及虛擬網路介面與路由，通常需要系統管理員權限，實際需求則依安裝檔與執行方式而異。請先關閉其他 VPN，確認一般代理可正常連線，再依用戶端提示取得權限。啟用後若所有網路連線都異常，請先關閉 TUN，確認網路是否恢復，再檢查 DNS 與路由設定。

連接埠遭占用是 Windows 常見的啟動問題。請先結束重複執行的用戶端，再查看記錄檔中指出的連接埠。你可以在終端機執行以下查詢，並將連接埠替換成設定頁顯示的數值。查詢結果僅用於確認占用情況；請依 PID 在工作管理員辨認程式，不要直接結束無法辨識的系統處理程序。

netstat -ano | findstr LISTENING

關閉視窗不一定代表已退出程式，系統匣中的用戶端可能仍在執行。完全退出前，先選擇「清除系統代理」、停用 TUN，再退出用戶端。若程式異常結束，Windows 設定可能仍指向已停止的本機代理，導致瀏覽器全部無法連線。還原系統代理後若網路恢復，通常表示需要清除殘留設定，而不是訂閱失效。

若要設定開機啟動，請先手動完成幾輪啟動、連線與退出測試，再啟用相關選項。系統剛登入時，網路可能尚未就緒，訂閱更新失敗不一定代表網址失效；稍後可手動重試並查看記錄檔。升級或切換桌面版與 WPF 版前，也請先退出舊版，避免兩個程式爭用連接埠與系統代理。

macOS 安裝與網路權限

依晶片選擇版本並完成首次啟動

在「關於這台 Mac」查看晶片資訊。若顯示 Apple 晶片，請選擇適用於 Apple Silicon 的 arm64 版本；若顯示 Intel 處理器，則選擇 x64 版本，再前往macOS 下載專區取得 v2rayN。優先選擇符合電腦架構的發行版本，避免把相容轉譯環境當成日常設定的必要條件。

開啟磁碟映像檔後，將應用程式複製到「應用程式」資料夾，再從該處啟動。不要長期直接執行映像檔中的副本，否則卸載映像檔、移動檔案或升級時，容易混淆實際執行位置。若系統阻擋首次開啟，請先確認檔案來源，再到系統設定的「隱私權與安全性」查看相關提示，並依系統提供的流程確認。

不要為了略過一次提示，就關閉整體系統安全機制。若提示與架構、檔案損毀或權限有關，請分別處理：架構不符就更換版本，複製未完成就重新複製，權限問題則確認目前使用者能否存取應用程式與資料夾。若裝置由公司或機構管理，網路設定可能受管理政策限制，此時反覆重裝用戶端通常無法解決問題。

匯入訂閱並確認目前網路服務

啟動 v2rayN 後，先進入訂閱分組設定新增網址，儲存後執行更新。選取目前使用的伺服器前，請確認安全方式、傳輸類型，以及訂閱提供的必要欄位都已正確辨識。含有用戶端專屬擴充欄位的資料，不一定能直接轉用；匯入後有記錄但啟動時出現參數錯誤，請先查看記錄中的欄位名稱，不要把所有選項一律打開。

第一次連線請先使用系統代理。macOS 的代理設定與網路服務相關，Wi-Fi、有線網路及其他介面可能各有獨立設定。套用自動設定後，請到目前使用的網路服務詳細資訊確認代理狀態。若從有線網路切換到無線網路後狀況改變，先檢查新網路服務的代理設定，再判斷問題是否出在伺服器或訂閱。

瀏覽器可能使用獨立擴充功能或專用代理設定，終端機工具也不一定會讀取系統代理。因此測試時，先選擇一個遵循系統設定的應用程式，再確認目標連線是否出現在記錄檔中。不要只因終端機的一次請求失敗，就認定系統代理失效；若工具支援手動代理，請依其參數格式填入本機位址與相應的監聽連接埠。

TUN 權限、睡眠與升級

TUN 需要處理虛擬介面與系統路由，實際授權方式依用戶端發行版本而異。請先確認基本代理可正常使用，再依介面提示啟用。若出現系統管理員授權提示，請確認操作確實來自剛啟動的用戶端。不要把來源不明的終端機指令碼當成通用修復方式，也不要長期以提升權限的方式執行所有日常程式。

電腦從睡眠喚醒、切換熱點或更換網路後，舊連線可能仍停留在等待狀態。請先確認新網路本身可正常使用，再重新啟動目前的連線；必要時關閉並重新開啟 TUN，讓介面與路由重新建立。若只有特定網路無法連線，請保留其他設定不變，在兩個網路間比對記錄，特別留意網域解析與握手階段，不要立刻重建所有設定。

升級前請匯出需要保留的設定，並記下目前使用者資料的位置。替換應用程式不一定會清除使用者設定，因此升級後仍看到舊設定是正常情況。反過來說，把應用程式移到垃圾桶也不一定會清除網路接管狀態。解除安裝或更換程式前，請先關閉 TUN、還原系統代理，再退出應用程式，最後檢查目前網路服務的代理設定。

若用戶端顯示連線正常，但受管理的瀏覽器仍無法連線，請檢查瀏覽器政策、擴充功能及系統描述檔是否指定了其他代理。這些設定的優先順序可能與一般使用者設定不同。請先記下政策來源並聯絡裝置管理人員，不要刪除不明設定檔來試錯，以免影響工作網路或其他受管理的應用程式。

Linux 安裝與桌面環境

確認封裝格式、架構與相依套件

Linux 請先確認發行版採用的封裝系統，再確認機器架構。Debian、Ubuntu 等系統通常選擇 deb；Fedora 等使用 rpm 的系統則選擇對應格式。其他發行版不要強行安裝不相容的封裝格式。前往Linux 下載專區選擇 v2rayN，並確認 x64 或 arm64 符合機器的實際架構。

以下兩個指令只會讀取機器資訊：第一個查看架構，第二個查看發行版識別資訊。常見的 x86_64 對應 x64，aarch64 通常對應 arm64。發行版名稱本身無法保證相依套件都符合需求，還要依系統版本、桌面元件及套件管理員提供的相依資訊判斷。不要只因副檔名相同，就認定一定可以安裝。

uname -m
cat /etc/os-release

安裝時優先使用發行版提供的軟體安裝程式或套件管理員，讓系統管理相依關係與解除安裝記錄。若提示缺少相依套件，請保留完整錯誤訊息，檢查軟體來源與系統支援範圍，不要隨意從其他發行版複製共用程式庫。圖形化用戶端也需要可用的桌面工作階段；只有終端機的伺服器環境不適用於此處的圖形化安裝流程。

使用一般使用者工作階段匯入與測試

安裝後，請從應用程式選單啟動，並以一般桌面使用者身分儲存設定。若直接以管理員帳戶啟動圖形介面，設定可能會寫入另一個使用者目錄，之後正常啟動時看起來就像「資料不見了」。遇到這種情況，先確認執行使用者與資料路徑，不要反覆匯入相同訂閱。需要提權的網路操作，請使用用戶端支援的授權方式，並與日常設定分開處理。

匯入訂閱的順序仍是新增分組、填入網址、儲存、執行更新，再選取目前使用的伺服器。更新成功後，先確認核心正常啟動，再設定桌面代理。Linux 各桌面環境的代理設定入口不盡相同；有些應用程式會讀取桌面設定，有些讀取環境變數，有些則只接受應用程式自己的參數。因此，「系統代理已啟用」不代表所有程式都已接管。

先用一個確定會遵循桌面代理設定的應用程式測試，再個別設定其他工具。尚未確認監聽正常前，不要把代理環境變數寫入所有 shell 啟動檔，否則新開的終端機也可能持續連到未執行的連接埠。若曾設定 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY，排查時也要檢查大小寫形式與應用程式本身的設定。

TUN、DNS 與多種網路管理元件

啟用 TUN 前，請確認系統具備所需的虛擬網路介面功能，並查看用戶端記錄中的權限提示。部分環境也需要提權服務或網路管理工具配合。不要為了解決權限錯誤，就把整個設定資料夾改成所有使用者都能寫入；請先確認錯誤指向程式執行權限、資料夾權限，還是建立介面與路由所需的系統權限。

Linux 上可能同時執行桌面網路管理工具、系統解析服務、容器網路及其他 VPN。若啟用 TUN 後網域無法連線，一般網路恢復後又正常，請優先檢查 DNS 實際由哪個元件接管。不要一開始就直接覆寫系統解析檔，因為它可能由服務自動產生；修改後也可能立即被還原，讓排查結果難以重現。

使用以下指令查看本機監聽狀態，可確認用戶端連接埠是否已開啟。看到監聽只代表本機入口已建立，不代表遠端握手成功。若沒有權限查看處理程序名稱，仍可先確認位址與連接埠；需要進一步查看時，再依系統管理規範提權，不必為了這項檢查就讓整個用戶端以管理員身分執行。

ss -lntp

退出前請還原桌面代理並停用 TUN。停止後若仍有異常，先檢查是否另有用戶端執行個體、持續生效的環境變數，或其他網路服務留下的規則，再決定是否重新啟動相關服務。升級後也應重新測試系統匣、背景執行與自動啟動功能；不同桌面工作階段處理背景程式的方式可能不同，不能只看視窗是否關閉來判斷程式是否仍在執行。

Android 安裝與 VPN 授權

選擇 v2rayNG 或 v2flyNG

前往Android 下載專區，一般可先選用 Xray 核心的 v2rayNG；連線資料明確要求 V2Fly 核心時，再選擇 v2flyNG。不能只因兩款用戶端名稱相似，就認定它們完全支援相同的擴充參數。尤其是 REALITY 等設定，請先確認核心能力與伺服器端需求，不要靠反覆切換開關來補足不支援的欄位。

多數較新的主流裝置可選 arm64，但最終仍應以裝置處理器與系統支援的應用程式架構為準。若安裝程式提示架構不相容，請再確認是否應改用通用版本。下載完成後，從系統檔案管理工具開啟安裝檔；若系統要求允許目前來源安裝應用程式，只需為這次使用的瀏覽器或檔案管理工具授權，安裝完成後即可撤銷該來源的權限。

更新安裝時若提示簽章不一致，不要立刻刪除原應用程式。先匯出必要設定，確認舊程式與新安裝檔的來源、應用程式身分及簽章是否屬於同一發行管道。解除安裝通常會移除應用程式資料，訂閱分組與手動設定可能一併遺失。不同用戶端之間也不能以覆蓋安裝方式搬移資料，請使用各自支援的匯入與匯出功能。

匯入訂閱並建立系統 VPN 連線

在訂閱分組設定中新增名稱與網址，儲存後返回主畫面執行更新訂閱。部分介面會區分透過目前代理更新與直接更新；若首次連線前訂閱網址本身可以直接連線，可先選擇直接更新。若網址必須透過既有連線才能存取，就需要先準備一筆可用設定；空分組無法自行建立連線。

清單出現伺服器資料後，選取目前使用的伺服器並啟動連線。Android 首次會顯示 VPN 連線要求，確認後用戶端才能透過系統提供的 VPN 介面接管所選應用程式的流量。出現 VPN 圖示只代表介面已建立，不代表遠端伺服器已連線；仍須參考記錄檔及實際應用程式的連線狀況。若未確認授權視窗，反覆點選伺服器也無法完成接管。

Android 用戶端的接管方式與桌面端的「自動設定系統代理」不同。設定頁可能提供依應用程式設定代理的選項，用來選擇哪些應用程式流量要通過或略過 VPN。不同模式下，勾選清單的意義可能相反，啟用前請先閱讀目前的說明。初次測試建議維持預設範圍，確認連線後再逐一排除應用程式，以免不小心把測試用瀏覽器排除在外。

背景限制、網路切換與分享

連線一段時間後自行中斷，請先檢查系統的電池最佳化、背景活動限制與省電模式。不同裝置廠商的設定位置各異，可從應用程式資訊頁查看電池與背景權限。只調整與該用戶端相關的項目，並觀察螢幕鎖定前後的記錄是否中斷。不要把所有斷線都歸因於背景限制；若處理程序仍在執行，但握手持續失敗，仍須檢查遠端參數。

Wi-Fi 與行動網路切換時，本機介面可能仍存在，但原有連線已失效。請等新網路完全就緒後，再重新連線至目前的伺服器。若只有行動網路無法連線，請保持伺服器與路由不變，比較位址解析、IPv4 與 IPv6 的連線狀況及握手錯誤；不要同時修改傳輸類型與安全參數，否則無法判斷哪項變更影響結果。

「允許來自區域網路的連線」是另一項功能，用來開放本機代理監聽給其他裝置使用，並非手機本身上網的必要設定。啟用後，還要考慮監聽位址、連接埠與目前網路是否可信。手機熱點是否會讓其他裝置的流量進入 VPN，取決於系統實作；不能因手機本身連線成功，就認定熱點裝置也會自動生效。

日常停止連線時，先在用戶端中斷連線，再確認系統 VPN 狀態已結束。若設定了永遠開啟 VPN，或封鎖未經 VPN 的連線，停止用戶端後系統可能依政策阻擋網路；請回到 VPN 詳細設定確認。需要簡短的訂閱操作步驟，可繼續閱讀Android 訂閱匯入教學。

整理訂閱與核對參數

分開檢查訂閱更新與伺服器連線

訂閱網址是分發設定的入口，用戶端必須先存取它，才能取得伺服器資料。更新成功表示這次已完成取得與解析，不代表每台伺服器目前都可用；連線成功也不代表日後一定能存取訂閱網址。這是兩個不同階段。排查時請先確認問題發生在下載訂閱、解析內容、啟動核心，還是建立遠端連線，不要把所有狀況都稱為「匯入失敗」。

每個來源各自建立一個分組，名稱可填用途或來源簡稱，不要把完整網址放進分組名稱。貼上網址時，請檢查首尾空白、換行及複製工具加入的標點；含查詢參數的網址必須完整保留。網址失效、權限變更或來源回傳網頁時，用戶端可能收到非訂閱內容；此時更新記錄比伺服器清單更能看出問題。

瀏覽器能開啟某個頁面，不代表該網址回傳的是用戶端可辨識的設定。訂閱可能依存取方式回傳不同內容，也可能要求目前帳戶仍有效。不要把登入頁或分享頁的網址直接當成訂閱連結。若來源提供多種格式，請選擇目前用戶端支援的格式，不要把多處取得的訂閱文字拼成單一檔案。

逐項核對連線與安全參數

手動輸入時，先核對協定、伺服器位址、連接埠與使用者識別碼，再檢查傳輸方式與安全層。VLESS、VMess、Trojan 的驗證欄位並不相同，不能把某種設定的密碼任意填入另一種設定的使用者識別欄位。傳輸方式也須與伺服器端一致；若伺服器使用 WebSocket，路徑與 Host 的大小寫及開頭斜線都應依原始資料保留。

TLS 伺服器名稱與憑證驗證有關，介面通常會以 SNI 或伺服器名稱顯示。REALITY 設定也可能包含公鑰、短識別碼與指紋等欄位，請依伺服器資料逐項填寫。不要把公鑰誤認為密碼，也不要用伺服器 IP 取代所有網域名稱。匯入後若有必要欄位空白，請先確認分享格式是否相容，再考慮手動補齊。

分享連結與訂閱內容可能含有編碼參數。直接修改文字時，容易破壞分隔符號與跳脫字元。一般使用者建議透過用戶端支援的表單編輯，並保留修改前的匯出副本。若要了解協定原理，可參考VLESS 設定說明與REALITY 參數說明；實際參數仍以伺服器提供的資料為準。

更新、篩選與備份的注意事項

訂閱更新可能覆寫由訂閱管理的伺服器資料，因此不要把臨時手動修改當成長期保存方式。若要保留自訂項目，請依用戶端支援的方式移至獨立分組或匯出備份。更新後目前選取的伺服器失效，也可能只是遠端移除或重新命名了資料；請先重新選取目前使用的伺服器，再確認是否真的發生連線問題。

篩選規則會影響清單顯示，清單空白不一定代表訂閱沒有回傳內容。請先切換至所有分組、暫時取消關鍵字篩選，再查看更新記錄。去重時也不能只看顯示名稱；兩筆同名資料可能使用不同連接埠、傳輸方式或驗證資料。整理方式可參考訂閱分組與伺服器篩選筆記；執行批次操作前，請先保留可還原的匯出檔案。

設定備份應存放在受保護的位置，不要與公開截圖或問題描述一併上傳。匯出檔可能同時包含伺服器驗證資料與訂閱網址，只改顯示名稱無法移除敏感內容。還原至另一台裝置後，仍須重新檢查本機連接埠、系統代理、檔案路徑及權限；這些裝置相關設定不能直接依賴舊備份照搬。

系統代理、TUN 與路由

先了解流量接管方式，再選擇模式

系統代理、TUN 與路由規則位於不同層次。系統代理會告訴願意遵循設定的應用程式，將請求送至本機連接埠；TUN 則透過虛擬介面接管相應的網路流量；路由規則負責決定已進入核心的連線要使用哪個出口。即使路由設定得再完整，也無法代理從未進入用戶端的應用程式流量；這是排查時首先要釐清的界線。

桌面日常瀏覽可以先使用系統代理，確認網頁可正常存取且記錄相符後，再考慮其他接管需求。有些應用程式有獨立代理設定，也可以直接填入本機監聽位址。TUN 的涵蓋範圍較廣，但也會增加介面、路由、DNS 與權限等變數；並非所有環境都適合一開始就啟用，更不能把它當成修正錯誤伺服器參數的開關。

「全域」通常是指流量進入用戶端後如何選擇出口，不代表電腦上的每個連線都會被接管。使用系統代理時，即使選擇全域路由，不讀取系統代理設定的應用程式仍可能直接連線。反過來說，啟用 TUN 後也能透過路由讓部分目標直接連線。判斷流量去向時，須一併檢查接管方式、規則比對結果及實際出口記錄。

路由順序與 DNS 設定

規則通常依順序比對，實際行為以所用核心為準。請將精確的例外規則放在較廣泛的規則之前，並清楚記錄每條規則的用途。新增規則後，用一個明確的目標測試，不要一次匯入多組彼此可能覆蓋的規則。網域規則與 IP 規則並不相同：連線進入核心時能否取得網域資訊，會影響規則是否有機會比對成功。

以下是 Xray 路由物件的結構範例，表示將私有位址範圍交給名為 direct 的出口。這只是完整設定中的一部分，且要求該出口標籤已存在；不能單獨作為可啟動的用戶端設定。圖形化用戶端可能會自動產生設定，直接修改產生的檔案通常會被覆寫，建議優先使用介面中的路由設定。

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

網域名稱解析的位置也會影響結果。由應用程式先解析成 IP，與將網域交給代理解析，是兩種不同路徑。使用 TUN 時也可能由 TUN 接管 DNS，不能只修改瀏覽器設定就認定解析方式已變更。若網域解析失敗但 IP 位址可連線，請檢查實際解析入口與記錄，不要立刻替換所有 DNS 位址；一次只修改一個環節，才方便比較。

區域網路分享與存取範圍

要分享給其他裝置使用，請先確認電腦本身連線正常，再開啟「允許來自區域網路的連線」或相應的監聽設定。其他裝置要填的是電腦目前的區域網路位址與本機代理連接埠，不是遠端伺服器位址，也不是 127.0.0.1。迴路位址一律指向填入該位址的裝置；手機填入後，只會尋找手機本身提供的服務。

使用同一個無線網路，不代表裝置之間一定能互通；訪客網路、無線隔離與系統防火牆都可能阻擋存取。請先確認兩台裝置的網段與網路類型，再只允許必要的程式或連接埠通過防火牆。開啟監聽時應限制在可信任的網路；若用戶端支援驗證，可依需求啟用。不要為了方便測試，就透過路由器將本機代理轉發至公用網路。

分享時也要確認接收端支援的代理類型。裝置設定若只提供 HTTP 代理，就不能填入只提供 SOCKS 的連接埠；有些裝置的代理設定也只會影響部分應用程式。停止分享後，請關閉區域網路監聽，並清除其他裝置中的代理位址。更完整的裝置端設定順序，請參閱v2rayN 區域網路分享筆記；不要把分享問題和本機遠端連線問題混在一起處理。

常見設定問題與連線疑難排解

依故障階段蒐集資訊

先界定故障範圍：是訂閱無法更新、核心無法啟動、所有應用程式都無法使用，還是只有特定應用程式或目標失敗。接著記下上次正常使用後修改過的項目，以及目前的接管方式。排查時請固定測試目標與應用程式，避免一邊換網路、一邊換伺服器又修改 DNS，最後無法重現最初的錯誤。

用戶端視窗正常，不代表核心也正常。先查看記錄檔是否出現設定載入完成、本機監聽建立等訊息，再找出最早出現的錯誤。連接埠遭占用、設定欄位不支援、資料檔案遺失與遠端逾時是不同問題。若啟動時出錯，先修復本機執行環境，不必急著更換訂閱；本機入口正常後，再檢查遠端連線及應用程式是否有使用代理。

請縮短查看記錄檔的時間範圍：記下測試開始時間，送出一次請求，再查看前後相近的記錄。大量無關的舊記錄容易掩蓋最初的錯誤。暫時提高記錄詳細程度以完成排查後，請恢復日常設定。分享記錄檔前，請刪除訂閱網址、使用者識別碼與驗證參數；只需保留錯誤類型、發生階段及必要的環境資訊。

逾時、連線遭拒與憑證錯誤

「連線遭拒」通常表示該位址與連接埠沒有服務接受目前的連線，也可能是中間網路設備造成；「逾時」則表示等待期間未收到預期回應，可能原因更多。請先核對遠端位址與連接埠，再從本機記錄確認實際連線目標。若只在某個網路失敗，可保持設定不變，改用另一個網路比對，不要直接更改協定類型。

遇到 TLS 憑證或握手錯誤時，先校正系統日期、時間與時區，再檢查 SNI、伺服器位址、安全類型及傳輸參數是否與伺服器端一致。網域解析到錯誤目標，也可能導致取得不相符的憑證。「略過憑證驗證」無法修正這些參數，還會降低身分驗證能力，不應當作日常解法或預設範本保存。

若核心無法辨識設定欄位，請確認匯入的是否為另一種核心專用格式，或用戶端是否選用了不適合的核心。更新用戶端與切換核心是兩種不同操作，無法保證任一操作都能解決所有相容性問題。請先依錯誤欄位確認所需功能，再選擇用戶端。核心背景可參考Xray 與 V2Fly 的差異；握手問題則可查看TLS 與憑證疑難排解筆記。

還原預設設定並逐項重新測試

瀏覽器能用、其他應用程式不能用時，先確認該應用程式是否讀取系統代理、有沒有獨立設定，以及是否被依應用程式設定的規則排除。只有部分目標失敗時，請檢查路由比對、網域解析及目標本身的狀態，不必因此重裝整個用戶端。若 TUN 無法使用，但系統代理正常，請優先檢查虛擬介面、DNS 接管、路由衝突與權限，不要先重新輸入伺服器驗證資料。

需要還原時，先匯出目前設定，再停用自訂路由與額外 DNS 設定、關閉 TUN，並保留一台明確選取的伺服器來測試系統代理。Android 端則先還原預設的依應用程式設定範圍，再重新授權 VPN。每次只還原一個變數並記下結果；確認基本連線正常後，再依原本順序逐項啟用功能，找出最早造成異常的設定。

退出用戶端後一般網路仍異常，請先還原系統代理、檢查永遠開啟的 VPN 政策，並確認沒有其他程式持續接管網路。網路恢復後再啟動用戶端，觀察本機監聽與遠端握手狀況。若要尋求協助，請提供作業系統與架構、用戶端名稱、接管方式、已去除敏感資訊的錯誤原文，以及已測試的步驟。這些資訊比只顯示「無法連線」的截圖更有幫助，也能避免重複檢查已排除的項目。