V2Ray 故障排除
連線、訂閱與系統代理

無法上網：先確認連線在哪一段中斷

所有網頁都無法開啟時，先別刪除設定。一次連線通常會經過應用程式、流量接管入口、本機核心、遠端伺服器與目標網站。介面顯示已啟動，只代表用戶端進入運作狀態，不能證明每個環節都正常。先關閉其他代理工具、暫停 TUN，再將系統代理設為「清除系統代理」。接著開啟平時可直接連線的網站，確認基礎網路、無線網路驗證與預設閘道仍正常。

先恢復直接連線，再檢查本機監聽

清除代理後仍無法連線，先確認網路是否需要透過網頁登入、系統時間是否正確，以及同一網路上的其他裝置是否正常。此時反覆更換節點通常無濟於事。若直接連線已恢復，再啟動 v2rayN、選擇既有伺服器並執行「重新啟動服務」，查看日誌是否出現核心結束、設定解析失敗或監聽失敗。別只看系統匣圖示；視窗仍開著但核心已結束時，瀏覽器連到的可能是不存在的本機服務。

開啟「設定」中的「參數設定」，記下「本機混合監聽連接埠」。以下指令以實際設定為 10808 為例；若連接埠不同，請先修改指令。先確認是否有程序正在監聽，再核對所屬程序；不能把任何占用該連接埠的程式都當成正確的核心。監聽成功只代表本機入口已建立，還要進一步測試遠端連線。

# Windows PowerShell：查看監聽位址、連接埠與所屬程序
Get-NetTCPConnection -LocalPort 10808 -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess

# 向本機 HTTP 代理發出明確的請求
curl.exe -I --connect-timeout 10 --max-time 20 --proxy http://127.0.0.1:10808 https://example.com/

指令中的目標僅用來示範請求方式，不保證目前網路可以連線。實際排查時，請選擇已知可用且允許存取的目標，並在前後測試中使用相同目標。收到目標的 HTTP 回應，即使是拒絕存取或重新導向，也不同於連線逾時，代表請求已抵達某個 HTTP 服務。若遇到憑證錯誤，請再確認系統時間、目標名稱與憑證鏈；不要關閉憑證驗證來掩蓋問題。

依測試結果決定下一步，不要用猜測取代驗證

若明確指定代理的請求成功，接著選擇「自動設定系統代理」，完全關閉並重新開啟瀏覽器後再測試。仍然失敗時，改用未安裝代理擴充功能的瀏覽器比對。若只有一個應用程式異常，通常應檢查該應用程式的代理設定、快取或網路權限；所有應用程式都異常，再檢查系統流量接管。無痕視窗不一定會停用所有擴充功能，不能據此完全排除擴充功能的影響。

若只有部分網站無法連線，先記下失敗網域、錯誤類型與發生時間，並確認是否套用了直連規則。暫時切換路由只能作為比對測試，不應長期讓所有流量都走同一路徑來掩蓋問題。還原原有規則後，檢查目標網域比對、解析結果與規則順序。變更路由後必須建立新連線；舊連線可能仍使用原出口，因此立即重新整理不一定能反映新設定。

結束本輪排查時，記下「直接連線是否正常、本機是否正在監聽、明確指定代理是否成功、應用程式是否跟隨代理」四項結果。這比只說「無法上網」更有助於繼續定位。單一問題可查閱疑難解答；若無法建立監聽連接埠，請參閱本機連接埠占用排查，不要反覆重新安裝用戶端。

節點逾時：區分傳輸連線與協定交握

節點測試顯示逾時，不代表伺服器已停止運作。測試可能停在網域解析、建立連線、加密交握或取得測試目標回應等任一階段。先確認測試使用的目標與方式，避免把某個測試網站無法連線誤判為所有請求都失敗。保留目前的節點設定，改用同一訂閱中的另一台已知可用伺服器比對；不要一次更新訂閱、切換核心又修改傳輸參數，否則無法判斷是哪個步驟改變了結果。

依日誌順序找出第一個錯誤

