安裝 · 訂閱 · 流量接管 · 分流

V2Ray 全平台安裝設定指南

依作業系統查找操作步驟,依連線環節排查問題。桌面版以 v2rayN 為主,Android 說明 v2rayNG 與 v2flyNG 的設定差異。

本頁是依作業系統整理的查閱手冊,適合在安裝受阻、移轉裝置、調整路由或排查問題時逐章閱讀。初次使用可先完成入門指南的快速上手流程,再回來了解各平台的權限與參數。用戶端選單名稱可能隨版本調整,以下優先使用設定項目名稱與操作目的,不依賴固定的圖示位置。

通用準備:先釐清設定與流量入口

用戶端、核心與訂閱各自負責什麼

圖形用戶端負責顯示伺服器、管理訂閱、儲存設定,並呼叫核心建立連線。核心負責實際處理協定、傳輸與路由。訂閱則是取得伺服器設定的方式之一,本質上是可傳回設定內容的網址。這三者彼此相關,但不能互相取代。下載用戶端不會自動取得可用伺服器;匯入訂閱也不代表所有應用程式都會自動使用代理。開始前請先備妥有效設定,並確認哪些應用程式需要使用。

桌面系統建議依本手冊使用 v2rayN。Android 一般可使用採用 Xray 核心的 v2rayNG;需要相應的 V2Fly 設定時,再考慮 v2flyNG。協定名稱相同,不代表所有擴充欄位都通用。尤其是 REALITY、特定流控與傳輸選項,請確認用戶端所附核心是否支援。伺服器提供的位址、連接埠、使用者識別碼與安全參數需成套使用,勿混用不同伺服器設定中的欄位。

確認作業系統、處理器與安裝套件類型

先在系統資訊中確認處理器架構,再前往用戶端下載頁選擇安裝套件。x64 通常適用於常見的 Intel、AMD 桌上型處理器;arm64 則適用於 ARM 架構裝置,但不要只憑品牌或外觀判斷。macOS 還需區分 Apple Silicon 與 Intel。Linux 除了確認架構,也要判斷發行版使用 deb 或 rpm。Android 若不確定架構,可選通用套件;代價通常是檔案較大,而非連線能力更強。

安裝前請記下舊用戶端的資料位置、訂閱群組名稱與自訂規則。升級和移轉並不相同:升級通常沿用原有資料,移轉則可能建立全新的設定目錄。需要備份時,優先使用用戶端提供的匯出功能,並將匯出內容存放在自己可控的位置。訂閱網址、使用者識別碼及設定 QR code 都可能包含存取憑證,請勿當作一般截圖分享到公開討論區,也不要直接貼到線上格式化工具。

準備項目確認事項缺少時可能出現的狀況
系統資訊平台、架構與套件類型安裝程式無法啟動或提示格式不相容
設定來源有效的訂閱網址或完整的單筆設定用戶端能開啟,但沒有可選的伺服器
連線參數協定、連接埠、傳輸與安全欄位伺服器已列出,但無法建立連線
流量入口系統代理、應用程式代理或 TUN核心正在執行,但目標應用程式仍直接連線

建立最小可驗證設定

第一次測試時,只保留一個用戶端執行,選定一台明確可用的伺服器,暫時不要加入自訂 DNS、複雜分流或多種流量接管工具。裝置若同時執行其他代理或虛擬網路軟體,連接埠、路由與 DNS 可能互相干擾。請先結束這些程式,而不只是關閉視窗。也要確認系統日期、時區與自動校時正常;時間明顯錯誤可能影響安全連線驗證,讓問題看起來像是伺服器故障。

連線流程可分成四個步驟確認:設定是否成功匯入、核心是否正常啟動、應用程式是否將請求交給用戶端,以及用戶端是否依規則完成連線。每次只變更其中一個環節,並記錄變更前後的狀況。例如,訂閱清單已顯示伺服器,就先別反覆刪除群組;瀏覽器能連線而其他應用程式不行時,應先檢查流量入口,不要立刻更換協定。如此逐步排查,問題範圍會愈來愈明確,也能保留原本正常的部分。

Windows:安裝 v2rayN 與設定系統代理

選擇桌面版或傳統 WPF 版

