客戶端下載與設定文件

V2Ray官方網站 · v2rayN
客戶端下載與全平台設定

從選擇客戶端到匯入訂閱,依步驟完成路由與代理設定。

  • VMess
  • VLESS
  • Trojan
  • REALITY

訂閱匯入與群組管理

訂閱可將一組連線設定集中在同一個更新入口。v2rayN 可在訂閱群組中填入網址,再更新對應群組;v2rayNG 也能透過訂閱群組設定完成相同操作。相較於逐筆輸入,群組更方便區分來源、個別更新及找出異常。首次匯入後,先確認清單中已出現設定,再選擇一筆作為目前使用的設定。更新訂閱只會重新整理設定內容,不代表已啟用系統代理。網址可能包含存取憑證,分享截圖前請遮蔽完整連結;轉換訂閱時,也應先確認接收方是否可信。

查看教學 →
訂閱群組訂閱群組設定
備註個人訂閱
網址請填入訂閱服務提供者給的完整網址
更新訂閱依群組更新

依平台選擇客戶端

先確認作業系統與處理器架構,再選擇相符的安裝檔。下載頁整理了各平台的下載入口與安裝需求。

查看所有客戶端 →

Windows

v2rayN 優先推薦

桌面版與經典 WPF 版

Windows 電腦可選擇 v2rayN。桌面版採用跨平台介面,WPF 版則保留經典桌面介面;兩者的選單位置與設定方式可能不同,跟著教學操作前請先確認使用的介面。日常使用通常從訂閱管理、目前使用的設定及系統代理三個入口開始,不必一次調整所有參數。

下載前,請在系統設定中查看裝置架構與系統資訊,再核對下載頁所列的執行需求。安裝後先保留預設的監聽設定,匯入現有設定並測試瀏覽器連線。若啟用 TUN 時出現權限提示,請依安裝說明處理;若系統代理可用但某個應用程式仍無法連線,先確認該程式是否會讀取系統代理,不要直接認定是訂閱失效。

macOS

v2rayN

Apple Silicon 與 Intel 雙架構下載

Mac 使用者可透過 v2rayN 管理訂閱與路由。下載前請開啟「關於這台 Mac」,確認顯示的是 Apple 晶片還是 Intel 處理器,再選擇相符的安裝檔。選擇架構應以硬體資訊為準,而非電腦外觀或購買年份;架構選對了,較能避免執行環境造成的相容性問題。

安裝完成後,從「應用程式」資料夾啟動客戶端,並依系統提示授予必要權限。遇到系統安全提示時,請先確認檔案來源與應用程式資訊,不建議直接關閉整體系統的安全防護。首次連線仍建議先使用系統代理,確認設定可用後再考慮啟用 TUN。若結束應用程式後瀏覽器無法連線,請檢查網路設定中的代理是否仍指向已停止的本機監聽連接埠。

Android

v2rayNG 優先推薦

v2rayNG · Xray / v2flyNG · V2Fly

Android 裝置首選 v2rayNG;若需要使用 V2Fly 核心設定,也可考慮 v2flyNG。較新的主流手機多使用 arm64;若不確定裝置支援哪種架構,可先閱讀下載頁說明,再判斷是否需要通用安裝檔。安裝檔架構會影響能否正常安裝與執行,核心家族則會影響協定與參數的相容範圍。

首次啟動連線時,系統可能會要求授予建立 VPN 連線的權限,請確認提出要求的應用程式後再同意。連線後,保留必要的背景執行權限,避免省電策略在鎖定螢幕時終止服務。若同時使用其他占用系統 VPN 通道的服務,須先排除衝突。設定成功匯入不代表流量已接管,還須檢查客戶端連線狀態、系統提示與實際應用程式的連線結果。

Linux

v2rayN

deb / rpm,依發行版與架構選擇

Linux 桌面可使用 v2rayN 圖形介面客戶端。選擇安裝檔時,須同時考量發行版的套件格式與裝置架構:deb 和 rpm 不能只看檔案大小選擇,x64 與 arm64 也不能混用。請先在系統資訊中查看發行版與處理器資訊,再從下載頁找到相符的下載項目。

安裝後,從桌面應用程式選單啟動,先確認視窗能正常開啟,再匯入訂閱。不同桌面環境支援系統代理設定的程度不一,部分應用程式還需要在自身設定中指定代理。TUN 涉及虛擬網卡、權限與路由,首次設定時請依平台章節逐步檢查。若本機同時執行其他網路服務,請先確認監聽連接埠未被占用,並保留原有網路設定,以便發生問題時還原。

首次連線的三個步驟

先確認基本連線正常,再微調 DNS、分流與應用程式接管範圍。

