V2Ray 用戶端
常見問題

V2Ray 屬於 Project V 代理工具生態系，V2Fly 延續其核心維護；Xray 則是同一技術生態系中的另一種核心實作。v2rayN 是圖形介面用戶端，負責管理伺服器、訂閱、路由及啟動核心。介面能開啟不代表核心已正常運作，排查連線前應先查看核心記錄。選擇協定時，也要確認目前的核心是否支援相應的傳輸與安全參數，不能只看用戶端名稱。

Windows、macOS 與 Linux 桌面版可優先考慮 v2rayN；Android 可優先考慮採用 Xray 核心的 v2rayNG，如需相容 V2Fly 設定再考慮 v2flyNG。選擇時應考量作業系統、處理器架構及伺服器設定，而非介面是否相似。同一份訂閱在不同用戶端解析欄位時可能有所差異，移轉後應檢查協定、傳輸方式、TLS 與路由，不要直接沿用舊的本機設定資料夾。

訂閱網址通常會回傳一組設定，加入後還需要更新；分享連結常以 vmess://、vless:// 或 trojan:// 開頭，通常描述單一伺服器設定；原生 JSON 則可能包含入站、出站、DNS 與路由等完整內容。三者不能任意使用同一個匯入入口。取得內容後先判斷格式，再選擇訂閱群組、從剪貼簿匯入或匯入設定檔；不要把訂閱網址當成伺服器位址填入。

系統代理會讓遵循系統代理設定的應用程式連到本機代理連接埠；路由分流則決定已進入核心的連線要走 direct、proxy 還是 block；TUN 透過虛擬網路介面接收流量，涵蓋範圍視平台與設定而定。三者位於不同環節。瀏覽器流量尚未進入用戶端時，修改 geosite 規則通常沒有作用；流量已進入用戶端卻走錯出站時，應檢查規則順序，而不是反覆切換系統代理。

VLESS 與 Trojan 是代理協定，REALITY 則是連線安全機制，不能把它們視為同一層級的三種互斥選項。設定必須符合伺服器端的協定、傳輸方式與安全選項；使用 REALITY 時，還要確認公鑰、serverName 與 shortId 等參數。不要只憑名稱手動更改協定，也不要直接把原有 TLS 設定改成 REALITY。建議先匯入服務提供者提供的完整連結，再逐項確認目前用戶端與核心的支援情況。

2015 年後推出的主流 Android 手機通常可優先考慮 arm64，但上市年份不能取代架構確認，仍應以裝置系統資訊和應用程式需求為準。universal 包含多種架構，適合不確定架構時嘗試，但檔案通常較大。若顯示無法安裝，也要檢查最低系統版本、剩餘空間，以及是否與已安裝應用程式的簽章衝突；不要把所有安裝失敗都歸因於架構。解除安裝舊應用程式前，請先備份仍需使用的設定。

桌面版採用新一代跨平台介面，經典 WPF 版則使用 Windows 桌面介面，兩者的選單位置與部分設定入口可能不同。Windows 使用者可依操作習慣和相容性需求選擇，不必同時執行兩個版本。首次移轉時，先匯出伺服器與路由設定，再於目標版本匯入並檢查本機連接埠；不要用新版資料檔直接覆蓋舊版資料夾，也不要讓兩個執行個體爭用同一個代理連接埠。

先確認複製的是完整訂閱網址，前後沒有空格、換行或通訊軟體附加的標點。在 v2rayN 中將網址加入訂閱群組後，還要執行更新訂閱；只儲存群組不會產生伺服器清單。若顯示不支援此格式，請確認回傳內容是否其實是登入頁、錯誤頁，或用戶端不支援的訂閱格式。分享連結應使用相應的剪貼簿匯入入口；不要靠手動修改編碼掩蓋網址失效的問題。

桌面版 TUN 需要建立或管理虛擬網路介面，可能需要系統管理員權限、安裝服務或取得系統授權，實際需求視用戶端版本與作業系統而定。Android 用戶端則透過系統 VPN 授權接收流量，請在系統確認視窗中允許。授權後仍無法使用時，請查看建立介面相關的記錄，並檢查是否有其他 VPN 程式正在使用。先確認一般系統代理能否正常運作，再啟用 TUN，可避免把伺服器設定問題與介面權限問題混為一談。

macOS 使用者可先在「關於這台 Mac」確認裝置採用 Apple Silicon 還是 Intel，再選擇相應的 arm64 或 x64 安裝項目。Linux 則需同時確認處理器架構與套件格式：Debian、Ubuntu 系統通常選 deb，Fedora 等系統通常選 rpm，再確認是 x64 或 arm64。安裝後無法啟動時，請查看系統相依套件與應用程式記錄；不要只靠重新命名副檔名來嘗試跨架構或跨套件管理工具安裝。

