v2rayN · v2rayNG · v2flyNG

V2Ray 故障排除

依症狀找出網路、訂閱、核心與代理接管問題。

首次設定請先閱讀使用說明,完成匯入訂閱、選取伺服器及設定系統代理等基本步驟。本頁供連線異常時查閱:先確認問題範圍,再依對應章節逐項檢查。每次只調整一項設定,並記錄修改前後的結果,避免多個問題混在一起。

桌面版首選 v2rayN Android VPN 分層檢查日誌與連線

檢查順序:基本網路 → 訂閱與伺服器參數 → 核心監聽 → 應用程式接入 → 路由與 DNS。

先記下用戶端名稱、作業系統、錯誤時間、目前模式及完整錯誤類型。分享日誌前,請刪除訂閱網址、驗證資訊、伺服器位址及個人裝置資訊。

無法上網

「用戶端已啟動」只表示圖形介面正在執行,不代表核心、伺服器連線及應用程式代理都已建立。排查時,先區分三種情況:關閉代理後仍無法上網;只有啟用代理後無法上網;只有特定應用程式或網站異常。這三種情況的檢查方向不同,直接更換協定或反覆重新安裝通常無助於釐清問題,還可能覆蓋原本可用的設定。

先確認基本網路與問題範圍

在 v2rayN 系統匣選單中關閉系統代理,再結束用戶端,並用瀏覽器開啟平時可直接連線的網站。同時確認已連上 Wi-Fi、閘道可連通,且公共網路的登入驗證已完成。若此時仍無法上網,應先處理系統網路、路由器或上游網路問題。Android 裝置則先停止 VPN,再測試 Wi-Fi 和行動數據;別把底層網路中斷誤判為訂閱失效。

確認基本網路正常後,重新啟動用戶端,只選一個目前有效的伺服器測試。不要同時執行兩套代理用戶端,也不要一邊啟用桌面系統代理,一邊讓另一個工具透過虛擬網卡接管流量。多個接入方式並存,可能讓請求走上不同路徑,造成瀏覽器能開啟、其他應用程式逾時,或結束某個程式後整個系統突然恢復的情況。

檢查核心、本機監聽與應用程式接入

開啟用戶端日誌,先確認核心是否成功啟動,再查看發出連線請求時是否產生新紀錄。如果出現設定解析失敗、無法繫結位址或連接埠已被占用,應先排除本機啟動問題;此時測試遠端伺服器沒有意義。若核心正常執行,但開啟網頁時完全沒有相關紀錄,請優先確認應用程式是否使用系統代理、是否設定了獨立代理,以及目前監聽連接埠是否一致。

以下 Windows 範例會直接指定本機 HTTP 代理,避免瀏覽器設定干擾測試。範例連接埠為 10808,執行前務必核對參數設定中實際啟用的 HTTP 或混合監聽連接埠;若該連接埠只接受 SOCKS,請改用相應協定。目標位址只是標準範例網域,不代表所有網路都能連線。

curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 --head https://example.com/

如果顯示無法連線至本機位址,請檢查是否有監聽服務;如果已連上本機代理,之後才發生遠端逾時,請接著參閱節點逾時排查。收到目標網站的 HTTP 回應,即使內容是拒絕存取或不支援該請求方法,也表示這次請求已到達回應端,但不代表所有網站或協定都正常。不要只根據命令結束代碼判斷整條連線路徑。

分開排查路由與連線問題

本機代理測試可收到回應,但瀏覽器無法存取時,請優先檢查瀏覽器代理擴充功能、系統代理及安全軟體的網路過濾功能。若只有部分網域異常,先查看這些網域符合直連還是代理規則,再檢查 DNS。可暫時選用明確的代理路由作為對照,測試後還原原有規則;不要同時修改 DNS、路由和伺服器,否則無法判斷究竟是哪項變更生效。

最後進行一次完整複測:確認直連正常、本機代理有回應、瀏覽器依預期接入,且目標網域使用正確的連線出口。記下失敗的層級,再前往相應章節排查。若只有特定網站回報帳號限制、地區限制或業務錯誤,應依網站回傳內容處理;這與用戶端完全無法上網不同,也不應靠持續切換設定掩蓋真正原因。

