Windows / macOS / Android / Linux 四大平台皆可使用

V2Ray設定教學
v2rayN 下載與設定方法

從客戶端選擇到連線驗證,集中說明 訂閱匯入路由分流故障排查,同時解釋 v2rayN、v2rayNG、Xray 和 V2Fly 之間的實際關係。

常見線路地區 美國 日本 香港 新加坡 韓國

核心設定

從系統代理到路由規則,逐項對應客戶端介面

設定問題通常不是由單一開關造成。先確認客戶端、核心與訂閱都能正常使用,再檢查系統代理、路由與 DNS,排查路徑會比反覆切換節點更清楚。

連線入口

系統代理模式
決定哪些應用程式接入

v2rayN 中的節點顯示可用,不代表瀏覽器流量已交由客戶端處理。系統代理模式會將遵循作業系統代理設定的應用程式導向本機入站埠。日常使用可先選擇自動設定系統代理,再完全關閉並重新開啟瀏覽器,避免舊連線繼續沿用原有路徑。若只有個別程式無法連線,應繼續檢查該程式是否使用獨立代理、是否繞過系統設定,而不是直接修改節點參數。

這一層處理的是「應用程式是否進入客戶端」,與協定、線路及遠端服務是否可連線屬於不同環節。將入口問題與節點問題分開驗證,可以減少重複匯入訂閱或頻繁修改傳輸參數。

系統代理
自動設定系統代理
保留原有系統代理
略過區域網路位址
變更後重新建立應用程式連線

客戶端下載

依作業系統選擇客戶端

桌面端以 v2rayN 為主要入口,Android 可在 v2rayNG 與 v2flyNG 之間選擇。下載頁會進一步列出適合不同處理器架構與發行版的檔案。

Windows

使用 v2rayN 桌面版或經典 WPF 版。適合需要系統匣控制、系統代理切換、訂閱分組與完整路由設定的桌面環境。

前往下載

macOS

使用 v2rayN 跨平台桌面介面。下載時需依裝置處理器選擇對應版本,安裝後再完成系統代理授權與訂閱匯入。

前往下載

Android

優先選用採用 Xray 核心的 v2rayNG,也可依訂閱與核心偏好選擇 v2flyNG。主流裝置通常使用 arm64 架構。

前往下載

Linux

v2rayN 提供 Debian、Ubuntu 與 Fedora 系發行版的桌面安裝入口,並區分 x64 與 arm64 處理器架構。

前往下載

快速入門

透過匯入、選擇、驗證三步完成基本設定

首次設定不要同時調整所有進階選項。先建立一條最小可用的連線,再依應用程式需求增加路由與 DNS 規則。

  1. STEP 01

    匯入訂閱或分享連結

    桌面端可以從剪貼簿匯入訂閱網址或單一節點分享連結,Android 客戶端也提供對應入口。匯入訂閱後需要執行一次更新,確認伺服器清單已經出現。若清單為空,優先檢查複製內容是否含有多餘空格、網址是否完整,以及裝置時間是否正確。在尚未取得節點清單前,不要修改路由規則,因為此時問題仍處於取得訂閱的環節。

  2. STEP 02

    選擇節點並啟用代理

    從訂閱分組中選定作用中的節點,再啟動客戶端核心。Windows、macOS 與 Linux 桌面端還需設定系統代理模式,Android 則需確認系統連線授權。選取節點只代表設定進入待使用狀態,核心成功啟動並接管應用程式流量後,才算完成連線。此時先維持預設路由,避免進階規則影響第一次驗證。

  3. STEP 03

    檢查日誌與實際存取

    完成連線後,先開啟新的瀏覽器視窗進行存取測試,再查看客戶端日誌是否出現網域解析、TLS 握手或連線逾時資訊。延遲測試只能說明探測請求的回應情況,不能取代完整網頁存取。若瀏覽器仍沿用舊連線,可完全退出後重新開啟;若所有節點都失敗,則依照系統代理、DNS、本地網路、訂閱有效性與遠端狀態的順序逐層檢查。

開源生態系

Project V、V2Fly、Xray 與圖形化客戶端的關係

名稱相近不代表職責相同。理解生態系、核心與客戶端三層結構,有助於判斷教學中的設定究竟屬於介面操作、設定格式,還是協定實作。

Project V 是技術生態系的起點

Project V 建立了一套圍繞代理協定、傳輸方式、路由與設定結構的開源技術生態系。常見的 VMess、VLESS、WebSocket、gRPC、TLS、REALITY 與 routing 等詞彙處於不同層級:有些負責身分驗證與資料傳遞,有些負責承載連線,有些則負責決定流量最終的去向。客戶端介面會將這些欄位整理成表單,但底層仍會轉換為核心可讀取的設定。

因此,所謂「V2Ray 設定」並不是單一開關,而是由入站、出站、傳輸、安全性、DNS 與路由共同組成的結果。基礎使用者通常透過訂閱取得完整參數,只需處理客戶端匯入與系統代理;需要手動維護規則時,再逐步理解各區塊的職責,比直接複製一份龐大的設定更容易找出錯誤。

