桌面與 Android · 用戶端設定指南

V2Ray之家v2rayN 下載與設定

依裝置選擇開源用戶端,從匯入訂閱開始,逐步設定路由分流與 TUN 模式。

  • VMess / VLESS
  • Xray / V2Fly

設定入口 / 用戶端設定

訂閱、代理與分流設定

先匯入設定,再決定哪些流量要進入用戶端,最後調整流量的出口路徑。這三件事分別對應訂閱管理、代理模式與路由規則,不要把其中一項設定當成全部。

訂閱網址與分享連結分開匯入

訂閱網址用來批次取得伺服器設定,分享連結通常只包含一筆設定。在 v2rayN 的「訂閱群組」中新增網址,填寫方便辨識的備註,儲存後執行「更新所有訂閱」。如果拿到的是分享連結,複製後可從剪貼簿匯入。清單為空時先查看更新紀錄,不要重複建立相同群組。相較於逐筆手動輸入,訂閱可保留群組並集中更新;右側是匯入後使用的本機入站片段,不是訂閱網址的格式。

查看訂閱匯入步驟 →
{
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ]
}

設定視窗只展示相關欄位,不能直接取代完整設定。圖形化用戶端會組合入站、出站、路由和 DNS;剛開始使用時,建議優先在設定介面修改,每次只調整一項,並記下修改前的值。

安裝入口 / 平台

依平台選擇 V2Ray 用戶端

桌面裝置優先選擇 v2rayN,Android 裝置優先選擇 v2rayNG,需要 V2Fly 核心時再考慮 v2flyNG。先確認作業系統與處理器,再選擇安裝格式;不要只憑檔名中的用戶端名稱判斷安裝套件是否適用。

Windows

選擇 v2rayN。下載頁提供桌面版與經典 WPF 版:桌面版採用跨平台介面,WPF 版則保留經典操作版面。先選擇熟悉的介面,再依套件內的說明完成安裝或解壓縮。請將程式放在可寫入的固定資料夾,避免直接從壓縮檔預覽視窗啟動,否則可能影響設定儲存與更新。

首次執行後,先匯入一筆可用設定並確認核心已啟動,再啟用系統代理。如果出現連接埠遭占用的提示,請檢查是否同時執行了另一個用戶端。安裝與更新前請備份設定;切換介面版本時,也先確認原有訂閱群組和路由設定是否完整。

前往下載

macOS

選擇 v2rayN,並依晶片區分 Apple Silicon 與 Intel 安裝套件。可在系統的「關於這台 Mac」中查看晶片或處理器資訊,不要只依電腦購買年份推測。安裝完成後,從「應用程式」資料夾啟動;遇到系統安全性提示時,先閱讀具體原因,再依系統提供的方式處理。

系統代理與 TUN 的權限需求不同。先讓瀏覽器透過系統代理正常連線,再評估是否需要 TUN。電腦從睡眠恢復、切換 Wi-Fi 網路或使用其他網路工具後,如果連線異常,請先檢查系統代理位址與核心執行狀態,不要立即刪除訂閱並重新安裝。

前往下載

Android

優先選擇採用 Xray 核心的 v2rayNG;需要 V2Fly 核心時,下載頁另有 v2flyNG 可供選擇。現今主流裝置通常選擇 arm64;若不確定處理器架構,請查看裝置資訊或選擇通用版。兩款應用程式的設定相容性取決於核心,能在某個用戶端匯入,不代表另一個用戶端也能執行。

匯入訂閱後選擇設定,再點選連線並確認系統的 VPN 授權。若需要在背景持續連線,請檢查電池最佳化和背景活動限制。如果應用程式切到背景後中斷,先確認系統是否終止了程序;若在前景也無法連線,再查看連線紀錄與訂閱更新結果。

前往下載

Linux

選擇 v2rayN,再依發行版選擇 deb 或 rpm,並依處理器選擇 x64 或 arm64。安裝格式與處理器架構是兩項獨立條件,不能互相取代。使用發行版提供的圖形化軟體安裝程式完成安裝;若相依套件不符合需求,先處理安裝程式指出的問題,再嘗試啟動用戶端。

不同桌面環境讀取系統代理的方式可能不同,有些應用程式仍需個別設定 SOCKS 或 HTTP 入口。先在明確遵循代理設定的應用程式中測試,再逐步擴展到其他應用程式。啟用 TUN 前請檢查權限與現有虛擬網路介面;疑難排解時先恢復一般代理狀態,減少同時變動的設定項目。

前往下載

查看所有用戶端 →下載中心彙整了安裝套件入口與適用說明。

操作順序 / 快速開始

從匯入訂閱到連線確認

