用戶端安裝套件 · 依平台選擇
桌面平台選 v2rayN，Android 優先選 v2rayNG。先確認作業系統與處理器架構，再下載對應的安裝套件；訂閱網址和伺服器設定需另外準備。
同一款用戶端，提供兩種介面。以下版本皆適用於 x64 環境。
Desktop 採用新一代跨平台 UI；WPF 則是 Windows 專用的經典穩定版。首次安裝可先選 Desktop；若已習慣 WPF，也可繼續使用。
跨平台介面 · x64 · ZIP 壓縮套件
下載 v2rayN Desktop採用 Avalonia 介面，適合建立新的桌面設定。請先解壓縮至獨立目錄，再執行套件中的安裝程式，避免直接在壓縮檔瀏覽視窗中啟動。
Windows 專用介面 · x64 · ZIP 壓縮套件
下載 v2rayN WPF保留經典的 Windows 操作方式。已有設定的使用者請先備份，再依安裝程式提示升級；勿將兩種介面的程式檔案覆蓋至同一目錄。
| 檢查項目 | 選擇依據 |
|---|---|
| 系統架構 | 本頁提供的兩個版本皆為 x64。可在「設定 → 系統 → 關於」中查看系統類型。 |
| 系統與執行環境 | 請以安裝程式對目前 Windows 版本和執行元件的提示為準；若缺少相依元件，請先補齊對應環境。 |
| 權限 | 依系統提示授權安裝。TUN 可能需要系統管理員權限；一般系統代理設定不等於啟用 TUN。 |
| 檔案處理 | 下載後會取得 ZIP 壓縮套件，請先解壓縮再執行套件中的安裝程式；設定目錄須具備寫入權限。 |
安裝後先開啟主視窗，確認能進入「訂閱群組設定」。若系統提示缺少執行元件，請依提示處理相依元件；這與訂閱失效、伺服器逾時是不同階段的問題。能開啟介面，不代表伺服器設定已可使用，也不表示系統中的所有程式都會自動使用代理。
Desktop 與 WPF 的主要差異在介面和操作習慣，不代表其中一種介面天生有較好的連線品質。連線結果也取決於設定、核心支援、路由和實際網路環境。更換版本時請保留訂閱來源與自訂規則，先在新環境確認匯入結果，再決定是否移除舊版。詳細操作請參閱使用指南。
透過「關於這台 Mac」確認晶片，優先選擇符合本機架構的套件。
macOS 使用跨平台桌面介面。Apple Silicon 與 Intel 套件分別對應不同處理器，功能選擇不依晶片名稱區分；下載前只要確認本機架構即可。
Apple M 系列 · arm64 · DMG
下載 v2rayN · Apple Silicon若「關於這台 Mac」的晶片欄顯示 Apple M 系列，請選擇此套件。使用原生架構可避免不必要的轉譯，不必為了相容性習慣而優先選 Intel 套件。
Intel 處理器 · x64 · DMG
下載 v2rayN · Intel若「關於這台 Mac」的處理器欄顯示 Intel，請選擇此套件。arm64 套件不是 Intel 裝置的替代安裝方案；架構不符時請返回此處重新選擇。
| 檢查項目 | 選擇依據 |
|---|---|
| Apple Silicon | Apple M 系列晶片請選 arm64 DMG。 |
| Intel | Intel 處理器請選 x64 DMG。 |
| 系統相容性 | 安裝與啟動時請確認目前版本對 macOS 的需求；較舊的系統可能需要先升級。 |
| 授權與目錄 | 依 DMG 中的指引安裝至「應用程式」資料夾；系統代理、網路延伸功能等操作，請依實際出現的系統授權提示辦理。 |
開啟 DMG 後依照其中的指引完成安裝，再從「應用程式」資料夾啟動。首次開啟若出現安全性提示，請先確認下載來源與系統提示內容，再使用系統提供的正常授權流程處理。勿將關閉整體系統安全性機制當成一般安裝步驟；「架構不符」和「系統阻止開啟」也應分開判斷。
匯入訂閱後，先使用系統代理測試支援讀取系統代理設定的應用程式。部分終端程式、獨立網路工具或自行管理連線的應用程式，可能不會採用相同設定。若需要接管更大範圍的流量，再閱讀 TUN 相關說明，並確認權限、DNS 和路由。退出用戶端前也請留意系統代理是否已還原，避免留下指向已關閉本機連接埠的設定。
優先選擇 v2rayNG；需要使用 V2Fly 核心設定時，再考慮 v2flyNG。
採用 Xray 核心的 Android 圖形用戶端。2015 年後的主流手機通常可先選 arm64，最終仍以裝置實際支援的應用程式架構為準；無法確認時可選通用版。
arm64-v8a · APK
下載 v2rayNG · arm64適用於支援 64 位元 ARM 應用程式的裝置。新款手機通常採用此架構，但處理器支援 64 位元，不一定代表系統允許安裝對應的應用程式。
適用於使用 V2Fly 核心情境的 Android 用戶端。請依設定所需的協定與傳輸功能選擇，不應只看用戶端名稱判斷相容性；Xray 專屬功能不能假設可在此使用。
arm64-v8a · APK
下載 v2flyNG · arm64適用於已確認支援 arm64 應用程式的裝置。安裝後請重新檢查匯入結果，特別留意協定、傳輸方式與路由規則中的核心相關欄位。
| 檢查項目 | 選擇依據 |
|---|---|
| 應用程式架構 | 支援 arm64-v8a 時優先選 arm64；不確定時請選通用版。 |
| Android 版本 | 請以 APK 安裝程式對目前系統的相容性判斷為準，不能只憑手機出廠年份決定。 |
| 安裝權限 | 依系統提示，只授予此次使用的瀏覽器或檔案管理員安裝應用程式的權限。 |
| 網路權限 | 首次啟動連線時，請確認 Android VPN 授權；其他正在執行的 VPN 類應用程式可能會占用相同入口。 |
開啟 APK 時若提示無法安裝，請先判斷是系統版本不符、架構不符，還是已安裝應用程式的簽章不同等原因。若已有同名用戶端但無法覆蓋安裝，請勿立即解除安裝；解除安裝可能同時移除本機訂閱與自訂設定，應先在舊應用程式中備份。卡片上的版本資訊與套件名稱分別取自發佈清單欄位，不能只靠檔名判斷能否覆蓋現有應用程式。
安裝成功後，匯入有權使用的訂閱、選擇伺服器，再啟動連線並處理系統授權。若應用程式切換至背景後容易中斷，可檢查電池最佳化和背景執行限制；這些限制由系統及裝置廠商控制。v2rayNG 與 v2flyNG 使用不同核心，切換用戶端時應重新確認設定支援情況；詳細差異請參閱用戶端比較。
先選擇符合發行版的套件格式，再確認 x64 或 arm64 架構。
Linux 使用跨平台桌面介面，需要可用的圖形桌面環境。deb 與 rpm 是不同的套件格式，不是兩種連線模式；下方主要下載選項皆為 x64 架構。
Debian 系發行版 · amd64
下載 v2rayN · x64 deb適用於採用 deb 套件管理系統且符合相依條件的環境。可用發行版的軟體安裝程式開啟；若出現相依套件提示，請交由系統套件管理員處理。
RPM 系發行版 · x86_64
下載 v2rayN · x64 rpm適用於符合此套件建置目標與相依條件的 RPM 環境。檔名含有 el10，不能因此認定所有採用 RPM 的發行版都能直接安裝。
| 檢查項目 | 選擇依據 |
|---|---|
| 處理器架構 | x86_64 對應 x64，aarch64 對應 arm64；amd64 是 deb 套件常見的 x64 標示。 |
| 套件管理系統 | Debian 系環境選 deb；RPM 系環境選 rpm，並進一步確認建置目標與相依套件相容性。 |
| 圖形環境 | 適用於圖形桌面工作階段，不適用於僅有命令列的伺服器；系統匣的顯示方式則受桌面環境影響。 |
| 權限與相依套件 | 由系統安裝程式處理軟體相依套件與安裝授權；TUN 所需權限請依用戶端與發行版的實際提示設定。 |
套件管理員回報缺少共享函式庫、發行版版本不符或架構錯誤時，應先解決相容性問題，不要將其他格式的套件強行轉換後當成通用方案。圖形介面能否啟動、系統匣是否顯示，以及程式是否隨桌面工作階段啟動，屬於不同層面的檢查項目；不能只憑安裝完成提示就判定所有功能都已就緒。
Linux 桌面的系統代理設定不一定會被每個應用程式採用。瀏覽器通常有自己的代理策略，終端工具也可能讀取環境變數或使用獨立設定。建議先用明確支援系統代理的應用程式測試，再依實際需求處理其他程式。若改用 TUN，請一併檢查 DNS、路由和權限，避免疊加多種流量接管方式後才盲目排查。
安裝套件只提供用戶端程式；訂閱、流量入口和路由規則仍須分別設定。
開啟用戶端後，使用訂閱群組保存訂閱網址，填入方便辨識的別名，再執行更新。訂閱網址可能包含存取憑證，請勿貼到公開討論區、記錄截圖或共用文件中。若有多個來源，請建立獨立群組，方便分別更新和查找錯誤。
清單中出現伺服器後，選擇實際要使用的項目。匯入成功只表示用戶端已讀取設定，不代表伺服器一定連得上。若更新失敗，請檢查網址是否過期、裝置時間是否正確，以及目前網路能否連上訂閱來源，而非反覆重裝程式。
查看訂閱匯入與首次連線步驟 →系統代理決定支援此設定的應用程式如何連入用戶端；路由規則則決定流量進入用戶端後如何選擇出口，兩者用途不同。啟用系統代理自動設定，不會自動讓所有程式都使用代理，也不會取代既有的路由預設。
初次設定可先採用容易理解的設定，確認一個應用程式能正常連線後，再調整分流或啟用 TUN。每次只修改一個環節，並保留原有設定。發生問題時，記下觸發步驟和相關記錄，比同時更換用戶端、訂閱和規則更容易找出原因。
查看入站、出站與路由設定參考 →請先區分套件選擇、安裝相容性與連線設定問題。連線故障可接著參閱疑難排解。
首次安裝可先選 Desktop，採用新一代跨平台介面。WPF 則是 Windows 專用的經典穩定版，適合想延續既有操作習慣的使用者。兩者皆提供 x64 版本；升級或更換版本前請先備份設定，勿混用程式目錄。
在蘋果選單中開啟「關於這台 Mac」。晶片欄顯示 Apple M 系列時，請選 Apple Silicon，也就是 arm64 套件；處理器欄顯示 Intel 時，請選 Intel，也就是 x64 套件。建議優先安裝符合這台 Mac 架構的套件。
2015 年後的主流手機通常可先選 arm64，但仍應以裝置實際支援的應用程式架構為準。無法確認架構，或安裝 arm64 時出現不相容提示，可改選通用版。通用版涵蓋較多架構，檔案通常也較大。
用戶端安裝套件不含可用伺服器或訂閱。請自行準備有權使用的訂閱網址或伺服器設定，再透過訂閱群組或匯入功能新增。匯入成功後，還須選擇伺服器、設定流量入口並確認路由規則。
先退出用戶端，並使用目前版本提供的備份或匯出功能保存設定；若要透過程式目錄搬移設定，請先確認目前版本實際使用的設定目錄。安裝後檢查訂閱群組、路由、自訂 DNS 和本機連接埠，確認正常後再清除舊檔案。
先檢查訂閱更新、所選伺服器、系統時間和記錄，再確認應用程式是否讀取系統代理。系統代理和 TUN 是不同的流量入口；若程式能正常啟動但無法連線，反覆下載相同安裝套件通常無法解決設定或網路問題。