questions / answers

V2Ray 常見問題,設定與排查

從訂閱匯入到流量出口,依照問題發生的環節逐步排查。先確認應用程式是否接入用戶端,再檢查節點、路由與 DNS;每次只調整一項設定。

以下設定名稱可能因用戶端版本而異。記錄錯誤時請保留記錄中的錯誤類型,並遮蔽訂閱網址、身分資訊與伺服器存取憑證。

basics

基礎認知

先分清用戶端、核心與節點,再判斷設定影響哪個環節。

V2Ray、Xray 與 v2rayN 各自負責什麼?

V2Ray 是 Project V 代理生態系中的核心專案;V2Fly 延續相關核心的開發,Xray 則是另一個核心分支。核心負責連線、協定處理、DNS 與路由,v2rayN 則是用來管理設定的圖形介面用戶端。桌面版可使用 v2rayN;Android 可使用採用 Xray 核心的 v2rayNG,或採用 V2Fly 核心的 v2flyNG。在介面中成功新增節點,只代表設定已匯入,不代表一定能連上伺服器。排查時先確認用戶端是否已啟動核心,再查看連線記錄;切換核心前,應確認節點協定與傳輸設定受到支援。核心名稱不能用來判斷連線品質。

安裝用戶端後,為什麼還需要節點或訂閱?

用戶端是用來管理本機設定與轉送流量的工具,安裝檔本身不含可用的遠端服務。節點資訊包含伺服器位址、連接埠、協定、身分資料及傳輸參數;訂閱則是讓用戶端定期取得多個節點資訊的連結。請從有權使用的服務或自行架設的伺服器取得設定,再匯入用戶端。訂閱可以讀取,不代表其中的節點一定連得上;還要確認服務是否仍在有效期限內、伺服器狀態及目前的網路狀況。請勿把本機 SOCKS 位址 127.0.0.1 當成遠端節點,也不要在公開截圖或討論區貼出訂閱連結;連結可能包含帳戶存取識別資訊,應妥善保管。

VMess、VLESS、Trojan 與 Shadowsocks 該怎麼選?

協定由伺服器設定決定,不是用戶端中可任意選擇的項目。匯入分享連結時,請保留服務提供者設定的協定、連接埠、傳輸方式及安全層參數。VLESS 節點可能還需要指定 flow、REALITY 公鑰或伺服器名稱;Trojan 常搭配 TLS;VMess 與 Shadowsocks 也各自有身分驗證與加密參數。單純更改協定下拉選單通常會造成連線失敗,協定名稱本身也不代表速度較快。初次設定時,建議使用完整連結或 QR 碼;連線成功後再了解各欄位的用途。若確實需要更換協定,伺服器與用戶端都必須同步調整,並確認目前使用的核心支援所選組合。

系統代理、全域模式和 TUN 是同一層的設定嗎?

這三項設定分屬不同環節。系統代理會提供本機代理位址給應用程式使用,只有遵循系統代理設定的程式才會採用;TUN 則透過虛擬網路介面接收流量,通常能涵蓋更多不讀取系統代理設定的應用程式。全域模式描述流量進入核心後採用的路由策略,通常會將符合條件的流量送往代理出口,但不會自動接管所有程式。分流模式則依網域或 IP 等規則,選擇直連、代理或阻擋。要確認某個應用程式是否經由代理,先檢查流量有沒有進入用戶端,再確認命中了哪條規則。排查初期先選一種接入方式測試,避免同時調整系統代理、TUN 與路由,以免無法判斷問題出在哪裡。

延伸閱讀:協定與傳輸速查 · 訂閱與節點

installation

安裝設定

分別檢查安裝檔架構、訂閱格式與系統權限。

Android 安裝檔的 arm64 和 universal 該怎麼選?

arm64 安裝檔適用於採用 64 位元 ARM 架構,且系統支援相應應用程式的裝置,檔案通常較小;universal 安裝檔包含多種受支援的架構,適合不確定裝置架構時使用。近年多數主流手機通常可選擇 arm64,但光看購買年份或處理器規格不一定能確認,部分裝置仍使用 32 位元系統。若系統顯示無法安裝,先檢查系統版本、剩餘空間、既有應用程式的簽章及安裝權限,再確認是否為架構問題。升級前請保留訂閱群組與自訂規則,避免為了解決安裝衝突而直接解除安裝,導致設定遺失。v2rayNG 與 v2flyNG 的安裝檔應分別選擇,不能當成同一個應用程式的不同版本來覆蓋安裝。

訂閱匯入失敗時,應該先檢查哪些項目?

