系統故障排除手冊 v2rayN / v2rayNG / v2flyNG

V2Ray 故障排除指南

連線、訂閱、DNS 與系統流量接管,依症狀逐步找出問題。

首次設定請先參閱快速入門教學;若已完成匯入,使用時才遇到異常,請查閱本手冊。桌面操作以 v2rayN 為主,Android 的差異另行說明。介面名稱可能隨用戶端版本調整,請以實際設定項目與日誌為準。

一次只修改一個項目。記下原設定,重新啟動相關連線,再以相同目標測試。不要同時更換節點、DNS 和路由。

先確認故障範圍

無法上網:從應用程式到出口逐層檢查

用戶端顯示正在執行,只代表介面或核心處於某種工作狀態,不表示目標網站已能正常存取。先釐清狀況:是所有程式都無法連線、只有瀏覽器有問題,還是只有部分網站無法開啟。記下首次發生時間、最近修改過的設定,以及切換網路後是否仍有相同狀況。這些紀錄比反覆點擊連線更有幫助,也能避免把網站本身的故障誤判為用戶端設定錯誤。

建立可供比對的基本連線

先停止用戶端接管流量,確認系統代理已還原,再開啟平時可直接連線的網站。若仍無法存取,先檢查 Wi-Fi、網路線、閘道和網路登入頁面;需要網頁認證的公共網路,請先完成登入。確認基本網路正常後,再啟動用戶端並選擇一個有效設定。測試期間只保留一個代理用戶端,暫停其他會改變網路出口的工具。

接著確認本機代理入口是否可用。在 v2rayN 查看實際的 HTTP 或 SOCKS 監聽位址與連接埠,不要照抄其他教學中的數字。若瀏覽器使用手動代理,協定必須與監聽入口相符,位址通常指向本機。若把 SOCKS 入口填進 HTTP 欄位,或把遠端伺服器連接埠填成本機代理連接埠,都可能導致網頁完全無法開啟,但節點設定本身未必有問題。

透過日誌區分「未接入」與「接入後失敗」

開啟用戶端日誌後,重新連線至明確指定的目標。如果完全沒有相應的連線紀錄,優先檢查瀏覽器是否略過系統代理、擴充功能是否覆寫設定,以及目標程式是否根本不讀取系統代理。若日誌出現目標網域,再確認錯誤發生於解析、連線或交握階段。日誌可能會合併重複訊息,不能只因沒有新增一行就判定流量未進入;必要時可暫時提高日誌詳細程度,再重新測試。

若「只有某個網站無法連線,其他網站正常」,請檢查路由是否將該網域送往不合適的出口。可暫時使用用戶端提供的全域代理路由進行比對,協助縮小問題範圍,但測試後請還原原本設定。若全域路由可開啟、原規則不行,接著檢查規則順序、網域比對和直連 DNS;若兩種路由都失敗,則檢查節點連線和目標服務狀態。

排除認證、憑證與舊連線的干擾

遇到憑證錯誤時,先檢查系統日期、時區和時間同步,再核對節點的伺服器名稱設定。不要關閉憑證驗證來掩蓋問題。若瀏覽器能開啟網頁,但某個應用程式無法連線,也要確認該程式是否使用獨立代理、固定連線池或背景服務。修改系統代理後,既有連線不一定會立即重新建立;完全結束應用程式後再開啟,通常比只重新整理目前頁面更能反映新設定。

若啟用 TUN 後所有流量都中斷,關閉後瀏覽器又恢復,請檢查權限、虛擬網卡、路由和 DNS 接管,不要立刻重裝整個用戶端。先保存目前設定,還原為「單一用戶端、單一節點、系統代理」的最基本可用狀態,再逐項加回規則。每次測試都使用相同頁面並記錄錯誤訊息;「無法開啟」還需進一步確認是逾時、連線遭拒、名稱解析失敗,還是憑證驗證失敗。

