v2rayN 全平台設定指南

準備工作：安裝套件與訂閱資料

先分清楚客戶端、核心與服務端

v2rayN 是桌面圖形介面客戶端，可用來管理伺服器、訂閱群組、代理模式與路由規則；實際建立連線的是客戶端呼叫的代理核心。Windows、macOS、Linux 優先使用 v2rayN；Android 則建議使用採用 Xray 核心的 v2rayNG，也可選擇採用 V2Fly 核心的 v2flyNG。圖形介面客戶端不提供服務，安裝程式不會自動建立可用伺服器，也不會自動取得訂閱權限。開始設定前，請先準備服務提供者提供的有效訂閱網址，或包含完整連線參數的分享連結。

訂閱是一組可更新的設定資料，不是網站帳號密碼。請確認服務仍在有效期限內、是否有流量限制，以及同時連線裝置數量是否受限。只有伺服器位址和連接埠通常不足以還原設定，可能還需要使用者識別碼、傳輸方式、TLS 參數、服務名稱等資訊。請勿照著網路上的零散範例自行補上缺少欄位；錯誤的組合可能成功儲存，卻無法完成遠端交握。訂閱網址含有存取憑證，複製時請保留完整內容，分享截圖時則應遮住整個網址。

確認系統架構，保留還原方式

前往安裝套件頁面，依作業系統選擇下載項目，再確認處理器架構。Windows 提供 x64 桌面版和經典 WPF 版；macOS 分為 Apple Silicon 與 Intel；Linux 則有 deb、rpm，以及 x64、arm64 版本；Android 提供 arm64 與通用版。檔案能下載，不代表一定能在這台裝置上執行。系統版本與執行環境需求請以安裝套件說明為準；較舊的系統應先確認相容性，不能只因客戶端名稱相同就直接覆蓋安裝。

初次設定前，記下目前是否啟用其他代理、VPN、手動 DNS 或瀏覽器代理擴充功能。多種流量接管工具同時運作時，流量可能繞道，也可能形成迴圈。除錯期間一次只保留一條明確的代理路徑。已安裝客戶端的裝置，請先匯出必要設定，並記下原本的本機連接埠、訂閱群組和自訂路由；備份也可能含有憑證，請存放在受控的本機資料夾。升級與切換介面版本應分開進行；保留可還原的舊設定，比反覆覆蓋更容易找出問題。

建立最基本的驗證流程

先開啟客戶端但不要啟用 TUN，確認核心能正常啟動；接著匯入訂閱、更新伺服器並指定一個啟用中的設定；然後啟用系統代理，使用會遵循系統代理設定的瀏覽器造訪目標網站。這條基本路徑確認可用後，再加入 TUN、自訂 DNS 或複雜分流。依序測試能將安裝、訂閱與流量接管問題分開，避免同時變更多個項目後無法判斷是哪個步驟生效。

系統時間也是準備工作之一。日期、時區或時間同步異常，可能導致憑證驗證及部分協定認證失敗。測試時，請選一個平時可直接連線的頁面作為直連對照，再選一個預期經代理連線的目標，分別記錄結果。測速成功只代表通往測試目標的路徑可用，不代表所有網站和應用程式都會走代理。後續驗證應參考核心記錄、實際頁面連線與出口資訊，不要只看系統匣圖示或連線按鈕的顏色。

Windows：v2rayN 安裝與初始設定

安裝介面版本，確認核心能啟動

在Windows 下載頁面選擇 v2rayN。桌面版採用跨平台介面，WPF 版則是經典 Windows 介面，兩者的選單位置與設定資料夾可能不同。初次使用可先選桌面版；若已習慣 WPF 版，也可以繼續使用對應版本。依安裝程式指示完成安裝；若下載的是需要解壓縮的版本，請先完整解壓縮至固定資料夾再執行程式。不要直接從壓縮檔預覽視窗啟動，也不要只複製主程式而遺漏相依檔案。

一般系統代理通常不需要一直以系統管理員身分執行。初次啟動若提示缺少執行環境，請依程式指示安裝相應元件，不要誤以為是節點失效。開啟記錄區，確認客戶端呼叫的核心沒有立即結束；若啟動失敗，先查看安全軟體的封鎖記錄、資料夾寫入權限，以及是否有同名程序殘留。請勿為了排錯而關閉所有系統防護，應根據明確的檔案來源和錯誤訊息處理。程式若放在暫存下載資料夾，清理後容易遺失相依檔案或設定，建議移至固定位置。

