全平台安裝
與訂閱設定

事前準備與設定範圍

先了解用戶端、核心、訂閱與系統流量接管的差異。用戶端負責顯示介面、儲存群組及產生設定；核心負責實際連線與路由；訂閱網址用來取得伺服器參數；系統代理或虛擬網卡則負責將應用程式流量交給核心處理。這四個環節可能各自出錯。視窗能開啟，不代表核心已啟動；訂閱更新成功，也不代表瀏覽器已使用代理。

確認系統、架構與安裝來源

開啟系統的裝置資訊，記下作業系統、處理器架構和可用儲存空間。桌面裝置不要只憑外觀判斷架構，同一款機型可能搭載不同晶片。前往用戶端下載頁面後，先選平台，再選對應的安裝檔。Windows 桌面版與 WPF 版是不同的介面版本；macOS 需區分 Apple Silicon 與 Intel；Linux 則要確認套件格式。

Android 優先選擇適用於裝置的 arm64 套件；不確定架構時，再查看通用版說明。套件可以下載，不代表系統一定能執行；最低系統需求請以下載頁面和安裝程式提示為準。若架構不符，請回到下載頁面更換套件，不要反覆調整代理設定。安裝錯誤和網路連線錯誤應分開處理。

準備訂閱網址與連線條件

從現有服務的管理頁面複製完整訂閱網址，確認帳戶仍有效、方案允許使用，且裝置數量未超過限制。本網站提供設定說明，不會產生訂閱內容。訂閱網址通常包含帳戶存取憑證，複製後請勿張貼在公開討論區；分享截圖前，也要遮蔽網址、QR Code 和個人備註中的敏感資訊。

分清訂閱網址與單一分享連結。訂閱通常透過網路請求取得一組設定；單一分享連結則直接包含一部伺服器的參數。將單一分享內容貼進訂閱網址欄位，可能會產生格式錯誤；把帳戶管理網頁當成訂閱網址，也可能取得網頁而非節點資料。請使用服務頁面明確標示的用戶端訂閱入口。

檢查網址前後是否混入空格、換行或全形標點。含查詢參數的網址必須完整保留，不能只複製問號前的部分。不要為了縮短網址而刪除參數，也不要將訂閱憑證貼到線上轉換工具。若需轉換格式，請先確認來源、用途，以及完整網址是否會提交給第三方。

建立一次只調整一項設定的驗證流程

啟用系統自動校時，再檢查裝置日期和時區。憑證驗證與部分協定驗證需要正確時間，手動調快時間並不能解決連線錯誤。確認目前網路已完成登入；飯店、校園或訪客網路若尚未通過認證頁面，用戶端可能只會顯示逾時，看起來像是訂閱或伺服器故障。

暫時關閉其他代理和占用虛擬網卡的連線工具，並保留原有設定紀錄。第一次驗證時，只啟用一個用戶端、一部伺服器和一種流量接管方式。先匯入訂閱並確認核心已啟動，再開啟系統代理，最後才嘗試 TUN。這樣發生問題時，就能明確找出是哪一步影響結果，不必同時處理多層規則。

選擇兩個用途明確的測試目標：一個應直接連線的常用網站，以及一個依現有規則應走代理的服務。瀏覽器顯示快取頁面不代表連線正常；測試時請手動重新整理，並查看用戶端記錄檔中的請求。也不要只憑節點旁的測試結果判斷所有應用程式，該結果通常只反映某一種探測請求。

最後確認工作網路或機構裝置的使用規範。受管理的裝置可能限制本機代理、網路延伸功能或管理員權限；若遇到明確的政策限制，請聯絡裝置管理人員。不要關閉系統防護來繞過限制。各平台章節會依下載、安裝、匯入、接管、驗證的順序說明，完成一個步驟後再繼續即可。

Windows：安裝 v2rayN

Windows 請先從對應平台的下載區選擇 v2rayN。桌面版採用跨平台介面，WPF 版則保留傳統桌面操作方式。依照個人使用習慣選擇即可，不必為了匯入訂閱而同時安裝兩個版本。以下會以「訂閱群組」、「系統代理」等功能名稱說明操作；選單位置可能因介面調整而不同。

完成安裝並確認核心可以啟動

