CLIENT HELP / FAQ

V2Ray 常見問題

安裝包選擇、訂閱匯入與連線故障排除。先依現象定位,再一次調整一項設定。

以下解答適用於 v2rayN、v2rayNG 與 v2flyNG 的常見使用情境。不同版本的選單名稱可能略有差異,請以目前用戶端的設定與記錄為準。

01 / CONCEPTS

認識 V2Ray

釐清用戶端、核心與流量入口,避免跨層排查。

V2Ray、V2Fly、Xray 與圖形化用戶端有什麼關係?

V2Ray 通常指 Project V 生態系中的代理工具與設定架構,V2Fly 和 Xray 則是相關的核心家族。核心負責處理協定、傳輸、路由及 DNS;圖形化用戶端則用來管理伺服器設定、訂閱群組與啟動選項。v2rayN 是桌面用戶端,v2rayNG 使用 Xray 核心,v2flyNG 使用 V2Fly 核心。排除相容性問題時,應一併確認用戶端名稱、實際執行的核心及其版本,不能只憑成功匯入就判定功能可用。

v2rayN、v2rayNG、v2flyNG 該怎麼選?

Windows、macOS 和 Linux 桌面環境可優先考慮 v2rayN;Android 平台可優先考慮 v2rayNG,若需要相容 V2Fly 設定,再考慮 v2flyNG。選擇前先確認訂閱要求的協定、傳輸方式及安全設定,再核對用戶端核心是否支援。同名設定欄位在不同核心中,可能有不同的值或行為。切換用戶端時,先保留原有設定,使用一筆已知可用的設定進行測試,再移轉完整訂閱與分流設定。

安裝用戶端後,就有可用的連線設定了嗎?

安裝用戶端只是準備好本機執行環境,並不代表已有可用的伺服器連線。還需要從有權使用的服務來源取得訂閱網址或單筆設定,並確認服務效期、伺服器位址、連接埠及驗證資訊。訂閱網址通常包含存取憑證,不應貼到公開討論區或放進截圖。匯入設定後,先選取一台伺服器,再啟動核心並設定合適的代理方式;只看到伺服器名稱,不代表已建立連線。

系統代理、TUN 與路由分流各自控制什麼?

系統代理會提供本機代理入口給遵循系統設定的應用程式,但不保證所有程式都會使用。TUN 透過虛擬網路介面接收流量,涵蓋範圍通常較廣,但需要相應權限,也可能與其他網路工具衝突。路由分流則決定進入核心的連線要使用哪個出口,例如直連、代理或封鎖。三者位於不同層級:代理方式決定流量是否進入核心,路由則決定流量進入後如何處理。排除問題時,應先確認流量入口,再檢查分流設定。

查看三款用戶端比較 →

02 / INSTALLATION

下載與安裝

先確認作業系統與架構,再選擇套件格式和介面版本。

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

多數較新的 Android 手機可先選 arm64,但裝置年份僅供參考,不能取代處理器與系統架構資訊。arm64 安裝包適用於相應架構,通常檔案較小;universal 安裝包支援多種架構,適合不確定裝置架構時使用。如果 arm64 安裝包無法安裝,先檢查系統版本、剩餘空間及舊版應用程式的來源,再試用通用版。安裝失敗也可能是簽章不一致或降級限制所致,不一定能靠更換架構的安裝包解決。

v2rayN 桌面版和經典 WPF 版有什麼差異?

桌面版採用新一代跨平台介面,經典 WPF 版則使用 Windows 介面技術。Windows 使用者可依介面習慣與執行環境選擇;macOS 和 Linux 使用者則可查看相應平台的桌面版安裝包。兩種介面的選單位置、執行相依項目及部分功能實作可能不同,不能只根據截圖尋找按鈕。更換版本前,先匯出需要保留的訂閱、伺服器及路由設定,並保留舊設定目錄;首次啟動後,確認實際生效的監聽連接埠及核心選擇。

如何確認 macOS 晶片架構和 Linux 安裝包格式?

macOS 可在系統的「關於這台 Mac」查看晶片資訊:Apple Silicon 選 arm64,Intel 選 x64。Linux 則須同時確認發行版的套件格式與處理器架構:Debian、Ubuntu 系統通常選 deb,Fedora 等系統通常選 rpm;x64 和 arm64 不能只憑發行版名稱判斷。若安裝程式指出架構不符或缺少相依套件,應先核對系統資訊及套件需求,不要反覆安裝不同格式的套件,也不要任意變更系統安全設定。

更新用戶端會遺失訂閱嗎?安裝失敗時先檢查什麼?

一般覆蓋更新通常會保留使用者設定,但可攜式目錄、安裝目錄和使用者資料目錄不一定位於同一處;切換發行版本或安裝形式時尤其要確認。更新前先備份訂閱群組、路由設定及必要的自訂設定,再關閉用戶端。安裝失敗時,依序檢查系統與架構需求、可用空間、正在執行的程序,以及舊版應用程式的來源與簽章。Android 上簽章不同的應用程式可能無法覆蓋安裝;解除安裝前,請確認設定已妥善儲存。

