V2Ray 故障排除
節點、訂閱與系統代理設定

無法上網：先區分基本網路與代理連線

「無法上網」不足以明確判定故障。先記下三種情況：關閉代理後一般網站是否能連線、開啟代理後是否所有網站都無法使用，以及問題是否只出現在特定應用程式。暫時關閉其他代理或 VPN 工具，避免多組規則同時接管流量。記下目前使用的節點與路由模式，後續測試都使用相同的目標網頁；不要同時更換節點、切換網路又調整 DNS，否則難以判斷哪項變更有效。

關閉代理，建立直接連線的對照

在 v2rayN 中先選擇清除系統代理，再關閉 TUN 模式。只關閉主視窗不一定會結束用戶端，請確認系統匣中沒有仍在執行的背景程序。重新開啟瀏覽器，造訪平常可直接連線的網站。若此時也無法連線，先檢查 Wi-Fi、網路線、閘道器與網路登入頁面；公共網路可能需要先完成驗證。基本網路尚未恢復前，先不要修改節點參數。若同一網路上的其他裝置正常，只有這台電腦無法連線，再檢查本機防火牆、手動設定的代理與 DNS。

直接連線恢復後，啟動 v2rayN，確認節點清單中有可用設定，並將其選為目前使用的伺服器。查看記錄是否出現核心程序結束、設定解析失敗或連接埠繫結失敗。用戶端視窗能開啟，只代表圖形介面正在執行，不代表代理核心已開始監聽連接埠。找出參數設定中的實際本機連接埠，再與記錄中的監聽位址核對。不同用戶端的連接埠不一定相同，也不要把伺服器連線連接埠誤填成本機代理連接埠。

分別確認本機監聽與遠端連線

確認本機 HTTP 或混合入口後，可略過系統代理設定，明確指定代理進行測試。以下命令適用於 Windows PowerShell，範例假設用戶端的 HTTP 或混合監聽連接埠為 10808；若實際設定不同，請先換成對應連接埠。測試網址用於確認 HTTPS 請求鏈路，不代表業務網站一定能正常存取。若該連接埠只提供 SOCKS 服務，請使用下一章的 SOCKS 測試方式，不可直接套用 HTTP 參數。

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

若命令立即顯示無法連線至本機位址，優先檢查核心是否啟動、連接埠是否一致；若已連上本機代理，接著回報遠端交握失敗，請參閱節點章節。命令成功但瀏覽器失敗，通常應檢查瀏覽器獨立代理、擴充功能與系統代理，而不是繼續更換伺服器。網站若回傳重新導向、拒絕存取或其他 HTTP 狀態，表示已收到應用層回應，不應一概視為「網路不通」。

縮小範圍至路由、應用程式或目標網站

暫時切換至用戶端提供的全域代理路由，使用同一節點再測試一次。若全域模式可用、分流模式失敗，請優先檢查目標網域是否符合直連規則、規則資料是否正常載入，以及 DNS 解析結果是否影響位址規則。全域模式僅用於診斷對照，確認問題後應恢復原本模式。若只有一個應用程式失敗，請確認它是否遵循系統代理；有些應用程式需要自行設定代理，有些連線則必須由正確設定的 TUN 或 VPN 接管。

修復後至少測試兩種連線：一個應直接連線的網頁，以及一個應透過代理連線的網頁。接著關閉並重新啟動用戶端，確認設定仍有效。若退出後直接連線又失敗，通常是系統代理或網路設定仍有殘留，請繼續閱讀系統代理無效章節。若不熟悉初次設定，可返回快速入門依照主要步驟操作；概念相關問題則可參閱常見問題。

節點逾時：依序檢查位址、連接埠與交握

先區分「用戶端測試逾時」和「實際連線逾時」。不同測試方式可能檢查 TCP 連線、指定網頁請求或其他項目；單一測試失敗，不能直接證明整個節點失效。請用瀏覽器與明確指定代理的命令交叉確認，再判斷是單一節點異常、同一訂閱中的所有節點異常，還是所有來源的節點都異常。只有單一節點失敗，較可能是節點參數或伺服器狀態問題；全部失敗則應先排除本機、目前網路與核心啟動異常。

