V2Ray 用戶端常見問題

Windows、macOS 與 Linux 桌面版可使用 v2rayN；Android 優先選用採用 Xray 核心的 v2rayNG，需要 V2Fly 核心設定時再考慮 v2flyNG。先確認作業系統，再確認訂閱所需的協定與核心功能。用戶端名稱相近，不代表設定完全相同，桌面版的系統代理步驟不能直接套用到 Android。若現有設定需要 REALITY 等功能，請確認目前核心是否支援；各版本差異可參考選型指南。

用戶端負責管理設定並啟動代理核心，本身不會提供可連線的伺服器。訂閱是設定提供者提供的網址，用戶端讀取後才會產生可選用的設定項目；也可以匯入單筆分享連結或完整設定檔。先確認設定來源與有效期限，再依格式匯入，別把一般介紹網頁當成訂閱網址。訂閱連結可能含有存取憑證，請勿公開貼在截圖、留言區或不熟悉的轉換網站。

系統代理會將代理位址寫入桌面系統設定，通常適用於會讀取這些設定的瀏覽器與應用程式，但不會接管所有程式。TUN 透過虛擬網路介面接收流量，涵蓋範圍較廣，也涉及系統管理員權限、路由與 DNS 設定。Android 用戶端通常透過系統 VPN 介面接收裝置流量，不必另外安裝桌面版 TUN 驅動程式。先選擇符合需求的連線方式，再設定分流，避免同時啟用多個會接管網路的工具。

不一定。全域通常是指已進入核心的流量要如何選擇出口，並不保證所有應用程式的流量都已進入核心。只啟用系統代理時，忽略系統代理設定的程式仍可能直接連網；啟用 TUN 後，也要檢查排除的應用程式、略過的網段與路由規則。排查時分成兩步：先確認目標應用程式的請求是否到達用戶端，再確認請求符合哪個出口規則。別只看模式名稱就判斷流量路徑，請以目前用戶端的記錄與規則為準。

多數較新的 Android 裝置採用 arm64 架構，確認系統支援後即可選擇 arm64 套件；不確定架構時，可先查看裝置規格，或選擇包含多種架構元件的 universal 通用套件。處理器支援 64 位元，不代表系統執行環境也一定支援，不能只看裝置購買年份判斷。若無法安裝，也要檢查系統版本需求、儲存空間、安裝權限，以及是否與既有應用程式的簽章衝突；通用套件只能解決部分架構相容問題，無法略過系統需求。

先確認要匯入的是單筆分享連結、訂閱網址還是設定檔。訂閱網址應新增至訂閱設定，儲存後再執行更新；從剪貼簿匯入通常適用於支援的分享內容，無法保證任意網頁網址都會被辨識為訂閱。檢查複製的內容是否含空格、換行、引號或聊天軟體附加文字，再確認網址仍有效。若開啟後顯示登入頁面或錯誤訊息，重複點選匯入也無法解決問題，請向設定提供者確認正確網址與用戶端格式。

桌面版採用跨平台介面，適合希望在不同桌面作業系統上使用相近操作方式的使用者；WPF 版採用經典 Windows 介面，適合熟悉其選單配置的使用者。兩者的執行環境需求與設定位置可能不同，請依下載頁面的說明選擇，別只憑檔名判斷。初次使用建議先安裝其中一個版本，完成訂閱匯入與連線測試。需要遷移時，先備份設定，再使用用戶端支援的匯入方式，避免覆寫正在使用的資料目錄。

先關閉 TUN，確認一般代理模式可以啟動，再根據記錄判斷是權限、服務還是驅動程式問題。Windows 通常需要系統管理員權限，或正確安裝相關服務；macOS 與 Linux 則須依用戶端提示完成授權或輔助元件設定，實際流程會隨版本變動。檢查是否有其他 VPN、虛擬網卡工具或安全軟體造成攔截，別反覆安裝來源不明的驅動程式。Android 若顯示 VPN 授權失敗，請處理系統授權，並確認沒有其他應用程式占用 VPN 連線。

