V2Ray 全平台安裝設定

事前準備：確認裝置、設定與接管範圍

分清用戶端、核心與連線設定

先分清三個層次。v2rayN、v2rayNG、v2flyNG 是用來顯示節點、儲存訂閱及調整代理模式的圖形用戶端；Xray 與 v2fly 是負責處理協定、路由與連線的核心；訂閱或分享連結則提供伺服器位址、連接埠、身分資訊及傳輸參數。安裝用戶端不代表已取得可用伺服器。開始前請準備有效設定，並確認服務提供者允許目前裝置使用，避免把缺少連線資料誤判為安裝失敗。

桌面端可從 v2rayN 開始；Windows、macOS、Linux 的操作概念相近，但安裝格式和權限各有不同。Android 優先選用採用 Xray 核心的 v2rayNG，已有設定明確要求 v2fly 時再選 v2flyNG。不要只憑協定名稱判斷相容性：即使同為 VLESS，傳輸方式、安全層與附加選項也可能不同。請一併確認整套參數是否受所選用戶端核心支援，無法靠更換應用程式圖示解決設定差異。

確認架構、系統環境與設定來源

開啟系統的裝置資訊，記下作業系統、處理器架構及目前的網路連線方式。桌面常見的 x64 與 arm64 不可混為一談，安裝格式也不代表處理器架構。先到下載頁選擇正確平台，再選對應的下載項目。系統相容範圍請以下載頁說明和安裝程式的實際提示為準，不要根據舊文章推斷所有系統都能執行。裝置時間應設為自動同步；日期明顯錯誤可能影響憑證驗證及部分協定驗證。

確認拿到的是訂閱網址、單一節點連結，還是完整設定檔。訂閱網址通常是可透過網路讀取設定集合的網址；單一節點連結通常帶有協定前綴；完整設定檔則可能包含入站、出站與路由。三者應使用各自的匯入入口。請保存原始資料，複製時留意換行、尾端空格及通訊軟體截斷內容的情況。訂閱連結可能包含帳戶識別資訊，截圖、記錄檔和求助內容都應遮蔽這些資訊。

先建立最基本的連線，再逐步加入功能

首次設定只啟用一個用戶端、一個明確選取的節點，以及一種流量接管方式。先使用桌面系統代理，或 Android 的 VPN 接管，確認瀏覽器能依預期存取，再加入分流、應用程式排除及 TUN。多個代理程式同時啟動，可能搶占本機連接埠、覆寫系統設定或重複接管路由。發生故障時，先回到這個最基本的狀態，比同時修改訂閱、核心和 DNS 更容易找出影響來源。

了解系統代理的適用範圍。它會讓遵循系統設定的應用程式使用本機代理，但不保證所有程式都會採用；瀏覽器擴充功能、應用程式自己的代理選項及命令列環境可能另有設定。TUN 透過虛擬網路介面接收更多流量，但仍受路由、DNS、應用程式排除設定及系統權限影響。不要把「全域」理解為任何情況下所有資料都一定經過同一個出口，應搭配用戶端實際規則和記錄檔確認。

最後確認不使用代理時的基本網路狀態。如果裝置連登入頁面都無法開啟，請先處理無線連線、網路驗證或本機 DNS，再設定用戶端。記錄原有的系統代理和手動 DNS；尤其是公司網路或受管理裝置，不應直接覆寫既有政策。測試時盡量使用相同網路、目標及模式；每次只修改一項並記錄結果，之後才能準確還原，而不是靠反覆重裝碰運氣。

Windows：安裝 v2rayN 並設定系統代理

選擇桌面版或傳統 WPF 版

前往Windows 下載專區，優先查看 v2rayN。桌面版使用跨平台介面，傳統 WPF 版則保留 Windows 的介面與操作習慣；兩者的選單位置可能不同，但訂閱、使用中節點、系統代理及路由仍屬相同的設定層次。請依下載頁列出的系統需求選擇，不要同時啟動兩個版本測試同一個連接埠。先決定使用哪個版本，再確認捷徑與工作目錄相符。

