客戶端問題清單

v2rayN/v2rayNG
設定與連線疑難排解

先找到問題類別,再展開檢查步驟。每次只修改一項設定,確認結果後再進行下一步。

初次設定可先閱讀使用指南;若要了解路由、DNS 與 TUN 的完整學習順序,請查看系統教學。

基礎認識

分清客戶端、訂閱與流量入口,避免在錯誤的設定層反覆嘗試。

v2rayN、v2rayNG 和 v2flyNG 該怎麼選?

先依裝置選擇客戶端。Windows、macOS 和 Linux 可使用 v2rayN;Windows 下載時,再區分桌面版與經典 WPF 版。Android 使用者可先了解採用 Xray 核心的 v2rayNG;需要 V2Fly 核心時,再考慮 v2flyNG。客戶端介面與核心屬於不同層次,不能光看名稱就判斷一定支援某種協定。匯入前請確認服務設定需求,並核對目前客戶端與核心的支援狀況。三款客戶端都需要可用的設定檔,安裝完成不代表已具備連線條件。

訂閱網址、節點分享連結與客戶端有什麼不同?

客戶端是讀取設定並管理連線的工具。訂閱網址通常用來取得一組設定,需先儲存至訂閱群組,再執行更新;節點分享連結通常包含單一連線設定,應使用從剪貼簿匯入或掃描 QR Code 等功能。不要把服務商的帳戶頁面網址當成訂閱網址,也不要將多個分享連結直接貼到訂閱網址欄位。訂閱網址可能包含帳戶識別資訊,排查時只描述格式與錯誤訊息,公開截圖請勿顯示完整內容。

系統代理、路由規則與 TUN 各自控制什麼?

先分清流量入口與出口選擇。系統代理會將代理位址寫入作業系統設定,只有遵循這項設定的應用程式才會使用;TUN 則透過虛擬網卡接收符合接管條件的流量,接管範圍也會受到路由、排除項目與系統環境影響。路由規則則決定進入核心的連線要走直連、代理或其他指定出口。啟用 TUN 不代表所有連線都一定走代理,選擇繞過中國大陸也不代表所有應用程式都會進入核心。初次設定時,先驗證一種流量入口,再檢查路由結果。

訂閱匯入成功,就代表裡面的所有協定都能使用嗎?

不能只看匯入結果。訂閱解析成功,只表示客戶端讀取到可辨識的內容,不代表目前的核心支援每個項目的所有參數。VMess、VLESS、Trojan 是協定名稱,REALITY 則是與連線安全相關的設定;傳輸方式與安全參數也需要分別符合要求。部分項目無法啟動時,先查看記錄中的不支援欄位或參數錯誤,再確認所選核心與客戶端是否為最新版。請保留服務設定的原始值,不要只憑協定名稱猜測連接埠、傳輸路徑或伺服器名稱。

安裝設定

依序檢查安裝套件、訂閱入口與執行權限。不同平台的授權方式不可混用。

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

先查看裝置的處理器架構或系統說明。多數較新的 Android 手機可選 arm64 套件,但處理器支援 64 位元,不代表系統也提供相應的執行環境,不能只依購買年份判斷。不確定架構時,可選擇容量通常較大的 universal 通用套件。若安裝時顯示裝置不相容,先核對系統需求與套件架構;若提示與現有應用程式衝突,請確認是否為同一款客戶端,以及簽章是否一致。解除安裝可能影響本機設定,請先透過客戶端的備份功能保存所需內容。

v2rayN 新增訂閱網址後,為什麼清單還是空的?

開啟訂閱群組設定,確認網址已儲存且該群組已啟用。返回主畫面,在訂閱群組選單執行「更新全部訂閱(不透過代理)」,接著切換至該群組查看結果。新增網址只是儲存來源,不代表設定已成功下載。若記錄顯示取得成功但沒有項目,請確認網址回傳的是訂閱內容還是登入頁面,並確認內容格式可供目前客戶端辨識。不要連續重複新增相同網址;先保留一個群組,分別排查取得失敗與解析失敗。

v2rayNG 從剪貼簿匯入失敗,該檢查哪些地方?

先確認剪貼簿裡是完整的節點分享連結,而不是介紹文字、網頁標題或帶有額外標點的片段。複製時請勿漏掉協定前綴,也不要手動修改編碼後的內容。如果拿到的是訂閱網址,請開啟訂閱群組設定、新增群組並儲存網址,再執行更新訂閱,不要反覆使用節點匯入功能。QR Code 無法辨識時,請確認圖片清晰且完整。仍無法匯入的話,再核對客戶端支援的格式與服務提供者的匯入說明;請勿將訂閱內容上傳至陌生的轉換網站。

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

先關閉 Tun,查看記錄確認問題發生在權限、虛擬網卡還是路由設定階段。Windows 使用者可先結束客戶端,再依目前版本的要求以系統管理員身分重新執行,然後啟用 Tun;macOS 和 Linux 的授權及輔助服務要求不同,請依各平台提示完成,不要照搬 Windows 的步驟。若首次授權遭系統封鎖,先核對應用程式來源與提示內容。若已有權限仍無法啟用,請檢查是否有其他 VPN 或虛擬網卡工具同時接管網路,逐一退出後再試,不要直接刪除系統網卡。

使用技巧

