客戶端安裝檔 / 平台與架構

V2Ray 客戶端下載

桌面版選擇 v2rayN，Android 優先選擇 v2rayNG。先確認作業系統，再選擇處理器架構與安裝檔格式。

安裝流程：選擇安裝檔 → 安裝客戶端 → 匯入訂閱 → 設定代理

第一次使用？查看入門指南 →

桌面客戶端 / x64

Windows 安裝檔

同一款客戶端提供兩種介面。Desktop 桌面版採用新一代跨平台 UI；WPF 是經典穩定版，沿用傳統 Windows 桌面操作方式。第一次使用可先選 Desktop；若已習慣 WPF，也可繼續使用經典版。

安裝前確認

Windows 系統需求與檢查位置
項目需求與檢查方式
系統建議使用仍受支援的 Windows 10 / 11；實際相依需求請以安裝程式提示為準。
處理器本頁提供的兩個安裝檔皆為 x64。可在「設定 → 系統 → 系統資訊」查看系統類型。
安裝環境請保留可寫入的設定資料夾；若提示缺少執行階段元件，請依對應版本的安裝說明處理。
權限一般系統代理與 TUN 所需權限不同；啟用 TUN 前請先閱讀權限提示。

請勿直接從壓縮檔預覽視窗啟動程式。先完整解壓縮到獨立資料夾，再執行安裝程式；Desktop 與 WPF 請使用不同資料夾，以免設定檔互相覆寫。安裝完成後先匯入訂閱，再選擇系統代理模式。

選擇依據

先確認架構，再選套件格式

下載按鈕的差異在於執行環境，不是線路等級。正確的安裝檔必須同時符合系統、處理器與客戶端設定需求。

x64 與 ARM64

x64 常見於 Intel、AMD 桌面裝置，安裝檔也可能標示為 amd64 或 x86_64；ARM64 也可能標示為 aarch64 或 arm64-v8a。這些名稱代表處理器指令集，不能只因系統顯示「64 位元」就任意互換。尤其是 Android，處理器支援 64 位元，不代表裝置目前的系統一定能安裝 64 位元應用程式。

架構選錯時，通常在安裝或啟動階段就會出現錯誤，不必反覆修改訂閱。先開啟系統的「關於」頁面確認裝置資訊，再下載相應平台的版本。通用 APK 可支援多種架構，但不會因此帶來更好的網路效能。

客戶端與設定相容性

v2rayN 適用於桌面環境；v2rayNG 與 v2flyNG 適用於 Android。v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心，支援的協定與傳輸選項會依版本而異。訂閱中出現 VMess、VLESS 或 Trojan，不代表所有延伸設定都能通用。

請先查看設定提供者註明的客戶端與版本需求。匯入後若出現不支援的傳輸方式或欄位，應確認相容性，而不是只更換安裝檔架構。Project V、V2Fly 與 Xray 是相關的開源技術生態系；實際操作可透過圖形介面客戶端完成，並在使用說明中進一步了解核心概念。

安裝後的操作順序

匯入訂閱與設定代理

安裝檔只包含客戶端程式。伺服器位址、驗證資訊與訂閱內容須另外準備；客戶端安裝完成不代表已建立連線。

01 / 安裝與啟動

先確認程式能正常開啟

完成安裝後，從系統應用程式清單啟動客戶端。Windows 請先完整解壓縮安裝檔，macOS 請先複製 App，Linux 請先處理相依套件，Android 則先完成安裝授權。若尚未進入主畫面就已關閉，應優先檢查系統相容性、執行環境與檔案權限，此時修改訂閱網址通常沒有幫助。

首次執行時先保留預設監聽設定。記下客戶端使用的本機連接埠，確認沒有其他代理程式占用相同連接埠，再匯入設定。請勿同時啟動多個舊版視窗，以免誤判目前使用中的設定。

02 / 訂閱與伺服器

新增群組，再更新訂閱

v2rayN 通常可在「訂閱分組設定」新增群組，輸入名稱與網址並儲存，再執行訂閱更新。v2rayNG 則在「訂閱分組設定」新增網址，再返回主畫面更新訂閱。不同版本的選單名稱可能略有差異，操作重點都是先儲存網址，再取得伺服器清單。

單一分享連結與訂閱網址是不同內容。複製連結後，請使用與格式相符的匯入功能。更新完成後還須手動選擇伺服器；只看到清單，不代表客戶端已開始接管應用程式流量。

03 / 代理與驗證

設定模式，再測試實際連線