訂閱群組、伺服器與系統代理

開啟訂閱群組設定，新增一個以來源命名的群組，將完整訂閱網址貼到網址欄位並儲存。返回主畫面後更新訂閱；若介面提供不同更新方式，初次使用可優先選擇不透過目前代理更新，避免客戶端尚未連線，卻必須透過自身取得設定。更新完成後，確認伺服器已加入預期群組，再選擇一個伺服器作為目前使用的設定。只在清單中反白一列不一定代表已啟用，請使用目前介面中的設為活動伺服器功能，並確認狀態已變更。

執行真實連線測試，觀察失敗原因，不要只按清單排序。選好可用伺服器後，將系統代理設為「自動設定系統代理」，再使用一般瀏覽器測試。路由可先選擇「繞過大陸」等內建預設，減少初次設定的項目；需要明確對照時，可暫時切換全域代理規則測試同一目標，但請記得系統代理和路由屬於不同層次。前者決定哪些應用程式將請求交給本機代理，後者決定核心收到請求後選擇哪個出口。瀏覽器代理擴充功能可能會覆寫系統設定，測試前請先暫停擴充功能。

TUN 權限與 Windows 特有問題

只有在確認系統代理路徑可用，而目標應用程式又不遵循系統代理時，才考慮啟用 TUN 模式。依目前客戶端提示申請系統管理員權限、安裝必要元件或啟動所需服務，再檢查虛擬網卡與核心記錄。允許提高權限不代表可以忽略啟動錯誤：即使 TUN 未成功建立，客戶端視窗仍可能正常顯示。遇到虛擬網卡建立失敗或權限不足，請先結束殘留程序並改用一般系統代理測試；不要反覆安裝網卡元件，也不要任意刪除實體網卡或系統路由。

本機連接埠被占用時，核心通常會回報監聽失敗。先從客戶端設定確認實際連接埠，再於系統中查詢占用程序，確認是否為另一個客戶端執行個體。變更連接埠後，曾手動設定代理的應用程式也要同步更新，否則仍會連到舊連接埠。電腦從睡眠恢復，或切換有線與無線網路後失去連線，請先停用 TUN 並重新連線，確認網路本身已恢復，再檢查代理。手動連線穩定後再設定開機自動啟動，並確認登入後沒有兩個介面版本同時接管代理。

正常結束前，請先停用 TUN，再使用「清除系統代理」還原一般網路。若異常關機後所有網頁都無法開啟，請檢查 Windows 代理設定是否仍指向已停止的本機監聽連接埠。這裡要清除的是殘留代理，而不是重設整套網路設定；若裝置受組織原則管理，請勿覆寫組織指定的代理。更完整的初次安裝說明請參閱v2rayN 初次安裝與初始設定；排錯時也可對照其中的資料夾與啟動檢查項目。

macOS：晶片選擇、權限與代理還原

選擇符合晶片的安裝套件

先在系統的「關於這台 Mac」查看處理器資訊。顯示 Apple 晶片的裝置請選擇 Apple Silicon 安裝套件；顯示 Intel 處理器的裝置則選擇 Intel 安裝套件，請前往macOS 安裝套件下載。下載磁碟映像檔後開啟，依提示將應用程式移至「應用程式」資料夾，再從固定位置啟動。不要長期從暫時掛載的映像檔執行程式，否則卸載映像檔後，登入項目或捷徑可能會指向不存在的位置。完成安裝後再處理首次啟動提示，避免同時進行安裝、更新與權限調整。

遇到系統安全性提示時，先確認套件是從所選下載頁面取得，再依「隱私權與安全性」中的具體提示決定是否允許開啟。不要為了啟動單一應用程式而關閉整體安全機制，也不建議執行來源不明的終端機指令來解除限制。安裝套件架構不符、系統版本不符合需求，以及應用程式損毀，是不同問題，應分別確認。視窗開啟後，還要確認核心能正常啟動；圖形介面可執行，不代表核心程序或 TUN 所需元件已取得執行權限。

