安裝檔索引GUI

V2Ray 用戶端下載

桌面系統選 v2rayN;Android 依設定選 v2rayNG 或 v2flyNG。先確認作業系統,再核對架構與安裝檔格式。

  1. 選擇作業系統
  2. 確認系統架構
  3. 確認安裝檔格式或介面版本

依作業系統選擇安裝檔

切換分頁以選擇要安裝的裝置。替其他裝置下載時,請以該裝置的系統資訊為準。

Windows 安裝檔

v2rayN

v2rayN

優先推薦 7.24.1

桌面版採用新一代跨平台介面,適合首次安裝,或希望在不同桌面系統上維持一致操作體驗的使用者。經典 WPF 版保留熟悉的 Windows 版面,適合想沿用原有介面與操作習慣的使用者。兩者是可獨立使用的安裝版本,擇一即可。

兩個下載入口提供的都是 ZIP 檔。請先完整解壓縮至可寫入的資料夾,再執行檔案中的安裝程式。請勿直接在壓縮檔預覽視窗中連按兩下執行。從舊版移轉時,先結束系統匣中的舊用戶端,再安裝並測試,避免兩個程式同時占用本機連接埠。

系統需求

檢查項目適用條件
系統與架構建議使用仍受支援的 64 位元 Windows 10 或 11;本頁提供的兩個安裝檔皆為 x64。
確認方式前往「設定 → 系統 → 關於」,查看系統類型並確認處理器架構與系統位元數。
執行環境若出現執行階段元件提示,請依提示確認所需元件、版本與位元數。

安裝程式能開啟,不代表用戶端已成功啟動。首次執行時請檢查系統匣與主視窗,確認可以開啟設定後再匯入設定。

安裝、升級與回復檢查

先確認問題發生在哪個階段:下載、安裝、啟動,還是連線。前一階段已完成,就從下一階段開始檢查,別把所有異常都歸咎於安裝檔。

01 · 安裝前

記下系統資訊與舊版來源

替自己或同事安裝時,先記下目標裝置的系統版本、架構與選用的檔名。用同一台電腦替多部裝置準備安裝檔,很容易在下載紀錄中選錯架構相近的檔案。請將檔名與目標裝置逐一對應,尤其要分清桌面版與經典版、晶片架構,以及同一用戶端的兩種行動裝置安裝檔。

全新安裝只需準備安裝檔與設定來源。升級前則應先開啟舊用戶端,記下版本、介面版本、安裝管道與自訂資料位置,並分別記錄訂閱、手動節點、路由和本機連接埠。只記下訂閱網址通常不足以還原整套設定。設定與匯出檔可能包含敏感資訊,請存放在自己能控管的位置,不要附在公開的問題排查截圖中。

如果電腦由組織集中管理,請先確認帳號是否有安裝權限、App 應安裝在哪個資料夾,以及代理設定是否由組織統一提供。權限不足時,反覆解壓縮或改用相同架構的安裝檔通常無法解除安裝限制。將完整錯誤訊息交給裝置管理員,比在不同資料夾中一再嘗試更容易找出問題。

02 · 安裝時

依錯誤訊息判斷架構、相依性或覆蓋衝突

安裝程式提示 App 與裝置不相容時,請先回到系統資訊確認架構。架構正確但仍提示不支援,再檢查系統版本或安裝檔所需的執行元件。若套件管理器明確列出相依套件及版本範圍,請依此資訊排查,不要一概認定是「系統太舊」。

若下載完成後,壓縮工具回報無法開啟,請先確認瀏覽器下載工作已完成,並確認開啟的是本次下載的檔案,而非同名舊檔或尚未下載完成的暫存檔。外層壓縮檔應先完整解壓縮;磁碟映像檔應先開啟再複製 App;套件則交由系統安裝程式處理。手動更改副檔名無法轉換檔案格式。

無法覆蓋安裝相同的 App 時,先比較新舊版本的安裝管道與版本。錯誤若指出簽章衝突,換成通用版也無法解決;若指出版本降級,請確認是否誤選較舊的安裝檔。若必須解除安裝,請先確認資料已匯出且有辦法還原。解除安裝 App 可能會一併刪除本機資料,不建議把它當成第一個測試步驟。