恢復後至少確認三件事:一般網頁能完整載入、需要代理的應用程式能建立新連線,以及關閉用戶端後基本網路仍可使用。若只有部分資源載入失敗,請檢查瀏覽器開發人員工具中的失敗網域,不要繼續切換整套設定。更詳細的操作順序可參閱已連線卻無法上網的逐項排查清單;若尚未完成初次設定,建議回到教學主線。

檢查遠端連線

節點逾時:區分連接埠、傳輸與交握失敗

逾時並非單一原因,而是連線過程中的某個環節未能在期限內完成。用戶端的測試工具可能測量 TCP 建立連線、經代理傳送 HTTP 要求,或其他探測流程,這些測試不能混為一談。先確認測試類型,再實際嘗試存取。單一節點測試失敗不代表整個訂閱都失效;連接埠可連通,也不代表認證和傳輸參數正確。

先確認是單一節點還是整體環境

在相同網路與用戶端設定下,分別測試兩個來自不同來源或不同線路的有效節點。若只有一個失敗,重點檢查該節點及伺服器狀態;若所有節點同時失敗,則檢查本機時間、網路出口、防火牆和核心啟動狀況。接著可短暫切換至另一個可用網路進行比對。切換網路會同時改變解析和出口,只能說明問題可能與環境有關,不能據此直接判定某項設定錯誤。

確認伺服器位址與連接埠時,請以訂閱或服務提供者提供的完整資訊為準。網域後不要重複加上協定前綴,連接埠欄位也不要混入路徑。手動設定時留意前後空格、全形標點和複製遺漏。使用網域位址時,先確認本機能否解析;若服務位址已更新,請重新取得設定,不要長期沿用單次查詢取得的位址。

依錯誤發生階段縮小範圍

日誌線索優先檢查下一步
connection refused位址、連接埠、服務監聽核對設定並確認服務狀態
i/o timeout網路路徑、遠端回應分別切換網路與節點比對
certificate時間、憑證鏈、伺服器名稱修正時間與 TLS 參數
EOF連線提早中斷依前文檢查傳輸與認證

這些關鍵字只是排查起點,不能直接當成最終原因。例如「連線遭拒」通常表示已收到明確拒絕,但拒絕可能來自遠端服務,也可能來自路徑中的設備;「逾時」則無法只憑一行日誌判斷是封包遺失還是服務沒有回應。記下錯誤前後幾行訊息,尤其是連線目標和使用的出口。不要混淆目標網站拒絕連線與代理伺服器拒絕連線,兩者屬於不同層級。

傳輸設定必須成套一致

使用 TLS 的節點應核對伺服器名稱、傳輸協定和伺服器端要求。WebSocket 的路徑與 Host、gRPC 的服務名稱等參數,都必須符合服務設定,不能只修改協定名稱。VLESS 搭配 REALITY 時,也應核對公鑰、短識別碼、伺服器名稱和流量控制等適用參數。欄位是否必填取決於具體組合;最穩妥的做法是重新匯入完整連結,而不是拼湊不同教學中的欄位。

系統時間不準會影響憑證有效期限判斷,也可能影響部分協定的認證流程。先透過系統設定同步時間,再重新啟動核心建立連線。遇到憑證鏈問題時,應檢查系統信任存放區是否正常,以及網路是否出現需要登入的認證頁面。不要把略過驗證設為常態方案;伺服器名稱與時間相關的處理方式,請參閱TLS 交握與憑證錯誤排查。

最後再判斷是否需要更新用戶端或核心。只有日誌明確指出不支援欄位、無法識別協定或設定解析失敗時,更新才是直接相關的處理方式。更新前先保存設定,再前往用戶端下載頁面選擇對應平台;更新後以原節點重新測試,避免同時更換線路。若節點本身已失效,請向服務提供者確認參數和維護狀態,不要不斷縮短測試間隔,增加連線要求。

確認恢復時,除了測試成功一次,也應建立實際網頁連線並觀察是否持續正常。保存有效的節點參數和測試環境,撤銷臨時新增的防火牆例外與除錯設定。若再次逾時,就能依這份基準判斷是節點、網路還是本機設定發生變化。

取得與解析訂閱

訂閱失敗:檢查網址、取得方式與內容格式