依設定來源建立訂閱群組，並為各群組設定容易辨識用途的名稱，別將多個來源反覆匯入同一群組。訂閱更新可能會取代群組中的項目，因此長期使用的手動設定應另外保存；手動修改是否會保留，則以目前用戶端的行為為準。更新前先確認選取的群組與網址，更新後再檢查目前使用的設定是否仍在。刪除重複群組前，先備份設定並確認需要的路由、備註與手動新增內容是否都已保留。

先確認設定提供者是否已提供目標用戶端可讀取的格式，若能直接匯入，通常不必轉換。確實需要轉換時，請確認來源格式與目標格式都能表達協定、傳輸方式、安全參數及相關擴充設定；轉換成功不代表所有欄位都完整。轉換後先測試單筆設定，再批次使用。別將含有存取憑證的訂閱連結交給不熟悉的線上服務，也別為了匯入而任意刪除無法辨識的欄位；請先確認是否需要更新用戶端與核心。

日常使用桌面瀏覽器，可先從系統代理開始：選擇有效設定、啟動核心，再開啟自動設定系統代理，並確認瀏覽器會使用系統設定。只有需要讓不讀取系統代理的應用程式連線，或確實有網路接管需求時，再評估 TUN。測試時一次只調整一個選項，記錄修改前後的狀況。系統代理與 TUN 不必同時啟用，兩者疊加反而可能增加排查難度；Android 則依用戶端流程啟用 VPN 連線。

先開啟用戶端的執行記錄或核心記錄，記下問題發生時間，再重現一次失敗操作，查看相關錯誤及其前後幾行。分享記錄前，應遮蔽完整訂閱網址、使用者識別資訊、密碼、權杖及其他可重複使用的憑證，也可視情況隱藏伺服器位址。保留錯誤類型、欄位名稱與操作順序，才有助於找出問題。只有必要時才短暫提高記錄詳細程度，排查結束後恢復常用層級，避免長期記錄過多瀏覽細節；請勿直接公開整份設定檔。

舊設定仍可使用，只代表已儲存的伺服器參數還能連線，不代表訂閱介面正常。先確認訂閱網址是否過期或已重設，再檢查更新請求回傳的是逾時、憑證錯誤還是拒絕存取。若用戶端提供透過代理更新訂閱的選項，可在現有設定仍可用時，嘗試切換更新路徑，避免依賴尚未更新取得的設定。別急著刪除仍可使用的群組；先備份，再確認系統時間、基本網路與訂閱提供者的介面狀態。

不能只憑一次測試就下結論。先確認測試類型：有些只檢查連接埠是否可連線，有些會實際發出代理請求，失敗原因並不相同。檢查裝置時間、伺服器位址、連接埠、協定及傳輸安全參數，尤其別將某個核心支援的設定交給不支援該設定的核心。接著改用另一筆已知有效的設定，或換一種網路交叉測試。如果所有設定都失敗，優先檢查本機權限、防火牆與網路；若只有部分設定失敗，再聯絡設定提供者。

先確認核心確實正在執行，且沒有啟動錯誤，再檢查流量接入方式：桌面系統代理是否指向目前的監聽連接埠，Android 是否已取得 VPN 授權。接著查看記錄，確認存取時是否出現請求；若沒有，先檢查瀏覽器的獨立代理、應用程式排除設定或其他代理工具。請求已進入核心時，再檢查 DNS、路由出口與設定是否有效。每次只調整一項並重複測試，別一次重設所有設定；詳細步驟請參閱連線問題排查清單。

先確認系統代理中的位址與連接埠是否和用戶端目前的監聽設定一致，並檢查瀏覽器是否另設代理或受到擴充功能接管。若核心顯示 address already in use，表示監聽連接埠已被其他程序或另一個用戶端執行個體占用，應先關閉重複執行的程式；若確實需要變更連接埠，也要同步修改所有手動指定該連接埠的應用程式。確認核心成功啟動後，再測試系統代理。關閉用戶端前，先清除其設定的系統代理，可避免程式結束後瀏覽器仍連到舊連接埠。