V2Ray 全平台安裝與設定

事前準備：平台、設定與連線方式

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

V2Ray 是 Project V 生態系中的技術名稱，實際安裝與日常操作主要透過圖形化用戶端完成。桌面平台首選 v2rayN；Android 優先選用 Xray 核心的 v2rayNG，需要 V2Fly 核心時再考慮 v2flyNG。用戶端負責儲存設定、更新訂閱並提供操作介面；核心則負責處理協定、連線與路由。安裝用戶端不會自動取得伺服器，也不會自動產生可用訂閱。開始前，請準備設定提供者提供的訂閱網址、分享連結或完整設定檔，並確認適用的用戶端。

設定相容性不能只看名稱是否相似。VMess、VLESS、Trojan 等協定各有對應欄位，傳輸方式與 TLS 設定也必須一致。含有 REALITY 參數的設定，請確認目標核心及其具體實作支援相關功能；不可任意將原設定的安全選項改成其他方式。用戶端顯示一筆項目，只代表匯入程式辨識了部分內容，不表示核心已接受所有參數。訂閱格式說明不清楚時，請先向提供者確認輸出格式，不要反覆切換核心碰運氣。

確認系統架構與安裝位置

下載前，先在系統設定中確認處理器架構，再選擇安裝檔。Windows 下載區分桌面版與經典 WPF 版；macOS 區分 Apple Silicon 與 Intel；Linux 區分 deb、rpm 與處理器架構；Android 則區分 arm64 與通用版。架構不符可能導致安裝程式無法執行，或直到啟動核心時才出現錯誤。桌面版建議安裝在目前使用者可寫入的一般資料夾，避免直接從壓縮檔預覽視窗啟動，也不要將執行目錄放在暫存下載快取、常發生同步衝突的資料夾或唯讀位置。

準備網路與設定資料

先確認尚未啟用代理時，系統網路本身可正常連線至一般服務，系統日期與時區也正確。請完整保存訂閱網址，特別留意查詢參數、大小寫與結尾字元；網址中的存取權杖屬於憑證，不應貼到公開討論區。排錯時記下用戶端名稱、系統架構、所選核心與錯誤時間，但不要記錄完整訂閱網址。若需提供截圖，請先遮住伺服器網址、使用者識別資訊與個人帳戶資料。遷移既有用戶端前，請先透過匯出功能備份設定，並將備份存放在自己可控的位置。

了解系統代理、TUN 與 VPN 的差異

桌面系統代理會將本機代理網址提供給遵循系統設定的應用程式，通常適用於瀏覽器與一般桌面程式。TUN 透過虛擬網路介面接入更多流量，也會牽涉路由、DNS 與額外權限。Android 用戶端通常透過系統 VPN 介面接管應用程式流量，首次啟動時會出現系統授權提示。這些方式決定流量如何進入核心，與核心如何選擇出口是兩回事。初次設定建議只啟用一種接入方式，驗證完成後再依需求增加其他選項，避免多個代理工具同時修改網路設定。

本指南中的選單名稱用於協助尋找功能，不保證各用戶端介面上的文字完全相同。版本更新可能會調整功能入口，查找時請留意「訂閱群組」、「系統代理」、「路由設定」等功能名稱，不要依賴按鈕顏色或固定位置。涉及執行環境、權限與驅動程式的提示，請閱讀用戶端目前版本的發行說明及系統彈出訊息；不要因為舊教學要求以系統管理員身分啟動，就將所有日常操作都改成高權限執行。完成安裝準備後，再前往對應平台章節，避免混用不同系統的操作步驟。

Windows：v2rayN 安裝與系統代理

選擇桌面版或經典 WPF 版

前往Windows 下載區，先區分桌面版與經典 WPF 版。桌面版採用跨平台介面，WPF 版則延續經典 Windows 介面；兩者的選單配置、設定入口與相依需求可能不同。請優先考量系統相容性與既有操作習慣，不要將兩套程式安裝到同一資料夾。下載區目前提供對應架構的下載入口；若裝置架構與入口不符，請先查閱目前版本的發行說明，不要只因為標示 Windows 就認定任何安裝檔都能原生執行。