前往Windows 下載頁,選擇 v2rayN。桌面版採用跨平台介面,傳統 WPF 版則保留 Windows 風格的操作方式。兩者的介面配置與資料存放方式可能不同,請勿把某一版本的畫面位置當成另一版本的固定入口。初次安裝時選定一個版本並完成設定即可;若已習慣某個介面,也可繼續使用對應版本。兩個版本都需要相符的執行環境與核心檔案,請以安裝提示為準。

執行安裝程式後,依照精靈選擇安裝位置,再從開始功能表或應用程式清單啟動。若安裝時提示缺少執行元件,先確認元件名稱與架構,再透過系統認可的管道安裝;勿從不明的快顯視窗下載同名檔案。啟動後若看不到主視窗,先檢查工作列通知區域,用戶端可能仍在背景執行。重複啟動會增加後續判斷連接埠占用問題的難度,請先確認是否已有執行中的執行個體。

一般使用系統代理通常不需要一直以系統管理員身分執行。只有部分網路接管、虛擬網卡或系統層級操作可能需要額外權限。遇到安全軟體警示時,先確認警示對象是安裝程式、圖形用戶端還是核心程序,再檢查檔案所在位置。不要為了啟動程式而長期關閉系統防護。若程式一啟動就關閉,請保存錯誤訊息,並檢查安裝是否完成、資料目錄是否可寫入,以及安全軟體是否隔離了必要檔案。

新增訂閱、更新並選擇伺服器

開啟訂閱群組管理,新增群組,在別名欄輸入容易辨識的名稱,並將完整訂閱網址貼到網址欄。別名只是本機標籤,不會影響連線。網址中的查詢參數也是網址的一部分,複製時請勿漏掉問號後的內容,也別帶入通訊軟體自動加上的引號或換行。儲存群組後更新訂閱,等清單出現實際項目,再選擇要使用的伺服器並設為目前設定。

第一次更新時,建議使用目前網路可行的方式。部分介面提供透過代理更新與直接更新兩種選項;若尚未建立可用的代理,透過代理更新可能形成循環依賴。網址在瀏覽器中顯示文字,不代表用戶端一定能解析;內容也可能是登入頁面、錯誤頁面或其他格式。更新後清單仍為空白時,先檢查訂閱相關錯誤,不要在伺服器編輯視窗中手動填入不明欄位。

若曾手動調整群組中的項目,更新時可能會重建訂閱項目,因此不要假設所有本機修改都會保留。需要長期保留的特殊伺服器,可依用戶端支援的方式複製到獨立管理的項目,再確認不會被訂閱更新覆蓋。完成匯入後,先確認目前選取的伺服器確實來自目標群組。群組清單中有許多項目,不代表目前使用的伺服器已切換;實際運作的仍可能是上次儲存的設定。

啟用系統代理,再決定是否使用 TUN

在系統代理選單中選擇「自動設定系統代理」,讓遵循 Windows 代理設定的應用程式將請求傳送至本機用戶端。接著重新開啟瀏覽器頁面測試。路由模式先選用戶端提供的一般預設,例如「繞過中國大陸」,不要同時匯入來源不明的複雜規則。若某個應用程式沒有變化,先確認它是否使用系統代理;遊戲、命令列程式及部分內建網路元件可能使用自己的連線方式。

系統代理:自動設定系統代理
路由:繞過中國大陸
目前伺服器:從已匯入的設定中選擇
TUN:依應用程式需求另行啟用
白話說明

系統代理負責將遵循系統設定的應用程式接入,路由則決定這些請求要傳往何處。這兩者都不是伺服器本身的開關。先讓瀏覽器透過系統代理完成一次連線,再嘗試 TUN,可避免把權限、虛擬網卡與連線參數問題混在一起。

只有在確實需要接管不遵循系統代理的應用程式時,才啟用 TUN 並依提示授權。若啟用後整個系統都無法解析網域名稱,先關閉 TUN,確認一般系統代理仍可使用,再檢查虛擬網卡、DNS 與其他網路軟體是否衝突。結束用戶端後,若瀏覽器仍無法連線,請檢查 Windows 代理設定是否殘留本機位址。用戶端的「清除系統代理」可撤銷由它設定的入口,不會刪除訂閱;「不變更系統代理」則不會清除先前留下的設定。

macOS:晶片選擇、權限與網路接管

依晶片選擇版本並處理首次開啟提示

