V2Ray 疑難排解指南

無法上網：先拆解連線流程

用戶端顯示正在執行，只代表介面進入某種狀態，不等於瀏覽器請求已透過節點傳送。先記錄問題範圍：所有應用程式都無法使用，還是只有瀏覽器；所有網站都打不開，還是只有特定網域；關閉用戶端後，一般直連是否恢復。這三組比較分別對應系統網路、應用程式接入與目標服務。測試時固定使用一個平常能正常開啟的 HTTPS 網頁，避免不斷更換目標，讓網站本身的異常干擾判斷。

建立最精簡的測試環境

先結束其他代理程式，暫停瀏覽器代理擴充功能，關閉 TUN，只保留 v2rayN 一般的本機代理入口。選擇一個參數完整的節點，確認它是目前使用中的伺服器，再檢查主視窗日誌是否顯示核心已正常啟動。如果尚未完成初次設定，請勿從進階路由著手，先回到快速入門教學完成基本連線。結束其他程式是為了排除連接埠衝突與重複接管，不是要求長期改變使用習慣。

開啟參數設定，記下本機 SOCKS 或混合監聽的實際連接埠。本頁命令中的 10808 僅適用於該連接埠確實提供 SOCKS 服務的情況；若已變更連接埠，命令也要一併更新。監聽位址為 127.0.0.1 時只接受本機請求，這是一般本機使用方式。不要為了修復本機瀏覽器而開放區域網路連線，也不要將監聽位址改成所有網路介面，避免不必要地擴大可連線範圍。

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

這個命令會明確使用本機 SOCKS 代理，並將目標網域交由代理端解析，適合用來避開瀏覽器代理設定，對照連線流程。Windows 若沒有可直接使用的同名命令，可在終端機執行 curl.exe。收到 HTTP 回應代表請求至少已到達某個回應端；若狀態碼不是成功頁面，也不必立刻判定代理失效。憑證錯誤、連線遭拒與連線逾時屬於不同層級，請保留完整錯誤訊息，不要只記下「打不開」。

依結果選擇下一步

同時查看日誌：執行命令的時間附近是否出現對應的目標請求。如果沒有日誌，先確認目前日誌層級足以記錄存取，再核對命令是否指向正在執行的執行個體。若看得到目標，但出站標籤與預期不同，請檢查路由命中結果及最終預設出站。暫時改用「全部經代理」的路由進行比對，可以縮小問題範圍；測試結束後請還原原本策略，不要把切換模式當成所有問題的固定解法。

只有特定網站無法使用時，請比較同一節點下的其他目標，以及同一目標下的其他節點。單一網站回傳拒絕存取、驗證碼或地區提示，通常表示應用層連線已建立；繼續更改本機監聽連接埠無法解決目標端限制。若瀏覽器顯示憑證日期異常，先檢查系統時間與時區。不要關閉憑證驗證來掩蓋錯誤，也不要把任何能顯示頁面的連線都視為安全無虞。

節點逾時：分辨探測與實際連線

清單中的逾時不代表單一類型的問題。有些測試只檢查 TCP 連接埠是否可連，有些會透過節點請求指定網址，還有些結果會受測速目標、交握流程與本機 DNS 影響。先確認執行的是哪一種測試，再以一般網頁瀏覽重現問題。TCP 可連只代表該位址有服務回應，無法證明通訊協定參數、驗證資訊與傳輸設定都正確；探測逾時也可能只是測試目標無法使用，不代表整個節點失效。

依序核對位址、連接埠與交握設定

開啟目前節點的編輯視窗，先核對伺服器位址、連接埠與通訊協定，再檢查傳輸方式、TLS、伺服器名稱及相關傳輸欄位。訂閱匯入的設定應優先與服務提供者提供的原始參數比對，不要根據節點備註猜測設定。備註只是顯示名稱，可任意命名，不能代表實際通訊協定或線路。複製位址時留意前後空格、全形標點與換行；連接埠欄位應填數字，不要混入通訊協定前綴或網址路徑。