匯入訂閱並驗證系統代理

在 v2rayN 中建立訂閱群組，填入備註和完整訂閱網址，儲存後更新訂閱。若更新失敗，先在未啟用 TUN 的情況下檢查目前網路和網址是否有效；不要把訂閱連結貼到一般伺服器位址欄位。更新成功後選擇目前使用的伺服器，執行真實連線測試，再開啟自動設定系統代理。測試瀏覽器時，確認沒有獨立代理設定或擴充功能接管請求。切換網路前後可使用同一個目標頁面對照，避免因測試目標不同而誤判客戶端狀態。

macOS 的代理設定通常會對應到特定網路服務。有線網路、無線網路及其他網路介面可能各自有不同設定，切換介面後請重新確認目前使用的服務是否仍指向預期的本機連接埠。工作裝置也可能受到設定描述檔或管理原則控管；若客戶端無法自由覆寫設定，請先確認限制來源。系統代理只會影響遵循這些設定的應用程式，終端機工具和部分應用程式有自己的連線方式。不要因為瀏覽器已可使用，就認定終端機中的所有程式也經過相同代理路徑。

TUN、睡眠恢復與結束處理

需要擴大流量接管範圍時，再依介面指示設定 TUN 權限或輔助服務。不同封裝方式可能採用不同權限流程，請依目前程式提示操作，不要照搬其他平台的系統管理員操作。啟用後確認核心持續運作，並留意是否出現路由建立、裝置存取或 DNS 相關錯誤。若另一個 VPN 正在使用預設路由或 DNS 設定，請先中斷衝突連線再測試。不要同時使用多個工具並反覆切換預設出口，否則客戶端記錄將難以對應實際流量路徑。

合上筆電進入睡眠後，網路介面、閘道和 DNS 都可能改變。先確認直接連線正常，再重新建立代理連線；如果只有 TUN 模式失效、系統代理正常，應優先檢查虛擬介面與路由是否恢復，而不是立刻重新匯入訂閱。連線到需要網頁登入的公共網路時，通常要先停用流量接管，完成網路認證後再恢復代理。認證頁面無法開啟不一定是伺服器故障，也可能是本機網路尚未允許裝置連上網際網路；此時反覆更換伺服器不會改善情況。

關閉視窗不一定代表已結束客戶端，請檢查選單列狀態和背景程序。需要恢復一般網路時，先關閉 TUN，再清除客戶端設定的系統代理。若客戶端異常結束，請進入目前網路服務的代理設定，確認是否殘留本機代理位址；只移除本次客戶端設定的項目，保留原有的組織設定。連線流程穩定後再加入登入項目；升級後若舊程式仍留在背景，請先結束舊的執行個體，再開啟新安裝的應用程式，避免同一連接埠被重複監聽。

Linux：套件、桌面環境與執行權限

依發行版選擇套件格式與架構

前往Linux 下載頁面選擇 v2rayN。deb 適用於採用相應套件管理系統的發行版，rpm 則適用於使用對應系統的發行版；此外還要確認 x64 或 arm64，不能只因副檔名相同就安裝。可在終端機執行下方指令查看電腦架構與系統資訊：常見的 x86_64 對應 x64，aarch64 對應 arm64。系統名稱與處理器架構是兩項獨立資訊；若在容器、相容層或遠端工作階段中執行，還須依實際執行環境判斷。

uname -m
cat /etc/os-release

優先使用發行版的軟體安裝程式或套件管理工具安裝本機套件，讓系統處理相依性。若提示缺少圖形執行元件，先查看具體的相依套件名稱，不要強制忽略相依性繼續安裝。安裝成功但視窗無法開啟時，可從終端機啟動已安裝的應用程式並查看錯誤輸出；先區分顯示環境、執行程式庫與核心啟動問題。不要讓整個圖形介面客戶端長期在系統管理員工作階段中執行，否則可能造成設定檔權限不一致，也會擴大後續操作的影響範圍。

匯入訂閱與桌面代理差異

