Windows
v2rayN桌面版採用跨平台介面,經典 WPF 版則保留熟悉的操作配置。初次安裝可先了解桌面版;若已有使用習慣與設定,先比較介面差異再決定。安裝完成後,確認用戶端能正常啟動核心,再匯入訂閱;程式成功啟動不代表代理已生效。
桌面裝置可先查看 v2rayN,Android 裝置可先查看 v2rayNG;需要 V2Fly 核心時,再了解 v2flyNG。安裝檔取決於作業系統與處理器,連線方式則取決於設定與核心。將這兩件事分開判斷,就不容易選錯。下載頁集中列出各平台的下載入口與安裝需求,首頁則協助你確認方向。
用戶端負責儲存設定、啟動核心及設定流量入口,不會憑空產生可用的遠端服務。開始前,請準備好有權使用的訂閱網址或伺服器參數。若已有舊設定,先保留群組與自訂路由,再安裝或移轉;第一次使用則先按照教學完成單一連線測試,暫時不必同時啟用所有進階選項。
桌面版採用跨平台介面,經典 WPF 版則保留熟悉的操作配置。初次安裝可先了解桌面版;若已有使用習慣與設定,先比較介面差異再決定。安裝完成後,確認用戶端能正常啟動核心,再匯入訂閱;程式成功啟動不代表代理已生效。
先在系統的「關於這台 Mac」確認晶片,再選擇 Apple Silicon 或 Intel 對應的下載入口。匯入訂閱後,確認系統代理是否已啟用,以及瀏覽器是否沿用系統設定。需要使用 TUN 時,再另外處理權限;初次連線不必同時啟用系統代理與虛擬網卡,以免增加難以判斷的變因。
v2rayNG 使用 Xray 核心,v2flyNG 則提供採用 V2Fly 核心的另一種選擇。多數較新的手機可先查看 arm64 版本;若不確定裝置架構,可查詢裝置資訊或考慮通用版。初次連線時須確認系統 VPN 權限;若切換至背景後就中斷,請再檢查電池最佳化、背景執行權限,以及其他占用 VPN 通道的應用程式。
依 Linux 發行版的套件格式選擇 deb 或 rpm,再確認處理器架構。圖形介面的系統代理設定不一定適用於終端機程式;每個應用程式是否會使用代理,都要分別確認。如果瀏覽器可以連線、命令列卻不行,先檢查該程式的代理設定與環境變數,不要直接更換整套伺服器設定。
先釐清三個環節:應用程式將請求送至本機入口,核心依照規則選擇出口,DNS 則為連線查詢所需資訊。用戶端透過圖形介面集中管理這些設定;發生問題時,沿著這條路徑逐一檢查,比反覆匯入同一筆訂閱更有效。
訂閱可將多筆伺服器設定集中在同一個更新入口。先建立群組,再貼上有權使用的網址;更新後,確認清單中確實出現設定。一般更新失敗時,可在現有連線正常的前提下,嘗試透過代理更新。訂閱網址可能包含存取憑證,不適合放進截圖或公開記錄。與逐筆手動輸入相比,群組較容易保留設定來源與更新範圍;不過,自訂備註、排序與路由應另外備份,避免誤將遠端更新當成本機設定的永久備份。右側範例僅示範在 JSON 中儲存 URL 的寫法,並非用戶端訂閱檔案格式。
{
"url": "https://example.com/sub"
}
VMess、VLESS 與 Trojan 是不同的出站協定,不能任意互換。匯入後還要確認連接埠、傳輸方式及 TLS 等安全設定;即使協定相同,也不代表所有參數都相容。圖形用戶端方便儲存及切換多種設定,但實際能否執行仍取決於所選核心。請先依照伺服器提供的完整參數設定,連線成功後再考慮調整傳輸選項。右側範例展示直連與阻斷兩種基本出站,用來說明路由如何引用 tag;範例不包含遠端服務參數,不能取代可用的代理設定。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom"
},
{
"tag": "block",
"protocol": "blackhole"
}
]
}
路由決定連線要交由哪個出站處理,規則會由上往下比對,因此例外規則通常要放在涵蓋範圍較廣的規則之前。geosite 用於網域集合,geoip 用於 IP 位址集合,兩者都需要相應的資料庫。初期先保留少量明確規則,例如讓區域網路位址直連,再逐項加入需要的網域。相較於所有流量都走同一個出口,分流能減少對本地服務的影響,但必須維護規則順序與出站標籤。範例中的 direct 必須確實存在於出站設定中;修改後請以具體目標測試比對結果,不要只因規則已儲存就認定設定生效。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}
DNS 設定不只是填入解析器網址,還涉及由誰發出查詢、查詢走哪條路徑,以及解析結果如何參與路由。核心內建的 DNS 不會自動接管系統中所有應用程式的解析。遇到網域無法連線時,先分辨是解析失敗還是連線失敗,再檢查查詢策略與實際出口。比起不斷更換解析器,釐清應用程式、系統與核心各自負責的範圍更有幫助。範例展示伺服器清單與 IPv4 查詢策略的寫法,並非適用所有網路的建議值;修改前先記下原設定,每次只調整一項,才能判斷變化的原因。
{
"dns": {
"servers": [
"1.1.1.1",
"localhost"
],
"queryStrategy": "UseIPv4"
}
}
系統代理讓遵循系統設定的應用程式使用本機代理入口;TUN 則透過虛擬網路介面處理流量,兩者的權限需求與影響範圍不同。初次設定建議先使用系統代理完成測試,再依實際需求了解 TUN。右側是本機 SOCKS 入站範例,並非 TUN 設定;監聽迴圈位址時,只接受本機連線。相較於直接開放區域網路監聽,這種起始設定更容易控制存取範圍。若確實需要其他裝置連線,還須一併檢查防火牆、驗證方式與網路邊界,不能只將監聽位址改成所有介面就算完成。
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"udp": true
}
}
]
}
用戶端介面與代理核心負責不同工作;介面中出現某個選項,不代表目前使用的核心一定能辨識對應欄位。切換前先確認設定使用的協定、傳輸方式與安全特性,再查閱核心的支援範圍。比起只看名稱判斷,啟動記錄更能指出不支援的欄位或參數。建議保留一份可用設定,切換後先進行最基本的連線測試,再還原自訂路由與 DNS。右側是常見記錄層級範例,並非核心選擇開關;核心通常要在用戶端設定中選擇,不能靠在 JSON 中新增自訂欄位來切換。
{
"log": {
"loglevel": "warning"
}
}
如果訂閱已更新卻無法連線,先確認是否選取有效設定,再查看核心啟動記錄。接著確認應用程式是否確實連上本機入站,最後檢查路由選取的出口與網域解析。TCP 連接埠可連通,只代表有機會建立交握,不能取代完整的協定連線;測試失敗也可能是測試目標本身無法連線。保留原始錯誤訊息,比只記下「逾時」更容易找出問題。
設定參考中的 JSON 用來說明欄位之間的關係。用戶端通常會依介面設定產生執行設定,直接修改暫存產生檔,可能會在下次啟動時被覆寫。需要長期保留的規則,應放在用戶端支援的自訂入口,並在修改後檢查產生的設定。完整欄位說明可從入站章節開始閱讀;第一次操作則可接著查看訂閱匯入教學。
「V2Ray」在日常討論中常被當作一個大類名稱,但實際操作時,最好將專案生態系、代理核心與圖形用戶端分開理解。Project V 提供模組化代理工具的設計概念:入站接收請求,路由決定流量去向,出站負責建立連線。V2Fly 延續 V2Ray 的社群開發,Xray 則發展出另一條核心分支。兩者有共同的技術背景,也各自持續發展功能,不能因為名稱相近,就認為設定永遠通用。
用戶端負責操作介面,核心負責處理連線。v2rayN 將訂閱、伺服器清單、系統代理與設定選項集中在桌面介面,再呼叫相應核心運作。v2rayNG 適用於 Android 裝置,採用 Xray 核心;v2flyNG 則提供 V2Fly 核心路線。這三款用戶端都是開源軟體專案。選擇時先看裝置,再看設定需求,不必為了名稱一致,勉強要求不同裝置使用完全相同的介面。
協定支援必須具體到各項功能。VMess、VLESS、Trojan 是協定層級的選擇;傳輸方式以及 TLS、REALITY 等安全設定則是不同面向。設定能否運作,取決於用戶端能否正確匯入、核心能否辨識,以及伺服器參數是否一致。只看到「支援 VLESS」,還不足以判斷含有特定傳輸方式與安全選項的設定是否相容。遇到無法啟動時,先查看錯誤欄位,再核對支援範圍,比反覆更換用戶端更能有效排查。
開源授權也要依專案分別確認。v2rayN、v2rayNG 與 v2flyNG 採用 GPL 系列授權;V2Fly 與 Xray 核心專案則採用 MPL 2.0。授權條款說明原始碼的使用、修改與散布條件,並不代表你獲得使用遠端服務的授權。訂閱、伺服器與網路仍各有管理規範。日常使用未必需要逐條研究授權內容,但若要重新散布、修改或整合程式碼,就應閱讀相應專案的授權條款,不能將「開源」簡單理解為完全不受限制。
更新也分成不同層面:用戶端更新會改變介面與整合功能,核心更新會影響協定實作,訂閱更新會替換遠端設定,規則資料庫更新則會影響網域與 IP 集合。這四種更新各自解決不同問題,遇到故障時不必一次全部更新。例如網站被錯誤分流時,可先檢查規則順序與資料庫;若核心明確回報欄位不受支援,再確認核心功能;如果只有一個訂閱群組更新失敗,則先檢查網址、權限與更新路徑。
保留可還原的設定,比一次就調整到位更實際。修改前記下目前的出站、路由模式、DNS 與代理入口,每次只變更一組設定。確認瀏覽器能正常連線後,再測試其他需要使用的應用程式。對背景執行的應用程式、遊戲或命令列程式,不要預設它們都會遵循系統代理;使用 TUN 時,也不要認為啟用後就能涵蓋所有網路情境。流量入口、路由與解析都必須依裝置環境實際測試;介面上的開關狀態只代表設定,不代表結果。
測試連線時,要先了解結果代表什麼。TCPing 較接近連接埠連通性檢查;實際連線測試則會繼續檢查協定交握及測試目標。結果會受到本機網路、伺服器狀態、解析結果與目標回應影響;單次成功不代表所有應用程式都能正常使用,單次失敗也不能直接證明是用戶端出了問題。可以固定一套測試步驟:選取設定、啟動核心、確認代理模式、連線至預期目標,再比對記錄進行檢查。步驟一致,結果才有比較價值。
這裡的中文說明將「如何操作」與「為什麼這樣設定」分開:教學介紹安裝後的連續操作步驟,設定參考說明欄位與片段,問題排查依症狀縮小檢查範圍,技術筆記則探討特定機制。本網站是獨立整理用戶端資料的網站,並非遠端連線服務提供者。準備好有權使用的設定後,可先完成基本連線,再決定是否需要複雜的分流設定;依眼前需求閱讀即可,不必一次看完所有章節。
完成基本連線後,再依問題深入了解。以下三篇分別說明首次連線驗證、核心選擇與 FakeDNS,避免將不同層級的設定混在一起調整。
說明 FakeDNS 如何透過保留網段的虛擬位址取得網域資訊、如何搭配 sniffing 與 TUN 模式,以及哪些情境適合啟用、哪些情況可能造成問題。
閱讀筆記:FakeDNS 運作原理整理 Project V 之後 V2Fly 與 Xray 兩條分支的發展歷程,比較 VLESS、XTLS、REALITY 等功能的支援差異,並說明 v2rayNG 與 v2flyNG 的選擇方式。
閱讀筆記:Xray 與 V2Fly 核心差異匯入訂閱後,先了解 TCPing 與實際連線測試結果的差異,選擇可用節點,再使用系統代理模式並透過瀏覽器確認流量確實經由代理傳送。
閱讀筆記:v2rayN 首次連線步驟