先開啟「關於這台 Mac」查看晶片資訊,再前往macOS 下載頁選擇 v2rayN。Apple Silicon 對應 arm64,Intel 對應 x64。開啟磁碟映像檔後,將應用程式複製到「應用程式」資料夾,再從該資料夾啟動。不要長期直接從已掛載的磁碟映像檔執行,否則更新、權限記錄與啟動路徑容易不一致。安裝完成後可退出磁碟映像檔,後續應使用「應用程式」資料夾中的副本。

首次啟動若遭系統安全機制阻擋,先確認下載來源與系統顯示的應用程式名稱。確認無誤後,依目前系統提供的流程,在「系統設定」的「隱私權與安全性」中查看與此次開啟操作相關的提示,再選擇允許開啟。不同系統版本的文字與按鈕位置可能不同,不要為了略過單一應用程式的提示而關閉整套系統安全機制。介面操作可參考macOS 首次開啟與權限說明。

應用程式能開啟,不代表核心也能正常執行。圖形視窗出現後,仍應檢查核心啟動結果及資料目錄的寫入權限。將應用程式從下載資料夾移到「應用程式」後,若系統再次要求網路相關權限,請確認提示的對象再處理,不要假設先前的授權一定適用於所有新路徑。若重複要求授權或啟動異常,可先正常結束應用程式,再從固定安裝位置重新開啟,避免同時存在多個副本。

匯入訂閱並確認目前設定

在訂閱群組中新增項目,填入別名與完整網址,儲存後執行更新。訂閱網址通常包含存取權杖,從剪貼簿貼上後,請確認開頭的通訊協定與結尾參數完整無缺。若匯入的是單筆設定分享連結,請使用對應的匯入入口,不要把它當成訂閱網址填入。兩種匯入方式產生的項目可能都會出現在伺服器清單中,但後續更新方式不同;不能只因清單顯示相似就混用入口。

更新完成後,選擇一台伺服器作為目前設定,再啟動連線。若同一份訂閱曾在其他裝置上正常使用,可拿來比較,但這不代表能排除平台差異:本機核心支援、系統時間、網路環境與 DNS 都可能不同。先保留訂閱中的原始傳輸與安全欄位,不要因為看不懂某個名稱就改成預設值。尤其是伺服器名稱指示、傳輸路徑與公開金鑰相關選項,修改後可能直接造成握手失敗。

系統代理作用於網路服務,TUN 則需要額外權限

使用一般瀏覽器時,先在 v2rayN 中啟用自動設定系統代理,再確認目前使用的網路服務是否已正確設定。macOS 的代理設定與網路服務有關,Wi-Fi、有線網路及其他連線方式可能各有不同設定。切換網路後若出現「昨天可以用,今天卻不行」的情況,應檢查目前啟用的服務,而非只查看舊連線的代理頁面。應用程式要求修改網路設定時,請依系統提示完成必要授權。

若瀏覽器正常,但某個應用程式始終直接連線,先確認該應用程式是否有自己的代理選項。需要接管更廣泛的 IP 流量時,可考慮使用 TUN,但可能需要額外網路權限或輔助元件,請以用戶端實際提示為準。不要把授權視窗中的系統帳號密碼當成訂閱密碼,兩者用途完全不同。啟用後若區域網路裝置連線異常,請檢查是否有略過本機網段,以及其他虛擬網路服務是否也在改寫路由。

結束前請關閉連線,並清除由用戶端設定的系統代理,再確認一般網路是否恢復。若用戶端意外結束,而系統仍指向已停止監聽的本機連接埠,瀏覽器就會顯示無法連線至代理伺服器。此時可在系統網路設定中移除殘留代理,不必刪除訂閱或重新安裝。移轉至新電腦時,可重新匯入訂閱,但系統授權必須在新裝置上重新完成;舊裝置的資料備份不能取代新的系統權限確認。

Android:v2rayNG 與 v2flyNG 設定

選擇用戶端與安裝套件架構

前往Android 下載頁,一般使用建議選擇 v2rayNG;需要相應的 V2Fly 設定時再選 v2flyNG。兩者不是同一個應用程式的不同外觀,核心能力與部分設定也有差異。遇到特定協定擴充時,應先確認支援範圍,而不是在兩個應用程式間反覆匯入碰運氣。僅從伺服器名稱中的協定縮寫,無法判斷所有參數是否相容,請查看實際設定內容。

