常見的 V2Ray 問題

V2Ray 屬於 Project V 代理工具生態系，V2Fly 與 Xray 則是相關的核心家族。核心負責協定處理、建立連線及執行路由；圖形化客戶端則用來編輯設定、管理訂閱及啟動核心。v2rayN 適用於桌面平台，v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心。下載客戶端並不會自動取得可用的伺服器設定；使用前仍須準備有權使用的訂閱或節點參數。

Windows、macOS 與 Linux 桌面版可優先依作業系統選擇 v2rayN；Android 可先選 v2rayNG，若需要相容 V2Fly 核心，再考慮 v2flyNG。Windows 下載區提供 Desktop 與 WPF 兩種介面版本：前者採用跨平台介面，後者採用傳統 WPF 介面。選擇時先確認作業系統、處理器架構與協定支援；另一個客戶端能匯入相同連結，不代表所有傳輸參數都完全相容。

訂閱連結通常用來取得一組伺服器設定，客戶端更新訂閱時會重新向該網址發出請求。單一節點分享連結通常以協定名稱開頭，只包含一筆連線設定。請使用相應的匯入功能，不能只憑連結長度判斷是否為訂閱。訂閱網址可能包含帳戶識別資訊與存取憑證，請妥善保管。尋求協助時說明錯誤類型即可，請勿公開完整網址、QR Code 或含有憑證的截圖。

系統代理會讓遵循系統設定的應用程式，將請求送至本機代理連接埠；路由預設則決定進入核心的請求要直連、走代理或封鎖；TUN 模式透過虛擬網路介面接收流量，涵蓋範圍則取決於實作方式、權限與路由設定。三者位於不同環節，並非可以互相取代的同一個開關。初次設定時建議先關閉 TUN，使用系統代理確認基本連線，再依應用程式是否遵循系統代理，決定是否啟用 TUN。

先確認複製的是完整訂閱網址，並移除前後空格、換行及聊天軟體附帶的標點符號。在 v2rayN 中，請先於訂閱群組儲存網址，再更新該群組的訂閱；Android 客戶端則是在訂閱設定中儲存後更新。儲存網址不代表已成功取得節點。若仍沒有節點，請查看更新記錄，確認是網路請求失敗、回應內容無法解析，還是沒有有效節點。登入網頁、方案說明頁及已失效的訂閱，都不能直接當作節點訂閱匯入。

先確認裝置處理器及作業系統支援的應用程式架構。2015 年後的主流手機通常可優先考慮 arm64，但處理器支援 64 位元，不代表目前的系統一定能安裝 64 位元應用程式，仍應以裝置資訊為準。不確定架構時可選 universal；這類安裝檔通常包含多種架構所需的元件，檔案也會較大。若無法解析安裝檔，除了架構，也要檢查系統版本、下載是否中斷，以及同名應用程式是否來自不同簽章來源；解除安裝前請先備份設定。

先確認核心已啟動，且已選取目前使用的伺服器，再於 v2rayN 選擇自動設定系統代理。開啟系統網路代理設定，確認本機位址與連接埠是否和客戶端相同。瀏覽器擴充功能、其他代理工具或組織管理政策，都可能覆寫這些設定；有些應用程式也完全不使用系統代理。請先關閉可能衝突的工具，再用遵循系統代理的瀏覽器測試。Linux 桌面環境的代理設定位置各有不同，必要時可在 GNOME 或 KDE 網路設定中手動確認。

先關閉 TUN，確認一般代理連線正常，再處理虛擬介面權限。Windows 通常需要系統管理員權限及可用的相關驅動程式；macOS 與 Linux 請依客戶端提示完成授權，不要用來源不明的命令取代權限設定。Android 首次啟動時會要求系統 VPN 授權；若先前拒絕，請重新發起連線並確認授權。若有其他 VPN 類應用程式占用系統介面，請先停止該應用程式。完成權限設定後仍無法使用，請查看記錄中的介面建立或路由寫入錯誤，避免反覆切換開關。

