v2rayN 全平台安裝與設定

一般準備：先確認設定與網路狀況

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

v2rayN 是管理設定的圖形化用戶端，可儲存伺服器資料、產生執行設定，並呼叫可用的核心處理流量。Xray 與 V2Fly 是代理生態系中不同的核心實作，支援的協定與擴充功能並不完全相同。安裝用戶端只是備妥本機工具，不會自動取得遠端伺服器。開始前，請準備有權使用的訂閱連結或完整連線參數，並確認服務提供者說明了適用的用戶端、傳輸方式及必要的驗證資訊。

訂閱連結是設定的入口，不等同於伺服器位址。手動設定則須逐項填入位址、連接埠、協定驗證與傳輸參數。取得資料後，先確認它是訂閱、單一分享連結，還是核心設定檔，再選擇相應的匯入方式。請勿將完整連結直接填入位址欄，也不要把網頁說明誤當成訂閱內容。資料不完整時，先向設定提供者確認；自行猜測補齊欄位，通常只會增加排查範圍。

建立可復原的本機基準

先關閉其他正在接管網路的代理或虛擬網卡工具，保留一個用戶端進行測試。開啟一般網頁，確認目前網路本身可正常連線；在系統設定中啟用自動設定日期與時間，並確認時區正確。系統時間明顯偏差會影響憑證驗證，也可能影響需要時間校驗的協定。若電腦由組織管理，請先了解代理、憑證與網路延伸功能的管理規定，不要覆寫既有政策。

記錄原有的系統代理、手動 DNS 與網路介面設定；截圖時請遮住帳號與連結。設定時一次只調整一類項目：先測試伺服器，再啟用系統代理，最後才考慮 TUN。如此一來，遇到問題時就能復原至上一個狀態。初次連線不建議同時匯入複雜規則、更換核心並修改 DNS；若一次變動多個項目，即使連線恢復，也很難確認真正生效的是哪一項。

選擇接管範圍，再安排測試

系統代理只會影響會讀取系統代理設定的應用程式。瀏覽器通常可以使用，但命令列程式、遊戲或採用自有網路堆疊的應用程式未必會跟隨。TUN 透過虛擬網路介面接收更多流量，涵蓋範圍較廣，但也需要正確設定權限、路由與 DNS。初次設定時建議先測試系統代理；只有確認目標應用程式不使用系統代理，或確實需要全裝置流量分流時，再設定 TUN。

測試時請區分「設定已儲存」、「核心已啟動」與「網頁已透過預期路徑連線」三種狀態。視窗中顯示伺服器項目，不代表驗證已成功；系統匣顯示正在執行，也不代表瀏覽器已將流量交給用戶端。準備一個原本可正常連線的網頁，以及一個預期需透過指定出口連線的目標，依序檢查一般連線、代理連線與直連規則。請搭配記錄檔判讀測試結果，不要只根據圖示或單次測速下結論。

下載入口統一位於用戶端下載頁。請先前往對應平台區塊，再確認處理器架構與套件類型。本文不預設固定的選單配置：若找不到相同名稱的選項，請優先查看訂閱群組、設定、系統代理等功能區。若只想先完成一次可用連線，請前往快速入門，完成後再回來參閱備份與排錯章節。

macOS：晶片選擇、安裝與網路權限

辨識 Apple 晶片與 Intel 安裝檔

開啟 Apple 選單中的「關於這台 Mac」，查看「晶片」或「處理器」欄位。若顯示 Apple 晶片，請在macOS 下載區選擇 Apple Silicon 安裝檔；若顯示 Intel，則選擇 Intel 安裝檔。兩者對應不同的處理器架構，不應只憑電腦外觀判斷。即使已安裝轉譯環境，也不代表應優先使用另一種架構；原生架構較容易確認核心、輔助元件與權限是否正常。

開啟下載的磁碟映像檔，將 v2rayN 拖曳至「應用程式」，再從該資料夾啟動。請勿長期直接從磁碟映像檔執行，以免影響升級、設定儲存與輔助元件的定位。若系統提示無法開啟，先確認檔案來自下載頁指定的入口、架構相符且已下載完成，再查看「系統設定 → 隱私權與安全性」中的具體提示。不要為了啟動單一應用程式而關閉整體安全防護。

