開放原始碼用戶端一覽

V2Ray中文站v2rayN 下載與設定

依平台選擇開放原始碼用戶端,從匯入訂閱開始,再查看路由分流與核心設定。

01 設定範例

用戶端設定與 JSON 欄位

用戶端負責管理訂閱並啟動核心;設定檔則描述核心如何接收、解析及轉送流量。以下片段可用來辨識欄位,不能直接當成完整設定檔執行。

訂閱項目與本機入站

訂閱可用來批次更新節點。以 v2rayN 為例,先新增訂閱網址並更新對應群組,再從更新後的清單選取節點。清單出現項目只表示用戶端已讀取設定,不代表伺服器已連線成功。訂閱網址是用戶端的管理資料,不是核心的 JSON 欄位。下方的 SOCKS 入站是啟動核心後供本機應用程式使用的代理入口,與遠端訂閱網址是兩回事。若要在應用程式中手動設定代理,請使用目前設定的連接埠。

{
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks"
    }
  ]
}

查看 JSON 手冊

02 安裝選項

依作業系統選擇用戶端

先確認裝置使用的作業系統,再查看處理器架構。桌面裝置選用 v2rayN;行動裝置則依設定需求選擇 v2rayNG 或 v2flyNG。

v2rayN 提供 x64 桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版則保留經典介面;兩者是不同的圖形介面程式,不代表兩種節點協定。先開啟系統的「關於」頁面查看系統類型,確認裝置能執行相應架構的程式。

若要從舊版本移轉,請先關閉原有程式,再啟動新程式。同一台電腦上的兩個用戶端若使用相同的本機監聽連接埠,後啟動的程式可能會顯示連接埠已被占用。切換後也要確認系統代理仍指向目前程式實際監聽的位址和連接埠。若啟動失敗,先判斷是介面程式未執行,還是介面開啟後核心啟動失敗,再查看相應的錯誤訊息。

在系統的「關於這台 Mac」中查看晶片或處理器資訊。顯示 Apple 晶片的裝置請選擇 Apple Silicon 對應的 arm64 安裝檔;顯示 Intel 處理器的裝置則選擇 x64。這兩種選項只差在處理器架構,不需依訂閱協定挑選,也不應只憑裝置外觀判斷。

開啟磁碟映像檔後,將應用程式移至「應用程式」資料夾再啟動,之後就能從固定位置開啟。首次測試時可先使用會讀取系統代理的瀏覽器,避免同時切換多項網路設定。Wi-Fi 與有線網路的代理設定可能分屬不同網路服務;如果更換網路後行為有所不同,請在目前使用的網路服務中確認設定,而不是先重新匯入訂閱。

多數較新的裝置可選用 arm64 套件,前提是系統支援執行該架構的應用程式;不確定時可選通用套件。通用套件通常包含多種架構的原生程式庫,但仍須符合用戶端本身的系統需求。v2rayNG 採用 Xray 核心;若要比對 V2Fly 的行為,再選用 v2flyNG。

首次使用 VPN 模式時,系統會要求確認連線權限。若裝置上已有其他應用程式建立 VPN,請先確認是否互相衝突。建立連線後,若特定應用程式的行為不同,先確認用戶端是否啟用了依應用程式篩選,再查看該應用程式是否列在納入或排除清單中。此時安裝架構通常不是排查重點;架構問題主要發生在安裝或載入原生程式庫時。

先依發行版選擇套件格式,再依裝置選擇架構。採用 Debian 套件管理系統的發行版通常選 deb,採用 RPM 套件管理系統的發行版通常選 rpm。兩種格式都有 x64 與 arm64 對應選項;套件格式正確不代表架構也正確,兩者都要分別確認。

如果套件管理工具提示缺少相依套件或不相容,先記下套件提供的訊息,並在安裝階段處理問題,再開啟 v2rayN。啟動後,桌面應用程式是否讀取系統代理,取決於桌面環境與應用程式本身。若瀏覽器可用、終端機卻無法連線,可另外檢查終端機工具的代理參數或環境設定;不要把終端機未經代理誤判為安裝失敗。

查看所有用戶端

03 初次設定

匯入、分流與連線測試

第一次先只測試一個節點、一套路由和一個應用程式。確認基本連線正常後,再啟用其他連線方式或調整 DNS。

  1. 01 資料來源

    匯入訂閱

    取得訂閱網址後,在訂閱群組中新增一筆資料並儲存,接著手動更新該群組。儲存網址與取得項目是兩個步驟;如果清單仍是空的,先確認選取的是剛新增的群組,再查看更新結果。若只有一條節點分享連結,請使用對應的單節點匯入功能。

    匯入後,先選擇一筆協定與傳輸參數明確的設定。若更新失敗,檢查網址是否遭截斷或多出空白;若更新成功但少了幾個節點,請優先確認這些節點的格式是否受用戶端支援。分享排查截圖時,請遮蔽訂閱網址、帳戶欄位和節點憑證。

  2. 02 出站規則

    選擇路由模式

    先釐清哪些連線需要直連,哪些請求應交由代理節點處理。使用用戶端預設規則時,先確認實際選用的規則組合,並檢查直連與代理目標的比對條件。辦公網路或區域網路服務可用來測試直連;代理端則選一個穩定且已知可連線的目標。

    系統代理開關會影響部分應用程式是否將流量送至本機入口;路由模式則決定核心收到連線後要將流量送往何處。兩項設定不能互相取代。如果修改規則後區域網路連線有所變化,請保留原節點不變,只切回原本的規則測試,方便判斷是比對條件改變,還是應用程式改用了不同入口。

  3. 03 實際連線

    連線並確認

    桌面端選擇節點,確認核心已準備好監聽,再視需要啟用系統代理;行動端則選好節點後建立 VPN 連線,並確認已取得系統授權。使用實際應用程式分別連線至直連與代理測試目標,同時查看用戶端記錄是否出現相應請求。清單中的延遲數值和連線狀態都不能取代這項測試。

    如果兩種測試目標都無法連線,先檢查本機入口或 VPN 狀態;若只有代理目標失敗,再檢查節點、路由是否符合條件,以及遠端交握。瀏覽器測試成功後,若還要使用命令列,請用目標工具另外測試。關閉用戶端前,可先關閉或清除系統代理,避免其他程式繼續連線至已停止的本機連接埠。