開啟 v2rayN 後，先匯入訂閱並更新伺服器，選擇目前使用的設定，確認核心能監聽本機連接埠後再設定代理。不同 Linux 桌面環境的系統代理實作方式各異：有些提供統一的網路代理面板，有些應用程式只讀取自身設定或環境變數。因此，即使「自動設定系統代理」操作成功，也不代表所有桌面程式都會遵循。請先用明確支援所選代理類型的瀏覽器測試，再檢查未生效應用程式的代理設定，避免一開始就擴大整個系統的接管範圍。

終端機中的 HTTP 工具可明確指定代理，用來區分代理連線問題和桌面設定問題。例如，下方指令只適用於已確認客戶端的 HTTP 或混合監聽連接埠為 10808 的情況；若實際連接埠不同，請先修改指令再執行。這項操作會讓本次請求透過本機代理連線至範例網站，不會變更系統代理，也不會轉送其他程式的流量。請比對回應狀態、連線錯誤與客戶端記錄，不要只因指令執行結束就認定代理已生效。

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

若曾為終端機設定代理環境變數，測試時請記錄變數的作用範圍。終端機工作階段中的變數不一定會傳給已開啟的圖形介面應用程式，圖形介面應用程式的設定也不一定會傳給終端機。結束客戶端後若仍保留這些變數，指令就會持續連線到已停止的本機連接埠。排錯時先比對明確指定代理的測試結果，再決定是否調整目前工作階段設定；不要只為了讓單一指令可用，就在全域啟動檔案中加入來源不明的代理變數。

TUN、DNS 管理與權限範圍

Linux 的 TUN 需要虛擬網路裝置、路由操作權限，以及客戶端目前採用的啟動方式。請依照客戶端文件或介面提供的權限流程設定，先查看記錄是否指出裝置不存在、權限不足或路由衝突。不要為所有程式一律開放權限，也不要在不了解影響的情況下修改可執行檔權限。容器、受限制的桌面工作階段和遠端環境可能沒有可用的虛擬裝置或網路管理權限，此時應改用應用程式層級的代理，而不是不斷重新啟動圖形介面。

DNS 也可能同時受到網路管理服務、系統解析服務或手動設定的檔案影響。啟用 TUN 後若網域名稱解析失敗，但既有連線正常，請先檢查客戶端的 DNS 設定與系統解析路徑，再確認是否有其他服務覆寫設定。不要直接清空系統解析設定，因為它可能由網路服務自動產生，重新連線後又會改變。中斷 TUN 後，請確認預設路由和 DNS 是否已恢復；關閉客戶端後再測試一般網路，有助於區分遠端故障與本機殘留狀態。

需要在開機或登入後自動啟動時，請先確認圖形工作階段、金鑰儲存區與網路都已就緒。登入時自動啟動與背景服務是不同的執行方式，沒有明確需求時不應同時啟用。升級後若一般使用者無法寫入設定，請檢查是否曾以較高權限執行，導致資料夾擁有者改變；修復前先備份，且僅處理客戶端實際使用的資料夾。記錄顯示本機監聽正常但瀏覽器失敗時，請優先檢查桌面代理設定入口，不要急著更換伺服器參數。

Android：v2rayNG 與 VPN 連線管理

安裝客戶端並授權連線

Android 優先推薦使用採用 Xray 核心的 v2rayNG；需要 V2Fly 核心環境時，可選擇 v2flyNG。兩款客戶端是獨立應用程式，不要假設它們會共用訂閱、目前使用的伺服器或 VPN 狀態。前往Android 下載頁面選擇安裝套件，多數較新的裝置可先確認是否適用 arm64；若不確定架構或無法安裝 arm64 版本，請依系統資訊選擇通用版。通用版支援範圍較廣，但不代表所有系統版本都符合執行需求。更新現有應用程式前，請先保存訂閱資料和必要設定。

安裝時依 Android 提示，授予目前檔案來源安裝應用程式的權限；安裝完成後，可視需求撤銷該來源的權限。若系統顯示應用程式未安裝，請確認架構、可用空間、系統相容性與既有安裝來源，不要一開始就清除資料。初次建立連線時，系統會顯示 VPN 授權提示；這是客戶端透過系統網路介面接管流量所需的確認。授權後仍須查看應用程式內的記錄與狀態，系統彈出視窗確認完成不代表已成功連上遠端伺服器。

匯入訂閱、選擇伺服器並驗證