完成匯入並確認系統代理

初次開啟後，進入訂閱群組管理，新增用途明確的群組，將完整訂閱連結貼至位址欄位，儲存後更新訂閱。若更新選項可選擇是否透過代理，而目前尚無可用連線，請先嘗試不透過代理更新；若該位址必須經由代理才能存取，則需要先有另一條可用的連線。更新成功後，確認群組中出現可選伺服器，再將目標設為目前使用項目。

啟動核心後，在系統代理選單選擇「自動設定系統代理」。此處的「自動設定」是用戶端提供的設定操作，不應直接視為瀏覽器中的代理自動設定指令碼模式。前往「系統設定 → 網路」，開啟目前使用的網路服務，在詳細資訊的代理區域確認代理主機與連接埠符合用戶端的本機監聽設定。無線與有線連線屬於不同服務；切換網路後，請重新確認實際生效的介面。

先用瀏覽器測試，再檢查其他應用程式。瀏覽器擴充功能、應用程式內建的代理選項，以及開發工具的環境變數，都可能覆寫系統設定。若瀏覽器正常，但某個應用程式仍直接連線，請先確認該應用程式是否會讀取系統代理，不要立即更換伺服器。測試結束時請使用「清除系統代理」；「不變更系統代理」通常表示用戶端不再主動修改設定，不能當作清除操作。

TUN 與休眠後的復原順序

確認系統代理可正常使用後，再考慮啟用 Tun。不同安裝方式與執行環境可能需要輔助服務、網路延伸功能或管理者授權。請依照用戶端與系統提示完成必要授權，再確認核心已成功建立虛擬介面。若授權視窗反覆出現，請勿連續點選重試；先退出多餘的執行個體，查看記錄檔中的權限、服務安裝或介面建立錯誤，再依照相應流程處理。公司裝置上的管理限制應由管理者確認。

闔上螢幕進入休眠、喚醒，或從無線網路切換至有線網路後若連線失效，請先關閉 TUN，確認一般網路恢復，再重新啟動核心並啟用流量接管。若系統代理仍指向本機位址，但用戶端已關閉，網頁可能會全部無法開啟；請重新啟動用戶端清除代理，或在對應的網路服務中還原先前記錄的設定。用戶端關閉時，請勿保留指向無服務監聽連接埠的代理項目。

升級前先備份訂閱群組與自訂規則，退出舊的執行個體後再替換應用程式。若系統提示應用程式仍在使用中，請檢查選單列圖示與背景處理程序；新舊執行個體同時運作時，不要繼續匯入設定。替換完成後，先測試一般代理，再測試 TUN 與自動啟動。如此可區分升級後的設定相容性問題與系統授權問題，而不是將所有連線失敗都歸咎於安裝檔。

Windows：桌面版、WPF 與系統代理

依介面與相容性需求選擇版本

Windows 下載區提供 v2rayN 桌面版與經典 WPF 版。桌面版採用新一代跨平台介面，WPF 版則保留經典操作方式。初次安裝可優先評估桌面版；若已有穩定的設定與操作流程，請先備份，再決定是否遷移。兩者的介面與設定儲存位置可能不同，不要預期安裝後會自動共用所有資料，也不要將兩個程式視為互不影響的代理而同時啟動。

安裝前請確認作業系統與處理器架構符合下載項目的說明，並確保使用者資料夾有足夠的寫入權限。依照安裝精靈完成安裝；若使用需要解壓縮的發行版本，請完整解壓縮後再啟動，不要直接從壓縮軟體的預覽視窗執行。若出現缺少執行環境的提示，請依提示確認相依元件與系統支援狀況；不要將來源不明的單一動態程式庫複製到程式資料夾中嘗試修復。

匯入訂閱並確認本機連接埠

啟動 v2rayN 後建立訂閱群組，輸入訂閱位址、儲存並更新。成功取得訂閱內容，只代表設定入口可存取；仍須選擇使用中的伺服器並啟動核心。手動匯入分享連結時，先確認協定、位址、連接埠與傳輸欄位完整，再確認已儲存至預期的群組。若已有舊設定，請先用名稱明確的群組測試，避免預設群組與訂閱群組中出現同名項目而選錯。

