說明中心 / 設定與故障排除

v2rayN 常見問題

從匯入訂閱到連線故障,依問題發生的環節逐一查找。先確認哪個步驟出錯,再修改對應設定;一次只調整一項,並保留原始值以便還原。

基礎知識

用戶端、訂閱與代理模式

先釐清設定來源、請求入口,以及核心如何處理連線。

V2Ray、核心與用戶端分別是什麼?

V2Ray 通常指 Project V 代理生態中的相關技術與程式。核心負責處理協定、連線與路由,圖形用戶端則提供匯入訂閱、選擇伺服器及修改設定的介面。V2Fly 與 Xray 是相關的核心系列,支援範圍與設定細節並不完全相同。遇到協定不支援時,應確認用戶端實際呼叫的核心及其版本,而不只是看視窗上顯示的用戶端名稱。

v2rayN、v2rayNG 與 v2flyNG 該怎麼選?

Windows、macOS 與 Linux 桌面環境可優先考慮 v2rayN。Android 則可優先考慮採用 Xray 核心的 v2rayNG;若要配合 V2Fly 核心設定,再考慮 v2flyNG。先依作業系統選擇,再確認伺服器要求的協定與傳輸方式,別只因名稱相似就互換設定。用戶端與核心的支援範圍會隨版本變動,舊版無法辨識的欄位不一定代表訂閱網址有誤。

訂閱網址和單一節點分享連結有什麼不同?

訂閱網址通常是用來取得一組設定的網址;更新訂閱時,會重新下載伺服器提供的項目。單一節點分享連結通常只包含一份連線設定。兩者的匯入入口可能不同,不能把一般網頁網址當成訂閱網址使用。訂閱網址中的權杖可能代表帳戶存取權限,應像密碼一樣妥善保管。向他人求助時,請隱藏完整網址與憑證,只提供錯誤訊息及必要的設定資訊。

系統代理、TUN 與路由分流各自負責哪個環節?

系統代理會引導遵循系統設定的應用程式,將請求交給本機代理連接埠;TUN 則透過虛擬網路介面接管符合條件的網路流量,通常需要額外權限。路由分流是在流量進入核心後,決定要直連、代理或封鎖。三者不是同一個開關。瀏覽器能用、其他程式卻無法連線時,應先確認該程式是否遵循系統代理,再判斷是否需要 TUN,而不是直接把路由改成全域代理。

安裝用戶端後,為什麼還需要訂閱或伺服器設定?

用戶端提供本機設定管理與連線功能,不代表已具備可用的遠端服務。建立代理連線仍需有效的伺服器位址、連接埠與驗證參數,通常由訂閱或單一設定提供。安裝成功只代表程式能執行,不能據此判定遠端連線可用。首次使用時,先取得有權使用的設定,再完成匯入、選擇使用中的伺服器並設定流量入口;沒有設定時,反覆切換系統代理也無法補上這些參數。

查看術語說明 →
安裝設定

安裝包、訂閱匯入與權限

先讓用戶端與核心正常執行,再處理訂閱及流量接管。介面選項名稱可能因版本略有不同。

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

確認裝置支援 arm64 時,優先選擇對應的安裝包,檔案通常較小。多數較新的手機符合這項條件,但晶片支援 64 位元,不代表系統一定提供相應的執行環境,應以裝置系統資訊或實際安裝結果為準。不確定架構時,可試用涵蓋多種架構的 universal 安裝包。若安裝失敗,也要檢查系統版本、剩餘空間,以及同名應用程式的簽章是否一致,不要把所有安裝錯誤都歸因於架構。

訂閱匯入失敗或匯入後清單空白,該先檢查什麼?

先確認複製的是完整訂閱網址,沒有換行、前後空格或通訊軟體附加的標點,再從訂閱群組的網址輸入欄位匯入。儲存群組後執行更新;部分版本不會在儲存時立即取得內容。如果回傳的是登入頁面、錯誤頁面或空白內容,清單也可能是空的。接著確認訂閱是否有效、輸出格式是否適用於目前的用戶端;若出現解析失敗,記下錯誤類型並向設定提供者確認格式,不要任意刪改網址參數。