執行安裝程式後，依系統提示完成安裝，並將設定儲存在目前帳戶具有寫入權限的位置。如果取得的是壓縮檔，請先完整解壓縮，再從解壓後的資料夾啟動；不要直接在壓縮檔預覽視窗中執行。若需要執行階段元件，先核對系統提示及下載頁說明，不要從不明彈出視窗取得元件。首次啟動遇到安全性提示時，請確認檔案來源及系統提示內容，不要關閉整套系統防護。

匯入訂閱並確認目前使用的節點

在主視窗找到訂閱群組管理，新增群組，填入易於辨識的名稱及完整訂閱網址，儲存後執行更新。新增網址只是建立訂閱記錄，通常還要手動更新才能取得節點。更新成功後，從群組中選取節點，使用「設為目前伺服器」或功能相同的操作確認。反白某一列不一定代表已切換，請查看目前使用標記，並留意記錄檔是否載入對應設定。

先啟動核心，再啟用系統代理。使用自動設定方式時，請確認選用的是用戶端提供的系統代理選項，而不是在 Windows 中填入遠端伺服器位址。系統代理指向本機監聽入口，遠端連線由核心處理。開啟系統代理設定，核對位址是否為本機迴路位址，以及連接埠是否與用戶端一致。不要照抄他人使用的固定連接埠，實際數值應以目前用戶端設定為準。

依應用程式驗證系統代理與 TUN

使用遵循系統代理的瀏覽器開啟測試頁面，查看是否出現新的連線記錄。如果瀏覽器正常、某個應用程式卻失敗，先檢查該應用程式是否有獨立代理設定、擴充功能或內建網路選項；不要立刻更換節點。若程式明確支援手動代理，可依用戶端實際監聽協定填入 HTTP 或 SOCKS 入口，避免把 SOCKS 連接埠當成 HTTP 連接埠。驗證完成後，只保留一種明確的應用程式代理設定。

需要接管不遵循系統代理的應用程式時，再考慮使用 TUN。先儲存設定，依用戶端提示授予管理虛擬網卡或路由所需的權限，再啟用功能。首次測試不要同時使用其他第三方 VPN 和手動路由。TUN 成功啟動後，應能看到相關介面或啟動記錄；若開關顯示已啟用，卻出現權限錯誤，就不能視為接管成功。可參閱TUN 模式說明核對操作步驟。

排除 Windows 特有的啟動與結束問題

啟動失敗時，先查看是否已有其他執行個體占用監聽連接埠。關閉重複執行的執行個體後再試；若仍失敗，查看記錄檔中的連接埠占用、設定解析或元件缺漏等具體訊息。安裝目錄位於受保護的位置，或設定檔被同步軟體占用，也可能導致儲存失敗。此時應檢查目錄權限和檔案狀態，不要長期以系統管理員身分執行來掩蓋所有問題，更不要刪除尚未備份的訂閱資料。

正常結束前，先關閉 TUN、清除本用戶端設定的系統代理，再結束程式。若非正常關機後所有網頁都無法開啟，請檢查 Windows 是否仍指向已停止的本機代理；還原原本設定後再重新啟動用戶端。確認手動連線穩定後，再啟用開機自動啟動，並分別檢查登入後啟動及權限提升提示。睡眠喚醒後發生異常時，先重新啟動接管功能並檢查網路，不必重新匯入整份訂閱。

macOS：依晶片選擇安裝版本並檢查網路服務

辨識晶片並安裝應用程式

開啟系統的「關於這台 Mac」，先確認顯示的是 Apple 晶片還是 Intel 處理器，再前往macOS 下載專區選擇 v2rayN。Apple Silicon 對應 arm64，Intel 對應 x64；不要只憑裝置購買年份判斷。選錯架構可能導致無法執行或增加相容層，讓故障排除多出其他變因。若下載頁提供兩種選項，請選擇符合本機原生架構的版本，不要同時安裝兩份應用程式測試。

開啟磁碟映像檔後，依提示將應用程式拖入「應用程式」資料夾，再從安裝位置啟動。不要長期從已掛載的映像檔執行，否則更新、捷徑及權限位置可能混亂。首次開啟時，依系統提示確認應用程式來源；若系統阻止啟動，請查看「隱私權與安全性」中與此次操作相關的提示，確認來源後依系統允許的程序處理。不要使用關閉整體系統安全機制的指令，繞過原因不明的阻擋。