節點連線逾時

逾時表示某個階段未能在等待期限內完成,不代表伺服器一定離線。用戶端可能正在等待網域名稱解析、建立 TCP 連線、完成安全交握,或等待測試目標回應。先保存同一時段的日誌,找出最早出現的錯誤,再檢視後續連鎖錯誤。最後一行籠統的逾時訊息往往只是結果;前面的解析失敗或交握錯誤才是排查線索。

分辨測試類型與失敗階段

Tcping 通常只測試伺服器位址和連接埠能否建立 TCP 連線,不會完整驗證驗證資訊、傳輸層設定或目標網站存取。真實連線延遲會透過代理路徑向測試位址發出請求,結果也會受測試目標本身影響。因此,Tcping 有結果但網頁無法開啟並不矛盾;反過來說,伺服器不回應一般 ICMP 請求,也不能據此認定代理無法使用。

先確認伺服器項目仍來自目前的訂閱,而不是很久以前複製出來的獨立項目。檢查位址、連接埠與協定是否完整,並確認沒有選到名稱相同、但屬於不同群組的項目。若近期修改過伺服器端參數,請重新更新訂閱,或依完整參數重建項目;不要只改位址,卻沿用舊的傳輸設定。測試範圍的詳細說明請參閱延遲測試原理說明。

依日誌類型檢查參數

連線階段與優先檢查項目
日誌線索優先檢查不宜直接推論
網域名稱解析失敗伺服器網域、基本 DNS 與解析路徑不能直接判定連接埠遭到拒絕
連線逾時位址、連接埠、網路路徑與伺服器端可連通性不能只憑逾時判定驗證資訊錯誤
連線遭到拒絕伺服器端監聽、連接埠轉送與防火牆規則不代表本機系統代理失效
安全交握失敗時間、服務名稱、憑證與安全參數不應藉由停用驗證來掩蓋問題

使用 TLS 時,伺服器位址與交握時使用的服務名稱可能不同,不要把介面中的位址欄位直接複製到所有名稱欄位。請檢查系統日期、時間與時區;時間不準會影響憑證有效期限的判斷。遇到憑證錯誤時,應核對設定來源與伺服器端憑證,不要直接啟用略過驗證;這麼做可能讓連線看似恢復,卻留下錯誤的身分驗證設定。

使用 REALITY 時,請將伺服器端要求的公開金鑰、短識別碼、伺服器名稱及相關流控設定一起核對。空白字元、複製不完整,或誤用另一台伺服器的參數,都可能造成底層連接埠可連通、交握卻失敗。欄位是否必填取決於伺服器端設定,不可照抄其他項目的值。基本概念請參閱REALITY 術語說明。

透過可控對照縮小網路問題範圍

同一個項目在 Wi-Fi 下連線失敗、使用行動數據卻正常,表示應優先比較網路路徑、解析結果與閘道策略,而不是立刻重新安裝用戶端。不同測試應維持相同的伺服器、協定與目標位址;切換網路後重新建立連線,避免舊連線繼續使用原有路徑。若所有項目同時失效,也要檢查本機防火牆是否剛更新應用程式規則。

只有單一伺服器持續連線失敗,而同群組的其他伺服器正常時,問題較可能出在個別設定或伺服器端。確認訂閱已更新後,將錯誤發生時間、錯誤階段與已遮蔽敏感資訊的日誌提供給設定服務商。不要傳送完整訂閱網址,也不要公開驗證欄位。若要比對核心支援能力,請先閱讀核心選擇說明;更換核心並不是解決所有逾時問題的通用方法。

延長逾時時間只能用來確認回應是否較慢,無法修正位址錯誤、連接埠未監聽或交握參數不符。每次調整後都使用相同測試目標複測,並保留原始結果。若日誌顯示代理已建立,但測試網站遲遲沒有回應,請改用另一個明確可用的測試目標交叉驗證,避免將測試服務故障誤判為整台伺服器無法使用。

訂閱更新失敗