先確認伺服器位址與連接埠完整無誤，特別留意複製時混入的空格、換行或連接埠遭截斷。網域解析失敗時，優先處理解析問題；連線遭拒通常表示目標位址沒有對應服務，或中間設備主動拒絕；連線逾時只代表在指定時間內未完成連線，不能單憑這筆日誌判定問題出在哪裡。記下第一筆相關錯誤；後續一連串連線取消，可能只是前一個錯誤引發的連鎖反應。

在 Windows 上可以檢查是否能與遠端連接埠建立一般 TCP 連線。以下範例會透過 PowerShell 互動輸入既有設定中的位址與連接埠，不會將實際資訊寫入命令歷程記錄。測試成功只代表 TCP 層可連線，不能證明帳號、傳輸路徑或 TLS 參數正確；測試失敗也不代表伺服器一定故障。此方法不適用於只使用 UDP 的連線，結論只能套用於實際測試的協定。

$server = Read-Host "輸入既有設定中的伺服器位址"
$port = [int](Read-Host "輸入既有設定中的伺服器連接埠")
Test-NetConnection -ComputerName $server -Port $port -InformationLevel Detailed

若一般連線可以建立，但用戶端提示交握失敗，請核對協定與傳輸層參數。VMess、VLESS、Trojan 的認證欄位不能互換；WebSocket 路徑與 Host、gRPC 服務名稱都必須與伺服器端一致。使用 TLS 時，連線位址可能與伺服器名稱不同；不能因為位址填的是 IP，就順手刪除伺服器名稱。REALITY 設定中的公鑰、短識別碼及相關參數也必須來自正確設定，不能照著其他節點拼湊。

分別驗證時間、網路與核心

若出現憑證尚未生效、已過期或與認證時間相關的錯誤，先檢查系統日期、時區與自動校時結果。時間錯誤會影響憑證和部分認證流程，但調整時間並非所有逾時問題的通用解法。憑證名稱不符時，應檢查伺服器名稱與設定來源；不要長期開啟略過憑證驗證。若公司網路需要驗證，或裝置有受管理的安全軟體，也應先確認其連線政策，而非直接關閉安全防護。

改用另一種網路測試時，保持用戶端、節點與目標不變。例如在獲准使用的行動熱點上執行相同請求，再切回原網路測試。若只有某個網路失敗，重點檢查網路驗證、出口限制與位址族可達性；若所有網路都失敗但其他節點正常，則著重檢查該節點的服務狀態與參數。雙協定網路中，網域解析出的 IPv6 位址可能沒有可用路徑，但不應因此永久停用整台裝置的 IPv6。

切換至 Xray 或其他支援的核心前，先確認目標核心支援該節點的協定與傳輸方式。圖形介面能儲存欄位，不代表所有核心都會以相同方式解讀。優先使用原本與訂閱及用戶端相容的組合，保留原設定後再單獨測試。若匯入新設定後才出現異常，可與上次可用的設定比對差異，但不要把已撤銷或過期的認證資訊當成可靠基準。

向設定提供者回報時，請說明發生時間、網路類型、協定、是否能建立 TCP 連線，以及移除敏感資訊後的第一筆錯誤。不要傳送整份訂閱內容或含認證欄位的截圖。若某個節點只能連線到少數目標，還要繼續檢查出口路由與 DNS；只有確認所有目標都在同一階段失敗，才適合判定問題出在節點本身。恢復正常後，請取消暫時提高的日誌層級並還原測試路由。

訂閱失敗：分別檢查取得、解析與套用

訂閱更新失敗至少分成三種情況：網址未取得內容、已取得內容但格式無法辨識、清單更新成功但所選伺服器失效。先確認日誌停在哪個步驟，再檢查「訂閱群組設定」中的目標群組。不要連續建立多個同名群組，也不要為了清除錯誤而刪掉最後一份可用設定。更新前記下群組名稱、節點數量變化與目前選取項目，避免把更新後選取項目改變誤認為整份訂閱都無法使用。

確認網址仍有效，且取得的是設定內容

