V2Ray 全平台安裝與設定指南

第一次連線,請先依照入門指南完成匯入、啟用代理及測試。若已安裝客戶端,或想查詢安裝套件、系統流量接管範圍、分流與解析細節,請從本手冊的相關章節開始。排查問題時一次只調整一項設定,並保留能重現問題的設定。

通用準備:安裝套件、訂閱與測試

先分清客戶端、核心與訂閱

桌面平台建議先選 v2rayN。Android 可先考慮使用 Xray 核心的 v2rayNG;若訂閱服務提供者明確要求使用 v2fly 核心,再考慮 v2flyNG。客戶端負責管理訂閱、選擇節點及接收系統流量;核心則負責處理連線。訂閱是服務提供者提供的設定入口,通常會傳回一組可匯入的節點。安裝套件能執行,不代表目前使用的核心支援訂閱中的所有傳輸方式與安全選項。

選擇安裝套件時,請確認作業系統目前支援的程式架構,而非只看裝置的商品名稱。桌面裝置先查系統資訊;行動裝置還須考量系統提供給應用程式的架構。更換裝置時請重新選擇套件,不要直接將舊裝置上的整個程式資料夾複製過去。若服務提供者提供多種訂閱格式,請先選擇明確支援目前客戶端的入口。兩種客戶端都能開啟同一連結,不代表產生的節點設定也相同。

四種平台的客戶端與套件選擇依據
平台客戶端選擇套件的依據
Windowsv2rayNx64 系統;桌面版或傳統 WPF 版
macOSv2rayNApple Silicon 或 Intel
Linuxv2rayN發行版套件格式;x64 或 arm64
Androidv2rayNG / v2flyNGarm64 或通用版;依核心相容性選擇客戶端

備妥可重新匯入的原始資料

請將訂閱網址和服務提供者的使用說明存放在只有自己能讀取的位置。訂閱網址可能包含身分資訊;節點分享文字、QR Code 和匯出的設定也可能含有連線憑證。不要將這些資料貼到公開工單,也不要交給來源不明的線上轉換工具。記錄時只需寫下群組別名、協定、傳輸方式和更新時間。同步至新裝置前,請確認訂閱是否限制同時上線的裝置數量,以免誤把裝置數量上限當成設定故障。

請分清訂閱更新與節點連線:前者是向訂閱服務取得設定,後者才是使用設定中的伺服器建立連線。更新成功只能表示這次取得的內容可供解析;節點仍可能因傳輸選項不符、憑證驗證失敗或目前網路無法連線而無法使用。若服務提供者變更了訂閱網址,請先更新原群組中的網址,再手動重新整理該群組。不要反覆新增同名群組,否則很容易選回舊項目。

建立可重複執行的測試流程

啟用代理前,先確認目前網路能開啟常用網站。若使用需要登入的公共 Wi-Fi,請先完成網路登入,再啟動客戶端。檢查系統日期、時間與時區,並盡量啟用自動校時。接著只匯入一個群組,手動更新一次,再選取一個已知可用的節點。先查看核心日誌是否有啟動錯誤,再啟用平台對應的連線方式,最後使用同一個應用程式連線至同一個目標,比較啟動前後的狀況。

桌面平台第一次使用時,建議先測試系統代理;Android 則先使用系統提供的 VPN 連線。暫時不要同時啟用自訂 DNS、修改分流規則或切換核心。若測試失敗,請記下是更新失敗、核心未啟動,還是應用程式無法連線。將舊裝置的設定移轉至新裝置時,先確認一條連線可正常使用,再逐項還原分流和排程更新,避免一併帶入舊設定中的錯誤。

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

選擇桌面版或傳統 WPF 版

前往 Windows 下載,並在系統設定的裝置資訊中確認系統類型與安裝套件標示相符。桌面版採用跨平台介面,選單配置與其他桌面系統較接近;傳統 WPF 版則採用 Windows 使用者熟悉的介面。安裝其中一種即可。不要讓兩個版本同時啟動,否則可能搶用相同的本機連接埠,也可能在結束時互相覆寫系統代理設定。

