v2rayN
桌面版採用新一代跨平台 UI,介面結構更接近 macOS、Linux 版本,適合首次安裝及想使用新版互動方式的使用者。經典 WPF 版採用 Windows 桌面介面,選單路徑更接近長期使用的傳統版本,適合已熟悉既有操作方式的使用者。首次使用通常優先下載桌面版;若目前工作流程依賴 WPF 介面,再選擇經典版。
用戶端下載與安裝包選擇
依作業系統與處理器架構選擇安裝包。桌面平台使用 v2rayN,Android 可在 v2rayNG 與 v2flyNG 之間選擇。頁面中的版本資訊由同源版本清單更新,下載前仍需確認平台、架構與軟體包格式。
平台安裝包
切換平台後查看固定的用戶端清單、主要安裝包、備選包與最低使用條件。每個標籤只列出適用於該系統的圖形化用戶端。
Windows x64
Windows 提供桌面版與經典 WPF 版。兩者皆可管理相同類型的訂閱、伺服器設定、路由規則與系統代理,主要差異在於介面技術與操作習慣。
桌面版採用新一代跨平台 UI,介面結構更接近 macOS、Linux 版本,適合首次安裝及想使用新版互動方式的使用者。經典 WPF 版採用 Windows 桌面介面,選單路徑更接近長期使用的傳統版本,適合已熟悉既有操作方式的使用者。首次使用通常優先下載桌面版;若目前工作流程依賴 WPF 介面,再選擇經典版。
| 項目 | 需求 | 選擇說明 |
|---|---|---|
| 作業系統 | 支援的 64 位元 Windows 桌面系統 | 維持系統元件與執行環境可正常使用。 |
| 處理器架構 | x64 | 本頁 Windows 安裝包適用於常見的 64 位元 Intel 或 AMD 處理器。 |
| 安裝方式 | 解壓縮後執行安裝程式 | 建議先完整解壓縮壓縮檔,再啟動其中的安裝程式。 |
| 首次設定 | 訂閱連結或單一伺服器設定 | 安裝完成後仍需匯入有效設定,用戶端不會自動產生伺服器資訊。 |
安裝前關閉正在執行的舊版視窗,避免設定檔處於寫入狀態。安裝完成後,可先開啟「訂閱群組」新增訂閱網址,再執行訂閱更新。匯入成功後選擇一個設定,依實際需求設定路由模式與系統代理。若程式能啟動但瀏覽器未如預期使用代理,應先檢查系統代理開關,而不是反覆重新安裝。
macOS 桌面
macOS 安裝包依晶片架構區分。Apple M 系列晶片選擇 arm64,Intel 處理器選擇 x64。晶片類型必須與安裝包一致。
v2rayN macOS 版使用與新版桌面用戶端一致的設定管理邏輯,可管理訂閱群組、節點設定、路由規則與記錄。下載前開啟系統選單中的「關於這台 Mac」,查看「晶片」或「處理器」欄位。顯示 Apple M 系列名稱時選擇 Apple Silicon;顯示 Intel 名稱時選擇 Intel。安裝包架構選錯時,常見情況是應用程式無法開啟,或系統提示架構不相容。
| 項目 | 需求 | 選擇說明 |
|---|---|---|
| 作業系統 | 支援的 64 位元 macOS | 建議先完成系統維護更新,再安裝目前的用戶端。 |
| Apple 晶片 | arm64 | 「關於這台 Mac」顯示 Apple M 系列時,選擇 Apple Silicon 包。 |
| Intel 晶片 | x64 | 「關於這台 Mac」顯示 Intel 處理器時,選擇 Intel 包。 |
| 安裝格式 | DMG | 開啟磁碟映像檔,依系統介面完成應用程式安裝。 |
首次開啟後,系統可能要求確認網路相關權限。權限只決定應用程式能否建立本機代理及調整相關系統設定,不會取代訂閱匯入。完成授權後,先新增訂閱群組並執行更新,再選擇設定與路由模式。若更換至另一種晶片架構的裝置,應重新下載相符的新安裝包,不要直接複製舊裝置上的應用程式檔案。
Android 行動裝置
Android 首選 v2rayNG;需要使用 v2fly 核心分支時可選擇 v2flyNG。兩款用戶端皆提供 arm64 與通用安裝包。
v2rayNG 是 Android 平台的主要選擇,適合匯入訂閱、掃描設定 QR Code、管理伺服器清單及切換路由模式。2015 年後的主流手機通常採用 arm64 架構,優先下載 arm64 版可減少安裝包大小。無法確認裝置架構、裝置型號較舊,或 arm64 包無法安裝時,再選擇通用版。
v2flyNG 適用於需要 v2fly 核心分支的 Android 使用情境,設定管理方式接近常見的行動端用戶端。是否選擇它,主要取決於訂閱所使用的協定與伺服器端設定是否更適合 v2fly 相容路徑。一般使用者若沒有明確的核心需求,可先使用上方的 v2rayNG。
| 項目 | 需求 | 選擇說明 |
|---|---|---|
| 處理器架構 | arm64 或通用架構包 | 2015 年後的主流裝置通常優先選擇 arm64。 |
| 安裝格式 | APK | 使用系統安裝介面開啟已下載完成的安裝包。 |
| 用戶端選擇 | v2rayNG 或 v2flyNG | 預設選擇 v2rayNG;明確需要 v2fly 核心分支時選擇 v2flyNG。 |
| 首次連線 | 系統網路連線授權 | 啟動連線時,依系統提示確認用戶端的本機網路連線要求。 |
安裝完成後,可透過剪貼簿匯入訂閱連結,或使用用戶端提供的 QR Code 掃描入口匯入單一設定。匯入後先更新訂閱,再檢查伺服器清單是否出現有效項目。行動端的連線開關只代表本機網路通道已建立,實際可用性仍取決於設定參數、伺服器狀態、路由規則與 DNS 設定。若更新訂閱失敗,應分別檢查連結是否可存取、目前網路,以及更新要求是否需要透過既有代理。
Linux 桌面
Linux 安裝包依發行版軟體包格式及處理器架構區分。Debian 系統選擇 deb,RHEL 系統選擇 rpm,並依裝置在 x64 與 arm64 之間匹配。
v2rayN Linux 版提供圖形化的訂閱、伺服器、路由與記錄管理。Ubuntu、Debian 及其衍生發行版通常選擇 deb;Fedora、Rocky Linux、AlmaLinux、RHEL 系發行版通常選擇 rpm。常見桌上型電腦使用 x64,採用 ARM 處理器的裝置選擇 arm64。先判斷包格式,再判斷架構,可避免安裝程式回報軟體包不相容。
| 發行版或裝置 | 安裝包 | 架構選擇 |
|---|---|---|
| Debian、Ubuntu 及衍生發行版 | deb | 一般 Intel 或 AMD 桌面選擇 x64,ARM 裝置選擇 arm64。 |
| Fedora、Rocky Linux、AlmaLinux、RHEL 系 | rpm | x86_64 選擇 x64,aarch64 選擇 arm64。 |
| 桌面環境 | 可執行圖形化應用程式的桌面工作階段 | 精簡伺服器環境應先確認是否具備圖形桌面與相關相依套件。 |
| 網路設定 | 桌面系統代理或應用程式內代理 | 安裝完成後,依桌面環境確認系統代理是否實際生效。 |
可在終端機執行 uname -m 查看架構:常見輸出 x86_64 對應 x64,aarch64 對應 arm64。若套件管理器回報缺少相依套件,應先透過目前發行版的軟體來源補齊相依套件,再重新執行安裝。用戶端啟動後,匯入訂閱及選擇設定的流程與其他桌面版本相近,但系統代理入口可能因桌面環境不同而有所變化。若應用程式內連線正常而瀏覽器未生效,應檢查目前桌面環境的代理設定是否已正確寫入。
安裝後的設定路徑
安裝用戶端只是準備步驟。訂閱匯入、設定選擇、路由模式與系統代理共同決定應用程式是否能如預期運作。
先依作業系統選擇平台標籤,再核對晶片或處理器架構。Windows 本頁提供 x64 安裝包;macOS 依 Apple Silicon 與 Intel 區分;Android 依 arm64 與通用版區分;Linux 同時區分 deb、rpm、x64 與 arm64。不能只根據檔名中的版本號選擇。
桌面系統透過安裝程式或軟體包管理器完成安裝,Android 使用系統安裝介面開啟 APK。升級既有版本前先退出正在執行的用戶端,避免設定檔仍被占用。安裝完成後先確認用戶端能正常開啟,再繼續匯入設定。
訂閱連結適合集中管理多個伺服器項目,單一分享連結或設定適合臨時匯入。貼上訂閱網址時應避免多餘空格與換行,並確認連結仍在有效期限內。執行訂閱更新後,檢查用戶端清單中是否產生可識別的設定項目。
選擇一個設定後,再設定路由模式。日常使用通常從規則分流開始,只有明確需要時才調整為其他模式。桌面端還要確認系統代理狀態;行動端首次連線時需要回應系統網路授權。修改路由或 DNS 後,應重新載入設定,確保舊設定不再繼續生效。
用戶端選擇依據
三個名稱對應不同平台與核心生態。選擇時先看裝置平台,再看協定相容需求,不需要在同一台裝置上重複安裝所有用戶端。
v2rayN 支援 Windows、macOS 與 Linux,本頁桌面平台皆以它作為主要用戶端。它提供訂閱群組、伺服器清單、路由規則、系統代理、記錄及核心設定等圖形化入口。Windows 使用者還可在新一代桌面版與經典 WPF 版之間選擇,macOS 與 Linux 則依晶片、架構及軟體包格式選擇對應安裝包。
v2rayNG 適合 Android 日常設定管理,使用 Xray 核心處理相應協定與傳輸設定。它可匯入訂閱、分享連結與 QR Code,並透過系統網路連線機制接管需要代理的流量。對於沒有特定核心分支要求的行動端使用者,通常優先選擇 v2rayNG arm64 版。
v2flyNG 同樣面向 Android,但採用 v2fly 核心分支。它更適合已確認伺服器端設定、訂閱格式或協定組合需要該分支的情境。用戶端名稱相近並不代表所有設定行為完全一致,切換用戶端後應重新檢查訂閱解析結果、路由規則與 DNS 設定。
版本更新通常會帶來介面調整、協定能力變化、執行環境更新或問題修正。升級前應記下目前的訂閱群組、路由模式與系統代理狀態。桌面端若需要遷移設定,先在舊版本中確認設定目錄與匯出功能,再在新版本中依用戶端提供的匯入路徑還原。不要在新舊用戶端同時執行時修改同一份設定目錄。
Android 從 v2rayNG 切換至 v2flyNG,或從 v2flyNG 切換回 v2rayNG 時,應視為用戶端遷移,而非簡單覆蓋安裝。重新匯入訂閱後檢查項目數量、協定欄位、傳輸參數與路由規則。某個訂閱可以匯入,不代表其中每項設定都適用於目前的核心分支。
下載相關問題
以下問題涵蓋平台架構、軟體包格式與首次設定中最常見的選擇節點。
桌面版採用新一代跨平台介面,適合首次安裝、想使用新版操作結構,或需要與 macOS、Linux 版本維持相近體驗的使用者。經典 WPF 版基於 Windows 原生桌面技術,選單路徑更接近長期維護的傳統版本,適合已熟悉既有介面的使用者。
兩者皆適用於 Windows x64,也都能完成訂閱、設定、路由與系統代理管理。沒有既有使用習慣時先選擇桌面版;目前流程依賴 WPF 選單位置時,再選擇經典版。
開啟系統選單中的「關於這台 Mac」,查看晶片或處理器欄位。顯示 Apple M 系列晶片時選擇 Apple Silicon arm64 版;顯示 Intel 處理器時選擇 Intel x64 版。架構選錯通常會導致安裝包無法啟動,或系統直接回報應用程式與目前裝置不相容。
2015 年後的主流 Android 手機通常採用 arm64 架構,因此優先選擇 arm64 版。該版本只包含對應架構所需的元件,安裝包通常更精簡。無法確認裝置架構、裝置較舊,或 arm64 版無法安裝時,再改用通用版。
架構選擇不會改變訂閱內容與主要操作方式,只影響安裝包能否與處理器相符。已成功安裝 arm64 版時,不需要再安裝通用版。
Debian、Ubuntu 及其衍生發行版通常選擇 deb;Fedora、Rocky Linux、AlmaLinux、RHEL 系發行版通常選擇 rpm。確定格式後,還需要檢查處理器架構。終端機中 uname -m 顯示 x86_64 時選擇 x64,顯示 aarch64 時選擇 arm64。
軟體包格式與處理器架構是兩個獨立條件。即使選對 deb 或 rpm,架構錯誤仍會導致安裝失敗。
用戶端只負責管理設定、路由與系統代理。首次啟動後,仍需匯入有效的訂閱連結或單一伺服器設定,執行訂閱更新,選擇可用設定,並依使用情境啟用系統代理或行動端網路連線。
如果用戶端已在執行,但應用程式未如預期連線,請依序檢查訂閱是否成功解析、目前設定是否可用、路由模式是否合適、系統代理是否生效,以及 DNS 設定是否相符。完整排查流程請前往問題診斷頁面。