常見問題設定與連線排查

V2Ray 屬於 Project V 代理生態系，V2Fly 延續相關核心的維護；Xray 則是同一技術生態系中的另一條核心發展路線。v2rayN 是圖形化用戶端，負責管理伺服器、產生設定並啟動選用的核心。排查時，先釐清是介面操作失敗還是核心啟動失敗：訂閱清單為空，應檢查訂閱回傳內容；服務啟動時出錯，則查看記錄中的核心、設定與連接埠資訊。不要只憑用戶端名稱判斷某種協定組合是否可運作，還要確認實際使用的核心及伺服器端要求。

桌面裝置建議優先選用 v2rayN，下載時依 Windows、macOS 或 Linux，以及處理器架構選擇相符的安裝套件。Windows 也可選擇跨平台桌面介面或傳統 WPF 介面，兩者的選單位置與執行需求可能不同。Android 裝置建議使用採用 Xray 核心的 v2rayNG；需要 V2Fly 核心環境時，再考慮 v2flyNG。更換用戶端前，請先備份訂閱網址與自訂規則，並確認新用戶端支援節點使用的協定與傳輸組合；不要直接覆蓋原有設定資料夾。

用戶端提供本機設定與連線功能，但安裝完成不代表已經有可連線的遠端伺服器。訂閱網址可用來取得一組節點設定，單一節點連結通常只包含一台伺服器的連線參數。兩者都應來自可信來源，並受相關服務的有效期限、流量配額與使用規範限制。請在訂閱群組設定中填入訂閱網址，不要把服務商的帳戶頁面網址當成訂閱連結。網址中的存取參數應視為憑證妥善保管，分享截圖、尋求協助或提供記錄前都要先遮蔽。

系統代理會為遵循系統設定的應用程式提供本機代理入口；路由分流則決定進入核心的連線要走代理、直接連線或封鎖；TUN 透過虛擬網路介面接收更多應用程式的流量。三者作用於不同環節，設定系統代理不代表所有應用程式都會進入核心；選擇全域路由也無法強制接管未使用代理的程式。初次設定時，建議先用系統代理確認瀏覽器連線正常，再調整路由，最後視需要啟用 TUN。每次只修改一項，較容易找出問題所在。

先將壓縮檔完整解壓縮到目前帳戶可寫入的獨立資料夾，再從解壓縮後的資料夾執行 v2rayN.exe；不要直接在壓縮軟體的預覽視窗中啟動。確認安裝套件符合作業系統與處理器架構；若錯誤訊息明確指出缺少執行環境，請依目前版本說明安裝相應的相依元件，不要任意安裝無關元件。接著檢查安全軟體的隔離紀錄及資料夾寫入權限。仍無法啟動時，記下完整錯誤訊息、作業系統版本與介面版本，保留原資料夾以利查明原因，避免反覆覆蓋安裝。

較新的主流 Android 裝置通常適用 arm64，但最終仍應以裝置處理器及系統支援的應用程式架構為準，不能只看購買年份。確認系統支援 arm64 時，選擇相應安裝套件；無法確認或出現架構不相容提示時，可改試包含多種架構的 universal 套件。若安裝時顯示應用程式未安裝，也要檢查剩餘儲存空間、系統版本需求，以及舊版簽章是否相容。不要直接解除安裝仍有設定的用戶端，先匯出可還原的設定，再決定是否重新安裝。

先確認取得的是訂閱網址、單一節點連結，還是只能用來登入的網頁網址。訂閱網址應填入訂閱群組設定，儲存後再更新該群組的訂閱；單一節點連結則使用從剪貼簿匯入等相應功能。掃描 QR Code 後沒有結果，常見原因包括 QR Code 內容是網頁、連結遭截斷，或目前用戶端不支援該格式。請重新複製原始文字，移除前後空格與換行後，再查看匯入提示。不要將私人訂閱交給不熟悉的線上轉換網站，以免網址外洩。

先關閉 TUN，確認一般系統代理可正常連線，再處理虛擬介面問題。Windows 請依用戶端提示，以所需權限啟動；macOS 與 Linux 則確認目前版本要求的提權方式或服務設定。查看記錄，分辨問題是權限不足、介面建立失敗、路由寫入失敗，還是 DNS 設定失敗；不要把所有啟動錯誤都歸咎於節點。暫時關閉其他虛擬網卡或隧道工具後再試。啟用後若網路異常，先關閉 TUN 並確認網路恢復，再依具體錯誤調整，避免同時變更多組路由參數。

