V2Ray 故障排除

無法上網：先拆解連線路徑

用戶端顯示已啟動，不代表應用程式的連線要求已經透過代理。一次連線通常會經過應用程式、本機監聽、核心路由、遠端連線及目標服務。前一個環節交接失敗，後續設定即使正確，也收不到要求。先記下是所有應用程式都無法連線、只有瀏覽器異常，還是部分網站無法開啟；也要記錄連線前後的變化，避免將原本就存在的網路問題誤認為用戶端故障。

分別測試直連與代理

先在用戶端停用系統代理，或中斷 Android 連線，再開啟平常可直接連線的頁面。如果直連也失敗，應先處理無線網路驗證、路由器連線、系統時間或網路本身的問題。測試時別只看已開啟的分頁，頁面可能是從快取載入。請重新開啟頁面並重新整理，確認確實送出網路要求，再啟動用戶端執行相同測試。

桌面端建議先用 v2rayN 排查。開啟參數設定，確認實際的本機監聽位址、連接埠和協定，再與系統代理中的位址比對。本站示意圖中的 10808、10809並非所有版本通用的預設值：部分介面使用混合監聽，部分設定則分別提供 SOCKS 與 HTTP。請以目前用戶端設定和啟動記錄為準，不要照著舊截圖修改系統設定。

接著開啟用戶端記錄，清除舊內容或記下目前時間，只重現一次連線失敗。如果完全沒有新的連線記錄，優先確認應用程式是否使用系統代理，以及瀏覽器是否有獨立代理設定覆蓋系統設定。如果本機入站記錄出現後才報錯，表示要求已送達核心，接下來應檢查節點、路由和 DNS。若記錄層級太低而看不到個別連線，可暫時提高一級，測試後再還原。

使用明確指定的代理隔離系統設定

以下指令僅適用於已確認 127.0.0.1:10808 提供 SOCKS 服務的情況；若連接埠不同，請替換成實際值。Windows 請在 PowerShell 使用 curl.exe，macOS 和 Linux 可使用 curl。範例網域僅用來確認要求路徑，不適合比較速度。若未安裝相關工具，可改用應用程式內建的代理設定，不必為此額外安裝網路工具。

curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/

如果明確指定代理後能收到回應，但一般瀏覽器仍無法連線，節點不應是首要懷疑對象，請參閱系統代理章節。若顯示無法連線至本機位址，請檢查核心程序、監聽連接埠和連接埠衝突；若本機連線已建立，接著才出現握手失敗或逾時，請參閱節點逾時章節。HTTP 錯誤狀態仍可能表示傳輸已連通，不能把所有非成功狀態都視為代理中斷。

確認連線已恢復，不要只看連線按鈕

確認恢復時，依相反順序檢查：核心啟動沒有錯誤、本機監聽正常、應用程式要求出現在記錄中，且目標頁面能收到回應。每次只調整一個變數，並重新測試最初失敗的連線。若同時切換節點、修改 DNS、路由和瀏覽器設定，就無法判斷是哪項調整生效，也不利於還原原本設定。確認問題已解決後，記下處理方式，並只保留必要記錄。

節點逾時：從連接埠到傳輸參數逐項檢查

逾時只表示某個操作未能在期限內完成，無法直接判斷故障位置。節點清單的延遲測試、建立傳輸連線和載入網頁，可能使用不同的測試目標與路徑。先確認是哪項操作出錯，再查看同一時間的核心記錄。單次測試失敗不足以判定節點永久失效；即使連續失敗，也應先排除本機網路變化和設定未生效的可能。

分辨連線遭拒、握手失敗與等待逾時

記錄中出現 connection refused，通常表示該位址沒有接受連線，可能是連接埠填錯、服務未監聽，也可能是中間設備主動拒絕。出現 i/o timeout 則表示等待時間已到，仍須判斷逾時的是 DNS 解析、連線撥號，還是讀取回應。看到 EOF 只能確定連線提早結束，單憑這一行不足以證明憑證錯誤，應一併分析前後的協定與握手記錄。

