v2rayN 常見問題

Windows、macOS 與 Linux 桌面系統可選用 v2rayN；Android 裝置可優先考慮採用 Xray 核心的 v2rayNG，採用 V2Fly 核心的 v2flyNG 則可作為替代選擇。用戶端負責管理設定、呼叫核心並提供代理入口，不會自動產生可用的訂閱。選擇前先確認裝置平台，再檢查目前用戶端是否支援訂閱所用的協定與傳輸方式。三款軟體的設定資料夾與介面各不相同，轉換時建議重新匯入訂閱，不要直接覆蓋彼此的資料檔案。

還需要來源可信且仍有效的訂閱網址，或完整的伺服器設定。訂閱通常包含伺服器位址、連接埠、協定與驗證參數，用戶端只負責讀取並使用這些資訊。安裝完成後，先匯入設定，再選擇伺服器，最後設定系統代理或 Android VPN 連線並測試是否能正常存取。軟體安裝成功不代表伺服器已可使用；若尚未取得設定，請向設定提供者確認取得方式。不要使用來源不明的設定作為測試資料，也不要在公開截圖中留下訂閱網址。

訂閱網址是取得一組設定的入口，更新後可能新增、刪除或修改伺服器；單一節點分享連結通常只包含一份伺服器設定，不會隨訂閱自動更新。匯入前先確認拿到的是網頁網址、訂閱網址還是協定分享連結。訂閱網址應填入訂閱群組的網址欄位，分享連結則使用用戶端對應的剪貼簿匯入功能。帳戶管理頁面不能代替訂閱網址，複製時也要避免帶入前後空白或換行。訂閱網址中的驗證參數屬於敏感資訊，請妥善保管，如同帳戶憑證。

系統代理會將代理入口寫入作業系統設定，通常供遵循該設定的瀏覽器與應用程式使用；自行建立連線或使用獨立代理設定的軟體可能不受影響。TUN 模式透過虛擬網路介面接入流量，可涵蓋更多應用程式，但也涉及路由、DNS 與系統權限。無論採用哪種方式，都不代表所有連線一定會經過代理，實際出口仍受分流規則影響。剛開始設定時，建議先使用系統代理確認連線，再依需求啟用 TUN，以免同時變更多項網路設定，難以排查問題。

先確認複製的是完整訂閱網址，而不是帳戶登入頁或付款頁面，並刪除前後空白。開啟訂閱群組、加入網址並儲存後，還要執行「更新所有訂閱」；只儲存不會立即產生伺服器清單。若出現無法辨識格式的提示，請檢查回傳內容是否為登入頁、錯誤頁，或目前用戶端不支援的設定格式；不要只是不斷貼上同一個網址。若部分設定沒有出現，請查看記錄中的解析訊息，再向提供者確認相容格式。排查時只需描述錯誤類型，不要公開含有驗證參數的完整網址。

2015 年後推出的主流 Android 手機通常可優先選擇 arm64，但仍應以裝置實際支援的應用程式架構為準。universal 包含多種架構，檔案通常較大，適合無法確認架構或需要相容不同裝置的情況。若安裝 arm64 時顯示不相容，可先查看系統與處理器資訊，再試用通用版；部分裝置的處理器支援 64 位元，但系統環境仍可能有所限制。若安裝包解析失敗，還要檢查系統版本是否符合需求，不能將所有安裝失敗都歸因於架構選擇。

桌面版採用跨平台介面，經典 WPF 版則適用於 Windows，兩者的介面配置、相依項目及部分設定入口可能不同。切換前先使用用戶端提供的匯出或備份功能保存設定，並記下訂閱群組、路由與本機連接埠。接著關閉舊版用戶端，再啟動另一個版本，避免兩者搶用同一個代理連接埠。不要隨意混合或覆蓋新舊版本的檔案，也不要在確認移轉結果前刪除原有資料。首次啟動後重新檢查系統代理入口與目前使用的伺服器，確認連線正常後再清理舊資料夾。

在 Windows 上先結束用戶端，再以系統管理員身分執行並重新啟用 TUN。macOS 與 Linux 的權限授予方式取決於用戶端版本和系統環境，請依目前介面的提示完成授權，不要任意放寬整個設定資料夾的權限。若授權後仍失敗，請查看記錄是否提到虛擬介面建立失敗、驅動程式問題或連接埠遭占用，並確認是否有其他 VPN 或 TUN 程式正在執行。測試時一次只保留一個接管網路的工具；失敗後先關閉 TUN、恢復一般網路，再繼續排查原因。