訂閱更新包含下載內容、解析格式及寫入群組三個環節。顯示更新失敗,可能是網址無法存取,也可能已下載內容,卻收到登入頁面、錯誤頁面或不相容的設定格式。請先保留現有項目,不要急著刪除整個群組。若現有伺服器仍可使用,刪除後再重建可能會讓後續排查失去可用的連線方式。

檢查網址與群組設定

開啟訂閱群組設定,確認網址是完整的單行連結,沒有連同說明文字、引號、換行或結尾空格一起貼上。訂閱網址通常含有個人存取憑證,應像密碼一樣妥善保管,不要放進公開截圖或線上轉換網站。核對時只需確認結構是否完整,不要為了讓他人判斷而直接傳送原文;需要協助時,可描述回應狀態和錯誤類型。

確認正在更新的群組,就是目前檢視的群組。多個群組名稱相同時,很容易誤以為「更新後沒有變化」;可先改成能區分用途的名稱,再逐一更新。若用戶端提供啟用開關、更新網址或篩選選項,也要確認群組未停用,且篩選條件沒有排除所有項目。群組顯示空白,不一定代表網路請求失敗。

分別測試直連更新與透過代理更新

部分訂閱網址可透過目前的基本網路直接存取,另一些則需要現有代理連線。依用戶端提供的更新方式分別測試,並注意每次只改變請求路徑。選擇透過代理更新前,必須先有一台可正常運作的伺服器;若現有代理已失效,卻仍依賴它更新訂閱,就會陷入無法自行恢復的循環。

瀏覽器能開啟網址,但用戶端仍更新失敗時,不要直接認定是用戶端異常。瀏覽器可能保留登入 Cookie、使用獨立代理,或自動經過驗證轉址;用戶端請求通常不會沿用這些狀態。請確認該網址是服務商明確提供的用戶端訂閱入口。需要互動登入的網頁,不能視為用戶端可讀取的訂閱回應。

若能查看回應狀態,驗證失敗通常需要重新取得有效網址;若請求過於頻繁,則應停止連續重新整理,依服務商說明稍後再試。伺服器端錯誤應搭配同一時段的其他存取結果判斷。不要將所有狀態都歸因於用戶端版本過舊,也不要使用瀏覽器擴充功能持續重試,以免進一步觸發伺服器端的存取限制。

確認格式與寫入結果

常見內容包括逐行排列的分享連結、經編碼的連結集合,以及專供特定核心使用的原生 JSON。副檔名和網址後綴無法保證格式正確,訂閱介面也可能依請求回傳不同內容。取得原生設定時,應使用用戶端對應的設定匯入功能,而不要預設所有 JSON 都能作為一般訂閱群組更新。詳情請參閱訂閱格式與轉換說明。

更新提示成功但沒有伺服器時,先切換至「全部」或清除清單搜尋條件,再檢查訂閱篩選規則、項目協定支援情況與日誌中的解析提示。單一節點分享連結與可重複更新的訂閱網址是不同類型的資源;前者適合匯入單一設定,不能只因看起來像一段連結,就填入訂閱網址欄位。相關差異請參閱分享連結與訂閱網址。

確認網址已過期或遭服務商更換後,請在原有群組中更新網址,再執行一次更新並觀察項目變化。若要新增群組作為對照,請保留舊群組,直到新項目通過連線測試,避免兩個群組同時自動更新造成混淆。問題解決後,請取消臨時篩選和重複群組,恢復合理的更新頻率,並妥善保留最近一次可用設定的私密備份。

連線正常但速度緩慢

排查速度問題前,先確認具體情況:網頁首次開啟很慢、檔案持續下載很慢、影片播放時斷時續,還是只有某個應用程式反應遲緩。首次開啟涉及解析、連線和交握;持續傳輸則較受頻寬、封包遺失、網路壅塞與伺服器負載影響。把這些情況混在一起比較,容易誤以為「延遲低就一定下載快」,也可能把網站本身的限速歸咎於用戶端。

建立可重現的對照條件

