客戶端／安裝套件選擇
桌面平台選 v2rayN，Android 優先選 v2rayNG。先確認作業系統與處理器，再挑選安裝套件。
同一款 v2rayN，提供兩種桌面介面。以下下載入口適用於 x64 裝置。
Windows 桌面客戶端 · 7.24.1
新一代跨平台 UI · x64 · ZIP
經典穩定版 · x64 · ZIP
Desktop 採用新一代跨平台介面，適合首次安裝或希望在不同系統沿用相近操作習慣的使用者；WPF 保留經典 Windows 介面，適合熟悉傳統選單和視窗配置的使用者。選擇時應考量介面習慣與執行環境，而非根據套件名稱判斷連線速度。兩個版本都需要先匯入設定，再選擇適合目前應用情境的代理方式。
下載的是壓縮檔：請先解壓縮整個資料夾，再執行其中的程式。請勿直接從壓縮軟體的預覽視窗啟動。
| 檢查項目 | 適用條件 | 安裝前操作 |
|---|---|---|
| 處理器架構 | x64 Windows | 前往系統設定的「關於」查看系統類型；請勿只依電腦品牌選擇。 |
| 執行環境 | 依目前套件的啟動提示為準 | 若出現 .NET 執行環境提示，請確認提示中的版本與架構。 |
| 程式資料夾 | 可寫入且能長期保留的本機資料夾 | 請完整解壓縮，避免使用暫存資料夾；並保留程式與附屬檔案原有的相對位置。 |
| 代理權限 | 系統代理與 TUN 的權限需求不同 | 先以一般權限完成設定；需要使用 TUN 時，再依客戶端提示處理權限。 |
安裝前請先建立獨立資料夾，並保留下載套件解壓縮後的檔案結構。若裝置上已安裝 v2rayN，請勿將 Desktop 與 WPF 的檔案放在同一個資料夾。先從舊客戶端備份訂閱群組和手動新增的節點，再從新資料夾啟動；確認設定已成功遷移後，才清理舊資料夾。執行環境缺失、連接埠遭占用和程式檔案遭隔離是不同問題，請依實際錯誤訊息處理，不要反覆更換訂閱。
首次連線建議先使用系統代理：儲存訂閱網址、更新群組、選擇節點，再啟用系統代理並用瀏覽器測試。部分命令列工具不會讀取系統代理，需另外設定代理環境變數。v2rayN TUN 模式適合需要接管更多應用程式流量的情境，但仍會受到路由規則、DNS 設定和系統權限影響；啟用開關不代表所有連線都已經透過代理。
先開啟「關於這台 Mac」查看處理器。Apple M 系列和 Intel 必須選擇不同的安裝套件。
macOS 桌面客戶端 · 7.24.1
Apple M 系列 · arm64 · DMG
Intel 處理器 · x64 · DMG
晶片名稱顯示 Apple M 系列時，請選 Apple Silicon；顯示 Intel 處理器時，請選 Intel。請勿以購買年份代替處理器判斷，同一年也可能有不同架構的裝置。優先下載與裝置架構相符的原生套件；若出現無法開啟應用程式的提示，請先確認系統版本、架構與系統安全性提示，再判斷是否需要其他執行環境。
開啟 DMG 後，依安裝畫面指示將應用程式拖移至「應用程式」資料夾，再從該資料夾啟動並完成初始設定。
| 檢查項目 | 適用條件 | 安裝前操作 |
|---|---|---|
| 處理器 | Apple Silicon 或 Intel | 在「關於這台 Mac」查看晶片或處理器欄位。 |
| 系統版本 | 依目前應用程式套件的相容性需求為準 | 記下 macOS 版本，遇到啟動提示時逐項核對。 |
| 安裝位置 | 「應用程式」資料夾 | 複製完成後再啟動，避免長期直接從磁碟映像檔執行。 |
| 網路設定 | 系統代理或客戶端支援的接管方式 | 留意其他代理工具是否已修改同一網路服務的設定。 |
首次啟動時可能會出現系統安全性提示。請先閱讀提示內容，確認開啟的是剛安裝的應用程式，再到系統設定處理相關授權。請勿為了啟動單一程式而關閉整套系統安全防護。若應用程式能啟動但網頁連線異常，請改為檢查代理模式、節點與 DNS；安裝權限問題通常發生在程式啟動階段，與訂閱中的節點是否連線正常是不同的排除方向。
使用系統代理時，請確認目前使用的網路服務，例如無線網路或有線網路。切換網路後，原有代理設定未必適用於新的服務。關閉客戶端前，請依客戶端提供的方式清除系統代理，避免留下指向已停止本機連接埠的設定。升級應用程式前，請保留訂閱與自訂路由；替換程式後，先確認本機監聽連接埠和代理狀態，再開始日常使用。
v2rayNG 使用 Xray 核心；v2flyNG 則是採用 V2Fly 核心的替代選擇。兩款客戶端須分別安裝，設定也各自管理。
Android · Xray 核心 · 2.2.6
主流 64 位元裝置 · APK
多架構封裝 · APK
2015 年後推出的主流手機通常可先選 arm64，但部分裝置的系統環境仍可能不同，請以實際相容性為準。不確定裝置架構，或安裝時明確提示套件不相容，可改選通用版。兩種套件只是同一客戶端針對不同架構的發佈方式，並非功能有高低之分。v2rayNG 適合使用 Xray 設定與相關協定組合的使用者，實際支援能力仍以安裝的版本為準。
首次連線時需確認系統 VPN 授權。安裝完成後，請先匯入設定，再啟動連線。
Android · V2Fly 核心 · 1.10.31
64 位元裝置 · APK
多架構封裝 · APK
v2flyNG 適合希望使用 V2Fly 核心的 Android 使用者。選用前，請確認訂閱提供的協定與傳輸設定能由目前版本辨識，別假設另一款客戶端支援的所有參數都能直接沿用。兩款應用程式可各自保留設定；測試連線時，請先停止正在執行的 VPN 連線，再啟動另一款客戶端，以免將系統接管衝突誤判為節點問題。
安裝另一款客戶端不會自動同步既有設定；遷移時請重新匯入訂閱，並檢查自訂設定。
| 檢查項目 | 適用條件 | 安裝前操作 |
|---|---|---|
| 裝置架構 | arm64 或通用套件支援的架構 | 優先查核裝置資訊；無法確認時，請使用通用版。 |
| 系統相容性 | 依 APK 安裝需求為準 | 若系統提示版本不相容，請記下 Android 版本和錯誤訊息。 |
| 安裝來源 | 允許目前使用的下載或檔案管理應用程式安裝 | 依系統提示，只授權這次使用的安裝來源。 |
| 連線權限 | 系統 VPN 授權 | 首次啟動連線時確認授權，並檢查是否有其他 VPN 連線正在執行。 |
| 背景執行 | 依裝置的電池管理策略設定 | 若鎖定螢幕後連線中斷，請檢查應用程式背景執行與電池限制。 |
安裝 APK 和連線 VPN 是兩個不同步驟。系統允許某個來源安裝，只代表應用程式可以安裝；啟動連線時仍須另外授予 VPN 權限。升級時若出現應用程式簽章不同的提示，請勿急著解除安裝，因為解除安裝可能會清除本機節點與設定。請先備份設定，再確認原本的安裝來源與新套件是否支援直接覆蓋；必要時依遷移流程重新安裝。
匯入 v2rayNG 訂閱時，請先建立訂閱群組，填入網址並儲存，再更新訂閱。更新成功後，選擇一個節點並啟動連線，再確認瀏覽器能否正常瀏覽。若鎖定螢幕後連線中斷，請先檢查背景執行限制；若只有特定應用程式異常，再檢查分應用代理清單。客戶端的測試結果可協助篩選節點，但不代表所有應用程式的連線體驗都相同。
依發行版的套件管理格式選擇 deb 或 rpm，再確認 x64 或 arm64 處理器架構。
Linux 桌面客戶端 · 7.24.1
Debian 系套件格式 · x64
RPM 系套件格式 · x64
deb 通常用於 Debian、Ubuntu 等採用此套件格式的發行版；rpm 則適用於採用 RPM 套件管理格式的發行版。套件格式相同，不代表每個發行版版本都符合相依性需求，安裝前仍須查看套件管理工具的提示。x64 套件中的 amd64 或 x86_64 是架構標記；arm64 套件中的 arm64 或 aarch64 則代表另一種處理器架構，兩者不能互換。
此處提供圖形桌面客戶端。選擇套件時，請一併考量桌面環境、發行版相依性與處理器架構。
| 檢查項目 | 適用條件 | 安裝前操作 |
|---|---|---|
| 套件格式 | deb 或 rpm | 在發行版的軟體安裝工具中確認支援的套件格式。 |
| 處理器架構 | x64 或 arm64 | 透過系統資訊確認架構，請勿只依套件副檔名判斷。 |
| 桌面環境 | 可執行圖形應用程式的桌面工作階段 | 確認應用程式選單和圖形化安裝工具皆可使用。 |
| 相依套件與權限 | 符合目前套件的相依性需求 | 依套件管理工具的提示解決相依性；代理接管權限須另外設定。 |
建議使用發行版提供的圖形化軟體安裝工具開啟套件，查看相依性與安裝結果。安裝工具發生錯誤時，請先記下相依套件名稱和系統版本，不要反覆開啟同一個套件。若已安裝其他來源的同名應用程式，請先確認目前的設定儲存位置與套件管理狀態，避免混淆程式檔案替換和使用者設定遷移。升級前請保留自訂路由和訂閱，安裝完成後再檢查連線。
Linux 桌面的系統代理、瀏覽器內建代理和終端機環境變數可能各自生效。客戶端顯示已啟動，只表示本機服務正在執行，不代表每個應用程式都會讀取代理設定。請先用明確採用系統代理的應用程式測試，再逐一檢查其他程式。若要接管更多流量，請確認客戶端支援的模式、權限與 DNS 設定，避免同時啟用多套互相衝突的接管規則。
先查看作業系統類型、處理器架構和既有客戶端的安裝位置。安裝套件格式決定安裝方式，處理器架構則決定程式能否執行；兩者都確認無誤後再進行下一步。已在使用客戶端的裝置，請先備份訂閱群組、手動新增的節點、自訂路由和本機連接埠設定。訂閱可以重新更新，不代表所有手動設定都能一併還原。
首次安裝可直接依平台選擇下載入口；若要更換介面版本或客戶端，則應將設定遷移視為獨立步驟。尤其是桌面版使用不同程式資料夾，或在 Android 兩款應用程式之間切換時，請勿假設設定會自動共用。發生錯誤時，保留原始提示和目前的系統資訊，有助於分辨安裝、權限與連線問題。
客戶端是管理設定和啟動連線的工具，安裝套件本身不會提供訂閱。準備好有權使用的訂閱網址後，請在群組設定中填入網址、儲存並更新。訂閱網址可能包含存取憑證，截圖、求助或同步筆記時，請隱藏完整連結。更新後確認協定類型和節點備註，選擇節點，再啟用相應的系統代理或 VPN 模式。
V2Ray 節點速度測試應搭配實際連線測試。測試失敗可能與測試目標、DNS 或網路環境有關，不宜只根據一次結果就刪除整個群組。若要了解 VLESS 協定與其他傳輸方式的搭配，請參閱設定說明；V2Ray 協定選擇最終必須與伺服器提供的參數一致。
V2Ray 客戶端負責管理訂閱、節點清單、路由設定和啟動控制；核心則依設定處理連線。Project V 是了解這個生態系的背景，V2Fly 與 Xray 則屬於相關核心家族，兩者都不是作業系統名稱。下載時先依裝置選擇圖形化客戶端，設定時再確認訂閱所需的協定與傳輸功能，避免把核心名稱誤當成安裝套件架構來選擇。
v2rayN 適用於桌面平台，可在客戶端支援範圍內管理相關核心與設定；v2rayNG 適用於 Android，使用 Xray 核心；v2flyNG 適用於 Android，使用 V2Fly 核心。三款客戶端的設定介面和支援參數不一定完全相同，訂閱能否匯入也須視目前版本而定。若無法辨識某種協定，請先確認訂閱格式與客戶端支援能力，再考慮更換選擇。
原始碼開放代表專案可以供人研究與改進，但實際安裝仍須留意系統相容性和升級遷移。日常使用不必追著每次介面變更更新；只有當功能需求、相容性問題或修正內容與裝置相關時，升級才有明確目的。升級後先確認訂閱群組和路由是否保留，再實際測試連線，避免把升級後的預設設定誤認為原有設定。
首次安裝建議選 Desktop，採用新一代跨平台介面。WPF 則是經典穩定版，適合習慣傳統 Windows 介面的使用者。兩種安裝套件都應先完整解壓縮；遷移前請備份現有設定，也不要將兩個版本的程式檔案混在同一個資料夾。
開啟系統選單中的「關於這台 Mac」。晶片欄位顯示 Apple M 系列時，請選 Apple Silicon；處理器欄位顯示 Intel 時，請選 Intel。安裝套件名稱中的 arm64 對應 Apple Silicon，64 則對應此處的 Intel 下載入口。
2015 年後推出的主流手機通常可先選 arm64，但仍應以裝置的實際架構為準。通用版包含多種架構，適合不確定裝置架構，或 arm64 套件顯示不相容的情況。兩者只是同一客戶端的不同封裝方式，並不代表節點或協定能力有高低之分。
安裝套件只包含客戶端程式，不代表已設定好連線。啟動後，需匯入有權使用的訂閱網址或節點設定，更新訂閱並選擇節點，再設定系統代理或 VPN 接管方式。訂閱網址可能包含存取憑證，請勿公開分享完整連結。
請先備份訂閱群組、手動新增的節點、自訂路由及相關設定，並記下目前使用的代理模式與本機連接埠。關閉舊程式後，再安裝或解壓縮新版。首次啟動時確認群組和路由正常，再更新訂閱；請勿同時執行兩個使用相同本機連接埠的客戶端。
先確認作業系統與處理器架構，再檢查壓縮檔是否已完整解壓縮。Windows 請依啟動提示檢查所需執行環境；macOS 查看系統安全性提示；Android 檢查安裝來源授權及簽章衝突；Linux 查看套件相依性提示。保留完整錯誤訊息，再依平台逐項排除。