先依實際連線需求選擇路由預設，再確認特定網域的比對結果。繞過中國大陸通常依據網域與 IP 分類規則，將相應流量導向直連出口；全域代理通常會讓進入核心的請求優先走代理出口，實際結果仍受所選規則影響。路由中的全域代理不等於接管整台裝置，未進入核心的應用程式流量不會因此改變。若只有單一網站異常，可短暫切換預設進行比對；確認原因後再調整規則，不建議長期擴大代理範圍來掩蓋設定問題。

先選擇一台已匯入的伺服器，啟動核心並設定系統代理，再瀏覽已知可正常連線的 HTTPS 網頁，同時查看客戶端的連線記錄或日誌。確認目標網域是否出現，以及流量是走代理還是直連出口。節點測試成功只代表某種測試請求可用，無法證明瀏覽器已使用代理。若記錄中沒有瀏覽器請求，請先檢查瀏覽器本身的代理設定、擴充功能及系統設定。若日誌資訊不足，可暫時提高記錄層級；找出原因後請恢復一般層級，並妥善處理日誌。

訂閱群組中的節點通常由遠端訂閱內容產生；更新時，客戶端可能依遠端資料重新建立或覆寫項目，因此不建議直接在訂閱節點上長期手動修改。若要保留獨立參數，請先備份，再使用客戶端支援的複製或手動新增功能建立獨立項目，並與原訂閱群組清楚區分。更新訂閱也可能變更項目識別資訊，原本使用的伺服器不一定會繼續被選取。每次更新後請檢查目前使用的項目、路由預設與重要傳輸參數，再測試連線。

優先使用客戶端提供的匯出或備份功能，保存訂閱群組、手動新增的節點、自訂路由與必要的 DNS 設定，並記下本機監聽連接埠及常用模式。備份檔可能包含伺服器密碼、使用者識別資訊與訂閱憑證，請存放於安全位置，不要當作一般附件公開傳送。匯入其他客戶端時，先移轉基本連線設定，再逐項重建路由與 DNS；介面設定與設定檔格式不一定相容。還原後先測試一個節點，確認正常再移轉其他設定。

先確認本機網路正常、系統時間正確，再檢查節點位址、連接埠與協定參數是否完整。比較同一訂閱中的其他節點，並在情況允許時切換其他網路交叉測試。若只有單一節點失敗，問題較可能與該伺服器或參數有關；若全部失敗，則應檢查本機網路、核心啟動狀態與訂閱狀態。請注意，TCP 連線成功不代表 TLS 或協定交握也成功。查看日誌中的解析失敗、連線逾時或交握錯誤，依錯誤發生的環節處理；不要同時修改多個參數，以免無法追查原因。

顯示已連線通常只代表本機服務或系統介面已啟動，不表示遠端連線與網域解析都正常。先檢查目前使用的伺服器，再確認瀏覽器流量是否進入核心。若請求已進入核心但連線失敗，請查看 DNS 解析、路由出口及交握日誌；若完全沒有記錄，則應回頭檢查系統代理或 TUN 的流量接管範圍。可改用其他已知可正常連線的 HTTPS 網頁，排除單一網站故障。不要一開始就關閉防火牆或所有安全設定，應先透過日誌確認問題出在應用程式、解析、路由或伺服器的哪個環節。

節點連線使用已儲存的伺服器設定，更新訂閱則會向訂閱網址發出請求；兩者的 DNS、路由與存取條件可能不同。先確認訂閱是否到期、網址是否已重設，以及日誌中的 HTTP 狀態碼。若是驗證或權限錯誤，請聯絡訂閱提供者確認；若是網路逾時，可在客戶端支援的情況下，比較直連更新與透過代理更新。若代理更新依賴的目前節點本身無法使用，就會造成更新受阻。短時間內反覆重試可能觸發請求限制，請保留錯誤資訊，間隔一段時間再試。

先重新開啟客戶端、關閉 TUN，選擇清除系統代理後再正常退出。若客戶端無法啟動，請到作業系統的網路設定檢查是否仍有指向本機的手動代理；清除前也要確認沒有其他應用程式正在使用該代理設定。Android 可檢查系統 VPN 連線是否仍啟用；桌面裝置也應檢查其他 VPN 或虛擬網路工具。恢復後請用一般直連網頁測試。除非已確認故障來源並準備好還原原有網路設定，否則不要直接刪除所有網路介面卡或重設全部路由。