依照安裝精靈完成安裝。若使用的套件需要先解壓縮,請先將整個資料夾解壓縮到一般使用者可寫入的位置,再從資料夾中啟動;不要直接從壓縮軟體的預覽視窗執行。啟動時若提示缺少執行環境,請以目前安裝套件的提示和下載頁說明為準,不要將另一個程式資料夾中的元件複製過來。準備移轉設定時,請先正常結束程式,再依客戶端支援的方式匯出或備份;無法啟動的舊資料夾不要直接覆蓋到新版上。

匯入群組並確認核心已啟動

開啟訂閱群組設定,新增群組並輸入易於辨識來源的別名和訂閱網址,儲存後更新目前群組。返回主視窗,切換至該群組,選取一個節點並設為目前使用的伺服器。節點出現在清單中不代表已啟用,請以目前伺服器標記和啟動日誌為準。若更新結果為空,先確認選取的群組和服務提供者指定的訂閱格式,再查看更新日誌;不要立刻更換連接埠或清除現有群組。

在參數設定中查看本機監聽位址和連接埠。只在本機測試時,請保留迴送位址;連接埠號碼以實際設定為準。若日誌顯示位址已被使用,先找出目前是哪個程式正在監聽。以下 PowerShell 命令以常見連接埠為例,執行前請換成介面顯示的連接埠。命令只會列出監聽位址和程序編號,不會修改設定;取得編號後,可在工作管理員的「詳細資料」頁面核對對應程序。不要直接結束不熟悉的系統程序。

Get-NetTCPConnection -State Listen -LocalPort 10808 |
  Select-Object LocalAddress, LocalPort, OwningProcess

先測試系統代理,再考慮 TUN

從系統匣選取自動設定系統代理,再到 Windows 的網路代理設定確認目前位址和連接埠。使用系統代理的應用程式通常會讀取這項設定;自行設定代理的瀏覽器或工具則可能不會。先使用確定會遵循系統設定的瀏覽器發出新請求,再查看客戶端日誌是否出現相應連線。瀏覽器原有分頁可能沿用既有連線,測試時可開啟新視窗;必要時正常結束並重新啟動瀏覽器。

若只有不讀取系統代理的應用程式需要連線,先確認它是否支援在應用程式內設定代理位址。確實需要接管更多流量時,再依照桌面 TUN 檢查流程啟用,並依客戶端提示授予必要權限。首次測試時,請將系統代理還原至原本狀態,避免兩種連線方式疊加而難以判斷。公司電腦若出現權限限制,請依管理單位的流程處理;不要停用管理政策,也不要把管理員權限當成一般連線故障的解決方式。

從睡眠中恢復、切換 Wi-Fi 或異常結束後,若關閉客戶端反而無法上網,請重新確認 Windows 是否仍指向已停止的迴送連接埠。先還原原本的代理設定,再測試基本網路連線。若原本使用組織部署的自動設定指令碼,也請還原原政策,而非只關閉手動代理選項。重新安裝通常不會清除留在系統層級的代理設定。若要確認解壓縮資料夾、執行環境與首次啟動的關係,可參閱v2rayN 首次安裝設定檢查清單。

macOS:安裝 v2rayN 與設定網路服務

依晶片選擇下載項目並完成首次啟動

開啟 Apple 選單中的「關於這台 Mac」。若顯示 Apple 晶片,請選擇 Apple Silicon 安裝套件;若顯示 Intel 處理器,則選擇 Intel 安裝套件。前往 macOS 下載選取對應的磁碟映像檔。掛載後依視窗提示將應用程式複製到「應用程式」資料夾,再從複製完成的位置啟動。確認程式正常執行後,即可退出安裝映像檔。不要長期從掛載磁碟直接開啟應用程式,否則退出映像檔後,原本的啟動位置就會失效。

首次開啟時若出現提示,先分辨是一般確認、系統安全政策攔截,還是應用程式本身無法啟動。確認套件來源、晶片類型和目前系統需求;公司裝置的限制請向管理單位確認。不要為了開啟應用程式而關閉整台裝置的安全檢查。若介面已能開啟但核心程序啟動失敗,先查看日誌指出的程式名稱和路徑。若問題是在系統升級後才出現,先確認新版系統與目前安裝套件的相容性說明,再修改既有設定。

更新訂閱後檢查目前連線

從訂閱選單新增群組,輸入別名和網址,儲存後手動更新一次。看到項目後選取目前使用的節點,並確認日誌有記錄核心啟動。移轉舊設定時,建議優先保留可重新匯入的訂閱資料和少量自訂規則。不要原封不動移轉另一台裝置的核心程式、絕對路徑或啟動輔助項目。路徑與晶片可能不同,即使節點文字相同,呼叫的程式仍可能無法執行。