首次設定先使用預設路由與一般代理,暫時保持 TUN 和區域網路共享關閉。基本連線正常後再增加功能,發生問題時也更容易找出具體環節。

  1. 新增訂閱,再更新設定清單

    在 v2rayN 開啟「訂閱群組」,新增訂閱網址與備註,儲存後執行更新。Android 版 v2rayNG 可從「訂閱群組設定」管理網址,再回到主畫面更新訂閱。複製網址時請確認沒有多出空格、換行或說明文字;分享連結應透過剪貼簿匯入,不要填在訂閱網址欄位。

    更新完成後,清單中應會顯示匯入的設定。如果清單仍為空,請查看紀錄,分辨是網址無法存取、內容為空,還是格式不受支援。訂閱連結可能包含存取憑證,請勿將完整網址張貼到公開討論區。用戶端只負責讀取設定,不會自動提供訂閱服務。

  2. 選擇設定,再設定代理模式

    在清單中選擇要使用的伺服器設定,讓用戶端啟動對應的核心。桌面端需要讓瀏覽器使用代理時,請選擇「自動設定系統代理」;Android 端則點選連線,並依系統提示允許建立 VPN 連線。首次測試時請維持一條明確的使用路徑,不要同時啟用多個負責相同流量接管功能的工具。

    此時先使用路由預設,不要直接貼上整份網路上的設定。系統代理決定應用程式是否將要求送到本機連接埠;路由則決定核心收到要求後如何選擇出口。應用程式若未遵循系統代理,反覆更換路由規則通常無法解決接管問題,應檢查應用程式本身的網路設定。

  3. 確認實際連線,再處理異常

    使用瀏覽器開啟日常需要的網頁,確認內容能正常載入,而不只是查看連線圖示或測試結果。核心測試成功只能表示特定測試路徑可用,不代表所有應用程式和網域都正常。接著再測試另一類目標是否依預期直連,確認分流策略沒有將本機服務錯誤導向代理出口。

    遇到異常時,依「核心是否啟動 → 應用程式是否進入代理 → 路由是否命中 → DNS 是否正常」的順序排查。連線逾時、憑證錯誤與網域解析失敗的原因各不相同,請保留相關錯誤資訊。需要分享紀錄時,先移除訂閱網址、伺服器驗證資訊和個人路徑。

查看完整教學 →

專案關係 / 開源

Project V、V2Fly 與 Xray

用戶端提供操作介面,核心負責協定連線與流量處理。選型時將這兩層分開檢視,才能判斷某項設定由哪個專案提供,以及為什麼同一個分享連結在不同用戶端中的表現可能不同。

從工具生態到核心分支

Project V 是以網路代理工具為核心發展的開源生態,V2Ray 是其中的重要組成。V2Fly 社群延續 V2Ray 核心的開發與維護,Xray 則是從 V2Ray 演進而來的另一個核心分支。兩者共用部分概念與設定結構,但後續支援的協定特性、傳輸方式和欄位可能有所不同,不能因名稱相近就認為設定完全一致。

VMess、VLESS 等是協定名稱,WebSocket、gRPC 等屬於傳輸方式,TLS 則涉及連線的傳輸安全設定。匯入設定時,這些參數都必須與伺服器端相符。協定名稱正確,不代表傳輸路徑、伺服器名稱和連接埠也正確;疑難排解時應逐項檢查欄位,不要一次變更所有選項。

圖形化用戶端與核心各自負責什麼

v2rayN 提供桌面端的訂閱群組、伺服器選擇、系統代理與路由管理介面,並將設定交由相應核心執行。v2rayNG 是 Android 端採用 Xray 核心的開源用戶端,v2flyNG 則提供另一種採用 V2Fly 核心的選擇。三款用戶端皆為開源專案,介面、套件製作與維護時程各自獨立,功能是否可用也取決於實際使用的核心能力。

選擇時先看平台,再確認現有設定所依賴的協定與傳輸特性。桌面端建議從 v2rayN 開始;Android 端優先考慮 v2rayNG,需要 V2Fly 相容行為時再評估 v2flyNG。不要只因核心名稱不同,就認定連線速度有固定差異;伺服器線路、網路環境與設定通常更直接影響連線結果。

開源專案並非共用同一份授權

開源表示程式碼依相應授權條款公開,可使用、修改與再散布的條件由各專案授權規定。V2Fly 的 V2Ray 核心與 Xray 核心採用 MPL 2.0,用戶端及其相依項目也可能採用其他授權。一般使用者主要留意功能與維護說明;若要修改、打包或散布軟體,應分別閱讀用戶端、核心及隨附元件的授權檔案。

公開程式碼有助於社群討論實作方式、回報問題與檢視變更,但不能取代使用者對設定來源的判斷。訂閱提供者、伺服器營運者和圖形化用戶端各自扮演不同角色。匯入前應確認設定來源,使用時也要了解連線會經過哪台伺服器;不要把用戶端開源等同於第三方服務值得信任。

更新時保留可還原的設定

用戶端更新可能調整選單、設定產生方式、核心元件與規則資料。更新前請備份訂閱群組、路由與必要的自訂設定,並記下目前可正常使用的組合。更新後先測試既有設定,再嘗試新功能;如果基本連線失效,應優先比對紀錄與設定變化,而不是重複匯入同一批訂閱。

更新訂閱、更新用戶端、更新核心與更新規則資料是不同操作。更新訂閱用來刷新伺服器設定,不會自動解決所有用戶端相容性問題;路由資料過舊也不一定需要重新安裝應用程式。日常維護時先確認需要更新的是哪一層,再使用對應入口,避免尚未找出問題前就擴大變動範圍。

查看三款用戶端比較評測 →閱讀新手到進階設定手冊 →

專題閱讀 / 文章

訂閱格式、協定與區域網路共享

完成基本連線後,再依使用情境閱讀專題。需要讓其他裝置共用代理入口時,請查看區域網路設定;匯入失敗時先辨認訂閱格式;比較協定時應留意實際設定需求,而不只是名稱。

查看所有文章 →依問題瀏覽常見問題 →