先檢查系統日期、時間與時區，並讓系統自動同步時間。憑證有效期限檢查和部分驗證機制都依賴時間；電腦休眠、離線或手動調整系統時間後，可能突然無法連線。接著確認目前使用的節點就是正在排查的項目，先中斷舊連線，再重新連線一次。清單中選取某個項目，不一定代表它已設為目前使用的伺服器。

接著依照服務提供者提供的設定，逐項核對伺服器位址、服務連接埠、使用者識別碼或密碼、傳輸方式和安全性設定。伺服器連接埠是遠端服務的入口，本機監聽連接埠則是應用程式連接用戶端的位置，兩者不可混用。透過訂閱匯入的項目，也可能因舊快取、群組更新失敗或手動修改，與目前的伺服器設定不一致。

只檢查目前節點實際使用的欄位

使用 WebSocket 的項目須核對路徑和 Host；路徑中的大小寫、開頭斜線和多餘空格都可能影響比對。使用 gRPC 的項目應核對服務名稱。使用 TLS 的項目須確認伺服器名稱與憑證相符，連線位址不一定就是憑證名稱。不要為了消除錯誤而直接關閉憑證驗證，這會掩蓋設定問題，也會改變連線的安全性。

VLESS 是代理協定，REALITY 則是與特定實作相關的安全機制，兩者不是同一個設定選項。排查 REALITY 項目時，須核對伺服器要求的伺服器名稱、公鑰、短識別碼和指紋等參數，並確認目前核心支援這些參數的組合。v2rayNG 和 v2flyNG 使用不同的核心系列，分享連結能匯入，不代表所有欄位都能照原設定執行。

傳輸參數較複雜時，建議重新匯入一份原始設定作比對，不要在現有項目上接連嘗試不同選項。保留原項目，並為測試項目加上容易辨識的備註，避免不慎覆蓋。不要移用其他節點的路徑、伺服器名稱或安全性參數；這些欄位通常必須搭配使用，單獨替換容易造成新的錯誤。

透過控制變因確認遠端問題

保持用戶端設定不變，先切換至另一個已確認可用的節點。如果新節點可以連線，問題較可能出在原項目的參數或遠端狀態。如果所有節點在同一個網路都無法連線，再換用另一個正常網路測試，並暫時停止其他代理或通道程式。切換網路後應重新建立連線，舊連線不會因網路出口改變而自動成為有效的比對結果。

確認位址和連接埠無誤、用戶端相容性已確認，且在不同網路上反覆測試仍失敗後，再向服務提供者詢問伺服器監聽、防火牆和帳戶狀態即可。提供失敗時間、使用的核心、已遮蔽敏感資訊的錯誤行，以及是否所有節點都失敗。不要公開完整訂閱網址、使用者識別碼、密碼或分享連結；這些資訊可能同時具備存取憑證的功能。

訂閱失敗：分別檢查取得內容與解析

訂閱更新包含取得內容、辨識格式、解析節點和寫入群組等階段。顯示更新失敗，不一定代表網址已失效，也可能是網路無法連線、收到登入頁面、格式不支援或選錯群組。先記下完整錯誤訊息，分辨是「要求失敗」還是「解析失敗」，再決定要檢查網路或內容。別一開始就刪除所有節點，以免失去可供比對的有效設定。

先保留現有群組與可用節點

在 v2rayN 開啟訂閱群組，確認要更新的群組名稱與網址相符，並檢查是否有重複群組或名稱相近的項目。如果用戶端提供匯出設定的功能，可在本機儲存備份並妥善保管；備份可能含有帳戶資訊。測試新網址時另建群組，比覆蓋現有群組更容易還原，也方便比較更新前後的節點內容。

貼上連結時，檢查開頭和結尾是否夾帶空格、換行、引號或聊天軟體附加的說明文字。不要自行刪除問號後方的查詢參數，其中可能包含驗證或格式選擇資訊。具有效期的網址可能需要重新取得，但網址很長不代表有問題。若服務提供者重新產生網址，舊網址是否仍有效，應以對方說明為準。