v2rayN 系統代理沒有生效,應按照什麼順序檢查?

先確認核心已正常啟動,並已選取有效的伺服器,再將系統代理設為「自動設定系統代理」。接著檢查作業系統中的代理位址與連接埠,是否符合用戶端的本機監聽設定;並沒有適用於所有安裝方式的固定連接埠。瀏覽器擴充功能、其他代理工具或組織的裝置政策都可能覆寫設定,應逐一排除。如果只有特定應用程式無法使用,確認它是否會讀取系統代理;也可能需要在應用程式本身指定代理。

啟用 TUN 時顯示權限不足或建立虛擬網卡失敗,該怎麼辦?

先關閉 TUN,確認一般系統代理能否正常運作,再依用戶端提示授予所需權限。Windows 可能需要系統管理員權限及相關網路元件;macOS 需要完成相關網路授權;Linux 則需符合虛擬網路介面與權限要求。各版本的實作方式不盡相同,請以目前的錯誤訊息為準。不要因此關閉所有安全防護;先確認是否有其他 VPN 或虛擬網卡占用,再查看核心啟動記錄中的第一則相關錯誤。

macOS 開啟 v2rayN 時遭系統封鎖,該如何處理?

先確認安裝包符合處理器型號,Apple Silicon 與 Intel 應選擇對應版本。若系統提示無法驗證開發者,請先確認下載來源可信,再前往系統設定中的「隱私權與安全性」,依系統提供的選項允許開啟。不同系統版本的選項名稱可能不同。來源不明或提示檔案損毀時,不要直接執行網路上的批次解除限制指令。程式能開啟後,再分別檢查系統代理與網路權限;允許開啟應用程式不代表 TUN 權限已經完整。

使用技巧

訂閱更新、分流與連線確認

成功取得設定、流量進入用戶端、遠端請求完成,是三項需要分別確認的結果。

已啟用自動更新訂閱,為什麼設定還是沒有變?

自動更新通常要求用戶端正在執行,且已到達設定的更新間隔;電腦休眠或應用程式已關閉時,不應假設更新工作仍會執行。先手動更新一次,確認更新結果與群組是否正確,再檢查更新功能是否已啟用及間隔設定。更新成功但項目沒有變化,也可能是伺服器端沒有發布新內容。自動更新只負責重新取得設定,不會自動修復已過期的帳戶、失效的網址或系統代理設定,因此仍須分辨是取得設定失敗還是連線失敗。

「繞過中國大陸」和全域代理有什麼不同?平常該怎麼選?

「繞過中國大陸」通常透過網域與位址規則,讓符合中國大陸範圍的目標直連,其他目標則依其餘規則處理;實際行為取決於目前的規則順序與資料檔。全域代理通常會將已進入用戶端的流量交由代理出口處理,但不會自動接管原本不遵循系統代理的程式。平常可先選擇符合需求的分流模式,遇到單一網站的問題時再暫時切換比對;測試後請恢復原設定,避免長期靠切換模式掩蓋規則錯誤。

Android 瀏覽器能上網,但部分應用程式無法使用,該如何排查?

先確認 v2rayNG 已建立系統 VPN 連線,再檢查應用程式代理清單,以及清單目前代表允許還是排除。遭排除的應用程式不會如預期進入用戶端。也要確認是否有其他 VPN、工作資料夾的網路政策或廠商的背景執行限制。如果應用程式已被接管,接著檢查它連線的網域是否被路由規則指定為直連。每次只修改一項設定並重新開啟目標應用程式,才能判斷問題出在接管範圍、分流規則還是遠端連線。

更新訂閱會覆蓋手動修改的節點參數嗎?