在設定中查看本機監聽位址，以及 HTTP 或混合代理連接埠。連接埠應對應用戶端實際啟用的入站設定，不要照抄其他教學常見的數值。若只供本機使用，請維持回送位址監聽；若啟用允許區域網路連線，還需考量驗證、防火牆與可存取範圍。發現連接埠遭占用時，先找出占用的程式，再決定停止舊執行個體或更換連接埠；修改後也要同步更新所有手動填入該連接埠的應用程式。

在系統代理選單啟用自動設定後，開啟「設定 → 網路和網際網路 → 代理」，確認手動代理設定與用戶端一致。若瀏覽器啟用了獨立代理擴充功能，請先暫時停用再測試。部分應用程式會快取網路設定，切換後可能需要重新啟動。系統設定中出現本機代理位址，不代表核心正在監聽；還須確認用戶端記錄檔沒有啟動失敗或連接埠繫結錯誤。

TUN、權限與背景執行個體

啟用 TUN 前，先閱讀目前用戶端對服務或管理者權限的提示。部分執行方式需要提高權限或安裝輔助服務，但測試一般系統代理時，不應因此一律改用高權限執行。依需求授權後，檢查虛擬網卡建立、路由寫入與 DNS 接管是否完成。若安全軟體封鎖網路元件，請先查看封鎖詳細資訊與檔案位置，再依組織政策處理；不要關閉整套防護來排除問題。

Windows 上常見的混淆來源包括多個系統匣執行個體、開機啟動項目與舊服務。關閉主視窗不一定會結束程式，請透過系統匣選單中的結束操作。若重新開機後代理設定又被改寫，請檢查啟動應用程式與既有網路工具，確認是哪個程式在登入時接管系統代理。遷移用戶端時，先退出舊程式並停止其相關接管，再啟動新程式；否則兩個執行個體可能輪流寫入系統設定，導致連線時好時壞。

若瀏覽器可正常使用，但終端機程式無法連線，請檢查該程式是否使用系統代理，或是否設定了自己的代理環境變數。確認所需協定與監聽類型後，再手動填入位址。若所有網頁都無法開啟，請逐一檢查本機連接埠、核心啟動狀態與系統代理。更完整的瀏覽器排查流程請參閱已連線但無法開啟網頁：排查清單，不必一開始就重新安裝整個用戶端。

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

確認發行版與處理器架構

Linux 安裝檔須符合兩項條件：發行版使用的套件格式，以及裝置的處理器架構。Debian、Ubuntu 等系統通常選擇 deb，Fedora 等系統通常選擇 rpm；實際仍應依發行版的套件管理方式為準。常見個人電腦多為 x64，部分開發板與桌上型裝置則採用 arm64。前往Linux 下載區後，先確認套件格式，再確認架構，不要將套件格式誤認為處理器類型。

可在終端機執行下列兩個唯讀指令查看資訊。輸出中的 x86_64通常對應 x64，aarch64通常對應 arm64；發行版資訊則可用來判斷套件管理體系。這些指令只會檢查本機，不會安裝或修改用戶端。若裝置採用其他架構，不要強行安裝不相符的套件，請先確認下載頁是否提供適用於該環境的版本。

uname -m
cat /etc/os-release

優先使用發行版的軟體安裝程式開啟下載的套件，查看相依項目與安裝提示後再完成操作。遇到相依項目缺少時，應交由系統套件管理器處理，不要從其他發行版複製程式庫檔案。安裝後從應用程式選單啟動 v2rayN，確認一般使用者可以儲存設定。若先前曾以高權限啟動用戶端，使用者設定目錄可能有檔案擁有權問題；請先確認具體目錄與權限，再進行修復，不要遞迴修改整個家目錄的權限。

匯入設定與桌面代理的差異