接著確認這次更新是透過直連還是代理。不同用戶端或介面版本的更新選單名稱可能不同，請查看該操作的實際說明。如果目前使用的代理節點已失效，透過它更新訂閱可能陷入循環；此時可在允許直連的網路上嘗試一般更新。反之，若訂閱網址只能透過可用代理存取，請先選擇已確認正常的連線再更新。

辨識伺服器回傳內容，別一再點擊更新

如果記錄中有 HTTP 狀態碼，應優先檢查與驗證相關的錯誤是否由網址或帳戶權限造成；若要求次數過多，請暫停重試並依照伺服器提示處理。即使狀態碼表示成功，也不一定取得了節點內容：網路驗證入口、登入頁面和反向代理錯誤頁，都可能回傳一般網頁。用戶端將網頁當成訂閱解析時，往往只顯示清單空白或格式錯誤，卻不會說明實際收到的網頁內容。

如需檢視回應內容，請只在可信任的本機環境操作，不要將訂閱網址貼到線上解碼或測試工具。確認回傳內容是用戶端支援的分享連結集合或訂閱格式，而不是說明頁面。瀏覽器能顯示一大段文字，只能證明內容已取得，不能證明其中所有節點協定、欄位和編碼都與目前用戶端相容。

同一份訂閱只有部分節點匯入時，請查看遭略過項目使用的協定與傳輸方式。可能是欄位缺漏、格式擴充不受支援，也可能是伺服器回傳了適用於其他設定系統的內容。請向提供者索取適用於目前用戶端的輸出格式，不要把整份其他用途的設定直接貼入單一節點匯入欄位。切換核心前也須確認協定支援情況。

檢查篩選條件、群組與更新結果

更新顯示成功，但清單仍是空的，請先清除搜尋關鍵字、切回所有群組，並確認是否啟用了節點名稱篩選或隱藏條件。接著比對記錄中的匯入數量與目前清單，不要只看狀態提示。部分用戶端會以新訂閱內容取代群組中的舊項目，因此伺服器若回傳空內容，反覆更新可能讓原有節點消失；保留備份有助於還原。

更新成功不代表連線測試也成功。選擇一個新匯入的項目作為目前節點，重新連線，再依照訂閱匯入步驟完成連線測試。如果新節點全部失敗、舊節點仍可用，應優先比對參數和輸出格式；如果只有更新失敗、現有節點仍可用，就不要同時修改節點的路由、DNS 和傳輸設定。

遇到格式相容性問題，可前往用戶端下載頁，選擇符合系統與架構的用戶端，再依照升級方式保留設定。更新程式無法解決所有訂閱問題：網址失效、帳戶權限和伺服器回傳錯誤仍須分別處理。記下取得內容的路徑、錯誤階段和最後匯入結果，下次排查就能從已確認的環節繼續。

速度慢：分辨延遲、傳輸量與停頓

「速度慢」至少包含三種不同問題：首次開啟頁面要等很久、持續下載速度偏低，以及連線一段時間後頻繁停頓。延遲測試主要反映特定要求的回應時間，不能直接代表大型檔案的傳輸速度，更不能代表所有網站的表現。先用一句具體描述記下症狀，例如「同一頁面第一次開啟很慢，重新整理後正常」，再選擇能驗證該現象的測試方式。

固定測試條件，避免比較結果失真

測試時固定裝置、網路、用戶端路由和目標服務，每次只切換一個節點。先暫停系統更新、雲端同步和其他大量傳輸工作，確認本機頻寬沒有用盡。無線網路訊號弱、路由器負載高或同時連線裝置太多，都可能讓代理看起來變慢。若直連可用的服務也變慢，應先處理本機網路，不要反覆更換核心。

