安裝檔 / 系統與架構
V2Ray 用戶端下載
桌面端選擇 v2rayN，Android 端選擇 v2rayNG。先確認作業系統，再選擇處理器架構與安裝檔格式。
- Desktop / WPF
- x64 / arm64
- DMG / APK / deb / rpm
用戶端負責管理設定與連線；可用的伺服器設定需另外匯入。初次安裝可參考設定教學繼續操作。
Windows 安裝檔
同一用戶端提供兩種介面。以下下載項目皆為 x64，下載前請先到系統資訊確認系統類型。
系統需求與安裝準備
| 檢查項目 | 選擇依據 |
|---|---|
| 作業系統 | Windows 桌面版；最低系統版本請以目前安裝程式的提示為準。 |
| 處理器架構 | 這兩個下載項目皆為 x64。前往「設定 → 系統 → 系統資訊」查看系統類型。 |
| 安裝檔 | 先解壓縮 ZIP，保留完整的解壓縮資料夾，再執行其中的安裝程式。 |
| 執行環境 | 若安裝程式提示缺少執行環境，請依指示確認所需元件與架構，勿任意替換程式檔案。 |
請勿直接從壓縮檔預覽視窗啟動程式。先將檔案解壓縮至可寫入的一般資料夾，確認安裝程式能讀取同一資料夾內的檔案，再開始安裝。舊版用戶端仍在執行時，請先關閉系統代理並結束程式，避免新舊執行個體搶用本機監聽連接埠。
Desktop 與 WPF 的主要差異在介面技術與操作配置，不代表任何設定都能直接在兩個版本之間複製。切換時請優先使用用戶端提供的設定匯出與匯入功能；自訂路由、訂閱群組與本機連接埠都需逐項核對。請勿將舊資料夾中的所有檔案直接覆寫到新資料夾。
安裝完成後，先匯入設定並選擇一台伺服器，再確認核心能否啟動。系統代理會影響讀取系統代理設定的應用程式，但不代表所有應用程式的流量都已變更。連線驗證與路由選擇可接著參閱首次設定教學。
macOS 安裝檔
先查看「關於這台 Mac」中的晶片或處理器資訊，再選擇對應的 DMG。
v2rayN
7.24.1系統需求與晶片辨識
| 檢查項目 | 選擇依據 |
|---|---|
| 作業系統 | macOS；最低系統版本請以目前應用程式套件的需求與系統提示為準。 |
| Apple Silicon | 「關於這台 Mac」顯示 Apple M 系列晶片時，請選擇 arm64 DMG。 |
| Intel 處理器 | 「關於這台 Mac」顯示 Intel 時，請選擇 x64 DMG。 |
| 安裝方式 | 開啟 DMG，將應用程式拖移至「應用程式」資料夾，再從該資料夾啟動。 |
「關於這台 Mac」顯示的晶片名稱，比機型年份更可靠。外觀相近的裝置可能採用不同架構，舊款裝置也可能較晚才購買。下載錯誤架構的套件後，即使磁碟映像檔能開啟，應用程式也未必能正常執行，因此請在安裝前確認架構。
開啟磁碟映像檔後，請勿將映像檔中的暫存位置當成長期執行目錄。將應用程式複製到「應用程式」資料夾，複製完成後再啟動；更新前請先結束舊的執行個體，並確認選單列中的用戶端也已關閉。若系統阻擋啟動，請先閱讀「隱私權與安全性」中的具體提示，勿為了啟動單一應用程式而全面關閉系統保護。
首次啟動後，先確認匯入結果，再設定系統代理。若瀏覽器可以連線、其他應用程式卻不行，請確認該應用程式是否會讀取系統代理，不能只憑瀏覽器結果判定所有流量。若涉及協定、安全層與核心支援範圍，請參閱協定與核心手冊，再核對匯入的設定。
Android 安裝檔
建議優先選擇 v2rayNG。2015 年後的主流手機通常可選 arm64；不確定架構時可查看通用版。
v2rayNG
推薦 2.2.6v2flyNG
替代選項 1.10.31系統需求與安裝授權
| 檢查項目 | 選擇依據 |
|---|---|
| 作業系統 | Android；最低系統版本以目前 APK 的宣告為準，安裝程式會檢查相容性。 |
| 處理器架構 | arm64 適用於支援 64 位元應用程式的系統；通用版支援多種應用程式架構。 |
| 安裝授權 | 只為實際開啟 APK 的瀏覽器或檔案管理員，啟用所需的安裝權限。 |
| 連線授權 | 首次連線時會要求系統 VPN 授權，確認應用程式名稱後再允許。 |
手機處理器支援 64 位元，不代表系統一定允許安裝 64 位元應用程式。部分舊裝置採用不同的系統建置方式，因此年份只能作為初步參考。若 arm64 套件無法安裝，請先查看安裝程式提供的原因；通用版可處理部分架構差異，但無法繞過系統版本需求。
覆蓋更新時，套件名稱、簽章與已安裝的應用程式必須符合 Android 更新條件。不同發布管道提供的安裝檔可能無法直接覆蓋；遇到簽章衝突時，請先保留現有應用程式並匯出設定。直接解除安裝通常會刪除應用程式的私人資料，訂閱群組與自訂規則也可能一併遺失。
v2rayNG 與 v2flyNG 是不同的用戶端，不能只因名稱相似就認定協定能力完全相同。設定若包含特定安全層或傳輸組合，請先查明核心支援範圍。連線建立後若常在鎖定螢幕時中斷，請檢查電池最佳化與背景權限；分應用程式代理的勾選範圍也會影響哪些應用程式實際使用代理。
Linux 安裝檔
先確認發行版使用 deb 或 rpm，再核對 x64 與 arm64。此處提供圖形介面桌面用戶端。
v2rayN
7.24.1系統需求與套件格式
| 檢查項目 | 選擇依據 |
|---|---|
| 桌面環境 | 需要能執行圖形應用程式的 Linux 桌面工作階段；純終端機環境不在本頁安裝指南的適用範圍內。 |
| 套件格式 | 依發行版選擇 deb 或 rpm；副檔名相同也不代表適用於所有發行版版本。 |
| 架構名稱 | amd64、x86_64 對應 x64；arm64、aarch64 對應 ARM 64 位元。 |
| 系統相依套件 | 系統套件安裝程式會檢查相依程式庫；若有缺少，請先核對發行版版本與套件來源。 |
套件格式與處理器架構是兩個不同條件。例如，使用 deb 的桌面系統也可能搭載 ARM 裝置，不能看到熟悉的副檔名就直接下載 x64。請在系統的「關於」或硬體資訊中查看處理器與系統架構，再回到對應的下載項目選擇檔案。
下載後，使用發行版的軟體安裝程式開啟套件，並查看相依性檢查結果。若提示某個系統程式庫版本不符合需求，請先確認套件是否適用於目前的發行版，不要強制忽略相依性。請勿將 rpm 改成 deb 副檔名，也不要強行安裝架構不符的套件。
安裝完成後，從應用程式選單啟動，並先在一般使用者工作階段匯入設定。不同桌面環境讀取系統代理設定的方式不盡相同，瀏覽器也可能另有自己的代理選項。若用戶端已啟動但瀏覽器無法如預期連線，請一併檢查桌面代理設定、瀏覽器設定與本機監聽連接埠，逐層找出問題。
安裝後
匯入設定與更新準備
下載完成只是第一步。保留設定、確認匯入結果，再讓用戶端接管需要使用代理的應用程式。
首次安裝
開啟用戶端後，伺服器清單為空代表尚未匯入設定。請先準備有權使用的訂閱網址、分享連結或設定檔，再使用用戶端對應的匯入功能。訂閱網址是用來取得設定的網址，不是本機監聽位址，也不應填入系統代理的伺服器欄位。
匯入訂閱後，請更新訂閱並檢查伺服器清單。清單中出現項目不代表一定可以連線；還需選擇伺服器、啟動連線，並依據記錄檔與應用程式的連線結果確認設定有效。設定中的協定、傳輸方式與安全層必須彼此相符。
查看匯入與連線教學 →更新與移轉
更新前先匯出設定，並將備份存放在應用程式資料夾之外。除了訂閱群組，也請記錄自訂路由、本機監聽連接埠、分應用程式代理選項與系統代理模式。只保留訂閱網址，通常無法還原所有個人化設定。
先結束舊的執行個體，再安裝新套件。更新完成後，先確認能否正常啟動，再還原設定。若要切換介面版本或核心系列，請先小範圍測試現有設定；不要同時變更協定、路由與代理模式，否則發生問題時難以判斷原因。
查看協定與核心相容性說明 →分開排查下載、安裝與連線問題
下載失敗時，先查看瀏覽器的下載記錄，確認是否因網路中斷、磁碟空間不足或系統下載政策而遭到阻擋。檔案仍在暫存下載狀態時，請勿改名後安裝。重新下載前可先刪除未完成的同名檔案，避免誤將舊檔案當成新下載結果。
安裝失敗時，記下安裝程式的原始錯誤訊息，並確認是架構不符、系統版本不支援、缺少相依套件，還是與既有安裝衝突。若安裝成功但無法連線，應改查設定、核心啟動狀態與系統代理，不必反覆重裝用戶端。請一併參考瀏覽器連線結果、用戶端記錄檔與所選路由來判斷。
頁面中的版本文字顯示更新清單上的標記，安裝檔連結則由下載清單分別管理。不同用戶端的發布時程不同；選擇時請優先考量系統、架構與相容需求，不要只看版本號大小判斷是否適用。更多常見狀況請前往疑難排解依問題查找。
下載相關問題
安裝檔選擇常見問題
Windows 桌面版與傳統 WPF 版該選哪一個？
初次使用可先選桌面版 Desktop，採用新一代跨平台介面。習慣傳統 Windows 操作配置時，可選擇經典穩定的 WPF 版。兩者都是 v2rayN，切換前請先備份設定，避免兩個執行個體同時接管系統代理。
Android 該下載 arm64 還是通用版？
2015 年後的主流手機通常可優先選 arm64，但仍須確認系統支援 64 位元應用程式。若不確定裝置架構，或 arm64 安裝檔顯示不相容，可改試通用版。通用版無法解決系統版本過舊或安裝檔簽章不同的問題。
下載用戶端後就有可用的設定嗎？
用戶端安裝檔與伺服器設定是兩回事。安裝完成後，需匯入有權使用的分享連結、訂閱網址或設定檔，再選擇伺服器並啟動連線。訂閱網址可能含有存取憑證，請勿放入公開截圖或記錄檔。
更新安裝前要保留哪些內容？
先使用用戶端的匯出或備份功能保存設定，並記下訂閱群組、路由規則與本機監聽連接埠。更新前請先結束舊版用戶端。行動裝置覆蓋安裝通常需要相同的套件名稱與簽章；若安裝程式提示衝突，請勿直接解除安裝，先確認備份可以還原。
下載完成卻無法安裝，先檢查什麼？
先確認檔案已完整下載，再核對作業系統、處理器架構與套件格式。Windows 的 ZIP 檔需先解壓縮，Android 使用 APK，macOS 使用 DMG，Linux 則依發行版選擇 deb 或 rpm。保留安裝程式的錯誤訊息，再依疑難排解頁面的指示檢查。