V2Ray 客戶端下載

Windows 系統與執行需求

如何選擇 Desktop 或 WPF

兩個版本主要差異在介面架構與桌面操作方式，並非訂閱來源。Desktop 採用新一代跨平台介面，WPF 則延續傳統 Windows 操作配置；選單位置、視窗行為及部分功能入口可能不同。若教學截圖與實際介面不一致，請先依選單名稱尋找相應功能，不要只因按鈕位置不同就認定功能不存在。功能支援會隨發行版本變動，選擇時請參考最新更新說明。

若目前使用 WPF 且設定正常，可先備份，再評估是否改用 Desktop。不要直接以新版本覆蓋唯一一份設定資料夾，也不要讓兩個版本同時執行並接管系統代理。完成移轉後，依序檢查訂閱群組、目前使用的伺服器、系統代理與路由設定，確認基本連線正常後再還原自訂選項。初次安裝則建議先使用單一版本，減少重複設定造成的排查負擔。

下載後的安裝順序

1. 請將 ZIP 檔儲存至可寫入的資料夾並完整解壓縮；不要直接在壓縮檔預覽視窗中啟動安裝程式。
2. 執行解壓縮後的安裝程式，依照提示完成安裝。若提示缺少執行環境，請先記下相依項目名稱，再依發行說明安裝，不要反覆重裝同一個套件。
3. 啟動客戶端後匯入設定、選擇伺服器，再啟用自動設定系統代理。先用瀏覽器測試基本連線，最後再處理路由分流與 TUN。

安裝時若出現檔案遭占用，請先結束系統匣中的客戶端，再確認是否仍有舊程序執行。應用程式能開啟卻無法連線時，請檢查設定與網路；重新下載安裝檔通常無法解決訂閱失效、伺服器參數錯誤或連接埠衝突。詳細操作請參閱使用指南。

macOS 系統與晶片需求

DMG 安裝與首次啟動

下載完成後開啟 DMG，將應用程式拖曳至「應用程式」資料夾，再從該資料夾啟動。請勿長期從已掛載的磁碟映像執行，否則更新、應用程式路徑辨識與權限記錄都較不易管理。確認安裝完成後即可退出磁碟映像；是否保留下載檔取決於日後維護需求，不會影響已複製到「應用程式」資料夾的應用程式啟動。

首次啟動若出現開發者驗證提示，請先確認下載來源與晶片版本是否正確，再查看「系統設定 → 隱私權與安全性」中的相關提示。只允許已確認來源的應用程式執行，不要為了啟動單一應用程式而全面關閉系統安全機制。不同 macOS 版本的按鈕位置可能不同，請依系統目前顯示的提示操作。

分別處理安裝與網路權限

應用程式能開啟，不代表所有網路功能都已取得授權。請先匯入有效設定，使用一般系統代理確認連線；確實需要接管更多應用程式流量時，再依說明啟用 TUN 並授予相應權限。系統代理、網路延伸功能與虛擬網卡屬於不同層級的設定，允許其中一項不代表其他功能也已啟用。

若啟動後沒有顯示視窗，請先查看選單列或 Dock 是否已有執行中的程式。若退出應用程式後網路才恢復，請確認系統代理是否仍指向本機連接埠，並檢查是否同時執行其他代理客戶端。排查權限問題時，記下具體提示與系統版本，比反覆下載不同架構的安裝檔更容易找出原因。

Android 系統與架構需求

架構選擇與安裝失敗排查

arm64 是處理器與應用程式的執行架構，不能只以手機品牌、型號或上市年份判斷。近年推出的大多數裝置適用 arm64 安裝檔，但舊裝置、特殊系統或採用其他架構的裝置可能需要通用版。通用版涵蓋更多架構，無法自動解決系統版本過舊、儲存空間不足或已安裝應用程式簽章不一致等問題。

開啟 APK 後依照系統提示完成安裝。允許安裝應用程式的權限通常會授予發起安裝的應用程式：若從瀏覽器下載後改用檔案管理員開啟，可能需要另外授權檔案管理員。安裝完成後可關閉暫時授予的安裝權限。若系統提示應用程式未安裝，請先檢查是否有同名舊應用程式、剩餘空間與架構相容性，再判斷是否需備份後重新安裝。

v2rayNG 與 v2flyNG 的適用差異

v2rayNG 採用 Xray 核心，是本頁優先推薦的 Android 客戶端；v2flyNG 採用 V2Fly 核心，適合有相應設定需求的使用者。兩者是同一代理生態中的不同客戶端，不代表所有訂閱參數都能互通。協定、傳輸方式與擴充參數是否可用，仍取決於實際核心版本及客戶端的設定支援。

首次連線時請確認系統 VPN 授權，並留意同一時間通常只能有一個接管網路的應用程式運作。若已啟用其他客戶端或 VPN 應用程式，請先中止原有連線再測試。連線按鈕顯示已啟動，只代表本機服務正在執行；還需透過網頁存取與記錄確認伺服器是否可用。若背景執行時斷線，再檢查電池最佳化與背景執行限制，別把所有問題都歸咎於安裝檔。

Linux 系統與套件格式需求

使用圖形化套件管理員安裝

將安裝檔儲存至本機後，使用發行版提供的軟體安裝程式開啟。安裝程式可能需要管理員授權才能寫入系統目錄，並會從發行版軟體來源安裝相依套件；若遇到相依性問題，請先查看缺少的項目與系統版本，不要強行忽略。deb 與 rpm 是不同的套件管理格式，只改副檔名無法將其轉換為另一種格式。

安裝完成後，從應用程式選單啟動 v2rayN。若視窗無法開啟，請優先確認架構、圖形環境與相依套件是否相符；若視窗正常但網路未經代理，則須檢查桌面環境的系統代理設定。不同桌面環境與應用程式支援系統代理的程度不一，某個瀏覽器能連線，不代表所有應用程式都會自動使用相同的代理入口。

代理範圍與權限界線

先使用一般代理模式確認伺服器連線，再考慮啟用 TUN。TUN 涉及虛擬網卡、路由與權限，設定範圍比應用程式代理更廣。遇到授權提示時，請確認需要授權的操作，不要為了方便而讓整個圖形化客戶端長期以高權限執行。若系統中已有其他代理或網路接管工具，請先關閉其中一個，再檢查是否有連接埠占用或路由衝突。

更新前請先結束客戶端並備份設定，再透過套件管理員安裝新版。Linux 發行版升級大版本後，原本可用的系統程式庫與桌面整合可能改變，請重新確認目前套件的需求。完整設定步驟與分流原則請參閱完整手冊；本頁僅提供圖形化客戶端安裝入口。