桌面平台選 v2rayN，Android 優先選 v2rayNG。先選作業系統，再確認處理器架構。
安裝包僅包含客戶端。使用前請準備有效的訂閱網址或分享連結；初次設定可參閱使用說明。
兩個安裝入口皆適用於 x64 系統。選擇熟悉的介面即可，不必同時安裝兩個版本。
桌面版採用新一代跨平台 UI；經典 WPF 版則保留 Windows 傳統介面。兩個版本都能以圖形介面管理設定，初次使用可從桌面版開始。
新一代跨平台介面，適合初次安裝，或希望在不同桌面平台維持相近操作習慣的使用者。
經典穩定版介面，適合熟悉原有選單與視窗配置、希望延續既有操作方式的使用者。
| 檢查項目 | 需求與處理方式 |
|---|---|
| 系統架構 | 本頁提供 x64 套件。請在「設定 → 系統 → 系統資訊」確認系統類型；32 位元系統無法使用這兩個下載入口。 |
| 系統版本 | 建議使用仍提供安全性更新的 Windows 版本；最低需求請以目前套件的安裝提示為準。 |
| 執行環境 | 若啟動時提示缺少 .NET 桌面執行階段，請依提示確認所需版本與 x64 架構；不要隨意複製 DLL 來處理。 |
| 儲存空間與權限 | 下載後請完整解壓縮 ZIP，再執行套件中的安裝程式或啟動檔。設定目錄必須可寫入；安裝目錄則依安裝精靈的指示確認。 |
請勿直接從壓縮檔預覽視窗啟動程式。先將整個壓縮檔解壓縮至獨立資料夾，再開啟其中的安裝入口。安裝或初次啟動時若出現系統安全性提示，先確認下載檔案與所選入口是否相符，再依系統說明處理；不要為了啟動客戶端而長期關閉系統防護。
從 WPF 版遷移至桌面版前，先在舊客戶端備份設定，並記下訂閱群組、路由模式與本機監聽連接埠。關閉舊版後再開啟新版，確認匯入結果。同時執行兩個版本可能造成連接埠衝突，也可能互相覆寫系統代理設定；介面能開啟，不代表代理接管已正確完成。
安裝完成後，在「訂閱群組設定」儲存訂閱網址，再從訂閱選單執行更新。選取要使用的設定後，選擇路由模式，最後透過系統匣選單點選「自動設定系統代理」。系統代理只會影響遵循此設定的應用程式；部分程式仍須另外指定代理位址，詳情請參閱匯入訂閱與初次連線步驟。
先開啟「關於這台 Mac」，依晶片資訊選擇 DMG，不要按裝置購買年份判斷。
桌面圖形化客戶端，提供訂閱群組、路由規則及系統代理管理功能。兩個套件的差異在於處理器架構；設定前請先完成應用程式安裝。
若「關於這台 Mac」的晶片欄顯示 Apple M 系列，請選擇此套件，優先使用與硬體相符的原生架構。
若「關於這台 Mac」的處理器欄顯示 Intel，請選擇此套件。macOS 版本名稱無法用來判斷處理器類型。
| 檢查項目 | 需求與處理方式 |
|---|---|
| 處理器 | Apple Silicon 對應 arm64；Intel 對應 x64。建議優先選擇原生架構套件。 |
| 系統版本 | 請使用仍提供安全性更新的 macOS。最低版本需求依目前應用程式套件的相容性要求而定。 |
| 應用程式位置 | 開啟 DMG，將應用程式複製到「應用程式」資料夾，再從該資料夾啟動；不要長期從已掛載的映像檔執行。 |
| 權限設定 | 修改系統代理或啟用相關網路功能時，請依實際顯示的對話框授權。一般系統代理與 TUN 所需權限不同。 |
完成複製應用程式後，可退出 DMG 掛載磁碟區。若出現「無法驗證開發者」提示，確認應用程式來源後，開啟「系統設定 → 隱私權與安全性」，查看是否有針對本次啟動的允許選項。不同 macOS 版本的按鈕位置可能不同，請依目前系統提示操作，不必全面關閉安全性檢查。
初次設定時，先匯入訂閱並選擇設定，再啟用系統代理。若取消權限提示，介面可能仍正常顯示，但系統代理並未成功設定。請返回客戶端重新執行相關操作，並查看目前網路服務的代理設定；不要只憑選單的勾選狀態判斷連線是否成功。
升級前先關閉應用程式，避免新舊版本同時執行。更新後確認訂閱群組、路由模式與本機連接埠是否保留，再用瀏覽器測試。若瀏覽器與其他應用程式的結果不同，先確認該應用程式是否遵循系統代理；不要馬上更換協定或反覆匯入相同訂閱。
優先選擇 v2rayNG；有明確的 V2Fly 設定需求時，再考慮 v2flyNG。
Android 圖形化客戶端，可匯入訂閱與分享連結，透過系統 VPN 授權接管流量，並依需求設定路由及應用程式代理。
2015 年後推出的主流手機通常適用此套件。仍須確認系統支援 64 位元應用程式，不能只看處理器的宣傳規格。
無法確認架構，或 arm64 套件提示不相容時，請選擇此版本。支援更多架構，檔案通常也較大。
適合需要 V2Fly 核心行為的 Android 設定。不要只因訂閱能匯入，就認定所有協定參數都能使用；尤其要確認伺服器採用的擴充功能是否相容。
適用於支援 64 位元應用程式的 ARM 裝置。安裝前請先確認所用設定與 v2fly 核心相容。
架構不明確時可選擇此備用套件。通用版不會改變核心類型，也不會補上另一種核心專屬功能。
| 檢查項目 | 需求與處理方式 |
|---|---|
| 系統相容性 | 系統版本須符合所選 APK 的最低需求。若安裝程式提示系統版本過舊，改用通用版也無法解決版本限制。 |
| 應用程式架構 | 支援 64 位元應用程式的 ARM 裝置，建議優先選擇 arm64；不確定時可使用通用版，並留意安裝程式的提示。 |
| 安裝權限 | 只需為這次使用的瀏覽器或檔案管理員開啟「安裝未知應用程式」權限；安裝完成後可視需要關閉。 |
| 連線權限 | 初次連線時須確認系統 VPN 要求。通常同一個使用者空間只能維持一個啟用中的 VPN，其他 VPN 請先中斷連線。 |
| 背景執行 | 若需持續連線，請在系統電池管理中允許客戶端於背景執行；不同裝置廠商的選單名稱可能不同。 |
下載 APK 後，透過系統安裝程式完成安裝。若出現「應用程式未安裝」，請先查看具體原因：架構不符、系統版本不足、儲存空間不足與簽章不一致是不同問題。升級安裝失敗時，不要立刻解除安裝舊版；解除安裝可能一併刪除本機設定，請先備份再處理。
開啟客戶端後，新增訂閱群組並輸入網址，再執行更新訂閱。選取設定並點選連線後，系統會要求建立 VPN 連線；確認後才會開始接管流量。VPN 圖示表示本機通道已建立，不代表遠端服務一定正常。若仍無法連線，請先檢查設定與記錄，再確認路由及 DNS。
應用程式代理會決定哪些應用程式透過代理通道連線。啟用篩選後，請分清「僅代理選取的應用程式」與「略過選取的應用程式」兩種方向；若瀏覽器未納入範圍，可能會發生客戶端已連線、瀏覽器卻未使用代理的情況。修改篩選後，請依客戶端提示重新建立連線，讓新範圍生效。核心選擇與協定相容性的差異，請參閱協定參考。
依發行版選擇 deb 或 rpm，再確認 x64 與 ARM 64 位元架構。
適用於具備圖形桌面環境的 Linux 系統。deb 與 rpm 是不同的套件格式，不代表不同的路由模式；能否安裝仍取決於發行版提供的相依套件。
建議 Debian、Ubuntu 系發行版優先檢查。套件名稱中的 amd64 對應常見的 x86_64 處理器架構。
供採用 RPM 套件管理的發行版檢查。目前檔案帶有 el10 建置標記，安裝前請特別確認發行版與相依套件是否相容。
| 檢查項目 | 需求與處理方式 |
|---|---|
| 桌面環境 | 需要可執行圖形應用程式的桌面工作階段。本頁安裝包供桌面客戶端使用，不是伺服器部署入口。 |
| 套件管理系統 | 依發行版選擇 deb 或 rpm；系統套件安裝程式必須能解析該套件格式及其相依套件。 |
| 處理器架構 | x64、x86_64 與 amd64 指的是常見的同一類桌面架構；ARM 64 位元套件則標示為 arm64 或 aarch64。 |
| 相依套件與權限 | 確認圖形執行環境、系統函式庫及安裝權限符合需求。請勿忽略相依套件錯誤並強行安裝。 |
在檔案管理員中開啟安裝包，使用發行版的軟體安裝程式查看套件資訊、架構與相依套件。若提示無法辨識套件格式，先確認是否選錯 deb 或 rpm；若相依套件無法滿足，請檢查發行版版本與軟體來源狀態。尤其是帶有特定發行版建置標記的 RPM，不要因副檔名相同就認定適用於所有 RPM 系統。
安裝後從應用程式選單啟動 v2rayN，再匯入訂閱。Linux 桌面環境讀取系統代理的方式不盡相同：部分應用程式會遵循桌面網路設定，其他應用程式則須在自身設定中指定代理。測試時，先選擇明確支援代理設定的應用程式，確認本機監聽位址與連接埠，再判斷是否需要其他接管方式。
需要使用 TUN 功能時，請先完成一般設定的測試，再確認客戶端所需權限與網路環境。不要讓整個日常桌面工作階段長期以高權限執行。更新套件前先關閉舊程序，保留個人設定目錄；更新後若啟動異常，優先判斷是圖形相依套件還是設定問題，避免混為一談而反覆修改訂閱。
先確認設定有效，再接管應用程式流量。每次只調整一個環節，方便找出問題。
訂閱網址用於批次更新設定；分享連結通常用於匯入單筆設定。兩者都可能含有存取憑證，請勿公開貼在留言區或截圖中。先確認來源與有效期限，再選擇客戶端支援的匯入方式。
儲存訂閱網址後，還須執行更新訂閱。清單出現設定後，選取要使用的項目，並確認協定類型、傳輸方式及安全性層參數。匯入失敗時，先檢查格式相容性，不要任意切換協定來修復。
桌面端請設定系統代理；Android 請確認 VPN 授權，再檢查路由模式與應用程式範圍。測試完成後記下可用設定。停止使用時，請透過客戶端清除系統代理或中斷連線，避免留下失效的本機代理位址。
先確認系統、架構與安裝方式，再處理連線設定。
初次使用可先選桌面版 Desktop，採用新一代跨平台介面。經典 WPF 版則保留 Windows 傳統介面，適合熟悉原有操作方式的使用者。請勿同時執行兩個版本；遷移前先備份設定，再確認訂閱、路由與本機連接埠。
2015 年後推出的主流手機通常可優先選擇 arm64，但仍須確認系統支援 64 位元應用程式。若不確定裝置架構，或 arm64 套件顯示與裝置不相容，可改選通用版。通用版支援更多架構，不代表連線速度更快。
開啟蘋果選單中的「關於這台 Mac」。晶片欄顯示 Apple M 系列時選擇 Apple Silicon；處理器欄顯示 Intel 時選擇 Intel。請依裝置實際使用的處理器下載，不要依 macOS 版本名稱判斷。
安裝包不含可用的服務設定。請先準備有效的訂閱網址或分享連結，匯入並選擇設定後，再依平台啟用系統代理或授權 VPN 連線。成功匯入訂閱不代表一定能連上伺服器。
先使用目前客戶端提供的備份或匯出功能，保留訂閱群組、手動設定、路由規則及必要的 DNS 設定，並記下本機監聽連接埠。關閉舊版後再更新。備份可能含有驗證資訊，請存放在自己能妥善控管的位置。
先依發行版使用的套件管理系統選擇：Debian、Ubuntu 系統通常使用 deb；採用 RPM 套件管理的發行版則使用 rpm。接著確認處理器架構：x86_64 對應 amd64，ARM 64 位元對應 arm64 或 aarch64。套件格式相符不代表相依套件一定齊全，仍須留意套件管理器的提示。