v2rayN 常見問題

v2rayN 是桌面圖形用戶端，負責訂閱群組、伺服器選擇、系統代理與路由設定；實際建立連線的是它啟動的代理核心。v2rayNG 與 v2flyNG 適用於 Android，主要技術路線分別採用 Xray 與 V2Fly 核心。Project V 是認識這套生態的起點；用戶端名稱相近，不代表設定檔可以直接互換。排查問題時，應分別記錄用戶端版本、實際執行的核心及使用的協定。確認用戶端已開啟，並不代表核心已成功啟動，也不代表應用程式流量已進入代理。

Windows 使用者可選擇 v2rayN 桌面版或經典 WPF 版；macOS 與 Linux 則使用跨平台桌面版。桌面版採用 Avalonia 介面，WPF 版使用 Windows 介面技術，兩者的系統匣行為、選單位置及部分系統整合可能不同。先依作業系統與處理器架構選擇套件，再根據既有設定與使用習慣挑選介面版本。切換前請先備份用戶端設定，也不要將兩個版本解壓縮到同一個資料夾後覆蓋執行。若只有某個版本發生問題，請記錄實際使用的介面版本與操作步驟，不要直接判定訂閱或伺服器已失效。

先查看裝置的處理器架構或系統提供的裝置資訊。使用支援相應執行環境的 64 位元 ARM 裝置時，通常選擇 arm64 套件；無法確認架構時，可試用包含多種架構元件的 universal 通用套件，但檔案通常較大。不能只憑購買年份判斷；處理器支援 64 位元，也不代表系統一定提供相同的應用程式執行環境。若安裝時提示不相容，請核對系統需求；若提示簽章衝突，先備份設定，再確認已安裝應用程式的來源與簽章。不要將所有安裝失敗都歸因於架構選擇。

訂閱網址用來取得一組伺服器設定，之後也可能更新內容；單一伺服器連結通常只描述一組連線設定；完整設定檔則可能包含入站、出站、路由與 DNS 等設定。三者的匯入入口並不相同，若把訂閱網址當成單一伺服器連結匯入，可能會無法辨識或顯示空白清單。訂閱網址也不等同於可直接瀏覽的網站，瀏覽器顯示的頁面無法單獨證明內容符合用戶端要求。這類網址通常包含存取憑證，提交截圖或記錄前請遮蔽完整網址與身分資訊，避免公開分享。

先確認輸入的是訂閱網址還是單一伺服器連結。訂閱網址應填入訂閱群組的網址欄位，再執行該群組的更新；單一連結則使用相應的連結匯入功能。檢查複製內容是否包含空格、換行、聊天軟體附加文字，或缺少必要參數。若更新請求成功但清單仍是空白，請查看用戶端記錄是否指出內容格式無法解析，並確認服務提供者沒有回傳登入頁面、到期通知或錯誤頁面。不要反覆刪除所有伺服器來測試；先保留現有群組，另外建立測試群組，核對來源與回傳內容。

自動設定系統代理只會修改系統提供給應用程式讀取的代理設定，不保證所有程式都會使用。先確認代理核心已啟動、本機監聽連接埠正常，再檢查系統代理的位址與連接埠是否和用戶端一致。瀏覽器擴充功能、個別代理選項、企業政策或其他代理程式都可能覆寫系統設定；修改後可關閉並重新開啟瀏覽器測試。比較一個確定會讀取系統代理的應用程式與發生問題的程式，有助於判斷是入口故障還是程式行為不同。若確實需要接管不讀取系統代理的程式，再考慮使用 TUN，而不是先改成全域路由。

TUN 需要建立虛擬網路介面並調整路由，通常需要管理員授權或平台相應的權限提升流程。先關閉重複執行的用戶端，再依目前平台的要求授權啟動，並查看記錄中的第一個錯誤。權限不足、介面建立失敗與路由寫入失敗是不同環節，反覆點選開關無法解決所有問題。若裝置受組織政策管理，請遵守裝置管理規範，不要嘗試繞過限制。同時檢查是否有其他虛擬網卡或 VPN 正在使用路由。排查期間先關閉 TUN，確認系統代理可正常運作，再逐項恢復虛擬網卡接管與 DNS 設定。

匯入後先確認目標群組中有可辨識的伺服器項目，再選擇其中一項作為目前使用的伺服器，並確認核心已成功啟動。接著選擇需要的系統代理模式，使用確實會讀取該入口的應用程式開啟測試頁面，並查看相應的存取記錄或路由記錄。伺服器清單出現項目只代表設定已儲存；測試有回應，也不代表所有應用程式都能正常連線。驗證時一次只變更一個條件，例如維持伺服器不變，只切換系統代理設定。如此可分別確認設定解析、伺服器連線、流量入口與路由比對，避免同時修改多項設定後無從判斷。