如果伺服器位址是網域，用戶端必須先解析出入口位址，才能建立遠端連線。若日誌在連線至目標伺服器前就顯示解析失敗，應先檢查節點網域的解析，而不是更改目標網站的分流規則。可在系統終端機查詢伺服器網域，並比較目前網路與另一個可信網路的結果。不要把查到的特定位址永久寫死當成通用解法，入口可能會配置多個位址並進行調度，固定位址可能避開後續更新。

Test-NetConnection -ComputerName example.com -Port 443

以上是 Windows PowerShell 檢查 TCP 連線的語法範例，示範網域並非可用節點。排查時請使用實際節點位址與服務連接埠；此命令不會進行代理通訊協定驗證，也不會測試 UDP 傳輸。若 TCP 測試成功，但用戶端交握失敗，請優先檢查 TLS 伺服器名稱、傳輸路徑、驗證欄位與裝置時間。REALITY 設定應逐項對照服務提供者提供的伺服器名稱、公鑰與短識別碼，不要靠隨機修改欄位碰運氣。

交叉測試，縮小問題範圍

選兩個原本可用的節點，分別在目前網路連線；再讓同一個節點透過另一個網路連線。若所有節點只在一個網路失效，較可能是本機網路、路由器或網路路徑問題；若某個節點在多個網路都持續失敗，則較可能是遠端服務或該節點設定有誤。切換網路時維持目標網址與用戶端設定不變，避免同時更換核心、通訊協定與路由。使用手機熱點可能消耗行動數據，請控制請求量，不必下載大型檔案。

日誌中的 connection refused 常見原因是目標連接埠沒有服務或明確拒絕連線；timeout 只表示等待時間已超過期限，無法直接判定是哪一端丟棄資料；EOF 或連線重設表示連線提前結束，還要配合它發生在撥號、TLS 交握或驗證之後來判斷。將錯誤中的目標位址與使用中的節點比對，避免把訂閱更新或背景探測產生的日誌看錯。連續重試只會增加雜訊，找出同一請求前後幾行日誌更有幫助。

若電腦從睡眠恢復，或網路從有線切換至無線後才開始逾時，先停止連線再重新啟動核心，讓舊連線與舊路由結束。必要時關閉後重新開啟用戶端，不要直接刪除所有伺服器。網路變更後，長連線可能仍沿用已失效的路徑，重新建立連線即可解決這類問題。若重啟後只短暫恢復，請記錄中斷所需時間，以及是否與螢幕休眠有關，再檢查網路省電與背景執行策略；不要把短暫恢復誤認為遠端問題已修復。

訂閱失敗：分開檢查下載與解析

訂閱更新分為兩個階段：用戶端先向訂閱網址發出請求，再解析回應內容中的節點。下載失敗、回傳空內容、格式無法辨識與節點重複，應分別處理。按下更新後沒有新增節點，不一定是網路問題，也可能是內容沒有變更、群組篩選隱藏了結果，或訂閱只包含目前核心不支援的欄位。先保存現有可用設定，記下目前群組名稱與節點數量，再進行更新；不要清空清單來驗證網址是否有效。

確認訂閱入口與網址類型

在 v2rayN 的訂閱群組設定中檢查對應群組的 URL，確認複製的是完整訂閱連結，而不是登入頁、購買頁或單一節點分享字串。在 v2rayNG 中進入訂閱設定，確認該筆訂閱的網址與啟用狀態，再執行更新。單一節點分享連結與可回傳多個節點的訂閱網址用途不同；將前者貼到只接受訂閱 URL 的欄位，可能會顯示不支援的網址或空白內容，重複按下更新也不會改變格式。

