v2rayN 常見問題

v2rayN 是適用於 Windows、macOS 與 Linux 的圖形化用戶端，v2rayNG 則適用於 Android。用戶端負責管理訂閱、編輯設定及提供代理入口，實際連線則由核心處理。Xray 與 V2Fly 屬於相關的開源核心生態系，支援能力會隨版本而異。排查問題時，先記下用戶端名稱、核心名稱與錯誤訊息，不要只寫「V2Ray 不能用」。Android 上的 v2flyNG 是另一款採用 V2Fly 核心的用戶端，設定能否使用仍須核對具體協定與參數。

訂閱網址通常是網頁請求網址，用戶端存取後會取得一組設定，之後也能再次更新。單一分享連結通常以 vmess://、vless:// 或 trojan:// 等協定前綴開頭，用來匯入單一設定。將訂閱網址貼到單一設定的匯入欄位，可能會出現格式錯誤；將分享連結填入訂閱網址欄，也無法正常更新。先確認內容類型，再選擇訂閱群組或從剪貼簿匯入。訂閱網址可能含有存取憑證，請勿公開截圖或完整連結。

安裝用戶端只是準備好本機工具，還需要合法取得有效的伺服器設定或訂閱。匯入後，請核對協定、伺服器位址、連接埠與認證參數，再將設定設為目前使用項目。用戶端顯示已啟動，通常只代表本機核心或代理入口正在執行，不表示遠端連線及所有應用程式都已正常。首次設定建議先用支援系統代理的瀏覽器測試，再處理終端機、遊戲或其他應用程式。本網站提供使用說明，不提供訂閱網址或連線帳號。

REALITY 不是「全域」或「略過區域網路」這類代理模式，而是連線設定中的安全相關技術，常見於 VLESS 設定。是否使用 REALITY 取決於伺服器端方案，排查問題時不可任意改成 TLS。匯入後，請核對伺服器端要求的伺服器名稱、公開金鑰、短識別碼及其他參數；欄位名稱可能因用戶端版本而異。系統代理決定應用程式如何連入用戶端，路由則決定流量走哪個出口；兩者與 REALITY 參數屬於不同層面，應分開檢查。

優先依裝置支援的應用程式架構選擇。近年多數 Android 手機適用 arm64 套件，檔案通常比通用套件小；universal 套件包含多種架構，適合暫時無法確認架構時嘗試。不要只憑手機購買年份判斷，部分裝置的系統環境與晶片能力並不一致。如果出現不相容提示，可先查看系統或裝置說明中的架構資訊；通用套件仍無法安裝時，再確認 Android 版本、儲存空間及簽章衝突，不要反覆更換相同架構的套件。

在訂閱群組設定中新增群組，填寫容易辨識的備註，將完整訂閱網址貼到網址欄，儲存後執行更新目前訂閱。先確認複製內容沒有混入空格、換行、引號或說明文字，再確認網址仍然有效。如果複製的是單一分享連結，應改用從剪貼簿匯入伺服器的入口。Base64 是部分訂閱內容使用的編碼方式，不代表任何一段編碼文字都能貼進訂閱網址欄。選單文字可能有所不同，請以目前版本中相應的訂閱管理入口為準。

先確認下載的是適用於目前系統的用戶端版本，並將壓縮檔完整解壓縮到可寫入的資料夾，不要直接從壓縮檔預覽中執行。只有目前版本明確依賴外部執行階段，或錯誤訊息指出缺少執行環境時，才依照要求安裝相應架構的 .NET 桌面執行階段；不要把所有閃退都歸咎於執行階段。接著檢查安全軟體的封鎖紀錄、資料夾權限與啟動記錄。若懷疑設定損毀，請先備份，再用獨立的新資料夾測試，避免直接刪除原有訂閱與路由設定。

TUN 需要建立或設定虛擬網路介面；桌面版可能需要管理員授權、服務元件或系統網路權限，實際需求視平台與用戶端版本而定。先關閉其他會接管網路的工具，再依照用戶端提示完成授權，不要替整個安裝資料夾設定過寬的權限。Android 上請確認已授予系統 VPN 連線權限；若已有其他 VPN 連線，可能無法同時啟用。授權後仍然失敗，請查看記錄中的介面或路由錯誤。排查期間先關閉 TUN，使用一般本機代理確認遠端設定可用，再單獨處理 TUN。