確認裝置架構後,選擇 arm64 或通用套件。近年的主流手機多採用 arm64,但處理器支援某種架構,不代表系統一定提供對應的應用程式執行環境;請以系統資訊為準。安裝程式若提示格式不相容,可回到下載頁選擇通用套件,不要反覆開啟同一個安裝檔。若系統要求授權目前使用的檔案管理器或瀏覽器安裝應用程式,只需針對正在使用的來源授權;安裝完成後,可依個人安全習慣撤銷該來源的權限。

若裝置已安裝同名應用程式,升級失敗可能與簽章來源、架構或系統限制有關。不要一開始就解除安裝,因為解除安裝通常會移除本機訂閱與自訂設定。請先確認原應用程式的來源,匯出需要保留的設定,並記錄訂閱群組。兩個用戶端可以分別安裝,但不應同時嘗試接管同一裝置的 VPN 通道。測試前請停止另一個用戶端,也檢查工作設定檔中的網路工具是否仍在執行。

匯入訂閱並啟動 VPN 模式

在用戶端的訂閱管理中新增群組,填入名稱與完整網址,儲存後回到主畫面更新訂閱。若來源提供 QR code,可使用用戶端的掃描入口,但要先確認 QR code 代表單筆設定還是訂閱網址。複製內容後,請依內容形式選擇相符的匯入入口。QR code 圖片與訂閱網址同樣敏感;拍攝設定畫面時,請遮住這些內容,不要只遮住伺服器名稱。

更新取得項目後,點選要使用的伺服器,再點選連線。首次啟動時通常會出現 Android 的 VPN 連線要求,需要使用者明確允許。此要求用於建立本機流量接管介面,不代表用戶端提供遠端伺服器,也不是訂閱購買提示。授權後若連線仍立即停止,請查看用戶端記錄或錯誤訊息,判斷是設定解析失敗、核心啟動失敗,還是連線建立後才發生網路錯誤。

若要讓其他應用程式的流量進入用戶端,請使用 VPN 模式;僅提供本機代理監聽的模式則要求應用程式自行設定代理,適用於用途明確的情境。裝置狀態列出現 VPN 圖示,只能表示系統通道已建立,不能證明特定目標已連通。完成連線後,請實際開啟目標應用程式測試,再回到用戶端查看相應記錄。不要把「連線按鈕已變色」或「系統圖示已出現」視為完整的驗證結果。

設定應用程式分流、區域網路與背景限制

若應用程式分流使用允許清單,只有清單中的應用程式會納入接管範圍;排除清單則相反,被勾選的應用程式會略過代理。修改前請先看清目前的模式,避免把「要代理的應用程式」加入排除清單。調整後可能需要重新建立 VPN 連線才會生效。瀏覽器可以連線但某個應用程式不行時,先檢查清單與該應用程式的網路權限,再確認伺服器是否支援它所需的傳輸方式,不必立刻重設整個用戶端。

VPN 模式:接管應用程式的 IP 流量
略過區域網路:保留本機網路的存取路徑
應用程式分流:先確認允許清單或排除清單
Mux 多工:確認相容後再調整
白話說明

這幾項分別控制流量入口、區域網路例外、應用程式範圍與連線多工,不是一組必須全部啟用的加速開關。先保留用戶端的一般設定。只有在有明確需求或遇到相容性問題時,才一次調整一項並重新連線驗證。

螢幕關閉後斷線、切回應用程式後又恢復,通常與背景電量管理有關。可在系統電池設定中檢查該用戶端的背景執行限制,並視需要允許背景活動;各家廠牌的選項名稱不同,請勿照抄其他手機的選單路徑。從 Wi-Fi 切換至行動網路後若連線中斷,應先重新連線並檢查目前網路是否可連通。若只有特定網路發生問題,請接著檢查 DNS、網路存取政策與伺服器端入口,不要把所有狀況都歸因於電池最佳化。

Linux:套件、桌面代理與 TUN

依發行版與架構安裝 v2rayN

Linux 可使用 v2rayN 桌面用戶端。先開啟發行版的系統資訊,確認 CPU 架構與套件系統,再前往Linux 下載頁選擇相應安裝套件。Debian、Ubuntu 系統通常使用 deb,Fedora 等系統通常使用 rpm,但實際相容性也取決於發行版版本與相依套件。套件副檔名只能用來判斷安裝系統,不能保證所有使用同類套件管理器的系統都符合執行需求。

