平台與架構選擇

V2Ray 用戶端下載

先選擇要安裝用戶端的系統,再依處理器架構與套件格式下載。桌面系統使用 v2rayN;Android 建議使用 v2rayNG,需要 v2fly 核心時再選 v2flyNG。

Windows 用戶端

安裝、升級與移轉

第一次安裝時,先確認系統與架構;若要保留現有設定,請先備份再安裝。若要在這台電腦上替另一台裝置下載,請依接收檔案的裝置資訊選擇安裝檔,不要依瀏覽器目前顯示的系統選擇。虛擬機器也是如此:請查看虛擬機器內的系統與處理器架構,而非主機品牌。

先確認要更新的是用戶端,還是訂閱

更新用戶端會取代應用程式;更新訂閱則只會重新讀取訂閱群組網址提供的設定。若發現某個群組的內容不正確,先試試「更新訂閱」,不必急著下載新版用戶端。如果是選單位置與教學截圖不同,請先記下用戶端名稱、已安裝版本及介面類型,再找適用該版本的操作說明。尤其在 Windows 上,桌面版與經典 WPF 版的選單配置不同,不代表其中一個安裝失敗。

更換版本前,先保留可還原的設定

若目前版本提供匯出或備份功能,請先使用用戶端內建功能儲存檔案,並確認備份檔案所在位置。訂閱群組、手動設定的路由、個別新增的設定及本機連接埠,不一定都包含在同一份訂閱中;只保存網址並不等於完整備份。備份可能包含私人訂閱網址或連線憑證,請存放在自己能控管的位置,不要連同錯誤截圖一起傳送。

更換安裝方式、發行管道或裝置時,別預設可以直接覆蓋安裝,也別假設能直接沿用舊程式的整個資料目錄。請先在目標裝置安裝相容的版本,再透過匯入功能還原可辨識的設定。若舊裝置上有自行修改的路由或連接埠,可在新裝置逐項核對,確認正常後再清除舊設定。

第一次啟動後,依序確認三件事

  1. 先確認視窗能否開啟。若程式無法啟動,請保留系統提示,重新檢查套件格式、處理器架構及執行環境。此時不必先修改訂閱網址或路由規則,因為程式尚未進入讀取這些設定的階段。
  2. 再確認設定已出現在清單中。新增訂閱網址與更新訂閱是兩個步驟。新增後返回主畫面執行更新,再切換至對應群組查看。若手上的是單一分享連結,請使用剪貼簿匯入等功能,不要把它當成訂閱網址。
  3. 最後確認應用程式使用了選定的連線方式。桌面系統先確認是否已啟用系統代理,以及目標應用程式是否遵循此設定;手機則檢查用戶端是否取得系統連線授權。初次測試時一次只調整一項設定,避免同時更改連接埠、路由與連線模式,反而難以找出問題所在。

發生錯誤時,記下問題出現的步驟、用戶端名稱、系統版本、所選套件的架構及完整錯誤訊息。若只有瀏覽器下載失敗,先檢查下載;系統安裝程式拒絕套件時,先檢查相容性;程式已開啟但更新失敗時,再檢查訂閱與網路。將不同階段分開排查,比反覆下載同一個安裝檔更容易找出問題。

下載與安裝常見問題

從選錯安裝檔、瀏覽器下載中斷,到安裝後清單仍是空的,依照實際提示逐步排查。

Windows 桌面版和經典 WPF 版需要一起安裝嗎?

選一種即可。第一次使用可選桌面版;習慣經典介面,或正依照 WPF 版截圖尋找選單時,可選經典 WPF 版。切換前請先結束舊用戶端並備份設定。兩個版本可以下載留存,但不建議同時執行:若兩者嘗試監聽相同的本機連接埠,後啟動的版本可能無法正常運作,也可能讓你搞不清楚目前由哪個版本控制系統代理。

頁面版本與下載檔名中的數字不一致,應該以哪個為準?

卡片上的版本來自應用程式清單,檔名則對應你實際選擇的下載項目,兩處數字可能不同。已安裝的版本請以用戶端的「關於」或系統應用程式詳細資訊為準。若需要確認特定版本,請先核對實際取得的檔案,以及安裝程式或系統顯示的資訊;仍無法確認時,不要把頁面版本號當成檔案版本,也別急著覆蓋原有安裝。

Android 顯示「未安裝應用程式」,改用通用版有用嗎?

若提示架構不相容,可確認系統支援的架構後再試通用版;若提示與現有套件衝突,改用通用版通常無法解決。先查看儲存空間、系統版本與詳細錯誤,再確認裝置上是否已有同名用戶端,以及新舊套件是否來自相同發行管道。解除安裝可能會一併刪除訂閱與設定,請先備份,再決定是否重新安裝。

下載中斷或檔案無法開啟,該先檢查什麼?

先確認瀏覽器的下載清單是否顯示完成,再核對副檔名與所選系統。Windows 的 ZIP 請先完整解壓縮;macOS 的 DMG 用 Finder 開啟;Android 的 APK 交由系統安裝程式處理;Linux 的 deb 或 rpm 則使用相應的套件管理工具。檔案尚未下載完成時,可在瀏覽器中重試;若反覆取得錯誤頁面,請記下選擇的下載項目與瀏覽器提示,不要只改副檔名就把錯誤頁面當成安裝檔。

安裝完成後,為什麼還是看不到訂閱內容?

安裝檔只會安裝用戶端,不會自動加入訂閱。v2rayN 請在「訂閱群組」新增網址後再執行更新;v2rayNG 請開啟「訂閱群組設定」,儲存網址後返回主畫面更新訂閱。更新後清單仍是空的話,先確認所選群組、連結是否完整及訂閱是否有效,再檢查連線設定。請勿將完整的私人訂閱網址貼到公開討論區。