先在伺服器清單選好目前使用的伺服器，確認核心已啟動，再從主介面或系統匣選單的系統代理功能中選擇自動設定系統代理。接著確認作業系統的代理位址與連接埠，是否符合用戶端目前的監聽值，並重新開啟測試用的應用程式。部分瀏覽器擴充功能、應用程式的個別代理設定或其他代理工具可能覆蓋系統設定，請暫時關閉後再測試。若只有某個應用程式無法使用，先確認它是否遵循系統代理；若否，需設定該應用程式自己的代理，或等一般連線正常後再考慮啟用 TUN。

在訂閱群組設定中為每個來源建立獨立群組，使用容易辨認來源與用途的備註，再分別填入對應的訂閱網址。第一次更新建議逐一更新群組，確認各組回傳正常後，再更新所有訂閱。尋找伺服器時先切換群組，再依備註關鍵字篩選；篩選只會改變顯示範圍，不代表刪除伺服器。手動新增的節點應與訂閱管理的項目分開保存，更新前先確認用戶端如何處理舊項目。網址失效時先修改原有群組，不要重複建立多個同名群組。

日常使用時，可在路由設定中依需求選擇繞過中國大陸規則，讓符合規則的目標直接連線，其餘流量則依規則處理。若要確認故障是否由分流造成，可暫時切換至全域代理路由，使用同一台伺服器連線至同一目標進行比較，測試完成後再恢復原規則。請注意，全域路由只會影響進入代理核心的流量，不會自動接管所有應用程式。自訂規則的比對順序、網域判斷方式與規則資料都會影響結果；修改前請先保存現有規則，每次只調整一項條件。

先退出用戶端並確認相關程序已結束，再備份設定資料夾或使用目前版本提供的匯出功能。請特別保存訂閱群組、手動新增的節點、自訂路由、DNS 設定與本機監聽連接埠；訂閱網址也應存放在受保護的位置。升級前先閱讀目前版本的移轉說明，尤其是切換介面版本或跨越較大版本升級時，不要預設舊設定可以直接覆蓋。更新後依序確認服務啟動、單一節點連線、訂閱更新與日常應用程式都正常，穩定後再清理舊資料夾與備份。

先確認訂閱是否已到期、網址是否已重設，以及複製時是否漏掉查詢參數。接著查看更新記錄，分辨是連線失敗、憑證錯誤、回傳內容為空，還是格式無法解析。如果目前的代理本身無法使用，請依用戶端提供的更新選項，嘗試不經代理取得訂閱；必要時改用其他正常網路測試。若回傳的是登入頁面、驗證頁面或錯誤頁面，就不是有效的訂閱內容，重新匯入也無法解決。先保留現有伺服器清單，確認回傳內容與服務狀態後，再決定是否清空並重建群組。

測試逾時只表示目前的測試流程未能在時限內完成，不能單憑這點認定所有連線都無法使用。先確認裝置本身可以連上網路，再檢查目前使用的伺服器、系統時間與節點有效期限。TCP 測試與實際透過代理瀏覽網頁的測試涵蓋範圍不同，應搭配實際連線結果及核心記錄判斷。可在相同網路測試另一個已知可用的節點，或在不同網路測試原節點，以縮小問題範圍。若記錄顯示驗證或交握錯誤，應優先核對節點參數與核心支援情況，不要只是不斷延長逾時時間。

顯示正在執行通常只代表本機服務已啟動，不表示遠端連線也已成功。先關閉代理，確認基本網路正常，再重新啟用代理並檢查目前使用的伺服器、系統代理位址與監聽連接埠。若所有網站都無法連線，請查看核心記錄是否有連線或驗證錯誤；若只有部分網域無法使用，再檢查路由規則、DNS 解析與瀏覽器的安全 DNS 設定。暫時停用瀏覽器代理擴充功能，並用另一個瀏覽器交叉測試，不要一次重設所有設定。若同時啟用了 TUN 與系統代理，可先關閉 TUN，縮短排查流程。

先從記錄確認發生衝突的監聽連接埠，不要預設一定是 10808。Windows 可在終端機執行 netstat -ano，查看監聽項目及對應的程序編號，再到工作管理員確認程序名稱；若發現舊版用戶端重複執行，先正常退出，不要直接結束不熟悉的系統程序。也可以到設定中的參數設定，找到相應的本機監聽項目，改用未占用的連接埠後重新啟動服務。修改後請重新設定系統代理，並同步調整瀏覽器擴充功能與手動設定代理的應用程式；連接埠相同不代表 HTTP 與 SOCKS 協定可以互換。