// TROUBLESHOOTING INDEX
V2Ray 常見問題與故障排除
依基礎認知、安裝設定、使用技巧和故障排除整理。先判斷問題發生在客戶端介面、核心啟動、本機網路還是遠端節點，再逐項修改設定。
// 01 · BASICS
基礎認知
先分清客戶端、核心、訂閱和代理模式。概念層次清楚後，安裝與日誌排查會更直接。
v2rayN、v2rayNG 與 v2flyNG 該怎麼選？
Windows、macOS 與 Linux 桌面環境優先選擇 v2rayN，它提供伺服器清單、訂閱分組、系統代理、路由和 TUN 等完整入口。Android 通常選擇採用 Xray 核心的 v2rayNG；需要使用 V2Fly 核心生態時再選擇 v2flyNG。三者的設定介面不同，訂閱內容能否匯入仍取決於伺服器端提供的協定與欄位。
V2Ray、V2Fly、Xray 與圖形化客戶端有什麼關係？
V2Ray 通常指 Project V 建立的協定與工具生態，V2Fly 和 Xray 是常見的核心家族，負責連線、傳輸、路由與 DNS 等底層工作。v2rayN、v2rayNG、v2flyNG 屬於圖形化客戶端，負責儲存設定、呼叫核心並提供系統代理等操作入口。排查問題時要區分介面設定、核心啟動和遠端節點這三個層次。
訂閱連結和單一分享連結有什麼不同？
訂閱連結通常會回傳一組伺服器設定，客戶端可以依分組儲存並定期更新；單一分享連結只描述一個節點，常見內容包括位址、連接埠、識別資訊、傳輸方式與安全參數。匯入訂閱時應使用訂閱管理入口，匯入單一連結時則使用從剪貼簿匯入或掃描入口。將兩者放錯入口，常見結果就是清單為空或提示無法辨識格式。
系統代理模式與 TUN 模式有什麼不同？
系統代理會透過作業系統的代理設定，將支援代理的應用程式流量交給客戶端，設定簡單，適合瀏覽器和遵循系統代理的桌面程式。TUN 模式會建立虛擬網路介面，可接管更多不讀取系統代理設定的程式，但需要額外權限，也更容易受到本機防火牆、虛擬網卡和 DNS 設定影響。首次設定建議先驗證系統代理，再按需求啟用 TUN。
// 02 · INSTALLATION
安裝設定
安裝階段重點核對作業系統、處理器架構、應用程式權限和首次匯入順序，不要用切換節點處理應用程式啟動問題。
Windows 上的 v2rayN 桌面版與經典 WPF 版該怎麼選？
桌面版採用新一代跨平台介面，適合希望在不同桌面系統間維持相近操作方式的使用者；經典 WPF 版面向 Windows，介面與既有教學中的選單結構較為接近。兩者都能完成訂閱、伺服器選擇和系統代理設定。已有穩定設定不必只因介面變化而遷移，新安裝可先使用桌面版，遇到相容性問題再嘗試 WPF 版。
macOS 安裝包中的 Apple Silicon 與 Intel 該怎麼選？
開啟系統的「關於這台 Mac」頁面，查看晶片或處理器欄位。顯示 Apple M 系列晶片時選擇 Apple Silicon，也就是 arm64 安裝包；顯示 Intel 處理器時選擇 x64 安裝包。選錯架構可能導致應用程式無法啟動，或需要額外轉譯。安裝前先確認晶片類型，比依照裝置外觀或購買年份判斷更可靠。
Android 安裝包中的 arm64 與 universal 該怎麼選？
2015 年後推出的大多數主流 Android 手機可以優先選擇 arm64，安裝包通常更精簡。無法確認處理器架構、裝置較舊，或安裝 arm64 時提示不相容，可改用 universal 通用版。通用版包含更多架構支援，因此檔案通常較大，但客戶端功能不會因此增加。不要只依據系統顯示的 64 位元名稱判斷，安裝結果才是直接依據。
客戶端首次啟動被系統攔截時該怎麼處理？
先確認安裝包與目前的作業系統、處理器架構相符，再從系統安全提示中查看被攔截的具體原因。Windows 可檢查應用程式防護提示，macOS 可在隱私權與安全性設定中確認這次開啟，Linux 則檢查安裝格式、檔案權限和缺少的相依元件。不要連續更換節點來處理啟動攔截，因為此時核心尚未執行，問題發生在應用程式載入階段。
第一次匯入訂閱的正確順序是什麼？
先複製完整的訂閱網址，在客戶端中新建訂閱分組並貼上網址，然後執行更新訂閱。伺服器清單出現後，選擇一個活動伺服器，再啟動核心並開啟系統代理。最後用瀏覽器造訪常用網站驗證連線。訂閱名稱只是本機標記，不影響更新；真正需要保持完整的是訂閱網址，複製時應避免遺漏開頭、參數或結尾字元。
安裝後是否需要另外下載 V2Ray 或 Xray 核心？
通常先使用客戶端安裝包內建或由客戶端管理的核心，不需要在首次安裝時另外拼接核心檔案。若日誌明確提示核心不存在、無法啟動或版本不相容，再檢查客戶端的核心設定與更新入口。手動放置核心時必須符合系統和處理器架構，並確保客戶端設定中的核心路徑與實際檔案位置一致。
// 03 · OPERATION
使用技巧
日常操作圍繞訂閱更新、活動伺服器、代理模式和路由規則展開。每次只調整一個變數，日誌才具備可比性。
訂閱應該多久更新一次？
更新頻率取決於訂閱提供方的變更節奏。節點資訊長期穩定時，沒有必要頻繁重新整理；收到設定調整通知、目前節點集中失效或訂閱內容發生變化時，應手動更新一次。自動更新間隔不宜設定得過短，過於頻繁可能觸發請求限制。更新前保留目前可用的伺服器，更新後再觀察分組和活動伺服器是否被替換。
如何選擇活動伺服器並判斷設定是否可用？
先更新訂閱，再在伺服器清單中選擇一個項目作為活動伺服器。客戶端提供的測試結果只能作為篩選參考，最後仍應啟動核心並實際造訪目標網站。測試失敗時先查看日誌中的網域解析、連線遭拒、握手失敗或逾時資訊。不要只根據名稱和排序判斷，也不要同時修改協定、路由、DNS 與代理模式，否則很難定位變化來源。
全域、規則與直連模式該怎麼使用？
全域模式通常會將可接管的流量交給目前伺服器，適合暫時驗證節點是否運作；規則模式依照 domain、ip、geosite 等條件決定代理或直連，適合日常使用；直連模式主要用於暫停代理路徑和對照排查。設定新訂閱時可以先用全域模式驗證連線，再切回規則模式。如果切換後出現差異，應檢查規則順序和最後的兜底規則。
自訂路由規則為什麼沒有命中？
先確認規則類型與內容相符，例如將網域放入 domain 條件，位址區段放入 ip 條件，預設分類使用正確的 geosite 名稱。多數路由會依由上到下的順序匹配，前面的寬泛規則可能提早攔截流量。修改後要讓客戶端重新載入設定，並從日誌確認實際目標網域、解析結果與命中的出站。只修改規則但未重新啟動核心，通常仍會繼續使用舊設定。
如何設定開機啟動與啟動後自動連線？
開機啟動、啟動核心和啟用系統代理是三個不同的動作。先在客戶端設定中啟用隨系統啟動，再確認啟動時載入上次使用的伺服器，最後按需求開啟啟動後設定系統代理。首次設定後應重新啟動一次系統進行驗證，檢查客戶端是否執行、核心是否啟動、系統代理是否寫入。只看到系統匣圖示並不代表代理路徑已經生效。
// 04 · DIAGNOSIS
故障排除
從第一個可重現的錯誤開始：訂閱請求、設定解析、核心啟動、節點連線、DNS、路由與應用程式接管依序檢查。
匯入訂閱連結後為什麼沒有伺服器？
先確認使用的是訂閱管理入口，並執行一次手動更新。若清單仍為空，檢查網址是否完整、是否包含多餘空格、是否已失效，以及客戶端日誌中的 HTTP 狀態或解析錯誤。瀏覽器能開啟訂閱網址不代表客戶端一定能解析，其中的內容還必須符合支援的訂閱格式。也要檢查伺服器是否被匯入其他分組或被篩選條件隱藏。
訂閱更新失敗或提示網路錯誤該怎麼排查？
先用目前的網路確認訂閱網址可以存取，再檢查客戶端是否設定了用於更新訂閱的代理方式。目前的活動節點已失效時，透過代理更新可能形成依賴循環，可暫時改用直連更新；直連無法存取時，則需要選擇仍可用的伺服器後重試。還應核對系統時間、網址參數、請求限制，以及日誌中的憑證或網域解析提示。
節點測試一直逾時，應該檢查什麼？
先切換同一訂閱中的另一個節點，判斷是單一節點故障還是全部設定異常。全部逾時時，檢查本機網路、系統時間、防火牆、DNS 和核心啟動日誌；只有個別節點逾時時，通常與遠端狀態、連接埠、傳輸參數或線路有關。測試工具本身也可能使用特定目標網址，因此應結合實際網頁存取和連線日誌判斷。
客戶端顯示已連線，但瀏覽器無法上網怎麼辦？
依序確認活動伺服器、核心執行狀態、系統代理開關和瀏覽器代理來源。先使用全域模式進行一次對照測試，再查看日誌是否出現 DNS 失敗、路由至直連、連線遭拒或握手錯誤。瀏覽器若曾安裝獨立代理擴充功能，可能會繞過系統設定，應暫時停用後重試。修改完成後關閉並重新開啟瀏覽器連線，避免繼續重用舊工作階段。
系統代理已開啟，但部分程式不生效怎麼辦？
部分程式不讀取作業系統代理，或只支援特定代理類型，因此即使開啟系統代理仍可能直連。先確認瀏覽器等標準應用程式可以正常使用，再檢查目標程式是否有獨立代理設定。需要接管更多應用程式時可評估 TUN 模式，但應先記錄原有網路設定。企業網路、安全軟體和其他代理工具也可能覆寫系統代理，排查時只保留一個控制入口。
TUN 模式提示權限不足或啟動失敗，該如何處理？
TUN 需要建立或管理虛擬網路介面。桌面系統上應依照客戶端提示授予管理員或網路擴充功能權限，Android 上則應確認系統的 VPN 連線授權。若仍然失敗，檢查是否已有其他虛擬網卡、代理工具或安全軟體佔用相關功能，並查看日誌中的驅動程式、介面名稱和路由寫入錯誤。退出其他網路工具後重新啟動客戶端，通常比反覆切換節點更有效。
// RELATED DOCUMENTS
繼續查看設定步驟
需要從匯入訂閱開始操作時，請查看使用文件；需要了解代理模式、路由、TUN 與日常維護時，請進入系統教學。