用戶端發行版本/平台選擇
V2Ray 用戶端下載
桌面端請選 v2rayN;Android 端建議優先選 v2rayNG,也可依設定需求選擇 v2flyNG。先選作業系統,再確認處理器架構與套件類型。
v2rayN
Windows x64 · 7.24.1
首選
桌面版採用新一代跨平台代理介面,適合初次安裝,或希望在不同桌面系統上使用相近操作方式的使用者。WPF 版保留經典 Windows 介面,適合已熟悉舊版選單與設定流程的使用者。兩者是同一款用戶端的不同介面版本,不必為了支援某種訂閱而同時安裝。
這兩個下載連結提供的都是含安裝程式的 ZIP 檔。請先解壓縮至可寫入的資料夾,再開啟其中的安裝程式;不要直接從壓縮檔預覽視窗執行。升級或切換介面版本前,記下目前使用的設定位置,並結束系統匣中的舊用戶端。
v2rayN
macOS · 7.24.1
從 Apple 選單開啟「關於這台 Mac」。若顯示 Apple M 系列晶片,請選 Apple Silicon 套件;若顯示 Intel 處理器,請選 x64 套件。選擇依據是目前這部電腦的晶片,不是序號、購買年份,或另一部電腦正在使用的版本。
開啟 DMG 後,依磁碟映像中的說明將應用程式複製到目標位置,再從該位置啟動。首次啟動若遇到系統提示,請先確認提示與處理器架構、系統版本或裝置管理政策何者相關;重新下載另一種架構的套件,無法解決系統版本限制。
v2rayNG
Android · Xray · 2.2.6
首選
2015 年後推出的主流手機可優先選 ARM64;準確的判斷依據是裝置系統是否支援 arm64-v8a。無法確認支援的 ABI 時,可先選通用版。通用版包含多種架構的元件,通常檔案較大,但不會改變最低 Android 版本需求。
卡片上的版本資訊來自發行清單,可能與下載連結指向的檔名不同。若要升級現有安裝,請以所選套件的實際版本與發行管道為準,並在安裝前再次確認系統安裝畫面顯示的資訊。
v2flyNG
Android · V2Fly · 1.10.31
其他選擇
適合已有 V2Fly 設定、希望延續原有使用方式的使用者。確認裝置支援 arm64-v8a 時請選 ARM64;不確定裝置 ABI 時請選通用版。更換用戶端前,先確認目標用戶端能否辨識原設定使用的協定、傳輸方式與安全層。
更換用戶端不等於覆蓋升級。請先保留原設定,再於新用戶端中測試一條連線;測試期間不要讓兩個用戶端同時嘗試接管本機流量。
v2rayN
Linux · 7.24.1
ARM64 deb
ARM64 rpm
先依發行版選擇套件格式,再確認架構。Debian、Ubuntu 通常選擇 deb;此處的 rpm 帶有 el10 標示,請確認目標發行版及其相依性需求。套件管理器能辨識 rpm 格式,不代表這個 rpm 能在目前系統上執行。
安裝步驟/設定遷移
安裝前確認三項資訊
分別確認系統版本與架構
安裝失敗時,先判斷是套件選錯,還是裝置不符合執行條件。系統版本會決定可使用的介面與執行階段程式庫,架構則決定套件中的程式能否在目前環境執行,兩者無法互相推論。兩部電腦即使同為 64 位元,一部可能使用 x64,另一部則是 ARM64;即使處理器相同,安裝不同版本的作業系統後,可執行的用戶端版本也可能不同。遠端協助時,請對方查看目標裝置的資訊,不要依自己的裝置型號推測。
套件格式須符合安裝方式
副檔名決定下載完成後應使用哪個程式處理。ZIP 先解壓縮,DMG 先開啟磁碟映像,APK 由 Android 安裝介面處理,deb 和 rpm 則交由對應的套件管理器處理。在瀏覽器中開啟下載記錄,不代表安裝已完成。若系統畫面顯示檔案無法開啟,請先確認下載已完成,且所選格式適用於目前系統。不要更改副檔名,嘗試在其他平台安裝;更改名稱不會轉換套件或其中的可執行程式。
區分首次安裝、覆蓋升級與更換用戶端
首次安裝只需選對套件與執行環境;覆蓋升級還須考量版本、發行管道與現有資料。更換用戶端則要另外檢查設定相容性,不能只因為能匯入訂閱,就認定所有項目都可使用。若原用戶端管理多個群組,請先記下目前選取的群組、常用伺服器、代理模式與自訂路由。若備份檔含有訂閱網址或驗證資訊,請存放在安全的位置,不要隨故障截圖一併上傳或轉傳。
首次啟動與升級後的確認
安裝完成後,先確認介面能正常開啟,再匯入一筆有權使用的設定進行測試。不要同時變更訂閱、路由規則與接管模式,否則發生問題時很難判斷原因。若先前使用系統代理,升級後可先沿用此模式,測試遵循系統代理設定的應用程式;有需要時再另外測試 TUN。兩種模式的流量接管範圍不同,瀏覽器測試成功不代表其他應用程式也使用相同路徑。
遷移時建議依序檢查「群組可見 → 項目可讀 → 單筆連線可用 → 目標應用程式可存取」。訂閱更新後看不到項目,先檢查匯入或更新記錄;項目已顯示但無法連線,再檢查設定中的協定、傳輸方式與安全層;用戶端顯示已連線,但目標應用程式沒有變化,則優先查看代理模式與路由規則的符合情況。依這三個層次排查,比直接重新安裝更容易保留原有設定與診斷線索。
若問題只在升級後發生,先記下出錯步驟與系統提示,再逐項比對備份中的設定。桌面端也要確認舊程序是否仍在系統匣中執行,以及結束後系統代理是否如預期還原。行動裝置切換用戶端前,先停止上一個用戶端的連線。需要圖形介面操作步驟時,請參閱訂閱匯入與連線教學;若懷疑項目與核心不相容,請先查閱協定與核心手冊。
下載與安裝常見問題
Windows 桌面版與經典 WPF 版該怎麼選?
首次安裝可從桌面版開始;若想沿用經典 Windows 介面與選單配置,請選 WPF 版。切換版本前先備份設定,首次啟動新版本時,避免兩個用戶端同時修改系統代理。
Android 升級安裝時提示簽章不一致,該怎麼辦?
先確認已安裝版本的發行管道,並優先從相同管道取得更新。若確定要切換管道,先備份設定並確認可還原,再解除安裝舊版後安裝新版。解除安裝可能會清除應用程式資料。
macOS 下載後提示應用程式不適用於這部電腦,該怎麼辦?
先在「關於這台 Mac」確認晶片或處理器,再對照發行說明確認系統版本。Apple Silicon 請選 ARM64 套件,Intel 機型請選 x64 套件。架構符合不代表目前的系統版本也符合需求。
Linux 可以在所有發行版使用相同套件格式安裝嗎?
不行。先依發行版選擇 deb 或 rpm,再確認處理器架構與目標發行版。尤其是帶有 el10 標示的 rpm,不應只因系統支援 rpm 就跨發行版強制安裝。
安裝成功後,為什麼用戶端裡沒有伺服器?
用戶端安裝套件不含訂閱或伺服器設定。開啟用戶端後,匯入你有權使用的訂閱網址或單一伺服器設定;若清單仍是空的,請先檢查匯入或更新記錄。