核對伺服器位址與遠端連接埠

開啟節點編輯頁面，核對伺服器位址、伺服器連接埠、協定與傳輸方式。位址欄不應包含協定前綴、路徑或多餘空格，除非欄位明確要求完整 URL。連接埠必須符合服務提供者提供的入口，不能因為看到 10808 就把遠端連接埠也改成這個值。剛更新訂閱後，請確認目前選取的確實是更新後的設定；有些介面會保留舊項目或先前的選取狀態，需要重新選定使用中的伺服器。

在 Windows PowerShell 中，可用以下命令檢查指定主機與 TCP 連接埠是否能建立連線。範例網域僅供文件示範，實際排查時請換成節點伺服器網域與正確連接埠。結果只反映 TCP 連線狀態，不會驗證協定驗證、傳輸路徑與 TLS 參數，也不適用於直接將 UDP 服務視為 TCP 服務測試。若連線失敗，請先換一個網路進行相同測試，再向服務提供者確認入口是否已變更。

Test-NetConnection -ComputerName example.com -Port 443

若網域解析失敗，請先參閱 DNS 章節。若能解析但 TCP 連線失敗，可能與網路路徑、遠端監聽、防火牆或服務無法使用有關；反覆修改本機加密選項通常無濟於事。若 TCP 連線成功但仍逾時，請繼續查看用戶端記錄中的交握與驗證資訊。排查時保留錯誤訊息前後幾行即可；分享記錄前請刪除訂閱網址、使用者識別資訊與驗證欄位，不要公開完整設定。

區分 TLS、傳輸層與協定參數

遇到 TLS 憑證錯誤，先檢查系統日期、時區與時間同步，再核對 SNI 或伺服器名稱。伺服器位址與 SNI 可能不同，不能用「兩個欄位填一樣」取代服務提供者的設定。使用 WebSocket 等傳輸方式時，也必須配合路徑、Host 與安全層；路徑通常區分大小寫，開頭的斜線也可能影響結果。交握遭到關閉不一定是憑證問題，也可能是請求送往錯誤的服務入口。

VLESS、VMess、Trojan 等設定的驗證與傳輸需求各不相同，不能只修改協定名稱並沿用其他欄位。REALITY 設定也必須符合伺服器提供的公鑰、短識別碼與伺服器名稱等參數，請以原始設定為準，不要自行拼湊網路上的參數。不要把允許不安全連線當成通用解法；略過憑證驗證既無法修正錯誤路徑，也會降低身分驗證的安全性。憑證問題可進一步參閱TLS 交握與系統時間排查。

透過單一變因對照判斷故障來源

若用戶端提供 SOCKS 入口，可使用以下命令透過代理端處理目標網域。此處同樣假設本機 SOCKS 監聽連接埠為 10808，請務必先確認入口類型。與 HTTP 代理測試相比，這有助於判斷應用程式的代理設定是否有誤，但不能證明所有路由與 DNS 請求都在遠端處理，實際情況仍取決於核心規則。

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

同一設定換網路後恢復，表示目前的網路連線環境值得優先調查；同一網路換節點後恢復，則原節點或其連線路徑更可疑。若所有對照測試都失敗，請確認核心是否支援該設定包含的欄位，再考慮前往下載頁面選擇適用平台的用戶端。排查時不要任意切換多種核心或覆蓋原有設定。完整分層排查順序請參閱節點逾時排查文章，回報問題時請附上已完成的對照結果。

訂閱失敗：區分下載錯誤與內容解析錯誤

更新訂閱包含兩個獨立步驟：先取得內容，再將內容解析為用戶端支援的設定。「更新失敗」可能發生在任一步驟。先確認提示是連線逾時、HTTP 狀態錯誤、憑證錯誤，還是格式無法辨識、沒有有效節點。前者應檢查連線路徑，後者則應檢查回應內容與訂閱格式。不要一開始就刪除整個訂閱群組，否則會失去舊設定，也無法比對故障前後的差異。