查看完整教學 →
  1. 匯入訂閱,確認設定來源

    準備完整的訂閱網址,在客戶端的訂閱群組設定中新增群組,填入方便辨識的備註並儲存,再執行更新。若收到的是單筆分享連結,請使用相應的匯入入口,不要當作訂閱網址填入。更新完成後,檢查清單中是否出現設定;若清單空白、格式錯誤或要求失敗,請先確認網址是否完整、是否已過期,以及目前網路能否連上訂閱服務。

    訂閱網址可能允許他人讀取連線設定,請當作敏感資訊妥善保存。排除問題時,只提供必要的錯誤訊息,不要公開完整網址、身分欄位或連線憑證。需要轉換格式時,請先確認客戶端是否已能直接識別,避免不必要地將訂閱交給其他服務。詳細步驟請參閱訂閱匯入教學。

  2. 選擇設定,設定流量接管方式

    從清單選擇一筆要使用的設定,再選擇合適的系統代理或連線模式。桌面端可先自動設定系統代理,讓遵循系統設定的瀏覽器發出連線要求;Android 端則依客戶端提示啟動連線並確認系統授權。此時先採用現成的路由方案,暫緩修改監聽位址、DNS 與複雜規則,以減少同時變動的條件。

    系統代理與路由負責不同環節:前者決定應用程式如何將要求交給客戶端,後者決定收到要求後使用哪個出口。即使選擇全域路由,不讀取系統代理的應用程式也不一定會被接管。若確實需要涵蓋更多應用程式,請參考系統代理與 TUN 說明逐項啟用,並檢查是否與其他網路工具衝突。

  3. 確認連線,再調整路由

    開啟目標網站,同時測試一個預期直連的網站與一項區域網路資源,確認代理連線、直連與本機網路都符合預期。客戶端成功啟動只代表服務正在執行;清單中的測試結果也不能取代實際應用程式的連線測試。必要時查看與這次要求相關的錯誤記錄,分辨是解析失敗、連線逾時、驗證異常,還是規則比對不符。

    基本連線正常後,再逐項修改路由或 DNS;每次只改一個條件,並重新測試。需要撤回調整時,還原上一組設定,不要一次重設所有選項。結束使用前正常停止連線,並確認系統網路設定已還原;若只有特定應用程式出問題,先檢查它自己的代理設定。路由分流可繼續閱讀路由規則入門;平台權限問題則請參閱全平台安裝設定指南。

Project V 生態系與核心差異

了解客戶端與核心的分工,有助於避免選擇與移轉時產生誤解。圖形介面負責儲存訂閱、選擇設定、整理選項及顯示記錄;核心則讀取產生的設定,處理協定、傳輸、路由與連線。介面中的開關是否生效,取決於客戶端如何產生參數,以及核心是否支援這些參數。因此,不能只憑應用程式名稱或相同的協定標籤,就認定所有功能都一致。

Project V、V2Fly 與 Xray 的關係

Project V 是以 V2Ray 為核心發展的開源代理工具生態系。V2Fly 延續並發展相關核心實作,Xray 則是在此技術背景下形成的另一個核心分支。兩者共享部分概念與設定慣例,但功能發展、參數支援與實際行為並不完全相同。討論「V2Ray 核心差異」時,應說明比較的是哪一種核心實作,而不是把所有相關圖形介面客戶端都視為同一個程式。

VMess、VLESS、Trojan 是連線協定相關名稱,REALITY 則是安全層相關技術;它們並非同一層級、可任意互換的選項。完整連線設定也可能包含傳輸方式、網域、連接埠及身分欄位等參數。客戶端能辨識分享連結,只代表格式解析成功;能否連線,還取決於核心支援、伺服器設定與目前網路環境是否相符。調整協定前,應先取得正確的參數。

三款開源客戶端的定位

v2rayN 適用於桌面裝置,方便集中管理訂閱、切換設定及調整路由。v2rayNG 適用於 Android 裝置,使用 Xray 核心;v2flyNG 同樣適用於 Android 裝置,以 V2Fly 核心作為連線基礎。三者都是開源客戶端,實際功能請以各自的安裝檔與介面說明為準。選擇時先看裝置平台,再確認設定需求,不必因名稱相近就在多款應用程式間反覆移轉。

桌面端與行動裝置的系統接管方式不同。同一份訂閱匯入兩種裝置後,系統權限、背景執行策略與 DNS 行為仍可能不同。例如,電腦上的應用程式可能會讀取系統代理,而 Android 裝置通常需要由客戶端發起系統 VPN 連線。移轉設定時可以沿用合法持有的訂閱,但不要假設另一台裝置會自動沿用路由模式、權限授權與背景設定。

開源授權與元件界線

程式碼開源表示可依所採用的授權條款閱讀、使用及再散布,不代表所有元件都採用相同授權。圖形介面客戶端、核心與隨安裝檔一同散布的元件,可能各自附有授權說明。若個人使用以外還計畫修改程式、重新打包或散布,應分別查看適用條款,並保留規定須保留的著作權與授權資訊。開源也不能取代對訂閱來源、設定內容及系統權限的判斷。

客戶端下載與遠端服務也是兩個不同範圍。客戶端提供本機管理與連線功能,遠端服務的可用性、權限與存取條件則由相應服務決定。安裝成功卻沒有設定,或已有訂閱無法更新,都不能單憑客戶端是否免費來推斷原因。本網站內容以工具安裝與設定為主,實際使用時仍應遵守所在地適用的法律規範、網路管理要求與服務條款。

客戶端、核心與規則分別更新

社群維護可能帶來介面調整、相容性修正與功能變更。升級客戶端、更新核心、重新整理訂閱與更新規則資料是不同操作:重新整理訂閱會變更連線設定,更新規則資料會影響分類比對,更新核心可能改變參數支援,而升級客戶端則可能調整介面或設定產生方式。遇到問題時,先記錄剛才發生的是哪一種變更,再決定是否要還原舊設定或重新匯入。

更新前請保留必要設定,並妥善保護備份中的敏感資訊;更新後依序確認能否啟動、讀取訂閱、實際連線及正確套用路由,不要只確認視窗能否開啟。若教學中的選單與目前介面略有不同,可依「訂閱管理」、「系統代理」、「路由設定」等功能名稱尋找對應入口。需要完整的平台操作步驟,請參閱完整安裝指南;需要了解三款應用程式的適用情境,請查看客戶端比較。

設定主題與故障排除

基本連線完成後,依遇到的問題閱讀相關主題。每次只調整一個環節,並保留可重現的測試結果。

查看所有文章 →