取得安裝檔後，依檔案類型完成安裝或完整解壓縮。需解壓縮的套件請展開所有資料夾，維持用戶端與隨附核心檔案的相對位置，再從解壓後的資料夾啟動。首次執行若提示缺少執行環境，請依程式提示的環境名稱與架構安裝相應元件，不要隨意安裝多套執行階段。若系統阻止啟動，請先確認檔案來源、系統提示的具體原因與本機防護紀錄，不要直接關閉整套防護功能。介面可以開啟但核心無法執行時，也請確認核心檔案是否完整保留在預期資料夾中。

匯入訂閱並選擇可用設定

在訂閱群組設定中新增群組，填入方便辨識的名稱，再貼上完整訂閱網址並儲存。儲存群組與取得內容是兩個步驟：儲存後請執行更新訂閱，等待清單出現設定項目。若使用單一分享連結，可透過用戶端的剪貼簿匯入功能新增，不必為單筆設定建立遠端訂閱。匯入後請檢查協定、傳輸與安全選項是否符合來源說明，再將一筆設定設為目前使用項目。在清單中點選並反白，不一定代表已切換目前使用的設定，請以用戶端狀態提示為準。

若訂閱清單沒有內容，先查看更新提示是否顯示連線、驗證或解析失敗。連線失敗時，檢查下載訂閱時使用直連或既有代理；驗證失敗時，確認網址是否已過期；解析失敗時，確認回傳內容是否為用戶端支援的訂閱格式。不要反覆新增同名群組來嘗試解決，這會增加重複項目，反而讓問題更難判斷。若已有可用設定，可保留作為備援，再單獨檢查新群組，避免一次清除所有設定後失去可用連線。

啟用系統代理，再視需要啟用 TUN

先啟動目前使用的設定，再選擇自動設定系統代理。接著開啟系統代理設定，確認代理網址指向用戶端實際監聽的本機位址，連接埠也與用戶端設定一致。HTTP、SOCKS 與混合入口不能任意互換，手動設定應用程式代理時必須配對正確的連接埠類型。若瀏覽器安裝了獨立代理擴充功能，它可能不會讀取系統設定；驗證時請先停用該擴充功能的代理接管。需要讓不遵循系統代理的程式連線時，再考慮 TUN；啟用前先清除系統代理，減少兩種接入路徑重疊造成的干擾。

處理權限、退出還原與遷移

TUN 可能需要提升權限或安裝相關網路元件，請依用戶端目前的提示操作，不要長期以系統管理員身分執行整個程式。啟用後若內網印表機、共用資料夾或企業網路受到影響，請先停用 TUN，確認是否為路由接管範圍所致，再新增必要的直連規則。使用其他 VPN 或企業連線軟體時，請逐一測試，不要假設多張虛擬網卡會自動協調。從睡眠狀態恢復後若出現異常，可先停止服務再重新啟動，並檢查虛擬介面與 DNS 是否恢復正常。

正常退出前，請使用用戶端的清除系統代理功能，再關閉程式。若用戶端意外結束，系統可能仍保留指向本機連接埠的代理設定，導致瀏覽器連到已停止監聽的位址。重新開啟用戶端以清除設定，或前往系統代理頁面確認並還原原狀。遷移至其他資料夾時，請先退出程式並備份設定，再移動完整資料夾；不要同時執行兩個共用同一設定資料夾的執行個體。更多桌面介面差異請參閱v2rayN Windows 安裝與設定完整流程，排錯時仍應以目前的日誌為準。

macOS：晶片選擇、權限與網路服務

依晶片類型選擇 v2rayN

在系統的「關於這台 Mac」中查看晶片資訊，再前往macOS 下載區選擇適用於 Apple Silicon 或 Intel 的 v2rayN 安裝檔。不要依裝置購買年份推測晶片，也不要把檔名中的架構標記當成可忽略的字樣。下載完成後開啟磁碟映像檔，依套件內的指示將 App 放入一般應用程式資料夾，再從安裝後的位置啟動。執行中的 App 不應長期依賴仍掛載的下載映像檔，否則後續更新、路徑參照與解除安裝容易混淆。

