先選擇作業系統，再選擇處理器架構。
桌面版使用 v2rayN；Android 裝置建議優先選 v2rayNG，需要 V2Fly 設定生態系時再考慮 v2flyNG。安裝後匯入現有訂閱，客戶端本身不提供伺服器。
以下兩個下載入口皆為 x64 版本。初次安裝建議先選 Desktop；想沿用經典操作方式則可選 WPF。下載壓縮檔後，請先解壓縮，再執行其中的安裝程式。
Desktop 採用新一代跨平台介面；WPF 則是經典穩定版。兩者都能管理訂閱與代理設定，介面配置和設定入口則有所不同。
初次使用建議先安裝 Desktop，完成訂閱匯入與連線測試後，再調整路由。已在使用 WPF 的使用者，不必只為了更換介面而搬移設定；若確實需要切換，請先從原客戶端匯出設定，再匯入新客戶端。不要直接覆蓋另一個版本的整個程式資料夾，也不要假設兩種介面會即時共用設定。
一般日常操作使用標準使用者權限即可。系統代理通常不需要較高權限；TUN 則可能需要管理員權限及虛擬網路元件。建議先關閉 TUN，確認系統代理正常運作後，再依需求啟用。若同時啟動兩個版本，監聽連接埠可能衝突，請先結束舊版程式。
| 檢查項目 | 需求與選擇 | 查看方式 |
|---|---|---|
| 處理器架構 | 本頁提供 x64 安裝檔 | 設定 → 系統 → 系統資訊，查看系統類型 |
| 系統相容性 | 請以目前安裝程式的提示為準；舊版系統需特別確認執行環境 | 先完成系統更新，再處理安裝程式提示的相依元件 |
| 執行權限 | 一般代理與 TUN 的權限需求不同 | 先測試系統代理；需要使用 TUN 時，再依提示授權 |
請勿直接從壓縮檔預覽視窗啟動程式。先解壓縮至可寫入的資料夾，完成安裝後再從應用程式入口啟動。若系統提示缺少執行元件，請記下提示中的元件名稱與架構，並依指示安裝；重複安裝同一個安裝檔通常無法解決相依元件缺漏。
先從蘋果選單的「關於這台 Mac」查看晶片資訊。若顯示 Apple M 系列，請選 Apple Silicon；若顯示 Intel 處理器，請選 Intel。請勿依作業系統名稱或電腦外觀猜測架構。
Apple M 系列建議使用原生 arm64 安裝檔；Intel 機型則使用 x64 安裝檔。兩種安裝檔是為不同處理器架構設計，功能並無等級差異。
開啟 DMG 後，將應用程式拖曳至「應用程式」資料夾，再從該資料夾啟動。請勿長期從已掛載的磁碟映像執行，以免更新、權限記錄和應用程式路徑難以維持一致。首次啟動若出現系統安全性提示，請先確認來源與應用程式名稱，再到系統設定的「隱私權與安全性」查看原因；不建議關閉整台裝置的安全機制。
訂閱與路由設定可參考桌面版教學，但選單位置可能隨介面版本變動。設定系統代理後，先用瀏覽器測試，再確認其他應用程式是否遵循系統代理。部分終端工具有自己的代理設定；瀏覽器可用、終端卻無法使用，不代表訂閱一定失效。若需要接管更多應用程式，再了解 TUN 的權限需求與路由影響。
| 檢查項目 | 需求與選擇 | 查看方式 |
|---|---|---|
| 晶片 | Apple Silicon 選 arm64；Intel 選 x64 | 蘋果選單 → 關於這台 Mac |
| 系統版本 | 須符合目前應用程式公布的最低系統版本 | 在「關於這台 Mac」查看系統版本，並參考啟動提示 |
| 應用程式位置 | 複製到「應用程式」資料夾後執行 | 安裝完成後退出 DMG，再啟動應用程式 |
若提示應用程式不相容，請先確認是否選錯晶片版本，再檢查系統版本。處理器架構正確，不代表目前應用程式能在所有舊版系統上執行。升級系統前請先確認裝置是否支援；不要任意修改應用程式檔案，試圖繞過明確的相容性要求。
2015 年後推出的主流手機通常可先選 arm64。若無法確認系統架構，或 arm64 安裝檔顯示不相容，再考慮通用版。兩款客戶端各自儲存設定，切換應用程式不會自動移轉訂閱。
適用於日常訂閱管理及 Xray 相關設定。arm64 安裝檔適用於對應系統架構；通用版則包含多種架構的相容內容。
下載 APK 後，從系統檔案管理員開啟。若系統詢問是否允許安裝未知來源的應用程式，請只授權目前負責安裝的瀏覽器或檔案管理員，安裝完成後即可關閉權限。首次連線時會要求建立 VPN 連線，這是 Android 接管流量所需的系統授權；確認應用程式名稱後再允許。
匯入訂閱後，先更新群組，再選擇伺服器並啟動連線。清單出現項目不代表已成功連線。若背景連線經常中斷，請檢查電池最佳化、背景活動與常駐通知設定，也要留意裝置上是否有其他應用程式正在使用系統 VPN。啟用更多功能前，先確認基本連線與網域解析正常。
適用於需要 V2Fly 核心生態系的設定。選擇依據是協定與欄位的相容性，而非應用程式名稱是否相似。
若現有設定適用於 V2Fly，可將 v2flyNG 作為替代選項。請勿假設它與 v2rayNG 支援的協定完全相同，尤其是使用特定核心擴充功能的設定。匯入失敗時，先確認分享連結類型、傳輸方式與安全性選項，再判斷是否改用另一款客戶端。
從其他應用程式移轉時，建議重新加入訂閱網址，再逐項確認路由與 DNS 設定。節點名稱相同，不代表所有欄位都已完整移轉。兩款 Android 客戶端可分別安裝，但測試連線時一次只執行一款，避免將系統 VPN 切換誤判為伺服器不穩定。
| 檢查項目 | 需求與選擇 | 建議做法 |
|---|---|---|
| 系統架構 | 64 位元系統通常選 arm64；不確定時可選通用版 | 以系統架構為準，不要只看處理器規格 |
| 系統相容性 | 須符合對應 APK 的最低系統需求 | 若解析失敗，也請檢查系統版本與下載狀態 |
| 安裝與連線權限 | 允許安裝未知來源的應用程式，以及系統 VPN 連線授權 | 依系統提示分別確認即可，不必開放無關權限 |
若安裝時提示「與現有應用程式衝突」，請勿立即解除安裝。先確認目前應用程式的來源與簽章是否和新安裝檔一致，再匯出設定。若必須重新安裝，請先備份訂閱網址與自訂規則；只截取節點清單通常不足以還原完整設定。
一般 x64 桌面裝置請選擇相符的套件格式；ARM 桌面裝置請使用下方 arm64 下載入口。套件格式由 Linux 發行版決定，處理器架構則依裝置而定，兩者都必須相符。
Debian、Ubuntu 等發行版通常使用 deb；Fedora、RHEL 等通常使用 rpm。套件格式相同，不代表所有版本的相依套件都符合需求。
使用系統的軟體安裝程式開啟下載的套件，先檢查相依套件與架構提示，再確認安裝。目前的 rpm 檔名包含建置目標資訊，安裝前尤其要確認發行版提供的執行程式庫是否符合需求。請勿為了略過相依性錯誤而強制安裝，也不要直接將其他發行版的軟體來源加入目前系統。
這是圖形介面客戶端的下載入口，適用於配備桌面環境的裝置。安裝後先從應用程式選單啟動，再設定訂閱與系統代理。不同桌面環境對系統代理的支援不盡相同，終端程式也可能不會讀取桌面代理設定。需要使用 TUN 時再處理權限與路由，避免剛安裝就以高權限執行所有日常操作。
| 檢查項目 | 需求與選擇 | 查看方式 |
|---|---|---|
| 套件格式 | 依發行版選擇 deb 或 rpm | 可在系統資訊或軟體管理員中查看發行版名稱 |
| 處理器架構 | x64 對應 amd64 / x86_64；arm64 對應 aarch64 | 在系統資訊中查看硬體與作業系統架構 |
| 執行環境 | 圖形桌面與安裝套件所需的相依套件 | 使用系統軟體安裝程式檢查相依套件與相容性 |
若軟體管理員拒絕安裝，請先查看缺少的相依套件名稱，不要立刻更換節點或訂閱。相依套件問題發生在應用程式啟動之前，與伺服器連線無關。系統代理與 TUN 是安裝後的設定，請待客戶端正常開啟後再分別測試。
先確認一條連線正常，再新增規則。安裝檔、訂閱與代理模式是三件不同的事，排查時也應分別確認。
訂閱網址通常要加入訂閱群組，儲存後還須執行更新；以 vmess:// 或 vless:// 開頭的單一節點連結，通常從剪貼簿入口匯入。請勿將訂閱網址提供給不明的轉換服務，因為網址可能包含個人存取憑證。
選取可用伺服器後再啟用連線。桌面版先使用系統代理；Android 裝置則依系統提示建立 VPN 連線。建議先用預設路由確認基本功能正常；等連線穩定後，再設定自訂分流與 TUN，方便判斷問題出在哪個步驟。
查看使用說明 →使用實際需要的應用程式測試連線，再查看記錄是否有明確錯誤。延遲測試僅供參考，不能取代實際連線測試。確認設定可用後請匯出備份；升級、換裝置或更換客戶端前先保存原有設定，避免訂閱與自訂規則同時遺失。
連線問題排解 →架構不相容、安裝失敗與連線失敗屬於不同階段。先找出問題所在階段，再處理對應狀況。
請先準備可用的訂閱網址、單一節點分享連結或現有設定。客戶端用來管理設定及建立連線，安裝檔本身不包含可用伺服器。訂閱網址通常從訂閱群組匯入；單一節點分享連結通常從剪貼簿匯入，兩種入口不可混用。
第一次安裝可先選 Desktop，採用新一代跨平台介面。若習慣傳統介面或想沿用原有操作方式，可選經典穩定的 WPF 版。兩者差異不在節點方案。切換前請先匯出設定，也不要讓兩個客戶端同時使用相同的監聽連接埠。
2015 年後推出的主流手機通常可先選 arm64，但仍應以裝置的系統架構為準。通用版支援多種架構，適合無法確認架構，或 arm64 安裝檔顯示不相容時使用。部分裝置的處理器支援 64 位元，但安裝的系統仍可能是 32 位元。
同一客戶端正常升級通常會保留資料，但安裝方式、簽章或資料目錄不同，都可能影響結果。更新前請先透過客戶端介面匯出設定，並記下訂閱群組與路由設定。不要先解除安裝舊版；若遇到簽章衝突或無法覆蓋安裝，請先確認備份可用，再決定後續處理方式。
先確認訂閱已成功更新，且已選取可用伺服器，再檢查系統代理或連線開關是否已啟用。接著查看客戶端記錄，判斷是連接埠遭占用、驗證失敗、解析失敗還是連線逾時。先用系統代理測試，不要同時變更協定、路由和 TUN 設定。