測試時固定裝置、網路、伺服器和目標網站,並暫停系統更新、雲端硬碟同步及其他大量傳輸工作。若 Wi-Fi 訊號弱或頻段壅塞,先靠近路由器或改用有線網路作對照。若直連相同類型的資源也很慢,應先處理本機網路;只有透過代理明顯變慢時,再檢查代理路徑。不同日期、不同資源的結果不能直接當作相同條件比較。

不要同時對所有伺服器進行下載速度測試。並行測試會占用本機頻寬、增加伺服器端負載,也可能讓原本穩定的連線看起來不穩。每次選少量候選伺服器,依相同順序逐一測試,並在兩次測試之間留出恢復時間。記錄開始時間、網路類型和資源來源即可,不必把某次瞬間峰值當成長期可用的速度。

分別觀察建立連線與持續傳輸

若每個網頁第一次開啟都很慢,但開啟後圖片和檔案載入正常,請優先觀察 DNS、交握、連線重用與路由規則;若開始速度很快、持續下載時逐漸變慢,則應比較 Wi-Fi 穩定性、長連線品質和遠端限速。瀏覽器開發者工具中的等待階段可供參考,但快取、網站指令碼和第三方資源都會影響結果,建議先用結構簡單的頁面作對照。

Tcping 測到的是較前期的連線特徵,真實連線延遲涵蓋更多代理流程,而下載測試才會產生持續流量。這三者不能互相取代。某台伺服器測得的延遲較高,持續傳輸量仍可能更穩定;另一台伺服器即使連線很快,也可能在尖峰時段受限。選擇時應以實際應用需求為準,而不是只看單一數值排序。

速度變慢的表現與排查方向
表現優先比對下一步
首次開啟很慢網域解析、交握與連線重用查看 DNS 與連線階段日誌
持續傳輸速度慢本機頻寬、封包遺失、伺服器端負載使用固定資源逐一測試
只有一個網站很慢網站連線出口、資源來源與服務限制比較其他網站與路由規則命中情況
切換網路後恢復Wi-Fi 連線、電信網路與閘道設定不變,重新測試網路

檢查分流、重複接管與傳輸設定

只有部分資源載入緩慢時,請檢查主頁面與圖片、影片資源是否套用了不同路由。網頁可能同時連線至多個網域,其中一部分走代理、另一部分直連;介面顯示已連線,不代表整個頁面使用相同出口。暫時套用統一路由作對照有助於找出問題;確認後再調整規則順序,不應長期依賴一條涵蓋所有流量的臨時規則。

同時啟用系統代理與虛擬網卡接管時,請確認核心自身的連出流量不會再次被代理。重複接管、錯誤的上游代理或鏈式設定可能增加額外往返,嚴重時甚至形成迴圈。不要為了測速同時開啟所有模式。一般瀏覽器測試請先使用單一、明確的接入方式;只有確實需要讓不遵循系統代理的應用程式連線時,再單獨測試虛擬網卡模式。

傳輸層參數必須與伺服器端設定相符。任意啟用多路複用、修改傳輸協定或套用他人的連線參數,不會自動增加頻寬,反而可能造成相容性問題。若懷疑路徑的封包大小異常,應依據具體症狀和網路環境逐步測試,記錄原始值,每次只改一項;不要在毫無根據時複製整套系統網路「最佳化」設定。

最後區分可調整項目與外部限制:用戶端可以修正錯誤的路由、解析和接管方式,卻無法確保伺服器負載、目標網站政策或上游網路始終不變。如果在多次固定條件的測試中,問題都指向同一條遠端路徑,請將發生時段與具體情況提供給設定服務商。還原所有臨時測試設定後,再用日常應用確認穩定性,不要持續執行速度測試。

DNS 與網域名稱解析

DNS 問題常見表現包括網域無法開啟、同一服務時好時壞,或日誌在連線前便回報名稱解析失敗。請區分伺服器網域解析與目標網站網域解析:前者決定用戶端能否找到代理伺服器,後者決定請求如何到達目標網站。兩者可能使用不同解析器和路由,不能只修改一個系統 DNS,就認為所有環節都已改變。

先判斷解析發生在哪一層