每個節點測試幾次，並分別記錄偶發失敗與持續異常。目標服務可能限制單一連線速度，也可能依出口位址選擇不同的內容傳遞路徑；同一節點連線不同服務的速度有所差異並不罕見。不要用單一網站的一次測速結果推斷所有服務。測試頁面、檔案或影片時，應盡量使用相同內容與畫質。

如果節點測試顯示延遲低，但網頁載入仍然緩慢，請觀察記錄中是否有較長的 DNS 解析等待，或大量重複連線。網頁通常會同時要求多個網域，主要文件回應快，不代表圖片、指令碼和介面都經由正確路徑傳輸。瀏覽器開發人員工具有助於區分網域解析、建立連線和等待回應等階段，但請留意要求網址可能包含個人資訊。

檢查實際對外連線與裝置資源

暫時選擇明確使用代理的路由作為對照，確認速度慢的要求沒有被規則導向不適合的直連出口。如果暫時修改路由後速度明顯改善，應還原原本模式並找出特定規則，不要長期擴大代理範圍來掩蓋問題。需要登入的服務可能因出口變更觸發額外驗證，測試時應區分驗證等待時間與正常傳輸時間。

持續下載速度偏慢時，請查看系統工作管理工具中的網路、處理器和記憶體使用量。低功耗裝置在高傳輸量、複雜加密或大量連線時可能受資源瓶頸限制；處理器持續忙碌時，換用低延遲節點未必能提升速度。記錄層級若設得很詳細，也可能增加磁碟寫入和介面更新負擔，完成診斷後請還原日常使用的記錄設定。

多工複用並非適用所有節點的加速選項。它會改變連線的組織方式，實際效果取決於協定、傳輸方式、伺服器支援和連線品質。只有在設定提供者明確支援時，才逐項測試並記錄調整前後的結果。不要同時修改多工複用、壅塞相關參數和 DNS，否則即使速度改變，也無法判斷是哪項設定造成的。

間歇性停頓時，檢查網路變化

如果大量傳輸開始後停住，但小型網頁仍能開啟，應留意封包遺失、連線重設、路徑差異和伺服器限制。能夠連線不代表長時間連線一定穩定。先在另一個正常網路測試相同節點，再判斷是否需要進一步檢查路徑 MTU。不要直接照抄較小的 MTU 數值，它可能讓部分連線恢復，也可能降低效率或造成新的相容性問題。

連線一段時間後才變慢，也應檢查裝置溫度、省電模式、Android 背景限制和網路切換記錄。裝置從休眠喚醒或重新連上無線網路後，舊連線可能仍在等待結束，新連線卻已恢復正常。先重新建立用戶端連線作比對；若只有長連線失效，記下發生時間和網路切換情況，再繼續找出原因，不要直接判定整個節點無法使用。

如果多台裝置在同一時段使用同一節點時，傳輸量都下降，換用其他節點後又恢復，遠端負載或出口連線問題的可能性較高。此時應將固定條件下的重現步驟回報服務提供者。只說「測速不快」很難定位；說明目標服務、持續時間、直連是否正常，以及低延遲但低傳輸量的情況，會更有助於排查。

DNS 問題：確認由哪一端解析網域

DNS 異常常見症狀包括部分網域無法開啟、首次連線等待很久，或切換路由後結果不同。一次要求可能使用系統 DNS、瀏覽器的加密 DNS、核心內建 DNS，或將網域交由遠端處理。先確認應用程式交給用戶端的是網域名稱還是已解析的位址，再檢查對應的 DNS 解析路徑。只修改系統 DNS，不一定會影響瀏覽器或核心自行發出的查詢。

使用同一個網域檢查 DNS 解析階段

先記下無法連線的網域和錯誤訊息。系統顯示找不到主機，和 DNS 解析成功後連線逾時，是不同階段的問題。可使用以下系統指令檢查系統解析器能否回傳結果；這無法證明代理核心使用相同結果，也無法證明目標服務可連線。為排除快取影響，修改設定後應重新建立連線，並再次測試同一個網域，而不是換測另一個剛好可用的網站。