匯入資料並檢查系統代理的套用範圍

開啟 v2rayN 的訂閱管理，新增群組並填入完整網址，儲存後更新。節點出現後，明確設為目前使用的節點，再啟動代理。如果設定可以匯入，但核心無法啟動，先檢查記錄檔中的協定、安全層及傳輸錯誤；成功匯入只代表用戶端能辨識資料，不保證所選核心支援其中所有選項。跨裝置移轉時，也要確認沒有誤用只適合另一種環境的自訂設定檔。

啟用系統代理後，進入系統網路設定，確認目前使用中的網路服務。Wi-Fi、乙太網路和其他網路服務可能各自保存代理選項；切換連線方式後，原有設定不一定會套用到新服務。核對本機位址、連接埠及協定，不要把伺服器網域直接填入本機代理欄位。公司網路若已有自動代理設定檔，請先記錄原設定，避免覆寫既有連線路徑後無法還原。

瀏覽器測試通過後，再測試需要使用的應用程式。有些應用程式會保留自己的代理設定，有些終端程式只讀取環境變數；不能因為系統代理已開啟，就認定所有程式都已採用。排除問題時，先暫時關閉瀏覽器代理擴充功能，並使用相同目標比較預設設定與應用程式的獨立設定。如果只有一個應用程式異常，應優先檢查它的網路選項，而不是反覆修改整個系統的 DNS。

啟用 TUN 並處理權限與網路切換

需要接管更多流量時，可使用用戶端實際提供的 TUN 功能。先儲存設定，依目前介面的權限指引操作，再確認虛擬介面和路由是否成功建立。不同發行版本及系統環境可能有不同的輔助元件或權限提示，請以目前用戶端的提示為準。不要照抄舊文章中的介面名稱，也不要在不清楚用途時手動刪除系統網路介面。啟用後若網路中斷，先關閉 TUN，還原基本網路狀態。

從 Wi-Fi 切換至有線網路、熱點或需要網頁登入的網路時，先確認基本連線已建立。驗證頁面可能要求直接使用目前網路存取，舊代理、DNS 或路由會干擾登入流程。可先關閉流量接管並完成驗證，再重新啟用。睡眠喚醒後若核心仍在執行但連線中斷，請檢查網路服務是否變更，再重新建立接管；只有訂閱確實過期或參數有變動時，才需要更新節點資料。

儲存設定並確認結束方式

升級應用程式前，使用用戶端支援的方式備份訂閱群組及必要設定，並記錄現有路由與流量接管模式。程式目錄和使用者設定目錄用途不同，不應把刪除應用程式等同於清除設定。移轉至新裝置時，先重新匯入原始訂閱，再逐項還原自訂設定，避免直接搬入舊裝置的網路路徑、權限狀態或介面相關參數。備份檔應保存在自己能控管的位置，不要公開分享。

結束應用程式後若仍無法連線，請檢查目前網路服務的代理頁面是否留有本機位址，並確認對應的本機程序是否已停止。依記錄還原原設定，再測試基本網路。若同時安裝企業網路工具，請遵循裝置管理規定，避免自行修改受管理的政策。日常使用時應維持明確的啟停順序：先連上網路，再啟動核心，最後啟用流量接管；結束時反向操作，方便找出殘留設定。

Linux：選擇套件並分清桌面代理與 TUN

依發行版與架構選擇安裝方式

前往Linux 下載專區選擇 v2rayN。先在系統設定或裝置資訊中確認發行版及處理器架構，再選擇套件。deb 常用於 Debian、Ubuntu 及相關發行版；rpm 常用於採用相應套件管理系統的發行版，兩者不是可任意互換的壓縮格式。桌面裝置常見 x64，部分裝置採用 arm64，套件格式與架構兩項條件都必須符合。不要只憑副檔名判斷能否安裝。

優先使用系統的軟體安裝程式安裝本機套件，讓套件管理工具處理相依項目及安裝記錄。若出現相依項目不符合的提示，先查看具體元件與系統版本，再確認目前環境是否受支援。不要強行忽略相依性繼續安裝，也不要為了執行單一用戶端而任意替換系統基礎函式庫。安裝後從應用程式選單啟動；若桌面捷徑沒有立即更新，可重新登入桌面工作階段，再確認安裝是否完成。

