客戶端安裝包 / 四大平台
V2Ray 客戶端下載
桌面版請選 v2rayN。Android 建議使用 v2rayNG，若需要 V2Fly 核心則選 v2flyNG。
先選作業系統，再選處理器架構。三款客戶端皆為免費開源軟體；訂閱網址與節點設定需另行準備。安裝包名稱、客戶端版本與核心版本各有不同，請依平台、架構及檔案格式選擇。
Windows 安裝包
同一款 v2rayN，提供兩種介面。首次安裝建議從 Desktop 開始。
系統需求與安裝條件
| 檢查項目 | 選擇依據 |
|---|---|
| 系統架構 | 本頁提供的 Windows 安裝包為 x64；請在「設定 → 系統 → 系統資訊」查看「系統類型」。 |
| 系統版本 | 建議使用仍有系統更新支援的 Windows 10 / 11；舊版系統請先確認與目前客戶端及執行階段的相容性。 |
| 安裝權限 | 一般系統代理不等同於 TUN；啟用虛擬網卡相關功能時，可能需要管理員授權。 |
下載 ZIP 後，先解壓縮至一般資料夾，再執行其中的安裝程式。請勿直接從壓縮檔預覽視窗啟動。安裝路徑應方便讀取與寫入；若已有舊版，請先結束系統匣中的 v2rayN，避免兩個程式同時占用本機監聽連接埠。
首次啟動後，從頂端「訂閱群組」選單進入「訂閱群組設定」，新增群組名稱與訂閱網址，再更新訂閱。伺服器清單出現節點後，選取節點並設為目前使用的伺服器。最後從系統匣選單設定系統代理。只啟動客戶端，卻未指定使用中的節點或接管應用程式流量，瀏覽器仍可能維持原本的連線方式。
Desktop 與 WPF 的選單配置可能不同，遷移設定也不宜只靠複製程式檔案。請先記下訂閱群組、路由選擇與本機連接埠，再使用目前版本提供的備份或匯出功能保存設定。若執行時提示缺少元件，請依安裝程式指示確認相依項目，不要反覆改裝另一種介面版本。
macOS 安裝包
在「關於這台 Mac」確認處理器，再選擇對應的 DMG。
v2rayN
Apple Silicon
若「關於這台 Mac」顯示 Apple M 系列晶片，請選 arm64，使用符合晶片架構的原生安裝包。
下載v2rayN · Apple Siliconarm64 · DMG
系統需求與安裝條件
| 檢查項目 | 選擇依據 |
|---|---|
| 處理器架構 | Apple 選單 → 關於這台 Mac，查看「晶片」或「處理器」欄位。 |
| 系統版本 | 請使用目前客戶端支援的 macOS 版本；舊版系統請留意啟動時顯示的最低系統版本需求。 |
| 網路權限 | 系統代理與 TUN 是不同的流量接管方式；若涉及網路延伸功能或提升權限，請先確認系統授權提示。 |
開啟 DMG 後，將應用程式複製到「應用程式」資料夾，再從該處啟動。請勿長期從已掛載的磁碟映像執行，否則容易混淆升級、權限記錄與啟動位置。若系統阻止開啟，請先確認下載來源與系統提示，再到「系統設定 → 隱私權與安全性」查看相關記錄；不要只為了安裝一次就關閉整體系統安全機制。
匯入訂閱後，先選擇使用中的節點，再設定代理。前往「系統設定 → 網路」，選取目前的網路服務，進入「詳細資訊 → 代理」，確認系統代理是否與客戶端顯示的本機位址及連接埠一致。應用程式內建的個別代理設定可能會覆蓋系統設定；瀏覽器能連線，不代表所有程式都會經過代理。
升級前先結束選單列中的客戶端，再替換「應用程式」資料夾裡的舊版應用程式。若新版本啟動後設定是空的，請先確認開啟的是原本的應用程式位置及同一個使用者帳戶。若權限要求反覆出現，請檢查是否仍從 DMG 或舊副本啟動，避免同時保留多個難以區分的執行副本。
Android 安裝包
先選客戶端，再選 arm64 或通用版。兩款應用程式各自管理設定。
v2rayNG
推薦一般 Android 使用者優先選擇。支援訂閱管理與匯入節點，並透過系統 VPN 介面接管流量；實際支援的協定取決於應用程式內含的核心。
2015 年後推出的主流手機通常可選 arm64；不確定架構時請選通用版。請以裝置系統實際支援的 ABI 為準。
v2flyNG
替代選項適合需要使用 V2Fly 設定的使用者。這是與 v2rayNG 分開的應用程式；更換客戶端前，請確認目標核心能辨識節點協定與傳輸設定。
arm64 適用於 64 位元 ARM 系統；通用版支援較多架構，但安裝包通常較大。
系統需求與安裝條件
| 檢查項目 | 選擇依據 |
|---|---|
| 系統相容性 | 請以 Android 安裝程式對目前 APK 顯示的相容性提示為準；處理器支援 64 位元，不代表系統一定提供 64 位元執行環境。 |
| 安裝授權 | 請授權實際用來開啟 APK 的瀏覽器或檔案管理工具「安裝未知應用程式」；安裝完成後可取消授權。 |
| VPN 介面 | 首次連線時需確認系統 VPN 授權；通常無法與另一款使用相同 VPN 介面的應用程式同時接管流量。 |
下載 APK 後，從下載記錄或檔案管理工具開啟。不同手機的設定名稱略有差異，可在「設定」中搜尋「安裝未知應用程式」，只授權這次用來開啟檔案的應用程式。安裝程式若顯示「未安裝應用程式」，請先檢查剩餘儲存空間、系統版本、處理器架構及舊版簽章，不要直接刪除舊應用程式。
在 v2rayNG 中，從側邊選單進入「訂閱群組設定」新增網址，再從主畫面的選單更新訂閱。若已有節點分享連結，也可透過新增選單中的剪貼簿匯入功能加入。節點出現後點選節點，再按連線按鈕，並確認系統跳出的 VPN 連線要求。訂閱更新完成不代表服務已連線，兩者都要分別確認。
若背景執行時斷線，請到系統的「應用程式資訊」檢查電池與背景活動限制。部分裝置會在螢幕鎖定後限制網路活動，建議先觀察應用程式在前景時能否穩定連線，再調整相關權限。切換至 v2flyNG 時，請重新匯入訂閱網址或相容的分享連結；兩款客戶端的應用程式私有資料不會自動同步。
Linux 安裝包
依發行版選擇 deb / rpm，再確認 x64 或 arm64。
v2rayN
deb 套件
適用於使用 deb 套件管理的 Debian、Ubuntu 等發行版。預設下載選項適用於常見的 Intel / AMD 64 位元桌面架構。
下載v2rayN · x64 deb ARM 裝置：下載 arm64 deb →rpm 套件
適用於使用 RPM 套件管理的發行版。套件也可能要求特定版本的系統程式庫；格式相符不代表所有發行版都能安裝。
下載v2rayN · x64 rpm ARM 裝置：下載 arm64 rpm →系統需求與安裝條件
| 檢查項目 | 選擇依據 |
|---|---|
| 套件管理格式 | 請在系統軟體中心或發行版說明中確認使用 deb 還是 rpm，不要只靠桌面外觀判斷。 |
| 處理器架構 | x64 對應 amd64 / x86_64；arm64 對應 aarch64。請在系統「關於」或硬體資訊中查看。 |
| 桌面環境與相依項目 | 需要圖形桌面環境及安裝程式要求的系統程式庫；請以軟體管理工具顯示的相依性檢查結果為準。 |
使用系統軟體安裝程式開啟下載的套件，先查看相依項目與相容性提示，再確認安裝。若安裝程式指出相依項目無法滿足，請優先確認發行版版本是否符合套件需求。不要強制略過相依項目，也不要只因同為 RPM 格式，就認定能跨發行版直接安裝。
啟動 v2rayN 後，先匯入訂閱並選擇使用中的節點。Linux 桌面版的系統代理通常由桌面環境管理，各應用程式遵循系統設定的程度不一。在 GNOME 中可前往「設定 → 網路 → 網路代理」檢查；其他桌面環境請尋找相應的網路代理設定。終端機程式或使用自有網路堆疊的應用程式，可能仍需個別設定。
TUN 涉及虛擬網路裝置與權限，不能與系統代理混為一談。首次測試時先選用一種流量接管方式，確認本機連接埠、節點與路由正常後，再啟用其他功能。升級前請結束舊程序並備份設定；切換 deb / rpm 或改用其他架構都不能取代正常遷移，也無法解決節點服務本身的連線問題。
安裝後的三項檢查
完成安裝只是準備工作。依序確認訂閱、節點與流量接管方式，排除問題時更容易找出原因。
已匯入訂閱
確認訂閱網址完整，更新後清單中出現預期的節點。訂閱更新失敗時，先查看更新記錄，判斷是網址失效、網路要求失敗，還是格式無法解析。不要反覆匯入相同群組來掩蓋錯誤。
查看訂閱匯入步驟 →已選取節點
訂閱群組不等於目前使用中的節點。選擇伺服器後再啟動連線，並查看記錄是否出現監聽連接埠占用、協定欄位缺漏或交握異常。清單中的名稱只是備註，不代表服務一定可用。
查看連線與驗證步驟 →應用程式已接管流量
系統代理仰賴應用程式遵循設定，TUN 則透過虛擬網卡處理流量。請先確認實際啟用的方式，再檢查路由規則。某個網站直接連線可能是分流結果，不能只憑網頁能否開啟來判斷。
查看全平台設定指南 →客戶端介面版本、核心支援的協定與伺服器設定，都會影響連線是否可用。Project V、V2Fly 與 Xray 屬於相關技術生態系，但不能任意互換設定標籤。若使用特殊傳輸方式或安全設定，請先確認目標客戶端的核心是否支援，再遷移節點。想比較三款客戶端，請參閱客戶端比較。
下載與安裝常見問題
整理選擇安裝包、升級與首次連線相關問題。其他網路問題請參閱常見問題。
下載客戶端後，就有可用節點嗎？
客戶端用來管理設定與轉送流量，安裝包不等於節點服務。請先準備有權使用的訂閱網址或節點分享連結，再匯入客戶端。訂閱網址可能含有存取憑證，請勿公開貼上或放入截圖。
Windows 版該選 Desktop 還是 WPF？
首次安裝建議選 Desktop，採用新一代跨平台介面。WPF 是經典穩定版，適合習慣 Windows 傳統操作方式的使用者。兩者都是 v2rayN，本頁提供的安裝包皆為 x64。更換介面版本前請先備份設定，也不要同時啟動兩個客戶端。
Android 該下載 arm64 還是通用版？
2015 年後推出的主流手機通常可優先選 arm64，仍應以系統支援的 ABI 為準，不能只看處理器名稱。無法確認架構時請選通用版。若安裝時解析失敗，也要檢查系統版本、檔案是否下載完整，以及同名應用的簽章是否一致。
升級前需要解除安裝舊版嗎？
先備份設定，再結束舊客戶端。同一款應用的簽章、架構與安裝方式一致時，通常可直接覆蓋升級。Android 若發生簽章衝突，請勿直接解除安裝，以免遺失應用程式資料；先確認安裝來源並匯出設定。桌面版更換安裝目錄或介面版本時，也請先保留原有設定。
安裝完成但網頁無法開啟，需要重新下載嗎？
先檢查節點、訂閱與代理接管方式，不必立刻重新下載。在 v2rayN 伺服器清單確認目前使用的節點，查看底部記錄，再檢查系統代理；Android 則確認已允許 VPN 連線並啟動服務。連接埠衝突、訂閱過期、系統時間錯誤或 TLS 參數異常，都無法靠重複安裝解決。