nslookup example.com

如果系統解析失敗，但透過明確指定的 SOCKS 代理連線正常，可能是代理將網域交由其他解析路徑處理。前文指令中的 socks5h 會讓 curl 將網域交給 SOCKS 端處理；使用 socks5 時，通常由 curl 先在本機解析。兩種方式適合用來比對，但本機代理收到網域後如何解析，仍取決於核心路由和 DNS 設定。

如果只有一個瀏覽器異常，請檢查瀏覽器是否啟用了獨立的安全 DNS 設定。瀏覽器可能不使用系統解析器，也可能因本身解析失敗，而根本沒有將要求送到本機代理。暫時改回使用系統 DNS 解析路徑有助於定位問題，但測試後應依實際需求決定是否保留。不要同時修改瀏覽器設定與核心 DNS，以免混淆兩個環節的問題。

確認核心 DNS 與路由的關係

核心 DNS 設定不只包含伺服器位址，也涉及查詢類型、要求經由哪個出站，以及路由比對時是否需要先解析網域取得位址。以下是用來說明欄位層級的局部 JSON：它會保留網域供初始路由判斷，不會為了比對位址規則而主動解析。這段內容不是完整的執行設定，不能直接取代用戶端產生的整份檔案。

{
  "routing": {
    "domainStrategy": "AsIs"
  }
}

在支援該欄位的 Xray 與 V2Fly 設定中，AsIs 不代表所有網域永遠不會進行解析；實際連線或其他元件仍可能需要位址。如果選擇在網域比對未命中後再解析，位址規則才有機會參與後續比對，但也會增加對 DNS 解析的依賴。應先釐清分流目標，再選擇策略，不要只因為看到 DNS 錯誤就隨意切換所有選項。

使用加密 DNS 時，也要考慮如何取得 DNS 伺服器本身的網域位址，以及連線至該伺服器的要求應走直連還是代理。若建立代理連線前必須先解析節點位址，但解析要求又依賴尚未建立的代理，就可能形成啟動循環。解決方法是為啟動階段保留可用的解析路徑，並依照用戶端對應設定的說明操作，不要一味增加更多 DNS 伺服器。

分別處理 IPv6、快取與 FakeDNS

部分網路會回傳 IPv6 位址，但通往目標的 IPv6 路徑可能不完整，造成等待一段時間才切回其他位址，或偶爾逾時。先確認裝置是否具備穩定的 IPv6 連線，再透過支援的設定比較位址家族策略。暫時改用 IPv4 可用來驗證問題，但不能因此認定所有問題都應靠停用 IPv6 解決；不同網路的結果可能截然不同。

修改 DNS 設定後，舊連線、應用程式快取和系統快取可能仍在使用舊位址。先關閉相關頁面和連線，再依照系統提供的方式清除快取；不要頻繁重新啟動整台裝置，以免掩蓋問題的重現條件。使用 FakeDNS 時，應用程式取得的虛擬位址必須由對應核心還原成網域。變更流量接管方式後，殘留的虛擬位址可能無法路由，需讓應用程式重新解析。

排查時先還原成簡單且容易判讀的 DNS 解析路徑，確認正常後再逐項加入複雜功能。記錄中應同時檢查 DNS 查詢錯誤與最後的出站資訊，避免只看見 DNS 解析成功，就忽略後續連線失敗。虛擬位址機制的原理與適用範圍可參閱FakeDNS 原理解說，相關概念也可在名詞解釋中查閱。

系統代理未生效：檢查流量接管與分流

系統代理、核心路由和透明接管是三個不同層次。系統代理會告訴支援該設定的應用程式將要求交給哪裡；路由則決定核心收到要求後要選擇哪個出站；透明接管會嘗試從其他層面導入流量。因此，將路由改為全域模式，不會讓完全忽略系統代理的應用程式自動連上用戶端。先確認要求已進入核心，再判斷它應該套用哪條規則。

核對位址、連接埠與應用程式行為