桌面版可先使用系統代理模式，讓遵循系統代理設定的應用程式透過本機連線。若要代理其他應用程式，請先了解 TUN 的權限、路由與 DNS 設定需求。Android 點選連線後須確認系統 VPN 要求，並檢查是否有其他 VPN 服務正在執行。

驗證時請同時查看客戶端記錄並實際使用應用程式測試。延遲測試結果只反映特定測試方式，不能取代完整的連線驗證。若瀏覽器正常但某個應用程式無法連線，先確認該程式是否使用系統代理，再判斷是否需要調整代理範圍。

依步驟完成首次連線 → 查看桌面版與 Android 的訂閱匯入位置 →

保留設定與排查問題

更新前先備份，失敗時分階段排查

分清客戶端更新與訂閱更新

下載新版客戶端是更新應用程式；訂閱更新則是重新取得群組中的伺服器設定，兩者互不相同。訂閱失效、存取憑證變更或更新網址錯誤，通常無法靠重新安裝客戶端解決。請先查看「訂閱分組設定」中的網址，再依記錄判斷是網址有誤、網路要求失敗，還是內容格式不受支援。

升級前先停止連線並結束客戶端，再使用程式提供的備份或匯出功能保存必要設定。請特別記下訂閱群組、自訂路由、本機監聽連接埠、DNS 與 TUN 狀態。跨版本移轉時，先閱讀設定變更說明，再決定要匯入哪些內容；不要把舊資料夾中的所有檔案直接覆寫到新版資料夾。

依問題發生階段排查

下載未完成時，先檢查瀏覽器下載紀錄、剩餘空間與網路連線；安裝失敗時，檢查系統版本、架構、套件格式與舊版簽章；啟動失敗時，檢查執行相依套件與權限；程式能啟動但無法連線時，再檢查訂閱、伺服器選擇、系統代理、路由與 DNS。保留完整錯誤訊息，比只說「打不開」更容易找到處理方式。

從一款客戶端切換到另一款時，先結束舊程式並清除舊的系統代理設定。新客戶端使用的本機連接埠可能不同，應用程式內手動填寫的代理設定也要一併調整。測試完成後，確認只保留預期使用的代理或 VPN 服務，避免多個連線入口同時運作而造成結果不一致。

遇到訂閱問題，可查看訂閱更新失敗排查；若要了解各平台的權限與路由差異，可依跨平台安裝設定說明逐項確認。下載時不必先修改所有進階設定，先完成基本可用的設定，再逐步新增自訂規則。

下載常見問題

安裝檔選擇與更新

Windows 桌面版和經典 WPF 版該選哪個？

初次安裝可先選 Desktop 桌面版，採用新一代跨平台介面。習慣傳統 Windows 操作方式的使用者可選 WPF 經典穩定版。兩者都需確認各自版本的執行環境，安裝檔也不要解壓縮到同一個資料夾。

Android 該下載 arm64 還是通用版？

2015 年後推出的主流手機通常可優先試用 arm64，但仍須確認系統支援 64 位元應用程式。若不確定裝置架構，或 arm64 安裝檔無法安裝，可改用通用版。通用版包含多種架構，檔案通常較大，但不代表連線速度更快。

安裝檔下載完成，為什麼還是無法連線？

客戶端不會附上可直接使用的伺服器設定。請匯入有權使用的訂閱網址或分享連結，更新並選擇伺服器，再設定系統代理或啟動 Android VPN 連線。最後查看記錄並實際使用應用程式確認是否生效。

更新客戶端前要保留哪些設定？

先停止連線並結束舊版客戶端，使用程式提供的備份或匯出功能，保存訂閱群組、自訂路由及必要設定。備份可能含有敏感設定，請存放在受保護的位置。更新後確認監聽連接埠、系統代理狀態與路由模式，再恢復日常使用。

macOS 顯示無法開啟 App，該怎麼處理？

先確認下載的安裝檔符合晶片架構，再將 App 拖到「應用程式」資料夾。確認來源可信後，可到「系統設定」的「隱私權與安全性」查看是否有「仍要打開」選項。若系統指出 App 已損毀或有風險，請勿略過警告，應重新下載並確認相容性。

Linux 的 deb、rpm 和 arm64 安裝檔如何選擇？

先依 Linux 發行版選擇安裝檔格式：Debian、Ubuntu 系統通常使用 deb，Fedora、RHEL 系統通常使用 rpm；再確認處理器是 x86_64 或 ARM64。格式相同不代表適用所有發行版版本，仍須檢查套件管理器列出的相依套件與系統函式庫需求。