Project V 開源用戶端

v2rayN官網 · V2Ray 用戶端 下載與設定

依裝置選擇桌面用戶端或Android 用戶端,再依教學匯入訂閱、設定路由與 DNS。

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY

設定圖層

v2rayN 核心設定

訂閱決定伺服器清單的來源;系統代理或 TUN 決定哪些流量會進入用戶端;路由則決定這些流量要往哪裡走。遇到問題時,分別檢查這三個環節,比一次重設所有選項更容易找出原因。

依來源新增訂閱

訂閱分組 → 訂閱分組設定 → 添加

將不同來源的訂閱分開儲存,並為每個分組取容易辨識的別名。更新前先選取目標分組,再使用更新目前訂閱的功能;只有需要一次全部更新時,才選擇更新全部。與逐筆貼上伺服器不同,更新訂閱會重新讀取來源回傳的清單,手動修改的項目可能遭到覆蓋。需要長期保留的手動設定,請另外儲存。更新失敗時,先確認提示是下載錯誤還是內容無法解析,再決定是否調整設定。

查看訂閱與伺服器篩選說明

平台與安裝套件

依裝置選擇用戶端

桌面裝置請使用 v2rayN。Android 裝置則依核心需求,在 v2rayNG 和 v2flyNG 之間選擇。下載前先確認裝置的處理器架構;同一款用戶端提供的安裝套件,可能適用於不同晶片或安裝方式。

下載頁分別列出 v2rayN 桌面版與經典 WPF 版。桌面版採用跨平台介面;若已習慣舊版操作,或正在參照舊版教學,可先查看經典 WPF 版的說明。兩者介面位置可能不同,請依功能名稱尋找訂閱分組、路由和系統代理,不必逐項比對截圖。

下載前,請前往「設定 → 系統 → 關於」確認系統類型。首次連線時,可先選擇一台伺服器,再用會讀取系統代理設定的瀏覽器測試;若要讓其他應用程式也走代理,再考慮使用 TUN。退出後若系統仍嘗試連線至本機代理,請檢查系統代理是否已還原。

在「關於這台 Mac」查看晶片或處理器。若顯示 Apple 晶片,請選擇 arm64;若顯示 Intel 處理器,請選擇 x64。兩種安裝套件適用於不同架構,不能只憑系統名稱選擇。安裝後先開啟用戶端,確認能進入主畫面,再匯入訂閱。

無法開啟應用程式,和開啟後無法設定代理,是兩種不同問題。前者先查看系統的應用程式開啟提示;後者再檢查網路相關授權與代理設定。受管理的裝置可能受到系統限制,請勿誤以為是安裝套件選錯。

需要 Xray 核心時選擇 v2rayNG;需要對照 V2Fly 設定時選擇 v2flyNG。確認系統支援 arm64 後,再選擇相應的安裝套件;不確定時請查看通用版。安裝套件架構決定能否安裝在裝置上;核心選擇則決定能否處理訂閱中的協定與傳輸欄位。

若系統提示安裝衝突,先確認正在更新的是同一個應用程式,並查看系統提示的具體原因。若打算解除安裝後重新安裝,請先確認訂閱和本機設定是否能還原。首次申請 VPN 權限時,也要確認裝置上是否已有其他應用程式正在使用該連線。

依發行版選擇套件格式:Debian、Ubuntu 通常使用 deb,Fedora、openSUSE 通常使用 rpm;接著依系統架構選擇 x64 或 arm64。格式相符不代表相依元件一定齊全;若安裝程式提示缺少元件,請先處理相依套件,再檢查桌面選單入口。

本教學以圖形桌面工作階段為前提。若視窗能開啟,但應用程式沒有走代理,先確認目前的桌面環境是否套用系統代理設定,再檢查目標應用程式是否會讀取該設定。瀏覽器測試成功,也不代表其他應用程式會沿用相同設定。

更換裝置時要保留哪些設定

遷移前先區分訂閱網址、手動新增的伺服器和本機設定。訂閱網址可在新裝置上重新新增;不屬於訂閱的手動項目需要另外儲存;系統代理、虛擬網卡和應用程式分流通常與原裝置相關,需在新裝置上重新確認。備份若包含訂閱連結或連線資訊,請與公開的問題排查截圖分開存放。

先在新裝置上完成最基本的設定:匯入一個來源、選擇一台已知可用的伺服器,再用一種連線模式測試。確認基本連線正常後,再還原自訂 DNS 和路由規則。若新裝置連基本設定都無法通過,請先確認架構、核心和權限,不要依賴整套舊設定碰運氣。