伺服器位址若填寫網域名稱,建立連線前就必須先解析出可用位址。如果這個階段依賴的解析路徑本身又需要代理才能運作,就可能形成啟動依賴迴圈。請先確認基本網路可以解析伺服器網域,再檢查用戶端 DNS 設定中的引導路徑。不要隨意將伺服器網域替換成查到的位址;伺服器端可能使用動態位址,或依賴正確的交握名稱。

目標網域可能由應用程式、本機系統或代理核心解析,實際方式取決於應用程式代理協定與用戶端設定。SOCKS 請求也有本機解析與交由代理解析之分,因此瀏覽器能開啟,不代表命令列工具採用相同方式。排查時記下使用的是 HTTP 代理、SOCKS 代理還是虛擬網卡模式,再依日誌確認名稱在哪一層轉換成位址。

可使用系統命令檢查基本解析是否有回傳結果,但這只能驗證系統解析路徑,不代表核心 DNS 的最終結果。以下命令使用範例網域;測試實際故障時,請替換為發生問題的公開網域,避免將含有帳號或存取憑證的完整連結貼進命令。檢查結果時,也要留意是否同時回傳不同的位址類型。

nslookup example.com

檢查加密 DNS、位址類型與快取

瀏覽器的安全 DNS 設定可能會略過系統解析器,用戶端也可能另行設定加密 DNS。為建立可比較的測試路徑,可暫時讓瀏覽器遵循系統設定,再觀察問題是否改變;測試結束後,依實際需求還原設定。解析服務能否連線與回傳位址是否適用是兩回事;如果服務端沒有回應,連續更換解析位址也未必能解決路由問題。

部分網域會同時回傳 IPv4 和 IPv6 位址,但目前網路對兩種位址類型的連線能力可能不同。若日誌顯示持續嘗試無法連通的位址類型,請比對系統網路狀態與用戶端的網域解析策略。暫時限制位址類型有助於排查,但不應將永久停用某種協定當成所有裝置的通用做法;最終設定應符合實際可用的網路與伺服器能力。

修改解析設定後,舊結果可能仍留在瀏覽器、系統或核心的快取中。先關閉舊分頁或重新啟動相關應用程式,視需要重新啟動用戶端,再測試相同網域。Windows 可使用以下命令清除系統解析快取,但這不會清除所有應用程式快取,也無法修正錯誤的上游解析器。不要反覆清除快取來取代對錯誤路徑的檢查。

ipconfig /flushdns

讓 DNS 路徑與路由保持一致

直連流量與代理流量可能適合使用不同的解析路徑。若直連請求取得只適用於其他網路出口的位址,連線可能失敗或變慢;若遠端解析請求被錯誤送往無法存取的出口,也會造成逾時。先檢查 DNS 請求本身如何連出,再檢查網域比對規則;不要只看最後回傳的位址,而忽略查詢過程。

使用虛擬網卡模式時,也要檢查系統 DNS 是否經過用戶端預期的接管路徑,以及其他 VPN 是否改寫了相同設定。若啟用虛擬位址映射等機制,解析與後續連線都必須由相應規則處理,不能只複製其中一項設定。一般訂閱匯入使用者應優先透過用戶端圖形介面排查,避免直接編輯自動產生的執行設定。

修復後至少確認三件事:伺服器網域可以解析、目標網域收到回應,且實際存取符合預期路由。若只有單一網域持續異常,請比較其權威記錄變化、網站狀態與不同網路的結果,再決定是否需要設定個別規則。DNS 不是所有連線錯誤的總開關;解析成功後,仍可能有連接埠、交握或目標服務故障。

系統代理未生效

系統代理是作業系統提供給應用程式讀取的一組代理設定,並非強制轉送所有流量。瀏覽器通常會遵循這些設定,但部分終端工具、遊戲及使用獨立網路模組的應用程式不會自動套用。因此,「瀏覽器正常,某個應用程式不通」時,應先檢查應用程式的接入方式,而不是改成全域路由後繼續等待;路由只能處理已進入用戶端的請求。

確認監聽連接埠與系統設定一致

