V2Ray 疑難排解大全
依症狀檢查應用程式入口、核心日誌與連線路徑
首次設定請先依照使用指南匯入訂閱、選擇伺服器並確認連線。本頁適合遇到異常時查閱:先選擇最接近的症狀,再依章節順序逐步縮小範圍。桌面操作以 v2rayN 為主,Android 操作則對應 v2rayNG 與 v2flyNG;選單名稱可能因介面調整而異,請以設定功能和實際日誌為判斷依據。
無法上網:先確認請求卡在哪個環節
顯示「連線成功」通常只代表用戶端已啟動核心或建立本機服務,不表示瀏覽器請求已抵達目標網站。排查時可將連線路徑分成應用程式、本機入站、路由選擇、遠端出站及目標服務五個環節。先關閉其他代理程式,選定一個網站重複測試,同時查看 v2rayN 的日誌區域。不要一開始就更換協定、修改 DNS、啟用 TUN 並重設路由;同時變更多項設定,即使恢復連線也難以判斷真正原因。
基本網路與本機監聽
先清除系統代理,再開啟平常可直接瀏覽的網站。若仍無法連線,請檢查 Wi-Fi、閘道、入口網站驗證及系統時間;必要時在同一裝置改用其他網路。完成網頁驗證後,再重新啟動用戶端連線。基本網路恢復前,代理日誌中的逾時通常沒有獨立的診斷價值。若關閉用戶端後所有瀏覽器都無法上網,也要檢查系統是否仍設有指向本機連接埠的代理,不要立即認定遠端伺服器故障。
接著在 v2rayN 中選取目標伺服器作為目前使用的伺服器,查看是否出現核心啟動錯誤。進入相關設定確認本機監聽位址與連接埠,再檢查瀏覽器或系統代理是否使用相同連接埠。不要根據網路截圖假設連接埠固定:不同設定與入站類型可能使用不同數值。若日誌顯示連接埠已被占用,先關閉其他用戶端,再重新啟動核心;若必須更換連接埠,也要同步修改使用該連接埠的應用程式,否則本機服務即使正常也收不到請求。
透過日誌判斷入口與出站
重新開啟網頁,查看此時是否新增連線日誌。若沒有新紀錄,優先檢查應用程式入口:瀏覽器擴充功能是否覆寫系統代理、應用程式是否使用獨立代理設定,以及目標位址是否列在系統略過清單中。日誌是否記錄連線也會受到日誌層級影響,不能只憑空白視窗下結論;先確認查看的是目前核心的日誌,再暫時啟用足以觀察連線的層級。定位完成後請恢復原有日誌層級,避免持續產生大量紀錄。
| 觀察結果 | 下一步檢查 |
|---|---|
| 應用程式請求未出現在日誌中 | 系統代理、獨立代理與本機監聽連接埠 |
| 請求進入核心,但走 direct | 路由模式、比對順序與預設出站 |
| 走 proxy 後交握失敗 | 遠端位址、傳輸參數、驗證與時間 |
| 只有一個網站異常 | 目標服務、網域規則及網站存取限制 |
如果連線已進入核心,卻被分配到 direct,請檢查狀態列的路由模式和自訂規則順序。路由通常依序尋找符合條件的規則,範圍過廣的直連規則若排在前面,可能會遮蔽後續代理規則。可暫時切換至全域代理模式進行對照,確認是否為分流問題;測試完成後請恢復原模式。「全域」指的是用戶端的路由選擇,並不表示系統中每個程式都會自動接入;未使用本機代理的應用程式仍可能完全略過用戶端。
判斷是整條連線路徑故障,還是單一網站異常
若多個不同網站都無法連線,請接著查看節點連線與 DNS 章節;若只有一個網站異常,先改用其他瀏覽器或新開工作階段,並確認該網站是否正在維護、是否要求登入,以及靜態資源網域是否套用了不同路由。網頁文字已顯示、圖片卻一直載入,通常表示頁面依賴多個網域,不能只檢查網址列中的主網域。將同一時間的請求與規則逐一比對,比反覆重新整理整個頁面更容易找出差異。
節點逾時:分開檢查位址連線與協定交握
逾時表示某個步驟未能在指定時間內完成,不能只憑這個訊息就認定伺服器故障。用戶端的測試功能可能測量 TCP 連線、經由代理存取測試網址,或採用其他方式;不同測試的對象並不相同。先確認功能名稱與日誌,再用瀏覽器的實際請求重現問題。若測試網址本身無法使用,節點清單中的測試結果也可能全都異常;不要因此大量刪除伺服器或覆寫原有訂閱。
先確認位址、連接埠與連線階段
在伺服器編輯視窗中檢查位址是否完整、連接埠是否與服務提供者給的值相同,以及複製時是否混入空格或換行。若位址是網域名稱,也要確認系統能解析該網域。若日誌顯示連線遠端位址時就逾時,應優先檢查網路路徑、伺服器可用性與連接埠;若已建立連線,之後才出現 TLS 或驗證錯誤,則應檢查傳輸安全與協定參數。混淆這兩類錯誤並修改設定,通常只會拖長排查時間。
在同一裝置改用另一個網路,可有效區分本機網路限制與伺服器問題;在同一網路改用已知可用的設定,則有助判斷故障是否集中於特定伺服器。對照時請維持用戶端、目標網站與路由模式不變。若在企業網路中測試,請先確認是否需要入口網站驗證或指定出口,並遵守網路使用規定。不要為了通過測試而任意開放系統入站防火牆;出站連線失敗與對外開放本機服務是兩回事。
TLS、傳輸與 REALITY 參數
連線建立後若出現憑證相關錯誤,先校正裝置日期、時間與時區,再確認伺服器名稱設定是否符合設定來源。TLS 的伺服器名稱與連線位址可以不同,但不能憑經驗互相替換。憑證鏈不受信任、名稱不符與交握逾時是不同狀況,應依完整錯誤訊息分別處理。關閉憑證驗證不是一般修復方式,這可能掩蓋設定錯誤,也會降低連線身分驗證的安全性;請修正名稱、時間或伺服器端憑證條件。
使用 WebSocket 或 gRPC 時,請逐項比對傳輸類型、路徑、Host 或服務名稱。路徑大小寫、開頭的斜線,以及服務名稱中的字元都可能影響比對;連接埠可連線不代表這些參數正確。透過分享連結匯入後,仍應確認欄位是否完整辨識;若來源格式超出用戶端支援範圍,介面中可能會缺少欄位。不要把「傳輸類型」當成可任意切換的加速選項,用戶端與伺服器端必須採用相容設定。
VLESS 搭配 REALITY 時,請核對伺服器端指定的伺服器名稱、公鑰、短識別碼及流量控制要求;這些欄位用途不同,不能互相替代。也要確認所選核心支援目前的組合。v2rayNG 與 v2flyNG 使用的核心家族不同,不應假設同一分享連結在兩者上都能以相同方式運作。最穩妥的復原方式是重新取得有效設定,完整匯入後再測試,而不是從不同教學中拼湊幾組看似相同的欄位。
重試間隔與結果記錄
連續快速重新載入,可能使短暫的網路恢復、伺服器連線限制及舊程序結束等狀況互相重疊。每次修改後先等待核心啟動完成,只送出一次明確請求,再查看對應時段出現的第一個錯誤。若多個錯誤接連出現,通常應先處理最早發生的失敗;後續連線關閉可能只是連帶結果。記錄「使用哪個網路、哪台伺服器、存取哪個目標、卡在哪個步驟」,並保留一份可用設定以便復原,會比只截取一則逾時提示更有幫助。
回報給設定提供者時,可說明連線是在連接遠端時失敗,還是 TLS 交握後才失敗,並附上已隱去敏感資訊的日誌片段。不要傳送完整訂閱網址或驗證欄位。若其他伺服器都能穩定運作,而這份設定在不同網路下始終卡在相同交握階段,繼續修改本機路由的效益不大;此時應確認遠端服務狀態與設定有效期限。欄位常見用途可搭配FAQ閱讀,避免把網路逾時與協定不相容混為一談。
訂閱失敗:分辨取得失敗與內容解析失敗
更新訂閱包含兩個獨立步驟:先從訂閱網址取得回應,再將回應解析成用戶端可辨識的伺服器資料。出現「更新失敗」時,先查看日誌是否顯示連線、憑證、狀態碼或解析錯誤。能在瀏覽器開啟網址,不代表回應內容就是訂閱;瀏覽器也可能顯示登入頁面、驗證頁面或帳號到期通知。不要將網頁內容另存後反覆匯入,也不要因一次取得失敗就刪除仍可使用的伺服器資料。
確認訂閱網址與取得方式
進入訂閱群組設定,檢查網址是否完整,特別留意結尾參數、複製時混入的空格,以及通訊軟體截斷長網址的情況。訂閱網址通常含有帳號存取權限,應視為敏感資訊妥善保管。若曾在截圖或討論區公開網址,請在服務提供者允許的情況下重設網址,再更新本機群組。一般網頁網址、使用者控制台網址與訂閱介面並非同一項目,必須使用來源明確提供的訂閱入口。
在 v2rayN 中,可依目前網路狀況嘗試「更新訂閱(不透過代理)」或透過代理取得,實際名稱以介面為準。若直連失敗但代理可用,可透過現有可用伺服器更新;若代理已失效,繼續依賴該代理取得訂閱可能形成循環。請保留原有群組,並透過明確可行的方式重試。企業網路的網頁驗證或本機網路尚未就緒,也可能使訂閱請求收到非預期內容。
依回應類型選擇處理方式
若日誌記錄 HTTP 狀態碼,請區分權限遭拒、網址不存在、請求受限與伺服器錯誤。權限問題通常需要確認訂閱是否已失效、參數是否完整;若請求過於頻繁,應停止連續點擊,稍後再試。憑證錯誤則先檢查裝置時間與本機信任環境。不要把所有錯誤狀態碼都歸因於「用戶端太舊」,也不要為了下載訂閱而任意略過憑證驗證,以免掩蓋取得路徑中的實際問題。
| 失敗情況 | 處理方向 |
|---|---|
| 連線逾時或網域解析失敗 | 檢查網路、DNS 與訂閱取得方式 |
| 回應是登入頁面或提示頁面 | 確認介面、授權狀態與網址是否有效 |
| 有收到回應,但無法解析 | 檢查訂閱格式與協定支援範圍 |
| 更新後伺服器設定欄位不完整 | 核對原始來源欄位與用戶端相容性 |
就內容格式而言,分享連結集合、經 Base64 編碼的訂閱與原生 JSON 設定,不能只根據副檔名判斷。Base64 是一種編碼方式,不代表內容一定包含正確的伺服器資訊;原生核心 JSON 也不一定能直接貼到一般訂閱欄位。請使用用戶端對應的匯入入口,並確認支援的資料結構。若只有一條分享連結,可先從剪貼簿匯入,測試是否能辨識,藉此區分格式問題與遠端取得問題。
更新後的群組與目前使用的伺服器
更新成功後,請檢查目標群組是否出現預期資料,再確認目前使用的伺服器。更新訂閱可能會變更資料名稱,或移除已撤下的設定,先前選取的項目不一定仍有效。不要只看到「更新成功」就認為連線已恢復。先選取一筆資料並啟動連線,再瀏覽固定網站,之後才判斷是否需要進一步檢查交握參數。若有多個名稱相似的群組,尤其要確認更新、檢視與連線的是不是同一個群組。
自動更新間隔不宜設得太短。頻繁取得不會修復錯誤網址,反而可能觸發介面請求限制;定時更新也可能剛好遇上裝置從休眠喚醒或切換網路。若手動更新可用、自動更新偶爾失敗,先觀察失敗時間與裝置網路狀態的關聯,不必立刻重建所有設定。若需調整群組結構,請先使用用戶端匯出功能備份可復原的副本,並存放在受保護的位置。
不同訂閱格式與轉換限制,請繼續閱讀V2Ray 訂閱格式詳解。排查結束後應留下明確結論:問題出在網址權限、取得方式、回應格式,還是設定相容性。這項結論有助判斷後續該聯絡誰、修改哪裡,也能避免下次遇到相同提示時又從刪除用戶端開始處理。
速度慢:分別觀察初始回應、持續傳輸與應用程式差異
「速度慢」可能是開啟網頁前等待很久、圖片載入不順、檔案傳輸不穩,或影片播放反覆緩衝。這些現象的瓶頸各不相同。先確認延遲發生在哪個階段,再固定裝置、網路、目標與伺服器進行測試。不要用單一節點的測試結果代替實際應用體驗;延遲反映往返或測試請求所需時間,不能直接推論持續傳輸速率,更不能代表特定網站的服務狀態。
建立可比較的測試條件
先暫停其他大量傳輸工作,確認裝置是否啟用省電模式,以及無線訊號是否穩定。背景同步、系統更新及其他裝置占用網路出口,都可能讓代理連線忽快忽慢。必要時可在同一網路下改用有線連線對照,或將裝置移近無線基地台後重新測試。每次只改變一項條件,避免同時更換伺服器、網路與瀏覽器,否則無法判斷改善來自哪個環節。
若只有首次開啟網站時較慢,之後的頁面都正常,應優先觀察 DNS 查詢、連線建立與 TLS 交握。若頁面很快出現,但大型檔案持續傳輸緩慢,則更需要檢查出口頻寬、遠端負載、目標服務限速與連線封包遺失。若只有特定影片或下載網站較慢,可用其他類型的內容對照;目標服務可能依出口位置、帳號或內容傳遞節點採取不同策略,不一定能靠修改本機連接埠解決。
確認實際路由,避免誤判原因
查看速度慢的請求最後走 direct 還是 proxy,尤其留意網站的圖片、影片與 API 網域。主頁面經代理、靜態資源直連,或反過來的組合,都可能造成部分內容載入停滯。若自訂規則範圍過廣,請縮小比對範圍並確認規則順序。暫時切換全域模式可用於對照,但不應直接當成長期結論:全域模式改變的是流量路徑,無法消除無線干擾、遠端壅塞或目標服務本身的等待。
比較兩組伺服器設定時,請維持其他條件不變,並分別記錄網頁首次開啟與持續傳輸的體驗。如果一組設定在多個目標都較慢、另一組正常,可優先懷疑該連線路徑或遠端資源;若所有設定都只有同一個目標較慢,則應檢查該目標的解析與服務策略。不要為了追求某項測試數值而連續重新載入核心;舊連線中斷及快取重新建立會干擾觀察,造成愈測愈慢的錯覺。
傳輸參數與網路邊界
不要盲目啟用多路複用或任意更換傳輸方式。多路複用是否有幫助,取決於協定支援、連線模式與伺服器端條件;某些情況下還可能讓多個請求集中在同一條壅塞路徑。WebSocket、gRPC 與其他傳輸方式都必須符合伺服器端設定,不能只在用戶端下拉選單中切換。遇到網路上的「最佳化參數」建議時,先確認適用的核心與版本,再備份原設定,透過單項對照確認效果,不要長期保留無法說明用途的設定。
使用 TUN 時,如果小型網頁正常,某些大型回應或特定應用程式卻反覆停頓,可留意路徑 MTU 與網路對封包的處理方式,但前提是已有日誌、網路對照與可重現的條件。不要把降低 MTU 當成所有速度問題的通用做法。先透過一般系統代理路徑測試相同目標;若該路徑正常,再集中檢查 TUN、網路介面卡與網路環境。修改後記下原始數值,若沒有改善便能還原。
排查完成後,保留一組日常使用的基準條件:固定測試網站、已知可用的伺服器設定及正常路由模式。之後遇到異常時先與基準比較,不要重新照做所有最佳化建議。若速度隨時段明顯變化,可記錄發生時間並回報服務提供者;維持本機設定穩定,觀察結果才有比較價值。分流規則的具體調整方式,請參閱v2rayN 路由分流設定實戰。
DNS 問題:分辨應用程式、核心與節點的解析
DNS 故障常見表現包括網域無法開啟、等待一段時間後才開始連線,或不同應用程式取得不同結果。排查前先分清三種情況:作業系統如何解析網域、用戶端核心如何解析目標網域,以及用來連線遠端伺服器的網域如何解析。瀏覽器也可能啟用獨立的安全 DNS,繞過系統解析路徑。修改單一 DNS 位址不會自動影響所有層級,必須先確認發生錯誤的查詢是由哪個環節發出。
從錯誤訊息判斷解析層級
若日誌顯示無法解析遠端伺服器位址,請先修復節點網域的基本解析;否則代理通道尚未建立,依賴該通道的遠端 DNS 也無法啟動。若遠端連線正常,只有目標網站網域解析失敗,則應查看目標查詢使用的解析器與出站路徑。不要直接把伺服器位址替換成任意查到的 IP 就結束排查;某些設定依賴伺服器名稱、憑證與動態位址,替換可能只是暫時繞過問題,卻造成後續維護困難。
系統查詢工具只能證明系統目前的解析結果,不能證明瀏覽器或核心也採用相同結果。可在終端機使用下列命令對照系統解析;其中的測試網域是公開示例網域,不涉及帳號資訊。命令執行成功後,仍須查看應用程式日誌,確認實際連線路徑。若系統查詢失敗但瀏覽器可以開啟,可能是瀏覽器使用自己的解析器或快取;若系統查詢成功而用戶端失敗,則應檢查核心 DNS 設定及其出站依賴。
nslookup example.com
路由策略與解析結果的關係
以 Xray 路由為例,domainStrategy決定路由比對過程中何時嘗試將網域解析為 IP。AsIs不會主動為路由比對解析網域;IPIfNonMatch會在網域規則不符合時嘗試比對 IP;IPOnDemand則會在比對需要 IP 的規則時嘗試解析。這是路由層的策略,不等同於 DNS 伺服器清單,也不能與出站中的同名或近似欄位混用。修改前應先確認所在的設定層級。
以下是路由物件的示意片段,必須合併至已有對應出站的設定中,不能直接當成完整用戶端設定啟動。若用戶端已有圖形化路由編輯器,請優先透過介面修改。核心會依規則順序進行比對,示例先處理指定網域,再處理私有位址;實際出站標籤必須符合目前設定。網域是否以網域形式進入核心,也取決於應用程式使用的代理協定與解析方式。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["full:example.com"],
"outboundTag": "proxy"
},
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}
快取、加密解析與循環依賴
修改 DNS 後,系統、瀏覽器與應用程式都可能保留舊結果;已建立的連線也不會因更換解析器而自動重新建立。先關閉相關網頁並重新建立連線,必要時依系統提供的方法清除快取,再觀察新請求。尚未確認查詢出口前,不要同時啟用多項加密解析功能;瀏覽器、用戶端遠端解析與系統解析層層疊加後,結果差異會更難解釋,也可能使網域分流的觀察不完整。
使用必須經過代理才能存取的解析服務時,請特別避免循環依賴:代理伺服器網域必須先能解析,代理通道才能建立;通道尚未建立時,又無法存取依賴代理的解析服務。請依用戶端支援的功能,為啟動階段提供可用的解析路徑,並檢查解析服務自身網域的處理方式。不要將所有 DNS 流量都交給尚未可用的出站,也不要把相同解析設定直接複製到不同核心。
復原驗證至少應涵蓋原本出問題的網域與另一個正常網站,同時確認路由符合預期。網頁恢復瀏覽,但所有連線的出口都改變,不算完成分流排查。若日誌顯示缺少 geosite 或 geoip 資料,這是規則資料載入問題,請前往啟動與閃退章節檢查資源,不要繼續更換解析器。規則前綴與比對順序可參閱Xray 自訂路由規則語法。
系統代理未生效:檢查應用程式是否接入本機入站
系統代理與路由模式是兩個不同層級的開關。前者告訴支援系統代理的應用程式將請求送往何處;後者決定進入核心後的請求要走哪個出站。在 v2rayN 中將路由切換為「全域」,不代表作業系統的所有流量都會由用戶端接管。瀏覽器可能遵循系統代理,命令列工具、遊戲及其他應用程式則可能使用各自的設定。先確認故障應用程式採用的代理方式,再決定是否需要在應用程式內設定代理或使用 TUN。
認識狀態列中的三種選項
「自動設定系統代理」會寫入用戶端所需的系統代理設定;「清除系統代理」會移除相關設定;「不變更系統代理」表示用戶端不主動修改目前狀態,並非自動關閉代理。若先前留下錯誤設定,選擇「不變更」可能使錯誤路徑繼續保留。測試前先記下原有設定,避免覆寫公司網路或其他軟體需要的設定,再明確切換到本次測試所需的選項。
| 設定項目 | 排查時的用途 |
|---|---|
| 自動設定系統代理 | 確認寫入的位址與本機入站連接埠一致 |
| 清除系統代理 | 用於恢復直接連線並排除殘留設定 |
| 不變更系統代理 | 保留目前系統狀態,不會修復既有設定 |
| 路由模式 | 只影響進入核心後的出站選擇 |
進入系統網路設定核對代理位址與連接埠,不要只看用戶端狀態列是否亮起。若系統中的值與介面預期不符,可能是其他代理軟體、瀏覽器擴充功能、自動設定指令碼或管理政策正在寫入設定。一次只執行一個代理用戶端,暫時停用會接管代理的瀏覽器擴充功能,再重新測試。受管理裝置上的代理政策可能由組織統一部署;若設定自動恢復,應先確認管理規定,不要反覆強制覆寫。
手動設定與環境變數
支援手動代理的應用程式,可暫時填入目前用戶端實際提供的本機位址與連接埠進行對照。HTTP 入站應使用應用程式支援的 HTTP 代理方式;SOCKS 入站則應設定為 SOCKS,不能只因連接埠相似就互換。本機監聽位址若限定在裝置本身,其他裝置就無法直接連接該連接埠。排查本機問題不需要開放區域網路存取,也不應把監聽範圍改為所有網路介面作為一般修復方式。
命令列程式可能讀取HTTP_PROXY、HTTPS_PROXY或ALL_PROXY環境變數,也可能完全不理會這些變數。在圖形介面中修改系統代理後,已開啟的終端機不一定會更新程序環境。若只有命令列失敗,請查看工具本身的代理說明與目前環境變數;若只有瀏覽器失敗,則檢查擴充功能、設定檔及獨立代理設定。不要根據單一應用程式的行為推論整個系統狀態;應用程式間的差異正是判斷入口問題的線索。
TUN 與退出後的復原
TUN 是另一種流量接入方式,可能涉及虛擬網卡、路由表、權限與 DNS 接管,並不是系統代理選項的別稱。若系統代理路徑原本可用,應先完成該路徑的基準測試,再決定是否排查 TUN。兩種機制同時啟用且設定不明,可能造成部分流量繞路或形成迴圈。遇到權限提示時,只授予必要權限,不要把長期以高權限執行整個用戶端當成唯一解法。
若結束用戶端後網路立即失效,請檢查系統代理是否仍指向已停止監聽的本機連接埠。重新開啟用戶端並執行「清除系統代理」,再到系統網路設定確認已恢復;也要排除應用程式內獨立設定的手動代理。強制結束程序、系統異常關機或軟體衝突,都可能中斷結束時的清理作業;復原時應先處理殘留設定,再考慮是否重新安裝。重新安裝程式不一定會清除系統中獨立保存的代理參數。
驗證時,使用同一個瀏覽器送出新請求,確認日誌中能看到對應連線,再檢查出站標籤是否符合預期路由。若入口恢復但走錯出站,應回頭檢查分流規則,而不是繼續修改系統代理。不同桌面環境支援的代理設定範圍也不盡相同,尤其 Linux 應用程式可能使用各自的網路堆疊;必要時請在應用程式內明確設定。首次設定可搭配使用指南建立可重複的接入流程。
啟動與閃退:分別檢查介面、核心與設定資源
用戶端視窗無法開啟、視窗開啟後核心啟動失敗,以及連線一段時間後程序結束,是三種不同問題。先記錄故障發生的時機:雙擊程式後立即結束、選擇伺服器後出現錯誤,還是更新訂閱或規則後才發生異常。v2rayN 的圖形介面與代理核心負責不同工作;介面能正常顯示,不代表核心已經執行;同樣地,核心結束也不一定代表整個用戶端閃退。請分別查看應用程式提示、核心日誌與系統錯誤紀錄。
安裝檔、架構與執行環境
先確認安裝來源與裝置的作業系統、處理器架構相符。桌面版優先推薦 v2rayN;Windows 桌面版與傳統 WPF 版在介面及執行環境需求上有所不同;macOS 與 Linux 也應選擇符合晶片和發行版的安裝來源。需要重新取得程式時,請透過用戶端下載頁確認平台說明。不要只靠檔案圖示判斷架構,也不要從舊目錄隨意抽出單一執行檔替換,以免程式與附帶資源版本不符。
若程式需要執行環境,請依安裝提示和系統錯誤訊息安裝相應元件,不要下載名稱相似但不確定用途的元件。檢查安裝位置是否可寫入及執行、是否位於受限目錄,以及安全軟體是否封鎖程式或資源。查看封鎖紀錄後再決定如何處理,不要直接關閉整套安全防護。Linux 另須檢查檔案權限與桌面啟動項目;macOS 則依系統的安全性與權限提示確認程式來源及允許方式。
從第一個錯誤判斷核心啟動失敗原因
核心日誌若顯示監聽失敗,通常應先檢查位址或連接埠是否已被占用;若顯示設定解析失敗,則檢查 JSON 語法、欄位位置與目前核心支援範圍。JSON 不允許結尾逗號,欄位值的型別也必須正確,數字、字串與布林值不能任意互換。若使用圖形化用戶端產生設定,應優先修正介面中的來源設定。手動修改暫存產生的檔案可能在下次重新載入時被覆寫,造成「修好又壞」的反覆情況。
listen tcp 127.0.0.1:1080: bind: address already in use
上方文字示範連接埠占用時常見的錯誤訊息;其中連接埠只是範例,不代表用戶端的預設值。確認占用來源後,可關閉衝突程式,或在用戶端修改監聽連接埠並同步調整應用程式代理。不要直接結束用途不明的系統程序。若舊核心程序尚未結束,請先正常關閉用戶端並稍候,再重新啟動;若殘留程序反覆出現,應檢查安全軟體干預、權限與結束日誌,不要只是不斷重新啟動。
規則資料、核心相容性與設定復原
若錯誤涉及 geosite、geoip,請檢查資料檔是否存在、能否讀取,以及目前資料是否包含被引用的集合。規則名稱拼錯與檔案缺失是兩種不同問題,更新資料無法修正錯誤的集合名稱。若自訂規則是從其他核心環境複製而來,也可能用了目前核心不支援的欄位。先撤銷最近新增的一條規則,確認核心能否啟動,再逐條還原;這比一次刪除所有路由更容易保留有效設定。
在 Xray 與 V2Fly 家族核心之間切換時,必須重新確認協定、傳輸方式與擴充欄位的相容性。兩者屬於相關生態系,但不代表所有設定都能通用。若錯誤只在某一種核心出現,先使用該核心明確支援的設定建立基準,再檢查差異。不要透過重新命名檔案強行替換核心,也不要在另一套設定中保留特定核心專用欄位。用戶端提供的切換入口與設定產生方式應配套使用。
若介面在載入使用者資料時閃退,可先結束程式並備份用戶端資料目錄,再依用戶端支援的方式建立獨立乾淨設定進行對照。不要立即刪除原目錄,其中可能包含群組、路由與訂閱資料。若乾淨設定正常,再分批還原設定以找出損壞或不相容項目;若乾淨設定仍失敗,則檢查執行環境、權限與系統日誌。更詳細的錯誤判讀方式請參閱v2rayN 核心啟動失敗排查。
行動裝置專項:VPN 權限、分應用代理與背景限制
Android 上的 v2rayNG 與 v2flyNG 通常透過系統 VPN 介面接入應用程式流量,排查方式與桌面系統代理不同。狀態列出現 VPN 圖示,只能證明系統顯示相應連線狀態,不能代表遠端交握或目標網站存取成功。先在用戶端選擇目前使用的設定並啟動連線,再查看日誌,接著用固定的瀏覽器測試。兩款用戶端使用不同核心家族,涉及特定協定與傳輸組合時,應確認相容性,不要只根據介面相似程度判斷。
系統授權與 VPN 衝突
首次連線時必須確認系統 VPN 授權;若取消授權或受到系統政策限制,本機流量就不會依預期進入用戶端。請檢查是否有其他使用 VPN 介面的應用程式正在執行,例如本機網路過濾工具或工作環境工具。這類應用程式可能會爭用相同的接入位置,啟動其中一個就可能影響另一個。先停止衝突應用程式,再重新建立連線並查看系統提示。由組織管理的裝置可能另有使用限制,應先確認裝置政策允許的使用方式。
系統中的「一律使用 VPN」與「封鎖未經 VPN 的連線」選項,會改變斷線時的網路行為。如果用戶端未執行或連線尚未建立,而系統仍要求所有連線經過 VPN,裝置可能會完全無法上網。檢查這些系統選項前,先了解用途並記錄原有狀態,再進行對照。不要將斷線保護造成的封鎖誤判為 Wi-Fi 故障,也不要未經判斷就重設裝置的所有網路設定;應先讓用戶端與系統政策恢復一致。
分應用規則與網路切換
只有某個應用程式無法存取網路時,請查看用戶端是否啟用分應用代理,以及目前使用的是「僅代理所選應用程式」或「略過所選應用程式」模式。兩種模式的作用相反,選取同一個應用程式會產生完全相反的結果。修改清單後,通常需要依介面要求重新建立連線,讓新規則套用到目前的執行設定。系統應用程式、工作資料夾中的應用程式與一般安裝的應用程式,也可能屬於不同範圍;不能只因名稱相同,就認定選取了正確的項目。
Wi-Fi 正常、行動數據卻無法使用時,先中斷連線,等目標網路穩定後再重新啟動,並檢查行動數據權限、流量限制與入口網站驗證狀態。切換網路會改變位址、路由與解析環境,舊連線不一定能繼續使用。反向情況也採用相同方式對照,並維持伺服器與測試網站不變。如果只在某個網路下出現 DNS 或遠端連線錯誤,請回到對應章節排查,不要直接清除訂閱;訂閱資料不會因網路類型改變而自動失效。
鎖定螢幕後斷線與背景執行
若前景使用正常、鎖定螢幕後連線中斷,應優先檢查電池最佳化、背景活動與系統自動清理規則。不同裝置的設定位置不同,請在系統的應用程式詳細資料中尋找相關選項,並只為需要持續連線的用戶端調整。不要一次修改所有省電策略,否則難以確認是哪個選項造成限制。調整後鎖定螢幕並等待,再喚醒裝置檢查用戶端程序、VPN 狀態與日誌時間,以判斷是程序遭結束、網路暫時休眠,還是遠端連線自行中斷。
從最近使用的應用程式清單中滑除程式、使用一鍵清理或啟用極限省電,都可能影響背景服務。若系統仍顯示 VPN 圖示,但應用程式日誌已停止更新,請重新開啟用戶端確認執行狀態,必要時正常停止後再啟動。不要只憑通知是否仍顯示來判斷連線是否正常。背景持續執行也會消耗裝置資源;連線恢復後,應觀察耗電量、網路用量與穩定性。若資源使用異常且伴隨大量重新連線,請先處理造成重連的網路或設定問題。
安裝更新與復原驗證
請依裝置架構從Android 下載入口選擇安裝檔;不確定架構時,可查看裝置資訊與下載頁說明。安裝失敗時,應分辨架構不相容、未符合系統需求、儲存空間不足,以及現有安裝來源不同等原因。不要只為了試用另一個安裝檔就直接解除安裝,請先保存設定與訂閱資料。更換 v2rayNG 與 v2flyNG 也不只是替換外觀,還必須確認待匯入設定所需的核心功能。
最終驗證應涵蓋前景瀏覽、鎖定螢幕後喚醒及一次網路切換,逐項確認請求仍能進入用戶端,且路由符合預期。使用分應用模式時,還應分別檢查一個預期走代理及一個預期略過代理的應用程式。只記下復原所需的最少設定,其他系統選項維持原狀。若仍需回報問題,請提供裝置系統、用戶端名稱、網路類型及已隱去敏感資訊的錯誤片段;基本操作可返回使用指南,零散設定疑問則可查閱常見問題。