執行安裝程式時，請確認目標資料夾可寫入；若下載的是需要解壓縮的版本，請先完整解壓縮，再從目標資料夾啟動。不要直接在壓縮檔預覽視窗中執行程式，也不要只抽出主程式檔案。相關元件和設定檔可能依賴相對路徑，檔案不完整可能造成視窗開啟但核心無法啟動。

首次開啟時先查看記錄區，確認沒有元件遺失、設定解析失敗或埠號遭占用。若程式提示缺少執行環境，請依提示安裝適用於該版本的元件，再重新啟動用戶端。不要從來源不明的網頁下載同名動態連結程式庫放進資料夾；這無法確保相依性相符，也會讓後續排錯失去明確的安裝基準。

一般情況下，系統代理不需要以管理員身分執行。先以一般權限完成匯入和瀏覽器測試，只有啟用需要較高權限的功能時，才依提示操作。若改用管理員身分啟動後設定清單變空，請先確認是否開啟了另一份程式或使用不同的設定資料夾，不要立刻重新匯入並覆蓋既有資料。

新增訂閱群組並更新伺服器

開啟訂閱群組設定並新增群組，在備註欄填寫容易辨識的用途，然後在網址欄貼上完整訂閱網址。啟用該群組的更新選項，先儲存，再執行更新訂閱。自動更新間隔只控制後續重新整理，不會取代首次手動更新。第一次更新請先使用預設 User-Agent；只有服務提供者明確要求時才填入指定值。

更新完成後切回伺服器清單，確認沒有其他群組或搜尋條件篩掉項目。選擇一部伺服器並設為目前使用項目，再查看記錄檔是否產生新設定。若訂閱包含目前核心不支援的欄位，伺服器名稱仍可能顯示，但啟動時會報錯；此時應檢查協定與核心的相容性，不要反覆複製網址。

若更新訂閱提供直連和透過代理兩種方式，第一次可先試用目前網路能存取的方式。透過代理更新需要已有可用連線；所有伺服器都失效時，無法憑空恢復訂閱。保留原有群組並查看更新回應，再決定是否更換取得方式；避免先刪除所有伺服器，導致失去可用的復原路徑。

設定系統代理並確認埠號

選擇自動設定系統代理，讓遵循 Windows 系統代理設定的應用程式使用本機監聽位址。開啟系統設定中的代理頁面，確認手動代理位址和埠號與用戶端目前設定相符。本機埠號不是遠端伺服器的埠號，也不是訂閱網址中的埠號；三者用途不同，不可直接照抄。

選用符合目前需求的路由預設，先用瀏覽器發出新的請求。若瀏覽器仍無法連線，請檢查是否安裝了獨立控制代理的擴充功能，或瀏覽器本身指定了其他位址。系統代理的適用範圍取決於應用程式，不能因為某個程式直連就判定核心失效。若需接管這類程式，請參閱系統代理與 TUN章節。

處理 Windows 特有的關閉與權限問題

啟用 TUN 前，請先儲存正在進行的網路工作，再依用戶端提示提升權限。虛擬網卡建立失敗和無法連上伺服器是兩種不同問題：前者應檢查權限、驅動程式與網路工具衝突，後者才檢查節點和路由。不要一看到錯誤就同時重裝用戶端、刪除網卡並重設系統網路，請先保留完整錯誤訊息。

關閉用戶端時，先清除系統代理，再結束程式。若意外關閉後瀏覽器無法連上網路，請開啟 Windows 代理設定，確認是否仍指向已停止監聽的本機埠號。關閉殘留的手動代理後測試直連；若恢復正常，表示問題出在流量接管狀態，不必因此修改訂閱或刪除所有設定。

最後設定開機啟動時，請區分啟動應用程式與自動啟用流量接管。先驗證重新啟動後的行為，再決定是否自動連線。多人共用的電腦也要在實際使用的帳戶中檢查代理設定。若要移轉設定，請先關閉用戶端並備份，不要直接在兩個執行中的實例之間覆蓋設定檔。

macOS：安裝與網路授權

macOS 使用 v2rayN 前，先開啟「關於這台 Mac」查看晶片。顯示 Apple 晶片的裝置請選 Apple Silicon 版本；顯示 Intel 處理器的裝置請選 Intel 版本。前往macOS 下載區，依晶片選擇套件。架構會影響程式能否執行，不會改變訂閱內容，因此不要用修改協定的方式處理啟動錯誤。

