v2rayN
推薦Desktop 是新一代跨平台 UI，適合初次安裝及跨桌面系統使用；WPF 是經典穩定版，適合延續既有操作習慣。先選擇介面，再匯入設定；兩種介面不必同時執行。
下載後會取得 ZIP 壓縮檔。請先完整解壓縮，再執行檔案中的安裝程式；不要直接從壓縮檔預覽視窗啟動。
圖形化用戶端 · 安裝檔選擇
V2Ray 用戶端下載
V2Ray 用戶端下載
v2rayN 與 Android 用戶端
先選作業系統，再選處理器架構。桌面使用 v2rayN，Android 優先選 v2rayNG，v2flyNG 則作為核心相容性的備選。
三款用戶端皆為免費開源軟體。安裝完成後，仍須匯入有效的訂閱或伺服器設定。
Windows 安裝檔
同一款用戶端，提供兩種介面。以下下載連結皆為 x64 安裝檔。
系統與安裝條件
| 檢查項目 | 選擇與需求 | 查看位置 |
|---|---|---|
| 作業系統 | 建議使用仍提供安全性更新的 Windows；最低版本請以目前安裝程式的提示為準。 | 設定 → 系統 → 系統資訊 |
| 處理器架構 | 本頁提供 x64 安裝檔，安裝前請確認系統類型與應用程式相容。 | 系統資訊 → 系統類型 |
| 執行環境 | 若提示缺少執行階段，請依該安裝檔的需求補齊相應環境後再試。 | 安裝與啟動提示 |
安裝目錄請選擇具備讀寫權限的位置，避免長期將設定留在下載暫存資料夾。首次啟動後，先確認主視窗能正常開啟，再匯入訂閱。系統代理會影響讀取系統代理設定的應用程式，但不代表所有程式都會自動使用代理；若要接管其他應用程式，請先了解權限與路由影響，再另行設定 TUN 模式。
從 WPF 切換至 Desktop 前，請先使用用戶端的匯出功能儲存設定，並記下本機監聽連接埠、訂閱群組及路由方案。不要直接用另一個分支的程式覆蓋原目錄。關閉舊用戶端後再啟動新用戶端，可避免監聽連接埠遭占用，也能減少系統代理被兩個程序輪流修改的情況。
macOS 磁碟映像檔
請在「關於這台 Mac」查看晶片資訊，不要依電腦外觀或購買年份判斷。
v2rayN
推薦Apple M 系列晶片請選 Apple Silicon；顯示 Intel 處理器時請選 Intel 安裝檔。優先使用符合本機架構的版本，可減少額外相容層造成的啟動與執行差異。
開啟 DMG 後，將應用程式複製到「應用程式」資料夾，再從該資料夾啟動；複製完成後可退出磁碟映像檔。
系統與安裝條件
| 檢查項目 | 選擇與需求 | 查看位置 |
|---|---|---|
| 系統版本 | 請使用仍提供安全性更新的 macOS；最低相容版本以應用程式提示為準。 | Apple 選單 → 關於這台 Mac |
| 晶片架構 | Apple M 系列使用 arm64；Intel 使用 x64。 | 關於這台 Mac → 晶片或處理器 |
| 網路權限 | 修改代理設定或啟用網路接管時，請依系統提示確認授權內容。 | 系統設定 → 網路 |
首次啟動若出現系統安全性提示，請先確認檔案來源、所選架構及提示內容，再前往「隱私權與安全性」查看是否有允許開啟的選項。不要為了啟動單一應用程式而關閉整個系統的安全機制；若系統明確指出檔案損毀或不相容，重新下載符合架構的安裝檔，比反覆修改權限更合適。
設定系統代理後，可在目前網路服務的代理設定中確認位址與連接埠是否符合用戶端設定。切換網路、從睡眠喚醒或退出用戶端後，若瀏覽器無法連線，請先檢查是否留下失效的本機代理。日常使用請透過用戶端選單退出；更新前也應先關閉舊程序，再替換「應用程式」中的檔案。
Android 安裝檔
先確認架構，再檢查核心相容性。2015 年後的主流手機通常優先選擇 arm64。
v2rayNG
首選 · Xray 核心Android 首選圖形化用戶端。訂閱管理、節點選擇與連線操作都在應用程式內完成；使用 VLESS、REALITY 等設定時，還須確認伺服器參數及目前核心是否支援。
應用程式顯示的版本資訊與個別安裝檔名稱可能暫時不同；請以所選檔案及安裝後「關於」頁面顯示的執行版本為準。
v2flyNG
備選 · V2Fly 核心適用於既有設定依賴 V2Fly 行為的情境。這不是 v2rayNG 的介面主題，兩者採用的核心路線與設定支援範圍不同。匯入前請確認協定、傳輸及安全性欄位，不要直接照搬另一款用戶端的所有進階設定。
系統與安裝條件
| 檢查項目 | 選擇與需求 | 查看位置 |
|---|---|---|
| 系統相容性 | 最低 Android 版本依所選 APK 而異，請以安裝程式提示為準。 | 設定 → 關於手機 → Android 版本 |
| 裝置架構 | 2015 年後的主流手機通常選 arm64；舊裝置或不確定架構時選通用版。 | 裝置資訊或處理器製造商規格 |
| 必要授權 | 安裝時允許目前來源安裝應用程式；連線時確認系統 VPN 要求。 | 應用程式安裝程式與系統 VPN 對話方塊 |
年份僅供初步判斷。部分裝置雖採用 64 位元處理器，系統仍可能使用不同的應用程式執行環境，最後應以裝置資訊與安裝結果為準。出現「應用程式未安裝」時，先檢查剩餘空間、檔案是否下載完整，以及是否與同名應用程式發生簽章衝突。不要把所有安裝錯誤都歸因於處理器架構。
首次連線時會出現系統 VPN 授權提示。授權建立的是本機流量接管入口，不代表已成功連上伺服器。測試時請只讓一個需要占用系統 VPN 通道的應用程式執行；若切換至背景後連線中斷，再依裝置製造商的電池管理設定檢查背景限制，不必一開始就開放所有權限。
Linux 軟體套件
依發行版的套件管理系統選擇 deb 或 rpm，再確認 x64 或 arm64。
v2rayN
推薦Linux 桌面版提供圖形化設定介面。Debian、Ubuntu 系通常使用 deb；Fedora、RHEL 系通常使用 rpm。套件格式只是第一步，相同格式在不同發行版上仍可能受執行程式庫版本差異影響。
amd64、x86_64 對應此處的 x64；aarch64 對應 arm64。檔名若標示發行版，請再確認目標系統符合相依套件需求。
系統與安裝條件
| 檢查項目 | 選擇與需求 | 查看位置 |
|---|---|---|
| 桌面環境 | 需要可執行圖形應用程式的桌面工作階段。 | 系統設定 → 關於 |
| 套件格式與架構 | deb / rpm 須符合發行版，x64 / arm64 須符合處理器。 | 系統資訊與圖形化套件管理員 |
| 相依套件與權限 | 由套件管理員檢查相依套件；網路接管所需的額外權限，依功能需求設定。 | 軟體安裝程式提示與用戶端設定 |
按兩下套件後，使用發行版的圖形化軟體安裝程式查看相依套件與安裝結果。若提示相依套件版本不足，不要強制忽略；請先確認安裝檔適用的發行版及目前系統版本。安裝成功卻無法啟動時，記下錯誤訊息中的程式庫名稱與版本，再到故障排除頁查找原因；重複安裝通常無法解決相依條件不符的問題。
Linux 的系統代理設定取決於桌面環境，不同應用程式讀取代理設定的方式也可能不同。瀏覽器可用、其他程式卻無法連線時，先檢查各應用程式自己的網路設定。不要為了使用一般代理功能而長期以高權限啟動整個圖形化用戶端；TUN 等功能所需權限應依用戶端說明另行設定。
安裝 → 匯入設定 → 選擇節點 → 驗證代理
- 啟動與權限
先確認應用程式能正常開啟。系統代理、VPN 或網路接管所需的授權，僅在啟用相應功能時處理；安裝成功不代表必須預先開放所有權限。
- 訂閱與節點
匯入有效的訂閱網址或伺服器設定，確認用戶端能辨識協定與傳輸欄位。用戶端本身不提供帳號、訂閱或連線線路。
- 連線與驗證
選擇一個節點實際測試連線，再啟用所需的代理模式。使用瀏覽器確認連線結果，並搭配記錄判斷問題發生在解析、交握或路由階段。
系統代理路由規則DNS
更新與設定遷移
更新前保留可還原的設定，更新後先進行小範圍測試。
匯出設定時，請確認備份包含訂閱群組、自訂路由、本機連接埠及應用程式偏好設定。部分資料可能儲存在獨立檔案中，不能只複製主程式。備份可能包含訂閱網址與伺服器識別資訊，請存放在個人可控的位置，不要貼到公開討論區，也不要將完整設定截圖當作一般錯誤回報的附件。
安裝新版前請先退出正在執行的用戶端。桌面系統也應查看系統匣或選單列，確認背景程序已結束；Android 覆蓋安裝時則應保留原應用程式資料。跨安裝來源更新可能受簽章限制，跨介面或跨核心遷移也可能遇到設定欄位差異。若發生衝突，先儲存原設定再決定是否重新安裝，不要直接清除資料嘗試。
更新完成後，先確認「關於」頁面的執行版本，再選擇一份已知可用的設定測試連線。確認系統代理位址、監聽連接埠與路由方案沒有意外變更後，再恢復自動訂閱更新。若問題只在新版出現，可記下系統、架構、套件名稱及錯誤提示，依故障排除流程逐項檢查。
下載與安裝常見問題
先分辨套件選擇錯誤、系統安裝限制與連線設定問題。
Windows 桌面版與 WPF 版該選哪一個？
初次使用建議選擇 Desktop 桌面版，採用新一代跨平台介面。習慣經典介面或已有 WPF 使用流程時，可選擇經典穩定的 WPF 版。兩者差異在介面方案，與節點服務或網路線路無關。遷移前先匯出設定，避免直接混用程式目錄。
怎麼判斷該下載 arm64 還是 x64？
Windows 可在「設定」的系統資訊中查看系統類型；Mac 可在「關於這台 Mac」查看晶片，Apple M 系列選 Apple Silicon，Intel 處理器選 Intel；Linux 則查看系統資訊中的硬體架構。Android 可在裝置資訊確認處理器，2015 年後的主流手機通常優先選 arm64，不確定時選通用版。
Android 顯示無法安裝，需要先解除安裝舊版嗎？
先確認儲存空間、系統安裝權限及安裝檔架構。若已有同名應用程式，也要留意簽章來源不同或目前安裝的是較舊版本。不要直接解除安裝；先匯出設定並確認備份可用，再依實際錯誤訊息處理。不同來源的安裝檔不一定能直接覆蓋安裝。
安裝用戶端後，為什麼還是無法連線？
用戶端只提供設定管理與流量轉送功能，不包含節點服務。請匯入有效的訂閱或伺服器設定，選擇節點並啟動連線，再確認系統代理或 VPN 授權是否生效。仍無法連線時，依序檢查節點是否可用、路由設定及 DNS。
更新用戶端會保留訂閱和路由設定嗎？
一般覆蓋更新通常會保留應用程式資料，但更換介面分支、安裝來源或主要版本時，不能假設設定完全相容。更新前請從用戶端匯出設定，記下訂閱群組、路由方案及本機連接埠。更新後先測試一個節點，再恢復自動更新與自訂路由。
版本資訊與安裝檔名稱不一致時，該怎麼判斷？
版本資訊來自應用程式層級的更新資料，個別安裝檔則有自己的檔名，兩者可能暫時不同。下載時請確認所選平台、架構與實際檔名，安裝後在用戶端「關於」頁面查看執行版本。不要手動修改下載網址中的數字來猜測其他安裝檔。