下載後建議使用發行版的軟體安裝程式開啟,查看相依套件與安裝提示,再確認安裝。若系統回報相依套件無法滿足,請保留完整錯誤訊息,並檢查套件架構、發行版環境與軟體來源狀態。不要強制略過相依套件,讓應用程式看似安裝成功,實際上卻無法啟動。安裝完成後,從應用程式選單啟動。圖形用戶端適合已有桌面工作階段的環境;只有遠端終端機的伺服器不能直接照搬圖形介面的操作步驟。

以一般使用者身分啟動圖形介面即可。若以系統管理員身分執行整個桌面用戶端,可能會建立屬於管理員的設定檔,之後以一般使用者啟動時便可能無法儲存設定。遇到寫入失敗,請確認目前應用程式的資料目錄與檔案擁有者,不要直接放寬整個使用者目錄的權限。若發行版的安全機制阻擋某項網路操作,應查看具體遭拒的對象,再依平台規範處理,而非關閉整套系統存取控制。

匯入訂閱與桌面環境的代理差異

在訂閱群組中新增項目,填入別名與網址,儲存後更新,再選擇目前使用的伺服器。操作方式與其他桌面平台相同。更新失敗時,需分辨是用戶端無法存取網址,還是下載內容無法解析;若直接存取時出現登入表單或網路認證頁,應先完成目前網路的登入認證。在 Linux 桌面環境中,瀏覽器能開啟網址而用戶端無法存取,也可能是兩個程式使用了不同的代理入口或 DNS 路徑。

系統代理的涵蓋範圍取決於桌面環境與應用程式的實作方式。部分應用程式會讀取桌面設定,有些使用自身設定,另有一些命令列工具則讀取環境變數。v2rayN 顯示已啟用自動設定系統代理,不代表所有終端機程式都會立即採用該設定。先用明確遵循桌面代理的應用程式測試,確認本機監聽正常後,再處理特定程式。不要只因一個終端機工具無法連線,就直接修改整個系統的路由與 DNS。

環境變數也有適用範圍。在目前終端機工作階段中修改變數,不會自動傳給已執行的圖形應用程式;桌面設定變更也不一定會改寫已開啟終端機的環境。若目標程式支援手動設定代理,可在程式自己的設定中填入用戶端實際監聽的本機位址、連接埠與協定。HTTP 代理與 SOCKS 代理不能只因連接埠數字相近就互換,實際監聽類型請以用戶端設定為準。

TUN 的權限、虛擬介面與還原方式

只有在需要接管不支援代理設定的應用程式時,才評估使用 TUN。它涉及虛擬網路介面、路由、DNS 與必要權限,並不是一般系統代理的強化開關。先確認目前的用戶端與發行版支援此模式,再依用戶端提示完成授權或輔助服務設定。各發行版的權限方案不同,不建議長期執行來源不明的提權命令,也不要把其他平台的安裝步驟套用到目前的 Linux 環境。

啟用後若無法連線,先關閉 TUN,再檢查原有系統代理是否正常。若關閉後仍有異常,可在系統網路管理員中檢查目前的 DNS 與預設連線是否已恢復。虛擬介面存在本身不一定代表故障,關鍵在於路由是否仍將流量送往已停止的路徑。以下兩個命令只讀取狀態,不會修改網路設定;適用於採用相應網路工具的系統。若沒有該命令,請使用發行版提供的同等檢視方式。

ip route show
resolvectl status

檢視路由時,留意預設出口與虛擬介面之間的關係;檢視 DNS 時,確認解析伺服器屬於哪個網路連線,不要看到多個位址就直接刪除。若同時執行容器網路、虛擬機器或其他 VPN,先分別停止相關接管工具,再逐一恢復並觀察哪個步驟引發衝突。結束用戶端後,也要確認桌面代理沒有殘留。重新安裝軟體通常不會自動修復其他元件留下的路由,因此,比起反覆重裝,更重要的是保留「關閉接管後恢復一般網路」的操作方式。

流量接管與分流:系統代理、TUN 與路由

先決定請求如何進入,再決定出口