在 v2rayN 參數設定中查看本機監聽位址、連接埠及支援的代理協定,再開啟系統代理設定核對。不同設定可能使用不同連接埠,不要將教學範例當成目前裝置的固定值。本機應用程式通常會連線至迴圈位址;若位址填成另一台裝置,或連接埠填成遠端伺服器的連接埠,系統設定看似已啟用,卻仍無法連上本機接入點。

以下 Windows PowerShell 命令可檢查範例連接埠是否有 TCP 監聽。如果沒有輸出,先確認用戶端核心已啟動,並核對連接埠是否與實際設定一致;如果有輸出,可進一步確認所屬處理程序。有監聽只表示某個程式占用了這個連接埠,無法單獨證明它就是預期的代理,也不代表遠端伺服器可用。

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

如果連接埠被其他程式占用,確認其用途後,可關閉衝突程式,或修改用戶端監聽連接埠並同步更新應用程式代理設定。不要只改用戶端,卻保留系統中的舊連接埠。也不要為了本機存取而將監聽位址擴大到所有網卡;允許區域網路連線會改變存取範圍,與修復本機系統代理是兩回事。

分辨手動代理、自動設定與應用程式個別設定

手動代理與自動設定指令碼是不同機制,系統介面中可能同時保留相關欄位。用戶端的模式名稱也不能簡單對應到作業系統中的某個開關,應以實際寫入的位址、連接埠或指令碼網址為準。切換模式後,請關閉並重新開啟測試應用程式,避免舊處理程序繼續沿用已建立的直連連線,導致誤判設定未生效。

瀏覽器擴充功能、企業原則及應用程式自己的代理選項,都可能覆蓋系統設定。先停用代理類擴充功能進行對照,再檢查應用程式是否選了「不使用代理」或指定其他位址。部分命令列程式讀取環境變數,不會讀取桌面系統代理;另一些 Windows 元件則使用獨立的代理設定來源。不要預期系統匣中的單一開關會同步改寫所有環境。

桌面平台的系統代理檢查位置
平台檢查重點常見限制
Windows系統代理位址、連接埠與應用程式個別設定部分元件不讀取桌面代理設定
macOS目前網路服務的代理選項切換網路服務後,設定可能不同
Linux桌面環境、應用程式選項與環境變數桌面代理設定不一定會傳遞給終端程式

檢查結束後殘留設定與虛擬網卡接管

用戶端異常結束後,系統代理可能仍指向已停止監聽的本機位址,造成關閉用戶端後所有網頁都無法開啟。這時請先在系統設定中暫時關閉殘留代理,確認直連恢復,再啟動用戶端並重新設定。不要先刪除網路介面卡或重設整個系統網路;單純的殘留位址問題不需要採取破壞性操作。

若確實需要接管不讀取系統代理的應用程式,可依用戶端文件評估虛擬網卡模式。該模式可能涉及權限、路由與 DNS 接管;啟用前請先確認一般本機代理連線正常,再單獨測試。不要把提高權限當成所有系統代理問題的解法,只有出現明確權限錯誤或確實需要接管時,才應授予相應權限。

最後驗證設定層與流量層:系統介面顯示正確位址、用戶端連接埠確實在監聽、應用程式發出請求時有產生日誌,且目標存取結果符合預期。只看到系統匣選單已勾選,無法證明這四項都成立。完成後退出用戶端,再確認系統是否恢復預期狀態,避免下次啟動前因設定殘留而再次發生同樣問題。

用戶端閃退或無法啟動

遇到啟動異常時,先分辨是圖形介面無法開啟、介面已開啟但核心退出,還是執行一段時間後整個程式關閉。這三種情況涉及不同層級:圖形執行環境、產生的設定或核心網路處理程序,以及系統資源與背景軟體。先記下觸發動作,例如啟動後立即退出、更新訂閱後退出,或啟用虛擬網卡後退出,再查看相應時間的日誌;不要只說「不能用」。

先排除套件類型、權限與執行環境問題

請前往用戶端下載頁,依作業系統和處理器選擇合適的套件。Windows 桌面版與傳統 WPF 版使用不同的介面技術,所需執行環境應以實際套件的提示為準;不要將某種執行環境視為所有套件的共同需求。macOS 請區分 Apple Silicon 與 Intel;Linux 則要同時考量處理器架構和發行版套件格式,避免把架構不符誤判為設定損壞。

