客戶端安裝包
桌面端選擇 v2rayN，Android 優先選擇 v2rayNG。先確認作業系統，再核對處理器架構；安裝包格式與設定中的協定類型是兩回事。
01選擇系統
02確認架構
03安裝並匯入設定
採用新一代跨平台 UI，適合初次安裝，也適合希望在不同桌面系統間維持相近操作習慣的使用者。下載 ZIP 後請先完整解壓縮，再執行其中的安裝程式，請勿直接從壓縮檔預覽視窗啟動。
穩定的經典版本，沿用 Windows WPF 介面，適合熟悉原有選單與操作流程的使用者。與 Desktop 版的差異主要在介面實作與互動配置，並非使用不同的代理協定；無須只為了支援某種節點類型而更換介面。
| 檢查項目 | 選擇依據 | 操作提示 |
|---|---|---|
| 系統架構 | 目前提供 x64 安裝包 | 前往「設定」→「系統」→「系統資訊」查看系統類型。 |
| 系統與執行環境 | 須符合所選版本的系統與執行階段需求 | 若安裝程式提示缺少執行元件，請依提示安裝；舊版系統請先確認相容性。 |
| 安裝目錄 | 選擇目前帳戶可正常存取的位置 | 解壓縮時請保留資料夾結構，勿只移動單一執行檔。 |
| 設定匯入方式 | 匯入訂閱群組或分享連結 | 匯入後選取伺服器，再檢查系統代理與路由設定。 |
首次啟動後，請先查看設定中的本機監聽連接埠，再決定是否啟用系統代理。瀏覽器通常會讀取系統代理，但有些應用程式使用自己的網路設定，需要另外指定代理入口。請勿以「程式已啟動」判斷「所有應用程式都已連線」。
更新現有安裝時，請先從系統匣選單結束舊程序。關閉主視窗有時只會將客戶端縮至系統匣，舊程序仍可能占用連接埠。若新程式提示無法監聽，請先確認是否有重複執行，再調整連接埠；無須同時變更訂閱與路由。
適用於搭載 Apple M 系列晶片的 Mac，安裝包採用 arm64 架構。請在蘋果選單 →「關於這台 Mac」查看「晶片」欄位；若顯示 M 系列，建議優先選擇相應的原生架構，無須為了與其他電腦一致而選用 Intel 版。
適用於搭載 Intel 處理器的 Mac，安裝包採用 x64 架構。裝置外觀與購買年份只能作為參考，請以「關於這台 Mac」中的處理器資訊為準。確認架構正確後，也請確認系統版本符合目前應用程式的需求。
| 檢查項目 | 選擇依據 | 操作提示 |
|---|---|---|
| 晶片 | Apple M 系列選 arm64；Intel 選 x64 | 前往蘋果選單 →「關於這台 Mac」，查看晶片或處理器資訊。 |
| 系統版本 | 符合目前版本所列的最低需求 | 晶片相符不代表舊版系統一定能執行目前版本。 |
| 安裝格式 | DMG 磁碟映像 | 依提示複製應用程式，避免長期從已掛載的映像執行。 |
| 網路設定 | 依使用方式授予必要的網路變更權限 | 首次設定系統代理後，可在系統網路設定中確認是否生效。 |
若系統阻止首次開啟，請先確認下載來源與應用程式名稱，再查看「系統設定」→「隱私權與安全性」中的具體提示。請勿為了執行單一客戶端而全面關閉系統安全機制，也不要直接套用來源不明的終端機指令。系統版本過舊、架構不符與開啟權限是不同問題，應分別處理。
安裝後先匯入訂閱並選取伺服器，再啟用所需的代理模式。切換網路或結束客戶端後，若瀏覽器無法連線，請檢查系統網路設定是否仍指向本機連接埠。只需清除已失效的代理設定，無須先刪除所有客戶端設定。
2015 年後推出的主流手機通常可優先選用，前提是系統支援 arm64-v8a 應用程式。採用 Xray 核心，適合需要相應協定功能的設定。能否匯入並連線，仍取決於客戶端版本與伺服器參數是否相符。
包含多種架構，適合不確定裝置架構或需要其他支援架構的情況。通用版不代表系統需求較低，也無法解決所有安裝錯誤；系統版本、剩餘空間與既有應用程式簽章仍需分別檢查。
適用於支援 arm64 應用程式的裝置，可作為既有 V2Fly 設定與操作習慣的替代選擇。v2fly 與 Xray 的功能並不完全相同，不能只因分享連結外觀相似，就認定所有安全層與傳輸參數都能直接沿用。
適用於架構不明或其他受支援的裝置環境。選擇客戶端時，請先確認設定所需的核心功能，再選擇安裝包架構。需要 Xray 專屬功能的設定，應使用相符的客戶端，不要反覆更換同一應用程式的安裝包。
| 檢查項目 | 選擇依據 | 操作提示 |
|---|---|---|
| 應用程式架構 | arm64 或通用版 APK | 請以系統支援的 ABI 為準，不要只看處理器型號。 |
| 系統相容性 | 符合目前 APK 的最低系統需求 | 若解析失敗，請檢查系統版本、下載狀態與儲存空間。 |
| 安裝權限 | 依系統提示允許安裝來自目前來源的應用程式 | 只為實際使用的瀏覽器或檔案管理員授予所需權限。 |
| 連線權限 | 首次連線時須確認 VPN 連線要求 | 同一時間執行的其他 VPN 應用程式可能造成連線衝突。 |
安裝完成後，先匯入分享連結或訂閱網址，更新並選取一項設定，再點選連線。系統跳出的 VPN 授權是用來建立本機流量入口，不代表遠端伺服器已通過驗證。顯示連線圖示後，仍應實際瀏覽網頁，確認路由、DNS 與出站設定是否正常。
若應用程式常在鎖定螢幕後中斷，可查看系統的電池最佳化與背景執行設定，依實際需要允許背景活動。不要一開始就開放所有權限；先確認問題是否與背景限制有關，再逐項調整。改用其他客戶端前，請保存訂閱網址與必要的自訂設定。
適用於原生套件格式為 deb 且符合相依需求的發行版，例如相容的 Debian、Ubuntu 環境。檔名中的 amd64 指常見的 x64 架構，同樣適用於相符的 Intel 64 位元電腦，並非只供 AMD 處理器使用。
適用於採用 RPM 套件管理且符合此套件相依需求的發行版。目前檔名包含 el10 建置標記，安裝前請確認目標發行版與執行階段需求；不能只因副檔名相同，就認定適用於所有 RPM 系統。
| 檢查項目 | 選擇依據 | 操作提示 |
|---|---|---|
| 套件格式 | 發行版原生支援的 deb 或 rpm | 優先使用系統的軟體安裝程式處理相依套件。 |
| 處理器架構 | x64 對應 amd64 / x86_64；arm64 對應 aarch64 | 請在系統資訊中確認架構，勿混裝不同架構的套件。 |
| 桌面環境 | 可執行圖形應用程式的桌面工作階段 | 系統匣與系統代理整合效果可能因桌面環境而異。 |
| 發行版相依套件 | 符合安裝包需求的執行階段版本 | 若發生相依性錯誤，請先查看缺少的項目，不要強制略過相依性檢查進行安裝。 |
在檔案管理員中開啟安裝包，交由發行版的軟體安裝程式完成安裝。若安裝程式指出相依套件無法滿足，請先確認目前發行版版本是否符合此套件的建置目標。更換套件格式通常無法解決基礎執行階段版本過舊的問題，也不建議為單一客戶端混用其他發行版的軟體來源。
安裝後的系統代理設定能否被應用程式讀取，取決於桌面環境與應用程式本身的實作。可先在瀏覽器中測試，再確認不使用系統代理的程式是否需要個別設定。結束客戶端前，請清除不再使用的代理設定，避免本機監聽停止後，應用程式仍向舊連接埠傳送請求。
安裝後設定
先確認作業系統與架構，下載完成後依系統安裝流程開啟。桌面端應先結束舊客戶端；Android 更新時則要留意既有應用程式的簽章與來源。全新安裝與覆蓋更新的提示可能不同，遇到錯誤時請先記錄完整訊息，不要立即刪除設定。
在客戶端的訂閱群組管理中填入自行取得且有權使用的網址，儲存後執行更新。群組名稱僅用於區分來源，網址才是實際請求的目標。訂閱可能包含存取憑證，截圖或尋求協助時請遮蔽完整連結，勿公開貼出。
選取有效伺服器，再設定桌面系統代理或確認 Android 連線授權。請實際瀏覽網頁驗證結果，必要時依序檢查本機連接埠、路由、DNS 與系統時間。延遲測試只供單項參考，不能取代完整的應用程式連線測試。
v2rayN 適用於 Windows、macOS 與 Linux 桌面環境，提供訂閱、伺服器選擇與路由等圖形介面設定。v2rayNG 與 v2flyNG 適用於 Android，兩者的介面操作有相似之處，但核心功能不可混為一談。選擇時先確認裝置系統，再確認既有設定所需功能，最後核對架構與安裝格式。
桌面端從一種介面遷移至另一種介面時，不建議直接覆寫不熟悉的資料目錄。請先使用客戶端提供的匯出功能保存設定，記下自訂路由與本機連接埠，再於新安裝中逐項還原。可重新取得的訂閱設定與手動新增的項目，也應分別保存。
Project V 生態中的 V2Fly 與 Xray 有共同的技術背景，也各自發展出不同功能。VMess、VLESS 等名稱只是設定的一部分，傳輸方式、安全層與擴充參數同樣會影響相容性。分享連結能夠辨識，不代表目前使用的核心必然支援其中所有欄位。
若設定匯入成功但連線失敗，請先比對伺服器端要求與客戶端記錄，而不是接連更換所有安裝包。想了解 REALITY、傳輸方式與核心差異，可閱讀協定手冊；不熟悉入站、出站與路由等名詞，可先查閱術語表。
常見安裝問題
初次安裝可先選 Desktop 桌面版，採用新一代跨平台介面；若已熟悉經典介面或想延續原有操作習慣，可選擇穩定的 WPF 經典版。兩個版本都是 v2rayN，目前提供的安裝包皆為 x64。切換前請先匯出設定並保存訂閱資訊，也不要讓兩個客戶端同時控制系統代理。
開啟蘋果選單中的「關於這台 Mac」。若晶片欄顯示 Apple M 系列，請選擇 Apple Silicon 安裝包；若處理器欄顯示 Intel，請選擇 Intel 安裝包。晶片架構與系統版本是兩項獨立條件，安裝前也請確認目前系統符合該版本的需求。
arm64 版適用於支援 64 位元 ARM 應用程式的裝置，2015 年後推出的主流手機通常可優先選用；通用版包含多種架構，適合不確定裝置架構或需要其他架構的情況。手機處理器支援 64 位元，不代表系統一定提供相應的應用程式環境。若出現架構不相容提示，請先確認系統支援的 ABI。
客戶端是設定與連線工具，安裝包不會附帶可用的伺服器或訂閱。請匯入自行取得且有權使用的設定，更新訂閱並選取有效項目，再檢查桌面系統代理或 Android VPN 連線授權。客戶端成功啟動只代表程式正在執行，不表示出站設定已可使用。
通常不必為了更新而主動刪除設定，但不同版本、安裝位置與簽章之間的遷移方式可能有所差異。更新前請先匯出設定，記下訂閱群組、路由與本機連接埠，再完全結束客戶端。若 Android 提示簽章不一致，請勿直接解除安裝；先確認安裝來源與備份是否完整，再決定遷移方式。
Debian、Ubuntu 等原生套件格式為 deb 的發行版，請選擇 deb；原生套件格式為 RPM 的發行版，請選擇 rpm，並確認發行版版本與相依套件。x64 適用於常見的 Intel 或 AMD 64 位元電腦，arm64 適用於相應的 ARM 64 位元環境。套件格式相同，不代表所有發行版版本都相容。