連結中的查詢參數通常用來識別訂閱帳戶，漏掉尾端內容可能讓伺服器回傳登入頁或錯誤訊息。聊天工具與筆記應用程式可能在換行、標點或自動辨識連結時截斷網址，請從原始入口重新複製。檢查時只在本機查看完整內容，截圖時應遮住參數。瀏覽器能開啟網址，只能表示瀏覽器透過自己的網路路徑取得回應，不能證明用戶端使用相同代理或請求標頭，也不能證明回應內容是節點資料。

先查看更新日誌中的 HTTP 狀態。驗證失敗時，檢查連結是否已失效或權限是否變更；若請求過於頻繁，請停止連續點擊，並依服務提供者的更新限制等待；伺服器錯誤則記下時間，稍後再試。狀態成功但解析失敗時，回應內容可能是網頁、存取提示或其他設定格式。不要將完整回應貼到公開的轉換工具，訂閱網址與節點驗證欄位都可能因此外洩。格式轉換應採用來源明確且可在本機處理的方式。

確認更新請求使用哪條網路路徑

部分用戶端允許訂閱更新時選擇直連或經代理，不同版本的選項位置與預設行為可能不同，請以目前版本的設定與日誌為準。當現有節點已失效，而更新又依賴該節點時，就會形成循環：需要更新才能恢復連線，卻必須先連線才能更新。可以先嘗試直連更新；若該網址只能經代理存取，則暫時使用已確認可用的連線。一次只切換更新路徑，不要同時更改訂閱網址，才能判斷哪項變更有效。

若顯示 TLS 或憑證異常，先確認裝置時間、系統憑證環境與網址拼寫。公司或學校網路，以及需要登入的公共網路，可能會回傳驗證頁面；請先在瀏覽器完成網路登入，再更新訂閱。不要忽略憑證錯誤來處理訂閱問題。訂閱內容會影響後續遠端連線，來源正確與否比是否成功下載更重要。若網址發生重新導向，可向服務提供者確認最終入口是否變更，不要直接將陌生的中繼網址替換進設定。

若已成功取得內容但節點清單仍是空的，請檢查群組篩選、搜尋條件、去重選項與節點類型。有些訂閱內容是提供給其他設定系統使用，副檔名相似不代表可以直接匯入。部分欄位也需要特定核心功能支援，舊版核心可能在解析或啟動時拒絕這些欄位。先更新符合系統架構的用戶端，再重新匯入原始訂閱；不要手動刪掉所有看不懂的欄位，否則可能留下可儲存卻無法驗證的殘缺節點。

成功更新一次後，確認使用中的節點是否仍在、路由設定是否引用舊群組，以及自動選擇是否已切換伺服器。名稱重複不一定代表位址相同，名稱變更也不代表服務端一定有變動。更詳細的操作方式與格式差異，請參閱訂閱連結匯入步驟。若要向他人說明問題，提供回應狀態、解析錯誤與用戶端名稱即可，避免分享可直接使用的訂閱 URL。

速度慢：分辨延遲、傳輸量與抖動

「速度慢」至少包含三種情況：網頁開始回應前等待很久、下載持續速率偏低，以及連線速度忽快忽慢。清單上的單一延遲數值無法反映完整使用體驗。先確認瓶頸出現在建立連線階段，還是持續傳輸階段，再比較相同時段、相同目標與相同網路。短時間內反覆切換數十個節點，不但難以取得可比較的樣本，也可能觸發目標服務的速率限制；少量且有控制的比較，通常比大規模自動測速更能找出問題。

先建立直連基準

暫停系統更新、雲端硬碟同步與其他大量傳輸工作，確認 Wi-Fi 訊號與本機網路正常。關閉用戶端後，連線至平常可以直連的服務，觀察速度是否同樣緩慢；若基準狀態已異常，應先處理本機頻寬占用、無線干擾或路由器負載。基準測試只能反映網路接取狀態，不能據此推估節點的實際速度。下載測試也會消耗服務流量；若訂閱有流量額度限制，建議選擇時間短且可中止的測試，並事先了解計費方式。

