開源用戶端Android 與桌面版

V2Ray Android 下載

桌面版選 v2rayN,Android 優先選 v2rayNG;從挑選安裝檔開始,依序完成訂閱匯入與路由分流。

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks

連線異常與對應設定

先找出問題發生在哪個步驟:更新訂閱只會取得設定,啟用系統代理才會改變部分應用程式的連線入口,而路由規則則決定進入用戶端的流量如何傳送。這三個步驟不能互相取代。排查時一次只改一項設定,並用同一個應用程式重試,才容易確認是哪項設定生效。

常見問題

  • 已啟用系統代理,瀏覽器仍直接連線。排除瀏覽器本身的代理設定後,再確認請求是沒有進入用戶端,還是進入後符合直連規則。
  • 更新訂閱後清單是空的。儲存網址只會新增群組項目;更新可能失敗,也可能成功寫入其他群組。
  • Android 螢幕一鎖定,過一會兒就斷線。如果回到應用程式後才恢復,先檢查系統的背景執行限制,不必立刻更換連線設定。

對應設定

  • 在 v2rayN 選擇「自動設定系統代理」,確認瀏覽器使用系統設定,再到「路由設定」檢查目標是否符合直連規則。
  • 開啟「訂閱群組」,選取剛儲存的群組並更新目前訂閱。若顯示解析失敗,先確認取得的是訂閱網址,而不是帳戶登入頁面。
  • 在 Android 系統的 v2rayNG 應用程式資訊中查看電池設定。若有「不受限制」選項,可暫時選取並測試鎖定螢幕後的連線;確認改善後再保留此設定。

路由規則範例:目標符合私人位址集合時,透過標記為 direct 的出站傳送。此標記必須與現有出站名稱一致。

{
  "type": "field",
  "ip": ["geoip:private"],
  "outboundTag": "direct"
}

五項用戶端設定

訂閱群組與清單更新

訂閱群組適合管理一批會變動的連線設定;若只需匯入單一項目,則直接使用單一連結即可。桌面版 v2rayN 可先在「訂閱群組」儲存網址,再更新目前群組;Android 版 v2rayNG 則從側邊選單進入訂閱群組設定,儲存後回到主清單更新。確認新項目出現在正確群組後,再手動選取一筆連線設定。若更新後自訂項目遭到覆蓋,請將本機項目存放在獨立群組,而非反覆修改訂閱群組內容。

訂閱群組更新目前訂閱

介面示意將分散的設定集中呈現,方便對照,但不代表實際選單順序。若目前用戶端的用詞不同,可先查閱概念速查:確認要調整的是流量入口、目標比對,還是連線設定本身,再返回對應選單。

依作業系統選擇安裝檔

先確認要安裝在哪部裝置,再依作業系統與處理器架構挑選安裝檔。同一架構的安裝檔也不能跨作業系統使用;已安裝的裝置在更新前,還要確認目前使用的用戶端與發行版本。

v2rayN 提供跨平台介面的桌面版,以及經典 WPF 版。初次使用可先選桌面版;若手邊的操作說明以經典介面為例,選擇 WPF 版會更容易對照。前往系統的「關於」查看「系統類型」,確認裝置適用下載頁列出的架構。

若應用程式在視窗出現前就關閉,請先查看發行說明列出的桌面執行環境。此時尚未進入訂閱或連線階段,修改節點參數無法解決啟動失敗。

前往下載

在「關於這台 Mac」查看「晶片」或「處理器」。顯示 Apple 晶片的機型請選 Apple Silicon 安裝檔;顯示 Intel 處理器的機型則選 Intel 安裝檔。不要依購買年份猜測,同一時期可能推出不同架構的機型。

開啟磁碟映像檔後,依其中的安裝說明將應用程式移至「應用程式」資料夾。若曾直接從映像檔視窗試用用戶端,請先結束程式,再從實際安裝位置啟動,避免安裝與測試時開啟不同副本。

前往下載

優先考慮以 Xray 為基礎的 v2rayNG;若有明確的 V2Fly 設定需求,再評估 v2flyNG。多數近年的裝置可選 arm64 安裝檔;不確定系統支援哪種架構時,可先查看通用版,並核對最低系統需求。

若系統提示與已安裝的應用程式衝突,先確認是否為覆蓋安裝失敗。解除安裝可能會清除本機設定,排查前請先備份訂閱群組與手動建立的項目,不要一開始就解除安裝。

前往下載

安裝桌面版 v2rayN 時,先依發行版的套件管理系統選擇 deb 或 rpm,再確認處理器架構。Debian、Ubuntu 通常使用 deb,Fedora 通常使用 rpm;若使用 ARM 裝置,也要選擇相符架構的套件。