將應用程式安裝在固定位置

開啟磁碟映像檔後，依安裝畫面將應用程式放入「應用程式」資料夾，再從該資料夾啟動。不要長期從已掛載的映像檔或暫存下載資料夾執行。固定的安裝位置有助於系統辨識權限和啟動項目，也能減少更新後出現兩個同名應用程式、誤開舊版本或找不到設定位置等問題。

第一次啟動若出現系統安全提示，請先確認安裝檔來源和應用程式名稱，再到系統設定的「隱私權與安全性」查看可執行的授權操作。不同系統版本的入口可能不同，請以系統實際提示為準。不要大量關閉系統安全機制，也不要為了消除提示而執行來源不明的終端機指令。

啟動後查看記錄檔，確認核心已正常載入。若提示應用程式無法執行，先檢查系統需求、晶片架構和安裝是否完成；若視窗正常但核心報錯，再依錯誤訊息檢查元件或設定。分開檢查這兩個階段，可避免把系統相容性問題誤認為訂閱服務無法使用。

匯入訂閱並建立第一條連線

在訂閱群組設定中新增群組，填寫備註和完整網址，儲存後手動更新。貼上網址時，請確認剪貼簿內容是否來自密碼管理器或富文字網頁，且網址結尾沒有空格。更新完成後選擇目前使用的伺服器，先保留預設連線參數，不要擅自修改訂閱中的傳輸方式、服務名稱或憑證相關欄位。

若更新後出現多個名稱相似的伺服器，請先依服務說明選擇用途，不要認為名稱相同就代表設定完全一致。更新訂閱可能會替換伺服器參數，手動修改的內容也可能在下次更新時被覆蓋。若需要長期使用自訂設定，請建立獨立群組，或使用用戶端支援的持久化規則，並記錄修改原因。

確認目前網路服務的代理狀態

開啟用戶端的系統代理功能後，進入目前網路連線的詳細資訊查看代理設定。macOS 的代理設定與個別網路服務相關，Wi-Fi 和有線網路可能各自保留不同狀態。插上擴充基座或切換網路後，若瀏覽器突然不再使用代理，請先確認目前使用的網路服務，不要立刻更換伺服器。

請分清網頁代理、安全網頁代理和 SOCKS 代理欄位。若用戶端自動設定了其中幾項，請保持設定與其監聽方式一致；不要為了「全部勾選」就把同一個埠號填入所有協定。手動設定代理的應用程式需要明確選擇 HTTP 或 SOCKS 類型；類型與監聽埠號不符時，通常會立即連線失敗。

瀏覽器測試成功後，再檢查實際需要使用的應用程式。有些應用會讀取系統代理，有些使用自己的網路設定，還有些只在啟動時讀取一次。修改代理後，可先關閉並重新開啟目標應用程式，再查看記錄檔是否出現請求。不要把仍在使用的舊連線誤認為新設定未生效。

視需要使用 TUN 並確認復原方式

若所選版本提供 TUN 功能，請依用戶端提示完成必要授權，再查看記錄檔中的虛擬介面和路由初始化結果。系統沒有提供的選項，不要透過複製其他平台的指令強行補上。只有系統代理無法涵蓋目標應用程式時，才需要進一步評估 TUN；日常瀏覽不必先增加流量接管層。

從睡眠狀態喚醒後若連線停滯，先暫停再重新啟用流量接管，並測試目前網路是否已恢復。喚醒時可能同時變更 IP 位址、閘道或 DNS；舊連線失效不代表需要更新訂閱。若每次喚醒都失敗，請記錄問題是否只發生於 TUN、某個網路服務或特定應用程式，以縮小排查範圍。

關閉或解除安裝前，先關閉 TUN 和系統代理，並在目前網路服務中確認沒有殘留設定。接著測試直連，確認恢復正常後再移除應用程式。若要保留設定，請另外備份，但不要公開分享整個設定資料夾。切換網路後若持續斷線，可參考疑難排解，繼續檢查權限和流量接管衝突。

Linux：套件與桌面代理

Linux 請先確認發行版使用的套件系統和裝置架構，再前往Linux 下載區選擇 v2rayN。常見 Debian 系發行版使用 deb，常見 RPM 系發行版使用 rpm；同一格式也可能分為 x64 和 arm64。桌面圖形用戶端需要可用的桌面環境，不能把「套件可以解壓縮」當成圖形程式已具備執行條件。