若更新群組時出現 HTTP 錯誤,先檢查訂閱權限,以及目前網路能否存取該網址;不要把完整連結傳給別人代測。若更新正常但連線交握失敗,再確認目前節點的協定、傳輸方式和安全欄位是否相符。若同一群組的大部分節點都能連線,請先找出出錯項目,不要立刻重設系統網路位置或手動修改全域 DNS。

依目前網路服務檢查系統代理

在客戶端啟用系統代理後,到系統設定的「網路」中開啟目前使用的網路服務,並在詳細資料中檢查「代理」。Wi-Fi 和有線網路可能屬於不同服務;若設定套用到未使用的服務,目前的應用程式就不會取得預期的連線入口。插拔擴充基座或從 Wi-Fi 切換至有線網路後,請先確認目前服務,再查看客戶端的本機連接埠是否仍在監聽。以下命令只會查詢系統代理狀態;若結果含有組織設定的位址,請勿公開完整輸出。

scutil --proxy

請核對輸出中啟用的類型、主機和連接埠,不要只看是否出現「代理」字樣。客戶端使用的連接埠必須與系統實際指向的入口相符,協定類型也必須一致。若瀏覽器可以正常連線,但另一個應用程式不行,請確認該應用程式是否有自己的網路設定,或是否仍沿用啟用代理前已建立的連線。一次只修改一項,再重新開啟該應用程式測試,不必勾選所有系統代理類別。

切換網路或啟用 TUN 後如何還原

需要接管不讀取系統代理的程式時,先記錄目前的網路服務、代理和 DNS 值,再確認客戶端的 TUN 選項和系統權限需求。啟用後進行兩類測試:一是一般網頁請求,二是應該仍可存取的本機資源。網頁能開啟不代表本機流量未被改道;若公司內網或本機裝置突然無法連線,請先關閉 TUN 並還原原本的連線方式,確認問題是否消失。不要一再授予權限來取代路由排查。

從睡眠中喚醒後斷線,先確認預設網路是否改變,再檢查迴送監聽和目前服務的代理設定。關閉客戶端後,應還原先前的代理狀態,而不是一律清除設定。若只有在某個 Wi-Fi 網路上失敗,請再檢查該網路是否需要登入網頁或使用獨立代理政策。這樣可以區分單一網路的設定問題和安裝問題,也能避免修改其他網路的無關設定。

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

依發行版和架構選擇安裝套件

先查看系統資訊確認發行版,再前往 Linux 下載取得 v2rayN。使用 Debian 系套件管理的系統通常選擇 deb;使用 RPM 套件管理且符合套件相依需求的系統則選擇 rpm。套件格式相同不代表相依套件相容,尤其是較舊的發行版。架構方面,常見的 x86_64 對應 x64,aarch64 對應 arm64。容器或相容層中的資訊不一定等同實際桌面工作階段的執行環境,請在預計啟動客戶端的系統中確認。

cat /etc/os-release
uname -m

下載後,請使用發行版的軟體安裝程式,或支援本機套件的套件管理工具安裝,並依套件管理工具提示處理相依性衝突。若提示架構不符,請回到下載頁更換正確套件;若提示缺少相依套件,先確認目前發行版是否符合需求,不要強制略過相依性檢查。安裝時可能需要授權,平時則請在一般使用者的圖形工作階段中執行客戶端。以管理員身分開啟整個桌面應用程式,可能會變更設定資料夾或檔案的擁有者,導致一般帳戶之後只能讀取、無法寫入設定。

匯入訂閱並檢查核心監聽狀態

在一般桌面工作階段啟動 v2rayN,建立訂閱群組並輸入別名和網址,更新目前群組後選取節點。切換前先確認該節點所需的核心與傳輸設定。匯入設定只會建立節點項目;還要確認核心程序是否接受參數並開始監聽。若程式介面無法開啟,先檢查應用程式的啟動提示;若介面可開啟但核心無法啟動,再查看參數解析、程式權限和監聽連接埠。不要把所有失敗都歸因於訂閱過期。