接著固定使用同一個節點，重複開啟相同頁面，區分首次造訪與後續造訪。第一次較慢、之後正常，可能與 DNS、TLS 建立連線或連線重複使用有關；每次都很慢，則應檢查日誌是否頻繁重新連線，以及目標位址是否反覆變動。瀏覽器開發人員工具可協助分辨等待第一個位元組與下載內容的時間，但網頁本身的指令碼和廣告請求也會影響載入時間。測試代理路徑時，不要只用複雜網頁的完整載入時間作為判斷依據。

逐層排除額外路徑與資源競爭

檢查應用程式是否同時使用瀏覽器代理擴充功能、系統代理與 TUN，以及是否還設定了額外的前置代理。多層路徑可能增加交握時間，也可能形成迴圈。先只保留一種明確的接入方式，再測試相同請求。若一般系統代理正常、TUN 卻較慢，請優先檢查虛擬網卡路由、DNS 接管及其他網路軟體衝突，不要立即更換所有節點。本機到節點的路徑與節點到目標服務的路徑，都可能成為效能瓶頸。

觀察核心程序的 CPU、記憶體與網路使用量，尤其是在小型裝置、大量並行連線或複雜路由規則下。資源使用量偏高時，先減少同時執行的工作與不必要的偵錯日誌，再重新測量。不要把隨意開啟連線重複使用、關閉加密驗證或加入不明參數當成加速方法。連線重複使用是否有幫助，取決於通訊協定、服務端支援與連線型態；設定不相容反而可能增加失敗率，應先確認連線穩定且相容性無虞，再調整效能。

若下載一開始正常、幾秒後便持續變慢，請比較不同目標與不同時段，確認是否遇到目標限速、服務流量政策或共享線路壅塞。若所有目標在相同時段都變慢，記下時段後再換一個節點比較；若只有一個下載來源異常，即使更換節點也未必有用。測速網站可能選用不同伺服器，結果不一定等同於日常應用程式的體驗。可以使用同一來源的同一個檔案進行短時間比較，但排查時不必下載來源不明的大型檔案。

使用 UDP 的應用程式與網頁採用的 TCP 路徑，表現可能不同。網頁正常但即時通訊卡頓時，請確認該通訊協定、節點與接入方式是否支援所需的 UDP 流量，再觀察封包遺失與網路切換情況。不要只因某項功能較慢，就啟用所有流量接管功能。MTU 不合適可能造成部分連線停滯，但沒有證據時不應任意調低；若只有在 TUN 下大型回應卡住，請保留原值，以小幅度、單一變數方式測試，沒有改善就立即還原。

連續使用一段時間後才開始變慢，還要檢查裝置溫度、省電模式、背景工作與日誌檔案是否持續增加。電腦長時間喚醒後，可以重新建立連線作為比較，但重新啟動只能用於定位問題。若問題能穩定重現，請記錄觸發條件，不要每次都反覆重啟。討論「哪個核心比較快」之前，先確認兩次測試使用相同的節點參數、路由與目標；否則結果往往只是網路狀況不同，無法證明核心效能有差異。

DNS 問題：先確認由哪個元件解析

排查 DNS 的第一步不是更換公共 DNS 位址，而是確認由哪個元件發出查詢。系統解析器、瀏覽器的加密 DNS、用戶端核心 DNS 與 TUN 接管可能同時存在。節點伺服器網域與最終網站網域也涉及兩次不同的解析：前者用來找到代理入口，後者用來連線至目標。入口無法解析時，即使目標網域的 DNS 設定正確，也無法連線；混淆這兩段流程，只會越改越多設定，問題卻依然存在。

透過可控制的請求比較解析位置

先記下錯誤訊息中的網域與發出請求的程序，判斷問題出在訂閱網址、節點入口還是目標網站。系統終端機的查詢只能測試系統目前使用的解析路徑，不代表瀏覽器或核心的實際結果。若瀏覽器正常、其他程式失敗，請檢查瀏覽器是否啟用獨立的加密 DNS；若明確指定代理後正常、直連卻異常，問題可能出在系統解析或直連網路。比較時固定使用相同目標，不要拿另一個網域的成功結果取代目前網域的診斷。