訂閱更新包含取得內容、解析內容和寫入群組三個階段。點擊更新後若出現失敗訊息,先判斷錯誤屬於哪個階段:連線逾時通常發生在取得階段;回傳內容無法辨識可能是解析階段的問題;更新完成但看不到節點,則應檢查群組篩選和內容變更。不要一開始就刪除原有訂閱;仍可使用的舊節點可以保留,用來維持連線並比對問題。

確認網址完整,並妥善保護訂閱憑據

從服務提供者頁面重新複製訂閱網址,檢查開頭、結尾和查詢參數是否完整。聊天軟體插入換行、瀏覽器複製的是顯示文字而非實際連結,或手動刪除問號後的參數,都會使網址失效。訂閱網址通常包含存取憑據,不要將完整網址貼到公開討論區,也不要上傳至不明轉換服務。尋求協助時,只需描述錯誤類型;截圖前請遮住網址、帳戶資訊和節點認證欄位。

查看帳戶頁面是否顯示已到期、停用、流量用盡或訂閱網址已重設。能登入服務頁面,不代表原訂閱網址仍有效;同樣地,網頁能開啟也不能證明訂閱介面正常。若服務提供者明確給出新網址,請編輯現有群組並更新,避免重複建立多個名稱相似的群組。保留原群組備註,方便確認哪些節點來自同一來源。

分開檢查訂閱取得與節點連線

節點連線成功,不代表訂閱介面一定能透過相同路徑存取;若所有節點失效,依賴現有代理取得訂閱也可能形成循環。查看用戶端是否提供透過代理更新、直接更新或類似選項,依目前網路狀況選擇後分別測試。不同用戶端的介面名稱不盡相同,不能假設更新訂閱一定會使用系統代理。

若直接更新逾時,但現有節點可以存取訂閱服務,可嘗試透過目前代理更新;若目前代理已無法使用,但訂閱介面可直接存取,則改用直接取得。每次只調整取得方式,不要同時修改 DNS 和群組網址。連續失敗時可稍後再試,避免觸發伺服器頻率限制。需要網路登入的環境,請先完成基本認證,否則取得的可能是登入頁面。

確認格式相容性與節點遺漏

訂閱內容可能是經編碼的分享連結集合,也可能是特定用戶端專用格式。檔名或連結結尾的副檔名無法保證內容適用於目前用戶端。請優先使用服務提供者明確標示適用於 v2rayN、v2rayNG 或 v2flyNG 的入口。若日誌指出不支援某個協定欄位,應先確認用戶端與核心的支援能力,再考慮更新軟體;任意刪除欄位可能讓節點成功儲存,卻在連線時失敗。

如果更新沒有報錯,但只剩下部分節點,請檢查是否啟用了關鍵字篩選、協定篩選或群組篩選。也要確認服務提供者是否調整線路清單,以及用戶端是否依重複項目規則合併內容。先切換至所有群組,再搜尋一個已知的節點別名。不要只因「清單數量和昨天不同」就判定解析錯誤,伺服器端內容變動也會造成相同現象。

更新後連線參數改變,屬於另一類問題。原有節點可能已被替換,目前選取的項目也可能指向已移除的記錄;請重新選擇更新後的節點,再啟動核心。若新訂閱能匯入但所有節點都無法連線,請前往節點逾時章節排查,不要繼續處理內容取得問題。恢復後保留必要的群組設定備份,並存放於安全位置,不要與日誌一併公開分享。

完整確認流程為:更新操作明確完成、目標群組能找到新內容,且選擇其中一個有效節點後能建立實際連線。首次新增群組的操作請參閱訂閱匯入教學;網址管理與常見使用問題請查看常見問題。若同一網址在多台裝置上都無法取得,且帳戶狀態正常,應優先稍候或聯絡服務提供者確認介面狀況,避免在每台裝置上進行無關的重裝。

效能與穩定性

網速慢:分別測試延遲、傳輸量與應用程式體驗

