v2rayN
Desktop 桌面版／經典 WPF 版
Desktop 桌面版採用新一代跨平台 UI，適合初次使用，或希望在不同桌面系統間維持相近操作習慣的使用者。WPF 版是經典穩定版，保留熟悉的桌面配置；若已習慣這套介面與操作方式，可繼續選用此版本。
下載的是 ZIP 壓縮檔。請先在檔案管理員中完整解壓縮，再執行其中的安裝程式，依照安裝精靈完成安裝。請勿直接從壓縮檔預覽視窗啟動程式。兩種版本的安裝入口不同，若使用同一份訂閱，無須同時執行兩個版本。
安裝後匯入訂閱 →客戶端／安裝檔／架構選擇
V2Ray 客戶端下載
桌面版選 v2rayN，Android 優先選 v2rayNG。依作業系統與處理器架構選擇安裝檔，再匯入訂閱並設定代理。
- 免費開源客戶端
- 依架構選擇
- 更新前備份設定
Windows 安裝檔
同一款桌面客戶端提供兩種介面版本，先依使用習慣選一種。
推薦
安裝完成後的檢查順序
首次開啟後，先進入「訂閱群組」新增現有訂閱，再執行更新。伺服器清單出現項目後，選擇一台伺服器進行實際連線測試，最後再設定系統代理。安裝完成只代表程式能啟動，不代表瀏覽器流量已透過代理傳輸。
若安裝程式提示缺少執行環境，請依提示確認所需的執行階段類型與架構，勿混淆不同介面版本的相依項目。啟動後若記錄顯示監聽連接埠被占用，請先結束另一個正在執行的代理客戶端，再檢查本機連接埠設定。重複安裝通常無法解決連接埠衝突。
macOS 安裝檔
先查看「關於這台 Mac」中的晶片資訊，再選擇相符的 DMG。
v2rayN
Apple Silicon / Intel
開啟 Apple 選單中的「關於這台 Mac」。若顯示 Apple 晶片名稱，請選擇 Apple Silicon 的 arm64 安裝檔；若顯示 Intel 處理器，則選擇 x64 安裝檔。架構相符比檔案大小更重要，不必因檔名中有「64」就改選 Intel 版。
下載後開啟 DMG，將 App 拖曳至「應用程式」資料夾，再從該資料夾啟動。請勿長期從掛載的磁碟映像執行，以免卸載映像後找不到程式，或更新時寫入錯誤位置。
查看桌面版設定步驟 →啟動提示與代理權限
遇到系統安全性提示時，先確認下載來源與檔案架構，再查看「系統設定 → 隱私權與安全性」中的相關說明。確認來源可信後，可按住 Control 鍵並點按 App，選擇「打開」。請勿為了啟動單一 App 而全面停用系統安全機制，也不要對來源不明的檔案套用繞過步驟。
匯入設定後，先使用系統代理進行基本連線測試，再考慮啟用 TUN。兩種方式接管流量的範圍不同，所需權限也不一樣。若已使用其他網路工具，請先結束其中一個再測試，避免重複修改系統代理與路由。結束客戶端後，若瀏覽器仍無法連線，請檢查系統網路設定是否留有手動代理。
Android 安裝檔
優先選 v2rayNG；需要 V2Fly 核心相容性時，再考慮 v2flyNG。
v2rayNG
Android・Xray 核心
2015 年後推出的主流手機通常可選 arm64。請留意，處理器支援 64 位元，不代表系統一定允許安裝 64 位元應用程式。若不確定裝置架構，或明確收到 arm64 安裝檔不相容的提示，可改試通用版。
v2rayNG 使用 Xray 核心，適合在手機上匯入訂閱、選擇伺服器及設定依應用程式代理。首次連線時會出現系統 VPN 授權對話框，請核對應用程式名稱後再允許；授權本身不會提供訂閱或伺服器。
查看 v2rayNG 訂閱匯入方式 →v2flyNG
Android・V2Fly 核心
若需要使用 V2Fly 核心，且現有設定與該核心相容，可選擇 v2flyNG。它與 v2rayNG 是不同的應用程式，介面名稱相似不代表支援的協定、傳輸選項與設定行為完全相同。
從其他應用程式移轉時，請重新匯入原始訂閱或設定，再確認路由、DNS 與依應用程式代理設定。請勿直接複製應用程式的私人資料目錄。兩款應用程式可各自保留設定，但測試連線時，應只讓其中一款建立 VPN 連線。
安裝失敗與背景連線
若系統顯示應用程式未安裝，請先檢查剩餘空間與系統相容性提示，再確認手機是否已安裝同名應用程式。來自不同發佈管道的應用程式可能使用不同簽章，無法直接覆蓋更新。請勿直接解除安裝再重裝；先確認設定可否匯出，並保存訂閱來源與自訂設定。
建立連線後，若螢幕鎖定一段時間便中斷，可檢查系統的電池最佳化與背景執行限制。是否允許長時間在背景執行，應依連線需求與耗電情況決定。若只想讓少數應用程式使用代理，可透過依應用程式代理縮小接管範圍，再逐一確認目標應用程式已納入規則。
Linux 安裝檔
先確認發行版使用的套件格式，再核對 x64 或 arm64。
v2rayN
Linux 圖形介面桌面客戶端
Debian、Ubuntu 及其衍生系統通常使用 deb；Fedora、RHEL 系及其衍生系統通常使用 rpm。套件格式相符只是第一步，發行版版本、桌面環境與系統相依套件也會影響安裝結果。
按兩下安裝檔後，使用系統的圖形化軟體安裝程式查看相依套件與相容性提示。若系統指出相依套件無法滿足，請先確認發行版版本，不要強制忽略相依套件繼續安裝。此處提供的是圖形介面桌面客戶端，需有可用的桌面工作階段。
了解 TUN 模式設定 →桌面代理與應用程式代理的差別
客戶端啟動後，系統代理能否影響目標應用程式，取決於桌面環境，以及該應用程式是否讀取系統代理設定。瀏覽器能連線，不代表所有軟體都已透過代理。請先用明確支援代理設定的應用程式完成測試，再依需求選擇應用程式內的代理設定或 TUN。
若要啟用 TUN，請先閱讀權限與路由說明，確認目前系統沒有其他工具重複接管網路。請勿長期以高權限執行整個圖形桌面工作階段。更新後若系統代理未恢復，先查看客戶端狀態與桌面網路設定，再檢查應用程式本身的代理設定。
從安裝檔到成功連線
下載前後，分開檢查
安裝檔用來安裝程式；訂閱、路由與代理模式則決定實際連線方式。分開檢查，較容易找出問題。
下載前：確認裝置與設定來源
先確認作業系統、處理器架構與套件格式。電腦或手機的商品名稱不能取代架構資訊，同系列裝置也可能採用不同處理器。頁面列出的條件是選擇安裝檔的依據，不代表相容於所有舊版系統，仍須以安裝程式提示為準。
首次使用還需要準備有權使用的訂閱或伺服器設定。客戶端與訂閱服務是兩回事：下載軟體不等於取得網路服務，更新客戶端也不會自動延長訂閱效期。服務是否可用，請向相應的設定提供者確認。
更新前：保存現有設定
記下訂閱群組、路由預設、DNS、本機監聽連接埠與依應用程式代理規則。優先使用客戶端提供的匯出或備份功能；若要備份資料夾，請先結束客戶端，避免複製仍在寫入的資料。
備份可能含有伺服器憑證與訂閱存取參數，請存放在個人可控的位置。更新前先結束舊版程式，完成後檢查伺服器清單與路由狀態，再恢復系統代理或 TUN。請勿同時啟動新舊版本，測試同一個監聽連接埠。
Windows 桌面版與 WPF 版該選哪一個？
首次安裝可先選 Desktop 桌面版，採用新一代跨平台介面；習慣傳統視窗配置的使用者則可選 WPF 經典穩定版。兩者都用來管理代理設定，無須同時安裝。切換介面版本前，請先備份訂閱群組、路由與自訂設定，再依新版本支援的方式匯入。
Android 的 arm64 與通用版有什麼差別？
2015 年後推出的主流手機通常可選 arm64，但仍應以裝置實際支援的應用程式架構為準。通用版包含多種架構，適合不確定裝置架構或 arm64 安裝失敗時嘗試，檔案通常較大。若安裝失敗，也請檢查系統版本、剩餘空間，以及與既有應用程式的簽章相容性。
下載並安裝客戶端後，為什麼還沒有伺服器？
客戶端負責讀取設定並轉送流量，安裝檔本身不會附帶可用伺服器。請準備有權使用的訂閱網址或伺服器設定，在訂閱群組中新增並更新，或從剪貼簿匯入。訂閱連結可能包含存取憑證，請勿公開分享完整連結或含有憑證的截圖。
macOS 顯示無法開啟 App 時該怎麼處理？
先確認安裝檔與晶片類型相符，並已將 App 拖曳至「應用程式」資料夾。確認下載來源可信後，可在 Finder 中按住 Control 鍵並點按 App，選擇「打開」，或查看「系統設定」中的「隱私權與安全性」提示。請勿為了執行單一 App 而全面停用系統安全機制；若仍持續出錯，請記下完整提示再進一步排查。
更新客戶端前需要備份哪些資料？
記下訂閱群組、目前使用的伺服器、路由預設、DNS、自訂規則與本機監聽連接埠；優先使用目前客戶端提供的匯出或備份功能。備份檔可能含有敏感設定，請存放在個人可控的位置。更新前先結束舊版客戶端，完成後再檢查系統代理、TUN 與路由狀態。
安裝檔版本文字與檔名不一致時，該以哪個為準？
發布更新期間，頁面上的版本文字與下載檔名可能暫時不同步。檔名可用來辨識安裝檔，安裝後的實際版本則以客戶端的「關於」或「檢查更新」頁面為準。請勿只憑頁面版本文字判斷是否已完成升級；若要保留舊設定，請先備份，再查看新版本的移轉說明。