nslookup example.com

curl --proxy socks5://127.0.0.1:10808 --connect-timeout 10 --head https://example.com/
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --head https://example.com/

兩個代理命令的差異在於目標網域在哪裡解析：socks5 通常由本機先解析，socks5h 則將網域交由代理端解析。若後者成功、前者失敗，可優先檢查本機解析；兩者都失敗，則繼續查看遠端連線與核心日誌。命令中的本機連接埠仍須與實際設定相符。這項比較無法證明所有應用程式都採用相同方式，應用程式可能自行解析，也可能直接使用快取位址。

檢查 DNS 的連線路徑與路由關係

在 v2rayN 中找到 DNS 與路由設定，先確認目前設定值，再判斷 DNS 請求本身應該直連還是經代理。設定遠端加密解析時，也必須確保能連到解析服務，不能假設填入位址就會自動建立可用路徑。如果解析服務的網域又依賴尚未建立的同一條代理連線，可能形成啟動依賴迴圈。應分別驗證入口解析、解析服務可連線性與目標查詢結果，不要一次替換所有解析項目。

以下是 V2Ray 相容設定中常見的 DNS 欄位結構，可用來了解伺服器與查詢策略的用途，並非可直接匯入的完整節點設定。圖形用戶端可能在啟動時重新產生設定，請透過對應的設定介面修改，不要直接編輯執行中的暫存檔案。不同核心與用戶端支援的擴充欄位並不相同；若日誌顯示欄位未知或策略無效，請回到目前核心支援的設定範圍，不要照抄其他系統的完整設定。

{
  "dns": {
    "servers": [
      "1.1.1.1",
      "8.8.8.8"
    ],
    "queryStrategy": "UseIP"
  }
}

查得到位址，不代表該位址一定可用。檢查結果是否同時包含 IPv4 與 IPv6，並確認目前網路確實能透過相應的 IP 位址類型連線。若只有回傳 IPv6 時才失敗，可暫時使用僅 IPv4 的查詢策略進行比較，再決定是否修復本機 IPv6 路徑。不要把永久停用 IPv6 當成預設建議，也不要只因單一網站異常就修改整個系統的設定。路由中的網域比對與解析後的位址比對可能產生不同結果，也應一併確認最終出站。

修正解析路徑後再清除快取，否則錯誤結果很快又會進入快取。Windows 可使用 ipconfig /flushdns 清除系統 DNS 快取，但此命令不會清除瀏覽器、核心與所有應用程式的個別快取。完成調整後，重新啟動相關連線或應用程式，再重複相同測試。使用 TUN 虛擬位址映射時，舊連線可能仍沿用先前的映射，不宜把切換前後混在一起的日誌當成結論。先停止連線，再以全新的測試工作階段檢查。

系統代理無效：檢查應用程式的接入方式

系統代理是系統提供給應用程式的一組代理設定，不會強制接管所有網路流量。有些應用程式會讀取系統設定，有些使用自己的設定，也有些終端機程式只讀取環境變數。TUN 則透過虛擬網卡與路由接入流量，兩者不是同一個開關。先判斷需要接入的應用程式採用哪種方式，再選擇對應設定；不要因為某個程式沒有使用系統代理，就認定節點或核心已失效。

先驗證連接埠，再檢查系統設定

先關閉 TUN，使用本頁第一章的明確代理命令驗證本機入口。如果該請求也失敗，請回頭排查核心與節點，不要繼續調整系統設定。明確指定代理後若可正常連線，請在 v2rayN 的系統代理選單選擇自動設定系統代理，再開啟作業系統的網路代理頁面，確認位址與連接埠是否和用戶端一致。有些用戶端入口同時支援 HTTP 與 SOCKS，另一些則分開監聽；不要把只提供 SOCKS 的連接埠填入只接受 HTTP 代理的欄位。