檢查訂閱網址與回應類型

向服務提供者重新複製訂閱網址，檢查前後空白、換行，以及通訊軟體自動附加的標點。部分網址包含查詢參數，複製時漏掉後半段可能導致身分驗證失敗；不要自行刪除或修改看似複雜的參數。帳戶頁面連結、購買頁面連結與用戶端訂閱連結用途不同，能在瀏覽器開啟網頁，不代表該網址可匯入訂閱。完整網址可能具有存取權限，請妥善保管，不要放入公開截圖、搜尋欄或第三方解析頁面。

若回應為未授權或禁止存取，先檢查訂閱是否到期、連結是否已重設，以及伺服器是否限制存取方式；若回應為找不到資源，則核對路徑是否已變更。請求成功但解析結果為空，可能是取得了登入頁、維護頁、存取驗證頁或錯誤說明。不要看到成功狀態就認定是用戶端損壞。可在本機查看回應開頭是否明顯為網頁文字，但查看時避免將包含憑證的完整內容複製到記錄或公開問題回報。

選擇合適的更新連線方式

若目前網路無法直接連線至訂閱伺服器，但已有可用節點，請先選取該節點，再使用用戶端提供的透過代理更新功能。一般更新與透過代理更新是否獨立於系統代理，取決於用戶端的實作方式，不能只看系統代理開關判斷。反過來說，若用戶端將更新請求送進已失效的節點，改用直接連線更新反而可能恢復。每次只更改更新方式並保留相同訂閱網址，才能確認連線方式的差異。

初次設定時若沒有可用節點，就無法依靠尚未建立的代理取得訂閱。請在可存取服務的網路環境重試，或向服務提供者索取用戶端支援的其他匯入方式。不要為了繞過錯誤而任意關閉憑證驗證，也不要使用來源不明的訂閱轉換服務。更新頻率保持適度；連續快速點擊可能觸發伺服器流量限制，遇到明確的限流回應時應稍後重試，不要重複建立多個相同群組。

確認格式、編碼與用戶端支援度

分享連結、編碼後的連結集合與結構化設定是不同格式。部分訂閱服務會依用戶端產生不同內容，請選擇適用於 v2rayN、v2rayNG 或 v2flyNG 的入口。手動處理編碼前請先保留原始內容，避免重複編碼、截斷或將換行轉成一般字元。不要只修改副檔名就匯入其他軟體的設定；檔名不會改變檔案內部結構。若解析提示不支援某協定或欄位，應確認用戶端與核心的支援能力，不要任意刪除錯誤欄位。

更新提示成功但清單沒有變化時，請檢查目前顯示的群組、搜尋條件與隱藏規則，確認不是只看到收藏項目或其他篩選結果。節點遭移除也可能是訂閱服務主動調整，不一定是用戶端漏掉匯入。必要時可建立臨時群組進行對照，但不要立即覆蓋原群組。恢復後請手動選取節點並實際連線測試，因為訂閱更新成功不代表節點可連線。詳細匯入步驟請參閱訂閱匯入教學，內容檢查請參閱訂閱解析失敗自我檢查。

速度緩慢：分別測試連線建立、傳輸量與使用體驗

先描述「慢」發生在哪個階段：開啟網頁前等待很久、網頁主體出現後圖片載入很慢，還是持續下載時速度偏低。建立連線時的等待可能與 DNS、交握或目標網站回應有關；持續傳輸則還會受到頻寬、封包遺失、網路壅塞與伺服器負載影響。用戶端顯示的延遲數值只是特定測試方式的結果，不代表可用下載頻寬；更不能只用一次測試的高低推斷節點長期品質。請先保留目前模式與節點，建立可重複的測試條件。

排除本機頻寬與裝置負載

關閉系統更新、大型下載、雲端同步與其他占用網路的工作，並觀察同一網路中的裝置是否也正在傳輸資料。Wi-Fi 訊號看似滿格，仍可能受到干擾；可移近無線基地台或改用有線網路進行比較。若直接連線也同樣緩慢，應先處理基本網路問題，而不是持續更換代理設定。行動熱點與固定網路可作為對照，但測試時請留意行動網路的費用與流量限制，不要反覆下載大型檔案。

