首選
v2rayN
Windows x64 圖形客戶端，提供桌面版與經典 WPF 版兩種介面分支。
// PLATFORM SELECTOR
依平台選擇安裝包
四大平台分別列出適用客戶端、主要安裝包、備選架構與基本系統需求。切換平台時，頁面網址會同步對應錨點。
// WINDOWS PACKAGES
Windows：v2rayN
桌面版採用新一代跨平台 UI，適合首次安裝及希望統一桌面體驗的使用者；經典 WPF 版延續傳統 Windows 介面與操作配置，適合已有使用習慣的環境。兩個入口都屬於 v2rayN，差異主要在圖形介面技術與互動配置。
Windows 系統需求與安裝順序
| 檢查項目 | 建議 |
|---|---|
| 處理器架構 | 本頁 Windows 安裝包適用於 x64 系統。可在「系統資訊」的系統類型欄位中確認。 |
| 安裝權限 | 安裝程式需要寫入應用程式目錄。受管理裝置出現權限提示時，應依照本機管理政策處理。 |
| 首次啟動 | 啟動後先匯入訂閱或單筆設定，更新訂閱群組，再選擇設定並啟動核心。 |
| 系統代理 | 客戶端啟動不代表系統流量已經接入。需要依使用方式開啟系統代理或設定應用程式代理。 |
// MACOS PACKAGES
macOS：v2rayN
macOS 安裝包依處理器架構區分。Apple M 系列晶片選擇 Apple Silicon arm64 版本，Intel 處理器選擇 x64 版本。架構必須相符；僅憑裝置外觀或購買年份判斷容易出錯，下載前應開啟系統資訊核對晶片欄位。
首選
v2rayN
macOS 桌面圖形客戶端，分別提供 Apple Silicon 與 Intel 安裝包。
macOS 系統需求與安裝順序
| 檢查項目 | 建議 |
|---|---|
| 晶片類型 | 從系統資訊查看晶片或處理器名稱。M 系列對應 arm64，Intel 處理器對應 x64。 |
| 安裝檔案 | 下載完成後開啟 dmg，依系統提示將應用程式放入應用程式目錄。 |
| 首次開啟 | 依系統安全性提示確認應用程式來源並執行開啟操作，不要反覆下載不同架構的檔案嘗試覆蓋。 |
| 代理權限 | 開啟系統代理或相關網路功能時，系統可能要求確認權限。設定完成後再檢查客戶端狀態。 |
// ANDROID PACKAGES
Android：v2rayNG 與 v2flyNG
一般使用情境先選擇採用 Xray 核心的 v2rayNG。明確需要 v2fly 核心、既有設定依 v2fly 行為維護，或需要對應相容路徑時，再使用 v2flyNG。兩款客戶端都提供 arm64 與通用版，2015 年後的主流手機通常先選 arm64。
首選
v2rayNG
採用 Xray 核心的 Android 圖形客戶端，適合作為一般首選。
v2fly 核心備選
v2flyNG
採用 v2fly 核心的 Android 圖形客戶端，適合有明確核心相容需求的情況。
Android 系統需求與安裝順序
| 檢查項目 | 建議 |
|---|---|
| 架構版本 | 主流手機優先嘗試 arm64。只有架構不明或提示不相容時，才改用通用版。 |
| 客戶端選擇 | 一般情境先使用 v2rayNG；明確需要 v2fly 核心相容路徑時使用 v2flyNG。 |
| 安裝權限 | 透過瀏覽器或檔案管理員開啟安裝包時，系統可能要求確認允許該來源安裝的權限。 |
| 首次連線 | 匯入訂閱後先更新群組並選擇設定，再啟動連線。只新增訂閱網址不會自動選取設定。 |
// LINUX PACKAGES
Linux：v2rayN
Linux 安裝包先依發行版套件管理體系選擇 deb 或 rpm，再依裝置處理器選擇 x64 或 arm64。Debian、Ubuntu 及其衍生發行版通常使用 deb；Fedora、RHEL 系及採用 rpm 套件管理體系的發行版通常使用 rpm。
首選
v2rayN
Linux 桌面圖形客戶端，提供 deb、rpm 及兩種處理器架構安裝包。
arm64 對應安裝包
裝置指令回傳 aarch64 或 arm64 時，選擇以下架構版本。套件格式仍需與發行版相符。
v2rayn_7.24.1_arm64.deb
v2rayN-7.24.1-1.el10.aarch64.rpm
Linux 系統需求與安裝順序
| 檢查項目 | 建議 |
|---|---|
| 套件格式 | 使用 apt、dpkg 體系通常選擇 deb；使用 dnf、yum、rpm 體系通常選擇 rpm。 |
| 處理器架構 | x86_64 或 amd64 選擇 x64；aarch64 或 arm64 選擇 arm64。 |
| 桌面環境 | v2rayN 是圖形客戶端，應在具備可用桌面工作階段的環境中安裝與執行。 |
| 系統代理 | 不同桌面環境的系統代理入口可能不同。啟動客戶端後，還需確認桌面環境是否讀取對應的代理設定。 |
// AFTER DOWNLOAD
下載後的首次設定順序
客戶端安裝完成只是準備階段。真正開始使用前，還要匯入設定、選擇執行項目、決定代理範圍，並檢查連線狀態。
STEP 01
安裝並首次啟動
使用符合系統與架構的安裝包完成安裝。首次啟動後先確認客戶端主介面能正常開啟，不要急著同時修改連接埠、DNS、路由與系統代理。一次處理一個環節，發生問題時更容易定位。
STEP 02
匯入訂閱或設定
在訂閱群組中新增有效網址並執行更新，或匯入單筆 vmess、vless、trojan 等設定。匯入後檢查協定、伺服器位址、連接埠與傳輸設定是否正確識別，再選擇要執行的設定。
STEP 03
啟動並設定代理範圍
啟動核心後，依用途選擇系統代理、應用程式內代理或路由分流。直連、代理與攔截規則會影響最終存取路徑；首次設定可先使用客戶端提供的一般路由模式，確認連線後再新增自訂規則。
// SUBSCRIPTION
匯入訂閱不會自動連線
新增訂閱網址後，還需要執行更新、開啟對應群組並選取一筆設定。訂閱更新失敗時，先確認網址是否完整、裝置時間是否準確，以及目前網路能否存取訂閱來源。不要在同一次排查中連續更換客戶端、連接埠與協定，否則難以判斷真正的故障點。
查看訂閱匯入教學// ROUTING
系統代理與路由規則分開判斷
系統代理決定應用程式是否將請求交給客戶端，本機路由規則決定客戶端收到請求後採用直連、代理或攔截。客戶端顯示已啟動但瀏覽器仍無法連線時，應分別檢查設定是否選取、本機監聽連接埠、系統代理狀態與路由模式，而不是只觀察單一開關。
閱讀協定與核心參考// UPDATE PATH
更新前記錄關鍵設定
跨越較大版本更新時，建議先記錄訂閱群組、本機監聽連接埠、路由模式、DNS 選項與自訂規則。安裝新版後逐項確認這些設定是否仍符合目前用途。若只是排查連線問題，優先查看客戶端記錄與錯誤提示，不要把升級當成唯一處理方式。
查看故障排查問題// PACKAGE NOTES
安裝包選擇的四個判斷點
先選客戶端型號，再看檔案格式
桌面平台對應 v2rayN，Android 一般首選 v2rayNG，明確需要 v2fly 核心時再選擇 v2flyNG。先確定客戶端型號，再在同一張卡片內選擇架構與安裝包格式，可避免下載到名稱相似但用途不同的檔案。
架構名稱可能有不同寫法
x64、x86_64 與 amd64 通常指向同一類桌面處理器架構；arm64 與 aarch64 通常對應同一類 64 位元 ARM 架構。安裝包檔名與系統資訊的寫法不一定完全相同，應依架構含義對應，而不是只尋找完全相同的字串。
通用版用於相容性判斷
Android 通用版包含更廣泛的架構支援，適合無法確認裝置資訊或專用架構套件無法安裝的情況。已確認裝置採用 arm64 時，優先使用 arm64 套件即可。通用版不是功能增強版，兩者主要差異在封裝涵蓋的處理器架構範圍。
安裝成功後繼續確認設定
客戶端能夠開啟，只能表示程式安裝階段基本完成。後續還要檢查訂閱、協定參數、執行設定、系統代理與路由規則。若提示連接埠被占用，應找出占用程序或修改本機監聽連接埠，並同步調整依賴該連接埠的應用程式代理設定。
// DOWNLOAD FAQ
下載與安裝常見問題
以下問題集中處理版本、架構、套件格式與首次啟動。訂閱更新、路由分流與連線錯誤的進一步處理，請前往常見問題頁。
Windows 應該選擇 v2rayN 桌面版還是 WPF 版？
首次安裝可先選擇桌面版，採用新一代跨平台 UI。已熟悉經典 Windows 介面，或現有維護流程依賴 WPF 版選單配置時，可以繼續選擇經典 WPF 版。兩者都是 v2rayN，核心用途基本一致，不需要同時安裝並執行。
macOS 如何判斷應該下載 Apple Silicon 還是 Intel 安裝包？
開啟系統資訊並查看晶片或處理器欄位。顯示 Apple M 系列晶片時選擇 Apple Silicon arm64 安裝包；顯示 Intel 處理器時選擇 Intel x64 安裝包。不要僅依裝置名稱判斷，外觀相近的機型可能採用不同處理器。
Android 應該下載 arm64 還是通用版？
2015 年後的主流 Android 手機通常優先選擇 arm64 版本。它只包含對應架構資源，檔案更精簡。無法確認裝置架構，或 arm64 套件提示不相容時，再下載通用版。兩種安裝包的主要功能一致，差異在支援的處理器架構範圍。
v2rayNG 和 v2flyNG 應該如何選擇？
一般 Android 使用情境優先選擇採用 Xray 核心的 v2rayNG。明確需要 v2fly 核心、既有設定依 v2fly 行為維護，或服務說明指定對應核心時，再選擇 v2flyNG。匯入設定前仍需確認協定與傳輸參數是否相容。
Linux 應該選擇 deb 還是 rpm 安裝包？
Debian、Ubuntu 及其衍生發行版通常選擇 deb；Fedora、RHEL 系及採用 rpm 套件管理體系的發行版選擇 rpm。確定套件格式後，還要檢查系統是 x86_64 還是 arm64。兩項判斷都正確，安裝包才符合目前環境。
安裝完成後為什麼還不能直接連線？
安裝包只提供客戶端程式。首次啟動後還需要匯入有效設定或訂閱、更新訂閱群組、選擇具體設定並啟動核心。若希望瀏覽器或其他應用程式接入，還要依使用方式開啟系統代理，或將應用程式代理位址指向客戶端的本機監聽連接埠。