建議先從本機檢查連接埠。以下命令可在已安裝 ss 的系統上查看本機 TCP 監聽狀態,請以介面顯示的實際連接埠取代範例值。若沒有輸出,先檢查核心是否已啟動,不要直接新增防火牆放行規則。查到監聽項目只能證明本機入口存在,不能證明遠端連線正常。若監聽範圍超出預期,請確認是否誤開區域網路存取,並先恢復為僅限本機使用的位址,再繼續測試。

ss -ltn 'sport = :10808'

確認目前桌面工作階段是否讀取代理設定

不同桌面環境儲存系統代理設定的位置各不相同。同一個客戶端按鈕不保證每個工作階段、瀏覽器和背景服務都會採用相同設定。啟用系統代理後,先查看目前桌面環境中的代理項目,再使用會遵循該設定的應用程式發出新請求。終端機程式可能會讀取目前程序環境中的代理變數,也可能使用自己的設定;其他終端機工作階段不會自動沿用臨時變數。排查時建議只在單一測試程式中明確選擇正確的代理類型,不要寫入會影響所有程序的全域變數。

若瀏覽器使用代理,但命令列請求直接連線,不一定是分流錯誤。先確認命令列請求是否到達核心,再確認它支援 HTTP 還是 SOCKS 入口。不能只憑連接埠號碼猜測入口類型。由服務管理工具啟動的程式,其執行環境與登入後的桌面環境不同;排查時也不要以瀏覽器成功連線,推定服務端運作正常。單一應用程式已能滿足需求時,保留範圍較小的設定會更容易還原。

檢查 TUN 所需權限與路由

確實需要 TUN 時,請確認本機支援虛擬網卡,且客戶端能依照發行版的機制取得必要權限。切換前後分別查看路由;若有多張網卡或同時使用虛擬機器,也請一併確認需要保留的本機網段。以下命令用於檢視 IPv4 路由和政策,不會修改系統;若目前網路也使用 IPv6,還須查看相應的 IPv6 路由。若辦公網路或虛擬機器受到影響,請先關閉 TUN 進行確認,不要立刻覆寫預設路由。

ip route show
ip rule show
ip -6 route show

結束後仍無法連線,請先確認虛擬介面和客戶端程序是否已停止,再檢查桌面代理是否殘留,以及目前網路是否已恢復原本的出口。若裝置由網路管理服務維護,請盡量透過原服務還原,不要手動覆寫該服務產生的檔案。若重新啟動可暫時恢復,也請記下觸發條件:是客戶端結束順序、睡眠喚醒,還是網路切換。下次重現時,才能在問題仍存在的情況下取得可供比對的狀態。

Android:v2rayNG、v2flyNG 與 VPN 連線

選擇客戶端和安裝套件

先前往 Android 下載查看 v2rayNG。只有在訂閱服務提供者要求使用 v2fly 核心時,才選擇 v2flyNG;首次測試時不要同時執行兩套客戶端。確認系統支援 arm64 後,可選擇對應套件;若無法判斷,或裝置處理器支援 arm64、但系統只能執行其他架構的應用程式,請先確認通用版的適用範圍。安裝程式若回報不相容,除了架構,也要檢查系統需求和剩餘儲存空間;不要反覆更換訂閱來處理安裝錯誤。

透過瀏覽器或檔案管理員開啟安裝套件時,系統可能會要求授權目前的來源。只為開啟已知安裝套件的應用程式授予當次所需權限,完成後即可撤銷。更新時若提示安裝衝突,先檢查已安裝的應用程式是否來自其他發行管道,或是否位於不同使用者空間。若需要解除安裝後重新安裝,請先備妥訂閱原始網址和必要設定紀錄,因為解除安裝可能會清除本機群組、自訂規則和選取項目。

新增訂閱,然後啟動 VPN

在訂閱群組管理中新增群組,輸入別名和訂閱網址,儲存後執行更新。單一分享項目和完整訂閱不是同一種入口:單一節點請使用客戶端提供的單筆匯入方式;訂閱則在群組中重新整理。確認目前檢視的是剛建立的群組,選取項目後再從主畫面啟動。應用程式選單文字可能隨版本不同,但「儲存網址」、「取得項目」、「選取項目」和「啟動連線」是四個不同的狀態。