寫入設定後，結束並重新開啟測試應用程式，讓它重新讀取代理設定。瀏覽器擴充功能、應用程式內固定代理與組織管理政策都可能覆寫系統值，測試前應先暫停這些設定。若系統欄位又被改回舊連接埠，請檢查是否有其他網路程式仍在背景執行；若裝置受管理，也可能是政策定期還原設定。不要反覆修改登錄檔或持續搶寫設定，先找出設定來源，才不會在用戶端結束後留下失效代理。

區分路由規則問題與應用程式未接入

日誌中看不到目標請求時，較可能是應用程式尚未接入；若看得到請求但顯示直連，則應檢查路由規則、略過清單與預設出站。系統代理的例外清單也可能讓本機位址或特定網域略過代理，這與用戶端內部路由是兩道不同的判斷。測試時可暫時移除對應的自訂例外，但不要刪除所有系統預設項目。若涉及區域網路裝置、印表機服務與內部網域，請先確認預期路徑，避免修復網頁連線的同時影響本機服務。

若終端機工具不使用系統代理，可先用單次命令參數驗證；確認有效後，再決定是否設定代理環境變數。環境變數可能只影響目前終端機及之後啟動的子程序，已執行中的應用程式未必會更新；有些工具還會區分大小寫及不同通訊協定的變數。排查完成後請刪除臨時變數，避免用戶端關閉後終端機仍指向沒有監聽的本機連接埠。不要在公開指令碼或命令歷程說明中放入含帳戶資訊的代理網址。

單獨啟用 TUN，單獨驗收

只有明確需要接入不讀取代理設定的應用程式時，才測試 TUN。先保存目前路由，依用戶端提示授予必要權限，並確認虛擬網卡已成功建立。權限不足、殘留網卡、其他隧道程式與網路過濾軟體都可能妨礙流量接管。用戶端連往節點的流量必須正確繞過接管路徑；自動路由錯誤可能會將流量再次送回虛擬入口，形成迴圈。請使用用戶端支援的預設策略驗證，不要直接加入範圍過大的靜態路由。

若啟用 TUN 後連本機網路也無法使用，請立即關閉 TUN，檢查預設路由、DNS 與區域網路略過設定。切換網路或從睡眠恢復後，舊網卡索引或路由可能失效；重新建立連線有助於判斷問題。接管尚未停止前，不要手動刪除所有虛擬網卡；請先讓用戶端正常停止，再檢查是否有殘留項目。若必須還原系統網路，先記錄原始設定，只撤銷這次修改，避免清理命令影響其他正常使用的網路服務。

用戶端當機：分辨介面與核心問題

介面無法開啟、介面閃退，以及介面正常但核心停止，是三種不同問題。圖形用戶端負責管理設定與啟動程序，核心負責處理連線；其中一個正常，並不能證明另一個也正常。先觀察問題發生於程式啟動、選擇節點、更新訂閱或啟用 TUN 的哪個時刻，並記錄是否每次都能重現。不要一開始就刪除整個使用者目錄，因為日誌、訂閱與設定可能都在其中；刪除後不但會失去線索，也更難復原。

先檢查安裝與執行環境

從下載頁重新確認作業系統與處理器架構。macOS 請區分 Apple Silicon 與 Intel；Linux 請確認架構與套件格式；Windows 則應依目前系統條件選擇 v2rayN 桌面版或傳統 WPF 版。不要將某平台的程式目錄複製到另一個平台繼續使用。壓縮檔形式的程式應完整解壓至可寫入的位置後再執行；直接從壓縮檔瀏覽視窗啟動，可能造成相依檔案或工作目錄不完整。