以一般使用者帳戶設定訂閱與本機入口

先使用日常帳戶執行用戶端，匯入訂閱並更新節點，再選取目前使用的節點。訂閱和介面設定通常屬於目前使用者；長期以高權限帳戶啟動，可能讓檔案變成一般使用者無法修改的狀態，導致下次儲存失敗。設定無法持續保存時，先檢查設定目錄的擁有者及寫入權限，而不是再次提高權限執行。需要移轉設定時，先備份，再使用用戶端支援的匯入方式還原。

Linux 的桌面代理不是所有程序都會遵循的統一開關。不同桌面環境可能使用不同設定機制；瀏覽器、軟體商店、終端機和背景服務也可能分別讀取系統設定、環境變數或自己的設定。先用一個明確支援系統代理的瀏覽器測試，再逐一確認其他應用程式。修改環境變數後，可能需要重新開啟終端機；已在執行的服務也不會自動取得之後在桌面工作階段中變更的變數。

依用戶端指引設定 TUN 權限

準備啟用 TUN 時，先確認用戶端在目前 Linux 環境中提供相應功能，並閱讀介面上的授權要求。虛擬網路裝置與路由修改通常需要額外權限，但不代表圖形介面應始終以高權限執行。優先採用用戶端支援的輔助服務或授權流程。不要直接複製其他發行版的權限指令到目前系統，也不要為了略過提示而授予整個應用程式目錄過大的存取權限。

啟動後檢查記錄檔，確認虛擬介面確實建立、路由確實加入，再測試應用程式流量。系統本身的 DNS 管理工具、網路管理服務和用戶端 DNS 設定可能同時存在，必須分清由誰接收查詢、由誰提供上游伺服器。若只有網域存取失敗、直接網路連線正常，先查看 DNS 相關錯誤，不要把所有問題都歸咎於伺服器無法使用。修改解析設定前先記錄原狀態，停止用戶端後也應能恢復正常解析。

排除連接埠、桌面工作階段與網路管理衝突

本機連接埠遭占用是常見的啟動失敗原因。若其他使用者工作階段、舊執行個體或代理工具已監聽相同連接埠，新執行個體可能無法建立入口。優先結束不再需要的執行個體；若確實要更改連接埠，也要同步修改所有手動指定該連接埠的應用程式。只改用戶端一端，瀏覽器仍會連到舊入口。防火牆規則也應按實際需求檢查；本機使用通常不需要將代理監聽入口開放給整個區域網路。

圖形介面無法開啟和網路無法連線是兩種不同問題。若顯示服務、桌面工作階段或介面相依項目異常，應先讓應用程式正常啟動；若核心能執行但流量不通，再檢查設定和網路路徑。沒有桌面環境的遠端系統不應視為相同的圖形操作環境。本手冊以圖形用戶端為主，排錯不需要額外建立獨立的背景代理服務，以免同一台裝置出現兩套來源不明的路由設定。

設定開機啟動前，先確認一般登入後的手動操作流程正常。自動啟動工作、使用者服務和系統服務所使用的帳戶及環境並不相同，桌面中可用的路徑不一定適用於背景服務。更新軟體後，檢查自動啟動項目是否仍指向有效位置；正常結束時應關閉 TUN 並還原代理。若異常結束後無法連線，先對照原本的網路管理設定還原基本狀態，再重新啟用用戶端，不要直接清除整套防火牆或系統路由。

Android：安裝用戶端並管理 VPN 流量接管

選擇 v2rayNG 或 v2flyNG

從Android 下載專區開始，優先選用採用 Xray 核心的 v2rayNG；需要 v2fly 核心時再考慮 v2flyNG。這是兩款不同的用戶端，不要假設訂閱、路由及應用程式排除等設定會自動共用。較新的主流手機可先查看 arm64 版本；裝置較舊或架構不明時，請查看通用版說明。最終應依裝置支援的架構及安裝提示選擇，不要只憑手機外觀判斷。

