v2rayN
日常使用保留其中一個版本即可。請勿同時執行兩個執行個體並占用相同的本機監聽連接埠。
用戶端安裝 · 平台與架構
V2Ray 下載
用戶端與安裝檔選擇
桌面系統選 v2rayN，Android 優先選 v2rayNG。先確認作業系統與處理器架構，再下載對應的安裝檔。
初次安裝與匯入訂閱教學 →Windows：v2rayN
同一款用戶端的兩種介面版本。以下皆為 x64 安裝檔，下載後請先解壓縮，再執行檔案中的安裝程式。
系統準備與安裝步驟
先在「設定 → 系統 → 系統資訊」查看系統類型，確認裝置使用 x64 系統。這兩種安裝檔都不是為其他架構單獨編譯的原生版本；若裝置架構不同，請先確認系統是否具備相容執行能力。將 ZIP 檔儲存至可寫入的資料夾，完整解壓縮後再執行安裝程式，請勿直接從壓縮檔預覽視窗啟動。
Desktop 與 WPF 的主要差異在於介面技術與操作配置，不代表可以省略訂閱，也不表示相同規則在不同核心上一定會有相同結果。初次使用建議保留預設參數，先匯入設定並測試連線。既有使用者切換介面前，請先備份訂閱群組、自訂路由與個人設定；不要直接用另一個版本覆蓋正在執行的資料夾。
若程式啟動時提示缺少執行元件，請依提示安裝架構相符的 .NET 桌面執行階段；不同發布檔是否內含執行環境可能有所不同，無須預先重複安裝所有執行階段。若程式一開啟就退出，也請檢查安全軟體的隔離紀錄及安裝資料夾的寫入權限。日常使用系統代理通常不必持續以系統管理員身分執行，只有相關網路功能明確要求提升權限時才需要處理。
| 項目 | 本頁提供的安裝檔類型 | 檢查位置與要求 |
|---|---|---|
| 系統與架構 | Windows x64 | 在系統資訊中確認系統類型；最低系統版本請以對應發布檔的要求為準。 |
| 安裝格式 | ZIP 內含安裝程式 | 完整解壓縮並關閉舊執行個體，再執行安裝程式。 |
| 執行環境 | 依啟動提示處理 | 若提示缺少 .NET，請安裝所需的桌面執行階段，並確認架構相符。 |
| 儲存空間與權限 | 可寫入的資料夾 | 預留解壓縮、安裝及寫入設定所需空間，並確認安全軟體未隔離相關元件。 |
macOS：v2rayN
依「關於這台 Mac」中的晶片或處理器名稱選擇。DMG 是安裝映像檔，不是日常執行程式的資料夾。
v2rayN
將應用程式拖曳至「應用程式」資料夾後再啟動；更新前請先退出已執行的 v2rayN。
辨識晶片與初次啟動
開啟螢幕左上角的 Apple 選單，進入「關於這台 Mac」。若顯示「晶片 Apple M…」，請使用 arm64 安裝檔；若顯示「處理器 Intel…」，請使用 x64 安裝檔。即使過去曾透過相容層執行舊版應用程式，也建議優先選擇與硬體相符的目前版本，而非沿用舊安裝檔的架構。副檔名相同不代表程式適用於相同處理器。
按兩下下載的 DMG，依映像檔視窗中的指示將 v2rayN 拖曳至「應用程式」資料夾。複製完成後，從「應用程式」資料夾開啟用戶端，再退出安裝映像檔。這樣可避免程式持續從暫存掛載位置執行，也方便日後替換升級。若系統顯示安全性提示，請先閱讀提示並確認應用程式來源；不要只為了安裝一次就關閉整體系統安全檢查。
初次啟動後先匯入設定、選擇可用項目，再設定系統代理。系統代理只會影響遵循該設定的應用程式，不能據此認定所有程式都使用相同的對外連線。TUN 是另一種接管網路流量的方式，可能需要額外權限並調整路由；若目前只需要讓瀏覽器使用代理，請先測試系統代理，再參考設定說明決定是否啟用 TUN。
| 項目 | 選擇依據 | 安裝要求 |
|---|---|---|
| Apple Silicon | Apple M 系列晶片 | 選擇 arm64 DMG，並確認系統版本符合目前安裝檔的要求。 |
| Intel | Intel 處理器 | 選擇 x64 DMG，不要與 arm64 安裝檔混用。 |
| 執行位置 | 「應用程式」資料夾 | 複製完成後再啟動，並預留應用程式及設定所需的寫入空間。 |
| 網路權限 | 依功能授權 | 先測試基本連線；TUN 權限與一般系統代理請分別處理。 |
Android：v2rayNG 與 v2flyNG
先介紹採用 Xray 核心的 v2rayNG，再提供採用 V2Fly 核心的 v2flyNG 作為替代選擇。兩者的設定需分別維護。
v2rayNG
應用程式層級的版本文字與平台安裝檔名可能不同步；安裝後可在「關於」頁面確認實際版本。
v2flyNG
用戶端外觀相似，不代表核心功能相同。請勿直接套用其他核心專用的設定欄位。
APK 安裝、權限與背景執行
優先查看手機設定中的裝置資訊，或使用系統提供的應用程式相容性資訊確認架構。處理器支援 64 位元，不一定表示系統允許安裝所有 64 位元應用程式；遇到「應用程式未安裝」時，也請檢查系統版本、儲存空間及現有應用程式的來源。通用版可降低架構選擇的不確定性，但無法解決簽章衝突或系統版本過舊的問題。
透過瀏覽器或檔案管理員開啟 APK 時，系統可能會要求允許該來源安裝應用程式。僅授權目前使用的來源，安裝完成後可視需要取消。升級時通常應保留原有應用程式及資料；若系統提示與已安裝的應用程式衝突，請勿立即解除安裝。先匯出或記下訂閱群組與自訂設定，再確認新舊安裝檔是否來自相同簽章管道，避免解除安裝後遺失本機設定。
初次啟用連線時，Android 會顯示 VPN 連線授權提示。這是用戶端建立本機流量接管入口所需的系統授權，並不代表已成功連線。授權後仍需有效設定及可用的伺服器。若螢幕鎖定後經常中斷連線，請到系統電池設定檢查背景執行限制，並確認沒有其他 VPN 類應用程式同時占用連線；不同廠牌的設定名稱可能不同。
| 項目 | 建議選擇 | 需確認事項 |
|---|---|---|
| 應用程式架構 | 主流裝置優先選 arm64 | 確認系統支援的應用程式架構；不確定時選擇通用版。 |
| 系統版本 | 符合 APK 最低需求 | 最低需求會隨用戶端版本而變動，不能以裝置購買年份代替判斷。 |
| 安裝授權 | 目前使用的瀏覽器或檔案管理員 | 允許目前使用的來源安裝應用程式，並預留足夠的安裝空間。 |
| 連線權限 | 系統 VPN 授權 | 首次連線時確認授權，並排除其他 VPN 類應用程式占用。 |
Linux：v2rayN
先依 Linux 發行版選擇 deb 或 rpm，再依處理器架構選擇 x64 或 arm64。以下提供圖形介面用戶端。
v2rayN
rpm 檔名包含建置目標資訊，不代表所有使用 rpm 的發行版都符合相同的相依條件。
發行版、架構與桌面環境
在系統的「關於」或「系統資訊」中確認發行版與架構。x86_64、amd64 通常對應此處的 x64 安裝檔；aarch64 則對應 arm64。deb 與 rpm 的差異首先在於套件管理格式，而非處理器型號，因此兩項都必須確認。請勿修改副檔名，將一種套件偽裝成另一種使用；遇到相依性錯誤時，也不要強行略過套件管理工具的檢查。
下載完成後，可透過檔案管理員開啟安裝檔，交由系統的軟體安裝工具處理。安裝工具會讀取套件中的相依項目，並要求必要權限；若提示無法滿足相依需求，請先檢查發行版版本、軟體來源狀態及套件建置目標，而不是重複安裝同一個檔案。此處提供的是圖形介面用戶端，僅有遠端終端機、沒有桌面工作階段的環境不適用這套安裝流程。
安裝後從應用程式選單啟動 v2rayN，先匯入設定，再查看本機監聽連接埠。不同桌面環境的系統代理設定位置各異，用戶端設定也不一定會被所有應用程式讀取。可先用明確支援 HTTP 或 SOCKS 代理的應用程式測試連線；確認基本設定無誤後，再處理桌面系統代理或 TUN。使用 TUN 時，請另外確認權限、路由及 DNS，避免同時變更太多網路選項。
| 項目 | 相符方式 | 執行需求 |
|---|---|---|
| 套件格式 | deb 或 rpm | 須符合發行版的套件管理系統，並滿足套件中的相依需求。 |
| 處理器 | x64 或 arm64 | 請在系統資訊中確認，不要依發行版名稱推測架構。 |
| 使用環境 | 圖形桌面工作階段 | 需要可執行圖形應用程式的桌面環境及相關相依項目。 |
| 網路功能 | 依功能設定權限 | 分別測試系統代理與 TUN，避免多個用戶端同時接管路由。 |
安裝後的設定順序
下載完成只代表程式已備妥。連線結果仍取決於訂閱、選取的設定、代理模式及應用程式本身的設定。
匯入設定
訂閱連結與分享連結
在 v2rayN 中開啟訂閱群組設定，新增群組名稱與訂閱網址，儲存後執行更新。v2rayNG 可從選單中的訂閱相關功能新增網址，再更新對應群組。單一分享連結與完整訂閱並不相同：分享連結通常只包含一組設定，訂閱網址則用來取得一系列項目。請先辨識手上的內容，再選擇匯入方式。
查看匯入訂閱步驟 →選擇代理模式
系統代理與路由分流
匯入後先選取一組設定，再選擇代理模式。系統代理決定哪些遵循系統設定的應用程式會將要求交給用戶端；路由規則則決定用戶端收到要求後使用哪個出口。兩者不是同一個開關。初次測試時請保持規則簡單，連線成功後再新增網域、位址或應用程式分流，並記錄每次修改的結果。
查看 routing 設定 →確認相容範圍
協定與核心功能
VMess、VLESS、Trojan 是協定層級的選擇；TLS、REALITY 與傳輸設定也必須逐項符合伺服器設定。不能只因名稱相同，就認定參數完整。v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心；遇到 VLESS 等設定的相容性問題時，請先確認實際使用的核心及其版本支援，再核對傳輸方式、安全設定與伺服器要求。
查看核心與欄位支援範圍 →擴大流量接管範圍
TUN 模式與 DNS
需要接管不讀取系統代理設定的應用程式時，再考慮使用 TUN。先儲存原有設定，確認一般代理已可正常運作，再依用戶端提示授權。啟用後請同時測試網域解析與連線，避免將 DNS 失敗誤判為伺服器無法連線。TUN 的實作方式會因用戶端及其呼叫的核心而異，並非在所有設定檔中加入相同欄位就能啟用。
查看 TUN 設定範圍 →更新前要保留哪些設定
先記錄目前狀態，再替換程式。發生問題時才能分辨是安裝變更還是設定變更造成的。
更新前請記下訂閱群組名稱、更新方式、本機監聽連接埠、自訂路由及 DNS 設定。訂閱項目通常可以重新取得，但手動新增的設定、應用程式分流及自訂規則未必能從訂閱還原。備份請存放在個人可控的位置，切勿公開含有存取憑證的連結、設定 QR Code 或未經處理的日誌原文。
升級前先完全退出舊用戶端，尤其要確認系統匣或背景沒有仍在執行的執行個體。安裝完成後，先確認設定清單仍在，再逐項還原需要的網路功能。不要同時更換用戶端、核心、訂閱及路由規則；一次只調整一項，才能判斷連線變化的原因。若安裝程式明確指出不支援目前系統，請先確認系統需求，不要以重複下載取代相容性檢查。
v2rayN、v2rayNG、v2flyNG 都是 Project V 相關開源生態中的圖形介面用戶端。用戶端負責提供設定入口、訂閱及系統整合；核心則負責處理連線與路由。程式能正常啟動，不代表伺服器參數已相符；訂閱能更新，也不代表其中每個項目都能使用。測試時請分別檢查匯入結果、選取的設定及實際應用程式連線，逐步確認。
下載與安裝常見問題
先確認套件類型與系統相容性，再排查訂閱及連線問題。
Windows 要選桌面版還是傳統 WPF 版？
初次安裝可先選 Desktop 桌面版，採用新一代跨平台介面。若習慣原有的 Windows 操作配置，可選經典穩定的 WPF 版。兩種版本皆提供 x64 安裝檔；切換前請先備份訂閱群組與自訂設定，首次啟動後確認本機監聽連接埠。
Android 的 arm64 和通用版該怎麼選？
2015 年後推出的主流手機通常可先選 arm64，但仍應以裝置實際支援的應用程式架構為準。若不確定架構，可選通用版；通用安裝檔包含多種架構，容量通常較大。若安裝失敗，也請檢查系統版本、可用空間及既有應用程式的簽章，不要只憑錯誤訊息判定是架構問題。
macOS 如何分辨 Apple Silicon 與 Intel？
開啟 Apple 選單中的「關於這台 Mac」。若晶片欄顯示 Apple M 系列，請選 Apple Silicon；若處理器欄顯示 Intel，請選 Intel。下載 DMG 後開啟磁碟映像檔，將應用程式拖曳至「應用程式」資料夾，再從該資料夾啟動。
安裝用戶端後，是否已包含訂閱或連線參數？
安裝檔只提供用戶端程式，不包含可直接使用的訂閱或伺服器連線參數。請匯入自行取得且有權使用的訂閱連結或分享連結，再選擇設定、設定代理模式並測試連線。訂閱網址可能含有存取憑證，請勿公開貼在截圖或求助內容中。
卡片上的版本文字與下載檔名不同，該怎麼辦？
卡片上的版本文字取自應用程式層級的資訊清單，實際檔名則對應各平台的安裝檔項目；發布期間兩者可能不同步。請先確認選取的用戶端、作業系統與架構；安裝前記下檔名，安裝後到用戶端的「關於」頁面確認實際版本。不要只根據卡片上的版本文字推測檔名，也不要手動修改下載網址中的版本號。