開源用戶端Project V

V2Ray中文版 用戶端下載

依平台選擇圖形化用戶端,從匯入訂閱開始設定;遇到連線異常時,再依故障症狀逐項檢查。

V2Ray 用戶端常用設定

看得到節點,只代表項目已匯入。應用程式是否使用代理、核心能否與節點交握,以及請求是否依規則分流,分別由不同設定控制。依症狀切換下方刻度,先找出需要檢查的層級。

協定、傳輸與安全參數

節點已正常匯入卻總是交握失敗,請先確認協定、傳輸方式與安全層設定是否和伺服器一致。VMess、VLESS、Trojan 與 Shadowsocks 的參數不能互換;同一協定也可能搭配不同的傳輸方式。在支援多核心的桌面用戶端中,開啟節點編輯面板逐項核對,再確認目前啟用的核心。相較於只支援單一協定的工具,多協定用戶端更便於集中管理;但切換核心不會自動改寫既有參數。只調整已確認不一致的項目,再實際測試連線。

相關排查章節:無法上網 →
節點編輯 · 核對順序
  • 協定類型
  • 傳輸協定(network)
  • 傳輸層安全性(security)
  • 伺服器名稱(serverName)

依作業系統選擇安裝包

程式無法開啟時,先確認作業系統、處理器架構與套件格式,不要急著更換節點。安裝和連線是兩個不同階段:至少要能正常開啟用戶端並進入設定頁面,再匯入設定排查網路問題。

Windows

選擇 v2rayN 桌面版或經典 WPF 版。桌面版採用跨平台介面;若已習慣舊版操作,或正在比對舊版選單,也可查看 WPF 版入口。請先在系統資訊中確認處理器是否為 x64。

若發行套件需要解壓縮,請先完整解壓至具有寫入權限的資料夾,再啟動程式。若出現執行階段元件提示,記下缺少的元件名稱,依下載頁說明補齊後再試。

前往下載

macOS

選擇符合 v2rayN 的處理器版本。在「關於本機」查看晶片或處理器:Apple 晶片選 arm64,Intel 處理器選 x64。僅憑作業系統版本無法判斷處理器架構。

從磁碟映像安裝後,請從「應用程式」重新啟動用戶端。若系統出現提示,先分辨是架構不符、系統版本需求,還是權限問題,這幾種情況的處理方式不同。

前往下載

Android

常用入口是以 Xray 為核心的 v2rayNG;若有明確的 V2Fly 設定需求,再選用 v2flyNG。請先確認裝置支援的應用程式架構;支援 arm64 時選擇對應套件,不確定時可查看通用套件。

安裝後,請先在前景完成首次 VPN 授權。若只有切換網路或鎖定螢幕後才中斷,請保留相同節點重新測試,再逐項檢查其他 VPN 工作階段與背景電池限制。

前往下載

Linux

先確認發行版使用的套件格式:Debian、Ubuntu 系通常選 deb,Fedora 系通常選 rpm。接著查看系統資訊,確認架構是 x64 或 arm64;套件名稱中的處理器架構不能互換。

此入口提供圖形化用戶端。能夠安裝不代表目前的桌面環境會為所有應用程式設定代理。完成設定後,先用瀏覽器比對,再確認實際發生問題的程式是否會沿用桌面代理設定。

前往下載
查看所有用戶端 →

匯入訂閱、連線與驗證

首次設定只驗證一條連線路徑:使用一台裝置、一個網路和一個節點。記錄每個步驟的結果,之後即使更換裝置,也能重現成功條件或找出失敗環節。

  1. 匯入訂閱並確認節點已加入群組

    在桌面版 v2rayN 新增訂閱群組並儲存網址,再手動更新該群組;使用 v2rayNG 時,也要先在訂閱群組管理中新增訂閱,再執行更新。節點清單出現項目後,請確認它屬於剛才更新的群組,避免把舊節點誤認為新訂閱的結果。

    若節點數量沒有變化,請查看更新時顯示的訊息。若逾時,先檢查取得訂閱的路徑;若提示格式不支援,請確認訂閱類型。訂閱網址可能包含存取憑證,排查問題時請遮蔽完整網址。

  2. 選擇節點並啟用連線

    從剛匯入的群組中選擇與用戶端核心相容的節點;桌面版請確認已設為目前使用的設定,再啟用系統代理。行動裝置則啟動連線並完成系統 VPN 授權。首次測試先使用預設規則,暫時不要加入自訂分流或 DNS 設定。

    若啟動按鈕很快就恢復未連線狀態,先查看記錄中的第一個錯誤。連接埠被占用、設定無法辨識與交握失敗是不同問題;先排除啟動錯誤,再測試網路存取。

  3. 使用同一個應用程式確認請求路徑

    在會讀取系統代理的瀏覽器中送出新請求,記錄連線前後的存取結果,必要時比對出口 IP 位址與用戶端記錄。測得到節點延遲,不代表這個瀏覽器的請求也走相同路徑。

    若只有一個網站無法連線,請用同一個瀏覽器再測試另一個預期使用相同出站的目標,接著檢查規則比對結果與網域解析。若關閉代理後仍無法連線,先恢復基本網路,不要同時更換多個節點和規則。