要讓支援系統代理的應用程式使用用戶端時，請選擇「自動設定系統代理」。「清除系統代理」會移除用戶端設定的系統代理入口，常用於停用代理或排除殘留設定；「不變更系統代理」表示不主動修改現有系統設定，不等於所有流量都直接連線。系統代理只是應用程式連入用戶端的方式，不等於全域路由，也不會自動涵蓋所有程式。切換前請記下原有設定，尤其是裝置已設定機關或公司網路代理時。測試完成後，退出用戶端也應確認系統代理是否如預期還原。

不少命令列程式不會讀取桌面系統代理，而是使用自身的代理設定，或 http_proxy、https_proxy、all_proxy 等環境變數。先查閱程式文件，確認支援 HTTP 代理還是 SOCKS 代理，再填入用戶端目前啟用的本機監聽位址與相應連接埠。不要將 SOCKS 連接埠當成 HTTP 連接埠使用，也不要假設不同版本使用相同連接埠。測試時可先將變數限定在目前終端機工作階段，確認成功後再決定是否永久設定。若先前設定過代理，也要檢查舊變數與 no_proxy 是否影響這次請求。

略過區域網路通常會讓私人位址範圍直接連線，以便存取路由器、印表機與本機服務；其他流量如何處理，仍須視目前的規則集而定。全域路由通常會將進入用戶端的流量統一送往代理出口，但未經用戶端的應用程式不會因此自動受到接管。無法正常存取本機裝置時，先確認目標位址符合哪條規則及規則順序，再判斷是否因 TUN 或 DNS 設定而改變連線路徑。不要同時修改代理模式、路由與 DNS；逐項調整，並重新測試相同目標，比較容易找出影響來源。

將自行新增的設定放在獨立群組，避免直接修改訂閱產生的設定，因為再次更新時這些欄位可能會被覆寫。更新前請備份用戶端設定與自訂路由，並記下目前使用的群組與設定；備份檔也可能包含憑證，請妥善保管。更新後確認目前使用的設定仍然存在，再檢查傳輸與安全參數是否有變動。自動更新只是重新取得訂閱內容，不會替伺服器端修復過期帳號。若更新結果明顯異常，先查看回應內容與記錄，不要連續覆寫唯一的備份。

先確認本機網路可正常連線至平時直接存取的網站，並啟用系統自動校時；時間偏差可能導致安全交握失敗。接著檢查用戶端核心是否已啟動、本機監聽連接埠是否遭其他程式占用，再核對伺服器位址、遠端連接埠、傳輸方式及 TLS 或 REALITY 參數。查看記錄，分辨網域名稱解析失敗、連線逾時、連線遭拒與交握失敗，不要將它們視為同一種問題。若只在特定網路環境下失敗，可改用其他獲准使用的網路重新測試。不要透過關閉憑證驗證來掩蓋設定錯誤。

先確認「已連線」代表本機服務已啟動，還是遠端請求確實成功；接著用同一個瀏覽器，分別瀏覽平時可直接連線的網站與需要代理的目標。檢查目前使用的設定是否正確、系統代理是否指向用戶端目前的監聽連接埠，以及瀏覽器是否啟用了獨立代理設定。接著查看瀏覽時是否有對應記錄：沒有記錄，優先排查應用程式是否進入用戶端；有記錄但解析失敗，請檢查 DNS；若出現交握錯誤，則核對遠端參數。也請確認訂閱服務狀態；連線入口已啟動，不代表帳號仍然有效。

開啟作業系統的代理設定，確認位址與連接埠和用戶端目前的監聽入口一致，再查看瀏覽器擴充功能是否覆蓋系統設定。有些瀏覽器或工作設定會使用獨立代理、自動設定指令碼或受管理政策；切換用戶端選單無法覆蓋這些設定。在符合裝置管理要求的前提下，可暫時停用代理擴充功能，關閉瀏覽器後重新開啟測試；無痕視窗不一定能略過代理擴充功能或管理政策。若用戶端記錄中沒有請求，先排除入口問題，不要立刻更換訂閱或修改遠端協定。

先查看更新錯誤：逾時通常需要檢查請求路徑與網路；未授權或禁止存取，應核對訂閱權限；回應格式錯誤，則可能是把登入頁面或錯誤頁面當成設定讀取。若用戶端支援選擇更新路徑，可先嘗試不透過代理更新；若訂閱服務確實要求透過代理存取，再用已可用的設定更新，避免形成依賴尚未匯入設定的循環。若網址已過期或遭重設，請向原服務提供者重新取得。分享錯誤訊息時，只保留錯誤類型與必要的狀態資訊，並遮蔽完整網址、認證欄位及回應內容中的憑證。