在訂閱群組中儲存連結並更新，選擇伺服器後啟動核心，先確認本機監聽正常。Linux 桌面環境的系統代理實作並不一致：有些用戶端可以寫入桌面代理設定，有些環境則需要在系統網路面板手動填寫。GNOME、KDE 與不同應用程式讀取設定的方式也可能不同。即使看到用戶端顯示已設定代理，仍應前往目前桌面的網路設定，確認實際位址與連接埠。

命令列程式通常不會因桌面代理已啟用就自動使用代理。它們可能透過環境變數、命令列參數或各自的設定檔管理代理。請先查看目標程式的代理說明，再選擇與用戶端監聽類型相符的設定。HTTP 代理與 SOCKS 代理不能只更換名稱就共用所有語法；遠端解析網域名稱的行為也會因程式而異。測試期間不要將代理變數寫入多個啟動檔案，否則之後很難判斷舊連接埠是從何處繼承而來。

最小權限與虛擬介面檢查

TUN 需要核心虛擬網路介面與適當的網路管理權限，圖形程式可以啟動，不代表已具備這些條件。請使用用戶端支援的方式設定服務或授權，避免長期以高權限執行整個桌面程式。若記錄檔顯示介面不存在、操作不允許或寫入路由失敗，先確認系統是否提供 TUN 裝置，以及容器或受限工作階段是否允許相關操作，再判斷是權限問題還是核心啟動問題。

可使用下列唯讀指令查看位址與路由。比較啟用前後的變化時，請留意新增介面與預設路由的方向，不要只憑介面名稱判斷連線是否成功。若同時執行其他虛擬網路工具，路由優先順序可能互相影響。請先只保留一種接管方式，確認一般代理可用後再啟用 TUN；關閉後也要確認系統路由已復原，而不只是查看用戶端的開關狀態。

ip address show
ip route show

若 Linux 上直連正常、代理失敗，先檢查本機監聽與核心記錄檔；若只有網域名稱連線失敗，再檢查 DNS 解析路徑。系統 DNS 可能分別由網路管理服務、解析服務或連線設定維護，不建議直接覆寫解析檔碰運氣。升級時請保留使用者設定備份，依照套件管理器的流程替換程式，再逐一確認桌面代理、背景服務與自動啟動，避免舊服務仍指向已替換的程式路徑。

Android：v2rayNG 與 v2flyNG 設定

先選擇用戶端，再挑選安裝檔架構

Android 建議優先使用 v2rayNG，採用 Xray 核心；若需要相容 V2Fly 核心的方案，再評估 v2flyNG。兩款用戶端不應同時接管系統網路，請先確認資料要求的協定與核心功能。前往Android 下載區選擇對應版本。較新的主流手機通常適用 arm64，但仍應以系統架構為準；若不確定，可考慮通用版，不要只根據處理器的行銷名稱判斷系統實際執行的架構。

開啟安裝檔時，系統可能要求允許目前使用的瀏覽器或檔案管理程式安裝應用程式。請只授權本次使用的來源，安裝完成後可視需要撤銷權限。若無法安裝，先檢查系統需求、安裝檔是否已完整下載、架構是否相符，以及是否已安裝同名但簽章不同的應用程式。升級失敗時不要立即解除安裝舊版；請先備份設定，因為解除安裝通常也會一併移除應用程式的私人資料。

訂閱、分享連結與使用中的設定

開啟用戶端的訂閱設定或群組管理，新增訂閱名稱與完整位址，儲存後返回主畫面更新。選單名稱可能因介面版本而略有差異，但操作順序一致：先儲存來源，再取得內容，最後選擇使用中的設定。單一分享連結可透過相應的剪貼簿匯入功能新增；匯入 QR Code 前請確認來源可信，不要將含有驗證資訊的 QR Code 上傳至公開辨識服務。

匯入完成後開啟設定詳細資料，確認協定、遠端位址、連接埠及傳輸安全參數。訂閱匯入的項目通常由服務提供者維護，本機手動修改可能在更新後遺失。若要暫時排錯，先複製成獨立設定並記錄差異。選取目標項目後再點選連線，以免誤用上次保留的使用中項目。清單有內容且連線按鈕可按，仍不能取代實際檢查核心是否成功啟動。

VPN 授權與依應用程式代理