先核對網址是否完整；查詢參數、大小寫與末尾字元都可能影響請求。訂閱網址通常具有存取權限，應像帳號資訊一樣妥善保管，不要貼到公開問題回報、截圖或線上轉換工具。若網址來自網頁按鈕，請確認複製的是訂閱連結，而非帳戶頁面、QR Code 圖片網址或瀏覽器重新導向頁面。檢視網頁顯示內容只能作為輔助；瀏覽器能開啟，不代表用戶端收到的回應相同。

若收到未授權、禁止存取或找不到資源等回應，請確認訂閱是否到期、權杖是否已重設、網址是否變更。此時反覆更換 DNS 通常無法解決權限問題。若回應內容是登入頁面、驗證碼頁面或維護通知，即使狀態碼表示請求成功，取得的也不是節點設定。遇到這種情況，應向設定提供者取得正確入口，不要將網頁內文手動編碼後匯入用戶端。

若請求逾時，請分別確認更新通道。已有可用連線時，可測試透過代理更新；目前沒有任何可用伺服器時，則試用選單中「更新訂閱(不透過代理)」對應的路徑。這不是開啟越多選項越好，而是要依訂閱伺服器的可達性選擇。更新請求使用的通道不一定與瀏覽器相同；瀏覽器擴充功能、系統代理與 TUN 的組合可能造成比對結果失準。

先檢查格式，再確認更新後的選取項目

不同用戶端支援的訂閱格式與擴充參數不盡相同。包含大量專用規則的完整設定檔，不一定能直接當作節點訂閱匯入；即使匯入成功，也不保證所有擴充欄位都會保留。優先索取明確適用於 v2rayN 或 Android 用戶端的格式。若必須轉換，先了解轉換程序會處理哪些欄位，並盡量在可信任的環境中進行，尤其要確認傳輸層、TLS 與 REALITY 參數沒有遭到捨棄。

更新後節點消失，先檢查群組篩選條件與搜尋框，不要立刻認定訂閱回傳空內容。含空格或大小寫差異的篩選關鍵字，可能會隱藏所有可用項目。清除暫時使用的搜尋條件後再查看，並確認更新的是預期群組。若訂閱取代了原有節點，先前選取的項目可能已不存在；請重新選擇清單中的伺服器並重新啟動服務，再用明確指定代理的請求驗證，不要只看群組更新提示。

設定自動更新間隔前，先手動更新一次並確認通道可靠。間隔過短會造成重複請求，也可能觸發伺服器限制；裝置休眠、斷線或背景工作暫停時，計時器不一定會準時執行。不要因為漏了一次定時更新就同時啟用多個更新工作。常常更新失敗的群組可暫時改為手動更新，記下失敗時間與回應，再針對網路和權限排查。

若手動更新成功但自動更新失敗，請比對裝置喚醒時間、網路切換與更新時的代理狀態；若所有用戶端同時失敗，再檢查網址與伺服器端狀態。排查紀錄只寫錯誤類型，不要保存完整訂閱 URL。群組更新方式與間隔的詳細說明，請參閱訂閱更新失敗與自動重新整理設定。網址更新成功後仍逾時，應回到連線層排查，不要反覆更新碰運氣。

速度慢：分別檢查延遲、傳輸量與封包遺失

網頁首次載入慢、檔案下載慢與影片間歇停頓，並不是同一種問題。首次請求耗時較長，可能是解析、建立連線或交握所致；持續下載速度低，則可能同時受遠端出口、目標網站、無線網路與本機負載影響。先描述可重現的症狀，例如首次開啟很慢但重新整理後正常，或所有大型檔案下載都很慢。不要只憑單次延遲測試替節點排序後就認定原因；往返時間較短不代表傳輸量較高。

固定測試條件，再比較不同路徑

在相近時段使用相同目標與檔案進行比對，並暫停雲端同步、系統下載及其他占用網路的工作。若直連與代理連線的目標不同，就無法單獨比較路徑差異；不同內容傳遞節點也可能造成結果波動。先用同一台伺服器重複測試兩三次，再換另一台伺服器。不要同時執行多項測速工作，測速本身會占用頻寬，讓原本正常的連線看起來有問題。