同時查看工作管理員或系統監視器中的 CPU、記憶體與磁碟使用情況。裝置負載過高、儲存空間不足或過熱，都會影響瀏覽器與用戶端的回應；此時看似網路卡頓，瓶頸實際上可能在本機。TUN 接管大量應用程式流量、複雜規則與高頻記錄也可能增加系統負擔。先暫停無關工作，再比較一般系統代理與 TUN 模式；不要為了表面上的速度提升而降低驗證要求或關閉系統防護。

建立公平的節點與連線路徑對照

測試節點時，盡量維持目標網站、網路、用戶端模式與測試時段一致，每次只更換一個節點。不要同時讓多個節點進行大量下載，否則會共用本機頻寬。地理距離近不一定比較快，網路互連、遠端出口與壅塞情況也同樣重要。若只有一個目標網站緩慢、其他網站正常，原因可能是該網站本身、內容傳遞路徑或對遠端出口的限制，不應立即歸咎於所有代理連線。

若全域路由速度正常、分流模式卻緩慢，先確認較慢的請求最後是透過代理還是直接連線。網頁通常會連線至多個網域；若主頁載入正常但圖片遲遲未顯示，可能是資源網域符合了不同的出口規則。可暫時啟用適量的存取記錄，找出失敗或等待較久的資源網域，再調整相應規則。不要只憑網址列中的主網域新增規則，也不要長期啟用極詳細記錄進行日常下載，以免增加磁碟負擔並暴露瀏覽記錄。

確認連線多工、UDP 與 MTU 限制

多路複用不是一定要開啟的加速功能。它可能減少重複交握，也可能在某些連線路徑上加劇壅塞或造成相容性問題，應依節點要求設定並在相同情境下比較。網頁使用的 HTTP/3 等機制會涉及 UDP，而系統 HTTP 代理不等於接管所有 UDP 請求；應用程式可能改用其他連線方式，因此首次載入時看似停滯。請先確認應用程式實際使用的傳輸方式與流量接管範圍，不要把所有延遲都歸因於節點頻寬不足。

只有在 TUN 模式下出現特定大型網頁、上傳或長連線卡住，而一般系統代理正常時，才將 MTU 列為後續排查項目。先記下預設值，參考目前網路與用戶端說明逐步調整，每次修改後重新建立連線並測試。MTU 太小會增加分段與處理負擔，直接套用網路文章中的固定值也可能掩蓋真正問題。MTU 無法修復驗證失敗、憑證錯誤或遠端服務停止，應先確認基本連線正常再檢查。

修復後應以實際使用情況作為判斷標準：網頁能否穩定開啟、會議或長連線是否中斷、持續傳輸是否穩定。若只在特定時段變慢，請記錄不同時段的對照結果並回報服務提供者，避免頻繁修改本機所有參數。若延遲集中在首次造訪，或使用 IP 與網域連線時結果不同，請前往下一章檢查 DNS；若只有特定應用程式速度慢，則檢查它的獨立代理與分流規則，而不是繼續全面更換節點。

DNS 問題：確認解析位置與請求出口

DNS 負責將網域名稱轉換為位址，但一次連線可能同時涉及系統解析器、瀏覽器安全 DNS、用戶端內建 DNS 與代理伺服器端的解析。網域無法開啟但其他連線正常時，請先確認是哪一層發生問題。記錄中的伺服器網域解析失敗與目標網站網域解析失敗並不相同：前者可能導致代理連線根本無法建立，後者則發生在已選定出口之後。不要只修改某個公共 DNS 位址，就認定整條解析路徑都已改變。

先檢查系統解析與快取

