先選擇作業系統，再選擇處理器架構。桌面裝置使用 v2rayN；Android 裝置建議使用 v2rayNG，也可依設定需求選擇 v2flyNG。
初次使用？查看安裝與設定步驟切換平台後，查看相應的用戶端、安裝格式與系統需求。版本資訊會顯示在用戶端卡片中。
採用新一代跨平台 UI，初次安裝建議選這個版本。
下載桌面版 · x64 ZIP 壓縮檔 · 解壓縮後安裝穩定的傳統 Windows 介面，適合延續原有操作習慣。
下載 WPF 版 · x64 ZIP 壓縮檔 · 解壓縮後安裝Desktop 與 WPF 的差異主要在介面技術和操作版面，並非使用不同的連線協定。兩個版本都需要匯入有效設定；訂閱服務是否可用，與介面版本無關。初次使用可從桌面版開始；若已習慣 WPF，則可繼續使用傳統介面，不必因連線失敗而反覆切換版本。
下載後，先將壓縮檔完整解壓縮至可寫入的資料夾，再執行其中的安裝程式。請勿直接在壓縮檔預覽視窗中啟動程式。若系統提示缺少執行環境，請依提示確認所需元件與架構；不要將其他版本的程式檔混放在目前目錄。
| 檢查項目 | 選擇與需求 | 確認位置 |
|---|---|---|
| 處理器架構 | 本頁的兩個下載連結都是 x64 安裝檔。 | 設定 → 系統 → 系統資訊，查看系統類型。 |
| 系統與執行環境 | 請使用仍受維護的 64 位元 Windows；最低需求以目前安裝程式的提示為準。 | 執行安裝程式，留意相容性或執行環境提示。 |
| 安裝與權限 | 安裝目錄必須可寫入；系統代理與 TUN 的權限需求不同。 | 先以一般權限啟動，只有在啟用需要提高權限的功能時才授權。 |
安裝完成後，先使用系統代理測試瀏覽器連線。TUN 會透過虛擬網卡接管流量，通常需要額外權限；初次啟動不必同時開啟所有流量接管功能。
使用 M 系列晶片的 Mac，請選擇原生 arm64 安裝檔。
下載 Apple Silicon 版 DMG 磁碟映像檔 · arm64若「關於這台 Mac」顯示 Intel 處理器，請選擇 x64 安裝檔。
下載 Intel 版 DMG 磁碟映像檔 · x64開啟蘋果選單中的「關於這台 Mac」，查看「晶片」或「處理器」欄位。M 系列代表 Apple Silicon；若顯示 Intel 型號，則選擇 Intel 版。不要只憑電腦外觀或購買年份判斷，同一產品名稱可能涵蓋不同世代的晶片。
開啟 DMG 後，依視窗說明將應用程式移至「應用程式」資料夾，再從該處啟動。若出現系統安全性提示，請先閱讀提示並確認應用程式來源，再透過系統提供的授權方式處理。不要為了解決單一應用程式的啟動問題而關閉整套系統安全設定。
初次連線時，請分別確認用戶端已啟動、設定已選取，且代理範圍已設定。程式視窗顯示中，不代表系統代理已啟用。更新前請先結束舊程式，避免仍在執行的舊執行個體占用監聽連接埠。
| 檢查項目 | 選擇與需求 | 確認位置 |
|---|---|---|
| 晶片 | Apple Silicon 選 arm64；Intel 選 x64。 | 蘋果選單 → 關於這台 Mac。 |
| 系統相容性 | 請使用仍受維護的 macOS；最低系統需求以目前應用程式的提示為準。 | 「關於這台 Mac」中的系統版本與啟動提示。 |
| 安裝位置 | 將應用程式移至「應用程式」資料夾，並保留可寫入的設定儲存空間。 | Finder → 應用程式。 |
若下載了錯誤架構的安裝檔，請先結束應用程式，再改用符合晶片的版本。不要預設使用轉譯執行，應優先選擇與晶片相符的版本。
2015 年後的主流手機建議優先選用，但仍須確認系統支援。
下載 v2rayNG · arm64 APK 安裝檔 · arm64-v8a不確定裝置架構，或 arm64 安裝檔顯示不相容時，請選擇此版本。
下載 v2rayNG · 通用版 APK 安裝檔 · 多架構v2rayNG 使用 Xray 核心，適合在 Android 裝置上匯入訂閱、設定路由及管理分應用程式代理。核心負責處理連線，用戶端則提供設定介面；下載後仍需要現有的連線參數。協定與傳輸設定應與伺服器端一致，請勿只依協定名稱自行填入其他欄位。
開啟 APK 時，系統可能會要求允許目前使用的瀏覽器或檔案管理員安裝未知應用程式。請只授權實際執行安裝的應用程式。初次啟動 VPN 模式時，請閱讀並確認系統連線要求；此授權用於建立本機流量接管介面，不代表用戶端已自動取得有效訂閱。
需要 v2fly 核心且裝置支援 arm64 時，請選擇此版本。
下載 v2flyNG · arm64 APK 安裝檔 · arm64-v8a適用於無法確認架構，或需要支援更多架構的裝置。
下載 v2flyNG · 通用版 APK 安裝檔 · 多架構v2flyNG 是採用 v2fly 核心的替代用戶端，並非 v2rayNG 的另一種架構安裝檔。請先確認設定功能符合實際需求再選用，不要將兩款應用程式的核心功能視為完全相同。切換應用程式後，請重新檢查訂閱匯入結果、路由規則和代理模式。
移轉前先保存原有的訂閱網址和自訂設定，再於新應用程式中匯入。請勿使用一款應用程式的資料檔直接覆寫另一款的資料目錄。測試兩款應用程式的連線時，只啟動其中一款的 VPN 模式，避免系統切換目前使用的 VPN 而造成誤判。
| 檢查項目 | 選擇與需求 | 確認位置 |
|---|---|---|
| 應用程式架構 | 主流裝置優先選 arm64；無法確認時請選通用版。 | 裝置規格與安裝時的相容性提示。 |
| 系統版本 | 以目前 APK 宣告的最低版本及系統安裝提示為準。 | 設定 → 關於手機 → Android 版本。 |
| 安裝權限 | 安裝來源應用程式必須取得相應授權。 | 系統「安裝未知應用程式」設定。 |
| 連線權限 | VPN 模式需要確認系統連線要求。 | 初次啟動時顯示的系統授權視窗。 |
背景中斷連線與安裝失敗是不同問題。只有確認用戶端在鎖定螢幕後遭系統停止，才需要進一步檢查電池最佳化與背景執行限制，不要一開始就反覆解除安裝應用程式。
適用於使用 deb 套件系統的 Linux 發行版。
下載 deb · x64 arm64 裝置：下載 deb 套件適用於使用 rpm 套件系統的 Linux 發行版。
下載 rpm · x64 arm64 裝置：下載 rpm 套件先確認 Linux 發行版使用的套件格式，再確認處理器架構。deb 與 rpm 代表套件管理格式，與連線功能無關；amd64、x86_64 通常對應本頁的 x64，aarch64 則對應 arm64。檔名中的架構別名不同，不代表是另一款用戶端。
使用發行版的軟體安裝程式開啟下載的套件，並查看相依性與相容性提示。使用相同套件格式，不代表所有發行版版本都符合套件的相依需求。若安裝程式提示函式庫版本不足，請先確認發行版是否受支援；不要略過相依性檢查，也不要混用其他套件格式的安裝檔。
本頁提供圖形介面桌面用戶端。安裝後從應用程式選單啟動，先匯入設定並確認系統代理可用，再視需求考慮使用 TUN。桌面環境套用代理的方式，以及應用程式本身是否讀取系統代理，都會影響流量接管範圍；不能只看用戶端是否啟動，就認定所有程式都已使用代理。
| 檢查項目 | 選擇與需求 | 確認位置 |
|---|---|---|
| 套件格式 | 依發行版選擇 deb 或 rpm，並確認符合安裝程式的相依需求。 | 發行版的軟體中心與系統說明。 |
| 處理器架構 | x64 與 arm64 請使用對應的安裝檔。 | 系統設定中的裝置或處理器資訊。 |
| 執行環境 | 需要圖形桌面環境，以及可寫入的使用者設定目錄。 | 桌面工作階段與軟體安裝程式的相依性提示。 |
透過套件管理員完成升級後，請結束並重新啟動用戶端，再於「關於」頁面確認實際執行版本，避免繼續使用仍留在背景中的舊程序。
安裝成功只是準備工作。依照以下順序檢查，有助於分開處理安裝問題與設定問題。
先開啟用戶端，找到設定與「關於」頁面，記下用戶端名稱、實際執行版本和系統版本。若程式立即關閉，應先處理架構、執行環境、安裝路徑或權限提示，此時不要反覆修改訂閱。
訂閱是用來批次取得連線設定的連結。將連結貼到訂閱群組並儲存，接著執行更新，再確認清單中是否出現連線設定。連結可能包含存取憑證，請勿在公開截圖、求助貼文或共用記錄檔中貼出完整網址。
選取一筆設定，確認代理模式與路由預設值後啟動連線。先用瀏覽器實際測試一次，再檢查其他應用程式。延遲測試結果只反映特定測試目標與方式，不能取代實際連線驗證。
先備份再更新。保存訂閱網址、自訂路由、分應用程式代理清單，以及手動新增的設定。建議使用用戶端提供的匯出功能；匯出的檔案可能包含存取憑證，請儲存在可信任的本機位置。升級用戶端與更新訂閱是兩回事；更新程式不會自動延長服務期限或修復失效的服務設定。
更新前先停止連線並結束舊的執行個體，再執行安裝程式。若需變更安裝位置，請勿將新舊程式混放在同一個資料夾。重新啟動後，確認設定是否保留、監聽連接埠是否變更，以及系統代理是否恢復；先測試基本連線，再逐一還原自訂功能。
若更新後出現異常，請記下問題發生的步驟和完整錯誤訊息。程式能啟動但無法連線時，先檢查設定和模式；完全無法啟動時，再排查程式環境。依問題出現的階段逐項檢查，比同時更改多項設定更容易找出原因。
先確認問題發生在下載、安裝、啟動或連線階段，再依相應步驟處理。
還需要有效的連線設定。安裝檔只包含用戶端程式，不含可直接使用的服務設定。匯入現有的訂閱連結或設定檔，更新清單並選取設定後，再啟動代理。初次使用請依照入門指南選擇模式並確認連線。
2015 年後的主流手機可優先嘗試 arm64，但仍應以裝置支援的應用程式架構為準。若系統提示架構不相容，或無法確認裝置規格，再選通用版。通用版支援較多架構，檔案通常也較大；同一用戶端的兩種安裝檔不必同時安裝。
不需要。Desktop 採用新一代跨平台介面，WPF 則使用傳統 Windows 介面，兩者都屬於 v2rayN。初次使用建議選桌面版；習慣傳統版面時可選 WPF 版。切換前先備份設定並關閉原程式，避免兩個執行個體同時占用本機代理連接埠。
先使用用戶端的備份或匯出功能，另外保存訂閱網址與自訂路由，再停止連線並結束程式。更新時使用與原用戶端相同的應用程式和架構。若要改用另一款用戶端，請勿直接覆寫其資料目錄，應使用兩款應用程式都支援的匯入方式移轉設定。
版本資訊取自應用程式的版本資料，下載按鈕則指向特定架構的安裝檔，兩者可能分批更新。確認已安裝版本時，請以用戶端的「關於」頁面為準。若要排查相容性問題，也請記下已安裝版本、系統版本和安裝檔類型，方便比對。
先區分程式啟動失敗或連線失敗。程式無法開啟時，檢查架構、解壓縮位置、系統提示與執行環境；程式可開啟但無法連線時，檢查訂閱更新結果、選取的設定、系統時間與代理模式，再查看記錄檔。請勿反覆更換安裝檔來取代設定排查。