在 v2rayN 選擇自動設定系統代理後，開啟系統網路設定，確認代理位址與用戶端實際監聽位址相符。本機連線通常會指向回環位址，但連接埠須以目前設定為準。不要將遠端節點位址填入系統代理欄位，也不要將只提供 SOCKS 的連接埠當成 HTTP 代理使用。如果使用混合監聽，請確認該監聽確實支援應用程式使用的協定。

Windows 上的不同應用程式可能讀取不同的代理設定，命令列工具也不一定沿用瀏覽器設定。macOS 的代理設定與目前使用的網路服務相關，切換有線和無線連線後應重新確認。Linux 桌面環境、應用程式本身的設定與終端機環境變數也可能彼此獨立。因此，瀏覽器能用只代表瀏覽器的連線路徑正常，不能保證其他程式也正常。

部分應用程式有自己的 HTTP 或 SOCKS 設定，請優先確認是否覆蓋了系統代理。瀏覽器擴充功能、開發工具和下載工具都可能保留舊位址。終端機工具也可能讀取代理環境變數和排除清單；如果符合排除規則，要求就會繞過指定代理。排查時應確認個別程序使用的設定來源，不要只檢查系統設定頁面上的單一開關。

透過局部規則檢查比對順序與出站

確認要求已進入核心後，再檢查路由比對結果。多數規則依序比對，前方過於寬泛的規則可能讓後方精確規則永遠沒有機會執行。以下是局部規則範例，會將範例網域及其子網域導向名為 direct 的出站。只有完整設定已定義該出站標籤時才能使用；不可將此片段當成獨立設定匯入。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["domain:example.com"],
        "outboundTag": "direct"
      }
    ]
  }
}

規則顯示名稱不一定等於實際出站標籤，修改自訂規則前應先檢查產生的設定。如果應用程式先將網域解析為位址，入站資料可能只包含位址資訊，網域規則就無法比對。流量探測在部分情況下可以補上網域資訊，但也受協定與設定限制，無法保證還原所有要求的原始網域。請依據記錄確認規則是否具備所需的比對資訊。

暫時切換為全域路由後恢復正常，通常表示原有規則、解析結果或預設出站存在差異。下一步應還原原本模式，為單一故障網域新增精確的比對規則，並確認套用後是否恢復。不要直接清除所有規則或長期擴大比對範圍，否則原本應直連的區域網路服務、工作網路和本機裝置也可能受到影響。

排除多個代理設定互相覆蓋

同時執行多個代理程式時，它們可能搶用系統代理設定或本機連接埠；關閉其中一個後，另一個未必會自動重新接管。測試時只保留一個用戶端，重新套用系統代理，再確認實際位址。若啟用了透明接管或虛擬網卡模式，也應確認哪一層負責接收流量，避免形成要求循環或重複接管。

只有在確認應用程式不讀取系統代理，且確實需要接管流量時，才考慮用戶端支援的其他模式。需要權限的模式應依照平台說明授權，不要長期以管理員身分執行來取代問題定位。受管理裝置上的系統代理也可能由組織政策設定；此時本機修改可能被覆蓋，應遵循裝置管理規範，而非一再強制改寫設定。

恢復測試時，應涵蓋原本無法連線的應用程式，以及一個正常直連的服務，並確認用戶端退出後網路仍能正常使用。若只有區域網路存取異常，請檢查排除清單、監聽範圍與規則順序，不要直接開放所有入站介面。若容易混淆相關概念，可先參閱路由與 DNS 術語，再回到本章確認每項設定所屬的層次。

啟動失敗與閃退：分辨介面與核心問題

啟動故障應先分成三類：介面無法開啟、介面正常但核心退出，以及執行一段時間後整個程式關閉。這幾種狀況分別較可能與執行環境、設定或連接埠、資源與系統事件有關。先記下最後看見的介面畫面和完整錯誤訊息，不要直接刪除設定資料夾。用戶端介面仍在執行，或系統匣仍有圖示，都不代表核心已成功啟動。