以下指令會捨棄下載內容，只輸出請求各階段耗時與平均下載速度，適合小規模重複測試。目標與連接埠請依實際環境調整。透過 HTTP 代理連線時，名稱解析與連線指標的意義會受代理協定影響，不能直接將每個數值視為遠端 DNS 或遠端伺服器的獨立耗時。小型網頁的平均下載速度容易受交握時間占比影響，不適合用來推估大型檔案的速度上限。

curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 30 --output NUL --silent --show-error --write-out "connect=%{time_connect} start=%{time_starttransfer} total=%{time_total} speed=%{speed_download}\n" https://example.com/

如果每次連線都很快，但等待第一個位元組的時間很長，請檢查目標服務回應與遠端出口；如果第一個位元組正常、傳輸期間卻反覆停頓，則觀察無線訊號、封包遺失與系統資源。一般 ping 被拒絕不代表應用連線失敗；連續 ping 正常也不能證明加密連線沒有問題。優先使用實際採用的協定發出請求，再將網路診斷工具結果作為佐證，不要用單一數值取代完整的使用結果。

排除本機資源與流量接管方式的影響

開啟工作管理員或系統監視器，留意核心程序的處理器使用率、記憶體與磁碟活動。舊型裝置、省電模式與溫度限制可能影響加密與轉送；長時間使用詳細日誌也可能增加寫入負擔。先恢復一般日誌層級、關閉不必要的背景工作，再重新測試。不要為了節省資源而隨意停用安全軟體，也不要把高使用率一概歸咎於用戶端；還需要同時查看當時的實際流量。

分別測試明確指定代理、系統代理與 TUN，每次只啟用一種明確的連線路徑。若只有 TUN 速度慢，重點檢查虛擬網卡、路由衝突與其他網路篩選軟體。若只有大型檔案或特定連線卡住，可在保留預設值的前提下檢查 MTU 相容性，但不要照抄網路上的數值並長期使用。修改 MTU 後必須重新建立連線，並對多個目標進行驗證；小型網頁正常不足以證明問題已解決。

影片卡頓也可能是目標網站限速、內容傳遞位置或應用程式本身的緩衝策略所致。同一節點只有一個網站速度慢、其他網站正常時，先檢查該目標對應的路由與出口，不必立即重新安裝。瀏覽器啟用的安全 DNS、擴充功能或快取，可能讓瀏覽器與命令列走不同路徑；應用程式若使用 UDP，一般網頁的 TCP 測試也無法反映實際情況。比對時請註明應用程式、目標與傳輸類型。

若晚間速度慢、白天正常，而本機資源與無線網路穩定，可將特定時段壅塞列為待驗證原因；換網路後恢復，則進一步比較本地接入線路。不要因偶爾一次變快，就認定是剛修改的參數奏效；至少還原原設定做一次反向比對。確認改善可以重現後，再保留必要變更。規則愈複雜不代表速度愈快；減少重複代理與無效篩選，通常比疊加更多「加速」設定更容易維持穩定。

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

網域無法開啟但部分 IP 可以連線，只能表示解析路徑值得檢查，不能立即證明 DNS 是唯一問題。HTTPS 網站仰賴伺服器名稱與憑證，直接以 IP 開啟會改變請求條件。先區分系統解析、瀏覽器安全 DNS、代理核心解析與遠端解析：同一個網域在不同位置可能得到不同結果。記下請求由哪個應用程式發起、使用哪種代理協定，再判斷應調整哪一層。

先檢查解析結果，再處理快取

在 Windows 使用以下指令查詢系統解析結果，並查看各網路介面的 DNS 設定。有線網卡、無線網卡與虛擬網卡可能同時存在；系統實際採用的路徑不一定是目前查看的網卡。回傳多個位址本身並非異常，內容傳遞服務與雙協定網路都可能產生多筆記錄。重點檢查是否解析失敗、是否出現非預期的內網位址，以及目前網路能否連線到解析結果。

# Windows PowerShell：檢查系統解析與介面 DNS
Resolve-DnsName example.com
Get-DnsClientServerAddress

# 修正解析設定後，如有需要再清除系統快取
Clear-DnsClientCache

