桌面平台選擇 v2rayN，Android 可選擇 v2rayNG 或使用 v2fly 核心的 v2flyNG。先確認作業系統、處理器架構與安裝包格式，再前往對應平台下載。
平台選項會同步至頁面網址。下載前請先閱讀卡片中的架構說明；若裝置資訊不明，優先查看系統設定或系統資訊頁面，不要只憑檔名猜測。
Windows 平台固定提供 v2rayN。桌面版採用新一代跨平台 UI，適合首次安裝或希望介面體驗接近其他桌面平台的使用者；WPF 版是 Windows 上長期使用的經典介面，系統匣與設定配置更符合既有操作習慣。兩個版本都能管理訂閱、路由、DNS、系統代理與本機監聽連接埠，主要差異在介面技術與桌面互動方式。
若先前沒有使用過 v2rayN，可先下載桌面版。已有 WPF 設定與操作習慣的使用者，可繼續選擇經典 WPF 版。更新前建議記錄訂閱群組、路由規則、本機 SOCKS 連接埠與系統代理模式。
| 檢查項目 | 建議選擇 | 說明 |
|---|---|---|
| 處理器架構 | x64 | 本頁 Windows 安裝包對應 64 位元 x86 架構，下載前可在「系統資訊」中確認系統類型。 |
| 介面類型 | Desktop 或 WPF | 首次使用優先考慮桌面版；熟悉經典 v2rayN 工作流程時可選擇 WPF 版。 |
| 安裝後設定 | 訂閱、路由、系統代理 | 程式啟動後仍需匯入有效設定，並依應用情境選擇系統代理模式。 |
macOS 平台使用 v2rayN 桌面版，安裝包依處理器架構區分。搭載 Apple M 系列晶片的裝置選擇 Apple Silicon 版；系統資訊顯示 Intel 處理器的裝置選擇 Intel 版。架構必須與裝置相符，訂閱匯入、路由設定、DNS 與系統代理操作則使用同一套客戶端邏輯。
開啟系統選單中的「關於這台 Mac」或系統資訊頁面，查看晶片或處理器欄位。Apple M 系列使用 arm64 安裝包，Intel 處理器使用 x64 安裝包。不要只根據裝置購買年份判斷架構。
| 系統資訊 | 對應安裝包 | 判斷方式 |
|---|---|---|
| Apple M 系列晶片 | Apple Silicon DMG | 系統資訊的晶片欄位顯示 Apple M 系列型號時，使用 arm64 架構包。 |
| Intel 處理器 | Intel DMG | 系統資訊的處理器欄位顯示 Intel 型號時，使用 x64 架構包。 |
| 首次啟動 | 確認系統權限 | 首次開啟時依系統提示處理應用程式啟動與網路存取權限，再設定系統代理。 |
Android 平台先選擇 v2rayNG，它採用 Xray 核心並支援 VMess、VLESS、Trojan、Shadowsocks 等常見設定。需要使用 v2fly 核心工作流程時，可選擇 v2flyNG。兩款客戶端都提供 arm64 與通用安裝包；2015 年後的主流手機通常優先選擇 arm64，無法確認架構時再選擇通用版。
適合需要使用 Xray 核心及其相關協定能力的 Android 使用者。首次下載優先選擇 arm64；若裝置較舊、架構未知或 arm64 包無法安裝，再改用通用版。
適合明確需要 v2fly 核心行為或已有相應設定工作流程的使用者。客戶端選擇應以設定相容性為依據，不需要同時安裝兩款應用程式來完成同一套日常連線。
| 檢查項目 | 優先選擇 | 說明 |
|---|---|---|
| 主流 64 位元 ARM 裝置 | arm64 | 多數 2015 年後的主流手機採用此架構，安裝包大小與目標架構更集中。 |
| 無法確認架構 | 通用版 | 通用包支援範圍更廣，適合系統資訊不完整或 arm64 包顯示不相容的裝置。 |
| 客戶端路線 | 優先選擇 v2rayNG | 一般使用先選 v2rayNG；明確需要 v2fly 核心時再選擇 v2flyNG。 |
Linux 平台使用 v2rayN 桌面客戶端。Debian、Ubuntu 及其衍生發行版通常選擇 deb；Fedora、Rocky Linux、AlmaLinux 與 RHEL 系列發行版通常選擇 rpm。確定格式後，還需要在 x64 與 arm64 間選擇正確架構。本頁不提供通用壓縮包，優先使用發行版的軟體包管理機制完成安裝與升級。
一般桌上型電腦通常選擇 x64，採用 ARM 處理器的裝置選擇 arm64。再依發行版的軟體包格式選擇 deb 或 rpm。下載前可執行系統內建的架構查詢工具，也可在系統資訊介面確認處理器類型。
| 發行版或裝置 | 安裝包 | 架構說明 |
|---|---|---|
| Debian、Ubuntu 及其衍生版 | deb | 一般 Intel 或 AMD 桌面裝置通常選擇 x64；ARM 裝置選擇 arm64。 |
| Fedora、Rocky Linux、AlmaLinux、RHEL 系列 | rpm | x86_64 對應 x64，aarch64 對應 arm64。 |
| 桌面工作階段 | 圖形環境 | v2rayN 是圖形客戶端，需要可用的桌面工作階段與系統匣或同等桌面功能。 |
安裝包只解決客戶端程式的部署問題。能否正常建立連線，還取決於設定格式、客戶端支援範圍、本機監聽設定、路由規則與系統代理狀態。
卡片中的版本號由同源版本清單更新。升級前可記錄目前設定，並閱讀新版本介面中的欄位變更。若只是更換同一客戶端的安裝包架構，不應同時將舊架構與新架構程式作為日常入口。
x64、arm64、Apple Silicon 與 Intel 描述的是處理器或程式架構。架構選錯時，常見結果是安裝程式拒絕執行、程式無法啟動，或系統提示應用程式與裝置不相容。先查閱系統資訊，再下載對應檔案。
v2rayN 面向桌面平台，v2rayNG 與 v2flyNG 面向 Android。客戶端名稱相近，但執行平台、介面與核心路線不同。不要將桌面客戶端的安裝步驟直接套用到行動裝置，也不要把安裝包選擇等同於協定選擇。
安裝成功不代表連線流程已經結束。首次啟動建議依固定順序完成設定，方便在發生問題時快速定位至訂閱、路由、連接埠或系統代理的具體環節。
Windows 依所選介面版本完成安裝；macOS 開啟對應架構的 DMG；Android 使用與裝置架構相符的安裝包；Linux 透過發行版對應的軟體包工具安裝 deb 或 rpm。首次啟動時，依系統提示處理必要的應用程式執行與網路存取權限。
在客戶端的訂閱群組或匯入功能中加入有效網址，也可以匯入客戶端支援的分享連結或設定檔。匯入後先檢查伺服器項目是否完整，再確認協定、傳輸方式與安全性欄位沒有因格式不相容而遺失。
常見設定包括本機 SOCKS 監聽連接埠、允許區域網路連線、流量探測、DNS 與路由模式。預設連接埠被其他程式佔用時，需要調整連接埠，並同步修改所有使用該連接埠的應用程式。路由規則應先從簡潔設定開始，再依實際需求增加網域或 IP 比對條件。
選擇有效設定後啟動連線，再依使用方式啟用系統代理或在目標應用程式中填寫本機代理位址。驗證時應分別檢查客戶端記錄、系統代理開關、應用程式代理設定與 DNS 行為。若只有個別應用程式無法連線，優先檢查該應用程式是否繞過系統代理。
以下問題涵蓋介面版本、處理器架構、Linux 軟體包格式、首次連線與升級準備。客戶端執行問題可繼續前往疑難排解頁面，依記錄與設定逐項檢查。
桌面版採用新一代跨平台介面，適合希望在不同桌面系統間維持相近操作方式的使用者；WPF 版僅支援 Windows，介面、系統匣與設定配置更接近經典 v2rayN。首次安裝可先選擇桌面版，已有 WPF 使用習慣或需要延續既有工作流程時，可選擇經典版。兩者都提供訂閱、路由、DNS、本機連接埠與系統代理等核心設定。
開啟系統資訊並查看晶片或處理器欄位。顯示 Apple M 系列晶片時選擇 Apple Silicon 版；顯示 Intel 處理器時選擇 Intel 版。兩種安裝包的主要差異在處理器架構，訂閱與路由設定方式基本一致。若安裝後出現架構不相容提示，應返回系統資訊重新確認，而不是反覆覆蓋安裝同一個檔案。
2015 年後的主流 Android 手機通常優先選擇 arm64 版，適用於常見的 64 位元 ARM 架構。無法確認裝置架構、系統資訊沒有提供明確標示，或安裝時顯示不相容時，可改用通用版。通用版支援範圍更廣，但客戶端功能不會因此比同版本 arm64 包增加。
Debian、Ubuntu 及其衍生發行版通常使用 deb；Fedora、Rocky Linux、AlmaLinux、RHEL 系列發行版通常使用 rpm。確定格式後還要檢查架構：一般 Intel、AMD 桌面裝置通常為 x64，ARM 裝置則選擇 arm64。軟體包格式與處理器架構是兩個獨立條件，必須同時相符。
客戶端安裝完成只代表程式能夠執行。還需要匯入有效訂閱或設定，選擇可用項目，設定合適的路由模式，啟動連線，並依使用情境啟用系統代理。若應用程式使用獨立代理設定，也要確認代理類型、位址與連接埠和客戶端本機監聽設定一致。排查時先查看客戶端記錄，再檢查系統代理與應用程式代理，避免一次修改多個變數。
建議先記錄訂閱群組、路由規則、DNS 設定、本機監聽連接埠、系統代理模式與自訂啟動選項。覆蓋安裝通常不需要重新建立所有設定，但跨介面版本或跨較大版本更新時，欄位名稱與預設行為可能改變。安裝完成後應逐項核對重要設定，先用單一設定驗證連線，再恢復複雜路由。