安裝前，允許目前的下載來源安裝應用程式，並只授予實際使用的瀏覽器或檔案管理員必要權限。安裝完成後，可關閉不再需要的來源授權。遇到解析失敗、無法安裝或與已安裝應用程式衝突時，先確認檔案是否適用於目前裝置，以及現有應用程式的安裝來源。不要直接解除安裝後重裝，因為解除安裝可能清除設定；請先保存訂閱網址和必要設定，再決定是否需要移轉或重新安裝。

匯入訂閱、選擇節點並允許連線

開啟應用程式，從選單進入訂閱群組或訂閱設定，新增名稱和網址，儲存後返回主畫面執行更新。節點出現後，點選要使用的項目，再啟動連線。若複製的是單一節點分享連結，請使用從剪貼簿匯入的對應入口；不要將完整訂閱網址當成單一節點內容處理。清單反白、服務啟動狀態和系統 VPN 圖示各自代表不同層次，測試時都應一併留意。

首次連線通常會顯示系統 VPN 授權對話框。確認是目前使用的用戶端發起後，再允許建立連線。這項授權用於在本機建立流量接管介面，不代表訂閱伺服器已可使用。若出現 VPN 圖示但網頁仍無法開啟，請繼續檢查節點、DNS 和路由。Android 的這種接管方式不同於在桌面瀏覽器中填寫系統 HTTP 代理，不必在 Wi-Fi 代理頁面重複填入遠端節點位址。

檢查應用程式範圍與背景限制

先使用預設的應用程式範圍測試，再依需求啟用應用程式分流。請分清「僅所選應用程式使用代理」與「所選應用程式略過代理」這兩種相反設定，實際名稱以目前介面為準。新增或移除應用程式後，依用戶端要求重新建立連線。若瀏覽器正常、某個應用程式卻失敗，先確認它是否遭到排除或位於另一個使用者空間，再檢查路由與協定；不能只因桌面版可用，就認定手機設定完全相同。

多數一般使用情境下，同一使用者空間通常只能維持一個作用中的 VPN 連線。其他 VPN、使用本機 VPN 的過濾工具或企業網路工具，都可能取代目前連線，導致用戶端看似啟動後又停止。排除問題時只保留一種流量接管工具，並觀察系統狀態及用戶端記錄檔。受管理的裝置應遵循組織政策，不要為了讓連線持續運作而任意停用企業管理功能或繞過系統限制。

鎖定螢幕後斷線或切換應用程式後服務停止，通常與背景管理有關。先檢查用戶端是否受到電池最佳化限制、是否允許背景資料，再重現一次鎖定螢幕的情況。不要一次關閉整台裝置的省電設定，只調整必要的應用程式。即使長時間在背景執行，也不代表網路永遠不會中斷；從 Wi-Fi 切換至行動網路時，原連線可能需要重新建立。請以實際存取結果和新連線記錄確認是否恢復，而不只看通知列是否仍有圖示。

處理網路切換與常駐 VPN 設定

在熱點、Wi-Fi 和行動數據之間切換後，先確認裝置本身能連上網路，再檢查節點連線。部分網路需要先完成網頁驗證，可暫時停止流量接管以登入，之後再重新連線。若只有行動數據無法使用，請檢查用戶端及目標應用程式的行動網路權限；若所有網路都失敗，再檢查訂閱是否有效、裝置時間及參數。先找出問題是否只發生在特定網路，通常比連續切換多個節點更有效。

需要設定 VPN 常駐，或在 VPN 中斷後禁止連線時，先了解可能的影響：服務停止、裝置重新啟動或訂閱失效時，系統可能會依設定限制其他網路存取。建議一般連線穩定後再啟用，並記住系統中還原設定的位置。移轉至另一個用戶端前，先停止原服務、備份設定並確認新應用程式的核心支援情況；移轉完成後重新設定應用程式範圍，避免以為規則仍然生效，實際上卻未儲存。

訂閱管理：匯入、更新與設定移轉

辨識三種資料並選擇正確的匯入方式

先確認資料的形式。以 vmess://、vless:// 等協定前綴開頭的通常是單一節點分享連結，包含連線至一台伺服器所需的資訊；訂閱網址通常用來取得一組設定；完整 JSON 設定則可能同時描述入站、出站、DNS 和路由。請分別使用分享連結匯入、訂閱群組管理及自訂設定入口。副檔名和網址外觀只能提供線索，仍需確認實際內容格式。

