桌面端選 v2rayN，Android 端首選 v2rayNG。先確認作業系統與處理器，再下載相符的安裝檔。
Windows x64 · Desktop 桌面版 / 經典 WPF 版
桌面版採用新一代跨平台介面，適合希望在不同桌面系統上維持相近操作習慣的使用者。伺服器、訂閱群組、路由與核心設定仍須分別確認；介面相似不代表系統代理機制完全相同。
WPF 版沿用經典 Windows 介面，適合熟悉傳統選單配置的使用者。兩個版本並非速度等級之分；實際連線表現主要取決於伺服器、線路、協定組合與路由設定，而非介面框架。
| 檢查項目 | 需求說明 |
|---|---|
| 系統與架構 | 適用於 Windows x64 環境；請在「設定 → 系統 → 系統資訊」確認系統類型。 |
| 安裝檔格式 | 提供 ZIP 壓縮檔。請先解壓縮至獨立資料夾，再依照檔案內容執行安裝程式或客戶端。 |
| 執行環境 | 系統版本與執行環境需求會因發行套件而異；若出現缺少執行環境的提示，請依指示安裝相符元件。 |
| 權限與流量接管 | 一般系統代理與 TUN 的權限需求不同；使用 TUN 時，請依客戶端提示完成權限授予。 |
請勿直接在壓縮檔預覽視窗中啟動程式。完整解壓縮後再執行，程式才能讀取同一資料夾中的資源、設定與元件。安裝位置應允許目前使用者寫入；若設定儲存失敗，請先檢查資料夾權限，不要一開始就反覆重新安裝。
安裝完成後，先匯入訂閱或伺服器設定，再選取要使用的項目。系統代理只會影響使用系統代理設定的應用程式；若特定程式未經代理，請先檢查該程式的網路設定。切換 Desktop 與 WPF 版前，請先匯出設定、關閉舊程式並清除舊的系統代理狀態，避免兩個執行個體同時修改設定。
macOS · 依「關於這台 Mac」顯示的晶片選擇
若「關於這台 Mac」顯示 Apple M 系列晶片，請選擇 arm64 安裝檔。建議使用與晶片相符的原生架構，不要只依購買年份判斷；同一時期販售的不同機型可能搭載不同處理器。
若「關於這台 Mac」顯示 Intel 處理器，請選擇 x64 安裝檔。兩種 DMG 對應的是處理器架構，並非功能等級。若系統提示應用程式無法執行，請先確認架構與系統相容條件，再檢查安裝過程。
| 檢查項目 | 需求說明 |
|---|---|
| 處理器 | Apple Silicon 使用 arm64；Intel 使用 x64，請在系統選單的「關於這台 Mac」查看。 |
| 套件格式 | DMG 磁碟映像檔。開啟後，依映像檔中的安裝指引將應用程式移至「應用程式」資料夾。 |
| 系統相容性 | 請以目前發行套件的執行需求與系統提示為準；較舊的系統請先確認相容性。 |
| 系統權限 | 依使用的代理模式授予系統權限；網路延伸功能或流量接管權限不等於匯入訂閱。 |
安裝後請從「應用程式」資料夾啟動客戶端，不要長期從掛載的磁碟映像檔執行。若出現安全性提示，請先確認下載來源與提示內容，再透過系統提供的「隱私權與安全性」設定處理；不要為了安裝單一應用程式而全面關閉系統安全功能。
從其他桌面系統遷移設定時，可沿用相容的伺服器參數，但本機路徑、網路介面、系統代理與權限設定都需要重新確認。先測試單一設定是否能連線，再還原完整路由規則，方便判斷問題來自伺服器參數或本機流量接管方式。關閉客戶端前，也請確認系統代理是否已還原。
Android · Xray 核心 · arm64 / 通用版
2015 年後的主流手機通常可選 arm64，但仍須確認系統支援 64 位元應用程式。處理器能力與系統執行環境不一定相同；若出現架構不相容提示，請先確認裝置資訊，再考慮使用通用版。
通用版支援更多處理器架構，檔案通常較大。這不代表連線速度更快，也不會自動修正訂閱參數錯誤。首次啟動後仍須匯入有效設定，並允許系統建立 VPN 連線。
Android · V2Fly 核心 · 請先確認協定相容性
適合需要使用 V2Fly 設定功能的使用者。選擇前請確認伺服器要求的協定、傳輸方式與安全欄位；不能只看客戶端名稱判斷相容性。同屬 Project V 生態系，不代表所有延伸功能都相同。
不確定裝置架構時可選擇通用版。從 v2rayNG 遷移時，請先保留原有設定備份，逐項確認路由與 DNS；單純更換安裝檔不會自動轉換不同核心的專屬設定。
| 檢查項目 | 需求說明 |
|---|---|
| 系統相容性 | 需要使用支援目前 APK 的 Android 系統；最低版本依安裝程式與發行需求而定。 |
| 裝置架構 | 64 位元 Android 環境優先選 arm64；不確定時可選通用版，但仍須符合系統版本需求。 |
| 安裝權限 | 依系統提示允許目前使用的瀏覽器或檔案管理員安裝應用程式；安裝完成後可撤銷此權限。 |
| 連線權限 | 使用 VpnService 接管流量需要系統 VPN 權限；同一使用者環境通常只能執行一個 VPN 服務。 |
| 背景執行 | 若要維持連線，請妥善設定電池最佳化與背景執行權限；各裝置系統的設定位置可能不同。 |
安裝程式提示「應用程式未安裝」時，請分辨原因是系統版本過舊、架構不相容、儲存空間不足或簽章衝突。通用版主要解決架構支援問題，無法避開其他安裝條件。已有設定時請先備份，不要立刻解除安裝舊應用程式，以免遺失僅儲存在本機的伺服器資訊。
首次連線時出現的 VPN 確認視窗，是授權系統接管流量，不是登入伺服器。授權後請檢查服務狀態與記錄。若鎖定螢幕後常中斷，請確認電池最佳化與背景執行限制；若只有部分應用程式未走代理，請檢查依應用程式代理的包含或排除模式，不必反覆更換安裝檔。
兩款 Android 客戶端可分別儲存設定，但測試時一次只啟動一個 VPN 服務。若想了解核心差異，請參閱協定與核心參考；若需要完整的背景執行設定步驟，請閱讀v2rayNG 權限、省電與依應用程式代理筆記。
Linux · 先選發行版套件格式，再選 x64 或 arm64
使用 Debian 套件管理系統時，請選擇 deb。檔名中的 amd64 對應常見的 x64 架構，並非只適用於某一個處理器品牌。ARM 桌上型裝置請選擇 arm64 套件，並確認發行版提供相應的執行相依套件。
使用 RPM 套件管理系統時，請選擇 rpm。x86_64 對應 x64，aarch64 對應 arm64。套件格式符合只是第一步，還須檢查執行環境與發行版相容性；不要強行略過相依性問題繼續安裝。
| 檢查項目 | 需求說明 |
|---|---|
| 執行環境 | 需要圖形桌面環境及目前客戶端所需的相依套件，不適用於僅有命令列終端的環境。 |
| 架構對應 | amd64 / x86_64 選 x64；aarch64 選 arm64，不能只依發行版名稱選擇。 |
| 套件管理系統 | 依發行版選用 deb 或 rpm，並透過系統套件安裝程式查看相依套件與相容性提示。 |
| 網路流量接管 | 應用程式是否使用桌面系統代理，取決於桌面環境及應用程式本身的設定；TUN 另有權限需求。 |
下載後，使用發行版的套件安裝程式開啟相應檔案，先查看相依套件提示，再完成安裝。即使副檔名正確，較舊的執行環境或不同的發行版分支仍可能造成安裝失敗；不要預設透過轉換套件或略過相依性來處理。
啟動後，先在客戶端中測試單一設定，再設定桌面環境的系統代理。瀏覽器、下載工具和其他應用程式未必使用同一組代理設定。若客戶端已建立連線，但某個應用程式仍直接連線，請檢查該應用程式使用的代理來源；若使用 TUN，還須確認權限、網路介面及現有的網路管理服務。
安裝檔負責提供可執行的程式；伺服器設定、流量入口與路由規則仍須分別設定。
訂閱網址用於取得一組伺服器設定；單一分享連結則用來匯入一筆設定。請勿將兩者輸入錯誤的欄位。匯入後檢查協定類型、位址、連接埠、傳輸方式與安全參數，先選一筆設定測試連線。更新訂閱通常只會更新伺服器清單，不代表本機路由、DNS 與代理模式也會同步。
桌面系統代理主要影響遵循系統設定的應用程式；Android 客戶端透過 VpnService 接管流量，也可進一步設定依應用程式代理。路由規則只會處理已進入核心的連線，無法取代系統代理或 VPN 權限。請先確認流量入口，再決定哪些網域與位址要走 proxy、direct 或 block。
服務啟動後，請用目標應用程式實際發出一次請求，並搭配記錄確認連線是否建立。延遲測試數值、介面顯示的執行狀態與實際下載速度，測量的項目各不相同。遇到逾時，請依序檢查系統時間、設定更新、傳輸參數、DNS 與記錄，避免同時修改多項設定而無法判斷原因。
客戶端程式、伺服器設定與本機設定是三種不同資料，更新時應分別處理。
更新前，請匯出需要保留的伺服器設定，並另外記下路由規則、DNS、監聽連接埠與依應用程式代理設定。不同客戶端匯出的內容可能不同，「匯出伺服器設定」不代表已完整備份。備份檔與訂閱網址可能包含存取憑證，請存放於安全位置。
同一款客戶端通常可透過覆蓋安裝更新並保留資料，但仍受系統安裝規則、應用程式簽章與安裝方式影響。遇到簽章或相依套件提示時，請先看清楚原因再決定遷移方式；尚未備份前，請勿刪除舊程式與設定資料夾。
Project V 是相關代理工具的生態背景；V2Fly 延續 V2Ray 核心的發展，Xray 則屬於相關技術家族，並有自己的功能延伸。v2rayN 用於管理桌面設定；Android 版的 v2rayNG 與 v2flyNG，則應依各自的核心能力選擇。
這些客戶端以開源方式發布，實際授權範圍請以各專案與元件的聲明為準。選擇時應檢查協定、傳輸方式與安全欄位的組合，而非只看是否支援某個協定名稱。遷移後請先用單一設定驗證，再還原較複雜的規則。
先確認安裝條件，再排查連線設定。更換安裝檔並非所有問題的通用解法。