清除快取應在修正設定後進行。若上游仍有問題，清除後只會再次取得相同的錯誤結果。瀏覽器、用戶端核心與應用程式本身也可能有獨立快取，系統指令無法一併清除。必要時完全關閉相關應用程式並重新啟動核心後再試，不必每次查詢都重新啟動整台裝置。若問題只在從休眠喚醒或切換網路後出現，優先檢查舊介面的解析設定是否殘留。

使用 SOCKS 時，目標名稱可以由本機解析，也可以交由代理處理。以下兩個指令的關鍵差異是網域解析位置，不是「一個安全、一個不安全」。只有在本機混合連接埠確實提供對應服務時，才能這樣測試。若只有遠端解析方式成功，應繼續檢查本機解析與路由；若兩者都失敗，還要參考連線日誌，不能只更換 DNS 位址。

# 先在本機解析目標網域
curl.exe --socks5 127.0.0.1:10808 -I --connect-timeout 10 --max-time 20 https://example.com/

# 將目標網域交由 SOCKS 代理解析
curl.exe --socks5-hostname 127.0.0.1:10808 -I --connect-timeout 10 --max-time 20 https://example.com/

一併檢查網域策略與分流規則

v2rayN 路由設定中的網域策略會影響何時為了 IP 規則而進行解析。以 Xray 的定義為例，AsIs 不會主動解析路由目標網域；IPIfNonMatch 會在網域規則未命中時，再嘗試比對解析出的 IP；IPOnDemand 則可能在處理 IP 規則時發起解析。實際可選項目與行為仍須依目前使用的核心而定，不能直接將一種核心的說明套用到另一種核心。

以下片段僅供理解路由語義，並非可直接覆蓋用戶端產生設定的完整檔案。它說明網域策略與規則之間的關係，不提供通用 DNS 位址，也不能取代用戶端介面設定。實際修改時，優先透過介面操作，以免重新啟動服務後設定遭自動產生的內容覆蓋。檢查規則時請由上往下閱讀；較早命中的直連規則可能使後面的代理規則完全不會執行。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

使用加密 DNS 時，解析器本身也需要可用的連線路徑。若解析器網域的初始解析、連線出口與代理啟動順序互相依賴，可能形成循環：沒有 DNS 就無法連上代理，沒有代理又無法連到 DNS。先恢復可用的基礎解析，再逐項啟用進階設定。不要一次將系統、瀏覽器與核心全都改用同一個新解析器，否則很難判斷真正生效的是哪一層。

公司內網、家用裝置名稱與公共網域可能需要不同的解析範圍。將所有查詢都交給公共解析服務，可能讓內部名稱失效；強制讓內部位址走遠端，也可能造成無法本機存取。恢復後請分別測試公共網站、區域網路服務與休眠喚醒情況。若涉及 IPv6，先檢查預設路由與位址可達性，再決定是否調整個別應用程式的位址選擇；不要用全域停用取代路徑定位。

系統代理未生效：先檢查應用程式，再檢查 TUN

選擇「自動設定系統代理」後仍有應用程式直接連線，先確認該應用程式是否會讀取系統代理。系統代理是提供給應用程式使用的代理設定，並非強制攔截所有網路請求；有些應用程式會使用自己的設定，命令列工具也可能只讀取環境變數。TUN 則透過虛擬網路介面與路由接管流量，排查範圍更廣。兩者用途不同，系統代理失效時不應直接同時啟用所有流量接管方式。

了解三種系統代理選項的適用範圍

「自動設定系統代理」通常會將系統入口指向用戶端的本機監聽；「清除系統代理」會移除相應代理設定；「不變更系統代理」表示用戶端不主動修改既有設定，不代表一定是直接連線。切換選項後，請到作業系統的網路設定核對位址與連接埠，尤其留意手動代理與自動設定指令碼是否同時存在。其他軟體可能會重新寫入系統設定，介面剛顯示成功不代表之後仍會維持不變。

瀏覽器代理擴充功能、受管理的政策與應用程式內部設定都可能覆蓋系統入口。先暫時停用相關擴充功能，再完全關閉並重新開啟應用程式；若瀏覽器由組織管理，請勿擅自修改政策。Windows 中不同網路元件也可能使用不同的代理設定，某些系統服務與目前使用者的瀏覽器並不共用設定。因此「瀏覽器能用」只能驗證瀏覽器的連線路徑，不能推論更新服務、終端機與背景程式也會使用相同入口。

