Windows · x64
v2rayN
7.24.1桌面版採用新一代跨平台 UI；經典 WPF 版保留熟悉的 Windows 操作介面。第一次安裝可從桌面版開始。
檔案是 ZIP 壓縮檔。下載完成後請先解壓縮，再執行其中的安裝程式。
安裝檔 · 依平台選擇
V2Ray 下載
V2Ray 下載
用戶端安裝檔
先選擇作業系統，再確認處理器架構。
Windows 安裝需求與檢查位置
| 檢查項目 | 需求與處理方式 |
|---|---|
| 系統與架構 | 本頁提供 x64 版本。最低系統版本請以相應的發行說明及安裝程式檢測結果為準。 |
| 安裝檔 | 請完整解壓縮 ZIP；不要在壓縮檔預覽視窗中直接啟動安裝程式。 |
| 執行環境 | 若安裝程式提示缺少執行元件，請依提示安裝相應環境，不要只憑名稱安裝不相關的元件。 |
| 權限與網路 | 一般代理與 Tun 模式所需權限不同；啟用 Tun 前，請檢查權限、虛擬網卡及其他 VPN 是否有衝突。 |
安裝前請關閉正在執行的舊用戶端。兩個版本不宜同時啟動，否則可能占用相同的本機監聽連接埠，也可能輪流變更系統代理。若要更換版本，請先備份現有設定，再於新介面確認訂閱群組、監聽連接埠與路由模式；確認連線正常後，再清理舊資料夾。不要把解除安裝舊版當成故障排除的第一步。
macOS · 依晶片選擇
v2rayN
7.24.1在蘋果選單的「關於這台 Mac」查看晶片。顯示 Apple 晶片就選 Apple Silicon；顯示 Intel 處理器則選 Intel。
打開 DMG，依磁碟映像中的指示將 App 移至「應用程式」，再從「應用程式」資料夾啟動。
macOS 安裝需求與檢查位置
| 檢查項目 | 需求與處理方式 |
|---|---|
| 晶片架構 | Apple Silicon 對應 arm64；Intel 對應 x64。請以「關於這台 Mac」顯示的資訊為準。 |
| 系統版本 | 在「關於這台 Mac」查看版本；是否符合需求，請以目前安裝檔的提示及相應發行說明為準。 |
| 安裝位置 | 將 App 複製到「應用程式」。複製完成後再退出磁碟映像，避免一直從暫存掛載位置執行。 |
| 網路權限 | 依選擇的代理模式確認系統授權；切換模式前請先停止連線，避免與其他網路工具重複接管流量。 |
如果系統阻止啟動，請勿連續重複開啟。先確認提示是架構不符、開發者驗證限制，還是檔案損毀。確認來源後，可在「系統設定 → 隱私權與安全性」查看開發者驗證相關選項；若有明確風險提示，請停止執行並重新確認來源。升級前記下原有代理設定，退出用戶端後再替換 App，避免舊程序持續占用檔案或連接埠。
Android · Xray 核心
v2rayNG
2.2.62015 年後的主流手機建議優先選 arm64；不確定裝置架構時可選通用版。仍須以系統實際支援的應用程式架構為準。
APK 安裝檔。首次使用 VPN 模式連線時，須確認系統的 VPN 連線授權。
Android · v2fly 核心
v2flyNG
1.10.31適合設定明確以 v2fly 核心為目標的使用情境。匯入前請檢查協定及傳輸參數，不要假設不同核心支援的功能完全相同。
這是與 v2rayNG 不同的用戶端。移轉時請重新匯入設定，並分別確認路由及依 App 設定。
Android 安裝需求與檢查位置
| 檢查項目 | 需求與處理方式 |
|---|---|
| 處理器架構 | arm64 適用於支援該應用程式架構的裝置；通用版涵蓋多種架構，檔案通常較大。 |
| 系統版本 | 在「設定 → 關於手機」查看；實際相容範圍請以目前 APK 的安裝檢測與發行說明為準。 |
| 安裝授權 | 只授予目前使用的瀏覽器或檔案管理器必要的安裝權限；安裝完成後可視需要取消授權。 |
| VPN 與背景執行 | 首次連線時確認 VPN 授權；若要持續使用，請檢查電池最佳化、背景活動及系統自動啟動限制。 |
打開 APK 後若提示無法安裝，請先確認具體原因：架構不相容、系統版本不符、既有 App 簽章不同，處理方式各不相同。通用版只能解決架構選擇問題，無法繞過系統版本或簽章限制。裝置年份只能作為初步判斷；少數裝置即使處理器支援 64 位元，系統仍可能限制可執行的應用程式架構。
進入用戶端後，先匯入設定再連線。VPN 授權是讓用戶端透過系統提供的網路介面接管流量，不代表遠端伺服器已可使用。若鎖定螢幕後斷線，先檢查電池最佳化與背景執行限制；若只有部分 App 無法存取，再確認「依 App 設定代理」採用的是略過所選 App，還是僅代理所選 App。修改清單後請重新連線，確認新規則已生效。
查看 VPN 授權與省電設定筆記 →Linux · deb / rpm
v2rayN
7.24.1先確認發行版使用的套件格式，再確認處理器架構。Debian、Ubuntu 系統通常選 deb；Fedora、RHEL 系統通常使用 rpm，但仍須確認相依套件是否相容。
使用發行版的軟體安裝程式開啟檔案。若相依套件不符，請先閱讀安裝程式提示，不要強制略過相依性檢查。
Linux 安裝需求與檢查位置
| 檢查項目 | 需求與處理方式 |
|---|---|
| 套件格式 | 依發行版的套件管理系統選擇 deb 或 rpm，不要靠變更副檔名轉換套件格式。 |
| 硬體架構 | x64 使用 amd64 / x86_64 套件；arm64 使用 arm64 / aarch64 套件。 |
| 桌面環境 | 需要能執行圖形化應用程式的桌面環境；具體系統程式庫與執行元件需求請依安裝程式提示為準。 |
| 代理接管 | 桌面環境與 App 讀取系統代理的方式可能不同；請先測試單一 App，再確認 Tun 所需權限。 |
安裝完成後，從應用程式選單啟動用戶端，先確認主介面是否正常顯示。安裝程式回報相依套件缺失，與用戶端啟動後連線失敗，是不同階段的問題，不應混在一起處理。前者檢查系統程式庫與套件相容性，後者檢查設定、監聽位址及代理模式。不要為了解決一般啟動問題而長期以高權限執行整個桌面工作階段，也不要在尚未確認一般代理可用前，一次啟用多種流量接管方式。
安裝後：設定與連線檢查
程式能開啟、設定能匯入、流量已接管，是三個不同的檢查項目。
匯入設定，再選擇模式
用戶端本身不提供伺服器。請先準備有權使用的訂閱網址或設定，在訂閱群組中新增並更新；確認清單出現可用設定後，再選擇要使用的伺服器。訂閱網址可能包含存取憑證，請勿張貼在公開留言區，也不要連同記錄檔分享。
桌面端先使用適合目前 App 的系統代理設定；Android 先確認 VPN 模式及系統授權。Tun 模式、依 App 設定代理和自訂 DNS 都可稍後逐項設定，不必在第一次連線前同時啟用。
依步驟完成首次連線 →系統代理
自動設定系統代理供會讀取系統代理的 App 使用
Tun 模式有需要時再設定權限
此介面僅示意設定之間的關係，並非可操作的控制項。各用戶端及不同版本的選單位置可能不同，請以實際介面為準。
先保留基準設定，再逐項調整
安裝或更新前，請備份訂閱群組、手動新增的設定及自訂路由。備份檔也可能包含敏感資訊，應存放在自己能掌控的位置。更新後先使用原有模式連線，確認記錄沒有持續報錯，再逐項還原進階設定。如此即使發生問題，也能找出是哪一次變更造成，而不必在多個開關之間反覆嘗試。
連線後，請用實際需要存取的 App 驗證結果。系統代理開關顯示已啟用，只代表系統設定已變更，不保證所有 App 都會讀取該設定；Android 通知列顯示 VPN 圖示，也不代表目前的伺服器一定能成功連線。驗證失敗時，請記下用戶端名稱、系統資訊、具體錯誤及重現步驟；分享記錄前，先遮蔽訂閱網址與驗證參數。
安裝檔常見問題
先確認安裝檔是否選對，再處理安裝權限與連線設定。
Windows 桌面版和經典 WPF 版該選哪一個？
第一次安裝建議選桌面版 Desktop，採用新一代跨平台介面。經典 WPF 版是 Windows 上穩定的傳統版本，適合習慣原有介面的使用者。兩個版本都需要匯入有效設定；切換前請先備份，避免同時執行而占用相同的本機監聽連接埠。
Android 的 arm64 和通用版有什麼差別？
2015 年後的主流手機通常可優先選 arm64，但仍須確認系統支援的應用程式架構。不確定裝置類型時，可選包含多種架構的通用版。若出現架構不相容提示，請先查看裝置資訊，不要反覆安裝同一個檔案。
下載並安裝用戶端後，就能直接連線嗎？
用戶端不含可用的伺服器設定。請自行準備有權使用的訂閱網址或設定，匯入後選擇伺服器，再設定系統代理或 VPN 模式並連線。用戶端安裝完成只代表程式已就緒，不代表網路已連線。
更新用戶端前需要先解除安裝舊版嗎？
請先備份設定和路由規則，再關閉舊用戶端，依安裝程式提示更新。Android 使用相同套件名稱與簽章，且版本允許升級時，通常可直接覆蓋安裝；若提示簽章不符，請勿直接解除安裝，應先匯出設定。更換用戶端不等於一般的覆蓋更新。
macOS 顯示無法打開 App 時該怎麼處理？
先在「關於這台 Mac」確認晶片，排除安裝檔架構選錯，再核對系統顯示的具體提示。若提示與開發者驗證限制有關，確認來源後可查看「系統設定 → 隱私權與安全性」選項；若提示檔案損毀或有惡意軟體風險，請停止執行並重新確認來源，不要關閉整體系統安全防護。
安裝成功卻無法上網，接下來要檢查什麼？
先退出其他代理或 VPN，確認原本的網路可直接連線，再查看用戶端記錄與設定是否有效。桌面端檢查「自動設定系統代理」及本機監聽連接埠；Android 檢查 VPN 授權與背景執行限制。若只有部分 App 無法使用，再檢查 App 本身的代理設定與路由規則，避免一次變更多項設定。