首次開啟時，系統可能要求確認 App 來源或阻止執行。請先閱讀系統提供的具體原因，確認來源與安裝步驟後，再使用系統允許的單次開啟方式處理。不要使用批次移除系統防護的指令，也不要將「來源限制」與「App 已損毀」兩種提示視為同一個問題。若用戶端介面正常但核心退出，請繼續檢查架構、執行權限與日誌中的檔案路徑；反覆拖曳 App 圖示通常無法解決核心執行環境不相容的問題。

建立訂閱群組與目前使用的設定

開啟訂閱管理功能，建立獨立群組，填入訂閱網址並執行更新。群組名稱僅供本機辨識，遠端內容取決於網址及其參數。匯入分享連結時，請先確認剪貼簿中只有完整連結，沒有聊天軟體附帶的說明文字、引號或換行。更新完成後選擇一筆目前使用的設定，確認核心可正常啟動，再設定系統代理。從桌面平台遷移的設定可能含有其他系統的本機檔案路徑，例如規則檔或憑證路徑；這些欄位需要重新指定，不可直接沿用。

訂閱更新使用哪條網路路徑，取決於用戶端提供的更新選項與當時的連線狀態。首次啟動時若尚無可用設定，而更新又依賴代理，就會形成必須先有設定才能更新的循環。此時請依提供者說明取得可用的初始設定，或確認目前網路能否直接連線至訂閱端點。已可連線時，不要為了更新一組訂閱而刪除所有舊設定。更新完成後，請確認目前使用的項目仍存在，避免遠端設定重新命名後，用戶端沒有自動選取替代項目。

確認目前網路服務的代理狀態

macOS 的代理設定會套用至網路服務。用戶端啟用系統代理後，請在目前實際使用的網路服務中檢查設定，例如正在使用的 Wi-Fi 或有線網路。切換網路、連接擴充基座或調整服務順序後，原有代理狀態可能不再對應目前的連線路徑。瀏覽器是否讀取系統代理也會受到自身設定影響，使用獨立代理擴充功能的瀏覽器應另外檢查。請先用一個會讀取系統設定的應用程式驗證，再檢查其他應用程式；不要只憑選單列圖示就認定整個系統的流量都已接入。

系統代理正常，但特定應用程式仍直接連線，可能是該程式忽略系統設定或使用自己的網路堆疊。需要擴大接入範圍時再考慮 TUN，並依用戶端提示處理權限。啟用前先記錄原有網路代理與 DNS 設定，並停止其他同類網路接管工具。企業裝置可能透過管理政策限制修改網路設定，此時應遵守裝置管理規範，反覆授權無法解決政策限制。成功授權也不代表核心已接管流量，仍須透過日誌與實際應用程式請求確認。

處理睡眠、切換網路與退出後殘留設定

從睡眠狀態喚醒後若連線異常，先確認系統已連上網路，再停止並重新啟動用戶端服務。若只有切換網路後才失敗，應優先檢查目前服務的代理設定、DNS 與舊連線是否仍存在，而不是立刻更換協定。正常退出前先清除系統代理；應用程式意外關閉後，若瀏覽器持續顯示無法連線至代理伺服器，請檢查目前網路服務是否仍指向本機位址。還原設定時只撤銷本次用戶端寫入的內容，不要順手刪除企業網路所需的其他設定。

更新用戶端前，請備份訂閱群組與自訂路由，並記下所選核心。替換應用程式後，先用原有的簡單設定驗證，再還原複雜規則。若新程式無法讀取舊資料夾，請檢查設定儲存位置與目前使用者的權限，避免直接複製整個快取資料夾而造成權限繼承問題。平台排錯時，應區分應用程式啟動、核心啟動與系統接入三個階段：應用程式無法開啟就檢查系統提示；核心退出就查日誌；只有業務應用程式失敗時才檢查代理路徑。分階段處理，比不斷重新安裝更容易保留可判斷的結果。

Linux：套件格式、桌面代理與 TUN 權限

依發行版與架構選擇安裝檔

前往Linux 下載區，先依發行版選擇 deb 或 rpm，再確認架構是 x64 或 arm64。deb 常用於 Debian、Ubuntu 及相關發行版；rpm 常用於 Fedora 等發行版，但套件格式相同不代表相依套件完全一致。安裝前請查看目前發行版的套件安裝工具所列出的相依性提示，不要忽略錯誤後直接嘗試啟動。圖形化用戶端需要桌面工作階段，只有命令列環境的伺服器不在本頁的操作範圍內，請勿照搬桌面自動啟動與系統代理步驟。