若要讓中國大陸網站直連、其他網站依規則使用代理，可先選用繞過中國大陸規則集；全域模式適合暫時判斷分流是否造成異常，但仍應確認實際規則如何處理私有位址等流量。切換模式後，請確認設定已重新載入，並用同一個網站再次測試。全域模式不代表所有程式都已接上代理：不遵循系統代理設定的應用程式仍可能直連，這時應先確認應用程式的代理設定或 TUN 是否已接入。

目前網路可直接連線至訂閱服務時，可選擇更新訂閱（不透過代理）；若直連失敗，且已有可用代理，再嘗試透過代理更新。兩種方式只會改變取得訂閱時的網路路徑，無法修復過期網址或伺服器回傳的錯誤內容。切換方式前，請記下記錄中的具體錯誤，例如解析失敗、連線逾時或 HTTP 狀態碼；不要短時間內頻繁重新整理，以免觸發訂閱服務的請求限制。

在路由設定中新增網域比對並選擇 direct 出站。例如，domain:example.com 會比對該網域及其子網域，full:example.com 則只比對完整網域。Xray 路由通常依規則由上而下比對，特定例外規則應放在可能先命中的廣泛規則之前。儲存並重新載入後，關閉既有連線再重新造訪，並查看存取記錄中的出站標籤。不要只靠網頁能否開啟來判斷規則是否命中，也不要把系統代理的略過清單當成核心路由表。

建議優先移轉訂閱網址或用戶端支援匯出的設定，再檢查目前的伺服器、路由規則與 DNS。系統代理、TUN 授權、開機啟動、本機連接埠及應用程式分流通常與裝置環境有關，需要在新裝置上重新確認。不同用戶端的完整備份不一定相容，能匯入分享連結也不代表能讀取彼此的資料庫。備份可能含有伺服器驗證資訊與私人訂閱網址，請存放在安全的位置，移轉完成後清除暫存副本。

如果程式結束後，系統仍指向已關閉的本機代理連接埠，瀏覽器就會繼續嘗試連線到該連接埠。在 v2rayN 中先執行清除系統代理，再正常結束程式；使用 TUN 時，也要確認虛擬介面和相關路由已還原。若用戶端已關閉，可到系統網路設定檢查手動代理。不要任意清除其他軟體或組織管理的代理設定；還原後重新啟動瀏覽器，並分別確認本機網路與一般網站是否連線正常。

先確認測試方式：TCP 連線成功只表示可連上目標連接埠，不代表協定交握或網頁請求成功；單一測試逾時也不能據此判定伺服器失效。檢查伺服器位址、連接埠、系統時間及目前網路，再核對協定、傳輸與安全參數。查看記錄是解析失敗、連線遭拒還是交握錯誤，必要時換個網路交叉測試。每次只修改一項並保留原有設定，避免同時改動多處而無法判斷原因。

顯示已連線通常只代表本機服務或 VPN 介面已啟動，不代表遠端連線成功。先檢查核心記錄是否正常啟動，再確認應用程式是否已接上系統代理或 VPN；瀏覽網頁時，觀察是否有請求記錄。沒有記錄，應優先檢查流量入口；有記錄但請求失敗，再檢查伺服器交握、DNS 和路由。先用單一瀏覽器和單一網站測試，暫時停用可能改寫代理設定的擴充功能，避免瀏覽器個別設定覆蓋系統設定。

先在狀態列選擇自動設定系統代理，並確認核心已成功啟動、本機監聽連接埠未被占用。接著開啟系統網路代理設定，確認位址與連接埠指向目前的執行個體。若設定值很快又被改回，請檢查其他代理軟體、瀏覽器擴充功能或裝置管理政策。部分應用程式不會讀取系統代理，需要在應用程式內個別設定或評估使用 TUN；遇到這類應用程式時，反覆切換路由模式無法解決流量尚未進入用戶端的問題。

保留目前可用的設定，先記下更新時的錯誤，再分別檢查網址是否過期、裝置時間是否正確、網域是否能解析，以及目前網路能否連線至訂閱服務。HTTP 401 或 403 應優先確認授權與服務狀態；逾時則著重檢查網路路徑；若回應成功但無法解析，應檢查內容格式。若已有可用伺服器，可比較直連與透過代理更新的結果，但不要公開完整訂閱網址，也不要因舊清單為空就認定必須重新安裝用戶端。

先在同一個網路和瀏覽器中比較正常與異常網站，再查看異常網域的解析錯誤及路由命中記錄。若暫時切換成全域規則後恢復，應檢查先命中的直連或封鎖規則；若記錄明確顯示網域解析失敗，則檢查用戶端 DNS 設定、瀏覽器安全 DNS，以及 TUN 接管 DNS 是否彼此影響。每次只調整一處，清除快取並建立新連線後再測試。網頁能開啟但部分資源載入失敗時，也要檢查資源網域，不能只看網址列中的主網域。