進入訂閱群組設定，新增群組並貼上完整網址，儲存後從選單更新訂閱。若透過剪貼簿匯入分享連結，匯入的可能是單一或一組設定，不一定同時建立可自動更新的訂閱關係。請分清楚這兩種方式並記錄，否則之後更新時可能會發現手動匯入的伺服器沒有變動。訂閱更新成功後，請確認清單中出現預期設定，再選擇一個目前使用的伺服器；若沒有選定伺服器，即使點擊連線按鈕，也無法建立有效的遠端連線。

先執行真實連線測試，選擇測試可用的伺服器，再點擊連線按鈕並確認狀態已變更。接著使用瀏覽器造訪目標網站，必要時查看出口資訊和記錄。若測試成功，但某個應用程式沒有走代理，請檢查是否設定了應用程式層級的代理範圍。「僅代理所選應用程式」與「排除所選應用程式」的意思相反；清單中選取某個應用程式不一定代表它會經過代理，請先確認目前模式的說明。變更應用程式清單或路由後，依介面指示重新建立 VPN 連線，讓新設定生效。

背景限制、網路切換與核心差異

Android 通常只允許同一使用者環境中有一個啟用中的 VPN 連線。其他 VPN、部分透過 VPN 運作的網路過濾工具或工作設定檔，都可能與目前客戶端衝突。若剛連線就中斷，請先確認系統中是否有其他工具自動恢復連線。應用程式分流與系統 VPN 的接管範圍也要一併檢查，不能只修改核心路由就預期所有應用程式都會經過代理。桌面端所說的系統代理設定不應直接套用到 Android；Android 常見的連線方式，是客戶端透過系統 VPN 服務建立本機流量接管入口。

螢幕熄滅後失去連線、切回應用程式後立即恢復，通常需要檢查電池最佳化與背景執行限制。請使用裝置系統提供的設定允許必要的背景執行，再觀察連線是否穩定；不要一次開放所有應用程式的權限。常駐通知用來顯示執行狀態，隱藏通知不一定能讓背景服務持續運作。切換無線網路與行動數據時，原有連線可能需要重新建立，尤其是網路需要網頁登入、行動數據尚未可用，或裝置進入省電狀態時。請先確認直接網路可用，再重新連線客戶端，避免把本機網路切換誤認為訂閱過期。

v2rayNG 與 v2flyNG 使用不同核心家族，設定能否使用取決於核心對其協定、傳輸方式與欄位的實際支援，不能只看分享連結是否能匯入。切換客戶端時請重新匯入訂閱並分別測試，不要直接複製另一款應用程式的所有內部檔案。若服務提供者明確要求特定核心功能，請以其要求為準。若沒有相容性方面的明確需求，先讓單一客戶端設定穩定運作，再考慮其他選擇，避免兩款應用程式輪流啟動造成連線狀態混亂。

系統代理與 TUN：接管範圍和本機連接埠

分清流量接管入口與路由出口

系統代理會告知遵循系統設定的應用程式，將請求傳送至本機 HTTP 或 SOCKS 代理入口；它不會強制接管所有流量。TUN 則透過虛擬網路介面與路由，將進入相應路徑的封包交由代理核心處理，接管範圍通常較廣，但仍受路由、應用程式排除設定與系統限制影響。全域代理規則只負責核心內部的出口選擇，不代表所有應用程式都已進入核心。先確認請求是否抵達客戶端，再討論應直連或經代理，可避免混淆不同層次的問題。

「自動設定系統代理」通常會寫入目前的本機代理入口；「清除系統代理」則會撤銷相關設定；「不變更系統代理」會保留系統目前的設定。最後一項不代表核心已停止運作，也不代表先前的設定會自動還原。除錯時請確認客戶端是否仍在監聽、系統是否仍指向該連接埠，以及應用程式是否遵循系統設定。尤其在客戶端異常結束後，系統代理設定可能仍然存在，導致瀏覽器連線到沒有程序監聽的連接埠，所有網站便會同時無法開啟。

本機監聽、區域網路與模式疊加

