v2rayN · v2rayNG · v2flyNG
桌面版使用 v2rayN；Android 優先選 v2rayNG，v2flyNG 為備選。先選擇作業系統，再確認處理器架構與安裝格式。
安裝檔僅提供客戶端程式；連線前請準備有權使用的訂閱網址或設定。若先前已安裝，建議先備份再更新。
兩種介面版本皆提供 x64 安裝檔。首次安裝可從桌面版開始；習慣經典版面則選擇 WPF 版。
採用 Avalonia 的新一代跨平台 UI。適合初次安裝，或希望在不同桌面系統間維持相近操作習慣的使用者。
適用於 Windows 的經典穩定介面版本。適合熟悉原有選單位置、偏好傳統桌面版面的使用者。
此處的「桌面版」與「WPF 版」是依介面框架區分，並非兩種訂閱服務，也不代表其中一版必定連線較快。能否使用特定協定，仍取決於實際執行的核心、連線參數與伺服器設定。
查看客戶端與版本差異 →| 檢查項目 | 需求與確認方式 |
|---|---|
| 系統與架構 | 本頁提供 Windows x64 套件。請在「設定 → 系統 → 系統資訊」查看系統類型；最低系統版本請以所選發行套件的說明為準。 |
| 執行環境 | 桌面版與 WPF 版所需的相依元件可能不同。若出現執行階段提示，請依實際錯誤處理，勿將其他版本的相依檔案放入安裝目錄。 |
| 目錄與權限 | 將壓縮檔完整解壓縮至可寫入的目錄，再執行其中的安裝程式。系統代理通常不必持續以系統管理員權限執行；接管 TUN 可能需要額外權限。 |
下載的檔案是 ZIP 壓縮檔，請勿直接在壓縮軟體的預覽視窗中執行程式。先完整解壓縮，再依照檔案內容安裝或啟動，避免設定、記錄檔與附帶檔案散落在暫存目錄。若舊版仍在背景執行，請先結束程式，以免監聽連接埠遭占用。
若首次啟動後介面正常，但網頁仍無法連線，請先確認已匯入設定並選取伺服器，再檢查系統代理。安裝完成不代表網路接管也已完成。需要依序操作時，可參考使用指南，從匯入訂閱開始逐步確認。
在系統選單的「關於這台 Mac」查看晶片或處理器名稱，Apple Silicon 與 Intel 請分別使用對應的 DMG。
「關於這台 Mac」顯示 Apple M 系列晶片時請選擇此套件。依晶片名稱判斷即可，不必根據機身型號或購買年份推測。
「關於這台 Mac」顯示 Intel 處理器時請選擇此套件。它與 Apple Silicon 套件使用相同的客戶端名稱，但可執行檔的處理器架構不同。
開啟 DMG 後，將應用程式複製到「應用程式」資料夾再啟動。首次使用時先匯入一般設定並設定系統代理；確認基本連線正常後，再考慮使用 TUN 與自訂 DNS。
安裝後的設定步驟 →| 檢查項目 | 需求與確認方式 |
|---|---|
| 晶片架構 | Apple M 系列對應 arm64；Intel 對應 x64。建議優先使用符合晶片架構的原生套件。 |
| 系統相容性 | 最低 macOS 版本請以目前發行套件的需求為準。舊版系統無法啟動時，應先確認系統相容性，而非反覆更換不同晶片架構的套件。 |
| 系統權限 | 網路接管與輔助元件可能需要授權。僅針對來源已確認的應用程式依系統提示操作，並保持系統安全機制正常啟用。 |
系統提示無法開啟應用程式時，請先閱讀完整訊息：架構不相容、系統版本過舊、應用程式安全性確認與檔案損毀是不同問題。不要把所有提示都歸因於同一原因，也不建議為了解決單一應用程式的啟動問題而全面關閉系統安全檢查。
更新前請先結束正在執行的客戶端，再替換應用程式。應用程式資料夾與使用者資料目錄並非同一位置，移動應用程式圖示不等於遷移所有設定。更換電腦時，請使用客戶端支援的匯出方式保存必要資訊，並檢查新環境中的代理與權限設定。
先確認核心類型，再查看處理器架構。一般使用情境建議優先選 v2rayNG；有明確 V2Fly 設定需求時，再考慮 v2flyNG。
2015 年後推出的主流手機通常可選 arm64。少數裝置可能使用 32 位元系統，仍須以實際系統支援的應用程式架構為準。
不確定裝置架構時可選通用版。套件包含多種架構的支援，但不代表也能支援較舊的 Android 系統。
適合主要使用 Xray 生態系設定的 Android 使用者。安裝後可匯入訂閱或連線資訊，再依系統提示授予 VPN 連線權限。此權限用於接管裝置流量，不表示安裝檔內含可用伺服器。
適合明確需要 V2Fly 核心且裝置支援 arm64 的使用者。選擇依據是設定相容性，而非名稱是否與其他客戶端相似。
適合無法確認裝置架構時使用。匯入其他客戶端的設定後，仍須檢查協定、傳輸方式、安全設定與路由欄位。
不要預設 Xray 專屬的擴充參數也能直接用於 V2Fly。訂閱可以匯入，只代表客戶端辨識了相關資訊，不代表目前的核心能執行所有連線參數。
比較兩款 Android 客戶端 →| 檢查項目 | 需求與確認方式 |
|---|---|
| 系統與架構 | 請優先確認裝置支援 arm64 應用程式；最低 Android 版本請依各 APK 的安裝需求為準，通用版不代表相容所有系統。 |
| 安裝授權 | 依系統提示允許目前使用的瀏覽器或檔案管理員安裝應用程式；安裝完成後可撤銷這項權限。 |
| VPN 與背景執行 | 首次連線需要授予 VPN 權限。若已有其他 VPN 應用程式在執行，請先檢查是否衝突；若背景連線經常中斷，再檢查電池最佳化設定。 |
「未安裝應用程式」不一定是架構問題，也可能與系統版本、既有應用程式的簽章、可用空間不足或安裝檔讀取失敗有關。若提示更新衝突，請先備份目前設定並確認原應用程式的來源；不要為了完成更新而直接刪除唯一一份設定資料。
Android 的 VPN 連線權限與系統網路接管有關。測試兩款客戶端時，建議一次只啟動一款，先停用另一款的連線，再檢查瀏覽器是否能連線及客戶端記錄檔。只有部分應用程式異常時，應優先檢查應用程式分流，而非立刻更換安裝檔。
先確認使用 deb 或 rpm，再確認 x64 或 arm64。桌面客戶端需要可用的圖形工作階段，不適用於僅有終端機的伺服器環境。
適用於採用 deb 套件管理系統的發行版，例如 Debian、Ubuntu。amd64 在此代表 x64 架構，不限於特定處理器品牌。
適用於採用 rpm 套件管理系統且相依套件版本相符的系統。同一副檔名不代表適用所有發行版，請查看軟體安裝程式提供的相依性提示。
下載後可使用系統軟體安裝程式開啟套件。若相依套件無法滿足，請檢查發行版與套件是否相容，不建議強制忽略相依性進行安裝。這些套件名稱中的 arm64 與 aarch64 指的是同類處理器架構。
系統代理、入站與路由參考 →| 檢查項目 | 需求與確認方式 |
|---|---|
| 套件管理系統 | 使用發行版原生支援的 deb 或 rpm 格式；具體系統函式庫需求請以套件中繼資料與安裝程式提示為準。 |
| 處理器架構 | x86_64、amd64 對應 x64；aarch64、arm64 對應 arm64。可在系統資訊中確認。 |
| 桌面環境與權限 | 需要圖形桌面及相應的執行相依套件。應用程式是否讀取系統代理由程式本身決定；使用 TUN 與管理網路介面可能需要額外權限。 |
不同 Linux 桌面環境處理系統代理的方式不盡相同。若客戶端已啟用系統代理，但某個程式仍直接連線，請檢查該程式是否會讀取桌面代理設定，以及是否有自己的代理選項。這類網路接管範圍問題通常無法靠重新安裝相同套件解決。
升級時請維持相同的套件管理方式，避免混用手動複製檔案與系統套件安裝。若保留多個客戶端目錄，請先確認目前執行的執行個體、使用的資料目錄與監聽連接埠，再判斷是否發生設定遺失或連接埠衝突。
安裝、匯入與接管是三個獨立步驟。依序確認可減少將設定問題誤判為安裝檔問題。
依系統與架構安裝，並確認介面能正常開啟。發生錯誤時，先記錄完整提示，分辨系統相容性、相依套件缺失與權限問題；不要一次替換多個元件。
使用有權存取的訂閱或連線資訊，更新後選取要使用的設定。訂閱網址可能包含存取憑證，請勿張貼在公開討論區，也不要連同截圖分享。
桌面系統請先檢查系統代理；Android 則依提示授予 VPN 權限。確認基本連線正常後，再調整分流、DNS 與 TUN；每次只變更一項，並保留可還原的設定。
整理版本選擇、處理器架構、設定相容性與備份的五個常見問題。
初次安裝可先選採用 Avalonia 跨平台介面的桌面版；習慣 Windows 經典介面與操作方式的使用者則可選 WPF 版。兩者都是 v2rayN，介面框架不同不代表連線效能有絕對高下。遷移前請先備份訂閱、路由與自訂設定。
2015 年後推出的主流手機通常可優先選 arm64，但仍須確認系統支援 64 位元應用程式。不確定處理器架構時可選通用版；若出現安裝檔不相容的提示，請檢查系統版本與應用程式架構，不要反覆安裝同一個檔案。
不能預設所有設定都能互換。v2rayNG 採用 Xray 核心，v2flyNG 則採用 V2Fly 核心。一般連線資訊或許可以匯入，但實際支援的協定、傳輸方式與擴充欄位仍取決於核心及客戶端版本，遷移後請重新確認。
客戶端安裝檔不包含可直接使用的連線設定。請準備有權使用的訂閱網址或連線資訊，匯入後選擇有效設定，再設定系統代理或相應的流量接管方式。首次連線建議維持預設 DNS 與路由，確認可用後再逐項調整。
先結束客戶端，使用內建的匯出或備份功能保存訂閱、路由與自訂設定，並確認實際資料目錄。保留原安裝檔與備份；升級後檢查目前設定、系統代理及記錄檔。還原舊版前也要確認資料格式相容性，切勿直接覆蓋唯一的備份。