網頁開啟慢、影片緩衝和大型檔案下載慢,不一定是同一個環節造成。延遲代表一次往返所需時間,傳輸量代表持續傳輸能力;封包遺失和抖動則會影響連線穩定性。節點清單中的單次測試結果良好,不代表所有應用程式都會很快。先確認真正影響使用的是首頁等待時間過長、持續傳輸速率不足,還是連線間歇中斷,再選擇相應的比對方式。

建立固定的測試條件

選擇平時穩定的目標,在相近時段使用相同網路、用戶端和操作方式測試。暫停系統更新、雲端同步及其他大量傳輸工作,同時確認同一網路中沒有裝置占滿上傳頻寬。上傳壅塞也會拖慢網頁回應,不能只看下載流量。若 Wi-Fi 訊號較弱,請先靠近基地台或改用有線網路,避免把本機無線重傳誤判為遠端線路問題。

接著只切換節點,觀察相同目標的表現。若多個節點連線至同一網站都很慢,但其他網站正常,應考慮目標網站限速、內容傳遞路徑或帳戶限制。若同一節點在行動網路正常、固定網路較慢,則可能是接取路徑不同。不要同時執行多組速度測試;並行測試會互相爭用頻寬,結果既不代表日常體驗,也不適合直接比較。

透過日誌與系統資源用量確認瓶頸

傳輸期間若頻繁重新連線、逾時或連線重設,應先處理穩定性;盲目增加並行連線通常只會讓問題更嚴重。查看工作管理員或系統監視器,確認用戶端、核心或目標應用程式是否持續占用大量處理器資源。裝置處於省電模式、溫度過高或背景掃描頻繁時,加密和網路處理效能可能受到影響。先恢復正常供電與散熱條件,再判斷是否需要調整軟體。

若瀏覽器下載正常,但某個應用程式速度很慢,請檢查該程式是否走不同出口、使用獨立代理,或選擇了不同服務區域。路由規則可能讓網頁走代理、下載網域卻直接連線,也可能正好相反。請依目標網域的連線紀錄確認實際出口。不要只根據應用程式名稱推測路徑,同一程式可能會使用登入、媒體和更新等多個網域。

謹慎調整傳輸與 TUN 參數

多路複用並非在所有協定與網路環境下都能加快速度。若問題只在啟用某項進階傳輸選項後出現,可還原該選項的預設值再比對;不要從不同來源拼湊所謂的通用加速參數。協定與核心的組合也有能力限制,伺服器端未啟用的功能,僅修改用戶端不會提升效能。保留服務提供者給的完整參數,比任意更改傳輸類型更重要。

TUN 模式下若出現「小頁面正常,大檔案卡住」,可將 MTU、路徑探索和 UDP 處理列為可能原因,但它們並非唯一因素。先關閉 TUN,使用系統代理下載相同檔案進行比對;若只有 TUN 異常,再檢查虛擬網卡與核心日誌。確實需要調整 MTU 時,請記下原值並小幅測試;若結果沒有改善就還原,不要長期保留無法說明的網路參數。

DNS 也可能造成「感覺很慢」的體驗。網域解析反覆重試,可能讓首次開啟等待很久,但開始傳輸檔案後速度正常;此時應轉往DNS 章節排查,不要只更換高頻寬節點。另一個常見誤區是瀏覽器快取:第二次造訪速度較快,可能只是資源已儲存在本機。若要比較首次載入速度,請使用新的工作階段,或確保快取條件一致。

最後應保留可重複的改善,而非偶然出現的速度高峰。以實際使用情境持續測試,確認沒有用頻繁斷線換取短暫的高速。服務提供者標示的流量倍率是計費規則,不代表速度保證,選擇前請分開理解。節點地區、協定與流量倍率的選擇方式,可參閱節點選擇比較指南。若基本網路本身已壅塞,用戶端設定無法補足接取頻寬,應先處理本機與上游網路狀況。

名稱解析與路由

DNS 問題:確認由誰解析,以及結果如何使用

DNS 會將網域名稱轉換為位址,但在代理環境中,解析可能由系統、瀏覽器、用戶端核心或遠端完成。某個位置查詢成功,不代表實際連線使用了相同結果。排查重點不是一開始就更換 DNS 伺服器,而是確認失敗的要求由誰發出、經由哪條路徑解析,以及解析結果是否影響路由選擇。名稱解析與連線出口需要一起檢查。