依網路條件選擇更新方式,在各裝置分別維護設定,升級前先備份。

更新訂閱時,該透過代理還是不透過代理?

依訂閱網址目前能否直接連線來選擇,不要將某一種方式視為通用答案。初次設定且尚無可用連線時,可先試著不透過代理更新;若網址只能透過現有代理存取,請先確認目前設定可用,再選擇透過代理更新。更新失敗時,記下狀態碼與錯誤類型,區分網址失效、登入失效、解析失敗與網路逾時。客戶端更新訂閱只是重新取得內容,不會延長帳戶效期,也不能取代服務提供者對流量額度與有效期限的管理。

繞過中國大陸與全域代理該怎麼選?切換後要檢查什麼?

依存取需求選擇路由模式。繞過中國大陸通常透過網域與位址規則,讓符合條件的中國大陸目標直連,其餘連線則依規則處理;全域代理通常會讓進入核心的連線優先走代理,但實際結果仍以目前規則為準。切換後請重新連線至目標,必要時關閉應用程式原有連線,避免舊連線沿用先前的路徑。結果不如預期時,檢查規則順序、規則資源與網域解析,不必急著更換節點。未受系統代理接管的應用程式,也不會因切換路由模式而自動使用代理。

電腦和手機共用訂閱,會同步所有設定嗎?

共用訂閱主要是讓各裝置分別取得同一來源的節點設定,不會自動同步客戶端的所有本機設定。v2rayN 和 v2rayNG 的系統代理、路由、DNS、TUN 或 VPN 模式都需要在各裝置上分別檢查;名稱相同的設定也可能有不同實作方式。節點 QR Code 或分享連結適合傳送單一項目,不等於完整備份。移轉前請確認目標客戶端支援備份格式,並保留舊裝置上的設定。也請查看服務提供者對裝置數量與同時連線數的限制,避免把更新成功誤認為可以不限裝置同時使用。

更新客戶端前,如何保留訂閱與本機設定?

先使用目前客戶端提供的備份或匯出功能,保存訂閱群組與所需的本機設定,並記下自訂路由、DNS 和代理入口設定。備份可能包含訂閱網址與連線憑證,請存放在安全的位置。跨客戶端、介面版本或平台還原前,先確認目標版本支援該格式,不要直接覆寫不明的設定資料夾。更新後先檢查群組是否保留,再選一個既有項目測試連線,最後還原自訂設定。若新版出現異常,請保留錯誤訊息與原始備份,避免反覆解除安裝而遺失排查線索。

故障排除

依序檢查基本網路、流量入口、遠端連線與路由解析,先找出失敗環節。

節點測試逾時,是節點失效還是本機問題?

先確認本機網路正常,再檢查系統時間是否正確。若只有一個項目測試逾時,可改測同一訂閱中的其他項目比較;若全部逾時,優先檢查本機網路、防火牆、核心是否啟動及訂閱是否仍有效。TCP 測試、實際連線測試與瀏覽器瀏覽驗證的內容並不相同,單一測試逾時不能證明所有應用程式都無法連線。查看記錄確認是網域解析失敗、連線遭拒還是交握失敗,再處理對應環節。不要只因一次逾時就批次刪除節點或修改所有協定參數。

客戶端顯示已連線,但瀏覽器無法上網,該怎麼辦?

先將「已連線」理解為本機服務或 VPN 已啟動,不要視為遠端連線正常的證明。確認目前項目已選取、核心正常啟動,再分別存取一個預期直連與一個預期走代理的目標。兩者都失敗時,檢查流量入口接管、DNS 與其他 VPN 衝突;只有代理目標失敗時,優先查看項目設定與出口記錄;只有特定網站失敗時,再檢查路由規則命中與網域解析。排查期間每次只修改一項設定,並重新存取目標;不要同時切換 DNS、路由與 TUN,才能判斷是哪一步造成變化。

v2rayN 已開啟系統代理,為什麼有些程式還是沒有走代理?

先在 v2rayN 的系統代理選單確認已選取「自動設定系統代理」,再檢查作業系統寫入的代理位址是否與目前本機監聽連接埠一致。部分應用程式使用自己的代理設定,或根本不讀取系統代理;此時應依實際監聽協定與連接埠,在應用程式內設定代理,或先了解接管範圍再使用 TUN。如果瀏覽器安裝了代理擴充功能,先確認它是否覆寫系統設定。關閉客戶端後仍無法上網時,檢查系統是否留有代理設定,將其還原為符合目前網路環境的狀態,再測試基本連線。

訂閱更新失敗時,如何分辨記錄中的逾時、驗證失敗與解析錯誤?

先依失敗階段分類。要求逾時表示未能在指定時間內取得回應,請檢查網址是否可連線,以及更新時使用的網路路徑;收到 401 或 403 等回應時,核對網址、帳戶狀態與服務提供者的限制,反覆重試無法解決驗證問題;要求成功但解析失敗時,檢查回傳內容是否為登入頁、錯誤頁或不支援的訂閱格式。複製網址時請保留完整查詢參數,並留意尾端空格。查看記錄與截圖前,先遮蔽訂閱網址、憑證及個人資料,再向設定提供者說明錯誤類型。

需要逐步圖文說明,請繼續閱讀使用指南;不確定協定或路由術語時,請查閱術語手冊。選擇安裝套件請前往客戶端下載頁。