優先使用系統的圖形化軟體安裝工具開啟安裝檔，讓套件管理器處理相依性與檔案登記。若安裝程式提示缺少相依套件，請記下元件名稱與系統版本，再確認目前的發行套件是否適用於該系統。不要從不明來源將動態程式庫複製到系統資料夾，也不要混淆相依套件缺失與執行權限不足。安裝完成後，從桌面應用程式選單啟動 v2rayN，確認圖形介面、設定資料夾與日誌功能可正常使用。用戶端與核心的執行檔應維持套件預期的資料夾結構，不可只把主程式複製到桌面。

以一般使用者身分匯入與執行

首次啟動時請使用日常桌面帳戶，新增訂閱群組並更新，或匯入單一分享連結。設定資料夾應允許目前使用者正常寫入；若曾以高權限啟動，可能會留下其他使用者無法修改的檔案。儲存失敗時，先檢查資料夾權限與剩餘空間，不要繼續提高整個程式的權限。選定目前使用的設定後，請查看核心日誌，確認是否為連接埠占用、檔案遺失或不支援欄位。桌面版的設定入口可能與 Windows 類似，但本機路徑、權限與網路接管機制不能直接照搬其他平台的做法。

自訂規則、憑證或外部資源檔應放在穩定且可讀取的位置，再透過用戶端設定選取。不要使用可移除式儲存裝置上的暫存路徑，也不要假設從其他電腦匯出的絕對路徑仍然存在。訂閱中的遠端伺服器參數通常與系統無關，但附加檔案與本機監聽設定屬於環境設定，遷移後需要逐項檢查。若設定匯入成功卻無法啟動，請先在日誌中找出第一筆明確錯誤，不要只看介面最後顯示的「啟動失敗」摘要。

了解桌面系統代理的適用範圍

Linux 的系統代理取決於桌面環境與應用程式的實作，不能視為所有程式必然遵循的總開關。用戶端寫入桌面代理後，瀏覽器可能會套用設定，但有些程式只讀取自身設定或環境變數。驗證時請分別檢查瀏覽器、目標業務程式與用戶端日誌，不要因為一個應用程式可用就認定所有流量都已接管。若目標程式提供手動代理設定，請選擇正確的 HTTP 或 SOCKS 類型，並填入用戶端實際監聽的連接埠；環境變數與圖形桌面設定也可能互不相通。

尚未確認監聽類型前，不建議把同一個位址填入所有代理欄位。HTTP 代理連接埠、SOCKS 連接埠與混合入口的行為不同，是否支援 UDP 也取決於接入方式與核心設定。使用本機代理時通常應維持迴路位址，不要只為了讓單一程式辨識代理，就將監聽位址改為所有網路介面。允許區域網路存取屬於另一類設定，還須考量驗證、防火牆與存取範圍，不應作為一般桌面安裝的預設步驟。

視需要啟用 TUN，區分權限與政策

TUN 接入涉及虛擬網路裝置、路由表與 DNS，所需授權方式會因發行套件與系統而異。請透過用戶端提供的功能設定權限，不要為整個應用程式資料夾開放過寬的權限。啟用失敗時，先檢查日誌是否明確指出建立裝置、操作路由或權限遭拒，再查看系統政策紀錄。防火牆與系統存取控制可能影響網路接入，但應確認具體規則，而不是關閉所有政策。若有容器網路、企業 VPN 或其他虛擬介面，請先停用其中一套，建立最精簡可用的狀態。

桌面登入時自動啟動與系統服務並非同一回事。圖形化用戶端通常依賴使用者工作階段，設定自動啟動後應登出再登入驗證，不要誤將其註冊成長期以高權限執行的服務。系統升級後若只有 TUN 失效，請優先檢查權限、虛擬介面與路由是否恢復，再考慮用戶端相容性。正常退出前請撤銷接入設定；重新啟動後仍有異常，則檢查系統是否殘留手動代理。排錯記錄應包含桌面環境、發行版、架構與使用的接入模式，才能區分應用程式問題與系統環境差異。

Android：匯入設定與 VPN 模式