檢查安裝版本與系統架構

先回到用戶端下載頁，確認選擇的版本符合平台與處理器架構。Windows 桌面版與傳統 WPF 版的介面和執行環境可能不同，請以對應下載項目的說明為準。macOS 須區分 Apple Silicon 與 Intel；Linux 則要同時確認處理器架構與發行版的套件格式，不要只因檔案副檔名相似就嘗試安裝。

如果系統提示缺少執行元件，先確認錯誤指的是哪個元件，以及目前用戶端屬於哪個版本系列，不要從不明來源複製動態連結程式庫。Linux 圖形程式也需要桌面工作階段和對應圖形環境；只有命令列環境時，圖形介面無法開啟不代表核心網路功能故障。安裝套件權限或系統安全性警告也應依照系統支援的流程處理，不要全面停用防護。

若升級後出現異常，請先完全關閉舊版本，確認背景沒有殘留程序，再啟動新版本。多個執行個體可能搶用設定檔和監聽連接埠。保留原設定備份，使用獨立測試資料夾或用戶端支援的新設定方式進行驗證；不要任意混用舊程式資料夾中的核心與新介面，否則會產生難以辨識的相容性差異。

檢查監聽連接埠是否已被佔用

記錄出現位址已被佔用或無法繫結時，應先查明佔用程序。以下以 10808 示範查詢方法，不代表每個版本都預設監聽此連接埠。Windows 指令請在 PowerShell 執行；macOS 和 Linux 是否能使用相關工具，則視系統安裝情況而定。查詢沒有結果，只能表示當下未找到對應的監聽程序；仍須重新啟動核心並查看記錄。

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

# macOS
lsof -nP -iTCP:10808 -sTCP:LISTEN

# Linux
ss -ltnp 'sport = :10808'

取得程序識別碼後，先在系統程序工具中確認程式名稱和路徑，不要直接結束不明程序。如果是舊用戶端執行個體，請正常關閉後再試；如果是仍須執行的其他服務，則可在用戶端參數設定中改用未被佔用的連接埠。修改後也要同步更新系統代理和應用程式的獨立代理設定，否則即使核心成功啟動，要求仍會送往舊位址。

如果記錄顯示設定解析失敗，應從第一個語法或欄位錯誤開始檢查。自訂 JSON 常見問題包括多餘逗號、引號錯誤、欄位層級不正確，以及出站標籤不存在。先撤銷最近一次修改，再重新產生設定。不要一次猜測並修正多處問題，也不要將記錄最後的退出提示當成根本原因，真正的錯誤通常出現在更前面的記錄。

排查執行中的退出與資源問題

若執行一段時間後才閃退，請記下故障發生前是否剛更新訂閱、切換網路、喚醒系統或開啟詳細記錄。檢查磁碟剩餘空間、記憶體使用情況和設定資料夾是否可寫入。同步軟體同時修改設定檔、資料夾權限變更或磁碟寫入失敗，也可能導致異常。避免將目前使用的設定放在多個程式會同時修改的位置。

如果介面已退出但核心仍在執行，請先正常結束相關執行個體，再清除系統中指向舊監聽位址的代理設定。只刪除桌面捷徑不會終止背景程序。如果系統有提供當機事件記錄，可依故障時間查找相關事件，並記下異常模組和錯誤類型；分享記錄前請遮住使用者名稱、個人路徑，以及可能含有節點參數的命令列內容。

如果在乾淨的測試設定中可以正常啟動，但還原舊設定後就一定出錯，請分批還原訂閱群組、自訂路由、DNS 和其他擴充設定。如此才能找出觸發問題的條件，而不是一次搬回所有舊設定。連接埠衝突的詳細處理方式，可參閱找出衝突程序並修改監聽連接埠。

Android 專項：權限、背景執行與分應用代理