首次啟動 VPN 時,Android 會詢問是否允許客戶端建立本機 VPN。請先確認提出請求的是剛開啟的客戶端,再授予權限。狀態列圖示只能表示 VPN 連線已建立,不能證明所選節點已連線。接著使用瀏覽器發出新請求,並對照客戶端日誌進行確認。若裝置已由其他應用程式接管 VPN,請先確認能否暫停該應用程式;由工作資料或裝置管理政策維護的連線,請勿自行解除。

分辨背景停止、單一應用程式限制與網路切換

前景使用正常、螢幕關閉後卻斷線時,先確認連線服務是否仍在執行,再查看系統的應用程式耗電和背景執行政策。先重現一次,並記下螢幕關閉多久後斷線、通知是否仍顯示,以及解鎖後是否自動重新連線。只有確認系統停止服務後,才考慮只為目前使用的客戶端調整背景執行權限。不要同時取消所有應用程式的電池限制,也不要把通知仍顯示當成遠端連線持續正常的證據。

只有某個應用程式無法連線時,先檢查是否啟用了依應用程式分流。確認目前模式是只包含選取的應用程式,還是排除這些應用程式,不要只看清單中有沒有勾選。修改後依客戶端提示重新建立連線,再由目標應用程式發出新請求。也要分清系統的「一律使用 VPN」和「封鎖未使用 VPN 的連線」:前者要求維持 VPN,後者則會影響 VPN 中斷期間的其他網路連線。首次連線尚未確認正常前,不要把這些選項當成修復方法。

從 Wi-Fi 切換至行動數據後連線失敗,先切回原網路重新測試,再透過行動網路發出全新請求。既有連線可能因網路切換而失效,部分應用程式也可能受系統限制而無法使用行動數據。若問題只在螢幕關閉或切換網路時出現,請優先檢查系統政策;若兩種網路下同一節點都交握失敗,再檢查節點設定。如需進一步調整續航與背景穩定性,可參閱v2rayNG 電池最佳化與背景執行設定,一次調整一項權限並記錄結果。

路由分流與 TUN:入口、規則與出口

先確認流量是否進入核心

系統代理和 TUN 負責將流量導入客戶端。系統代理提供應用程式可讀取的代理設定,但應用程式也可能不採用;TUN 則透過虛擬網路介面搭配系統路由,接收符合條件的流量。路由分流負責在流量進入後選擇出口。切換為全域代理規則,不會讓忽略系統代理的應用程式自動接入;反過來說,啟用 TUN 也不代表所有接收的連線都會經由遠端轉送。

排查「某個應用程式沒有走代理」時,先查看它發出新連線時的日誌。核心沒有相關紀錄,就先檢查系統代理、應用程式本身的設定或系統路由;若有日誌但顯示選擇直連,則檢查規則;若有日誌且已選到預期出口但連線失敗,再檢查解析和交握。日誌等級可能影響紀錄詳盡程度,必要時可暫時提高一級,重現問題後再調回原設定。先區分這三個環節,避免核心根本沒收到請求時就重寫整套規則。

從小範圍規則開始驗證

使用客戶端內建的路由方案時,先查看方案中的比對項目和預設出口。名稱相似的方案可能有不同的預設行為,不要只憑名稱推測結果。自訂規則可先從單一明確網域或網段開始,確認核心取得的是網域名稱還是 IP 位址。網域規則比對的是連線中可供路由判斷的網域名稱,不是瀏覽器輸入的完整網址;通常不要將通訊協定前綴、路徑和查詢參數填入網域比對欄位。

同一流量符合多條規則時,常見核心會依序檢查路由規則,並套用第一條符合的規則。將需要優先驗證的特殊規則放在範圍較廣的規則之前,並確認沒有符合規則時使用的出口。不要把代理群組的別名當成實際的出站標識,也不要直接將其他核心的設定片段貼到目前的規則編輯器。更換核心後,先用簡單規則測試,再逐步還原原方案中的進階條件。

本機印表機、共享資料夾和公司內部服務通常有各自的存取路徑。請確認實際使用的本機網域、位址範圍和企業網路需求,再視需要設定直連或系統層級的排除;兩者不一定是在同一層處理。分別測試本機資源和一般網頁。若網頁正常但共享資源無法使用,請檢查本機流量是否進入虛擬網卡;若已進入核心,再確認實際使用的出口。

依可還原的順序啟用桌面 TUN