優先選用 v2rayNG，依需求選擇 v2flyNG

Android 下載區首先提供 v2rayNG，適用於使用 Xray 核心的設定；v2flyNG 則是使用 V2Fly 核心的替代選項。選擇時應依據設定所用的協定與核心功能，不要因名稱相似就認為兩者完全相同。大多數較新的主流裝置可優先考慮 arm64；若無法確認架構，或安裝程式明確提示不相容，再查詢裝置資訊並考慮通用版。處理器支援某項能力，不一定代表系統執行環境完全相同，最終仍應以裝置系統與安裝檔需求為準。

下載後透過系統檔案管理員開啟安裝檔，依提示允許目前來源安裝這次套件。授權對象可能是瀏覽器或檔案管理員，請確認正在授權的應用程式，不要替無關程式開啟安裝權限。安裝完成後開啟用戶端，先確認設定與日誌入口，再匯入設定。更新時若提示簽章衝突或無法覆寫，請先備份現有群組與設定，確認舊應用程式來源與新套件是否一致；不要等到解除安裝後才發現設定只儲存在舊應用程式中。

匯入訂閱、分享連結與 QR Code

使用訂閱管理功能新增群組，輸入完整網址並儲存，再執行更新。複製網址時，避免把聊天對話框中的說明文字一併複製；若提供者給的是分享連結，請使用相應的匯入功能，不要將連結貼到訂閱網址欄位。QR Code 適合匯入單筆設定，但掃描結果仍須檢查協定與參數。貼上後若沒有新增項目，請先查看用戶端提示與剪貼簿內容，不要連續點選匯入造成重複項目。訂閱更新成功後，選擇目前使用的設定再啟動連線。

在 v2rayNG 與 v2flyNG 之間遷移時，請使用兩者都支援的標準分享格式，或請提供者重新提供相容的訂閱。不要將一款用戶端的所有內部資料直接覆寫到另一款用戶端的資料夾。同一協定名稱下，安全參數、傳輸選項與核心擴充功能也可能不同，特別是使用特定核心功能的設定。若匯入後只出現部分項目，請先確認未顯示項目的協定與格式，不能只憑清單筆數判斷遠端訂閱是否完整。

授權 VPN 介面並驗證連線

首次啟動時通常會出現 Android 的 VPN 連線要求，確認由目前的用戶端發起後再授權。授權表示允許應用程式建立系統 VPN 介面，不代表遠端連線已成功。啟動後請確認用戶端回報核心正常運作，再以實際目標應用程式驗證。狀態列出現 VPN 圖示只表示介面已接入，遠端伺服器、DNS 與路由仍可能失敗。若裝置已連線至另一款 VPN，請先中斷連線再測試，避免系統在兩者間切換或拒絕建立新介面。

應用程式分流會決定哪些程式進入 VPN 介面，「僅允許所選應用程式」與「排除所選應用程式」兩種邏輯可能相反。啟用前請先閱讀目前介面的說明，再選取測試應用程式。應用程式進入介面後，仍須由核心路由決定直連或代理，因此選取應用程式不代表所有請求都會走相同出口。初次驗證建議關閉複雜的應用程式篩選，先用簡單設定確認整體可用，再逐項加回；否則被排除的瀏覽器可能讓人誤以為伺服器失效。

處理背景限制、私人 DNS 與網路切換

螢幕熄滅後連線中斷，請優先檢查系統是否限制用戶端的背景活動、電池使用或自動啟動。不同裝置的設定位置不一，請依應用程式的背景執行權限查找，不要照搬特定品牌的固定路徑。允許背景活動後重新連線，並觀察前景狀態通知是否持續顯示。若用戶端仍在執行，只有網域請求失敗，再檢查系統私人 DNS、用戶端 DNS 與網路環境是否互相衝突。排錯時一次只調整一項，記下原設定，驗證後再決定是否保留。

在 Wi-Fi 與行動網路之間切換，可能會使舊連線失效，通常需要用戶端重新建立連線；不要將短暫重新連線直接判定為設定錯誤。若持續失敗，先停止連線，確認系統網路恢復後再重新啟動服務。若同一設定只在某種網路環境下失敗，請檢查該網路是否能連線至訂閱端點與伺服器，並將具體錯誤回報提供者。退出用戶端前請主動停止 VPN；需要長時間保持連線時，也應檢查系統的持續連線與封鎖選項，避免用戶端停止後仍因系統政策而無法上網。