系統代理、TUN 與路由分別處理三種不同問題。系統代理會告知遵循設定的應用程式連線至本機代理;TUN 則在網路層接收進入虛擬介面的 IP 流量;路由規則決定已進入核心的請求該使用哪個出口。所謂「全域」通常是用戶端提供的路由預設,不保證所有應用程式的流量都已進入用戶端。忽略系統代理的程式,即使路由切換為全域,也可能仍以自己的方式直接連線。

因此,應先用系統代理測試瀏覽器,再考慮使用 TUN。一般代理模式的問題主要集中在應用程式入口、監聽連接埠與伺服器設定;TUN 還會增加虛擬介面、路由表、權限及 DNS 等變數。只有在需要擴大接管範圍時,才增加這些變數;不要為了讓狀態看起來更完整,就把所有開關都打開。若應用程式已有自己的代理設定,也應確認不會與系統或虛擬網路入口重複接管。

設定項目主要解決的問題無法據此推斷
系統代理遵循系統設定的應用程式如何接入所有程式都已接管
TUN接入更廣泛的 IP 流量所有請求都使用代理出口
路由規則如何分配進入核心的請求出口目標應用程式已進入核心
DNS 設定由誰解析網域名稱,以及如何使用解析結果協定或伺服器端參數正確

了解規則順序與資料檔

路由通常依規則順序比對,較早符合的結果可能讓後續規則不再參與判斷。因此,排查某個網域為何直接連線時,應先檢查前面的規則,而不只是確認末尾有代理規則。網域規則依賴請求中可用的網域資訊;IP 規則則依賴目標位址及相關解析策略,兩者不一定等效。若應用程式直接連線至 IP,或網域在進入核心前已完成解析,實際可用的比對條件可能與預期不同。

GeoIP 與 GeoSite 是規則資料,不是伺服器設定。前者提供 IP 分類資料,後者提供網域分類資料;可使用哪些集合,取決於實際安裝的資料檔。用戶端預設設定可以引用這些資料,但無法保證所有第三方資料檔都有同名分類。更換來源後若啟動時顯示找不到集合,請確認規則引用與資料內容是否相符。需要了解更新方式時,可參閱路由資料檔說明。

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

這是提供給支援相應語法的核心使用的路由片段,並非完整的連線設定。它會將私有位址比對至名為 direct 的出口;完整設定中必須已有同名出口,且可讀取相應的 GeoIP 資料。AsIs 不會為了路由比對而額外主動解析網域名稱,但其他連線環節仍可能需要 DNS。

DNS、區域網路與多工的調整原則

若網域無法開啟,但直接存取目標 IP 有反應,可將 DNS 列為排查方向,但不能簡單認定是某個公共解析伺服器失效。用戶端、系統、瀏覽器與應用程式都可能使用自己的解析路徑,快取也可能保留舊結果。先確認問題發生在哪個應用程式、是否啟用獨立的加密 DNS,以及 TUN 是否接管系統 DNS。每次只調整一處,重新連線並重新送出請求,避免多個解析設定互相覆蓋。

存取印表機、共享資料夾或本機管理頁面時,需要保留適當的區域網路直連路徑。「略過區域網路」通常會處理私有位址,但具體網段與網域探索行為仍受規則和系統網路環境影響。不要為了存取本機裝置而將所有目標都設為直連,也不要只新增一條網域規則,就假設本機探索協定一定正常。先使用裝置實際的區域網路位址測試,再檢查名稱解析與應用程式探索機制,將網路連線問題與自動探索問題分開排查。

Mux 多工用於重複利用連線,但不代表適用於所有網路與協定組合。若只有特定協定或應用程式出現異常,可在保留其他條件的情況下關閉多工進行比較,但不要同時更換伺服器、傳輸方式與 DNS。自訂設定也應遵循相同原則:先保存原有規則,再新增一項目的明確的變更。用戶端產生的設定與手動撰寫的設定可能互相覆蓋;編輯前請確認目前實際執行的是哪一份,不要只因檔案成功儲存,就認定設定已生效。

設定問題:從訂閱到目標逐層排查

訂閱更新失敗或匯入後沒有項目