透過系統套件管理器安裝

建議先使用發行版的軟體安裝程式開啟下載套件，讓套件管理器處理相依性。若安裝程式提示缺少相依套件，請先查看缺少的項目和系統版本支援情況，再透過發行版的正式軟體來源處理。不要混用其他發行版的軟體來源，也不要強制忽略相依性安裝，否則後續可能造成視窗無法啟動或系統元件衝突。

可使用下方指令確認架構。這只會顯示本機的機器類型，不會修改系統設定。常見輸出中的 x86_64 對應常見的 x64 套件，aarch64 則對應常見的 arm64 套件。若在容器、遠端桌面或相容層中執行，還要區分主機系統與實際執行環境；不要只憑主機硬體名稱選擇套件。

uname -m

安裝完成後，從桌面選單啟動，並先以一般使用者身分執行。若視窗無法開啟，可在終端機啟動已安裝的程式以查看錯誤，但不要為了繞過錯誤而直接以管理員帳戶執行整個圖形用戶端。一般帳戶和管理員帳戶的設定資料夾不同，混用會造成訂閱、權限和檔案擁有者設定混亂，後續更難維護。

匯入訂閱並檢查本機監聽

開啟訂閱群組，新增備註和網址，儲存並更新，接著選擇目前使用的伺服器。確認核心已啟動後，再設定桌面代理。若記錄檔提示埠號遭占用，請先關閉其他代理程式和重複執行的實例。常見預設範例埠號可用下方指令查看監聽狀態；若本機設定不同，請改用實際埠號。

ss -ltnp 'sport = :10808'
ss -ltnp 'sport = :10809'

指令沒有輸出，可能表示該埠號沒有監聽，也可能是用戶端使用了其他埠號；部分程序的詳細資訊也可能受權限限制。請先確認用戶端設定，不要只憑範例埠號推斷故障。一般本機使用應優先繫結至回送位址；只有明確需要讓區域網路裝置使用時，才評估開放監聽和設定防火牆規則。

分清桌面代理與終端機環境變數

不同桌面環境儲存系統代理設定的方式各異，用戶端的自動設定不一定涵蓋所有應用程式。開啟系統代理後，請到桌面網路設定確認模式和埠號，再用瀏覽器驗證。是否顯示系統匣圖示，與核心是否正常運作是兩回事；若沒有系統匣支援，請透過視窗和記錄檔確認執行狀態。

終端機程式通常有自己的代理讀取方式，不一定遵循桌面設定。需要測試時，可只為單一指令指定代理，避免先修改整個登入環境。以下範例假設 HTTP 監聽埠號為 10809、SOCKS 監聽埠號為 10808；實際使用前請先確認埠號。測試目標只會回傳網頁，不代表所有業務協定都能使用。

curl --proxy http://127.0.0.1:10809 --head https://example.com
curl --proxy socks5h://127.0.0.1:10808 --head https://example.com

第二行中的 socks5h 表示由代理端解析目標網域，與某些本機解析方式不同。若終端機測試成功但瀏覽器失敗，請優先檢查桌面代理或瀏覽器設定；若兩者都失敗，再檢查監聽、目前使用的伺服器和記錄檔。已設定環境變數的終端機，即使桌面代理已關閉，仍可能繼續連線至本機埠號。

謹慎處理 TUN、權限與預設路由

是否能啟用 TUN，取決於用戶端版本、系統能力和授權方式，請依實際介面提示操作。若無法建立虛擬介面，先查看記錄檔是否指出權限或裝置支援問題，不要讓整個程式永久以高權限啟動。遠端連線裝置尤其要保留復原方式；修改預設路由可能會中斷目前使用中的遠端工作階段。

若已安裝其他 VPN、容器網路或額外的防火牆管理工具，請逐一確認路由和規則的來源。不要直接清空系統防火牆來嘗試恢復連線，這可能會影響其他服務。關閉用戶端後再測試直連，並檢查桌面代理和終端機變數是否殘留；必要時重新開啟終端機，在乾淨的工作階段中重新驗證。

升級前備份訂閱群組和自訂規則，並使用相同的套件管理方式更新。若更新後只有介面異常，先記下桌面環境和錯誤輸出，不要立刻刪除設定；若核心解析失敗，則檢查自訂參數是否仍受目前版本支援。分開記錄圖形介面、套件和網路問題，才能判斷需要回復哪一層。