以下 Windows 命令可查看系統取得的解析結果，並清除本機 DNS 快取。範例網域僅用於建立對照；實際排查時也應查詢目標網域與節點伺服器網域。查得到位址不代表該位址一定符合目標服務的預期；不同解析器、網路與地理出口回傳不同結果也可能正常。清除快取前先記下原始結果，清除後重新開啟應用程式並再次查詢，避免只因網頁偶然恢復就判斷問題原因。

nslookup example.com
ipconfig /flushdns

若查詢立即逾時，請檢查系統目前設定的 DNS 伺服器是否可連線，以及是否指定至已離線的區域網路裝置。企業或校園網路可能仰賴內部 DNS 解析專用網域，貿然改用公共 DNS 可能導致內部服務失效。恢復自動取得 DNS 可作為對照，但修改前請先記下原始設定。清除快取只能移除舊結果，無法修復上游無法連線、路由規則錯誤或伺服器未設定記錄等問題。

區分瀏覽器、系統與代理端的 DNS 解析

瀏覽器可能使用獨立的安全 DNS，因此命令列查詢正常、瀏覽器卻失敗並不矛盾。先檢查瀏覽器是否使用自訂解析器、代理擴充功能或獨立網路設定，再用其他遵循系統設定的應用程式進行比較。不要同時修改瀏覽器安全 DNS、系統 DNS 與用戶端 DNS，否則難以判斷是哪一層發揮作用。使用加密 DNS 時，也要確認解析服務本身可透過目前網路或代理連線，避免解決一個網域問題後又引入新的連線依賴。

進行 SOCKS 測試時，socks5h 可將目標主機名稱交由代理端解析，一般本機解析方式可能不同。若兩種方式的結果不同，請檢查本機解析與代理端解析的差異；但這仍不能證明用戶端對所有網域都使用相同路徑。路由策略、核心 DNS 與應用程式自己的解析方式都會影響最終結果。不要直接將 HTTPS 網址中的網域換成 IP 進行簡單測試，因為憑證、SNI 與虛擬主機也會使用原始網域。

檢查分流依賴與解析循環

使用網域規則時，請求可能依網域直接選擇出口；使用位址規則時，核心可能需要先解析網域，才能繼續比對。IPIfNonMatch 等策略只會在網域規則未符合時嘗試解析，並不是「一律由遠端解析」的開關。調整策略前，請先了解規則順序，確認問題網域是否已被前面的規則指定出口。若代理伺服器本身的網域需要透過尚未建立的代理解析，就可能形成啟動依賴循環。

TUN 情境也可能涉及虛擬 DNS 位址與位址對應。虛擬位址不能當成真實伺服器位址填入節點設定；應用程式或核心重新啟動後，舊連線保留的對應也可能失效。修改相關設定後，請重新建立受影響應用程式的連線，必要時重新啟動用戶端，不要繼續使用原分頁中的長連線。若問題只在 TUN 模式出現，先切回一般系統代理模式驗證，將範圍縮小至虛擬網卡、DNS 接管或路由衝突，再檢查進階參數。

最後的驗證應涵蓋代理目標與區域網路資源。若網頁恢復正常，但印表機、內部網域或本機服務失效，表示分流或內部解析仍需調整。不要將所有未知網域永久強制交由單一出口處理。網域規則、位址規則與核心名稱等概念可參閱名詞解釋；若記錄已顯示解析正確，但遠端交握仍失敗，請回到節點章節排查，避免反覆嘗試 DNS 設定。

系統代理無效：核對模式、監聽與應用程式行為

系統代理是將代理位址提供給願意遵循該設定的應用程式，並不會自動接管所有網路請求。v2rayN 的自動設定系統代理、清除系統代理與不變更系統代理，分別代表寫入、移除或保留目前的系統代理狀態；這些設定與路由中的全域、繞過中國大陸、直連並非同一層。前者決定應用程式如何連進用戶端，後者則決定請求進入用戶端後從哪個出口離開。混淆這兩層，是「選了全域模式卻沒效果」的常見原因。

確認核心監聽狀態與入口類型