先區分解析失敗與連線失敗

若日誌明確顯示網域解析失敗,記下網域名稱,並與同一時間其他網域的結果比較。若所有網域都失敗,請檢查解析服務本身及其連線路徑;若只有單一網域異常,則考慮權威記錄、快取或目標網域狀態。直接使用位址開啟網站不是可靠的替代測試;許多網站依賴伺服器名稱、憑證和虛擬主機,位址可連通不代表網域存取流程正常。

可使用系統內建工具查看系統端的解析狀況。在 Windows 中可執行 nslookup example.com;這只能確認系統查詢是否收到回應,不代表瀏覽器的加密 DNS 或用戶端內建解析結果一定相同。比對時記下查詢時間和使用的網路,不要只保留單一位址結果。若系統能解析,但用戶端回報錯誤,應接著檢查核心 DNS 設定,避免反覆清除系統快取,卻沒有處理真正的故障環節。

了解網域策略與規則順序

路由規則可依網域或位址比對。網域規則未命中時,部分策略會先進行解析,再繼續檢查位址規則。以下是 V2Ray/Xray 路由物件的局部範例,用於理解欄位位置,並非可獨立執行的完整設定。這也不等同於 DNS 伺服器位址設定,單改這一行無法解決所有名稱解析問題。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch"
  }
}

IPIfNonMatch 表示網域未命中現有規則時,嘗試解析後再進行相關位址比對。實際結果仍取決於規則順序、解析結果和預設出口。將策略改為另一項只會改變判斷時機,不保證路由更準確。先確認目標網域應使用哪個出口,再檢查為何沒有命中相應規則。更多概念請參閱路由與分流術語。

避免解析要求與代理形成依賴循環

若代理伺服器位址是網域,而解析該網域所需的 DNS 要求又只能透過尚未建立的代理送出,就可能形成啟動循環。使用加密 DNS 時,其服務位址本身也可能需要先解析。請在用戶端支援的範圍內,為伺服器網域保留可用的引導解析路徑,並確認代理尚未啟動時仍可連線;不要未經確認就加入複雜的遠端解析鏈。

使用 TUN 接管時,也要確認系統 DNS 要求是否有被接收、轉送並正確路由。若同時啟用瀏覽器加密 DNS、系統加密 DNS 和核心 DNS,不同程式可能得到不同結果。先選定一條清楚的測試路徑,暫時停用其他層級的自訂設定,再逐項恢復。若使用 FakeDNS 之類的映射機制,關閉接管後應讓相關應用程式重新建立連線,避免繼續使用只適用於該機制的映射位址。

雙堆疊網路也需要納入檢查。網域可能同時回傳兩類位址,其中一類網路路徑無法使用時,就可能出現間歇等待或部分應用程式失敗。先查看實際連線使用哪一類位址,再透過用戶端提供的位址選擇設定短暫比對。不建議一開始就停用全系統的某類位址,因為這可能掩蓋路由、閘道或上游網路的實際問題,也會影響其他應用程式。

確認恢復時,分別檢查系統查詢、用戶端日誌和實際網頁連線,確認三者沒有互相矛盾。接著切換一次網路,確認新網路是否改變 DNS 設定或引導條件。若只在修改 DNS 位址後短暫恢復,過一段時間又失敗,還需觀察快取到期後的情況。記錄「解析結果正常但連線失敗」這個分界;後續應改查出口和目標服務,而不是持續更換 DNS。

應用程式流量接管

系統代理未生效:檢查入口、權限與 TUN

系統代理是一組供應用程式參考的代理設定,不是強制接管所有程式的開關。有些應用程式會讀取這些設定,有些使用自己的代理設定,另有一些會直接建立連線。因此,瀏覽器能連線、另一個程式卻不行,不一定表示 v2rayN 沒有啟動。先確認目標應用程式支援哪種接入方式,再決定使用系統代理、應用程式內代理或 TUN。