若使用需要解壓縮的檔案,請先完整解壓縮至有寫入權限的位置再執行,不要直接從壓縮檔預覽視窗啟動。確認相依檔案與主程式都位於預期目錄,且清理工具沒有移除工作路徑。如果安裝或首次啟動遭系統安全機制阻擋,請先閱讀系統提供的具體原因,再透過系統提供的應用程式授權流程處理,不要直接關閉整台裝置的防護。

若出現明確的執行環境缺失提示,請依提示核對系統架構與所需元件;若檔案存取失敗,請檢查目錄權限、磁碟空間,以及設定檔是否被其他程式占用。將整個目錄放在雲端同步位置,可能造成鎖定或同步衝突;排查時可複製到一般本機目錄測試,但請保留原目錄,並避免同時啟動兩個執行個體寫入同一份設定。

分辨介面故障與核心設定錯誤

圖形介面仍在執行,只有核心反覆退出時,先查看日誌是否指出不支援的欄位、無效的協定組合、連接埠占用或規則檔案遺失。若最近剛啟用自訂設定、路由或 DNS,請先還原該項變更。一般訂閱使用者不宜直接修改自動產生的執行設定,因為下次套用用戶端設定時可能被覆蓋,也容易造成圖形介面狀態與實際設定不一致。

若確實要排查原生 JSON 語法,以下是合法的最小 JSON 範例,只用於理解物件、陣列、逗號與布林值的寫法,並非可直接建立代理連線的完整核心設定。檢查時請特別留意結尾多餘的逗號、中文標點與字串引號;語法正確也不代表其中的協定欄位符合目前核心的要求。

{
  "log": {
    "loglevel": "warning"
  }
}

遇到核心相容性問題時,先確認項目所需的協定能力,再比對用戶端實際使用的核心。v2rayNG 與 v2flyNG 屬於不同核心系列,只改變應用程式名稱不代表參數必定相容。相關背景請參閱Xray 與 V2Fly 核心差異。排查時不要將來源不明的核心檔案直接覆蓋到用戶端目錄。

透過隔離設定判斷是否損壞

懷疑使用者設定損壞時,先結束所有執行個體,備份設定、訂閱群組與自訂規則,再依用戶端支援的方式使用新的使用者設定目錄進行測試。不要直接刪除原有目錄。新設定能啟動,只表示問題可能與舊設定或擴充設定有關;之後分批還原訂閱、路由和其他設定,觀察哪一步再次觸發故障,不要一次覆蓋回全部舊內容。

若在乾淨設定下仍穩定重現閃退,請檢查系統事件紀錄、剩餘儲存空間、記憶體壓力及安全軟體的攔截紀錄。Linux 桌面啟動失敗時,也應核對圖形工作階段和套件相依性;macOS 則請留意系統授權提示。依觸發條件收集證據後,再決定是否更新或重新安裝。覆蓋安裝未必會清除損壞的使用者設定,因此不能只因「重裝後仍失敗」就認定是軟體本身異常。

恢復執行後,先用一份已知可用的設定驗證一般代理,再逐步還原較複雜的功能。保留可重現的步驟、完整錯誤訊息及已排除的項目,比連續嘗試多個安裝套件更有助於後續排查。首次安裝流程另請參閱桌面版首次安裝與初始設定;本章主要處理異常狀態,不取代日常安裝步驟。

Android 連線與背景執行

Android 端可先使用 v2rayNG 排查常見連線問題;需要 V2Fly 核心功能時,再評估 v2flyNG。兩款應用程式都要區分伺服器設定與系統 VPN 通道:狀態列出現 VPN 圖示,只表示系統通道已建立,不代表伺服器交握成功。若圖示正常但無法存取,仍應依序檢查本機接管、節點連線、路由與 DNS。

檢查 VPN 授權與網路狀態