先在參數設定中查看實際的本機監聽位址、連接埠與協定，再確認系統代理指向是否一致。HTTP、SOCKS 與混合入口不能只看連接埠號碼判斷；混合入口支援的協定請以用戶端說明為準。舊設定可能使用不同連接埠，不要硬套教學中的預設值。監聽本機回送位址適合本機使用，排錯時不必改成監聽所有網路介面；擴大監聽範圍也會增加額外的存取風險。

Windows 可使用以下命令查看 10808 是否正在監聽，以及對應的程序。第一條是 PowerShell 查詢，第二條是命令提示字元與 PowerShell 都可呼叫的系統工具。若沒有結果，先查看核心記錄；若顯示由其他程序占用，記下程序識別碼後，在工作管理員中確認程式來源。不要直接結束無法辨識的系統程序，也不要認為看到連接埠正在監聽，就能證明監聽程序一定是目前的用戶端。

Get-NetTCPConnection -LocalPort 10808 -State Listen
netstat -ano | findstr ":10808"

確認衝突後，優先正常結束占用連接埠的其他代理工具，或在 v2rayN 參數設定中改用未被占用的連接埠。修改後必須重新啟動相關核心，並重新執行自動設定系統代理；瀏覽器獨立代理、終端機環境變數與其他手動設定也要同步更新。只改監聽連接埠、不更新應用程式入口，會造成用戶端正常執行，但請求仍送往舊連接埠的情況。詳細排查方式請參閱本機連接埠占用處理。

區分不同平台的系統入口

若明確指定代理的命令可用，一般應用程式卻不行，請優先檢查應用程式設定。瀏覽器擴充功能可能覆寫系統代理，終端機可能沿用舊的代理環境變數，服務程序也可能使用獨立設定。Windows 的 netsh winhttp show proxy 會查看 WinHTTP 代理，不能代表所有瀏覽器與桌面應用程式目前使用的代理狀態。不要只因該命令顯示直接連線，就一再寫入另一套系統設定。

處理退出後的設定殘留與 TUN 接管

用戶端異常結束後，如果系統仍指向本機代理連接埠，但核心已停止，所有遵循該設定的應用程式都會連線失敗。請先重新啟動用戶端並清除系統代理，再檢查系統代理頁面中的手動入口或自動設定指令碼是否仍存在。若設定由組織政策管理，不要強行覆寫。正常結束用戶端時，也應確認直接連線已恢復，而不只是關閉視窗。多種代理工具同時執行時，後寫入設定的工具可能覆蓋先前設定；請先結束其他工具再測試。

TUN 透過虛擬網路介面接管流量，需要搭配相應權限、路由與防火牆設定，並不是系統代理開關的另一種名稱。一般代理確認可用後，再單獨啟用 TUN 並觀察記錄。若啟用後立刻無法上網，請先關閉 TUN 回到已知可用的狀態，再檢查虛擬網卡、其他 VPN 與安全軟體是否衝突。修復後逐一啟動應用程式，確認流量接管範圍並保留區域網路與必要的直接連線；不要將「所有請求都進入用戶端」誤解為所有請求都必須經過遠端代理。

用戶端閃退：區分介面關閉與核心啟動失敗

先確認故障發生在哪個階段：雙擊後完全沒有視窗、視窗開啟後立即關閉、主介面正常但啟動連線失敗，還是使用一段時間後程序消失。圖形介面與代理核心可能是獨立程序，核心結束不一定會關閉主視窗。記下觸發操作、錯誤原文與系統架構，再決定是否重新安裝。不要連續刪除設定、重建訂閱又切換核心，否則可能遺失設定，也會讓原始問題無法重現。

啟動失敗時，先檢查套件類型、目錄與執行環境

前往取得用戶端頁面，選擇符合系統與處理器的版本。桌面平台優先推薦 v2rayN；Windows 桌面版與傳統 WPF 版採用不同介面技術，執行需求也不同，請查看對應套件的要求，不要把某個套件缺少的元件檔直接複製到另一個套件。macOS 需區分 Apple Silicon 與 Intel；Linux 除了處理器架構，也應選擇適用於該發行版的套件類型。架構不符或缺少執行環境，通常無法靠修改代理規則解決。