初次連線時，Android 會顯示建立 VPN 連線的系統授權提示。允許後，用戶端才能透過系統提供的虛擬網路介面接收流量。此處的 VPN 是接管網路的系統機制，不代表遠端服務一定使用傳統 VPN 協定。連線期間請留意系統狀態與用戶端記錄檔，確認服務沒有啟動後立即退出。若已有其他 VPN 應用程式連線，請先停止原有連線再測試。

依應用程式代理通常可選擇只接管指定應用程式，或排除指定應用程式；這兩種清單的意義正好相反。儲存前請先確認目前使用的模式，再以一個目標應用程式測試。不要只因應用程式名稱出現在清單中，就判定它一定會使用代理。工作資料中的應用程式、獨立使用者空間及部分系統元件可能處於不同環境；如有管理政策，請遵循裝置授權範圍，不要反覆切換權限來規避組織限制。

路由模式仍會決定流量進入用戶端後的出口；依應用程式代理則決定哪些應用程式會先進入用戶端，兩者屬於不同層級。若瀏覽器已被排除，切換全域路由也不會讓它自動進入代理。排查時先暫時採用容易理解的接管範圍，再確認路由；問題確認後再逐步恢復依應用程式分流，避免同時維護兩套意義不明的允許清單與排除規則。

背景執行限制與網路切換

若螢幕關閉後經常中斷，請檢查應用程式的電池最佳化、背景活動與廠牌省電限制。只對需要持續連線的用戶端進行必要調整，再觀察鎖定螢幕與喚醒後的狀況，不必全面關閉省電功能。無線網路與行動網路切換後，原有連線可能需要重新建立；先確認手機本身可連線，再重新連線至服務。訂閱更新與連線服務也應分開判斷，背景更新失敗不一定表示目前的伺服器已無法使用。

從 v2rayNG 遷移至 v2flyNG 或反向遷移時，建議重新匯入同一份有效訂閱，再逐項還原路由、DNS 與依應用程式設定；不要直接覆寫彼此的資料目錄。需要協助時，請提供已去識別化的記錄檔、系統環境與失敗步驟，並隱藏訂閱、驗證資訊及完整 QR Code。協定參數的差異可繼續參閱四種代理協定比較；更換用戶端並不能解決所有遠端問題。

訂閱管理：更新、遷移與設定備份

分開管理訂閱來源與伺服器項目

訂閱群組儲存來源位址與更新方式，伺服器清單則儲存取得的連線資料。請分開理解兩者：刪除伺服器項目，不一定會刪除訂閱來源；再次更新時，該項目也可能重新出現。建議依用途或來源建立群組，並以工作、測試或備用等實際用途命名，不必將完整位址放入群組名稱。群組越清楚，更新失敗時越容易找出問題來源。

首次匯入訂閱時，貼上連結後請檢查前後空格、換行與截斷部分。通訊軟體可能會折疊顯示長連結，複製畫面上可見的文字不一定等於複製完整位址。訂閱內容也可能需要使用服務提供者指定的格式，或符合用戶端支援範圍。若清單空白，先確認取得的是設定內容、登入頁面還是錯誤訊息，不要連續重複匯入。若位址已失效，應請服務提供者更新來源，而非隨意修改字元嘗試復原。

選擇更新方式與自動更新間隔

「更新訂閱（不透過代理）」適用於目前網路可直接存取來源的情況，也能避免「連線依賴訂閱、更新訂閱又依賴連線」的循環。透過代理更新則要求代理已可正常運作。兩者差異在於請求經過的路徑，而不是訂閱內容格式。排查時各測試一次並查看錯誤，再固定使用可行的方式；若完全沒有可用伺服器，不要只是不斷選擇透過代理更新。

自動更新間隔應配合來源變更頻率、使用習慣與請求限制。來源穩定時不必過於頻繁地取得更新；行動裝置也需考量流量與背景執行限制。若介面以分鐘為單位，請依實際單位輸入，避免直接將小時數當成分鐘。設定後先手動更新成功，再等候一次自動執行。裝置休眠、應用程式遭系統停止或網路受限時，自動工作可能延後，並不保證會準時執行。