命令列先以明確代理參數測試，確認成功後再檢查環境變數，避免長期修改後忘記還原。以下範例只會影響目前的 PowerShell 工作階段，適用於支援這些變數的工具；不同程式讀取的變數名稱與優先順序可能不同。NO_PROXY 可讓指定目標繞過代理；若其中包含過於寬泛的網域後綴，也可能造成「部分網站始終直接連線」的情況。

# 僅限目前的 PowerShell 工作階段；請依用戶端實際設定調整連接埠
$env:HTTP_PROXY = "http://127.0.0.1:10808"
$env:HTTPS_PROXY = "http://127.0.0.1:10808"
$env:NO_PROXY = "localhost,127.0.0.1,::1"

# 測試結束後移除此處設定
Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:NO_PROXY -ErrorAction SilentlyContinue

以最精簡的設定單獨驗證 TUN

只有確定需要接管不讀取代理設定的應用程式時，才檢查「啟用 Tun 模式」。先關閉其他虛擬網路工具與重複代理，確認核心正常且一般代理請求成功，再依用戶端提示處理權限。若權限不足、虛擬介面建立失敗或路由寫入失敗，請從日誌找出原因，不要反覆切換開關。提高權限前，先確認啟動的是正確用戶端；不要為了排查而長期放寬整個下載目錄的權限。

啟用 TUN 後完全無法上網，請優先檢查預設路由是否形成迴圈，以及用戶端連往遠端伺服器的流量是否又被送回虛擬介面。多個虛擬網路工具同時修改路由時，表面上的優先順序可能與實際流量路徑不同。請先逐一關閉，再測試單一用戶端。需要檢視路由時，Windows 可使用 route print，Linux 可使用 ip route；先記錄結果，不要直接執行不熟悉的指令刪除預設路由。

只有使用 TUN 時無法存取區域網路，應檢查私有位址規則、介面選擇與 DNS，而不是開啟「允許來自區域網路的連線」。後者控制其他裝置能否連到本機代理監聽，與本機能否存取區域網路不是同一回事。開放監聽還需要考量防火牆與可信任網段，不能當成所有區域網路問題的通用解法。請將本機排查與向其他裝置提供代理分開處理。

關閉用戶端後仍無法上網，先清除系統代理，再確認虛擬介面與路由是否已撤銷。必要時透過正常介面重新連接實體網路，但不要直接執行完整網路重設，因為這可能影響固定 IP、企業網路與其他虛擬網卡。恢復後，請各測試一次正常結束與休眠喚醒。瀏覽器與終端機的個別排查方式請參閱系統代理未生效排查，避免將應用程式差異誤認為節點故障。

用戶端閃退：區分介面、核心與系統環境

雙擊後沒有視窗、視窗一閃即關，以及連線時核心結束，應分開處理。先查看工作管理員或系統監視器，確認是否已有程序留在系統匣，避免重複啟動造成連接埠衝突。若視窗仍開著但日誌顯示服務已結束，通常不是介面閃退；若視窗完全消失，則應檢查應用程式日誌與系統事件。記下問題發生在啟動、更新、匯入或啟用 TUN 之後；發生時間點比反覆重新啟動更有助於縮小範圍。

檢查安裝類型與執行目錄

請從用戶端下載頁依作業系統與處理器架構選擇安裝檔。Windows 桌面版與傳統 WPF 版採用不同的介面技術，不能將其中一版的執行環境需求直接套用到另一版。macOS 要區分 Apple Silicon 與 Intel；Linux 則要區分發行版套件格式與處理器架構。架構不符可能會導致無法執行，而非顯示明確的用戶端錯誤。不要只靠更改副檔名來繞過安裝方式。