若選擇的套件需要解壓縮，請先完整解壓縮至目前使用者有寫入權限的目錄，不要直接從壓縮檔預覽視窗執行。路徑過長、目錄受到保護或檔案遭安全軟體隔離，都可能造成啟動元件缺失。請先查看系統提示與安全軟體記錄，確認遭處理的是哪個檔案，不要直接關閉所有防護。若使用安裝套件，請依一般安裝流程操作，不要與可攜式目錄中的零散檔案混放。Windows 常見選擇請參閱安裝設定與套件類型說明。

核心退出時先檢查設定與連接埠

主介面正常但核心無法啟動時，先查看記錄中的第一個明確錯誤。若連接埠繫結失敗，請參閱連接埠章節；若欄位無法辨識或設定解析失敗，請回想是否剛匯入自訂設定、修改進階參數或切換核心。新設定可能包含目前核心不支援的欄位，也可能有 JSON 語法錯誤。不要只看記錄最後的「程序已結束」，那通常只是結果，真正原因可能出現在前面的解析或啟動資訊。

以下是符合 JSON 語法的最小記錄設定片段，僅用於說明物件、欄位與字串的寫法，並非可直接啟動的完整代理設定。實際使用時，應透過用戶端支援的設定入口調整記錄層級，或在完整設定中的正確位置修改；不要用這一小段覆蓋整個設定檔。排查完成後請恢復一般記錄層級，避免長期累積大量存取記錄。

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

設定中多一個尾隨逗號、引號未閉合，或在要求布林值的欄位中填入數字，都可能導致解析失敗。JSON 語法檢查只能確認結構是否合法，無法驗證欄位是否適用於目前的核心。若沒有明確需求，優先還原剛修改的進階選項，改用圖形介面用戶端產生設定。排查核心切換問題時，應先還原該核心支援的節點與參數組合；不要將 Xray 與 V2Fly 視為所有欄位都能互換的同一個程式。

透過備份與乾淨環境進行比較

完全結束用戶端後，依用戶端的儲存方式備份設定目錄或匯出設定。備份可能包含訂閱與驗證資訊，請存放在受控的本機位置。保留原目錄不變，改在獨立目錄或新的應用程式設定環境中啟動乾淨的執行個體；測試時不要同時執行兩個執行個體，以免搶用相同連接埠。若乾淨環境正常，請逐步還原訂閱與必要設定，不要一次覆蓋所有舊檔案。若問題仍相同，請繼續檢查執行環境、檔案權限與系統層級錯誤記錄。

升級後出現異常，也應先保存目前狀態，確認新舊套件沒有混用、舊程序已結束，以及設定遷移是否完成。不要在用戶端執行時替換正在使用的檔案。macOS 出現系統安全提示時，請確認提示類型與系統提供的處理方式；Linux 則應查看啟動輸出與桌面工作階段相關依賴，不要一律使用更高權限執行。恢復後檢查訂閱、系統代理與退出清理是否正常，再移除暫存測試目錄。回報問題時只提供必要錯誤、系統架構與重現步驟，不要附上完整私人設定。

行動裝置問題：檢查 VPN 權限、個別應用程式與背景限制

Android 優先推薦使用 v2rayNG，採用 Xray 核心；v2flyNG 則是 V2Fly 核心的替代選擇。兩者支援的設定與選項位置不完全相同，不要因介面相似就逐項照抄。排查前記下目前使用的應用程式、所選節點、運作模式與網路，再確認故障是初次連線就失敗、鎖定螢幕後中斷、切換網路後失效，還是只有部分應用程式無法連線。先讓單一用戶端在一種網路下穩定運作，不要同時啟動兩個 VPN 連線進行比較。

首次連線時檢查授權與 VPN 占用

使用 VPN 模式時，系統通常會要求確認建立本機 VPN 連線。若先前拒絕授權，請再次啟動連線並查看授權提示；按鈕顯示已啟動，不代表所有應用程式流量都已進入 VPN。檢查系統是否有其他 VPN、工作設定檔中的網路工具，或啟用中的永遠開啟 VPN 設定。部分系統支援分別管理不同設定檔的網路，個人與工作設定檔中的應用程式也可能受到不同政策控制，不能只憑通知列圖示判斷所有應用程式都已接管。