查看完整指南 →

Project V、V2Fly 與 Xray 的關係

專案、核心、用戶端和節點協定並非同一層級的名稱。閱讀指南或回報問題前,請先確認討論的是哪一層;尤其錯誤發生在啟動階段時,介面顯示的名稱不能取代實際執行的核心名稱。

專案脈絡
Project V
核心家族
V2Fly / Xray
圖形化用戶端
v2rayN / v2rayNG / v2flyNG
概念速查 →
  1. 從 Project V 認識模組化代理

    V2Ray 源自 Project V,將接收請求的入站、負責轉送的出站,以及決定請求流向的路由拆分為獨立設定。入站負責將瀏覽器或其他應用程式的請求交給核心;路由依條件選擇出站;出站則負責直連、代理或其他處理。

    這三個位置也對應三種常見狀況:核心未收到連線時,先檢查本機連線設定;連線已進入核心卻走錯出口,請檢查路由順序;請求已到達預期出站仍然失敗,再確認伺服器參數與網路連通性。將問題分類到這三個層級,比只憑「網頁無法開啟」判斷原因更準確。

  2. V2Fly 與 Xray 各有相容範圍

    V2Fly 社群延續 V2Ray 核心專案;Xray 從這段程式碼脈絡分支後獨立發展,兩者分別由各自社群維護。常見設定概念有所重疊,但支援的傳輸方式、安全層與欄位可能不同。使用相同協定名稱,不代表兩者接受完全相同的參數。

    遇到「項目可以匯入,核心卻無法啟動」時,先查看記錄指出哪個欄位,再判斷是該核心不支援此選項,還是用戶端產生設定時漏掉了該項目。切換核心前先記下原本的選擇;重新測試時維持相同節點與網路,才能判斷差異來自哪個層級。

  3. 協定有公開實作,不代表參數通用

    VMess、VLESS、Trojan 與 Shadowsocks 都能在開源代理生態系中找到實作。協定規定兩端如何交換資料,傳輸方式與安全層則決定資料如何傳送及受到保護。以 VLESS 為例,不能只憑協定名稱推斷連線已設定 TLS,也不能將 TLS 與傳輸方式視為同一項設定。

    查看共用設定時,先確認協定,再檢查傳輸方式與安全層,依各自欄位逐項比對伺服器設定。若只從另一份指南照抄一個參數,可能反而讓兩端原本一致的設定變得不相符。協定公開有助於比對實作與排查問題,但不代表某項訂閱或第三方服務屬於用戶端專案。

  4. 三款開源用戶端各自負責圖形化設定

    v2rayN 是桌面圖形化用戶端,可管理節點、訂閱與路由,並依設定選用相應核心。v2rayNG 以 Xray 為核心,提供行動版訂閱與 VPN 連線;v2flyNG 以 V2Fly 為核心,適合需要確認 V2Fly 相容性的行動裝置設定。三者都是開源用戶端,介面負責整理設定,實際建立連線的是底層核心。

    訂閱服務和用戶端也是兩回事。安裝用戶端不會自動取得節點;用戶端能開啟,也不代表訂閱仍然有效。遠端回傳錯誤、項目過期或應用程式缺少權限,分別要檢查訂閱來源、節點設定與裝置設定。先確認錯誤來自哪一方,再決定要查看指南的哪個部分。

  5. 軟體、核心與訂閱的更新週期各不相同

    用戶端更新可能調整介面、系統支援或套件方式;核心更新可能新增欄位或修正連線行為;訂閱更新則只同步來源提供的節點清單。訂閱更新成功不代表軟體已升級;重新安裝用戶端也無法讓失效的訂閱恢復使用。

    升級前請備份自訂路由與設定,並記下目前使用的核心和正常運作的連線模式。升級後先測試原本的節點,再逐項還原選用設定。若出現回歸問題,記錄發生時間、平台與架構、使用的核心、重現步驟和已去識別化的記錄,比只提供無法連網的截圖更容易定位。

訂閱、連線與代理模式專題

依故障發生的位置選擇文章:訂閱更新失敗,查看取得與解析流程;節點已出現但首次連線失敗,檢查節點與出口;只有部分應用程式的行為不同,再區分系統代理與路由設定。

查看所有文章 →