更新訂閱可能移除已撤下的項目，也可能覆寫由來源管理的部分參數。若需保留暫用設定，請先複製到獨立群組，再修改別名、路由關聯或傳輸設定。不要將伺服器項目的列號當成長期識別方式，更新後排序可能改變。若使用自動選取或群組策略，更新後請確認使用中的伺服器仍符合預期，再檢查一般連線與路由行為；不要只看到更新成功提示就結束檢查。

備份範圍與敏感資訊處理

備份至少應包含訂閱來源、獨立設定、自訂路由、DNS、監聽連接埠及依應用程式設定。優先使用用戶端提供的匯出或備份功能；若需複製資料檔案，請先完全退出用戶端，並確認檔案位置與目前執行的執行個體相符。只複製程式檔案通常無法保留使用者設定；反過來，完整複製使用者資料也可能帶入不適用於另一台裝置的路徑、服務狀態與介面名稱。

跨平台遷移時，建議使用訂閱連結與通用分享格式；系統代理、TUN 服務與程式路徑則應在目標裝置上重新設定。能匯入同一份設定，不代表另一個核心能接受所有擴充欄位。請先還原一條基本連線並完成測試，再還原路由與 DNS。若來源裝置有大量自訂規則，另存文字說明會比直接覆寫整套設定更容易發現平台差異與不相容欄位。

更換訂閱後，請停用舊來源的自動更新，再清除不再需要的項目。若連結曾公開，只刪除本機記錄並不能撤銷他人的存取權，還需要在來源端更換或撤銷連結。更新發生錯誤時，可參閱訂閱更新失敗與間隔設定，繼續檢查網路路徑、時間、憑證與回應內容；先找出失敗環節，再考慮重新匯入。

路由與 DNS：接管流量後的出口判斷

先釐清系統代理、TUN 與路由模式

系統代理與 TUN 負責將流量送進用戶端，路由規則則決定流量進入後的去向。選擇全域路由，通常代表讓已接管的流量透過指定代理出口，不會自動涵蓋所有應用程式；選擇繞過中國大陸等分流模式，則會依網域、位址或規則集決定直連或代理。判斷某個應用程式為何未依預期連線時，先確認它是否進入用戶端，再查看它符合哪條規則。

多數路由系統會依序比對規則；前方範圍較廣的規則可能遮蔽後方較精確的規則。調整時，先設定明確的網域、應用程式或目標範圍，再加入預設策略，並確認目前使用的核心確實支援這些欄位。不要混用不同核心的設定語法。用戶端提供的預設路由可作為基準；自訂前先匯出原設定，並記錄新增規則的位置與用途，方便復原。

了解實際規則片段的使用情境

以下是 Xray/V2Ray 路由物件中的規則片段，用於將符合條件的網域交由名為 direct 的出口處理。這不是完整的用戶端設定，必須放在相應的 routing.rules 中，且需已有同名出口與可用的網域規則資料。若圖形化用戶端提供規則編輯器，請優先透過介面輸入；不要用此片段覆寫整份執行設定，也不要假設所有核心都使用相同欄位。

{
  "type": "field",
  "domain": [
    "geosite:cn"
  ],
  "outboundTag": "direct"
}

type 表示規則類型，domain 限定網域比對條件，outboundTag 指定出口標籤。標籤只是設定內部的參照名稱，拼字必須與既有出口一致。規則資料缺少、標籤不存在，或規則被前面的項目遮蔽，都可能導致設定未依預期生效。修改後先確認核心是否接受設定，再查看目標請求的比對記錄；不要只根據儲存按鈕是否成功判斷規則有效。

DNS 解析路徑與網域比對

DNS 會將網域名稱轉換為位址，而代理連線還涉及應用程式、系統與核心各自的解析方式。瀏覽器可能啟用自己的加密 DNS，系統也可能快取舊結果；即使用戶端設定遠端 DNS，未進入用戶端的請求仍可能使用其他解析器。排查前請釐清整個路徑：由誰發出查詢、查詢經過哪個出口，以及由誰使用解析結果建立連線。只更換 DNS 位址，通常不足以解決所有解析問題。