僅代理模式通常只提供本機代理入口，不會自動將其他應用程式的所有請求轉送至用戶端。若系統或應用程式未設定相應入口，就可能出現節點測試正常、瀏覽器卻未經代理的情況，兩者並不矛盾。請先確認需要 VPN 接管流量，還是只需本機代理，再依目標應用程式支援的方式設定。若系統 VPN 頁面啟用了封鎖未經 VPN 的連線，用戶端尚未建立通道時，基本網路也可能無法使用；請先了解該選項的作用再進行比較，不要反覆重新安裝用戶端。

部分應用程式無法連線時，先檢查個別應用程式代理

檢查個別應用程式代理是否啟用，以及目前使用的是允許清單還是略過清單。相同的應用程式清單在兩種模式中的意思正好相反：一種只讓清單中的應用程式使用代理，另一種則讓清單中的應用程式略過代理。新安裝、分身或工作設定檔中的應用程式可能是不同識別項目，請重新確認清單。瀏覽器可用、特定應用程式卻失敗時，先檢查該應用程式是否遭排除、是否採用獨立網路方式，再查看目標網域是否被路由規則設為直接連線。

不要只為了讓一個應用程式恢復，就將所有網域改用同一個 DNS 或出口。可暫時關閉個別應用程式篩選，使用相同節點與網路測試目標應用程式；若恢復正常，再逐步補齊清單。應用程式也可能快取連線，修改設定後請結束並重新開啟該應用程式。系統瀏覽器、內嵌網頁與獨立應用程式的網路行為不一定相同，因此登入網頁成功一次，不能取代對實際目標應用程式的測試。排查涉及帳戶工作階段時，不要將登入資訊寫入公開記錄。

分別處理鎖定螢幕後斷線與切換網路失敗

若只有鎖定螢幕或切換至背景後才斷線，請優先檢查電池最佳化、背景執行限制與廠商系統的程序清理策略。了解耗電影響後，允許目前使用的用戶端進行必要的背景活動，並確認通知是否仍存在。不要一次對所有應用程式關閉電池管理；只針對相關用戶端進行比較。若程序仍在執行但連線失效，請檢查網路是否在休眠時切換、遠端連線是否需要重新建立，以及系統記錄中是否出現 VPN 已撤銷的訊息。

Wi-Fi 與行動網路切換後，原連線可能仍依賴已變更的位址與網路路徑。先停止並重新啟動用戶端連線，再開啟目標應用程式測試，區分「重新連線即可恢復」與「特定網路始終無法使用」。若只有公共 Wi-Fi 失敗，請先完成網路登入驗證；若只有行動網路失敗，請檢查該網路的基本連線、DNS 與存取路徑。不要反覆切換飛航模式來代替記錄原因，也不要在沒有證據時任意修改 APN 或系統底層網路參數。

安裝相容性與最終復原檢查

安裝失敗時，請核對處理器架構、系統需求、可用儲存空間，以及是否與同名應用程式發生簽章衝突。較新的主流裝置通常適用 arm64；若不確定，請依下載頁說明選擇通用套件，不要從其他應用程式目錄抽取檔案手動補齊。若無法覆蓋安裝，請先備份設定並了解系統提示後再決定是否解除安裝；解除安裝可能會清除訂閱與設定。套件請統一從Android 下載入口選擇，不要混用兩個用戶端的設定目錄。

若 v2rayNG 正常，但 v2flyNG 使用同一節點時失敗，請先確認協定與參數是否受該核心支援，而不是立刻判定裝置異常。回報時請註明用戶端名稱、網路類型、運作模式、個別應用程式策略與觸發步驟，並附上刪除敏感欄位後的錯誤片段。若要重新依主要步驟設定，請返回快速入門教學；只想確認某項設定的意思，則請參閱常見問題，不要用重新安裝取代問題排查。