桌面平台選 v2rayN，Android 優先選 v2rayNG。先確認作業系統與處理器架構，再下載對應的安裝檔。
本頁提供 x64 安裝檔。請先前往「設定 → 系統 → 系統資訊」查看系統類型。
桌面版 Desktop 採用新一代跨平台 UI；經典 WPF 版保留 Windows 傳統介面，適合想延續既有操作習慣的使用者。初次安裝可從桌面版開始，熟悉 WPF 的使用者也可繼續選擇經典版。
將壓縮檔解壓縮至可寫入的資料夾，並保留解壓縮後的檔案結構；請勿直接在壓縮軟體的預覽視窗中執行程式。若安裝時提示缺少執行環境，請依安裝程式說明處理；實際相依項目以目前安裝檔的需求為準。一般系統 Proxy 通常不需要管理員權限；準備啟用 TUN 時，再依用戶端提示處理所需權限。
首次開啟後，先匯入訂閱並更新伺服器清單，選取有效設定，再設定路由與系統 Proxy。暫時不要同時加入 TUN、自訂 DNS 等設定。先確認基本連線正常，較容易區分安裝問題與設定問題。
| 檢查項目 | 本頁安裝檔需求 | 確認方式 |
|---|---|---|
| 處理器架構 | 64 位元 x64 環境 | 在系統資訊中查看「系統類型」，不要只依電腦品牌判斷。 |
| 系統與執行環境 | 請使用仍受支援的 Windows；最低版本與相依項目以安裝程式要求為準。 | 先完成系統更新；若出現相依項目提示，請記下完整內容。 |
| 檔案與權限 | 可寫入的安裝資料夾；TUN 可能需要額外權限。 | 完整解壓縮，初次測試先使用一般系統 Proxy。 |
安裝成功不代表伺服器已可使用。訂閱網址失效、設定過期或路由選錯，都需要在設定階段分別排查。接著閱讀 v2rayN 安裝與匯入訂閱教學。
在 Apple 選單的「關於這台 Mac」查看晶片資訊，再選擇 Apple Silicon 或 Intel。
macOS 使用 v2rayN 跨平台桌面介面。兩種 DMG 分別對應不同處理器，不必同時安裝；晶片名稱為 Apple M 系列時選 arm64，顯示 Intel 處理器時選 x64。
開啟 DMG 後，將應用程式拖曳至「應用程式」資料夾，再從該資料夾啟動。請勿長期直接執行磁碟映像檔中的應用程式，否則容易混淆後續更新、路徑紀錄與權限管理。若系統提示無法驗證開發者，請先確認應用程式來源與下載過程，再前往「系統設定 → 隱私權與安全性」查看此次遭封鎖項目的處理方式。
不建議只為了啟動一次就關閉整套系統安全機制。若應用程式提示檔案損毀、架構不符或系統版本過舊，請先辨別具體原因，不要將所有啟動失敗都視為權限問題。是否需要網路權限或 TUN 相關授權，請以系統和用戶端實際要求為準，只授予目前功能所需的權限。
| 檢查項目 | 選擇依據 | 安裝提醒 |
|---|---|---|
| Apple Silicon | 「關於這台 Mac」顯示 Apple M 系列晶片。 | 下載 arm64 DMG，移至「應用程式」資料夾後啟動。 |
| Intel | 「關於這台 Mac」顯示 Intel 處理器。 | 下載 x64 DMG，避免混用其他架構。 |
| 系統與權限 | 最低系統版本請以應用程式啟動提示與發行需求為準。 | 查看「隱私權與安全性」中的封鎖紀錄，並依需求授予網路權限。 |
從其他桌面系統遷移時，請先匯出訂閱與路由設定，再檢查本機路徑、監聽連接埠與 Proxy 方式；不要直接照搬特定系統的路徑。若遇到啟動封鎖，可參閱 macOS 權限放行與網路授權步驟。
優先選擇 v2rayNG；若需要 v2fly 核心生態系，再考慮 v2flyNG。
v2rayNG 使用 Xray 核心，透過 Android 的 VpnService 接管裝置流量。若要匯入 VLESS、REALITY 等設定，也應確認目前用戶端與設定欄位相容；不能只看協定名稱判斷是否可用。
版本資訊與各平台檔案路徑分別來自下載清單，可能暫時不同步；安裝後請在用戶端「關於」頁面確認實際版本，不要手動修改檔案網址。
v2flyNG 適用於 v2fly 核心生態系。若現有設定明確依賴這套核心，可將它列為備選；不同核心的功能不一定完全相同，匯入前請確認傳輸方式與擴充參數。
| 檢查項目 | 需求或選擇依據 | 處理方式 |
|---|---|---|
| 應用程式架構 | arm64 需要裝置系統支援相應的應用程式架構。 | 無法確認時請選通用版；不要只依處理器型號判斷。 |
| 系統相容性 | 最低系統版本請以 APK 安裝提示及目前應用程式需求為準。 | 安裝時顯示不相容，請一併檢查系統版本與架構。 |
| 安裝來源 | 瀏覽器或檔案管理員可能需要個別授予安裝權限。 | 只授權給此次使用的應用程式；安裝完成後可關閉此權限。 |
| 連線權限 | 首次啟動連線時，需確認系統顯示的 VPN 連線要求。 | 避免同時執行其他會占用 VPN 通道的應用程式。 |
下載完成後，從系統下載清單開啟 APK。若提示與已安裝應用程式的簽章衝突，請先停止安裝並備份舊設定，不要為了覆蓋安裝就立刻清除資料。安裝成功後匯入訂閱、選取設定，再確認系統跳出的 VPN 連線要求。
初次測試時，先保持簡單的個別應用程式規則。若鎖定螢幕後經常斷線，再檢查電池最佳化、背景執行與自動啟動權限，而不是反覆重新安裝。詳細步驟請見 v2rayNG 個別應用程式 Proxy 與省電白名單設定。
先確認發行版使用的套件格式，再選擇 x64 或 arm64。此處提供圖形用戶端安裝檔。
Linux 使用 v2rayN 跨平台桌面介面。Debian、Ubuntu 等發行版通常選 deb；Fedora、RHEL 系列發行版通常使用 rpm。副檔名相同不代表所有發行版都符合相依需求，安裝前仍需查看發行版版本與套件管理工具的提示。
下載後使用發行版內建的軟體安裝程式開啟安裝檔，並留意架構與相依項目檢查。若圖形安裝程式提示相依項目不符，請先確認目前發行版是否適用此套件；不要強制略過相依檢查繼續安裝。名稱相近的發行版也可能使用不同版本的系統函式庫。
在系統「關於」或硬體資訊中查看處理器架構：x86_64 通常對應本頁的 x64 套件，aarch64 通常對應 arm64 套件。amd64 是 x64 架構常見的套件標記，並不限定處理器品牌。若選錯架構，請重新選擇安裝檔，不要修改檔名。
| 檢查項目 | 需求或選擇依據 | 安裝提醒 |
|---|---|---|
| 桌面環境 | 可執行圖形應用程式的 Linux 桌面工作階段。 | 本頁並非為純命令列伺服器提供的部署入口。 |
| 套件格式 | 依發行版選擇 deb 或 rpm。 | 仍需透過套件管理工具確認系統函式庫與其他相依項目。 |
| 處理器架構 | x86_64 選 x64；aarch64 選 arm64。 | 確認系統實際架構，避免使用不相符的安裝檔。 |
| Proxy 與權限 | 系統 Proxy 的支援情況取決於桌面環境。 | 先測試應用程式 Proxy，再依需求設定 TUN 權限。 |
部分應用程式不會自動讀取桌面環境的系統 Proxy，因此「用戶端能啟動」不等於「所有應用程式都使用 Proxy」。請先確認本機監聽與一般 Proxy 可正常使用，再參考 進階設定手冊 設定路由、DNS 與 TUN。
安裝檔只包含用戶端程式。訂閱、路由與系統 Proxy 都需要分別設定，依序操作更容易找出問題。
設定來源
向有權使用的服務或自架環境取得訂閱連結，匯入後執行更新。連結包含存取憑證，請勿公開貼在截圖、留言或求助紀錄中。若伺服器清單空白，先檢查連結是否有效，再確認訂閱請求能否完成。
查看訂閱匯入教學 →基本設定
選好伺服器後，先啟用常用路由預設與一般系統 Proxy，其他設定盡量維持預設值。Android 請先確認 VPN 連線要求。不要一開始就同時修改 DNS、路由與 TUN，否則發生問題時難以判斷原因。
閱讀路由與 TUN 設定 →確認結果
能安裝卻無法連線，通常需要檢查訂閱參數、伺服器狀態或 Proxy 設定，而非重新下載。只有在安裝程式無法開啟、架構不相容或缺少相依項目時，才優先回頭檢查安裝環節。記下完整錯誤訊息，比反覆更換安裝檔更有效。
查看常見問題 →更新前先記下目前的用戶端、安裝方式與設定位置。匯出訂閱群組、自訂路由及必要設定，再結束正在執行的程式。備份可能含有伺服器網址與驗證資訊，請存放在自己能控管的位置；遷移完成後，及時處理多餘的副本。
使用系統安裝程式或套件管理工具更新時，請先閱讀目前的安裝提示。若準備從桌面版切換至 WPF，或從 v2rayNG 切換至 v2flyNG，請視為設定遷移：確認新用戶端能匯入所需欄位，逐項核對路由與 DNS，不要假設每個選項都能完全對應。
更新完成後，先開啟用戶端的「關於」頁面確認實際版本，再測試訂閱更新與常用連線。卡片上的版本資訊來自下載清單，安裝檔名稱則由各平台的實際檔案決定；資訊與檔名暫時不同時，不要自行修改網址來拼湊其他安裝檔。
若應用程式結束後瀏覽器無法正常連線，請先確認系統 Proxy 是否仍指向已關閉的本機連接埠。還原系統 Proxy 後再啟動用戶端，並確認連接埠未被其他程式占用。解除安裝前也應先停用 Proxy 與相關連線模式，避免將殘留設定誤認為網路故障。
用戶端會讀取設定並建立連線，安裝檔不含可用的伺服器設定。請自行準備有權使用的訂閱連結或單一伺服器參數。安裝完成後匯入設定，再選擇伺服器與路由模式；本頁下載入口不提供訂閱服務。
初次安裝可先選桌面版 Desktop，採用新一代跨平台介面。若已熟悉 Windows 經典介面，或想延續原有操作習慣，可選擇經典穩定的 WPF 版。兩者都是 v2rayN；安裝或遷移前請先備份設定，並避免同時啟動兩個執行個體接管系統 Proxy。
2015 年後推出的主流手機通常可優先選擇 arm64，但仍應以裝置支援的應用程式架構為準。若無法確認架構，或裝置只能執行其他架構的應用程式，請選擇通用版。若安裝時顯示不相容，也要檢查系統版本；通用版無法解決所有系統相容性問題。
卡片上的版本號來自下載清單的 latest 欄位，按鈕則使用各平台的實際檔案路徑，兩者可能尚未同步。確認安裝版本時，請以用戶端「關於」頁面顯示的版本為準。請勿手動修改下載網址中的版本號；需要更新時，重新使用本頁對應的下載入口。
先結束舊版用戶端並備份設定，再依安裝程式指示更新；是否需要解除安裝，取決於安裝方式與套件管理工具的要求。若遇到簽章衝突、套件衝突或準備更換用戶端，請勿直接刪除應用程式資料。先確認備份可還原，再處理舊版安裝；更新後檢查訂閱、路由與系統 Proxy。