Windows
安裝 v2rayN 時,可選擇桌面版或經典 WPF 版。桌面版採用跨平台介面;依照舊教學尋找選單時,先確認截圖使用的是哪種介面,再找訂閱分組和系統代理的設定入口。
從可攜式目錄搬移前,請先結束正在執行的程式、備份設定,並記下原本的本機監聽連接埠。若新舊版本同時執行,第二個程式可能無法綁定相同連接埠;切換版本前請先排除這類衝突。
前往下載桌上型電腦建議使用 v2rayN,手機和平板則可選擇 v2rayNG 或 v2flyNG。先確認作業系統,再核對處理器架構;同一款用戶端在不同系統上的安裝方式可能不同。換裝置時,保留原訂閱網址即可重新匯入,不必照搬舊裝置的連接埠、代理模式和規則。
安裝 v2rayN 時,可選擇桌面版或經典 WPF 版。桌面版採用跨平台介面;依照舊教學尋找選單時,先確認截圖使用的是哪種介面,再找訂閱分組和系統代理的設定入口。
從可攜式目錄搬移前,請先結束正在執行的程式、備份設定,並記下原本的本機監聽連接埠。若新舊版本同時執行,第二個程式可能無法綁定相同連接埠;切換版本前請先排除這類衝突。
前往下載開啟「關於這台 Mac」確認晶片,再選擇適用的 v2rayN 安裝套件:顯示 Apple 晶片就選 Apple Silicon,顯示 Intel 處理器就選 Intel。安裝後請從「應用程式」資料夾啟動,避免一直在磁碟映像檔中執行。
若瀏覽器沒有使用用戶端連線,請檢查目前網路服務的代理設定,以及瀏覽器是否另有代理設定。結束用戶端後若網路存取異常,先還原原本的網路設定,再重新開啟同一個網頁測試。
前往下載建議先查看採用 Xray 核心的 v2rayNG;若設定明確要求使用 v2fly 核心,再選擇 v2flyNG。近年多數手機適用 arm64 套件;不確定裝置架構時,可查看通用套件和系統需求。
首次連線時,請留意系統跳出的 VPN 授權提示。同一個使用者環境中,既有的 VPN App 可能會與新連線互相切換。若只是鎖定螢幕後斷線,先檢查背景執行和電池最佳化設定,再判斷是否需要更換設定。
前往下載依 Linux 發行版選擇 v2rayN 套件格式。Debian、Ubuntu 通常選 deb,Fedora 等系統通常選 rpm。套件格式和處理器架構需分別確認:相同格式也可能提供 x64 與 arm64 兩種版本。
安裝完成不代表所有應用程式都會使用桌面代理。圖形介面程式和從終端機啟動的工具可能各有設定;若只有單一程式無法連線,先檢查該程式的代理設定,不必一開始就重裝用戶端。
前往下載訂閱負責更新設定清單,路由決定請求的連線路徑,系統代理和 TUN 則決定哪些請求會進入用戶端。分開檢查這幾項,比一次修改多個設定更容易找出問題。
為每個訂閱來源建立獨立分組,並使用容易辨識來源的別名。貼上網址後,先手動更新目前分組,確認清單確實匯入,再決定是否啟用定期更新。比起逐一匯入連結,分組更新更容易確認是哪個來源有變動;但更新成功只代表用戶端讀取到設定,不代表清單中的每個項目都能連線。若清單是空的,先確認目前選取的分組,再檢查訂閱網址是否過期,以及回傳內容能否由用戶端辨識。分享截圖時,請遮住完整網址。
路由決定已進入用戶端的請求要從哪個出口送出,並不負責將應用程式流量導入用戶端。先使用預設設定建立可用的基準,再針對特定網域或位址調整。相較於直接切換成全域模式,自訂規則可讓區域網路服務維持直連,其餘請求則交由預設規則處理。規則有比對順序,範圍較廣的條件可能先於特定條件生效。遇到網站走錯出口時,請用同一個應用程式重現問題,再查看記錄確認命中的規則;每次只修改一條並重新測試,不要同時更換 DNS 解析方式。
瀏覽器等會讀取系統代理的應用程式,適合先透過系統代理測試。只有需要處理不會讀取代理設定的流量時,才考慮使用 TUN;它透過虛擬網路介面接入流量,可能需要額外權限,也可能與現有的虛擬網路設定衝突。測試時不要同時啟用兩種模式。先記下原本設定,再選一種模式驗證,檢查目標應用程式和區域網路服務能否正常存取。若切換後整台裝置的網路都異常,先還原原本模式,再查看核心和網路介面相關記錄。
核心會讀取協定、傳輸和安全層參數,並實際建立連線;介面能匯入設定,不代表所選核心一定能執行。先查看設定提供者註明的需求,例如包含 REALITY 的設定通常應選 Xray。與只能使用固定核心的用戶端不同,桌面版可依設定選擇支援的核心。切換前先記下原本選項,保持節點和路由不變,重新啟動後先查看啟動記錄,再測試連線。若記錄最先顯示欄位不受支援,請先確認核心相容性,不必急著修改連接埠或啟用 TUN。
設定說明常把用戶端、核心和協定簡稱為 V2Ray。排查時請分清這三個層次:介面負責管理設定,核心負責解析設定並建立連線,協定則定義通訊雙方如何交換資料。先找出問題所在的層次,再決定要修改什麼。
Project V 是認識這個生態系的起點,V2Ray 是其中負責處理代理連線和路由的核心程式。V2Fly 社群持續維護相關核心與文件,桌面和行動圖形介面用戶端則由各自專案維護。閱讀核心相關說明時,不必在圖形介面中逐字尋找同名欄位:同一項設定可能在用戶端的訂閱、路由或傳輸設定中,也可能沒有獨立的操作項目。
判斷文件是否適用,先確認內容描述的是圖形介面還是核心設定,再確認作業系統和核心系列是否相符。例如,核心文件提到的入站連接埠,是用戶端在本機接收請求的入口,不是訂閱設定中遠端伺服器的連接埠。兩者填錯都可能導致網頁無法開啟,但記錄的位置不同。前者應先檢查本機監聽,後者則應回頭核對連線參數。
Xray 源自 V2Ray 生態系,之後依自己的方向持續維護。兩種核心支援部分相同的協定與設定概念,也各自實作不同的傳輸和安全功能。只看設定名稱無法判斷相容性:即使使用相同協定,兩份設定仍可能採用不同傳輸方式,或需要不同的安全層欄位。請優先保留訂閱提供的原始參數,依提供者註明的組合選擇核心,不要混用其他連線的參數。
更換核心後若應用程式仍未開始連線,請先檢查啟動記錄中最早出現的異常。欄位無法辨識通常是相容性問題;本機位址無法綁定,則應先檢查連接埠是否被占用。確認核心正常啟動且請求確實經過核心後,再繼續排查遠端連線和交握問題。這樣可避免把不同階段的故障都歸咎於訂閱失效。
開源用戶端和核心讓設定欄位及協定實作都能公開檢視。VMess、VLESS、Trojan 和 Shadowsocks 是協定名稱,不是可以在任意設定中互換的選項。能否連線,取決於通訊兩端使用的協定、傳輸方式和必要安全參數是否一致。尤其不要把 VLESS 當成加密方式;實際使用的安全層仍須依具體設定判斷。
首次連線時,先使用設定提供者給的原始組合作為基準。若出現交握錯誤,請先確認位址、連接埠、傳輸方式和安全參數,再檢查裝置時間。切換協定需要對端也提供相應設定;只在用戶端單方面改選項,無法將原連線轉換成另一種協定。想了解哪些組合適合現有裝置,先比較核心支援範圍,再考量網路與裝置條件。
v2rayN 將桌面端的訂閱、路由和代理設定集中在圖形介面。v2rayNG 是以 Xray 為主的行動用戶端,透過系統 VPN 介面接入流量;v2flyNG 則為明確使用 v2fly 核心的設定提供另一個開源圖形介面入口。選擇用戶端時,先確認裝置支援哪一款,再查看現有設定對核心的要求,不必因圖示或名稱相似而安裝多款。
在不同裝置上使用同一份訂閱時,建議重新匯入,再依平台檢查流量接入方式。桌面端的系統代理設定不會隨訂閱轉移到手機,手機上的 VPN 授權和個別 App 設定也不會帶到桌面端。若只有其中一台裝置能連線,先在兩邊選取相同設定,並比對目前的核心和網路環境;別只因分組名稱相同,就認定兩邊使用的是同一條連線。
介面版本更新、核心更新和訂閱重新整理是三件不同的事。介面更新可能改變選單位置或安裝需求;核心更新可能影響可辨識的欄位;重新整理訂閱則會從原網址重新讀取設定清單。更換安裝套件前,請先備份分組、路由和其他設定。更新後一次只驗證一項變更:先確認程式能啟動,再用一份已知可用的設定測試,最後還原自訂分流。
如果問題是在更新後才出現,請記下變更時間、使用平台和發生異常的操作,再收集相關記錄。截取記錄時保留第一筆錯誤及附近幾行,移除訂閱網址、身分參數和不打算公開的目標位址。若只有一個訂閱分組受影響,先檢查該分組的更新結果,不必因此刪除其他可正常使用的分組。前往說明中心 →
挑選用戶端、排除故障和安裝程式,各自有不同的檢查順序。若連線已建立但個別應用程式異常,先查看記錄;若尚未安裝用戶端,請從首次安裝檢查清單開始。確認設定和用戶端都支援同一組協定參數後,再比較協定選擇。
從加密方式、交握負擔、傳輸層搭配和用戶端相容性四個面向比較四種代理協定,並針對日常瀏覽、行動網路和低規格裝置等情境提供選型建議。
教你開啟用戶端記錄、調整記錄層級,並逐項解讀交握失敗、連線逾時、連接埠占用、時間不同步等常見錯誤,附上由近到遠的排查順序。
依序整理解壓縮目錄、執行環境、核心類型、本機連接埠、系統代理和首次匯入訂閱等 v2rayN 入門必查設定,並列出新手常遇到的幾個問題。