v2rayN
7.24.1第一次安裝建議選 Desktop。它採用新一代跨平台介面;WPF 則是 Windows 上經典且穩定的版本,適合想沿用熟悉版面配置的使用者。兩種下載項目都是 ZIP 格式,擇一下載即可。
下載後先用檔案總管選擇「全部解壓縮」,再開啟解壓縮資料夾中的安裝程式。請勿直接在壓縮檔預覽視窗中執行。若出現缺少執行環境的提示,記下提示中的元件名稱與架構,依該版本的需求處理,不必因此先改用另一種介面版本。
先選擇要安裝用戶端的系統,再依處理器架構與套件格式下載。桌面系統使用 v2rayN;Android 建議使用 v2rayNG,需要 v2fly 核心時再選 v2flyNG。
第一次安裝建議選 Desktop。它採用新一代跨平台介面;WPF 則是 Windows 上經典且穩定的版本,適合想沿用熟悉版面配置的使用者。兩種下載項目都是 ZIP 格式,擇一下載即可。
下載後先用檔案總管選擇「全部解壓縮」,再開啟解壓縮資料夾中的安裝程式。請勿直接在壓縮檔預覽視窗中執行。若出現缺少執行環境的提示,記下提示中的元件名稱與架構,依該版本的需求處理,不必因此先改用另一種介面版本。
從 Apple 選單開啟「關於這台 Mac」。若「晶片」顯示 Apple M 系列,請選 Apple Silicon;若「處理器」顯示 Intel,請選 x64。兩個檔案都是 DMG,副檔名相同,無法用副檔名區分晶片。
在 Finder 中開啟 DMG,依視窗提示將應用程式拖曳至「應用程式」資料夾,再從該處啟動;複製完成後可退出磁碟映像檔。若無法開啟,先確認是系統版本過舊、晶片架構不相容,還是系統阻擋啟動。請依實際提示處理,不要為了啟動單一應用程式而關閉整台裝置的安全防護設定。
v2rayNG 使用 Xray 核心。2015 年後推出的主流手機通常可選 arm64;不過部分機型雖採用 64 位元晶片,系統仍可能只支援 32 位元應用程式。若不確定系統支援哪種架構,請選通用版;它包含多種架構所需的元件,檔案通常較大。
v2flyNG 使用 v2fly 核心。若設定明確要求使用此核心,可選擇這個用戶端。兩款用戶端的設定不會自動共用,匯入前請確認協定與傳輸設定相容。通用版只會擴大安裝檔支援的處理器架構,不會讓用戶端支援更多協定,也不會改變連線方式。
先依發行版選擇格式:Debian、Ubuntu 系統通常選 deb;使用 RPM 套件管理的發行版則查看 rpm。再確認架構:amd64 和 x86_64 對應此處的 x64,aarch64 對應 arm64。即使處理器是 Intel,也可能應選標示為 amd64 的 deb。
格式相符不代表相依套件一定相容。若安裝程式提示找不到特定程式庫或版本,請先核對發行版與版本。本頁 rpm 檔名包含 el10 建置標記,不要只憑副檔名就認定適用於所有 RPM 系發行版。請勿使用強制安裝略過相依性檢查。
第一次安裝時,先確認系統與架構;若要保留現有設定,請先備份再安裝。若要在這台電腦上替另一台裝置下載,請依接收檔案的裝置資訊選擇安裝檔,不要依瀏覽器目前顯示的系統選擇。虛擬機器也是如此:請查看虛擬機器內的系統與處理器架構,而非主機品牌。
更新用戶端會取代應用程式;更新訂閱則只會重新讀取訂閱群組網址提供的設定。若發現某個群組的內容不正確,先試試「更新訂閱」,不必急著下載新版用戶端。如果是選單位置與教學截圖不同,請先記下用戶端名稱、已安裝版本及介面類型,再找適用該版本的操作說明。尤其在 Windows 上,桌面版與經典 WPF 版的選單配置不同,不代表其中一個安裝失敗。
若目前版本提供匯出或備份功能,請先使用用戶端內建功能儲存檔案,並確認備份檔案所在位置。訂閱群組、手動設定的路由、個別新增的設定及本機連接埠,不一定都包含在同一份訂閱中;只保存網址並不等於完整備份。備份可能包含私人訂閱網址或連線憑證,請存放在自己能控管的位置,不要連同錯誤截圖一起傳送。
更換安裝方式、發行管道或裝置時,別預設可以直接覆蓋安裝,也別假設能直接沿用舊程式的整個資料目錄。請先在目標裝置安裝相容的版本,再透過匯入功能還原可辨識的設定。若舊裝置上有自行修改的路由或連接埠,可在新裝置逐項核對,確認正常後再清除舊設定。
發生錯誤時,記下問題出現的步驟、用戶端名稱、系統版本、所選套件的架構及完整錯誤訊息。若只有瀏覽器下載失敗,先檢查下載;系統安裝程式拒絕套件時,先檢查相容性;程式已開啟但更新失敗時,再檢查訂閱與網路。將不同階段分開排查,比反覆下載同一個安裝檔更容易找出問題。
從選錯安裝檔、瀏覽器下載中斷,到安裝後清單仍是空的,依照實際提示逐步排查。
選一種即可。第一次使用可選桌面版;習慣經典介面,或正依照 WPF 版截圖尋找選單時,可選經典 WPF 版。切換前請先結束舊用戶端並備份設定。兩個版本可以下載留存,但不建議同時執行:若兩者嘗試監聽相同的本機連接埠,後啟動的版本可能無法正常運作,也可能讓你搞不清楚目前由哪個版本控制系統代理。
卡片上的版本來自應用程式清單,檔名則對應你實際選擇的下載項目,兩處數字可能不同。已安裝的版本請以用戶端的「關於」或系統應用程式詳細資訊為準。若需要確認特定版本,請先核對實際取得的檔案,以及安裝程式或系統顯示的資訊;仍無法確認時,不要把頁面版本號當成檔案版本,也別急著覆蓋原有安裝。
若提示架構不相容,可確認系統支援的架構後再試通用版;若提示與現有套件衝突,改用通用版通常無法解決。先查看儲存空間、系統版本與詳細錯誤,再確認裝置上是否已有同名用戶端,以及新舊套件是否來自相同發行管道。解除安裝可能會一併刪除訂閱與設定,請先備份,再決定是否重新安裝。
先確認瀏覽器的下載清單是否顯示完成,再核對副檔名與所選系統。Windows 的 ZIP 請先完整解壓縮;macOS 的 DMG 用 Finder 開啟;Android 的 APK 交由系統安裝程式處理;Linux 的 deb 或 rpm 則使用相應的套件管理工具。檔案尚未下載完成時,可在瀏覽器中重試;若反覆取得錯誤頁面,請記下選擇的下載項目與瀏覽器提示,不要只改副檔名就把錯誤頁面當成安裝檔。
安裝檔只會安裝用戶端,不會自動加入訂閱。v2rayN 請在「訂閱群組」新增網址後再執行更新;v2rayNG 請開啟「訂閱群組設定」,儲存網址後返回主畫面更新訂閱。更新後清單仍是空的話,先確認所選群組、連結是否完整及訂閱是否有效,再檢查連線設定。請勿將完整的私人訂閱網址貼到公開討論區。