有可能。訂閱群組中的項目通常會根據遠端內容重新產生或同步;直接修改其中的位址、連接埠或傳輸參數,下次更新後可能會還原,實際情況取決於用戶端版本與同步方式。若要長期保留實驗設定,請先另存為獨立的手動項目,並使用清楚的別名與訂閱項目區分。修改前記下原始值,測試後只保留必要的變更。不要為了保留單一修改而停用所有訂閱更新,否則其他設定也可能長期停留在舊版本。

如何確認實際請求有經過代理,而不只是開關已開啟?

先用同一個瀏覽器開啟已知可用的 HTTPS 網頁,再對照用戶端連線記錄,查看該網域符合哪條路由規則、使用哪個出口。必要時可用可信的出口位址查詢網站輔助比對,但出口位址改變本身無法證明所有應用程式都已被接管。快取頁面、瀏覽器獨立代理與直連規則都可能影響判斷。測試時應同時確認目標應用程式已進入用戶端、路由選擇正確且請求成功,不要只看連線按鈕或系統匣圖示。

查看各平台設定說明 →
故障排除

更新失敗、逾時與網路復原

先保留錯誤訊息,再進行比對測試。能否匯入訂閱與能否連上伺服器,可能走的是兩條不同的網路路徑。

v2rayN 訂閱更新失敗,如何分辨是網址問題還是網路問題?

先查看更新提示:名稱解析失敗通常與 DNS 有關;連線逾時通常指向連至訂閱伺服器的網路路徑;401 或 403 可能與權限、權杖或存取限制有關;解析失敗則可能是回應格式不符。這些資訊只能做為線索,不能直接當成結論。如果訂閱只能透過代理存取,需先建立可用的連線,再嘗試用戶端提供的代理更新方式。不要依賴尚未取得的設定來更新設定;網址失效時,應向提供者索取有效網址。

節點測試顯示逾時,就代表伺服器失效了嗎?

不一定。測試方法、測試目標與實際應用程式的請求可能不同;逾時也可能發生在本機 DNS、網路出口或測試網站。先核對伺服器位址與連接埠,再用相同設定開啟已知可用的網頁,同時查看記錄中是否出現連線逾時、驗證失敗或交握錯誤。只有某個項目異常時,可與同一訂閱中的其他項目比較;所有項目都異常時,優先檢查本機網路、系統時間與核心啟動狀態,不要只憑測試結果刪除所有設定。

用戶端顯示已連線,但所有網頁都打不開,該先做哪些檢查?

顯示已連線可能只代表本機服務或 VPN 介面已啟動,不表示遠端請求成功。先暫時關閉代理,確認原本的網路可正常使用;再重新啟用代理,檢查使用中的伺服器、流量入口與記錄。如果原本的網路正常,但所有代理請求都失敗,請依序檢查本機監聽、遠端連線、驗證與 DNS。若記錄中沒有目標網站的請求,先確認應用程式是否已被接管;若已有請求且顯示明確錯誤,再處理對應環節,避免同時修改連接埠、DNS 與路由。

記錄出現 TLS 交握失敗或憑證時間錯誤,該怎麼處理?

先檢查裝置的日期、時間與時區,啟用可靠的自動校時,再確認伺服器要求的網域、SNI 與傳輸參數。憑證過期、網域不符、中間網路干擾,或用戶端不支援相關設定,都可能導致交握失敗。不要把略過憑證驗證當成日常解決方式,這會降低身分驗證的安全性。若參數來自訂閱,先重新取得有效設定;錯誤仍然存在時,向伺服器維護者提供已隱藏敏感資訊的錯誤訊息與發生時間。

關閉用戶端後仍無法上網,如何還原網路設定?

先檢查系統是否仍指向已停止的本機代理連接埠。如果能重新開啟用戶端,可先執行清除系統代理,再正常退出;若無法開啟,請在作業系統的網路設定中關閉殘留的手動代理。若之前啟用了 TUN,也要確認相關連線已停止,並檢查是否有其他 VPN 接管網路。不要立刻重設整台裝置的所有網路設定,先記錄目前狀態,再逐項還原。退出前先停止流量接管,有助於避免再次遇到相同問題。

依錯誤類型查看記錄 →