設定手冊 / 依症狀排查
v2rayN 疑難排解大全
從請求入口到遠端連線,逐層檢查系統代理、監聽連接埠、路由、DNS 與核心記錄。
首次設定請先完成快速入門教學中的匯入、選取節點與連線驗證。本頁適用於連線異常時查閱:依症狀前往對應章節,每次只修改一項設定,再以相同請求重新測試。
診斷層級 › 應用程式入口 › 本機監聽 › 對外連線
無法上網:先釐清「已連線」代表什麼
主視窗選取伺服器、核心正在執行、系統代理已啟用,是三種不同狀態。節點顯示為作用中,只代表後續請求準備使用該節點,不表示已成功與遠端交握。排查時先分辨「所有應用程式都無法連線」、「只有瀏覽器失敗」或「只有部分網域失敗」。同時記下使用的用戶端、作業系統、代理模式,以及問題首次發生的時間,方便後續比對。
確認直連與代理的故障範圍
先在 v2rayN 系統匣選單選擇「系統代理 → 清除系統代理」,並暫時關閉 TUN 模式。接著造訪平時可直接連線的網站,確認裝置本身能上網。旅館、校園或公共 Wi-Fi 可能需要先完成登入驗證;若清除代理後仍完全無法連線,應先排除網路連線、閘道器或系統 DNS 問題,不要繼續調整節點參數。測試完成後,重新選擇「自動設定系統代理」。
接著關閉其他代理程式與瀏覽器代理擴充功能,只保留 v2rayN。多個程式輪流修改系統代理時,介面顯示可能與實際設定不一致。若只有某個瀏覽器出問題,請用新建的臨時瀏覽器設定檔重新測試,避免既有擴充功能、快取或安全性政策造成干擾。不要先刪除原有設定,保留能重現問題的環境更有助於找出原因。
檢查本機混合監聽連接埠
前往「設定 → 參數設定 → Core:基礎設定」,確認「本機混合監聽連接埠」。以下指令以連接埠 10808 為例;若實際設定不同,請一併修改。明確指定代理可略過系統代理入口,用來確認用戶端本機監聽與對外連線是否正常。指令請在 Windows PowerShell 中使用 curl.exe,避免與其他同名指令混淆。
curl.exe -I --connect-timeout 10 --max-time 20 --proxy http://127.0.0.1:10808 https://example.com/
若收到 HTTP 回應標頭,表示這次請求已完成代理連線,但不代表所有網站都能使用。若立即顯示無法連線至本機位址,請檢查核心是否已啟動、連接埠是否被占用。若等待後逾時,再檢查遠端連線與 DNS。若出現憑證錯誤,先確認系統時間與目標憑證,不要直接停用憑證驗證。若目標網站本身異常,請改用另一個已知可連線的測試網址交叉確認。
透過記錄區分入口、路由與交握
開啟主視窗的記錄區,清除舊內容後只送出一次請求,觀察同一時間點的資訊。完全沒有相關記錄時,請求可能未進入用戶端,也可能是未啟用存取記錄;請搭配明確指定代理的測試判斷,不要只憑「沒有記錄」下結論。看到本機接入記錄後,繼續檢查目標網域、對外連線標籤與錯誤類型,確認請求是否依規則送往預期的出口。
暫時將「記錄等級」調為 info,有助於查看啟動資訊與錯誤前後文;是否輸出存取記錄,仍取決於使用的核心與記錄設定。重現問題後請恢復為 warning,避免長時間產生大量記錄。分享記錄前,請刪除訂閱網址、伺服器位址、使用者識別資訊與驗證內容,只保留錯誤文字、目標類型與發生順序。
依測試結果修復,避免同時重裝
明確指定代理後能連線、瀏覽器卻失敗,優先前往系統代理未生效;本機連接埠正常但所有遠端連線都逾時,請參閱節點逾時;只有網域無法連線,請檢查DNS 與路由解析。若只有特定網站無法連線,先比較該網站在不同節點與直連狀態下的結果,避免把目標網站的存取限制誤判為整個用戶端故障。
修復後,請回到原本的瀏覽器與網路環境重新測試,確認不是只有在臨時環境中成功。若需要精簡的逐項檢查清單,可參閱顯示已連線卻無法開啟網頁的排查筆記。保留最終有效的修改,並撤回診斷期間額外新增的規則,避免臨時設定掩蓋下次故障。
診斷層級 › 伺服器位址 › 傳輸連接埠 › 協定交握
節點逾時:分辨 TCP 可連線與協定可用
V2Ray 延遲測試的意義不只一種。Tcping 主要反映與伺服器指定連接埠的連線狀況;真連線測試通常會透過所選代理設定向測試網址送出請求。前者成功不代表驗證、TLS 或傳輸設定正確;後者失敗也可能是測試網址無法連線。請先記下測試方式與完整錯誤訊息,避免拿不同指標比較同一個節點。
從位址解析與連接埠連線開始
開啟節點編輯視窗,檢查伺服器位址是否含有多餘空格,以及連接埠是否與服務提供者的資訊一致。位址欄通常只填主機名稱或 IP,不應貼上含路徑的完整網頁網址。若網域無法解析,先確認目前網路的 DNS 狀態;連接埠拒絕連線與等待逾時代表不同狀況。前者通常表示目標可達,但該連接埠未接受連線;後者則可能與網路路徑、防火牆或遠端回應有關。
在 Windows 中可使用 Test-NetConnection 檢查伺服器連接埠,但指令中的位址必須換成實際伺服器,結果也只能用來判斷連線狀況。不要用網站的網頁連接埠代替節點連接埠。若同一節點在手機熱點可用、家用網路卻無法連線,請優先比對兩種網路的 DNS、IPv6、對外連線政策與安全軟體規則,而非立刻修改協定欄位。
檢查 TLS、傳輸與驗證欄位
TCP 已建立連線但交握失敗時,請依服務提供者提供的原始參數,檢查使用者識別碼、密碼、傳輸方式、TLS 開關、伺服器名稱與路徑。WebSocket 路徑與 Host 不等於伺服器位址;gRPC 服務名稱也不是任意備註。欄位應否留白取決於伺服器端設定,不要照抄其他節點的內容。每次只修改一個欄位後重新測試;若仍失敗,請還原原值。
使用 REALITY 的節點還必須符合服務端提供的公鑰、短識別碼與伺服器名稱。不要自行產生新值取代訂閱中的欄位,也不要因為名稱看起來像網站,就改填伺服器 IP。協定參數彼此相關,單獨「最佳化」某個欄位可能破壞整組設定。若匯入訂閱後欄位缺失,請確認用戶端與所選核心能否辨識該設定,再向服務提供者確認。
遇到憑證有效期、主機名稱不符或交握驗證錯誤時,先校正系統日期、時間與時區,再檢查憑證名稱是否符合伺服器名稱。公司網路的 HTTPS 檢查也可能影響連線。不要把「允許不安全連線」當成通用修復方式;這會改變驗證範圍,也無法解決連接埠不通、密碼錯誤或傳輸路徑不符等問題。
透過交叉測試縮小故障範圍
固定同一個測試網址,先比較同一訂閱中的兩個節點,再比較不同網路上的同一個節點。若只有一個節點失敗,問題較可能出在節點參數或伺服器端;若所有節點同時失敗,先檢查本機網路、核心啟動狀態與訂閱是否過期。若只有某種協定類型失敗,請檢查所選核心的支援狀況與該類傳輸共用的欄位,不要因此刪除整份訂閱。
| 測試結果 | 優先檢查項目 | 無法據此判斷 |
|---|---|---|
| Tcping 成功,真連線失敗 | 驗證、TLS、傳輸欄位、測試網址 | 節點已可正常代理連線 |
| 本機監聽連線遭拒 | 核心程序、監聽連接埠、連接埠衝突 | 遠端伺服器已離線 |
| 更換網路後恢復正常 | DNS 解析、對外連線路徑、網路端限制 | 原節點所有參數都錯誤 |
了解測試方式的限制
真連線測試應固定使用同一個網址;更換測試網址後,不要直接與先前結果排名比較。部分網站會限制自動請求、重新導向或拒絕特定出口,因此測試失敗不代表代理完全無法使用。使用瀏覽器實際開啟網頁,並查看同一時間的記錄,可補足自動測試未涵蓋的驗證環節。
若仍然逾時,回報問題時請提供協定類型、傳輸方式、是否啟用 TLS、同一節點切換網路後的結果,以及已去識別化的錯誤資訊。請勿公開完整分享連結。首次選取節點與驗證步驟請參閱首次連線、真連線測速與代理驗證;用戶端下載與平台選擇請前往下載頁面。
診斷層級 › 訂閱請求 › 回應內容 › 節點解析
訂閱更新失敗:先檢查下載,再檢查解析
訂閱更新包含兩個步驟:取得訂閱內容,以及將內容解析為用戶端能辨識的節點。網路逾時、驗證失敗與內容格式不相容,需要採取不同處理方式。先開啟「訂閱群組設定」,確認要更新的是哪個群組,再查看本次更新記錄。不要反覆匯入同一個網址,建立多個重複群組,否則難以分辨舊節點與本次更新結果。
確認網址完整且存取權限有效
編輯訂閱群組,檢查網址開頭、結尾與查詢參數。通訊軟體可能會截斷長網址,複製時也可能混入換行或全形標點。含有驗證參數的訂閱網址本身就是存取憑證,請勿貼到公開網頁、線上轉換工具或螢幕截圖中。若服務提供者已重設網址,舊網址即使仍能開啟,也不代表會繼續傳回有效節點。
訂閱到期、流量額度用盡或帳戶權限變更,都可能讓介面回傳說明頁,而非節點清單。遇到 HTTP 驗證錯誤或禁止存取時,請先到服務提供者的帳戶頁面確認狀態。不要將驗證錯誤誤認為用戶端缺少設定,也不要嘗試修改網址中的識別資訊來繞過權限。確認網址與帳戶狀態都有效後,再進行下一步網路診斷。
分辨直連更新與透過代理更新
v2rayN 的「訂閱群組」選單通常提供更新訂閱與透過代理更新的選項,實際名稱可能因介面版本而異。直連更新失敗,但現有節點仍可使用時,可以嘗試透過目前可用的代理更新。反過來說,若目前節點已失效,透過代理更新也會失敗;此時應先切換到仍可用的節點,或測試直連更新,不要讓更新請求一再依賴同一個故障出口。
若直連與代理更新都失敗,請觀察錯誤發生在哪個階段。網域解析失敗時優先檢查 DNS,連線逾時時檢查網路路徑,TLS 錯誤則檢查時間與憑證環境。瀏覽器能開啟訂閱網址,不代表用戶端一定能取得內容:瀏覽器可能使用不同代理、登入狀態或安全驗證流程。比較時請確認兩者使用相同的網路入口。
下載成功但沒有節點時的處理順序
更新記錄顯示請求成功,但節點數量沒有變化時,請檢查回傳內容是否為網頁、錯誤說明或不相容格式。伺服器即使回傳成功狀態碼,也可能只提供登入頁面。標準分享連結、編碼後的節點清單與其他用戶端專用設定並非相同內容;不要只因副檔名或網址中出現「訂閱」兩字,就認定格式一定適用於 v2rayN。
若只有部分節點匯入失敗,請比對失敗節點的協定、傳輸方式與共用欄位。舊版用戶端可能無法辨識新增參數;此時先備份設定,再從v2rayN 下載頁面選擇適用於系統的安裝檔更新。不要為了成功匯入而手動刪除不明欄位;缺少必要驗證或傳輸參數的節點,即使顯示在清單中也無法連線。
節點「沒有更新」也可能是篩選條件造成的。檢查目前群組、關鍵字篩選與清單排序,確認新節點沒有被隱藏。查看訂閱群組是否設定篩選條件,再比對更新前後的備註與伺服器位址。備註變更不代表新增伺服器,重複節點也不代表更新失敗,應以記錄與實際內容為準。
保留舊設定,建立可還原的更新流程
更新前匯出目前可用的設定,並記下群組設定。備份檔含有敏感節點資訊,請存放於安全的位置。若懷疑某種訂閱格式有問題,可先建立臨時群組單獨測試;成功後再決定是否取代原群組,失敗則刪除臨時群組即可,不必清空所有伺服器。批次刪除、去重與覆寫前,請先確認操作範圍。
排查完成後,再考慮是否啟用自動更新。若每次啟動都立刻更新而卡住,可先暫停自動工作,確認手動更新能否穩定完成。自動重試無法修復無效網址或不相容內容,反而可能掩蓋最初的錯誤線索。記下「使用哪個更新入口、哪種網路、哪個群組」成功,比籠統記錄「重新啟動後就好了」更容易重現。
診斷層級 › 基準比較 › 出口負載 › 傳輸路徑
速度慢:分別檢查延遲、傳輸量與應用程式回應
網頁開啟慢、下載速度低與影片經常緩衝,不一定是同一種問題。連線延遲主要影響建立請求時的等待時間,傳輸量反映持續傳送資料的能力;封包遺失與重傳則可能造成速度忽快忽慢。低延遲節點不一定適合傳輸大型檔案。先確認速度慢發生在首次開啟、持續下載,還是執行一段時間後,再選擇相應的比較方式。
建立條件固定的測試基準
先暫停雲端硬碟同步、系統更新與其他下載,盡量固定測試裝置、Wi-Fi 位置、目標網址與測試時段。不要一邊大量測速,一邊判斷瀏覽器速度;多個並行請求會互相爭用頻寬。使用同一項實際工作比較兩個節點,並重複測試幾次,觀察差異是否持續出現。單次速度峰值可能只是快取或短暫閒置所致,不能代表長期表現。
接著清除系統代理並關閉 TUN,測試基本網路速度。若直連時也明顯變慢,先檢查 Wi-Fi 訊號、路由器負載與寬頻使用情況。若可使用網路線,請進行一次有線比對;手機熱點只能作為另一條網路的參考,不代表頻寬與原網路相同。基準本身不穩定時,繼續調整代理參數容易得到互相矛盾的結果。
比較節點負載與目標網站政策
同一時間只有某個節點速度慢,可能與出口負載、線路品質,或該出口到目標網站的路徑有關。切換節點後固定連線至同一目標,確認改善是否能重複出現。若只有某個下載網站速度慢,其他網站正常,也應考慮目標網站的限速、帳戶等級、連線數限制與內容傳遞政策。更換出口可能改變前往目標網站的路徑,但不保證能解除服務端本身的限制。
不要只憑節點所在地名稱判斷實際線路品質。備註只是標籤,實際路徑仍受服務提供者的部署與網路互連影響。尖峰時段變慢、離峰時段恢復,通常比修改本機監聽連接埠更值得注意。記錄不同時段的實際測試結果與連線錯誤,向服務提供者說明持續性問題,比只提供單一延遲數字更有幫助。
檢查分流、UDP 與 TUN 的影響
先確認速度慢的請求實際使用哪個對外連線。下載工作可能依網域規則直連,瀏覽器也可能透過自己的代理擴充功能使用另一個出口。檢查「路由設定」中的目前預設值與自訂規則,必要時使用範圍明確的臨時規則進行比對,驗證後立即撤回。不要為了測速而將所有私人網路流量送入代理,以免影響區域網路服務與本機裝置連線。
部分應用程式會使用 UDP 或 QUIC。若節點不支援相關流量,可能在等待後才切換連線方式,表現為一開始很慢、之後恢復正常。「啟用 UDP」只允許本機進行相關處理,不會讓遠端自動支援 UDP。先用一般 HTTPS 請求建立基準,再比較應用程式本身的協定行為。調整瀏覽器協定選項時,請記下原始值並在測試後還原。
TUN 模式也涉及虛擬網卡、路由接管與系統權限。若只有在 TUN 模式下變慢,先關閉 TUN,以明確指定代理完成相同工作。若明確指定代理時正常,應著重檢查 TUN 路由、DNS 接管與其他虛擬網卡衝突。MTU 不相符可能影響特定路徑,但不要直接照抄網路上的數值;應先確認有大型封包傳輸異常、小型請求正常等跡象,再一次調整一項設定。
避免無效最佳化,驗證長期表現
連線重用、傳輸參數與核心選擇並非開得越多就越快。若與伺服器端設定不符,額外啟用功能反而可能造成相容性問題。保留訂閱提供的預設傳輸設定,先處理明顯的封包遺失、出口負載與路由錯誤。切換核心後若速度變快,也要確認使用的是同一個節點與規則,避免把不同路徑的差異歸因於核心本身。
最後請透過日常使用的應用程式持續觀察,不要只看測速頁面。記錄回應變慢發生在哪個階段、是否伴隨連線錯誤,以及切換節點或網路後能否恢復。若問題與路由規則命中有關,可進一步閱讀geosite 與 geoip 分流設定。速度排查的目標是找出穩定的瓶頸,而不是反覆切換設定碰巧得到一次較快的結果。
診斷層級 › 系統解析 › 核心 DNS › 路由解析
DNS 問題:確認網域由哪一層解析
同一個網域可能透過系統 DNS、瀏覽器安全 DNS、核心 DNS 或代理伺服器端解析。修改系統 DNS 後沒有變化,不代表設定未儲存;請求可能根本沒有使用該設定。先記下應用程式、代理入口與節點類型,再查看記錄中的解析錯誤。確認解析發生在哪一層後,才能判斷應修改系統設定還是核心設定。
分辨網域解析錯誤與連線錯誤
記錄中的網域不存在、解析逾時與連線目標逾時,應分開處理。解析成功只表示取得位址,不保證位址正確或能建立連線。也不要只憑「IP 可連線、網域不行」下結論:透過 HTTPS 直接連線 IP,可能因憑證名稱、伺服器名稱指示與網站虛擬主機而失敗,這不代表 DNS 本身有問題。
可在系統終端機執行 nslookup example.com,查看系統 DNS 是否有回應。但這項工具通常不會使用瀏覽器的安全 DNS,也不會自動沿用 v2rayN 的核心 DNS。它適合驗證系統層,無法單獨證明代理請求的 DNS 解析路徑。比對時請記錄使用的解析器,避免直接比較兩條不同路徑的結果。
了解 domainStrategy 的作用範圍
routing.domainStrategy 控制路由比對時如何使用網域與解析後的 IP。AsIs 傾向保留網域來比對規則;IPIfNonMatch 則會在網域規則未命中時嘗試解析,再繼續比對 IP 規則。這個欄位不是「所有 DNS 請求都透過代理」的總開關,也不能取代應用程式或系統層的 DNS 設定。
以下是 Xray/V2Ray 格式的局部設定,用於說明欄位之間的關係,並非完整的用戶端設定。請將內容合併至對應核心的設定架構,並確認既有直連出口標籤確實為 direct。v2rayN 的圖形化路由編輯器會產生設定,不建議直接修改執行期間的暫存檔,否則下次啟動時可能被覆寫。規則資料庫也必須包含所引用的資料。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}
檢查解析伺服器是否可連線
設定 DoH 時,需一併考慮解析伺服器位址、憑證驗證與連線路徑。DoH 使用加密傳輸,但不會自動決定請求要直連還是透過代理。若解析伺服器的網域本身需要解析,而其連線又依賴尚未建立成功的代理,就可能形成啟動依賴。請依使用核心支援的引導解析與路由方式規劃,不能只更換一個 URL。
先恢復成已知可用的 DNS 設定,確認基本解析正常,再逐項加入分流設定。不同核心的 DNS 欄位並不完全相同,不要把某個核心的設定片段直接貼到另一個核心。介面中的「DNS 設定」與「TUN 模式設定」可能分別管理不同環節,請確認目前使用的核心與接管範圍,再選擇適當的設定入口。
若只有啟用 IPv6 後部分網站逾時,請檢查本機是否有可用的 IPv6 路由,而不只是網卡是否顯示 IPv6 位址。某些網路能取得 IPv6 記錄,卻無法完成連線。可透過受控設定比較僅使用 IPv4 的結果,但不要把停用 IPv6 當成所有 DNS 問題的預設解法;修復後應重新評估原本的需求。
清除快取並驗證解析路徑
完成修改後,請關閉並重新開啟相關應用程式;必要時可在 Windows 執行 ipconfig /flushdns,清除系統 DNS 快取。這個指令不會同時清除瀏覽器快取、核心快取與伺服器端快取。重新測試前請固定使用同一個目標網域,並觀察錯誤是否由解析失敗轉為連線失敗;錯誤階段改變代表排查有所進展,不應簡單判定為「還是沒用」。
線上 DNS 檢測顯示的是該檢測方式能觀察到的解析出口,不能證明所有流量路徑。瀏覽器安全 DNS、快取與代理模式都會影響結果。分流細節請參閱DNS 與 DoH 設定筆記,路徑驗證請參閱DNS 洩漏檢測與防洩漏設定。先確認預期的解析出口,再判斷檢測結果是否符合預期。
診斷層級 › 應用程式代理 › 系統入口 › TUN 接管
系統代理未生效:確認應用程式是否讀取設定
「自動設定系統代理」主要是將本機代理入口寫入作業系統設定,不代表每個應用程式都會使用該入口。有些應用程式使用獨立代理,有些只讀取環境變數,有些則直接建立通訊端連線。排查重點不是反覆點選啟用,而是確認目標應用程式採用哪種入口,以及該入口是否指向目前正在監聽的位址與連接埠。
比對系統設定與實際監聽狀態
在 v2rayN 主視窗底部或系統匣選單選擇「系統代理 → 自動設定系統代理」,接著開啟 Windows「設定 → 網路和網際網路 → Proxy」,核對位址與連接埠。位址通常指向本機迴路位址,連接埠必須與「本機混合監聽連接埠」一致。若設定隨即被改回,請檢查其他代理軟體、管理工具或組織政策是否正在接管。
可使用下列指令查看常用連接埠的監聽狀態。若沒有輸出,先確認實際連接埠是否不同,再檢查核心程序;即使有輸出,也不代表監聽者一定是 v2rayN,還需透過程序編號確認是哪個程式。排查時不要任意終止系統程序。若連接埠被其他應用程式占用,可改用未占用的連接埠,但系統設定與手動設定的應用程式也必須一併修改。
Get-NetTCPConnection -State Listen -LocalPort 10808 |
Select-Object LocalAddress, LocalPort, OwningProcess
不需要為了本機應用程式啟用「允許來自區域網路的連線」。這項設定會改變監聽服務的可連線範圍,卻不會讓忽略系統代理的程式開始讀取設定。只有其他裝置確實需要連線到這台電腦時,才一併評估監聽位址、防火牆與存取範圍。診斷完成後,請恢復原本最小化的監聽範圍,避免長期保留臨時排錯設定。
排除瀏覽器與命令列工具的獨立入口
瀏覽器代理擴充功能、企業政策或瀏覽器本身的設定,可能會覆寫系統代理。先停用擴充功能並重新開啟瀏覽器,再與明確指定代理的請求比較。命令列工具則可能讀取 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY 等環境變數;已開啟的終端機會保留啟動時的環境。修改變數後請開啟新的終端機,不要只在原本的視窗重複送出請求。
Windows 的使用者代理與 WinHTTP 代理並非完全相同的設定來源。netsh winhttp show proxy 可查看後者,但若顯示直連,也不能證明一般瀏覽器沒有使用使用者代理。不要任意執行全域重設指令處理所有應用程式;先確認目標程式讀取哪一套設定,再查閱該程式的官方代理選項,以免影響系統服務或組織設定。
分辨 PAC、分流規則與應用程式略過設定
若使用 PAC,指令碼會決定哪些請求送往代理入口;核心路由則會在請求進入用戶端後,決定使用哪個出口。這是兩個不同層級的分流。網站未出現在代理記錄中,可能是在 PAC 階段已直連,也可能是應用程式根本未使用系統代理。為了縮小問題範圍,可暫時改用明確指定的本機手動代理入口進行測試,再檢查核心規則,而不是同時修改兩個層級。
若請求已進入核心卻使用錯誤出口,請檢查「路由設定」中的規則順序。較明確的規則應放在可能先匹配的通用規則之前,並保留區域網路存取需求。網域比對也會受到流量探測與 DNS 政策影響,不應只根據最終 IP 猜測命中的規則。重新測試時,請使用相同網址與瀏覽器,避免重新導向產生其他網域而影響判斷。
需要使用 TUN 時再檢查接管條件
目標應用程式不支援代理入口時,可評估使用 TUN 模式。啟用前先確認一般系統代理連線正常,再依系統要求授予虛擬網卡與路由管理權限。TUN 並非修復遠端節點故障的開關;若明確指定代理也無法連線,請先解決節點問題。啟用後檢查其他虛擬私人網路、虛擬機器網卡與安全軟體是否同時修改路由,避免重複接管。
macOS 與 Linux 的桌面代理入口各有不同,應用程式是否遵循桌面設定也不盡相同。請勿照搬 Windows 的系統路徑。若要重新建立基本設定,請回到教學中的系統代理步驟;排查完成後,關閉多餘的代理工具,並確認重新開啟應用程式與用戶端後,設定仍保持一致。
診斷層級 › 圖形介面 › 核心程序 › 執行環境
用戶端閃退:區分介面退出與核心退出
視窗無法開啟、視窗閃退、核心不斷重新啟動,以及連線後程式退出,是四種不同問題。先記下最後一次正常執行時間與近期變更:是否更新用戶端、移動資料夾、匯入自訂設定或啟用 TUN。不要立刻刪除整個資料夾;若設定、記錄與執行檔一併清空,往往只剩下無法重現的現象。
先確認系統、處理器架構與安裝位置
請從下載頁面依平台與處理器選擇安裝檔。Windows 桌面版與傳統 WPF 版採用不同的介面架構,不能因此認定設定資料夾可以任意互相覆蓋;macOS 需區分 Apple Silicon 與 Intel;Linux 則須符合發行版套件格式與處理器架構。若選錯安裝檔,請重新選擇,不要藉由更改檔名或混入其他架構的檔案嘗試啟動。
若以解壓縮資料夾執行,請先完整解壓縮,不要直接從壓縮檔預覽中開啟。確認資料夾可寫入、磁碟空間足夠,且路徑不是受限的暫存位置。可攜式設定與安裝版設定的儲存位置可能不同,不要憑經驗將備份覆寫到程式資料夾。請先使用用戶端匯出功能,或依實際資料目錄建立備份,再進行移轉與更新。
使用最小設定區分資料問題
完成備份後,在獨立資料夾或獨立使用者資料環境中啟動相同平台的用戶端,不匯入舊設定,先觀察空白設定能否穩定開啟。不要讓兩個執行個體同時占用同一個連接埠。若新環境正常,請逐項匯入訂閱、路由與 DNS 設定;每匯入一類就重新啟動並檢查,即可定位問題是資料損毀,還是特定自訂功能所觸發。
若空白設定也會閃退,請檢查系統錯誤記錄與執行環境提示。Windows 可在事件檢視器的應用程式記錄中查看故障模組;macOS 可查看系統提供的當機報告;Linux 可從終端機啟動圖形程式,觀察啟動錯誤。請記錄錯誤文字,不要只截取最後出現的視窗。執行相依套件的需求以對應安裝檔說明為準,不要從不明網頁安裝不明元件。
核心退出時,先查看第一個錯誤
圖形介面正常,但核心無法持續執行時,請優先查看啟動記錄中的第一個明確錯誤。監聽連接埠衝突、設定欄位不合法、缺少規則資料與權限不足,都可能造成後續一連串連線失敗。處理第一個錯誤後重新啟動,再判斷剩餘問題。不要把最後出現的「連線遭拒」當成根本原因,因為它可能只是核心已退出的結果。
若使用自訂設定,請確認語法正確、出口標籤存在,且規則引用的資料可用。不同核心的欄位不能混用;切換核心後也應檢查相關自訂片段。自動產生的執行設定可能在下次啟動時重新建立,修復時應回到圖形介面設定或自訂設定來源。若問題只在新增路由後出現,先撤銷該項設定,不要同時更換用戶端與節點。
| 現象 | 保留的記錄 | 優先處理方式 |
|---|---|---|
| 視窗啟動後立即退出 | 系統當機記錄、故障模組 | 以獨立資料環境測試並檢查執行相依套件 |
| 視窗正常,核心退出 | 啟動記錄中的第一個錯誤 | 檢查連接埠、設定、規則資料與權限 |
| 啟用 TUN 後發生異常 | 虛擬網卡與路由錯誤 | 關閉 TUN,使用一般代理進行比對 |
更新、回退與安全軟體處理
若問題在更新後才出現,先保存錯誤資訊與舊設定,再於隔離環境比較更新前後的行為。不要將舊版的所有程式檔案覆寫到新資料夾中,混用執行檔可能引發新的相容性問題。若需回退,請使用先前保留且來源明確的完整安裝檔,並另行保存目前資料,避免新舊設定格式互相覆蓋。
遇到安全軟體攔截時,先查看具體記錄、檔案路徑與觸發時間,再確認是否與啟動失敗相符。不要把關閉所有防護當成一般處理方式,也不要將整個磁碟加入排除清單。受工作或學校管理的裝置,應由管理員確認允許範圍。修復後清除殘留的系統代理,重新開啟用戶端並實際連線一次,確認圖形介面與核心都能穩定執行。
診斷層級 › VPN 授權 › 應用程式分流 › 背景執行與網路切換
Android 專項:連線權限、依應用程式分流與背景斷線
Android 建議優先使用 v2rayNG,v2flyNG 則可作為採用 V2Fly 核心的替代選項。桌面版的「系統代理」概念不能直接套用到 Android:用戶端通常透過系統 VPN 介面接管流量,再由設定決定對外連線方式。畫面出現 VPN 圖示只代表系統通道已建立;遠端節點仍可能驗證失敗或逾時,必須搭配實際連線與記錄判斷。
首次啟動與 VPN 授權
匯入節點並選取目標伺服器後,啟動連線時請確認系統彈出的 VPN 授權視窗。若授權視窗未出現或被其他畫面遮住,請先切回前景再試一次,並檢查是否有另一個 VPN 應用程式正在執行。Android 通常只允許一個應用程式占用目前使用者的 VPN 通道;兩個用戶端交替啟動可能互相取代,造成看似隨機的斷線。
請從Android 下載頁面選擇符合裝置架構的安裝檔。多數較新的裝置使用 arm64;若不確定架構,可查看系統資訊或選擇通用版。若安裝失敗,請先分辨是系統版本限制、安裝權限、簽章衝突或儲存空間不足,不要只反覆下載。覆蓋安裝遇到簽章衝突時,先匯出設定,再評估解除安裝與重新安裝對資料的影響。
檢查依應用程式分流與路由模式
瀏覽器可以連線,但特定應用程式無法使用時,先查看用戶端的依應用程式代理設定。確認目前使用的是「僅代理選取的應用程式」,還是「略過選取的應用程式」;兩者的作用方向相反。系統應用程式、工作設定檔中的應用程式與一般使用者應用程式也可能分屬不同環境,不要只因清單中的名稱相似,就認定目標應用程式已包含在內。修改後請重新啟動連線再測試。
若所有應用程式都無法連線,先暫時取消額外的應用程式篩選,只保留已知可用的節點與基本路由進行驗證。不要同時調整遠端 DNS、流量探測、IPv6 與分流清單。特定應用程式使用 UDP 時,也要確認節點與核心是否支援;VPN 通道能接管流量,不代表遠端一定能轉送該應用程式需要的所有協定。
部分應用程式會快取連線或解析結果;修改分流設定後,可能仍沿用舊連線。請先停止目標應用程式再重新開啟,必要時先中斷用戶端連線後再重新連線。直接清除應用程式資料會影響登入狀態與本機資料,不應作為第一步。請先用瀏覽器與另一個一般應用程式交叉驗證,再判斷問題是否只發生在單一應用程式內。
螢幕關閉後斷線與網路切換
螢幕開啟時可用,鎖定一段時間後失效,請優先檢查系統電池最佳化、背景執行限制與裝置製造商的工作管理設定。依裝置系統提供的步驟允許用戶端在背景持續執行,並保留連線通知。不要一次開放所有應用程式的背景權限,只需調整確實需要維持連線的用戶端。系統更新後權限可能變更,若問題再度發生,請重新確認設定。
系統的「一律開啟 VPN」與「封鎖未使用 VPN 的連線」會改變斷線時的網路狀態。啟用後者時,用戶端退出或重新連線期間可能暫時完全無法上網,這是該設定預期的作用。請先確認是否需要這種行為;排查基本網路時,可暫時關閉相關限制,但應記下原始設定,測試結束後依實際需求還原。
從 Wi-Fi 切換到行動網路後失效時,先中斷連線再重新連線,觀察是否恢復。網路切換會改變位址、DNS 與既有連線狀態,原有連線不一定能繼續使用。若只有特定網路無法連線,請使用同一節點分別測試,並檢查該網路是否需要網頁驗證、是否有異常的 IPv6 路徑。不要把所有切換網路後的故障都歸因於背景程式遭到清除。
行動裝置 DNS 與故障資訊
Android 的私人 DNS、瀏覽器安全 DNS 與用戶端 DNS 設定可能同時影響解析。遇到網域解析異常時,先記下這些設定,不要一次關閉所有選項。若記錄顯示解析逾時,請搭配目前網路與用戶端的遠端 DNS 路徑進行檢查;若只有特定瀏覽器異常,先比較瀏覽器本身的解析行為。詳細說明請回到DNS 章節逐層確認。
向他人說明 Android 故障時,請記錄裝置系統、用戶端名稱、網路類型、鎖定螢幕與切換網路的條件,以及 VPN 是否仍維持連線。附上已去識別化的第一筆錯誤資訊,並說明同一節點在桌面版 v2rayN 上是否可用。跨裝置比對只能協助縮小範圍,不代表兩邊設定完全相同。恢復後請再測試鎖定螢幕、喚醒與切換網路,確認修復涵蓋真正會觸發故障的情境。