用戶端能啟動,不代表桌面應用程式就會使用系統代理。安裝後先查看目前桌面環境的網路代理設定,再以會讀取該設定的應用程式驗證;部分應用程式仍須在自身設定中指定連線方式。

前往下載

查看所有用戶端 →

從匯入到驗證的三個步驟

第一次連線時先保留預設設定,使用已知可用的設定建立基準。確認連線正常後,再調整分流、應用程式清單或背景設定;之後若發生問題,就能回到上一步重試。

  1. 匯入設定並選取項目

    若有訂閱網址,請在用戶端新增群組,填入方便辨識的名稱與訂閱網址,儲存後更新該群組。若只有一筆分享連結,請使用從剪貼簿匯入的功能,不必先建立訂閱。匯入後檢查主清單是否出現預期項目,並選取一筆作為測試。若用戶端顯示找不到設定,先確認複製的內容是完整網址或分享連結,而非 QR Code 旁的說明文字。訂閱網址可能包含存取憑證,請勿將完整網址貼在公開截圖或問題回報中。

  2. 讓測試應用程式接入

    桌面端在 v2rayN 選取設定後,啟用「自動設定系統代理」,再開啟一個使用系統代理的瀏覽器。Android 端則在 v2rayNG 點選連線;首次出現系統 VPN 權限確認時,先確認由哪個應用程式發起,再授予權限。測試期間先不要修改應用程式清單,必要時確認沒有其他 VPN 正在佔用系統連線。若在啟用代理或授予系統權限前就遇到錯誤,請先處理用戶端啟動、執行環境或授權問題,不必急著修改路由規則。

  3. 以實際請求判斷問題出在哪個步驟

    開啟平常會瀏覽的頁面,發出一筆新請求並記下時間,再回到用戶端查看當時的執行記錄。若找不到對應記錄,先確認測試應用程式是否已接入;若記錄顯示直接連線,但預期應使用代理,再檢查規則比對結果;若已嘗試建立連線卻逾時,依序檢查本機網路、連線設定與伺服器狀態。驗證完成後,可還原原本的系統代理設定或中斷 Android VPN,再用同一個應用程式重試,確認連線狀態確實會隨設定變化。

查看完整教學 →

Project V 生態系與用戶端授權

專案、核心與用戶端分屬不同層次。先釐清文件討論的是哪一層,才能判斷某項功能屬於連線協定、核心實作,還是介面提供的設定。

Project V 與社群維護

Project V 是 V2Ray 早期所屬的專案生態系;V2Ray 核心負責處理入站、出站與路由。V2Fly 社群持續維護 V2Ray 核心,Xray 則從這個程式碼脈絡分支發展。日常討論中,「V2Ray」可能指核心,也常被用來泛稱這類工具。遇到教學提到「支援 V2Ray」時,應進一步確認實際指的是可匯入某種分享格式,還是能依所用協定與傳輸參數完成連線。

Xray 與 V2Fly 的相容範圍

兩種核心路線共用部分設定概念,但協定名稱相同,不代表所有傳輸與安全設定都相容。尤其要分別確認協定類型與附加欄位:使用 VLESS 的設定也可能要求特定傳輸方式或安全選項。若更換核心後用戶端能顯示項目,但啟動或握手仍失敗,應逐項比對原始設定與支援欄位,並確認伺服器端的需求;不能把「已匯入」視為「已相容」。

三款開源圖形化用戶端

v2rayN 適用於桌面環境,可管理訂閱、參數與系統代理;v2rayNG 以 Xray 為基礎,透過 Android 系統 VPN 服務接入連線;v2flyNG 採用 V2Fly 核心,為有相關設定需求的 Android 裝置提供另一種選擇。三款圖形化用戶端皆採 GPL-3.0 開源授權,可免費使用。用戶端授權不等於核心及其他元件的授權,也不包含可用的伺服器或訂閱服務;已有連線設定時,仍應依實際參數選擇用戶端。

更新前後的檢查順序

用戶端、核心與路由規則資料可能分別更新。更新用戶端可能影響介面或系統接入,更新核心則可能改變設定解析與連線行為。若只有個別網域的出站結果不如預期,請優先檢查目前使用的路由規則與資料,不要同時更換用戶端和核心。更新前記下啟用的群組、路由預設與應用程式範圍;更新後先重現一筆原本可用的連線,再測試新增設定,方便區分版本遷移與既有問題。

比較三款用戶端的適用情境 →

執行記錄與故障排除

視窗無法開啟、單筆連線逾時、記錄出現握手錯誤,各有不同的檢查起點。先選擇最符合目前狀況的文章;若多個應用程式同時異常,建議從問題診斷依症狀逐項排除。

查看所有文章 →