依平台選擇安裝檔開源客戶端

V2Ray 客戶端下載

桌面平台使用 v2rayN;Android 首選 v2rayNG,也可依核心需求選擇 v2flyNG。先選裝置系統,再確認晶片架構或套件格式。

各平台安裝檔

v2rayN

v2rayN

首選

7.24.1Windows · x64 · ZIP

Desktop 是採用新一代跨平台介面的桌面版,適合初次安裝。WPF 是經典穩定版,適合熟悉 Windows 版介面與系統匣選單的使用者。兩者擇一即可。

Windows 系統需求

檢查項目安裝條件
系統類型在「設定 → 系統 → 關於」確認系統為 64 位元,處理器為 x64。
安裝檔先將 ZIP 解壓縮至可寫入的資料夾,再開啟安裝程式。
執行環境若系統版本或執行階段不符合需求,請依安裝程式的提示處理。

安裝與版本切換

在系統資訊中同時確認「64 位元作業系統」和「x64 型處理器」。只看到「64 位元」還不夠,不同架構的處理器都可能執行 64 位元系統。確認後,使用檔案總管的「全部解壓縮」解開 ZIP,不要直接在壓縮檔預覽視窗中執行安裝程式。這樣安裝程式讀取套件內的其他檔案時,才不會只取得暫存解壓縮的一個檔案。

從經典 WPF 版切換至桌面版時,先備份節點與訂閱群組,再從系統匣結束舊版,而不是只關閉主視窗。首次啟動新版後,檢查節點清單、路由選擇和本機監聽連接埠。如果客戶端已開啟,但網頁仍無法瀏覽,先確認舊版是否留下系統代理設定,以及代理指向的連接埠是否仍有程式在監聽;不要急著重新安裝或連續更換節點。

安裝與遷移

安裝前後檢查

分別確認安裝、匯入與代理接管是否正常。遇到問題時,先找出哪個步驟尚未完成。

確認下載完成,再開啟安裝檔

瀏覽器可能還在寫入下載檔案。先開啟瀏覽器的下載記錄,確認下載工作已完成,再前往目標資料夾。若檔案系統隱藏副檔名,可透過「內容」或「顯示簡介」辨別 ZIP、DMG、APK、deb 和 rpm。若出現檔案損毀或無法開啟的提示,先記下錯誤訊息與下載狀態;不要試圖變更副檔名,將一種套件格式改成另一種。

先備份,再取代舊版 App

已在使用客戶端時,請備份節點、訂閱群組與自訂路由,並記下目前使用的本機連接埠和代理接管模式。手動新增的節點不一定包含在訂閱中,自訂路由也不會隨訂閱更新自動還原。備份可能含有訂閱網址和節點認證資訊,請存放在自己能控管的資料夾,不要放進公開雲端硬碟、聊天截圖或問題回報中。安裝新版後,先確認這些設定仍可讀取,再清除舊檔案。

先確認節點,再測試網頁

初次安裝後清單是空的,屬於正常情況。以 v2rayN 為例,透過「訂閱群組」新增網址,再執行「更新全部訂閱」,確認清單中確實出現節點。接著選擇一個節點,先檢查客戶端記錄是否有連線或交握錯誤,再選擇系統代理或 TUN。排除問題時,別同時開啟多個客戶端,也不要一次變更多項設定;每次只調整一項,再重試同一個網頁,比較容易找出原因。

需要逐步操作說明,請參閱快速入門;遇到系統權限、套件相依性或代理接管差異,可參考安裝完整指南。

下載常見問題

安裝檔選擇、覆蓋安裝與首次連線。

Windows 兩種安裝檔都需要下載嗎?

不需要。初次安裝可選擇採用新一代跨平台介面的桌面版;習慣經典 Windows 介面,或需要沿用相關操作說明,則可選經典 WPF 版。排除連線問題時只執行一個客戶端,避免兩個程式同時變更系統代理設定。

macOS 安裝檔該選 Apple Silicon 還是 Intel?

從 Apple 選單開啟「關於這台 Mac」。「晶片」欄顯示 Apple M 系列時選 Apple Silicon;「處理器」欄顯示 Intel 時選 Intel。請依這台 Mac 的實際晶片選擇,不要依購買年份或硬碟容量判斷。

Android 通用版能解決所有安裝失敗問題嗎?

不能。通用版適合不確定裝置應用程式架構的情況;若安裝失敗是因為系統版本過舊、安裝來源權限不足,或與現有應用程式簽章衝突,改用通用版也無法解決。先查看系統提示,再決定是否更換安裝檔。

Linux 安裝檔要先看格式還是架構?

先依發行版的套件系統選擇 deb 或 rpm,再依目前的系統架構選擇 x64 或 arm64。即使兩者都符合,也要確認安裝程式列出的發行版相容性與相依套件需求。

升級前需要保留哪些設定?

先備份現有節點、訂閱群組與自訂路由,並另外記下本機監聽連接埠和目前的代理接管模式。升級前先結束舊版;新版啟動後確認節點與路由正常,再啟用系統代理或 TUN。請妥善保管備份與訂閱網址。

安裝成功後,為什麼沒有可用的伺服器?

安裝檔只包含客戶端,伺服器節點需要另外設定:匯入自己的節點設定,或新增有權使用的訂閱並更新。看到節點後,選擇要使用的項目,再設定代理接管方式並測試連線。

下載 V2Ray 客戶端