查看平台與安裝包選擇 →

03 / CONFIGURATION

訂閱與設定

區分取得失敗、解析失敗與規則比對失敗。

如何區分訂閱匯入失敗和單筆設定匯入失敗?

先確認複製的是訂閱網址還是單筆分享連結,並使用用戶端對應的匯入功能。訂閱通常需要先儲存為群組,再執行更新;單筆連結則會直接解析其中的協定欄位。檢查內容是否完整,以及是否混入空格、換行、說明文字或網頁網址。若能下載訂閱內容但解析失敗,應核對回傳格式及核心支援情況;若請求本身失敗,則檢查網路與訂閱是否有效。不要將完整訂閱網址貼在記錄檔截圖或公開回報中。

v2rayN 訂閱更新失敗時,應依什麼順序排除?

先查看更新記錄,區分網址解析失敗、連線逾時、存取遭拒及內容格式錯誤。接著確認訂閱網址是否過期、遭重設或複製不完整,再檢查系統時間是否正確。若目前使用的伺服器已失效,透過代理更新可能無法完成,可嘗試使用用戶端提供的直連更新方式;反之,直連無法存取時,可透過現有的可用連線嘗試代理更新。每次只調整一種方式,保留原有群組,避免把網路問題誤判為需要清除設定。

更新訂閱後,手動修改的伺服器參數為什麼會還原?

訂閱群組中的伺服器通常會依遠端內容重新產生,更新時用戶端可能覆蓋先前的本機修改。若要長期保留特殊參數,可先將設定複製到不受訂閱更新管理的手動群組,再調整傳輸、安全或其他欄位,並記錄修改原因。不要直接在唯一可用的訂閱項目上反覆測試。更新後也應檢查目前使用的伺服器是否仍有效,以及路由是否引用了已變更的標籤;顯示名稱相同,不代表底層參數完全一致。

路由分流規則未生效時,應檢查哪些欄位?

先確認應用程式的流量已進入用戶端,再檢查規則順序、比對條件及出口標籤。一般路由規則會依序比對,若將涵蓋範圍廣的條件放在前面,後續較精確的規則可能沒有機會命中。outboundTag 必須對應實際存在的出口標籤;geosite 和 geoip 條件也需要相應的規則資料。網域比對是否有效,還取決於應用程式傳送的是網域還是 IP、DNS 設定及流量嗅探。可先用一條範圍明確的測試規則確認,避免一次變更所有分流設定。

閱讀 routing 路由欄位說明 →

04 / TROUBLESHOOTING

連線故障排除

依序檢查基本網路、流量入口、伺服器連線與目標存取。

節點逾時和連線遭拒各代表什麼?

逾時表示連線未能在指定時間內完成,可能與本機網路、伺服器是否可連線、傳輸設定或伺服器回應有關;連線遭拒通常表示目標位址可連線,但對應連接埠未接受連線,也可能是中間設備主動拒絕。先核對位址、連接埠與目前網路,再比較同一筆設定在其他可用網路上的結果。接著查看核心記錄,確認失敗發生在連線、TLS 交握或驗證階段。清單中的測試結果只反映該測試路徑,不能取代實際應用程式的連線測試。

顯示已連線卻無法上網,接下來該檢查什麼?

顯示已連線可能只代表核心或本機 VPN 服務已啟動,不代表伺服器驗證及目標存取都已成功。先關閉代理以確認基本網路正常,再檢查目前使用的伺服器、記錄中的驗證或交握錯誤,以及 DNS 解析是否異常。若只有部分網站無法存取,應優先檢查分流規則與網域解析;若所有應用程式都無法連線,先檢查入口連接埠、核心啟動狀態及伺服器連線狀況。Android 也要確認 VPN 授權、個別應用程式代理清單及電池限制,避免將應用程式未納入代理誤判為伺服器故障。

系統代理無效,或瀏覽器可用但終端機無法使用,該怎麼辦?

先確認 v2rayN 已啟用自動設定系統代理,並查看系統實際記錄的代理位址與連接埠。應用程式使用的協定必須與本機監聽入口一致,不要假設所有版本的 HTTP 與 SOCKS 連接埠都相同,應以目前設定為準。瀏覽器擴充功能可能會覆蓋系統代理;終端機程式則可能只讀取自身參數或代理環境變數。分別檢查這兩種連線方式,並重新啟動需要重新讀取設定的程式。若連接埠遭其他程序占用,應調整監聽設定,並同步修改應用程式端的代理設定。

TUN 無法啟動或 Android VPN 授權異常時該怎麼辦?

桌面版 TUN 需要虛擬網路介面及相應的系統權限。先查看啟動記錄,確認問題是權限不足、介面建立失敗還是路由設定衝突,再依用戶端提示完成授權或安裝服務。不要把始終以高權限執行當成通用解法。Android 版 v2rayNG 使用系統 VpnService,首次啟動時需確認 VPN 授權;若已有其他 VPN 應用程式正在執行,應先停止衝突服務。連線後若頻繁中斷,再檢查背景執行、電池最佳化及個別應用程式清單,不要反覆重設所有設定。