01 / BASICS
基礎認識
先釐清客戶端、核心、訂閱與代理模式各自負責的環節,後續排查才不會把介面問題和連線問題混在一起。
V2Ray、Xray 核心與 v2rayN 分別是什麼?
V2Ray 通常指 Project V 相關的協定與工具生態系,Xray 是其中的核心實作,負責協定處理、入站、出站、DNS 與路由。v2rayN 是桌面圖形客戶端,負責訂閱管理、伺服器選擇與系統代理設定,並呼叫 Xray 等核心處理流量。排查問題時要區分介面設定與核心設定:訂閱清單異常通常先檢查客戶端,協定或路由報錯則繼續查看核心日誌。
Windows、macOS、Android 與 Linux 應該選擇哪個客戶端?
Windows、macOS 與 Linux 可優先使用 v2rayN,介面和訂閱管理方式較為一致。Android 可選擇使用 Xray 核心的 v2rayNG;需要 v2fly 核心時則可選 v2flyNG。選擇時先確認作業系統與處理器架構,再下載對應安裝包。不同客戶端的選單位置略有差異,但基本流程都是匯入訂閱、更新伺服器、選擇節點、設定代理模式並驗證連線。
V2Ray 訂閱連結和單一節點設定有什麼差別?
訂閱連結通常由服務提供者產生,客戶端存取該網址後可一次取得多筆伺服器設定,後續更新時也能同步新增與刪除的變更。單一節點設定只描述一條連線,可透過連結、QR Code 或手動填寫欄位匯入。長期使用適合保存訂閱並按需更新;臨時測試單筆設定時則可直接匯入節點。訂閱網址屬於敏感設定資訊,不宜放入公開文件、截圖或共用日誌。
系統代理、路由模式和 TUN 模式有什麼差別?
系統代理是將代理位址寫入作業系統設定,主要接管遵循系統代理的應用程式。路由模式決定流量進入核心後要走 direct、proxy 或 block,例如依 geosite 與 geoip 規則分流。TUN 模式透過虛擬網路介面接管更大範圍的流量,適合不讀取系統代理設定的程式。三者處於不同環節,可以搭配使用;日常瀏覽通常先使用系統代理,需要接管更多程式時再評估 TUN。
02 / INSTALLATION
安裝設定
安裝階段重點確認平台、處理器架構與權限。匯入訂閱後還需要主動更新,伺服器清單才會依回傳內容產生。
如何將訂閱連結匯入 v2rayN 或 v2rayNG?
先完整複製服務方提供的訂閱網址。在 v2rayN 中進入訂閱群組管理,新增群組並貼上網址,儲存後執行更新訂閱;在 v2rayNG 中開啟訂閱群組或訂閱設定,新增網址後執行更新。更新完成後回到伺服器清單,選擇一筆設定,再開啟系統代理或建立連線。不要將訂閱網址貼到單一伺服器的位址欄,因為該欄位需要的是伺服器主機名稱,而不是訂閱入口。
訂閱更新成功後,為什麼看不到伺服器?
先確認目前顯示的是剛更新的訂閱群組,並清除伺服器名稱或地區關鍵字的篩選條件。接著查看更新結果是否顯示已解析出有效設定;若回傳內容為空、格式不受支援或訂閱已失效,清單就不會產生伺服器。也可檢查裝置的日期、時間與時區是否正確,再重新更新。多個群組並存時,請確認伺服器清單沒有停留在其他群組,或只顯示已收藏的項目。
Android 安裝包的 arm64 與 universal 該如何選擇?
近年的主流 Android 手機通常採用 arm64 架構,建議優先選擇 arm64 安裝包,檔案通常較小。無法確認架構、裝置較舊,或 arm64 安裝包顯示不相容時,再使用 universal 通用版。通用版包含多種處理器架構,適用範圍較廣,但不會因此增加功能。若客戶端已安裝,更新包還必須與現有應用程式的簽章及來源一致,否則系統可能要求先解除安裝舊版本。
開啟 TUN 模式時,為什麼會提示權限不足?
TUN 模式需要建立虛擬網路介面並修改路由,因此會觸發系統層級的權限要求。桌面端應從客戶端內的 TUN 開關啟動,並依提示授予系統管理員權限、網路擴充功能權限或相關輔助元件權限;不要只啟動核心檔案。授權後請完全退出客戶端,再重新開啟。若仍然失敗,請檢查安全性軟體是否阻止驅動程式或服務啟動,並確認舊版 TUN 元件沒有殘留佔用。
03 / USAGE
使用技巧
代理模式決定哪些程式會將請求交給客戶端,路由規則則決定流量使用哪個出站。調整時應一次只修改一個變數。
日常使用應該選擇哪種系統代理模式?
需要讓瀏覽器和多數遵循系統設定的應用程式使用代理時,可選擇自動設定系統代理。暫時停止使用時,選擇清除系統代理,讓作業系統恢復一般網路路徑。不變更系統代理適合已手動設定代理,或只使用 TUN 的情境。PAC 模式會依規則決定哪些請求交由代理處理,但實際涵蓋範圍取決於應用程式的支援程度。切換後可開啟系統網路設定,確認代理位址與連接埠是否同步變更。
全域模式與繞過中國大陸模式該如何選擇?
全域模式通常會將大部分已接管的流量交給 proxy 出站,適合快速判斷問題是否來自分流規則,但會增加不必要的代理流量。繞過中國大陸模式會讓常見的中國大陸網域與位址走 direct,其餘流量依規則處理,更適合日常使用。若某個網站在繞過模式下異常,可先切換至全域模式進行對照測試;若全域模式正常,再檢查該網域命中的 geosite、geoip 或自訂規則。
多個訂閱如何分組管理,避免更新後混在一起?
為每個訂閱建立獨立群組,並以來源或用途命名,不要將多個訂閱網址反覆寫入同一個群組。更新前先選取目標群組,更新後檢查新增與刪除紀錄,再依地區關鍵字或協定篩選伺服器。需要保留手動設定時,可另外建立本機群組,避免訂閱更新覆蓋管理順序。切換群組後也要重新確認目前使用的伺服器,因為清單變更不一定會自動替換已選取的節點。
自訂路由規則為什麼沒有如預期生效?
路由規則通常由上到下進行比對,較寬泛的規則放在前面可能提前命中,導致後面的精確規則未被執行。請檢查網域規則使用的是 domain、full、keyword 還是 geosite,位址規則使用的是 ip、geoip 還是網段,並確認目標出站標籤確實存在。修改後應重新載入設定或重新啟動核心。排查時可暫時只保留一條目標規則,透過日誌確認實際網域、位址與最終出站。
04 / TROUBLESHOOTING
故障排查
先判斷故障發生在取得訂閱、節點握手、系統代理還是路由解析。保留對應階段的日誌,比反覆切換所有設定更有效。
訂閱更新失敗或提示網路錯誤,該如何處理?
先在訂閱設定中檢查網址是否完整,尤其不要遺漏協定標頭、路徑與參數。確認系統時間正確後,分別在關閉系統代理與啟用可用節點的狀態下嘗試更新,以判斷訂閱網址是否需要透過代理存取。若服務方要求特定 User-Agent 或更新方式,請依其說明設定。仍然失敗時,查看客戶端日誌中的 HTTP 狀態與解析提示,並向訂閱提供者確認網址是否已過期。
節點測試一直逾時,應該依什麼順序排查?
先切換至同一訂閱中的另一台伺服器,判斷是單一節點故障,還是所有設定都無法使用。接著檢查裝置能否正常存取一般網站、系統時間是否正確,以及伺服器位址、連接埠、UUID、傳輸方式與 TLS 相關欄位是否完整。測試方式也會影響結果,TCP 可連通不代表協定握手一定成功。若所有節點同時逾時,可更新訂閱、重新啟動網路與客戶端,再查看核心日誌中的連線階段錯誤。
客戶端顯示已連線,但網頁仍然無法開啟,該怎麼辦?
顯示已連線只代表客戶端或核心已啟動,不代表目標請求一定成功。先確認目前已選取伺服器,並檢查系統代理是否開啟、代理連接埠是否與客戶端監聽連接埠一致。再使用全域模式進行一次對照測試:全域模式可用而分流不可用時,重點檢查路由與 DNS;全域模式也不可用,則切換節點並查看握手日誌。若瀏覽器啟用了獨立代理、擴充功能代理或安全 DNS,也應暫時恢復為跟隨系統設定。
v2rayN 已設定系統代理,但部分程式仍然直連,該怎麼辦?
部分程式不會讀取作業系統代理設定,或只在啟動時讀取一次。先完全退出該程式,在 v2rayN 中選擇自動設定系統代理後重新開啟,並確認系統代理頁面已寫入本機位址與連接埠。若程式提供自己的網路代理選項,應設定為跟隨系統,或手動填入客戶端監聽連接埠。若仍然直連且需要接管該程式,可評估啟用 TUN 模式,並在啟用後檢查虛擬介面與路由表是否建立成功。