使用壓縮檔版本時，請先完整解壓縮，再從固定目錄執行；不要在壓縮檔預覽視窗中啟動，也不要只複製執行檔而遺漏隨附資源。安裝版則使用作業系統提供的方式修復或重新安裝。確認使用者資料目錄可寫入、磁碟空間足夠，且雲端同步沒有鎖定設定檔。不要將用戶端放在必須頻繁提高權限才能寫入的暫存位置，再靠長期以管理員身分執行來掩蓋目錄問題。

安全軟體攔截時，先查看事件紀錄中的檔案與原因，確認來源及安裝流程，再依組織或裝置管理規定處理。不要一開始就全面關閉防護，或將整個磁碟加入排除清單。系統若提示缺少執行元件，請依所選用戶端版本的需求處理；不要下載來源不明的單一動態連結程式庫來補足。資源缺失、權限遭拒與架構不符是不同問題，多安裝元件未必有幫助。

先備份，再建立乾淨設定進行比對

若閃退始於匯入或更新設定，先正常結束程序並備份目前的使用者資料，再使用用戶端支援的方式建立獨立測試環境。不了解資料目錄位置前，不要批次刪除檔案。測試環境先不要啟用自動啟動、TUN 與自動更新，只啟動介面並加入必要的最少設定。若乾淨環境正常，再逐步還原群組、規則與其他設定；若仍然閃退，應優先檢查系統環境與安裝資源，而非繼續刪除節點。

Windows 可依時間在事件檢視器的應用程式紀錄中尋找故障模組；macOS 可查看系統提供的當機報告；Linux 可從終端機啟動圖形程式以觀察標準錯誤，並查詢目前使用者的系統日誌。不同發行版與啟動方式的日誌位置並不相同，不要假定每個系統都有相同的檔案。以下指令只顯示最近一段時間的使用者日誌，仍可能包含個人路徑與其他程式資訊，分享前請先篩選。

# Linux：查看目前使用者最近十分鐘的日誌
journalctl --user --since "10 minutes ago" --no-pager

若日誌明確指出本機連接埠遭占用，先查明所屬程序，不要隨意結束所有網路程序。Windows 可將查詢監聽狀態取得的程序 ID 傳給 Get-Process -Id 查看名稱，再透過對應程式正常結束程序。確實需要修改「本機混合監聽連接埠」時，請記下新值，並同步更新手動設定的瀏覽器、終端機及其他應用程式。系統代理應重新套用；用戶端變更連接埠後，舊的環境變數不會自動更新。

Linux 桌面捷徑沒有回應，但從終端機啟動正常時，請檢查啟動項目的執行路徑、工作目錄與環境變數。開機自動啟動失敗，也可能是網路尚未就緒或權限提示無法顯示，並不代表程式本身無法執行。相關部署限制請參閱Linux 桌面安裝與自動啟動。修正後先驗證手動啟動，再恢復自動啟動，最後測試重新開機與正常結束。

若問題只在切換核心後出現，請還原原本組合，並確認目標核心是否能辨識該設定。回報閃退時，請提供系統架構、安裝類型、觸發操作與移除敏感內容後的錯誤片段，不要臆測版本問題，也不要只寫「更新後就不能用」。能穩定重現的最短操作步驟，比完整錄影更容易分析；確認修復後再恢復自動工作，避免測試期間被更新或訂閱重新整理改變條件。

Android 專項：檢查 VPN 授權、背景執行與應用程式範圍

Android 用戶端顯示已連線，但應用程式沒有流量時，先區分 VPN 服務是否成功建立與遠端連線是否成功。v2rayNG 的連線按鈕進入運作狀態，只代表本機服務已啟動，仍須透過實際請求與日誌驗證。v2flyNG 作為 V2Fly 核心的替代選項，也應依其支援的設定與選單檢查。不要在兩款用戶端之間來回匯入後，就認定節點設定完全相同；擴充欄位與核心能力可能影響實際連線。

先確認系統授權與 VPN 是否遭占用

第一次連線時，請確認已完成系統 VPN 授權提示；拒絕授權、受到裝置管理政策限制或背景程序遭中斷，都可能導致服務無法建立。Android 通常無法讓兩個一般 VPN 服務同時接管流量，請檢查是否有企業連線、網路篩選或其他代理應用程式正在使用 VPN。先正常停止這些服務，再啟動要測試的用戶端。不要反覆點選連線按鈕，連續啟停會讓日誌中的服務狀態更難判讀。