V2Fly 與 Xray 是不同的核心家族

V2Fly 延續 Project V 相關技術的社群維護路線,保留熟悉的設定結構與協定能力。Xray 在相近的設定體系上發展,並涵蓋 VLESS、REALITY 等常見部署組合。兩者都屬於執行核心:負責讀取設定、監聽本機入站、完成網域解析與路由比對,並建立實際的出站連線。核心本身不等同於桌面視窗或行動端介面。

選擇哪一種核心,應以節點要求、客戶端支援與設定欄位為依據。遇到匯入成功卻無法啟動時,首先查看日誌中是否有不支援的欄位或格式錯誤;核心已啟動但存取失敗時,再檢查網路、DNS、憑證名稱與遠端回應。將「設定能否解析」與「連線能否建立」分開,是處理複雜故障的關鍵。

圖形化客戶端負責系統整合與日常管理

v2rayN 面向 Windows、macOS 與 Linux 桌面環境,主要負責訂閱更新、節點選擇、系統代理、路由規則編輯、核心切換與日誌查看。v2rayNG 面向 Android,通常搭配 Xray 核心使用;v2flyNG 同樣面向 Android,著重 V2Fly 核心路線。三款客戶端都透過公開的開源協作方式持續維護,但發佈節奏、介面結構與支援欄位並不完全一致。

客戶端升級通常會涉及介面調整、執行核心更新或設定相容性變化。更新前應先記下目前可用的訂閱分組、系統代理模式與自訂路由,更新後則先驗證最小連線,再恢復進階設定。遇到舊設定無法直接使用時,應根據日誌與目前的欄位說明調整,而不是直接覆蓋不同客戶端的設定目錄。

開源授權帶來可檢視的維護方式

開源授權明確界定程式碼的使用、修改與散佈範圍,也讓協定實作、設定處理與問題修正能接受社群檢視。對一般使用者而言,更實際的價值是文件、問題紀錄與版本變更可以形成可追蹤的技術資料。它不能取代正確設定,也無法保證每個第三方訂閱來源都可靠;客戶端、核心與節點服務仍應分別判斷。

本站教學以公開的設定語意與客戶端實際介面為基礎,重點說明各選項的作用、依賴關係與排查順序。涉及訂閱內容時,只說明匯入與管理方式;涉及協定時,只說明欄位與連線機制。透過這種分層方式,可以避免將客戶端問題、核心問題與遠端服務問題混在同一個結論中。

常見問題整理

先確認問題發生在哪一層

訂閱、節點、系統代理、DNS 與路由會依序影響連線。根據症狀定位環節,比反覆刪除和重新安裝客戶端更有效。

訂閱更新成功,為什麼清單仍然是空的?

先確認訂閱回傳的是客戶端支援的節點格式,並檢查分組篩選條件、裝置時間與更新日誌。如果複製的是單一分享連結,應使用從剪貼簿匯入節點的入口,而不是訂閱更新入口。

查看訂閱與節點術語 →

延遲測試正常,為什麼瀏覽器仍無法開啟網頁?

探測回應與完整存取不是同一個過程。繼續檢查系統代理是否啟用、瀏覽器是否重複使用舊連線、DNS 是否回傳可用結果,以及路由規則是否將目標網域送往預期的出站。

查看無法上網的排查方法 →

VLESS、VMess 與 REALITY 分別是什麼?

VLESS 與 VMess 是客戶端和伺服器之間使用的協定類型,REALITY 則是與連線安全及握手相關的方案。三者不能直接互相替換,匯入時應完整保留節點提供的協定、傳輸與安全性欄位。

查看協定術語 →

修改路由後只有部分網站異常,該怎麼辦?

先暫時切回較簡單的預設規則,確認基本連線恢復後,再逐條加入網域與 IP 條件。重點檢查規則順序、比對範圍,以及同一服務使用的主網域、API 網域與靜態資源網域是否被導向不同的出站。

查看 DNS 與分流排查 →

技術筆記

設定結構、憑證錯誤與分享連結

最新文章圍繞客戶端介面背後的設定邏輯展開,適合完成基本連線後繼續閱讀。

進階原理

V2Ray 設定檔結構逐段解析:inbounds、outbounds 與 routing 各自負責什麼

拆解一份最小可用的 V2Ray JSON 設定,說明入站、出站與路由區塊的職責,以及它們與 v2rayN 圖形化設定的對應關係。

閱讀全文 →
故障排查

TLS 握手失敗與憑證錯誤排查:系統時間、SNI 與 allowInsecure 三個關鍵點

依照系統時間、SNI、憑證鏈與客戶端日誌整理排查順序,並說明放寬憑證檢查可能帶來的實際風險。

閱讀全文 →
入門指南

vmess:// 和 vless:// 分享連結怎麼使用?與訂閱網址的差異一次說清楚

說明單一節點分享連結與可更新訂閱清單的結構差異,並列出 v2rayN 與 v2rayNG 中對應的匯入入口。

閱讀全文 →