桌面端選 v2rayN；Android 端先看 v2rayNG。確認作業系統與處理器架構後，再選擇相應的安裝檔。
下載入口依作業系統分類；切換平台後，網址列會保留相應的錨點。
適用於 x64 裝置。初次使用建議從 Desktop 開始；想沿用經典操作習慣則選 WPF。
兩種版本的主要差異在介面技術與操作配置，不宜據此判斷連線速度。節點品質、遠端負載、路由與本機網路都會影響使用體驗。建議先選一個版本完成匯入與連線測試，再決定是否更換，避免混淆介面差異與設定差異，增加排查難度。
檔案儲存至本機後，先完整解壓縮至有寫入權限的資料夾，再執行其中的安裝或啟動程式；請勿直接從壓縮檔預覽視窗啟動。若出現缺少執行環境的提示，請依提示安裝相應元件，不要只憑檔名安裝任意舊版執行階段。
已有設定的使用者，請先匯出備份並結束系統匣中的舊版用戶端，再進行安裝或移轉。不建議同時執行 Desktop 與 WPF：即使視窗各自獨立，仍可能爭用本機監聽埠或反覆修改系統代理。移轉後先檢查訂閱群組與路由選擇，再實際測試一次連線。
| 確認項目 | 安裝前確認 |
|---|---|
| 處理器架構 | 本頁兩個下載入口皆為 x64；請於「設定 → 系統 → 系統資訊」確認系統類型，不適用於 32 位元環境。 |
| 系統與執行環境 | 建議使用仍在維護支援期間的 Windows；最低系統版本及執行階段需求，請以所下載版本的安裝提示為準。 |
| 資料夾與權限 | 選擇可寫入的資料夾並預留解壓縮空間。一般使用時先以標準權限啟動，只有相關功能明確要求時才授予額外權限。 |
| 連線準備 | 保留現有訂閱或節點設定；首次測試先使用系統代理，通過基本連線後再單獨測試 TUN 等功能。 |
前往「蘋果選單 → 關於這台 Mac」查看晶片或處理器名稱，再選擇相應的 DMG。
下載完成後開啟 DMG，依映像檔中的指示將 App 移至「應用程式」資料夾，再從該資料夾啟動。請勿長期直接從掛載的映像檔執行，否則卸載映像檔或清理下載資料夾後，啟動入口可能失效，也容易搞不清楚目前使用的是哪一份程式。
晶片架構與系統版本是兩項獨立條件：選對 arm64 或 x64，不代表目前系統一定符合版本需求。若出現無法開啟或不相容提示，請先記下完整提示、系統版本與晶片型號；若系統顯示安全性提示，應先確認檔案來源與提示內容，再透過系統提供的方式處理，請勿直接停用整套安全機制。
初次啟動時，先匯入一個已知可用的節點，再確認系統代理狀態。如果瀏覽器可以連線、某個 App 卻不行，請先確認該 App 是否遵循系統代理，不要立即更換安裝檔。TUN 涉及不同的權限與流量接管方式，建議與系統代理分開測試，以免重複接管而難以判斷。
| 確認項目 | 安裝前確認 |
|---|---|
| 晶片架構 | Apple M 系列使用 arm64；Intel 處理器使用 x64。建議優先選擇符合硬體架構的原生版本。 |
| 系統版本 | 在「關於這台 Mac」查看完整版本資訊；最低需求可能因版本而異，請以 App 或系統的相容性提示為準。 |
| 安裝位置 | 請確認可寫入 App 安裝資料夾；安裝完成後從「應用程式」啟動，不要長期直接從 DMG 執行。 |
| 系統授權 | 僅授予實際功能所需的權限；若網路流量接管功能要求額外授權，請先閱讀提示再決定是否啟用。 |
建議先選 v2rayNG；需要 v2fly 核心設定時，再考慮 v2flyNG。兩款用戶端的設定各自獨立管理。
v2rayNG 適合需要匯入訂閱、切換節點及透過 Android VPN 服務接管流量的使用者。安裝後前往訂閱設定，新增群組並輸入完整訂閱網址，再更新訂閱。只將連結複製到剪貼簿不會自動建立訂閱群組；單一節點分享連結也不等於可持續更新的訂閱網址。
第一次點選連線時，系統會要求建立 VPN 連線。這是用戶端接管網路流量的系統入口，確認目前操作後再授權。若裝置上已有其他 VPN 服務，請先停止該服務再測試；也要檢查用戶端的分應用程式代理設定，避免測試用的 App 恰好被排除。
卡片上的版本文字與安裝檔檔名，可能因清單更新時程而暫時不同；安裝後可在「關於」頁面確認實際版本。請勿自行修改網址中的版本號，也不要只因檔名不同就判定架構不符。
v2flyNG 使用 v2fly 核心，可作為有相應設定需求時的替代選擇。它與 v2rayNG 名稱相近，但並非同一款 App 的不同介面；支援的協定、傳輸方式與參數仍須分別確認。不能因為某款用戶端成功匯入設定，就認定另一款也一定能完整辨識所有欄位。
從 v2rayNG 移轉時，建議先在新用戶端重新新增有權使用的訂閱，確認節點數量與參數後再測試連線。App 內的完整備份不一定能直接還原至另一款用戶端。請保留原有設定，直到新用戶端確認可正常使用；測試時一次只啟動一項 VPN 服務。
| 確認項目 | 安裝前確認 |
|---|---|
| 應用程式架構 | 優先選擇 arm64；處理器支援 64 位元，不代表系統一定允許安裝 64 位元 App。若不確定，請選通用版並確認安裝結果。 |
| 系統版本 | 在系統設定中查看 Android 版本；最低需求請以所下載 APK 的安裝提示為準，通用版不會降低系統需求。 |
| 安裝權限 | 系統可能會要求允許目前使用的瀏覽器或檔案管理員安裝 App；僅授權本次使用的來源，完成後可撤銷權限。 |
| 升級衝突 | 若遇到簽章或 App 衝突，請先備份設定，再確認原本的安裝來源；沒有備份前不要直接解除安裝舊版 App。 |
| 背景執行 | 若螢幕鎖定後連線中斷，再檢查電池最佳化與背景執行限制。先確認前景連線正常，避免太早修改大量系統設定。 |
先確認發行版採用的套件管理系統，再確認處理器架構。deb 與 rpm 是不同套件格式，不能互換。
在系統「關於」或硬體資訊中查看架構：amd64、x86_64 通常對應此處的 x64，aarch64 通常對應 arm64。套件管理工具也會檢查發行版相依套件與套件中繼資料，因此即使副檔名與架構相同，也不代表所有發行版都能安裝同一個版本。
下載後使用發行版的圖形軟體安裝程式開啟安裝檔，先查看相依套件與變更摘要，再確認安裝。若提示相依套件無法滿足，請記下缺少的項目與系統版本，不要強制忽略相依性來規避錯誤。圖形介面用戶端需要可用的桌面工作階段，不適合直接取代純命令列伺服器上的工具。
安裝後系統代理是否生效，取決於桌面環境及目標 App 對代理的支援。如果某個 App 未遵循系統代理，請先檢查 App 本身的網路設定；之後若啟用 TUN，再依功能提示授予所需權限。不要為了排查單一 App，讓整個圖形用戶端長期以高權限執行。
| 確認項目 | 安裝前確認 |
|---|---|
| 套件格式 | 依發行版選擇 deb 或 rpm；請勿只改副檔名或任意轉換套件格式來處理相容性問題。 |
| 架構 | x64 對應 amd64 / x86_64；arm64 對應 aarch64。兩種套件格式皆提供相應架構的下載入口。 |
| 桌面環境與相依套件 | 需要圖形桌面環境；系統程式庫、桌面元件與最低版本需求，取決於安裝程式及版本相依套件。 |
| 安裝權限 | 依系統安裝程式的提示授予安裝權限；安裝完成後，建議在一般使用者的桌面工作階段中執行。 |
下載用戶端與訂閱服務是兩回事。程式安裝完成後，需匯入現有的訂閱網址或單一節點設定，選擇一個節點作為目前使用的伺服器，再啟動連線。訂閱更新成功只代表取得了設定，不表示其中每個節點都能連線；請觀察實際連線結果與核心記錄，不要只看清單是否顯示項目。
桌面端先檢查系統代理，Android 端先確認 VPN 服務已建立。基本連線正常後，再逐項設定路由、分應用程式代理或 TUN。每次只變更一項設定，並記錄變更前後的狀況，才能區分安裝、設定與網路路徑問題。
初次安裝可先選 Desktop 桌面版，採用新一代跨平台 UI；習慣傳統介面與操作方式的使用者，可選 WPF 經典穩定版。兩者擇一安裝，移轉前先匯出設定，請勿同時啟動，以免占用相同的監聽埠。
2015 年後推出的主流手機通常可優先選 arm64，實際仍應以裝置支援的應用程式 ABI 為準。通用版包含多種架構，適合不確定裝置架構時使用；若發生解析或安裝錯誤，也請檢查系統需求、簽章衝突與儲存空間。
安裝檔只有用戶端程式，不含可直接使用的節點或訂閱服務。安裝後需匯入有權使用的訂閱或節點設定，再選擇伺服器、設定路由並測試連線。訂閱網址屬於敏感資訊，請勿公開分享。
版本文字與下載網址取自清單中的不同欄位，更新期間可能暫時不一致。請勿修改檔名來嘗試下載其他版本；先確認所選平台與架構，安裝後於用戶端的「關於」頁面確認實際版本，再決定是否移轉原有設定。
先使用用戶端提供的備份或匯出功能，保存訂閱群組、自訂節點、路由規則及必要設定，並將備份存放在私人資料夾。升級前先關閉正在執行的用戶端；首次啟動後先測試單一節點，暫時不要覆寫原有備份。
先確認核心能否啟動、節點設定是否完整、本機連接埠是否被占用，以及系統代理或 Android VPN 服務是否已啟用。安裝成功不代表訂閱或遠端服務可用；保留已隱去敏感資訊的第一筆錯誤記錄，依疑難排解手冊查找原因，通常比反覆重裝更有效。