訂閱管理：格式、更新與設定遷移

分清訂閱網址、分享連結與完整設定

訂閱網址是用戶端取得設定集合的遠端入口，內容可能隨提供者調整；分享連結通常描述單筆設定，匯入後不一定會隨遠端更新；完整設定檔則可能包含入站、出站、DNS 與路由等多個部分。三者不能只看文字外觀就互相替代。將網頁網址貼到訂閱欄位，用戶端可能取得的是網頁內容，而非設定資料；將完整 JSON 當成分享連結匯入，也可能無法辨識。請先確認收到的資料類型，再使用相應入口，可避免大多數匯入錯誤。

訂閱的編碼與容器格式只是外層，實際相容性取決於內部協定與欄位。能夠解碼不表示所有項目都能啟動；訂閱轉換也無法補上原始資料中缺少的公開金鑰、服務名稱或路徑。確實需要轉換時，請優先使用來源明確且可控的方式，並了解轉換過程會接觸訂閱憑證。不要將個人訂閱網址提交給資料處理方式不明的工具；若設定依賴特定核心功能，請先確認目標用戶端支援，再考慮格式轉換，而不是反過來試圖透過轉換強行遷移。

將更新流程分成四個階段

訂閱更新可分為讀取網址、網路請求、解析內容與套用清單四個階段。讀取網址失敗通常是空白字元、內容遭截斷或跳脫字元錯誤；網路請求失敗可能與 DNS、連線路徑、驗證或伺服器狀態有關；解析內容失敗表示回傳格式不符合預期；套用清單異常則需檢查篩選條件、重複規則與目前群組。若日誌只顯示更新失敗，請先找出較早出現的具體提示。依階段定位比一遇到錯誤就更換核心有效，因為訂閱請求不一定經過目前使用的協定連線。

更新前請留意用戶端選擇的下載路徑：直連、透過目前代理或其他可用方式，實際選項以介面為準。若目前設定已失效，訂閱更新又依賴該設定，故障就會互相影響。請保留一筆已確認可用的設定作為備援，必要時先恢復更新路徑。驗證失敗時不要連續頻繁重試，應確認訂閱是否已重設、帳戶狀態是否變更，以及網址參數是否完整。即使回應成功，清單也可能為空，因為遠端確實沒有可用項目；請查看提示，不要不斷建立新群組。

管理群組、目前使用項目與本機變更

不同來源的設定應建立獨立群組，並以自己能辨識的用途或來源命名，避免所有項目都堆在預設清單中。訂閱更新可能會取代由遠端管理的項目，本機手動修改的名稱與部分參數未必能保留。需要長期保存的自訂設定，請使用用戶端提供的複製或獨立設定功能，並留意這類設定不會再自動同步原訂閱。遠端設定重新命名或刪除後，目前使用的項目可能失效，因此更新完成後請確認選取項目仍存在，並重新驗證核心狀態。

遷移時先還原資料，再還原系統接入

遷移至新裝置時，先備份舊裝置資料，再於新裝置建立最精簡的設定。優先還原訂閱或分享項目，確認核心可啟動後，再還原路由、應用程式篩選與自動啟動。系統代理連接埠、網卡名稱、本機檔案路徑與權限都屬於裝置環境，不應直接複製。完整用戶端備份適合在相近環境中還原，但仍須檢查核心選擇與接入設定。新舊裝置不要透過同步工具同時寫入同一個作用中的資料庫，以免發生覆寫或鎖定問題。

訂閱網址、匯出檔與含有連線參數的截圖都應視為憑證。公開求助時，保留錯誤類型、協定名稱與必要的欄位結構，移除使用者識別資訊、伺服器資訊與存取權杖。若網址已外洩，刪除貼文不代表憑證已撤回；請透過提供者支援的管理方式重設，再更新各裝置儲存的網址。常見格式問題可參閱常見問題；需要了解訂閱與設定欄位的差異時，可搭配術語表確認概念，避免混淆更新失敗與連線失敗。

代理與分流：接入、路由與 DNS