先區分訂閱網址與單一節點分享連結:訂閱網址應填入訂閱群組的網址欄位;單一節點連結則應使用剪貼簿或匯入分享連結的入口。在 v2rayN 中儲存群組後,還要執行更新訂閱;v2rayNG 也需要新增訂閱後再更新,不能只儲存名稱。請確認複製的內容完整,移除前後空格與換行,並確認沒有一併貼上網頁登入網址或說明文字。若記錄顯示解析失敗,伺服器傳回的內容可能是登入頁面、錯誤頁面,或用戶端不支援的設定格式,請向服務提供者確認。不要靠更改名稱或重複重新安裝來修復格式問題;先用已知相容的節點連結測試匯入功能。

現有節點仍能連線,為什麼訂閱更新失敗?

更新訂閱時連線的是訂閱服務位址,不一定是節點連線所使用的伺服器,因此兩者可能出現不同結果。先檢查連結是否過期、帳戶狀態是否正常,以及記錄中的 HTTP 狀態碼或逾時訊息。若訂閱網址只能透過代理存取,先啟用已知可用的節點,再選擇用戶端提供的透過代理更新方式;若必須直連,則使用直連更新。選項名稱與位置可能因用戶端版本而異。也要排除系統時間錯誤、DNS 解析異常或網路登入頁面的干擾。更新失敗時請保留原有群組,不要先清除所有節點;若長時間收到空白內容或格式有所變更,再向服務提供者確認訂閱格式。

啟用 TUN 時提示權限不足,該怎麼處理?

TUN 需要建立虛擬網路介面並調整路由,因此權限需求高於一般本機代理。Windows 通常需要依照用戶端提示,以系統管理員權限啟動或設定所需服務;Linux 請檢查目前版本的權限設定方式、虛擬網路裝置的存取權限及服務狀態;macOS 則依系統提示完成相應授權。Android 需要確認系統 VPN 授權,而且通常一次只能執行一個 VPN 服務。先關閉其他占用相同類型介面的工具,再查看用戶端記錄中的具體錯誤。不要把所有權限問題都歸因於節點無法使用,也不要任意修改系統檔案權限。若暫時無法完成授權,可先使用系統代理測試節點,等一般連線穩定後再設定 TUN。

操作步驟:訂閱匯入教學 · Android 入門說明 · 平台與安裝檔選擇

daily use

使用技巧

代理模式、應用程式接入與多裝置同步,不能只看節點名稱。

日常瀏覽該用全域模式,還是繞過中國大陸?

日常瀏覽可先使用分流模式,讓需要代理的目標經由代理出口,其餘目標則依規則直連。繞過中國大陸通常是依中國大陸的網域與 IP 分類,設定直連的預設方案;實際行為仍取決於用戶端的規則集。全域模式適合暫時測試代理出口,或需要統一出口的測試情境,但不代表所有應用程式都會自動將流量送進用戶端。切換模式後,請重新連線至同一個目標;必要時關閉原本的頁面或應用程式,避免既有長連線仍沿用舊路徑。若全域模式可用、分流模式卻無法使用,應優先檢查規則順序、分類資料與 DNS,而不是立刻更換節點。測試完成後請恢復常用策略,減少不必要的流量繞行。

瀏覽器可以上網,為什麼終端機或開發工具沒有走代理?

許多命令列工具不會自動讀取桌面環境的系統代理設定,需要在工具中設定代理位址,或為目前的處理程序設定相應環境變數。先確認用戶端實際的監聽位址、連接埠與協定;若 SOCKS 連接埠是 10808,可使用 curl -x socks5h://127.0.0.1:10808 -I https://www.example.com 測試此入口,若連接埠不同也要同步修改。socks5h 會將目標網域交由代理端解析,與在本機解析的行為不同。應用程式若在容器或虛擬機器中執行,127.0.0.1 指向的是該環境本身,不一定是主機。先在主機上確認連線,再檢查隔離環境的網路存取;不要為了省事就讓所有網路都能連到代理監聽埠。

允許區域網路連線後,其他裝置要怎麼設定代理?

其他裝置應填入執行用戶端之電腦的區域網路 IP 與對應的代理連接埠,不能填 127.0.0.1,因為該位址永遠指向目前使用的裝置。在 v2rayN 中啟用允許來自區域網路的連線後,還要確認核心的監聽範圍、系統防火牆,以及裝置之間是否能互相連線。路由器的訪客網路或無線用戶隔離可能會阻擋存取;HTTP 與 SOCKS 連接埠也不能任意互換。請只在可信任的網路中啟用分享,並將防火牆的允許範圍限制在需要使用的裝置或網段,避免將入口暴露於公網。連線失敗時,先測試同一個區域網路內是否能連到該連接埠,再檢查節點狀態;不需分享時,請關閉此選項並還原原本的監聽設定。