首次啟動連線時,系統會要求確認 VPN 授權。若不慎拒絕,請再次發起連線並依系統提示授權;若裝置受工作設定檔或裝置管理政策限制,則應遵循相應規定。不要反覆清除應用程式資料來繞過授權問題,這會同時刪除訂閱與自訂設定。請先停用其他 VPN 應用程式,確認目前設定沒有被另一條 VPN 通道取代。

公共 Wi-Fi 可能要求先登入驗證頁面。連線 VPN 前,請先停止代理並完成網路登入,再重新建立連線。從 Wi-Fi 切換至行動數據後,舊連線可能仍在等待逾時;可先停止連線再重新建立,並查看日誌是否已使用新網路。若只有其中一種網路無法連線,請維持相同伺服器與設定進行比對;不要切換網路的同時又更換節點,以免失去判斷依據。

系統的永遠開啟 VPN 與封鎖未經 VPN 的連線,是獨立於應用程式介面的設定。若啟用了封鎖繞過,VPN 未連線時,部分流量可能依系統政策遭到阻擋。此時「停止用戶端後仍無法上網」不一定代表基本網路故障,應先檢查系統 VPN 政策,並依實際需求還原;不要只靠重新啟動手機來避開問題。

一併檢查個別應用程式代理與 DNS

啟用個別應用程式代理後,請確認目前設定是只代理所選應用程式,還是讓所選應用程式繞過代理;兩種清單的意思相反。如果測試用的瀏覽器不在預期清單中,流量可能完全不會經過用戶端。修改清單後請重新建立 VPN,並完全關閉再開啟測試應用程式,避免舊連線沿用原路徑。不要只因應用程式圖示在清單中被勾選,就認定它一定會使用代理。

若只有特定應用程式無法連線,請檢查它是否依賴其他元件發出請求,以及是否有獨立代理或安全 DNS 設定。主要應用程式與相關元件可能使用不同的網路接入方式,造成登入正常、資源卻無法載入。先用一個確認會經過代理的瀏覽器建立基準,再逐步加入其他應用程式。Android 設定流程請參閱v2rayNG 使用教學。

啟用本機 DNS 或流量嗅探,不會自動修復所有應用程式問題。嗅探或許能協助路由識別網域,但不等於解密應用程式內容,也不能取代正確的 DNS 與協定設定。遇到網域相關錯誤時,請對照DNS 章節判斷解析位置,再一次只修改一項設定。伺服器端參數仍須依完整設定核對,不要照著桌面截圖隨意補上欄位。

背景中斷時先檢查電池與處理程序限制

鎖定螢幕後連線中斷、切回應用程式又恢復時,常見檢查項目包括電池最佳化、背景活動限制、流量節省功能及廠商的自動啟動管理。請依系統提供的應用程式設定允許必要的背景執行,並保留用戶端要求的前景服務通知。不同裝置的設定位置名稱各異,請依系統實際介面查找;不需要為了一個用戶端就關閉所有應用程式的電池管理。

若允許背景執行後仍會中斷,請記錄中斷是否發生在切換網路、長時間閒置或系統清理記憶體之後。保持螢幕開啟做一次對照,區分網路閒置回收與處理程序遭終止。日誌停止更新、VPN 圖示消失及伺服器重新連線失敗,代表不同線索,應分別記錄。單純提高重新連線頻率可能增加耗電,卻無法解決系統持續終止處理程序的問題。

桌面版可用,同一個訂閱在 Android 上無法使用,該先查什麼?

先確認選取的是同一台伺服器,再比較 Wi-Fi、系統時間、協定支援能力與完整參數,接著檢查 VPN 授權、個別應用程式範圍和 DNS。訂閱網址相同只代表設定來源相同,不代表兩端的網路路徑與核心能力完全一致。

需要重新安裝時,請先備份訂閱與自訂規則,再從Android 下載入口選擇符合處理器的套件;不要同時更換安裝套件與修改協定。最後複測應包括前景存取、鎖定螢幕後恢復、Wi-Fi 與行動數據切換。若仍無法使用,請整理裝置系統、應用程式名稱、觸發步驟及已遮蔽敏感資訊的日誌,再回到相應故障章節繼續縮小範圍。