Android：訂閱與 VPN 授權

Android 優先使用 v2rayNG，採用 Xray 核心；若需要 V2Fly 核心且設定相容，可選擇 v2flyNG 作為替代方案。前往Android 下載區後，先下載適用於裝置的 arm64 套件；若不確定或裝置情況特殊，再查看通用版。不要為了比較介面而同時啟動兩個用戶端的連線服務。

安裝應用程式並處理系統授權

從下載檔案開啟安裝程式時，系統可能會要求允許目前的檔案來源安裝應用程式。確認來源後，只需視需要授權這次使用的瀏覽器或檔案管理器。若安裝失敗，先查看系統提示：儲存空間不足、架構不符、系統需求未達標和既有應用程式簽章衝突，分別需要不同處理方式，無法靠重新匯入訂閱解決。

若已有同名應用程式，請勿在未備份的情況下直接解除安裝。先確認能否正常覆蓋安裝，以及現有訂閱和規則是否已儲存。若系統明確提示簽章不一致，請核對安裝來源並停止混裝。解除安裝時可能會一併刪除應用程式資料，僅憑伺服器名稱無法完整還原訂閱網址和本機設定。

建立訂閱群組並選擇目前使用的伺服器

開啟訂閱設定並新增項目，填入備註和網址，啟用更新後儲存，再執行更新訂閱。有些介面會將伺服器清單和訂閱管理分開，請確認更新的是目標群組。若剪貼簿內容是單一分享連結，請使用對應的匯入功能，不要貼到需要透過網路取得資料的訂閱網址欄位。

更新成功後返回清單，選擇一部伺服器作為目前使用項目，再啟動連線。備註只影響顯示，不會參與驗證；網址、埠號、使用者識別碼、傳輸和安全參數則必須與伺服器端相符。不要因為名稱標示某種用途，就認定它支援所有協定或應用程式。服務提供者更新訂閱後，也請重新確認目前使用的項目仍然存在。

設定中的「允許不安全連線」不是修復網路錯誤的通用開關。遇到憑證錯誤，請先檢查系統時間、目標網域和服務說明，並保留憑證驗證。任意關閉驗證會改變連線的安全性，也無法解決網址失效、埠號無法連線或帳戶停用等問題。

了解本機 VPN 流量接管與應用程式範圍

第一次連線時，系統通常會顯示 VPN 連線要求。確認要求由剛安裝的用戶端發出後，再授權連線。這項授權是為了在裝置上建立流量接管通道，不代表遠端伺服器已確認可用。系統出現連線圖示後，仍需實際發出請求並查看應用程式記錄檔，確認核心已完成連線。

Android 的本機 VPN 機制與桌面系統代理設定不同，不必照抄 Windows 代理頁面的欄位。系統通常只允許一個此類 VPN 服務同時執行，其他使用相同機制的網路工具可能會搶占連線。若連線自動中斷，先確認是否啟動了其他服務，不要先刪除訂閱。

若啟用應用程式分流，請確認目前模式是「僅讓選取的應用程式使用代理」，還是「讓選取的應用程式略過代理」。兩種清單的意思相反，若理解錯誤，可能會造成瀏覽器可用、其他程式無法連線。調整範圍後請重新建立連線，再開啟目標應用程式；必要時先以不篩選應用程式的基本設定測試。

檢查網路切換、休眠與網域解析

從 Wi-Fi 切換到行動網路後，原有連線可能需要重新建立。先確認行動數據本身可用，再重新連線用戶端；若某個 Wi-Fi 可用而行動網路失敗，請記錄網路差異，並檢查是否與 IPv6、目標埠號或 DNS 路徑有關。不要把自動重新連線當成無限重試；持續失敗時，請先暫停並查看第一筆相關錯誤。

系統私人 DNS、應用程式自帶的加密 DNS 和用戶端 DNS 可能同時存在，但用途未必相同。若網域解析失敗而其他請求正常，先記錄這些設定，再逐項驗證。不要同時修改所有解析入口，否則即使連線恢復，也無法判斷是哪項設定造成影響。