03 · 首次啟動

先確認介面能啟動,再測試設定

安裝後請從這次的安裝位置開啟用戶端,確認能進入主畫面並查看版本資訊。關閉桌面視窗後,程式可能仍在系統匣或選單列執行;再次開啟前,請先確認是否已有執行中的程式。若程式一開啟就結束,請記下錯誤訊息與結束前的操作,不要先匯入所有舊設定才開始排查。

介面正常後,請依訂閱匯入步驟新增設定。先選一筆已知可用的設定,確認用戶端能否建立連線。看得到設定清單只代表匯入成功,不能證明網路流量已如預期經由代理傳送。若無法建立連線,先查看用戶端記錄;若連線已建立但網頁仍無法開啟,再參考無法上網的排查方式。

若只有特定 App 的表現不同,請先記錄受影響的 App,以及是否已啟用系統代理。有些 App 使用自己的代理設定,不一定會採用系統選項。在其他條件不變的情況下,用同一個 App 比較連線前後的結果,再檢查路由分流。同時修改連線與路由設定,會讓結果難以判讀。

04 · 升級

先備妥可還原的資料,再替換舊版

若用戶端提供備份功能,請優先使用內建的備份或匯出入口。將產生的檔案存放在程式資料夾之外,並記下建立備份時使用的版本、備份包含哪些設定,以及哪些設定需要手動重建。跨用戶端移轉時,不要將整份應用程式資料直接覆蓋到新用戶端的資料夾;不同用戶端的備份結構與欄位不一定相同。

切換前先結束舊程式,停用由舊程式設定的系統代理,再啟動新版。還原後請確認設定是否完整、原本的自訂連接埠是否保留,以及開機啟動項目是否仍指向舊位置。測試通過前不要立即刪除舊資料夾。若暫時需要保留兩套程式,也不要同時啟動,或讓兩者寫入同一份設定。

回復舊版時,請優先使用與舊版本相符的備份。新版寫入的資料不一定能由舊版讀取。完成回復後,先還原一筆設定並測試,再還原群組與自訂路由。若新舊版本在同一個網路環境都出現相同問題,就不必再反覆更換安裝檔,應改查連線、訂閱或系統代理的相關章節。

下載與安裝常見問題

Windows 首次安裝該選桌面版還是 WPF 版?

首次安裝可先選桌面版。若已在使用經典 WPF 版,且想保留原有介面與操作習慣,可繼續選 WPF 版。兩個下載入口都是 x64 安裝檔,請先在系統資訊確認系統類型。

macOS 如何分辨 Apple Silicon 和 Intel?

打開蘋果選單中的「關於這台 Mac」。「晶片」顯示 Apple M 系列時選 Apple Silicon;「處理器」顯示 Intel 時選 Intel。更換電腦後請重新確認,不要直接沿用舊電腦的下載紀錄。

Android 通用版安裝檔能解決簽章衝突嗎?

不能。通用版是為了支援多種處理器架構;簽章衝突則表示不符合覆蓋安裝條件。請優先沿用原本的安裝管道;若必須移轉,先確認設定可以還原,再解除安裝舊 App 並重新安裝。

Linux 應按安裝檔格式選,還是按處理器架構選?

兩者都要符合。先依發行版選擇 deb 或 rpm,再依目前系統的 x86_64 或 arm64 架構選擇對應的下載入口。能辨識檔案格式不代表相依套件一定符合需求,也要確認發行版版本。

設定已匯入,安裝新版前還需要備份嗎?

需要。訂閱項目可以重新下載,不代表手動節點、群組與路由設定也能還原。升級前請先使用用戶端提供的備份或匯出功能,並將備份存放在舊程式目錄之外。

為什麼用戶端發布版本和安裝檔名稱不同?

卡片上的版本取自清單中的應用程式版本欄位,安裝檔名稱則來自各下載入口的檔案紀錄,兩者可能暫時不一致。若要安裝特定版本,請先確認下載入口對應的檔名;無法從檔名確認版本,或兩處資訊不一致時,請勿直接覆蓋升級。