單一節點連結適合臨時測試或固定設定，參數變更後通常需要重新匯入；訂閱則適合管理由服務提供者維護的一組節點，更新時會取得最新內容。QR Code 只是承載文字的方式，掃描後仍須判斷取得的是哪一種資料。不要因為連結能在瀏覽器中開啟，就認定它一定是用戶端可解析的訂閱；登入頁、錯誤頁及帳戶管理頁都不是有效的節點清單。

建立群組並確認更新結果

為每個來源建立獨立群組，名稱標明用途或裝置，避免將多個來源混在無法追蹤的清單中。儲存網址後手動更新一次，查看更新結果和節點是否出現。若用戶端可選擇透過代理或直接更新，先選目前確實可用的路徑：尚無可用節點時，依賴已失效的代理更新會形成循環。只有確認存取訂閱需要另一條正常運作的路徑後，才切換更新方式，不要反覆點擊按鈕。

更新後確認目前使用的節點。有些用戶端會盡量保留原選項，但節點遭到刪除、更名或替換後，目前使用的項目可能改變或失效。節點名稱只是顯示標籤，並非確認伺服器身分的可靠依據；遇到同名項目時，應搭配群組和連線參數確認。設定自動更新前，先確定手動更新穩定，不必安排過短的更新間隔。頻繁重新整理無法解決帳戶到期、請求限制或內容格式不相容，反而可能讓錯誤訊息更難判讀。

排查清單空白、項目缺漏與參數不相容

沒有節點時，先分辨是下載失敗還是解析失敗。下載失敗應檢查網址是否完整、網路路徑、帳戶狀態及系統時間；解析失敗則應確認回傳內容格式是否有效，以及是否包含目前核心不支援的選項。不要將訂閱網址貼到公開的線上工具中測試，網址可能包含存取權限。需要求助時，只提供已遮蔽主機身分資訊、帳戶參數及憑證的錯誤摘要，並說明用戶端和平台。

只有部分節點缺漏時，請檢查協定、傳輸方式及安全層的組合是否受支援，也要確認用戶端是否啟用了篩選。協定名稱相同，不代表其他核心都能辨識每種延伸參數。不要為了讓匯入成功而任意刪除 TLS、REALITY、服務名稱或路徑等欄位；用戶端與伺服器必須使用相符的參數。相關概念可參閱分享連結與訂閱網址的差異，再回頭核對原始資料。

移轉前先備份，更新後再確認

更換裝置或重新安裝前，分別備份訂閱來源、手動新增的節點、路由規則及應用程式排除設定。重新更新訂閱可以還原來源仍提供的節點，但不一定會還原本機備註、自訂排序或已遭來源刪除的項目。匯出完整設定也不代表能跨平台直接使用，因為本機監聽、檔案路徑、虛擬介面及權限可能不同。移轉時優先還原連線資料，再還原通用規則，最後調整平台專屬設定。

不要把直接編輯訂閱產生的節點當成長期維護方式。下次更新可能覆蓋這些修改；確實需要調整時，可在用戶端支援的範圍內複製成獨立項目，並記錄修改原因。如此一來，更新來源時就不會把本機測試與原始設定混在一起。手動新增的節點也應定期確認是否仍有效，不能因為它不會自動更新，就認為伺服器參數永遠不會改變。

完成還原後，先用一個節點進行基本測試，確認核心啟動、應用程式接管和網域存取正常，再還原更多群組與規則。訂閱顯示的備註或期限不能取代實際連線測試；用戶端能讀取清單，也不代表帳戶仍允許建立連線。若服務提供者調整了格式或核心需求，先確認移轉說明，再更新用戶端設定。未備份前切勿批次刪除群組，否則排查時將失去原始資料可供比對。

模式與分流：釐清流量入口與規則順序

分清流量接管模式與路由模式

系統代理與 TUN 回答的是「流量如何進入用戶端」；全域、直連和規則分流回答的是「流量進入後要送往哪裡」。這是兩個不同層次的設定。開啟系統代理後，不遵循它的應用程式仍可能直接連網；啟用 TUN 後，規則仍可能讓部分流量直連。排查時先確認應用程式是否進入核心，再確認命中哪個出站，別看到「全域」字樣就忽略應用程式接管是否真正生效。

