安裝與連線排查

v2rayN 常見問題

先釐清問題發生在哪個步驟:安裝套件無法開啟、訂閱沒有匯入,還是應用程式請求沒有進入代理。依目前狀況選擇類別,排查時一次只變更一項設定。

基礎觀念

先區分用戶端、核心和設定。了解各自的用途,就能判斷該從哪裡尋找相關設定。

v2rayN、V2Ray 和 Xray 有什麼不同?

v2rayN 是桌面圖形用戶端,負責管理設定、啟動核心並設定本機代理。V2Ray 是 Project V 生態系中的代理軟體,V2Fly 社群持續維護相關實作;Xray 則是獨立發展的核心專案。切換圖形介面和切換核心是兩回事。匯入設定前,先確認目前使用的核心支援設定中的協定、傳輸方式與安全選項。

訂閱網址和單一節點連結有什麼不同?

訂閱網址指向可定期擷取的設定內容,更新一次即可重新整理整組項目。單一節點連結則描述一個連線,匯入後通常不會隨訂閱更新。先確認來源提供的是哪一種,再選擇訂閱群組或單一匯入入口。兩者都可能包含存取憑證,請勿貼在公開截圖、問題單標題或線上轉換頁面。

系統代理和 TUN 模式有什麼不同?

系統代理會為遵循系統設定的應用程式提供本機代理入口,但有獨立網路設定的應用程式可能不會使用。TUN 透過虛擬介面接收由路由導入的流量,涵蓋範圍取決於系統路由、排除規則與權限。排查時先選用一種方式,確認單一應用程式可以連線後,再決定是否需要擴大涵蓋範圍。

安裝用戶端後,為什麼沒有可用節點?

用戶端負責執行連線設定,不代表會提供遠端連線。首次開啟時清單是空的,屬於正常情況。取得有權使用的訂閱或單一設定後,匯入並選取項目,再確認核心是否啟動。如果匯入後仍看不到項目,先檢查目前的群組和搜尋篩選條件,不必重複匯入同一份內容。

安裝設定

先依作業系統和架構選擇安裝套件。用戶端能開啟後,再分別確認訂閱能否讀取、虛擬介面能否建立。

Windows 上的 v2rayN 桌面版和 WPF 版該怎麼選?

桌面版採用跨平台介面,WPF 版則保留傳統 Windows 介面。先確認系統架構及發行說明中的執行需求,再依熟悉的介面選擇。若已有設定,切換前請先備份用戶端資料;測試另一版本前先關閉原用戶端,避免兩個程序同時修改系統代理或搶用同一個本機監聽埠。

Android 安裝套件的 arm64 和 universal 該怎麼選?

如果裝置系統支援 arm64-v8a,建議優先選擇 arm64 套件;不確定系統支援哪種應用程式架構時,可先查閱裝置規格,或選擇支援多種架構的 universal 套件。處理器支援 64 位元,不代表系統一定能執行 64 位元應用程式。若通用套件也無法安裝,請再確認 Android 版本需求,以及是否與已安裝應用程式的簽章衝突。

訂閱匯入失敗,或匯入後沒有項目,該怎麼辦?

先確認複製的是完整訂閱網址,沒有換行或多餘空格,也不是帳戶登入頁面。儲存到訂閱群組後,手動更新該群組並查看記錄。若收到的是登入頁面或錯誤提示頁,即使請求成功也無法解析成節點;如果記錄顯示格式不支援,請向設定提供者確認能否提供目前用戶端相容的訂閱格式。

開啟 TUN 時提示權限不足,該怎麼辦?

先查看記錄中的錯誤發生在建立虛擬介面,還是寫入路由。Windows 上可先關閉用戶端,再依發行說明以系統管理員權限啟動;macOS 和 Linux 則請依對應版本文件確認虛擬介面、輔助程序與授權需求。如果裝置由公司或機構管理,先確認是否允許相關權限,請勿為了排除啟動失敗而關閉系統防護。

使用技巧

測試結果應與實際請求互相比對。連接埠可連通、請求進入核心,以及規則選中預期輸出,是三個不同的檢查點。

如何確認某個應用程式確實使用了代理?

只用一個測試應用程式發起新請求,查看用戶端記錄中是否出現相應的目標與輸出記錄。若沒有記錄,檢查該應用程式是否使用獨立代理設定,或仍在沿用先前建立的連線。記錄中有資料只代表請求已進入核心,還要確認實際命中的輸出是代理還是直接連線。

為什麼連接埠測試成功,實際連線測試卻失敗?

Tcping 成功通常只代表當下可以連上目標 TCP 連接埠,並未驗證協定交握、身分驗證或測試網址是否能存取。實際連線失敗時,可先用相同的測試網址比對一個已知可用項目,再查看記錄是交握錯誤,還是連線測試目標逾時。請勿只根據連接埠測試結果判斷節點是否可用。

新增路由規則後,為什麼仍然命中舊規則?

先確認修改的是目前啟用的路由設定,儲存後重新載入,再發起新的連線。規則通常依序比對,前面較寬泛的規則可能先命中,讓後續例外規則無法生效。檢查目標是以網域名稱還是 IP 進入核心,並依網域解析策略判斷應使用哪一類比對條件。

更新用戶端前需要備份哪些內容?

先記下目前版本與使用的核心,關閉用戶端後依該版本說明備份資料目錄。建議保留自訂路由、訂閱群組和手動設定,別假設安裝目錄就是資料目錄。備份可能包含憑證,請存放在安全可控的位置。升級後先確認一個已知可用項目,再逐一還原自訂設定。

查看路由規則與生效順序 →

故障排除

先確認影響範圍:是只有一個應用程式無法開啟、只有一筆設定逾時,還是訂閱請求本身失敗。記下首次出現的錯誤,再決定要檢查哪一層。

節點突然逾時,應該先檢查什麼?

先確認目前的網路可以正常存取常用網站,再用相同的測試方式比對另一個已知可用項目。若只有一個項目失敗,查看記錄是網域解析失敗、連線逾時還是交握失敗,並確認伺服器位址、連接埠與目前設定。若所有項目都失敗,優先檢查核心是否已啟動,以及本機連接埠是否成功監聽。

用戶端顯示已連線,為什麼還是無法上網?

已啟動或已選取項目,不代表應用程式的請求已成功通過。先停用重複啟用的代理接入方式,只保留一種,再用瀏覽器發起新請求並比對記錄。沒有請求記錄,就檢查應用程式接入方式與本機連接埠;有記錄則檢查路由比對、DNS 和輸出錯誤。如果停用用戶端後仍無法存取,請確認系統是否仍指向已停止監聽的代理連接埠。

系統代理已開啟,為什麼某個應用程式沒有生效?

先用遵循系統代理設定的瀏覽器進行比對。如果瀏覽器正常,但目標應用程式沒有請求記錄,請檢查該應用程式是否設有獨立代理、略過清單,或網路設定是否由其他工具接管。手動填寫代理時,協定與連接埠都必須符合用戶端實際的輸入設定。如果應用程式快取了代理設定,修改後請關閉再重新開啟測試。

訂閱先前可以使用,更新時卻失敗,該怎麼辦?

先保留現有群組,手動更新一次並查看錯誤訊息。遇到 401 或 403,優先檢查訂閱授權或網址是否已更換;連線逾時則檢查用戶端發出訂閱請求時使用的網路路徑。如果更新設定需要透過代理,而目前項目又無法使用,先恢復一條可用連線;或在訂閱來源允許且可直接連線時,改用直連方式更新。

比對本機輸入位址與連接埠 →