先確認問題發生在請求網址,還是解析內容。無法解析訂閱網域、連線逾時、存取遭拒,分別代表不同階段出現問題;若傳回內容不是支援的設定格式,則應檢查訂閱類型與回應內容。複製網址時,請確認前後沒有多餘空格、換行或不完整的查詢參數。網址能在瀏覽器中顯示頁面,不代表用戶端收到的一定是設定。頁面可能要求登入、顯示網路認證提示,或傳回面向瀏覽器的管理介面。

已有可用伺服器時,可依目前網路狀況嘗試直接更新或透過代理更新,觀察錯誤是否改變;若沒有任何可用設定,就不要依賴尚未建立的代理完成首次更新。若伺服器端已變更訂閱網址或存取權杖,請使用新的完整網址,不要只替換猜測有變動的片段。多台裝置同時失敗時,更應檢查訂閱來源與服務狀態;只有一台裝置失敗,則優先比較該裝置的網路、時間、解析與用戶端設定。

伺服器已列出,但核心啟動或握手失敗

訂閱清單已有項目後,先確認選取的伺服器正確,再查看核心啟動結果。設定解析失敗通常發生在實際建立遠端連線之前,應檢查欄位支援與核心相容性。位址無法解析時,先處理網域解析;連線遭拒通常表示目標位址可連通,但該連接埠沒有接受連線;逾時只代表等待未能完成,不能僅憑這一點判定是本機網路、遠端防火牆或服務程序出了問題。

握手錯誤需要比對整套安全與傳輸參數,包括伺服器名稱、傳輸類型、路徑、使用者識別碼與相關擴充選項。伺服器位址與安全連線使用的名稱可能不同,不要因為兩個欄位看起來重複就刪除其中一個。系統時間明顯錯誤也可能導致驗證異常。不要長期以略過憑證驗證作為修復方式;請先核對憑證名稱、有效期限、設定來源與網路中間環節,讓安全參數恢復為與伺服器端相符的狀態。

同一份設定在 v2rayNG 可用、在 v2flyNG 卻無法使用時,應優先檢查核心功能差異,不要直接推斷其中一個應用程式損壞。桌面版也可能出現用戶端已更新、核心功能卻未完全同步的情況。需要比較協定支援範圍時,可參閱Xray 與 V2Fly 核心差異。比較時請維持網路與伺服器相同,一次只更換一項條件,結果才有助於定位問題。

顯示已連線,但應用程式仍無法存取

將問題分成「應用程式的請求沒有進來」與「請求進來後沒有出去」。操作目標應用程式時,若用戶端沒有相應請求的跡象,先檢查系統代理、應用程式分流清單、應用程式自有設定與 TUN 接管範圍;若已看到請求,再查看命中的路由及遠端錯誤。只有部分網站無法使用時,應比較網域解析、分流結果與目標服務本身的狀況。瀏覽器快取、連線多工與背景程序可能繼續沿用舊連線;調整設定後請重新送出請求,再判斷結果。

本機監聽啟動失敗時,請檢查是否有第二個用戶端占用相同連接埠,也確認上次執行的程序是否仍在背景執行。修改連接埠後,也要同步更新應用程式的手動代理位址;若只改用戶端而未改應用程式,兩端設定就會不一致。若只有啟用 TUN 時才出現問題,先退回一般代理模式,確認伺服器連線仍正常,再檢查權限、虛擬介面、DNS 與其他網路工具。一般代理尚未驗證成功前,不要繼續增加接管設定的複雜度。

恢復一般網路並整理有效線索

需要恢復網路時,先停止連線與 TUN,再清除由用戶端設定的系統代理,並確認沒有其他代理程序殘留。Android 則需確認目前 VPN 已確實停止,以及系統是否啟用了阻止非 VPN 連線的相關選項。桌面系統也應檢查應用程式本身的手動代理設定;清除系統代理後,這類設定不一定會自動重設。確認一般網路恢復後,再從一台目前使用的伺服器與一種流量入口重新建立測試基準。

記錄問題時,請保留作業系統平台、用戶端名稱、發生階段、觸發操作,以及最接近錯誤時間的記錄。分享前請移除訂閱網址、使用者識別碼、伺服器存取憑證與 QR code,不要直接上傳完整資料目錄。記錄中的錯誤可搭配v2rayN 記錄錯誤說明逐項理解;簡短的常見問答可查看說明中心。清楚記錄一次失敗的操作步驟,比大量缺少時間範圍的截圖更有助於定位問題。