本機 HTTP、SOCKS 或混合連接埠是應用程式連線至客戶端的入口，不是遠端伺服器連接埠。混合連接埠通常能接收核心支援的多種代理請求，但可用協定仍須參照設定說明。初次使用時保留目前預設監聽設定即可；若記錄顯示位址已被占用，再查找衝突程序或改用未使用的連接埠。不要混用監聽位址、伺服器位址與訂閱網址。若監聽位址設為迴圈介面，主要供本機存取；其他裝置無法透過自己的迴圈位址連到這台電腦。

「允許區域網路連線」會擴大可存取範圍，只有明確需要共用代理時才應啟用。啟用後還須考慮監聽位址、防火牆與代理驗證，不能只因區域網路可信就長期開放入口。若要讓另一台裝置連線，請使用客戶端所在電腦的區域網路位址與實際監聽連接埠，並限制允許存取的網路範圍。一般單機使用時，維持僅允許本機存取會更容易管理。排錯期間不要同時開放區域網路、修改連接埠並啟用 TUN，否則難以判斷是哪項變更造成結果不同。

TUN 的啟用與還原順序

啟用 TUN 前，先保存可用的系統代理設定並確認遠端連線正常；接著依平台需求完成權限、元件或服務設定。啟用後觀察核心是否持續執行，並確認路由與 DNS 是否依預期建立。若網路全面中斷，請先停用 TUN、清除殘留的系統代理並測試直接連線；直接連線恢復後，再改回已知可用的系統代理路徑。TUN 發生故障時，不要連續修改伺服器傳輸參數，否則會破壞原本可用的對照條件。

不同實作方式不一定要求兩種模式互斥，但初次診斷時應先使用單一路徑。在某些環境中，應用程式明確連線至本機代理，而該連線又被 TUN 接管；若排除設定或迴圈處理不正確，就可能形成迴圈或重複處理。請依客戶端預設設定使用，不要自行強制將代理伺服器位址也送回同一代理出口。遇到 UDP 應用程式、遊戲或即時通訊異常時，還須分別確認應用程式流量是否進入核心、遠端是否支援相應轉送，以及目前網路是否允許相關通訊；不能只靠網頁測試代表所有情況都正常。

設定完成後，請完整測試啟用與停止流程：連線時目標可正常存取，停止後直接網路能恢復，重新啟動時不會出現連接埠或路由衝突。三個步驟都穩定後，再考慮啟用自動連線或長期在背景執行。變更系統網路設定前請保留原始值；若裝置受到管理限制，不要強行覆寫。選擇模式應以實際應用需求為準，不是接管範圍越大就一定越適合。

路由與 DNS：規則順序及分流驗證

從預設規則開始，確認比對順序

路由分流會依網域、目標 IP、連接埠或其他條件選擇出口，前提是流量已進入代理核心。初次使用時，先選擇客戶端提供的預設規則，確認一般連線穩定後，再逐條加入自訂規則。常見的「繞過大陸」預設會搭配規則資源區分直連和代理範圍，但實際效果取決於目前使用的核心與規則檔案；「全域」也應視為客戶端對應預設的出口策略，而不是作業系統層級的所有應用程式接管。設定前先釐清哪些服務需要直連、哪些需要代理，避免目標不明。

規則通常依設定順序比對，由第一條符合的規則決定處理方式，因此較具體的例外規則應排在範圍較廣的規則之前。範圍過大的直連規則，可能導致後續精確的代理規則永遠無法符合。修改時一次新增一條，並記錄測試網域、預期出口和實際記錄。不要直接拼接不同核心的規則片段；即使欄位名稱相似，資源格式、標籤命名和預設行為也可能不同。圖形介面中的路由編輯器與核心原始設定屬於不同層次，請使用介面支援的匯入方式。

網域、IP 與規則資源的關係

網域規則適合用來指定網站或服務的歸屬，IP 規則則適合處理明確的網段與解析後位址。有些連線進入核心時只剩 IP 資訊，網域規則能否比對，還取決於應用程式的請求方式、DNS 路徑與嗅探設定。使用 geosite 和 geoip 時，請確認相關規則資源存在且與核心相容；資源缺失或標籤有誤，可能導致啟動失敗或比對結果不如預期。不要將規則資源更新和訂閱更新混為一談，兩者更新的內容不同，排錯時應分別檢查結果。