直連 DNS 與遠端 DNS 應配合路由設計。預計直連的網域需要可用的解析路徑；預計透過代理連線的目標，也應避免解析請求依賴尚未建立的連線。DoH 可加密查詢傳輸，但服務位址本身仍須可連線，也可能需要先解析服務位址。不要將「使用 DoH」直接等同於解析結果一定正確，請一併確認逾時、憑證與回應結果。

FakeDNS 會使用合成位址，協助核心保留網域資訊，適用於特定流量接管方案，但位址對應、路由與 DNS 流程必須協同運作。若應用程式取得合成位址後繞過核心連線，連線可能失敗。一般系統代理已能滿足需求時，不必為了功能完整而啟用 FakeDNS。測試前先儲存目前的 DNS 設定，確認核心支援與接管範圍，再檢查直連應用程式、區域網路服務及退出後的復原狀況。

至少測試一個明確設定為直連的目標，以及一個明確設定為代理的目標，並搭配記錄檔確認實際出口。若受到快取干擾，請依應用程式或系統提供的方式清除快取，重新連線後再測試；不要同時重設所有網路設定。欄位用途與解析方式的詳細說明，請參閱v2rayN DNS 分流解析說明；先讓規則保持簡單易懂，再逐步增加細緻策略。

常見設定問題：依失敗層級逐項排查

分開處理啟動失敗與連線失敗

先確認問題發生在哪個層級：程式無法開啟、核心未啟動、本機連接埠無法連線、遠端連線失敗，還是只有網頁無法開啟。程式無法啟動時，優先確認架構、系統需求、執行相依項目與設定目錄權限。核心啟動報錯時，先檢查設定解析、可執行元件與連接埠繫結，不要先更換訂閱。只有本機運作正常後，遠端逾時與驗證問題才是主要排查方向。

開啟記錄檔後，重新執行一次失敗操作，記下前後少量錯誤訊息與發生時間。單一逾時訊息不一定是根本原因，請檢查之前是否已有 DNS 失敗、連線遭拒或不支援設定。分享記錄檔前，請隱藏位址、驗證資訊與訂閱內容，但保留錯誤類別、協定名稱與呼叫順序。公開整份含有憑證的設定，不但無助於定位問題，也會增加資料外洩風險。

連線逾時、驗證與傳輸參數

遠端連線逾時時，先確認目前網路正常、裝置時間正確，並檢查位址與連接埠是否有複製錯誤。若所有設定都失敗，優先檢查本機網路、核心啟動狀態與流量接管方式；若只有一項失敗，再確認該伺服器是否仍有效及參數是否正確。測速結果也會受測試方法與目標影響，單一測試失敗不代表所有實際流量都無法通過，請再進行一次實際連線測試。

驗證失敗時，通常需要確認協定要求的識別資訊或密碼；TLS 相關錯誤則應檢查伺服器名稱、憑證鏈、系統時間與傳輸參數。連線位址可能與用來驗證的伺服器名稱不同，不要為了減少欄位而任意清空。傳輸路徑、Host 與其他擴充參數也必須符合伺服器端設定。不要透過略過憑證驗證來掩蓋設定錯誤，請先確認資料是否過期或伺服器名稱是否填錯。

更換核心後若發生連線問題，請確認目標核心是否支援該協定與擴充功能，以及訂閱轉換時是否遺漏欄位。Xray 與 V2Fly 並非所有功能都能直接互換。請先還原至原本可用的核心與基本設定，再逐步確認差異。若需要更完整的遠端排查順序，請參閱節點逾時與連線失敗排查；不要只是不斷更換用戶端，卻繼續使用同一份錯誤參數。

常見問答：復原網路並縮小問題範圍

最後還原一份易於理解的設定

排查完成後，移除暫時測試項目，還原確實需要的自動啟動與分流規則，並再次確認退出用戶端後一般網路正常。儲存一份已驗證可用的設定備份，並附上作業系統、架構、代理模式與重要變更說明。下次發生異常時，先比對近期變更，不要一開始就重新安裝。完整操作流程請參閱快速入門教學；需要更換平台安裝檔時，再前往下載頁確認。