依作業系統選擇 v2rayN、v2rayNG 或 v2flyNG。每個入口均標示介面版本、處理器架構與安裝包類型，先確認裝置資訊，再開始下載。
切換平台後，只顯示該系統可用的客戶端與安裝包。下載前查看卡片中的架構說明，可減少因安裝包類型不相容而導致的安裝失敗。
Windows 提供桌面版與經典 WPF 版兩個入口。兩者都用於管理訂閱、伺服器設定、路由規則與系統代理，主要差異在於介面技術路線與操作習慣。首次安裝可優先選擇桌面版；已熟悉傳統 v2rayN 介面的使用者，則可繼續選擇經典 WPF 版。
v2rayN 適合在 Windows 桌面環境中集中管理訂閱、手動設定、路由模式與代理狀態。下載完成後解壓縮安裝包並執行其中的安裝程式，安裝結束後再匯入訂閱或伺服器參數。若從舊版遷移，建議先記錄原有訂閱網址、路由模式與自訂設定，再於新版中逐項還原。
新一代跨平台 UI，介面結構與其他桌面系統相近，適合新安裝以及希望使用後續桌面功能的使用者。
延續傳統 Windows 客戶端的選單與視窗配置，適合已熟悉舊版 v2rayN 操作方式的使用者。
| 檢查項目 | 需求與判斷方式 |
|---|---|
| 處理器架構 | 本頁 Windows 安裝包為 x64。可在系統設定的「系統類型」中查看處理器與作業系統架構。 |
| 安裝權限 | 安裝程式需要寫入應用程式目錄。受管理的裝置可能需要管理員授權。 |
| 網路設定 | 安裝後需要匯入有效訂閱或手動設定，接著選擇設定並配置系統代理模式。 |
| 舊版遷移 | 先記錄訂閱群組、路由設定與自訂連接埠。不要直接覆寫仍在執行的舊程式目錄。 |
macOS 安裝包分為 Apple Silicon 與 Intel 兩種架構。開啟系統選單中的「關於這台 Mac」，查看「晶片」或「處理器」欄位：顯示 Apple M 系列時選擇 Apple Silicon，顯示 Intel 時選擇 Intel。架構必須與裝置相符，否則應用程式可能無法啟動。
macOS 版 v2rayN 使用桌面介面管理訂閱、連線設定與路由規則。安裝包架構是首要選擇條件，與裝置晶片無關的功能設定可在安裝後完成。下載對應 DMG 後開啟檔案，將應用程式放入系統應用程式目錄，再依系統提示授予執行與網路設定所需的權限。
適用於採用 Apple M 系列晶片的 Mac。新款裝置通常屬於此架構，但仍應以「關於這台 Mac」顯示的資訊為準。
適用於「關於這台 Mac」中明確顯示 Intel 處理器的裝置。不要僅依裝置外觀或購買年份判斷。
| 檢查項目 | 需求與判斷方式 |
|---|---|
| 晶片架構 | Apple M 系列選擇 arm64 安裝包，Intel 處理器選擇 x64 安裝包。 |
| 應用程式目錄 | 開啟 DMG 後將客戶端放入系統應用程式目錄，避免長時間從暫時掛載的視窗執行。 |
| 執行授權 | 首次啟動可能會出現系統安全性確認。依系統設定中的提示核對應用程式名稱並完成授權。 |
| 代理權限 | 啟用系統代理或網路擴充功能時，系統可能要求輸入本機帳戶憑證以確認設定。 |
Android 平台先選擇採用 Xray 核心體系的 v2rayNG；需要使用 V2Fly 核心體系時，再選擇 v2flyNG。兩款客戶端都提供 arm64 與通用版。2015 年後的主流手機通常優先使用 arm64，無法確認架構或安裝不相容時改用通用版。
v2rayNG 提供訂閱匯入、QR Code 辨識、手動設定、路由規則與連線記錄等常用功能。安裝後需要授予系統 VPN 連線權限，接著匯入有效設定並從清單中選擇伺服器。arm64 套件針對主流 64 位元 ARM 裝置；通用版涵蓋範圍更廣，適合架構資訊不明確的裝置。
適用於多數 2015 年後推出的主流 Android 手機與平板。確認裝置採用 64 位元 ARM 處理器時優先選擇。
適合無法確認處理器架構，或 arm64 安裝包提示不相容的裝置。功能入口與 arm64 版一致。
v2flyNG 適用於需要使用 V2Fly 核心體系的 Android 設定。它與 v2rayNG 是兩個獨立客戶端，通常依據訂閱提供者說明、協議相容要求與既有設定擇一。若目前設定明確要求 V2Fly，或需要維持與既有 V2Fly 設定一致，可安裝 v2flyNG。
適用於採用 64 位元 ARM 處理器的主流 Android 裝置。處理器架構明確時優先使用此版本。
無法確認裝置架構時使用。安裝後仍需匯入與 V2Fly 體系相容的訂閱或手動設定。
| 檢查項目 | 需求與判斷方式 |
|---|---|
| 處理器架構 | 2015 年後的主流裝置通常優先選擇 arm64；無法確認時選擇通用版。 |
| 安裝權限 | 從瀏覽器下載後，系統可能要求允許目前檔案來源執行安裝。依系統提示完成一次性授權。 |
| VPN 權限 | 首次連線時需要確認系統 VPN 請求。此權限用於讓客戶端接管裝置的網路連線。 |
| 背景執行 | 若系統頻繁結束連線，可在電池管理中檢查客戶端的背景執行策略。 |
Linux 安裝包同時區分軟體包格式與處理器架構。Debian、Ubuntu 及其衍生發行版通常選擇 deb；Fedora、RHEL 系列及其衍生發行版通常選擇 rpm。一般桌上型電腦多為 x64，採用 ARM 處理器的裝置則選擇 arm64 對應入口。
Linux 版 v2rayN 提供桌面圖形介面。選擇安裝包時先判斷發行版採用 deb 或 rpm，再透過系統架構資訊區分 x64 與 arm64。安裝後如需修改系統代理，也應檢查桌面環境的代理設定、客戶端監聽狀態與目前路由模式。
適用於採用 deb 軟體包管理方式的 x64 桌面系統，是常見 PC 與筆記型電腦的主要選擇。
適用於採用 rpm 軟體包管理方式的 x64 桌面系統。安裝前確認發行版能夠處理 rpm 套件。
裝置架構顯示為 aarch64 或 arm64 時，依發行版選擇下方對應的軟體包。
deb 檔案：v2rayn_7.24.1_arm64.deb
rpm 檔案：v2rayN-7.24.1-1.el10.aarch64.rpm
| 檢查項目 | 需求與判斷方式 |
|---|---|
| 軟體包格式 | Debian、Ubuntu 系列通常選擇 deb；Fedora、RHEL 系列通常選擇 rpm。 |
| 處理器架構 | x86_64 對應 x64，aarch64 或 arm64 對應 arm64。 |
| 桌面環境 | 圖形客戶端需要可用的桌面工作階段。純命令列環境不適合執行本頁提供的桌面程式。 |
| 系統代理 | 不同桌面環境的代理設定入口不同。啟用客戶端後仍需檢查桌面環境是否採用相應設定。 |
客戶端安裝包只解決程式安裝問題。訂閱網址、伺服器參數、路由規則與系統代理狀態需要在安裝完成後分別設定。
先確認目前裝置使用 Windows、macOS、Android 還是 Linux。不同平台的程式結構、權限模型與安裝流程不同，不能交叉使用安裝包。
x64、arm64、Apple Silicon 與 Intel 是安裝包選擇中的關鍵欄位。系統設定頁或系統資訊工具能提供準確結果，不建議只依裝置購買時間推斷。
升級或遷移前記錄訂閱網址、手動伺服器參數、路由模式與本機連接埠。安裝完成後依原有用途逐項還原，避免將程式更新與設定變更混在同一個步驟處理。
啟動客戶端後匯入有效設定，選擇要使用的項目，再啟用系統代理或行動裝置 VPN 服務。連線異常時先查看客戶端記錄，再檢查系統代理與 DNS 設定。
以下集中說明下載階段最常見的版本、晶片、架構與首次設定問題。連線問題可繼續前往問題診斷頁，依症狀進行排查。
桌面版採用新一代跨平台介面，適合新安裝以及希望使用新版介面結構的使用者。經典 WPF 版延續傳統 Windows 操作方式，選單位置與舊版使用習慣更接近。兩種版本不需要同時安裝；無法確定時先選擇桌面版，已有穩定使用流程時則可依原有習慣選擇 WPF 版。
開啟系統選單中的「關於這台 Mac」，查看晶片或處理器資訊。顯示 Apple M 系列晶片時選擇 Apple Silicon 版本；顯示 Intel 處理器時選擇 Intel 版本。架構選擇只與裝置晶片有關，與訂閱類型、伺服器協議和路由模式無關。
2015 年後的主流 Android 手機通常優先選擇 arm64。若系統資訊確認處理器為 64 位元 ARM，直接下載 arm64 即可。無法確認架構，或安裝時出現軟體包與裝置不相容提示，再改用通用版。兩種安裝包的客戶端功能入口相同。
Debian、Ubuntu 及其衍生發行版通常使用 deb；Fedora、RHEL 系列及其衍生發行版通常使用 rpm。選定格式後還要判斷處理器架構：常見桌上型電腦多為 x64，架構資訊顯示 aarch64 或 arm64 的裝置則選擇 arm64 對應套件。
客戶端負責讀取、管理和執行設定，安裝包本身不包含伺服器參數。完成安裝後，需要匯入有效訂閱連結，或依伺服器提供的資訊手動填寫位址、連接埠、使用者識別、傳輸方式與安全參數。匯入後更新清單、選擇設定，再啟用系統代理或 VPN 服務。