安裝程式與免安裝版本對執行階段的要求可能不同，請以安裝提示與目前版本說明為準，不要從不明來源下載單一相依檔案。若系統安全軟體提示隔離，先查看偵測紀錄、檔案來源與處理原因，不要把關閉所有安全防護當成通用解法。程式若放在受保護目錄、唯讀媒體或由同步工具管理的資料夾，也可能無法寫入設定。可在使用者可寫入的目錄建立獨立測試環境，原有目錄則保持不動。

核心啟動失敗時，先找第一則相關錯誤

在 v2rayN 主視窗查看核心日誌，依啟動時間找出第一則錯誤，不要只看最後一行「程序已結束」。常見原因包括連接埠遭占用、設定格式錯誤、核心檔案遺失、參數不相容與權限不足。存取日誌與啟動日誌用途不同：前者描述請求，後者說明程序為何無法進入工作狀態。更詳細的錯誤排查方式請參閱核心啟動失敗日誌診斷；查閱時仍應以本次日誌中的實際欄位為準。

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

以上命令用於在 Windows PowerShell 查看指定 TCP 連接埠的監聽程序，請將連接埠替換成實際值；部分環境可能需要相應權限。取得程序編號後，先在工作管理員確認它屬於哪個程式，不要直接結束不明的系統程序。若是另一個用戶端執行個體，正常結束多餘的執行個體即可；若該連接埠必須由其他服務使用，可更改此用戶端的監聽連接埠，並同步更新系統代理與應用程式設定。只改監聽連接埠而未更新入口，會造成新的「無法連線」問題。

設定錯誤應依日誌提供的欄位路徑處理。自訂 JSON 中多餘的逗號、錯誤的引號、欄位型別或不支援的參數，都可能導致核心拒絕啟動；圖形介面產生的設定則應優先回到相關設定頁面修正。暫存設定通常會在下次啟動時被覆寫，不應將修改暫存檔案當成長期解法。若要了解欄位間的關係，可參閱設定檔結構解析，但不要用文章中的片段直接覆寫整份現有設定。

逐步還原，不要覆蓋所有狀態

若介面持續閃退，先備份設定與日誌，再使用獨立使用者目錄或用戶端支援的新設定環境啟動。空白環境可以正常啟動，表示問題較可能來自現有設定、視窗狀態或匯入內容；若仍然失敗，再檢查安裝、相依項目與系統事件。復原時先加入一個節點並驗證，再恢復訂閱、路由與其他設定，每個步驟都單獨測試。一次匯入全部備份，可能連觸發問題的設定也一併恢復。

更新程式前，請正常結束介面與核心，不要在程序仍執行時直接覆寫檔案。發生問題後可保留舊目錄以便回復，但不同版本之間不一定相容，應先複製再嘗試讀取。不要為了修復單一啟動錯誤而頻繁切換 Xray 與 V2Fly；先確認節點所需功能與目前核心相容。回報問題時附上系統、架構、操作步驟與已遮蔽敏感資訊的錯誤訊息，隱藏節點驗證資料、訂閱網址及個人目錄名稱。

行動裝置疑難排解：權限、背景執行與網路切換

Android 優先使用 v2rayNG；需要 V2Fly 核心相容方案時，可改用 v2flyNG。兩者的操作介面與可用參數不一定完全相同，請依目前使用的用戶端確認。行動裝置比桌面更容易受到電池管理、應用程式範圍與網路切換影響。先區分從未連線成功、螢幕亮起時正常但鎖定後中斷，以及 Wi-Fi 正常但行動數據失敗這三類情況，再依對應流程排查，不要把所有問題都歸咎於節點不穩定。

連線權限與目前使用中的設定

首次啟動連線時，系統通常會要求授權建立 VPN 連線；若拒絕授權或受到裝置政策限制，介面可能仍顯示已啟動，但實際上沒有接管流量。請重新發起連線並閱讀系統提示，確認目前應用程式已獲得授權。系統 VPN 圖示只能表示連線服務處於某種啟用狀態，不代表遠端一定可連線。請確認已選取使用中的伺服器、核心回報啟動完成，再使用內建連線測試或固定網頁驗證；不要只依通知列文字下結論。