先使用目前的連線方式確認同一節點可正常連線,記錄系統代理和路由的基準狀態,再確認客戶端使用的實作方式與權限需求。關閉測試用的系統代理後啟動 TUN,分別測試一般網頁、不讀取系統代理的目標應用程式,以及必須保留的本機服務。測試時請發出新請求,不要沿用啟動前已建立的長連線。若啟用 TUN 後所有請求都逾時,請先關閉 TUN 並還原基準狀態,確認原本的連線方式仍能運作,再檢查虛擬介面和系統路由。

虛擬介面與其他 VPN 同時執行時,預設路由、目標網段和 DNS 流向可能互相覆蓋。不要同時啟用多套流量接管功能來嘗試修復。切換 Wi-Fi 和有線網路也可能改變預設閘道;重現問題時請記錄連線方式、目標類型和客戶端日誌。若問題只在正常結束程式後出現,請觀察結束時是否還原原本的代理和路由,再判斷是否需要重新啟動應用程式。能穩定還原,比臨時疊加設定讓某個網頁開啟更有助於診斷。

DNS 設定:確認由誰解析、透過哪條路徑解析

依請求確認解析發生的位置

先確認出問題的是訂閱服務網址、節點伺服器網址,還是要存取的目標網域。這三種位址不一定在同一階段解析。訂閱更新通常由客戶端發起;節點伺服器的網域名稱必須在建立遠端連線前解析成位址;目標網域則可能由應用程式、系統、核心或遠端解析,視連線方式與出站設定而定。若只看到「網域名稱解析失敗」,應先找出同一時間日誌中所指的對象,不要立刻更換整台裝置的解析服務。

應用程式有時會將解析後的 IP 位址交給代理,有時則會直接傳送網域名稱。核心只收到位址時,依賴網域名稱的分流規則可能不會生效;收到網域名稱時,也不一定需要先解析成位址才能選擇出口。使用路由網域策略前,請先分清需求是依網域規則判斷,還是依解析後的位址比對網段。流量嗅探在支援的協定和條件下或許能協助辨識網域,但無法還原所有連線,也不能取代正確的解析路徑。

以最少變更驗證解析設定

初次排錯時,先使用原本可正常運作的解析設定。在相同網路和應用程式中測試一個常用網域及一個必須保留的內部網域,兩者的正確解析結果可能來自不同服務。若內部網域只能透過組織網路解析,不要為了統一設定而改用外部服務。支援加密 DNS 的瀏覽器請先記下是否已啟用,因為瀏覽器的結果不一定代表作業系統的解析結果。修改後,請考量應用程式和系統的快取,以新請求重新測試,不要只依舊分頁的顯示結果下結論。

以下是適用於 V2Fly 核心設定的 dns 區段範例,其中 localhost 表示使用本機的系統解析。這是一段可合併至現有核心設定的 JSON 片段,不是可獨立啟動的完整設定,也不是將 DNS 伺服器位址設為迴送位址。圖形客戶端通常會由介面產生最終設定,請優先在相應設定中調整,不要用這段內容覆寫原始檔案。使用其他核心時,請先確認對應的設定欄位及版本支援,再進行變更。

{
  "dns": {
    "servers": ["localhost"]
  }
}

排查解析迴圈與位址族差異

啟用 TUN 或自訂解析後,請留意解析服務的請求是否又被同一個連線入口接管。若節點伺服器的網域名稱必須在代理連線成功後才能解析,啟動過程可能會互相等待。請對照最早出現錯誤的日誌和原系統 DNS,確認基本的啟動請求經由哪條路徑。先還原最近的變更,再逐項恢復解析相關設定。不要同時更換 DNS、路由規則和核心,否則即使問題解決,也無法判斷是哪項變更生效。

同一個網域可能同時有 IPv4 和 IPv6 位址。成功取得解析結果,不代表目前網路能連線至其中每個位址。若在家正常、切換到行動網路後逾時,請檢查日誌中的實際連線位址,以及網路支援的位址族。不要直接使用 HTTPS 網站的 IP 位址來判斷網域設定是否錯誤,因為憑證名稱、伺服器名稱和實際存取的網域仍可能必須一致。請使用同一個目標網域進行比較,確認是未取得位址,還是取得位址後無法連線。