生態系與維護

Project V、V2Fly 與 Xray

用戶端負責呈現設定並管理組態,核心則負責建立連線和執行路由規則。這兩層的專案可以分別發布,因此遇到連線問題時,除了要會尋找介面設定,也要知道實際由哪個核心處理。

Project V 生態系的分工

Project V 是早期專案生態系的名稱,V2Ray 是其中的核心代理程式。原有專案逐步由社群接手後,V2Fly 延續 V2Ray 的維護與發布;Xray 則以相關程式碼為基礎分支,獨立發展。現在在用戶端看到的名稱,可能指整個生態系,也可能指某個正在執行的核心;閱讀教學時需依上下文判斷。

圖形用戶端會將訂閱項目整理成可選的伺服器設定,並把路由與網路模式轉換成核心可使用的設定。若看不到伺服器清單,通常應先檢查匯入或更新;若清單能選取但核心無法啟動,則應優先查看記錄,而不是再次匯入相同位址。

核心與協定的相容範圍

判斷 V2Fly 和 Xray 是否適用於某份設定,必須同時確認協定、傳輸方式與連線安全機制。VMess、VLESS 和 Trojan 是協定名稱,WebSocket 是傳輸方式,REALITY 則是連線安全機制。只看清單中的協定縮寫,無法判斷其他欄位是否也受支援。

例如,伺服器要求使用 VLESS、REALITY 和特定流控組合時,應選擇支援整套組合的核心,並依伺服器參數設定,而不是只把協定選單改成 VLESS。遷移完整設定時,也要確認 DNS 和輸出欄位;連線參數相容,不代表同一份自訂路由也能原封不動地使用。

三款開源用戶端的定位

v2rayN 是以 GPL-3.0 發布的桌面圖形用戶端,提供訂閱、核心選擇、路由和網路模式設定。v2rayNG 與 v2flyNG 是開源 Android 用戶端,分別以 Xray 和 V2Fly 為核心。這些用戶端負責管理本機連線設定,不會提供訂閱或遠端伺服器。

閱讀授權條款時,應區分用戶端與隨附使用的核心、元件。用戶端的開源授權說明適用於其程式碼;核心和其他元件仍應分別查看各自的授權。免費取得用戶端也不代表能使用特定遠端服務,服務使用權由實際服務提供者決定。

用戶端、核心與訂閱更新

用戶端發布可能調整介面與平台支援,核心發布可能變更設定欄位與協定支援,重新整理訂閱則會重新讀取伺服器提供的清單。這三種更新彼此獨立:訂閱更新成功不代表程式已升級,同一個用戶端下載檔也不保證不同來源的訂閱都能正常使用。

更新前記下目前使用的核心、路由設定和連線模式。更新後先重新測試一項原本正常的操作,再啟用自訂設定。若問題是在重新整理訂閱後出現,優先比對該分組的設定變化;若問題是在程式升級後出現,先檢查設定遷移或核心啟動提示。

使用心得

核心選擇與協定筆記

正在挑選 Android 用戶端時,先比較 Xray 與 V2Fly 的差異;想釐清某個名稱指的是圖形用戶端還是核心,先了解生態系關係。若已取得 REALITY 設定,再對照安全機制與流控欄位,避免把兩種設定混為一談。

常見問題精選

訂閱更新成功,為什麼還是連不上?

更新成功只代表用戶端取得伺服器清單;選取項目後,請確認核心是否已啟動、應用程式是否將流量交給用戶端,再依問題排查說明區分連線失敗和網域解析失敗。

為什麼只有某個應用程式沒有走代理?

先確認該應用程式是否讀取系統代理、是否設定了自己的代理,或在 VPN 模式下是否被排除;確認流量已進入用戶端後,再檢查路由規則與輸出標籤。

剛變更 DNS 或 TUN,該如何恢復排查?

先還原至最近一次可正常使用的模式,保持伺服器不變,檢查常用應用程式和區域網路連線,再逐項還原 DNS 或 TUN 設定;若某個步驟再次引發異常,請依常見問題繼續檢查該層設定。

同一個訂閱能在兩種用戶端通用嗎?

能否讀取訂閱取決於回傳格式;匯入後能否連線,則取決於實際核心和設定欄位。兩台裝置能否同時使用,還要看服務提供者的規定。可先參考訂閱與節點相關術語,釐清這三件事。