確認系統設定確實已寫入

在 v2rayN 選擇自動設定系統代理後,開啟作業系統的網路代理設定,確認位址與連接埠是否指向目前的監聽入口。若仍指向舊連接埠或其他程式的位址,請檢查是否有另一個用戶端、管理工具或自動化指令碼覆寫設定。關閉其他流量接管工具後,再重新寫入一次。受組織管理的裝置可能有策略限制,不應規避管理要求;請先確認允許使用的網路設定方式。

在應用程式內手動設定代理時,先核對協定、主機和連接埠,再確認是否誤填了認證欄位。一般的本機監聽入口不一定啟用認證,不要將節點的使用者識別碼或密碼填進瀏覽器代理認證欄。排查時也不宜任意將監聽位址改為所有網卡;若只供本機使用,維持本機範圍更容易控管存取。若需與區域網路共享,應另行規劃存取權限。

辨別自動設定、獨立代理與環境變數

系統可能同時有手動代理、自動設定指令碼和應用程式內代理,實際優先順序由應用程式決定。瀏覽器擴充功能也能獨立改變瀏覽器的出口方式。請先停用相關擴充功能並檢查瀏覽器代理設定,再重新建立工作階段。命令列工具和背景服務可能會讀取環境變數或獨立設定;不要因為瀏覽器連線成功,就推斷它們一定走相同路徑。本手冊優先透過圖形介面確認實際入口。

環境優先檢查位置常見限制
Windows系統代理設定與應用程式設定背景服務可能使用獨立代理設定
macOS目前網路服務的代理選項切換網路服務後應重新確認
Linux桌面網路設定與應用程式設定不同應用程式讀取設定的方式不同
Android用戶端 VPN 接管與個別應用程式設定與桌面系統代理不是同一種機制

將 TUN 故障拆分為啟動與轉送問題

TUN 透過虛擬網卡處理路由至該網卡的流量,但實際涵蓋範圍仍由系統路由和用戶端設定決定。啟動失敗時,先查看權限、虛擬網卡建立狀況和驅動程式相關日誌;啟動成功但無法上網時,再檢查路由、DNS、出口選擇,以及伺服器位址是否已正確排除。不要看到開關已啟用,就認定流量已完整接管;也不要假設所有用戶端都提供完全相同的選項。

桌面版需要提高權限的操作,應使用系統認可的授權流程。若授權後仍失敗,請檢查是否殘留舊的虛擬網卡、其他網路工具是否占用路由,以及安全軟體是否有明確的封鎖紀錄。不要直接關閉整套防護。先依紀錄允許必要元件,再進行測試;若找不到明確證據,請維持原有防護狀態,避免排查時引入新風險。

若出現連線迴圈或啟用後立即斷網,請先關閉 TUN,確認系統代理的基本設定仍正常。接著逐項啟用流量接管和 DNS 設定,觀察是哪一步觸發問題。路由規則會決定接管後的流量如何選擇出口,TUN 並不代表所有目標都會使用同一個節點。啟用方式與適用情境請參閱TUN 設定教學及虛擬網卡原理說明。

關閉用戶端後若網路中斷,先檢查系統是否仍指向已關閉的本機代理,再確認虛擬網卡與路由是否依正常流程釋放。優先重新開啟用戶端,使用停止流量接管、清除系統代理等正常操作恢復;不要直接結束所有程序。確認恢復後,記下目前可用的接管方式;日常只保留必要的一層,以減少重複代理和設定互相覆寫。

啟動與執行環境

用戶端當機:分開檢查介面、核心與設定

視窗突然關閉、點擊啟動沒有反應,以及介面正常但核心退出,是三種不同問題。先觀察系統匣圖示是否仍在、日誌是否持續更新,以及工作管理工具中是否還有相關程序。記下觸發動作,例如啟動後立即退出、匯入某個節點後退出,或只有啟用 TUN 才退出。能穩定重現的觸發條件,通常比單次當機訊息更容易找出問題。

先保護設定,再處理執行環境