Android 上的 v2rayNG 和 v2flyNG 通常透過 VpnService 接收應用程式流量，系統連線授權、背景執行策略和分應用規則都會影響實際效果。連線按鈕顯示執行中，只代表啟動流程已進入相應階段；仍應檢查系統連線圖示、通知和用戶端記錄。先分辨問題是在剛啟動時發生、鎖定螢幕後斷線，還是只有部分應用程式無法使用。

確認 VpnService 授權與目前連線由哪個應用程式管理

首次連線時，系統會詢問是否允許應用程式建立 VPN 連線，請確認授權對象是目前使用的用戶端。如果沒有跳出對話框或立即返回，請檢查是否有其他系統介面遮住提示，或裝置管理政策是否限制連線。不要快速重複點擊啟動按鈕，否則授權、停止和重新啟動等操作可能交錯，讓記錄難以判讀。

同一個系統使用者通常只能有一個應用程式負責目前的 VPN 連線。其他使用相同介面的網路工具可能取代現有連線；反過來說，啟動 v2rayNG 也可能讓另一條連線中止。排查時先停止其他同類工具，再啟動目標用戶端，並確認系統顯示的連線應用程式。不要同時執行 v2rayNG 與 v2flyNG 來比較節點，應分開測試。

如果系統啟用了永遠開啟 VPN，或阻止未經 VPN 的連線，停止用戶端後可能連直連也無法使用。這不代表訂閱自動損壞，而是系統政策仍在限制流量。請檢查系統 VPN 設定中的目前應用程式和相關選項，依實際需求調整。工作資料與個人資料可能套用不同的管理規則，應在發生問題的資料空間內檢查。

鎖定螢幕後斷線，先檢查省電與數據限制

如果螢幕開啟時可用，鎖定一段時間後就失效，先查看用戶端程序是否仍在執行、通知是否消失，以及記錄是否中斷。系統省電策略可能限制背景網路，甚至結束程序。請允許目前用戶端在背景執行，或設定合適的電池使用策略，並檢查裝置製造商提供的自動啟動與背景管理選項；各系統的選單名稱不同，請以裝置目前介面為準。

允許背景執行不代表所有網路條件都已放行，還要檢查背景數據和數據節省設定。如果無線網路可用、行動網路卻失敗，請確認用戶端和目標應用程式都獲准使用該網路。調整後重新連線，再鎖定螢幕，以相同等待時間和同一個應用程式重新測試。解鎖後恢復正常，不能證明背景問題已解決，因為應用程式可能在回到前景時才重新建立連線。

如果通知仍在，但網路已切換，可能是舊連線尚未及時恢復。先記下無線網路與行動網路切換時間，再中斷並重新啟動連線作比對。如果重新連線後立刻恢復，應優先檢查網路切換後的復原流程，不要不斷更換 DNS。裝置進入深度省電、訊號暫時中斷或切換無線基地台，都可能影響既有長連線。

確認分應用清單的設定模式

啟用分應用代理後，先確認目前模式是只有勾選的應用程式經過代理，還是勾選的應用程式繞過代理。同一份勾選清單在兩種模式下結果正好相反，不能只看應用程式是否已勾選。調整後應重新建立用戶端連線，並完全關閉目標應用程式再重新開啟，以免沿用舊連線路徑。新安裝的應用程式是否自動納入範圍，也取決於目前模式。

部分服務會呼叫系統元件、下載服務或獨立的登入程序，實際網路要求未必都由眼前的應用程式送出。排查時可暫時停用分應用限制，確認完整接管是否正常；若恢復正常，再逐步縮小範圍。不要只因主要應用程式能開啟首頁，就認定所有功能都正常；登入、附件下載和媒體播放可能使用不同的連線路徑。

從 v2rayNG 切換到 v2flyNG 時，須重新確認系統授權、分應用設定和協定相容性。兩者分別採用 Xray 與 V2Fly 核心路線，不能假設所有擴充參數都通用。優先選擇符合節點需求的用戶端，先測試一個明確支援的項目，再還原自訂設定。安裝入口與架構選擇請參閱Android 用戶端下載。