v2rayN
桌面版採用新一代跨平台介面,適合首次安裝。WPF 版是 Windows 經典版本,適合熟悉原有介面與操作方式的使用者。兩個版本擇一即可。
安裝檔選擇
先選擇作業系統,再確認處理器架構。電腦請使用 v2rayN;Android 裝置建議使用 v2rayNG,需要 V2Fly 核心時則選擇 v2flyNG。
桌面版採用新一代跨平台介面,適合首次安裝。WPF 版是 Windows 經典版本,適合熟悉原有介面與操作方式的使用者。兩個版本擇一即可。
| 檢查項目 | 需求與確認方式 |
|---|---|
| 作業系統 | 建議使用仍受支援的 Windows 11;若使用舊版系統,請先確認此版本及其執行階段的需求。 |
| 架構 | 此處提供 x64 安裝檔。請在「設定 → 系統 → 系統資訊」查看系統類型與處理器。 |
| 安裝 | 先解壓縮 ZIP,再執行檔案中的安裝程式。若明確提示缺少執行階段,請依提示確認版本與架構。 |
請分清系統位元數與處理器架構。系統標示「64 位元」不代表處理器一定是 x64。若裝置使用 ARM,請先確認目前的 Windows 是否支援模擬執行此 x64 版本;此處提供的兩個下載項目都不是原生 ARM 版本。
安裝前請先結束舊版。關閉視窗後,請檢查工作列通知區域;若圖示仍在,請從系統匣選單結束程式。兩套程式同時執行可能搶用監聽連接埠,或先後修改同一項系統代理設定。首次啟動時先確認介面正常,再匯入設定;不要同時開啟系統代理與 TUN 來排除問題。
若安裝程式一啟動就發生錯誤,請先保留完整錯誤訊息,並分清楚是「安裝程式無法執行」、「客戶端視窗無法開啟」,還是「開啟後連線失敗」。前兩種情況先檢查系統、執行階段或安裝目錄權限;若介面正常但連線失敗,再檢查設定與網路,不必先改用另一種介面版本。
從蘋果選單開啟「關於這台 Mac」。顯示 Apple M 系列晶片就選 Apple Silicon;顯示 Intel 處理器就選 Intel。請勿根據外觀或購買年份判斷。
| 檢查項目 | 需求與確認方式 |
|---|---|
| 作業系統 | 請使用仍受支援的 macOS;若使用舊版系統,請確認所選版本的最低系統需求。 |
| 晶片 | Apple Silicon 對應 arm64;Intel 對應 x64。 |
| 安裝 | 開啟 DMG,依磁碟映像檔中的說明將應用程式移至「應用程式」資料夾後再啟動。 |
複製完成後再退出磁碟映像檔。請勿將掛載中的磁碟映像檔當作日常啟動應用程式的位置。如果安裝新版後仍開啟舊版,請從 Finder 的「應用程式」資料夾直接啟動新副本,並確認 Dock 中的舊圖示是否仍指向另一份應用程式。
若系統提示目前的 macOS 版本不相容,請先確認系統版本;若提示無法執行此應用程式,再核對晶片與下載檔案的架構。遇到安全性提示時,請先看清楚原因,分辨是開發者未受認證、應用程式已損毀,還是系統版本不符。請勿一概視為網路問題,也不要全面關閉系統保護。
採用 Xray 核心。2015 年後推出的主流手機通常可選 arm64;請先確認系統支援 arm64-v8a 再下載。若不確定裝置架構,可先選通用版。
採用 V2Fly 核心。只有在此版本支援現有設定所需的協定與傳輸方式時,才建議用它取代原有客戶端。通用版支援更多架構,但不會因此增加功能選項。
| 檢查項目 | 需求與確認方式 |
|---|---|
| 作業系統 | 在「關於手機」查看 Android 版本;裝置須符合所選版本的最低系統需求與安裝政策。 |
| 架構 | 請以系統支援的應用程式 ABI 為準,不能只因晶片是 64 位元就認定可以安裝 arm64 版本。 |
| 安裝 | 裝置必須允許目前使用的瀏覽器或檔案管理員安裝應用程式;受管理的裝置則依管理員政策辦理。 |
安裝授權與連線授權是兩回事。系統可能會先要求允許目前的下載來源安裝應用程式;完成後可以撤銷這項授權。首次啟動代理服務時,也可能出現系統 VPN 連線要求。安裝成功只代表應用程式可以執行,不代表已獲准建立連線,也不代表已匯入設定。
從其他版本升級時,若出現「未安裝應用程式」提示,請先記下系統訊息,不要立刻刪除原有應用程式。系統可能因架構不相容、應用程式簽章不同、目標版本低於已安裝版本,或裝置政策而拒絕安裝。請先確認原因,再決定是否更換安裝檔或備份後遷移;解除安裝通常也會刪除該應用程式的本機資料。
v2rayn_7.24.1_arm64.deb
v2rayN-7.24.1-1.el10.aarch64.rpm
Debian、Ubuntu 系統通常選擇 DEB。使用 RPM 的系統請先確認發行版與相依套件;此處的 RPM 檔名標示 el10,能安裝 RPM 不代表一定相容。
| 檢查項目 | 需求與確認方式 |
|---|---|
| 執行環境 | 需要圖形桌面工作階段,並符合所選版本的系統相依套件需求。 |
| 架構 | uname -m 輸出 x86_64 對應 x64;aarch64 對應 arm64。混合架構環境請以套件管理工具的目標架構為準。 |
| 套件格式 | 依發行版選擇 DEB 或 RPM,並由系統的軟體安裝工具處理相依套件。 |
架構與套件格式須分別符合需求。DEB 使用 amd64 表示 x64,並非只適用於 AMD 處理器;RPM 通常標示為 x86_64。同樣地,DEB 的 arm64 與 RPM 的 aarch64 都代表 64 位元 ARM,但兩種套件格式不能互換。
若軟體安裝工具提示相依套件無法滿足,請保留第一則缺少相依套件或版本衝突的訊息,並先確認發行版版本與軟體來源狀態。不要強制略過相依套件,也不要將其他發行版的套件混裝到系統中。若安裝成功但從應用程式選單啟動沒有反應,請檢查目前是否處於圖形工作階段,並分辨是應用程式啟動異常還是代理設定錯誤。
選定平台後,請根據按鈕下方的檔名確認格式與架構。若瀏覽器仍顯示下載中,請等檔案下載完成再開啟。若儲存下來的是網頁而非安裝檔,請返回下載項目重試,並記錄瀏覽器顯示的是網路錯誤、存取受限還是連結失效。請勿只修改副檔名,就把網頁當成安裝檔。
若卡片上的清單版本與檔名不同,請先分辨應用程式版本欄位與個別下載項目。選擇安裝檔時以該項目的檔名為準,升級前再對照已安裝的版本。不要因為下載時間較新,就認定剛儲存的檔案是較新版本;也不要只憑壓縮檔名稱,就推斷執行中的程式已成功更新。
更換版本前,請先記下目前的客戶端、訂閱群組、預設選取的節點與自訂路由。只保存訂閱網址不等於完整備份設定:手動新增的節點、本機監聽連接埠與路由規則可能需要另外匯出。訂閱網址可能包含存取憑證,備份檔應存放在受控裝置中,不要貼到公開的客服單或聊天群組。
安裝後先確認程式能否啟動,再確認是否已讀取舊設定。若需要手動還原,請先匯入必要設定並檢查清單,不要直接覆蓋整個新目錄。請保留舊版或舊備份,直到新版能啟動、讀取設定並完成連線測試,再決定是否清理。
首次安裝客戶端時,清單為空是正常情況。請將既有訂閱匯入相應群組並手動更新,或新增已知的伺服器設定。確認節點清單載入後,選擇一個節點,再檢查客戶端記錄是否有啟動錯誤。訂閱更新失敗是發生在取得設定的階段,不等於已匯入的節點無法連線;兩種情況應分開排查。
桌面版還要分辨客戶端正在執行,與目標應用程式是否使用代理。請先用已知可連線的網站測試,再確認目標應用程式是否遵循系統代理設定。啟用 TUN 或修改路由前,請保留一組已確認可用的基本設定,每次只調整一項。詳細操作請參閱匯入訂閱與連線教學;若記錄已指出連接埠遭占用,請參閱本機監聽連接埠排查。
卡片上的版本來自應用程式清單,檔名則對應各下載項目,兩者可能不同步。下載前請先確認所選項目的檔名;安裝後若要確認實際版本,請查看客戶端的「關於」頁面或系統的應用程式資訊。
不需要。首次安裝可先選擇採用跨平台介面的桌面版;如果熟悉經典介面或想沿用原本的操作習慣,可選擇 WPF 版。切換前請備份設定並完全結束舊版,避免兩套程式同時管理系統代理或搶用本機監聽連接埠。
只有在問題出於架構不相容時,改用通用版才可能有幫助。也請檢查 Android 版本、可用空間,以及裝置上是否已安裝簽章不同或版本較新的應用程式。若系統明確指出簽章衝突,請先備份設定,再決定是否解除安裝舊版。
升級前先結束客戶端,再使用客戶端提供的匯出功能保存設定,或依目前版本的說明備份資料目錄。記下訂閱群組、自訂路由、本機連接埠與代理模式。確認新版已讀取設定後,再清理舊目錄或舊版應用程式。
安裝檔只包含客戶端。請先匯入既有訂閱或伺服器設定;使用訂閱時,還要執行更新並確認節點已出現在清單中。確認設定已載入後,再選擇節點、啟用所需的代理模式並測試連線。