依流量路徑了解設定

完整流程可理解為：應用程式發出請求、流量進入本機入口、核心比對規則、選擇出站連線，再連至目標。系統代理與 TUN 決定前半段如何接入；路由規則則決定後半段選擇直連、代理或拒絕。用戶端顯示「全域」時，請先確認它指的是系統代理的接入範圍，還是核心將已接入流量統一送往代理出口；不同介面可能採用不同名稱。未進入本機入口的請求，不會因切換核心路由模式就自動受管，因此某些程式始終直連。

一般瀏覽器使用時可先選擇系統代理，只有確實需要接管更多程式或協定時再啟用 TUN。系統代理下的應用程式若繞過本機位址，可能是該程式自己的例外清單；TUN 下的直連則可能由核心規則或網段排除設定造成。排錯時應先確認請求是否進入核心，再判斷符合哪條規則。若還不知道問題發生在哪個環節，不要同時啟用 TUN、修改 DNS、切換全域模式並更換伺服器；即使連線恢復，也無法判斷真正生效的是哪個步驟。

設定路由規則前，先釐清優先順序

多數規則會依序比對，較早符合的規則會影響最終出口。區域網路、特定服務網域與預設出口都應有明確位置。過於寬泛的規則若放在前面，會遮蔽後續的細部規則；反之，缺少預設處理方式，也會讓未符合規則的請求走向非預期出口。以下範例是 Xray 風格的路由片段，只示範私有位址直連與特定網域後綴比對。這不是完整連線設定，既有出站必須定義相應標籤，不可直接將此片段當成完整伺服器設定匯入。

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

範例中的 domain:example.com 表示比對該網域及其子網域，不是用來驗證實際服務連線的網址。direct 與 proxy 是出站標籤，必須與實際設定中的標籤一致；核心也需要能讀取相應規則資料，才能分類私有位址。圖形化用戶端可能會自動產生標籤與規則，使用其路由編輯器時請依照目前欄位規範，不要混貼不同核心的語法。修改前請備份舊規則，修改後先確認設定可啟動，再測試規則是否命中。

DNS 解析與網域比對會互相影響

DNS 負責將網域名稱解析為位址，但請求經過應用程式、本機系統與核心時，網域資訊不一定會完整保留。若應用程式先自行解析，再只傳送 IP，核心可能無法直接依原始網域比對；能否還原網域資訊，也取決於接入方式與相關功能。選擇 DNS 伺服器時，還要考量它本身如何連線；不要將目前路徑無法到達的位址設為唯一解析來源。網域無法開啟但已知連線仍可建立時，請先檢查解析流程，不要直接認定協定不相容。

FakeDNS 透過虛擬位址映射保存網域關係，必須搭配流量接入與網域還原機制使用。這不是更換 DNS 位址就能單獨運作的功能，啟用後也可能影響區域網路服務、應用程式快取與網路切換。初次安裝不建議為了「設定齊全」而直接啟用。確實需要依網域分流時，請先記錄一般 DNS 狀態，再依用戶端支援方式設定並測試；發生問題時才能完整還原。原理與限制請參閱FakeDNS 運作原理詳解。

以最少變數驗證分流

每次只驗證一個目標應用程式與一種接入方式，確認請求進入核心後，再檢查出口與 DNS。區域網路存取異常時，先檢查私有網段與名稱解析；遠端服務異常時，再檢查協定與伺服器連線。需要更新規則資料時，請區分規則資源更新與訂閱更新，兩者不是同一個按鈕。Xray 與 V2Fly 的設定能力也不完全相同，切換核心後應重新檢查自訂規則；生態系與功能取捨可參閱Xray 與 V2Fly 核心差異，不要只靠改名嘗試相容。

常見設定問題：依故障階段排除

分開處理安裝失敗與核心故障

安裝程式無法執行時，先確認系統架構、套件格式與安裝程式提示；圖形介面能開啟但服務啟動失敗時，則應檢查核心日誌。連接埠占用、檔案路徑不存在、權限不足與未知欄位，都可能使核心退出，但處理方式各不相同。日誌中第一筆明確錯誤通常比最後的失敗摘要更重要。若連接埠遭占用，先確認是否有舊執行個體或其他程式使用相同連接埠，再停止衝突程式或修改監聽連接埠；修改後也須同步更新應用程式與系統代理設定，否則會產生新的連線問題。