最後測試停止連線後的狀態。若啟用了「永遠開啟 VPN」或「封鎖未經 VPN 的連線」，停止用戶端後可能仍無法直接連線，這是系統策略造成的結果。請依實際需求保留或調整策略，不要誤認為網路已損壞。更換用戶端前，先停止舊服務，再匯入新應用程式，並分別驗證協定支援和背景穩定性。

系統代理、TUN 與流量接管

先判斷應用程式如何傳送流量，再選擇接管方式。系統代理通常只是告訴應用程式「代理入口在哪裡」，應用程式是否使用仍由本身決定；TUN 則透過虛擬網路介面和路由，將符合條件的流量交給處理程式。兩者都不是遠端伺服器，也不會直接決定某個網域最後採用直連或代理，這主要由路由規則控制。

分清流量接管範圍與出口規則

「開啟系統代理」和「使用全域路由」是兩種不同操作。前者決定應用程式的請求是否進入用戶端；後者決定請求進入後要選擇哪種出口。只修改全域路由，無法強制忽略系統代理的應用程式改變網路路徑；只開啟 TUN，也不代表所有請求必定經過遠端代理，直連規則仍可能生效。

常見的清除系統代理、自動設定系統代理和不變更系統代理，可視為不同的管理操作。清除通常會移除目前由用戶端管理的系統代理設定；自動設定會寫入用戶端的監聽入口；不變更則保留目前的系統狀態。實際行為請以用戶端提示為準，尤其已有機構政策或手動設定時，操作前請先記錄原有值。

逐步啟用並縮小影響範圍

先確認使用系統代理的瀏覽器能正常連線，再測試目標應用程式是否遵循設定。若目標應用程式能手動設定代理，可先使用本機 HTTP 或 SOCKS 入口，確認核心和伺服器正常。如此一來，即使後續 TUN 失敗，也能將問題範圍縮小到系統接管層，不必重新懷疑整條訂閱連線。

啟用 TUN 前，請先關閉其他同類型的流量接管工具並儲存工作，再依提示授予必要權限。啟動後查看介面是否建立、路由是否安裝，以及 DNS 是否初始化。某些版本可能使用不同的輔助元件，請勿跨平台照抄驅動程式處理步驟。若記錄檔停在介面初始化階段，應先排查本機問題。

是否需要同時啟用 TUN 和系統代理，取決於用戶端實作和使用情境，不宜一概而論。基本測試時盡量只保留一種主要接管路徑；若需同時使用，請確認本機代理連線不會再次遭到錯誤接管。若發生連線反覆重試、資源使用異常或出口不斷變化，請先退回單一路徑排查。

檢查 UDP、區域網路與虛擬網路

能瀏覽網頁不代表 UDP 應用程式也能使用。目標應用程式是否使用 UDP、所選協定與伺服器是否支援，以及用戶端是否接管相關流量，都必須符合需求。不要看到 UDP 失敗就改用全域路由；規則只能選擇出口，無法補足伺服器未提供的功能。請先確認服務說明，再檢查記錄檔中的連線類型。

印表機、檔案共享和區域網路管理頁面通常需要保留本機連線路徑。啟用 TUN 後若無法使用這些資源，請先檢查區域網路位址是否被錯誤送往遠端，再查看用戶端的排除規則。機構內網可能使用多個私有網段，不能只處理家用路由器所在的網段就認為設定完整。

虛擬機器、容器和其他 VPN 也可能新增網卡、DNS 與路由。發生衝突時，請記錄目前啟用的網路工具，並逐一暫停測試，不要清空所有路由。遠端工作或遠端管理時尤其要謹慎：修改接管規則前，請確認有本機復原方式，避免連目前工作階段依賴的路徑也一併改掉。

依請求路徑判斷結果

驗證時分別檢查應用程式、監聽入口、路由比對和遠端連線。若應用程式的請求沒有出現在記錄檔中，請優先檢查流量接管；若請求已進入但比對到直連規則，請檢查路由；只有比對到代理後仍連線逾時，才繼續檢查伺服器和網路。詳細的使用範圍可參考v2rayN TUN 模式說明，不要把 TUN 當成解決所有連線問題的方法。

關閉連線後，再用同一個應用程式測試一次，確認結果符合預期。瀏覽器可能會重用長連線，有些應用程式也會保留連線池；必須重新建立請求才能觀察新的路徑。先記錄一組成功的基準設定，再逐項加入自動啟動、應用程式範圍或複雜的排除規則，比一次啟用所有功能更容易維護。