若只有一個瀏覽器出現解析錯誤,先比對該瀏覽器的代理和加密 DNS 設定;若所有程式都無法連線,再檢查系統解析和目前的網路入口。問題只在啟用 TUN 後出現時,請比較啟用與停用時的解析路徑和本機服務可達性。排查完成後,還原不必要的臨時設定,只保留明確解決問題的項目並記下原因,避免換網後誤把測試設定當成必要設定。

常見設定問題:從本機狀態追查遠端連線

訂閱更新失敗,或更新後看不到節點

先確認目前編輯的是正確群組,並檢查網址是否多出空格或在複製時遭截斷。日誌若顯示未授權或禁止存取,請聯絡服務提供者確認網址權限和狀態;若已取得內容但解析失敗,請確認回傳內容不是登入頁面、提示頁面或其他客戶端使用的格式。若先前必須透過舊節點才能更新同一網址,請在更新前保留一份已確認可用的設定,並確認更新操作使用的是直接連線還是目前代理。新群組尚未確認可用前,不要刪除所有舊項目。

更新成功但仍看到舊內容時,先檢查目前清單的篩選條件、群組選項和目前使用的伺服器。自動更新間隔與手動更新是兩回事;測試時請手動更新一次,並查看記錄的時間和結果。若新項目已出現但目前使用的節點未變,請重新選取相應項目後發出新請求。問題只出現在某個群組時,先單獨檢查該群組,不要還原整套客戶端設定。

核心啟動錯誤、連接埠衝突或權限不足

先找出啟動當下第一則關鍵錯誤。若位址已被使用,請依平台章節確認是舊客戶端程序、錯誤的監聽位址,還是其他程式正在使用該連接埠。確認可以調整後,再修改客戶端監聽連接埠,並更新手動設定了舊連接埠的應用程式。若提示找不到檔案或無法執行,請檢查安裝套件架構、程式路徑和檔案權限。若提示參數無效,先停用最近新增的規則或自訂設定,回到簡單節點進行測試。不同錯誤需要處理不同層面,重新開啟系統代理不會讓核心讀懂無效參數。

核心正在執行,但連線逾時或交握失敗

先確認請求確實到達正確的本機入口,再檢查系統時間、目前使用的節點與核心是否相符。交握失敗時,請比對服務提供者給出的協定、傳輸方式和安全參數,不要關閉憑證驗證來掩蓋錯誤。連線逾時則要先分辨是解析尚未完成、連線未建立,還是連線建立後沒有收到預期回應。使用同一個應用程式和連線方式,改用已知可用的其他節點進行比較;也可以維持節點不變,改用另一個經允許的網路測試。一次只變更一個條件。

瀏覽器與客戶端的測速結果不一致時,請分別確認兩者測試的目標。測速可能只驗證所選連線的一小段路徑,無法取代實際應用程式的請求。若某個網頁可以開啟,但影片、會議或其他應用程式異常,先檢查它們是否使用相同入口、相同協定,以及目前的連線方式是否涵蓋相關流量。不要因某項測試成功,就推定整台裝置和所有應用程式都採用了相同設定。

停止客戶端後,網路沒有恢復

桌面平台先確認系統代理是否仍指向已停止的本機連接埠,再檢查 TUN 是否已停止、預設網路和 DNS 是否回到原本狀態。行動裝置則先查看系統 VPN 的「一律使用 VPN」和「封鎖未使用 VPN 的連線」選項。只還原本次修改過的項目,避免刪除組織預先設定的代理或其他網路設定。若代理已恢復但一般網路仍無法使用,請回到未啟動客戶端的狀態測試,排查目前網路登入、位址配置或基本連線,不要繼續新增分流規則。

如何整理可供複查的故障紀錄

記錄作業系統、客戶端與核心類型、連線方式、切換前後的狀況、問題發生時間,以及錯誤前後幾行日誌。若故障只在切換網路、螢幕關閉或喚醒後出現,也請記下觸發順序和應用程式狀態。分享診斷截圖前,請遮蔽訂閱網址、帳戶資訊、伺服器位址和內部網域。說明哪些變更已還原、修改前是否正常,有助於其他人分辨連線問題與排查過程中引入的新變化。

若要依錯誤訊息進一步排查,請參閱V2Ray 執行日誌排查方法;若要查詢常見的安裝與使用問題,請前往說明中心。若只想重新完成首次連線流程,請返回入門指南中的訂閱匯入步驟,以一個群組、一個節點和一種連線方式建立新的基準狀態。