先使用預設規則建立基準，再決定是否需要修改。全域代理適合短時間排除分流因素，但不會自動修復錯誤的伺服器或解析問題；全域直連適合測試本機網路，但不代表用戶端所有背景請求都沒有獨立設定。長期使用規則分流時，應了解預設出站、區域網路處理及應用程式排除分別在哪裡設定。不同介面的名稱可能有所不同，操作時請以實際規則內容和記錄檔為準。

依照由具體到一般的順序安排規則

常見路由規則會依序比對；前面的規則決定出站後，後續同類規則通常不會再更改結果。因此，特定網域、業務網路和區域網路規則應排在範圍較廣的規則之前。網域規則與 IP 規則並不完全相同：目標網域可能尚未解析，也可能因應用程式或接管方式不同而只能取得 IP。排查前先確認核心實際取得的目標資訊，不能只憑瀏覽器網址列推斷命中結果。

以下是用來理解規則順序的 Xray 路由片段，會將範例網域及其子網域送往代理，並讓常見私有位址直連。這不是完整的用戶端設定，必須合併到含有相應出站標籤的設定中；proxy 和 direct 必須與實際出站標籤相符。圖形用戶端若會自動產生設定，請優先在自訂規則介面中設定相同邏輯，不要直接覆寫每次啟動都會重新產生的檔案。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["domain:example.com"],
        "outboundTag": "proxy"
      },
      {
        "type": "field",
        "ip": [
          "10.0.0.0/8",
          "172.16.0.0/12",
          "192.168.0.0/16"
        ],
        "outboundTag": "direct"
      }
    ]
  }
}

此處的 domain:example.com 用於比對範例網域及其子網域，不能理解為比對任何含有該字串的位址；私有網段規則也不包含所有特殊用途位址及 IPv6 情況。AsIs 不會只為了 IP 規則而強制解析網域，因此網域目標不一定會命中後續的 IP 規則。此片段只表達兩種明確意圖，其餘流量仍由完整設定中的預設行為決定，不可當成完整分流方案直接匯入。

確認規則資源、DNS 與 IPv6

使用 geosite 或 geoip 分類時，規則檔必須存在，且格式和分類名稱須符合目前核心的支援範圍。找不到分類、資源載入失敗和網路連線失敗是不同問題，應先查看啟動記錄檔。不了解資料來源和分類意義時，不要大量新增規則。若要系統性整理，可參閱路由分流設定說明，再依自己的目標網域少量調整，並確保每項規則都有清楚用途。

DNS 決定名稱如何解析，路由決定連線如何送出；兩者彼此影響，但不能互相取代。應用程式可能使用自己的加密解析，也可能先取得 IP 再發起連線；用戶端實際看到的資訊不同，網域規則的效果也可能不同。啟用 TUN 後，應確認解析請求是否走預期路徑，以及遠端解析所需連線是否有可用的出站。不要一次更換所有解析伺服器，應先透過記錄檔確認故障發生在哪個環節。

IPv6 也應視為獨立路徑檢查。裝置取得 IPv6 位址，不代表目前節點、目標和接管規則都支援相同連線方式。只有在雙棧網路發生異常時，才可在受控測試中比較不同位址族的結果；不要把永久停用 IPv6 當成通用故障排除方式。區域網路印表機、檔案共享和內部網域也可能需要直連，加入大範圍規則前應先測試這些本機服務，避免代理設定影響原有網路使用。

每次修改後，使用相同目標重新測試，並確認命中的規則或出站記錄。規則數量增加不代表準確度提升；用途不明的舊規則應先備份再整理。確認一切正常後再儲存為長期設定，並記錄預設出站及還原方式。如果只有某個應用程式繞過系統代理，應優先解決入口層問題，而不是繼續新增網域規則；路由無法處理根本沒有進入核心的連線。

設定疑難排解：沿連線路徑逐層檢查

先分類症狀，再決定檢查方向