刪除資料夾、重設設定或重新安裝之前,先使用用戶端支援的匯出方式保存必要設定。訂閱網址和節點認證資訊具有敏感性,備份應存放在自己掌控的位置。若介面無法開啟,可先複製現有資料資料夾以便復原,但不要直接公開整個資料夾。接著確認設定檔位置是否屬於目前的安裝版本,避免把另一套可攜式資料夾誤認為目前執行個體的資料。

前往用戶端下載頁面確認平台與處理器架構。桌面系統能執行某類應用程式,不代表其他架構的套件一定適用;尤其是在不同處理器裝置之間移轉時,應重新選擇相符套件。Windows 桌面版與傳統 WPF 版採用不同介面技術,排查時請依所選套件的需求檢查執行環境,不要把某種介面的相依項目說明直接套用至另一種。

分別處理介面無法開啟與核心無法啟動

若介面啟動後立即退出,請檢查系統事件紀錄、應用程式日誌和磁碟剩餘空間。安裝目錄無法寫入、使用者資料目錄權限異常或同步軟體鎖定檔案,都可能影響啟動。先將程式放在可正常存取的位置,並確認目前使用者具備必要權限;不要長期以最高權限執行,掩蓋一般檔案存取問題。需要提高權限的 TUN 操作,應與日常介面啟動分開判斷。

若介面正常顯示,但核心立即停止,請優先檢查設定產生和監聽連接埠錯誤。日誌若顯示位址已被使用,可能是另一個執行個體仍在執行,也可能是其他程式占用相同連接埠。先關閉重複執行個體並確認連接埠用途,再修改本機監聽設定;修改後也要同步更新系統和應用程式代理。若只更改用戶端連接埠,但瀏覽器仍指向舊值,就會出現新的「啟動成功但無法連線」問題。

若出現設定解析錯誤、不支援欄位或規則檔案讀取失敗,請找出最近一次修改。手動編輯的 JSON 應檢查引號、逗號和欄位型別,但不要直接修改用戶端每次啟動時都會重新產生的檔案。優先透過設定介面還原該項目,或恢復先前保存的設定。匯入參數與目前核心不相容時,應確認協定支援狀況,不要隨機刪除錯誤行。

更新後出現異常,保留前後設定以供比對

若問題在更新後立即出現,請記下更新前後使用的套件類型、系統環境和觸發動作,不要憑空編造或靠記憶填寫版本資訊。確認舊程序是否已結束,以及新程式是否仍讀取原本的資料位置。不同執行個體共用同一資料資料夾可能造成狀態混亂。重新安裝前,先確認實際執行的是哪個執行檔;桌面捷徑也可能仍指向舊資料夾。

若安全軟體隔離或阻止元件,先查看明確的事件紀錄與檔案來源,再決定是否還原或設定例外;不要一次關閉所有防護。磁碟空間不足、異常斷電或資料寫入中斷,也可能造成設定不完整。若介面仍能開啟,可先匯出尚可讀取的資料,再建立新的工作資料;恢復時逐一匯入群組和規則,方便找出觸發異常的內容。

尋求協助時,請提供系統類型、架構、用戶端介面類型、重現步驟和已遮蔽敏感資訊的錯誤上下文。隱藏訂閱憑據、伺服器認證欄位和不必要的個人路徑。確認恢復後,先測試一般連線,再逐步加回複雜路由和 TUN;觀察一段實際使用情況,確認恢復的不只是視窗。核心與圖形介面的關係可參閱Project V 生態說明,避免混淆介面故障與核心故障。

Android 專項

行動裝置異常:VPN 授權、背景執行與個別應用程式規則

Android 排查以 v2rayNG 為主要操作對象,v2flyNG 則是採用 V2Fly 核心的替代選擇。兩者的設定能力與介面細節可能不同,不要假設同一項進階參數在兩者都適用。先確認目前實際執行的是哪個用戶端,再依「基本網路、VPN 授權、節點連線、應用程式規則」的順序檢查。桌面系統代理的使用經驗,不能直接取代 Android VPN 流量接管的判斷。

啟動後沒有網路,先檢查授權與衝突