路由分流與 DNS 搭配設定

路由負責為已進入核心的請求選擇出口；DNS 負責將網域解析為位址。兩者會互相影響，但不能混為一談。先確認使用需求：哪些服務直連、哪些經過代理、哪些需要封鎖，再選擇符合需求的預設。第一次設定時，不要將來源不明的大型規則集整份覆蓋到目前設定中。

先使用預設建立穩定基準

全域、繞過中國大陸和黑名單等名稱都是用戶端的預設模式，實際內容可能隨規則資源和設定而改變。全域模式通常會讓一般目標使用代理，但仍可能保留必要的本機例外；繞過中國大陸取決於網域與位址分類；黑名單的實際涵義則要查看規則內容，不要只憑名稱推斷所有目標的連線方式。

切換預設後，分別使用準備好的直連和代理目標發出請求，並查看路由比對結果。不要只測試出口位址，因為它只反映該次請求的路徑。同一個應用程式可能同時連線至驗證、內容和更新等多個網域；若首頁正常但某項功能失敗，應檢查實際失敗的請求，而非立刻將整組設定切換為全域。

了解規則順序與網域比對

多數規則會依序判斷，先符合的規則就會決定處理方式。為單一目標新增例外時，應放在可能涵蓋該目標的廣泛規則之前。網域規則通常比任意指定某個解析 IP 更容易維護，因為服務位址可能變動；但若應用程式直接連線至 IP，網域規則就可能沒有比對依據，需要另外檢查。

以下是 Xray 風格的路由片段，用來示範私有位址和指定網域直連。這不是可單獨執行的完整設定；出口標籤必須與現有設定一致。圖形用戶端通常會產生設定，建議優先透過其路由編輯介面設定相同規則；不要直接覆蓋執行時檔案，以免下次啟動時重新產生而遭覆蓋。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "domain": ["domain:example.com"],
        "outboundTag": "direct"
      }
    ]
  }
}

其中 domain 比對可涵蓋指定網域及其子網域；若要比對完整主機名稱，可考慮使用 full。geosite 和 geoip 則需要相應的資源檔，分類名稱也必須確實存在。AsIs 並不代表「永遠不解析網域」，它描述的是路由階段採用的策略；其他連線和 DNS 階段仍可能進行解析，不能只憑單一欄位判斷完整請求路徑。

分別檢查目標解析與伺服器解析

用戶端可能需要解析使用者要連線的目標網域，也可能需要先解析代理伺服器本身的網域。若伺服器網域解析依賴尚未建立的代理通道，就可能形成啟動循環。若啟動時持續解析失敗，請先確認是哪個網域；不要不加區分地將所有 DNS 請求強制送進尚未可用的代理。

系統、瀏覽器和用戶端都可能有 DNS 設定。瀏覽器啟用獨立的加密解析後，用戶端記錄檔中未必會出現預期的系統 DNS 請求；啟用 TUN 後，用戶端又可能接管部分解析流量。排錯時請先釐清由誰發起解析、由誰回應，以及請求經過哪條路徑，再決定要調整哪一層。

修改規則或 DNS 後，舊快取和既有連線可能仍在生效。請先發出新的請求，必要時重新啟動目標應用程式，再觀察結果。不要因為重新整理一次頁面沒有變化就繼續增加規則；太多臨時修改會讓真正的解析問題被複雜路由掩蓋，也難以判斷復原時哪些設定需要保留。

處理 IPv6 與分流範圍

同時支援 IPv4 和 IPv6 的網路中，應用程式可能優先使用不同的位址類型。若某個網域時好時壞，請記錄記錄檔中的目標位址，並確認對應路徑都能使用。暫時限制使用某一種位址類型有助於定位問題，但不應未經分析就長期停用 IPv6，尤其是在依賴 IPv6 的網路環境中。

組織內部網域通常需要使用組織提供的解析路徑；公用 DNS 服務未必能查到內部記錄。若內部網頁無法開啟，請同時檢查網域解析和內網路由，不要只新增直連規則。反過來說，解析正確也不代表路由可達，兩個環節都必須分別驗證。

每次只新增一條目標明確的規則，標註用途並保留修改前的設定。先閱讀中國大陸與海外分流設定建立預設基準，再依照自訂規則語法處理例外。規則越明確，驗證目標越清楚；服務位址變動時，也更容易找出需要維護的項目。