v2rayN 與 v2rayNG 如何讓多台裝置的設定保持一致?

各裝置可以使用相同的訂閱網址分別更新節點清單,也可以透過單一節點分享連結或 QR 碼傳送。訂閱通常只會分發節點,不會同步系統代理、TUN 權限、本機連接埠及完整路由規則,因此節點清單相同,不代表流量路徑也相同。先統一訂閱來源與更新時間,再逐台確認使用中的節點、分流模式、DNS 與自訂規則。桌面版與 Android 版的介面及功能支援有所不同,不宜直接互換完整設定檔;匯入前請先確認格式相容。分享 QR 碼或備份檔時,請留意其中包含的身分資訊,避免存放在公開相簿或群組聊天室。切換裝置後應重新測試,不要只憑節點名稱判斷設定已一致。

繼續閱讀:路由分流設定 · 多裝置設定同步方案

troubleshooting

故障排除

依網路、監聽入口、節點連線、路由與 DNS 的順序逐步縮小問題範圍。

節點測試逾時,就代表節點一定無法使用嗎?

不一定。TCP 連線測試、實際請求測試與應用程式存取檢查的內容並不相同,測試目標本身無法連線也可能造成逾時。先確認核心是否正常啟動,再檢查節點位址、連接埠、系統時間與傳輸參數;TLS 伺服器名稱、REALITY 公鑰或 flow 設定錯誤,都可能導致交握失敗。使用已知可用的節點及相同測試目標進行比對,並嘗試切換至另一個正常的網路,以區分伺服器端與目前網路的問題。不要把單次測試結果當成節點持續可用的保證,也不要只靠增加逾時時間來掩蓋設定錯誤。若多個節點同時失敗,優先檢查本機網路與用戶端記錄;只有單一節點失敗時,再向服務提供者確認。

顯示已連線但網頁無法開啟,應依什麼順序排查?

顯示已連線,可能只代表核心或 VPN 介面已啟動,不表示每個目標請求都成功。先確認本機網路可正常使用,並完成網路登入,再檢查系統時間、使用中的節點與用戶端記錄。接著確認本機監聽連接埠及應用程式的代理設定,使用明確指定代理的請求測試流量能否經由該入口;若測試成功但瀏覽器仍無法連線,請檢查瀏覽器代理擴充功能與系統設定。若請求進入核心後仍失敗,再暫時比較全域與分流模式,找出路由或 DNS 問題。使用 TUN 時也要檢查虛擬介面與路由。每次只修改一項並記錄結果,不要同時切換節點、變更 DNS 和重設所有規則,否則很難確認哪個步驟有效。

v2rayN 已設定系統代理,為什麼應用程式仍直接連線?

先檢查用戶端設定的代理位址是否與系統網路設定一致,並確認對應連接埠確實在監聽。Linux 各種桌面環境對系統代理的支援不同,部分應用程式只讀取自身設定或環境變數;瀏覽器擴充功能也可能覆寫系統代理。使用支援明確指定代理的工具測試入口;若能連線,接下來應檢查應用程式的接入方式,而不是直接重新安裝核心。也要分辨流量是未進入用戶端,還是進入後被路由規則設為直連,可搭配請求記錄判斷。若確實需要接管不讀取系統代理的應用程式,再評估是否使用 TUN。離開用戶端後若網路異常,應還原系統代理設定;若監聽已停止,但系統仍指向該連接埠,應用程式也會連線失敗。

只有部分網域無法開啟,該如何檢查 DNS 與分流規則?

先記下無法連線的網域與記錄中的錯誤,分辨是網域解析失敗、連線逾時還是憑證錯誤。比較全域與分流模式:若只有分流模式失敗,請檢查是否有排序較前的自訂規則將目標送往錯誤出口,以及 geosite、geoip 分類資料是否與規則相容。DNS 設定應配合流量出口,分別檢查節點伺服器位址及存取目標的解析方式;瀏覽器的安全 DNS 也可能使用另一條解析路徑。修改後重新建立連線,必要時清除應用程式快取,再測試相同網域。不要長期以 IP 位址取代需要 TLS 的網域連線,這可能影響伺服器名稱與憑證驗證。若記錄中出現 IPv6,還應確認相關網路是否連通,避免沒有根據地同時更改多項 DNS 設定。

排查補充:DNS 設定說明 · 已連線卻無法上網的逐項檢查清單