Android 的 VPN 服務通常無法讓多個同類應用程式同時各自接管流量。若另一個網路過濾、隧道或代理應用程式正在使用這項服務，請先正常停止，再啟動目前的用戶端。若系統為舊應用程式啟用了永遠開啟 VPN 或封鎖未經 VPN 的流量，也可能讓切換後的網路行為異常。進入系統 VPN 設定確認目前連線所屬的應用程式，不要在未確認前刪除其他應用程式資料；測試結束後依原用途還原設定，避免無意間改變裝置的網路政策。

只有部分應用程式失效時，檢查接管範圍

在用戶端的應用程式代理或分應用程式設定中，確認目前選的是「僅代理所選應用程式」，還是「略過所選應用程式」。兩種清單的意義相反，選取圖示不一定代表流量會進入代理。先選一個明確的測試應用程式，停止後重新啟動連線，讓應用程式範圍設定重新生效；必要時完全結束並重新開啟測試應用程式。如果該應用程式使用獨立 DNS、固定位址或自有網路元件，也應透過日誌確認請求是否進入用戶端，不能只因瀏覽器正常就推斷所有應用程式都已接入。

鎖定螢幕後中斷時，先檢查系統電池管理、背景執行與自動啟動權限。不同裝置的設定名稱可能不同，請以允許目前用戶端在背景維持連線為目標，不要直接關閉整個系統的省電功能。保留用戶端的執行通知，觀察服務是否遭系統停止；通知消失、程序重新啟動與遠端逾時是不同的證據。可在同一網路與同一節點下，分別測試螢幕亮起和鎖定時的情況，記下多久後發生問題，再決定是否調整電池最佳化例外。

分別驗證網路切換與行動數據

從 Wi-Fi 切換至行動數據後，既有連線可能失效，DNS 與入口位址也可能改變。先停止連線，確認手機本身已連上可用網路，再重新啟動用戶端。需要網頁登入的公共 Wi-Fi，應先完成網路驗證；尚未驗證的網路可能將請求重新導向登入頁，造成訂閱更新與連線同時失敗。若只有行動數據異常，請確認目前 SIM 卡的數據權限、流量限制，以及用戶端是否允許使用行動數據，不要先修改節點通訊協定。

部分行動網路主要提供 IPv6 或採用位址轉換，不能只憑桌面上的 IPv4 測試結果判斷手機的連線路徑。記下用戶端日誌中的 IP 位址類型與解析錯誤，再比較同一節點在 Wi-Fi 與行動數據下的表現。系統的私人 DNS 設定也可能影響入口解析；可暫時改回系統自動解析進行比較，測試後再還原原設定。不要同時修改接取點、DNS 與節點欄位，否則即使問題消失也無法判定原因，還可能影響原本正常的數據連線。

安裝失敗時先確認套件架構與系統安裝提示。較新的主流裝置通常可選擇 arm64；若不確定，請依Android 下載說明選擇合適的下載項目。通用套件檔案可能較大，但不代表連線能力更強。更新時請保留同一用戶端的設定備份，不要用 v2rayNG 的完整備份覆寫 v2flyNG，反之亦然。跨裝置移轉時，優先使用相容的訂閱或節點分享方式；相關限制請參閱電腦與 Android 設定移轉。

最後依序確認「應用程式已納入接管範圍、核心收到請求、節點成功連線、目標回傳回應」。若桌面與手機在同一個 Wi-Fi 網路使用同一節點，卻有不同結果，請優先比較權限、分應用程式範圍與 DNS；若兩端都失敗，則回頭檢查節點與網路路徑。尋求協助時提供系統版本、用戶端名稱、網路類型、是否與鎖定螢幕相關，以及已遮蔽敏感資訊的錯誤訊息即可。保留可重現的最小測試情境，比不斷更換不同用戶端更容易定位真正的問題層級。