常見設定問題與排錯順序

排錯時先描述現象，再決定要修改哪個環節。記下平台、用戶端、流量接管方式、目前使用的伺服器，以及發生錯誤時的操作，例如「更新訂閱失敗」或「啟用 TUN 後無法連線內網」。不要只寫「連不上」，因為取得訂閱、啟動核心、接管流量和連線遠端服務各屬不同階段，需要的診斷資訊也不一樣。

訂閱更新失敗或沒有伺服器

先檢查網址是否完整和帳戶狀態，再查看更新結果是網路錯誤、網頁內容還是解析錯誤。網路錯誤應優先檢查目前的取得方式；網頁內容可能是登入頁或錯誤頁；解析錯誤則應檢查訂閱格式和用戶端支援情況。收到內容不代表內容一定是有效訂閱，不要只憑「下載成功」就判定正常。

更新後清單為空，請先清除搜尋條件並切換至目標群組，確認該群組允許更新。保留更新前的設定，不要連續刪除再重建。若只有部分伺服器消失，可能是服務提供者調整了訂閱，或特定設定無法解析。記下未顯示的類型和錯誤訊息，再比對服務說明，不要自行編造節點參數。

核心啟動失敗或本機埠號異常

找出本次啟動後最早出現的相關錯誤。埠號遭占用時先檢查是否有重複執行的實例；設定欄位錯誤時先還原最近的修改；檔案遺失時先確認安裝是否完整。後續大量連線失敗可能只是最初啟動錯誤造成的連鎖結果；逐一處理後續逾時，無法修復未啟動的核心。

若使用多種發行版本，請確認目前執行的路徑，避免在一份程式中修改設定，實際啟動的卻是另一份。升級後不要立刻以整個舊資料夾覆蓋新程式，應先確認基本啟動正常，再依用戶端支援的方式還原設定。執行檔、執行元件和使用者設定應分開看待，並非所有檔案都是設定檔。

瀏覽器可用，但其他應用程式失敗

先確認目標應用程式是否讀取系統代理，以及是否設定了獨立代理或應用程式排除規則。記錄檔沒有出現對應請求時，通常應先檢查應用程式到用戶端之間的接管；若已有請求且明確比對到代理，再檢查協定、遠端連線和應用程式本身的功能。需要使用 TUN 時，請依前一章逐步啟用，不要先修改訂閱中的驗證欄位。

網頁可用，但語音、遊戲或即時功能失敗時，請繼續檢查 UDP 和服務支援情況，不要以網頁測試結果代替其他協定的驗證。下載工作失敗也可能與應用程式內建的網路堆疊或多個網域有關。記下具體失敗的功能和時間，再查看前後相關記錄，比不斷切換伺服器更有助於找出問題。

交握錯誤、逾時與部分功能失敗

遇到憑證或交握錯誤，先檢查系統時間、伺服器名稱和訂閱是否為最新版本，再確認目前核心是否支援相應參數。REALITY 設定中的公鑰、服務名稱和相關識別資訊必須與伺服器端一致，不要憑經驗任意替換。伺服器參數有變更時，請先更新訂閱並聯絡服務提供者確認，而不是關閉安全驗證。

連線逾時時，請分辨是伺服器位址無法連線、目標存取逾時，還是 DNS 逾時。若只在某個網路環境失敗，記下 Wi-Fi、行動網路或有線連線的差異；若只在某部伺服器失敗，請在相同流量接管和路由設定下比較其他伺服器。固定其他條件才能進行有效比較，否則結果難以判讀。

保留診斷資訊並還原可用基準

準備回報問題時，請保留錯誤發生時間、操作步驟和已遮蔽敏感資訊的記錄。移除訂閱網址、使用者識別碼、QR Code 和帳戶資訊；記錄中的目標網域也可能暴露個人使用內容，請依需求裁切。不要為了求助而直接打包整個設定資料夾，更不要將含有憑證的備份上傳到公開位置。

還原時先撤回最近一次修改，再回到單一用戶端、單一伺服器和單一流量接管方式的基準。簡單記錄成功的設定，之後再逐項恢復自訂規則和自動啟動。一般問題可繼續參閱疑難排解；若要重新依序操作，請返回快速入門教學，不必先重新安裝整套環境。