V2Ray 客戶端下載
v2rayN 與 Android 客戶端
桌面端選擇 v2rayN,Android 優先選擇 v2rayNG。
先確認作業系統與架構,再匯入訂閱、設定代理。
CLIENT SHELF
依作業系統選擇安裝檔
切換平台以查看對應的下載入口。安裝檔格式與處理器架構都必須相符;客戶端能開啟,不代表訂閱和代理已設定完成。
Windows 系統需求與安裝
| 檢查項目 | 選擇依據 |
|---|---|
| 作業系統 | 建議使用仍在支援期間的 Windows 10 / 11;實際相容性請以對應版本的發布說明與安裝提示為準。 |
| 處理器架構 | 本頁提供 Windows x64 版本。前往「設定 → 系統 → 系統資訊」查看系統類型。 |
| 安裝檔格式 | ZIP 檔須先完整解壓縮至資料夾,再執行其中的安裝程式;請勿直接在壓縮檔視窗中啟動。 |
| 權限與執行環境 | 依安裝程式提示安裝所需的執行環境;啟用 TUN 時可能需要系統管理員權限。 |
下載後先結束正在執行的舊版客戶端,尤其要確認系統匣中沒有程式仍在背景執行。完整解壓縮安裝檔後,再執行安裝程式並依提示完成安裝。請勿只從壓縮檔中抽出單一程式檔,否則可能缺少同資料夾中的相依檔案。若介面能啟動,但核心隨即結束,請開啟記錄面板,記下第一則明確錯誤,再確認是否有連接埠遭占用或缺少執行環境。
桌面版與 WPF 版的差異主要在介面和操作配置,不應把切換介面版本當成網路故障的萬用解法。初次設定時只執行一個客戶端,避免兩個版本同時變更系統代理。更新訂閱後,先從伺服器清單選取項目,再從系統匣選單設定「自動設定系統代理」。需要接管更多應用程式的流量時,再另外測試 TUN 模式。
v2rayN · macOS
macOS 系統需求與安裝
| 檢查項目 | 選擇依據 |
|---|---|
| 作業系統版本 | 請使用仍在支援期間的 macOS;最低版本需求以該安裝檔說明及系統安裝提示為準。 |
| 晶片類型 | 從系統選單前往「關於這台 Mac」:M 系列晶片選 arm64,Intel 處理器選 x64。 |
| 安裝位置 | 開啟 DMG 後,將應用程式移至「應用程式」,再從該處啟動。 |
| 網路權限 | 依系統提示授權系統代理及 TUN 相關權限;首次授權後請確認代理狀態。 |
先從系統選單開啟「關於這台 Mac」,確認晶片類型,再下載相符的 DMG。開啟磁碟映像檔後,將應用程式複製到「應用程式」,等候複製完成再啟動。直接從磁碟映像檔啟動,可能造成更新位置與實際使用位置不一致,也會增加後續確認執行中程式版本的難度。安裝完成後可退出磁碟映像檔。
若系統阻擋首次開啟,請先閱讀「系統設定 → 隱私權與安全性」中的提示,確認下載來源及應用程式身分後,再決定是否繼續。請勿為了啟動單一應用程式而關閉整套系統安全機制。進入客戶端後,先匯入訂閱並測試所選伺服器;若瀏覽器仍未使用代理,請檢查系統網路設定中的代理位址與連接埠是否和客戶端本機監聽設定一致。
從睡眠狀態恢復或切換網路後若連線中斷,先確認客戶端仍在執行,再查看代理與 TUN 狀態。結束客戶端前,可先清除系統代理,避免系統繼續連到已停止的本機連接埠。不同版本的選單位置可能有所調整,欄位意義與檢查順序則相同。
v2rayNG
v2flyNG
Android 系統需求與安裝
| 檢查項目 | 選擇依據 |
|---|---|
| 作業系統版本 | 請以安裝程式顯示的最低 Android 版本及對應發布說明為準。 |
| 應用程式架構 | 主流裝置優先選 arm64;不確定或顯示架構不相容時,請選通用版。 |
| 安裝權限 | 只為實際用來開啟 APK 的瀏覽器或檔案管理員授予「安裝未知應用程式」權限。 |
| 連線權限 | 首次連線時確認系統 VPN 要求;避免同時使用其他 VPN 應用程式占用連線。 |
下載 APK 後,從下載清單或檔案管理員開啟。若系統要求授權安裝來源,請前往該應用程式的權限頁面完成設定,再返回安裝程式繼續。安裝完成後,可視需要撤銷該來源的安裝權限。若出現「應用程式未安裝」,先檢查架構不相容、系統版本過舊或已安裝應用程式的簽章不同,請勿反覆下載同一個檔案。
已有訂閱與自訂規則時,請勿立即解除安裝舊應用程式。先使用應用程式提供的匯出或備份功能保存設定,再決定是否需要重新安裝。v2rayNG 與 v2flyNG 使用不同核心,不能只因名稱相似,就認定所有協定與欄位都通用。使用 VLESS、REALITY 等設定時,請先確認所選客戶端目前核心的支援情況,通常可先從 v2rayNG 開始測試。
安裝並匯入設定後,首次連線時會出現系統 VPN 授權提示。此授權用來建立本機流量轉送通道,不代表訂閱已生效。開啟連線後仍須測試實際存取狀況。若鎖定螢幕後經常斷線,請檢查系統對該客戶端的電池最佳化、背景活動與網路限制;變更後再次鎖定螢幕測試,避免一次修改多項設定而難以找出原因。
v2rayN · Linux
Linux 系統需求與安裝
| 檢查項目 | 選擇依據 |
|---|---|
| 桌面環境 | 本頁提供圖形化客戶端,需在可執行桌面應用程式的 Linux 環境中使用。 |
| 處理器架構 | x86_64 / amd64 請選 x64;aarch64 / arm64 請選 arm64。 |
| 套件管理體系 | Debian、Ubuntu 等通常選 deb;Fedora 等通常選 rpm,仍須確認目前安裝檔的目標環境。 |
| 相依套件與權限 | 由系統軟體安裝程式檢查相依套件;TUN 另需虛擬網卡支援及相應網路權限。 |
先前往系統的「關於」或硬體資訊頁面查看處理器架構,再確認發行版使用的套件格式。使用系統軟體安裝程式開啟下載的 deb 或 rpm,查看相依資訊後完成安裝。採用相同套件管理體系,不代表所有發行版都能直接執行同一個套件;若安裝程式指出執行程式庫版本不足,請先確認發行版版本與套件的建置目標,勿強制忽略相依性。
安裝完成後,從應用程式選單開啟 v2rayN。一般圖形桌面環境建議在目前使用者工作階段執行,勿為了略過單一權限提示,長期以高權限啟動整個桌面程式。先確認本機監聽與系統代理,再處理 TUN。不同桌面環境讀取系統代理的方式不盡相同,部分應用程式需要在自身網路設定中選擇系統代理,或手動填入本機位址。
TUN 啟用失敗時,請查看記錄中的權限、虛擬網卡與路由錯誤,依照具體訊息處理。切勿同時啟用多個代理程式的 TUN 接管功能。更換發行版或移轉裝置前,請分別備份訂閱群組與自訂路由,勿直接將舊系統的路徑、網路介面名稱與權限設定照搬至新環境。
CLIENT & CORE
客戶端、核心與訂閱的差異
Project V 是 V2Ray 技術生態系的起點。V2Fly 延續相關核心的維護,Xray 則是此生態系中的另一條核心發展路線。圖形化客戶端負責管理設定、呼叫核心並提供操作介面;協定與傳輸方式的實際支援範圍,則取決於目前使用的核心及其版本。
v2rayN、v2rayNG、v2flyNG 都是免費開源客戶端。桌面端選 v2rayN,Android 優先選用採用 Xray 核心的 v2rayNG;明確需要 V2Fly 核心時,再考慮 v2flyNG。下載客戶端不代表已取得伺服器,訂閱需另外準備。
遇到無法辨識的協定欄位時,先別隨意更換安裝檔。請確認分享連結類型、核心支援情況及記錄中的錯誤,再決定是否更新客戶端。需要進一步比較選擇時,請參閱三款客戶端完整評測;各平台的環境設定請見全平台安裝指南。
AFTER INSTALLATION
安裝後的設定順序
先建立一條可供測試的連線,再調整分流與流量接管。每次只變更一類設定,方便還原與排查。
STEP 01
匯入訂閱或分享連結
桌面端前往「訂閱群組設定」,新增群組並填入訂閱網址。格式範例如 https://example.com/sub?token=xxxx。儲存後更新訂閱;尚未建立代理時,可嘗試「更新訂閱(不透過代理)」。若服務要求特定網路環境,請依服務說明選擇更新方式。
Android 可從新增選單選擇訂閱,或從剪貼簿匯入。訂閱網址與單一分享連結是不同內容,請使用對應的匯入入口。更新完成後,確認清單中是否出現伺服器;若清單為空,先查看更新結果,暫時不要變更系統代理。
STEP 02
選取伺服器並確認設定
從清單選取一個項目作為目前使用的伺服器,確認位址、連接埠、協定與傳輸參數。匯入訂閱通常會一併帶入這些欄位,不需自行猜測填寫。手動設定時,則須逐項比對服務端資訊,尤其是 TLS、SNI 與 REALITY 相關欄位。
延遲測試結果只反映特定測試條件,不能取代實際存取測試。測試失敗時,請分辨是 DNS、連線逾時還是交握錯誤,並搭配記錄排查。請勿公開包含訂閱網址、身分欄位或完整設定的截圖。
STEP 03
設定系統代理或連線權限
桌面端先使用系統代理測試瀏覽器連線。確認客戶端的本機監聽連接埠與系統代理連接埠一致,且沒有其他程式重複變更代理設定。Android 請確認已授予系統 VPN 權限,再查看應用程式顯示的連線狀態。
系統代理不會自動套用至所有應用程式。若某個程式仍直接連線,先確認它是否會讀取系統代理,再判斷是否需要 TUN。TUN 涉及權限、虛擬網卡、DNS 與路由,基礎連線尚未確認前,不應同時啟用。
STEP 04
設定路由並保留可還原的設定
依實際用途選擇路由模式,例如「繞過中國大陸」,並確認需要直連及需要代理的應用程式是否符合預期。路由規則會決定流量走向,無法修復已失效的伺服器。修改自訂規則前,請先儲存目前可正常使用的設定。
完成後,依序測試網頁瀏覽、常用應用程式、網路切換,以及結束客戶端後的連線狀態。準備升級時,記下本機連接埠、訂閱群組與規則來源。需要逐步操作說明,請接著閱讀匯入訂閱與連線教學。
DOWNLOAD FAQ
下載與安裝常見問題
Windows 桌面版與經典 WPF 版該怎麼選?
首次安裝可選擇桌面版 Desktop,採用新一代跨平台介面。習慣經典介面與操作方式的使用者,可選擇穩定成熟的 WPF 版。兩者都是 v2rayN;首次使用其中一版時,請先匯入訂閱並確認系統代理正常,再移轉其他設定。
Android 該下載 arm64 還是通用版?
2015 年後的主流手機通常可優先選擇 arm64,仍應以裝置實際支援的應用程式架構為準。不確定架構,或 arm64 安裝檔顯示不相容時,請選通用版。通用版支援較多架構,檔案通常也較大;訂閱或連線問題不應靠更換架構安裝檔處理。
安裝客戶端後,為什麼還沒有可連線的伺服器?
客戶端負責讀取設定並轉送流量,安裝檔不含可用伺服器。請準備自行管理或合法取得的訂閱網址、分享連結或設定檔,再透過訂閱群組或匯入選單新增。訂閱網址含有存取憑證,請勿公開或直接放進求助截圖。
下載後顯示無法安裝,應先檢查什麼?
先確認作業系統、處理器架構與安裝檔格式,再查看系統提示。Windows 的 ZIP 檔須完整解壓縮;macOS 須分辨 Apple Silicon 與 Intel;Android 請檢查安裝權限與簽章衝突;Linux 則查看套件管理器回報的相依套件與發行版相容性。
更新客戶端時,原有的訂閱與路由設定該怎麼處理?
更新前,使用客戶端提供的備份或匯出功能,並記下訂閱群組、路由模式及本機監聽連接埠。先結束舊版客戶端,再安裝適用於目前系統的新版本。更新後確認設定仍在,再更新訂閱並測試連線;跨介面版本移轉時,勿直接覆寫不相容的設定檔。