把故障描述成可重現的現象：應用程式無法啟動、訂閱更新失敗、核心啟動失敗、只有網域無法存取、只有特定應用程式失敗，或鎖定螢幕與切換網路後斷線。記錄平台、接管方式、目前使用的節點，以及最後一次有效的修改。不要把這些現象都簡化成「不能用」，因為它們發生在不同層次。先關閉流量接管確認基本網路，再用一個節點和一個應用程式重現問題，是最穩妥的排查起點。

應用程式無法開啟時，先處理安裝、架構、系統相依項目及權限；介面正常但核心啟動失敗時，檢查設定解析和本機連接埠；核心正常、應用程式卻沒有連線記錄時，檢查系統代理、應用程式排除和 TUN；已有連線記錄但仍無法使用時，再檢查目標解析、伺服器和協定參數。依這個順序處理，能避免程式尚未啟動就先修改路由，也能避免把訂閱過期誤判為系統權限問題。

查看記錄檔並保留必要前後文

先確認錯誤發生時間，再查看前後幾行，不要只截取最後一個詞。連接埠遭占用通常表示本機程序衝突；驗證或交握失敗可能與憑證、時間、傳輸方式及安全層參數有關；名稱解析失敗則應檢查 DNS 路徑。記錄檔中的逾時只代表某次操作未能在期限內完成，不能直接判定是哪一端故障。搭配請求目標、使用的出站和基本網路測試結果，才能進一步縮小範圍。

需要更詳細的記錄時，可在用戶端提供的記錄層級設定中暫時調整。以下是 Xray 設定中合法的記錄物件範例，不包含伺服器資訊，也不是完整連線設定。圖形用戶端應優先使用介面選項；直接修改自動產生的檔案，可能在重新啟動後失效。info 可協助查看執行情況；若資訊仍不足，再短時間啟用更詳細的層級，問題排除後恢復原設定，避免長期記錄不必要的存取內容。

{
  "log": {
    "loglevel": "info"
  }
}

分享記錄檔前，請刪除訂閱網址、身分參數、伺服器憑證及可識別個人的路徑。保留錯誤類別、時間順序和必要的目標類型，通常就足以討論問題。不要把完整匯出設定直接貼到公開頁面，也不要為了方便讓不熟悉的工具讀取訂閱。需要更多常見問題解答時，可查閱常見問題；補充資訊應聚焦目前故障所在層次，不必一次公開所有設定截圖。

分清延遲、傳輸量與實際可用性

延遲測試只能提供排查線索，不能保證連線可用。TCP 建立連線的結果主要反映連接埠是否可連；實際代理連線測試還會涉及代理交握和測試目標；下載測速則會受到傳輸量、壅塞及並行連線影響。某項數值很低但網頁無法開啟，兩者並不矛盾，因為測試路徑可能不同。比較時應使用相同節點、網路和目標，避免把不同時間、不同協定的結果直接排列後，就判定連線穩定性。

只有一個目標失敗時，先比較其他目標是否正常，再檢查該目標的解析、協定和路由。所有目標都失敗時，優先檢查目前使用的節點和入口；只有一個應用程式失敗時，先檢查該應用程式的設定；只有特定網路失敗時，優先檢查網路驗證、位址族和連線限制。更多測試差異請參閱延遲測試與下載測速說明。不要以反覆測速取代檢視錯誤記錄。

還原設定並確認恢復結果

遇到複雜故障時，依相反順序撤銷最近的修改：先停用新增規則，再還原預設 DNS 和接管模式，最後才考慮重新匯入連線資料。每次還原後，都用相同目標測試並記錄結果。準備重設用戶端前，先備份訂閱、手動新增的節點、路由及應用程式範圍。重新安裝不一定會清除使用者設定，也不一定會還原系統網路設定，因此不適合作為第一個排錯步驟。

最後保留一份已驗證的基本設定與還原記錄。桌面端請確認系統代理能否清除、TUN 能否正常關閉；Android 請確認背景執行、應用程式範圍及常駐策略符合預期。升級前先備份，升級後先做基本測試，再還原複雜規則。需要重新完成整套連線流程時，請回到快速入門教學；需要確認安裝入口時，請回到用戶端下載頁，讓安裝、設定和故障排除各自保持清楚界線。