以下是 Xray/V2Ray 格式的路由片段，示範透過精確網域後綴和私有 IPv4 網段設定直連。這不是完整的連線設定，且要求現有設定已定義標籤為 direct 的直連出口；若沒有對應出口，就不能直接使用。片段中沒有定義代理伺服器，也不會決定未符合規則的流量預設要前往哪個出口。若圖形介面只接受逐條規則，請依欄位分別輸入，不要將整個物件貼進單一網域輸入欄，也不要用它覆蓋客戶端產生的完整設定。

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

分別排查 DNS 與分流問題

DNS 會將網域名稱轉換成位址，但解析所使用的路徑與網頁連線的出口不一定相同。系統 DNS、客戶端內建 DNS 和瀏覽器加密 DNS 都可能參與解析。瀏覽器若啟用獨立解析，客戶端記錄中的網域資訊可能與系統查詢結果不同。請先確認是哪個元件負責解析，再決定是否調整；不要同時修改系統解析器、瀏覽器設定與核心 DNS。使用固定 IP 對照只能協助縮小問題範圍，不能取代正常的網域測試，因為 TLS 和虛擬主機仍可能需要正確的主機名稱。

只有少數網站異常、其他大多正常時，先比對這些網站是否走錯出口、是否符合非預期規則，以及解析位址是否正確。若問題是在切換規則後才出現，還原上一份可用規則進行驗證，比更換訂閱更有助於找出原因。IPv6 也應納入檢查：若系統優先取得 IPv6 位址，而目前的流量接管或遠端路徑未涵蓋相應流量，就可能造成連線不穩。請依實際網路能力設定雙堆疊路徑；沒有證據時，不要直接認定所有 IPv6 功能都是故障原因。

測試規則時，建立新連線比重新整理長時間開啟的頁面更可靠。瀏覽器快取、連線重用和應用程式內快取可能使舊出口暫時繼續使用。必要時請關閉相關應用程式並重新開啟，再查看核心記錄中的比對結果。若還不熟悉規則結構，可閱讀domain、ip 與分流規則實作；混用多組訂閱時，請先整理好群組，參閱多訂閱群組管理，避免將伺服器篩選條件誤當成流量路由條件。

常見設定問題：依故障層次恢復連線

先確認故障發生在哪一層

排查時從本機開始：程式能否開啟、核心是否持續執行、本機連接埠是否正在監聽、應用程式是否將請求交給客戶端、遠端是否能建立連線，最後再檢查路由和 DNS。每個步驟都保留明確的驗證結果，比同時重新安裝程式與更換訂閱更有效。請先保存記錄中的錯誤類型和發生時間；提供記錄給他人前，務必刪除訂閱網址、使用者識別碼及其他憑證。只有診斷期間才按需提高記錄等級，找出問題後請恢復一般等級，避免長時間累積不必要的連線記錄。

若所有伺服器都同時失敗，請優先檢查共通因素：本機網路、系統時間、核心啟動狀態、訂閱有效期限與代理模式。只有個別伺服器失敗時，再確認該設定中的位址、連接埠、傳輸方式和 TLS 參數。更新訂閱可能修正服務提供者變更後的設定，但無法解決本機連接埠遭占用或權限不足。完整的分層排查方式請參閱節點逾時與無法連線排查流程；需要快速問答時，請前往常見問題頁面。

訂閱、測速與瀏覽器連線

結束後還原、更新與設定備份

升級前請記錄安裝方式、設定資料夾與目前使用的介面版本，匯出訂閱群組和自訂路由，並將備份存放在受控位置。設定備份可能含有伺服器憑證，不能直接公開發布到討論區。升級後先確認原本最基本的可用路徑，再檢查新設定；若設定移轉異常，不要在同一資料夾中交替執行多個版本並反覆儲存。需要重新建立設定時，優先從完整訂閱還原伺服器，再逐項移轉手動路由和應用程式規則，避免一次複製錯誤狀態。

完整還原後，請依序進行連線、停止、再次連線三項檢查，並記錄最後採用的模式與連接埠。下次遇到相同問題時，就能先回到已知可用的狀態，不必從頭修改所有參數。初次使用者可返回快速入門教學依序完成操作；已確認平台與架構的讀者，可直接前往安裝套件頁面選擇相應客戶端。本指南說明各項設定的適用範圍；實際選單與權限提示請以目前客戶端和作業系統顯示為準。