首次啟動連線時,需要透過系統授予 VPN 連線權限。若尚未完成授權,即使已匯入節點,也不會自動接管應用程式流量。查看系統 VPN 設定與用戶端通知,確認目前連線屬於預期的用戶端。Android 通常同一個使用者空間只能有一個作用中的 VPN 服務,其他使用 VPN 機制的網路工具可能互相衝突;請先停止衝突服務,再單獨啟動需要測試的用戶端。

若系統啟用了永遠開啟 VPN,或禁止未使用 VPN 時連線,用戶端中斷後可能連基本網路也無法使用。這是系統策略的結果,不一定表示網路已損壞。排查前先了解這些選項的作用,必要時在裝置管理規範允許的範圍內調整測試條件,完成後再還原。若裝置受工作資料或裝置管理策略控管,請遵循管理員提供的網路方案。

分開確認螢幕關閉後斷線與背景限制

前景使用正常、鎖定螢幕後斷線時,優先檢查電池最佳化、背景活動限制和數據節省模式。不同裝置品牌的設定位置各異,可在應用程式資訊中尋找電池、背景數據和自動啟動等選項。只為目前使用的用戶端調整必要權限,不必更改所有應用程式的電源策略。也應檢查通知權限和背景服務限制,但有通知不代表節點連線一定持續正常。

測試時固定使用一個節點,先在前景完成連線,再鎖定螢幕等待;解鎖後立即查看日誌中的重新連線和網路變更紀錄。若只有從 Wi-Fi 切換到行動網路時中斷,可能是原有連線失效後未能及時恢復;請先停止並重新建立連線,確認新網路是否可用。不要在連線尚未重建時反覆更改協定參數,以免把網路切換與設定問題混在一起。

部分應用程式失敗,檢查個別應用程式規則與 DNS

個別應用程式代理通常有「僅代理所選應用程式」或「略過所選應用程式」等模式;若選錯模式,就會出現「明明勾選了卻沒有走代理」的情況。先確認模式,再檢查目標應用程式及其相依服務是否列在正確清單中。修改後重新建立 VPN,並完全結束目標應用程式後再開啟。瀏覽器與某個應用程式表現不同,也可能是因為它們使用不同 DNS 或連線協定,不能只靠一次網頁測試判斷接管範圍。

系統私人 DNS、用戶端 DNS 和應用程式內的加密 DNS 可能同時存在。若日誌出現名稱解析失敗,請先回到DNS 排查流程確認由哪一層負責解析;不要同時把所有解析入口改成不同服務。行動網路與 Wi-Fi 的結果不同時,也要檢查新網路是否需要認證、是否限制特定連線,以及用戶端是否已恢復原本的出口。必要時使用另一個有效節點進行單一變數比對。

安裝、移轉與最後確認

安裝套件架構不符可能導致無法安裝或執行,請依裝置處理器與系統能力選擇。主流裝置通常選擇 arm64;若不確定,可查看裝置資訊並參考下載頁面的通用套件說明。若現有應用程式無法覆蓋安裝,請查看系統顯示的原因,並檢查是否有不同簽章或其他使用者空間中的安裝紀錄。不要為了覆蓋安裝直接清除資料,請先備份再處理。

移轉設定時,優先重新新增自己的訂閱並更新,不要盲目複製所有系統相關選項。個別應用程式清單、背景權限和 VPN 授權都屬於裝置環境的一部分,在新裝置上仍需重新確認。若單一手動節點無法連線,請核對完整分享參數與核心支援狀況;若所有節點在兩種網路下都失敗,再檢查帳戶與服務狀態,不要只在手機設定中反覆尋找原因。

最後依實際使用情境確認:前景連線、鎖定螢幕後恢復、網路切換、目標應用程式連線,以及正常中斷後的基本網路都應符合預期。保存有效設定,撤銷臨時除錯和無關的權限調整。需要重新選擇安裝套件時,請前往Android 用戶端下載;若只想了解常見操作差異,可查看常見問題。完成一輪確認後,再恢復日常使用的複雜規則,讓下次出現異常時仍有明確的比對基準。