出現未知協定或欄位錯誤時，先確認設定所需的核心，不要任意刪除錯誤欄位。刪除安全欄位或許能通過解析，卻可能使連線行為偏離提供者要求。檔案遺失時請檢查安裝資料夾、資源路徑與防護紀錄；權限錯誤則應確認具體檔案或網路操作，不要一律提高整個程式的權限。完整設定檔也要留意 JSON 語法，例如多餘逗號、引號是否成對及欄位型別。錯誤分類請參閱v2rayN 核心啟動失敗日誌診斷。

顯示已連線，但網頁無法開啟

「已連線」可能只代表核心或系統接入介面已啟動，不表示每個目標請求都成功。先確認實際應用程式是否進入本機入口：桌面平台請檢查系統代理與瀏覽器的獨立代理設定；Android 請確認 VPN 是否仍在執行，以及應用程式是否遭排除。接著確認監聽連接埠，再檢查 DNS 與路由，最後才查看遠端連線。若日誌完全沒有目標請求，應先處理接入問題；若日誌已顯示請求但連線逾時，再檢查出口、網路與伺服器。不要跳過前面步驟，直接將所有問題歸咎於遠端失效。

只有部分網站無法使用時，可能與網域規則、解析結果、目標服務本身或使用的傳輸方式有關，不一定代表整個用戶端失效。用同一個應用程式比較不同目標，再用另一個應用程式測試相同目標，可區分應用程式設定與目標路徑問題。測試時避免連續切換多項設定，請等候每次連線完成或回報錯誤。系統代理、DNS 與路由的詳細檢查順序，請參閱已連線卻無法上網排查清單；記錄結果後再繼續修改，避免臨時設定互相覆蓋。

訂閱失敗、握手失敗與時間問題

訂閱更新失敗時，先檢查請求路徑與回傳類型；遠端連線握手失敗時，則確認伺服器位址、連接埠、使用者識別資訊、傳輸路徑與安全參數。TLS 相關錯誤還要檢查系統日期、時區與伺服器名稱欄位，不要透過關閉驗證來掩蓋問題。設定要求的服務名稱、主機名稱與伺服器位址不一定相同，請依提供者資料逐項填寫，不要憑經驗替換看似相近的值。修改分享連結中的編碼參數也容易破壞語法，建議重新匯入完整原始連結，再與本機項目比對。

同一設定在另一台裝置上正常，只能表示遠端在該次測試條件下可用，不能直接證明本機用戶端有缺陷。請比較兩台裝置的核心、系統時間、接入方式、DNS、網路環境與應用程式篩選，盡量讓條件一致。若只有特定網路會失敗，請記錄是否能連線至訂閱端點、具體錯誤與發生階段。只有在確認設定資料夾損毀或安裝檔異常後，才應重新安裝；重新安裝不能取代對網路路徑與核心錯誤的分析，否則往往只是再次匯入相同問題。

升級回復、恢復連線與有效求助

升級前先匯出設定，記錄目前使用的核心、接入模式與自訂路由。升級後先驗證簡單設定，再還原額外功能。需要回復舊版時，請保留備份並確認舊程式能否讀取新版設定格式，避免不同程式交替寫入同一個資料夾。若用戶端停止後整個系統仍無法上網，先檢查桌面系統代理是否殘留，再檢查 TUN、VPN 與手動 DNS 是否已撤銷。Android 也要確認系統是否啟用了 VPN 中斷時封鎖連線的政策；恢復時只調整與本次用戶端相關的項目。

求助資料應包含平台、架構、用戶端名稱、所選核心、故障階段、最後一次變更，以及移除敏感資訊後的錯誤片段。說明是否只有單一應用程式失敗、是否在切換網路後發生、停止用戶端後能否恢復，比只說「連不上」更有助於定位。不要公開完整訂閱、連線 QR Code 或未處理的設定檔。修正後請在相同測試條件下再次驗證，再撤銷已無用的臨時設定。需要重新完成最簡連線流程時，請回到快速入門教學；需要查詢特定概念或常見狀況時，再參閱常見問題，讓安裝、驗證與排錯形成完整流程。