依作業系統選擇 v2rayN、v2rayNG 或 v2flyNG。下載前先確認系統平台、處理器架構與安裝包類型，避免混用不同架構或不同套件管理體系的檔案。
平台標籤會同步至網址列錨點，重新開啟連結時可直接返回對應系統。版本文字與下載網址由同源發佈清單更新；清單暫時無法使用時，頁面會保留目前版本的完整下載路徑。
Windows 平台固定提供 Desktop 與經典 WPF 兩個入口。Desktop 是新一代跨平台介面，適合首次安裝及希望維持桌面端介面一致的使用者；WPF 延續經典配置，適合已熟悉舊版選單與操作路徑的使用者。
桌面圖形客戶端，提供訂閱管理、伺服器選擇、系統代理、路由設定與 TUN 模式等常用功能。
新一代跨平台 UI。希望使用目前桌面介面與後續跨平台體驗時，優先選擇此套件。
沿用經典 v2rayN 視窗結構與選單路徑，適合需要維持既有操作習慣的使用者。
| 檢查項目 | 需求與判斷方式 |
|---|---|
| 系統 | 使用仍在維護週期內的 64 位元 Windows 桌面系統，並完成例行系統更新。 |
| 處理器 | 目前頁面提供 x64 安裝包。可在「設定 → 系統 → 系統資訊」查看系統類型。 |
| 安裝權限 | 安裝程式需要寫入應用程式目錄；TUN 模式可能還要求提升權限，以建立虛擬網路裝置。 |
| 首次啟動 | 先匯入訂閱或單一伺服器設定，再選擇設定、啟動連線，並依需求設定系統代理。 |
從其他版本遷移時，先記錄訂閱網址、路由規則與本機連接埠設定。不要在兩個正在執行的客戶端之間反覆切換系統代理，否則瀏覽器可能持續使用已停止監聽的本機連接埠。
兩個安裝包的功能定位一致，差異在於處理器架構。M 系列晶片選擇 Apple Silicon 版本，Intel 處理器選擇 Intel 版本。架構判斷應以系統資訊中的晶片或處理器欄位為準。
同一客戶端分別提供 arm64 與 x64 安裝包。確認晶片架構正確後，再進行訂閱匯入與系統代理設定。
適用於系統資訊顯示 Apple M 系列晶片的裝置，對應 arm64 架構。
適用於系統資訊明確顯示 Intel 處理器的裝置，對應 x64 架構。
| 檢查項目 | 需求與判斷方式 |
|---|---|
| 系統 | 使用目前仍能正常接收系統維護更新的 64 位元 macOS 環境。 |
| 架構 | M 系列晶片對應 arm64；Intel 處理器對應 x64。下載包必須與硬體架構一致。 |
| 網路權限 | 首次設定系統代理或 TUN 模式時，系統可能要求確認網路設定相關權限。 |
| 啟動檢查 | 匯入設定後先查看客戶端日誌，再驗證瀏覽器流量是否依所選代理模式處理。 |
如果應用程式可以啟動但網頁未經過代理，應先檢查客戶端是否已開始監聽、本機連接埠是否被其他程式佔用，以及系統代理是否指向客戶端目前顯示的連接埠。不要把「客戶端已開啟」等同於「代理已啟用」。
日常使用優先選擇採用 Xray 核心的 v2rayNG；現有設定明確依賴 V2Fly 核心家族，或需要相應實作時選擇 v2flyNG。每款客戶端都提供 arm64 與通用版，2015 年後的主流手機通常先選 arm64。
採用 Xray 核心的 Android 圖形客戶端，支援訂閱匯入、QR Code 匯入、路由設定與依應用程式設定。
適用於絕大多數近年推出的 64 位元 Android 手機，安裝包針對 arm64-v8a 架構。
支援更廣泛的裝置架構，適合無法確認處理器類型或 arm64 套件無法安裝的情況。
採用 V2Fly 核心家族的 Android 圖形客戶端，適合現有設定明確要求相應核心實作的情境。
面向 arm64-v8a 處理器架構。裝置架構明確時，優先使用對應的精簡架構包。
適用於無法確認處理器架構，或裝置提示 arm64 安裝包與目前系統不相容的情況。
| 檢查項目 | 需求與判斷方式 |
|---|---|
| 架構 | 2015 年後的主流手機通常可先選 arm64；安裝失敗或架構不明時改用通用版。 |
| 安裝授權 | 系統可能要求允許目前瀏覽器或檔案管理器執行一次安裝，完成後可依系統設定收回權限。 |
| VPN 連線確認 | 客戶端首次啟動本機 VPN 服務時會顯示系統確認視窗，需要確認後才能接管應用程式流量。 |
| 背景執行 | 若連線在鎖定螢幕後被系統停止，應檢查電池最佳化與背景活動限制，而不是反覆匯入訂閱。 |
v2rayNG 與 v2flyNG 是兩個獨立客戶端。切換時先停止目前連線，再啟動另一個客戶端，避免系統中同時存在兩個正在要求 VPN 接管的應用程式。匯入訂閱後還應手動更新一次，確認伺服器清單與群組內容已載入。
Debian、Ubuntu 及其衍生發行版通常使用 deb；Fedora、Rocky Linux、AlmaLinux 等採用 RPM 套件管理體系的發行版使用 rpm。接著再確認處理器是 x64 還是 arm64。
提供 deb 與 rpm 兩類安裝包，並分別涵蓋 x64 與 arm64 架構。選擇順序應先確定發行版套件類型，再確認處理器架構。
x64 適用於常見 Intel 或 AMD 64 位元桌面裝置；arm64 適用於 64 位元 ARM 裝置。
x86_64 對應常見 x64 裝置；aarch64 對應 arm64 裝置。發行版必須支援 RPM 套件管理。
| 檢查項目 | 需求與判斷方式 |
|---|---|
| 發行版 | 先確認系統使用 Debian 系列還是 RPM 套件管理體系，再選擇對應副檔名。 |
| 架構 | x86_64 或 amd64 選擇 x64；aarch64 或 arm64 選擇 arm64。 |
| 桌面環境 | v2rayN 是圖形客戶端，應在具備可用桌面工作階段與一般圖形相依元件的環境中執行。 |
| 網路設定 | 啟動後檢查本機監聽連接埠、系統代理與桌面環境代理設定是否一致。 |
如果安裝程式回報缺少相依元件，應透過目前發行版的套件管理工具處理相依關係，而不是混裝另一種發行版的安裝包。使用 Wayland 或不同桌面環境時，系統代理入口的位置可能不同，但客戶端中的本機監聽與路由邏輯不變。
安裝失敗通常不是客戶端型號問題，而是平台、架構或套件類型不一致。依固定順序判斷，可以減少重複下載與設定遷移。
Windows、macOS 與 Linux 桌面端使用 v2rayN；Android 端優先使用 v2rayNG，需要 V2Fly 核心家族時選擇 v2flyNG。不要將不同平台的檔案副檔名視為同一類安裝包處理。
x64、arm64、Intel 與 Apple Silicon 描述的是處理器架構。應從系統資訊讀取，不建議依裝置品牌、外觀或大致年份推測。Android 架構無法確認時，可使用通用版作為相容選擇。
Windows 在 Desktop 與 WPF 之間選擇介面路線；Linux 在 deb 與 rpm 之間選擇套件管理體系。確定安裝包後，再處理訂閱匯入、系統代理與路由規則，不要將安裝階段與連線階段混在一起排查。
下載並安裝客戶端只完成執行環境準備。客戶端需要有效設定才能建立連線，系統流量是否進入客戶端還取決於代理模式與路由設定。
確認檔案屬於目前平台與架構，結束同類客戶端後再安裝。升級現有客戶端時，先記錄訂閱、路由規則、本機連接埠與 DNS 設定。安裝程式完成不代表系統代理已開啟。
透過訂閱網址、分享連結、QR Code 或手動參數匯入設定。匯入後執行訂閱更新，檢查伺服器清單、群組與協定參數是否完整。清單為空通常表示訂閱未成功解析，而不是安裝包損壞。
選擇設定並啟動後，檢查本機監聽是否正常，再設定系統代理。需要接管更廣泛的流量時，再設定 TUN 模式。兩種模式的流量入口不同，不應在不了解規則時反覆切換。
先查看日誌中是否存在 DNS、連接埠、協定或連線逾時錯誤，再測試瀏覽器。部分應用程式不遵循系統代理，此時應檢查應用程式自身的代理設定或評估 TUN 模式，而不是直接更換客戶端。
以下問題集中處理版本路線、處理器架構、Linux 套件類型與安裝後的連線條件。設定內容本身無效時，更換安裝包通常無法解決問題。
首次安裝可優先選擇 Desktop 版，採用新一代跨平台介面。已熟悉經典 v2rayN 操作配置，或需要沿用既有使用習慣時，可選擇 WPF 版。兩者請勿同時執行，以免系統代理連接埠與設定狀態互相影響。
開啟系統資訊或關於這台 Mac，查看晶片或處理器欄位。顯示 Apple M 系列晶片時選擇 Apple Silicon 版本；顯示 Intel 處理器時選擇 Intel 版本。架構不相容可能導致安裝程式無法正常啟動。
2015 年後的主流 Android 手機通常採用 arm64 架構，可優先下載 arm64 版本。無法確認裝置架構、安裝時出現架構不相容提示，或裝置採用其他處理器架構時，再改用通用版。
Android 日常使用可優先選擇採用 Xray 核心的 v2rayNG。需要使用 V2Fly 核心家族，或現有設定明確要求相應實作時，可選擇 v2flyNG。兩款客戶端的設定應分開管理，不建議直接覆蓋彼此的資料目錄。
Debian、Ubuntu 及其衍生發行版通常選擇 deb；Fedora、Rocky Linux、AlmaLinux 等採用 RPM 套件管理體系的發行版選擇 rpm。還需依處理器架構區分 x64 與 arm64，不能只根據副檔名選擇。
客戶端只負責管理設定、核心與本機代理，需要先匯入有效訂閱或伺服器設定，再選擇可用設定並啟動連線。之後依使用範圍開啟系統代理或設定 TUN 模式，最後透過瀏覽器與客戶端日誌確認連線狀態。