系統代理決定應用程式是否將流量交給本機代理入口；路由規則則決定流量進入核心後使用哪個出站。自動設定系統代理不會讓所有目的地自動走代理，全域路由也不會接管忽略系統代理的應用程式。使用繞過中國大陸等預設時，也要了解網域、位址與規則資料庫的比對條件。若特定網站的連線路徑不符合預期，先確認流量是否進入核心，再查看比對到的規則與出站標籤。排查時可以暫時調整預設，但請記錄原設定並於測試後還原；若需要長期例外，新增範圍明確的規則，比長期使用寬泛規則更容易維護。

在訂閱群組設定中確認已啟用更新，並依欄位說明填寫自動更新間隔，注意單位是分鐘。更新頻率應參考訂閱服務提供者的要求；頻率過高可能觸發請求限制，也會增加排查時的干擾。透過代理更新適用於無法直接連線至訂閱服務、但已有可用代理的情況，前提是目前使用的伺服器與代理核心均正常運作。若所有伺服器都失效，而訂閱更新又依賴這些伺服器，就會形成更新依賴；此時應先恢復直接連線，或使用現有的可用設定。設定完成後手動更新一次，確認記錄正常，再觀察後續自動更新是否觸發。

先查看記錄，確認問題是解析失敗、連線失敗，還是請求已送往不符合預期的出站。應用程式自己的安全 DNS、系統 DNS 與核心 DNS 可能走不同路徑，修改其中一處未必會影響其他兩處。使用 TUN 時，也要確認 DNS 請求是否已被接管，以及是否出現解析請求再次進入自身入口的循環。若規則是依位址比對，解析結果也會影響路由選擇。每次只調整一項解析設定，並重新建立應用程式連線後再測試；不要同時更換所有解析器與路由規則。直接使用位址連線也可能導致憑證名稱比對失敗，因此不能把這種測試當成最終修正方式。

優先使用目前用戶端提供的備份或匯出功能，保留訂閱群組、手動新增的伺服器、自訂路由與必要參數設定，並記錄原用戶端及核心資訊。匯出檔可能包含訂閱憑證與伺服器驗證資訊，請存放在安全位置，避免上傳至公開雲端硬碟或分享連結。遷移至不同平台或用戶端時，不要假設整個資料夾可以直接覆蓋；請先確認匯入格式與欄位相容性。還原後逐項確認本機連接埠、系統代理、TUN 與自訂路徑，尤其不要沿用舊系統的絕對路徑。新環境驗證完成前請保留原備份，以便回復。

逾時只表示目前測試未能在限定時間內完成，不能單憑這點判定伺服器永久失效。先確認用戶端採用的測試方式與測試位址，再檢查本機網路是否正常、系統時間是否準確、伺服器網域能否解析，以及協定參數是否完整。交握失敗、目標無法連線與測試網站無法連線可能呈現相似狀況，應搭配核心記錄判斷。維持網路不變，改用另一組已知可用的設定作比較；也可以維持設定不變，改用其他網路重新測試。若多組設定同時失敗，應優先排查本機入口、網路與核心啟動狀態，而不是逐一刪除伺服器或頻繁重新安裝用戶端。

用戶端的執行狀態、測試請求成功與應用程式實際連線，是三個不同層面。先確認發生問題的應用程式是否使用系統代理，或已由 TUN 接管，再檢查目前使用的伺服器與路由出站是否正確。若只有網域無法連線，請優先檢查 DNS；若只有部分網站異常，則查看規則比對結果、連線記錄與目標服務本身的狀態。也要排除代理擴充功能、舊的手動代理設定及安全軟體造成的干擾。測試時可用一般瀏覽器視窗與另一個應用程式交叉驗證，並重新建立連線，避免舊連線沿用原本路徑。不要只憑狀態圖示判斷整條連線正常，也不要把全域路由當成所有故障的通用解法。

先查看更新記錄，區分網址失效、名稱解析失敗、連線逾時、憑證錯誤與伺服器拒絕請求。若出現憑證錯誤，先檢查裝置日期、時區及系統信任憑證是否正常，再核對訂閱網域；不要將關閉憑證驗證當成一般解決方式。若收到請求限制，請停止連續手動重試，並依服務提供者要求延長更新間隔。網址過期或回傳驗證錯誤時，需確認訂閱有效期限與存取憑證；重新安裝用戶端通常無法解決這些問題。記錄問題時保留錯誤類型與發生環節即可，提交給支援人員前請遮蔽完整訂閱網址及可能包含的驗證參數。

先檢查系統是否仍指向已停止監聽的本機代理連接埠，必要時透過系統設定還原原本的網路代理設定。使用 TUN 時，請依用戶端的正常流程停止虛擬網卡接管，再退出程式，避免直接結束程序後留下尚未還原的網路狀態。多個代理或 VPN 同時執行時，可能分別修改系統代理、預設路由與 DNS；排查時只保留一個接管者。若連接埠遭占用，先確認是哪個程式占用再處理，不要任意結束系統程序。恢復基本連線後逐一啟用功能，觀察哪個步驟會重現問題；遠端操作裝置時，調整路由前應先準備可用的復原方式。