Windows
v2rayN 桌面版與經典 WPF 版
桌面版採用跨平台介面,WPF 版則保留經典桌面操作方式。兩種版本適合不同的介面使用習慣,選擇前請先查看下載中心列出的系統需求。初次使用時,請將程式放在可寫入的資料夾,避免因目錄權限問題而無法儲存設定。
桌面版選 v2rayN,Android 優先選 v2rayNG;從開源客戶端開始,完成訂閱匯入與路由分流設定。
先匯入設定,再檢查流量入口與路由出口。以下為設定結構示意,實際選單名稱依使用的客戶端而異,不代表目前連線狀態。
{"outbounds":[{"tag":"proxy",
"protocol":"vless"}]}訂閱可用來批次取得設定,分享連結通常只包含單一節點。先確認內容來自可信來源,再到訂閱群組儲存網址並更新;如果複製的是分享連結,請使用從剪貼簿匯入的功能。更新完成後,檢查協定、傳輸方式與安全參數是否完整,再選取要使用的設定。圖形客戶端會將這些欄位整理成清單,方便日常管理;若直接執行核心,則需要自行維護設定檔。訂閱網址通常含有存取憑證,分享截圖或求助紀錄時,請先遮蔽敏感資訊。
{"routing":{
"domainStrategy":"IPIfNonMatch"
}}路由模式負責決定已進入核心的請求如何傳送,無法讓所有應用程式自動走代理。初次使用可先採用客戶端預設規則,確認常用網站正常後再新增自訂規則。規則通常依序比對,較明確的網域條件應排在較寬泛的條件之前。範例中的網域策略會在網域規則未命中時嘗試解析,接著比對 IP 規則。相較於單純切換系統代理,分流能針對不同目的地採取不同處理方式,但也需要搭配 DNS 設定與規則資料更新,避免解析結果影響預期的連線出口。
{"listen":"127.0.0.1",
"port":10808,"protocol":"socks"}系統代理主要影響遵循系統代理設定的應用程式,不等於接管所有網路流量。啟用前先確認核心已啟動,且本機監聽連接埠沒有衝突,再讓客戶端設定系統代理。若瀏覽器可用、其他軟體卻無法連線,請檢查該應用程式是否使用獨立的代理設定。畫面中的連接埠僅為設定範例,實際值應與本機設定一致。相較於透過虛擬網卡接管流量,系統代理的影響範圍較容易確認;排查時可先從這個方式建立可重現的連線,再評估是否需要採用其他流量接管方式。
{"protocol":"vless",
"tag":"proxy"}圖形介面負責整理設定,核心則負責建立連線及執行路由。選擇核心時,應核對完整的協定、傳輸方式與安全參數,不要只看節點名稱。v2rayNG 以 Xray 核心作為 Android 端的主要選擇,v2flyNG 則提供 V2Fly 核心的替代方案。桌面版可依 v2rayN 實際提供的選項與設定需求調整。不同核心的欄位不一定能互換;切換前請先備份原有設定,切換後查看啟動紀錄並重新測試。更換核心並非所有連線問題的通用解法。
{"listen":"127.0.0.1",
"port":10808}此處所說的同步,是指在不同裝置上重複使用設定來源,並不表示客戶端會自動同步所有設定。可在各裝置手動匯入同一個可信訂閱,再分別檢查使用中的設定、分流規則與 DNS。完整設定檔也可能包含本機路徑、監聽連接埠或平台專屬選項,不宜直接照搬。相較於只遷移單一分享連結,訂閱更方便持續取得更新,但各裝置上的系統代理、應用程式分流與權限仍須個別設定。遷移完成後請逐台測試,備份檔案與訂閱網址也應妥善保管,視為敏感資訊。
先選作業系統,再選處理器架構與安裝套件格式。下載中心集中提供各版本下載入口,首頁不直接提供安裝檔。
v2rayN 桌面版與經典 WPF 版
桌面版採用跨平台介面,WPF 版則保留經典桌面操作方式。兩種版本適合不同的介面使用習慣,選擇前請先查看下載中心列出的系統需求。初次使用時,請將程式放在可寫入的資料夾,避免因目錄權限問題而無法儲存設定。
v2rayN · Apple Silicon / Intel
先到系統的「關於本機」查看晶片資訊,再選擇相符的架構。安裝完成後,確認應用程式能正常啟動、核心能順利執行,最後再設定系統代理。若系統要求確認來源,請先核實下載來源與提示內容,不要直接關閉所有安全防護。
優先選 v2rayNG,v2flyNG 作為備用
多數較新的裝置可先查看 arm64 版本;若不確定裝置架構,請閱讀通用版說明。首次連線時須授權系統 VPN;若已連接其他 VPN,請先排除衝突。若應用程式在背景中斷,請接著檢查電池最佳化、背景執行權限及網路切換狀況。
v2rayN · deb / rpm
依發行版的套件管理系統選擇 deb 或 rpm,再確認裝置使用 x64 還是 arm64。安裝圖形客戶端與接管桌面流量是兩個不同步驟:即使核心正常啟動,應用程式仍可能需要系統代理或個別代理設定,不能只看視窗已開啟就認定連線完成。
客戶端提供設定管理介面,本身不含可直接使用的遠端連線服務。下載安裝後,仍須取得可信服務提供者或自架服務所提供的有效設定。只有在訂閱更新成功、選定使用中的設定、本機流量入口生效後,應用程式的請求才有機會依預期路徑傳送。分開確認這三個步驟,可避免訂閱失效時反覆重新安裝,也能避免將系統代理未生效誤判為伺服器故障。
初次安裝建議保留預設監聽位址,只調整必要項目。若已安裝其他代理軟體,請先記下目前的連接埠與系統代理狀態,避免多個程式同時修改相同設定。基本連線正常後,再逐項新增自訂路由、DNS 或應用程式分流;每次只調整一類設定,遇到問題時才容易確認如何還原。
查看所有客戶端 →分清專案、核心與客戶端,才能看懂下載項目名稱與設定選項。本站名稱用於下載與文件導覽,不代表這些獨立開源專案由本站開發。
Project V 是了解 V2Ray 相關工具的背景起點。早期以核心與設定檔為主的使用方式,逐漸發展出桌面與行動裝置的圖形客戶端。核心主要處理網路連線,客戶端則將訂閱、節點、路由與本機代理設定整理成方便操作的介面。搜尋「V2Ray 官網」時,常會同時看到專案名稱、核心名稱與客戶端名稱;它們所屬層級不同,並不是同一套安裝程式的不同寫法。
V2Fly 延續 V2Ray 核心的社群開發路線,Xray 則是以相關程式碼為基礎發展出的另一條核心路線。兩者有共同的技術背景,但功能演進與支援的具體參數並不完全相同。VMess、VLESS 等是協定名稱,WebSocket 等是傳輸方式選項,TLS 與 REALITY 則涉及連線安全設定。只知道協定名稱不足以判斷相容性,應依伺服器需求逐項核對;並非任何客戶端都能使用任何分享連結。
v2rayN 適用於桌面平台,方便集中管理訂閱、切換使用中的設定及調整路由。v2rayNG 適用於 Android,常見流程是匯入設定後,透過系統 VPN 介面接管相應流量;v2flyNG 則提供以 V2Fly 核心為基礎的 Android 備用選擇。三者都是開源圖形客戶端,但選單、設定匯出格式與平台權限各不相同。選擇時應優先考量裝置與設定需求,不要只因名稱相近就互相替換。
相關客戶端與核心皆依各自的開源授權發布,授權條款規範程式碼使用、修改與再散布的條件;客戶端與核心也可能採用不同授權,適用範圍應以各專案的授權文件為準。程式碼開放有助社群審查與貢獻,但不能取代對訂閱服務、遠端伺服器與本機權限的判斷。下載安裝程式、取得連線設定及授權流量接管,是不同的信任環節,每個環節都應個別確認。
客戶端更新可能涉及介面、匯入相容性或系統整合;核心更新可能影響協定處理;路由規則資料更新則會改變網域與 IP 的分類。更新訂閱通常只是重新取得遠端設定,不代表上述元件都已更新。升級前先備份現有設定並閱讀更新說明,升級後重新測試常用網站與應用程式。若出現回歸問題,記錄問題發生在哪個更新環節,會比直接清除所有設定更容易找出原因。
備份內容也應分開處理:分享連結可保存連線參數,客戶端設定備份則可能包含訂閱憑證、群組資訊與本機路徑。跨裝置遷移時,不要將備份上傳至公開位置;向他人求助時,先遮蔽網址中的憑證、使用者識別資訊與認證欄位。使用文件中的設定片段時,也應先了解各欄位用途,不要將局部範例當成可直接執行的完整設定。
依序檢查設定來源、流量入口與規則出口。每個步驟都保留檢查結果,才能作為下一步的判斷依據。
安裝只完成工具準備。還需要匯入有效訂閱或分享連結、選取使用中的設定,並確認核心已成功啟動。桌面版接著檢查系統代理或應用程式代理,Android 則確認 VPN 授權。先確認瀏覽器能正常連線,再逐步測試其他應用程式,避免同時排查多個變數。詳細步驟請參閱入門指南。
匯入成功只表示客戶端已辨識收到的設定,不代表遠端服務目前可連線。請繼續檢查訂閱效期、使用中的設定、系統時間與連線紀錄。如果收到的是登入頁面或錯誤訊息,即使網址能在瀏覽器中開啟,也不是有效的訂閱內容。請勿公開貼出完整訂閱網址,可依教學中的匯入流程重新確認匯入入口。
有些應用程式可能不理會系統代理,也可能使用自己的代理設定。瀏覽器擴充功能、應用程式內建代理與系統代理同時存在時,也可能指向不同連接埠。先確認本機監聽與瀏覽器連線,再檢查目標應用程式的網路設定。直連或代理模式只會決定進入核心後的路由方式,無法讓尚未進入核心的請求自動套用規則。可參考故障排除,依症狀逐步檢查。
先記錄失敗的網域、系統解析結果與客戶端紀錄,再分辨是解析失敗還是連線失敗。瀏覽器安全 DNS、系統 DNS 與核心 DNS 可能走不同路徑,只修改其中一處未必會影響所有請求。保留目前設定,每次只調整一個環節,並同時測試預期直連與代理的目的地,避免修好一個網站卻影響其他規則。後續可參考DNS 與路由故障排除說明。
從首次啟動、連結格式到路由部署,依問題查閱相關主題。先完成圖形客戶端的基本連線,再考慮更複雜的網路流量接管方式。
介紹在路由器或旁路由上直接執行核心的兩種網路架構,說明透明代理、DNS 接管與裝置閘道設定重點,以及適用情境。
入門指南比較單一節點分享連結與訂閱網址的格式、更新方式及匯入入口,示範如何在 v2rayN 與 v2rayNG 中透過剪貼簿或 QR Code 匯入節點。
入門指南整理 v2rayN 初次啟動時須確認的設定,涵蓋解壓縮執行、核心選擇、本機連接埠與系統代理模式,並彙整防毒軟體誤判、連接埠占用等常見問題。