查看完整教學

04 開放原始碼生態

Project V、V2Fly 與 Xray

先區分介面、核心與協定。用戶端名稱用來選擇軟體;協定和傳輸設定則用來判斷連線是否相容。

用戶端
管理訂閱與節點,產生或載入設定
核心
讀取設定,處理解析、路由與轉送
協定
定義連線兩端如何交換資料

查看專案介紹

  1. Project V 與用戶端的分工

    Project V 是了解早期 V2Ray 專案的起點。V2Ray 將流量入口、轉送出口與比對規則分開定義:同一個入站收到的不同請求,可以透過路由送往不同出站。這種架構方便分開檢查流量如何進入,以及流量將前往何處,也讓不同圖形介面的用戶端能共用相同的設定概念。

    v2rayN、v2rayNG 與 v2flyNG 是開放原始碼圖形介面用戶端,分別提供節點管理、設定與啟動功能。桌面用戶端的介面設定不等同於核心設定檔;行動裝置的 VPN 授權則由系統管理。查找資料時,先判斷問題發生在介面、作業系統還是核心。例如,軟體介面能正常開啟,不代表核心已開始監聽;系統授予 VPN 權限,也不代表遠端交握一定成功。

  2. V2Fly 與 Xray 的共通語法及差異

    V2Fly 社群延續維護 V2Ray 核心,Xray 則由 V2Ray 程式碼分支發展而來。兩者在入站、出站及許多路由欄位上保留相似概念,也各自有獨立實作。遇到同名欄位時,仍須確認目前核心支援的範圍;尤其是較新的傳輸與安全選項,不能直接將一套設定的參數套用到另一套核心。

    選擇核心時,先確認節點參數的要求,再查看用戶端能呼叫哪個核心。如果某項設定在舊環境可用,換到新環境卻出現未知欄位或不支援的選項,先從記錄檔找出欄位名稱,再判斷是用戶端未產生正確參數,還是目標核心不認得該欄位。使用不含敏感資訊的精簡設定檔進行比對,比反覆重新安裝更容易找出問題。常見名稱可參考核心術語。

  3. 分別確認協定、傳輸與安全層

    VMess、VLESS 和 Trojan 都會出現在這個生態系中,但驗證方式、連線參數與安全層要求各不相同。協定欄位與傳輸欄位描述的是不同層面:用戶端能辨識某種協定,不代表支援節點使用的每一種傳輸組合。即使遠端位址和連接埠正確,傳輸參數或伺服器名稱不一致仍可能導致連線失敗。

    例如,VLESS 本身不提供內容加密;閱讀相關設定時,還要查看實際使用的安全層,不能只從協定名稱推斷連線特性。用戶端和核心的程式碼採開放原始碼,也不代表透過軟體匯入的第三方節點由這些專案營運。軟體來源、連線設定與節點營運者應分開判斷。各術語的詳細說明請參閱協定速查。

  4. 用戶端、核心與訂閱更新各有範圍

    用戶端更新可能調整介面或產生設定的方式;核心更新可能影響支援的欄位;訂閱更新則會重新整理群組中的節點清單。三者不一定要同時更新。排查近期變化時,先記下問題從哪個步驟開始:軟體升級後無法啟動,應查看核心記錄;更新訂閱後只有某個節點失效,則先確認該節點的新參數。

    手動管理規則時,可記錄目前使用的路由設定、重要標籤與本機連接埠,方便變更後比對。先用一筆已知可用的設定測試代理入口與遠端連線,再逐項還原自訂路由與解析設定。若要移轉訂閱和自訂設定,含有憑證的資料應存放在安全可控的位置;提交故障紀錄時,通常只需提供錯誤類別與相關欄位名稱。

  5. 依錯誤發生的位置查找資料

    訂閱清單空白,就從匯入功能、群組及更新錯誤開始檢查;清單正常但所有應用程式都無法連線,就確認核心是否啟動、連接埠是否正在監聽,以及應用程式是否將請求送至本機入口。只有部分目標連線失敗時,再檢查規則是否符合、網域解析或遠端連線。依照這個順序排查,能避免用更換節點來處理本機連線問題,也能避免節點已失效時還不斷修改系統代理。

    查詢介面操作請參閱入門指南;需要了解欄位值和結構時,請參閱JSON 手冊。手冊中的入站與出站片段只涵蓋範例所討論的部分;合併至現有設定時,先檢查同名標籤的引用方式與預設出站順序,再以實際連線驗證。

05 使用心得

安裝、代理模式與節點選擇

依目前遇到的問題選讀:先確認用戶端能否啟動,再檢查請求是否進入核心,最後比較節點的連線表現。

查看所有文章