客戶端安裝檔 / 平台與架構
桌面端選擇 v2rayN；Android 裝置建議優先選擇 v2rayNG，如有使用 V2Fly 核心的需求，也可選擇 v2flyNG。請先確認作業系統，再選擇處理器架構。
v2rayN 提供 Desktop 與經典 WPF 兩種介面。本頁提供的兩個下載項目皆為 x64 安裝檔。
Desktop 是新一代跨平台 UI。適合初次安裝，或希望在不同桌面系統上維持相近操作體驗的使用者。伺服器清單、訂閱群組與參數設定仍須在首次啟動後逐一確認；切換介面不代表已自動連線。
WPF 是經典穩定版。適合熟悉傳統 Windows 操作介面的使用者。選擇時應考量介面與操作習慣，而非節點協定名稱；能否使用特定協定，仍取決於所選核心是否與伺服器設定相符。
兩個下載檔都是 ZIP 壓縮檔。下載完成後，請先解壓縮至獨立資料夾，再開啟其中的安裝程式；不要直接從壓縮檔預覽視窗執行。資料夾路徑盡量保持簡短，並避免放在會定期清除的暫存目錄中。
| 檢查項目 | 本頁安裝檔適用範圍 | 操作建議 |
|---|---|---|
| 處理器 | x64，適用於 64 位元 Intel / AMD 環境 | 請在系統資訊中確認架構；其他架構請勿直接使用本頁的 x64 安裝檔。 |
| 作業系統 | 建議使用仍持續接收安全性更新的 Windows 10 / 11 | 最低版本需求請以所選安裝程式的提示為準；舊版系統需另外確認相容性。 |
| 執行元件 | Desktop 與 WPF 可能需要不同的相依元件 | 若提示缺少執行元件，請依安裝程式標示的元件名稱處理，不要任意複製動態連結程式庫。 |
| 權限 | 系統代理與 TUN 的權限需求不同 | 先完成一般代理設定；只有在啟用 TUN 等功能時，才依客戶端提示授予權限。 |
使用 v2rayN 的 DMG 安裝檔。Apple Silicon 與 Intel 各有原生架構版本可供下載。
開啟 Apple 選單中的「關於這台 Mac」。若顯示「晶片」並列出 Apple M 系列名稱，請選擇 Apple Silicon；若顯示 Intel 處理器，請選擇 Intel。購買年份僅供參考，晶片名稱才是選擇安裝檔的依據。
開啟 DMG 後，將 v2rayN 拖曳至「應用程式」資料夾，再從該資料夾啟動。請勿長期從掛載的磁碟映像檔執行，以免卸載映像檔或更新時弄錯程式位置。
首次啟動若出現無法驗證開發者的提示，請先確認要開啟的應用程式來源與名稱，再前往系統設定的「隱私權與安全性」查看相關提示。不要為了啟動單一應用程式而關閉整體系統安全防護。
| 檢查項目 | 適用範圍 | 操作建議 |
|---|---|---|
| Apple Silicon | Apple M 系列晶片，arm64 安裝檔 | 建議優先使用與晶片相符的原生安裝檔，不必只為了安裝客戶端而選擇轉譯執行。 |
| Intel | Intel 處理器，x64 安裝檔 | 請在「關於這台 Mac」查看處理器名稱，勿在 Intel 裝置上使用 arm64 安裝檔。 |
| 系統版本 | 須符合目前 DMG 中應用程式所宣告的最低系統版本 | 安裝舊版 macOS 前，請先確認相容性；架構正確不代表系統版本一定符合需求。 |
| 應用程式位置 | 建議安裝至「應用程式」資料夾 | 安裝完成後請退出磁碟映像檔，並從固定的應用程式位置啟動及更新。 |
建議優先選擇使用 Xray 核心的 v2rayNG；有明確的 V2Fly 核心需求時，再選擇 v2flyNG。
v2rayNG 適合需要在 Android 裝置上匯入訂閱、管理伺服器及設定應用程式代理範圍的使用者。使用 VLESS、REALITY 等設定時，請一併確認分享參數與客戶端內建核心是否支援，不能只看伺服器名稱判斷相容性。
2015 年後推出的主流手機可優先選擇 arm64，但部分裝置的系統仍可能只支援其他應用程式架構。無法確認時可選擇通用版；通用版包含多種架構，下載檔通常較大，實際大小請以檔案資訊為準。
卡片上的版本文字與安裝檔檔名使用不同的發佈欄位。若要確認實際建置版本，請查看下載檔名及安裝後的「關於」頁面；不要只依上方版本文字推斷特定架構安裝檔的建置編號。
v2flyNG 使用 V2Fly 核心，適合設定明確以此核心為目標的情況。它是獨立客戶端，不是 v2rayNG 的佈景主題，也不是只憑名稱就能互換的安裝檔。兩者的資料目錄與部分設定需分開管理。
架構選擇方式與 v2rayNG 相同：先確認裝置支援的應用程式架構，再選擇 arm64 或通用版。若設定使用 REALITY 等 Xray 功能，請勿因介面相似就直接匯入；應先確認設定所需的協定與安全層。
從其他 Android 客戶端遷移時，建議重新匯入訂閱或相容的分享連結。請另外檢查應用程式分流、路由及 DNS 設定，不要假設匯入伺服器後這些選項也會一併同步。
| 檢查項目 | 適用範圍 | 操作建議 |
|---|---|---|
| arm64 | 支援 arm64-v8a 應用程式的系統 | 可優先考慮 2015 年後推出的主流手機，實際支援架構仍以系統資訊為準。 |
| 通用版 | 包含多種應用程式架構 | 架構不明時可選擇通用版；通用版無法略過應用程式本身的最低系統需求。 |
| 系統版本 | 須符合所選 APK 宣告的最低 Android 版本 | 若解析失敗，請分別檢查系統版本、架構及檔案是否下載完整。 |
| 連線權限 | VPN 模式需要取得系統 VPN 授權 | 確認應用程式後再授權；若使用僅代理模式，應用程式須自行連線至本機代理連接埠。 |
| 背景執行 | 各裝置系統的電池與背景執行限制不同 | 只有在鎖定螢幕後發生斷線時，才依裝置設定調整該客戶端的背景執行權限。 |
不確定 Android 端該選哪種核心？請參閱 三款客戶端差異，再決定是否需要 v2flyNG。
v2rayN 提供 deb 與 rpm 格式。請先依發行版使用的套件管理系統選擇格式，再選擇 x64 或 arm64 架構。
Debian、Ubuntu 及相關發行版通常使用 deb；Fedora、RHEL 及相關發行版通常使用 rpm。套件格式相同只表示套件管理系統相近，不保證系統程式庫版本與目前套件完全相容。
檔名中的 amd64 與 x86_64 都用來標示 x64 架構；arm64 與 aarch64 則對應 64 位元 ARM 環境。即使裝置同為 64 位元，也不可跨架構安裝。
本頁提供圖形化桌面客戶端。安裝後請從應用程式選單啟動，並在桌面工作階段中設定代理。僅有命令列環境的伺服器不適用此圖形化安裝流程；設定欄位可另行參閱文件，無須在此尋找獨立的核心套件。
| 檢查項目 | 適用範圍 | 操作建議 |
|---|---|---|
| 套件格式 | deb 或 rpm | 請依目前發行版使用的套件管理系統選擇，不要直接將一種格式重新命名成另一種格式。 |
| 處理器 | x64 與 arm64 各有對應安裝檔 | 請以系統識別的架構為準，僅憑裝置外觀或處理器位元數不足以判斷。 |
| 桌面環境 | 需要可執行圖形化應用程式的桌面工作階段 | 代理設定是否會被應用程式採用，也取決於桌面環境與應用程式本身的設定。 |
| 相依套件與系統程式庫 | 須符合目前套件宣告的相依條件 | 請由套件管理員檢查；安裝失敗時記下具體的相依套件名稱，不要直接強制安裝。 |
安裝檔只提供客戶端；伺服器參數、訂閱內容與代理範圍需另外設定。
安裝前請準備有權使用的訂閱連結、分享連結或設定檔。訂閱通常是用來更新一組伺服器的入口，不等同於單一伺服器網址。匯入後請確認群組已顯示、設定欄位完整，再選擇一台使用中的伺服器。伺服器清單中出現項目，不代表系統代理已啟用。
桌面端可先使用系統代理模式，Android 端則依客戶端提示授予 VPN 權限。若應用程式需要手動填入代理位址，請使用客戶端顯示的本機監聽位址與連接埠，不要將遠端伺服器連接埠當成本機代理連接埠。操作順序請參閱 快速入門教學。
更新同一款客戶端前，請先保存訂閱網址、手動新增的設定、自訂路由與 DNS 設定。若客戶端提供匯出或備份功能，請優先使用。切換 Desktop 與 WPF，或從一款 Android 客戶端遷移至另一款時，不要假設所有設定都會自動沿用。
安裝後先確認使用中的伺服器、路由模式與本機監聽連接埠，再還原應用程式分流或 TUN 等額外設定。若遇到問題，每次只調整一個選項，並查看記錄中的具體錯誤。訂閱網址與匯出的設定可能含有存取憑證，請勿放入公開截圖、共用文件或公開討論內容。
先排除套件類型與架構問題，再處理設定與代理模式。
第一次安裝可先選 Desktop，使用新一代跨平台介面；熟悉經典 Windows 介面與操作方式的使用者，則可選擇穩定的 WPF 經典版。兩者都要在首次啟動後確認使用中的伺服器、路由及系統代理設定；切換前請先備份訂閱與設定。
2015 年後推出的主流手機可優先嘗試 arm64，但仍應以系統支援的應用程式架構為準。通用版包含多種架構，適合無法確認架構或需要相容其他裝置的情況。若安裝時提示套件不相容，請先確認架構與系統版本，避免反覆覆蓋安裝。
安裝檔只提供圖形化客戶端，不含可直接使用的伺服器設定。請準備有權使用的訂閱連結、分享連結或設定檔；匯入後選擇使用中的伺服器，再依需求設定系統代理或 VPN 模式。
請先保存訂閱網址、手動新增的伺服器設定、自訂路由及 DNS 設定。使用客戶端提供的匯出或備份功能，並記下目前的代理模式。跨客戶端遷移時，優先使用相容的訂閱或分享連結，避免直接覆蓋另一款客戶端的資料目錄。
卡片上的版本文字與各架構安裝檔檔名來自不同的發佈欄位，更新時間可能不一致。選擇時請先確認客戶端、作業系統與架構；若要確認實際建置版本，請查看下載檔名及安裝後的「關於」頁面，不要只依卡片上的版本文字判斷特定安裝檔的建置編號。