訂閱中的伺服器資訊由提供者維護，更新時可能會重新產生，因此不要預期手動修改能長期保留在訂閱項目中。若要測試某個參數，先將相關設定複製成獨立的手動項目，並用清楚的備註區分訂閱原項與測試項目。更新訂閱前也可以先備份目前設定，以免操作錯誤後無法還原。若經常需要修改相同欄位，應先向提供者確認原始設定是否有誤，而不是每次更新後都重複修正。群組層級設定與伺服器欄位的保留方式可能不同，請以目前版本的實際結果為準。

若希望瀏覽器等應用程式使用用戶端入口，請選擇自動設定系統代理；暫時停止使用或準備結束用戶端時，可選擇清除系統代理；只有在其他工具負責管理系統代理時，才考慮選擇不變更系統代理。不變更不代表直接連線，而是保留系統目前的設定，舊代理位址也可能繼續生效。切換後請到作業系統的代理設定中確認實際入口。若關閉用戶端後瀏覽器仍無法存取，先檢查是否還有指向本機連接埠的代理，再清除不再使用的設定。

瀏覽器和終端機工具可能讀取不同的代理設定；瀏覽器能正常使用，只代表它自己的連線方式可用。先確認終端機工具是否支援系統代理；若不支援，再依工具文件設定代理參數或 http_proxy、https_proxy 等環境變數。位址應填入用戶端實際監聽的本機位址與連接埠，並選用相符的 HTTP 或 SOCKS 類型，不要照抄其他裝置的數值。環境變數通常只會套用到目前工作階段或新啟動的處理程序。測試結束後請清除暫時設定，避免用戶端關閉後終端機仍嘗試連線至舊連接埠。

先檢查路由規則是否包含將 geoip:private 指向 direct 的項目，並確認該規則排在可能優先符合的廣泛規則之前。這項規則主要適用於私有位址，不代表所有內部網域都一定涵蓋；透過內部網域存取時，也要確認 DNS 回傳的是正確的內網位址。儲存規則後，重新測試路由器管理頁面、印表機或內部服務。若仍無法存取，暫時關閉代理以確認基本網路是否正常，再檢查應用程式是否自行指定代理。不要只為了存取一項區域網路服務，就直接刪除整套分流規則。

先分辨是請求逾時、驗證失敗，還是內容解析失敗。若逾時，請檢查本機網路與訂閱網域是否能解析，並確認更新時使用的是直接連線還是現有代理；若目前使用的節點已失效，透過該節點更新就可能失敗。若驗證失敗，檢查訂閱是否已到期或網址是否已重設；若解析失敗，則確認提供者是否更換了格式。不要短時間內頻繁重試，伺服器可能會限制請求。若需要重新取得訂閱網址，請儲存後再更新，並只向提供者提交已移除驗證參數的錯誤資訊。

單次測試逾時只表示該測試請求未能在指定時間內完成，不能據此判定整組設定都已失效。先確認裝置時間正確，再改用同一群組中的另一台伺服器實際測試連線。若只有一個項目失敗，請核對位址、連接埠與傳輸參數；若全部失敗，優先檢查本機網路、訂閱有效期限、核心啟動記錄與防火牆提示。部分測試目標無法連線也會造成逾時，可改用用戶端支援的其他測試方式交叉確認。排查連線問題時，不要長時間關閉系統防護。

顯示已連線通常只代表本機服務或 Android VPN 介面已啟動，不保證遠端伺服器可以存取。先關閉 TUN，只保留一種連線方式，確認目前使用的伺服器與本機監聽連接埠，再檢查系統代理是否指向該連接埠。若瀏覽器裝有獨立代理擴充功能，請暫時停用後重新開啟網頁。若網域無法開啟但網路仍連線，請繼續檢查 DNS；若所有請求都失敗，查看核心記錄中的驗證、交握或連線錯誤。Android 也應檢查依應用程式設定的代理清單，確認瀏覽器未被排除。

先觀察是否只有在鎖定螢幕或切換應用程式後才會斷線。若前景使用正常、背景卻經常停止，請檢查系統是否限制用戶端的背景活動或電池使用，並依裝置設定允許必要的背景執行。確認 VPN 授權仍有效，且沒有其他 VPN 應用程式取代目前的連線。若只在無線網路與行動數據切換時失敗，請返回用戶端重新連線並查看記錄，再測試其他伺服器。背景限制與節點故障可能同時存在，建議分開測試，不要一次更改電池、DNS、路由和伺服器的所有設定。