若啟用了系統的「永遠開啟的 VPN」或「封鎖未經 VPN 的連線」，用戶端一旦停止，直接連線也可能遭系統封鎖。這種情況不一定是代理殘留。先查看系統 VPN 設定並記下原本狀態，在獲准修改的裝置上視需要調整後再測試。受管理裝置應遵守組織政策，不可透過刪除管理元件來排查。測試完成後，請重新啟用原本需要的防護設定，並確認正常斷線時的行為。

開啟用戶端日誌，對已知目標發出一次請求，確認是否有對應紀錄。若沒有請求紀錄，先檢查應用程式範圍與流量接管入口；若出現解析錯誤，請前往 DNS 章節；若出現交握錯誤，則回到節點逾時章節。不要只看連線時間或圖示顏色。使用行動數據與無線網路比對時，請保持使用同一節點，並先確認已完成無線網路的網頁登入，否則入口網站驗證可能讓代理連線與一般網頁都出現異常。

處理鎖定螢幕後中斷與應用程式分流

連線後立即可用，但鎖定螢幕一段時間後就中斷，請優先檢查電池最佳化與背景執行限制。不同廠牌的選單名稱不盡相同，應在應用程式資訊中查看電池使用量、背景活動與自動啟動權限，不要照抄其他品牌的操作路徑。先只為目前的用戶端調整必要選項，保持通知服務可見，再測試鎖定螢幕與喚醒。不要放寬所有應用程式的限制，這會增加耗電，也不能證明問題出在節點。

只有部分應用程式失效時，請確認應用程式分流清單使用的是「僅代理所選應用程式」，還是語意相反的「略過所選應用程式」模式。同一個勾選動作在不同模式下可能代表納入或排除。修改後先停止並重新建立 VPN，再完全關閉並重新開啟目標應用程式，因為現有連線可能仍沿用舊路徑。也要確認工作資料中的應用程式是否屬於另一個管理範圍，不要假設個人空間中的選擇會自動套用到所有應用程式。

手機開啟熱點後，連上熱點的裝置不一定會自動經過手機用戶端的 VPN。熱點轉送、手機本機請求與向區域網路開放代理監聽是不同路徑；手機網頁能用不能證明網路分享也成功。排查手機本機連線時，先關閉分享功能；確實需要向可信任的裝置提供代理時，再分別核對監聽位址、認證資訊與網路存取範圍。不要為了測試將代理入口暴露在不可信任的網路中。

分別排查訂閱、網路切換與安裝問題

在 v2rayNG 中檢查「訂閱群組設定」，確認群組網址與啟用狀態，再執行「更新訂閱」。若目前沒有可用連線，更新請求可能需要直接連線；請依選單與日誌確認使用的方式，不能因為瀏覽器能開啟網址，就推斷用戶端的連線通道正常。更新成功後，重新選擇伺服器再連線。訂閱網址包含存取權限，不要長期保存在公開的剪貼簿記錄工具中，也不要將完整 QR Code 交給他人協助排錯。

從無線網路切換到行動數據後中斷，先停止並重新連線一次，讓服務透過新網路建立連線。若這樣可以恢復，接著觀察系統是否限制背景網路、解析是否沿用舊狀態，以及遠端位址在兩種網路中是否都可連線。不要一開始就重設所有網路設定。雙協定網路與電信業者的位址轉換可能改變連線條件；一般網頁測試正常，也無法完整涵蓋使用 UDP 的應用程式，應依實際應用進行比對。

最後完整測試一次：連線後瀏覽目標網站、鎖定螢幕再喚醒、切換網路後重新連線，並在正常中斷後確認可以直接連線。每個步驟都正常，才算涵蓋行動裝置的使用情境。若仍有異常，請整理系統版本、用戶端名稱、網路類型、是否與鎖定螢幕有關，以及移除敏感資訊後的第一筆錯誤，再查閱常見問題。若要重新建立基礎設定，請返回快速入門教學，不要將暫時測試設定繼續當作日常預設值。